@4399ywkf/editor 0.6.0 → 0.7.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@4399ywkf/editor",
-  "version": "0.6.0",
-  "description": "4399 多格式文档编辑器：doc(tiptap) / sheet(univer) / pdf，含 docx 导入导出与 AI 可驱动的结构化编辑面（./doc-runtime）",
+  "version": "0.7.0",
+  "description": "4399 多格式文档编辑器：doc(tiptap) / sheet(univer) / pdf / pptx，含 docx·xlsx·csv 双向导入导出与 AI 可驱动的结构化编辑面（./doc-runtime、./sheet-runtime）",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -42,6 +42,10 @@
       "types": "./dist/doc-runtime.d.ts",
       "import": "./dist/doc-runtime.js"
     },
+    "./sheet-runtime": {
+      "types": "./dist/sheet-runtime.d.ts",
+      "import": "./dist/sheet-runtime.js"
+    },
     "./plugins/ai": {
       "types": "./dist/plugins/ai.d.ts",
       "import": "./dist/plugins/ai.js"
@@ -143,7 +147,7 @@
   "scripts": {
     "build": "tsup && node scripts/build-styles.mjs",
     "dev": "tsup --watch",
-    "test": "node --experimental-strip-types --test src/docx/*.test.ts src/doc-runtime/*.test.ts src/xlsx/*.test.ts src/*.test.ts src/plugins/**/*.test.ts",
+    "test": "node --experimental-strip-types --test src/docx/*.test.ts src/doc-runtime/*.test.ts src/sheet-runtime/*.test.ts src/xlsx/*.test.ts src/*.test.ts src/plugins/**/*.test.ts",
     "typecheck": "tsc --noEmit"
   }
 }

package/dist/SheetView-DSADIZNS.js

@@ -1,3 +0,0 @@
-export { SheetView as default } from './chunk-L6ZR5HHW.js';
-//# sourceMappingURL=SheetView-DSADIZNS.js.map
-//# sourceMappingURL=SheetView-DSADIZNS.js.map

package/dist/chunk-32WQX3NR.js

@@ -1,37 +0,0 @@
-// 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);
-}
-
-// src/xlsx/cell.ts
-function numericKeys(o) {
-  if (!o) return [];
-  return Object.keys(o).map(Number).filter((n) => Number.isInteger(n) && n >= 0).sort((a, b) => a - b);
-}
-function richTextToPlain(cell) {
-  const stream = cell.p?.body?.dataStream;
-  if (typeof stream !== "string") return void 0;
-  return stream.replace(/\r\n$/, "").replace(/\r/g, "\n");
-}
-function looksLikeDateFormat(pattern) {
-  if (!pattern) return false;
-  const bare = pattern.replace(/"[^"]*"/g, "").replace(/\\./g, "");
-  return /[yYdD]/.test(bare) || /h/i.test(bare) || /\[\$-/.test(pattern);
-}
-
-export { looksLikeDateFormat, numericKeys, richTextToPlain, snapshotFromUniver, toSnapshot };
-//# sourceMappingURL=chunk-32WQX3NR.js.map
-//# sourceMappingURL=chunk-32WQX3NR.js.map

package/dist/chunk-32WQX3NR.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/xlsx/snapshot.ts","../src/xlsx/cell.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;;;ACjBO,SAAS,YAAY,CAAA,EAAkD;AAC5E,EAAA,IAAI,CAAC,CAAA,EAAG,OAAO,EAAC;AAChB,EAAA,OAAO,MAAA,CAAO,KAAK,CAAC,CAAA,CACjB,IAAI,MAAM,CAAA,CACV,MAAA,CAAO,CAAC,CAAA,KAAM,MAAA,CAAO,UAAU,CAAC,CAAA,IAAK,KAAK,CAAC,CAAA,CAC3C,KAAK,CAAC,CAAA,EAAG,CAAA,KAAM,CAAA,GAAI,CAAC,CAAA;AACzB;AAGO,SAAS,gBAAgB,IAAA,EAAoC;AAClE,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,CAAA,EAAG,IAAA,EAAM,UAAA;AAC7B,EAAA,IAAI,OAAO,MAAA,KAAW,QAAA,EAAU,OAAO,MAAA;AACvC,EAAA,OAAO,OAAO,OAAA,CAAQ,OAAA,EAAS,EAAE,CAAA,CAAE,OAAA,CAAQ,OAAO,IAAI,CAAA;AACxD;AASO,SAAS,oBAAoB,OAAA,EAA6C;AAC/E,EAAA,IAAI,CAAC,SAAS,OAAO,KAAA;AAErB,EAAA,MAAM,IAAA,GAAO,QAAQ,OAAA,CAAQ,UAAA,EAAY,EAAE,CAAA,CAAE,OAAA,CAAQ,QAAQ,EAAE,CAAA;AAC/D,EAAA,OAAO,QAAA,CAAS,IAAA,CAAK,IAAI,CAAA,IAAK,IAAA,CAAK,KAAK,IAAI,CAAA,IAAK,OAAA,CAAQ,IAAA,CAAK,OAAO,CAAA;AACvE","file":"chunk-32WQX3NR.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","/** 读 Univer 快照时 xlsx 与 csv 两条导出路径共用的小工具。 */\n\nimport type { CellData } from \"./types.ts\"\n\n/**\n * 稀疏矩阵的行号/列号。\n *\n * Univer 的 `cellData` 是 `{ [row]: { [col]: cell } }` 的普通对象，键是字符串。\n * 直接 `Object.keys()` 会得到 `[\"10\", \"2\"]` 这种字典序，必须转数字再排 ——\n * 否则导出的行序就是乱的。\n */\nexport function numericKeys(o: Record<number, unknown> | undefined): number[] {\n  if (!o) return []\n  return Object.keys(o)\n    .map(Number)\n    .filter((n) => Number.isInteger(n) && n >= 0)\n    .sort((a, b) => a - b)\n}\n\n/** 富文本只取纯文本。Univer 的 dataStream 用 \\r 断段、结尾还带一个 \\r\\n */\nexport function richTextToPlain(cell: CellData): string | undefined {\n  const stream = cell.p?.body?.dataStream\n  if (typeof stream !== \"string\") return undefined\n  return stream.replace(/\\r\\n$/, \"\").replace(/\\r/g, \"\\n\")\n}\n\n/**\n * 这个单元格的数字格式是不是日期/时间。\n *\n * 只做**粗判**，用来给 csv 提示「这里会导出成序列号」，不用来做转换 ——\n * Excel 的格式码有转义（`\\d`、`\"年\"`）、有区域前缀（`[$-409]`）、\n * 还有和 `mm` 同形的分钟，真解析是个坑。猜错日期比原样给出序列号更糟。\n */\nexport function looksLikeDateFormat(pattern: string | undefined | null): boolean {\n  if (!pattern) return false\n  // 去掉引号里的字面量和反斜杠转义，剩下的才是真正的格式符\n  const bare = pattern.replace(/\"[^\"]*\"/g, \"\").replace(/\\\\./g, \"\")\n  return /[yYdD]/.test(bare) || /h/i.test(bare) || /\\[\\$-/.test(pattern)\n}\n"]}

package/dist/chunk-L6ZR5HHW.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/views/SheetView.tsx"],"names":[],"mappings":"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","file":"chunk-L6ZR5HHW.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 **导出**用本包的 `./xlsx`：直接读 Univer 快照拼 OOXML，不引 SheetJS。\n * **导入**仍在宿主侧自理（SheetJS 或后端解析），本包不做 xlsx → 快照那一向。\n *\n * 配置见 `SheetOptions`：UI 开关直接透传给 preset（Univer 的 class 是\n * `univer-` 前缀的原子类，没有稳定选择器，CSS 硬藏靠不住），额外能力靠追加 preset。\n */\nexport default function SheetView({\n  content,\n  readOnly,\n  className,\n  sheet,\n  onReady,\n  onError,\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 })\n  useEffect(() => {\n    latest.current = { sheet, onReady, onError }\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 } = latest.current\n      try {\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        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        if (content) univerAPI.createWorkbook(content as never)\n        else univerAPI.createWorkbook({})\n        if (readOnly) univerAPI.getActiveWorkbook?.()?.setEditable?.(false)\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  }, [content, readOnly])\n\n  return <div ref={hostRef} className={className} style={{ width: \"100%\", height: \"100%\" }} />\n}\n"]}