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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadLoadEarlier.js","names":["computed","useAui","useAuiState","ActionButtonElement","ActionButtonProps","createActionButton","useThreadLoadEarlier","aui","hasEarlier","s","thread","loadEarlier","value","ThreadPrimitiveLoadEarlier","Element","Props"],"sources":["../../../src/primitives/thread/ThreadLoadEarlier.tsx"],"sourcesContent":["\"use client\";\n\nimport { computed } from \"vue\";\nimport { useAui, useAuiState } from \"@ulearning/ai-store\";\nimport {\n  type ActionButtonElement,\n  type ActionButtonProps,\n  createActionButton,\n} from \"../../utils/createActionButton\";\n\nconst useThreadLoadEarlier = () => {\n  const aui = useAui();\n  const hasEarlier = useAuiState((s) => s.thread.hasEarlier);\n  const loadEarlier = () => {\n    void aui.thread.loadEarlier();\n  };\n  return computed(() => (hasEarlier.value ? loadEarlier : null));\n};\n\nexport namespace ThreadPrimitiveLoadEarlier {\n  export type Element = ActionButtonElement;\n  export type Props = ActionButtonProps<typeof useThreadLoadEarlier>;\n}\n\n/**\n * A button that loads the page before the first loaded message. Disabled\n * while the runtime reports no earlier messages. A press while a page is\n * loading joins that load, so the button stays enabled and keeps keyboard\n * focus until the page lands; read `thread.isLoadingEarlier` to show progress.\n */\nexport const ThreadPrimitiveLoadEarlier = createActionButton(\n  \"ThreadPrimitive.LoadEarlier\",\n  useThreadLoadEarlier,\n);\n"],"mappings":";;;;;AAUA,MAAMM,6BAA6B;CACjC,MAAMC,MAAMN,OAAO;CACnB,MAAMO,aAAaN,aAAaO,MAAMA,EAAEC,OAAOF,UAAU;CACzD,MAAMG,oBAAoB;EACxB,IAASD,OAAOC,YAAY;CAC9B;CACA,OAAOX,eAAgBQ,WAAWI,QAAQD,cAAc,IAAK;AAC/D;;;;;;;AAaA,MAAaE,6BAA6BR,mBACxC,+BACAC,oBACF"}

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

@@ -0,0 +1,2 @@
+export { ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveMessageByIndex, ThreadPrimitiveUnstable_MessageById, ThreadPrimitiveRow, } from "@ulearning/ai-core/vue";
+//# sourceMappingURL=ThreadMessages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadMessages.d.ts","mappings":"AAEA,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,6BAA6B,EAC7B,mCAAmC,EACnC,kBAAkB,GACnB,MAAM,wBAAwB","names":[],"ignoreList":[],"sources":["../../../src/primitives/thread/ThreadMessages.tsx"],"sourcesContent":[null]}

package/dist/primitives/thread/ThreadMessages.js

@@ -0,0 +1,2 @@
+"use client";
+export { ThreadPrimitiveMessageByIndex, ThreadPrimitiveMessages, ThreadPrimitiveMessagesImpl, ThreadPrimitiveRow, ThreadPrimitiveUnstable_MessageById } from "@ulearning/ai-core/vue";

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

@@ -0,0 +1,37 @@
+import { type PrimitiveProps } from "../../utils/Primitive.js";
+import { type ComponentPublicInstance } from "vue";
+export declare namespace ThreadPrimitiveRoot {
+    type Element = ComponentPublicInstance;
+    /**
+     * Props for the ThreadPrimitive.Root component.
+     * Accepts all standard div element props.
+     */
+    type Props = PrimitiveProps<"div">;
+}
+/**
+ * The root container component for a thread.
+ *
+ * This component serves as the foundational wrapper for all thread-related components.
+ * It provides the basic structure and context needed for thread functionality.
+ *
+ * While this component is mounted, an unhandled Escape keydown inside this thread stops its
+ * active speech, even if the action bar that started it is no longer mounted. Escape outside
+ * every thread retains the document-level fallback.
+ *
+ * @example
+ * ```tsx
+ * <ThreadPrimitive.Root>
+ *   <ThreadPrimitive.Viewport>
+ *     <ThreadPrimitive.Messages>
+ *       {() => <MyMessage />}
+ *     </ThreadPrimitive.Messages>
+ *   </ThreadPrimitive.Viewport>
+ * </ThreadPrimitive.Root>
+ * ```
+ */
+export declare const ThreadPrimitiveRoot: import("vue").DefineSetupFnComponent<ThreadPrimitiveRoot.Props, {}, {}, import("vue").HTMLAttributes & {
+    render?: import("vue").VNode | undefined;
+    asChild?: boolean | undefined;
+    children?: import("vue").VNodeChild;
+} & {}, import("vue").PublicProps>;
+//# sourceMappingURL=ThreadRoot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadRoot.d.ts","mappings":"AAEA,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,0BAAuB;AAEtE,OAAO,EAML,KAAK,uBAAuB,EAC7B,MAAM,KAAK;AAQZ,yBAAiB,mBAAmB,CAAC;IACnC,KAAY,OAAO,GAAG,uBAAuB;IAC7C;;;;IAIA,KAAY,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;;AAG3C;;;;;;;;;;;;;;;;;;;;;AAqBA,eAAO,MAAM,mBAAmB;;;;kCAqE/B","names":[],"ignoreList":[],"sources":["../../../src/primitives/thread/ThreadRoot.tsx"],"sourcesContent":[null]}

package/dist/primitives/thread/ThreadRoot.js

@@ -0,0 +1,84 @@
+"use client";
+import { Primitive as Primitive$1 } from "../../utils/Primitive.js";
+import { isCompositionKey } from "../../utils/isCompositionKey.js";
+import { ThreadRootElementContext } from "./ThreadRootElementContext.js";
+import { defineComponent, h, mergeProps, provide, shallowRef } from "vue";
+import { useAui } from "@ulearning/ai-store";
+import { useIsomorphicLayoutEffect } from "@ulearning/ai-store/internal";
+import { useForwardExpose } from "reka-ui";
+// src/primitives/thread/ThreadRoot.tsx
+const escapeEventThreadRoots = /* @__PURE__ */ new WeakMap();
+/**
+* The root container component for a thread.
+*
+* This component serves as the foundational wrapper for all thread-related components.
+* It provides the basic structure and context needed for thread functionality.
+*
+* While this component is mounted, an unhandled Escape keydown inside this thread stops its
+* active speech, even if the action bar that started it is no longer mounted. Escape outside
+* every thread retains the document-level fallback.
+*
+* @example
+* ```tsx
+* <ThreadPrimitive.Root>
+*   <ThreadPrimitive.Viewport>
+*     <ThreadPrimitive.Messages>
+*       {() => <MyMessage />}
+*     </ThreadPrimitive.Messages>
+*   </ThreadPrimitive.Viewport>
+* </ThreadPrimitive.Root>
+* ```
+*/
+const ThreadPrimitiveRoot = defineComponent((props, { attrs, slots }) => {
+	const { forwardRef } = useForwardExpose();
+	const aui = useAui();
+	const root = shallowRef(null);
+	provide(ThreadRootElementContext, root);
+	const setElement = (instance) => {
+		forwardRef(instance);
+		const element = instance instanceof Element ? instance : instance?.$el;
+		root.value = element instanceof HTMLElement ? element : null;
+	};
+	const markRoot = (event) => {
+		if (event.key === "Escape" && root.value) escapeEventThreadRoots.set(event, root.value);
+	};
+	useIsomorphicLayoutEffect(() => {
+		const doc = root.value?.ownerDocument;
+		if (!doc) return void 0;
+		const handleKeyDown = (event) => {
+			if (event.key !== "Escape" || isCompositionKey(event)) return;
+			if (event.defaultPrevented || aui.thread.source === null) return;
+			const eventThreadRoot = escapeEventThreadRoots.get(event) ?? event.composedPath().find((target) => target instanceof Element && target.hasAttribute("data-aui-thread-root"));
+			if (eventThreadRoot && eventThreadRoot !== root.value) return;
+			if (aui.thread.getState().speech == null) return;
+			event.preventDefault();
+			try {
+				aui.thread.stopSpeaking();
+			} catch (error) {
+				if (!(error instanceof Error) || error.message !== "No message is being spoken") throw error;
+			}
+		};
+		doc.addEventListener("keydown", handleKeyDown);
+		return () => doc.removeEventListener("keydown", handleKeyDown);
+	});
+	return () => h(Primitive$1.div, {
+		...attrs,
+		render: props.render,
+		asChild: props.asChild,
+		children: props.children,
+		"data-aui-thread-root": "",
+		ref: setElement,
+		...mergeProps({ onKeydown: markRoot }, { onKeydown: attrs.onKeydown })
+	}, slots);
+}, {
+	name: "ThreadPrimitive.Root",
+	inheritAttrs: false,
+	props: [
+		"render",
+		"asChild",
+		"children"
+	]
+});
+export { ThreadPrimitiveRoot };
+
+//# sourceMappingURL=ThreadRoot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadRoot.js","names":["Primitive","PrimitiveProps","isCompositionKey","defineComponent","h","mergeProps","provide","shallowRef","ComponentPublicInstance","useForwardExpose","useIsomorphicLayoutEffect","useAui","ThreadRootElementContext","escapeEventThreadRoots","WeakMap","KeyboardEvent","Element","ThreadPrimitiveRoot","Props","props","attrs","slots","forwardRef","aui","root","HTMLElement","setElement","instance","element","$el","value","markRoot","event","key","set","doc","ownerDocument","undefined","handleKeyDown","defaultPrevented","thread","source","eventThreadRoot","get","composedPath","find","target","hasAttribute","getState","speech","preventDefault","stopSpeaking","error","Error","message","addEventListener","removeEventListener","div","render","asChild","children","ref","onKeydown","name","inheritAttrs","Primitive"],"sources":["../../../src/primitives/thread/ThreadRoot.tsx"],"sourcesContent":["\"use client\";\n\nimport { Primitive, type PrimitiveProps } from \"../../utils/Primitive\";\nimport { isCompositionKey } from \"../../utils/isCompositionKey\";\nimport {\n  defineComponent,\n  h,\n  mergeProps,\n  provide,\n  shallowRef,\n  type ComponentPublicInstance,\n} from \"vue\";\nimport { useForwardExpose } from \"reka-ui\";\nimport { useIsomorphicLayoutEffect } from \"@ulearning/ai-store/internal\";\nimport { useAui } from \"@ulearning/ai-store\";\nimport { ThreadRootElementContext } from \"./ThreadRootElementContext\";\n\nconst escapeEventThreadRoots = new WeakMap<KeyboardEvent, Element>();\n\nexport namespace ThreadPrimitiveRoot {\n  export type Element = ComponentPublicInstance;\n  /**\n   * Props for the ThreadPrimitive.Root component.\n   * Accepts all standard div element props.\n   */\n  export type Props = PrimitiveProps<\"div\">;\n}\n\n/**\n * The root container component for a thread.\n *\n * This component serves as the foundational wrapper for all thread-related components.\n * It provides the basic structure and context needed for thread functionality.\n *\n * While this component is mounted, an unhandled Escape keydown inside this thread stops its\n * active speech, even if the action bar that started it is no longer mounted. Escape outside\n * every thread retains the document-level fallback.\n *\n * @example\n * ```tsx\n * <ThreadPrimitive.Root>\n *   <ThreadPrimitive.Viewport>\n *     <ThreadPrimitive.Messages>\n *       {() => <MyMessage />}\n *     </ThreadPrimitive.Messages>\n *   </ThreadPrimitive.Viewport>\n * </ThreadPrimitive.Root>\n * ```\n */\nexport const ThreadPrimitiveRoot = defineComponent<ThreadPrimitiveRoot.Props>(\n  (props, { attrs, slots }) => {\n    const { forwardRef } = useForwardExpose();\n    const aui = useAui();\n    const root = shallowRef<HTMLElement | null>(null);\n    provide(ThreadRootElementContext, root);\n    const setElement = (instance: Element | ComponentPublicInstance | null) => {\n      forwardRef(instance);\n      const element = instance instanceof Element ? instance : instance?.$el;\n      root.value = element instanceof HTMLElement ? element : null;\n    };\n    const markRoot = (event: KeyboardEvent) => {\n      if (event.key === \"Escape\" && root.value)\n        escapeEventThreadRoots.set(event, root.value);\n    };\n    useIsomorphicLayoutEffect(() => {\n      const doc = root.value?.ownerDocument;\n      if (!doc) return undefined;\n      const handleKeyDown = (event: KeyboardEvent) => {\n        if (event.key !== \"Escape\" || isCompositionKey(event)) return;\n        if (event.defaultPrevented || aui.thread.source === null) return;\n        const eventThreadRoot =\n          escapeEventThreadRoots.get(event) ??\n          event\n            .composedPath()\n            .find(\n              (target) =>\n                target instanceof Element &&\n                target.hasAttribute(\"data-aui-thread-root\"),\n            );\n        if (eventThreadRoot && eventThreadRoot !== root.value) return;\n        if (aui.thread.getState().speech == null) return;\n        event.preventDefault();\n        try {\n          aui.thread.stopSpeaking();\n        } catch (error) {\n          if (\n            !(error instanceof Error) ||\n            error.message !== \"No message is being spoken\"\n          )\n            throw error;\n        }\n      };\n      doc.addEventListener(\"keydown\", handleKeyDown);\n      return () => doc.removeEventListener(\"keydown\", handleKeyDown);\n    });\n    return () =>\n      h(\n        Primitive.div,\n        {\n          ...attrs,\n          render: props.render,\n          asChild: props.asChild,\n          children: props.children,\n          \"data-aui-thread-root\": \"\",\n          ref: setElement,\n          ...mergeProps(\n            { onKeydown: markRoot },\n            { onKeydown: attrs.onKeydown },\n          ),\n        },\n        slots,\n      );\n  },\n  {\n    name: \"ThreadPrimitive.Root\",\n    inheritAttrs: false,\n    props: [\"render\", \"asChild\", \"children\"],\n  },\n);\n"],"mappings":";;;;;;;;;AAiBA,MAAMa,yCAAyB,IAAIC,QAAgC;;;;;;;;;;;;;;;;;;;;;;AAgCnE,MAAaG,sBAAsBd,iBAChCgB,OAAO,EAAEC,OAAOC,YAAY;CAC3B,MAAM,EAAEC,eAAeb,iBAAiB;CACxC,MAAMc,MAAMZ,OAAO;CACnB,MAAMa,OAAOjB,WAA+B,IAAI;CAChDD,QAAQM,0BAA0BY,IAAI;CACtC,MAAME,cAAcC,aAAuD;EACzEL,WAAWK,QAAQ;EACnB,MAAMC,UAAUD,oBAAoBX,UAAUW,WAAWA,UAAUE;EACnEL,KAAKM,QAAQF,mBAAmBH,cAAcG,UAAU;CAC1D;CACA,MAAMG,YAAYC,UAAyB;EACzC,IAAIA,MAAMC,QAAQ,YAAYT,KAAKM,OACjCjB,uBAAuBqB,IAAIF,OAAOR,KAAKM,KAAK;CAChD;CACApB,gCAAgC;EAC9B,MAAMyB,MAAMX,KAAKM,OAAOM;EACxB,IAAI,CAACD,KAAK,OAAOE,KAAAA;EACjB,MAAMC,iBAAiBN,UAAyB;GAC9C,IAAIA,MAAMC,QAAQ,YAAY/B,iBAAiB8B,KAAK,GAAG;GACvD,IAAIA,MAAMO,oBAAoBhB,IAAIiB,OAAOC,WAAW,MAAM;GAC1D,MAAMC,kBACJ7B,uBAAuB8B,IAAIX,KAAK,KAChCA,MACGY,aAAa,CAAC,CACdC,MACEC,WACCA,kBAAkB9B,WAClB8B,OAAOC,aAAa,sBAAsB,CAC9C;GACJ,IAAIL,mBAAmBA,oBAAoBlB,KAAKM,OAAO;GACvD,IAAIP,IAAIiB,OAAOQ,SAAS,CAAC,CAACC,UAAU,MAAM;GAC1CjB,MAAMkB,eAAe;GACrB,IAAI;IACF3B,IAAIiB,OAAOW,aAAa;GAC1B,SAASC,OAAO;IACd,IACE,EAAEA,iBAAiBC,UACnBD,MAAME,YAAY,8BAElB,MAAMF;GACV;EACF;EACAjB,IAAIoB,iBAAiB,WAAWjB,aAAa;EAC7C,aAAaH,IAAIqB,oBAAoB,WAAWlB,aAAa;CAC/D,CAAC;CACD,aACElC,EACEJ,YAAUyD,KACV;EACE,GAAGrC;EACHsC,QAAQvC,MAAMuC;EACdC,SAASxC,MAAMwC;EACfC,UAAUzC,MAAMyC;EAChB,wBAAwB;EACxBC,KAAKnC;EACL,GAAGrB,WACD,EAAEyD,WAAW/B,SAAS,GACtB,EAAE+B,WAAW1C,MAAM0C,UAAU,CAC/B;CACF,GACAzC,KACF;AACJ,GACA;CACE0C,MAAM;CACNC,cAAc;CACd7C,OAAO;EAAC;EAAU;EAAW;CAAU;AACzC,CACF"}

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

@@ -0,0 +1,4 @@
+import { type InjectionKey, type ShallowRef } from "vue";
+export declare const ThreadRootElementContext: InjectionKey<ShallowRef<HTMLElement | null>>;
+export declare const useThreadRootElementRef: () => ShallowRef<HTMLElement | null> | undefined;
+//# sourceMappingURL=ThreadRootElementContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadRootElementContext.d.ts","mappings":"AAEA,OAAO,EAAU,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,KAAK;AAEhE,eAAO,MAAM,wBAAwB,EAAE,YAAY,CACjD,UAAU,CAAC,WAAW,GAAG,IAAI,CAAC,CACG;AACnC,eAAO,MAAM,uBAAuB,kDACS","names":[],"ignoreList":[],"sources":["../../../src/primitives/thread/ThreadRootElementContext.ts"],"sourcesContent":[null]}

package/dist/primitives/thread/ThreadRootElementContext.js

@@ -0,0 +1,8 @@
+"use client";
+import { inject } from "vue";
+// src/primitives/thread/ThreadRootElementContext.ts
+const ThreadRootElementContext = Symbol("aui.ThreadRootElement");
+const useThreadRootElementRef = () => inject(ThreadRootElementContext, void 0);
+export { ThreadRootElementContext, useThreadRootElementRef };
+
+//# sourceMappingURL=ThreadRootElementContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadRootElementContext.js","names":[],"sources":["../../../src/primitives/thread/ThreadRootElementContext.ts"],"sourcesContent":["\"use client\";\n\nimport { inject, type InjectionKey, type ShallowRef } from \"vue\";\n\nexport const ThreadRootElementContext: InjectionKey<\n  ShallowRef<HTMLElement | null>\n> = Symbol(\"aui.ThreadRootElement\");\nexport const useThreadRootElementRef = () =>\n  inject(ThreadRootElementContext, undefined);\n"],"mappings":";;;AAIA,MAAa,2BAET,OAAO,uBAAuB;AAClC,MAAa,gCACX,OAAO,0BAA0B,KAAA,CAAS"}

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

@@ -0,0 +1,22 @@
+import { type ActionButtonElement, type ActionButtonProps } from "../../utils/createActionButton.js";
+export declare namespace useThreadScrollToBottom {
+    type Options = {
+        behavior?: ScrollBehavior | undefined;
+    };
+}
+declare const useThreadScrollToBottom: (options?: useThreadScrollToBottom.Options) => import("vue").ComputedRef<(() => void) | null>;
+export declare namespace ThreadPrimitiveScrollToBottom {
+    type Element = ActionButtonElement;
+    type Props = ActionButtonProps<typeof useThreadScrollToBottom>;
+}
+export declare const ThreadPrimitiveScrollToBottom: import("vue").DefineSetupFnComponent<import("vue").ButtonHTMLAttributes & {
+    render?: import("vue").VNode | undefined;
+    asChild?: boolean | undefined;
+    children?: import("vue").VNodeChild;
+} & useThreadScrollToBottom.Options, {}, {}, import("vue").ButtonHTMLAttributes & {
+    render?: import("vue").VNode | undefined;
+    asChild?: boolean | undefined;
+    children?: import("vue").VNodeChild;
+} & useThreadScrollToBottom.Options & {}, import("vue").PublicProps>;
+export {};
+//# sourceMappingURL=ThreadScrollToBottom.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadScrollToBottom.d.ts","mappings":"AAEA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAEvB,MAAM,mCAAgC;AAOvC,yBAAiB,uBAAuB,CAAC;IACvC,KAAY,OAAO,GAAG;QACpB,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS;KACtC;;AAGH,cAAM,uBAAuB,GAC3B,UAAS,uBAAuB,CAAC,OAAY,mDAa9C;AAED,yBAAiB,6BAA6B,CAAC;IAC7C,KAAY,OAAO,GAAG,mBAAmB;IACzC,KAAY,KAAK,GAAG,iBAAiB,CAAC,OAAO,uBAAuB,CAAC;;AAGvE,eAAO,MAAM,6BAA6B;;;;;;;;oEAIzC","names":[],"ignoreList":[],"sources":["../../../src/primitives/thread/ThreadScrollToBottom.ts"],"sourcesContent":[null]}

package/dist/primitives/thread/ThreadScrollToBottom.js

@@ -0,0 +1,17 @@
+"use client";
+import { useThreadViewport, useThreadViewportStore } from "../../context/vue/ThreadViewportContext.js";
+import { createActionButton } from "../../utils/createActionButton.js";
+import { computed } from "vue";
+// src/primitives/thread/ThreadScrollToBottom.ts
+const useThreadScrollToBottom = (options = {}) => {
+	const isAtBottom = useThreadViewport((s) => s.isAtBottom);
+	const threadViewportStore = useThreadViewportStore();
+	const handleScrollToBottom = () => {
+		threadViewportStore.getState().scrollToBottom({ behavior: options.behavior });
+	};
+	return computed(() => isAtBottom.value ? null : handleScrollToBottom);
+};
+const ThreadPrimitiveScrollToBottom = createActionButton("ThreadPrimitive.ScrollToBottom", useThreadScrollToBottom, ["behavior"]);
+export { ThreadPrimitiveScrollToBottom };
+
+//# sourceMappingURL=ThreadScrollToBottom.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadScrollToBottom.js","names":[],"sources":["../../../src/primitives/thread/ThreadScrollToBottom.ts"],"sourcesContent":["\"use client\";\n\nimport {\n  type ActionButtonElement,\n  type ActionButtonProps,\n  createActionButton,\n} from \"../../utils/createActionButton\";\nimport { computed } from \"vue\";\nimport {\n  useThreadViewport,\n  useThreadViewportStore,\n} from \"../../context/vue/ThreadViewportContext\";\n\nexport namespace useThreadScrollToBottom {\n  export type Options = {\n    behavior?: ScrollBehavior | undefined;\n  };\n}\n\nconst useThreadScrollToBottom = (\n  options: useThreadScrollToBottom.Options = {},\n) => {\n  const isAtBottom = useThreadViewport((s) => s.isAtBottom);\n\n  const threadViewportStore = useThreadViewportStore();\n\n  const handleScrollToBottom = () => {\n    threadViewportStore\n      .getState()\n      .scrollToBottom({ behavior: options.behavior });\n  };\n\n  return computed(() => (isAtBottom.value ? null : handleScrollToBottom));\n};\n\nexport namespace ThreadPrimitiveScrollToBottom {\n  export type Element = ActionButtonElement;\n  export type Props = ActionButtonProps<typeof useThreadScrollToBottom>;\n}\n\nexport const ThreadPrimitiveScrollToBottom = createActionButton(\n  \"ThreadPrimitive.ScrollToBottom\",\n  useThreadScrollToBottom,\n  [\"behavior\"],\n);\n"],"mappings":";;;;;AAmBA,MAAM,2BACJ,UAA2C,CAAC,MACzC;CACH,MAAM,aAAa,mBAAmB,MAAM,EAAE,UAAU;CAExD,MAAM,sBAAsB,uBAAuB;CAEnD,MAAM,6BAA6B;EACjC,oBACG,SAAS,CAAC,CACV,eAAe,EAAE,UAAU,QAAQ,SAAS,CAAC;CAClD;CAEA,OAAO,eAAgB,WAAW,QAAQ,OAAO,oBAAqB;AACxE;AAOA,MAAa,gCAAgC,mBAC3C,kCACA,yBACA,CAAC,UAAU,CACb"}

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

@@ -0,0 +1,80 @@
+import { type ActionButtonElement, type ActionButtonProps } from "../../utils/createActionButton.js";
+declare const useThreadSuggestion: (options: {
+    /** The suggestion prompt. */
+    prompt: string;
+    /**
+     * When true, automatically sends the message.
+     * When false, replaces or appends the composer text with the suggestion - depending on the value of `clearComposer`.
+     */
+    send?: boolean | undefined;
+    /**
+     * Whether to clear the composer after sending. A send queued while a run is
+     * in progress never clears the composer.
+     * When send is set to false, determines if composer text is replaced with suggestion (true, default),
+     * or if it's appended to the composer text (false).
+     *
+     * @default true
+     */
+    clearComposer?: boolean | undefined;
+    /** @deprecated Use `send` instead. */
+    autoSend?: boolean | undefined;
+    /** @deprecated Use `clearComposer` instead. */
+    method?: "replace";
+}) => import("vue").ComputedRef<(() => void) | null>;
+export declare namespace ThreadPrimitiveSuggestion {
+    type Element = ActionButtonElement;
+    type Props = ActionButtonProps<typeof useThreadSuggestion>;
+}
+export declare const ThreadPrimitiveSuggestion: import("vue").DefineSetupFnComponent<import("vue").ButtonHTMLAttributes & {
+    render?: import("vue").VNode | undefined;
+    asChild?: boolean | undefined;
+    children?: import("vue").VNodeChild;
+} & {
+    /** The suggestion prompt. */
+    prompt: string;
+    /**
+     * When true, automatically sends the message.
+     * When false, replaces or appends the composer text with the suggestion - depending on the value of `clearComposer`.
+     */
+    send?: boolean | undefined;
+    /**
+     * Whether to clear the composer after sending. A send queued while a run is
+     * in progress never clears the composer.
+     * When send is set to false, determines if composer text is replaced with suggestion (true, default),
+     * or if it's appended to the composer text (false).
+     *
+     * @default true
+     */
+    clearComposer?: boolean | undefined;
+    /** @deprecated Use `send` instead. */
+    autoSend?: boolean | undefined;
+    /** @deprecated Use `clearComposer` instead. */
+    method?: "replace";
+}, {}, {}, import("vue").ButtonHTMLAttributes & {
+    render?: import("vue").VNode | undefined;
+    asChild?: boolean | undefined;
+    children?: import("vue").VNodeChild;
+} & {
+    /** The suggestion prompt. */
+    prompt: string;
+    /**
+     * When true, automatically sends the message.
+     * When false, replaces or appends the composer text with the suggestion - depending on the value of `clearComposer`.
+     */
+    send?: boolean | undefined;
+    /**
+     * Whether to clear the composer after sending. A send queued while a run is
+     * in progress never clears the composer.
+     * When send is set to false, determines if composer text is replaced with suggestion (true, default),
+     * or if it's appended to the composer text (false).
+     *
+     * @default true
+     */
+    clearComposer?: boolean | undefined;
+    /** @deprecated Use `send` instead. */
+    autoSend?: boolean | undefined;
+    /** @deprecated Use `clearComposer` instead. */
+    method?: "replace";
+} & {}, import("vue").PublicProps>;
+export {};
+//# sourceMappingURL=ThreadSuggestion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadSuggestion.d.ts","mappings":"AAIA,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EAEvB,MAAM,mCAAgC;AAGvC,cAAM,mBAAmB,GAAI,SAAS;IACpC;IACA,MAAM,EAAE,MAAM;IAEd;;;;IAIA,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS;IAE1B;;;;;;;;IAQA,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS;IAEnC;IACA,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS;IAE9B;IACA,MAAM,CAAC,EAAE,SAAS;CACnB,mDAOA;AAED,yBAAiB,yBAAyB,CAAC;IACzC,KAAY,OAAO,GAAG,mBAAmB;IACzC,KAAY,KAAK,GAAG,iBAAiB,CAAC,OAAO,mBAAmB,CAAC;;AAGnE,eAAO,MAAM,yBAAyB;;;;;IAtCpC;YACQ,MAAM;IAEd;;;;WAIO,OAAO,GAAG,SAAS;IAE1B;;;;;;;;oBAQgB,OAAO,GAAG,SAAS;IAEnC;eACW,OAAO,GAAG,SAAS;IAE9B;aACS,SAAS;;;;;;IAvBlB;YACQ,MAAM;IAEd;;;;WAIO,OAAO,GAAG,SAAS;IAE1B;;;;;;;;oBAQgB,OAAO,GAAG,SAAS;IAEnC;eACW,OAAO,GAAG,SAAS;IAE9B;aACS,SAAS;kCAmBnB","names":[],"ignoreList":[],"sources":["../../../src/primitives/thread/ThreadSuggestion.ts"],"sourcesContent":[null]}

package/dist/primitives/thread/ThreadSuggestion.js

@@ -0,0 +1,23 @@
+"use client";
+import { createActionButton } from "../../utils/createActionButton.js";
+import { useSuggestionTrigger } from "@ulearning/ai-core/vue";
+import { computed } from "vue";
+// src/primitives/thread/ThreadSuggestion.ts
+const useThreadSuggestion = (options) => {
+	const { disabled, trigger } = useSuggestionTrigger(() => ({
+		prompt: options.prompt,
+		send: options.send ?? options.autoSend ?? false,
+		clearComposer: options.clearComposer
+	}));
+	return computed(() => disabled.value ? null : trigger);
+};
+const ThreadPrimitiveSuggestion = createActionButton("ThreadPrimitive.Suggestion", useThreadSuggestion, [
+	"prompt",
+	"send",
+	"clearComposer",
+	"autoSend",
+	"method"
+]);
+export { ThreadPrimitiveSuggestion };
+
+//# sourceMappingURL=ThreadSuggestion.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadSuggestion.js","names":["useSuggestionTriggerBehavior"],"sources":["../../../src/primitives/thread/ThreadSuggestion.ts"],"sourcesContent":["\"use client\";\n\nimport { computed } from \"vue\";\n\nimport {\n  type ActionButtonElement,\n  type ActionButtonProps,\n  createActionButton,\n} from \"../../utils/createActionButton\";\nimport { useSuggestionTrigger as useSuggestionTriggerBehavior } from \"@ulearning/ai-core/vue\";\n\nconst useThreadSuggestion = (options: {\n  /** The suggestion prompt. */\n  prompt: string;\n\n  /**\n   * When true, automatically sends the message.\n   * When false, replaces or appends the composer text with the suggestion - depending on the value of `clearComposer`.\n   */\n  send?: boolean | undefined;\n\n  /**\n   * Whether to clear the composer after sending. A send queued while a run is\n   * in progress never clears the composer.\n   * When send is set to false, determines if composer text is replaced with suggestion (true, default),\n   * or if it's appended to the composer text (false).\n   *\n   * @default true\n   */\n  clearComposer?: boolean | undefined;\n\n  /** @deprecated Use `send` instead. */\n  autoSend?: boolean | undefined;\n\n  /** @deprecated Use `clearComposer` instead. */\n  method?: \"replace\";\n}) => {\n  const { disabled, trigger } = useSuggestionTriggerBehavior(() => ({\n    prompt: options.prompt,\n    send: options.send ?? options.autoSend ?? false,\n    clearComposer: options.clearComposer,\n  }));\n  return computed(() => (disabled.value ? null : trigger));\n};\n\nexport namespace ThreadPrimitiveSuggestion {\n  export type Element = ActionButtonElement;\n  export type Props = ActionButtonProps<typeof useThreadSuggestion>;\n}\n\nexport const ThreadPrimitiveSuggestion = createActionButton(\n  \"ThreadPrimitive.Suggestion\",\n  useThreadSuggestion,\n  [\"prompt\", \"send\", \"clearComposer\", \"autoSend\", \"method\"],\n);\n"],"mappings":";;;;;AAWA,MAAM,uBAAuB,YAyBvB;CACJ,MAAM,EAAE,UAAU,YAAYA,4BAAoC;EAChE,QAAQ,QAAQ;EAChB,MAAM,QAAQ,QAAQ,QAAQ,YAAY;EAC1C,eAAe,QAAQ;CACzB,EAAE;CACF,OAAO,eAAgB,SAAS,QAAQ,OAAO,OAAQ;AACzD;AAOA,MAAa,4BAA4B,mBACvC,8BACA,qBACA;CAAC;CAAU;CAAQ;CAAiB;CAAY;AAAQ,CAC1D"}

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

@@ -0,0 +1,2 @@
+export { ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl, ThreadPrimitiveSuggestionByIndex, } from "@ulearning/ai-core/vue";
+//# sourceMappingURL=ThreadSuggestions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadSuggestions.d.ts","mappings":"AAEA,OAAO,EACL,0BAA0B,EAC1B,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,wBAAwB","names":[],"ignoreList":[],"sources":["../../../src/primitives/thread/ThreadSuggestions.tsx"],"sourcesContent":[null]}

package/dist/primitives/thread/ThreadSuggestions.js

@@ -0,0 +1,2 @@
+"use client";
+export { ThreadPrimitiveSuggestionByIndex, ThreadPrimitiveSuggestions, ThreadPrimitiveSuggestionsImpl } from "@ulearning/ai-core/vue";

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

@@ -0,0 +1,115 @@
+import { type ComponentPublicInstance } from "vue";
+import { type PrimitiveProps } from "../../utils/Primitive.js";
+export declare namespace ThreadPrimitiveViewport {
+    type Element = ComponentPublicInstance;
+    type Props = PrimitiveProps<"div"> & {
+        /**
+         * 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;
+        /**
+         * Controls scroll anchoring behavior for new messages.
+         * - "bottom" (default): Messages anchor at the bottom, classic chat behavior.
+         * - "top": New user messages anchor at the top of the viewport for a focused reading experience.
+         */
+        turnAnchor?: "top" | "bottom" | undefined;
+        /**
+         * Clamps tall user messages so the assistant response stays in view.
+         *
+         * @default { tallerThan: "10em", visibleHeight: "6em" }
+         */
+        topAnchorMessageClamp?: {
+            /**
+             * Clamp messages taller than this. Supports `px`, `em`, and `rem`.
+             *
+             * @default "10em"
+             */
+            tallerThan?: string;
+            /**
+             * Visible portion of clamped messages. Supports `px`, `em`, and `rem`.
+             *
+             * @default "6em"
+             */
+            visibleHeight?: string;
+        };
+        /**
+         * Whether to scroll to bottom when a new run starts.
+         *
+         * Defaults to true.
+         */
+        scrollToBottomOnRunStart?: boolean | undefined;
+        /**
+         * Whether to scroll to bottom when thread history is first loaded.
+         *
+         * Defaults to true.
+         */
+        scrollToBottomOnInitialize?: boolean | undefined;
+        /**
+         * Whether to scroll to bottom when switching to a different thread.
+         *
+         * Defaults to true.
+         */
+        scrollToBottomOnThreadSwitch?: boolean | undefined;
+    };
+}
+/** A scrollable thread viewport with bottom or top turn anchoring. */
+export declare const ThreadPrimitiveViewport: import("vue").DefineSetupFnComponent<ThreadPrimitiveViewport.Props, {}, {}, import("vue").HTMLAttributes & {
+    render?: import("vue").VNode | undefined;
+    asChild?: boolean | undefined;
+    children?: import("vue").VNodeChild;
+} & {
+    /**
+     * 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;
+    /**
+     * Controls scroll anchoring behavior for new messages.
+     * - "bottom" (default): Messages anchor at the bottom, classic chat behavior.
+     * - "top": New user messages anchor at the top of the viewport for a focused reading experience.
+     */
+    turnAnchor?: "top" | "bottom" | undefined;
+    /**
+     * Clamps tall user messages so the assistant response stays in view.
+     *
+     * @default { tallerThan: "10em", visibleHeight: "6em" }
+     */
+    topAnchorMessageClamp?: {
+        /**
+         * Clamp messages taller than this. Supports `px`, `em`, and `rem`.
+         *
+         * @default "10em"
+         */
+        tallerThan?: string;
+        /**
+         * Visible portion of clamped messages. Supports `px`, `em`, and `rem`.
+         *
+         * @default "6em"
+         */
+        visibleHeight?: string;
+    };
+    /**
+     * Whether to scroll to bottom when a new run starts.
+     *
+     * Defaults to true.
+     */
+    scrollToBottomOnRunStart?: boolean | undefined;
+    /**
+     * Whether to scroll to bottom when thread history is first loaded.
+     *
+     * Defaults to true.
+     */
+    scrollToBottomOnInitialize?: boolean | undefined;
+    /**
+     * Whether to scroll to bottom when switching to a different thread.
+     *
+     * Defaults to true.
+     */
+    scrollToBottomOnThreadSwitch?: boolean | undefined;
+} & {}, import("vue").PublicProps>;
+//# sourceMappingURL=ThreadViewport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadViewport.d.ts","mappings":"AAEA,OAAO,EAIL,KAAK,uBAAuB,EAG7B,MAAM,KAAK;AAEZ,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,0BAAuB;AAiBtE,yBAAiB,uBAAuB,CAAC;IACvC,KAAY,OAAO,GAAG,uBAAuB;IAC7C,KAAY,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG;QAC1C;;;;;;QAMA,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS;QAEhC;;;;;QAKA,UAAU,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,SAAS;QAEzC;;;;;QAKA,qBAAqB,CAAC,EAAE;YACtB;;;;;YAKA,UAAU,CAAC,EAAE,MAAM;YACnB;;;;;YAKA,aAAa,CAAC,EAAE,MAAM;SACvB;QAED;;;;;QAKA,wBAAwB,CAAC,EAAE,OAAO,GAAG,SAAS;QAE9C;;;;;QAKA,0BAA0B,CAAC,EAAE,OAAO,GAAG,SAAS;QAEhD;;;;;QAKA,4BAA4B,CAAC,EAAE,OAAO,GAAG,SAAS;KACnD;;AAwGH;AACA,eAAO,MAAM,uBAAuB;;;;;IAhKhC;;;;;;iBAMa,OAAO,GAAG,SAAS;IAEhC;;;;;iBAKa,KAAK,GAAG,QAAQ,GAAG,SAAS;IAEzC;;;;;4BAKwB;QACtB;;;;;QAKA,UAAU,CAAC,EAAE,MAAM;QACnB;;;;;QAKA,aAAa,CAAC,EAAE,MAAM;KACvB;IAED;;;;;+BAK2B,OAAO,GAAG,SAAS;IAE9C;;;;;iCAK6B,OAAO,GAAG,SAAS;IAEhD;;;;;mCAK+B,OAAO,GAAG,SAAS;kCAqIrD","names":[],"ignoreList":[],"sources":["../../../src/primitives/thread/ThreadViewport.tsx"],"sourcesContent":[null]}

package/dist/primitives/thread/ThreadViewport.js

@@ -0,0 +1,96 @@
+"use client";
+import { useThreadViewport, useThreadViewportStore } from "../../context/vue/ThreadViewportContext.js";
+import { ThreadPrimitiveViewportProvider } from "../../context/providers/ThreadViewportProvider.js";
+import { Primitive as Primitive$1 } from "../../utils/Primitive.js";
+import { useManagedRef } from "../../utils/hooks/useManagedRef.js";
+import { useThreadViewportAutoScroll } from "./useThreadViewportAutoScroll.js";
+import { useSizeHandle } from "../../utils/hooks/useSizeHandle.js";
+import { useTopAnchorReserve } from "./topAnchor/useTopAnchorReserve.js";
+import { getActiveTopAnchorAnchorId, getActiveTopAnchorTargetId, isTopAnchorTurnValid } from "./topAnchor/topAnchorTurn.js";
+import { computed, defineComponent, h, toValue } from "vue";
+import { useAuiState } from "@ulearning/ai-store";
+import { useIsomorphicLayoutEffect } from "@ulearning/ai-store/internal";
+import { useForwardExpose } from "reka-ui";
+// src/primitives/thread/ThreadViewport.tsx
+const useTopAnchorTurn = (enabled) => {
+	const threadViewportStore = useThreadViewportStore();
+	const activeAnchorId = useAuiState((s) => toValue(enabled) ? getActiveTopAnchorAnchorId(s.thread) : void 0);
+	const activeTargetId = useAuiState((s) => toValue(enabled) ? getActiveTopAnchorTargetId(s.thread) : void 0);
+	const topAnchorTurn = useThreadViewport((s) => s.topAnchorTurn);
+	const activeTurn = computed(() => activeAnchorId.value && activeTargetId.value ? {
+		anchorId: activeAnchorId.value,
+		targetId: activeTargetId.value
+	} : null);
+	const topAnchorTurnIsValid = useAuiState((s) => toValue(enabled) && !!topAnchorTurn.value && isTopAnchorTurnValid(topAnchorTurn.value, s.thread.messages));
+	useIsomorphicLayoutEffect(() => {
+		if (!topAnchorTurn.value || topAnchorTurnIsValid.value) return;
+		threadViewportStore.getState().setTopAnchorTurn(null);
+	}, () => [topAnchorTurn.value, topAnchorTurnIsValid.value]);
+	useIsomorphicLayoutEffect(() => {
+		if (!activeTurn.value) return;
+		const state = threadViewportStore.getState();
+		const current = state.topAnchorTurn;
+		if (current?.anchorId === activeTurn.value.anchorId && current.targetId === activeTurn.value.targetId) return;
+		state.setTopAnchorTurn(activeTurn.value);
+	}, () => [activeTurn.value]);
+};
+const viewportProps = [
+	"render",
+	"asChild",
+	"children",
+	"autoScroll",
+	"scrollToBottomOnRunStart",
+	"scrollToBottomOnInitialize",
+	"scrollToBottomOnThreadSwitch",
+	"turnAnchor",
+	"topAnchorMessageClamp"
+];
+const ThreadPrimitiveViewportScrollable = defineComponent((props, { attrs, slots }) => {
+	const { forwardRef } = useForwardExpose();
+	const autoScrollRef = useThreadViewportAutoScroll(() => props);
+	const registerSize = useThreadViewport((s) => s.registerViewport);
+	const viewportSizeRef = useSizeHandle(registerSize, (element) => element.clientHeight);
+	const registerElement = useThreadViewport((s) => s.registerViewportElement);
+	const viewportElementRef = useManagedRef((element) => registerElement.value(element));
+	const topAnchorEnabled = useThreadViewportStore().getState().turnAnchor === "top";
+	useTopAnchorTurn(topAnchorEnabled);
+	useTopAnchorReserve(topAnchorEnabled);
+	const setElement = (instance) => {
+		forwardRef(instance);
+		const candidate = instance instanceof Element ? instance : instance?.$el;
+		const element = candidate instanceof HTMLElement ? candidate : null;
+		autoScrollRef(element);
+		viewportSizeRef(element);
+		viewportElementRef(element);
+	};
+	return () => h(Primitive$1.div, {
+		...attrs,
+		render: props.render,
+		asChild: props.asChild,
+		children: props.children,
+		ref: setElement
+	}, slots);
+}, {
+	name: "ThreadPrimitive.ViewportScrollable",
+	inheritAttrs: false,
+	props: [...viewportProps]
+});
+/** A scrollable thread viewport with bottom or top turn anchoring. */
+const ThreadPrimitiveViewport = defineComponent((props, { attrs, slots }) => {
+	const { forwardRef } = useForwardExpose();
+	return () => h(ThreadPrimitiveViewportProvider, { options: {
+		turnAnchor: props.turnAnchor,
+		topAnchorMessageClamp: props.topAnchorMessageClamp
+	} }, { default: () => h(ThreadPrimitiveViewportScrollable, {
+		...attrs,
+		...props,
+		ref: forwardRef
+	}, slots) });
+}, {
+	name: "ThreadPrimitive.Viewport",
+	inheritAttrs: false,
+	props: [...viewportProps]
+});
+export { ThreadPrimitiveViewport };
+
+//# sourceMappingURL=ThreadViewport.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadViewport.js","names":["computed","defineComponent","h","ComponentPublicInstance","MaybeRefOrGetter","toValue","useForwardExpose","Primitive","PrimitiveProps","useAuiState","useIsomorphicLayoutEffect","useManagedRef","useThreadViewportAutoScroll","ThreadPrimitiveViewportProvider","useSizeHandle","useThreadViewport","useThreadViewportStore","useTopAnchorReserve","getActiveTopAnchorAnchorId","getActiveTopAnchorTargetId","isTopAnchorTurnValid","ThreadPrimitiveViewport","Element","Props","autoScroll","turnAnchor","topAnchorMessageClamp","tallerThan","visibleHeight","scrollToBottomOnRunStart","scrollToBottomOnInitialize","scrollToBottomOnThreadSwitch","useTopAnchorTurn","enabled","threadViewportStore","activeAnchorId","s","thread","undefined","activeTargetId","topAnchorTurn","activeTurn","value","anchorId","targetId","topAnchorTurnIsValid","messages","getState","setTopAnchorTurn","state","current","viewportProps","const","ThreadPrimitiveViewportScrollable","props","attrs","slots","forwardRef","autoScrollRef","HTMLElement","registerSize","registerViewport","viewportSizeRef","element","clientHeight","registerElement","registerViewportElement","viewportElementRef","topAnchorEnabled","setElement","instance","candidate","$el","div","render","asChild","children","ref","name","inheritAttrs","options","default","Primitive"],"sources":["../../../src/primitives/thread/ThreadViewport.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  computed,\n  defineComponent,\n  h,\n  type ComponentPublicInstance,\n  type MaybeRefOrGetter,\n  toValue,\n} from \"vue\";\nimport { useForwardExpose } from \"reka-ui\";\nimport { Primitive, type PrimitiveProps } from \"../../utils/Primitive\";\nimport { useAuiState } from \"@ulearning/ai-store\";\nimport { useIsomorphicLayoutEffect } from \"@ulearning/ai-store/internal\";\nimport { useManagedRef } from \"../../utils/hooks/useManagedRef\";\nimport { useThreadViewportAutoScroll } from \"./useThreadViewportAutoScroll\";\nimport { ThreadPrimitiveViewportProvider } from \"../../context/providers/ThreadViewportProvider\";\nimport { useSizeHandle } from \"../../utils/hooks/useSizeHandle\";\nimport {\n  useThreadViewport,\n  useThreadViewportStore,\n} from \"../../context/vue/ThreadViewportContext\";\nimport { useTopAnchorReserve } from \"./topAnchor/useTopAnchorReserve\";\nimport {\n  getActiveTopAnchorAnchorId,\n  getActiveTopAnchorTargetId,\n  isTopAnchorTurnValid,\n} from \"./topAnchor/topAnchorTurn\";\nexport namespace ThreadPrimitiveViewport {\n  export type Element = ComponentPublicInstance;\n  export type Props = PrimitiveProps<\"div\"> & {\n    /**\n     * Whether to automatically scroll to the bottom when new messages are added.\n     * When enabled, the viewport will automatically scroll to show the latest content.\n     *\n     * Default false if `turnAnchor` is \"top\", otherwise defaults to true.\n     */\n    autoScroll?: boolean | undefined;\n\n    /**\n     * Controls scroll anchoring behavior for new messages.\n     * - \"bottom\" (default): Messages anchor at the bottom, classic chat behavior.\n     * - \"top\": New user messages anchor at the top of the viewport for a focused reading experience.\n     */\n    turnAnchor?: \"top\" | \"bottom\" | undefined;\n\n    /**\n     * Clamps tall user messages so the assistant response stays in view.\n     *\n     * @default { tallerThan: \"10em\", visibleHeight: \"6em\" }\n     */\n    topAnchorMessageClamp?: {\n      /**\n       * Clamp messages taller than this. Supports `px`, `em`, and `rem`.\n       *\n       * @default \"10em\"\n       */\n      tallerThan?: string;\n      /**\n       * Visible portion of clamped messages. Supports `px`, `em`, and `rem`.\n       *\n       * @default \"6em\"\n       */\n      visibleHeight?: string;\n    };\n\n    /**\n     * Whether to scroll to bottom when a new run starts.\n     *\n     * Defaults to true.\n     */\n    scrollToBottomOnRunStart?: boolean | undefined;\n\n    /**\n     * Whether to scroll to bottom when thread history is first loaded.\n     *\n     * Defaults to true.\n     */\n    scrollToBottomOnInitialize?: boolean | undefined;\n\n    /**\n     * Whether to scroll to bottom when switching to a different thread.\n     *\n     * Defaults to true.\n     */\n    scrollToBottomOnThreadSwitch?: boolean | undefined;\n  };\n}\n\nconst useTopAnchorTurn = (enabled: MaybeRefOrGetter<boolean>) => {\n  const threadViewportStore = useThreadViewportStore();\n  const activeAnchorId = useAuiState((s) =>\n    toValue(enabled) ? getActiveTopAnchorAnchorId(s.thread) : undefined,\n  );\n  const activeTargetId = useAuiState((s) =>\n    toValue(enabled) ? getActiveTopAnchorTargetId(s.thread) : undefined,\n  );\n  const topAnchorTurn = useThreadViewport((s) => s.topAnchorTurn);\n  const activeTurn = computed(() =>\n    activeAnchorId.value && activeTargetId.value\n      ? { anchorId: activeAnchorId.value, targetId: activeTargetId.value }\n      : null,\n  );\n  const topAnchorTurnIsValid = useAuiState(\n    (s) =>\n      toValue(enabled) &&\n      !!topAnchorTurn.value &&\n      isTopAnchorTurnValid(topAnchorTurn.value, s.thread.messages),\n  );\n\n  useIsomorphicLayoutEffect(\n    () => {\n      if (!topAnchorTurn.value || topAnchorTurnIsValid.value) return;\n      threadViewportStore.getState().setTopAnchorTurn(null);\n    },\n    () => [topAnchorTurn.value, topAnchorTurnIsValid.value],\n  );\n  useIsomorphicLayoutEffect(\n    () => {\n      if (!activeTurn.value) return;\n      const state = threadViewportStore.getState();\n      const current = state.topAnchorTurn;\n      if (\n        current?.anchorId === activeTurn.value.anchorId &&\n        current.targetId === activeTurn.value.targetId\n      )\n        return;\n      state.setTopAnchorTurn(activeTurn.value);\n    },\n    () => [activeTurn.value],\n  );\n};\n\nconst viewportProps = [\n  \"render\",\n  \"asChild\",\n  \"children\",\n  \"autoScroll\",\n  \"scrollToBottomOnRunStart\",\n  \"scrollToBottomOnInitialize\",\n  \"scrollToBottomOnThreadSwitch\",\n  \"turnAnchor\",\n  \"topAnchorMessageClamp\",\n] as const;\nconst ThreadPrimitiveViewportScrollable = defineComponent(\n  (props: ThreadPrimitiveViewport.Props, { attrs, slots }) => {\n    const { forwardRef } = useForwardExpose();\n    const autoScrollRef = useThreadViewportAutoScroll<HTMLElement>(() => props);\n    const registerSize = useThreadViewport((s) => s.registerViewport);\n    const viewportSizeRef = useSizeHandle(\n      registerSize,\n      (element) => element.clientHeight,\n    );\n    const registerElement = useThreadViewport((s) => s.registerViewportElement);\n    const viewportElementRef = useManagedRef<HTMLElement>((element) =>\n      registerElement.value(element),\n    );\n    const threadViewportStore = useThreadViewportStore();\n    const topAnchorEnabled =\n      threadViewportStore.getState().turnAnchor === \"top\";\n    useTopAnchorTurn(topAnchorEnabled);\n    useTopAnchorReserve(topAnchorEnabled);\n    const setElement = (instance: Element | ComponentPublicInstance | null) => {\n      forwardRef(instance);\n      const candidate = instance instanceof Element ? instance : instance?.$el;\n      const element = candidate instanceof HTMLElement ? candidate : null;\n      autoScrollRef(element);\n      viewportSizeRef(element);\n      viewportElementRef(element);\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.ViewportScrollable\",\n    inheritAttrs: false,\n    props: [...viewportProps],\n  },\n);\n\n/** A scrollable thread viewport with bottom or top turn anchoring. */\nexport const ThreadPrimitiveViewport = defineComponent(\n  (props: ThreadPrimitiveViewport.Props, { attrs, slots }) => {\n    const { forwardRef } = useForwardExpose();\n    return () =>\n      h(\n        ThreadPrimitiveViewportProvider,\n        {\n          options: {\n            turnAnchor: props.turnAnchor,\n            topAnchorMessageClamp: props.topAnchorMessageClamp,\n          },\n        },\n        {\n          default: () =>\n            h(\n              ThreadPrimitiveViewportScrollable,\n              { ...attrs, ...props, ref: forwardRef },\n              slots,\n            ),\n        },\n      );\n  },\n  {\n    name: \"ThreadPrimitive.Viewport\",\n    inheritAttrs: false,\n    props: [...viewportProps],\n  },\n);\n"],"mappings":"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"}

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

@@ -0,0 +1,13 @@
+import { type ComponentPublicInstance } from "vue";
+import { type PrimitiveProps } from "../../utils/Primitive.js";
+export declare namespace ThreadPrimitiveViewportFooter {
+    type Element = ComponentPublicInstance;
+    type Props = PrimitiveProps<"div">;
+}
+/** Measures its height and margin; multiple footer insets are summed. */
+export declare const ThreadPrimitiveViewportFooter: import("vue").DefineSetupFnComponent<ThreadPrimitiveViewportFooter.Props, {}, {}, import("vue").HTMLAttributes & {
+    render?: import("vue").VNode | undefined;
+    asChild?: boolean | undefined;
+    children?: import("vue").VNodeChild;
+} & {}, import("vue").PublicProps>;
+//# sourceMappingURL=ThreadViewportFooter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ThreadViewportFooter.d.ts","mappings":"AAEA,OAAO,EAAsB,KAAK,uBAAuB,EAAE,MAAM,KAAK;AAEtE,OAAO,EAAa,KAAK,cAAc,EAAE,MAAM,0BAAuB;AAItE,yBAAiB,6BAA6B,CAAC;IAC7C,KAAY,OAAO,GAAG,uBAAuB;IAC7C,KAAY,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC;;AAG3C;AACA,eAAO,MAAM,6BAA6B;;;;kCA+BzC","names":[],"ignoreList":[],"sources":["../../../src/primitives/thread/ThreadViewportFooter.tsx"],"sourcesContent":[null]}