nukejs 0.0.3 → 0.0.5

package/dist/bundle.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/bundle.ts"],
-  "sourcesContent": ["/**\r\n * bundle.ts \u2014 NukeJS Client Runtime\r\n *\r\n * This file is compiled by esbuild into /__n.js and served to every page.\r\n * It provides:\r\n *\r\n *   initRuntime(data)              \u2014 called once per page load to hydrate\r\n *                                    \"use client\" components and wire up SPA nav\r\n *   setupLocationChangeMonitor()   \u2014 patches history.pushState/replaceState so\r\n *                                    SPA navigation fires a 'locationchange' event\r\n *\r\n * Hydration model (partial hydration):\r\n *   - The server renders the full page to HTML, wrapping each client component\r\n *     in a <span data-hydrate-id=\"cc_\u2026\" data-hydrate-props=\"\u2026\"> marker.\r\n *   - initRuntime loads the matching JS bundle for each marker and calls\r\n *     hydrateRoot() on it, letting React take over just that subtree.\r\n *   - Props serialized by the server may include nested React elements\r\n *     (serialized as { __re: 'html'|'client', \u2026 }), which are reconstructed\r\n *     back into React.createElement calls before mounting.\r\n *\r\n * SPA navigation:\r\n *   - Link clicks / programmatic navigation dispatch a 'locationchange' event.\r\n *   - The handler fetches the target URL as HTML, diffs the #app container,\r\n *     unmounts the old React roots, and re-hydrates the new ones.\r\n *   - HMR navigations add ?__hmr=1 so the server skips client-SSR (faster).\r\n */\r\n\r\n// \u2500\u2500\u2500 History patch \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Patches history.pushState and history.replaceState to fire a custom\r\n * 'locationchange' event on window.  Also listens to 'popstate' for\r\n * back/forward navigation.\r\n *\r\n * This must be called after initRuntime sets up the navigation listener so\r\n * there's no race between the event firing and the listener being registered.\r\n */\r\nexport function setupLocationChangeMonitor(): void {\r\n  const originalPushState = window.history.pushState.bind(window.history);\r\n  const originalReplaceState = window.history.replaceState.bind(window.history);\r\n\r\n  const dispatch = (href?: any) =>\r\n    window.dispatchEvent(new CustomEvent('locationchange', { detail: { href } }));\r\n\r\n  window.history.pushState = function (...args) {\r\n    originalPushState(...args);\r\n    dispatch(args[2]); // args[2] is the URL\r\n  };\r\n\r\n  window.history.replaceState = function (...args) {\r\n    originalReplaceState(...args);\r\n    dispatch(args[2]);\r\n  };\r\n\r\n  // Back/forward navigation via the browser's native UI.\r\n  window.addEventListener('popstate', () => dispatch(window.location.pathname));\r\n}\r\n\r\n// \u2500\u2500\u2500 Logger \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\ntype ClientDebugLevel = 'silent' | 'error' | 'info' | 'verbose';\r\n\r\n/**\r\n * Returns a thin logger whose methods are no-ops unless `level` allows them.\r\n * The server embeds the active debug level in the __n_data JSON blob so the\r\n * client respects the same setting as the server.\r\n */\r\nfunction makeLogger(level: ClientDebugLevel) {\r\n  return {\r\n    verbose: (...a: any[]) => { if (level === 'verbose') console.log(...a); },\r\n    info: (...a: any[]) => { if (level === 'verbose' || level === 'info') console.log(...a); },\r\n    warn: (...a: any[]) => { if (level === 'verbose' || level === 'info') console.warn(...a); },\r\n    error: (...a: any[]) => { if (level !== 'silent') console.error(...a); },\r\n  };\r\n}\r\n\r\n// \u2500\u2500\u2500 Serialized node types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/** The wire format for React elements embedded in hydration props. */\r\ntype SerializedNode =\r\n  | null\r\n  | undefined\r\n  | string\r\n  | number\r\n  | boolean\r\n  | SerializedNode[]\r\n  | { __re: 'html'; tag: string; props: Record<string, any> }   // native DOM element\r\n  | { __re: 'client'; componentId: string; props: Record<string, any> } // client component\r\n  | Record<string, any>;                                             // plain object\r\n\r\ntype ModuleMap = Map<string, any>; // componentId \u2192 default export\r\n\r\n// \u2500\u2500\u2500 Prop reconstruction \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Recursively turns the server's serialized node tree back into real React\r\n * elements so they can be passed as props to hydrated components.\r\n *\r\n * The server serializes JSX passed as props (e.g. `<Button icon={<Icon />}>`)\r\n * into a JSON-safe format.  This function reverses that process.\r\n */\r\nasync function reconstructElement(node: SerializedNode, mods: ModuleMap): Promise<any> {\r\n  if (node === null || node === undefined) return node;\r\n  if (typeof node !== 'object') return node; // primitive \u2014 pass through\r\n\r\n  if (Array.isArray(node)) {\r\n    const items = await Promise.all(node.map(n => reconstructElement(n, mods)));\r\n    // Add index-based keys to any React elements in the array so React doesn't\r\n    // warn about \"Each child in a list should have a unique key prop\".\r\n    const React = await import('react');\r\n    return items.map((el, i) =>\r\n      el && typeof el === 'object' && el.$$typeof\r\n        ? React.default.cloneElement(el, { key: el.key ?? i })\r\n        : el,\r\n    );\r\n  }\r\n\r\n  // Client component \u2014 look up the loaded module by ID.\r\n  if ((node as any).__re === 'client') {\r\n    const n = node as { __re: 'client'; componentId: string; props: Record<string, any> };\r\n    const Comp = mods.get(n.componentId);\r\n    if (!Comp) return null;\r\n    const React = await import('react');\r\n    return React.default.createElement(Comp, await reconstructProps(n.props, mods));\r\n  }\r\n\r\n  // Native HTML element (e.g. <div>, <span>).\r\n  if ((node as any).__re === 'html') {\r\n    const n = node as { __re: 'html'; tag: string; props: Record<string, any> };\r\n    const React = await import('react');\r\n    return React.default.createElement(n.tag, await reconstructProps(n.props, mods));\r\n  }\r\n\r\n  // Plain object \u2014 reconstruct each value.\r\n  return node;\r\n}\r\n\r\n/** Reconstructs every value in a props object, handling nested serialized nodes. */\r\nasync function reconstructProps(\r\n  props: Record<string, any> | null | undefined,\r\n  mods: ModuleMap,\r\n): Promise<Record<string, any>> {\r\n  if (!props || typeof props !== 'object' || Array.isArray(props))\r\n    return reconstructElement(props as any, mods);\r\n\r\n  const out: Record<string, any> = {};\r\n  for (const [k, v] of Object.entries(props))\r\n    out[k] = await reconstructElement(v, mods);\r\n  return out;\r\n}\r\n\r\n// \u2500\u2500\u2500 Module loading \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Dynamically imports each client component bundle from /__client-component/.\r\n * All fetches are issued in parallel; failures are logged but do not abort\r\n * the rest of the hydration pass.\r\n *\r\n * @param bust  Optional cache-busting suffix appended as `?t=<bust>`.\r\n *              Used during HMR navigation to bypass the module cache.\r\n */\r\nasync function loadModules(\r\n  ids: string[],\r\n  log: ReturnType<typeof makeLogger>,\r\n  bust = '',\r\n): Promise<ModuleMap> {\r\n  const mods: ModuleMap = new Map();\r\n  await Promise.all(\r\n    ids.map(async (id) => {\r\n      try {\r\n        const url = `/__client-component/${id}.js` + (bust ? `?t=${bust}` : '');\r\n        const m = await import(url);\r\n        mods.set(id, m.default);\r\n        log.verbose('\u2713 Loaded:', id);\r\n      } catch (err) {\r\n        log.error('\u2717 Load failed:', id, err);\r\n      }\r\n    }),\r\n  );\r\n  return mods;\r\n}\r\n\r\n// \u2500\u2500\u2500 Root mounting \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/** All active React roots \u2014 tracked so they can be unmounted before navigation. */\r\ntype ReactRoot = { unmount(): void };\r\nconst activeRoots: ReactRoot[] = [];\r\n\r\n/**\r\n * Finds every `[data-hydrate-id]` span in the document and either:\r\n *   - hydrateRoot()  \u2014 on initial page load (server HTML already present)\r\n *   - createRoot()   \u2014 after SPA navigation (innerHTML was set by us)\r\n *\r\n * Nested markers (a client component inside another client component) are\r\n * skipped here because the parent's React tree will handle its children.\r\n */\r\nasync function mountNodes(\r\n  mods: ModuleMap,\r\n  log: ReturnType<typeof makeLogger>,\r\n  isNavigation: boolean,\r\n): Promise<void> {\r\n  const { hydrateRoot, createRoot } = await import('react-dom/client');\r\n  const React = await import('react');\r\n\r\n  const nodes = document.querySelectorAll<HTMLElement>('[data-hydrate-id]');\r\n  log.verbose('Found', nodes.length, 'hydration point(s)');\r\n\r\n  for (const node of nodes) {\r\n    // Skip nested markers \u2014 the outer component owns its children.\r\n    if (node.parentElement?.closest('[data-hydrate-id]')) continue;\r\n\r\n    const id = node.getAttribute('data-hydrate-id')!;\r\n    const Comp = mods.get(id);\r\n    if (!Comp) { log.warn('No module for', id); continue; }\r\n\r\n    // Deserialize props from the data attribute (JSON set by the server).\r\n    let rawProps: Record<string, any> = {};\r\n    try {\r\n      rawProps = JSON.parse(node.getAttribute('data-hydrate-props') || '{}');\r\n    } catch (e) {\r\n      log.error('Props parse error for', id, e);\r\n    }\r\n\r\n    try {\r\n      const element = React.default.createElement(Comp, await reconstructProps(rawProps, mods));\r\n\r\n      // hydrateRoot reconciles React's virtual DOM against the server-rendered\r\n      // HTML without fully re-rendering.  createRoot replaces the content\r\n      // entirely \u2014 safe after navigation because we set innerHTML ourselves.\r\n      const root = isNavigation ? createRoot(node) : hydrateRoot(node, element);\r\n      if (isNavigation) (root as any).render(element);\r\n      activeRoots.push(root);\r\n      log.verbose('\u2713 Mounted:', id);\r\n    } catch (err) {\r\n      log.error('\u2717 Mount failed:', id, err);\r\n    }\r\n  }\r\n}\r\n\r\n// \u2500\u2500\u2500 SPA navigation \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Listens for 'locationchange' events (fired by setupLocationChangeMonitor\r\n * or by Link clicks) and performs a soft navigation:\r\n *\r\n *   1. Fetch the target URL as HTML (adds ?__hmr=1 during HMR updates so the\r\n *      server skips client-side SSR for a faster response).\r\n *   2. Parse the response with DOMParser.\r\n *   3. Replace #app innerHTML and __n_data.\r\n *   4. Unmount old React roots, then re-hydrate new ones.\r\n *   5. Scroll to top.\r\n *\r\n * Falls back to a full page reload if anything goes wrong.\r\n */\r\n/**\r\n * Syncs attributes from a parsed element onto the live document element.\r\n * Adds/updates attributes present in `next`, and removes any that were set\r\n * on `live` but are absent in `next` (so stale bodyAttrs/htmlAttrs are cleared).\r\n */\r\nfunction syncAttrs(live: Element, next: Element): void {\r\n  // Apply / update attributes from the new document.\r\n  for (const { name, value } of Array.from(next.attributes)) {\r\n    live.setAttribute(name, value);\r\n  }\r\n  // Remove attributes that no longer exist in the new document.\r\n  for (const { name } of Array.from(live.attributes)) {\r\n    if (!next.hasAttribute(name)) live.removeAttribute(name);\r\n  }\r\n}\r\n\r\nfunction setupNavigation(log: ReturnType<typeof makeLogger>): void {\r\n  window.addEventListener('locationchange', async ({ detail: { href, hmr } }: any) => {\r\n    try {\r\n      // Append ?__hmr=1 for HMR-triggered reloads so SSR skips the slower\r\n      // client-component renderToString path.\r\n      const fetchUrl = hmr\r\n        ? href + (href.includes('?') ? '&' : '?') + '__hmr=1'\r\n        : href;\r\n\r\n      const response = await fetch(fetchUrl, { headers: { Accept: 'text/html' } });\r\n      if (!response.ok) {\r\n        log.error('Navigation fetch failed:', response.status);\r\n        return;\r\n      }\r\n\r\n      const parser = new DOMParser();\r\n      const doc = parser.parseFromString(await response.text(), 'text/html');\r\n      const newApp = doc.getElementById('app');\r\n      const currApp = document.getElementById('app');\r\n      if (!newApp || !currApp) return;\r\n\r\n      // Tear down existing React trees before mutating the DOM \u2014 avoids React\r\n      // warnings about unmounting from a detached node.\r\n      activeRoots.splice(0).forEach(r => r.unmount());\r\n\r\n      // Swap content in-place (avoids a full document.write / navigation).\r\n      currApp.innerHTML = newApp.innerHTML;\r\n\r\n      // Update the runtime data blob so subsequent navigations use the new page's\r\n      // client component IDs.\r\n      const newDataEl = doc.getElementById('__n_data');\r\n      const currDataEl = document.getElementById('__n_data');\r\n      if (newDataEl && currDataEl) currDataEl.textContent = newDataEl.textContent;\r\n\r\n      // Update <title>.\r\n      const newTitle = doc.querySelector('title');\r\n      if (newTitle) document.title = newTitle.textContent ?? '';\r\n\r\n      // Sync <html> attributes (e.g. lang, class, style from useHtml({ htmlAttrs })).\r\n      syncAttrs(document.documentElement, doc.documentElement);\r\n\r\n      // Sync <body> attributes (e.g. style, class from useHtml({ bodyAttrs })).\r\n      syncAttrs(document.body, doc.body);\r\n\r\n      const navData = JSON.parse(currDataEl?.textContent ?? '{}') as RuntimeData;\r\n      log.info('\uD83D\uDD04 Route \u2192', href, '\u2014 mounting', navData.hydrateIds?.length ?? 0, 'component(s)');\r\n\r\n      // Load bundles with a cache-buster timestamp so stale modules are evicted.\r\n      const mods = await loadModules(navData.allIds ?? [], log, String(Date.now()));\r\n      await mountNodes(mods, log, true);\r\n\r\n      window.scrollTo(0, 0);\r\n      log.info('\uD83C\uDF89 Navigation complete:', href);\r\n    } catch (err) {\r\n      log.error('Navigation error, falling back to full reload:', err);\r\n      window.location.href = href;\r\n    }\r\n  });\r\n}\r\n\r\n// \u2500\u2500\u2500 Public API \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/** Shape of the JSON blob embedded as #__n_data in every SSR page. */\r\nexport interface RuntimeData {\r\n  /** IDs of client components actually rendered on this page (subset of allIds). */\r\n  hydrateIds: string[];\r\n  /** All client component IDs reachable from this page, including layouts.\r\n   *  Pre-loaded so SPA navigations to related pages feel instant. */\r\n  allIds: string[];\r\n  url: string;\r\n  params: Record<string, any>;\r\n  debug: ClientDebugLevel;\r\n}\r\n\r\n/**\r\n * Bootstraps the NukeJS client runtime.\r\n *\r\n * Called once per page load from the inline <script type=\"module\"> injected\r\n * by the SSR renderer:\r\n *\r\n * ```js\r\n * const { initRuntime } = await import('nukejs');\r\n * const data = JSON.parse(document.getElementById('__n_data').textContent);\r\n * await initRuntime(data);\r\n * ```\r\n *\r\n * Order of operations:\r\n *   1. Create the logger at the configured debug level.\r\n *   2. Wire up SPA navigation listener.\r\n *   3. Load all client component bundles in parallel.\r\n *   4. Hydrate every [data-hydrate-id] node.\r\n *   5. Patch history.pushState/replaceState so Link clicks trigger navigation.\r\n */\r\nexport async function initRuntime(data: RuntimeData): Promise<void> {\r\n  const log = makeLogger(data.debug ?? 'silent');\r\n\r\n  log.info('\uD83D\uDE80 Partial hydration:', data.hydrateIds.length, 'root component(s)');\r\n\r\n  // Set up navigation first so any 'locationchange' fired during hydration\r\n  // is captured.\r\n  setupNavigation(log);\r\n\r\n  // Load all component bundles (not just hydrateIds) so SPA navigations can\r\n  // mount components for other pages without an extra network round-trip.\r\n  const mods = await loadModules(data.allIds, log);\r\n  await mountNodes(mods, log, false);\r\n\r\n  log.info('\uD83C\uDF89 Done!');\r\n\r\n  // Patch history last so pushState calls during hydration (e.g. redirect\r\n  // side-effects) don't trigger a navigation before roots are ready.\r\n  setupLocationChangeMonitor();\r\n}"],
-  "mappings": "AAqCO,SAAS,6BAAmC;AACjD,QAAM,oBAAoB,OAAO,QAAQ,UAAU,KAAK,OAAO,OAAO;AACtE,QAAM,uBAAuB,OAAO,QAAQ,aAAa,KAAK,OAAO,OAAO;AAE5E,QAAM,WAAW,CAAC,SAChB,OAAO,cAAc,IAAI,YAAY,kBAAkB,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AAE9E,SAAO,QAAQ,YAAY,YAAa,MAAM;AAC5C,sBAAkB,GAAG,IAAI;AACzB,aAAS,KAAK,CAAC,CAAC;AAAA,EAClB;AAEA,SAAO,QAAQ,eAAe,YAAa,MAAM;AAC/C,yBAAqB,GAAG,IAAI;AAC5B,aAAS,KAAK,CAAC,CAAC;AAAA,EAClB;AAGA,SAAO,iBAAiB,YAAY,MAAM,SAAS,OAAO,SAAS,QAAQ,CAAC;AAC9E;AAWA,SAAS,WAAW,OAAyB;AAC3C,SAAO;AAAA,IACL,SAAS,IAAI,MAAa;AAAE,UAAI,UAAU,UAAW,SAAQ,IAAI,GAAG,CAAC;AAAA,IAAG;AAAA,IACxE,MAAM,IAAI,MAAa;AAAE,UAAI,UAAU,aAAa,UAAU,OAAQ,SAAQ,IAAI,GAAG,CAAC;AAAA,IAAG;AAAA,IACzF,MAAM,IAAI,MAAa;AAAE,UAAI,UAAU,aAAa,UAAU,OAAQ,SAAQ,KAAK,GAAG,CAAC;AAAA,IAAG;AAAA,IAC1F,OAAO,IAAI,MAAa;AAAE,UAAI,UAAU,SAAU,SAAQ,MAAM,GAAG,CAAC;AAAA,IAAG;AAAA,EACzE;AACF;AA2BA,eAAe,mBAAmB,MAAsB,MAA+B;AACrF,MAAI,SAAS,QAAQ,SAAS,OAAW,QAAO;AAChD,MAAI,OAAO,SAAS,SAAU,QAAO;AAErC,MAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,UAAM,QAAQ,MAAM,QAAQ,IAAI,KAAK,IAAI,OAAK,mBAAmB,GAAG,IAAI,CAAC,CAAC;AAG1E,UAAM,QAAQ,MAAM,OAAO,OAAO;AAClC,WAAO,MAAM;AAAA,MAAI,CAAC,IAAI,MACpB,MAAM,OAAO,OAAO,YAAY,GAAG,WAC/B,MAAM,QAAQ,aAAa,IAAI,EAAE,KAAK,GAAG,OAAO,EAAE,CAAC,IACnD;AAAA,IACN;AAAA,EACF;AAGA,MAAK,KAAa,SAAS,UAAU;AACnC,UAAM,IAAI;AACV,UAAM,OAAO,KAAK,IAAI,EAAE,WAAW;AACnC,QAAI,CAAC,KAAM,QAAO;AAClB,UAAM,QAAQ,MAAM,OAAO,OAAO;AAClC,WAAO,MAAM,QAAQ,cAAc,MAAM,MAAM,iBAAiB,EAAE,OAAO,IAAI,CAAC;AAAA,EAChF;AAGA,MAAK,KAAa,SAAS,QAAQ;AACjC,UAAM,IAAI;AACV,UAAM,QAAQ,MAAM,OAAO,OAAO;AAClC,WAAO,MAAM,QAAQ,cAAc,EAAE,KAAK,MAAM,iBAAiB,EAAE,OAAO,IAAI,CAAC;AAAA,EACjF;AAGA,SAAO;AACT;AAGA,eAAe,iBACb,OACA,MAC8B;AAC9B,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK;AAC5D,WAAO,mBAAmB,OAAc,IAAI;AAE9C,QAAM,MAA2B,CAAC;AAClC,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,KAAK;AACvC,QAAI,CAAC,IAAI,MAAM,mBAAmB,GAAG,IAAI;AAC3C,SAAO;AACT;AAYA,eAAe,YACb,KACA,KACA,OAAO,IACa;AACpB,QAAM,OAAkB,oBAAI,IAAI;AAChC,QAAM,QAAQ;AAAA,IACZ,IAAI,IAAI,OAAO,OAAO;AACpB,UAAI;AACF,cAAM,MAAM,uBAAuB,EAAE,SAAS,OAAO,MAAM,IAAI,KAAK;AACpE,cAAM,IAAI,MAAM,OAAO;AACvB,aAAK,IAAI,IAAI,EAAE,OAAO;AACtB,YAAI,QAAQ,kBAAa,EAAE;AAAA,MAC7B,SAAS,KAAK;AACZ,YAAI,MAAM,uBAAkB,IAAI,GAAG;AAAA,MACrC;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAMA,MAAM,cAA2B,CAAC;AAUlC,eAAe,WACb,MACA,KACA,cACe;AACf,QAAM,EAAE,aAAa,WAAW,IAAI,MAAM,OAAO,kBAAkB;AACnE,QAAM,QAAQ,MAAM,OAAO,OAAO;AAElC,QAAM,QAAQ,SAAS,iBAA8B,mBAAmB;AACxE,MAAI,QAAQ,SAAS,MAAM,QAAQ,oBAAoB;AAEvD,aAAW,QAAQ,OAAO;AAExB,QAAI,KAAK,eAAe,QAAQ,mBAAmB,EAAG;AAEtD,UAAM,KAAK,KAAK,aAAa,iBAAiB;AAC9C,UAAM,OAAO,KAAK,IAAI,EAAE;AACxB,QAAI,CAAC,MAAM;AAAE,UAAI,KAAK,iBAAiB,EAAE;AAAG;AAAA,IAAU;AAGtD,QAAI,WAAgC,CAAC;AACrC,QAAI;AACF,iBAAW,KAAK,MAAM,KAAK,aAAa,oBAAoB,KAAK,IAAI;AAAA,IACvE,SAAS,GAAG;AACV,UAAI,MAAM,yBAAyB,IAAI,CAAC;AAAA,IAC1C;AAEA,QAAI;AACF,YAAM,UAAU,MAAM,QAAQ,cAAc,MAAM,MAAM,iBAAiB,UAAU,IAAI,CAAC;AAKxF,YAAM,OAAO,eAAe,WAAW,IAAI,IAAI,YAAY,MAAM,OAAO;AACxE,UAAI,aAAc,CAAC,KAAa,OAAO,OAAO;AAC9C,kBAAY,KAAK,IAAI;AACrB,UAAI,QAAQ,mBAAc,EAAE;AAAA,IAC9B,SAAS,KAAK;AACZ,UAAI,MAAM,wBAAmB,IAAI,GAAG;AAAA,IACtC;AAAA,EACF;AACF;AAsBA,SAAS,UAAU,MAAe,MAAqB;AAErD,aAAW,EAAE,MAAM,MAAM,KAAK,MAAM,KAAK,KAAK,UAAU,GAAG;AACzD,SAAK,aAAa,MAAM,KAAK;AAAA,EAC/B;AAEA,aAAW,EAAE,KAAK,KAAK,MAAM,KAAK,KAAK,UAAU,GAAG;AAClD,QAAI,CAAC,KAAK,aAAa,IAAI,EAAG,MAAK,gBAAgB,IAAI;AAAA,EACzD;AACF;AAEA,SAAS,gBAAgB,KAA0C;AACjE,SAAO,iBAAiB,kBAAkB,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,MAAW;AAClF,QAAI;AAGF,YAAM,WAAW,MACb,QAAQ,KAAK,SAAS,GAAG,IAAI,MAAM,OAAO,YAC1C;AAEJ,YAAM,WAAW,MAAM,MAAM,UAAU,EAAE,SAAS,EAAE,QAAQ,YAAY,EAAE,CAAC;AAC3E,UAAI,CAAC,SAAS,IAAI;AAChB,YAAI,MAAM,4BAA4B,SAAS,MAAM;AACrD;AAAA,MACF;AAEA,YAAM,SAAS,IAAI,UAAU;AAC7B,YAAM,MAAM,OAAO,gBAAgB,MAAM,SAAS,KAAK,GAAG,WAAW;AACrE,YAAM,SAAS,IAAI,eAAe,KAAK;AACvC,YAAM,UAAU,SAAS,eAAe,KAAK;AAC7C,UAAI,CAAC,UAAU,CAAC,QAAS;AAIzB,kBAAY,OAAO,CAAC,EAAE,QAAQ,OAAK,EAAE,QAAQ,CAAC;AAG9C,cAAQ,YAAY,OAAO;AAI3B,YAAM,YAAY,IAAI,eAAe,UAAU;AAC/C,YAAM,aAAa,SAAS,eAAe,UAAU;AACrD,UAAI,aAAa,WAAY,YAAW,cAAc,UAAU;AAGhE,YAAM,WAAW,IAAI,cAAc,OAAO;AAC1C,UAAI,SAAU,UAAS,QAAQ,SAAS,eAAe;AAGvD,gBAAU,SAAS,iBAAiB,IAAI,eAAe;AAGvD,gBAAU,SAAS,MAAM,IAAI,IAAI;AAEjC,YAAM,UAAU,KAAK,MAAM,YAAY,eAAe,IAAI;AAC1D,UAAI,KAAK,0BAAc,MAAM,mBAAc,QAAQ,YAAY,UAAU,GAAG,cAAc;AAG1F,YAAM,OAAO,MAAM,YAAY,QAAQ,UAAU,CAAC,GAAG,KAAK,OAAO,KAAK,IAAI,CAAC,CAAC;AAC5E,YAAM,WAAW,MAAM,KAAK,IAAI;AAEhC,aAAO,SAAS,GAAG,CAAC;AACpB,UAAI,KAAK,kCAA2B,IAAI;AAAA,IAC1C,SAAS,KAAK;AACZ,UAAI,MAAM,kDAAkD,GAAG;AAC/D,aAAO,SAAS,OAAO;AAAA,IACzB;AAAA,EACF,CAAC;AACH;AAmCA,eAAsB,YAAY,MAAkC;AAClE,QAAM,MAAM,WAAW,KAAK,SAAS,QAAQ;AAE7C,MAAI,KAAK,gCAAyB,KAAK,WAAW,QAAQ,mBAAmB;AAI7E,kBAAgB,GAAG;AAInB,QAAM,OAAO,MAAM,YAAY,KAAK,QAAQ,GAAG;AAC/C,QAAM,WAAW,MAAM,KAAK,KAAK;AAEjC,MAAI,KAAK,iBAAU;AAInB,6BAA2B;AAC7B;",
+  "sourcesContent": ["/**\r\n * bundle.ts \u2014 NukeJS Client Runtime\r\n *\r\n * This file is compiled by esbuild into /__n.js and served to every page.\r\n * It provides:\r\n *\r\n *   initRuntime(data)              \u2014 called once per page load to hydrate\r\n *                                    \"use client\" components and wire up SPA nav\r\n *   setupLocationChangeMonitor()   \u2014 patches history.pushState/replaceState so\r\n *                                    SPA navigation fires a 'locationchange' event\r\n *\r\n * Hydration model (partial hydration):\r\n *   - The server renders the full page to HTML, wrapping each client component\r\n *     in a <span data-hydrate-id=\"cc_\u2026\" data-hydrate-props=\"\u2026\"> marker.\r\n *   - initRuntime loads the matching JS bundle for each marker and calls\r\n *     hydrateRoot() on it, letting React take over just that subtree.\r\n *   - Props serialized by the server may include nested React elements\r\n *     (serialized as { __re: 'html'|'client', \u2026 }), which are reconstructed\r\n *     back into React.createElement calls before mounting.\r\n *\r\n * SPA navigation:\r\n *   - Link clicks / programmatic navigation dispatch a 'locationchange' event.\r\n *   - The handler fetches the target URL as HTML, diffs the #app container,\r\n *     unmounts the old React roots, and re-hydrates the new ones.\r\n *   - HMR navigations add ?__hmr=1 so the server skips client-SSR (faster).\r\n *\r\n * Head tag management:\r\n *   - The SSR renderer wraps every useHtml()-generated <meta>, <link>, <style>,\r\n *     and <script> tag in <!--n-head-->\u2026<!--/n-head--> sentinel comments.\r\n *   - On each navigation the client diffs the live sentinel block against the\r\n *     incoming one by fingerprint, adding new tags and removing gone ones.\r\n *     Tags shared between pages (e.g. a layout stylesheet) are left untouched\r\n *     so there is no removal/re-insertion flash.\r\n *   - New tags are always inserted before <!--/n-head--> so they stay inside\r\n *     the tracked block and remain visible to the diff on subsequent navigations.\r\n */\r\n\r\n// \u2500\u2500\u2500 History patch \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Patches history.pushState and history.replaceState to fire a custom\r\n * 'locationchange' event on window.  Also listens to 'popstate' for\r\n * back/forward navigation.\r\n *\r\n * Called after initRuntime sets up the navigation listener so there is no\r\n * race between the event firing and the listener being registered.\r\n */\r\nexport function setupLocationChangeMonitor(): void {\r\n  const originalPushState    = window.history.pushState.bind(window.history);\r\n  const originalReplaceState = window.history.replaceState.bind(window.history);\r\n\r\n  const dispatch = (href?: any) =>\r\n    window.dispatchEvent(new CustomEvent('locationchange', { detail: { href } }));\r\n\r\n  window.history.pushState = function (...args) {\r\n    originalPushState(...args);\r\n    dispatch(args[2]); // args[2] is the URL\r\n  };\r\n\r\n  window.history.replaceState = function (...args) {\r\n    originalReplaceState(...args);\r\n    dispatch(args[2]);\r\n  };\r\n\r\n  // Back/forward navigation via the browser's native UI.\r\n  window.addEventListener('popstate', () => dispatch(window.location.pathname));\r\n}\r\n\r\n// \u2500\u2500\u2500 Logger \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\ntype ClientDebugLevel = 'silent' | 'error' | 'info' | 'verbose';\r\n\r\n/**\r\n * Returns a thin logger whose methods are no-ops unless `level` allows them.\r\n * The server embeds the active debug level in the __n_data JSON blob so the\r\n * client respects the same setting as the server.\r\n */\r\nfunction makeLogger(level: ClientDebugLevel) {\r\n  return {\r\n    verbose: (...a: any[]) => { if (level === 'verbose') console.log(...a); },\r\n    info:    (...a: any[]) => { if (level === 'verbose' || level === 'info') console.log(...a); },\r\n    warn:    (...a: any[]) => { if (level === 'verbose' || level === 'info') console.warn(...a); },\r\n    error:   (...a: any[]) => { if (level !== 'silent') console.error(...a); },\r\n  };\r\n}\r\n\r\n// \u2500\u2500\u2500 Serialized node types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/** The wire format for React elements embedded in hydration props. */\r\ntype SerializedNode =\r\n  | null\r\n  | undefined\r\n  | string\r\n  | number\r\n  | boolean\r\n  | SerializedNode[]\r\n  | { __re: 'html';   tag: string;         props: Record<string, any> }\r\n  | { __re: 'client'; componentId: string; props: Record<string, any> }\r\n  | Record<string, any>;\r\n\r\ntype ModuleMap = Map<string, any>; // componentId \u2192 default export\r\n\r\n// \u2500\u2500\u2500 Prop reconstruction \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Recursively turns the server's serialized node tree back into real React\r\n * elements so they can be passed as props to hydrated components.\r\n *\r\n * The server serializes JSX passed as props (e.g. `<Button icon={<Icon />}>`)\r\n * into a JSON-safe format.  This function reverses that process.\r\n */\r\nasync function reconstructElement(node: SerializedNode, mods: ModuleMap): Promise<any> {\r\n  if (node === null || node === undefined) return node;\r\n  if (typeof node !== 'object') return node; // primitive \u2014 pass through\r\n\r\n  if (Array.isArray(node)) {\r\n    const items = await Promise.all(node.map(n => reconstructElement(n, mods)));\r\n    // Add index-based keys to React elements in the array to avoid the\r\n    // \"Each child in a list should have a unique key prop\" warning.\r\n    const React = await import('react');\r\n    return items.map((el, i) =>\r\n      el && typeof el === 'object' && el.$$typeof\r\n        ? React.default.cloneElement(el, { key: el.key ?? i })\r\n        : el,\r\n    );\r\n  }\r\n\r\n  // Client component \u2014 look up the loaded module by ID.\r\n  if ((node as any).__re === 'client') {\r\n    const n = node as { __re: 'client'; componentId: string; props: Record<string, any> };\r\n    const Comp = mods.get(n.componentId);\r\n    if (!Comp) return null;\r\n    const React = await import('react');\r\n    return React.default.createElement(Comp, await reconstructProps(n.props, mods));\r\n  }\r\n\r\n  // Native HTML element (e.g. <div>, <span>).\r\n  if ((node as any).__re === 'html') {\r\n    const n = node as { __re: 'html'; tag: string; props: Record<string, any> };\r\n    const React = await import('react');\r\n    return React.default.createElement(n.tag, await reconstructProps(n.props, mods));\r\n  }\r\n\r\n  // Plain object \u2014 pass through as-is.\r\n  return node;\r\n}\r\n\r\n/** Reconstructs every value in a props object, handling nested serialized nodes. */\r\nasync function reconstructProps(\r\n  props: Record<string, any> | null | undefined,\r\n  mods: ModuleMap,\r\n): Promise<Record<string, any>> {\r\n  if (!props || typeof props !== 'object' || Array.isArray(props))\r\n    return reconstructElement(props as any, mods);\r\n\r\n  const out: Record<string, any> = {};\r\n  for (const [k, v] of Object.entries(props))\r\n    out[k] = await reconstructElement(v, mods);\r\n  return out;\r\n}\r\n\r\n// \u2500\u2500\u2500 Module loading \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Dynamically imports each client component bundle from /__client-component/.\r\n * All fetches are issued in parallel; failures are logged but do not abort\r\n * the rest of the hydration pass.\r\n *\r\n * @param bust  Optional cache-busting suffix appended as `?t=<bust>`.\r\n *              Used during HMR navigation to bypass the module cache.\r\n */\r\nasync function loadModules(\r\n  ids: string[],\r\n  log: ReturnType<typeof makeLogger>,\r\n  bust = '',\r\n): Promise<ModuleMap> {\r\n  const mods: ModuleMap = new Map();\r\n  await Promise.all(\r\n    ids.map(async (id) => {\r\n      try {\r\n        const url = `/__client-component/${id}.js` + (bust ? `?t=${bust}` : '');\r\n        const m = await import(url);\r\n        mods.set(id, m.default);\r\n        log.verbose('\u2713 Loaded:', id);\r\n      } catch (err) {\r\n        log.error('\u2717 Load failed:', id, err);\r\n      }\r\n    }),\r\n  );\r\n  return mods;\r\n}\r\n\r\n// \u2500\u2500\u2500 Root mounting \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/** All active React roots \u2014 tracked so they can be unmounted before navigation. */\r\ntype ReactRoot = { unmount(): void };\r\nconst activeRoots: ReactRoot[] = [];\r\n\r\n/**\r\n * Finds every `[data-hydrate-id]` span in the document and calls hydrateRoot()\r\n * on it.  hydrateRoot reconciles React's virtual DOM against the existing server\r\n * HTML without discarding it, which avoids a visible flash on both initial load\r\n * and SPA navigation (where we set innerHTML to fresh SSR output before calling\r\n * mountNodes).\r\n *\r\n * Nested markers are skipped \u2014 the parent's React tree owns its children.\r\n */\r\nasync function mountNodes(\r\n  mods: ModuleMap,\r\n  log:  ReturnType<typeof makeLogger>,\r\n): Promise<void> {\r\n  const { hydrateRoot } = await import('react-dom/client');\r\n  const React = await import('react');\r\n\r\n  const nodes = document.querySelectorAll<HTMLElement>('[data-hydrate-id]');\r\n  log.verbose('Found', nodes.length, 'hydration point(s)');\r\n\r\n  for (const node of nodes) {\r\n    // Skip nested markers \u2014 the outer component owns its children.\r\n    if (node.parentElement?.closest('[data-hydrate-id]')) continue;\r\n\r\n    const id   = node.getAttribute('data-hydrate-id')!;\r\n    const Comp = mods.get(id);\r\n    if (!Comp) { log.warn('No module for', id); continue; }\r\n\r\n    let rawProps: Record<string, any> = {};\r\n    try {\r\n      rawProps = JSON.parse(node.getAttribute('data-hydrate-props') || '{}');\r\n    } catch (e) {\r\n      log.error('Props parse error for', id, e);\r\n    }\r\n\r\n    try {\r\n      const element = React.default.createElement(Comp, await reconstructProps(rawProps, mods));\r\n      const root    = hydrateRoot(node, element);\r\n      activeRoots.push(root);\r\n      log.verbose('\u2713 Mounted:', id);\r\n    } catch (err) {\r\n      log.error('\u2717 Mount failed:', id, err);\r\n    }\r\n  }\r\n}\r\n\r\n// \u2500\u2500\u2500 Head tag sync \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Walks a <head> element and returns every Element node that lives between\r\n * the <!--n-head--> and <!--/n-head--> sentinel comments, plus the closing\r\n * comment node itself (used as the insertion anchor).\r\n *\r\n * The SSR renderer emits these sentinels around every useHtml()-generated tag\r\n * so the client can manage exactly that set without touching permanent tags\r\n * (charset, viewport, importmap, runtime <script>).\r\n */\r\nfunction headBlock(head: HTMLHeadElement): { nodes: Element[]; closeComment: Comment | null } {\r\n  const nodes: Element[] = [];\r\n  let closeComment: Comment | null = null;\r\n  let inside = false;\r\n\r\n  for (const child of Array.from(head.childNodes)) {\r\n    if (child.nodeType === Node.COMMENT_NODE) {\r\n      const text = (child as Comment).data.trim();\r\n      if (text === 'n-head')  { inside = true;  continue; }\r\n      if (text === '/n-head') { closeComment = child as Comment; inside = false; continue; }\r\n    }\r\n    if (inside && child.nodeType === Node.ELEMENT_NODE)\r\n      nodes.push(child as Element);\r\n  }\r\n\r\n  return { nodes, closeComment };\r\n}\r\n\r\n/** Stable key for an Element: tag name + sorted attribute list (name=value pairs). */\r\nfunction fingerprint(el: Element): string {\r\n  return el.tagName + '|' + Array.from(el.attributes)\r\n    .sort((a, b) => a.name.localeCompare(b.name))\r\n    .map(a => `${a.name}=${a.value}`)\r\n    .join('&');\r\n}\r\n\r\n/**\r\n * Diffs the live <!--n-head--> block against the incoming document's block and\r\n * applies the minimal set of DOM mutations:\r\n *\r\n *   - Tags present in `next` but not in `live` \u2192 inserted before <!--/n-head-->\r\n *     so they remain inside the tracked block on future navigations.\r\n *   - Tags present in `live` but not in `next` \u2192 removed.\r\n *   - Tags present in both \u2192 left untouched (no removal/re-insertion flash).\r\n *\r\n * If the live head has no sentinel block yet (e.g. initial page had no useHtml\r\n * tags), both sentinel comments are created on the fly.\r\n */\r\nfunction syncHeadTags(doc: Document): void {\r\n  const live = headBlock(document.head);\r\n  const next = headBlock(doc.head);\r\n\r\n  const liveMap = new Map<string, Element>();\r\n  for (const el of live.nodes) liveMap.set(fingerprint(el), el);\r\n\r\n  const nextMap = new Map<string, Element>();\r\n  for (const el of next.nodes) nextMap.set(fingerprint(el), el);\r\n\r\n  // Ensure we have an anchor to insert before.\r\n  let anchor = live.closeComment;\r\n  if (!anchor) {\r\n    document.head.appendChild(document.createComment('n-head'));\r\n    anchor = document.createComment('/n-head');\r\n    document.head.appendChild(anchor);\r\n  }\r\n\r\n  for (const [fp, el] of nextMap)\r\n    if (!liveMap.has(fp)) document.head.insertBefore(el, anchor);\r\n\r\n  for (const [fp, el] of liveMap)\r\n    if (!nextMap.has(fp)) el.remove();\r\n}\r\n\r\n// \u2500\u2500\u2500 SPA navigation \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Syncs attributes from a parsed element onto the live document element.\r\n * Adds/updates attributes present in `next` and removes any that were set\r\n * on `live` but are absent in `next` (clears stale htmlAttrs/bodyAttrs).\r\n */\r\nfunction syncAttrs(live: Element, next: Element): void {\r\n  for (const { name, value } of Array.from(next.attributes))\r\n    live.setAttribute(name, value);\r\n  for (const { name } of Array.from(live.attributes))\r\n    if (!next.hasAttribute(name)) live.removeAttribute(name);\r\n}\r\n\r\n/**\r\n * Listens for 'locationchange' events and performs a soft navigation:\r\n *\r\n *   1. Fetch the target URL as HTML (?__hmr=1 skips client-SSR for HMR speed).\r\n *   2. Parse the response with DOMParser.\r\n *   3. Apply all visual DOM changes first (head tags, html/body attrs, #app\r\n *      innerHTML, title, __n_data) so the new content is painted before React\r\n *      cleanup effects run \u2014 prevents a useHtml restore from briefly undoing\r\n *      the new document state.\r\n *   4. Unmount old React roots (runs cleanup effects against the already-updated DOM).\r\n *   5. Re-hydrate new client component markers.\r\n *   6. Scroll to top.\r\n *\r\n * Falls back to a full page reload if anything goes wrong.\r\n */\r\nfunction setupNavigation(log: ReturnType<typeof makeLogger>): void {\r\n  window.addEventListener('locationchange', async ({ detail: { href, hmr } }: any) => {\r\n    try {\r\n      const fetchUrl = hmr\r\n        ? href + (href.includes('?') ? '&' : '?') + '__hmr=1'\r\n        : href;\r\n\r\n      const response = await fetch(fetchUrl, { headers: { Accept: 'text/html' } });\r\n      if (!response.ok) {\r\n        log.error('Navigation fetch failed:', response.status);\r\n        return;\r\n      }\r\n\r\n      const parser  = new DOMParser();\r\n      const doc     = parser.parseFromString(await response.text(), 'text/html');\r\n      const newApp  = doc.getElementById('app');\r\n      const currApp = document.getElementById('app');\r\n      if (!newApp || !currApp) return;\r\n\r\n      // \u2500\u2500 Visual update \u2014 all DOM mutations before React teardown \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n      // Styles must be in place before new content appears to avoid an unstyled\r\n      // flash. Unmounting runs useEffect cleanups (including useHtml restores)\r\n      // which would temporarily revert document state if done first.\r\n\r\n      // 1. Head tags \u2014 diff-based sync preserves shared layout tags untouched.\r\n      syncHeadTags(doc);\r\n\r\n      // 2. <html> and <body> attributes (lang, class, style, etc.).\r\n      syncAttrs(document.documentElement, doc.documentElement);\r\n      syncAttrs(document.body, doc.body);\r\n\r\n      // 3. Page content.\r\n      currApp.innerHTML = newApp.innerHTML;\r\n\r\n      // 4. <title>.\r\n      const newTitle = doc.querySelector('title');\r\n      if (newTitle) document.title = newTitle.textContent ?? '';\r\n\r\n      // 5. Runtime data blob \u2014 must come after innerHTML swap so the new\r\n      //    __n_data element is part of the live document.\r\n      const newDataEl  = doc.getElementById('__n_data');\r\n      const currDataEl = document.getElementById('__n_data');\r\n      if (newDataEl && currDataEl) currDataEl.textContent = newDataEl.textContent;\r\n\r\n      // \u2500\u2500 React teardown \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n      // Unmount after the visual update.  Cleanup effects now run against an\r\n      // already-updated document, so there is nothing left to visually undo.\r\n      activeRoots.splice(0).forEach(r => r.unmount());\r\n\r\n      // \u2500\u2500 Re-hydration \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n      const navData = JSON.parse(currDataEl?.textContent ?? '{}') as RuntimeData;\r\n      log.info('\uD83D\uDD04 Route \u2192', href, '\u2014 mounting', navData.hydrateIds?.length ?? 0, 'component(s)');\r\n\r\n      const mods = await loadModules(navData.allIds ?? [], log, String(Date.now()));\r\n      await mountNodes(mods, log);\r\n\r\n      window.scrollTo(0, 0);\r\n      log.info('\uD83C\uDF89 Navigation complete:', href);\r\n    } catch (err) {\r\n      log.error('Navigation error, falling back to full reload:', err);\r\n      window.location.href = href;\r\n    }\r\n  });\r\n}\r\n\r\n// \u2500\u2500\u2500 Public API \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/** Shape of the JSON blob embedded as #__n_data in every SSR page. */\r\nexport interface RuntimeData {\r\n  /** IDs of client components actually rendered on this page (subset of allIds). */\r\n  hydrateIds: string[];\r\n  /** All client component IDs reachable from this page, including layouts.\r\n   *  Pre-loaded so SPA navigations to related pages feel instant. */\r\n  allIds:  string[];\r\n  url:     string;\r\n  params:  Record<string, any>;\r\n  debug:   ClientDebugLevel;\r\n}\r\n\r\n/**\r\n * Bootstraps the NukeJS client runtime.\r\n *\r\n * Called once per page load from the inline <script type=\"module\"> injected\r\n * by the SSR renderer:\r\n *\r\n * ```js\r\n * const { initRuntime } = await import('nukejs');\r\n * const data = JSON.parse(document.getElementById('__n_data').textContent);\r\n * await initRuntime(data);\r\n * ```\r\n *\r\n * Order of operations:\r\n *   1. Create the logger at the configured debug level.\r\n *   2. Wire up SPA navigation listener.\r\n *   3. Load all client component bundles in parallel.\r\n *   4. Hydrate every [data-hydrate-id] node.\r\n *   5. Patch history.pushState/replaceState so Link clicks trigger navigation.\r\n */\r\nexport async function initRuntime(data: RuntimeData): Promise<void> {\r\n  const log = makeLogger(data.debug ?? 'silent');\r\n\r\n  log.info('\uD83D\uDE80 Partial hydration:', data.hydrateIds.length, 'root component(s)');\r\n\r\n  // Set up navigation first so any 'locationchange' fired during hydration\r\n  // is captured (e.g. a redirect side-effect inside a component).\r\n  setupNavigation(log);\r\n\r\n  // Load all component bundles (not just hydrateIds) so SPA navigations to\r\n  // related pages can mount their components without an extra network round-trip.\r\n  const mods = await loadModules(data.allIds, log);\r\n  await mountNodes(mods, log);\r\n\r\n  log.info('\uD83C\uDF89 Done!');\r\n\r\n  // Patch history last so pushState calls during hydration don't trigger a\r\n  // navigation before roots are ready.\r\n  setupLocationChangeMonitor();\r\n}"],
+  "mappings": "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",
   "names": []
 }

package/dist/bundler.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/bundler.ts"],
-  "sourcesContent": ["/**\n * bundler.ts \u2014 Dev-Mode On-Demand Bundler\n *\n * Handles the three internal JS routes served only in `nuke dev`:\n *\n *   /__react.js                \u2014 Full React + ReactDOM browser bundle.\n *                                All hooks, jsx-runtime, hydrateRoot, createRoot.\n *                                Served once and cached by the browser.\n *\n *   /__n.js                    \u2014 NukeJS client runtime (bundle.ts compiled to ESM).\n *                                Provides initRuntime and SPA navigation.\n *\n *   /__client-component/<id>   \u2014 Individual \"use client\" component bundles.\n *                                Built on-demand the first time they're requested.\n *                                Re-built on every request in dev (no disk cache).\n *\n * In production (`nuke build`), equivalent bundles are written to dist/static/\n * by build-common.ts instead of being served dynamically.\n */\n\nimport path from 'path';\nimport { fileURLToPath } from 'url';\nimport { build } from 'esbuild';\nimport type { ServerResponse } from 'http';\nimport { log } from './logger';\nimport { getComponentById } from './component-analyzer';\n\n// \u2500\u2500\u2500 Bundle caches \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n// Cache Promises (not just results) so concurrent requests share one build\n// instead of each spawning their own esbuild process.\nlet reactBundlePromise: Promise<string> | null = null;\nlet nukeBundlePromise: Promise<string> | null = null;\n\n// \u2500\u2500\u2500 Client component bundle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Bundles a single \"use client\" file for the browser.\n *\n * React and react-dom/client are kept external so the importmap can resolve\n * them to the already-loaded /__react.js bundle (avoids shipping React twice).\n *\n * @param filePath  Absolute path to the source file.\n * @returns         ESM string ready to serve as application/javascript.\n */\nexport async function bundleClientComponent(filePath: string): Promise<string> {\n  const result = await build({\n    entryPoints: [filePath],\n    bundle: true,\n    format: 'esm',\n    platform: 'browser',\n    write: false,\n    jsx: 'automatic',\n    // Keep React external \u2014 resolved by the importmap to /__react.js\n    external: ['react', 'react-dom/client', 'react/jsx-runtime'],\n  });\n  return result.outputFiles[0].text;\n}\n\n/**\n * Looks up a client component by its content-hash ID (e.g. `cc_a1b2c3d4`),\n * bundles it on-demand, and writes the result to the HTTP response.\n *\n * The ID\u2192path mapping comes from the component analyzer cache, which is\n * populated during SSR as pages and their layouts are rendered.\n */\nexport async function serveClientComponentBundle(\n  componentId: string,\n  res: ServerResponse,\n): Promise<void> {\n  const filePath = getComponentById(componentId);\n  if (filePath) {\n    log.verbose(`Bundling client component: ${componentId} (${path.basename(filePath)})`);\n    res.setHeader('Content-Type', 'application/javascript');\n    res.end(await bundleClientComponent(filePath));\n    return;\n  }\n\n  // ID not found \u2014 either the page hasn't been visited yet (cache is empty)\n  // or the ID is stale.\n  log.error(`Client component not found: ${componentId}`);\n  res.statusCode = 404;\n  res.end('Client component not found');\n}\n\n// \u2500\u2500\u2500 React bundle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Builds and serves the unified React browser bundle to /__react.js.\n *\n * Exports every public React API so client components can import from 'react'\n * or 'react-dom/client' and have them resolve via the importmap to this single\n * pre-loaded bundle \u2014 no duplicate copies of React in the browser.\n *\n * esbuild aliases point at the project's installed React version so the bundle\n * always matches what the server is actually running.\n */\nexport async function serveReactBundle(res: ServerResponse): Promise<void> {\n  log.verbose('Bundling React runtime');\n\n  if (!reactBundlePromise) {\n    reactBundlePromise = build({\n      stdin: {\n        contents: `\n        import React, {\n          useState, useEffect, useContext, useReducer, useCallback, useMemo,\n          useRef, useImperativeHandle, useLayoutEffect, useDebugValue,\n          useDeferredValue, useTransition, useId, useSyncExternalStore,\n          useInsertionEffect, createContext, forwardRef, memo, lazy,\n          Suspense, Fragment, StrictMode, Component, PureComponent\n        } from 'react';\n        import { jsx, jsxs } from 'react/jsx-runtime';\n        import { hydrateRoot, createRoot } from 'react-dom/client';\n\n        export {\n          useState, useEffect, useContext, useReducer, useCallback, useMemo,\n          useRef, useImperativeHandle, useLayoutEffect, useDebugValue,\n          useDeferredValue, useTransition, useId, useSyncExternalStore,\n          useInsertionEffect, createContext, forwardRef, memo, lazy,\n          Suspense, Fragment, StrictMode, Component, PureComponent,\n          hydrateRoot, createRoot, jsx, jsxs\n        };\n        export default React;\n      `,\n        loader: 'ts',\n      },\n      bundle: true,\n      write: false,\n      treeShaking: true,\n      minify: false,\n      format: 'esm',\n      jsx: 'automatic',\n      alias: {\n        react: path.dirname(fileURLToPath(import.meta.resolve('react/package.json'))),\n        'react-dom': path.dirname(fileURLToPath(import.meta.resolve('react-dom/package.json'))),\n      },\n      define: { 'process.env.NODE_ENV': '\"development\"' },\n    }).then(r => r.outputFiles[0].text);\n  }\n\n  res.setHeader('Content-Type', 'application/javascript');\n  res.end(await reactBundlePromise);\n}\n\n// \u2500\u2500\u2500 NukeJS runtime bundle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\n/**\n * Bundles and serves the NukeJS client runtime to /__n.js.\n *\n * The entry point is bundle.ts (or bundle.js in production dist/).\n * React is kept external so it resolves via the importmap to /__react.js.\n *\n * Minified because this script is loaded on every page request.\n */\nexport async function serveNukeBundle(res: ServerResponse): Promise<void> {\n  log.verbose('Bundling nuke runtime');\n\n  if (!nukeBundlePromise) {\n    const dir = path.dirname(fileURLToPath(import.meta.url));\n    const entry = path.join(dir, `bundle.${dir.endsWith('dist') ? 'js' : 'ts'}`);\n    nukeBundlePromise = build({\n      entryPoints: [entry],\n      write: false,\n      format: 'esm',\n      minify: true,\n      bundle: true,\n      external: ['react', 'react-dom/client'],\n    }).then(r => r.outputFiles[0].text);\n  }\n\n  res.setHeader('Content-Type', 'application/javascript');\n  res.end(await nukeBundlePromise);\n}"],
+  "sourcesContent": ["/**\r\n * bundler.ts \u2014 Dev-Mode On-Demand Bundler\r\n *\r\n * Handles the three internal JS routes served only in `nuke dev`:\r\n *\r\n *   /__react.js                \u2014 Full React + ReactDOM browser bundle.\r\n *                                All hooks, jsx-runtime, hydrateRoot, createRoot.\r\n *                                Served once and cached by the browser.\r\n *\r\n *   /__n.js                    \u2014 NukeJS client runtime (bundle.ts compiled to ESM).\r\n *                                Provides initRuntime and SPA navigation.\r\n *\r\n *   /__client-component/<id>   \u2014 Individual \"use client\" component bundles.\r\n *                                Built on-demand the first time they're requested.\r\n *                                Re-built on every request in dev (no disk cache).\r\n *\r\n * In production (`nuke build`), equivalent bundles are written to dist/static/\r\n * by build-common.ts instead of being served dynamically.\r\n */\r\n\r\nimport path from 'path';\r\nimport { fileURLToPath } from 'url';\r\nimport { build } from 'esbuild';\r\nimport type { ServerResponse } from 'http';\r\nimport { log } from './logger';\r\nimport { getComponentById } from './component-analyzer';\r\n\r\n// \u2500\u2500\u2500 Bundle caches \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n// Cache Promises (not just results) so concurrent requests share one build\r\n// instead of each spawning their own esbuild process.\r\nlet reactBundlePromise: Promise<string> | null = null;\r\nlet nukeBundlePromise: Promise<string> | null = null;\r\n\r\n// \u2500\u2500\u2500 Client component bundle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Bundles a single \"use client\" file for the browser.\r\n *\r\n * React and react-dom/client are kept external so the importmap can resolve\r\n * them to the already-loaded /__react.js bundle (avoids shipping React twice).\r\n *\r\n * @param filePath  Absolute path to the source file.\r\n * @returns         ESM string ready to serve as application/javascript.\r\n */\r\nexport async function bundleClientComponent(filePath: string): Promise<string> {\r\n  const result = await build({\r\n    entryPoints: [filePath],\r\n    bundle: true,\r\n    format: 'esm',\r\n    platform: 'browser',\r\n    write: false,\r\n    jsx: 'automatic',\r\n    // Keep React external \u2014 resolved by the importmap to /__react.js\r\n    external: ['react', 'react-dom/client', 'react/jsx-runtime'],\r\n  });\r\n  return result.outputFiles[0].text;\r\n}\r\n\r\n/**\r\n * Looks up a client component by its content-hash ID (e.g. `cc_a1b2c3d4`),\r\n * bundles it on-demand, and writes the result to the HTTP response.\r\n *\r\n * The ID\u2192path mapping comes from the component analyzer cache, which is\r\n * populated during SSR as pages and their layouts are rendered.\r\n */\r\nexport async function serveClientComponentBundle(\r\n  componentId: string,\r\n  res: ServerResponse,\r\n): Promise<void> {\r\n  const filePath = getComponentById(componentId);\r\n  if (filePath) {\r\n    log.verbose(`Bundling client component: ${componentId} (${path.basename(filePath)})`);\r\n    res.setHeader('Content-Type', 'application/javascript');\r\n    res.end(await bundleClientComponent(filePath));\r\n    return;\r\n  }\r\n\r\n  // ID not found \u2014 either the page hasn't been visited yet (cache is empty)\r\n  // or the ID is stale.\r\n  log.error(`Client component not found: ${componentId}`);\r\n  res.statusCode = 404;\r\n  res.end('Client component not found');\r\n}\r\n\r\n// \u2500\u2500\u2500 React bundle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Builds and serves the unified React browser bundle to /__react.js.\r\n *\r\n * Exports every public React API so client components can import from 'react'\r\n * or 'react-dom/client' and have them resolve via the importmap to this single\r\n * pre-loaded bundle \u2014 no duplicate copies of React in the browser.\r\n *\r\n * esbuild aliases point at the project's installed React version so the bundle\r\n * always matches what the server is actually running.\r\n */\r\nexport async function serveReactBundle(res: ServerResponse): Promise<void> {\r\n  log.verbose('Bundling React runtime');\r\n\r\n  if (!reactBundlePromise) {\r\n    reactBundlePromise = build({\r\n      stdin: {\r\n        contents: `\r\n        import React, {\r\n          useState, useEffect, useContext, useReducer, useCallback, useMemo,\r\n          useRef, useImperativeHandle, useLayoutEffect, useDebugValue,\r\n          useDeferredValue, useTransition, useId, useSyncExternalStore,\r\n          useInsertionEffect, createContext, forwardRef, memo, lazy,\r\n          Suspense, Fragment, StrictMode, Component, PureComponent\r\n        } from 'react';\r\n        import { jsx, jsxs } from 'react/jsx-runtime';\r\n        import { hydrateRoot, createRoot } from 'react-dom/client';\r\n\r\n        export {\r\n          useState, useEffect, useContext, useReducer, useCallback, useMemo,\r\n          useRef, useImperativeHandle, useLayoutEffect, useDebugValue,\r\n          useDeferredValue, useTransition, useId, useSyncExternalStore,\r\n          useInsertionEffect, createContext, forwardRef, memo, lazy,\r\n          Suspense, Fragment, StrictMode, Component, PureComponent,\r\n          hydrateRoot, createRoot, jsx, jsxs\r\n        };\r\n        export default React;\r\n      `,\r\n        loader: 'ts',\r\n      },\r\n      bundle: true,\r\n      write: false,\r\n      treeShaking: true,\r\n      minify: false,\r\n      format: 'esm',\r\n      jsx: 'automatic',\r\n      alias: {\r\n        react: path.dirname(fileURLToPath(import.meta.resolve('react/package.json'))),\r\n        'react-dom': path.dirname(fileURLToPath(import.meta.resolve('react-dom/package.json'))),\r\n      },\r\n      define: { 'process.env.NODE_ENV': '\"development\"' },\r\n    }).then(r => r.outputFiles[0].text);\r\n  }\r\n\r\n  res.setHeader('Content-Type', 'application/javascript');\r\n  res.end(await reactBundlePromise);\r\n}\r\n\r\n// \u2500\u2500\u2500 NukeJS runtime bundle \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Bundles and serves the NukeJS client runtime to /__n.js.\r\n *\r\n * The entry point is bundle.ts (or bundle.js in production dist/).\r\n * React is kept external so it resolves via the importmap to /__react.js.\r\n *\r\n * Minified because this script is loaded on every page request.\r\n */\r\nexport async function serveNukeBundle(res: ServerResponse): Promise<void> {\r\n  log.verbose('Bundling nuke runtime');\r\n\r\n  if (!nukeBundlePromise) {\r\n    const dir = path.dirname(fileURLToPath(import.meta.url));\r\n    const entry = path.join(dir, `bundle.${dir.endsWith('dist') ? 'js' : 'ts'}`);\r\n    nukeBundlePromise = build({\r\n      entryPoints: [entry],\r\n      write: false,\r\n      format: 'esm',\r\n      minify: true,\r\n      bundle: true,\r\n      external: ['react', 'react-dom/client'],\r\n    }).then(r => r.outputFiles[0].text);\r\n  }\r\n\r\n  res.setHeader('Content-Type', 'application/javascript');\r\n  res.end(await nukeBundlePromise);\r\n}"],
   "mappings": "AAoBA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAC9B,SAAS,aAAa;AAEtB,SAAS,WAAW;AACpB,SAAS,wBAAwB;AAMjC,IAAI,qBAA6C;AACjD,IAAI,oBAA4C;AAahD,eAAsB,sBAAsB,UAAmC;AAC7E,QAAM,SAAS,MAAM,MAAM;AAAA,IACzB,aAAa,CAAC,QAAQ;AAAA,IACtB,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,OAAO;AAAA,IACP,KAAK;AAAA;AAAA,IAEL,UAAU,CAAC,SAAS,oBAAoB,mBAAmB;AAAA,EAC7D,CAAC;AACD,SAAO,OAAO,YAAY,CAAC,EAAE;AAC/B;AASA,eAAsB,2BACpB,aACA,KACe;AACf,QAAM,WAAW,iBAAiB,WAAW;AAC7C,MAAI,UAAU;AACZ,QAAI,QAAQ,8BAA8B,WAAW,KAAK,KAAK,SAAS,QAAQ,CAAC,GAAG;AACpF,QAAI,UAAU,gBAAgB,wBAAwB;AACtD,QAAI,IAAI,MAAM,sBAAsB,QAAQ,CAAC;AAC7C;AAAA,EACF;AAIA,MAAI,MAAM,+BAA+B,WAAW,EAAE;AACtD,MAAI,aAAa;AACjB,MAAI,IAAI,4BAA4B;AACtC;AAcA,eAAsB,iBAAiB,KAAoC;AACzE,MAAI,QAAQ,wBAAwB;AAEpC,MAAI,CAAC,oBAAoB;AACvB,yBAAqB,MAAM;AAAA,MACzB,OAAO;AAAA,QACL,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,QAqBV,QAAQ;AAAA,MACV;AAAA,MACA,QAAQ;AAAA,MACR,OAAO;AAAA,MACP,aAAa;AAAA,MACb,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,KAAK;AAAA,MACL,OAAO;AAAA,QACL,OAAO,KAAK,QAAQ,cAAc,YAAY,QAAQ,oBAAoB,CAAC,CAAC;AAAA,QAC5E,aAAa,KAAK,QAAQ,cAAc,YAAY,QAAQ,wBAAwB,CAAC,CAAC;AAAA,MACxF;AAAA,MACA,QAAQ,EAAE,wBAAwB,gBAAgB;AAAA,IACpD,CAAC,EAAE,KAAK,OAAK,EAAE,YAAY,CAAC,EAAE,IAAI;AAAA,EACpC;AAEA,MAAI,UAAU,gBAAgB,wBAAwB;AACtD,MAAI,IAAI,MAAM,kBAAkB;AAClC;AAYA,eAAsB,gBAAgB,KAAoC;AACxE,MAAI,QAAQ,uBAAuB;AAEnC,MAAI,CAAC,mBAAmB;AACtB,UAAM,MAAM,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AACvD,UAAM,QAAQ,KAAK,KAAK,KAAK,UAAU,IAAI,SAAS,MAAM,IAAI,OAAO,IAAI,EAAE;AAC3E,wBAAoB,MAAM;AAAA,MACxB,aAAa,CAAC,KAAK;AAAA,MACnB,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,QAAQ;AAAA,MACR,UAAU,CAAC,SAAS,kBAAkB;AAAA,IACxC,CAAC,EAAE,KAAK,OAAK,EAAE,YAAY,CAAC,EAAE,IAAI;AAAA,EACpC;AAEA,MAAI,UAAU,gBAAgB,wBAAwB;AACtD,MAAI,IAAI,MAAM,iBAAiB;AACjC;",
   "names": []
 }

package/dist/component-analyzer.js

@@ -32,7 +32,7 @@ function extractImports(filePath) {
   const content = fs.readFileSync(filePath, "utf-8");
   const dir = path.dirname(filePath);
   const imports = [];
-  const importRegex = /import\s+(?:(?:\{[^}]*\}|\*\s+as\s+\w+|\w+)\s+from\s+)?['"]([^'"]+)['"]/g;
+  const importRegex = /(?:import|export)\s+(?:(?:\{[^}]*\}|\*\s+as\s+\w+|\w+)\s+from\s+)?['"]([^'"]+)['"]/g;
   let match;
   while ((match = importRegex.exec(content)) !== null) {
     const importPath = match[1];
@@ -51,16 +51,31 @@ function extractImports(filePath) {
     }
     if (!importPath.startsWith(".") && !importPath.startsWith("/")) continue;
     let resolved = path.resolve(dir, importPath);
-    if (!fs.existsSync(resolved)) {
-      for (const ext of [".tsx", ".ts", ".jsx", ".js"]) {
+    const EXTS = [".tsx", ".ts", ".jsx", ".js"];
+    const isFile = (p) => fs.existsSync(p) && fs.statSync(p).isFile();
+    if (!isFile(resolved)) {
+      let found = false;
+      for (const ext of EXTS) {
         const candidate = resolved + ext;
-        if (fs.existsSync(candidate)) {
+        if (isFile(candidate)) {
           resolved = candidate;
+          found = true;
           break;
         }
       }
+      if (!found && fs.existsSync(resolved) && fs.statSync(resolved).isDirectory()) {
+        for (const ext of EXTS) {
+          const candidate = path.join(resolved, `index${ext}`);
+          if (isFile(candidate)) {
+            resolved = candidate;
+            found = true;
+            break;
+          }
+        }
+      }
+      if (!found) continue;
     }
-    if (fs.existsSync(resolved)) imports.push(resolved);
+    imports.push(resolved);
   }
   return imports;
 }

package/dist/component-analyzer.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/component-analyzer.ts"],
-  "sourcesContent": ["/**\r\n * component-analyzer.ts \u2014 Static Import Analyzer & Client Component Registry\r\n *\r\n * This module solves a core problem in NukeJS's partial hydration model:\r\n * the server needs to know *at render time* which components in a page's\r\n * import tree are \"use client\" boundaries so it can:\r\n *\r\n *   1. Emit <span data-hydrate-id=\"\u2026\"> markers instead of rendering them.\r\n *   2. Inject the matching bundle URLs into the page's runtime data blob.\r\n *   3. Serialize the props passed to those components so the browser can\r\n *      reconstruct them after loading the bundle.\r\n *\r\n * How it works:\r\n *   - analyzeComponent()         checks whether a file starts with \"use client\"\r\n *                                 and assigns a stable content-hash ID if it does.\r\n *   - extractImports()           parses `import \u2026 from '\u2026'` statements with a\r\n *                                 regex and resolves relative/absolute paths.\r\n *   - findClientComponentsInTree() recursively walks the import graph, stopping\r\n *                                 at client boundaries (they own their subtree).\r\n *\r\n * Results are memoised in `componentCache` (process-lifetime) so repeated SSR\r\n * renders don't re-read and re-hash files they've already seen.\r\n *\r\n * ID scheme:\r\n *   The ID for a client component is `cc_` + the first 8 hex chars of the MD5\r\n *   hash of its path relative to pagesDir.  This is stable across restarts and\r\n *   matches what the browser will request from /__client-component/<id>.js.\r\n */\r\n\r\nimport path from 'path';\r\nimport fs from 'fs';\r\nimport crypto from 'crypto';\r\nimport { fileURLToPath } from 'url';\r\n\r\n// \u2500\u2500\u2500 Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nexport interface ComponentInfo {\r\n  filePath:           string;\r\n  /** True when the file's first non-comment line is \"use client\". */\r\n  isClientComponent:  boolean;\r\n  /** Stable hash-based ID, present only for client components. */\r\n  clientComponentId?: string;\r\n}\r\n\r\n// \u2500\u2500\u2500 In-process cache \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n// Memoises analyze results for the lifetime of the dev server process.\r\n// In production builds the analysis runs once per build, so no cache is needed.\r\nconst componentCache = new Map<string, ComponentInfo>();\r\n\r\n// \u2500\u2500\u2500 Client boundary detection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Returns true when a file begins with a `\"use client\"` or `'use client'`\r\n * directive (ignoring blank lines and line/block comment prefixes).\r\n *\r\n * Only the first five lines are checked \u2014 the directive must appear before\r\n * any executable code.\r\n */\r\nfunction isClientComponent(filePath: string): boolean {\r\n  const content = fs.readFileSync(filePath, 'utf-8');\r\n  for (const line of content.split('\\n').slice(0, 5)) {\r\n    const trimmed = line.trim();\r\n    if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('/*')) continue;\r\n    if (/^[\"']use client[\"'];?$/.test(trimmed)) return true;\r\n    break; // First substantive line is not \"use client\"\r\n  }\r\n  return false;\r\n}\r\n\r\n/**\r\n * Generates a deterministic, short ID for a client component.\r\n * The path is made relative to pagesDir before hashing so the ID is\r\n * portable across machines (absolute paths differ per developer).\r\n */\r\nfunction getClientComponentId(filePath: string, pagesDir: string): string {\r\n  const hash = crypto\r\n    .createHash('md5')\r\n    .update(path.relative(pagesDir, filePath))\r\n    .digest('hex')\r\n    .substring(0, 8);\r\n  return `cc_${hash}`;\r\n}\r\n\r\n// \u2500\u2500\u2500 Analysis \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Analyses a component file and returns cached results on subsequent calls.\r\n *\r\n * @param filePath  Absolute path to the source file.\r\n * @param pagesDir  Absolute path to the pages root (used for ID generation).\r\n */\r\nexport function analyzeComponent(filePath: string, pagesDir: string): ComponentInfo {\r\n  if (componentCache.has(filePath)) return componentCache.get(filePath)!;\r\n\r\n  const isClient = isClientComponent(filePath);\r\n  const info: ComponentInfo = {\r\n    filePath,\r\n    isClientComponent:  isClient,\r\n    clientComponentId: isClient ? getClientComponentId(filePath, pagesDir) : undefined,\r\n  };\r\n\r\n  componentCache.set(filePath, info);\r\n  return info;\r\n}\r\n\r\n// \u2500\u2500\u2500 Import extraction \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Parses `import \u2026 from '\u2026'` statements in a file and returns a list of\r\n * resolved absolute paths for all *local* imports (relative or absolute paths).\r\n *\r\n * Non-local specifiers (npm packages) are skipped, except `nukejs` itself \u2014\r\n * which is resolved to our own index file so built-in \"use client\" components\r\n * like `<Link>` are included in the client component discovery walk.\r\n *\r\n * Extensions are tried in priority order if the specifier has none.\r\n */\r\nfunction extractImports(filePath: string): string[] {\r\n  const content = fs.readFileSync(filePath, 'utf-8');\r\n  const dir     = path.dirname(filePath);\r\n  const imports: string[] = [];\r\n\r\n  const importRegex =\r\n    /import\\s+(?:(?:\\{[^}]*\\}|\\*\\s+as\\s+\\w+|\\w+)\\s+from\\s+)?['\"]([^'\"]+)['\"]/g;\r\n  let match: RegExpExecArray | null;\r\n\r\n  while ((match = importRegex.exec(content)) !== null) {\r\n    const importPath = match[1];\r\n\r\n    // Special case: resolve the 'nukejs' package import to our own source so\r\n    // built-in \"use client\" exports (Link, useRouter, etc.) are discovered.\r\n    if (importPath === 'nukejs') {\r\n      const selfDir = path.dirname(fileURLToPath(import.meta.url));\r\n      for (const candidate of [\r\n        path.join(selfDir, 'index.ts'),\r\n        path.join(selfDir, 'index.js'),\r\n      ]) {\r\n        if (fs.existsSync(candidate)) { imports.push(candidate); break; }\r\n      }\r\n      continue;\r\n    }\r\n\r\n    // Skip npm packages and other non-local specifiers.\r\n    if (!importPath.startsWith('.') && !importPath.startsWith('/')) continue;\r\n\r\n    // Resolve to an absolute path and add common extensions if needed.\r\n    let resolved = path.resolve(dir, importPath);\r\n    if (!fs.existsSync(resolved)) {\r\n      for (const ext of ['.tsx', '.ts', '.jsx', '.js']) {\r\n        const candidate = resolved + ext;\r\n        if (fs.existsSync(candidate)) { resolved = candidate; break; }\r\n      }\r\n    }\r\n    if (fs.existsSync(resolved)) imports.push(resolved);\r\n  }\r\n\r\n  return imports;\r\n}\r\n\r\n// \u2500\u2500\u2500 Tree walk \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Recursively walks the import graph from `filePath`, collecting every\r\n * \"use client\" file encountered.\r\n *\r\n * The walk stops at client boundaries: a \"use client\" file is collected and\r\n * its own imports are NOT walked (the client runtime handles their subtree).\r\n *\r\n * The `visited` set prevents infinite loops from circular imports.\r\n *\r\n * @returns  Map<id, absoluteFilePath> for every client component reachable\r\n *           from `filePath` (including `filePath` itself if it's a client).\r\n */\r\nexport function findClientComponentsInTree(\r\n  filePath:  string,\r\n  pagesDir:  string,\r\n  visited  = new Set<string>(),\r\n): Map<string, string> {\r\n  const clientComponents = new Map<string, string>();\r\n  if (visited.has(filePath)) return clientComponents;\r\n  visited.add(filePath);\r\n\r\n  const info = analyzeComponent(filePath, pagesDir);\r\n\r\n  // This file is a client boundary \u2014 record it and stop descending.\r\n  if (info.isClientComponent && info.clientComponentId) {\r\n    clientComponents.set(info.clientComponentId, filePath);\r\n    return clientComponents;\r\n  }\r\n\r\n  // Server component \u2014 recurse into its imports.\r\n  for (const importPath of extractImports(filePath)) {\r\n    for (const [id, p] of findClientComponentsInTree(importPath, pagesDir, visited)) {\r\n      clientComponents.set(id, p);\r\n    }\r\n  }\r\n\r\n  return clientComponents;\r\n}\r\n\r\n// \u2500\u2500\u2500 Cache access \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n\r\n/**\r\n * Looks up the absolute file path for a client component by its ID.\r\n * O(1) reverse lookup \u2014 avoids the O(n) linear scan in bundler.ts.\r\n *\r\n * Returns undefined when the ID is not in the cache (page not yet visited\r\n * in dev, or stale ID after a file change).\r\n */\r\nexport function getComponentById(id: string): string | undefined {\r\n  for (const [filePath, info] of componentCache) {\r\n    if (info.clientComponentId === id) return filePath;\r\n  }\r\n  return undefined;\r\n}\r\n\r\n/** Returns the live component cache (used by bundler.ts for ID\u2192path lookup). */\r\nexport function getComponentCache(): Map<string, ComponentInfo> {\r\n  return componentCache;\r\n}\r\n\r\n/**\r\n * Removes a single file's analysis entry from the cache.\r\n * Call this whenever a source file changes in dev mode so the next render\r\n * re-analyses the file (picks up added/removed \"use client\" directives and\r\n * changed import graphs).\r\n */\r\nexport function invalidateComponentCache(filePath: string): void {\r\n  componentCache.delete(filePath);\r\n}"],
-  "mappings": "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",
+  "sourcesContent": ["/**\r\n * component-analyzer.ts \u2014 Static Import Analyzer & Client Component Registry\r\n *\r\n * This module solves a core problem in NukeJS's partial hydration model:\r\n * the server needs to know *at render time* which components in a page's\r\n * import tree are \"use client\" boundaries so it can:\r\n *\r\n *   1. Emit <span data-hydrate-id=\"\u2026\"> markers instead of rendering them.\r\n *   2. Inject the matching bundle URLs into the page's runtime data blob.\r\n *   3. Serialize the props passed to those components so the browser can\r\n *      reconstruct them after loading the bundle.\r\n *\r\n * How it works:\r\n *   - analyzeComponent()         checks whether a file starts with \"use client\"\r\n *                                 and assigns a stable content-hash ID if it does.\r\n *   - extractImports()           parses `import \u2026 from '\u2026'` statements with a\r\n *                                 regex and resolves relative/absolute paths.\r\n *   - findClientComponentsInTree() recursively walks the import graph, stopping\r\n *                                 at client boundaries (they own their subtree).\r\n *\r\n * Results are memoised in `componentCache` (process-lifetime) so repeated SSR\r\n * renders don't re-read and re-hash files they've already seen.\r\n *\r\n * ID scheme:\r\n *   The ID for a client component is `cc_` + the first 8 hex chars of the MD5\r\n *   hash of its path relative to pagesDir.  This is stable across restarts and\r\n *   matches what the browser will request from /__client-component/<id>.js.\r\n */\r\n\r\nimport path from 'path';\r\nimport fs from 'fs';\r\nimport crypto from 'crypto';\r\nimport { fileURLToPath } from 'url';\r\n\r\n// \u2500\u2500\u2500 Types \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nexport interface ComponentInfo {\r\n  filePath:           string;\r\n  /** True when the file's first non-comment line is \"use client\". */\r\n  isClientComponent:  boolean;\r\n  /** Stable hash-based ID, present only for client components. */\r\n  clientComponentId?: string;\r\n}\r\n\r\n// \u2500\u2500\u2500 In-process cache \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n// Memoises analyze results for the lifetime of the dev server process.\r\n// In production builds the analysis runs once per build, so no cache is needed.\r\nconst componentCache = new Map<string, ComponentInfo>();\r\n\r\n// \u2500\u2500\u2500 Client boundary detection \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Returns true when a file begins with a `\"use client\"` or `'use client'`\r\n * directive (ignoring blank lines and line/block comment prefixes).\r\n *\r\n * Only the first five lines are checked \u2014 the directive must appear before\r\n * any executable code.\r\n */\r\nfunction isClientComponent(filePath: string): boolean {\r\n  const content = fs.readFileSync(filePath, 'utf-8');\r\n  for (const line of content.split('\\n').slice(0, 5)) {\r\n    const trimmed = line.trim();\r\n    if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('/*')) continue;\r\n    if (/^[\"']use client[\"'];?$/.test(trimmed)) return true;\r\n    break; // First substantive line is not \"use client\"\r\n  }\r\n  return false;\r\n}\r\n\r\n/**\r\n * Generates a deterministic, short ID for a client component.\r\n * The path is made relative to pagesDir before hashing so the ID is\r\n * portable across machines (absolute paths differ per developer).\r\n */\r\nfunction getClientComponentId(filePath: string, pagesDir: string): string {\r\n  const hash = crypto\r\n    .createHash('md5')\r\n    .update(path.relative(pagesDir, filePath))\r\n    .digest('hex')\r\n    .substring(0, 8);\r\n  return `cc_${hash}`;\r\n}\r\n\r\n// \u2500\u2500\u2500 Analysis \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Analyses a component file and returns cached results on subsequent calls.\r\n *\r\n * @param filePath  Absolute path to the source file.\r\n * @param pagesDir  Absolute path to the pages root (used for ID generation).\r\n */\r\nexport function analyzeComponent(filePath: string, pagesDir: string): ComponentInfo {\r\n  if (componentCache.has(filePath)) return componentCache.get(filePath)!;\r\n\r\n  const isClient = isClientComponent(filePath);\r\n  const info: ComponentInfo = {\r\n    filePath,\r\n    isClientComponent:  isClient,\r\n    clientComponentId: isClient ? getClientComponentId(filePath, pagesDir) : undefined,\r\n  };\r\n\r\n  componentCache.set(filePath, info);\r\n  return info;\r\n}\r\n\r\n// \u2500\u2500\u2500 Import extraction \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Parses `import \u2026 from '\u2026'` and `export \u2026 from '\u2026'` statements in a file and returns a list of\r\n * resolved absolute paths for all *local* imports (relative or absolute paths).\r\n *\r\n * Non-local specifiers (npm packages) are skipped, except `nukejs` itself \u2014\r\n * which is resolved to our own index file so built-in \"use client\" components\r\n * like `<Link>` are included in the client component discovery walk.\r\n *\r\n * Extensions are tried in priority order if the specifier has none.\r\n */\r\nfunction extractImports(filePath: string): string[] {\r\n  const content = fs.readFileSync(filePath, 'utf-8');\r\n  const dir     = path.dirname(filePath);\r\n  const imports: string[] = [];\r\n\r\n  const importRegex =\r\n    /(?:import|export)\\s+(?:(?:\\{[^}]*\\}|\\*\\s+as\\s+\\w+|\\w+)\\s+from\\s+)?['\"]([^'\"]+)['\"]/g;\r\n  let match: RegExpExecArray | null;\r\n\r\n  while ((match = importRegex.exec(content)) !== null) {\r\n    const importPath = match[1];\r\n\r\n    // Special case: resolve the 'nukejs' package import to our own source so\r\n    // built-in \"use client\" exports (Link, useRouter, etc.) are discovered.\r\n    if (importPath === 'nukejs') {\r\n      const selfDir = path.dirname(fileURLToPath(import.meta.url));\r\n      for (const candidate of [\r\n        path.join(selfDir, 'index.ts'),\r\n        path.join(selfDir, 'index.js'),\r\n      ]) {\r\n        if (fs.existsSync(candidate)) { imports.push(candidate); break; }\r\n      }\r\n      continue;\r\n    }\r\n\r\n    // Skip npm packages and other non-local specifiers.\r\n    if (!importPath.startsWith('.') && !importPath.startsWith('/')) continue;\r\n\r\n    // Resolve to an absolute path and add common extensions if needed.\r\n    let resolved = path.resolve(dir, importPath);\r\n    const EXTS = ['.tsx', '.ts', '.jsx', '.js'] as const;\r\n\r\n    const isFile = (p: string) =>\r\n      fs.existsSync(p) && fs.statSync(p).isFile();\r\n\r\n    if (!isFile(resolved)) {\r\n      let found = false;\r\n\r\n      // 1. Try appending an extension  (e.g. './Button' \u2192 './Button.tsx')\r\n      for (const ext of EXTS) {\r\n        const candidate = resolved + ext;\r\n        if (isFile(candidate)) { resolved = candidate; found = true; break; }\r\n      }\r\n\r\n      // 2. If resolved is a directory, look for an index file inside it\r\n      //    (e.g. './components' \u2192 './components/index.tsx')\r\n      if (!found && fs.existsSync(resolved) && fs.statSync(resolved).isDirectory()) {\r\n        for (const ext of EXTS) {\r\n          const candidate = path.join(resolved, `index${ext}`);\r\n          if (isFile(candidate)) { resolved = candidate; found = true; break; }\r\n        }\r\n      }\r\n\r\n      if (!found) continue; // unresolvable import \u2014 skip silently\r\n    }\r\n\r\n    imports.push(resolved);\r\n  }\r\n\r\n  return imports;\r\n}\r\n\r\n// \u2500\u2500\u2500 Tree walk \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Recursively walks the import graph from `filePath`, collecting every\r\n * \"use client\" file encountered.\r\n *\r\n * The walk stops at client boundaries: a \"use client\" file is collected and\r\n * its own imports are NOT walked (the client runtime handles their subtree).\r\n *\r\n * The `visited` set prevents infinite loops from circular imports.\r\n *\r\n * @returns  Map<id, absoluteFilePath> for every client component reachable\r\n *           from `filePath` (including `filePath` itself if it's a client).\r\n */\r\nexport function findClientComponentsInTree(\r\n  filePath:  string,\r\n  pagesDir:  string,\r\n  visited  = new Set<string>(),\r\n): Map<string, string> {\r\n  const clientComponents = new Map<string, string>();\r\n  if (visited.has(filePath)) return clientComponents;\r\n  visited.add(filePath);\r\n\r\n  const info = analyzeComponent(filePath, pagesDir);\r\n\r\n  // This file is a client boundary \u2014 record it and stop descending.\r\n  if (info.isClientComponent && info.clientComponentId) {\r\n    clientComponents.set(info.clientComponentId, filePath);\r\n    return clientComponents;\r\n  }\r\n\r\n  // Server component \u2014 recurse into its imports.\r\n  for (const importPath of extractImports(filePath)) {\r\n    for (const [id, p] of findClientComponentsInTree(importPath, pagesDir, visited)) {\r\n      clientComponents.set(id, p);\r\n    }\r\n  }\r\n\r\n  return clientComponents;\r\n}\r\n\r\n// \u2500\u2500\u2500 Cache access \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n\r\n/**\r\n * Looks up the absolute file path for a client component by its ID.\r\n * O(1) reverse lookup \u2014 avoids the O(n) linear scan in bundler.ts.\r\n *\r\n * Returns undefined when the ID is not in the cache (page not yet visited\r\n * in dev, or stale ID after a file change).\r\n */\r\nexport function getComponentById(id: string): string | undefined {\r\n  for (const [filePath, info] of componentCache) {\r\n    if (info.clientComponentId === id) return filePath;\r\n  }\r\n  return undefined;\r\n}\r\n\r\n/** Returns the live component cache (used by bundler.ts for ID\u2192path lookup). */\r\nexport function getComponentCache(): Map<string, ComponentInfo> {\r\n  return componentCache;\r\n}\r\n\r\n/**\r\n * Removes a single file's analysis entry from the cache.\r\n * Call this whenever a source file changes in dev mode so the next render\r\n * re-analyses the file (picks up added/removed \"use client\" directives and\r\n * changed import graphs).\r\n */\r\nexport function invalidateComponentCache(filePath: string): void {\r\n  componentCache.delete(filePath);\r\n}"],
+  "mappings": "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",
   "names": []
 }

package/dist/middleware.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/middleware.ts"],
-  "sourcesContent": ["/**\n * middleware.ts \u2014 Built-In NukeJS Middleware\n *\n * This is the internal middleware loaded before any user-defined middleware.\n * It handles three responsibilities:\n *\n *   1. Static public files  (app/public/**)\n *      Any file placed in app/public/ is served at its path relative to\n *      that directory.  E.g. app/public/favicon.ico \u2192 GET /favicon.ico.\n *      The correct Content-Type is set automatically.  Path traversal attempts\n *      are rejected with 400.\n *\n *   2. HMR client script    (/__hmr.js)\n *      Builds and serves hmr-bundle.ts on demand.  Injected into every dev\n *      page as <script type=\"module\" src=\"/__hmr.js\">.\n *\n *   3. HMR SSE stream       (/__hmr)\n *      Long-lived Server-Sent Events connection used by the browser to receive\n *      reload/replace/restart events when source files change.\n */\n\nimport { build } from 'esbuild';\nimport type { IncomingMessage, ServerResponse } from 'http';\nimport path from 'path';\nimport fs from 'fs';\nimport { fileURLToPath } from 'url';\nimport { hmrClients } from './hmr';\nimport { getMimeType } from './utils';\n\n// Cache the compiled HMR bundle Promise so esbuild only runs once per server lifetime.\n// Caching the Promise (not just the result) prevents a race condition where multiple\n// concurrent requests all see null and each kick off their own build.\nlet hmrBundlePromise: Promise<string> | null = null;\n\n// Absolute path to the static public directory.\n// Files here are served at their path relative to this directory.\nconst PUBLIC_DIR = path.resolve('./app/public');\n\nexport default async function middleware(\n  req: IncomingMessage,\n  res: ServerResponse,\n): Promise<void> {\n\n  // \u2500\u2500 Static public files \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  // Checked first so /favicon.ico, /main.css, etc. are never accidentally\n  // routed to the SSR or API layers.\n  const rawUrl = req.url ?? '/';\n  const pathname = rawUrl.split('?')[0]; // strip query string\n\n  if (fs.existsSync(PUBLIC_DIR)) {\n    // path.join handles the leading '/' in pathname naturally and normalises\n    // any '..' segments, making it safe to use directly with a startsWith guard.\n    // Using path.join (not path.resolve) ensures an absolute second argument\n    // cannot silently escape PUBLIC_DIR the way path.resolve would allow.\n    const candidate = path.join(PUBLIC_DIR, pathname);\n\n    // Path traversal guard: the resolved path must be inside PUBLIC_DIR.\n    // We normalise PUBLIC_DIR with a trailing separator so that a directory\n    // whose name is a prefix of another cannot pass (e.g. /public2 vs /public).\n    const publicBase = PUBLIC_DIR.endsWith(path.sep) ? PUBLIC_DIR : PUBLIC_DIR + path.sep;\n    const safe = candidate.startsWith(publicBase) || candidate === PUBLIC_DIR;\n\n    if (!safe) {\n      res.statusCode = 400;\n      res.end('Bad request');\n      return;\n    }\n\n    // Serve the file if it exists at any depth inside PUBLIC_DIR.\n    // Directories are intentionally skipped (no directory listings).\n    if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {\n      const ext = path.extname(candidate);\n      res.setHeader('Content-Type', getMimeType(ext));\n      res.end(fs.readFileSync(candidate));\n      return;\n    }\n  }\n\n  // \u2500\u2500 HMR client script \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  // Builds hmr-bundle.ts on demand so the browser always gets the latest version.\n  if (rawUrl === '/__hmr.js') {\n    if (!hmrBundlePromise) {\n      const dir   = path.dirname(fileURLToPath(import.meta.url));\n      const entry = path.join(dir, `hmr-bundle.${dir.endsWith('dist') ? 'js' : 'ts'}`);\n      hmrBundlePromise = build({\n        entryPoints: [entry],\n        write:       false,\n        format:      'esm',\n        minify:      true,\n        bundle:      true,\n        external:    ['react', 'react-dom/client', 'react/jsx-runtime'],\n      }).then(r => r.outputFiles[0].text);\n    }\n\n    res.setHeader('Content-Type', 'application/javascript');\n    res.end(await hmrBundlePromise);\n    return;\n  }\n\n  // \u2500\u2500 HMR SSE stream \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n  // Long-lived connection tracked in hmrClients so hmr.ts can broadcast events\n  // to all connected browsers when a file changes.\n  if (rawUrl === '/__hmr') {\n    // Each full-page reload opens a new SSE connection before the old one has\n    // fully closed. After ~6 reloads the browser's connection limit is exhausted\n    // and it can't make any new requests \u2014 the server appears to hang.\n    // Fix: allow up to 5 SSE connections per IP; when a 6th arrives, destroy\n    // the oldest one from that IP to free a slot before accepting the new one.\n    const MAX_SSE_PER_IP = 5;\n    const remoteAddr = req.socket?.remoteAddress;\n    if (remoteAddr) {\n      const fromSameIp = [...hmrClients].filter(\n        c => (c as any).socket?.remoteAddress === remoteAddr\n      );\n      if (fromSameIp.length >= MAX_SSE_PER_IP) {\n        // Drop the oldest (first in insertion order).\n        const oldest = fromSameIp[0];\n        oldest.destroy();\n        hmrClients.delete(oldest);\n      }\n    }\n\n    res.setHeader('Content-Type', 'text/event-stream');\n    res.setHeader('Cache-Control', 'no-cache');\n    res.setHeader('Connection', 'keep-alive');\n    res.setHeader('Access-Control-Allow-Origin', '*');\n    res.flushHeaders();\n\n    res.write('data: {\"type\":\"connected\"}\\n\\n');\n\n    hmrClients.add(res);\n    req.on('close', () => hmrClients.delete(res));\n    return;\n  }\n}"],
+  "sourcesContent": ["/**\r\n * middleware.ts \u2014 Built-In NukeJS Middleware\r\n *\r\n * This is the internal middleware loaded before any user-defined middleware.\r\n * It handles three responsibilities:\r\n *\r\n *   1. Static public files  (app/public/**)\r\n *      Any file placed in app/public/ is served at its path relative to\r\n *      that directory.  E.g. app/public/favicon.ico \u2192 GET /favicon.ico.\r\n *      The correct Content-Type is set automatically.  Path traversal attempts\r\n *      are rejected with 400.\r\n *\r\n *   2. HMR client script    (/__hmr.js)\r\n *      Builds and serves hmr-bundle.ts on demand.  Injected into every dev\r\n *      page as <script type=\"module\" src=\"/__hmr.js\">.\r\n *\r\n *   3. HMR SSE stream       (/__hmr)\r\n *      Long-lived Server-Sent Events connection used by the browser to receive\r\n *      reload/replace/restart events when source files change.\r\n */\r\n\r\nimport { build } from 'esbuild';\r\nimport type { IncomingMessage, ServerResponse } from 'http';\r\nimport path from 'path';\r\nimport fs from 'fs';\r\nimport { fileURLToPath } from 'url';\r\nimport { hmrClients } from './hmr';\r\nimport { getMimeType } from './utils';\r\n\r\n// Cache the compiled HMR bundle Promise so esbuild only runs once per server lifetime.\r\n// Caching the Promise (not just the result) prevents a race condition where multiple\r\n// concurrent requests all see null and each kick off their own build.\r\nlet hmrBundlePromise: Promise<string> | null = null;\r\n\r\n// Absolute path to the static public directory.\r\n// Files here are served at their path relative to this directory.\r\nconst PUBLIC_DIR = path.resolve('./app/public');\r\n\r\nexport default async function middleware(\r\n  req: IncomingMessage,\r\n  res: ServerResponse,\r\n): Promise<void> {\r\n\r\n  // \u2500\u2500 Static public files \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n  // Checked first so /favicon.ico, /main.css, etc. are never accidentally\r\n  // routed to the SSR or API layers.\r\n  const rawUrl = req.url ?? '/';\r\n  const pathname = rawUrl.split('?')[0]; // strip query string\r\n\r\n  if (fs.existsSync(PUBLIC_DIR)) {\r\n    // path.join handles the leading '/' in pathname naturally and normalises\r\n    // any '..' segments, making it safe to use directly with a startsWith guard.\r\n    // Using path.join (not path.resolve) ensures an absolute second argument\r\n    // cannot silently escape PUBLIC_DIR the way path.resolve would allow.\r\n    const candidate = path.join(PUBLIC_DIR, pathname);\r\n\r\n    // Path traversal guard: the resolved path must be inside PUBLIC_DIR.\r\n    // We normalise PUBLIC_DIR with a trailing separator so that a directory\r\n    // whose name is a prefix of another cannot pass (e.g. /public2 vs /public).\r\n    const publicBase = PUBLIC_DIR.endsWith(path.sep) ? PUBLIC_DIR : PUBLIC_DIR + path.sep;\r\n    const safe = candidate.startsWith(publicBase) || candidate === PUBLIC_DIR;\r\n\r\n    if (!safe) {\r\n      res.statusCode = 400;\r\n      res.end('Bad request');\r\n      return;\r\n    }\r\n\r\n    // Serve the file if it exists at any depth inside PUBLIC_DIR.\r\n    // Directories are intentionally skipped (no directory listings).\r\n    if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {\r\n      const ext = path.extname(candidate);\r\n      res.setHeader('Content-Type', getMimeType(ext));\r\n      res.end(fs.readFileSync(candidate));\r\n      return;\r\n    }\r\n  }\r\n\r\n  // \u2500\u2500 HMR client script \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n  // Builds hmr-bundle.ts on demand so the browser always gets the latest version.\r\n  if (rawUrl === '/__hmr.js') {\r\n    if (!hmrBundlePromise) {\r\n      const dir   = path.dirname(fileURLToPath(import.meta.url));\r\n      const entry = path.join(dir, `hmr-bundle.${dir.endsWith('dist') ? 'js' : 'ts'}`);\r\n      hmrBundlePromise = build({\r\n        entryPoints: [entry],\r\n        write:       false,\r\n        format:      'esm',\r\n        minify:      true,\r\n        bundle:      true,\r\n        external:    ['react', 'react-dom/client', 'react/jsx-runtime'],\r\n      }).then(r => r.outputFiles[0].text);\r\n    }\r\n\r\n    res.setHeader('Content-Type', 'application/javascript');\r\n    res.end(await hmrBundlePromise);\r\n    return;\r\n  }\r\n\r\n  // \u2500\u2500 HMR SSE stream \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n  // Long-lived connection tracked in hmrClients so hmr.ts can broadcast events\r\n  // to all connected browsers when a file changes.\r\n  if (rawUrl === '/__hmr') {\r\n    // Each full-page reload opens a new SSE connection before the old one has\r\n    // fully closed. After ~6 reloads the browser's connection limit is exhausted\r\n    // and it can't make any new requests \u2014 the server appears to hang.\r\n    // Fix: allow up to 5 SSE connections per IP; when a 6th arrives, destroy\r\n    // the oldest one from that IP to free a slot before accepting the new one.\r\n    const MAX_SSE_PER_IP = 5;\r\n    const remoteAddr = req.socket?.remoteAddress;\r\n    if (remoteAddr) {\r\n      const fromSameIp = [...hmrClients].filter(\r\n        c => (c as any).socket?.remoteAddress === remoteAddr\r\n      );\r\n      if (fromSameIp.length >= MAX_SSE_PER_IP) {\r\n        // Drop the oldest (first in insertion order).\r\n        const oldest = fromSameIp[0];\r\n        oldest.destroy();\r\n        hmrClients.delete(oldest);\r\n      }\r\n    }\r\n\r\n    res.setHeader('Content-Type', 'text/event-stream');\r\n    res.setHeader('Cache-Control', 'no-cache');\r\n    res.setHeader('Connection', 'keep-alive');\r\n    res.setHeader('Access-Control-Allow-Origin', '*');\r\n    res.flushHeaders();\r\n\r\n    res.write('data: {\"type\":\"connected\"}\\n\\n');\r\n\r\n    hmrClients.add(res);\r\n    req.on('close', () => hmrClients.delete(res));\r\n    return;\r\n  }\r\n}"],
   "mappings": "AAqBA,SAAS,aAAa;AAEtB,OAAO,UAAU;AACjB,OAAO,QAAQ;AACf,SAAS,qBAAqB;AAC9B,SAAS,kBAAkB;AAC3B,SAAS,mBAAmB;AAK5B,IAAI,mBAA2C;AAI/C,MAAM,aAAa,KAAK,QAAQ,cAAc;AAE9C,eAAO,WACL,KACA,KACe;AAKf,QAAM,SAAS,IAAI,OAAO;AAC1B,QAAM,WAAW,OAAO,MAAM,GAAG,EAAE,CAAC;AAEpC,MAAI,GAAG,WAAW,UAAU,GAAG;AAK7B,UAAM,YAAY,KAAK,KAAK,YAAY,QAAQ;AAKhD,UAAM,aAAa,WAAW,SAAS,KAAK,GAAG,IAAI,aAAa,aAAa,KAAK;AAClF,UAAM,OAAO,UAAU,WAAW,UAAU,KAAK,cAAc;AAE/D,QAAI,CAAC,MAAM;AACT,UAAI,aAAa;AACjB,UAAI,IAAI,aAAa;AACrB;AAAA,IACF;AAIA,QAAI,GAAG,WAAW,SAAS,KAAK,GAAG,SAAS,SAAS,EAAE,OAAO,GAAG;AAC/D,YAAM,MAAM,KAAK,QAAQ,SAAS;AAClC,UAAI,UAAU,gBAAgB,YAAY,GAAG,CAAC;AAC9C,UAAI,IAAI,GAAG,aAAa,SAAS,CAAC;AAClC;AAAA,IACF;AAAA,EACF;AAIA,MAAI,WAAW,aAAa;AAC1B,QAAI,CAAC,kBAAkB;AACrB,YAAM,MAAQ,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AACzD,YAAM,QAAQ,KAAK,KAAK,KAAK,cAAc,IAAI,SAAS,MAAM,IAAI,OAAO,IAAI,EAAE;AAC/E,yBAAmB,MAAM;AAAA,QACvB,aAAa,CAAC,KAAK;AAAA,QACnB,OAAa;AAAA,QACb,QAAa;AAAA,QACb,QAAa;AAAA,QACb,QAAa;AAAA,QACb,UAAa,CAAC,SAAS,oBAAoB,mBAAmB;AAAA,MAChE,CAAC,EAAE,KAAK,OAAK,EAAE,YAAY,CAAC,EAAE,IAAI;AAAA,IACpC;AAEA,QAAI,UAAU,gBAAgB,wBAAwB;AACtD,QAAI,IAAI,MAAM,gBAAgB;AAC9B;AAAA,EACF;AAKA,MAAI,WAAW,UAAU;AAMvB,UAAM,iBAAiB;AACvB,UAAM,aAAa,IAAI,QAAQ;AAC/B,QAAI,YAAY;AACd,YAAM,aAAa,CAAC,GAAG,UAAU,EAAE;AAAA,QACjC,OAAM,EAAU,QAAQ,kBAAkB;AAAA,MAC5C;AACA,UAAI,WAAW,UAAU,gBAAgB;AAEvC,cAAM,SAAS,WAAW,CAAC;AAC3B,eAAO,QAAQ;AACf,mBAAW,OAAO,MAAM;AAAA,MAC1B;AAAA,IACF;AAEA,QAAI,UAAU,gBAAgB,mBAAmB;AACjD,QAAI,UAAU,iBAAiB,UAAU;AACzC,QAAI,UAAU,cAAc,YAAY;AACxC,QAAI,UAAU,+BAA+B,GAAG;AAChD,QAAI,aAAa;AAEjB,QAAI,MAAM,gCAAgC;AAE1C,eAAW,IAAI,GAAG;AAClB,QAAI,GAAG,SAAS,MAAM,WAAW,OAAO,GAAG,CAAC;AAC5C;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/router.d.ts

@@ -20,8 +20,12 @@
  *   checking whether the file exists.
  */
 /**
- * Recursively collects all .ts/.tsx files in `dir`, returning paths relative to
- * `baseDir` without the file extension.
+ * Recursively collects all routable .ts/.tsx files in `dir`, returning paths
+ * relative to `baseDir` without the file extension.
+ *
+ * layout.tsx files are excluded — they wrap pages but are never routes
+ * themselves.  This mirrors the filter in collectServerPages() so dev-mode
+ * route matching behaves identically to the production build.
  *
  * Example output: ['index', 'users/index', 'users/[id]', 'blog/[...slug]']
  */
@@ -62,6 +66,7 @@ export interface RouteMatch {
  * Steps:
  *   1. Reject '..' or '.' path segments (path traversal guard).
  *   2. Try an exact file match (e.g. /about → baseDir/about.tsx).
+ *      layout.tsx is explicitly excluded from exact matching.
  *   3. Sort all discovered routes by specificity (most specific first).
  *   4. Return the first dynamic route that matches.
  *

package/dist/router.js

@@ -8,6 +8,8 @@ function findAllRoutes(dir, baseDir = dir) {
     if (entry.isDirectory()) {
       routes.push(...findAllRoutes(fullPath, baseDir));
     } else if (entry.name.endsWith(".tsx") || entry.name.endsWith(".ts")) {
+      const stem = entry.name.replace(/\.(tsx|ts)$/, "");
+      if (stem === "layout") continue;
       routes.push(path.relative(baseDir, fullPath).replace(/\.(tsx|ts)$/, ""));
     }
   }
@@ -63,8 +65,9 @@ function matchRoute(urlPath, baseDir, extension = ".tsx") {
   if (rawSegments.some((s) => s === ".." || s === ".")) return null;
   const segments = rawSegments.length === 0 ? ["index"] : rawSegments;
   const exactPath = path.join(baseDir, ...segments) + extension;
+  const exactStem = path.basename(exactPath, extension);
   if (!isWithinBase(baseDir, exactPath)) return null;
-  if (fs.existsSync(exactPath)) {
+  if (exactStem !== "layout" && fs.existsSync(exactPath)) {
     return { filePath: exactPath, params: {}, routePattern: segments.join("/") };
   }
   const sortedRoutes = findAllRoutes(baseDir).sort(

package/dist/router.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/router.ts"],
-  "sourcesContent": ["/**\r\n * router.ts \u2014 File-System Based URL Router\r\n *\r\n * Maps incoming URL paths to handler files using Next.js-compatible conventions:\r\n *\r\n *   server/users/index.ts          \u2192 /users\r\n *   server/users/[id].ts           \u2192 /users/:id         (dynamic segment)\r\n *   server/blog/[...slug].ts       \u2192 /blog/*            (catch-all)\r\n *   server/files/[[...path]].ts    \u2192 /files or /files/* (optional catch-all)\r\n *\r\n * Route specificity (higher = wins over lower):\r\n *   static segment     +4   (e.g. 'about')\r\n *   dynamic segment    +3   (e.g. '[id]')\r\n *   catch-all          +2   (e.g. '[...slug]')\r\n *   optional catch-all +1   (e.g. '[[...path]]')\r\n *\r\n * Path traversal protection:\r\n *   matchRoute() rejects URL segments that contain '..' or '.' and verifies\r\n *   that the resolved file path stays inside the base directory before\r\n *   checking whether the file exists.\r\n */\r\n\r\nimport path from 'path';\r\nimport fs   from 'fs';\r\n\r\n// \u2500\u2500\u2500 Route file discovery \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Recursively collects all .ts/.tsx files in `dir`, returning paths relative to\r\n * `baseDir` without the file extension.\r\n *\r\n * Example output: ['index', 'users/index', 'users/[id]', 'blog/[...slug]']\r\n */\r\nexport function findAllRoutes(dir: string, baseDir: string = dir): string[] {\r\n  if (!fs.existsSync(dir)) return [];\r\n\r\n  const routes: string[] = [];\r\n  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\r\n    const fullPath = path.join(dir, entry.name);\r\n    if (entry.isDirectory()) {\r\n      routes.push(...findAllRoutes(fullPath, baseDir));\r\n    } else if (entry.name.endsWith('.tsx') || entry.name.endsWith('.ts')) {\r\n      routes.push(path.relative(baseDir, fullPath).replace(/\\.(tsx|ts)$/, ''));\r\n    }\r\n  }\r\n  return routes;\r\n}\r\n\r\n// \u2500\u2500\u2500 Dynamic segment matching \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Attempts to match `urlSegments` against a route that may contain dynamic\r\n * segments ([param]), catch-alls ([...slug]), and optional catch-alls ([[...path]]).\r\n *\r\n * Returns the captured params on success, or null if the route does not match.\r\n *\r\n * Param value types:\r\n *   [param]         \u2192 string\r\n *   [...slug]       \u2192 string[]  (at least one segment required)\r\n *   [[...path]]     \u2192 string[]  (zero or more segments)\r\n */\r\nexport function matchDynamicRoute(\r\n  urlSegments:  string[],\r\n  routePath:    string,\r\n): { params: Record<string, string | string[]> } | null {\r\n  const routeSegments = routePath.split(path.sep);\r\n\r\n  // 'index' at the end of a route path means the route handles the parent directory URL.\r\n  if (routeSegments.at(-1) === 'index') routeSegments.pop();\r\n\r\n  const params: Record<string, string | string[]> = {};\r\n  let ri = 0; // route segment index\r\n  let ui = 0; // URL segment index\r\n\r\n  while (ri < routeSegments.length) {\r\n    const seg = routeSegments[ri];\r\n\r\n    // [[...name]] \u2014 optional catch-all: consumes zero or more remaining URL segments.\r\n    const optCatchAll = seg.match(/^\\[\\[\\.\\.\\.(.+)\\]\\]$/);\r\n    if (optCatchAll) {\r\n      params[optCatchAll[1]] = urlSegments.slice(ui);\r\n      return { params };\r\n    }\r\n\r\n    // [...name] \u2014 required catch-all: must consume at least one URL segment.\r\n    const catchAll = seg.match(/^\\[\\.\\.\\.(.+)\\]$/);\r\n    if (catchAll) {\r\n      const remaining = urlSegments.slice(ui);\r\n      if (!remaining.length) return null;\r\n      params[catchAll[1]] = remaining;\r\n      return { params };\r\n    }\r\n\r\n    // [name] \u2014 single dynamic segment: consumes exactly one URL segment.\r\n    const dynamic = seg.match(/^\\[(.+)\\]$/);\r\n    if (dynamic) {\r\n      if (ui >= urlSegments.length) return null;\r\n      params[dynamic[1]] = urlSegments[ui++];\r\n      ri++;\r\n      continue;\r\n    }\r\n\r\n    // Static segment \u2014 must match exactly.\r\n    if (ui >= urlSegments.length || seg !== urlSegments[ui]) return null;\r\n    ui++; ri++;\r\n  }\r\n\r\n  // All route segments consumed \u2014 URL must be fully consumed too.\r\n  return ui < urlSegments.length ? null : { params };\r\n}\r\n\r\n// \u2500\u2500\u2500 Specificity scoring \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Computes a specificity score for a route path.\r\n * Used to sort candidate routes so more specific routes shadow catch-alls.\r\n *\r\n * Higher score = more specific:\r\n *   static segment      4\r\n *   [dynamic]           3\r\n *   [...catchAll]       2\r\n *   [[...optCatchAll]]  1\r\n */\r\nexport function getRouteSpecificity(routePath: string): number {\r\n  return routePath.split(path.sep).reduce((score, seg) => {\r\n    if (seg.match(/^\\[\\[\\.\\.\\.(.+)\\]\\]$/)) return score + 1;\r\n    if (seg.match(/^\\[\\.\\.\\.(.+)\\]$/))     return score + 2;\r\n    if (seg.match(/^\\[(.+)\\]$/))           return score + 3;\r\n    return score + 4; // static segment\r\n  }, 0);\r\n}\r\n\r\n// \u2500\u2500\u2500 Route match result \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nexport interface RouteMatch {\r\n  filePath:     string;\r\n  params:       Record<string, string | string[]>;\r\n  routePattern: string;\r\n}\r\n\r\n// \u2500\u2500\u2500 Path traversal guard \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Returns true only when `filePath` is a descendant of `baseDir`.\r\n * Used to prevent URL path traversal attacks (e.g. /../../etc/passwd).\r\n */\r\nfunction isWithinBase(baseDir: string, filePath: string): boolean {\r\n  const rel = path.relative(baseDir, filePath);\r\n  return Boolean(rel) && !rel.startsWith('..') && !path.isAbsolute(rel);\r\n}\r\n\r\n// \u2500\u2500\u2500 Route matching \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Resolves a URL path to a route file inside `baseDir`.\r\n *\r\n * Steps:\r\n *   1. Reject '..' or '.' path segments (path traversal guard).\r\n *   2. Try an exact file match (e.g. /about \u2192 baseDir/about.tsx).\r\n *   3. Sort all discovered routes by specificity (most specific first).\r\n *   4. Return the first dynamic route that matches.\r\n *\r\n * @param urlPath   The URL path to match (e.g. '/users/42').\r\n * @param baseDir   Absolute path to the directory containing route files.\r\n * @param extension File extension to look for ('.tsx' or '.ts').\r\n */\r\nexport function matchRoute(\r\n  urlPath:   string,\r\n  baseDir:   string,\r\n  extension = '.tsx',\r\n): RouteMatch | null {\r\n  // Split the URL path into segments, rejecting any that attempt path traversal.\r\n  const rawSegments = urlPath === '/' ? [] : urlPath.slice(1).split('/');\r\n  if (rawSegments.some(s => s === '..' || s === '.')) return null;\r\n\r\n  // For the root URL, look for an index file.\r\n  const segments = rawSegments.length === 0 ? ['index'] : rawSegments;\r\n\r\n  // 1. Exact match: /about \u2192 about.tsx\r\n  const exactPath = path.join(baseDir, ...segments) + extension;\r\n  if (!isWithinBase(baseDir, exactPath)) return null;\r\n  if (fs.existsSync(exactPath)) {\r\n    return { filePath: exactPath, params: {}, routePattern: segments.join('/') };\r\n  }\r\n\r\n  // 2. Dynamic match \u2014 try routes sorted by specificity so '[id]' wins over '[...all]'.\r\n  const sortedRoutes = findAllRoutes(baseDir).sort(\r\n    (a, b) => getRouteSpecificity(b) - getRouteSpecificity(a),\r\n  );\r\n\r\n  for (const route of sortedRoutes) {\r\n    const match = matchDynamicRoute(segments, route);\r\n    if (!match) continue;\r\n    const filePath = path.join(baseDir, route) + extension;\r\n    if (!isWithinBase(baseDir, filePath)) continue;\r\n    if (fs.existsSync(filePath)) {\r\n      return { filePath, params: match.params, routePattern: route };\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n// \u2500\u2500\u2500 Layout discovery \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Returns every layout.tsx file that wraps a given route file, in\r\n * outermost-first order (root layout first, nearest layout last).\r\n *\r\n * Layout chain example for app/pages/blog/[slug]/page.tsx:\r\n *   app/pages/layout.tsx          \u2190 root layout\r\n *   app/pages/blog/layout.tsx     \u2190 blog section layout\r\n *\r\n * The outermost-first order matches how wrapWithLayouts() nests them:\r\n * the last layout in the array is the innermost wrapper.\r\n */\r\nexport function findLayoutsForRoute(routeFilePath: string, pagesDir: string): string[] {\r\n  const layouts: string[] = [];\r\n\r\n  // Root layout wraps everything.\r\n  const rootLayout = path.join(pagesDir, 'layout.tsx');\r\n  if (fs.existsSync(rootLayout)) layouts.push(rootLayout);\r\n\r\n  // Walk the directory hierarchy from pagesDir to the file's parent.\r\n  const relativePath = path.relative(pagesDir, path.dirname(routeFilePath));\r\n  if (!relativePath || relativePath === '.') return layouts;\r\n\r\n  const segments = relativePath.split(path.sep).filter(s => s !== '.');\r\n  for (let i = 1; i <= segments.length; i++) {\r\n    const layoutPath = path.join(pagesDir, ...segments.slice(0, i), 'layout.tsx');\r\n    if (fs.existsSync(layoutPath)) layouts.push(layoutPath);\r\n  }\r\n\r\n  return layouts;\r\n}\r\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\r\n * router.ts \u2014 File-System Based URL Router\r\n *\r\n * Maps incoming URL paths to handler files using Next.js-compatible conventions:\r\n *\r\n *   server/users/index.ts          \u2192 /users\r\n *   server/users/[id].ts           \u2192 /users/:id         (dynamic segment)\r\n *   server/blog/[...slug].ts       \u2192 /blog/*            (catch-all)\r\n *   server/files/[[...path]].ts    \u2192 /files or /files/* (optional catch-all)\r\n *\r\n * Route specificity (higher = wins over lower):\r\n *   static segment     +4   (e.g. 'about')\r\n *   dynamic segment    +3   (e.g. '[id]')\r\n *   catch-all          +2   (e.g. '[...slug]')\r\n *   optional catch-all +1   (e.g. '[[...path]]')\r\n *\r\n * Path traversal protection:\r\n *   matchRoute() rejects URL segments that contain '..' or '.' and verifies\r\n *   that the resolved file path stays inside the base directory before\r\n *   checking whether the file exists.\r\n */\r\n\r\nimport path from 'path';\r\nimport fs   from 'fs';\r\n\r\n// \u2500\u2500\u2500 Route file discovery \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Recursively collects all routable .ts/.tsx files in `dir`, returning paths\r\n * relative to `baseDir` without the file extension.\r\n *\r\n * layout.tsx files are excluded \u2014 they wrap pages but are never routes\r\n * themselves.  This mirrors the filter in collectServerPages() so dev-mode\r\n * route matching behaves identically to the production build.\r\n *\r\n * Example output: ['index', 'users/index', 'users/[id]', 'blog/[...slug]']\r\n */\r\nexport function findAllRoutes(dir: string, baseDir: string = dir): string[] {\r\n  if (!fs.existsSync(dir)) return [];\r\n\r\n  const routes: string[] = [];\r\n  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\r\n    const fullPath = path.join(dir, entry.name);\r\n    if (entry.isDirectory()) {\r\n      routes.push(...findAllRoutes(fullPath, baseDir));\r\n    } else if (entry.name.endsWith('.tsx') || entry.name.endsWith('.ts')) {\r\n      const stem = entry.name.replace(/\\.(tsx|ts)$/, '');\r\n      if (stem === 'layout') continue;\r\n      routes.push(path.relative(baseDir, fullPath).replace(/\\.(tsx|ts)$/, ''));\r\n    }\r\n  }\r\n  return routes;\r\n}\r\n\r\n// \u2500\u2500\u2500 Dynamic segment matching \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Attempts to match `urlSegments` against a route that may contain dynamic\r\n * segments ([param]), catch-alls ([...slug]), and optional catch-alls ([[...path]]).\r\n *\r\n * Returns the captured params on success, or null if the route does not match.\r\n *\r\n * Param value types:\r\n *   [param]         \u2192 string\r\n *   [...slug]       \u2192 string[]  (at least one segment required)\r\n *   [[...path]]     \u2192 string[]  (zero or more segments)\r\n */\r\nexport function matchDynamicRoute(\r\n  urlSegments:  string[],\r\n  routePath:    string,\r\n): { params: Record<string, string | string[]> } | null {\r\n  const routeSegments = routePath.split(path.sep);\r\n\r\n  // 'index' at the end of a route path means the route handles the parent directory URL.\r\n  if (routeSegments.at(-1) === 'index') routeSegments.pop();\r\n\r\n  const params: Record<string, string | string[]> = {};\r\n  let ri = 0; // route segment index\r\n  let ui = 0; // URL segment index\r\n\r\n  while (ri < routeSegments.length) {\r\n    const seg = routeSegments[ri];\r\n\r\n    // [[...name]] \u2014 optional catch-all: consumes zero or more remaining URL segments.\r\n    const optCatchAll = seg.match(/^\\[\\[\\.\\.\\.(.+)\\]\\]$/);\r\n    if (optCatchAll) {\r\n      params[optCatchAll[1]] = urlSegments.slice(ui);\r\n      return { params };\r\n    }\r\n\r\n    // [...name] \u2014 required catch-all: must consume at least one URL segment.\r\n    const catchAll = seg.match(/^\\[\\.\\.\\.(.+)\\]$/);\r\n    if (catchAll) {\r\n      const remaining = urlSegments.slice(ui);\r\n      if (!remaining.length) return null;\r\n      params[catchAll[1]] = remaining;\r\n      return { params };\r\n    }\r\n\r\n    // [name] \u2014 single dynamic segment: consumes exactly one URL segment.\r\n    const dynamic = seg.match(/^\\[(.+)\\]$/);\r\n    if (dynamic) {\r\n      if (ui >= urlSegments.length) return null;\r\n      params[dynamic[1]] = urlSegments[ui++];\r\n      ri++;\r\n      continue;\r\n    }\r\n\r\n    // Static segment \u2014 must match exactly.\r\n    if (ui >= urlSegments.length || seg !== urlSegments[ui]) return null;\r\n    ui++; ri++;\r\n  }\r\n\r\n  // All route segments consumed \u2014 URL must be fully consumed too.\r\n  return ui < urlSegments.length ? null : { params };\r\n}\r\n\r\n// \u2500\u2500\u2500 Specificity scoring \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Computes a specificity score for a route path.\r\n * Used to sort candidate routes so more specific routes shadow catch-alls.\r\n *\r\n * Higher score = more specific:\r\n *   static segment      4\r\n *   [dynamic]           3\r\n *   [...catchAll]       2\r\n *   [[...optCatchAll]]  1\r\n */\r\nexport function getRouteSpecificity(routePath: string): number {\r\n  return routePath.split(path.sep).reduce((score, seg) => {\r\n    if (seg.match(/^\\[\\[\\.\\.\\.(.+)\\]\\]$/)) return score + 1;\r\n    if (seg.match(/^\\[\\.\\.\\.(.+)\\]$/))     return score + 2;\r\n    if (seg.match(/^\\[(.+)\\]$/))           return score + 3;\r\n    return score + 4; // static segment\r\n  }, 0);\r\n}\r\n\r\n// \u2500\u2500\u2500 Route match result \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\nexport interface RouteMatch {\r\n  filePath:     string;\r\n  params:       Record<string, string | string[]>;\r\n  routePattern: string;\r\n}\r\n\r\n// \u2500\u2500\u2500 Path traversal guard \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Returns true only when `filePath` is a descendant of `baseDir`.\r\n * Used to prevent URL path traversal attacks (e.g. /../../etc/passwd).\r\n */\r\nfunction isWithinBase(baseDir: string, filePath: string): boolean {\r\n  const rel = path.relative(baseDir, filePath);\r\n  return Boolean(rel) && !rel.startsWith('..') && !path.isAbsolute(rel);\r\n}\r\n\r\n// \u2500\u2500\u2500 Route matching \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Resolves a URL path to a route file inside `baseDir`.\r\n *\r\n * Steps:\r\n *   1. Reject '..' or '.' path segments (path traversal guard).\r\n *   2. Try an exact file match (e.g. /about \u2192 baseDir/about.tsx).\r\n *      layout.tsx is explicitly excluded from exact matching.\r\n *   3. Sort all discovered routes by specificity (most specific first).\r\n *   4. Return the first dynamic route that matches.\r\n *\r\n * @param urlPath   The URL path to match (e.g. '/users/42').\r\n * @param baseDir   Absolute path to the directory containing route files.\r\n * @param extension File extension to look for ('.tsx' or '.ts').\r\n */\r\nexport function matchRoute(\r\n  urlPath:   string,\r\n  baseDir:   string,\r\n  extension = '.tsx',\r\n): RouteMatch | null {\r\n  // Split the URL path into segments, rejecting any that attempt path traversal.\r\n  const rawSegments = urlPath === '/' ? [] : urlPath.slice(1).split('/');\r\n  if (rawSegments.some(s => s === '..' || s === '.')) return null;\r\n\r\n  // For the root URL, look for an index file.\r\n  const segments = rawSegments.length === 0 ? ['index'] : rawSegments;\r\n\r\n  // 1. Exact match: /about \u2192 about.tsx \u2014 never resolve to a layout file.\r\n  const exactPath = path.join(baseDir, ...segments) + extension;\r\n  const exactStem = path.basename(exactPath, extension);\r\n  if (!isWithinBase(baseDir, exactPath)) return null;\r\n  if (exactStem !== 'layout' && fs.existsSync(exactPath)) {\r\n    return { filePath: exactPath, params: {}, routePattern: segments.join('/') };\r\n  }\r\n\r\n  // 2. Dynamic match \u2014 try routes sorted by specificity so '[id]' wins over '[...all]'.\r\n  const sortedRoutes = findAllRoutes(baseDir).sort(\r\n    (a, b) => getRouteSpecificity(b) - getRouteSpecificity(a),\r\n  );\r\n\r\n  for (const route of sortedRoutes) {\r\n    const match = matchDynamicRoute(segments, route);\r\n    if (!match) continue;\r\n    const filePath = path.join(baseDir, route) + extension;\r\n    if (!isWithinBase(baseDir, filePath)) continue;\r\n    if (fs.existsSync(filePath)) {\r\n      return { filePath, params: match.params, routePattern: route };\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n// \u2500\u2500\u2500 Layout discovery \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\r\n\r\n/**\r\n * Returns every layout.tsx file that wraps a given route file, in\r\n * outermost-first order (root layout first, nearest layout last).\r\n *\r\n * Layout chain example for app/pages/blog/[slug]/page.tsx:\r\n *   app/pages/layout.tsx          \u2190 root layout\r\n *   app/pages/blog/layout.tsx     \u2190 blog section layout\r\n *\r\n * The outermost-first order matches how wrapWithLayouts() nests them:\r\n * the last layout in the array is the innermost wrapper.\r\n */\r\nexport function findLayoutsForRoute(routeFilePath: string, pagesDir: string): string[] {\r\n  const layouts: string[] = [];\r\n\r\n  // Root layout wraps everything.\r\n  const rootLayout = path.join(pagesDir, 'layout.tsx');\r\n  if (fs.existsSync(rootLayout)) layouts.push(rootLayout);\r\n\r\n  // Walk the directory hierarchy from pagesDir to the file's parent.\r\n  const relativePath = path.relative(pagesDir, path.dirname(routeFilePath));\r\n  if (!relativePath || relativePath === '.') return layouts;\r\n\r\n  const segments = relativePath.split(path.sep).filter(s => s !== '.');\r\n  for (let i = 1; i <= segments.length; i++) {\r\n    const layoutPath = path.join(pagesDir, ...segments.slice(0, i), 'layout.tsx');\r\n    if (fs.existsSync(layoutPath)) layouts.push(layoutPath);\r\n  }\r\n\r\n  return layouts;\r\n}"],
+  "mappings": "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",
   "names": []
 }

package/dist/ssr.d.ts

@@ -6,7 +6,7 @@
  *   1. Match the incoming URL to a page file in app/pages using the file-system
  *      router.
  *   2. Discover the layout chain (layout.tsx files from root to the page dir).
- *   3. Dynamically import the page and layout modules (always fresh via ?t=Date.now()).
+ *   3. Dynamically import the page and layout modules (always fresh via tsImport).
  *   4. Walk the import tree to discover all "use client" components.
  *   5. Render the wrapped element tree with the async renderer.
  *   6. Flush the html-store (title, meta, link, script, style tags).
@@ -23,9 +23,15 @@
  * HMR fast path:
  *   When the request URL contains `__hmr=1` (added by the HMR client during
  *   soft navigation), the renderer skips client-component renderToString
- *   (ctx.skipClientSSR = true).  This significantly speeds up HMR reloads
- *   because the client already has the DOM in place and only needs the new
- *   server-rendered markup.
+ *   (ctx.skipClientSSR = true).  This speeds up HMR reloads because the
+ *   client already has the DOM in place and only needs fresh server markup.
+ *
+ * Head tag sentinels:
+ *   Every useHtml()-generated <meta>, <link>, <style>, and <script> tag is
+ *   wrapped in <!--n-head-->…<!--/n-head--> comment sentinels.  The client
+ *   runtime uses these to diff and sync head tags on SPA navigation without
+ *   touching permanent tags (charset, viewport, importmap, runtime script).
+ *   Pages with no useHtml head tags emit no sentinels.
  */
 import type { ServerResponse } from 'http';
 /**

package/dist/ssr.js

@@ -73,6 +73,16 @@ function renderStyleTag(tag) {
   const media = tag.media ? ` media="${escapeAttr(tag.media)}"` : "";
   return `  <style${media}>${tag.content ?? ""}</style>`;
 }
+function renderManagedHeadTags(store) {
+  const tags = [
+    ...store.meta.map(renderMetaTag),
+    ...store.link.map(renderLinkTag),
+    ...store.style.map(renderStyleTag),
+    ...store.script.map(renderScriptTag)
+  ];
+  if (tags.length === 0) return [];
+  return ["  <!--n-head-->", ...tags, "  <!--/n-head-->"];
+}
 async function serverSideRender(url, res, pagesDir, isDev = false) {
   const skipClientSSR = url.includes("__hmr=1");
   const cleanUrl = url.split("?")[0];
@@ -114,16 +124,11 @@ async function serverSideRender(url, res, pagesDir, isDev = false) {
     '  <meta charset="utf-8" />',
     '  <meta name="viewport" content="width=device-width, initial-scale=1" />',
     `  <title>${escapeAttr(pageTitle)}</title>`,
-    ...store.meta.map(renderMetaTag),
-    ...store.link.map(renderLinkTag),
-    ...store.style.map(renderStyleTag),
-    ...store.script.map(renderScriptTag)
+    ...renderManagedHeadTags(store)
   ];
   const runtimeData = JSON.stringify({
     hydrateIds: [...ctx.hydrated],
-    // only components actually rendered
     allIds: [...registry.keys()],
-    // all reachable — pre-load for SPA nav
     url,
     params,
     debug: toClientDebugLevel(getDebugLevel())