@takazudo/zfb-runtime 0.1.0-next.76 → 0.1.0-next.78

package/dist/client-router/swap-functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"swap-functions.js","sourceRoot":"","sources":["../../src/client-router/swap-functions.ts"],"names":[],"mappings":"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","sourcesContent":["/// <reference lib=\"dom\" />\n/// <reference lib=\"dom.iterable\" />\n// Ported verbatim from Astro transitions/swap-functions.ts. Mechanical renames\n// applied per W1B §13.4 (data-astro-* → data-zfb-*, dataset.astro* → dataset.zfb*,\n// astro-island element-name branch → data-zfb-island marker per W1B §12.3 island-lifecycle\n// contract). vueScopedStyleId is intentionally KEPT verbatim per W2A §2.8 (the W3B\n// issue body's \"DELETE\" instruction is overridden by W2A's reclassification).\n\nexport type SavedFocus = {\n  activeElement: HTMLElement | null;\n  start?: number | null;\n  end?: number | null;\n};\n\nconst PERSIST_ATTR = \"data-zfb-transition-persist\";\n\nconst NON_OVERRIDABLE_ZFB_ATTRS = [\"data-zfb-transition\", \"data-zfb-transition-fallback\"];\n\n// Consumers extend the preserve-set via <meta name=\"zfb-preserve-html-attrs\"\n// content=\"data-theme data-sidebar-hidden …\">, emitted by\n// <ClientRouter preserveHtmlAttrs={[…]} />. Without it, a runtime <html>\n// attribute set from a persisted island is wiped on every swap. See\n// client-router/port-spec.md deviation #11 and Takazudo/zudo-front-builder#1103.\nconst PRESERVE_ATTRS_META_NAME = \"zfb-preserve-html-attrs\";\n\nconst knownVueScopedStyles = new Map<string, HTMLStyleElement>();\n\nconst scriptsAlreadyRan = new Set<string>();\nexport function detectScriptExecuted(script: HTMLScriptElement) {\n  const key = script.src ? new URL(script.src, location.href).href : script.textContent!;\n  if (scriptsAlreadyRan.has(key)) return true;\n  scriptsAlreadyRan.add(key);\n  return false;\n}\n\n/*\n * \tMark new scripts that should not execute\n */\nexport function deselectScripts(doc: Document) {\n  for (const s2 of doc.scripts) {\n    if (\n      // Check if the script should be rerun regardless of it being the same\n      !s2.hasAttribute(\"data-zfb-rerun\") &&\n      // Check if the script has already been executed\n      detectScriptExecuted(s2)\n    ) {\n      // the old script is in the new document and doesn't have the rerun attribute\n      // we mark it as executed to prevent re-execution\n      s2.dataset[\"zfbExec\"] = \"\";\n    }\n  }\n}\n\n/*\n * Read the consumer-configured preserve-list from the live document's\n * <meta name=\"zfb-preserve-html-attrs\"> tag. The list is a site-wide, static\n * contract (the tag is rendered on every page, so it is present on both the\n * current and incoming documents); reading the live document is sufficient.\n * Returns [] when the tag is absent.\n */\nfunction consumerPreservedAttrs(): string[] {\n  const content = document\n    .querySelector(`meta[name=\"${PRESERVE_ATTRS_META_NAME}\"]`)\n    ?.getAttribute(\"content\");\n  // Attribute names are ASCII-case-insensitive and the DOM exposes them\n  // lowercased, so normalize the list to match (NON_OVERRIDABLE_ZFB_ATTRS is\n  // already lowercase). Without this, a mixed-case entry would silently never\n  // match the live attribute name.\n  return content ? content.toLowerCase().split(/\\s+/).filter(Boolean) : [];\n}\n\n/*\n * swap attributes of the html element\n * delete all attributes from the current document\n * insert all attributes from doc\n * reinsert all original attributes whose name is in the preserve-set:\n * NON_OVERRIDABLE_ZFB_ATTRS (transition-internal) ∪ the consumer preserve-list.\n * Preserved attributes are re-applied last, so a runtime value on the current\n * root wins over the incoming document's default (e.g. a localStorage-driven\n * data-theme). See client-router/port-spec.md deviation #11 / #1103.\n */\nexport function swapRootAttributes(newDoc: Document) {\n  const currentRoot = document.documentElement;\n  const preserve = new Set([...NON_OVERRIDABLE_ZFB_ATTRS, ...consumerPreservedAttrs()]);\n  const preservedAttributes = [...currentRoot.attributes].filter(\n    ({ name }) => (currentRoot.removeAttribute(name), preserve.has(name)),\n  );\n  [...newDoc.documentElement.attributes, ...preservedAttributes].forEach(({ name, value }) =>\n    currentRoot.setAttribute(name, value),\n  );\n}\n\n/*\n * make the old head look like the new one\n */\nexport function swapHeadElements(doc: Document) {\n  for (const el of Array.from(document.head.children)) {\n    const newEl = persistedHeadElement(el as HTMLElement, doc);\n    // If the element exists in the document already, remove it\n    // from the new document and leave the current node alone\n    if (newEl) {\n      newEl.remove();\n    } else {\n      if ((import.meta as any).env?.DEV && el instanceof HTMLStyleElement) {\n        // In DEV mode, keep updated Vue scoped styles for later reuse\n        const viteDevId = vueScopedStyleId(el);\n        viteDevId && knownVueScopedStyles.set(viteDevId, el);\n      }\n      // If the element does not exist in the new document, remove the element from current the head.\n      el.remove();\n    }\n  }\n\n  // Everything left in the new head is new, append it all.\n  if ((import.meta as any).env?.DEV) {\n    // In DEV mode, replace known Vue scoped styles with the versions we remembered\n    [...doc.head.children].forEach((child) => {\n      document.head.append(knownVueScopedStyles.get((child as any).dataset?.viteDevId) || child);\n    });\n  } else {\n    document.head.append(...doc.head.children);\n  }\n}\n\nexport function swapBodyElement(newElement: Element, oldElement: Element) {\n  // Lift persist elements to <html> before the body swap so they stay in the DOM\n  // throughout replaceWith(). This prevents Safari from losing WebGL context on\n  // <canvas> elements due to brief DOM detachment. Uses moveBefore() where available\n  // (Chrome 133+) for zero-detachment atomic moves.\n  const persistPairs: { old: Element; newTarget: Element }[] = [];\n  const docEl = oldElement.ownerDocument.documentElement;\n\n  // moveBefore() is not yet in TypeScript's DOM lib, feature-detect and wrap.\n  const moveBefore: ((parent: Node, node: Node, child: Node | null) => void) | null =\n    typeof (docEl as any).moveBefore === \"function\"\n      ? (parent, node, child) => (parent as any).moveBefore(node, child)\n      : null;\n\n  for (const el of oldElement.querySelectorAll(`[${PERSIST_ATTR}]`)) {\n    const id = el.getAttribute(PERSIST_ATTR);\n    const newEl = newElement.querySelector(`[${PERSIST_ATTR}=\"${id}\"]`);\n    if (!newEl) continue; // no matching target — leave in old body to be discarded\n    persistPairs.push({ old: el, newTarget: newEl });\n    if (moveBefore) {\n      moveBefore(docEl, el, null);\n    } else {\n      docEl.appendChild(el);\n    }\n  }\n\n  // this will reset scroll Position\n  oldElement.replaceWith(newElement);\n\n  // Move persist elements into the new body at the position of their targets\n  for (const { old: el, newTarget } of persistPairs) {\n    if (moveBefore) {\n      moveBefore(newTarget.parentNode!, el, newTarget);\n      newTarget.remove();\n    } else {\n      newTarget.replaceWith(el);\n    }\n    // For islands, copy over the props to allow them to re-render\n    if (\n      newTarget.matches(\"[data-zfb-island]\") &&\n      shouldCopyProps(el as HTMLElement) &&\n      !isSameProps(el, newTarget)\n    ) {\n      el.setAttribute(\"ssr\", \"\");\n      // zfb island wrapper writes SSR props to data-props, not props (different attribute, not just renamed).\n      const np = newTarget.getAttribute(\"data-props\");\n      if (np !== null) el.setAttribute(\"data-props\", np);\n      else el.removeAttribute(\"data-props\");\n    }\n  }\n\n  // This will upgrade any Declarative Shadow DOM in the new body.\n  attachShadowRoots(newElement);\n}\n\n/**\n * Attach Shadow DOM roots for templates with the declarative `shadowrootmode` attribute.\n * @see https://web.dev/articles/declarative-shadow-dom#polyfill\n * @param root DOM subtree to attach shadow roots within.\n */\nfunction attachShadowRoots(root: Element | ShadowRoot) {\n  root.querySelectorAll<HTMLTemplateElement>(\"template[shadowrootmode]\").forEach((template) => {\n    const mode = template.getAttribute(\"shadowrootmode\");\n    const parent = template.parentNode;\n    if ((mode === \"closed\" || mode === \"open\") && parent instanceof HTMLElement) {\n      // Skip if shadow root already exists (e.g., from transition-persisted elements)\n      if (parent.shadowRoot) {\n        template.remove();\n        return;\n      }\n      const shadowRoot = parent.attachShadow({ mode });\n      shadowRoot.appendChild(template.content);\n      template.remove();\n      attachShadowRoots(shadowRoot);\n    }\n  });\n}\n\nexport const saveFocus = (): (() => void) => {\n  const activeElement = document.activeElement as HTMLElement;\n  // The element that currently has the focus is part of a DOM tree\n  // that will survive the transition to the new document.\n  // Save the element and the cursor position\n  if (activeElement?.closest(`[${PERSIST_ATTR}]`)) {\n    if (activeElement instanceof HTMLInputElement || activeElement instanceof HTMLTextAreaElement) {\n      const start = activeElement.selectionStart;\n      const end = activeElement.selectionEnd;\n      return () => restoreFocus({ activeElement, start, end });\n    }\n    return () => restoreFocus({ activeElement });\n  } else {\n    return () => restoreFocus({ activeElement: null });\n  }\n};\n\nexport const restoreFocus = ({ activeElement, start, end }: SavedFocus) => {\n  if (activeElement) {\n    activeElement.focus();\n    if (activeElement instanceof HTMLInputElement || activeElement instanceof HTMLTextAreaElement) {\n      if (typeof start === \"number\") activeElement.selectionStart = start;\n      if (typeof end === \"number\") activeElement.selectionEnd = end;\n    }\n  }\n};\n\nexport const vueScopedStyleId = (el: HTMLStyleElement): string => {\n  const viteDevId = el.dataset[\"viteDevId\"] || \"\";\n\n  const url = new URL(viteDevId, location.href);\n  return url.searchParams.get(\"vue\") !== null &&\n    url.searchParams.get(\"type\") === \"style\" &&\n    url.searchParams.has(\"scoped\")\n    ? viteDevId\n    : \"\";\n};\n\n// Check for a head element that should persist and returns it,\n// either because it has the data attribute or because replacing it would cause avoidable FOUC.\nconst persistedHeadElement = (el: HTMLElement, newDoc: Document): Element | null => {\n  const id = el.getAttribute(PERSIST_ATTR);\n  const newEl = id && newDoc.head.querySelector(`[${PERSIST_ATTR}=\"${id}\"]`);\n  if (newEl) {\n    return newEl;\n  }\n  if (el.matches(\"link[rel=stylesheet]\")) {\n    const href = el.getAttribute(\"href\");\n    return newDoc.head.querySelector(`link[rel=stylesheet][href=\"${href}\"]`);\n  }\n  // In dev mode, Vite injects <style data-vite-dev-id=\"...\"> elements whose\n  // textContent may later be transformed (especially Vue's `:deep()` → `[data-v-xxx]`).\n  // Match these by their stable dev ID so the already-transformed style is preserved\n  // across ClientRouter soft navigations instead of being replaced by the raw version.\n  // There are other ids that can't be preserved and need a refresh, like Uno's /__uno.css,\n  // which keeps the same id, but with different contents.\n  // To avoid enumerating all exceptions, we only apply the auto-persist logic to elements\n  // that look like Vue's dev styles.\n  if ((import.meta as any).env?.DEV && el instanceof HTMLStyleElement) {\n    const viteDevId = vueScopedStyleId(el);\n    if (viteDevId) {\n      return newDoc.head.querySelector(`style[data-vite-dev-id=\"${viteDevId}\"]`);\n    }\n  }\n  // Preserve inline <style> elements with identical content across navigations.\n  // This prevents unnecessary removal and re-insertion of styles (e.g. @font-face\n  // declarations from <Font>), which would cause the browser to re-evaluate them\n  // and trigger a flash of unstyled text (FOUT).\n  if (el.tagName === \"STYLE\" && el.textContent) {\n    const styles = newDoc.head.querySelectorAll(\"style\");\n    for (const s of styles) {\n      if (s.textContent === el.textContent) {\n        return s;\n      }\n    }\n  }\n  // Preserve font preload links across navigations to avoid re-fetching cached fonts.\n  if (el.matches(\"link[rel=preload][as=font]\")) {\n    const href = el.getAttribute(\"href\");\n    return newDoc.head.querySelector(`link[rel=preload][as=font][href=\"${href}\"]`);\n  }\n  return null;\n};\n\nconst shouldCopyProps = (el: HTMLElement): boolean => {\n  const persistProps = el.dataset[\"zfbTransitionPersistProps\"];\n  return persistProps == null || persistProps === \"false\";\n};\n\nconst isSameProps = (oldEl: Element, newEl: Element) => {\n  // zfb island wrapper writes SSR props to data-props, not props (different attribute, not just renamed).\n  return oldEl.getAttribute(\"data-props\") === newEl.getAttribute(\"data-props\");\n};\n\nexport const swapFunctions = {\n  deselectScripts,\n  swapRootAttributes,\n  swapHeadElements,\n  swapBodyElement,\n  saveFocus,\n};\n\nexport const swap = (doc: Document) => {\n  deselectScripts(doc);\n  swapRootAttributes(doc);\n  swapHeadElements(doc);\n  const restoreFocusFunction = saveFocus();\n  swapBodyElement(doc.body, document.body);\n  restoreFocusFunction();\n};\n"]}
+{"version":3,"file":"swap-functions.js","sourceRoot":"","sources":["../../src/client-router/swap-functions.ts"],"names":[],"mappings":"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","sourcesContent":["/// <reference lib=\"dom\" />\n/// <reference lib=\"dom.iterable\" />\n// Ported verbatim from Astro transitions/swap-functions.ts. Mechanical renames\n// applied per W1B §13.4 (data-astro-* → data-zfb-*, dataset.astro* → dataset.zfb*,\n// astro-island element-name branch → data-zfb-island marker per W1B §12.3 island-lifecycle\n// contract). vueScopedStyleId is intentionally KEPT verbatim per W2A §2.8 (the W3B\n// issue body's \"DELETE\" instruction is overridden by W2A's reclassification).\n\nexport type SavedFocus = {\n  activeElement: HTMLElement | null;\n  start?: number | null;\n  end?: number | null;\n};\n\nconst PERSIST_ATTR = \"data-zfb-transition-persist\";\n\n// Cross-package \"needs-remount\" flag written onto a persisted island whose props\n// changed across the swap. @takazudo/zfb's mountNewIslands consumes it — the\n// island mounted-map lives in that separate package, so a DOM attribute is the\n// only channel the two packages share. Namespaced under data-zfb-* like every\n// other zfb marker so it can't collide with a bare attribute a consumer sets on\n// the same island root. Replaces the opaque `ssr` attribute the original Astro\n// port set here but nothing consumed — zfb islands are marker divs, not\n// <astro-island> custom elements. See client-router/port-spec.md §12.3 / #1389.\nconst ISLAND_REMOUNT_ATTR = \"data-zfb-island-remount\";\n\nconst NON_OVERRIDABLE_ZFB_ATTRS = [\"data-zfb-transition\", \"data-zfb-transition-fallback\"];\n\n// Consumers extend the preserve-set via <meta name=\"zfb-preserve-html-attrs\"\n// content=\"data-theme data-sidebar-hidden …\">, emitted by\n// <ClientRouter preserveHtmlAttrs={[…]} />. Without it, a runtime <html>\n// attribute set from a persisted island is wiped on every swap. See\n// client-router/port-spec.md deviation #11 and Takazudo/zudo-front-builder#1103.\nconst PRESERVE_ATTRS_META_NAME = \"zfb-preserve-html-attrs\";\n\nconst knownVueScopedStyles = new Map<string, HTMLStyleElement>();\n\nconst scriptsAlreadyRan = new Set<string>();\nexport function detectScriptExecuted(script: HTMLScriptElement) {\n  const key = script.src ? new URL(script.src, location.href).href : script.textContent!;\n  if (scriptsAlreadyRan.has(key)) return true;\n  scriptsAlreadyRan.add(key);\n  return false;\n}\n\n/*\n * \tMark new scripts that should not execute\n */\nexport function deselectScripts(doc: Document) {\n  for (const s2 of doc.scripts) {\n    if (\n      // Check if the script should be rerun regardless of it being the same\n      !s2.hasAttribute(\"data-zfb-rerun\") &&\n      // Check if the script has already been executed\n      detectScriptExecuted(s2)\n    ) {\n      // the old script is in the new document and doesn't have the rerun attribute\n      // we mark it as executed to prevent re-execution\n      s2.dataset[\"zfbExec\"] = \"\";\n    }\n  }\n}\n\n/*\n * Read the consumer-configured preserve-list from the live document's\n * <meta name=\"zfb-preserve-html-attrs\"> tag. The list is a site-wide, static\n * contract (the tag is rendered on every page, so it is present on both the\n * current and incoming documents); reading the live document is sufficient.\n * Returns [] when the tag is absent.\n */\nfunction consumerPreservedAttrs(): string[] {\n  const content = document\n    .querySelector(`meta[name=\"${PRESERVE_ATTRS_META_NAME}\"]`)\n    ?.getAttribute(\"content\");\n  // Attribute names are ASCII-case-insensitive and the DOM exposes them\n  // lowercased, so normalize the list to match (NON_OVERRIDABLE_ZFB_ATTRS is\n  // already lowercase). Without this, a mixed-case entry would silently never\n  // match the live attribute name.\n  return content ? content.toLowerCase().split(/\\s+/).filter(Boolean) : [];\n}\n\nconst attrValueSelector = (attr: string, value: string): string =>\n  value === \"\" ? `[${attr}=\"\"]` : `[${attr}=${CSS.escape(value)}]`;\n\nconst querySelectorWithAttrValue = (\n  root: ParentNode,\n  selectorPrefix: string,\n  attr: string,\n  value: string,\n): Element | null => {\n  const escapedMatch = root.querySelector(`${selectorPrefix}${attrValueSelector(attr, value)}`);\n  if (escapedMatch) return escapedMatch;\n  return (\n    Array.from(root.querySelectorAll(`${selectorPrefix}[${attr}]`)).find(\n      (el) => el.getAttribute(attr) === value,\n    ) ?? null\n  );\n};\n\n/*\n * swap attributes of the html element\n * delete all attributes from the current document\n * insert all attributes from doc\n * reinsert all original attributes whose name is in the preserve-set:\n * NON_OVERRIDABLE_ZFB_ATTRS (transition-internal) ∪ the consumer preserve-list.\n * Preserved attributes are re-applied last, so a runtime value on the current\n * root wins over the incoming document's default (e.g. a localStorage-driven\n * data-theme). See client-router/port-spec.md deviation #11 / #1103.\n */\nexport function swapRootAttributes(newDoc: Document) {\n  const currentRoot = document.documentElement;\n  const preserve = new Set([...NON_OVERRIDABLE_ZFB_ATTRS, ...consumerPreservedAttrs()]);\n  const preservedAttributes = [...currentRoot.attributes].filter(\n    ({ name }) => (currentRoot.removeAttribute(name), preserve.has(name)),\n  );\n  [...newDoc.documentElement.attributes, ...preservedAttributes].forEach(({ name, value }) =>\n    currentRoot.setAttribute(name, value),\n  );\n}\n\n/*\n * make the old head look like the new one\n */\nexport function swapHeadElements(doc: Document) {\n  for (const el of Array.from(document.head.children)) {\n    const newEl = persistedHeadElement(el as HTMLElement, doc);\n    // If the element exists in the document already, remove it\n    // from the new document and leave the current node alone\n    if (newEl) {\n      newEl.remove();\n    } else {\n      if ((import.meta as any).env?.DEV && el instanceof HTMLStyleElement) {\n        // In DEV mode, keep updated Vue scoped styles for later reuse\n        const viteDevId = vueScopedStyleId(el);\n        viteDevId && knownVueScopedStyles.set(viteDevId, el);\n      }\n      // If the element does not exist in the new document, remove the element from current the head.\n      el.remove();\n    }\n  }\n\n  // Everything left in the new head is new, append it all.\n  if ((import.meta as any).env?.DEV) {\n    // In DEV mode, replace known Vue scoped styles with the versions we remembered\n    [...doc.head.children].forEach((child) => {\n      document.head.append(knownVueScopedStyles.get((child as any).dataset?.viteDevId) || child);\n    });\n  } else {\n    document.head.append(...doc.head.children);\n  }\n}\n\nexport function swapBodyElement(newElement: Element, oldElement: Element) {\n  // Lift persist elements to <html> before the body swap so they stay in the DOM\n  // throughout replaceWith(). This prevents Safari from losing WebGL context on\n  // <canvas> elements due to brief DOM detachment. Uses moveBefore() where available\n  // (Chrome 133+) for zero-detachment atomic moves.\n  const persistPairs: { old: Element; newTarget: Element }[] = [];\n  const docEl = oldElement.ownerDocument.documentElement;\n\n  // moveBefore() is not yet in TypeScript's DOM lib, feature-detect and wrap.\n  const moveBefore: ((parent: Node, node: Node, child: Node | null) => void) | null =\n    typeof (docEl as any).moveBefore === \"function\"\n      ? (parent, node, child) => (parent as any).moveBefore(node, child)\n      : null;\n\n  for (const el of oldElement.querySelectorAll(`[${PERSIST_ATTR}]`)) {\n    const id = el.getAttribute(PERSIST_ATTR);\n    const newEl = id !== null ? querySelectorWithAttrValue(newElement, \"\", PERSIST_ATTR, id) : null;\n    if (!newEl) continue; // no matching target — leave in old body to be discarded\n    persistPairs.push({ old: el, newTarget: newEl });\n    if (moveBefore) {\n      moveBefore(docEl, el, null);\n    } else {\n      docEl.appendChild(el);\n    }\n  }\n\n  // this will reset scroll Position\n  oldElement.replaceWith(newElement);\n\n  // Move persist elements into the new body at the position of their targets\n  for (const { old: el, newTarget } of persistPairs) {\n    if (moveBefore) {\n      moveBefore(newTarget.parentNode!, el, newTarget);\n      newTarget.remove();\n    } else {\n      newTarget.replaceWith(el);\n    }\n    // Persist-props hybrid path (port-spec §12.3.1 hybrid case / §12.3.2): the\n    // persisted island survived the lift with its live component instance, but\n    // the incoming page carries different props. Refresh data-props on the\n    // surviving node and flag it with ISLAND_REMOUNT_ATTR. That flag is the\n    // cross-package \"needs-remount\" signal consumed by @takazudo/zfb's\n    // mountNewIslands (clearMountedForRemount): it can't be an in-memory queue\n    // because the islands runtime's mounted-map lives in a different package, so\n    // the flagged DOM node itself is the queue. mountNewIslands unmounts the\n    // stale instance and re-mounts against this node with the new data-props.\n    if (\n      newTarget.matches(\"[data-zfb-island]\") &&\n      shouldCopyProps(el as HTMLElement) &&\n      !isSameProps(el, newTarget)\n    ) {\n      el.setAttribute(ISLAND_REMOUNT_ATTR, \"\");\n      // zfb island wrapper writes SSR props to data-props, not props (different attribute, not just renamed).\n      const np = newTarget.getAttribute(\"data-props\");\n      if (np !== null) el.setAttribute(\"data-props\", np);\n      else el.removeAttribute(\"data-props\");\n    }\n  }\n\n  // This will upgrade any Declarative Shadow DOM in the new body.\n  attachShadowRoots(newElement);\n}\n\n/**\n * Attach Shadow DOM roots for templates with the declarative `shadowrootmode` attribute.\n * @see https://web.dev/articles/declarative-shadow-dom#polyfill\n * @param root DOM subtree to attach shadow roots within.\n */\nfunction attachShadowRoots(root: Element | ShadowRoot) {\n  root.querySelectorAll<HTMLTemplateElement>(\"template[shadowrootmode]\").forEach((template) => {\n    const mode = template.getAttribute(\"shadowrootmode\");\n    const parent = template.parentNode;\n    if ((mode === \"closed\" || mode === \"open\") && parent instanceof HTMLElement) {\n      // Skip if shadow root already exists (e.g., from transition-persisted elements)\n      if (parent.shadowRoot) {\n        template.remove();\n        return;\n      }\n      const shadowRoot = parent.attachShadow({ mode });\n      shadowRoot.appendChild(template.content);\n      template.remove();\n      attachShadowRoots(shadowRoot);\n    }\n  });\n}\n\nexport const saveFocus = (): (() => void) => {\n  const activeElement = document.activeElement as HTMLElement;\n  // The element that currently has the focus is part of a DOM tree\n  // that will survive the transition to the new document.\n  // Save the element and the cursor position\n  if (activeElement?.closest(`[${PERSIST_ATTR}]`)) {\n    if (activeElement instanceof HTMLInputElement || activeElement instanceof HTMLTextAreaElement) {\n      const start = activeElement.selectionStart;\n      const end = activeElement.selectionEnd;\n      return () => restoreFocus({ activeElement, start, end });\n    }\n    return () => restoreFocus({ activeElement });\n  } else {\n    return () => restoreFocus({ activeElement: null });\n  }\n};\n\nexport const restoreFocus = ({ activeElement, start, end }: SavedFocus) => {\n  if (activeElement) {\n    activeElement.focus();\n    if (activeElement instanceof HTMLInputElement || activeElement instanceof HTMLTextAreaElement) {\n      if (typeof start === \"number\") activeElement.selectionStart = start;\n      if (typeof end === \"number\") activeElement.selectionEnd = end;\n    }\n  }\n};\n\nexport const vueScopedStyleId = (el: HTMLStyleElement): string => {\n  const viteDevId = el.dataset[\"viteDevId\"] || \"\";\n\n  const url = new URL(viteDevId, location.href);\n  return url.searchParams.get(\"vue\") !== null &&\n    url.searchParams.get(\"type\") === \"style\" &&\n    url.searchParams.has(\"scoped\")\n    ? viteDevId\n    : \"\";\n};\n\n// Check for a head element that should persist and returns it,\n// either because it has the data attribute or because replacing it would cause avoidable FOUC.\nconst persistedHeadElement = (el: HTMLElement, newDoc: Document): Element | null => {\n  const id = el.getAttribute(PERSIST_ATTR);\n  const newEl = id !== null ? querySelectorWithAttrValue(newDoc.head, \"\", PERSIST_ATTR, id) : null;\n  if (newEl) {\n    return newEl;\n  }\n  if (el.matches(\"link[rel=stylesheet]\")) {\n    const href = el.getAttribute(\"href\");\n    return href !== null\n      ? querySelectorWithAttrValue(newDoc.head, \"link[rel=stylesheet]\", \"href\", href)\n      : null;\n  }\n  // In dev mode, Vite injects <style data-vite-dev-id=\"...\"> elements whose\n  // textContent may later be transformed (especially Vue's `:deep()` → `[data-v-xxx]`).\n  // Match these by their stable dev ID so the already-transformed style is preserved\n  // across ClientRouter soft navigations instead of being replaced by the raw version.\n  // There are other ids that can't be preserved and need a refresh, like Uno's /__uno.css,\n  // which keeps the same id, but with different contents.\n  // To avoid enumerating all exceptions, we only apply the auto-persist logic to elements\n  // that look like Vue's dev styles.\n  if ((import.meta as any).env?.DEV && el instanceof HTMLStyleElement) {\n    const viteDevId = vueScopedStyleId(el);\n    if (viteDevId) {\n      return querySelectorWithAttrValue(newDoc.head, \"style\", \"data-vite-dev-id\", viteDevId);\n    }\n  }\n  // Preserve inline <style> elements with identical content across navigations.\n  // This prevents unnecessary removal and re-insertion of styles (e.g. @font-face\n  // declarations from <Font>), which would cause the browser to re-evaluate them\n  // and trigger a flash of unstyled text (FOUT).\n  if (el.tagName === \"STYLE\" && el.textContent) {\n    const styles = newDoc.head.querySelectorAll(\"style\");\n    for (const s of styles) {\n      if (s.textContent === el.textContent) {\n        return s;\n      }\n    }\n  }\n  // Preserve font preload links across navigations to avoid re-fetching cached fonts.\n  if (el.matches(\"link[rel=preload][as=font]\")) {\n    const href = el.getAttribute(\"href\");\n    return href !== null\n      ? querySelectorWithAttrValue(newDoc.head, \"link[rel=preload][as=font]\", \"href\", href)\n      : null;\n  }\n  return null;\n};\n\nconst shouldCopyProps = (el: HTMLElement): boolean => {\n  const persistProps = el.dataset[\"zfbTransitionPersistProps\"];\n  return persistProps == null || persistProps === \"false\";\n};\n\nconst isSameProps = (oldEl: Element, newEl: Element) => {\n  // zfb island wrapper writes SSR props to data-props, not props (different attribute, not just renamed).\n  return oldEl.getAttribute(\"data-props\") === newEl.getAttribute(\"data-props\");\n};\n\nexport const swapFunctions = {\n  deselectScripts,\n  swapRootAttributes,\n  swapHeadElements,\n  swapBodyElement,\n  saveFocus,\n};\n\nexport const swap = (doc: Document) => {\n  deselectScripts(doc);\n  swapRootAttributes(doc);\n  swapHeadElements(doc);\n  const restoreFocusFunction = saveFocus();\n  swapBodyElement(doc.body, document.body);\n  restoreFocusFunction();\n};\n"]}

package/dist/router.d.ts

@@ -16,7 +16,10 @@ export interface PageHeading {
  * - `default`: the JSX page component. Called with the props returned by
  *   `getStaticProps` (if exported) or the `props` from the matching
  *   `paths()` entry (for dynamic routes). The return value is fed straight
- *   to the framework adapter's `renderToString`.
+ *   to the framework adapter's `renderToString`. A dynamic route with no
+ *   `paths()` export is called with `{ params: urlParams }` instead of
+ *   `{}` — see `createPageRouter`'s JSDoc for the full componentInput
+ *   derivation table.
  * - `prerender`: literal `false` opts a route OUT of build-time SSG (T5
  *   contract). The page router still serves it under the embedded V8 host
  *   so dev mode behaves identically; SSG callers filter the route list before
@@ -106,6 +109,17 @@ export type PageRouter = (request: Request) => Promise<Response>;
  *      `framework.renderToString(module.default({}))`, and returns the
  *      string in a `Response` with the appropriate `Content-Type`.
  *
+ * Per-route `componentInput` (the object passed to `module.default(...)`) is
+ * derived from the route pattern and the page module's exports:
+ *   - Dynamic route + `paths()` export: match the URL params against the
+ *     `paths()` entries and pass `{ params, ...props }` (404 on no match).
+ *   - Static route + `getStaticProps()` export: pass the returned `props`.
+ *   - Dynamic route with NO `paths()` export (e.g. a per-request SSR page
+ *     whose slugs can't be enumerated ahead of time): pass `{ params:
+ *     urlParams }` so the component still knows which URL params it is
+ *     serving, rather than being invoked with `{}`.
+ *   - Anything else (static route, no `getStaticProps`): pass `{}`.
+ *
  * The returned function is a plain `(request) => Promise<Response>` so a
  * Worker entry point can `export default { fetch: createPageRouter(...) }`
  * directly.

package/dist/router.js

@@ -110,6 +110,17 @@ async function getOrEvalPaths(memo, routeKey, pathsFn) {
  *      `framework.renderToString(module.default({}))`, and returns the
  *      string in a `Response` with the appropriate `Content-Type`.
  *
+ * Per-route `componentInput` (the object passed to `module.default(...)`) is
+ * derived from the route pattern and the page module's exports:
+ *   - Dynamic route + `paths()` export: match the URL params against the
+ *     `paths()` entries and pass `{ params, ...props }` (404 on no match).
+ *   - Static route + `getStaticProps()` export: pass the returned `props`.
+ *   - Dynamic route with NO `paths()` export (e.g. a per-request SSR page
+ *     whose slugs can't be enumerated ahead of time): pass `{ params:
+ *     urlParams }` so the component still knows which URL params it is
+ *     serving, rather than being invoked with `{}`.
+ *   - Anything else (static route, no `getStaticProps`): pass `{}`.
+ *
  * The returned function is a plain `(request) => Promise<Response>` so a
  * Worker entry point can `export default { fetch: createPageRouter(...) }`
  * directly.
@@ -314,6 +325,16 @@ export function createPageRouter(opts) {
                     ...(match.props ?? {}),
                 };
             }
+            else if (isDynamicRoute) {
+                // Dynamic route with no `paths()` export: the natural shape for a
+                // per-request SSR page whose slugs can't be enumerated ahead of
+                // time. Neither branch above applies (no paths() to match against,
+                // and getStaticProps only fires for static routes), so without this
+                // the component would be invoked with `{}` — no params, no
+                // diagnostic, and no way to know which slug it is serving. Pass the
+                // URL params through directly instead.
+                componentInput = { params: urlParams };
+            }
             else if (!isDynamicRoute && typeof mod.getStaticProps === "function") {
                 // Static route with `getStaticProps`: call it to fetch build-time
                 // data and pass the returned props to the default component. This

package/dist/router.js.map

@@ -1 +1 @@
-{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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","sourcesContent":["// `@takazudo/zfb-runtime` — Hono-based page router.\n//\n// `createPageRouter` is the JS-side entry point for ADR-007's SSG-first\n// architecture. The pipeline goes:\n//\n//   user pages/ + content/ + layouts/ + components/\n//     → esbuild bundle (T3)            // single ESM file\n//     → embedded V8 host (T6)          // same WinterCG surface as CF Workers\n//     → createPageRouter({ pages, contentSnapshot, framework })\n//     → (request) => Promise<Response>\n//\n// The bundle's Worker entry point shape is documented in the package\n// README. The contract is intentionally minimal: one factory call returns\n// one fetch handler. Hono is an implementation detail — callers should\n// not depend on the Hono types leaking through. The exposed surface is\n// the four types here plus the `createPageRouter` function.\n//\n// Side effect on init: registers the supplied `ContentSnapshot` with\n// `zfb/content`'s module-level snapshot bridge so any page module\n// importing `getCollection(\"...\")` resolves from memory rather than\n// touching the Node `fs` API (the Worker runtime has no `fs`).\n//\n// ## Synthetic `__paths__` endpoint\n//\n// The Rust build pipeline needs to evaluate non-literal `paths()` exports\n// (e.g. those that `await import(\"@takazudo/zfb/content\")` and call `getCollection`)\n// at runtime against the running embedded host. The router exposes a\n// synthetic internal endpoint:\n//\n//   GET /__paths__/<percent-encoded-route-key>\n//\n// When a page registered at `route` has a `paths` export, the handler calls\n// it and returns the JSON-serialized array as `application/json`. If the\n// `paths` export is missing or throws, the response is a descriptive 500.\n// This endpoint is only meant for the build pipeline — it is safe to leave\n// registered in production because no user-authored route should start with\n// `/__paths__/` (the build pipeline rejects any route that conflicts).\n\nimport { Hono } from \"hono\";\nimport { setContentSnapshot } from \"@takazudo/zfb/content\";\n\nimport type { FrameworkAdapter } from \"./framework.js\";\nimport type { ContentSnapshot } from \"./snapshot.js\";\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Heading metadata emitted by the MDX `headings` export (T4). Cross-ref:\n * `crates/zfb-content/src/mdx_jsx_emit.rs`. Optional on the page-module\n * shape — non-MDX pages won't carry it.\n */\nexport interface PageHeading {\n  readonly depth: number;\n  readonly slug: string;\n  readonly text: string;\n}\n\n/**\n * The shape every page module must export.\n *\n * - `default`: the JSX page component. Called with the props returned by\n *   `getStaticProps` (if exported) or the `props` from the matching\n *   `paths()` entry (for dynamic routes). The return value is fed straight\n *   to the framework adapter's `renderToString`.\n * - `prerender`: literal `false` opts a route OUT of build-time SSG (T5\n *   contract). The page router still serves it under the embedded V8 host\n *   so dev mode behaves identically; SSG callers filter the route list before\n *   driving the renderer.\n * - `contentType`: optional override for non-HTML routes (e.g.\n *   `application/xml` for `rss.xml.tsx`). Default is\n *   `text/html; charset=utf-8`. Cross-ref shipped #49.\n * - `headings`: optional list emitted by MDX (T4).\n * - `paths`: optional dynamic-route enumerator. Called at build time by\n *   the `__paths__` synthetic endpoint to produce the concrete URL list\n *   for this route template. May be async. Returns an array of\n *   `{ params, props? }` objects identical in shape to the Astro/zfb\n *   `paths()` contract.\n *   **Evaluated once per router instance** — the result is memoised and\n *   shared across the `/__paths__` handler and all per-page render\n *   requests. This matches the build-time-enumerator contract: every\n *   entry rendered within a single build sees the same paths() snapshot.\n *   Dev mode is safe because each file-save triggers a fresh bundle,\n *   which creates a new router instance with a clean memo.\n * - `getStaticProps`: optional async function for static routes that need\n *   to fetch data at build/render time. Called once per request (before\n *   `default`). Must return `{ props: Record<string, unknown> }`. The\n *   returned `props` are spread into the `default` component's props.\n */\nexport interface PageModule {\n  readonly default: (props: Record<string, unknown>) => unknown;\n  readonly prerender?: boolean;\n  readonly contentType?: string;\n  readonly headings?: readonly PageHeading[];\n  readonly paths?: () => unknown[] | Promise<unknown[]>;\n  readonly getStaticProps?: () => Promise<{ props: Record<string, unknown> }>;\n}\n\n/**\n * One page registered with the router.\n *\n * `route` is a Hono path pattern (e.g. `/`, `/blog/:slug`,\n * `/blog/page/:page`). `module` is a thunk so the bundle can use code\n * splitting if it wants to — today the bundler emits everything as one\n * ESM file and the thunk simply returns the already-loaded module.\n */\nexport interface PageDefinition {\n  readonly route: string;\n  readonly module: () => Promise<PageModule>;\n}\n\n/** Options accepted by [`createPageRouter`]. */\nexport interface CreatePageRouterOptions {\n  /** Pages to register. Order does not affect routing — Hono dispatches by path. */\n  readonly pages: readonly PageDefinition[];\n  /**\n   * In-memory content snapshot. Embedded into the bundle by T3; the\n   * router hands it to `zfb/content` so user pages reading content via\n   * `getCollection(...)` resolve synchronously from memory.\n   */\n  readonly contentSnapshot: ContentSnapshot;\n  /** Framework adapter pinning the SSR call. */\n  readonly framework: FrameworkAdapter;\n  /**\n   * When `true`, the 500 body for render errors includes the full JS stack\n   * trace. When `false`, only the message + route are included. When\n   * omitted, the runtime checks `globalThis.__zfb.ssrDebug` at request time:\n   * that flag is set by the embedded V8 build/dev host (`globals_shim.js`)\n   * and is absent on the production Cloudflare Workers runtime.\n   *\n   * Default is effectively OFF for production (no flag ⇒ message + route only).\n   * Useful for explicit injection in unit tests without global mutation.\n   */\n  readonly includeErrorStack?: boolean;\n}\n\n/**\n * Fetch-handler shape returned by [`createPageRouter`]. Shaped as a plain\n * function (not a Hono `app`) so the consumer's contract is exactly\n * \"Worker-style fetch handler\" with no leaked framework types.\n */\nexport type PageRouter = (request: Request) => Promise<Response>;\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n/**\n * Default content-type when a page module does not override.\n *\n * Aligned with #49's per-page `contentType` convention: the default\n * served for HTML pages is `text/html; charset=utf-8`. Tests pin this\n * verbatim because the embedded V8 host does NOT auto-set a charset.\n */\nconst DEFAULT_CONTENT_TYPE = \"text/html; charset=utf-8\";\n\n/**\n * Issue #530: prepend `<!doctype html>\\n` to SSR-rendered HTML bodies that\n * lack a doctype declaration, mirroring the guard in\n * `crates/zfb-build/src/renderer.rs::render_one_inner` (issue #524).\n *\n * Gate conditions (all must hold to prepend):\n *   1. `contentType` media-type (before `;`) is `text/html` (case-insensitive).\n *   2. The body, after stripping an optional UTF-8 BOM (U+FEFF) and leading\n *      ASCII whitespace, starts with `<html` (case-insensitive) — i.e. it is\n *      an `<html>`-rooted document, not XML / JSON / a fragment.\n *   3. The body (same stripped prefix) does NOT already begin with `<!doctype`\n *      (case-insensitive).\n *\n * Deliberately NOT shared with the Rust side — duplication of a 5-line guard\n * is the right call rather than introducing a new cross-language boundary.\n */\nfunction ensureHtml5Doctype(body: string, contentType: string): string {\n  const mediaType = contentType.split(\";\")[0]?.trim().toLowerCase();\n  if (mediaType !== \"text/html\") return body;\n  // Strip optional BOM and leading whitespace to inspect the root element.\n  const stripped = body.replace(/^/, \"\").trimStart();\n  if (!stripped.toLowerCase().startsWith(\"<!doctype\")) {\n    if (stripped.toLowerCase().startsWith(\"<html\")) {\n      return `<!doctype html>\\n${body}`;\n    }\n  }\n  return body;\n}\n\n/**\n * Evaluate `pathsFn` once per `routeKey`, sharing the result across all\n * concurrent and subsequent callers via a Promise stored in `memo`.\n *\n * Rejections are evicted from the memo so that a transient paths() failure\n * does not permanently poison the cache — the next request retries.\n */\nasync function getOrEvalPaths(\n  memo: Map<string, Promise<unknown[]>>,\n  routeKey: string,\n  pathsFn: () => unknown[] | Promise<unknown[]>,\n): Promise<unknown[]> {\n  const existing = memo.get(routeKey);\n  if (existing !== undefined) {\n    return existing;\n  }\n  const promise = Promise.resolve(pathsFn()).then(\n    (v) => v as unknown[],\n    (err) => {\n      // Evict on rejection so the next request retries.\n      memo.delete(routeKey);\n      return Promise.reject(err) as Promise<unknown[]>;\n    },\n  );\n  memo.set(routeKey, promise);\n  return promise;\n}\n\n/**\n * Build a page router for the SSG-first architecture (ADR-005).\n *\n * Side effects:\n *   1. Registers `opts.contentSnapshot` with the `zfb/content` module so\n *      `getCollection(name)` resolves from memory. Idempotent across\n *      calls — the latest snapshot wins (matches the documented dev-mode\n *      live-reload contract).\n *   2. Constructs an internal Hono app and registers a GET handler per\n *      `pages[i].route`. The handler imports the page module, calls\n *      `framework.renderToString(module.default({}))`, and returns the\n *      string in a `Response` with the appropriate `Content-Type`.\n *\n * The returned function is a plain `(request) => Promise<Response>` so a\n * Worker entry point can `export default { fetch: createPageRouter(...) }`\n * directly.\n */\nexport function createPageRouter(opts: CreatePageRouterOptions): PageRouter {\n  setContentSnapshot(opts.contentSnapshot);\n\n  const app = new Hono();\n\n  // Build a lookup map: Hono route pattern → PageDefinition, for the\n  // `__paths__` synthetic endpoint below. The map is keyed on the `route`\n  // string exactly as the caller supplied it (e.g. \"/blog/:slug\").\n  const pagesByRoute = new Map<string, PageDefinition>();\n  for (const page of opts.pages) {\n    pagesByRoute.set(page.route, page);\n  }\n\n  // Per-router-instance memo for paths() results.\n  //\n  // Keyed on page.route (e.g. \"/blog/:slug\"). Stores the in-flight or\n  // settled Promise so that concurrent requests share one evaluation.\n  // Rejections are NOT cached: if paths() throws the Promise is removed\n  // from the map so the next request retries rather than re-propagating\n  // the same error indefinitely.\n  //\n  // Production SSR isolates evaluate paths() once per isolate, which\n  // matches the documented build-time-enumerator contract. Dev mode is\n  // safe because each re-bundle creates a fresh router instance\n  // (dev.rs reload_renderer), so stale paths() results never persist\n  // across a file-save cycle. Watch-time invalidation is explicitly\n  // out of scope per issue #507.\n  const pathsMemo = new Map<string, Promise<unknown[]>>();\n\n  // Sanity check: a user-authored route that happens to start with\n  // `/__paths__` (or a top-level catchall like `/:slug{.+}`) would\n  // shadow the synthetic endpoint registered below if Hono dispatched\n  // by registration order. We register `/__paths__/:routeKey{.+}` first\n  // (see directly below) but still warn on collisions so users do not\n  // ship a page that conflicts with the build pipeline's wire format.\n  for (const page of opts.pages) {\n    if (routeShadowsPathsEndpoint(page.route)) {\n      // Use console.warn so the message reaches the host's tail logs\n      // without bringing down the worker. The build pipeline's\n      // /__paths__ requests still resolve correctly because the\n      // synthetic handler is registered first.\n      // eslint-disable-next-line no-console\n      console.warn(\n        `[zfb-runtime] route \"${page.route}\" may shadow the synthetic /__paths__ endpoint; rename the page or use a more specific pattern`,\n      );\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Synthetic `/__paths__/<encoded-route-key>` endpoint.\n  //\n  // Called by the Rust build pipeline (crates/zfb/src/render_pipeline.rs)\n  // to evaluate non-literal `paths()` exports at runtime. The route key is\n  // the Hono pattern for the page (e.g. `/blog/:slug`) percent-encoded so\n  // it survives in the URL path segment. The response is a JSON array of\n  // `{ params, props? }` objects identical to the `paths()` contract.\n  //\n  // Pattern: `/__paths__/:routeKey{.+}` — the `{.+}` quantifier (Hono's\n  // regex-segment syntax) allows slashes inside the route key so\n  // `/blog/:slug` decodes correctly from `/__paths__/%2Fblog%2F%3Aslug`.\n  //\n  // IMPORTANT: this handler is registered BEFORE user routes so a\n  // user-authored top-level catchall (e.g. `/:wildcard{.+}`) cannot\n  // shadow it — Hono dispatches in registration order.\n  // -------------------------------------------------------------------------\n  app.get(\"/__paths__/:routeKey{.+}\", async (c) => {\n    // Hono's `c.req.param(\"routeKey\")` already URL-decodes the captured\n    // segment when it contains a `%`, so a single decode is correct\n    // here — no explicit `decodeURIComponent` (that would be a\n    // double-decode and break literal `%` characters in route keys).\n    const routeKey = c.req.param(\"routeKey\");\n\n    const page = pagesByRoute.get(routeKey);\n    if (!page) {\n      return c.body(\n        `[zfb-runtime] /__paths__: no page registered for route key \"${routeKey}\"`,\n        404,\n        { \"Content-Type\": \"text/plain; charset=utf-8\" },\n      );\n    }\n\n    const mod = await page.module();\n    if (typeof mod.paths !== \"function\") {\n      return c.body(\n        `[zfb-runtime] /__paths__: page module for \"${routeKey}\" has no paths() export`,\n        404,\n        { \"Content-Type\": \"text/plain; charset=utf-8\" },\n      );\n    }\n\n    let result: unknown[];\n    try {\n      result = await getOrEvalPaths(pathsMemo, routeKey, mod.paths);\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      return c.body(`[zfb-runtime] /__paths__: paths() threw for \"${routeKey}\": ${msg}`, 500, {\n        \"Content-Type\": \"text/plain; charset=utf-8\",\n      });\n    }\n\n    return c.body(JSON.stringify(result), 200, {\n      \"Content-Type\": \"application/json; charset=utf-8\",\n    });\n  });\n\n  for (const page of opts.pages) {\n    // `app.all` (vs `app.get`) so SSR routes whose page handler dispatches\n    // by `request.method` (e.g. POST API endpoints like\n    // `pages/api/*.tsx`) actually reach the handler. The handler is then\n    // responsible for returning a method-appropriate status (e.g. 405 for\n    // an unsupported verb). With `app.get` the inner router would 404\n    // before the handler ever ran, leaving e.g. `POST /api/foo` looking\n    // identical to a missing route.\n    app.all(page.route, async (c) => {\n      const mod = await page.module();\n      if (typeof mod.default !== \"function\") {\n        // Surface as a 500 with a well-known message rather than letting\n        // Hono swallow the error into a generic body. T6's embedded V8\n        // host log-tail / source-map plumbing is what eventually projects\n        // page-side errors back to the user's TSX line; until then the\n        // pinned message is the contract this layer ships.\n        return c.body(\n          `[zfb-runtime] page module for \"${page.route}\" did not export a default component`,\n          500,\n          { \"Content-Type\": \"text/plain; charset=utf-8\" },\n        );\n      }\n\n      // For dynamic routes that export `paths()`, look up the concrete\n      // entry for this URL by matching the URL params against the\n      // paths() results. This implements the ADR-002 contract:\n      //   paths() → [{ params, props? }]\n      //   render(url) → find matching entry → pass { params, props } to default()\n      //\n      // For static routes (no `paths()` export, no URL params), we pass\n      // an empty object — the component signature has no required props.\n      // For dynamic routes whose URL params do not match any paths()\n      // entry, we return a 404 rather than rendering with empty props.\n      //\n      // Whether the route is dynamic is derived from the ROUTE PATTERN,\n      // not from the captured params: for an optional catchall\n      // (`/docs/:slug{.+}?`), Hono matches the bare `/docs` with NO\n      // params captured at all, so `Object.keys(c.req.param())` would\n      // be empty and the old gate skipped paths() entirely — rendering\n      // with `{}` instead of the entry whose `slug` is `[]`.\n      const declaredParams = routeParamSpecs(page.route);\n      const rawUrlParams = c.req.param() ?? {};\n      const urlParams: Record<string, string> = {};\n      for (const [k, v] of Object.entries(rawUrlParams)) {\n        // Unmatched optional params may surface as undefined — drop them\n        // so \"param absent\" is represented uniformly.\n        if (typeof v === \"string\") urlParams[k] = v;\n      }\n      const isDynamicRoute = declaredParams.length > 0;\n\n      let componentInput: Record<string, unknown> = {};\n\n      if (isDynamicRoute && typeof mod.paths === \"function\") {\n        let pathsResult: unknown;\n        try {\n          pathsResult = await getOrEvalPaths(pathsMemo, page.route, mod.paths);\n        } catch (err) {\n          const msg = err instanceof Error ? err.message : String(err);\n          return c.body(`[zfb-runtime] paths() threw for \"${page.route}\": ${msg}`, 500, {\n            \"Content-Type\": \"text/plain; charset=utf-8\",\n          });\n        }\n\n        if (!Array.isArray(pathsResult)) {\n          return c.body(`[zfb-runtime] paths() for \"${page.route}\" did not return an array`, 500, {\n            \"Content-Type\": \"text/plain; charset=utf-8\",\n          });\n        }\n\n        // Validate each entry's shape per-entry rather than using a bare\n        // cast — matches the strictness the Rust pipeline applies on the\n        // same wire format. Any malformed entry surfaces as a 500.\n        for (const entry of pathsResult) {\n          if (!isPathsEntry(entry)) {\n            return c.body(\n              `[zfb-runtime] paths() for \"${page.route}\" returned an entry without a valid params object`,\n              500,\n              { \"Content-Type\": \"text/plain; charset=utf-8\" },\n            );\n          }\n        }\n\n        // Find the entry whose params match the URL params for this\n        // request. For catchall params (e.g. slug for\n        // /docs/[...slug]), Hono returns a slash-joined string (e.g.\n        // \"guides/install\"), so we compare against the paths() entry's\n        // params.slug joined with \"/\".\n        //\n        // Matching iterates the params DECLARED by the route pattern so\n        // the zero-segment optional-catchall case is covered: when Hono\n        // matched `/docs` for `/docs/:slug{.+}?` no `slug` param exists\n        // in the URL, and the matching entry is the one whose param is\n        // the explicit empty array (`{ slug: [] }`).\n        const match = (pathsResult as PathsEntry[]).find((entry) => {\n          return declaredParams.every(({ name, optionalCatchall }) => {\n            const urlVal = urlParams[name];\n            const paramVal = entry.params[name];\n            if (urlVal === undefined) {\n              // Param absent from the URL: only valid for an optional\n              // catchall, and only against the explicit `[]` entry.\n              return optionalCatchall && Array.isArray(paramVal) && paramVal.length === 0;\n            }\n            if (Array.isArray(paramVal)) {\n              // catchall: paths() emits slug as string[] but Hono\n              // provides it as a \"/\"-joined string\n              return paramVal.join(\"/\") === urlVal;\n            }\n            return String(paramVal) === urlVal;\n          });\n        });\n\n        if (!match) {\n          // The URL params do not correspond to any paths() entry —\n          // this is the dev-mode equivalent of a build-time miss.\n          // Hono's `c.notFound()` returns the framework's default 404,\n          // which is cleaner than fabricating an empty-props render.\n          return c.notFound();\n        }\n\n        // Pass the paths() entry's props directly as component props\n        // (spread to top level, matching the Astro/zfb convention).\n        // Also include `params` so components can access URL params if\n        // needed, but individual prop keys from `props` win on collision.\n        componentInput = {\n          params: match.params,\n          ...(match.props ?? {}),\n        };\n      } else if (!isDynamicRoute && typeof mod.getStaticProps === \"function\") {\n        // Static route with `getStaticProps`: call it to fetch build-time\n        // data and pass the returned props to the default component. This\n        // supports the `export async function getStaticProps()` pattern\n        // used by static pages that need to query content collections (e.g.\n        // a homepage listing all blog posts via `getCollection(\"blog\")`).\n        let staticPropsResult: unknown;\n        try {\n          staticPropsResult = await mod.getStaticProps();\n        } catch (err) {\n          const msg = err instanceof Error ? err.message : String(err);\n          return c.body(`[zfb-runtime] getStaticProps() threw for \"${page.route}\": ${msg}`, 500, {\n            \"Content-Type\": \"text/plain; charset=utf-8\",\n          });\n        }\n        if (\n          typeof staticPropsResult !== \"object\" ||\n          staticPropsResult === null ||\n          !(\"props\" in staticPropsResult)\n        ) {\n          return c.body(\n            `[zfb-runtime] getStaticProps() for \"${page.route}\" must return { props: {...} }`,\n            500,\n            { \"Content-Type\": \"text/plain; charset=utf-8\" },\n          );\n        }\n        componentInput = (staticPropsResult as { props: Record<string, unknown> }).props;\n      }\n\n      // `await` so async page modules (e.g. API routes typed as\n      // `(): Promise<Response>`) resolve before we inspect the value.\n      // For sync pages that return a VNode/string the await is a no-op.\n      //\n      // Wrapped in a try/catch so that any error thrown by the component\n      // or by renderToString surfaces as a descriptive 500 rather than\n      // escaping to Hono's generic error handler (which discards the real\n      // message). Mirrors the getStaticProps catch above.\n      try {\n        const result = await mod.default(componentInput);\n        // API route short-circuit: a page module that returns a Response\n        // directly (e.g. `pages/api/*.tsx` handlers that use Web Fetch\n        // primitives instead of returning JSX) is responsible for its own\n        // status, headers, and body — return it as-is rather than running\n        // it through the framework SSR path. A `return` from inside a\n        // `try` does not trigger the `catch`, so this passes through\n        // correctly without special-casing.\n        if (result instanceof Response) {\n          return result;\n        }\n        // Non-HTML routes (e.g. `sitemap.xml.tsx`, `feed.xml.tsx`) commonly\n        // return their body as a pre-serialised `string` instead of a\n        // VNode. Routing those through `framework.renderToString` would\n        // HTML-escape the angle brackets and ampersands, producing\n        // garbage XML. Pass strings through verbatim; only wrap actual\n        // VNodes.\n        const html = typeof result === \"string\" ? result : opts.framework.renderToString(result);\n        const contentType = mod.contentType ?? DEFAULT_CONTENT_TYPE;\n        return c.body(ensureHtml5Doctype(html, contentType), 200, { \"Content-Type\": contentType });\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        // __zfb.ssrDebug is set only by the embedded V8 build/dev host\n        // (globals_shim.js), never by the production Workers runtime.\n        const includeStack =\n          opts.includeErrorStack ??\n          (globalThis as { __zfb?: { ssrDebug?: boolean } }).__zfb?.ssrDebug === true;\n        const stack = includeStack && err instanceof Error && err.stack ? `\\n${err.stack}` : \"\";\n        return c.body(`[zfb-runtime] render threw for \"${page.route}\": ${msg}${stack}`, 500, {\n          \"Content-Type\": \"text/plain; charset=utf-8\",\n        });\n      }\n    });\n  }\n\n  // Hono's `app.fetch` returns `Response | Promise<Response>`. The\n  // public router contract is unconditionally async; using an `async`\n  // wrapper (rather than `Promise.resolve(...)`) ensures any\n  // synchronous throw inside `app.fetch` is converted to a rejected\n  // promise instead of escaping the caller's `await`.\n  return async (request) => await app.fetch(request);\n}\n\n/**\n * Shape of one entry produced by a page's `paths()` export. The\n * `params` object is required (every entry needs to identify the URL\n * it represents); `props` is optional (the page may render purely from\n * the URL params).\n */\ninterface PathsEntry {\n  readonly params: Record<string, unknown>;\n  readonly props?: Record<string, unknown>;\n}\n\n/**\n * Type guard for one `paths()` entry. Mirrors the strictness of the\n * Rust pipeline's `paths()` resolver — every entry must be a non-null\n * object whose `params` is itself a non-null object.\n */\nfunction isPathsEntry(x: unknown): x is PathsEntry {\n  if (typeof x !== \"object\" || x === null) return false;\n  const params = (x as { params?: unknown }).params;\n  return typeof params === \"object\" && params !== null;\n}\n\n/**\n * One param declared by a Hono route pattern. `optionalCatchall` is\n * `true` for the `:name{.+}?` form (file-system `[[...name]]`), whose\n * zero-segment match captures no param at all.\n */\ninterface RouteParamSpec {\n  readonly name: string;\n  readonly optionalCatchall: boolean;\n}\n\n/**\n * Parse the params declared by a Hono route pattern (the `route` string\n * the build pipeline registers, e.g. `/blog/:slug`, `/docs/:slug{.+}`,\n * `/docs/:slug{.+}?`). Static routes return an empty list.\n *\n * Only the pattern shapes emitted by `bracket_to_hono` (zfb-build) are\n * recognised — `:name`, `:name{.+}`, `:name{.+}?` — which is the entire\n * grammar the file router produces.\n */\nfunction routeParamSpecs(route: string): RouteParamSpec[] {\n  const specs: RouteParamSpec[] = [];\n  for (const seg of route.split(\"/\")) {\n    if (!seg.startsWith(\":\")) continue;\n    const optionalCatchall = seg.endsWith(\"?\");\n    const body = optionalCatchall ? seg.slice(1, -1) : seg.slice(1);\n    const braceIdx = body.indexOf(\"{\");\n    const name = braceIdx === -1 ? body : body.slice(0, braceIdx);\n    if (name.length > 0) {\n      specs.push({ name, optionalCatchall });\n    }\n  }\n  return specs;\n}\n\n/**\n * Heuristic check for user-authored routes that may shadow the\n * synthetic `/__paths__/<encoded-route-key>` endpoint.\n *\n * Returns true when the route literal contains `/__paths__` (an\n * obvious collision) or when its first segment is a Hono catchall\n * (`:name{.+}`, optionally `:name{.+}?`) or a file-system catchall\n * (`[...name]` / `[[...name]]`) at the root — those would match\n * `/__paths__/...` once Hono dispatches to them.\n */\nfunction routeShadowsPathsEndpoint(route: string): boolean {\n  if (route.includes(\"/__paths__\")) {\n    return true;\n  }\n  // Strip the leading slash and look at the first segment only —\n  // anything deeper cannot match `/__paths__` because the literal\n  // first segment differs.\n  const firstSeg = route.replace(/^\\/+/, \"\").split(\"/\")[0] ?? \"\";\n  // Hono regex-quantifier catchall: `:name{.+}` / optional `:name{.+}?`.\n  if (/^:[A-Za-z_][\\w]*\\{\\.[+*]\\}\\??$/.test(firstSeg)) {\n    return true;\n  }\n  // File-system catchall (pre-bracket-to-hono): `[...name]` / `[[...name]]`.\n  if (/^\\[\\.\\.\\.[A-Za-z_][\\w]*\\]$/.test(firstSeg)) {\n    return true;\n  }\n  if (/^\\[\\[\\.\\.\\.[A-Za-z_][\\w]*\\]\\]$/.test(firstSeg)) {\n    return true;\n  }\n  return false;\n}\n"]}
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"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","sourcesContent":["// `@takazudo/zfb-runtime` — Hono-based page router.\n//\n// `createPageRouter` is the JS-side entry point for ADR-007's SSG-first\n// architecture. The pipeline goes:\n//\n//   user pages/ + content/ + layouts/ + components/\n//     → esbuild bundle (T3)            // single ESM file\n//     → embedded V8 host (T6)          // same WinterCG surface as CF Workers\n//     → createPageRouter({ pages, contentSnapshot, framework })\n//     → (request) => Promise<Response>\n//\n// The bundle's Worker entry point shape is documented in the package\n// README. The contract is intentionally minimal: one factory call returns\n// one fetch handler. Hono is an implementation detail — callers should\n// not depend on the Hono types leaking through. The exposed surface is\n// the four types here plus the `createPageRouter` function.\n//\n// Side effect on init: registers the supplied `ContentSnapshot` with\n// `zfb/content`'s module-level snapshot bridge so any page module\n// importing `getCollection(\"...\")` resolves from memory rather than\n// touching the Node `fs` API (the Worker runtime has no `fs`).\n//\n// ## Synthetic `__paths__` endpoint\n//\n// The Rust build pipeline needs to evaluate non-literal `paths()` exports\n// (e.g. those that `await import(\"@takazudo/zfb/content\")` and call `getCollection`)\n// at runtime against the running embedded host. The router exposes a\n// synthetic internal endpoint:\n//\n//   GET /__paths__/<percent-encoded-route-key>\n//\n// When a page registered at `route` has a `paths` export, the handler calls\n// it and returns the JSON-serialized array as `application/json`. If the\n// `paths` export is missing or throws, the response is a descriptive 500.\n// This endpoint is only meant for the build pipeline — it is safe to leave\n// registered in production because no user-authored route should start with\n// `/__paths__/` (the build pipeline rejects any route that conflicts).\n\nimport { Hono } from \"hono\";\nimport { setContentSnapshot } from \"@takazudo/zfb/content\";\n\nimport type { FrameworkAdapter } from \"./framework.js\";\nimport type { ContentSnapshot } from \"./snapshot.js\";\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Heading metadata emitted by the MDX `headings` export (T4). Cross-ref:\n * `crates/zfb-content/src/mdx_jsx_emit.rs`. Optional on the page-module\n * shape — non-MDX pages won't carry it.\n */\nexport interface PageHeading {\n  readonly depth: number;\n  readonly slug: string;\n  readonly text: string;\n}\n\n/**\n * The shape every page module must export.\n *\n * - `default`: the JSX page component. Called with the props returned by\n *   `getStaticProps` (if exported) or the `props` from the matching\n *   `paths()` entry (for dynamic routes). The return value is fed straight\n *   to the framework adapter's `renderToString`. A dynamic route with no\n *   `paths()` export is called with `{ params: urlParams }` instead of\n *   `{}` — see `createPageRouter`'s JSDoc for the full componentInput\n *   derivation table.\n * - `prerender`: literal `false` opts a route OUT of build-time SSG (T5\n *   contract). The page router still serves it under the embedded V8 host\n *   so dev mode behaves identically; SSG callers filter the route list before\n *   driving the renderer.\n * - `contentType`: optional override for non-HTML routes (e.g.\n *   `application/xml` for `rss.xml.tsx`). Default is\n *   `text/html; charset=utf-8`. Cross-ref shipped #49.\n * - `headings`: optional list emitted by MDX (T4).\n * - `paths`: optional dynamic-route enumerator. Called at build time by\n *   the `__paths__` synthetic endpoint to produce the concrete URL list\n *   for this route template. May be async. Returns an array of\n *   `{ params, props? }` objects identical in shape to the Astro/zfb\n *   `paths()` contract.\n *   **Evaluated once per router instance** — the result is memoised and\n *   shared across the `/__paths__` handler and all per-page render\n *   requests. This matches the build-time-enumerator contract: every\n *   entry rendered within a single build sees the same paths() snapshot.\n *   Dev mode is safe because each file-save triggers a fresh bundle,\n *   which creates a new router instance with a clean memo.\n * - `getStaticProps`: optional async function for static routes that need\n *   to fetch data at build/render time. Called once per request (before\n *   `default`). Must return `{ props: Record<string, unknown> }`. The\n *   returned `props` are spread into the `default` component's props.\n */\nexport interface PageModule {\n  readonly default: (props: Record<string, unknown>) => unknown;\n  readonly prerender?: boolean;\n  readonly contentType?: string;\n  readonly headings?: readonly PageHeading[];\n  readonly paths?: () => unknown[] | Promise<unknown[]>;\n  readonly getStaticProps?: () => Promise<{ props: Record<string, unknown> }>;\n}\n\n/**\n * One page registered with the router.\n *\n * `route` is a Hono path pattern (e.g. `/`, `/blog/:slug`,\n * `/blog/page/:page`). `module` is a thunk so the bundle can use code\n * splitting if it wants to — today the bundler emits everything as one\n * ESM file and the thunk simply returns the already-loaded module.\n */\nexport interface PageDefinition {\n  readonly route: string;\n  readonly module: () => Promise<PageModule>;\n}\n\n/** Options accepted by [`createPageRouter`]. */\nexport interface CreatePageRouterOptions {\n  /** Pages to register. Order does not affect routing — Hono dispatches by path. */\n  readonly pages: readonly PageDefinition[];\n  /**\n   * In-memory content snapshot. Embedded into the bundle by T3; the\n   * router hands it to `zfb/content` so user pages reading content via\n   * `getCollection(...)` resolve synchronously from memory.\n   */\n  readonly contentSnapshot: ContentSnapshot;\n  /** Framework adapter pinning the SSR call. */\n  readonly framework: FrameworkAdapter;\n  /**\n   * When `true`, the 500 body for render errors includes the full JS stack\n   * trace. When `false`, only the message + route are included. When\n   * omitted, the runtime checks `globalThis.__zfb.ssrDebug` at request time:\n   * that flag is set by the embedded V8 build/dev host (`globals_shim.js`)\n   * and is absent on the production Cloudflare Workers runtime.\n   *\n   * Default is effectively OFF for production (no flag ⇒ message + route only).\n   * Useful for explicit injection in unit tests without global mutation.\n   */\n  readonly includeErrorStack?: boolean;\n}\n\n/**\n * Fetch-handler shape returned by [`createPageRouter`]. Shaped as a plain\n * function (not a Hono `app`) so the consumer's contract is exactly\n * \"Worker-style fetch handler\" with no leaked framework types.\n */\nexport type PageRouter = (request: Request) => Promise<Response>;\n\n// ---------------------------------------------------------------------------\n// Implementation\n// ---------------------------------------------------------------------------\n\n/**\n * Default content-type when a page module does not override.\n *\n * Aligned with #49's per-page `contentType` convention: the default\n * served for HTML pages is `text/html; charset=utf-8`. Tests pin this\n * verbatim because the embedded V8 host does NOT auto-set a charset.\n */\nconst DEFAULT_CONTENT_TYPE = \"text/html; charset=utf-8\";\n\n/**\n * Issue #530: prepend `<!doctype html>\\n` to SSR-rendered HTML bodies that\n * lack a doctype declaration, mirroring the guard in\n * `crates/zfb-build/src/renderer.rs::render_one_inner` (issue #524).\n *\n * Gate conditions (all must hold to prepend):\n *   1. `contentType` media-type (before `;`) is `text/html` (case-insensitive).\n *   2. The body, after stripping an optional UTF-8 BOM (U+FEFF) and leading\n *      ASCII whitespace, starts with `<html` (case-insensitive) — i.e. it is\n *      an `<html>`-rooted document, not XML / JSON / a fragment.\n *   3. The body (same stripped prefix) does NOT already begin with `<!doctype`\n *      (case-insensitive).\n *\n * Deliberately NOT shared with the Rust side — duplication of a 5-line guard\n * is the right call rather than introducing a new cross-language boundary.\n */\nfunction ensureHtml5Doctype(body: string, contentType: string): string {\n  const mediaType = contentType.split(\";\")[0]?.trim().toLowerCase();\n  if (mediaType !== \"text/html\") return body;\n  // Strip optional BOM and leading whitespace to inspect the root element.\n  const stripped = body.replace(/^/, \"\").trimStart();\n  if (!stripped.toLowerCase().startsWith(\"<!doctype\")) {\n    if (stripped.toLowerCase().startsWith(\"<html\")) {\n      return `<!doctype html>\\n${body}`;\n    }\n  }\n  return body;\n}\n\n/**\n * Evaluate `pathsFn` once per `routeKey`, sharing the result across all\n * concurrent and subsequent callers via a Promise stored in `memo`.\n *\n * Rejections are evicted from the memo so that a transient paths() failure\n * does not permanently poison the cache — the next request retries.\n */\nasync function getOrEvalPaths(\n  memo: Map<string, Promise<unknown[]>>,\n  routeKey: string,\n  pathsFn: () => unknown[] | Promise<unknown[]>,\n): Promise<unknown[]> {\n  const existing = memo.get(routeKey);\n  if (existing !== undefined) {\n    return existing;\n  }\n  const promise = Promise.resolve(pathsFn()).then(\n    (v) => v as unknown[],\n    (err) => {\n      // Evict on rejection so the next request retries.\n      memo.delete(routeKey);\n      return Promise.reject(err) as Promise<unknown[]>;\n    },\n  );\n  memo.set(routeKey, promise);\n  return promise;\n}\n\n/**\n * Build a page router for the SSG-first architecture (ADR-005).\n *\n * Side effects:\n *   1. Registers `opts.contentSnapshot` with the `zfb/content` module so\n *      `getCollection(name)` resolves from memory. Idempotent across\n *      calls — the latest snapshot wins (matches the documented dev-mode\n *      live-reload contract).\n *   2. Constructs an internal Hono app and registers a GET handler per\n *      `pages[i].route`. The handler imports the page module, calls\n *      `framework.renderToString(module.default({}))`, and returns the\n *      string in a `Response` with the appropriate `Content-Type`.\n *\n * Per-route `componentInput` (the object passed to `module.default(...)`) is\n * derived from the route pattern and the page module's exports:\n *   - Dynamic route + `paths()` export: match the URL params against the\n *     `paths()` entries and pass `{ params, ...props }` (404 on no match).\n *   - Static route + `getStaticProps()` export: pass the returned `props`.\n *   - Dynamic route with NO `paths()` export (e.g. a per-request SSR page\n *     whose slugs can't be enumerated ahead of time): pass `{ params:\n *     urlParams }` so the component still knows which URL params it is\n *     serving, rather than being invoked with `{}`.\n *   - Anything else (static route, no `getStaticProps`): pass `{}`.\n *\n * The returned function is a plain `(request) => Promise<Response>` so a\n * Worker entry point can `export default { fetch: createPageRouter(...) }`\n * directly.\n */\nexport function createPageRouter(opts: CreatePageRouterOptions): PageRouter {\n  setContentSnapshot(opts.contentSnapshot);\n\n  const app = new Hono();\n\n  // Build a lookup map: Hono route pattern → PageDefinition, for the\n  // `__paths__` synthetic endpoint below. The map is keyed on the `route`\n  // string exactly as the caller supplied it (e.g. \"/blog/:slug\").\n  const pagesByRoute = new Map<string, PageDefinition>();\n  for (const page of opts.pages) {\n    pagesByRoute.set(page.route, page);\n  }\n\n  // Per-router-instance memo for paths() results.\n  //\n  // Keyed on page.route (e.g. \"/blog/:slug\"). Stores the in-flight or\n  // settled Promise so that concurrent requests share one evaluation.\n  // Rejections are NOT cached: if paths() throws the Promise is removed\n  // from the map so the next request retries rather than re-propagating\n  // the same error indefinitely.\n  //\n  // Production SSR isolates evaluate paths() once per isolate, which\n  // matches the documented build-time-enumerator contract. Dev mode is\n  // safe because each re-bundle creates a fresh router instance\n  // (dev.rs reload_renderer), so stale paths() results never persist\n  // across a file-save cycle. Watch-time invalidation is explicitly\n  // out of scope per issue #507.\n  const pathsMemo = new Map<string, Promise<unknown[]>>();\n\n  // Sanity check: a user-authored route that happens to start with\n  // `/__paths__` (or a top-level catchall like `/:slug{.+}`) would\n  // shadow the synthetic endpoint registered below if Hono dispatched\n  // by registration order. We register `/__paths__/:routeKey{.+}` first\n  // (see directly below) but still warn on collisions so users do not\n  // ship a page that conflicts with the build pipeline's wire format.\n  for (const page of opts.pages) {\n    if (routeShadowsPathsEndpoint(page.route)) {\n      // Use console.warn so the message reaches the host's tail logs\n      // without bringing down the worker. The build pipeline's\n      // /__paths__ requests still resolve correctly because the\n      // synthetic handler is registered first.\n      // eslint-disable-next-line no-console\n      console.warn(\n        `[zfb-runtime] route \"${page.route}\" may shadow the synthetic /__paths__ endpoint; rename the page or use a more specific pattern`,\n      );\n    }\n  }\n\n  // -------------------------------------------------------------------------\n  // Synthetic `/__paths__/<encoded-route-key>` endpoint.\n  //\n  // Called by the Rust build pipeline (crates/zfb/src/render_pipeline.rs)\n  // to evaluate non-literal `paths()` exports at runtime. The route key is\n  // the Hono pattern for the page (e.g. `/blog/:slug`) percent-encoded so\n  // it survives in the URL path segment. The response is a JSON array of\n  // `{ params, props? }` objects identical to the `paths()` contract.\n  //\n  // Pattern: `/__paths__/:routeKey{.+}` — the `{.+}` quantifier (Hono's\n  // regex-segment syntax) allows slashes inside the route key so\n  // `/blog/:slug` decodes correctly from `/__paths__/%2Fblog%2F%3Aslug`.\n  //\n  // IMPORTANT: this handler is registered BEFORE user routes so a\n  // user-authored top-level catchall (e.g. `/:wildcard{.+}`) cannot\n  // shadow it — Hono dispatches in registration order.\n  // -------------------------------------------------------------------------\n  app.get(\"/__paths__/:routeKey{.+}\", async (c) => {\n    // Hono's `c.req.param(\"routeKey\")` already URL-decodes the captured\n    // segment when it contains a `%`, so a single decode is correct\n    // here — no explicit `decodeURIComponent` (that would be a\n    // double-decode and break literal `%` characters in route keys).\n    const routeKey = c.req.param(\"routeKey\");\n\n    const page = pagesByRoute.get(routeKey);\n    if (!page) {\n      return c.body(\n        `[zfb-runtime] /__paths__: no page registered for route key \"${routeKey}\"`,\n        404,\n        { \"Content-Type\": \"text/plain; charset=utf-8\" },\n      );\n    }\n\n    const mod = await page.module();\n    if (typeof mod.paths !== \"function\") {\n      return c.body(\n        `[zfb-runtime] /__paths__: page module for \"${routeKey}\" has no paths() export`,\n        404,\n        { \"Content-Type\": \"text/plain; charset=utf-8\" },\n      );\n    }\n\n    let result: unknown[];\n    try {\n      result = await getOrEvalPaths(pathsMemo, routeKey, mod.paths);\n    } catch (err) {\n      const msg = err instanceof Error ? err.message : String(err);\n      return c.body(`[zfb-runtime] /__paths__: paths() threw for \"${routeKey}\": ${msg}`, 500, {\n        \"Content-Type\": \"text/plain; charset=utf-8\",\n      });\n    }\n\n    return c.body(JSON.stringify(result), 200, {\n      \"Content-Type\": \"application/json; charset=utf-8\",\n    });\n  });\n\n  for (const page of opts.pages) {\n    // `app.all` (vs `app.get`) so SSR routes whose page handler dispatches\n    // by `request.method` (e.g. POST API endpoints like\n    // `pages/api/*.tsx`) actually reach the handler. The handler is then\n    // responsible for returning a method-appropriate status (e.g. 405 for\n    // an unsupported verb). With `app.get` the inner router would 404\n    // before the handler ever ran, leaving e.g. `POST /api/foo` looking\n    // identical to a missing route.\n    app.all(page.route, async (c) => {\n      const mod = await page.module();\n      if (typeof mod.default !== \"function\") {\n        // Surface as a 500 with a well-known message rather than letting\n        // Hono swallow the error into a generic body. T6's embedded V8\n        // host log-tail / source-map plumbing is what eventually projects\n        // page-side errors back to the user's TSX line; until then the\n        // pinned message is the contract this layer ships.\n        return c.body(\n          `[zfb-runtime] page module for \"${page.route}\" did not export a default component`,\n          500,\n          { \"Content-Type\": \"text/plain; charset=utf-8\" },\n        );\n      }\n\n      // For dynamic routes that export `paths()`, look up the concrete\n      // entry for this URL by matching the URL params against the\n      // paths() results. This implements the ADR-002 contract:\n      //   paths() → [{ params, props? }]\n      //   render(url) → find matching entry → pass { params, props } to default()\n      //\n      // For static routes (no `paths()` export, no URL params), we pass\n      // an empty object — the component signature has no required props.\n      // For dynamic routes whose URL params do not match any paths()\n      // entry, we return a 404 rather than rendering with empty props.\n      //\n      // Whether the route is dynamic is derived from the ROUTE PATTERN,\n      // not from the captured params: for an optional catchall\n      // (`/docs/:slug{.+}?`), Hono matches the bare `/docs` with NO\n      // params captured at all, so `Object.keys(c.req.param())` would\n      // be empty and the old gate skipped paths() entirely — rendering\n      // with `{}` instead of the entry whose `slug` is `[]`.\n      const declaredParams = routeParamSpecs(page.route);\n      const rawUrlParams = c.req.param() ?? {};\n      const urlParams: Record<string, string> = {};\n      for (const [k, v] of Object.entries(rawUrlParams)) {\n        // Unmatched optional params may surface as undefined — drop them\n        // so \"param absent\" is represented uniformly.\n        if (typeof v === \"string\") urlParams[k] = v;\n      }\n      const isDynamicRoute = declaredParams.length > 0;\n\n      let componentInput: Record<string, unknown> = {};\n\n      if (isDynamicRoute && typeof mod.paths === \"function\") {\n        let pathsResult: unknown;\n        try {\n          pathsResult = await getOrEvalPaths(pathsMemo, page.route, mod.paths);\n        } catch (err) {\n          const msg = err instanceof Error ? err.message : String(err);\n          return c.body(`[zfb-runtime] paths() threw for \"${page.route}\": ${msg}`, 500, {\n            \"Content-Type\": \"text/plain; charset=utf-8\",\n          });\n        }\n\n        if (!Array.isArray(pathsResult)) {\n          return c.body(`[zfb-runtime] paths() for \"${page.route}\" did not return an array`, 500, {\n            \"Content-Type\": \"text/plain; charset=utf-8\",\n          });\n        }\n\n        // Validate each entry's shape per-entry rather than using a bare\n        // cast — matches the strictness the Rust pipeline applies on the\n        // same wire format. Any malformed entry surfaces as a 500.\n        for (const entry of pathsResult) {\n          if (!isPathsEntry(entry)) {\n            return c.body(\n              `[zfb-runtime] paths() for \"${page.route}\" returned an entry without a valid params object`,\n              500,\n              { \"Content-Type\": \"text/plain; charset=utf-8\" },\n            );\n          }\n        }\n\n        // Find the entry whose params match the URL params for this\n        // request. For catchall params (e.g. slug for\n        // /docs/[...slug]), Hono returns a slash-joined string (e.g.\n        // \"guides/install\"), so we compare against the paths() entry's\n        // params.slug joined with \"/\".\n        //\n        // Matching iterates the params DECLARED by the route pattern so\n        // the zero-segment optional-catchall case is covered: when Hono\n        // matched `/docs` for `/docs/:slug{.+}?` no `slug` param exists\n        // in the URL, and the matching entry is the one whose param is\n        // the explicit empty array (`{ slug: [] }`).\n        const match = (pathsResult as PathsEntry[]).find((entry) => {\n          return declaredParams.every(({ name, optionalCatchall }) => {\n            const urlVal = urlParams[name];\n            const paramVal = entry.params[name];\n            if (urlVal === undefined) {\n              // Param absent from the URL: only valid for an optional\n              // catchall, and only against the explicit `[]` entry.\n              return optionalCatchall && Array.isArray(paramVal) && paramVal.length === 0;\n            }\n            if (Array.isArray(paramVal)) {\n              // catchall: paths() emits slug as string[] but Hono\n              // provides it as a \"/\"-joined string\n              return paramVal.join(\"/\") === urlVal;\n            }\n            return String(paramVal) === urlVal;\n          });\n        });\n\n        if (!match) {\n          // The URL params do not correspond to any paths() entry —\n          // this is the dev-mode equivalent of a build-time miss.\n          // Hono's `c.notFound()` returns the framework's default 404,\n          // which is cleaner than fabricating an empty-props render.\n          return c.notFound();\n        }\n\n        // Pass the paths() entry's props directly as component props\n        // (spread to top level, matching the Astro/zfb convention).\n        // Also include `params` so components can access URL params if\n        // needed, but individual prop keys from `props` win on collision.\n        componentInput = {\n          params: match.params,\n          ...(match.props ?? {}),\n        };\n      } else if (isDynamicRoute) {\n        // Dynamic route with no `paths()` export: the natural shape for a\n        // per-request SSR page whose slugs can't be enumerated ahead of\n        // time. Neither branch above applies (no paths() to match against,\n        // and getStaticProps only fires for static routes), so without this\n        // the component would be invoked with `{}` — no params, no\n        // diagnostic, and no way to know which slug it is serving. Pass the\n        // URL params through directly instead.\n        componentInput = { params: urlParams };\n      } else if (!isDynamicRoute && typeof mod.getStaticProps === \"function\") {\n        // Static route with `getStaticProps`: call it to fetch build-time\n        // data and pass the returned props to the default component. This\n        // supports the `export async function getStaticProps()` pattern\n        // used by static pages that need to query content collections (e.g.\n        // a homepage listing all blog posts via `getCollection(\"blog\")`).\n        let staticPropsResult: unknown;\n        try {\n          staticPropsResult = await mod.getStaticProps();\n        } catch (err) {\n          const msg = err instanceof Error ? err.message : String(err);\n          return c.body(`[zfb-runtime] getStaticProps() threw for \"${page.route}\": ${msg}`, 500, {\n            \"Content-Type\": \"text/plain; charset=utf-8\",\n          });\n        }\n        if (\n          typeof staticPropsResult !== \"object\" ||\n          staticPropsResult === null ||\n          !(\"props\" in staticPropsResult)\n        ) {\n          return c.body(\n            `[zfb-runtime] getStaticProps() for \"${page.route}\" must return { props: {...} }`,\n            500,\n            { \"Content-Type\": \"text/plain; charset=utf-8\" },\n          );\n        }\n        componentInput = (staticPropsResult as { props: Record<string, unknown> }).props;\n      }\n\n      // `await` so async page modules (e.g. API routes typed as\n      // `(): Promise<Response>`) resolve before we inspect the value.\n      // For sync pages that return a VNode/string the await is a no-op.\n      //\n      // Wrapped in a try/catch so that any error thrown by the component\n      // or by renderToString surfaces as a descriptive 500 rather than\n      // escaping to Hono's generic error handler (which discards the real\n      // message). Mirrors the getStaticProps catch above.\n      try {\n        const result = await mod.default(componentInput);\n        // API route short-circuit: a page module that returns a Response\n        // directly (e.g. `pages/api/*.tsx` handlers that use Web Fetch\n        // primitives instead of returning JSX) is responsible for its own\n        // status, headers, and body — return it as-is rather than running\n        // it through the framework SSR path. A `return` from inside a\n        // `try` does not trigger the `catch`, so this passes through\n        // correctly without special-casing.\n        if (result instanceof Response) {\n          return result;\n        }\n        // Non-HTML routes (e.g. `sitemap.xml.tsx`, `feed.xml.tsx`) commonly\n        // return their body as a pre-serialised `string` instead of a\n        // VNode. Routing those through `framework.renderToString` would\n        // HTML-escape the angle brackets and ampersands, producing\n        // garbage XML. Pass strings through verbatim; only wrap actual\n        // VNodes.\n        const html = typeof result === \"string\" ? result : opts.framework.renderToString(result);\n        const contentType = mod.contentType ?? DEFAULT_CONTENT_TYPE;\n        return c.body(ensureHtml5Doctype(html, contentType), 200, { \"Content-Type\": contentType });\n      } catch (err) {\n        const msg = err instanceof Error ? err.message : String(err);\n        // __zfb.ssrDebug is set only by the embedded V8 build/dev host\n        // (globals_shim.js), never by the production Workers runtime.\n        const includeStack =\n          opts.includeErrorStack ??\n          (globalThis as { __zfb?: { ssrDebug?: boolean } }).__zfb?.ssrDebug === true;\n        const stack = includeStack && err instanceof Error && err.stack ? `\\n${err.stack}` : \"\";\n        return c.body(`[zfb-runtime] render threw for \"${page.route}\": ${msg}${stack}`, 500, {\n          \"Content-Type\": \"text/plain; charset=utf-8\",\n        });\n      }\n    });\n  }\n\n  // Hono's `app.fetch` returns `Response | Promise<Response>`. The\n  // public router contract is unconditionally async; using an `async`\n  // wrapper (rather than `Promise.resolve(...)`) ensures any\n  // synchronous throw inside `app.fetch` is converted to a rejected\n  // promise instead of escaping the caller's `await`.\n  return async (request) => await app.fetch(request);\n}\n\n/**\n * Shape of one entry produced by a page's `paths()` export. The\n * `params` object is required (every entry needs to identify the URL\n * it represents); `props` is optional (the page may render purely from\n * the URL params).\n */\ninterface PathsEntry {\n  readonly params: Record<string, unknown>;\n  readonly props?: Record<string, unknown>;\n}\n\n/**\n * Type guard for one `paths()` entry. Mirrors the strictness of the\n * Rust pipeline's `paths()` resolver — every entry must be a non-null\n * object whose `params` is itself a non-null object.\n */\nfunction isPathsEntry(x: unknown): x is PathsEntry {\n  if (typeof x !== \"object\" || x === null) return false;\n  const params = (x as { params?: unknown }).params;\n  return typeof params === \"object\" && params !== null;\n}\n\n/**\n * One param declared by a Hono route pattern. `optionalCatchall` is\n * `true` for the `:name{.+}?` form (file-system `[[...name]]`), whose\n * zero-segment match captures no param at all.\n */\ninterface RouteParamSpec {\n  readonly name: string;\n  readonly optionalCatchall: boolean;\n}\n\n/**\n * Parse the params declared by a Hono route pattern (the `route` string\n * the build pipeline registers, e.g. `/blog/:slug`, `/docs/:slug{.+}`,\n * `/docs/:slug{.+}?`). Static routes return an empty list.\n *\n * Only the pattern shapes emitted by `bracket_to_hono` (zfb-build) are\n * recognised — `:name`, `:name{.+}`, `:name{.+}?` — which is the entire\n * grammar the file router produces.\n */\nfunction routeParamSpecs(route: string): RouteParamSpec[] {\n  const specs: RouteParamSpec[] = [];\n  for (const seg of route.split(\"/\")) {\n    if (!seg.startsWith(\":\")) continue;\n    const optionalCatchall = seg.endsWith(\"?\");\n    const body = optionalCatchall ? seg.slice(1, -1) : seg.slice(1);\n    const braceIdx = body.indexOf(\"{\");\n    const name = braceIdx === -1 ? body : body.slice(0, braceIdx);\n    if (name.length > 0) {\n      specs.push({ name, optionalCatchall });\n    }\n  }\n  return specs;\n}\n\n/**\n * Heuristic check for user-authored routes that may shadow the\n * synthetic `/__paths__/<encoded-route-key>` endpoint.\n *\n * Returns true when the route literal contains `/__paths__` (an\n * obvious collision) or when its first segment is a Hono catchall\n * (`:name{.+}`, optionally `:name{.+}?`) or a file-system catchall\n * (`[...name]` / `[[...name]]`) at the root — those would match\n * `/__paths__/...` once Hono dispatches to them.\n */\nfunction routeShadowsPathsEndpoint(route: string): boolean {\n  if (route.includes(\"/__paths__\")) {\n    return true;\n  }\n  // Strip the leading slash and look at the first segment only —\n  // anything deeper cannot match `/__paths__` because the literal\n  // first segment differs.\n  const firstSeg = route.replace(/^\\/+/, \"\").split(\"/\")[0] ?? \"\";\n  // Hono regex-quantifier catchall: `:name{.+}` / optional `:name{.+}?`.\n  if (/^:[A-Za-z_][\\w]*\\{\\.[+*]\\}\\??$/.test(firstSeg)) {\n    return true;\n  }\n  // File-system catchall (pre-bracket-to-hono): `[...name]` / `[[...name]]`.\n  if (/^\\[\\.\\.\\.[A-Za-z_][\\w]*\\]$/.test(firstSeg)) {\n    return true;\n  }\n  if (/^\\[\\[\\.\\.\\.[A-Za-z_][\\w]*\\]\\]$/.test(firstSeg)) {\n    return true;\n  }\n  return false;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takazudo/zfb-runtime",
-  "version": "0.1.0-next.76",
+  "version": "0.1.0-next.78",
   "private": false,
   "type": "module",
   "description": "JavaScript runtime for zfb static sites — Hono-backed page router, content snapshots, and client-side hydration.",
@@ -75,7 +75,7 @@
   },
   "peerDependencies": {
     "react": "^19.2.3",
-    "@takazudo/zfb": "0.1.0-next.76"
+    "@takazudo/zfb": "0.1.0-next.78"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -89,7 +89,7 @@
     "react": "^19.2.3",
     "typescript": "^5.9.0",
     "vitest": "^2.1.9",
-    "@takazudo/zfb": "0.1.0-next.76"
+    "@takazudo/zfb": "0.1.0-next.78"
   },
   "scripts": {
     "build": "tsc",