@vertz/ui 0.2.22 → 0.2.24

package/dist/src/components/index.js

@@ -13,32 +13,38 @@ function createComponentProxy(name) {
     return fn(...args);
   };
 }
-function createSuiteProxy(name, subComponents) {
-  const suite = {};
+function createCompoundProxy(name, subComponents) {
+  const root = (...args) => {
+    const fn = _getPrimitive(name);
+    if (typeof fn !== "function") {
+      throw new Error(`Primitive "${name}" is not callable in the registered theme. ` + `Check that your theme package provides this component.`);
+    }
+    return fn(...args);
+  };
   for (const sub of subComponents) {
-    Object.defineProperty(suite, sub, {
+    Object.defineProperty(root, sub, {
       get: () => {
-        const parent = _getComponent(name);
+        const parent = _getPrimitive(name);
         return Reflect.get(parent, sub);
       },
       enumerable: true,
       configurable: true
     });
   }
-  return suite;
+  return root;
 }
-function createCompoundProxy(name, subComponents) {
+function createCallableSuiteProxy(name, subComponents) {
   const root = (...args) => {
-    const fn = _getPrimitive(name);
+    const fn = _getComponent(name);
     if (typeof fn !== "function") {
-      throw new Error(`Primitive "${name}" is not callable in the registered theme. ` + `Check that your theme package provides this component.`);
+      throw new Error(`Component "${name}" is not callable in the registered theme. ` + `Check that your theme package provides this component.`);
     }
     return fn(...args);
   };
   for (const sub of subComponents) {
     Object.defineProperty(root, sub, {
       get: () => {
-        const parent = _getPrimitive(name);
+        const parent = _getComponent(name);
         return Reflect.get(parent, sub);
       },
       enumerable: true,
@@ -47,6 +53,20 @@ function createCompoundProxy(name, subComponents) {
   }
   return root;
 }
+function createPrimitiveSuiteProxy(name, subComponents) {
+  const suite = {};
+  for (const sub of subComponents) {
+    Object.defineProperty(suite, sub, {
+      get: () => {
+        const parent = _getPrimitive(name);
+        return Reflect.get(parent, sub);
+      },
+      enumerable: true,
+      configurable: true
+    });
+  }
+  return suite;
+}
 function createPrimitiveProxy(name) {
   return (...args) => {
     const fn = _getPrimitive(name);
@@ -62,49 +82,34 @@ var Input = /* @__PURE__ */ createComponentProxy("Input");
 var Textarea = /* @__PURE__ */ createComponentProxy("Textarea");
 var Label = /* @__PURE__ */ createComponentProxy("Label");
 var Separator = /* @__PURE__ */ createComponentProxy("Separator");
-var Breadcrumb = /* @__PURE__ */ createComponentProxy("Breadcrumb");
+var Breadcrumb = /* @__PURE__ */ createCallableSuiteProxy("Breadcrumb", ["Item"]);
 var Pagination = /* @__PURE__ */ createComponentProxy("Pagination");
-var Alert = /* @__PURE__ */ createSuiteProxy("Alert", [
-  "Alert",
-  "AlertTitle",
-  "AlertDescription"
-]);
-var Card = /* @__PURE__ */ createSuiteProxy("Card", [
-  "Card",
-  "CardHeader",
-  "CardTitle",
-  "CardDescription",
-  "CardContent",
-  "CardFooter",
-  "CardAction"
-]);
-var FormGroup = /* @__PURE__ */ createSuiteProxy("FormGroup", ["FormGroup", "FormError"]);
-var Avatar = /* @__PURE__ */ createSuiteProxy("Avatar", [
-  "Avatar",
-  "AvatarImage",
-  "AvatarFallback"
-]);
-var Skeleton = /* @__PURE__ */ createSuiteProxy("Skeleton", ["Skeleton"]);
-var Table = /* @__PURE__ */ createSuiteProxy("Table", [
-  "Table",
-  "TableHeader",
-  "TableBody",
-  "TableRow",
-  "TableHead",
-  "TableCell",
-  "TableCaption",
-  "TableFooter"
+var Alert = /* @__PURE__ */ createCallableSuiteProxy("Alert", [
+  "Title",
+  "Description"
 ]);
-var AlertDialog = /* @__PURE__ */ createCompoundProxy("AlertDialog", ["Trigger", "Content", "Header", "Title", "Description", "Footer", "Cancel", "Action"]);
-var Dialog = /* @__PURE__ */ createCompoundProxy("Dialog", [
-  "Trigger",
-  "Content",
+var Card = /* @__PURE__ */ createCallableSuiteProxy("Card", [
   "Header",
   "Title",
   "Description",
+  "Content",
   "Footer",
-  "Close"
+  "Action"
+]);
+var FormGroup = /* @__PURE__ */ createCallableSuiteProxy("FormGroup", ["FormError"]);
+var Avatar = /* @__PURE__ */ createCallableSuiteProxy("Avatar", ["Image", "Fallback"]);
+var EmptyState = /* @__PURE__ */ createCallableSuiteProxy("EmptyState", ["Icon", "Title", "Description", "Action"]);
+var Skeleton = /* @__PURE__ */ createCallableSuiteProxy("Skeleton", ["Text", "Circle"]);
+var Table = /* @__PURE__ */ createCallableSuiteProxy("Table", [
+  "Header",
+  "Body",
+  "Row",
+  "Head",
+  "Cell",
+  "Caption",
+  "Footer"
 ]);
+var Dialog = /* @__PURE__ */ createPrimitiveSuiteProxy("Dialog", ["Header", "Title", "Description", "Footer", "Body", "Close", "Cancel"]);
 var DropdownMenu = /* @__PURE__ */ createCompoundProxy("DropdownMenu", ["Trigger", "Content", "Item", "Group", "Label", "Separator"]);
 var Select = /* @__PURE__ */ createCompoundProxy("Select", [
   "Trigger",
@@ -192,6 +197,7 @@ export {
   Input,
   HoverCard,
   FormGroup,
+  EmptyState,
   DropdownMenu,
   Drawer,
   Dialog,
@@ -207,7 +213,6 @@ export {
   Breadcrumb,
   Badge,
   Avatar,
-  AlertDialog,
   Alert,
   Accordion
 };

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

@@ -1,6 +1,6 @@
 /** All keyword names. */
-type Keyword = "flex" | "grid" | "block" | "inline" | "hidden" | "inline-flex" | "flex-1" | "flex-col" | "flex-row" | "flex-wrap" | "flex-nowrap" | "fixed" | "absolute" | "relative" | "sticky" | "uppercase" | "lowercase" | "capitalize" | "outline-none" | "overflow-hidden" | "select-none" | "pointer-events-none" | "whitespace-nowrap" | "shrink-0" | "italic" | "not-italic";
-type BaseUtility = Keyword | `${SpacingProperty}:${SpacingValue}` | `${BgColorProperty}:${ColorToken}` | `${SizeProperty}:${SizeKeyword | SpacingValue | "screen"}` | `${RadiusProperty}:${RadiusValue}` | `${ShadowProperty}:${ShadowValue}` | `${AlignmentProperty}:${AlignmentValue}` | `${FontWeightProperty}:${FontWeightValue}` | `${LineHeightProperty}:${LineHeightValue}` | `${ContentProperty}:${ContentValue}` | `${RawProperty}:${string}` | `ring:${`${number}` | ColorToken}` | `text:${FontSizeValue | TextAlignKeyword | ColorToken}` | `font:${FontSizeValue | FontWeightValue}` | `border:${`${number}` | ColorToken}` | `list:${ListKeyword}`;
+type Keyword = "flex" | "grid" | "block" | "inline" | "hidden" | "inline-flex" | "flex-1" | "flex-col" | "flex-row" | "flex-wrap" | "flex-nowrap" | "fixed" | "absolute" | "relative" | "sticky" | "uppercase" | "lowercase" | "capitalize" | "outline-none" | "overflow-hidden" | "select-none" | "pointer-events-none" | "whitespace-nowrap" | "shrink-0" | "italic" | "not-italic" | "scale-0" | "scale-75" | "scale-90" | "scale-95" | "scale-100" | "scale-105" | "scale-110" | "scale-125" | "scale-150";
+type BaseUtility = Keyword | `${SpacingProperty}:${SpacingValue}` | `${BgColorProperty}:${ColorToken}` | `${SizeProperty}:${SizeKeyword | SpacingValue | "screen" | `${number}/${number}`}` | `${RadiusProperty}:${RadiusValue}` | `${ShadowProperty}:${ShadowValue}` | `${AlignmentProperty}:${AlignmentValue}` | `${FontWeightProperty}:${FontWeightValue}` | `${LineHeightProperty}:${LineHeightValue}` | `${ContentProperty}:${ContentValue}` | `${RawProperty}:${string}` | `ring:${`${number}` | ColorToken}` | `text:${FontSizeValue | TextAlignKeyword | ColorToken}` | `font:${FontSizeValue | FontWeightValue}` | `border:${`${number}` | ColorToken}` | `list:${ListKeyword}`;
 type PseudoUtility = `${PseudoPrefix}:${Keyword}` | `${PseudoPrefix}:${PropertyName}:${string}`;
 /**
 * Union of all valid CSS utility class strings.
@@ -253,8 +253,12 @@ interface ThemeProviderProps {
 *
 * Uses __element() directly (instead of jsx()) so the hydration cursor
 * walker can claim the existing SSR node during mount().
+*
+* Accepts `props` without destructuring so that the compiler-generated
+* getter for `theme` stays alive — `__attr()` reads it inside a domEffect,
+* making the attribute reactive when the parent passes a signal-backed value.
 */
-declare function ThemeProvider({ theme, children }: ThemeProviderProps): HTMLElement;
+declare function ThemeProvider(props: ThemeProviderProps): HTMLElement;
 /**
 * A record of variant names to their possible values (each value maps to style entries).
 *

package/dist/src/css/public.js

@@ -8,11 +8,11 @@ import {
   globalCss,
   s,
   variants
-} from "../../shared/chunk-pq8khh47.js";
-import"../../shared/chunk-vwz86vg9.js";
-import"../../shared/chunk-prj7nm08.js";
-import"../../shared/chunk-c61572xp.js";
-import"../../shared/chunk-2qe6aqhb.js";
+} from "../../shared/chunk-t3rnfxc0.js";
+import"../../shared/chunk-mbnda3pv.js";
+import"../../shared/chunk-h1fsr8kv.js";
+import"../../shared/chunk-2y9f9j62.js";
+import"../../shared/chunk-656n0x6y.js";
 export {
   variants,
   s,

package/dist/src/form/public.js

@@ -3,8 +3,8 @@ import {
   form,
   formDataToObject,
   validate
-} from "../../shared/chunk-yb4a0smw.js";
-import"../../shared/chunk-2qe6aqhb.js";
+} from "../../shared/chunk-4gmtsf6v.js";
+import"../../shared/chunk-656n0x6y.js";
 export {
   validate,
   formDataToObject,

package/dist/src/index.d.ts

@@ -117,6 +117,24 @@ declare function createContext<T>(defaultValue?: T, __stableId?: string): Contex
 * Returns the default value if no Provider is active.
 */
 declare function useContext<T>(ctx: Context<T>): UnwrapSignals<T> | undefined;
+/** Props for error fallback components (shared by DefaultErrorFallback and route errorComponent). */
+interface ErrorFallbackProps {
+	error: Error;
+	retry: () => void;
+}
+/**
+* Framework-provided error fallback component.
+*
+* Renders a simple error display with the error message and a "Try again" button.
+* Works without any theme registered — uses inline styles for a clean default look.
+*
+* Exported from `@vertz/ui` (not `@vertz/ui/components`) because it is a
+* framework-level component, not a theme-provided one.
+*
+* Uses imperative DOM instead of JSX because `@vertz/ui` is a core package
+* without the Vertz compiler plugin — `.ts` files don't go through JSX transforms.
+*/
+declare function DefaultErrorFallback({ error, retry }: ErrorFallbackProps): HTMLElement;
 /** DOM element types accepted by JSX (mirrors JSX.Element). */
 type JsxElement = HTMLElement | SVGElement | DocumentFragment;
 /** Props for the ErrorBoundary component. */
@@ -139,6 +157,60 @@ interface ErrorBoundaryProps {
 */
 declare function ErrorBoundary(props: ErrorBoundaryProps): JsxElement;
 /**
+* Props for the Foreign component.
+*
+* `<Foreign>` renders a container element whose children are owned by
+* external (non-Vertz) code. During hydration, the container is claimed
+* but its children are not walked — external content is preserved.
+*/
+interface ForeignProps {
+	/**
+	* HTML tag for the container element.
+	* @default 'div'
+	*/
+	tag?: keyof HTMLElementTagNameMap | keyof SVGElementTagNameMap;
+	/**
+	* Called when the container is ready for external DOM manipulation.
+	* Runs after hydration is complete (post-hydration onMount timing).
+	* Return a cleanup function for unmount.
+	*
+	* This is the sole way to access the container element.
+	* For SVG tags, cast to the appropriate SVG element type.
+	*/
+	onReady?: (container: HTMLElement | SVGElement) => (() => void) | void;
+	/**
+	* Pre-rendered HTML content to inject during SSR.
+	* Only takes effect during server-side rendering — on the client,
+	* the SSR content is already in the DOM and preserved by hydration.
+	*
+	* Use this for content that can be pre-rendered on the server
+	* (e.g. syntax-highlighted code) to avoid a flash on first paint.
+	*/
+	html?: string;
+	/** Element id */
+	id?: string;
+	/** CSS class name */
+	className?: string;
+	/** Inline styles (camelCase object) */
+	style?: Partial<CSSStyleDeclaration>;
+	/**
+	* Children are not supported. Foreign renders an empty container
+	* whose children are managed by external code via onReady.
+	*/
+	children?: never;
+}
+/**
+* Foreign component — renders an unmanaged subtree container.
+*
+* Claims the container element during hydration without entering its children.
+* External code owns the container's children via the `onReady` callback,
+* which fires in post-hydration `onMount` timing.
+*
+* Implemented as a hand-written `.ts` component (no JSX, no compiler transforms)
+* because it's a framework primitive that uses `__element()` directly.
+*/
+declare function Foreign({ tag, onReady, html, id, className, style }: ForeignProps): Element;
+/**
 * Runs callback once on mount. Never re-executes.
 * Return a function to register cleanup that runs on unmount.
 *
@@ -224,8 +296,8 @@ declare const slideOutToRight: string;
 declare const accordionDown: string;
 declare const accordionUp: string;
 /** All keyword names. */
-type Keyword = "flex" | "grid" | "block" | "inline" | "hidden" | "inline-flex" | "flex-1" | "flex-col" | "flex-row" | "flex-wrap" | "flex-nowrap" | "fixed" | "absolute" | "relative" | "sticky" | "uppercase" | "lowercase" | "capitalize" | "outline-none" | "overflow-hidden" | "select-none" | "pointer-events-none" | "whitespace-nowrap" | "shrink-0" | "italic" | "not-italic";
-type BaseUtility = Keyword | `${SpacingProperty}:${SpacingValue}` | `${BgColorProperty}:${ColorToken}` | `${SizeProperty}:${SizeKeyword | SpacingValue | "screen"}` | `${RadiusProperty}:${RadiusValue}` | `${ShadowProperty}:${ShadowValue}` | `${AlignmentProperty}:${AlignmentValue}` | `${FontWeightProperty}:${FontWeightValue}` | `${LineHeightProperty}:${LineHeightValue}` | `${ContentProperty}:${ContentValue}` | `${RawProperty}:${string}` | `ring:${`${number}` | ColorToken}` | `text:${FontSizeValue | TextAlignKeyword | ColorToken}` | `font:${FontSizeValue | FontWeightValue}` | `border:${`${number}` | ColorToken}` | `list:${ListKeyword}`;
+type Keyword = "flex" | "grid" | "block" | "inline" | "hidden" | "inline-flex" | "flex-1" | "flex-col" | "flex-row" | "flex-wrap" | "flex-nowrap" | "fixed" | "absolute" | "relative" | "sticky" | "uppercase" | "lowercase" | "capitalize" | "outline-none" | "overflow-hidden" | "select-none" | "pointer-events-none" | "whitespace-nowrap" | "shrink-0" | "italic" | "not-italic" | "scale-0" | "scale-75" | "scale-90" | "scale-95" | "scale-100" | "scale-105" | "scale-110" | "scale-125" | "scale-150";
+type BaseUtility = Keyword | `${SpacingProperty}:${SpacingValue}` | `${BgColorProperty}:${ColorToken}` | `${SizeProperty}:${SizeKeyword | SpacingValue | "screen" | `${number}/${number}`}` | `${RadiusProperty}:${RadiusValue}` | `${ShadowProperty}:${ShadowValue}` | `${AlignmentProperty}:${AlignmentValue}` | `${FontWeightProperty}:${FontWeightValue}` | `${LineHeightProperty}:${LineHeightValue}` | `${ContentProperty}:${ContentValue}` | `${RawProperty}:${string}` | `ring:${`${number}` | ColorToken}` | `text:${FontSizeValue | TextAlignKeyword | ColorToken}` | `font:${FontSizeValue | FontWeightValue}` | `border:${`${number}` | ColorToken}` | `list:${ListKeyword}`;
 type PseudoUtility = `${PseudoPrefix}:${Keyword}` | `${PseudoPrefix}:${PropertyName}:${string}`;
 /**
 * Union of all valid CSS utility class strings.
@@ -540,8 +612,12 @@ interface ThemeProviderProps {
 *
 * Uses __element() directly (instead of jsx()) so the hydration cursor
 * walker can claim the existing SSR node during mount().
+*
+* Accepts `props` without destructuring so that the compiler-generated
+* getter for `theme` stays alive — `__attr()` reads it inside a domEffect,
+* making the attribute reactive when the parent passes a signal-backed value.
 */
-declare function ThemeProvider({ theme, children }: ThemeProviderProps): HTMLElement;
+declare function ThemeProvider(props: ThemeProviderProps): HTMLElement;
 /**
 * A record of variant names to their possible values (each value maps to style entries).
 *
@@ -581,6 +657,9 @@ interface VariantFunction<V extends VariantDefinitions> {
 */
 declare function variants<V extends VariantDefinitions>(config: VariantsConfig<V>): VariantFunction<V>;
 declare const DialogStackContext: Context<DialogStack>;
+declare const DialogHandleContext: Context<DialogHandle<unknown>>;
+declare const DialogIdContext: Context<string>;
+declare function useDialog<T = void>(): DialogHandle<T>;
 declare function useDialogStack(): DialogStack;
 interface DialogHandle<TResult> {
 	close(...args: void extends TResult ? [] : [result: TResult]): void;
@@ -597,19 +676,42 @@ type DialogResult<T> = {
 } | {
 	readonly ok: false;
 };
+interface DialogOpenOptions {
+	/** Whether the dialog can be dismissed by backdrop click or Escape. Default: true */
+	dismissible?: boolean;
+}
+interface ConfirmOptions {
+	title: string;
+	description?: string;
+	confirm?: string;
+	cancel?: string;
+	intent?: "primary" | "danger";
+	dismissible?: boolean;
+}
 interface DialogStack {
 	open<
 		TResult,
 		TProps
-	>(component: DialogComponent<TResult, TProps>, props: TProps): Promise<DialogResult<TResult>>;
+	>(component: DialogComponent<TResult, TProps>, props: TProps, options?: DialogOpenOptions): Promise<DialogResult<TResult>>;
 	/** @internal — used by useDialogStack() to pass captured context scope */
 	openWithScope<
 		TResult,
 		TProps
-	>(component: DialogComponent<TResult, TProps>, props: TProps, scope: ContextScope | null): Promise<DialogResult<TResult>>;
+	>(component: DialogComponent<TResult, TProps>, props: TProps, scope: ContextScope | null, options?: DialogOpenOptions): Promise<DialogResult<TResult>>;
+	confirm(options: ConfirmOptions): Promise<boolean>;
 	readonly size: number;
 	closeAll(): void;
 }
+/**
+* Manages the dialog container element and provides DialogStack via context.
+*
+* Creates a hydration-safe container div via `__element`, initializes the
+* dialog stack, and wraps children in `DialogStackContext.Provider`.
+* The container renders after children — dialogs portal into it.
+*/
+declare function DialogStackProvider({ children }: {
+	children?: unknown;
+}): HTMLElement;
 declare function createDialogStack(container: HTMLElement): DialogStack;
 /**
 * Brand symbol for render nodes.
@@ -661,18 +763,18 @@ declare function getAdapter(): RenderAdapter;
 */
 declare function setAdapter(adapter: RenderAdapter | null): void;
 /**
-* Create a DOM adapter that delegates to real browser DOM APIs.
-* Zero overhead — no branding, no wrapping.
-* Browser `Node` instances pass `isRenderNode()` via the `instanceof Node` fallback.
-*/
-declare function createDOMAdapter(): RenderAdapter;
-/**
 * Wait for all CSS animations on an element to complete, then call back.
 * If no animations are running, calls back immediately.
 * Respects prefers-reduced-motion by skipping the wait.
 */
 declare function onAnimationsComplete(el: Element, callback: () => void): void;
 /**
+* Create a DOM adapter that delegates to real browser DOM APIs.
+* Zero overhead — no branding, no wrapping.
+* Browser `Node` instances pass `isRenderNode()` via the `instanceof Node` fallback.
+*/
+declare function createDOMAdapter(): RenderAdapter;
+/**
 * Create a DOM element with optional static properties.
 *
 * This is a compiler output target — the compiler generates calls
@@ -885,6 +987,37 @@ interface FormDataOptions {
 *   "true"/"false" become booleans.
 */
 declare function formDataToObject(formData: FormData, options?: FormDataOptions): Record<string, unknown>;
+type DateInput = Date | string | number;
+interface FormatRelativeTimeOptions {
+	/** BCP 47 locale tag. Defaults to user's locale via Intl defaults. */
+	locale?: string;
+	/** Intl.RelativeTimeFormat numeric option. Defaults to 'auto'. */
+	numeric?: "auto" | "always";
+	/** Reference time for "now". Defaults to `new Date()`. Useful for testing. */
+	now?: Date;
+}
+declare function formatRelativeTime(date: DateInput, options?: FormatRelativeTimeOptions): string;
+interface RelativeTimeProps {
+	/** The date to format. Accepts Date, ISO string, or epoch ms. */
+	date: DateInput;
+	/** BCP 47 locale tag. */
+	locale?: string;
+	/** Intl.RelativeTimeFormat numeric option. Defaults to 'auto'. */
+	numeric?: "auto" | "always";
+	/** Update interval in ms. Defaults to adaptive. */
+	updateInterval?: number;
+	/** CSS class name for the <time> element. */
+	className?: string;
+	/** Title attribute (shown on hover). Defaults to full formatted date. Set to false to disable. */
+	title?: string | false;
+}
+/**
+* Auto-updating relative time component.
+* Renders a `<time>` element with the formatted relative time.
+* Uses `setTimeout` chains with adaptive intervals for live updates.
+* Timer starts in `onMount()` — safe for SSR (skipped on server).
+*/
+declare function RelativeTime({ date, locale, numeric, updateInterval, className, title }: RelativeTimeProps): HTMLTimeElement;
 /** A function returning a dynamic import of a component module. */
 type ComponentLoader = () => Promise<{
 	default: ComponentFunction;
@@ -1027,6 +1160,16 @@ declare function invalidate<
 	T,
 	E
 >(descriptor: QueryDescriptor<T, E>): void;
+/**
+* Invalidate all active queries targeting tenant-scoped entities.
+* Clears cached data first (no SWR stale window), then refetches.
+*
+* Called automatically by TenantProvider after switchTenant() succeeds.
+* Can also be called manually if needed.
+*
+* No-op during SSR.
+*/
+declare function invalidateTenantQueries(): void;
 import { EntityQueryMeta as EntityQueryMeta2, QueryDescriptor as QueryDescriptor2 } from "@vertz/fetch";
 /** Options for query(). */
 interface QueryOptions<T> {
@@ -1034,8 +1177,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. */
@@ -1069,6 +1210,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. */
@@ -1090,7 +1233,11 @@ declare function query<
 	T,
 	E
 >(descriptor: QueryDescriptor2<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: () => QueryDescriptor2<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
@@ -1215,7 +1362,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. */
@@ -1253,7 +1403,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>;
@@ -1287,7 +1440,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"];
@@ -1505,9 +1661,18 @@ 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;
+/** 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.
@@ -1520,7 +1685,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.
 *
@@ -1537,26 +1702,6 @@ declare function parseSearchParams<T = Record<string, string>>(urlParams: URLSea
 * @returns The current search params value
 */
 declare function useSearchParams<T>(searchSignal: ReadonlySignal<T>): T;
-/** Input type for registerTheme(). Compatible with configureTheme() output. */
-interface RegisterThemeInput {
-	components: {
-		primitives?: object;
-	};
-}
-/**
-* Register a theme for use with `@vertz/ui/components`.
-*
-* Call once at app startup, before any component from `@vertz/ui/components` is used.
-* Calling again replaces the previously registered theme.
-*
-* @example
-* ```ts
-* import { registerTheme } from '@vertz/ui';
-* import { configureTheme } from '@vertz/theme-shadcn';
-* registerTheme(configureTheme({ palette: 'zinc', radius: 'md' }));
-* ```
-*/
-declare function registerTheme(resolved: RegisterThemeInput): void;
 /**
 * Error thrown when `onCleanup()` is called outside a disposal scope.
 * Similar to React's invalid hook call error — fail-fast so developers
@@ -1566,6 +1711,12 @@ declare class DisposalScopeError extends Error {
 	constructor();
 }
 /**
+* Register a cleanup function with the current disposal scope.
+* Throws `DisposalScopeError` if no scope is active — fail-fast
+* so developers know their cleanup callback was not registered.
+*/
+declare function onCleanup(fn: DisposeFn): void;
+/**
 * Group multiple signal writes into a single update flush.
 * Nested batches are supported — only the outermost batch triggers the flush.
 */
@@ -1805,6 +1956,7 @@ declare class QueryEnvelopeStore {
 	private _envelopes;
 	get(queryKey: string): QueryEnvelope | undefined;
 	set(queryKey: string, envelope: QueryEnvelope): void;
+	delete(queryKey: string): void;
 	clear(): void;
 }
 /** Get the global EntityStore singleton. */
@@ -1909,4 +2061,24 @@ declare function resetRelationSchemas_TEST_ONLY(): void;
 * ```
 */
 declare function createTestStore(data: Record<string, Record<string, unknown>>): EntityStore;
-export { zoomOut, zoomIn, variants, validate, useSearchParams, useRouter, useParams, useDialogStack, useContext, untrack, slideOutToTop, slideOutToRight, slideOutToLeft, slideOutToBottom, slideInFromTop, slideInFromRight, slideInFromLeft, slideInFromBottom, signal, setAdapter, s, resolveChildren, resetRelationSchemas_TEST_ONLY, resetInjectedStyles, registerTheme, registerRelationSchema, ref, queryMatch, query, parseSearchParams, palettes, onMount2 as onMount, onAnimationsComplete, mount, keyframes, isRenderNode, isQueryDescriptor, isBrowser, invalidate, injectCSS, hydrateIslands, hydrate, globalCss, getRelationSchema, getQueryEnvelopeStore, getInjectedCSS, getEntityStore, getAdapter, formDataToObject, form, font, fadeOut, fadeIn, defineTheme, defineRoutes, css, createTestStore, createRouter, createOptimisticHandler, createLink, createFieldState, createDialogStack, createDOMAdapter, createContext, configureImageOptimizer, computed, compileTheme, compileFonts, children, buildOptimizedUrl, batch, accordionUp, accordionDown, __staticText, __exitChildren, __enterChildren, __element, __append, VariantsConfig, VariantProps, VariantFunction, ValidationResult, UnwrapSignals, TypedRoutes, TypedRouter, ThemeProviderProps, ThemeProvider, ThemeInput, Theme, SuspenseProps, Suspense, StyleValue, StyleEntry, Signal, SerializedStore, SearchParamSchema, SdkMethodWithMeta, SdkMethod, RouterViewProps, RouterView, RouterOptions, RouterContext, Router, RoutePattern, RoutePaths, RouteMatch, RouteDefinitionMap, RouteConfig, RenderText, RenderNode, RenderElement, RenderAdapter, RelationSchema, RelationFieldDef, RegisterThemeInput, Ref, ReadonlySignal, RENDER_NODE_BRAND, QueryResult, QueryOptions, QueryMatchHandlers, QueryEnvelopeStore, QueryEnvelope, QueryDescriptor3 as QueryDescriptor, PresenceProps, Presence, PreloadItem, PathWithParams, ParamSchema, OutletContextValue, OutletContext, Outlet, NavigateOptions, NavigateInput, MountOptions, MountHandle, MergeSelectOptions, MatchedRoute, LoaderData, ListTransitionProps, ListTransition, LinkProps, LinkFactoryOptions, Link, IslandRegistry, IslandProps, Island, InferRouteMap, ImageProps, Image, GlobalCSSOutput, GlobalCSSInput, FormSchema, FormOptions, FormInstance, FormDataOptions, FontSrc, FontOptions, FontFallbackMetrics, FontDescriptor, FieldState, FieldSelectionTracker, FallbackFontName, ExtractParams, ErrorBoundaryProps, ErrorBoundary, EntityStoreOptions, EntityStore, DisposeFn, DisposalScopeError, DialogStackContext, DialogStack, DialogResult, DialogHandle, DialogComponent, Context, Computed, ComponentRegistry, ComponentLoader, ComponentFunction, CompiledTheme, CompiledRoute, CompiledFonts, CompileThemeOptions, CompileFontsOptions, ColorPalette, ChildrenAccessor, ChildValue, CacheStore, CSSOutput, CSSInput, ANIMATION_EASING, ANIMATION_DURATION };
+/** Input type for registerTheme(). Compatible with configureTheme() output. */
+interface RegisterThemeInput {
+	components: {
+		primitives?: object;
+	};
+}
+/**
+* Register a theme for use with `@vertz/ui/components`.
+*
+* Call once at app startup, before any component from `@vertz/ui/components` is used.
+* Calling again replaces the previously registered theme.
+*
+* @example
+* ```ts
+* import { registerTheme } from '@vertz/ui';
+* import { configureTheme } from '@vertz/theme-shadcn';
+* registerTheme(configureTheme({ palette: 'zinc', radius: 'md' }));
+* ```
+*/
+declare function registerTheme(resolved: RegisterThemeInput): void;
+export { zoomOut, zoomIn, variants, validate, useSearchParams, useRouter, useParams, useDialogStack, useDialog, useContext, untrack, slideOutToTop, slideOutToRight, slideOutToLeft, slideOutToBottom, slideInFromTop, slideInFromRight, slideInFromLeft, slideInFromBottom, signal, setAdapter, s, resolveChildren, resetRelationSchemas_TEST_ONLY, resetInjectedStyles, registerTheme, registerRelationSchema, ref, queryMatch, query, parseSearchParams, palettes, onMount2 as onMount, onCleanup, onAnimationsComplete, mount, keyframes, isRenderNode, isQueryDescriptor, isBrowser, invalidateTenantQueries, invalidate, injectCSS, hydrateIslands, hydrate, globalCss, getRelationSchema, getQueryEnvelopeStore, getInjectedCSS, getEntityStore, getAdapter, formatRelativeTime, formDataToObject, form, font, fadeOut, fadeIn, defineTheme, defineRoutes, css, createTestStore, createRouter, createOptimisticHandler, createLink, createFieldState, createDialogStack, createDOMAdapter, createContext, configureImageOptimizer, computed, compileTheme, compileFonts, children, buildOptimizedUrl, batch, accordionUp, accordionDown, __staticText, __exitChildren, __enterChildren, __element, __append, VariantsConfig, VariantProps, VariantFunction, ValidationResult, UnwrapSignals, TypedRoutes, TypedRouter, ThemeProviderProps, ThemeProvider, ThemeInput, Theme, SuspenseProps, Suspense, StyleValue, StyleEntry, Signal, SerializedStore, SearchParamSchema, SdkMethodWithMeta, SdkMethod, RouterViewProps, RouterView, RouterOptions, RouterContext, Router, RoutePattern, RoutePaths, RouteMatch, RouteDefinitionMap, RouteConfig, RenderText, RenderNode, RenderElement, RenderAdapter, RelativeTimeProps, RelativeTime, RelationSchema, RelationFieldDef, RegisterThemeInput, Ref, ReadonlySignal, RENDER_NODE_BRAND, QueryResult, QueryOptions, QueryMatchHandlers, QueryEnvelopeStore, QueryEnvelope, QueryDescriptor3 as QueryDescriptor, PresenceProps, Presence, PreloadItem, PathWithParams, ParamSchema, OutletContextValue, OutletContext, Outlet, NavigateOptions, NavigateInput, MountOptions, MountHandle, MergeSelectOptions, MatchedRoute, LoaderData, ListTransitionProps, ListTransition, LinkProps, LinkFactoryOptions, Link, IslandRegistry, IslandProps, Island, InferRouteMap, ImageProps, Image, GlobalCSSOutput, GlobalCSSInput, FormatRelativeTimeOptions, FormSchema, FormOptions, FormInstance, FormDataOptions, ForeignProps, Foreign, FontSrc, FontOptions, FontFallbackMetrics, FontDescriptor, FieldState, FieldSelectionTracker, FallbackFontName, ExtractParams, ErrorFallbackProps, ErrorBoundaryProps, ErrorBoundary, EntityStoreOptions, EntityStore, DisposeFn, DisposalScopeError, DialogStackProvider, DialogStackContext, DialogStack, DialogResult, DialogOpenOptions, DialogIdContext, DialogHandleContext, DialogHandle, DialogComponent, DefaultErrorFallback, DateInput, Context, ConfirmOptions, Computed, ComponentRegistry, ComponentLoader, ComponentFunction, CompiledTheme, CompiledRoute, CompiledFonts, CompileThemeOptions, CompileFontsOptions, ColorPalette, ChildrenAccessor, ChildValue, CacheStore, CSSOutput, CSSInput, ANIMATION_EASING, ANIMATION_DURATION };