@vertz/ui 0.2.15 → 0.2.17

package/dist/src/index.js

@@ -6,6 +6,7 @@ import {
   fadeIn,
   fadeOut,
   hydrate,
+  hydrateIslands,
   isQueryDescriptor,
   keyframes,
   onAnimationsComplete,
@@ -20,33 +21,32 @@ import {
   slideOutToTop,
   zoomIn,
   zoomOut
-} from "../shared/chunk-4txc67nd.js";
+} from "../shared/chunk-6jyt4ycw.js";
 import {
+  Link,
   Outlet,
   OutletContext,
-  RouterContext,
   RouterView,
   createLink,
   parseSearchParams,
-  useParams,
-  useRouter,
   useSearchParams
-} from "../shared/chunk-nn9v1zmk.js";
-import"../shared/chunk-dksg08fq.js";
+} from "../shared/chunk-2wtb9x81.js";
+import"../shared/chunk-07bh4m1e.js";
 import {
   createRouter
-} from "../shared/chunk-wymw818z.js";
+} from "../shared/chunk-fkbgbf3n.js";
 import {
   defineRoutes
-} from "../shared/chunk-83g4h38e.js";
+} from "../shared/chunk-6wd36w21.js";
 import {
   createFieldState,
   form,
   formDataToObject,
   validate
-} from "../shared/chunk-5dbq8jp9.js";
+} from "../shared/chunk-j09yyh34.js";
 import {
   EntityStore,
+  FieldSelectionTracker,
   QueryEnvelopeStore,
   getEntityStore,
   getMutationEventBus,
@@ -57,14 +57,16 @@ import {
   queryMatch,
   registerRelationSchema,
   resetRelationSchemas_TEST_ONLY
-} from "../shared/chunk-hw67ckr3.js";
+} from "../shared/chunk-fs3eec4b.js";
 import"../shared/chunk-jrtrk5z4.js";
 import {
   ThemeProvider,
   children,
+  compileFonts,
   compileTheme,
   css,
   defineTheme,
+  font,
   getInjectedCSS,
   globalCss,
   injectCSS,
@@ -72,16 +74,20 @@ import {
   resolveChildren,
   s,
   variants
-} from "../shared/chunk-1wby7nex.js";
+} from "../shared/chunk-dhehvmj0.js";
 import {
   __append,
   __element,
   __enterChildren,
   __exitChildren,
   __staticText,
+  claimElement,
   endHydration,
+  enterChildren,
+  exitChildren,
+  getIsHydrating,
   startHydration
-} from "../shared/chunk-j6qyxfdc.js";
+} from "../shared/chunk-vndfjfdy.js";
 import"../shared/chunk-prj7nm08.js";
 import {
   RENDER_NODE_BRAND,
@@ -89,7 +95,15 @@ import {
   getAdapter,
   isRenderNode,
   setAdapter
-} from "../shared/chunk-h89w580h.js";
+} from "../shared/chunk-afawz764.js";
+import {
+  RouterContext,
+  useParams,
+  useRouter
+} from "../shared/chunk-mtsvrj9e.js";
+import {
+  isBrowser
+} from "../shared/chunk-14eqne2a.js";
 import {
   DisposalScopeError,
   _tryOnCleanup,
@@ -106,7 +120,7 @@ import {
   signal,
   untrack,
   useContext
-} from "../shared/chunk-8hsz5y4a.js";
+} from "../shared/chunk-4fwcwxn6.js";
 // src/component/error-boundary-context.ts
 var handlerStack = [];
 function pushErrorHandler(handler) {
@@ -620,6 +634,128 @@ function createDialogStack(container) {
     });
   }
 }
+// src/image/config.ts
+var optimizerBaseUrl = null;
+function configureImageOptimizer(baseUrl) {
+  optimizerBaseUrl = baseUrl;
+}
+function isOptimizerConfigured() {
+  return optimizerBaseUrl !== null;
+}
+function buildOptimizedUrl(src, width, height, quality, fit) {
+  if (!optimizerBaseUrl)
+    return null;
+  if (!src.startsWith("http://") && !src.startsWith("https://"))
+    return null;
+  const params = new URLSearchParams({
+    url: src,
+    w: String(width),
+    h: String(height),
+    q: String(quality),
+    fit
+  });
+  return `${optimizerBaseUrl}?${params}`;
+}
+// src/image/image.ts
+var BUILD_ONLY_PROPS = new Set([
+  "src",
+  "width",
+  "height",
+  "alt",
+  "class",
+  "style",
+  "loading",
+  "decoding",
+  "fetchpriority",
+  "priority",
+  "quality",
+  "fit",
+  "pictureClass"
+]);
+function Image({
+  src,
+  width,
+  height,
+  alt,
+  class: className,
+  style,
+  loading = "lazy",
+  decoding = "async",
+  fetchpriority,
+  priority,
+  quality = 80,
+  fit = "cover",
+  pictureClass: _pictureClass,
+  ...rest
+}) {
+  const resolvedLoading = priority ? "eager" : loading;
+  const resolvedDecoding = priority ? "sync" : decoding;
+  const resolvedFetchpriority = priority ? "high" : fetchpriority;
+  const optimizedSrc = buildOptimizedUrl(src, width, height, quality, fit);
+  if (isOptimizerConfigured() && optimizedSrc === null) {
+    console.info(`[vertz] <Image src="${src}"> was not optimized — only absolute HTTP(S) URLs are rewritten. ` + "Relative paths and data URIs are served as-is.");
+  }
+  const el = document.createElement("img");
+  el.setAttribute("src", optimizedSrc ?? src);
+  el.setAttribute("width", String(width));
+  el.setAttribute("height", String(height));
+  el.setAttribute("alt", alt);
+  el.setAttribute("loading", resolvedLoading);
+  el.setAttribute("decoding", resolvedDecoding);
+  if (resolvedFetchpriority)
+    el.setAttribute("fetchpriority", resolvedFetchpriority);
+  if (className)
+    el.setAttribute("class", className);
+  if (style)
+    el.setAttribute("style", style);
+  for (const [key, value] of Object.entries(rest)) {
+    if (!BUILD_ONLY_PROPS.has(key) && value != null) {
+      el.setAttribute(key, String(value));
+    }
+  }
+  return el;
+}
+// src/island/island.ts
+function validateSerializable(props, islandId) {
+  for (const [key, value] of Object.entries(props)) {
+    if (typeof value === "function") {
+      throw new Error(`[vertz] Island "${islandId}" received a function prop "${key}". ` + "Island props must be JSON-serializable. Define event handlers inside the island component instead.");
+    }
+    if (typeof value === "symbol") {
+      throw new Error(`[vertz] Island "${islandId}" received a Symbol prop "${key}". ` + "Island props must be JSON-serializable.");
+    }
+  }
+}
+function Island({ id, component: Component, props = {} }) {
+  const islandId = id ?? Component.name ?? "Island";
+  validateSerializable(props, islandId);
+  if (getIsHydrating()) {
+    const claimed = claimElement("div");
+    if (claimed) {
+      enterChildren(claimed);
+      claimElement("script");
+      Component(props);
+      exitChildren();
+      return claimed;
+    }
+  }
+  const wrapper = document.createElement("div");
+  wrapper.setAttribute("data-v-island", islandId);
+  const script = document.createElement("script");
+  script.setAttribute("data-v-island-props", "");
+  script.setAttribute("type", "application/json");
+  script.textContent = JSON.stringify(props);
+  wrapper.appendChild(script);
+  const content = Component(props);
+  if (content != null) {
+    if (content instanceof Node) {
+      wrapper.appendChild(content);
+    } else if (typeof content === "string") {
+      wrapper.appendChild(document.createTextNode(content));
+    }
+  }
+  return wrapper;
+}
 // src/mount.ts
 var MOUNTED_KEY = Symbol.for("vertz:mounted-roots");
 var _global = globalThis;
@@ -766,8 +902,10 @@ export {
   keyframes,
   isRenderNode,
   isQueryDescriptor,
+  isBrowser,
   invalidate,
   injectCSS,
+  hydrateIslands,
   hydrate,
   globalCss,
   getRelationSchema,
@@ -777,6 +915,7 @@ export {
   getAdapter,
   formDataToObject,
   form,
+  font,
   fadeOut,
   fadeIn,
   defineTheme,
@@ -790,9 +929,12 @@ export {
   createDialogStack,
   createDOMAdapter,
   createContext,
+  configureImageOptimizer,
   computed,
   compileTheme,
+  compileFonts,
   children,
+  buildOptimizedUrl,
   batch,
   accordionUp,
   accordionDown,
@@ -811,6 +953,10 @@ export {
   OutletContext,
   Outlet,
   ListTransition,
+  Link,
+  Island,
+  Image,
+  FieldSelectionTracker,
   ErrorBoundary,
   EntityStore,
   DisposalScopeError,

package/dist/src/internals.d.ts

@@ -80,6 +80,49 @@ declare function getContextScope(): ContextScope | null;
 * @internal
 */
 declare function setContextScope(scope: ContextScope | null): ContextScope | null;
+interface FontSrc {
+	path: string;
+	weight?: string | number;
+	style?: "normal" | "italic";
+}
+type FallbackFontName = "Arial" | "Times New Roman" | "Courier New";
+interface FontFallbackMetrics {
+	/** CSS ascent-override value, e.g., '94.52%' */
+	ascentOverride: string;
+	/** CSS descent-override value, e.g., '24.60%' */
+	descentOverride: string;
+	/** CSS line-gap-override value, e.g., '0.00%' */
+	lineGapOverride: string;
+	/** CSS size-adjust value, e.g., '104.88%' */
+	sizeAdjust: string;
+	/** System font used as fallback base. */
+	fallbackFont: FallbackFontName;
+}
+interface CompileFontsOptions {
+	/** Pre-computed fallback metrics per font key. Provided by @vertz/ui-server at build/SSR time. */
+	fallbackMetrics?: Record<string, FontFallbackMetrics>;
+}
+type FontStyle = "normal" | "italic";
+type FontDisplay = "auto" | "block" | "swap" | "fallback" | "optional";
+interface FontDescriptor {
+	readonly __brand: "FontDescriptor";
+	readonly family: string;
+	readonly weight: string;
+	readonly style: FontStyle;
+	readonly display: FontDisplay;
+	readonly src?: string | FontSrc[];
+	readonly fallback: string[];
+	readonly subsets: string[];
+	readonly unicodeRange?: string;
+	readonly adjustFontFallback: boolean | FallbackFontName;
+}
+/** Structured description of a resource to preload. */
+interface PreloadItem {
+	href: string;
+	as: "font" | "image" | "style" | "script";
+	type?: string;
+	crossorigin?: boolean;
+}
 /** Color tokens: a map of color names to their raw/contextual values. */
 type ColorTokens = Record<string, Record<string, string>>;
 /** Spacing tokens: a flat map of names to CSS values. */
@@ -90,6 +133,8 @@ interface Theme {
 	colors: ColorTokens;
 	/** Spacing scale tokens. */
 	spacing?: SpacingTokens;
+	/** Font descriptors keyed by token name. */
+	fonts?: Record<string, FontDescriptor>;
 }
 /** Output of compileTheme(). */
 interface CompiledTheme {
@@ -97,6 +142,15 @@ interface CompiledTheme {
 	css: string;
 	/** Flat list of token dot-paths (e.g., 'primary.500', 'background'). */
 	tokens: string[];
+	/** Font preload link tags for injection into <head>. */
+	preloadTags: string;
+	/** Structured preload data for generating HTTP Link headers. */
+	preloadItems: PreloadItem[];
+}
+/** Options for compileTheme(). */
+interface CompileThemeOptions {
+	/** Pre-computed font fallback metrics for zero-CLS font loading. */
+	fallbackMetrics?: CompileFontsOptions["fallbackMetrics"];
 }
 /**
 * Compile a theme into CSS custom properties.
@@ -108,7 +162,7 @@ interface CompiledTheme {
 * @param theme - A theme object from defineTheme().
 * @returns Compiled CSS and token list.
 */
-declare function compileTheme(theme: Theme): CompiledTheme;
+declare function compileTheme(theme: Theme, options?: CompileThemeOptions): CompiledTheme;
 /**
 * Shared CSS token lookup tables.
 *
@@ -383,12 +437,23 @@ 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;
+/**
+* Returns true when running in a real browser environment.
+* Returns false on the server, even if `window` exists (DOM shim).
+*
+* Uses `hasSSRResolver()` — which returns true when an SSR resolver
+* has been registered — instead of `getSSRContext()` which only returns
+* a value inside `ssrStorage.run()`. This correctly identifies server
+* module-scope code (e.g., HMR re-imports where `createRouter()` runs
+* at import time, outside any SSR render context).
+*/
+declare function isBrowser(): boolean;
 /** A function returning a dynamic import of a component module. */
 type ComponentLoader = () => Promise<{
 	default: ComponentFunction;
 }>;
-/** A component function that takes props and an element to mount into. */
-type ComponentFunction = (props: Record<string, unknown>, el: Element) => void;
+/** A component function that takes props and optionally an element to mount into. May return a Node. */
+type ComponentFunction = (props: Record<string, unknown>, el?: Element) => Node | void;
 /** Maps component IDs to their dynamic import loaders. */
 type ComponentRegistry = Record<string, ComponentLoader>;
 /**
@@ -413,14 +478,27 @@ interface CacheStore<T = unknown> {
 	clear?(): void;
 }
 /**
-* Default in-memory cache backed by a Map.
+* Default in-memory cache backed by a Map with optional LRU eviction.
+*
+* When `maxSize` is finite, least-recently-used entries are evicted on `set()`
+* when the cache exceeds the limit. `get()` promotes entries to most-recently-used.
 */
 declare class MemoryCache<T = unknown> implements CacheStore<T> {
 	private _store;
+	private _maxSize;
+	private _refs;
+	private _orphans;
+	constructor(options?: {
+		maxSize?: number;
+	});
 	get(key: string): T | undefined;
 	set(key: string, value: T): void;
 	delete(key: string): void;
 	clear(): void;
+	/** Mark a cache key as actively used by a query instance. */
+	retain(key: string): void;
+	/** Release a cache key when a query instance disposes or changes key. */
+	release(key: string): void;
 }
 /**
 * Derive a cache key from a thunk function.
@@ -492,6 +570,8 @@ interface RouteConfig<
 	searchParams?: SearchParamSchema<TSearch>;
 	/** Nested child routes. */
 	children?: RouteDefinitionMap;
+	/** Whether to pre-render this route at build time (default: true for static routes). */
+	prerender?: boolean;
 }
 /** A map of path patterns to route configs (user input format). */
 interface RouteDefinitionMap {
@@ -513,6 +593,8 @@ interface CompiledRoute {
 	searchParams?: RouteConfig["searchParams"];
 	/** Compiled children. */
 	children?: CompiledRoute[];
+	/** Whether to pre-render this route at build time (default: true for static routes). */
+	prerender?: boolean;
 }
 /** A single matched route entry in the matched chain. */
 interface MatchedRoute {
@@ -666,11 +748,22 @@ interface SerializedStore {
 	}>;
 }
 /**
+* Options for mergeWithSelect — metadata about field selection.
+*/
+interface MergeSelectOptions {
+	/** Fields that were part of the query's select set */
+	fields: string[];
+	/** Query source identifier for diagnostics (e.g., 'GET:/users') */
+	querySource: string;
+}
+/**
 * Options for EntityStore constructor.
 */
 interface EntityStoreOptions {
 	/** Initial data to hydrate from (SSR). */
 	initialData?: SerializedStore;
+	/** Enable dev-mode field selection tracking (zero overhead when false). */
+	devMode?: boolean;
 }
 /**
 * EntityStore - Normalized, signal-backed entity cache for @vertz/ui.
@@ -682,6 +775,7 @@ declare class EntityStore {
 	private _entities;
 	private _typeListeners;
 	private _queryIndices;
+	private _fieldTracker;
 	/** Public accessor for query indices — used by optimistic handlers and tests. */
 	get queryIndices(): QueryResultIndex;
 	constructor(options?: EntityStoreOptions);
@@ -705,6 +799,14 @@ declare class EntityStore {
 		id: string;
 	}>(type: string, data: T | T[]): void;
 	/**
+	* Merge entities with field selection metadata.
+	* Registers the select set for dev-mode access warnings.
+	* In production (devMode: false), behaves identically to merge().
+	*/
+	mergeWithSelect<T extends {
+		id: string;
+	}>(type: string, data: T | T[], selectOptions: MergeSelectOptions): void;
+	/**
 	* Remove an entity from the store.
 	* Triggers type change listeners and removes from query indices.
 	*/
@@ -790,8 +892,15 @@ declare class EntityStore {
 	private _mergeOne;
 	/**
 	* Recompute the visible signal value from base + all layers.
+	* Uses lastPlainVisible for equality check to avoid triggering
+	* field selection Proxy warnings during internal store operations.
 	*/
 	private _recomputeVisible;
+	/**
+	* Wrap entity in dev-mode Proxy for field selection warnings.
+	* No-op when devMode is off or no tracking exists.
+	*/
+	private _wrapWithFieldProxy;
 	private _getOrCreateTypeMap;
 	private _getOrCreateListeners;
 	private _notifyTypeChange;
@@ -843,8 +952,62 @@ interface SSRRenderContext {
 	errors: unknown[];
 	/** Global per-query timeout override (ms). */
 	globalSSRTimeout?: number;
+	/**
+	* Lazy route component Promises registered by RouterView during Pass 1.
+	* Keyed by CompiledRoute object identity to avoid pattern string collisions.
+	*/
+	pendingRouteComponents?: Map<object, Promise<{
+		default: () => Node;
+	}>>;
+	/**
+	* Resolved sync factories, populated between Pass 1 and Pass 2.
+	* Keyed by CompiledRoute object identity.
+	*/
+	resolvedComponents?: Map<object, () => Node>;
+	/**
+	* Route patterns discovered by createRouter() during SSR.
+	* Used by the build pipeline to discover which routes to pre-render.
+	*/
+	discoveredRoutes?: 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.
+	*/
+	ssrAuth?: SSRAuth;
+	/**
+	* Written by ProtectedRoute during Pass 1 when the user is not
+	* authenticated. Signals ssrRenderToString() to skip Pass 2 and
+	* return a redirect response instead.
+	*/
+	ssrRedirect?: {
+		to: string;
+	};
 }
+/** Auth state injected into SSRRenderContext by the server. */
+type SSRAuth = {
+	status: "authenticated";
+	user: {
+		id: string;
+		email: string;
+		role: string;
+		[key: string]: unknown;
+	};
+	expiresAt: number;
+} | {
+	status: "unauthenticated";
+};
 type SSRContextResolver = () => SSRRenderContext | undefined;
 declare function registerSSRResolver(resolver: SSRContextResolver | null): void;
 declare function getSSRContext(): SSRRenderContext | undefined;
-export { stopSignalCollection, startSignalCollection, setContextScope, setAdapter, runCleanups, resolveComponent, removeNode, registerSSRResolver, pushScope, popScope, onCleanup, onAnimationsComplete, matchRoute, matchPath, lifecycleEffect, isRenderNode, insertBefore, 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, 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 };
+/**
+* Returns true when an SSR resolver has been registered.
+*
+* This indicates we are running on the server — regardless of whether
+* an SSR render is currently active. The resolver is registered once
+* at import time by `@vertz/ui-server` and never cleared during the
+* server's lifetime. Stored on globalThis so it survives require.cache
+* 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 };

package/dist/src/internals.js

@@ -2,24 +2,24 @@ import {
   deserializeProps,
   onAnimationsComplete,
   resolveComponent
-} from "../shared/chunk-4txc67nd.js";
+} from "../shared/chunk-6jyt4ycw.js";
 import {
   __attr,
   __classList,
   __on,
   __show
-} from "../shared/chunk-dksg08fq.js";
+} from "../shared/chunk-07bh4m1e.js";
 import {
   executeLoaders,
   matchPath,
   matchRoute
-} from "../shared/chunk-83g4h38e.js";
+} from "../shared/chunk-6wd36w21.js";
 import {
   EntityStore,
   MemoryCache,
   QueryEnvelopeStore,
   deriveKey
-} from "../shared/chunk-hw67ckr3.js";
+} from "../shared/chunk-fs3eec4b.js";
 import"../shared/chunk-jrtrk5z4.js";
 import {
   ALIGNMENT_MAP,
@@ -40,7 +40,7 @@ import {
   SIZE_KEYWORDS,
   SPACING_SCALE,
   compileTheme
-} from "../shared/chunk-1wby7nex.js";
+} from "../shared/chunk-dhehvmj0.js";
 import {
   __append,
   __child,
@@ -53,7 +53,7 @@ import {
   claimComment,
   claimText,
   getIsHydrating
-} from "../shared/chunk-j6qyxfdc.js";
+} from "../shared/chunk-vndfjfdy.js";
 import"../shared/chunk-prj7nm08.js";
 import {
   RENDER_NODE_BRAND,
@@ -61,12 +61,16 @@ import {
   getAdapter,
   isRenderNode,
   setAdapter
-} from "../shared/chunk-h89w580h.js";
+} from "../shared/chunk-afawz764.js";
+import {
+  isBrowser
+} from "../shared/chunk-14eqne2a.js";
 import {
   _tryOnCleanup,
   domEffect,
   getContextScope,
   getSSRContext,
+  hasSSRResolver,
   lifecycleEffect,
   onCleanup,
   popScope,
@@ -77,7 +81,7 @@ import {
   signal,
   startSignalCollection,
   stopSignalCollection
-} from "../shared/chunk-8hsz5y4a.js";
+} from "../shared/chunk-4fwcwxn6.js";
 // src/dom/conditional.ts
 function normalizeNode(branchResult) {
   if (branchResult == null || typeof branchResult === "boolean") {
@@ -325,7 +329,9 @@ export {
   matchPath,
   lifecycleEffect,
   isRenderNode,
+  isBrowser,
   insertBefore,
+  hasSSRResolver,
   getSSRContext,
   getContextScope,
   getAdapter,

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

@@ -1,3 +1,7 @@
+/** A ref container for DOM element access. */
+interface Ref<T> {
+	current: T | undefined;
+}
 /**
 * JSX namespace - required for TypeScript's react-jsx mode
 * to understand intrinsic element types and component types.
@@ -11,6 +15,7 @@ declare namespace JSX {
 	}
 	interface IntrinsicAttributes {
 		key?: string | number;
+		ref?: Ref<unknown> | ((el: Element) => void);
 	}
 	interface IntrinsicElements {
 		[key: string]: HTMLAttributes | undefined;

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

@@ -26,7 +26,7 @@ function jsxImpl(tag, props) {
   if (typeof tag === "function") {
     return tag(props || {});
   }
-  const { children, ...attrs } = props || {};
+  const { children, ref: refProp, ...attrs } = props || {};
   const svg = isSVGTag(tag);
   const element = svg ? document.createElementNS(SVG_NS, tag) : document.createElement(tag);
   for (const [key, value] of Object.entries(attrs)) {
@@ -45,6 +45,13 @@ function jsxImpl(tag, props) {
     }
   }
   applyChildren(element, children);
+  if (refProp != null) {
+    if (typeof refProp === "function") {
+      refProp(element);
+    } else if (typeof refProp === "object" && "current" in refProp) {
+      refProp.current = element;
+    }
+  }
   return element;
 }
 function jsx(tag, props) {

package/dist/src/query/public.js

@@ -1,10 +1,11 @@
 import {
   query,
   queryMatch
-} from "../../shared/chunk-hw67ckr3.js";
+} from "../../shared/chunk-fs3eec4b.js";
 import"../../shared/chunk-jrtrk5z4.js";
-import"../../shared/chunk-h89w580h.js";
-import"../../shared/chunk-8hsz5y4a.js";
+import"../../shared/chunk-afawz764.js";
+import"../../shared/chunk-14eqne2a.js";
+import"../../shared/chunk-4fwcwxn6.js";
 
 // src/query/public.ts
 import { isQueryDescriptor } from "@vertz/fetch";