slikts/tuplerone

🎯 Tuplerone — Tuple và value object trong JavaScript/TypeScript

Tuplerone cho phép so sánh giá trị kiểu danh sách bằng ===, giống như tuple trong Python.

Tuplerone là một thư viện nhỏ gọn (dưới 1KB) cung cấp cấu trúc dữ liệu tuple và value object cho JavaScript và TypeScript. Thay vì so sánh tham chiếu như mảng, Tuplerone trả về cùng một tham chiếu nếu nội dung tuple giống nhau, nhờ cấu trúc WeakMap DAG.

✨ Điểm nổi bật

• Tuple(1,2,3) === Tuple(1,2,3): so sánh giá trị thay vì tham chiếu
• Immutable: dùng Object.freeze(), không thể thay đổi thuộc tính
• Array-like & iterable: truy cập bằng chỉ số, hỗ trợ for-of và spread
• Efficient lookup: dùng WeakMap DAG để lưu trữ và tra cứu nhanh
• Tiny & zero-dependency: dưới 1KB, không phụ thuộc bên ngoài
• Type-safe: hỗ trợ TypeScript đầy đủ
• Map/WeakMap key: dùng tuple làm khóa phức hợp

💡 Vì sao đáng chú ý

Tuplerone khắc phục hạn chế của mảng trong JS: [1,2,3] !== [1,2,3]. Thay vào đó, nó dùng một WeakMap DAG để ánh xạ nội dung tuple sang một tham chiếu duy nhất — giống hệnh viễn lược trong Python. Rất hữu ích khi dùng memoization (React.memo, PureComponent), truyền danh sách làm props, hoặc dùng nhiều giá trị làm khóa Map.

---

#Tuple #ValueObject #Immutability #JavaScript #TypeScript #TiniX