@askrjs/askr 0.0.28 → 0.0.30

package/dist/bin/askr-ssg.js

@@ -1,5 +1,28 @@
 #!/usr/bin/env node
-import*as m from"path";import*as y from"fs";import"../ssg/index.js";import{createStaticGen as k}from"../ssg/create-static-gen.js";const{resolve:u}=m,{existsSync:$}=y;function d(e){const r=u(e).replace(/\\/g,"/");return`file://${r.startsWith("/")?"":"/"}${encodeURI(r)}`}const w={cwd:()=>process.cwd(),now:()=>performance.now(),existsSync:$,importConfig:async e=>await import(d(e)),createStaticGen:k},S=`
+import { createStaticGen } from "../ssg/create-static-gen.js";
+import "../ssg/index.js";
+import * as pathModule from "path";
+import * as fsModule from "fs";
+//#region src/bin/askr-ssg.ts
+/**
+* askr-ssg CLI
+*
+* Usage: askr-ssg --config path/to/config.ts --output dist/static
+*/
+const { resolve } = pathModule;
+const { existsSync } = fsModule;
+function toFileUrl(filePath) {
+	const normalized = resolve(filePath).replace(/\\/g, "/");
+	return `file://${normalized.startsWith("/") ? "" : "/"}${encodeURI(normalized)}`;
+}
+const defaultCliDeps = {
+	cwd: () => process.cwd(),
+	now: () => performance.now(),
+	existsSync,
+	importConfig: async (path) => await import(toFileUrl(path)),
+	createStaticGen
+};
+const helpText = `
 askr-ssg - Static Site Generation for Askr
 
 Usage:
@@ -21,4 +44,128 @@ Example:
 TypeScript config execution:
   Use tsx to run the CLI with TS config loading:
   tsx node_modules/@askrjs/askr/dist/bin/askr-ssg.js --config ./ssg.config.ts --output ./dist/static
-`;function v(e){const r={configPath:"",outputDir:"",workers:1,incremental:!1,changedKeys:[],changedRoutes:[],forceFull:!1,help:!1};for(let t=0;t<e.length;t++)e[t]==="--config"&&t+1<e.length?(r.configPath=e[t+1],t++):e[t]==="--output"&&t+1<e.length?(r.outputDir=e[t+1],t++):e[t]==="--workers"&&t+1<e.length?(r.workers=e[t+1]==="auto"?"auto":Number(e[t+1]),t++):e[t]==="--changed-key"&&t+1<e.length?(r.changedKeys.push(e[t+1]),t++):e[t]==="--changed-route"&&t+1<e.length?(r.changedRoutes.push(e[t+1]),t++):e[t]==="--incremental"?r.incremental=!0:e[t]==="--force-full"?r.forceFull=!0:(e[t]==="--help"||e[t]==="-h")&&(r.help=!0);return r}function x(e){return{mode:e.incremental?"incremental":"full",changedKeys:e.changedKeys,changedRoutes:e.changedRoutes,forceFull:e.forceFull}}function C(e,r,t,o){e.log(""),e.log(`Generation complete in ${t}s`),e.log(`   Mode:      ${o.mode}`),e.log(`   Generated: ${o.successful}/${o.totalRoutes} routes`),e.log(`   Failed:    ${o.failed} routes`),e.log(`   Rebuilt:   ${o.rebuilt} routes`),e.log(`   Skipped:   ${o.skipped} routes`),e.log(`   Removed:   ${o.removed} routes`),e.log(`   CacheHit:  ${o.cacheHits} routes`),e.log(`   Output:    ${r}`),e.log(`   Metadata:  ${r}/metadata.json`),e.log("")}async function G(e,r={},t=console){const o=v(e);if(o.help)return t.log(S),0;if(!o.configPath)return t.error("Error: --config argument is required"),1;if(!o.configPath.endsWith(".ts"))return t.error("Error: --config must point to a TypeScript file (.ts)"),1;if(!o.outputDir)return t.error("Error: --output argument is required"),1;const s={...w,...r},a=u(s.cwd(),o.configPath),f=u(s.cwd(),o.outputDir);if(!s.existsSync(a))return t.error(`Error: Config file not found: ${a}`),1;try{t.log(`Loading config: ${a}`);const n=await s.importConfig(a),i=n.default||n;if(!Array.isArray(i.routes))return t.error("Error: Config must export routes array"),1;t.log(`Generating ${i.routes.length} routes...`);const g=s.createStaticGen({routes:i.routes,outputDir:f,seed:i.seed,dataOverrides:i.dataOverrides,concurrency:i.concurrency,parallelism:o.workers}),p=s.now(),c=await g.generate(x(o)),h=((s.now()-p)/1e3).toFixed(2);if(C(t,f,h,c),c.failed>0){t.log("Errors encountered:");for(const l of c.routes)l.status==="error"&&t.log(`   ${l.path}: ${l.error}`);return t.log(""),1}return 0}catch(n){return t.error("Generation failed:"),t.error(n instanceof Error?n.message:String(n)),n instanceof Error&&n.stack&&t.error(n.stack),1}}async function b(){const e=await G(process.argv.slice(2));process.exit(e)}process.argv[1]&&import.meta.url===d(process.argv[1])&&b();export{v as parseCliArgs,G as runCli};
+`;
+function parseCliArgs(args) {
+	const parsed = {
+		configPath: "",
+		outputDir: "",
+		workers: 1,
+		incremental: false,
+		changedKeys: [],
+		changedRoutes: [],
+		forceFull: false,
+		help: false
+	};
+	for (let i = 0; i < args.length; i++) if (args[i] === "--config" && i + 1 < args.length) {
+		parsed.configPath = args[i + 1];
+		i++;
+	} else if (args[i] === "--output" && i + 1 < args.length) {
+		parsed.outputDir = args[i + 1];
+		i++;
+	} else if (args[i] === "--workers" && i + 1 < args.length) {
+		parsed.workers = args[i + 1] === "auto" ? "auto" : Number(args[i + 1]);
+		i++;
+	} else if (args[i] === "--changed-key" && i + 1 < args.length) {
+		parsed.changedKeys.push(args[i + 1]);
+		i++;
+	} else if (args[i] === "--changed-route" && i + 1 < args.length) {
+		parsed.changedRoutes.push(args[i + 1]);
+		i++;
+	} else if (args[i] === "--incremental") parsed.incremental = true;
+	else if (args[i] === "--force-full") parsed.forceFull = true;
+	else if (args[i] === "--help" || args[i] === "-h") parsed.help = true;
+	return parsed;
+}
+function toGenerateOptions(args) {
+	return {
+		mode: args.incremental ? "incremental" : "full",
+		changedKeys: args.changedKeys,
+		changedRoutes: args.changedRoutes,
+		forceFull: args.forceFull
+	};
+}
+function printSummary(io, outputDir, durationSeconds, result) {
+	io.log("");
+	io.log(`Generation complete in ${durationSeconds}s`);
+	io.log(`   Mode:      ${result.mode}`);
+	io.log(`   Generated: ${result.successful}/${result.totalRoutes} routes`);
+	io.log(`   Failed:    ${result.failed} routes`);
+	io.log(`   Rebuilt:   ${result.rebuilt} routes`);
+	io.log(`   Skipped:   ${result.skipped} routes`);
+	io.log(`   Removed:   ${result.removed} routes`);
+	io.log(`   CacheHit:  ${result.cacheHits} routes`);
+	io.log(`   Output:    ${outputDir}`);
+	io.log(`   Metadata:  ${outputDir}/metadata.json`);
+	io.log("");
+}
+async function runCli(args, deps = {}, io = console) {
+	const parsed = parseCliArgs(args);
+	if (parsed.help) {
+		io.log(helpText);
+		return 0;
+	}
+	if (!parsed.configPath) {
+		io.error("Error: --config argument is required");
+		return 1;
+	}
+	if (!parsed.configPath.endsWith(".ts")) {
+		io.error("Error: --config must point to a TypeScript file (.ts)");
+		return 1;
+	}
+	if (!parsed.outputDir) {
+		io.error("Error: --output argument is required");
+		return 1;
+	}
+	const resolvedDeps = {
+		...defaultCliDeps,
+		...deps
+	};
+	const resolvedConfigPath = resolve(resolvedDeps.cwd(), parsed.configPath);
+	const resolvedOutputDir = resolve(resolvedDeps.cwd(), parsed.outputDir);
+	if (!resolvedDeps.existsSync(resolvedConfigPath)) {
+		io.error(`Error: Config file not found: ${resolvedConfigPath}`);
+		return 1;
+	}
+	try {
+		io.log(`Loading config: ${resolvedConfigPath}`);
+		const configModule = await resolvedDeps.importConfig(resolvedConfigPath);
+		const config = configModule.default || configModule;
+		if (!Array.isArray(config.routes)) {
+			io.error("Error: Config must export routes array");
+			return 1;
+		}
+		io.log(`Generating ${config.routes.length} routes...`);
+		const ssg = resolvedDeps.createStaticGen({
+			routes: config.routes,
+			outputDir: resolvedOutputDir,
+			seed: config.seed,
+			dataOverrides: config.dataOverrides,
+			concurrency: config.concurrency,
+			parallelism: parsed.workers
+		});
+		const startTime = resolvedDeps.now();
+		const result = await ssg.generate(toGenerateOptions(parsed));
+		printSummary(io, resolvedOutputDir, ((resolvedDeps.now() - startTime) / 1e3).toFixed(2), result);
+		if (result.failed > 0) {
+			io.log("Errors encountered:");
+			for (const route of result.routes) if (route.status === "error") io.log(`   ${route.path}: ${route.error}`);
+			io.log("");
+			return 1;
+		}
+		return 0;
+	} catch (error) {
+		io.error("Generation failed:");
+		io.error(error instanceof Error ? error.message : String(error));
+		if (error instanceof Error && error.stack) io.error(error.stack);
+		return 1;
+	}
+}
+async function main() {
+	const exitCode = await runCli(process.argv.slice(2));
+	process.exit(exitCode);
+}
+if (process.argv[1] && import.meta.url === toFileUrl(process.argv[1])) main();
+//#endregion
+export { parseCliArgs, runCli };
+
+//# sourceMappingURL=askr-ssg.js.map

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":";;;;;;;;;;;AAcA,MAAM,EAAE,YAAY;AACpB,MAAM,EAAE,eAAe;AAEvB,SAAS,UAAU,UAA0B;CAC3C,MAAM,aAAa,QAAQ,SAAS,CAAC,QAAQ,OAAO,IAAI;AAExD,QAAO,UADc,WAAW,WAAW,IAAI,GAAG,KAAK,MACvB,UAAU,WAAW;;AAkCvD,MAAM,iBAA0B;CAC9B,WAAW,QAAQ,KAAK;CACxB,WAAW,YAAY,KAAK;CAC5B;CACA,cAAc,OAAO,SAClB,MAAM,OAAO,UAAU,KAAK;CAC/B;CACD;AAED,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;AAwBjB,SAAgB,aAAa,MAA+B;CAC1D,MAAM,SAAwB;EAC5B,YAAY;EACZ,WAAW;EACX,SAAS;EACT,aAAa;EACb,aAAa,EAAE;EACf,eAAe,EAAE;EACjB,WAAW;EACX,MAAM;EACP;AAED,MAAK,IAAI,IAAI,GAAG,IAAI,KAAK,QAAQ,IAC/B,KAAI,KAAK,OAAO,cAAc,IAAI,IAAI,KAAK,QAAQ;AACjD,SAAO,aAAa,KAAK,IAAI;AAC7B;YACS,KAAK,OAAO,cAAc,IAAI,IAAI,KAAK,QAAQ;AACxD,SAAO,YAAY,KAAK,IAAI;AAC5B;YACS,KAAK,OAAO,eAAe,IAAI,IAAI,KAAK,QAAQ;AACzD,SAAO,UAAU,KAAK,IAAI,OAAO,SAAS,SAAS,OAAO,KAAK,IAAI,GAAG;AACtE;YACS,KAAK,OAAO,mBAAmB,IAAI,IAAI,KAAK,QAAQ;AAC7D,SAAO,YAAY,KAAK,KAAK,IAAI,GAAG;AACpC;YACS,KAAK,OAAO,qBAAqB,IAAI,IAAI,KAAK,QAAQ;AAC/D,SAAO,cAAc,KAAK,KAAK,IAAI,GAAG;AACtC;YACS,KAAK,OAAO,gBACrB,QAAO,cAAc;UACZ,KAAK,OAAO,eACrB,QAAO,YAAY;UACV,KAAK,OAAO,YAAY,KAAK,OAAO,KAC7C,QAAO,OAAO;AAIlB,QAAO;;AAGT,SAAS,kBAAkB,MAAyC;AAClE,QAAO;EACL,MAAM,KAAK,cAAc,gBAAgB;EACzC,aAAa,KAAK;EAClB,eAAe,KAAK;EACpB,WAAW,KAAK;EACjB;;AAGH,SAAS,aACP,IACA,WACA,iBACA,QACA;AACA,IAAG,IAAI,GAAG;AACV,IAAG,IAAI,0BAA0B,gBAAgB,GAAG;AACpD,IAAG,IAAI,iBAAiB,OAAO,OAAO;AACtC,IAAG,IAAI,iBAAiB,OAAO,WAAW,GAAG,OAAO,YAAY,SAAS;AACzE,IAAG,IAAI,iBAAiB,OAAO,OAAO,SAAS;AAC/C,IAAG,IAAI,iBAAiB,OAAO,QAAQ,SAAS;AAChD,IAAG,IAAI,iBAAiB,OAAO,QAAQ,SAAS;AAChD,IAAG,IAAI,iBAAiB,OAAO,QAAQ,SAAS;AAChD,IAAG,IAAI,iBAAiB,OAAO,UAAU,SAAS;AAClD,IAAG,IAAI,iBAAiB,YAAY;AACpC,IAAG,IAAI,iBAAiB,UAAU,gBAAgB;AAClD,IAAG,IAAI,GAAG;;AAGZ,eAAsB,OACpB,MACA,OAAyB,EAAE,EAC3B,KAAY,SACK;CACjB,MAAM,SAAS,aAAa,KAAK;AACjC,KAAI,OAAO,MAAM;AACf,KAAG,IAAI,SAAS;AAChB,SAAO;;AAGT,KAAI,CAAC,OAAO,YAAY;AACtB,KAAG,MAAM,uCAAuC;AAChD,SAAO;;AAGT,KAAI,CAAC,OAAO,WAAW,SAAS,MAAM,EAAE;AACtC,KAAG,MAAM,wDAAwD;AACjE,SAAO;;AAGT,KAAI,CAAC,OAAO,WAAW;AACrB,KAAG,MAAM,uCAAuC;AAChD,SAAO;;CAGT,MAAM,eAAe;EAAE,GAAG;EAAgB,GAAG;EAAM;CACnD,MAAM,qBAAqB,QAAQ,aAAa,KAAK,EAAE,OAAO,WAAW;CACzE,MAAM,oBAAoB,QAAQ,aAAa,KAAK,EAAE,OAAO,UAAU;AAEvE,KAAI,CAAC,aAAa,WAAW,mBAAmB,EAAE;AAChD,KAAG,MAAM,iCAAiC,qBAAqB;AAC/D,SAAO;;AAGT,KAAI;AACF,KAAG,IAAI,mBAAmB,qBAAqB;EAE/C,MAAM,eAAe,MAAM,aAAa,aAAa,mBAAmB;EACxE,MAAM,SAAU,aAAa,WAAW;AAExC,MAAI,CAAC,MAAM,QAAQ,OAAO,OAAO,EAAE;AACjC,MAAG,MAAM,yCAAyC;AAClD,UAAO;;AAGT,KAAG,IAAI,cAAc,OAAO,OAAO,OAAO,YAAY;EAEtD,MAAM,MAAM,aAAa,gBAAgB;GACvC,QAAQ,OAAO;GACf,WAAW;GACX,MAAM,OAAO;GACb,eAAe,OAAO;GACtB,aAAa,OAAO;GACpB,aAAa,OAAO;GACrB,CAAC;EAEF,MAAM,YAAY,aAAa,KAAK;EACpC,MAAM,SAAS,MAAM,IAAI,SAAS,kBAAkB,OAAO,CAAC;AAG5D,eAAa,IAAI,qBAFE,aAAa,KAAK,GAAG,aAAa,KAAM,QAAQ,EAE/B,EAAU,OAAO;AAErD,MAAI,OAAO,SAAS,GAAG;AACrB,MAAG,IAAI,sBAAsB;AAC7B,QAAK,MAAM,SAAS,OAAO,OACzB,KAAI,MAAM,WAAW,QACnB,IAAG,IAAI,MAAM,MAAM,KAAK,IAAI,MAAM,QAAQ;AAG9C,MAAG,IAAI,GAAG;AACV,UAAO;;AAGT,SAAO;UACA,OAAO;AACd,KAAG,MAAM,qBAAqB;AAC9B,KAAG,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC;AAChE,MAAI,iBAAiB,SAAS,MAAM,MAClC,IAAG,MAAM,MAAM,MAAM;AAEvB,SAAO;;;AAIX,eAAe,OAAO;CACpB,MAAM,WAAW,MAAM,OAAO,QAAQ,KAAK,MAAM,EAAE,CAAC;AACpD,SAAQ,KAAK,SAAS;;AAGxB,IAAI,QAAQ,KAAK,MAAM,OAAO,KAAK,QAAQ,UAAU,QAAQ,KAAK,GAAG,CACnE,CAAK,MAAM"}

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,CA+DhE;AAgLD;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuFxE;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"}