zkit-ui 1.0.0

package/README.md

@@ -0,0 +1,267 @@
+# zkit-ui
+
+私有 React Native 组件库（Monorepo workspace 包），用于沉淀可复用 UI / 交互 / tokens。
+
+## 目标
+
+- 组件“可沉淀”：通用、可组合、可测试、可维护
+- 主题可配置：默认主题 + 应用侧覆盖 + 局部覆盖
+- 国际化可注入：默认字典 + 应用侧覆盖 + 缺失策略
+- API 可控：一致的 props 设计与导出方式，避免“每个组件一个风格”
+
+## 安装与使用
+
+在 workspace 内通过 `workspace:*` 引用即可（本仓库已采用 pnpm workspace）。
+
+```ts
+import { Button } from 'zkit-ui';
+```
+
+## 主题（Theme）
+
+### 主题模型
+
+主题类型定义在 [types.ts](src/theme/types.ts)：
+
+- `Theme`：完整主题对象（组件内部使用）
+- `ThemeOverride`：应用侧覆盖对象（Partial + 深层 colors Partial）
+
+默认主题在 [defaultTheme.ts](src/theme/defaultTheme.ts)。
+
+### 推荐用法：统一 Provider（主题 + i18n + 全局浮层）
+
+```tsx
+import { ComponentLibProvider } from 'zkit-ui';
+
+export function AppProviders({ children }: { children: React.ReactNode }) {
+  return (
+    <ComponentLibProvider
+      theme={{ colors: { primary: '#2563EB' } }}
+      messages={{ 'button.ok': '确定' }}
+      missingKeyPolicy="throw"
+    >
+      {children}
+    </ComponentLibProvider>
+  );
+}
+```
+
+### 单独使用 ThemeProvider
+
+```tsx
+import { ThemeProvider } from 'zkit-ui';
+
+<ThemeProvider theme={{ colors: { primary: '#16A34A' } }}>
+  {/* ... */}
+</ThemeProvider>;
+```
+
+### 全局默认配置（不依赖 Provider）
+
+如果你的项目希望“即便没包 Provider，也要有一致默认值”，可以在应用启动时配置：
+
+```ts
+import { configureComponentLib } from 'zkit-ui';
+
+configureComponentLib({
+  theme: { colors: { primary: '#0F172A' } },
+  i18n: {
+    locale: 'zh-CN',
+    messages: { 'checkbox.label': '勾选' },
+    missingKeyPolicy: 'throw',
+  },
+});
+```
+
+## 国际化（i18n）
+
+### 核心概念
+
+- 默认 locale 会读取系统语言；内置支持 `zh-CN`、`zh-TW`、`ja`、`en-US`、`de`，不支持的语言回退到 `zh-CN`
+- `messages`：扁平字典 `Record<string, string>`
+- `t(key, params?)`：取文案；支持 `{name}` 这种占位符插值
+- `missingKeyPolicy`：
+  - `throw`：缺失 key 直接抛错（更适合开发/测试，及时暴露漏配）
+  - `key`：缺失 key 回显 key（更适合线上，避免崩溃）
+
+### 使用
+
+```tsx
+import { I18nProvider, Text, useI18n } from 'zkit-ui';
+
+function Demo() {
+  const { t } = useI18n();
+  return <Text>{t('greeting.hello', { name: 'Alice' })}</Text>;
+}
+
+<I18nProvider messages={{ 'greeting.hello': '你好，{name}' }} missingKeyPolicy="throw">
+  <Demo />
+</I18nProvider>;
+```
+
+## 组件编写规范（沉淀收纳标准）
+
+## 组件清单
+
+- Accordion：手风琴/折叠面板（Reanimated 高度与指示器动画）
+- Checkbox：三端一致的复选框/复选框组（受控/非受控、三态、Reanimated 指示器动画）
+- Radio：三端一致的单选框/单选组（受控/非受控、可清空组、Reanimated 指示器动画）
+- Switch：三端一致的布尔开关（受控/非受控、Reanimated 轨道与 thumb 动画）
+- TextInput / TextInputPrimitive：统一文本输入 Field 与接近 RN 原生能力的薄封装
+- Sheet：通用方向弹层（H5 bottom/top/left/right 自绘，iOS/Android bottom 内部走原生 TrueSheet）
+- LoadingService：全局加载 HUD 服务（handle 状态模型、Promise 绑定、Android 无 elevation 残影路径）
+- ImagePreview：全屏图片预览（声明式 open/value 状态模型 + 全局 imagePreview.open 服务）
+- Picker：底部滚轮选择器（单列/级联、确认提交、iOS 原生 wheel）
+- AddressCascader：省市区级联选择（内置中国数据）
+- DatePicker：年/月/日日期选择（空值、范围、精度与确认提交语义）
+- WheelColumn：单列滚轮选择（iOS 原生 wheel，Android/Web 自绘高性能路径）
+
+### Accordion 用法
+
+```tsx
+import * as React from 'react';
+import {
+  Accordion,
+  AccordionContent,
+  AccordionItem,
+  AccordionTrigger,
+  Text,
+} from 'zkit-ui';
+
+export function DemoAccordion() {
+  const [openItem, setOpenItem] = React.useState<string | null>('item-1');
+
+  return (
+    <Accordion value={openItem} onChange={setOpenItem} variant="card" size="md">
+      <AccordionItem value="item-1">
+        <AccordionTrigger title="第一项" description="支持标题、副标题和自定义插槽" />
+        <AccordionContent>
+          <Text>内容 1</Text>
+        </AccordionContent>
+      </AccordionItem>
+
+      <AccordionItem value="item-2">
+        <AccordionTrigger title="第二项" />
+        <AccordionContent>
+          <Text>内容 2</Text>
+        </AccordionContent>
+      </AccordionItem>
+    </Accordion>
+  );
+}
+```
+
+`Accordion` 使用 `value/defaultValue/onChange` 状态模型。默认 `type="single"` 且可折叠，空值为 `null`；`type="multiple"` 时值为数组。内容默认 `mountStrategy="eager"` 以保留内部状态，可按需切到 `lazy` 或 `unmountOnExit`。
+
+### Sheet 用法
+
+```tsx
+import * as React from 'react';
+import { Button, Sheet, Text } from 'zkit-ui';
+
+export function DemoSheet() {
+  const [open, setOpen] = React.useState(false);
+
+  return (
+    <>
+      <Button onPress={() => setOpen(true)}>打开筛选</Button>
+
+      <Sheet placement="right" open={open} onOpenChange={setOpen} size="md">
+        <Sheet.Header title="筛选" description="支持上下左右方向" />
+        <Sheet.Content>
+          <Text>右侧弹层内容</Text>
+        </Sheet.Content>
+      </Sheet>
+    </>
+  );
+}
+```
+
+`Sheet` 使用 `open/defaultOpen/onOpenChange` 状态模型。iOS / Android 的 `placement="bottom"` 会使用原生 TrueSheet；H5 bottom 与 `top/left/right` 一样使用 Reanimated 自绘路径。底部档位通过根级 `detents/detentIndex/defaultDetentIndex/onDetentChange` 管理，`nativeProps` 只作为原生底部的高级逃生口。
+
+### ImagePreview 用法
+
+```tsx
+import { ImagePreview, imagePreview } from 'zkit-ui';
+
+<ImagePreview
+  images={images}
+  open={previewOpen}
+  value={previewIndex}
+  onChange={setPreviewIndex}
+  onOpenChange={setPreviewOpen}
+/>;
+
+imagePreview.open({ images, index: 0 });
+```
+
+`ImagePreview` 使用 `open/defaultOpen/onOpenChange` 管理显隐，使用 `value/defaultValue/onChange` 管理当前图片索引。全局 `imagePreview.open()` 返回 handle，可通过 `handle.result` 获取关闭原因和最终索引；`ComponentLibProvider` 已内置 `ImagePreviewProvider`。
+
+### 目录与导出
+
+- 组件放在 `src/ui/`（一组件一文件为主；复杂组件可拆同名子文件）
+- 业务无关的工具放在 `src/`（例如 `theme/`、`i18n/`）
+- 所有对外导出集中在 [src/index.ts](src/index.ts)
+  - 新增组件必须同时导出组件与 props type
+  - 不对外导出内部私有工具（除非确定是稳定 API）
+
+### Props 设计
+
+- 语义优先：优先用 `variant`/`size` 等语义字段；最终样式从 Theme 派生
+- 兜底能力：保留 `style`（容器）与必要的 `*Style`（子元素）作为 escape hatch
+- 默认值规则：
+  - 能安全默认的（例如 `variant="primary"`、`shape="square"`）可以给默认值
+  - 与业务强相关/配置缺失会导致误用的，不要做“看起来能跑”的兜底
+- 受控/非受控：
+  - 交互组件优先支持 `value/checked` + `onChange` 受控
+  - 同时支持 `defaultValue/defaultChecked` 非受控
+  - 明确 `isControlled` 分支，避免受控/非受控混用导致状态错乱
+- 事件命名：
+  - 值变化：`onChange`（对外一般用最终 primitive 值）
+  - 语义更强的变化：可以补充 `onCheckedChange` 这类（但要解释差异）
+
+### 样式与 tokens
+
+- 组件内部禁止写死品牌色，必须来自 `useTheme()`（允许通过 props 单次覆盖）
+- 尺寸类 props 直接接收 number（业务侧可自行传 `wp/sp` 计算后的值）
+- 文字组件统一使用组件库 [Text](src/ui/Text/index.tsx)，优先用 `variant` / `size` / `weight` / `tone` 表达语义，`style` 只作为最终 escape hatch
+- 新增 tokens 流程：
+  - 先扩展 [Theme](src/theme/types.ts) 的字段
+  - 同步补齐 [defaultTheme](src/theme/defaultTheme.ts)
+  - 再在组件里通过 `useTheme()` 消费，避免散落常量
+
+### i18n key 规范
+
+- 统一前缀：`component.<ComponentName>.*`，避免与业务侧 key 冲突
+- key 示例：
+  - `component.Button.ok`
+  - `component.Checkbox.indeterminate`
+- 默认策略建议：
+  - 开发/测试：`missingKeyPolicy="throw"`（及时暴露漏 key）
+  - 线上：`missingKeyPolicy="key"`（缺失时不崩溃）
+
+### 可访问性（A11y）
+
+- 交互组件必须设置 `accessibilityRole`
+- 对应状态必须设置 `accessibilityState`（disabled/checked/selected 等）
+- 必要时补充 `accessibilityLabel`（当 UI 上无可读 label 时）
+
+### 测试与可调试性
+
+- 交互组件提供 `testID`（或透传 RN 原生 props）
+- 避免在组件内部吞掉错误；配置缺失要更“fail-fast”（尤其是 i18n key）
+
+### 新增组件检查清单
+
+- 在 `src/ui/<Component>.tsx` 实现组件与 `export type <Component>Props`
+- 使用 `useTheme()` 获取颜色/样式 tokens（不要写死品牌色）
+- 文案通过 `useI18n().t()` 获取（不要写死可见文本）
+- 补齐 `accessibilityRole` 与 `accessibilityState`
+- 需要时提供 `testID`（或透传 RN props）
+- 在 [src/index.ts](src/index.ts) 导出组件与 props type
+
+### 组件收纳门槛（什么时候该进组件库）
+
+- 至少被 2 个页面/模块复用，且不存在明显业务耦合
+- 视觉/交互有稳定设计来源（设计稿或明确规范），不是临时方案
+- props 可解释、可组合，且对主题/i18n 有清晰依赖边界

package/dist/ComponentLibProvider.d.ts

@@ -0,0 +1,15 @@
+import type * as React from 'react';
+import type { I18nMessages, I18nMissingKeyPolicy } from './i18n/types';
+import { type LoadingDefaults } from './services/LoadingService/index';
+import type { Theme, ThemeOverride } from './theme/types';
+export type ComponentLibProviderProps = {
+    baseTheme?: Theme;
+    theme?: ThemeOverride;
+    locale?: string;
+    messages?: I18nMessages;
+    missingKeyPolicy?: I18nMissingKeyPolicy;
+    loading?: LoadingDefaults;
+    children: React.ReactNode;
+};
+export declare function ComponentLibProvider({ baseTheme, theme, locale, messages, missingKeyPolicy, loading, children, }: ComponentLibProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=ComponentLibProvider.d.ts.map

package/dist/ComponentLibProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentLibProvider.d.ts","sourceRoot":"","sources":["../src/ComponentLibProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AAEpC,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIvE,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAIxF,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE1D,MAAM,MAAM,yBAAyB,GAAG;IAEtC,SAAS,CAAC,EAAE,KAAK,CAAC;IAElB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAKF,wBAAgB,oBAAoB,CAAC,EACnC,SAAS,EACT,KAAK,EACL,MAAM,EACN,QAAQ,EACR,gBAAgB,EAChB,OAAO,EACP,QAAQ,GACT,EAAE,yBAAyB,2CAoB3B"}

package/dist/ComponentLibProvider.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ComponentLibProvider = ComponentLibProvider;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const I18nProvider_1 = require("./i18n/I18nProvider");
+const index_1 = require("./services/ActionDialogService/index");
+const index_2 = require("./services/CardToastService/index");
+const index_3 = require("./services/ImagePreviewService/index");
+const index_4 = require("./services/LoadingService/index");
+const index_5 = require("./services/PermissionPurposeDialogService/index");
+const index_6 = require("./services/PickerService/index");
+const ThemeProvider_1 = require("./theme/ThemeProvider");
+// ComponentLibProvider 是组件库推荐的顶层 Provider：
+// - 同时提供 Theme 与 i18n
+// - 避免业务方在 App 里层层包裹多个 Provider
+function ComponentLibProvider({ baseTheme, theme, locale, messages, missingKeyPolicy, loading, children, }) {
+    return ((0, jsx_runtime_1.jsx)(ThemeProvider_1.ThemeProvider, { baseTheme: baseTheme, theme: theme, children: (0, jsx_runtime_1.jsx)(I18nProvider_1.I18nProvider, { locale: locale, messages: messages, missingKeyPolicy: missingKeyPolicy, children: (0, jsx_runtime_1.jsx)(index_6.PickerServiceProvider, { children: (0, jsx_runtime_1.jsx)(index_2.ToastProvider, { children: (0, jsx_runtime_1.jsx)(index_1.ActionDialogProvider, { children: (0, jsx_runtime_1.jsx)(index_4.LoadingProvider, { defaults: loading, children: (0, jsx_runtime_1.jsx)(index_5.PermissionPurposeDialogProvider, { children: (0, jsx_runtime_1.jsx)(index_3.ImagePreviewProvider, { children: children }) }) }) }) }) }) }) }));
+}

package/dist/assets/animations/spinner.json

@@ -0,0 +1 @@
+{"v":"5.7.5","fr":60,"ip":0,"op":61,"w":600,"h":600,"nm":"ios-spinner","ddd":0,"assets":[],"layers":[{"ddd":0,"ind":1,"ty":4,"nm":"1","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[100]},{"t":60,"s":[0]}],"ix":11},"r":{"a":0,"k":-180,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":2,"ty":4,"nm":"2","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[8]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":4,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":5,"s":[100]},{"t":60,"s":[8]}],"ix":11},"r":{"a":0,"k":-150,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":3,"ty":4,"nm":"3","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[16]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":9,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":10,"s":[100]},{"t":60,"s":[16]}],"ix":11},"r":{"a":0,"k":-120,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":4,"ty":4,"nm":"4","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[24]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":14,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":15,"s":[100]},{"t":60,"s":[24]}],"ix":11},"r":{"a":0,"k":-90,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":5,"ty":4,"nm":"5","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[32]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":19,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":20,"s":[100]},{"t":60,"s":[32]}],"ix":11},"r":{"a":0,"k":-60,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":6,"ty":4,"nm":"6","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[40]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":24,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":25,"s":[100]},{"t":60,"s":[40]}],"ix":11},"r":{"a":0,"k":-30,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":7,"ty":4,"nm":"7","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[48]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":29,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":30,"s":[100]},{"t":60,"s":[48]}],"ix":11},"r":{"a":0,"k":0,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":8,"ty":4,"nm":"8","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[56]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":34,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":35,"s":[100]},{"t":60,"s":[56]}],"ix":11},"r":{"a":0,"k":-330,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":9,"ty":4,"nm":"9","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[64]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":39,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":40,"s":[100]},{"t":60,"s":[64]}],"ix":11},"r":{"a":0,"k":-300,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":10,"ty":4,"nm":"10","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[72]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":44,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":45,"s":[100]},{"t":60,"s":[72]}],"ix":11},"r":{"a":0,"k":-270,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":11,"ty":4,"nm":"11","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[80]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":49,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":50,"s":[100]},{"t":60,"s":[80]}],"ix":11},"r":{"a":0,"k":-240,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0},{"ddd":0,"ind":12,"ty":4,"nm":"12","sr":1,"ks":{"o":{"a":1,"k":[{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":0,"s":[88]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":54,"s":[0]},{"i":{"x":[0.833],"y":[0.833]},"o":{"x":[0.167],"y":[0.167]},"t":55,"s":[100]},{"t":60,"s":[88]}],"ix":11},"r":{"a":0,"k":-210,"ix":10},"p":{"a":0,"k":[300,300,0],"ix":2,"l":2},"a":{"a":0,"k":[0,0,0],"ix":1,"l":2},"s":{"a":0,"k":[100,100,100],"ix":6,"l":2}},"ao":0,"shapes":[{"ty":"gr","it":[{"ind":0,"ty":"sh","ix":1,"ks":{"a":0,"k":{"i":[[0,0],[0,0]],"o":[[0,0],[0,0]],"v":[[13,22],[13,124]],"c":false},"ix":2},"nm":"Path 1","mn":"ADBE Vector Shape - Group","hd":false},{"ty":"st","c":{"a":0,"k":[0,0,0,1],"ix":3},"o":{"a":0,"k":100,"ix":4},"w":{"a":0,"k":40,"ix":5},"lc":2,"lj":1,"ml":4,"bm":0,"nm":"Stroke 1","mn":"ADBE Vector Graphic - Stroke","hd":false},{"ty":"tr","p":{"a":0,"k":[0,0],"ix":2},"a":{"a":0,"k":[11,-82],"ix":1},"s":{"a":0,"k":[100,100],"ix":3},"r":{"a":0,"k":0,"ix":6},"o":{"a":0,"k":100,"ix":7},"sk":{"a":0,"k":0,"ix":4},"sa":{"a":0,"k":0,"ix":5},"nm":"Transform"}],"nm":"Shape 1","np":2,"cix":2,"bm":0,"ix":1,"mn":"ADBE Vector Group","hd":false}],"ip":0,"op":61,"st":0,"bm":0}],"markers":[]}

package/dist/assets/icons/check.svg

@@ -0,0 +1,4 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+  <path d="M20 6L9 17L4 12" stroke="currentColor" stroke-width="3" stroke-linecap="round" stroke-linejoin="round"/>
+</svg>
+

package/dist/config.d.ts

@@ -0,0 +1,16 @@
+import type { Theme, ThemeOverride } from './theme/types';
+import type { I18nMessages, I18nMissingKeyPolicy } from './i18n/types';
+export type ComponentLibI18nConfig = {
+    locale?: string;
+    messages?: I18nMessages;
+    missingKeyPolicy?: I18nMissingKeyPolicy;
+};
+export type ComponentLibConfig = {
+    theme?: ThemeOverride;
+    i18n?: ComponentLibI18nConfig;
+};
+export declare function configureComponentLib(next: ComponentLibConfig): void;
+export declare function getComponentLibConfig(): ComponentLibConfig;
+export declare function getDefaultTheme(): Theme;
+export declare function getDefaultI18nConfig(): Required<ComponentLibI18nConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAQvE,MAAM,MAAM,sBAAsB,GAAG;IAEnC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,QAAQ,CAAC,EAAE,YAAY,CAAC;IAIxB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAE/B,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,IAAI,CAAC,EAAE,sBAAsB,CAAC;CAC/B,CAAC;AAKF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,kBAAkB,QAS7D;AAED,wBAAgB,qBAAqB,IAAI,kBAAkB,CAE1D;AAMD,wBAAgB,eAAe,IAAI,KAAK,CAEvC;AAKD,wBAAgB,oBAAoB,IAAI,QAAQ,CAAC,sBAAsB,CAAC,CAMvE"}

package/dist/config.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureComponentLib = configureComponentLib;
+exports.getComponentLibConfig = getComponentLibConfig;
+exports.getDefaultTheme = getDefaultTheme;
+exports.getDefaultI18nConfig = getDefaultI18nConfig;
+const defaultTheme_1 = require("./theme/defaultTheme");
+const mergeTheme_1 = require("./theme/mergeTheme");
+const locale_1 = require("./i18n/locale");
+let componentLibConfig = {};
+// 合并式更新：多次调用会按层级合并（不会把之前的 i18n 整块覆盖掉）
+function configureComponentLib(next) {
+    componentLibConfig = {
+        ...componentLibConfig,
+        ...next,
+        i18n: {
+            ...componentLibConfig.i18n,
+            ...next.i18n,
+        },
+    };
+}
+function getComponentLibConfig() {
+    return componentLibConfig;
+}
+// getDefaultTheme 用于生成“当前有效的默认主题”：
+// - defaultTheme 作为组件库内置基线
+// - configureComponentLib({ theme }) 提供全局覆盖
+// - ThemeProvider({ theme }) 再做实例级覆盖（优先级更高）
+function getDefaultTheme() {
+    return (0, mergeTheme_1.mergeTheme)(defaultTheme_1.defaultTheme, componentLibConfig.theme);
+}
+// getDefaultI18nConfig 用于生成“当前有效的默认 i18n 配置”：
+// - configureComponentLib({ i18n }) 可在应用启动时设定默认 locale/messages
+// - I18nProvider({ ... }) 可在局部覆盖（例如某个子树临时切换语言）
+function getDefaultI18nConfig() {
+    var _a, _b, _c, _d, _e, _f;
+    return {
+        locale: (_b = (_a = componentLibConfig.i18n) === null || _a === void 0 ? void 0 : _a.locale) !== null && _b !== void 0 ? _b : (0, locale_1.resolveSystemBuiltinLocale)(),
+        messages: (_d = (_c = componentLibConfig.i18n) === null || _c === void 0 ? void 0 : _c.messages) !== null && _d !== void 0 ? _d : {},
+        missingKeyPolicy: (_f = (_e = componentLibConfig.i18n) === null || _e === void 0 ? void 0 : _e.missingKeyPolicy) !== null && _f !== void 0 ? _f : 'key',
+    };
+}

package/dist/i18n/I18nProvider.d.ts

@@ -0,0 +1,11 @@
+import * as React from 'react';
+import type { I18nContextValue, I18nMessages, I18nMissingKeyPolicy } from './types';
+export declare const I18nContext: React.Context<I18nContextValue>;
+export type I18nProviderProps = {
+    locale?: string;
+    messages?: I18nMessages;
+    missingKeyPolicy?: I18nMissingKeyPolicy;
+    children: React.ReactNode;
+};
+export declare function I18nProvider({ locale, messages, missingKeyPolicy, children }: I18nProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=I18nProvider.d.ts.map

package/dist/i18n/I18nProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"I18nProvider.d.ts","sourceRoot":"","sources":["../../src/i18n/I18nProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EAGrB,MAAM,SAAS,CAAC;AAyCjB,eAAO,MAAM,WAAW,iCAEtB,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,gBAAgB,CAAC,EAAE,oBAAoB,CAAC;IACxC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B,CAAC;AAEF,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,EAAE,iBAAiB,2CAM/F"}

package/dist/i18n/I18nProvider.js

@@ -0,0 +1,84 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.I18nContext = void 0;
+exports.I18nProvider = I18nProvider;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const React = __importStar(require("react"));
+const config_1 = require("../config");
+const locale_1 = require("./locale");
+const locales_1 = require("./locales");
+function interpolate(template, params) {
+    if (!params)
+        return template;
+    return template.replace(/\{(\w+)\}/g, (full, key) => {
+        const value = params[key];
+        if (value === undefined || value === null)
+            return full;
+        return String(value);
+    });
+}
+function createTranslator(messages, missingKeyPolicy) {
+    return (key, params) => {
+        const raw = messages[key];
+        if (raw == null) {
+            if (missingKeyPolicy === 'throw') {
+                throw new Error(`[zkit-ui] Missing i18n key: ${key}`);
+            }
+            return key;
+        }
+        return interpolate(raw, params);
+    };
+}
+function resolveI18nValue(base, override) {
+    var _a, _b, _c, _d;
+    const locale = (_a = override === null || override === void 0 ? void 0 : override.locale) !== null && _a !== void 0 ? _a : base.locale;
+    // 优先级：override.messages > base.messages > 内置语言包
+    const builtinMessages = (_b = locales_1.locales[(0, locale_1.resolveBuiltinLocale)(locale)]) !== null && _b !== void 0 ? _b : {};
+    const messages = { ...builtinMessages, ...base.messages, ...((_c = override === null || override === void 0 ? void 0 : override.messages) !== null && _c !== void 0 ? _c : {}) };
+    const missingKeyPolicy = (_d = override === null || override === void 0 ? void 0 : override.missingKeyPolicy) !== null && _d !== void 0 ? _d : base.missingKeyPolicy;
+    const t = createTranslator(messages, missingKeyPolicy);
+    return { locale, messages, missingKeyPolicy, t };
+}
+exports.I18nContext = React.createContext({
+    ...resolveI18nValue((0, config_1.getDefaultI18nConfig)()),
+});
+function I18nProvider({ locale, messages, missingKeyPolicy, children }) {
+    const value = React.useMemo(() => {
+        const base = (0, config_1.getDefaultI18nConfig)();
+        return resolveI18nValue(base, { locale, messages, missingKeyPolicy });
+    }, [locale, messages, missingKeyPolicy]);
+    return (0, jsx_runtime_1.jsx)(exports.I18nContext.Provider, { value: value, children: children });
+}

package/dist/i18n/locale.d.ts

@@ -0,0 +1,7 @@
+export declare const DEFAULT_I18N_LOCALE = "zh-CN";
+export declare const BUILTIN_I18N_LOCALES: readonly ["zh-CN", "zh-TW", "ja", "en-US", "de"];
+export type BuiltinI18nLocale = (typeof BUILTIN_I18N_LOCALES)[number];
+export declare function resolveBuiltinLocale(locale?: string | null): BuiltinI18nLocale;
+export declare function getSystemLocale(): string | undefined;
+export declare function resolveSystemBuiltinLocale(): "zh-CN" | "zh-TW" | "ja" | "en-US" | "de";
+//# sourceMappingURL=locale.d.ts.map

package/dist/i18n/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/i18n/locale.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,UAAU,CAAC;AAE3C,eAAO,MAAM,oBAAoB,kDAAmD,CAAC;AAGrF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAsEtE,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,CAE9E;AAiBD,wBAAgB,eAAe,uBAE9B;AAED,wBAAgB,0BAA0B,8CAOzC"}