@askrjs/askr 0.0.43 → 0.0.44

package/dist/ssg/index.d.ts

@@ -1,3 +1,4 @@
+import { DocumentRenderArgs, DocumentRenderContext, DocumentRenderer } from "../common/ssr.js";
 import { DiscoveredResources, RouteConfig, RouteRenderReason, RouteRenderResult, RouteRenderStatus, SSGGenerateOptions, SSGMetadata, SSGMode, SSGOptions, SSGResult } from "./types.js";
 import { createStaticGen } from "./create-static-gen.js";
-export { type DiscoveredResources, type RouteConfig, type RouteRenderReason, type RouteRenderResult, type RouteRenderStatus, type SSGGenerateOptions, type SSGMetadata, type SSGMode, type SSGOptions, type SSGResult, createStaticGen };
+export { type DiscoveredResources, type DocumentRenderArgs, type DocumentRenderContext, type DocumentRenderer, type RouteConfig, type RouteRenderReason, type RouteRenderResult, type RouteRenderStatus, type SSGGenerateOptions, type SSGMetadata, type SSGMode, type SSGOptions, type SSGResult, createStaticGen };

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

@@ -1,5 +1,8 @@
 import { interpolateRoutePath } from "./route-utils.js";
 //#region src/ssg/resolve-ssg-data.ts
+function hasOwnRouteData(dataMap, path) {
+	return Object.prototype.hasOwnProperty.call(dataMap, path);
+}
 /**
 * Resolve and validate data for SSG routes
 * Returns a map of route path -> SSRData
@@ -21,6 +24,20 @@ function resolveSsgData(routes, options = {}) {
 	}
 	return dataMap;
 }
+function resolveSsgRouteData(dataMap, routePath, concretePath) {
+	if (hasOwnRouteData(dataMap, concretePath)) return {
+		hasData: true,
+		data: dataMap[concretePath]
+	};
+	if (hasOwnRouteData(dataMap, routePath)) return {
+		hasData: true,
+		data: dataMap[routePath]
+	};
+	return {
+		hasData: false,
+		data: void 0
+	};
+}
 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;
@@ -83,6 +100,6 @@ function validateRoutes(routes) {
 	}
 }
 //#endregion
-export { expandRoutes, resolveSsgData, validateRoutes };
+export { expandRoutes, resolveSsgData, resolveSsgRouteData, 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';\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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"}
+{"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\nexport interface ResolvedSsgRouteData {\n  hasData: boolean;\n  data?: SSRData;\n}\n\nfunction hasOwnRouteData(\n  dataMap: Record<string, SSRData>,\n  path: string\n): boolean {\n  return Object.prototype.hasOwnProperty.call(dataMap, path);\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\nexport function resolveSsgRouteData(\n  dataMap: Record<string, SSRData>,\n  routePath: string,\n  concretePath: string\n): ResolvedSsgRouteData {\n  if (hasOwnRouteData(dataMap, concretePath)) {\n    return {\n      hasData: true,\n      data: dataMap[concretePath],\n    };\n  }\n\n  if (hasOwnRouteData(dataMap, routePath)) {\n    return {\n      hasData: true,\n      data: dataMap[routePath],\n    };\n  }\n\n  return {\n    hasData: false,\n    data: undefined,\n  };\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":";;AAqBA,SAAS,gBACP,SACA,MACS;CACT,OAAO,OAAO,UAAU,eAAe,KAAK,SAAS,IAAI;AAC3D;;;;;;;;AASA,SAAgB,eACd,QACA,UAAiC,CAAC,GACT;CACzB,MAAM,EAAE,gBAAgB,CAAC,MAAM;CAC/B,MAAM,UAAmC,CAAC;CAE1C,KAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,eAAe,qBAAqB,MAAM,MAAM,MAAM,MAAM;EAClE,MAAM,eACJ,gBAAgB,gBACZ,eACA,MAAM,QAAQ,gBACZ,MAAM,OACN;EAGR,IAAI,cAAc;GAChB,MAAM,OAAO,cAAc;GAC3B,IAAI,OAAO,SAAS,YAAY,SAAS,QAAQ,MAAM,QAAQ,IAAI,GACjE,MAAM,IAAI,MACR,mBAAmB,aAAa,2BAA2B,OAAO,MACpE;GAEF,QAAQ,gBAAgB;EAC1B;CAGF;CAEA,OAAO;AACT;AAEA,SAAgB,oBACd,SACA,WACA,cACsB;CACtB,IAAI,gBAAgB,SAAS,YAAY,GACvC,OAAO;EACL,SAAS;EACT,MAAM,QAAQ;CAChB;CAGF,IAAI,gBAAgB,SAAS,SAAS,GACpC,OAAO;EACL,SAAS;EACT,MAAM,QAAQ;CAChB;CAGF,OAAO;EACL,SAAS;EACT,MAAM;CACR;AACF;AAEA,SAAS,eAAe,OAAiD;CACvE,IAAI,OAAO,UAAU,YAAY,UAAU,QAAQ,MAAM,QAAQ,KAAK,GACpE,OAAO;CAGT,KAAK,MAAM,eAAe,OAAO,OAAO,KAAK,GAC3C,IAAI,OAAO,gBAAgB,UACzB,OAAO;CAIX,OAAO;AACT;AAEA,SAAS,mBAAmB,OAA0B;CACpD,IAAI,OAAO,MAAM,SAAS,YAAY,CAAC,MAAM,KAAK,WAAW,GAAG,GAC9D,MAAM,IAAI,MACR,uDAAuD,MAAM,KAAK,EACpE;CAIF,IAAI,QADY,MAAM,WAAW,MAAM,eAChB,YACrB,MAAM,IAAI,MACR,8CAA8C,MAAM,KAAK,EAC3D;CAGF,IAAI,MAAM,WAAW,UAAa,CAAC,eAAe,MAAM,MAAM,GAC5D,MAAM,IAAI,MACR,UAAU,MAAM,KAAK,yDACvB;CAGF,IAAI,MAAM,qBAAqB,QAAW;EACxC,IAAI,CAAC,MAAM,QAAQ,MAAM,gBAAgB,GACvC,MAAM,IAAI,MACR,UAAU,MAAM,KAAK,+CACvB;EAEF,KAAK,MAAM,OAAO,MAAM,kBACtB,IAAI,OAAO,QAAQ,YAAY,IAAI,WAAW,GAC5C,MAAM,IAAI,MACR,UAAU,MAAM,KAAK,uDACvB;CAGN;AACF;AAEA,SAAS,sBACP,OACA,SAC+B;CAC/B,IAAI,CAAC,MAAM,QAAQ,OAAO,GACxB,MAAM,IAAI,MACR,UAAU,MAAM,KAAK,6CACvB;CAGF,OAAO,QAAQ,KAAK,OAAO,UAAU;EACnC,IAAI,CAAC,eAAe,KAAK,GACvB,MAAM,IAAI,MACR,UAAU,MAAM,KAAK,YAAY,MAAM,kDACzC;EAGF,OAAO;CACT,CAAC;AACH;AAEA,eAAsB,aACpB,QACwB;CACxB,IAAI,CAAC,MAAM,QAAQ,MAAM,GACvB,MAAM,IAAI,MAAM,yBAAyB;CAG3C,MAAM,WAA0B,CAAC;CAEjC,KAAK,MAAM,SAAS,QAAQ;EAC1B,mBAAmB,KAAK;EAExB,IAAI,MAAM,QACR,SAAS,KAAK;GAAE,GAAG;GAAO,SAAS;EAAU,CAAC;EAGhD,IAAI,CAAC,MAAM,SAAS;GAClB,IAAI,CAAC,MAAM,QACT,SAAS,KAAK,KAAK;GAErB;EACF;EAEA,MAAM,UAAU,sBAAsB,OAAO,MAAM,MAAM,QAAQ,CAAC;EAClE,KAAK,MAAM,UAAU,SACnB,SAAS,KAAK;GAAE,GAAG;GAAO;GAAQ,SAAS;EAAU,CAAC;CAE1D;CAEA,OAAO;AACT;;;;AAKA,SAAgB,eAAe,QAA6B;CAC1D,IAAI,CAAC,MAAM,QAAQ,MAAM,GACvB,MAAM,IAAI,MAAM,yBAAyB;CAG3C,MAAM,uBAAO,IAAI,IAAY;CAE7B,KAAK,MAAM,SAAS,QAAQ;EAC1B,mBAAmB,KAAK;EAExB,MAAM,MAAM,GAAG,MAAM,KAAK,IAAI,KAAK,UAAU,MAAM,UAAU,CAAC,CAAC;EAC/D,IAAI,KAAK,IAAI,GAAG,GACd,MAAM,IAAI,MACR,4CAA4C,MAAM,KAAK,EACzD;EAEF,KAAK,IAAI,GAAG;EAEZ,IAAI,MAAM,KAAK,SAAS,GAAG,GAAG;GAC5B,MAAM,aAAa,MAAM,KAAK,MAAM,KAAK,SAAS,cAAc,CAAC,EAAE,KAChE,MAAM,EAAE,EACX;GACA,IAAI,CAAC,MAAM,QACT,MAAM,IAAI,MACR,UAAU,MAAM,KAAK,2CACvB;GAEF,KAAK,MAAM,QAAQ,YACjB,IAAI,EAAE,QAAQ,MAAM,SAClB,MAAM,IAAI,MACR,UAAU,MAAM,KAAK,4BAA4B,KAAK,EACxD;EAGN;CACF;AACF"}

package/dist/ssg/types.d.ts

@@ -1,4 +1,5 @@
 import { ComponentFunction } from "../common/component.js";
+import { DocumentRenderer } from "../common/ssr.js";
 import { RouteAuthMode, RouteHandler, RoutePathParams, RoutePolicy } from "../common/router.js";
 
 //#region src/ssg/types.d.ts
@@ -59,6 +60,8 @@ interface SSGOptions<TRoutes extends readonly RouteConfig[] = RouteConfig[]> {
   seed?: number;
   /** Optional override data for resources (route-keyed) */
   dataOverrides?: Record<string, unknown>;
+  /** Optional document wrapper for full HTML output */
+  document?: DocumentRenderer;
   /** Optional concurrency limit for rendering (default: 10) */
   concurrency?: number;
   /** Preferred render parallelism. `'auto'` resolves from the host machine. */

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

@@ -1 +1 @@
-{"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"}
+{"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"}

package/dist/ssr/context.d.ts

@@ -1,7 +1,6 @@
+import { SSRData } from "../common/ssr.js";
 import { Route, RouteAuthOptions } from "../common/router.js";
 import { SSRDataMissingError } from "../common/ssr-errors.js";
-import { SSRData } from "../common/ssr.js";
-
 //#region src/ssr/context.d.ts
 interface RenderContext {
   url: string;

package/dist/ssr/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","names":[],"sources":["../../src/ssr/context.ts"],"mappings":";;;;;UAgBiB,aAAA;EACf,GAAA;EACA,IAAA;EACA,IAAA,GAAO,OAAA;EACP,MAAA,GAAS,MAAA;EACT,MAAA,YAAkB,KAAA;EAClB,SAAA,GAAY,gBAAA;EACZ,MAAA,GAAS,WAAA;EACT,UAAA,GAAa,GAAA;EACb,aAAA,EAAe,KAAA;EAEf,UAAA;EACA,UAAA,EAAY,MAAA;AAAA;AAAA,KAIF,UAAA,GAAa,aAAa;AAAA,iBAoDtB,mBAAA,CACd,IAAA,WACA,IAAA;EACE,GAAA;EACA,IAAA,GAAO,OAAA;EACP,MAAA,GAAS,MAAA;EACT,MAAA,YAAkB,KAAA;EAClB,SAAA,GAAY,gBAAA;EACZ,MAAA,GAAS,WAAA;AAAA,IAEV,aAAA;;;;;iBAsBa,iBAAA,IAAqB,GAAA,EAAK,aAAA,EAAe,EAAA,QAAU,CAAA,GAAI,CAAA;;AAxFnD;AAIpB;;iBAuGgB,gBAAA,IAAoB,aAAa;AAAA,cASpC,aAAA,SAAa,gBAAmB;AAAA,cAChC,cAAA,SAAc,iBAAoB;AAAA,cAClC,oBAAA,SAAoB,gBAAmB;AAAA,iBAEpC,iBAAA,IAAqB,GAAA,EAAK,aAAA,EAAe,EAAA,QAAU,CAAA,GAAI,CAAA;;;;;iBASvD,mBAAA"}
+{"version":3,"file":"context.d.ts","names":[],"sources":["../../src/ssr/context.ts"],"mappings":";;;;UAgBiB,aAAA;EACf,GAAA;EACA,IAAA;EACA,IAAA,GAAO,OAAA;EACP,MAAA,GAAS,MAAA;EACT,MAAA,YAAkB,KAAA;EAClB,SAAA,GAAY,gBAAA;EACZ,MAAA,GAAS,WAAA;EACT,UAAA,GAAa,GAAA;EACb,aAAA,EAAe,KAAA;EAEf,UAAA;EACA,UAAA,EAAY,MAAA;AAAA;AAAA,KAIF,UAAA,GAAa,aAAa;AAAA,iBAoDtB,mBAAA,CACd,IAAA,WACA,IAAA;EACE,GAAA;EACA,IAAA,GAAO,OAAA;EACP,MAAA,GAAS,MAAA;EACT,MAAA,YAAkB,KAAA;EAClB,SAAA,GAAY,gBAAA;EACZ,MAAA,GAAS,WAAA;AAAA,IAEV,aAAA;;;;;iBAsBa,iBAAA,IAAqB,GAAA,EAAK,aAAA,EAAe,EAAA,QAAU,CAAA,GAAI,CAAA;;AAxFnD;AAIpB;;iBAuGgB,gBAAA,IAAoB,aAAa;AAAA,cASpC,aAAA,SAAa,gBAAmB;AAAA,cAChC,cAAA,SAAc,iBAAoB;AAAA,cAClC,oBAAA,SAAoB,gBAAmB;AAAA,iBAEpC,iBAAA,IAAqB,GAAA,EAAK,aAAA,EAAe,EAAA,QAAU,CAAA,GAAI,CAAA;;;;;iBASvD,mBAAA"}

package/dist/ssr/index.d.ts

@@ -1,7 +1,7 @@
 import { JSXElement } from "../common/jsx.js";
+import { DocumentRenderArgs, DocumentRenderContext, DocumentRenderer, SSRData } from "../common/ssr.js";
 import { RouteAuthOptions, RouteHandler, RouteManifest, RouteRequestResult } from "../common/router.js";
 import { SSRDataMissingError } from "../common/ssr-errors.js";
-import { SSRData } from "../common/ssr.js";
 import { SSRComponent, VNode } from "./types.js";
 import { renderResolvedToStringSync } from "./render-resolved.js";
 
@@ -41,21 +41,20 @@ type SSRRoute = {
   handler: RouteHandler;
   namespace?: string;
 };
-declare function renderToString(component: (props?: Record<string, unknown>) => VNode | JSXElement | string | number | null): string;
-declare function renderToString(opts: {
-  url: string;
-  routes: SSRRoute[];
-  seed?: number;
-  data?: SSRData;
-}): string;
-declare function renderToStream(opts: {
+type RouteRenderOptions = {
   url: string;
   routes: SSRRoute[];
   seed?: number;
   data?: SSRData;
+  document?: DocumentRenderer;
+};
+type RouteStreamOptions = RouteRenderOptions & {
   onChunk(html: string): void;
   onComplete(): void;
-}): void;
+};
+declare function renderToString(component: (props?: Record<string, unknown>) => VNode | JSXElement | string | number | null): string;
+declare function renderToString(opts: RouteRenderOptions): string;
+declare function renderToStream(opts: RouteStreamOptions): void;
 //#endregion
-export { type SSRComponent, SSRDataMissingError, SSRRoute, type VNode, renderResolvedToStringSync, renderToStream, renderToString, renderToStringSync, resolveRequest };
+export { type DocumentRenderArgs, type DocumentRenderContext, type DocumentRenderer, type SSRComponent, SSRDataMissingError, SSRRoute, type VNode, renderResolvedToStringSync, renderToStream, renderToString, renderToStringSync, resolveRequest };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/ssr/index.ts"],"mappings":";;;;;;;;;;;;;iBAusCgB,kBAAA,CACd,SAAA,GACE,KAAA,GAAQ,MAAA,sBACL,KAAA,GAAQ,UAAA,iDACb,KAAA,GAAQ,MAAA,mBACR,OAAA;EAAY,IAAA;EAAe,IAAA,GAAO,OAAA;AAAA;AAAA,iBAgCd,cAAA,CACpB,IAAA;EAEM,GAAA;EACA,QAAA,EAAU,aAAA;EACV,MAAA,GAAS,KAAA;IACP,IAAA;IACA,OAAA,EAAS,YAAA;IACT,SAAA;EAAA;EAEF,IAAA,GAAO,gBAAA;EACP,MAAA,GAAS,WAAA;AAAA;EAGT,GAAA;EACA,QAAA,GAAW,aAAA;EACX,MAAA,EAAQ,KAAA;IACN,IAAA;IACA,OAAA,EAAS,YAAA;IACT,SAAA;EAAA;EAEF,IAAA,GAAO,gBAAA;EACP,MAAA,GAAS,WAAA;AAAA,IAEd,OAAA,CAAQ,kBAAA;AAAA,KAsCC,QAAA;EACV,IAAA;EACA,OAAA,EAAS,YAAY;EACrB,SAAA;AAAA;AAAA,iBAGc,cAAA,CACd,SAAA,GACE,KAAA,GAAQ,MAAA,sBACL,KAAA,GAAQ,UAAA;AAAA,iBAEC,cAAA,CAAe,IAAA;EAC7B,GAAA;EACA,MAAA,EAAQ,QAAA;EACR,IAAA;EACA,IAAA,GAAO,OAAO;AAAA;AAAA,iBAuBA,cAAA,CAAe,IAAA;EAC7B,GAAA;EACA,MAAA,EAAQ,QAAA;EACR,IAAA;EACA,IAAA,GAAO,OAAO;EACd,OAAA,CAAQ,IAAA;EACR,UAAA;AAAA"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/ssr/index.ts"],"mappings":";;;;;;;;;;;;;iBAosCgB,kBAAA,CACd,SAAA,GACE,KAAA,GAAQ,MAAA,sBACL,KAAA,GAAQ,UAAA,iDACb,KAAA,GAAQ,MAAA,mBACR,OAAA;EAAY,IAAA;EAAe,IAAA,GAAO,OAAA;AAAA;AAAA,iBAgCd,cAAA,CACpB,IAAA;EAEM,GAAA;EACA,QAAA,EAAU,aAAA;EACV,MAAA,GAAS,KAAA;IACP,IAAA;IACA,OAAA,EAAS,YAAA;IACT,SAAA;EAAA;EAEF,IAAA,GAAO,gBAAA;EACP,MAAA,GAAS,WAAA;AAAA;EAGT,GAAA;EACA,QAAA,GAAW,aAAA;EACX,MAAA,EAAQ,KAAA;IACN,IAAA;IACA,OAAA,EAAS,YAAA;IACT,SAAA;EAAA;EAEF,IAAA,GAAO,gBAAA;EACP,MAAA,GAAS,WAAA;AAAA,IAEd,OAAA,CAAQ,kBAAA;AAAA,KAsCC,QAAA;EACV,IAAA;EACA,OAAA,EAAS,YAAY;EACrB,SAAA;AAAA;AAAA,KAGG,kBAAA;EACH,GAAA;EACA,MAAA,EAAQ,QAAA;EACR,IAAA;EACA,IAAA,GAAO,OAAA;EACP,QAAA,GAAW,gBAAA;AAAA;AAAA,KAGR,kBAAA,GAAqB,kBAAkB;EAC1C,OAAA,CAAQ,IAAA;EACR,UAAA;AAAA;AAAA,iBAiGc,cAAA,CACd,SAAA,GACE,KAAA,GAAQ,MAAA,sBACL,KAAA,GAAQ,UAAA;AAAA,iBAEC,cAAA,CAAe,IAAwB,EAAlB,kBAAkB;AAAA,iBAiBvC,cAAA,CAAe,IAAwB,EAAlB,kBAAkB"}

package/dist/ssr/index.js

@@ -10,10 +10,10 @@ import { evaluateCaseState, evaluateShowState } from "../runtime/control.js";
 import { SSRDataMissingError } from "../common/ssr-errors.js";
 import { VOID_ELEMENTS, escapeText, styleObjToCss } from "./escape.js";
 import { createRenderContext, getRenderContext, throwSSRDataMissing, withRenderContext } from "./context.js";
-import { resolveRouteFromRoutes, resolveRouteRequest } from "../router/route.js";
+import { _resolveRouteMatchFromRoutes, resolveRouteFromRoutes, resolveRouteRequest } from "../router/route.js";
 import "../jsx/index.js";
 import { DefaultPortal, disposeDefaultPortalScope } from "../foundations/structures/portal.js";
-import { SSR_RENDER_DATA_ATTR } from "../common/ssr.js";
+import { SSR_RENDER_DATA_ATTR, renderDocument } from "../common/ssr.js";
 import { getCurrentRenderData, getNextKey, startRenderPhase, stopRenderPhase } from "./render-keys.js";
 import { installSSRBridge } from "../runtime/ssr-bridge.js";
 import { renderAttrs, renderAttrsDirect } from "./attrs.js";
@@ -65,24 +65,35 @@ function popSSRStrictPurityGuard() {
 /**
 * Synchronous rendering helpers (used for strictly synchronous SSR)
 */
-function renderChildSync(child, ctx) {
-	if (typeof child === "string") return escapeText(child);
-	if (typeof child === "number") return escapeText(String(child));
-	if (child === null || child === void 0 || child === false) return "";
-	if (child && typeof child === "object" && "type" in child) return renderNodeSync(child, ctx);
+function renderRenderableSync(value, ctx) {
+	if (typeof value === "string") return escapeText(value);
+	if (typeof value === "number") return escapeText(String(value));
+	if (value === null || value === void 0 || value === false) return "";
+	if (Array.isArray(value)) return renderChildrenSync(value, ctx);
+	if (value && typeof value === "object" && "type" in value) return renderNodeSync(value, ctx);
 	return "";
 }
-function renderChildSyncToSink(child, sink, ctx) {
-	if (child === null || child === void 0 || child === false) return;
-	if (typeof child === "string") {
-		sink.write(escapeText(child));
+function renderChildSync(child, ctx) {
+	return renderRenderableSync(child, ctx);
+}
+function renderRenderableSyncToSink(value, sink, ctx) {
+	if (value === null || value === void 0 || value === false) return;
+	if (typeof value === "string") {
+		sink.write(escapeText(value));
 		return;
 	}
-	if (typeof child === "number") {
-		sink.write(escapeText(String(child)));
+	if (typeof value === "number") {
+		sink.write(escapeText(String(value)));
 		return;
 	}
-	if (child && typeof child === "object" && "type" in child) renderNodeSyncToSink(child, sink, ctx);
+	if (Array.isArray(value)) {
+		renderChildrenSyncToSink(value, sink, ctx);
+		return;
+	}
+	if (value && typeof value === "object" && "type" in value) renderNodeSyncToSink(value, sink, ctx);
+}
+function renderChildSyncToSink(child, sink, ctx) {
+	renderRenderableSyncToSink(child, sink, ctx);
 }
 function serializeHydrationRenderData(data) {
 	if (!data || Object.keys(data).length === 0) return "";
@@ -195,19 +206,7 @@ function evaluateControlBoundaryChildren(node) {
 function renderChildrenSyncToSink(children, sink, ctx) {
 	if (!children || !Array.isArray(children) || children.length === 0) return;
 	if (children.length >= 32) {
-		for (let i = 0; i < children.length; i++) {
-			const child = children[i];
-			if (child === null || child === void 0 || child === false) continue;
-			if (typeof child === "string") {
-				sink.write(escapeText(child));
-				continue;
-			}
-			if (typeof child === "number") {
-				sink.write(escapeText(String(child)));
-				continue;
-			}
-			if (child && typeof child === "object" && "type" in child) renderNodeSyncToSink(child, sink, ctx);
-		}
+		for (let i = 0; i < children.length; i++) renderRenderableSyncToSink(children[i], sink, ctx);
 		return;
 	}
 	for (let i = 0; i < children.length; i++) renderChildSyncToSink(children[i], sink, ctx);
@@ -238,14 +237,10 @@ function renderNodeSync(node, ctx) {
 	if (__SSR_DEBUG) try {
 		logger.warn("[SSR] renderNodeSync type:", typeof type, type);
 	} catch {}
-	if (typeof type === "function") {
-		const result = executeComponentSync(type, props, ctx);
-		if (isPromiseLike(result)) throwSSRDataMissing();
-		return renderNodeSync(result, ctx);
-	}
+	if (typeof type === "function") return renderRenderableSync(inheritRenderableKey(node, executeComponentSync(type, props, ctx)), ctx);
 	if (typeof type === "symbol") {
 		if (type === Fragment) {
-			const childrenArr = Array.isArray(node.children) ? node.children : Array.isArray(props?.children) ? props?.children : void 0;
+			const childrenArr = getRenderableChildren(node);
 			/* istanbul ignore if - dev-only debug */
 			if (__SSR_DEBUG) try {
 				logger.warn("[SSR] fragment children length:", childrenArr?.length);
@@ -283,19 +278,19 @@ function renderNodeSync(node, ctx) {
 	if (maybeDangerous !== void 0 && maybeDangerous !== null) {
 		const { attrs, dangerousHtml } = renderAttrs(props, { returnDangerousHtml: true });
 		if (dangerousHtml !== void 0) return `<${typeStr}${attrs}>${dangerousHtml}</${typeStr}>`;
-		return `<${typeStr}${attrs}>${renderChildrenSync(node.children, ctx)}</${typeStr}>`;
+		return `<${typeStr}${attrs}>${renderChildrenSync(getRenderableChildren(node), ctx)}</${typeStr}>`;
 	}
-	return `<${typeStr}${renderAttrs(props)}>${renderChildrenSync(node.children, ctx)}</${typeStr}>`;
+	return `<${typeStr}${renderAttrs(props)}>${renderChildrenSync(getRenderableChildren(node), ctx)}</${typeStr}>`;
 }
 function renderNodeSyncToSink(node, sink, ctx) {
 	const { type, props } = node;
 	if (typeof type === "function") {
-		renderNodeSyncToSink(inheritRenderableKey(node, executeComponentSync(type, props, ctx)), sink, ctx);
+		renderRenderableSyncToSink(inheritRenderableKey(node, executeComponentSync(type, props, ctx)), sink, ctx);
 		return;
 	}
 	if (typeof type === "symbol") {
 		if (type === Fragment) {
-			renderChildrenSyncToSink(Array.isArray(node.children) ? node.children : Array.isArray(props?.children) ? props?.children : void 0, sink, ctx);
+			renderChildrenSyncToSink(getRenderableChildren(node), sink, ctx);
 			return;
 		}
 		if (type === __CONTROL_BOUNDARY__) {
@@ -344,16 +339,11 @@ function renderNodeSyncToSink(node, sink, ctx) {
 		renderAttrsDirect(props, sink);
 		sink.write(">");
 		if (dangerousHtml !== void 0) sink.write(dangerousHtml);
-		else renderChildrenSyncToSink(node.children, sink, ctx);
+		else renderChildrenSyncToSink(getRenderableChildren(node), sink, ctx);
 		sinkWrite3(sink, "</", typeStr, ">");
 		return;
 	}
-	let children = node.children;
-	if (children === void 0 && props?.children !== void 0) {
-		const propsChildren = props.children;
-		if (Array.isArray(propsChildren)) children = propsChildren;
-		else if (propsChildren !== null && propsChildren !== false) children = [propsChildren];
-	}
+	const children = getRenderableChildren(node);
 	if (!children || Array.isArray(children) && children.length === 0) {
 		sinkWrite2(sink, "<", typeStr);
 		renderAttrsDirect(props, sink);
@@ -532,10 +522,11 @@ function verifyExpectedNode(node, state, ctx) {
 		state.pendingText += String(node);
 		return true;
 	}
+	if (Array.isArray(node)) return verifyExpectedChildren(node, state, ctx);
 	if (!node || typeof node !== "object" || !("type" in node)) return true;
 	const vnode = node;
 	const { type, props } = vnode;
-	if (typeof type === "function") return verifyExpectedNode(inheritRenderableKey(vnode, executeComponentSync(type, props, ctx)), state, ctx);
+	if (typeof type === "function") return verifyRenderableNode(inheritRenderableKey(vnode, executeComponentSync(type, props, ctx)), state, ctx);
 	if (typeof type === "symbol") {
 		if (type === __CONTROL_BOUNDARY__) {
 			const children = evaluateControlBoundaryChildren(vnode);
@@ -655,6 +646,64 @@ async function resolveRequest(opts) {
 		params: resolved.params
 	};
 }
+function resolveSSRRouteRender(opts) {
+	const { url, routes, seed = 12345, data, document } = opts;
+	const routeTable = routes.map((route) => ({ ...route }));
+	const requestUrl = new URL(url, "http://localhost");
+	const matched = _resolveRouteMatchFromRoutes(requestUrl.pathname, routeTable);
+	if (!matched) throw new Error(`SSR: no route found for url: ${url}`);
+	const ctx = createRenderContext(seed, {
+		url,
+		data,
+		params: matched.params,
+		routes: routeTable
+	});
+	return {
+		url,
+		requestUrl,
+		route: matched.route,
+		params: matched.params,
+		seed,
+		data,
+		ctx,
+		document
+	};
+}
+function buildDocumentRenderArgs(resolved, appHtml) {
+	return {
+		appHtml,
+		context: {
+			mode: "ssr",
+			url: resolved.url,
+			pathname: resolved.requestUrl.pathname,
+			search: resolved.requestUrl.search,
+			hash: resolved.requestUrl.hash,
+			params: resolved.params,
+			data: resolved.data,
+			seed: resolved.seed,
+			route: {
+				path: resolved.route.path,
+				namespace: resolved.route.namespace
+			}
+		}
+	};
+}
+function renderResolvedRouteAppToSink(resolved, sink) {
+	const { ctx, data, route, params } = resolved;
+	withRenderContext(ctx, () => {
+		startRenderPhase(data || null);
+		try {
+			renderRenderableSyncToSink(executeComponentSync(route.handler, params, ctx), sink, ctx);
+			sink.write(serializeHydrationRenderData(data));
+		} finally {
+			try {
+				stopRenderPhase();
+			} finally {
+				disposeSSRTemporaryOwners(ctx);
+			}
+		}
+	});
+}
 function renderToString(arg) {
 	if (typeof arg === "function") return renderToStringSync(arg);
 	const opts = arg;
@@ -675,29 +724,16 @@ function renderToStream(opts) {
 	sink.end();
 }
 function renderToSinkInternal(opts) {
-	const { url, routes, seed = 12345, data, sink } = opts;
-	const routeTable = routes.map((route) => ({ ...route }));
-	const resolved = resolveRouteFromRoutes(new URL(url, "http://localhost").pathname, routeTable);
-	if (!resolved) throw new Error(`SSR: no route found for url: ${url}`);
-	const ctx = createRenderContext(seed, {
-		url,
-		data,
-		params: resolved.params,
-		routes: routeTable
-	});
-	withRenderContext(ctx, () => {
-		startRenderPhase(data || null);
-		try {
-			renderNodeSyncToSink(executeComponentSync(resolved.handler, resolved.params, ctx), sink, ctx);
-			sink.write(serializeHydrationRenderData(data));
-		} finally {
-			try {
-				stopRenderPhase();
-			} finally {
-				disposeSSRTemporaryOwners(ctx);
-			}
-		}
-	});
+	const { sink, ...renderOptions } = opts;
+	const resolved = resolveSSRRouteRender(renderOptions);
+	if (!resolved.document) {
+		renderResolvedRouteAppToSink(resolved, sink);
+		return;
+	}
+	const appSink = new StringSink();
+	renderResolvedRouteAppToSink(resolved, appSink);
+	appSink.end();
+	sink.write(renderDocument(resolved.document, buildDocumentRenderArgs(resolved, appSink.toString()), "renderToString()/renderToStream()"));
 }
 //#endregion
 export { SSRDataMissingError, renderResolvedToStringSync, renderToStream, renderToString, renderToStringSync, resolveRequest };