@ulearning/ai-sdk 0.0.0-stage → 1.0.0-next.0

package/dist/primitives/thread/ThreadViewportFooter.js

@@ -0,0 +1,39 @@
+"use client";
+import { useThreadViewport } from "../../context/vue/ThreadViewportContext.js";
+import { Primitive as Primitive$1 } from "../../utils/Primitive.js";
+import { useSizeHandle } from "../../utils/hooks/useSizeHandle.js";
+import { defineComponent, h } from "vue";
+import { useForwardExpose } from "reka-ui";
+// src/primitives/thread/ThreadViewportFooter.tsx
+/** Measures its height and margin; multiple footer insets are summed. */
+const ThreadPrimitiveViewportFooter = defineComponent((props, { attrs, slots }) => {
+	const { forwardRef } = useForwardExpose();
+	const register = useThreadViewport((s) => s.registerContentInset);
+	const resizeRef = useSizeHandle(register, (element) => {
+		const marginTop = parseFloat(getComputedStyle(element).marginTop) || 0;
+		return element.offsetHeight + marginTop;
+	});
+	const setElement = (instance) => {
+		forwardRef(instance);
+		const candidate = instance instanceof Element ? instance : instance?.$el;
+		resizeRef(candidate instanceof HTMLElement ? candidate : null);
+	};
+	return () => h(Primitive$1.div, {
+		...attrs,
+		render: props.render,
+		asChild: props.asChild,
+		children: props.children,
+		ref: setElement
+	}, slots);
+}, {
+	name: "ThreadPrimitive.ViewportFooter",
+	inheritAttrs: false,
+	props: [
+		"render",
+		"asChild",
+		"children"
+	]
+});
+export { ThreadPrimitiveViewportFooter };
+
+//# sourceMappingURL=ThreadViewportFooter.js.map

package/dist/primitives/thread/ThreadViewportFooter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadViewportFooter.js","names":["defineComponent","h","ComponentPublicInstance","useForwardExpose","Primitive","PrimitiveProps","useSizeHandle","useThreadViewport","ThreadPrimitiveViewportFooter","Element","Props","props","attrs","slots","forwardRef","register","s","registerContentInset","resizeRef","element","marginTop","parseFloat","getComputedStyle","offsetHeight","setElement","instance","candidate","$el","HTMLElement","div","render","asChild","children","ref","name","inheritAttrs","Primitive"],"sources":["../../../src/primitives/thread/ThreadViewportFooter.tsx"],"sourcesContent":["\"use client\";\n\nimport { defineComponent, h, type ComponentPublicInstance } from \"vue\";\nimport { useForwardExpose } from \"reka-ui\";\nimport { Primitive, type PrimitiveProps } from \"../../utils/Primitive\";\nimport { useSizeHandle } from \"../../utils/hooks/useSizeHandle\";\nimport { useThreadViewport } from \"../../context/vue/ThreadViewportContext\";\n\nexport namespace ThreadPrimitiveViewportFooter {\n  export type Element = ComponentPublicInstance;\n  export type Props = PrimitiveProps<\"div\">;\n}\n\n/** Measures its height and margin; multiple footer insets are summed. */\nexport const ThreadPrimitiveViewportFooter = defineComponent(\n  (props: ThreadPrimitiveViewportFooter.Props, { attrs, slots }) => {\n    const { forwardRef } = useForwardExpose();\n    const register = useThreadViewport((s) => s.registerContentInset);\n    const resizeRef = useSizeHandle(register, (element) => {\n      const marginTop = parseFloat(getComputedStyle(element).marginTop) || 0;\n      return element.offsetHeight + marginTop;\n    });\n    const setElement = (instance: Element | ComponentPublicInstance | null) => {\n      forwardRef(instance);\n      const candidate = instance instanceof Element ? instance : instance?.$el;\n      resizeRef(candidate instanceof HTMLElement ? candidate : null);\n    };\n    return () =>\n      h(\n        Primitive.div,\n        {\n          ...attrs,\n          render: props.render,\n          asChild: props.asChild,\n          children: props.children,\n          ref: setElement,\n        },\n        slots,\n      );\n  },\n  {\n    name: \"ThreadPrimitive.ViewportFooter\",\n    inheritAttrs: false,\n    props: [\"render\", \"asChild\", \"children\"],\n  },\n);\n"],"mappings":";;;;;;;;AAcA,MAAaQ,gCAAgCR,iBAC1CW,OAA4C,EAAEC,OAAOC,YAAY;CAChE,MAAM,EAAEC,eAAeX,iBAAiB;CACxC,MAAMY,WAAWR,mBAAmBS,MAAMA,EAAEC,oBAAoB;CAChE,MAAMC,YAAYZ,cAAcS,WAAWI,YAAY;EACrD,MAAMC,YAAYC,WAAWC,iBAAiBH,OAAO,CAAC,CAACC,SAAS,KAAK;EACrE,OAAOD,QAAQI,eAAeH;CAChC,CAAC;CACD,MAAMI,cAAcC,aAAuD;EACzEX,WAAWW,QAAQ;EACnB,MAAMC,YAAYD,oBAAoBhB,UAAUgB,WAAWA,UAAUE;EACrET,UAAUQ,qBAAqBE,cAAcF,YAAY,IAAI;CAC/D;CACA,aACEzB,EACEG,YAAUyB,KACV;EACE,GAAGjB;EACHkB,QAAQnB,MAAMmB;EACdC,SAASpB,MAAMoB;EACfC,UAAUrB,MAAMqB;EAChBC,KAAKT;CACP,GACAX,KACF;AACJ,GACA;CACEqB,MAAM;CACNC,cAAc;CACdxB,OAAO;EAAC;EAAU;EAAW;CAAU;AACzC,CACF"}

package/dist/primitives/thread/topAnchor/computeTopAnchorSlack.d.ts

@@ -0,0 +1,22 @@
+export type ComputeTopAnchorTargetOptions = {
+    viewport: HTMLElement;
+    anchor: HTMLElement;
+    tallerThan: number;
+    visibleHeight: number;
+};
+export type ComputeTopAnchorReserveOptions = ComputeTopAnchorTargetOptions & {
+    reserve: HTMLElement;
+};
+/**
+ * Compute the scroll position that pins the anchor (last user message) to the
+ * top of the viewport. For tall user messages the anchor is intentionally
+ * over-scrolled so only `visibleHeight` of it remains visible, leaving room
+ * for the assistant message below.
+ *
+ * Depends only on the anchor's offset within the scroll content; never reads
+ * `viewport.scrollHeight` (which is volatile while the assistant message
+ * streams in).
+ */
+export declare const computeTopAnchorTargetScrollTop: ({ viewport, anchor, tallerThan, visibleHeight, }: ComputeTopAnchorTargetOptions) => number;
+export declare const computeTopAnchorReserve: ({ viewport, reserve, ...targetOptions }: ComputeTopAnchorReserveOptions) => number;
+//# sourceMappingURL=computeTopAnchorSlack.d.ts.map

package/dist/primitives/thread/topAnchor/computeTopAnchorSlack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeTopAnchorSlack.d.ts","mappings":"AAEA,MAAM,MAAM,6BAA6B,GAAG;IAC1C,QAAQ,EAAE,WAAW;IACrB,MAAM,EAAE,WAAW;IACnB,UAAU,EAAE,MAAM;IAClB,aAAa,EAAE,MAAM;CACtB;AAED,MAAM,MAAM,8BAA8B,GAAG,6BAA6B,GAAG;IAC3E,OAAO,EAAE,WAAW;CACrB;AAqCD;;;;;;;;;;AAUA,eAAO,MAAM,+BAA+B,GAAI,kDAK7C,6BAA6B,KAAG,MAOlC;AAaD,eAAO,MAAM,uBAAuB,GAAI,yCAIrC,8BAA8B,KAAG,MAMnC","names":[],"ignoreList":[],"sources":["../../../../src/primitives/thread/topAnchor/computeTopAnchorSlack.ts"],"sourcesContent":[null]}

package/dist/primitives/thread/topAnchor/computeTopAnchorSlack.js

@@ -0,0 +1,51 @@
+"use client";
+// src/primitives/thread/topAnchor/computeTopAnchorSlack.ts
+const getDocumentOffsetTop = (element) => {
+	let top = 0;
+	let current = element;
+	while (current) {
+		top += current.offsetTop;
+		current = current.offsetParent;
+	}
+	return top;
+};
+const getLayoutOffsetTop = (element, ancestor) => {
+	let top = 0;
+	let current = element;
+	while (current && current !== ancestor) {
+		top += current.offsetTop;
+		current = current.offsetParent;
+	}
+	if (current === ancestor) return top;
+	return getDocumentOffsetTop(element) - getDocumentOffsetTop(ancestor);
+};
+/**
+* Compute the scroll position that pins the anchor (last user message) to the
+* top of the viewport. For tall user messages the anchor is intentionally
+* over-scrolled so only `visibleHeight` of it remains visible, leaving room
+* for the assistant message below.
+*
+* Depends only on the anchor's offset within the scroll content; never reads
+* `viewport.scrollHeight` (which is volatile while the assistant message
+* streams in).
+*/
+const computeTopAnchorTargetScrollTop = ({ viewport, anchor, tallerThan, visibleHeight }) => {
+	const anchorTop = getLayoutOffsetTop(anchor, viewport);
+	const anchorHeight = anchor.offsetHeight;
+	return anchorTop + Math.max(0, anchorHeight - (anchorHeight <= tallerThan ? anchorHeight : visibleHeight));
+};
+const computeTopAnchorSlack = ({ scrollHeight, ...targetOptions }) => {
+	const { viewport } = targetOptions;
+	const targetScrollHeight = computeTopAnchorTargetScrollTop(targetOptions) + viewport.clientHeight;
+	return Math.max(0, targetScrollHeight - scrollHeight);
+};
+const computeTopAnchorReserve = ({ viewport, reserve, ...targetOptions }) => {
+	return computeTopAnchorSlack({
+		viewport,
+		...targetOptions,
+		scrollHeight: viewport.scrollHeight - reserve.offsetHeight
+	});
+};
+export { computeTopAnchorReserve, computeTopAnchorTargetScrollTop };
+
+//# sourceMappingURL=computeTopAnchorSlack.js.map

package/dist/primitives/thread/topAnchor/computeTopAnchorSlack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"computeTopAnchorSlack.js","names":[],"sources":["../../../../src/primitives/thread/topAnchor/computeTopAnchorSlack.ts"],"sourcesContent":["\"use client\";\n\nexport type ComputeTopAnchorTargetOptions = {\n  viewport: HTMLElement;\n  anchor: HTMLElement;\n  tallerThan: number;\n  visibleHeight: number;\n};\n\nexport type ComputeTopAnchorReserveOptions = ComputeTopAnchorTargetOptions & {\n  reserve: HTMLElement;\n};\n\ntype ComputeTopAnchorSlackOptions = ComputeTopAnchorTargetOptions & {\n  scrollHeight: number;\n};\n\nconst getDocumentOffsetTop = (element: HTMLElement): number => {\n  let top = 0;\n  let current: HTMLElement | null = element;\n\n  while (current) {\n    top += current.offsetTop;\n    current = current.offsetParent as HTMLElement | null;\n  }\n\n  return top;\n};\n\nconst getLayoutOffsetTop = (\n  element: HTMLElement,\n  ancestor: HTMLElement,\n): number => {\n  // Use layout geometry, not visual rects, so entrance transforms/animations\n  // on the anchor do not shift the scroll target while they settle.\n  let top = 0;\n  let current: HTMLElement | null = element;\n\n  while (current && current !== ancestor) {\n    top += current.offsetTop;\n    current = current.offsetParent as HTMLElement | null;\n  }\n\n  if (current === ancestor) return top;\n\n  return getDocumentOffsetTop(element) - getDocumentOffsetTop(ancestor);\n};\n\n/**\n * Compute the scroll position that pins the anchor (last user message) to the\n * top of the viewport. For tall user messages the anchor is intentionally\n * over-scrolled so only `visibleHeight` of it remains visible, leaving room\n * for the assistant message below.\n *\n * Depends only on the anchor's offset within the scroll content; never reads\n * `viewport.scrollHeight` (which is volatile while the assistant message\n * streams in).\n */\nexport const computeTopAnchorTargetScrollTop = ({\n  viewport,\n  anchor,\n  tallerThan,\n  visibleHeight,\n}: ComputeTopAnchorTargetOptions): number => {\n  const anchorTop = getLayoutOffsetTop(anchor, viewport);\n  const anchorHeight = anchor.offsetHeight;\n  const visibleAnchorHeight =\n    anchorHeight <= tallerThan ? anchorHeight : visibleHeight;\n\n  return anchorTop + Math.max(0, anchorHeight - visibleAnchorHeight);\n};\n\nconst computeTopAnchorSlack = ({\n  scrollHeight,\n  ...targetOptions\n}: ComputeTopAnchorSlackOptions): number => {\n  const { viewport } = targetOptions;\n  const targetScrollTop = computeTopAnchorTargetScrollTop(targetOptions);\n  const targetScrollHeight = targetScrollTop + viewport.clientHeight;\n\n  return Math.max(0, targetScrollHeight - scrollHeight);\n};\n\nexport const computeTopAnchorReserve = ({\n  viewport,\n  reserve,\n  ...targetOptions\n}: ComputeTopAnchorReserveOptions): number => {\n  return computeTopAnchorSlack({\n    viewport,\n    ...targetOptions,\n    scrollHeight: viewport.scrollHeight - reserve.offsetHeight,\n  });\n};\n"],"mappings":";;AAiBA,MAAM,wBAAwB,YAAiC;CAC7D,IAAI,MAAM;CACV,IAAI,UAA8B;CAElC,OAAO,SAAS;EACd,OAAO,QAAQ;EACf,UAAU,QAAQ;CACpB;CAEA,OAAO;AACT;AAEA,MAAM,sBACJ,SACA,aACW;CAGX,IAAI,MAAM;CACV,IAAI,UAA8B;CAElC,OAAO,WAAW,YAAY,UAAU;EACtC,OAAO,QAAQ;EACf,UAAU,QAAQ;CACpB;CAEA,IAAI,YAAY,UAAU,OAAO;CAEjC,OAAO,qBAAqB,OAAO,IAAI,qBAAqB,QAAQ;AACtE;;;;;;;;;;;AAYA,MAAa,mCAAmC,EAC9C,UACA,QACA,YACA,oBAC2C;CAC3C,MAAM,YAAY,mBAAmB,QAAQ,QAAQ;CACrD,MAAM,eAAe,OAAO;CAI5B,OAAO,YAAY,KAAK,IAAI,GAAG,gBAF7B,gBAAgB,aAAa,eAAe,cAEmB;AACnE;AAEA,MAAM,yBAAyB,EAC7B,cACA,GAAG,oBACuC;CAC1C,MAAM,EAAE,aAAa;CAErB,MAAM,qBADkB,gCAAgC,aACf,IAAI,SAAS;CAEtD,OAAO,KAAK,IAAI,GAAG,qBAAqB,YAAY;AACtD;AAEA,MAAa,2BAA2B,EACtC,UACA,SACA,GAAG,oBACyC;CAC5C,OAAO,sBAAsB;EAC3B;EACA,GAAG;EACH,cAAc,SAAS,eAAe,QAAQ;CAChD,CAAC;AACH"}

package/dist/primitives/thread/topAnchor/createReserveObservers.d.ts

@@ -0,0 +1,5 @@
+export declare const createReserveObservers: (onChange: () => void) => {
+    target: (viewport: HTMLElement, anchor: HTMLElement, target: HTMLElement) => void;
+    disconnect: () => void;
+};
+//# sourceMappingURL=createReserveObservers.d.ts.map

package/dist/primitives/thread/topAnchor/createReserveObservers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReserveObservers.d.ts","mappings":"AAEA,eAAO,MAAM,sBAAsB,GAAI,UAAU,MAAM,IAAI;uBAkB3C,WAAW,UACb,WAAW,UACX,WAAW;;CA2BxB","names":[],"ignoreList":[],"sources":["../../../../src/primitives/thread/topAnchor/createReserveObservers.ts"],"sourcesContent":[null]}

package/dist/primitives/thread/topAnchor/createReserveObservers.js

@@ -0,0 +1,37 @@
+"use client";
+// src/primitives/thread/topAnchor/createReserveObservers.ts
+const createReserveObservers = (onChange) => {
+	const resizeObserver = new ResizeObserver(onChange);
+	const mutationObserver = new MutationObserver(onChange);
+	let observedViewport = null;
+	let observedAnchor = null;
+	let observedTarget = null;
+	const disconnect = () => {
+		resizeObserver.disconnect();
+		mutationObserver.disconnect();
+		observedViewport = null;
+		observedAnchor = null;
+		observedTarget = null;
+	};
+	return {
+		target: (viewport, anchor, target) => {
+			if (observedViewport === viewport && observedAnchor === anchor && observedTarget === target) return;
+			disconnect();
+			resizeObserver.observe(viewport);
+			resizeObserver.observe(anchor);
+			resizeObserver.observe(target);
+			mutationObserver.observe(target, {
+				childList: true,
+				subtree: true,
+				characterData: true
+			});
+			observedViewport = viewport;
+			observedAnchor = anchor;
+			observedTarget = target;
+		},
+		disconnect
+	};
+};
+export { createReserveObservers };
+
+//# sourceMappingURL=createReserveObservers.js.map

package/dist/primitives/thread/topAnchor/createReserveObservers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReserveObservers.js","names":[],"sources":["../../../../src/primitives/thread/topAnchor/createReserveObservers.ts"],"sourcesContent":["\"use client\";\n\nexport const createReserveObservers = (onChange: () => void) => {\n  const resizeObserver = new ResizeObserver(onChange);\n  const mutationObserver = new MutationObserver(onChange);\n\n  let observedViewport: HTMLElement | null = null;\n  let observedAnchor: HTMLElement | null = null;\n  let observedTarget: HTMLElement | null = null;\n\n  const disconnect = () => {\n    resizeObserver.disconnect();\n    mutationObserver.disconnect();\n    observedViewport = null;\n    observedAnchor = null;\n    observedTarget = null;\n  };\n\n  return {\n    target: (\n      viewport: HTMLElement,\n      anchor: HTMLElement,\n      target: HTMLElement,\n    ) => {\n      if (\n        observedViewport === viewport &&\n        observedAnchor === anchor &&\n        observedTarget === target\n      ) {\n        return;\n      }\n\n      disconnect();\n\n      resizeObserver.observe(viewport);\n      resizeObserver.observe(anchor);\n      resizeObserver.observe(target);\n      mutationObserver.observe(target, {\n        childList: true,\n        subtree: true,\n        characterData: true,\n      });\n\n      observedViewport = viewport;\n      observedAnchor = anchor;\n      observedTarget = target;\n    },\n    disconnect,\n  };\n};\n"],"mappings":";;AAEA,MAAa,0BAA0B,aAAyB;CAC9D,MAAM,iBAAiB,IAAI,eAAe,QAAQ;CAClD,MAAM,mBAAmB,IAAI,iBAAiB,QAAQ;CAEtD,IAAI,mBAAuC;CAC3C,IAAI,iBAAqC;CACzC,IAAI,iBAAqC;CAEzC,MAAM,mBAAmB;EACvB,eAAe,WAAW;EAC1B,iBAAiB,WAAW;EAC5B,mBAAmB;EACnB,iBAAiB;EACjB,iBAAiB;CACnB;CAEA,OAAO;EACL,SACE,UACA,QACA,WACG;GACH,IACE,qBAAqB,YACrB,mBAAmB,UACnB,mBAAmB,QAEnB;GAGF,WAAW;GAEX,eAAe,QAAQ,QAAQ;GAC/B,eAAe,QAAQ,MAAM;GAC7B,eAAe,QAAQ,MAAM;GAC7B,iBAAiB,QAAQ,QAAQ;IAC/B,WAAW;IACX,SAAS;IACT,eAAe;GACjB,CAAC;GAED,mBAAmB;GACnB,iBAAiB;GACjB,iBAAiB;EACnB;EACA;CACF;AACF"}

package/dist/primitives/thread/topAnchor/mountTopAnchorReserve.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Minimal slice of `ThreadViewportStore` that the top-anchor reserve needs.
+ * Decoupling from the full store keeps `mountTopAnchorReserve` testable in
+ * isolation and re-usable from any consumer that can adapt to this shape.
+ */
+export type TopAnchorStore = {
+    getState(): {
+        turnAnchor: "top" | "bottom";
+        element: {
+            viewport: HTMLElement | null;
+            anchor: HTMLElement | null;
+            target: HTMLElement | null;
+        };
+        targetConfig: {
+            tallerThan: number;
+            visibleHeight: number;
+        } | null;
+        topAnchorTurn: {
+            readonly anchorId: string;
+            readonly targetId: string;
+        } | null;
+    };
+    subscribe(fn: () => void): () => void;
+};
+export declare const mountTopAnchorReserve: (store: TopAnchorStore) => () => void;
+//# sourceMappingURL=mountTopAnchorReserve.d.ts.map

package/dist/primitives/thread/topAnchor/mountTopAnchorReserve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mountTopAnchorReserve.d.ts","mappings":"AAcA;;;;;AAKA,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,IAAI;QACV,UAAU,EAAE,KAAK,GAAG,QAAQ;QAC5B,OAAO,EAAE;YACP,QAAQ,EAAE,WAAW,GAAG,IAAI;YAC5B,MAAM,EAAE,WAAW,GAAG,IAAI;YAC1B,MAAM,EAAE,WAAW,GAAG,IAAI;SAC3B;QACD,YAAY,EAAE;YACZ,UAAU,EAAE,MAAM;YAClB,aAAa,EAAE,MAAM;SACtB,GAAG,IAAI;QACR,aAAa,EAAE;YACb,QAAQ,CAAC,QAAQ,EAAE,MAAM;YACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM;SAC1B,GAAG,IAAI;KACT;IACD,SAAS,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;CACtC;AAsBD,eAAO,MAAM,qBAAqB,GAAI,OAAO,cAAc,eAiK1D","names":[],"ignoreList":[],"sources":["../../../../src/primitives/thread/topAnchor/mountTopAnchorReserve.ts"],"sourcesContent":[null]}

package/dist/primitives/thread/topAnchor/mountTopAnchorReserve.js

@@ -0,0 +1,139 @@
+"use client";
+import { createReserveElement, getAnchorId, setReserveHeight, snapScrollTop } from "./topAnchorUtils.js";
+import { computeTopAnchorReserve, computeTopAnchorTargetScrollTop } from "./computeTopAnchorSlack.js";
+import { createReserveObservers } from "./createReserveObservers.js";
+// src/primitives/thread/topAnchor/mountTopAnchorReserve.ts
+const createFrameScheduler = (fn) => {
+	let frame = null;
+	return {
+		schedule: () => {
+			if (frame !== null) return;
+			frame = requestAnimationFrame(() => {
+				frame = null;
+				fn();
+			});
+		},
+		cancel: () => {
+			if (frame !== null) {
+				cancelAnimationFrame(frame);
+				frame = null;
+			}
+		}
+	};
+};
+const mountTopAnchorReserve = (store) => {
+	let reserve = null;
+	let lastScrolledAnchorId;
+	let listenedViewport = null;
+	let lastScrollTop = 0;
+	let restoreScrollTop = null;
+	let restoredThisTurn = false;
+	let lastAppliedTarget = null;
+	const clearRestore = () => {
+		restoreScrollTop = null;
+		lastAppliedTarget = null;
+	};
+	const wasPinnedAtLastScroll = () => lastAppliedTarget !== null && Math.abs(lastScrollTop - lastAppliedTarget) <= 1;
+	const handleScroll = () => {
+		const viewport = listenedViewport;
+		if (!viewport) return;
+		const scrollTop = viewport.scrollTop;
+		const maxScrollTop = Math.max(0, viewport.scrollHeight - viewport.clientHeight);
+		if (scrollTop < lastScrollTop && lastScrollTop > maxScrollTop + 1 && Math.abs(scrollTop - maxScrollTop) <= 1 && wasPinnedAtLastScroll() && !restoredThisTurn) {
+			restoreScrollTop ??= lastScrollTop;
+			scheduler.schedule();
+		}
+		lastScrollTop = scrollTop;
+	};
+	const listenViewport = (viewport) => {
+		if (listenedViewport === viewport) return;
+		if (listenedViewport) listenedViewport.removeEventListener("scroll", handleScroll);
+		listenedViewport = viewport;
+		restoredThisTurn = false;
+		clearRestore();
+		if (viewport) {
+			viewport.addEventListener("scroll", handleScroll, { passive: true });
+			lastScrollTop = viewport.scrollTop;
+		}
+	};
+	function apply() {
+		const state = store.getState();
+		const { viewport, anchor, target } = state.element;
+		const clamp = state.targetConfig;
+		listenViewport(state.turnAnchor === "top" ? viewport : null);
+		if (state.turnAnchor !== "top" || !viewport) {
+			observers.disconnect();
+			clearRestore();
+			if (reserve) {
+				setReserveHeight(reserve, 0);
+				reserve.remove();
+			}
+			return;
+		}
+		if (!anchor && !target && !clamp && state.topAnchorTurn) {
+			observers.disconnect();
+			clearRestore();
+			if (reserve?.parentElement && reserve.parentElement.lastElementChild !== reserve) reserve.parentElement.append(reserve);
+			return;
+		}
+		if (!anchor || !target || !clamp) {
+			observers.disconnect();
+			clearRestore();
+			if (reserve) {
+				setReserveHeight(reserve, 0);
+				reserve.remove();
+			}
+			return;
+		}
+		reserve ??= createReserveElement();
+		if (reserve.parentElement !== target.parentElement || reserve.previousElementSibling !== target) target.after(reserve);
+		observers.target(viewport, anchor, target);
+		if (setReserveHeight(reserve, computeTopAnchorReserve({
+			viewport,
+			anchor,
+			reserve,
+			...clamp
+		}))) {
+			scheduler.schedule();
+			return;
+		}
+		const anchorId = getAnchorId(anchor);
+		const targetScrollTop = snapScrollTop(computeTopAnchorTargetScrollTop({
+			viewport,
+			anchor,
+			...clamp
+		}));
+		if (anchorId === void 0 || anchorId !== lastScrolledAnchorId) {
+			restoreScrollTop = null;
+			restoredThisTurn = false;
+			if (Math.abs(viewport.scrollTop - targetScrollTop) > 1) viewport.scrollTo({
+				top: targetScrollTop,
+				behavior: "smooth"
+			});
+			if (anchorId !== void 0) lastScrolledAnchorId = anchorId;
+		} else if (restoreScrollTop !== null && lastAppliedTarget !== null) {
+			const desired = snapScrollTop(restoreScrollTop + (targetScrollTop - lastAppliedTarget));
+			restoreScrollTop = null;
+			restoredThisTurn = true;
+			if (Math.abs(viewport.scrollTop - desired) > 1) viewport.scrollTo({
+				top: desired,
+				behavior: "instant"
+			});
+		}
+		lastAppliedTarget = targetScrollTop;
+	}
+	const scheduler = createFrameScheduler(apply);
+	const observers = createReserveObservers(scheduler.schedule);
+	scheduler.schedule();
+	const unsubscribe = store.subscribe(scheduler.schedule);
+	return () => {
+		scheduler.cancel();
+		unsubscribe();
+		observers.disconnect();
+		listenViewport(null);
+		reserve?.remove();
+	};
+};
+export { mountTopAnchorReserve };
+
+//# sourceMappingURL=mountTopAnchorReserve.js.map

package/dist/primitives/thread/topAnchor/mountTopAnchorReserve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mountTopAnchorReserve.js","names":[],"sources":["../../../../src/primitives/thread/topAnchor/mountTopAnchorReserve.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  computeTopAnchorReserve,\n  computeTopAnchorTargetScrollTop,\n} from \"./computeTopAnchorSlack\";\nimport { createReserveObservers } from \"./createReserveObservers\";\nimport {\n  createReserveElement,\n  getAnchorId,\n  setReserveHeight,\n  snapScrollTop,\n} from \"./topAnchorUtils\";\n\n/**\n * Minimal slice of `ThreadViewportStore` that the top-anchor reserve needs.\n * Decoupling from the full store keeps `mountTopAnchorReserve` testable in\n * isolation and re-usable from any consumer that can adapt to this shape.\n */\nexport type TopAnchorStore = {\n  getState(): {\n    turnAnchor: \"top\" | \"bottom\";\n    element: {\n      viewport: HTMLElement | null;\n      anchor: HTMLElement | null;\n      target: HTMLElement | null;\n    };\n    targetConfig: {\n      tallerThan: number;\n      visibleHeight: number;\n    } | null;\n    topAnchorTurn: {\n      readonly anchorId: string;\n      readonly targetId: string;\n    } | null;\n  };\n  subscribe(fn: () => void): () => void;\n};\n\nconst createFrameScheduler = (fn: () => void) => {\n  let frame: number | null = null;\n\n  return {\n    schedule: () => {\n      if (frame !== null) return;\n      frame = requestAnimationFrame(() => {\n        frame = null;\n        fn();\n      });\n    },\n    cancel: () => {\n      if (frame !== null) {\n        cancelAnimationFrame(frame);\n        frame = null;\n      }\n    },\n  };\n};\n\nexport const mountTopAnchorReserve = (store: TopAnchorStore) => {\n  let reserve: HTMLElement | null = null;\n  let lastScrolledAnchorId: string | undefined;\n\n  let listenedViewport: HTMLElement | null = null;\n  let lastScrollTop = 0;\n  let restoreScrollTop: number | null = null;\n  let restoredThisTurn = false;\n  let lastAppliedTarget: number | null = null;\n\n  const clearRestore = () => {\n    restoreScrollTop = null;\n    lastAppliedTarget = null;\n  };\n\n  const wasPinnedAtLastScroll = () =>\n    lastAppliedTarget !== null &&\n    Math.abs(lastScrollTop - lastAppliedTarget) <= 1;\n\n  const handleScroll = () => {\n    const viewport = listenedViewport;\n    if (!viewport) return;\n    const scrollTop = viewport.scrollTop;\n    const maxScrollTop = Math.max(\n      0,\n      viewport.scrollHeight - viewport.clientHeight,\n    );\n    // A range clamp starts beyond the new maximum and lands on it.\n    const isRangeClamp =\n      scrollTop < lastScrollTop &&\n      lastScrollTop > maxScrollTop + 1 &&\n      Math.abs(scrollTop - maxScrollTop) <= 1;\n\n    if (isRangeClamp && wasPinnedAtLastScroll() && !restoredThisTurn) {\n      restoreScrollTop ??= lastScrollTop;\n      scheduler.schedule();\n    }\n\n    lastScrollTop = scrollTop;\n  };\n\n  const listenViewport = (viewport: HTMLElement | null) => {\n    if (listenedViewport === viewport) return;\n    if (listenedViewport) {\n      listenedViewport.removeEventListener(\"scroll\", handleScroll);\n    }\n    listenedViewport = viewport;\n    restoredThisTurn = false;\n    clearRestore();\n    if (viewport) {\n      viewport.addEventListener(\"scroll\", handleScroll, { passive: true });\n      lastScrollTop = viewport.scrollTop;\n    }\n  };\n\n  function apply() {\n    const state = store.getState();\n    const { viewport, anchor, target } = state.element;\n    const clamp = state.targetConfig;\n\n    listenViewport(state.turnAnchor === \"top\" ? viewport : null);\n\n    if (state.turnAnchor !== \"top\" || !viewport) {\n      observers.disconnect();\n      clearRestore();\n      if (reserve) {\n        setReserveHeight(reserve, 0);\n        reserve.remove();\n      }\n      return;\n    }\n\n    if (!anchor && !target && !clamp && state.topAnchorTurn) {\n      // ThreadViewport clears this state once the stored pair stops being the\n      // trailing turn (followed at most by pending user messages), so reaching\n      // here means the anchor gap is transient and the next run is imminent.\n      observers.disconnect();\n      clearRestore();\n      if (\n        reserve?.parentElement &&\n        reserve.parentElement.lastElementChild !== reserve\n      ) {\n        reserve.parentElement.append(reserve);\n      }\n      return;\n    }\n\n    if (!anchor || !target || !clamp) {\n      observers.disconnect();\n      clearRestore();\n      if (reserve) {\n        setReserveHeight(reserve, 0);\n        reserve.remove();\n      }\n      return;\n    }\n\n    reserve ??= createReserveElement();\n\n    if (\n      reserve.parentElement !== target.parentElement ||\n      reserve.previousElementSibling !== target\n    ) {\n      target.after(reserve);\n    }\n\n    observers.target(viewport, anchor, target);\n\n    const reserveChanged = setReserveHeight(\n      reserve,\n      computeTopAnchorReserve({ viewport, anchor, reserve, ...clamp }),\n    );\n\n    if (reserveChanged) {\n      scheduler.schedule();\n      return;\n    }\n\n    const anchorId = getAnchorId(anchor);\n    const targetScrollTop = snapScrollTop(\n      computeTopAnchorTargetScrollTop({ viewport, anchor, ...clamp }),\n    );\n\n    if (anchorId === undefined || anchorId !== lastScrolledAnchorId) {\n      restoreScrollTop = null;\n      restoredThisTurn = false;\n      if (Math.abs(viewport.scrollTop - targetScrollTop) > 1) {\n        viewport.scrollTo({ top: targetScrollTop, behavior: \"smooth\" });\n      }\n      if (anchorId !== undefined) lastScrolledAnchorId = anchorId;\n    } else if (restoreScrollTop !== null && lastAppliedTarget !== null) {\n      // Restore the anchor-relative position: if content above the anchor\n      // changed height and the browser already adjusted scrollTop to match\n      // (scroll anchoring), the desired offset equals the current one and\n      // this is a no-op.\n      const desired = snapScrollTop(\n        restoreScrollTop + (targetScrollTop - lastAppliedTarget),\n      );\n      restoreScrollTop = null;\n      restoredThisTurn = true;\n      if (Math.abs(viewport.scrollTop - desired) > 1) {\n        viewport.scrollTo({ top: desired, behavior: \"instant\" });\n      }\n    }\n\n    lastAppliedTarget = targetScrollTop;\n  }\n\n  const scheduler = createFrameScheduler(apply);\n  const observers = createReserveObservers(scheduler.schedule);\n\n  scheduler.schedule();\n  const unsubscribe = store.subscribe(scheduler.schedule);\n\n  return () => {\n    scheduler.cancel();\n    unsubscribe();\n    observers.disconnect();\n    listenViewport(null);\n    reserve?.remove();\n  };\n};\n"],"mappings":"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"}

package/dist/primitives/thread/topAnchor/topAnchorTurn.d.ts

@@ -0,0 +1,27 @@
+type TopAnchorTurnMessage = {
+    readonly id: string;
+    readonly role: string;
+};
+export type TopAnchorTurn = {
+    readonly anchorId: string;
+    readonly targetId: string;
+};
+/**
+ * A stored turn stays valid only while it is still the trailing turn: the
+ * anchor immediately precedes the target, and anything after the target is a
+ * pending user message awaiting the next run. An assistant message after the
+ * target means the turn was superseded (e.g. an external store synced in a
+ * turn completed elsewhere), so the reserve must be torn down, not preserved.
+ */
+export declare const isTopAnchorTurnValid: (turn: TopAnchorTurn | null, messages: readonly TopAnchorTurnMessage[]) => boolean;
+export declare const getActiveTopAnchorTurn: ({ isRunning, messages, }: {
+    readonly isRunning: boolean;
+    readonly messages: readonly TopAnchorTurnMessage[];
+}) => {
+    anchorId: string;
+    targetId: string;
+} | null;
+export declare const getActiveTopAnchorAnchorId: (options: Parameters<typeof getActiveTopAnchorTurn>[0]) => string | undefined;
+export declare const getActiveTopAnchorTargetId: (options: Parameters<typeof getActiveTopAnchorTurn>[0]) => string | undefined;
+export {};
+//# sourceMappingURL=topAnchorTurn.d.ts.map

package/dist/primitives/thread/topAnchor/topAnchorTurn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topAnchorTurn.d.ts","mappings":"AAEA,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM;CACtB;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM;CAC1B;AAED;;;;;;;AAOA,eAAO,MAAM,oBAAoB,GAC/B,MAAM,aAAa,GAAG,IAAI,EAC1B,UAAU,SAAS,oBAAoB,EAAE,YAa1C;AAED,eAAO,MAAM,sBAAsB,GAAI,0BAGpC;IACD,QAAQ,CAAC,SAAS,EAAE,OAAO;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,oBAAoB,EAAE;CACnD;;;QAQA;AAED,eAAO,MAAM,0BAA0B,GACrC,SAAS,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,uBACT;AAE9C,eAAO,MAAM,0BAA0B,GACrC,SAAS,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,uBACT","names":[],"ignoreList":[],"sources":["../../../../src/primitives/thread/topAnchor/topAnchorTurn.ts"],"sourcesContent":[null]}

package/dist/primitives/thread/topAnchor/topAnchorTurn.js

@@ -0,0 +1,30 @@
+"use client";
+// src/primitives/thread/topAnchor/topAnchorTurn.ts
+/**
+* A stored turn stays valid only while it is still the trailing turn: the
+* anchor immediately precedes the target, and anything after the target is a
+* pending user message awaiting the next run. An assistant message after the
+* target means the turn was superseded (e.g. an external store synced in a
+* turn completed elsewhere), so the reserve must be torn down, not preserved.
+*/
+const isTopAnchorTurnValid = (turn, messages) => {
+	if (!turn) return false;
+	const targetIndex = messages.findIndex((message) => message.id === turn.targetId);
+	if (targetIndex < 1) return false;
+	return messages[targetIndex - 1]?.id === turn.anchorId && messages.slice(targetIndex + 1).every((message) => message.role === "user");
+};
+const getActiveTopAnchorTurn = ({ isRunning, messages }) => {
+	if (!isRunning) return null;
+	const target = messages.at(-1);
+	const anchor = messages.at(-2);
+	if (anchor?.role !== "user" || target?.role !== "assistant") return null;
+	return {
+		anchorId: anchor.id,
+		targetId: target.id
+	};
+};
+const getActiveTopAnchorAnchorId = (options) => getActiveTopAnchorTurn(options)?.anchorId;
+const getActiveTopAnchorTargetId = (options) => getActiveTopAnchorTurn(options)?.targetId;
+export { getActiveTopAnchorAnchorId, getActiveTopAnchorTargetId, getActiveTopAnchorTurn, isTopAnchorTurnValid };
+
+//# sourceMappingURL=topAnchorTurn.js.map

package/dist/primitives/thread/topAnchor/topAnchorTurn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topAnchorTurn.js","names":[],"sources":["../../../../src/primitives/thread/topAnchor/topAnchorTurn.ts"],"sourcesContent":["\"use client\";\n\ntype TopAnchorTurnMessage = {\n  readonly id: string;\n  readonly role: string;\n};\n\nexport type TopAnchorTurn = {\n  readonly anchorId: string;\n  readonly targetId: string;\n};\n\n/**\n * A stored turn stays valid only while it is still the trailing turn: the\n * anchor immediately precedes the target, and anything after the target is a\n * pending user message awaiting the next run. An assistant message after the\n * target means the turn was superseded (e.g. an external store synced in a\n * turn completed elsewhere), so the reserve must be torn down, not preserved.\n */\nexport const isTopAnchorTurnValid = (\n  turn: TopAnchorTurn | null,\n  messages: readonly TopAnchorTurnMessage[],\n) => {\n  if (!turn) return false;\n\n  const targetIndex = messages.findIndex(\n    (message) => message.id === turn.targetId,\n  );\n  if (targetIndex < 1) return false;\n\n  return (\n    messages[targetIndex - 1]?.id === turn.anchorId &&\n    messages.slice(targetIndex + 1).every((message) => message.role === \"user\")\n  );\n};\n\nexport const getActiveTopAnchorTurn = ({\n  isRunning,\n  messages,\n}: {\n  readonly isRunning: boolean;\n  readonly messages: readonly TopAnchorTurnMessage[];\n}) => {\n  if (!isRunning) return null;\n\n  const target = messages.at(-1);\n  const anchor = messages.at(-2);\n  if (anchor?.role !== \"user\" || target?.role !== \"assistant\") return null;\n\n  return { anchorId: anchor.id, targetId: target.id };\n};\n\nexport const getActiveTopAnchorAnchorId = (\n  options: Parameters<typeof getActiveTopAnchorTurn>[0],\n) => getActiveTopAnchorTurn(options)?.anchorId;\n\nexport const getActiveTopAnchorTargetId = (\n  options: Parameters<typeof getActiveTopAnchorTurn>[0],\n) => getActiveTopAnchorTurn(options)?.targetId;\n"],"mappings":";;;;;;;;;AAmBA,MAAa,wBACX,MACA,aACG;CACH,IAAI,CAAC,MAAM,OAAO;CAElB,MAAM,cAAc,SAAS,WAC1B,YAAY,QAAQ,OAAO,KAAK,QACnC;CACA,IAAI,cAAc,GAAG,OAAO;CAE5B,OACE,SAAS,cAAc,EAAE,EAAE,OAAO,KAAK,YACvC,SAAS,MAAM,cAAc,CAAC,CAAC,CAAC,OAAO,YAAY,QAAQ,SAAS,MAAM;AAE9E;AAEA,MAAa,0BAA0B,EACrC,WACA,eAII;CACJ,IAAI,CAAC,WAAW,OAAO;CAEvB,MAAM,SAAS,SAAS,GAAG,EAAE;CAC7B,MAAM,SAAS,SAAS,GAAG,EAAE;CAC7B,IAAI,QAAQ,SAAS,UAAU,QAAQ,SAAS,aAAa,OAAO;CAEpE,OAAO;EAAE,UAAU,OAAO;EAAI,UAAU,OAAO;CAAG;AACpD;AAEA,MAAa,8BACX,YACG,uBAAuB,OAAO,CAAC,EAAE;AAEtC,MAAa,8BACX,YACG,uBAAuB,OAAO,CAAC,EAAE"}

package/dist/primitives/thread/topAnchor/topAnchorUtils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Convert a supported CSS length string (`px`, `em`, `rem`) into pixels,
+ * resolving font-relative units against the supplied element's computed style.
+ * Unsupported or malformed values disable the tall-message clamp.
+ *
+ * Part of the top-anchor package's public input contract: consumers may pass
+ * clamp configuration as supported CSS-length strings, and this function is the
+ * single place that converts them into the pixel values the package operates on.
+ */
+export declare const parseCssLength: (value: string, element: HTMLElement) => number;
+export declare const getAnchorId: (anchor: HTMLElement) => string | undefined;
+export declare const createReserveElement: () => HTMLDivElement;
+export declare const setReserveHeight: (reserve: HTMLElement, height: number) => boolean;
+export declare const snapScrollTop: (top: number) => number;
+//# sourceMappingURL=topAnchorUtils.d.ts.map

package/dist/primitives/thread/topAnchor/topAnchorUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topAnchorUtils.d.ts","mappings":"AAEA;;;;;;;;;AASA,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,SAAS,WAAW,KAAG,MAkBpE;AAED,eAAO,MAAM,WAAW,GAAI,QAAQ,WAAW,uBAA6B;AAE5E,eAAO,MAAM,oBAAoB,sBAShC;AAED,eAAO,MAAM,gBAAgB,GAAI,SAAS,WAAW,EAAE,QAAQ,MAAM,YAQpE;AAED,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,WAGxC","names":[],"ignoreList":[],"sources":["../../../../src/primitives/thread/topAnchor/topAnchorUtils.ts"],"sourcesContent":[null]}

package/dist/primitives/thread/topAnchor/topAnchorUtils.js

@@ -0,0 +1,46 @@
+"use client";
+// src/primitives/thread/topAnchor/topAnchorUtils.ts
+/**
+* Convert a supported CSS length string (`px`, `em`, `rem`) into pixels,
+* resolving font-relative units against the supplied element's computed style.
+* Unsupported or malformed values disable the tall-message clamp.
+*
+* Part of the top-anchor package's public input contract: consumers may pass
+* clamp configuration as supported CSS-length strings, and this function is the
+* single place that converts them into the pixel values the package operates on.
+*/
+const parseCssLength = (value, element) => {
+	const match = value.trim().match(/^(\d+(?:\.\d+)?|\.\d+)(em|px|rem)$/);
+	if (!match) return Number.POSITIVE_INFINITY;
+	const num = Number(match[1]);
+	const unit = match[2];
+	if (unit === "px") return num;
+	if (unit === "em") return num * (parseFloat(getComputedStyle(element).fontSize) || 16);
+	if (unit === "rem") return num * (parseFloat(getComputedStyle(document.documentElement).fontSize) || 16);
+	return Number.POSITIVE_INFINITY;
+};
+const getAnchorId = (anchor) => anchor.dataset.messageId;
+const createReserveElement = () => {
+	const reserve = document.createElement("div");
+	reserve.dataset.auiTopAnchorReserve = "";
+	reserve.style.height = "0px";
+	reserve.style.flexShrink = "0";
+	reserve.style.pointerEvents = "none";
+	reserve.setAttribute("aria-hidden", "true");
+	return reserve;
+};
+const setReserveHeight = (reserve, height) => {
+	const nextHeight = `${height}px`;
+	if (reserve.style.height !== nextHeight) {
+		reserve.style.height = nextHeight;
+		return true;
+	}
+	return false;
+};
+const snapScrollTop = (top) => {
+	const pixelRatio = window.devicePixelRatio || 1;
+	return Math.round(top * pixelRatio) / pixelRatio;
+};
+export { createReserveElement, getAnchorId, parseCssLength, setReserveHeight, snapScrollTop };
+
+//# sourceMappingURL=topAnchorUtils.js.map

package/dist/primitives/thread/topAnchor/topAnchorUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topAnchorUtils.js","names":[],"sources":["../../../../src/primitives/thread/topAnchor/topAnchorUtils.ts"],"sourcesContent":["\"use client\";\n\n/**\n * Convert a supported CSS length string (`px`, `em`, `rem`) into pixels,\n * resolving font-relative units against the supplied element's computed style.\n * Unsupported or malformed values disable the tall-message clamp.\n *\n * Part of the top-anchor package's public input contract: consumers may pass\n * clamp configuration as supported CSS-length strings, and this function is the\n * single place that converts them into the pixel values the package operates on.\n */\nexport const parseCssLength = (value: string, element: HTMLElement): number => {\n  const match = value.trim().match(/^(\\d+(?:\\.\\d+)?|\\.\\d+)(em|px|rem)$/);\n  if (!match) return Number.POSITIVE_INFINITY;\n\n  const num = Number(match[1]);\n  const unit = match[2];\n\n  if (unit === \"px\") return num;\n  if (unit === \"em\") {\n    const fontSize = parseFloat(getComputedStyle(element).fontSize) || 16;\n    return num * fontSize;\n  }\n  if (unit === \"rem\") {\n    const rootFontSize =\n      parseFloat(getComputedStyle(document.documentElement).fontSize) || 16;\n    return num * rootFontSize;\n  }\n  return Number.POSITIVE_INFINITY;\n};\n\nexport const getAnchorId = (anchor: HTMLElement) => anchor.dataset.messageId;\n\nexport const createReserveElement = () => {\n  const reserve = document.createElement(\"div\");\n  reserve.dataset.auiTopAnchorReserve = \"\";\n  reserve.style.height = \"0px\";\n  reserve.style.flexShrink = \"0\";\n  reserve.style.pointerEvents = \"none\";\n  reserve.setAttribute(\"aria-hidden\", \"true\");\n\n  return reserve;\n};\n\nexport const setReserveHeight = (reserve: HTMLElement, height: number) => {\n  const nextHeight = `${height}px`;\n  if (reserve.style.height !== nextHeight) {\n    reserve.style.height = nextHeight;\n    return true;\n  }\n\n  return false;\n};\n\nexport const snapScrollTop = (top: number) => {\n  const pixelRatio = window.devicePixelRatio || 1;\n  return Math.round(top * pixelRatio) / pixelRatio;\n};\n"],"mappings":";;;;;;;;;;;AAWA,MAAa,kBAAkB,OAAe,YAAiC;CAC7E,MAAM,QAAQ,MAAM,KAAK,CAAC,CAAC,MAAM,oCAAoC;CACrE,IAAI,CAAC,OAAO,OAAO,OAAO;CAE1B,MAAM,MAAM,OAAO,MAAM,EAAE;CAC3B,MAAM,OAAO,MAAM;CAEnB,IAAI,SAAS,MAAM,OAAO;CAC1B,IAAI,SAAS,MAEX,OAAO,OADU,WAAW,iBAAiB,OAAO,CAAC,CAAC,QAAQ,KAAK;CAGrE,IAAI,SAAS,OAGX,OAAO,OADL,WAAW,iBAAiB,SAAS,eAAe,CAAC,CAAC,QAAQ,KAAK;CAGvE,OAAO,OAAO;AAChB;AAEA,MAAa,eAAe,WAAwB,OAAO,QAAQ;AAEnE,MAAa,6BAA6B;CACxC,MAAM,UAAU,SAAS,cAAc,KAAK;CAC5C,QAAQ,QAAQ,sBAAsB;CACtC,QAAQ,MAAM,SAAS;CACvB,QAAQ,MAAM,aAAa;CAC3B,QAAQ,MAAM,gBAAgB;CAC9B,QAAQ,aAAa,eAAe,MAAM;CAE1C,OAAO;AACT;AAEA,MAAa,oBAAoB,SAAsB,WAAmB;CACxE,MAAM,aAAa,GAAG,OAAO;CAC7B,IAAI,QAAQ,MAAM,WAAW,YAAY;EACvC,QAAQ,MAAM,SAAS;EACvB,OAAO;CACT;CAEA,OAAO;AACT;AAEA,MAAa,iBAAiB,QAAgB;CAC5C,MAAM,aAAa,OAAO,oBAAoB;CAC9C,OAAO,KAAK,MAAM,MAAM,UAAU,IAAI;AACxC"}

package/dist/primitives/thread/topAnchor/useTopAnchorReserve.d.ts

@@ -0,0 +1,8 @@
+import { type MaybeRefOrGetter } from "vue";
+/**
+ * Mounts the top-turn-anchor reserve element against the active
+ * `ThreadViewport` store. Call this from inside the scrollable viewport so
+ * the reserve `<div>` is appended next to the streaming assistant message.
+ */
+export declare const useTopAnchorReserve: (enabled: MaybeRefOrGetter<boolean>) => void;
+//# sourceMappingURL=useTopAnchorReserve.d.ts.map

package/dist/primitives/thread/topAnchor/useTopAnchorReserve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTopAnchorReserve.d.ts","mappings":"AAEA,OAAO,EAAW,KAAK,gBAAgB,EAAE,MAAM,KAAK;AAKpD;;;;;AAKA,eAAO,MAAM,mBAAmB,GAAI,SAAS,gBAAgB,CAAC,OAAO,CAAC,SAUrE","names":[],"ignoreList":[],"sources":["../../../../src/primitives/thread/topAnchor/useTopAnchorReserve.ts"],"sourcesContent":[null]}

package/dist/primitives/thread/topAnchor/useTopAnchorReserve.js

@@ -0,0 +1,21 @@
+"use client";
+import { useThreadViewportStore } from "../../../context/vue/ThreadViewportContext.js";
+import { mountTopAnchorReserve } from "./mountTopAnchorReserve.js";
+import { toValue } from "vue";
+import { useIsomorphicLayoutEffect } from "@ulearning/ai-store/internal";
+// src/primitives/thread/topAnchor/useTopAnchorReserve.ts
+/**
+* Mounts the top-turn-anchor reserve element against the active
+* `ThreadViewport` store. Call this from inside the scrollable viewport so
+* the reserve `<div>` is appended next to the streaming assistant message.
+*/
+const useTopAnchorReserve = (enabled) => {
+	const threadViewportStore = useThreadViewportStore();
+	useIsomorphicLayoutEffect(() => {
+		if (!toValue(enabled)) return;
+		return mountTopAnchorReserve(threadViewportStore);
+	}, () => [toValue(enabled), threadViewportStore]);
+};
+export { useTopAnchorReserve };
+
+//# sourceMappingURL=useTopAnchorReserve.js.map

package/dist/primitives/thread/topAnchor/useTopAnchorReserve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTopAnchorReserve.js","names":[],"sources":["../../../../src/primitives/thread/topAnchor/useTopAnchorReserve.ts"],"sourcesContent":["\"use client\";\n\nimport { toValue, type MaybeRefOrGetter } from \"vue\";\nimport { useIsomorphicLayoutEffect } from \"@ulearning/ai-store/internal\";\nimport { useThreadViewportStore } from \"../../../context/vue/ThreadViewportContext\";\nimport { mountTopAnchorReserve } from \"./mountTopAnchorReserve\";\n\n/**\n * Mounts the top-turn-anchor reserve element against the active\n * `ThreadViewport` store. Call this from inside the scrollable viewport so\n * the reserve `<div>` is appended next to the streaming assistant message.\n */\nexport const useTopAnchorReserve = (enabled: MaybeRefOrGetter<boolean>) => {\n  const threadViewportStore = useThreadViewportStore();\n\n  useIsomorphicLayoutEffect(\n    () => {\n      if (!toValue(enabled)) return;\n      return mountTopAnchorReserve(threadViewportStore);\n    },\n    () => [toValue(enabled), threadViewportStore],\n  );\n};\n"],"mappings":";;;;;;;;;;;AAYA,MAAa,uBAAuB,YAAuC;CACzE,MAAM,sBAAsB,uBAAuB;CAEnD,gCACQ;EACJ,IAAI,CAAC,QAAQ,OAAO,GAAG;EACvB,OAAO,sBAAsB,mBAAmB;CAClD,SACM,CAAC,QAAQ,OAAO,GAAG,mBAAmB,CAC9C;AACF"}

package/dist/primitives/thread/useThreadViewportAutoScroll.d.ts

@@ -0,0 +1,32 @@
+import { type MaybeRefOrGetter } from "vue";
+export declare namespace useThreadViewportAutoScroll {
+    type Options = {
+        /**
+         * Whether to automatically scroll to the bottom when new messages are added.
+         * When enabled, the viewport will automatically scroll to show the latest content.
+         *
+         * Default false if `turnAnchor` is "top", otherwise defaults to true.
+         */
+        autoScroll?: boolean | undefined;
+        /**
+         * Whether to scroll to bottom when a new run starts.
+         *
+         * Defaults to true.
+         */
+        scrollToBottomOnRunStart?: boolean | undefined;
+        /**
+         * Whether to scroll to bottom when messages first appear in the thread.
+         *
+         * Defaults to true.
+         */
+        scrollToBottomOnInitialize?: boolean | undefined;
+        /**
+         * Whether to scroll to bottom when switching to a different thread.
+         *
+         * Defaults to true.
+         */
+        scrollToBottomOnThreadSwitch?: boolean | undefined;
+    };
+}
+export declare const useThreadViewportAutoScroll: <TElement extends HTMLElement>(options: MaybeRefOrGetter<useThreadViewportAutoScroll.Options>) => ((element: TElement | null) => void);
+//# sourceMappingURL=useThreadViewportAutoScroll.d.ts.map

package/dist/primitives/thread/useThreadViewportAutoScroll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThreadViewportAutoScroll.d.ts","mappings":"AAEA,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,KAAK;AAQhE,yBAAiB,2BAA2B,CAAC;IAC3C,KAAY,OAAO,GAAG;QACpB;;;;;;QAMA,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS;QAEhC;;;;;QAKA,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS;QAE9C;;;;;QAKA,0BAA0B,CAAC,EAAE,OAAO,GAAG,SAAS;QAEhD;;;;;QAKA,4BAA4B,CAAC,EAAE,OAAO,GAAG,SAAS;KACnD;;AAGH,eAAO,MAAM,2BAA2B,GAAI,QAAQ,SAAS,WAAW,EACtE,SAAS,gBAAgB,CAAC,2BAA2B,CAAC,OAAO,CAAC,KAC7D,CAAC,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,KAAK,IAAI,CA8FrC","names":[],"ignoreList":[],"sources":["../../../src/primitives/thread/useThreadViewportAutoScroll.ts"],"sourcesContent":[null]}