@comitor/ui 1.11.0 → 2.1.0

package/dist/data-grid/messages.d.ts

@@ -1,280 +1,567 @@
+import { DataGridMessages } from './messages-en.js';
+export { messagesEn } from './messages-en.js';
+export { messagesVi } from './messages-vi.js';
+
 /**
- * Toàn bộ chuỗi hiển thị của DataGrid (tiếng Việt) — gom một chỗ để dễ rà soát,
- * đổi từ ngữ theo nghiệp vụ, hoặc dịch sang ngôn ngữ khác sau này.
+ * Sổ đăng ký ngôn ngữ của DataGrid. Module THUẦN — không directive, không hook — nên Server
+ * Component đọc thẳng được (xem `verify:directives`, phép kiểm 2 và 3).
+ *
+ * Hai ngôn ngữ, và cố ý dừng ở hai: tiếng Anh là bản gốc định nghĩa hình dạng
+ * ({@link DataGridMessages}), tiếng Việt là bản dịch đủ. Thêm ngôn ngữ thứ ba thì thêm một file
+ * `messages-<mã>.ts` chú thích `: DataGridMessages`, ghi vào `DATA_GRID_MESSAGES` bên dưới, và
+ * `DataGridLocale` tự rộng ra theo — không có danh sách thứ hai nào phải nhớ cập nhật.
  *
- * Quy ước: chuỗi cố định để nguyên; chuỗi có tham số viết thành hàm.
- * KHÔNG đặt JSX ở đây — chỉ chuỗi thuần.
+ * ⚠ Mặc định là **tiếng Anh**, ngược với phần còn lại của gói (README §5). Đây là ngoại lệ có chủ
+ * ý của riêng `DataGrid`, chốt ở `2.0.0` — lý do đầy đủ ở đầu `messages-en.ts`.
  */
-declare const msg: {
-    readonly grid: {
-        /** Nhãn mặc định của vùng `role="grid"` (ghi đè bằng prop `aria-label`) */
-        readonly label: "Bảng dữ liệu";
-        readonly addRow: "Thêm dòng";
-    };
-    readonly search: {
-        readonly placeholder: "Tìm trong bảng...";
-        readonly label: "Tìm trong bảng";
-        readonly prevMatch: "Kết quả trước";
-        readonly nextMatch: "Kết quả sau";
-        readonly close: "Đóng tìm kiếm";
-        readonly matchPosition: (index: number, total: number) => string;
-        readonly noResults: "Không có kết quả";
-        readonly typeToSearch: "Gõ để tìm";
-    };
-    readonly column: {
-        readonly sortAsc: "Sắp xếp tăng dần";
-        readonly sortDesc: "Sắp xếp giảm dần";
-        readonly removeSort: "Bỏ sắp xếp";
-        readonly pinLeft: "Ghim sang trái";
-        readonly unpinLeft: "Bỏ ghim trái";
-        readonly pinRight: "Ghim sang phải";
-        readonly unpinRight: "Bỏ ghim phải";
-        readonly hide: "Ẩn cột";
-        readonly resize: (label: string) => string;
-        /** Tên kiểu dữ liệu của cột, hiện trong tooltip ở tiêu đề cột */
-        readonly variant: {
-            readonly shortText: "Văn bản ngắn";
-            readonly longText: "Văn bản dài";
-            readonly number: "Số";
-            readonly url: "Liên kết";
-            readonly checkbox: "Ô đánh dấu";
-            readonly select: "Chọn một";
-            readonly multiSelect: "Chọn nhiều";
-            readonly date: "Ngày";
-            readonly file: "Tệp";
+
+/** Mọi bảng ngôn ngữ dựng sẵn, tra theo mã. */
+declare const DATA_GRID_MESSAGES: {
+    en: {
+        grid: {
+            label: string;
+            addRow: string;
         };
-    };
-    readonly select: {
-        readonly all: "Chọn tất cả";
-        readonly row: "Chọn dòng";
-        readonly rowNumber: (rowNumber: number) => string;
-    };
-    readonly contextMenu: {
-        readonly copy: "Sao chép";
-        readonly cut: "Cắt";
-        readonly clear: "Xoá nội dung";
-        readonly deleteRows: "Xoá dòng";
-    };
-    readonly pasteDialog: {
-        readonly title: "Thêm dòng để dán hết dữ liệu?";
-        readonly description: (rowsNeeded: number) => string;
-        readonly expandTitle: "Tạo dòng mới";
-        readonly expandDescription: (rowsNeeded: number) => string;
-        readonly keepTitle: "Giữ nguyên số dòng";
-        readonly keepDescription: "Chỉ dán phần vừa với các dòng hiện có";
-        readonly cancel: "Huỷ";
-        readonly confirm: "Tiếp tục";
-    };
-    readonly rowHeight: {
-        readonly label: "Chiều cao dòng";
-        readonly short: "Thấp";
-        readonly medium: "Vừa";
-        readonly tall: "Cao";
-        readonly extraTall: "Rất cao";
-    };
-    readonly view: {
-        readonly trigger: "Hiển thị";
-        readonly toggleColumns: "Ẩn/hiện cột";
-        readonly searchPlaceholder: "Tìm cột...";
-        readonly empty: "Không có cột phù hợp.";
-    };
-    readonly sort: {
-        readonly trigger: "Sắp xếp";
-        readonly title: "Sắp xếp theo";
-        readonly emptyTitle: "Chưa sắp xếp";
-        readonly description: "Đổi tiêu chí sắp xếp cho danh sách.";
-        readonly emptyDescription: "Thêm tiêu chí để sắp xếp danh sách.";
-        readonly add: "Thêm sắp xếp";
-        readonly reset: "Bỏ sắp xếp";
-        readonly remove: "Xoá tiêu chí";
-        readonly drag: "Kéo để đổi thứ tự";
-        readonly fieldPlaceholder: "Tìm trường...";
-        readonly fieldEmpty: "Không có trường phù hợp.";
-        readonly asc: "Tăng dần";
-        readonly desc: "Giảm dần";
-    };
-    readonly filter: {
-        readonly trigger: "Lọc";
-        readonly title: "Lọc theo";
-        readonly emptyTitle: "Chưa có bộ lọc";
-        readonly description: "Đổi điều kiện lọc để thu hẹp dữ liệu.";
-        readonly emptyDescription: "Thêm điều kiện lọc để thu hẹp dữ liệu.";
-        readonly add: "Thêm bộ lọc";
-        readonly reset: "Xoá bộ lọc";
-        readonly remove: "Xoá điều kiện";
-        readonly drag: "Kéo để đổi thứ tự";
-        readonly where: "Khi";
-        readonly and: "Và";
-        readonly fieldPlaceholder: "Tìm trường...";
-        readonly fieldEmpty: "Không có trường phù hợp.";
-        readonly valuePlaceholder: "Giá trị";
-        readonly rangeStart: "Từ";
-        readonly rangeEnd: "Đến";
-        readonly pickDate: "Chọn ngày";
-        readonly pickRange: "Chọn khoảng ngày";
-        readonly optionPlaceholder: "Tìm lựa chọn...";
-        readonly optionEmpty: "Không có lựa chọn phù hợp.";
-        readonly selectedCount: (count: number) => string;
-        readonly emptyValue: (label: string) => string;
-        /** Nhãn toán tử lọc — xem `filters.ts` để biết toán tử nào dùng cho kiểu ô nào */
-        readonly operators: {
-            readonly contains: "Chứa";
-            readonly notContains: "Không chứa";
-            readonly equals: "Bằng";
-            readonly notEquals: "Khác";
-            readonly startsWith: "Bắt đầu bằng";
-            readonly endsWith: "Kết thúc bằng";
-            readonly isEmpty: "Đang trống";
-            readonly isNotEmpty: "Không trống";
-            readonly lessThan: "Nhỏ hơn";
-            readonly lessThanOrEqual: "Nhỏ hơn hoặc bằng";
-            readonly greaterThan: "Lớn hơn";
-            readonly greaterThanOrEqual: "Lớn hơn hoặc bằng";
-            readonly isBetween: "Trong khoảng";
-            readonly dateEquals: "Đúng ngày";
-            readonly dateNotEquals: "Khác ngày";
-            readonly before: "Trước ngày";
-            readonly after: "Sau ngày";
-            readonly onOrBefore: "Vào hoặc trước ngày";
-            readonly onOrAfter: "Vào hoặc sau ngày";
-            readonly is: "Là";
-            readonly isNot: "Không là";
-            readonly isAnyOf: "Là một trong";
-            readonly isNoneOf: "Không là bất kỳ";
-            readonly isTrue: "Có đánh dấu";
-            readonly isFalse: "Không đánh dấu";
+        search: {
+            placeholder: string;
+            label: string;
+            prevMatch: string;
+            nextMatch: string;
+            close: string;
+            matchPosition: (index: number, total: number) => string;
+            noResults: string;
+            typeToSearch: string;
+        };
+        column: {
+            sortAsc: string;
+            sortDesc: string;
+            removeSort: string;
+            pinLeft: string;
+            unpinLeft: string;
+            pinRight: string;
+            unpinRight: string;
+            hide: string;
+            resize: (label: string) => string;
+            variant: {
+                shortText: string;
+                longText: string;
+                number: string;
+                url: string;
+                checkbox: string;
+                select: string;
+                multiSelect: string;
+                date: string;
+                file: string;
+            };
+        };
+        select: {
+            all: string;
+            row: string;
+            rowNumber: (rowNumber: number) => string;
+        };
+        contextMenu: {
+            copy: string;
+            cut: string;
+            clear: string;
+            deleteRows: string;
+        };
+        pasteDialog: {
+            title: string;
+            description: (rowsNeeded: number) => string;
+            expandTitle: string;
+            expandDescription: (rowsNeeded: number) => string;
+            keepTitle: string;
+            keepDescription: string;
+            cancel: string;
+            confirm: string;
+        };
+        rowHeight: {
+            label: string;
+            short: string;
+            medium: string;
+            tall: string;
+            extraTall: string;
+        };
+        view: {
+            trigger: string;
+            toggleColumns: string;
+            searchPlaceholder: string;
+            empty: string;
+        };
+        sort: {
+            trigger: string;
+            title: string;
+            emptyTitle: string;
+            description: string;
+            emptyDescription: string;
+            add: string;
+            reset: string;
+            remove: string;
+            drag: string;
+            fieldPlaceholder: string;
+            fieldEmpty: string;
+            asc: string;
+            desc: string;
+        };
+        filter: {
+            trigger: string;
+            title: string;
+            emptyTitle: string;
+            description: string;
+            emptyDescription: string;
+            add: string;
+            reset: string;
+            remove: string;
+            drag: string;
+            where: string;
+            and: string;
+            fieldPlaceholder: string;
+            fieldEmpty: string;
+            valuePlaceholder: string;
+            rangeStart: string;
+            rangeEnd: string;
+            pickDate: string;
+            pickRange: string;
+            optionPlaceholder: string;
+            optionEmpty: string;
+            selectedCount: (count: number) => string;
+            emptyValue: (label: string) => string;
+            operators: {
+                contains: string;
+                notContains: string;
+                equals: string;
+                notEquals: string;
+                startsWith: string;
+                endsWith: string;
+                isEmpty: string;
+                isNotEmpty: string;
+                lessThan: string;
+                lessThanOrEqual: string;
+                greaterThan: string;
+                greaterThanOrEqual: string;
+                isBetween: string;
+                dateEquals: string;
+                dateNotEquals: string;
+                before: string;
+                after: string;
+                onOrBefore: string;
+                onOrAfter: string;
+                is: string;
+                isNot: string;
+                isAnyOf: string;
+                isNoneOf: string;
+                isTrue: string;
+                isFalse: string;
+            };
+        };
+        cell: {
+            longTextPlaceholder: string;
+            optionSearchPlaceholder: string;
+            optionEmpty: string;
+            clearAll: string;
+            invalidUrlTitle: string;
+            invalidUrlDescription: string;
+        };
+        file: {
+            uploadLabel: string;
+            dropHere: string;
+            dragHere: string;
+            browse: string;
+            limits: (maxSize?: string, maxFiles?: number) => string;
+            count: (count: number) => string;
+            clearAll: string;
+            remove: string;
+            uploading: string;
+            deleting: string;
+            tooMany: (maxFiles: number) => string;
+            tooLarge: (maxSize: string) => string;
+            wrongType: string;
+            rejectedOne: (name: string) => string;
+            rejectedMany: (name: string, others: number) => string;
+            uploadFailed: (count: number) => string;
+            deleteFailed: (name: string) => string;
+            deleteFailedMany: string;
+        };
+        toast: {
+            cellsCopied: (count: number) => string;
+            copyFailed: string;
+            cellsCut: (count: number) => string;
+            cutFailed: string;
+            cellsPasted: (count: number) => string;
+            cellsPastedWithSkipped: (count: number, skipped: number) => string;
+            pasteSkipped: (skipped: number) => string;
+            pasteFailed: string;
+            cellsCleared: (count: number) => string;
+            rowsDeleted: (count: number) => string;
+            nothingToUndo: string;
+            nothingToRedo: string;
+            undone: (count: number) => string;
+            redone: (count: number) => string;
+        };
+        booleanText: {
+            checked: string;
+            unchecked: string;
+        };
+        shortcuts: {
+            trigger: string;
+            title: string;
+            description: string;
+            searchPlaceholder: string;
+            emptyTitle: string;
+            emptyDescription: string;
+            close: string;
+            groups: {
+                navigation: string;
+                selection: string;
+                editing: string;
+                search: string;
+                filtering: string;
+                sorting: string;
+                general: string;
+            };
+            keys: {
+                click: string;
+                doubleClick: string;
+            };
+            navigation: {
+                move: string;
+                nextCell: string;
+                prevCell: string;
+                firstColumn: string;
+                lastColumn: string;
+                firstRowSameColumn: string;
+                lastRowSameColumn: string;
+                firstColumnSameRow: string;
+                lastColumnSameRow: string;
+                firstCell: string;
+                lastCell: string;
+                pageUp: string;
+                pageDown: string;
+                scrollUp: string;
+                scrollDown: string;
+                scrollLeft: string;
+                scrollRight: string;
+            };
+            selection: {
+                extend: string;
+                toTop: string;
+                toBottom: string;
+                toFirstColumn: string;
+                toLastColumn: string;
+                all: string;
+                toggle: string;
+                range: string;
+                clear: string;
+            };
+            editing: {
+                start: string;
+                insertRow: string;
+                copy: string;
+                cut: string;
+                paste: string;
+                clear: string;
+                deleteRows: string;
+                undo: string;
+                redo: string;
+            };
+            search: {
+                open: string;
+                next: string;
+                prev: string;
+                close: string;
+            };
+            filtering: {
+                toggle: string;
+                remove: string;
+            };
+            sorting: {
+                toggle: string;
+                remove: string;
+            };
+            general: {
+                shortcuts: string;
+            };
         };
     };
-    readonly cell: {
-        readonly longTextPlaceholder: "Nhập nội dung...";
-        readonly optionSearchPlaceholder: "Tìm...";
-        readonly optionEmpty: "Không có lựa chọn phù hợp.";
-        readonly clearAll: "Bỏ chọn hết";
-        readonly invalidUrlTitle: "Liên kết không hợp lệ";
-        readonly invalidUrlDescription: "Liên kết chứa giao thức nguy hiểm (javascript:, data:, vbscript: hoặc file:)";
-    };
-    readonly file: {
-        readonly uploadLabel: "Tải tệp lên";
-        readonly dropHere: "Thả tệp vào đây";
-        readonly dragHere: "Kéo tệp vào đây";
-        readonly browse: "hoặc bấm để chọn tệp";
-        readonly limits: (maxSize?: string, maxFiles?: number) => string;
-        readonly count: (count: number) => string;
-        readonly clearAll: "Xoá hết";
-        readonly remove: "Xoá tệp";
-        readonly uploading: "Đang tải lên...";
-        readonly deleting: "Đang xoá...";
-        readonly tooMany: (maxFiles: number) => string;
-        readonly tooLarge: (maxSize: string) => string;
-        readonly wrongType: "Không chấp nhận định dạng tệp này";
-        readonly rejectedOne: (name: string) => string;
-        readonly rejectedMany: (name: string, others: number) => string;
-        readonly uploadFailed: (count: number) => string;
-        readonly deleteFailed: (name: string) => string;
-        readonly deleteFailedMany: "Không xoá được tệp";
-    };
-    readonly toast: {
-        readonly cellsCopied: (count: number) => string;
-        readonly copyFailed: "Không sao chép được vào clipboard";
-        readonly cellsCut: (count: number) => string;
-        readonly cutFailed: "Không cắt được vào clipboard";
-        readonly cellsPasted: (count: number) => string;
-        readonly cellsPastedWithSkipped: (count: number, skipped: number) => string;
-        readonly pasteSkipped: (skipped: number) => string;
-        readonly pasteFailed: "Không dán được. Vui lòng thử lại.";
-        readonly cellsCleared: (count: number) => string;
-        readonly rowsDeleted: (count: number) => string;
-        readonly nothingToUndo: "Không còn thao tác để hoàn tác";
-        readonly nothingToRedo: "Không còn thao tác để làm lại";
-        readonly undone: (count: number) => string;
-        readonly redone: (count: number) => string;
-    };
-    /** Giá trị văn bản khi dán boolean vào ô văn bản */
-    readonly booleanText: {
-        readonly checked: "Có";
-        readonly unchecked: "Không";
-    };
-    readonly shortcuts: {
-        readonly trigger: "Phím tắt";
-        readonly title: "Phím tắt";
-        readonly description: "Danh sách phím tắt để thao tác nhanh với bảng dữ liệu.";
-        readonly searchPlaceholder: "Tìm phím tắt...";
-        readonly emptyTitle: "Không tìm thấy phím tắt";
-        readonly emptyDescription: "Thử tìm với từ khoá khác.";
-        readonly close: "Đóng";
-        readonly groups: {
-            readonly navigation: "Di chuyển";
-            readonly selection: "Chọn ô";
-            readonly editing: "Sửa dữ liệu";
-            readonly search: "Tìm kiếm";
-            readonly filtering: "Lọc";
-            readonly sorting: "Sắp xếp";
-            readonly general: "Chung";
+    vi: {
+        grid: {
+            label: string;
+            addRow: string;
         };
-        readonly keys: {
-            readonly click: "Nhấp chuột";
-            readonly doubleClick: "Nhấp đúp";
+        search: {
+            placeholder: string;
+            label: string;
+            prevMatch: string;
+            nextMatch: string;
+            close: string;
+            matchPosition: (index: number, total: number) => string;
+            noResults: string;
+            typeToSearch: string;
         };
-        readonly navigation: {
-            readonly move: "Di chuyển giữa các ô";
-            readonly nextCell: "Sang ô kế tiếp";
-            readonly prevCell: "Về ô trước đó";
-            readonly firstColumn: "Về cột đầu";
-            readonly lastColumn: "Tới cột cuối";
-            readonly firstRowSameColumn: "Về dòng đầu (cùng cột)";
-            readonly lastRowSameColumn: "Tới dòng cuối (cùng cột)";
-            readonly firstColumnSameRow: "Về cột đầu (cùng dòng)";
-            readonly lastColumnSameRow: "Tới cột cuối (cùng dòng)";
-            readonly firstCell: "Về ô đầu bảng";
-            readonly lastCell: "Tới ô cuối bảng";
-            readonly pageUp: "Lên một trang";
-            readonly pageDown: "Xuống một trang";
-            readonly scrollUp: "Cuộn lên một trang";
-            readonly scrollDown: "Cuộn xuống một trang";
-            readonly scrollLeft: "Cuộn sang trái một trang cột";
-            readonly scrollRight: "Cuộn sang phải một trang cột";
+        column: {
+            sortAsc: string;
+            sortDesc: string;
+            removeSort: string;
+            pinLeft: string;
+            unpinLeft: string;
+            pinRight: string;
+            unpinRight: string;
+            hide: string;
+            resize: (label: string) => string;
+            variant: {
+                shortText: string;
+                longText: string;
+                number: string;
+                url: string;
+                checkbox: string;
+                select: string;
+                multiSelect: string;
+                date: string;
+                file: string;
+            };
         };
-        readonly selection: {
-            readonly extend: "Mở rộng vùng chọn";
-            readonly toTop: "Chọn tới đầu bảng";
-            readonly toBottom: "Chọn tới cuối bảng";
-            readonly toFirstColumn: "Chọn tới cột đầu";
-            readonly toLastColumn: "Chọn tới cột cuối";
-            readonly all: "Chọn toàn bộ ô";
-            readonly toggle: "Thêm/bớt một ô khỏi vùng chọn";
-            readonly range: "Chọn cả vùng";
-            readonly clear: "Bỏ chọn";
+        select: {
+            all: string;
+            row: string;
+            rowNumber: (rowNumber: number) => string;
         };
-        readonly editing: {
-            readonly start: "Bắt đầu sửa ô";
-            readonly insertRow: "Chèn dòng bên dưới";
-            readonly copy: "Sao chép ô đang chọn";
-            readonly cut: "Cắt ô đang chọn";
-            readonly paste: "Dán vào ô";
-            readonly clear: "Xoá nội dung ô đang chọn";
-            readonly deleteRows: "Xoá dòng đang chọn";
-            readonly undo: "Hoàn tác";
-            readonly redo: "Làm lại";
+        contextMenu: {
+            copy: string;
+            cut: string;
+            clear: string;
+            deleteRows: string;
         };
-        readonly search: {
-            readonly open: "Mở ô tìm kiếm";
-            readonly next: "Kết quả kế tiếp";
-            readonly prev: "Kết quả trước đó";
-            readonly close: "Đóng tìm kiếm";
+        pasteDialog: {
+            title: string;
+            description: (rowsNeeded: number) => string;
+            expandTitle: string;
+            expandDescription: (rowsNeeded: number) => string;
+            keepTitle: string;
+            keepDescription: string;
+            cancel: string;
+            confirm: string;
         };
-        readonly filtering: {
-            readonly toggle: "Mở/đóng menu lọc";
-            readonly remove: "Xoá điều kiện lọc (khi đang chọn)";
+        rowHeight: {
+            label: string;
+            short: string;
+            medium: string;
+            tall: string;
+            extraTall: string;
         };
-        readonly sorting: {
-            readonly toggle: "Mở/đóng menu sắp xếp";
-            readonly remove: "Xoá tiêu chí sắp xếp (khi đang chọn)";
+        view: {
+            trigger: string;
+            toggleColumns: string;
+            searchPlaceholder: string;
+            empty: string;
         };
-        readonly general: {
-            readonly shortcuts: "Xem danh sách phím tắt";
+        sort: {
+            trigger: string;
+            title: string;
+            emptyTitle: string;
+            description: string;
+            emptyDescription: string;
+            add: string;
+            reset: string;
+            remove: string;
+            drag: string;
+            fieldPlaceholder: string;
+            fieldEmpty: string;
+            asc: string;
+            desc: string;
+        };
+        filter: {
+            trigger: string;
+            title: string;
+            emptyTitle: string;
+            description: string;
+            emptyDescription: string;
+            add: string;
+            reset: string;
+            remove: string;
+            drag: string;
+            where: string;
+            and: string;
+            fieldPlaceholder: string;
+            fieldEmpty: string;
+            valuePlaceholder: string;
+            rangeStart: string;
+            rangeEnd: string;
+            pickDate: string;
+            pickRange: string;
+            optionPlaceholder: string;
+            optionEmpty: string;
+            selectedCount: (count: number) => string;
+            emptyValue: (label: string) => string;
+            operators: {
+                contains: string;
+                notContains: string;
+                equals: string;
+                notEquals: string;
+                startsWith: string;
+                endsWith: string;
+                isEmpty: string;
+                isNotEmpty: string;
+                lessThan: string;
+                lessThanOrEqual: string;
+                greaterThan: string;
+                greaterThanOrEqual: string;
+                isBetween: string;
+                dateEquals: string;
+                dateNotEquals: string;
+                before: string;
+                after: string;
+                onOrBefore: string;
+                onOrAfter: string;
+                is: string;
+                isNot: string;
+                isAnyOf: string;
+                isNoneOf: string;
+                isTrue: string;
+                isFalse: string;
+            };
+        };
+        cell: {
+            longTextPlaceholder: string;
+            optionSearchPlaceholder: string;
+            optionEmpty: string;
+            clearAll: string;
+            invalidUrlTitle: string;
+            invalidUrlDescription: string;
+        };
+        file: {
+            uploadLabel: string;
+            dropHere: string;
+            dragHere: string;
+            browse: string;
+            limits: (maxSize?: string, maxFiles?: number) => string;
+            count: (count: number) => string;
+            clearAll: string;
+            remove: string;
+            uploading: string;
+            deleting: string;
+            tooMany: (maxFiles: number) => string;
+            tooLarge: (maxSize: string) => string;
+            wrongType: string;
+            rejectedOne: (name: string) => string;
+            rejectedMany: (name: string, others: number) => string;
+            uploadFailed: (count: number) => string;
+            deleteFailed: (name: string) => string;
+            deleteFailedMany: string;
+        };
+        toast: {
+            cellsCopied: (count: number) => string;
+            copyFailed: string;
+            cellsCut: (count: number) => string;
+            cutFailed: string;
+            cellsPasted: (count: number) => string;
+            cellsPastedWithSkipped: (count: number, skipped: number) => string;
+            pasteSkipped: (skipped: number) => string;
+            pasteFailed: string;
+            cellsCleared: (count: number) => string;
+            rowsDeleted: (count: number) => string;
+            nothingToUndo: string;
+            nothingToRedo: string;
+            undone: (count: number) => string;
+            redone: (count: number) => string;
+        };
+        booleanText: {
+            checked: string;
+            unchecked: string;
+        };
+        shortcuts: {
+            trigger: string;
+            title: string;
+            description: string;
+            searchPlaceholder: string;
+            emptyTitle: string;
+            emptyDescription: string;
+            close: string;
+            groups: {
+                navigation: string;
+                selection: string;
+                editing: string;
+                search: string;
+                filtering: string;
+                sorting: string;
+                general: string;
+            };
+            keys: {
+                click: string;
+                doubleClick: string;
+            };
+            navigation: {
+                move: string;
+                nextCell: string;
+                prevCell: string;
+                firstColumn: string;
+                lastColumn: string;
+                firstRowSameColumn: string;
+                lastRowSameColumn: string;
+                firstColumnSameRow: string;
+                lastColumnSameRow: string;
+                firstCell: string;
+                lastCell: string;
+                pageUp: string;
+                pageDown: string;
+                scrollUp: string;
+                scrollDown: string;
+                scrollLeft: string;
+                scrollRight: string;
+            };
+            selection: {
+                extend: string;
+                toTop: string;
+                toBottom: string;
+                toFirstColumn: string;
+                toLastColumn: string;
+                all: string;
+                toggle: string;
+                range: string;
+                clear: string;
+            };
+            editing: {
+                start: string;
+                insertRow: string;
+                copy: string;
+                cut: string;
+                paste: string;
+                clear: string;
+                deleteRows: string;
+                undo: string;
+                redo: string;
+            };
+            search: {
+                open: string;
+                next: string;
+                prev: string;
+                close: string;
+            };
+            filtering: {
+                toggle: string;
+                remove: string;
+            };
+            sorting: {
+                toggle: string;
+                remove: string;
+            };
+            general: {
+                shortcuts: string;
+            };
         };
     };
 };
-type DataGridMessages = typeof msg;
+/** Mã ngôn ngữ mà `DataGrid` nhận. Suy từ `DATA_GRID_MESSAGES`, không viết tay lần hai. */
+type DataGridLocale = keyof typeof DATA_GRID_MESSAGES;
+/** Mặc định khi không ai truyền gì — xem ghi chú đầu file về vì sao là `"en"`. */
+declare const DEFAULT_DATA_GRID_LOCALE: DataGridLocale;
+/**
+ * Bảng chuỗi cho một ngôn ngữ, hoặc bảng do app tự truyền vào.
+ *
+ * Nhận cả mã lẫn cả object để app không phải chọn giữa "dùng bản dựng sẵn" và "sửa vài chữ":
+ * truyền `"vi"` là xong, còn muốn đổi từ ngữ theo nghiệp vụ thì trải bảng ra rồi ghi đè khoá cần
+ * đổi. Mã lạ rơi về mặc định thay vì ném lỗi — một chữ sai chính tả trong prop không đáng làm
+ * trắng cả màn hình.
+ */
+declare function getDataGridMessages(locale?: DataGridLocale | DataGridMessages): DataGridMessages;
 
-export { type DataGridMessages, msg };
+export { DATA_GRID_MESSAGES, DEFAULT_DATA_GRID_LOCALE, type DataGridLocale, DataGridMessages, getDataGridMessages };