weifuwu 0.85.0 → 0.86.0

package/dist/index.js

@@ -3607,6 +3607,17 @@ function createClientBrowser() {
       if (typeof window !== "undefined") window.location.hash = h2;
     },
     timeout: (fn, ms) => typeof window !== "undefined" ? window.setTimeout(fn, ms) : 0,
+    /** 浏览器表单状态恢复（load/pageshow）监听——SSR 安全 no-op */
+    onFormRestore: (cb) => {
+      if (typeof window === "undefined" || typeof document === "undefined") return () => {
+      };
+      window.addEventListener("load", cb, { once: true });
+      window.addEventListener("pageshow", cb);
+      return () => {
+        window.removeEventListener("load", cb);
+        window.removeEventListener("pageshow", cb);
+      };
+    },
     rootElement: () => typeof document !== "undefined" ? document.documentElement : null,
     storageGet: (key) => {
       try {
@@ -3770,7 +3781,15 @@ var globalHandlers = /* @__PURE__ */ new Map();
 var globalRoots = /* @__PURE__ */ new Map();
 var EVENT_MAP = {
   focus: "focusin",
-  blur: "focusout"
+  blur: "focusout",
+  mouseenter: "mouseover",
+  mouseleave: "mouseout"
+};
+var REVERSE_MAP = {
+  focusin: "focus",
+  focusout: "blur",
+  mouseover: "mouseenter",
+  mouseout: "mouseleave"
 };
 var NON_BUBBLING = /* @__PURE__ */ new Set(["error", "load", "loadstart", "loadend", "abort", "unload", "resize", "message"]);
 var TEXT_INPUT_EVENTS = /* @__PURE__ */ new Set(["input", "change", "compositionstart", "compositionend"]);
@@ -3805,11 +3824,11 @@ function rootOf(node) {
   return null;
 }
 function ensureRootEvent(root, event) {
+  const realEvent = EVENT_MAP[event] ?? event;
   const set = registered.get(root) ?? /* @__PURE__ */ new Set();
-  if (set.has(event)) return;
-  set.add(event);
+  if (set.has(realEvent)) return;
+  set.add(realEvent);
   registered.set(root, set);
-  const realEvent = EVENT_MAP[event] ?? event;
   const fn = (e) => dispatch(e);
   const useCapture = NON_BUBBLING.has(realEvent);
   root.addEventListener(realEvent, fn, useCapture ? { capture: true } : void 0);
@@ -3857,8 +3876,11 @@ function addGlobalListener(target, event, handler, opts) {
 function dispatch(e) {
   let el = e.target;
   if (el && el.nodeType === 3) el = el.parentElement;
-  const m = handlers.get(e.type);
-  if (!m) return;
+  const keys = [];
+  if (handlers.has(e.type)) keys.push(e.type);
+  const mapped = REVERSE_MAP[e.type];
+  if (mapped && mapped !== e.type && handlers.has(mapped)) keys.push(mapped);
+  if (keys.length === 0) return;
   while (el) {
     if (!el.hasAttribute?.("data-v3-id")) {
       const idEl = el.closest?.("[data-v3-id]");
@@ -3869,8 +3891,9 @@ function dispatch(e) {
     }
     const id = el.getAttribute?.("data-v3-id");
     if (id) {
-      const entry = m.get(id);
-      if (entry) {
+      for (const k of keys) {
+        const entry = handlers.get(k)?.get(id);
+        if (!entry) continue;
         try {
           Object.defineProperty(e, "currentTarget", { value: el, configurable: true });
         } catch {
@@ -3884,11 +3907,12 @@ function dispatch(e) {
           stream.emit(ev("text", "input", id, { event: e.type, value: typeof value === "string" ? value.slice(0, 100) : null }));
         }
         if (entry.once) {
-          m.delete(id);
+          handlers.get(k).delete(id);
           stream.emit(ev("event", "unbind", id, { event: e.type }));
         }
         if (e.cancelBubble) break;
       }
+      if (e.cancelBubble) break;
     }
     el = el.parentElement;
   }
@@ -4402,7 +4426,8 @@ function usePopup(env, options) {
       prevOpen = true;
       lastEl = el;
     }
-    const props = content.props ?? {};
+    const props = (content ?? h("span")).props ?? {};
+    if (!content) return null;
     latestContentRef = props.ref ?? null;
     const cls = options.positioning === "none" ? props.class ?? "" : ["wf-popup", props.class].filter(Boolean).join(" ");
     const style = options.positioning === "none" ? { ...props.style ?? {}, position: "fixed" } : {
@@ -5497,7 +5522,9 @@ async function buildVNode(vnode, ctx, oldV, isRoot = false) {
         // SSR 下 document undefined → null/no-op——组件 36 处 ctx.browser 消费
         // 无需各自 fallback（Tour 曾因 ctx.browser 缺失 → query 返回 undefined →
         // targetEl 永不赋值 → rect 恒 0 → 引导高亮定位失效）
-        browser: createClientBrowser(),
+        // 注入优先（测试/宿主可覆盖——真实事故：ctx.browser 注入被覆盖——
+        // Editor draftKey 的 storageSet 走真实 browser 而非 fake）
+        browser: ctx.browser ?? createClientBrowser(),
         ui: createV3Ui(compId, componentRender, (fn) => {
           unmountHooks.set(compId, fn);
         })

package/dist/office/docx.d.ts

@@ -0,0 +1,33 @@
+/**
+ * weifuwu/office/docx — docx ↔ ODES DocState 双向转换（前端/服务端通用——零依赖）
+ *
+ * 参考算法：office2json（unzip → XML 树 → 路径提取 w:body → w:p → w:r → w:t），
+ * 增强提取到 ODES IR（design/office-events-plan.md）：
+ * - 段落属性：pStyle → h1/h2/h3、jc → 对齐（裁剪：样式名映射子集）
+ * - 内联格式：rPr b/i/u → marks（区间）
+ * - 表格：w:tbl → Editor 表格 embed 快照（HTML 复用现有模型）
+ * - 图片：w:drawing r:embed → rels → media → data url → img embed
+ *
+ * 导出（DocState → minimal docx）：VNode 组件化（OOXML 也是 VNode——与前端
+ * "VNode → DOM"同构）→ vnodeToXml → store ZIP。块级 embed（pre/hr）打断段落。
+ *
+ * 前端可用（无需后端）：ZIP 解压走 DecompressionStream（浏览器/Node 18+）；
+ * base64 跨环境（Buffer 守卫/atob）。诚实裁剪：分节/页眉页脚/域代码/批注
+ * 不导入；http 图片导出裁剪（warning）。
+ */
+import type { DocState } from '../components/Editor/model/types.ts';
+/** base64 → Uint8Array（跨环境——浏览器 atob / Node Buffer） */
+export declare function base64ToBytes(b64: string): Uint8Array;
+/** Uint8Array → base64（跨环境） */
+export declare function bytesToBase64(u8: Uint8Array): string;
+export interface DocxImportResult {
+    doc: DocState;
+    /** 裁剪提示（不可映射内容——诚实不静默） */
+    warnings: string[];
+}
+export declare function docxToDoc(u8: Uint8Array): Promise<DocxImportResult>;
+export interface DocxExportResult {
+    data: Uint8Array;
+    warnings: string[];
+}
+export declare function docToDocx(doc: DocState): DocxExportResult;

package/dist/office/pptx.d.ts

@@ -0,0 +1,24 @@
+/**
+ * weifuwu/office/pptx — pptx ↔ ODES DeckState 双向转换（前端/服务端通用——零依赖）
+ *
+ * 参考算法：office2json（ppt/slides/slideN.xml → p:sld → p:cSld → p:spTree →
+ * p:sp → p:txBody → a:p → a:r → a:t），增强提取到 ODES IR：
+ * - 多幻灯片：slideN.xml 全量（office2json 只取文本——ODES 保留结构）
+ * - shape 几何：p:xfrm（a:off x/y + a:ext cx/cy——EMU → px：/9525）
+ * - shape 类型：p:sp（文本/图形——p:prstGeom prst）/ p:pic（图片）
+ * - 文本：txBody → 段落拼接（a:br 换行）
+ *
+ * 导出（DeckState → minimal pptx）：slideN.xml（spTree 结构）+ presentation.xml
+ * + rels + contentTypes——store ZIP（VNode 组件化）。裁剪：动画/母版/备注/主题。
+ */
+import type { DeckState } from '../components/OfficeEditor/model/types.ts';
+export interface PptxImportResult {
+    deck: DeckState;
+    warnings: string[];
+}
+export declare function pptxToDeck(u8: Uint8Array): Promise<PptxImportResult>;
+export interface PptxExportResult {
+    data: Uint8Array;
+    warnings: string[];
+}
+export declare function deckToPptx(deck: DeckState): PptxExportResult;

package/dist/office/xlsx.d.ts

@@ -0,0 +1,25 @@
+/**
+ * weifuwu/office/xlsx — xlsx ↔ ODES WorkbookState 双向转换（前端/服务端通用——零依赖）
+ *
+ * 参考算法：office2json（sheet1.xml → sheetData → row → c{t,v} + sharedStrings），
+ * 增强提取到 ODES IR（design/office-events-plan.md）：
+ * - 多 sheet：workbook.xml（sheet 名 + rId）→ rels → 各 sheetN.xml
+ * - 单元格引用：c@r（A1——office2json 丢弃——ODES 必须）
+ * - 类型：c@t（s=shared/n=number/b=bool/f=formula）→ SheetCell.kind
+ * - 公式：f 元素（公式字符串保留——不计算——服务端导出重算）
+ * - 行高/列宽/样式索引：裁剪（v1——诚实：不读不写）
+ *
+ * 导出（WorkbookState → minimal xlsx）：共享字符串表去重 + sheetData XML +
+ * store ZIP（VNode 组件化——OOXML 也是 VNode）。
+ */
+import type { WorkbookState } from '../components/OfficeEditor/model/types.ts';
+export interface XlsxImportResult {
+    workbook: WorkbookState;
+    warnings: string[];
+}
+export declare function xlsxToWorkbook(u8: Uint8Array): Promise<XlsxImportResult>;
+export interface XlsxExportResult {
+    data: Uint8Array;
+    warnings: string[];
+}
+export declare function workbookToXlsx(wb: WorkbookState): XlsxExportResult;

package/dist/office/xml-serialize.d.ts

@@ -0,0 +1,18 @@
+/**
+ * weifuwu/office/xml-serialize — VNode 树 → XML 字符串（服务端 OOXML 生成）
+ *
+ * 架构（与前端 "VNode → DOM" 同构——"OOXML 也是写 VNode"）：
+ *   DocState → VNode 树（h()——vdom3 纯数据结构，零 DOM 依赖）
+ *   → vnodeToXml（本模块）→ ZIP 打包
+ *
+ * 序列化约定（仅输出 XML 子集——与 vdom3 渲染管线解耦）：
+ * - type: string = 元素名（含命名空间前缀——w:p、a:graphic 等原样输出）
+ * - props: 字符串值 = XML 属性；number/boolean 字符串化；key/children 排除
+ * - children: 字符串 = 文本（转义）；VNode = 子元素；数组 = 序列
+ * - 空元素 → 自闭合 <w:b/>（OOXML 合法——MS Word 接受）
+ * - 函数/symbol type、事件 props（on*）→ 抛错（诚实——序列化器不支持）
+ */
+import type { VNode, VNodeChild } from '../ui-dom/vdom3/types.ts';
+export declare function vnodeToXml(v: VNode | VNodeChild, xmlDecl?: boolean): string;
+/** 便捷：把 VNode 树序列化为 OOXML 部件 XML（名称检查由调用方保证） */
+export declare function vnodeToXmlDecl(v: VNode): string;

package/dist/office/xml.d.ts

@@ -0,0 +1,21 @@
+/**
+ * weifuwu/office/xml — 自研轻量 XML 解析（零 npm 依赖）
+ *
+ * 参考算法：office2json（@xmldom/xmldom → { name, attrs, children } 树）。
+ * OOXML 是规整 XML——只做元素树 + 文本；裁剪：DTD/实体展开（除内建五实体）/
+ * 命名空间处理（前缀保留原名——w:p 等）。解析失败抛错（诚实——不静默）。
+ */
+export interface XmlNode {
+    name: string;
+    attrs: Record<string, string>;
+    children: XmlNode[];
+    /** 直接文本内容（子元素外的文本） */
+    text: string;
+}
+/** 手写扫描器：<name attrs>...</name> / <name/> / 文本 / 指令 / 注释 / CDATA */
+export declare function parseXml(xml: string): XmlNode;
+/** 便捷：找子元素（按名字——含命名空间前缀匹配） */
+export declare function child(el: XmlNode, name: string): XmlNode | null;
+export declare function children(el: XmlNode, name: string): XmlNode[];
+/** 全部后代文本（拼接） */
+export declare function allText(el: XmlNode): string;

package/dist/office/zip.d.ts

@@ -0,0 +1,21 @@
+/**
+ * weifuwu/office/zip — 自研 ZIP 容器读写（零 npm 依赖）
+ *
+ * 参考算法：office2json（unzip 结构——EOCD → central directory → local header）。
+ * 实现取舍：
+ * - 读：EOCD（尾部扫描）→ central directory → local header offset 取数据；
+ *   压缩方法 0（store）/ 8（deflate——Node 内置 zlib.inflateRawSync）
+ * - 写：store（无压缩——合法 ZIP，文件较大但零依赖正确性优先）；
+ *   CRC32 自研查表
+ * - 裁剪：ZIP64/加密/数据描述符（flags bit3）/多盘——不支持（诚实——读到即抛错）
+ */
+export interface ZipEntry {
+    name: string;
+    data: Uint8Array;
+}
+export declare function crc32(buf: Uint8Array): number;
+/** inflate（ZIP method 8）——跨环境：浏览器 DecompressionStream / Node 18+（同 API）。
+ *  老环境无 DecompressionStream → 抛错（诚实裁剪：OOXML 必用 deflate）。 */
+export declare function inflateRaw(data: Uint8Array): Promise<Uint8Array>;
+export declare function readZip(u8: Uint8Array): Promise<Map<string, Uint8Array>>;
+export declare function writeZip(files: Map<string, Uint8Array>): Uint8Array;