@vesk/runtime 0.2.28 → 0.2.29

package/dist/hydrate.d.ts

@@ -30,6 +30,16 @@ export interface HydrateWalker {
      */
     retireDetached?(): void;
     subWalker(rootEl: HTMLElement): HydrateWalker;
+    /**
+     * Transfer ownership of an explicit marker subset out of this walk: the
+     * listed markers are marked claimed here (the cursor skips them) so a
+     * scoped walker built over the same comments owns them exclusively.
+     * Used by the layout slot contract (`layout.ts`), which scopes page
+     * claims to SSR slot boundaries instead of sharing the positional cursor
+     * with nav/footer claims. Optional — walkers that cannot transfer leave
+     * the markers in place and the caller falls back to the shared walk.
+     */
+    takeMarkers?(comments: Comment[]): void;
     /**
      * Claim the SSR element of a keyed list item whose `data-vsk-key` matches
      * `key`. Consumes the item's root marker and stamps the element, but leaves
@@ -79,6 +89,7 @@ export type HydrationMismatchHandler = (issue: HydrationIssue) => void;
 export declare function setHydrateStrict(enabled: boolean): void;
 export declare function isHydrateStrict(): boolean;
 export declare function onHydrationMismatch(handler: HydrationMismatchHandler | null): void;
+export declare function reportHydrationIssue(issue: HydrationIssue): void;
 /**
  * Structured audit of the most recent full hydration pass over `container`.
  * Counts unclaimed `<!--vsk-->` markers (SSR regions the client never

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

@@ -62,6 +62,16 @@ export function isHydrateStrict() {
 export function onHydrationMismatch(handler) {
     __mismatchHandler = handler;
 }
+export function reportHydrationIssue(issue) {
+    if (!__mismatchHandler)
+        return;
+    try {
+        __mismatchHandler(issue);
+    }
+    catch {
+        // Telemetry must never break rendering.
+    }
+}
 function devWarn(message) {
     if (__hydrateDevMode && typeof console !== 'undefined') {
         console.warn('[vesk-hydrate] ' + message);
@@ -613,6 +623,25 @@ class WalkerEngine {
             this.idx = this.markers.length;
         return new WalkerEngine(rootEl, owned.map((m) => m.comment));
     }
+    // Ownership transfer for an explicit marker subset (layout slot contract).
+    // The listed markers are marked claimed here without advancing the cursor:
+    // positional claims skip them, and a scoped walker built over the same
+    // comments owns them exclusively. Exactly one engine owns each marker.
+    takeMarkers(comments) {
+        let owned;
+        try {
+            owned = new Set(comments);
+        }
+        catch {
+            return;
+        }
+        if (owned.size === 0)
+            return;
+        for (const tm of this.markers) {
+            if (tm.state !== 'claimed' && owned.has(tm.comment))
+                tm.state = 'claimed';
+        }
+    }
     // Retire every unclaimed marker in the whole walk that points at `el`.
     // Used after a cross-position adopt (relocate): the adopted node moves to
     // the cursor, so alias markers stacked at its old station would otherwise
@@ -764,6 +793,10 @@ export function createHydrateChildWalker(parentEl) {
         retireDetached() {
             // Child-walkers hold no marker list; nothing to sweep.
         },
+        takeMarkers(_comments) {
+            // Child-walkers hold no marker list; nothing to transfer. The
+            // layout slot contract falls back to the shared walk.
+        },
     };
 }
 export function hydrate(container, componentFn, props) {

package/dist/index-client.d.ts

@@ -1,6 +1,8 @@
 export { track, get, set, untrack, peek_tracked as peek, derived, flush_sync as flushSync, tick, schedule_update, queue_microtask, active_block, set_active_block, set_active_component, is_mutating_allowed, tracking, teardown, run_block, run_teardown, create_component_ctx, push_component, pop_component, with_block, with_scope, scope, safe_scope, set_tracking, set_active_reaction, is_block_dirty, destroy_non_branch_children, disable_scoped_flush, on_destroy } from '@vesk/runtime/src/ripple-runtime';
 export { effect, user_effect, block, branch, root, render, pre_effect, destroy_block, destroy_block_children, pause_block, resume_block, is_destroyed, unlink_block, create_try_block, boundary_fn_running_block } from '@vesk/runtime/src/ripple-blocks';
-export { hydrate, hydrateViewport, hydrateIdle, hydrateOnInteraction, needsHydration, hydrationCount, createHydrateWalker, collectVskMarkers, reactiveProps, hydrateInitial, assertFullyHydrated, auditHydration, setHydrateDevMode, setHydrateStrict, isHydrateStrict, onHydrationMismatch, bumpNavEpoch, isVskMarkerText, parseVskMarker } from '@vesk/runtime/src/hydrate';
+export { hydrate, hydrateViewport, hydrateIdle, hydrateOnInteraction, needsHydration, hydrationCount, createHydrateWalker, collectVskMarkers, reactiveProps, hydrateInitial, assertFullyHydrated, auditHydration, setHydrateDevMode, setHydrateStrict, isHydrateStrict, onHydrationMismatch, reportHydrationIssue, bumpNavEpoch, isVskMarkerText, parseVskMarker } from '@vesk/runtime/src/hydrate';
+export { createLayoutSlot, trackSlotContent, auditLayoutSlots, LAYOUT_SLOT_OPEN, LAYOUT_SLOT_CLOSE } from '@vesk/runtime/src/layout';
+export type { LayoutSlot, LayoutSlotAudit, SlotIdentity } from '@vesk/runtime/src/layout';
 export type { HydrationReport, HydrationIssue, HydrationIssueKind, HydrationMismatchHandler, DeferredHydrationOptions, IdleHydrationOptions, InteractionHydrationOptions, ViewportHydrationHandle } from '@vesk/runtime/src/hydrate';
 export { createRouter, createFileRouter, Outlet, Link, NavLink, useNavigate, useParams, usePathname, useSearchParams, useRouter, buildRouteTree, defineRoute, Redirect, redirect, permanentRedirect, notFound, NotFoundError, ensureChunk, matchRoute } from '@vesk/runtime/src/router';
 export { getNetworkState, watchNetwork } from '@vesk/runtime/src/network';

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

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

package/dist/index-client.js

@@ -1,6 +1,7 @@
 export { track, get, set, untrack, peek_tracked as peek, derived, flush_sync as flushSync, tick, schedule_update, queue_microtask, active_block, set_active_block, set_active_component, is_mutating_allowed, tracking, teardown, run_block, run_teardown, create_component_ctx, push_component, pop_component, with_block, with_scope, scope, safe_scope, set_tracking, set_active_reaction, is_block_dirty, destroy_non_branch_children, disable_scoped_flush, on_destroy } from '@vesk/runtime/src/ripple-runtime';
 export { effect, user_effect, block, branch, root, render, pre_effect, destroy_block, destroy_block_children, pause_block, resume_block, is_destroyed, unlink_block, create_try_block, boundary_fn_running_block } from '@vesk/runtime/src/ripple-blocks';
-export { hydrate, hydrateViewport, hydrateIdle, hydrateOnInteraction, needsHydration, hydrationCount, createHydrateWalker, collectVskMarkers, reactiveProps, hydrateInitial, assertFullyHydrated, auditHydration, setHydrateDevMode, setHydrateStrict, isHydrateStrict, onHydrationMismatch, bumpNavEpoch, isVskMarkerText, parseVskMarker } from '@vesk/runtime/src/hydrate';
+export { hydrate, hydrateViewport, hydrateIdle, hydrateOnInteraction, needsHydration, hydrationCount, createHydrateWalker, collectVskMarkers, reactiveProps, hydrateInitial, assertFullyHydrated, auditHydration, setHydrateDevMode, setHydrateStrict, isHydrateStrict, onHydrationMismatch, reportHydrationIssue, bumpNavEpoch, isVskMarkerText, parseVskMarker } from '@vesk/runtime/src/hydrate';
+export { createLayoutSlot, trackSlotContent, auditLayoutSlots, LAYOUT_SLOT_OPEN, LAYOUT_SLOT_CLOSE } from '@vesk/runtime/src/layout';
 export { createRouter, createFileRouter, Outlet, Link, NavLink, useNavigate, useParams, usePathname, useSearchParams, useRouter, buildRouteTree, defineRoute, Redirect, redirect, permanentRedirect, notFound, NotFoundError, ensureChunk, matchRoute } from '@vesk/runtime/src/router';
 export { getNetworkState, watchNetwork } from '@vesk/runtime/src/network';
 export { bindValue, bindChecked, bindGroup } from '@vesk/runtime/src/bindings';

package/dist/layout.d.ts

@@ -0,0 +1,59 @@
+import type { HydrateWalker } from '@vesk/runtime/src/hydrate';
+/** SSR comment text opening a layout page-slot region. */
+export declare const LAYOUT_SLOT_OPEN = "vsk-slot";
+/** SSR comment text closing a layout page-slot region (also the async anchor). */
+export declare const LAYOUT_SLOT_CLOSE = "vsk-slot-end";
+export interface LayoutSlot {
+    /** Walker scoped to the slot's SSR markers (or the shared walker when unscopable). */
+    walker: HydrateWalker;
+    /** True when the walker is scoped to slot boundaries (not the shared cursor). */
+    scoped: boolean;
+    /**
+     * Wire an async child hydrator result: resolved slot content is inserted
+     * at its SSR position (before the slot-end boundary). Returns a promise
+     * for the layout's `__pendingChild` chain.
+     */
+    track(promise: unknown): unknown;
+}
+/**
+ * Slot boundary identity. Server codegen stamps every pair with a unique id
+ * (`vsk-slot:s7` … `vsk-slot-end:s7`); pre-boundary output uses the bare texts
+ * (legacy, id `''`). Open/close are paired by EXACT id — never positionally —
+ * so nested layouts and sibling slots cannot mis-scope each other. No regex:
+ * prefix strip only.
+ */
+export interface SlotIdentity {
+    /** '' for legacy bare boundaries, otherwise the stamped id. */
+    id: string;
+}
+/**
+ * Anchor an async slot child: when the hydrator promise resolves, detached
+ * slot content is inserted BEFORE the slot-end boundary (its SSR position).
+ * When the boundary is gone (a navigation replaced the DOM while suspended),
+ * the late content is dropped — hydrating replaced DOM is how duplicates are
+ * born. Resolution value and errors pass through untouched.
+ */
+export declare function trackSlotContent(promise: unknown, anchor: Comment | null): unknown;
+/**
+ * Build the slot scope for a layout `{children}` invocation.
+ *
+ * Transfers the whole slot range — depth-0 markers plus nested-slot
+ * interiors — out of the shared walk (`takeMarkers`), then hands back a
+ * walker scoped to the depth-0 markers only. Nav/footer claims can no longer
+ * drift into page markers and page claims can no longer steal footer markers,
+ * including across `await` suspensions (scope never depends on claim timing)
+ * and across nesting levels (an inner scope re-scans the live DOM and owns
+ * its interior exclusively). Falls back to the shared walker (legacy
+ * behavior) when boundaries are absent, unbalanced, already consumed, or the
+ * walker cannot transfer — a fallback degrades to today's semantics, never to
+ * a wrong scope.
+ */
+export declare function createLayoutSlot(walker: HydrateWalker, parentEl: Element | null): LayoutSlot;
+export interface LayoutSlotAudit {
+    ok: boolean;
+    unbalanced: number;
+    leftoverInSlot: number;
+}
+/** Verify slot boundary balance and slot-region claim completeness. */
+export declare function auditLayoutSlots(container: HTMLElement): LayoutSlotAudit;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../src/layout.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAqC/D,0DAA0D;AAC1D,eAAO,MAAM,gBAAgB,aAAa,CAAC;AAC3C,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,iBAAiB,CAAC;AAEhD,MAAM,WAAW,UAAU;IAC1B,sFAAsF;IACtF,MAAM,EAAE,aAAa,CAAC;IACtB,iFAAiF;IACjF,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC5B,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;CACX;AAyOD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAuBlF;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC/B,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,OAAO,GAAG,IAAI,GACtB,UAAU,CA4CZ;AAcD,MAAM,WAAW,eAAe;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,uEAAuE;AACvE,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,WAAW,GAAG,eAAe,CA8DxE"}

package/dist/layout.js

@@ -0,0 +1,456 @@
+import { createHydrateWalker, isVskMarkerText, reportHydrationIssue, } from '@vesk/runtime/src/hydrate';
+// ---------------------------------------------------------------------------
+// Dedicated layout contract (Layout hydration ownership).
+//
+// A layout composes three independently-authored regions — chrome/nav, the
+// page slot, footer — that SSR serializes as undifferentiated siblings inside
+// one parent element. Hydrating all three off a single shared positional
+// cursor means ANY single claim miss (a self-claiming Link in the nav, an
+// async suspension in the page, a conditional) shifts every later claim into
+// fresh-node fallback: fresh nodes append at region tails, so one miss twins
+// the footer, and a late-resolving async page lands below the footer (or the
+// page claims first and the layout stacks under it).
+//
+// Containment scoping (`subWalker(enclosingEl)`) is not the answer either: it
+// bulk-transfers sibling markers rendered AFTER the slot (the footer) into
+// the page's walk. The missing piece is boundary-delimited scoping, owned
+// here:
+//
+//   * SSR wraps every `{props.children}` region in `<!--vsk-slot-->` …
+//     `<!--vsk-slot-end-->` (server codegen). The texts deliberately lack the
+//     `vsk:` prefix so the generic marker machinery (walkers, canary, audit)
+//     ignores them; only this module reads them.
+//   * `createLayoutSlot` transfers the slot range out of the shared walk and
+//     hands back a walker scoped to the depth-0 markers. Nav/footer claims can
+//     no longer drift into page markers and page claims can no longer steal
+//     footer markers — including across `await` suspensions, because scope no
+//     longer depends on claim timing, and across nesting (nested-slot
+//     interiors are neutralized in the ancestor walk and re-scoped by the
+//     inner layout from the live DOM).
+//   * `track` anchors async slot content: a suspending child resolves to
+//     nodes inserted BEFORE the slot-end boundary at its SSR position — never
+//     appended at the tail, never dropped. A navigation that replaced the DOM
+//     first (slot-end detached) drops the late content instead of duplicating
+//     it into the new page.
+// ---------------------------------------------------------------------------
+/** SSR comment text opening a layout page-slot region. */
+export const LAYOUT_SLOT_OPEN = 'vsk-slot';
+/** SSR comment text closing a layout page-slot region (also the async anchor). */
+export const LAYOUT_SLOT_CLOSE = 'vsk-slot-end';
+function slotIdentity(text, prefix) {
+    if (text === prefix)
+        return { id: '' };
+    if (typeof text !== 'string')
+        return null;
+    const want = prefix + ':';
+    if (text.length > want.length && text.startsWith(want))
+        return { id: text.slice(want.length) };
+    return null;
+}
+function slotOpenId(text) {
+    return slotIdentity(text, LAYOUT_SLOT_OPEN);
+}
+function slotCloseId(text) {
+    return slotIdentity(text, LAYOUT_SLOT_CLOSE);
+}
+function slotUsed(node) {
+    try {
+        return node.__vsk_slot_used === true;
+    }
+    catch {
+        return false;
+    }
+}
+function markSlotUsed(node) {
+    try {
+        node.__vsk_slot_used = true;
+    }
+    catch {
+        // Expando unsupported — the pair may be re-scanned, which degrades to
+        // the legacy shared-walker path, never to a wrong scope.
+    }
+}
+/**
+ * Locate the unconsumed slot boundary pair that are direct children of
+ * `parentEl` and collect the `vsk:` markers between them in document order.
+ *
+ * Open/close pair by EXACT boundary id (legacy bare boundaries pair
+ * positionally, as before). An id-stamped open with no same-id close — or a
+ * legacy open facing only id-stamped closes (version skew) — refuses to scope
+ * (null) rather than risk a wrong range. Nested layout slots inside the range
+ * are skipped via a depth counter, so an outer slot never captures an inner
+ * layout's page markers (each layout scopes its own pair when its slot runs).
+ * Returns null when the SSR output predates slot boundaries (legacy) or the
+ * pair is unbalanced.
+ */
+function findSlotRange(parentEl) {
+    let open = null;
+    let openId = null;
+    let close = null;
+    try {
+        // Walk the entire subtree of parentEl (not just direct children) so a
+        // layout whose slot lives inside a nested <main> (DocsLayout:
+        // outer <div> → <div.flex> → <main>) is still found. The old
+        // direct-children scan missed those and fell back to the shared walk
+        // (257-marker hydration drift on /docs).
+        const walker = document.createTreeWalker(parentEl, 128, {
+            acceptNode: (node) => {
+                const t = node.textContent;
+                if (slotOpenId(t) !== null || slotCloseId(t) !== null)
+                    return 1;
+                return 2;
+            },
+        });
+        // Nesting depth while seeking the close: a nested slot pair inside
+        // our range must not donate its close to us. Bare boundaries
+        // (`vsk-slot` … `vsk-slot-end`) carry no id, so without depth the
+        // first inner close would prematurely end the outer range and
+        // mis-scope the page. Distinct ids pair by exact id AND depth.
+        let nest = 0;
+        while (walker.nextNode()) {
+            const c = walker.currentNode;
+            const t = c.textContent;
+            if (open === null) {
+                const id = slotOpenId(t);
+                if (id !== null && !slotUsed(c)) {
+                    open = c;
+                    openId = id;
+                }
+            }
+            else {
+                if (slotOpenId(t) !== null && !slotUsed(c)) {
+                    nest++;
+                    continue;
+                }
+                const id = slotCloseId(t);
+                if (id === null || slotUsed(c))
+                    continue;
+                if (id.id === openId.id && nest === 0) {
+                    // Ensure close is after open in document order and still
+                    // inside parentEl (TreeWalker guarantees this, but verify
+                    // via isConnected/contains for detached-navigation safety).
+                    try {
+                        if (!parentEl.contains?.(c))
+                            continue;
+                    }
+                    catch { }
+                    close = c;
+                    break;
+                }
+                if (nest > 0)
+                    nest--;
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    if (!open || !close)
+        return null;
+    // Document-order walk from `open` to `close`, collecting vsk markers at
+    // nesting depth 0 for the slot walker, and every vsk marker in range for
+    // ancestor neutralization (see `SlotRange.all`). A nested `vsk-slot` …
+    // `vsk-slot-end` pair (inner layout) increments depth so its interior
+    // markers stay owned by the inner scope.
+    const markers = [];
+    const all = [];
+    let depth = 0;
+    let node = null;
+    try {
+        node = open.nextSibling;
+    }
+    catch {
+        return null;
+    }
+    let guard = 0;
+    while (node !== null && node !== close && guard++ < 100000) {
+        let next = null;
+        let descend = null;
+        try {
+            const n = node;
+            next = n.nextSibling;
+            descend = n.firstChild;
+            if (n.nodeType === 8) {
+                if (slotOpenId(n.textContent) !== null) {
+                    depth++;
+                }
+                else if (slotCloseId(n.textContent) !== null) {
+                    if (depth === 0)
+                        break; // unbalanced: a close with no open — stop, don't over-capture
+                    depth--;
+                }
+                else if (isVskMarkerText(n.textContent)) {
+                    all.push(n);
+                    // Depth-0 only: nested `vsk-slot` interiors stay owned by
+                    // the inner layout's own scope (see the nested test in
+                    // layout.test.ts). The ancestor walk is neutralized for
+                    // the whole range via `all` + `takeMarkers` regardless.
+                    if (depth === 0)
+                        markers.push(n);
+                }
+            }
+        }
+        catch {
+            return null;
+        }
+        // Preorder: descend first, else advance; climb past exhausted parents.
+        if (descend !== null && descend !== undefined) {
+            node = descend;
+        }
+        else {
+            let cur = node;
+            let nxt = next;
+            while (nxt === null || nxt === undefined) {
+                let parent = null;
+                try {
+                    parent = cur.parentNode;
+                }
+                catch {
+                    return null;
+                }
+                if (parent === null || parent === undefined || parent === parentEl)
+                    break;
+                if (parent === close) {
+                    nxt = null;
+                    cur = null;
+                    break;
+                }
+                try {
+                    nxt = parent.nextSibling;
+                }
+                catch {
+                    return null;
+                }
+                cur = parent;
+            }
+            if (cur === null)
+                break;
+            node = nxt;
+        }
+    }
+    if (node !== close)
+        return null; // never reached the close — unbalanced, refuse to scope
+    markSlotUsed(open);
+    markSlotUsed(close);
+    return { markers, all, end: close };
+}
+function insertDetachedSlotContent(value, anchor) {
+    let parent = null;
+    try {
+        parent = anchor.parentNode;
+        if (!parent)
+            return;
+    }
+    catch {
+        return;
+    }
+    const nodes = [];
+    if (value && typeof value === 'object') {
+        const v = value;
+        if (v.nodeType === 11 || v.nodeType === 1)
+            nodes.push(v);
+        else if (typeof v.length === 'number') {
+            for (let i = 0; i < v.length; i++) {
+                const n = v[i];
+                if (n && (n.nodeType === 11 || n.nodeType === 1))
+                    nodes.push(n);
+            }
+        }
+        else
+            return;
+    }
+    else
+        return;
+    for (const n of nodes) {
+        if (n === anchor)
+            continue;
+        let attached = null;
+        try {
+            attached = n.parentNode;
+        }
+        catch {
+            continue;
+        }
+        // Only place detached content. Attached nodes were claimed in place —
+        // moving them would reorder live DOM on a hunch.
+        if (attached !== null && attached !== undefined)
+            continue;
+        try {
+            parent.insertBefore(n, anchor);
+        }
+        catch {
+            // A failed insert must not strand the render; the audit reports it.
+        }
+    }
+}
+/**
+ * Anchor an async slot child: when the hydrator promise resolves, detached
+ * slot content is inserted BEFORE the slot-end boundary (its SSR position).
+ * When the boundary is gone (a navigation replaced the DOM while suspended),
+ * the late content is dropped — hydrating replaced DOM is how duplicates are
+ * born. Resolution value and errors pass through untouched.
+ */
+export function trackSlotContent(promise, anchor) {
+    if (!promise || typeof promise.then !== 'function' || !anchor)
+        return promise;
+    return promise.then((value) => {
+        let live = false;
+        try {
+            live = !!anchor.parentNode && anchor.isConnected !== false;
+        }
+        catch {
+            live = false;
+        }
+        if (live)
+            insertDetachedSlotContent(value, anchor);
+        else {
+            reportHydrationIssue({
+                kind: 'leftover-marker',
+                detail: 'async layout slot resolved after its SSR boundary detached (navigation replaced the DOM); late slot content dropped instead of duplicated.',
+            });
+        }
+        return value;
+    }, (error) => {
+        throw error;
+    });
+}
+/**
+ * Build the slot scope for a layout `{children}` invocation.
+ *
+ * Transfers the whole slot range — depth-0 markers plus nested-slot
+ * interiors — out of the shared walk (`takeMarkers`), then hands back a
+ * walker scoped to the depth-0 markers only. Nav/footer claims can no longer
+ * drift into page markers and page claims can no longer steal footer markers,
+ * including across `await` suspensions (scope never depends on claim timing)
+ * and across nesting levels (an inner scope re-scans the live DOM and owns
+ * its interior exclusively). Falls back to the shared walker (legacy
+ * behavior) when boundaries are absent, unbalanced, already consumed, or the
+ * walker cannot transfer — a fallback degrades to today's semantics, never to
+ * a wrong scope.
+ */
+export function createLayoutSlot(walker, parentEl) {
+    const fallback = {
+        walker,
+        scoped: false,
+        track: (promise) => trackSlotContent(promise, null),
+    };
+    if (!walker || !parentEl)
+        return fallback;
+    let range = null;
+    try {
+        range = findSlotRange(parentEl);
+    }
+    catch {
+        return fallback;
+    }
+    if (!range) {
+        reportHydrationIssue({
+            kind: 'untyped-marker',
+            detail: 'layout slot has no SSR slot boundaries (legacy output or unbalanced markers); hydrating the page on the shared walker — ordering is best-effort.',
+        });
+        return fallback;
+    }
+    if (typeof walker.takeMarkers !== 'function') {
+        reportHydrationIssue({
+            kind: 'untyped-marker',
+            detail: 'layout slot walker cannot transfer markers; hydrating the page on the shared walker — ordering is best-effort.',
+        });
+        return { walker, scoped: false, track: (promise) => trackSlotContent(promise, range.end) };
+    }
+    try {
+        walker.takeMarkers(range.all);
+    }
+    catch {
+        return fallback;
+    }
+    let slotWalker;
+    try {
+        slotWalker = createHydrateWalker(parentEl, range.markers);
+    }
+    catch {
+        return fallback;
+    }
+    const end = range.end;
+    return {
+        walker: slotWalker,
+        scoped: true,
+        track: (promise) => trackSlotContent(promise, end),
+    };
+}
+// ---------------------------------------------------------------------------
+// Strict slot audit: every slot boundary pair must be balanced, and no `vsk:`
+// marker may survive inside a slot range after hydration — a leftover there is
+// page content the client never claimed (the twin/duplication surface).
+// Runs from the router after the layout chain hydrates (full strategy only;
+// deferred strategies hydrate the slot later by design).
+// ---------------------------------------------------------------------------
+const _SHOW_COMMENT = 128;
+const _FILTER_ACCEPT = 1;
+const _FILTER_SKIP = 2;
+/** Verify slot boundary balance and slot-region claim completeness. */
+export function auditLayoutSlots(container) {
+    let unbalanced = 0;
+    let leftoverInSlot = 0;
+    try {
+        const walker = document.createTreeWalker(container, _SHOW_COMMENT, {
+            acceptNode: (node) => {
+                const t = node.textContent;
+                if (slotOpenId(t) !== null || slotCloseId(t) !== null || isVskMarkerText(t))
+                    return _FILTER_ACCEPT;
+                return _FILTER_SKIP;
+            },
+        });
+        // Open-id stack: id-stamped pairs must close in LIFO order with the
+        // exact id; legacy bare boundaries pair blindly (as before). Any id
+        // mismatch names the diverging slot instead of silently mis-scoping.
+        const stack = [];
+        while (walker.nextNode()) {
+            const c = walker.currentNode;
+            const t = c.textContent;
+            const open = slotOpenId(t);
+            if (open !== null) {
+                stack.push(open.id);
+                continue;
+            }
+            const close = slotCloseId(t);
+            if (close !== null) {
+                if (stack.length === 0) {
+                    unbalanced++;
+                    reportHydrationIssue({
+                        kind: 'marker-skew',
+                        detail: 'layout slot close without a matching open — SSR/client slot structure diverges; slot content may misorder.',
+                    });
+                    continue;
+                }
+                const top = stack.pop();
+                if (top !== '' && close.id !== '' && top !== close.id) {
+                    unbalanced++;
+                    reportHydrationIssue({
+                        kind: 'marker-skew',
+                        detail: `layout slot id mismatch: open "${top}" closed by "${close.id}" — SSR/client slot structure diverges; slot content may misorder.`,
+                    });
+                }
+                continue;
+            }
+            if (stack.length > 0 && isVskMarkerText(t))
+                leftoverInSlot++;
+        }
+        if (stack.length > 0) {
+            unbalanced++;
+            reportHydrationIssue({
+                kind: 'marker-skew',
+                detail: 'layout slot open without a matching close — SSR/client slot structure diverges; slot content may misorder.',
+            });
+        }
+        if (leftoverInSlot > 0) {
+            reportHydrationIssue({
+                kind: 'leftover-marker',
+                detail: `${leftoverInSlot} hydration marker(s) survived inside a layout slot region; the page rendered differently than SSR — duplication risk.`,
+            });
+        }
+    }
+    catch {
+        // Audit must never break rendering.
+    }
+    return { ok: unbalanced === 0 && leftoverInSlot === 0, unbalanced, leftoverInSlot };
+}

package/dist/router.d.ts.map

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

package/dist/router.js

@@ -1,6 +1,7 @@
 import { get, set, scope, set_active_block } from '@vesk/runtime/src/ripple-runtime';
 import { root } from '@vesk/runtime/src/ripple-blocks';
 import { createHydrateWalker, hydrateViewport, hydrateIdle, hydrateOnInteraction, bumpNavEpoch } from '@vesk/runtime/src/hydrate';
+import { auditLayoutSlots } from '@vesk/runtime/src/layout';
 import { matchRoute, flattenLayoutChain, buildTreeFromMap } from '@vesk/runtime/src/router-match';
 import { setIsHydrating, _state, _scrollPositions, _isPopStateNavigation, setIsPopStateNavigation, setCurrentRouter, showLoadingInContainer, handleScroll, applyHead, findLoadingComponent, findErrorComponent, findNotFoundComponent, findOfflineComponent, findNetworkComponent, getCurrentRouter, Outlet, Link, NavLink, useNavigate, useParams, usePathname, useSearchParams, useRouter, Redirect, redirect, permanentRedirect, NotFoundError, notFound, } from '@vesk/runtime/src/router-components';
 import { getNetworkState, watchNetwork } from '@vesk/runtime/src/network';
@@ -1137,6 +1138,18 @@ async function hydrateInitial(router, match, container, strategy) {
         }
         const walker = createHydrateWalker(container);
         await runInBlockWindow(() => renderLayoutChain(0)(walker));
+        // Strict slot audit: with boundary-delimited slot walkers, any marker
+        // surviving inside a slot region (or an unbalanced boundary pair) is a
+        // page/layout divergence — the duplication surface. Deferred strategies
+        // hydrate the slot later by design, so only the full strategy audits.
+        if (!strategy || strategy === 'full') {
+            try {
+                auditLayoutSlots(container);
+            }
+            catch {
+                // Audit must never break rendering.
+            }
+        }
         setIsHydrating(false);
     }
     catch (error) {

package/package.json

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