@vertz/ui 0.2.22 → 0.2.24

package/dist/src/internals.d.ts

@@ -81,6 +81,31 @@ declare function getContextScope(): ContextScope | null;
 */
 declare function setContextScope(scope: ContextScope | null): ContextScope | null;
 /**
+* Compiler-injected: push a new mount frame at component body start.
+* Returns the stack depth AFTER pushing — used by __discardMountFrame
+* to avoid popping a parent frame if __flushMountFrame already popped ours.
+*/
+declare function __pushMountFrame(): number;
+/**
+* Compiler-injected: flush the current mount frame after JSX evaluation.
+* Pops the frame first (so the stack is clean even if a callback throws),
+* then executes all deferred callbacks. All callbacks run even if one throws —
+* the first error is rethrown after all have executed.
+*
+* During hydration (postHydrationQueue is non-null), callbacks are pushed
+* to the queue instead of executing — they run after endHydration() via
+* flushDeferredMounts(). This prevents onMount DOM manipulation from
+* corrupting the hydration cursor.
+*/
+declare function __flushMountFrame(): void;
+/**
+* Compiler-injected: discard the current mount frame in error paths.
+* Only pops if the stack depth still matches `expectedDepth` (the value
+* returned by __pushMountFrame). This prevents popping a parent frame
+* when __flushMountFrame already popped ours (e.g., a callback threw).
+*/
+declare function __discardMountFrame(expectedDepth: number): void;
+/**
 * Shared CSS token lookup tables.
 *
 * This is the single source of truth for all CSS token resolution data.
@@ -117,7 +142,12 @@ declare const KEYWORD_MAP: Record<string, CSSDeclarationEntry[]>;
 declare const DISPLAY_MAP: Record<string, string>;
 /** Spacing scale: number -> rem. 1=0.25rem, 2=0.5rem, 4=1rem, 8=2rem, etc. */
 declare const SPACING_SCALE: Record<string, string>;
-/** Border radius scale — matches Tailwind v4 / shadcn. */
+/**
+* Border radius scale — derived from the `--radius` CSS custom property.
+*
+* All levels (except none/full) are proportional to `--radius` (default 0.375rem).
+* Changing `--radius` on a theme element scales every component's border-radius.
+*/
 declare const RADIUS_SCALE: Record<string, string>;
 /** Shadow scale. */
 declare const SHADOW_SCALE: Record<string, string>;
@@ -295,6 +325,16 @@ declare function onAnimationsComplete(el: Element, callback: () => void): void;
 */
 declare function __attr(el: HTMLElement, name: string, fn: () => string | boolean | Record<string, string | number> | null | undefined): DisposeFn;
 /**
+* Create a reactive DOM property binding.
+* Unlike __attr (which uses setAttribute), this directly assigns to the
+* element's IDL property (e.g., el.value, el.checked). This is required
+* for form-related properties where setAttribute doesn't control the
+* displayed state (e.g., <select>.value, <input>.checked).
+*
+* Uses deferredDomEffect so the first run is skipped during hydration.
+*/
+declare function __prop(el: HTMLElement, name: string, fn: () => unknown): DisposeFn;
+/**
 * Reactive display toggle.
 * When fn() returns false, the element is hidden (display: none).
 * When fn() returns true, the element is shown (display restored).
@@ -408,6 +448,11 @@ declare function __exitChildren(): void;
 * Bind an event handler to an element.
 * Returns a cleanup function to remove the listener.
 *
+* Registers the cleanup with the current disposal scope (if any) so that
+* event listeners are automatically removed when the owning component or
+* dialog is unmounted. Without this, listeners on dynamically-mounted
+* elements (e.g., forms inside useDialogStack dialogs) would leak.
+*
 * Compiler output target for event bindings (onClick, onInput, etc.).
 */
 declare function __on(el: HTMLElement, event: string, handler: EventListener): () => void;
@@ -440,11 +485,23 @@ declare function clearChildren(container: Node): void;
 * @param items - A signal or getter function containing the array of items.
 *   The compiler generates `() => signal.value` as a getter; the runtime
 *   also accepts a raw Signal for direct use in tests.
-* @param keyFn - Extracts a unique key from each item (receives item and index)
+* @param keyFn - Extracts a unique key from each item (receives item and index).
+*   Pass `null` for unkeyed lists — triggers full-replacement mode (safe but slower).
 * @param renderFn - Creates a DOM node for an item (called once per key)
 * @returns A dispose function to stop the reactive list reconciliation
 */
-declare function __list<T>(container: HTMLElement, items: Signal<T[]> | (() => T[]), keyFn: (item: T, index: number) => string | number, renderFn: (item: T) => Node): DisposeFn;
+declare function __list<T>(container: HTMLElement, items: Signal<T[]> | (() => T[]), keyFn: ((item: T, index: number) => string | number) | null, renderFn: (item: T) => Node): DisposeFn;
+/**
+* Apply a spread props object to a DOM element.
+*
+* Compiler output target for JSX spread attributes on intrinsic elements:
+*   <button {...rest} /> → __spread(el, rest)
+*
+* Handles event handlers (on*), ref, style, class/className, htmlFor,
+* SVG attribute normalization, and standard HTML attributes.
+* Uses replace (not merge) semantics — last-wins, matching source order.
+*/
+declare function __spread(el: Element, props: Record<string, unknown>): void;
 declare function styleObjectToString(style: Record<string, string | number | null | undefined>): string;
 /**
 * Returns true when running in a real browser environment.
@@ -590,7 +647,10 @@ interface RouteConfig<
 		signal: AbortSignal;
 	}) => Promise<TLoaderData> | TLoaderData;
 	/** Optional error component rendered when loader throws. */
-	errorComponent?: (error: Error) => Node;
+	errorComponent?: (props: {
+		error: Error;
+		retry: () => void;
+	}) => Node;
 	/** Optional path params schema for validation/parsing. */
 	params?: ParamSchema<TParams>;
 	/** Optional search params schema for validation/coercion. */
@@ -618,7 +678,10 @@ interface CompiledRoute {
 		params: Record<string, string>;
 		signal: AbortSignal;
 	}) => Promise<unknown> | unknown;
-	errorComponent?: RouteConfig["errorComponent"];
+	errorComponent?: (props: {
+		error: Error;
+		retry: () => void;
+	}) => Node;
 	/** Optional path params schema for validation/parsing. */
 	params?: ParamSchema<unknown>;
 	searchParams?: RouteConfig["searchParams"];
@@ -958,6 +1021,7 @@ declare class QueryEnvelopeStore {
 	private _envelopes;
 	get(queryKey: string): QueryEnvelope | undefined;
 	set(queryKey: string, envelope: QueryEnvelope): void;
+	delete(queryKey: string): void;
 	clear(): void;
 }
 /** Entry registered by query() during SSR for renderToHTML() to await. */
@@ -1058,4 +1122,4 @@ declare function getSSRContext(): SSRRenderContext | undefined;
 * clears during HMR module re-evaluation.
 */
 declare function hasSSRResolver(): boolean;
-export { stopSignalCollection, startSignalCollection, setContextScope, setAdapter, runCleanups, resolveComponent, removeNode, registerSSRResolver, pushScope, popScope, onCleanup, onAnimationsComplete, matchRoute, matchPath, lifecycleEffect, isRenderNode, isBrowser, insertBefore, hasSSRResolver, getSSRContext, getContextScope, getAdapter, executeLoaders, domEffect, deserializeProps, deriveKey, createDOMAdapter, compileTheme, clearChildren, _tryOnCleanup, __text, styleObjectToString as __styleStr, __staticText, __show, __on, __list, __insert, __exitChildren, __enterChildren, __element, __conditional, __classList, __child, __attr, __append, SSRRenderContext, SSRQueryEntry, SSRAuth, SPACING_SCALE, SIZE_KEYWORDS, SHADOW_SCALE, RenderText, RenderNode, RenderElement, RenderAdapter, RENDER_NODE_BRAND, RADIUS_SCALE, QueryEnvelopeStore, PropertyMapping, PSEUDO_PREFIXES, PSEUDO_MAP, PROPERTY_MAP, MemoryCache, MatchResult, LINE_HEIGHT_SCALE, KEYWORD_MAP, HEIGHT_AXIS_PROPERTIES, FONT_WEIGHT_SCALE, FONT_SIZE_SCALE, EntityStore, DISPLAY_MAP, CSS_COLOR_KEYWORDS, CSSDeclarationEntry, CONTENT_MAP, COLOR_NAMESPACES, ALIGNMENT_MAP };
+export { stopSignalCollection, startSignalCollection, setContextScope, setAdapter, runCleanups, resolveComponent, removeNode, registerSSRResolver, pushScope, popScope, onCleanup, onAnimationsComplete, matchRoute, matchPath, lifecycleEffect, isRenderNode, isBrowser, insertBefore, hasSSRResolver, getSSRContext, getContextScope, getAdapter, executeLoaders, domEffect, deserializeProps, deriveKey, createDOMAdapter, compileTheme, clearChildren, _tryOnCleanup, __text, styleObjectToString as __styleStr, __staticText, __spread, __show, __pushMountFrame, __prop, __on, __list, __insert, __flushMountFrame, __exitChildren, __enterChildren, __element, __discardMountFrame, __conditional, __classList, __child, __attr, __append, SSRRenderContext, SSRQueryEntry, SSRAuth, SPACING_SCALE, SIZE_KEYWORDS, SHADOW_SCALE, RenderText, RenderNode, RenderElement, RenderAdapter, RENDER_NODE_BRAND, RADIUS_SCALE, QueryEnvelopeStore, PropertyMapping, PSEUDO_PREFIXES, PSEUDO_MAP, PROPERTY_MAP, MemoryCache, MatchResult, LINE_HEIGHT_SCALE, KEYWORD_MAP, HEIGHT_AXIS_PROPERTIES, FONT_WEIGHT_SCALE, FONT_SIZE_SCALE, EntityStore, DISPLAY_MAP, CSS_COLOR_KEYWORDS, CSSDeclarationEntry, CONTENT_MAP, COLOR_NAMESPACES, ALIGNMENT_MAP };

package/dist/src/internals.js

@@ -2,16 +2,13 @@ import {
   deserializeProps,
   onAnimationsComplete,
   resolveComponent
-} from "../shared/chunk-pdqr78k9.js";
+} from "../shared/chunk-18frwfc4.js";
 import {
-  __attr,
-  __classList,
+  __discardMountFrame,
+  __flushMountFrame,
   __on,
-  __show
-} from "../shared/chunk-kjwp5q5s.js";
-import {
-  styleObjectToString
-} from "../shared/chunk-4xkw6h1s.js";
+  __pushMountFrame
+} from "../shared/chunk-ge2e6y2s.js";
 import {
   executeLoaders,
   matchPath,
@@ -22,7 +19,7 @@ import {
   MemoryCache,
   QueryEnvelopeStore,
   deriveKey
-} from "../shared/chunk-szk0hyjg.js";
+} from "../shared/chunk-4gen306a.js";
 import"../shared/chunk-jrtrk5z4.js";
 import {
   ALIGNMENT_MAP,
@@ -43,28 +40,37 @@ import {
   SIZE_KEYWORDS,
   SPACING_SCALE,
   compileTheme
-} from "../shared/chunk-pq8khh47.js";
+} from "../shared/chunk-t3rnfxc0.js";
 import {
   __append,
+  __attr,
   __child,
+  __classList,
   __element,
   __enterChildren,
   __exitChildren,
   __insert,
+  __prop,
+  __show,
   __staticText,
   __text
-} from "../shared/chunk-vwz86vg9.js";
-import"../shared/chunk-prj7nm08.js";
+} from "../shared/chunk-mbnda3pv.js";
+import {
+  SVG_NS,
+  normalizeSVGAttr,
+  styleObjectToString
+} from "../shared/chunk-h1fsr8kv.js";
 import {
   RENDER_NODE_BRAND,
   createDOMAdapter,
   getAdapter,
   isRenderNode,
   setAdapter
-} from "../shared/chunk-c61572xp.js";
+} from "../shared/chunk-2y9f9j62.js";
+import"../shared/chunk-2eh4p2n7.js";
 import {
   isBrowser
-} from "../shared/chunk-bybgyjye.js";
+} from "../shared/chunk-da2w7j7w.js";
 import {
   _tryOnCleanup,
   claimComment,
@@ -84,7 +90,7 @@ import {
   signal,
   startSignalCollection,
   stopSignalCollection
-} from "../shared/chunk-2qe6aqhb.js";
+} from "../shared/chunk-656n0x6y.js";
 // src/dom/conditional.ts
 function normalizeNode(branchResult) {
   if (branchResult == null || typeof branchResult === "boolean") {
@@ -108,9 +114,14 @@ function __conditional(condFn, trueFn, falseFn) {
   return csrConditional(condFn, trueFn, falseFn);
 }
 function hydrateConditional(condFn, trueFn, falseFn) {
-  const anchor = claimComment() ?? getAdapter().createComment("conditional");
+  const claimed = claimComment();
+  if (!claimed) {
+    return csrConditional(condFn, trueFn, falseFn);
+  }
+  const anchor = claimed;
   let currentNode = null;
   let branchCleanups = [];
+  let resultNode = anchor;
   const outerScope = pushScope();
   let isFirstRun = true;
   domEffect(() => {
@@ -121,13 +132,29 @@ function hydrateConditional(condFn, trueFn, falseFn) {
       const branchResult2 = show ? trueFn() : falseFn();
       popScope();
       branchCleanups = scope2;
+      let contentNode = null;
       if (branchResult2 == null || typeof branchResult2 === "boolean") {
-        currentNode = getAdapter().createComment("empty");
+        contentNode = null;
       } else if (isRenderNode(branchResult2)) {
-        currentNode = branchResult2;
+        contentNode = branchResult2;
       } else {
-        const claimed = claimText();
-        currentNode = claimed ?? getAdapter().createTextNode(String(branchResult2));
+        const claimed2 = claimText();
+        contentNode = claimed2 ?? getAdapter().createTextNode(String(branchResult2));
+      }
+      const anchorParent = anchor.parentNode;
+      if (anchorParent) {
+        const wrap = getAdapter().createElement("span");
+        wrap.style.display = "contents";
+        anchorParent.insertBefore(wrap, anchor);
+        wrap.appendChild(anchor);
+        if (contentNode?.parentNode && contentNode.parentNode !== wrap) {
+          wrap.appendChild(contentNode);
+        }
+        currentNode = wrap;
+        resultNode = wrap;
+      } else {
+        currentNode = contentNode ?? getAdapter().createComment("empty");
+        resultNode = currentNode;
       }
       return;
     }
@@ -145,13 +172,13 @@ function hydrateConditional(condFn, trueFn, falseFn) {
     currentNode = newNode;
   });
   popScope();
-  const wrapper = () => {
+  const disposeFn = () => {
     runCleanups(branchCleanups);
     runCleanups(outerScope);
   };
-  _tryOnCleanup(wrapper);
-  const result = Object.assign(anchor, {
-    dispose: wrapper
+  _tryOnCleanup(disposeFn);
+  const result = Object.assign(resultNode, {
+    dispose: disposeFn
   });
   return result;
 }
@@ -202,11 +229,13 @@ function clearChildren(container) {
   }
 }
 // src/dom/list.ts
+var unkeyedListWarned = false;
 function createItemProxy(itemSignal) {
-  if (typeof itemSignal.peek() !== "object" || itemSignal.peek() == null) {
-    return itemSignal.peek();
+  const initial = itemSignal.peek();
+  if (typeof initial !== "object" || initial == null) {
+    return initial;
   }
-  return new Proxy({}, {
+  return new Proxy(initial, {
     get(_target, prop, receiver) {
       const current = itemSignal.value;
       if (current == null)
@@ -217,6 +246,9 @@ function createItemProxy(itemSignal) {
       }
       return value;
     },
+    set() {
+      return false;
+    },
     has(_target, prop) {
       const current = itemSignal.value;
       if (current == null)
@@ -234,6 +266,12 @@ function createItemProxy(itemSignal) {
       if (current == null)
         return;
       return Reflect.getOwnPropertyDescriptor(current, prop);
+    },
+    getPrototypeOf() {
+      const current = itemSignal.value;
+      if (current == null)
+        return null;
+      return Object.getPrototypeOf(current);
     }
   });
 }
@@ -242,7 +280,12 @@ function __list(container, items, keyFn, renderFn) {
   const nodeMap = new Map;
   const scopeMap = new Map;
   const itemSignalMap = new Map;
+  if (!keyFn && !unkeyedListWarned) {
+    unkeyedListWarned = true;
+    console.warn("[vertz] .map() without a key prop uses full-replacement mode (slower). " + "Add a key prop to list items for efficient updates: " + "{items.map(item => <Item key={item.id} />)}");
+  }
   const isHydrationRun = getIsHydrating();
+  let startOffset = isHydrationRun ? -1 : container.childNodes.length;
   const outerScope = pushScope();
   let isFirstRun = true;
   domEffect(() => {
@@ -250,19 +293,47 @@ function __list(container, items, keyFn, renderFn) {
     if (isFirstRun && isHydrationRun) {
       isFirstRun = false;
       for (const [i, item] of newItems.entries()) {
-        const key = keyFn(item, i);
-        const itemSig = signal(item);
-        const proxy = createItemProxy(itemSig);
+        const key = keyFn ? keyFn(item, i) : i;
         const scope = pushScope();
-        const node = renderFn(proxy);
+        if (keyFn) {
+          const itemSig = signal(item);
+          const proxy = createItemProxy(itemSig);
+          const node = renderFn(proxy);
+          itemSignalMap.set(key, itemSig);
+          nodeMap.set(key, node);
+        } else {
+          const node = renderFn(item);
+          nodeMap.set(key, node);
+        }
         popScope();
-        nodeMap.set(key, node);
         scopeMap.set(key, scope);
-        itemSignalMap.set(key, itemSig);
       }
+      startOffset = container.childNodes.length - nodeMap.size;
       return;
     }
     isFirstRun = false;
+    if (!keyFn) {
+      for (const scope of scopeMap.values()) {
+        runCleanups(scope);
+      }
+      scopeMap.clear();
+      for (const node of nodeMap.values()) {
+        node.parentNode?.removeChild(node);
+      }
+      nodeMap.clear();
+      itemSignalMap.clear();
+      for (const item of newItems) {
+        const scope = pushScope();
+        const node = renderFn(item);
+        popScope();
+        container.appendChild(node);
+        const internalKey = nodeMap.size;
+        nodeMap.set(internalKey, node);
+        scopeMap.set(internalKey, scope);
+      }
+      fixUpSelectValue(container);
+      return;
+    }
     const newKeySet = new Set(newItems.map((item, i) => keyFn(item, i)));
     for (const [key, node] of nodeMap) {
       if (!newKeySet.has(key)) {
@@ -298,11 +369,12 @@ function __list(container, items, keyFn, renderFn) {
       desiredNodes.push(node);
     }
     for (const [i, desiredNode] of desiredNodes.entries()) {
-      const currentChild = container.childNodes[i];
+      const currentChild = container.childNodes[startOffset + i];
       if (currentChild !== desiredNode) {
         container.insertBefore(desiredNode, currentChild ?? null);
       }
     }
+    fixUpSelectValue(container);
   });
   popScope();
   const wrapper = () => {
@@ -315,6 +387,56 @@ function __list(container, items, keyFn, renderFn) {
   _tryOnCleanup(wrapper);
   return wrapper;
 }
+function fixUpSelectValue(container) {
+  if (container.tagName === "SELECT") {
+    const selected = container.querySelector("option[selected]");
+    if (selected) {
+      Reflect.set(container, "value", selected.value);
+    }
+  }
+}
+// src/dom/spread.ts
+var SKIP_KEYS = new Set(["children", "key"]);
+var PROP_ALIASES = {
+  className: "class",
+  htmlFor: "for"
+};
+function __spread(el, props) {
+  const isSvg = el.namespaceURI === SVG_NS;
+  for (const key of Object.keys(props)) {
+    if (SKIP_KEYS.has(key))
+      continue;
+    const value = props[key];
+    if (key === "ref") {
+      if (value && typeof value === "object" && "current" in value) {
+        value.current = el;
+      }
+      continue;
+    }
+    if (key.length > 2 && key.startsWith("on") && typeof value === "function") {
+      const eventName = key.slice(2).toLowerCase();
+      el.addEventListener(eventName, value);
+      continue;
+    }
+    if (value == null || value === false)
+      continue;
+    const attrName = PROP_ALIASES[key] ?? key;
+    if (attrName === "style") {
+      if (typeof value === "object") {
+        el.setAttribute("style", styleObjectToString(value));
+      } else {
+        el.setAttribute("style", String(value));
+      }
+      continue;
+    }
+    if (value === true) {
+      el.setAttribute(attrName, "");
+      continue;
+    }
+    const finalName = isSvg ? normalizeSVGAttr(attrName) : attrName;
+    el.setAttribute(finalName, String(value));
+  }
+}
 export {
   stopSignalCollection,
   startSignalCollection,
@@ -349,13 +471,18 @@ export {
   __text,
   styleObjectToString as __styleStr,
   __staticText,
+  __spread,
   __show,
+  __pushMountFrame,
+  __prop,
   __on,
   __list,
   __insert,
+  __flushMountFrame,
   __exitChildren,
   __enterChildren,
   __element,
+  __discardMountFrame,
   __conditional,
   __classList,
   __child,

package/dist/src/jsx-runtime/index.js

@@ -1,11 +1,9 @@
-import {
-  styleObjectToString
-} from "../../shared/chunk-4xkw6h1s.js";
 import {
   SVG_NS,
   isSVGTag,
-  normalizeSVGAttr
-} from "../../shared/chunk-prj7nm08.js";
+  normalizeSVGAttr,
+  styleObjectToString
+} from "../../shared/chunk-h1fsr8kv.js";
 
 // src/jsx-runtime/index.ts
 function applyChildren(parent, children) {

package/dist/src/query/public.d.ts

@@ -37,8 +37,6 @@ interface QueryOptions<T> {
 	initialData?: T;
 	/** Debounce re-fetches triggered by reactive dependency changes (ms). */
 	debounce?: number;
-	/** When false, the query will not fetch. Defaults to true. */
-	enabled?: boolean;
 	/** Explicit cache key. When omitted, derived from the thunk. */
 	key?: string;
 	/** Custom cache store. Defaults to a shared in-memory Map. */
@@ -72,6 +70,8 @@ interface QueryResult<
 	readonly revalidating: Unwrapped<ReadonlySignal<boolean>>;
 	/** The error from the latest failed fetch, or undefined. */
 	readonly error: Unwrapped<ReadonlySignal<E | undefined>>;
+	/** True when the query has never fetched (thunk returned null or not yet run). */
+	readonly idle: Unwrapped<ReadonlySignal<boolean>>;
 	/** Manually trigger a refetch (clears cache for this key). */
 	refetch: () => void;
 	/** Alias for refetch — revalidate the cached data. */
@@ -93,7 +93,11 @@ declare function query<
 	T,
 	E
 >(descriptor: QueryDescriptor<T, E>, options?: Omit<QueryOptions<T>, "key">): QueryResult<T, E>;
-declare function query<T>(thunk: () => Promise<T>, options?: QueryOptions<T>): QueryResult<T>;
+declare function query<
+	T,
+	E
+>(thunk: () => QueryDescriptor<T, E> | null, options?: Omit<QueryOptions<T>, "key">): QueryResult<T, E>;
+declare function query<T>(thunk: () => Promise<T> | null, options?: QueryOptions<T>): QueryResult<T>;
 interface QueryMatchHandlers<
 	T,
 	E

package/dist/src/query/public.js

@@ -1,11 +1,12 @@
 import {
   query,
   queryMatch
-} from "../../shared/chunk-szk0hyjg.js";
+} from "../../shared/chunk-4gen306a.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-c61572xp.js";
-import"../../shared/chunk-bybgyjye.js";
-import"../../shared/chunk-2qe6aqhb.js";
+import"../../shared/chunk-2y9f9j62.js";
+import"../../shared/chunk-2eh4p2n7.js";
+import"../../shared/chunk-da2w7j7w.js";
+import"../../shared/chunk-656n0x6y.js";
 
 // src/query/public.ts
 import { isQueryDescriptor } from "@vertz/fetch";

package/dist/src/router/public.d.ts

@@ -93,7 +93,10 @@ interface RouteConfig<
 		signal: AbortSignal;
 	}) => Promise<TLoaderData> | TLoaderData;
 	/** Optional error component rendered when loader throws. */
-	errorComponent?: (error: Error) => Node;
+	errorComponent?: (props: {
+		error: Error;
+		retry: () => void;
+	}) => Node;
 	/** Optional path params schema for validation/parsing. */
 	params?: ParamSchema<TParams>;
 	/** Optional search params schema for validation/coercion. */
@@ -131,7 +134,10 @@ interface RouteConfigLike {
 		params: Record<string, string>;
 		signal: AbortSignal;
 	}): unknown;
-	errorComponent?: (error: Error) => Node;
+	errorComponent?: (props: {
+		error: Error;
+		retry: () => void;
+	}) => Node;
 	params?: ParamSchema<unknown>;
 	searchParams?: SearchParamSchema<unknown>;
 	children?: Record<string, RouteConfigLike>;
@@ -165,7 +171,10 @@ interface CompiledRoute {
 		params: Record<string, string>;
 		signal: AbortSignal;
 	}) => Promise<unknown> | unknown;
-	errorComponent?: RouteConfig["errorComponent"];
+	errorComponent?: (props: {
+		error: Error;
+		retry: () => void;
+	}) => Node;
 	/** Optional path params schema for validation/parsing. */
 	params?: ParamSchema<unknown>;
 	searchParams?: RouteConfig["searchParams"];
@@ -449,9 +458,23 @@ declare function useRouter<T extends Record<string, RouteConfigLike> = RouteDefi
 */
 declare function useParams<TPath extends string = string>(): ExtractParams<TPath>;
 declare function useParams<T extends Record<string, unknown>>(): T;
+/** Props for error fallback components (shared by DefaultErrorFallback and route errorComponent). */
+interface ErrorFallbackProps {
+	error: Error;
+	retry: () => void;
+}
+/** Error fallback component signature, reuses ErrorFallbackProps from DefaultErrorFallback. */
+type ErrorFallbackFn = (props: ErrorFallbackProps) => Node;
 interface RouterViewProps {
 	router: Router;
+	/** Rendered when no route matches (404). */
 	fallback?: () => Node;
+	/**
+	* Global error fallback for all routes. When set, every route component is
+	* automatically wrapped in an ErrorBoundary using this fallback.
+	* Per-route `errorComponent` takes precedence over this.
+	*/
+	errorFallback?: ErrorFallbackFn;
 }
 /**
 * Renders the matched route's component inside a container div.
@@ -464,7 +487,7 @@ interface RouterViewProps {
 * domEffect runs the component factory (to attach reactivity/event handlers)
 * but skips clearing the container.
 */
-declare function RouterView({ router, fallback }: RouterViewProps): HTMLElement;
+declare function RouterView({ router, fallback, errorFallback }: RouterViewProps): HTMLElement;
 /**
 * Parse URLSearchParams into a typed object, optionally through a schema.
 *

package/dist/src/router/public.js

@@ -6,26 +6,25 @@ import {
   createLink,
   parseSearchParams,
   useSearchParams
-} from "../../shared/chunk-67z8b0q8.js";
-import"../../shared/chunk-kjwp5q5s.js";
-import"../../shared/chunk-4xkw6h1s.js";
+} from "../../shared/chunk-2wag9c7v.js";
+import"../../shared/chunk-ge2e6y2s.js";
 import {
   createRouter
-} from "../../shared/chunk-7g722pdh.js";
+} from "../../shared/chunk-jtma4sh4.js";
 import {
   defineRoutes
 } from "../../shared/chunk-am9zaw4h.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-vwz86vg9.js";
-import"../../shared/chunk-prj7nm08.js";
-import"../../shared/chunk-c61572xp.js";
+import"../../shared/chunk-mbnda3pv.js";
+import"../../shared/chunk-h1fsr8kv.js";
+import"../../shared/chunk-2y9f9j62.js";
 import {
   RouterContext,
   useParams,
   useRouter
-} from "../../shared/chunk-4cmt1ve8.js";
-import"../../shared/chunk-bybgyjye.js";
-import"../../shared/chunk-2qe6aqhb.js";
+} from "../../shared/chunk-f4d5nphq.js";
+import"../../shared/chunk-da2w7j7w.js";
+import"../../shared/chunk-656n0x6y.js";
 export {
   useSearchParams,
   useRouter,