codpro2005/ts-regexp

🧠 ts-regexp: RegExp có type safety thực sự

Wrapper RegExp tự động suy luận kiểu capture groups tại thời điểm biên dịch.

ts-regexp là một thư viện TypeScript nhỏ gọn, cung cấp hàm regex thay thế RegExp với khả năng suy luận kiểu (type inference) chính xác cho cả capture groups thứ tự và tên. Thay vì nhận về { [key: string]: string } như RegExp native, ts-regexp trả về kiểu rõ ràng như { year: string; month: string; day: string }.

✨ Điểm nổi bật

• Type inference cho capture groups: Tự động suy luận kiểu từ pattern, không cần ép kiểu.
• Hỗ trợ capture có tên: Các nhóm (?<name>...) được ánh xạ thành object có khóa tương ứng.
• Phương thức chuẩn: exec, test hoạt động như RegExp nhưng có typing chính xác.
• Regex-first methods: matchIn, replaceIn, searchIn, splitIn đảo ngược thứ tự tham số để type-safe hơn.
• Global flag methods: matchAllIn, replaceAllIn chỉ khả dụng khi có flag g.
• Fallback RegExp: Truy cập pattern.regExp để lấy instance RegExp gốc khi cần.
• Utility type Parse<T>: Phân tích pattern tại mức type để lấy captures và namedCaptures.

💡 Vì sao đáng chú ý

ts-regexp khác biệt từ RegExp native ở khả năng suy luận kiểu tĩnh thời gian biên dịch, giúp tránh lỗi truy cập sai key hoặc kiểu sai từ capture groups. Phù hợp cho dự án TypeScript cần xử lý regex phức tạp với độ tin cậy cao.

#TypeScript #RegExp #TypeSafety #Regex #OpenSource #TiniX