@miaixz/ui 0.5.0

package/dist/errors/ui-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-error.js","sourceRoot":"","sources":["../../src/errors/ui-error.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MiaixzTranslator } from \"@miaixz/sdk/i18n\";\n\nconst miaixzUiSensitiveDetailKeys = new Set([\n  \"accesstoken\",\n  \"account\",\n  \"address\",\n  \"apikey\",\n  \"authorization\",\n  \"body\",\n  \"content\",\n  \"cookie\",\n  \"csrf\",\n  \"data\",\n  \"email\",\n  \"filecontent\",\n  \"filename\",\n  \"filepath\",\n  \"fullname\",\n  \"idcard\",\n  \"key\",\n  \"mobile\",\n  \"name\",\n  \"password\",\n  \"phone\",\n  \"proxyauthorization\",\n  \"realname\",\n  \"refreshtoken\",\n  \"secret\",\n  \"setcookie\",\n  \"token\",\n  \"user\",\n  \"userid\",\n  \"username\",\n  \"xapikey\",\n  \"xcsrftoken\",\n]);\nconst miaixzUiErrorMaximumDepth = 8;\nconst miaixzUiErrorMaximumCollectionSize = 100;\nconst miaixzUiErrorMaximumStringLength = 1_024;\nconst miaixzUiRedactedValue = \"[REDACTED]\";\nconst miaixzUiTruncatedValue = \"[TRUNCATED]\";\nconst miaixzUiCircularValue = \"[CIRCULAR]\";\n\n/**\n * Describes a non-JSON diagnostic value without retaining its content.\n */\ninterface MiaixzUiErrorValueSummary {\n  /**\n   * Contains the safe runtime value category.\n   */\n  readonly type: string;\n\n  /**\n   * Contains the measurable byte size when it can be obtained without reading content.\n   */\n  readonly bytes?: number;\n}\n\n/**\n * Configures a stable UI runtime error.\n *\n * @public\n */\nexport interface MiaixzUiErrorOptions {\n  /**\n   * Supplies the stable machine-readable error code.\n   */\n  readonly code: string;\n\n  /**\n   * Supplies the stable translation key used for the public message.\n   */\n  readonly messageKey: string;\n\n  /**\n   * Supplies optional diagnostic metadata that will be bounded and sanitized.\n   */\n  readonly details?: unknown;\n\n  /**\n   * Supplies the original failure for local diagnostics.\n   */\n  readonly cause?: unknown;\n}\n\n/**\n * Reports whether an object is safe to traverse as inert JSON-like metadata.\n *\n * @param value - Object candidate to inspect.\n * @returns Whether the value is an object literal or null-prototype record.\n */\nfunction isPlainUiErrorObject(value: object): value is Record<string, unknown> {\n  const prototype = Object.getPrototypeOf(value);\n  return prototype === Object.prototype || prototype === null;\n}\n\n/**\n * Normalizes a detail key before comparing it with the sensitive-key registry.\n *\n * @param value - Detail key to normalize.\n * @returns Lowercase alphanumeric key without separators.\n */\nfunction normalizeUiErrorDetailKey(value: string): string {\n  return value.replace(/[^a-zA-Z0-9]/g, \"\").toLowerCase();\n}\n\n/**\n * Truncates diagnostic strings by Unicode code point.\n *\n * @param value - Diagnostic string to constrain.\n * @returns Original string or a safely truncated representation.\n */\nfunction truncateUiErrorString(value: string): string {\n  const characters = [...value];\n  if (characters.length <= miaixzUiErrorMaximumStringLength) return value;\n  return `${characters.slice(0, miaixzUiErrorMaximumStringLength).join(\"\")}${miaixzUiTruncatedValue}`;\n}\n\n/**\n * Creates a content-free summary for a non-JSON diagnostic value.\n *\n * @param value - Runtime value whose content must not be retained.\n * @returns Frozen type and optional byte-size metadata.\n */\nfunction summarizeUiErrorValue(value: unknown): Readonly<MiaixzUiErrorValueSummary> {\n  let type: string = typeof value;\n  let bytes: number | undefined;\n  if (typeof Blob !== \"undefined\" && value instanceof Blob) {\n    type = typeof File !== \"undefined\" && value instanceof File ? \"File\" : \"Blob\";\n    bytes = value.size;\n  } else if (value instanceof ArrayBuffer) {\n    type = \"ArrayBuffer\";\n    bytes = value.byteLength;\n  } else if (ArrayBuffer.isView(value)) {\n    type = \"TypedArray\";\n    bytes = value.byteLength;\n  } else if (typeof FormData !== \"undefined\" && value instanceof FormData) {\n    type = \"FormData\";\n  } else if (typeof URLSearchParams !== \"undefined\" && value instanceof URLSearchParams) {\n    type = \"URLSearchParams\";\n    bytes = new TextEncoder().encode(value.toString()).byteLength;\n  } else if (typeof ReadableStream !== \"undefined\" && value instanceof ReadableStream) {\n    type = \"ReadableStream\";\n  } else if (value !== null && typeof value === \"object\") {\n    type = \"Object\";\n  }\n  return Object.freeze(bytes === undefined ? { type } : { type, bytes });\n}\n\n/**\n * Recursively creates bounded, immutable, getter-safe UI error details.\n *\n * @param value - Runtime value to sanitize.\n * @param depth - Current recursive depth.\n * @param ancestors - Objects in the active traversal path.\n * @returns Frozen metadata without recognized sensitive values or file content.\n */\nfunction sanitizeUiErrorDetails(\n  value: unknown,\n  depth = 0,\n  ancestors: ReadonlySet<object> = new Set(),\n): unknown {\n  if (typeof value === \"string\") return truncateUiErrorString(value);\n  if (\n    value === null ||\n    typeof value === \"number\" ||\n    typeof value === \"boolean\" ||\n    typeof value === \"undefined\"\n  ) {\n    return value;\n  }\n  if (typeof value !== \"object\") return summarizeUiErrorValue(value);\n  if (ancestors.has(value)) return miaixzUiCircularValue;\n  if (depth >= miaixzUiErrorMaximumDepth) return miaixzUiTruncatedValue;\n  if (!Array.isArray(value) && !isPlainUiErrorObject(value)) {\n    return summarizeUiErrorValue(value);\n  }\n\n  const nextAncestors = new Set(ancestors);\n  nextAncestors.add(value);\n  if (Array.isArray(value)) {\n    const limit = Math.min(value.length, miaixzUiErrorMaximumCollectionSize);\n    const result: unknown[] = [];\n    for (let index = 0; index < limit; index += 1) {\n      const descriptor = Object.getOwnPropertyDescriptor(value, String(index));\n      result.push(\n        descriptor && \"value\" in descriptor\n          ? sanitizeUiErrorDetails(descriptor.value, depth + 1, nextAncestors)\n          : miaixzUiTruncatedValue,\n      );\n    }\n    if (value.length > miaixzUiErrorMaximumCollectionSize) {\n      result[miaixzUiErrorMaximumCollectionSize - 1] = miaixzUiTruncatedValue;\n    }\n    return Object.freeze(result);\n  }\n\n  const result: Record<string, unknown> = {};\n  const keys = Object.keys(value);\n  const limit = Math.min(keys.length, miaixzUiErrorMaximumCollectionSize);\n  for (let index = 0; index < limit; index += 1) {\n    const key = keys[index];\n    if (key === undefined) continue;\n    if (miaixzUiSensitiveDetailKeys.has(normalizeUiErrorDetailKey(key))) {\n      result[key] = miaixzUiRedactedValue;\n      continue;\n    }\n    const descriptor = Object.getOwnPropertyDescriptor(value, key);\n    result[key] =\n      descriptor && \"value\" in descriptor\n        ? sanitizeUiErrorDetails(descriptor.value, depth + 1, nextAncestors)\n        : miaixzUiTruncatedValue;\n  }\n  if (keys.length > miaixzUiErrorMaximumCollectionSize) {\n    const lastKey = keys[miaixzUiErrorMaximumCollectionSize - 1];\n    if (lastKey !== undefined) result[lastKey] = miaixzUiTruncatedValue;\n  }\n  return Object.freeze(result);\n}\n\n/**\n * Error created by UI runtime contract validation.\n *\n * @public\n */\nexport class MiaixzUiError extends Error {\n  /**\n   * Contains the stable machine-readable error code.\n   */\n  readonly code: string;\n\n  /**\n   * Contains the stable translation key for the public message.\n   */\n  readonly messageKey: string;\n\n  /**\n   * Contains optional immutable and sanitized diagnostic metadata.\n   */\n  readonly details?: unknown;\n\n  /**\n   * Creates a stable localized UI error.\n   *\n   * @param message - Localized public message.\n   * @param options - Stable error metadata and optional cause.\n   */\n  constructor(message: string, options: MiaixzUiErrorOptions) {\n    const safeCause = options.cause instanceof Error ? options.cause : undefined;\n    super(message, safeCause === undefined ? undefined : { cause: safeCause });\n    this.name = \"MiaixzUiError\";\n    this.code = options.code;\n    this.messageKey = options.messageKey;\n    if (options.details !== undefined) this.details = sanitizeUiErrorDetails(options.details);\n  }\n}\n\n/**\n * Creates a UI error whose public message is resolved by the supplied translator.\n *\n * @param translate - Translator that resolves the registered message key.\n * @param options - Stable error metadata and optional cause.\n * @returns Localized UI runtime error.\n * @public\n */\nexport function createMiaixzUiError(\n  translate: MiaixzTranslator,\n  options: MiaixzUiErrorOptions,\n): MiaixzUiError {\n  return new MiaixzUiError(translate(options.messageKey), options);\n}\n"]}

package/dist/i18n/i18n.d.ts

@@ -0,0 +1,52 @@
+import type { MiaixzI18n, MiaixzI18nSnapshot, MiaixzMessageCatalog, MiaixzTranslator } from "@miaixz/sdk/i18n";
+import { type ReactNode } from "react";
+export type { MiaixzI18n, MiaixzI18nSnapshot, MiaixzLocale, MiaixzMessageCatalog, MiaixzMessageLoader, MiaixzMessageLoaderMap, MiaixzMessageLoaderResult, MiaixzMessageModule, MiaixzMessageParams, MiaixzMessages, MiaixzMessageSource, MiaixzTranslator, } from "@miaixz/sdk/i18n";
+/**
+ * Configures the React adapter for an existing SDK internationalization runtime.
+ *
+ * @public
+ */
+export interface MiaixzLocaleProviderProps {
+    /**
+     * Supplies the sole SDK-owned internationalization runtime.
+     */
+    readonly i18n: MiaixzI18n;
+    /**
+     * Renders the subtree that consumes the locale context.
+     */
+    readonly children: ReactNode;
+}
+/**
+ * Exposes the SDK snapshot and translator through React context.
+ *
+ * @public
+ */
+export interface MiaixzLocaleContextValue extends MiaixzI18nSnapshot {
+    /**
+     * Resolves localized messages through the supplied SDK runtime.
+     */
+    readonly t: MiaixzTranslator;
+}
+/**
+ * Provides all built-in UI messages in English and Simplified Chinese.
+ *
+ * @public
+ */
+export declare const miaixzUiMessages: MiaixzMessageCatalog;
+/**
+ * Adapts one SDK internationalization runtime to a React subtree.
+ *
+ * @param props - SDK runtime and child subtree.
+ * @returns React context provider bound to the SDK snapshot.
+ * @public
+ */
+export declare function MiaixzLocaleProvider(props: MiaixzLocaleProviderProps): import("react").JSX.Element;
+/**
+ * Returns the nearest SDK-backed locale context.
+ *
+ * @returns Active locale snapshot and translator.
+ * @throws MiaixzUiError When called outside a Miaixz locale provider.
+ * @public
+ */
+export declare function useMiaixzLocale(): MiaixzLocaleContextValue;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../src/i18n/i18n.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAML,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAIf,YAAY,EACV,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAE1B;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAyB,SAAQ,kBAAkB;IAClE;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,oBAiG7B,CAAC;AAkBH;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,yBAAyB,+BAkBpE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,wBAAwB,CAQ1D"}

package/dist/i18n/i18n.js

@@ -0,0 +1,156 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useSyncExternalStore, } from "react";
+import { MiaixzUiError } from "../errors/index.js";
+/**
+ * Provides all built-in UI messages in English and Simplified Chinese.
+ *
+ * @public
+ */
+export const miaixzUiMessages = Object.freeze({
+    "en-US": Object.freeze({
+        "ui.loading": "Loading",
+        "ui.search": "Search",
+        "ui.search.clear": "Clear search",
+        "ui.dialog.close": "Close dialog",
+        "ui.drawer.close": "Close drawer",
+        "ui.notification.dismiss": "Dismiss notification",
+        "ui.pagination.label": "Pagination",
+        "ui.pagination.previous": "Previous page",
+        "ui.pagination.next": "Next page",
+        "ui.pagination.page": "Page {page}",
+        "ui.breadcrumb.label": "Breadcrumb",
+        "ui.menu.label": "Menu",
+        "ui.sectionNavigation.label": "Section navigation",
+        "ui.action.dismiss": "Dismiss",
+        "ui.action.cancel": "Cancel",
+        "ui.action.retry": "Retry",
+        "ui.action.remove": "Remove",
+        "ui.confirm.confirmationInputLabel": "Confirmation text",
+        "ui.combobox.loadError": "Options could not be loaded",
+        "ui.tree.loadError": "Child items could not be loaded",
+        "ui.table.selectRow": "Select row",
+        "ui.table.selectPage": "Select current page",
+        "ui.upload.queued": "Queued",
+        "ui.upload.uploading": "Uploading",
+        "ui.upload.success": "Upload complete",
+        "ui.upload.error": "Upload failed",
+        "ui.upload.cancelled": "Upload cancelled",
+        "ui.error.locale.providerMissing": "A Miaixz locale provider is required",
+        "ui.error.toast.providerMissing": "useToast must be used inside ToastProvider",
+        "ui.error.tabs.providerMissing": "Tab components must be used inside Tabs",
+        "ui.error.progress.maxInvalid": "The progress maximum must be greater than zero",
+        "ui.error.progress.valueInvalid": "The progress value must be finite",
+        "ui.error.options.sourceInvalid": "Exactly one option source is required",
+        "ui.error.controlled.valueInvalid": "The controlled value configuration is invalid",
+        "ui.error.controlled.inputInvalid": "The controlled input configuration is invalid",
+        "ui.error.controlled.modeChanged": "The component control mode cannot change after mounting",
+        "ui.error.selection.limitInvalid": "The selection limit must be a positive integer",
+        "ui.error.tree.duplicateId": "Tree node identifiers must be unique",
+        "ui.error.table.duplicateColumnId": "Table column identifiers must be unique",
+        "ui.error.table.duplicateRowId": "Table row identifiers must be unique",
+        "ui.error.file.typeNotAccepted": "The selected file type is not accepted",
+        "ui.error.file.tooLarge": "The selected file is too large",
+        "ui.error.file.countExceeded": "Too many files were selected",
+        "ui.error.file.maxFilesInvalid": "The maximum file count is invalid",
+        "ui.error.file.maxSizeInvalid": "The maximum file size is invalid",
+        "ui.error.upload.progressInvalid": "Upload progress must be from zero through one hundred",
+    }),
+    "zh-CN": Object.freeze({
+        "ui.loading": "加载中",
+        "ui.search": "搜索",
+        "ui.search.clear": "清除搜索内容",
+        "ui.dialog.close": "关闭对话框",
+        "ui.drawer.close": "关闭抽屉",
+        "ui.notification.dismiss": "关闭通知",
+        "ui.pagination.label": "分页导航",
+        "ui.pagination.previous": "上一页",
+        "ui.pagination.next": "下一页",
+        "ui.pagination.page": "第 {page} 页",
+        "ui.breadcrumb.label": "面包屑导航",
+        "ui.menu.label": "菜单",
+        "ui.sectionNavigation.label": "分区导航",
+        "ui.action.dismiss": "关闭",
+        "ui.action.cancel": "取消",
+        "ui.action.retry": "重试",
+        "ui.action.remove": "移除",
+        "ui.confirm.confirmationInputLabel": "确认文本",
+        "ui.combobox.loadError": "无法加载选项",
+        "ui.tree.loadError": "无法加载子项",
+        "ui.table.selectRow": "选择行",
+        "ui.table.selectPage": "选择当前页",
+        "ui.upload.queued": "等待上传",
+        "ui.upload.uploading": "上传中",
+        "ui.upload.success": "上传完成",
+        "ui.upload.error": "上传失败",
+        "ui.upload.cancelled": "已取消上传",
+        "ui.error.locale.providerMissing": "需要 Miaixz 多语言提供器",
+        "ui.error.toast.providerMissing": "useToast 必须在 ToastProvider 内使用",
+        "ui.error.tabs.providerMissing": "Tab 组件必须在 Tabs 内使用",
+        "ui.error.progress.maxInvalid": "进度最大值必须大于零",
+        "ui.error.progress.valueInvalid": "进度值必须是有限数值",
+        "ui.error.options.sourceInvalid": "必须且只能提供一个选项来源",
+        "ui.error.controlled.valueInvalid": "受控值配置无效",
+        "ui.error.controlled.inputInvalid": "受控输入配置无效",
+        "ui.error.controlled.modeChanged": "组件挂载后不能切换控制模式",
+        "ui.error.selection.limitInvalid": "选择上限必须是正整数",
+        "ui.error.tree.duplicateId": "树节点标识必须唯一",
+        "ui.error.table.duplicateColumnId": "表格列标识必须唯一",
+        "ui.error.table.duplicateRowId": "表格行标识必须唯一",
+        "ui.error.file.typeNotAccepted": "不支持所选文件类型",
+        "ui.error.file.tooLarge": "所选文件过大",
+        "ui.error.file.countExceeded": "选择的文件数量过多",
+        "ui.error.file.maxFilesInvalid": "最大文件数量无效",
+        "ui.error.file.maxSizeInvalid": "最大文件大小无效",
+        "ui.error.upload.progressInvalid": "上传进度必须在零到一百之间",
+    }),
+});
+const MiaixzLocaleContext = createContext(undefined);
+const registeredUiRuntimes = new WeakSet();
+/**
+ * Registers UI package resources once for each SDK runtime instance.
+ *
+ * @param i18n - SDK runtime receiving built-in UI resources.
+ */
+function registerUiMessages(i18n) {
+    if (registeredUiRuntimes.has(i18n))
+        return;
+    for (const [locale, messages] of Object.entries(miaixzUiMessages)) {
+        i18n.registerMessages("ui", locale, messages, "builtin");
+    }
+    registeredUiRuntimes.add(i18n);
+}
+/**
+ * Adapts one SDK internationalization runtime to a React subtree.
+ *
+ * @param props - SDK runtime and child subtree.
+ * @returns React context provider bound to the SDK snapshot.
+ * @public
+ */
+export function MiaixzLocaleProvider(props) {
+    const { i18n, children } = props;
+    registerUiMessages(i18n);
+    const snapshot = useSyncExternalStore((listener) => i18n.subscribe(listener), () => i18n.getSnapshot(), () => i18n.getSnapshot());
+    useEffect(() => {
+        void i18n.loadNamespace("ui", snapshot.locale).catch(() => undefined);
+    }, [i18n, snapshot.locale]);
+    const value = useMemo(() => ({ ...snapshot, t: i18n.t }), [i18n, snapshot]);
+    return _jsx(MiaixzLocaleContext.Provider, { value: value, children: children });
+}
+/**
+ * Returns the nearest SDK-backed locale context.
+ *
+ * @returns Active locale snapshot and translator.
+ * @throws MiaixzUiError When called outside a Miaixz locale provider.
+ * @public
+ */
+export function useMiaixzLocale() {
+    const value = useContext(MiaixzLocaleContext);
+    if (value !== undefined)
+        return value;
+    const messageKey = "ui.error.locale.providerMissing";
+    throw new MiaixzUiError(messageKey, {
+        code: "UI_LOCALE_PROVIDER_MISSING",
+        messageKey,
+    });
+}
+//# sourceMappingURL=i18n.js.map

package/dist/i18n/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../src/i18n/i18n.tsx"],"names":[],"mappings":"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","sourcesContent":["import type {\n  MiaixzI18n,\n  MiaixzI18nSnapshot,\n  MiaixzMessageCatalog,\n  MiaixzTranslator,\n} from \"@miaixz/sdk/i18n\";\nimport {\n  createContext,\n  useContext,\n  useEffect,\n  useMemo,\n  useSyncExternalStore,\n  type ReactNode,\n} from \"react\";\n\nimport { MiaixzUiError } from \"../errors/index.js\";\n\nexport type {\n  MiaixzI18n,\n  MiaixzI18nSnapshot,\n  MiaixzLocale,\n  MiaixzMessageCatalog,\n  MiaixzMessageLoader,\n  MiaixzMessageLoaderMap,\n  MiaixzMessageLoaderResult,\n  MiaixzMessageModule,\n  MiaixzMessageParams,\n  MiaixzMessages,\n  MiaixzMessageSource,\n  MiaixzTranslator,\n} from \"@miaixz/sdk/i18n\";\n\n/**\n * Configures the React adapter for an existing SDK internationalization runtime.\n *\n * @public\n */\nexport interface MiaixzLocaleProviderProps {\n  /**\n   * Supplies the sole SDK-owned internationalization runtime.\n   */\n  readonly i18n: MiaixzI18n;\n\n  /**\n   * Renders the subtree that consumes the locale context.\n   */\n  readonly children: ReactNode;\n}\n\n/**\n * Exposes the SDK snapshot and translator through React context.\n *\n * @public\n */\nexport interface MiaixzLocaleContextValue extends MiaixzI18nSnapshot {\n  /**\n   * Resolves localized messages through the supplied SDK runtime.\n   */\n  readonly t: MiaixzTranslator;\n}\n\n/**\n * Provides all built-in UI messages in English and Simplified Chinese.\n *\n * @public\n */\nexport const miaixzUiMessages: MiaixzMessageCatalog = Object.freeze({\n  \"en-US\": Object.freeze({\n    \"ui.loading\": \"Loading\",\n    \"ui.search\": \"Search\",\n    \"ui.search.clear\": \"Clear search\",\n    \"ui.dialog.close\": \"Close dialog\",\n    \"ui.drawer.close\": \"Close drawer\",\n    \"ui.notification.dismiss\": \"Dismiss notification\",\n    \"ui.pagination.label\": \"Pagination\",\n    \"ui.pagination.previous\": \"Previous page\",\n    \"ui.pagination.next\": \"Next page\",\n    \"ui.pagination.page\": \"Page {page}\",\n    \"ui.breadcrumb.label\": \"Breadcrumb\",\n    \"ui.menu.label\": \"Menu\",\n    \"ui.sectionNavigation.label\": \"Section navigation\",\n    \"ui.action.dismiss\": \"Dismiss\",\n    \"ui.action.cancel\": \"Cancel\",\n    \"ui.action.retry\": \"Retry\",\n    \"ui.action.remove\": \"Remove\",\n    \"ui.confirm.confirmationInputLabel\": \"Confirmation text\",\n    \"ui.combobox.loadError\": \"Options could not be loaded\",\n    \"ui.tree.loadError\": \"Child items could not be loaded\",\n    \"ui.table.selectRow\": \"Select row\",\n    \"ui.table.selectPage\": \"Select current page\",\n    \"ui.upload.queued\": \"Queued\",\n    \"ui.upload.uploading\": \"Uploading\",\n    \"ui.upload.success\": \"Upload complete\",\n    \"ui.upload.error\": \"Upload failed\",\n    \"ui.upload.cancelled\": \"Upload cancelled\",\n    \"ui.error.locale.providerMissing\": \"A Miaixz locale provider is required\",\n    \"ui.error.toast.providerMissing\": \"useToast must be used inside ToastProvider\",\n    \"ui.error.tabs.providerMissing\": \"Tab components must be used inside Tabs\",\n    \"ui.error.progress.maxInvalid\": \"The progress maximum must be greater than zero\",\n    \"ui.error.progress.valueInvalid\": \"The progress value must be finite\",\n    \"ui.error.options.sourceInvalid\": \"Exactly one option source is required\",\n    \"ui.error.controlled.valueInvalid\": \"The controlled value configuration is invalid\",\n    \"ui.error.controlled.inputInvalid\": \"The controlled input configuration is invalid\",\n    \"ui.error.controlled.modeChanged\": \"The component control mode cannot change after mounting\",\n    \"ui.error.selection.limitInvalid\": \"The selection limit must be a positive integer\",\n    \"ui.error.tree.duplicateId\": \"Tree node identifiers must be unique\",\n    \"ui.error.table.duplicateColumnId\": \"Table column identifiers must be unique\",\n    \"ui.error.table.duplicateRowId\": \"Table row identifiers must be unique\",\n    \"ui.error.file.typeNotAccepted\": \"The selected file type is not accepted\",\n    \"ui.error.file.tooLarge\": \"The selected file is too large\",\n    \"ui.error.file.countExceeded\": \"Too many files were selected\",\n    \"ui.error.file.maxFilesInvalid\": \"The maximum file count is invalid\",\n    \"ui.error.file.maxSizeInvalid\": \"The maximum file size is invalid\",\n    \"ui.error.upload.progressInvalid\": \"Upload progress must be from zero through one hundred\",\n  }),\n  \"zh-CN\": Object.freeze({\n    \"ui.loading\": \"加载中\",\n    \"ui.search\": \"搜索\",\n    \"ui.search.clear\": \"清除搜索内容\",\n    \"ui.dialog.close\": \"关闭对话框\",\n    \"ui.drawer.close\": \"关闭抽屉\",\n    \"ui.notification.dismiss\": \"关闭通知\",\n    \"ui.pagination.label\": \"分页导航\",\n    \"ui.pagination.previous\": \"上一页\",\n    \"ui.pagination.next\": \"下一页\",\n    \"ui.pagination.page\": \"第 {page} 页\",\n    \"ui.breadcrumb.label\": \"面包屑导航\",\n    \"ui.menu.label\": \"菜单\",\n    \"ui.sectionNavigation.label\": \"分区导航\",\n    \"ui.action.dismiss\": \"关闭\",\n    \"ui.action.cancel\": \"取消\",\n    \"ui.action.retry\": \"重试\",\n    \"ui.action.remove\": \"移除\",\n    \"ui.confirm.confirmationInputLabel\": \"确认文本\",\n    \"ui.combobox.loadError\": \"无法加载选项\",\n    \"ui.tree.loadError\": \"无法加载子项\",\n    \"ui.table.selectRow\": \"选择行\",\n    \"ui.table.selectPage\": \"选择当前页\",\n    \"ui.upload.queued\": \"等待上传\",\n    \"ui.upload.uploading\": \"上传中\",\n    \"ui.upload.success\": \"上传完成\",\n    \"ui.upload.error\": \"上传失败\",\n    \"ui.upload.cancelled\": \"已取消上传\",\n    \"ui.error.locale.providerMissing\": \"需要 Miaixz 多语言提供器\",\n    \"ui.error.toast.providerMissing\": \"useToast 必须在 ToastProvider 内使用\",\n    \"ui.error.tabs.providerMissing\": \"Tab 组件必须在 Tabs 内使用\",\n    \"ui.error.progress.maxInvalid\": \"进度最大值必须大于零\",\n    \"ui.error.progress.valueInvalid\": \"进度值必须是有限数值\",\n    \"ui.error.options.sourceInvalid\": \"必须且只能提供一个选项来源\",\n    \"ui.error.controlled.valueInvalid\": \"受控值配置无效\",\n    \"ui.error.controlled.inputInvalid\": \"受控输入配置无效\",\n    \"ui.error.controlled.modeChanged\": \"组件挂载后不能切换控制模式\",\n    \"ui.error.selection.limitInvalid\": \"选择上限必须是正整数\",\n    \"ui.error.tree.duplicateId\": \"树节点标识必须唯一\",\n    \"ui.error.table.duplicateColumnId\": \"表格列标识必须唯一\",\n    \"ui.error.table.duplicateRowId\": \"表格行标识必须唯一\",\n    \"ui.error.file.typeNotAccepted\": \"不支持所选文件类型\",\n    \"ui.error.file.tooLarge\": \"所选文件过大\",\n    \"ui.error.file.countExceeded\": \"选择的文件数量过多\",\n    \"ui.error.file.maxFilesInvalid\": \"最大文件数量无效\",\n    \"ui.error.file.maxSizeInvalid\": \"最大文件大小无效\",\n    \"ui.error.upload.progressInvalid\": \"上传进度必须在零到一百之间\",\n  }),\n});\n\nconst MiaixzLocaleContext = createContext<MiaixzLocaleContextValue | undefined>(undefined);\nconst registeredUiRuntimes = new WeakSet<MiaixzI18n>();\n\n/**\n * Registers UI package resources once for each SDK runtime instance.\n *\n * @param i18n - SDK runtime receiving built-in UI resources.\n */\nfunction registerUiMessages(i18n: MiaixzI18n): void {\n  if (registeredUiRuntimes.has(i18n)) return;\n  for (const [locale, messages] of Object.entries(miaixzUiMessages)) {\n    i18n.registerMessages(\"ui\", locale, messages, \"builtin\");\n  }\n  registeredUiRuntimes.add(i18n);\n}\n\n/**\n * Adapts one SDK internationalization runtime to a React subtree.\n *\n * @param props - SDK runtime and child subtree.\n * @returns React context provider bound to the SDK snapshot.\n * @public\n */\nexport function MiaixzLocaleProvider(props: MiaixzLocaleProviderProps) {\n  const { i18n, children } = props;\n  registerUiMessages(i18n);\n  const snapshot = useSyncExternalStore(\n    (listener) => i18n.subscribe(listener),\n    () => i18n.getSnapshot(),\n    () => i18n.getSnapshot(),\n  );\n\n  useEffect(() => {\n    void i18n.loadNamespace(\"ui\", snapshot.locale).catch(() => undefined);\n  }, [i18n, snapshot.locale]);\n\n  const value = useMemo<MiaixzLocaleContextValue>(\n    () => ({ ...snapshot, t: i18n.t }),\n    [i18n, snapshot],\n  );\n  return <MiaixzLocaleContext.Provider value={value}>{children}</MiaixzLocaleContext.Provider>;\n}\n\n/**\n * Returns the nearest SDK-backed locale context.\n *\n * @returns Active locale snapshot and translator.\n * @throws MiaixzUiError When called outside a Miaixz locale provider.\n * @public\n */\nexport function useMiaixzLocale(): MiaixzLocaleContextValue {\n  const value = useContext(MiaixzLocaleContext);\n  if (value !== undefined) return value;\n  const messageKey = \"ui.error.locale.providerMissing\";\n  throw new MiaixzUiError(messageKey, {\n    code: \"UI_LOCALE_PROVIDER_MISSING\",\n    messageKey,\n  });\n}\n"]}

package/dist/i18n/index.d.ts

@@ -0,0 +1,3 @@
+export * from "../errors/index.js";
+export * from "./i18n.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/i18n/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC"}

package/dist/i18n/index.js

@@ -0,0 +1,3 @@
+export * from "../errors/index.js";
+export * from "./i18n.js";
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC","sourcesContent":["export * from \"../errors/index.js\";\nexport * from \"./i18n.js\";\n"]}

package/dist/icons/icon-names.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Identifies a statically registered Lucide icon available to the Miaixz icon component.
+ *
+ * @public
+ */
+export type MiaixzIconName = "Check" | "ChevronDown" | "ChevronLeft" | "ChevronRight" | "CircleAlert" | "CircleCheck" | "File" | "Folder" | "FolderOpen" | "Info" | "LoaderCircle" | "Minus" | "Plus" | "RotateCcw" | "Search" | "Trash2" | "TriangleAlert" | "Upload" | "X";
+//# sourceMappingURL=icon-names.d.ts.map

package/dist/icons/icon-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-names.d.ts","sourceRoot":"","sources":["../../src/icons/icon-names.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,OAAO,GACP,aAAa,GACb,aAAa,GACb,cAAc,GACd,aAAa,GACb,aAAa,GACb,MAAM,GACN,QAAQ,GACR,YAAY,GACZ,MAAM,GACN,cAAc,GACd,OAAO,GACP,MAAM,GACN,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,eAAe,GACf,QAAQ,GACR,GAAG,CAAC"}

package/dist/icons/icon-names.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=icon-names.js.map

package/dist/icons/icon-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-names.js","sourceRoot":"","sources":["../../src/icons/icon-names.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * Identifies a statically registered Lucide icon available to the Miaixz icon component.\n *\n * @public\n */\nexport type MiaixzIconName =\n  | \"Check\"\n  | \"ChevronDown\"\n  | \"ChevronLeft\"\n  | \"ChevronRight\"\n  | \"CircleAlert\"\n  | \"CircleCheck\"\n  | \"File\"\n  | \"Folder\"\n  | \"FolderOpen\"\n  | \"Info\"\n  | \"LoaderCircle\"\n  | \"Minus\"\n  | \"Plus\"\n  | \"RotateCcw\"\n  | \"Search\"\n  | \"Trash2\"\n  | \"TriangleAlert\"\n  | \"Upload\"\n  | \"X\";\n"]}

package/dist/icons/icon-registry.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Maps the frozen Miaixz icon names to statically imported Lucide components.
+ *
+ * The frozen object prevents project code from mutating the shared registry. Project-specific
+ * icons must be rendered with `CustomIcon` instead of extending this map at runtime.
+ *
+ * @internal
+ */
+export declare const miaixzIconRegistry: Readonly<{
+    Check: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    ChevronDown: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    ChevronLeft: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    ChevronRight: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    CircleAlert: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    CircleCheck: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    File: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    Folder: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    FolderOpen: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    Info: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    LoaderCircle: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    Minus: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    Plus: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    RotateCcw: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    Search: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    Trash2: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    TriangleAlert: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    Upload: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+    X: import("react").ForwardRefExoticComponent<Omit<import("lucide-react").LucideProps, "ref"> & import("react").RefAttributes<SVGSVGElement>>;
+}>;
+//# sourceMappingURL=icon-registry.d.ts.map

package/dist/icons/icon-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-registry.d.ts","sourceRoot":"","sources":["../../src/icons/icon-registry.ts"],"names":[],"mappings":"AAyBA;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;EAoB0B,CAAC"}

package/dist/icons/icon-registry.js

@@ -0,0 +1,31 @@
+import { Check, ChevronDown, ChevronLeft, ChevronRight, CircleAlert, CircleCheck, File, Folder, FolderOpen, Info, LoaderCircle, Minus, Plus, RotateCcw, Search, Trash2, TriangleAlert, Upload, X, } from "lucide-react";
+/**
+ * Maps the frozen Miaixz icon names to statically imported Lucide components.
+ *
+ * The frozen object prevents project code from mutating the shared registry. Project-specific
+ * icons must be rendered with `CustomIcon` instead of extending this map at runtime.
+ *
+ * @internal
+ */
+export const miaixzIconRegistry = Object.freeze({
+    Check,
+    ChevronDown,
+    ChevronLeft,
+    ChevronRight,
+    CircleAlert,
+    CircleCheck,
+    File,
+    Folder,
+    FolderOpen,
+    Info,
+    LoaderCircle,
+    Minus,
+    Plus,
+    RotateCcw,
+    Search,
+    Trash2,
+    TriangleAlert,
+    Upload,
+    X,
+});
+//# sourceMappingURL=icon-registry.js.map

package/dist/icons/icon-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icon-registry.js","sourceRoot":"","sources":["../../src/icons/icon-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,WAAW,EACX,IAAI,EACJ,MAAM,EACN,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,KAAK,EACL,IAAI,EACJ,SAAS,EACT,MAAM,EACN,MAAM,EACN,aAAa,EACb,MAAM,EACN,CAAC,GAEF,MAAM,cAAc,CAAC;AAItB;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9C,KAAK;IACL,WAAW;IACX,WAAW;IACX,YAAY;IACZ,WAAW;IACX,WAAW;IACX,IAAI;IACJ,MAAM;IACN,UAAU;IACV,IAAI;IACJ,YAAY;IACZ,KAAK;IACL,IAAI;IACJ,SAAS;IACT,MAAM;IACN,MAAM;IACN,aAAa;IACb,MAAM;IACN,CAAC;CACqD,CAAC,CAAC","sourcesContent":["import {\n  Check,\n  ChevronDown,\n  ChevronLeft,\n  ChevronRight,\n  CircleAlert,\n  CircleCheck,\n  File,\n  Folder,\n  FolderOpen,\n  Info,\n  LoaderCircle,\n  Minus,\n  Plus,\n  RotateCcw,\n  Search,\n  Trash2,\n  TriangleAlert,\n  Upload,\n  X,\n  type LucideIcon,\n} from \"lucide-react\";\n\nimport type { MiaixzIconName } from \"./icon-names.js\";\n\n/**\n * Maps the frozen Miaixz icon names to statically imported Lucide components.\n *\n * The frozen object prevents project code from mutating the shared registry. Project-specific\n * icons must be rendered with `CustomIcon` instead of extending this map at runtime.\n *\n * @internal\n */\nexport const miaixzIconRegistry = Object.freeze({\n  Check,\n  ChevronDown,\n  ChevronLeft,\n  ChevronRight,\n  CircleAlert,\n  CircleCheck,\n  File,\n  Folder,\n  FolderOpen,\n  Info,\n  LoaderCircle,\n  Minus,\n  Plus,\n  RotateCcw,\n  Search,\n  Trash2,\n  TriangleAlert,\n  Upload,\n  X,\n} satisfies Readonly<Record<MiaixzIconName, LucideIcon>>);\n"]}

package/dist/icons/index.d.ts

@@ -0,0 +1,4 @@
+export type { MiaixzIconName } from "./icon-names.js";
+export { CustomIcon, Icon } from "../components/icon/index.js";
+export type { CustomIconProps, IconProps, IconSize, IconStroke } from "../components/icon/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/icons/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/icons/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAC/D,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/icons/index.js

@@ -0,0 +1,2 @@
+export { CustomIcon, Icon } from "../components/icon/index.js";
+//# sourceMappingURL=index.js.map

package/dist/icons/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/icons/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC","sourcesContent":["export type { MiaixzIconName } from \"./icon-names.js\";\nexport { CustomIcon, Icon } from \"../components/icon/index.js\";\nexport type { CustomIconProps, IconProps, IconSize, IconStroke } from \"../components/icon/index.js\";\n"]}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./components/index.js";
+export * from "./errors/index.js";
+export * from "./i18n/index.js";
+export * from "./runtime/appearance.js";
+export type { MiaixzIconName } from "./icons/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./components/index.js";
+export * from "./errors/index.js";
+export * from "./i18n/index.js";
+export * from "./runtime/appearance.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC","sourcesContent":["export * from \"./components/index.js\";\nexport * from \"./errors/index.js\";\nexport * from \"./i18n/index.js\";\nexport * from \"./runtime/appearance.js\";\nexport type { MiaixzIconName } from \"./icons/index.js\";\n"]}

package/dist/internal/class-names.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Joins truthy class names without adding external runtime dependencies.
+ *
+ * @param values - Candidate class names and false-like values.
+ * @returns A space-delimited class-name string.
+ */
+export declare function classNames(...values: ReadonlyArray<string | false | null | undefined>): string;
+//# sourceMappingURL=class-names.d.ts.map

package/dist/internal/class-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-names.d.ts","sourceRoot":"","sources":["../../src/internal/class-names.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,MAAM,EAAE,aAAa,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAE9F"}

package/dist/internal/class-names.js

@@ -0,0 +1,10 @@
+/**
+ * Joins truthy class names without adding external runtime dependencies.
+ *
+ * @param values - Candidate class names and false-like values.
+ * @returns A space-delimited class-name string.
+ */
+export function classNames(...values) {
+    return values.filter(Boolean).join(" ");
+}
+//# sourceMappingURL=class-names.js.map

package/dist/internal/class-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-names.js","sourceRoot":"","sources":["../../src/internal/class-names.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,GAAG,MAAwD;IACpF,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["/**\n * Joins truthy class names without adding external runtime dependencies.\n *\n * @param values - Candidate class names and false-like values.\n * @returns A space-delimited class-name string.\n */\nexport function classNames(...values: ReadonlyArray<string | false | null | undefined>): string {\n  return values.filter(Boolean).join(\" \");\n}\n"]}

package/dist/internal/menu/index.d.ts

@@ -0,0 +1,3 @@
+export { MiaixzMenu } from "./menu.js";
+export type { MiaixzMenuProps } from "./menu.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/menu/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/menu/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC"}

package/dist/internal/menu/index.js

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

package/dist/internal/menu/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/menu/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC","sourcesContent":["export { MiaixzMenu } from \"./menu.js\";\nexport type { MiaixzMenuProps } from \"./menu.js\";\n"]}

package/dist/internal/menu/menu.d.ts

@@ -0,0 +1,33 @@
+import { type HTMLAttributes, type RefObject } from "react";
+/**
+ * Configures the package-internal WAI-ARIA menu behavior.
+ */
+export interface MiaixzMenuProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Controls initial focus and active keyboard behavior.
+     */
+    readonly active: boolean;
+    /**
+     * References the menu button used for restoration and Tab ordering.
+     */
+    readonly triggerRef: RefObject<HTMLButtonElement | null>;
+    /**
+     * Requests closure and chooses whether trigger focus should be restored.
+     */
+    readonly onRequestClose: (restoreFocus: boolean) => void;
+}
+/**
+ * Renders the single package-internal menu pattern used by Dropdown and future composites.
+ *
+ * @param props - Native menu attributes and package-owned lifecycle controls.
+ * @param props.active - Whether the menu owns keyboard focus.
+ * @param props.triggerRef - Reference to the owning menu button.
+ * @param props.onRequestClose - Closure request with focus-restoration intent.
+ * @param props.className - Optional project class merged with the internal menu class.
+ * @param props.children - Menu item, label, and divider content.
+ * @param props.onClick - Optional native click observer.
+ * @param props.onKeyDown - Optional native keyboard observer.
+ * @returns A WAI-ARIA menu with roving focus and Portal-safe Tab behavior.
+ */
+export declare function MiaixzMenu({ active, triggerRef, onRequestClose, className, children, onClick, onKeyDown, ...props }: MiaixzMenuProps): import("react").JSX.Element;
+//# sourceMappingURL=menu.d.ts.map

package/dist/internal/menu/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../src/internal/menu/menu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EAGnB,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AA0Bf;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,cAAc,CAAC,cAAc,CAAC;IACrE;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAEzD;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,UAAU,EACV,cAAc,EACd,SAAS,EACT,QAAQ,EACR,OAAO,EACP,SAAS,EACT,GAAG,KAAK,EACT,EAAE,eAAe,+BAkCjB"}