@chenzy-design/svelte 0.1.0

package/dist/config-provider/ConfigProvider.svelte

@@ -0,0 +1,227 @@
+<script lang="ts">
+  import { getContext, setContext, untrack } from 'svelte';
+  import type { Snippet } from 'svelte';
+  import {
+    mergeConfig,
+    DEFAULT_CONFIG,
+    resolveAppliedTheme,
+    resolveReducedMotion,
+    type ConfigInput,
+    type ResolvedConfig,
+    type ConfigTheme,
+    type AppliedTheme,
+    type ConfigDir,
+    type ConfigSize,
+    type ReducedMotionInput,
+  } from '@chenzy-design/core';
+  import { createLocale, type LocaleApi } from '@chenzy-design/locale';
+  import type { Locale } from '@chenzy-design/locale';
+  import { LOCALE_CONTEXT_KEY } from '../locale-provider/context.js';
+  import {
+    CONFIG_CONTEXT_KEY,
+    type ConfigContextValue,
+    type GetPopupContainer,
+    type GetValidateMessages,
+  } from './context.js';
+
+  interface Props {
+    /** 语言包；提供则注入 locale context（复用 LocaleProvider 机制），未提供沿用上层。 */
+    locale?: Locale;
+    /** 主题，undefined 继承父级；dark 在 wrap 根写 data-theme 触发暗色调色板；auto 跟随系统 prefers-color-scheme 实时切 light/dark。 */
+    theme?: ConfigTheme;
+    /** 是否降级动画：true 强制降级、false 强制开启、'auto'（默认）跟随系统 prefers-reduced-motion；为真时写全局标记令库内动画退化。 */
+    reducedMotion?: ReducedMotionInput;
+    /** 文本方向，undefined 继承父级。 */
+    dir?: ConfigDir;
+    /** 默认尺寸，undefined 继承父级。 */
+    size?: ConfigSize;
+    /** 浮层 z-index 基线，undefined 继承父级。 */
+    zIndexBase?: number;
+    /** 是否启用过渡动画，undefined 继承父级。 */
+    transition?: boolean;
+    /** 全局浮层默认挂载容器；浮层组件（Modal/Dropdown 等）未传自身 prop 时回退此值，undefined 继承父级（最终回退 document.body）。 */
+    getPopupContainer?: GetPopupContainer;
+    /** 全局表单校验文案覆盖；按 `Form.*` 键返回模板（支持 {label}/{min}/{max} 插值），仅覆盖列出键、其余回退 locale；undefined 继承父级。 */
+    getValidateMessages?: GetValidateMessages;
+    /** 默认 false：true 时渲染包裹元素（display:contents）建立主题/方向作用域。 */
+    wrap?: boolean;
+    /** wrap 元素标签，默认 'div'；可设 section/article/main 等语义标签。 */
+    as?: string;
+    /** theme 变化通知（受控，不回写）；applied 为 auto 解析后实际落地的 light/dark。 */
+    onThemeChange?: (info: { theme: ConfigTheme; applied: AppliedTheme }) => void;
+    /** reducedMotion 解析结果变化通知（受控，不回写）；reduced=true 表示已降级。 */
+    onReducedMotionChange?: (info: { reducedMotion: ReducedMotionInput; reduced: boolean }) => void;
+    /** locale 变化通知（受控，不回写）。 */
+    onLocaleChange?: (info: { locale: string }) => void;
+    /** dir 变化通知（受控，不回写）。 */
+    onDirChange?: (info: { dir: ConfigDir }) => void;
+    /** 合并后配置变化通知（受控，不回写）。 */
+    onConfigChange?: (info: { config: ResolvedConfig }) => void;
+    children?: Snippet;
+  }
+
+  let {
+    locale,
+    theme,
+    reducedMotion,
+    dir,
+    size,
+    zIndexBase,
+    transition,
+    getPopupContainer,
+    getValidateMessages,
+    wrap = false,
+    as = 'div',
+    onThemeChange,
+    onReducedMotionChange,
+    onLocaleChange,
+    onDirChange,
+    onConfigChange,
+    children,
+  }: Props = $props();
+
+  // 读父级 config（嵌套支持）：init 期调 getContext，无父级用 DEFAULT_CONFIG。
+  const parentCfg = getContext<ConfigContextValue | undefined>(CONFIG_CONTEXT_KEY);
+
+  // exactOptionalPropertyTypes：仅塞非 undefined 字段，避免显式 undefined 报错。
+  const localInput = $derived.by(() => {
+    const o: ConfigInput = {};
+    if (theme !== undefined) o.theme = theme;
+    if (reducedMotion !== undefined) o.reducedMotion = reducedMotion;
+    if (dir !== undefined) o.dir = dir;
+    if (size !== undefined) o.size = size;
+    if (zIndexBase !== undefined) o.zIndexBase = zIndexBase;
+    if (transition !== undefined) o.transition = transition;
+    return o;
+  });
+
+  // 合并：父级（或默认）+ 本地输入（就近 wins、undefined 继承）。
+  const resolved = $derived(mergeConfig(parentCfg?.current ?? DEFAULT_CONFIG, localInput));
+
+  // --- 系统媒体偏好（命令式 matchMedia 监听 + cleanup，红线 #3）---
+  // SSR 安全：window 不存在或不支持 matchMedia 时退化为 false（不暗、不降级）。
+  const mqlSupported =
+    typeof window !== 'undefined' && typeof window.matchMedia === 'function';
+  // $state 持有系统偏好快照；监听器命令式写入，$derived 据此纯函数解析。
+  let systemPrefersDark = $state(
+    mqlSupported && window.matchMedia('(prefers-color-scheme: dark)').matches,
+  );
+  let systemReducedMotion = $state(
+    mqlSupported && window.matchMedia('(prefers-reduced-motion: reduce)').matches,
+  );
+
+  // theme=auto 解析为实际 light/dark（纯函数，红线 #2）。
+  const appliedTheme = $derived(resolveAppliedTheme(resolved.theme, systemPrefersDark));
+  // reducedMotion 最终是否降级（纯函数，红线 #2）。
+  const reduced = $derived(resolveReducedMotion(resolved.reducedMotion, systemReducedMotion));
+
+  // 仅在确有依赖系统态时才挂监听，避免无谓订阅。
+  const needsColorScheme = $derived(resolved.theme === 'auto');
+  const needsMotionQuery = $derived(resolved.reducedMotion === 'auto');
+
+  // prefers-color-scheme 监听：仅 theme=auto 时订阅，系统切换实时更新（红线 #3）。
+  $effect(() => {
+    if (!mqlSupported || !needsColorScheme) return;
+    const mql = window.matchMedia('(prefers-color-scheme: dark)');
+    systemPrefersDark = mql.matches;
+    const onChange = (e: MediaQueryListEvent): void => {
+      systemPrefersDark = e.matches;
+    };
+    mql.addEventListener('change', onChange);
+    return () => mql.removeEventListener('change', onChange);
+  });
+
+  // prefers-reduced-motion 监听：仅 reducedMotion=auto 时订阅（红线 #3）。
+  $effect(() => {
+    if (!mqlSupported || !needsMotionQuery) return;
+    const mql = window.matchMedia('(prefers-reduced-motion: reduce)');
+    systemReducedMotion = mql.matches;
+    const onChange = (e: MediaQueryListEvent): void => {
+      systemReducedMotion = e.matches;
+    };
+    mql.addEventListener('change', onChange);
+    return () => mql.removeEventListener('change', onChange);
+  });
+
+  // 全局降级标记：renderless（wrap=false）时命令式写到 documentElement（红线 #3），
+  // 令全库 reduced-motion 退化生效；wrap=true 时改写在包裹 div 上（见模板）。
+  // 仅显式 reducedMotion 才接管全局标记（'auto' 沿用系统 CSS @media，避免误置）。
+  $effect(() => {
+    if (wrap || typeof document === 'undefined') return;
+    if (resolved.reducedMotion === 'auto') return; // auto 留给原生 @media
+    const root = document.documentElement;
+    if (reduced) root.setAttribute('data-reduced-motion', '');
+    else root.removeAttribute('data-reduced-motion');
+    return () => root.removeAttribute('data-reduced-motion');
+  });
+
+  // 函数型配置（getPopupContainer/getValidateMessages）不参与 core 的纯配置合并，
+  // 在此就近合并：本地提供则 wins，未提供继承父级（红线 #2 派生、不回写 props）。
+  const resolvedPopupContainer = $derived(getPopupContainer ?? parentCfg?.getPopupContainer);
+  const resolvedValidateMessages = $derived(
+    getValidateMessages ?? parentCfg?.getValidateMessages,
+  );
+
+  // 注入 config context：getter 保证后代读到最新合并结果。红线：受控不回写 props。
+  setContext(CONFIG_CONTEXT_KEY, {
+    get current(): ResolvedConfig {
+      return resolved;
+    },
+    get getPopupContainer(): GetPopupContainer | undefined {
+      return resolvedPopupContainer;
+    },
+    get getValidateMessages(): GetValidateMessages | undefined {
+      return resolvedValidateMessages;
+    },
+  } satisfies ConfigContextValue);
+
+  // 注入 locale context（仅当 locale prop 提供时）；direction 跟随合并后的 dir。
+  const localeApi = $derived(locale ? createLocale({ locale, direction: resolved.dir }) : null);
+  // init 期捕获初始值决定是否注入 locale context（setContext 必须同步执行）；
+  // 用 untrack 显式取初始快照，避免 state_referenced_locally 误报。
+  const hasLocale = untrack(() => locale !== undefined);
+  if (hasLocale) {
+    setContext(LOCALE_CONTEXT_KEY, {
+      get current(): LocaleApi | null {
+        return localeApi;
+      },
+    });
+  }
+
+  // 红线：$effect 只调通知回调，无 DOM/几何。首次也触发可接受。
+  $effect(() => {
+    onThemeChange?.({ theme: resolved.theme, applied: appliedTheme });
+  });
+  $effect(() => {
+    onReducedMotionChange?.({ reducedMotion: resolved.reducedMotion, reduced });
+  });
+  $effect(() => {
+    onDirChange?.({ dir: resolved.dir });
+  });
+  $effect(() => {
+    onConfigChange?.({ config: resolved });
+  });
+  $effect(() => {
+    if (localeApi) onLocaleChange?.({ locale: localeApi.code });
+  });
+</script>
+
+{#if wrap}
+  <svelte:element
+    this={as}
+    class="cd-config-provider cd-config-provider--{resolved.size}"
+    data-theme={appliedTheme === 'dark' ? 'dark' : undefined}
+    data-reduced-motion={resolved.reducedMotion !== 'auto' && reduced ? '' : undefined}
+    dir={resolved.dir}
+  >
+    {@render children?.()}
+  </svelte:element>
+{:else}
+  {@render children?.()}
+{/if}
+
+<style>
+  .cd-config-provider {
+    display: contents;
+  }
+</style>

package/dist/config-provider/ConfigProvider.svelte.d.ts

@@ -0,0 +1,55 @@
+import type { Snippet } from 'svelte';
+import { type ResolvedConfig, type ConfigTheme, type AppliedTheme, type ConfigDir, type ConfigSize, type ReducedMotionInput } from '@chenzy-design/core';
+import type { Locale } from '@chenzy-design/locale';
+import { type GetPopupContainer, type GetValidateMessages } from './context.js';
+interface Props {
+    /** 语言包；提供则注入 locale context（复用 LocaleProvider 机制），未提供沿用上层。 */
+    locale?: Locale;
+    /** 主题，undefined 继承父级；dark 在 wrap 根写 data-theme 触发暗色调色板；auto 跟随系统 prefers-color-scheme 实时切 light/dark。 */
+    theme?: ConfigTheme;
+    /** 是否降级动画：true 强制降级、false 强制开启、'auto'（默认）跟随系统 prefers-reduced-motion；为真时写全局标记令库内动画退化。 */
+    reducedMotion?: ReducedMotionInput;
+    /** 文本方向，undefined 继承父级。 */
+    dir?: ConfigDir;
+    /** 默认尺寸，undefined 继承父级。 */
+    size?: ConfigSize;
+    /** 浮层 z-index 基线，undefined 继承父级。 */
+    zIndexBase?: number;
+    /** 是否启用过渡动画，undefined 继承父级。 */
+    transition?: boolean;
+    /** 全局浮层默认挂载容器；浮层组件（Modal/Dropdown 等）未传自身 prop 时回退此值，undefined 继承父级（最终回退 document.body）。 */
+    getPopupContainer?: GetPopupContainer;
+    /** 全局表单校验文案覆盖；按 `Form.*` 键返回模板（支持 {label}/{min}/{max} 插值），仅覆盖列出键、其余回退 locale；undefined 继承父级。 */
+    getValidateMessages?: GetValidateMessages;
+    /** 默认 false：true 时渲染包裹元素（display:contents）建立主题/方向作用域。 */
+    wrap?: boolean;
+    /** wrap 元素标签，默认 'div'；可设 section/article/main 等语义标签。 */
+    as?: string;
+    /** theme 变化通知（受控，不回写）；applied 为 auto 解析后实际落地的 light/dark。 */
+    onThemeChange?: (info: {
+        theme: ConfigTheme;
+        applied: AppliedTheme;
+    }) => void;
+    /** reducedMotion 解析结果变化通知（受控，不回写）；reduced=true 表示已降级。 */
+    onReducedMotionChange?: (info: {
+        reducedMotion: ReducedMotionInput;
+        reduced: boolean;
+    }) => void;
+    /** locale 变化通知（受控，不回写）。 */
+    onLocaleChange?: (info: {
+        locale: string;
+    }) => void;
+    /** dir 变化通知（受控，不回写）。 */
+    onDirChange?: (info: {
+        dir: ConfigDir;
+    }) => void;
+    /** 合并后配置变化通知（受控，不回写）。 */
+    onConfigChange?: (info: {
+        config: ResolvedConfig;
+    }) => void;
+    children?: Snippet;
+}
+declare const ConfigProvider: import("svelte").Component<Props, {}, "">;
+type ConfigProvider = ReturnType<typeof ConfigProvider>;
+export default ConfigProvider;
+//# sourceMappingURL=ConfigProvider.svelte.d.ts.map

package/dist/config-provider/ConfigProvider.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigProvider.svelte.d.ts","sourceRoot":"","sources":["../../src/config-provider/ConfigProvider.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAMH,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAGH,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAC;AAGtB,UAAU,KAAK;IACb,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yGAAyG;IACzG,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,yFAAyF;IACzF,aAAa,CAAC,EAAE,kBAAkB,CAAC;IACnC,2BAA2B;IAC3B,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,2BAA2B;IAC3B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2FAA2F;IAC3F,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,gGAAgG;IAChG,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IAC1C,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wDAAwD;IACxD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,6DAA6D;IAC7D,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,WAAW,CAAC;QAAC,OAAO,EAAE,YAAY,CAAA;KAAE,KAAK,IAAI,CAAC;IAC9E,yDAAyD;IACzD,qBAAqB,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,aAAa,EAAE,kBAAkB,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAChG,2BAA2B;IAC3B,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACpD,wBAAwB;IACxB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,SAAS,CAAA;KAAE,KAAK,IAAI,CAAC;IACjD,yBAAyB;IACzB,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,cAAc,CAAA;KAAE,KAAK,IAAI,CAAC;IAC5D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAyKH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/config-provider/context.d.ts

@@ -0,0 +1,26 @@
+import type { ResolvedConfig } from '@chenzy-design/core';
+/** 全局浮层挂载容器解析器：返回浮层应 portal 进的元素。 */
+export type GetPopupContainer = () => HTMLElement | null | undefined;
+/**
+ * 全局表单校验文案覆盖：按 `Form.*` 键返回模板字符串（支持 {label}/{min}/{max} 等
+ * 占位符插值）。仅覆盖列出的键，未列出的回退到 locale 内置文案。
+ */
+export type ValidateMessages = Record<string, string>;
+export type GetValidateMessages = () => ValidateMessages;
+/**
+ * config context：下发合并后的全局配置。
+ *
+ * `current` 是可序列化的纯配置（来自 core 的 mergeConfig）；而函数型配置
+ * （getPopupContainer / getValidateMessages）不参与 core 合并，单独挂在 context
+ * 上，并在嵌套时由 ConfigProvider 自行做「就近 wins、未提供继承父级」合并。
+ */
+export type ConfigContextValue = {
+    readonly current: ResolvedConfig;
+    /** 全局浮层默认容器；未配置为 undefined（浮层组件回退 document.body）。 */
+    readonly getPopupContainer?: GetPopupContainer | undefined;
+    /** 全局校验文案覆盖；未配置为 undefined（回退 locale 内置文案）。 */
+    readonly getValidateMessages?: GetValidateMessages | undefined;
+};
+/** config context：下发合并后的全局配置 */
+export declare const CONFIG_CONTEXT_KEY: unique symbol;
+//# sourceMappingURL=context.d.ts.map

package/dist/config-provider/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/config-provider/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,qCAAqC;AACrC,MAAM,MAAM,iBAAiB,GAAG,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACtD,MAAM,MAAM,mBAAmB,GAAG,MAAM,gBAAgB,CAAC;AAEzD;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,qDAAqD;IACrD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC3D,+CAA+C;IAC/C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;CAChE,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,kBAAkB,eAAsB,CAAC"}

package/dist/config-provider/context.js

@@ -0,0 +1,2 @@
+/** config context：下发合并后的全局配置 */
+export const CONFIG_CONTEXT_KEY = Symbol('cd-config');

package/dist/config-provider/index.d.ts

@@ -0,0 +1,24 @@
+import { type GetPopupContainer, type GetValidateMessages } from './context.js';
+import { type ResolvedConfig } from '@chenzy-design/core';
+export { default as ConfigProvider } from './ConfigProvider.svelte';
+export { CONFIG_CONTEXT_KEY, type ConfigContextValue, type GetPopupContainer, type GetValidateMessages, type ValidateMessages, } from './context.js';
+export { meta as configProviderMeta } from './meta.js';
+/**
+ * 读取最近 ConfigProvider 注入的合并后配置（无 Provider 时返回 DEFAULT_CONFIG）。
+ * 约束：getContext 只能在组件初始化期调用，故此 helper 必须在消费组件的
+ * `<script>` 顶层（初始化期）调用。
+ */
+export declare function getConfigContext(): ResolvedConfig;
+/**
+ * 读取全局浮层默认容器解析器（无配置时返回 undefined，调用方回退 document.body）。
+ * 浮层组件（Modal/Dropdown/Popover/Tooltip/Select 等）应把自身 getContainer/
+ * getPopupContainer prop 作为优先，仅在未传时回退到这里的全局默认。
+ * 约束：须在消费组件 `<script>` 顶层（初始化期）调用。
+ */
+export declare function getGlobalPopupContainer(): GetPopupContainer | undefined;
+/**
+ * 读取全局校验文案覆盖（无配置时返回 undefined，Form 回退 locale 内置文案）。
+ * 约束：须在消费组件 `<script>` 顶层（初始化期）调用。
+ */
+export declare function getGlobalValidateMessages(): GetValidateMessages | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/config-provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config-provider/index.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EACL,kBAAkB,EAClB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,IAAI,IAAI,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAGjD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,GAAG,SAAS,CAGvE;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,mBAAmB,GAAG,SAAS,CAG3E"}

package/dist/config-provider/index.js

@@ -0,0 +1,33 @@
+import { getContext } from 'svelte';
+import { CONFIG_CONTEXT_KEY, } from './context.js';
+import { DEFAULT_CONFIG } from '@chenzy-design/core';
+export { default as ConfigProvider } from './ConfigProvider.svelte';
+export { CONFIG_CONTEXT_KEY, } from './context.js';
+export { meta as configProviderMeta } from './meta.js';
+/**
+ * 读取最近 ConfigProvider 注入的合并后配置（无 Provider 时返回 DEFAULT_CONFIG）。
+ * 约束：getContext 只能在组件初始化期调用，故此 helper 必须在消费组件的
+ * `<script>` 顶层（初始化期）调用。
+ */
+export function getConfigContext() {
+    const ctx = getContext(CONFIG_CONTEXT_KEY);
+    return ctx?.current ?? DEFAULT_CONFIG;
+}
+/**
+ * 读取全局浮层默认容器解析器（无配置时返回 undefined，调用方回退 document.body）。
+ * 浮层组件（Modal/Dropdown/Popover/Tooltip/Select 等）应把自身 getContainer/
+ * getPopupContainer prop 作为优先，仅在未传时回退到这里的全局默认。
+ * 约束：须在消费组件 `<script>` 顶层（初始化期）调用。
+ */
+export function getGlobalPopupContainer() {
+    const ctx = getContext(CONFIG_CONTEXT_KEY);
+    return ctx?.getPopupContainer;
+}
+/**
+ * 读取全局校验文案覆盖（无配置时返回 undefined，Form 回退 locale 内置文案）。
+ * 约束：须在消费组件 `<script>` 顶层（初始化期）调用。
+ */
+export function getGlobalValidateMessages() {
+    const ctx = getContext(CONFIG_CONTEXT_KEY);
+    return ctx?.getValidateMessages;
+}

package/dist/config-provider/meta.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * ConfigProvider — see specs/components/other/ConfigProvider.spec.md
+ */
+export declare const meta: {
+    readonly name: "ConfigProvider";
+    readonly category: "other";
+    readonly renderless: true;
+    readonly description: "全局配置总入口，通过 setContext 注入 locale/theme/dir/size/zIndexBase/transition/reducedMotion 等配置 context 供子树继承；嵌套时浅合并（undefined 继承、就近 wins）；theme=\"dark\" 在 wrap 根写 data-theme 触发 tokens 暗色调色板，theme=\"auto\" 经命令式 matchMedia 监听 prefers-color-scheme 实时解析 light/dark（系统切换自动响应、带 cleanup）；reducedMotion(boolean|\"auto\") 控制动画降级，显式开启时写全局标记（wrap 时在包裹 div、renderless 时命令式写 documentElement 的 data-reduced-motion）令依赖 motion-duration token 的动画退化，\"auto\" 沿用系统原生 @media；wrap=true 渲染 display:contents 包裹元素建立独立主题/方向作用域，默认 wrap=false renderless 无 DOM；locale 维度复用 LocaleProvider 的 createLocale + LOCALE_CONTEXT_KEY 机制；getPopupContainer 经 context 暴露全局浮层默认容器供浮层组件（Modal/Dropdown 等）在自身 prop 未传时回退；getValidateMessages 经 context 暴露全局表单校验文案覆盖供 Form 在 locale 内置文案之上按 Form.* 键覆盖（支持插值）；wrap 时 as 可自定义包裹元素标签（section/article/main 等，默认 div）。函数型配置（getPopupContainer/getValidateMessages）不参与 core 纯配置合并，由 ConfigProvider 在 context 层就近合并（未提供继承父级）。";
+    readonly exports: readonly ["ConfigProvider"];
+    readonly props: readonly [{
+        readonly name: "locale";
+        readonly type: "Locale";
+        readonly default: "undefined";
+        readonly desc: "语言包对象；提供则注入 locale context（复用 LocaleProvider 机制），未提供则沿用上层";
+    }, {
+        readonly name: "theme";
+        readonly type: "'light'|'dark'|'auto'";
+        readonly default: "undefined";
+        readonly desc: "主题，undefined 继承父级；dark 在 wrap 根写 data-theme 触发暗色调色板；auto 跟随系统 prefers-color-scheme 实时切 light/dark";
+    }, {
+        readonly name: "reducedMotion";
+        readonly type: "boolean|'auto'";
+        readonly default: "'auto'";
+        readonly desc: "动画降级开关，undefined 继承父级（默认 auto）；true 强制降级、false 强制开启、auto 跟随系统 prefers-reduced-motion；显式开启时写全局 data-reduced-motion 标记令动画退化";
+    }, {
+        readonly name: "dir";
+        readonly type: "'ltr'|'rtl'";
+        readonly default: "undefined";
+        readonly desc: "文本方向，undefined 继承父级";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "undefined";
+        readonly desc: "默认尺寸，undefined 继承父级";
+    }, {
+        readonly name: "zIndexBase";
+        readonly type: "number";
+        readonly default: "undefined";
+        readonly desc: "浮层 z-index 基线，undefined 继承父级（DEFAULT 1000）";
+    }, {
+        readonly name: "transition";
+        readonly type: "boolean";
+        readonly default: "undefined";
+        readonly desc: "是否启用过渡动画，undefined 继承父级";
+    }, {
+        readonly name: "getPopupContainer";
+        readonly type: "() => HTMLElement | null | undefined";
+        readonly default: "undefined";
+        readonly desc: "全局浮层默认挂载容器；经 context 暴露给浮层组件（Modal/Dropdown 等），其自身 getContainer/getPopupContainer prop 优先，未传时回退此值（最终回退 document.body）；undefined 继承父级";
+    }, {
+        readonly name: "getValidateMessages";
+        readonly type: "() => Record<string, string>";
+        readonly default: "undefined";
+        readonly desc: "全局表单校验文案覆盖；按 Form.* 键返回模板字符串（支持 {label}/{min}/{max} 占位符插值），仅覆盖列出的键、其余回退 locale 内置文案；经 context 暴露给 Form；undefined 继承父级";
+    }, {
+        readonly name: "wrap";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "true 时渲染 display:contents 包裹元素，建立主题/方向作用域；false 为 renderless 无 DOM";
+    }, {
+        readonly name: "as";
+        readonly type: "string";
+        readonly default: "'div'";
+        readonly desc: "wrap=true 时包裹元素的标签，可设 section/article/main 等语义标签；wrap=false 时无效";
+    }];
+    readonly events: readonly [{
+        readonly name: "onThemeChange";
+        readonly desc: "theme 变化时通知（受控，不回写）；info.applied 为 auto 解析后实际落地的 light/dark";
+    }, {
+        readonly name: "onReducedMotionChange";
+        readonly desc: "reducedMotion 解析结果变化时通知（受控，不回写）；info.reduced=true 表示已降级";
+    }, {
+        readonly name: "onLocaleChange";
+        readonly desc: "locale 变化时通知（受控，不回写）";
+    }, {
+        readonly name: "onDirChange";
+        readonly desc: "dir 变化时通知（受控，不回写）";
+    }, {
+        readonly name: "onConfigChange";
+        readonly desc: "合并后配置变化时通知（受控，不回写）";
+    }];
+    readonly slots: readonly [{
+        readonly name: "children";
+        readonly desc: "受配置作用域覆盖的后代内容";
+    }];
+    readonly a11y: {
+        readonly hasRole: false;
+        readonly note: "无 role；wrap div 用 display:contents 不生成盒子、不打断 a11y 树；dir 属性写入供 RTL 辅助技术读取；推荐宿主同步 html lang/dir。";
+    };
+    readonly tokens: readonly [];
+    readonly responsive: false;
+    readonly examples: readonly [{
+        readonly title: "应用根配置";
+        readonly code: "<ConfigProvider {locale} theme=\"light\" dir=\"ltr\">{@render app()}</ConfigProvider>";
+    }, {
+        readonly title: "局部暗色覆盖";
+        readonly code: "<ConfigProvider wrap theme=\"dark\">{@render panel()}</ConfigProvider>";
+    }, {
+        readonly title: "跟随系统主题（auto）";
+        readonly code: "<ConfigProvider wrap theme=\"auto\">{@render app()}</ConfigProvider>";
+    }, {
+        readonly title: "强制降级动画";
+        readonly code: "<ConfigProvider reducedMotion>{@render app()}</ConfigProvider>";
+    }, {
+        readonly title: "嵌套 dir 覆盖";
+        readonly code: "<ConfigProvider dir=\"ltr\"><ConfigProvider wrap dir=\"rtl\">{@render rtlSection()}</ConfigProvider></ConfigProvider>";
+    }, {
+        readonly title: "全局浮层容器";
+        readonly code: "<ConfigProvider getPopupContainer={() => document.getElementById(\"app\")!}>{@render app()}</ConfigProvider>";
+    }, {
+        readonly title: "全局校验文案覆盖";
+        readonly code: "<ConfigProvider getValidateMessages={() => ({ \"Form.required\": \"{label}不能为空\" })}>{@render form()}</ConfigProvider>";
+    }, {
+        readonly title: "自定义 wrap 标签";
+        readonly code: "<ConfigProvider wrap as=\"section\" theme=\"dark\">{@render panel()}</ConfigProvider>";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/config-provider/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/config-provider/meta.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2HP,CAAC"}

package/dist/config-provider/meta.js

@@ -0,0 +1,127 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * ConfigProvider — see specs/components/other/ConfigProvider.spec.md
+ */
+export const meta = {
+    name: 'ConfigProvider',
+    category: 'other',
+    renderless: true,
+    description: '全局配置总入口，通过 setContext 注入 locale/theme/dir/size/zIndexBase/transition/reducedMotion 等配置 context 供子树继承；嵌套时浅合并（undefined 继承、就近 wins）；theme="dark" 在 wrap 根写 data-theme 触发 tokens 暗色调色板，theme="auto" 经命令式 matchMedia 监听 prefers-color-scheme 实时解析 light/dark（系统切换自动响应、带 cleanup）；reducedMotion(boolean|"auto") 控制动画降级，显式开启时写全局标记（wrap 时在包裹 div、renderless 时命令式写 documentElement 的 data-reduced-motion）令依赖 motion-duration token 的动画退化，"auto" 沿用系统原生 @media；wrap=true 渲染 display:contents 包裹元素建立独立主题/方向作用域，默认 wrap=false renderless 无 DOM；locale 维度复用 LocaleProvider 的 createLocale + LOCALE_CONTEXT_KEY 机制；getPopupContainer 经 context 暴露全局浮层默认容器供浮层组件（Modal/Dropdown 等）在自身 prop 未传时回退；getValidateMessages 经 context 暴露全局表单校验文案覆盖供 Form 在 locale 内置文案之上按 Form.* 键覆盖（支持插值）；wrap 时 as 可自定义包裹元素标签（section/article/main 等，默认 div）。函数型配置（getPopupContainer/getValidateMessages）不参与 core 纯配置合并，由 ConfigProvider 在 context 层就近合并（未提供继承父级）。',
+    exports: ['ConfigProvider'],
+    props: [
+        {
+            name: 'locale',
+            type: 'Locale',
+            default: 'undefined',
+            desc: '语言包对象；提供则注入 locale context（复用 LocaleProvider 机制），未提供则沿用上层',
+        },
+        {
+            name: 'theme',
+            type: "'light'|'dark'|'auto'",
+            default: 'undefined',
+            desc: '主题，undefined 继承父级；dark 在 wrap 根写 data-theme 触发暗色调色板；auto 跟随系统 prefers-color-scheme 实时切 light/dark',
+        },
+        {
+            name: 'reducedMotion',
+            type: "boolean|'auto'",
+            default: "'auto'",
+            desc: '动画降级开关，undefined 继承父级（默认 auto）；true 强制降级、false 强制开启、auto 跟随系统 prefers-reduced-motion；显式开启时写全局 data-reduced-motion 标记令动画退化',
+        },
+        {
+            name: 'dir',
+            type: "'ltr'|'rtl'",
+            default: 'undefined',
+            desc: '文本方向，undefined 继承父级',
+        },
+        {
+            name: 'size',
+            type: "'small'|'default'|'large'",
+            default: 'undefined',
+            desc: '默认尺寸，undefined 继承父级',
+        },
+        {
+            name: 'zIndexBase',
+            type: 'number',
+            default: 'undefined',
+            desc: '浮层 z-index 基线，undefined 继承父级（DEFAULT 1000）',
+        },
+        {
+            name: 'transition',
+            type: 'boolean',
+            default: 'undefined',
+            desc: '是否启用过渡动画，undefined 继承父级',
+        },
+        {
+            name: 'getPopupContainer',
+            type: '() => HTMLElement | null | undefined',
+            default: 'undefined',
+            desc: '全局浮层默认挂载容器；经 context 暴露给浮层组件（Modal/Dropdown 等），其自身 getContainer/getPopupContainer prop 优先，未传时回退此值（最终回退 document.body）；undefined 继承父级',
+        },
+        {
+            name: 'getValidateMessages',
+            type: '() => Record<string, string>',
+            default: 'undefined',
+            desc: '全局表单校验文案覆盖；按 Form.* 键返回模板字符串（支持 {label}/{min}/{max} 占位符插值），仅覆盖列出的键、其余回退 locale 内置文案；经 context 暴露给 Form；undefined 继承父级',
+        },
+        {
+            name: 'wrap',
+            type: 'boolean',
+            default: 'false',
+            desc: 'true 时渲染 display:contents 包裹元素，建立主题/方向作用域；false 为 renderless 无 DOM',
+        },
+        {
+            name: 'as',
+            type: 'string',
+            default: "'div'",
+            desc: 'wrap=true 时包裹元素的标签，可设 section/article/main 等语义标签；wrap=false 时无效',
+        },
+    ],
+    events: [
+        { name: 'onThemeChange', desc: 'theme 变化时通知（受控，不回写）；info.applied 为 auto 解析后实际落地的 light/dark' },
+        { name: 'onReducedMotionChange', desc: 'reducedMotion 解析结果变化时通知（受控，不回写）；info.reduced=true 表示已降级' },
+        { name: 'onLocaleChange', desc: 'locale 变化时通知（受控，不回写）' },
+        { name: 'onDirChange', desc: 'dir 变化时通知（受控，不回写）' },
+        { name: 'onConfigChange', desc: '合并后配置变化时通知（受控，不回写）' },
+    ],
+    slots: [{ name: 'children', desc: '受配置作用域覆盖的后代内容' }],
+    a11y: {
+        hasRole: false,
+        note: '无 role；wrap div 用 display:contents 不生成盒子、不打断 a11y 树；dir 属性写入供 RTL 辅助技术读取；推荐宿主同步 html lang/dir。',
+    },
+    tokens: [],
+    responsive: false,
+    examples: [
+        {
+            title: '应用根配置',
+            code: '<ConfigProvider {locale} theme="light" dir="ltr">{@render app()}</ConfigProvider>',
+        },
+        {
+            title: '局部暗色覆盖',
+            code: '<ConfigProvider wrap theme="dark">{@render panel()}</ConfigProvider>',
+        },
+        {
+            title: '跟随系统主题（auto）',
+            code: '<ConfigProvider wrap theme="auto">{@render app()}</ConfigProvider>',
+        },
+        {
+            title: '强制降级动画',
+            code: '<ConfigProvider reducedMotion>{@render app()}</ConfigProvider>',
+        },
+        {
+            title: '嵌套 dir 覆盖',
+            code: '<ConfigProvider dir="ltr"><ConfigProvider wrap dir="rtl">{@render rtlSection()}</ConfigProvider></ConfigProvider>',
+        },
+        {
+            title: '全局浮层容器',
+            code: '<ConfigProvider getPopupContainer={() => document.getElementById("app")!}>{@render app()}</ConfigProvider>',
+        },
+        {
+            title: '全局校验文案覆盖',
+            code: '<ConfigProvider getValidateMessages={() => ({ "Form.required": "{label}不能为空" })}>{@render form()}</ConfigProvider>',
+        },
+        {
+            title: '自定义 wrap 标签',
+            code: '<ConfigProvider wrap as="section" theme="dark">{@render panel()}</ConfigProvider>',
+        },
+    ],
+};

package/dist/date-picker/DatePicker.a11y.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DatePicker.a11y.test.d.ts.map

package/dist/date-picker/DatePicker.a11y.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DatePicker.a11y.test.d.ts","sourceRoot":"","sources":["../../src/date-picker/DatePicker.a11y.test.ts"],"names":[],"mappings":""}