@comitor/ui 1.10.0 → 2.0.0

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

@@ -0,0 +1,567 @@
+import { DataGridMessages } from './messages-en.js';
+export { messagesEn } from './messages-en.js';
+export { messagesVi } from './messages-vi.js';
+
+/**
+ * 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.
+ *
+ * ⚠ 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`.
+ */
+
+/** 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;
+        };
+        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;
+            };
+        };
+    };
+    vi: {
+        grid: {
+            label: string;
+            addRow: string;
+        };
+        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;
+            };
+        };
+    };
+};
+/** 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 { DATA_GRID_MESSAGES, DEFAULT_DATA_GRID_LOCALE, type DataGridLocale, DataGridMessages, getDataGridMessages };

package/dist/data-grid/messages.js

@@ -0,0 +1,20 @@
+import { messagesEn } from "./messages-en.js";
+import { messagesVi } from "./messages-vi.js";
+const DATA_GRID_MESSAGES = {
+  en: messagesEn,
+  vi: messagesVi
+};
+const DEFAULT_DATA_GRID_LOCALE = "en";
+function getDataGridMessages(locale) {
+  if (!locale) return DATA_GRID_MESSAGES[DEFAULT_DATA_GRID_LOCALE];
+  if (typeof locale === "string") return DATA_GRID_MESSAGES[locale] ?? DATA_GRID_MESSAGES[DEFAULT_DATA_GRID_LOCALE];
+  return locale;
+}
+export {
+  DATA_GRID_MESSAGES,
+  DEFAULT_DATA_GRID_LOCALE,
+  getDataGridMessages,
+  messagesEn,
+  messagesVi
+};
+//# sourceMappingURL=messages.js.map

package/dist/data-grid/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/data-grid/messages.ts"],"sourcesContent":["/**\n * Sổ đăng ký ngôn ngữ của DataGrid. Module THUẦN — không directive, không hook — nên Server\n * Component đọc thẳng được (xem `verify:directives`, phép kiểm 2 và 3).\n *\n * Hai ngôn ngữ, và cố ý dừng ở hai: tiếng Anh là bản gốc định nghĩa hình dạng\n * ({@link DataGridMessages}), tiếng Việt là bản dịch đủ. Thêm ngôn ngữ thứ ba thì thêm một file\n * `messages-<mã>.ts` chú thích `: DataGridMessages`, ghi vào `DATA_GRID_MESSAGES` bên dưới, và\n * `DataGridLocale` tự rộng ra theo — không có danh sách thứ hai nào phải nhớ cập nhật.\n *\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ủ\n * ý của riêng `DataGrid`, chốt ở `2.0.0` — lý do đầy đủ ở đầu `messages-en.ts`.\n */\nimport { type DataGridMessages, messagesEn } from \"./messages-en.js\";\nimport { messagesVi } from \"./messages-vi.js\";\n\nexport type { DataGridMessages };\nexport { messagesEn, messagesVi };\n\n/** Mọi bảng ngôn ngữ dựng sẵn, tra theo mã. */\nexport const DATA_GRID_MESSAGES = {\n  en: messagesEn,\n  vi: messagesVi\n};\n\n/** Mã ngôn ngữ mà `DataGrid` nhận. Suy từ `DATA_GRID_MESSAGES`, không viết tay lần hai. */\nexport type DataGridLocale = keyof typeof DATA_GRID_MESSAGES;\n\n/** Mặc định khi không ai truyền gì — xem ghi chú đầu file về vì sao là `\"en\"`. */\nexport const DEFAULT_DATA_GRID_LOCALE: DataGridLocale = \"en\";\n\n/**\n * Bảng chuỗi cho một ngôn ngữ, hoặc bảng do app tự truyền vào.\n *\n * 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ữ\":\n * 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\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\n * trắng cả màn hình.\n */\nexport function getDataGridMessages(locale?: DataGridLocale | DataGridMessages): DataGridMessages {\n  if (!locale) return DATA_GRID_MESSAGES[DEFAULT_DATA_GRID_LOCALE];\n  if (typeof locale === \"string\") return DATA_GRID_MESSAGES[locale] ?? DATA_GRID_MESSAGES[DEFAULT_DATA_GRID_LOCALE];\n  return locale;\n}\n"],"mappings":"AAYA,SAAgC,kBAAkB;AAClD,SAAS,kBAAkB;AAMpB,MAAM,qBAAqB;AAAA,EAChC,IAAI;AAAA,EACJ,IAAI;AACN;AAMO,MAAM,2BAA2C;AAUjD,SAAS,oBAAoB,QAA8D;AAChG,MAAI,CAAC,OAAQ,QAAO,mBAAmB,wBAAwB;AAC/D,MAAI,OAAO,WAAW,SAAU,QAAO,mBAAmB,MAAM,KAAK,mBAAmB,wBAAwB;AAChH,SAAO;AACT;","names":[]}

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

@@ -0,0 +1,50 @@
+import { DndContextProps, UniqueIdentifier, DragEndEvent, DragOverlay } from '@dnd-kit/core';
+import { SortableContextProps } from '@dnd-kit/sortable';
+import * as React from 'react';
+
+interface GetItemValue<T> {
+    /**
+     * Callback that returns a unique identifier for each sortable item. Required for array of objects.
+     * @example getItemValue={(item) => item.id}
+     */
+    getItemValue: (item: T) => UniqueIdentifier;
+}
+type SortableProps<T> = DndContextProps & (T extends object ? GetItemValue<T> : Partial<GetItemValue<T>>) & {
+    value: T[];
+    onValueChange?: (items: T[]) => void;
+    onMove?: (event: DragEndEvent & {
+        activeIndex: number;
+        overIndex: number;
+    }) => void;
+    strategy?: SortableContextProps["strategy"];
+    orientation?: "vertical" | "horizontal" | "mixed";
+    flatCursor?: boolean;
+};
+declare function Sortable<T>(props: SortableProps<T>): React.JSX.Element;
+interface SortableContentProps extends React.ComponentProps<"div"> {
+    strategy?: SortableContextProps["strategy"];
+    children: React.ReactNode;
+    asChild?: boolean;
+    withoutSlot?: boolean;
+}
+declare function SortableContent(props: SortableContentProps): React.JSX.Element;
+interface SortableItemProps extends React.ComponentProps<"div"> {
+    value: UniqueIdentifier;
+    asHandle?: boolean;
+    asChild?: boolean;
+    disabled?: boolean;
+}
+declare function SortableItem(props: SortableItemProps): React.JSX.Element;
+interface SortableItemHandleProps extends React.ComponentProps<"button"> {
+    asChild?: boolean;
+}
+declare function SortableItemHandle(props: SortableItemHandleProps): React.JSX.Element;
+interface SortableOverlayProps extends Omit<React.ComponentProps<typeof DragOverlay>, "children"> {
+    container?: Element | DocumentFragment | null;
+    children?: ((params: {
+        value: UniqueIdentifier;
+    }) => React.ReactNode) | React.ReactNode;
+}
+declare function SortableOverlay(props: SortableOverlayProps): React.ReactPortal | null;
+
+export { Sortable, SortableContent, SortableItem, SortableItemHandle, SortableOverlay, type SortableProps };