@askrjs/askr 0.0.84 → 0.0.86

package/dist/ssr/index.d.ts

@@ -1,6 +1,6 @@
-import { f as DocumentRenderArgs, g as SSRStyleRegistration, h as SSRData, m as DocumentRenderer, p as DocumentRenderContext } from "../control-Y8F73Uln.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-_UN08Pg1.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-CtC4lChT.js";
+import { x as SSRDataMissingError } from "../render-context-D0Hoj9dW.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-B98593qJ.js";
 export { SSRDataMissingError, createRenderContext, getRenderContext, renderResolvedToStringSync, renderRouteRequest, renderRouteRequestToString, renderToStream, renderToString, renderToStringSync, resolveRequest, withRenderContext, withRenderContextAsync };

package/dist/{ssr-CtC4lChT.js → ssr-B98593qJ.js}

@@ -1,23 +1,22 @@
 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-Bw4Mf9fd.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-Bug5tSiG.js";
-import { p as isPromiseLike } from "./lifecycle-batch-CFI4NKpJ.js";
-import { _ as setControlBoundaryContextFrame, g as evaluateShowState, h as evaluateCaseState, i as evaluateForState, o as rollbackForStateTransaction, r as commitForStateTransaction } from "./for-internal-DjpV8ioj.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-oqtAJ4iH.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-IfQZmqkN.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-pHBoqwYd.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 isPageRenderEnvelope, f as stopRenderPhase$1, g as isEmptyPageRenderEnvelope, h as createPageRenderEnvelope, t as configureRenderContextProvider, u as startRenderPhase$1, x as SSRDataMissingError } from "./render-context-D0Hoj9dW.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-ZTlD_EnK.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-DQPG0VAm.js";
-import { n as renderDocument, t as SSR_RENDER_DATA_ATTR } from "./ssr-CbQO5xd3.js";
+import { o as isUnsafeUrlAttribute, r as validateCspNonce, t as CspNonceScope } from "./csp-nonce-Bc52OIVc.js";
+import { n as SSR_PORTAL_HOST, t as SSR_PORTAL_ANCHOR } from "./portal-w3oQ6oQU.js";
+import { t as createDataRuntime } from "./data-runtime-Ck3tJDDQ.js";
+import { c as withTelemetry, i as dehydrateDataRuntime, t as createQueryPrefetchContext } from "./query-registry-CPW_6nwF.js";
+import { a as resolveRouteFromRoutes, c as removeRouteBasePath, s as normalizeRouteBasePath, t as _resolveRouteMatchFromRoutes } from "./route-matching-DqULzZtC.js";
+import { a as resolveRouteRequest, d as DEFERRED_BOUNDARY, l as validateRouteHydrationData, o as getRouteHydrationMetadata, p as isDeferred } from "./resolution-YHwi4Bav.js";
+import { n as disposeRegisteredDefaultPortalScope, r as getDefaultPortalHost } from "./default-portal-runtime-DvMvWJVp.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 +196,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 +307,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 +448,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 +473,8 @@ function resolveSSRRouteRender(opts) {
 		data,
 		ctx,
 		document,
-		cspNonce
+		cspNonce,
+		styleRegistrationValidation
 	};
 }
 function buildDocumentRenderArgs(resolved, appHtml) {
@@ -514,7 +518,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) {
@@ -551,7 +555,7 @@ function executeComponentSync(component, props, ctx, ownerFrame = null) {
 				cleanupError = error;
 			}
 			try {
-				disposeDefaultPortalScope(temp);
+				disposeRegisteredDefaultPortalScope(temp);
 			} catch (error) {
 				if (cleanupError) throw new AggregateError([cleanupError, error], "SSR temporary owner cleanup failed");
 				throw error;
@@ -592,7 +596,7 @@ function wrapWithDefaultPortal(out) {
 	if (isPromiseLike(out)) throwSSRDataMissing();
 	const portalVNode = {
 		$$typeof: ELEMENT_TYPE,
-		type: DefaultPortal,
+		type: getDefaultPortalHost(),
 		props: { __askrAutoDefaultPortal: true },
 		key: "__default_portal"
 	};
@@ -781,7 +785,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 +820,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 +857,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>`;
 }
@@ -1251,11 +1257,27 @@ function renderResolvedToStringSync(opts) {
 		...route,
 		handler
 	} : route);
+	const matchedRoute = routes[matchedIndex];
 	return renderToString({
 		url,
-		registry: createRouteRegistry(() => {
-			for (const route$1 of effectiveRoutes) route(route$1.path, route$1.handler, { namespace: route$1.namespace });
-		}),
+		registry: {
+			manifest: {
+				records: registry.manifest.records.map((record) => {
+					const effectiveHandler = record.path === matchedRoute.path && record.handler === matchedRoute.handler && record.options.namespace === matchedRoute.namespace ? handler : record.handler;
+					return {
+						...record,
+						component: effectiveHandler,
+						handler: effectiveHandler,
+						layoutChain: [],
+						pageChain: [],
+						options: record.options.namespace ? { namespace: record.options.namespace } : {},
+						metaChain: void 0
+					};
+				}),
+				...registry.manifest.basePath ? { basePath: registry.manifest.basePath } : {}
+			},
+			routes: effectiveRoutes
+		},
 		seed: options?.seed,
 		data: options?.data,
 		dataRuntime: options?.dataRuntime,
@@ -1401,6 +1423,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,
@@ -1421,6 +1446,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 };

package/dist/{state-BzIMC6-i.js → state-DCjONcHK.js}

@@ -1,7 +1,7 @@
-import { x as isProductionEnvironment } from "./access-ePqdQqkV.js";
-import { t as isBulkCommitActive } from "./fastlane-BOr4lSLl.js";
-import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-_GQGe_St.js";
+import { v as logger, x as isProductionEnvironment } from "./access-Dpfoi4cA.js";
+import { t as isBulkCommitActive } from "./fastlane-CrfB3QG0.js";
 import { i as claimHookIndex, p as getCurrentInstance } from "./component-scope-DzJEbYGE.js";
+import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B5NtV7V0.js";
 //#region src/runtime/state.ts
 /**
 * State primitive for Askr components
@@ -77,6 +77,7 @@ function createStateCell(initialValue, instance) {
 		else newValue = newValueOrUpdater;
 		if (Object.is(value, newValue)) return;
 		if (isBulkCommitActive()) {
+			if (!isProductionEnvironment()) logger.warn("[Askr] state.set() was called while a bulk commit (fast-lane reorder) was in progress. The value updated, but subscribers were not notified, so this change will not be reflected in the UI until an unrelated update triggers a re-render. This usually happens from a ref callback or a native focus/blur event fired synchronously during a large keyed-list reorder.");
 			value = newValue;
 			return;
 		}

package/dist/{portal-pHBoqwYd.js → structures-DsOm-clq.js}

@@ -1,11 +1,107 @@
-import { o as getRuntimeRenderer } from "./access-ePqdQqkV.js";
-import { t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
-import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-_GQGe_St.js";
+import { o as getRuntimeRenderer } from "./access-Dpfoi4cA.js";
 import { f as getCurrentComponentInstance, m as getCurrentPortalScope } from "./component-scope-DzJEbYGE.js";
-import { t as cleanupComponent } from "./component-cleanup-Bug5tSiG.js";
-import { c as getCurrentLifecycleCommitBatch, u as registerLifecycleTransaction } from "./lifecycle-batch-CFI4NKpJ.js";
-import { n as getActiveRenderContext } from "./render-context-D-DFk2WN.js";
+import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-C3IECePB.js";
+import { l as notifyReadableReaders, o as markReactivePropsDirtySource, s as markReadableDerivedSubscribersDirty, u as recordReadableRead } from "./readable-B5NtV7V0.js";
+import { t as cleanupComponent } from "./component-cleanup-BUfUleGZ.js";
+import { c as getCurrentLifecycleCommitBatch, u as registerLifecycleTransaction } from "./lifecycle-batch-Dfpid9-A.js";
+import { n as getActiveRenderContext } from "./render-context-D0Hoj9dW.js";
 import { i as createSSRPortalHostToken, n as SSR_PORTAL_HOST, r as createSSRPortalAnchorToken, t as SSR_PORTAL_ANCHOR } from "./portal-w3oQ6oQU.js";
+import { i as registerDefaultPortalRuntime } from "./default-portal-runtime-DvMvWJVp.js";
+//#region src/jsx/utils.ts
+function isElement(value) {
+	return typeof value === "object" && value !== null && value.$$typeof === ELEMENT_TYPE;
+}
+function cloneElement(element, props) {
+	return {
+		$$typeof: element.$$typeof,
+		type: element.type,
+		key: element.key,
+		props: {
+			...element.props,
+			...props
+		}
+	};
+}
+//#endregion
+//#region src/foundations/structures/layout.tsx
+function layout(Layout) {
+	return (children, props) => {
+		return Layout({
+			...props,
+			children
+		});
+	};
+}
+//#endregion
+//#region src/foundations/structures/slot.tsx
+/**
+* Slot
+*
+* Structural primitive for prop forwarding patterns.
+*
+* POLICY DECISIONS (LOCKED):
+*
+* 1. asChild Pattern
+*    When asChild=true, merges props into the single child element.
+*    Child must be a valid JSXElement; non-element children return null.
+*    **Slot props override child props** (injection pattern).
+*
+* 2. Fallback Behavior
+*    When asChild=false, returns a Fragment (structural no-op).
+*    No DOM element is introduced.
+*
+* 3. Type Safety
+*    asChild=true requires exactly one JSXElement child (enforced by type).
+*    Runtime validates with isElement() check.
+*/
+function Slot(props) {
+	if (props.asChild) {
+		const { children, asChild: _asChild, ...rest } = props;
+		if (isElement(children)) return cloneElement(children, rest);
+		return null;
+	}
+	return {
+		$$typeof: ELEMENT_TYPE,
+		type: Fragment,
+		props: { children: props.children },
+		key: null
+	};
+}
+//#endregion
+//#region src/foundations/structures/presence.ts
+/**
+* Presence
+*
+* Structural policy primitive for conditional mount/unmount.
+* - No timers
+* - No animation coupling
+* - No DOM side-effects
+*
+* POLICY DECISIONS (LOCKED):
+*
+* 1. Present as Function
+*    Accepts boolean OR function to support lazy evaluation patterns.
+*    Function is called once per render. Use boolean form for static values.
+*
+* 2. Children Type
+*    Presence forwards normal renderable child content only.
+*    Imperative DOM nodes are not part of the public contract.
+*
+* 3. Immediate Mount/Unmount
+*    No exit animations or transitions. When `present` becomes false,
+*    children are removed immediately. Animation must be layered above
+*    this primitive.
+*/
+function Presence({ present, children }) {
+	if (!(typeof present === "function" ? present() : Boolean(present))) return null;
+	return {
+		$$typeof: ELEMENT_TYPE,
+		type: Fragment,
+		props: { children },
+		key: null
+	};
+}
+//#endregion
 //#region src/runtime/portal.ts
 const DEFAULT_SSR_PORTAL_KEY = {};
 function getSSRPortalSlot(key) {
@@ -391,5 +487,138 @@ function Portal(props) {
 	writeDefaultPortal(props, owner);
 	return null;
 }
+registerDefaultPortalRuntime({
+	host: DefaultPortal,
+	clearForInstance(instance) {
+		clearDefaultPortalForInstance(instance);
+	},
+	disposeScope: disposeDefaultPortalScope
+});
+//#endregion
+//#region src/foundations/structures/collection.ts
+function createCollection() {
+	const registry = /* @__PURE__ */ new Map();
+	function register(node, metadata) {
+		const item = {
+			node,
+			metadata
+		};
+		registry.set(node, item);
+		return () => {
+			registry.delete(node);
+		};
+	}
+	function items() {
+		return Array.from(registry.values());
+	}
+	function clear() {
+		registry.clear();
+	}
+	function size() {
+		return registry.size;
+	}
+	return {
+		register,
+		items,
+		clear,
+		size
+	};
+}
+/**
+* USAGE EXAMPLE:
+*
+* // Create a collection for menu items
+* const menuItems = createCollection<HTMLElement, { disabled: boolean }>();
+*
+* // Register items
+* const unregister1 = menuItems.register(element1, { disabled: false });
+* const unregister2 = menuItems.register(element2, { disabled: true });
+*
+* // Query items
+* const allItems = menuItems.items();
+* const enabledItems = allItems.filter(item => !item.metadata.disabled);
+*
+* // Cleanup
+* unregister1();
+* unregister2();
+*/
+//#endregion
+//#region src/foundations/structures/layer.ts
+function createLayer() {
+	const stack = [];
+	let nextId = 1;
+	function register(options) {
+		const id = nextId++;
+		const entry = {
+			id,
+			options
+		};
+		stack.push(entry);
+		function isTop() {
+			return stack[stack.length - 1]?.id === id;
+		}
+		function unregister() {
+			const index = stack.findIndex((e) => e.id === id);
+			if (index !== -1) stack.splice(index, 1);
+		}
+		return {
+			id,
+			isTop,
+			unregister
+		};
+	}
+	function layers() {
+		return stack.map((entry) => ({
+			id: entry.id,
+			isTop: () => stack[stack.length - 1]?.id === entry.id,
+			unregister: () => {
+				const index = stack.findIndex((e) => e.id === entry.id);
+				if (index !== -1) stack.splice(index, 1);
+			}
+		}));
+	}
+	function handleEscape() {
+		const top = stack[stack.length - 1];
+		if (top) top.options.onEscape?.();
+	}
+	function handleOutsidePointer(e) {
+		const top = stack[stack.length - 1];
+		if (!top) return;
+		const node = top.options.node;
+		if (node && e.target instanceof Node) {
+			if (!node.contains(e.target)) top.options.onOutsidePointer?.(e);
+		} else top.options.onOutsidePointer?.(e);
+	}
+	return {
+		register,
+		layers,
+		handleEscape,
+		handleOutsidePointer
+	};
+}
+/**
+* USAGE EXAMPLE:
+*
+* const layerManager = createLayer();
+*
+* function Modal({ onClose }) {
+*   const modalRef = ref<HTMLDivElement>();
+*
+*   const layer = layerManager.register({
+*     node: modalRef.current,
+*     onEscape: onClose,
+*     onOutsidePointer: onClose,
+*   });
+*
+*   onUnmount(() => layer.unregister());
+*
+*   return (
+*     <div ref={modalRef}>
+*       <h1>Modal</h1>
+*       {layer.isTop() && <p>I am on top!</p>}
+*     </div>
+*   );
+* }
+*/
 //#endregion
-export { disposeDefaultPortalScope as a, definePortal as i, Portal as n, clearDefaultPortalForInstance as r, DefaultPortal as t };
+export { definePortal as a, layout as c, Portal as i, cloneElement as l, createCollection as n, Presence as o, DefaultPortal as r, Slot as s, createLayer as t, isElement as u };

package/dist/testing/index.d.ts

@@ -1,5 +1,5 @@
-import { l as ComponentFunction } from "../control-Y8F73Uln.js";
-import { M as RouteMatch, W as RouteRegistry, w as RouteAuthOptions } from "../index-_UN08Pg1.js";
+import { l as ComponentFunction } from "../control-DhUZU4_V.js";
+import { M as RouteMatch, W as RouteRegistry, w as RouteAuthOptions } from "../index-pIgGaXvS.js";
 import { C as Query, k as QueryStaleReason } from "../index-5S-fi2xy.js";
 //#region src/testing/render.d.ts
 interface RenderOptions {

package/dist/testing/index.js

@@ -1,7 +1,7 @@
-import { r as flushRuntimeScheduler } from "../access-ePqdQqkV.js";
-import { r as computeRouteActivityMatches } from "../route-matching-IfQZmqkN.js";
-import { l as addInvalidationListener } from "../data-runtime-D68YOo9L.js";
-import { a as cleanupApp, r as createSPA, t as createIsland } from "../boot-D28lesMw.js";
+import { r as flushRuntimeScheduler } from "../access-Dpfoi4cA.js";
+import { l as addInvalidationListener } from "../data-runtime-Ck3tJDDQ.js";
+import { r as computeRouteActivityMatches } from "../route-matching-DqULzZtC.js";
+import { a as cleanupApp, r as createSPA, t as createIsland } from "../boot-CViTpUiB.js";
 //#region src/testing/render.ts
 const renderStates = /* @__PURE__ */ new WeakMap();
 const eventConstructorNames = {

package/dist/{verify-hydration-BguOSco9.js → verify-hydration-ww1dgwea.js}

@@ -1,5 +1,6 @@
-import { t as SSR_RENDER_DATA_ATTR } from "./ssr-CbQO5xd3.js";
-import { a as renderResolvedToStringSync } from "./ssr-CtC4lChT.js";
+import { m as withHydrationVerificationRender } from "./render-context-D0Hoj9dW.js";
+import { t as SSR_RENDER_DATA_ATTR } from "./ssr-DSHd_Q9K.js";
+import { a as renderResolvedToStringSync } from "./ssr-B98593qJ.js";
 //#region src/ssr/verify-hydration.ts
 function normalizeHydrationHtml(html) {
 	const template = document.createElement("template");
@@ -9,13 +10,13 @@ function normalizeHydrationHtml(html) {
 }
 function verifyHydrationSyncForUrl(opts) {
 	const { root, url, registry, resolved, options } = opts;
-	const expected = renderResolvedToStringSync({
+	const expected = withHydrationVerificationRender(() => renderResolvedToStringSync({
 		url,
 		registry,
 		handler: resolved.handler,
 		params: resolved.params,
 		options
-	});
+	}));
 	return normalizeHydrationHtml(root.innerHTML) === normalizeHydrationHtml(expected);
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askrjs/askr",
-  "version": "0.0.84",
+  "version": "0.0.86",
   "description": "Actor-backed deterministic UI framework",
   "keywords": [
     "askr",
@@ -170,7 +170,7 @@
     }
   },
   "engines": {
-    "node": ">=24.15.0"
+    "node": ">=24.0.0"
   },
   "packageManager": "npm@12.0.1",
   "allowScripts": {