@askrjs/askr 0.0.70 → 0.0.71

package/dist/testing/index.js

@@ -1,5 +1,184 @@
-import { t as addInvalidationListener } from "../invalidation-listeners-Des3AHYs.js";
-import { r as computeRouteActivityMatches } from "../route-matching-DLBWDeXX.js";
+import { r as flushRuntimeScheduler } from "../access-ePqdQqkV.js";
+import { r as computeRouteActivityMatches } from "../route-matching-M-f1VQRu.js";
+import { l as addInvalidationListener } from "../data-runtime-rpV6-3XW.js";
+import { a as cleanupApp, r as createSPA, t as createIsland } from "../boot-DIKbEA4Y.js";
+//#region src/testing/render.ts
+const renderStates = /* @__PURE__ */ new WeakMap();
+const eventConstructorNames = {
+	auxclick: ["MouseEvent"],
+	click: ["MouseEvent"],
+	contextmenu: ["MouseEvent"],
+	dblclick: ["MouseEvent"],
+	mousedown: ["MouseEvent"],
+	mouseenter: ["MouseEvent"],
+	mouseleave: ["MouseEvent"],
+	mousemove: ["MouseEvent"],
+	mouseout: ["MouseEvent"],
+	mouseover: ["MouseEvent"],
+	mouseup: ["MouseEvent"],
+	pointercancel: ["PointerEvent", "MouseEvent"],
+	pointerdown: ["PointerEvent", "MouseEvent"],
+	pointerenter: ["PointerEvent", "MouseEvent"],
+	pointerleave: ["PointerEvent", "MouseEvent"],
+	pointermove: ["PointerEvent", "MouseEvent"],
+	pointerout: ["PointerEvent", "MouseEvent"],
+	pointerover: ["PointerEvent", "MouseEvent"],
+	pointerup: ["PointerEvent", "MouseEvent"],
+	keydown: ["KeyboardEvent"],
+	keypress: ["KeyboardEvent"],
+	keyup: ["KeyboardEvent"],
+	blur: ["FocusEvent"],
+	focus: ["FocusEvent"],
+	focusin: ["FocusEvent"],
+	focusout: ["FocusEvent"],
+	beforeinput: ["InputEvent"],
+	input: ["InputEvent"],
+	compositionend: ["CompositionEvent"],
+	compositionstart: ["CompositionEvent"],
+	compositionupdate: ["CompositionEvent"],
+	drag: ["DragEvent", "MouseEvent"],
+	dragend: ["DragEvent", "MouseEvent"],
+	dragenter: ["DragEvent", "MouseEvent"],
+	dragleave: ["DragEvent", "MouseEvent"],
+	dragover: ["DragEvent", "MouseEvent"],
+	dragstart: ["DragEvent", "MouseEvent"],
+	drop: ["DragEvent", "MouseEvent"],
+	touchcancel: ["TouchEvent"],
+	touchend: ["TouchEvent"],
+	touchmove: ["TouchEvent"],
+	touchstart: ["TouchEvent"],
+	wheel: ["WheelEvent", "MouseEvent"]
+};
+function requireDocument() {
+	if (typeof document === "undefined" || typeof document.createElement !== "function" || !document.body) throw new Error("@askrjs/askr/testing render requires a DOM environment. Configure Vitest with environment: \"jsdom\".");
+	return document;
+}
+function requireWindow() {
+	if (typeof window === "undefined" || !window.location || !window.history || typeof window.history.replaceState !== "function") throw new Error("@askrjs/askr/testing renderRoute requires a browser-like DOM environment. Configure Vitest with environment: \"jsdom\".");
+	return window;
+}
+function prepareContainer(options) {
+	const currentDocument = requireDocument();
+	const managed = options?.container === void 0;
+	const providedContainer = options?.container;
+	if (providedContainer !== void 0 && (!providedContainer || providedContainer.nodeType !== 1 || typeof providedContainer.querySelector !== "function" || typeof providedContainer.replaceChildren !== "function")) throw new TypeError("@askrjs/askr/testing render options.container must be an HTMLElement.");
+	const container = providedContainer ?? currentDocument.createElement("div");
+	if (renderStates.get(container)?.active) throw new Error("@askrjs/askr/testing cannot render into a container that already has an active render.");
+	if (managed) {
+		container.setAttribute("data-askr-testing-root", "");
+		currentDocument.body.appendChild(container);
+	}
+	const state = {
+		active: true,
+		managed
+	};
+	renderStates.set(container, state);
+	return {
+		container,
+		state
+	};
+}
+function getBaseEventConstructor(target) {
+	if (typeof Element !== "undefined" && target instanceof Element) return target.ownerDocument.defaultView?.Event ?? Event;
+	return Event;
+}
+function getEventConstructor(target, type) {
+	const realm = (typeof Element !== "undefined" && target instanceof Element ? target.ownerDocument.defaultView : typeof window !== "undefined" ? window : void 0) ?? globalThis;
+	for (const name of eventConstructorNames[type] ?? []) {
+		const constructor = realm[name];
+		if (typeof constructor === "function") return constructor;
+	}
+	return getBaseEventConstructor(target);
+}
+function isEventForTarget(target, value) {
+	if (value instanceof getBaseEventConstructor(target)) return true;
+	return typeof Event !== "undefined" && value instanceof Event;
+}
+function flush() {
+	flushRuntimeScheduler();
+}
+function dispatch(target, event, init = {}) {
+	if (!target || typeof target.dispatchEvent !== "function") throw new TypeError("@askrjs/askr/testing dispatch requires an EventTarget.");
+	if (typeof event !== "string" && !isEventForTarget(target, event)) throw new TypeError("@askrjs/askr/testing dispatch requires an Event instance or event type string.");
+	const dispatchedEvent = typeof event === "string" ? new (getEventConstructor(target, event))(event, {
+		bubbles: true,
+		cancelable: true,
+		...init
+	}) : event;
+	return target.dispatchEvent(dispatchedEvent);
+}
+function cleanupContainer(container) {
+	const state = renderStates.get(container);
+	if (!state?.active) return;
+	state.active = false;
+	try {
+		cleanupApp(container);
+	} finally {
+		container.replaceChildren();
+		if (state.managed) container.remove();
+		if (state.restoreHistory && state.restoreUrl) state.restoreHistory.replaceState({}, "", state.restoreUrl);
+		renderStates.delete(container);
+	}
+}
+function isRenderResult(target) {
+	return "container" in target && "cleanup" in target;
+}
+function cleanup(target) {
+	cleanupContainer(isRenderResult(target) ? target.container : target);
+}
+function createRenderResult(container) {
+	return {
+		container,
+		root: container,
+		flush,
+		dispatch,
+		unmount: () => cleanupContainer(container),
+		cleanup: () => cleanupContainer(container)
+	};
+}
+function render(component, options) {
+	if (typeof component !== "function") throw new TypeError("@askrjs/askr/testing render requires a component function.");
+	const { container } = prepareContainer(options);
+	try {
+		createIsland({
+			root: container,
+			component,
+			cleanupStrict: options?.cleanupStrict
+		});
+		flush();
+		return createRenderResult(container);
+	} catch (error) {
+		cleanupContainer(container);
+		throw error;
+	}
+}
+function mount(component, options) {
+	return render(component, options);
+}
+async function renderRoute(options) {
+	if (!options?.registry) throw new TypeError("@askrjs/askr/testing renderRoute requires a route registry.");
+	const currentWindow = requireWindow();
+	const { container, state } = prepareContainer(options);
+	try {
+		if (options.url !== void 0) {
+			state.restoreHistory = currentWindow.history;
+			state.restoreUrl = `${currentWindow.location.pathname}${currentWindow.location.search}${currentWindow.location.hash}`;
+			currentWindow.history.replaceState({}, "", options.url);
+		}
+		await createSPA({
+			root: container,
+			registry: options.registry,
+			auth: options.auth,
+			cleanupStrict: options.cleanupStrict
+		});
+		flush();
+		return createRenderResult(container);
+	} catch (error) {
+		cleanupContainer(container);
+		throw error;
+	}
+}
+//#endregion
 //#region src/testing/index.ts
 function normalizeRefresh(options) {
 	return async () => {
@@ -163,4 +342,4 @@ function getRouteWarnings(options) {
 	});
 }
 //#endregion
-export { createInvalidationRecorder, getRouteWarnings, matchRoute, mockQuery, queryState };
+export { cleanup, createInvalidationRecorder, dispatch, flush, getRouteWarnings, matchRoute, mockQuery, mount, queryState, render, renderRoute };

package/dist/{verify-hydration-ChyEiBAn.js → verify-hydration-CVSGv6Vs.js}

@@ -1,5 +1,5 @@
 import { t as SSR_RENDER_DATA_ATTR } from "./ssr-CbQO5xd3.js";
-import { a as renderResolvedToStringSync } from "./ssr-vE-KUgDV.js";
+import { a as renderResolvedToStringSync } from "./ssr-BSUA9Y64.js";
 //#region src/ssr/verify-hydration.ts
 function normalizeHydrationHtml(html) {
 	const template = document.createElement("template");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askrjs/askr",
-  "version": "0.0.70",
+  "version": "0.0.71",
   "description": "Actor-backed deterministic UI framework",
   "keywords": [
     "askr",
@@ -23,6 +23,7 @@
     "url": "git+https://github.com/askrjs/askr.git"
   },
   "files": [
+    "capabilities.json",
     "dist/**/*.js",
     "dist/**/*.d.ts"
   ],
@@ -113,7 +114,8 @@
       "types": "./dist/jsx-dev-runtime.d.ts",
       "import": "./dist/jsx-dev-runtime.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./capabilities.json": "./capabilities.json"
   },
   "publishConfig": {
     "access": "public"

package/dist/attr-names-CjhzmHOn.js

@@ -1,15 +0,0 @@
-//#region src/common/attr-names.ts
-const PUBLIC_ATTRIBUTE_NAME_MAP = {
-	className: "class",
-	htmlFor: "for",
-	strokeWidth: "stroke-width",
-	strokeLinecap: "stroke-linecap",
-	strokeLinejoin: "stroke-linejoin",
-	fillRule: "fill-rule",
-	clipRule: "clip-rule"
-};
-function getPublicAttributeName(propName) {
-	return PUBLIC_ATTRIBUTE_NAME_MAP[propName] ?? propName;
-}
-//#endregion
-export { getPublicAttributeName as t };

package/dist/component-scope-CvPba6O6.d.ts

@@ -1,12 +0,0 @@
-//#region src/runtime/component-scope.d.ts
-/**
- * Get the abort signal for the current component.
- *
- * The signal is guaranteed to be aborted when:
- * - Component unmounts
- * - Navigation occurs (different route)
- * - Parent is destroyed
- */
-declare function getSignal(): AbortSignal;
-//#endregion
-export { getSignal as t };

package/dist/invalidation-listeners-Des3AHYs.js

@@ -1,13 +0,0 @@
-//#region src/data/invalidation-listeners.ts
-const invalidationListeners = /* @__PURE__ */ new Set();
-function addInvalidationListener(listener) {
-	invalidationListeners.add(listener);
-	return () => {
-		invalidationListeners.delete(listener);
-	};
-}
-function emitInvalidation(event) {
-	for (const listener of invalidationListeners) listener(event);
-}
-//#endregion
-export { emitInvalidation as n, addInvalidationListener as t };

package/dist/jsx-runtime-X2SX2y8V.d.ts

@@ -1,2 +0,0 @@
-import "./types-DEhT-Nrv.js";
-import "./jsx-runtime-aYZ8zb4q.js";

package/dist/resource-operation-BJiLoLYZ.js

@@ -1,276 +0,0 @@
-import { t as enqueueRuntimeLane, v as logger } from "./access-ePqdQqkV.js";
-import { c as registerCommitOperationForInstance, d as getCurrentContextFrame, g as withAsyncResourceContext } from "./component-internal-CPjM4n8M.js";
-import { f as getCurrentComponentInstance } from "./component-scope-CC3cojX9.js";
-import { p as isPromiseLike } from "./lifecycle-batch-COgl8jMS.js";
-import { t as brandSnapshotSource } from "./snapshot-source-BB42xgwb.js";
-import { i as getNextRenderKey, l as throwSSRDataMissing, n as getActiveRenderContext, r as getCurrentRenderData, u as SSRDataMissingError } from "./render-context-Clw3rFiO.js";
-import { t as state } from "./state-CVuQVjvK.js";
-//#region src/runtime/resource-cell.ts
-/**
-* Pure, component-agnostic ResourceCell state machine.
-* - Holds value/pending/error/generation/controller
-* - Exposes a stable `snapshot` object: { value, pending, error, refresh }
-* - Uses `withAsyncResourceContext` to bind the synchronous execution step
-*   to a captured frame. Continuations after await do not see the frame.
-*/
-var ResourceCell = class {
-	constructor(fn, deps, resourceFrame) {
-		this.value = null;
-		this.pending = true;
-		this.error = null;
-		this.generation = 0;
-		this.controller = null;
-		this.deps = null;
-		this.resourceFrame = null;
-		this.subscribers = /* @__PURE__ */ new Set();
-		this.disposed = false;
-		this.fn = fn;
-		this.deps = deps ? deps.slice() : null;
-		this.resourceFrame = resourceFrame;
-		this.snapshot = brandSnapshotSource({
-			value: null,
-			pending: true,
-			error: null,
-			refresh: () => this.refresh()
-		});
-	}
-	setLoader(fn) {
-		this.fn = fn;
-	}
-	subscribe(cb) {
-		this.subscribers.add(cb);
-		return () => this.subscribers.delete(cb);
-	}
-	notifySubscribers() {
-		this.snapshot.value = this.value;
-		this.snapshot.pending = this.pending;
-		this.snapshot.error = this.error;
-		for (const cb of this.subscribers) cb();
-	}
-	start(ssr = false, notify = true) {
-		if (this.disposed) return;
-		const generation = this.generation;
-		this.controller?.abort();
-		const controller = new AbortController();
-		this.controller = controller;
-		this.pending = true;
-		this.error = null;
-		if (notify) this.notifySubscribers();
-		let result;
-		try {
-			result = withAsyncResourceContext(this.resourceFrame, () => this.fn({ signal: controller.signal }));
-		} catch (err) {
-			this.pending = false;
-			this.error = err instanceof Error ? err : new Error(String(err));
-			if (notify) this.notifySubscribers();
-			return;
-		}
-		if (!isPromiseLike(result)) {
-			this.value = result;
-			this.pending = false;
-			this.error = null;
-			if (notify) this.notifySubscribers();
-			return;
-		}
-		if (ssr) throwSSRDataMissing();
-		Promise.resolve(result).then((val) => {
-			if (this.generation !== generation) return;
-			if (this.controller !== controller) return;
-			if (controller.signal.aborted) return;
-			this.value = val;
-			this.pending = false;
-			this.error = null;
-			this.notifySubscribers();
-		}).catch((err) => {
-			if (this.generation !== generation) return;
-			if (this.controller !== controller) return;
-			if (controller.signal.aborted || err instanceof Error && err.name === "AbortError" || typeof DOMException !== "undefined" && err instanceof DOMException && err.name === "AbortError") return;
-			this.pending = false;
-			this.error = err instanceof Error ? err : new Error(String(err));
-			try {
-				if (this.ownerName) logger.error(`[Askr] Async resource error in ${this.ownerName}:`, err);
-				else logger.error("[Askr] Async resource error:", err);
-			} catch {}
-			this.notifySubscribers();
-		});
-	}
-	refresh() {
-		if (this.disposed) return;
-		this.generation++;
-		this.controller?.abort();
-		this.start();
-	}
-	abort() {
-		this.controller?.abort();
-	}
-	dispose() {
-		if (this.disposed) return;
-		this.disposed = true;
-		this.controller?.abort();
-		this.subscribers.clear();
-	}
-};
-//#endregion
-//#region src/runtime/resource-operation.ts
-/**
-* Resource primitive — simple, deterministic async primitive
-* Usage: resource(fn, deps)
-* - fn receives { signal }
-* - captures execution context once at creation (synchronous step only)
-* - executes at most once per generation; stale async results are ignored
-* - refresh() cancels in-flight execution, increments generation and re-runs
-* - exposes { value, pending, error, refresh }
-* - during SSR, async results are disallowed and will throw synchronously
-*/
-function resource(fn, deps = []) {
-	const instance = getCurrentComponentInstance();
-	const inst = instance;
-	if (!instance) {
-		const renderData = getCurrentRenderData()?.resources;
-		if (renderData && (getActiveRenderContext()?.resourceDataProvided || Object.keys(renderData).some((key) => key.startsWith("r:")))) {
-			const key = getNextRenderKey();
-			if (!(key in renderData)) throwSSRDataMissing();
-			const val = renderData[key];
-			return brandSnapshotSource({
-				value: val,
-				pending: false,
-				error: null,
-				refresh: () => {}
-			});
-		}
-		if (getActiveRenderContext()) throwSSRDataMissing();
-		throw new Error("[Askr] resource() must be called during component render inside an app. Do not create resources at module scope or outside render.");
-	}
-	const renderData = getCurrentRenderData()?.resources;
-	if (renderData && (getActiveRenderContext()?.resourceDataProvided || Object.keys(renderData).some((key) => key.startsWith("r:")))) {
-		const key = getNextRenderKey();
-		if (!(key in renderData)) throwSSRDataMissing();
-		const val = renderData[key];
-		const h = state({
-			cell: void 0,
-			snapshot: brandSnapshotSource({
-				value: val,
-				pending: false,
-				error: null,
-				refresh: () => {}
-			})
-		})();
-		h.snapshot.value = val;
-		h.snapshot.pending = false;
-		h.snapshot.error = null;
-		return h.snapshot;
-	}
-	const holder = state({
-		cell: void 0,
-		snapshot: brandSnapshotSource({
-			value: null,
-			pending: true,
-			error: null,
-			refresh: () => {}
-		})
-	});
-	const h = holder();
-	if (!h.cell) {
-		const cell = new ResourceCell(fn, deps, getCurrentContextFrame());
-		cell.ownerName = inst.fn?.name || "<anonymous>";
-		h.cell = cell;
-		h.snapshot = cell.snapshot;
-		const unsubscribe = cell.subscribe(() => {
-			const cur = holder();
-			cur.snapshot.value = cell.snapshot.value;
-			cur.snapshot.pending = cell.snapshot.pending;
-			cur.snapshot.error = cell.snapshot.error;
-			holder.set(cur);
-			try {
-				inst.notifyUpdate?.();
-			} catch {}
-		});
-		(inst.cleanupFns ??= []).push(() => {
-			unsubscribe();
-			cell.dispose();
-		});
-		if (inst.ssr) {
-			cell.start(true, false);
-			if (!cell.pending) {
-				const cur = holder();
-				cur.snapshot.value = cell.value;
-				cur.snapshot.pending = cell.pending;
-				cur.snapshot.error = cell.error;
-			}
-		} else {
-			const scheduledGeneration = cell.generation;
-			registerCommitOperationForInstance(inst, () => {
-				enqueueRuntimeLane("post", () => {
-					if (!inst.notifyUpdate || cell.generation !== scheduledGeneration) return;
-					try {
-						cell.start(false, false);
-					} catch (err) {
-						const cur = holder();
-						cur.snapshot.value = cell.value;
-						cur.snapshot.pending = cell.pending;
-						cur.snapshot.error = err ?? null;
-						holder.set(cur);
-						inst.notifyUpdate?.();
-						return;
-					}
-					if (!cell.pending) {
-						const cur = holder();
-						cur.snapshot.value = cell.value;
-						cur.snapshot.pending = cell.pending;
-						cur.snapshot.error = cell.error;
-						holder.set(cur);
-						inst.notifyUpdate?.();
-					}
-				});
-			});
-		}
-	}
-	const cell = h.cell;
-	cell.setLoader(fn);
-	if (!cell.deps || cell.deps.length !== deps.length || cell.deps.some((d, i) => !Object.is(d, deps[i]))) {
-		cell.deps = deps.slice();
-		cell.generation++;
-		cell.pending = true;
-		cell.error = null;
-		h.snapshot.pending = true;
-		h.snapshot.error = null;
-		try {
-			if (inst.ssr) {
-				cell.start(true, false);
-				if (!cell.pending) {
-					const cur = holder();
-					cur.snapshot.value = cell.value;
-					cur.snapshot.pending = cell.pending;
-					cur.snapshot.error = cell.error;
-				}
-			} else {
-				const scheduledGeneration = cell.generation;
-				registerCommitOperationForInstance(inst, () => {
-					enqueueRuntimeLane("post", () => {
-						if (!inst.notifyUpdate || cell.generation !== scheduledGeneration) return;
-						cell.start(false, false);
-						if (!cell.pending) {
-							const cur = holder();
-							cur.snapshot.value = cell.value;
-							cur.snapshot.pending = cell.pending;
-							cur.snapshot.error = cell.error;
-							holder.set(cur);
-							inst.notifyUpdate?.();
-						}
-					});
-				});
-			}
-		} catch (err) {
-			if (err instanceof SSRDataMissingError) throw err;
-			cell.error = err;
-			cell.pending = false;
-			const cur = holder();
-			cur.snapshot.value = cell.value;
-			cur.snapshot.pending = cell.pending;
-			cur.snapshot.error = cell.error;
-		}
-	}
-	return h.snapshot;
-}
-//#endregion
-export { resource as t };