weifuwu 0.84.0 → 0.85.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}`;
@@ -5367,6 +5410,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 +5445,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 = () => {
@@ -5437,6 +5511,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 +5610,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 +5630,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 +5655,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);