@miaixz/ui 0.5.0

package/dist/components/confirm-dialog/confirm-dialog.js

@@ -0,0 +1,70 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from "react";
+import { useMiaixzLocale } from "../../i18n/index.js";
+import { Button } from "../button/index.js";
+import { Dialog } from "../dialog/index.js";
+import { InlineMessage } from "../inline-message/index.js";
+import { Input } from "../input/index.js";
+/**
+ * Renders a focus-safe confirmation flow by composing the shared modal dialog.
+ *
+ * @param props - Controlled confirmation state, content, actions, and optional safety controls.
+ * @returns A confirmation dialog that keeps cancellation as the initial focus target.
+ * @public
+ */
+export function ConfirmDialog(props) {
+    const { open, onOpenChange, title, description, confirmLabel, cancelLabel, tone = "normal", confirmationText, pending = false, error, onConfirm, } = props;
+    const { t } = useMiaixzLocale();
+    const confirmationInputRef = useRef(null);
+    const previousOpenRef = useRef(open);
+    const internalPendingRef = useRef(false);
+    const [internalPending, setInternalPending] = useState(false);
+    const [confirmationMatches, setConfirmationMatches] = useState(confirmationText === undefined);
+    const isPending = pending || internalPending;
+    const canConfirm = confirmationText === undefined || confirmationMatches;
+    useEffect(() => {
+        const opened = open && !previousOpenRef.current;
+        previousOpenRef.current = open;
+        if (opened) {
+            if (confirmationInputRef.current !== null)
+                confirmationInputRef.current.value = "";
+            setConfirmationMatches(confirmationText === undefined);
+            return;
+        }
+        if (open && confirmationText !== undefined) {
+            setConfirmationMatches(confirmationInputRef.current?.value === confirmationText);
+        }
+    }, [confirmationText, open]);
+    /**
+     * Forwards dismissal requests only while no confirmation operation is pending.
+     *
+     * @param nextOpen - Requested controlled open state.
+     */
+    const handleOpenChange = (nextOpen) => {
+        if (!nextOpen && (pending || internalPendingRef.current))
+            return;
+        onOpenChange(nextOpen);
+    };
+    /**
+     * Runs the confirmation action exactly once and contains synchronous or asynchronous failures.
+     */
+    const handleConfirm = async () => {
+        if (pending || internalPendingRef.current || !canConfirm)
+            return;
+        internalPendingRef.current = true;
+        setInternalPending(true);
+        try {
+            await onConfirm();
+            onOpenChange(false);
+        }
+        catch {
+            // Consumers own localized error presentation through the explicit error property.
+        }
+        finally {
+            internalPendingRef.current = false;
+            setInternalPending(false);
+        }
+    };
+    return (_jsx(Dialog, { open: open, onOpenChange: handleOpenChange, title: title, description: description, size: "small", showClose: false, "aria-busy": isPending || undefined, className: "miaixz-confirm-dialog", children: _jsxs("div", { className: "miaixz-confirm-dialog-content", children: [_jsx(Button, { className: "miaixz-confirm-dialog-cancel", disabled: isPending, onClick: () => handleOpenChange(false), children: cancelLabel }), confirmationText !== undefined && (_jsx("div", { className: "miaixz-confirm-dialog-input", children: _jsx(Input, { ref: confirmationInputRef, "aria-label": t("ui.confirm.confirmationInputLabel"), autoComplete: "off", disabled: isPending, spellCheck: false, onChange: (event) => setConfirmationMatches(event.currentTarget.value === confirmationText) }) })), error !== undefined && (_jsx(InlineMessage, { tone: "danger", className: "miaixz-confirm-dialog-error", children: error })), _jsx(Button, { className: "miaixz-confirm-dialog-confirm", variant: tone === "danger" ? "danger" : "primary", disabled: !canConfirm || isPending, loading: isPending, onClick: () => void handleConfirm(), children: confirmLabel })] }) }));
+}
+//# sourceMappingURL=confirm-dialog.js.map

package/dist/components/confirm-dialog/confirm-dialog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-dialog.js","sourceRoot":"","sources":["../../../src/components/confirm-dialog/confirm-dialog.tsx"],"names":[],"mappings":"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","sourcesContent":["import { useEffect, useRef, useState } from \"react\";\n\nimport { useMiaixzLocale } from \"../../i18n/index.js\";\nimport { Button } from \"../button/index.js\";\nimport { Dialog } from \"../dialog/index.js\";\nimport { InlineMessage } from \"../inline-message/index.js\";\nimport { Input } from \"../input/index.js\";\nimport type { ConfirmDialogProps } from \"./confirm-dialog.types.js\";\n\n/**\n * Renders a focus-safe confirmation flow by composing the shared modal dialog.\n *\n * @param props - Controlled confirmation state, content, actions, and optional safety controls.\n * @returns A confirmation dialog that keeps cancellation as the initial focus target.\n * @public\n */\nexport function ConfirmDialog(props: ConfirmDialogProps) {\n  const {\n    open,\n    onOpenChange,\n    title,\n    description,\n    confirmLabel,\n    cancelLabel,\n    tone = \"normal\",\n    confirmationText,\n    pending = false,\n    error,\n    onConfirm,\n  } = props;\n  const { t } = useMiaixzLocale();\n  const confirmationInputRef = useRef<HTMLInputElement>(null);\n  const previousOpenRef = useRef(open);\n  const internalPendingRef = useRef(false);\n  const [internalPending, setInternalPending] = useState(false);\n  const [confirmationMatches, setConfirmationMatches] = useState(confirmationText === undefined);\n  const isPending = pending || internalPending;\n  const canConfirm = confirmationText === undefined || confirmationMatches;\n\n  useEffect(() => {\n    const opened = open && !previousOpenRef.current;\n    previousOpenRef.current = open;\n    if (opened) {\n      if (confirmationInputRef.current !== null) confirmationInputRef.current.value = \"\";\n      setConfirmationMatches(confirmationText === undefined);\n      return;\n    }\n    if (open && confirmationText !== undefined) {\n      setConfirmationMatches(confirmationInputRef.current?.value === confirmationText);\n    }\n  }, [confirmationText, open]);\n\n  /**\n   * Forwards dismissal requests only while no confirmation operation is pending.\n   *\n   * @param nextOpen - Requested controlled open state.\n   */\n  const handleOpenChange = (nextOpen: boolean): void => {\n    if (!nextOpen && (pending || internalPendingRef.current)) return;\n    onOpenChange(nextOpen);\n  };\n\n  /**\n   * Runs the confirmation action exactly once and contains synchronous or asynchronous failures.\n   */\n  const handleConfirm = async (): Promise<void> => {\n    if (pending || internalPendingRef.current || !canConfirm) return;\n    internalPendingRef.current = true;\n    setInternalPending(true);\n    try {\n      await onConfirm();\n      onOpenChange(false);\n    } catch {\n      // Consumers own localized error presentation through the explicit error property.\n    } finally {\n      internalPendingRef.current = false;\n      setInternalPending(false);\n    }\n  };\n\n  return (\n    <Dialog\n      open={open}\n      onOpenChange={handleOpenChange}\n      title={title}\n      description={description}\n      size=\"small\"\n      showClose={false}\n      aria-busy={isPending || undefined}\n      className=\"miaixz-confirm-dialog\"\n    >\n      <div className=\"miaixz-confirm-dialog-content\">\n        <Button\n          className=\"miaixz-confirm-dialog-cancel\"\n          disabled={isPending}\n          onClick={() => handleOpenChange(false)}\n        >\n          {cancelLabel}\n        </Button>\n        {confirmationText !== undefined && (\n          <div className=\"miaixz-confirm-dialog-input\">\n            <Input\n              ref={confirmationInputRef}\n              aria-label={t(\"ui.confirm.confirmationInputLabel\")}\n              autoComplete=\"off\"\n              disabled={isPending}\n              spellCheck={false}\n              onChange={(event) =>\n                setConfirmationMatches(event.currentTarget.value === confirmationText)\n              }\n            />\n          </div>\n        )}\n        {error !== undefined && (\n          <InlineMessage tone=\"danger\" className=\"miaixz-confirm-dialog-error\">\n            {error}\n          </InlineMessage>\n        )}\n        <Button\n          className=\"miaixz-confirm-dialog-confirm\"\n          variant={tone === \"danger\" ? \"danger\" : \"primary\"}\n          disabled={!canConfirm || isPending}\n          loading={isPending}\n          onClick={() => void handleConfirm()}\n        >\n          {confirmLabel}\n        </Button>\n      </div>\n    </Dialog>\n  );\n}\n"]}

package/dist/components/confirm-dialog/confirm-dialog.types.d.ts

@@ -0,0 +1,63 @@
+import type { ReactNode } from "react";
+/**
+ * Defines the semantic treatment of a confirmation action.
+ *
+ * @public
+ */
+export type ConfirmDialogTone = "normal" | "danger";
+/**
+ * Configures a controlled confirmation dialog without exposing native dialog attributes.
+ *
+ * @public
+ */
+export interface ConfirmDialogProps {
+    /**
+     * Controls whether the confirmation dialog is open.
+     */
+    open: boolean;
+    /**
+     * Receives accepted open-state changes.
+     */
+    onOpenChange: (open: boolean) => void;
+    /**
+     * Supplies the confirmation heading.
+     */
+    title: ReactNode;
+    /**
+     * Supplies the confirmation description.
+     */
+    description: ReactNode;
+    /**
+     * Supplies the visible confirmation action label.
+     */
+    confirmLabel: string;
+    /**
+     * Supplies the visible cancellation action label.
+     */
+    cancelLabel: string;
+    /**
+     * Selects the normal or destructive confirmation treatment.
+     *
+     * @defaultValue `"normal"`
+     */
+    tone?: ConfirmDialogTone;
+    /**
+     * Requires an exact internally managed text entry before confirmation.
+     */
+    confirmationText?: string;
+    /**
+     * Disables dismissal and actions while an externally managed operation is pending.
+     *
+     * @defaultValue `false`
+     */
+    pending?: boolean;
+    /**
+     * Supplies an already localized failure message.
+     */
+    error?: ReactNode;
+    /**
+     * Runs the confirmation action synchronously or asynchronously.
+     */
+    onConfirm: () => void | Promise<void>;
+}
+//# sourceMappingURL=confirm-dialog.types.d.ts.map

package/dist/components/confirm-dialog/confirm-dialog.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-dialog.types.d.ts","sourceRoot":"","sources":["../../../src/components/confirm-dialog/confirm-dialog.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEpD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IACd;;OAEG;IACH,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACtC;;OAEG;IACH,KAAK,EAAE,SAAS,CAAC;IACjB;;OAEG;IACH,WAAW,EAAE,SAAS,CAAC;IACvB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,iBAAiB,CAAC;IACzB;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC"}

package/dist/components/confirm-dialog/confirm-dialog.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=confirm-dialog.types.js.map

package/dist/components/confirm-dialog/confirm-dialog.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm-dialog.types.js","sourceRoot":"","sources":["../../../src/components/confirm-dialog/confirm-dialog.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { ReactNode } from \"react\";\n\n/**\n * Defines the semantic treatment of a confirmation action.\n *\n * @public\n */\nexport type ConfirmDialogTone = \"normal\" | \"danger\";\n\n/**\n * Configures a controlled confirmation dialog without exposing native dialog attributes.\n *\n * @public\n */\nexport interface ConfirmDialogProps {\n  /**\n   * Controls whether the confirmation dialog is open.\n   */\n  open: boolean;\n  /**\n   * Receives accepted open-state changes.\n   */\n  onOpenChange: (open: boolean) => void;\n  /**\n   * Supplies the confirmation heading.\n   */\n  title: ReactNode;\n  /**\n   * Supplies the confirmation description.\n   */\n  description: ReactNode;\n  /**\n   * Supplies the visible confirmation action label.\n   */\n  confirmLabel: string;\n  /**\n   * Supplies the visible cancellation action label.\n   */\n  cancelLabel: string;\n  /**\n   * Selects the normal or destructive confirmation treatment.\n   *\n   * @defaultValue `\"normal\"`\n   */\n  tone?: ConfirmDialogTone;\n  /**\n   * Requires an exact internally managed text entry before confirmation.\n   */\n  confirmationText?: string;\n  /**\n   * Disables dismissal and actions while an externally managed operation is pending.\n   *\n   * @defaultValue `false`\n   */\n  pending?: boolean;\n  /**\n   * Supplies an already localized failure message.\n   */\n  error?: ReactNode;\n  /**\n   * Runs the confirmation action synchronously or asynchronously.\n   */\n  onConfirm: () => void | Promise<void>;\n}\n"]}

package/dist/components/confirm-dialog/index.d.ts

@@ -0,0 +1,3 @@
+export { ConfirmDialog } from "./confirm-dialog.js";
+export type { ConfirmDialogProps, ConfirmDialogTone } from "./confirm-dialog.types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/confirm-dialog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/confirm-dialog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/components/confirm-dialog/index.js

@@ -0,0 +1,2 @@
+export { ConfirmDialog } from "./confirm-dialog.js";
+//# sourceMappingURL=index.js.map

package/dist/components/confirm-dialog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/confirm-dialog/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC","sourcesContent":["export { ConfirmDialog } from \"./confirm-dialog.js\";\nexport type { ConfirmDialogProps, ConfirmDialogTone } from \"./confirm-dialog.types.js\";\n"]}

package/dist/components/data-table/data-table.d.ts

@@ -0,0 +1,9 @@
+import { type ReactElement, type RefAttributes } from "react";
+import type { DataTableProps } from "./data-table.types.js";
+/**
+ * Renders a generic controlled server-side data table.
+ *
+ * @public
+ */
+export declare const DataTable: <Row>(props: DataTableProps<Row> & RefAttributes<HTMLDivElement>) => ReactElement;
+//# sourceMappingURL=data-table.d.ts.map

package/dist/components/data-table/data-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table.d.ts","sourceRoot":"","sources":["../../../src/components/data-table/data-table.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAqBjF,OAAO,KAAK,EAEV,cAAc,EAGf,MAAM,uBAAuB,CAAC;AA8X/B;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAA0C,CAAC,GAAG,EAClE,KAAK,EAAE,cAAc,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,cAAc,CAAC,KACvD,YAAY,CAAC"}

package/dist/components/data-table/data-table.js

@@ -0,0 +1,198 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useId } from "react";
+import { createMiaixzUiError } from "../../errors/index.js";
+import { useMiaixzLocale } from "../../i18n/index.js";
+import { classNames } from "../../internal/class-names.js";
+import { Checkbox } from "../checkbox/index.js";
+import { Icon } from "../icon/index.js";
+import { LoadingOverlay } from "../loading-overlay/index.js";
+import { Radio } from "../radio/index.js";
+import { Table, TableBody, TableCaption, TableCell, TableContainer, TableHead, TableHeader, TableRow, } from "../table/index.js";
+/**
+ * Resolves the visual and semantic state exposed by the DataTable root.
+ *
+ * @param loading - Whether server data is currently loading.
+ * @param error - Project-owned error content.
+ * @param rowCount - Current page row count.
+ * @returns Stable DataTable state attribute.
+ */
+function getMiaixzDataTableState(loading, error, rowCount) {
+    if (loading)
+        return "loading";
+    if (error !== undefined)
+        return "error";
+    if (rowCount === 0)
+        return "empty";
+    return "ready";
+}
+/**
+ * Validates unique column identifiers before rendering semantic headings.
+ *
+ * @typeParam Row - Consumer-owned row shape.
+ * @param translate - Active localized message resolver.
+ * @param columns - Consumer-provided column definitions.
+ */
+function validateMiaixzDataTableColumns(translate, columns) {
+    const identifiers = new Set();
+    for (const column of columns) {
+        if (identifiers.has(column.id)) {
+            throw createMiaixzUiError(translate, {
+                code: "UI_TABLE_DUPLICATE_COLUMN_ID",
+                messageKey: "ui.error.table.duplicateColumnId",
+                details: { duplicateId: column.id },
+            });
+        }
+        identifiers.add(column.id);
+    }
+}
+/**
+ * Resolves row identifiers once and rejects duplicate values.
+ *
+ * @typeParam Row - Consumer-owned row shape.
+ * @param translate - Active localized message resolver.
+ * @param rows - Current server-provided page.
+ * @param getRowId - Consumer identifier resolver.
+ * @returns Current rows paired with validated identifiers.
+ */
+function createMiaixzDataTableRows(translate, rows, getRowId) {
+    const identifiers = new Set();
+    return rows.map((row) => {
+        const id = getRowId(row);
+        if (identifiers.has(id)) {
+            throw createMiaixzUiError(translate, {
+                code: "UI_TABLE_DUPLICATE_ROW_ID",
+                messageKey: "ui.error.table.duplicateRowId",
+                details: { duplicateId: id },
+            });
+        }
+        identifiers.add(id);
+        return { id, value: row };
+    });
+}
+/**
+ * Validates controlled sort and row-selection contracts.
+ *
+ * @param translate - Active localized message resolver.
+ * @param sortControlled - Whether a controlled sort value was supplied.
+ * @param hasSortHandler - Whether sort intentions can be observed.
+ * @param selectionControlled - Whether controlled selected identifiers were supplied.
+ * @param hasSelectionHandler - Whether selection intentions can be observed.
+ */
+function validateMiaixzDataTableControls(translate, sortControlled, hasSortHandler, selectionControlled, hasSelectionHandler) {
+    if ((sortControlled && !hasSortHandler) || (selectionControlled && !hasSelectionHandler)) {
+        throw createMiaixzUiError(translate, {
+            code: "UI_CONTROLLED_VALUE_INVALID",
+            messageKey: "ui.error.controlled.valueInvalid",
+        });
+    }
+}
+/**
+ * Produces the next sort intent in the frozen three-state cycle.
+ *
+ * @param columnId - Activated sortable column identifier.
+ * @param current - Current controlled server-side sort state.
+ * @returns Next sort intent or undefined when the cycle resets.
+ */
+function getNextMiaixzDataTableSort(columnId, current) {
+    if (current?.columnId !== columnId)
+        return { columnId, direction: "ascending" };
+    if (current.direction === "ascending")
+        return { columnId, direction: "descending" };
+    return undefined;
+}
+/**
+ * Resolves the sort direction associated with one heading.
+ *
+ * @param columnId - Column identifier being rendered.
+ * @param sort - Current controlled server-side sort state.
+ * @returns Active ARIA sort direction when this is the sorted column.
+ */
+function getMiaixzDataTableColumnSort(columnId, sort) {
+    return sort?.columnId === columnId ? sort.direction : undefined;
+}
+/**
+ * Creates a logical alignment class shared by a heading and its body cells.
+ *
+ * @param align - Optional column alignment.
+ * @returns Stable alignment class name.
+ */
+function getMiaixzDataTableAlignmentClass(align) {
+    return `miaixz-data-table-align-${align ?? "start"}`;
+}
+/**
+ * Renders the generic controlled DataTable implementation.
+ *
+ * @typeParam Row - Consumer-owned row shape.
+ * @param properties - DataTable properties and inherited div attributes.
+ * @param reference - Forwarded DataTable root reference.
+ * @returns Semantic table, async states, and optional pagination slot.
+ */
+function DataTableImplementation(properties, reference) {
+    const { rows, columns, getRowId, sort, onSortChange, selectedRowIds, onSelectedRowIdsChange, selectionMode = "none", loading = false, error, emptyState, pagination, caption, className, ...props } = properties;
+    const { t } = useMiaixzLocale();
+    const selectionName = useId();
+    validateMiaixzDataTableControls(t, sort !== undefined, onSortChange !== undefined, selectedRowIds !== undefined, onSelectedRowIdsChange !== undefined);
+    validateMiaixzDataTableColumns(t, columns);
+    const resolvedRows = createMiaixzDataTableRows(t, rows, getRowId);
+    const selectedIds = new Set(selectedRowIds ?? []);
+    const currentIds = new Set(resolvedRows.map((row) => row.id));
+    const selectedCurrentIds = resolvedRows.filter((row) => selectedIds.has(row.id));
+    if (selectionMode === "single" && selectedCurrentIds.length > 1) {
+        throw createMiaixzUiError(t, {
+            code: "UI_CONTROLLED_VALUE_INVALID",
+            messageKey: "ui.error.controlled.valueInvalid",
+        });
+    }
+    const hasSelectionColumn = selectionMode !== "none";
+    const columnCount = columns.length + (hasSelectionColumn ? 1 : 0);
+    const allCurrentSelected = resolvedRows.length > 0 && selectedCurrentIds.length === rows.length;
+    const someCurrentSelected = selectedCurrentIds.length > 0 && !allCurrentSelected;
+    const state = getMiaixzDataTableState(loading, error, rows.length);
+    /**
+     * Reports one current-page row-selection intent without retaining internal state.
+     *
+     * @param rowId - Activated row identifier.
+     * @param selected - Requested native control state.
+     */
+    function changeRowSelection(rowId, selected) {
+        if (selectionMode === "single") {
+            onSelectedRowIdsChange?.(selected ? [rowId] : []);
+            return;
+        }
+        const nextIds = new Set(selectedIds);
+        if (selected)
+            nextIds.add(rowId);
+        else
+            nextIds.delete(rowId);
+        onSelectedRowIdsChange?.([...nextIds]);
+    }
+    /**
+     * Reports a current-page select-all intent while preserving invisible identifiers.
+     */
+    function changePageSelection() {
+        const nextIds = new Set(selectedIds);
+        if (allCurrentSelected) {
+            for (const id of currentIds)
+                nextIds.delete(id);
+        }
+        else {
+            for (const id of currentIds)
+                nextIds.add(id);
+        }
+        onSelectedRowIdsChange?.([...nextIds]);
+    }
+    return (_jsxs("div", { ...props, ref: reference, "aria-busy": loading || undefined, "data-state": state, className: classNames("miaixz-data-table", className), children: [_jsx(LoadingOverlay, { active: loading, label: t("ui.loading"), children: _jsx(TableContainer, { "aria-label": caption, role: "region", tabIndex: 0, className: "miaixz-data-table-container", children: _jsxs(Table, { children: [_jsx(TableCaption, { children: caption }), _jsx(TableHeader, { children: _jsxs(TableRow, { children: [selectionMode === "multiple" && (_jsx(TableHead, { className: "miaixz-data-table-selection-cell", scope: "col", children: _jsx(Checkbox, { "aria-label": t("ui.table.selectPage"), checked: allCurrentSelected, indeterminate: someCurrentSelected, disabled: resolvedRows.length === 0 || onSelectedRowIdsChange === undefined, onChange: changePageSelection, className: "miaixz-data-table-selection-control" }) })), selectionMode === "single" && (_jsx(TableHead, { className: "miaixz-data-table-selection-cell", scope: "col" })), columns.map((column) => {
+                                            const direction = getMiaixzDataTableColumnSort(column.id, sort);
+                                            return (_jsx(TableHead, { scope: "col", "aria-sort": direction, className: classNames("miaixz-data-table-heading", getMiaixzDataTableAlignmentClass(column.align)), children: column.sortable ? (_jsxs("button", { type: "button", disabled: onSortChange === undefined, "data-state": direction ?? "none", className: "miaixz-data-table-sort", onClick: () => onSortChange?.(getNextMiaixzDataTableSort(column.id, sort)), children: [_jsx("span", { className: "miaixz-data-table-heading-content", children: column.header }), _jsx(Icon, { name: "ChevronDown", size: "inline", className: "miaixz-data-table-sort-icon" })] })) : (column.header) }, column.id));
+                                        })] }) }), _jsx(TableBody, { children: error !== undefined ? (_jsx(TableRow, { children: _jsx(TableCell, { colSpan: columnCount, className: "miaixz-data-table-state-cell", children: _jsx("div", { className: "miaixz-data-table-error", role: "alert", children: error }) }) })) : resolvedRows.length === 0 ? (_jsx(TableRow, { children: _jsx(TableCell, { colSpan: columnCount, className: "miaixz-data-table-state-cell", children: _jsx("div", { className: "miaixz-data-table-empty", children: emptyState }) }) })) : (resolvedRows.map((row) => {
+                                    const selected = selectedIds.has(row.id) && hasSelectionColumn;
+                                    return (_jsxs(TableRow, { selected: selected, children: [hasSelectionColumn && (_jsx(TableCell, { className: "miaixz-data-table-selection-cell", children: selectionMode === "multiple" ? (_jsx(Checkbox, { "aria-label": t("ui.table.selectRow"), checked: selected, disabled: onSelectedRowIdsChange === undefined, onChange: (event) => changeRowSelection(row.id, event.currentTarget.checked), className: "miaixz-data-table-selection-control" })) : (_jsx(Radio, { "aria-label": t("ui.table.selectRow"), name: selectionName, checked: selected, disabled: onSelectedRowIdsChange === undefined, onChange: (event) => changeRowSelection(row.id, event.currentTarget.checked), className: "miaixz-data-table-selection-control" })) })), columns.map((column) => (_jsx(TableCell, { className: classNames("miaixz-data-table-cell", getMiaixzDataTableAlignmentClass(column.align)), children: column.cell(row.value) }, column.id)))] }, row.id));
+                                })) })] }) }) }), pagination !== undefined && _jsx("div", { className: "miaixz-data-table-pagination", children: pagination })] }));
+}
+/**
+ * Renders a generic controlled server-side data table.
+ *
+ * @public
+ */
+export const DataTable = forwardRef(DataTableImplementation);
+//# sourceMappingURL=data-table.js.map

package/dist/components/data-table/data-table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table.js","sourceRoot":"","sources":["../../../src/components/data-table/data-table.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAyC,MAAM,OAAO,CAAC;AAIjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EACL,KAAK,EACL,SAAS,EACT,YAAY,EACZ,SAAS,EACT,cAAc,EACd,SAAS,EACT,WAAW,EACX,QAAQ,GACT,MAAM,mBAAmB,CAAC;AAyB3B;;;;;;;GAOG;AACH,SAAS,uBAAuB,CAC9B,OAAgB,EAChB,KAAc,EACd,QAAgB;IAEhB,IAAI,OAAO;QAAE,OAAO,SAAS,CAAC;IAC9B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IACxC,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACnC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,8BAA8B,CACrC,SAA2B,EAC3B,OAAwC;IAExC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/B,MAAM,mBAAmB,CAAC,SAAS,EAAE;gBACnC,IAAI,EAAE,8BAA8B;gBACpC,UAAU,EAAE,kCAAkC;gBAC9C,OAAO,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,yBAAyB,CAChC,SAA2B,EAC3B,IAAoB,EACpB,QAAwC;IAExC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,MAAM,EAAE,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YACxB,MAAM,mBAAmB,CAAC,SAAS,EAAE;gBACnC,IAAI,EAAE,2BAA2B;gBACjC,UAAU,EAAE,+BAA+B;gBAC3C,OAAO,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;aAC7B,CAAC,CAAC;QACL,CAAC;QACD,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACpB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,+BAA+B,CACtC,SAA2B,EAC3B,cAAuB,EACvB,cAAuB,EACvB,mBAA4B,EAC5B,mBAA4B;IAE5B,IAAI,CAAC,cAAc,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACzF,MAAM,mBAAmB,CAAC,SAAS,EAAE;YACnC,IAAI,EAAE,6BAA6B;YACnC,UAAU,EAAE,kCAAkC;SAC/C,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,0BAA0B,CACjC,QAAgB,EAChB,OAAkC;IAElC,IAAI,OAAO,EAAE,QAAQ,KAAK,QAAQ;QAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;IAChF,IAAI,OAAO,CAAC,SAAS,KAAK,WAAW;QAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;IACpF,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,4BAA4B,CACnC,QAAgB,EAChB,IAA+B;IAE/B,OAAO,IAAI,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AAClE,CAAC;AAED;;;;;GAKG;AACH,SAAS,gCAAgC,CAAC,KAAwC;IAChF,OAAO,2BAA2B,KAAK,IAAI,OAAO,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,uBAAuB,CAC9B,UAA+B,EAC/B,SAA6C;IAE7C,MAAM,EACJ,IAAI,EACJ,OAAO,EACP,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,sBAAsB,EACtB,aAAa,GAAG,MAAM,EACtB,OAAO,GAAG,KAAK,EACf,KAAK,EACL,UAAU,EACV,UAAU,EACV,OAAO,EACP,SAAS,EACT,GAAG,KAAK,EACT,GAAG,UAAU,CAAC;IACf,MAAM,EAAE,CAAC,EAAE,GAAG,eAAe,EAAE,CAAC;IAChC,MAAM,aAAa,GAAG,KAAK,EAAE,CAAC;IAC9B,+BAA+B,CAC7B,CAAC,EACD,IAAI,KAAK,SAAS,EAClB,YAAY,KAAK,SAAS,EAC1B,cAAc,KAAK,SAAS,EAC5B,sBAAsB,KAAK,SAAS,CACrC,CAAC;IACF,8BAA8B,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,yBAAyB,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACjF,IAAI,aAAa,KAAK,QAAQ,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,MAAM,mBAAmB,CAAC,CAAC,EAAE;YAC3B,IAAI,EAAE,6BAA6B;YACnC,UAAU,EAAE,kCAAkC;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,kBAAkB,GAAG,aAAa,KAAK,MAAM,CAAC;IACpD,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,kBAAkB,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC;IAChG,MAAM,mBAAmB,GAAG,kBAAkB,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC;IACjF,MAAM,KAAK,GAAG,uBAAuB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAEnE;;;;;OAKG;IACH,SAAS,kBAAkB,CAAC,KAAa,EAAE,QAAiB;QAC1D,IAAI,aAAa,KAAK,QAAQ,EAAE,CAAC;YAC/B,sBAAsB,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAClD,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,QAAQ;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;;YAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,sBAAsB,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,SAAS,mBAAmB;QAC1B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,CAAC;QACrC,IAAI,kBAAkB,EAAE,CAAC;YACvB,KAAK,MAAM,EAAE,IAAI,UAAU;gBAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,EAAE,IAAI,UAAU;gBAAE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,sBAAsB,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,OAAO,CACL,kBACM,KAAK,EACT,GAAG,EAAE,SAAS,eACH,OAAO,IAAI,SAAS,gBACnB,KAAK,EACjB,SAAS,EAAE,UAAU,CAAC,mBAAmB,EAAE,SAAS,CAAC,aAErD,KAAC,cAAc,IAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,YAAY,CAAC,YACrD,KAAC,cAAc,kBACD,OAAO,EACnB,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,CAAC,EACX,SAAS,EAAC,6BAA6B,YAEvC,MAAC,KAAK,eACJ,KAAC,YAAY,cAAE,OAAO,GAAgB,EACtC,KAAC,WAAW,cACV,MAAC,QAAQ,eACN,aAAa,KAAK,UAAU,IAAI,CAC/B,KAAC,SAAS,IAAC,SAAS,EAAC,kCAAkC,EAAC,KAAK,EAAC,KAAK,YACjE,KAAC,QAAQ,kBACK,CAAC,CAAC,qBAAqB,CAAC,EACpC,OAAO,EAAE,kBAAkB,EAC3B,aAAa,EAAE,mBAAmB,EAClC,QAAQ,EAAE,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,sBAAsB,KAAK,SAAS,EAC3E,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAC,qCAAqC,GAC/C,GACQ,CACb,EACA,aAAa,KAAK,QAAQ,IAAI,CAC7B,KAAC,SAAS,IAAC,SAAS,EAAC,kCAAkC,EAAC,KAAK,EAAC,KAAK,GAAG,CACvE,EACA,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;4CACtB,MAAM,SAAS,GAAG,4BAA4B,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;4CAChE,OAAO,CACL,KAAC,SAAS,IAER,KAAK,EAAC,KAAK,eACA,SAAS,EACpB,SAAS,EAAE,UAAU,CACnB,2BAA2B,EAC3B,gCAAgC,CAAC,MAAM,CAAC,KAAK,CAAC,CAC/C,YAEA,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CACjB,kBACE,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,YAAY,KAAK,SAAS,gBACxB,SAAS,IAAI,MAAM,EAC/B,SAAS,EAAC,wBAAwB,EAClC,OAAO,EAAE,GAAG,EAAE,CACZ,YAAY,EAAE,CAAC,0BAA0B,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,aAG7D,eAAM,SAAS,EAAC,mCAAmC,YAAE,MAAM,CAAC,MAAM,GAAQ,EAC1E,KAAC,IAAI,IACH,IAAI,EAAC,aAAa,EAClB,IAAI,EAAC,QAAQ,EACb,SAAS,EAAC,6BAA6B,GACvC,IACK,CACV,CAAC,CAAC,CAAC,CACF,MAAM,CAAC,MAAM,CACd,IA3BI,MAAM,CAAC,EAAE,CA4BJ,CACb,CAAC;wCACJ,CAAC,CAAC,IACO,GACC,EACd,KAAC,SAAS,cACP,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,CACrB,KAAC,QAAQ,cACP,KAAC,SAAS,IAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAC,8BAA8B,YACvE,cAAK,SAAS,EAAC,yBAAyB,EAAC,IAAI,EAAC,OAAO,YAClD,KAAK,GACF,GACI,GACH,CACZ,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAC9B,KAAC,QAAQ,cACP,KAAC,SAAS,IAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAC,8BAA8B,YACvE,cAAK,SAAS,EAAC,yBAAyB,YAAE,UAAU,GAAO,GACjD,GACH,CACZ,CAAC,CAAC,CAAC,CACF,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;oCACvB,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,kBAAkB,CAAC;oCAC/D,OAAO,CACL,MAAC,QAAQ,IAAc,QAAQ,EAAE,QAAQ,aACtC,kBAAkB,IAAI,CACrB,KAAC,SAAS,IAAC,SAAS,EAAC,kCAAkC,YACpD,aAAa,KAAK,UAAU,CAAC,CAAC,CAAC,CAC9B,KAAC,QAAQ,kBACK,CAAC,CAAC,oBAAoB,CAAC,EACnC,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,sBAAsB,KAAK,SAAS,EAC9C,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAClB,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,EAEzD,SAAS,EAAC,qCAAqC,GAC/C,CACH,CAAC,CAAC,CAAC,CACF,KAAC,KAAK,kBACQ,CAAC,CAAC,oBAAoB,CAAC,EACnC,IAAI,EAAE,aAAa,EACnB,OAAO,EAAE,QAAQ,EACjB,QAAQ,EAAE,sBAAsB,KAAK,SAAS,EAC9C,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAClB,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,EAEzD,SAAS,EAAC,qCAAqC,GAC/C,CACH,GACS,CACb,EACA,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CACvB,KAAC,SAAS,IAER,SAAS,EAAE,UAAU,CACnB,wBAAwB,EACxB,gCAAgC,CAAC,MAAM,CAAC,KAAK,CAAC,CAC/C,YAEA,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IANlB,MAAM,CAAC,EAAE,CAOJ,CACb,CAAC,KArCW,GAAG,CAAC,EAAE,CAsCV,CACZ,CAAC;gCACJ,CAAC,CAAC,CACH,GACS,IACN,GACO,GACF,EAChB,UAAU,KAAK,SAAS,IAAI,cAAK,SAAS,EAAC,8BAA8B,YAAE,UAAU,GAAO,IACzF,CACP,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC,uBAAuB,CAE1C,CAAC","sourcesContent":["import { forwardRef, useId, type ReactElement, type RefAttributes } from \"react\";\n\nimport type { MiaixzTranslator } from \"@miaixz/sdk/i18n\";\n\nimport { createMiaixzUiError } from \"../../errors/index.js\";\nimport { useMiaixzLocale } from \"../../i18n/index.js\";\nimport { classNames } from \"../../internal/class-names.js\";\nimport { Checkbox } from \"../checkbox/index.js\";\nimport { Icon } from \"../icon/index.js\";\nimport { LoadingOverlay } from \"../loading-overlay/index.js\";\nimport { Radio } from \"../radio/index.js\";\nimport {\n  Table,\n  TableBody,\n  TableCaption,\n  TableCell,\n  TableContainer,\n  TableHead,\n  TableHeader,\n  TableRow,\n} from \"../table/index.js\";\nimport type {\n  DataTableColumn,\n  DataTableProps,\n  DataTableSort,\n  DataTableSortDirection,\n} from \"./data-table.types.js\";\n\n/**\n * Associates one immutable row value with its validated identifier.\n *\n * @typeParam Row - Consumer-owned row shape.\n */\ninterface MiaixzDataTableRow<Row> {\n  /**\n   * Contains the validated unique row identifier.\n   */\n  readonly id: string;\n\n  /**\n   * Contains the original consumer-owned row value.\n   */\n  readonly value: Row;\n}\n\n/**\n * Resolves the visual and semantic state exposed by the DataTable root.\n *\n * @param loading - Whether server data is currently loading.\n * @param error - Project-owned error content.\n * @param rowCount - Current page row count.\n * @returns Stable DataTable state attribute.\n */\nfunction getMiaixzDataTableState(\n  loading: boolean,\n  error: unknown,\n  rowCount: number,\n): \"loading\" | \"error\" | \"empty\" | \"ready\" {\n  if (loading) return \"loading\";\n  if (error !== undefined) return \"error\";\n  if (rowCount === 0) return \"empty\";\n  return \"ready\";\n}\n\n/**\n * Validates unique column identifiers before rendering semantic headings.\n *\n * @typeParam Row - Consumer-owned row shape.\n * @param translate - Active localized message resolver.\n * @param columns - Consumer-provided column definitions.\n */\nfunction validateMiaixzDataTableColumns<Row>(\n  translate: MiaixzTranslator,\n  columns: readonly DataTableColumn<Row>[],\n): void {\n  const identifiers = new Set<string>();\n  for (const column of columns) {\n    if (identifiers.has(column.id)) {\n      throw createMiaixzUiError(translate, {\n        code: \"UI_TABLE_DUPLICATE_COLUMN_ID\",\n        messageKey: \"ui.error.table.duplicateColumnId\",\n        details: { duplicateId: column.id },\n      });\n    }\n    identifiers.add(column.id);\n  }\n}\n\n/**\n * Resolves row identifiers once and rejects duplicate values.\n *\n * @typeParam Row - Consumer-owned row shape.\n * @param translate - Active localized message resolver.\n * @param rows - Current server-provided page.\n * @param getRowId - Consumer identifier resolver.\n * @returns Current rows paired with validated identifiers.\n */\nfunction createMiaixzDataTableRows<Row>(\n  translate: MiaixzTranslator,\n  rows: readonly Row[],\n  getRowId: (row: Readonly<Row>) => string,\n): readonly MiaixzDataTableRow<Row>[] {\n  const identifiers = new Set<string>();\n  return rows.map((row) => {\n    const id = getRowId(row);\n    if (identifiers.has(id)) {\n      throw createMiaixzUiError(translate, {\n        code: \"UI_TABLE_DUPLICATE_ROW_ID\",\n        messageKey: \"ui.error.table.duplicateRowId\",\n        details: { duplicateId: id },\n      });\n    }\n    identifiers.add(id);\n    return { id, value: row };\n  });\n}\n\n/**\n * Validates controlled sort and row-selection contracts.\n *\n * @param translate - Active localized message resolver.\n * @param sortControlled - Whether a controlled sort value was supplied.\n * @param hasSortHandler - Whether sort intentions can be observed.\n * @param selectionControlled - Whether controlled selected identifiers were supplied.\n * @param hasSelectionHandler - Whether selection intentions can be observed.\n */\nfunction validateMiaixzDataTableControls(\n  translate: MiaixzTranslator,\n  sortControlled: boolean,\n  hasSortHandler: boolean,\n  selectionControlled: boolean,\n  hasSelectionHandler: boolean,\n): void {\n  if ((sortControlled && !hasSortHandler) || (selectionControlled && !hasSelectionHandler)) {\n    throw createMiaixzUiError(translate, {\n      code: \"UI_CONTROLLED_VALUE_INVALID\",\n      messageKey: \"ui.error.controlled.valueInvalid\",\n    });\n  }\n}\n\n/**\n * Produces the next sort intent in the frozen three-state cycle.\n *\n * @param columnId - Activated sortable column identifier.\n * @param current - Current controlled server-side sort state.\n * @returns Next sort intent or undefined when the cycle resets.\n */\nfunction getNextMiaixzDataTableSort(\n  columnId: string,\n  current: DataTableSort | undefined,\n): DataTableSort | undefined {\n  if (current?.columnId !== columnId) return { columnId, direction: \"ascending\" };\n  if (current.direction === \"ascending\") return { columnId, direction: \"descending\" };\n  return undefined;\n}\n\n/**\n * Resolves the sort direction associated with one heading.\n *\n * @param columnId - Column identifier being rendered.\n * @param sort - Current controlled server-side sort state.\n * @returns Active ARIA sort direction when this is the sorted column.\n */\nfunction getMiaixzDataTableColumnSort(\n  columnId: string,\n  sort: DataTableSort | undefined,\n): DataTableSortDirection | undefined {\n  return sort?.columnId === columnId ? sort.direction : undefined;\n}\n\n/**\n * Creates a logical alignment class shared by a heading and its body cells.\n *\n * @param align - Optional column alignment.\n * @returns Stable alignment class name.\n */\nfunction getMiaixzDataTableAlignmentClass(align: DataTableColumn<unknown>[\"align\"]): string {\n  return `miaixz-data-table-align-${align ?? \"start\"}`;\n}\n\n/**\n * Renders the generic controlled DataTable implementation.\n *\n * @typeParam Row - Consumer-owned row shape.\n * @param properties - DataTable properties and inherited div attributes.\n * @param reference - Forwarded DataTable root reference.\n * @returns Semantic table, async states, and optional pagination slot.\n */\nfunction DataTableImplementation<Row>(\n  properties: DataTableProps<Row>,\n  reference: React.ForwardedRef<HTMLDivElement>,\n): ReactElement {\n  const {\n    rows,\n    columns,\n    getRowId,\n    sort,\n    onSortChange,\n    selectedRowIds,\n    onSelectedRowIdsChange,\n    selectionMode = \"none\",\n    loading = false,\n    error,\n    emptyState,\n    pagination,\n    caption,\n    className,\n    ...props\n  } = properties;\n  const { t } = useMiaixzLocale();\n  const selectionName = useId();\n  validateMiaixzDataTableControls(\n    t,\n    sort !== undefined,\n    onSortChange !== undefined,\n    selectedRowIds !== undefined,\n    onSelectedRowIdsChange !== undefined,\n  );\n  validateMiaixzDataTableColumns(t, columns);\n  const resolvedRows = createMiaixzDataTableRows(t, rows, getRowId);\n  const selectedIds = new Set(selectedRowIds ?? []);\n  const currentIds = new Set(resolvedRows.map((row) => row.id));\n  const selectedCurrentIds = resolvedRows.filter((row) => selectedIds.has(row.id));\n  if (selectionMode === \"single\" && selectedCurrentIds.length > 1) {\n    throw createMiaixzUiError(t, {\n      code: \"UI_CONTROLLED_VALUE_INVALID\",\n      messageKey: \"ui.error.controlled.valueInvalid\",\n    });\n  }\n\n  const hasSelectionColumn = selectionMode !== \"none\";\n  const columnCount = columns.length + (hasSelectionColumn ? 1 : 0);\n  const allCurrentSelected = resolvedRows.length > 0 && selectedCurrentIds.length === rows.length;\n  const someCurrentSelected = selectedCurrentIds.length > 0 && !allCurrentSelected;\n  const state = getMiaixzDataTableState(loading, error, rows.length);\n\n  /**\n   * Reports one current-page row-selection intent without retaining internal state.\n   *\n   * @param rowId - Activated row identifier.\n   * @param selected - Requested native control state.\n   */\n  function changeRowSelection(rowId: string, selected: boolean): void {\n    if (selectionMode === \"single\") {\n      onSelectedRowIdsChange?.(selected ? [rowId] : []);\n      return;\n    }\n    const nextIds = new Set(selectedIds);\n    if (selected) nextIds.add(rowId);\n    else nextIds.delete(rowId);\n    onSelectedRowIdsChange?.([...nextIds]);\n  }\n\n  /**\n   * Reports a current-page select-all intent while preserving invisible identifiers.\n   */\n  function changePageSelection(): void {\n    const nextIds = new Set(selectedIds);\n    if (allCurrentSelected) {\n      for (const id of currentIds) nextIds.delete(id);\n    } else {\n      for (const id of currentIds) nextIds.add(id);\n    }\n    onSelectedRowIdsChange?.([...nextIds]);\n  }\n\n  return (\n    <div\n      {...props}\n      ref={reference}\n      aria-busy={loading || undefined}\n      data-state={state}\n      className={classNames(\"miaixz-data-table\", className)}\n    >\n      <LoadingOverlay active={loading} label={t(\"ui.loading\")}>\n        <TableContainer\n          aria-label={caption}\n          role=\"region\"\n          tabIndex={0}\n          className=\"miaixz-data-table-container\"\n        >\n          <Table>\n            <TableCaption>{caption}</TableCaption>\n            <TableHeader>\n              <TableRow>\n                {selectionMode === \"multiple\" && (\n                  <TableHead className=\"miaixz-data-table-selection-cell\" scope=\"col\">\n                    <Checkbox\n                      aria-label={t(\"ui.table.selectPage\")}\n                      checked={allCurrentSelected}\n                      indeterminate={someCurrentSelected}\n                      disabled={resolvedRows.length === 0 || onSelectedRowIdsChange === undefined}\n                      onChange={changePageSelection}\n                      className=\"miaixz-data-table-selection-control\"\n                    />\n                  </TableHead>\n                )}\n                {selectionMode === \"single\" && (\n                  <TableHead className=\"miaixz-data-table-selection-cell\" scope=\"col\" />\n                )}\n                {columns.map((column) => {\n                  const direction = getMiaixzDataTableColumnSort(column.id, sort);\n                  return (\n                    <TableHead\n                      key={column.id}\n                      scope=\"col\"\n                      aria-sort={direction}\n                      className={classNames(\n                        \"miaixz-data-table-heading\",\n                        getMiaixzDataTableAlignmentClass(column.align),\n                      )}\n                    >\n                      {column.sortable ? (\n                        <button\n                          type=\"button\"\n                          disabled={onSortChange === undefined}\n                          data-state={direction ?? \"none\"}\n                          className=\"miaixz-data-table-sort\"\n                          onClick={() =>\n                            onSortChange?.(getNextMiaixzDataTableSort(column.id, sort))\n                          }\n                        >\n                          <span className=\"miaixz-data-table-heading-content\">{column.header}</span>\n                          <Icon\n                            name=\"ChevronDown\"\n                            size=\"inline\"\n                            className=\"miaixz-data-table-sort-icon\"\n                          />\n                        </button>\n                      ) : (\n                        column.header\n                      )}\n                    </TableHead>\n                  );\n                })}\n              </TableRow>\n            </TableHeader>\n            <TableBody>\n              {error !== undefined ? (\n                <TableRow>\n                  <TableCell colSpan={columnCount} className=\"miaixz-data-table-state-cell\">\n                    <div className=\"miaixz-data-table-error\" role=\"alert\">\n                      {error}\n                    </div>\n                  </TableCell>\n                </TableRow>\n              ) : resolvedRows.length === 0 ? (\n                <TableRow>\n                  <TableCell colSpan={columnCount} className=\"miaixz-data-table-state-cell\">\n                    <div className=\"miaixz-data-table-empty\">{emptyState}</div>\n                  </TableCell>\n                </TableRow>\n              ) : (\n                resolvedRows.map((row) => {\n                  const selected = selectedIds.has(row.id) && hasSelectionColumn;\n                  return (\n                    <TableRow key={row.id} selected={selected}>\n                      {hasSelectionColumn && (\n                        <TableCell className=\"miaixz-data-table-selection-cell\">\n                          {selectionMode === \"multiple\" ? (\n                            <Checkbox\n                              aria-label={t(\"ui.table.selectRow\")}\n                              checked={selected}\n                              disabled={onSelectedRowIdsChange === undefined}\n                              onChange={(event) =>\n                                changeRowSelection(row.id, event.currentTarget.checked)\n                              }\n                              className=\"miaixz-data-table-selection-control\"\n                            />\n                          ) : (\n                            <Radio\n                              aria-label={t(\"ui.table.selectRow\")}\n                              name={selectionName}\n                              checked={selected}\n                              disabled={onSelectedRowIdsChange === undefined}\n                              onChange={(event) =>\n                                changeRowSelection(row.id, event.currentTarget.checked)\n                              }\n                              className=\"miaixz-data-table-selection-control\"\n                            />\n                          )}\n                        </TableCell>\n                      )}\n                      {columns.map((column) => (\n                        <TableCell\n                          key={column.id}\n                          className={classNames(\n                            \"miaixz-data-table-cell\",\n                            getMiaixzDataTableAlignmentClass(column.align),\n                          )}\n                        >\n                          {column.cell(row.value)}\n                        </TableCell>\n                      ))}\n                    </TableRow>\n                  );\n                })\n              )}\n            </TableBody>\n          </Table>\n        </TableContainer>\n      </LoadingOverlay>\n      {pagination !== undefined && <div className=\"miaixz-data-table-pagination\">{pagination}</div>}\n    </div>\n  );\n}\n\n/**\n * Renders a generic controlled server-side data table.\n *\n * @public\n */\nexport const DataTable = forwardRef(DataTableImplementation) as <Row>(\n  props: DataTableProps<Row> & RefAttributes<HTMLDivElement>,\n) => ReactElement;\n"]}

package/dist/components/data-table/data-table.types.d.ts

@@ -0,0 +1,127 @@
+import type { HTMLAttributes, ReactNode } from "react";
+/**
+ * Defines the server-owned sort directions exposed by DataTable.
+ *
+ * @public
+ */
+export type DataTableSortDirection = "ascending" | "descending";
+/**
+ * Describes the active server-side sort intent.
+ *
+ * @public
+ */
+export interface DataTableSort {
+    /**
+     * Identifies the column requested by the consumer.
+     */
+    readonly columnId: string;
+    /**
+     * Identifies the requested server-side sort direction.
+     */
+    readonly direction: DataTableSortDirection;
+}
+/**
+ * Defines one generic DataTable column without coupling it to business fields.
+ *
+ * @typeParam Row - Consumer-owned row shape.
+ * @public
+ */
+export interface DataTableColumn<Row> {
+    /**
+     * Supplies the unique column identifier.
+     */
+    readonly id: string;
+    /**
+     * Renders the semantic column heading.
+     */
+    readonly header: ReactNode;
+    /**
+     * Renders a cell for one immutable row value.
+     */
+    readonly cell: (row: Readonly<Row>) => ReactNode;
+    /**
+     * Enables server-side sort intent for this column.
+     *
+     * @defaultValue `false`
+     */
+    readonly sortable?: boolean;
+    /**
+     * Aligns the heading and cells using logical text directions.
+     *
+     * @defaultValue `"start"`
+     */
+    readonly align?: "start" | "center" | "end";
+}
+/**
+ * Defines the properties owned by the generic Miaixz DataTable contract.
+ *
+ * @typeParam Row - Consumer-owned row shape.
+ * @public
+ */
+export interface MiaixzDataTableOwnProps<Row> {
+    /**
+     * Supplies the current server-provided page of rows.
+     */
+    rows: readonly Row[];
+    /**
+     * Supplies immutable generic column definitions.
+     */
+    columns: readonly DataTableColumn<Row>[];
+    /**
+     * Resolves a stable unique identifier for one row.
+     */
+    getRowId: (row: Readonly<Row>) => string;
+    /**
+     * Supplies the controlled server-side sort state.
+     */
+    sort?: DataTableSort;
+    /**
+     * Receives the next server-side sort intent.
+     */
+    onSortChange?: (sort: DataTableSort | undefined) => void;
+    /**
+     * Supplies the controlled selected-row identifiers.
+     */
+    selectedRowIds?: readonly string[];
+    /**
+     * Receives selected identifiers after a current-page selection intent.
+     */
+    onSelectedRowIdsChange?: (ids: readonly string[]) => void;
+    /**
+     * Selects the row-selection behavior.
+     *
+     * @defaultValue `"none"`
+     */
+    selectionMode?: "none" | "single" | "multiple";
+    /**
+     * Indicates that the consumer is loading server data.
+     *
+     * @defaultValue `false`
+     */
+    loading?: boolean;
+    /**
+     * Supplies project-owned error-state content.
+     */
+    error?: ReactNode;
+    /**
+     * Supplies project-owned empty-state content.
+     */
+    emptyState?: ReactNode;
+    /**
+     * Supplies a project-owned server pagination control.
+     */
+    pagination?: ReactNode;
+    /**
+     * Supplies the required accessible table caption.
+     */
+    caption: string;
+}
+/**
+ * Configures a generic controlled server-side data table.
+ *
+ * @typeParam Row - Consumer-owned row shape.
+ * @public
+ */
+export interface DataTableProps<Row> extends Omit<HTMLAttributes<HTMLDivElement>, keyof MiaixzDataTableOwnProps<Row>>, MiaixzDataTableOwnProps<Row> {
+}
+//# sourceMappingURL=data-table.types.d.ts.map

package/dist/components/data-table/data-table.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table.types.d.ts","sourceRoot":"","sources":["../../../src/components/data-table/data-table.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,sBAAsB,GAAG,WAAW,GAAG,YAAY,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,GAAG;IAClC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IAEjD;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;CAC7C;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB,CAAC,GAAG;IAC1C;;OAEG;IACH,IAAI,EAAE,SAAS,GAAG,EAAE,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE,SAAS,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;IAEzC;;OAEG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC;IAEzC;;OAEG;IACH,IAAI,CAAC,EAAE,aAAa,CAAC;IAErB;;OAEG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,KAAK,IAAI,CAAC;IAEzD;;OAEG;IACH,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAEnC;;OAEG;IACH,sBAAsB,CAAC,EAAE,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,KAAK,IAAI,CAAC;IAE1D;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IAE/C;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB;;OAEG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAAC,GAAG,CACjC,SACE,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,uBAAuB,CAAC,GAAG,CAAC,CAAC,EACxE,uBAAuB,CAAC,GAAG,CAAC;CAAG"}

package/dist/components/data-table/data-table.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=data-table.types.js.map

package/dist/components/data-table/data-table.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-table.types.js","sourceRoot":"","sources":["../../../src/components/data-table/data-table.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { HTMLAttributes, ReactNode } from \"react\";\n\n/**\n * Defines the server-owned sort directions exposed by DataTable.\n *\n * @public\n */\nexport type DataTableSortDirection = \"ascending\" | \"descending\";\n\n/**\n * Describes the active server-side sort intent.\n *\n * @public\n */\nexport interface DataTableSort {\n  /**\n   * Identifies the column requested by the consumer.\n   */\n  readonly columnId: string;\n\n  /**\n   * Identifies the requested server-side sort direction.\n   */\n  readonly direction: DataTableSortDirection;\n}\n\n/**\n * Defines one generic DataTable column without coupling it to business fields.\n *\n * @typeParam Row - Consumer-owned row shape.\n * @public\n */\nexport interface DataTableColumn<Row> {\n  /**\n   * Supplies the unique column identifier.\n   */\n  readonly id: string;\n\n  /**\n   * Renders the semantic column heading.\n   */\n  readonly header: ReactNode;\n\n  /**\n   * Renders a cell for one immutable row value.\n   */\n  readonly cell: (row: Readonly<Row>) => ReactNode;\n\n  /**\n   * Enables server-side sort intent for this column.\n   *\n   * @defaultValue `false`\n   */\n  readonly sortable?: boolean;\n\n  /**\n   * Aligns the heading and cells using logical text directions.\n   *\n   * @defaultValue `\"start\"`\n   */\n  readonly align?: \"start\" | \"center\" | \"end\";\n}\n\n/**\n * Defines the properties owned by the generic Miaixz DataTable contract.\n *\n * @typeParam Row - Consumer-owned row shape.\n * @public\n */\nexport interface MiaixzDataTableOwnProps<Row> {\n  /**\n   * Supplies the current server-provided page of rows.\n   */\n  rows: readonly Row[];\n\n  /**\n   * Supplies immutable generic column definitions.\n   */\n  columns: readonly DataTableColumn<Row>[];\n\n  /**\n   * Resolves a stable unique identifier for one row.\n   */\n  getRowId: (row: Readonly<Row>) => string;\n\n  /**\n   * Supplies the controlled server-side sort state.\n   */\n  sort?: DataTableSort;\n\n  /**\n   * Receives the next server-side sort intent.\n   */\n  onSortChange?: (sort: DataTableSort | undefined) => void;\n\n  /**\n   * Supplies the controlled selected-row identifiers.\n   */\n  selectedRowIds?: readonly string[];\n\n  /**\n   * Receives selected identifiers after a current-page selection intent.\n   */\n  onSelectedRowIdsChange?: (ids: readonly string[]) => void;\n\n  /**\n   * Selects the row-selection behavior.\n   *\n   * @defaultValue `\"none\"`\n   */\n  selectionMode?: \"none\" | \"single\" | \"multiple\";\n\n  /**\n   * Indicates that the consumer is loading server data.\n   *\n   * @defaultValue `false`\n   */\n  loading?: boolean;\n\n  /**\n   * Supplies project-owned error-state content.\n   */\n  error?: ReactNode;\n\n  /**\n   * Supplies project-owned empty-state content.\n   */\n  emptyState?: ReactNode;\n\n  /**\n   * Supplies a project-owned server pagination control.\n   */\n  pagination?: ReactNode;\n\n  /**\n   * Supplies the required accessible table caption.\n   */\n  caption: string;\n}\n\n/**\n * Configures a generic controlled server-side data table.\n *\n * @typeParam Row - Consumer-owned row shape.\n * @public\n */\nexport interface DataTableProps<Row>\n  extends\n    Omit<HTMLAttributes<HTMLDivElement>, keyof MiaixzDataTableOwnProps<Row>>,\n    MiaixzDataTableOwnProps<Row> {}\n"]}

package/dist/components/data-table/index.d.ts

@@ -0,0 +1,3 @@
+export { DataTable } from "./data-table.js";
+export type { DataTableColumn, DataTableProps, DataTableSort, DataTableSortDirection, MiaixzDataTableOwnProps, } from "./data-table.types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/data-table/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/data-table/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EACV,eAAe,EACf,cAAc,EACd,aAAa,EACb,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,uBAAuB,CAAC"}

package/dist/components/data-table/index.js

@@ -0,0 +1,2 @@
+export { DataTable } from "./data-table.js";
+//# sourceMappingURL=index.js.map

package/dist/components/data-table/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/data-table/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC","sourcesContent":["export { DataTable } from \"./data-table.js\";\nexport type {\n  DataTableColumn,\n  DataTableProps,\n  DataTableSort,\n  DataTableSortDirection,\n  MiaixzDataTableOwnProps,\n} from \"./data-table.types.js\";\n"]}

package/dist/components/dialog/dialog.d.ts

@@ -0,0 +1,8 @@
+import type { DialogProps } from "./dialog.types.js";
+/**
+ * Controls a native modal dialog with localized dismissal and focus-safe lifecycle.
+ *
+ * @public
+ */
+export declare const Dialog: import("react").ForwardRefExoticComponent<DialogProps & import("react").RefAttributes<HTMLDialogElement>>;
+//# sourceMappingURL=dialog.d.ts.map

package/dist/components/dialog/dialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialog.d.ts","sourceRoot":"","sources":["../../../src/components/dialog/dialog.tsx"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,MAAM,2GA0FjB,CAAC"}