@askrjs/askr 0.0.85 → 0.0.87

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

@@ -1,11 +1,107 @@
 import { o as getRuntimeRenderer } from "./access-Dpfoi4cA.js";
 import { f as getCurrentComponentInstance, m as getCurrentPortalScope } from "./component-scope-DzJEbYGE.js";
-import { t as ELEMENT_TYPE } from "./jsx-C3IECePB.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-D-DFk2WN.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,6 +1,6 @@
 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";
+import { M as RouteMatch, W as RouteRegistry, w as RouteAuthOptions } from "../index-BvNkcegT.js";
+import { C as Query, k as QueryStaleReason, v as DataRuntime } from "../index-SGxMZLAc.js";
 //#region src/testing/render.d.ts
 interface RenderOptions {
   /**
@@ -34,6 +34,20 @@ declare function mount(component: ComponentFunction, options?: RenderOptions): R
 declare function renderRoute(options: RouteRenderOptions): Promise<RenderResult>;
 //#endregion
 //#region src/testing/index.d.ts
+/** Dispatch the browser click sequence expected by Askr's delegated events. */
+declare function click(element: Element): boolean;
+/** Set a text control's value and emit an input event for each character. */
+declare function type(element: HTMLInputElement | HTMLTextAreaElement, text: string): void;
+/** Dispatch a cancelable bubbling submit event on a form. */
+declare function submit(form: HTMLFormElement): boolean;
+interface QueryTestRegistry {
+  readonly runtime: DataRuntime;
+  set<T extends {}>(key: string, query: Query<T>): void;
+  delete(key: string): void;
+  clear(): void;
+}
+/** Create a keyed query fixture registry for a test render runtime. */
+declare function createQueryTestRegistry(): QueryTestRegistry;
 type MockRefresh = () => void | Promise<void>;
 interface MockQueryOptions {
   refresh?: MockRefresh;
@@ -80,4 +94,4 @@ declare function createInvalidationRecorder(): InvalidationRecorder;
 declare function matchRoute(path: string, options: MatchRouteOptions): RouteMatch | null;
 declare function getRouteWarnings(options: MatchRouteOptions): RoutePatternWarning[];
 //#endregion
-export { InvalidationRecord, InvalidationRecorder, MockQueryOptions, MockRefresh, type RenderOptions, type RenderResult, RoutePatternWarning, type RouteRenderOptions, cleanup, createInvalidationRecorder, dispatch, flush, getRouteWarnings, matchRoute, mockQuery, mount, queryState, render, renderRoute };
+export { InvalidationRecord, InvalidationRecorder, MockQueryOptions, MockRefresh, QueryTestRegistry, type RenderOptions, type RenderResult, RoutePatternWarning, type RouteRenderOptions, cleanup, click, createInvalidationRecorder, createQueryTestRegistry, dispatch, flush, getRouteWarnings, matchRoute, mockQuery, mount, queryState, render, renderRoute, submit, type };

package/dist/testing/index.js

@@ -1,7 +1,7 @@
 import { r as flushRuntimeScheduler } from "../access-Dpfoi4cA.js";
-import { r as computeRouteActivityMatches } from "../route-matching-DHduNiGk.js";
-import { l as addInvalidationListener } from "../data-runtime-D68YOo9L.js";
-import { a as cleanupApp, r as createSPA, t as createIsland } from "../boot-DWe880Et.js";
+import { l as addInvalidationListener, t as createDataRuntime } from "../data-runtime-CnVeSvJz.js";
+import { r as computeRouteActivityMatches } from "../route-matching-DqULzZtC.js";
+import { a as cleanupApp, r as createSPA, t as createIsland } from "../boot-Bd-j_BL5.js";
 //#region src/testing/render.ts
 const renderStates = /* @__PURE__ */ new WeakMap();
 const eventConstructorNames = {
@@ -180,6 +180,44 @@ async function renderRoute(options) {
 }
 //#endregion
 //#region src/testing/index.ts
+/** Dispatch the browser click sequence expected by Askr's delegated events. */
+function click(element) {
+	if (!element || typeof element.dispatchEvent !== "function") throw new TypeError("@askrjs/askr/testing click requires an Element.");
+	return dispatch(element, "click");
+}
+/** Set a text control's value and emit an input event for each character. */
+function type(element, text) {
+	if (!element || typeof element.dispatchEvent !== "function") throw new TypeError("@askrjs/askr/testing type requires a text control.");
+	for (const character of text) {
+		element.value += character;
+		dispatch(element, "input", {
+			inputType: "insertText",
+			data: character
+		});
+	}
+}
+/** Dispatch a cancelable bubbling submit event on a form. */
+function submit(form) {
+	if (!form || typeof form.dispatchEvent !== "function") throw new TypeError("@askrjs/askr/testing submit requires a form.");
+	return dispatch(form, "submit");
+}
+/** Create a keyed query fixture registry for a test render runtime. */
+function createQueryTestRegistry() {
+	const runtime = createDataRuntime();
+	return {
+		runtime,
+		set(key, query) {
+			if (typeof key !== "string" || key.length === 0) throw new TypeError("@askrjs/askr/testing query registry keys must be non-empty strings.");
+			runtime.queryTestOverrides.set(key, query);
+		},
+		delete(key) {
+			runtime.queryTestOverrides.delete(key);
+		},
+		clear() {
+			runtime.queryTestOverrides.clear();
+		}
+	};
+}
 function normalizeRefresh(options) {
 	return async () => {
 		await options?.refresh?.();
@@ -342,4 +380,4 @@ function getRouteWarnings(options) {
 	});
 }
 //#endregion
-export { cleanup, createInvalidationRecorder, dispatch, flush, getRouteWarnings, matchRoute, mockQuery, mount, queryState, render, renderRoute };
+export { cleanup, click, createInvalidationRecorder, createQueryTestRegistry, dispatch, flush, getRouteWarnings, matchRoute, mockQuery, mount, queryState, render, renderRoute, submit, type };

package/dist/{verify-hydration-C3QBBQqR.js → verify-hydration-DkISyZCo.js}

@@ -1,5 +1,6 @@
+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-CpiBHMNv.js";
+import { a as renderResolvedToStringSync } from "./ssr-q250YlKo.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.85",
+  "version": "0.0.87",
   "description": "Actor-backed deterministic UI framework",
   "keywords": [
     "askr",
@@ -24,6 +24,7 @@
   },
   "files": [
     "capabilities.json",
+    "CHANGELOG.md",
     "dist/**/*.js",
     "dist/**/*.d.ts"
   ],
@@ -170,7 +171,7 @@
     }
   },
   "engines": {
-    "node": ">=24.15.0"
+    "node": ">=24.0.0"
   },
   "packageManager": "npm@12.0.1",
   "allowScripts": {

package/dist/render-context-D-DFk2WN.js

@@ -1,73 +0,0 @@
-//#region src/common/ssr-errors.ts
-/**
-* Common call contracts: SSR error types
-*/
-var SSRDataMissingError = class SSRDataMissingError extends Error {
-	constructor(message = "Server-side rendering requires all data to be available synchronously. This component attempted to use async data during SSR.") {
-		super(message);
-		this.code = "SSR_DATA_MISSING";
-		this.name = "SSRDataMissingError";
-		Object.setPrototypeOf(this, SSRDataMissingError.prototype);
-	}
-};
-//#endregion
-//#region src/common/render-context.ts
-let provider = { getRenderContext() {
-	return null;
-} };
-let hydrationRenderData = null;
-let hydrationKeyCounter = 0;
-function configureRenderContextProvider(nextProvider) {
-	provider = nextProvider;
-}
-function getActiveRenderContext() {
-	return provider.getRenderContext();
-}
-/** Register request-local CSS produced during SSR without importing the SSR renderer in clients. */
-function registerSSRStyle(id, cssText) {
-	const context = getActiveRenderContext();
-	if (!context?.ssrStyles) return;
-	const safeCssText = cssText.replace(/<\/style/gi, "<\\/style");
-	const existing = context.ssrStyles.get(id);
-	if (existing && existing.cssText !== safeCssText) throw new RangeError(`SSR style registration collision for ${JSON.stringify(id)}.`);
-	context.ssrStyles.set(id, {
-		id,
-		cssText: safeCssText
-	});
-}
-function getCurrentRenderData() {
-	return getActiveRenderContext()?.renderData ?? hydrationRenderData;
-}
-function getNextRenderKey() {
-	const ctx = getActiveRenderContext();
-	if (ctx) return `r:${ctx.keyCounter++}`;
-	if (hydrationRenderData) return `r:${hydrationKeyCounter++}`;
-	return "r:0";
-}
-function startHydrationRenderPhase(data) {
-	hydrationRenderData = data;
-	hydrationKeyCounter = 0;
-}
-function stopHydrationRenderPhase() {
-	hydrationRenderData = null;
-	hydrationKeyCounter = 0;
-}
-function startRenderPhase(data) {
-	const ctx = getActiveRenderContext();
-	if (ctx) {
-		ctx.renderData = data ?? null;
-		ctx.keyCounter = 0;
-	}
-}
-function stopRenderPhase() {
-	const ctx = getActiveRenderContext();
-	if (ctx) {
-		ctx.renderData = null;
-		ctx.keyCounter = 0;
-	}
-}
-function throwSSRDataMissing() {
-	throw new SSRDataMissingError();
-}
-//#endregion
-export { registerSSRStyle as a, stopHydrationRenderPhase as c, SSRDataMissingError as d, getNextRenderKey as i, stopRenderPhase as l, getActiveRenderContext as n, startHydrationRenderPhase as o, getCurrentRenderData as r, startRenderPhase as s, configureRenderContextProvider as t, throwSSRDataMissing as u };

package/dist/structures-DSLF_iis.js

@@ -1,223 +0,0 @@
-import { n as Fragment, t as ELEMENT_TYPE } from "./jsx-C3IECePB.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/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 { layout as a, Slot as i, createCollection as n, cloneElement as o, Presence as r, isElement as s, createLayer as t };