@llui/vike 0.0.16 → 0.0.18

package/README.md

@@ -61,8 +61,10 @@ export const onRenderClient = createOnRenderClient({
 
 Declare app chrome (header, sidebar, dialogs, session state) as a `Layout` component that stays mounted across client navigation. The route-scoped `Page` swaps in and out at the layout's `pageSlot()` position while the surrounding layout subtree — and every DOM node, focus trap, portal, and effect subscription inside it — is untouched.
 
+> **Do not name your layout file `+Layout.ts`.** Vike reserves the `+` prefix for its own framework-adapter config conventions, and `+Layout.ts` specifically is interpreted by `vike-react` / `vike-vue` / `vike-solid` as a framework-native layout config. `@llui/vike` isn't a framework adapter in that sense — it's a render adapter, and `createOnRenderClient({ Layout })` consumes the layout component directly. Name your file `Layout.ts`, `app-layout.ts`, or place it anywhere outside `/pages` that Vike won't scan, then import it from `+onRenderClient.ts` / `+onRenderHtml.ts` by path.
+
 ```ts
-// pages/+Layout.ts
+// pages/Layout.ts    ← not +Layout.ts
 import { component, div, header, main } from '@llui/dom'
 import { pageSlot } from '@llui/vike/client'
 
@@ -84,7 +86,7 @@ export const AppLayout = component<LayoutState, LayoutMsg>({
 ```ts
 // pages/+onRenderClient.ts
 import { createOnRenderClient } from '@llui/vike/client'
-import { AppLayout } from './+Layout'
+import { AppLayout } from './Layout'
 
 export const onRenderClient = createOnRenderClient({
   Layout: AppLayout,
@@ -94,7 +96,7 @@ export const onRenderClient = createOnRenderClient({
 ```ts
 // pages/+onRenderHtml.ts — server renders layout + page as one tree
 import { createOnRenderHtml } from '@llui/vike/server'
-import { AppLayout } from './+Layout'
+import { AppLayout } from './Layout'
 
 export const onRenderHtml = createOnRenderHtml({
   Layout: AppLayout,
@@ -133,7 +135,7 @@ The scope-tree integration makes this natural: `pageSlot()` creates its slot as
 Common pattern — a layout-owned toast system:
 
 ```ts
-// pages/+Layout.ts
+// pages/Layout.ts
 import { component, div, main, provide, createContext } from '@llui/dom'
 import { pageSlot } from '@llui/vike/client'
 
@@ -143,6 +145,10 @@ interface ToastDispatchers {
 }
 export const ToastContext = createContext<ToastDispatchers>(undefined, 'Toast')
 
+// Note: import { provideValue, useContextValue } from '@llui/dom' for
+// the stable-dispatcher pattern below — they're the static-bag
+// companions to the reactive provide / useContext primitives.
+
 export const AppLayout = component<LayoutState, LayoutMsg>({
   name: 'AppLayout',
   init: () => [{ toasts: [] }, []],
@@ -150,12 +156,12 @@ export const AppLayout = component<LayoutState, LayoutMsg>({
   view: ({ send }) => [
     div({ class: 'app-shell' }, [
       ToastStack(), // reads from layout state
-      ...provide(
+      ...provideValue(
         ToastContext,
-        () => ({
+        {
           show: (msg) => send({ type: 'toast/show', msg }),
           dismiss: (id) => send({ type: 'toast/dismiss', id }),
-        }),
+        },
         () => [main([pageSlot()])],
       ),
     ]),
@@ -166,8 +172,8 @@ export const AppLayout = component<LayoutState, LayoutMsg>({
 ```ts
 // Any page below the layout can now use the toast dispatcher.
 // pages/studio/+Page.ts
-import { component, button, text, useContext } from '@llui/dom'
-import { ToastContext } from '../+Layout'
+import { component, button, text, useContextValue } from '@llui/dom'
+import { ToastContext } from '../Layout'
 
 export const StudioPage = component<StudioState, StudioMsg>({
   name: 'StudioPage',
@@ -179,12 +185,14 @@ export const StudioPage = component<StudioState, StudioMsg>({
     return [s, []]
   },
   view: ({ send }) => {
-    const toast = useContext(ToastContext)
-    return [button({ onClick: () => toast({} as LayoutState).show('Saved') }, [text('Save')])]
+    const toast = useContextValue(ToastContext)
+    return [button({ onClick: () => toast.show('Saved') }, [text('Save')])]
   },
 })
 ```
 
+`provideValue` and `useContextValue` are companions to the reactive `provide` / `useContext` for the common case of publishing a stable dispatcher bag — anything that doesn't depend on the parent's state. Use them for toast queues, session managers, breadcrumb dispatchers, and any other pattern where a page calls into layout-owned operations through a closure-captured `send`. The reactive `provide(ctx, accessor, children)` and `useContext(ctx)` forms still exist for context values that DO depend on state (e.g. `provide(ThemeContext, (s) => s.theme, () => [...])`).
+
 Toast state machines, global progress indicators, breadcrumb/title bars, modal-takeover chrome toggles, and session-expired banners all fall out of this pattern naturally — the layout owns the state, provides a dispatcher via context, and any page can trigger layout operations without touching the layout's internals.
 
 For the rarer case where a layout needs to **probe a page** (e.g. "is your form dirty? can we navigate away?"), use **addressed effects** — the page registers an address on mount, the layout dispatches a targeted effect to it.

package/dist/on-render-client.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentDef, TransitionOptions } from '@llui/dom';
+import type { AnyComponentDef, TransitionOptions } from '@llui/dom';
 export { pageSlot } from './page-slot.js';
 declare global {
     interface Window {
@@ -18,12 +18,11 @@ declare global {
  * data under the `lluiLayoutData` key.
  */
 export interface ClientPageContext {
-    Page: ComponentDef<unknown, unknown, unknown, unknown>;
+    Page: AnyComponentDef;
     data?: unknown;
     lluiLayoutData?: readonly unknown[];
     isHydration?: boolean;
 }
-type AnyComponentDef = ComponentDef<unknown, unknown, unknown, unknown>;
 type LayoutChain = ReadonlyArray<AnyComponentDef>;
 /**
  * Page-lifecycle hooks that fire around the dispose → mount cycle on
@@ -155,11 +154,20 @@ export declare function onRenderClient(pageContext: ClientPageContext): Promise<
  * for the full option surface — this is the entry point for persistent
  * layouts, route transitions, and lifecycle hooks.
  *
+ * **Do not name your layout file `+Layout.ts`.** Vike reserves the `+`
+ * prefix for its own framework config conventions, and `+Layout.ts` is
+ * interpreted by `vike-react` / `vike-vue` / `vike-solid` framework
+ * adapters as a native layout config. `@llui/vike` isn't a framework
+ * adapter in that sense — it's a render adapter, and `createOnRenderClient`
+ * consumes the layout component directly via the `Layout` option. Name
+ * the file `Layout.ts`, `app-layout.ts`, or anywhere outside `/pages`
+ * that Vike won't scan, and import it here by path.
+ *
  * ```ts
  * // pages/+onRenderClient.ts
  * import { createOnRenderClient, fromTransition } from '@llui/vike/client'
  * import { routeTransition } from '@llui/transitions'
- * import { AppLayout } from './+Layout'
+ * import { AppLayout } from './Layout' // ← NOT './+Layout'
  *
  * export const onRenderClient = createOnRenderClient({
  *   Layout: AppLayout,

package/dist/on-render-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"on-render-client.d.ts","sourceRoot":"","sources":["../src/on-render-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAa,iBAAiB,EAAS,MAAM,WAAW,CAAA;AAKlF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,cAAc,CAAC,EAAE,OAAO,CAAA;KACzB;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACtD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IACnC,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,KAAK,eAAe,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AACvE,KAAK,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC,CAAA;AAoBjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,eAAe,GAAG,WAAW,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,KAAK,WAAW,CAAC,CAAA;IAE1F;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnD;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,CAAA;IAEnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,iBAAiB,GACnB,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,SAAS,CAAC,CAgBlD;AAoBD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,GAC3B,CAAC,WAAW,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAEnD"}
+{"version":3,"file":"on-render-client.d.ts","sourceRoot":"","sources":["../src/on-render-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAa,iBAAiB,EAAS,MAAM,WAAW,CAAA;AAKrF,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,cAAc,CAAC,EAAE,OAAO,CAAA;KACzB;CACF;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IACnC,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED,KAAK,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC,CAAA;AAoBjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,EAAE,eAAe,GAAG,WAAW,GAAG,CAAC,CAAC,WAAW,EAAE,iBAAiB,KAAK,WAAW,CAAC,CAAA;IAE1F;;;;;;;;;OASG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEnD;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,IAAI,CAAA;IAEnC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,iBAAiB,GACnB,IAAI,CAAC,mBAAmB,EAAE,SAAS,GAAG,SAAS,CAAC,CAgBlD;AA2BD;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,mBAAmB,GAC3B,CAAC,WAAW,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAEnD"}

package/dist/on-render-client.js

@@ -94,11 +94,20 @@ export async function onRenderClient(pageContext) {
  * for the full option surface — this is the entry point for persistent
  * layouts, route transitions, and lifecycle hooks.
  *
+ * **Do not name your layout file `+Layout.ts`.** Vike reserves the `+`
+ * prefix for its own framework config conventions, and `+Layout.ts` is
+ * interpreted by `vike-react` / `vike-vue` / `vike-solid` framework
+ * adapters as a native layout config. `@llui/vike` isn't a framework
+ * adapter in that sense — it's a render adapter, and `createOnRenderClient`
+ * consumes the layout component directly via the `Layout` option. Name
+ * the file `Layout.ts`, `app-layout.ts`, or anywhere outside `/pages`
+ * that Vike won't scan, and import it here by path.
+ *
  * ```ts
  * // pages/+onRenderClient.ts
  * import { createOnRenderClient, fromTransition } from '@llui/vike/client'
  * import { routeTransition } from '@llui/transitions'
- * import { AppLayout } from './+Layout'
+ * import { AppLayout } from './Layout' // ← NOT './+Layout'
  *
  * export const onRenderClient = createOnRenderClient({
  *   Layout: AppLayout,
@@ -139,6 +148,32 @@ async function renderClient(pageContext, options) {
     while (firstMismatch < minLen && chainHandles[firstMismatch].def === newChain[firstMismatch]) {
         firstMismatch++;
     }
+    // Push fresh data into surviving layers (layers in the shared prefix).
+    // Without this, persistent layouts can't react to nav-driven data
+    // changes — pathname, breadcrumbs, session, nav-highlight state all
+    // belong to the layout but change on every client navigation. Each
+    // surviving layer's def can opt in via `propsMsg(data) => Msg`; we
+    // dispatch the resulting message through the handle's `send` so the
+    // layout's update loop processes it like any other state change.
+    //
+    // Diff is shallow-key Object.is on record-shaped data, falling back
+    // to whole-value Object.is for primitives / non-records. This matches
+    // child()'s prop-diff behavior, which is what the report asked us to
+    // mirror. Layers without `propsMsg` are skipped silently — opt-in.
+    for (let i = 0; i < firstMismatch; i++) {
+        const entry = chainHandles[i];
+        const newData = newChainData[i];
+        if (!hasDataChanged(entry.data, newData))
+            continue;
+        entry.data = newData;
+        const propsMsg = entry.def.propsMsg;
+        if (typeof propsMsg !== 'function')
+            continue;
+        const msg = propsMsg(newData);
+        if (msg !== null && msg !== undefined) {
+            entry.handle.send(msg);
+        }
+    }
     // Find the slot element whose contents will change. Shared prefix =
     // everything before firstMismatch. The slot we're about to replace
     // content in sits in the layer at firstMismatch - 1 (if any);
@@ -146,8 +181,9 @@ async function renderClient(pageContext, options) {
     const leaveTarget = firstMismatch === 0 ? rootEl : (chainHandles[firstMismatch - 1].slotMarker ?? rootEl);
     // If everything matches (same chain end-to-end with same defs), this
     // is effectively a no-op nav — the page def hasn't changed. We still
-    // fire onMount so callers can run per-render side effects, but there's
-    // nothing to dispose or mount.
+    // fire onMount so callers can run per-render side effects, and the
+    // surviving-layer data updates above already ran. But there's nothing
+    // to dispose or mount, so skip the rest of the work.
     const isNoOp = firstMismatch === chainHandles.length && firstMismatch === newChain.length;
     if (isNoOp) {
         options.onMount?.();
@@ -215,10 +251,18 @@ function mountChainSuffix(chain, chainData, startAt, initialTarget, initialParen
             // client mismatch throws with a clear error instead of silently
             // hydrating the wrong state into the wrong instance.
             const layerState = extractHydrationState(opts.serverStateEnvelope, i, chain.length, def);
+            // Cross from the type-erased AnyComponentDef back into a concrete
+            // ComponentDef<unknown, unknown, unknown, unknown> for the mount
+            // primitive's signature. The cast is safe — mountApp / hydrateApp
+            // don't use the type parameters at runtime, they just thread the
+            // def through createComponentInstance which accesses init/update/
+            // view by field name. AnyComponentDef has the same field shape.
             handle = hydrateApp(mountTarget, def, layerState, { parentScope });
         }
         else {
-            handle = mountApp(mountTarget, def, layerData, { parentScope });
+            handle = mountApp(mountTarget, def, layerData, {
+                parentScope,
+            });
         }
         const slot = _consumePendingSlot();
         if (isInnermost && slot !== null) {
@@ -243,6 +287,7 @@ function mountChainSuffix(chain, chainData, startAt, initialTarget, initialParen
             handle,
             slotMarker: slot?.marker ?? null,
             slotScope: slot?.slotScope ?? null,
+            data: layerData,
         });
         if (slot !== null) {
             mountTarget = slot.marker;
@@ -260,6 +305,46 @@ function mountChainSuffix(chain, chainData, startAt, initialTarget, initialParen
  * name at a given index — so server/client drift fails loud instead of
  * silently binding the wrong state to the wrong instance.
  */
+/**
+ * Shallow-key data diff for the persistent-layer prop-update path.
+ * Returns true when `next` differs from `prev` enough to warrant
+ * dispatching a `propsMsg`. Mirrors `child()`'s prop-diff semantics:
+ *
+ * - `Object.is(prev, next)` short-circuits identical references.
+ * - For two plain-object records, walks the union of keys and returns
+ *   true on the first `Object.is` mismatch.
+ * - For anything else (primitives, arrays, class instances), falls
+ *   back to the top-level `Object.is` result — covers the cases where
+ *   the host populates `lluiLayoutData[i]` with a primitive or a
+ *   referentially-stable object.
+ */
+function hasDataChanged(prev, next) {
+    if (Object.is(prev, next))
+        return false;
+    // Both must be plain object records to do a key walk; otherwise the
+    // Object.is above is the only signal.
+    if (prev === null ||
+        next === null ||
+        typeof prev !== 'object' ||
+        typeof next !== 'object' ||
+        Array.isArray(prev) ||
+        Array.isArray(next)) {
+        return true;
+    }
+    const prevRec = prev;
+    const nextRec = next;
+    const seen = new Set();
+    for (const k of Object.keys(prevRec)) {
+        seen.add(k);
+        if (!Object.is(prevRec[k], nextRec[k]))
+            return true;
+    }
+    for (const k of Object.keys(nextRec)) {
+        if (!seen.has(k))
+            return true;
+    }
+    return false;
+}
 function extractHydrationState(envelope, layerIndex, chainLength, def) {
     // Legacy flat envelope — no layout chain at render time. Only valid
     // when the chain has a single layer (the page).

package/dist/on-render-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"on-render-client.js","sourceRoot":"","sources":["../src/on-render-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { hydrateApp, mountApp } from '@llui/dom'\nimport type { ComponentDef, AppHandle, TransitionOptions, Scope } from '@llui/dom'\nimport { _consumePendingSlot, _resetPendingSlot } from './page-slot.js'\n\n// Re-exported so `@llui/vike/client` is a one-stop-shop for everything\n// a pages/+onRenderClient.ts / +Layout.ts file needs.\nexport { pageSlot } from './page-slot.js'\n\ndeclare global {\n  interface Window {\n    __LLUI_STATE__?: unknown\n  }\n}\n\n/**\n * Page context shape as seen by `@llui/vike`'s client-side hooks. The\n * `Page` and `data` fields come from whichever `+Page.ts` and `+data.ts`\n * Vike resolved for the current route.\n *\n * `lluiLayoutData` is optional and carries per-layer data for the layout\n * chain configured via `createOnRenderClient({ Layout })`. It's indexed\n * outermost-to-innermost, one entry per layout layer. Absent entries\n * mean the corresponding layout's `init()` receives `undefined`. Users\n * wire this from their Vike `+data.ts` files by merging layout-owned\n * data under the `lluiLayoutData` key.\n */\nexport interface ClientPageContext {\n  Page: ComponentDef<unknown, unknown, unknown, unknown>\n  data?: unknown\n  lluiLayoutData?: readonly unknown[]\n  isHydration?: boolean\n}\n\ntype AnyComponentDef = ComponentDef<unknown, unknown, unknown, unknown>\ntype LayoutChain = ReadonlyArray<AnyComponentDef>\n\n/**\n * Resolves the layout chain for a given pageContext. A single layout\n * becomes a one-element chain; a function resolver gives callers full\n * control to return different chains for different routes (e.g. nested\n * layouts keyed on Vike's `pageContext.urlPathname`).\n */\nfunction resolveLayoutChain(\n  layoutOption: RenderClientOptions['Layout'],\n  pageContext: ClientPageContext,\n): LayoutChain {\n  if (!layoutOption) return []\n  if (typeof layoutOption === 'function') {\n    return layoutOption(pageContext) ?? []\n  }\n  if (Array.isArray(layoutOption)) return layoutOption\n  return [layoutOption as AnyComponentDef]\n}\n\n/**\n * Page-lifecycle hooks that fire around the dispose → mount cycle on\n * client navigation. With persistent layouts in play the cycle only\n * tears down the *divergent* suffix of the layout chain — any layers\n * shared between the old and new routes stay mounted.\n *\n * Navigation sequence for an already-mounted app:\n *\n * ```\n *   client nav triggered\n *     │\n *     ▼\n *   compare old chain to new chain → find first mismatch index K\n *     │\n *     ▼\n *   onLeave(leaveTarget)   ← awaited; leaveTarget is the slot element\n *     │                      at depth K-1 (or the root container if K=0)\n *     │                      whose contents are about to be replaced\n *     ▼\n *   dispose chainHandles[K..end] innermost first\n *     │\n *     ▼\n *   leaveTarget.textContent = ''\n *     │\n *     ▼\n *   mount newChain[K..end] into leaveTarget, outermost first\n *     │\n *     ▼\n *   onEnter(leaveTarget)   ← fire-and-forget; fresh DOM in place\n *     │\n *     ▼\n *   onMount()\n * ```\n *\n * On the initial hydration render, `onLeave` and `onEnter` are NOT\n * called — there's no outgoing page to leave and no animation to enter.\n * Use `onMount` for code that should run on every render including the\n * initial one.\n */\nexport interface RenderClientOptions {\n  /** CSS selector for the mount container. Default: `'#app'`. */\n  container?: string\n\n  /**\n   * Persistent layout chain. One of:\n   *\n   * - A single `ComponentDef` — becomes a one-layout chain.\n   * - An array of `ComponentDef`s — outermost layout first, innermost\n   *   layout last. Every layer except the innermost must call\n   *   `pageSlot()` in its view to declare where nested content renders.\n   * - A function that returns a chain from the current `pageContext` —\n   *   lets different routes use different chains, e.g. by reading\n   *   Vike's `pageContext.urlPathname` or `pageContext.config.Layout`.\n   *\n   * Layers that are shared between the previous and next navigation\n   * stay mounted. Only the divergent suffix is disposed and re-mounted.\n   * Dialogs, focus traps, and effect subscriptions rooted in a surviving\n   * layer are unaffected by the nav.\n   */\n  Layout?: AnyComponentDef | LayoutChain | ((pageContext: ClientPageContext) => LayoutChain)\n\n  /**\n   * Called on the slot element whose contents are about to be replaced,\n   * BEFORE the divergent suffix is disposed and re-mounted. The slot's\n   * current DOM is still attached when this runs — the only moment a\n   * leave animation can read/write it. Return a promise to defer the\n   * swap until the animation completes.\n   *\n   * For a plain no-layout setup, the slot element is the root container.\n   * Not called on the initial hydration render.\n   */\n  onLeave?: (el: HTMLElement) => void | Promise<void>\n\n  /**\n   * Called after the new divergent suffix is mounted, on the same slot\n   * element that was passed to `onLeave`. Use this to kick off an enter\n   * animation. Fire-and-forget — promise returns are ignored.\n   *\n   * Not called on the initial hydration render.\n   */\n  onEnter?: (el: HTMLElement) => void\n\n  /**\n   * Called after mount or hydration completes. Fires on every render\n   * including the initial hydration. Use for per-render side effects\n   * that don't fit the animation hooks.\n   */\n  onMount?: () => void\n}\n\n/**\n * Adapt a `TransitionOptions` object (e.g. the output of\n * `routeTransition()` from `@llui/transitions`, or a preset like `fade`\n * / `slide`) into the `onLeave` / `onEnter` pair expected by\n * `createOnRenderClient`.\n *\n * ```ts\n * import { createOnRenderClient, fromTransition } from '@llui/vike/client'\n * import { routeTransition } from '@llui/transitions'\n *\n * export const onRenderClient = createOnRenderClient({\n *   Layout: AppLayout,\n *   ...fromTransition(routeTransition({ duration: 200 })),\n * })\n * ```\n *\n * The transition operates on the slot element — in a no-layout setup,\n * the root container; in a layout setup, the innermost surviving\n * layer's `pageSlot()` element. Opacity / transform fades apply to the\n * outgoing page content, then the new page fades in.\n */\nexport function fromTransition(\n  t: TransitionOptions,\n): Pick<RenderClientOptions, 'onLeave' | 'onEnter'> {\n  return {\n    onLeave: t.leave\n      ? (el): void | Promise<void> => {\n          const result = t.leave!([el])\n          return result && typeof (result as Promise<void>).then === 'function'\n            ? (result as Promise<void>)\n            : undefined\n        }\n      : undefined,\n    onEnter: t.enter\n      ? (el): void => {\n          t.enter!([el])\n        }\n      : undefined,\n  }\n}\n\n/**\n * One element of the live chain the adapter keeps between navs.\n * `handle` is the AppHandle returned by mountApp/hydrateApp for this\n * layer. `slotMarker` / `slotScope` are set when the layer called\n * `pageSlot()` during its view pass; they're null for the innermost\n * layer (typically the page component, which doesn't have a slot).\n */\ninterface ChainEntry {\n  def: AnyComponentDef\n  handle: AppHandle\n  slotMarker: HTMLElement | null\n  slotScope: Scope | null\n}\n\n// Live chain of mounted layers. Module-level state: there's exactly\n// one chain per Vike-managed app per page load.\nlet chainHandles: ChainEntry[] = []\n\n/**\n * @internal — test helper. Disposes every layer in the current chain\n * and clears the module state so subsequent calls behave as a first\n * mount. Not part of the public API; subject to change without notice.\n */\nexport function _resetChainForTest(): void {\n  // Dispose innermost-first to match the normal teardown path.\n  for (let i = chainHandles.length - 1; i >= 0; i--) {\n    chainHandles[i]!.handle.dispose()\n  }\n  chainHandles = []\n  _resetPendingSlot()\n}\n\n/**\n * Back-compat alias for the pre-layout test helper name.\n * @internal\n * @deprecated — use `_resetChainForTest` instead.\n */\nexport function _resetCurrentHandleForTest(): void {\n  _resetChainForTest()\n}\n\n/**\n * Default onRenderClient hook — no layout, no animation hooks. Hydrates\n * on first load, mounts fresh on subsequent navs. Use `createOnRenderClient`\n * for the customizable factory form.\n */\nexport async function onRenderClient(pageContext: ClientPageContext): Promise<void> {\n  await renderClient(pageContext, {})\n}\n\n/**\n * Factory to create a customized onRenderClient hook. See `RenderClientOptions`\n * for the full option surface — this is the entry point for persistent\n * layouts, route transitions, and lifecycle hooks.\n *\n * ```ts\n * // pages/+onRenderClient.ts\n * import { createOnRenderClient, fromTransition } from '@llui/vike/client'\n * import { routeTransition } from '@llui/transitions'\n * import { AppLayout } from './+Layout'\n *\n * export const onRenderClient = createOnRenderClient({\n *   Layout: AppLayout,\n *   ...fromTransition(routeTransition({ duration: 200 })),\n *   onMount: () => console.log('page rendered'),\n * })\n * ```\n */\nexport function createOnRenderClient(\n  options: RenderClientOptions,\n): (pageContext: ClientPageContext) => Promise<void> {\n  return (pageContext) => renderClient(pageContext, options)\n}\n\nasync function renderClient(\n  pageContext: ClientPageContext,\n  options: RenderClientOptions,\n): Promise<void> {\n  const selector = options.container ?? '#app'\n  const container = document.querySelector(selector)\n  if (!container) {\n    throw new Error(`@llui/vike: container \"${selector}\" not found in DOM`)\n  }\n  const rootEl = container as HTMLElement\n\n  // Resolve the chain for this render. The page component is always\n  // the innermost entry, regardless of layout configuration.\n  const layoutChain = resolveLayoutChain(options.Layout, pageContext)\n  const layoutData = pageContext.lluiLayoutData ?? []\n  const newChain: LayoutChain = [...layoutChain, pageContext.Page]\n  const newChainData: readonly unknown[] = [...layoutData, pageContext.data]\n\n  if (pageContext.isHydration) {\n    // First load — the chain starts empty and we hydrate every layer\n    // against server-rendered HTML. No onLeave/onEnter on hydration.\n    await mountOrHydrateChain(newChain, newChainData, rootEl, {\n      mode: 'hydrate',\n      serverStateEnvelope: window.__LLUI_STATE__,\n    })\n    options.onMount?.()\n    return\n  }\n\n  // Subsequent nav — diff the chain to find the divergent suffix.\n  let firstMismatch = 0\n  const minLen = Math.min(chainHandles.length, newChain.length)\n  while (firstMismatch < minLen && chainHandles[firstMismatch]!.def === newChain[firstMismatch]) {\n    firstMismatch++\n  }\n\n  // Find the slot element whose contents will change. Shared prefix =\n  // everything before firstMismatch. The slot we're about to replace\n  // content in sits in the layer at firstMismatch - 1 (if any);\n  // otherwise we're swapping the whole app at the root container.\n  const leaveTarget =\n    firstMismatch === 0 ? rootEl : (chainHandles[firstMismatch - 1]!.slotMarker ?? rootEl)\n\n  // If everything matches (same chain end-to-end with same defs), this\n  // is effectively a no-op nav — the page def hasn't changed. We still\n  // fire onMount so callers can run per-render side effects, but there's\n  // nothing to dispose or mount.\n  const isNoOp = firstMismatch === chainHandles.length && firstMismatch === newChain.length\n  if (isNoOp) {\n    options.onMount?.()\n    return\n  }\n\n  // onLeave runs BEFORE any teardown. Outgoing DOM still mounted here.\n  // Skip on the very first mount — there's no outgoing page to leave.\n  const isFirstMount = chainHandles.length === 0\n  if (options.onLeave && !isFirstMount) {\n    await options.onLeave(leaveTarget)\n  }\n\n  // Dispose the divergent suffix, innermost first. Each handle.dispose()\n  // calls disposeScope on that layer's rootScope, which cascades through\n  // every child scope the layer owned (bindings, portals, onMount\n  // cleanups, dialog focus traps, etc.). The surviving layers are\n  // untouched because their scopes live above the disposal roots.\n  for (let i = chainHandles.length - 1; i >= firstMismatch; i--) {\n    chainHandles[i]!.handle.dispose()\n  }\n  chainHandles = chainHandles.slice(0, firstMismatch)\n\n  // Clear the slot element before mounting the new suffix. handle.dispose()\n  // above already did this for the innermost layer's container, but the\n  // slot at firstMismatch - 1 keeps its marker element (it's owned by the\n  // surviving layer) and we mount fresh children into it.\n  leaveTarget.textContent = ''\n\n  // Mount the new suffix starting at firstMismatch.\n  const parentScope =\n    firstMismatch === 0 ? undefined : (chainHandles[firstMismatch - 1]!.slotScope ?? undefined)\n  mountChainSuffix(newChain, newChainData, firstMismatch, leaveTarget, parentScope, {\n    mode: 'mount',\n  })\n\n  // onEnter fires after the new suffix is in place. Fire-and-forget.\n  options.onEnter?.(leaveTarget)\n  options.onMount?.()\n}\n\n/**\n * Walk the full chain for the first mount or hydration. Starts from\n * depth 0 at the root container, threads each layer's slot into the\n * next layer's mount target + parentScope.\n */\nasync function mountOrHydrateChain(\n  chain: LayoutChain,\n  chainData: readonly unknown[],\n  rootEl: HTMLElement,\n  opts: MountOpts,\n): Promise<void> {\n  mountChainSuffix(chain, chainData, 0, rootEl, undefined, opts)\n}\n\ninterface MountOpts {\n  mode: 'mount' | 'hydrate'\n  /** For hydration: the full `window.__LLUI_STATE__` envelope. */\n  serverStateEnvelope?: unknown\n}\n\n/**\n * Mount (or hydrate) `chain[startAt..end]` into `initialTarget`, with\n * the initial layer's rootScope parented at `initialParentScope`.\n * Threads slot → next-target → next-parentScope through the chain.\n *\n * Fails loudly if a non-innermost layer forgot to call `pageSlot()`,\n * or if the innermost layer called `pageSlot()` unnecessarily.\n */\nfunction mountChainSuffix(\n  chain: LayoutChain,\n  chainData: readonly unknown[],\n  startAt: number,\n  initialTarget: HTMLElement,\n  initialParentScope: Scope | undefined,\n  opts: MountOpts,\n): void {\n  let mountTarget: HTMLElement = initialTarget\n  let parentScope: Scope | undefined = initialParentScope\n\n  for (let i = startAt; i < chain.length; i++) {\n    const def = chain[i]!\n    const layerData = chainData[i]\n    const isInnermost = i === chain.length - 1\n\n    // Defensive: clear any stale slot from a prior failed mount.\n    _resetPendingSlot()\n\n    let handle: AppHandle\n    if (opts.mode === 'hydrate') {\n      // Hydration envelope: each layer pulls its own state slice. The\n      // envelope shape is `{ layouts: [...], page: {...} }` with each\n      // entry carrying `{ name, state }`. We match by name so a server/\n      // client mismatch throws with a clear error instead of silently\n      // hydrating the wrong state into the wrong instance.\n      const layerState = extractHydrationState(opts.serverStateEnvelope, i, chain.length, def)\n      handle = hydrateApp(mountTarget, def, layerState, { parentScope })\n    } else {\n      handle = mountApp(mountTarget, def, layerData, { parentScope })\n    }\n\n    const slot = _consumePendingSlot()\n\n    if (isInnermost && slot !== null) {\n      // Innermost layer declared a slot with nothing to fill it —\n      // probably a misuse of pageSlot() in the page component itself.\n      handle.dispose()\n      throw new Error(\n        `[llui/vike] <${def.name}> is the innermost component in the chain ` +\n          `but called pageSlot(). pageSlot() only belongs in layout components ` +\n          `that wrap a nested page or layout — not in the page itself.`,\n      )\n    }\n    if (!isInnermost && slot === null) {\n      // Non-innermost layer didn't declare a slot — there's nowhere to\n      // mount the remaining chain.\n      handle.dispose()\n      throw new Error(\n        `[llui/vike] <${def.name}> is a layout layer at depth ${i} but did not ` +\n          `call pageSlot() in its view(). There are ${chain.length - i - 1} more ` +\n          `layer(s) to mount and no slot to mount them into. Add pageSlot() from ` +\n          `@llui/vike/client to the view at the position where nested content renders.`,\n      )\n    }\n\n    chainHandles.push({\n      def,\n      handle,\n      slotMarker: slot?.marker ?? null,\n      slotScope: slot?.slotScope ?? null,\n    })\n\n    if (slot !== null) {\n      mountTarget = slot.marker\n      parentScope = slot.slotScope\n    }\n  }\n}\n\n/**\n * Pull the per-layer state from the hydration envelope. Supports both\n * the new chain-aware shape (`{ layouts: [...], page: {...} }`) and the\n * legacy flat shape (`window.__LLUI_STATE__` is the state object itself)\n * for backward compatibility with pages written against 0.0.15 or earlier.\n *\n * Throws on envelope shape mismatch — missing entries, wrong component\n * name at a given index — so server/client drift fails loud instead of\n * silently binding the wrong state to the wrong instance.\n */\nfunction extractHydrationState(\n  envelope: unknown,\n  layerIndex: number,\n  chainLength: number,\n  def: AnyComponentDef,\n): unknown {\n  // Legacy flat envelope — no layout chain at render time. Only valid\n  // when the chain has a single layer (the page).\n  const isLegacyFlat =\n    envelope !== null &&\n    typeof envelope === 'object' &&\n    !('layouts' in (envelope as object)) &&\n    !('page' in (envelope as object))\n\n  if (isLegacyFlat) {\n    if (chainLength !== 1) {\n      throw new Error(\n        `[llui/vike] Hydration envelope is in the legacy flat shape but the ` +\n          `current render has ${chainLength} chain layers. The server must emit ` +\n          `the chain-aware shape ({ layouts, page }) when rendering with a layout.`,\n      )\n    }\n    return envelope\n  }\n\n  const chainEnvelope = envelope as\n    | { layouts?: Array<{ name: string; state: unknown }>; page?: { name: string; state: unknown } }\n    | undefined\n  if (!chainEnvelope) {\n    throw new Error(\n      `[llui/vike] Hydration envelope is missing. Server-side onRenderHtml must ` +\n        `populate window.__LLUI_STATE__ with the full chain before client hydration.`,\n    )\n  }\n\n  const isPageLayer = layerIndex === chainLength - 1\n  const layoutEntries = chainEnvelope.layouts ?? []\n  const expected = isPageLayer ? chainEnvelope.page : layoutEntries[layerIndex]\n\n  if (!expected) {\n    throw new Error(\n      `[llui/vike] Hydration envelope has no entry for chain layer ${layerIndex} ` +\n        `(<${def.name}>). Server rendered ${layoutEntries.length} layouts + ${\n          chainEnvelope.page ? 'a page' : 'no page'\n        }, client expected ${chainLength} total entries.`,\n    )\n  }\n\n  if (expected.name !== def.name) {\n    throw new Error(\n      `[llui/vike] Hydration mismatch at chain layer ${layerIndex}: server ` +\n        `rendered <${expected.name}> but client is trying to hydrate <${def.name}>. ` +\n        `This usually means the layout chain resolver returns different layouts ` +\n        `on the server and the client for the same route.`,\n    )\n  }\n\n  return expected.state\n}\n"]}
+{"version":3,"file":"on-render-client.js","sourceRoot":"","sources":["../src/on-render-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { hydrateApp, mountApp } from '@llui/dom'\nimport type { AnyComponentDef, AppHandle, TransitionOptions, Scope } from '@llui/dom'\nimport { _consumePendingSlot, _resetPendingSlot } from './page-slot.js'\n\n// Re-exported so `@llui/vike/client` is a one-stop-shop for everything\n// a pages/+onRenderClient.ts / +Layout.ts file needs.\nexport { pageSlot } from './page-slot.js'\n\ndeclare global {\n  interface Window {\n    __LLUI_STATE__?: unknown\n  }\n}\n\n/**\n * Page context shape as seen by `@llui/vike`'s client-side hooks. The\n * `Page` and `data` fields come from whichever `+Page.ts` and `+data.ts`\n * Vike resolved for the current route.\n *\n * `lluiLayoutData` is optional and carries per-layer data for the layout\n * chain configured via `createOnRenderClient({ Layout })`. It's indexed\n * outermost-to-innermost, one entry per layout layer. Absent entries\n * mean the corresponding layout's `init()` receives `undefined`. Users\n * wire this from their Vike `+data.ts` files by merging layout-owned\n * data under the `lluiLayoutData` key.\n */\nexport interface ClientPageContext {\n  Page: AnyComponentDef\n  data?: unknown\n  lluiLayoutData?: readonly unknown[]\n  isHydration?: boolean\n}\n\ntype LayoutChain = ReadonlyArray<AnyComponentDef>\n\n/**\n * Resolves the layout chain for a given pageContext. A single layout\n * becomes a one-element chain; a function resolver gives callers full\n * control to return different chains for different routes (e.g. nested\n * layouts keyed on Vike's `pageContext.urlPathname`).\n */\nfunction resolveLayoutChain(\n  layoutOption: RenderClientOptions['Layout'],\n  pageContext: ClientPageContext,\n): LayoutChain {\n  if (!layoutOption) return []\n  if (typeof layoutOption === 'function') {\n    return layoutOption(pageContext) ?? []\n  }\n  if (Array.isArray(layoutOption)) return layoutOption\n  return [layoutOption as AnyComponentDef]\n}\n\n/**\n * Page-lifecycle hooks that fire around the dispose → mount cycle on\n * client navigation. With persistent layouts in play the cycle only\n * tears down the *divergent* suffix of the layout chain — any layers\n * shared between the old and new routes stay mounted.\n *\n * Navigation sequence for an already-mounted app:\n *\n * ```\n *   client nav triggered\n *     │\n *     ▼\n *   compare old chain to new chain → find first mismatch index K\n *     │\n *     ▼\n *   onLeave(leaveTarget)   ← awaited; leaveTarget is the slot element\n *     │                      at depth K-1 (or the root container if K=0)\n *     │                      whose contents are about to be replaced\n *     ▼\n *   dispose chainHandles[K..end] innermost first\n *     │\n *     ▼\n *   leaveTarget.textContent = ''\n *     │\n *     ▼\n *   mount newChain[K..end] into leaveTarget, outermost first\n *     │\n *     ▼\n *   onEnter(leaveTarget)   ← fire-and-forget; fresh DOM in place\n *     │\n *     ▼\n *   onMount()\n * ```\n *\n * On the initial hydration render, `onLeave` and `onEnter` are NOT\n * called — there's no outgoing page to leave and no animation to enter.\n * Use `onMount` for code that should run on every render including the\n * initial one.\n */\nexport interface RenderClientOptions {\n  /** CSS selector for the mount container. Default: `'#app'`. */\n  container?: string\n\n  /**\n   * Persistent layout chain. One of:\n   *\n   * - A single `ComponentDef` — becomes a one-layout chain.\n   * - An array of `ComponentDef`s — outermost layout first, innermost\n   *   layout last. Every layer except the innermost must call\n   *   `pageSlot()` in its view to declare where nested content renders.\n   * - A function that returns a chain from the current `pageContext` —\n   *   lets different routes use different chains, e.g. by reading\n   *   Vike's `pageContext.urlPathname` or `pageContext.config.Layout`.\n   *\n   * Layers that are shared between the previous and next navigation\n   * stay mounted. Only the divergent suffix is disposed and re-mounted.\n   * Dialogs, focus traps, and effect subscriptions rooted in a surviving\n   * layer are unaffected by the nav.\n   */\n  Layout?: AnyComponentDef | LayoutChain | ((pageContext: ClientPageContext) => LayoutChain)\n\n  /**\n   * Called on the slot element whose contents are about to be replaced,\n   * BEFORE the divergent suffix is disposed and re-mounted. The slot's\n   * current DOM is still attached when this runs — the only moment a\n   * leave animation can read/write it. Return a promise to defer the\n   * swap until the animation completes.\n   *\n   * For a plain no-layout setup, the slot element is the root container.\n   * Not called on the initial hydration render.\n   */\n  onLeave?: (el: HTMLElement) => void | Promise<void>\n\n  /**\n   * Called after the new divergent suffix is mounted, on the same slot\n   * element that was passed to `onLeave`. Use this to kick off an enter\n   * animation. Fire-and-forget — promise returns are ignored.\n   *\n   * Not called on the initial hydration render.\n   */\n  onEnter?: (el: HTMLElement) => void\n\n  /**\n   * Called after mount or hydration completes. Fires on every render\n   * including the initial hydration. Use for per-render side effects\n   * that don't fit the animation hooks.\n   */\n  onMount?: () => void\n}\n\n/**\n * Adapt a `TransitionOptions` object (e.g. the output of\n * `routeTransition()` from `@llui/transitions`, or a preset like `fade`\n * / `slide`) into the `onLeave` / `onEnter` pair expected by\n * `createOnRenderClient`.\n *\n * ```ts\n * import { createOnRenderClient, fromTransition } from '@llui/vike/client'\n * import { routeTransition } from '@llui/transitions'\n *\n * export const onRenderClient = createOnRenderClient({\n *   Layout: AppLayout,\n *   ...fromTransition(routeTransition({ duration: 200 })),\n * })\n * ```\n *\n * The transition operates on the slot element — in a no-layout setup,\n * the root container; in a layout setup, the innermost surviving\n * layer's `pageSlot()` element. Opacity / transform fades apply to the\n * outgoing page content, then the new page fades in.\n */\nexport function fromTransition(\n  t: TransitionOptions,\n): Pick<RenderClientOptions, 'onLeave' | 'onEnter'> {\n  return {\n    onLeave: t.leave\n      ? (el): void | Promise<void> => {\n          const result = t.leave!([el])\n          return result && typeof (result as Promise<void>).then === 'function'\n            ? (result as Promise<void>)\n            : undefined\n        }\n      : undefined,\n    onEnter: t.enter\n      ? (el): void => {\n          t.enter!([el])\n        }\n      : undefined,\n  }\n}\n\n/**\n * One element of the live chain the adapter keeps between navs.\n * `handle` is the AppHandle returned by mountApp/hydrateApp for this\n * layer. `slotMarker` / `slotScope` are set when the layer called\n * `pageSlot()` during its view pass; they're null for the innermost\n * layer (typically the page component, which doesn't have a slot).\n */\ninterface ChainEntry {\n  def: AnyComponentDef\n  handle: AppHandle\n  slotMarker: HTMLElement | null\n  slotScope: Scope | null\n  /**\n   * The data slice this layer was most recently mounted or updated\n   * with. Compared shallow-key against the next nav's `lluiLayoutData[i]`\n   * to decide whether a surviving layer needs a `propsMsg` dispatch.\n   * Layers that didn't receive any layout data carry `undefined` here.\n   */\n  data: unknown\n}\n\n// Live chain of mounted layers. Module-level state: there's exactly\n// one chain per Vike-managed app per page load.\nlet chainHandles: ChainEntry[] = []\n\n/**\n * @internal — test helper. Disposes every layer in the current chain\n * and clears the module state so subsequent calls behave as a first\n * mount. Not part of the public API; subject to change without notice.\n */\nexport function _resetChainForTest(): void {\n  // Dispose innermost-first to match the normal teardown path.\n  for (let i = chainHandles.length - 1; i >= 0; i--) {\n    chainHandles[i]!.handle.dispose()\n  }\n  chainHandles = []\n  _resetPendingSlot()\n}\n\n/**\n * Back-compat alias for the pre-layout test helper name.\n * @internal\n * @deprecated — use `_resetChainForTest` instead.\n */\nexport function _resetCurrentHandleForTest(): void {\n  _resetChainForTest()\n}\n\n/**\n * Default onRenderClient hook — no layout, no animation hooks. Hydrates\n * on first load, mounts fresh on subsequent navs. Use `createOnRenderClient`\n * for the customizable factory form.\n */\nexport async function onRenderClient(pageContext: ClientPageContext): Promise<void> {\n  await renderClient(pageContext, {})\n}\n\n/**\n * Factory to create a customized onRenderClient hook. See `RenderClientOptions`\n * for the full option surface — this is the entry point for persistent\n * layouts, route transitions, and lifecycle hooks.\n *\n * **Do not name your layout file `+Layout.ts`.** Vike reserves the `+`\n * prefix for its own framework config conventions, and `+Layout.ts` is\n * interpreted by `vike-react` / `vike-vue` / `vike-solid` framework\n * adapters as a native layout config. `@llui/vike` isn't a framework\n * adapter in that sense — it's a render adapter, and `createOnRenderClient`\n * consumes the layout component directly via the `Layout` option. Name\n * the file `Layout.ts`, `app-layout.ts`, or anywhere outside `/pages`\n * that Vike won't scan, and import it here by path.\n *\n * ```ts\n * // pages/+onRenderClient.ts\n * import { createOnRenderClient, fromTransition } from '@llui/vike/client'\n * import { routeTransition } from '@llui/transitions'\n * import { AppLayout } from './Layout' // ← NOT './+Layout'\n *\n * export const onRenderClient = createOnRenderClient({\n *   Layout: AppLayout,\n *   ...fromTransition(routeTransition({ duration: 200 })),\n *   onMount: () => console.log('page rendered'),\n * })\n * ```\n */\nexport function createOnRenderClient(\n  options: RenderClientOptions,\n): (pageContext: ClientPageContext) => Promise<void> {\n  return (pageContext) => renderClient(pageContext, options)\n}\n\nasync function renderClient(\n  pageContext: ClientPageContext,\n  options: RenderClientOptions,\n): Promise<void> {\n  const selector = options.container ?? '#app'\n  const container = document.querySelector(selector)\n  if (!container) {\n    throw new Error(`@llui/vike: container \"${selector}\" not found in DOM`)\n  }\n  const rootEl = container as HTMLElement\n\n  // Resolve the chain for this render. The page component is always\n  // the innermost entry, regardless of layout configuration.\n  const layoutChain = resolveLayoutChain(options.Layout, pageContext)\n  const layoutData = pageContext.lluiLayoutData ?? []\n  const newChain: LayoutChain = [...layoutChain, pageContext.Page]\n  const newChainData: readonly unknown[] = [...layoutData, pageContext.data]\n\n  if (pageContext.isHydration) {\n    // First load — the chain starts empty and we hydrate every layer\n    // against server-rendered HTML. No onLeave/onEnter on hydration.\n    await mountOrHydrateChain(newChain, newChainData, rootEl, {\n      mode: 'hydrate',\n      serverStateEnvelope: window.__LLUI_STATE__,\n    })\n    options.onMount?.()\n    return\n  }\n\n  // Subsequent nav — diff the chain to find the divergent suffix.\n  let firstMismatch = 0\n  const minLen = Math.min(chainHandles.length, newChain.length)\n  while (firstMismatch < minLen && chainHandles[firstMismatch]!.def === newChain[firstMismatch]) {\n    firstMismatch++\n  }\n\n  // Push fresh data into surviving layers (layers in the shared prefix).\n  // Without this, persistent layouts can't react to nav-driven data\n  // changes — pathname, breadcrumbs, session, nav-highlight state all\n  // belong to the layout but change on every client navigation. Each\n  // surviving layer's def can opt in via `propsMsg(data) => Msg`; we\n  // dispatch the resulting message through the handle's `send` so the\n  // layout's update loop processes it like any other state change.\n  //\n  // Diff is shallow-key Object.is on record-shaped data, falling back\n  // to whole-value Object.is for primitives / non-records. This matches\n  // child()'s prop-diff behavior, which is what the report asked us to\n  // mirror. Layers without `propsMsg` are skipped silently — opt-in.\n  for (let i = 0; i < firstMismatch; i++) {\n    const entry = chainHandles[i]!\n    const newData = newChainData[i]\n    if (!hasDataChanged(entry.data, newData)) continue\n    entry.data = newData\n    const propsMsg = (entry.def as { propsMsg?: (data: unknown) => unknown }).propsMsg\n    if (typeof propsMsg !== 'function') continue\n    const msg = propsMsg(newData)\n    if (msg !== null && msg !== undefined) {\n      entry.handle.send(msg)\n    }\n  }\n\n  // Find the slot element whose contents will change. Shared prefix =\n  // everything before firstMismatch. The slot we're about to replace\n  // content in sits in the layer at firstMismatch - 1 (if any);\n  // otherwise we're swapping the whole app at the root container.\n  const leaveTarget =\n    firstMismatch === 0 ? rootEl : (chainHandles[firstMismatch - 1]!.slotMarker ?? rootEl)\n\n  // If everything matches (same chain end-to-end with same defs), this\n  // is effectively a no-op nav — the page def hasn't changed. We still\n  // fire onMount so callers can run per-render side effects, and the\n  // surviving-layer data updates above already ran. But there's nothing\n  // to dispose or mount, so skip the rest of the work.\n  const isNoOp = firstMismatch === chainHandles.length && firstMismatch === newChain.length\n  if (isNoOp) {\n    options.onMount?.()\n    return\n  }\n\n  // onLeave runs BEFORE any teardown. Outgoing DOM still mounted here.\n  // Skip on the very first mount — there's no outgoing page to leave.\n  const isFirstMount = chainHandles.length === 0\n  if (options.onLeave && !isFirstMount) {\n    await options.onLeave(leaveTarget)\n  }\n\n  // Dispose the divergent suffix, innermost first. Each handle.dispose()\n  // calls disposeScope on that layer's rootScope, which cascades through\n  // every child scope the layer owned (bindings, portals, onMount\n  // cleanups, dialog focus traps, etc.). The surviving layers are\n  // untouched because their scopes live above the disposal roots.\n  for (let i = chainHandles.length - 1; i >= firstMismatch; i--) {\n    chainHandles[i]!.handle.dispose()\n  }\n  chainHandles = chainHandles.slice(0, firstMismatch)\n\n  // Clear the slot element before mounting the new suffix. handle.dispose()\n  // above already did this for the innermost layer's container, but the\n  // slot at firstMismatch - 1 keeps its marker element (it's owned by the\n  // surviving layer) and we mount fresh children into it.\n  leaveTarget.textContent = ''\n\n  // Mount the new suffix starting at firstMismatch.\n  const parentScope =\n    firstMismatch === 0 ? undefined : (chainHandles[firstMismatch - 1]!.slotScope ?? undefined)\n  mountChainSuffix(newChain, newChainData, firstMismatch, leaveTarget, parentScope, {\n    mode: 'mount',\n  })\n\n  // onEnter fires after the new suffix is in place. Fire-and-forget.\n  options.onEnter?.(leaveTarget)\n  options.onMount?.()\n}\n\n/**\n * Walk the full chain for the first mount or hydration. Starts from\n * depth 0 at the root container, threads each layer's slot into the\n * next layer's mount target + parentScope.\n */\nasync function mountOrHydrateChain(\n  chain: LayoutChain,\n  chainData: readonly unknown[],\n  rootEl: HTMLElement,\n  opts: MountOpts,\n): Promise<void> {\n  mountChainSuffix(chain, chainData, 0, rootEl, undefined, opts)\n}\n\ninterface MountOpts {\n  mode: 'mount' | 'hydrate'\n  /** For hydration: the full `window.__LLUI_STATE__` envelope. */\n  serverStateEnvelope?: unknown\n}\n\n/**\n * Mount (or hydrate) `chain[startAt..end]` into `initialTarget`, with\n * the initial layer's rootScope parented at `initialParentScope`.\n * Threads slot → next-target → next-parentScope through the chain.\n *\n * Fails loudly if a non-innermost layer forgot to call `pageSlot()`,\n * or if the innermost layer called `pageSlot()` unnecessarily.\n */\nfunction mountChainSuffix(\n  chain: LayoutChain,\n  chainData: readonly unknown[],\n  startAt: number,\n  initialTarget: HTMLElement,\n  initialParentScope: Scope | undefined,\n  opts: MountOpts,\n): void {\n  let mountTarget: HTMLElement = initialTarget\n  let parentScope: Scope | undefined = initialParentScope\n\n  for (let i = startAt; i < chain.length; i++) {\n    const def = chain[i]!\n    const layerData = chainData[i]\n    const isInnermost = i === chain.length - 1\n\n    // Defensive: clear any stale slot from a prior failed mount.\n    _resetPendingSlot()\n\n    let handle: AppHandle\n    if (opts.mode === 'hydrate') {\n      // Hydration envelope: each layer pulls its own state slice. The\n      // envelope shape is `{ layouts: [...], page: {...} }` with each\n      // entry carrying `{ name, state }`. We match by name so a server/\n      // client mismatch throws with a clear error instead of silently\n      // hydrating the wrong state into the wrong instance.\n      const layerState = extractHydrationState(opts.serverStateEnvelope, i, chain.length, def)\n      // Cross from the type-erased AnyComponentDef back into a concrete\n      // ComponentDef<unknown, unknown, unknown, unknown> for the mount\n      // primitive's signature. The cast is safe — mountApp / hydrateApp\n      // don't use the type parameters at runtime, they just thread the\n      // def through createComponentInstance which accesses init/update/\n      // view by field name. AnyComponentDef has the same field shape.\n      handle = hydrateApp(\n        mountTarget,\n        def as unknown as Parameters<typeof hydrateApp>[1],\n        layerState,\n        { parentScope },\n      )\n    } else {\n      handle = mountApp(mountTarget, def as unknown as Parameters<typeof mountApp>[1], layerData, {\n        parentScope,\n      })\n    }\n\n    const slot = _consumePendingSlot()\n\n    if (isInnermost && slot !== null) {\n      // Innermost layer declared a slot with nothing to fill it —\n      // probably a misuse of pageSlot() in the page component itself.\n      handle.dispose()\n      throw new Error(\n        `[llui/vike] <${def.name}> is the innermost component in the chain ` +\n          `but called pageSlot(). pageSlot() only belongs in layout components ` +\n          `that wrap a nested page or layout — not in the page itself.`,\n      )\n    }\n    if (!isInnermost && slot === null) {\n      // Non-innermost layer didn't declare a slot — there's nowhere to\n      // mount the remaining chain.\n      handle.dispose()\n      throw new Error(\n        `[llui/vike] <${def.name}> is a layout layer at depth ${i} but did not ` +\n          `call pageSlot() in its view(). There are ${chain.length - i - 1} more ` +\n          `layer(s) to mount and no slot to mount them into. Add pageSlot() from ` +\n          `@llui/vike/client to the view at the position where nested content renders.`,\n      )\n    }\n\n    chainHandles.push({\n      def,\n      handle,\n      slotMarker: slot?.marker ?? null,\n      slotScope: slot?.slotScope ?? null,\n      data: layerData,\n    })\n\n    if (slot !== null) {\n      mountTarget = slot.marker\n      parentScope = slot.slotScope\n    }\n  }\n}\n\n/**\n * Pull the per-layer state from the hydration envelope. Supports both\n * the new chain-aware shape (`{ layouts: [...], page: {...} }`) and the\n * legacy flat shape (`window.__LLUI_STATE__` is the state object itself)\n * for backward compatibility with pages written against 0.0.15 or earlier.\n *\n * Throws on envelope shape mismatch — missing entries, wrong component\n * name at a given index — so server/client drift fails loud instead of\n * silently binding the wrong state to the wrong instance.\n */\n/**\n * Shallow-key data diff for the persistent-layer prop-update path.\n * Returns true when `next` differs from `prev` enough to warrant\n * dispatching a `propsMsg`. Mirrors `child()`'s prop-diff semantics:\n *\n * - `Object.is(prev, next)` short-circuits identical references.\n * - For two plain-object records, walks the union of keys and returns\n *   true on the first `Object.is` mismatch.\n * - For anything else (primitives, arrays, class instances), falls\n *   back to the top-level `Object.is` result — covers the cases where\n *   the host populates `lluiLayoutData[i]` with a primitive or a\n *   referentially-stable object.\n */\nfunction hasDataChanged(prev: unknown, next: unknown): boolean {\n  if (Object.is(prev, next)) return false\n  // Both must be plain object records to do a key walk; otherwise the\n  // Object.is above is the only signal.\n  if (\n    prev === null ||\n    next === null ||\n    typeof prev !== 'object' ||\n    typeof next !== 'object' ||\n    Array.isArray(prev) ||\n    Array.isArray(next)\n  ) {\n    return true\n  }\n  const prevRec = prev as Record<string, unknown>\n  const nextRec = next as Record<string, unknown>\n  const seen = new Set<string>()\n  for (const k of Object.keys(prevRec)) {\n    seen.add(k)\n    if (!Object.is(prevRec[k], nextRec[k])) return true\n  }\n  for (const k of Object.keys(nextRec)) {\n    if (!seen.has(k)) return true\n  }\n  return false\n}\n\nfunction extractHydrationState(\n  envelope: unknown,\n  layerIndex: number,\n  chainLength: number,\n  def: AnyComponentDef,\n): unknown {\n  // Legacy flat envelope — no layout chain at render time. Only valid\n  // when the chain has a single layer (the page).\n  const isLegacyFlat =\n    envelope !== null &&\n    typeof envelope === 'object' &&\n    !('layouts' in (envelope as object)) &&\n    !('page' in (envelope as object))\n\n  if (isLegacyFlat) {\n    if (chainLength !== 1) {\n      throw new Error(\n        `[llui/vike] Hydration envelope is in the legacy flat shape but the ` +\n          `current render has ${chainLength} chain layers. The server must emit ` +\n          `the chain-aware shape ({ layouts, page }) when rendering with a layout.`,\n      )\n    }\n    return envelope\n  }\n\n  const chainEnvelope = envelope as\n    | { layouts?: Array<{ name: string; state: unknown }>; page?: { name: string; state: unknown } }\n    | undefined\n  if (!chainEnvelope) {\n    throw new Error(\n      `[llui/vike] Hydration envelope is missing. Server-side onRenderHtml must ` +\n        `populate window.__LLUI_STATE__ with the full chain before client hydration.`,\n    )\n  }\n\n  const isPageLayer = layerIndex === chainLength - 1\n  const layoutEntries = chainEnvelope.layouts ?? []\n  const expected = isPageLayer ? chainEnvelope.page : layoutEntries[layerIndex]\n\n  if (!expected) {\n    throw new Error(\n      `[llui/vike] Hydration envelope has no entry for chain layer ${layerIndex} ` +\n        `(<${def.name}>). Server rendered ${layoutEntries.length} layouts + ${\n          chainEnvelope.page ? 'a page' : 'no page'\n        }, client expected ${chainLength} total entries.`,\n    )\n  }\n\n  if (expected.name !== def.name) {\n    throw new Error(\n      `[llui/vike] Hydration mismatch at chain layer ${layerIndex}: server ` +\n        `rendered <${expected.name}> but client is trying to hydrate <${def.name}>. ` +\n        `This usually means the layout chain resolver returns different layouts ` +\n        `on the server and the client for the same route.`,\n    )\n  }\n\n  return expected.state\n}\n"]}

package/dist/on-render-html.d.ts

@@ -1,5 +1,4 @@
-import type { ComponentDef } from '@llui/dom';
-type AnyComponentDef = ComponentDef<unknown, unknown, unknown, unknown>;
+import type { AnyComponentDef } from '@llui/dom';
 type LayoutChain = ReadonlyArray<AnyComponentDef>;
 /**
  * Page context shape as seen by `@llui/vike`'s server hook. `Page` and
@@ -61,10 +60,16 @@ export declare function onRenderHtml(pageContext: PageContext): Promise<RenderHt
 /**
  * Factory to create a customized onRenderHtml hook.
  *
+ * **Do not name your layout file `+Layout.ts`.** Vike reserves `+Layout`
+ * for its own framework-adapter config (`vike-react` / `vike-vue` /
+ * `vike-solid`) and will conflict with `@llui/vike`'s `Layout` option.
+ * Name the file `Layout.ts`, `app-layout.ts`, or anywhere outside
+ * `/pages` that Vike won't scan, and import it here by path.
+ *
  * ```ts
  * // pages/+onRenderHtml.ts
  * import { createOnRenderHtml } from '@llui/vike/server'
- * import { AppLayout } from './+Layout'
+ * import { AppLayout } from './Layout' // ← NOT './+Layout'
  *
  * export const onRenderHtml = createOnRenderHtml({
  *   Layout: AppLayout,

package/dist/on-render-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"on-render-html.d.ts","sourceRoot":"","sources":["../src/on-render-html.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,WAAW,CAAA;AAG7D,KAAK,eAAe,GAAG,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;AACvE,KAAK,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAA;IACZ,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,WAAW,EAAE,WAAW,CAAA;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,WAAW,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAA;CACpC;AAcD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,CAAA;IAE3C;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,eAAe,GAAG,WAAW,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,KAAK,WAAW,CAAC,CAAA;CACrF;AAcD;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEtF;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,GACzB,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAEzD"}
+{"version":3,"file":"on-render-html.d.ts","sourceRoot":"","sources":["../src/on-render-html.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,WAAW,CAAA;AAGhE,KAAK,WAAW,GAAG,aAAa,CAAC,eAAe,CAAC,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAA;IACrB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,cAAc,CAAC,EAAE,SAAS,OAAO,EAAE,CAAA;IACnC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAA;IACZ,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAA;IACb,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAA;IACZ,yCAAyC;IACzC,WAAW,EAAE,WAAW,CAAA;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IAC3C,WAAW,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAA;CACpC;AAcD;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,MAAM,CAAA;IAE3C;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,EAAE,eAAe,GAAG,WAAW,GAAG,CAAC,CAAC,WAAW,EAAE,WAAW,KAAK,WAAW,CAAC,CAAA;CACrF;AAcD;;GAEG;AACH,wBAAsB,YAAY,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAEtF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,iBAAiB,GACzB,CAAC,WAAW,EAAE,WAAW,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAEzD"}

package/dist/on-render-html.js

@@ -30,10 +30,16 @@ export async function onRenderHtml(pageContext) {
 /**
  * Factory to create a customized onRenderHtml hook.
  *
+ * **Do not name your layout file `+Layout.ts`.** Vike reserves `+Layout`
+ * for its own framework-adapter config (`vike-react` / `vike-vue` /
+ * `vike-solid`) and will conflict with `@llui/vike`'s `Layout` option.
+ * Name the file `Layout.ts`, `app-layout.ts`, or anywhere outside
+ * `/pages` that Vike won't scan, and import it here by path.
+ *
  * ```ts
  * // pages/+onRenderHtml.ts
  * import { createOnRenderHtml } from '@llui/vike/server'
- * import { AppLayout } from './+Layout'
+ * import { AppLayout } from './Layout' // ← NOT './+Layout'
  *
  * export const onRenderHtml = createOnRenderHtml({
  *   Layout: AppLayout,
@@ -99,6 +105,9 @@ function renderChain(chain, chainData) {
         // its data slice, same as client-side mountApp(). renderNodes takes
         // the state post-init so that the view sees the right fields.
         const [initialState] = def.init(layerData);
+        // Cross from type-erased AnyComponentDef into the concrete signature
+        // renderNodes expects. Same pattern as the client mount path —
+        // renderNodes is generic but the runtime doesn't use the type params.
         const { nodes, inst } = renderNodes(def, initialState, currentSlotScope);
         allBindings.push(...inst.allBindings);
         if (i === 0) {

package/dist/on-render-html.js.map

@@ -1 +1 @@
-{"version":3,"file":"on-render-html.js","sourceRoot":"","sources":["../src/on-render-html.ts"],"names":[],"mappings":"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","sourcesContent":["import { renderNodes, serializeNodes } from '@llui/dom'\nimport type { ComponentDef, Binding, Scope } from '@llui/dom'\nimport { _consumePendingSlot, _resetPendingSlot } from './page-slot.js'\n\ntype AnyComponentDef = ComponentDef<unknown, unknown, unknown, unknown>\ntype LayoutChain = ReadonlyArray<AnyComponentDef>\n\n/**\n * Page context shape as seen by `@llui/vike`'s server hook. `Page` and\n * `data` are whichever `+Page.ts` and `+data.ts` Vike resolved for the\n * current route; `lluiLayoutData` is an optional array of per-layer\n * layout data matching the chain configured on `createOnRenderHtml`.\n */\nexport interface PageContext {\n  Page: AnyComponentDef\n  data?: unknown\n  lluiLayoutData?: readonly unknown[]\n  head?: string\n}\n\nexport interface DocumentContext {\n  /** Rendered component HTML (layout + page composed if a Layout is configured) */\n  html: string\n  /** JSON-serialized hydration envelope (chain-aware when Layout is configured) */\n  state: string\n  /** Head content from pageContext.head (e.g. from +Head.ts) */\n  head: string\n  /** Full page context for custom logic */\n  pageContext: PageContext\n}\n\nexport interface RenderHtmlResult {\n  documentHtml: string | { _escaped: string }\n  pageContext: { lluiState: unknown }\n}\n\nconst DEFAULT_DOCUMENT = ({ html, state, head }: DocumentContext): string => `<!DOCTYPE html>\n<html>\n  <head>\n    <meta charset=\"utf-8\" />\n    ${head}\n  </head>\n  <body>\n    <div id=\"app\">${html}</div>\n    <script>window.__LLUI_STATE__ = ${state}</script>\n  </body>\n</html>`\n\n/**\n * Options for the customized `createOnRenderHtml` factory. Mirrors\n * `@llui/vike/client`'s `RenderClientOptions.Layout` — the same chain\n * shape is accepted for consistency between server and client render.\n */\nexport interface RenderHtmlOptions {\n  /** Custom HTML document template. Defaults to a minimal layout. */\n  document?: (ctx: DocumentContext) => string\n\n  /**\n   * Persistent layout chain. One of:\n   *\n   * - A single `ComponentDef` — becomes a one-layout chain.\n   * - An array of `ComponentDef`s — outermost first, innermost last.\n   *   Every layer except the innermost must call `pageSlot()` in its view.\n   * - A function that returns a chain from the current `pageContext` —\n   *   enables per-route chains (e.g. reading Vike's `urlPathname`).\n   *\n   * The server renders the full chain as one composed HTML tree. Client\n   * hydration reads the matching envelope and reconstructs the chain\n   * layer-by-layer.\n   */\n  Layout?: AnyComponentDef | LayoutChain | ((pageContext: PageContext) => LayoutChain)\n}\n\nfunction resolveLayoutChain(\n  layoutOption: RenderHtmlOptions['Layout'],\n  pageContext: PageContext,\n): LayoutChain {\n  if (!layoutOption) return []\n  if (typeof layoutOption === 'function') {\n    return layoutOption(pageContext) ?? []\n  }\n  if (Array.isArray(layoutOption)) return layoutOption\n  return [layoutOption as AnyComponentDef]\n}\n\n/**\n * Default onRenderHtml hook — no layout, minimal document template.\n */\nexport async function onRenderHtml(pageContext: PageContext): Promise<RenderHtmlResult> {\n  return renderPage(pageContext, {})\n}\n\n/**\n * Factory to create a customized onRenderHtml hook.\n *\n * ```ts\n * // pages/+onRenderHtml.ts\n * import { createOnRenderHtml } from '@llui/vike/server'\n * import { AppLayout } from './+Layout'\n *\n * export const onRenderHtml = createOnRenderHtml({\n *   Layout: AppLayout,\n *   document: ({ html, state, head }) => `<!DOCTYPE html>\n *     <html><head>${head}<link rel=\"stylesheet\" href=\"/styles.css\" /></head>\n *     <body><div id=\"app\">${html}</div>\n *     <script>window.__LLUI_STATE__ = ${state}</script></body></html>`,\n * })\n * ```\n */\nexport function createOnRenderHtml(\n  options: RenderHtmlOptions,\n): (pageContext: PageContext) => Promise<RenderHtmlResult> {\n  return (pageContext) => renderPage(pageContext, options)\n}\n\n/**\n * Hydration envelope emitted into `window.__LLUI_STATE__`. Chain-aware\n * by default — every layer (layouts + page) is represented by its own\n * entry, keyed by component name so server/client mismatches fail loud.\n */\ninterface HydrationEnvelope {\n  layouts: Array<{ name: string; state: unknown }>\n  page: { name: string; state: unknown }\n}\n\nasync function renderPage(\n  pageContext: PageContext,\n  options: RenderHtmlOptions,\n): Promise<RenderHtmlResult> {\n  // Lazy-import to keep jsdom out of the client bundle's dependency graph\n  const { initSsrDom } = await import('@llui/dom/ssr')\n  await initSsrDom()\n\n  const layoutChain = resolveLayoutChain(options.Layout, pageContext)\n  const layoutData = pageContext.lluiLayoutData ?? []\n\n  // Full chain: every layout, then the page. Always at least one entry\n  // (the page) since Vike's pageContext always has a Page.\n  const chain: LayoutChain = [...layoutChain, pageContext.Page]\n  const chainData: readonly unknown[] = [...layoutData, pageContext.data]\n\n  const { html, envelope } = renderChain(chain, chainData)\n\n  const document = options.document ?? DEFAULT_DOCUMENT\n  const head = pageContext.head ?? ''\n  const state = JSON.stringify(envelope)\n  const documentHtml = document({ html, state, head, pageContext })\n\n  return {\n    // Vike's dangerouslySkipEscape format — the document template is\n    // trusted (authored by the developer, not user input)\n    documentHtml: { _escaped: documentHtml },\n    pageContext: { lluiState: envelope },\n  }\n}\n\n/**\n * Render every layer of the chain into one composed DOM tree, then\n * serialize. At each non-innermost layer, consume the pending\n * `pageSlot()` registration and append the next layer's nodes into\n * the slot marker. Scopes are threaded so inner layers inherit the\n * outer layer's scope tree for context lookups.\n */\nfunction renderChain(\n  chain: LayoutChain,\n  chainData: readonly unknown[],\n): { html: string; envelope: HydrationEnvelope } {\n  if (chain.length === 0) {\n    throw new Error('[llui/vike] renderChain called with empty chain')\n  }\n\n  // Defensive: ensure no stale slot leaks in from a prior failed render.\n  _resetPendingSlot()\n\n  // Accumulate bindings from every layer — serializeNodes needs the\n  // full set so hydrate markers are correctly placed across the\n  // composed tree.\n  const allBindings: Binding[] = []\n  const envelopeLayouts: HydrationEnvelope['layouts'] = []\n  let envelopePage: HydrationEnvelope['page'] | null = null\n\n  let outermostNodes: Node[] = []\n  let currentSlotMarker: HTMLElement | null = null\n  let currentSlotScope: Scope | undefined = undefined\n\n  for (let i = 0; i < chain.length; i++) {\n    const def = chain[i]!\n    const layerData = chainData[i]\n    const isInnermost = i === chain.length - 1\n\n    // Resolve the initial state from the layer's own init() applied to\n    // its data slice, same as client-side mountApp(). renderNodes takes\n    // the state post-init so that the view sees the right fields.\n    const [initialState] = def.init(layerData)\n\n    const { nodes, inst } = renderNodes(def, initialState, currentSlotScope)\n    allBindings.push(...inst.allBindings)\n\n    if (i === 0) {\n      outermostNodes = nodes\n    } else {\n      // Append this layer's nodes into the previous layer's slot marker.\n      // The slot marker is an element owned by the previous layer's DOM;\n      // appending here stitches this layer into the composed tree so\n      // the final serialization pass emits one integrated HTML string.\n      if (!currentSlotMarker) {\n        // Unreachable given the error checks below, but defensive.\n        throw new Error(`[llui/vike] internal: chain layer ${i} (<${def.name}>) has no slot marker`)\n      }\n      for (const node of nodes) {\n        currentSlotMarker.appendChild(node)\n      }\n    }\n\n    // Record this layer's state in the envelope. Page goes under\n    // `page`, everything else under `layouts[]` ordered outer-to-inner.\n    if (isInnermost) {\n      envelopePage = { name: def.name, state: initialState }\n    } else {\n      envelopeLayouts.push({ name: def.name, state: initialState })\n    }\n\n    // Consume this layer's pending slot registration (if any). Every\n    // non-innermost layer MUST declare a slot; the innermost MUST NOT.\n    const slot = _consumePendingSlot()\n    if (isInnermost && slot !== null) {\n      throw new Error(\n        `[llui/vike] <${def.name}> is the innermost component in the chain ` +\n          `but called pageSlot(). pageSlot() only belongs in layout components.`,\n      )\n    }\n    if (!isInnermost && slot === null) {\n      throw new Error(\n        `[llui/vike] <${def.name}> is a layout layer at depth ${i} but did not ` +\n          `call pageSlot() in its view(). There are ${chain.length - i - 1} more ` +\n          `layer(s) to mount and no slot to mount them into.`,\n      )\n    }\n\n    currentSlotMarker = slot?.marker ?? null\n    currentSlotScope = slot?.slotScope\n  }\n\n  const html = serializeNodes(outermostNodes, allBindings)\n\n  if (envelopePage === null) {\n    // Unreachable — chain is non-empty so the last iteration sets this.\n    throw new Error('[llui/vike] internal: renderChain produced no page entry')\n  }\n\n  return {\n    html,\n    envelope: {\n      layouts: envelopeLayouts,\n      page: envelopePage,\n    },\n  }\n}\n"]}
+{"version":3,"file":"on-render-html.js","sourceRoot":"","sources":["../src/on-render-html.ts"],"names":[],"mappings":"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","sourcesContent":["import { renderNodes, serializeNodes } from '@llui/dom'\nimport type { AnyComponentDef, Binding, Scope } from '@llui/dom'\nimport { _consumePendingSlot, _resetPendingSlot } from './page-slot.js'\n\ntype LayoutChain = ReadonlyArray<AnyComponentDef>\n\n/**\n * Page context shape as seen by `@llui/vike`'s server hook. `Page` and\n * `data` are whichever `+Page.ts` and `+data.ts` Vike resolved for the\n * current route; `lluiLayoutData` is an optional array of per-layer\n * layout data matching the chain configured on `createOnRenderHtml`.\n */\nexport interface PageContext {\n  Page: AnyComponentDef\n  data?: unknown\n  lluiLayoutData?: readonly unknown[]\n  head?: string\n}\n\nexport interface DocumentContext {\n  /** Rendered component HTML (layout + page composed if a Layout is configured) */\n  html: string\n  /** JSON-serialized hydration envelope (chain-aware when Layout is configured) */\n  state: string\n  /** Head content from pageContext.head (e.g. from +Head.ts) */\n  head: string\n  /** Full page context for custom logic */\n  pageContext: PageContext\n}\n\nexport interface RenderHtmlResult {\n  documentHtml: string | { _escaped: string }\n  pageContext: { lluiState: unknown }\n}\n\nconst DEFAULT_DOCUMENT = ({ html, state, head }: DocumentContext): string => `<!DOCTYPE html>\n<html>\n  <head>\n    <meta charset=\"utf-8\" />\n    ${head}\n  </head>\n  <body>\n    <div id=\"app\">${html}</div>\n    <script>window.__LLUI_STATE__ = ${state}</script>\n  </body>\n</html>`\n\n/**\n * Options for the customized `createOnRenderHtml` factory. Mirrors\n * `@llui/vike/client`'s `RenderClientOptions.Layout` — the same chain\n * shape is accepted for consistency between server and client render.\n */\nexport interface RenderHtmlOptions {\n  /** Custom HTML document template. Defaults to a minimal layout. */\n  document?: (ctx: DocumentContext) => string\n\n  /**\n   * Persistent layout chain. One of:\n   *\n   * - A single `ComponentDef` — becomes a one-layout chain.\n   * - An array of `ComponentDef`s — outermost first, innermost last.\n   *   Every layer except the innermost must call `pageSlot()` in its view.\n   * - A function that returns a chain from the current `pageContext` —\n   *   enables per-route chains (e.g. reading Vike's `urlPathname`).\n   *\n   * The server renders the full chain as one composed HTML tree. Client\n   * hydration reads the matching envelope and reconstructs the chain\n   * layer-by-layer.\n   */\n  Layout?: AnyComponentDef | LayoutChain | ((pageContext: PageContext) => LayoutChain)\n}\n\nfunction resolveLayoutChain(\n  layoutOption: RenderHtmlOptions['Layout'],\n  pageContext: PageContext,\n): LayoutChain {\n  if (!layoutOption) return []\n  if (typeof layoutOption === 'function') {\n    return layoutOption(pageContext) ?? []\n  }\n  if (Array.isArray(layoutOption)) return layoutOption\n  return [layoutOption as AnyComponentDef]\n}\n\n/**\n * Default onRenderHtml hook — no layout, minimal document template.\n */\nexport async function onRenderHtml(pageContext: PageContext): Promise<RenderHtmlResult> {\n  return renderPage(pageContext, {})\n}\n\n/**\n * Factory to create a customized onRenderHtml hook.\n *\n * **Do not name your layout file `+Layout.ts`.** Vike reserves `+Layout`\n * for its own framework-adapter config (`vike-react` / `vike-vue` /\n * `vike-solid`) and will conflict with `@llui/vike`'s `Layout` option.\n * Name the file `Layout.ts`, `app-layout.ts`, or anywhere outside\n * `/pages` that Vike won't scan, and import it here by path.\n *\n * ```ts\n * // pages/+onRenderHtml.ts\n * import { createOnRenderHtml } from '@llui/vike/server'\n * import { AppLayout } from './Layout' // ← NOT './+Layout'\n *\n * export const onRenderHtml = createOnRenderHtml({\n *   Layout: AppLayout,\n *   document: ({ html, state, head }) => `<!DOCTYPE html>\n *     <html><head>${head}<link rel=\"stylesheet\" href=\"/styles.css\" /></head>\n *     <body><div id=\"app\">${html}</div>\n *     <script>window.__LLUI_STATE__ = ${state}</script></body></html>`,\n * })\n * ```\n */\nexport function createOnRenderHtml(\n  options: RenderHtmlOptions,\n): (pageContext: PageContext) => Promise<RenderHtmlResult> {\n  return (pageContext) => renderPage(pageContext, options)\n}\n\n/**\n * Hydration envelope emitted into `window.__LLUI_STATE__`. Chain-aware\n * by default — every layer (layouts + page) is represented by its own\n * entry, keyed by component name so server/client mismatches fail loud.\n */\ninterface HydrationEnvelope {\n  layouts: Array<{ name: string; state: unknown }>\n  page: { name: string; state: unknown }\n}\n\nasync function renderPage(\n  pageContext: PageContext,\n  options: RenderHtmlOptions,\n): Promise<RenderHtmlResult> {\n  // Lazy-import to keep jsdom out of the client bundle's dependency graph\n  const { initSsrDom } = await import('@llui/dom/ssr')\n  await initSsrDom()\n\n  const layoutChain = resolveLayoutChain(options.Layout, pageContext)\n  const layoutData = pageContext.lluiLayoutData ?? []\n\n  // Full chain: every layout, then the page. Always at least one entry\n  // (the page) since Vike's pageContext always has a Page.\n  const chain: LayoutChain = [...layoutChain, pageContext.Page]\n  const chainData: readonly unknown[] = [...layoutData, pageContext.data]\n\n  const { html, envelope } = renderChain(chain, chainData)\n\n  const document = options.document ?? DEFAULT_DOCUMENT\n  const head = pageContext.head ?? ''\n  const state = JSON.stringify(envelope)\n  const documentHtml = document({ html, state, head, pageContext })\n\n  return {\n    // Vike's dangerouslySkipEscape format — the document template is\n    // trusted (authored by the developer, not user input)\n    documentHtml: { _escaped: documentHtml },\n    pageContext: { lluiState: envelope },\n  }\n}\n\n/**\n * Render every layer of the chain into one composed DOM tree, then\n * serialize. At each non-innermost layer, consume the pending\n * `pageSlot()` registration and append the next layer's nodes into\n * the slot marker. Scopes are threaded so inner layers inherit the\n * outer layer's scope tree for context lookups.\n */\nfunction renderChain(\n  chain: LayoutChain,\n  chainData: readonly unknown[],\n): { html: string; envelope: HydrationEnvelope } {\n  if (chain.length === 0) {\n    throw new Error('[llui/vike] renderChain called with empty chain')\n  }\n\n  // Defensive: ensure no stale slot leaks in from a prior failed render.\n  _resetPendingSlot()\n\n  // Accumulate bindings from every layer — serializeNodes needs the\n  // full set so hydrate markers are correctly placed across the\n  // composed tree.\n  const allBindings: Binding[] = []\n  const envelopeLayouts: HydrationEnvelope['layouts'] = []\n  let envelopePage: HydrationEnvelope['page'] | null = null\n\n  let outermostNodes: Node[] = []\n  let currentSlotMarker: HTMLElement | null = null\n  let currentSlotScope: Scope | undefined = undefined\n\n  for (let i = 0; i < chain.length; i++) {\n    const def = chain[i]!\n    const layerData = chainData[i]\n    const isInnermost = i === chain.length - 1\n\n    // Resolve the initial state from the layer's own init() applied to\n    // its data slice, same as client-side mountApp(). renderNodes takes\n    // the state post-init so that the view sees the right fields.\n    const [initialState] = def.init(layerData)\n\n    // Cross from type-erased AnyComponentDef into the concrete signature\n    // renderNodes expects. Same pattern as the client mount path —\n    // renderNodes is generic but the runtime doesn't use the type params.\n    const { nodes, inst } = renderNodes(\n      def as unknown as Parameters<typeof renderNodes>[0],\n      initialState,\n      currentSlotScope,\n    )\n    allBindings.push(...inst.allBindings)\n\n    if (i === 0) {\n      outermostNodes = nodes\n    } else {\n      // Append this layer's nodes into the previous layer's slot marker.\n      // The slot marker is an element owned by the previous layer's DOM;\n      // appending here stitches this layer into the composed tree so\n      // the final serialization pass emits one integrated HTML string.\n      if (!currentSlotMarker) {\n        // Unreachable given the error checks below, but defensive.\n        throw new Error(`[llui/vike] internal: chain layer ${i} (<${def.name}>) has no slot marker`)\n      }\n      for (const node of nodes) {\n        currentSlotMarker.appendChild(node)\n      }\n    }\n\n    // Record this layer's state in the envelope. Page goes under\n    // `page`, everything else under `layouts[]` ordered outer-to-inner.\n    if (isInnermost) {\n      envelopePage = { name: def.name, state: initialState }\n    } else {\n      envelopeLayouts.push({ name: def.name, state: initialState })\n    }\n\n    // Consume this layer's pending slot registration (if any). Every\n    // non-innermost layer MUST declare a slot; the innermost MUST NOT.\n    const slot = _consumePendingSlot()\n    if (isInnermost && slot !== null) {\n      throw new Error(\n        `[llui/vike] <${def.name}> is the innermost component in the chain ` +\n          `but called pageSlot(). pageSlot() only belongs in layout components.`,\n      )\n    }\n    if (!isInnermost && slot === null) {\n      throw new Error(\n        `[llui/vike] <${def.name}> is a layout layer at depth ${i} but did not ` +\n          `call pageSlot() in its view(). There are ${chain.length - i - 1} more ` +\n          `layer(s) to mount and no slot to mount them into.`,\n      )\n    }\n\n    currentSlotMarker = slot?.marker ?? null\n    currentSlotScope = slot?.slotScope\n  }\n\n  const html = serializeNodes(outermostNodes, allBindings)\n\n  if (envelopePage === null) {\n    // Unreachable — chain is non-empty so the last iteration sets this.\n    throw new Error('[llui/vike] internal: renderChain produced no page entry')\n  }\n\n  return {\n    html,\n    envelope: {\n      layouts: envelopeLayouts,\n      page: envelopePage,\n    },\n  }\n}\n"]}

package/dist/page-slot.d.ts

@@ -23,8 +23,12 @@ interface PendingSlot {
  * the page does `useContext(ToastContext)` and walks up through the
  * slot into the layout's providers.
  *
+ * Do NOT name the file `+Layout.ts` — Vike reserves the `+` prefix for
+ * its own framework config conventions. Use `Layout.ts`, `app-layout.ts`,
+ * or anywhere outside `/pages` that Vike won't scan.
+ *
  * ```ts
- * // pages/+Layout.ts
+ * // pages/Layout.ts    ← not +Layout.ts
  * import { component, div, main, header } from '@llui/dom'
  * import { pageSlot } from '@llui/vike/client'
  *

package/dist/page-slot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"page-slot.d.ts","sourceRoot":"","sources":["../src/page-slot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAQtC;;;;;;GAMG;AACH,UAAU,WAAW;IACnB,SAAS,EAAE,KAAK,CAAA;IAChB,MAAM,EAAE,WAAW,CAAA;CACpB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,QAAQ,IAAI,IAAI,EAAE,CAuBjC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,GAAG,IAAI,CAIxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"page-slot.d.ts","sourceRoot":"","sources":["../src/page-slot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAQtC;;;;;;GAMG;AACH,UAAU,WAAW;IACnB,SAAS,EAAE,KAAK,CAAA;IAChB,MAAM,EAAE,WAAW,CAAA;CACpB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,QAAQ,IAAI,IAAI,EAAE,CAuBjC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,GAAG,IAAI,CAIxD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/dist/page-slot.js

@@ -13,8 +13,12 @@ let pendingSlot = null;
  * the page does `useContext(ToastContext)` and walks up through the
  * slot into the layout's providers.
  *
+ * Do NOT name the file `+Layout.ts` — Vike reserves the `+` prefix for
+ * its own framework config conventions. Use `Layout.ts`, `app-layout.ts`,
+ * or anywhere outside `/pages` that Vike won't scan.
+ *
  * ```ts
- * // pages/+Layout.ts
+ * // pages/Layout.ts    ← not +Layout.ts
  * import { component, div, main, header } from '@llui/dom'
  * import { pageSlot } from '@llui/vike/client'
  *

package/dist/page-slot.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-slot.js","sourceRoot":"","sources":["../src/page-slot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAmBlE,IAAI,WAAW,GAAuB,IAAI,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,UAAU,QAAQ;IACtB,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,mEAAmE;QACnE,yDAAyD;QACzD,MAAM,IAAI,KAAK,CACb,2DAA2D;YACzD,8EAA8E,CACjF,CAAA;IACH,CAAC;IACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,uEAAuE;YACrE,6EAA6E;YAC7E,2EAA2E;YAC3E,oEAAoE,CACvE,CAAA;IACH,CAAC;IACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAA;IACxC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IAC5C,MAAM,CAAC,OAAO,CAAC,YAAY,GAAG,EAAE,CAAA;IAChC,WAAW,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;IACnC,OAAO,CAAC,MAAM,CAAC,CAAA;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,IAAI,GAAG,WAAW,CAAA;IACxB,WAAW,GAAG,IAAI,CAAA;IAClB,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,WAAW,GAAG,IAAI,CAAA;AACpB,CAAC","sourcesContent":["import type { Scope } from '@llui/dom'\nimport { getRenderContext, createScope } from '@llui/dom/internal'\n\n// @llui/dom/internal is the adapter-layer surface: low-level primitives\n// (render-context access, scope creation, disposer registration) that\n// framework adapters like @llui/vike need to build structural primitives\n// on top of. Not part of the public app-author API.\n\n/**\n * Transient handoff between a layout layer's render pass and the vike\n * adapter that's mounting the chain. `pageSlot()` populates this during\n * the layout's view() call; `consumePendingSlot()` reads and clears it\n * immediately after the mount returns. One slot per mount pass — calling\n * `pageSlot()` twice in the same layout is a bug the primitive reports.\n */\ninterface PendingSlot {\n  slotScope: Scope\n  marker: HTMLElement\n}\n\nlet pendingSlot: PendingSlot | null = null\n\n/**\n * Declare where a persistent layout renders its nested content — either\n * a nested layout or the route's page component. The vike adapter's\n * client and server render paths walk the layout chain, and each layer's\n * `pageSlot()` call records the position where the next layer mounts.\n *\n * The slot is a real scope-tree node: the scope it creates is a child\n * of the current render scope, so contexts provided by the layout (via\n * `provide()`) above the slot are reachable from inside the nested\n * page. That's how patterns like a layout-owned toast dispatcher work —\n * the page does `useContext(ToastContext)` and walks up through the\n * slot into the layout's providers.\n *\n * ```ts\n * // pages/+Layout.ts\n * import { component, div, main, header } from '@llui/dom'\n * import { pageSlot } from '@llui/vike/client'\n *\n * export const AppLayout = component<LayoutState, LayoutMsg>({\n *   name: 'AppLayout',\n *   init: () => [{  ...  }, []],\n *   update: layoutUpdate,\n *   view: (h) => [\n *     div({ class: 'app-shell' }, [\n *       header([... persistent chrome ...]),\n *       main([pageSlot()]),    // ← here the page goes\n *     ]),\n *   ],\n * })\n * ```\n *\n * Call exactly once per layout. Calling more than once in a single\n * view throws — a layout with two slots would be ambiguous about which\n * one receives the nested content.\n */\nexport function pageSlot(): Node[] {\n  if (typeof document === 'undefined') {\n    // Server path — @llui/dom's renderToString uses jsdom, so document\n    // IS defined during SSR, but we guard anyway for safety.\n    throw new Error(\n      '[llui/vike] pageSlot() called without a DOM environment. ' +\n        'Call from inside a component view() that runs during mount, hydrate, or SSR.',\n    )\n  }\n  if (pendingSlot !== null) {\n    throw new Error(\n      '[llui/vike] pageSlot() was called more than once in the same layout. ' +\n        'A layout has exactly one nested-content slot — if you need two independent ' +\n        'regions that swap on navigation, build them as sibling nested layouts in ' +\n        'the Vike routing tree and use context to share state between them.',\n    )\n  }\n  const ctx = getRenderContext('pageSlot')\n  const slotScope = createScope(ctx.rootScope)\n  const marker = document.createElement('div')\n  marker.dataset.lluiPageSlot = ''\n  pendingSlot = { slotScope, marker }\n  return [marker]\n}\n\n/**\n * @internal — vike adapter only. Read and clear the slot registered by\n * the most recent `pageSlot()` call. Returns null if the layer being\n * mounted didn't call `pageSlot()` (meaning it's the innermost layer\n * and owns no nested content).\n */\nexport function _consumePendingSlot(): PendingSlot | null {\n  const slot = pendingSlot\n  pendingSlot = null\n  return slot\n}\n\n/**\n * @internal — vike adapter only. Reset the pending slot without reading\n * it. Used defensively in error paths to avoid leaking a pending slot\n * registration into a subsequent mount attempt.\n */\nexport function _resetPendingSlot(): void {\n  pendingSlot = null\n}\n"]}
+{"version":3,"file":"page-slot.js","sourceRoot":"","sources":["../src/page-slot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAmBlE,IAAI,WAAW,GAAuB,IAAI,CAAA;AAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,QAAQ;IACtB,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACpC,mEAAmE;QACnE,yDAAyD;QACzD,MAAM,IAAI,KAAK,CACb,2DAA2D;YACzD,8EAA8E,CACjF,CAAA;IACH,CAAC;IACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,uEAAuE;YACrE,6EAA6E;YAC7E,2EAA2E;YAC3E,oEAAoE,CACvE,CAAA;IACH,CAAC;IACD,MAAM,GAAG,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAA;IACxC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,CAAA;IAC5C,MAAM,CAAC,OAAO,CAAC,YAAY,GAAG,EAAE,CAAA;IAChC,WAAW,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,CAAA;IACnC,OAAO,CAAC,MAAM,CAAC,CAAA;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,IAAI,GAAG,WAAW,CAAA;IACxB,WAAW,GAAG,IAAI,CAAA;IAClB,OAAO,IAAI,CAAA;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,WAAW,GAAG,IAAI,CAAA;AACpB,CAAC","sourcesContent":["import type { Scope } from '@llui/dom'\nimport { getRenderContext, createScope } from '@llui/dom/internal'\n\n// @llui/dom/internal is the adapter-layer surface: low-level primitives\n// (render-context access, scope creation, disposer registration) that\n// framework adapters like @llui/vike need to build structural primitives\n// on top of. Not part of the public app-author API.\n\n/**\n * Transient handoff between a layout layer's render pass and the vike\n * adapter that's mounting the chain. `pageSlot()` populates this during\n * the layout's view() call; `consumePendingSlot()` reads and clears it\n * immediately after the mount returns. One slot per mount pass — calling\n * `pageSlot()` twice in the same layout is a bug the primitive reports.\n */\ninterface PendingSlot {\n  slotScope: Scope\n  marker: HTMLElement\n}\n\nlet pendingSlot: PendingSlot | null = null\n\n/**\n * Declare where a persistent layout renders its nested content — either\n * a nested layout or the route's page component. The vike adapter's\n * client and server render paths walk the layout chain, and each layer's\n * `pageSlot()` call records the position where the next layer mounts.\n *\n * The slot is a real scope-tree node: the scope it creates is a child\n * of the current render scope, so contexts provided by the layout (via\n * `provide()`) above the slot are reachable from inside the nested\n * page. That's how patterns like a layout-owned toast dispatcher work —\n * the page does `useContext(ToastContext)` and walks up through the\n * slot into the layout's providers.\n *\n * Do NOT name the file `+Layout.ts` — Vike reserves the `+` prefix for\n * its own framework config conventions. Use `Layout.ts`, `app-layout.ts`,\n * or anywhere outside `/pages` that Vike won't scan.\n *\n * ```ts\n * // pages/Layout.ts    ← not +Layout.ts\n * import { component, div, main, header } from '@llui/dom'\n * import { pageSlot } from '@llui/vike/client'\n *\n * export const AppLayout = component<LayoutState, LayoutMsg>({\n *   name: 'AppLayout',\n *   init: () => [{  ...  }, []],\n *   update: layoutUpdate,\n *   view: (h) => [\n *     div({ class: 'app-shell' }, [\n *       header([... persistent chrome ...]),\n *       main([pageSlot()]),    // ← here the page goes\n *     ]),\n *   ],\n * })\n * ```\n *\n * Call exactly once per layout. Calling more than once in a single\n * view throws — a layout with two slots would be ambiguous about which\n * one receives the nested content.\n */\nexport function pageSlot(): Node[] {\n  if (typeof document === 'undefined') {\n    // Server path — @llui/dom's renderToString uses jsdom, so document\n    // IS defined during SSR, but we guard anyway for safety.\n    throw new Error(\n      '[llui/vike] pageSlot() called without a DOM environment. ' +\n        'Call from inside a component view() that runs during mount, hydrate, or SSR.',\n    )\n  }\n  if (pendingSlot !== null) {\n    throw new Error(\n      '[llui/vike] pageSlot() was called more than once in the same layout. ' +\n        'A layout has exactly one nested-content slot — if you need two independent ' +\n        'regions that swap on navigation, build them as sibling nested layouts in ' +\n        'the Vike routing tree and use context to share state between them.',\n    )\n  }\n  const ctx = getRenderContext('pageSlot')\n  const slotScope = createScope(ctx.rootScope)\n  const marker = document.createElement('div')\n  marker.dataset.lluiPageSlot = ''\n  pendingSlot = { slotScope, marker }\n  return [marker]\n}\n\n/**\n * @internal — vike adapter only. Read and clear the slot registered by\n * the most recent `pageSlot()` call. Returns null if the layer being\n * mounted didn't call `pageSlot()` (meaning it's the innermost layer\n * and owns no nested content).\n */\nexport function _consumePendingSlot(): PendingSlot | null {\n  const slot = pendingSlot\n  pendingSlot = null\n  return slot\n}\n\n/**\n * @internal — vike adapter only. Reset the pending slot without reading\n * it. Used defensively in error paths to avoid leaking a pending slot\n * registration into a subsequent mount attempt.\n */\nexport function _resetPendingSlot(): void {\n  pendingSlot = null\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llui/vike",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "type": "module",
   "sideEffects": false,
   "exports": {
@@ -22,7 +22,7 @@
   ],
   "dependencies": {
     "jsdom": "^26.1.0",
-    "@llui/dom": "0.0.16"
+    "@llui/dom": "0.0.18"
   },
   "description": "LLui Vike SSR adapter — onRenderHtml, onRenderClient hooks",
   "keywords": [