@vertz/ui 0.2.24 → 0.2.26

package/dist/shared/{chunk-18frwfc4.js → chunk-ymc3wwam.js}

@@ -1,6 +1,9 @@
 import {
   injectCSS
-} from "./chunk-t3rnfxc0.js";
+} from "./chunk-j1a7t906.js";
+import {
+  createContext
+} from "./chunk-ppr06jgn.js";
 
 // src/dom/animation.ts
 function onAnimationsComplete(el, callback) {
@@ -417,6 +420,9 @@ var palettes = {
   pink,
   rose
 };
+// src/dom/list-animation-context.ts
+var ListAnimationContext = createContext(undefined, "@vertz/ui::ListAnimationContext");
+
 // src/hydrate/component-registry.ts
 async function resolveComponent(registry, componentId) {
   const loader = registry[componentId];
@@ -547,4 +553,4 @@ function hydrateIslands(registry) {
 // src/query/index.ts
 import { isQueryDescriptor } from "@vertz/fetch";
 
-export { onAnimationsComplete, keyframes, ANIMATION_DURATION, ANIMATION_EASING, fadeIn, fadeOut, zoomIn, zoomOut, slideInFromTop, slideInFromBottom, slideOutToTop, slideOutToBottom, slideInFromLeft, slideInFromRight, slideOutToLeft, slideOutToRight, accordionDown, accordionUp, palettes, resolveComponent, deserializeProps, hydrate, hydrateIslands, isQueryDescriptor };
+export { onAnimationsComplete, keyframes, ANIMATION_DURATION, ANIMATION_EASING, fadeIn, fadeOut, zoomIn, zoomOut, slideInFromTop, slideInFromBottom, slideOutToTop, slideOutToBottom, slideInFromLeft, slideInFromRight, slideOutToLeft, slideOutToRight, accordionDown, accordionUp, palettes, ListAnimationContext, resolveComponent, deserializeProps, hydrate, hydrateIslands, isQueryDescriptor };

package/dist/src/auth/public.js

@@ -1,12 +1,12 @@
 import {
   RouterContext
-} from "../../shared/chunk-f4d5nphq.js";
+} from "../../shared/chunk-7nr2ebrf.js";
 import {
   invalidateTenantQueries
-} from "../../shared/chunk-2eh4p2n7.js";
+} from "../../shared/chunk-09ntccdx.js";
 import {
   isBrowser
-} from "../../shared/chunk-da2w7j7w.js";
+} from "../../shared/chunk-xs5s8gqe.js";
 import {
   _tryOnCleanup,
   computed,
@@ -14,7 +14,7 @@ import {
   getSSRContext,
   signal,
   useContext
-} from "../../shared/chunk-656n0x6y.js";
+} from "../../shared/chunk-ppr06jgn.js";
 
 // src/auth/access-context.ts
 var AccessContext = createContext(undefined, "@vertz/ui::AccessContext");

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

@@ -51,6 +51,7 @@ declare const ContextMenu: ThemeComponentMap["ContextMenu"];
 declare const Sheet: ThemeComponentMap["Sheet"];
 declare const Drawer: ThemeComponentMap["Drawer"];
 declare const Carousel: ThemeComponentMap["Carousel"];
+declare const List: ThemeComponentMap["List"];
 declare const Calendar: ThemeComponentMap["Calendar"];
 declare const Checkbox: ThemeComponentMap["Checkbox"];
 declare const Switch: ThemeComponentMap["Switch"];
@@ -67,4 +68,4 @@ declare const NavigationMenu: ThemeComponentMap["NavigationMenu"];
 declare const ResizablePanel: ThemeComponentMap["ResizablePanel"];
 declare const ScrollArea: ThemeComponentMap["ScrollArea"];
 declare const ToggleGroup: ThemeComponentMap["ToggleGroup"];
-export { Tooltip, ToggleGroup, Toggle, Toast, ThemeComponentMap, Textarea, Tabs, Table, Switch, Slider, Skeleton, Sheet, Separator, Select, ScrollArea, ResizablePanel, RadioGroup, Progress, Popover, Pagination, NavigationMenu, Menubar, Label, Input, HoverCard, FormGroup, EmptyState, DropdownMenu, Drawer, Dialog, DatePicker, ContextMenu, Command, Collapsible, Checkbox, Carousel, Card, Calendar, Button, Breadcrumb, Badge, Avatar, Alert, Accordion };
+export { Tooltip, ToggleGroup, Toggle, Toast, ThemeComponentMap, Textarea, Tabs, Table, Switch, Slider, Skeleton, Sheet, Separator, Select, ScrollArea, ResizablePanel, RadioGroup, Progress, Popover, Pagination, NavigationMenu, Menubar, List, Label, Input, HoverCard, FormGroup, EmptyState, DropdownMenu, Drawer, Dialog, DatePicker, ContextMenu, Command, Collapsible, Checkbox, Carousel, Card, Calendar, Button, Breadcrumb, Badge, Avatar, Alert, Accordion };

package/dist/src/components/index.js

@@ -145,6 +145,10 @@ var Drawer = /* @__PURE__ */ createCompoundProxy("Drawer", [
   "Handle"
 ]);
 var Carousel = /* @__PURE__ */ createCompoundProxy("Carousel", ["Slide", "Previous", "Next"]);
+var List = /* @__PURE__ */ createCompoundProxy("List", [
+  "Item",
+  "DragHandle"
+]);
 var Calendar = /* @__PURE__ */ createPrimitiveProxy("Calendar");
 var Checkbox = /* @__PURE__ */ createPrimitiveProxy("Checkbox");
 var Switch = /* @__PURE__ */ createPrimitiveProxy("Switch");
@@ -193,6 +197,7 @@ export {
   Pagination,
   NavigationMenu,
   Menubar,
+  List,
   Label,
   Input,
   HoverCard,

package/dist/src/css/public.js

@@ -8,11 +8,10 @@ import {
   globalCss,
   s,
   variants
-} from "../../shared/chunk-t3rnfxc0.js";
-import"../../shared/chunk-mbnda3pv.js";
+} from "../../shared/chunk-j1a7t906.js";
+import"../../shared/chunk-djvarb8r.js";
 import"../../shared/chunk-h1fsr8kv.js";
-import"../../shared/chunk-2y9f9j62.js";
-import"../../shared/chunk-656n0x6y.js";
+import"../../shared/chunk-ppr06jgn.js";
 export {
   variants,
   s,

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

@@ -156,6 +156,17 @@ interface FormOptions<
 	onError?: (errors: Record<string, string>) => void;
 	/** When true, reset the form after a successful submission. */
 	resetOnSuccess?: boolean;
+	/**
+	* Controls when fields with errors are re-validated after the first form submission.
+	*
+	* - `'blur'` (default) — Re-validates flagged fields when the user blurs them.
+	* - `'change'` — Re-validates flagged fields on every input/change event.
+	* - `'submit'` — No re-validation between submissions; errors only update on submit.
+	*
+	* Re-validation only activates after the first submit attempt. Fields without prior
+	* errors are never re-validated on blur/change (no premature validation).
+	*/
+	revalidateOn?: "submit" | "blur" | "change";
 }
 /**
 * Create a form instance bound to an SDK method.

package/dist/src/form/public.js

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

package/dist/src/index.d.ts

@@ -222,20 +222,6 @@ declare function Foreign({ tag, onReady, html, id, className, style }: ForeignPr
 * ```
 */
 declare function onMount2(callback: () => (() => void) | void): void;
-interface ListTransitionProps<T> {
-	each: T[];
-	keyFn: (item: T, index: number) => string | number;
-	children: (item: T) => Node;
-}
-/**
-* ListTransition component for animated list item enter/exit.
-* New items get `data-presence="enter"`, removed items get `data-presence="exit"`
-* with DOM removal deferred until CSS animation completes.
-*
-* Props are accessed as getters (not destructured) so the compiler-generated
-* reactive getters are tracked by the underlying domEffect.
-*/
-declare function ListTransition<T>(props: ListTransitionProps<T>): DocumentFragment;
 interface PresenceProps {
 	when: boolean;
 	children: () => HTMLElement;
@@ -809,6 +795,31 @@ declare function __enterChildren(el: Element): void;
 */
 declare function __exitChildren(): void;
 /**
+* Lifecycle hooks for list animation (enter/exit/reorder).
+*
+* Provided by `<List animate>` via ListAnimationContext.
+* Consumed by `__listValue()` during reconciliation.
+*/
+interface ListAnimationHooks {
+	/** Called before reconciliation starts. Use to snapshot element rects for FLIP. */
+	onBeforeReconcile: () => void;
+	/** Called after reconciliation finishes. Use to play FLIP animations. */
+	onAfterReconcile: () => void;
+	/** Called when a new item enters (after first render). */
+	onItemEnter: (node: Node, key: string | number) => void;
+	/** Called when an item exits. Must call `done()` when animation finishes so the node can be removed. */
+	onItemExit: (node: Node, key: string | number, done: () => void) => void;
+}
+/**
+* Context for list animation hooks.
+*
+* When provided, `__listValue()` calls these hooks during reconciliation
+* to enable enter/exit animations and FLIP reordering.
+*
+* When not provided, `__listValue()` behaves as a plain keyed list.
+*/
+declare const ListAnimationContext: Context<ListAnimationHooks | undefined>;
+/**
 * Returns true when running in a real browser environment.
 * Returns false on the server, even if `window` exists (DOM shim).
 *
@@ -953,6 +964,17 @@ interface FormOptions<
 	onError?: (errors: Record<string, string>) => void;
 	/** When true, reset the form after a successful submission. */
 	resetOnSuccess?: boolean;
+	/**
+	* Controls when fields with errors are re-validated after the first form submission.
+	*
+	* - `'blur'` (default) — Re-validates flagged fields when the user blurs them.
+	* - `'change'` — Re-validates flagged fields on every input/change event.
+	* - `'submit'` — No re-validation between submissions; errors only update on submit.
+	*
+	* Re-validation only activates after the first submit attempt. Fields without prior
+	* errors are never re-validated on blur/change (no premature validation).
+	*/
+	revalidateOn?: "submit" | "blur" | "change";
 }
 /**
 * Create a form instance bound to an SDK method.
@@ -1238,35 +1260,6 @@ declare function query<
 	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
-> {
-	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<
-	T,
-	E
->(queryResult: QueryResult<T, E>, handlers: QueryMatchHandlers<T, E>): HTMLElement & {
-	dispose: DisposeFn;
-};
 /**
 * Template literal type utility that extracts route parameter names from a path pattern.
 *
@@ -2081,4 +2074,4 @@ interface RegisterThemeInput {
 * ```
 */
 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 };
+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, 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, QueryEnvelopeStore, QueryEnvelope, QueryDescriptor3 as QueryDescriptor, PresenceProps, Presence, PreloadItem, PathWithParams, ParamSchema, OutletContextValue, OutletContext, Outlet, NavigateOptions, NavigateInput, MountOptions, MountHandle, MergeSelectOptions, MatchedRoute, LoaderData, ListAnimationHooks, ListAnimationContext, 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 };

package/dist/src/index.js

@@ -4,6 +4,7 @@ import {
 import {
   ANIMATION_DURATION,
   ANIMATION_EASING,
+  ListAnimationContext,
   accordionDown,
   accordionUp,
   fadeIn,
@@ -24,7 +25,7 @@ import {
   slideOutToTop,
   zoomIn,
   zoomOut
-} from "../shared/chunk-18frwfc4.js";
+} from "../shared/chunk-ymc3wwam.js";
 import {
   ErrorBoundary,
   Link,
@@ -35,16 +36,16 @@ import {
   getCurrentErrorHandler,
   parseSearchParams,
   useSearchParams
-} from "../shared/chunk-2wag9c7v.js";
+} from "../shared/chunk-2krx4aqe.js";
 import {
   beginDeferringMounts,
   discardDeferredMounts,
   flushDeferredMounts,
   onMount
-} from "../shared/chunk-ge2e6y2s.js";
+} from "../shared/chunk-svvqjmyy.js";
 import {
   createRouter
-} from "../shared/chunk-jtma4sh4.js";
+} from "../shared/chunk-e09mdqcx.js";
 import {
   defineRoutes
 } from "../shared/chunk-am9zaw4h.js";
@@ -53,7 +54,7 @@ import {
   form,
   formDataToObject,
   validate
-} from "../shared/chunk-4gmtsf6v.js";
+} from "../shared/chunk-h2sjma78.js";
 import {
   EntityStore,
   FieldSelectionTracker,
@@ -63,10 +64,9 @@ import {
   getQueryEnvelopeStore,
   getRelationSchema,
   query,
-  queryMatch,
   registerRelationSchema,
   resetRelationSchemas_TEST_ONLY
-} from "../shared/chunk-4gen306a.js";
+} from "../shared/chunk-1jgws7rs.js";
 import"../shared/chunk-jrtrk5z4.js";
 import {
   ThemeProvider,
@@ -83,35 +83,33 @@ import {
   resolveChildren,
   s,
   variants
-} from "../shared/chunk-t3rnfxc0.js";
+} from "../shared/chunk-j1a7t906.js";
 import {
+  RENDER_NODE_BRAND,
   __append,
   __element,
   __enterChildren,
   __exitChildren,
   __insert,
-  __staticText
-} from "../shared/chunk-mbnda3pv.js";
-import"../shared/chunk-h1fsr8kv.js";
-import {
-  RENDER_NODE_BRAND,
+  __staticText,
   createDOMAdapter,
   getAdapter,
   isRenderNode,
   setAdapter
-} from "../shared/chunk-2y9f9j62.js";
+} from "../shared/chunk-djvarb8r.js";
+import"../shared/chunk-h1fsr8kv.js";
 import {
   RouterContext,
   useParams,
   useRouter
-} from "../shared/chunk-f4d5nphq.js";
+} from "../shared/chunk-7nr2ebrf.js";
 import {
   invalidate,
   invalidateTenantQueries
-} from "../shared/chunk-2eh4p2n7.js";
+} from "../shared/chunk-09ntccdx.js";
 import {
   isBrowser
-} from "../shared/chunk-da2w7j7w.js";
+} from "../shared/chunk-xs5s8gqe.js";
 import {
   DisposalScopeError,
   _tryOnCleanup,
@@ -136,7 +134,7 @@ import {
   startHydration,
   untrack,
   useContext
-} from "../shared/chunk-656n0x6y.js";
+} from "../shared/chunk-ppr06jgn.js";
 // src/component/default-error-fallback.ts
 function DefaultErrorFallback({ error, retry }) {
   const container = document.createElement("div");
@@ -207,188 +205,6 @@ function Foreign({
   }
   return el;
 }
-// src/dom/list-transition.ts
-function createItemProxy(itemSignal) {
-  if (typeof itemSignal.peek() !== "object" || itemSignal.peek() == null) {
-    return itemSignal.peek();
-  }
-  return new Proxy({}, {
-    get(_target, prop, receiver) {
-      const current = itemSignal.value;
-      if (current == null)
-        return;
-      const value = Reflect.get(current, prop, receiver);
-      if (typeof value === "function") {
-        return value.bind(current);
-      }
-      return value;
-    },
-    has(_target, prop) {
-      const current = itemSignal.value;
-      if (current == null)
-        return false;
-      return Reflect.has(current, prop);
-    },
-    ownKeys() {
-      const current = itemSignal.value;
-      if (current == null)
-        return [];
-      return Reflect.ownKeys(current);
-    },
-    getOwnPropertyDescriptor(_target, prop) {
-      const current = itemSignal.value;
-      if (current == null)
-        return;
-      return Reflect.getOwnPropertyDescriptor(current, prop);
-    }
-  });
-}
-function listTransition(startMarker, endMarker, items, keyFn, renderFn) {
-  const getItems = typeof items === "function" ? items : () => items.value;
-  const nodeMap = new Map;
-  const scopeMap = new Map;
-  const itemSignalMap = new Map;
-  const exitingNodes = new Set;
-  const exitingKeyMap = new Map;
-  const keyGeneration = new Map;
-  let isFirstRun = true;
-  const outerScope = pushScope();
-  try {
-    domEffect(() => {
-      const newItems = getItems() ?? [];
-      const newKeySet = new Set(newItems.map((item, i) => keyFn(item, i)));
-      if (isFirstRun) {
-        isFirstRun = false;
-        for (const [i, item] of newItems.entries()) {
-          const key = keyFn(item, i);
-          const itemSig = signal(item);
-          const proxy = createItemProxy(itemSig);
-          const scope = pushScope();
-          const node = renderFn(proxy);
-          popScope();
-          nodeMap.set(key, node);
-          scopeMap.set(key, scope);
-          itemSignalMap.set(key, itemSig);
-          endMarker.parentNode?.insertBefore(node, endMarker);
-        }
-        return;
-      }
-      for (const [key, node] of nodeMap) {
-        if (!newKeySet.has(key)) {
-          const scope = scopeMap.get(key);
-          if (scope) {
-            runCleanups(scope);
-            scopeMap.delete(key);
-          }
-          nodeMap.delete(key);
-          itemSignalMap.delete(key);
-          const gen = (keyGeneration.get(key) ?? 0) + 1;
-          keyGeneration.set(key, gen);
-          exitingNodes.add(node);
-          exitingKeyMap.set(key, node);
-          if (node instanceof Element) {
-            node.setAttribute("data-presence", "exit");
-            onAnimationsComplete(node, () => {
-              if (keyGeneration.get(key) === gen) {
-                node.parentNode?.removeChild(node);
-                exitingNodes.delete(node);
-                exitingKeyMap.delete(key);
-              }
-            });
-          } else {
-            node.parentNode?.removeChild(node);
-            exitingNodes.delete(node);
-            exitingKeyMap.delete(key);
-          }
-        }
-      }
-      const desiredNodes = [];
-      const enterNodes = [];
-      for (const [i, item] of newItems.entries()) {
-        const key = keyFn(item, i);
-        let node = nodeMap.get(key);
-        if (!node) {
-          const oldExiting = exitingKeyMap.get(key);
-          if (oldExiting) {
-            oldExiting.parentNode?.removeChild(oldExiting);
-            exitingNodes.delete(oldExiting);
-            exitingKeyMap.delete(key);
-          }
-          const gen = (keyGeneration.get(key) ?? 0) + 1;
-          keyGeneration.set(key, gen);
-          const itemSig = signal(item);
-          const proxy = createItemProxy(itemSig);
-          const scope = pushScope();
-          node = renderFn(proxy);
-          popScope();
-          nodeMap.set(key, node);
-          scopeMap.set(key, scope);
-          itemSignalMap.set(key, itemSig);
-          if (node instanceof Element)
-            node.setAttribute("data-presence", "enter");
-          enterNodes.push({ node, key });
-        } else {
-          const itemSig = itemSignalMap.get(key);
-          if (itemSig) {
-            itemSig.value = item;
-          }
-        }
-        desiredNodes.push(node);
-      }
-      const parent = startMarker.parentNode;
-      if (parent) {
-        let cursor = startMarker.nextSibling;
-        for (const desired of desiredNodes) {
-          while (cursor && cursor !== endMarker && exitingNodes.has(cursor)) {
-            cursor = cursor.nextSibling;
-          }
-          if (cursor === desired) {
-            cursor = cursor.nextSibling;
-          } else {
-            parent.insertBefore(desired, cursor);
-          }
-        }
-      }
-      for (const { node: enterNode, key } of enterNodes) {
-        if (!(enterNode instanceof Element))
-          continue;
-        onAnimationsComplete(enterNode, () => {
-          if (nodeMap.get(key) === enterNode) {
-            enterNode.removeAttribute("data-presence");
-          }
-        });
-      }
-    });
-  } finally {
-    popScope();
-  }
-  const dispose = () => {
-    for (const scope of scopeMap.values()) {
-      runCleanups(scope);
-    }
-    scopeMap.clear();
-    for (const node of exitingNodes) {
-      node.parentNode?.removeChild(node);
-    }
-    exitingNodes.clear();
-    exitingKeyMap.clear();
-    runCleanups(outerScope);
-  };
-  _tryOnCleanup(dispose);
-  return dispose;
-}
-
-// src/component/list-transition.ts
-function ListTransition(props) {
-  const startMarker = document.createComment("lt-start");
-  const endMarker = document.createComment("lt-end");
-  const fragment = document.createDocumentFragment();
-  fragment.appendChild(startMarker);
-  fragment.appendChild(endMarker);
-  const dispose = listTransition(startMarker, endMarker, () => props.each, props.keyFn, props.children);
-  _tryOnCleanup(dispose);
-  return Object.assign(fragment, { dispose });
-}
 // src/component/presence.ts
 function Presence(props) {
   const anchor = document.createComment("presence");
@@ -1112,7 +928,6 @@ export {
   registerTheme,
   registerRelationSchema,
   ref,
-  queryMatch,
   query,
   parseSearchParams,
   palettes,
@@ -1176,7 +991,7 @@ export {
   Presence,
   OutletContext,
   Outlet,
-  ListTransition,
+  ListAnimationContext,
   Link,
   Island,
   Image,

package/dist/src/internals.d.ts

@@ -387,6 +387,10 @@ interface DisposableText extends Text {
 * Returns a Text node with a `dispose` property for cleanup.
 */
 declare function __text(fn: () => string): DisposableText;
+/** A Node that also carries a dispose function for cleanup. */
+interface DisposableChild extends Node {
+	dispose: DisposeFn;
+}
 /**
 * Create a reactive child node that updates when dependencies change.
 * Unlike __text(), this handles both Node values (appended directly)
@@ -395,11 +399,12 @@ declare function __text(fn: () => string): DisposableText;
 * This prevents HTMLElements from being stringified to "[object HTMLElement]"
 * when used as JSX expression children like {someElement}.
 *
-* Returns a wrapper element with `display: contents` and a `dispose` property.
+* Uses a comment anchor (<!--child-->) with sibling-based content management.
+* Content nodes are inserted after the anchor and tracked for cleanup.
+* Returns a DocumentFragment (CSR) or the claimed comment (hydration),
+* with a `dispose` property for lifecycle management.
 */
-declare function __child(fn: () => Node | string | number | boolean | null | undefined): HTMLElement & {
-	dispose: DisposeFn;
-};
+declare function __child(fn: () => Node | string | number | boolean | null | undefined): DisposableChild;
 /**
 * Insert a static (non-reactive) child value into a parent node.
 * This is used for static JSX expression children to avoid the performance
@@ -492,6 +497,47 @@ declare function clearChildren(container: Node): void;
 */
 declare function __list<T>(container: HTMLElement, items: Signal<T[]> | (() => T[]), keyFn: ((item: T, index: number) => string | number) | null, renderFn: (item: T) => Node): DisposeFn;
 /**
+* Lifecycle hooks for list animation (enter/exit/reorder).
+*
+* Provided by `<List animate>` via ListAnimationContext.
+* Consumed by `__listValue()` during reconciliation.
+*/
+interface ListAnimationHooks {
+	/** Called before reconciliation starts. Use to snapshot element rects for FLIP. */
+	onBeforeReconcile: () => void;
+	/** Called after reconciliation finishes. Use to play FLIP animations. */
+	onAfterReconcile: () => void;
+	/** Called when a new item enters (after first render). */
+	onItemEnter: (node: Node, key: string | number) => void;
+	/** Called when an item exits. Must call `done()` when animation finishes so the node can be removed. */
+	onItemExit: (node: Node, key: string | number, done: () => void) => void;
+}
+/**
+* Context for list animation hooks.
+*
+* When provided, `__listValue()` calls these hooks during reconciliation
+* to enable enter/exit animations and FLIP reordering.
+*
+* When not provided, `__listValue()` behaves as a plain keyed list.
+*/
+declare const ListAnimationContext: Context<ListAnimationHooks | undefined>;
+/**
+* Keyed list reconciliation that returns a DisposableNode (DocumentFragment).
+*
+* Unlike `__list()` which appends to an existing container element,
+* `__listValue()` manages items between comment markers in a DocumentFragment.
+* This makes it suitable for use in component children thunks where there is
+* no parent element variable at compile time.
+*
+* Compiler output target for .map() expressions in component children JSX.
+*
+* @param items - A signal or getter function containing the array of items
+* @param keyFn - Extracts a unique key from each item. Pass null for unkeyed mode.
+* @param renderFn - Creates a DOM node for an item (called once per key)
+* @returns A DisposableNode (DocumentFragment with dispose method)
+*/
+declare function __listValue<T>(items: Signal<T[]> | (() => T[]), keyFn: ((item: T, index: number) => string | number) | null, renderFn: (item: T) => Node): DisposableNode;
+/**
 * Apply a spread props object to a DOM element.
 *
 * Compiler output target for JSX spread attributes on intrinsic elements:
@@ -1122,4 +1168,4 @@ declare function getSSRContext(): SSRRenderContext | undefined;
 * clears during HMR module re-evaluation.
 */
 declare function hasSSRResolver(): boolean;
-export { stopSignalCollection, startSignalCollection, setContextScope, setAdapter, runCleanups, resolveComponent, removeNode, registerSSRResolver, pushScope, popScope, onCleanup, onAnimationsComplete, matchRoute, matchPath, lifecycleEffect, isRenderNode, isBrowser, insertBefore, hasSSRResolver, getSSRContext, getContextScope, getAdapter, executeLoaders, domEffect, deserializeProps, deriveKey, createDOMAdapter, compileTheme, clearChildren, _tryOnCleanup, __text, styleObjectToString as __styleStr, __staticText, __spread, __show, __pushMountFrame, __prop, __on, __list, __insert, __flushMountFrame, __exitChildren, __enterChildren, __element, __discardMountFrame, __conditional, __classList, __child, __attr, __append, SSRRenderContext, SSRQueryEntry, SSRAuth, SPACING_SCALE, SIZE_KEYWORDS, SHADOW_SCALE, RenderText, RenderNode, RenderElement, RenderAdapter, RENDER_NODE_BRAND, RADIUS_SCALE, QueryEnvelopeStore, PropertyMapping, PSEUDO_PREFIXES, PSEUDO_MAP, PROPERTY_MAP, MemoryCache, MatchResult, LINE_HEIGHT_SCALE, KEYWORD_MAP, HEIGHT_AXIS_PROPERTIES, FONT_WEIGHT_SCALE, FONT_SIZE_SCALE, EntityStore, DISPLAY_MAP, CSS_COLOR_KEYWORDS, CSSDeclarationEntry, CONTENT_MAP, COLOR_NAMESPACES, ALIGNMENT_MAP };
+export { stopSignalCollection, startSignalCollection, setContextScope, setAdapter, runCleanups, resolveComponent, removeNode, registerSSRResolver, pushScope, popScope, onCleanup, onAnimationsComplete, matchRoute, matchPath, lifecycleEffect, isRenderNode, isBrowser, insertBefore, hasSSRResolver, getSSRContext, getContextScope, getAdapter, executeLoaders, domEffect, deserializeProps, deriveKey, createDOMAdapter, compileTheme, clearChildren, _tryOnCleanup, __text, styleObjectToString as __styleStr, __staticText, __spread, __show, __pushMountFrame, __prop, __on, __listValue, __list, __insert, __flushMountFrame, __exitChildren, __enterChildren, __element, __discardMountFrame, __conditional, __classList, __child, __attr, __append, SSRRenderContext, SSRQueryEntry, SSRAuth, SPACING_SCALE, SIZE_KEYWORDS, SHADOW_SCALE, RenderText, RenderNode, RenderElement, RenderAdapter, RENDER_NODE_BRAND, RADIUS_SCALE, QueryEnvelopeStore, PropertyMapping, PSEUDO_PREFIXES, PSEUDO_MAP, PROPERTY_MAP, MemoryCache, MatchResult, ListAnimationHooks, ListAnimationContext, 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 };