@askrjs/askr 0.0.48 → 0.0.49

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  RouteConfig,\n  RouteRenderReason,\n  RouteRenderResult,\n  SSGGenerateOptions,\n  SSGMode,\n  SSGOptions,\n  SSGResult,\n} from './types';\nimport {\n  expandRoutes,\n  resolveSsgRouteData,\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              document: options.document,\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 resolvedData = resolveSsgRouteData(\n          dataMap,\n          descriptor.route.path,\n          descriptor.path\n        );\n        const baseData = resolvedData.hasData ? resolvedData.data : undefined;\n        const resourceCount =\n          resolvedData.hasData && baseData ? Object.keys(baseData).length : 0;\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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"}
+{"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  RouteRenderResult,\n  SSGGenerateOptions,\n  SSGMode,\n  SSGOptions,\n  SSGResult,\n} from './types';\nimport type { RouteRegistry } from '../common/router';\nimport {\n  resolveSsgRouteData,\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 IncrementalManifestRouteEntry,\n  writeIncrementalManifest,\n  hashHtml,\n  SSG_MANIFEST_SCHEMA_VERSION,\n} from './incremental-manifest';\nimport { resolveRouteDescriptor } from './route-utils';\nimport {\n  collectRemovedRouteResults,\n  dedupeStrings,\n  getRoutesToRender,\n  selectRouteForGeneration,\n  type SelectedRoute,\n} from './generation-plan';\nimport { normalizeStaticRoutes, splitStaticRoutes } from './static-routes';\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\ntype StaticGenRouteSource<TRoutes extends readonly AnyRouteConfig[]> =\n  | {\n      routes: TRoutes & StrictRouteConfigs<TRoutes>;\n      registry?: never;\n    }\n  | {\n      registry: RouteRegistry;\n      routes?: never;\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' | 'registry'> &\n    StaticGenRouteSource<TRoutes>\n) {\n  let result: SSGResult | null = null;\n  const configuredRoutes = normalizeStaticRoutes(options);\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 (configuredRoutes.length === 0) {\n    throw new Error('routes array or route registry 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 splitRoutes = await splitStaticRoutes(configuredRoutes);\n      const routes = splitRoutes.routes;\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      for (const runtimeRoute of splitRoutes.runtimeOnly) {\n        routeResultsById.set(runtimeRoute.routeId, runtimeRoute.result);\n      }\n      const eligibleDescriptors = descriptors;\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              document: options.document,\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 resolvedData = resolveSsgRouteData(\n          dataMap,\n          descriptor.route.path,\n          descriptor.path\n        );\n        const baseData = resolvedData.hasData ? resolvedData.data : undefined;\n        const resourceCount =\n          resolvedData.hasData && baseData ? Object.keys(baseData).length : 0;\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 (const routeId of splitRoutes.outputRouteIds) {\n        const routeResult = routeResultsById.get(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: configuredRoutes.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"],"mappings":"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"}

package/dist/ssg/generation-plan.js

@@ -0,0 +1,70 @@
+//#region src/ssg/generation-plan.ts
+function dedupeStrings(values) {
+	return values ? Array.from(new Set(values)) : [];
+}
+function getRoutesToRender(selected) {
+	const routes = [];
+	for (let index = 0; index < selected.length; index += 1) routes.push(selected[index].descriptor.route);
+	return routes;
+}
+function selectRouteForGeneration(descriptor, previous, mode, changedKeys, changedRoutes) {
+	if (mode === "full") return {
+		descriptor,
+		reason: "full",
+		previous
+	};
+	if (!previous) return {
+		descriptor,
+		reason: "new-route",
+		previous
+	};
+	if (previous.lastStatus === "error" || previous.htmlHash === null) return {
+		descriptor,
+		reason: "new-route",
+		previous
+	};
+	if (descriptor.invalidationKeys.length === 0) return {
+		descriptor,
+		reason: "no-keys",
+		previous
+	};
+	if (changedRoutes.includes(descriptor.path)) return {
+		descriptor,
+		reason: "changed-route",
+		previous
+	};
+	if (descriptor.invalidationKeys.some((key) => changedKeys.includes(key))) return {
+		descriptor,
+		reason: "changed-key",
+		previous
+	};
+	return {
+		descriptor,
+		reason: "unchanged",
+		previous
+	};
+}
+function collectRemovedRouteResults(manifest, currentRouteIds) {
+	if (!manifest) return [];
+	const results = [];
+	for (let index = 0; index < manifest.routes.length; index += 1) {
+		const entry = manifest.routes[index];
+		if (currentRouteIds.has(entry.routeId)) continue;
+		results.push({
+			path: entry.path,
+			filePath: entry.filePath,
+			html: "",
+			fileSize: 0,
+			renderDuration: 0,
+			resourceCount: 0,
+			status: "removed",
+			reason: "deleted",
+			written: false
+		});
+	}
+	return results;
+}
+//#endregion
+export { collectRemovedRouteResults, dedupeStrings, getRoutesToRender, selectRouteForGeneration };
+
+//# sourceMappingURL=generation-plan.js.map

package/dist/ssg/generation-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation-plan.js","names":[],"sources":["../../src/ssg/generation-plan.ts"],"sourcesContent":["/**\n * SSG incremental generation planning.\n */\n\nimport type {\n  RouteConfig,\n  RouteRenderReason,\n  RouteRenderResult,\n  SSGMode,\n} from './types';\nimport type {\n  IncrementalManifest,\n  IncrementalManifestRouteEntry,\n} from './incremental-manifest';\nimport type { ResolvedRouteDescriptor } from './route-utils';\n\nexport interface SelectedRoute {\n  descriptor: ResolvedRouteDescriptor;\n  reason: RouteRenderReason;\n  previous: IncrementalManifestRouteEntry | null;\n}\n\nexport function dedupeStrings(values?: string[]): string[] {\n  return values ? Array.from(new Set(values)) : [];\n}\n\nexport function 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\nexport function 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\nexport function 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":";AAsBA,SAAgB,cAAc,QAA6B;CACzD,OAAO,SAAS,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC;AACjD;AAEA,SAAgB,kBAAkB,UAA0C;CAC1E,MAAM,SAAwB,CAAC;CAC/B,KAAK,IAAI,QAAQ,GAAG,QAAQ,SAAS,QAAQ,SAAS,GACpD,OAAO,KAAK,SAAS,MAAM,CAAC,WAAW,KAAK;CAE9C,OAAO;AACT;AAEA,SAAgB,yBACd,YACA,UACA,MACA,aACA,eACe;CACf,IAAI,SAAS,QACX,OAAO;EAAE;EAAY,QAAQ;EAAQ;CAAS;CAGhD,IAAI,CAAC,UACH,OAAO;EAAE;EAAY,QAAQ;EAAa;CAAS;CAGrD,IAAI,SAAS,eAAe,WAAW,SAAS,aAAa,MAC3D,OAAO;EAAE;EAAY,QAAQ;EAAa;CAAS;CAGrD,IAAI,WAAW,iBAAiB,WAAW,GACzC,OAAO;EAAE;EAAY,QAAQ;EAAW;CAAS;CAGnD,IAAI,cAAc,SAAS,WAAW,IAAI,GACxC,OAAO;EAAE;EAAY,QAAQ;EAAiB;CAAS;CAGzD,IAAI,WAAW,iBAAiB,MAAM,QAAQ,YAAY,SAAS,GAAG,CAAC,GACrE,OAAO;EAAE;EAAY,QAAQ;EAAe;CAAS;CAGvD,OAAO;EAAE;EAAY,QAAQ;EAAa;CAAS;AACrD;AAEA,SAAgB,2BACd,UACA,iBACqB;CACrB,IAAI,CAAC,UACH,OAAO,CAAC;CAGV,MAAM,UAA+B,CAAC;CACtC,KAAK,IAAI,QAAQ,GAAG,QAAQ,SAAS,OAAO,QAAQ,SAAS,GAAG;EAC9D,MAAM,QAAQ,SAAS,OAAO;EAC9B,IAAI,gBAAgB,IAAI,MAAM,OAAO,GACnC;EAEF,QAAQ,KAAK;GACX,MAAM,MAAM;GACZ,UAAU,MAAM;GAChB,MAAM;GACN,UAAU;GACV,gBAAgB;GAChB,eAAe;GACf,QAAQ;GACR,QAAQ;GACR,SAAS;EACX,CAAC;CACH;CAEA,OAAO;AACT"}

package/dist/ssg/incremental-manifest.js

@@ -51,6 +51,6 @@ function outputFileExists(outputDir, filePath) {
 	return fs.existsSync(pathModule.join(outputDir, filePath));
 }
 //#endregion
-export { getExistingOutputFileSize, hashHtml, outputFileExists, readIncrementalManifest, writeIncrementalManifest };
+export { getExistingOutputFileSize, getIncrementalManifestPath, hashHtml, outputFileExists, readIncrementalManifest, writeIncrementalManifest };
 
 //# sourceMappingURL=incremental-manifest.js.map

package/dist/ssg/static-routes.js

@@ -0,0 +1,101 @@
+import { _getBuiltInRoutePolicy } from "../router/policy.js";
+import { getOutputFilePath, interpolateRoutePath, resolveRouteDescriptor } from "./route-utils.js";
+import { expandRoutes } from "./resolve-ssg-data.js";
+//#region src/ssg/static-routes.ts
+function getRuntimeOnlyDiagnostic(route, path) {
+	const policies = route.policies ?? [];
+	if (route.auth === true) return `Skipped prerender for "${path}": authenticated routes are runtime-only by default.`;
+	if (route.role) return `Skipped prerender for "${path}": role-gated routes are runtime-only by default.`;
+	if (route.permission) return `Skipped prerender for "${path}": permission-gated routes are runtime-only by default.`;
+	if (policies.length > 0) {
+		let hasAuthPolicy = false;
+		let hasRolePolicy = false;
+		let hasPermissionPolicy = false;
+		for (const policy of policies) {
+			const metadata = _getBuiltInRoutePolicy(policy);
+			if (!metadata) return `Skipped prerender for "${path}": routes with custom policies are runtime-only by default.`;
+			if (metadata.kind === "auth") hasAuthPolicy = true;
+			else if (metadata.kind === "role") hasRolePolicy = true;
+			else if (metadata.kind === "permission") hasPermissionPolicy = true;
+		}
+		if (hasAuthPolicy) return `Skipped prerender for "${path}": authenticated routes are runtime-only by default.`;
+		if (hasRolePolicy) return `Skipped prerender for "${path}": role-gated routes are runtime-only by default.`;
+		if (hasPermissionPolicy) return `Skipped prerender for "${path}": permission-gated routes are runtime-only by default.`;
+		return null;
+	}
+	return null;
+}
+function getRouteResultPath(route) {
+	return route.params ? interpolateRoutePath(route.path, route.params) : route.path;
+}
+function createRuntimeOnlyRoute(route, diagnostic) {
+	const path = getRouteResultPath(route);
+	const filePath = getOutputFilePath(path);
+	return {
+		routeId: `${path}::${filePath}`,
+		result: {
+			path,
+			filePath,
+			html: "",
+			fileSize: 0,
+			renderDuration: 0,
+			resourceCount: 0,
+			status: "skipped",
+			reason: "runtime-only",
+			written: false,
+			error: diagnostic
+		}
+	};
+}
+async function splitStaticRoutes(routes) {
+	const prerenderableRoutes = [];
+	const runtimeOnly = [];
+	const outputRouteIds = [];
+	for (const route of routes) {
+		const diagnostic = getRuntimeOnlyDiagnostic(route, getRouteResultPath(route));
+		if (diagnostic) {
+			const runtimeRoute = createRuntimeOnlyRoute(route, diagnostic);
+			runtimeOnly.push(runtimeRoute);
+			outputRouteIds.push(runtimeRoute.routeId);
+			continue;
+		}
+		const expanded = await expandRoutes([route]);
+		prerenderableRoutes.push(...expanded);
+		for (const expandedRoute of expanded) outputRouteIds.push(resolveRouteDescriptor(expandedRoute).routeId);
+	}
+	return {
+		routes: prerenderableRoutes,
+		runtimeOnly,
+		outputRouteIds
+	};
+}
+function normalizeStaticRoutes(options) {
+	if (options.registry) return routeRegistryToRouteConfigs(options.registry);
+	return [...options.routes ?? []];
+}
+function routeRegistryToRouteConfigs(registry) {
+	const routeConfigs = [];
+	for (const record of registry.manifest.records) {
+		if (record.isFallback) continue;
+		routeConfigs.push({
+			path: record.path,
+			handler: record.handler,
+			namespace: record.options.namespace,
+			auth: record.options.auth,
+			role: record.options.role,
+			permission: record.options.permission,
+			policies: stripRegistryGuestPolicies(record.options.policies),
+			entries: record.options.entries
+		});
+	}
+	return routeConfigs;
+}
+function stripRegistryGuestPolicies(policies) {
+	if (!policies || policies.length === 0) return;
+	const filtered = policies.filter((policy) => _getBuiltInRoutePolicy(policy)?.kind !== "guest");
+	return filtered.length > 0 ? filtered : void 0;
+}
+//#endregion
+export { normalizeStaticRoutes, splitStaticRoutes };
+
+//# sourceMappingURL=static-routes.js.map

package/dist/ssg/static-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-routes.js","names":[],"sources":["../../src/ssg/static-routes.ts"],"sourcesContent":["/**\n * SSG route source normalization and runtime-only filtering.\n */\n\nimport type { RouteConfig, RouteRenderResult } from './types';\nimport type { RoutePolicy, RouteRegistry } from '../common/router';\nimport { _getBuiltInRoutePolicy } from '../router/policy';\nimport { expandRoutes } from './resolve-ssg-data';\nimport {\n  getOutputFilePath,\n  interpolateRoutePath,\n  resolveRouteDescriptor,\n} from './route-utils';\n\ntype StaticRouteSource = {\n  registry?: RouteRegistry;\n  routes?: readonly RouteConfig[];\n};\n\nexport type RuntimeOnlyRoute = {\n  routeId: string;\n  result: RouteRenderResult;\n};\n\nexport interface SplitStaticRoutesResult {\n  routes: RouteConfig[];\n  runtimeOnly: RuntimeOnlyRoute[];\n  outputRouteIds: string[];\n}\n\nfunction getRuntimeOnlyDiagnostic(\n  route: RouteConfig,\n  path: string\n): string | null {\n  const policies = route.policies ?? [];\n\n  if (route.auth === true) {\n    return `Skipped prerender for \"${path}\": authenticated routes are runtime-only by default.`;\n  }\n\n  if (route.role) {\n    return `Skipped prerender for \"${path}\": role-gated routes are runtime-only by default.`;\n  }\n\n  if (route.permission) {\n    return `Skipped prerender for \"${path}\": permission-gated routes are runtime-only by default.`;\n  }\n\n  if (policies.length > 0) {\n    let hasAuthPolicy = false;\n    let hasRolePolicy = false;\n    let hasPermissionPolicy = false;\n\n    for (const policy of policies) {\n      const metadata = _getBuiltInRoutePolicy(policy);\n      if (!metadata) {\n        return `Skipped prerender for \"${path}\": routes with custom policies are runtime-only by default.`;\n      }\n\n      if (metadata.kind === 'auth') {\n        hasAuthPolicy = true;\n      } else if (metadata.kind === 'role') {\n        hasRolePolicy = true;\n      } else if (metadata.kind === 'permission') {\n        hasPermissionPolicy = true;\n      }\n    }\n\n    if (hasAuthPolicy) {\n      return `Skipped prerender for \"${path}\": authenticated routes are runtime-only by default.`;\n    }\n\n    if (hasRolePolicy) {\n      return `Skipped prerender for \"${path}\": role-gated routes are runtime-only by default.`;\n    }\n\n    if (hasPermissionPolicy) {\n      return `Skipped prerender for \"${path}\": permission-gated routes are runtime-only by default.`;\n    }\n\n    return null;\n  }\n\n  return null;\n}\n\nfunction getRouteResultPath(route: RouteConfig): string {\n  return route.params\n    ? interpolateRoutePath(route.path, route.params)\n    : route.path;\n}\n\nfunction createRuntimeOnlyRoute(\n  route: RouteConfig,\n  diagnostic: string\n): RuntimeOnlyRoute {\n  const path = getRouteResultPath(route);\n  const filePath = getOutputFilePath(path);\n\n  return {\n    routeId: `${path}::${filePath}`,\n    result: {\n      path,\n      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  };\n}\n\nexport async function splitStaticRoutes(\n  routes: readonly RouteConfig[]\n): Promise<SplitStaticRoutesResult> {\n  const prerenderableRoutes: RouteConfig[] = [];\n  const runtimeOnly: RuntimeOnlyRoute[] = [];\n  const outputRouteIds: string[] = [];\n\n  for (const route of routes) {\n    const routePath = getRouteResultPath(route);\n    const diagnostic = getRuntimeOnlyDiagnostic(route, routePath);\n    if (diagnostic) {\n      const runtimeRoute = createRuntimeOnlyRoute(route, diagnostic);\n      runtimeOnly.push(runtimeRoute);\n      outputRouteIds.push(runtimeRoute.routeId);\n      continue;\n    }\n\n    const expanded = await expandRoutes([route]);\n    prerenderableRoutes.push(...expanded);\n    for (const expandedRoute of expanded) {\n      outputRouteIds.push(resolveRouteDescriptor(expandedRoute).routeId);\n    }\n  }\n\n  return {\n    routes: prerenderableRoutes,\n    runtimeOnly,\n    outputRouteIds,\n  };\n}\n\nexport function normalizeStaticRoutes(\n  options: StaticRouteSource\n): RouteConfig[] {\n  if (options.registry) {\n    return routeRegistryToRouteConfigs(options.registry);\n  }\n\n  return [...(options.routes ?? [])];\n}\n\nfunction routeRegistryToRouteConfigs(registry: RouteRegistry): RouteConfig[] {\n  const routeConfigs: RouteConfig[] = [];\n\n  for (const record of registry.manifest.records) {\n    if (record.isFallback) {\n      continue;\n    }\n\n    routeConfigs.push({\n      path: record.path,\n      handler: record.handler,\n      namespace: record.options.namespace,\n      auth: record.options.auth,\n      role: record.options.role,\n      permission: record.options.permission,\n      policies: stripRegistryGuestPolicies(record.options.policies),\n      entries: record.options.entries,\n    });\n  }\n\n  return routeConfigs;\n}\n\nfunction stripRegistryGuestPolicies(\n  policies: readonly RoutePolicy[] | undefined\n): readonly RoutePolicy[] | undefined {\n  if (!policies || policies.length === 0) {\n    return undefined;\n  }\n\n  const filtered = policies.filter(\n    (policy) => _getBuiltInRoutePolicy(policy)?.kind !== 'guest'\n  );\n\n  return filtered.length > 0 ? filtered : undefined;\n}\n"],"mappings":";;;;AA8BA,SAAS,yBACP,OACA,MACe;CACf,MAAM,WAAW,MAAM,YAAY,CAAC;CAEpC,IAAI,MAAM,SAAS,MACjB,OAAO,0BAA0B,KAAK;CAGxC,IAAI,MAAM,MACR,OAAO,0BAA0B,KAAK;CAGxC,IAAI,MAAM,YACR,OAAO,0BAA0B,KAAK;CAGxC,IAAI,SAAS,SAAS,GAAG;EACvB,IAAI,gBAAgB;EACpB,IAAI,gBAAgB;EACpB,IAAI,sBAAsB;EAE1B,KAAK,MAAM,UAAU,UAAU;GAC7B,MAAM,WAAW,uBAAuB,MAAM;GAC9C,IAAI,CAAC,UACH,OAAO,0BAA0B,KAAK;GAGxC,IAAI,SAAS,SAAS,QACpB,gBAAgB;QACX,IAAI,SAAS,SAAS,QAC3B,gBAAgB;QACX,IAAI,SAAS,SAAS,cAC3B,sBAAsB;EAE1B;EAEA,IAAI,eACF,OAAO,0BAA0B,KAAK;EAGxC,IAAI,eACF,OAAO,0BAA0B,KAAK;EAGxC,IAAI,qBACF,OAAO,0BAA0B,KAAK;EAGxC,OAAO;CACT;CAEA,OAAO;AACT;AAEA,SAAS,mBAAmB,OAA4B;CACtD,OAAO,MAAM,SACT,qBAAqB,MAAM,MAAM,MAAM,MAAM,IAC7C,MAAM;AACZ;AAEA,SAAS,uBACP,OACA,YACkB;CAClB,MAAM,OAAO,mBAAmB,KAAK;CACrC,MAAM,WAAW,kBAAkB,IAAI;CAEvC,OAAO;EACL,SAAS,GAAG,KAAK,IAAI;EACrB,QAAQ;GACN;GACA;GACA,MAAM;GACN,UAAU;GACV,gBAAgB;GAChB,eAAe;GACf,QAAQ;GACR,QAAQ;GACR,SAAS;GACT,OAAO;EACT;CACF;AACF;AAEA,eAAsB,kBACpB,QACkC;CAClC,MAAM,sBAAqC,CAAC;CAC5C,MAAM,cAAkC,CAAC;CACzC,MAAM,iBAA2B,CAAC;CAElC,KAAK,MAAM,SAAS,QAAQ;EAE1B,MAAM,aAAa,yBAAyB,OAD1B,mBAAmB,KACc,CAAS;EAC5D,IAAI,YAAY;GACd,MAAM,eAAe,uBAAuB,OAAO,UAAU;GAC7D,YAAY,KAAK,YAAY;GAC7B,eAAe,KAAK,aAAa,OAAO;GACxC;EACF;EAEA,MAAM,WAAW,MAAM,aAAa,CAAC,KAAK,CAAC;EAC3C,oBAAoB,KAAK,GAAG,QAAQ;EACpC,KAAK,MAAM,iBAAiB,UAC1B,eAAe,KAAK,uBAAuB,aAAa,CAAC,CAAC,OAAO;CAErE;CAEA,OAAO;EACL,QAAQ;EACR;EACA;CACF;AACF;AAEA,SAAgB,sBACd,SACe;CACf,IAAI,QAAQ,UACV,OAAO,4BAA4B,QAAQ,QAAQ;CAGrD,OAAO,CAAC,GAAI,QAAQ,UAAU,CAAC,CAAE;AACnC;AAEA,SAAS,4BAA4B,UAAwC;CAC3E,MAAM,eAA8B,CAAC;CAErC,KAAK,MAAM,UAAU,SAAS,SAAS,SAAS;EAC9C,IAAI,OAAO,YACT;EAGF,aAAa,KAAK;GAChB,MAAM,OAAO;GACb,SAAS,OAAO;GAChB,WAAW,OAAO,QAAQ;GAC1B,MAAM,OAAO,QAAQ;GACrB,MAAM,OAAO,QAAQ;GACrB,YAAY,OAAO,QAAQ;GAC3B,UAAU,2BAA2B,OAAO,QAAQ,QAAQ;GAC5D,SAAS,OAAO,QAAQ;EAC1B,CAAC;CACH;CAEA,OAAO;AACT;AAEA,SAAS,2BACP,UACoC;CACpC,IAAI,CAAC,YAAY,SAAS,WAAW,GACnC;CAGF,MAAM,WAAW,SAAS,QACvB,WAAW,uBAAuB,MAAM,CAAC,EAAE,SAAS,OACvD;CAEA,OAAO,SAAS,SAAS,IAAI,WAAW;AAC1C"}

package/dist/ssg/types.d.ts

@@ -1,12 +1,15 @@
-import { ComponentFunction } from "../common/component.js";
 import { DocumentRenderer } from "../common/ssr.js";
-import { RouteAuthMode, RouteHandler, RoutePathParams, RoutePolicy } from "../common/router.js";
+import { RenderableChild } from "../common/vnode.js";
+import { ComponentFunction } from "../common/component.js";
+import { RouteAuthMode, RouteHandler, RoutePathParams, RoutePolicy, RouteRegistry } 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>;
+type RouteComponentProps<Path extends string> = RouteConfigParams<Path> & Record<string, unknown>;
+type StaticRouteComponent<Path extends string> = (props: RouteComponentProps<Path>, context?: Parameters<ComponentFunction>[1]) => RenderableChild;
 /**
  * Route config accepted by SSG.
  *
@@ -19,7 +22,7 @@ interface RouteConfig<Path extends string = string> {
   /** Route handler compatible with router/SSR */
   handler?: RouteHandler;
   /** Backward-compatible alias for handler */
-  component?: ComponentFunction;
+  component?: StaticRouteComponent<Path>;
   /** Optional base props merged with route params during render */
   props?: Record<string, unknown>;
   /** Optional namespace for router compatibility */
@@ -50,10 +53,7 @@ interface RouteConfig<Path extends string = string> {
    */
   entries?: () => Array<RouteConfigParams<Path>> | Promise<Array<RouteConfigParams<Path>>>;
 }
-/** Options for createStaticGen */
-interface SSGOptions<TRoutes extends readonly RouteConfig[] = RouteConfig[]> {
-  /** Routes to generate */
-  routes: TRoutes;
+interface SSGBaseOptions {
   /** Output directory for generated HTML files */
   outputDir: string;
   /** Optional seed for deterministic rendering */
@@ -67,6 +67,14 @@ interface SSGOptions<TRoutes extends readonly RouteConfig[] = RouteConfig[]> {
   /** Preferred render parallelism. `'auto'` resolves from the host machine. */
   parallelism?: number | 'auto';
 }
+/** Options for createStaticGen */
+type SSGOptions<TRoutes extends readonly RouteConfig[] = RouteConfig[]> = SSGBaseOptions & ({
+  /** Routes to generate. Prefer `registry` when routes are already defined through the router DSL. */routes: TRoutes;
+  registry?: never;
+} | {
+  /** Explicit route registry captured with `createRouteRegistry()`. */registry: RouteRegistry;
+  routes?: never;
+});
 /** Options for a single generation run */
 interface SSGGenerateOptions {
   /** Generation mode */

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../../src/ssg/types.ts"],"mappings":";;;;;KAaY,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,QAAA,GAAW,gBAAA;EA3CX;EA6CA,WAAA;EA3CO;EA6CP,WAAA;AAAA;;UAIe,kBAAA;EAzCf;EA2CA,IAAA,GAAO,OAAO;EA3Ca;EA6C3B,WAAA;EA9BA;EAgCA,aAAA;EA/BU;EAiCV,SAAA;AAAA;;UAIe,iBAAA;EApCqB;EAsCpC,IAAA;EAtCwC;EAwCxC,QAAA;EApCyB;EAsCzB,IAAA;EArCyB;EAuCzB,QAAA;EApCQ;EAsCR,cAAA;EA9BW;EAgCX,aAAA;EAhC2B;EAkC3B,MAAA,EAAQ,iBAAA;EA7CiB;EA+CzB,MAAA,EAAQ,iBAAiB;EA5CzB;EA8CA,OAAA;EA5CA;EA8CA,KAAA;AAAA;;UAIe,SAAA;EA5CJ;EA8CX,WAAA;EA1CA;EA4CA,WAAA;EA5CW;EA8CX,UAAA;EA1CiC;EA4CjC,MAAA;EA1Cc;EA4Cd,aAAA;EA5CO;EA8CP,IAAA,EAAM,OAAA;EA1CN;EA4CA,OAAA;EA1CS;EA4CT,OAAA;EAxCe;EA0Cf,OAAA;;EAEA,SAAA;EA1CA;EA4CA,eAAA;EAxCA;EA0CA,iBAAA;EAtCA;EAwCA,MAAA,EAAQ,iBAAiB;AAAA;;UAIV,WAAA,SAAoB,MAAA;EAtC3B;EAwCR,WAAA;EApCA;EAsCA,WAAA;EAtCK;EAwCL,UAAA;EApCwB;EAsCxB,MAAA;EAZyB;EAczB,aAAA;EApCA;EAsCA,IAAA,EAAM,OAAA;EAlCN;EAoCA,OAAA;EAhCA;EAkCA,OAAA;EAhCA;EAkCA,OAAA;EA9BA;EAgCA,SAAA;EA5BA;EA8BA,eAAA;EA1BA;EA4BA,iBAAA;EA5ByB;EA8BzB,MAAA,EAAQ,KAAA;IA1BO,eA4Bb,IAAA,UA5ByB;IA8BzB,QAAA,UAQQ;IANR,QAAA,UANM;IAQN,cAAA,UAlCuC;IAoCvC,aAAA,UApCiC;IAsCjC,MAAA,EAAQ,iBAAA,EAlCV;IAoCE,MAAA,EAAQ,iBAAA,EAhCV;IAkCE,OAAA,WA9BF;IAgCE,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":"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"}

package/dist/ssr/boundaries.js

@@ -0,0 +1,113 @@
+import { __CONTROL_BOUNDARY__ } from "../common/control.js";
+import { ELEMENT_TYPE } from "../common/jsx.js";
+import { evaluateForState } from "../runtime/for-internal.js";
+import "../runtime/for.js";
+import { evaluateCaseState, evaluateShowState } from "../runtime/control.js";
+import "../jsx/index.js";
+//#region src/ssr/boundaries.ts
+function normalizeRenderableChildren(value) {
+	if (value === null || value === void 0 || value === false) return [];
+	return Array.isArray(value) ? value : [value];
+}
+function getRenderableChildren(node) {
+	if (Array.isArray(node.children)) return node.children;
+	if (Array.isArray(node.props?.children)) return node.props.children;
+	if (node.props?.children !== void 0 && node.props.children !== null && node.props.children !== false) return [node.props.children];
+}
+function getErrorBoundaryState(node) {
+	return node.__instance?.errorBoundaryState ?? null;
+}
+function resetErrorBoundaryState(node) {
+	const state = node.__instance?.errorBoundaryState;
+	if (state) {
+		state.error = null;
+		state.notified = false;
+	}
+}
+function createErrorBoundaryReset(node) {
+	return () => resetErrorBoundaryState(node);
+}
+function createDefaultErrorBoundaryFallbackVNode(error) {
+	const message = error instanceof Error ? error.stack || error.message || error.name : typeof error === "string" ? error : (() => {
+		try {
+			return JSON.stringify(error);
+		} catch {
+			return String(error);
+		}
+	})();
+	return {
+		$$typeof: ELEMENT_TYPE,
+		type: "div",
+		props: {
+			role: "alert",
+			"data-askr-error-boundary": "true",
+			style: {
+				boxSizing: "border-box",
+				padding: "1rem",
+				border: "1px solid currentColor",
+				borderRadius: "0.75rem",
+				display: "grid",
+				gap: "0.75rem",
+				maxWidth: "100%"
+			},
+			children: [
+				{
+					$$typeof: ELEMENT_TYPE,
+					type: "strong",
+					props: { children: ["Something went wrong while rendering this view."] }
+				},
+				{
+					$$typeof: ELEMENT_TYPE,
+					type: "p",
+					props: {
+						style: { margin: "0" },
+						children: ["The app recovered into a visible fallback so the error is not hidden in the console."]
+					}
+				},
+				{
+					$$typeof: ELEMENT_TYPE,
+					type: "details",
+					props: {
+						open: true,
+						children: [{
+							$$typeof: ELEMENT_TYPE,
+							type: "summary",
+							props: { children: ["Error details"] }
+						}, {
+							$$typeof: ELEMENT_TYPE,
+							type: "pre",
+							props: {
+								style: {
+									margin: "0",
+									whiteSpace: "pre-wrap",
+									wordBreak: "break-word"
+								},
+								children: [message]
+							}
+						}]
+					}
+				}
+			]
+		},
+		key: null
+	};
+}
+function resolveErrorBoundaryFallbackNode(fallback, error, reset) {
+	return typeof fallback === "function" ? fallback(error, reset) : fallback !== void 0 ? fallback : createDefaultErrorBoundaryFallbackVNode(error);
+}
+function getControlBoundaryState(node) {
+	const boundaryNode = node;
+	return boundaryNode._controlState ?? boundaryNode._forState ?? null;
+}
+function evaluateControlBoundaryChildren(node) {
+	if (node.type !== __CONTROL_BOUNDARY__) return;
+	const controlState = getControlBoundaryState(node);
+	if (!controlState) return [];
+	if (controlState.kind === "for") return evaluateForState(controlState);
+	if (controlState.kind === "show") return evaluateShowState(controlState);
+	return evaluateCaseState(controlState);
+}
+//#endregion
+export { createErrorBoundaryReset, evaluateControlBoundaryChildren, getControlBoundaryState, getErrorBoundaryState, getRenderableChildren, normalizeRenderableChildren, resetErrorBoundaryState, resolveErrorBoundaryFallbackNode };
+
+//# sourceMappingURL=boundaries.js.map

package/dist/ssr/boundaries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundaries.js","names":[],"sources":["../../src/ssr/boundaries.ts"],"sourcesContent":["/**\n * Shared SSR boundary state and renderable child helpers.\n */\n\nimport type { JSXElement } from '../common/jsx';\nimport { __CONTROL_BOUNDARY__ } from '../common/control';\nimport type { DOMElement } from '../common/vnode';\nimport { ELEMENT_TYPE } from '../jsx';\nimport type { ComponentInstance } from '../runtime/component';\nimport {\n  type ControlBoundaryState,\n  evaluateCaseState,\n  evaluateShowState,\n} from '../runtime/control';\nimport { evaluateForState } from '../runtime/for';\nimport type { VNode } from './types';\n\ntype ErrorBoundaryState = NonNullable<ComponentInstance['errorBoundaryState']>;\n\nexport function normalizeRenderableChildren(value: unknown): unknown[] {\n  if (value === null || value === undefined || value === false) {\n    return [];\n  }\n\n  return Array.isArray(value) ? value : [value];\n}\n\nexport function getRenderableChildren(\n  node: VNode | JSXElement\n): unknown[] | undefined {\n  if (Array.isArray((node as VNode).children)) {\n    return (node as VNode).children;\n  }\n  if (Array.isArray(node.props?.children)) {\n    return node.props.children as unknown[];\n  }\n  if (\n    node.props?.children !== undefined &&\n    node.props.children !== null &&\n    node.props.children !== false\n  ) {\n    return [node.props.children];\n  }\n  return undefined;\n}\n\nexport function getErrorBoundaryState(\n  node: VNode | JSXElement\n): ErrorBoundaryState | null {\n  return (\n    (node as DOMElement & { __instance?: ComponentInstance }).__instance\n      ?.errorBoundaryState ?? null\n  );\n}\n\nexport function resetErrorBoundaryState(node: VNode | JSXElement): void {\n  const instance = (node as DOMElement & { __instance?: ComponentInstance })\n    .__instance;\n  const state = instance?.errorBoundaryState;\n  if (state) {\n    state.error = null;\n    state.notified = false;\n  }\n}\n\nexport function createErrorBoundaryReset(node: VNode | JSXElement): () => void {\n  return () => resetErrorBoundaryState(node);\n}\n\nfunction createDefaultErrorBoundaryFallbackVNode(error: unknown): JSXElement {\n  const message =\n    error instanceof Error\n      ? error.stack || error.message || error.name\n      : typeof error === 'string'\n        ? error\n        : (() => {\n            try {\n              return JSON.stringify(error);\n            } catch {\n              return String(error);\n            }\n          })();\n\n  return {\n    $$typeof: ELEMENT_TYPE,\n    type: 'div',\n    props: {\n      role: 'alert',\n      'data-askr-error-boundary': 'true',\n      style: {\n        boxSizing: 'border-box',\n        padding: '1rem',\n        border: '1px solid currentColor',\n        borderRadius: '0.75rem',\n        display: 'grid',\n        gap: '0.75rem',\n        maxWidth: '100%',\n      },\n      children: [\n        {\n          $$typeof: ELEMENT_TYPE,\n          type: 'strong',\n          props: {\n            children: ['Something went wrong while rendering this view.'],\n          },\n        },\n        {\n          $$typeof: ELEMENT_TYPE,\n          type: 'p',\n          props: {\n            style: { margin: '0' },\n            children: [\n              'The app recovered into a visible fallback so the error is not hidden in the console.',\n            ],\n          },\n        },\n        {\n          $$typeof: ELEMENT_TYPE,\n          type: 'details',\n          props: {\n            open: process.env.NODE_ENV !== 'production',\n            children: [\n              {\n                $$typeof: ELEMENT_TYPE,\n                type: 'summary',\n                props: {\n                  children: ['Error details'],\n                },\n              },\n              {\n                $$typeof: ELEMENT_TYPE,\n                type: 'pre',\n                props: {\n                  style: {\n                    margin: '0',\n                    whiteSpace: 'pre-wrap',\n                    wordBreak: 'break-word',\n                  },\n                  children: [message],\n                },\n              },\n            ],\n          },\n        },\n      ],\n    },\n    key: null,\n  } as JSXElement;\n}\n\nexport function resolveErrorBoundaryFallbackNode(\n  fallback: unknown,\n  error: unknown,\n  reset: () => void\n): unknown {\n  return typeof fallback === 'function'\n    ? (fallback as (error: unknown, reset: () => void) => unknown)(error, reset)\n    : fallback !== undefined\n      ? fallback\n      : createDefaultErrorBoundaryFallbackVNode(error);\n}\n\nexport function getControlBoundaryState(\n  node: VNode | JSXElement\n): ControlBoundaryState | null {\n  const boundaryNode = node as DOMElement;\n\n  return (\n    boundaryNode._controlState ??\n    (boundaryNode._forState as ControlBoundaryState | undefined) ??\n    null\n  );\n}\n\nexport function evaluateControlBoundaryChildren(\n  node: VNode | JSXElement\n): unknown[] | undefined {\n  if (node.type !== __CONTROL_BOUNDARY__) {\n    return undefined;\n  }\n\n  const controlState = getControlBoundaryState(node);\n  if (!controlState) {\n    return [];\n  }\n\n  if (controlState.kind === 'for') {\n    return evaluateForState(controlState);\n  }\n  if (controlState.kind === 'show') {\n    return evaluateShowState(controlState);\n  }\n  return evaluateCaseState(controlState);\n}\n"],"mappings":";;;;;;;AAmBA,SAAgB,4BAA4B,OAA2B;CACrE,IAAI,UAAU,QAAQ,UAAU,UAAa,UAAU,OACrD,OAAO,CAAC;CAGV,OAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,KAAK;AAC9C;AAEA,SAAgB,sBACd,MACuB;CACvB,IAAI,MAAM,QAAS,KAAe,QAAQ,GACxC,OAAQ,KAAe;CAEzB,IAAI,MAAM,QAAQ,KAAK,OAAO,QAAQ,GACpC,OAAO,KAAK,MAAM;CAEpB,IACE,KAAK,OAAO,aAAa,UACzB,KAAK,MAAM,aAAa,QACxB,KAAK,MAAM,aAAa,OAExB,OAAO,CAAC,KAAK,MAAM,QAAQ;AAG/B;AAEA,SAAgB,sBACd,MAC2B;CAC3B,OACG,KAAyD,YACtD,sBAAsB;AAE9B;AAEA,SAAgB,wBAAwB,MAAgC;CAGtE,MAAM,QAFY,KACf,YACqB;CACxB,IAAI,OAAO;EACT,MAAM,QAAQ;EACd,MAAM,WAAW;CACnB;AACF;AAEA,SAAgB,yBAAyB,MAAsC;CAC7E,aAAa,wBAAwB,IAAI;AAC3C;AAEA,SAAS,wCAAwC,OAA4B;CAC3E,MAAM,UACJ,iBAAiB,QACb,MAAM,SAAS,MAAM,WAAW,MAAM,OACtC,OAAO,UAAU,WACf,eACO;EACL,IAAI;GACF,OAAO,KAAK,UAAU,KAAK;EAC7B,QAAQ;GACN,OAAO,OAAO,KAAK;EACrB;CACF,EAAA,CAAG;CAEX,OAAO;EACL,UAAU;EACV,MAAM;EACN,OAAO;GACL,MAAM;GACN,4BAA4B;GAC5B,OAAO;IACL,WAAW;IACX,SAAS;IACT,QAAQ;IACR,cAAc;IACd,SAAS;IACT,KAAK;IACL,UAAU;GACZ;GACA,UAAU;IACR;KACE,UAAU;KACV,MAAM;KACN,OAAO,EACL,UAAU,CAAC,iDAAiD,EAC9D;IACF;IACA;KACE,UAAU;KACV,MAAM;KACN,OAAO;MACL,OAAO,EAAE,QAAQ,IAAI;MACrB,UAAU,CACR,sFACF;KACF;IACF;IACA;KACE,UAAU;KACV,MAAM;KACN,OAAO;MACL,MAAA;MACA,UAAU,CACR;OACE,UAAU;OACV,MAAM;OACN,OAAO,EACL,UAAU,CAAC,eAAe,EAC5B;MACF,GACA;OACE,UAAU;OACV,MAAM;OACN,OAAO;QACL,OAAO;SACL,QAAQ;SACR,YAAY;SACZ,WAAW;QACb;QACA,UAAU,CAAC,OAAO;OACpB;MACF,CACF;KACF;IACF;GACF;EACF;EACA,KAAK;CACP;AACF;AAEA,SAAgB,iCACd,UACA,OACA,OACS;CACT,OAAO,OAAO,aAAa,aACtB,SAA4D,OAAO,KAAK,IACzE,aAAa,SACX,WACA,wCAAwC,KAAK;AACrD;AAEA,SAAgB,wBACd,MAC6B;CAC7B,MAAM,eAAe;CAErB,OACE,aAAa,iBACZ,aAAa,aACd;AAEJ;AAEA,SAAgB,gCACd,MACuB;CACvB,IAAI,KAAK,SAAS,sBAChB;CAGF,MAAM,eAAe,wBAAwB,IAAI;CACjD,IAAI,CAAC,cACH,OAAO,CAAC;CAGV,IAAI,aAAa,SAAS,OACxB,OAAO,iBAAiB,YAAY;CAEtC,IAAI,aAAa,SAAS,QACxB,OAAO,kBAAkB,YAAY;CAEvC,OAAO,kBAAkB,YAAY;AACvC"}

package/dist/ssr/component-runtime.js

@@ -0,0 +1,111 @@
+import { ELEMENT_TYPE, Fragment } from "../common/jsx.js";
+import { getCurrentComponentInstance, setCurrentComponentInstance } from "../runtime/component-scope.js";
+import { cleanupComponent } from "../runtime/component-cleanup.js";
+import { isPromiseLike } from "../common/promise.js";
+import { createComponentInstance } from "../runtime/component-internal.js";
+import "../runtime/component.js";
+import { DefaultPortal, disposeDefaultPortalScope } from "../foundations/structures/portal.js";
+import "../jsx/index.js";
+import { throwSSRDataMissing } from "./context.js";
+//#region src/ssr/component-runtime.ts
+const __ssrGuardStack = [];
+function pushSSRStrictPurityGuard() {
+	__ssrGuardStack.push({
+		random: Reflect.get(Math, "random"),
+		now: Reflect.get(Date, "now")
+	});
+	Reflect.set(Math, "random", () => {
+		throw new Error("SSR Strict Purity: Math.random is not allowed during synchronous SSR. Use the provided `ssr` context RNG instead.");
+	});
+	Reflect.set(Date, "now", () => {
+		throw new Error("SSR Strict Purity: Date.now is not allowed during synchronous SSR. Pass timestamps explicitly or use deterministic helpers.");
+	});
+}
+function popSSRStrictPurityGuard() {
+	const prev = __ssrGuardStack.pop();
+	if (prev) {
+		Reflect.set(Math, "random", prev.random);
+		Reflect.set(Date, "now", prev.now);
+	}
+}
+function executeComponentSync(component, props, ctx) {
+	try {
+		pushSSRStrictPurityGuard();
+		const prev = getCurrentComponentInstance();
+		const temp = createComponentInstance("ssr-temp", component, props || {}, null);
+		temp.ssr = true;
+		temp.portalScope = temp;
+		ctx.ssrCleanupFns.push(() => {
+			let cleanupError = null;
+			try {
+				cleanupComponent(temp);
+			} catch (error) {
+				cleanupError = error;
+			}
+			try {
+				disposeDefaultPortalScope(temp);
+			} catch (error) {
+				if (cleanupError) throw new AggregateError([cleanupError, error], "SSR temporary owner cleanup failed");
+				throw error;
+			}
+			if (cleanupError) throw cleanupError;
+		});
+		setCurrentComponentInstance(temp);
+		try {
+			const result = component(props || {}, { ssr: ctx });
+			if (isPromiseLike(result)) throwSSRDataMissing();
+			if (typeof result === "string" || typeof result === "number" || typeof result === "boolean" || result === null || result === void 0) {
+				const inner = result === null || result === void 0 || result === false ? "" : String(result);
+				return {
+					$$typeof: ELEMENT_TYPE,
+					type: Fragment,
+					props: { children: inner ? [inner] : [] }
+				};
+			}
+			return result;
+		} finally {
+			setCurrentComponentInstance(prev);
+		}
+	} finally {
+		popSSRStrictPurityGuard();
+	}
+}
+function disposeSSRTemporaryOwners(ctx) {
+	const cleanupFns = ctx.ssrCleanupFns;
+	ctx.ssrCleanupFns = [];
+	const cleanupErrors = [];
+	for (let index = cleanupFns.length - 1; index >= 0; index -= 1) try {
+		cleanupFns[index]();
+	} catch (error) {
+		cleanupErrors.push(error);
+	}
+	if (cleanupErrors.length === 1) throw cleanupErrors[0];
+	if (cleanupErrors.length > 1) throw new AggregateError(cleanupErrors, "SSR temporary owner cleanup failed");
+}
+function wrapWithDefaultPortal(out) {
+	if (isPromiseLike(out)) throwSSRDataMissing();
+	const portalVNode = {
+		$$typeof: ELEMENT_TYPE,
+		type: DefaultPortal,
+		props: {},
+		key: "__default_portal"
+	};
+	if (out == null) return {
+		$$typeof: ELEMENT_TYPE,
+		type: Fragment,
+		props: { children: [portalVNode] }
+	};
+	return {
+		$$typeof: ELEMENT_TYPE,
+		type: Fragment,
+		props: { children: [out, portalVNode] }
+	};
+}
+function renderSyncComponentRoot(component, props, ctx) {
+	const wrapped = (p, c) => wrapWithDefaultPortal(component(p ?? {}, c));
+	return executeComponentSync(wrapped, props || {}, ctx);
+}
+//#endregion
+export { disposeSSRTemporaryOwners, executeComponentSync, renderSyncComponentRoot };
+
+//# sourceMappingURL=component-runtime.js.map

package/dist/ssr/component-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-runtime.js","names":[],"sources":["../../src/ssr/component-runtime.ts"],"sourcesContent":["/**\n * SSR component execution and temporary owner lifecycle.\n */\n\nimport type { JSXElement } from '../common/jsx';\nimport type { Props } from '../common/props';\nimport type { ComponentFunction } from '../common/component';\nimport { isPromiseLike } from '../common/promise';\nimport { Fragment, ELEMENT_TYPE } from '../jsx';\nimport { DefaultPortal } from '../foundations/structures/portal';\nimport { disposeDefaultPortalScope } from '../foundations/structures/portal';\nimport {\n  cleanupComponent,\n  createComponentInstance,\n  getCurrentComponentInstance,\n  setCurrentComponentInstance,\n} from '../runtime/component';\nimport { throwSSRDataMissing, type RenderContext } from './context';\nimport type { SSRComponent, VNode } from './types';\n\nexport type Component = SSRComponent;\n\nconst __ssrGuardStack: Array<{ random: () => number; now: () => number }> = [];\n\nfunction pushSSRStrictPurityGuard() {\n  /* istanbul ignore if - dev-only guard */\n  if (process.env.NODE_ENV === 'production') return;\n  __ssrGuardStack.push({\n    random: Reflect.get(Math, 'random') as () => number,\n    now: Reflect.get(Date, 'now') as () => number,\n  });\n  Reflect.set(Math, 'random', () => {\n    throw new Error(\n      'SSR Strict Purity: Math.random is not allowed during synchronous SSR. Use the provided `ssr` context RNG instead.'\n    );\n  });\n  Reflect.set(Date, 'now', () => {\n    throw new Error(\n      'SSR Strict Purity: Date.now is not allowed during synchronous SSR. Pass timestamps explicitly or use deterministic helpers.'\n    );\n  });\n}\n\nfunction popSSRStrictPurityGuard() {\n  /* istanbul ignore if - dev-only guard */\n  if (process.env.NODE_ENV === 'production') return;\n  const prev = __ssrGuardStack.pop();\n  if (prev) {\n    Reflect.set(Math, 'random', prev.random);\n    Reflect.set(Date, 'now', prev.now);\n  }\n}\n\nexport function executeComponentSync(\n  component: Component,\n  props: Record<string, unknown> | undefined,\n  ctx: RenderContext\n): VNode | JSXElement {\n  try {\n    if (process.env.NODE_ENV !== 'production') {\n      pushSSRStrictPurityGuard();\n    }\n    const prev = getCurrentComponentInstance();\n    const temp = createComponentInstance(\n      'ssr-temp',\n      component as ComponentFunction,\n      (props || {}) as Props,\n      null\n    );\n    temp.ssr = true;\n    temp.portalScope = temp;\n    ctx.ssrCleanupFns.push(() => {\n      let cleanupError: unknown = null;\n\n      try {\n        cleanupComponent(temp);\n      } catch (error) {\n        cleanupError = error;\n      }\n\n      try {\n        disposeDefaultPortalScope(temp);\n      } catch (error) {\n        if (cleanupError) {\n          throw new AggregateError(\n            [cleanupError, error],\n            'SSR temporary owner cleanup failed'\n          );\n        }\n        throw error;\n      }\n\n      if (cleanupError) {\n        throw cleanupError;\n      }\n    });\n    setCurrentComponentInstance(temp);\n    try {\n      const result = component((props || {}) as Props, { ssr: ctx });\n      if (isPromiseLike(result)) {\n        throwSSRDataMissing();\n      }\n      if (\n        typeof result === 'string' ||\n        typeof result === 'number' ||\n        typeof result === 'boolean' ||\n        result === null ||\n        result === undefined\n      ) {\n        const inner =\n          result === null || result === undefined || result === false\n            ? ''\n            : String(result);\n        return {\n          $$typeof: ELEMENT_TYPE,\n          type: Fragment,\n          props: { children: inner ? [inner] : [] },\n        } as unknown as VNode | JSXElement;\n      }\n      return result as VNode | JSXElement;\n    } finally {\n      setCurrentComponentInstance(prev);\n    }\n  } finally {\n    if (process.env.NODE_ENV !== 'production') popSSRStrictPurityGuard();\n  }\n}\n\nexport function disposeSSRTemporaryOwners(ctx: RenderContext): void {\n  const cleanupFns = ctx.ssrCleanupFns;\n  ctx.ssrCleanupFns = [];\n  const cleanupErrors: unknown[] = [];\n\n  for (let index = cleanupFns.length - 1; index >= 0; index -= 1) {\n    try {\n      cleanupFns[index]();\n    } catch (error) {\n      cleanupErrors.push(error);\n    }\n  }\n\n  if (cleanupErrors.length === 1) {\n    throw cleanupErrors[0];\n  }\n\n  if (cleanupErrors.length > 1) {\n    throw new AggregateError(\n      cleanupErrors,\n      'SSR temporary owner cleanup failed'\n    );\n  }\n}\n\nfunction wrapWithDefaultPortal(out: unknown): VNode | JSXElement {\n  if (isPromiseLike(out)) {\n    throwSSRDataMissing();\n  }\n\n  const portalVNode = {\n    $$typeof: ELEMENT_TYPE,\n    type: DefaultPortal,\n    props: {},\n    key: '__default_portal',\n  } as unknown;\n\n  if (out == null) {\n    return {\n      $$typeof: ELEMENT_TYPE,\n      type: Fragment,\n      props: { children: [portalVNode] },\n    } as unknown as VNode | JSXElement;\n  }\n\n  return {\n    $$typeof: ELEMENT_TYPE,\n    type: Fragment,\n    props: { children: [out as unknown, portalVNode] },\n  } as unknown as VNode | JSXElement;\n}\n\nexport function renderSyncComponentRoot(\n  component: Component,\n  props: Record<string, unknown> | undefined,\n  ctx: RenderContext\n): VNode | JSXElement {\n  const wrapped: Component = (\n    p?: Record<string, unknown>,\n    c?: { signal?: AbortSignal; ssr?: RenderContext }\n  ) => wrapWithDefaultPortal(component(p ?? {}, c));\n\n  return executeComponentSync(wrapped, props || {}, ctx);\n}\n"],"mappings":";;;;;;;;;;AAsBA,MAAM,kBAAsE,CAAC;AAE7E,SAAS,2BAA2B;CAGlC,gBAAgB,KAAK;EACnB,QAAQ,QAAQ,IAAI,MAAM,QAAQ;EAClC,KAAK,QAAQ,IAAI,MAAM,KAAK;CAC9B,CAAC;CACD,QAAQ,IAAI,MAAM,gBAAgB;EAChC,MAAM,IAAI,MACR,mHACF;CACF,CAAC;CACD,QAAQ,IAAI,MAAM,aAAa;EAC7B,MAAM,IAAI,MACR,6HACF;CACF,CAAC;AACH;AAEA,SAAS,0BAA0B;CAGjC,MAAM,OAAO,gBAAgB,IAAI;CACjC,IAAI,MAAM;EACR,QAAQ,IAAI,MAAM,UAAU,KAAK,MAAM;EACvC,QAAQ,IAAI,MAAM,OAAO,KAAK,GAAG;CACnC;AACF;AAEA,SAAgB,qBACd,WACA,OACA,KACoB;CACpB,IAAI;EAEA,yBAAyB;EAE3B,MAAM,OAAO,4BAA4B;EACzC,MAAM,OAAO,wBACX,YACA,WACC,SAAS,CAAC,GACX,IACF;EACA,KAAK,MAAM;EACX,KAAK,cAAc;EACnB,IAAI,cAAc,WAAW;GAC3B,IAAI,eAAwB;GAE5B,IAAI;IACF,iBAAiB,IAAI;GACvB,SAAS,OAAO;IACd,eAAe;GACjB;GAEA,IAAI;IACF,0BAA0B,IAAI;GAChC,SAAS,OAAO;IACd,IAAI,cACF,MAAM,IAAI,eACR,CAAC,cAAc,KAAK,GACpB,oCACF;IAEF,MAAM;GACR;GAEA,IAAI,cACF,MAAM;EAEV,CAAC;EACD,4BAA4B,IAAI;EAChC,IAAI;GACF,MAAM,SAAS,UAAW,SAAS,CAAC,GAAa,EAAE,KAAK,IAAI,CAAC;GAC7D,IAAI,cAAc,MAAM,GACtB,oBAAoB;GAEtB,IACE,OAAO,WAAW,YAClB,OAAO,WAAW,YAClB,OAAO,WAAW,aAClB,WAAW,QACX,WAAW,QACX;IACA,MAAM,QACJ,WAAW,QAAQ,WAAW,UAAa,WAAW,QAClD,KACA,OAAO,MAAM;IACnB,OAAO;KACL,UAAU;KACV,MAAM;KACN,OAAO,EAAE,UAAU,QAAQ,CAAC,KAAK,IAAI,CAAC,EAAE;IAC1C;GACF;GACA,OAAO;EACT,UAAU;GACR,4BAA4B,IAAI;EAClC;CACF,UAAU;EACmC,wBAAwB;CACrE;AACF;AAEA,SAAgB,0BAA0B,KAA0B;CAClE,MAAM,aAAa,IAAI;CACvB,IAAI,gBAAgB,CAAC;CACrB,MAAM,gBAA2B,CAAC;CAElC,KAAK,IAAI,QAAQ,WAAW,SAAS,GAAG,SAAS,GAAG,SAAS,GAC3D,IAAI;EACF,WAAW,MAAM,CAAC;CACpB,SAAS,OAAO;EACd,cAAc,KAAK,KAAK;CAC1B;CAGF,IAAI,cAAc,WAAW,GAC3B,MAAM,cAAc;CAGtB,IAAI,cAAc,SAAS,GACzB,MAAM,IAAI,eACR,eACA,oCACF;AAEJ;AAEA,SAAS,sBAAsB,KAAkC;CAC/D,IAAI,cAAc,GAAG,GACnB,oBAAoB;CAGtB,MAAM,cAAc;EAClB,UAAU;EACV,MAAM;EACN,OAAO,CAAC;EACR,KAAK;CACP;CAEA,IAAI,OAAO,MACT,OAAO;EACL,UAAU;EACV,MAAM;EACN,OAAO,EAAE,UAAU,CAAC,WAAW,EAAE;CACnC;CAGF,OAAO;EACL,UAAU;EACV,MAAM;EACN,OAAO,EAAE,UAAU,CAAC,KAAgB,WAAW,EAAE;CACnD;AACF;AAEA,SAAgB,wBACd,WACA,OACA,KACoB;CACpB,MAAM,WACJ,GACA,MACG,sBAAsB,UAAU,KAAK,CAAC,GAAG,CAAC,CAAC;CAEhD,OAAO,qBAAqB,SAAS,SAAS,CAAC,GAAG,GAAG;AACvD"}