@askrjs/askr 0.2.3 → 0.3.0

package/dist/testing/index.js

@@ -1,9 +1,10 @@
-import { r as flushRuntimeScheduler } from "../access-Rr7CMa06.js";
-import { u as recordReadableRead } from "../readable-CEcteIDE.js";
-import { l as addInvalidationListener, t as createDataRuntime } from "../data-runtime-7t_Y0iv3.js";
-import { a as normalizeAsyncDataError, o as notifySource, t as createReadableSource } from "../shared-CGrx2AOL.js";
-import { r as computeRouteActivityMatches } from "../route-matching-Bo6UqG-5.js";
-import { a as cleanupApp, r as createSPA, t as createIsland } from "../boot-D4GaLA0d.js";
+import { r as flushRuntimeScheduler } from "../access-CEA2pOry.js";
+import { v as recordReadableRead } from "../notify-DxxuDPeY.js";
+import { l as addInvalidationListener, t as createDataRuntime } from "../data-runtime-CxoY98lX.js";
+import { a as loadingQueryState, i as freshQueryState, o as refreshingQueryState, r as errorQueryState, s as staleQueryState } from "../data-2edW0jhF.js";
+import { a as normalizeAsyncDataError, o as notifySource, t as createReadableSource } from "../shared-kU8yvryp.js";
+import { a as cleanupApp, n as createSPA, r as createIsland } from "../boot-BMBMWUGI.js";
+import { r as computeRouteActivityMatches } from "../route-matching-CUzZ31gT.js";
 //#region src/testing/render.ts
 const renderStates = /* @__PURE__ */ new WeakMap();
 const eventConstructorNames = {
@@ -149,7 +150,8 @@ function render(component, options) {
 		createIsland({
 			root: container,
 			component,
-			cleanupStrict: options?.cleanupStrict
+			cleanupStrict: options?.cleanupStrict,
+			dataRuntime: options?.dataRuntime
 		});
 		flush();
 		return createRenderResult(container);
@@ -188,7 +190,7 @@ async function renderRoute(options) {
 	}
 }
 //#endregion
-//#region src/testing/index.ts
+//#region src/testing/interactions.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.");
@@ -210,6 +212,8 @@ function submit(form) {
 	if (!form || typeof form.dispatchEvent !== "function") throw new TypeError("@askrjs/askr/testing submit requires a form.");
 	return dispatch(form, "submit");
 }
+//#endregion
+//#region src/testing/registries.ts
 /** Create a keyed query fixture registry for a test render runtime. */
 function createQueryTestRegistry() {
 	const runtime = createDataRuntime();
@@ -248,6 +252,8 @@ function createMutationTestRegistry() {
 		}
 	};
 }
+//#endregion
+//#region src/testing/mutation-fixtures.ts
 var MutableMutationFixture = class {
 	constructor(initial = {}) {
 		this.source = createReadableSource();
@@ -375,6 +381,8 @@ const mutationState = Object.assign(createMutationFixture, {
 		return createMutationFixture({ error });
 	}
 });
+//#endregion
+//#region src/testing/query-fixtures.ts
 function normalizeRefresh(options) {
 	return async () => {
 		await options?.refresh?.();
@@ -387,15 +395,7 @@ function makeQuery(state, options) {
 	};
 }
 function createFreshQuery(data, options) {
-	return makeQuery({
-		data,
-		error: null,
-		loading: false,
-		refreshing: false,
-		stale: false,
-		consistency: "fresh",
-		staleReason: null
-	}, options);
+	return makeQuery(freshQueryState(data), options);
 }
 /**
 * Build a fresh {@link Query} fixture for tests: call directly with data, or
@@ -403,59 +403,19 @@ function createFreshQuery(data, options) {
 */
 const mockQuery = Object.assign(createFreshQuery, {
 	loading(options) {
-		return makeQuery({
-			data: null,
-			error: null,
-			loading: true,
-			refreshing: false,
-			stale: false,
-			consistency: "fresh",
-			staleReason: null
-		}, options);
+		return makeQuery(loadingQueryState(), options);
 	},
 	error(error, previousData, options) {
-		return makeQuery({
-			data: previousData ?? null,
-			error,
-			loading: false,
-			refreshing: false,
-			stale: true,
-			consistency: "stale",
-			staleReason: "error"
-		}, options);
+		return makeQuery(errorQueryState(previousData ?? null, error), options);
 	},
 	refreshing(data, options) {
-		return makeQuery({
-			data,
-			error: null,
-			loading: false,
-			refreshing: true,
-			stale: true,
-			consistency: "refreshing",
-			staleReason: null
-		}, options);
+		return makeQuery(refreshingQueryState(data, "refreshing"), options);
 	},
 	stale(data, reason = "inconsistent", options) {
-		return makeQuery({
-			data,
-			error: null,
-			loading: false,
-			refreshing: false,
-			stale: true,
-			consistency: "stale",
-			staleReason: reason
-		}, options);
+		return makeQuery(staleQueryState(data, reason), options);
 	},
 	pendingWrite(data, options) {
-		return makeQuery({
-			data,
-			error: null,
-			loading: false,
-			refreshing: true,
-			stale: true,
-			consistency: "pending-write",
-			staleReason: null
-		}, options);
+		return makeQuery(refreshingQueryState(data, "pending-write"), options);
 	}
 });
 /** Alias table mirroring {@link mockQuery}'s state builders (`fresh`, `loading`, `error`, ...). */
@@ -467,6 +427,8 @@ const queryState = {
 	stale: mockQuery.stale,
 	pendingWrite: mockQuery.pendingWrite
 };
+//#endregion
+//#region src/testing/invalidation.ts
 /** Start recording {@link invalidate} calls for assertions; call `stop()` when done. */
 function createInvalidationRecorder() {
 	const records = [];
@@ -494,6 +456,8 @@ function createInvalidationRecorder() {
 		}
 	};
 }
+//#endregion
+//#region src/testing/routes.ts
 /** Match `path` against a route registry for tests, without mounting the app. */
 function matchRoute(path, options) {
 	if (!options?.registry) throw new TypeError("matchRoute requires options.registry.");

package/dist/timer-C7uqnJVt.js

@@ -0,0 +1,85 @@
+import { a as registerCommitOperation } from "./instance-VAFYVJOa.js";
+import { O as ownCleanup, f as getCurrentComponentInstance, i as claimHookIndex } from "./scope-Cq_iYbTR.js";
+import { n as getComponentLifecycleSlot } from "./capabilities-Bbf0mlp9.js";
+import { t as isRouteActivityActive } from "./route-activity-CNJfpwx-.js";
+//#region src/runtime/lifecycle/policy.ts
+function normalizePredicates(predicates) {
+	if (!predicates) return [];
+	return typeof predicates === "function" ? [predicates] : predicates;
+}
+function allPredicatesPass(predicates) {
+	for (const predicate of predicates) if (!predicate()) return false;
+	return true;
+}
+/** {@link ActivityPredicate} that is true while the current route matches `pathOrPaths`. */
+function routeActive(pathOrPaths) {
+	return () => isRouteActivityActive(pathOrPaths);
+}
+//#endregion
+//#region src/resources/browser-activity.ts
+/** Activity gates retain their permissive server defaults. */
+function documentVisible() {
+	return () => typeof document === "undefined" || document.visibilityState !== "hidden";
+}
+function windowFocused() {
+	return () => typeof document === "undefined" || typeof document.hasFocus !== "function" || document.hasFocus();
+}
+/** Browser target factories are deferred and skipped during server execution. */
+function resolveListenerTarget(target) {
+	return typeof target === "function" ? typeof window === "undefined" ? null : target() ?? null : target;
+}
+//#endregion
+//#region src/runtime/lifecycle/timer.ts
+function stopTimerSlot(slot) {
+	if (slot.id === null) return;
+	clearInterval(slot.id);
+	slot.id = null;
+}
+function startTimerSlot(slot) {
+	slot.id = setInterval(() => {
+		if (allPredicatesPass(slot.predicates)) slot.callback();
+	}, slot.intervalMs ?? slot.pendingIntervalMs);
+}
+function commitTimerSlot(instance, slot) {
+	const intervalChanged = slot.intervalMs !== slot.pendingIntervalMs;
+	slot.callback = slot.pendingCallback;
+	slot.predicates = slot.pendingPredicates;
+	if (slot.id === null || intervalChanged) {
+		stopTimerSlot(slot);
+		slot.intervalMs = slot.pendingIntervalMs;
+		startTimerSlot(slot);
+	}
+	if (!slot.cleanupRegistered) {
+		slot.cleanupRegistered = true;
+		ownCleanup(instance.owner, () => {
+			stopTimerSlot(slot);
+			slot.cleanupRegistered = false;
+		});
+	}
+}
+/** Run `fn` on an owned interval for the current component's lifetime, optionally gated by `options.when`. */
+function timer(intervalMs, fn, options) {
+	const instance = getCurrentComponentInstance();
+	if (!instance) return;
+	const index = claimHookIndex(instance, "timer");
+	const predicates = normalizePredicates(options?.when);
+	const slot = getComponentLifecycleSlot(instance, index, "timer", () => ({
+		kind: "timer",
+		id: null,
+		intervalMs: null,
+		pendingIntervalMs: intervalMs,
+		callback: fn,
+		predicates,
+		pendingCallback: fn,
+		pendingPredicates: predicates,
+		cleanupRegistered: false
+	}));
+	slot.pendingIntervalMs = intervalMs;
+	slot.pendingCallback = fn;
+	slot.pendingPredicates = predicates;
+	registerCommitOperation(() => {
+		commitTimerSlot(instance, slot);
+	});
+}
+//#endregion
+export { routeActive as a, windowFocused as i, documentVisible as n, resolveListenerTarget as r, timer as t };

package/dist/{index-B1gu0_m0.d.ts → utilities.d.ts}

@@ -1,4 +1,3 @@
-//#region src/foundations/utilities/event-types.d.ts
 /** Minimal shape of an event that can be prevented from its default action. */
 interface DefaultPreventable {
   defaultPrevented?: boolean;
@@ -22,8 +21,6 @@ interface PointerLikeEvent extends DefaultPreventable, PropagationStoppable {
 interface FocusLikeEvent extends DefaultPreventable, PropagationStoppable {
   relatedTarget?: unknown;
 }
-//#endregion
-//#region src/foundations/utilities/compose-handlers.d.ts
 /**
  * composeHandlers
  *
@@ -61,16 +58,19 @@ interface ComposeHandlersOptions {
  * Compose two optional event handlers into one, running `first` then
  * `second` unless `first` marked the event as default-prevented.
  */
-declare function composeHandlers<A extends readonly unknown[]>(first?: (...args: A) => void, second?: (...args: A) => void, options?: ComposeHandlersOptions): (...args: A) => void;
-//#endregion
-//#region src/foundations/utilities/merge-props.d.ts
+declare function composeHandlers<A extends readonly unknown[]>(
+  first?: (...args: A) => void,
+  second?: (...args: A) => void,
+  options?: ComposeHandlersOptions
+): (...args: A) => void;
 /**
  * Merge `base` props over `injected` props: non-handler keys in `base` win,
  * and matching event handlers are composed (`injected` runs first).
  */
-declare function mergeProps<TBase extends object, TInjected extends object>(base: TBase, injected: TInjected): TInjected & TBase;
-//#endregion
-//#region src/foundations/utilities/aria.d.ts
+declare function mergeProps<TBase extends object, TInjected extends object>(
+  base: TBase,
+  injected: TInjected
+): TInjected & TBase;
 /**
  * Tiny aria helpers
  */
@@ -86,8 +86,6 @@ declare function ariaExpanded(expanded?: boolean): {
 declare function ariaSelected(selected?: boolean): {
   'aria-selected'?: 'true' | 'false';
 };
-//#endregion
-//#region src/foundations/utilities/use-id.d.ts
 /** Options for {@link formatId}. */
 interface FormatIdOptions {
   /** Defaults to 'askr' */
@@ -117,5 +115,18 @@ interface FormatIdOptions {
  *    This is deterministic and consistent.
  */
 declare function formatId(options: FormatIdOptions): string;
-//#endregion
-export { ariaSelected as a, composeHandlers as c, KeyboardLikeEvent as d, PointerLikeEvent as f, ariaExpanded as i, DefaultPreventable as l, formatId as n, mergeProps as o, PropagationStoppable as p, ariaDisabled as r, ComposeHandlersOptions as s, FormatIdOptions as t, FocusLikeEvent as u };
+export {
+  ariaSelected,
+  composeHandlers,
+  KeyboardLikeEvent,
+  PointerLikeEvent,
+  ariaExpanded,
+  DefaultPreventable,
+  formatId,
+  mergeProps,
+  PropagationStoppable,
+  ariaDisabled,
+  ComposeHandlersOptions,
+  FormatIdOptions,
+  FocusLikeEvent,
+};

package/dist/{verify-hydration-_Q6avFp0.js → verify-hydration-ikaxotf7.js}

@@ -1,23 +1,26 @@
 import { g as getHydrationRenderUrl, m as withHydrationVerificationRender } from "./render-context-B7ohlh6t.js";
-import { t as SSR_RENDER_DATA_ATTR } from "./ssr-DSHd_Q9K.js";
-import { a as renderResolvedToStringSync } from "./ssr-BaC5qHEw.js";
+import { n as getRouteRenderContext, s as currentAuth } from "./resolution-3DskUkjG.js";
+import { t as SSR_RENDER_DATA_ATTR } from "./ssr-EPjwJH5R.js";
+import { t as renderResolvedForHydrationSync } from "./render-resolved-BC0W7_5b.js";
 //#region src/ssr/verify-hydration.ts
+const SSR_STYLE_REGISTRY_SELECTOR = "style[data-askr-style-registry]";
 function normalizeHydrationHtml(html) {
 	const template = document.createElement("template");
 	template.innerHTML = html;
-	for (const script of Array.from(template.content.querySelectorAll(`script[${SSR_RENDER_DATA_ATTR}]`))) script.remove();
+	for (const carrier of Array.from(template.content.querySelectorAll(`script[${SSR_RENDER_DATA_ATTR}],${SSR_STYLE_REGISTRY_SELECTOR}`))) carrier.remove();
 	return template.innerHTML.replace(/<!--[\s\S]*?-->/g, "");
 }
 function verifyHydrationSyncForUrl(opts) {
 	const { root, url, registry, resolved, options } = opts;
 	const verificationUrl = getHydrationRenderUrl(options?.envelope) ?? new URL(url, "http://localhost").pathname;
-	const expected = withHydrationVerificationRender(() => renderResolvedToStringSync({
+	const authContext = getRouteRenderContext(resolved)?.auth ?? currentAuth();
+	const expected = withHydrationVerificationRender(() => renderResolvedForHydrationSync({
 		url: verificationUrl,
 		registry,
 		handler: resolved.handler,
 		params: resolved.params,
 		options
-	}));
+	}, authContext));
 	return normalizeHydrationHtml(root.innerHTML) === normalizeHydrationHtml(expected);
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askrjs/askr",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Lane-scheduled deterministic UI framework",
   "keywords": [
     "askr",
@@ -30,7 +30,8 @@
   ],
   "type": "module",
   "sideEffects": [
-    "./dist/index.js"
+    "./dist/index.js",
+    "./dist/boot/index.js"
   ],
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -139,30 +140,27 @@
     "pack:check": "node tests/package-artifacts.js",
     "check": "npm run release:verify && npm run pack:check",
     "test:unit": "vp test run -c vitest.test.unit.config.ts",
-    "bench": "npm run bench:tier1 && npm run bench:tier2 && npm run bench:tier3 && npm run bench:tier4",
+    "bench": "npm run bench:tier1 && npm run bench:tier2",
     "bench:tier1": "cross-env NODE_ENV=production vp test bench --run --reporter=default --config vitest.bench.tier1.config.ts",
     "bench:tier2": "cross-env NODE_ENV=production vp test bench --run --reporter=default --config vitest.bench.tier2.config.ts",
-    "bench:tier3": "cross-env NODE_ENV=production vp test bench --run --reporter=default --config vitest.bench.tier3.config.ts",
-    "bench:tier4": "cross-env NODE_ENV=production vp test bench --run --reporter=default --config vitest.bench.tier4.config.ts",
     "prepack": "npm run build",
     "prepublishOnly": "npm run check"
   },
   "dependencies": {
-    "@askrjs/auth": ">=0.2.0 <0.3.0",
-    "@askrjs/schema": ">=0.2.0 <0.3.0"
+    "@askrjs/auth": ">=0.3.0 <0.4.0",
+    "@askrjs/schema": ">=0.3.0 <0.4.0"
   },
   "devDependencies": {
-    "@types/node": "^26.2.0",
-    "@typescript/native": "npm:typescript@^7.0.2",
-    "@vitest/browser-playwright": "4.1.10",
+    "@types/node": "^26.4.1",
+    "@typescript/typescript6": "^6.0.2",
+    "@vitest/browser-playwright": "4.1.11",
     "cross-env": "^10.1.0",
     "jsdom": "^30.0.1",
-    "playwright": "^1.62.1",
-    "publint": "^0.3.23",
+    "playwright": "^1.63.0",
+    "publint": "^0.3.24",
     "tsd": "^0.33.0",
-    "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "vite": "^8.2.1",
-    "vite-plus": "^0.2.8"
+    "typescript": "^7.0.2",
+    "vite-plus": "^0.3.1"
   },
   "tsd": {
     "compilerOptions": {