@assistant-ui/react 0.12.28 → 0.14.0

package/src/tests/RemoteThreadListRuntime.deferredProvider.test.tsx

@@ -1,8 +1,8 @@
 // @vitest-environment jsdom
 
-import { render } from "@testing-library/react";
+import { act, render } from "@testing-library/react";
 import { type FC, type PropsWithChildren, useState } from "react";
-import { describe, expect, it } from "vitest";
+import { afterEach, describe, expect, it, vi } from "vitest";
 import { useRemoteThreadListRuntime } from "@assistant-ui/core/react";
 import { makeAdapter } from "./remote-thread-list-test-helpers";
 import type { AssistantRuntime } from "@assistant-ui/core";
@@ -39,14 +39,13 @@ const RuntimeCapture: FC<{
   return null;
 };
 
-// regression for #3678: deferred unstable_Provider must not strand the runtime binder.
-describe("useRemoteThreadListRuntime with a deferred unstable_Provider", () => {
-  it("composer.setText does not throw EMPTY_THREAD_ERROR when unstable_Provider defers children", () => {
-    const Provider: FC<PropsWithChildren> = ({ children }) => {
-      const [ready] = useState(false);
-      if (!ready) return null;
-      return <>{children}</>;
-    };
+afterEach(() => {
+  vi.useRealTimers();
+});
+
+describe("useRemoteThreadListRuntime with unstable_Provider", () => {
+  it("composer.setText works when unstable_Provider renders children unconditionally", () => {
+    const Provider: FC<PropsWithChildren> = ({ children }) => <>{children}</>;
     const adapter = makeAdapter({ unstable_Provider: Provider });
 
     const runtimeRef: { current: AssistantRuntime | null } = { current: null };
@@ -61,19 +60,31 @@ describe("useRemoteThreadListRuntime with a deferred unstable_Provider", () => {
     expect(() => runtime!.thread.composer.setText("hello")).not.toThrow();
   });
 
-  it("composer.setText still works when unstable_Provider renders children unconditionally", () => {
-    const Provider: FC<PropsWithChildren> = ({ children }) => <>{children}</>;
+  it("warns in dev when unstable_Provider defers children", () => {
+    vi.useFakeTimers();
+    const warn = vi.spyOn(console, "warn").mockImplementation(() => {});
+
+    const Provider: FC<PropsWithChildren> = ({ children }) => {
+      const [ready] = useState(false);
+      if (!ready) return null;
+      return <>{children}</>;
+    };
     const adapter = makeAdapter({ unstable_Provider: Provider });
 
-    const runtimeRef: { current: AssistantRuntime | null } = { current: null };
     render(
       <RuntimeProvider adapter={adapter}>
-        <RuntimeCapture runtimeRef={runtimeRef} />
+        <div />
       </RuntimeProvider>,
     );
 
-    const runtime = runtimeRef.current;
-    expect(runtime).toBeTruthy();
-    expect(() => runtime!.thread.composer.setText("hello")).not.toThrow();
+    act(() => {
+      vi.advanceTimersByTime(150);
+    });
+
+    expect(warn).toHaveBeenCalledWith(
+      expect.stringContaining("did not render its `children` synchronously"),
+    );
+
+    warn.mockRestore();
   });
 });

package/src/utils/hooks/useManagedRef.ts

@@ -10,6 +10,7 @@ export const useManagedRef = <TNode>(
       // Call the previous cleanup function
       if (cleanupRef.current) {
         cleanupRef.current();
+        cleanupRef.current = undefined;
       }
 
       // Call the new callback and store its cleanup function

package/src/utils/hooks/useOnResizeContent.ts

@@ -13,8 +13,7 @@ export const useOnResizeContent = (callback: () => void) => {
 
       const mutationObserver = new MutationObserver((mutations) => {
         // Filter out style-only attribute mutations to prevent feedback loops
-        // with components like ThreadViewportSlack that write styles in response
-        // to viewport changes
+        // with code paths that write styles in response to viewport changes.
         const hasRelevantMutation = mutations.some(
           (m) => m.type !== "attributes" || m.attributeName !== "style",
         );

package/dist/legacy-runtime/runtime-cores/external-store/getExternalStoreMessage.d.ts

@@ -1,3 +0,0 @@
-export { getExternalStoreMessage, getExternalStoreMessages, bindExternalStoreMessage, } from "@assistant-ui/core";
-export { symbolInnerMessage } from "@assistant-ui/core/internal";
-//# sourceMappingURL=getExternalStoreMessage.d.ts.map

package/dist/legacy-runtime/runtime-cores/external-store/getExternalStoreMessage.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"getExternalStoreMessage.d.ts","sourceRoot":"","sources":["../../../../src/legacy-runtime/runtime-cores/external-store/getExternalStoreMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/legacy-runtime/runtime-cores/external-store/getExternalStoreMessage.js

@@ -1,3 +0,0 @@
-export { getExternalStoreMessage, getExternalStoreMessages, bindExternalStoreMessage, } from "@assistant-ui/core";
-export { symbolInnerMessage } from "@assistant-ui/core/internal";
-//# sourceMappingURL=getExternalStoreMessage.js.map

package/dist/legacy-runtime/runtime-cores/external-store/getExternalStoreMessage.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"getExternalStoreMessage.js","sourceRoot":"","sources":["../../../../src/legacy-runtime/runtime-cores/external-store/getExternalStoreMessage.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC"}

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

@@ -1,20 +0,0 @@
-import { type FC, type ReactNode } from "react";
-export type ThreadViewportSlackProps = {
-    /** Threshold at which the user message height clamps to the offset */
-    fillClampThreshold?: string | undefined;
-    /** Offset used when clamping large user messages */
-    fillClampOffset?: string | undefined;
-    children: ReactNode;
-};
-/**
- * A slot component that provides minimum height to enable scroll anchoring.
- *
- * When using `turnAnchor="top"`, this component ensures there is
- * enough scroll room below the anchor point (last user message) for it to scroll
- * to the top of the viewport. The min-height is applied only to the last
- * assistant message.
- *
- * This component is used internally by MessagePrimitive.Root.
- */
-export declare const ThreadPrimitiveViewportSlack: FC<ThreadViewportSlackProps>;
-//# sourceMappingURL=ThreadViewportSlack.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ThreadViewportSlack.d.ts","sourceRoot":"","sources":["../../../src/primitives/thread/ThreadViewportSlack.tsx"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,EAAE,EACP,KAAK,SAAS,EAGf,MAAM,OAAO,CAAC;AA2Bf,MAAM,MAAM,wBAAwB,GAAG;IACrC,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,SAAS,CAAC;CACrB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,EAAE,EAAE,CAAC,wBAAwB,CA2DrE,CAAC"}

package/dist/primitives/thread/ThreadViewportSlack.js

@@ -1,80 +0,0 @@
-"use client";
-import { jsx as _jsx } from "react/jsx-runtime";
-import { Slot } from "radix-ui";
-import { createContext, useCallback, useContext, } from "react";
-import { useThreadViewportStore } from "../../context/react/ThreadViewportContext.js";
-import { useAuiState } from "@assistant-ui/store";
-import { useManagedRef } from "../../utils/hooks/useManagedRef.js";
-const SlackNestingContext = createContext(false);
-const parseCssLength = (value, element) => {
-    const match = value.match(/^([\d.]+)(em|px|rem)$/);
-    if (!match)
-        return 0;
-    const num = parseFloat(match[1]);
-    const unit = match[2];
-    if (unit === "px")
-        return num;
-    if (unit === "em") {
-        const fontSize = parseFloat(getComputedStyle(element).fontSize) || 16;
-        return num * fontSize;
-    }
-    if (unit === "rem") {
-        const rootFontSize = parseFloat(getComputedStyle(document.documentElement).fontSize) || 16;
-        return num * rootFontSize;
-    }
-    return 0;
-};
-/**
- * A slot component that provides minimum height to enable scroll anchoring.
- *
- * When using `turnAnchor="top"`, this component ensures there is
- * enough scroll room below the anchor point (last user message) for it to scroll
- * to the top of the viewport. The min-height is applied only to the last
- * assistant message.
- *
- * This component is used internally by MessagePrimitive.Root.
- */
-export const ThreadPrimitiveViewportSlack = ({ children, fillClampThreshold = "10em", fillClampOffset = "6em", }) => {
-    const shouldApplySlack = useAuiState(
-    // only add slack to the last assistant message following a user message (valid turn)
-    (s) => s.message.isLast &&
-        s.message.role === "assistant" &&
-        s.message.index >= 1 &&
-        s.thread.messages.at(s.message.index - 1)?.role === "user");
-    const threadViewportStore = useThreadViewportStore({ optional: true });
-    const isNested = useContext(SlackNestingContext);
-    const callback = useCallback((el) => {
-        if (!threadViewportStore || isNested)
-            return;
-        const updateMinHeight = () => {
-            const state = threadViewportStore.getState();
-            if (state.turnAnchor === "top" && shouldApplySlack) {
-                const { viewport, inset, userMessage } = state.height;
-                const threshold = parseCssLength(fillClampThreshold, el);
-                const offset = parseCssLength(fillClampOffset, el);
-                const clampAdjustment = userMessage <= threshold ? userMessage : offset;
-                const minHeight = Math.max(0, viewport - inset - clampAdjustment);
-                el.style.minHeight = `${minHeight}px`;
-                el.style.flexShrink = "0";
-                el.style.transition = "min-height 0s";
-            }
-            else {
-                el.style.minHeight = "";
-                el.style.flexShrink = "";
-                el.style.transition = "";
-            }
-        };
-        updateMinHeight();
-        return threadViewportStore.subscribe(updateMinHeight);
-    }, [
-        threadViewportStore,
-        shouldApplySlack,
-        isNested,
-        fillClampThreshold,
-        fillClampOffset,
-    ]);
-    const ref = useManagedRef(callback);
-    return (_jsx(SlackNestingContext.Provider, { value: true, children: _jsx(Slot.Root, { ref: ref, children: children }) }));
-};
-ThreadPrimitiveViewportSlack.displayName = "ThreadPrimitive.ViewportSlack";
-//# sourceMappingURL=ThreadViewportSlack.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"ThreadViewportSlack.js","sourceRoot":"","sources":["../../../src/primitives/thread/ThreadViewportSlack.tsx"],"names":[],"mappings":"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"}

package/src/legacy-runtime/runtime-cores/external-store/getExternalStoreMessage.ts

@@ -1,6 +0,0 @@
-export {
-  getExternalStoreMessage,
-  getExternalStoreMessages,
-  bindExternalStoreMessage,
-} from "@assistant-ui/core";
-export { symbolInnerMessage } from "@assistant-ui/core/internal";

package/src/primitives/thread/ThreadViewportSlack.tsx

@@ -1,116 +0,0 @@
-"use client";
-
-import { Slot } from "radix-ui";
-import {
-  createContext,
-  type FC,
-  type ReactNode,
-  useCallback,
-  useContext,
-} from "react";
-import { useThreadViewportStore } from "../../context/react/ThreadViewportContext";
-import { useAuiState } from "@assistant-ui/store";
-import { useManagedRef } from "../../utils/hooks/useManagedRef";
-
-const SlackNestingContext = createContext(false);
-
-const parseCssLength = (value: string, element: HTMLElement): number => {
-  const match = value.match(/^([\d.]+)(em|px|rem)$/);
-  if (!match) return 0;
-
-  const num = parseFloat(match[1]!);
-  const unit = match[2];
-
-  if (unit === "px") return num;
-  if (unit === "em") {
-    const fontSize = parseFloat(getComputedStyle(element).fontSize) || 16;
-    return num * fontSize;
-  }
-  if (unit === "rem") {
-    const rootFontSize =
-      parseFloat(getComputedStyle(document.documentElement).fontSize) || 16;
-    return num * rootFontSize;
-  }
-  return 0;
-};
-
-export type ThreadViewportSlackProps = {
-  /** Threshold at which the user message height clamps to the offset */
-  fillClampThreshold?: string | undefined;
-  /** Offset used when clamping large user messages */
-  fillClampOffset?: string | undefined;
-  children: ReactNode;
-};
-
-/**
- * A slot component that provides minimum height to enable scroll anchoring.
- *
- * When using `turnAnchor="top"`, this component ensures there is
- * enough scroll room below the anchor point (last user message) for it to scroll
- * to the top of the viewport. The min-height is applied only to the last
- * assistant message.
- *
- * This component is used internally by MessagePrimitive.Root.
- */
-export const ThreadPrimitiveViewportSlack: FC<ThreadViewportSlackProps> = ({
-  children,
-  fillClampThreshold = "10em",
-  fillClampOffset = "6em",
-}) => {
-  const shouldApplySlack = useAuiState(
-    // only add slack to the last assistant message following a user message (valid turn)
-    (s) =>
-      s.message.isLast &&
-      s.message.role === "assistant" &&
-      s.message.index >= 1 &&
-      s.thread.messages.at(s.message.index - 1)?.role === "user",
-  );
-  const threadViewportStore = useThreadViewportStore({ optional: true });
-  const isNested = useContext(SlackNestingContext);
-
-  const callback = useCallback(
-    (el: HTMLElement) => {
-      if (!threadViewportStore || isNested) return;
-
-      const updateMinHeight = () => {
-        const state = threadViewportStore.getState();
-        if (state.turnAnchor === "top" && shouldApplySlack) {
-          const { viewport, inset, userMessage } = state.height;
-          const threshold = parseCssLength(fillClampThreshold, el);
-          const offset = parseCssLength(fillClampOffset, el);
-          const clampAdjustment =
-            userMessage <= threshold ? userMessage : offset;
-
-          const minHeight = Math.max(0, viewport - inset - clampAdjustment);
-          el.style.minHeight = `${minHeight}px`;
-          el.style.flexShrink = "0";
-          el.style.transition = "min-height 0s";
-        } else {
-          el.style.minHeight = "";
-          el.style.flexShrink = "";
-          el.style.transition = "";
-        }
-      };
-
-      updateMinHeight();
-      return threadViewportStore.subscribe(updateMinHeight);
-    },
-    [
-      threadViewportStore,
-      shouldApplySlack,
-      isNested,
-      fillClampThreshold,
-      fillClampOffset,
-    ],
-  );
-
-  const ref = useManagedRef<HTMLElement>(callback);
-
-  return (
-    <SlackNestingContext.Provider value={true}>
-      <Slot.Root ref={ref}>{children}</Slot.Root>
-    </SlackNestingContext.Provider>
-  );
-};
-
-ThreadPrimitiveViewportSlack.displayName = "ThreadPrimitive.ViewportSlack";