@askrjs/askr 0.0.30 → 0.0.33

package/README.md

@@ -23,8 +23,8 @@ createIsland({ root: document.body, component: Counter });
 ### Runtime
 
 `@askrjs/askr` exports the core runtime primitives: `state()`, `derive()`,
-`selector()`, `resource()`, routing helpers, JSX control-flow helpers, and SSR/SSG
-entrypoints.
+`selector()`, `resource()`, `ErrorBoundary`, routing helpers, JSX control-flow
+helpers, and SSR/SSG entrypoints.
 
 ### Explicit reactivity
 
@@ -69,7 +69,25 @@ function Data({ id }: { id: string }) {
 
   if (data.pending) return <div>Loading...</div>;
   if (data.error) return <div>Failed to load</div>;
-  return <div>{data.value.name}</div>;
+return <div>{data.value.name}</div>;
+}
+```
+
+### Developer error boundaries
+
+`ErrorBoundary` is the opt-in boundary primitive for render-time failures. It
+renders a visible fallback in development, still logs the underlying error, and
+can reset when your app state changes.
+
+```ts
+import { ErrorBoundary } from '@askrjs/askr';
+
+function App() {
+  return (
+    <ErrorBoundary fallback={<div>Something went wrong</div>}>
+      <FlakyView />
+    </ErrorBoundary>
+  );
 }
 ```
 

package/dist/benchmark.js

@@ -10,8 +10,8 @@ import { BenchmarkTable } from "./bench/components/benchmark-table.js";
 installRendererBridge();
 const benchmarkMetadata = {
 	packageName: "@askrjs/askr",
-	packageVersion: "0.0.30",
-	buildLabel: "0.0.30-local"
+	packageVersion: "0.0.33",
+	buildLabel: "0.0.33-local"
 };
 function getBenchmarkMetadata() {
 	return { ...benchmarkMetadata };

package/dist/common/vnode.d.ts

@@ -2,6 +2,7 @@ import { Props } from "./props.js";
 import { ForState } from "../runtime/for.js";
 import { ControlBoundaryState } from "../runtime/control.js";
 //#region src/common/vnode.d.ts
+declare const __ERROR_BOUNDARY__: unique symbol;
 interface DOMElement {
   type: string | ((props: Props) => any) | symbol;
   props?: Props;

package/dist/common/vnode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vnode.d.ts","names":[],"sources":["../../src/common/vnode.ts"],"mappings":";;;;UAUiB,UAAA;EAKf,IAAA,aAAiB,KAAA,EAAO,KAAA;EACxB,KAAA,GAAQ,KAAA;EACR,QAAA,GAAW,KAAA;EACX,GAAA;EAAA,CACC,MAAA,CAAO,QAAA;EACR,aAAA,GAAgB,oBAAA;EAChB,SAAA,GAAY,QAAA;AAAA;AAAA,KAIF,KAAA,GAAQ,UAAA;AAAA,cAIP,gBAAA;AAAA,iBAEG,aAAA,CAAc,IAAA,YAAgB,IAAA,IAAQ,UAAA"}
+{"version":3,"file":"vnode.d.ts","names":[],"sources":["../../src/common/vnode.ts"],"mappings":";;;;cAUa,kBAAA;AAAA,UAEI,UAAA;EAKf,IAAA,aAAiB,KAAA,EAAO,KAAA;EACxB,KAAA,GAAQ,KAAA;EACR,QAAA,GAAW,KAAA;EACX,GAAA;EAAA,CACC,MAAA,CAAO,QAAA;EACR,aAAA,GAAgB,oBAAA;EAChB,SAAA,GAAY,QAAA;AAAA;AAAA,KAIF,KAAA,GAAQ,UAAA;AAAA,cAIP,gBAAA;AAAA,iBAEG,aAAA,CAAc,IAAA,YAAgB,IAAA,IAAQ,UAAA"}

package/dist/common/vnode.js

@@ -1,10 +1,11 @@
 import { __CONTROL_BOUNDARY__ } from "./control.js";
 //#region src/common/vnode.ts
+const __ERROR_BOUNDARY__ = Symbol.for("askr.error-boundary");
 const __FOR_BOUNDARY__ = __CONTROL_BOUNDARY__;
 function _isDOMElement(node) {
 	return typeof node === "object" && node !== null && "type" in node;
 }
 //#endregion
-export { __FOR_BOUNDARY__, _isDOMElement };
+export { __ERROR_BOUNDARY__, __FOR_BOUNDARY__, _isDOMElement };
 
 //# sourceMappingURL=vnode.js.map

package/dist/common/vnode.js.map

@@ -1 +1 @@
-{"version":3,"file":"vnode.js","names":[],"sources":["../../src/common/vnode.ts"],"sourcesContent":["/**\n * Common call contracts: VNode / virtual DOM shapes\n */\n\nimport type { Props } from './props';\nimport type { ControlBoundaryState } from '../runtime/control';\nimport type { ForState } from '../runtime/for';\nexport { __CONTROL_BOUNDARY__ } from './control';\nimport { __CONTROL_BOUNDARY__ } from './control';\n\nexport interface DOMElement {\n  // Element `type` can be an intrinsic tag name, a component function, or\n  // a special symbol (e.g. `Fragment`). Include `symbol` in the type union\n  // so runtime comparisons against `Fragment` are type-safe.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  type: string | ((props: Props) => any) | symbol;\n  props?: Props;\n  children?: VNode[];\n  key?: string | number | null;\n  [Symbol.iterator]?: never;\n  _controlState?: ControlBoundaryState; // Internal: control boundary state\n  _forState?: ForState<unknown>; // Deprecated internal alias during migration\n}\n\n// Type for virtual DOM nodes\nexport type VNode = DOMElement | string | number | boolean | null | undefined;\n\n// Backward-compatible internal alias while renderer/runtime migrates away from\n// the old For-only boundary naming.\nexport const __FOR_BOUNDARY__ = __CONTROL_BOUNDARY__;\n\nexport function _isDOMElement(node: unknown): node is DOMElement {\n  return typeof node === 'object' && node !== null && 'type' in node;\n}\n"],"mappings":";;AA6BA,MAAa,mBAAmB;AAEhC,SAAgB,cAAc,MAAmC;AAC/D,QAAO,OAAO,SAAS,YAAY,SAAS,QAAQ,UAAU"}
+{"version":3,"file":"vnode.js","names":[],"sources":["../../src/common/vnode.ts"],"sourcesContent":["/**\n * Common call contracts: VNode / virtual DOM shapes\n */\n\nimport type { Props } from './props';\nimport type { ControlBoundaryState } from '../runtime/control';\nimport type { ForState } from '../runtime/for';\nexport { __CONTROL_BOUNDARY__ } from './control';\nimport { __CONTROL_BOUNDARY__ } from './control';\n\nexport const __ERROR_BOUNDARY__ = Symbol.for('askr.error-boundary');\n\nexport interface DOMElement {\n  // Element `type` can be an intrinsic tag name, a component function, or\n  // a special symbol (e.g. `Fragment`). Include `symbol` in the type union\n  // so runtime comparisons against `Fragment` are type-safe.\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  type: string | ((props: Props) => any) | symbol;\n  props?: Props;\n  children?: VNode[];\n  key?: string | number | null;\n  [Symbol.iterator]?: never;\n  _controlState?: ControlBoundaryState; // Internal: control boundary state\n  _forState?: ForState<unknown>; // Deprecated internal alias during migration\n}\n\n// Type for virtual DOM nodes\nexport type VNode = DOMElement | string | number | boolean | null | undefined;\n\n// Backward-compatible internal alias while renderer/runtime migrates away from\n// the old For-only boundary naming.\nexport const __FOR_BOUNDARY__ = __CONTROL_BOUNDARY__;\n\nexport function _isDOMElement(node: unknown): node is DOMElement {\n  return typeof node === 'object' && node !== null && 'type' in node;\n}\n"],"mappings":";;AAUA,MAAa,qBAAqB,OAAO,IAAI,sBAAsB;AAqBnE,MAAa,mBAAmB;AAEhC,SAAgB,cAAc,MAAmC;AAC/D,QAAO,OAAO,SAAS,YAAY,SAAS,QAAQ,UAAU"}

package/dist/components/error-boundary.d.ts

@@ -0,0 +1,25 @@
+import { Props } from "../common/props.js";
+import { JSXElement } from "../common/jsx.js";
+import { ComponentInstance } from "../runtime/component.js";
+
+//#region src/components/error-boundary.d.ts
+type ErrorBoundaryFallbackRender = (error: unknown, reset: () => void) => unknown;
+interface ErrorBoundaryProps extends Props {
+  children?: unknown;
+  fallback?: unknown | ErrorBoundaryFallbackRender;
+  onError?: (error: unknown) => void;
+  resetKey?: unknown;
+}
+type ErrorBoundaryState = NonNullable<ComponentInstance['errorBoundaryState']>;
+type ErrorBoundaryVNode = JSXElement & {
+  __instance?: ComponentInstance;
+};
+declare function ErrorBoundary(props: ErrorBoundaryProps): JSXElement;
+declare function isErrorBoundaryVNode(value: unknown): value is ErrorBoundaryVNode;
+declare function resolveErrorBoundaryState(vnode: ErrorBoundaryVNode): ErrorBoundaryState | null;
+declare function resolveErrorBoundaryFallback(fallback: ErrorBoundaryProps['fallback'], error: unknown, reset: () => void): unknown;
+declare function createBoundaryReset(instance: ComponentInstance): () => void;
+declare function reportBoundaryError(instance: ComponentInstance, error: unknown, onError?: (error: unknown) => void): void;
+//#endregion
+export { ErrorBoundary, ErrorBoundaryFallbackRender, ErrorBoundaryProps };
+//# sourceMappingURL=error-boundary.d.ts.map

package/dist/components/error-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.d.ts","names":[],"sources":["../../src/components/error-boundary.tsx"],"mappings":";;;;;KAUY,2BAAA,IACV,KAAA,WACA,KAAA;AAAA,UAGe,kBAAA,SAA2B,KAAA;EAC1C,QAAA;EACA,QAAA,aAAqB,2BAAA;EACrB,OAAA,IAAW,KAAA;EACX,QAAA;AAAA;AAAA,KAGG,kBAAA,GAAqB,WAAA,CAAY,iBAAA;AAAA,KAEjC,kBAAA,GAAqB,UAAA;EACxB,UAAA,GAAa,iBAAA;AAAA;AAAA,iBA+DC,aAAA,CAAc,KAAA,EAAO,kBAAA,GAAqB,UAAA;AAAA,iBAY1C,oBAAA,CACd,KAAA,YACC,KAAA,IAAS,kBAAA;AAAA,iBAQI,yBAAA,CACd,KAAA,EAAO,kBAAA,GACN,kBAAA;AAAA,iBAIa,4BAAA,CACd,QAAA,EAAU,kBAAA,cACV,KAAA,WACA,KAAA;AAAA,iBAoDc,mBAAA,CAAoB,QAAA,EAAU,iBAAA;AAAA,iBAc9B,mBAAA,CACd,QAAA,EAAU,iBAAA,EACV,KAAA,WACA,OAAA,IAAW,KAAA"}

package/dist/components/error-boundary.js

@@ -0,0 +1,114 @@
+import { __ERROR_BOUNDARY__ } from "../common/vnode.js";
+import { isDevelopmentEnvironment } from "../common/env.js";
+import { logger } from "../dev/logger.js";
+import { ELEMENT_TYPE } from "../common/jsx.js";
+import { getCurrentComponentInstance } from "../runtime/component.js";
+//#region src/components/error-boundary.tsx
+function getBoundaryMessage(error) {
+	if (error instanceof Error) return error.message || error.name || "Unknown error";
+	if (typeof error === "string") return error;
+	try {
+		return JSON.stringify(error);
+	} catch {
+		return String(error);
+	}
+}
+function ensureBoundaryState(instance, resetKey) {
+	const boundaryState = instance.errorBoundaryState ?? (instance.errorBoundaryState = {
+		error: null,
+		resetKey,
+		notified: false
+	});
+	if (!Object.is(boundaryState.resetKey, resetKey)) {
+		boundaryState.error = null;
+		boundaryState.resetKey = resetKey;
+		boundaryState.notified = false;
+	}
+	return boundaryState;
+}
+function createBoundaryVNode(instance, props) {
+	const key = typeof props.key === "symbol" ? null : props.key ?? null;
+	return {
+		$$typeof: ELEMENT_TYPE,
+		type: __ERROR_BOUNDARY__,
+		props: {
+			children: props.children,
+			fallback: props.fallback,
+			onError: props.onError,
+			resetKey: props.resetKey
+		},
+		key,
+		__instance: instance
+	};
+}
+function ErrorBoundary(props) {
+	const instance = getCurrentComponentInstance();
+	if (!instance) throw new Error("[Askr] ErrorBoundary() can only be used during component render execution.");
+	ensureBoundaryState(instance, props.resetKey);
+	return createBoundaryVNode(instance, props);
+}
+function resolveErrorBoundaryFallback(fallback, error, reset) {
+	if (typeof fallback === "function") return fallback(error, reset);
+	if (fallback !== void 0) return fallback;
+	const message = getBoundaryMessage(error);
+	const wrapper = document.createElement("div");
+	wrapper.setAttribute("role", "alert");
+	wrapper.setAttribute("data-askr-error-boundary", "true");
+	wrapper.style.boxSizing = "border-box";
+	wrapper.style.padding = "1rem";
+	wrapper.style.border = "1px solid currentColor";
+	wrapper.style.borderRadius = "0.75rem";
+	wrapper.style.display = "grid";
+	wrapper.style.gap = "0.75rem";
+	wrapper.style.maxWidth = "100%";
+	const title = document.createElement("strong");
+	title.textContent = "Something went wrong while rendering this view.";
+	const summary = document.createElement("p");
+	summary.textContent = "The app recovered into a visible fallback so the error is not hidden in the console.";
+	summary.style.margin = "0";
+	const details = document.createElement("details");
+	details.open = isDevelopmentEnvironment();
+	const detailsSummary = document.createElement("summary");
+	detailsSummary.textContent = "Error details";
+	const pre = document.createElement("pre");
+	pre.textContent = message;
+	pre.style.margin = "0";
+	pre.style.whiteSpace = "pre-wrap";
+	pre.style.wordBreak = "break-word";
+	const button = document.createElement("button");
+	button.type = "button";
+	button.textContent = "Try again";
+	button.addEventListener("click", () => reset());
+	details.append(detailsSummary, pre);
+	wrapper.append(title, summary, details, button);
+	return wrapper;
+}
+function createBoundaryReset(instance) {
+	return () => {
+		const boundaryState = instance.errorBoundaryState;
+		if (!boundaryState) return;
+		boundaryState.error = null;
+		boundaryState.notified = false;
+		queueMicrotask(() => {
+			instance._enqueueRun?.();
+		});
+	};
+}
+function reportBoundaryError(instance, error, onError) {
+	const boundaryState = instance.errorBoundaryState;
+	if (boundaryState && Object.is(boundaryState.error, error) && boundaryState.notified) return;
+	if (boundaryState) {
+		boundaryState.error = error;
+		boundaryState.notified = true;
+	}
+	try {
+		onError?.(error);
+	} catch (hookError) {
+		logger.error("[Askr] ErrorBoundary onError handler threw:", hookError);
+	}
+	logger.error("[Askr] ErrorBoundary caught render error:", error);
+}
+//#endregion
+export { ErrorBoundary, createBoundaryReset, reportBoundaryError, resolveErrorBoundaryFallback };
+
+//# sourceMappingURL=error-boundary.js.map

package/dist/components/error-boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-boundary.js","names":[],"sources":["../../src/components/error-boundary.tsx"],"sourcesContent":["import type { Props } from '../common/props';\nimport { ELEMENT_TYPE, type JSXElement } from '../common/jsx';\nimport { __ERROR_BOUNDARY__ } from '../common/vnode';\nimport {\n  getCurrentComponentInstance,\n  type ComponentInstance,\n} from '../runtime/component';\nimport { logger } from '../dev/logger';\nimport { isDevelopmentEnvironment } from '../common/env';\n\nexport type ErrorBoundaryFallbackRender = (\n  error: unknown,\n  reset: () => void\n) => unknown;\n\nexport interface ErrorBoundaryProps extends Props {\n  children?: unknown;\n  fallback?: unknown | ErrorBoundaryFallbackRender;\n  onError?: (error: unknown) => void;\n  resetKey?: unknown;\n}\n\ntype ErrorBoundaryState = NonNullable<ComponentInstance['errorBoundaryState']>;\n\ntype ErrorBoundaryVNode = JSXElement & {\n  __instance?: ComponentInstance;\n};\n\nfunction getBoundaryMessage(error: unknown): string {\n  if (error instanceof Error) {\n    return error.message || error.name || 'Unknown error';\n  }\n\n  if (typeof error === 'string') {\n    return error;\n  }\n\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return String(error);\n  }\n}\n\nfunction ensureBoundaryState(\n  instance: ComponentInstance,\n  resetKey: unknown\n): ErrorBoundaryState {\n  const boundaryState =\n    instance.errorBoundaryState ??\n    (instance.errorBoundaryState = {\n      error: null,\n      resetKey,\n      notified: false,\n    });\n\n  if (!Object.is(boundaryState.resetKey, resetKey)) {\n    boundaryState.error = null;\n    boundaryState.resetKey = resetKey;\n    boundaryState.notified = false;\n  }\n\n  return boundaryState;\n}\n\nfunction createBoundaryVNode(\n  instance: ComponentInstance,\n  props: ErrorBoundaryProps\n): ErrorBoundaryVNode {\n  const key =\n    typeof props.key === 'symbol'\n      ? null\n      : ((props.key ?? null) as string | number | null);\n\n  return {\n    $$typeof: ELEMENT_TYPE,\n    type: __ERROR_BOUNDARY__,\n    props: {\n      children: props.children,\n      fallback: props.fallback,\n      onError: props.onError,\n      resetKey: props.resetKey,\n    },\n    key,\n    __instance: instance,\n  };\n}\n\nexport function ErrorBoundary(props: ErrorBoundaryProps): JSXElement {\n  const instance = getCurrentComponentInstance();\n  if (!instance) {\n    throw new Error(\n      '[Askr] ErrorBoundary() can only be used during component render execution.'\n    );\n  }\n\n  ensureBoundaryState(instance, props.resetKey);\n  return createBoundaryVNode(instance, props);\n}\n\nexport function isErrorBoundaryVNode(\n  value: unknown\n): value is ErrorBoundaryVNode {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    (value as ErrorBoundaryVNode).type === __ERROR_BOUNDARY__\n  );\n}\n\nexport function resolveErrorBoundaryState(\n  vnode: ErrorBoundaryVNode\n): ErrorBoundaryState | null {\n  return vnode.__instance?.errorBoundaryState ?? null;\n}\n\nexport function resolveErrorBoundaryFallback(\n  fallback: ErrorBoundaryProps['fallback'],\n  error: unknown,\n  reset: () => void\n): unknown {\n  if (typeof fallback === 'function') {\n    return fallback(error, reset);\n  }\n\n  if (fallback !== undefined) {\n    return fallback;\n  }\n\n  const message = getBoundaryMessage(error);\n  const wrapper = document.createElement('div');\n  wrapper.setAttribute('role', 'alert');\n  wrapper.setAttribute('data-askr-error-boundary', 'true');\n  wrapper.style.boxSizing = 'border-box';\n  wrapper.style.padding = '1rem';\n  wrapper.style.border = '1px solid currentColor';\n  wrapper.style.borderRadius = '0.75rem';\n  wrapper.style.display = 'grid';\n  wrapper.style.gap = '0.75rem';\n  wrapper.style.maxWidth = '100%';\n\n  const title = document.createElement('strong');\n  title.textContent = 'Something went wrong while rendering this view.';\n\n  const summary = document.createElement('p');\n  summary.textContent =\n    'The app recovered into a visible fallback so the error is not hidden in the console.';\n  summary.style.margin = '0';\n\n  const details = document.createElement('details');\n  details.open = isDevelopmentEnvironment();\n\n  const detailsSummary = document.createElement('summary');\n  detailsSummary.textContent = 'Error details';\n\n  const pre = document.createElement('pre');\n  pre.textContent = message;\n  pre.style.margin = '0';\n  pre.style.whiteSpace = 'pre-wrap';\n  pre.style.wordBreak = 'break-word';\n\n  const button = document.createElement('button');\n  button.type = 'button';\n  button.textContent = 'Try again';\n  button.addEventListener('click', () => reset());\n\n  details.append(detailsSummary, pre);\n  wrapper.append(title, summary, details, button);\n  return wrapper;\n}\n\nexport function createBoundaryReset(instance: ComponentInstance): () => void {\n  return () => {\n    const boundaryState = instance.errorBoundaryState;\n    if (!boundaryState) {\n      return;\n    }\n    boundaryState.error = null;\n    boundaryState.notified = false;\n    queueMicrotask(() => {\n      instance._enqueueRun?.();\n    });\n  };\n}\n\nexport function reportBoundaryError(\n  instance: ComponentInstance,\n  error: unknown,\n  onError?: (error: unknown) => void\n): void {\n  const boundaryState = instance.errorBoundaryState;\n  if (\n    boundaryState &&\n    Object.is(boundaryState.error, error) &&\n    boundaryState.notified\n  ) {\n    return;\n  }\n\n  if (boundaryState) {\n    boundaryState.error = error;\n    boundaryState.notified = true;\n  }\n\n  try {\n    onError?.(error);\n  } catch (hookError) {\n    logger.error('[Askr] ErrorBoundary onError handler threw:', hookError);\n  }\n\n  logger.error('[Askr] ErrorBoundary caught render error:', error);\n}\n"],"mappings":"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"}

package/dist/data/index.d.ts

@@ -0,0 +1,43 @@
+//#region src/data/index.d.ts
+type QueryConsistency = 'fresh' | 'stale' | 'refreshing' | 'pending-write';
+type Query<T> = {
+  data: T | null;
+  error: unknown | null;
+  loading: boolean;
+  refreshing: boolean;
+  stale: boolean;
+  consistency: QueryConsistency;
+  refresh(): Promise<void>;
+};
+type Mutation<TInput, TResult> = {
+  status: 'idle' | 'pending' | 'success' | 'error';
+  pending: boolean;
+  error: unknown | null;
+  result: TResult | null;
+  execute(input: TInput): Promise<TResult>;
+  abort(): void;
+  reset(): void;
+};
+type QueryOptions<T> = {
+  key: string;
+  fetch: (ctx: {
+    signal: AbortSignal;
+  }) => Promise<T>;
+  isConsistent?: (data: T) => boolean;
+  reconcile?: (data: T, ctx: {
+    key: string;
+  }) => Promise<boolean> | boolean;
+};
+type MutationOptions<TInput, TResult> = {
+  action: (input: TInput, ctx: {
+    signal: AbortSignal;
+  }) => Promise<TResult>;
+  affects?: (input: TInput, result: TResult) => string[];
+  afterSuccess?: 'invalidate';
+};
+declare function createQuery<T>(options: QueryOptions<T>): Query<T>;
+declare function invalidate(prefix: string): void;
+declare function createMutation<TInput, TResult>(options: MutationOptions<TInput, TResult>): Mutation<TInput, TResult>;
+//#endregion
+export { Mutation, Query, QueryConsistency, createMutation, createQuery, invalidate };
+//# sourceMappingURL=index.d.ts.map

package/dist/data/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/data/index.ts"],"mappings":";KASY,gBAAA;AAAA,KAMA,KAAA;EACV,IAAA,EAAM,CAAA;EACN,KAAA;EACA,OAAA;EACA,UAAA;EACA,KAAA;EACA,WAAA,EAAa,gBAAA;EAEb,OAAA,IAAW,OAAA;AAAA;AAAA,KAGD,QAAA;EACV,MAAA;EACA,OAAA;EACA,KAAA;EACA,MAAA,EAAQ,OAAA;EAER,OAAA,CAAQ,KAAA,EAAO,MAAA,GAAS,OAAA,CAAQ,OAAA;EAChC,KAAA;EACA,KAAA;AAAA;AAAA,KAGG,YAAA;EACH,GAAA;EACA,KAAA,GAAQ,GAAA;IAAO,MAAA,EAAQ,WAAA;EAAA,MAAkB,OAAA,CAAQ,CAAA;EACjD,YAAA,IAAgB,IAAA,EAAM,CAAA;EACtB,SAAA,IAAa,IAAA,EAAM,CAAA,EAAG,GAAA;IAAO,GAAA;EAAA,MAAkB,OAAA;AAAA;AAAA,KAG5C,eAAA;EACH,MAAA,GAAS,KAAA,EAAO,MAAA,EAAQ,GAAA;IAAO,MAAA,EAAQ,WAAA;EAAA,MAAkB,OAAA,CAAQ,OAAA;EACjE,OAAA,IAAW,KAAA,EAAO,MAAA,EAAQ,MAAA,EAAQ,OAAA;EAClC,YAAA;AAAA;AAAA,iBA6Wc,WAAA,GAAA,CAAe,OAAA,EAAS,YAAA,CAAa,CAAA,IAAK,KAAA,CAAM,CAAA;AAAA,iBAahD,UAAA,CAAW,MAAA;AAAA,iBAIX,cAAA,iBAAA,CACd,OAAA,EAAS,eAAA,CAAgB,MAAA,EAAQ,OAAA,IAChC,QAAA,CAAS,MAAA,EAAQ,OAAA"}

package/dist/data/index.js

@@ -0,0 +1,293 @@
+import { globalScheduler } from "../runtime/scheduler.js";
+import { markReactivePropsDirtySource, markReadableDerivedSubscribersDirty, notifyReadableReaders, recordReadableRead } from "../runtime/readable.js";
+//#region src/data/index.ts
+function createReadableSource() {
+	return (() => void 0);
+}
+function notifySource(source) {
+	markReadableDerivedSubscribersDirty(source);
+	markReactivePropsDirtySource(source);
+	notifyReadableReaders(source);
+}
+function isAbortError(error, signal) {
+	return signal.aborted || error instanceof Error && error.name === "AbortError" || typeof DOMException !== "undefined" && error instanceof DOMException && error.name === "AbortError";
+}
+const queryCache = /* @__PURE__ */ new Map();
+function invalidateQueries(prefix, markPendingWrite) {
+	for (const [key, query] of queryCache) {
+		if (!key.startsWith(prefix)) continue;
+		if (markPendingWrite) query.markPendingWrite();
+		query.refresh();
+	}
+}
+var QueryCell = class {
+	constructor(options) {
+		this.source = createReadableSource();
+		this.controller = null;
+		this.generation = 0;
+		this.startQueued = false;
+		this.pendingRefresh = null;
+		this.reconcileAttemptCount = 0;
+		this.state = {
+			data: null,
+			error: null,
+			loading: true,
+			refreshing: false,
+			stale: false,
+			consistency: "fresh"
+		};
+		this.options = options;
+	}
+	setOptions(options) {
+		this.options = options;
+	}
+	get data() {
+		recordReadableRead(this.source);
+		return this.state.data;
+	}
+	get error() {
+		recordReadableRead(this.source);
+		return this.state.error;
+	}
+	get loading() {
+		recordReadableRead(this.source);
+		return this.state.loading;
+	}
+	get refreshing() {
+		recordReadableRead(this.source);
+		return this.state.refreshing;
+	}
+	get stale() {
+		recordReadableRead(this.source);
+		return this.state.stale;
+	}
+	get consistency() {
+		recordReadableRead(this.source);
+		return this.state.consistency;
+	}
+	ensureStarted() {
+		if (this.state.data !== null || this.pendingRefresh || this.startQueued) return;
+		this.queueStart("initial");
+	}
+	refresh() {
+		if (this.pendingRefresh) return this.pendingRefresh;
+		this.queueStart("manual");
+		return this.pendingRefresh ?? Promise.resolve();
+	}
+	markPendingWrite() {
+		this.setState({
+			refreshing: true,
+			stale: true,
+			consistency: "pending-write"
+		});
+	}
+	queueStart(reason) {
+		this.startQueued = true;
+		this.pendingRefresh = new Promise((resolve) => {
+			globalScheduler.enqueue(() => {
+				this.startQueued = false;
+				this.start(reason).finally(() => {
+					this.pendingRefresh = null;
+					resolve();
+				});
+			});
+		});
+	}
+	setState(next) {
+		this.state = {
+			...this.state,
+			...next
+		};
+		notifySource(this.source);
+	}
+	async start(reason) {
+		this.generation += 1;
+		const generation = this.generation;
+		this.controller?.abort();
+		const controller = new AbortController();
+		this.controller = controller;
+		const hasData = this.state.data !== null;
+		this.setState({
+			loading: !hasData,
+			refreshing: hasData,
+			stale: hasData,
+			consistency: reason === "pending-write" ? "pending-write" : hasData ? "refreshing" : "fresh",
+			error: null
+		});
+		let nextData;
+		try {
+			nextData = await this.options.fetch({ signal: controller.signal });
+		} catch (error) {
+			if (this.generation !== generation || this.controller !== controller) return;
+			if (isAbortError(error, controller.signal)) {
+				this.setState({
+					loading: false,
+					refreshing: false
+				});
+				return;
+			}
+			this.setState({
+				loading: false,
+				refreshing: false,
+				stale: true,
+				consistency: "stale",
+				error
+			});
+			return;
+		}
+		if (this.generation !== generation || this.controller !== controller) return;
+		if (!(this.options.isConsistent?.(nextData) ?? true)) {
+			this.setState({
+				data: nextData,
+				loading: false,
+				refreshing: false,
+				stale: true,
+				consistency: "stale"
+			});
+			await this.reconcile(nextData);
+			return;
+		}
+		this.reconcileAttemptCount = 0;
+		this.setState({
+			data: nextData,
+			loading: false,
+			refreshing: false,
+			stale: false,
+			consistency: "fresh",
+			error: null
+		});
+	}
+	async reconcile(data) {
+		if (!(this.options.reconcile?.(data, { key: this.options.key }) ?? false)) return;
+		this.reconcileAttemptCount += 1;
+		if (this.reconcileAttemptCount > 3) {
+			this.setState({
+				consistency: "stale",
+				refreshing: false
+			});
+			return;
+		}
+		await new Promise((resolve) => setTimeout(resolve, 25));
+		if (this.state.consistency === "fresh") return;
+		await this.refresh();
+	}
+};
+var MutationCell = class {
+	constructor(options) {
+		this.source = createReadableSource();
+		this.controller = null;
+		this.generation = 0;
+		this.state = {
+			status: "idle",
+			error: null,
+			result: null
+		};
+		this.action = options.action;
+		this.affects = options.affects;
+		this.afterSuccess = options.afterSuccess;
+	}
+	get status() {
+		recordReadableRead(this.source);
+		return this.state.status;
+	}
+	get pending() {
+		recordReadableRead(this.source);
+		return this.state.status === "pending";
+	}
+	get error() {
+		recordReadableRead(this.source);
+		return this.state.error;
+	}
+	get result() {
+		recordReadableRead(this.source);
+		return this.state.result;
+	}
+	setState(next) {
+		this.state = {
+			...this.state,
+			...next
+		};
+		notifySource(this.source);
+	}
+	async execute(input) {
+		this.generation += 1;
+		const generation = this.generation;
+		this.controller?.abort();
+		const controller = new AbortController();
+		this.controller = controller;
+		this.setState({
+			status: "pending",
+			error: null,
+			result: null
+		});
+		let result;
+		try {
+			result = await this.action(input, { signal: controller.signal });
+		} catch (error) {
+			if (this.generation !== generation || this.controller !== controller) throw error;
+			if (isAbortError(error, controller.signal)) {
+				this.setState({
+					status: "idle",
+					error: null
+				});
+				throw error;
+			}
+			this.setState({
+				status: "error",
+				error
+			});
+			throw error;
+		}
+		if (this.generation !== generation || this.controller !== controller) return result;
+		this.setState({
+			status: "success",
+			error: null,
+			result
+		});
+		if (this.afterSuccess === "invalidate") {
+			const prefixes = this.affects?.(input, result) ?? [];
+			for (const prefix of new Set(prefixes)) invalidateQueries(prefix, true);
+		}
+		return result;
+	}
+	abort() {
+		this.generation += 1;
+		this.controller?.abort();
+		this.controller = null;
+		this.setState({
+			status: "idle",
+			error: null
+		});
+	}
+	reset() {
+		this.generation += 1;
+		this.controller?.abort();
+		this.controller = null;
+		this.setState({
+			status: "idle",
+			error: null,
+			result: null
+		});
+	}
+};
+function createQuery(options) {
+	const existing = queryCache.get(options.key);
+	if (existing) {
+		existing.setOptions(options);
+		return existing;
+	}
+	const created = new QueryCell(options);
+	queryCache.set(options.key, created);
+	created.ensureStarted();
+	return created;
+}
+function invalidate(prefix) {
+	invalidateQueries(prefix, false);
+}
+function createMutation(options) {
+	return new MutationCell(options);
+}
+//#endregion
+export { createMutation, createQuery, invalidate };
+
+//# sourceMappingURL=index.js.map

package/dist/data/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/data/index.ts"],"sourcesContent":["import { globalScheduler } from '../runtime/scheduler';\nimport {\n  markReadableDerivedSubscribersDirty,\n  markReactivePropsDirtySource,\n  notifyReadableReaders,\n  recordReadableRead,\n  type ReadableSource,\n} from '../runtime/readable';\n\nexport type QueryConsistency =\n  | 'fresh'\n  | 'stale'\n  | 'refreshing'\n  | 'pending-write';\n\nexport type Query<T> = {\n  data: T | null;\n  error: unknown | null;\n  loading: boolean;\n  refreshing: boolean;\n  stale: boolean;\n  consistency: QueryConsistency;\n\n  refresh(): Promise<void>;\n};\n\nexport type Mutation<TInput, TResult> = {\n  status: 'idle' | 'pending' | 'success' | 'error';\n  pending: boolean;\n  error: unknown | null;\n  result: TResult | null;\n\n  execute(input: TInput): Promise<TResult>;\n  abort(): void;\n  reset(): void;\n};\n\ntype QueryOptions<T> = {\n  key: string;\n  fetch: (ctx: { signal: AbortSignal }) => Promise<T>;\n  isConsistent?: (data: T) => boolean;\n  reconcile?: (data: T, ctx: { key: string }) => Promise<boolean> | boolean;\n};\n\ntype MutationOptions<TInput, TResult> = {\n  action: (input: TInput, ctx: { signal: AbortSignal }) => Promise<TResult>;\n  affects?: (input: TInput, result: TResult) => string[];\n  afterSuccess?: 'invalidate';\n};\n\ntype QueryState<T> = {\n  data: T | null;\n  error: unknown | null;\n  loading: boolean;\n  refreshing: boolean;\n  stale: boolean;\n  consistency: QueryConsistency;\n};\n\ntype MutationState<TResult> = {\n  status: 'idle' | 'pending' | 'success' | 'error';\n  error: unknown | null;\n  result: TResult | null;\n};\n\nfunction createReadableSource(): ReadableSource<unknown> {\n  return (() => undefined) as ReadableSource<unknown>;\n}\n\nfunction notifySource(source: ReadableSource<unknown>): void {\n  markReadableDerivedSubscribersDirty(source);\n  markReactivePropsDirtySource(source);\n  notifyReadableReaders(source);\n}\n\nfunction isAbortError(error: unknown, signal: AbortSignal): boolean {\n  return (\n    signal.aborted ||\n    (error instanceof Error && error.name === 'AbortError') ||\n    (typeof DOMException !== 'undefined' &&\n      error instanceof DOMException &&\n      error.name === 'AbortError')\n  );\n}\n\nconst queryCache = new Map<string, QueryCell<unknown>>();\n\nfunction invalidateQueries(prefix: string, markPendingWrite: boolean): void {\n  for (const [key, query] of queryCache) {\n    if (!key.startsWith(prefix)) {\n      continue;\n    }\n\n    if (markPendingWrite) {\n      query.markPendingWrite();\n    }\n\n    void query.refresh();\n  }\n}\n\nclass QueryCell<T> implements Query<T> {\n  private readonly source = createReadableSource();\n  private options: QueryOptions<T>;\n  private controller: AbortController | null = null;\n  private generation = 0;\n  private startQueued = false;\n  private pendingRefresh: Promise<void> | null = null;\n  private reconcileAttemptCount = 0;\n\n  private state: QueryState<T> = {\n    data: null,\n    error: null,\n    loading: true,\n    refreshing: false,\n    stale: false,\n    consistency: 'fresh',\n  };\n\n  constructor(options: QueryOptions<T>) {\n    this.options = options;\n  }\n\n  setOptions(options: QueryOptions<T>): void {\n    this.options = options;\n  }\n\n  get data(): T | null {\n    recordReadableRead(this.source);\n    return this.state.data;\n  }\n\n  get error(): unknown | null {\n    recordReadableRead(this.source);\n    return this.state.error;\n  }\n\n  get loading(): boolean {\n    recordReadableRead(this.source);\n    return this.state.loading;\n  }\n\n  get refreshing(): boolean {\n    recordReadableRead(this.source);\n    return this.state.refreshing;\n  }\n\n  get stale(): boolean {\n    recordReadableRead(this.source);\n    return this.state.stale;\n  }\n\n  get consistency(): QueryConsistency {\n    recordReadableRead(this.source);\n    return this.state.consistency;\n  }\n\n  ensureStarted(): void {\n    if (this.state.data !== null || this.pendingRefresh || this.startQueued) {\n      return;\n    }\n\n    this.queueStart('initial');\n  }\n\n  refresh(): Promise<void> {\n    if (this.pendingRefresh) {\n      return this.pendingRefresh;\n    }\n\n    this.queueStart('manual');\n    return this.pendingRefresh ?? Promise.resolve();\n  }\n\n  markPendingWrite(): void {\n    this.setState({\n      refreshing: true,\n      stale: true,\n      consistency: 'pending-write',\n    });\n  }\n\n  private queueStart(\n    reason: 'initial' | 'manual' | 'invalidate' | 'pending-write'\n  ): void {\n    this.startQueued = true;\n    this.pendingRefresh = new Promise<void>((resolve) => {\n      globalScheduler.enqueue(() => {\n        this.startQueued = false;\n        void this.start(reason).finally(() => {\n          this.pendingRefresh = null;\n          resolve();\n        });\n      });\n    });\n  }\n\n  private setState(next: Partial<QueryState<T>>): void {\n    this.state = {\n      ...this.state,\n      ...next,\n    };\n    notifySource(this.source);\n  }\n\n  private async start(\n    reason: 'initial' | 'manual' | 'invalidate' | 'pending-write'\n  ): Promise<void> {\n    this.generation += 1;\n    const generation = this.generation;\n\n    this.controller?.abort();\n    const controller = new AbortController();\n    this.controller = controller;\n\n    const hasData = this.state.data !== null;\n    this.setState({\n      loading: !hasData,\n      refreshing: hasData,\n      stale: hasData,\n      consistency:\n        reason === 'pending-write'\n          ? 'pending-write'\n          : hasData\n            ? 'refreshing'\n            : 'fresh',\n      error: null,\n    });\n\n    let nextData: T;\n    try {\n      nextData = await this.options.fetch({ signal: controller.signal });\n    } catch (error) {\n      if (this.generation !== generation || this.controller !== controller) {\n        return;\n      }\n\n      if (isAbortError(error, controller.signal)) {\n        this.setState({ loading: false, refreshing: false });\n        return;\n      }\n\n      this.setState({\n        loading: false,\n        refreshing: false,\n        stale: true,\n        consistency: 'stale',\n        error,\n      });\n      return;\n    }\n\n    if (this.generation !== generation || this.controller !== controller) {\n      return;\n    }\n\n    const isConsistent = this.options.isConsistent?.(nextData) ?? true;\n    if (!isConsistent) {\n      this.setState({\n        data: nextData,\n        loading: false,\n        refreshing: false,\n        stale: true,\n        consistency: 'stale',\n      });\n      await this.reconcile(nextData);\n      return;\n    }\n\n    this.reconcileAttemptCount = 0;\n    this.setState({\n      data: nextData,\n      loading: false,\n      refreshing: false,\n      stale: false,\n      consistency: 'fresh',\n      error: null,\n    });\n  }\n\n  private async reconcile(data: T): Promise<void> {\n    const shouldRetry =\n      this.options.reconcile?.(data, { key: this.options.key }) ?? false;\n\n    if (!shouldRetry) {\n      return;\n    }\n\n    this.reconcileAttemptCount += 1;\n    if (this.reconcileAttemptCount > 3) {\n      this.setState({ consistency: 'stale', refreshing: false });\n      return;\n    }\n\n    await new Promise<void>((resolve) => setTimeout(resolve, 25));\n    if (this.state.consistency === 'fresh') {\n      return;\n    }\n\n    await this.refresh();\n  }\n}\n\nclass MutationCell<TInput, TResult> implements Mutation<TInput, TResult> {\n  private readonly source = createReadableSource();\n  private readonly action: MutationOptions<TInput, TResult>['action'];\n  private readonly affects?: MutationOptions<TInput, TResult>['affects'];\n  private readonly afterSuccess?: MutationOptions<\n    TInput,\n    TResult\n  >['afterSuccess'];\n  private controller: AbortController | null = null;\n  private generation = 0;\n\n  private state: MutationState<TResult> = {\n    status: 'idle',\n    error: null,\n    result: null,\n  };\n\n  constructor(options: MutationOptions<TInput, TResult>) {\n    this.action = options.action;\n    this.affects = options.affects;\n    this.afterSuccess = options.afterSuccess;\n  }\n\n  get status(): 'idle' | 'pending' | 'success' | 'error' {\n    recordReadableRead(this.source);\n    return this.state.status;\n  }\n\n  get pending(): boolean {\n    recordReadableRead(this.source);\n    return this.state.status === 'pending';\n  }\n\n  get error(): unknown | null {\n    recordReadableRead(this.source);\n    return this.state.error;\n  }\n\n  get result(): TResult | null {\n    recordReadableRead(this.source);\n    return this.state.result;\n  }\n\n  private setState(next: Partial<MutationState<TResult>>): void {\n    this.state = {\n      ...this.state,\n      ...next,\n    };\n    notifySource(this.source);\n  }\n\n  async execute(input: TInput): Promise<TResult> {\n    this.generation += 1;\n    const generation = this.generation;\n\n    this.controller?.abort();\n    const controller = new AbortController();\n    this.controller = controller;\n\n    this.setState({ status: 'pending', error: null, result: null });\n\n    let result: TResult;\n    try {\n      result = await this.action(input, { signal: controller.signal });\n    } catch (error) {\n      if (this.generation !== generation || this.controller !== controller) {\n        throw error;\n      }\n\n      if (isAbortError(error, controller.signal)) {\n        this.setState({ status: 'idle', error: null });\n        throw error;\n      }\n\n      this.setState({ status: 'error', error });\n      throw error;\n    }\n\n    if (this.generation !== generation || this.controller !== controller) {\n      return result;\n    }\n\n    this.setState({ status: 'success', error: null, result });\n\n    if (this.afterSuccess === 'invalidate') {\n      const prefixes = this.affects?.(input, result) ?? [];\n      for (const prefix of new Set(prefixes)) {\n        invalidateQueries(prefix, true);\n      }\n    }\n\n    return result;\n  }\n\n  abort(): void {\n    this.generation += 1;\n    this.controller?.abort();\n    this.controller = null;\n    this.setState({ status: 'idle', error: null });\n  }\n\n  reset(): void {\n    this.generation += 1;\n    this.controller?.abort();\n    this.controller = null;\n    this.setState({ status: 'idle', error: null, result: null });\n  }\n}\n\nexport function createQuery<T>(options: QueryOptions<T>): Query<T> {\n  const existing = queryCache.get(options.key) as QueryCell<T> | undefined;\n  if (existing) {\n    existing.setOptions(options);\n    return existing;\n  }\n\n  const created = new QueryCell(options);\n  queryCache.set(options.key, created as QueryCell<unknown>);\n  created.ensureStarted();\n  return created;\n}\n\nexport function invalidate(prefix: string): void {\n  invalidateQueries(prefix, false);\n}\n\nexport function createMutation<TInput, TResult>(\n  options: MutationOptions<TInput, TResult>\n): Mutation<TInput, TResult> {\n  return new MutationCell(options);\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -15,7 +15,9 @@ import { DefaultPortal, Portal, PortalProps, definePortal } from "./foundations/
 import { Derived, derive } from "./runtime/derive.js";
 import { Selector, selector } from "./runtime/selector.js";
 import { ResourceResult, resource } from "./runtime/operations.js";
+import { Mutation, Query, QueryConsistency, createMutation, createQuery, invalidate } from "./data/index.js";
 import { currentRoute, fallback, group, lazy, registerRoutes, resolveRouteRequest, route } from "./router/route.js";
 import { allow, deny, forbidden, notFound, redirect, requireAuth, requirePermission, requireRole, unauthorized } from "./router/policy.js";
 import { Link, LinkProps } from "./components/link.js";
-export { type AccessDecision, type AccessDenyDecision, type AccessRedirectDecision, Case, type CaseProps, type Context, DefaultPortal, type Derived, For, type ForProps, Fragment, type GroupHelperOptions, type HistoryScrollBehavior, type HydrateSPAConfig, type IslandConfig, type IslandsConfig, Link, type LinkProps, Match, type MatchProps, type NavigateOptions, type NavigationScrollBehavior, Portal, type PortalProps, type Props, type RegisterRoutesOptions, type ResourceResult, type RouteAuthMode, type RouteAuthOptions, type RouteAuthResolver, type RouteAuthState, type RouteComponent, type RouteContext, type RouteDefinition, type RouteManifest, type RouteMatch, type RouteMode, type RouteOptions, type RoutePolicy, type RouteRecord, type RouteRenderResult, type RouteRequestOptions, type RouteRequestResult, type RouteSnapshot, type SPAConfig, type ScrollRestorationOptions, type Selector, Show, type ShowProps, Slot, type SlotProps, type State, allow, cleanupApp, createIsland, createIslands, createSPA, currentRoute, defineContext, definePortal, deny, derive, fallback, forbidden, getSignal, group, hasApp, hydrateSPA, jsx, jsxs, lazy, navigate, notFound, readContext, redirect, registerRoutes, requireAuth, requirePermission, requireRole, resolveRouteRequest, resource, route, selector, state, unauthorized };
+import { ErrorBoundary, ErrorBoundaryFallbackRender, ErrorBoundaryProps } from "./components/error-boundary.js";
+export { type AccessDecision, type AccessDenyDecision, type AccessRedirectDecision, Case, type CaseProps, type Context, DefaultPortal, type Derived, ErrorBoundary, type ErrorBoundaryFallbackRender, type ErrorBoundaryProps, For, type ForProps, Fragment, type GroupHelperOptions, type HistoryScrollBehavior, type HydrateSPAConfig, type IslandConfig, type IslandsConfig, Link, type LinkProps, Match, type MatchProps, type Mutation, type NavigateOptions, type NavigationScrollBehavior, Portal, type PortalProps, type Props, type Query, type QueryConsistency, type RegisterRoutesOptions, type ResourceResult, type RouteAuthMode, type RouteAuthOptions, type RouteAuthResolver, type RouteAuthState, type RouteComponent, type RouteContext, type RouteDefinition, type RouteManifest, type RouteMatch, type RouteMode, type RouteOptions, type RoutePolicy, type RouteRecord, type RouteRenderResult, type RouteRequestOptions, type RouteRequestResult, type RouteSnapshot, type SPAConfig, type ScrollRestorationOptions, type Selector, Show, type ShowProps, Slot, type SlotProps, type State, allow, cleanupApp, createIsland, createIslands, createMutation, createQuery, createSPA, currentRoute, defineContext, definePortal, deny, derive, fallback, forbidden, getSignal, group, hasApp, hydrateSPA, invalidate, jsx, jsxs, lazy, navigate, notFound, readContext, redirect, registerRoutes, requireAuth, requirePermission, requireRole, resolveRouteRequest, resource, route, selector, state, unauthorized };