@chenzy-design/svelte 0.1.0 → 0.2.1

package/src/color-picker/ColorPickerKbdFixture.svelte

@@ -1,25 +0,0 @@
-<!--
-  仅供 ColorPicker.kbd.test.ts（browser project）使用的焦点陷阱 e2e 夹具。
-  ColorPicker 自带 trigger 按钮（aria-haspopup=dialog）；open 受控，点击 trigger 切换。
-  浮层「非 portal」——面板渲染在 .cd-color-picker 根容器内（相对定位），
-  故测试在 fixture container 范围内查 [role=dialog]，不在 document 查。
-  验证：打开后焦点进入面板内首控件、Tab 困在面板内循环、Esc 关闭后焦点归还 trigger。
-  alpha + presets 提供足量可聚焦点测 Tab 循环。
--->
-<script lang="ts">
-  import { LocaleProvider } from '../locale-provider/index.js';
-  import ColorPicker from './ColorPicker.svelte';
-
-  let open = $state(false);
-  const presets = ['#ff0000', '#00ff00', '#0000ff'];
-</script>
-
-<LocaleProvider locale="en_US">
-  <ColorPicker
-    {open}
-    value="#3366ff"
-    {presets}
-    ariaLabel="Pick color"
-    onOpenChange={(v) => (open = v)}
-  />
-</LocaleProvider>

package/src/color-picker/index.ts

@@ -1,2 +0,0 @@
-export { default as ColorPicker } from './ColorPicker.svelte';
-export { meta as colorPickerMeta } from './meta.js';

package/src/color-picker/meta.ts

@@ -1,47 +0,0 @@
-/**
- * Machine-readable component metadata for AI/docs consumption.
- * See specs/00-foundation/ai-friendly.spec.md.
- */
-export const meta = {
-  name: 'ColorPicker',
-  category: 'input',
-  description:
-    '颜色选择器：trigger 触发浮层面板（或 inline 内联），含 saturation 方块 + hue 条 + alpha 条 + 可切换格式（hex/rgb/hsv/hsl）的输入 + presets，对外以 hex 字符串通信。',
-  props: [
-    { name: 'value', type: 'string', default: 'undefined' },
-    { name: 'defaultValue', type: 'string', default: "'#000000'" },
-    { name: 'alpha', type: 'boolean', default: 'true' },
-    { name: 'open', type: 'boolean', default: 'undefined' },
-    { name: 'defaultOpen', type: 'boolean', default: 'false' },
-    { name: 'presets', type: 'string[]', default: '[]' },
-    { name: 'size', type: "'small'|'default'|'large'", default: 'default' },
-    { name: 'status', type: "'default'|'warning'|'error'", default: 'default', desc: '校验态，仅影响 trigger / inline 面板边框色' },
-    { name: 'disabled', type: 'boolean', default: 'false' },
-    { name: 'outputUppercase', type: 'boolean', default: 'true' },
-    { name: 'format', type: "'hex'|'rgb'|'hsv'|'hsl'", default: 'undefined', desc: '受控：面板内显示/编辑的颜色格式（对外 onChange 仍为 hex）' },
-    { name: 'defaultFormat', type: "'hex'|'rgb'|'hsv'|'hsl'", default: "'hex'", desc: '非受控初始格式' },
-    { name: 'showFormatToggle', type: 'boolean', default: 'true', desc: '面板内显示格式切换下拉' },
-    { name: 'inline', type: 'boolean', default: 'false', desc: '内联渲染面板，不使用 trigger 浮层' },
-    { name: 'eyeDropper', type: 'boolean', default: 'true', desc: '支持 EyeDropper 时显示吸管按钮（降级隐藏）' },
-    { name: 'recentColors', type: 'boolean', default: 'false', desc: '显示最近使用颜色行' },
-    { name: 'recentMax', type: 'number', default: '8', desc: '最近颜色上限' },
-    { name: 'onChange', type: '(hex: string) => void', default: 'undefined' },
-    { name: 'onOpenChange', type: '(open: boolean) => void', default: 'undefined' },
-    { name: 'onFormatChange', type: "(format: 'hex'|'rgb'|'hsv'|'hsl') => void", default: 'undefined' },
-    { name: 'ariaLabel', type: 'string', default: 'undefined' },
-  ],
-  a11y: {
-    role: 'dialog',
-    notes: [
-      'trigger 含 aria-haspopup=dialog / aria-expanded',
-      '浮层 role=dialog，打开经 useFocusTrap 陷入焦点、关闭归还 trigger',
-      'saturation / hue / alpha handle 为 role=slider，含 aria-label 与 aria-valuenow',
-      'hue / alpha / saturation 支持方向键微调；Home/End 跳极值；RTL 下水平方向键语义镜像',
-      'presets 为 role=listbox + role=option，方向键漫游、Enter/Space 选中、Home/End 首末',
-      'hex 输入含 label 与 aria-label',
-      '格式切换为 select，含 aria-label',
-      'Esc 与外部点击经 useDismiss 关闭浮层（inline 模式无浮层不挂 dismiss）',
-    ],
-  },
-  tokens: ['--cd-color-picker-*', '--cd-focus-ring', '--cd-input-*', '--cd-color-*'],
-} as const;

package/src/config-provider/ConfigProvider.svelte

@@ -1,227 +0,0 @@
-<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/src/config-provider/context.ts

@@ -1,29 +0,0 @@
-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 const CONFIG_CONTEXT_KEY = Symbol('cd-config');

package/src/config-provider/index.ts

@@ -1,48 +0,0 @@
-import { getContext } from 'svelte';
-import {
-  CONFIG_CONTEXT_KEY,
-  type ConfigContextValue,
-  type GetPopupContainer,
-  type GetValidateMessages,
-} from './context.js';
-import { DEFAULT_CONFIG, 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 function getConfigContext(): ResolvedConfig {
-  const ctx = getContext<ConfigContextValue | undefined>(CONFIG_CONTEXT_KEY);
-  return ctx?.current ?? DEFAULT_CONFIG;
-}
-
-/**
- * 读取全局浮层默认容器解析器（无配置时返回 undefined，调用方回退 document.body）。
- * 浮层组件（Modal/Dropdown/Popover/Tooltip/Select 等）应把自身 getContainer/
- * getPopupContainer prop 作为优先，仅在未传时回退到这里的全局默认。
- * 约束：须在消费组件 `<script>` 顶层（初始化期）调用。
- */
-export function getGlobalPopupContainer(): GetPopupContainer | undefined {
-  const ctx = getContext<ConfigContextValue | undefined>(CONFIG_CONTEXT_KEY);
-  return ctx?.getPopupContainer;
-}
-
-/**
- * 读取全局校验文案覆盖（无配置时返回 undefined，Form 回退 locale 内置文案）。
- * 约束：须在消费组件 `<script>` 顶层（初始化期）调用。
- */
-export function getGlobalValidateMessages(): GetValidateMessages | undefined {
-  const ctx = getContext<ConfigContextValue | undefined>(CONFIG_CONTEXT_KEY);
-  return ctx?.getValidateMessages;
-}

package/src/config-provider/meta.ts

@@ -1,128 +0,0 @@
-/**
- * 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>',
-    },
-  ],
-} as const;

package/src/date-picker/DatePicker.a11y.test.ts

@@ -1,45 +0,0 @@
-// DatePicker a11y：触发器（button，默认非 editable）+ role=dialog 面板 + role=grid 日历。
-// 只断言静态 ARIA + axe 0 violations，不测真实键盘/焦点（jsdom 限制）。
-// 打开态面板 portal 到 document.body，故扫描 document.body。
-import { describe, it, expect } from 'vitest';
-import { renderWithLocale, expectNoAxeViolations } from '../test-utils/a11y.js';
-import DatePicker from './DatePicker.svelte';
-
-describe('DatePicker a11y', () => {
-  it('关闭态：触发器 aria-haspopup=dialog / aria-expanded=false，无 axe violations', async () => {
-    const { container } = renderWithLocale(DatePicker, {
-      props: { ariaLabel: 'Start date' },
-    });
-    const trigger = container.querySelector('.cd-date-picker__trigger');
-    expect(trigger).not.toBeNull();
-    expect(trigger?.getAttribute('aria-haspopup')).toBe('dialog');
-    expect(trigger?.getAttribute('aria-expanded')).toBe('false');
-    expect(trigger?.getAttribute('aria-label')).toBe('Start date');
-    await expectNoAxeViolations(container);
-  });
-
-  it('打开态：role=dialog 面板 + role=grid 日历（portal 到 body），无 axe violations', async () => {
-    renderWithLocale(DatePicker, {
-      props: { defaultOpen: true, ariaLabel: 'Start date' },
-    });
-    const dialog = document.querySelector('[role="dialog"]');
-    expect(dialog).not.toBeNull();
-    expect(dialog?.getAttribute('aria-label')).toBeTruthy();
-    const grid = document.querySelector('[role="grid"]');
-    expect(grid).not.toBeNull();
-    const cells = document.querySelectorAll('[role="gridcell"]');
-    expect(cells.length).toBeGreaterThan(0);
-    await expectNoAxeViolations(document.body);
-  });
-
-  it('打开态：触发器 aria-expanded=true + columnheader 表头存在', async () => {
-    renderWithLocale(DatePicker, {
-      props: { defaultOpen: true, ariaLabel: 'Start date' },
-    });
-    const trigger = document.querySelector('.cd-date-picker__trigger');
-    expect(trigger?.getAttribute('aria-expanded')).toBe('true');
-    const headers = document.querySelectorAll('[role="columnheader"]');
-    expect(headers.length).toBe(7);
-    await expectNoAxeViolations(document.body);
-  });
-});

package/src/date-picker/DatePicker.kbd.test.ts

@@ -1,71 +0,0 @@
-// DatePicker 键盘 e2e（browser project / 真实 chromium）。
-// DatePicker 日历用 WAI-ARIA grid 的 aria-activedescendant 模型：焦点停在
-// role=grid 容器（tabindex=0），方向键不移动真实 DOM 焦点，而是改变容器的
-// aria-activedescendant 指向当前高亮日期格的 id。故断言 activedescendant 变化，
-// 而非真实 .toHaveFocus()（这点先读源码 onGridKeydown + activeCellId 确认）。
-//   1. 打开后焦点落在 grid 容器，aria-activedescendant 指向初始高亮（value=2024-03-15）。
-//   2. ArrowRight/ArrowDown/Home/PageUp 改变 aria-activedescendant 指向的日期格。
-//   3. Esc 关闭面板，焦点归还 trigger。
-import { describe, it, expect } from 'vitest';
-import { page } from 'vitest/browser';
-import { renderKbdFixture, userEvent } from '../test-utils/kbd.js';
-import DatePickerKbdFixture from './DatePickerKbdFixture.svelte';
-
-function loc(el: Element) {
-  return page.elementLocator(el);
-}
-
-// 读取 grid 容器当前 aria-activedescendant 指向的日期格的 id 后缀（-YYYY-M-D）。
-function activeSuffix(grid: HTMLElement): string {
-  const id = grid.getAttribute('aria-activedescendant') ?? '';
-  // id 形如 cd-date-picker-grid-x-2024-2-15；取末三段（年-月-日）。
-  const parts = id.split('-');
-  return parts.slice(-3).join('-');
-}
-
-describe('DatePicker 键盘 e2e（网格 aria-activedescendant）', () => {
-  it('方向键 + Home + PageUp 改变 aria-activedescendant；Esc 归还 trigger', async () => {
-    const { baseElement } = renderKbdFixture(DatePickerKbdFixture);
-
-    const trigger = baseElement.querySelector('[data-testid="before"]') as HTMLButtonElement;
-    expect(trigger).not.toBeNull();
-    await userEvent.click(trigger);
-
-    // 面板 portal 进 root 子树（非 body portal）：查 role=dialog + 日期网格。
-    const dialog = document.querySelector('[role="dialog"]') as HTMLElement;
-    expect(dialog).not.toBeNull();
-    const grid = dialog.querySelector('[role="grid"]') as HTMLElement;
-    expect(grid).not.toBeNull();
-
-    // 1. 焦点落在网格容器（aria-activedescendant 模型：焦点在容器，非单格）。
-    await expect.element(loc(grid)).toHaveFocus();
-    // 初始高亮对齐 value=2024-03-15。
-    expect(activeSuffix(grid)).toBe('2024-2-15');
-
-    // 2a. ArrowRight → 次日（16）。
-    await userEvent.keyboard('{ArrowRight}');
-    await expect.poll(() => activeSuffix(grid)).toBe('2024-2-16');
-    // 真实 DOM 焦点仍在网格容器（未移到具体格）。
-    expect(document.activeElement).toBe(grid);
-
-    // 2b. ArrowDown → +1 周（16 → 23）。
-    await userEvent.keyboard('{ArrowDown}');
-    await expect.poll(() => activeSuffix(grid)).toBe('2024-2-23');
-
-    // 2c. ArrowLeft → 前一日（22）。
-    await userEvent.keyboard('{ArrowLeft}');
-    await expect.poll(() => activeSuffix(grid)).toBe('2024-2-22');
-
-    // 2d. Home → 本周首日（3/22 是周五，所在周以周日起 → 3/17）。
-    await userEvent.keyboard('{Home}');
-    await expect.poll(() => activeSuffix(grid)).toBe('2024-2-17');
-
-    // 2e. PageUp → 前一月（2/17）；游标随动翻页，网格仍存在。
-    await userEvent.keyboard('{PageUp}');
-    await expect.poll(() => activeSuffix(grid)).toBe('2024-1-17');
-
-    // 3. Esc 关闭面板，焦点归还 trigger（focus trap returnFocus）。
-    await userEvent.keyboard('{Escape}');
-    await expect.element(loc(trigger)).toHaveFocus();
-  });
-});