@askrjs/askr 0.0.27 → 0.0.29

package/dist/boot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/boot/index.ts"],"sourcesContent":["/**\n * App bootstrap and mount\n */\n\nimport {\n  createComponentInstance,\n  mountComponent,\n  cleanupComponent,\n  type ComponentFunction,\n  type ComponentInstance,\n} from '../runtime/component';\nimport {\n  isDevelopmentEnvironment,\n  isProductionEnvironment,\n} from '../common/env';\nimport { logger } from '../dev/logger';\nimport { initializeNavigation, registerAppInstance } from '../router/navigate';\nimport {\n  configureScrollRestoration,\n  type ScrollRestorationOptions,\n} from '../router/navigate';\nimport {\n  _applyManifest,\n  _drainLazy,\n  _setActiveRouteAuthOptions,\n  _snapshotLazy,\n  clearRoutes,\n  lockRouteRegistration,\n  resolveRoute,\n  resolveRouteRequest,\n  route as registerRoute,\n  setServerLocation,\n} from '../router/route';\nimport { globalScheduler } from '../runtime/scheduler';\nimport { assertExecutionModel } from '../runtime/execution-model';\n\nconst HAS_ROUTES_KEY = Symbol.for('__ASKR_HAS_ROUTES__');\n\nlet componentIdCounter = 0;\n\n// Track instances by root element to support multiple createIsland calls on same root\nconst instancesByRoot = new WeakMap<Element, ComponentInstance>();\n\n// Symbol for storing cleanup on elements\nconst CLEANUP_SYMBOL = Symbol.for('__tempoCleanup__');\n\n// Type for elements that have cleanup functions attached\ninterface ElementWithCleanup extends Element {\n  [CLEANUP_SYMBOL]?: () => void;\n}\n\nfunction attachCleanupForRoot(\n  rootElement: Element,\n  instance: ComponentInstance\n) {\n  (rootElement as ElementWithCleanup)[CLEANUP_SYMBOL] = () => {\n    // Attempt to remove listeners and cleanup instances under the root.\n    // In non-strict mode we preserve previous behavior by swallowing errors\n    // (but logging in dev); in strict mode we aggregate and re-throw.\n    const errors: unknown[] = [];\n    try {\n      removeAllListeners(rootElement);\n    } catch (e) {\n      errors.push(e);\n    }\n\n    // Manually traverse descendants and attempt to cleanup their instances.\n    // Avoids import cycles by using local traversal and existing cleanupComponent.\n    try {\n      const descendants = rootElement.querySelectorAll('*');\n      for (const d of Array.from(descendants)) {\n        try {\n          const inst = (d as Element & { __ASKR_INSTANCE?: ComponentInstance })\n            .__ASKR_INSTANCE;\n          if (inst) {\n            try {\n              cleanupComponent(inst);\n            } catch (err) {\n              errors.push(err);\n            }\n            try {\n              delete (d as Element & { __ASKR_INSTANCE?: ComponentInstance })\n                .__ASKR_INSTANCE;\n            } catch (err) {\n              errors.push(err);\n            }\n          }\n        } catch (err) {\n          errors.push(err);\n        }\n      }\n    } catch (e) {\n      errors.push(e);\n    }\n\n    try {\n      cleanupComponent(instance as ComponentInstance);\n    } catch (e) {\n      errors.push(e);\n    }\n\n    if (errors.length > 0) {\n      if (instance.cleanupStrict) {\n        throw new AggregateError(errors, `cleanup failed for app root`);\n      } else if (isDevelopmentEnvironment()) {\n        for (const err of errors) logger.warn('[Askr] cleanup error:', err);\n      }\n    }\n  };\n\n  try {\n    const descriptor =\n      Object.getOwnPropertyDescriptor(rootElement, 'innerHTML') ||\n      Object.getOwnPropertyDescriptor(\n        Object.getPrototypeOf(rootElement),\n        'innerHTML'\n      ) ||\n      Object.getOwnPropertyDescriptor(Element.prototype, 'innerHTML');\n\n    if (descriptor && (descriptor.get || descriptor.set)) {\n      Object.defineProperty(rootElement, 'innerHTML', {\n        get: descriptor.get\n          ? function (this: Element) {\n              return descriptor.get!.call(this);\n            }\n          : undefined,\n        set: function (this: Element, value: string) {\n          if (value === '' && instancesByRoot.get(this) === instance) {\n            try {\n              removeAllListeners(rootElement);\n            } catch (e) {\n              if (instance.cleanupStrict) throw e;\n              if (isDevelopmentEnvironment()) {\n                logger.warn('[Askr] cleanup error:', e);\n              }\n            }\n\n            try {\n              cleanupComponent(instance as ComponentInstance);\n            } catch (e) {\n              if (instance.cleanupStrict) throw e;\n              if (isDevelopmentEnvironment()) {\n                logger.warn('[Askr] cleanup error:', e);\n              }\n            }\n          }\n          if (descriptor.set) {\n            return descriptor.set.call(this, value);\n          }\n        },\n        configurable: true,\n      });\n    }\n  } catch {\n    // If Object.defineProperty fails, ignore\n  }\n}\n\n/**\n * Explicitly teardown an app mounted on `root` if present. This is the\n * recommended API for deterministic cleanup rather than relying on overriding\n * `innerHTML` setter behavior.\n */\nexport function teardownApp(_root: Element | string) {\n  throw new Error(\n    'The `teardownApp` alias has been removed. Use `cleanupApp(root)` instead.'\n  );\n}\n\nimport { Fragment, ELEMENT_TYPE } from '../jsx';\n\nimport { DefaultPortal } from '../foundations/structures/portal';\n\nfunction mountOrUpdate(\n  rootElement: Element,\n  componentFn: ComponentFunction,\n  options?: { cleanupStrict?: boolean }\n) {\n  // Ensure root component always includes a DefaultPortal host by wrapping it.\n  const wrappedFn: ComponentFunction = (props, ctx) => {\n    const out = componentFn(props, ctx);\n    const portalVNode = {\n      $$typeof: ELEMENT_TYPE,\n      type: DefaultPortal,\n      props: {},\n      key: '__default_portal',\n    } as unknown;\n    return {\n      $$typeof: ELEMENT_TYPE,\n      type: Fragment,\n      props: {\n        children:\n          out === undefined || out === null\n            ? [portalVNode]\n            : [out, portalVNode],\n      },\n    } as unknown as ReturnType<ComponentFunction>;\n  };\n  // Preserve the original component name for debugging/dev warnings\n  Object.defineProperty(wrappedFn, 'name', {\n    value: componentFn.name || 'Component',\n  });\n\n  // Clean up existing cleanup function before mounting new one\n  const existingCleanup = (rootElement as ElementWithCleanup)[CLEANUP_SYMBOL];\n  if (existingCleanup) existingCleanup();\n\n  let instance = instancesByRoot.get(rootElement);\n\n  if (instance) {\n    removeAllListeners(rootElement);\n    try {\n      cleanupComponent(instance);\n    } catch (e) {\n      // If previous cleanup threw in strict mode, log but continue mounting new instance\n      if (isDevelopmentEnvironment()) {\n        logger.warn('[Askr] prior cleanup threw:', e);\n      }\n    }\n\n    instance.fn = wrappedFn;\n    instance.evaluationGeneration++;\n    instance.mounted = false;\n    instance.expectedStateIndices = [];\n    instance.firstRenderComplete = false;\n    instance.isRoot = true;\n    // Update strict flag if provided\n    if (options && typeof options.cleanupStrict === 'boolean') {\n      instance.cleanupStrict = options.cleanupStrict;\n    }\n  } else {\n    const componentId = String(++componentIdCounter);\n    instance = createComponentInstance(componentId, wrappedFn, {}, rootElement);\n    instancesByRoot.set(rootElement, instance);\n    instance.isRoot = true;\n    // Initialize strict flag from options\n    if (options && typeof options.cleanupStrict === 'boolean') {\n      instance.cleanupStrict = options.cleanupStrict;\n    }\n  }\n\n  attachCleanupForRoot(rootElement, instance);\n  mountComponent(instance);\n  globalScheduler.flush();\n}\n\nfunction bindResolvedRouteHandler(resolved: ResolvedRoute): ComponentFunction {\n  return () =>\n    resolved.handler(resolved.params) as ReturnType<ComponentFunction>;\n}\n\nfunction bindDeniedStatus(status: number): ComponentFunction {\n  return () => ({\n    type: 'div',\n    props: {\n      'data-route-denied': String(status),\n    },\n    children: [String(status)],\n  });\n}\n\n// New strongly-typed init functions\nimport type {\n  Route,\n  RouteManifest,\n  ResolvedRoute,\n  RouteAuthOptions,\n} from '../common/router';\nimport { installRendererBridge, removeAllListeners } from '../renderer';\ninstallRendererBridge();\n\nexport type IslandConfig = {\n  root: Element | string;\n  component: ComponentFunction;\n  // Optional: surface cleanup errors during teardown for this island\n  cleanupStrict?: boolean;\n  // Explicitly disallow routes on islands at type level\n  routes?: never;\n};\n\nexport type IslandsConfig = {\n  islands: IslandConfig[];\n};\n\nexport type SPAConfig = {\n  root: Element | string;\n  /**\n   * Preferred: pass the route manifest built via `registerRoutes(() => { ... })`.\n   * ```ts\n   * import { getManifest } from '@askrjs/askr/router';\n   * await createSPA({ root: '#app', manifest: getManifest() });\n   * ```\n   */\n  manifest?: RouteManifest;\n  /** Legacy: flat route array — kept for backward compatibility and test fixtures. */\n  routes?: Route[];\n  auth?: RouteAuthOptions;\n  scrollRestoration?: boolean | ScrollRestorationOptions;\n  cleanupStrict?: boolean;\n  component?: never;\n};\n\nexport type HydrateSPAConfig = {\n  root: Element | string;\n  /** Preferred manifest input — see `SPAConfig.manifest`. */\n  manifest?: RouteManifest;\n  /** Legacy flat route array. */\n  routes?: Route[];\n  auth?: RouteAuthOptions;\n  scrollRestoration?: boolean | ScrollRestorationOptions;\n  cleanupStrict?: boolean;\n  hydrate?: {\n    verifyMarkup?: boolean;\n    deferUntilIdle?: boolean;\n    deferBelowFold?: boolean;\n    foldThreshold?: number;\n    skipSelectors?: string[];\n  };\n};\n\n/**\n * createIsland: Enhances existing DOM (no router, mounts once)\n */\nexport function createIsland(config: IslandConfig): void {\n  assertExecutionModel('islands');\n  if (!config || typeof config !== 'object') {\n    throw new Error('createIsland requires a config object');\n  }\n  if (typeof config.component !== 'function') {\n    throw new Error('createIsland: component must be a function');\n  }\n\n  const rootElement =\n    typeof config.root === 'string'\n      ? document.getElementById(config.root)\n      : config.root;\n  if (!rootElement) throw new Error(`Root element not found: ${config.root}`);\n\n  // Islands must not initialize router or routes\n  if ('routes' in config) {\n    throw new Error(\n      'createIsland does not accept routes; use createSPA for routed apps'\n    );\n  }\n\n  // Routes are never supported with islands.\n  // If routes were registered (even at module load time), fail fast to avoid\n  // surprising partial router behavior.\n  try {\n    const g = globalThis as unknown as Record<string | symbol, unknown>;\n    if (g[HAS_ROUTES_KEY]) {\n      throw new Error(\n        'Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.'\n      );\n    }\n  } catch {\n    // ignore\n  }\n\n  mountOrUpdate(rootElement, config.component, {\n    cleanupStrict: config.cleanupStrict,\n  });\n}\n\n/**\n * createIslands: Enhances one or more existing DOM roots (no router).\n * The only public islands constructor.\n */\nexport function createIslands(config: IslandsConfig): void {\n  assertExecutionModel('islands');\n  if (!config || typeof config !== 'object') {\n    throw new Error('createIslands requires a config object');\n  }\n  if (!Array.isArray(config.islands) || config.islands.length === 0) {\n    throw new Error('createIslands requires a non-empty islands array');\n  }\n  for (const island of config.islands) {\n    createIsland(island);\n  }\n}\n\n/**\n * createSPA: Initializes router and mounts the app with the provided route manifest or route table.\n *\n * Preferred usage with manifest:\n * ```ts\n * import { getManifest } from '@askrjs/askr/router';\n * await createSPA({ root: '#app', manifest: getManifest() });\n * ```\n *\n * Legacy usage with plain routes array (still supported):\n * ```ts\n * await createSPA({ root: '#app', routes: getRoutes() });\n * ```\n */\nexport async function createSPA(config: SPAConfig): Promise<void> {\n  assertExecutionModel('spa');\n  if (!config || typeof config !== 'object') {\n    throw new Error('createSPA requires a config object');\n  }\n\n  const hasManifest =\n    config.manifest != null && config.manifest.records.length > 0;\n  const hasRoutes = Array.isArray(config.routes) && config.routes.length > 0;\n\n  if (!hasManifest && !hasRoutes) {\n    throw new Error(\n      'createSPA requires a route manifest or route table. ' +\n        'Pass `manifest: getManifest()` or `routes: getRoutes()`. ' +\n        'If you are enhancing existing HTML, use createIsland instead.'\n    );\n  }\n\n  const rootElement =\n    typeof config.root === 'string'\n      ? document.getElementById(config.root)\n      : config.root;\n  if (!rootElement) throw new Error(`Root element not found: ${config.root}`);\n\n  const pendingLazyAtBoot = _snapshotLazy();\n\n  configureScrollRestoration(config.scrollRestoration);\n\n  clearRoutes();\n\n  if (hasManifest) {\n    // Preferred path: apply pre-built manifest records directly\n    _applyManifest(config.manifest!);\n  } else {\n    // Legacy path: register plain Route objects (no layout metadata)\n    for (const r of config.routes!) {\n      registerRoute(r.path, r.handler as Parameters<typeof registerRoute>[1]);\n    }\n  }\n\n  const routeAuth = config.auth ?? config.manifest?.auth;\n  _setActiveRouteAuthOptions(routeAuth);\n\n  // Drain any lazy() imports so all split chunks are ready before mounting\n  await _drainLazy(pendingLazyAtBoot);\n\n  // Lock registration in production to prevent late registration surprises\n  if (isProductionEnvironment()) lockRouteRegistration();\n\n  // Mount the currently-resolved route handler (if any)\n  let path = typeof window !== 'undefined' ? window.location.pathname : '/';\n  let href =\n    typeof window !== 'undefined'\n      ? `${window.location.pathname}${window.location.search}${window.location.hash}`\n      : path;\n  let resolved = await resolveRouteRequest(href, { auth: routeAuth });\n\n  while (\n    typeof window !== 'undefined' &&\n    resolved &&\n    resolved.kind === 'redirect'\n  ) {\n    const redirectTarget = new URL(resolved.to, window.location.href);\n    const redirectHref = `${redirectTarget.pathname}${redirectTarget.search}${redirectTarget.hash}`;\n    window.history.replaceState({ path: redirectHref }, '', redirectHref);\n    path = redirectTarget.pathname;\n    href = redirectHref;\n    resolved = await resolveRouteRequest(href, { auth: routeAuth });\n  }\n\n  if (!resolved) {\n    mountOrUpdate(rootElement, () => ({ type: 'div', children: [] }), {\n      cleanupStrict: config.cleanupStrict,\n    });\n\n    await registerAppNavigation(rootElement, path);\n    return;\n  }\n\n  if (resolved.kind === 'redirect') {\n    mountOrUpdate(rootElement, () => ({ type: 'div', children: [] }), {\n      cleanupStrict: config.cleanupStrict,\n    });\n\n    await registerAppNavigation(rootElement, path);\n    return;\n  }\n\n  mountOrUpdate(\n    rootElement,\n    resolved.kind === 'deny'\n      ? bindDeniedStatus(resolved.status)\n      : bindResolvedRouteHandler({\n          handler: resolved.handler,\n          params: resolved.params,\n        }),\n    {\n      cleanupStrict: config.cleanupStrict,\n    }\n  );\n\n  await registerAppNavigation(rootElement, path);\n}\n\n/**\n * Mark elements that should be skipped during hydration\n */\nfunction markSkippedElements(root: Element, skipSelectors: string[]): void {\n  for (const selector of skipSelectors) {\n    const elements = root.querySelectorAll(selector);\n    elements.forEach((el) => el.setAttribute('data-skip-hydrate', 'true'));\n  }\n}\n\nfunction collectDeferredBelowFoldBoundaries(\n  root: Element,\n  foldY: number\n): Element[] {\n  const boundaries: Element[] = [];\n  const stack: Element[] = [];\n\n  for (let index = root.children.length - 1; index >= 0; index -= 1) {\n    stack.push(root.children[index]);\n  }\n\n  while (stack.length > 0) {\n    const element = stack.pop()!;\n\n    if (element.hasAttribute('data-skip-hydrate')) {\n      continue;\n    }\n\n    const rect = element.getBoundingClientRect();\n    if (rect.top >= foldY) {\n      element.setAttribute('data-skip-hydrate', 'true');\n      boundaries.push(element);\n      continue;\n    }\n\n    for (let index = element.children.length - 1; index >= 0; index -= 1) {\n      stack.push(element.children[index]);\n    }\n  }\n\n  return boundaries;\n}\n\nfunction activateVisibleDeferredBoundaries(\n  boundaries: Element[],\n  foldY: number\n): { activated: boolean; remaining: number } {\n  let activated = false;\n  let remaining = 0;\n\n  for (const element of boundaries) {\n    if (!element.hasAttribute('data-skip-hydrate')) {\n      continue;\n    }\n\n    const rect = element.getBoundingClientRect();\n    if (rect.top < foldY) {\n      element.removeAttribute('data-skip-hydrate');\n      activated = true;\n    } else {\n      remaining += 1;\n    }\n  }\n\n  return { activated, remaining };\n}\n\nfunction queueIdleWork(work: () => void): Promise<void> {\n  return new Promise((resolve) => {\n    if (typeof requestIdleCallback !== 'undefined') {\n      requestIdleCallback(\n        () => {\n          work();\n          resolve();\n        },\n        { timeout: 2000 }\n      );\n      return;\n    }\n\n    setTimeout(() => {\n      work();\n      resolve();\n    }, 0);\n  });\n}\n\nfunction flushHydrationActivation(rootElement: Element): void {\n  const instance = instancesByRoot.get(rootElement);\n  if (!instance) return;\n  instance._enqueueRun?.();\n  globalScheduler.flush();\n}\n\nfunction shouldVerifyHydrationMarkup(config: HydrateSPAConfig): boolean {\n  const explicit = config.hydrate?.verifyMarkup;\n  if (typeof explicit === 'boolean') {\n    return explicit;\n  }\n\n  return !isProductionEnvironment();\n}\n\nasync function registerAppNavigation(rootElement: Element, path: string) {\n  const instance = instancesByRoot.get(rootElement);\n  if (!instance) throw new Error('Internal error: app instance missing');\n  registerAppInstance(instance as ComponentInstance, path);\n  initializeNavigation();\n}\n\n/**\n * Apply selective hydration with deferral options\n */\nasync function applySelectiveHydration(\n  rootElement: Element,\n  resolved: { handler: ComponentFunction; params: Record<string, unknown> },\n  path: string,\n  cleanupStrict: boolean | undefined,\n  hydrateOptions: NonNullable<HydrateSPAConfig['hydrate']>\n): Promise<void> {\n  const hasPermanentSkips = (hydrateOptions.skipSelectors?.length ?? 0) > 0;\n  const hasBelowFoldDeferral = !!hydrateOptions.deferBelowFold;\n  const hasSelectiveBoundaries = hasPermanentSkips || hasBelowFoldDeferral;\n\n  if (hydrateOptions.skipSelectors?.length) {\n    markSkippedElements(rootElement, hydrateOptions.skipSelectors);\n  }\n\n  let deferredBoundaries: Element[] = [];\n  if (hydrateOptions.deferBelowFold) {\n    const foldY = hydrateOptions.foldThreshold ?? window.innerHeight;\n    deferredBoundaries = collectDeferredBelowFoldBoundaries(rootElement, foldY);\n\n    const handleScroll = () => {\n      const { activated, remaining } = activateVisibleDeferredBoundaries(\n        deferredBoundaries,\n        foldY\n      );\n\n      if (!activated) {\n        return;\n      }\n\n      flushHydrationActivation(rootElement);\n\n      if (remaining === 0) {\n        window.removeEventListener('scroll', handleScroll);\n      }\n    };\n\n    window.addEventListener('scroll', handleScroll, { passive: true });\n  }\n\n  if (hydrateOptions.deferUntilIdle && !hasSelectiveBoundaries) {\n    await queueIdleWork(() => {\n      mountOrUpdate(\n        rootElement,\n        (() => resolved.handler(resolved.params)) as ComponentFunction,\n        {\n          cleanupStrict,\n        }\n      );\n    });\n    await registerAppNavigation(rootElement, path);\n    return;\n  }\n\n  mountOrUpdate(\n    rootElement,\n    (() => resolved.handler(resolved.params)) as ComponentFunction,\n    {\n      cleanupStrict,\n    }\n  );\n  await registerAppNavigation(rootElement, path);\n\n  if (hydrateOptions.deferUntilIdle && deferredBoundaries.length > 0) {\n    await queueIdleWork(() => {\n      const { activated } = activateVisibleDeferredBoundaries(\n        deferredBoundaries,\n        Number.POSITIVE_INFINITY\n      );\n      if (activated) {\n        flushHydrationActivation(rootElement);\n      }\n    });\n  }\n}\n\n/**\n * hydrateSPA: Hydrate server-rendered HTML.\n * Accepts either a `manifest` (preferred) or a legacy `routes` array.\n */\nexport async function hydrateSPA(config: HydrateSPAConfig): Promise<void> {\n  assertExecutionModel('spa');\n  if (!config || typeof config !== 'object') {\n    throw new Error('hydrateSPA requires a config object');\n  }\n\n  const hasManifest =\n    config.manifest != null && config.manifest.records.length > 0;\n  const hasRoutes = Array.isArray(config.routes) && config.routes.length > 0;\n\n  if (!hasManifest && !hasRoutes) {\n    throw new Error(\n      'hydrateSPA requires a route manifest or route table. ' +\n        'Pass `manifest: getManifest()` or `routes: getRoutes()`. ' +\n        'If you are enhancing existing HTML, use createIsland instead.'\n    );\n  }\n\n  const rootElement =\n    typeof config.root === 'string'\n      ? document.getElementById(config.root)\n      : config.root;\n  if (!rootElement) throw new Error(`Root element not found: ${config.root}`);\n\n  const pendingLazyAtHydrationBoot = _snapshotLazy();\n\n  configureScrollRestoration(config.scrollRestoration);\n\n  clearRoutes();\n\n  if (hasManifest) {\n    _applyManifest(config.manifest!);\n  } else {\n    for (const r of config.routes!) {\n      registerRoute(r.path, r.handler as Parameters<typeof registerRoute>[1]);\n    }\n  }\n\n  _setActiveRouteAuthOptions(config.auth ?? config.manifest?.auth);\n\n  // Drain any lazy() imports so all split chunks are ready before mounting\n  await _drainLazy(pendingLazyAtHydrationBoot);\n\n  const path = typeof window !== 'undefined' ? window.location.pathname : '/';\n  const currentUrl =\n    typeof window !== 'undefined'\n      ? `${window.location.pathname}${window.location.search}${window.location.hash}`\n      : path;\n  setServerLocation(currentUrl);\n  if (isProductionEnvironment()) lockRouteRegistration();\n\n  const resolved = resolveRoute(path);\n  if (!resolved) {\n    throw new Error(`hydrateSPA: no route found for current path (${path}).`);\n  }\n\n  // Build a legacy-compatible routes array for the hydration verify call\n  const legacyRouteTable = hasManifest\n    ? config.manifest!.records.map((r) => ({\n        path: r.path,\n        handler: r.handler,\n        namespace: r.options.namespace,\n      }))\n    : config.routes!;\n\n  if (shouldVerifyHydrationMarkup(config)) {\n    const { verifyHydrationSyncForUrl } = await import('../ssr');\n    if (\n      !verifyHydrationSyncForUrl({\n        root: rootElement,\n        url: currentUrl,\n        routes: legacyRouteTable,\n      })\n    ) {\n      throw new Error(\n        '[Askr] Hydration mismatch detected. Server HTML does not match expected server-render output.'\n      );\n    }\n  }\n\n  const hydrateOptions = config.hydrate;\n  if (hydrateOptions) {\n    if (hydrateOptions.deferUntilIdle || hydrateOptions.deferBelowFold) {\n      await applySelectiveHydration(\n        rootElement,\n        {\n          handler: resolved.handler as ComponentFunction,\n          params: resolved.params as Record<string, unknown>,\n        },\n        path,\n        config.cleanupStrict,\n        hydrateOptions\n      );\n      return;\n    }\n\n    if (hydrateOptions.skipSelectors?.length) {\n      markSkippedElements(rootElement, hydrateOptions.skipSelectors);\n    }\n  }\n\n  mountOrUpdate(rootElement, bindResolvedRouteHandler(resolved), {\n    cleanupStrict: config.cleanupStrict,\n  });\n  await registerAppNavigation(rootElement, path);\n}\n\n/**\n * Cleanup an app mounted on a root element (element or id).\n * Safe to call multiple times — no-op when nothing is mounted.\n */\nexport function cleanupApp(root: Element | string): void {\n  const rootElement =\n    typeof root === 'string' ? document.getElementById(root) : root;\n\n  if (!rootElement) return;\n\n  const cleanupFn = (rootElement as ElementWithCleanup)[CLEANUP_SYMBOL];\n  if (typeof cleanupFn === 'function') {\n    cleanupFn();\n  }\n\n  instancesByRoot.delete(rootElement);\n}\n\n/**\n * Check whether an app is mounted on the given root\n */\nexport function hasApp(root: Element | string): boolean {\n  const rootElement =\n    typeof root === 'string' ? document.getElementById(root) : root;\n\n  if (!rootElement) return false;\n  return instancesByRoot.has(rootElement);\n}\n"],"mappings":"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"}

package/dist/common/component.d.ts

@@ -1,16 +1,17 @@
-/**
- * Common call contracts: Component signatures
- */
-import type { Props } from './props';
-import type { JSXElement } from './jsx';
-export type ComponentContext = {
-    signal: AbortSignal;
+import { Props } from "./props.js";
+import { JSXElement } from "./jsx.js";
+import { VNode } from "./vnode.js";
+
+//#region src/common/component.d.ts
+type ComponentContext = {
+  signal: AbortSignal;
 };
-import { type VNode } from './vnode';
-export type ComponentVNode = {
-    type: string;
-    props?: Props;
-    children?: (string | ComponentVNode | null | undefined | false)[];
+type ComponentVNode = {
+  type: string;
+  props?: Props;
+  children?: (string | ComponentVNode | null | undefined | false)[];
 };
-export type ComponentFunction = (props: Props, context?: ComponentContext) => JSXElement | VNode;
+type ComponentFunction = (props: Props, context?: ComponentContext) => JSXElement | VNode;
+//#endregion
+export { ComponentFunction };
 //# sourceMappingURL=component.d.ts.map

package/dist/common/component.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/common/component.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAExC,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,WAAW,CAAC;CACrB,CAAC;AAEF,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,SAAS,CAAC;AAKrC,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,QAAQ,CAAC,EAAE,CAAC,MAAM,GAAG,cAAc,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,CAAC,EAAE,CAAC;CACnE,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,CAC9B,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE,gBAAgB,KACvB,UAAU,GAAG,KAAK,CAAC"}
+{"version":3,"file":"component.d.ts","names":[],"sources":["../../src/common/component.ts"],"mappings":";;;;;KAOY,gBAAA;EACV,MAAA,EAAQ,WAAA;AAAA;AAAA,KAQE,cAAA;EACV,IAAA;EACA,KAAA,GAAQ,KAAA;EACR,QAAA,aAAqB,cAAA;AAAA;AAAA,KAGX,iBAAA,IACV,KAAA,EAAO,KAAA,EACP,OAAA,GAAU,gBAAA,KACP,UAAA,GAAa,KAAA"}

package/dist/common/control.d.ts

@@ -0,0 +1,13 @@
+import { Props } from "./props.js";
+
+//#region src/common/control.d.ts
+declare const __CONTROL_BOUNDARY__: unique symbol;
+declare const EAGER_CONTROL_PRIMITIVE: unique symbol;
+type EagerControlPrimitive<P extends Props = Props> = ((props: P) => unknown) & {
+  [EAGER_CONTROL_PRIMITIVE]?: true;
+};
+declare function markEagerControlPrimitive<T extends (...args: never[]) => unknown>(primitive: T): T;
+declare function isEagerControlPrimitive(value: unknown): value is EagerControlPrimitive;
+//#endregion
+export { EagerControlPrimitive };
+//# sourceMappingURL=control.d.ts.map

package/dist/common/control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","names":[],"sources":["../../src/common/control.ts"],"mappings":";;;cAEa,oBAAA;AAAA,cAEP,uBAAA;AAAA,KAEM,qBAAA,WAAgC,KAAA,GAAQ,KAAA,MAClD,KAAA,EAAO,CAAA;EAAA,CAEN,uBAAA;AAAA;AAAA,iBAGa,yBAAA,eACA,IAAA,sBAAA,CACd,SAAA,EAAW,CAAA,GAAI,CAAA;AAAA,iBASD,uBAAA,CACd,KAAA,YACC,KAAA,IAAS,qBAAA"}

package/dist/common/control.js

@@ -0,0 +1,14 @@
+//#region src/common/control.ts
+const __CONTROL_BOUNDARY__ = Symbol("__CONTROL_BOUNDARY__");
+const EAGER_CONTROL_PRIMITIVE = Symbol("__ASKR_EAGER_CONTROL_PRIMITIVE__");
+function markEagerControlPrimitive(primitive) {
+	primitive[EAGER_CONTROL_PRIMITIVE] = true;
+	return primitive;
+}
+function isEagerControlPrimitive(value) {
+	return typeof value === "function" && Boolean(value[EAGER_CONTROL_PRIMITIVE]);
+}
+//#endregion
+export { __CONTROL_BOUNDARY__, isEagerControlPrimitive, markEagerControlPrimitive };
+
+//# sourceMappingURL=control.js.map

package/dist/common/control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"control.js","names":[],"sources":["../../src/common/control.ts"],"sourcesContent":["import type { Props } from './props';\n\nexport const __CONTROL_BOUNDARY__ = Symbol('__CONTROL_BOUNDARY__');\n\nconst EAGER_CONTROL_PRIMITIVE = Symbol('__ASKR_EAGER_CONTROL_PRIMITIVE__');\n\nexport type EagerControlPrimitive<P extends Props = Props> = ((\n  props: P\n) => unknown) & {\n  [EAGER_CONTROL_PRIMITIVE]?: true;\n};\n\nexport function markEagerControlPrimitive<\n  T extends (...args: never[]) => unknown,\n>(primitive: T): T {\n  (\n    primitive as T & {\n      [EAGER_CONTROL_PRIMITIVE]?: true;\n    }\n  )[EAGER_CONTROL_PRIMITIVE] = true;\n  return primitive;\n}\n\nexport function isEagerControlPrimitive(\n  value: unknown\n): value is EagerControlPrimitive {\n  return (\n    typeof value === 'function' &&\n    Boolean(\n      (\n        value as {\n          [EAGER_CONTROL_PRIMITIVE]?: true;\n        }\n      )[EAGER_CONTROL_PRIMITIVE]\n    )\n  );\n}\n"],"mappings":";AAEA,MAAa,uBAAuB,OAAO,uBAAuB;AAElE,MAAM,0BAA0B,OAAO,mCAAmC;AAQ1E,SAAgB,0BAEd,WAAiB;AAEf,WAGA,2BAA2B;AAC7B,QAAO;;AAGT,SAAgB,wBACd,OACgC;AAChC,QACE,OAAO,UAAU,cACjB,QAEI,MAGA,yBACH"}

package/dist/common/env.js

@@ -0,0 +1,47 @@
+//#region src/common/env.ts
+function normalizeEnv(source) {
+	if (!source) return {};
+	const normalized = {};
+	for (const [key, value] of Object.entries(source)) if (typeof value === "string") normalized[key] = value;
+	else if (typeof value === "boolean" || typeof value === "number") normalized[key] = String(value);
+	return normalized;
+}
+function getBuildTimeEnv() {
+	const metaEnv = import.meta.env;
+	const normalized = normalizeEnv(metaEnv);
+	if (normalized.NODE_ENV == null && metaEnv) {
+		if (typeof metaEnv.MODE === "string" && metaEnv.MODE.length > 0) normalized.NODE_ENV = metaEnv.MODE;
+		else if (metaEnv.PROD === true || metaEnv.PROD === "true") normalized.NODE_ENV = "production";
+		else if (metaEnv.DEV === true || metaEnv.DEV === "true") normalized.NODE_ENV = "development";
+	}
+	return normalized;
+}
+function resolveNodeEnv(processNodeEnv, buildNodeEnv) {
+	if (buildNodeEnv === "production") return "production";
+	if (processNodeEnv != null) return processNodeEnv;
+	if (buildNodeEnv === "development") return "development";
+	return buildNodeEnv === "test" ? void 0 : buildNodeEnv;
+}
+function getRuntimeEnv() {
+	const processEnv = globalThis.process?.env ?? {};
+	const buildTimeEnv = getBuildTimeEnv();
+	return {
+		...processEnv,
+		...buildTimeEnv,
+		NODE_ENV: resolveNodeEnv(processEnv.NODE_ENV, buildTimeEnv.NODE_ENV)
+	};
+}
+function isProductionEnvironment() {
+	return getRuntimeEnv().NODE_ENV === "production";
+}
+function isDevelopmentEnvironment() {
+	return !isProductionEnvironment();
+}
+function isRuntimeEnvFlagEnabled(name) {
+	const value = getRuntimeEnv()[name];
+	return value === "1" || value === "true";
+}
+//#endregion
+export { getRuntimeEnv, isDevelopmentEnvironment, isProductionEnvironment, isRuntimeEnvFlagEnabled };
+
+//# sourceMappingURL=env.js.map

package/dist/common/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","names":[],"sources":["../../src/common/env.ts"],"sourcesContent":["export type RuntimeEnv = Record<string, string | undefined>;\n\ntype RuntimeEnvGlobal = typeof globalThis & {\n  process?: {\n    env?: RuntimeEnv;\n  };\n};\n\ntype BuildTimeEnv = Record<string, unknown> & {\n  NODE_ENV?: unknown;\n  MODE?: unknown;\n  PROD?: unknown;\n  DEV?: unknown;\n};\n\nfunction normalizeEnv(source?: Record<string, unknown>): RuntimeEnv {\n  if (!source) {\n    return {};\n  }\n\n  const normalized: RuntimeEnv = {};\n  for (const [key, value] of Object.entries(source)) {\n    if (typeof value === 'string') {\n      normalized[key] = value;\n    } else if (typeof value === 'boolean' || typeof value === 'number') {\n      normalized[key] = String(value);\n    }\n  }\n\n  return normalized;\n}\n\nfunction getBuildTimeEnv(): RuntimeEnv {\n  const metaEnv = (import.meta as ImportMeta & { env?: BuildTimeEnv }).env;\n  const normalized = normalizeEnv(metaEnv);\n\n  if (normalized.NODE_ENV == null && metaEnv) {\n    if (typeof metaEnv.MODE === 'string' && metaEnv.MODE.length > 0) {\n      normalized.NODE_ENV = metaEnv.MODE;\n    } else if (metaEnv.PROD === true || metaEnv.PROD === 'true') {\n      normalized.NODE_ENV = 'production';\n    } else if (metaEnv.DEV === true || metaEnv.DEV === 'true') {\n      normalized.NODE_ENV = 'development';\n    }\n  }\n\n  return normalized;\n}\n\nfunction resolveNodeEnv(\n  processNodeEnv: string | undefined,\n  buildNodeEnv: string | undefined\n): string | undefined {\n  if (buildNodeEnv === 'production') {\n    return 'production';\n  }\n\n  if (processNodeEnv != null) {\n    return processNodeEnv;\n  }\n\n  if (buildNodeEnv === 'development') {\n    return 'development';\n  }\n\n  return buildNodeEnv === 'test' ? undefined : buildNodeEnv;\n}\n\nexport function getRuntimeEnv(): RuntimeEnv {\n  const processEnv = (globalThis as RuntimeEnvGlobal).process?.env ?? {};\n  const buildTimeEnv = getBuildTimeEnv();\n\n  return {\n    ...processEnv,\n    ...buildTimeEnv,\n    NODE_ENV: resolveNodeEnv(processEnv.NODE_ENV, buildTimeEnv.NODE_ENV),\n  };\n}\n\nexport function isProductionEnvironment(): boolean {\n  return getRuntimeEnv().NODE_ENV === 'production';\n}\n\nexport function isDevelopmentEnvironment(): boolean {\n  return !isProductionEnvironment();\n}\n\nexport function isRuntimeEnvFlagEnabled(name: string): boolean {\n  const value = getRuntimeEnv()[name];\n  return value === '1' || value === 'true';\n}\n"],"mappings":";AAeA,SAAS,aAAa,QAA8C;AAClE,KAAI,CAAC,OACH,QAAO,EAAE;CAGX,MAAM,aAAyB,EAAE;AACjC,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,OAAO,CAC/C,KAAI,OAAO,UAAU,SACnB,YAAW,OAAO;UACT,OAAO,UAAU,aAAa,OAAO,UAAU,SACxD,YAAW,OAAO,OAAO,MAAM;AAInC,QAAO;;AAGT,SAAS,kBAA8B;CACrC,MAAM,UAAW,OAAO,KAA6C;CACrE,MAAM,aAAa,aAAa,QAAQ;AAExC,KAAI,WAAW,YAAY,QAAQ,SACjC;MAAI,OAAO,QAAQ,SAAS,YAAY,QAAQ,KAAK,SAAS,EAC5D,YAAW,WAAW,QAAQ;WACrB,QAAQ,SAAS,QAAQ,QAAQ,SAAS,OACnD,YAAW,WAAW;WACb,QAAQ,QAAQ,QAAQ,QAAQ,QAAQ,OACjD,YAAW,WAAW;;AAI1B,QAAO;;AAGT,SAAS,eACP,gBACA,cACoB;AACpB,KAAI,iBAAiB,aACnB,QAAO;AAGT,KAAI,kBAAkB,KACpB,QAAO;AAGT,KAAI,iBAAiB,cACnB,QAAO;AAGT,QAAO,iBAAiB,SAAS,SAAY;;AAG/C,SAAgB,gBAA4B;CAC1C,MAAM,aAAc,WAAgC,SAAS,OAAO,EAAE;CACtE,MAAM,eAAe,iBAAiB;AAEtC,QAAO;EACL,GAAG;EACH,GAAG;EACH,UAAU,eAAe,WAAW,UAAU,aAAa,SAAS;EACrE;;AAGH,SAAgB,0BAAmC;AACjD,QAAO,eAAe,CAAC,aAAa;;AAGtC,SAAgB,2BAAoC;AAClD,QAAO,CAAC,yBAAyB;;AAGnC,SAAgB,wBAAwB,MAAuB;CAC7D,MAAM,QAAQ,eAAe,CAAC;AAC9B,QAAO,UAAU,OAAO,UAAU"}

package/dist/common/jsx.d.ts

@@ -1,17 +1,19 @@
-/**
- * Common call contracts: JSX element shape
- */
-import type { Props } from './props';
-export declare const ELEMENT_TYPE: unique symbol;
-export declare const Fragment: unique symbol;
-export interface JSXElement {
-    /** Internal element marker */
-    $$typeof: symbol;
-    /** Element type: string, component, Fragment, etc */
-    type: string | ((props: Props) => unknown) | symbol;
-    /** Props bag */
-    props: Props;
-    /** Optional key (normalized by runtime) */
-    key?: string | number | null;
+import { Props } from "./props.js";
+
+//#region src/common/jsx.d.ts
+declare const ELEMENT_TYPE: unique symbol;
+declare const Fragment: unique symbol;
+declare const STATIC_CHILDREN: unique symbol;
+interface JSXElement {
+  /** Internal element marker */
+  $$typeof: symbol;
+  /** Element type: string, component, Fragment, etc */
+  type: string | ((props: Props) => unknown) | symbol;
+  /** Props bag */
+  props: Props;
+  /** Optional key (normalized by runtime) */
+  key?: string | number | null;
 }
+//#endregion
+export { Fragment, JSXElement };
 //# sourceMappingURL=jsx.d.ts.map

package/dist/common/jsx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsx.d.ts","sourceRoot":"","sources":["../../src/common/jsx.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC,eAAO,MAAM,YAAY,eAA6B,CAAC;AACvD,eAAO,MAAM,QAAQ,eAA8B,CAAC;AAEpD,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,QAAQ,EAAE,MAAM,CAAC;IAEjB,qDAAqD;IACrD,IAAI,EAAE,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,GAAG,MAAM,CAAC;IAEpD,gBAAgB;IAChB,KAAK,EAAE,KAAK,CAAC;IAEb,2CAA2C;IAC3C,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC9B"}
+{"version":3,"file":"jsx.d.ts","names":[],"sources":["../../src/common/jsx.ts"],"mappings":";;;cAMa,YAAA;AAAA,cACA,QAAA;AAAA,cACA,eAAA;AAAA,UAEI,UAAA;EAHJ;EAKX,QAAA;;EAGA,IAAA,aAAiB,KAAA,EAAO,KAAA;EARyB;EAWjD,KAAA,EAAO,KAAA;EAVwD;EAa/D,GAAA;AAAA"}

package/dist/common/jsx.js

@@ -1 +1,8 @@
-const o=Symbol.for("askr.element"),r=Symbol.for("askr.fragment");export{o as ELEMENT_TYPE,r as Fragment};
+//#region src/common/jsx.ts
+const ELEMENT_TYPE = Symbol.for("askr.element");
+const Fragment = Symbol.for("askr.fragment");
+const STATIC_CHILDREN = Symbol.for("askr.static-children");
+//#endregion
+export { ELEMENT_TYPE, Fragment, STATIC_CHILDREN };
+
+//# sourceMappingURL=jsx.js.map

package/dist/common/jsx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx.js","names":[],"sources":["../../src/common/jsx.ts"],"sourcesContent":["/**\n * Common call contracts: JSX element shape\n */\n\nimport type { Props } from './props';\n\nexport const ELEMENT_TYPE = Symbol.for('askr.element');\nexport const Fragment = Symbol.for('askr.fragment');\nexport const STATIC_CHILDREN = Symbol.for('askr.static-children');\n\nexport interface JSXElement {\n  /** Internal element marker */\n  $$typeof: symbol;\n\n  /** Element type: string, component, Fragment, etc */\n  type: string | ((props: Props) => unknown) | symbol;\n\n  /** Props bag */\n  props: Props;\n\n  /** Optional key (normalized by runtime) */\n  key?: string | number | null;\n}\n"],"mappings":";AAMA,MAAa,eAAe,OAAO,IAAI,eAAe;AACtD,MAAa,WAAW,OAAO,IAAI,gBAAgB;AACnD,MAAa,kBAAkB,OAAO,IAAI,uBAAuB"}

package/dist/common/props.d.ts

@@ -1,3 +1,4 @@
+//#region src/common/props.d.ts
 /**
  * Common call contracts: Props
  *
@@ -7,17 +8,19 @@
  * Props accepted by components and elements.
  * Intentionally permissive but provides a single named type.
  */
-export interface Props {
-    /** Optional key for keyed lists (string | number | symbol for internal frames) */
-    key?: string | number | symbol;
-    /** Optional children slot */
-    children?: unknown;
-    /** Allow additional arbitrary attributes (e.g., class, id, data-*) */
-    [attr: string]: unknown;
+interface Props {
+  /** Optional key for keyed lists (string | number | symbol for internal frames) */
+  key?: string | number | symbol;
+  /** Optional children slot */
+  children?: unknown;
+  /** Allow additional arbitrary attributes (e.g., class, id, data-*) */
+  [attr: string]: unknown;
 }
-export interface ComponentNode {
-    type: 'component' | 'element' | 'text';
-    value?: unknown;
-    children?: ComponentNode[];
+interface ComponentNode {
+  type: 'component' | 'element' | 'text';
+  value?: unknown;
+  children?: ComponentNode[];
 }
+//#endregion
+export { Props };
 //# sourceMappingURL=props.d.ts.map

package/dist/common/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../src/common/props.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,kFAAkF;IAClF,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IAC/B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B"}
+{"version":3,"file":"props.d.ts","names":[],"sources":["../../src/common/props.ts"],"mappings":";;AAUA;;;;;;;;UAAiB,KAAA;EASA;EAPf,GAAA;;EAEA,QAAA;EAMA;EAAA,CAJC,IAAA;AAAA;AAAA,UAGc,aAAA;EACf,IAAA;EACA,KAAA;EACA,QAAA,GAAW,aAAA;AAAA"}

package/dist/common/router.d.ts

@@ -1,39 +1,197 @@
+//#region src/common/router.d.ts
 /**
  * Common call contracts: Router types
  */
-export interface RouteHandler {
-    (params: Record<string, string>, context?: {
-        signal: AbortSignal;
-    }): unknown;
-}
-export interface Route {
-    path: string;
-    handler: RouteHandler;
-    namespace?: string;
-}
-export interface ResolvedRoute {
-    handler: RouteHandler;
+/**
+ * A route page component: a regular component that receives route params as
+ * props (always `Record<string, string>` derived from the URL pattern).
+ *
+ * Components may accept no params at all — `() => unknown` is assignable.
+ */
+type RouteComponent = (props: Record<string, string>) => unknown;
+type RouteMode = 'spa' | 'ssr' | 'ssg';
+type RouteAuthMode = true | 'guest';
+type AccessRedirectStatus = 301 | 302 | 303 | 307 | 308;
+type AccessDenyStatus = 401 | 403 | 404;
+interface AccessAllowDecision {
+  kind: 'allow';
+}
+interface AccessRedirectDecision {
+  kind: 'redirect';
+  to: string;
+  status?: AccessRedirectStatus;
+  replace?: boolean;
+}
+interface AccessDenyDecision {
+  kind: 'deny';
+  status: AccessDenyStatus;
+}
+type AccessDecision = AccessAllowDecision | AccessRedirectDecision | AccessDenyDecision;
+interface RouteContext<Session = unknown, User = unknown> {
+  mode: RouteMode;
+  params: Record<string, string>;
+  pathname: string;
+  search: string;
+  hash: string;
+  href: string;
+  session: Session | null;
+  user: User | null;
+  signal: AbortSignal;
+}
+type RoutePolicy = (context: RouteContext) => AccessDecision | Promise<AccessDecision>;
+interface RouteAuthState<Session = unknown, User = unknown> {
+  session: Session | null;
+  user: User | null;
+}
+type RouteAuthResolver<Session = unknown, User = unknown> = (context: Omit<RouteContext<Session, User>, 'session' | 'user'>) => RouteAuthState<Session, User> | Promise<RouteAuthState<Session, User>>;
+interface RouteAuthOptions<Session = unknown, User = unknown> {
+  resolve: RouteAuthResolver<Session, User>;
+  loginPath?: string | ((context: RouteContext<Session, User>) => string | Promise<string>);
+  guestRedirectTo?: string | ((context: RouteContext<Session, User>) => string | Promise<string>);
+  hasRole?: (user: User, role: string, context: RouteContext<Session, User>) => boolean | Promise<boolean>;
+  hasPermission?: (user: User, permission: string, context: RouteContext<Session, User>) => boolean | Promise<boolean>;
+}
+interface CommonAccessOptions {
+  auth?: RouteAuthMode;
+  role?: string;
+  permission?: string;
+  policies?: readonly RoutePolicy[];
+}
+/**
+ * Options for `route()` declarations.
+ *
+ * - `loader`: server data loader called before render, result passed as SSR data
+ * - `entries`: SSG entry generator — returns one param map per static page
+ * - `title`: page title hint used by SSG and document-meta integrations
+ * - `namespace`: MFE namespace key for grouped route management
+ */
+interface RouteOptions extends CommonAccessOptions {
+  loader?: (context: {
     params: Record<string, string>;
+  }) => unknown;
+  entries?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+  title?: string;
+  namespace?: string;
+}
+/**
+ * A single parsed segment from a route path.
+ *
+ * - `static`:   a literal path segment, e.g. `"users"` in `/users/{id}`
+ * - `param`:    a `{name}` capture group — `value` holds the param name
+ * - `wildcard`: a bare `*` segment that captures exactly one segment
+ * - `catchall`: the `/*` catch-all that matches any depth
+ */
+interface ParsedSegment {
+  kind: 'static' | 'param' | 'wildcard' | 'catchall';
+  /** For static/wildcard/catchall: the literal text; for param: the param name. */
+  value: string;
+}
+/** Resolved layout component as stored in a route record's layout chain. */
+interface LayoutScopeRecord {
+  component: (props: {
+    children?: unknown;
+  }) => unknown;
+}
+interface RegisterRoutesOptions {
+  auth?: RouteAuthOptions;
+}
+type RouteDefinition = () => void;
+interface RouteRequestOptions {
+  manifest?: RouteManifest;
+  mode?: RouteMode;
+  auth?: RouteAuthOptions;
+  signal?: AbortSignal;
+}
+interface RouteRenderResult {
+  kind: 'render';
+  handler: RouteHandler;
+  params: Record<string, string>;
+}
+type RouteRequestResult = RouteRenderResult | AccessRedirectDecision | AccessDenyDecision | null;
+interface GroupHelperOptions extends CommonAccessOptions {
+  layout?: (props: {
+    children?: unknown;
+  }) => unknown;
+}
+/**
+ * A fully normalized route record produced by `route(path, Component, options?)`.
+ *
+ * This is the canonical representation shared by:
+ *   - SPA matching and navigation
+ *   - SSR request resolution
+ *   - SSG manifest expansion
+ */
+interface RouteRecord {
+  /** Canonical normalized absolute path, e.g. `/posts/{slug}` */
+  path: string;
+  /** The page component to render when this route is active */
+  component: RouteComponent;
+  /** Pre-parsed segment list for fast matching and typed param extraction */
+  segments: ParsedSegment[];
+  /** Pre-computed specificity rank (higher = more specific) */
+  rank: number;
+  /** Layout chain from outermost to innermost, applied automatically on render */
+  layoutChain: LayoutScopeRecord[];
+  /** Route metadata: loader, entries, policies, title, namespace */
+  options: RouteOptions;
+  /** True when this is the `/*` catch-all fallback route */
+  isFallback: boolean;
+  /**
+   * Runtime-ready handler with layout composition baked in.
+   * Compatible with the low-level `RouteHandler` signature so that navigation
+   * and SSR rendering do not need to know about layout chains.
+   */
+  handler: RouteHandler;
+}
+/**
+ * The normalized route manifest produced by registered route definitions.
+ * declarations.  Pass it to `createSPA`, `hydrateSPA`, or `renderToString`
+ * instead of assembling plain `Route[]` arrays.
+ *
+ * ```ts
+ * import { getManifest } from '@askrjs/askr/router';
+ * await createSPA({ root: '#app', manifest: getManifest() });
+ * ```
+ */
+interface RouteManifest {
+  records: RouteRecord[];
+  auth?: RouteAuthOptions;
+}
+interface RouteHandler {
+  (params: Record<string, string>, context?: {
+    signal: AbortSignal;
+  }): unknown;
+}
+interface Route {
+  path: string;
+  handler: RouteHandler;
+  namespace?: string;
+}
+interface ResolvedRoute {
+  handler: RouteHandler;
+  params: Record<string, string>;
+}
+interface RouteMatch {
+  path: string;
+  params: Readonly<Record<string, string>>;
+  name?: string;
+  namespace?: string;
+}
+interface RouteQuery {
+  get(key: string): string | null;
+  getAll(key: string): string[];
+  has(key: string): boolean;
+  toJSON(): Record<string, string | string[]>;
 }
-export interface RouteMatch {
-    path: string;
-    params: Readonly<Record<string, string>>;
-    name?: string;
-    namespace?: string;
-}
-export interface RouteQuery {
-    get(key: string): string | null;
-    getAll(key: string): string[];
-    has(key: string): boolean;
-    toJSON(): Record<string, string | string[]>;
-}
-export interface RouteSnapshot {
-    path: string;
-    params: Readonly<Record<string, string>>;
-    query: Readonly<RouteQuery>;
-    hash: string | null;
-    name?: string;
-    namespace?: string;
-    matches: readonly RouteMatch[];
+interface RouteSnapshot {
+  path: string;
+  params: Readonly<Record<string, string>>;
+  query: Readonly<RouteQuery>;
+  hash: string | null;
+  name?: string;
+  namespace?: string;
+  matches: readonly RouteMatch[];
 }
+//#endregion
+export { AccessDecision, AccessDenyDecision, AccessDenyStatus, AccessRedirectDecision, AccessRedirectStatus, GroupHelperOptions, LayoutScopeRecord, ParsedSegment, RegisterRoutesOptions, ResolvedRoute, Route, RouteAuthMode, RouteAuthOptions, RouteAuthResolver, RouteAuthState, RouteComponent, RouteContext, RouteDefinition, RouteHandler, RouteManifest, RouteMatch, RouteMode, RouteOptions, RoutePolicy, RouteQuery, RouteRecord, RouteRenderResult, RouteRequestOptions, RouteRequestResult, RouteSnapshot };
 //# sourceMappingURL=router.d.ts.map

package/dist/common/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/common/router.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC;CAC9E;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAChC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,KAAK,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,SAAS,UAAU,EAAE,CAAC;CAChC"}
+{"version":3,"file":"router.d.ts","names":[],"sources":["../../src/common/router.ts"],"mappings":"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"}

package/dist/common/ssr-errors.d.ts

@@ -1,8 +1,11 @@
+//#region src/common/ssr-errors.d.ts
 /**
  * Common call contracts: SSR error types
  */
-export declare class SSRDataMissingError extends Error {
-    readonly code = "SSR_DATA_MISSING";
-    constructor(message?: string);
+declare class SSRDataMissingError extends Error {
+  readonly code = "SSR_DATA_MISSING";
+  constructor(message?: string);
 }
+//#endregion
+export { SSRDataMissingError };
 //# sourceMappingURL=ssr-errors.d.ts.map

package/dist/common/ssr-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssr-errors.d.ts","sourceRoot":"","sources":["../../src/common/ssr-errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,IAAI,sBAAsB;gBAEjC,OAAO,SAAkI;CAM5I"}
+{"version":3,"file":"ssr-errors.d.ts","names":[],"sources":["../../src/common/ssr-errors.ts"],"mappings":";;AAIA;;cAAa,mBAAA,SAA4B,KAAA;EAAA,SAC9B,IAAA;cAEP,OAAA;AAAA"}

package/dist/common/ssr-errors.js

@@ -1 +1,16 @@
-class e extends Error{constructor(t="Server-side rendering requires all data to be available synchronously. This component attempted to use async data during SSR."){super(t),this.code="SSR_DATA_MISSING",this.name="SSRDataMissingError",Object.setPrototypeOf(this,e.prototype)}}export{e as SSRDataMissingError};
+//#region src/common/ssr-errors.ts
+/**
+* Common call contracts: SSR error types
+*/
+var SSRDataMissingError = class SSRDataMissingError extends Error {
+	constructor(message = "Server-side rendering requires all data to be available synchronously. This component attempted to use async data during SSR.") {
+		super(message);
+		this.code = "SSR_DATA_MISSING";
+		this.name = "SSRDataMissingError";
+		Object.setPrototypeOf(this, SSRDataMissingError.prototype);
+	}
+};
+//#endregion
+export { SSRDataMissingError };
+
+//# sourceMappingURL=ssr-errors.js.map

package/dist/common/ssr-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr-errors.js","names":[],"sources":["../../src/common/ssr-errors.ts"],"sourcesContent":["/**\n * Common call contracts: SSR error types\n */\n\nexport class SSRDataMissingError extends Error {\n  readonly code = 'SSR_DATA_MISSING';\n  constructor(\n    message = 'Server-side rendering requires all data to be available synchronously. This component attempted to use async data during SSR.'\n  ) {\n    super(message);\n    this.name = 'SSRDataMissingError';\n    Object.setPrototypeOf(this, SSRDataMissingError.prototype);\n  }\n}\n"],"mappings":";;;;AAIA,IAAa,sBAAb,MAAa,4BAA4B,MAAM;CAE7C,YACE,UAAU,iIACV;AACA,QAAM,QAAQ;cAJA;AAKd,OAAK,OAAO;AACZ,SAAO,eAAe,MAAM,oBAAoB,UAAU"}