@zerodep-dev/vue-tsx-pro-ui 0.0.0-stage → 0.1.0

package/dist/config/createUi.js

@@ -0,0 +1,96 @@
+import { ConfigContext, defaultConfig } from "./context.js";
+import { mergeStyles } from "./styles.js";
+import { resolveTheme, themeVariables } from "./theme/theme.js";
+import { usePrefersDark } from "../utils/dom/media-query.js";
+import { defineLang } from "./lang/lang.js";
+import { computed, effectScope, toValue, watchEffect } from "vue";
+import * as css from "@zerodep-dev/vue-tsx-pro-tsx/styles";
+//#region src/config/createUi.ts
+/**
+* 应用级配置：在宿主入口里 `app.use(createUi({ theme, lang }))`，所有 TSX 页面共享，不必逐页包裹 Provider。
+* 传入 ref 或 getter 即可在运行时切换主题与语言。
+*/
+/** paintDocument 时页面根元素的样式 */
+var documentStyles = css.create({
+	page: {
+		backgroundColor: "_background",
+		color: "_text",
+		fontFamily: "_sans",
+		lineHeight: "_normal",
+		WebkitFontSmoothing: "antialiased",
+		MozOsxFontSmoothing: "grayscale"
+	},
+	body: { margin: 0 }
+});
+/**
+* 应用级配置的 Vue 插件：`app.use(createUi({ theme: { light: lightTheme, dark: darkTheme } }))`。
+* 主题的 CSS 变量写在页面根元素上，所有 TSX 页面共享；应用卸载时撤销。
+*/
+function createUi(options = {}) {
+	return { install(app) {
+		const scope = effectScope();
+		app.onUnmount(() => scope.stop());
+		scope.run(() => {
+			const prefersDark = usePrefersDark();
+			const theme = computed(() => resolveTheme(toValue(options.theme) ?? defaultConfig.theme, prefersDark.value));
+			const lang = computed(() => defineLang(defaultConfig.lang, toValue(options.lang) ?? {}));
+			app.provide(ConfigContext.key, {
+				get theme() {
+					return theme.value;
+				},
+				get lang() {
+					return lang.value;
+				},
+				highlighter: options.highlighter,
+				textMatcher: options.textMatcher,
+				defaults: options.defaults ?? {},
+				styles: mergeStyles({}, options.styles),
+				router: options.router,
+				http: options.http,
+				workCalendar: options.workCalendar,
+				ripple: options.ripple ?? true
+			});
+			if (options.lang && typeof document !== "undefined") {
+				const root = document.documentElement;
+				const previous = {
+					lang: root.lang,
+					dir: root.dir
+				};
+				watchEffect(() => {
+					root.lang = lang.value.code;
+					root.dir = lang.value.direction;
+				});
+				app.onUnmount(() => Object.assign(root, previous));
+			}
+			if ((options.theme || options.paintDocument) && typeof document !== "undefined") {
+				const root = document.documentElement;
+				if (options.paintDocument) root.style.removeProperty("background-color");
+				if (options.paintDocument) root.style.removeProperty("color");
+				watchEffect((onCleanup) => onCleanup(applyTheme(root, theme.value, options.paintDocument ?? false)));
+				if (options.paintDocument && document.body) {
+					const body = document.body;
+					const classes = css.attrs(documentStyles.body).class?.split(" ") ?? [];
+					body.classList.add(...classes);
+					app.onUnmount(() => body.classList.remove(...classes));
+				}
+			}
+		});
+	} };
+}
+/** 把主题的 class、CSS 变量与 data-theme 写到元素上，返回撤销函数 */
+function applyTheme(element, theme, paint) {
+	const classes = css.attrs(...theme.styles, paint && documentStyles.page).class?.split(" ").filter(Boolean) ?? [];
+	const variables = themeVariables(theme);
+	element.classList.add(...classes);
+	for (const [name, value] of Object.entries(variables)) element.style.setProperty(name, value);
+	element.dataset.theme = theme.name;
+	return () => {
+		element.classList.remove(...classes);
+		for (const name of Object.keys(variables)) element.style.removeProperty(name);
+		delete element.dataset.theme;
+	};
+}
+//#endregion
+export { createUi, documentStyles };
+
+//# sourceMappingURL=createUi.js.map

package/dist/config/createUi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createUi.js","names":[],"sources":["../../src/config/createUi.ts"],"sourcesContent":["/**\n * 应用级配置：在宿主入口里 `app.use(createUi({ theme, lang }))`，所有 TSX 页面共享，不必逐页包裹 Provider。\n * 传入 ref 或 getter 即可在运行时切换主题与语言。\n */\nimport {\n  computed,\n  effectScope,\n  toValue,\n  watchEffect,\n  type MaybeRefOrGetter,\n  type Plugin,\n} from 'vue';\nimport * as css from '@zerodep-dev/vue-tsx-pro-tsx/styles';\nimport {\n  ConfigContext,\n  defaultConfig,\n  type Highlighter,\n  type TextMatcher,\n  type UiRouter,\n} from './context';\nimport type { ComponentDefaults } from './defaults';\nimport { mergeStyles, type ComponentStyles } from './styles';\nimport { defineLang, type Lang } from './lang/lang';\nimport { usePrefersDark } from '../utils/dom/media-query';\nimport type { WorkCalendar } from '../utils/data/workdays';\nimport type { HttpClient } from '../utils/request/http';\nimport { resolveTheme, themeVariables, type Theme, type ThemeInput } from './theme/theme';\n\n/** 应用级配置；theme 与 lang 可以传 ref 或 getter，运行时切换，其余在安装时确定 */\nexport interface UiOptions {\n  /** 主题；不写时用亮色主题，也不改动页面根元素 */\n  theme?: MaybeRefOrGetter<ThemeInput>;\n  /** 只写要改的字段，其余用简体中文的默认值 */\n  lang?: MaybeRefOrGetter<Partial<Lang>>;\n  /** 代码高亮器（CodeBlock 用），如 `@zerodep-dev/vue-tsx-pro-ui/shiki` 的 createShikiHighlighter()；不写时显示纯文本 */\n  highlighter?: Highlighter;\n  /** 额外的文字匹配，如 `@zerodep-dev/vue-tsx-pro-ui/pinyin` 的 createPinyinMatcher()：选项过滤、命令面板认拼音；不写时只按字面匹配 */\n  textMatcher?: TextMatcher;\n  /** 组件默认值，如 `{ Button: { variant: 'outline' } }`（见 defaults.ts） */\n  defaults?: ComponentDefaults;\n  /** 组件的主题定制：追加样式、新增档位，如 `{ Button: { base: { root: { letterSpacing: '0.02em' } } } }`（见 styles.ts） */\n  styles?: ComponentStyles;\n  /** 路由适配：站内链接不刷新页面地跳转、导航组件判断当前页（见 UiRouter） */\n  router?: UiRouter;\n  /** 请求客户端：createHttpClient({ baseURL, onRequest, onResponse })，或包一层 axios、ky（见 HttpClient） */\n  http?: HttpClient;\n  /** 工作日历：createWorkCalendar({ holidays, workdays }) 带上法定节假日与调休；不写时只按周末算 */\n  workCalendar?: WorkCalendar;\n  /** 按下时的波纹效果，默认 true；关掉后组件的 ripple prop 仍可单独打开 */\n  ripple?: boolean;\n  /**\n   * 页面根元素也用主题的背景色、文字色与字体，并去掉 body 的默认外边距，默认 false。\n   * 整页都由组件库主题管理的站点（如文档站）打开：页面边缘、回弹滚动露出的地方不再是浏览器的默认色，\n   * AppShell 贴满窗口、四周不留 8px 的白边；配合 themeBootScript 时接手它写的行内颜色\n   */\n  paintDocument?: boolean;\n}\n\n/** paintDocument 时页面根元素的样式 */\nexport const documentStyles = css.create({\n  // 字号不设：根元素的字号是 rem 的基准，留给浏览器（用户的字号设置）\n  page: {\n    backgroundColor: '_background',\n    color: '_text',\n    fontFamily: '_sans',\n    lineHeight: '_normal',\n    // macOS 上用灰度抗锯齿，深色底上的浅色文字不发虚；其他系统忽略\n    WebkitFontSmoothing: 'antialiased',\n    MozOsxFontSmoothing: 'grayscale',\n  },\n  // 浏览器给 body 的 8px 外边距：整页的外壳（AppShell）要贴满窗口\n  body: { margin: 0 },\n});\n\n/**\n * 应用级配置的 Vue 插件：`app.use(createUi({ theme: { light: lightTheme, dark: darkTheme } }))`。\n * 主题的 CSS 变量写在页面根元素上，所有 TSX 页面共享；应用卸载时撤销。\n */\nexport function createUi(options: UiOptions = {}): Plugin {\n  return {\n    install(app) {\n      const scope = effectScope();\n      app.onUnmount(() => scope.stop());\n      scope.run(() => {\n        const prefersDark = usePrefersDark();\n        const theme = computed(() =>\n          resolveTheme(toValue(options.theme) ?? defaultConfig.theme, prefersDark.value),\n        );\n        const lang = computed(() => defineLang(defaultConfig.lang, toValue(options.lang) ?? {}));\n        app.provide(ConfigContext.key, {\n          get theme() {\n            return theme.value;\n          },\n          get lang() {\n            return lang.value;\n          },\n          highlighter: options.highlighter,\n          textMatcher: options.textMatcher,\n          defaults: options.defaults ?? {},\n          styles: mergeStyles({}, options.styles),\n          router: options.router,\n          http: options.http,\n          workCalendar: options.workCalendar,\n          ripple: options.ripple ?? true,\n        });\n        // 应用级的语言也写在页面根元素上（Provider 写在自己的元素上）：读屏按 lang 选发音，\n        // 从右到左的语言靠 dir 镜像排版与滚动条；没传 lang 时不动，宿主自己管\n        if (options.lang && typeof document !== 'undefined') {\n          const root = document.documentElement;\n          const previous = { lang: root.lang, dir: root.dir };\n          watchEffect(() => {\n            root.lang = lang.value.code;\n            root.dir = lang.value.direction;\n          });\n          app.onUnmount(() => Object.assign(root, previous));\n        }\n        // 应用级没有容器元素，主题变量挂在页面根元素上；变量名带 vtp- 前缀，不会与宿主冲突。\n        // 只开 paintDocument、不传主题时用默认主题（整页也要有底色、字体，body 去掉外边距）\n        if ((options.theme || options.paintDocument) && typeof document !== 'undefined') {\n          const root = document.documentElement;\n          // themeBootScript 在应用加载前写的行内颜色：交给主题的 class\n          if (options.paintDocument) root.style.removeProperty('background-color');\n          if (options.paintDocument) root.style.removeProperty('color');\n          watchEffect((onCleanup) =>\n            onCleanup(applyTheme(root, theme.value, options.paintDocument ?? false)),\n          );\n          if (options.paintDocument && document.body) {\n            const body = document.body;\n            const classes = css.attrs(documentStyles.body).class?.split(' ') ?? [];\n            body.classList.add(...classes);\n            app.onUnmount(() => body.classList.remove(...classes));\n          }\n        }\n      });\n    },\n  };\n}\n\n/** 把主题的 class、CSS 变量与 data-theme 写到元素上，返回撤销函数 */\nfunction applyTheme(element: HTMLElement, theme: Theme, paint: boolean) {\n  const classes =\n    css\n      .attrs(...theme.styles, paint && documentStyles.page)\n      .class?.split(' ')\n      .filter(Boolean) ?? [];\n  const variables = themeVariables(theme);\n  element.classList.add(...classes);\n  for (const [name, value] of Object.entries(variables)) element.style.setProperty(name, value);\n  element.dataset.theme = theme.name;\n  return () => {\n    element.classList.remove(...classes);\n    for (const name of Object.keys(variables)) element.style.removeProperty(name);\n    delete element.dataset.theme;\n  };\n}\n"],"mappings":";;;;;;;;;;;;;AA2DA,IAAa,iBAAiB,IAAI,OAAO;CAEvC,MAAM;EACJ,iBAAiB;EACjB,OAAO;EACP,YAAY;EACZ,YAAY;EAEZ,qBAAqB;EACrB,qBAAqB;CACvB;CAEA,MAAM,EAAE,QAAQ,EAAE;AACpB,CAAC;;;;;AAMD,SAAgB,SAAS,UAAqB,CAAC,GAAW;CACxD,OAAO,EACL,QAAQ,KAAK;EACX,MAAM,QAAQ,YAAY;EAC1B,IAAI,gBAAgB,MAAM,KAAK,CAAC;EAChC,MAAM,UAAU;GACd,MAAM,cAAc,eAAe;GACnC,MAAM,QAAQ,eACZ,aAAa,QAAQ,QAAQ,KAAK,KAAK,cAAc,OAAO,YAAY,KAAK,CAC/E;GACA,MAAM,OAAO,eAAe,WAAW,cAAc,MAAM,QAAQ,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC;GACvF,IAAI,QAAQ,cAAc,KAAK;IAC7B,IAAI,QAAQ;KACV,OAAO,MAAM;IACf;IACA,IAAI,OAAO;KACT,OAAO,KAAK;IACd;IACA,aAAa,QAAQ;IACrB,aAAa,QAAQ;IACrB,UAAU,QAAQ,YAAY,CAAC;IAC/B,QAAQ,YAAY,CAAC,GAAG,QAAQ,MAAM;IACtC,QAAQ,QAAQ;IAChB,MAAM,QAAQ;IACd,cAAc,QAAQ;IACtB,QAAQ,QAAQ,UAAU;GAC5B,CAAC;GAGD,IAAI,QAAQ,QAAQ,OAAO,aAAa,aAAa;IACnD,MAAM,OAAO,SAAS;IACtB,MAAM,WAAW;KAAE,MAAM,KAAK;KAAM,KAAK,KAAK;IAAI;IAClD,kBAAkB;KAChB,KAAK,OAAO,KAAK,MAAM;KACvB,KAAK,MAAM,KAAK,MAAM;IACxB,CAAC;IACD,IAAI,gBAAgB,OAAO,OAAO,MAAM,QAAQ,CAAC;GACnD;GAGA,KAAK,QAAQ,SAAS,QAAQ,kBAAkB,OAAO,aAAa,aAAa;IAC/E,MAAM,OAAO,SAAS;IAEtB,IAAI,QAAQ,eAAe,KAAK,MAAM,eAAe,kBAAkB;IACvE,IAAI,QAAQ,eAAe,KAAK,MAAM,eAAe,OAAO;IAC5D,aAAa,cACX,UAAU,WAAW,MAAM,MAAM,OAAO,QAAQ,iBAAiB,KAAK,CAAC,CACzE;IACA,IAAI,QAAQ,iBAAiB,SAAS,MAAM;KAC1C,MAAM,OAAO,SAAS;KACtB,MAAM,UAAU,IAAI,MAAM,eAAe,IAAI,CAAC,CAAC,OAAO,MAAM,GAAG,KAAK,CAAA;KACpE,KAAK,UAAU,IAAI,GAAG,OAAO;KAC7B,IAAI,gBAAgB,KAAK,UAAU,OAAO,GAAG,OAAO,CAAC;IACvD;GACF;EACF,CAAC;CACH,EACF;AACF;;AAGA,SAAS,WAAW,SAAsB,OAAc,OAAgB;CACtE,MAAM,UACJ,IACG,MAAM,GAAG,MAAM,QAAQ,SAAS,eAAe,IAAI,CAAC,CACpD,OAAO,MAAM,GAAG,CAAC,CACjB,OAAO,OAAO,KAAK,CAAA;CACxB,MAAM,YAAY,eAAe,KAAK;CACtC,QAAQ,UAAU,IAAI,GAAG,OAAO;CAChC,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,SAAS,GAAG,QAAQ,MAAM,YAAY,MAAM,KAAK;CAC5F,QAAQ,QAAQ,QAAQ,MAAM;CAC9B,aAAa;EACX,QAAQ,UAAU,OAAO,GAAG,OAAO;EACnC,KAAK,MAAM,QAAQ,OAAO,KAAK,SAAS,GAAG,QAAQ,MAAM,eAAe,IAAI;EAC5E,OAAO,QAAQ,QAAQ;CACzB;AACF"}

package/dist/config/defaults.d.ts

@@ -0,0 +1,71 @@
+import type { BadgeOptions } from '../base/badge-styles';
+import type { AlertOptions } from '../feedback/Alert';
+import type { EmptyOptions } from '../feedback/Empty';
+import type { ProgressOptions } from '../feedback/Progress';
+import type { ResultOptions } from '../feedback/Result';
+import type { IndicatorOptions } from '../base/Indicator';
+import type { LinkOptions } from '../base/Link';
+import type { DialogOptions } from '../overlay/Dialog';
+import type { DrawerOptions } from '../overlay/Drawer';
+import type { AvatarOptions } from '../display/Avatar';
+import type { CardOptions } from '../display/Card';
+import type { ChoiceOptions } from '../input/choice-styles';
+import type { ControlOptions } from '../input/control';
+import type { TabsOptions } from '../navigation/Tabs';
+import type { DataTableOptions } from '../table/table-styles';
+import type { ButtonOptions } from '../base/button-core';
+/** 可以配置默认值的组件与选项；新组件有外观档位时在这里登记 */
+export interface ComponentDefaults {
+    /** Button、LinkButton、IconButton、IconLinkButton 共用 */
+    Button?: Partial<Pick<ButtonOptions, 'variant' | 'tone' | 'size' | 'radius'>>;
+    /** Badge、Tag 共用 */
+    Badge?: BadgeOptions;
+    /** Link */
+    Link?: LinkOptions;
+    /** Indicator */
+    Indicator?: IndicatorOptions;
+    /** Alert */
+    Alert?: AlertOptions;
+    /** Progress */
+    Progress?: ProgressOptions;
+    /** Empty */
+    Empty?: EmptyOptions;
+    /** Result */
+    Result?: ResultOptions;
+    /** Card */
+    Card?: CardOptions;
+    /** Dialog、AlertDialog 共用 */
+    Dialog?: DialogOptions;
+    /** Drawer */
+    Drawer?: DrawerOptions;
+    /** Avatar */
+    Avatar?: AvatarOptions;
+    /** Tabs */
+    Tabs?: TabsOptions;
+    /** 输入框：TextField、Textarea、NumberField、Select、Combobox 共用 */
+    Input?: ControlOptions;
+    /** 勾选类控件：Checkbox、RadioGroup、Switch 共用 */
+    Choice?: ChoiceOptions;
+    /** 表格：DataTable、TreeDataTable 共用 */
+    DataTable?: DataTableOptions;
+    /** 静态表格 Table */
+    Table?: DataTableOptions;
+}
+/** 合并两层默认值：按组件逐个合并，内层写了的选项覆盖外层 */
+export declare function mergeDefaults(outer: ComponentDefaults, inner: ComponentDefaults | undefined): ComponentDefaults;
+/** useDefaults 合并后的选项：给了 fallback 的项一定有值，其余可能仍是 undefined（如不写时继承字号的 size） */
+export type ResolvedDefaults<Own, Fallback> = {
+    [K in keyof Own as K extends keyof Fallback ? K : never]-?: Exclude<Own[K], undefined>;
+} & {
+    [K in keyof Own as K extends keyof Fallback ? never : K]: Own[K];
+};
+/**
+ * 组件的外观选项逐项合并：显式写的 prop > 最近一层 Provider > createUi > fallback（组件自己的默认值）。
+ * 在 setup 里调用；返回的函数在渲染时调用，读到最新的 prop 与配置（Provider 切换后跟着变）。
+ *
+ *   const appearance = useDefaults('Card', () => ({ variant, padding }), { variant: 'surface', padding: 'lg' });
+ *   const s = recipe(appearance());   // recipe = useRecipe(cardRecipe)：档位交给配方（config/styles.ts）
+ */
+export declare function useDefaults<Name extends keyof ComponentDefaults, Own extends NonNullable<ComponentDefaults[Name]>, const Fallback extends {
+    [K in keyof Own]?: Exclude<Own[K], undefined>;
+} = {}>(name: Name, read: () => Own, fallback?: Fallback): () => ResolvedDefaults<Own, Fallback>;

package/dist/config/defaults.js

@@ -0,0 +1,45 @@
+import { useConfig } from "./context.js";
+import { computed } from "vue";
+//#region src/config/defaults.ts
+/**
+* 组件默认值：应用级 `createUi({ defaults })`、局部 `<Provider defaults>` 统一改组件的默认外观，
+* 不必每处都写（参考 Ant Design 的 ConfigProvider、MUI 主题的 defaultProps）。
+* 优先级：组件上显式写的 prop > 最近一层 Provider > createUi > 组件自己的默认值。
+*
+*   createUi({ defaults: { Button: { variant: 'outline', size: 'sm' } } })
+*
+* 只收外观类的选项（样式、尺寸、色调）；行为类的（disabled、loading）每处单独决定。
+*/
+/** 合并两层默认值：按组件逐个合并，内层写了的选项覆盖外层 */
+function mergeDefaults(outer, inner) {
+	if (!inner) return outer;
+	const merged = { ...outer };
+	for (const [name, options] of Object.entries(inner)) merged[name] = {
+		...outer[name],
+		...options
+	};
+	return merged;
+}
+/**
+* 组件的外观选项逐项合并：显式写的 prop > 最近一层 Provider > createUi > fallback（组件自己的默认值）。
+* 在 setup 里调用；返回的函数在渲染时调用，读到最新的 prop 与配置（Provider 切换后跟着变）。
+*
+*   const appearance = useDefaults('Card', () => ({ variant, padding }), { variant: 'surface', padding: 'lg' });
+*   const s = recipe(appearance());   // recipe = useRecipe(cardRecipe)：档位交给配方（config/styles.ts）
+*/
+function useDefaults(name, read, fallback) {
+	const config = useConfig();
+	const resolved = computed(() => {
+		const own = read();
+		const provided = config.defaults[name] ?? {};
+		const defaults = fallback ?? {};
+		const merged = {};
+		for (const key of Object.keys(own)) merged[key] = own[key] ?? provided[key] ?? defaults[key];
+		return merged;
+	});
+	return () => resolved.value;
+}
+//#endregion
+export { mergeDefaults, useDefaults };
+
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","names":[],"sources":["../../src/config/defaults.ts"],"sourcesContent":["/**\n * 组件默认值：应用级 `createUi({ defaults })`、局部 `<Provider defaults>` 统一改组件的默认外观，\n * 不必每处都写（参考 Ant Design 的 ConfigProvider、MUI 主题的 defaultProps）。\n * 优先级：组件上显式写的 prop > 最近一层 Provider > createUi > 组件自己的默认值。\n *\n *   createUi({ defaults: { Button: { variant: 'outline', size: 'sm' } } })\n *\n * 只收外观类的选项（样式、尺寸、色调）；行为类的（disabled、loading）每处单独决定。\n */\nimport { computed } from 'vue';\nimport { useConfig } from './context';\nimport type { BadgeOptions } from '../base/badge-styles';\nimport type { AlertOptions } from '../feedback/Alert';\nimport type { EmptyOptions } from '../feedback/Empty';\nimport type { ProgressOptions } from '../feedback/Progress';\nimport type { ResultOptions } from '../feedback/Result';\nimport type { IndicatorOptions } from '../base/Indicator';\nimport type { LinkOptions } from '../base/Link';\nimport type { DialogOptions } from '../overlay/Dialog';\nimport type { DrawerOptions } from '../overlay/Drawer';\nimport type { AvatarOptions } from '../display/Avatar';\nimport type { CardOptions } from '../display/Card';\nimport type { ChoiceOptions } from '../input/choice-styles';\nimport type { ControlOptions } from '../input/control';\nimport type { TabsOptions } from '../navigation/Tabs';\nimport type { DataTableOptions } from '../table/table-styles';\nimport type { ButtonOptions } from '../base/button-core';\n\n/** 可以配置默认值的组件与选项；新组件有外观档位时在这里登记 */\nexport interface ComponentDefaults {\n  /** Button、LinkButton、IconButton、IconLinkButton 共用 */\n  Button?: Partial<Pick<ButtonOptions, 'variant' | 'tone' | 'size' | 'radius'>>;\n  /** Badge、Tag 共用 */\n  Badge?: BadgeOptions;\n  /** Link */\n  Link?: LinkOptions;\n  /** Indicator */\n  Indicator?: IndicatorOptions;\n  /** Alert */\n  Alert?: AlertOptions;\n  /** Progress */\n  Progress?: ProgressOptions;\n  /** Empty */\n  Empty?: EmptyOptions;\n  /** Result */\n  Result?: ResultOptions;\n  /** Card */\n  Card?: CardOptions;\n  /** Dialog、AlertDialog 共用 */\n  Dialog?: DialogOptions;\n  /** Drawer */\n  Drawer?: DrawerOptions;\n  /** Avatar */\n  Avatar?: AvatarOptions;\n  /** Tabs */\n  Tabs?: TabsOptions;\n  /** 输入框：TextField、Textarea、NumberField、Select、Combobox 共用 */\n  Input?: ControlOptions;\n  /** 勾选类控件：Checkbox、RadioGroup、Switch 共用 */\n  Choice?: ChoiceOptions;\n  /** 表格：DataTable、TreeDataTable 共用 */\n  DataTable?: DataTableOptions;\n  /** 静态表格 Table */\n  Table?: DataTableOptions;\n}\n\n/** 合并两层默认值：按组件逐个合并，内层写了的选项覆盖外层 */\nexport function mergeDefaults(\n  outer: ComponentDefaults,\n  inner: ComponentDefaults | undefined,\n): ComponentDefaults {\n  if (!inner) return outer;\n  const merged: Record<string, object | undefined> = { ...outer };\n  for (const [name, options] of Object.entries(inner)) {\n    merged[name] = { ...(outer as Record<string, object | undefined>)[name], ...options };\n  }\n  return merged as ComponentDefaults;\n}\n\n/** useDefaults 合并后的选项：给了 fallback 的项一定有值，其余可能仍是 undefined（如不写时继承字号的 size） */\nexport type ResolvedDefaults<Own, Fallback> = {\n  [K in keyof Own as K extends keyof Fallback ? K : never]-?: Exclude<Own[K], undefined>;\n} & {\n  [K in keyof Own as K extends keyof Fallback ? never : K]: Own[K];\n};\n\n/**\n * 组件的外观选项逐项合并：显式写的 prop > 最近一层 Provider > createUi > fallback（组件自己的默认值）。\n * 在 setup 里调用；返回的函数在渲染时调用，读到最新的 prop 与配置（Provider 切换后跟着变）。\n *\n *   const appearance = useDefaults('Card', () => ({ variant, padding }), { variant: 'surface', padding: 'lg' });\n *   const s = recipe(appearance());   // recipe = useRecipe(cardRecipe)：档位交给配方（config/styles.ts）\n */\nexport function useDefaults<\n  Name extends keyof ComponentDefaults,\n  Own extends NonNullable<ComponentDefaults[Name]>,\n  const Fallback extends { [K in keyof Own]?: Exclude<Own[K], undefined> } = {},\n>(name: Name, read: () => Own, fallback?: Fallback): () => ResolvedDefaults<Own, Fallback> {\n  const config = useConfig();\n  // 缓存合并结果：prop 或配置变了才重新合并，渲染里多次读取都是同一个对象\n  const resolved = computed(() => {\n    const own = read() as Record<string, unknown>;\n    const provided = (config.defaults[name] ?? {}) as Record<string, unknown>;\n    const defaults = (fallback ?? {}) as Record<string, unknown>;\n    const merged: Record<string, unknown> = {};\n    for (const key of Object.keys(own)) merged[key] = own[key] ?? provided[key] ?? defaults[key];\n    return merged as ResolvedDefaults<Own, Fallback>;\n  });\n  return () => resolved.value;\n}\n"],"mappings":";;;;;;;;;;;;;AAmEA,SAAgB,cACd,OACA,OACmB;CACnB,IAAI,CAAC,OAAO,OAAO;CACnB,MAAM,SAA6C,EAAE,GAAG,MAAM;CAC9D,KAAK,MAAM,CAAC,MAAM,YAAY,OAAO,QAAQ,KAAK,GAChD,OAAO,QAAQ;EAAE,GAAI,MAA6C;EAAO,GAAG;CAAQ;CAEtF,OAAO;AACT;;;;;;;;AAgBA,SAAgB,YAId,MAAY,MAAiB,UAA4D;CACzF,MAAM,SAAS,UAAU;CAEzB,MAAM,WAAW,eAAe;EAC9B,MAAM,MAAM,KAAK;EACjB,MAAM,WAAY,OAAO,SAAS,SAAS,CAAC;EAC5C,MAAM,WAAY,YAAY,CAAC;EAC/B,MAAM,SAAkC,CAAC;EACzC,KAAK,MAAM,OAAO,OAAO,KAAK,GAAG,GAAG,OAAO,OAAO,IAAI,QAAQ,SAAS,QAAQ,SAAS;EACxF,OAAO;CACT,CAAC;CACD,aAAa,SAAS;AACxB"}

package/dist/config/lang/en-US.d.ts

@@ -0,0 +1,3 @@
+import type { Lang } from './lang';
+/** English (United States) */
+export declare const enUS: Lang;

package/dist/config/lang/en-US.js

@@ -0,0 +1,386 @@
+import zodMessages from "zod/v4/locales/en.js";
+//#region src/config/lang/en-US.ts
+/** English (United States) */
+var enUS = {
+	code: "en-US",
+	direction: "ltr",
+	calendar: "gregory",
+	currency: "USD",
+	confirm: "OK",
+	cancel: "Cancel",
+	close: "Close",
+	imagePreview: (alt) => `View larger: ${alt}`,
+	imageError: "Image failed to load",
+	lightboxLabel: "Image viewer",
+	lightboxZoomIn: "Zoom in",
+	lightboxZoomOut: "Zoom out",
+	lightboxRotateLeft: "Rotate left",
+	lightboxRotateRight: "Rotate right",
+	lightboxReset: "Reset",
+	lightboxDownload: "Download",
+	lightboxPrevious: "Previous image",
+	lightboxNext: "Next image",
+	lightboxCounter: (index, total) => `${index} of ${total}`,
+	descriptionsCopy: (label) => `Copy ${label}`,
+	fieldCompareHeaders: [
+		"Field",
+		"Before",
+		"After",
+		"Change"
+	],
+	fieldCompareTo: "changed to",
+	fieldCompareNone: "No changes",
+	timelineShowMore: (count) => `Show ${count} more`,
+	timelineShowLess: "Show less",
+	timelineDetails: "Details",
+	mentionsList: "People to mention",
+	mentionsEmpty: "No matching people",
+	checklistStatus: {
+		done: "done",
+		todo: "to do",
+		overdue: "overdue",
+		blocked: "blocked",
+		skipped: "not applicable"
+	},
+	checklistItemState: (label, state) => `${label}: ${state}`,
+	checklistIconsLabel: (parts) => parts.join("; "),
+	checklistSummary: (done, total) => `${done} of ${total} done`,
+	chartExport: "Export",
+	chartExportImage: "Export image (PNG)",
+	chartExportData: "Export data (CSV)",
+	chartExportName: "chart",
+	chartZoom: "Visible range",
+	chartZoomReset: "Show all",
+	chartZoomIn: "Zoom in",
+	chartZoomOut: "Zoom out",
+	chartZoomFit: "Fit to view",
+	chartZoomWheelHint: "Hold Ctrl and scroll to zoom the map",
+	chartSeries: "Series",
+	chartStart: "Start",
+	chartEnd: "End",
+	chartDuration: "Duration",
+	chartToday: "Today",
+	chartDays: (days) => days === 1 ? "1 day" : `${days} days`,
+	sparklineSummary: (count, first, last, min, max) => `${count} values, from ${first} to ${last}, low ${min}, high ${max}`,
+	clear: "Clear",
+	loading: "Loading",
+	remove: "Remove",
+	copy: "Copy",
+	copied: "Copied",
+	emptyValue: "—",
+	formRequired: "Required",
+	formErrorSummary: (count) => count === 1 ? "There is 1 problem" : `There are ${count} problems`,
+	formErrorItem: (label, message) => `${label}: ${message}`,
+	formIssues: zodMessages().localeError,
+	leaveTitle: "Leave this page?",
+	leaveDescription: "You have unsaved changes that will be lost.",
+	leaveConfirm: "Leave",
+	toasterLabel: "Notifications",
+	linkNewWindow: " (opens in a new window)",
+	passwordShow: "Show password",
+	characterCount: (count, max) => max == null ? `${count} characters` : `${count} of ${max} characters`,
+	sliderMin: "Minimum",
+	sliderMax: "Maximum",
+	indicatorCount: (count) => `${count} new`,
+	indicatorDot: "New",
+	avatarMore: (count) => `${count} more`,
+	numberDecrement: "Decrease",
+	numberIncrement: "Increase",
+	comboboxToggle: "Show options",
+	tableSelectAll: "Select all",
+	tableSelectColumn: "Select",
+	tableSelectRow: (row) => `Select row ${row}`,
+	tableResizeColumn: (column) => `Resize column “${column}”`,
+	tableEmpty: "No data",
+	tableSummary: "Total",
+	tableSelectedCount: (count) => `${count} selected`,
+	listResultCount: (count) => count === 1 ? "1 option" : `${count} options`,
+	listLoadFailed: "Failed to load. Try again.",
+	tableClearSelection: "Clear selection",
+	tableDetails: "Details",
+	tableRowDetails: (row) => `Details of ${row}`,
+	tableFilterColumn: (column, active) => `Filter “${column}”${active ? " (filtered)" : ""}`,
+	tableFilterSearch: "Search",
+	tableFilterClear: "Clear filter",
+	tableColumnMenu: (column) => `Actions for column “${column}”`,
+	tableSortAscending: "Sort ascending",
+	tableSortDescending: "Sort descending",
+	tableSortClear: "Clear sort",
+	tableSortPriority: (priority, direction) => `sort ${priority}, ${direction}`,
+	tablePinStart: "Pin to start",
+	tablePinEnd: "Pin to end",
+	tableUnpin: "Unpin",
+	tableMoveBackward: "Move earlier",
+	tableMoveForward: "Move later",
+	tableHideColumn: "Hide column",
+	tableColumnSettings: "Columns",
+	tableColumnSettingsReset: "Reset",
+	chartEmpty: "No data",
+	chartCategory: "Category",
+	chartValue: "Value",
+	chartShare: "Share",
+	chartTotal: "Total",
+	chartFlow: "Flow",
+	chartFlowLabel: (source, target) => `${source} → ${target}`,
+	chartIncrease: "Increase",
+	chartDecrease: "Decrease",
+	chartChange: "Change",
+	chartCumulative: "Cumulative",
+	chartStepRate: "Step conversion",
+	chartOverallRate: "Overall conversion",
+	chartStage: "Stage",
+	chartLink: "Link",
+	chartDegree: (count) => `${count} ${count === 1 ? "link" : "links"}`,
+	treeToggle: (row) => `Children of ${row}`,
+	splitterResize: "Resize panes",
+	splitterCollapse: "Collapse",
+	splitterExpand: "Expand",
+	fileDrop: "Click or drop files here",
+	fileTooLarge: (max) => `File must be at most ${max}`,
+	fileTypeRejected: "This file type is not supported",
+	uploadFailed: "Upload failed",
+	uploadDone: "Uploaded",
+	uploadRetry: (file) => `Retry uploading ${file}`,
+	uploadRemove: (file) => `Remove ${file}`,
+	uploadAddImage: "Add image",
+	uploadPasteHint: "You can also paste images",
+	progressTarget: (value) => `target ${value}`,
+	backToTop: "Back to top",
+	ellipsisExpand: "More",
+	ellipsisCollapse: "Less",
+	ratingStar: (value) => value === 1 ? "1 star" : `${value} stars`,
+	ratingSummary: (value, count) => value == null ? "Not rated" : `${value} out of ${count} stars`,
+	resultStatus: {
+		403: {
+			title: "Access denied",
+			description: "You need more permissions to see this page. Ask an administrator for access."
+		},
+		404: {
+			title: "Page not found",
+			description: "The address may be wrong, or the page has moved."
+		},
+		500: {
+			title: "Something went wrong",
+			description: "The server could not handle the request. Try again later, and contact an administrator if it keeps happening."
+		}
+	},
+	sortableHandle: (item) => `Move ${item}`,
+	sortableInstructions: "Press Space to pick up, use the arrow keys to move, Space again to drop, Escape to cancel",
+	sortableGrabbed: (item, position, total) => `Picked up ${item}, position ${position} of ${total}`,
+	sortableMoved: (item, position, total) => `${item} moved to position ${position} of ${total}`,
+	sortableDropped: (item, position, total) => `Dropped ${item}, position ${position} of ${total}`,
+	sortableCancelled: (item, position) => `Cancelled, ${item} returned to position ${position}`,
+	sortableGroupInstructions: "Press space to pick up, use the up and down arrow keys to move within a group and the left and right arrow keys to change group, press space again to drop, Escape to cancel",
+	sortableGroupGrabbed: (item, group, position) => `Picked up ${item}, position ${position} in ${group}`,
+	sortableOver: (item, group, position, reason) => reason ? `${group}: cannot drop, ${reason}` : `${item} over ${group}, position ${position}, press space to drop`,
+	sortableGroupDropped: (item, group, position) => `Dropped ${item} in ${group}, position ${position}`,
+	sortableGroupCancelled: (item, group, position) => `Cancelled, ${item} returned to ${group}, position ${position}`,
+	sortableRejected: (item, reason) => `Cannot move: ${reason}. ${item} returned`,
+	tourPrevious: "Back",
+	tourNext: "Next",
+	tourFinish: "Done",
+	tourSkip: "Skip",
+	tourProgress: (current, total) => `${current} of ${total}`,
+	selectEmpty: "No options",
+	selectPlaceholder: "Select…",
+	selectSearch: "Search",
+	selectNoMatch: "No matching options",
+	selectCreate: (text) => `Create “${text}”`,
+	selectSummary: (labels) => labels.join(", "),
+	selectMoreTags: (count) => `+${count}`,
+	paginationTotal: (total) => `${total.toLocaleString("en-US")} items`,
+	paginationRange: (from, to, total) => `${from.toLocaleString("en-US")}–${to.toLocaleString("en-US")} of ${total.toLocaleString("en-US")} items`,
+	pagination: "Pagination",
+	pageSizeOption: (size) => `${size} / page`,
+	pageSizeLabel: "Items per page",
+	pageJumpBefore: "Go to",
+	pageJumpAfter: "",
+	pageJumpLabel: "Go to page",
+	contextMenuLabel: "More actions",
+	previousPage: "Previous page",
+	nextPage: "Next page",
+	pageLabel: (page) => `Page ${page}`,
+	treeEmpty: "No data",
+	tabClose: (label) => `Close ${label}`,
+	tabAdd: "New tab",
+	navBarMore: "More",
+	tabList: "All tabs",
+	tabScrollPrevious: "Scroll back",
+	tabScrollNext: "Scroll forward",
+	tabMoved: (label, position, total) => `Moved ${label} to position ${position} of ${total}`,
+	treeNoMatch: "No matching items",
+	treeMoved: (item, parent, position) => parent ? `Moved ${item} into ${parent} at position ${position}` : `Moved ${item} to the top level at position ${position}`,
+	transferSource: "Available",
+	transferTarget: "Selected",
+	transferMoveTo: (title) => `Move to ${title}`,
+	transferSelectAll: (title) => `Select all in ${title}`,
+	transferCount: (checked, total) => `${checked} / ${total}`,
+	transferMoved: (count, title) => `Moved ${count} ${count === 1 ? "item" : "items"} to ${title}`,
+	conditionModes: {
+		all: "All of",
+		any: "Any of",
+		none: "None of",
+		notAll: "Not all of"
+	},
+	conditionMode: "Match",
+	conditionAnd: "and",
+	conditionOr: "or",
+	conditionOperators: {
+		eq: "equals",
+		ne: "does not equal",
+		gt: "greater than",
+		gte: "at least",
+		lt: "less than",
+		lte: "at most",
+		between: "between",
+		in: "is any of",
+		notIn: "is none of",
+		contains: "contains",
+		notContains: "does not contain",
+		startsWith: "starts with",
+		exists: "is not empty",
+		empty: "is empty"
+	},
+	conditionTypeOperators: {
+		date: {
+			eq: "is",
+			gt: "is after",
+			gte: "is on or after",
+			lt: "is before",
+			lte: "is on or before"
+		},
+		select: {
+			eq: "is",
+			ne: "is not"
+		},
+		boolean: { eq: "is" }
+	},
+	conditionTrue: "Yes",
+	conditionFalse: "No",
+	conditionTo: "to",
+	conditionRange: (low, high) => low && high ? `${low} to ${high}` : low ? `${low} or more` : `${high} or less`,
+	conditionValueSeparator: ", ",
+	conditionAndJoiner: ", and ",
+	conditionOrJoiner: ", or ",
+	conditionNotPrefix: "not: ",
+	conditionField: "Field",
+	conditionOperator: "Operator",
+	conditionValue: (field) => `Value of ${field}`,
+	conditionAddRule: "Add condition",
+	conditionAddGroup: "Add group",
+	conditionRemoveRule: "Remove condition",
+	conditionRemoveGroup: "Remove group",
+	conditionEmpty: "No conditions yet",
+	conditionGroup: "Condition group",
+	conditionRule: (index) => `Condition ${index}`,
+	peopleTypes: {
+		user: "Person",
+		department: "Department",
+		position: "Position"
+	},
+	peopleSearch: "Search people, departments, positions",
+	peoplePages: "Browse by",
+	peopleOrg: "Organization",
+	peoplePositions: "Positions",
+	peopleRecent: "Recent",
+	peopleRoot: "All",
+	peopleChildren: "Open",
+	peopleOpen: (name) => `Open ${name}`,
+	peopleCount: (count, max) => max ? `${count} / ${max} selected` : `${count} selected`,
+	peopleSelected: "Selected",
+	peopleRemove: (name) => `Remove ${name}`,
+	peopleSelectAll: "Select all",
+	peopleEmpty: "Nothing to choose here",
+	peopleNoResult: "No matches",
+	peopleNothingSelected: "Nothing selected yet",
+	peoplePlaceholder: "Choose people",
+	breadcrumbs: "Breadcrumb",
+	breadcrumbsExpand: "Show hidden levels",
+	stepState: (state) => ` (${{
+		complete: "completed",
+		upcoming: "not started",
+		error: "error"
+	}[state]})`,
+	calendarPreviousMonth: "Previous month",
+	calendarNextMonth: "Next month",
+	calendarPreviousYear: "Previous year",
+	calendarNextYear: "Next year",
+	calendarYear: (year) => String(year),
+	calendarQuarter: (quarter) => `Q${quarter}`,
+	calendarBoardCount: (count) => `${count} ${count === 1 ? "event" : "events"}`,
+	calendarBoardMore: (count) => `${count} more`,
+	calendarPreviousDecade: "Previous decade",
+	calendarNextDecade: "Next decade",
+	calendarChooseMonth: (current) => `Choose month: ${current}`,
+	calendarChooseYear: (current) => `Choose year: ${current}`,
+	calendarWeek: "Wk",
+	calendarWeekNumber: (week) => `Week ${week}`,
+	calendarToday: (date) => `Today, ${date}`,
+	calendarPickEnd: "Select an end date",
+	datePickerOpen: "Choose date",
+	timePickerOpen: "Choose time",
+	dateRangeStart: "Start date",
+	dateRangeEnd: "End date",
+	dateRangePresets: "Presets",
+	datePickerPresets: "Presets",
+	datePickerThisQuarter: "This quarter",
+	dateRangePreset: {
+		today: "Today",
+		yesterday: "Yesterday",
+		last7Days: "Last 7 days",
+		last30Days: "Last 30 days",
+		thisWeek: "This week",
+		thisMonth: "This month",
+		lastMonth: "Last month",
+		thisYear: "This year"
+	},
+	timePickerNow: "Now",
+	dateFieldEmpty: "Empty",
+	dateFieldPlaceholders: {
+		year: "yyyy",
+		month: "mm",
+		day: "dd",
+		quarter: "q",
+		week: "ww",
+		hour: "––",
+		minute: "––",
+		second: "––",
+		dayPeriod: "AM"
+	},
+	dateFieldPeriodPatterns: {
+		quarter: "Q{quarter} {year}",
+		week: "Week {week}, {year}"
+	},
+	modelViewerLoading: "Loading model",
+	modelViewerError: "Couldn’t load the model",
+	codeExpand: "Show all",
+	codeCollapse: "Show less",
+	headingAnchor: "Link to this section",
+	skipToContent: "Skip to content",
+	tableOfContents: "On this page",
+	drawerResize: "Resize drawer",
+	searchLabel: "Search",
+	searchPlaceholder: "Search docs",
+	searchEmpty: "No results",
+	themeLight: "Light",
+	themeSystem: "System",
+	themeDark: "Dark",
+	themePaper: "Paper",
+	themeMidnight: "Midnight",
+	themeHighContrast: "High contrast",
+	themeOcean: "Ocean",
+	themeForest: "Forest",
+	themeLemon: "Lemon",
+	themeSakura: "Sakura",
+	themeFestive: "Festive",
+	themeCyberpunk: "Cyberpunk",
+	themeCoffee: "Coffee",
+	colorPick: "Pick a color",
+	pagerLabel: "Pagination",
+	pagerPrevious: "Previous",
+	pagerNext: "Next"
+};
+//#endregion
+export { enUS };
+
+//# sourceMappingURL=en-US.js.map