@askrjs/askr 0.0.30 → 0.0.31

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.31",
+	buildLabel: "0.0.31-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/index.d.ts

@@ -18,4 +18,5 @@ import { ResourceResult, resource } from "./runtime/operations.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 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 };

package/dist/index.js

@@ -2,6 +2,7 @@ import { Fragment } from "./common/jsx.js";
 import { defineContext, readContext } from "./runtime/context.js";
 import { getSignal } from "./runtime/component.js";
 import { jsx, jsxs } from "./jsx-runtime.js";
+import { ErrorBoundary } from "./components/error-boundary.js";
 import { installRendererBridge } from "./renderer/index.js";
 import { state } from "./runtime/state.js";
 import { derive } from "./runtime/derive.js";
@@ -29,6 +30,6 @@ import "./foundations/structures.js";
 */
 installRendererBridge();
 //#endregion
-export { Case, DefaultPortal, For, Fragment, Link, Match, Portal, Show, Slot, 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 };
+export { Case, DefaultPortal, ErrorBoundary, For, Fragment, Link, Match, Portal, Show, Slot, 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 };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Askr: Actor-backed deterministic UI framework\n *\n * Public API surface — only users should import from here\n */\n\nimport { installRendererBridge } from './renderer';\n\ninstallRendererBridge();\n\n// Runtime primitives\nexport { state } from './runtime/state';\nexport type { State } from './runtime/state';\nexport { derive } from './runtime/derive';\nexport type { Derived } from './runtime/derive';\nexport { getSignal } from './runtime/component';\nexport { selector } from './runtime/selector';\nexport type { Selector } from './runtime/selector';\n\n// Context\nexport { defineContext, readContext } from './runtime/context';\nexport type { Context } from './runtime/context';\n\n// Resources\nexport { resource } from './runtime/operations';\nexport type { ResourceResult } from './runtime/operations';\n\n// App bootstrap\nexport {\n  createIsland,\n  createIslands,\n  createSPA,\n  hydrateSPA,\n  cleanupApp,\n  hasApp,\n} from './boot';\nexport type {\n  IslandConfig,\n  IslandsConfig,\n  SPAConfig,\n  HydrateSPAConfig,\n} from './boot';\n\n// Routing\nexport {\n  registerRoutes,\n  route,\n  currentRoute,\n  group,\n  fallback,\n  lazy,\n  allow,\n  redirect,\n  deny,\n  unauthorized,\n  forbidden,\n  notFound,\n  requireAuth,\n  requireRole,\n  requirePermission,\n  resolveRouteRequest,\n  type RouteSnapshot,\n  type RouteMatch,\n  type RouteComponent,\n  type RouteMode,\n  type RouteAuthMode,\n  type RouteContext,\n  type RoutePolicy,\n  type RouteOptions,\n  type RouteRecord,\n  type RouteManifest,\n  type AccessDecision,\n  type AccessDenyDecision,\n  type AccessRedirectDecision,\n  type GroupHelperOptions,\n  type RegisterRoutesOptions,\n  type RouteDefinition,\n  type RouteAuthOptions,\n  type RouteAuthResolver,\n  type RouteAuthState,\n  type RouteRenderResult,\n  type RouteRequestOptions,\n  type RouteRequestResult,\n} from './router';\nexport { navigate } from './router/navigate';\nexport type {\n  NavigateOptions,\n  NavigationScrollBehavior,\n  HistoryScrollBehavior,\n  ScrollRestorationOptions,\n} from './router/navigate';\n\n// Components\nexport { Link } from './components/link';\nexport type { LinkProps } from './components/link';\nexport { Case, For, Match, Show } from './control';\nexport type { CaseProps, ForProps, MatchProps, ShowProps } from './control';\nexport {\n  Slot,\n  definePortal,\n  DefaultPortal,\n  Portal,\n} from './foundations/structures';\nexport type { SlotProps, PortalProps } from './foundations/structures';\n\n// Re-export JSX runtime for tsconfig jsxImportSource\nexport { jsx, jsxs, Fragment } from './jsx-runtime';\n\n// Public types\nexport type { Props } from './common/props';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,uBAAuB"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * Askr: Actor-backed deterministic UI framework\n *\n * Public API surface — only users should import from here\n */\n\nimport { installRendererBridge } from './renderer';\n\ninstallRendererBridge();\n\n// Runtime primitives\nexport { state } from './runtime/state';\nexport type { State } from './runtime/state';\nexport { derive } from './runtime/derive';\nexport type { Derived } from './runtime/derive';\nexport { getSignal } from './runtime/component';\nexport { selector } from './runtime/selector';\nexport type { Selector } from './runtime/selector';\n\n// Context\nexport { defineContext, readContext } from './runtime/context';\nexport type { Context } from './runtime/context';\n\n// Resources\nexport { resource } from './runtime/operations';\nexport type { ResourceResult } from './runtime/operations';\n\n// App bootstrap\nexport {\n  createIsland,\n  createIslands,\n  createSPA,\n  hydrateSPA,\n  cleanupApp,\n  hasApp,\n} from './boot';\nexport type {\n  IslandConfig,\n  IslandsConfig,\n  SPAConfig,\n  HydrateSPAConfig,\n} from './boot';\n\n// Routing\nexport {\n  registerRoutes,\n  route,\n  currentRoute,\n  group,\n  fallback,\n  lazy,\n  allow,\n  redirect,\n  deny,\n  unauthorized,\n  forbidden,\n  notFound,\n  requireAuth,\n  requireRole,\n  requirePermission,\n  resolveRouteRequest,\n  type RouteSnapshot,\n  type RouteMatch,\n  type RouteComponent,\n  type RouteMode,\n  type RouteAuthMode,\n  type RouteContext,\n  type RoutePolicy,\n  type RouteOptions,\n  type RouteRecord,\n  type RouteManifest,\n  type AccessDecision,\n  type AccessDenyDecision,\n  type AccessRedirectDecision,\n  type GroupHelperOptions,\n  type RegisterRoutesOptions,\n  type RouteDefinition,\n  type RouteAuthOptions,\n  type RouteAuthResolver,\n  type RouteAuthState,\n  type RouteRenderResult,\n  type RouteRequestOptions,\n  type RouteRequestResult,\n} from './router';\nexport { navigate } from './router/navigate';\nexport type {\n  NavigateOptions,\n  NavigationScrollBehavior,\n  HistoryScrollBehavior,\n  ScrollRestorationOptions,\n} from './router/navigate';\n\n// Components\nexport { Link } from './components/link';\nexport type { LinkProps } from './components/link';\nexport { ErrorBoundary } from './components/error-boundary';\nexport type {\n  ErrorBoundaryProps,\n  ErrorBoundaryFallbackRender,\n} from './components/error-boundary';\nexport { Case, For, Match, Show } from './control';\nexport type { CaseProps, ForProps, MatchProps, ShowProps } from './control';\nexport {\n  Slot,\n  definePortal,\n  DefaultPortal,\n  Portal,\n} from './foundations/structures';\nexport type { SlotProps, PortalProps } from './foundations/structures';\n\n// Re-export JSX runtime for tsconfig jsxImportSource\nexport { jsx, jsxs, Fragment } from './jsx-runtime';\n\n// Public types\nexport type { Props } from './common/props';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,uBAAuB"}

package/dist/renderer/dom.js

@@ -1,4 +1,4 @@
-import { __FOR_BOUNDARY__, _isDOMElement } from "../common/vnode.js";
+import { __ERROR_BOUNDARY__, __FOR_BOUNDARY__, _isDOMElement } from "../common/vnode.js";
 import "./types.js";
 import { getRuntimeEnv } from "../common/env.js";
 import { logger } from "../dev/logger.js";
@@ -21,6 +21,7 @@ import { clearCaseDomUpdateState, clearShowDomUpdateState, evaluateCaseState, ev
 import { reconcileKeyedChildren } from "./reconcile.js";
 import { isBulkTextFastPathEligible, performBulkTextReplace } from "./children.js";
 import { createFineGrainedEffect, markFineGrainedEffectsDirtySource } from "../runtime/effect.js";
+import { createBoundaryReset, reportBoundaryError, resolveErrorBoundaryFallback } from "../components/error-boundary.js";
 //#region src/renderer/dom.ts
 const reactivePropRegistry = /* @__PURE__ */ new Set();
 const controlBoundaryOwners = /* @__PURE__ */ new WeakMap();
@@ -1085,6 +1086,7 @@ function createDOMNode(node, parentNamespace) {
 		if (typeof type === "string") return createIntrinsicElement(node, type, props, parentNamespace);
 		if (typeof type === "function") return createComponentElement(node, type, props, parentNamespace);
 		if (type === __FOR_BOUNDARY__) return createForBoundary(node, props, parentNamespace);
+		if (type === __ERROR_BOUNDARY__) return createErrorBoundaryElement(node, props, parentNamespace);
 		if (typeof type === "symbol" && (type === Fragment || String(type) === "Symbol(Fragment)")) return createFragmentElement(node, props, parentNamespace);
 	}
 	return null;
@@ -1486,6 +1488,26 @@ function createForBoundary(node, props, parentNamespace) {
 	clearControlBoundaryDomUpdateState(controlState);
 	return fragment;
 }
+function createErrorBoundaryElement(node, props, parentNamespace) {
+	const boundaryState = node.__instance?.errorBoundaryState ?? null;
+	const reset = node.__instance ? createBoundaryReset(node.__instance) : () => {};
+	const fallback = props.fallback;
+	const children = props.children;
+	if (boundaryState?.error != null) {
+		const fallbackValue = resolveErrorBoundaryFallback(fallback, boundaryState.error, reset);
+		if (fallbackValue instanceof Node) return fallbackValue;
+		return createDOMNode(fallbackValue, parentNamespace) ?? document.createComment("");
+	}
+	try {
+		return createDOMNode(children, parentNamespace) ?? document.createComment("");
+	} catch (error) {
+		if (node.__instance) reportBoundaryError(node.__instance, error, props.onError);
+		else logger.error("[Askr] ErrorBoundary caught render error:", error);
+		const fallbackValue = resolveErrorBoundaryFallback(fallback, error, reset);
+		if (fallbackValue instanceof Node) return fallbackValue;
+		return createDOMNode(fallbackValue, parentNamespace) ?? document.createComment("");
+	}
+}
 function syncForItemDom(parent, scope, vnode) {
 	let dom = scope.dom ?? null;
 	const parentNamespace = parent.namespaceURI === SVG_NAMESPACE ? SVG_NAMESPACE : void 0;