@chenzy-design/svelte 0.1.0

package/dist/list/meta.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * List — see specs/components/show/List.spec.md
+ */
+export declare const meta: {
+    readonly name: "List";
+    readonly category: "show";
+    readonly description: "列表：数据驱动渲染（dataSource + renderItem），支持 header/footer（string 或 Snippet）、bordered 外框、split 行间分隔线、loading 骨架/spinner 与空态（默认 Empty）。泛型组件。";
+    readonly exports: readonly ["List", "ListItem", "ListMeta"];
+    readonly subComponents: readonly ["List.Item", "List.Item.Meta", "List.Meta"];
+    readonly props: readonly [{
+        readonly name: "dataSource";
+        readonly type: "T[]";
+        readonly default: "[]";
+        readonly desc: "列表数据数组";
+    }, {
+        readonly name: "renderItem";
+        readonly type: "Snippet<[item: T, index: number]>";
+        readonly default: "undefined";
+        readonly desc: "行渲染 Snippet";
+    }, {
+        readonly name: "rowKey";
+        readonly type: "string|((item: T) => string|number)";
+        readonly default: "'key'";
+        readonly desc: "行唯一标识，用于 each key";
+    }, {
+        readonly name: "size";
+        readonly type: "'small'|'default'|'large'";
+        readonly default: "'default'";
+        readonly desc: "行内边距尺寸";
+    }, {
+        readonly name: "bordered";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "外层边框 + 圆角";
+    }, {
+        readonly name: "split";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "行间分隔线";
+    }, {
+        readonly name: "header";
+        readonly type: "string|Snippet";
+        readonly default: "undefined";
+        readonly desc: "头部内容";
+    }, {
+        readonly name: "footer";
+        readonly type: "string|Snippet";
+        readonly default: "undefined";
+        readonly desc: "底部内容";
+    }, {
+        readonly name: "loading";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "加载态，覆盖 body";
+    }, {
+        readonly name: "loadingSkeleton";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "loading 时用骨架行替代 spinner";
+    }, {
+        readonly name: "skeletonCount";
+        readonly type: "number";
+        readonly default: "3";
+        readonly desc: "骨架占位行数";
+    }, {
+        readonly name: "emptyContent";
+        readonly type: "string|Snippet";
+        readonly default: "undefined";
+        readonly desc: "空数据展示内容，默认内置 Empty";
+    }, {
+        readonly name: "grid";
+        readonly type: "number | { column?: number; gutter?: number }";
+        readonly default: "undefined";
+        readonly desc: "网格布局列数/间距";
+    }, {
+        readonly name: "loadMore";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "自定义底部加载区";
+    }, {
+        readonly name: "onLoadMore";
+        readonly type: "() => void";
+        readonly default: "undefined";
+        readonly desc: "内置加载更多按钮回调";
+    }, {
+        readonly name: "loadingMore";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "内置按钮 loading 态";
+    }, {
+        readonly name: "hasMore";
+        readonly type: "boolean";
+        readonly default: "false";
+        readonly desc: "是否还有更多数据";
+    }, {
+        readonly name: "pagination";
+        readonly type: "false | { pageSize?, current?, defaultCurrent?, onChange? }";
+        readonly default: "undefined";
+        readonly desc: "分页（切片当页，与 loadMore 互斥优先）";
+    }, {
+        readonly name: "virtualized";
+        readonly type: "false | { itemSize?: number|\"auto\"; estimatedItemSize?: number; height: number|string; overscan?: number }";
+        readonly default: "false";
+        readonly desc: "虚拟化：仅渲染视口内行，定高/动态测高，复用 core 区间数学（与 grid/pagination 互斥，优先生效）";
+    }, {
+        readonly name: "selectable";
+        readonly type: "false | 'single' | 'multiple'";
+        readonly default: "false";
+        readonly desc: "行可选模式：单选/多选（listbox/option 语义）";
+    }, {
+        readonly name: "selectedKeys";
+        readonly type: "(string|number)[]";
+        readonly default: "undefined";
+        readonly desc: "受控选中 key 集合（不回写，仅 onSelectionChange 回调）";
+    }, {
+        readonly name: "defaultSelectedKeys";
+        readonly type: "(string|number)[]";
+        readonly default: "[]";
+        readonly desc: "非受控初始选中 key 集合";
+    }, {
+        readonly name: "onSelectionChange";
+        readonly type: "(keys, { item, key, selected }) => void";
+        readonly default: "undefined";
+        readonly desc: "选中态变更回调（受控/非受控均触发）";
+    }, {
+        readonly name: "children";
+        readonly type: "Snippet";
+        readonly default: "undefined";
+        readonly desc: "声明式用法：内嵌 <List.Item>（不传 dataSource 时生效）";
+    }, {
+        readonly name: "class";
+        readonly type: "string";
+        readonly default: "''";
+        readonly desc: "根类名透传";
+    }];
+    readonly capabilities: readonly ["data-render", "pagination", "load-more", "virtualized", "grid", "selectable", "declarative-items", "empty/loading-state"];
+    readonly methods: readonly [{
+        readonly name: "scrollToIndex";
+        readonly type: "(index: number, opts?: { align?: 'start'|'center'|'end' }) => void";
+        readonly desc: "虚拟化模式命令式滚动到指定索引项";
+    }];
+    readonly events: readonly [{
+        readonly name: "onSelectionChange";
+        readonly payload: "(keys, { item, key, selected })";
+        readonly desc: "selectable 选中态变更";
+    }];
+    readonly slots: readonly [{
+        readonly name: "renderItem";
+        readonly desc: "行渲染（item, index）";
+    }, {
+        readonly name: "header";
+        readonly desc: "头部 Snippet（与 header string 二选一）";
+    }, {
+        readonly name: "footer";
+        readonly desc: "底部 Snippet";
+    }, {
+        readonly name: "emptyContent";
+        readonly desc: "空态 Snippet";
+    }, {
+        readonly name: "children";
+        readonly desc: "声明式 <List.Item> 子项（不传 dataSource 时）";
+    }];
+    readonly a11y: {
+        readonly role: "list";
+        readonly focusable: false;
+        readonly notes: readonly ["ul/li 原生列表语义；selectable 时容器 role=listbox（multiple 加 aria-multiselectable），行 role=option + aria-selected", "selectable 行 tabindex=0，Space/Enter 切换选中；multiple 支持 shift 连选", "loading 时根容器 aria-busy=true", "骨架行 aria-hidden=true，spinner aria-hidden=true", "虚拟化行带 aria-setsize/aria-posinset"];
+    };
+    readonly tokens: readonly ["--cd-list-bg", "--cd-list-border", "--cd-list-radius", "--cd-list-item-padding", "--cd-list-item-padding-small", "--cd-list-split-color", "--cd-list-header-color", "--cd-list-item-color", "--cd-radius-full", "--cd-radius-small", "--cd-color-primary"];
+    readonly examples: readonly [{
+        readonly title: "基础";
+        readonly code: "{#snippet item(d)}<span>{d.title}</span>{/snippet}\n<List dataSource={data} renderItem={item} bordered />";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

package/dist/list/meta.d.ts.map

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

package/dist/list/meta.js

@@ -0,0 +1,97 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * List — see specs/components/show/List.spec.md
+ */
+export const meta = {
+    name: 'List',
+    category: 'show',
+    description: '列表：数据驱动渲染（dataSource + renderItem），支持 header/footer（string 或 Snippet）、bordered 外框、split 行间分隔线、loading 骨架/spinner 与空态（默认 Empty）。泛型组件。',
+    exports: ['List', 'ListItem', 'ListMeta'],
+    subComponents: ['List.Item', 'List.Item.Meta', 'List.Meta'],
+    props: [
+        { name: 'dataSource', type: 'T[]', default: '[]', desc: '列表数据数组' },
+        {
+            name: 'renderItem',
+            type: 'Snippet<[item: T, index: number]>',
+            default: 'undefined',
+            desc: '行渲染 Snippet',
+        },
+        {
+            name: 'rowKey',
+            type: 'string|((item: T) => string|number)',
+            default: "'key'",
+            desc: '行唯一标识，用于 each key',
+        },
+        { name: 'size', type: "'small'|'default'|'large'", default: "'default'", desc: '行内边距尺寸' },
+        { name: 'bordered', type: 'boolean', default: 'false', desc: '外层边框 + 圆角' },
+        { name: 'split', type: 'boolean', default: 'true', desc: '行间分隔线' },
+        { name: 'header', type: 'string|Snippet', default: 'undefined', desc: '头部内容' },
+        { name: 'footer', type: 'string|Snippet', default: 'undefined', desc: '底部内容' },
+        { name: 'loading', type: 'boolean', default: 'false', desc: '加载态，覆盖 body' },
+        { name: 'loadingSkeleton', type: 'boolean', default: 'false', desc: 'loading 时用骨架行替代 spinner' },
+        { name: 'skeletonCount', type: 'number', default: '3', desc: '骨架占位行数' },
+        {
+            name: 'emptyContent',
+            type: 'string|Snippet',
+            default: 'undefined',
+            desc: '空数据展示内容，默认内置 Empty',
+        },
+        { name: 'grid', type: 'number | { column?: number; gutter?: number }', default: 'undefined', desc: '网格布局列数/间距' },
+        { name: 'loadMore', type: 'Snippet', default: 'undefined', desc: '自定义底部加载区' },
+        { name: 'onLoadMore', type: '() => void', default: 'undefined', desc: '内置加载更多按钮回调' },
+        { name: 'loadingMore', type: 'boolean', default: 'false', desc: '内置按钮 loading 态' },
+        { name: 'hasMore', type: 'boolean', default: 'false', desc: '是否还有更多数据' },
+        { name: 'pagination', type: 'false | { pageSize?, current?, defaultCurrent?, onChange? }', default: 'undefined', desc: '分页（切片当页，与 loadMore 互斥优先）' },
+        { name: 'virtualized', type: 'false | { itemSize?: number|"auto"; estimatedItemSize?: number; height: number|string; overscan?: number }', default: 'false', desc: '虚拟化：仅渲染视口内行，定高/动态测高，复用 core 区间数学（与 grid/pagination 互斥，优先生效）' },
+        { name: 'selectable', type: "false | 'single' | 'multiple'", default: 'false', desc: '行可选模式：单选/多选（listbox/option 语义）' },
+        { name: 'selectedKeys', type: '(string|number)[]', default: 'undefined', desc: '受控选中 key 集合（不回写，仅 onSelectionChange 回调）' },
+        { name: 'defaultSelectedKeys', type: '(string|number)[]', default: '[]', desc: '非受控初始选中 key 集合' },
+        { name: 'onSelectionChange', type: '(keys, { item, key, selected }) => void', default: 'undefined', desc: '选中态变更回调（受控/非受控均触发）' },
+        { name: 'children', type: 'Snippet', default: 'undefined', desc: '声明式用法：内嵌 <List.Item>（不传 dataSource 时生效）' },
+        { name: 'class', type: 'string', default: "''", desc: '根类名透传' },
+    ],
+    capabilities: ['data-render', 'pagination', 'load-more', 'virtualized', 'grid', 'selectable', 'declarative-items', 'empty/loading-state'],
+    methods: [
+        { name: 'scrollToIndex', type: "(index: number, opts?: { align?: 'start'|'center'|'end' }) => void", desc: '虚拟化模式命令式滚动到指定索引项' },
+    ],
+    events: [
+        { name: 'onSelectionChange', payload: '(keys, { item, key, selected })', desc: 'selectable 选中态变更' },
+    ],
+    slots: [
+        { name: 'renderItem', desc: '行渲染（item, index）' },
+        { name: 'header', desc: '头部 Snippet（与 header string 二选一）' },
+        { name: 'footer', desc: '底部 Snippet' },
+        { name: 'emptyContent', desc: '空态 Snippet' },
+        { name: 'children', desc: '声明式 <List.Item> 子项（不传 dataSource 时）' },
+    ],
+    a11y: {
+        role: 'list',
+        focusable: false,
+        notes: [
+            'ul/li 原生列表语义；selectable 时容器 role=listbox（multiple 加 aria-multiselectable），行 role=option + aria-selected',
+            'selectable 行 tabindex=0，Space/Enter 切换选中；multiple 支持 shift 连选',
+            'loading 时根容器 aria-busy=true',
+            '骨架行 aria-hidden=true，spinner aria-hidden=true',
+            '虚拟化行带 aria-setsize/aria-posinset',
+        ],
+    },
+    tokens: [
+        '--cd-list-bg',
+        '--cd-list-border',
+        '--cd-list-radius',
+        '--cd-list-item-padding',
+        '--cd-list-item-padding-small',
+        '--cd-list-split-color',
+        '--cd-list-header-color',
+        '--cd-list-item-color',
+        '--cd-radius-full',
+        '--cd-radius-small',
+        '--cd-color-primary',
+    ],
+    examples: [
+        {
+            title: '基础',
+            code: '{#snippet item(d)}<span>{d.title}</span>{/snippet}\n<List dataSource={data} renderItem={item} bordered />',
+        },
+    ],
+};

package/dist/locale-provider/LocaleProvider.svelte

@@ -0,0 +1,110 @@
+<script lang="ts">
+  import { setContext } from 'svelte';
+  import type { Snippet } from 'svelte';
+  import {
+    createLocale,
+    resolveLocale,
+    mergeLocale,
+    en_US,
+    type LocaleApi,
+    type Direction,
+    type CreateLocaleOptions,
+  } from '@chenzy-design/locale';
+  import type { Locale } from '@chenzy-design/locale';
+  import { LOCALE_CONTEXT_KEY, type LocaleContextValue } from './context.js';
+  import { getLocaleContext } from './index.js';
+
+  interface Props {
+    /**
+     * 语言包对象，或内置/已注册的字符串码（如 'zh_CN' / 'en-US'）。
+     * 字符串码经 registerLocale 注册表 + 内置包查表解析；未知码回退 en_US。
+     */
+    locale: Locale | string;
+    /** 缺失 key 回退包，默认 createLocale 内部用 en_US。 */
+    fallback?: Locale;
+    /** 文本方向，默认 'auto'（按 locale.rtl 推断）。 */
+    direction?: Direction | 'auto';
+    /**
+     * 嵌套时是否深合并父级 LocaleProvider 的语言包（子覆盖父，未覆盖继承父）。
+     * 默认 true；设 false 则整体替换，仅用本级语言包。
+     */
+    inherit?: boolean;
+    /** 默认 IANA 时区（如 'Asia/Shanghai'）注入 formatDate；未设时继承父级。 */
+    timeZone?: string;
+    /** 默认 ISO 4217 货币（如 'CNY'）用于 currency 风格 formatNumber；未设时继承父级。 */
+    currency?: string;
+    /** locale/direction 变化时的通知回调（受控，不回写）。 */
+    onLocaleChange?: (info: { locale: string; direction: Direction }) => void;
+    children?: Snippet<
+      [
+        {
+          locale: string;
+          t: LocaleApi['t'];
+          formatDate: LocaleApi['formatDate'];
+          formatNumber: LocaleApi['formatNumber'];
+          direction: Direction;
+        },
+      ]
+    >;
+  }
+
+  let {
+    locale,
+    fallback,
+    direction = 'auto',
+    inherit = true,
+    timeZone,
+    currency,
+    onLocaleChange,
+    children,
+  }: Props = $props();
+
+  // 最近的父级 LocaleProvider 上下文（初始化期读一次）；用于 inherit 深合并与配置继承。
+  const parent = getLocaleContext();
+
+  // 解析本级语言包：字符串码经注册表/内置查表，未知码回退 en_US；对象原样使用。
+  // 红线 #2：resolveLocale / mergeLocale 为 @chenzy-design/locale 的纯函数。
+  const resolved = $derived.by<Locale>(() => {
+    const own = resolveLocale(locale) ?? en_US;
+    // inherit：深合并父级生效包作基底，子覆盖父、未覆盖继承父。
+    return inherit && parent ? (mergeLocale(parent.resolved, own) as Locale) : own;
+  });
+
+  // 时区/货币：本级未设时继承父级生效值（仅 inherit 时；否则只用本级）。
+  const effTimeZone = $derived(timeZone ?? (inherit ? parent?.timeZone : undefined));
+  const effCurrency = $derived(currency ?? (inherit ? parent?.currency : undefined));
+
+  // 派生 LocaleApi：依赖变化时重建（Intl 缓存随之重置，可接受）。
+  // exactOptionalPropertyTypes 下条件构造 options，避免给可选属性传 undefined。
+  const api = $derived.by<LocaleApi>(() => {
+    const options: CreateLocaleOptions = { locale: resolved, direction };
+    if (fallback) options.fallback = fallback;
+    if (effTimeZone) options.timeZone = effTimeZone;
+    if (effCurrency) options.currency = effCurrency;
+    return createLocale(options);
+  });
+
+  // setContext 注入带 getter 的稳定引用对象，使后代 getContext 读到最新值。
+  // 红线 #1：locale 受控，仅注入不回写。resolved/timeZone/currency 供子级 inherit 用。
+  setContext<LocaleContextValue>(LOCALE_CONTEXT_KEY, {
+    get current(): LocaleApi {
+      return api;
+    },
+    get resolved(): Locale {
+      return resolved;
+    },
+    get timeZone(): string | undefined {
+      return effTimeZone;
+    },
+    get currency(): string | undefined {
+      return effCurrency;
+    },
+  });
+
+  // 红线 #3：$effect 只调通知回调，无 DOM/几何操作。首次 mount 也会触发一次（payload 为初始 locale，可接受）。
+  $effect(() => {
+    onLocaleChange?.({ locale: api.code, direction: api.direction });
+  });
+</script>
+
+{#if children}{@render children({ locale: api.code, t: api.t, formatDate: api.formatDate, formatNumber: api.formatNumber, direction: api.direction })}{/if}

package/dist/locale-provider/LocaleProvider.svelte.d.ts

@@ -0,0 +1,41 @@
+import type { Snippet } from 'svelte';
+import { type LocaleApi, type Direction } from '@chenzy-design/locale';
+import type { Locale } from '@chenzy-design/locale';
+interface Props {
+    /**
+     * 语言包对象，或内置/已注册的字符串码（如 'zh_CN' / 'en-US'）。
+     * 字符串码经 registerLocale 注册表 + 内置包查表解析；未知码回退 en_US。
+     */
+    locale: Locale | string;
+    /** 缺失 key 回退包，默认 createLocale 内部用 en_US。 */
+    fallback?: Locale;
+    /** 文本方向，默认 'auto'（按 locale.rtl 推断）。 */
+    direction?: Direction | 'auto';
+    /**
+     * 嵌套时是否深合并父级 LocaleProvider 的语言包（子覆盖父，未覆盖继承父）。
+     * 默认 true；设 false 则整体替换，仅用本级语言包。
+     */
+    inherit?: boolean;
+    /** 默认 IANA 时区（如 'Asia/Shanghai'）注入 formatDate；未设时继承父级。 */
+    timeZone?: string;
+    /** 默认 ISO 4217 货币（如 'CNY'）用于 currency 风格 formatNumber；未设时继承父级。 */
+    currency?: string;
+    /** locale/direction 变化时的通知回调（受控，不回写）。 */
+    onLocaleChange?: (info: {
+        locale: string;
+        direction: Direction;
+    }) => void;
+    children?: Snippet<[
+        {
+            locale: string;
+            t: LocaleApi['t'];
+            formatDate: LocaleApi['formatDate'];
+            formatNumber: LocaleApi['formatNumber'];
+            direction: Direction;
+        }
+    ]>;
+}
+declare const LocaleProvider: import("svelte").Component<Props, {}, "">;
+type LocaleProvider = ReturnType<typeof LocaleProvider>;
+export default LocaleProvider;
+//# sourceMappingURL=LocaleProvider.svelte.d.ts.map

package/dist/locale-provider/LocaleProvider.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleProvider.svelte.d.ts","sourceRoot":"","sources":["../../src/locale-provider/LocaleProvider.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAKH,KAAK,SAAS,EACd,KAAK,SAAS,EAEf,MAAM,uBAAuB,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAKlD,UAAU,KAAK;IACb;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC/B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,SAAS,CAAA;KAAE,KAAK,IAAI,CAAC;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAChB;QACE;YACE,MAAM,EAAE,MAAM,CAAC;YACf,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;YAClB,UAAU,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;YACpC,YAAY,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;YACxC,SAAS,EAAE,SAAS,CAAC;SACtB;KACF,CACF,CAAC;CACH;AAyEH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

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

@@ -0,0 +1,20 @@
+import type { Locale, LocaleApi } from '@chenzy-design/locale';
+/** Svelte context key shared by LocaleProvider 与（未来的）ConfigProvider。 */
+export declare const LOCALE_CONTEXT_KEY: unique symbol;
+/**
+ * 注入到 context 的对象。`current` 是消费端读的 LocaleApi（getter，随语言切换更新）；
+ * `resolved`/`timeZone`/`currency` 供嵌套 LocaleProvider 做 inherit 深合并与配置继承，
+ * 消费组件无需关心。
+ */
+export interface LocaleContextValue {
+    /** 最近注入的 LocaleApi（getter，渲染期重新读取拿到最新值）。 */
+    readonly current: LocaleApi;
+    /** 当前生效的完整语言包对象，供子级 inherit 深合并的父基底。 */
+    readonly resolved: Locale;
+    /** 当前生效的默认时区，供子级未显式设置时继承。 */
+    readonly timeZone: string | undefined;
+    /** 当前生效的默认货币，供子级未显式设置时继承。 */
+    readonly currency: string | undefined;
+}
+export type { Locale, LocaleApi };
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/locale-provider/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAE/D,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,eAAsB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IACtC,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC"}

package/dist/locale-provider/context.js

@@ -0,0 +1,2 @@
+/** Svelte context key shared by LocaleProvider 与（未来的）ConfigProvider。 */
+export const LOCALE_CONTEXT_KEY = Symbol('cd-locale');

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

@@ -0,0 +1,12 @@
+import { type LocaleContextValue } from './context.js';
+export { default as LocaleProvider } from './LocaleProvider.svelte';
+export { LOCALE_CONTEXT_KEY, type LocaleApi, type LocaleContextValue, } from './context.js';
+export { meta as localeProviderMeta } from './meta.js';
+/**
+ * 读取最近 LocaleProvider 注入的上下文值。
+ * 约束：getContext 只能在组件初始化期调用，故此 helper 必须在消费组件的
+ * `<script>` 顶层（初始化期）调用，返回对象的 `current` 持有最新 LocaleApi。
+ */
+export declare function getLocaleContext(): LocaleContextValue | undefined;
+export { useLocale } from './use-locale.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/locale-provider/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAE3E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EACL,kBAAkB,EAClB,KAAK,SAAS,EACd,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,IAAI,IAAI,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,kBAAkB,GAAG,SAAS,CAEjE;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/locale-provider/index.js

@@ -0,0 +1,14 @@
+import { getContext } from 'svelte';
+import { LOCALE_CONTEXT_KEY } from './context.js';
+export { default as LocaleProvider } from './LocaleProvider.svelte';
+export { LOCALE_CONTEXT_KEY, } from './context.js';
+export { meta as localeProviderMeta } from './meta.js';
+/**
+ * 读取最近 LocaleProvider 注入的上下文值。
+ * 约束：getContext 只能在组件初始化期调用，故此 helper 必须在消费组件的
+ * `<script>` 顶层（初始化期）调用，返回对象的 `current` 持有最新 LocaleApi。
+ */
+export function getLocaleContext() {
+    return getContext(LOCALE_CONTEXT_KEY);
+}
+export { useLocale } from './use-locale.js';

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

@@ -0,0 +1,79 @@
+/**
+ * Machine-readable component metadata for AI/docs consumption.
+ * LocaleProvider — see specs/components/other/LocaleProvider.spec.md
+ */
+export declare const meta: {
+    readonly name: "LocaleProvider";
+    readonly category: "other";
+    readonly renderless: true;
+    readonly description: "语言上下文注入组件，renderless 无 DOM 输出，通过 setContext 注入 LocaleApi（t/formatDate/formatNumber/direction）供后代组件消费；含回退链 + Intl 缓存 + direction 推断，是 ConfigProvider 的 locale 维度子集。locale 支持语言包对象或字符串码（registerLocale 注册表 + 内置查表解析）；嵌套时 inherit 深合并父级语言包（子覆盖父）；timeZone/currency 经 context 注入 formatDate/formatNumber。";
+    readonly exports: readonly ["LocaleProvider"];
+    readonly props: readonly [{
+        readonly name: "locale";
+        readonly type: "Locale | string";
+        readonly default: "undefined";
+        readonly desc: "语言包对象或字符串码（如 'zh_CN'/'en-US'）；字符串经 registerLocale 注册表 + 内置查表解析，未知码回退 en_US";
+    }, {
+        readonly name: "fallback";
+        readonly type: "Locale";
+        readonly default: "undefined";
+        readonly desc: "缺失 key 回退包，默认内部用 en_US";
+    }, {
+        readonly name: "direction";
+        readonly type: "'ltr'|'rtl'|'auto'";
+        readonly default: "'auto'";
+        readonly desc: "文本方向，'auto' 按 locale.rtl 推断";
+    }, {
+        readonly name: "inherit";
+        readonly type: "boolean";
+        readonly default: "true";
+        readonly desc: "嵌套时深合并父级 LocaleProvider 语言包（子覆盖父，未覆盖继承父）；false 则整体替换";
+    }, {
+        readonly name: "timeZone";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "默认 IANA 时区（如 'Asia/Shanghai'）注入 formatDate；未设时继承父级";
+    }, {
+        readonly name: "currency";
+        readonly type: "string";
+        readonly default: "undefined";
+        readonly desc: "默认 ISO 4217 货币（如 'CNY'）用于 currency 风格 formatNumber；未设时继承父级";
+    }];
+    readonly events: readonly [{
+        readonly name: "onLocaleChange";
+        readonly desc: "locale/direction 变化时通知（受控，不回写）";
+    }];
+    readonly slots: readonly [{
+        readonly name: "children";
+        readonly desc: "作用域参数 { locale, t, formatDate, formatNumber, direction }";
+    }];
+    readonly a11y: {
+        readonly hasRole: false;
+        readonly note: "无 DOM 无 role；推荐宿主监听 onLocaleChange 同步 html lang/dir 满足 WCAG 3.1.2；renderless 不丢焦点。";
+    };
+    readonly tokens: readonly [];
+    readonly responsive: false;
+    readonly examples: readonly [{
+        readonly title: "基础包裹";
+        readonly code: "<LocaleProvider {locale}>{@render app()}</LocaleProvider>";
+    }, {
+        readonly title: "局部覆盖";
+        readonly code: "<LocaleProvider locale={en_US}>{@render section()}</LocaleProvider>";
+    }, {
+        readonly title: "slot 作用域格式化";
+        readonly code: "<LocaleProvider {locale}>{#snippet children({ t, formatNumber })}{t(\"Modal.okText\")} {formatNumber(1234.5)}{/snippet}</LocaleProvider>";
+    }, {
+        readonly title: "字符串码解析";
+        readonly code: "<LocaleProvider locale=\"en_US\">{@render app()}</LocaleProvider>";
+    }, {
+        readonly title: "注册自定义包后用码";
+        readonly code: "registerLocale('fr_FR', fr); // 再 <LocaleProvider locale=\"fr_FR\">…";
+    }, {
+        readonly title: "嵌套 inherit 深合并";
+        readonly code: "<LocaleProvider locale={zh_CN}>{@render outer()}<LocaleProvider locale={{ Modal: { okText: \"好的\" } }}>{@render inner()}</LocaleProvider></LocaleProvider>";
+    }, {
+        readonly title: "时区 / 货币";
+        readonly code: "<LocaleProvider locale=\"zh_CN\" timeZone=\"Asia/Shanghai\" currency=\"CNY\">{@render app()}</LocaleProvider>";
+    }];
+};
+//# sourceMappingURL=meta.d.ts.map

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

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