@askrjs/askr 0.0.27 → 0.0.29

package/dist/bin/askr-ssg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"askr-ssg.js","names":[],"sources":["../../src/bin/askr-ssg.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * askr-ssg CLI\n *\n * Usage: askr-ssg --config path/to/config.ts --output dist/static\n */\n\nimport * as pathModule from 'path';\nimport * as fsModule from 'fs';\nimport { createStaticGen } from '../ssg/index';\nimport type { RouteConfig } from '../ssg/types';\nimport type { SSGGenerateOptions, SSGResult } from '../ssg/types';\n\nconst { resolve } = pathModule;\nconst { existsSync } = fsModule;\n\nfunction toFileUrl(filePath: string): string {\n  const normalized = resolve(filePath).replace(/\\\\/g, '/');\n  const leadingSlash = normalized.startsWith('/') ? '' : '/';\n  return `file://${leadingSlash}${encodeURI(normalized)}`;\n}\n\nexport interface ParsedCliArgs {\n  configPath: string;\n  outputDir: string;\n  workers: number | 'auto';\n  incremental: boolean;\n  changedKeys: string[];\n  changedRoutes: string[];\n  forceFull: boolean;\n  help: boolean;\n}\n\ninterface CliIo {\n  log: (...args: unknown[]) => void;\n  error: (...args: unknown[]) => void;\n}\n\ninterface CliDeps {\n  cwd: () => string;\n  now: () => number;\n  existsSync: (path: string) => boolean;\n  importConfig: (path: string) => Promise<Record<string, unknown>>;\n  createStaticGen: typeof createStaticGen;\n}\n\ninterface CliConfig {\n  routes: RouteConfig[];\n  seed?: number;\n  dataOverrides?: Record<string, unknown>;\n  concurrency?: number;\n}\n\nconst defaultCliDeps: CliDeps = {\n  cwd: () => process.cwd(),\n  now: () => performance.now(),\n  existsSync,\n  importConfig: async (path: string) =>\n    (await import(toFileUrl(path))) as Record<string, unknown>,\n  createStaticGen,\n};\n\nconst helpText = `\naskr-ssg - Static Site Generation for Askr\n\nUsage:\n  askr-ssg --config <path> --output <dir> [--incremental]\n\nOptions:\n  --config <path>         Path to SSG config file (TypeScript module)\n  --output <dir>          Output directory for generated HTML\n  --workers <n|auto>      Preferred render worker count for SSG throughput\n  --incremental           Use incremental generation if a manifest exists\n  --changed-key <key>     Mark an invalidation key as changed (repeatable)\n  --changed-route <path>  Mark a concrete route path as changed (repeatable)\n  --force-full            Force a full rebuild even with incremental flags\n  --help                  Show this help message\n\nExample:\n  askr-ssg --config ./ssg.config.ts --output ./dist/static --incremental --changed-key blog/post-123\n\nTypeScript config execution:\n  Use tsx to run the CLI with TS config loading:\n  tsx node_modules/@askrjs/askr/dist/bin/askr-ssg.js --config ./ssg.config.ts --output ./dist/static\n`;\n\nexport function parseCliArgs(args: string[]): ParsedCliArgs {\n  const parsed: ParsedCliArgs = {\n    configPath: '',\n    outputDir: '',\n    workers: 1,\n    incremental: false,\n    changedKeys: [],\n    changedRoutes: [],\n    forceFull: false,\n    help: false,\n  };\n\n  for (let i = 0; i < args.length; i++) {\n    if (args[i] === '--config' && i + 1 < args.length) {\n      parsed.configPath = args[i + 1];\n      i++;\n    } else if (args[i] === '--output' && i + 1 < args.length) {\n      parsed.outputDir = args[i + 1];\n      i++;\n    } else if (args[i] === '--workers' && i + 1 < args.length) {\n      parsed.workers = args[i + 1] === 'auto' ? 'auto' : Number(args[i + 1]);\n      i++;\n    } else if (args[i] === '--changed-key' && i + 1 < args.length) {\n      parsed.changedKeys.push(args[i + 1]);\n      i++;\n    } else if (args[i] === '--changed-route' && i + 1 < args.length) {\n      parsed.changedRoutes.push(args[i + 1]);\n      i++;\n    } else if (args[i] === '--incremental') {\n      parsed.incremental = true;\n    } else if (args[i] === '--force-full') {\n      parsed.forceFull = true;\n    } else if (args[i] === '--help' || args[i] === '-h') {\n      parsed.help = true;\n    }\n  }\n\n  return parsed;\n}\n\nfunction toGenerateOptions(args: ParsedCliArgs): SSGGenerateOptions {\n  return {\n    mode: args.incremental ? 'incremental' : 'full',\n    changedKeys: args.changedKeys,\n    changedRoutes: args.changedRoutes,\n    forceFull: args.forceFull,\n  };\n}\n\nfunction printSummary(\n  io: CliIo,\n  outputDir: string,\n  durationSeconds: string,\n  result: SSGResult\n) {\n  io.log('');\n  io.log(`Generation complete in ${durationSeconds}s`);\n  io.log(`   Mode:      ${result.mode}`);\n  io.log(`   Generated: ${result.successful}/${result.totalRoutes} routes`);\n  io.log(`   Failed:    ${result.failed} routes`);\n  io.log(`   Rebuilt:   ${result.rebuilt} routes`);\n  io.log(`   Skipped:   ${result.skipped} routes`);\n  io.log(`   Removed:   ${result.removed} routes`);\n  io.log(`   CacheHit:  ${result.cacheHits} routes`);\n  io.log(`   Output:    ${outputDir}`);\n  io.log(`   Metadata:  ${outputDir}/metadata.json`);\n  io.log('');\n}\n\nexport async function runCli(\n  args: string[],\n  deps: Partial<CliDeps> = {},\n  io: CliIo = console\n): Promise<number> {\n  const parsed = parseCliArgs(args);\n  if (parsed.help) {\n    io.log(helpText);\n    return 0;\n  }\n\n  if (!parsed.configPath) {\n    io.error('Error: --config argument is required');\n    return 1;\n  }\n\n  if (!parsed.configPath.endsWith('.ts')) {\n    io.error('Error: --config must point to a TypeScript file (.ts)');\n    return 1;\n  }\n\n  if (!parsed.outputDir) {\n    io.error('Error: --output argument is required');\n    return 1;\n  }\n\n  const resolvedDeps = { ...defaultCliDeps, ...deps };\n  const resolvedConfigPath = resolve(resolvedDeps.cwd(), parsed.configPath);\n  const resolvedOutputDir = resolve(resolvedDeps.cwd(), parsed.outputDir);\n\n  if (!resolvedDeps.existsSync(resolvedConfigPath)) {\n    io.error(`Error: Config file not found: ${resolvedConfigPath}`);\n    return 1;\n  }\n\n  try {\n    io.log(`Loading config: ${resolvedConfigPath}`);\n\n    const configModule = await resolvedDeps.importConfig(resolvedConfigPath);\n    const config = (configModule.default || configModule) as Partial<CliConfig>;\n\n    if (!Array.isArray(config.routes)) {\n      io.error('Error: Config must export routes array');\n      return 1;\n    }\n\n    io.log(`Generating ${config.routes.length} routes...`);\n\n    const ssg = resolvedDeps.createStaticGen({\n      routes: config.routes,\n      outputDir: resolvedOutputDir,\n      seed: config.seed,\n      dataOverrides: config.dataOverrides,\n      concurrency: config.concurrency,\n      parallelism: parsed.workers,\n    });\n\n    const startTime = resolvedDeps.now();\n    const result = await ssg.generate(toGenerateOptions(parsed));\n    const duration = ((resolvedDeps.now() - startTime) / 1000).toFixed(2);\n\n    printSummary(io, resolvedOutputDir, duration, result);\n\n    if (result.failed > 0) {\n      io.log('Errors encountered:');\n      for (const route of result.routes) {\n        if (route.status === 'error') {\n          io.log(`   ${route.path}: ${route.error}`);\n        }\n      }\n      io.log('');\n      return 1;\n    }\n\n    return 0;\n  } catch (error) {\n    io.error('Generation failed:');\n    io.error(error instanceof Error ? error.message : String(error));\n    if (error instanceof Error && error.stack) {\n      io.error(error.stack);\n    }\n    return 1;\n  }\n}\n\nasync function main() {\n  const exitCode = await runCli(process.argv.slice(2));\n  process.exit(exitCode);\n}\n\nif (process.argv[1] && import.meta.url === toFileUrl(process.argv[1])) {\n  void main();\n}\n"],"mappings":"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"}

package/dist/boot/index.d.ts

@@ -1,70 +1,92 @@
-/**
- * App bootstrap and mount
- */
-import { type ComponentFunction } from '../runtime/component';
-export interface AppConfig {
-    root: Element | string;
-    component: ComponentFunction;
-    cleanupStrict?: boolean;
-}
+import { ComponentFunction } from "../common/component.js";
+import { Route, RouteAuthOptions, RouteManifest } from "../common/router.js";
+import { ScrollRestorationOptions } from "../router/navigate.js";
+
+//#region src/boot/index.d.ts
 /**
  * Explicitly teardown an app mounted on `root` if present. This is the
  * recommended API for deterministic cleanup rather than relying on overriding
  * `innerHTML` setter behavior.
  */
-export declare function teardownApp(_root: Element | string): void;
-import type { Route } from '../common/router';
-export type IslandConfig = {
-    root: Element | string;
-    component: ComponentFunction;
-    cleanupStrict?: boolean;
-    routes?: never;
+declare function teardownApp(_root: Element | string): void;
+type IslandConfig = {
+  root: Element | string;
+  component: ComponentFunction;
+  cleanupStrict?: boolean;
+  routes?: never;
 };
-export type IslandsConfig = {
-    islands: IslandConfig[];
+type IslandsConfig = {
+  islands: IslandConfig[];
 };
-export type SPAConfig = {
-    root: Element | string;
-    routes: Route[];
-    cleanupStrict?: boolean;
-    component?: never;
+type SPAConfig = {
+  root: Element | string;
+  /**
+   * Preferred: pass the route manifest built via `registerRoutes(() => { ... })`.
+   * ```ts
+   * import { getManifest } from '@askrjs/askr/router';
+   * await createSPA({ root: '#app', manifest: getManifest() });
+   * ```
+   */
+  manifest?: RouteManifest; /** Legacy: flat route array — kept for backward compatibility and test fixtures. */
+  routes?: Route[];
+  auth?: RouteAuthOptions;
+  scrollRestoration?: boolean | ScrollRestorationOptions;
+  cleanupStrict?: boolean;
+  component?: never;
 };
-export type HydrateSPAConfig = {
-    root: Element | string;
-    routes: Route[];
-    cleanupStrict?: boolean;
-    hydrate?: {
-        deferUntilIdle?: boolean;
-        deferBelowFold?: boolean;
-        foldThreshold?: number;
-        skipSelectors?: string[];
-    };
+type HydrateSPAConfig = {
+  root: Element | string; /** Preferred manifest input — see `SPAConfig.manifest`. */
+  manifest?: RouteManifest; /** Legacy flat route array. */
+  routes?: Route[];
+  auth?: RouteAuthOptions;
+  scrollRestoration?: boolean | ScrollRestorationOptions;
+  cleanupStrict?: boolean;
+  hydrate?: {
+    verifyMarkup?: boolean;
+    deferUntilIdle?: boolean;
+    deferBelowFold?: boolean;
+    foldThreshold?: number;
+    skipSelectors?: string[];
+  };
 };
 /**
  * createIsland: Enhances existing DOM (no router, mounts once)
  */
-export declare function createIsland(config: IslandConfig): void;
+declare function createIsland(config: IslandConfig): void;
 /**
  * createIslands: Enhances one or more existing DOM roots (no router).
  * The only public islands constructor.
  */
-export declare function createIslands(config: IslandsConfig): void;
+declare function createIslands(config: IslandsConfig): void;
 /**
- * createSPA: Initializes router and mounts the app with provided route table
+ * createSPA: Initializes router and mounts the app with the provided route manifest or route table.
+ *
+ * Preferred usage with manifest:
+ * ```ts
+ * import { getManifest } from '@askrjs/askr/router';
+ * await createSPA({ root: '#app', manifest: getManifest() });
+ * ```
+ *
+ * Legacy usage with plain routes array (still supported):
+ * ```ts
+ * await createSPA({ root: '#app', routes: getRoutes() });
+ * ```
  */
-export declare function createSPA(config: SPAConfig): Promise<void>;
+declare function createSPA(config: SPAConfig): Promise<void>;
 /**
- * hydrateSPA: Hydrate server-rendered HTML with explicit routes
+ * hydrateSPA: Hydrate server-rendered HTML.
+ * Accepts either a `manifest` (preferred) or a legacy `routes` array.
  */
-export declare function hydrateSPA(config: HydrateSPAConfig): Promise<void>;
-export declare function hydrate(_config: AppConfig): Promise<void>;
+declare function hydrateSPA(config: HydrateSPAConfig): Promise<void>;
 /**
  * Cleanup an app mounted on a root element (element or id).
  * Safe to call multiple times — no-op when nothing is mounted.
  */
-export declare function cleanupApp(root: Element | string): void;
+declare function cleanupApp(root: Element | string): void;
 /**
  * Check whether an app is mounted on the given root
  */
-export declare function hasApp(root: Element | string): boolean;
+declare function hasApp(root: Element | string): boolean;
+//#endregion
+export { HydrateSPAConfig, IslandConfig, IslandsConfig, SPAConfig, cleanupApp, createIsland, createIslands, createSPA, hasApp, hydrateSPA, teardownApp };
 //# sourceMappingURL=index.d.ts.map

package/dist/boot/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boot/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAIL,KAAK,iBAAiB,EAEvB,MAAM,sBAAsB,CAAC;AAuB9B,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,SAAS,EAAE,iBAAiB,CAAC;IAE7B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAmHD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,QAIlD;AAkFD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,SAAS,EAAE,iBAAiB,CAAC;IAE7B,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,KAAK,EAAE,CAAC;IAEhB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,KAAK,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IACvB,MAAM,EAAE,KAAK,EAAE,CAAC;IAEhB,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB,OAAO,CAAC,EAAE;QACR,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,cAAc,CAAC,EAAE,OAAO,CAAC;QACzB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAuCvD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAWzD;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAwEhE;AAoED;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsGxE;AAED,wBAAsB,OAAO,CAAC,OAAO,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAYvD;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,OAAO,CAMtD"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/boot/index.ts"],"mappings":";;;;;;AAmKA;;;;iBAAgB,WAAA,CAAY,KAAA,EAAO,OAAA;AAAA,KA4GvB,YAAA;EACV,IAAA,EAAM,OAAA;EACN,SAAA,EAAW,iBAAA;EAEX,aAAA;EAEA,MAAA;AAAA;AAAA,KAGU,aAAA;EACV,OAAA,EAAS,YAAA;AAAA;AAAA,KAGC,SAAA;EACV,IAAA,EAAM,OAAA;EALI;;;;;AAIZ;;EASE,QAAA,GAAW,aAAA,EARL;EAUN,MAAA,GAAS,KAAA;EACT,IAAA,GAAO,gBAAA;EACP,iBAAA,aAA8B,wBAAA;EAC9B,aAAA;EACA,SAAA;AAAA;AAAA,KAGU,gBAAA;EACV,IAAA,EAAM,OAAA,WAVN;EAYA,QAAA,GAAW,aAAA,EAVX;EAYA,MAAA,GAAS,KAAA;EACT,IAAA,GAAO,gBAAA;EACP,iBAAA,aAA8B,wBAAA;EAC9B,aAAA;EACA,OAAA;IACE,YAAA;IACA,cAAA;IACA,cAAA;IACA,aAAA;IACA,aAAA;EAAA;AAAA;;;;iBAOY,YAAA,CAAa,MAAA,EAAQ,YAAA;;;;;iBA6CrB,aAAA,CAAc,MAAA,EAAQ,aAAA;;;;;;;;;;;;;;;iBA2BhB,SAAA,CAAU,MAAA,EAAQ,SAAA,GAAY,OAAA;;;AAxEpD;;iBAiXsB,UAAA,CAAW,MAAA,EAAQ,gBAAA,GAAmB,OAAA;;;AApU5D;;iBAmbgB,UAAA,CAAW,IAAA,EAAM,OAAA;;;AAxZjC;iBAyagB,MAAA,CAAO,IAAA,EAAM,OAAA"}

package/dist/boot/index.js

@@ -1,2 +1,416 @@
-const __vite__mapDeps=(i,m=__vite__mapDeps,d=(m.f||(m.f=["router/route.js","router/match.js","runtime/component.js","runtime/scheduler.js","dev/invariant.js","dev/logger.js","runtime/context.js","common/jsx.js","runtime/dev-namespace.js","runtime/fastlane.js","renderer/keyed.js","renderer/utils.js","renderer/index.js","renderer/types.js","common/vnode.js","renderer/cleanup.js","runtime/events.js","renderer/dom.js","jsx-runtime.js","jsx/types.js","runtime/for.js","renderer/reconcile.js","renderer/fastpath.js","renderer/evaluate.js","runtime/execution-model.js","router/navigate.js","ssr/index.js","jsx/index.js","jsx/utils.js","foundations/structures/portal.js","ssr/context.js","ssr/errors.js","common/ssr-errors.js","runtime/ssr-bridge.js","ssr/render-keys.js","ssr/escape.js","ssr/attrs.js","ssr/sink.js","ssr/stream-render.js"])))=>i.map(i=>d[i]);
-import{__vitePreload as w}from"../_virtual/preload-helper.js";import{cleanupComponent as S,createComponentInstance as k,mountComponent as C}from"../runtime/component.js";import{globalScheduler as H}from"../runtime/scheduler.js";import{assertExecutionModel as _}from"../runtime/execution-model.js";import"../jsx/index.js";import{DefaultPortal as M}from"../foundations/structures/portal.js";import"../renderer/index.js";import{removeAllListeners as v}from"../renderer/cleanup.js";import{ELEMENT_TYPE as T,Fragment as N}from"../common/jsx.js";const j=Symbol.for("__ASKR_HAS_ROUTES__");let q=0;const h=new WeakMap,I=Symbol.for("__tempoCleanup__");function B(e,t){e[I]=()=>{const r=[];try{v(e)}catch(a){r.push(a)}try{const a=e.querySelectorAll("*");for(const o of Array.from(a))try{const n=o.__ASKR_INSTANCE;if(n){try{S(n)}catch(i){r.push(i)}try{delete o.__ASKR_INSTANCE}catch(i){r.push(i)}}}catch(n){r.push(n)}}catch(a){r.push(a)}try{S(t)}catch(a){r.push(a)}if(r.length>0&&t.cleanupStrict)throw new AggregateError(r,"cleanup failed for app root")};try{const r=Object.getOwnPropertyDescriptor(e,"innerHTML")||Object.getOwnPropertyDescriptor(Object.getPrototypeOf(e),"innerHTML")||Object.getOwnPropertyDescriptor(Element.prototype,"innerHTML");r&&(r.get||r.set)&&Object.defineProperty(e,"innerHTML",{get:r.get?function(){return r.get.call(this)}:void 0,set:function(a){if(a===""&&h.get(this)===t){try{v(e)}catch(o){if(t.cleanupStrict)throw o}try{S(t)}catch(o){if(t.cleanupStrict)throw o}}if(r.set)return r.set.call(this,a)},configurable:!0})}catch{}}function Q(e){throw new Error("The `teardownApp` alias has been removed. Use `cleanupApp(root)` instead.")}function y(e,t,r){const a=(i,c)=>{const s=t(i,c),l={$$typeof:T,type:M,props:{},key:"__default_portal"};return{$$typeof:T,type:N,props:{children:s==null?[l]:[s,l]}}};Object.defineProperty(a,"name",{value:t.name||"Component"});const o=e[I];o&&o();let n=h.get(e);if(n){v(e);try{S(n)}catch{}n.fn=a,n.evaluationGeneration++,n.mounted=!1,n.expectedStateIndices=[],n.firstRenderComplete=!1,n.isRoot=!0,r&&typeof r.cleanupStrict=="boolean"&&(n.cleanupStrict=r.cleanupStrict)}else{const i=String(++q);n=k(i,a,{},e),h.set(e,n),n.isRoot=!0,r&&typeof r.cleanupStrict=="boolean"&&(n.cleanupStrict=r.cleanupStrict)}B(e,n),C(n),H.flush()}function D(e){if(_("islands"),!e||typeof e!="object")throw new Error("createIsland requires a config object");if(typeof e.component!="function")throw new Error("createIsland: component must be a function");const t=typeof e.root=="string"?document.getElementById(e.root):e.root;if(!t)throw new Error(`Root element not found: ${e.root}`);if("routes"in e)throw new Error("createIsland does not accept routes; use createSPA for routed apps");try{if(globalThis[j])throw new Error("Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.")}catch{}y(t,e.component,{cleanupStrict:e.cleanupStrict})}function X(e){if(_("islands"),!e||typeof e!="object")throw new Error("createIslands requires a config object");if(!Array.isArray(e.islands)||e.islands.length===0)throw new Error("createIslands requires a non-empty islands array");for(const t of e.islands)D(t)}async function Z(e){if(_("spa"),!e||typeof e!="object")throw new Error("createSPA requires a config object");if(!Array.isArray(e.routes)||e.routes.length===0)throw new Error("createSPA requires a route table. If you are enhancing existing HTML, use createIsland instead.");const t=typeof e.root=="string"?document.getElementById(e.root):e.root;if(!t)throw new Error(`Root element not found: ${e.root}`);const{clearRoutes:r,route:a,lockRouteRegistration:o,resolveRoute:n}=await w(async()=>{const{clearRoutes:u,route:f,lockRouteRegistration:g,resolveRoute:p}=await import("../router/route.js");return{clearRoutes:u,route:f,lockRouteRegistration:g,resolveRoute:p}},__vite__mapDeps([0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24]));r();for(const u of e.routes)a(u.path,u.handler,u.namespace);o();const i=typeof window<"u"?window.location.pathname:"/",c=n(i);if(!c){y(t,()=>({type:"div",children:[]}),{cleanupStrict:!1});const{registerAppInstance:u,initializeNavigation:f}=await w(async()=>{const{registerAppInstance:p,initializeNavigation:A}=await import("../router/navigate.js");return{registerAppInstance:p,initializeNavigation:A}},__vite__mapDeps([25,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24])),g=h.get(t);if(!g)throw new Error("Internal error: app instance missing");u(g,i),f();return}y(t,c.handler,{cleanupStrict:!1});const{registerAppInstance:s,initializeNavigation:l}=await w(async()=>{const{registerAppInstance:u,initializeNavigation:f}=await import("../router/navigate.js");return{registerAppInstance:u,initializeNavigation:f}},__vite__mapDeps([25,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24])),m=h.get(t);if(!m)throw new Error("Internal error: app instance missing");s(m,i),l()}function x(e,t){for(const r of t)e.querySelectorAll(r).forEach(o=>o.setAttribute("data-skip-hydrate","true"))}async function z(e,t,r){const{renderToStringSync:a}=await w(async()=>{const{renderToStringSync:o}=await import("../ssr/index.js");return{renderToStringSync:o}},__vite__mapDeps([26,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,27,28,29,30,31,32,33,34,35,36,37,38]));if(r.deferUntilIdle&&(typeof requestIdleCallback<"u"?await new Promise(o=>{requestIdleCallback(()=>o(void 0),{timeout:2e3})}):await new Promise(o=>setTimeout(o,0))),r.deferBelowFold){const o=r.foldThreshold??window.innerHeight,n=Array.from(e.querySelectorAll("*")).filter(c=>c.getBoundingClientRect().top>=o);for(const c of n)c.setAttribute("data-skip-hydrate","true");const i=()=>{const c=n.filter(s=>s.getBoundingClientRect().top<o);for(const s of c)s.removeAttribute("data-skip-hydrate");c.length===n.length&&window.removeEventListener("scroll",i)};window.addEventListener("scroll",i,{passive:!0})}y(e,t.handler,{cleanupStrict:!1})}async function ee(e){if(_("spa"),!e||typeof e!="object")throw new Error("hydrateSPA requires a config object");if(!Array.isArray(e.routes)||e.routes.length===0)throw new Error("hydrateSPA requires a route table. If you are enhancing existing HTML, use createIsland instead.");const t=typeof e.root=="string"?document.getElementById(e.root):e.root;if(!t)throw new Error(`Root element not found: ${e.root}`);const r=t.innerHTML,{clearRoutes:a,route:o,setServerLocation:n,lockRouteRegistration:i,resolveRoute:c}=await w(async()=>{const{clearRoutes:d,route:E,setServerLocation:b,lockRouteRegistration:P,resolveRoute:O}=await import("../router/route.js");return{clearRoutes:d,route:E,setServerLocation:b,lockRouteRegistration:P,resolveRoute:O}},__vite__mapDeps([0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24]));a();for(const d of e.routes)o(d.path,d.handler,d.namespace);const s=typeof window<"u"?window.location.pathname:"/";n(s),i();const l=c(s);if(!l)throw new Error(`hydrateSPA: no route found for current path (${s}).`);const{renderToStringSync:m}=await w(async()=>{const{renderToStringSync:d}=await import("../ssr/index.js");return{renderToStringSync:d}},__vite__mapDeps([26,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,27,28,29,30,31,32,33,34,35,36,37,38])),u=m(()=>l.handler(l.params)??{type:"div",children:[]}),f=document.createElement("div");f.innerHTML=r;const g=document.createElement("div");if(g.innerHTML=u,!f.isEqualNode(g))throw new Error("[Askr] Hydration mismatch detected. Server HTML does not match expected server-render output.");const p=e.hydrate;if(p){if(p.deferUntilIdle||p.deferBelowFold){await z(t,{handler:l.handler,params:l.params},p);return}p.skipSelectors?.length&&x(t,p.skipSelectors)}y(t,l.handler,{cleanupStrict:!1});const{registerAppInstance:A,initializeNavigation:L}=await w(async()=>{const{registerAppInstance:d,initializeNavigation:E}=await import("../router/navigate.js");return{registerAppInstance:d,initializeNavigation:E}},__vite__mapDeps([25,0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24])),R=h.get(t);if(!R)throw new Error("Internal error: app instance missing");A(R,s),L()}async function te(e){throw new Error("The legacy `hydrate` API is removed. Use `hydrateSPA({ root, routes })` for SSR hydration with an explicit route table.")}function re(e){const t=typeof e=="string"?document.getElementById(e):e;if(!t)return;const r=t[I];typeof r=="function"&&r(),h.delete(t)}function ne(e){const t=typeof e=="string"?document.getElementById(e):e;return t?h.has(t):!1}export{re as cleanupApp,D as createIsland,X as createIslands,Z as createSPA,ne as hasApp,te as hydrate,ee as hydrateSPA,Q as teardownApp};
+import { isDevelopmentEnvironment, isProductionEnvironment } from "../common/env.js";
+import { logger } from "../dev/logger.js";
+import { globalScheduler } from "../runtime/scheduler.js";
+import { ELEMENT_TYPE, Fragment } from "../common/jsx.js";
+import { cleanupComponent, createComponentInstance, mountComponent } from "../runtime/component.js";
+import { removeAllListeners } from "../renderer/cleanup.js";
+import { installRendererBridge } from "../renderer/index.js";
+import { assertExecutionModel } from "../runtime/execution-model.js";
+import { _applyManifest, _drainLazy, _setActiveRouteAuthOptions, _snapshotLazy, clearRoutes, lockRouteRegistration, resolveRoute, resolveRouteRequest, route, setServerLocation } from "../router/route.js";
+import "../jsx/index.js";
+import { DefaultPortal } from "../foundations/structures/portal.js";
+import { configureScrollRestoration, initializeNavigation, registerAppInstance } from "../router/navigate.js";
+//#region src/boot/index.ts
+/**
+* App bootstrap and mount
+*/
+const HAS_ROUTES_KEY = Symbol.for("__ASKR_HAS_ROUTES__");
+let componentIdCounter = 0;
+const instancesByRoot = /* @__PURE__ */ new WeakMap();
+const CLEANUP_SYMBOL = Symbol.for("__tempoCleanup__");
+function attachCleanupForRoot(rootElement, instance) {
+	rootElement[CLEANUP_SYMBOL] = () => {
+		const errors = [];
+		try {
+			removeAllListeners(rootElement);
+		} catch (e) {
+			errors.push(e);
+		}
+		try {
+			const descendants = rootElement.querySelectorAll("*");
+			for (const d of Array.from(descendants)) try {
+				const inst = d.__ASKR_INSTANCE;
+				if (inst) {
+					try {
+						cleanupComponent(inst);
+					} catch (err) {
+						errors.push(err);
+					}
+					try {
+						delete d.__ASKR_INSTANCE;
+					} catch (err) {
+						errors.push(err);
+					}
+				}
+			} catch (err) {
+				errors.push(err);
+			}
+		} catch (e) {
+			errors.push(e);
+		}
+		try {
+			cleanupComponent(instance);
+		} catch (e) {
+			errors.push(e);
+		}
+		if (errors.length > 0) {
+			if (instance.cleanupStrict) throw new AggregateError(errors, `cleanup failed for app root`);
+			else if (isDevelopmentEnvironment()) for (const err of errors) logger.warn("[Askr] cleanup error:", err);
+		}
+	};
+	try {
+		const descriptor = Object.getOwnPropertyDescriptor(rootElement, "innerHTML") || Object.getOwnPropertyDescriptor(Object.getPrototypeOf(rootElement), "innerHTML") || Object.getOwnPropertyDescriptor(Element.prototype, "innerHTML");
+		if (descriptor && (descriptor.get || descriptor.set)) Object.defineProperty(rootElement, "innerHTML", {
+			get: descriptor.get ? function() {
+				return descriptor.get.call(this);
+			} : void 0,
+			set: function(value) {
+				if (value === "" && instancesByRoot.get(this) === instance) {
+					try {
+						removeAllListeners(rootElement);
+					} catch (e) {
+						if (instance.cleanupStrict) throw e;
+						if (isDevelopmentEnvironment()) logger.warn("[Askr] cleanup error:", e);
+					}
+					try {
+						cleanupComponent(instance);
+					} catch (e) {
+						if (instance.cleanupStrict) throw e;
+						if (isDevelopmentEnvironment()) logger.warn("[Askr] cleanup error:", e);
+					}
+				}
+				if (descriptor.set) return descriptor.set.call(this, value);
+			},
+			configurable: true
+		});
+	} catch {}
+}
+/**
+* Explicitly teardown an app mounted on `root` if present. This is the
+* recommended API for deterministic cleanup rather than relying on overriding
+* `innerHTML` setter behavior.
+*/
+function teardownApp(_root) {
+	throw new Error("The `teardownApp` alias has been removed. Use `cleanupApp(root)` instead.");
+}
+function mountOrUpdate(rootElement, componentFn, options) {
+	const wrappedFn = (props, ctx) => {
+		const out = componentFn(props, ctx);
+		const portalVNode = {
+			$$typeof: ELEMENT_TYPE,
+			type: DefaultPortal,
+			props: {},
+			key: "__default_portal"
+		};
+		return {
+			$$typeof: ELEMENT_TYPE,
+			type: Fragment,
+			props: { children: out === void 0 || out === null ? [portalVNode] : [out, portalVNode] }
+		};
+	};
+	Object.defineProperty(wrappedFn, "name", { value: componentFn.name || "Component" });
+	const existingCleanup = rootElement[CLEANUP_SYMBOL];
+	if (existingCleanup) existingCleanup();
+	let instance = instancesByRoot.get(rootElement);
+	if (instance) {
+		removeAllListeners(rootElement);
+		try {
+			cleanupComponent(instance);
+		} catch (e) {
+			if (isDevelopmentEnvironment()) logger.warn("[Askr] prior cleanup threw:", e);
+		}
+		instance.fn = wrappedFn;
+		instance.evaluationGeneration++;
+		instance.mounted = false;
+		instance.expectedStateIndices = [];
+		instance.firstRenderComplete = false;
+		instance.isRoot = true;
+		if (options && typeof options.cleanupStrict === "boolean") instance.cleanupStrict = options.cleanupStrict;
+	} else {
+		instance = createComponentInstance(String(++componentIdCounter), wrappedFn, {}, rootElement);
+		instancesByRoot.set(rootElement, instance);
+		instance.isRoot = true;
+		if (options && typeof options.cleanupStrict === "boolean") instance.cleanupStrict = options.cleanupStrict;
+	}
+	attachCleanupForRoot(rootElement, instance);
+	mountComponent(instance);
+	globalScheduler.flush();
+}
+function bindResolvedRouteHandler(resolved) {
+	return () => resolved.handler(resolved.params);
+}
+function bindDeniedStatus(status) {
+	return () => ({
+		type: "div",
+		props: { "data-route-denied": String(status) },
+		children: [String(status)]
+	});
+}
+installRendererBridge();
+/**
+* createIsland: Enhances existing DOM (no router, mounts once)
+*/
+function createIsland(config) {
+	assertExecutionModel("islands");
+	if (!config || typeof config !== "object") throw new Error("createIsland requires a config object");
+	if (typeof config.component !== "function") throw new Error("createIsland: component must be a function");
+	const rootElement = typeof config.root === "string" ? document.getElementById(config.root) : config.root;
+	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
+	if ("routes" in config) throw new Error("createIsland does not accept routes; use createSPA for routed apps");
+	try {
+		if (globalThis[HAS_ROUTES_KEY]) throw new Error("Routes are not supported with islands. Use createSPA (client) or createSSR (server) instead.");
+	} catch {}
+	mountOrUpdate(rootElement, config.component, { cleanupStrict: config.cleanupStrict });
+}
+/**
+* createIslands: Enhances one or more existing DOM roots (no router).
+* The only public islands constructor.
+*/
+function createIslands(config) {
+	assertExecutionModel("islands");
+	if (!config || typeof config !== "object") throw new Error("createIslands requires a config object");
+	if (!Array.isArray(config.islands) || config.islands.length === 0) throw new Error("createIslands requires a non-empty islands array");
+	for (const island of config.islands) createIsland(island);
+}
+/**
+* createSPA: Initializes router and mounts the app with the provided route manifest or route table.
+*
+* Preferred usage with manifest:
+* ```ts
+* import { getManifest } from '@askrjs/askr/router';
+* await createSPA({ root: '#app', manifest: getManifest() });
+* ```
+*
+* Legacy usage with plain routes array (still supported):
+* ```ts
+* await createSPA({ root: '#app', routes: getRoutes() });
+* ```
+*/
+async function createSPA(config) {
+	assertExecutionModel("spa");
+	if (!config || typeof config !== "object") throw new Error("createSPA requires a config object");
+	const hasManifest = config.manifest != null && config.manifest.records.length > 0;
+	const hasRoutes = Array.isArray(config.routes) && config.routes.length > 0;
+	if (!hasManifest && !hasRoutes) throw new Error("createSPA requires a route manifest or route table. Pass `manifest: getManifest()` or `routes: getRoutes()`. If you are enhancing existing HTML, use createIsland instead.");
+	const rootElement = typeof config.root === "string" ? document.getElementById(config.root) : config.root;
+	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
+	const pendingLazyAtBoot = _snapshotLazy();
+	configureScrollRestoration(config.scrollRestoration);
+	clearRoutes();
+	if (hasManifest) _applyManifest(config.manifest);
+	else for (const r of config.routes) route(r.path, r.handler);
+	const routeAuth = config.auth ?? config.manifest?.auth;
+	_setActiveRouteAuthOptions(routeAuth);
+	await _drainLazy(pendingLazyAtBoot);
+	if (isProductionEnvironment()) lockRouteRegistration();
+	let path = typeof window !== "undefined" ? window.location.pathname : "/";
+	let href = typeof window !== "undefined" ? `${window.location.pathname}${window.location.search}${window.location.hash}` : path;
+	let resolved = await resolveRouteRequest(href, { auth: routeAuth });
+	while (typeof window !== "undefined" && resolved && resolved.kind === "redirect") {
+		const redirectTarget = new URL(resolved.to, window.location.href);
+		const redirectHref = `${redirectTarget.pathname}${redirectTarget.search}${redirectTarget.hash}`;
+		window.history.replaceState({ path: redirectHref }, "", redirectHref);
+		path = redirectTarget.pathname;
+		href = redirectHref;
+		resolved = await resolveRouteRequest(href, { auth: routeAuth });
+	}
+	if (!resolved) {
+		mountOrUpdate(rootElement, () => ({
+			type: "div",
+			children: []
+		}), { cleanupStrict: config.cleanupStrict });
+		await registerAppNavigation(rootElement, path);
+		return;
+	}
+	if (resolved.kind === "redirect") {
+		mountOrUpdate(rootElement, () => ({
+			type: "div",
+			children: []
+		}), { cleanupStrict: config.cleanupStrict });
+		await registerAppNavigation(rootElement, path);
+		return;
+	}
+	mountOrUpdate(rootElement, resolved.kind === "deny" ? bindDeniedStatus(resolved.status) : bindResolvedRouteHandler({
+		handler: resolved.handler,
+		params: resolved.params
+	}), { cleanupStrict: config.cleanupStrict });
+	await registerAppNavigation(rootElement, path);
+}
+/**
+* Mark elements that should be skipped during hydration
+*/
+function markSkippedElements(root, skipSelectors) {
+	for (const selector of skipSelectors) root.querySelectorAll(selector).forEach((el) => el.setAttribute("data-skip-hydrate", "true"));
+}
+function collectDeferredBelowFoldBoundaries(root, foldY) {
+	const boundaries = [];
+	const stack = [];
+	for (let index = root.children.length - 1; index >= 0; index -= 1) stack.push(root.children[index]);
+	while (stack.length > 0) {
+		const element = stack.pop();
+		if (element.hasAttribute("data-skip-hydrate")) continue;
+		if (element.getBoundingClientRect().top >= foldY) {
+			element.setAttribute("data-skip-hydrate", "true");
+			boundaries.push(element);
+			continue;
+		}
+		for (let index = element.children.length - 1; index >= 0; index -= 1) stack.push(element.children[index]);
+	}
+	return boundaries;
+}
+function activateVisibleDeferredBoundaries(boundaries, foldY) {
+	let activated = false;
+	let remaining = 0;
+	for (const element of boundaries) {
+		if (!element.hasAttribute("data-skip-hydrate")) continue;
+		if (element.getBoundingClientRect().top < foldY) {
+			element.removeAttribute("data-skip-hydrate");
+			activated = true;
+		} else remaining += 1;
+	}
+	return {
+		activated,
+		remaining
+	};
+}
+function queueIdleWork(work) {
+	return new Promise((resolve) => {
+		if (typeof requestIdleCallback !== "undefined") {
+			requestIdleCallback(() => {
+				work();
+				resolve();
+			}, { timeout: 2e3 });
+			return;
+		}
+		setTimeout(() => {
+			work();
+			resolve();
+		}, 0);
+	});
+}
+function flushHydrationActivation(rootElement) {
+	const instance = instancesByRoot.get(rootElement);
+	if (!instance) return;
+	instance._enqueueRun?.();
+	globalScheduler.flush();
+}
+function shouldVerifyHydrationMarkup(config) {
+	const explicit = config.hydrate?.verifyMarkup;
+	if (typeof explicit === "boolean") return explicit;
+	return !isProductionEnvironment();
+}
+async function registerAppNavigation(rootElement, path) {
+	const instance = instancesByRoot.get(rootElement);
+	if (!instance) throw new Error("Internal error: app instance missing");
+	registerAppInstance(instance, path);
+	initializeNavigation();
+}
+/**
+* Apply selective hydration with deferral options
+*/
+async function applySelectiveHydration(rootElement, resolved, path, cleanupStrict, hydrateOptions) {
+	const hasPermanentSkips = (hydrateOptions.skipSelectors?.length ?? 0) > 0;
+	const hasBelowFoldDeferral = !!hydrateOptions.deferBelowFold;
+	const hasSelectiveBoundaries = hasPermanentSkips || hasBelowFoldDeferral;
+	if (hydrateOptions.skipSelectors?.length) markSkippedElements(rootElement, hydrateOptions.skipSelectors);
+	let deferredBoundaries = [];
+	if (hydrateOptions.deferBelowFold) {
+		const foldY = hydrateOptions.foldThreshold ?? window.innerHeight;
+		deferredBoundaries = collectDeferredBelowFoldBoundaries(rootElement, foldY);
+		const handleScroll = () => {
+			const { activated, remaining } = activateVisibleDeferredBoundaries(deferredBoundaries, foldY);
+			if (!activated) return;
+			flushHydrationActivation(rootElement);
+			if (remaining === 0) window.removeEventListener("scroll", handleScroll);
+		};
+		window.addEventListener("scroll", handleScroll, { passive: true });
+	}
+	if (hydrateOptions.deferUntilIdle && !hasSelectiveBoundaries) {
+		await queueIdleWork(() => {
+			mountOrUpdate(rootElement, (() => resolved.handler(resolved.params)), { cleanupStrict });
+		});
+		await registerAppNavigation(rootElement, path);
+		return;
+	}
+	mountOrUpdate(rootElement, (() => resolved.handler(resolved.params)), { cleanupStrict });
+	await registerAppNavigation(rootElement, path);
+	if (hydrateOptions.deferUntilIdle && deferredBoundaries.length > 0) await queueIdleWork(() => {
+		const { activated } = activateVisibleDeferredBoundaries(deferredBoundaries, Number.POSITIVE_INFINITY);
+		if (activated) flushHydrationActivation(rootElement);
+	});
+}
+/**
+* hydrateSPA: Hydrate server-rendered HTML.
+* Accepts either a `manifest` (preferred) or a legacy `routes` array.
+*/
+async function hydrateSPA(config) {
+	assertExecutionModel("spa");
+	if (!config || typeof config !== "object") throw new Error("hydrateSPA requires a config object");
+	const hasManifest = config.manifest != null && config.manifest.records.length > 0;
+	const hasRoutes = Array.isArray(config.routes) && config.routes.length > 0;
+	if (!hasManifest && !hasRoutes) throw new Error("hydrateSPA requires a route manifest or route table. Pass `manifest: getManifest()` or `routes: getRoutes()`. If you are enhancing existing HTML, use createIsland instead.");
+	const rootElement = typeof config.root === "string" ? document.getElementById(config.root) : config.root;
+	if (!rootElement) throw new Error(`Root element not found: ${config.root}`);
+	const pendingLazyAtHydrationBoot = _snapshotLazy();
+	configureScrollRestoration(config.scrollRestoration);
+	clearRoutes();
+	if (hasManifest) _applyManifest(config.manifest);
+	else for (const r of config.routes) route(r.path, r.handler);
+	_setActiveRouteAuthOptions(config.auth ?? config.manifest?.auth);
+	await _drainLazy(pendingLazyAtHydrationBoot);
+	const path = typeof window !== "undefined" ? window.location.pathname : "/";
+	const currentUrl = typeof window !== "undefined" ? `${window.location.pathname}${window.location.search}${window.location.hash}` : path;
+	setServerLocation(currentUrl);
+	if (isProductionEnvironment()) lockRouteRegistration();
+	const resolved = resolveRoute(path);
+	if (!resolved) throw new Error(`hydrateSPA: no route found for current path (${path}).`);
+	const legacyRouteTable = hasManifest ? config.manifest.records.map((r) => ({
+		path: r.path,
+		handler: r.handler,
+		namespace: r.options.namespace
+	})) : config.routes;
+	if (shouldVerifyHydrationMarkup(config)) {
+		const { verifyHydrationSyncForUrl } = await import("../ssr/index.js");
+		if (!verifyHydrationSyncForUrl({
+			root: rootElement,
+			url: currentUrl,
+			routes: legacyRouteTable
+		})) throw new Error("[Askr] Hydration mismatch detected. Server HTML does not match expected server-render output.");
+	}
+	const hydrateOptions = config.hydrate;
+	if (hydrateOptions) {
+		if (hydrateOptions.deferUntilIdle || hydrateOptions.deferBelowFold) {
+			await applySelectiveHydration(rootElement, {
+				handler: resolved.handler,
+				params: resolved.params
+			}, path, config.cleanupStrict, hydrateOptions);
+			return;
+		}
+		if (hydrateOptions.skipSelectors?.length) markSkippedElements(rootElement, hydrateOptions.skipSelectors);
+	}
+	mountOrUpdate(rootElement, bindResolvedRouteHandler(resolved), { cleanupStrict: config.cleanupStrict });
+	await registerAppNavigation(rootElement, path);
+}
+/**
+* Cleanup an app mounted on a root element (element or id).
+* Safe to call multiple times — no-op when nothing is mounted.
+*/
+function cleanupApp(root) {
+	const rootElement = typeof root === "string" ? document.getElementById(root) : root;
+	if (!rootElement) return;
+	const cleanupFn = rootElement[CLEANUP_SYMBOL];
+	if (typeof cleanupFn === "function") cleanupFn();
+	instancesByRoot.delete(rootElement);
+}
+/**
+* Check whether an app is mounted on the given root
+*/
+function hasApp(root) {
+	const rootElement = typeof root === "string" ? document.getElementById(root) : root;
+	if (!rootElement) return false;
+	return instancesByRoot.has(rootElement);
+}
+//#endregion
+export { cleanupApp, createIsland, createIslands, createSPA, hasApp, hydrateSPA, teardownApp };
+
+//# sourceMappingURL=index.js.map