@moldable-ai/ui 0.2.20 → 0.2.22

package/dist/components/ui/input-group.d.ts

@@ -7,7 +7,7 @@ declare const inputGroupAddonVariants: (props?: ({
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function InputGroupAddon({ className, align, ...props }: React.ComponentProps<'div'> & VariantProps<typeof inputGroupAddonVariants>): import("react/jsx-runtime").JSX.Element;
 declare const inputGroupButtonVariants: (props?: ({
-    size?: "xs" | "sm" | "icon-xs" | "icon-sm" | null | undefined;
+    size?: "sm" | "xs" | "icon-xs" | "icon-sm" | null | undefined;
 } & import("class-variance-authority/types").ClassProp) | undefined) => string;
 declare function InputGroupButton({ className, type, variant, size, ...props }: Omit<React.ComponentProps<typeof Button>, 'size'> & VariantProps<typeof inputGroupButtonVariants>): import("react/jsx-runtime").JSX.Element;
 declare function InputGroupText({ className, ...props }: React.ComponentProps<'span'>): import("react/jsx-runtime").JSX.Element;

package/dist/components/ui/list.d.ts

@@ -11,6 +11,10 @@ type ListProps = Omit<React.ComponentProps<'div'>, 'defaultValue' | 'onChange'>
     disabled?: boolean;
 };
 declare function List({ className, children, selectionMode, selectedValues, defaultSelectedValues, onSelectionChange, onAction, orientation, loop, disabled, role, onKeyDown, ref, ...props }: ListProps): import("react/jsx-runtime").JSX.Element;
+type ListSectionProps = Omit<React.ComponentProps<'div'>, 'role'>;
+declare function ListSection({ className, children, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, ...props }: ListSectionProps): import("react/jsx-runtime").JSX.Element;
+type ListSectionHeaderProps = Omit<React.ComponentProps<'div'>, 'id'>;
+declare function ListSectionHeader({ className, ...props }: ListSectionHeaderProps): import("react/jsx-runtime").JSX.Element;
 type ListItemProps = Omit<React.ComponentProps<'div'>, 'value'> & {
     value: string;
     disabled?: boolean;
@@ -20,5 +24,5 @@ declare function ListItemContent({ className, ...props }: React.ComponentProps<'
 declare function ListItemTitle({ className, ...props }: React.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
 declare function ListItemDescription({ className, ...props }: React.ComponentProps<'p'>): import("react/jsx-runtime").JSX.Element;
 declare function ListItemActions({ className, ...props }: React.ComponentProps<'div'>): import("react/jsx-runtime").JSX.Element;
-export { List, ListItem, ListItemActions, ListItemContent, ListItemDescription, ListItemTitle, type ListProps, type ListSelectionMode, };
+export { List, ListItem, ListItemActions, ListItemContent, ListItemDescription, ListItemTitle, ListSection, ListSectionHeader, type ListProps, type ListSectionHeaderProps, type ListSectionProps, type ListSelectionMode, };
 //# sourceMappingURL=list.d.ts.map

package/dist/components/ui/list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/components/ui/list.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAG9B,KAAK,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;AAmDvD,KAAK,SAAS,GAAG,IAAI,CACnB,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAC3B,cAAc,GAAG,UAAU,CAC5B,GAAG;IACF,aAAa,CAAC,EAAE,iBAAiB,CAAA;IACjC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACjC,qBAAqB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACxC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAA;IACzD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,iBAAS,IAAI,CAAC,EACZ,SAAS,EACT,QAAQ,EACR,aAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,QAAQ,EACR,WAAwB,EACxB,IAAY,EACZ,QAAgB,EAChB,IAAI,EACJ,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,SAAS,2CAsMX;AAED,KAAK,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,GAAG;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,QAAQ,EACR,KAAK,EACL,QAAgB,EAChB,OAAO,EACP,aAAa,EACb,OAAO,EACP,GAAG,EACH,IAAI,EACJ,GAAG,KAAK,EACT,EAAE,aAAa,2CAmFf;AAED,iBAAS,eAAe,CAAC,EACvB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,2CAQ7B;AAED,iBAAS,aAAa,CAAC,EACrB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,2CAQ7B;AAED,iBAAS,mBAAmB,CAAC,EAC3B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,2CAQ3B;AAED,iBAAS,eAAe,CAAC,EACvB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,2CAQ7B;AAED,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,KAAK,SAAS,EACd,KAAK,iBAAiB,GACvB,CAAA"}
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/components/ui/list.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAO9B,KAAK,iBAAiB,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAA;AA+CvD,KAAK,SAAS,GAAG,IAAI,CACnB,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAC3B,cAAc,GAAG,UAAU,CAC5B,GAAG;IACF,aAAa,CAAC,EAAE,iBAAiB,CAAA;IACjC,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACjC,qBAAqB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAA;IACxC,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,KAAK,IAAI,CAAA;IACzD,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAClC,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAA;IACvC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,iBAAS,IAAI,CAAC,EACZ,SAAS,EACT,QAAQ,EACR,aAAsB,EACtB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,QAAQ,EACR,WAAwB,EACxB,IAAY,EACZ,QAAgB,EAChB,IAAI,EACJ,SAAS,EACT,GAAG,EACH,GAAG,KAAK,EACT,EAAE,SAAS,2CAoMX;AAED,KAAK,gBAAgB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;AAEjE,iBAAS,WAAW,CAAC,EACnB,SAAS,EACT,QAAQ,EACR,YAAY,EAAE,SAAS,EACvB,iBAAiB,EAAE,cAAc,EACjC,GAAG,KAAK,EACT,EAAE,gBAAgB,2CAiBlB;AAED,KAAK,sBAAsB,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAA;AAErE,iBAAS,iBAAiB,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,sBAAsB,2CAiBzE;AAED,KAAK,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,GAAG;IAChE,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,iBAAS,QAAQ,CAAC,EAChB,SAAS,EACT,QAAQ,EACR,KAAK,EACL,QAAgB,EAChB,OAAO,EACP,aAAa,EACb,OAAO,EACP,GAAG,EACH,IAAI,EACJ,GAAG,KAAK,EACT,EAAE,aAAa,2CA+Ef;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,2CAQ5E;AAED,iBAAS,aAAa,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,2CAQ1E;AAED,iBAAS,mBAAmB,CAAC,EAC3B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,KAAK,CAAC,cAAc,CAAC,GAAG,CAAC,2CAQ3B;AAED,iBAAS,eAAe,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,2CAQ5E;AAED,OAAO,EACL,IAAI,EACJ,QAAQ,EACR,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,KAAK,SAAS,EACd,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,CAAA"}

package/dist/components/ui/list.js

@@ -2,7 +2,9 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import * as React from 'react';
 import { cn } from '../../lib/utils';
+import { getCollectionItemsInDomOrder, isInteractiveDescendant, } from './collection-navigation';
 const ListContext = React.createContext(null);
+const ListSectionContext = React.createContext(null);
 function useListContext(component) {
     const context = React.useContext(ListContext);
     if (!context) {
@@ -22,11 +24,6 @@ function sameSelection(a, b) {
     }
     return true;
 }
-function isInteractiveDescendant(target, currentTarget) {
-    if (!(target instanceof HTMLElement) || target === currentTarget)
-        return false;
-    return Boolean(target.closest('a,button,input,select,textarea,[contenteditable="true"],[role="button"],[role="link"]'));
-}
 function List({ className, children, selectionMode = 'none', selectedValues, defaultSelectedValues, onSelectionChange, onAction, orientation = 'vertical', loop = false, disabled = false, role, onKeyDown, ref, ...props }) {
     const rootRef = React.useRef(null);
     const itemsRef = React.useRef(new Map());
@@ -45,18 +42,21 @@ function List({ className, children, selectionMode = 'none', selectedValues, def
         if (!node)
             return () => undefined;
         itemsRef.current.set(value, { node, disabled: itemDisabled });
-        if (!disabled && !itemDisabled) {
-            setActiveValueState((current) => current ?? value);
-        }
         return () => {
             itemsRef.current.delete(value);
-            setActiveValueState((current) => {
-                if (current !== value)
-                    return current;
-                return ([...itemsRef.current.entries()].find(([, item]) => !disabled && !item.disabled)?.[0] ?? null);
-            });
+            setActiveValueState((current) => (current === value ? null : current));
         };
-    }, [disabled]);
+    }, []);
+    React.useLayoutEffect(() => {
+        const items = getCollectionItemsInDomOrder(itemsRef.current).filter(([, item]) => !disabled && !item.disabled);
+        setActiveValueState((current) => {
+            if (current && items.some(([value]) => value === current))
+                return current;
+            return (items.find(([value]) => selection.has(value))?.[0] ??
+                items[0]?.[0] ??
+                null);
+        });
+    }, [children, disabled, selection]);
     const setActiveValue = React.useCallback((value) => {
         const item = itemsRef.current.get(value);
         if (item && !item.disabled)
@@ -92,7 +92,7 @@ function List({ className, children, selectionMode = 'none', selectedValues, def
         onAction?.(value);
     }, [disabled, onAction]);
     const moveFocus = React.useCallback((direction) => {
-        const items = [...itemsRef.current.entries()].filter(([, item]) => !disabled && !item.disabled);
+        const items = getCollectionItemsInDomOrder(itemsRef.current).filter(([, item]) => !disabled && !item.disabled);
         if (items.length === 0)
             return;
         const currentIndex = items.findIndex(([value]) => value === activeValue);
@@ -168,6 +168,17 @@ function List({ className, children, selectionMode = 'none', selectedValues, def
                 ? 'flex-col gap-0.5'
                 : 'flex-row items-center gap-1', className), onKeyDown: handleKeyDown, ...props, children: children }) }));
 }
+function ListSection({ className, children, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, ...props }) {
+    const headerId = React.useId();
+    return (_jsx(ListSectionContext.Provider, { value: { headerId }, children: _jsx("div", { role: "group", "aria-label": ariaLabel, "aria-labelledby": ariaLabel ? undefined : (ariaLabelledBy ?? headerId), "data-slot": "list-section", className: cn('flex min-w-0 flex-col gap-0.5', className), ...props, children: children }) }));
+}
+function ListSectionHeader({ className, ...props }) {
+    const context = React.useContext(ListSectionContext);
+    if (!context) {
+        throw new Error('ListSectionHeader must be used inside ListSection');
+    }
+    return (_jsx("div", { id: context.headerId, "data-slot": "list-section-header", className: cn('text-muted-foreground px-2.5 py-1 text-xs font-medium', className), ...props }));
+}
 function ListItem({ className, children, value, disabled = false, onClick, onDoubleClick, onFocus, ref, role, ...props }) {
     const context = useListContext('ListItem');
     const { registerItem } = context;
@@ -221,4 +232,4 @@ function ListItemDescription({ className, ...props }) {
 function ListItemActions({ className, ...props }) {
     return (_jsx("div", { "data-slot": "list-item-actions", className: cn('ml-auto flex shrink-0 items-center gap-1', className), ...props }));
 }
-export { List, ListItem, ListItemActions, ListItemContent, ListItemDescription, ListItemTitle, };
+export { List, ListItem, ListItemActions, ListItemContent, ListItemDescription, ListItemTitle, ListSection, ListSectionHeader, };

package/dist/components/ui/material.d.ts

@@ -0,0 +1,34 @@
+import * as React from 'react';
+import { type VariantProps } from 'class-variance-authority';
+declare const materialVariants: (props?: ({
+    shape?: "circle" | "rounded" | "capsule" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export type MaterialVariant = 'regular' | 'clear';
+export type MaterialShape = NonNullable<VariantProps<typeof materialVariants>['shape']>;
+export type MaterialElevation = 'none' | 'panel' | 'overlay';
+export interface MaterialProps extends React.ComponentPropsWithoutRef<'div'>, VariantProps<typeof materialVariants> {
+    /**
+     * `regular` is the default for toolbars and control chrome. Reserve `clear`
+     * for compact controls floating above media or a richly colored canvas.
+     */
+    variant?: MaterialVariant;
+    elevation?: MaterialElevation;
+    interactive?: boolean;
+    asChild?: boolean;
+}
+declare function Material({ asChild, className, elevation, interactive, shape, variant, ...props }: MaterialProps): import("react/jsx-runtime").JSX.Element;
+declare const materialGroupSpacing: {
+    readonly compact: "gap-0.5 p-0.5";
+    readonly default: "gap-1 p-1";
+    readonly comfortable: "gap-1.5 p-1.5";
+};
+export interface MaterialGroupProps extends Omit<MaterialProps, 'asChild' | 'interactive'> {
+    spacing?: keyof typeof materialGroupSpacing;
+}
+/**
+ * A single sampled material layer for a related control cluster. Children
+ * should be ordinary transparent or ghost controls, not nested Materials.
+ */
+declare function MaterialGroup({ className, spacing, ...props }: MaterialGroupProps): import("react/jsx-runtime").JSX.Element;
+export { Material, MaterialGroup, materialVariants };
+//# sourceMappingURL=material.d.ts.map

package/dist/components/ui/material.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material.d.ts","sourceRoot":"","sources":["../../../src/components/ui/material.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,EAAE,KAAK,YAAY,EAAO,MAAM,0BAA0B,CAAA;AAEjE,QAAA,MAAM,gBAAgB;;8EAWpB,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,OAAO,CAAA;AACjD,MAAM,MAAM,aAAa,GAAG,WAAW,CACrC,YAAY,CAAC,OAAO,gBAAgB,CAAC,CAAC,OAAO,CAAC,CAC/C,CAAA;AACD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;AAE5D,MAAM,WAAW,aACf,SAAQ,KAAK,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAC3C,YAAY,CAAC,OAAO,gBAAgB,CAAC;IACvC;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAC7B,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,iBAAS,QAAQ,CAAC,EAChB,OAAe,EACf,SAAS,EACT,SAAmB,EACnB,WAAmB,EACnB,KAAK,EACL,OAAmB,EACnB,GAAG,KAAK,EACT,EAAE,aAAa,2CAcf;AAED,QAAA,MAAM,oBAAoB;;;;CAIhB,CAAA;AAEV,MAAM,WAAW,kBACf,SAAQ,IAAI,CAAC,aAAa,EAAE,SAAS,GAAG,aAAa,CAAC;IACtD,OAAO,CAAC,EAAE,MAAM,OAAO,oBAAoB,CAAA;CAC5C;AAED;;;GAGG;AACH,iBAAS,aAAa,CAAC,EACrB,SAAS,EACT,OAAmB,EACnB,GAAG,KAAK,EACT,EAAE,kBAAkB,2CAYpB;AAED,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/components/ui/material.js

@@ -0,0 +1,34 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Slot } from '@radix-ui/react-slot';
+import { cn } from '../../lib/utils';
+import { cva } from 'class-variance-authority';
+const materialVariants = cva('moldable-material border text-inherit', {
+    variants: {
+        shape: {
+            rounded: 'rounded-overlay',
+            capsule: 'rounded-full',
+            circle: 'aspect-square rounded-full',
+        },
+    },
+    defaultVariants: {
+        shape: 'rounded',
+    },
+});
+function Material({ asChild = false, className, elevation = 'panel', interactive = false, shape, variant = 'regular', ...props }) {
+    const Comp = asChild ? Slot : 'div';
+    return (_jsx(Comp, { "data-slot": asChild ? undefined : 'material', "data-material": variant, "data-material-elevation": elevation, "data-material-interactive": interactive || undefined, "data-material-shape": shape ?? 'rounded', className: cn(materialVariants({ shape }), className), ...props }));
+}
+const materialGroupSpacing = {
+    compact: 'gap-0.5 p-0.5',
+    default: 'gap-1 p-1',
+    comfortable: 'gap-1.5 p-1.5',
+};
+/**
+ * A single sampled material layer for a related control cluster. Children
+ * should be ordinary transparent or ghost controls, not nested Materials.
+ */
+function MaterialGroup({ className, spacing = 'default', ...props }) {
+    return (_jsx(Material, { "data-slot": "material-group", className: cn('inline-flex min-w-0 items-center', materialGroupSpacing[spacing], className), ...props }));
+}
+export { Material, MaterialGroup, materialVariants };

package/dist/components/ui/message-scroller-controller.d.ts

@@ -0,0 +1,162 @@
+import { MessageScrollerPolicy } from './message-scroller-policy';
+export type MessageScrollerDefaultScrollPosition = 'start' | 'end' | 'last-anchor';
+export type MessageScrollerScrollAlign = 'start' | 'center' | 'end' | 'nearest';
+export type MessageScrollerScrollOptions = {
+    align?: MessageScrollerScrollAlign;
+    behavior?: ScrollBehavior;
+    scrollMargin?: number;
+};
+export type MessageScrollerScrollable = {
+    start: boolean;
+    end: boolean;
+};
+export type MessageScrollerVisibilityState = {
+    currentAnchorId: string | null;
+    visibleMessageIds: string[];
+};
+export interface MessageScrollerControllerOptions {
+    autoScroll: boolean;
+    defaultScrollPosition: MessageScrollerDefaultScrollPosition;
+    scrollEdgeThreshold: number;
+    scrollPreviousItemPeek: number;
+    scrollMargin: number;
+}
+export interface ExternalStore<T> {
+    getSnapshot: () => T;
+    hasListeners: () => boolean;
+    setSnapshot: (next: T) => void;
+    subscribe: (listener: () => void, onFirst?: () => void, onLast?: () => void) => () => void;
+}
+export declare function createExternalStore<T>(initial: T, isEqual: (a: T, b: T) => boolean): ExternalStore<T>;
+export type ReadingLeaf = {
+    element: HTMLElement;
+    top: number;
+    bottom: number;
+};
+export declare function isMessageScrollerAtEnd(viewport: HTMLElement, threshold: number): boolean;
+/**
+ * Snapshot of the stable leaves the reader can currently see, preferring
+ * fine-grained `[data-message-scroll-anchor]` leaves (their tops do not move
+ * when a disclosure collapses inside the same message) over whole items.
+ */
+export declare function captureReadingLeaves(viewport: HTMLElement, content: HTMLElement, items: HTMLElement[]): ReadingLeaf[];
+/**
+ * Re-pins the first still-visible captured leaf after content above it
+ * changed size. Native scroll anchoring may already have compensated; the
+ * measured delta is zero then and this is deliberately a no-op.
+ */
+export declare function restoreReadingLeaves(viewport: HTMLElement, leaves: readonly ReadingLeaf[]): boolean;
+/**
+ * The single DOM-side owner of transcript scrolling. Every behavior that can
+ * move the viewport — follow-the-end, turn anchoring, prepend preservation,
+ * reading-position stability while rows above collapse — routes through this
+ * controller and its {@link MessageScrollerPolicy}, so nothing here can fight
+ * the reader (or another controller) for the scroll position.
+ */
+export declare class MessageScrollerController {
+    readonly scrollableStore: ExternalStore<MessageScrollerScrollable>;
+    readonly visibilityStore: ExternalStore<MessageScrollerVisibilityState>;
+    policy: MessageScrollerPolicy;
+    options: MessageScrollerControllerOptions;
+    preserveScrollOnPrepend: boolean;
+    private root;
+    private viewport;
+    private content;
+    private spacer;
+    private readonly messageElements;
+    private readonly handledTurnAnchors;
+    private readonly visibleMessageIds;
+    private readonly warmedItems;
+    private lastScrollTop;
+    private previousFirstItem;
+    private previousItemCount;
+    private anchoredElement;
+    private trackedFirstVisible;
+    private readingLeaves;
+    private pendingScrollToMessage;
+    private defaultPositionApplied;
+    private spacerHeight;
+    private spacerGap;
+    private programmaticDeadline;
+    private stateFrame;
+    private visibilityFrame;
+    private warmupHandle;
+    private warmupUsesIdleCallback;
+    private intersectionObserver;
+    constructor(options: MessageScrollerControllerOptions);
+    get viewportElement(): HTMLElement | null;
+    setRoot(element: HTMLElement | null): void;
+    setViewport(element: HTMLElement | null): void;
+    setContent(element: HTMLElement | null): void;
+    setSpacer(element: HTMLElement | null): void;
+    registerMessage(messageId: string, element: HTMLElement | null, previous: HTMLElement | null): void;
+    scrollToEnd: (options?: MessageScrollerScrollOptions) => boolean;
+    scrollToStart: (options?: MessageScrollerScrollOptions) => boolean;
+    scrollToMessage: (messageId: string, options?: MessageScrollerScrollOptions) => boolean;
+    scrollToElement(element: HTMLElement, options?: MessageScrollerScrollOptions, { keepPreviousPeek }?: {
+        keepPreviousPeek?: boolean;
+    }): boolean;
+    handleScroll(): void;
+    handleWheel(deltaY: number): void;
+    handleTouchMove(): void;
+    handleScrollKey(): void;
+    /**
+     * Content box resized (streaming growth, images decoding, disclosures
+     * collapsing, `content-visibility` reveals). Which way the viewport moves
+     * — if at all — is entirely the policy's call.
+     */
+    handleResize(): void;
+    /** Children of the content element changed. Runs before the next paint. */
+    handleContentMutation(): void;
+    observeVisibility(): void;
+    unobserveVisibility(): void;
+    resetDefaultPosition(): void;
+    updateOptions(options: MessageScrollerControllerOptions): void;
+    destroy(): void;
+    private applyDefaultPosition;
+    private anchorTurn;
+    private markTurnAnchorsHandled;
+    /**
+     * Older rows were inserted above the reader. Compensate the scroll offset
+     * by the tracked first-visible row's displacement in the same mutation
+     * pass, before the shifted layout can paint.
+     */
+    private preservePrependPosition;
+    private performScroll;
+    /**
+     * Snapshot of stable leaves the reader can see. When a disclosure above
+     * them collapses (or a hidden row re-measures), the first still-visible
+     * leaf is re-pinned so the text under the reader's eyes never shifts.
+     */
+    private snapshotReadingLeaves;
+    private restoreReadingPosition;
+    private trackFirstVisibleItem;
+    private scheduleStateCommit;
+    /**
+     * Once per frame: publish the scrollable edges and refresh the geometry
+     * snapshots (tracked first-visible row, reading leaves) that prepend
+     * preservation and reading-position restores compare against. Capturing
+     * here — instead of on every scroll event — bounds rect reads to one pass
+     * per frame.
+     */
+    private commitFrameState;
+    private applyStateAttributes;
+    private scheduleVisibilitySync;
+    private computeVisibility;
+    /**
+     * Rows outside the viewport skip rendering via `content-visibility: auto`
+     * and a placeholder intrinsic size. Their first reveal during an upward
+     * scroll pays first-time layout of complex markdown — felt as hitches on
+     * the first pass through history. Rendering each row once at idle records
+     * its real size (the `auto` keyword keeps last-remembered sizes), so the
+     * first real scroll finds everything measured and warm.
+     */
+    private scheduleWarmup;
+    private warmupBatch;
+    private cancelWarmup;
+    private flushPendingScrollToMessage;
+    private setSpacerHeight;
+    private itemChildren;
+    private isAtEnd;
+}
+//# sourceMappingURL=message-scroller-controller.d.ts.map

package/dist/components/ui/message-scroller-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-scroller-controller.d.ts","sourceRoot":"","sources":["../../../src/components/ui/message-scroller-controller.ts"],"names":[],"mappings":"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"}