@4399ywkf/editor 0.5.0 → 0.7.0

package/dist/{chunk-L6ZR5HHW.js → chunk-SYCK6Y5F.js}

@@ -3,26 +3,29 @@ import { jsx } from 'react/jsx-runtime';
 
 // src/views/SheetView.tsx
 function SheetView({
+  source,
   content,
   readOnly,
   className,
   sheet,
   onReady,
-  onError
+  onError,
+  onWarnings
 }) {
   const hostRef = useRef(null);
   const disposeRef = useRef(null);
-  const latest = useRef({ sheet, onReady, onError });
+  const latest = useRef({ sheet, onReady, onError, onWarnings });
   useEffect(() => {
-    latest.current = { sheet, onReady, onError };
+    latest.current = { sheet, onReady, onError, onWarnings };
   });
   useEffect(() => {
     let cancelled = false;
     const host = hostRef.current;
     if (!host) return;
     (async () => {
-      const { sheet: opts, onReady: ready, onError: fail } = latest.current;
+      const { sheet: opts, onReady: ready, onError: fail, onWarnings: warn } = latest.current;
       try {
+        const importPromise = !content && source ? import('./import-GVZDLWA2.js').then((m) => m.importSheetSource(source)) : null;
         const [{ createUniver, LocaleType, merge }, sheetsCore, zhCN] = await Promise.all([
           import('@univerjs/presets'),
           import('@univerjs/presets/preset-sheets-core'),
@@ -47,6 +50,8 @@ function SheetView({
         }
         if (opts?.presets?.length) presets.push(...opts.presets);
         if (opts?.locales?.length) locales.push(...opts.locales);
+        const imported = importPromise ? await importPromise : null;
+        if (cancelled) return;
         const { univerAPI, univer } = createUniver({
           locale: LocaleType.ZH_CN,
           // createUniver 不会自动收集 preset 自带的 locales，得在这里一起合进来，
@@ -56,16 +61,16 @@ function SheetView({
         });
         const dispose = () => univer.dispose();
         if (cancelled) return dispose();
-        if (content) univerAPI.createWorkbook(content);
-        else univerAPI.createWorkbook({});
+        univerAPI.createWorkbook(content ?? imported?.workbook ?? {});
         if (readOnly) univerAPI.getActiveWorkbook?.()?.setEditable?.(false);
+        if (imported?.warnings.length) warn?.(imported.warnings);
         disposeRef.current = dispose;
         ready?.(univerAPI);
       } catch (e) {
         const err = e instanceof Error ? e : new Error(String(e));
         fail?.(
           new Error(
-            `表格引擎加载失败：${err.message}。请确认已安装可选依赖 @univerjs/presets（pnpm add @univerjs/presets）`
+            `表格加载失败：${err.message}。若是引擎缺失，请确认已安装可选依赖 @univerjs/presets（pnpm add @univerjs/presets）`
           )
         );
       }
@@ -75,10 +80,10 @@ function SheetView({
       disposeRef.current?.();
       disposeRef.current = null;
     };
-  }, [content, readOnly]);
+  }, [source, content, readOnly]);
   return /* @__PURE__ */ jsx("div", { ref: hostRef, className, style: { width: "100%", height: "100%" } });
 }
 
 export { SheetView };
-//# sourceMappingURL=chunk-L6ZR5HHW.js.map
-//# sourceMappingURL=chunk-L6ZR5HHW.js.map
+//# sourceMappingURL=chunk-SYCK6Y5F.js.map
+//# sourceMappingURL=chunk-SYCK6Y5F.js.map

package/dist/chunk-SYCK6Y5F.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/views/SheetView.tsx"],"names":[],"mappings":"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","file":"chunk-SYCK6Y5F.js","sourcesContent":["import { useEffect, useRef } from \"react\"\nimport type { DocumentViewProps } from \"../registry\"\nimport type { SheetUiOptions } from \"../sheet-options\"\n\n/**\n * sheet 通道：Univer 适配。\n *\n * 只用 Apache-2.0 的 OSS 核心。**不碰** `@univerjs-pro/*` 与 `univer-cli`：\n * 前者要自建 Univer Server 且需商业授权，后者 63MB、license 字段为 None、\n * 90/91 个 JS 被混淆、还会向 univer.ai 上报遥测 —— 不能进生产链路。\n *\n * 导入导出都在本包 `./xlsx`：导出直接读 Univer 快照拼 OOXML，导入把\n * xlsx/csv/tsv 解析成快照（`source` prop 走的就是这条路，File / Blob / URL\n * 都收）。两个方向都不引 SheetJS，文档不出内网。导入丢了什么（图片、\n * 条件格式等独立部件）通过 `onWarnings` 如实报告。\n *\n * 配置见 `SheetOptions`：UI 开关直接透传给 preset（Univer 的 class 是\n * `univer-` 前缀的原子类，没有稳定选择器，CSS 硬藏靠不住），额外能力靠追加 preset。\n */\nexport default function SheetView({\n  source,\n  content,\n  readOnly,\n  className,\n  sheet,\n  onReady,\n  onError,\n  onWarnings,\n}: DocumentViewProps) {\n  const hostRef = useRef<HTMLDivElement>(null)\n  const disposeRef = useRef<(() => void) | null>(null)\n\n  // 这几项都是「创建时读一次」的，且宿主多半传内联字面量/箭头函数。\n  // 放进依赖数组 = 父组件每渲染一次就重建一次引擎（重下 871KB + 丢选区滚动位置），\n  // 所以走 ref：取最新值，但不参与依赖比较。\n  const latest = useRef({ sheet, onReady, onError, onWarnings })\n  useEffect(() => {\n    latest.current = { sheet, onReady, onError, onWarnings }\n  })\n\n  useEffect(() => {\n    let cancelled = false\n    const host = hostRef.current\n    if (!host) return\n\n    ;(async () => {\n      const { sheet: opts, onReady: ready, onError: fail, onWarnings: warn } = latest.current\n      try {\n        // source 的解析和 871KB 引擎的下载并行：两边都是网络/CPU 大头，串行纯浪费。\n        // content 优先于 source —— 已有快照就没有「导入」这回事\n        const importPromise =\n          !content && source\n            ? import(\"../xlsx/import\").then((m) => m.importSheetSource(source))\n            : null\n\n        // 动态 import：871KB gzip 的引擎只在真的打开表格时才下载\n        const [{ createUniver, LocaleType, merge }, sheetsCore, zhCN] = await Promise.all([\n          import(\"@univerjs/presets\"),\n          import(\"@univerjs/presets/preset-sheets-core\"),\n          import(\"@univerjs/presets/preset-sheets-core/locales/zh-CN\"),\n        ])\n        if (cancelled) return\n\n        // 只读时默认摘掉工具栏：整条 ribbon 全是死按钮，窄面板里还挤。\n        // 宿主显式传了 toolbar 就以宿主为准。\n        const ui: SheetUiOptions = { ...(readOnly ? { toolbar: false } : null), ...opts?.ui }\n\n        // 可选 peer：@univerjs/presets 未安装时这里的类型解析不到，\n        // 统一用 never 过桥，运行时由外层 try/catch 兜底并给出可读提示\n        const presets: unknown[] = [\n          (\n            sheetsCore as unknown as { UniverSheetsCorePreset: (o: object) => never }\n          ).UniverSheetsCorePreset({ container: host, ...ui }),\n        ]\n        const locales: unknown[] = [(zhCN as unknown as { default: object }).default]\n\n        if (opts?.findReplace) {\n          // preset-sheets-find-replace 是 @univerjs/presets 自己的 dependency，\n          // 走子路径不需要宿主再装包；没开就完全不下载。\n          const [findReplace, findReplaceZhCN] = await Promise.all([\n            import(\"@univerjs/presets/preset-sheets-find-replace\"),\n            import(\"@univerjs/presets/preset-sheets-find-replace/locales/zh-CN\"),\n          ])\n          if (cancelled) return\n          presets.push(\n            (\n              findReplace as unknown as { UniverSheetsFindReplacePreset: () => never }\n            ).UniverSheetsFindReplacePreset(),\n          )\n          locales.push((findReplaceZhCN as unknown as { default: object }).default)\n        }\n\n        if (opts?.presets?.length) presets.push(...opts.presets)\n        if (opts?.locales?.length) locales.push(...opts.locales)\n\n        // 导入失败不该等引擎起完才报：在创建引擎前结算，抛给外层统一 fail\n        const imported = importPromise ? await importPromise : null\n        if (cancelled) return\n\n        const { univerAPI, univer } = createUniver({\n          locale: LocaleType.ZH_CN,\n          // createUniver 不会自动收集 preset 自带的 locales，得在这里一起合进来，\n          // 否则新加的 preset 菜单会显示成原始 i18n key\n          locales: { [LocaleType.ZH_CN]: merge({}, ...(locales as object[])) },\n          presets: presets as never,\n        })\n\n        const dispose = () => (univer as unknown as { dispose: () => void }).dispose()\n        // 卸载可能发生在上面任一个 await 期间：那时 cleanup 拿到的 disposeRef 还是 null，\n        // 不在这儿自己收掉，引擎就挂在一个已脱离文档的 host 上泄漏了\n        if (cancelled) return dispose()\n\n        univerAPI.createWorkbook((content ?? imported?.workbook ?? {}) as never)\n        if (readOnly) univerAPI.getActiveWorkbook?.()?.setEditable?.(false)\n        if (imported?.warnings.length) warn?.(imported.warnings)\n\n        disposeRef.current = dispose\n        ready?.(univerAPI)\n      } catch (e) {\n        const err = e instanceof Error ? e : new Error(String(e))\n        fail?.(\n          new Error(\n            `表格加载失败：${err.message}。` +\n              `若是引擎缺失，请确认已安装可选依赖 @univerjs/presets（pnpm add @univerjs/presets）`,\n          ),\n        )\n      }\n    })()\n\n    return () => {\n      cancelled = true\n      disposeRef.current?.()\n      disposeRef.current = null\n    }\n  }, [source, content, readOnly])\n\n  return <div ref={hostRef} className={className} style={{ width: \"100%\", height: \"100%\" }} />\n}\n"]}

package/dist/chunk-WF7PIIFR.js

@@ -0,0 +1,21 @@
+// src/xlsx/snapshot.ts
+function snapshotFromUniver(univerAPI) {
+  const api = univerAPI;
+  const book = api?.getActiveWorkbook?.();
+  if (!book) throw new Error("拿不到当前工作簿：univerAPI 无效，或表格尚未就绪");
+  const snapshot = book.getSnapshot?.() ?? book.save?.();
+  if (!snapshot || typeof snapshot !== "object") {
+    throw new Error("当前 Univer 版本没有 getSnapshot() / save()，无法取快照");
+  }
+  return snapshot;
+}
+function toSnapshot(source) {
+  const maybe = source;
+  if (maybe && typeof maybe === "object" && ("sheets" in maybe || "sheetOrder" in maybe))
+    return maybe;
+  return snapshotFromUniver(source);
+}
+
+export { snapshotFromUniver, toSnapshot };
+//# sourceMappingURL=chunk-WF7PIIFR.js.map
+//# sourceMappingURL=chunk-WF7PIIFR.js.map

package/dist/chunk-WF7PIIFR.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/xlsx/snapshot.ts"],"names":[],"mappings":";AASO,SAAS,mBAAmB,SAAA,EAAkC;AACnE,EAAA,MAAM,GAAA,GAAM,SAAA;AAGZ,EAAA,MAAM,IAAA,GAAO,KAAK,iBAAA,IAAoB;AACtC,EAAA,IAAI,CAAC,IAAA,EAAM,MAAM,IAAI,MAAM,+BAA+B,CAAA;AAC1D,EAAA,MAAM,QAAA,GAAW,IAAA,CAAK,WAAA,IAAc,IAAK,KAAK,IAAA,IAAO;AACrD,EAAA,IAAI,CAAC,QAAA,IAAY,OAAO,QAAA,KAAa,QAAA,EAAU;AAC7C,IAAA,MAAM,IAAI,MAAM,6CAA6C,CAAA;AAAA,EAC/D;AACA,EAAA,OAAO,QAAA;AACT;AAGO,SAAS,WAAW,MAAA,EAA8C;AACvE,EAAA,MAAM,KAAA,GAAQ,MAAA;AACd,EAAA,IAAI,SAAS,OAAO,KAAA,KAAU,QAAA,KAAa,QAAA,IAAY,SAAS,YAAA,IAAgB,KAAA,CAAA;AAC9E,IAAA,OAAO,KAAA;AACT,EAAA,OAAO,mBAAmB,MAAM,CAAA;AAClC","file":"chunk-WF7PIIFR.js","sourcesContent":["/** 从 Univer 实例取快照。xlsx 与 csv 两条导出路径共用。 */\n\nimport type { WorkbookData } from \"./types.ts\"\n\n/**\n * 参数类型是 `unknown` 而不是 `FUniver`：`@univerjs/presets` 是可选 peer，\n * 写成具体类型会让没装它的项目 typecheck 直接红。运行时按 facade 的两个\n * 方法名依次试探（`getSnapshot` 是新名字，`save` 是旧的）。\n */\nexport function snapshotFromUniver(univerAPI: unknown): WorkbookData {\n  const api = univerAPI as {\n    getActiveWorkbook?: () => { getSnapshot?: () => unknown; save?: () => unknown } | null\n  } | null\n  const book = api?.getActiveWorkbook?.()\n  if (!book) throw new Error(\"拿不到当前工作簿：univerAPI 无效，或表格尚未就绪\")\n  const snapshot = book.getSnapshot?.() ?? book.save?.()\n  if (!snapshot || typeof snapshot !== \"object\") {\n    throw new Error(\"当前 Univer 版本没有 getSnapshot() / save()，无法取快照\")\n  }\n  return snapshot as WorkbookData\n}\n\n/** 快照或 Univer 实例都收 —— 调用方不必自己判断手里是什么 */\nexport function toSnapshot(source: WorkbookData | unknown): WorkbookData {\n  const maybe = source as WorkbookData\n  if (maybe && typeof maybe === \"object\" && (\"sheets\" in maybe || \"sheetOrder\" in maybe))\n    return maybe\n  return snapshotFromUniver(source)\n}\n"]}

package/dist/csv-parse-D0zTBvDB.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Univer 快照的结构化镜像。
+ *
+ * 为什么不直接 `import type { IWorkbookData } from "@univerjs/core"`：
+ * 那是**可选 peer**。没装 `@univerjs/presets` 的项目一解析不到这个模块，
+ * 整个包的 typecheck 就红了 —— 而「拿快照出 xlsx」恰恰是最不该逼人装 871KB
+ * 渲染引擎的场景（服务端定时导出、Node 里跑批都只有 JSON）。
+ *
+ * 所以这里只声明导出真正读到的字段，字段名与取值语义和 `@univerjs/core`
+ * 逐一对齐。Univer 加字段不会影响这里；改字段含义会 —— 那种时候本文件是
+ * 唯一需要改的地方。
+ */
+type CellValue = string | number | boolean;
+interface ColorStyle {
+    /** `#RRGGBB` / `rgb(r,g,b)` / `rgba(r,g,b,a)` */
+    rgb?: string | null;
+    /** 主题色 token。xlsx 侧解析不了，直接忽略 */
+    th?: number;
+}
+/** 下划线 / 删除线 / 上划线 */
+interface TextDecorationData {
+    /** 0 关 1 开 */
+    s?: number;
+    cl?: ColorStyle | null;
+    t?: number;
+}
+interface BorderStyleData {
+    /** 对齐 `BorderStyleTypes` */
+    s?: number;
+    cl?: ColorStyle | null;
+}
+interface BorderData {
+    t?: BorderStyleData | null;
+    r?: BorderStyleData | null;
+    b?: BorderStyleData | null;
+    l?: BorderStyleData | null;
+}
+interface TextRotation {
+    /** 角度，-90 ~ 90，正数逆时针 */
+    a?: number;
+    /** 1 = 竖排 */
+    v?: number;
+}
+interface StyleData {
+    /** fontFamily */
+    ff?: string | null;
+    /** fontSize，pt */
+    fs?: number;
+    /** italic */
+    it?: number;
+    /** bold */
+    bl?: number;
+    /** underline */
+    ul?: TextDecorationData | null;
+    /** strikethrough */
+    st?: TextDecorationData | null;
+    /** overline —— xlsx 没有对应表达 */
+    ol?: TextDecorationData | null;
+    /** background */
+    bg?: ColorStyle | null;
+    /** border */
+    bd?: BorderData | null;
+    /** font color */
+    cl?: ColorStyle | null;
+    /** 上下标 */
+    va?: number | null;
+    /** 数字格式 */
+    n?: {
+        pattern?: string;
+    } | null;
+    /** textRotation */
+    tr?: TextRotation | null;
+    /** horizontalAlign */
+    ht?: number | null;
+    /** verticalAlign */
+    vt?: number | null;
+    /** wrapStrategy */
+    tb?: number | null;
+}
+/** 富文本单元格。导出只取纯文本 —— xlsx 的富文本要拆成 `<si><r>` 段，收益不抵复杂度 */
+interface RichTextData {
+    body?: {
+        dataStream?: string;
+    } | null;
+}
+interface CellData {
+    v?: CellValue | null;
+    /** 对齐 `CellValueType` */
+    t?: number | null;
+    /** 原始公式，含前导 `=` */
+    f?: string | null;
+    /** 共享公式组 id。同组里只有一个单元格带 `f` */
+    si?: string | null;
+    /** 数组公式的引用范围 */
+    ref?: string | null;
+    /** 样式 id 或内联样式 */
+    s?: StyleData | string | null;
+    /** 富文本 */
+    p?: RichTextData | null;
+}
+interface RowData {
+    /** 高度 px */
+    h?: number;
+    /** 自适应高度 px，`ia` 为 1 时用它 */
+    ah?: number;
+    /** 是否自适应 */
+    ia?: number;
+    /** 隐藏 */
+    hd?: number;
+    s?: StyleData | string | null;
+}
+interface ColumnData {
+    /** 宽度 px */
+    w?: number;
+    hd?: number;
+    s?: StyleData | string | null;
+}
+interface CellRange {
+    startRow: number;
+    startColumn: number;
+    endRow: number;
+    endColumn: number;
+}
+interface FreezeData {
+    /** 冻结列数 */
+    xSplit: number;
+    /** 冻结行数 */
+    ySplit: number;
+    startRow: number;
+    startColumn: number;
+}
+/** `IObjectMatrixPrimitiveType<T>`：行号 → 列号 → 值，两层都是稀疏对象 */
+type Matrix<T> = Record<number, Record<number, T> | undefined>;
+interface WorksheetData {
+    id?: string;
+    name?: string;
+    /** `#RRGGBB` */
+    tabColor?: string;
+    /** 1 = 隐藏 */
+    hidden?: number;
+    freeze?: FreezeData;
+    rowCount?: number;
+    columnCount?: number;
+    /** px */
+    defaultColumnWidth?: number;
+    /** px */
+    defaultRowHeight?: number;
+    mergeData?: CellRange[];
+    cellData?: Matrix<CellData>;
+    rowData?: Record<number, RowData | undefined>;
+    columnData?: Record<number, ColumnData | undefined>;
+    /** 0 = 不显示网格线 */
+    showGridlines?: number;
+    /** 1 = 从右向左 */
+    rightToLeft?: number;
+    defaultStyle?: StyleData | string | null;
+}
+interface WorkbookData {
+    id?: string;
+    name?: string;
+    /** 工作表顺序。缺省时按 `sheets` 的键序 */
+    sheetOrder?: string[];
+    sheets?: Record<string, WorksheetData | undefined>;
+    /** 样式表：`CellData.s` 为字符串时查这里 */
+    styles?: Record<string, StyleData | null | undefined>;
+    defaultStyle?: StyleData | string | null;
+    /**
+     * 各插件自己序列化的数据（图片、条件格式、数据校验、筛选……）。
+     * 导出读不了它们的私有结构，但**能据此如实报告丢了什么** —— 见 `warnings`。
+     */
+    resources?: Array<{
+        id?: string;
+        name: string;
+        data: string;
+    }>;
+}
+
+/**
+ * CSV → Univer 快照。`csv.ts`（导出侧）的逆。
+ *
+ * 解析按 RFC 4180：引号字段、内部引号翻倍、字段内换行都认；
+ * 行分隔 `\r\n` / `\n` / `\r` 混用也收 —— 真实世界的 csv 三种都有。
+ *
+ * **类型推断是有立场的**：看起来是数字就转数字、TRUE/FALSE 转布尔，
+ * 但「会失真的数字」除外 —— 前导零（"0123"）和超过 15 位有效数字的
+ * （超出 IEEE 754 精度，转了就变值）保留为强制文本，宁可让用户看到
+ * 原文也不悄悄改数据。不想要推断就 `inferTypes: false`，全部按文本进。
+ */
+
+interface CsvParseOptions {
+    /** 分隔符，默认 `,`。tsv 传 `\t` */
+    delimiter?: string;
+    /** 是否推断数字/布尔类型，默认 true */
+    inferTypes?: boolean;
+    /** 工作表名，默认 "Sheet1" */
+    sheetName?: string;
+    /** 工作簿名 */
+    name?: string;
+}
+interface CsvToSnapshotResult {
+    workbook: WorkbookData;
+    warnings: string[];
+    stats: {
+        rows: number;
+        columns: number;
+        cells: number;
+    };
+}
+/**
+ * RFC 4180 状态机。比 split 系写法多出的能力：引号字段里的
+ * 分隔符/换行/翻倍引号。输入带 BOM 时自动剥掉。
+ */
+declare function parseCsv(text: string, delimiter?: string): string[][];
+declare function csvToSnapshot(text: string, options?: CsvParseOptions): CsvToSnapshotResult;
+
+export { type CellData as C, type RowData as R, type StyleData as S, type WorkbookData as W, type CsvParseOptions as a, type CsvToSnapshotResult as b, type WorksheetData as c, csvToSnapshot as d, type CellRange as e, type CellValue as f, type ColumnData as g, parseCsv as p };

package/dist/csv.d.ts

@@ -0,0 +1,86 @@
+import { W as WorkbookData } from './csv-parse-D0zTBvDB.js';
+export { C as CellData, a as CsvParseOptions, b as CsvToSnapshotResult, c as WorksheetData, d as csvToSnapshot, p as parseCsv } from './csv-parse-D0zTBvDB.js';
+
+/**
+ * Univer 快照 → CSV。
+ *
+ * **csv 是单表格式，工作簿是多表的**，这是产品决定不是技术决定。本实现的口径：
+ * 导**一张**表，其余的在 `warnings` 里**逐个点名**，和 xlsx 导出「如实报告丢了什么」
+ * 保持一致 —— 静悄悄只给一张表，用户往往到对账时才发现少了东西。
+ *
+ * 「哪张是活动表」只有运行时的 Univer 实例知道，**快照里根本没有这个字段**。
+ * 所以：传 `univerAPI` 时取真正的活动表；只传快照时取 `sheetOrder` 的第一张，
+ * 并且照样把这件事写进 warnings。要指定就用 `options.sheet`（表 id 或表名）。
+ */
+
+interface CsvOptions {
+    /** 导哪张表：工作表 id 或表名。不传则用活动表（拿不到就用第一张） */
+    sheet?: string;
+    /** 分隔符，默认 `,`。用 `\t` 就是 tsv */
+    delimiter?: string;
+    /** 行分隔，默认 `\r\n`（RFC 4180 规定，Excel 也最稳） */
+    newline?: string;
+    /**
+     * 是否加 UTF-8 BOM，默认 **true**。
+     * 不加的话 Excel 会按本地编码（简中系统是 GBK）解析，中文全是乱码 ——
+     * 这是 csv 导出最常见的投诉，默认就得挡掉。
+     */
+    bom?: boolean;
+    /** 公式格写 Univer 算好的值（默认）还是写公式文本 */
+    formulas?: "value" | "formula";
+}
+interface CsvResult {
+    /** 文本内容，不含 BOM */
+    text: string;
+    /** 可直接落盘/上传的字节，按 `bom` 决定是否带 BOM */
+    bytes: Uint8Array;
+    /** 导出时丢掉/降级了什么。**要展示给用户** */
+    warnings: string[];
+    stats: {
+        sheetName: string;
+        rows: number;
+        columns: number;
+        cells: number;
+        /** 没被导出的工作表数 */
+        skippedSheets: number;
+    };
+}
+declare const CSV_MIME = "text/csv;charset=utf-8";
+declare function csvFromSnapshot(workbook: WorkbookData, options?: CsvOptions): CsvResult;
+
+/**
+ * `@4399ywkf/editor/csv` —— 表格导入导出 CSV。
+ *
+ * 独立子路径而不是塞进 `./xlsx`：csv 这条路**一个依赖都不需要**
+ * （xlsx 那边要 fflate 打 zip），几 KB 就够。只要 csv 的宿主不该为 zip 买单。
+ *
+ * ```ts
+ * import { downloadCsv } from "@4399ywkf/editor/csv"
+ *
+ * const { warnings } = downloadCsv(univerAPI, "明细.csv")
+ * if (warnings.length) toast(warnings.join("\n"))   // ← 里面会点名哪些表没导
+ * ```
+ *
+ * **csv 是单表格式，工作簿是多表的。** 本实现只导一张表，其余的在 `warnings`
+ * 里逐个点名。传 `univerAPI` 时导真正的活动表；只传快照时导第一张 ——
+ * 快照里根本没有「活动表」这个字段。要指定就用 `options.sheet`（表 id 或表名）。
+ *
+ * 导入是反方向（csv 文本 → 快照），见 `csvToSnapshot` / `parseCsv`。
+ * 要连 File/Blob/编码嗅探一起管的，用 `@4399ywkf/editor/xlsx` 的 `importCsv`。
+ */
+
+/**
+ * Univer 实例或快照 → CSV。
+ *
+ * 传实例时会自动锁定**当前活动表** —— 这也是唯一能拿到活动表的途径。
+ */
+declare function exportCsv(source: WorkbookData | unknown, options?: CsvOptions): CsvResult;
+/** Univer 实例或快照 → Blob，便于交给上传接口 */
+declare function csvBlob(source: WorkbookData | unknown, options?: CsvOptions): Blob;
+/**
+ * 触发浏览器下载。返回 warnings / stats —— 别丢，
+ * 「另外几张表没导出」只能从这里知道。
+ */
+declare function downloadCsv(source: WorkbookData | unknown, filename?: string, options?: CsvOptions): CsvResult;
+
+export { CSV_MIME, type CsvOptions, type CsvResult, WorkbookData, csvBlob, csvFromSnapshot, downloadCsv, exportCsv };

package/dist/csv.js

@@ -0,0 +1,34 @@
+import { activeSheetId, csvFromSnapshot, CSV_MIME } from './chunk-HPSPOM2O.js';
+export { CSV_MIME, csvFromSnapshot } from './chunk-HPSPOM2O.js';
+import { toSnapshot } from './chunk-WF7PIIFR.js';
+export { csvToSnapshot, parseCsv } from './chunk-KRP5V7VF.js';
+import './chunk-5HMKRNIH.js';
+
+// src/csv.ts
+function exportCsv(source, options = {}) {
+  const snapshot = toSnapshot(source);
+  const sheet = options.sheet ?? (snapshot === source ? void 0 : activeSheetId(source));
+  return csvFromSnapshot(snapshot, { ...options, sheet });
+}
+function csvBlob(source, options) {
+  return new Blob([exportCsv(source, options).bytes], { type: CSV_MIME });
+}
+function downloadCsv(source, filename = "表格.csv", options) {
+  const result = exportCsv(source, options);
+  if (typeof document === "undefined") {
+    throw new Error("downloadCsv 需要浏览器环境，服务端请改用 exportCsv 自己落盘");
+  }
+  const url = URL.createObjectURL(new Blob([result.bytes], { type: CSV_MIME }));
+  const a = document.createElement("a");
+  a.href = url;
+  a.download = filename.endsWith(".csv") ? filename : `${filename}.csv`;
+  document.body.appendChild(a);
+  a.click();
+  a.remove();
+  setTimeout(() => URL.revokeObjectURL(url), 1e4);
+  return result;
+}
+
+export { csvBlob, downloadCsv, exportCsv };
+//# sourceMappingURL=csv.js.map
+//# sourceMappingURL=csv.js.map

package/dist/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/csv.ts"],"names":[],"mappings":";;;;;;;AA0CO,SAAS,SAAA,CAAU,MAAA,EAAgC,OAAA,GAAsB,EAAC,EAAc;AAC7F,EAAA,MAAM,QAAA,GAAW,WAAW,MAAM,CAAA;AAElC,EAAA,MAAM,QAAQ,OAAA,CAAQ,KAAA,KAAU,aAAa,MAAA,GAAS,MAAA,GAAY,cAAc,MAAM,CAAA,CAAA;AACtF,EAAA,OAAO,gBAAgB,QAAA,EAAU,EAAE,GAAG,OAAA,EAAS,OAAO,CAAA;AACxD;AAGO,SAAS,OAAA,CAAQ,QAAgC,OAAA,EAA4B;AAClF,EAAA,OAAO,IAAI,IAAA,CAAK,CAAC,SAAA,CAAU,MAAA,EAAQ,OAAO,CAAA,CAAE,KAAiB,CAAA,EAAG,EAAE,IAAA,EAAM,QAAA,EAAU,CAAA;AACpF;AAMO,SAAS,WAAA,CACd,MAAA,EACA,QAAA,GAAW,QAAA,EACX,OAAA,EACW;AACX,EAAA,MAAM,MAAA,GAAS,SAAA,CAAU,MAAA,EAAQ,OAAO,CAAA;AACxC,EAAA,IAAI,OAAO,aAAa,WAAA,EAAa;AACnC,IAAA,MAAM,IAAI,MAAM,2CAA2C,CAAA;AAAA,EAC7D;AACA,EAAA,MAAM,GAAA,GAAM,GAAA,CAAI,eAAA,CAAgB,IAAI,IAAA,CAAK,CAAC,MAAA,CAAO,KAAiB,CAAA,EAAG,EAAE,IAAA,EAAM,QAAA,EAAU,CAAC,CAAA;AACxF,EAAA,MAAM,CAAA,GAAI,QAAA,CAAS,aAAA,CAAc,GAAG,CAAA;AACpC,EAAA,CAAA,CAAE,IAAA,GAAO,GAAA;AACT,EAAA,CAAA,CAAE,WAAW,QAAA,CAAS,QAAA,CAAS,MAAM,CAAA,GAAI,QAAA,GAAW,GAAG,QAAQ,CAAA,IAAA,CAAA;AAC/D,EAAA,QAAA,CAAS,IAAA,CAAK,YAAY,CAAC,CAAA;AAC3B,EAAA,CAAA,CAAE,KAAA,EAAM;AACR,EAAA,CAAA,CAAE,MAAA,EAAO;AAET,EAAA,UAAA,CAAW,MAAM,GAAA,CAAI,eAAA,CAAgB,GAAG,GAAG,GAAM,CAAA;AACjD,EAAA,OAAO,MAAA;AACT","file":"csv.js","sourcesContent":["/**\n * `@4399ywkf/editor/csv` —— 表格导入导出 CSV。\n *\n * 独立子路径而不是塞进 `./xlsx`：csv 这条路**一个依赖都不需要**\n * （xlsx 那边要 fflate 打 zip），几 KB 就够。只要 csv 的宿主不该为 zip 买单。\n *\n * ```ts\n * import { downloadCsv } from \"@4399ywkf/editor/csv\"\n *\n * const { warnings } = downloadCsv(univerAPI, \"明细.csv\")\n * if (warnings.length) toast(warnings.join(\"\\n\"))   // ← 里面会点名哪些表没导\n * ```\n *\n * **csv 是单表格式，工作簿是多表的。** 本实现只导一张表，其余的在 `warnings`\n * 里逐个点名。传 `univerAPI` 时导真正的活动表；只传快照时导第一张 ——\n * 快照里根本没有「活动表」这个字段。要指定就用 `options.sheet`（表 id 或表名）。\n *\n * 导入是反方向（csv 文本 → 快照），见 `csvToSnapshot` / `parseCsv`。\n * 要连 File/Blob/编码嗅探一起管的，用 `@4399ywkf/editor/xlsx` 的 `importCsv`。\n */\n\nimport {\n  activeSheetId,\n  CSV_MIME,\n  type CsvOptions,\n  type CsvResult,\n  csvFromSnapshot,\n} from \"./xlsx/csv\"\nimport { toSnapshot } from \"./xlsx/snapshot\"\nimport type { WorkbookData } from \"./xlsx/types\"\n\nexport type { CsvOptions, CsvResult } from \"./xlsx/csv\"\nexport { CSV_MIME, csvFromSnapshot } from \"./xlsx/csv\"\nexport type { CsvParseOptions, CsvToSnapshotResult } from \"./xlsx/csv-parse\"\nexport { csvToSnapshot, parseCsv } from \"./xlsx/csv-parse\"\nexport type { CellData, WorkbookData, WorksheetData } from \"./xlsx/types\"\n\n/**\n * Univer 实例或快照 → CSV。\n *\n * 传实例时会自动锁定**当前活动表** —— 这也是唯一能拿到活动表的途径。\n */\nexport function exportCsv(source: WorkbookData | unknown, options: CsvOptions = {}): CsvResult {\n  const snapshot = toSnapshot(source)\n  // 已显式指定就不去猜；否则只在传的是实例时才问得出活动表\n  const sheet = options.sheet ?? (snapshot === source ? undefined : activeSheetId(source))\n  return csvFromSnapshot(snapshot, { ...options, sheet })\n}\n\n/** Univer 实例或快照 → Blob，便于交给上传接口 */\nexport function csvBlob(source: WorkbookData | unknown, options?: CsvOptions): Blob {\n  return new Blob([exportCsv(source, options).bytes as BlobPart], { type: CSV_MIME })\n}\n\n/**\n * 触发浏览器下载。返回 warnings / stats —— 别丢，\n * 「另外几张表没导出」只能从这里知道。\n */\nexport function downloadCsv(\n  source: WorkbookData | unknown,\n  filename = \"表格.csv\",\n  options?: CsvOptions,\n): CsvResult {\n  const result = exportCsv(source, options)\n  if (typeof document === \"undefined\") {\n    throw new Error(\"downloadCsv 需要浏览器环境，服务端请改用 exportCsv 自己落盘\")\n  }\n  const url = URL.createObjectURL(new Blob([result.bytes as BlobPart], { type: CSV_MIME }))\n  const a = document.createElement(\"a\")\n  a.href = url\n  a.download = filename.endsWith(\".csv\") ? filename : `${filename}.csv`\n  document.body.appendChild(a)\n  a.click()\n  a.remove()\n  // 立刻 revoke 会让部分浏览器（Safari）来不及取数据\n  setTimeout(() => URL.revokeObjectURL(url), 10_000)\n  return result\n}\n"]}

package/dist/docx.d.ts

@@ -104,6 +104,14 @@ interface ParseDocxResult {
     header: Record<string, unknown> | null;
     /** 默认页脚的结构化内容，同上 */
     footer: Record<string, unknown> | null;
+    /**
+     * 脚注。**键是正文上标标记 `[n]` 里的编号**（按引用出现顺序 1 起编），
+     * 宿主拿 `footnotes["1"]` 就是正文里 `[1]` 指的那条 —— 不用自己解 w:id。
+     * 编辑器没有脚注节点，所以注文不进文档树、导出 docx 时也不会写回。
+     */
+    footnotes: Record<string, Record<string, unknown>>;
+    /** 尾注，键的语义同 `footnotes`（编号序列与脚注各自独立） */
+    endnotes: Record<string, Record<string, unknown>>;
     /** 节属性原件，交给导出侧原样写回 */
     section: DocxSection;
 }
@@ -276,7 +284,14 @@ interface ImportDocxContext {
      * 但它只活在内存里：刷新页面 / 换设备就没了，要跨会话往返得自己存。
      */
     section: DocxSection;
+    /**
+     * 脚注。**键是正文上标标记 `[n]` 里的编号**（按引用出现顺序 1 起编）——
+     * 宿主拿 `footnotes["1"]` 就是正文 `[1]` 指的那条，不用自己解 w:id。
+     * 编辑器没有脚注节点：注文不进文档树，导出 docx 时也不会写回
+     * （导入时 warnings 里会明说）。
+     */
     footnotes: Record<string, JSONContent>;
+    /** 尾注，键的语义同 `footnotes`（编号序列与脚注各自独立） */
     endnotes: Record<string, JSONContent>;
 }
 interface ImportDocxCommandArgs {

package/dist/docx.js

@@ -142,9 +142,23 @@ function parseDocx(entries, opts) {
     paraSpacing: 0,
     paraIndent: 0,
     lists: 0,
-    listItems: 0
+    listItems: 0,
+    footnotes: 0,
+    endnotes: 0
   };
   const warnings = [];
+  const noteNumbers = {
+    footnote: /* @__PURE__ */ new Map(),
+    endnote: /* @__PURE__ */ new Map()
+  };
+  function noteNumber(kind, id) {
+    const seq = noteNumbers[kind];
+    const hit = seq.get(id);
+    if (hit !== void 0) return hit;
+    const n = seq.size + 1;
+    seq.set(id, n);
+    return n;
+  }
   const text = (p) => {
     const b = entries.read(p);
     return b ? decoder.decode(b) : null;
@@ -379,6 +393,17 @@ function parseDocx(entries, opts) {
         if (!n) continue;
         if (n.type === "image") out.blocks.push(n);
         else out.inline.push(n);
+      } else if (t === "w:footnoteReference" || t === "w:endnoteReference") {
+        const id = c.getAttribute("w:id");
+        if (!id) continue;
+        const kind = t === "w:footnoteReference" ? "footnote" : "endnote";
+        const n = noteNumber(kind, id);
+        const hasSuper = marks.some((m) => m.type === "superscript");
+        out.inline.push({
+          type: "text",
+          text: `[${n}]`,
+          marks: hasSuper ? marks : [...marks, { type: "superscript" }]
+        });
       } else if (t === "w:pict") {
         warnings.push("遇到 VML 图形（w:pict），未处理");
       }
@@ -706,6 +731,17 @@ function parseDocx(entries, opts) {
   if (!body) throw new Error("docx 缺少 w:body");
   const content = blocksOf(body);
   const doc = remapTypes({ type: "doc", content }, opts.prosemirrorNodes, opts.prosemirrorMarks);
+  const footnotes = notesOf("word/footnotes.xml", "w:footnote", "footnote");
+  const endnotes = notesOf("word/endnotes.xml", "w:endnote", "endnote");
+  if (recovered.footnotes || recovered.endnotes) {
+    const parts = [
+      ...recovered.footnotes ? [`${recovered.footnotes} 条脚注`] : [],
+      ...recovered.endnotes ? [`${recovered.endnotes} 条尾注`] : []
+    ];
+    warnings.push(
+      `文档有 ${parts.join("和")}：正文引用以上标 [n] 文本保留，注文在导入结果的 footnotes / endnotes 里（键即编号 n）。编辑器没有脚注节点，导出 docx 时不会写回`
+    );
+  }
   const section = readSection();
   const defaultHeader = section.refs.find((r) => r.kind === "header" && r.type === "default");
   const defaultFooter = section.refs.find((r) => r.kind === "footer" && r.type === "default");
@@ -716,8 +752,30 @@ function parseDocx(entries, opts) {
     ...opts.cssStyles ? { css: extractCss(stylesDoc) } : {},
     header: defaultHeader ? partContent(defaultHeader.path, "w:hdr") : null,
     footer: defaultFooter ? partContent(defaultFooter.path, "w:ftr") : null,
+    footnotes,
+    endnotes,
     section
   };
+  function notesOf(path, tag, kind) {
+    const d = xml(path);
+    if (!d) return {};
+    const out = {};
+    for (const el of Array.from(d.getElementsByTagName(tag))) {
+      const type = el.getAttribute("w:type");
+      if (type && type !== "normal") continue;
+      const id = el.getAttribute("w:id");
+      if (id === null) continue;
+      const blocks = blocksOf(el);
+      if (!blocks.length) continue;
+      out[String(noteNumber(kind, id))] = remapTypes(
+        { type: "doc", content: blocks },
+        opts.prosemirrorNodes,
+        opts.prosemirrorMarks
+      );
+      recovered[`${kind}s`] += 1;
+    }
+    return out;
+  }
   function partContent(path, root) {
     const d = xml(path);
     const el = d?.getElementsByTagName(root)[0];
@@ -1542,8 +1600,8 @@ var ImportDocx = Extension.create({
               header: result.header,
               footer: result.footer,
               section: result.section,
-              footnotes: {},
-              endnotes: {}
+              footnotes: result.footnotes,
+              endnotes: result.endnotes
             });
           } catch (e) {
             const err = e instanceof Error ? e : new Error(String(e));