@chenzy-design/svelte 0.3.0 → 0.4.1

package/dist/config-provider/ConfigProvider.svelte

@@ -4,15 +4,18 @@
   import {
     mergeConfig,
     DEFAULT_CONFIG,
-    resolveAppliedTheme,
-    resolveReducedMotion,
+    defaultResponsiveMap,
+    EMPTY_SCREENS,
+    registerMediaQuery,
     type ConfigInput,
     type ResolvedConfig,
-    type ConfigTheme,
-    type AppliedTheme,
     type ConfigDir,
-    type ConfigSize,
-    type ReducedMotionInput,
+    type ConfigTimeZone,
+    type ResponsiveMap,
+    type BreakpointScreens,
+    type Breakpoint,
+    type OnBreakpointScreensCallback,
+    type OnBreakpointChangeCallback,
   } from '@chenzy-design/core';
   import { createLocale, type LocaleApi } from '@chenzy-design/locale';
   import type { Locale } from '@chenzy-design/locale';
@@ -21,62 +24,32 @@
     CONFIG_CONTEXT_KEY,
     type ConfigContextValue,
     type GetPopupContainer,
-    type GetValidateMessages,
+    type OnBreakpoint,
   } from './context.js';
 
   interface Props {
-    /** 语言包；提供则注入 locale context（复用 LocaleProvider 机制），未提供沿用上层。 */
+    /** 语言包对象；提供则注入 locale context（复用 LocaleProvider 机制），未提供沿用上层。对齐 Semi locale。 */
     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）。 */
+    /** 文本方向，默认 'ltr'；'rtl' 时渲染 `<div class="cd-rtl">` 包裹层，驱动组件镜像。对齐 Semi direction。 */
+    direction?: ConfigDir;
+    /** 默认时区（数字偏移小时 / 'GMT±' / IANA 标识）注入时间类组件；未设继承父级。对齐 Semi timeZone。 */
+    timeZone?: ConfigTimeZone;
+    /** 全局浮层默认挂载容器；浮层组件（Modal/Dropdown 等）未传自身 prop 时回退此值，未设继承父级（最终回退 document.body）。对齐 Semi getPopupContainer。 */
     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;
+    /** 是否开启响应式断点监听；默认 false（不注册任何 matchMedia），开启后首次订阅时懒注册、无订阅时自动注销。对齐 Semi responsiveObserve。 */
+    responsiveObserve?: boolean;
+    /** 自定义断点配置（key 为 xs/sm/md/lg/xl/xxl，value 为 media query）；未传用默认断点。引用比较：inline 新对象会触发重注册。对齐 Semi responsiveMap。 */
+    responsiveMap?: ResponsiveMap;
     children?: Snippet;
   }
 
   let {
     locale,
-    theme,
-    reducedMotion,
-    dir,
-    size,
-    zIndexBase,
-    transition,
+    direction,
+    timeZone,
     getPopupContainer,
-    getValidateMessages,
-    wrap = false,
-    as = 'div',
-    onThemeChange,
-    onReducedMotionChange,
-    onLocaleChange,
-    onDirChange,
-    onConfigChange,
+    responsiveObserve = false,
+    responsiveMap,
     children,
   }: Props = $props();
 
@@ -86,82 +59,165 @@
   // 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;
+    if (direction !== undefined) o.direction = direction;
+    if (timeZone !== undefined) o.timeZone = timeZone;
     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,
-  );
+  // getPopupContainer 不参与 core 纯配置合并，就近合并：本地提供则 wins，否则继承父级。
+  const resolvedPopupContainer = $derived(getPopupContainer ?? parentCfg?.getPopupContainer);
 
-  // theme=auto 解析为实际 light/dark（纯函数，红线 #2）。
-  const appliedTheme = $derived(resolveAppliedTheme(resolved.theme, systemPrefersDark));
-  // reducedMotion 最终是否降级（纯函数，红线 #2）。
-  const reduced = $derived(resolveReducedMotion(resolved.reducedMotion, systemReducedMotion));
+  // 当前生效断点配置（未传用默认）。引用变化触发重注册（对齐 Semi 的引用比较语义）。
+  const effectiveMap = $derived<ResponsiveMap>(responsiveMap ?? defaultResponsiveMap);
 
-  // 仅在确有依赖系统态时才挂监听，避免无谓订阅。
-  const needsColorScheme = $derived(resolved.theme === 'auto');
-  const needsMotionQuery = $derived(resolved.reducedMotion === 'auto');
+  // --- 响应式断点（严格对齐 Semi ConfigProvider 的懒注册 / 订阅机制）---
+  // 同步真相源：普通（非响应式）字段，镜像 Semi 的 currentScreensRef。订阅时的立即
+  // 回调、notifyListeners、单断点订阅都读它，**不读 $state**，避免子组件在 $effect
+  // 内订阅时追踪到 $state screens、随后 registerMediaQueries 写入触发订阅重跑而死循环
+  // （effect_update_depth_exceeded）。
+  let currentScreensRef: BreakpointScreens = { ...EMPTY_SCREENS };
+  // 响应式镜像：仅供渲染层经 context getter 订阅（matchMedia 回调命令式写入）。
+  let screens = $state<BreakpointScreens>({ ...EMPTY_SCREENS });
+  // 订阅者集合：整表订阅 + 单断点订阅。
+  const screensListeners = new Set<OnBreakpointScreensCallback>();
+  const changeListeners = new Set<{
+    breakpoints?: Breakpoint[] | undefined;
+    callback: OnBreakpointChangeCallback;
+  }>();
+  let unRegisters: Array<() => void> = [];
+  let hasRegistered = false;
+  let warnedResponsiveObserve = false;
 
-  // 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);
-  });
+  const BREAKPOINT_KEYS: Breakpoint[] = ['xs', 'sm', 'md', 'lg', 'xl', 'xxl'];
 
-  // 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;
+  function notifyListeners(changed?: Breakpoint, match?: boolean): void {
+    // 读 ref（非响应式快照），对齐 Semi —— 不让订阅者回调追踪到 $state。
+    const snapshot = { ...currentScreensRef };
+    screensListeners.forEach((listener) => listener(snapshot));
+    if (changed != null && match != null) {
+      changeListeners.forEach(({ breakpoints, callback }) => {
+        if (!breakpoints || breakpoints.includes(changed)) callback(changed, match);
+      });
+    }
+  }
+
+  function updateScreen(screen: Breakpoint, matches: boolean): void {
+    if (currentScreensRef[screen] === matches) return;
+    currentScreensRef = { ...currentScreensRef, [screen]: matches };
+    screens = currentScreensRef; // 同步响应式镜像
+    notifyListeners(screen, matches);
+  }
+
+  function registerMediaQueries(): void {
+    if (hasRegistered) return;
+    const map = effectiveMap;
+    // 先同步读一次当前命中，再挂监听（callInInit:false 避免重复触发）。
+    const initial: BreakpointScreens = { ...EMPTY_SCREENS };
+    if (typeof window !== 'undefined' && typeof window.matchMedia === 'function') {
+      BREAKPOINT_KEYS.forEach((screen) => {
+        initial[screen] = window.matchMedia(map[screen]).matches;
+      });
+    }
+    currentScreensRef = initial;
+    screens = initial; // 同步响应式镜像
+    unRegisters = BREAKPOINT_KEYS.map((screen) =>
+      registerMediaQuery(map[screen], {
+        match: () => updateScreen(screen, true),
+        unmatch: () => updateScreen(screen, false),
+        callInInit: false,
+      }),
+    );
+    hasRegistered = true;
+  }
+
+  function unregisterMediaQueries(): void {
+    unRegisters.forEach((off) => off());
+    unRegisters = [];
+    hasRegistered = false;
+    currentScreensRef = { ...EMPTY_SCREENS };
+  }
+
+  // dev 检测：兼容 Vite（import.meta.env.DEV）与非 Vite 消费方（缺失时静默 no-op），
+  // 避免依赖 vite/client 环境类型即可通过 svelte-check。
+  const isDev = (import.meta as ImportMeta & { env?: { DEV?: boolean } }).env?.DEV ?? false;
+
+  function ensureRegistered(): void {
+    if (!responsiveObserve) {
+      if (!warnedResponsiveObserve && isDev) {
+        warnedResponsiveObserve = true;
+        console.warn(
+          '[chenzy-design] ConfigProvider responsive observing is disabled by default. ' +
+            'Set <ConfigProvider responsiveObserve> to enable breakpoint subscriptions.',
+        );
+      }
+      return;
+    }
+    if (screensListeners.size === 0 && changeListeners.size === 0) return;
+    registerMediaQueries();
+  }
+
+  function maybeUnregister(): void {
+    if (
+      responsiveObserve &&
+      screensListeners.size === 0 &&
+      changeListeners.size === 0
+    ) {
+      unregisterMediaQueries();
+    }
+  }
+
+  const onBreakpoint = ((arg1: unknown, arg2?: unknown) => {
+    // onBreakpoint(callback)
+    if (typeof arg1 === 'function') {
+      const cb = arg1 as OnBreakpointScreensCallback;
+      screensListeners.add(cb);
+      ensureRegistered();
+      cb({ ...currentScreensRef }); // 订阅即回调一次当前状态（读 ref，不追踪 $state）
+      return () => {
+        screensListeners.delete(cb);
+        maybeUnregister();
+      };
+    }
+    // onBreakpoint(breakpoints, callback)
+    const breakpoints = Array.isArray(arg1) ? (arg1 as Breakpoint[]) : undefined;
+    const cb = arg2 as OnBreakpointChangeCallback;
+    const entry = { breakpoints, callback: cb };
+    changeListeners.add(entry);
+    ensureRegistered();
+    if (breakpoints && typeof cb === 'function') {
+      breakpoints.forEach((bp) => cb(bp, currentScreensRef[bp])); // 读 ref，不追踪 $state
+    }
+    return () => {
+      changeListeners.delete(entry);
+      maybeUnregister();
     };
-    mql.addEventListener('change', onChange);
-    return () => mql.removeEventListener('change', onChange);
-  });
+  }) as OnBreakpoint;
 
-  // 全局降级标记：renderless（wrap=false）时命令式写到 documentElement（红线 #3），
-  // 令全库 reduced-motion 退化生效；wrap=true 时改写在包裹 div 上（见模板）。
-  // 仅显式 reducedMotion 才接管全局标记（'auto' 沿用系统 CSS @media，避免误置）。
+  // responsiveObserve 关掉时确保注销；responsiveMap 引用变化时（已注册）重注册。
+  // 仅追踪 effectiveMap / responsiveObserve 两个依赖；body 全程 untrack，避免读写
+  // screens 造成 effect 自反馈循环（effect_update_depth_exceeded）。
   $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');
+    const observe = responsiveObserve;
+    const map = effectiveMap;
+    untrack(() => {
+      if (!observe && hasRegistered) {
+        unregisterMediaQueries();
+      } else if (hasRegistered) {
+        // map 变化：重注册以应用新断点（callInInit:false，靠 registerMediaQueries
+        // 同步读的 initial 写入 screens 并经 context 传播；不在此主动 notify 子回调，
+        // 以免写子组件 state 反馈回父级形成循环）。
+        void map;
+        unregisterMediaQueries();
+        registerMediaQueries();
+      }
+    });
+    // cleanup：组件卸载时注销全部监听。
+    return () => untrack(() => unregisterMediaQueries());
   });
 
-  // 函数型配置（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 {
@@ -170,15 +226,25 @@
     get getPopupContainer(): GetPopupContainer | undefined {
       return resolvedPopupContainer;
     },
-    get getValidateMessages(): GetValidateMessages | undefined {
-      return resolvedValidateMessages;
+    get responsiveMap(): ResponsiveMap {
+      return effectiveMap;
+    },
+    get screens(): BreakpointScreens {
+      return screens;
+    },
+    get onBreakpoint(): OnBreakpoint {
+      return onBreakpoint;
     },
   } 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 误报。
+  // 注入 locale context（仅当 locale prop 提供时）。timeZone 不经 locale，而是作为
+  // ConfigContext 独立字段（resolved.timeZone）下发，由时间类组件（DatePicker/TimePicker）
+  // 经 config context 读取作为自身 timeZone 默认值 —— 严格对齐 Semi（DatePicker 用
+  // ConfigContext.Consumer 直接读 timeZone，与 locale 是两条独立通道）。
+  const localeApi = $derived<LocaleApi | null>(
+    locale ? createLocale({ locale, direction: resolved.direction }) : null,
+  );
+  // init 期捕获初始值决定是否注入 locale context（setContext 必须同步执行）。
   const hasLocale = untrack(() => locale !== undefined);
   if (hasLocale) {
     setContext(LOCALE_CONTEXT_KEY, {
@@ -187,41 +253,10 @@
       },
     });
   }
-
-  // 红线：$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>
+{#if resolved.direction === 'rtl'}
+  <div class="cd-rtl">{@render children?.()}</div>
 {:else}
   {@render children?.()}
 {/if}
-
-<style>
-  .cd-config-provider {
-    display: contents;
-  }
-</style>

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

@@ -1,52 +1,20 @@
 import type { Snippet } from 'svelte';
-import { type ResolvedConfig, type ConfigTheme, type AppliedTheme, type ConfigDir, type ConfigSize, type ReducedMotionInput } from '@chenzy-design/core';
+import { type ConfigDir, type ConfigTimeZone, type ResponsiveMap } from '@chenzy-design/core';
 import type { Locale } from '@chenzy-design/locale';
-import { type GetPopupContainer, type GetValidateMessages } from './context.js';
+import { type GetPopupContainer } from './context.js';
 interface Props {
-    /** 语言包；提供则注入 locale context（复用 LocaleProvider 机制），未提供沿用上层。 */
+    /** 语言包对象；提供则注入 locale context（复用 LocaleProvider 机制），未提供沿用上层。对齐 Semi locale。 */
     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）。 */
+    /** 文本方向，默认 'ltr'；'rtl' 时渲染 `<div class="cd-rtl">` 包裹层，驱动组件镜像。对齐 Semi direction。 */
+    direction?: ConfigDir;
+    /** 默认时区（数字偏移小时 / 'GMT±' / IANA 标识）注入时间类组件；未设继承父级。对齐 Semi timeZone。 */
+    timeZone?: ConfigTimeZone;
+    /** 全局浮层默认挂载容器；浮层组件（Modal/Dropdown 等）未传自身 prop 时回退此值，未设继承父级（最终回退 document.body）。对齐 Semi getPopupContainer。 */
     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;
+    /** 是否开启响应式断点监听；默认 false（不注册任何 matchMedia），开启后首次订阅时懒注册、无订阅时自动注销。对齐 Semi responsiveObserve。 */
+    responsiveObserve?: boolean;
+    /** 自定义断点配置（key 为 xs/sm/md/lg/xl/xxl，value 为 media query）；未传用默认断点。引用比较：inline 新对象会触发重注册。对齐 Semi responsiveMap。 */
+    responsiveMap?: ResponsiveMap;
     children?: Snippet;
 }
 declare const ConfigProvider: import("svelte").Component<Props, {}, "">;

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

@@ -1 +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"}
+{"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,EAQH,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,aAAa,EAKnB,MAAM,qBAAqB,CAAC;AAE/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAGH,KAAK,iBAAiB,EAEvB,MAAM,cAAc,CAAC;AAGtB,UAAU,KAAK;IACb,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,6GAA6G;IAC7G,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,6FAA6F;IAC7F,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,iHAAiH;IACjH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAuOH,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

@@ -1,25 +1,33 @@
-import type { ResolvedConfig } from '@chenzy-design/core';
-/** 全局浮层挂载容器解析器：返回浮层应 portal 进的元素。 */
+import type { ResolvedConfig, ResponsiveMap, BreakpointScreens, Breakpoint, OnBreakpointScreensCallback, OnBreakpointChangeCallback } from '@chenzy-design/core';
+/** 全局浮层挂载容器解析器：返回浮层应 portal 进的元素。对齐 Semi getPopupContainer。 */
 export type GetPopupContainer = () => HTMLElement | null | undefined;
 /**
- * 全局表单校验文案覆盖：按 `Form.*` 键返回模板字符串（支持 {label}/{min}/{max} 等
- * 占位符插值）。仅覆盖列出的键，未列出的回退到 locale 内置文案。
+ * 断点订阅函数（两种签名，均返回取消订阅函数）。对齐 Semi ConfigProvider onBreakpoint：
+ * - `onBreakpoint(cb)`：cb 拿到完整 screens 映射；
+ * - `onBreakpoint(['md','lg'], cb)`：只监听指定断点，cb 拿到 (screen, match)。
+ * 订阅时会立即以当前状态回调一次。
  */
-export type ValidateMessages = Record<string, string>;
-export type GetValidateMessages = () => ValidateMessages;
+export interface OnBreakpoint {
+    (callback: OnBreakpointScreensCallback): () => void;
+    (breakpoints: Breakpoint[], callback: OnBreakpointChangeCallback): () => void;
+}
 /**
- * config context：下发合并后的全局配置。
- *
- * `current` 是可序列化的纯配置（来自 core 的 mergeConfig）；而函数型配置
- * （getPopupContainer / getValidateMessages）不参与 core 合并，单独挂在 context
- * 上，并在嵌套时由 ConfigProvider 自行做「就近 wins、未提供继承父级」合并。
+ * config context：下发合并后的全局配置（direction / timeZone）与运行时能力。
+ * 严格对齐 Semi ConfigProvider Context：
+ * - `current`：可继承的纯配置（direction / timeZone）；
+ * - `getPopupContainer`：全局浮层默认容器（浮层组件自身 prop 优先，未传时回退）；
+ * - `responsiveMap` / `screens` / `onBreakpoint`：响应式断点能力（非 props，经 context 读）。
  */
 export type ConfigContextValue = {
     readonly current: ResolvedConfig;
     /** 全局浮层默认容器；未配置为 undefined（浮层组件回退 document.body）。 */
     readonly getPopupContainer?: GetPopupContainer | undefined;
-    /** 全局校验文案覆盖；未配置为 undefined（回退 locale 内置文案）。 */
-    readonly getValidateMessages?: GetValidateMessages | undefined;
+    /** 当前生效的断点配置（未传时为 defaultResponsiveMap）。 */
+    readonly responsiveMap: ResponsiveMap;
+    /** 各断点当前命中情况（read-only 快照）。 */
+    readonly screens: BreakpointScreens;
+    /** 订阅断点变化。 */
+    readonly onBreakpoint: OnBreakpoint;
 };
 /** config context：下发合并后的全局配置 */
 export declare const CONFIG_CONTEXT_KEY: unique symbol;

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

@@ -1 +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"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/config-provider/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,+DAA+D;AAC/D,MAAM,MAAM,iBAAiB,GAAG,MAAM,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC;AAErE;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,CAAC,QAAQ,EAAE,2BAA2B,GAAG,MAAM,IAAI,CAAC;IACpD,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,QAAQ,EAAE,0BAA0B,GAAG,MAAM,IAAI,CAAC;CAC/E;AAED;;;;;;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,4CAA4C;IAC5C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,cAAc;IACd,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;CACrC,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,kBAAkB,eAAsB,CAAC"}

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

@@ -1,11 +1,12 @@
-import { type GetPopupContainer, type GetValidateMessages } from './context.js';
+import { type ConfigContextValue, type GetPopupContainer } 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 { CONFIG_CONTEXT_KEY, type ConfigContextValue, type GetPopupContainer, type OnBreakpoint, } from './context.js';
 export { meta as configProviderMeta } from './meta.js';
+export { defaultResponsiveMap, type ConfigDir, type ConfigTimeZone, type Breakpoint, type ResponsiveMap, type BreakpointScreens, type OnBreakpointScreensCallback, type OnBreakpointChangeCallback, } from '@chenzy-design/core';
 /**
- * 读取最近 ConfigProvider 注入的合并后配置（无 Provider 时返回 DEFAULT_CONFIG）。
- * 约束：getContext 只能在组件初始化期调用，故此 helper 必须在消费组件的
+ * 读取最近 ConfigProvider 注入的合并后配置（direction / timeZone）；无 Provider 时返回
+ * DEFAULT_CONFIG。约束：getContext 只能在组件初始化期调用，故须在消费组件的
  * `<script>` 顶层（初始化期）调用。
  */
 export declare function getConfigContext(): ResolvedConfig;
@@ -17,8 +18,9 @@ export declare function getConfigContext(): ResolvedConfig;
  */
 export declare function getGlobalPopupContainer(): GetPopupContainer | undefined;
 /**
- * 读取全局校验文案覆盖（无配置时返回 undefined，Form 回退 locale 内置文案）。
- * 约束：须在消费组件 `<script>` 顶层（初始化期）调用。
+ * 读取 ConfigProvider 的响应式断点能力（screens / onBreakpoint / responsiveMap）。
+ * 等价于 Semi 的 `ConfigConsumer` 中断点相关字段。无 Provider 时返回 undefined。
+ * 约束：须在消费组件 `<script>` 顶层（初始化期）调用；订阅须在 $effect 内并返回清理。
  */
-export declare function getGlobalValidateMessages(): GetValidateMessages | undefined;
+export declare function getConfigResponsive(): Pick<ConfigContextValue, 'screens' | 'onBreakpoint' | 'responsiveMap'> | undefined;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config-provider/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACnG,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,YAAY,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,IAAI,IAAI,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EACL,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACtB,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,GAChC,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CAGjD;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI,iBAAiB,GAAG,SAAS,CAGvE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAC/B,IAAI,CAAC,kBAAkB,EAAE,SAAS,GAAG,cAAc,GAAG,eAAe,CAAC,GACtE,SAAS,CAcZ"}

package/dist/config-provider/index.js

@@ -1,12 +1,13 @@
 import { getContext } from 'svelte';
-import { CONFIG_CONTEXT_KEY, } from './context.js';
+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';
+export { defaultResponsiveMap, } from '@chenzy-design/core';
 /**
- * 读取最近 ConfigProvider 注入的合并后配置（无 Provider 时返回 DEFAULT_CONFIG）。
- * 约束：getContext 只能在组件初始化期调用，故此 helper 必须在消费组件的
+ * 读取最近 ConfigProvider 注入的合并后配置（direction / timeZone）；无 Provider 时返回
+ * DEFAULT_CONFIG。约束：getContext 只能在组件初始化期调用，故须在消费组件的
  * `<script>` 顶层（初始化期）调用。
  */
 export function getConfigContext() {
@@ -24,10 +25,23 @@ export function getGlobalPopupContainer() {
     return ctx?.getPopupContainer;
 }
 /**
- * 读取全局校验文案覆盖（无配置时返回 undefined，Form 回退 locale 内置文案）。
- * 约束：须在消费组件 `<script>` 顶层（初始化期）调用。
+ * 读取 ConfigProvider 的响应式断点能力（screens / onBreakpoint / responsiveMap）。
+ * 等价于 Semi 的 `ConfigConsumer` 中断点相关字段。无 Provider 时返回 undefined。
+ * 约束：须在消费组件 `<script>` 顶层（初始化期）调用；订阅须在 $effect 内并返回清理。
  */
-export function getGlobalValidateMessages() {
+export function getConfigResponsive() {
     const ctx = getContext(CONFIG_CONTEXT_KEY);
-    return ctx?.getValidateMessages;
+    if (!ctx)
+        return undefined;
+    return {
+        get screens() {
+            return ctx.screens;
+        },
+        get onBreakpoint() {
+            return ctx.onBreakpoint;
+        },
+        get responsiveMap() {
+            return ctx.responsiveMap;
+        },
+    };
 }