@vertz/ui 0.2.23 → 0.2.25

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

@@ -29,16 +29,12 @@ interface ReadonlySignal<T> {
 * type UnwrappedData = Unwrapped<ReadonlySignal<Task | undefined>>; // → Task | undefined
 */
 type Unwrapped<T> = T extends ReadonlySignal<infer U> ? U : T;
-/** Dispose function returned by effect(). */
-type DisposeFn = () => void;
 /** Options for query(). */
 interface QueryOptions<T> {
 	/** Pre-populated data — skips the initial fetch when provided. */
 	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 +68,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,34 +91,9 @@ 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>;
-interface QueryMatchHandlers<
-	T,
-	E
-> {
-	loading: () => Node | null;
-	error: (error: E) => Node | null;
-	data: (data: T) => Node | null;
-}
-/**
-* Pattern-match on a QueryResult's exclusive state.
-*
-* Returns a stable `<span style="display:contents">` wrapper that internally
-* manages branch switching (loading/error/data) via a reactive effect.
-* The same wrapper is returned for repeated calls with the same queryResult
-* (cached via WeakMap), enabling __child's stable-node optimization.
-*
-* Priority: loading → error → data.
-*
-* `loading` only fires on the initial load (no data yet).
-* When revalidating with existing data, the `data` handler receives the
-* current data. Access `query.revalidating` from the component scope for
-* revalidation state.
-*/
-declare function queryMatch<
+declare function query<
 	T,
 	E
->(queryResult: QueryResult<T, E>, handlers: QueryMatchHandlers<T, E>): HTMLElement & {
-	dispose: DisposeFn;
-};
-export { queryMatch, query, isQueryDescriptor, QueryResult, QueryOptions, QueryMatchHandlers, QueryDescriptor2 as QueryDescriptor, CacheStore };
+>(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>;
+export { query, isQueryDescriptor, QueryResult, QueryOptions, QueryDescriptor2 as QueryDescriptor, CacheStore };

package/dist/src/query/public.js

@@ -1,16 +1,14 @@
 import {
-  query,
-  queryMatch
-} from "../../shared/chunk-g6fb5yc2.js";
+  query
+} from "../../shared/chunk-1jgws7rs.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-2y9f9j62.js";
-import"../../shared/chunk-da2w7j7w.js";
-import"../../shared/chunk-656n0x6y.js";
+import"../../shared/chunk-09ntccdx.js";
+import"../../shared/chunk-xs5s8gqe.js";
+import"../../shared/chunk-ppr06jgn.js";
 
 // src/query/public.ts
 import { isQueryDescriptor } from "@vertz/fetch";
 export {
-  queryMatch,
   query,
   isQueryDescriptor
 };

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,24 @@ import {
   createLink,
   parseSearchParams,
   useSearchParams
-} from "../../shared/chunk-016m1fq0.js";
-import"../../shared/chunk-2kyhn86t.js";
-import"../../shared/chunk-4xkw6h1s.js";
+} from "../../shared/chunk-2krx4aqe.js";
+import"../../shared/chunk-svvqjmyy.js";
 import {
   createRouter
-} from "../../shared/chunk-jtma4sh4.js";
+} from "../../shared/chunk-e09mdqcx.js";
 import {
   defineRoutes
 } from "../../shared/chunk-am9zaw4h.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-13tvh4wq.js";
-import"../../shared/chunk-prj7nm08.js";
-import"../../shared/chunk-2y9f9j62.js";
+import"../../shared/chunk-djvarb8r.js";
+import"../../shared/chunk-h1fsr8kv.js";
 import {
   RouterContext,
   useParams,
   useRouter
-} from "../../shared/chunk-f4d5nphq.js";
-import"../../shared/chunk-da2w7j7w.js";
-import"../../shared/chunk-656n0x6y.js";
+} from "../../shared/chunk-7nr2ebrf.js";
+import"../../shared/chunk-xs5s8gqe.js";
+import"../../shared/chunk-ppr06jgn.js";
 export {
   useSearchParams,
   useRouter,

package/dist/src/test/index.d.ts

@@ -187,7 +187,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. */
@@ -225,7 +228,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>;
@@ -243,7 +249,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"];

package/dist/src/test/index.js

@@ -1,12 +1,12 @@
 import {
   createRouter
-} from "../../shared/chunk-jtma4sh4.js";
+} from "../../shared/chunk-e09mdqcx.js";
 import {
   defineRoutes
 } from "../../shared/chunk-am9zaw4h.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-da2w7j7w.js";
-import"../../shared/chunk-656n0x6y.js";
+import"../../shared/chunk-xs5s8gqe.js";
+import"../../shared/chunk-ppr06jgn.js";
 
 // src/test/interactions.ts
 async function click(el) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vertz/ui",
-  "version": "0.2.23",
+  "version": "0.2.25",
   "type": "module",
   "license": "MIT",
   "description": "Vertz UI framework — signals, components, JSX runtime",
@@ -69,15 +69,16 @@
   "scripts": {
     "build": "bunup",
     "test": "bun test",
+    "test:benchmark": "bun test src/dom/__tests__/hydration-deferred-effects-bench.local.ts",
     "test:watch": "bun test --watch",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@vertz/fetch": "^0.2.22"
+    "@vertz/fetch": "^0.2.24"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.7.0",
-    "@vertz/schema": "^0.2.22",
+    "@vertz/schema": "^0.2.24",
     "bunup": "^0.16.31",
     "happy-dom": "^20.7.0",
     "typescript": "^5.7.0"

package/reactivity.json

@@ -29,7 +29,7 @@
       "kind": "function",
       "reactivity": {
         "plainProperties": ["refetch", "revalidate", "dispose"],
-        "signalProperties": ["data", "loading", "error", "revalidating"],
+        "signalProperties": ["data", "loading", "error", "revalidating", "idle"],
         "type": "signal-api"
       }
     },

package/dist/shared/chunk-13tvh4wq.js

@@ -1,229 +0,0 @@
-import {
-  SVG_NS,
-  isSVGTag,
-  normalizeSVGAttr
-} from "./chunk-prj7nm08.js";
-import {
-  getAdapter,
-  isRenderNode
-} from "./chunk-2y9f9j62.js";
-import {
-  claimElement,
-  claimText,
-  deferredDomEffect,
-  domEffect,
-  enterChildren,
-  exitChildren,
-  getIsHydrating,
-  pauseHydration,
-  popScope,
-  pushScope,
-  resumeHydration,
-  runCleanups
-} from "./chunk-656n0x6y.js";
-
-// src/dom/element.ts
-var MAX_THUNK_DEPTH = 100;
-function resolveAndAppend(parent, value, depth = 0) {
-  if (depth >= MAX_THUNK_DEPTH) {
-    throw new Error("resolveAndAppend: max recursion depth exceeded — possible circular thunk");
-  }
-  if (value == null || typeof value === "boolean") {
-    return;
-  }
-  if (typeof value === "function") {
-    resolveAndAppend(parent, value(), depth + 1);
-    return;
-  }
-  if (Array.isArray(value)) {
-    for (const item of value) {
-      resolveAndAppend(parent, item, depth);
-    }
-    return;
-  }
-  if (isRenderNode(value)) {
-    parent.appendChild(value);
-    return;
-  }
-  const text = typeof value === "string" ? value : String(value);
-  parent.appendChild(getAdapter().createTextNode(text));
-}
-function __text(fn) {
-  if (getIsHydrating()) {
-    const claimed = claimText();
-    if (claimed) {
-      const node2 = claimed;
-      node2.dispose = deferredDomEffect(() => {
-        node2.data = fn();
-      });
-      return node2;
-    }
-  }
-  const node = getAdapter().createTextNode("");
-  node.dispose = domEffect(() => {
-    node.data = fn();
-  });
-  return node;
-}
-function __child(fn) {
-  let wrapper;
-  if (getIsHydrating()) {
-    const claimed = claimElement("span");
-    if (claimed) {
-      wrapper = claimed;
-      while (wrapper.firstChild) {
-        wrapper.removeChild(wrapper.firstChild);
-      }
-      pauseHydration();
-      try {
-        let childCleanups2 = [];
-        wrapper.dispose = domEffect(() => {
-          runCleanups(childCleanups2);
-          const needsPause = getIsHydrating();
-          if (needsPause)
-            pauseHydration();
-          try {
-            const scope = pushScope();
-            const value = fn();
-            popScope();
-            childCleanups2 = scope;
-            if (isRenderNode(value) && wrapper.childNodes.length === 1 && wrapper.firstChild === value) {
-              return;
-            }
-            if (!isRenderNode(value) && value != null && typeof value !== "boolean" && wrapper.childNodes.length === 1 && wrapper.firstChild.nodeType === 3) {
-              const text = typeof value === "string" ? value : String(value);
-              wrapper.firstChild.data = text;
-              return;
-            }
-            while (wrapper.firstChild) {
-              wrapper.removeChild(wrapper.firstChild);
-            }
-            resolveAndAppend(wrapper, value);
-          } finally {
-            if (needsPause)
-              resumeHydration();
-          }
-        });
-      } finally {
-        resumeHydration();
-      }
-      return wrapper;
-    }
-  }
-  wrapper = getAdapter().createElement("span");
-  wrapper.style.display = "contents";
-  let childCleanups = [];
-  wrapper.dispose = domEffect(() => {
-    runCleanups(childCleanups);
-    const scope = pushScope();
-    const value = fn();
-    popScope();
-    childCleanups = scope;
-    if (isRenderNode(value) && wrapper.childNodes.length === 1 && wrapper.firstChild === value) {
-      return;
-    }
-    if (!isRenderNode(value) && value != null && typeof value !== "boolean" && typeof value !== "function" && wrapper.childNodes.length === 1 && wrapper.firstChild.nodeType === 3) {
-      const text = typeof value === "string" ? value : String(value);
-      wrapper.firstChild.data = text;
-      return;
-    }
-    while (wrapper.firstChild) {
-      wrapper.removeChild(wrapper.firstChild);
-    }
-    resolveAndAppend(wrapper, value);
-  });
-  return wrapper;
-}
-function resolveAndInsert(parent, value, depth = 0) {
-  if (depth >= MAX_THUNK_DEPTH) {
-    throw new Error("__insert: max recursion depth exceeded — possible circular thunk");
-  }
-  if (value == null || typeof value === "boolean") {
-    return;
-  }
-  if (typeof value === "function") {
-    resolveAndInsert(parent, value(), depth + 1);
-    return;
-  }
-  if (Array.isArray(value)) {
-    for (const item of value) {
-      resolveAndInsert(parent, item, depth);
-    }
-    return;
-  }
-  insertLeaf(parent, value);
-}
-function insertLeaf(parent, value) {
-  if (getIsHydrating()) {
-    if (isRenderNode(value)) {
-      return;
-    }
-    claimText();
-    return;
-  }
-  if (isRenderNode(value)) {
-    parent.appendChild(value);
-    return;
-  }
-  const text = typeof value === "string" ? value : String(value);
-  parent.appendChild(getAdapter().createTextNode(text));
-}
-function __insert(parent, value) {
-  if (value == null || typeof value === "boolean") {
-    return;
-  }
-  resolveAndInsert(parent, value);
-}
-function __element(tag, props) {
-  if (getIsHydrating()) {
-    const claimed = claimElement(tag);
-    if (claimed) {
-      if (props && typeof process !== "undefined" && true) {
-        for (const [key, value] of Object.entries(props)) {
-          if (key === "role" || key.startsWith("aria-")) {
-            const actual = claimed.getAttribute(key);
-            if (actual !== value) {
-              console.warn(`[hydrate] ARIA mismatch on <${tag}>: ${key}="${actual}" (expected "${value}")`);
-            }
-          }
-        }
-      }
-      return claimed;
-    }
-  }
-  const adapter = getAdapter();
-  const svg = isSVGTag(tag);
-  const el = svg ? adapter.createElementNS(SVG_NS, tag) : adapter.createElement(tag);
-  if (props) {
-    for (const [key, value] of Object.entries(props)) {
-      const attrName = svg ? normalizeSVGAttr(key) : key;
-      el.setAttribute(attrName, value);
-    }
-  }
-  return el;
-}
-function __append(parent, child) {
-  if (getIsHydrating())
-    return;
-  parent.appendChild(child);
-}
-function __staticText(text) {
-  if (getIsHydrating()) {
-    const claimed = claimText();
-    if (claimed)
-      return claimed;
-  }
-  return getAdapter().createTextNode(text);
-}
-function __enterChildren(el) {
-  if (getIsHydrating()) {
-    enterChildren(el);
-  }
-}
-function __exitChildren() {
-  if (getIsHydrating()) {
-    exitChildren();
-  }
-}
-
-export { __text, __child, __insert, __element, __append, __staticText, __enterChildren, __exitChildren };

package/dist/shared/chunk-2y9f9j62.js

@@ -1,40 +0,0 @@
-import {
-  getSSRContext
-} from "./chunk-656n0x6y.js";
-
-// src/dom/dom-adapter.ts
-function createDOMAdapter() {
-  return {
-    createElement: (tag) => document.createElement(tag),
-    createElementNS: (ns, tag) => document.createElementNS(ns, tag),
-    createTextNode: (text) => document.createTextNode(text),
-    createComment: (text) => document.createComment(text),
-    createDocumentFragment: () => document.createDocumentFragment(),
-    isNode: (value) => typeof Node !== "undefined" && value instanceof Node
-  };
-}
-
-// src/dom/adapter.ts
-var RENDER_NODE_BRAND = Symbol.for("vertz:render-node");
-function isRenderNode(value) {
-  if (value == null || typeof value !== "object")
-    return false;
-  if (RENDER_NODE_BRAND in value)
-    return true;
-  return typeof Node !== "undefined" && value instanceof Node;
-}
-var currentAdapter = null;
-function getAdapter() {
-  const ctx = getSSRContext();
-  if (ctx)
-    return ctx.adapter;
-  if (!currentAdapter) {
-    currentAdapter = createDOMAdapter();
-  }
-  return currentAdapter;
-}
-function setAdapter(adapter) {
-  currentAdapter = adapter;
-}
-
-export { createDOMAdapter, RENDER_NODE_BRAND, isRenderNode, getAdapter, setAdapter };

package/dist/shared/chunk-prj7nm08.js

@@ -1,67 +0,0 @@
-// src/dom/svg-tags.ts
-var SVG_TAGS = new Set([
-  "svg",
-  "path",
-  "circle",
-  "ellipse",
-  "rect",
-  "line",
-  "polyline",
-  "polygon",
-  "g",
-  "defs",
-  "symbol",
-  "use",
-  "text",
-  "tspan",
-  "image",
-  "foreignObject",
-  "filter",
-  "feGaussianBlur",
-  "feOffset",
-  "feColorMatrix",
-  "feBlend",
-  "feMerge",
-  "feMergeNode",
-  "feComposite",
-  "feFlood",
-  "linearGradient",
-  "radialGradient",
-  "stop",
-  "pattern",
-  "clipPath",
-  "mask",
-  "animate",
-  "animateTransform",
-  "set",
-  "marker",
-  "desc"
-]);
-var SVG_NS = "http://www.w3.org/2000/svg";
-function isSVGTag(tag) {
-  return SVG_TAGS.has(tag);
-}
-var SVG_ATTR_MAP = {
-  strokeWidth: "stroke-width",
-  strokeLinecap: "stroke-linecap",
-  strokeLinejoin: "stroke-linejoin",
-  strokeDasharray: "stroke-dasharray",
-  strokeDashoffset: "stroke-dashoffset",
-  strokeOpacity: "stroke-opacity",
-  fillOpacity: "fill-opacity",
-  fillRule: "fill-rule",
-  clipRule: "clip-rule",
-  clipPath: "clip-path",
-  stopColor: "stop-color",
-  stopOpacity: "stop-opacity",
-  floodColor: "flood-color",
-  floodOpacity: "flood-opacity",
-  colorInterpolation: "color-interpolation",
-  colorInterpolationFilters: "color-interpolation-filters",
-  viewBox: "viewBox"
-};
-function normalizeSVGAttr(attr) {
-  return SVG_ATTR_MAP[attr] ?? attr;
-}
-
-export { SVG_NS, isSVGTag, normalizeSVGAttr };