@vesk/runtime 0.2.41 → 0.2.43

package/dist/form.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,UAAU;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACrB;AAED,UAAU,SAAS;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACrB;AAsCD,wBAAgB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAErD;AAED,wBAAgB,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAElD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAEjE;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAEjE;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAEhE;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAEhF;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAoDhH;AA+GD,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CA8C9G"}
+{"version":3,"file":"form.d.ts","sourceRoot":"","sources":["../src/form.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC9B,QAAQ,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,UAAU;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACrB;AAED,UAAU,SAAS;IAClB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,eAAe,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACrB;AAsCD,wBAAgB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAErD;AAED,wBAAgB,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAElD;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAEjE;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAEjE;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAEhE;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,cAAc,CAEhF;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAoDhH;AA+GD,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,MAAM,CAoD9G"}

package/dist/form.js

@@ -244,7 +244,13 @@ export function Form(props, registry, hydrate) {
         return `<form ${attrStr}>${children || ''}</form>`;
     }
     if (hydrate && hydrate.nextElement) {
-        let form = hydrate.nextElement('form');
+        // The compiler may deposit the static residue that precedes this
+        // self-claiming component (for example <h1> before <Form>). Consume it
+        // before claiming the form root; otherwise the runtime would inspect
+        // the heading as the form slot, detach it as a mismatch, and only find
+        // the real form through the broad querySelector fallback.
+        const skipK = typeof hydrate.takeSkipK === 'function' ? hydrate.takeSkipK() : 0;
+        let form = hydrate.nextElement('form', skipK);
         if (form && !form.parentNode && hydrate.root) {
             const existing = hydrate.root.querySelector('form');
             if (existing)

package/dist/hydrate.d.ts

@@ -20,7 +20,7 @@ export interface ClaimByKeyOptions {
 export interface HydrateWalker {
     root: HTMLElement | null;
     done(): boolean;
-    nextElement(tag?: string): Element;
+    nextElement(tag?: string, skipK?: number): Element;
     /**
      * Claim an element like `nextElement` but without stripping its direct text
      * children. Used by static-component stubs whose SSR content is preserved

package/dist/hydrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../src/hydrate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../src/hydrate.ts"],"names":[],"mappings":"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"}

package/dist/hydrate.js

@@ -38,16 +38,32 @@ export function reactiveProps(props) {
 // ---------------------------------------------------------------------------
 // Dev-mode hydration-integrity canary (T1)
 //
-// Claiming the SSR DOM is inherently positional: a element claimed from the
-// wrong slot fails silently in production (the SSR node is adopted as-is). To
-// surface SSR/client divergence early, dev mode:
-//   * stamps every adopted node with `data-vsk-claimed`,
-//   * warns with the container fragment when a positional claim misses, and
-//   * runs `assertFullyHydrated()` at the end of every full hydration so
-//     unclaimed phantom markers are reported instead of rotting in the DOM.
+// Claiming the SSR DOM is inherently positional: an element claimed from the
+// wrong slot fails silently in production. Hydration bookkeeping therefore
+// lives in WeakMaps, never in DOM attributes. The canary audits the records at
+// the end of every full hydration and warns when markers or structural claim
+// records remain unresolved.
 // ---------------------------------------------------------------------------
 let __hydrateDevMode = true;
-const CLAIMED_ATTR = 'data-vsk-claimed';
+// The first map answers "was this element adopted?" without observable DOM
+// mutation. The second lets auditHydration inspect records even after a safe
+// recovery detached a ghost: walker records stay reachable from their live
+// owner root without keeping an otherwise-unreachable node globally alive.
+const claimRegistry = new WeakMap();
+const walkerClaimRecords = new WeakMap();
+function recordClaim(root, record) {
+    claimRegistry.set(record.el, record);
+    if (!root)
+        return;
+    const records = walkerClaimRecords.get(root);
+    if (records)
+        records.push(record);
+    else
+        walkerClaimRecords.set(root, [record]);
+}
+function isAdopted(el) {
+    return claimRegistry.get(el)?.state === 'adopted';
+}
 export function setHydrateDevMode(enabled) {
     __hydrateDevMode = enabled;
 }
@@ -89,16 +105,15 @@ function reportMiss(kind, detail, loud) {
     if (loud)
         devWarn(`${kind}: ${detail}`);
 }
-function stampClaimed(el) {
-    if (__hydrateDevMode) {
-        try {
-            el.setAttribute(CLAIMED_ATTR, '');
-        }
-        catch {
-            // Some hosts restrict attribute writes on special nodes (SVG,
-            // <template> children); claiming is still valid.
-        }
-    }
+function recordAdopted(root, el, expectedTag) {
+    recordClaim(root, {
+        state: 'adopted',
+        el,
+        owner: root,
+        expectedTag,
+        actualTag: el.tagName.toLowerCase(),
+        detached: false,
+    });
 }
 // Strip the direct text children of a claimed element. Static text inside a
 // claimed subtree is re-created client-side as fresh text nodes, so the
@@ -176,8 +191,8 @@ function scanTwins(container) {
         let a = false;
         let b = false;
         try {
-            a = el.hasAttribute(CLAIMED_ATTR);
-            b = prev.hasAttribute(CLAIMED_ATTR);
+            a = isAdopted(el);
+            b = isAdopted(prev);
         }
         catch {
             continue;
@@ -236,6 +251,32 @@ export function auditHydration(container) {
         if (!sample && container.outerHTML)
             sample = String(container.outerHTML).slice(0, 800);
     }
+    const structuralRecords = [];
+    const seenRecords = new Set();
+    const collectWalkerRecords = (el) => {
+        const records = walkerClaimRecords.get(el);
+        if (records) {
+            for (const record of records) {
+                if (!seenRecords.has(record)) {
+                    seenRecords.add(record);
+                    structuralRecords.push(record);
+                }
+            }
+        }
+        for (let i = 0; i < el.children.length; i++)
+            collectWalkerRecords(el.children[i]);
+    };
+    collectWalkerRecords(container);
+    const structuralGhosts = structuralRecords.filter((record) => record.state === 'ghost');
+    if (structuralGhosts.length > 0) {
+        unclaimed += structuralGhosts.length;
+        if (orphanNames.length < 5) {
+            orphanNames.push(`${structuralGhosts.length} structural hydration ghost(s) (${structuralGhosts
+                .slice(0, 3)
+                .map((record) => `<${record.actualTag}> expected <${record.expectedTag}>`)
+                .join(', ')})`);
+        }
+    }
     const twinRes = scanTwins(container);
     const issues = [];
     if (unclaimed > 0) {
@@ -268,6 +309,19 @@ export function auditHydration(container) {
                 // Best-effort repair; the report above already recorded it.
             }
         }
+        for (const record of structuralGhosts) {
+            try {
+                // Only detach a still-connected ghost whose immediate parent is
+                // the walker's own root. Never sweep arbitrary descendants.
+                if (record.detached || !record.owner || record.el.parentNode !== record.owner)
+                    continue;
+                record.el.remove();
+                record.detached = true;
+            }
+            catch {
+                // Best-effort repair; the report above already recorded it.
+            }
+        }
     }
     if (__mismatchHandler) {
         for (const issue of issues) {
@@ -308,7 +362,7 @@ export function assertFullyHydrated(container) {
 }
 function underClaimedAncestor(el, container) {
     for (let n = el; n && n !== container; n = n.parentElement) {
-        if (n.nodeType === 1 && n.hasAttribute(CLAIMED_ATTR))
+        if (n.nodeType === 1 && isAdopted(n))
             return true;
     }
     return false;
@@ -384,7 +438,7 @@ function checkMarkerIdentity(marker, el) {
         }
     }
 }
-function adoptElement(marker, tag) {
+function adoptElement(root, marker, tag) {
     const el = marker.nextElementSibling;
     if (!el) {
         marker.remove();
@@ -401,12 +455,12 @@ function adoptElement(marker, tag) {
     marker.remove();
     stripDirectTextNodes(el);
     captureSsrElementChildren(el);
-    stampClaimed(el);
+    recordAdopted(root, el, tag || el.tagName.toLowerCase());
     return el;
 }
 // Like adoptElement but preserves direct text children. Used by static-component
 // stubs whose SSR content is kept as-is (no client-side re-rendering).
-function adoptElementRaw(marker, tag) {
+function adoptElementRaw(root, marker, tag) {
     const el = marker.nextElementSibling;
     if (!el) {
         marker.remove();
@@ -417,7 +471,7 @@ function adoptElementRaw(marker, tag) {
     checkMarkerIdentity(marker, el);
     marker.remove();
     captureSsrElementChildren(el);
-    stampClaimed(el);
+    recordAdopted(root, el, tag || el.tagName.toLowerCase());
     return el;
 }
 class WalkerEngine {
@@ -513,7 +567,7 @@ class WalkerEngine {
                 break;
             }
             this.idx++;
-            const adopted = adoptElement(tm.comment, tag);
+            const adopted = adoptElement(this.root, tm.comment, tag);
             if (adopted === null) {
                 // SSR rendered no element after this marker. Fall out to a
                 // fresh element instead of hunting through the remaining
@@ -589,7 +643,7 @@ class WalkerEngine {
                 break;
             }
             this.idx++;
-            const adopted = adoptElementRaw(tm.comment, tag);
+            const adopted = adoptElementRaw(this.root, tm.comment, tag);
             if (adopted === null) {
                 tm.state = 'claimed';
                 break;
@@ -694,7 +748,7 @@ class WalkerEngine {
         tm.comment.remove();
         stripDirectTextNodes(el);
         captureSsrElementChildren(el);
-        stampClaimed(el);
+        recordAdopted(this.root, el, el.tagName.toLowerCase());
         return { el };
     }
     claimByKey(key, options) {
@@ -822,8 +876,9 @@ class WalkerEngine {
 // caller already consumed — static residues it retrieved from `__vsk_ssrEls`)
 // and by tag. The compiler emits `nextElement(tag, skipK)` claims with the
 // descriptor implicit in the tag; divergence follows §2.2 step 4: a tag
-// mismatch consumes exactly one slot, reports, and hands back a fresh element
-// that the caller mounts — the SSR node is never bound, never deleted.
+// mismatch consumes exactly one slot, reports, detaches the provably-owned
+// direct-child ghost, and hands back a fresh element that the caller mounts.
+// The SSR node is never bound.
 //
 // The same engine backs `createHydrateChildWalker`, so runtime components that
 // claim offspring positionally (loading stubs, slot content) keep working with
@@ -923,12 +978,41 @@ class StructuralWalker {
             const el = this.els[target];
             if (tag && el.tagName.toLowerCase() !== tag) {
                 // §2.2 step 4: descriptor failed. Consume exactly ONE slot and
-                // hand back a fresh element — the SSR node is never bound, never
-                // deleted. The caller detaches the fresh node when provably safe
-                // or leaves it inert for the sweep.
+                // hand back a fresh element. The direct-child SSR ghost is
+                // detached below; nested recovery remains owned by its child walker.
                 this.idx = this.advancePastSkippable(target + 1);
-                reportMiss('tag-mismatch', `descriptor wanted <${tag}> but the SSR slot holds <${el.tagName.toLowerCase()}>; consuming one slot and rendering fresh.`, false);
-                return document.createElement(tag || 'div');
+                const ghost = {
+                    state: 'ghost',
+                    el,
+                    owner: this.root,
+                    expectedTag: tag || 'div',
+                    actualTag: el.tagName.toLowerCase(),
+                    detached: false,
+                };
+                recordClaim(this.root, ghost);
+                // This is the walker's own immediate child slot, so detachment is
+                // provably boundary-local. Never remove nested content here: a
+                // nested mismatch belongs to the child walker's own recovery.
+                if (this.root && el.parentNode === this.root) {
+                    try {
+                        el.remove();
+                        ghost.detached = true;
+                    }
+                    catch {
+                        // The final sweep will report/repair a still-owned ghost.
+                    }
+                }
+                const fresh = document.createElement(tag || 'div');
+                recordClaim(this.root, {
+                    state: 'fresh',
+                    el: fresh,
+                    owner: this.root,
+                    expectedTag: tag || 'div',
+                    actualTag: fresh.tagName.toLowerCase(),
+                    detached: false,
+                });
+                reportMiss('tag-mismatch', `descriptor wanted <${tag}> but the SSR slot holds <${el.tagName.toLowerCase()}>; consumed one slot, detached the local ghost, and rendered fresh.`, false);
+                return fresh;
             }
             if (this.adopted.has(el)) {
                 // Double-claim guard: a node already adopted (cross-position
@@ -941,16 +1025,25 @@ class StructuralWalker {
             if (!raw)
                 stripDirectTextNodes(el);
             captureSsrElementChildren(el);
-            stampClaimed(el);
+            recordAdopted(this.root, el, tag || el.tagName.toLowerCase());
             return el;
         }
         this.idx = this.els.length;
+        const fresh = document.createElement(tag || 'div');
+        recordClaim(this.root, {
+            state: 'fresh',
+            el: fresh,
+            owner: this.root,
+            expectedTag: tag || 'div',
+            actualTag: fresh.tagName.toLowerCase(),
+            detached: false,
+        });
         reportMiss('exhausted', `hydration claim missed <${tag || 'element'}>; the client rendered more or different content than SSR.`, 
         // Not loud: an exhausted walker is the normal post-hydration
         // re-render shape (every further claim legitimately builds fresh
         // nodes) — telemetry-only, mirroring the marker engine.
         false);
-        return document.createElement(tag || 'div');
+        return fresh;
     }
     nextElement(tag, skipK = 0) {
         return this.claimAt(tag, skipK, false);
@@ -1016,7 +1109,7 @@ class StructuralWalker {
             this.adopted.add(el);
             stripDirectTextNodes(el);
             captureSsrElementChildren(el);
-            stampClaimed(el);
+            recordAdopted(this.root, el, el.tagName.toLowerCase());
             return { el };
         }
         this.idx = this.els.length;

package/dist/index-client.d.ts

@@ -20,6 +20,8 @@ export { Experiment } from '@vesk/runtime/src/experiment';
 export { Form, Field, required, email, minLength, maxLength, pattern, custom } from '@vesk/runtime/src/form';
 export { Md } from '@vesk/runtime/src/md';
 export { Show, For, Switch, Match } from '@vesk/runtime/src/headless';
+export { primitive, leaf, isPrimitive, isLeaf, isVeskComponent, toDomNode, rerenderNode } from '@vesk/runtime/src/primitive';
+export type { VeskLeafComponent, VeskPrimitiveComponent, VeskTaggedLeafComponent, VeskComponentRegistry, VeskScope } from '@vesk/types';
 export { LoadingIndicator, useLoadingIndicator, configureLoadingIndicator, getLoadingProgress, isLoadingActive, getLoadingError, LOADING_INDICATOR_DEFAULT_COLOR, LOADING_INDICATOR_DEFAULT_ERROR_COLOR } from '@vesk/runtime/src/loading-indicator';
 export type { LoadingIndicatorHandle, LoadingIndicatorOptions, LoadingIndicatorProps } from '@vesk/runtime/src/loading-indicator';
 export { defineAction, getAction, clearActions, validateActionInput, issuesToFieldMap, isFormAction } from '@vesk/runtime/src/action';

package/dist/index-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-client.d.ts","sourceRoot":"","sources":["../src/index-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,YAAY,IAAI,IAAI,EAAE,OAAO,EAAE,UAAU,IAAI,SAAS,EAAE,IAAI,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACtf,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,sBAAsB,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAC1P,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,oBAAoB,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,aAAa,EAAE,cAAc,EAAE,mBAAmB,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACpY,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACrI,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC1F,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACrO,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,iBAAiB,EAAE,QAAQ,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACxR,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC1E,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,KAAK,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACtI,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACrH,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACxK,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAC7G,OAAO,EAAE,EAAE,EAAE,MAAM,sBAAsB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,eAAe,EAAE,eAAe,EAAE,+BAA+B,EAAE,qCAAqC,EAAE,MAAM,qCAAqC,CAAC;AACrP,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAClI,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index-client.d.ts","sourceRoot":"","sources":["../src/index-client.ts"],"names":[],"mappings":"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"}

package/dist/index-client.js

@@ -16,5 +16,6 @@ export { Experiment } from '@vesk/runtime/src/experiment';
 export { Form, Field, required, email, minLength, maxLength, pattern, custom } from '@vesk/runtime/src/form';
 export { Md } from '@vesk/runtime/src/md';
 export { Show, For, Switch, Match } from '@vesk/runtime/src/headless';
+export { primitive, leaf, isPrimitive, isLeaf, isVeskComponent, toDomNode, rerenderNode } from '@vesk/runtime/src/primitive';
 export { LoadingIndicator, useLoadingIndicator, configureLoadingIndicator, getLoadingProgress, isLoadingActive, getLoadingError, LOADING_INDICATOR_DEFAULT_COLOR, LOADING_INDICATOR_DEFAULT_ERROR_COLOR } from '@vesk/runtime/src/loading-indicator';
 export { defineAction, getAction, clearActions, validateActionInput, issuesToFieldMap, isFormAction } from '@vesk/runtime/src/action';

package/dist/index-server.d.ts

@@ -13,6 +13,8 @@ export { Experiment } from '@vesk/runtime/src/experiment';
 export { Form, Field, required, email, minLength, maxLength, pattern, custom } from '@vesk/runtime/src/form';
 export { Md } from '@vesk/runtime/src/md';
 export { Show, For, Switch, Match } from '@vesk/runtime/src/headless';
+export { primitive, leaf, isPrimitive, isLeaf, isVeskComponent, toDomNode, rerenderNode } from '@vesk/runtime/src/primitive';
+export type { VeskLeafComponent, VeskPrimitiveComponent, VeskTaggedLeafComponent, VeskComponentRegistry, VeskScope } from '@vesk/types';
 export { LoadingIndicator, useLoadingIndicator, configureLoadingIndicator, getLoadingProgress, isLoadingActive, getLoadingError } from '@vesk/runtime/src/loading-indicator';
 export type { LoadingIndicatorHandle, LoadingIndicatorOptions, LoadingIndicatorProps } from '@vesk/runtime/src/loading-indicator';
 export { defineAction, getAction, clearActions, validateActionInput, issuesToFieldMap, isFormAction } from '@vesk/runtime/src/action';

package/dist/index-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-server.d.ts","sourceRoot":"","sources":["../src/index-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index-server.d.ts","sourceRoot":"","sources":["../src/index-server.ts"],"names":[],"mappings":"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"}

package/dist/index-server.js

@@ -13,5 +13,6 @@ export { Experiment } from '@vesk/runtime/src/experiment';
 export { Form, Field, required, email, minLength, maxLength, pattern, custom } from '@vesk/runtime/src/form';
 export { Md } from '@vesk/runtime/src/md';
 export { Show, For, Switch, Match } from '@vesk/runtime/src/headless';
+export { primitive, leaf, isPrimitive, isLeaf, isVeskComponent, toDomNode, rerenderNode } from '@vesk/runtime/src/primitive';
 export { LoadingIndicator, useLoadingIndicator, configureLoadingIndicator, getLoadingProgress, isLoadingActive, getLoadingError } from '@vesk/runtime/src/loading-indicator';
 export { defineAction, getAction, clearActions, validateActionInput, issuesToFieldMap, isFormAction } from '@vesk/runtime/src/action';

package/dist/primitive.d.ts

@@ -0,0 +1,119 @@
+/**
+ * `primitive` / `leaf` — the two authoring wrappers for the Vesk component ABI.
+ *
+ * Every component call in Vesk, including a bare `<Badge/>` with no
+ * attributes, is invoked as `callee(props, __registry, __veskScope)`. The
+ * compiler always passes an object literal at the call site (`{}` when there
+ * are no attributes), so `props` is never nullish coming *from the framework*.
+ *
+ * The gap this module closes is the other direction: a component exported from
+ * a module is an ordinary function, and an ordinary function can be called
+ * with no arguments at all — `Badge()` from a helper, a test, a render
+ * callback, or a manual `registry.get('Badge')!(undefined, reg, scope)` probe.
+ * A hand-written `function Badge(props) { return props.children }` throws
+ * `Cannot read properties of undefined` in that case. `primitive()` removes
+ * that whole class of failure by normalizing nullish props to a frozen empty
+ * object before the wrapped function ever sees them.
+ *
+ * `leaf()` is the behavioural counterpart: stateful widgets, own click
+ * handlers, async components. They implement the `VeskLeafComponent` ABI
+ * directly — the wrapper only stamps the marker so the two kinds can be told
+ * apart at runtime.
+ *
+ * Both wrappers are pure: no `document`/`window` access, no top-level side
+ * effects, safe to import from the client and server barrels alike.
+ */
+import type { VeskComponentRegistry, VeskLeafComponent, VeskPrimitiveComponent, VeskScope, VeskTaggedLeafComponent } from '@vesk/types';
+/**
+ * Wrap a presentational component so it is safe to call with no arguments.
+ *
+ * The wrapped function is *not* a copy of `fn` — it forwards `props`,
+ * `__registry` and the scope untouched, so identity-sensitive behavior
+ * (scope preference, `__veskScope`) is unchanged. Only a nullish `props` is
+ * substituted; a real props object is never cloned, merged or stripped, which
+ * matters because on the client `props.children` can be a live reactive
+ * container that must reach `fn` by reference.
+ *
+ * @param fn - The presentational component. Receives `(props, registry, scope)`.
+ * @returns A {@link VeskPrimitiveComponent} callable as `Badge()` or `<Badge/>`.
+ * @example
+ * ```ts
+ * const Badge = primitive((props) => `<span class="badge">${props.label ?? ''}</span>`);
+ * Badge();                    // '' — no throw
+ * Badge({ label: 'new' });    // '<span class="badge">new</span>'
+ * ```
+ */
+export declare function primitive<P extends object = Record<string, unknown>>(fn: (props: P, registry?: VeskComponentRegistry, scope?: VeskScope) => unknown | Promise<unknown>): VeskPrimitiveComponent<P>;
+/**
+ * Tag a stateful/async component as a leaf so `isLeaf()` can identify it.
+ *
+ * Behaviourally a no-op — the function is returned as-is (plus the marker) so
+ * the `__veskScope` property the SSR renderer assigns to compiled components
+ * stays writable. Use it to document intent and to let tooling distinguish a
+ * behavioural widget from a `primitive()` one; do not use it to give a
+ * primitive extra behavior it cannot support.
+ *
+ * @param fn - The leaf component implementing `(props, registry, scope)`.
+ * @returns The same function, tagged with `__veskLeaf`.
+ * @example
+ * ```ts
+ * const Tabs = leaf((props, registry, scope) => {
+ *   const &[open] = track(0);
+ *   return `<div>${open}</div>`;
+ * });
+ * ```
+ */
+export declare function leaf<P extends object = Record<string, unknown>>(fn: VeskLeafComponent<P>): VeskTaggedLeafComponent<P>;
+/** True when `value` was produced by {@link primitive}. */
+export declare function isPrimitive(value: unknown): value is VeskPrimitiveComponent;
+/** True when `value` was tagged by {@link leaf}. */
+export declare function isLeaf(value: unknown): value is VeskTaggedLeafComponent;
+/**
+ * True when `value` is callable as a Vesk component — i.e. it is a function at
+ * all. Every registry entry satisfies this; the distinction that matters for
+ * authoring is {@link isPrimitive} vs {@link isLeaf}.
+ */
+export declare function isVeskComponent(value: unknown): value is VeskLeafComponent;
+/**
+ * Normalize a component call's return value into something the client renderer
+ * can insert.
+ *
+ * A compiled `.vsk` component returns a DOM `Node`, and the runtime components
+ * (`Image`, `Form`, `Md`, …) build one when `document` exists. A `primitive()`
+ * or `leaf()` written as a template string has no such branch — it returns a
+ * string on BOTH sides, because that is the whole point of the terse form. The
+ * server concatenates it into the HTML; the client would otherwise hand a
+ * string to `appendChild`/`replaceChild` and throw "parameter 1 is not of type
+ * 'Node'", taking the page's error boundary with it.
+ *
+ * So: a `Node` passes through untouched, a string is parsed into its root
+ * node(s), and every other value (including `null`/`undefined`/`false`, which
+ * callers test for) is returned as-is. On the server there is nothing to
+ * normalize into, so strings pass through unchanged.
+ */
+export declare function toDomNode<T>(value: T): T | Node | DocumentFragment;
+/**
+ * Keep a rendered markup node in sync with the tracked values it was built
+ * from, without re-invoking the component at mount.
+ *
+ * A `primitive()` or `leaf()` written as a template string is called once and
+ * its result is converted to DOM once. Tracked values it READ (through the
+ * `reactiveProps` proxy) therefore subscribe nobody: a later write updated the
+ * cell and left the markup stale, so a leaf driven by a parent's counter never
+ * moved. Compiled components avoid this because their bindings re-run; string
+ * components have no bindings, so the runtime re-runs the call and swaps the
+ * produced nodes in place.
+ *
+ * The dep list is read by the effect purely to SUBSCRIBE. The first effect run
+ * therefore performs no re-render — it compares against the values captured at
+ * mount, which also covers a write that lands between mount and the first
+ * flush. Re-rendering is skipped when the node has been detached (its owner was
+ * torn down), so a stale effect can never graft nodes back into the document.
+ *
+ * @param node - The node (or fragment) the mount already inserted.
+ * @param deps - Tracked cells / values the markup was derived from.
+ * @param call - Re-invokes the component and returns fresh markup.
+ * @returns `node`, so the call can wrap the mount expression in place.
+ */
+export declare function rerenderNode<T>(node: T, deps: readonly unknown[], call: () => unknown): T;
+//# sourceMappingURL=primitive.d.ts.map

package/dist/primitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.d.ts","sourceRoot":"","sources":["../src/primitive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EACX,qBAAqB,EACrB,iBAAiB,EACjB,sBAAsB,EACtB,SAAS,EACT,uBAAuB,EACvB,MAAM,aAAa,CAAC;AAmBrB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,qBAAqB,EAAE,KAAK,CAAC,EAAE,SAAS,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAC/F,sBAAsB,CAAC,CAAC,CAAC,CAS3B;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,EAAE,EAAE,iBAAiB,CAAC,CAAC,CAAC,GACtB,uBAAuB,CAAC,CAAC,CAAC,CAG5B;AAED,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAE3E;AAED,oDAAoD;AACpD,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,uBAAuB,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAE1E;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,GAAG,gBAAgB,CAwBlE;AAYD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,OAAO,GAAG,CAAC,CA4CzF"}

package/dist/primitive.js

@@ -0,0 +1,234 @@
+/**
+ * `primitive` / `leaf` — the two authoring wrappers for the Vesk component ABI.
+ *
+ * Every component call in Vesk, including a bare `<Badge/>` with no
+ * attributes, is invoked as `callee(props, __registry, __veskScope)`. The
+ * compiler always passes an object literal at the call site (`{}` when there
+ * are no attributes), so `props` is never nullish coming *from the framework*.
+ *
+ * The gap this module closes is the other direction: a component exported from
+ * a module is an ordinary function, and an ordinary function can be called
+ * with no arguments at all — `Badge()` from a helper, a test, a render
+ * callback, or a manual `registry.get('Badge')!(undefined, reg, scope)` probe.
+ * A hand-written `function Badge(props) { return props.children }` throws
+ * `Cannot read properties of undefined` in that case. `primitive()` removes
+ * that whole class of failure by normalizing nullish props to a frozen empty
+ * object before the wrapped function ever sees them.
+ *
+ * `leaf()` is the behavioural counterpart: stateful widgets, own click
+ * handlers, async components. They implement the `VeskLeafComponent` ABI
+ * directly — the wrapper only stamps the marker so the two kinds can be told
+ * apart at runtime.
+ *
+ * Both wrappers are pure: no `document`/`window` access, no top-level side
+ * effects, safe to import from the client and server barrels alike.
+ */
+import { get } from '@vesk/runtime/src/ripple-runtime';
+import { effect } from '@vesk/runtime/src/ripple-blocks';
+/**
+ * Shared stand-in for "called with no props". Frozen so a primitive that
+ * mutates `props` by mistake fails loudly in strict mode instead of leaking
+ * state between unrelated zero-arg calls.
+ */
+const EMPTY_PROPS = Object.freeze({});
+/**
+ * Wrap a presentational component so it is safe to call with no arguments.
+ *
+ * The wrapped function is *not* a copy of `fn` — it forwards `props`,
+ * `__registry` and the scope untouched, so identity-sensitive behavior
+ * (scope preference, `__veskScope`) is unchanged. Only a nullish `props` is
+ * substituted; a real props object is never cloned, merged or stripped, which
+ * matters because on the client `props.children` can be a live reactive
+ * container that must reach `fn` by reference.
+ *
+ * @param fn - The presentational component. Receives `(props, registry, scope)`.
+ * @returns A {@link VeskPrimitiveComponent} callable as `Badge()` or `<Badge/>`.
+ * @example
+ * ```ts
+ * const Badge = primitive((props) => `<span class="badge">${props.label ?? ''}</span>`);
+ * Badge();                    // '' — no throw
+ * Badge({ label: 'new' });    // '<span class="badge">new</span>'
+ * ```
+ */
+export function primitive(fn) {
+    const wrapped = ((props, registry, scope) => {
+        // Nullish-only guard: any other value is the caller's business. A frozen
+        // singleton avoids an allocation per zero-arg call and keeps `Object.is`
+        // stable for the common no-props case.
+        return fn(props == null ? EMPTY_PROPS : props, registry, scope);
+    });
+    wrapped.__veskPrimitive = true;
+    return wrapped;
+}
+/**
+ * Tag a stateful/async component as a leaf so `isLeaf()` can identify it.
+ *
+ * Behaviourally a no-op — the function is returned as-is (plus the marker) so
+ * the `__veskScope` property the SSR renderer assigns to compiled components
+ * stays writable. Use it to document intent and to let tooling distinguish a
+ * behavioural widget from a `primitive()` one; do not use it to give a
+ * primitive extra behavior it cannot support.
+ *
+ * @param fn - The leaf component implementing `(props, registry, scope)`.
+ * @returns The same function, tagged with `__veskLeaf`.
+ * @example
+ * ```ts
+ * const Tabs = leaf((props, registry, scope) => {
+ *   const &[open] = track(0);
+ *   return `<div>${open}</div>`;
+ * });
+ * ```
+ */
+export function leaf(fn) {
+    fn.__veskLeaf = true;
+    return fn;
+}
+/** True when `value` was produced by {@link primitive}. */
+export function isPrimitive(value) {
+    return typeof value === 'function' && value.__veskPrimitive === true;
+}
+/** True when `value` was tagged by {@link leaf}. */
+export function isLeaf(value) {
+    return typeof value === 'function' && value.__veskLeaf === true;
+}
+/**
+ * True when `value` is callable as a Vesk component — i.e. it is a function at
+ * all. Every registry entry satisfies this; the distinction that matters for
+ * authoring is {@link isPrimitive} vs {@link isLeaf}.
+ */
+export function isVeskComponent(value) {
+    return typeof value === 'function';
+}
+/**
+ * Normalize a component call's return value into something the client renderer
+ * can insert.
+ *
+ * A compiled `.vsk` component returns a DOM `Node`, and the runtime components
+ * (`Image`, `Form`, `Md`, …) build one when `document` exists. A `primitive()`
+ * or `leaf()` written as a template string has no such branch — it returns a
+ * string on BOTH sides, because that is the whole point of the terse form. The
+ * server concatenates it into the HTML; the client would otherwise hand a
+ * string to `appendChild`/`replaceChild` and throw "parameter 1 is not of type
+ * 'Node'", taking the page's error boundary with it.
+ *
+ * So: a `Node` passes through untouched, a string is parsed into its root
+ * node(s), and every other value (including `null`/`undefined`/`false`, which
+ * callers test for) is returned as-is. On the server there is nothing to
+ * normalize into, so strings pass through unchanged.
+ */
+export function toDomNode(value) {
+    if (typeof document === 'undefined')
+        return value;
+    if (value == null || typeof value === 'boolean')
+        return value;
+    if (typeof value.nodeType === 'number') {
+        return value;
+    }
+    if (typeof value !== 'string')
+        return value;
+    if (value === '')
+        return document.createDocumentFragment();
+    const template = document.createElement('template');
+    template.innerHTML = value;
+    const { content } = template;
+    // A single root becomes that node; several roots stay a fragment so the
+    // caller can splice them in without inventing a wrapper element that was
+    // never in the SSR markup.
+    if (content.childNodes.length === 1) {
+        const only = content.firstChild;
+        // Detach before returning: a node still parented to the template's
+        // content fragment reads as "already mounted" to the compiler's
+        // hydrate guard (`value.parentNode == null`), so the fresh node would
+        // never be inserted and the claimed SSR node would be retired instead.
+        content.removeChild(only);
+        return only;
+    }
+    return content;
+}
+/** True when `value` is a tracked cell (the shape `get`/`set` operate on). */
+function isCell(value) {
+    return typeof value === 'object' && value !== null && typeof value.f === 'number';
+}
+/** Read a dep as the value a render would see: cells unwrap, literals pass. */
+function readDep(dep) {
+    return isCell(dep) ? get(dep) : dep;
+}
+/**
+ * Keep a rendered markup node in sync with the tracked values it was built
+ * from, without re-invoking the component at mount.
+ *
+ * A `primitive()` or `leaf()` written as a template string is called once and
+ * its result is converted to DOM once. Tracked values it READ (through the
+ * `reactiveProps` proxy) therefore subscribe nobody: a later write updated the
+ * cell and left the markup stale, so a leaf driven by a parent's counter never
+ * moved. Compiled components avoid this because their bindings re-run; string
+ * components have no bindings, so the runtime re-runs the call and swaps the
+ * produced nodes in place.
+ *
+ * The dep list is read by the effect purely to SUBSCRIBE. The first effect run
+ * therefore performs no re-render — it compares against the values captured at
+ * mount, which also covers a write that lands between mount and the first
+ * flush. Re-rendering is skipped when the node has been detached (its owner was
+ * torn down), so a stale effect can never graft nodes back into the document.
+ *
+ * @param node - The node (or fragment) the mount already inserted.
+ * @param deps - Tracked cells / values the markup was derived from.
+ * @param call - Re-invokes the component and returns fresh markup.
+ * @returns `node`, so the call can wrap the mount expression in place.
+ */
+export function rerenderNode(node, deps, call) {
+    if (typeof document === 'undefined')
+        return node;
+    if (deps.length === 0)
+        return node;
+    // The markup this call site owns. A component that rendered several roots
+    // hands them over as a list: the call site drains the fragment into the
+    // mount point, so by the time this runs the fragment itself is detached and
+    // useless as a handle. The list is followed as one range, which lets a
+    // later render add, drop or reorder roots.
+    let owned = null;
+    let current = null;
+    if (Array.isArray(node)) {
+        const roots = node.filter((n) => n && typeof n.nodeType === 'number');
+        owned = roots.length ? roots : null;
+        current = owned ? owned[0] : null;
+    }
+    else if (node && typeof node.nodeType === 'number') {
+        current = node;
+    }
+    if (!current)
+        return node;
+    const liveRange = () => {
+        if (owned)
+            return owned;
+        return current && current.parentNode ? [current] : null;
+    };
+    let seen = deps.map(readDep);
+    effect(() => {
+        const now = deps.map(readDep);
+        if (now.length === seen.length && now.every((v, i) => Object.is(v, seen[i])))
+            return;
+        seen = now;
+        // Detachment is checked BEFORE re-invoking: once the owner is gone the
+        // component must not run again (side effects, fetches) and its markup
+        // must never be grafted back into the document.
+        const old = liveRange();
+        if (!old || !old[0].parentNode)
+            return;
+        const next = toDomNode(call());
+        if (!next || typeof next.nodeType !== 'number')
+            return;
+        // Snapshot the children before inserting: moving them out empties the
+        // fragment, which is what tells us whether this render had several roots.
+        const fresh = next.nodeType === 11 ? Array.from(next.childNodes) : [next];
+        const parent = old[0].parentNode;
+        for (const freshNode of fresh)
+            parent.insertBefore(freshNode, old[0]);
+        for (const oldNode of old)
+            if (oldNode.parentNode)
+                oldNode.parentNode.removeChild(oldNode);
+        owned = next.nodeType === 11 ? fresh : null;
+        current = fresh[0] ?? current;
+    });
+    return node;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vesk/runtime",
-  "version": "0.2.41",
+  "version": "0.2.43",
   "type": "module",
   "description": "Vesk runtime — reactivity, blocks, DOM operations, hydration",
   "main": "./dist/index-client.js",
@@ -51,7 +51,7 @@
     }
   },
   "dependencies": {
-    "@vesk/compiler": "^0.2.41"
+    "@vesk/compiler": "^0.2.43"
   },
   "scripts": {
     "typecheck": "tsc --noEmit",