@askrjs/askr 0.0.39 → 0.0.41

package/dist/runtime/state.js.map

@@ -1 +1 @@
-{"version":3,"file":"state.js","names":[],"sources":["../../src/runtime/state.ts"],"sourcesContent":["/**\n * State primitive for Askr components\n * Optimized for minimal overhead and fast updates\n *\n * INVARIANTS ENFORCED:\n * - state() only callable during component render (currentInstance exists)\n * - state() called at top-level only (indices must be monotonically increasing)\n * - state values persist across re-renders (stored in stateValues array)\n * - state.set() cannot be called during render (causes infinite loops)\n * - state.set() always enqueues through scheduler (never direct mutation)\n * - state.set() callback (notifyUpdate) always available\n */\n\nimport {\n  claimHookIndex,\n  getCurrentInstance,\n  type ComponentInstance,\n} from './component';\nimport { isBulkCommitActive } from './fastlane';\nimport {\n  recordReadableRead,\n  type ReadableSource,\n  markReadableDerivedSubscribersDirty,\n  markReactivePropsDirtySource,\n  notifyReadableReaders,\n} from './readable';\n\n/**\n * State value holder - callable to read, has set method to update\n * @example\n * const count = state(0);\n * count();           // read: 0\n * count.set(1);      // write: triggers re-render\n */\nexport interface State<T> extends ReadableSource<T> {\n  (): T;\n  set(value: T): void;\n  set(updater: (prev: T) => T): void;\n  [Symbol.iterator](): IterableIterator<StateTuple<T>[number]>; // Allows destructuring: const [get, set] = state(0)\n}\n\n/**\n * Public setter type for state cells.\n */\nexport type StateSetter<T> = State<T>['set'];\n\n/**\n * Tuple-first state handle returned by `state()`.\n */\nexport type StateTuple<T> = [get: State<T>, set: StateSetter<T>] & State<T>;\n\n/**\n * Creates a local state value for a component\n * Optimized for:\n * - O(1) read performance\n * - Minimal allocation per state\n * - Fast scheduler integration\n *\n * IMPORTANT: state() must be called during component render execution.\n * It captures the current component instance from context.\n * Calling outside a component function will throw an error.\n *\n * @example\n * ```ts\n * // ✅ Correct: called during render\n * export function Counter() {\n *   const [count, setCount] = state(0);\n *   return { type: 'button', children: [count()] };\n * }\n *\n * // ❌ Wrong: called outside component\n * const count = state(0);\n * export function BadComponent() {\n *   return { type: 'div' };\n * }\n * ```\n */\nexport function state<T>(initialValue: T): StateTuple<T> {\n  // INVARIANT: state() must be called during component render\n  const instance = getCurrentInstance();\n  if (!instance) {\n    throw new Error(\n      'state() can only be called during component render execution. ' +\n        'Move state() calls to the top level of your component function.'\n    );\n  }\n\n  const index = claimHookIndex(instance, 'state');\n  const stateValues = instance.stateValues;\n\n  // INVARIANT: Reuse existing state if it exists (fast path on re-renders)\n  // This ensures state identity and persistence and enforces ownership stability\n  if (stateValues[index]) {\n    const existing = stateValues[index] as State<T> & {\n      _owner?: ComponentInstance;\n    };\n    // Ownership must be stable: the state cell belongs to the instance that\n    // created it and must never change. This checks for accidental reuse.\n    if (existing._owner !== instance) {\n      throw new Error(\n        `State ownership violation: state() called at index ${index} is owned by a different component instance. ` +\n          `State ownership is positional and immutable.`\n      );\n    }\n    return existing as StateTuple<T>;\n  }\n\n  // Create new state (slow path, only on first render) — delegated to helper\n  const cell = createStateCell(initialValue, instance);\n\n  // INVARIANT: Store state in instance for persistence across renders\n  stateValues[index] = cell;\n\n  return cell as StateTuple<T>;\n}\n\n/**\n * Internal helper: create the backing state cell (value + readers + set semantics)\n * This extraction makes it easier to later split hook wiring from storage.\n */\nfunction createStateCell<T>(\n  initialValue: T,\n  instance: ComponentInstance\n): State<T> {\n  let value = initialValue;\n\n  // Per-state reader map: component -> last-committed render token\n  const readers = new Map<ComponentInstance, number>();\n\n  // Use a function as the state object (callable directly)\n  function read(): T {\n    (read as State<T>)._hasBeenRead = true;\n    recordReadableRead(read as State<T>);\n\n    return value;\n  }\n\n  // Attach the readers map to the callable so other runtime parts can access it\n  (read as State<T>)._readers = readers;\n\n  // Record explicit ownership of this state cell. Ownership is the component\n  // instance that created the state cell and must never change for the life\n  // of the cell. We expose this for runtime invariant checks/tests.\n  (read as State<T> & { _owner?: ComponentInstance })._owner = instance;\n\n  // Attach set method directly to function\n  read.set = (newValueOrUpdater: T | ((prev: T) => T)): void => {\n    // INVARIANT: State cannot be mutated during component render\n    // (when currentInstance is non-null). It must be scheduled for consistency.\n    const currentInst = getCurrentInstance();\n    if (currentInst !== null) {\n      throw new Error(\n        `[Askr] state.set() cannot be called during component render. ` +\n          `State mutations during render break the actor model and cause infinite loops. ` +\n          `Move state updates to event handlers or use conditional rendering instead.`\n      );\n    }\n\n    // Compute new value if an updater was provided\n    let newValue: T;\n    if (typeof newValueOrUpdater === 'function') {\n      // Note: function-valued state cannot be set directly via a function argument;\n      // such an argument is treated as a functional updater (this follows the common\n      // convention from other libraries). If you need to store a function as state,\n      // wrap it in an object.\n      const updater = newValueOrUpdater as (prev: T) => T;\n      newValue = updater(value);\n    } else {\n      newValue = newValueOrUpdater as T;\n    }\n\n    // Skip work if value didn't change\n    if (Object.is(value, newValue)) return;\n\n    // If a bulk commit is active, update backing value only and DO NOT notify or enqueue.\n    // Bulk commits must be side-effect silent with respect to runtime notifications.\n    if (isBulkCommitActive()) {\n      // In bulk commit mode we must be side-effect free: update backing\n      // value only and do not notify, enqueue, or log.\n      value = newValue;\n      return;\n    }\n\n    // INVARIANT: Update the value\n    value = newValue;\n\n    markReadableDerivedSubscribersDirty(read as State<T>);\n    markReactivePropsDirtySource(read as State<T>);\n\n    // notifyUpdate may be temporarily unavailable (e.g. during hydration).\n    // We intentionally avoid logging here to keep the state mutation path\n    // side-effect free. The scheduler will process updates when the system\n    // is stable.\n    // After value change, notify only components that *read* this state in their last committed render.\n    void notifyReadableReaders(read as State<T>);\n  };\n\n  // Allow destructuring assignment: const [get, set] = state(0);\n  // The state function is iterable and yields the getter then the setter\n  (\n    read as unknown as {\n      [Symbol.iterator]?: () => Iterator<State<T> | State<T>['set']>;\n    }\n  )[Symbol.iterator] = function* (): Generator<\n    State<T> | State<T>['set'],\n    void,\n    unknown\n  > {\n    yield read;\n    yield read.set;\n  };\n\n  return read as State<T>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6EA,SAAgB,MAAS,cAAgC;CAEvD,MAAM,WAAW,oBAAoB;CACrC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,gIAED;CAGH,MAAM,QAAQ,eAAe,UAAU,QAAQ;CAC/C,MAAM,cAAc,SAAS;CAI7B,IAAI,YAAY,QAAQ;EACtB,MAAM,WAAW,YAAY;EAK7B,IAAI,SAAS,WAAW,UACtB,MAAM,IAAI,MACR,sDAAsD,MAAM,2FAE7D;EAEH,OAAO;;CAIT,MAAM,OAAO,gBAAgB,cAAc,SAAS;CAGpD,YAAY,SAAS;CAErB,OAAO;;;;;;AAOT,SAAS,gBACP,cACA,UACU;CACV,IAAI,QAAQ;CAGZ,MAAM,0BAAU,IAAI,KAAgC;CAGpD,SAAS,OAAU;EACjB,KAAmB,eAAe;EAClC,mBAAmB,KAAiB;EAEpC,OAAO;;CAIT,KAAmB,WAAW;CAK9B,KAAoD,SAAS;CAG7D,KAAK,OAAO,sBAAkD;EAI5D,IADoB,oBAChB,KAAgB,MAClB,MAAM,IAAI,MACR,wNAGD;EAIH,IAAI;EACJ,IAAI,OAAO,sBAAsB,YAM/B,WAAW,kBAAQ,MAAM;OAEzB,WAAW;EAIb,IAAI,OAAO,GAAG,OAAO,SAAS,EAAE;EAIhC,IAAI,oBAAoB,EAAE;GAGxB,QAAQ;GACR;;EAIF,QAAQ;EAER,oCAAoC,KAAiB;EACrD,6BAA6B,KAAiB;EAO9C,AAAK,sBAAsB,KAAiB;;CAK9C,KAIE,OAAO,YAAY,aAInB;EACA,MAAM;EACN,MAAM,KAAK;;CAGb,OAAO"}
+{"version":3,"file":"state.js","names":[],"sources":["../../src/runtime/state.ts"],"sourcesContent":["/**\n * State primitive for Askr components\n * Optimized for minimal overhead and fast updates\n *\n * INVARIANTS ENFORCED:\n * - state() only callable during component render (currentInstance exists)\n * - state() called at top-level only (indices must be monotonically increasing)\n * - state values persist across re-renders (stored in stateValues array)\n * - state.set() cannot be called during render (causes infinite loops)\n * - state.set() always enqueues through scheduler (never direct mutation)\n * - state.set() callback (notifyUpdate) always available\n */\n\nimport {\n  claimHookIndex,\n  getCurrentInstance,\n  type ComponentInstance,\n} from './component';\nimport { isBulkCommitActive } from './fastlane';\nimport {\n  recordReadableRead,\n  type ReadableSource,\n  markReadableDerivedSubscribersDirty,\n  markReactivePropsDirtySource,\n  notifyReadableReaders,\n} from './readable';\n\n/**\n * State value holder - callable to read, has set method to update\n * @example\n * const count = state(0);\n * count();           // read: 0\n * count.set(1);      // write: triggers re-render\n */\nexport interface State<T> extends ReadableSource<T> {\n  (): T;\n  set(...args: StateSetterArgs<T>): void;\n  [Symbol.iterator](): IterableIterator<StateTuple<T>[number]>; // Allows destructuring: const [get, set] = state(0)\n}\n\ntype StateUpdater<T> = (prev: T) => T;\n\ntype StateSetterArgs<T> = [Extract<T, (...args: any[]) => unknown>] extends [\n  never,\n]\n  ? [value: T] | [updater: StateUpdater<T>]\n  : [updater: StateUpdater<T>];\n\n/**\n * Public setter type for state cells.\n */\nexport type StateSetter<T> = (...args: StateSetterArgs<T>) => void;\n\n/**\n * Tuple-first state handle returned by `state()`.\n */\nexport type StateTuple<T> = [get: State<T>, set: StateSetter<T>] & State<T>;\n\n/**\n * Creates a local state value for a component\n * Optimized for:\n * - O(1) read performance\n * - Minimal allocation per state\n * - Fast scheduler integration\n *\n * IMPORTANT: state() must be called during component render execution.\n * It captures the current component instance from context.\n * Calling outside a component function will throw an error.\n *\n * @example\n * ```ts\n * // ✅ Correct: called during render\n * export function Counter() {\n *   const [count, setCount] = state(0);\n *   return { type: 'button', children: [count()] };\n * }\n *\n * // ❌ Wrong: called outside component\n * const count = state(0);\n * export function BadComponent() {\n *   return { type: 'div' };\n * }\n * ```\n */\nexport function state<T>(initialValue: T): StateTuple<T> {\n  // INVARIANT: state() must be called during component render\n  const instance = getCurrentInstance();\n  if (!instance) {\n    throw new Error(\n      'state() can only be called during component render execution. ' +\n        'Move state() calls to the top level of your component function.'\n    );\n  }\n\n  const index = claimHookIndex(instance, 'state');\n  const stateValues = instance.stateValues;\n\n  // INVARIANT: Reuse existing state if it exists (fast path on re-renders)\n  // This ensures state identity and persistence and enforces ownership stability\n  if (stateValues[index]) {\n    const existing = stateValues[index] as State<T> & {\n      _owner?: ComponentInstance;\n    };\n    // Ownership must be stable: the state cell belongs to the instance that\n    // created it and must never change. This checks for accidental reuse.\n    if (existing._owner !== instance) {\n      throw new Error(\n        `State ownership violation: state() called at index ${index} is owned by a different component instance. ` +\n          `State ownership is positional and immutable.`\n      );\n    }\n    return existing as StateTuple<T>;\n  }\n\n  // Create new state (slow path, only on first render) — delegated to helper\n  const cell = createStateCell(initialValue, instance);\n\n  // INVARIANT: Store state in instance for persistence across renders\n  stateValues[index] = cell as unknown as State<unknown>;\n\n  return cell as StateTuple<T>;\n}\n\n/**\n * Internal helper: create the backing state cell (value + readers + set semantics)\n * This extraction makes it easier to later split hook wiring from storage.\n */\nfunction createStateCell<T>(\n  initialValue: T,\n  instance: ComponentInstance\n): State<T> {\n  let value = initialValue;\n\n  // Per-state reader map: component -> last-committed render token\n  const readers = new Map<ComponentInstance, number>();\n\n  // Use a function as the state object (callable directly)\n  function read(): T {\n    (read as State<T>)._hasBeenRead = true;\n    recordReadableRead(read as State<T>);\n\n    return value;\n  }\n\n  // Attach the readers map to the callable so other runtime parts can access it\n  (read as State<T>)._readers = readers;\n\n  // Record explicit ownership of this state cell. Ownership is the component\n  // instance that created the state cell and must never change for the life\n  // of the cell. We expose this for runtime invariant checks/tests.\n  (read as State<T> & { _owner?: ComponentInstance })._owner = instance;\n\n  // Attach set method directly to function\n  read.set = (newValueOrUpdater: T | ((prev: T) => T)): void => {\n    // INVARIANT: State cannot be mutated during component render\n    // (when currentInstance is non-null). It must be scheduled for consistency.\n    const currentInst = getCurrentInstance();\n    if (currentInst !== null) {\n      throw new Error(\n        `[Askr] state.set() cannot be called during component render. ` +\n          `State mutations during render break the actor model and cause infinite loops. ` +\n          `Move state updates to event handlers or use conditional rendering instead.`\n      );\n    }\n\n    // Compute new value if an updater was provided\n    let newValue: T;\n    if (typeof newValueOrUpdater === 'function') {\n      // Note: function-valued state cannot be set directly via a function argument;\n      // such an argument is treated as a functional updater (this follows the common\n      // convention from other libraries). If you need to store a function as state,\n      // wrap it in an object.\n      const updater = newValueOrUpdater as (prev: T) => T;\n      newValue = updater(value);\n    } else {\n      newValue = newValueOrUpdater as T;\n    }\n\n    // Skip work if value didn't change\n    if (Object.is(value, newValue)) return;\n\n    // If a bulk commit is active, update backing value only and DO NOT notify or enqueue.\n    // Bulk commits must be side-effect silent with respect to runtime notifications.\n    if (isBulkCommitActive()) {\n      // In bulk commit mode we must be side-effect free: update backing\n      // value only and do not notify, enqueue, or log.\n      value = newValue;\n      return;\n    }\n\n    // INVARIANT: Update the value\n    value = newValue;\n\n    markReadableDerivedSubscribersDirty(read as State<T>);\n    markReactivePropsDirtySource(read as State<T>);\n\n    // notifyUpdate may be temporarily unavailable (e.g. during hydration).\n    // We intentionally avoid logging here to keep the state mutation path\n    // side-effect free. The scheduler will process updates when the system\n    // is stable.\n    // After value change, notify only components that *read* this state in their last committed render.\n    void notifyReadableReaders(read as State<T>);\n  };\n\n  // Allow destructuring assignment: const [get, set] = state(0);\n  // The state function is iterable and yields the getter then the setter\n  (\n    read as unknown as {\n      [Symbol.iterator]?: () => Iterator<State<T> | State<T>['set']>;\n    }\n  )[Symbol.iterator] = function* (): Generator<\n    State<T> | State<T>['set'],\n    void,\n    unknown\n  > {\n    yield read;\n    yield read.set;\n  };\n\n  return read as State<T>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoFA,SAAgB,MAAS,cAAgC;CAEvD,MAAM,WAAW,mBAAmB;CACpC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,+HAEF;CAGF,MAAM,QAAQ,eAAe,UAAU,OAAO;CAC9C,MAAM,cAAc,SAAS;CAI7B,IAAI,YAAY,QAAQ;EACtB,MAAM,WAAW,YAAY;EAK7B,IAAI,SAAS,WAAW,UACtB,MAAM,IAAI,MACR,sDAAsD,MAAM,0FAE9D;EAEF,OAAO;CACT;CAGA,MAAM,OAAO,gBAAgB,cAAc,QAAQ;CAGnD,YAAY,SAAS;CAErB,OAAO;AACT;;;;;AAMA,SAAS,gBACP,cACA,UACU;CACV,IAAI,QAAQ;CAGZ,MAAM,0BAAU,IAAI,IAA+B;CAGnD,SAAS,OAAU;EACjB,KAAmB,eAAe;EAClC,mBAAmB,IAAgB;EAEnC,OAAO;CACT;CAGA,KAAmB,WAAW;CAK9B,KAAoD,SAAS;CAG7D,KAAK,OAAO,sBAAkD;EAI5D,IADoB,mBAChB,MAAgB,MAClB,MAAM,IAAI,MACR,uNAGF;EAIF,IAAI;EACJ,IAAI,OAAO,sBAAsB,YAM/B,WAAW,kBAAQ,KAAK;OAExB,WAAW;EAIb,IAAI,OAAO,GAAG,OAAO,QAAQ,GAAG;EAIhC,IAAI,mBAAmB,GAAG;GAGxB,QAAQ;GACR;EACF;EAGA,QAAQ;EAER,oCAAoC,IAAgB;EACpD,6BAA6B,IAAgB;EAO7C,AAAK,sBAAsB,IAAgB;CAC7C;CAIA,KAIE,OAAO,YAAY,aAInB;EACA,MAAM;EACN,MAAM,KAAK;CACb;CAEA,OAAO;AACT"}

package/dist/ssg/batch-render.js

@@ -1,4 +1,4 @@
-import { renderResolvedToStringSync } from "../ssr/index.js";
+import { renderToString } from "../ssr/index.js";
 import { getOutputFilePath, interpolateRoutePath } from "./route-utils.js";
 //#region src/ssg/batch-render.ts
 /**
@@ -25,19 +25,15 @@ async function batchRenderRoutes(routes, options = {}) {
 			}, ctx);
 		};
 		try {
-			const html = renderResolvedToStringSync({
+			const html = renderToString({
 				url,
 				routes: [{
 					path: route.path,
 					handler: mergedHandler,
 					namespace: route.namespace
 				}],
-				handler: mergedHandler,
-				params: route.params,
-				options: {
-					seed,
-					data: baseData
-				}
+				seed,
+				data: baseData
 			});
 			const duration = performance.now() - startTime;
 			return {

package/dist/ssg/batch-render.js.map

@@ -1 +1 @@
-{"version":3,"file":"batch-render.js","names":[],"sources":["../../src/ssg/batch-render.ts"],"sourcesContent":["/**\n * Batch rendering of multiple routes for SSG\n */\n\nimport { renderResolvedToStringSync } from '../ssr';\nimport type { RouteConfig, RouteRenderResult } from './types';\nimport type { RouteHandler } from '../common/router';\nimport type { ComponentFunction } from '../common/component';\nimport type { SSRData } from '../common/ssr';\nimport { getOutputFilePath, interpolateRoutePath } from './route-utils';\n\ninterface BatchRenderOptions {\n  seed?: number;\n  dataMap?: Record<string, SSRData>;\n  concurrency?: number;\n}\n\n/**\n * Render multiple routes in parallel with error handling\n */\nexport async function batchRenderRoutes(\n  routes: RouteConfig[],\n  options: BatchRenderOptions = {}\n): Promise<RouteRenderResult[]> {\n  const { seed = 12345, dataMap = {}, concurrency = 1 } = options;\n\n  const workerCount = Math.max(1, Math.min(concurrency, routes.length || 1));\n  const results: RouteRenderResult[] = [];\n  results.length = routes.length;\n  let nextIndex = 0;\n\n  const renderOne = async (route: RouteConfig): Promise<RouteRenderResult> => {\n    const startTime = performance.now();\n    const url = interpolateRoutePath(route.path, route.params);\n    const baseData = dataMap[route.path] ?? dataMap[url] ?? {};\n\n    const mergedHandler: RouteHandler = route.handler\n      ? route.handler\n      : (params, ctx?: unknown) => {\n          const component = route.component as ComponentFunction;\n          return component(\n            { ...route.props, ...params },\n            ctx as { signal: AbortSignal; ssr?: unknown }\n          );\n        };\n\n    try {\n      const routeEntry = {\n        path: route.path,\n        handler: mergedHandler,\n        namespace: route.namespace,\n      };\n\n      const html = renderResolvedToStringSync({\n        url,\n        routes: [routeEntry],\n        handler: mergedHandler,\n        params: route.params,\n        options: {\n          seed,\n          data: baseData,\n        },\n      });\n\n      const duration = performance.now() - startTime;\n      return {\n        path: url,\n        filePath: getOutputFilePath(url),\n        html,\n        fileSize: Buffer.byteLength(html, 'utf8'),\n        renderDuration: Math.round(duration),\n        resourceCount: Object.keys(baseData).length,\n        status: 'success',\n        reason: 'full',\n        written: false,\n      };\n    } catch (error) {\n      const duration = performance.now() - startTime;\n      return {\n        path: url,\n        filePath: getOutputFilePath(url),\n        html: '',\n        fileSize: 0,\n        renderDuration: Math.round(duration),\n        resourceCount: Object.keys(baseData).length,\n        status: 'error',\n        reason: 'full',\n        written: false,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  };\n\n  const worker = async () => {\n    while (true) {\n      const current = nextIndex;\n      nextIndex += 1;\n      if (current >= routes.length) return;\n      results[current] = await renderOne(routes[current]);\n    }\n  };\n\n  await Promise.all(Array.from({ length: workerCount }, () => worker()));\n  return results;\n}\n"],"mappings":";;;;;;;;;AAoBA,eAAsB,kBACpB,QACA,UAA8B,EAAE,EACF;CAC9B,MAAM,EAAE,OAAO,OAAO,UAAU,EAAE,EAAE,cAAc,MAAM;CAExD,MAAM,cAAc,KAAK,IAAI,GAAG,KAAK,IAAI,aAAa,OAAO,UAAU,EAAE,CAAC;CAC1E,MAAM,UAA+B,EAAE;CACvC,QAAQ,SAAS,OAAO;CACxB,IAAI,YAAY;CAEhB,MAAM,YAAY,OAAO,UAAmD;EAC1E,MAAM,YAAY,YAAY,KAAK;EACnC,MAAM,MAAM,qBAAqB,MAAM,MAAM,MAAM,OAAO;EAC1D,MAAM,WAAW,QAAQ,MAAM,SAAS,QAAQ,QAAQ,EAAE;EAE1D,MAAM,gBAA8B,MAAM,UACtC,MAAM,WACL,QAAQ,QAAkB;GACzB,MAAM,YAAY,MAAM;GACxB,OAAO,UACL;IAAE,GAAG,MAAM;IAAO,GAAG;IAAQ,EAC7B,IACD;;EAGP,IAAI;GAOF,MAAM,OAAO,2BAA2B;IACtC;IACA,QAAQ,CAAC;KAPT,MAAM,MAAM;KACZ,SAAS;KACT,WAAW,MAAM;KAKR,CAAW;IACpB,SAAS;IACT,QAAQ,MAAM;IACd,SAAS;KACP;KACA,MAAM;KACP;IACF,CAAC;GAEF,MAAM,WAAW,YAAY,KAAK,GAAG;GACrC,OAAO;IACL,MAAM;IACN,UAAU,kBAAkB,IAAI;IAChC;IACA,UAAU,OAAO,WAAW,MAAM,OAAO;IACzC,gBAAgB,KAAK,MAAM,SAAS;IACpC,eAAe,OAAO,KAAK,SAAS,CAAC;IACrC,QAAQ;IACR,QAAQ;IACR,SAAS;IACV;WACM,OAAO;GACd,MAAM,WAAW,YAAY,KAAK,GAAG;GACrC,OAAO;IACL,MAAM;IACN,UAAU,kBAAkB,IAAI;IAChC,MAAM;IACN,UAAU;IACV,gBAAgB,KAAK,MAAM,SAAS;IACpC,eAAe,OAAO,KAAK,SAAS,CAAC;IACrC,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;IAC9D;;;CAIL,MAAM,SAAS,YAAY;EACzB,OAAO,MAAM;GACX,MAAM,UAAU;GAChB,aAAa;GACb,IAAI,WAAW,OAAO,QAAQ;GAC9B,QAAQ,WAAW,MAAM,UAAU,OAAO,SAAS;;;CAIvD,MAAM,QAAQ,IAAI,MAAM,KAAK,EAAE,QAAQ,aAAa,QAAQ,QAAQ,CAAC,CAAC;CACtE,OAAO"}
+{"version":3,"file":"batch-render.js","names":[],"sources":["../../src/ssg/batch-render.ts"],"sourcesContent":["/**\n * Batch rendering of multiple routes for SSG\n */\n\nimport { renderToString } from '../ssr';\nimport type { RouteConfig, RouteRenderResult } from './types';\nimport type { RouteHandler } from '../common/router';\nimport type { ComponentFunction } from '../common/component';\nimport type { SSRData } from '../common/ssr';\nimport { getOutputFilePath, interpolateRoutePath } from './route-utils';\n\ninterface BatchRenderOptions {\n  seed?: number;\n  dataMap?: Record<string, SSRData>;\n  concurrency?: number;\n}\n\n/**\n * Render multiple routes in parallel with error handling\n */\nexport async function batchRenderRoutes(\n  routes: RouteConfig[],\n  options: BatchRenderOptions = {}\n): Promise<RouteRenderResult[]> {\n  const { seed = 12345, dataMap = {}, concurrency = 1 } = options;\n\n  const workerCount = Math.max(1, Math.min(concurrency, routes.length || 1));\n  const results: RouteRenderResult[] = [];\n  results.length = routes.length;\n  let nextIndex = 0;\n\n  const renderOne = async (route: RouteConfig): Promise<RouteRenderResult> => {\n    const startTime = performance.now();\n    const url = interpolateRoutePath(route.path, route.params);\n    const baseData = dataMap[route.path] ?? dataMap[url] ?? {};\n\n    const mergedHandler: RouteHandler = route.handler\n      ? route.handler\n      : (params, ctx?: unknown) => {\n          const component = route.component as ComponentFunction;\n          return component(\n            { ...route.props, ...params },\n            ctx as { signal: AbortSignal; ssr?: unknown }\n          );\n        };\n\n    try {\n      const routeEntry = {\n        path: route.path,\n        handler: mergedHandler,\n        namespace: route.namespace,\n      };\n\n      const html = renderToString({\n        url,\n        routes: [routeEntry],\n        seed,\n        data: baseData,\n      });\n\n      const duration = performance.now() - startTime;\n      return {\n        path: url,\n        filePath: getOutputFilePath(url),\n        html,\n        fileSize: Buffer.byteLength(html, 'utf8'),\n        renderDuration: Math.round(duration),\n        resourceCount: Object.keys(baseData).length,\n        status: 'success',\n        reason: 'full',\n        written: false,\n      };\n    } catch (error) {\n      const duration = performance.now() - startTime;\n      return {\n        path: url,\n        filePath: getOutputFilePath(url),\n        html: '',\n        fileSize: 0,\n        renderDuration: Math.round(duration),\n        resourceCount: Object.keys(baseData).length,\n        status: 'error',\n        reason: 'full',\n        written: false,\n        error: error instanceof Error ? error.message : String(error),\n      };\n    }\n  };\n\n  const worker = async () => {\n    while (true) {\n      const current = nextIndex;\n      nextIndex += 1;\n      if (current >= routes.length) return;\n      results[current] = await renderOne(routes[current]);\n    }\n  };\n\n  await Promise.all(Array.from({ length: workerCount }, () => worker()));\n  return results;\n}\n"],"mappings":";;;;;;;;;AAoBA,eAAsB,kBACpB,QACA,UAA8B,CAAC,GACD;CAC9B,MAAM,EAAE,OAAO,OAAO,UAAU,CAAC,GAAG,cAAc,MAAM;CAExD,MAAM,cAAc,KAAK,IAAI,GAAG,KAAK,IAAI,aAAa,OAAO,UAAU,CAAC,CAAC;CACzE,MAAM,UAA+B,CAAC;CACtC,QAAQ,SAAS,OAAO;CACxB,IAAI,YAAY;CAEhB,MAAM,YAAY,OAAO,UAAmD;EAC1E,MAAM,YAAY,YAAY,IAAI;EAClC,MAAM,MAAM,qBAAqB,MAAM,MAAM,MAAM,MAAM;EACzD,MAAM,WAAW,QAAQ,MAAM,SAAS,QAAQ,QAAQ,CAAC;EAEzD,MAAM,gBAA8B,MAAM,UACtC,MAAM,WACL,QAAQ,QAAkB;GACzB,MAAM,YAAY,MAAM;GACxB,OAAO,UACL;IAAE,GAAG,MAAM;IAAO,GAAG;GAAO,GAC5B,GACF;EACF;EAEJ,IAAI;GAOF,MAAM,OAAO,eAAe;IAC1B;IACA,QAAQ,CAAC;KAPT,MAAM,MAAM;KACZ,SAAS;KACT,WAAW,MAAM;IAKR,CAAU;IACnB;IACA,MAAM;GACR,CAAC;GAED,MAAM,WAAW,YAAY,IAAI,IAAI;GACrC,OAAO;IACL,MAAM;IACN,UAAU,kBAAkB,GAAG;IAC/B;IACA,UAAU,OAAO,WAAW,MAAM,MAAM;IACxC,gBAAgB,KAAK,MAAM,QAAQ;IACnC,eAAe,OAAO,KAAK,QAAQ,EAAE;IACrC,QAAQ;IACR,QAAQ;IACR,SAAS;GACX;EACF,SAAS,OAAO;GACd,MAAM,WAAW,YAAY,IAAI,IAAI;GACrC,OAAO;IACL,MAAM;IACN,UAAU,kBAAkB,GAAG;IAC/B,MAAM;IACN,UAAU;IACV,gBAAgB,KAAK,MAAM,QAAQ;IACnC,eAAe,OAAO,KAAK,QAAQ,EAAE;IACrC,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAC9D;EACF;CACF;CAEA,MAAM,SAAS,YAAY;EACzB,OAAO,MAAM;GACX,MAAM,UAAU;GAChB,aAAa;GACb,IAAI,WAAW,OAAO,QAAQ;GAC9B,QAAQ,WAAW,MAAM,UAAU,OAAO,QAAQ;EACpD;CACF;CAEA,MAAM,QAAQ,IAAI,MAAM,KAAK,EAAE,QAAQ,YAAY,SAAS,OAAO,CAAC,CAAC;CACrE,OAAO;AACT"}

package/dist/ssg/create-static-gen.d.ts

@@ -1,6 +1,12 @@
-import { SSGGenerateOptions, SSGOptions, SSGResult } from "./types.js";
+import { RouteConfig, SSGGenerateOptions, SSGOptions, SSGResult } from "./types.js";
 
 //#region src/ssg/create-static-gen.d.ts
+type AnyRouteConfig = RouteConfig<string>;
+type StrictRouteConfig<TRoute extends AnyRouteConfig> = Omit<TRoute, 'params' | 'entries'> & {
+  params?: RouteConfig<TRoute['path']>['params'];
+  entries?: RouteConfig<TRoute['path']>['entries'];
+};
+type StrictRouteConfigs<TRoutes extends readonly AnyRouteConfig[]> = { [TIndex in keyof TRoutes]: TRoutes[TIndex] extends AnyRouteConfig ? StrictRouteConfig<TRoutes[TIndex]> : never };
 /**
  * Create a Static Site Generator
  *
@@ -21,7 +27,9 @@ import { SSGGenerateOptions, SSGOptions, SSGResult } from "./types.js";
  * console.log(`Generated ${result.successful}/${result.totalRoutes} routes`);
  * ```
  */
-declare function createStaticGen(options: SSGOptions): {
+declare function createStaticGen<const TRoutes extends readonly AnyRouteConfig[]>(options: Omit<SSGOptions<TRoutes>, 'routes'> & {
+  routes: TRoutes & StrictRouteConfigs<TRoutes>;
+}): {
   /**
    * Generate static HTML for all routes
    * Writes to outputDir with metadata.json

package/dist/ssg/create-static-gen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-static-gen.d.ts","names":[],"sources":["../../src/ssg/create-static-gen.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;iBAkHgB,eAAA,CAAgB,OAAA,EAAS,UAAA;;;;;;6BAwBlB,kBAAA,GAChB,OAAA,CAAQ,SAAA;;;;;;;;;;;;;;;;eAmPE,SAAA;AAAA"}
+{"version":3,"file":"create-static-gen.d.ts","names":[],"sources":["../../src/ssg/create-static-gen.ts"],"mappings":";;;KA2CK,cAAA,GAAiB,WAAW;AAAA,KAE5B,iBAAA,gBAAiC,cAAA,IAAkB,IAAA,CACtD,MAAA;EAGA,MAAA,GAAS,WAAA,CAAY,MAAA;EACrB,OAAA,GAAU,WAAA,CAAY,MAAA;AAAA;AAAA,KAGnB,kBAAA,0BAA4C,cAAA,yBAC9B,OAAA,GAAU,OAAA,CAAQ,MAAA,UAAgB,cAAA,GAC/C,iBAAA,CAAkB,OAAA,CAAQ,MAAA;;;;;;;;;;;;;;;;;;AALF;AAAA;;iBAqFd,eAAA,gCACiB,cAAA,IAE/B,OAAA,EAAS,IAAA,CAAK,UAAA,CAAW,OAAA;EACvB,MAAA,EAAQ,OAAA,GAAU,kBAAA,CAAmB,OAAA;AAAA;EArFZ;;;;;6BA+GN,kBAAA,GAChB,OAAA,CAAQ,SAAA;EA/GQ;;;;;;;;;;;EAAS;;AAAM;AAgFtC;eAkRiB,SAAA;AAAA"}

package/dist/ssg/create-static-gen.js

@@ -1,6 +1,6 @@
 import { addPerfDuration, incrementPerfMetric } from "../runtime/perf-metrics.js";
-import { resolveSsgData, validateRoutes } from "./resolve-ssg-data.js";
 import { resolveRouteDescriptor } from "./route-utils.js";
+import { expandRoutes, resolveSsgData, validateRoutes } from "./resolve-ssg-data.js";
 import { batchRenderRoutes } from "./batch-render.js";
 import { writeStaticFiles } from "./write-static-files.js";
 import { generateSSGResult, resultToMetadata, writeMetadata } from "./generate-metadata.js";
@@ -56,14 +56,15 @@ function createStaticGen(options) {
 		* Returns detailed results
 		*/
 		async generate(generateOptions = {}) {
-			validateRoutes(options.routes);
+			const routes = await expandRoutes(options.routes);
+			validateRoutes(routes);
 			const changedKeys = dedupeStrings(generateOptions.changedKeys);
 			const changedRoutes = dedupeStrings(generateOptions.changedRoutes);
 			const requestedMode = generateOptions.mode ?? "full";
 			const previousManifest = !generateOptions.forceFull && requestedMode === "incremental" ? readIncrementalManifest(options.outputDir, seed) : null;
 			const effectiveMode = generateOptions.forceFull || requestedMode !== "incremental" || previousManifest === null ? "full" : "incremental";
-			const dataMap = resolveSsgData(options.routes, { dataOverrides: options.dataOverrides });
-			const descriptors = options.routes.map(resolveRouteDescriptor);
+			const dataMap = resolveSsgData(routes, { dataOverrides: options.dataOverrides });
+			const descriptors = routes.map(resolveRouteDescriptor);
 			const routeResultsById = /* @__PURE__ */ new Map();
 			const eligibleDescriptors = [];
 			for (const descriptor of descriptors) {

package/dist/ssg/create-static-gen.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-static-gen.js","names":[],"sources":["../../src/ssg/create-static-gen.ts"],"sourcesContent":["/**\n * Static Site Generation API\n *\n * Main orchestrator for batch rendering, file I/O, and metadata generation\n */\n\nimport type {\n  RouteRenderReason,\n  RouteRenderResult,\n  SSGGenerateOptions,\n  SSGMode,\n  SSGOptions,\n  SSGResult,\n} from './types';\nimport { resolveSsgData, validateRoutes } from './resolve-ssg-data';\nimport { batchRenderRoutes } from './batch-render';\nimport { writeStaticFiles } from './write-static-files';\nimport {\n  generateSSGResult,\n  resultToMetadata,\n  writeMetadata,\n} from './generate-metadata';\nimport {\n  getExistingOutputFileSize,\n  outputFileExists,\n  readIncrementalManifest,\n  type IncrementalManifest,\n  type IncrementalManifestRouteEntry,\n  writeIncrementalManifest,\n  hashHtml,\n  SSG_MANIFEST_SCHEMA_VERSION,\n} from './incremental-manifest';\nimport {\n  resolveRouteDescriptor,\n  type ResolvedRouteDescriptor,\n} from './route-utils';\nimport { addPerfDuration, incrementPerfMetric } from '../runtime/perf-metrics';\n\ninterface SelectedRoute {\n  descriptor: ResolvedRouteDescriptor;\n  reason: RouteRenderReason;\n  previous: IncrementalManifestRouteEntry | null;\n}\n\nfunction getRuntimeOnlyDiagnostic(\n  descriptor: ResolvedRouteDescriptor\n): string | null {\n  const { route } = descriptor;\n\n  if (route.auth === true) {\n    return `Skipped prerender for \"${descriptor.path}\": authenticated routes are runtime-only by default.`;\n  }\n\n  if (route.role) {\n    return `Skipped prerender for \"${descriptor.path}\": role-gated routes are runtime-only by default.`;\n  }\n\n  if (route.permission) {\n    return `Skipped prerender for \"${descriptor.path}\": permission-gated routes are runtime-only by default.`;\n  }\n\n  if (route.policies && route.policies.length > 0) {\n    return `Skipped prerender for \"${descriptor.path}\": routes with custom policies are runtime-only by default.`;\n  }\n\n  return null;\n}\n\nfunction resolveParallelism(requested: number | 'auto' | undefined): number {\n  if (requested !== 'auto') {\n    return Math.max(1, requested ?? 1);\n  }\n\n  const maybeNavigator = globalThis as typeof globalThis & {\n    navigator?: { hardwareConcurrency?: number };\n    process?: { env?: Record<string, string | undefined> };\n  };\n\n  const envWorkers = Number(\n    maybeNavigator.process?.env?.ASKR_SSG_WORKERS ??\n      maybeNavigator.process?.env?.NUMBER_OF_PROCESSORS ??\n      maybeNavigator.process?.env?.UV_THREADPOOL_SIZE\n  );\n  if (Number.isFinite(envWorkers) && envWorkers > 0) {\n    return Math.max(1, Math.trunc(envWorkers));\n  }\n\n  if (typeof maybeNavigator.navigator?.hardwareConcurrency === 'number') {\n    return Math.max(1, maybeNavigator.navigator.hardwareConcurrency);\n  }\n\n  return 1;\n}\n\n/**\n * Create a Static Site Generator\n *\n * Usage:\n * ```ts\n * const ssg = createStaticGen({\n *   routes: [\n *     { path: '/', component: HomePage },\n *     { path: '/about', component: AboutPage },\n *   ],\n *   outputDir: './dist',\n *   dataOverrides: {\n *     '/api/posts': { posts: [...] }\n *   }\n * });\n *\n * const result = await ssg.generate();\n * console.log(`Generated ${result.successful}/${result.totalRoutes} routes`);\n * ```\n */\nexport function createStaticGen(options: SSGOptions) {\n  let result: SSGResult | null = null;\n  const seed = options.seed ?? 12345;\n  const resolvedParallelism = resolveParallelism(options.parallelism);\n  const resolvedConcurrency = Math.max(\n    1,\n    options.concurrency ?? resolvedParallelism\n  );\n\n  if (!Array.isArray(options.routes) || options.routes.length === 0) {\n    throw new Error('routes array is required');\n  }\n\n  if (!options.outputDir || options.outputDir.trim().length === 0) {\n    throw new Error('outputDir is required');\n  }\n\n  return {\n    /**\n     * Generate static HTML for all routes\n     * Writes to outputDir with metadata.json\n     * Returns detailed results\n     */\n    async generate(\n      generateOptions: SSGGenerateOptions = {}\n    ): Promise<SSGResult> {\n      // Validate input\n      validateRoutes(options.routes);\n\n      const changedKeys = dedupeStrings(generateOptions.changedKeys);\n      const changedRoutes = dedupeStrings(generateOptions.changedRoutes);\n      const requestedMode = generateOptions.mode ?? 'full';\n      const previousManifest =\n        !generateOptions.forceFull && requestedMode === 'incremental'\n          ? readIncrementalManifest(options.outputDir, seed)\n          : null;\n      const effectiveMode: SSGMode =\n        generateOptions.forceFull ||\n        requestedMode !== 'incremental' ||\n        previousManifest === null\n          ? 'full'\n          : 'incremental';\n\n      // Resolve data\n      const dataMap = resolveSsgData(options.routes, {\n        dataOverrides: options.dataOverrides,\n      });\n\n      const descriptors = options.routes.map(resolveRouteDescriptor);\n      const routeResultsById = new Map<string, RouteRenderResult>();\n      const eligibleDescriptors: ResolvedRouteDescriptor[] = [];\n\n      for (const descriptor of descriptors) {\n        const diagnostic = getRuntimeOnlyDiagnostic(descriptor);\n        if (diagnostic) {\n          routeResultsById.set(descriptor.routeId, {\n            path: descriptor.path,\n            filePath: descriptor.filePath,\n            html: '',\n            fileSize: 0,\n            renderDuration: 0,\n            resourceCount: 0,\n            status: 'skipped',\n            reason: 'runtime-only',\n            written: false,\n            error: diagnostic,\n          });\n          continue;\n        }\n\n        eligibleDescriptors.push(descriptor);\n      }\n\n      const previousEntries = new Map(\n        (previousManifest?.routes ?? []).map((entry) => [entry.routeId, entry])\n      );\n      const currentRouteIds = new Set(\n        eligibleDescriptors.map((descriptor) => descriptor.routeId)\n      );\n\n      const selected: SelectedRoute[] = [];\n      const routesToRender: SelectedRoute[] = [];\n      for (let index = 0; index < eligibleDescriptors.length; index += 1) {\n        const descriptor = eligibleDescriptors[index];\n        const entry = selectRouteForGeneration(\n          descriptor,\n          previousEntries.get(descriptor.routeId) ?? null,\n          effectiveMode,\n          changedKeys,\n          changedRoutes\n        );\n        selected.push(entry);\n        if (entry.reason !== 'unchanged') {\n          routesToRender.push(entry);\n        }\n      }\n      const renderStartTime = performance.now();\n      incrementPerfMetric('ssgWorkerCount', resolvedParallelism);\n      const renderedResults =\n        routesToRender.length > 0\n          ? await batchRenderRoutes(getRoutesToRender(routesToRender), {\n              seed,\n              dataMap,\n              concurrency: resolvedConcurrency,\n            })\n          : [];\n      addPerfDuration('ssgRenderTimeMs', performance.now() - renderStartTime);\n      const renderedByRouteId = new Map<string, RouteRenderResult>();\n      for (let index = 0; index < renderedResults.length; index += 1) {\n        renderedByRouteId.set(\n          routesToRender[index].descriptor.routeId,\n          renderedResults[index]\n        );\n      }\n\n      let cacheHits = 0;\n      const nextManifestRoutes: IncrementalManifestRouteEntry[] = [];\n\n      for (const entry of selected) {\n        const { descriptor, previous, reason } = entry;\n        const baseData =\n          dataMap[descriptor.route.path] ?? dataMap[descriptor.path] ?? {};\n        const resourceCount = Object.keys(baseData).length;\n\n        if (reason === 'unchanged') {\n          routeResultsById.set(descriptor.routeId, {\n            path: descriptor.path,\n            filePath: descriptor.filePath,\n            html: '',\n            fileSize:\n              previous?.htmlHash !== null && previous !== null\n                ? getExistingOutputFileSize(\n                    options.outputDir,\n                    descriptor.filePath\n                  )\n                : 0,\n            renderDuration: 0,\n            resourceCount,\n            status: 'skipped',\n            reason: 'unchanged',\n            written: false,\n          });\n\n          if (previous) {\n            nextManifestRoutes.push({\n              ...previous,\n              path: descriptor.path,\n              filePath: descriptor.filePath,\n              invalidationKeys: descriptor.invalidationKeys.slice(),\n            });\n          }\n          continue;\n        }\n\n        const rendered = renderedByRouteId.get(descriptor.routeId);\n        if (!rendered) {\n          throw new Error(\n            `Missing rendered result for route \"${descriptor.path}\"`\n          );\n        }\n\n        const nextResult: RouteRenderResult = {\n          ...rendered,\n          path: descriptor.path,\n          filePath: descriptor.filePath,\n          resourceCount,\n          reason,\n          written: false,\n        };\n\n        if (nextResult.status === 'success') {\n          const htmlDigest = hashHtml(nextResult.html);\n          const shouldWrite =\n            effectiveMode === 'full' ||\n            !previous ||\n            previous.htmlHash !== htmlDigest ||\n            !outputFileExists(options.outputDir, descriptor.filePath);\n\n          nextResult.written = shouldWrite;\n          if (!shouldWrite) {\n            cacheHits += 1;\n          }\n\n          nextManifestRoutes.push({\n            routeId: descriptor.routeId,\n            path: descriptor.path,\n            filePath: descriptor.filePath,\n            invalidationKeys: descriptor.invalidationKeys.slice(),\n            htmlHash: htmlDigest,\n            lastStatus: 'success',\n          });\n        } else {\n          nextManifestRoutes.push({\n            routeId: descriptor.routeId,\n            path: descriptor.path,\n            filePath: descriptor.filePath,\n            invalidationKeys: descriptor.invalidationKeys.slice(),\n            htmlHash: previous?.htmlHash ?? null,\n            lastStatus: 'error',\n          });\n        }\n\n        routeResultsById.set(descriptor.routeId, nextResult);\n      }\n\n      const removedResults = collectRemovedRouteResults(\n        previousManifest,\n        currentRouteIds\n      );\n      const routeResults: RouteRenderResult[] = [];\n      for (let index = 0; index < descriptors.length; index += 1) {\n        const routeResult = routeResultsById.get(descriptors[index].routeId);\n        if (routeResult) {\n          routeResults.push(routeResult);\n        }\n      }\n      routeResults.push(...removedResults);\n\n      // Write HTML files to disk and remove stale output\n      const writeStartTime = performance.now();\n      await writeStaticFiles(routeResults, options.outputDir, {\n        concurrency: resolvedConcurrency,\n      });\n      addPerfDuration('ssgWriteTimeMs', performance.now() - writeStartTime);\n\n      // Generate result object\n      result = generateSSGResult(routeResults, {\n        mode: effectiveMode,\n        cacheHits,\n        invalidatedKeys: changedKeys,\n        invalidatedRoutes: changedRoutes,\n      });\n\n      // Write metadata\n      const metadata = resultToMetadata(result);\n      await writeMetadata(metadata, options.outputDir);\n\n      await writeIncrementalManifest(\n        {\n          schemaVersion: SSG_MANIFEST_SCHEMA_VERSION,\n          seed,\n          mode: effectiveMode,\n          routes: nextManifestRoutes,\n        },\n        options.outputDir\n      );\n\n      return result;\n    },\n\n    /**\n     * Get effective config in a serializable form for diagnostics.\n     */\n    getConfig() {\n      return {\n        routeCount: options.routes.length,\n        outputDir: options.outputDir,\n        seed,\n        concurrency: resolvedConcurrency,\n        parallelism: resolvedParallelism,\n        hasDataOverrides: !!options.dataOverrides,\n      };\n    },\n\n    /**\n     * Get the last generation result\n     * Returns null if generate() hasn't been called\n     */\n    getResult(): SSGResult | null {\n      return result;\n    },\n  };\n}\n\nfunction dedupeStrings(values?: string[]): string[] {\n  return values ? Array.from(new Set(values)) : [];\n}\n\nfunction getRoutesToRender(selected: SelectedRoute[]): SSGOptions['routes'] {\n  const routes: SSGOptions['routes'] = [];\n  for (let index = 0; index < selected.length; index += 1) {\n    routes.push(selected[index].descriptor.route);\n  }\n  return routes;\n}\n\nfunction selectRouteForGeneration(\n  descriptor: ResolvedRouteDescriptor,\n  previous: IncrementalManifestRouteEntry | null,\n  mode: SSGMode,\n  changedKeys: string[],\n  changedRoutes: string[]\n): SelectedRoute {\n  if (mode === 'full') {\n    return { descriptor, reason: 'full', previous };\n  }\n\n  if (!previous) {\n    return { descriptor, reason: 'new-route', previous };\n  }\n\n  if (previous.lastStatus === 'error' || previous.htmlHash === null) {\n    return { descriptor, reason: 'new-route', previous };\n  }\n\n  if (descriptor.invalidationKeys.length === 0) {\n    return { descriptor, reason: 'no-keys', previous };\n  }\n\n  if (changedRoutes.includes(descriptor.path)) {\n    return { descriptor, reason: 'changed-route', previous };\n  }\n\n  if (descriptor.invalidationKeys.some((key) => changedKeys.includes(key))) {\n    return { descriptor, reason: 'changed-key', previous };\n  }\n\n  return { descriptor, reason: 'unchanged', previous };\n}\n\nfunction collectRemovedRouteResults(\n  manifest: IncrementalManifest | null,\n  currentRouteIds: Set<string>\n): RouteRenderResult[] {\n  if (!manifest) {\n    return [];\n  }\n\n  const results: RouteRenderResult[] = [];\n  for (let index = 0; index < manifest.routes.length; index += 1) {\n    const entry = manifest.routes[index];\n    if (currentRouteIds.has(entry.routeId)) {\n      continue;\n    }\n    results.push({\n      path: entry.path,\n      filePath: entry.filePath,\n      html: '',\n      fileSize: 0,\n      renderDuration: 0,\n      resourceCount: 0,\n      status: 'removed' as const,\n      reason: 'deleted' as const,\n      written: false,\n    });\n  }\n\n  return results;\n}\n"],"mappings":"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"}
+{"version":3,"file":"create-static-gen.js","names":[],"sources":["../../src/ssg/create-static-gen.ts"],"sourcesContent":["/**\n * Static Site Generation API\n *\n * Main orchestrator for batch rendering, file I/O, and metadata generation\n */\n\nimport type {\n  RouteConfig,\n  RouteRenderReason,\n  RouteRenderResult,\n  SSGGenerateOptions,\n  SSGMode,\n  SSGOptions,\n  SSGResult,\n} from './types';\nimport {\n  expandRoutes,\n  resolveSsgData,\n  validateRoutes,\n} from './resolve-ssg-data';\nimport { batchRenderRoutes } from './batch-render';\nimport { writeStaticFiles } from './write-static-files';\nimport {\n  generateSSGResult,\n  resultToMetadata,\n  writeMetadata,\n} from './generate-metadata';\nimport {\n  getExistingOutputFileSize,\n  outputFileExists,\n  readIncrementalManifest,\n  type IncrementalManifest,\n  type IncrementalManifestRouteEntry,\n  writeIncrementalManifest,\n  hashHtml,\n  SSG_MANIFEST_SCHEMA_VERSION,\n} from './incremental-manifest';\nimport {\n  resolveRouteDescriptor,\n  type ResolvedRouteDescriptor,\n} from './route-utils';\nimport { addPerfDuration, incrementPerfMetric } from '../runtime/perf-metrics';\n\ntype AnyRouteConfig = RouteConfig<string>;\n\ntype StrictRouteConfig<TRoute extends AnyRouteConfig> = Omit<\n  TRoute,\n  'params' | 'entries'\n> & {\n  params?: RouteConfig<TRoute['path']>['params'];\n  entries?: RouteConfig<TRoute['path']>['entries'];\n};\n\ntype StrictRouteConfigs<TRoutes extends readonly AnyRouteConfig[]> = {\n  [TIndex in keyof TRoutes]: TRoutes[TIndex] extends AnyRouteConfig\n    ? StrictRouteConfig<TRoutes[TIndex]>\n    : never;\n};\n\ninterface SelectedRoute {\n  descriptor: ResolvedRouteDescriptor;\n  reason: RouteRenderReason;\n  previous: IncrementalManifestRouteEntry | null;\n}\n\nfunction getRuntimeOnlyDiagnostic(\n  descriptor: ResolvedRouteDescriptor\n): string | null {\n  const { route } = descriptor;\n\n  if (route.auth === true) {\n    return `Skipped prerender for \"${descriptor.path}\": authenticated routes are runtime-only by default.`;\n  }\n\n  if (route.role) {\n    return `Skipped prerender for \"${descriptor.path}\": role-gated routes are runtime-only by default.`;\n  }\n\n  if (route.permission) {\n    return `Skipped prerender for \"${descriptor.path}\": permission-gated routes are runtime-only by default.`;\n  }\n\n  if (route.policies && route.policies.length > 0) {\n    return `Skipped prerender for \"${descriptor.path}\": routes with custom policies are runtime-only by default.`;\n  }\n\n  return null;\n}\n\nfunction resolveParallelism(requested: number | 'auto' | undefined): number {\n  if (requested !== 'auto') {\n    return Math.max(1, requested ?? 1);\n  }\n\n  const maybeNavigator = globalThis as typeof globalThis & {\n    navigator?: { hardwareConcurrency?: number };\n    process?: { env?: Record<string, string | undefined> };\n  };\n\n  const envWorkers = Number(\n    maybeNavigator.process?.env?.ASKR_SSG_WORKERS ??\n      maybeNavigator.process?.env?.NUMBER_OF_PROCESSORS ??\n      maybeNavigator.process?.env?.UV_THREADPOOL_SIZE\n  );\n  if (Number.isFinite(envWorkers) && envWorkers > 0) {\n    return Math.max(1, Math.trunc(envWorkers));\n  }\n\n  if (typeof maybeNavigator.navigator?.hardwareConcurrency === 'number') {\n    return Math.max(1, maybeNavigator.navigator.hardwareConcurrency);\n  }\n\n  return 1;\n}\n\n/**\n * Create a Static Site Generator\n *\n * Usage:\n * ```ts\n * const ssg = createStaticGen({\n *   routes: [\n *     { path: '/', component: HomePage },\n *     { path: '/about', component: AboutPage },\n *   ],\n *   outputDir: './dist',\n *   dataOverrides: {\n *     '/api/posts': { posts: [...] }\n *   }\n * });\n *\n * const result = await ssg.generate();\n * console.log(`Generated ${result.successful}/${result.totalRoutes} routes`);\n * ```\n */\nexport function createStaticGen<\n  const TRoutes extends readonly AnyRouteConfig[],\n>(\n  options: Omit<SSGOptions<TRoutes>, 'routes'> & {\n    routes: TRoutes & StrictRouteConfigs<TRoutes>;\n  }\n) {\n  let result: SSGResult | null = null;\n  const seed = options.seed ?? 12345;\n  const resolvedParallelism = resolveParallelism(options.parallelism);\n  const resolvedConcurrency = Math.max(\n    1,\n    options.concurrency ?? resolvedParallelism\n  );\n\n  if (!Array.isArray(options.routes) || options.routes.length === 0) {\n    throw new Error('routes array is required');\n  }\n\n  if (!options.outputDir || options.outputDir.trim().length === 0) {\n    throw new Error('outputDir is required');\n  }\n\n  return {\n    /**\n     * Generate static HTML for all routes\n     * Writes to outputDir with metadata.json\n     * Returns detailed results\n     */\n    async generate(\n      generateOptions: SSGGenerateOptions = {}\n    ): Promise<SSGResult> {\n      const routes = await expandRoutes(options.routes as RouteConfig[]);\n      validateRoutes(routes);\n\n      const changedKeys = dedupeStrings(generateOptions.changedKeys);\n      const changedRoutes = dedupeStrings(generateOptions.changedRoutes);\n      const requestedMode = generateOptions.mode ?? 'full';\n      const previousManifest =\n        !generateOptions.forceFull && requestedMode === 'incremental'\n          ? readIncrementalManifest(options.outputDir, seed)\n          : null;\n      const effectiveMode: SSGMode =\n        generateOptions.forceFull ||\n        requestedMode !== 'incremental' ||\n        previousManifest === null\n          ? 'full'\n          : 'incremental';\n\n      // Resolve data\n      const dataMap = resolveSsgData(routes, {\n        dataOverrides: options.dataOverrides,\n      });\n\n      const descriptors = routes.map(resolveRouteDescriptor);\n      const routeResultsById = new Map<string, RouteRenderResult>();\n      const eligibleDescriptors: ResolvedRouteDescriptor[] = [];\n\n      for (const descriptor of descriptors) {\n        const diagnostic = getRuntimeOnlyDiagnostic(descriptor);\n        if (diagnostic) {\n          routeResultsById.set(descriptor.routeId, {\n            path: descriptor.path,\n            filePath: descriptor.filePath,\n            html: '',\n            fileSize: 0,\n            renderDuration: 0,\n            resourceCount: 0,\n            status: 'skipped',\n            reason: 'runtime-only',\n            written: false,\n            error: diagnostic,\n          });\n          continue;\n        }\n\n        eligibleDescriptors.push(descriptor);\n      }\n\n      const previousEntries = new Map(\n        (previousManifest?.routes ?? []).map((entry) => [entry.routeId, entry])\n      );\n      const currentRouteIds = new Set(\n        eligibleDescriptors.map((descriptor) => descriptor.routeId)\n      );\n\n      const selected: SelectedRoute[] = [];\n      const routesToRender: SelectedRoute[] = [];\n      for (let index = 0; index < eligibleDescriptors.length; index += 1) {\n        const descriptor = eligibleDescriptors[index];\n        const entry = selectRouteForGeneration(\n          descriptor,\n          previousEntries.get(descriptor.routeId) ?? null,\n          effectiveMode,\n          changedKeys,\n          changedRoutes\n        );\n        selected.push(entry);\n        if (entry.reason !== 'unchanged') {\n          routesToRender.push(entry);\n        }\n      }\n      const renderStartTime = performance.now();\n      incrementPerfMetric('ssgWorkerCount', resolvedParallelism);\n      const renderedResults =\n        routesToRender.length > 0\n          ? await batchRenderRoutes(getRoutesToRender(routesToRender), {\n              seed,\n              dataMap,\n              concurrency: resolvedConcurrency,\n            })\n          : [];\n      addPerfDuration('ssgRenderTimeMs', performance.now() - renderStartTime);\n      const renderedByRouteId = new Map<string, RouteRenderResult>();\n      for (let index = 0; index < renderedResults.length; index += 1) {\n        renderedByRouteId.set(\n          routesToRender[index].descriptor.routeId,\n          renderedResults[index]\n        );\n      }\n\n      let cacheHits = 0;\n      const nextManifestRoutes: IncrementalManifestRouteEntry[] = [];\n\n      for (const entry of selected) {\n        const { descriptor, previous, reason } = entry;\n        const baseData =\n          dataMap[descriptor.route.path] ?? dataMap[descriptor.path] ?? {};\n        const resourceCount = Object.keys(baseData).length;\n\n        if (reason === 'unchanged') {\n          routeResultsById.set(descriptor.routeId, {\n            path: descriptor.path,\n            filePath: descriptor.filePath,\n            html: '',\n            fileSize:\n              previous?.htmlHash !== null && previous !== null\n                ? getExistingOutputFileSize(\n                    options.outputDir,\n                    descriptor.filePath\n                  )\n                : 0,\n            renderDuration: 0,\n            resourceCount,\n            status: 'skipped',\n            reason: 'unchanged',\n            written: false,\n          });\n\n          if (previous) {\n            nextManifestRoutes.push({\n              ...previous,\n              path: descriptor.path,\n              filePath: descriptor.filePath,\n              invalidationKeys: descriptor.invalidationKeys.slice(),\n            });\n          }\n          continue;\n        }\n\n        const rendered = renderedByRouteId.get(descriptor.routeId);\n        if (!rendered) {\n          throw new Error(\n            `Missing rendered result for route \"${descriptor.path}\"`\n          );\n        }\n\n        const nextResult: RouteRenderResult = {\n          ...rendered,\n          path: descriptor.path,\n          filePath: descriptor.filePath,\n          resourceCount,\n          reason,\n          written: false,\n        };\n\n        if (nextResult.status === 'success') {\n          const htmlDigest = hashHtml(nextResult.html);\n          const shouldWrite =\n            effectiveMode === 'full' ||\n            !previous ||\n            previous.htmlHash !== htmlDigest ||\n            !outputFileExists(options.outputDir, descriptor.filePath);\n\n          nextResult.written = shouldWrite;\n          if (!shouldWrite) {\n            cacheHits += 1;\n          }\n\n          nextManifestRoutes.push({\n            routeId: descriptor.routeId,\n            path: descriptor.path,\n            filePath: descriptor.filePath,\n            invalidationKeys: descriptor.invalidationKeys.slice(),\n            htmlHash: htmlDigest,\n            lastStatus: 'success',\n          });\n        } else {\n          nextManifestRoutes.push({\n            routeId: descriptor.routeId,\n            path: descriptor.path,\n            filePath: descriptor.filePath,\n            invalidationKeys: descriptor.invalidationKeys.slice(),\n            htmlHash: previous?.htmlHash ?? null,\n            lastStatus: 'error',\n          });\n        }\n\n        routeResultsById.set(descriptor.routeId, nextResult);\n      }\n\n      const removedResults = collectRemovedRouteResults(\n        previousManifest,\n        currentRouteIds\n      );\n      const routeResults: RouteRenderResult[] = [];\n      for (let index = 0; index < descriptors.length; index += 1) {\n        const routeResult = routeResultsById.get(descriptors[index].routeId);\n        if (routeResult) {\n          routeResults.push(routeResult);\n        }\n      }\n      routeResults.push(...removedResults);\n\n      // Write HTML files to disk and remove stale output\n      const writeStartTime = performance.now();\n      await writeStaticFiles(routeResults, options.outputDir, {\n        concurrency: resolvedConcurrency,\n      });\n      addPerfDuration('ssgWriteTimeMs', performance.now() - writeStartTime);\n\n      // Generate result object\n      result = generateSSGResult(routeResults, {\n        mode: effectiveMode,\n        cacheHits,\n        invalidatedKeys: changedKeys,\n        invalidatedRoutes: changedRoutes,\n      });\n\n      // Write metadata\n      const metadata = resultToMetadata(result);\n      await writeMetadata(metadata, options.outputDir);\n\n      await writeIncrementalManifest(\n        {\n          schemaVersion: SSG_MANIFEST_SCHEMA_VERSION,\n          seed,\n          mode: effectiveMode,\n          routes: nextManifestRoutes,\n        },\n        options.outputDir\n      );\n\n      return result;\n    },\n\n    /**\n     * Get effective config in a serializable form for diagnostics.\n     */\n    getConfig() {\n      return {\n        routeCount: options.routes.length,\n        outputDir: options.outputDir,\n        seed,\n        concurrency: resolvedConcurrency,\n        parallelism: resolvedParallelism,\n        hasDataOverrides: !!options.dataOverrides,\n      };\n    },\n\n    /**\n     * Get the last generation result\n     * Returns null if generate() hasn't been called\n     */\n    getResult(): SSGResult | null {\n      return result;\n    },\n  };\n}\n\nfunction dedupeStrings(values?: string[]): string[] {\n  return values ? Array.from(new Set(values)) : [];\n}\n\nfunction getRoutesToRender(selected: SelectedRoute[]): RouteConfig[] {\n  const routes: RouteConfig[] = [];\n  for (let index = 0; index < selected.length; index += 1) {\n    routes.push(selected[index].descriptor.route);\n  }\n  return routes;\n}\n\nfunction selectRouteForGeneration(\n  descriptor: ResolvedRouteDescriptor,\n  previous: IncrementalManifestRouteEntry | null,\n  mode: SSGMode,\n  changedKeys: string[],\n  changedRoutes: string[]\n): SelectedRoute {\n  if (mode === 'full') {\n    return { descriptor, reason: 'full', previous };\n  }\n\n  if (!previous) {\n    return { descriptor, reason: 'new-route', previous };\n  }\n\n  if (previous.lastStatus === 'error' || previous.htmlHash === null) {\n    return { descriptor, reason: 'new-route', previous };\n  }\n\n  if (descriptor.invalidationKeys.length === 0) {\n    return { descriptor, reason: 'no-keys', previous };\n  }\n\n  if (changedRoutes.includes(descriptor.path)) {\n    return { descriptor, reason: 'changed-route', previous };\n  }\n\n  if (descriptor.invalidationKeys.some((key) => changedKeys.includes(key))) {\n    return { descriptor, reason: 'changed-key', previous };\n  }\n\n  return { descriptor, reason: 'unchanged', previous };\n}\n\nfunction collectRemovedRouteResults(\n  manifest: IncrementalManifest | null,\n  currentRouteIds: Set<string>\n): RouteRenderResult[] {\n  if (!manifest) {\n    return [];\n  }\n\n  const results: RouteRenderResult[] = [];\n  for (let index = 0; index < manifest.routes.length; index += 1) {\n    const entry = manifest.routes[index];\n    if (currentRouteIds.has(entry.routeId)) {\n      continue;\n    }\n    results.push({\n      path: entry.path,\n      filePath: entry.filePath,\n      html: '',\n      fileSize: 0,\n      renderDuration: 0,\n      resourceCount: 0,\n      status: 'removed' as const,\n      reason: 'deleted' as const,\n      written: false,\n    });\n  }\n\n  return results;\n}\n"],"mappings":"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"}

package/dist/ssg/generate-metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-metadata.js","names":[],"sources":["../../src/ssg/generate-metadata.ts"],"sourcesContent":["/**\n * Metadata generation for SSG\n *\n * Generates and serializes metadata about generated static files.\n * This module is Node-only and not intended for browser builds.\n */\n\nimport * as fs from 'node:fs/promises';\nimport * as pathModule from 'node:path';\nimport type {\n  RouteRenderResult,\n  SSGMetadata,\n  SSGMode,\n  SSGResult,\n} from './types';\n\ninterface GenerateResultOptions {\n  mode?: SSGMode;\n  cacheHits?: number;\n  invalidatedKeys?: string[];\n  invalidatedRoutes?: string[];\n}\n\n/**\n * Generate SSGResult from render results\n */\nexport function generateSSGResult(\n  results: RouteRenderResult[],\n  options: GenerateResultOptions = {}\n): SSGResult {\n  let successful = 0;\n  let failed = 0;\n  let totalDuration = 0;\n  let rebuilt = 0;\n  let skipped = 0;\n  let removed = 0;\n\n  for (let index = 0; index < results.length; index += 1) {\n    const result = results[index];\n    totalDuration += result.renderDuration;\n\n    if (result.status === 'success') {\n      successful += 1;\n      rebuilt += 1;\n    } else if (result.status === 'error') {\n      failed += 1;\n      rebuilt += 1;\n    } else if (result.status === 'skipped') {\n      skipped += 1;\n    } else if (result.status === 'removed') {\n      removed += 1;\n    }\n  }\n\n  return {\n    generatedAt: new Date().toISOString(),\n    totalRoutes: results.length,\n    successful,\n    failed,\n    totalDuration: Math.round(totalDuration),\n    mode: options.mode ?? 'full',\n    rebuilt,\n    skipped,\n    removed,\n    cacheHits: options.cacheHits ?? 0,\n    invalidatedKeys: options.invalidatedKeys?.slice() ?? [],\n    invalidatedRoutes: options.invalidatedRoutes?.slice() ?? [],\n    routes: results,\n  };\n}\n\n/**\n * Convert SSGResult to metadata for JSON serialization\n */\nexport function resultToMetadata(result: SSGResult): SSGMetadata {\n  const routes: SSGMetadata['routes'] = [];\n\n  for (let index = 0; index < result.routes.length; index += 1) {\n    const route = result.routes[index];\n    routes.push({\n      path: route.path,\n      filePath: route.filePath,\n      fileSize: route.fileSize,\n      renderDuration: route.renderDuration,\n      resourceCount: route.resourceCount,\n      status: route.status,\n      reason: route.reason,\n      written: route.written,\n      error: route.error,\n    });\n  }\n\n  return {\n    generatedAt: result.generatedAt,\n    totalRoutes: result.totalRoutes,\n    successful: result.successful,\n    failed: result.failed,\n    totalDuration: result.totalDuration,\n    mode: result.mode,\n    rebuilt: result.rebuilt,\n    skipped: result.skipped,\n    removed: result.removed,\n    cacheHits: result.cacheHits,\n    invalidatedKeys: result.invalidatedKeys.slice(),\n    invalidatedRoutes: result.invalidatedRoutes.slice(),\n    routes,\n  };\n}\n\n/**\n * Write metadata.json to output directory\n */\nexport async function writeMetadata(\n  metadata: Record<string, unknown>,\n  outputDir: string\n): Promise<void> {\n  const filePath = pathModule.join(outputDir, 'metadata.json');\n\n  // Ensure directory exists\n  await fs.mkdir(outputDir, { recursive: true });\n\n  // Write metadata file with formatting\n  await fs.writeFile(filePath, JSON.stringify(metadata, null, 2), 'utf8');\n}\n"],"mappings":";;;;;;;;;;;;AA0BA,SAAgB,kBACd,SACA,UAAiC,EAAE,EACxB;CACX,IAAI,aAAa;CACjB,IAAI,SAAS;CACb,IAAI,gBAAgB;CACpB,IAAI,UAAU;CACd,IAAI,UAAU;CACd,IAAI,UAAU;CAEd,KAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS,GAAG;EACtD,MAAM,SAAS,QAAQ;EACvB,iBAAiB,OAAO;EAExB,IAAI,OAAO,WAAW,WAAW;GAC/B,cAAc;GACd,WAAW;SACN,IAAI,OAAO,WAAW,SAAS;GACpC,UAAU;GACV,WAAW;SACN,IAAI,OAAO,WAAW,WAC3B,WAAW;OACN,IAAI,OAAO,WAAW,WAC3B,WAAW;;CAIf,OAAO;EACL,8BAAa,IAAI,MAAM,EAAC,aAAa;EACrC,aAAa,QAAQ;EACrB;EACA;EACA,eAAe,KAAK,MAAM,cAAc;EACxC,MAAM,QAAQ,QAAQ;EACtB;EACA;EACA;EACA,WAAW,QAAQ,aAAa;EAChC,iBAAiB,QAAQ,iBAAiB,OAAO,IAAI,EAAE;EACvD,mBAAmB,QAAQ,mBAAmB,OAAO,IAAI,EAAE;EAC3D,QAAQ;EACT;;;;;AAMH,SAAgB,iBAAiB,QAAgC;CAC/D,MAAM,SAAgC,EAAE;CAExC,KAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,OAAO,QAAQ,SAAS,GAAG;EAC5D,MAAM,QAAQ,OAAO,OAAO;EAC5B,OAAO,KAAK;GACV,MAAM,MAAM;GACZ,UAAU,MAAM;GAChB,UAAU,MAAM;GAChB,gBAAgB,MAAM;GACtB,eAAe,MAAM;GACrB,QAAQ,MAAM;GACd,QAAQ,MAAM;GACd,SAAS,MAAM;GACf,OAAO,MAAM;GACd,CAAC;;CAGJ,OAAO;EACL,aAAa,OAAO;EACpB,aAAa,OAAO;EACpB,YAAY,OAAO;EACnB,QAAQ,OAAO;EACf,eAAe,OAAO;EACtB,MAAM,OAAO;EACb,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,WAAW,OAAO;EAClB,iBAAiB,OAAO,gBAAgB,OAAO;EAC/C,mBAAmB,OAAO,kBAAkB,OAAO;EACnD;EACD;;;;;AAMH,eAAsB,cACpB,UACA,WACe;CACf,MAAM,WAAW,WAAW,KAAK,WAAW,gBAAgB;CAG5D,MAAM,GAAG,MAAM,WAAW,EAAE,WAAW,MAAM,CAAC;CAG9C,MAAM,GAAG,UAAU,UAAU,KAAK,UAAU,UAAU,MAAM,EAAE,EAAE,OAAO"}
+{"version":3,"file":"generate-metadata.js","names":[],"sources":["../../src/ssg/generate-metadata.ts"],"sourcesContent":["/**\n * Metadata generation for SSG\n *\n * Generates and serializes metadata about generated static files.\n * This module is Node-only and not intended for browser builds.\n */\n\nimport * as fs from 'node:fs/promises';\nimport * as pathModule from 'node:path';\nimport type {\n  RouteRenderResult,\n  SSGMetadata,\n  SSGMode,\n  SSGResult,\n} from './types';\n\ninterface GenerateResultOptions {\n  mode?: SSGMode;\n  cacheHits?: number;\n  invalidatedKeys?: string[];\n  invalidatedRoutes?: string[];\n}\n\n/**\n * Generate SSGResult from render results\n */\nexport function generateSSGResult(\n  results: RouteRenderResult[],\n  options: GenerateResultOptions = {}\n): SSGResult {\n  let successful = 0;\n  let failed = 0;\n  let totalDuration = 0;\n  let rebuilt = 0;\n  let skipped = 0;\n  let removed = 0;\n\n  for (let index = 0; index < results.length; index += 1) {\n    const result = results[index];\n    totalDuration += result.renderDuration;\n\n    if (result.status === 'success') {\n      successful += 1;\n      rebuilt += 1;\n    } else if (result.status === 'error') {\n      failed += 1;\n      rebuilt += 1;\n    } else if (result.status === 'skipped') {\n      skipped += 1;\n    } else if (result.status === 'removed') {\n      removed += 1;\n    }\n  }\n\n  return {\n    generatedAt: new Date().toISOString(),\n    totalRoutes: results.length,\n    successful,\n    failed,\n    totalDuration: Math.round(totalDuration),\n    mode: options.mode ?? 'full',\n    rebuilt,\n    skipped,\n    removed,\n    cacheHits: options.cacheHits ?? 0,\n    invalidatedKeys: options.invalidatedKeys?.slice() ?? [],\n    invalidatedRoutes: options.invalidatedRoutes?.slice() ?? [],\n    routes: results,\n  };\n}\n\n/**\n * Convert SSGResult to metadata for JSON serialization\n */\nexport function resultToMetadata(result: SSGResult): SSGMetadata {\n  const routes: SSGMetadata['routes'] = [];\n\n  for (let index = 0; index < result.routes.length; index += 1) {\n    const route = result.routes[index];\n    routes.push({\n      path: route.path,\n      filePath: route.filePath,\n      fileSize: route.fileSize,\n      renderDuration: route.renderDuration,\n      resourceCount: route.resourceCount,\n      status: route.status,\n      reason: route.reason,\n      written: route.written,\n      error: route.error,\n    });\n  }\n\n  return {\n    generatedAt: result.generatedAt,\n    totalRoutes: result.totalRoutes,\n    successful: result.successful,\n    failed: result.failed,\n    totalDuration: result.totalDuration,\n    mode: result.mode,\n    rebuilt: result.rebuilt,\n    skipped: result.skipped,\n    removed: result.removed,\n    cacheHits: result.cacheHits,\n    invalidatedKeys: result.invalidatedKeys.slice(),\n    invalidatedRoutes: result.invalidatedRoutes.slice(),\n    routes,\n  };\n}\n\n/**\n * Write metadata.json to output directory\n */\nexport async function writeMetadata(\n  metadata: Record<string, unknown>,\n  outputDir: string\n): Promise<void> {\n  const filePath = pathModule.join(outputDir, 'metadata.json');\n\n  // Ensure directory exists\n  await fs.mkdir(outputDir, { recursive: true });\n\n  // Write metadata file with formatting\n  await fs.writeFile(filePath, JSON.stringify(metadata, null, 2), 'utf8');\n}\n"],"mappings":";;;;;;;;;;;;AA0BA,SAAgB,kBACd,SACA,UAAiC,CAAC,GACvB;CACX,IAAI,aAAa;CACjB,IAAI,SAAS;CACb,IAAI,gBAAgB;CACpB,IAAI,UAAU;CACd,IAAI,UAAU;CACd,IAAI,UAAU;CAEd,KAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS,GAAG;EACtD,MAAM,SAAS,QAAQ;EACvB,iBAAiB,OAAO;EAExB,IAAI,OAAO,WAAW,WAAW;GAC/B,cAAc;GACd,WAAW;EACb,OAAO,IAAI,OAAO,WAAW,SAAS;GACpC,UAAU;GACV,WAAW;EACb,OAAO,IAAI,OAAO,WAAW,WAC3B,WAAW;OACN,IAAI,OAAO,WAAW,WAC3B,WAAW;CAEf;CAEA,OAAO;EACL,8BAAa,IAAI,KAAK,GAAE,YAAY;EACpC,aAAa,QAAQ;EACrB;EACA;EACA,eAAe,KAAK,MAAM,aAAa;EACvC,MAAM,QAAQ,QAAQ;EACtB;EACA;EACA;EACA,WAAW,QAAQ,aAAa;EAChC,iBAAiB,QAAQ,iBAAiB,MAAM,KAAK,CAAC;EACtD,mBAAmB,QAAQ,mBAAmB,MAAM,KAAK,CAAC;EAC1D,QAAQ;CACV;AACF;;;;AAKA,SAAgB,iBAAiB,QAAgC;CAC/D,MAAM,SAAgC,CAAC;CAEvC,KAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,OAAO,QAAQ,SAAS,GAAG;EAC5D,MAAM,QAAQ,OAAO,OAAO;EAC5B,OAAO,KAAK;GACV,MAAM,MAAM;GACZ,UAAU,MAAM;GAChB,UAAU,MAAM;GAChB,gBAAgB,MAAM;GACtB,eAAe,MAAM;GACrB,QAAQ,MAAM;GACd,QAAQ,MAAM;GACd,SAAS,MAAM;GACf,OAAO,MAAM;EACf,CAAC;CACH;CAEA,OAAO;EACL,aAAa,OAAO;EACpB,aAAa,OAAO;EACpB,YAAY,OAAO;EACnB,QAAQ,OAAO;EACf,eAAe,OAAO;EACtB,MAAM,OAAO;EACb,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,SAAS,OAAO;EAChB,WAAW,OAAO;EAClB,iBAAiB,OAAO,gBAAgB,MAAM;EAC9C,mBAAmB,OAAO,kBAAkB,MAAM;EAClD;CACF;AACF;;;;AAKA,eAAsB,cACpB,UACA,WACe;CACf,MAAM,WAAW,WAAW,KAAK,WAAW,eAAe;CAG3D,MAAM,GAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;CAG7C,MAAM,GAAG,UAAU,UAAU,KAAK,UAAU,UAAU,MAAM,CAAC,GAAG,MAAM;AACxE"}

package/dist/ssg/incremental-manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"incremental-manifest.js","names":[],"sources":["../../src/ssg/incremental-manifest.ts"],"sourcesContent":["import * as fs from 'node:fs';\nimport * as fsPromises from 'node:fs/promises';\nimport * as pathModule from 'node:path';\nimport type { RouteRenderStatus, SSGMode } from './types';\n\nexport const SSG_MANIFEST_SCHEMA_VERSION = 1;\nconst MANIFEST_DIR = '.askr';\nconst MANIFEST_FILE = 'ssg-manifest.json';\n\nexport interface IncrementalManifestRouteEntry {\n  routeId: string;\n  path: string;\n  filePath: string;\n  invalidationKeys: string[];\n  htmlHash: string | null;\n  lastStatus: Extract<RouteRenderStatus, 'success' | 'error'>;\n}\n\nexport interface IncrementalManifest {\n  schemaVersion: number;\n  seed: number;\n  mode: SSGMode;\n  routes: IncrementalManifestRouteEntry[];\n}\n\nexport function hashHtml(html: string): string {\n  // Deterministic 32-bit FNV-1a hash is sufficient for incremental change checks.\n  let hash = 0x811c9dc5;\n  for (let index = 0; index < html.length; index += 1) {\n    hash ^= html.charCodeAt(index);\n    hash = Math.imul(hash, 0x01000193);\n  }\n  return (hash >>> 0).toString(16).padStart(8, '0');\n}\n\nexport function getIncrementalManifestPath(outputDir: string): string {\n  return pathModule.join(outputDir, MANIFEST_DIR, MANIFEST_FILE);\n}\n\nexport function readIncrementalManifest(\n  outputDir: string,\n  seed: number\n): IncrementalManifest | null {\n  const manifestPath = getIncrementalManifestPath(outputDir);\n  if (!fs.existsSync(manifestPath)) {\n    return null;\n  }\n\n  try {\n    const raw = fs.readFileSync(manifestPath, 'utf8');\n    const parsed = JSON.parse(raw) as Partial<IncrementalManifest>;\n\n    if (\n      parsed.schemaVersion !== SSG_MANIFEST_SCHEMA_VERSION ||\n      parsed.seed !== seed ||\n      !Array.isArray(parsed.routes)\n    ) {\n      return null;\n    }\n\n    const routes = parsed.routes.filter(\n      (entry): entry is IncrementalManifestRouteEntry =>\n        !!entry &&\n        typeof entry.routeId === 'string' &&\n        typeof entry.path === 'string' &&\n        typeof entry.filePath === 'string' &&\n        Array.isArray(entry.invalidationKeys) &&\n        (entry.htmlHash === null || typeof entry.htmlHash === 'string') &&\n        (entry.lastStatus === 'success' || entry.lastStatus === 'error')\n    );\n\n    if (routes.length !== parsed.routes.length) {\n      return null;\n    }\n\n    return {\n      schemaVersion: SSG_MANIFEST_SCHEMA_VERSION,\n      seed,\n      mode: parsed.mode === 'incremental' ? 'incremental' : 'full',\n      routes,\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport async function writeIncrementalManifest(\n  manifest: IncrementalManifest,\n  outputDir: string\n): Promise<void> {\n  const manifestPath = getIncrementalManifestPath(outputDir);\n  await fsPromises.mkdir(pathModule.dirname(manifestPath), { recursive: true });\n  await fsPromises.writeFile(\n    manifestPath,\n    JSON.stringify(manifest, null, 2),\n    'utf8'\n  );\n}\n\nexport function getExistingOutputFileSize(\n  outputDir: string,\n  filePath: string\n): number {\n  const fullPath = pathModule.join(outputDir, filePath);\n  if (!fs.existsSync(fullPath)) {\n    return 0;\n  }\n\n  try {\n    return fs.statSync(fullPath).size;\n  } catch {\n    return 0;\n  }\n}\n\nexport function outputFileExists(outputDir: string, filePath: string): boolean {\n  return fs.existsSync(pathModule.join(outputDir, filePath));\n}\n"],"mappings":";;;AAMA,MAAM,eAAe;AACrB,MAAM,gBAAgB;AAkBtB,SAAgB,SAAS,MAAsB;CAE7C,IAAI,OAAO;CACX,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,GAAG;EACnD,QAAQ,KAAK,WAAW,MAAM;EAC9B,OAAO,KAAK,KAAK,MAAM,SAAW;;CAEpC,QAAQ,SAAS,GAAG,SAAS,GAAG,CAAC,SAAS,GAAG,IAAI;;AAGnD,SAAgB,2BAA2B,WAA2B;CACpE,OAAO,WAAW,KAAK,WAAW,cAAc,cAAc;;AAGhE,SAAgB,wBACd,WACA,MAC4B;CAC5B,MAAM,eAAe,2BAA2B,UAAU;CAC1D,IAAI,CAAC,GAAG,WAAW,aAAa,EAC9B,OAAO;CAGT,IAAI;EACF,MAAM,MAAM,GAAG,aAAa,cAAc,OAAO;EACjD,MAAM,SAAS,KAAK,MAAM,IAAI;EAE9B,IACE,OAAO,kBAAA,KACP,OAAO,SAAS,QAChB,CAAC,MAAM,QAAQ,OAAO,OAAO,EAE7B,OAAO;EAGT,MAAM,SAAS,OAAO,OAAO,QAC1B,UACC,CAAC,CAAC,SACF,OAAO,MAAM,YAAY,YACzB,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,aAAa,YAC1B,MAAM,QAAQ,MAAM,iBAAiB,KACpC,MAAM,aAAa,QAAQ,OAAO,MAAM,aAAa,cACrD,MAAM,eAAe,aAAa,MAAM,eAAe,SAC3D;EAED,IAAI,OAAO,WAAW,OAAO,OAAO,QAClC,OAAO;EAGT,OAAO;GACL,eAAA;GACA;GACA,MAAM,OAAO,SAAS,gBAAgB,gBAAgB;GACtD;GACD;SACK;EACN,OAAO;;;AAIX,eAAsB,yBACpB,UACA,WACe;CACf,MAAM,eAAe,2BAA2B,UAAU;CAC1D,MAAM,WAAW,MAAM,WAAW,QAAQ,aAAa,EAAE,EAAE,WAAW,MAAM,CAAC;CAC7E,MAAM,WAAW,UACf,cACA,KAAK,UAAU,UAAU,MAAM,EAAE,EACjC,OACD;;AAGH,SAAgB,0BACd,WACA,UACQ;CACR,MAAM,WAAW,WAAW,KAAK,WAAW,SAAS;CACrD,IAAI,CAAC,GAAG,WAAW,SAAS,EAC1B,OAAO;CAGT,IAAI;EACF,OAAO,GAAG,SAAS,SAAS,CAAC;SACvB;EACN,OAAO;;;AAIX,SAAgB,iBAAiB,WAAmB,UAA2B;CAC7E,OAAO,GAAG,WAAW,WAAW,KAAK,WAAW,SAAS,CAAC"}
+{"version":3,"file":"incremental-manifest.js","names":[],"sources":["../../src/ssg/incremental-manifest.ts"],"sourcesContent":["import * as fs from 'node:fs';\nimport * as fsPromises from 'node:fs/promises';\nimport * as pathModule from 'node:path';\nimport type { RouteRenderStatus, SSGMode } from './types';\n\nexport const SSG_MANIFEST_SCHEMA_VERSION = 1;\nconst MANIFEST_DIR = '.askr';\nconst MANIFEST_FILE = 'ssg-manifest.json';\n\nexport interface IncrementalManifestRouteEntry {\n  routeId: string;\n  path: string;\n  filePath: string;\n  invalidationKeys: string[];\n  htmlHash: string | null;\n  lastStatus: Extract<RouteRenderStatus, 'success' | 'error'>;\n}\n\nexport interface IncrementalManifest {\n  schemaVersion: number;\n  seed: number;\n  mode: SSGMode;\n  routes: IncrementalManifestRouteEntry[];\n}\n\nexport function hashHtml(html: string): string {\n  // Deterministic 32-bit FNV-1a hash is sufficient for incremental change checks.\n  let hash = 0x811c9dc5;\n  for (let index = 0; index < html.length; index += 1) {\n    hash ^= html.charCodeAt(index);\n    hash = Math.imul(hash, 0x01000193);\n  }\n  return (hash >>> 0).toString(16).padStart(8, '0');\n}\n\nexport function getIncrementalManifestPath(outputDir: string): string {\n  return pathModule.join(outputDir, MANIFEST_DIR, MANIFEST_FILE);\n}\n\nexport function readIncrementalManifest(\n  outputDir: string,\n  seed: number\n): IncrementalManifest | null {\n  const manifestPath = getIncrementalManifestPath(outputDir);\n  if (!fs.existsSync(manifestPath)) {\n    return null;\n  }\n\n  try {\n    const raw = fs.readFileSync(manifestPath, 'utf8');\n    const parsed = JSON.parse(raw) as Partial<IncrementalManifest>;\n\n    if (\n      parsed.schemaVersion !== SSG_MANIFEST_SCHEMA_VERSION ||\n      parsed.seed !== seed ||\n      !Array.isArray(parsed.routes)\n    ) {\n      return null;\n    }\n\n    const routes = parsed.routes.filter(\n      (entry): entry is IncrementalManifestRouteEntry =>\n        !!entry &&\n        typeof entry.routeId === 'string' &&\n        typeof entry.path === 'string' &&\n        typeof entry.filePath === 'string' &&\n        Array.isArray(entry.invalidationKeys) &&\n        (entry.htmlHash === null || typeof entry.htmlHash === 'string') &&\n        (entry.lastStatus === 'success' || entry.lastStatus === 'error')\n    );\n\n    if (routes.length !== parsed.routes.length) {\n      return null;\n    }\n\n    return {\n      schemaVersion: SSG_MANIFEST_SCHEMA_VERSION,\n      seed,\n      mode: parsed.mode === 'incremental' ? 'incremental' : 'full',\n      routes,\n    };\n  } catch {\n    return null;\n  }\n}\n\nexport async function writeIncrementalManifest(\n  manifest: IncrementalManifest,\n  outputDir: string\n): Promise<void> {\n  const manifestPath = getIncrementalManifestPath(outputDir);\n  await fsPromises.mkdir(pathModule.dirname(manifestPath), { recursive: true });\n  await fsPromises.writeFile(\n    manifestPath,\n    JSON.stringify(manifest, null, 2),\n    'utf8'\n  );\n}\n\nexport function getExistingOutputFileSize(\n  outputDir: string,\n  filePath: string\n): number {\n  const fullPath = pathModule.join(outputDir, filePath);\n  if (!fs.existsSync(fullPath)) {\n    return 0;\n  }\n\n  try {\n    return fs.statSync(fullPath).size;\n  } catch {\n    return 0;\n  }\n}\n\nexport function outputFileExists(outputDir: string, filePath: string): boolean {\n  return fs.existsSync(pathModule.join(outputDir, filePath));\n}\n"],"mappings":";;;AAMA,MAAM,eAAe;AACrB,MAAM,gBAAgB;AAkBtB,SAAgB,SAAS,MAAsB;CAE7C,IAAI,OAAO;CACX,KAAK,IAAI,QAAQ,GAAG,QAAQ,KAAK,QAAQ,SAAS,GAAG;EACnD,QAAQ,KAAK,WAAW,KAAK;EAC7B,OAAO,KAAK,KAAK,MAAM,QAAU;CACnC;CACA,QAAQ,SAAS,GAAG,SAAS,EAAE,EAAE,SAAS,GAAG,GAAG;AAClD;AAEA,SAAgB,2BAA2B,WAA2B;CACpE,OAAO,WAAW,KAAK,WAAW,cAAc,aAAa;AAC/D;AAEA,SAAgB,wBACd,WACA,MAC4B;CAC5B,MAAM,eAAe,2BAA2B,SAAS;CACzD,IAAI,CAAC,GAAG,WAAW,YAAY,GAC7B,OAAO;CAGT,IAAI;EACF,MAAM,MAAM,GAAG,aAAa,cAAc,MAAM;EAChD,MAAM,SAAS,KAAK,MAAM,GAAG;EAE7B,IACE,OAAO,kBAAA,KACP,OAAO,SAAS,QAChB,CAAC,MAAM,QAAQ,OAAO,MAAM,GAE5B,OAAO;EAGT,MAAM,SAAS,OAAO,OAAO,QAC1B,UACC,CAAC,CAAC,SACF,OAAO,MAAM,YAAY,YACzB,OAAO,MAAM,SAAS,YACtB,OAAO,MAAM,aAAa,YAC1B,MAAM,QAAQ,MAAM,gBAAgB,MACnC,MAAM,aAAa,QAAQ,OAAO,MAAM,aAAa,cACrD,MAAM,eAAe,aAAa,MAAM,eAAe,QAC5D;EAEA,IAAI,OAAO,WAAW,OAAO,OAAO,QAClC,OAAO;EAGT,OAAO;GACL,eAAA;GACA;GACA,MAAM,OAAO,SAAS,gBAAgB,gBAAgB;GACtD;EACF;CACF,QAAQ;EACN,OAAO;CACT;AACF;AAEA,eAAsB,yBACpB,UACA,WACe;CACf,MAAM,eAAe,2BAA2B,SAAS;CACzD,MAAM,WAAW,MAAM,WAAW,QAAQ,YAAY,GAAG,EAAE,WAAW,KAAK,CAAC;CAC5E,MAAM,WAAW,UACf,cACA,KAAK,UAAU,UAAU,MAAM,CAAC,GAChC,MACF;AACF;AAEA,SAAgB,0BACd,WACA,UACQ;CACR,MAAM,WAAW,WAAW,KAAK,WAAW,QAAQ;CACpD,IAAI,CAAC,GAAG,WAAW,QAAQ,GACzB,OAAO;CAGT,IAAI;EACF,OAAO,GAAG,SAAS,QAAQ,EAAE;CAC/B,QAAQ;EACN,OAAO;CACT;AACF;AAEA,SAAgB,iBAAiB,WAAmB,UAA2B;CAC7E,OAAO,GAAG,WAAW,WAAW,KAAK,WAAW,QAAQ,CAAC;AAC3D"}

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

@@ -1,3 +1,4 @@
+import { interpolateRoutePath } from "./route-utils.js";
 //#region src/ssg/resolve-ssg-data.ts
 /**
 * Resolve and validate data for SSG routes
@@ -9,23 +10,68 @@
 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;
+	for (const route of routes) {
+		const concretePath = interpolateRoutePath(route.path, route.params);
+		const overridePath = concretePath in dataOverrides ? concretePath : route.path in dataOverrides ? route.path : null;
+		if (overridePath) {
+			const data = dataOverrides[overridePath];
+			if (typeof data !== "object" || data === null || Array.isArray(data)) throw new Error(`data for route "${overridePath}" must be an object, got ${typeof data}`);
+			dataMap[overridePath] = data;
+		}
 	}
 	return dataMap;
 }
+function isStringRecord(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	for (const recordValue of Object.values(value)) if (typeof recordValue !== "string") return false;
+	return true;
+}
+function validateRouteShape(route) {
+	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}"`);
+	if (route.params !== void 0 && !isStringRecord(route.params)) throw new Error(`route "${route.path}" params must be an object containing only string values`);
+	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`);
+	}
+}
+function validateEntriesResult(route, entries) {
+	if (!Array.isArray(entries)) throw new Error(`route "${route.path}" entries must return an array of param maps`);
+	return entries.map((entry, index) => {
+		if (!isStringRecord(entry)) throw new Error(`route "${route.path}" entries[${index}] must be an object containing only string values`);
+		return entry;
+	});
+}
+async function expandRoutes(routes) {
+	if (!Array.isArray(routes)) throw new Error("routes must be an array");
+	const expanded = [];
+	for (const route of routes) {
+		validateRouteShape(route);
+		if (route.params) expanded.push({
+			...route,
+			entries: void 0
+		});
+		if (!route.entries) {
+			if (!route.params) expanded.push(route);
+			continue;
+		}
+		const entries = validateEntriesResult(route, await route.entries());
+		for (const params of entries) expanded.push({
+			...route,
+			params,
+			entries: void 0
+		});
+	}
+	return expanded;
+}
 /**
 * 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}"`);
+		validateRouteShape(route);
 		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);
@@ -34,13 +80,9 @@ function validateRoutes(routes) {
 			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 };
+export { expandRoutes, resolveSsgData, validateRoutes };
 
 //# sourceMappingURL=resolve-ssg-data.js.map

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

@@ -1 +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;CAE3C,KAAK,MAAM,SAAS,QAElB,IAAI,MAAM,QAAQ,eAAe;EAC/B,MAAM,OAAO,cAAc,MAAM;EACjC,IAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,MAAM,QAAQ,KAAK,EAClE,MAAM,IAAI,MACR,mBAAmB,MAAM,KAAK,2BAA2B,OAAO,OACjE;EAEH,QAAQ,MAAM,QAAQ;;CAM1B,OAAO;;;;;AAMT,SAAgB,eAAe,QAA6B;CAC1D,IAAI,CAAC,MAAM,QAAQ,OAAO,EACxB,MAAM,IAAI,MAAM,0BAA0B;CAG5C,IAAI,OAAO,WAAW,GACpB,MAAM,IAAI,MAAM,+BAA+B;CAGjD,MAAM,uBAAO,IAAI,KAAa;CAE9B,KAAK,MAAM,SAAS,QAAQ;EAC1B,IAAI,OAAO,MAAM,SAAS,YAAY,CAAC,MAAM,KAAK,WAAW,IAAI,EAC/D,MAAM,IAAI,MACR,uDAAuD,MAAM,KAAK,GACnE;EAIH,IAAI,QADY,MAAM,WAAW,MAAM,eAChB,YACrB,MAAM,IAAI,MACR,8CAA8C,MAAM,KAAK,GAC1D;EAGH,MAAM,MAAM,GAAG,MAAM,KAAK,IAAI,KAAK,UAAU,MAAM,UAAU,EAAE,CAAC;EAChE,IAAI,KAAK,IAAI,IAAI,EACf,MAAM,IAAI,MACR,4CAA4C,MAAM,KAAK,GACxD;EAEH,KAAK,IAAI,IAAI;EAEb,IAAI,MAAM,KAAK,SAAS,IAAI,EAAE;GAC5B,MAAM,aAAa,MAAM,KAAK,MAAM,KAAK,SAAS,eAAe,CAAC,CAAC,KAChE,MAAM,EAAE,GACV;GACD,IAAI,CAAC,MAAM,QACT,MAAM,IAAI,MACR,UAAU,MAAM,KAAK,4CACtB;GAEH,KAAK,MAAM,QAAQ,YACjB,IAAI,EAAE,QAAQ,MAAM,SAClB,MAAM,IAAI,MACR,UAAU,MAAM,KAAK,4BAA4B,KAAK,GACvD;;EAKP,IAAI,MAAM,qBAAqB,QAAW;GACxC,IAAI,CAAC,MAAM,QAAQ,MAAM,iBAAiB,EACxC,MAAM,IAAI,MACR,UAAU,MAAM,KAAK,gDACtB;GAEH,KAAK,MAAM,OAAO,MAAM,kBACtB,IAAI,OAAO,QAAQ,YAAY,IAAI,WAAW,GAC5C,MAAM,IAAI,MACR,UAAU,MAAM,KAAK,wDACtB"}
+{"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';\nimport { interpolateRoutePath } from './route-utils';\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    const concretePath = interpolateRoutePath(route.path, route.params);\n    const overridePath =\n      concretePath in dataOverrides\n        ? concretePath\n        : route.path in dataOverrides\n          ? route.path\n          : null;\n\n    // Check if user provided data for this route\n    if (overridePath) {\n      const data = dataOverrides[overridePath];\n      if (typeof data !== 'object' || data === null || Array.isArray(data)) {\n        throw new Error(\n          `data for route \"${overridePath}\" must be an object, got ${typeof data}`\n        );\n      }\n      dataMap[overridePath] = 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\nfunction isStringRecord(value: unknown): value is Record<string, string> {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) {\n    return false;\n  }\n\n  for (const recordValue of Object.values(value)) {\n    if (typeof recordValue !== 'string') {\n      return false;\n    }\n  }\n\n  return true;\n}\n\nfunction validateRouteShape(route: RouteConfig): void {\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  if (route.params !== undefined && !isStringRecord(route.params)) {\n    throw new Error(\n      `route \"${route.path}\" params must be an object containing only string values`\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\nfunction validateEntriesResult(\n  route: RouteConfig,\n  entries: unknown\n): Array<Record<string, string>> {\n  if (!Array.isArray(entries)) {\n    throw new Error(\n      `route \"${route.path}\" entries must return an array of param maps`\n    );\n  }\n\n  return entries.map((entry, index) => {\n    if (!isStringRecord(entry)) {\n      throw new Error(\n        `route \"${route.path}\" entries[${index}] must be an object containing only string values`\n      );\n    }\n\n    return entry;\n  });\n}\n\nexport async function expandRoutes(\n  routes: RouteConfig[]\n): Promise<RouteConfig[]> {\n  if (!Array.isArray(routes)) {\n    throw new Error('routes must be an array');\n  }\n\n  const expanded: RouteConfig[] = [];\n\n  for (const route of routes) {\n    validateRouteShape(route);\n\n    if (route.params) {\n      expanded.push({ ...route, entries: undefined });\n    }\n\n    if (!route.entries) {\n      if (!route.params) {\n        expanded.push(route);\n      }\n      continue;\n    }\n\n    const entries = validateEntriesResult(route, await route.entries());\n    for (const params of entries) {\n      expanded.push({ ...route, params, entries: undefined });\n    }\n  }\n\n  return expanded;\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  const seen = new Set<string>();\n\n  for (const route of routes) {\n    validateRouteShape(route);\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}\n"],"mappings":"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"}

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

@@ -1 +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;CACzD,IAAI,YAAY,KACd,OAAO;CAGT,OAAO,GADY,QAAQ,QAAQ,YAAY,GACrC,CAAW;;AAGvB,SAAgB,qBACd,WACA,QACQ;CACR,IAAI,CAAC,QAAQ,OAAO;CACpB,OAAO,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;CACxC,OAAO;EACL;EACA;EACA;EACA,SAAS,GAAG,KAAK,IAAI;EACrB,kBAAkB,MAAM,kBAAkB,OAAO,IAAI,EAAE;EACxD"}
+{"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;CACzD,IAAI,YAAY,KACd,OAAO;CAGT,OAAO,GADY,QAAQ,QAAQ,YAAY,EACrC,EAAW;AACvB;AAEA,SAAgB,qBACd,WACA,QACQ;CACR,IAAI,CAAC,QAAQ,OAAO;CACpB,OAAO,UAAU,QACf,iBACC,GAAG,QAAgB,OAAO,QAAQ,EACrC;AACF;AAEA,SAAgB,uBACd,OACyB;CACzB,MAAM,OAAO,qBAAqB,MAAM,MAAM,MAAM,MAAM;CAC1D,MAAM,WAAW,kBAAkB,IAAI;CACvC,OAAO;EACL;EACA;EACA;EACA,SAAS,GAAG,KAAK,IAAI;EACrB,kBAAkB,MAAM,kBAAkB,MAAM,KAAK,CAAC;CACxD;AACF"}

package/dist/ssg/types.d.ts

@@ -1,19 +1,20 @@
 import { ComponentFunction } from "../common/component.js";
-import { RouteAuthMode, RouteHandler, RoutePolicy } from "../common/router.js";
+import { RouteAuthMode, RouteHandler, RoutePathParams, 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';
+type RouteConfigParams<Path extends string> = string extends Path ? Record<string, string> : RoutePathParams<Path>;
 /**
  * Route config accepted by SSG.
  *
  * `handler` is preferred and matches router/SSR naming.
  * `component` is kept for compatibility and is normalized to `handler`.
  */
-interface RouteConfig {
+interface RouteConfig<Path extends string = string> {
   /** URL path to generate (e.g., "/blog/post-1", "/") */
-  path: string;
+  path: Path;
   /** Route handler compatible with router/SSR */
   handler?: RouteHandler;
   /** Backward-compatible alias for handler */
@@ -31,7 +32,7 @@ interface RouteConfig {
   /** 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>;
+  params?: RouteConfigParams<Path>;
   /** Optional explicit invalidation keys for incremental generation */
   invalidationKeys?: string[];
   /**
@@ -46,12 +47,12 @@ interface RouteConfig {
    * });
    * ```
    */
-  entries?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+  entries?: () => Array<RouteConfigParams<Path>> | Promise<Array<RouteConfigParams<Path>>>;
 }
 /** Options for createStaticGen */
-interface SSGOptions {
+interface SSGOptions<TRoutes extends readonly RouteConfig[] = RouteConfig[]> {
   /** Routes to generate */
-  routes: RouteConfig[];
+  routes: TRoutes;
   /** Output directory for generated HTML files */
   outputDir: string;
   /** Optional seed for deterministic rendering */

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/ssg/types.ts"],"mappings":";;;;KAYY,OAAA;AAAA,KAEA,iBAAA;AAAA,KAEA,iBAAA;AAAA,KAUP,iBAAA,uCAAwD,IAAA,GACzD,MAAA,mBACA,eAAA,CAAgB,IAAA;AAdpB;;;;AAA6B;AAE7B;AAFA,UAsBiB,WAAA;;EAEf,IAAA,EAAM,IAAA;EAtBqB;EAwB3B,OAAA,GAAU,YAAA;EAdU;EAgBpB,SAAA,GAAY,iBAAA;EAhB+C;EAkB3D,KAAA,GAAQ,MAAA;EAhBU;EAkBlB,SAAA;EAlBiB;EAoBjB,IAAA,GAAO,aAAA;EAtBc;EAwBrB,IAAA;EAvBE;EAyBF,UAAA;EAxBkB;EA0BlB,QAAA,YAAoB,WAAA;EA1BE;EA4BtB,MAAA,GAAS,iBAAA,CAAkB,IAAA;EApBD;EAsB1B,gBAAA;EApBM;;;;;;;;;;;;EAiCN,OAAA,SACI,KAAA,CAAM,iBAAA,CAAkB,IAAA,KACxB,OAAA,CAAQ,KAAA,CAAM,iBAAA,CAAkB,IAAA;AAAA;;UAIrB,UAAA,0BACU,WAAA,KAAgB,WAAA;EAL9B;EAQX,MAAA,EAAQ,OAAA;EA3CR;EA6CA,SAAA;EA3CA;EA6CA,IAAA;EA3CA;EA6CA,aAAA,GAAgB,MAAA;EA3ChB;EA6CA,WAAA;EA3CA;EA6CA,WAAA;AAAA;;UAIe,kBAAA;EAzCf;EA2CA,IAAA,GAAO,OAAO;EAzCd;EA2CA,WAAA;EA3C2B;EA6C3B,aAAA;EA9BA;EAgCA,SAAA;AAAA;;UAIe,iBAAA;EAlCH;EAoCZ,IAAA;EApCoC;EAsCpC,QAAA;EAtCwC;EAwCxC,IAAA;EApCyB;EAsCzB,QAAA;EArCyB;EAuCzB,cAAA;EApCQ;EAsCR,aAAA;EAhCsB;EAkCtB,MAAA,EAAQ,iBAAA;EA3CR;EA6CA,MAAA,EAAQ,iBAAiB;EA7CgB;EA+CzC,OAAA;EA5CQ;EA8CR,KAAA;AAAA;;UAIe,SAAA;EA1Cf;EA4CA,WAAA;EA1CW;EA4CX,WAAA;EAxCe;EA0Cf,UAAA;;EAEA,MAAA;EA1CA;EA4CA,aAAA;EA1CA;EA4CA,IAAA,EAAM,OAAA;EAxCN;EA0CA,OAAA;EA1CS;EA4CT,OAAA;EAxCgC;EA0ChC,OAAA;EA1ByB;EA4BzB,SAAA;EAxCA;EA0CA,eAAA;EAtCA;EAwCA,iBAAA;EApCA;EAsCA,MAAA,EAAQ,iBAAiB;AAAA;;UAIV,WAAA,SAAoB,MAAA;EApCnC;EAsCA,WAAA;EApCK;EAsCL,WAAA;EAlCe;EAoCf,UAAA;;EAEA,MAAA;EApCA;EAsCA,aAAA;EAlCA;EAoCA,IAAA,EAAM,OAAA;EAhCN;EAkCA,OAAA;EAhCM;EAkCN,OAAA;EA9BA;EAgCA,OAAA;EA5BA;EA8BA,SAAA;EA1BA;EA4BA,eAAA;EA1BQ;EA4BR,iBAAA;EA5ByB;EA8BzB,MAAA,EAAQ,KAAA;IA1BmB,eA4BzB,IAAA,UAhBI;IAkBJ,QAAA,UAUQ;IARR,QAAA,UAhCiC;IAkCjC,cAAA,UAlCuC;IAoCvC,aAAA,UAlCF;IAoCE,MAAA,EAAQ,iBAAA,EAhCV;IAkCE,MAAA,EAAQ,iBAAA,EA9BV;IAgCE,OAAA,WA9BI;IAgCJ,KAAA;EAAA;AAAA;;UAKa,mBAAA;EAAA,CACd,GAAA;IACC,KAAA;IACA,YAAA;EAAA;AAAA"}

package/dist/ssg/write-static-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-static-files.js","names":[],"sources":["../../src/ssg/write-static-files.ts"],"sourcesContent":["/**\n * File I/O for Static Site Generation\n *\n * Uses Node.js fs/path modules to write rendered HTML files to disk.\n * This module is Node-only and not intended for browser builds.\n */\n\nimport * as fs from 'node:fs/promises';\nimport * as fsSync from 'node:fs';\nimport * as pathModule from 'node:path';\nimport type { RouteRenderResult } from './types';\n\ninterface WriteStaticFilesOptions {\n  concurrency?: number;\n}\n\n/**\n * Write rendered routes to disk\n * Creates outputDir/{route-path}/index.html structure\n */\nexport async function writeStaticFiles(\n  results: RouteRenderResult[],\n  outputDir: string,\n  options: WriteStaticFilesOptions = {}\n): Promise<void> {\n  await fs.mkdir(outputDir, { recursive: true });\n\n  for (const result of results) {\n    if (result.status !== 'removed') {\n      continue;\n    }\n\n    const fullPath = pathModule.join(outputDir, result.filePath);\n    if (fsSync.existsSync(fullPath)) {\n      await fs.rm(fullPath, { force: true });\n      await pruneEmptyDirs(pathModule.dirname(fullPath), outputDir);\n    }\n  }\n\n  const pendingWrites: RouteRenderResult[] = [];\n  for (let index = 0; index < results.length; index += 1) {\n    const result = results[index];\n    if (result.status === 'error') {\n      console.warn(`Skipping failed route: ${result.path} - ${result.error}`);\n      continue;\n    }\n    if (result.status === 'success' && result.written) {\n      pendingWrites.push(result);\n    }\n  }\n\n  const directories: string[] = [];\n  const seenDirectories = new Set<string>();\n  for (const result of pendingWrites) {\n    const dir = pathModule.dirname(pathModule.join(outputDir, result.filePath));\n    if (!seenDirectories.has(dir)) {\n      seenDirectories.add(dir);\n      directories.push(dir);\n    }\n  }\n\n  for (const dir of directories) {\n    await fs.mkdir(dir, { recursive: true });\n  }\n\n  const concurrency = Math.max(\n    1,\n    Math.min(options.concurrency ?? 8, pendingWrites.length || 1)\n  );\n  let nextIndex = 0;\n\n  const worker = async () => {\n    while (true) {\n      const current = nextIndex;\n      nextIndex += 1;\n      if (current >= pendingWrites.length) {\n        return;\n      }\n\n      const result = pendingWrites[current];\n      const fullPath = pathModule.join(outputDir, result.filePath);\n      await fs.writeFile(fullPath, result.html, 'utf8');\n    }\n  };\n\n  await Promise.all(Array.from({ length: concurrency }, () => worker()));\n}\n\n/**\n * Get the output file path for a route\n * E.g., \"/blog/post\" -> \"blog/post\" or \"/\" -> \"\"\n */\nexport { getOutputFilePath } from './route-utils';\n\nasync function pruneEmptyDirs(\n  startDir: string,\n  rootDir: string\n): Promise<void> {\n  let current = startDir;\n  const normalizedRoot = pathModule.resolve(rootDir);\n\n  while (current.startsWith(normalizedRoot)) {\n    if (!fsSync.existsSync(current)) {\n      break;\n    }\n\n    if ((await fs.readdir(current)).length > 0) {\n      break;\n    }\n\n    await fs.rmdir(current);\n    if (pathModule.resolve(current) === normalizedRoot) {\n      break;\n    }\n    current = pathModule.dirname(current);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAoBA,eAAsB,iBACpB,SACA,WACA,UAAmC,EAAE,EACtB;CACf,MAAM,GAAG,MAAM,WAAW,EAAE,WAAW,MAAM,CAAC;CAE9C,KAAK,MAAM,UAAU,SAAS;EAC5B,IAAI,OAAO,WAAW,WACpB;EAGF,MAAM,WAAW,WAAW,KAAK,WAAW,OAAO,SAAS;EAC5D,IAAI,OAAO,WAAW,SAAS,EAAE;GAC/B,MAAM,GAAG,GAAG,UAAU,EAAE,OAAO,MAAM,CAAC;GACtC,MAAM,eAAe,WAAW,QAAQ,SAAS,EAAE,UAAU;;;CAIjE,MAAM,gBAAqC,EAAE;CAC7C,KAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS,GAAG;EACtD,MAAM,SAAS,QAAQ;EACvB,IAAI,OAAO,WAAW,SAAS;GAC7B,QAAQ,KAAK,0BAA0B,OAAO,KAAK,KAAK,OAAO,QAAQ;GACvE;;EAEF,IAAI,OAAO,WAAW,aAAa,OAAO,SACxC,cAAc,KAAK,OAAO;;CAI9B,MAAM,cAAwB,EAAE;CAChC,MAAM,kCAAkB,IAAI,KAAa;CACzC,KAAK,MAAM,UAAU,eAAe;EAClC,MAAM,MAAM,WAAW,QAAQ,WAAW,KAAK,WAAW,OAAO,SAAS,CAAC;EAC3E,IAAI,CAAC,gBAAgB,IAAI,IAAI,EAAE;GAC7B,gBAAgB,IAAI,IAAI;GACxB,YAAY,KAAK,IAAI;;;CAIzB,KAAK,MAAM,OAAO,aAChB,MAAM,GAAG,MAAM,KAAK,EAAE,WAAW,MAAM,CAAC;CAG1C,MAAM,cAAc,KAAK,IACvB,GACA,KAAK,IAAI,QAAQ,eAAe,GAAG,cAAc,UAAU,EAAE,CAC9D;CACD,IAAI,YAAY;CAEhB,MAAM,SAAS,YAAY;EACzB,OAAO,MAAM;GACX,MAAM,UAAU;GAChB,aAAa;GACb,IAAI,WAAW,cAAc,QAC3B;GAGF,MAAM,SAAS,cAAc;GAC7B,MAAM,WAAW,WAAW,KAAK,WAAW,OAAO,SAAS;GAC5D,MAAM,GAAG,UAAU,UAAU,OAAO,MAAM,OAAO;;;CAIrD,MAAM,QAAQ,IAAI,MAAM,KAAK,EAAE,QAAQ,aAAa,QAAQ,QAAQ,CAAC,CAAC;;AASxE,eAAe,eACb,UACA,SACe;CACf,IAAI,UAAU;CACd,MAAM,iBAAiB,WAAW,QAAQ,QAAQ;CAElD,OAAO,QAAQ,WAAW,eAAe,EAAE;EACzC,IAAI,CAAC,OAAO,WAAW,QAAQ,EAC7B;EAGF,KAAK,MAAM,GAAG,QAAQ,QAAQ,EAAE,SAAS,GACvC;EAGF,MAAM,GAAG,MAAM,QAAQ;EACvB,IAAI,WAAW,QAAQ,QAAQ,KAAK,gBAClC;EAEF,UAAU,WAAW,QAAQ,QAAQ"}
+{"version":3,"file":"write-static-files.js","names":[],"sources":["../../src/ssg/write-static-files.ts"],"sourcesContent":["/**\n * File I/O for Static Site Generation\n *\n * Uses Node.js fs/path modules to write rendered HTML files to disk.\n * This module is Node-only and not intended for browser builds.\n */\n\nimport * as fs from 'node:fs/promises';\nimport * as fsSync from 'node:fs';\nimport * as pathModule from 'node:path';\nimport type { RouteRenderResult } from './types';\n\ninterface WriteStaticFilesOptions {\n  concurrency?: number;\n}\n\n/**\n * Write rendered routes to disk\n * Creates outputDir/{route-path}/index.html structure\n */\nexport async function writeStaticFiles(\n  results: RouteRenderResult[],\n  outputDir: string,\n  options: WriteStaticFilesOptions = {}\n): Promise<void> {\n  await fs.mkdir(outputDir, { recursive: true });\n\n  for (const result of results) {\n    if (result.status !== 'removed') {\n      continue;\n    }\n\n    const fullPath = pathModule.join(outputDir, result.filePath);\n    if (fsSync.existsSync(fullPath)) {\n      await fs.rm(fullPath, { force: true });\n      await pruneEmptyDirs(pathModule.dirname(fullPath), outputDir);\n    }\n  }\n\n  const pendingWrites: RouteRenderResult[] = [];\n  for (let index = 0; index < results.length; index += 1) {\n    const result = results[index];\n    if (result.status === 'error') {\n      console.warn(`Skipping failed route: ${result.path} - ${result.error}`);\n      continue;\n    }\n    if (result.status === 'success' && result.written) {\n      pendingWrites.push(result);\n    }\n  }\n\n  const directories: string[] = [];\n  const seenDirectories = new Set<string>();\n  for (const result of pendingWrites) {\n    const dir = pathModule.dirname(pathModule.join(outputDir, result.filePath));\n    if (!seenDirectories.has(dir)) {\n      seenDirectories.add(dir);\n      directories.push(dir);\n    }\n  }\n\n  for (const dir of directories) {\n    await fs.mkdir(dir, { recursive: true });\n  }\n\n  const concurrency = Math.max(\n    1,\n    Math.min(options.concurrency ?? 8, pendingWrites.length || 1)\n  );\n  let nextIndex = 0;\n\n  const worker = async () => {\n    while (true) {\n      const current = nextIndex;\n      nextIndex += 1;\n      if (current >= pendingWrites.length) {\n        return;\n      }\n\n      const result = pendingWrites[current];\n      const fullPath = pathModule.join(outputDir, result.filePath);\n      await fs.writeFile(fullPath, result.html, 'utf8');\n    }\n  };\n\n  await Promise.all(Array.from({ length: concurrency }, () => worker()));\n}\n\n/**\n * Get the output file path for a route\n * E.g., \"/blog/post\" -> \"blog/post\" or \"/\" -> \"\"\n */\nexport { getOutputFilePath } from './route-utils';\n\nasync function pruneEmptyDirs(\n  startDir: string,\n  rootDir: string\n): Promise<void> {\n  let current = startDir;\n  const normalizedRoot = pathModule.resolve(rootDir);\n\n  while (current.startsWith(normalizedRoot)) {\n    if (!fsSync.existsSync(current)) {\n      break;\n    }\n\n    if ((await fs.readdir(current)).length > 0) {\n      break;\n    }\n\n    await fs.rmdir(current);\n    if (pathModule.resolve(current) === normalizedRoot) {\n      break;\n    }\n    current = pathModule.dirname(current);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAoBA,eAAsB,iBACpB,SACA,WACA,UAAmC,CAAC,GACrB;CACf,MAAM,GAAG,MAAM,WAAW,EAAE,WAAW,KAAK,CAAC;CAE7C,KAAK,MAAM,UAAU,SAAS;EAC5B,IAAI,OAAO,WAAW,WACpB;EAGF,MAAM,WAAW,WAAW,KAAK,WAAW,OAAO,QAAQ;EAC3D,IAAI,OAAO,WAAW,QAAQ,GAAG;GAC/B,MAAM,GAAG,GAAG,UAAU,EAAE,OAAO,KAAK,CAAC;GACrC,MAAM,eAAe,WAAW,QAAQ,QAAQ,GAAG,SAAS;EAC9D;CACF;CAEA,MAAM,gBAAqC,CAAC;CAC5C,KAAK,IAAI,QAAQ,GAAG,QAAQ,QAAQ,QAAQ,SAAS,GAAG;EACtD,MAAM,SAAS,QAAQ;EACvB,IAAI,OAAO,WAAW,SAAS;GAC7B,QAAQ,KAAK,0BAA0B,OAAO,KAAK,KAAK,OAAO,OAAO;GACtE;EACF;EACA,IAAI,OAAO,WAAW,aAAa,OAAO,SACxC,cAAc,KAAK,MAAM;CAE7B;CAEA,MAAM,cAAwB,CAAC;CAC/B,MAAM,kCAAkB,IAAI,IAAY;CACxC,KAAK,MAAM,UAAU,eAAe;EAClC,MAAM,MAAM,WAAW,QAAQ,WAAW,KAAK,WAAW,OAAO,QAAQ,CAAC;EAC1E,IAAI,CAAC,gBAAgB,IAAI,GAAG,GAAG;GAC7B,gBAAgB,IAAI,GAAG;GACvB,YAAY,KAAK,GAAG;EACtB;CACF;CAEA,KAAK,MAAM,OAAO,aAChB,MAAM,GAAG,MAAM,KAAK,EAAE,WAAW,KAAK,CAAC;CAGzC,MAAM,cAAc,KAAK,IACvB,GACA,KAAK,IAAI,QAAQ,eAAe,GAAG,cAAc,UAAU,CAAC,CAC9D;CACA,IAAI,YAAY;CAEhB,MAAM,SAAS,YAAY;EACzB,OAAO,MAAM;GACX,MAAM,UAAU;GAChB,aAAa;GACb,IAAI,WAAW,cAAc,QAC3B;GAGF,MAAM,SAAS,cAAc;GAC7B,MAAM,WAAW,WAAW,KAAK,WAAW,OAAO,QAAQ;GAC3D,MAAM,GAAG,UAAU,UAAU,OAAO,MAAM,MAAM;EAClD;CACF;CAEA,MAAM,QAAQ,IAAI,MAAM,KAAK,EAAE,QAAQ,YAAY,SAAS,OAAO,CAAC,CAAC;AACvE;AAQA,eAAe,eACb,UACA,SACe;CACf,IAAI,UAAU;CACd,MAAM,iBAAiB,WAAW,QAAQ,OAAO;CAEjD,OAAO,QAAQ,WAAW,cAAc,GAAG;EACzC,IAAI,CAAC,OAAO,WAAW,OAAO,GAC5B;EAGF,KAAK,MAAM,GAAG,QAAQ,OAAO,GAAG,SAAS,GACvC;EAGF,MAAM,GAAG,MAAM,OAAO;EACtB,IAAI,WAAW,QAAQ,OAAO,MAAM,gBAClC;EAEF,UAAU,WAAW,QAAQ,OAAO;CACtC;AACF"}

package/dist/ssr/attrs.js

@@ -1,3 +1,4 @@
+import { getPublicAttributeName } from "../common/attr-names.js";
 import { escapeAttr, needsEscapeAttr, styleObjToCss } from "./escape.js";
 //#region src/ssr/attrs.ts
 const ESCAPED_ATTR_VALUE_CACHE_LIMIT = 512;
@@ -27,7 +28,7 @@ function renderAttrsDirect(props, sink) {
 		if (key === "children" || key === "key" || key === "ref" || key === "dangerouslySetInnerHTML") continue;
 		if (isEventHandler(key)) continue;
 		if (key.charCodeAt(0) === 95) continue;
-		const attrName = key === "className" ? "class" : key;
+		const attrName = getPublicAttributeName(key);
 		if (attrName === "style") {
 			const css = typeof value === "string" ? value : styleObjToCss(value);
 			if (!css) continue;
@@ -66,7 +67,7 @@ function renderAttrs(props, opts) {
 		}
 		if (isEventHandler(key)) continue;
 		if (key.charCodeAt(0) === 95) continue;
-		const attrName = key === "class" || key === "className" ? "class" : key;
+		const attrName = key === "class" ? "class" : getPublicAttributeName(key);
 		if (attrName === "style") {
 			const css = typeof value === "string" ? value : styleObjToCss(value);
 			if (css === null || css === "") continue;