@askrjs/askr 0.0.28 → 0.0.30

package/dist/router/route.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route.js","names":[],"sources":["../../src/router/route.ts"],"sourcesContent":["/**\n * Route definition, registration, and matching.\n *\n * Primary public authoring:\n *   - `registerRoutes(() => { ... }, options?)`\n *   - `group(options, () => { ... })`\n *   - `route(path, Component, options?)`\n *   - `fallback(Component)`\n *   - `currentRoute()` for render-time access\n *\n */\n\nimport { matchSegments, parseSegments, computeRank } from './match';\nimport {\n  buildRouteContext,\n  buildRouteContextBase,\n  deepFreeze,\n  makeQuery,\n  parseLocation,\n} from './route-context';\nimport { getCurrentComponentInstance } from '../runtime/component';\nimport { getExecutionModel } from '../runtime/execution-model';\nimport { getRenderContext } from '../ssr/context';\nimport {\n  requireAuth,\n  requireGuest,\n  requirePermission,\n  requireRole,\n} from './policy';\n\nexport type {\n  AccessDecision,\n  AccessDenyDecision,\n  AccessRedirectDecision,\n  GroupHelperOptions,\n  RegisterRoutesOptions,\n  RouteDefinition,\n  RouteAuthOptions,\n  RouteHandler,\n  Route,\n  RouteContext,\n  RoutePolicy,\n  RouteRenderResult,\n  RouteRequestOptions,\n  RouteRequestResult,\n  ResolvedRoute,\n  RouteMatch,\n  RouteQuery,\n  RouteSnapshot,\n  RouteComponent,\n  RouteOptions,\n  ParsedSegment,\n  LayoutScopeRecord,\n  RouteRecord,\n  RouteManifest,\n} from '../common/router';\n\nimport type {\n  AccessDecision,\n  AccessDenyDecision,\n  AccessRedirectDecision,\n  GroupHelperOptions,\n  RegisterRoutesOptions,\n  RouteDefinition,\n  RouteAuthOptions,\n  RouteHandler,\n  Route,\n  RouteContext,\n  RoutePolicy,\n  RouteRenderResult,\n  RouteRequestOptions,\n  RouteRequestResult,\n  ResolvedRoute,\n  RouteMatch,\n  RouteQuery,\n  RouteSnapshot,\n  RouteComponent,\n  RouteOptions,\n  LayoutScopeRecord,\n  RouteRecord,\n  RouteManifest,\n} from '../common/router';\n\n// ---------------------------------------------------------------------------\n// Module-level stores\n// ---------------------------------------------------------------------------\n\n/** Legacy flat route array — kept for resolver and route() accessor backward compat. */\nconst routes: Route[] = [];\n\n/** Normalized route records built by the declarative registration API. */\nconst records: RouteRecord[] = [];\n\ntype RegistrationScope = {\n  layout?: LayoutScopeRecord['component'];\n  policies: readonly RoutePolicy[];\n  state: AccessScopeState;\n};\n\ntype RegistrationSession = {\n  authConfigured: boolean;\n};\n\n/** Active registration scope stack during module-load-time registration. */\nconst registrationScopeStack: RegistrationScope[] = [];\nconst registrationSessionStack: RegistrationSession[] = [];\n\nconst namespaces = new Set<string>();\n\ntype AccessScopeState = {\n  guestOnly: boolean;\n  authenticated: boolean;\n};\n\nlet defaultRouteAuthOptions: RouteAuthOptions | undefined;\nlet activeClientRouteAuthOptions: RouteAuthOptions | undefined;\n\nconst HAS_ROUTES_KEY = Symbol.for('__ASKR_HAS_ROUTES__');\n\nfunction setHasRoutes(value: boolean): void {\n  try {\n    const g = globalThis as unknown as Record<string | symbol, unknown>;\n    g[HAS_ROUTES_KEY] = value;\n  } catch {\n    // ignore\n  }\n}\n\n// Initialize to false at module load.\nsetHasRoutes(false);\n\n// Route index by depth - maintains insertion order\nconst routesByDepth = new Map<number, Route[]>();\n\n/**\n * Parse route path depth\n */\nfunction getDepth(path: string): number {\n  const normalized =\n    path.endsWith('/') && path !== '/' ? path.slice(0, -1) : path;\n  return normalized === '/' ? 0 : normalized.split('/').filter(Boolean).length;\n}\n\n// ---------------------------------------------------------------------------\n// WeakMap caches for external Route[] objects (e.g. SSR per-request tables)\n// Amortises parseSegments / computeRank across repeated resolveRouteFromRoutes\n// calls on the same route list (same object reference).\n// ---------------------------------------------------------------------------\n\n/** Pre-parsed segments for an externally supplied Route object. */\nconst routeSegsCache = new WeakMap<Route, ReturnType<typeof parseSegments>>();\n/** Pre-computed rank for an externally supplied Route object. */\nconst routeRankCache = new WeakMap<Route, number>();\n/** A rank-descending sorted copy of an external readonly Route array. */\nconst sortedListCache = new WeakMap<\n  ReadonlyArray<Route>,\n  ReadonlyArray<Route>\n>();\n\nfunction cachedSegs(r: Route): ReturnType<typeof parseSegments> {\n  let s = routeSegsCache.get(r);\n  if (!s) {\n    s = parseSegments(r.path);\n    routeSegsCache.set(r, s);\n  }\n  return s;\n}\n\nfunction cachedRank(r: Route): number {\n  let n = routeRankCache.get(r);\n  if (n === undefined) {\n    n = computeRank(cachedSegs(r));\n    routeRankCache.set(r, n);\n  }\n  return n;\n}\n\nfunction cachedSortedList(\n  routeList: ReadonlyArray<Route>\n): ReadonlyArray<Route> {\n  let sorted = sortedListCache.get(routeList);\n  if (!sorted) {\n    sorted = [...routeList].sort((a, b) => cachedRank(b) - cachedRank(a));\n    sortedListCache.set(routeList, sorted);\n  }\n  return sorted;\n}\n\n// SSR helper: when rendering on the server, callers may set a location so that\n// render-time route() returns deterministic server values that match client\n// hydration. This is deliberately an opt-in escape for SSR and tests.\nlet serverLocation: string | null = null;\n\nexport function setServerLocation(url: string | null): void {\n  serverLocation = url;\n}\n\nfunction isPromise<T>(value: T | Promise<T>): value is Promise<T> {\n  return value instanceof Promise;\n}\n\n// Compute matches for a specific route list.\nfunction computeMatchesFromRoutes(\n  pathname: string,\n  routesList: readonly Route[]\n): RouteMatch[] {\n  const matches: Array<{\n    pattern: string;\n    params: Record<string, string>;\n    name?: string;\n    namespace?: string;\n    rank: number;\n  }> = [];\n\n  const normalized =\n    pathname.endsWith('/') && pathname !== '/'\n      ? pathname.slice(0, -1)\n      : pathname;\n  const urlParts =\n    normalized === '/' ? [] : normalized.split('/').filter(Boolean);\n\n  for (const r of routesList) {\n    const params = matchSegments(urlParts, cachedSegs(r));\n    if (params !== null) {\n      matches.push({\n        pattern: r.path,\n        params,\n        name: (r as { name?: string }).name,\n        namespace: r.namespace,\n        rank: cachedRank(r),\n      });\n    }\n  }\n\n  matches.sort((a, b) => b.rank - a.rank);\n\n  return matches.map((m) => ({\n    path: m.pattern,\n    params: deepFreeze({ ...m.params }),\n    name: m.name,\n    namespace: m.namespace,\n  }));\n}\n\nfunction getActiveRoutes(): readonly Route[] {\n  const renderContext = getRenderContext();\n  return renderContext?.routes ?? routes;\n}\n\nfunction getActiveRouteAuthOptions(\n  override?: RouteAuthOptions\n): RouteAuthOptions | undefined {\n  if (override) {\n    return override;\n  }\n\n  const renderContext = getRenderContext();\n  return (\n    renderContext?.routeAuth ??\n    activeClientRouteAuthOptions ??\n    defaultRouteAuthOptions\n  );\n}\n\nexport function _setActiveRouteAuthOptions(\n  auth: RouteAuthOptions | undefined\n): void {\n  activeClientRouteAuthOptions = auth;\n}\n\nfunction getCurrentRegistrationSession(): RegistrationSession {\n  return (\n    registrationSessionStack[registrationSessionStack.length - 1] ?? {\n      authConfigured: !!defaultRouteAuthOptions?.resolve,\n    }\n  );\n}\n\nfunction getCurrentAccessScopeState(): AccessScopeState {\n  return (\n    registrationScopeStack[registrationScopeStack.length - 1]?.state ?? {\n      guestOnly: false,\n      authenticated: false,\n    }\n  );\n}\n\nfunction getCurrentLayoutChain(): LayoutScopeRecord[] {\n  const layoutChain: LayoutScopeRecord[] = [];\n\n  for (const scope of registrationScopeStack) {\n    if (scope.layout) {\n      layoutChain.push({ component: scope.layout });\n    }\n  }\n\n  return layoutChain;\n}\n\nfunction getCurrentInheritedPolicies(): RoutePolicy[] {\n  const policies: RoutePolicy[] = [];\n\n  for (const scope of registrationScopeStack) {\n    if (scope.policies.length > 0) {\n      policies.push(...scope.policies);\n    }\n  }\n\n  return policies;\n}\n\n// ---------------------------------------------------------------------------\n// Registration lock\n// ---------------------------------------------------------------------------\n\n/**\n * Prevent route registrations after the app has started.\n * Enforced in production; tests may unlock explicitly.\n */\nlet registrationLocked = false;\n\nexport function lockRouteRegistration(): void {\n  registrationLocked = true;\n}\n\nexport function _lockRouteRegistrationForTests(): void {\n  registrationLocked = true;\n}\n\nexport function _unlockRouteRegistrationForTests(): void {\n  registrationLocked = false;\n}\n\n// ---------------------------------------------------------------------------\n// Path validation\n// ---------------------------------------------------------------------------\n\nfunction validateRoutePath(path: string): void {\n  if (!path.startsWith('/')) {\n    throw new Error(`Route path must begin with \"/\". Got: \"${path}\"`);\n  }\n  // Reject Express-style :param syntax — Askr uses {param} interpolation\n  if (/:([^/{}]+)/.test(path)) {\n    const suggested = path.replace(/:([^/{}]+)/g, '{$1}');\n    throw new Error(\n      `Route parameter syntax uses {name} interpolation, not :name. ` +\n        `Use \"${suggested}\" instead of \"${path}\".`\n    );\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Internal helper: insert a RouteRecord in rank-descending order\n// so that resolveRoute can use first-match-wins without sorting.\n// Ties preserve declaration order (stable binary-search insertion).\n// ---------------------------------------------------------------------------\n\nfunction insertRecordSorted(record: RouteRecord): void {\n  let lo = 0;\n  let hi = records.length;\n  // Find the insertion point: after all existing records with rank >= this one\n  while (lo < hi) {\n    const mid = (lo + hi) >>> 1;\n    if (records[mid].rank >= record.rank) lo = mid + 1;\n    else hi = mid;\n  }\n  records.splice(lo, 0, record);\n}\n\n// ---------------------------------------------------------------------------\n// Internal helper: add a single pre-built Route object to the runtime stores\n// ---------------------------------------------------------------------------\n\nfunction addRouteToStores(routeObj: Route): void {\n  routes.push(routeObj);\n  setHasRoutes(true);\n\n  const depth = getDepth(routeObj.path);\n  let depthRoutes = routesByDepth.get(depth);\n  if (!depthRoutes) {\n    depthRoutes = [];\n    routesByDepth.set(depth, depthRoutes);\n  }\n  depthRoutes.push(routeObj);\n\n  if (routeObj.namespace) {\n    namespaces.add(routeObj.namespace);\n  }\n}\n\n// ---------------------------------------------------------------------------\n// lazy() — eager-prefetch code-split component wrapper\n// ---------------------------------------------------------------------------\n\n/** Promises from in-flight lazy() imports, drained by createSPA / hydrateSPA. */\nconst pendingLazy = new Set<Promise<unknown>>();\n\n/**\n * Snapshot the current in-flight lazy() imports.\n * Boot uses this before clearing route state so manifest-based startup can\n * still await chunks that were kicked off during route module evaluation.\n */\nexport function _snapshotLazy(): Promise<unknown>[] {\n  return [...pendingLazy];\n}\n\n/**\n * Declare a code-split route component. The `import()` fires immediately at\n * module evaluation time (creating a bundler split point), and the resolved\n * chunk is guaranteed to be available before the app mounts — so the renderer\n * always receives a plain synchronous function.\n *\n * ```ts\n * registerRoutes(() => {\n *   group({ layout: AppLayout }, () => {\n *     route('/', lazy(() => import('./pages/landing')));\n *     route('/dashboard', lazy(() => import('./pages/dashboard')));\n *   });\n * });\n * ```\n *\n * The module must export the component as its **default** export:\n * ```ts\n * // pages/dashboard.tsx\n * export default function DashboardPage() { … }\n * ```\n */\nexport function lazy(\n  factory: () => Promise<{ default: RouteComponent } | RouteComponent>\n): RouteComponent {\n  let resolved: RouteComponent | null = null;\n  let loadError: unknown = null;\n\n  const promise = factory().then(\n    (mod) => {\n      resolved =\n        typeof mod === 'function'\n          ? mod\n          : (mod as { default: RouteComponent }).default;\n      pendingLazy.delete(promise);\n    },\n    (err: unknown) => {\n      loadError = err;\n      pendingLazy.delete(promise);\n    }\n  );\n  pendingLazy.add(promise);\n\n  return (params) => {\n    if (loadError) throw loadError as Error;\n    if (!resolved) {\n      throw new Error(\n        'lazy() component used before it was resolved. ' +\n          'Await createSPA() / hydrateSPA() to ensure all chunks load first.'\n      );\n    }\n    return resolved(params);\n  };\n}\n\n/**\n * Wait for all pending `lazy()` imports to settle.\n * Called automatically by `createSPA` / `hydrateSPA` before mounting.\n */\nexport function _drainLazy(\n  additionalPending: Iterable<Promise<unknown>> = []\n): Promise<void> {\n  const combined = new Set<Promise<unknown>>([\n    ...additionalPending,\n    ...pendingLazy,\n  ]);\n  if (combined.size === 0) return Promise.resolve();\n  return Promise.allSettled(combined).then(() => undefined);\n}\n\nexport function group(options: GroupHelperOptions, fn: RouteDefinition): void;\nexport function group(options: GroupHelperOptions, fn: RouteDefinition): void {\n  pushGroupScope(options, fn);\n}\n\nexport function fallback(Component: RouteComponent): void {\n  const allowsRootFallback = registrationScopeStack.every(\n    (scope) =>\n      scope.policies.length === 0 &&\n      !scope.state.guestOnly &&\n      !scope.state.authenticated\n  );\n\n  if (!allowsRootFallback) {\n    throw new Error(\n      'fallback() can only be registered at the root scope. ' +\n        'Use route(\"/*\", Component) if you need compatibility behavior.'\n    );\n  }\n\n  route('/*', Component);\n}\n\nfunction pushRegistrationScope(\n  scope: RegistrationScope,\n  fn: RouteDefinition\n): void {\n  registrationScopeStack.push(scope);\n  try {\n    fn();\n  } finally {\n    registrationScopeStack.pop();\n  }\n}\n\nfunction pushGroupScope(\n  options: GroupHelperOptions,\n  fn: RouteDefinition\n): void {\n  const session = getCurrentRegistrationSession();\n  validateAccessMetadata(options, {\n    authConfigured: session.authConfigured,\n    state: getCurrentAccessScopeState(),\n  });\n  const policies = compileNodePolicies(options);\n\n  pushRegistrationScope(\n    {\n      layout: options.layout,\n      policies,\n      state: nextAccessScopeState(options, getCurrentAccessScopeState()),\n    },\n    fn\n  );\n}\n\nfunction hasBuiltInAuthMetadata(\n  node: Pick<GroupHelperOptions | RouteOptions, 'auth' | 'role' | 'permission'>\n): boolean {\n  return node.auth !== undefined || !!node.role || !!node.permission;\n}\n\nfunction validateSameNodeAccessMetadata(\n  node: Pick<GroupHelperOptions | RouteOptions, 'auth' | 'role' | 'permission'>\n): void {\n  if (node.auth === 'guest' && (!!node.role || !!node.permission)) {\n    throw new Error(\n      'Guest-only routes cannot be combined with role or permission requirements.'\n    );\n  }\n}\n\nfunction validateAccessMetadata(\n  node: Pick<GroupHelperOptions | RouteOptions, 'auth' | 'role' | 'permission'>,\n  context: {\n    authConfigured: boolean;\n    state: AccessScopeState;\n  }\n): void {\n  validateSameNodeAccessMetadata(node);\n\n  const requiresAuthenticated =\n    node.auth === true || !!node.role || !!node.permission;\n\n  if (\n    node.auth === 'guest' &&\n    (context.state.authenticated || !!node.role || !!node.permission)\n  ) {\n    throw new Error(\n      'Guest-only routes cannot be combined with authenticated access requirements.'\n    );\n  }\n\n  if (context.state.guestOnly && requiresAuthenticated) {\n    throw new Error(\n      'Child routes cannot weaken a guest-only access scope with authenticated requirements.'\n    );\n  }\n\n  if (hasBuiltInAuthMetadata(node) && !context.authConfigured) {\n    throw new Error(\n      'Routes using `auth`, `role`, or `permission` require `auth.resolve` in registerRoutes(...).'\n    );\n  }\n}\n\nfunction nextAccessScopeState(\n  node: Pick<GroupHelperOptions | RouteOptions, 'auth' | 'role' | 'permission'>,\n  state: AccessScopeState\n): AccessScopeState {\n  const requiresAuthenticated =\n    node.auth === true || !!node.role || !!node.permission;\n\n  return {\n    guestOnly: state.guestOnly || node.auth === 'guest',\n    authenticated: state.authenticated || requiresAuthenticated,\n  };\n}\n\nfunction compileNodePolicies(\n  node: Pick<\n    RouteOptions | GroupHelperOptions,\n    'auth' | 'role' | 'permission' | 'policies'\n  >\n): RoutePolicy[] {\n  validateSameNodeAccessMetadata(node);\n\n  const compiled: RoutePolicy[] = [];\n\n  if (node.auth === true) {\n    compiled.push(requireAuth());\n  } else if (node.auth === 'guest') {\n    compiled.push(requireGuest());\n  }\n\n  if (node.role) {\n    compiled.push(requireRole(node.role));\n  }\n\n  if (node.permission) {\n    compiled.push(requirePermission(node.permission));\n  }\n\n  if (node.policies?.length) {\n    compiled.push(...node.policies);\n  }\n\n  return compiled;\n}\n\nfunction normalizeRouteOptions(\n  options: RouteOptions | undefined\n): RouteOptions | undefined {\n  if (!options) {\n    return undefined;\n  }\n\n  const loader = options.loader;\n  const policies = compileNodePolicies(options);\n\n  if (\n    !loader &&\n    !options.entries &&\n    policies.length === 0 &&\n    !options.title &&\n    !options.namespace &&\n    options.auth === undefined &&\n    !options.role &&\n    !options.permission\n  ) {\n    return undefined;\n  }\n\n  return {\n    ...(loader ? { loader } : {}),\n    ...(options.entries ? { entries: options.entries } : {}),\n    ...(options.auth !== undefined ? { auth: options.auth } : {}),\n    ...(options.role ? { role: options.role } : {}),\n    ...(options.permission ? { permission: options.permission } : {}),\n    ...(policies.length > 0 ? { policies } : {}),\n    ...(options.title ? { title: options.title } : {}),\n    ...(options.namespace ? { namespace: options.namespace } : {}),\n  };\n}\nexport function registerRoutes(\n  definition: RouteDefinition,\n  options: RegisterRoutesOptions = {}\n): void {\n  defaultRouteAuthOptions = options.auth;\n\n  registrationSessionStack.push({\n    authConfigured: !!options.auth?.resolve,\n  });\n  try {\n    definition();\n  } finally {\n    registrationSessionStack.pop();\n  }\n}\n\n// ---------------------------------------------------------------------------\n// route() — dual-purpose: registration (module load) + accessor (render time)\n// ---------------------------------------------------------------------------\n\nfunction readCurrentRouteSnapshot(): RouteSnapshot {\n  const instance = getCurrentComponentInstance();\n  if (!instance) {\n    throw new Error(\n      'currentRoute() can only be called during component render execution. ' +\n        'Call currentRoute() from inside your component function.'\n    );\n  }\n\n  let pathname = '/';\n  let search = '';\n  let hash = '';\n  const renderContext = getRenderContext();\n\n  if (instance.ssr && renderContext?.url) {\n    const parsed = parseLocation(renderContext.url);\n    pathname = parsed.pathname;\n    search = parsed.search;\n    hash = parsed.hash;\n  } else if (typeof window !== 'undefined' && window.location) {\n    pathname = window.location.pathname || '/';\n    search = window.location.search || '';\n    hash = window.location.hash || '';\n  } else if (serverLocation) {\n    const parsed = parseLocation(serverLocation);\n    pathname = parsed.pathname;\n    search = parsed.search;\n    hash = parsed.hash;\n  }\n\n  const query = makeQuery(search);\n  const matches = computeMatchesFromRoutes(pathname, getActiveRoutes());\n  const instanceParams = instance.props as Record<string, string>;\n  const routeParams =\n    Object.keys(instanceParams).length > 0\n      ? instanceParams\n      : (matches[0]?.params ?? {});\n  const params = deepFreeze({\n    ...routeParams,\n  });\n\n  return Object.freeze({\n    path: pathname,\n    params,\n    query,\n    hash: hash || null,\n    matches: Object.freeze(matches),\n  });\n}\n\nexport function currentRoute(): RouteSnapshot {\n  return readCurrentRouteSnapshot();\n}\n\n/**\n * Register a route.\n *\n * ```ts\n * route('/posts/{slug}', PostPage, {\n *   loader:  ({ params }) => getPost(params.slug),\n *   entries: async () => getPosts().map(p => ({ slug: p.slug })),\n *   title:   'Post',\n *   policies:[requireAuth()],\n * });\n * ```\n */\nexport function route(\n  path: string,\n  Component: RouteComponent,\n  options?: RouteOptions\n): void;\nexport function route(\n  path: string,\n  Component: RouteComponent,\n  options?: RouteOptions\n): void {\n  if (getExecutionModel() === 'islands') {\n    throw new Error(\n      'Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.'\n    );\n  }\n\n  // ── Render-time accessor (no arguments) ─────────────────────────────────\n  if (typeof path === 'undefined') {\n    throw new Error(\n      'route() is only for route registration. Use currentRoute() inside components.'\n    );\n  }\n\n  // ── Registration mode ────────────────────────────────────────────────────\n\n  // Disallow registration during SSR render\n  const currentInst = getCurrentComponentInstance();\n  if (currentInst && currentInst.ssr) {\n    throw new Error(\n      'route() cannot be called during SSR rendering. Register routes at module load time instead.'\n    );\n  }\n\n  if (registrationLocked) {\n    throw new Error(\n      'Route registration is locked after app startup. ' +\n        'Register routes at module load time before calling createSPA or createSSR.'\n    );\n  }\n\n  if (typeof Component !== 'function') {\n    throw new Error(\n      'route(path, Component) requires a component function as the second argument. ' +\n        'Passing JSX elements or VNodes directly is not supported.'\n    );\n  }\n\n  validateRoutePath(path);\n  validateAccessMetadata(options ?? {}, {\n    authConfigured: getCurrentRegistrationSession().authConfigured,\n    state: getCurrentAccessScopeState(),\n  });\n\n  const chain = getCurrentLayoutChain();\n  const segments = parseSegments(path);\n  const rank = computeRank(segments);\n  const isFallback = path === '/*';\n  const comp = Component;\n  const normalizedOptions = normalizeRouteOptions(options);\n  const policies = [\n    ...getCurrentInheritedPolicies(),\n    ...(normalizedOptions?.policies ?? []),\n  ];\n\n  const handler: RouteHandler = (params) => {\n    let content = comp(params);\n\n    for (let i = chain.length - 1; i >= 0; i--) {\n      content = chain[i].component({ children: content });\n    }\n\n    return content;\n  };\n\n  const record: RouteRecord = {\n    path,\n    component: comp,\n    segments,\n    rank,\n    layoutChain: chain,\n    options: normalizedOptions\n      ? {\n          ...normalizedOptions,\n          ...(policies.length > 0 ? { policies } : {}),\n        }\n      : policies.length > 0\n        ? { policies }\n        : {},\n    isFallback,\n    handler,\n  };\n\n  insertRecordSorted(record);\n  addRouteToStores({\n    path,\n    handler,\n    namespace: normalizedOptions?.namespace ?? options?.namespace,\n  });\n}\n\n// ---------------------------------------------------------------------------\n// Manifest access\n// ---------------------------------------------------------------------------\n\n/**\n * Return the normalized route manifest built from registered route definitions.\n *\n * Pass this to `createSPA`, `hydrateSPA`, or `renderToString` as the\n * authoritative routing input:\n *\n * ```ts\n * import { getManifest } from '@askrjs/askr/router';\n * await createSPA({ root: '#app', manifest: getManifest() });\n * ```\n */\nexport function getManifest(): RouteManifest {\n  return {\n    records: [...records],\n    ...(defaultRouteAuthOptions ? { auth: defaultRouteAuthOptions } : {}),\n  };\n}\n\n/**\n * Internal: apply a pre-built manifest to the runtime stores without running\n * route() again. Called by createSPA / hydrateSPA when a manifest is passed.\n */\nexport function _applyManifest(manifest: RouteManifest): void {\n  defaultRouteAuthOptions = manifest.auth;\n  for (const record of manifest.records) {\n    records.push(record);\n    addRouteToStores({\n      path: record.path,\n      handler: record.handler,\n      namespace: record.options.namespace,\n    });\n  }\n  // Sort once after bulk insert so resolveRoute can use first-match-wins\n  records.sort((a, b) => b.rank - a.rank);\n}\n\n// ---------------------------------------------------------------------------\n// Route collection helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Get all registered routes (flat list, insertion order).\n * Prefer `getManifest()` when metadata (loader, policies, entries) is needed.\n */\nexport function getRoutes(): Route[] {\n  return [...routes];\n}\n\n/** Get routes for a specific namespace. */\nexport function getNamespaceRoutes(namespace: string): Route[] {\n  return routes.filter((r) => r.namespace === namespace);\n}\n\n/** Unload all routes from a namespace (for MFE unmounting). */\nexport function unloadNamespace(namespace: string): number {\n  const before = routes.length;\n\n  for (let i = routes.length - 1; i >= 0; i--) {\n    if (routes[i].namespace === namespace) {\n      const removed = routes[i];\n      routes.splice(i, 1);\n\n      const depth = getDepth(removed.path);\n      const depthRoutes = routesByDepth.get(depth);\n      if (depthRoutes) {\n        const idx = depthRoutes.indexOf(removed);\n        if (idx >= 0) depthRoutes.splice(idx, 1);\n      }\n    }\n  }\n\n  // Remove matching records too\n  for (let i = records.length - 1; i >= 0; i--) {\n    if (records[i].options.namespace === namespace) {\n      records.splice(i, 1);\n    }\n  }\n\n  namespaces.delete(namespace);\n  return before - routes.length;\n}\n\n/** Clear all registered routes and records (testing / boot reset). */\nexport function clearRoutes(): void {\n  routes.length = 0;\n  records.length = 0;\n  namespaces.clear();\n  routesByDepth.clear();\n  registrationScopeStack.length = 0;\n  registrationSessionStack.length = 0;\n  registrationLocked = false;\n  defaultRouteAuthOptions = undefined;\n  activeClientRouteAuthOptions = undefined;\n  setHasRoutes(false);\n  pendingLazy.clear();\n}\n\n/**\n * Get all loaded namespaces (MFE identifiers)\n */\nexport function getLoadedNamespaces(): string[] {\n  return Array.from(namespaces);\n}\n\n/**\n * Resolve a path to a route handler.\n *\n * Hot path: walks the module-level `records[]` array which is kept sorted by\n * rank descending at registration time — so the first `matchSegments` hit is\n * always the most specific match.  No per-call allocations for the common\n * case of purely-static routes.\n */\nexport function resolveRoute(pathname: string): ResolvedRoute | null {\n  const normalized =\n    pathname.endsWith('/') && pathname !== '/'\n      ? pathname.slice(0, -1)\n      : pathname;\n  const urlParts =\n    normalized === '/' ? [] : normalized.split('/').filter(Boolean);\n\n  for (const record of records) {\n    const params = matchSegments(urlParts, record.segments);\n    if (params !== null) {\n      return { handler: record.handler, params };\n    }\n  }\n  return null;\n}\n\nfunction getMatchingRecord(\n  target: string,\n  routeRecords: readonly RouteRecord[]\n): { record: RouteRecord; params: Record<string, string> } | null {\n  const location = parseLocation(target);\n  const normalized =\n    location.pathname.endsWith('/') && location.pathname !== '/'\n      ? location.pathname.slice(0, -1)\n      : location.pathname;\n  const urlParts =\n    normalized === '/' ? [] : normalized.split('/').filter(Boolean);\n\n  for (const record of routeRecords) {\n    const params = matchSegments(urlParts, record.segments);\n    if (params !== null) {\n      return { record, params };\n    }\n  }\n\n  return null;\n}\n\nfunction getRoutePolicies(\n  options: RouteOptions | undefined\n): readonly RoutePolicy[] {\n  if (!options) {\n    return [];\n  }\n\n  if (options.policies?.length) {\n    return options.policies;\n  }\n\n  return compileNodePolicies(options);\n}\n\nfunction getDefaultRouteMode(): RouteContext['mode'] {\n  if (typeof window !== 'undefined') {\n    return 'spa';\n  }\n\n  return 'ssr';\n}\n\nfunction buildRenderResult(\n  record: RouteRecord,\n  params: Record<string, string>\n): RouteRenderResult {\n  return {\n    kind: 'render',\n    handler: record.handler,\n    params,\n  };\n}\n\nfunction continueRoutePolicies(\n  policies: readonly RoutePolicy[],\n  context: RouteContext,\n  record: RouteRecord,\n  params: Record<string, string>,\n  startIndex = 0\n): RouteRequestResult | Promise<RouteRequestResult> {\n  for (let index = startIndex; index < policies.length; index += 1) {\n    const policyResult = policies[index](context);\n\n    if (isPromise(policyResult)) {\n      return policyResult.then((next) => {\n        if (next.kind !== 'allow') {\n          return next;\n        }\n\n        return continueRoutePolicies(\n          policies,\n          context,\n          record,\n          params,\n          index + 1\n        );\n      });\n    }\n\n    if (policyResult.kind !== 'allow') {\n      return policyResult;\n    }\n  }\n\n  return buildRenderResult(record, params);\n}\n\nexport function resolveRouteRequest(\n  target: string,\n  options: RouteRequestOptions = {}\n): RouteRequestResult | Promise<RouteRequestResult> {\n  const routeRecords = options.manifest?.records ?? records;\n  const match = getMatchingRecord(target, routeRecords);\n\n  if (!match) {\n    return null;\n  }\n\n  const { record, params } = match;\n  const policies = getRoutePolicies(record.options);\n\n  if (policies.length === 0) {\n    return buildRenderResult(record, params);\n  }\n\n  const signal =\n    options.signal ??\n    getRenderContext()?.signal ??\n    new AbortController().signal;\n  const mode = options.mode ?? getDefaultRouteMode();\n  const auth = getActiveRouteAuthOptions(\n    options.auth ?? options.manifest?.auth\n  );\n  const baseContext = buildRouteContextBase(target, params, {\n    mode,\n    signal,\n  });\n\n  const finalize = (authState: { session: unknown; user: unknown }) =>\n    continueRoutePolicies(\n      policies,\n      buildRouteContext(target, params, {\n        mode,\n        signal,\n        auth,\n        session: authState.session,\n        user: authState.user,\n      }),\n      record,\n      params\n    );\n\n  if (!auth?.resolve) {\n    return finalize({ session: null, user: null });\n  }\n\n  const authState = auth.resolve(baseContext);\n  if (isPromise(authState)) {\n    return authState.then((next) => finalize(next));\n  }\n\n  return finalize(authState);\n}\n\n/**\n * Resolve a path against an explicit route list (e.g. an SSR per-render\n * context).  When called with the global `routes` array this delegates to\n * the faster `resolveRoute` which uses pre-sorted `records[]`.\n *\n * For externally supplied lists the function:\n *   1. Builds a rank-sorted copy of the list on first call and caches it\n *      in a WeakMap so subsequent resolutions against the same list pay\n *      zero sort cost.\n *   2. Uses pre-parsed `ParsedSegment[]` from a WeakMap cache so no string\n *      splitting or segment parsing occurs on the hot path.\n *   3. Uses a running-best with an early-exit once the sorted list reaches\n *      a rank that cannot beat the current best match.\n */\nexport function resolveRouteFromRoutes(\n  pathname: string,\n  routeList: readonly Route[]\n): ResolvedRoute | null {\n  if (routeList === routes) return resolveRoute(pathname);\n\n  const normalized =\n    pathname.endsWith('/') && pathname !== '/'\n      ? pathname.slice(0, -1)\n      : pathname;\n  const urlParts =\n    normalized === '/' ? [] : normalized.split('/').filter(Boolean);\n\n  // Use the rank-sorted cached copy so we can exit as soon as the rank\n  // drops below the current best — typically saving 30-50% of iterations.\n  const sorted = cachedSortedList(routeList);\n  let bestHandler: RouteHandler | null = null;\n  let bestParams: Record<string, string> = {};\n  let bestRank = -Infinity;\n\n  for (const r of sorted) {\n    const rank = cachedRank(r);\n    // sorted descending: once rank < bestRank every remaining route loses\n    if (rank < bestRank) break;\n    // already have the best match at this rank (first-declared wins)\n    if (bestHandler !== null && rank === bestRank) continue;\n    const params = matchSegments(urlParts, cachedSegs(r));\n    if (params !== null) {\n      bestHandler = r.handler;\n      bestParams = params;\n      bestRank = rank;\n    }\n  }\n\n  return bestHandler !== null\n    ? { handler: bestHandler, params: bestParams }\n    : null;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAwFA,MAAM,SAAkB,EAAE;;AAG1B,MAAM,UAAyB,EAAE;;AAajC,MAAM,yBAA8C,EAAE;AACtD,MAAM,2BAAkD,EAAE;AAE1D,MAAM,6BAAa,IAAI,KAAa;AAOpC,IAAI;AACJ,IAAI;AAEJ,MAAM,iBAAiB,OAAO,IAAI,sBAAsB;AAExD,SAAS,aAAa,OAAsB;AAC1C,KAAI;EACF,MAAM,IAAI;AACV,IAAE,kBAAkB;SACd;;AAMV,aAAa,MAAM;AAGnB,MAAM,gCAAgB,IAAI,KAAsB;;;;AAKhD,SAAS,SAAS,MAAsB;CACtC,MAAM,aACJ,KAAK,SAAS,IAAI,IAAI,SAAS,MAAM,KAAK,MAAM,GAAG,GAAG,GAAG;AAC3D,QAAO,eAAe,MAAM,IAAI,WAAW,MAAM,IAAI,CAAC,OAAO,QAAQ,CAAC;;;AAUxE,MAAM,iCAAiB,IAAI,SAAkD;;AAE7E,MAAM,iCAAiB,IAAI,SAAwB;;AAEnD,MAAM,kCAAkB,IAAI,SAGzB;AAEH,SAAS,WAAW,GAA4C;CAC9D,IAAI,IAAI,eAAe,IAAI,EAAE;AAC7B,KAAI,CAAC,GAAG;AACN,MAAI,cAAc,EAAE,KAAK;AACzB,iBAAe,IAAI,GAAG,EAAE;;AAE1B,QAAO;;AAGT,SAAS,WAAW,GAAkB;CACpC,IAAI,IAAI,eAAe,IAAI,EAAE;AAC7B,KAAI,MAAM,QAAW;AACnB,MAAI,YAAY,WAAW,EAAE,CAAC;AAC9B,iBAAe,IAAI,GAAG,EAAE;;AAE1B,QAAO;;AAGT,SAAS,iBACP,WACsB;CACtB,IAAI,SAAS,gBAAgB,IAAI,UAAU;AAC3C,KAAI,CAAC,QAAQ;AACX,WAAS,CAAC,GAAG,UAAU,CAAC,MAAM,GAAG,MAAM,WAAW,EAAE,GAAG,WAAW,EAAE,CAAC;AACrE,kBAAgB,IAAI,WAAW,OAAO;;AAExC,QAAO;;AAMT,IAAI,iBAAgC;AAEpC,SAAgB,kBAAkB,KAA0B;AAC1D,kBAAiB;;AAGnB,SAAS,UAAa,OAA4C;AAChE,QAAO,iBAAiB;;AAI1B,SAAS,yBACP,UACA,YACc;CACd,MAAM,UAMD,EAAE;CAEP,MAAM,aACJ,SAAS,SAAS,IAAI,IAAI,aAAa,MACnC,SAAS,MAAM,GAAG,GAAG,GACrB;CACN,MAAM,WACJ,eAAe,MAAM,EAAE,GAAG,WAAW,MAAM,IAAI,CAAC,OAAO,QAAQ;AAEjE,MAAK,MAAM,KAAK,YAAY;EAC1B,MAAM,SAAS,cAAc,UAAU,WAAW,EAAE,CAAC;AACrD,MAAI,WAAW,KACb,SAAQ,KAAK;GACX,SAAS,EAAE;GACX;GACA,MAAO,EAAwB;GAC/B,WAAW,EAAE;GACb,MAAM,WAAW,EAAE;GACpB,CAAC;;AAIN,SAAQ,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK;AAEvC,QAAO,QAAQ,KAAK,OAAO;EACzB,MAAM,EAAE;EACR,QAAQ,WAAW,EAAE,GAAG,EAAE,QAAQ,CAAC;EACnC,MAAM,EAAE;EACR,WAAW,EAAE;EACd,EAAE;;AAGL,SAAS,kBAAoC;AAE3C,QADsB,kBACf,EAAe,UAAU;;AAGlC,SAAS,0BACP,UAC8B;AAC9B,KAAI,SACF,QAAO;AAIT,QADsB,kBAEpB,EAAe,aACf,gCACA;;AAIJ,SAAgB,2BACd,MACM;AACN,gCAA+B;;AAGjC,SAAS,gCAAqD;AAC5D,QACE,yBAAyB,yBAAyB,SAAS,MAAM,EAC/D,gBAAgB,CAAC,CAAC,yBAAyB,SAC5C;;AAIL,SAAS,6BAA+C;AACtD,QACE,uBAAuB,uBAAuB,SAAS,IAAI,SAAS;EAClE,WAAW;EACX,eAAe;EAChB;;AAIL,SAAS,wBAA6C;CACpD,MAAM,cAAmC,EAAE;AAE3C,MAAK,MAAM,SAAS,uBAClB,KAAI,MAAM,OACR,aAAY,KAAK,EAAE,WAAW,MAAM,QAAQ,CAAC;AAIjD,QAAO;;AAGT,SAAS,8BAA6C;CACpD,MAAM,WAA0B,EAAE;AAElC,MAAK,MAAM,SAAS,uBAClB,KAAI,MAAM,SAAS,SAAS,EAC1B,UAAS,KAAK,GAAG,MAAM,SAAS;AAIpC,QAAO;;;;;;AAWT,IAAI,qBAAqB;AAEzB,SAAgB,wBAA8B;AAC5C,sBAAqB;;AAevB,SAAS,kBAAkB,MAAoB;AAC7C,KAAI,CAAC,KAAK,WAAW,IAAI,CACvB,OAAM,IAAI,MAAM,yCAAyC,KAAK,GAAG;AAGnE,KAAI,aAAa,KAAK,KAAK,EAAE;EAC3B,MAAM,YAAY,KAAK,QAAQ,eAAe,OAAO;AACrD,QAAM,IAAI,MACR,qEACU,UAAU,gBAAgB,KAAK,IAC1C;;;AAUL,SAAS,mBAAmB,QAA2B;CACrD,IAAI,KAAK;CACT,IAAI,KAAK,QAAQ;AAEjB,QAAO,KAAK,IAAI;EACd,MAAM,MAAO,KAAK,OAAQ;AAC1B,MAAI,QAAQ,KAAK,QAAQ,OAAO,KAAM,MAAK,MAAM;MAC5C,MAAK;;AAEZ,SAAQ,OAAO,IAAI,GAAG,OAAO;;AAO/B,SAAS,iBAAiB,UAAuB;AAC/C,QAAO,KAAK,SAAS;AACrB,cAAa,KAAK;CAElB,MAAM,QAAQ,SAAS,SAAS,KAAK;CACrC,IAAI,cAAc,cAAc,IAAI,MAAM;AAC1C,KAAI,CAAC,aAAa;AAChB,gBAAc,EAAE;AAChB,gBAAc,IAAI,OAAO,YAAY;;AAEvC,aAAY,KAAK,SAAS;AAE1B,KAAI,SAAS,UACX,YAAW,IAAI,SAAS,UAAU;;;AAStC,MAAM,8BAAc,IAAI,KAAuB;;;;;;AAO/C,SAAgB,gBAAoC;AAClD,QAAO,CAAC,GAAG,YAAY;;;;;;;;;;;;;;;;;;;;;;;AAwBzB,SAAgB,KACd,SACgB;CAChB,IAAI,WAAkC;CACtC,IAAI,YAAqB;CAEzB,MAAM,UAAU,SAAS,CAAC,MACvB,QAAQ;AACP,aACE,OAAO,QAAQ,aACX,MACC,IAAoC;AAC3C,cAAY,OAAO,QAAQ;KAE5B,QAAiB;AAChB,cAAY;AACZ,cAAY,OAAO,QAAQ;GAE9B;AACD,aAAY,IAAI,QAAQ;AAExB,SAAQ,WAAW;AACjB,MAAI,UAAW,OAAM;AACrB,MAAI,CAAC,SACH,OAAM,IAAI,MACR,kHAED;AAEH,SAAO,SAAS,OAAO;;;;;;;AAQ3B,SAAgB,WACd,oBAAgD,EAAE,EACnC;CACf,MAAM,WAAW,IAAI,IAAsB,CACzC,GAAG,mBACH,GAAG,YACJ,CAAC;AACF,KAAI,SAAS,SAAS,EAAG,QAAO,QAAQ,SAAS;AACjD,QAAO,QAAQ,WAAW,SAAS,CAAC,WAAW,OAAU;;AAI3D,SAAgB,MAAM,SAA6B,IAA2B;AAC5E,gBAAe,SAAS,GAAG;;AAG7B,SAAgB,SAAS,WAAiC;AAQxD,KAAI,CAPuB,uBAAuB,OAC/C,UACC,MAAM,SAAS,WAAW,KAC1B,CAAC,MAAM,MAAM,aACb,CAAC,MAAM,MAAM,cAGZ,CACH,OAAM,IAAI,MACR,wHAED;AAGH,OAAM,MAAM,UAAU;;AAGxB,SAAS,sBACP,OACA,IACM;AACN,wBAAuB,KAAK,MAAM;AAClC,KAAI;AACF,MAAI;WACI;AACR,yBAAuB,KAAK;;;AAIhC,SAAS,eACP,SACA,IACM;AAEN,wBAAuB,SAAS;EAC9B,gBAFc,+BAEE,CAAQ;EACxB,OAAO,4BAA4B;EACpC,CAAC;CACF,MAAM,WAAW,oBAAoB,QAAQ;AAE7C,uBACE;EACE,QAAQ,QAAQ;EAChB;EACA,OAAO,qBAAqB,SAAS,4BAA4B,CAAC;EACnE,EACD,GACD;;AAGH,SAAS,uBACP,MACS;AACT,QAAO,KAAK,SAAS,UAAa,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,KAAK;;AAG1D,SAAS,+BACP,MACM;AACN,KAAI,KAAK,SAAS,YAAY,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,KAAK,YAClD,OAAM,IAAI,MACR,6EACD;;AAIL,SAAS,uBACP,MACA,SAIM;AACN,gCAA+B,KAAK;CAEpC,MAAM,wBACJ,KAAK,SAAS,QAAQ,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,KAAK;AAE9C,KACE,KAAK,SAAS,YACb,QAAQ,MAAM,iBAAiB,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,KAAK,YAEtD,OAAM,IAAI,MACR,+EACD;AAGH,KAAI,QAAQ,MAAM,aAAa,sBAC7B,OAAM,IAAI,MACR,wFACD;AAGH,KAAI,uBAAuB,KAAK,IAAI,CAAC,QAAQ,eAC3C,OAAM,IAAI,MACR,8FACD;;AAIL,SAAS,qBACP,MACA,OACkB;CAClB,MAAM,wBACJ,KAAK,SAAS,QAAQ,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,KAAK;AAE9C,QAAO;EACL,WAAW,MAAM,aAAa,KAAK,SAAS;EAC5C,eAAe,MAAM,iBAAiB;EACvC;;AAGH,SAAS,oBACP,MAIe;AACf,gCAA+B,KAAK;CAEpC,MAAM,WAA0B,EAAE;AAElC,KAAI,KAAK,SAAS,KAChB,UAAS,KAAK,aAAa,CAAC;UACnB,KAAK,SAAS,QACvB,UAAS,KAAK,cAAc,CAAC;AAG/B,KAAI,KAAK,KACP,UAAS,KAAK,YAAY,KAAK,KAAK,CAAC;AAGvC,KAAI,KAAK,WACP,UAAS,KAAK,kBAAkB,KAAK,WAAW,CAAC;AAGnD,KAAI,KAAK,UAAU,OACjB,UAAS,KAAK,GAAG,KAAK,SAAS;AAGjC,QAAO;;AAGT,SAAS,sBACP,SAC0B;AAC1B,KAAI,CAAC,QACH;CAGF,MAAM,SAAS,QAAQ;CACvB,MAAM,WAAW,oBAAoB,QAAQ;AAE7C,KACE,CAAC,UACD,CAAC,QAAQ,WACT,SAAS,WAAW,KACpB,CAAC,QAAQ,SACT,CAAC,QAAQ,aACT,QAAQ,SAAS,UACjB,CAAC,QAAQ,QACT,CAAC,QAAQ,WAET;AAGF,QAAO;EACL,GAAI,SAAS,EAAE,QAAQ,GAAG,EAAE;EAC5B,GAAI,QAAQ,UAAU,EAAE,SAAS,QAAQ,SAAS,GAAG,EAAE;EACvD,GAAI,QAAQ,SAAS,SAAY,EAAE,MAAM,QAAQ,MAAM,GAAG,EAAE;EAC5D,GAAI,QAAQ,OAAO,EAAE,MAAM,QAAQ,MAAM,GAAG,EAAE;EAC9C,GAAI,QAAQ,aAAa,EAAE,YAAY,QAAQ,YAAY,GAAG,EAAE;EAChE,GAAI,SAAS,SAAS,IAAI,EAAE,UAAU,GAAG,EAAE;EAC3C,GAAI,QAAQ,QAAQ,EAAE,OAAO,QAAQ,OAAO,GAAG,EAAE;EACjD,GAAI,QAAQ,YAAY,EAAE,WAAW,QAAQ,WAAW,GAAG,EAAE;EAC9D;;AAEH,SAAgB,eACd,YACA,UAAiC,EAAE,EAC7B;AACN,2BAA0B,QAAQ;AAElC,0BAAyB,KAAK,EAC5B,gBAAgB,CAAC,CAAC,QAAQ,MAAM,SACjC,CAAC;AACF,KAAI;AACF,cAAY;WACJ;AACR,2BAAyB,KAAK;;;AAQlC,SAAS,2BAA0C;CACjD,MAAM,WAAW,6BAA6B;AAC9C,KAAI,CAAC,SACH,OAAM,IAAI,MACR,gIAED;CAGH,IAAI,WAAW;CACf,IAAI,SAAS;CACb,IAAI,OAAO;CACX,MAAM,gBAAgB,kBAAkB;AAExC,KAAI,SAAS,OAAO,eAAe,KAAK;EACtC,MAAM,SAAS,cAAc,cAAc,IAAI;AAC/C,aAAW,OAAO;AAClB,WAAS,OAAO;AAChB,SAAO,OAAO;YACL,OAAO,WAAW,eAAe,OAAO,UAAU;AAC3D,aAAW,OAAO,SAAS,YAAY;AACvC,WAAS,OAAO,SAAS,UAAU;AACnC,SAAO,OAAO,SAAS,QAAQ;YACtB,gBAAgB;EACzB,MAAM,SAAS,cAAc,eAAe;AAC5C,aAAW,OAAO;AAClB,WAAS,OAAO;AAChB,SAAO,OAAO;;CAGhB,MAAM,QAAQ,UAAU,OAAO;CAC/B,MAAM,UAAU,yBAAyB,UAAU,iBAAiB,CAAC;CACrE,MAAM,iBAAiB,SAAS;CAKhC,MAAM,SAAS,WAAW,EACxB,GAJA,OAAO,KAAK,eAAe,CAAC,SAAS,IACjC,iBACC,QAAQ,IAAI,UAAU,EAAE,EAG9B,CAAC;AAEF,QAAO,OAAO,OAAO;EACnB,MAAM;EACN;EACA;EACA,MAAM,QAAQ;EACd,SAAS,OAAO,OAAO,QAAQ;EAChC,CAAC;;AAGJ,SAAgB,eAA8B;AAC5C,QAAO,0BAA0B;;AAoBnC,SAAgB,MACd,MACA,WACA,SACM;AACN,KAAI,mBAAmB,KAAK,UAC1B,OAAM,IAAI,MACR,+FACD;AAIH,KAAI,OAAO,SAAS,YAClB,OAAM,IAAI,MACR,gFACD;CAMH,MAAM,cAAc,6BAA6B;AACjD,KAAI,eAAe,YAAY,IAC7B,OAAM,IAAI,MACR,8FACD;AAGH,KAAI,mBACF,OAAM,IAAI,MACR,6HAED;AAGH,KAAI,OAAO,cAAc,WACvB,OAAM,IAAI,MACR,yIAED;AAGH,mBAAkB,KAAK;AACvB,wBAAuB,WAAW,EAAE,EAAE;EACpC,gBAAgB,+BAA+B,CAAC;EAChD,OAAO,4BAA4B;EACpC,CAAC;CAEF,MAAM,QAAQ,uBAAuB;CACrC,MAAM,WAAW,cAAc,KAAK;CACpC,MAAM,OAAO,YAAY,SAAS;CAClC,MAAM,aAAa,SAAS;CAC5B,MAAM,OAAO;CACb,MAAM,oBAAoB,sBAAsB,QAAQ;CACxD,MAAM,WAAW,CACf,GAAG,6BAA6B,EAChC,GAAI,mBAAmB,YAAY,EAAE,CACtC;CAED,MAAM,WAAyB,WAAW;EACxC,IAAI,UAAU,KAAK,OAAO;AAE1B,OAAK,IAAI,IAAI,MAAM,SAAS,GAAG,KAAK,GAAG,IACrC,WAAU,MAAM,GAAG,UAAU,EAAE,UAAU,SAAS,CAAC;AAGrD,SAAO;;AAqBT,oBAAmB;EAjBjB;EACA,WAAW;EACX;EACA;EACA,aAAa;EACb,SAAS,oBACL;GACE,GAAG;GACH,GAAI,SAAS,SAAS,IAAI,EAAE,UAAU,GAAG,EAAE;GAC5C,GACD,SAAS,SAAS,IAChB,EAAE,UAAU,GACZ,EAAE;EACR;EACA;EAGiB,CAAO;AAC1B,kBAAiB;EACf;EACA;EACA,WAAW,mBAAmB,aAAa,SAAS;EACrD,CAAC;;;;;;;;;;;;;AAkBJ,SAAgB,cAA6B;AAC3C,QAAO;EACL,SAAS,CAAC,GAAG,QAAQ;EACrB,GAAI,0BAA0B,EAAE,MAAM,yBAAyB,GAAG,EAAE;EACrE;;;;;;AAOH,SAAgB,eAAe,UAA+B;AAC5D,2BAA0B,SAAS;AACnC,MAAK,MAAM,UAAU,SAAS,SAAS;AACrC,UAAQ,KAAK,OAAO;AACpB,mBAAiB;GACf,MAAM,OAAO;GACb,SAAS,OAAO;GAChB,WAAW,OAAO,QAAQ;GAC3B,CAAC;;AAGJ,SAAQ,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK;;;;;;AAWzC,SAAgB,YAAqB;AACnC,QAAO,CAAC,GAAG,OAAO;;;AAIpB,SAAgB,mBAAmB,WAA4B;AAC7D,QAAO,OAAO,QAAQ,MAAM,EAAE,cAAc,UAAU;;;AAIxD,SAAgB,gBAAgB,WAA2B;CACzD,MAAM,SAAS,OAAO;AAEtB,MAAK,IAAI,IAAI,OAAO,SAAS,GAAG,KAAK,GAAG,IACtC,KAAI,OAAO,GAAG,cAAc,WAAW;EACrC,MAAM,UAAU,OAAO;AACvB,SAAO,OAAO,GAAG,EAAE;EAEnB,MAAM,QAAQ,SAAS,QAAQ,KAAK;EACpC,MAAM,cAAc,cAAc,IAAI,MAAM;AAC5C,MAAI,aAAa;GACf,MAAM,MAAM,YAAY,QAAQ,QAAQ;AACxC,OAAI,OAAO,EAAG,aAAY,OAAO,KAAK,EAAE;;;AAM9C,MAAK,IAAI,IAAI,QAAQ,SAAS,GAAG,KAAK,GAAG,IACvC,KAAI,QAAQ,GAAG,QAAQ,cAAc,UACnC,SAAQ,OAAO,GAAG,EAAE;AAIxB,YAAW,OAAO,UAAU;AAC5B,QAAO,SAAS,OAAO;;;AAIzB,SAAgB,cAAoB;AAClC,QAAO,SAAS;AAChB,SAAQ,SAAS;AACjB,YAAW,OAAO;AAClB,eAAc,OAAO;AACrB,wBAAuB,SAAS;AAChC,0BAAyB,SAAS;AAClC,sBAAqB;AACrB,2BAA0B;AAC1B,gCAA+B;AAC/B,cAAa,MAAM;AACnB,aAAY,OAAO;;;;;AAMrB,SAAgB,sBAAgC;AAC9C,QAAO,MAAM,KAAK,WAAW;;;;;;;;;;AAW/B,SAAgB,aAAa,UAAwC;CACnE,MAAM,aACJ,SAAS,SAAS,IAAI,IAAI,aAAa,MACnC,SAAS,MAAM,GAAG,GAAG,GACrB;CACN,MAAM,WACJ,eAAe,MAAM,EAAE,GAAG,WAAW,MAAM,IAAI,CAAC,OAAO,QAAQ;AAEjE,MAAK,MAAM,UAAU,SAAS;EAC5B,MAAM,SAAS,cAAc,UAAU,OAAO,SAAS;AACvD,MAAI,WAAW,KACb,QAAO;GAAE,SAAS,OAAO;GAAS;GAAQ;;AAG9C,QAAO;;AAGT,SAAS,kBACP,QACA,cACgE;CAChE,MAAM,WAAW,cAAc,OAAO;CACtC,MAAM,aACJ,SAAS,SAAS,SAAS,IAAI,IAAI,SAAS,aAAa,MACrD,SAAS,SAAS,MAAM,GAAG,GAAG,GAC9B,SAAS;CACf,MAAM,WACJ,eAAe,MAAM,EAAE,GAAG,WAAW,MAAM,IAAI,CAAC,OAAO,QAAQ;AAEjE,MAAK,MAAM,UAAU,cAAc;EACjC,MAAM,SAAS,cAAc,UAAU,OAAO,SAAS;AACvD,MAAI,WAAW,KACb,QAAO;GAAE;GAAQ;GAAQ;;AAI7B,QAAO;;AAGT,SAAS,iBACP,SACwB;AACxB,KAAI,CAAC,QACH,QAAO,EAAE;AAGX,KAAI,QAAQ,UAAU,OACpB,QAAO,QAAQ;AAGjB,QAAO,oBAAoB,QAAQ;;AAGrC,SAAS,sBAA4C;AACnD,KAAI,OAAO,WAAW,YACpB,QAAO;AAGT,QAAO;;AAGT,SAAS,kBACP,QACA,QACmB;AACnB,QAAO;EACL,MAAM;EACN,SAAS,OAAO;EAChB;EACD;;AAGH,SAAS,sBACP,UACA,SACA,QACA,QACA,aAAa,GACqC;AAClD,MAAK,IAAI,QAAQ,YAAY,QAAQ,SAAS,QAAQ,SAAS,GAAG;EAChE,MAAM,eAAe,SAAS,OAAO,QAAQ;AAE7C,MAAI,UAAU,aAAa,CACzB,QAAO,aAAa,MAAM,SAAS;AACjC,OAAI,KAAK,SAAS,QAChB,QAAO;AAGT,UAAO,sBACL,UACA,SACA,QACA,QACA,QAAQ,EACT;IACD;AAGJ,MAAI,aAAa,SAAS,QACxB,QAAO;;AAIX,QAAO,kBAAkB,QAAQ,OAAO;;AAG1C,SAAgB,oBACd,QACA,UAA+B,EAAE,EACiB;CAElD,MAAM,QAAQ,kBAAkB,QADX,QAAQ,UAAU,WAAW,QACG;AAErD,KAAI,CAAC,MACH,QAAO;CAGT,MAAM,EAAE,QAAQ,WAAW;CAC3B,MAAM,WAAW,iBAAiB,OAAO,QAAQ;AAEjD,KAAI,SAAS,WAAW,EACtB,QAAO,kBAAkB,QAAQ,OAAO;CAG1C,MAAM,SACJ,QAAQ,UACR,kBAAkB,EAAE,UACpB,IAAI,iBAAiB,CAAC;CACxB,MAAM,OAAO,QAAQ,QAAQ,qBAAqB;CAClD,MAAM,OAAO,0BACX,QAAQ,QAAQ,QAAQ,UAAU,KACnC;CACD,MAAM,cAAc,sBAAsB,QAAQ,QAAQ;EACxD;EACA;EACD,CAAC;CAEF,MAAM,YAAY,cAChB,sBACE,UACA,kBAAkB,QAAQ,QAAQ;EAChC;EACA;EACA;EACA,SAAS,UAAU;EACnB,MAAM,UAAU;EACjB,CAAC,EACF,QACA,OACD;AAEH,KAAI,CAAC,MAAM,QACT,QAAO,SAAS;EAAE,SAAS;EAAM,MAAM;EAAM,CAAC;CAGhD,MAAM,YAAY,KAAK,QAAQ,YAAY;AAC3C,KAAI,UAAU,UAAU,CACtB,QAAO,UAAU,MAAM,SAAS,SAAS,KAAK,CAAC;AAGjD,QAAO,SAAS,UAAU;;;;;;;;;;;;;;;;AAiB5B,SAAgB,uBACd,UACA,WACsB;AACtB,KAAI,cAAc,OAAQ,QAAO,aAAa,SAAS;CAEvD,MAAM,aACJ,SAAS,SAAS,IAAI,IAAI,aAAa,MACnC,SAAS,MAAM,GAAG,GAAG,GACrB;CACN,MAAM,WACJ,eAAe,MAAM,EAAE,GAAG,WAAW,MAAM,IAAI,CAAC,OAAO,QAAQ;CAIjE,MAAM,SAAS,iBAAiB,UAAU;CAC1C,IAAI,cAAmC;CACvC,IAAI,aAAqC,EAAE;CAC3C,IAAI,WAAW;AAEf,MAAK,MAAM,KAAK,QAAQ;EACtB,MAAM,OAAO,WAAW,EAAE;AAE1B,MAAI,OAAO,SAAU;AAErB,MAAI,gBAAgB,QAAQ,SAAS,SAAU;EAC/C,MAAM,SAAS,cAAc,UAAU,WAAW,EAAE,CAAC;AACrD,MAAI,WAAW,MAAM;AACnB,iBAAc,EAAE;AAChB,gBAAa;AACb,cAAW;;;AAIf,QAAO,gBAAgB,OACnB;EAAE,SAAS;EAAa,QAAQ;EAAY,GAC5C"}

package/dist/runtime/child-scope.d.ts

@@ -0,0 +1,21 @@
+import { ComponentInstance } from "./component.js";
+import { VNode } from "../common/vnode.js";
+
+//#region src/runtime/child-scope.d.ts
+interface ChildScope {
+  key: string | number;
+  componentInstance: ComponentInstance;
+  previousVnode: VNode | undefined;
+  vnode: VNode | undefined;
+  dom?: Node;
+  needsDomUpdate: boolean;
+  render(renderFn: () => VNode): VNode;
+  markDirty(): void;
+  dispose(): void;
+}
+declare function rerenderChildScope(scope: ChildScope): VNode | undefined;
+declare function disposeChildScope(scope: ChildScope): void;
+declare function createChildScope(parent: ComponentInstance | null, key: string | number, onDirty?: () => void): ChildScope;
+//#endregion
+export { ChildScope };
+//# sourceMappingURL=child-scope.d.ts.map

package/dist/runtime/child-scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-scope.d.ts","names":[],"sources":["../../src/runtime/child-scope.ts"],"mappings":";;;;UAciB,UAAA;EACf,GAAA;EACA,iBAAA,EAAmB,iBAAA;EACnB,aAAA,EAAe,KAAA;EACf,KAAA,EAAO,KAAA;EACP,GAAA,GAAM,IAAA;EACN,cAAA;EACA,MAAA,CAAO,QAAA,QAAgB,KAAA,GAAQ,KAAA;EAC/B,SAAA;EACA,OAAA;AAAA;AAAA,iBAiEc,kBAAA,CAAmB,KAAA,EAAO,UAAA,GAAa,KAAA;AAAA,iBAIvC,iBAAA,CAAkB,KAAA,EAAO,UAAA;AAAA,iBAIzB,gBAAA,CACd,MAAA,EAAQ,iBAAA,SACR,GAAA,mBACA,OAAA,gBACC,UAAA"}

package/dist/runtime/child-scope.js

@@ -0,0 +1,77 @@
+import { _isDOMElement } from "../common/vnode.js";
+import { isDevelopmentEnvironment } from "../common/env.js";
+import { cleanupComponent, createComponentInstance, finalizeReadSubscriptions, getCurrentStateIndex, registerOwnedChildScope, renderScopedComponent, unregisterOwnedChildScope } from "./component.js";
+//#region src/runtime/child-scope.ts
+function renderScope(scope) {
+	if (scope._disposed) {
+		if (isDevelopmentEnvironment()) throw new Error(`[askr] Attempted to render disposed child scope ${String(scope.key)}.`);
+		return scope.vnode;
+	}
+	if (!scope._renderFn) return scope.vnode;
+	const { componentInstance } = scope;
+	const previousVNode = scope.vnode;
+	try {
+		const nextVNode = renderScopedComponent(componentInstance, scope._startStateIndex, scope._renderFn);
+		if (previousVNode && nextVNode && _isDOMElement(previousVNode) && _isDOMElement(nextVNode) && typeof previousVNode.type === "function" && previousVNode.type === nextVNode.type && "__instance" in previousVNode && !("__instance" in nextVNode)) nextVNode.__instance = previousVNode.__instance;
+		scope.previousVnode = previousVNode;
+		scope.vnode = nextVNode;
+		scope.markDirty();
+		finalizeReadSubscriptions(componentInstance);
+		return scope.vnode;
+	} catch (error) {
+		componentInstance.hasPendingUpdate = false;
+		throw error;
+	}
+}
+function rerenderChildScope(scope) {
+	return renderScope(scope);
+}
+function disposeChildScope(scope) {
+	scope.dispose();
+}
+function createChildScope(parent, key, onDirty) {
+	const scope = {};
+	const componentInstance = createComponentInstance(`child-scope-${String(key)}`, () => scope._renderFn?.() ?? null, {}, null);
+	if (parent) componentInstance.ownerFrame = parent.ownerFrame;
+	scope.key = key;
+	scope.componentInstance = componentInstance;
+	scope.previousVnode = void 0;
+	scope.vnode = void 0;
+	scope.dom = void 0;
+	scope.needsDomUpdate = true;
+	scope._startStateIndex = getCurrentStateIndex();
+	scope._renderFn = void 0;
+	scope._onDirty = onDirty;
+	scope._parent = parent;
+	scope._disposed = false;
+	scope.markDirty = () => {
+		scope.needsDomUpdate = true;
+	};
+	scope.render = (renderFn) => {
+		scope._renderFn = renderFn;
+		return renderScope(scope);
+	};
+	scope.dispose = () => {
+		if (scope._disposed) return;
+		scope._disposed = true;
+		if (scope._parent) unregisterOwnedChildScope(scope._parent, scope);
+		cleanupComponent(componentInstance);
+		scope._renderFn = void 0;
+		scope.previousVnode = void 0;
+		scope.vnode = void 0;
+		scope.dom = void 0;
+		scope.needsDomUpdate = false;
+		componentInstance.hasPendingUpdate = false;
+	};
+	componentInstance._pendingFlushTask = () => {
+		componentInstance.hasPendingUpdate = false;
+		renderScope(scope);
+		scope._onDirty?.();
+	};
+	if (parent) registerOwnedChildScope(parent, scope);
+	return scope;
+}
+//#endregion
+export { createChildScope, disposeChildScope, rerenderChildScope };
+
+//# sourceMappingURL=child-scope.js.map

package/dist/runtime/child-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-scope.js","names":[],"sources":["../../src/runtime/child-scope.ts"],"sourcesContent":["import type { VNode } from '../common/vnode';\nimport { _isDOMElement } from '../common/vnode';\nimport {\n  cleanupComponent,\n  createComponentInstance,\n  finalizeReadSubscriptions,\n  getCurrentStateIndex,\n  registerOwnedChildScope,\n  renderScopedComponent,\n  unregisterOwnedChildScope,\n  type ComponentInstance,\n} from './component';\nimport { isDevelopmentEnvironment } from '../common/env';\n\nexport interface ChildScope {\n  key: string | number;\n  componentInstance: ComponentInstance;\n  previousVnode: VNode | undefined;\n  vnode: VNode | undefined;\n  dom?: Node;\n  needsDomUpdate: boolean;\n  render(renderFn: () => VNode): VNode;\n  markDirty(): void;\n  dispose(): void;\n}\n\ninterface MutableChildScope extends ChildScope {\n  _startStateIndex: number;\n  _renderFn?: (() => VNode) | undefined;\n  _onDirty?: (() => void) | undefined;\n  _parent?: ComponentInstance | null;\n  _disposed: boolean;\n}\n\nfunction renderScope(scope: MutableChildScope): VNode | undefined {\n  if (scope._disposed) {\n    if (isDevelopmentEnvironment()) {\n      throw new Error(\n        `[askr] Attempted to render disposed child scope ${String(scope.key)}.`\n      );\n    }\n    return scope.vnode;\n  }\n\n  if (!scope._renderFn) {\n    return scope.vnode;\n  }\n\n  const { componentInstance } = scope;\n  const previousVNode = scope.vnode;\n\n  try {\n    const nextVNode = renderScopedComponent(\n      componentInstance,\n      scope._startStateIndex,\n      scope._renderFn\n    );\n    if (\n      previousVNode &&\n      nextVNode &&\n      _isDOMElement(previousVNode) &&\n      _isDOMElement(nextVNode) &&\n      typeof previousVNode.type === 'function' &&\n      previousVNode.type === nextVNode.type &&\n      '__instance' in previousVNode &&\n      !('__instance' in nextVNode)\n    ) {\n      (\n        nextVNode as VNode & {\n          __instance?: ComponentInstance;\n        }\n      ).__instance = (\n        previousVNode as VNode & {\n          __instance?: ComponentInstance;\n        }\n      ).__instance;\n    }\n    scope.previousVnode = previousVNode;\n    scope.vnode = nextVNode;\n    scope.markDirty();\n    finalizeReadSubscriptions(componentInstance);\n    return scope.vnode;\n  } catch (error) {\n    componentInstance.hasPendingUpdate = false;\n    throw error;\n  }\n}\n\nexport function rerenderChildScope(scope: ChildScope): VNode | undefined {\n  return renderScope(scope as MutableChildScope);\n}\n\nexport function disposeChildScope(scope: ChildScope): void {\n  scope.dispose();\n}\n\nexport function createChildScope(\n  parent: ComponentInstance | null,\n  key: string | number,\n  onDirty?: () => void\n): ChildScope {\n  const scope = {} as MutableChildScope;\n\n  const componentInstance = createComponentInstance(\n    `child-scope-${String(key)}`,\n    () => scope._renderFn?.() ?? null,\n    {},\n    null\n  );\n\n  if (parent) {\n    componentInstance.ownerFrame = parent.ownerFrame;\n  }\n\n  scope.key = key;\n  scope.componentInstance = componentInstance;\n  scope.previousVnode = undefined;\n  scope.vnode = undefined;\n  scope.dom = undefined;\n  scope.needsDomUpdate = true;\n  scope._startStateIndex = getCurrentStateIndex();\n  scope._renderFn = undefined;\n  scope._onDirty = onDirty;\n  scope._parent = parent;\n  scope._disposed = false;\n  scope.markDirty = () => {\n    scope.needsDomUpdate = true;\n  };\n  scope.render = (renderFn: () => VNode) => {\n    scope._renderFn = renderFn;\n    return renderScope(scope) as VNode;\n  };\n  scope.dispose = () => {\n    if (scope._disposed) {\n      return;\n    }\n    scope._disposed = true;\n    if (scope._parent) {\n      unregisterOwnedChildScope(scope._parent, scope);\n    }\n    cleanupComponent(componentInstance);\n    scope._renderFn = undefined;\n    scope.previousVnode = undefined;\n    scope.vnode = undefined;\n    scope.dom = undefined;\n    scope.needsDomUpdate = false;\n    componentInstance.hasPendingUpdate = false;\n  };\n\n  componentInstance._pendingFlushTask = () => {\n    componentInstance.hasPendingUpdate = false;\n    renderScope(scope);\n    scope._onDirty?.();\n  };\n\n  if (parent) {\n    registerOwnedChildScope(parent, scope);\n  }\n\n  return scope;\n}\n"],"mappings":";;;;AAkCA,SAAS,YAAY,OAA6C;AAChE,KAAI,MAAM,WAAW;AACnB,MAAI,0BAA0B,CAC5B,OAAM,IAAI,MACR,mDAAmD,OAAO,MAAM,IAAI,CAAC,GACtE;AAEH,SAAO,MAAM;;AAGf,KAAI,CAAC,MAAM,UACT,QAAO,MAAM;CAGf,MAAM,EAAE,sBAAsB;CAC9B,MAAM,gBAAgB,MAAM;AAE5B,KAAI;EACF,MAAM,YAAY,sBAChB,mBACA,MAAM,kBACN,MAAM,UACP;AACD,MACE,iBACA,aACA,cAAc,cAAc,IAC5B,cAAc,UAAU,IACxB,OAAO,cAAc,SAAS,cAC9B,cAAc,SAAS,UAAU,QACjC,gBAAgB,iBAChB,EAAE,gBAAgB,WAGhB,WAGA,aACA,cAGA;AAEJ,QAAM,gBAAgB;AACtB,QAAM,QAAQ;AACd,QAAM,WAAW;AACjB,4BAA0B,kBAAkB;AAC5C,SAAO,MAAM;UACN,OAAO;AACd,oBAAkB,mBAAmB;AACrC,QAAM;;;AAIV,SAAgB,mBAAmB,OAAsC;AACvE,QAAO,YAAY,MAA2B;;AAGhD,SAAgB,kBAAkB,OAAyB;AACzD,OAAM,SAAS;;AAGjB,SAAgB,iBACd,QACA,KACA,SACY;CACZ,MAAM,QAAQ,EAAE;CAEhB,MAAM,oBAAoB,wBACxB,eAAe,OAAO,IAAI,UACpB,MAAM,aAAa,IAAI,MAC7B,EAAE,EACF,KACD;AAED,KAAI,OACF,mBAAkB,aAAa,OAAO;AAGxC,OAAM,MAAM;AACZ,OAAM,oBAAoB;AAC1B,OAAM,gBAAgB;AACtB,OAAM,QAAQ;AACd,OAAM,MAAM;AACZ,OAAM,iBAAiB;AACvB,OAAM,mBAAmB,sBAAsB;AAC/C,OAAM,YAAY;AAClB,OAAM,WAAW;AACjB,OAAM,UAAU;AAChB,OAAM,YAAY;AAClB,OAAM,kBAAkB;AACtB,QAAM,iBAAiB;;AAEzB,OAAM,UAAU,aAA0B;AACxC,QAAM,YAAY;AAClB,SAAO,YAAY,MAAM;;AAE3B,OAAM,gBAAgB;AACpB,MAAI,MAAM,UACR;AAEF,QAAM,YAAY;AAClB,MAAI,MAAM,QACR,2BAA0B,MAAM,SAAS,MAAM;AAEjD,mBAAiB,kBAAkB;AACnC,QAAM,YAAY;AAClB,QAAM,gBAAgB;AACtB,QAAM,QAAQ;AACd,QAAM,MAAM;AACZ,QAAM,iBAAiB;AACvB,oBAAkB,mBAAmB;;AAGvC,mBAAkB,0BAA0B;AAC1C,oBAAkB,mBAAmB;AACrC,cAAY,MAAM;AAClB,QAAM,YAAY;;AAGpB,KAAI,OACF,yBAAwB,QAAQ,MAAM;AAGxC,QAAO"}

package/dist/runtime/component.d.ts

@@ -1,61 +1,68 @@
-/**
- * Component instance lifecycle management
- * Internal only — users never see this
- */
-import { type State } from './state';
-import type { Props } from '../common/props';
-import type { ComponentFunction } from '../common/component';
-import { type ContextFrame } from './context';
-import { type ReadableSource } from './readable';
-export type { ComponentFunction } from '../common/component';
-export interface ComponentInstance {
-    id: string;
-    fn: ComponentFunction;
-    props: Props;
-    target: Element | null;
-    mounted: boolean;
-    abortController: AbortController;
-    ssr?: boolean;
-    cleanupStrict?: boolean;
-    stateValues: State<unknown>[];
-    evaluationGeneration: number;
-    notifyUpdate: (() => void) | null;
-    _pendingFlushTask?: () => void;
-    _pendingRunTask?: () => void;
-    _enqueueRun?: () => void;
-    stateIndexCheck: number;
-    expectedStateIndices: number[];
-    firstRenderComplete: boolean;
-    mountOperations: Array<() => void | (() => void) | Promise<void | (() => void)>>;
-    cleanupFns: Array<() => void>;
-    hasPendingUpdate: boolean;
-    ownerFrame: ContextFrame | null;
-    isRoot?: boolean;
-    _currentRenderToken?: number;
-    lastRenderToken?: number;
-    _pendingReadSources?: Set<ReadableSource<unknown>>;
-    _lastReadSources?: Set<ReadableSource<unknown>>;
-    devWarningsEmitted: Set<string>;
-    _placeholder?: Comment;
+import { Props } from "../common/props.js";
+import { ReadableSource } from "./readable.js";
+import { State } from "./state.js";
+import { ContextFrame } from "./context.js";
+import { ComponentFunction } from "../common/component.js";
+
+//#region src/runtime/component.d.ts
+interface ComponentInstance {
+  id: string;
+  fn: ComponentFunction;
+  props: Props;
+  target: Element | null;
+  mounted: boolean;
+  abortController: AbortController | null;
+  ssr?: boolean;
+  cleanupStrict?: boolean;
+  stateValues: State<unknown>[];
+  evaluationGeneration: number;
+  notifyUpdate: (() => void) | null;
+  _pendingFlushTask?: () => void;
+  _pendingRunTask?: () => void;
+  _enqueueRun?: () => void;
+  stateIndexCheck: number;
+  expectedStateIndices: number[];
+  firstRenderComplete: boolean;
+  mountOperations: Array<() => void | (() => void) | Promise<void | (() => void)>>;
+  cleanupFns: Array<() => void>;
+  hasPendingUpdate: boolean;
+  ownerFrame: ContextFrame | null;
+  isRoot?: boolean;
+  _currentRenderToken?: number;
+  lastRenderToken?: number;
+  _pendingReadSources?: Set<ReadableSource<unknown>>;
+  _lastReadSources?: Set<ReadableSource<unknown>>;
+  devWarningsEmitted?: Set<string>;
+  _placeholder?: Comment;
+  _ownedChildScopes?: Set<{
+    key: string | number;
+    dispose(): void;
+  }>;
 }
-export declare function createComponentInstance(id: string, fn: ComponentFunction, props: Props, target: Element | null): ComponentInstance;
-export declare function getCurrentComponentInstance(): ComponentInstance | null;
-export declare function setCurrentComponentInstance(instance: ComponentInstance | null): void;
-export declare function registerMountOperation(operation: () => void | (() => void) | Promise<void | (() => void)>): void;
-export declare function mountInstanceInline(instance: ComponentInstance, target: Element | null): void;
+declare function createComponentInstance(id: string, fn: ComponentFunction, props: Props, target: Element | null): ComponentInstance;
+type OwnedChildScope = {
+  key: string | number;
+  dispose(): void;
+};
+declare function getCurrentComponentInstance(): ComponentInstance | null;
+declare function setCurrentComponentInstance(instance: ComponentInstance | null): void;
+declare function registerMountOperation(operation: () => void | (() => void) | Promise<void | (() => void)>): void;
+declare function mountInstanceInline(instance: ComponentInstance, target: Element | null): void;
+declare function renderScopedComponent<T>(instance: ComponentInstance, startStateIndex: number, render: () => T): T;
 /**
  * Execute a component's render function synchronously.
  * Returns either a vnode/promise immediately (does NOT render).
  * Rendering happens separately through runComponent.
  */
-export declare function renderComponentInline(instance: ComponentInstance): unknown | Promise<unknown>;
+declare function renderComponentInline(instance: ComponentInstance): unknown | Promise<unknown>;
+declare function warnUnusedStateReads(instance: ComponentInstance): void;
 /**
  * Public entry point: Execute component with full lifecycle (execute + render)
  * Handles both initial mount and re-execution. Always enqueues through scheduler.
  * Single entry point to avoid lifecycle divergence.
  */
-export declare function executeComponent(instance: ComponentInstance): void;
-export declare function getCurrentInstance(): ComponentInstance | null;
+declare function executeComponent(instance: ComponentInstance): void;
+declare function getCurrentInstance(): ComponentInstance | null;
 /**
  * Get the abort signal for the current component
  * Used to cancel async operations on unmount/navigation
@@ -97,7 +104,7 @@ export declare function getCurrentInstance(): ComponentInstance | null;
  * const signal = getSignal(); // Error: not in component
  * ```
  */
-export declare function getSignal(): AbortSignal;
+declare function getSignal(): AbortSignal;
 /**
  * Finalize read subscriptions for an instance after a successful commit.
  * - Update per-state readers map to point to this instance's last committed token
@@ -106,21 +113,25 @@ export declare function getSignal(): AbortSignal;
  * subscribers are only notified when they actually read a state in their
  * last committed render.
  */
-export declare function finalizeReadSubscriptions(instance: ComponentInstance): void;
-export declare function getNextStateIndex(): number;
-export declare function claimHookIndex(instance: ComponentInstance, hookName: string): number;
-export declare function getCurrentStateIndex(): number;
-export declare function resetStateIndex(): void;
-export declare function setStateIndex(value: number): void;
+declare function finalizeReadSubscriptions(instance: ComponentInstance): void;
+declare function getNextStateIndex(): number;
+declare function claimHookIndex(instance: ComponentInstance, hookName: string): number;
+declare function getCurrentStateIndex(): number;
+declare function resetStateIndex(): void;
+declare function setStateIndex(value: number): void;
 /**
  * Mount a component instance.
  * This is just an alias to executeComponent() to maintain API compatibility.
  * All lifecycle logic is unified in executeComponent().
  */
-export declare function mountComponent(instance: ComponentInstance): void;
+declare function mountComponent(instance: ComponentInstance): void;
 /**
  * Clean up component — abort pending operations
  * Called on unmount or route change
  */
-export declare function cleanupComponent(instance: ComponentInstance): void;
+declare function cleanupComponent(instance: ComponentInstance): void;
+declare function registerOwnedChildScope(instance: ComponentInstance, scope: OwnedChildScope): void;
+declare function unregisterOwnedChildScope(instance: ComponentInstance, scope: OwnedChildScope): void;
+//#endregion
+export { ComponentInstance, getSignal };
 //# sourceMappingURL=component.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/runtime/component.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"component.d.ts","names":[],"sources":["../../src/runtime/component.ts"],"mappings":";;;;;;;UA4BiB,iBAAA;EACf,EAAA;EACA,EAAA,EAAI,iBAAA;EACJ,KAAA,EAAO,KAAA;EACP,MAAA,EAAQ,OAAA;EACR,OAAA;EACA,eAAA,EAAiB,eAAA;EACjB,GAAA;EAEA,aAAA;EACA,WAAA,EAAa,KAAA;EACb,oBAAA;EACA,YAAA;EAEA,iBAAA;EACA,eAAA;EACA,WAAA;EACA,eAAA;EACA,oBAAA;EACA,mBAAA;EACA,eAAA,EAAiB,KAAA,6BACa,OAAA;EAE9B,UAAA,EAAY,KAAA;EACZ,gBAAA;EACA,UAAA,EAAY,YAAA;EACZ,MAAA;EAGA,mBAAA;EACA,eAAA;EACA,mBAAA,GAAsB,GAAA,CAAI,cAAA;EAC1B,gBAAA,GAAmB,GAAA,CAAI,cAAA;EACvB,kBAAA,GAAqB,GAAA;EAIrB,YAAA,GAAe,OAAA;EACf,iBAAA,GAAoB,GAAA;IAClB,GAAA;IACA,OAAA;EAAA;AAAA;AAAA,iBAIY,uBAAA,CACd,EAAA,UACA,EAAA,EAAI,iBAAA,EACJ,KAAA,EAAO,KAAA,EACP,MAAA,EAAQ,OAAA,UACP,iBAAA;AAAA,KA4DE,eAAA;EACH,GAAA;EACA,OAAA;AAAA;AAAA,iBAac,2BAAA,CAAA,GAA+B,iBAAA;AAAA,iBAK/B,2BAAA,CACd,QAAA,EAAU,iBAAA;AAAA,iBAYI,sBAAA,CACd,SAAA,8BAAuC,OAAA;AAAA,iBAkDzB,mBAAA,CACd,QAAA,EAAU,iBAAA,EACV,MAAA,EAAQ,OAAA;AAAA,iBA0DM,qBAAA,GAAA,CACd,QAAA,EAAU,iBAAA,EACV,eAAA,UACA,MAAA,QAAc,CAAA,GACb,CAAA;;;;;;iBAsPa,qBAAA,CACd,QAAA,EAAU,iBAAA,aACC,OAAA;AAAA,iBA8BG,oBAAA,CAAqB,QAAA,EAAU,iBAAA;;;;;;iBAyF/B,gBAAA,CAAiB,QAAA,EAAU,iBAAA;AAAA,iBAW3B,kBAAA,CAAA,GAAsB,iBAAA;;;;;;;;;;AA/kBtC;;;;;;;;;;;;;;;;;;;AA4DC;;;;;AAoBD;;;;;AAKA;;;iBAuiBgB,SAAA,CAAA,GAAa,WAAA;;AA1hB7B;;;;;AAmDA;;iBAyfgB,yBAAA,CAA0B,QAAA,EAAU,iBAAA;AAAA,iBAIpC,iBAAA,CAAA;AAAA,iBAIA,cAAA,CACd,QAAA,EAAU,iBAAA,EACV,QAAA;AAAA,iBAgCc,oBAAA,CAAA;AAAA,iBAIA,eAAA,CAAA;AAAA,iBAIA,aAAA,CAAc,KAAA;;;AA/e9B;;;iBAwfgB,cAAA,CAAe,QAAA,EAAU,iBAAA;;;;;iBAQzB,gBAAA,CAAiB,QAAA,EAAU,iBAAA;AAAA,iBAuD3B,uBAAA,CACd,QAAA,EAAU,iBAAA,EACV,KAAA,EAAO,eAAA;AAAA,iBAMO,yBAAA,CACd,QAAA,EAAU,iBAAA,EACV,KAAA,EAAO,eAAA"}