@vmz/core 0.0.2 → 0.0.3

package/README.md

@@ -31,7 +31,8 @@ state write
   -> direct patch / switch / reconcile
 ```
 
-There is no default detour through “execute every component that might matter, build virtual nodes, then compare them.” If analysis must widen, it widens to a safe region and should preserve the reason.
+There is no default detour through “execute every component that might matter, build virtual nodes, then compare them.”
+If analysis must widen, it widens to a safe region and should preserve the reason.
 
 ## More than DOM updates
 
@@ -41,7 +42,8 @@ There is no default detour through “execute every component that might matter,
 - **Resumption:** the browser attaches to server-produced work at the smallest reachable boundary.
 - **Zero-JS delivery:** pages with no interactive requirement do not need an eager framework shell.
 
-The runtime should not grow a second compiler made of reflection, string dependencies, or generic proxies. Its quality comes from faithfully executing the generated plan while keeping the production surface focused.
+The runtime should not grow a second compiler made of reflection, string dependencies, or generic proxies. Its quality
+comes from faithfully executing the generated plan while keeping the production surface focused.
 
 ## License
 

package/dist/dom.d.ts

@@ -1,7 +1,6 @@
 /**
  * VMZ DOM / SSR runtime — precise patches, no VDOM diff.
  *
- * Design: 规划设计/vmz/04 · Gate 3 (no production `render()`)
  *
  * Direct components expose `__vmzCreate` / `__vmzSerialize` / `__vmzPlan`.
  * Mount, SSR, hydrate, and resume all run that same schedule.
@@ -14,7 +13,7 @@ export declare function __vmzTraceEnable(on?: boolean): void;
 export declare function __vmzPrecisionReset(): void;
 export declare function __vmzTraceReset(): void;
 /**
- * X5 StableId event snapshot (`vmz.dx.trace.v0` shape without schema stamp —
+ * StableId event snapshot (`vmz.dx.trace.v0` shape without schema stamp —
  * host may wrap via ingestRuntimeTrace).
  * @returns {{ schema: string, events: typeof traceBuf.events, status: string }}
  */
@@ -58,14 +57,14 @@ export declare function renderToString(Component: any, props?: {}): Promise<any>
 export declare function renderToStream(Component: any, props?: {}, opts?: {}): AsyncGenerator<any, void, unknown>;
 /**
  * Mount once; later updates are dep patches only (never re-run structure).
- * Requires compiler `__vmzCreate` (Gate 3 — no blueprint fallback).
+ * Requires compiler `__vmzCreate` (production Direct emit — no blueprint fallback).
  * @param {new (props?: object) => any} Component
  * @param {Element} container
  * @param {object} [props]
  */
 export declare function mount(Component: any, container: any, props?: {}): Promise<any>;
 /**
- * Snapshot plain state/prop field values for Island HMR (N4.3).
+ * Snapshot plain state/prop field values for Island HMR (session).
  * @param {object} inst
  * @returns {Record<string, unknown> | null}
  */
@@ -76,7 +75,7 @@ export declare function snapshotInstanceState(inst: any): {};
  */
 export declare function applyPreservedState(inst: any, state: any): void;
 /**
- * L5: attach to existing Island DOM without re-running construct structure or onMount.
+ * resume: attach to existing Island DOM without re-running construct structure or onMount.
  * Consumes ResumeEntry product (`data-vmz-resume`) derived from the same Execution Plan.
  * @param {new (props?: object) => any} Component
  * @param {HTMLElement} container
@@ -105,12 +104,12 @@ export declare function hydrate(Component: any, container: any, props?: {}, opts
 /**
  * Tear down binders and stop patches. Safe to call more than once.
  * Field writes after destroy no longer update DOM (values may still change).
- * L4: also dispose owned DOM trees (child __vmzInst / region __vmzDispose).
+ *: also dispose owned DOM trees (child __vmzInst / region __vmzDispose).
  * @param {object} inst
  */
 export declare function destroy(inst: any): void;
 /**
- * L4: walk a DOM subtree and run lifetime dispose hooks + nested instance destroy.
+ *: walk a DOM subtree and run lifetime dispose hooks + nested instance destroy.
  * Does not mark the *calling* parent destroyed; safe from destroy(inst).
  * @param {Node | null | undefined} root
  */
@@ -135,7 +134,6 @@ export declare function __vmzCancelTasks(inst: any): void;
 export declare function __vmzTaskStatus(inst: any, key: any): any;
 /**
  * Mark a plain object as intentionally shared across ownership boundaries.
- * Suppresses cross-component shared diagnostics (规划设计/vmz/13 §7.3).
  * @param {any} value
  */
 export declare function __vmzAllowShared(value: any): any;
@@ -167,7 +165,6 @@ export declare function __vmzReadPath(inst: any, root: any, segs: any): any;
  */
 export declare function __vmzWritePathLogical(inst: any, root: any, segs: any, kind: any, rhs: any): any;
 /**
- * Compiler-inserted path write barrier (规划设计/vmz/13 §7.3).
  * Mutates a plain owned object/array and schedules the same path notice Proxy would.
  *
  * Root-array index assigns (`tags[0] = x`) notify as field replace (structural),
@@ -193,7 +190,7 @@ export declare function __vmzWritePath(inst: any, root: any, segs: any, value: a
  */
 export declare function __vmzArrayMutate(inst: any, root: any, baseSegs: any, method: any, args: any): any;
 /**
- * L4 WriteBarrier: true when value is an owned plain object with path barriers (no Proxy).
+ * WriteBarrier: true when value is an owned plain object with path barriers (no Proxy).
  * @param {any} value
  */
 export declare function __vmzIsWriteBarrierOwned(value: any): boolean;

package/dist/dom.js

@@ -2,7 +2,6 @@
 /**
  * VMZ DOM / SSR runtime — precise patches, no VDOM diff.
  *
- * Design: 规划设计/vmz/04 · Gate 3 (no production `render()`)
  *
  * Direct components expose `__vmzCreate` / `__vmzSerialize` / `__vmzPlan`.
  * Mount, SSR, hydrate, and resume all run that same schedule.
@@ -12,7 +11,6 @@
 const components = Object.create(null);
 /**
  * Precision lab counters (test / MCP / benchmarks — not a user API).
- * Design: 规划设计/vmz/12 §7
  * Primary keys: BindingId (IR). `*ByDep` is transitional stable-string adapter.
  */
 const precision = {
@@ -35,7 +33,7 @@ const precision = {
     /** @type {Record<string, number>} BindingId → count */
     patchesByBinding: Object.create(null),
 };
-/** X5: optional StableId event ring (enabled with precision or __vmzTraceEnable). */
+/** optional StableId event ring (enabled with precision or __vmzTraceEnable). */
 const TRACE_CAP = 256;
 /** @type {{ enabled: boolean, events: Array<{ kind: string, stableId: { kind: string, id: string }, dep?: string|null, t?: number, chunkId?: string|null }> }} */
 const traceBuf = {
@@ -86,7 +84,7 @@ export function __vmzTraceReset() {
     traceBuf.events = [];
 }
 /**
- * X5 StableId event snapshot (`vmz.dx.trace.v0` shape without schema stamp —
+ * StableId event snapshot (`vmz.dx.trace.v0` shape without schema stamp —
  * host may wrap via ingestRuntimeTrace).
  * @returns {{ schema: string, events: typeof traceBuf.events, status: string }}
  */
@@ -117,7 +115,7 @@ export function __vmzPrecisionSnapshot() {
     };
 }
 /**
- * @param {() => any} fn
+ * @param { => any} fn
  * @param {string | null} [depKey]
  * @param {number | string | null} [bindingId]
  */
@@ -173,9 +171,9 @@ export async function renderToString(Component, props = {}) {
     if (typeof inst.onMount === 'function') {
         await inst.onMount();
     }
-    // Gate 3: SSR only via Direct serialize schedule — never `render()`.
+    // production Direct emit: SSR only via Direct serialize schedule — never `render`.
     if (!(Component && Component.__vmzDirect && typeof Component.__vmzCreate === 'function')) {
-        throw new Error(`vmz:dom renderToString() requires __vmzCreate (Direct); blueprint render() removed (Gate 3)`);
+        throw new Error(`vmz:dom renderToString() requires __vmzCreate (Direct); blueprint render() removed (production Direct emit)`);
     }
     const root = await runDirectSerializeTreeWithMounts(Component, inst);
     return flattenSerializeNode(root);
@@ -202,7 +200,7 @@ export async function* renderToStream(Component, props = {}, opts = {}) {
         if (aborted())
             return;
         if (!(Component && Component.__vmzDirect && typeof Component.__vmzCreate === 'function')) {
-            throw new Error(`vmz:dom renderToStream() requires __vmzCreate (Direct); blueprint render() removed (Gate 3)`);
+            throw new Error(`vmz:dom renderToStream() requires __vmzCreate (Direct); blueprint render() removed (production Direct emit)`);
         }
         const root = await runDirectSerializeTreeWithMounts(Component, inst);
         if (aborted())
@@ -216,13 +214,13 @@ export async function* renderToStream(Component, props = {}, opts = {}) {
         }
     }
     finally {
-        // Abort and normal completion both dispose the SSR instance (L4 lifetime).
+        // Abort and normal completion both dispose the SSR instance (lifetime).
         destroy(inst);
     }
 }
 /**
  * Mount once; later updates are dep patches only (never re-run structure).
- * Requires compiler `__vmzCreate` (Gate 3 — no blueprint fallback).
+ * Requires compiler `__vmzCreate` (production Direct emit — no blueprint fallback).
  * @param {new (props?: object) => any} Component
  * @param {Element} container
  * @param {object} [props]
@@ -250,7 +248,7 @@ export async function mount(Component, container, props = {}) {
     return inst;
 }
 /**
- * Nested Direct `component()` schedules child onMount asynchronously; drain before return
+ * Nested Direct `component` schedules child onMount asynchronously; drain before return
  * so SSR/hydrate callers see post-mount DOM (e.g. UserCard Ada, not Loading…).
  * @param {object} inst
  */
@@ -275,7 +273,7 @@ async function settlePendingChildMounts(inst) {
     }
 }
 /**
- * Direct create only (Gate 3).
+ * Direct create only (production Direct emit).
  * @param {new (props?: object) => any} Component
  * @param {object} inst
  */
@@ -283,7 +281,7 @@ async function createFromComponent(Component, inst) {
     if (Component && Component.__vmzDirect && typeof Component.__vmzCreate === 'function') {
         return runDirectCreate(Component, inst);
     }
-    throw new Error(`vmz:dom mount requires __vmzCreate (Direct); blueprint render() removed (Gate 3)`);
+    throw new Error(`vmz:dom mount requires __vmzCreate (Direct); blueprint render() removed (production Direct emit)`);
 }
 /**
  * @param {new (props?: object) => any} Component
@@ -299,7 +297,7 @@ function runDirectCreate(Component, inst) {
     }
 }
 /**
- * L3 SSR: run the same __vmzCreate schedule against a serialize host (no render()).
+ * SSR: run the same __vmzCreate schedule against a serialize host (no render).
  * @param {new (props?: object) => any} Component
  * @param {object} inst
  */
@@ -609,7 +607,7 @@ const serializeApi = {
                 resolved[k] = v;
         }
         if (client) {
-            // L5: Island SSR includes body + ResumeEntry slice (same Direct schedule).
+            // resume: Island SSR includes body + ResumeEntry slice (same Direct schedule).
             const child = serializeApi._ssrChildInstance(Ctor, resolved);
             let body = null;
             if (Ctor.__vmzDirect && typeof Ctor.__vmzCreate === 'function') {
@@ -683,15 +681,15 @@ const serializeApi = {
 const directApi = {
     /** @type {object | null} */
     _inst: null,
-    /** @type {Array<{ deps: string[], fn: () => any, bindingId?: number|string|null }> | null} */
+    /** @type {Array<{ deps: string[], fn: => any, bindingId?: number|string|null }> | null} */
     _branchBinds: null,
-    /** @type {Array<() => void> | null} */
+    /** @type {Array< => void> | null} */
     _itemPatches: null,
     /**
-     * Active keyed-each context (P0/P1): item binds + event delegation.
+     * Active keyed-each context (/): item binds + event delegation.
      * @type {null | {
-     *   noteItemBind: (bindingId: number|string|null, deps: string[], fn: () => void) => void,
-     *   needDelegate: (type: string) => void,
+     * noteItemBind: (bindingId: number|string|null, deps: string[], fn: => void) => void,
+     * needDelegate: (type: string) => void,
      * }}
      */
     _eachCtx: null,
@@ -735,9 +733,9 @@ const directApi = {
      * @param {object} inst
      * @param {number|string|null} bindingId
      * @param {string[]} deps
-     * @param {() => any} get
+     * @param { => any} get
      * @param {Text} textNode
-     * @param {{ stable: string[], branches: Array<{ cond?: () => any, deps: string[] }> } | null | undefined} [cf]
+     * @param {{ stable: string[], branches: Array<{ cond?: => any, deps: string[] }> } | null | undefined} [cf]
      */
     bindText(inst, bindingId, deps, get, textNode, cf) {
         wireDirectBind(inst, bindingId, deps, get, (raw) => {
@@ -748,10 +746,10 @@ const directApi = {
      * @param {object} inst
      * @param {number|string|null} bindingId
      * @param {string[]} deps
-     * @param {() => any} get
+     * @param { => any} get
      * @param {Element} el
      * @param {string} name
-     * @param {{ stable: string[], branches: Array<{ cond?: () => any, deps: string[] }> } | null | undefined} [cf]
+     * @param {{ stable: string[], branches: Array<{ cond?: => any, deps: string[] }> } | null | undefined} [cf]
      */
     bindAttr(inst, bindingId, deps, get, el, name, cf) {
         wireDirectBind(inst, bindingId, deps, get, (raw) => {
@@ -774,9 +772,9 @@ const directApi = {
      * @param {object} inst
      * @param {number|string|null} bindingId
      * @param {string[]} deps
-     * @param {() => any} get
+     * @param { => any} get
      * @param {Element} el
-     * @param {{ stable: string[], branches: Array<{ cond?: () => any, deps: string[] }> } | null | undefined} [cf]
+     * @param {{ stable: string[], branches: Array<{ cond?: => any, deps: string[] }> } | null | undefined} [cf]
      */
     bindHtml(inst, bindingId, deps, get, el, cf) {
         wireDirectBind(inst, bindingId, deps, get, (raw) => {
@@ -811,7 +809,7 @@ const directApi = {
             if (isEventEntryStrategy(String(client))) {
                 host.setAttribute('data-vmz-entry', 'event');
             }
-            // L5: resume on schedule; EventEntry may lazy-load chunk via __vmzLoadComponent.
+            // resume: resume on schedule; EventEntry may lazy-load chunk via __vmzLoadComponent.
             scheduleClientOn(host, String(client), async () => {
                 const Ctor = await resolveComponent(name);
                 if (!Ctor)
@@ -848,7 +846,7 @@ const directApi = {
      * @param {object} inst
      * @param {number|string|null} bindingId
      * @param {string[]} deps
-     * @param {Array<{ cond?: () => any, create: (api: typeof directApi) => Node }>} branches
+     * @param {Array<{ cond?: => any, create: (api: typeof directApi) => Node }>} branches
      * @param {number|string|null} [regionId]
      */
     ifBlock(inst, bindingId, deps, branches, regionId = null) {
@@ -859,7 +857,7 @@ const directApi = {
             host.setAttribute('data-vmz-region', String(regionId));
         /** @type {Array<Node | null>} */
         const cached = branches.map(() => null);
-        /** @type {Array<Array<{ deps: string[], fn: () => any, bindingId?: number|string|null }>>} */
+        /** @type {Array<Array<{ deps: string[], fn: => any, bindingId?: number|string|null }>>} */
         const branchBinds = branches.map(() => []);
         let active = -1;
         let gen = 0;
@@ -945,7 +943,7 @@ const directApi = {
         registerBind(inst, deps || [], apply, bindingId);
         if (directApi._itemPatches)
             directApi._itemPatches.push(apply);
-        // L4: parent destroy disposes all cached branch trees (pause ≠ destroy on switch).
+        // parent destroy disposes all cached branch trees (pause ≠ destroy on switch).
         host.__vmzDispose = () => {
             for (let i = 0; i < cached.length; i++) {
                 unwireBranch(i);
@@ -960,11 +958,11 @@ const directApi = {
     },
     /**
      * Direct keyed each — no blueprint `kind: "each"` dispatch.
-     * P0/P1: Set/Map + Fragment batch insert; item-local binds; host selected; event delegate.
+     * /: Set/Map + Fragment batch insert; item-local binds; host selected; event delegate.
      * @param {object} inst
      * @param {number|string|null} bindingId
      * @param {string[]} deps
-     * @param {{ as?: string, list: () => any, key?: (box: {item:any,index:number}) => any, createItem: (api: typeof directApi, box: {item:any,index:number}) => Node }} spec
+     * @param {{ as?: string, list: => any, key?: (box: {item:any,index:number}) => any, createItem: (api: typeof directApi, box: {item:any,index:number}) => Node }} spec
      * @param {number|string|null} [regionId]
      */
     eachBlock(inst, bindingId, deps, spec, regionId = null) {
@@ -975,10 +973,10 @@ const directApi = {
         const frag = document.createDocumentFragment();
         frag.appendChild(start);
         frag.appendChild(end);
-        /** @type {Map<any, { box: { item: any, index: number }, dom: Node, patches: Array<() => void> }>} */
+        /** @type {Map<any, { box: { item: any, index: number }, dom: Node, patches: Array< => void> }>} */
         const keyed = new Map();
         let gen = 0;
-        /** @type {Map<string, () => void>} */
+        /** @type {Map<string, => void>} */
         const listDispatchers = new Map();
         /** @type {Set<string>} */
         const hostDispatchers = new Set();
@@ -1227,7 +1225,6 @@ const directApi = {
                 const box = { item: list[i], index: i };
                 const k = itemKey(box);
                 if (seen.has(k)) {
-                    console.error(`vmz:dom each: duplicate key ${String(k)} — undefined reuse; fix the key expression (规划设计/vmz/10 §7)`);
                 }
                 seen.add(k);
                 let entry = keyed.get(k);
@@ -1318,7 +1315,7 @@ const directApi = {
                 entry.box.index = i;
                 tagItemPatches(entry.patches, i);
                 for (const p of entry.patches) {
-                    // Leaf BindingId patches are owned by list/host dispatchers (P1).
+                    // Leaf BindingId patches are owned by list/host dispatchers .
                     if (p.__vmzBindingId != null)
                         continue;
                     if (patchHasBindingId(inst, p))
@@ -1340,7 +1337,7 @@ const directApi = {
 /**
  * @param {object} inst
  * @param {string[]} deps
- * @param {() => any} fn
+ * @param { => any} fn
  * @param {number|string|null|undefined} bindingId
  */
 function trackDirectBind(inst, deps, fn, bindingId = null) {
@@ -1350,7 +1347,7 @@ function trackDirectBind(inst, deps, fn, bindingId = null) {
             directApi._itemPatches.push(fn);
         return;
     }
-    // P1: item binds stay on entry.patches; eachBlock registers one dispatcher per BindingId.
+    // item binds stay on entry.patches; eachBlock registers one dispatcher per BindingId.
     if (directApi._itemPatches) {
         fn.__vmzItemLocal = true;
         directApi._itemPatches.push(fn);
@@ -1365,9 +1362,9 @@ function trackDirectBind(inst, deps, fn, bindingId = null) {
  * @param {object} inst
  * @param {number|string|null} bindingId
  * @param {string[]} deps
- * @param {() => any} get
+ * @param { => any} get
  * @param {(raw: any) => void} write
- * @param {{ stable: string[], branches: Array<{ cond?: () => any, deps: string[] }> } | null | undefined} [cf]
+ * @param {{ stable: string[], branches: Array<{ cond?: => any, deps: string[] }> } | null | undefined} [cf]
  */
 function wireDirectBind(inst, bindingId, deps, get, write, cf) {
     let activeBranch = -1;
@@ -1416,7 +1413,7 @@ function wireDirectBind(inst, bindingId, deps, get, write, cf) {
         const branch = cf.branches[next];
         const nextDeps = [...(cf.stable || []), ...((branch && branch.deps) || [])];
         const uniq = [...new Set(nextDeps)];
-        // Item-local binds must never enter the global binder table (P1 / jfb select).
+        // Item-local binds must never enter the global binder table ( / jfb select).
         if (apply.__vmzItemLocal) {
             liveDeps = uniq;
             return;
@@ -1475,7 +1472,7 @@ function eachHostApi(start, end) {
     };
 }
 /**
- * Snapshot plain state/prop field values for Island HMR (N4.3).
+ * Snapshot plain state/prop field values for Island HMR (session).
  * @param {object} inst
  * @returns {Record<string, unknown> | null}
  */
@@ -1515,7 +1512,7 @@ export function applyPreservedState(inst, state) {
     }
 }
 /**
- * L5: attach to existing Island DOM without re-running construct structure or onMount.
+ * resume: attach to existing Island DOM without re-running construct structure or onMount.
  * Consumes ResumeEntry product (`data-vmz-resume`) derived from the same Execution Plan.
  * @param {new (props?: object) => any} Component
  * @param {HTMLElement} container
@@ -1565,14 +1562,14 @@ export async function resume(Component, container, slice = null) {
             }
         }
         else {
-            // Island leaf adopt: preserve Element identity (L5 nodeIdentity).
+            // Island leaf adopt: preserve Element identity (resume nodeIdentity).
             const node = runDirectResume(Component, inst, container);
             if (node)
                 inst.__vmzDomRoot = node;
         }
     }
     else {
-        throw new Error(`vmz:dom resume() requires __vmzCreate (Direct); blueprint render() removed (Gate 3)`);
+        throw new Error(`vmz:dom resume() requires __vmzCreate (Direct); blueprint render() removed (production Direct emit)`);
     }
     container.__vmzInst = inst;
     container.__vmzResumed = true;
@@ -1628,7 +1625,7 @@ export function attachEventEntries(root = globalThis.document) {
     }
 }
 /**
- * Adopt existing Island DOM while running the same `__vmzCreate` schedule (L5).
+ * Adopt existing Island DOM while running the same `__vmzCreate` schedule (resume).
  * @param {new (props?: object) => any} Component
  * @param {object} inst
  * @param {Element} container
@@ -1712,9 +1709,9 @@ export async function hydrate(Component, container, props = {}, opts = {}) {
     if (preserved) {
         applyPreservedState(inst, preserved);
     }
-    // Gate 3: hydrate uses the same Direct schedule as resume (no render()).
+    // production Direct emit: hydrate uses the same Direct schedule as resume (no render).
     if (!(Component && Component.__vmzDirect && typeof Component.__vmzCreate === 'function')) {
-        throw new Error(`vmz:dom hydrate() requires __vmzCreate (Direct); blueprint render() removed (Gate 3)`);
+        throw new Error(`vmz:dom hydrate() requires __vmzCreate (Direct); blueprint render() removed (production Direct emit)`);
     }
     // Wire DOM + events BEFORE awaiting onMount. SSR shell is already visible; if we
     // wait on RPC/bootstrap first, buttons look real but have no listeners (dead UI).
@@ -1747,7 +1744,7 @@ export async function hydrate(Component, container, props = {}, opts = {}) {
 /**
  * Tear down binders and stop patches. Safe to call more than once.
  * Field writes after destroy no longer update DOM (values may still change).
- * L4: also dispose owned DOM trees (child __vmzInst / region __vmzDispose).
+ *: also dispose owned DOM trees (child __vmzInst / region __vmzDispose).
  * @param {object} inst
  */
 export function destroy(inst) {
@@ -1755,7 +1752,7 @@ export function destroy(inst) {
         return;
     inst.__vmzDestroyed = true;
     inst.__vmzFlushScheduled = false;
-    // L4 async cancel: abort in-flight tasks before tearing down DOM.
+    // async cancel: abort in-flight tasks before tearing down DOM.
     __vmzCancelTasks(inst);
     if (inst.__vmzDomRoot) {
         disposeDomTree(inst.__vmzDomRoot);
@@ -1780,7 +1777,7 @@ export function destroy(inst) {
     }
 }
 /**
- * L4: walk a DOM subtree and run lifetime dispose hooks + nested instance destroy.
+ *: walk a DOM subtree and run lifetime dispose hooks + nested instance destroy.
  * Does not mark the *calling* parent destroyed; safe from destroy(inst).
  * @param {Node | null | undefined} root
  */
@@ -1819,7 +1816,7 @@ export function disposeDomTree(root) {
  * @param {ParentNode} [root]
  */
 export function hydrateIslands(root = globalThis.document) {
-    // L5: hydrateIslands is an alias for resumeIslands (same Plan attach).
+    // resume: hydrateIslands is an alias for resumeIslands (same Plan attach).
     return resumeIslands(root);
 }
 export function scheduleClient(strategy, fn) {
@@ -1841,7 +1838,7 @@ function eventEntryType(strategy) {
 }
 function scheduleClientOn(el, strategy, fn) {
     const run = () => {
-        Promise.resolve(fn()).catch((err) => console.error('vmz:dom island', err));
+        Promise.resolve(fn).catch((err) => console.error('vmz:dom island', err));
     };
     if (isEventEntryStrategy(strategy)) {
         if (!el || typeof el.addEventListener !== 'function') {
@@ -1918,7 +1915,7 @@ export function __vmzRunTask(inst, key, fn) {
         status: 'pending',
     };
     inst.__vmzTasks[k] = entry;
-    // Invoke synchronously so event handlers can call preventDefault() before
+    // Invoke synchronously so event handlers can call preventDefault before
     // the browser continues the default action (form submit → native navigation).
     // Async work still continues via the returned Promise.
     let syncResult;
@@ -1992,7 +1989,7 @@ function createInstance(Component, props = {}) {
     inst.__vmzDepToBindings = Object.create(null);
     makeReactive(inst, Component.__vmzState || []);
     makeReactive(inst, Component.__vmzProps || []);
-    // L4 WriteBarrier: path / array writes call Component helpers (no import needed).
+    // WriteBarrier: path / array writes call Component helpers (no import needed).
     Component.__vmzWritePath = __vmzWritePath;
     Component.__vmzWritePathLogical = __vmzWritePathLogical;
     Component.__vmzReadPath = __vmzReadPath;
@@ -2003,13 +2000,12 @@ function createInstance(Component, props = {}) {
 }
 /** Shared plain-object owners under WriteBarrier (no Proxy). */
 const wbSharedOwners = new WeakMap();
-/** Objects explicitly marked OK to share across component instances (13 §7.3). */
+/** Objects explicitly marked OK to share across component instances (13 ). */
 const wbAllowShared = new WeakSet();
 /** @type {Array<{ kind: string, message: string }>} */
 const wbCrossComponentDiags = [];
 /**
  * Mark a plain object as intentionally shared across ownership boundaries.
- * Suppresses cross-component shared diagnostics (规划设计/vmz/13 §7.3).
  * @param {any} value
  */
 export function __vmzAllowShared(value) {
@@ -2056,11 +2052,10 @@ function registerWbOwner(value, report, baseSegs = [], inst = null) {
         return;
     }
     entry.owners.push({ report, baseSegs: baseSegs.slice(), inst });
-    // Cross-component share without explicit allow → diagnose (13 §7.3).
+    // Cross-component share without explicit allow → diagnose (13 ).
     if (!wbAllowShared.has(value) && inst) {
         const other = entry.owners.find((o) => o.inst && o.inst !== inst);
         if (other) {
-            const msg = 'vmz: plain object shared across component instances without __vmzAllowShared (规划设计/vmz/13 §7.3)';
             if (!wbCrossComponentDiags.some((d) => d.message === msg)) {
                 wbCrossComponentDiags.push({ kind: 'shared_cross_component', message: msg });
             }
@@ -2134,7 +2129,6 @@ export function __vmzWritePathLogical(inst, root, segs, kind, rhs) {
     return __vmzWritePath(inst, root, segs, rhs);
 }
 /**
- * Compiler-inserted path write barrier (规划设计/vmz/13 §7.3).
  * Mutates a plain owned object/array and schedules the same path notice Proxy would.
  *
  * Root-array index assigns (`tags[0] = x`) notify as field replace (structural),
@@ -2273,7 +2267,7 @@ const reactiveProxies = new WeakMap();
 /** Plain objects using defineProperty write barriers (not Proxy). */
 const writeBarrierOwned = new WeakSet();
 /**
- * L4 WriteBarrier: true when value is an owned plain object with path barriers (no Proxy).
+ * WriteBarrier: true when value is an owned plain object with path barriers (no Proxy).
  * @param {any} value
  */
 export function __vmzIsWriteBarrierOwned(value) {
@@ -2331,7 +2325,7 @@ function notifyOwners(owners, localSegs) {
 }
 /**
  * Field-owned write traps for plain objects / arrays on state fields.
- * Plain objects: WriteBarrier via defineProperty (no Proxy) — L4 / 13 §7.3.
+ * Plain objects: WriteBarrier via defineProperty (no Proxy) — .
  * Arrays: transitional Proxy until keyed collection barriers land.
  * Shared raw objects notify **all** current owners.
  *
@@ -2532,11 +2526,10 @@ function wrapArray(arr, report, pathSegs) {
  * Still precise deps — never a full-tree re-render. Flush runs as a microtask;
  * call `await flushPending(inst)` to apply synchronously (tests / immediate UI).
  *
- * Design: 规划设计/vmz/12 §6 — parent write covers children; siblings stay separate.
  *
  * @param {object} inst
  * @param {{ type: 'replace', root: string } | { type: 'path', root: string, segs: string[] } | string} notice
- *        string form is transitional field-root alias for replace.
+ * string form is transitional field-root alias for replace.
  */
 function scheduleRefresh(inst, notice) {
     if (!inst || inst.__vmzDestroyed)
@@ -2822,7 +2815,6 @@ function pathDirtyCovers(node, depSegs) {
 }
 /**
  * Dual-track match retained for tests / tooling.
- * Design: 规划设计/vmz/11 §2.2 + 12 §6 parent-covers-children.
  * @param {{ type: string, root: string, segs?: string[] }} notice
  * @param {string} key
  */
@@ -2971,7 +2963,7 @@ function reindexBindingDeps(inst, bindingId, deps) {
 /**
  * @param {object} inst
  * @param {string[]} deps
- * @param {() => any} fn
+ * @param { => any} fn
  * @param {number|string|null|undefined} [bindingId]
  */
 function registerBind(inst, deps, fn, bindingId = null) {
@@ -2998,7 +2990,7 @@ function registerBind(inst, deps, fn, bindingId = null) {
 /**
  * @param {object} inst
  * @param {string[]} deps
- * @param {() => any} fn
+ * @param { => any} fn
  * @param {number|string|null|undefined} [bindingId]
  */
 function unregisterBind(inst, deps, fn, bindingId = null) {

package/dist/serve-host.mjs

@@ -9,8 +9,8 @@
  *
  * `VMZ_DEV=1`: POST `/__vmz/reload` soft-reloads modules (cache-bust import);
  * GET `/__vmz/events` SSE notifies the browser:
- *   - island HMR → re-import `entry-client.js` (no full document reload)
- *   - otherwise → `location.reload()`
+ * - island HMR → re-import `entry-client.js` (no full document reload)
+ * - otherwise → `location.reload`
  */
 import http from 'node:http';
 import path from 'node:path';

package/dist/server.d.ts

@@ -1,13 +1,12 @@
 /**
  * Minimal VMZ runtime — `#server` invoke + RPC/REST HTTP + optional static/SSR.
  *
- * Design: 规划设计/vmz/08-虚拟server.md, 07-REST接口.md
  *
  * Browser-safe: no static `node:*` imports. Node builtins are loaded only inside
  * Node/SSR request handlers so client bundles can `import { callServer }`.
  */
 /**
- * Map `#server/foo` → filesystem / URL the host can `import()`.
+ * Map `#server/foo` → filesystem / URL the host can `import`.
  * Only set this in Node/SSR hosts — browser bundles must omit it so RPC goes HTTP.
  */
 export declare function setServerModuleResolver(fn: any): void;

package/dist/server.js

@@ -2,7 +2,6 @@
 /**
  * Minimal VMZ runtime — `#server` invoke + RPC/REST HTTP + optional static/SSR.
  *
- * Design: 规划设计/vmz/08-虚拟server.md, 07-REST接口.md
  *
  * Browser-safe: no static `node:*` imports. Node builtins are loaded only inside
  * Node/SSR request handlers so client bundles can `import { callServer }`.
@@ -11,12 +10,12 @@
 /** @typedef {{ verb: string, path: string, moduleId: string, method: string, className?: string }} Route */
 /**
  * @typedef {{
- *   distDir?: string,
- *   renderIndex?: () => Promise<string> | string,
- *   renderIndexStream?: (opts?: { signal?: AbortSignal }) => AsyncIterable<string>,
- *   renderPage?: (pathname: string) => Promise<string | null> | string | null,
- *   renderPageStream?: (pathname: string, opts?: { signal?: AbortSignal, searchParams?: URLSearchParams, cookieHeader?: string }) => Promise<AsyncIterable<string> | null> | AsyncIterable<string> | null,
- *   req?: import('node:http').IncomingMessage,
+ * distDir?: string,
+ * renderIndex?: => Promise<string> | string,
+ * renderIndexStream?: (opts?: { signal?: AbortSignal }) => AsyncIterable<string>,
+ * renderPage?: (pathname: string) => Promise<string | null> | string | null,
+ * renderPageStream?: (pathname: string, opts?: { signal?: AbortSignal, searchParams?: URLSearchParams, cookieHeader?: string }) => Promise<AsyncIterable<string> | null> | AsyncIterable<string> | null,
+ * req?: import('node:http').IncomingMessage,
  * }} NodeRequestOptions
  */
 const DEFAULT_RPC_PATH = '/__vmz/rpc';
@@ -25,7 +24,7 @@ let resolveServerModule = null;
 /** @type {Route[]} */
 let routes = [];
 /**
- * Map `#server/foo` → filesystem / URL the host can `import()`.
+ * Map `#server/foo` → filesystem / URL the host can `import`.
  * Only set this in Node/SSR hosts — browser bundles must omit it so RPC goes HTTP.
  */
 export function setServerModuleResolver(fn) {