@askrjs/askr 0.0.28 → 0.0.30

package/dist/ssg/resolve-ssg-data.d.ts

@@ -1,14 +1,10 @@
-/**
- * Data resolution for SSG
- *
- * Merges user-supplied data overrides with any auto-discovered resources.
- * In phase 1, primarily handles user-supplied data.
- */
-import type { SSRData } from '../common/ssr';
-import type { RouteConfig } from './types';
+import { RouteConfig } from "./types.js";
+import { SSRData } from "../common/ssr.js";
+
+//#region src/ssg/resolve-ssg-data.d.ts
 interface DataResolutionOptions {
-    /** User-supplied data overrides per route path */
-    dataOverrides?: Record<string, unknown>;
+  /** User-supplied data overrides per route path */
+  dataOverrides?: Record<string, unknown>;
 }
 /**
  * Resolve and validate data for SSG routes
@@ -17,10 +13,11 @@ interface DataResolutionOptions {
  * In phase 1: accepts user-supplied dataOverrides
  * In phase 2: can be extended to auto-discover resources
  */
-export declare function resolveSsgData(routes: RouteConfig[], options?: DataResolutionOptions): Record<string, SSRData>;
+declare function resolveSsgData(routes: RouteConfig[], options?: DataResolutionOptions): Record<string, SSRData>;
 /**
  * Validate routes are properly configured
  */
-export declare function validateRoutes(routes: RouteConfig[]): void;
-export {};
+declare function validateRoutes(routes: RouteConfig[]): void;
+//#endregion
+export { resolveSsgData, validateRoutes };
 //# sourceMappingURL=resolve-ssg-data.d.ts.map

package/dist/ssg/resolve-ssg-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-ssg-data.d.ts","sourceRoot":"","sources":["../../src/ssg/resolve-ssg-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,UAAU,qBAAqB;IAC7B,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,CAkE1D"}
+{"version":3,"file":"resolve-ssg-data.d.ts","names":[],"sources":["../../src/ssg/resolve-ssg-data.ts"],"mappings":";;;;UAUU,qBAAA;EAYM;EAVd,aAAA,GAAgB,MAAA;AAAA;;;;;;;;iBAUF,cAAA,CACd,MAAA,EAAQ,WAAA,IACR,OAAA,GAAS,qBAAA,GACR,MAAA,SAAe,OAAA;;;;iBAyBF,cAAA,CAAe,MAAA,EAAQ,WAAA"}

package/dist/ssg/resolve-ssg-data.js

@@ -1 +1,46 @@
-function s(o,e={}){const{dataOverrides:t={}}=e,i={};for(const a of o)if(a.path in t){const r=t[a.path];if(typeof r!="object"||r===null||Array.isArray(r))throw new Error(`data for route "${a.path}" must be an object, got ${typeof r}`);i[a.path]=r}return i}function h(o){if(!Array.isArray(o))throw new Error("routes must be an array");if(o.length===0)throw new Error("routes array cannot be empty");const e=new Set;for(const t of o){if(typeof t.path!="string"||!t.path.startsWith("/"))throw new Error(`route path must be a string starting with "/", got "${t.path}"`);if(typeof(t.handler??t.component)!="function")throw new Error(`route handler must be a function for path "${t.path}"`);const a=`${t.path}::${JSON.stringify(t.params||{})}`;if(e.has(a))throw new Error(`duplicate route entry detected for path "${t.path}"`);if(e.add(a),t.path.includes("{")){const r=Array.from(t.path.matchAll(/\{([^}]+)\}/g)).map(n=>n[1]);if(!t.params)throw new Error(`route "${t.path}" uses path parameters and requires params`);for(const n of r)if(!(n in t.params))throw new Error(`route "${t.path}" missing required param "${n}"`)}if(t.invalidationKeys!==void 0){if(!Array.isArray(t.invalidationKeys))throw new Error(`route "${t.path}" invalidationKeys must be an array of strings`);for(const r of t.invalidationKeys)if(typeof r!="string"||r.length===0)throw new Error(`route "${t.path}" invalidationKeys must contain only non-empty strings`)}}}export{s as resolveSsgData,h as validateRoutes};
+//#region src/ssg/resolve-ssg-data.ts
+/**
+* Resolve and validate data for SSG routes
+* Returns a map of route path -> SSRData
+*
+* In phase 1: accepts user-supplied dataOverrides
+* In phase 2: can be extended to auto-discover resources
+*/
+function resolveSsgData(routes, options = {}) {
+	const { dataOverrides = {} } = options;
+	const dataMap = {};
+	for (const route of routes) if (route.path in dataOverrides) {
+		const data = dataOverrides[route.path];
+		if (typeof data !== "object" || data === null || Array.isArray(data)) throw new Error(`data for route "${route.path}" must be an object, got ${typeof data}`);
+		dataMap[route.path] = data;
+	}
+	return dataMap;
+}
+/**
+* Validate routes are properly configured
+*/
+function validateRoutes(routes) {
+	if (!Array.isArray(routes)) throw new Error("routes must be an array");
+	if (routes.length === 0) throw new Error("routes array cannot be empty");
+	const seen = /* @__PURE__ */ new Set();
+	for (const route of routes) {
+		if (typeof route.path !== "string" || !route.path.startsWith("/")) throw new Error(`route path must be a string starting with "/", got "${route.path}"`);
+		if (typeof (route.handler ?? route.component) !== "function") throw new Error(`route handler must be a function for path "${route.path}"`);
+		const key = `${route.path}::${JSON.stringify(route.params || {})}`;
+		if (seen.has(key)) throw new Error(`duplicate route entry detected for path "${route.path}"`);
+		seen.add(key);
+		if (route.path.includes("{")) {
+			const paramNames = Array.from(route.path.matchAll(/\{([^}]+)\}/g)).map((m) => m[1]);
+			if (!route.params) throw new Error(`route "${route.path}" uses path parameters and requires params`);
+			for (const name of paramNames) if (!(name in route.params)) throw new Error(`route "${route.path}" missing required param "${name}"`);
+		}
+		if (route.invalidationKeys !== void 0) {
+			if (!Array.isArray(route.invalidationKeys)) throw new Error(`route "${route.path}" invalidationKeys must be an array of strings`);
+			for (const key of route.invalidationKeys) if (typeof key !== "string" || key.length === 0) throw new Error(`route "${route.path}" invalidationKeys must contain only non-empty strings`);
+		}
+	}
+}
+//#endregion
+export { resolveSsgData, validateRoutes };
+
+//# sourceMappingURL=resolve-ssg-data.js.map

package/dist/ssg/resolve-ssg-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-ssg-data.js","names":[],"sources":["../../src/ssg/resolve-ssg-data.ts"],"sourcesContent":["/**\n * Data resolution for SSG\n *\n * Merges user-supplied data overrides with any auto-discovered resources.\n * In phase 1, primarily handles user-supplied data.\n */\n\nimport type { SSRData } from '../common/ssr';\nimport type { RouteConfig } from './types';\n\ninterface DataResolutionOptions {\n  /** User-supplied data overrides per route path */\n  dataOverrides?: Record<string, unknown>;\n}\n\n/**\n * Resolve and validate data for SSG routes\n * Returns a map of route path -> SSRData\n *\n * In phase 1: accepts user-supplied dataOverrides\n * In phase 2: can be extended to auto-discover resources\n */\nexport function resolveSsgData(\n  routes: RouteConfig[],\n  options: DataResolutionOptions = {}\n): Record<string, SSRData> {\n  const { dataOverrides = {} } = options;\n  const dataMap: Record<string, SSRData> = {};\n\n  for (const route of routes) {\n    // Check if user provided data for this route\n    if (route.path in dataOverrides) {\n      const data = dataOverrides[route.path];\n      if (typeof data !== 'object' || data === null || Array.isArray(data)) {\n        throw new Error(\n          `data for route \"${route.path}\" must be an object, got ${typeof data}`\n        );\n      }\n      dataMap[route.path] = data as SSRData;\n    }\n    // In phase 1, routes without data are rendered with no SSR data\n    // Phase 2 can add auto-discovery here\n  }\n\n  return dataMap;\n}\n\n/**\n * Validate routes are properly configured\n */\nexport function validateRoutes(routes: RouteConfig[]): void {\n  if (!Array.isArray(routes)) {\n    throw new Error('routes must be an array');\n  }\n\n  if (routes.length === 0) {\n    throw new Error('routes array cannot be empty');\n  }\n\n  const seen = new Set<string>();\n\n  for (const route of routes) {\n    if (typeof route.path !== 'string' || !route.path.startsWith('/')) {\n      throw new Error(\n        `route path must be a string starting with \"/\", got \"${route.path}\"`\n      );\n    }\n\n    const handler = route.handler ?? route.component;\n    if (typeof handler !== 'function') {\n      throw new Error(\n        `route handler must be a function for path \"${route.path}\"`\n      );\n    }\n\n    const key = `${route.path}::${JSON.stringify(route.params || {})}`;\n    if (seen.has(key)) {\n      throw new Error(\n        `duplicate route entry detected for path \"${route.path}\"`\n      );\n    }\n    seen.add(key);\n\n    if (route.path.includes('{')) {\n      const paramNames = Array.from(route.path.matchAll(/\\{([^}]+)\\}/g)).map(\n        (m) => m[1]\n      );\n      if (!route.params) {\n        throw new Error(\n          `route \"${route.path}\" uses path parameters and requires params`\n        );\n      }\n      for (const name of paramNames) {\n        if (!(name in route.params)) {\n          throw new Error(\n            `route \"${route.path}\" missing required param \"${name}\"`\n          );\n        }\n      }\n    }\n\n    if (route.invalidationKeys !== undefined) {\n      if (!Array.isArray(route.invalidationKeys)) {\n        throw new Error(\n          `route \"${route.path}\" invalidationKeys must be an array of strings`\n        );\n      }\n      for (const key of route.invalidationKeys) {\n        if (typeof key !== 'string' || key.length === 0) {\n          throw new Error(\n            `route \"${route.path}\" invalidationKeys must contain only non-empty strings`\n          );\n        }\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAsBA,SAAgB,eACd,QACA,UAAiC,EAAE,EACV;CACzB,MAAM,EAAE,gBAAgB,EAAE,KAAK;CAC/B,MAAM,UAAmC,EAAE;AAE3C,MAAK,MAAM,SAAS,OAElB,KAAI,MAAM,QAAQ,eAAe;EAC/B,MAAM,OAAO,cAAc,MAAM;AACjC,MAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,MAAM,QAAQ,KAAK,CAClE,OAAM,IAAI,MACR,mBAAmB,MAAM,KAAK,2BAA2B,OAAO,OACjE;AAEH,UAAQ,MAAM,QAAQ;;AAM1B,QAAO;;;;;AAMT,SAAgB,eAAe,QAA6B;AAC1D,KAAI,CAAC,MAAM,QAAQ,OAAO,CACxB,OAAM,IAAI,MAAM,0BAA0B;AAG5C,KAAI,OAAO,WAAW,EACpB,OAAM,IAAI,MAAM,+BAA+B;CAGjD,MAAM,uBAAO,IAAI,KAAa;AAE9B,MAAK,MAAM,SAAS,QAAQ;AAC1B,MAAI,OAAO,MAAM,SAAS,YAAY,CAAC,MAAM,KAAK,WAAW,IAAI,CAC/D,OAAM,IAAI,MACR,uDAAuD,MAAM,KAAK,GACnE;AAIH,MAAI,QADY,MAAM,WAAW,MAAM,eAChB,WACrB,OAAM,IAAI,MACR,8CAA8C,MAAM,KAAK,GAC1D;EAGH,MAAM,MAAM,GAAG,MAAM,KAAK,IAAI,KAAK,UAAU,MAAM,UAAU,EAAE,CAAC;AAChE,MAAI,KAAK,IAAI,IAAI,CACf,OAAM,IAAI,MACR,4CAA4C,MAAM,KAAK,GACxD;AAEH,OAAK,IAAI,IAAI;AAEb,MAAI,MAAM,KAAK,SAAS,IAAI,EAAE;GAC5B,MAAM,aAAa,MAAM,KAAK,MAAM,KAAK,SAAS,eAAe,CAAC,CAAC,KAChE,MAAM,EAAE,GACV;AACD,OAAI,CAAC,MAAM,OACT,OAAM,IAAI,MACR,UAAU,MAAM,KAAK,4CACtB;AAEH,QAAK,MAAM,QAAQ,WACjB,KAAI,EAAE,QAAQ,MAAM,QAClB,OAAM,IAAI,MACR,UAAU,MAAM,KAAK,4BAA4B,KAAK,GACvD;;AAKP,MAAI,MAAM,qBAAqB,QAAW;AACxC,OAAI,CAAC,MAAM,QAAQ,MAAM,iBAAiB,CACxC,OAAM,IAAI,MACR,UAAU,MAAM,KAAK,gDACtB;AAEH,QAAK,MAAM,OAAO,MAAM,iBACtB,KAAI,OAAO,QAAQ,YAAY,IAAI,WAAW,EAC5C,OAAM,IAAI,MACR,UAAU,MAAM,KAAK,wDACtB"}

package/dist/ssg/route-utils.d.ts

@@ -1,12 +1,16 @@
-import type { RouteConfig } from './types';
-export interface ResolvedRouteDescriptor {
-    route: RouteConfig;
-    path: string;
-    filePath: string;
-    routeId: string;
-    invalidationKeys: string[];
+import { RouteConfig } from "./types.js";
+
+//#region src/ssg/route-utils.d.ts
+interface ResolvedRouteDescriptor {
+  route: RouteConfig;
+  path: string;
+  filePath: string;
+  routeId: string;
+  invalidationKeys: string[];
 }
-export declare function getOutputFilePath(pathStr: string): string;
-export declare function interpolateRoutePath(routePath: string, params?: Record<string, string>): string;
-export declare function resolveRouteDescriptor(route: RouteConfig): ResolvedRouteDescriptor;
+declare function getOutputFilePath(pathStr: string): string;
+declare function interpolateRoutePath(routePath: string, params?: Record<string, string>): string;
+declare function resolveRouteDescriptor(route: RouteConfig): ResolvedRouteDescriptor;
+//#endregion
+export { getOutputFilePath };
 //# sourceMappingURL=route-utils.d.ts.map

package/dist/ssg/route-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-utils.d.ts","sourceRoot":"","sources":["../../src/ssg/route-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,WAAW,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAMR;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,WAAW,GACjB,uBAAuB,CAUzB"}
+{"version":3,"file":"route-utils.d.ts","names":[],"sources":["../../src/ssg/route-utils.ts"],"mappings":";;;UAEiB,uBAAA;EACf,KAAA,EAAO,WAAA;EACP,IAAA;EACA,QAAA;EACA,OAAA;EACA,gBAAA;AAAA;AAAA,iBAGc,iBAAA,CAAkB,OAAA;AAAA,iBAQlB,oBAAA,CACd,SAAA,UACA,MAAA,GAAS,MAAA;AAAA,iBASK,sBAAA,CACd,KAAA,EAAO,WAAA,GACN,uBAAA"}

package/dist/ssg/route-utils.js

@@ -1 +1,24 @@
-function r(e){return e==="/"?"index.html":`${e.replace(/^\/|\/$/g,"")}/index.html`}function l(e,n){return n?e.replace(/\{([^}]+)\}/g,(t,i)=>n[i]??""):e}function o(e){const n=l(e.path,e.params),t=r(n);return{route:e,path:n,filePath:t,routeId:`${n}::${t}`,invalidationKeys:e.invalidationKeys?.slice()??[]}}export{r as getOutputFilePath,l as interpolateRoutePath,o as resolveRouteDescriptor};
+//#region src/ssg/route-utils.ts
+function getOutputFilePath(pathStr) {
+	if (pathStr === "/") return "index.html";
+	return `${pathStr.replace(/^\/|\/$/g, "")}/index.html`;
+}
+function interpolateRoutePath(routePath, params) {
+	if (!params) return routePath;
+	return routePath.replace(/\{([^}]+)\}/g, (_, key) => params[key] ?? "");
+}
+function resolveRouteDescriptor(route) {
+	const path = interpolateRoutePath(route.path, route.params);
+	const filePath = getOutputFilePath(path);
+	return {
+		route,
+		path,
+		filePath,
+		routeId: `${path}::${filePath}`,
+		invalidationKeys: route.invalidationKeys?.slice() ?? []
+	};
+}
+//#endregion
+export { getOutputFilePath, interpolateRoutePath, resolveRouteDescriptor };
+
+//# sourceMappingURL=route-utils.js.map

package/dist/ssg/route-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-utils.js","names":[],"sources":["../../src/ssg/route-utils.ts"],"sourcesContent":["import type { RouteConfig } from './types';\n\nexport interface ResolvedRouteDescriptor {\n  route: RouteConfig;\n  path: string;\n  filePath: string;\n  routeId: string;\n  invalidationKeys: string[];\n}\n\nexport function getOutputFilePath(pathStr: string): string {\n  if (pathStr === '/') {\n    return 'index.html';\n  }\n  const normalized = pathStr.replace(/^\\/|\\/$/g, '');\n  return `${normalized}/index.html`;\n}\n\nexport function interpolateRoutePath(\n  routePath: string,\n  params?: Record<string, string>\n): string {\n  if (!params) return routePath;\n  return routePath.replace(\n    /\\{([^}]+)\\}/g,\n    (_, key: string) => params[key] ?? ''\n  );\n}\n\nexport function resolveRouteDescriptor(\n  route: RouteConfig\n): ResolvedRouteDescriptor {\n  const path = interpolateRoutePath(route.path, route.params);\n  const filePath = getOutputFilePath(path);\n  return {\n    route,\n    path,\n    filePath,\n    routeId: `${path}::${filePath}`,\n    invalidationKeys: route.invalidationKeys?.slice() ?? [],\n  };\n}\n"],"mappings":";AAUA,SAAgB,kBAAkB,SAAyB;AACzD,KAAI,YAAY,IACd,QAAO;AAGT,QAAO,GADY,QAAQ,QAAQ,YAAY,GACrC,CAAW;;AAGvB,SAAgB,qBACd,WACA,QACQ;AACR,KAAI,CAAC,OAAQ,QAAO;AACpB,QAAO,UAAU,QACf,iBACC,GAAG,QAAgB,OAAO,QAAQ,GACpC;;AAGH,SAAgB,uBACd,OACyB;CACzB,MAAM,OAAO,qBAAqB,MAAM,MAAM,MAAM,OAAO;CAC3D,MAAM,WAAW,kBAAkB,KAAK;AACxC,QAAO;EACL;EACA;EACA;EACA,SAAS,GAAG,KAAK,IAAI;EACrB,kBAAkB,MAAM,kBAAkB,OAAO,IAAI,EAAE;EACxD"}

package/dist/ssg/types.d.ts

@@ -1,164 +1,177 @@
-/**
- * Type definitions for Static Site Generation.
- */
-import type { ComponentFunction } from '../common/component';
-import type { RouteHandler } from '../common/router';
-export type SSGMode = 'full' | 'incremental';
-export type RouteRenderStatus = 'success' | 'error' | 'skipped' | 'removed';
-export type RouteRenderReason = 'full' | 'changed-key' | 'changed-route' | 'new-route' | 'no-keys' | 'unchanged' | 'deleted';
+import { ComponentFunction } from "../common/component.js";
+import { RouteAuthMode, RouteHandler, RoutePolicy } from "../common/router.js";
+
+//#region src/ssg/types.d.ts
+type SSGMode = 'full' | 'incremental';
+type RouteRenderStatus = 'success' | 'error' | 'skipped' | 'removed';
+type RouteRenderReason = 'full' | 'changed-key' | 'changed-route' | 'new-route' | 'no-keys' | 'unchanged' | 'deleted' | 'runtime-only';
 /**
  * Route config accepted by SSG.
  *
  * `handler` is preferred and matches router/SSR naming.
  * `component` is kept for compatibility and is normalized to `handler`.
  */
-export interface RouteConfig {
-    /** URL path to generate (e.g., "/blog/post-1", "/") */
-    path: string;
-    /** Route handler compatible with router/SSR */
-    handler?: RouteHandler;
-    /** Backward-compatible alias for handler */
-    component?: ComponentFunction;
-    /** Optional base props merged with route params during render */
-    props?: Record<string, unknown>;
-    /** Optional namespace for router compatibility */
-    namespace?: string;
-    /** Optional path parameter map for template paths like "/blog/{slug}" */
-    params?: Record<string, string>;
-    /** Optional explicit invalidation keys for incremental generation */
-    invalidationKeys?: string[];
+interface RouteConfig {
+  /** URL path to generate (e.g., "/blog/post-1", "/") */
+  path: string;
+  /** Route handler compatible with router/SSR */
+  handler?: RouteHandler;
+  /** Backward-compatible alias for handler */
+  component?: ComponentFunction;
+  /** Optional base props merged with route params during render */
+  props?: Record<string, unknown>;
+  /** Optional namespace for router compatibility */
+  namespace?: string;
+  /** Guest routes remain prerenderable; authenticated routes are runtime-only by default */
+  auth?: RouteAuthMode;
+  /** Role-gated routes are runtime-only by default */
+  role?: string;
+  /** Permission-gated routes are runtime-only by default */
+  permission?: string;
+  /** Advanced runtime access checks disable prerendering by default */
+  policies?: readonly RoutePolicy[];
+  /** Optional path parameter map for template paths like "/blog/{slug}" */
+  params?: Record<string, string>;
+  /** Optional explicit invalidation keys for incremental generation */
+  invalidationKeys?: string[];
+  /**
+   * SSG entry generator for parameterized routes.
+   *
+   * Return one param map per page to be generated.  The path template is
+   * expanded with each map to produce a concrete URL, e.g.:
+   *
+   * ```ts
+   * route('/posts/{slug}', PostPage, {
+   *   entries: async () => getPosts().map(p => ({ slug: p.slug })),
+   * });
+   * ```
+   */
+  entries?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
 }
 /** Options for createStaticGen */
-export interface SSGOptions {
-    /** Routes to generate */
-    routes: RouteConfig[];
-    /** Output directory for generated HTML files */
-    outputDir: string;
-    /** Optional seed for deterministic rendering */
-    seed?: number;
-    /** Optional override data for resources (route-keyed) */
-    dataOverrides?: Record<string, unknown>;
-    /** Optional concurrency limit for rendering (default: 10) */
-    concurrency?: number;
-    /** Preferred render parallelism. `'auto'` resolves from the host machine. */
-    parallelism?: number | 'auto';
+interface SSGOptions {
+  /** Routes to generate */
+  routes: RouteConfig[];
+  /** Output directory for generated HTML files */
+  outputDir: string;
+  /** Optional seed for deterministic rendering */
+  seed?: number;
+  /** Optional override data for resources (route-keyed) */
+  dataOverrides?: Record<string, unknown>;
+  /** Optional concurrency limit for rendering (default: 10) */
+  concurrency?: number;
+  /** Preferred render parallelism. `'auto'` resolves from the host machine. */
+  parallelism?: number | 'auto';
 }
 /** Options for a single generation run */
-export interface SSGGenerateOptions {
-    /** Generation mode */
-    mode?: SSGMode;
-    /** Changed invalidation keys for incremental runs */
-    changedKeys?: string[];
-    /** Changed concrete route paths for incremental runs */
-    changedRoutes?: string[];
-    /** Force a full rebuild even when incremental mode was requested */
-    forceFull?: boolean;
+interface SSGGenerateOptions {
+  /** Generation mode */
+  mode?: SSGMode;
+  /** Changed invalidation keys for incremental runs */
+  changedKeys?: string[];
+  /** Changed concrete route paths for incremental runs */
+  changedRoutes?: string[];
+  /** Force a full rebuild even when incremental mode was requested */
+  forceFull?: boolean;
 }
 /** Result of rendering a single route */
-export interface RouteRenderResult {
-    /** URL path */
-    path: string;
-    /** Output file path relative to outputDir */
-    filePath: string;
-    /** Generated HTML content */
-    html: string;
-    /** File size in bytes */
-    fileSize: number;
-    /** Render duration in milliseconds */
-    renderDuration: number;
-    /** Number of resources discovered and rendered */
-    resourceCount: number;
-    /** Render or generation status */
-    status: RouteRenderStatus;
-    /** Why this route was rendered, skipped, or removed */
-    reason: RouteRenderReason;
-    /** Whether the output file was written during this run */
-    written: boolean;
-    /** Error message if rendering failed */
-    error?: string;
+interface RouteRenderResult {
+  /** URL path */
+  path: string;
+  /** Output file path relative to outputDir */
+  filePath: string;
+  /** Generated HTML content */
+  html: string;
+  /** File size in bytes */
+  fileSize: number;
+  /** Render duration in milliseconds */
+  renderDuration: number;
+  /** Number of resources discovered and rendered */
+  resourceCount: number;
+  /** Render or generation status */
+  status: RouteRenderStatus;
+  /** Why this route was rendered, skipped, or removed */
+  reason: RouteRenderReason;
+  /** Whether the output file was written during this run */
+  written: boolean;
+  /** Error message if rendering failed */
+  error?: string;
 }
 /** Overall result from SSG generation */
-export interface SSGResult {
-    /** ISO timestamp of generation */
-    generatedAt: string;
-    /** Total number of routes processed */
-    totalRoutes: number;
-    /** Number of successfully generated routes */
-    successful: number;
-    /** Number of failed routes */
-    failed: number;
-    /** Total generation duration in milliseconds */
-    totalDuration: number;
-    /** Effective generation mode */
-    mode: SSGMode;
-    /** Number of routes rendered during this run */
-    rebuilt: number;
-    /** Number of current routes skipped as unchanged */
-    skipped: number;
-    /** Number of stale routes removed from output */
-    removed: number;
-    /** Number of rendered routes whose HTML bytes were unchanged */
-    cacheHits: number;
-    /** Invalidation keys applied to this run */
-    invalidatedKeys: string[];
-    /** Concrete route paths applied to this run */
-    invalidatedRoutes: string[];
-    /** Per-route results */
-    routes: RouteRenderResult[];
+interface SSGResult {
+  /** ISO timestamp of generation */
+  generatedAt: string;
+  /** Total number of routes processed */
+  totalRoutes: number;
+  /** Number of successfully generated routes */
+  successful: number;
+  /** Number of failed routes */
+  failed: number;
+  /** Total generation duration in milliseconds */
+  totalDuration: number;
+  /** Effective generation mode */
+  mode: SSGMode;
+  /** Number of routes rendered during this run */
+  rebuilt: number;
+  /** Number of current routes skipped as unchanged */
+  skipped: number;
+  /** Number of stale routes removed from output */
+  removed: number;
+  /** Number of rendered routes whose HTML bytes were unchanged */
+  cacheHits: number;
+  /** Invalidation keys applied to this run */
+  invalidatedKeys: string[];
+  /** Concrete route paths applied to this run */
+  invalidatedRoutes: string[];
+  /** Per-route results */
+  routes: RouteRenderResult[];
 }
 /** Metadata to write to metadata.json */
-export interface SSGMetadata extends Record<string, unknown> {
-    /** ISO timestamp of generation */
-    generatedAt: string;
-    /** Total number of routes processed */
-    totalRoutes: number;
-    /** Number of successfully generated routes */
-    successful: number;
-    /** Number of failed routes */
-    failed: number;
-    /** Total generation duration in milliseconds */
-    totalDuration: number;
-    /** Effective generation mode */
-    mode: SSGMode;
-    /** Number of routes rendered during this run */
-    rebuilt: number;
-    /** Number of current routes skipped as unchanged */
-    skipped: number;
-    /** Number of stale routes removed from output */
-    removed: number;
-    /** Number of rendered routes whose HTML bytes were unchanged */
-    cacheHits: number;
-    /** Invalidation keys applied to this run */
-    invalidatedKeys: string[];
-    /** Concrete route paths applied to this run */
-    invalidatedRoutes: string[];
-    /** Per-route details */
-    routes: Array<{
-        /** URL path */
-        path: string;
-        /** Output file path relative to outputDir */
-        filePath: string;
-        /** File size in bytes */
-        fileSize: number;
-        /** Render duration in milliseconds */
-        renderDuration: number;
-        /** Number of resources discovered and rendered */
-        resourceCount: number;
-        /** Render or generation status */
-        status: RouteRenderStatus;
-        /** Why this route was rendered, skipped, or removed */
-        reason: RouteRenderReason;
-        /** Whether the output file was written during this run */
-        written: boolean;
-        /** Error message if rendering failed */
-        error?: string;
-    }>;
+interface SSGMetadata extends Record<string, unknown> {
+  /** ISO timestamp of generation */
+  generatedAt: string;
+  /** Total number of routes processed */
+  totalRoutes: number;
+  /** Number of successfully generated routes */
+  successful: number;
+  /** Number of failed routes */
+  failed: number;
+  /** Total generation duration in milliseconds */
+  totalDuration: number;
+  /** Effective generation mode */
+  mode: SSGMode;
+  /** Number of routes rendered during this run */
+  rebuilt: number;
+  /** Number of current routes skipped as unchanged */
+  skipped: number;
+  /** Number of stale routes removed from output */
+  removed: number;
+  /** Number of rendered routes whose HTML bytes were unchanged */
+  cacheHits: number;
+  /** Invalidation keys applied to this run */
+  invalidatedKeys: string[];
+  /** Concrete route paths applied to this run */
+  invalidatedRoutes: string[];
+  /** Per-route details */
+  routes: Array<{
+    /** URL path */path: string; /** Output file path relative to outputDir */
+    filePath: string; /** File size in bytes */
+    fileSize: number; /** Render duration in milliseconds */
+    renderDuration: number; /** Number of resources discovered and rendered */
+    resourceCount: number; /** Render or generation status */
+    status: RouteRenderStatus; /** Why this route was rendered, skipped, or removed */
+    reason: RouteRenderReason; /** Whether the output file was written during this run */
+    written: boolean; /** Error message if rendering failed */
+    error?: string;
+  }>;
 }
 /** Resource discovery result for a single route */
-export interface DiscoveredResources {
-    [key: string]: {
-        count: number;
-        dependencies: string[];
-    };
+interface DiscoveredResources {
+  [key: string]: {
+    count: number;
+    dependencies: string[];
+  };
 }
+//#endregion
+export { DiscoveredResources, RouteConfig, RouteRenderReason, RouteRenderResult, RouteRenderStatus, SSGGenerateOptions, SSGMetadata, SSGMode, SSGOptions, SSGResult };
 //# sourceMappingURL=types.d.ts.map

package/dist/ssg/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ssg/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/ssg/types.ts"],"mappings":";;;;KAWY,OAAA;AAAA,KAEA,iBAAA;AAAA,KAEA,iBAAA;;AAFZ;;;;;UAkBiB,WAAA;EAhBY;EAkB3B,IAAA;EAlB2B;EAoB3B,OAAA,GAAU,YAAA;EAJK;EAMf,SAAA,GAAY,iBAAA;;EAEZ,KAAA,GAAQ,MAAA;EAFI;EAIZ,SAAA;EAEO;EAAP,IAAA,GAAO,aAAA;EAQE;EANT,IAAA;EAsBI;EApBJ,UAAA;EAqBY;EAnBZ,QAAA,YAAoB,WAAA;EAmBT;EAjBX,MAAA,GAAS,MAAA;EAlBT;EAoBA,gBAAA;EAlBU;;;;;;;;;;;;EA+BV,OAAA,SACI,KAAA,CAAM,MAAA,oBACN,OAAA,CAAQ,KAAA,CAAM,MAAA;AAAA;;UAIH,UAAA;EALX;EAOJ,MAAA,EAAQ,WAAA;EANJ;EAQJ,SAAA;EARkB;EAUlB,IAAA;EAVwB;EAYxB,aAAA,GAAgB,MAAA;EARS;EAUzB,WAAA;EAFsB;EAItB,WAAA;AAAA;;UAIe,kBAAA;EARf;EAUA,IAAA,GAAO,OAAA;EARP;EAUA,WAAA;EARW;EAUX,aAAA;EANe;EAQf,SAAA;AAAA;;UAIe,iBAAA;EAVR;EAYP,IAAA;EARA;EAUA,QAAA;EARS;EAUT,IAAA;EANe;EAQf,QAAA;;EAEA,cAAA;EARA;EAUA,aAAA;EANA;EAQA,MAAA,EAAQ,iBAAA;EAJR;EAMA,MAAA,EAAQ,iBAAA;EAFR;EAIA,OAAA;EAFA;EAIA,KAAA;AAAA;;UAIe,SAAA;EAJV;EAML,WAAA;EAFwB;EAIxB,WAAA;EAsByB;EApBzB,UAAA;EAFA;EAIA,MAAA;EAAA;EAEA,aAAA;EAEA;EAAA,IAAA,EAAM,OAAA;EAEN;EAAA,OAAA;EAIA;EAFA,OAAA;EAMA;EAJA,OAAA;EAQA;EANA,SAAA;EAMyB;EAJzB,eAAA;EAQe;EANf,iBAAA;;EAEA,MAAA,EAAQ,iBAAA;AAAA;;UAIO,WAAA,SAAoB,MAAA;EAAA;EAEnC,WAAA;EAFyC;EAIzC,WAAA;EAFA;EAIA,UAAA;EAAA;EAEA,MAAA;EAEA;EAAA,aAAA;EAEM;EAAN,IAAA,EAAM,OAAA;EAIN;EAFA,OAAA;EAMA;EAJA,OAAA;EAQA;EANA,OAAA;EAQQ;EANR,SAAA;EAUE;EARF,eAAA;EAYE;EAVF,iBAAA;EAcE;EAZF,MAAA,EAAQ,KAAA;IAcN,eAZA,IAAA,UAcA;IAZA,QAAA,UAcK;IAZL,QAAA,UAiBa;IAfb,cAAA,UAegC;IAbhC,aAAA,UAcD;IAZC,MAAA,EAAQ,iBAAA,EAcR;IAZA,MAAA,EAAQ,iBAAA,EAYI;IAVZ,OAAA;IAEA,KAAA;EAAA;AAAA;;UAKa,mBAAA;EAAA,CACd,GAAA;IACC,KAAA;IACA,YAAA;EAAA;AAAA"}

package/dist/ssg/write-static-files.d.ts

@@ -1,21 +1,15 @@
-/**
- * File I/O for Static Site Generation
- *
- * Uses Node.js fs/path modules to write rendered HTML files to disk.
- * This module is Node-only and not intended for browser builds.
- */
-import type { RouteRenderResult } from './types';
+import { RouteRenderResult } from "./types.js";
+import { getOutputFilePath } from "./route-utils.js";
+
+//#region src/ssg/write-static-files.d.ts
 interface WriteStaticFilesOptions {
-    concurrency?: number;
+  concurrency?: number;
 }
 /**
  * Write rendered routes to disk
  * Creates outputDir/{route-path}/index.html structure
  */
-export declare function writeStaticFiles(results: RouteRenderResult[], outputDir: string, options?: WriteStaticFilesOptions): Promise<void>;
-/**
- * Get the output file path for a route
- * E.g., "/blog/post" -> "blog/post" or "/" -> ""
- */
-export { getOutputFilePath } from './route-utils';
+declare function writeStaticFiles(results: RouteRenderResult[], outputDir: string, options?: WriteStaticFilesOptions): Promise<void>;
+//#endregion
+export { writeStaticFiles };
 //# sourceMappingURL=write-static-files.d.ts.map

package/dist/ssg/write-static-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-static-files.d.ts","sourceRoot":"","sources":["../../src/ssg/write-static-files.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,UAAU,uBAAuB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,EAAE,EAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"write-static-files.d.ts","names":[],"sources":["../../src/ssg/write-static-files.ts"],"mappings":";;;;UAYU,uBAAA;EACR,WAAA;AAAA;;;;;iBAOoB,gBAAA,CACpB,OAAA,EAAS,iBAAA,IACT,SAAA,UACA,OAAA,GAAS,uBAAA,GACR,OAAA"}