@miaixz/ui 0.5.0

package/dist/components/file-upload/file-upload.js

@@ -0,0 +1,359 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef, useCallback, useEffect, useRef, useState } from "react";
+import { createMiaixzUiError } from "../../errors/index.js";
+import { classNames } from "../../internal/class-names.js";
+import { useMiaixzLocale } from "../../i18n/index.js";
+import { Button } from "../button/index.js";
+import { Dropzone } from "../dropzone/index.js";
+import { Icon } from "../icon/index.js";
+import { Progress } from "../progress/index.js";
+const miaixzUploadConcurrency = 3;
+/**
+ * Parses recognized HTML accept segments while leaving unknown segments to the browser.
+ *
+ * @param accept - Comma-separated native accept expression.
+ * @returns Runtime rules used for deterministic drag-and-drop validation.
+ */
+function parseMiaixzAcceptRules(accept) {
+    if (accept === undefined)
+        return [];
+    const rules = [];
+    for (const rawSegment of accept.split(",")) {
+        const segment = rawSegment.trim().toLowerCase();
+        if (/^\.[^./,\s]+$/.test(segment)) {
+            rules.push({ kind: "extension", value: segment });
+        }
+        else if (/^[a-z0-9!#$&^_.+-]+\/\*$/.test(segment)) {
+            rules.push({ kind: "mime-family", value: segment.slice(0, -1) });
+        }
+        else if (/^[a-z0-9!#$&^_.+-]+\/[a-z0-9!#$&^_.+-]+$/.test(segment)) {
+            rules.push({ kind: "mime", value: segment });
+        }
+    }
+    return Object.freeze(rules);
+}
+/**
+ * Reports whether one file matches at least one recognized runtime accept rule.
+ *
+ * @param file - Browser File selected through input or drag-and-drop.
+ * @param rules - Parsed recognized accept rules.
+ * @returns Whether the file is accepted, including permissive behavior when no rule is recognized.
+ */
+function isMiaixzFileAccepted(file, rules) {
+    if (rules.length === 0)
+        return true;
+    const fileName = file.name.toLowerCase();
+    const mimeType = file.type.toLowerCase();
+    return rules.some((rule) => {
+        if (rule.kind === "extension")
+            return fileName.endsWith(rule.value);
+        if (rule.kind === "mime-family")
+            return mimeType.startsWith(rule.value);
+        return mimeType === rule.value;
+    });
+}
+/**
+ * Resolves and validates the frozen maximum-file contract.
+ *
+ * @param multiple - Whether multiple files are permitted.
+ * @param maxFiles - Optional consumer-supplied maximum.
+ * @param createError - Localized UI error factory.
+ * @returns Effective maximum number of retained files.
+ */
+function resolveMiaixzMaximumFiles(multiple, maxFiles, createError) {
+    if (!multiple) {
+        if (maxFiles !== undefined && maxFiles !== 1)
+            throw createError({ maxFiles, multiple });
+        return 1;
+    }
+    const resolved = maxFiles ?? 10;
+    if (!Number.isInteger(resolved) || resolved <= 0)
+        throw createError({ maxFiles: resolved, multiple });
+    return resolved;
+}
+/**
+ * Maps an upload state to its frozen built-in translation key.
+ *
+ * @param status - Current upload lifecycle state.
+ * @returns Built-in UI message key for the visible and announced status.
+ */
+function getMiaixzUploadStatusKey(status) {
+    return `ui.upload.${status}`;
+}
+/**
+ * Maps an upload state to a frozen Lucide icon name.
+ *
+ * @param status - Current upload lifecycle state.
+ * @returns Registered icon representing the state without relying on color alone.
+ */
+function getMiaixzUploadStatusIcon(status) {
+    if (status === "uploading")
+        return "LoaderCircle";
+    if (status === "success")
+        return "CircleCheck";
+    if (status === "error")
+        return "CircleAlert";
+    if (status === "cancelled")
+        return "X";
+    return "File";
+}
+/**
+ * Renders validated uploads with FIFO scheduling and consumer-owned requests.
+ *
+ * @public
+ */
+export const FileUpload = forwardRef(function FileUpload({ accept, multiple = false, maxFiles, maxSizeBytes, disabled = false, label, dropLabel, browseLabel, upload, onFilesChange, onComplete, onError, className, ...props }, ref) {
+    const { t } = useMiaixzLocale();
+    const [items, setItems] = useState([]);
+    const [validationMessages, setValidationMessages] = useState([]);
+    const itemsRef = useRef(items);
+    const nextIdRef = useRef(0);
+    const mountedRef = useRef(true);
+    const activeIdsRef = useRef(new Set());
+    const controllersRef = useRef(new Map());
+    const acceptRules = parseMiaixzAcceptRules(accept);
+    /**
+     * Creates the frozen invalid maximum-file error with sanitized details.
+     *
+     * @param details - Non-sensitive configuration values that caused the failure.
+     * @returns Localized UI contract error.
+     */
+    function createMaximumFilesError(details) {
+        return createMiaixzUiError(t, {
+            code: "UI_FILE_MAX_FILES_INVALID",
+            messageKey: "ui.error.file.maxFilesInvalid",
+            details,
+        });
+    }
+    const resolvedMaximumFiles = resolveMiaixzMaximumFiles(multiple, maxFiles, createMaximumFilesError);
+    if (maxSizeBytes !== undefined && (!Number.isInteger(maxSizeBytes) || maxSizeBytes <= 0)) {
+        throw createMiaixzUiError(t, {
+            code: "UI_FILE_MAX_SIZE_INVALID",
+            messageKey: "ui.error.file.maxSizeInvalid",
+            details: { maxSizeBytes },
+        });
+    }
+    /**
+     * Commits an immutable item list and optionally publishes its File objects.
+     *
+     * @param nextItems - Complete replacement item list.
+     * @param notify - Whether the frozen onFilesChange condition was met.
+     */
+    const replaceItems = useCallback((nextItems, notify) => {
+        const frozenItems = Object.freeze([...nextItems]);
+        itemsRef.current = frozenItems;
+        setItems(frozenItems);
+        if (notify)
+            onFilesChange?.(Object.freeze(frozenItems.map((item) => item.file)));
+    }, [onFilesChange]);
+    /**
+     * Replaces one item by ID while preserving the current list order.
+     *
+     * @param id - Internal accepted-item identifier.
+     * @param update - Pure item transformation.
+     * @param notify - Whether to publish the unchanged or changed File list.
+     */
+    const updateItem = useCallback((id, update, notify = false) => {
+        replaceItems(itemsRef.current.map((item) => (item.id === id ? update(item) : item)), notify);
+    }, [replaceItems]);
+    /**
+     * Runs one upload attempt and settles only the matching active item.
+     *
+     * @param item - Queued item captured when its FIFO slot became available.
+     */
+    const runUpload = useCallback(async (item) => {
+        const controller = new AbortController();
+        controllersRef.current.set(item.id, controller);
+        let invalidProgressError;
+        /**
+         * Validates and commits one upload progress report.
+         *
+         * @param value - Consumer-reported upload percentage.
+         */
+        function reportProgress(value) {
+            if (!Number.isFinite(value) || value < 0 || value > 100) {
+                invalidProgressError = createMiaixzUiError(t, {
+                    code: "UI_UPLOAD_PROGRESS_INVALID",
+                    messageKey: "ui.error.upload.progressInvalid",
+                    details: { value },
+                });
+                throw invalidProgressError;
+            }
+            if (!mountedRef.current || controller.signal.aborted)
+                return;
+            updateItem(item.id, (current) => current.status === "uploading" ? { ...current, progress: value } : current);
+        }
+        const context = Object.freeze({
+            signal: controller.signal,
+            reportProgress,
+        });
+        let shouldComplete = false;
+        try {
+            await upload(item.file, context);
+            if (invalidProgressError !== undefined)
+                throw invalidProgressError;
+            if (!mountedRef.current || controller.signal.aborted)
+                return;
+            const current = itemsRef.current.find((candidate) => candidate.id === item.id);
+            if (current?.status !== "uploading")
+                return;
+            updateItem(item.id, (candidate) => ({
+                ...candidate,
+                status: "success",
+                progress: 100,
+                completed: true,
+            }));
+            shouldComplete = !current.completed;
+        }
+        catch (error) {
+            if (!mountedRef.current || controller.signal.aborted)
+                return;
+            const current = itemsRef.current.find((candidate) => candidate.id === item.id);
+            if (current?.status !== "uploading")
+                return;
+            const resolvedError = invalidProgressError ?? error;
+            updateItem(item.id, (candidate) => ({ ...candidate, status: "error" }));
+            onError?.(item.file, resolvedError);
+        }
+        finally {
+            if (controllersRef.current.get(item.id) === controller) {
+                controllersRef.current.delete(item.id);
+                activeIdsRef.current.delete(item.id);
+            }
+        }
+        if (shouldComplete && mountedRef.current)
+            onComplete?.(item.file);
+    }, [onComplete, onError, t, updateItem, upload]);
+    useEffect(() => {
+        const availableSlots = miaixzUploadConcurrency - activeIdsRef.current.size;
+        if (availableSlots <= 0)
+            return;
+        const queuedItems = itemsRef.current
+            .filter((item) => item.status === "queued" && !activeIdsRef.current.has(item.id))
+            .slice(0, availableSlots);
+        if (queuedItems.length === 0)
+            return;
+        for (const item of queuedItems)
+            activeIdsRef.current.add(item.id);
+        const queuedIds = new Set(queuedItems.map((item) => item.id));
+        replaceItems(itemsRef.current.map((item) => queuedIds.has(item.id) ? { ...item, status: "uploading" } : item), false);
+        for (const item of queuedItems)
+            void runUpload(item).catch(() => undefined);
+    }, [items, replaceItems, runUpload]);
+    useEffect(() => {
+        const controllers = controllersRef.current;
+        const activeIds = activeIdsRef.current;
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+            for (const controller of controllers.values())
+                controller.abort();
+            controllers.clear();
+            activeIds.clear();
+        };
+    }, []);
+    /**
+     * Creates a localized validation error without retaining file names or content.
+     *
+     * @param code - Frozen file validation machine code.
+     * @param messageKey - Frozen built-in translation key.
+     * @param details - Safe size, MIME, or count diagnostics.
+     * @returns Localized and sanitized UI error.
+     */
+    function createValidationError(code, messageKey, details) {
+        return createMiaixzUiError(t, { code, messageKey, details });
+    }
+    /**
+     * Validates one selection operation, accepts available files, and reports rejections.
+     *
+     * @param files - Files selected through the public Dropzone primitive.
+     */
+    function handleFiles(files) {
+        if (disabled)
+            return;
+        const acceptedItems = [];
+        const errors = [];
+        for (const file of files) {
+            let error;
+            if (!isMiaixzFileAccepted(file, acceptRules)) {
+                error = createValidationError("UI_FILE_TYPE_NOT_ACCEPTED", "ui.error.file.typeNotAccepted", { accept, mimeType: file.type });
+            }
+            else if (maxSizeBytes !== undefined && file.size > maxSizeBytes) {
+                error = createValidationError("UI_FILE_TOO_LARGE", "ui.error.file.tooLarge", {
+                    maxSizeBytes,
+                    sizeBytes: file.size,
+                });
+            }
+            else if (itemsRef.current.length + acceptedItems.length >= resolvedMaximumFiles) {
+                error = createValidationError("UI_FILE_COUNT_EXCEEDED", "ui.error.file.countExceeded", {
+                    maxFiles: resolvedMaximumFiles,
+                });
+            }
+            if (error !== undefined) {
+                errors.push(error);
+                onError?.(file, error);
+                continue;
+            }
+            nextIdRef.current += 1;
+            acceptedItems.push({
+                id: `upload-${nextIdRef.current}`,
+                file,
+                status: "queued",
+                progress: 0,
+                completed: false,
+            });
+        }
+        setValidationMessages(Object.freeze([...new Set(errors.map((error) => error.message))]));
+        if (acceptedItems.length > 0) {
+            replaceItems([...itemsRef.current, ...acceptedItems], true);
+        }
+    }
+    /**
+     * Cancels one queued or active item while retaining its original File for retry.
+     *
+     * @param id - Internal accepted-item identifier.
+     */
+    function handleCancel(id) {
+        if (disabled)
+            return;
+        controllersRef.current.get(id)?.abort();
+        controllersRef.current.delete(id);
+        activeIdsRef.current.delete(id);
+        updateItem(id, (item) => item.status === "queued" || item.status === "uploading"
+            ? { ...item, status: "cancelled" }
+            : item, true);
+    }
+    /**
+     * Returns one failed or cancelled item to the FIFO queue.
+     *
+     * @param id - Internal accepted-item identifier.
+     */
+    function handleRetry(id) {
+        if (disabled)
+            return;
+        setValidationMessages([]);
+        updateItem(id, (item) => item.status === "error" || item.status === "cancelled"
+            ? { ...item, status: "queued", progress: 0, completed: false }
+            : item, true);
+    }
+    /**
+     * Removes one item and aborts any request still associated with it.
+     *
+     * @param id - Internal accepted-item identifier.
+     */
+    function handleRemove(id) {
+        if (disabled)
+            return;
+        controllersRef.current.get(id)?.abort();
+        controllersRef.current.delete(id);
+        activeIdsRef.current.delete(id);
+        replaceItems(itemsRef.current.filter((item) => item.id !== id), true);
+    }
+    return (_jsxs("div", { ...props, ref: ref, role: "group", "aria-label": label, "data-disabled": disabled || undefined, className: classNames("miaixz-file-upload", className), children: [_jsx("span", { className: "miaixz-file-upload-label", children: label }), _jsxs(Dropzone, { ...(accept === undefined ? {} : { accept }), multiple: multiple, disabled: disabled, label: dropLabel, onFiles: handleFiles, children: [_jsx("span", { className: "miaixz-file-upload-drop-label", children: dropLabel }), _jsx("span", { className: "miaixz-file-upload-browse-label", children: browseLabel })] }), validationMessages.length > 0 && (_jsxs("div", { className: "miaixz-file-upload-validation", role: "alert", children: [_jsx(Icon, { name: "CircleAlert", size: "inline" }), _jsx("ul", { className: "miaixz-file-upload-validation-list", children: validationMessages.map((message) => (_jsx("li", { children: message }, message))) })] })), items.length > 0 && (_jsx("ul", { className: "miaixz-file-upload-list", children: items.map((item) => {
+                    const statusLabel = t(getMiaixzUploadStatusKey(item.status));
+                    return (_jsxs("li", { "data-state": item.status, className: "miaixz-file-upload-item", children: [_jsx(Icon, { name: getMiaixzUploadStatusIcon(item.status), size: "control", className: "miaixz-file-upload-status-icon" }), _jsxs("div", { className: "miaixz-file-upload-details", children: [_jsx("span", { className: "miaixz-file-upload-name", children: item.file.name }), _jsx("span", { className: "miaixz-file-upload-status", role: "status", children: statusLabel }), item.status === "uploading" && (_jsx(Progress, { value: item.progress, label: `${item.file.name}: ${statusLabel}`, showValue: true }))] }), _jsxs("div", { className: "miaixz-file-upload-actions", children: [(item.status === "queued" || item.status === "uploading") && (_jsx(Button, { variant: "ghost", size: "small", disabled: disabled, startIcon: _jsx(Icon, { name: "X" }), onClick: () => handleCancel(item.id), children: t("ui.action.cancel") })), (item.status === "error" || item.status === "cancelled") && (_jsx(Button, { variant: "ghost", size: "small", disabled: disabled, startIcon: _jsx(Icon, { name: "RotateCcw" }), onClick: () => handleRetry(item.id), children: t("ui.action.retry") })), (item.status === "success" ||
+                                        item.status === "error" ||
+                                        item.status === "cancelled") && (_jsx(Button, { variant: "ghost", size: "small", disabled: disabled, startIcon: _jsx(Icon, { name: "Trash2" }), onClick: () => handleRemove(item.id), children: t("ui.action.remove") }))] })] }, item.id));
+                }) }))] }));
+});
+//# sourceMappingURL=file-upload.js.map

package/dist/components/file-upload/file-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.js","sourceRoot":"","sources":["../../../src/components/file-upload/file-upload.tsx"],"names":[],"mappings":"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","sourcesContent":["import { forwardRef, useCallback, useEffect, useRef, useState, type ReactElement } from \"react\";\n\nimport { createMiaixzUiError, type MiaixzUiError } from \"../../errors/index.js\";\nimport { classNames } from \"../../internal/class-names.js\";\nimport { useMiaixzLocale } from \"../../i18n/index.js\";\nimport { Button } from \"../button/index.js\";\nimport { Dropzone } from \"../dropzone/index.js\";\nimport { Icon } from \"../icon/index.js\";\nimport { Progress } from \"../progress/index.js\";\nimport type { FileUploadProps, MiaixzUploadContext } from \"./file-upload.types.js\";\n\nconst miaixzUploadConcurrency = 3;\n\n/**\n * Defines the complete internal upload state machine.\n */\ntype MiaixzUploadStatus = \"queued\" | \"uploading\" | \"success\" | \"error\" | \"cancelled\";\n\n/**\n * Stores one accepted file and its request-independent presentation state.\n */\ninterface MiaixzUploadItem {\n  /**\n   * Identifies this selection occurrence within one component instance.\n   */\n  readonly id: string;\n\n  /**\n   * Retains the original browser File object across cancellation and retry.\n   */\n  readonly file: File;\n\n  /**\n   * Indicates the current upload lifecycle state.\n   */\n  readonly status: MiaixzUploadStatus;\n\n  /**\n   * Contains the most recently accepted progress percentage.\n   */\n  readonly progress: number;\n\n  /**\n   * Prevents duplicate completion callbacks for one accepted item.\n   */\n  readonly completed: boolean;\n}\n\n/**\n * Represents one recognized runtime accept rule.\n */\ninterface MiaixzAcceptRule {\n  /**\n   * Identifies the extension, exact MIME, or MIME family matcher.\n   */\n  readonly kind: \"extension\" | \"mime\" | \"mime-family\";\n\n  /**\n   * Contains the normalized comparison value.\n   */\n  readonly value: string;\n}\n\n/**\n * Parses recognized HTML accept segments while leaving unknown segments to the browser.\n *\n * @param accept - Comma-separated native accept expression.\n * @returns Runtime rules used for deterministic drag-and-drop validation.\n */\nfunction parseMiaixzAcceptRules(accept: string | undefined): readonly MiaixzAcceptRule[] {\n  if (accept === undefined) return [];\n  const rules: MiaixzAcceptRule[] = [];\n  for (const rawSegment of accept.split(\",\")) {\n    const segment = rawSegment.trim().toLowerCase();\n    if (/^\\.[^./,\\s]+$/.test(segment)) {\n      rules.push({ kind: \"extension\", value: segment });\n    } else if (/^[a-z0-9!#$&^_.+-]+\\/\\*$/.test(segment)) {\n      rules.push({ kind: \"mime-family\", value: segment.slice(0, -1) });\n    } else if (/^[a-z0-9!#$&^_.+-]+\\/[a-z0-9!#$&^_.+-]+$/.test(segment)) {\n      rules.push({ kind: \"mime\", value: segment });\n    }\n  }\n  return Object.freeze(rules);\n}\n\n/**\n * Reports whether one file matches at least one recognized runtime accept rule.\n *\n * @param file - Browser File selected through input or drag-and-drop.\n * @param rules - Parsed recognized accept rules.\n * @returns Whether the file is accepted, including permissive behavior when no rule is recognized.\n */\nfunction isMiaixzFileAccepted(file: File, rules: readonly MiaixzAcceptRule[]): boolean {\n  if (rules.length === 0) return true;\n  const fileName = file.name.toLowerCase();\n  const mimeType = file.type.toLowerCase();\n  return rules.some((rule) => {\n    if (rule.kind === \"extension\") return fileName.endsWith(rule.value);\n    if (rule.kind === \"mime-family\") return mimeType.startsWith(rule.value);\n    return mimeType === rule.value;\n  });\n}\n\n/**\n * Resolves and validates the frozen maximum-file contract.\n *\n * @param multiple - Whether multiple files are permitted.\n * @param maxFiles - Optional consumer-supplied maximum.\n * @param createError - Localized UI error factory.\n * @returns Effective maximum number of retained files.\n */\nfunction resolveMiaixzMaximumFiles(\n  multiple: boolean,\n  maxFiles: number | undefined,\n  createError: (details: Readonly<Record<string, unknown>>) => MiaixzUiError,\n): number {\n  if (!multiple) {\n    if (maxFiles !== undefined && maxFiles !== 1) throw createError({ maxFiles, multiple });\n    return 1;\n  }\n  const resolved = maxFiles ?? 10;\n  if (!Number.isInteger(resolved) || resolved <= 0)\n    throw createError({ maxFiles: resolved, multiple });\n  return resolved;\n}\n\n/**\n * Maps an upload state to its frozen built-in translation key.\n *\n * @param status - Current upload lifecycle state.\n * @returns Built-in UI message key for the visible and announced status.\n */\nfunction getMiaixzUploadStatusKey(status: MiaixzUploadStatus): string {\n  return `ui.upload.${status}`;\n}\n\n/**\n * Maps an upload state to a frozen Lucide icon name.\n *\n * @param status - Current upload lifecycle state.\n * @returns Registered icon representing the state without relying on color alone.\n */\nfunction getMiaixzUploadStatusIcon(\n  status: MiaixzUploadStatus,\n): \"File\" | \"LoaderCircle\" | \"CircleCheck\" | \"CircleAlert\" | \"X\" {\n  if (status === \"uploading\") return \"LoaderCircle\";\n  if (status === \"success\") return \"CircleCheck\";\n  if (status === \"error\") return \"CircleAlert\";\n  if (status === \"cancelled\") return \"X\";\n  return \"File\";\n}\n\n/**\n * Renders validated uploads with FIFO scheduling and consumer-owned requests.\n *\n * @public\n */\nexport const FileUpload = forwardRef<HTMLDivElement, FileUploadProps>(function FileUpload(\n  {\n    accept,\n    multiple = false,\n    maxFiles,\n    maxSizeBytes,\n    disabled = false,\n    label,\n    dropLabel,\n    browseLabel,\n    upload,\n    onFilesChange,\n    onComplete,\n    onError,\n    className,\n    ...props\n  },\n  ref,\n): ReactElement {\n  const { t } = useMiaixzLocale();\n  const [items, setItems] = useState<readonly MiaixzUploadItem[]>([]);\n  const [validationMessages, setValidationMessages] = useState<readonly string[]>([]);\n  const itemsRef = useRef(items);\n  const nextIdRef = useRef(0);\n  const mountedRef = useRef(true);\n  const activeIdsRef = useRef(new Set<string>());\n  const controllersRef = useRef(new Map<string, AbortController>());\n  const acceptRules = parseMiaixzAcceptRules(accept);\n\n  /**\n   * Creates the frozen invalid maximum-file error with sanitized details.\n   *\n   * @param details - Non-sensitive configuration values that caused the failure.\n   * @returns Localized UI contract error.\n   */\n  function createMaximumFilesError(details: Readonly<Record<string, unknown>>): MiaixzUiError {\n    return createMiaixzUiError(t, {\n      code: \"UI_FILE_MAX_FILES_INVALID\",\n      messageKey: \"ui.error.file.maxFilesInvalid\",\n      details,\n    });\n  }\n\n  const resolvedMaximumFiles = resolveMiaixzMaximumFiles(\n    multiple,\n    maxFiles,\n    createMaximumFilesError,\n  );\n  if (maxSizeBytes !== undefined && (!Number.isInteger(maxSizeBytes) || maxSizeBytes <= 0)) {\n    throw createMiaixzUiError(t, {\n      code: \"UI_FILE_MAX_SIZE_INVALID\",\n      messageKey: \"ui.error.file.maxSizeInvalid\",\n      details: { maxSizeBytes },\n    });\n  }\n\n  /**\n   * Commits an immutable item list and optionally publishes its File objects.\n   *\n   * @param nextItems - Complete replacement item list.\n   * @param notify - Whether the frozen onFilesChange condition was met.\n   */\n  const replaceItems = useCallback(\n    (nextItems: readonly MiaixzUploadItem[], notify: boolean): void => {\n      const frozenItems = Object.freeze([...nextItems]);\n      itemsRef.current = frozenItems;\n      setItems(frozenItems);\n      if (notify) onFilesChange?.(Object.freeze(frozenItems.map((item) => item.file)));\n    },\n    [onFilesChange],\n  );\n\n  /**\n   * Replaces one item by ID while preserving the current list order.\n   *\n   * @param id - Internal accepted-item identifier.\n   * @param update - Pure item transformation.\n   * @param notify - Whether to publish the unchanged or changed File list.\n   */\n  const updateItem = useCallback(\n    (\n      id: string,\n      update: (item: Readonly<MiaixzUploadItem>) => MiaixzUploadItem,\n      notify = false,\n    ): void => {\n      replaceItems(\n        itemsRef.current.map((item) => (item.id === id ? update(item) : item)),\n        notify,\n      );\n    },\n    [replaceItems],\n  );\n\n  /**\n   * Runs one upload attempt and settles only the matching active item.\n   *\n   * @param item - Queued item captured when its FIFO slot became available.\n   */\n  const runUpload = useCallback(\n    async (item: Readonly<MiaixzUploadItem>): Promise<void> => {\n      const controller = new AbortController();\n      controllersRef.current.set(item.id, controller);\n      let invalidProgressError: MiaixzUiError | undefined;\n\n      /**\n       * Validates and commits one upload progress report.\n       *\n       * @param value - Consumer-reported upload percentage.\n       */\n      function reportProgress(value: number): void {\n        if (!Number.isFinite(value) || value < 0 || value > 100) {\n          invalidProgressError = createMiaixzUiError(t, {\n            code: \"UI_UPLOAD_PROGRESS_INVALID\",\n            messageKey: \"ui.error.upload.progressInvalid\",\n            details: { value },\n          });\n          throw invalidProgressError;\n        }\n        if (!mountedRef.current || controller.signal.aborted) return;\n        updateItem(item.id, (current) =>\n          current.status === \"uploading\" ? { ...current, progress: value } : current,\n        );\n      }\n\n      const context: MiaixzUploadContext = Object.freeze({\n        signal: controller.signal,\n        reportProgress,\n      });\n      let shouldComplete = false;\n      try {\n        await upload(item.file, context);\n        if (invalidProgressError !== undefined) throw invalidProgressError;\n        if (!mountedRef.current || controller.signal.aborted) return;\n        const current = itemsRef.current.find((candidate) => candidate.id === item.id);\n        if (current?.status !== \"uploading\") return;\n        updateItem(item.id, (candidate) => ({\n          ...candidate,\n          status: \"success\",\n          progress: 100,\n          completed: true,\n        }));\n        shouldComplete = !current.completed;\n      } catch (error) {\n        if (!mountedRef.current || controller.signal.aborted) return;\n        const current = itemsRef.current.find((candidate) => candidate.id === item.id);\n        if (current?.status !== \"uploading\") return;\n        const resolvedError = invalidProgressError ?? error;\n        updateItem(item.id, (candidate) => ({ ...candidate, status: \"error\" }));\n        onError?.(item.file, resolvedError);\n      } finally {\n        if (controllersRef.current.get(item.id) === controller) {\n          controllersRef.current.delete(item.id);\n          activeIdsRef.current.delete(item.id);\n        }\n      }\n      if (shouldComplete && mountedRef.current) onComplete?.(item.file);\n    },\n    [onComplete, onError, t, updateItem, upload],\n  );\n\n  useEffect(() => {\n    const availableSlots = miaixzUploadConcurrency - activeIdsRef.current.size;\n    if (availableSlots <= 0) return;\n    const queuedItems = itemsRef.current\n      .filter((item) => item.status === \"queued\" && !activeIdsRef.current.has(item.id))\n      .slice(0, availableSlots);\n    if (queuedItems.length === 0) return;\n    for (const item of queuedItems) activeIdsRef.current.add(item.id);\n    const queuedIds = new Set(queuedItems.map((item) => item.id));\n    replaceItems(\n      itemsRef.current.map((item) =>\n        queuedIds.has(item.id) ? { ...item, status: \"uploading\" } : item,\n      ),\n      false,\n    );\n    for (const item of queuedItems) void runUpload(item).catch(() => undefined);\n  }, [items, replaceItems, runUpload]);\n\n  useEffect(() => {\n    const controllers = controllersRef.current;\n    const activeIds = activeIdsRef.current;\n    mountedRef.current = true;\n    return () => {\n      mountedRef.current = false;\n      for (const controller of controllers.values()) controller.abort();\n      controllers.clear();\n      activeIds.clear();\n    };\n  }, []);\n\n  /**\n   * Creates a localized validation error without retaining file names or content.\n   *\n   * @param code - Frozen file validation machine code.\n   * @param messageKey - Frozen built-in translation key.\n   * @param details - Safe size, MIME, or count diagnostics.\n   * @returns Localized and sanitized UI error.\n   */\n  function createValidationError(\n    code: \"UI_FILE_TYPE_NOT_ACCEPTED\" | \"UI_FILE_TOO_LARGE\" | \"UI_FILE_COUNT_EXCEEDED\",\n    messageKey:\n      \"ui.error.file.typeNotAccepted\" | \"ui.error.file.tooLarge\" | \"ui.error.file.countExceeded\",\n    details: Readonly<Record<string, unknown>>,\n  ): MiaixzUiError {\n    return createMiaixzUiError(t, { code, messageKey, details });\n  }\n\n  /**\n   * Validates one selection operation, accepts available files, and reports rejections.\n   *\n   * @param files - Files selected through the public Dropzone primitive.\n   */\n  function handleFiles(files: readonly File[]): void {\n    if (disabled) return;\n    const acceptedItems: MiaixzUploadItem[] = [];\n    const errors: MiaixzUiError[] = [];\n    for (const file of files) {\n      let error: MiaixzUiError | undefined;\n      if (!isMiaixzFileAccepted(file, acceptRules)) {\n        error = createValidationError(\n          \"UI_FILE_TYPE_NOT_ACCEPTED\",\n          \"ui.error.file.typeNotAccepted\",\n          { accept, mimeType: file.type },\n        );\n      } else if (maxSizeBytes !== undefined && file.size > maxSizeBytes) {\n        error = createValidationError(\"UI_FILE_TOO_LARGE\", \"ui.error.file.tooLarge\", {\n          maxSizeBytes,\n          sizeBytes: file.size,\n        });\n      } else if (itemsRef.current.length + acceptedItems.length >= resolvedMaximumFiles) {\n        error = createValidationError(\"UI_FILE_COUNT_EXCEEDED\", \"ui.error.file.countExceeded\", {\n          maxFiles: resolvedMaximumFiles,\n        });\n      }\n      if (error !== undefined) {\n        errors.push(error);\n        onError?.(file, error);\n        continue;\n      }\n      nextIdRef.current += 1;\n      acceptedItems.push({\n        id: `upload-${nextIdRef.current}`,\n        file,\n        status: \"queued\",\n        progress: 0,\n        completed: false,\n      });\n    }\n    setValidationMessages(Object.freeze([...new Set(errors.map((error) => error.message))]));\n    if (acceptedItems.length > 0) {\n      replaceItems([...itemsRef.current, ...acceptedItems], true);\n    }\n  }\n\n  /**\n   * Cancels one queued or active item while retaining its original File for retry.\n   *\n   * @param id - Internal accepted-item identifier.\n   */\n  function handleCancel(id: string): void {\n    if (disabled) return;\n    controllersRef.current.get(id)?.abort();\n    controllersRef.current.delete(id);\n    activeIdsRef.current.delete(id);\n    updateItem(\n      id,\n      (item) =>\n        item.status === \"queued\" || item.status === \"uploading\"\n          ? { ...item, status: \"cancelled\" }\n          : item,\n      true,\n    );\n  }\n\n  /**\n   * Returns one failed or cancelled item to the FIFO queue.\n   *\n   * @param id - Internal accepted-item identifier.\n   */\n  function handleRetry(id: string): void {\n    if (disabled) return;\n    setValidationMessages([]);\n    updateItem(\n      id,\n      (item) =>\n        item.status === \"error\" || item.status === \"cancelled\"\n          ? { ...item, status: \"queued\", progress: 0, completed: false }\n          : item,\n      true,\n    );\n  }\n\n  /**\n   * Removes one item and aborts any request still associated with it.\n   *\n   * @param id - Internal accepted-item identifier.\n   */\n  function handleRemove(id: string): void {\n    if (disabled) return;\n    controllersRef.current.get(id)?.abort();\n    controllersRef.current.delete(id);\n    activeIdsRef.current.delete(id);\n    replaceItems(\n      itemsRef.current.filter((item) => item.id !== id),\n      true,\n    );\n  }\n\n  return (\n    <div\n      {...props}\n      ref={ref}\n      role=\"group\"\n      aria-label={label}\n      data-disabled={disabled || undefined}\n      className={classNames(\"miaixz-file-upload\", className)}\n    >\n      <span className=\"miaixz-file-upload-label\">{label}</span>\n      <Dropzone\n        {...(accept === undefined ? {} : { accept })}\n        multiple={multiple}\n        disabled={disabled}\n        label={dropLabel}\n        onFiles={handleFiles}\n      >\n        <span className=\"miaixz-file-upload-drop-label\">{dropLabel}</span>\n        <span className=\"miaixz-file-upload-browse-label\">{browseLabel}</span>\n      </Dropzone>\n\n      {validationMessages.length > 0 && (\n        <div className=\"miaixz-file-upload-validation\" role=\"alert\">\n          <Icon name=\"CircleAlert\" size=\"inline\" />\n          <ul className=\"miaixz-file-upload-validation-list\">\n            {validationMessages.map((message) => (\n              <li key={message}>{message}</li>\n            ))}\n          </ul>\n        </div>\n      )}\n\n      {items.length > 0 && (\n        <ul className=\"miaixz-file-upload-list\">\n          {items.map((item) => {\n            const statusLabel = t(getMiaixzUploadStatusKey(item.status));\n            return (\n              <li key={item.id} data-state={item.status} className=\"miaixz-file-upload-item\">\n                <Icon\n                  name={getMiaixzUploadStatusIcon(item.status)}\n                  size=\"control\"\n                  className=\"miaixz-file-upload-status-icon\"\n                />\n                <div className=\"miaixz-file-upload-details\">\n                  <span className=\"miaixz-file-upload-name\">{item.file.name}</span>\n                  <span className=\"miaixz-file-upload-status\" role=\"status\">\n                    {statusLabel}\n                  </span>\n                  {item.status === \"uploading\" && (\n                    <Progress\n                      value={item.progress}\n                      label={`${item.file.name}: ${statusLabel}`}\n                      showValue\n                    />\n                  )}\n                </div>\n                <div className=\"miaixz-file-upload-actions\">\n                  {(item.status === \"queued\" || item.status === \"uploading\") && (\n                    <Button\n                      variant=\"ghost\"\n                      size=\"small\"\n                      disabled={disabled}\n                      startIcon={<Icon name=\"X\" />}\n                      onClick={() => handleCancel(item.id)}\n                    >\n                      {t(\"ui.action.cancel\")}\n                    </Button>\n                  )}\n                  {(item.status === \"error\" || item.status === \"cancelled\") && (\n                    <Button\n                      variant=\"ghost\"\n                      size=\"small\"\n                      disabled={disabled}\n                      startIcon={<Icon name=\"RotateCcw\" />}\n                      onClick={() => handleRetry(item.id)}\n                    >\n                      {t(\"ui.action.retry\")}\n                    </Button>\n                  )}\n                  {(item.status === \"success\" ||\n                    item.status === \"error\" ||\n                    item.status === \"cancelled\") && (\n                    <Button\n                      variant=\"ghost\"\n                      size=\"small\"\n                      disabled={disabled}\n                      startIcon={<Icon name=\"Trash2\" />}\n                      onClick={() => handleRemove(item.id)}\n                    >\n                      {t(\"ui.action.remove\")}\n                    </Button>\n                  )}\n                </div>\n              </li>\n            );\n          })}\n        </ul>\n      )}\n    </div>\n  );\n});\n"]}

package/dist/components/file-upload/file-upload.types.d.ts

@@ -0,0 +1,91 @@
+import type { HTMLAttributes } from "react";
+/**
+ * Supplies cancellation and progress reporting to one consumer-owned upload request.
+ *
+ * @public
+ */
+export interface MiaixzUploadContext {
+    /**
+     * Aborts when the file is cancelled, removed, or the component unmounts.
+     */
+    readonly signal: AbortSignal;
+    /**
+     * Reports a finite upload percentage from zero through one hundred.
+     *
+     * @param value - Current upload percentage.
+     */
+    reportProgress(value: number): void;
+}
+/**
+ * Defines the consumer-owned asynchronous request for one file.
+ *
+ * @public
+ */
+export type MiaixzUploadHandler = (file: File, context: MiaixzUploadContext) => Promise<void>;
+/**
+ * Defines properties owned by the Miaixz FileUpload contract.
+ *
+ * @public
+ */
+export interface MiaixzFileUploadOwnProps {
+    /**
+     * Supplies the HTML file accept expression used by native and runtime validation.
+     */
+    readonly accept?: string;
+    /**
+     * Allows multiple files to remain in the upload list.
+     *
+     * @defaultValue `false`
+     */
+    readonly multiple?: boolean;
+    /**
+     * Limits accepted files, defaulting to one for single mode and ten for multiple mode.
+     */
+    readonly maxFiles?: number;
+    /**
+     * Limits each accepted file to a positive integer byte size.
+     */
+    readonly maxSizeBytes?: number;
+    /**
+     * Prevents new file selection and upload actions.
+     *
+     * @defaultValue `false`
+     */
+    readonly disabled?: boolean;
+    /**
+     * Supplies the required localized group label.
+     */
+    readonly label: string;
+    /**
+     * Supplies the localized drag-and-drop instruction.
+     */
+    readonly dropLabel: string;
+    /**
+     * Supplies the localized file picker action label.
+     */
+    readonly browseLabel: string;
+    /**
+     * Performs the consumer-owned network request for each accepted file.
+     */
+    readonly upload: MiaixzUploadHandler;
+    /**
+     * Receives the current file list after acceptance, removal, cancellation, or retry.
+     */
+    readonly onFilesChange?: (files: readonly File[]) => void;
+    /**
+     * Runs once after each file completes successfully.
+     */
+    readonly onComplete?: (file: File) => void;
+    /**
+     * Receives validation and upload failures without exposing server text in the UI.
+     */
+    readonly onError?: (file: File, error: unknown) => void;
+}
+/**
+ * Configures validated, concurrent, request-independent file uploads.
+ *
+ * @public
+ */
+export interface FileUploadProps extends Omit<HTMLAttributes<HTMLDivElement>, keyof MiaixzFileUploadOwnProps>, MiaixzFileUploadOwnProps {
+}
+//# sourceMappingURL=file-upload.types.d.ts.map

package/dist/components/file-upload/file-upload.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.types.d.ts","sourceRoot":"","sources":["../../../src/components/file-upload/file-upload.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9F;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,KAAK,IAAI,CAAC;IAE1D;;OAEG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,CAAC;IAE3C;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACzD;AAED;;;;GAIG;AACH,MAAM,WAAW,eACf,SACE,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,EAAE,MAAM,wBAAwB,CAAC,EACpE,wBAAwB;CAAG"}

package/dist/components/file-upload/file-upload.types.js

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

package/dist/components/file-upload/file-upload.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-upload.types.js","sourceRoot":"","sources":["../../../src/components/file-upload/file-upload.types.ts"],"names":[],"mappings":"","sourcesContent":["import type { HTMLAttributes } from \"react\";\n\n/**\n * Supplies cancellation and progress reporting to one consumer-owned upload request.\n *\n * @public\n */\nexport interface MiaixzUploadContext {\n  /**\n   * Aborts when the file is cancelled, removed, or the component unmounts.\n   */\n  readonly signal: AbortSignal;\n\n  /**\n   * Reports a finite upload percentage from zero through one hundred.\n   *\n   * @param value - Current upload percentage.\n   */\n  reportProgress(value: number): void;\n}\n\n/**\n * Defines the consumer-owned asynchronous request for one file.\n *\n * @public\n */\nexport type MiaixzUploadHandler = (file: File, context: MiaixzUploadContext) => Promise<void>;\n\n/**\n * Defines properties owned by the Miaixz FileUpload contract.\n *\n * @public\n */\nexport interface MiaixzFileUploadOwnProps {\n  /**\n   * Supplies the HTML file accept expression used by native and runtime validation.\n   */\n  readonly accept?: string;\n\n  /**\n   * Allows multiple files to remain in the upload list.\n   *\n   * @defaultValue `false`\n   */\n  readonly multiple?: boolean;\n\n  /**\n   * Limits accepted files, defaulting to one for single mode and ten for multiple mode.\n   */\n  readonly maxFiles?: number;\n\n  /**\n   * Limits each accepted file to a positive integer byte size.\n   */\n  readonly maxSizeBytes?: number;\n\n  /**\n   * Prevents new file selection and upload actions.\n   *\n   * @defaultValue `false`\n   */\n  readonly disabled?: boolean;\n\n  /**\n   * Supplies the required localized group label.\n   */\n  readonly label: string;\n\n  /**\n   * Supplies the localized drag-and-drop instruction.\n   */\n  readonly dropLabel: string;\n\n  /**\n   * Supplies the localized file picker action label.\n   */\n  readonly browseLabel: string;\n\n  /**\n   * Performs the consumer-owned network request for each accepted file.\n   */\n  readonly upload: MiaixzUploadHandler;\n\n  /**\n   * Receives the current file list after acceptance, removal, cancellation, or retry.\n   */\n  readonly onFilesChange?: (files: readonly File[]) => void;\n\n  /**\n   * Runs once after each file completes successfully.\n   */\n  readonly onComplete?: (file: File) => void;\n\n  /**\n   * Receives validation and upload failures without exposing server text in the UI.\n   */\n  readonly onError?: (file: File, error: unknown) => void;\n}\n\n/**\n * Configures validated, concurrent, request-independent file uploads.\n *\n * @public\n */\nexport interface FileUploadProps\n  extends\n    Omit<HTMLAttributes<HTMLDivElement>, keyof MiaixzFileUploadOwnProps>,\n    MiaixzFileUploadOwnProps {}\n"]}

package/dist/components/file-upload/index.d.ts

@@ -0,0 +1,3 @@
+export { FileUpload } from "./file-upload.js";
+export type { FileUploadProps, MiaixzFileUploadOwnProps, MiaixzUploadContext, MiaixzUploadHandler, } from "./file-upload.types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/file-upload/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/file-upload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,eAAe,EACf,wBAAwB,EACxB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC"}

package/dist/components/file-upload/index.js

@@ -0,0 +1,2 @@
+export { FileUpload } from "./file-upload.js";
+//# sourceMappingURL=index.js.map

package/dist/components/file-upload/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/components/file-upload/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC","sourcesContent":["export { FileUpload } from \"./file-upload.js\";\nexport type {\n  FileUploadProps,\n  MiaixzFileUploadOwnProps,\n  MiaixzUploadContext,\n  MiaixzUploadHandler,\n} from \"./file-upload.types.js\";\n"]}

package/dist/components/form-field/form-field.d.ts

@@ -0,0 +1,11 @@
+import type { FormFieldProps } from "./form-field.types.js";
+/**
+ * Connects a form control to its label, description, required state, and error.
+ * Generated identifiers preserve accessible relationships without caller setup.
+ *
+ * @param props - Form-field configuration and native container properties.
+ * @returns The connected form-field structure.
+ * @public
+ */
+export declare function FormField({ label, children, helperText, errorText, optionalText, required, controlId, className, ...props }: FormFieldProps): import("react").JSX.Element;
+//# sourceMappingURL=form-field.d.ts.map

package/dist/components/form-field/form-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-field.d.ts","sourceRoot":"","sources":["../../../src/components/form-field/form-field.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAc5D;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,QAAQ,EACR,UAAU,EACV,SAAS,EACT,YAAY,EACZ,QAAgB,EAChB,SAAS,EACT,SAAS,EACT,GAAG,KAAK,EACT,EAAE,cAAc,+BAsDhB"}

package/dist/components/form-field/form-field.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cloneElement, useId } from "react";
+import { classNames } from "../../internal/class-names.js";
+/**
+ * Combines optional ARIA reference identifiers without empty segments.
+ *
+ * @param ids - Candidate identifiers in semantic reading order.
+ * @returns A space-delimited identifier list or `undefined` when empty.
+ */
+function mergeIds(...ids) {
+    const value = ids.filter(Boolean).join(" ");
+    return value || undefined;
+}
+/* eslint-disable jsdoc/check-param-names, jsdoc/require-param -- TSDoc documents the typed properties instead of dotted parameter names. */
+/**
+ * Connects a form control to its label, description, required state, and error.
+ * Generated identifiers preserve accessible relationships without caller setup.
+ *
+ * @param props - Form-field configuration and native container properties.
+ * @returns The connected form-field structure.
+ * @public
+ */
+export function FormField({ label, children, helperText, errorText, optionalText, required = false, controlId, className, ...props }) {
+    const generatedId = useId();
+    const id = controlId ?? children.props.id ?? `miaixz-field-${generatedId}`;
+    const helperId = helperText ? `${id}-helper` : undefined;
+    const errorId = errorText ? `${id}-error` : undefined;
+    const describedBy = mergeIds(children.props["aria-describedby"], helperId, errorId);
+    const isRequired = required || Boolean(children.props.required);
+    const isInvalid = Boolean(errorText) || Boolean(children.props.invalid);
+    const ariaInvalid = errorText ? true : children.props["aria-invalid"];
+    const control = cloneElement(children, {
+        id,
+        ...(isRequired ? { required: true } : {}),
+        ...(isInvalid ? { invalid: true } : {}),
+        ...(ariaInvalid === undefined ? {} : { "aria-invalid": ariaInvalid }),
+        ...(describedBy === undefined ? {} : { "aria-describedby": describedBy }),
+    });
+    return (_jsxs("div", { ...props, className: classNames("miaixz-form-field", Boolean(errorText) && "miaixz-form-field-invalid", className), "data-invalid": Boolean(errorText) || undefined, children: [_jsxs("div", { className: "miaixz-form-field-label-row", children: [_jsxs("label", { className: "miaixz-form-field-label", htmlFor: id, children: [label, required && (_jsx("span", { className: "miaixz-form-field-required", "aria-hidden": "true", children: "*" }))] }), !required && optionalText && (_jsx("span", { className: "miaixz-form-field-optional", children: optionalText }))] }), control, helperText && (_jsx("div", { id: helperId, className: "miaixz-form-field-helper", children: helperText })), errorText && (_jsx("div", { id: errorId, className: "miaixz-form-field-error", role: "alert", children: errorText }))] }));
+}
+//# sourceMappingURL=form-field.js.map

package/dist/components/form-field/form-field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"form-field.js","sourceRoot":"","sources":["../../../src/components/form-field/form-field.tsx"],"names":[],"mappings":"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","sourcesContent":["import { cloneElement, useId } from \"react\";\n\nimport { classNames } from \"../../internal/class-names.js\";\nimport type { FormFieldProps } from \"./form-field.types.js\";\n\n/**\n * Combines optional ARIA reference identifiers without empty segments.\n *\n * @param ids - Candidate identifiers in semantic reading order.\n * @returns A space-delimited identifier list or `undefined` when empty.\n */\nfunction mergeIds(...ids: ReadonlyArray<string | undefined>): string | undefined {\n  const value = ids.filter(Boolean).join(\" \");\n  return value || undefined;\n}\n\n/* eslint-disable jsdoc/check-param-names, jsdoc/require-param -- TSDoc documents the typed properties instead of dotted parameter names. */\n/**\n * Connects a form control to its label, description, required state, and error.\n * Generated identifiers preserve accessible relationships without caller setup.\n *\n * @param props - Form-field configuration and native container properties.\n * @returns The connected form-field structure.\n * @public\n */\nexport function FormField({\n  label,\n  children,\n  helperText,\n  errorText,\n  optionalText,\n  required = false,\n  controlId,\n  className,\n  ...props\n}: FormFieldProps) {\n  const generatedId = useId();\n  const id = controlId ?? children.props.id ?? `miaixz-field-${generatedId}`;\n  const helperId = helperText ? `${id}-helper` : undefined;\n  const errorId = errorText ? `${id}-error` : undefined;\n  const describedBy = mergeIds(children.props[\"aria-describedby\"], helperId, errorId);\n  const isRequired = required || Boolean(children.props.required);\n  const isInvalid = Boolean(errorText) || Boolean(children.props.invalid);\n  const ariaInvalid = errorText ? true : children.props[\"aria-invalid\"];\n\n  const control = cloneElement(children, {\n    id,\n    ...(isRequired ? { required: true } : {}),\n    ...(isInvalid ? { invalid: true } : {}),\n    ...(ariaInvalid === undefined ? {} : { \"aria-invalid\": ariaInvalid }),\n    ...(describedBy === undefined ? {} : { \"aria-describedby\": describedBy }),\n  });\n\n  return (\n    <div\n      {...props}\n      className={classNames(\n        \"miaixz-form-field\",\n        Boolean(errorText) && \"miaixz-form-field-invalid\",\n        className,\n      )}\n      data-invalid={Boolean(errorText) || undefined}\n    >\n      <div className=\"miaixz-form-field-label-row\">\n        <label className=\"miaixz-form-field-label\" htmlFor={id}>\n          {label}\n          {required && (\n            <span className=\"miaixz-form-field-required\" aria-hidden=\"true\">\n              *\n            </span>\n          )}\n        </label>\n        {!required && optionalText && (\n          <span className=\"miaixz-form-field-optional\">{optionalText}</span>\n        )}\n      </div>\n      {control}\n      {helperText && (\n        <div id={helperId} className=\"miaixz-form-field-helper\">\n          {helperText}\n        </div>\n      )}\n      {errorText && (\n        <div id={errorId} className=\"miaixz-form-field-error\" role=\"alert\">\n          {errorText}\n        </div>\n      )}\n    </div>\n  );\n}\n/* eslint-enable jsdoc/check-param-names, jsdoc/require-param */\n"]}