weifuwu 0.84.0 → 0.86.0

package/dist/index.js

@@ -3316,7 +3316,6 @@ var HtmlSafe = class {
 
 // src/ui-dom/vdom3/types.ts
 function flatten(c) {
-  if (c == null || typeof c === "boolean") return [];
   if (Array.isArray(c)) return c.flatMap((x) => flatten(x));
   return [c];
 }
@@ -3368,8 +3367,19 @@ function createEventStream(max = 2e4, opts) {
       }
     }
   };
+  let currentSession = null;
+  let sessionUid = 0;
   return {
+    /** 新渲染会话开始（每次渲染入口调用——同一次渲染的事件共享 session id） */
+    setSession() {
+      currentSession = `s${++sessionUid}`;
+      return currentSession;
+    },
+    currentSession() {
+      return currentSession;
+    },
     emit(evt) {
+      if (currentSession != null && evt.session == null) evt.session = currentSession;
       emitOne(evt, false);
       if (watermark > 0 && !watermarkFired && len >= max * watermark) {
         watermarkFired = true;
@@ -3417,6 +3427,10 @@ function createEventStream(max = 2e4, opts) {
       for (let i = 0; i < len; i++) out[i] = at(i);
       return out;
     },
+    /** 按渲染会话过滤（阶段 5——session 字段的消费 API——一次渲染的事件全量） */
+    eventsBySession(sessionId) {
+      return this.events().filter((e) => e.session === sessionId);
+    },
     inverse(evt) {
       switch (evt.entity + ":" + evt.action) {
         case "node:insert":
@@ -3444,6 +3458,35 @@ function createEventStream(max = 2e4, opts) {
   };
 }
 var stream = createEventStream();
+if (typeof globalThis !== "undefined") {
+  const w = globalThis;
+  if (!w.__wf_tail) {
+    w.__wf_tail = (n = 200, filter) => {
+      const evs = stream.events().slice(-n);
+      if (!filter) return evs;
+      return evs.filter((e) => {
+        if (filter.comp && e.payload?.name !== filter.comp) return false;
+        if (filter.decision && e.payload?.reason !== filter.decision) return false;
+        if (filter.causeId && e.payload?.causeId !== filter.causeId) return false;
+        return true;
+      });
+    };
+    w.__wf_builds = (comp) => {
+      const evs = stream.events().filter((e) => e.entity === "comp" && e.action === "build");
+      if (!comp) return evs.map((e) => ({ name: e.payload?.name, reason: e.payload?.reason, changedKeys: e.payload?.changedKeys }));
+      return evs.filter((e) => e.payload?.name === comp).map((e) => ({ name: e.payload?.name, reason: e.payload?.reason, changedKeys: e.payload?.changedKeys }));
+    };
+    w.__wf_recent = (n = 50) => stream.events().slice(-n);
+    w.__wf_comp = (compId) => {
+      const evs = stream.events().filter((e) => {
+        if (e.target === compId) return true;
+        if (e.payload?.name && !compId) return true;
+        return false;
+      });
+      return evs.map((e) => ({ entity: e.entity, action: e.action, target: e.target, payload: e.payload, session: e.session }));
+    };
+  }
+}
 var nodeUid = 0;
 function nextNodeId() {
   return `n${++nodeUid}`;
@@ -3564,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 {
@@ -3727,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"]);
@@ -3762,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);
@@ -3814,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]");
@@ -3826,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 {
@@ -3841,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;
   }
@@ -4359,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" } : {
@@ -5367,6 +5435,21 @@ var unmountHooks = /* @__PURE__ */ new Map();
 function isVNode(v) {
   return v != null && typeof v === "object" && !Array.isArray(v) && "type" in v;
 }
+function propsSnap(props) {
+  try {
+    const picked = {};
+    for (const [k, v] of Object.entries(props)) {
+      if (v != null && typeof v === "object") {
+        const s = JSON.stringify(v);
+        if (s != null && s.length <= 1e4) picked[k] = s;
+      }
+    }
+    return Object.keys(picked).length > 0 ? JSON.stringify(picked) : null;
+  } catch {
+    return null;
+  }
+}
+var warnedContentChange = /* @__PURE__ */ new Set();
 function propsEqual(a, b) {
   const ka = Object.keys(a);
   const kb = Object.keys(b);
@@ -5387,17 +5470,33 @@ async function buildVNode(vnode, ctx, oldV, isRoot = false) {
       v2._render = reuse._render;
       v2._id = reuse._id;
       indexComponent(v2);
-      stream.emit(ev("comp", "build", v2._id, { name: compName(v2.type), reused: true, index: true }));
       if (!isRoot && propsEqual(reuse.props, v2.props)) {
         v2._child = reuse._child;
+        if (reuse.el != null) v2.el = reuse.el;
+        if (globalThis.__WF_V3_AUDIT !== "0" && reuse._propsSnap != null) {
+          const cur = propsSnap(v2.props);
+          if (cur != null && cur !== reuse._propsSnap) {
+            const key = `${compName(v2.type)}:${cur.slice(0, 40)}`;
+            if (!warnedContentChange.has(key)) {
+              warnedContentChange.add(key);
+              console.warn(
+                `[vdom3/audit] \u7EC4\u4EF6 ${compName(v2.type)} \u7684 props \u5BF9\u8C61\u5185\u5BB9\u5DF2\u53D8\u4F46\u5F15\u7528\u672A\u53D8\uFF08\u539F\u5730\u4FEE\u6539\u5BF9\u8C61\uFF1F\uFF09\u2014\u2014\u526A\u679D\u5C06\u8DF3\u8FC7\u91CD\u6E32\u67D3\u2014\u2014\u8BF7\u65B0\u5EFA\u5BF9\u8C61\u4F20 props\uFF08props \u4E0D\u53EF\u53D8\u5951\u7EA6\uFF09`
+              );
+            }
+          }
+        }
+        stream.emit(ev("comp", "build", v2._id, { name: compName(v2.type), reused: true, index: true, reason: "reuse-skip", propsKeys: Object.keys(v2.props) }));
+        v2._propsSnap = propsSnap(v2.props);
         return v2;
       }
       const changedKeys = Object.keys({ ...reuse.props, ...v2.props }).filter((k) => reuse.props[k] !== v2.props[k]);
       stream.emit(ev("props", "update", v2._id, { name: compName(v2.type), keys: changedKeys }));
+      v2._propsSnap = propsSnap(v2.props);
+      stream.emit(ev("comp", "build", v2._id, { name: compName(v2.type), reused: true, index: true, reason: isRoot ? "root-render" : "props-changed", changedKeys }));
     } else {
       v2._id = nextNodeId();
       indexComponent(v2);
-      stream.emit(ev("comp", "build", v2._id, { name: compName(v2.type), reused: false, index: true }));
+      stream.emit(ev("comp", "build", v2._id, { name: compName(v2.type), reused: false, index: true, reason: "mount" }));
       stream.emit(ev("comp", "mount", v2._id, { name: compName(v2.type) }));
       const compId = v2._id;
       const componentRender = () => {
@@ -5423,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);
         })
@@ -5437,6 +5538,7 @@ async function buildVNode(vnode, ctx, oldV, isRoot = false) {
         throw e;
       }
       v2._render = renderFn;
+      v2._propsSnap = propsSnap(v2.props);
     }
     stream.emit(ev("comp", "render", v2._id, { name: compName(v2.type) }));
     let output = null;
@@ -5535,7 +5637,11 @@ async function renderToEvents(vnode) {
     }
     events.push(ev("node", "insert", id, { parent: parentId, ref: null }));
     for (const c of childrenOf(v)) {
-      if (typeof c === "string" || typeof c === "number") {
+      if (c == null || c === false || c === true) {
+        const hid = nextId();
+        events.push(ev("node", "create", hid, { kind: "hole" }));
+        events.push(ev("node", "insert", hid, { parent: id, ref: null }));
+      } else if (typeof c === "string" || typeof c === "number") {
         const tid = nextId();
         events.push(ev("text", "create", tid, { value: String(c) }));
         events.push(ev("node", "insert", tid, { parent: id, ref: null }));
@@ -5551,9 +5657,13 @@ function eventsToHtml(events) {
   const tags = /* @__PURE__ */ new Map();
   const attrs = /* @__PURE__ */ new Map();
   const texts = /* @__PURE__ */ new Map();
+  const holes = /* @__PURE__ */ new Set();
   for (const e of events) {
-    if (e.entity === "node" && e.action === "create") tags.set(e.target, e.payload.tag);
-    else if (e.entity === "prop" && e.action === "update") {
+    if (e.entity === "node" && e.action === "create") {
+      const pl = e.payload;
+      if (pl.kind === "hole") holes.add(e.target);
+      else tags.set(e.target, pl.tag);
+    } else if (e.entity === "prop" && e.action === "update") {
       const pl = e.payload;
       const m = attrs.get(e.target) ?? /* @__PURE__ */ new Map();
       if (pl.value == null || pl.value === false) m.delete(pl.key);
@@ -5572,6 +5682,7 @@ function eventsToHtml(events) {
   }
   const esc = (s) => s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
   const emit = (id) => {
+    if (holes.has(id)) return "<!--wf-hole-->";
     const tag = tags.get(id);
     if (tag) {
       const a = attrs.get(id);

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;