@eternalheart/react-file-preview 1.2.0 → 1.3.1

package/README.md

@@ -307,7 +307,27 @@ const files = [
 ### Code & Text
 - **Markdown**: GitHub Flavored Markdown, code highlighting
 - **Code Files**: JS, TS, Python, Java, C++, Go, Rust, and 40+ languages
-- **Text Files**: TXT, LOG, CSV, JSON, YAML, XML, etc.
+- **Config/Logs**: YAML, TOML, INI, ENV, LOG, DIFF, PATCH, etc.
+
+### Structured Data
+- **JSON**: Auto formatting + syntax highlighting
+- **CSV/TSV**: Zero-dependency parser, table view with headers and row/column stats
+- **XML**: `DOMParser` validation + pretty print + syntax highlighting
+
+### Subtitles & Lyrics
+- **SRT / WebVTT**: Zero-dependency parser, structured cue list (index, time range, text)
+- **LRC / Enhanced LRC**: Lyric files with `[mm:ss.xx]` line stamps (and inline `<mm:ss.xx>` per-word stamps for ELRC), with `[ti:][ar:][al:]` metadata header
+- **ASS / SSA**: Advanced SubStation Alpha — extracts Dialogue events, strips `\N` `\h` and `{...}` override codes, surfaces Style names
+- **TTML / DFXP**: W3C / Apple Music XML captions, supports `begin` / `end` / `dur` and `<br/>`
+
+### Archives
+- **ZIP**: Tree view + inline preview for text/code/image entries, download fallback for other types
+
+### Outlook Email
+- **MSG**: Headers, body rendering, attachment list
+
+### E-books
+- **EPUB**: Chapter navigation, pagination
 
 ## 🎮 API Reference
 
@@ -321,6 +341,8 @@ const files = [
 | `onClose` | `() => void` | ✅ | Close callback |
 | `onNavigate` | `(index: number) => void` | ❌ | Navigation callback |
 | `customRenderers` | `CustomRenderer[]` | ❌ | Custom renderers for specific file types |
+| `locale` | `Locale` | ❌ | UI language (`'zh-CN'` default, `'en-US'` built-in) |
+| `messages` | `Partial<Record<Locale, Partial<Messages>>>` | ❌ | Custom translation overrides |
 
 ### FilePreviewEmbed Props
 
@@ -334,6 +356,8 @@ const files = [
 | `height` | `number \| string` | ❌ | `'100%'` | Container height |
 | `className` | `string` | ❌ | - | Extra class on the root wrapper |
 | `style` | `CSSProperties` | ❌ | - | Extra inline style on the root wrapper |
+| `locale` | `Locale` | ❌ | `'zh-CN'` | UI language (`'zh-CN'` or `'en-US'`) |
+| `messages` | `Partial<Record<Locale, Partial<Messages>>>` | ❌ | - | Custom translation overrides |
 
 > `FilePreviewEmbed` has no `isOpen` / `onClose`. To hide/show it, conditionally render it from the parent. It also hides the close button in the toolbar.
 
@@ -422,7 +446,48 @@ const files = [
 #### Text Files
 - **Markdown**: File extensions `.md` or `.markdown`
 - **Code**: Auto-detected by file extension (`.js`, `.ts`, `.py`, `.java`, etc.)
-- **Plain Text**: `text/plain`, `text/csv`, etc.
+- **Config / Logs**: `.yaml`, `.yml`, `.toml`, `.ini`, `.conf`, `.env`, `.log`, `.diff`, `.patch`
+- **Plain Text**: `text/plain`
+
+#### Structured Data
+- **JSON**: `application/json` (.json)
+- **CSV / TSV**: `text/csv` (.csv), `text/tab-separated-values` (.tsv)
+- **XML**: `application/xml`, `text/xml` (.xml)
+
+#### Subtitles & Lyrics
+- **SRT**: `application/x-subrip` (.srt)
+- **WebVTT**: `text/vtt` (.vtt)
+- **LRC**: (.lrc)
+- **Enhanced LRC**: (.elrc)
+- **ASS / SSA**: (.ass, .ssa)
+- **TTML / DFXP**: `application/ttml+xml` (.ttml, .dfxp)
+
+#### Archives
+- **ZIP**: `application/zip`, `application/x-zip-compressed` (.zip)
+
+#### Outlook Email
+- **MSG**: `application/vnd.ms-outlook` (.msg)
+
+#### E-books
+- **EPUB**: `application/epub+zip` (.epub)
+
+## 🌐 Internationalization (i18n)
+
+Built-in support for Chinese (default) and English. Zero external dependencies.
+
+```tsx
+// Switch to English
+<FilePreviewModal files={files} locale="en-US" ... />
+
+// Override specific translations
+<FilePreviewModal
+  files={files}
+  locale="en-US"
+  messages={{ 'en-US': { 'toolbar.zoom_in': 'Zoom ++' } }}
+/>
+```
+
+Use `useTranslator()` hook in custom renderers to access the translation function.
 
 ## 🎨 Custom Styling
 

package/README.zh-CN.md

@@ -305,7 +305,27 @@ const files = [
 ### 代码 & 文本
 - **Markdown**: GitHub Flavored Markdown,代码高亮
 - **代码文件**: JS, TS, Python, Java, C++, Go, Rust 等 40+ 种语言
-- **文本文件**: TXT, LOG, CSV, JSON, YAML, XML 等
+- **配置 / 日志**: YAML, TOML, INI, ENV, LOG, DIFF, PATCH 等
+
+### 结构化数据
+- **JSON**: 自动格式化 + 语法高亮
+- **CSV / TSV**: 零依赖解析,表格视图 + 行列统计
+- **XML**: `DOMParser` 校验 + 自动缩进 + 语法高亮
+
+### 字幕 / 歌词
+- **SRT / WebVTT**: 零依赖解析,结构化 cue 列表(索引、时间区间、文本)
+- **LRC / Enhanced LRC**: 歌词文件,`[mm:ss.xx]` 行时间戳(ELRC 额外支持行内 `<mm:ss.xx>` 逐字时间戳),自动解析 `[ti:][ar:][al:]` 等元数据
+- **ASS / SSA**: Advanced SubStation Alpha,提取 Dialogue 事件,自动剥离 `\N` `\h` 与 `{...}` 样式覆盖码,展示 Style 标签
+- **TTML / DFXP**: W3C / Apple Music 使用的 XML 字幕,支持 `begin` / `end` / `dur` 与 `<br/>`
+
+### 压缩包
+- **ZIP**: 树形目录 + 内嵌预览文本/代码/图片,其他类型可下载导出
+
+### Outlook 邮件
+- **MSG**: 邮件头、正文、附件列表
+
+### 电子书
+- **EPUB**: 章节导航、翻页
 
 ## 🎮 API 参考
 
@@ -319,6 +339,8 @@ const files = [
 | `onClose` | `() => void` | ✅ | 关闭回调 |
 | `onNavigate` | `(index: number) => void` | ❌ | 导航回调 |
 | `customRenderers` | `CustomRenderer[]` | ❌ | 自定义渲染器 |
+| `locale` | `Locale` | ❌ | 界面语言（默认 `'zh-CN'`，内置 `'en-US'`） |
+| `messages` | `Partial<Record<Locale, Partial<Messages>>>` | ❌ | 自定义翻译覆盖 |
 
 ### FilePreviewEmbed Props
 
@@ -332,6 +354,8 @@ const files = [
 | `height` | `number \| string` | ❌ | `'100%'` | 容器高度 |
 | `className` | `string` | ❌ | - | 根节点额外 className |
 | `style` | `CSSProperties` | ❌ | - | 根节点额外内联样式 |
+| `locale` | `Locale` | ❌ | `'zh-CN'` | 界面语言（`'zh-CN'` 或 `'en-US'`） |
+| `messages` | `Partial<Record<Locale, Partial<Messages>>>` | ❌ | - | 自定义翻译覆盖 |
 
 > `FilePreviewEmbed` 没有 `isOpen` / `onClose`,若要显示/隐藏,请在父组件中条件渲染。同时它不会显示工具栏上的关闭按钮。
 
@@ -420,7 +444,48 @@ const files = [
 #### 文本文件
 - **Markdown**: 文件扩展名 `.md` 或 `.markdown`
 - **代码**: 根据文件扩展名自动识别 (`.js`, `.ts`, `.py`, `.java`, 等)
-- **纯文本**: `text/plain`, `text/csv`, 等
+- **配置 / 日志**: `.yaml`, `.yml`, `.toml`, `.ini`, `.conf`, `.env`, `.log`, `.diff`, `.patch`
+- **纯文本**: `text/plain`
+
+#### 结构化数据
+- **JSON**: `application/json` (.json)
+- **CSV / TSV**: `text/csv` (.csv), `text/tab-separated-values` (.tsv)
+- **XML**: `application/xml`, `text/xml` (.xml)
+
+#### 字幕 / 歌词
+- **SRT**: `application/x-subrip` (.srt)
+- **WebVTT**: `text/vtt` (.vtt)
+- **LRC**: (.lrc)
+- **Enhanced LRC**: (.elrc)
+- **ASS / SSA**: (.ass, .ssa)
+- **TTML / DFXP**: `application/ttml+xml` (.ttml, .dfxp)
+
+#### 压缩包
+- **ZIP**: `application/zip`, `application/x-zip-compressed` (.zip)
+
+#### Outlook 邮件
+- **MSG**: `application/vnd.ms-outlook` (.msg)
+
+#### 电子书
+- **EPUB**: `application/epub+zip` (.epub)
+
+## 🌐 国际化（i18n）
+
+内置中文（默认）和英文，零外部依赖。
+
+```tsx
+// 切换为英文
+<FilePreviewModal files={files} locale="en-US" ... />
+
+// 自定义覆盖某些翻译
+<FilePreviewModal
+  files={files}
+  locale="en-US"
+  messages={{ 'en-US': { 'toolbar.zoom_in': 'Zoom ++' } }}
+/>
+```
+
+在自定义渲染器中可通过 `useTranslator()` hook 获取翻译函数。
 
 ## 🎨 自定义样式
 

package/lib/FilePreviewContent.d.ts

@@ -1,4 +1,5 @@
 import React from 'react';
+import { type Locale, type Messages } from '@eternalheart/file-preview-core';
 import { PreviewFileInput, CustomRenderer } from './types';
 export interface FilePreviewContentProps {
     files: PreviewFileInput[];
@@ -9,6 +10,12 @@ export interface FilePreviewContentProps {
     mode?: 'modal' | 'embed';
     /** 关闭回调,仅 modal 模式使用 */
     onClose?: () => void;
+    /** ZIP 嵌套深度（内部使用），超过上限时不再递归渲染 ZIP */
+    zipNestingDepth?: number;
+    /** 国际化语言，默认 'zh-CN' */
+    locale?: Locale;
+    /** 用户自定义翻译字典，浅合并到内置字典之上 */
+    messages?: Partial<Record<Locale, Partial<Messages>>>;
 }
 export declare const FilePreviewContent: React.FC<FilePreviewContentProps>;
 //# sourceMappingURL=FilePreviewContent.d.ts.map

package/lib/FilePreviewContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilePreviewContent.d.ts","sourceRoot":"","sources":["../src/FilePreviewContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAQjF,OAAO,EAAe,gBAAgB,EAAY,cAAc,EAAE,MAAM,SAAS,CAAC;AAiBlF,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAqDD,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAiZhE,CAAC"}
+{"version":3,"file":"FilePreviewContent.d.ts","sourceRoot":"","sources":["../src/FilePreviewContent.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4D,MAAM,OAAO,CAAC;AAGjF,OAAO,EAAiC,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAmB,MAAM,iCAAiC,CAAC;AAU7H,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAyB3D,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IACzB,wBAAwB;IACxB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAqehE,CAAC"}

package/lib/FilePreviewEmbed.d.ts

@@ -1,4 +1,5 @@
 import { PreviewFileInput, CustomRenderer } from './types';
+import type { Locale, Messages } from '@eternalheart/file-preview-core';
 interface FilePreviewEmbedProps {
     files: PreviewFileInput[];
     currentIndex?: number;
@@ -10,6 +11,10 @@ interface FilePreviewEmbedProps {
     height?: number | string;
     className?: string;
     style?: React.CSSProperties;
+    /** 国际化语言，默认 'zh-CN' */
+    locale?: Locale;
+    /** 用户自定义翻译字典 */
+    messages?: Partial<Record<Locale, Partial<Messages>>>;
 }
 export declare const FilePreviewEmbed: React.FC<FilePreviewEmbedProps>;
 export {};

package/lib/FilePreviewEmbed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilePreviewEmbed.d.ts","sourceRoot":"","sources":["../src/FilePreviewEmbed.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG3D,UAAU,qBAAqB;IAC7B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA0B5D,CAAC"}
+{"version":3,"file":"FilePreviewEmbed.d.ts","sourceRoot":"","sources":["../src/FilePreviewEmbed.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAExE,UAAU,qBAAqB;IAC7B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,uBAAuB;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;IAC5B,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA8B5D,CAAC"}

package/lib/FilePreviewModal.d.ts

@@ -1,4 +1,5 @@
 import { PreviewFileInput, CustomRenderer } from './types';
+import type { Locale, Messages } from '@eternalheart/file-preview-core';
 interface FilePreviewModalProps {
     files: PreviewFileInput[];
     currentIndex: number;
@@ -6,6 +7,10 @@ interface FilePreviewModalProps {
     onClose: () => void;
     onNavigate?: (index: number) => void;
     customRenderers?: CustomRenderer[];
+    /** 国际化语言，默认 'zh-CN' */
+    locale?: Locale;
+    /** 用户自定义翻译字典 */
+    messages?: Partial<Record<Locale, Partial<Messages>>>;
 }
 export declare const FilePreviewModal: React.FC<FilePreviewModalProps>;
 export {};

package/lib/FilePreviewModal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FilePreviewModal.d.ts","sourceRoot":"","sources":["../src/FilePreviewModal.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG3D,UAAU,qBAAqB;IAC7B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CA8D5D,CAAC"}
+{"version":3,"file":"FilePreviewModal.d.ts","sourceRoot":"","sources":["../src/FilePreviewModal.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE3D,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAExE,UAAU,qBAAqB;IAC7B,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;CACvD;AAED,eAAO,MAAM,gBAAgB,EAAE,KAAK,CAAC,EAAE,CAAC,qBAAqB,CAkE5D,CAAC"}

package/lib/components/ResizableSplit.d.ts

@@ -0,0 +1,29 @@
+import React from 'react';
+export interface ResizableSplitProps {
+    /** 左侧内容 */
+    left: React.ReactNode;
+    /** 右侧内容 */
+    right: React.ReactNode;
+    /** 左侧初始宽度（px）；传入 storageKey 时会从 localStorage 读取 */
+    initialLeftWidth?: number;
+    /** 左侧最小宽度（px） */
+    minLeftWidth?: number;
+    /** 左侧最大宽度（px），同时不超过 `容器宽 - minRightWidth - 分隔线宽` */
+    maxLeftWidth?: number;
+    /** 右侧至少保留的宽度（px） */
+    minRightWidth?: number;
+    /** localStorage 持久化 key；不传则不持久化 */
+    storageKey?: string;
+    /** 启用横向拖动的媒体查询，默认 `(min-width: 768px)` */
+    desktopMedia?: string;
+    /** 容器额外类名 */
+    className?: string;
+}
+/**
+ * 通用可拖动分隔布局：
+ * - 桌面端（由 `desktopMedia` 判定）横向分两栏，中间分隔线可左右拖动调整左栏宽度
+ * - 移动端退化为上下堆叠，不显示分隔线
+ * - 可选 `storageKey` 将宽度持久化到 localStorage
+ */
+export declare const ResizableSplit: React.FC<ResizableSplitProps>;
+//# sourceMappingURL=ResizableSplit.d.ts.map

package/lib/components/ResizableSplit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResizableSplit.d.ts","sourceRoot":"","sources":["../../src/components/ResizableSplit.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AAExE,MAAM,WAAW,mBAAmB;IAClC,WAAW;IACX,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC;IACtB,WAAW;IACX,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC;IACvB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAoGxD,CAAC"}

package/lib/i18n/LocaleContext.d.ts

@@ -0,0 +1,25 @@
+import React from 'react';
+import { type Locale, type Messages, type Translator } from '@eternalheart/file-preview-core';
+export interface LocaleContextValue {
+    locale: Locale;
+    t: Translator;
+}
+export interface LocaleProviderProps {
+    /** 当前语言，默认 'zh-CN' */
+    locale?: Locale;
+    /** 用户自定义字典，浅合并到内置字典之上 */
+    messages?: Partial<Record<Locale, Partial<Messages>>>;
+    children: React.ReactNode;
+}
+export declare const LocaleProvider: React.FC<LocaleProviderProps>;
+/**
+ * 获取翻译函数。任意位置调用都安全：
+ * - 在 LocaleProvider 下 → 用 provider 提供的 translator
+ * - 否则 → 回落到 zh-CN 兜底 translator
+ */
+export declare function useTranslator(): Translator;
+/**
+ * 获取当前 locale。在 Provider 之外返回 'zh-CN'。
+ */
+export declare function useLocale(): Locale;
+//# sourceMappingURL=LocaleContext.d.ts.map

package/lib/i18n/LocaleContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocaleContext.d.ts","sourceRoot":"","sources":["../../src/i18n/LocaleContext.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA6C,MAAM,OAAO,CAAC;AAClE,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,QAAQ,EACb,KAAK,UAAU,EAChB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,EAAE,UAAU,CAAC;CACf;AAID,MAAM,WAAW,mBAAmB;IAClC,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACtD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAWxD,CAAC;AAcF;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,UAAU,CAG1C;AAED;;GAEG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAGlC"}