@vertz/ui 0.2.20 → 0.2.22

package/dist/src/internals.d.ts

@@ -80,6 +80,69 @@ declare function getContextScope(): ContextScope | null;
 * @internal
 */
 declare function setContextScope(scope: ContextScope | null): ContextScope | null;
+/**
+* Shared CSS token lookup tables.
+*
+* This is the single source of truth for all CSS token resolution data.
+* These tables are consumed by:
+*   1. packages/ui/src/css/token-resolver.ts (runtime)
+*   2. packages/ui-compiler/src/transformers/css-transformer.ts (compiler)
+*   3. packages/ui-compiler/src/css-extraction/extractor.ts (extraction)
+*
+* DO NOT duplicate these tables elsewhere. If you need a new token,
+* add it here and all consumers will pick it up automatically.
+*
+* TYPE SYNC: When adding or removing entries from any map/scale/set below,
+* also update the corresponding exported union type immediately above
+* the runtime constant. The types and runtime values must stay in sync.
+*/
+interface PropertyMapping {
+	/** CSS property name(s). If multiple, all get the same value. */
+	properties: string[];
+	/** Value resolver type. */
+	valueType: "spacing" | "color" | "radius" | "shadow" | "size" | "display" | "alignment" | "font-size" | "font-weight" | "line-height" | "ring" | "content" | "raw";
+}
+declare const PROPERTY_MAP: Record<string, PropertyMapping>;
+/** A single CSS property-value pair. */
+interface CSSDeclarationEntry {
+	property: string;
+	value: string;
+}
+/** Keyword map -- single keywords that resolve to one or more declarations. */
+declare const KEYWORD_MAP: Record<string, CSSDeclarationEntry[]>;
+/**
+* Display-only keyword map. Used by the compiler for quick display keyword
+* lookup without processing the full KEYWORD_MAP.
+*/
+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. */
+declare const RADIUS_SCALE: Record<string, string>;
+/** Shadow scale. */
+declare const SHADOW_SCALE: Record<string, string>;
+/** Font size scale. */
+declare const FONT_SIZE_SCALE: Record<string, string>;
+/** Font weight scale. */
+declare const FONT_WEIGHT_SCALE: Record<string, string>;
+/** Line height scale. */
+declare const LINE_HEIGHT_SCALE: Record<string, string>;
+/** Alignment value map. */
+declare const ALIGNMENT_MAP: Record<string, string>;
+/** Size keywords for width/height. */
+declare const SIZE_KEYWORDS: Record<string, string>;
+/** Height-axis property shorthands that should use vh units. */
+declare const HEIGHT_AXIS_PROPERTIES: ReadonlySet<string>;
+/** Known color token namespaces -- values that resolve to CSS custom properties. */
+declare const COLOR_NAMESPACES: ReadonlySet<string>;
+/** CSS color keywords that pass through without token resolution. */
+declare const CSS_COLOR_KEYWORDS: ReadonlySet<string>;
+/** Content keywords. */
+declare const CONTENT_MAP: Record<string, string>;
+/** Supported pseudo-state prefixes. */
+declare const PSEUDO_PREFIXES: ReadonlySet<string>;
+/** Map pseudo shorthand names to CSS pseudo-selectors. */
+declare const PSEUDO_MAP: Record<string, string>;
 interface FontSrc {
 	path: string;
 	weight?: string | number;
@@ -164,65 +227,6 @@ interface CompileThemeOptions {
 */
 declare function compileTheme(theme: Theme, options?: CompileThemeOptions): CompiledTheme;
 /**
-* Shared CSS token lookup tables.
-*
-* This is the single source of truth for all CSS token resolution data.
-* These tables are consumed by:
-*   1. packages/ui/src/css/token-resolver.ts (runtime)
-*   2. packages/ui-compiler/src/transformers/css-transformer.ts (compiler)
-*   3. packages/ui-compiler/src/css-extraction/extractor.ts (extraction)
-*
-* DO NOT duplicate these tables elsewhere. If you need a new token,
-* add it here and all consumers will pick it up automatically.
-*/
-interface PropertyMapping {
-	/** CSS property name(s). If multiple, all get the same value. */
-	properties: string[];
-	/** Value resolver type. */
-	valueType: "spacing" | "color" | "radius" | "shadow" | "size" | "display" | "alignment" | "font-size" | "font-weight" | "line-height" | "ring" | "content" | "raw";
-}
-declare const PROPERTY_MAP: Record<string, PropertyMapping>;
-/** A single CSS property-value pair. */
-interface CSSDeclarationEntry {
-	property: string;
-	value: string;
-}
-/** Keyword map -- single keywords that resolve to one or more declarations. */
-declare const KEYWORD_MAP: Record<string, CSSDeclarationEntry[]>;
-/**
-* Display-only keyword map. Used by the compiler for quick display keyword
-* lookup without processing the full KEYWORD_MAP.
-*/
-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. */
-declare const RADIUS_SCALE: Record<string, string>;
-/** Shadow scale. */
-declare const SHADOW_SCALE: Record<string, string>;
-/** Font size scale. */
-declare const FONT_SIZE_SCALE: Record<string, string>;
-/** Font weight scale. */
-declare const FONT_WEIGHT_SCALE: Record<string, string>;
-/** Line height scale. */
-declare const LINE_HEIGHT_SCALE: Record<string, string>;
-/** Alignment value map. */
-declare const ALIGNMENT_MAP: Record<string, string>;
-/** Size keywords for width/height. */
-declare const SIZE_KEYWORDS: Record<string, string>;
-/** Height-axis property shorthands that should use vh units. */
-declare const HEIGHT_AXIS_PROPERTIES: ReadonlySet<string>;
-/** Known color token namespaces -- values that resolve to CSS custom properties. */
-declare const COLOR_NAMESPACES: ReadonlySet<string>;
-/** CSS color keywords that pass through without token resolution. */
-declare const CSS_COLOR_KEYWORDS: ReadonlySet<string>;
-/** Content keywords. */
-declare const CONTENT_MAP: Record<string, string>;
-/** Supported pseudo-state prefixes. */
-declare const PSEUDO_PREFIXES: ReadonlySet<string>;
-/** Map pseudo shorthand names to CSS pseudo-selectors. */
-declare const PSEUDO_MAP: Record<string, string>;
-/**
 * Brand symbol for render nodes.
 * SSR nodes add this to their prototype for fast identification.
 * Browser DOM nodes use the `instanceof Node` fallback in `isRenderNode`.
@@ -284,8 +288,12 @@ declare function onAnimationsComplete(el: Element, callback: () => void): void;
 *
 * Compiler output target for reactive attribute expressions.
 * Returns a dispose function to stop the reactive binding.
+*
+* Uses deferredDomEffect so the first run is skipped during hydration
+* (SSR attributes are already correct). Dependency tracking is
+* established when endHydration() flushes the deferred queue.
 */
-declare function __attr(el: HTMLElement, name: string, fn: () => string | boolean | null | undefined): DisposeFn;
+declare function __attr(el: HTMLElement, name: string, fn: () => string | boolean | Record<string, string | number> | null | undefined): DisposeFn;
 /**
 * Reactive display toggle.
 * When fn() returns false, the element is hidden (display: none).
@@ -437,6 +445,7 @@ declare function clearChildren(container: Node): void;
 * @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 styleObjectToString(style: Record<string, string | number | null | undefined>): string;
 /**
 * Returns true when running in a real browser environment.
 * Returns false on the server, even if `window` exists (DOM shim).
@@ -534,6 +543,24 @@ type ExtractParams<T extends string> = [ExtractParamsFromSegments<WithoutWildcar
 } : Record<string, never> : HasWildcard<T> extends true ? { [K in ExtractParamsFromSegments<WithoutWildcard<T>>] : string } & {
 	"*": string;
 } : { [K in ExtractParamsFromSegments<WithoutWildcard<T>>] : string };
+/**
+* View Transitions API integration.
+*
+* Provides a utility to wrap DOM updates in browser view transitions,
+* with graceful degradation for unsupported browsers, reduced motion
+* preferences, and SSR environments.
+*/
+/** View transition configuration. */
+interface ViewTransitionConfig {
+	/**
+	* CSS class name added to `<html>` during the transition,
+	* enabling per-transition CSS animation rules via
+	* `.className::view-transition-old(root)` etc.
+	*
+	* Omit for the default cross-fade.
+	*/
+	className?: string;
+}
 /** Schema interface for parsing and validating values (search params, path params). */
 interface SearchParamSchema<T> {
 	parse(data: unknown): {
@@ -572,6 +599,10 @@ interface RouteConfig<
 	children?: RouteDefinitionMap;
 	/** Whether to pre-render this route at build time (default: true for static routes). */
 	prerender?: boolean;
+	/** Generate param combinations for pre-rendering dynamic routes at build time. */
+	generateParams?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+	/** Per-route view transition config. Overrides global RouterOptions.viewTransition. */
+	viewTransition?: boolean | ViewTransitionConfig;
 }
 /** A map of path patterns to route configs (user input format). */
 interface RouteDefinitionMap {
@@ -595,6 +626,10 @@ interface CompiledRoute {
 	children?: CompiledRoute[];
 	/** Whether to pre-render this route at build time (default: true for static routes). */
 	prerender?: boolean;
+	/** Generate param combinations for pre-rendering dynamic routes at build time. */
+	generateParams?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+	/** Per-route view transition config. */
+	viewTransition?: boolean | ViewTransitionConfig;
 }
 /** A single matched route entry in the matched chain. */
 interface MatchedRoute {
@@ -970,6 +1005,12 @@ interface SSRRenderContext {
 	*/
 	discoveredRoutes?: string[];
 	/**
+	* Route patterns that matched the current URL during SSR.
+	* The full matched chain from root to leaf (e.g., ['/app', '/app/settings']).
+	* Used by the SSR handler to inject per-route modulepreload tags.
+	*/
+	matchedRoutePatterns?: string[];
+	/**
 	* Auth state resolved by the server (e.g. from session cookie).
 	* Set by ssrRenderToString() before Pass 1 so AuthProvider can
 	* hydrate status/user synchronously during SSR.
@@ -985,7 +1026,7 @@ interface SSRRenderContext {
 	};
 }
 /** Auth state injected into SSRRenderContext by the server. */
-type SSRAuth = {
+type SSRAuth = ({
 	status: "authenticated";
 	user: {
 		id: string;
@@ -996,6 +1037,13 @@ type SSRAuth = {
 	expiresAt: number;
 } | {
 	status: "unauthenticated";
+}) & {
+	/** OAuth provider metadata for SSR rendering of login buttons. */
+	providers?: {
+		id: string;
+		name: string;
+		authUrl: string;
+	}[];
 };
 type SSRContextResolver = () => SSRRenderContext | undefined;
 declare function registerSSRResolver(resolver: SSRContextResolver | null): void;
@@ -1010,4 +1058,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, __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, __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 };

package/dist/src/internals.js

@@ -2,24 +2,27 @@ import {
   deserializeProps,
   onAnimationsComplete,
   resolveComponent
-} from "../shared/chunk-yjs76c7v.js";
+} from "../shared/chunk-pdqr78k9.js";
 import {
   __attr,
   __classList,
   __on,
   __show
-} from "../shared/chunk-07bh4m1e.js";
+} from "../shared/chunk-kjwp5q5s.js";
+import {
+  styleObjectToString
+} from "../shared/chunk-4xkw6h1s.js";
 import {
   executeLoaders,
   matchPath,
   matchRoute
-} from "../shared/chunk-6wd36w21.js";
+} from "../shared/chunk-am9zaw4h.js";
 import {
   EntityStore,
   MemoryCache,
   QueryEnvelopeStore,
   deriveKey
-} from "../shared/chunk-fs3eec4b.js";
+} from "../shared/chunk-szk0hyjg.js";
 import"../shared/chunk-jrtrk5z4.js";
 import {
   ALIGNMENT_MAP,
@@ -40,7 +43,7 @@ import {
   SIZE_KEYWORDS,
   SPACING_SCALE,
   compileTheme
-} from "../shared/chunk-c3r237f0.js";
+} from "../shared/chunk-pq8khh47.js";
 import {
   __append,
   __child,
@@ -49,11 +52,8 @@ import {
   __exitChildren,
   __insert,
   __staticText,
-  __text,
-  claimComment,
-  claimText,
-  getIsHydrating
-} from "../shared/chunk-mgfrrrjq.js";
+  __text
+} from "../shared/chunk-vwz86vg9.js";
 import"../shared/chunk-prj7nm08.js";
 import {
   RENDER_NODE_BRAND,
@@ -61,14 +61,17 @@ import {
   getAdapter,
   isRenderNode,
   setAdapter
-} from "../shared/chunk-afawz764.js";
+} from "../shared/chunk-c61572xp.js";
 import {
   isBrowser
-} from "../shared/chunk-14eqne2a.js";
+} from "../shared/chunk-bybgyjye.js";
 import {
   _tryOnCleanup,
+  claimComment,
+  claimText,
   domEffect,
   getContextScope,
+  getIsHydrating,
   getSSRContext,
   hasSSRResolver,
   lifecycleEffect,
@@ -81,7 +84,7 @@ import {
   signal,
   startSignalCollection,
   stopSignalCollection
-} from "../shared/chunk-4fwcwxn6.js";
+} from "../shared/chunk-2qe6aqhb.js";
 // src/dom/conditional.ts
 function normalizeNode(branchResult) {
   if (branchResult == null || typeof branchResult === "boolean") {
@@ -243,7 +246,7 @@ function __list(container, items, keyFn, renderFn) {
   const outerScope = pushScope();
   let isFirstRun = true;
   domEffect(() => {
-    const newItems = getItems();
+    const newItems = getItems() ?? [];
     if (isFirstRun && isHydrationRun) {
       isFirstRun = false;
       for (const [i, item] of newItems.entries()) {
@@ -344,6 +347,7 @@ export {
   clearChildren,
   _tryOnCleanup,
   __text,
+  styleObjectToString as __styleStr,
   __staticText,
   __show,
   __on,

package/dist/src/jsx-runtime/index.d.ts

@@ -3,6 +3,24 @@ interface Ref<T> {
 	current: T | undefined;
 }
 /**
+* Extracts string-valued property names from CSSStyleDeclaration.
+* Filters out methods (getPropertyValue, item, etc.), numeric properties (length),
+* and non-string properties (parentRule). Uses Extract<keyof, string> to exclude
+* numeric index signatures.
+*/
+type CSSPropertyName = { [K in Extract<keyof CSSStyleDeclaration, string>] : CSSStyleDeclaration[K] extends string ? K : never }[Extract<keyof CSSStyleDeclaration, string>];
+/**
+* CSS properties type for the style prop, derived from CSSStyleDeclaration.
+* Provides autocomplete for all CSS properties the browser supports.
+*
+* - All properties accept string | number (numeric values get auto-px at runtime)
+* - CSS custom properties (--*) are supported via template literal index signature
+* - Stays current with whatever TypeScript version the developer uses
+*/
+type CSSProperties = { [K in CSSPropertyName]? : string | number } & {
+	[key: `--${string}`]: string | number;
+};
+/**
 * JSX namespace - required for TypeScript's react-jsx mode
 * to understand intrinsic element types and component types.
 */
@@ -12,6 +30,8 @@ declare namespace JSX {
 	interface HTMLAttributes {
 		[key: string]: unknown;
 		children?: unknown;
+		className?: string;
+		style?: string | CSSProperties;
 	}
 	interface IntrinsicAttributes {
 		key?: string | number;

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

@@ -1,3 +1,6 @@
+import {
+  styleObjectToString
+} from "../../shared/chunk-4xkw6h1s.js";
 import {
   SVG_NS,
   isSVGTag,
@@ -29,14 +32,21 @@ function jsxImpl(tag, props) {
   const { children, ref: refProp, ...attrs } = props || {};
   const svg = isSVGTag(tag);
   const element = svg ? document.createElementNS(SVG_NS, tag) : document.createElement(tag);
+  const resolvedClass = attrs.className ?? attrs.class;
   for (const [key, value] of Object.entries(attrs)) {
+    if (key === "className" || key === "class") {
+      if (key === "class" && attrs.className != null)
+        continue;
+      if (resolvedClass != null) {
+        element.setAttribute("class", String(resolvedClass));
+      }
+      continue;
+    }
     if (key.startsWith("on") && typeof value === "function") {
       const eventName = key.slice(2).toLowerCase();
       element.addEventListener(eventName, value);
-    } else if (key === "class" && value != null) {
-      element.setAttribute("class", String(value));
     } else if (key === "style" && value != null) {
-      element.setAttribute("style", String(value));
+      element.setAttribute("style", typeof value === "object" && !Array.isArray(value) ? styleObjectToString(value) : String(value));
     } else if (value === true) {
       element.setAttribute(key, "");
     } else if (value != null && value !== false) {

package/dist/src/query/public.js

@@ -1,11 +1,11 @@
 import {
   query,
   queryMatch
-} from "../../shared/chunk-fs3eec4b.js";
+} from "../../shared/chunk-szk0hyjg.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-afawz764.js";
-import"../../shared/chunk-14eqne2a.js";
-import"../../shared/chunk-4fwcwxn6.js";
+import"../../shared/chunk-c61572xp.js";
+import"../../shared/chunk-bybgyjye.js";
+import"../../shared/chunk-2qe6aqhb.js";
 
 // src/query/public.ts
 import { isQueryDescriptor } from "@vertz/fetch";

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

@@ -46,6 +46,24 @@ type RoutePattern<TRouteMap extends Record<string, unknown>> = keyof TRouteMap &
 * ```
 */
 type RoutePaths<TRouteMap extends Record<string, unknown>> = { [K in RoutePattern<TRouteMap>] : PathWithParams<K> }[RoutePattern<TRouteMap>];
+/**
+* View Transitions API integration.
+*
+* Provides a utility to wrap DOM updates in browser view transitions,
+* with graceful degradation for unsupported browsers, reduced motion
+* preferences, and SSR environments.
+*/
+/** View transition configuration. */
+interface ViewTransitionConfig {
+	/**
+	* CSS class name added to `<html>` during the transition,
+	* enabling per-transition CSS animation rules via
+	* `.className::view-transition-old(root)` etc.
+	*
+	* Omit for the default cross-fade.
+	*/
+	className?: string;
+}
 /** Schema interface for parsing and validating values (search params, path params). */
 interface SearchParamSchema<T> {
 	parse(data: unknown): {
@@ -84,6 +102,10 @@ interface RouteConfig<
 	children?: RouteDefinitionMap;
 	/** Whether to pre-render this route at build time (default: true for static routes). */
 	prerender?: boolean;
+	/** Generate param combinations for pre-rendering dynamic routes at build time. */
+	generateParams?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+	/** Per-route view transition config. Overrides global RouterOptions.viewTransition. */
+	viewTransition?: boolean | ViewTransitionConfig;
 }
 /** A map of path patterns to route configs (user input format). */
 interface RouteDefinitionMap {
@@ -114,6 +136,8 @@ interface RouteConfigLike {
 	searchParams?: SearchParamSchema<unknown>;
 	children?: Record<string, RouteConfigLike>;
 	prerender?: boolean;
+	generateParams?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+	viewTransition?: boolean | ViewTransitionConfig;
 }
 /**
 * Phantom branded array that carries the route map type `T`.
@@ -149,6 +173,10 @@ interface CompiledRoute {
 	children?: CompiledRoute[];
 	/** Whether to pre-render this route at build time (default: true for static routes). */
 	prerender?: boolean;
+	/** Generate param combinations for pre-rendering dynamic routes at build time. */
+	generateParams?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+	/** Per-route view transition config. */
+	viewTransition?: boolean | ViewTransitionConfig;
 }
 /** A single matched route entry in the matched chain. */
 interface MatchedRoute {
@@ -242,6 +270,11 @@ interface LinkProps<T extends Record<string, RouteConfigLike> = RouteDefinitionM
 	activeClass?: string;
 	/** Static class name for the anchor element. */
 	className?: string;
+	/**
+	* Static class for the anchor element.
+	* @deprecated Use `className` instead.
+	*/
+	class?: string;
 	/** Prefetch strategy. 'hover' triggers server pre-fetch on mouseenter/focus. */
 	prefetch?: "hover";
 }
@@ -264,7 +297,7 @@ declare function createLink(currentPath: ReadonlySignal<string>, navigate: (url:
 * Reads the router from `RouterContext` automatically — no manual wiring needed.
 * Just use `<Link href="/about">About</Link>` inside a router-provided tree.
 */
-declare function Link({ href, children, activeClass, className }: LinkProps): HTMLAnchorElement;
+declare function Link({ href, children, activeClass, class: classProp, className }: LinkProps): HTMLAnchorElement;
 type NavigateSearchValue = string | number | boolean | null | undefined;
 type NavigateSearch = string | URLSearchParams | Record<string, NavigateSearchValue | readonly NavigateSearchValue[]>;
 /** Options for router.navigate(). */
@@ -275,6 +308,11 @@ interface NavigateOptions {
 	params?: Record<string, string>;
 	/** Search params appended to the final URL. */
 	search?: NavigateSearch;
+	/**
+	* Override view transition for this navigation only.
+	* `false` explicitly disables even if route/global config enables transitions.
+	*/
+	viewTransition?: boolean | ViewTransitionConfig;
 }
 type NavigateOptionsFor<TPath extends string> = string extends TPath ? NavigateOptions : TPath extends `${string}:${string}` | `${string}*` ? Omit<NavigateOptions, "params"> & {
 	params: ExtractParams<TPath>;
@@ -302,6 +340,14 @@ interface RouterOptions {
 	_prefetchNavData?: (url: string, options?: {
 		timeout?: number;
 	}) => PrefetchHandle;
+	/**
+	* Global view transition setting.
+	* - `true` → all navigations use the default cross-fade
+	* - `ViewTransitionConfig` → all navigations use the config
+	* - Per-route and per-navigation overrides take precedence
+	* - Default: `undefined` (no transitions)
+	*/
+	viewTransition?: boolean | ViewTransitionConfig;
 }
 /**
 * The router instance returned by createRouter.

package/dist/src/router/public.js

@@ -6,25 +6,26 @@ import {
   createLink,
   parseSearchParams,
   useSearchParams
-} from "../../shared/chunk-j5qtsm0b.js";
-import"../../shared/chunk-07bh4m1e.js";
+} from "../../shared/chunk-67z8b0q8.js";
+import"../../shared/chunk-kjwp5q5s.js";
+import"../../shared/chunk-4xkw6h1s.js";
 import {
   createRouter
-} from "../../shared/chunk-fkbgbf3n.js";
+} from "../../shared/chunk-7g722pdh.js";
 import {
   defineRoutes
-} from "../../shared/chunk-6wd36w21.js";
+} from "../../shared/chunk-am9zaw4h.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-mgfrrrjq.js";
+import"../../shared/chunk-vwz86vg9.js";
 import"../../shared/chunk-prj7nm08.js";
-import"../../shared/chunk-afawz764.js";
+import"../../shared/chunk-c61572xp.js";
 import {
   RouterContext,
   useParams,
   useRouter
-} from "../../shared/chunk-mtsvrj9e.js";
-import"../../shared/chunk-14eqne2a.js";
-import"../../shared/chunk-4fwcwxn6.js";
+} from "../../shared/chunk-4cmt1ve8.js";
+import"../../shared/chunk-bybgyjye.js";
+import"../../shared/chunk-2qe6aqhb.js";
 export {
   useSearchParams,
   useRouter,

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

@@ -140,6 +140,24 @@ type ExtractParams<T extends string> = [ExtractParamsFromSegments<WithoutWildcar
 } : { [K in ExtractParamsFromSegments<WithoutWildcard<T>>] : string };
 /** Union of route pattern keys from a route map. */
 type RoutePattern<TRouteMap extends Record<string, unknown>> = keyof TRouteMap & string;
+/**
+* View Transitions API integration.
+*
+* Provides a utility to wrap DOM updates in browser view transitions,
+* with graceful degradation for unsupported browsers, reduced motion
+* preferences, and SSR environments.
+*/
+/** View transition configuration. */
+interface ViewTransitionConfig {
+	/**
+	* CSS class name added to `<html>` during the transition,
+	* enabling per-transition CSS animation rules via
+	* `.className::view-transition-old(root)` etc.
+	*
+	* Omit for the default cross-fade.
+	*/
+	className?: string;
+}
 /** Schema interface for parsing and validating values (search params, path params). */
 interface SearchParamSchema<T> {
 	parse(data: unknown): {
@@ -178,6 +196,10 @@ interface RouteConfig<
 	children?: RouteDefinitionMap;
 	/** Whether to pre-render this route at build time (default: true for static routes). */
 	prerender?: boolean;
+	/** Generate param combinations for pre-rendering dynamic routes at build time. */
+	generateParams?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+	/** Per-route view transition config. Overrides global RouterOptions.viewTransition. */
+	viewTransition?: boolean | ViewTransitionConfig;
 }
 /** A map of path patterns to route configs (user input format). */
 interface RouteDefinitionMap {
@@ -208,6 +230,8 @@ interface RouteConfigLike {
 	searchParams?: SearchParamSchema<unknown>;
 	children?: Record<string, RouteConfigLike>;
 	prerender?: boolean;
+	generateParams?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+	viewTransition?: boolean | ViewTransitionConfig;
 }
 /** Internal compiled route. */
 interface CompiledRoute {
@@ -227,6 +251,10 @@ interface CompiledRoute {
 	children?: CompiledRoute[];
 	/** Whether to pre-render this route at build time (default: true for static routes). */
 	prerender?: boolean;
+	/** Generate param combinations for pre-rendering dynamic routes at build time. */
+	generateParams?: () => Array<Record<string, string>> | Promise<Array<Record<string, string>>>;
+	/** Per-route view transition config. */
+	viewTransition?: boolean | ViewTransitionConfig;
 }
 /** A single matched route entry in the matched chain. */
 interface MatchedRoute {
@@ -271,6 +299,11 @@ interface NavigateOptions {
 	params?: Record<string, string>;
 	/** Search params appended to the final URL. */
 	search?: NavigateSearch;
+	/**
+	* Override view transition for this navigation only.
+	* `false` explicitly disables even if route/global config enables transitions.
+	*/
+	viewTransition?: boolean | ViewTransitionConfig;
 }
 type NavigateOptionsFor<TPath extends string> = string extends TPath ? NavigateOptions : TPath extends `${string}:${string}` | `${string}*` ? Omit<NavigateOptions, "params"> & {
 	params: ExtractParams<TPath>;

package/dist/src/test/index.js

@@ -1,12 +1,12 @@
 import {
   createRouter
-} from "../../shared/chunk-fkbgbf3n.js";
+} from "../../shared/chunk-7g722pdh.js";
 import {
   defineRoutes
-} from "../../shared/chunk-6wd36w21.js";
+} from "../../shared/chunk-am9zaw4h.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-14eqne2a.js";
-import"../../shared/chunk-4fwcwxn6.js";
+import"../../shared/chunk-bybgyjye.js";
+import"../../shared/chunk-2qe6aqhb.js";
 
 // src/test/interactions.ts
 async function click(el) {