@askrjs/askr 0.0.83 → 0.0.85

package/dist/resources/index.d.ts

@@ -1,5 +1,5 @@
-import { ut as getSignal } from "../index-TlEvex-C.js";
-import { i as onRouteChange, n as RouteChangeOptions, t as RouteChangeCleanup } from "../activity-CXEaU-Al.js";
+import { ut as getSignal } from "../index-pIgGaXvS.js";
+import { i as onRouteChange, n as RouteChangeOptions, t as RouteChangeCleanup } from "../activity-B1I5HJQI.js";
 //#region src/runtime/resource-operation.d.ts
 interface ResourceResult<T> {
   value: T | null;

package/dist/resources/index.js

@@ -1,9 +1,9 @@
-import { t as enqueueRuntimeLane } from "../access-ePqdQqkV.js";
-import { a as registerCommitOperation } from "../component-internal-DsM75Gl1.js";
+import { t as enqueueRuntimeLane } from "../access-Dpfoi4cA.js";
 import { f as getCurrentComponentInstance, g as getSignal, i as claimHookIndex } from "../component-scope-DzJEbYGE.js";
-import { z as resource } from "../route-matching-BUwz4kfl.js";
-import { a as task, i as routeActive, n as documentVisible, o as timer, r as on, s as windowFocused, t as capture } from "../lifecycle-operations-BJfxWUJr.js";
-import { n as onRouteChange } from "../activity-CnSRFO3d.js";
+import { a as registerCommitOperation } from "../component-internal-DcrLymUJ.js";
+import { G as resource } from "../route-matching-DHduNiGk.js";
+import { a as task, i as routeActive, n as documentVisible, o as timer, r as on, s as windowFocused, t as capture } from "../lifecycle-operations-BrYrBsXY.js";
+import { n as onRouteChange } from "../activity-Jd9CgEa3.js";
 //#region src/runtime/stream-operation.ts
 function toError(value) {
 	return value instanceof Error ? value : new Error(String(value));

package/dist/{route-matching-BUwz4kfl.js → route-matching-DHduNiGk.js}

@@ -1,10 +1,10 @@
-import { t as enqueueRuntimeLane, v as logger } from "./access-ePqdQqkV.js";
-import { c as registerCommitOperationForInstance, d as getCurrentContextFrame, v as withAsyncResourceContext } from "./component-internal-DsM75Gl1.js";
+import { t as enqueueRuntimeLane, v as logger } from "./access-Dpfoi4cA.js";
 import { f as getCurrentComponentInstance } from "./component-scope-DzJEbYGE.js";
-import { p as isPromiseLike } from "./lifecycle-batch-CwHCDseR.js";
+import { c as registerCommitOperationForInstance, d as getCurrentContextFrame, v as withAsyncResourceContext } from "./component-internal-DcrLymUJ.js";
+import { p as isPromiseLike } from "./lifecycle-batch-Dfpid9-A.js";
 import { t as brandSnapshotSource } from "./snapshot-source-BB42xgwb.js";
 import { d as SSRDataMissingError, i as getNextRenderKey, n as getActiveRenderContext, r as getCurrentRenderData, u as throwSSRDataMissing } from "./render-context-D-DFk2WN.js";
-import { t as state } from "./state-BCl9DeiN.js";
+import { t as state } from "./state-DCjONcHK.js";
 //#region src/runtime/resource-cell.ts
 /**
 * Pure, component-agnostic ResourceCell state machine.
@@ -401,6 +401,7 @@ const registrationScopeStack = [];
 let registrationLocked = false;
 let defaultRouteAuthOptions;
 let activeClientRouteAuthOptions;
+let defaultRouteBasePath = "";
 function getDepth(path) {
 	const normalized = path.endsWith("/") && path !== "/" ? path.slice(0, -1) : path;
 	return normalized === "/" ? 0 : normalized.split("/").filter(Boolean).length;
@@ -448,6 +449,15 @@ function getDefaultRouteAuthOptions() {
 function setDefaultRouteAuthOptions(auth) {
 	defaultRouteAuthOptions = auth;
 }
+function getDefaultRouteBasePath() {
+	return defaultRouteBasePath;
+}
+function setDefaultRouteBasePath(basePath) {
+	defaultRouteBasePath = basePath;
+}
+function getActiveRouteBasePath() {
+	return getActiveRenderContext()?.basePath ?? defaultRouteBasePath;
+}
 function getCurrentLayoutChain() {
 	const layoutChain = [];
 	for (const scope of registrationScopeStack) if (scope.layout) layoutChain.push({ component: scope.layout });
@@ -514,6 +524,7 @@ function clearRouteState() {
 	registrationLocked = false;
 	defaultRouteAuthOptions = void 0;
 	activeClientRouteAuthOptions = void 0;
+	defaultRouteBasePath = "";
 }
 function snapshotRouteState() {
 	return {
@@ -523,6 +534,7 @@ function snapshotRouteState() {
 		registrationLocked,
 		defaultRouteAuthOptions,
 		activeClientRouteAuthOptions,
+		defaultRouteBasePath,
 		routesByDepth: [...routesByDepth.entries()].map(([depth, depthRoutes]) => [depth, [...depthRoutes]]),
 		registrationScopeStack: [...registrationScopeStack]
 	};
@@ -541,6 +553,7 @@ function restoreRouteState(snapshot) {
 	registrationLocked = snapshot.registrationLocked;
 	defaultRouteAuthOptions = snapshot.defaultRouteAuthOptions;
 	activeClientRouteAuthOptions = snapshot.activeClientRouteAuthOptions;
+	defaultRouteBasePath = snapshot.defaultRouteBasePath;
 }
 //#endregion
 //#region src/router/route-context.ts
@@ -617,6 +630,34 @@ function buildRouteContext(target, params, options) {
 	};
 }
 //#endregion
+//#region src/router/base-path.ts
+/** Normalize the public mount point used by one route registry. */
+function normalizeRouteBasePath(value) {
+	if (value === void 0 || value === "" || value === "/") return "";
+	if (!value.startsWith("/") || /\/{2,}/.test(value) || value.includes("?") || value.includes("#") || value.includes("\\")) throw new TypeError(`Route basePath must be an absolute pathname without a query or hash. Received: ${JSON.stringify(value)}`);
+	const normalized = value.endsWith("/") ? value.slice(0, -1) : value;
+	if (normalized.split("/").some((segment) => segment === "." || segment === "..")) throw new TypeError("Route basePath must not contain dot segments.");
+	return normalized;
+}
+function parsedTarget(target) {
+	return new URL(target, "http://askr.invalid");
+}
+/** Add a registry mount point to one logical root-relative route target. */
+function addRouteBasePath(target, basePath) {
+	if (!basePath || !target.startsWith("/") || target.startsWith("//")) return target;
+	const parsed = parsedTarget(target);
+	if (parsed.origin !== "http://askr.invalid" || parsed.pathname === basePath || parsed.pathname.startsWith(`${basePath}/`)) return target;
+	return `${basePath}${parsed.pathname}${parsed.search}${parsed.hash}`;
+}
+/** Remove a registry mount point and retain query/hash for logical matching. */
+function removeRouteBasePath(target, basePath) {
+	const parsed = parsedTarget(target);
+	if (!basePath) return `${parsed.pathname}${parsed.search}${parsed.hash}`;
+	if (parsed.pathname === basePath || parsed.pathname === `${basePath}/`) return `/${parsed.search}${parsed.hash}`;
+	if (!parsed.pathname.startsWith(`${basePath}/`)) return void 0;
+	return `${parsed.pathname.slice(basePath.length)}${parsed.search}${parsed.hash}`;
+}
+//#endregion
 //#region src/router/route-matching.ts
 const routeSegsCache = /* @__PURE__ */ new WeakMap();
 const routeRankCache = /* @__PURE__ */ new WeakMap();
@@ -752,7 +793,9 @@ function computeMatchesFromRouteRecords(pathname, routeRecords) {
 	}];
 }
 function computeRouteActivityMatches(pathname, options) {
-	return computeMatchesFromRouteRecords(pathname, options.registry.manifest.records);
+	const logicalPath = removeRouteBasePath(pathname, normalizeRouteBasePath(options.registry.manifest.basePath));
+	if (logicalPath === void 0) return [];
+	return computeMatchesFromRouteRecords(logicalPath, options.registry.manifest.records);
 }
 function resolveRoute(pathname) {
 	const normalized = pathname.endsWith("/") && pathname !== "/" ? pathname.slice(0, -1) : pathname;
@@ -784,4 +827,4 @@ function _resolveRouteMatchFromRoutes(pathname, routeList) {
 	return findBestResolvedRouteFromRoutes(pathname, routeList);
 }
 //#endregion
-export { insertRecordSorted as A, getCurrentPathPrefix as C, getRouteRecords as D, getRouteList as E, snapshotRouteState as F, computeRank as I, normalizeRouteSegmentName as L, pushRegistrationScope as M, restoreRouteState as N, hasActivePageScope as O, setDefaultRouteAuthOptions as P, parseSegments as R, getCurrentPageScope as S, getDefaultRouteAuthOptions as T, getCurrentInheritedAuthRequirements as _, resolveRouteFromRoutes as a, getCurrentLayoutChain as b, deepFreeze as c, _setActiveRouteAuthOptions as d, addRouteToStores as f, getActiveRoutes as g, getActiveRouteAuthOptions as h, getMatchingRouteRecord as i, lockRouteRegistration as j, hasRegisteredRoutes as k, makeQuery as l, clearRouteState as m, computeMatchesFromRoutes as n, buildRouteContext as o, assertRouteRegistrationUnlocked as p, computeRouteActivityMatches as r, buildRouteContextBase as s, _resolveRouteMatchFromRoutes as t, parseLocation as u, getCurrentInheritedMeta as v, getCurrentScopeKind as w, getCurrentPageChain as x, getCurrentInheritedPolicies as y, resource as z };
+export { getDefaultRouteBasePath as A, setDefaultRouteBasePath as B, getCurrentInheritedPolicies as C, getCurrentPathPrefix as D, getCurrentPageScope as E, insertRecordSorted as F, resource as G, computeRank as H, lockRouteRegistration as I, pushRegistrationScope as L, getRouteRecords as M, hasActivePageScope as N, getCurrentScopeKind as O, hasRegisteredRoutes as P, restoreRouteState as R, getCurrentInheritedMeta as S, getCurrentPageChain as T, normalizeRouteSegmentName as U, snapshotRouteState as V, parseSegments as W, clearRouteState as _, resolveRouteFromRoutes as a, getActiveRoutes as b, removeRouteBasePath as c, deepFreeze as d, makeQuery as f, assertRouteRegistrationUnlocked as g, addRouteToStores as h, getMatchingRouteRecord as i, getRouteList as j, getDefaultRouteAuthOptions as k, buildRouteContext as l, _setActiveRouteAuthOptions as m, computeMatchesFromRoutes as n, addRouteBasePath as o, parseLocation as p, computeRouteActivityMatches as r, normalizeRouteBasePath as s, _resolveRouteMatchFromRoutes as t, buildRouteContextBase as u, getActiveRouteAuthOptions as v, getCurrentLayoutChain as w, getCurrentInheritedAuthRequirements as x, getActiveRouteBasePath as y, setDefaultRouteAuthOptions as z };

package/dist/router/index.d.ts

@@ -1,9 +1,9 @@
-import { c as RenderableChild } from "../control-Cix3yjVf.js";
+import { u as RenderableChild } from "../control-DhUZU4_V.js";
 import { r as JSXElement, s as Props } from "../jsx-Dvr2SGRG.js";
-import { A as RouteHandler, B as RouteQuery, C as Route, D as RouteContext, E as RouteComponent, F as RouteMode, G as RouteRegistryOptions, H as RouteRef, I as RouteOptions, J as RouteRequestResult, K as RouteRenderResult, L as RouteParams, M as RouteMatch, N as RouteMeta, O as RouteDefinition, P as RouteMetaSource, R as RoutePathParams, S as ParsedSegment, T as RouteAuthResolver, U as RouteRefSearch, V as RouteRecord, W as RouteRegistry, X as RouteSearchValue, Y as RouteSearch, Z as RouteSnapshot, _ as AccessRedirectStatus, b as PageHelperOptions, f as AccessAllowDecision, g as AccessRedirectDecision, h as AccessDenyStatus, j as RouteManifest, k as RouteDestination, m as AccessDenyDecision, p as AccessDecision, q as RouteRequestOptions, v as GroupHelperOptions, w as RouteAuthOptions, x as PageScopeRecord, y as LayoutScopeRecord, z as RoutePolicy } from "../index-TlEvex-C.js";
+import { A as RouteHandler, B as RouteQuery, C as Route, D as RouteContext, E as RouteComponent, F as RouteMode, G as RouteRegistryOptions, H as RouteRef, I as RouteOptions, J as RouteRequestResult, K as RouteRenderResult, L as RouteParams, M as RouteMatch, N as RouteMeta, O as RouteDefinition, P as RouteMetaSource, R as RoutePathParams, S as ParsedSegment, T as RouteAuthResolver, U as RouteRefSearch, V as RouteRecord, W as RouteRegistry, X as RouteSearchValue, Y as RouteSearch, Z as RouteSnapshot, _ as AccessRedirectStatus, b as PageHelperOptions, f as AccessAllowDecision, g as AccessRedirectDecision, h as AccessDenyStatus, j as RouteManifest, k as RouteDestination, m as AccessDenyDecision, p as AccessDecision, q as RouteRequestOptions, v as GroupHelperOptions, w as RouteAuthOptions, x as PageScopeRecord, y as LayoutScopeRecord, z as RoutePolicy } from "../index-pIgGaXvS.js";
 import "../types-C9YcqVpk.js";
-import { a as ScrollRestorationOptions, i as NavigationScrollBehavior, n as NavigateOptions, r as HistoryScrollBehavior, t as navigate } from "../navigate-DfY1BUYc.js";
-import { i as onRouteChange, n as RouteChangeOptions, r as currentRoute, t as RouteChangeCleanup } from "../activity-CXEaU-Al.js";
+import { a as ScrollRestorationOptions, i as NavigationScrollBehavior, n as NavigateOptions, r as HistoryScrollBehavior, t as navigate } from "../navigate-NyIjQUwI.js";
+import { i as onRouteChange, n as RouteChangeOptions, r as currentRoute, t as RouteChangeCleanup } from "../activity-B1I5HJQI.js";
 import { AuthContext, AuthContext as AuthContext$1, AuthRequirement, AuthRequirement as AuthRequirement$1 } from "@askrjs/auth";
 import { ObjectSchema } from "@askrjs/schema";
 //#region src/router/route-query.d.ts
@@ -29,7 +29,7 @@ type RouteComponentParam<TComponent extends AnyRouteComponent> = Parameters<TCom
 type CompatibleAbsoluteRouteComponent<Path extends string, TComponent extends AnyRouteComponent> = Parameters<TComponent> extends [] ? TComponent : RoutePathParams<Path> extends RouteComponentParam<TComponent> ? TComponent : never;
 type CompatibleRelativeRouteComponent<Path extends string, TComponent extends AnyRouteComponent> = Parameters<TComponent> extends [] ? TComponent : RouteComponentParam<TComponent> extends Record<keyof RoutePathParams<Path>, string> ? TComponent : never;
 type CompatibleRouteComponent<Path extends string, TComponent extends AnyRouteComponent> = Path extends `/${string}` ? CompatibleAbsoluteRouteComponent<Path, TComponent> : CompatibleRelativeRouteComponent<Path, TComponent>;
-type RouteOptionsForComponent<Path extends string, TComponent extends AnyRouteComponent, TSearchSchema extends ObjectSchema<RouteSearch> | undefined = ObjectSchema<RouteSearch> | undefined> = Parameters<TComponent> extends [] ? RouteOptions<RoutePathParams<Path>, TSearchSchema> : RouteComponentParam<TComponent> extends RouteParams ? RouteOptions<RouteComponentParam<TComponent>, TSearchSchema> : RouteOptions<RoutePathParams<Path>, TSearchSchema>;
+type RouteOptionsForComponent<Path extends string, TComponent extends AnyRouteComponent, TSearchSchema extends ObjectSchema<RouteSearch> | undefined = ObjectSchema<RouteSearch> | undefined, TLoaderData = unknown, TDehydratedData = TLoaderData> = Parameters<TComponent> extends [] ? RouteOptions<RoutePathParams<Path>, TSearchSchema, TLoaderData, TDehydratedData> : RouteComponentParam<TComponent> extends RouteParams ? RouteOptions<RouteComponentParam<TComponent>, TSearchSchema, TLoaderData, TDehydratedData> : RouteOptions<RoutePathParams<Path>, TSearchSchema, TLoaderData, TDehydratedData>;
 declare function group(options: GroupHelperOptions, fn: RouteDefinition): void;
 declare function page<const TPath extends string>(path: TPath, Component: RouteComponent<RoutePathParams<TPath>>, fn: RouteDefinition): void;
 declare function page<const TPath extends string, TComponent extends AnyRouteComponent>(path: TPath, Component: CompatibleRouteComponent<TPath, TComponent>, fn: RouteDefinition): void;
@@ -37,8 +37,8 @@ declare function page<const TPath extends string>(path: TPath, Component: RouteC
 declare function page<const TPath extends string, TComponent extends AnyRouteComponent>(path: TPath, Component: CompatibleRouteComponent<TPath, TComponent>, options: PageHelperOptions, fn: RouteDefinition): void;
 declare function index(Component: RouteComponent, options?: RouteOptions): void;
 declare function fallback(Component: RouteComponent): void;
-declare function route<const TPath extends string, const TSearchSchema extends ObjectSchema<RouteSearch> | undefined = undefined>(path: TPath, Component: RouteComponent<RoutePathParams<TPath>>, options?: RouteOptions<RoutePathParams<TPath>, TSearchSchema>): RouteRef<RoutePathParams<TPath>, RouteRefSearch<TSearchSchema>>;
-declare function route<const TPath extends string, TComponent extends AnyRouteComponent, const TSearchSchema extends ObjectSchema<RouteSearch> | undefined = undefined>(path: TPath, Component: CompatibleRouteComponent<TPath, TComponent>, options?: RouteOptionsForComponent<TPath, TComponent, TSearchSchema>): RouteRef<RoutePathParams<TPath>, RouteRefSearch<TSearchSchema>>;
+declare function route<const TPath extends string, const TSearchSchema extends ObjectSchema<RouteSearch> | undefined = undefined, TLoaderData = unknown, TDehydratedData = TLoaderData>(path: TPath, Component: RouteComponent<RoutePathParams<TPath>>, options?: RouteOptions<RoutePathParams<TPath>, TSearchSchema, TLoaderData, TDehydratedData>): RouteRef<RoutePathParams<TPath>, RouteRefSearch<TSearchSchema>>;
+declare function route<const TPath extends string, TComponent extends AnyRouteComponent, const TSearchSchema extends ObjectSchema<RouteSearch> | undefined = undefined, TLoaderData = unknown, TDehydratedData = TLoaderData>(path: TPath, Component: CompatibleRouteComponent<TPath, TComponent>, options?: RouteOptionsForComponent<TPath, TComponent, TSearchSchema, TLoaderData, TDehydratedData>): RouteRef<RoutePathParams<TPath>, RouteRefSearch<TSearchSchema>>;
 //#endregion
 //#region src/router/auth.d.ts
 /** Return the identity resolved for the route currently being rendered. */

package/dist/router/index.js

@@ -1,9 +1,10 @@
-import { a as resolveDeferredValues, b as Outlet, i as isDeferred, l as createRouteRegistry, m as resolveRouteRequest, n as Resolve, r as defer, s as routeData, w as lazy, y as currentAuth } from "../deferred-rdHAgyKe.js";
-import { a as isSafeHref } from "../csp-nonce-DDt0UNdt.js";
+import { C as currentAuth, O as lazy, a as resolveDeferredValues, i as isDeferred, l as createRouteRegistry, m as resolveRouteRequest, n as Resolve, r as defer, s as routeData, w as Outlet } from "../deferred-vUOy-awa.js";
+import { o as addRouteBasePath, y as getActiveRouteBasePath } from "../route-matching-DHduNiGk.js";
+import { a as isSafeHref } from "../csp-nonce-Bc52OIVc.js";
 import { jsx } from "../jsx-runtime.js";
-import { a as route, i as page, n as group, r as index, t as fallback } from "../authoring-DbGEgg40.js";
-import { n as onRouteChange, t as currentRoute } from "../activity-CnSRFO3d.js";
-import { a as serializeRouteMeta, c as getCurrentHref, d as parseTargetUrl, h as syncRegisteredRouteSnapshot, i as resolveRouteMeta, l as getRegisteredAppsSnapshot, m as syncAppRegistrationLocation, n as navigate, p as setCurrentRouteLocation, r as reconcileRouteMeta, s as saveScrollPosition, u as getWindowHref } from "../navigate-Crvd5gUG.js";
+import { a as route, i as page, n as group, r as index, t as fallback } from "../authoring-DdQ3pHqt.js";
+import { n as onRouteChange, t as currentRoute } from "../activity-Jd9CgEa3.js";
+import { a as serializeRouteMeta, c as getCurrentHref, d as parseTargetUrl, h as syncRegisteredRouteSnapshot, i as resolveRouteMeta, l as getRegisteredAppsSnapshot, m as syncAppRegistrationLocation, n as navigate, p as setCurrentRouteLocation, r as reconcileRouteMeta, s as saveScrollPosition, u as getWindowHref } from "../navigate-b4GGxO_l.js";
 import { o as mergeProps } from "../compose-ref-Cc_YkUpM.js";
 import { t as applyInteractionPolicy } from "../interactions-DgGQyUQv.js";
 //#region src/router/route-query.ts
@@ -116,7 +117,7 @@ function formatSearchIssues(issues) {
 	return issues.map((issue) => `${issue.path.length ? issue.path.join(".") : "search"}: ${issue.message}`).join("; ");
 }
 function to(route, params, search) {
-	const path = buildPath(route, params);
+	const path = addRouteBasePath(buildPath(route, params), route.basePath ?? "");
 	const parsedSearch = route.searchSchema?.safeParse(search ?? {});
 	if (parsedSearch && !parsedSearch.success) throw new Error(`Invalid route search. ${formatSearchIssues(parsedSearch.issues)}`);
 	const values = parsedSearch?.success ? parsedSearch.data : search;
@@ -167,7 +168,8 @@ function isSameOriginNavigableHref(href) {
 * - Composable via mergeProps
 */
 function Link({ href: suppliedHref, to, class: className, children, rel, target, "aria-current": ariaCurrent, "aria-label": ariaLabel, onPress, onClick, ...rest }) {
-	const href = to?.href ?? suppliedHref;
+	const supplied = to?.href ?? suppliedHref;
+	const href = supplied ? addRouteBasePath(supplied, getActiveRouteBasePath()) : supplied;
 	if (!href) throw new Error("Link requires href or to.");
 	if (!isSafeHref(href)) throw new TypeError("Link href uses an unsafe URL scheme.");
 	const handleNavigation = (e) => {

package/dist/{selector-DVwvof1M.js → selector-Ck_Pp9av.js}

@@ -1,6 +1,6 @@
-import { t as enqueueRuntimeLane } from "./access-ePqdQqkV.js";
-import { c as markReadableUsage, f as syncDerivedDependencySubscriptions, l as notifyReadableReaders, o as markReactivePropsDirtySource, p as withDerivedReadTracking, r as clearDerivedDependencySubscriptions, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B3VIOfd7.js";
+import { t as enqueueRuntimeLane } from "./access-Dpfoi4cA.js";
 import { i as claimHookIndex, p as getCurrentInstance } from "./component-scope-DzJEbYGE.js";
+import { c as markReadableUsage, f as syncDerivedDependencySubscriptions, l as notifyReadableReaders, o as markReactivePropsDirtySource, p as withDerivedReadTracking, r as clearDerivedDependencySubscriptions, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B5NtV7V0.js";
 //#region src/runtime/selector-store.ts
 const dirtySelectorRecords = /* @__PURE__ */ new Set();
 let hasPendingSelectorFlush = false;

package/dist/ssg/index.d.ts

@@ -1,5 +1,5 @@
-import { d as DocumentRenderContext, f as DocumentRenderer, u as DocumentRenderArgs } from "../control-Cix3yjVf.js";
-import { A as RouteHandler, I as RouteOptions, R as RoutePathParams, W as RouteRegistry, z as RoutePolicy } from "../index-TlEvex-C.js";
+import { _ as SSRStyleRegistrationValidation, f as DocumentRenderArgs, m as DocumentRenderer, p as DocumentRenderContext } from "../control-DhUZU4_V.js";
+import { A as RouteHandler, I as RouteOptions, R as RoutePathParams, W as RouteRegistry, z as RoutePolicy } from "../index-pIgGaXvS.js";
 import { AuthRequirement } from "@askrjs/auth";
 import "node:fs/promises";
 //#region src/ssg/types.d.ts
@@ -31,6 +31,10 @@ interface RouteConfig<Path extends string = string> {
   invalidationKeys?: string[];
   /** Route loader resolved completely before static HTML is rendered. */
   loader?: RouteOptions['loader'];
+  /** Select the loader data transported for initial hydration. */
+  dehydrate?: RouteOptions['dehydrate'];
+  /** @internal Public mount point inherited from the owning registry. */
+  basePath?: string;
   /**
    * SSG entry generator for parameterized routes.
    *
@@ -54,6 +58,8 @@ interface SSGBaseOptions {
   dataOverrides?: Record<string, unknown>;
   /** Optional document wrapper for full HTML output */
   document?: DocumentRenderer;
+  /** Diagnose document renderers that omit request-local SSR style registrations. */
+  styleRegistrationValidation?: SSRStyleRegistrationValidation;
   /** Static files or directories published with the generated routes. */
   assets?: readonly SSGAssetSource[];
   /** Optional concurrency limit for rendering (default: 1) */
@@ -68,7 +74,7 @@ interface SSGAssetSource {
   to?: string;
 }
 /** Options for createStaticGen */
-type SSGOptions<TRoutes extends readonly RouteConfig[] = RouteConfig[]> = SSGBaseOptions & {
+type SSGOptions<_TRoutes extends readonly RouteConfig[] = RouteConfig[]> = SSGBaseOptions & {
   /** Explicit route registry captured with `createRouteRegistry()`. */
   registry: RouteRegistry;
 };
@@ -242,4 +248,4 @@ declare function createStaticGen(options: SSGOptions): {
   getResult(): SSGResult | null;
 };
 //#endregion
-export { type DiscoveredResources, type DocumentRenderArgs, type DocumentRenderContext, type DocumentRenderer, type RouteConfig, type RouteRenderReason, type RouteRenderResult, type RouteRenderStatus, type SSGAssetSource, 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 SSGAssetSource, type SSGGenerateOptions, type SSGMetadata, type SSGMode, type SSGOptions, type SSGResult, type SSRStyleRegistrationValidation, createStaticGen };

package/dist/ssg/index.js

@@ -1,8 +1,9 @@
-import "../access-ePqdQqkV.js";
-import { C as _preloadRouteHandler, S as getRenderHandler, a as resolveDeferredValues, l as createRouteRegistry, u as bindResolvedRouteData } from "../deferred-rdHAgyKe.js";
-import { a as route } from "../authoring-DbGEgg40.js";
-import { n as renderDocument } from "../ssr-CbQO5xd3.js";
-import { n as renderToString } from "../ssr-C_Ql5_Kg.js";
+import "../access-Dpfoi4cA.js";
+import { D as _preloadRouteHandler, E as getRenderHandler, a as resolveDeferredValues, g as prepareRouteHydrationData, l as createRouteRegistry, u as bindResolvedRouteData } from "../deferred-vUOy-awa.js";
+import { o as addRouteBasePath } from "../route-matching-DHduNiGk.js";
+import { a as route } from "../authoring-DdQ3pHqt.js";
+import { n as renderDocument } from "../ssr-DSHd_Q9K.js";
+import { n as renderToString } from "../ssr-CpiBHMNv.js";
 import * as fs from "node:fs/promises";
 import * as pathModule from "node:path";
 import * as os from "node:os";
@@ -141,17 +142,21 @@ function validateRoutes(routes) {
 * Render multiple routes in parallel with error handling
 */
 async function batchRenderRoutes(routes, options = {}) {
-	const { seed = 12345, dataMap = {}, concurrency = 1, document } = options;
+	const { seed = 12345, dataMap = {}, concurrency = 1, document, styleRegistrationValidation = "warn" } = options;
 	const workerCount = Math.max(1, Math.min(concurrency, routes.length || 1));
 	const results = [];
 	results.length = routes.length;
 	let nextIndex = 0;
-	const sharedRegistry = new Set(routes.map((route) => route.path)).size === routes.length ? createRouteRegistry(() => {
+	const hasUniquePaths = new Set(routes.map((route) => route.path)).size === routes.length;
+	const basePaths = new Set(routes.map((route) => route.basePath ?? ""));
+	const sharedBasePath = basePaths.size === 1 ? routes[0]?.basePath : void 0;
+	const sharedRegistry = hasUniquePaths && basePaths.size <= 1 ? createRouteRegistry(() => {
 		for (const route$1 of routes) route(route$1.path, route$1.handler, { namespace: route$1.namespace });
-	}) : void 0;
+	}, { basePath: sharedBasePath }) : void 0;
 	const renderOne = async (route$2) => {
 		const startTime = performance.now();
 		const url = interpolateRoutePath(route$2.path, route$2.params);
+		const publicUrl = addRouteBasePath(url, route$2.basePath ?? "");
 		const requestUrl = new URL(url, "http://localhost");
 		const resolvedData = resolveSsgRouteData(dataMap, route$2.path, url);
 		const baseData = resolvedData.hasData ? resolvedData.data : void 0;
@@ -161,6 +166,7 @@ async function batchRenderRoutes(routes, options = {}) {
 		try {
 			await _preloadRouteHandler(mergedHandler);
 			let routeData;
+			let routeHydration;
 			let hasRouteData = false;
 			if (route$2.loader) {
 				const controller = new AbortController();
@@ -179,24 +185,30 @@ async function batchRenderRoutes(routes, options = {}) {
 					},
 					signal: controller.signal
 				};
+				const request = new Request(requestUrl);
 				const loaded = await route$2.loader({
 					...loadContext,
-					request: new Request(requestUrl)
+					request
 				});
 				await resolveDeferredValues(loaded, controller.signal);
 				routeData = loaded;
+				routeHydration = prepareRouteHydrationData(loaded, route$2.dehydrate, {
+					...loadContext,
+					request
+				}, url);
 				hasRouteData = true;
 			}
-			const renderedHandler = hasRouteData ? bindResolvedRouteData(mergedHandler, routeData) : mergedHandler;
+			const renderedHandler = hasRouteData ? bindResolvedRouteData(mergedHandler, routeData, routeHydration) : mergedHandler;
 			const registry = hasRouteData || !sharedRegistry ? createRouteRegistry(() => {
 				route(route$2.path, renderedHandler, { namespace: route$2.namespace });
-			}) : sharedRegistry;
+			}, { basePath: route$2.basePath }) : sharedRegistry;
 			phase = "render";
 			const html = renderToString({
-				url,
+				url: publicUrl,
 				registry,
 				seed,
 				data: baseData,
+				styleRegistrationValidation: "off",
 				document: document === void 0 ? void 0 : ({ appHtml, context }) => renderDocument(document, {
 					appHtml,
 					context: {
@@ -215,7 +227,7 @@ async function batchRenderRoutes(routes, options = {}) {
 						cspNonce: context.cspNonce,
 						styles: context.styles
 					}
-				}, "createStaticGen()")
+				}, "createStaticGen()", styleRegistrationValidation)
 			});
 			const duration = performance.now() - startTime;
 			return {
@@ -632,7 +644,9 @@ function routeRegistryToRouteConfigs(registry) {
 			auth: options.auth,
 			policies: options.policies,
 			entries: options.entries,
-			loader: options.loader
+			loader: options.loader,
+			dehydrate: options.dehydrate,
+			basePath: registry.manifest.basePath
 		});
 	}
 	return routeConfigs;
@@ -766,7 +780,8 @@ function createStaticGen(options) {
 				seed,
 				dataMap,
 				concurrency: resolvedConcurrency,
-				document: options.document
+				document: options.document,
+				styleRegistrationValidation: options.styleRegistrationValidation
 			}) : [];
 			performance.now() - renderStartTime;
 			const renderedByRouteId = /* @__PURE__ */ new Map();

package/dist/ssr/index.d.ts

@@ -1,6 +1,6 @@
-import { d as DocumentRenderContext, f as DocumentRenderer, m as SSRStyleRegistration, p as SSRData, u as DocumentRenderArgs } from "../control-Cix3yjVf.js";
+import { _ as SSRStyleRegistrationValidation, f as DocumentRenderArgs, g as SSRStyleRegistration, h as SSRData, m as DocumentRenderer, p as DocumentRenderContext } from "../control-DhUZU4_V.js";
 import { r as JSXElement, s as Props } from "../jsx-Dvr2SGRG.js";
-import { A as RouteHandler, C as Route, J as RouteRequestResult, V as RouteRecord, W as RouteRegistry, g as AccessRedirectDecision, l as DeferredBoundaryRegistration, m as AccessDenyDecision, u as SSRPortalState, w as RouteAuthOptions } from "../index-TlEvex-C.js";
+import { A as RouteHandler, C as Route, J as RouteRequestResult, V as RouteRecord, W as RouteRegistry, g as AccessRedirectDecision, l as DeferredBoundaryRegistration, m as AccessDenyDecision, u as SSRPortalState, w as RouteAuthOptions } from "../index-pIgGaXvS.js";
 import { D as QueryPrefetchContext, _ as CoreTelemetry, n as ServerQueryRegistry, v as DataRuntime } from "../index-5S-fi2xy.js";
 import { AuthContext } from "@askrjs/auth";
 //#region src/common/page-render-envelope.d.ts
@@ -29,6 +29,7 @@ interface RenderContext {
   params?: Record<string, string>;
   routes?: readonly Route[];
   routeAuth?: RouteAuthOptions;
+  basePath?: string;
   authContext?: AuthContext;
   signal?: AbortSignal;
   dataRuntime?: unknown;
@@ -51,6 +52,7 @@ declare function createRenderContext(seed?: number, opts?: {
   params?: Record<string, string>;
   routes?: readonly Route[];
   routeAuth?: RouteAuthOptions;
+  basePath?: string;
   signal?: AbortSignal;
   dataRuntime?: unknown;
   mode?: 'ssr' | 'spa';
@@ -92,6 +94,8 @@ type RouteRenderOptions = SSRRouteSource & {
   /** @internal Precomposed page state used by hydration verification. */
   envelope?: PageRenderEnvelope;
   cspNonce?: string;
+  /** Diagnose document renderers that omit request-local SSR style registrations. */
+  styleRegistrationValidation?: SSRStyleRegistrationValidation;
 };
 type RouteStreamOptions = RouteRenderOptions & {
   onChunk(html: string): void;
@@ -185,4 +189,4 @@ declare function renderToString(component: (props?: Record<string, unknown>) =>
 declare function renderToString(opts: RouteRenderOptions): string;
 declare function renderToStream(opts: RouteStreamOptions): void;
 //#endregion
-export { type DocumentRenderArgs, type DocumentRenderContext, type DocumentRenderer, type RenderRouteRequestOptions, type RenderRouteRequestResult, type SSRComponent, SSRDataMissingError, type SSRRoute, type SSRStyleRegistration, type VNode, createRenderContext, getRenderContext, renderResolvedToStringSync, renderRouteRequest, renderRouteRequestToString, renderToStream, renderToString, renderToStringSync, resolveRequest, withRenderContext, withRenderContextAsync };
+export { type DocumentRenderArgs, type DocumentRenderContext, type DocumentRenderer, type RenderRouteRequestOptions, type RenderRouteRequestResult, type SSRComponent, SSRDataMissingError, type SSRRoute, type SSRStyleRegistration, type SSRStyleRegistrationValidation, type VNode, createRenderContext, getRenderContext, renderResolvedToStringSync, renderRouteRequest, renderRouteRequestToString, renderToStream, renderToString, renderToStringSync, resolveRequest, withRenderContext, withRenderContextAsync };

package/dist/ssr/index.js

@@ -1,3 +1,3 @@
 import { d as SSRDataMissingError } from "../render-context-D-DFk2WN.js";
-import { a as renderResolvedToStringSync, c as createRenderContext, d as withRenderContextAsync, i as renderRouteRequestToString, l as getRenderContext, n as renderToString, o as renderToStringSync, r as renderRouteRequest, s as resolveRequest, t as renderToStream, u as withRenderContext } from "../ssr-C_Ql5_Kg.js";
+import { a as renderResolvedToStringSync, c as createRenderContext, d as withRenderContextAsync, i as renderRouteRequestToString, l as getRenderContext, n as renderToString, o as renderToStringSync, r as renderRouteRequest, s as resolveRequest, t as renderToStream, u as withRenderContext } from "../ssr-CpiBHMNv.js";
 export { SSRDataMissingError, createRenderContext, getRenderContext, renderResolvedToStringSync, renderRouteRequest, renderRouteRequestToString, renderToStream, renderToString, renderToStringSync, resolveRequest, withRenderContext, withRenderContextAsync };

package/dist/{ssr-C_Ql5_Kg.js → ssr-CpiBHMNv.js}

@@ -1,23 +1,23 @@
 import { t as __CONTROL_BOUNDARY__ } from "./control-C-ApnFs1.js";
 import { t as __ERROR_BOUNDARY__ } from "./vnode-D24p6IW2.js";
-import { v as logger } from "./access-ePqdQqkV.js";
-import { i as isFragmentType, n as Fragment, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
-import { f as getExecutionContextFrame, h as markVNodeTreeWithContextFrame, l as callWithContext, n as createComponentInstance, p as getVNodeContextFrame } from "./component-internal-DsM75Gl1.js";
+import { v as logger } from "./access-Dpfoi4cA.js";
 import { f as getCurrentComponentInstance, w as setCurrentComponentInstance } from "./component-scope-DzJEbYGE.js";
-import { t as cleanupComponent } from "./component-cleanup-oWN45rfa.js";
-import { p as isPromiseLike } from "./lifecycle-batch-CwHCDseR.js";
-import { _ as setControlBoundaryContextFrame, g as evaluateShowState, h as evaluateCaseState, i as evaluateForState, o as rollbackForStateTransaction, r as commitForStateTransaction } from "./for-internal-DRbV0h1d.js";
-import { _ as isPageRenderEnvelope, g as isEmptyPageRenderEnvelope, h as createPageRenderEnvelope, i as isDeferred, l as createRouteRegistry, m as resolveRouteRequest, t as DEFERRED_BOUNDARY } from "./deferred-rdHAgyKe.js";
+import { i as isFragmentType, n as Fragment, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
+import { f as getExecutionContextFrame, h as markVNodeTreeWithContextFrame, l as callWithContext, n as createComponentInstance, p as getVNodeContextFrame } from "./component-internal-DcrLymUJ.js";
+import { t as cleanupComponent } from "./component-cleanup-BUfUleGZ.js";
+import { p as isPromiseLike } from "./lifecycle-batch-Dfpid9-A.js";
+import { _ as setControlBoundaryContextFrame, g as evaluateShowState, h as evaluateCaseState, i as evaluateForState, o as rollbackForStateTransaction, r as commitForStateTransaction } from "./for-internal-B_mnQhan.js";
+import { _ as validateRouteHydrationData, b as isEmptyPageRenderEnvelope, h as getRouteHydrationMetadata, i as isDeferred, l as createRouteRegistry, m as resolveRouteRequest, t as DEFERRED_BOUNDARY, x as isPageRenderEnvelope, y as createPageRenderEnvelope } from "./deferred-vUOy-awa.js";
 import { d as SSRDataMissingError, l as stopRenderPhase$1, s as startRenderPhase$1, t as configureRenderContextProvider } from "./render-context-D-DFk2WN.js";
-import { a as resolveRouteFromRoutes, t as _resolveRouteMatchFromRoutes } from "./route-matching-BUwz4kfl.js";
+import { a as resolveRouteFromRoutes, c as removeRouteBasePath, s as normalizeRouteBasePath, t as _resolveRouteMatchFromRoutes } from "./route-matching-DHduNiGk.js";
 import { n as SSR_PORTAL_HOST, t as SSR_PORTAL_ANCHOR } from "./portal-w3oQ6oQU.js";
-import { a as disposeDefaultPortalScope, t as DefaultPortal } from "./portal-BZ_rN17v.js";
+import { a as disposeDefaultPortalScope, t as DefaultPortal } from "./portal-BVWjAhNQ.js";
 import { n as getPublicAttributeName, t as sanitizeCssValue } from "./css-BuPaTOfe.js";
-import { a as isSafeHref, r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-DDt0UNdt.js";
+import { o as isUnsafeUrlAttribute, r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-Bc52OIVc.js";
 import { t as createDataRuntime } from "./data-runtime-D68YOo9L.js";
 import { c as withTelemetry, i as dehydrateDataRuntime, t as createQueryPrefetchContext } from "./query-registry-BL6rjGsO.js";
-import { a as route } from "./authoring-DbGEgg40.js";
-import { n as renderDocument, t as SSR_RENDER_DATA_ATTR } from "./ssr-CbQO5xd3.js";
+import { a as route } from "./authoring-DdQ3pHqt.js";
+import { n as renderDocument, t as SSR_RENDER_DATA_ATTR } from "./ssr-DSHd_Q9K.js";
 //#region src/ssr/escape.ts
 /**
 * HTML escaping utilities for SSR
@@ -197,6 +197,7 @@ function createRenderContext(seed = 12345, opts = {}) {
 		params: opts.params,
 		routes: opts.routes,
 		routeAuth: opts.routeAuth,
+		basePath: opts.basePath,
 		signal: opts.signal,
 		dataRuntime: opts.dataRuntime ?? createDataRuntime({ queryCache }),
 		mode: opts.mode ?? "ssr",
@@ -307,7 +308,9 @@ function resolvePolicyAwareSSRRoute(opts, routeTable) {
 	let href = opts.url;
 	const visited = /* @__PURE__ */ new Set();
 	for (let redirects = 0; redirects <= MAX_SSR_REDIRECTS; redirects += 1) {
-		const matched = _resolveRouteMatchFromRoutes(new URL(href, "http://localhost").pathname, routeTable);
+		const logicalHref = removeRouteBasePath(href, normalizeRouteBasePath(manifest.basePath));
+		if (logicalHref === void 0) throw new Error(`SSR: no route found for url: ${href}`);
+		const matched = _resolveRouteMatchFromRoutes(new URL(logicalHref, "http://localhost").pathname, routeTable);
 		if (!matched) throw new Error(`SSR: no route found for url: ${href}`);
 		const resolved = getRouteRequestResultSync(resolveRouteRequest(href, {
 			registry: opts.registry,
@@ -446,13 +449,14 @@ function resolveSSRRouteSource(source) {
 	}));
 }
 function resolveSSRRouteRender(opts) {
-	const { seed = 12345, data, document } = opts;
+	const { seed = 12345, data, document, styleRegistrationValidation = "warn" } = opts;
 	const cspNonce = validateCspNonce(opts.cspNonce);
 	const routeTable = resolveSSRRouteSource(opts);
 	const resolvedRoute = resolvePolicyAwareSSRRoute(opts, routeTable);
 	const requestUrl = new URL(resolvedRoute.url, "http://localhost");
 	const ctx = createRenderContext(seed, {
 		url: resolvedRoute.url,
+		basePath: opts.registry.manifest.basePath,
 		data,
 		params: resolvedRoute.params,
 		routes: routeTable,
@@ -470,7 +474,8 @@ function resolveSSRRouteRender(opts) {
 		data,
 		ctx,
 		document,
-		cspNonce
+		cspNonce,
+		styleRegistrationValidation
 	};
 }
 function buildDocumentRenderArgs(resolved, appHtml) {
@@ -514,7 +519,7 @@ function renderToSinkInternal(opts, host) {
 		const appSink = new StringSink();
 		renderResolvedRouteAppToSink(resolved, appSink, host);
 		appSink.end();
-		sink.write(renderDocument(resolved.document, buildDocumentRenderArgs(resolved, appSink.toString()), "renderToString()/renderToStream()"));
+		sink.write(renderDocument(resolved.document, buildDocumentRenderArgs(resolved, appSink.toString()), "renderToString()/renderToStream()", resolved.styleRegistrationValidation));
 	});
 }
 function renderRouteToString(opts, host) {
@@ -781,7 +786,7 @@ function renderAttrsDirect(props, sink) {
 		}
 		if (value === false || value === null || value === void 0) continue;
 		const strValue = String(value);
-		if (attrName.toLowerCase() === "href" && !isSafeHref(strValue)) continue;
+		if (isUnsafeUrlAttribute(attrName, strValue)) continue;
 		sink.write(" ");
 		sink.write(attrName);
 		sink.write("=\"");
@@ -816,7 +821,7 @@ function renderAttrs(props, opts) {
 		else if (value === false || value === null || value === void 0) continue;
 		else {
 			const strValue = String(value);
-			if (attrName.toLowerCase() === "href" && !isSafeHref(strValue)) continue;
+			if (isUnsafeUrlAttribute(attrName, strValue)) continue;
 			attrParts.push(` ${attrName}="${getEscapedAttrValue(strValue)}"`);
 		}
 	}
@@ -853,6 +858,8 @@ function serializeHydrationRenderData(data, runtime) {
 		route: current.route,
 		framework: current.framework
 	});
+	const routeHydration = getRouteHydrationMetadata(payload.framework);
+	if (routeHydration) validateRouteHydrationData(payload.route, routeHydration.r);
 	if (isEmptyPageRenderEnvelope(payload)) return "";
 	return `<script type="application/json" ${SSR_RENDER_DATA_ATTR}="true">${JSON.stringify(payload, hydrationReplacer).replace(/</g, "\\u003C").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029")}<\/script>`;
 }
@@ -880,20 +887,23 @@ function renderDeferredBoundarySync(node, ctx) {
 	return `<askr-resolve data-askr-deferred="${id}">${renderRenderableSync(pending, ctx)}</askr-resolve>`;
 }
 function isMultiRangeChild(child) {
-	if (Array.isArray(child)) return child.length !== 1;
+	if (Array.isArray(child)) return true;
 	if (!child || typeof child !== "object" || !("type" in child)) return false;
-	const vnode = child;
-	if (!isFragmentType(vnode.type)) return false;
-	return (getRenderableChildren(vnode)?.length ?? 0) !== 1;
+	return isFragmentType(child.type);
+}
+function renderForRangeChildSync(child, ctx) {
+	if (child && typeof child === "object" && "type" in child && typeof child.type === "function") {
+		const vnode = child;
+		return renderForRangeChildSync(inheritRenderableKey(vnode, executeComponentSync(vnode.type, vnode.props, ctx, getVNodeContextFrame(vnode) ?? null)), ctx);
+	}
+	const rendered = renderChildSync(child, ctx);
+	return isMultiRangeChild(child) ? `${RANGE_START}${rendered}${RANGE_END}` : rendered;
 }
 function renderControlChildrenSync(node, ctx) {
 	const controlState = getControlBoundaryState(node);
 	return withControlBoundaryChildren(node, (children) => {
 		const values = children ?? [];
-		if (controlState?.kind === "for") return values.map((child) => {
-			const rendered = renderChildSync(child, ctx);
-			return isMultiRangeChild(child) ? `${RANGE_START}${rendered}${RANGE_END}` : rendered;
-		}).join("");
+		if (controlState?.kind === "for") return values.map((child) => renderForRangeChildSync(child, ctx)).join("");
 		const rendered = renderChildrenSync(values, ctx);
 		return values.length === 1 && isMultiRangeChild(values[0]) ? `${RANGE_START}${rendered}${RANGE_END}` : values.length !== 1 ? `${RANGE_START}${rendered}${RANGE_END}` : rendered;
 	});
@@ -1398,6 +1408,9 @@ async function renderRouteRequestInternal(options) {
 	});
 	const context = createRenderContext(options.seed, {
 		url: options.url,
+		basePath: manifest.basePath,
+		routes: options.registry.routes,
+		routeAuth: options.auth ?? manifest.auth,
 		data: options.data,
 		framework: options.framework,
 		signal,
@@ -1418,6 +1431,7 @@ async function renderRouteRequestInternal(options) {
 		});
 		if (!resolved) return { kind: "no-match" };
 		if (resolved.kind !== "render") return resolved;
+		context.params = resolved.params;
 		const sink = new StringSink();
 		renderSSRRouteAppToSink({
 			route: {

package/dist/ssr-DSHd_Q9K.js

@@ -0,0 +1,25 @@
+//#region src/common/ssr.ts
+function escapedStyleRawText(value) {
+	return value.replace(/<\//gi, "<\\/");
+}
+function validateDocumentStyleRegistrations(html, styles, apiName, validation) {
+	if (validation === "off" || !styles || styles.length === 0) return;
+	const dropped = styles.filter(({ cssText }) => !html.includes(cssText) && !html.includes(escapedStyleRawText(cssText)));
+	if (dropped.length === 0) return;
+	const registrations = dropped.map(({ id }) => JSON.stringify(id)).join(", ");
+	const message = `${apiName} document() dropped ${dropped.length} registered SSR style${dropped.length === 1 ? "" : "s"}: ${registrations}. Serialize context.styles into the returned document, or set styleRegistrationValidation to "off" when omission is intentional.`;
+	if (validation === "error") throw new Error(message);
+	console.warn(message);
+}
+function renderDocument(document, args, apiName, styleRegistrationValidation = "warn") {
+	const html = document(args);
+	if (typeof html !== "string") {
+		const received = typeof html === "object" && html !== null && "then" in html && typeof html.then === "function" ? "a Promise-like value" : html === null ? "null" : Array.isArray(html) ? "an array" : typeof html;
+		throw new Error(`${apiName} document() must synchronously return a string; received ${received}.`);
+	}
+	validateDocumentStyleRegistrations(html, args.context.styles, apiName, styleRegistrationValidation);
+	return html;
+}
+const SSR_RENDER_DATA_ATTR = "data-askr-render-data";
+//#endregion
+export { renderDocument as n, SSR_RENDER_DATA_ATTR as t };