@assistant-ui/react 0.14.21 → 0.14.22

package/dist/primitives/composer/trigger/TriggerPopoverResource.d.ts

@@ -13,7 +13,8 @@ type TriggerPopoverResourceOutput = {
   readonly categories: readonly Unstable_TriggerCategory[];
   readonly items: readonly Unstable_TriggerItem[];
   readonly highlightedIndex: number;
-  readonly isSearchMode: boolean; /** Stable ID prefix for generating accessible element IDs. */
+  readonly isSearchMode: boolean; /** Whether the adapter is currently resolving items (async sources). */
+  readonly isLoading: boolean; /** Stable ID prefix for generating accessible element IDs. */
   readonly popoverId: string; /** ID of the currently highlighted item (for aria-activedescendant). */
   readonly highlightedItemId: string | undefined;
   selectCategory(categoryId: string): void;
@@ -36,6 +37,7 @@ declare const TriggerPopoverResource: import("@assistant-ui/tap").Resource<Trigg
   behavior: TriggerBehavior | undefined;
   aui: AssistantClient; /** Stable ID for accessible element IDs (pass React's useId() from component layer). */
   popoverId: string;
+  isLoading: boolean;
 }]>;
 //#endregion
 export { OnSelectBehavior, type SelectItemOverride, type TriggerBehavior, type TriggerPopoverKeyEvent, TriggerPopoverResource, TriggerPopoverResourceOutput };

package/dist/primitives/composer/trigger/TriggerPopoverResource.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TriggerPopoverResource.d.ts","names":[],"sources":["../../../../src/primitives/composer/trigger/TriggerPopoverResource.ts"],"mappings":";;;;;;;KAqBY,gBAAA,GAAmB,eAAe;AAAA,KAElC,4BAAA;EAAA,SACD,IAAA;EAAA,SACA,KAAA;EAAA,SACA,gBAAA;EAAA,SACA,UAAA,WAAqB,wBAAA;EAAA,SACrB,KAAA,WAAgB,oBAAA;EAAA,SAChB,gBAAA;EAAA,SACA,YAAA,WAFgB;EAAA,SAIhB,SAAA,UAiBsB;EAAA,SAftB,iBAAA;EAET,cAAA,CAAe,UAAA;EACf,MAAA;EACA,UAAA,CAAW,IAAA,EAAM,oBAAA;EACjB,KAAA,UAZS;EAcT,cAAA,CAAe,KAAA;EACf,aAAA,CAAc,CAAA;IAAA,SACH,GAAA;IAAA,SACA,QAAA;IACT,cAAA;EAAA;EAGF,iBAAA,CAAkB,GAAA;EAClB,0BAAA,CAA2B,EAAA,EAAI,kBAAA;AAAA;AAAA,cAwFpB,sBAAA,8BAAsB,QAAA,CAAA,4BAAA;WA5ExB,uBAAA;;;YAGC,eAAA;OACL,eAAA,EAxBU"}
+{"version":3,"file":"TriggerPopoverResource.d.ts","names":[],"sources":["../../../../src/primitives/composer/trigger/TriggerPopoverResource.ts"],"mappings":";;;;;;;KAqBY,gBAAA,GAAmB,eAAe;AAAA,KAElC,4BAAA;EAAA,SACD,IAAA;EAAA,SACA,KAAA;EAAA,SACA,gBAAA;EAAA,SACA,UAAA,WAAqB,wBAAA;EAAA,SACrB,KAAA,WAAgB,oBAAA;EAAA,SAChB,gBAAA;EAAA,SACA,YAAA,WAFgB;EAAA,SAIhB,SAAA,WAmBsB;EAAA,SAjBtB,SAAA,UAiBwC;EAAA,SAfxC,iBAAA;EAET,cAAA,CAAe,UAAA;EACf,MAAA;EACA,UAAA,CAAW,IAAA,EAAM,oBAAA;EACjB,KAAA,UAbS;EAeT,cAAA,CAAe,KAAA;EACf,aAAA,CAAc,CAAA;IAAA,SACH,GAAA;IAAA,SACA,QAAA;IACT,cAAA;EAAA;EAGF,iBAAA,CAAkB,GAAA;EAClB,0BAAA,CAA2B,EAAA,EAAI,kBAAA;AAAA;AAAA,cA2FpB,sBAAA,8BAAsB,QAAA,CAAA,4BAAA;WA9ExB,uBAAA;;;YAGC,eAAA;OACL,eAAA,EAxBL"}

package/dist/primitives/composer/trigger/TriggerPopoverResource.js

@@ -8,8 +8,8 @@ import { resource, useResource } from "@assistant-ui/tap";
 //#region src/primitives/composer/trigger/TriggerPopoverResource.ts
 /** Composes detection, navigation, keyboard, and selection sub-resources. */
 const useTriggerPopoverResource = (t0) => {
-	const $ = c(45);
-	const { adapter, text, triggerChar, behavior, aui, popoverId } = t0;
+	const $ = c(46);
+	const { adapter, text, triggerChar, behavior, aui, popoverId, isLoading } = t0;
 	let t1;
 	if ($[0] !== text || $[1] !== triggerChar) {
 		t1 = TriggerDetectionResource({
@@ -91,7 +91,7 @@ const useTriggerPopoverResource = (t0) => {
 	} else t5 = $[26];
 	const keyboard = useResource(t5);
 	let t6;
-	if ($[27] !== detection.query || $[28] !== detection.setCursorPosition || $[29] !== keyboard.handleKeyDown || $[30] !== keyboard.highlightIndex || $[31] !== keyboard.highlightedIndex || $[32] !== keyboard.highlightedItemId || $[33] !== navigation.activeCategoryId || $[34] !== navigation.categories || $[35] !== navigation.goBack || $[36] !== navigation.isSearchMode || $[37] !== navigation.items || $[38] !== navigation.selectCategory || $[39] !== open || $[40] !== popoverId || $[41] !== selection.close || $[42] !== selection.registerSelectItemOverride || $[43] !== selection.selectItem) {
+	if ($[27] !== detection.query || $[28] !== detection.setCursorPosition || $[29] !== isLoading || $[30] !== keyboard.handleKeyDown || $[31] !== keyboard.highlightIndex || $[32] !== keyboard.highlightedIndex || $[33] !== keyboard.highlightedItemId || $[34] !== navigation.activeCategoryId || $[35] !== navigation.categories || $[36] !== navigation.goBack || $[37] !== navigation.isSearchMode || $[38] !== navigation.items || $[39] !== navigation.selectCategory || $[40] !== open || $[41] !== popoverId || $[42] !== selection.close || $[43] !== selection.registerSelectItemOverride || $[44] !== selection.selectItem) {
 		t6 = {
 			open,
 			query: detection.query,
@@ -100,6 +100,7 @@ const useTriggerPopoverResource = (t0) => {
 			items: navigation.items,
 			highlightedIndex: keyboard.highlightedIndex,
 			isSearchMode: navigation.isSearchMode,
+			isLoading,
 			popoverId,
 			highlightedItemId: keyboard.highlightedItemId,
 			selectCategory: navigation.selectCategory,
@@ -113,23 +114,24 @@ const useTriggerPopoverResource = (t0) => {
 		};
 		$[27] = detection.query;
 		$[28] = detection.setCursorPosition;
-		$[29] = keyboard.handleKeyDown;
-		$[30] = keyboard.highlightIndex;
-		$[31] = keyboard.highlightedIndex;
-		$[32] = keyboard.highlightedItemId;
-		$[33] = navigation.activeCategoryId;
-		$[34] = navigation.categories;
-		$[35] = navigation.goBack;
-		$[36] = navigation.isSearchMode;
-		$[37] = navigation.items;
-		$[38] = navigation.selectCategory;
-		$[39] = open;
-		$[40] = popoverId;
-		$[41] = selection.close;
-		$[42] = selection.registerSelectItemOverride;
-		$[43] = selection.selectItem;
-		$[44] = t6;
-	} else t6 = $[44];
+		$[29] = isLoading;
+		$[30] = keyboard.handleKeyDown;
+		$[31] = keyboard.highlightIndex;
+		$[32] = keyboard.highlightedIndex;
+		$[33] = keyboard.highlightedItemId;
+		$[34] = navigation.activeCategoryId;
+		$[35] = navigation.categories;
+		$[36] = navigation.goBack;
+		$[37] = navigation.isSearchMode;
+		$[38] = navigation.items;
+		$[39] = navigation.selectCategory;
+		$[40] = open;
+		$[41] = popoverId;
+		$[42] = selection.close;
+		$[43] = selection.registerSelectItemOverride;
+		$[44] = selection.selectItem;
+		$[45] = t6;
+	} else t6 = $[45];
 	return t6;
 };
 const TriggerPopoverResource = resource(useTriggerPopoverResource);

package/dist/primitives/composer/trigger/TriggerPopoverResource.js.map

@@ -1 +1 @@
-{"version":3,"file":"TriggerPopoverResource.js","names":["useEffectEvent","useResource","resource","Unstable_TriggerAdapter","Unstable_TriggerCategory","Unstable_TriggerItem","AssistantClient","TriggerDetectionResource","TriggerKeyboardResource","TriggerNavigationResource","TriggerSelectionResource","SelectItemOverride","TriggerBehavior","TriggerPopoverKeyEvent","OnSelectBehavior","TriggerPopoverResourceOutput","open","query","activeCategoryId","categories","items","highlightedIndex","isSearchMode","popoverId","highlightedItemId","selectCategory","categoryId","goBack","selectItem","item","close","highlightIndex","index","handleKeyDown","e","key","shiftKey","preventDefault","setCursorPosition","pos","registerSelectItemOverride","fn","useTriggerPopoverResource","t0","$","_c","adapter","text","triggerChar","behavior","aui","t1","detection","trigger","undefined","t2","navigation","t3","onSelected","t4","selection","t5","navigableList","keyboard","t6","TriggerPopoverResource"],"sources":["../../../../src/primitives/composer/trigger/TriggerPopoverResource.ts"],"sourcesContent":["import { useEffectEvent } from \"react\";\nimport { useResource, resource } from \"@assistant-ui/tap\";\nimport type {\n  Unstable_TriggerAdapter,\n  Unstable_TriggerCategory,\n  Unstable_TriggerItem,\n} from \"@assistant-ui/core\";\nimport type { AssistantClient } from \"@assistant-ui/store\";\nimport { TriggerDetectionResource } from \"./triggerDetectionResource\";\nimport { TriggerKeyboardResource } from \"./triggerKeyboardResource\";\nimport { TriggerNavigationResource } from \"./triggerNavigationResource\";\nimport {\n  TriggerSelectionResource,\n  type SelectItemOverride,\n  type TriggerBehavior,\n} from \"./triggerSelectionResource\";\n\nexport type { SelectItemOverride, TriggerBehavior };\nexport type { TriggerPopoverKeyEvent } from \"./triggerKeyboardResource\";\n\n/** @deprecated Use `TriggerBehavior`. */\nexport type OnSelectBehavior = TriggerBehavior;\n\nexport type TriggerPopoverResourceOutput = {\n  readonly open: boolean;\n  readonly query: string;\n  readonly activeCategoryId: string | null;\n  readonly categories: readonly Unstable_TriggerCategory[];\n  readonly items: readonly Unstable_TriggerItem[];\n  readonly highlightedIndex: number;\n  readonly isSearchMode: boolean;\n  /** Stable ID prefix for generating accessible element IDs. */\n  readonly popoverId: string;\n  /** ID of the currently highlighted item (for aria-activedescendant). */\n  readonly highlightedItemId: string | undefined;\n\n  selectCategory(categoryId: string): void;\n  goBack(): void;\n  selectItem(item: Unstable_TriggerItem): void;\n  close(): void;\n  /** Move the highlight to an entry index (e.g. from pointer hover). Out-of-range values are ignored. */\n  highlightIndex(index: number): void;\n  handleKeyDown(e: {\n    readonly key: string;\n    readonly shiftKey: boolean;\n    preventDefault(): void;\n  }): boolean;\n\n  setCursorPosition(pos: number): void;\n  registerSelectItemOverride(fn: SelectItemOverride): () => void;\n};\n\n/** Composes detection, navigation, keyboard, and selection sub-resources. */\nconst useTriggerPopoverResource = ({\n  adapter,\n  text,\n  triggerChar,\n  behavior,\n  aui,\n  popoverId,\n}: {\n  adapter: Unstable_TriggerAdapter | undefined;\n  text: string;\n  triggerChar: string;\n  behavior: TriggerBehavior | undefined;\n  aui: AssistantClient;\n  /** Stable ID for accessible element IDs (pass React's useId() from component layer). */\n  popoverId: string;\n}): TriggerPopoverResourceOutput => {\n  const detection = useResource(\n    TriggerDetectionResource({ text, triggerChar }),\n  );\n\n  const open =\n    detection.trigger !== null &&\n    adapter !== undefined &&\n    behavior !== undefined;\n\n  const navigation = useResource(\n    TriggerNavigationResource({\n      adapter,\n      query: detection.query,\n      open,\n    }),\n  );\n\n  const onSelected = useEffectEvent(() => {\n    navigation.goBack();\n  });\n\n  const selection = useResource(\n    TriggerSelectionResource({\n      behavior,\n      trigger: detection.trigger,\n      aui,\n      triggerChar,\n      setCursorPosition: detection.setCursorPosition,\n      onSelected,\n    }),\n  );\n\n  const keyboard = useResource(\n    TriggerKeyboardResource({\n      navigableList: navigation.navigableList,\n      isSearchMode: navigation.isSearchMode,\n      activeCategoryId: navigation.activeCategoryId,\n      query: detection.query,\n      popoverId,\n      open,\n      selectItem: selection.selectItem,\n      selectCategory: navigation.selectCategory,\n      goBack: navigation.goBack,\n      close: selection.close,\n    }),\n  );\n\n  return {\n    open,\n    query: detection.query,\n    activeCategoryId: navigation.activeCategoryId,\n    categories: navigation.categories,\n    items: navigation.items,\n    highlightedIndex: keyboard.highlightedIndex,\n    isSearchMode: navigation.isSearchMode,\n    popoverId,\n    highlightedItemId: keyboard.highlightedItemId,\n    selectCategory: navigation.selectCategory,\n    goBack: navigation.goBack,\n    selectItem: selection.selectItem,\n    close: selection.close,\n    highlightIndex: keyboard.highlightIndex,\n    handleKeyDown: keyboard.handleKeyDown,\n    setCursorPosition: detection.setCursorPosition,\n    registerSelectItemOverride: selection.registerSelectItemOverride,\n  };\n};\n\nexport const TriggerPopoverResource = resource(useTriggerPopoverResource);\n"],"mappings":"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"}
+{"version":3,"file":"TriggerPopoverResource.js","names":["useEffectEvent","useResource","resource","Unstable_TriggerAdapter","Unstable_TriggerCategory","Unstable_TriggerItem","AssistantClient","TriggerDetectionResource","TriggerKeyboardResource","TriggerNavigationResource","TriggerSelectionResource","SelectItemOverride","TriggerBehavior","TriggerPopoverKeyEvent","OnSelectBehavior","TriggerPopoverResourceOutput","open","query","activeCategoryId","categories","items","highlightedIndex","isSearchMode","isLoading","popoverId","highlightedItemId","selectCategory","categoryId","goBack","selectItem","item","close","highlightIndex","index","handleKeyDown","e","key","shiftKey","preventDefault","setCursorPosition","pos","registerSelectItemOverride","fn","useTriggerPopoverResource","t0","$","_c","adapter","text","triggerChar","behavior","aui","t1","detection","trigger","undefined","t2","navigation","t3","onSelected","t4","selection","t5","navigableList","keyboard","t6","TriggerPopoverResource"],"sources":["../../../../src/primitives/composer/trigger/TriggerPopoverResource.ts"],"sourcesContent":["import { useEffectEvent } from \"react\";\nimport { useResource, resource } from \"@assistant-ui/tap\";\nimport type {\n  Unstable_TriggerAdapter,\n  Unstable_TriggerCategory,\n  Unstable_TriggerItem,\n} from \"@assistant-ui/core\";\nimport type { AssistantClient } from \"@assistant-ui/store\";\nimport { TriggerDetectionResource } from \"./triggerDetectionResource\";\nimport { TriggerKeyboardResource } from \"./triggerKeyboardResource\";\nimport { TriggerNavigationResource } from \"./triggerNavigationResource\";\nimport {\n  TriggerSelectionResource,\n  type SelectItemOverride,\n  type TriggerBehavior,\n} from \"./triggerSelectionResource\";\n\nexport type { SelectItemOverride, TriggerBehavior };\nexport type { TriggerPopoverKeyEvent } from \"./triggerKeyboardResource\";\n\n/** @deprecated Use `TriggerBehavior`. */\nexport type OnSelectBehavior = TriggerBehavior;\n\nexport type TriggerPopoverResourceOutput = {\n  readonly open: boolean;\n  readonly query: string;\n  readonly activeCategoryId: string | null;\n  readonly categories: readonly Unstable_TriggerCategory[];\n  readonly items: readonly Unstable_TriggerItem[];\n  readonly highlightedIndex: number;\n  readonly isSearchMode: boolean;\n  /** Whether the adapter is currently resolving items (async sources). */\n  readonly isLoading: boolean;\n  /** Stable ID prefix for generating accessible element IDs. */\n  readonly popoverId: string;\n  /** ID of the currently highlighted item (for aria-activedescendant). */\n  readonly highlightedItemId: string | undefined;\n\n  selectCategory(categoryId: string): void;\n  goBack(): void;\n  selectItem(item: Unstable_TriggerItem): void;\n  close(): void;\n  /** Move the highlight to an entry index (e.g. from pointer hover). Out-of-range values are ignored. */\n  highlightIndex(index: number): void;\n  handleKeyDown(e: {\n    readonly key: string;\n    readonly shiftKey: boolean;\n    preventDefault(): void;\n  }): boolean;\n\n  setCursorPosition(pos: number): void;\n  registerSelectItemOverride(fn: SelectItemOverride): () => void;\n};\n\n/** Composes detection, navigation, keyboard, and selection sub-resources. */\nconst useTriggerPopoverResource = ({\n  adapter,\n  text,\n  triggerChar,\n  behavior,\n  aui,\n  popoverId,\n  isLoading,\n}: {\n  adapter: Unstable_TriggerAdapter | undefined;\n  text: string;\n  triggerChar: string;\n  behavior: TriggerBehavior | undefined;\n  aui: AssistantClient;\n  /** Stable ID for accessible element IDs (pass React's useId() from component layer). */\n  popoverId: string;\n  isLoading: boolean;\n}): TriggerPopoverResourceOutput => {\n  const detection = useResource(\n    TriggerDetectionResource({ text, triggerChar }),\n  );\n\n  const open =\n    detection.trigger !== null &&\n    adapter !== undefined &&\n    behavior !== undefined;\n\n  const navigation = useResource(\n    TriggerNavigationResource({\n      adapter,\n      query: detection.query,\n      open,\n    }),\n  );\n\n  const onSelected = useEffectEvent(() => {\n    navigation.goBack();\n  });\n\n  const selection = useResource(\n    TriggerSelectionResource({\n      behavior,\n      trigger: detection.trigger,\n      aui,\n      triggerChar,\n      setCursorPosition: detection.setCursorPosition,\n      onSelected,\n    }),\n  );\n\n  const keyboard = useResource(\n    TriggerKeyboardResource({\n      navigableList: navigation.navigableList,\n      isSearchMode: navigation.isSearchMode,\n      activeCategoryId: navigation.activeCategoryId,\n      query: detection.query,\n      popoverId,\n      open,\n      selectItem: selection.selectItem,\n      selectCategory: navigation.selectCategory,\n      goBack: navigation.goBack,\n      close: selection.close,\n    }),\n  );\n\n  return {\n    open,\n    query: detection.query,\n    activeCategoryId: navigation.activeCategoryId,\n    categories: navigation.categories,\n    items: navigation.items,\n    highlightedIndex: keyboard.highlightedIndex,\n    isSearchMode: navigation.isSearchMode,\n    isLoading,\n    popoverId,\n    highlightedItemId: keyboard.highlightedItemId,\n    selectCategory: navigation.selectCategory,\n    goBack: navigation.goBack,\n    selectItem: selection.selectItem,\n    close: selection.close,\n    highlightIndex: keyboard.highlightIndex,\n    handleKeyDown: keyboard.handleKeyDown,\n    setCursorPosition: detection.setCursorPosition,\n    registerSelectItemOverride: selection.registerSelectItemOverride,\n  };\n};\n\nexport const TriggerPopoverResource = resource(useTriggerPopoverResource);\n"],"mappings":"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"}

package/dist/primitives/composer/trigger/index.d.ts

@@ -15,6 +15,7 @@ declare const ComposerPrimitiveTriggerPopover: import("react").ForwardRefExoticC
 } & import("react").RefAttributes<HTMLDivElement>, "ref">, "onSelect"> & {
   readonly char: string;
   readonly adapter?: import("@assistant-ui/core").Unstable_TriggerAdapter | undefined;
+  readonly isLoading?: boolean | undefined;
 } & import("react").RefAttributes<HTMLDivElement>> & {
   Directive: import("react").FC<ComposerPrimitiveTriggerPopoverDirective.Props>;
   Action: import("react").FC<ComposerPrimitiveTriggerPopoverAction.Props>;

package/dist/unstable/useLiveCompletionAdapter.d.ts

@@ -0,0 +1,47 @@
+import { Unstable_TriggerAdapter, Unstable_TriggerItem } from "@assistant-ui/core";
+
+//#region src/unstable/useLiveCompletionAdapter.d.ts
+type Unstable_UseLiveCompletionAdapterOptions = {
+  /**
+   * Fetches the items for a query from an async source. Called debounced; the
+   * resolved items are cached and returned synchronously to the popover on the
+   * next render.
+   */
+  readonly fetcher: (query: string) => Promise<readonly Unstable_TriggerItem[]>; /** Debounce applied before a fetch fires, in milliseconds. @default 60 */
+  readonly debounceMs?: number | undefined; /** When `false`, no fetch is scheduled and the adapter stays empty. @default true */
+  readonly enabled?: boolean | undefined;
+};
+/**
+ * @deprecated Under active development and may change without notice.
+ *
+ * Bridges an async completion source (a server search, a gateway RPC) into the
+ * synchronous `Unstable_TriggerAdapter` that `ComposerTriggerPopover` consumes.
+ * `search(query)` returns the last fetched items synchronously and schedules a
+ * debounced fetch when the query changes; when results arrive the returned
+ * `adapter` identity changes, which re-runs the popover's lookup so the fresh
+ * items render. This is a search-only adapter (`categories` are empty).
+ *
+ * `isLoading` is `true` while a fetch is in flight. Pass it to the popover's
+ * `isLoading` prop to render a loading state.
+ *
+ * @example
+ * ```tsx
+ * const mentions = unstable_useLiveCompletionAdapter({
+ *   fetcher: (query) => searchUsers(query),
+ * });
+ *
+ * <ComposerTriggerPopover
+ *   char="@"
+ *   adapter={mentions.adapter}
+ *   isLoading={mentions.isLoading}
+ *   directive={{ onInserted }}
+ * />
+ * ```
+ */
+declare function unstable_useLiveCompletionAdapter(options: Unstable_UseLiveCompletionAdapterOptions): {
+  adapter: Unstable_TriggerAdapter;
+  isLoading: boolean;
+};
+//#endregion
+export { Unstable_UseLiveCompletionAdapterOptions, unstable_useLiveCompletionAdapter };
+//# sourceMappingURL=useLiveCompletionAdapter.d.ts.map

package/dist/unstable/useLiveCompletionAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveCompletionAdapter.d.ts","names":[],"sources":["../../src/unstable/useLiveCompletionAdapter.ts"],"mappings":";;;KAQY,wCAAA;;AAAZ;;;;WAMW,OAAA,GAAU,KAAA,aAAkB,OAAO,UAAU,oBAAA,KAAnC;EAAA,SAEV,UAAA,uBAF6C;EAAA,SAI7C,OAAA;AAAA;;AAAO;AAiClB;;;;;;;;;;AAEgD;;;;;;;;;;;;;;;iBAFhC,iCAAA,CACd,OAAA,EAAS,wCAAA;EACN,OAAA,EAAS,uBAAuB;EAAE,SAAA;AAAA"}

package/dist/unstable/useLiveCompletionAdapter.js

@@ -0,0 +1,116 @@
+"use client";
+import { useCallback, useEffect, useMemo, useRef, useState } from "@assistant-ui/tap/react-shim";
+//#region src/unstable/useLiveCompletionAdapter.ts
+/** Sentinel that no real query (including the empty string) equals, so the first query always fetches. */
+const NO_QUERY = "\0";
+/**
+* @deprecated Under active development and may change without notice.
+*
+* Bridges an async completion source (a server search, a gateway RPC) into the
+* synchronous `Unstable_TriggerAdapter` that `ComposerTriggerPopover` consumes.
+* `search(query)` returns the last fetched items synchronously and schedules a
+* debounced fetch when the query changes; when results arrive the returned
+* `adapter` identity changes, which re-runs the popover's lookup so the fresh
+* items render. This is a search-only adapter (`categories` are empty).
+*
+* `isLoading` is `true` while a fetch is in flight. Pass it to the popover's
+* `isLoading` prop to render a loading state.
+*
+* @example
+* ```tsx
+* const mentions = unstable_useLiveCompletionAdapter({
+*   fetcher: (query) => searchUsers(query),
+* });
+*
+* <ComposerTriggerPopover
+*   char="@"
+*   adapter={mentions.adapter}
+*   isLoading={mentions.isLoading}
+*   directive={{ onInserted }}
+* />
+* ```
+*/
+function unstable_useLiveCompletionAdapter(options) {
+	const { fetcher, debounceMs = 60, enabled = true } = options;
+	const [state, setState] = useState({
+		query: NO_QUERY,
+		items: []
+	});
+	const [isLoading, setIsLoading] = useState(false);
+	const fetcherRef = useRef(fetcher);
+	fetcherRef.current = fetcher;
+	const timerRef = useRef(null);
+	const tokenRef = useRef(0);
+	const pendingQueryRef = useRef(null);
+	const cancelTimer = useCallback(() => {
+		if (timerRef.current !== null) {
+			clearTimeout(timerRef.current);
+			timerRef.current = null;
+		}
+	}, []);
+	const scheduleFetch = useCallback((query) => {
+		if (!enabled) return;
+		if (pendingQueryRef.current === query) return;
+		pendingQueryRef.current = query;
+		cancelTimer();
+		const token = ++tokenRef.current;
+		setIsLoading(true);
+		timerRef.current = setTimeout(() => {
+			timerRef.current = null;
+			fetcherRef.current(query).then((items) => {
+				if (token !== tokenRef.current) return;
+				setState({
+					query,
+					items
+				});
+				setIsLoading(false);
+			}, () => {
+				if (token !== tokenRef.current) return;
+				setState({
+					query,
+					items: []
+				});
+				setIsLoading(false);
+			});
+		}, debounceMs);
+	}, [
+		enabled,
+		debounceMs,
+		cancelTimer
+	]);
+	const invalidatePending = useCallback(() => {
+		cancelTimer();
+		pendingQueryRef.current = null;
+		tokenRef.current += 1;
+		setIsLoading(false);
+	}, [cancelTimer]);
+	useEffect(() => {
+		if (enabled) return;
+		invalidatePending();
+		setState((s) => s.query === NO_QUERY ? s : {
+			query: NO_QUERY,
+			items: []
+		});
+	}, [enabled, invalidatePending]);
+	useEffect(() => cancelTimer, [cancelTimer]);
+	return {
+		adapter: useMemo(() => ({
+			categories: () => [],
+			categoryItems: () => [],
+			search: (query) => {
+				if (query !== state.query) queueMicrotask(() => scheduleFetch(query));
+				else if (pendingQueryRef.current !== null && pendingQueryRef.current !== query) queueMicrotask(invalidatePending);
+				return state.items;
+			}
+		}), [
+			state,
+			scheduleFetch,
+			invalidatePending
+		]),
+		isLoading
+	};
+}
+//#endregion
+export { unstable_useLiveCompletionAdapter };
+
+//# sourceMappingURL=useLiveCompletionAdapter.js.map

package/dist/unstable/useLiveCompletionAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLiveCompletionAdapter.js","names":["useCallback","useEffect","useMemo","useRef","useState","Unstable_TriggerAdapter","Unstable_TriggerItem","Unstable_UseLiveCompletionAdapterOptions","fetcher","query","Promise","debounceMs","enabled","NO_QUERY","unstable_useLiveCompletionAdapter","options","adapter","isLoading","state","setState","items","setIsLoading","fetcherRef","current","timerRef","ReturnType","setTimeout","tokenRef","pendingQueryRef","cancelTimer","clearTimeout","scheduleFetch","token","then","invalidatePending","s","categories","categoryItems","search","queueMicrotask"],"sources":["../../src/unstable/useLiveCompletionAdapter.ts"],"sourcesContent":["\"use client\";\n\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type {\n  Unstable_TriggerAdapter,\n  Unstable_TriggerItem,\n} from \"@assistant-ui/core\";\n\nexport type Unstable_UseLiveCompletionAdapterOptions = {\n  /**\n   * Fetches the items for a query from an async source. Called debounced; the\n   * resolved items are cached and returned synchronously to the popover on the\n   * next render.\n   */\n  readonly fetcher: (query: string) => Promise<readonly Unstable_TriggerItem[]>;\n  /** Debounce applied before a fetch fires, in milliseconds. @default 60 */\n  readonly debounceMs?: number | undefined;\n  /** When `false`, no fetch is scheduled and the adapter stays empty. @default true */\n  readonly enabled?: boolean | undefined;\n};\n\n/** Sentinel that no real query (including the empty string) equals, so the first query always fetches. */\nconst NO_QUERY = \"\\u0000\";\n\n/**\n * @deprecated Under active development and may change without notice.\n *\n * Bridges an async completion source (a server search, a gateway RPC) into the\n * synchronous `Unstable_TriggerAdapter` that `ComposerTriggerPopover` consumes.\n * `search(query)` returns the last fetched items synchronously and schedules a\n * debounced fetch when the query changes; when results arrive the returned\n * `adapter` identity changes, which re-runs the popover's lookup so the fresh\n * items render. This is a search-only adapter (`categories` are empty).\n *\n * `isLoading` is `true` while a fetch is in flight. Pass it to the popover's\n * `isLoading` prop to render a loading state.\n *\n * @example\n * ```tsx\n * const mentions = unstable_useLiveCompletionAdapter({\n *   fetcher: (query) => searchUsers(query),\n * });\n *\n * <ComposerTriggerPopover\n *   char=\"@\"\n *   adapter={mentions.adapter}\n *   isLoading={mentions.isLoading}\n *   directive={{ onInserted }}\n * />\n * ```\n */\nexport function unstable_useLiveCompletionAdapter(\n  options: Unstable_UseLiveCompletionAdapterOptions,\n): { adapter: Unstable_TriggerAdapter; isLoading: boolean } {\n  const { fetcher, debounceMs = 60, enabled = true } = options;\n\n  const [state, setState] = useState<{\n    query: string;\n    items: readonly Unstable_TriggerItem[];\n  }>({ query: NO_QUERY, items: [] });\n  const [isLoading, setIsLoading] = useState(false);\n\n  const fetcherRef = useRef(fetcher);\n  fetcherRef.current = fetcher;\n\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const tokenRef = useRef(0);\n  const pendingQueryRef = useRef<string | null>(null);\n\n  const cancelTimer = useCallback(() => {\n    if (timerRef.current !== null) {\n      clearTimeout(timerRef.current);\n      timerRef.current = null;\n    }\n  }, []);\n\n  const scheduleFetch = useCallback(\n    (query: string) => {\n      if (!enabled) return;\n      if (pendingQueryRef.current === query) return;\n      pendingQueryRef.current = query;\n      cancelTimer();\n      const token = ++tokenRef.current;\n      setIsLoading(true);\n      timerRef.current = setTimeout(() => {\n        timerRef.current = null;\n        fetcherRef.current(query).then(\n          (items) => {\n            if (token !== tokenRef.current) return;\n            setState({ query, items });\n            setIsLoading(false);\n          },\n          () => {\n            if (token !== tokenRef.current) return;\n            setState({ query, items: [] });\n            setIsLoading(false);\n          },\n        );\n      }, debounceMs);\n    },\n    [enabled, debounceMs, cancelTimer],\n  );\n\n  const invalidatePending = useCallback(() => {\n    cancelTimer();\n    pendingQueryRef.current = null;\n    tokenRef.current += 1;\n    setIsLoading(false);\n  }, [cancelTimer]);\n\n  useEffect(() => {\n    if (enabled) return;\n    invalidatePending();\n    setState((s) =>\n      s.query === NO_QUERY ? s : { query: NO_QUERY, items: [] },\n    );\n  }, [enabled, invalidatePending]);\n\n  useEffect(() => cancelTimer, [cancelTimer]);\n\n  const adapter = useMemo<Unstable_TriggerAdapter>(\n    () => ({\n      categories: () => [],\n      categoryItems: () => [],\n      search: (query: string) => {\n        // search() runs inside the popover's render; defer state updates with\n        // queueMicrotask so they are not dispatched while another component renders.\n        if (query !== state.query) {\n          queueMicrotask(() => scheduleFetch(query));\n        } else if (\n          pendingQueryRef.current !== null &&\n          pendingQueryRef.current !== query\n        ) {\n          // the query returned to a cached value while a fetch for a different\n          // query is in flight; drop it so its result cannot overwrite the cache\n          queueMicrotask(invalidatePending);\n        }\n        return state.items;\n      },\n    }),\n    [state, scheduleFetch, invalidatePending],\n  );\n\n  return { adapter, isLoading };\n}\n"],"mappings":";;;;AAsBA,MAAMa,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6BjB,SAAgBC,kCACdC,SAC0D;CAC1D,MAAM,EAAEP,SAASG,aAAa,IAAIC,UAAU,SAASG;CAErD,MAAM,CAACG,OAAOC,YAAYf,SAGvB;EAAEK,OAAOI;EAAUO,OAAO,CAAA;CAAG,CAAC;CACjC,MAAM,CAACH,WAAWI,gBAAgBjB,SAAS,KAAK;CAEhD,MAAMkB,aAAanB,OAAOK,OAAO;CACjCc,WAAWC,UAAUf;CAErB,MAAMgB,WAAWrB,OAA6C,IAAI;CAClE,MAAMwB,WAAWxB,OAAO,CAAC;CACzB,MAAMyB,kBAAkBzB,OAAsB,IAAI;CAElD,MAAM0B,cAAc7B,kBAAkB;EACpC,IAAIwB,SAASD,YAAY,MAAM;GAC7BO,aAAaN,SAASD,OAAO;GAC7BC,SAASD,UAAU;EACrB;CACF,GAAG,CAAA,CAAE;CAEL,MAAMQ,gBAAgB/B,aACnBS,UAAkB;EACjB,IAAI,CAACG,SAAS;EACd,IAAIgB,gBAAgBL,YAAYd,OAAO;EACvCmB,gBAAgBL,UAAUd;EAC1BoB,YAAY;EACZ,MAAMG,QAAQ,EAAEL,SAASJ;EACzBF,aAAa,IAAI;EACjBG,SAASD,UAAUG,iBAAiB;GAClCF,SAASD,UAAU;GACnBD,WAAWC,QAAQd,KAAK,CAAC,CAACwB,MACvBb,UAAU;IACT,IAAIY,UAAUL,SAASJ,SAAS;IAChCJ,SAAS;KAAEV;KAAOW;IAAM,CAAC;IACzBC,aAAa,KAAK;GACpB,SACM;IACJ,IAAIW,UAAUL,SAASJ,SAAS;IAChCJ,SAAS;KAAEV;KAAOW,OAAO,CAAA;IAAG,CAAC;IAC7BC,aAAa,KAAK;GACpB,CACF;EACF,GAAGV,UAAU;CACf,GACA;EAACC;EAASD;EAAYkB;CAAW,CACnC;CAEA,MAAMK,oBAAoBlC,kBAAkB;EAC1C6B,YAAY;EACZD,gBAAgBL,UAAU;EAC1BI,SAASJ,WAAW;EACpBF,aAAa,KAAK;CACpB,GAAG,CAACQ,WAAW,CAAC;CAEhB5B,gBAAgB;EACd,IAAIW,SAAS;EACbsB,kBAAkB;EAClBf,UAAUgB,MACRA,EAAE1B,UAAUI,WAAWsB,IAAI;GAAE1B,OAAOI;GAAUO,OAAO,CAAA;EAAG,CAC1D;CACF,GAAG,CAACR,SAASsB,iBAAiB,CAAC;CAE/BjC,gBAAgB4B,aAAa,CAACA,WAAW,CAAC;CAyB1C,OAAO;EAAEb,SAvBOd,eACP;GACLkC,kBAAkB,CAAA;GAClBC,qBAAqB,CAAA;GACrBC,SAAS7B,UAAkB;IAGzB,IAAIA,UAAUS,MAAMT,OAClB8B,qBAAqBR,cAActB,KAAK,CAAC;SACpC,IACLmB,gBAAgBL,YAAY,QAC5BK,gBAAgBL,YAAYd,OAI5B8B,eAAeL,iBAAiB;IAElC,OAAOhB,MAAME;GACf;EACF,IACA;GAACF;GAAOa;GAAeG;EAAiB,CAGjClB;EAASC;CAAU;AAC9B"}

package/dist/utils/smooth/useSmooth.d.ts

@@ -22,6 +22,14 @@ type SmoothOptions = {
    * @default Infinity
    */
   maxCharsPerFrame?: number | undefined;
+  /**
+   * Minimum time in milliseconds between committed updates. The reveal keeps
+   * advancing every frame, but the visible text (and the downstream re-render
+   * and markdown re-parse it triggers) is committed at most once per interval.
+   * The final frame always commits. `0` commits every frame.
+   * @default 0
+   */
+  minCommitMs?: number | undefined;
 };
 /**
  * Animates streamed message part text with a typewriter-style reveal.

package/dist/utils/smooth/useSmooth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSmooth.d.ts","names":[],"sources":["../../../src/utils/smooth/useSmooth.ts"],"mappings":";;;;;AAiBA;KAAY,aAAA;;;;;;EAMV,OAAA;EAWgB;AA+FlB;;;;EApGE,iBAAA;EAqG6C;;;;EAhG7C,gBAAA;AAAA;;;;;;;;;;;;AAkG2D;;;;;cAHhD,SAAA,GACX,KAAA,EAAO,gBAAA,IAAoB,eAAA,GAAkB,oBAAA,GAC7C,MAAA,aAAkB,aAAA,KACjB,gBAAA,IAAoB,eAAA,GAAkB,oBAAA"}
+{"version":3,"file":"useSmooth.d.ts","names":[],"sources":["../../../src/utils/smooth/useSmooth.ts"],"mappings":";;;;;AAiBA;KAAY,aAAA;;;;;;EAMV,OAAA;EAmBW;AAAA;AAsGb;;;EAnHE,iBAAA;EAoH2B;;;;EA/G3B,gBAAA;EAiHuC;;;;;;;EAzGvC,WAAA;AAAA;;;;;AAyG2D;;;;;;;;;;;;cAHhD,SAAA,GACX,KAAA,EAAO,gBAAA,IAAoB,eAAA,GAAkB,oBAAA,GAC7C,MAAA,aAAkB,aAAA,KACjB,gBAAA,IAAoB,eAAA,GAAkB,oBAAA"}

package/dist/utils/smooth/useSmooth.js

@@ -12,10 +12,12 @@ var TextStreamAnimator = class {
 	setText;
 	animationFrameId = null;
 	lastUpdateTime = Date.now();
+	lastCommitTime = 0;
 	targetText = "";
 	drainMs = DEFAULT_DRAIN_MS;
 	maxCharIntervalMs = DEFAULT_MAX_CHAR_INTERVAL_MS;
 	maxCharsPerFrame = Infinity;
+	minCommitMs = 0;
 	constructor(currentText, setText) {
 		this.currentText = currentText;
 		this.setText = setText;
@@ -48,7 +50,10 @@ var TextStreamAnimator = class {
 		if (charsToAdd === 0) return;
 		this.currentText = this.targetText.slice(0, this.currentText.length + charsToAdd);
 		this.lastUpdateTime = currentTime - timeToConsume;
-		this.setText(this.currentText);
+		if (charsToAdd === remainingChars || currentTime - this.lastCommitTime >= this.minCommitMs) {
+			this.lastCommitTime = currentTime;
+			this.setText(this.currentText);
+		}
 	};
 };
 const SMOOTH_STATUS = Object.freeze({ type: "running" });
@@ -76,6 +81,7 @@ const useSmooth = (state, smooth = false) => {
 	const drainMs = positiveOr(options?.drainMs, DEFAULT_DRAIN_MS);
 	const maxCharIntervalMs = positiveOr(options?.maxCharIntervalMs, DEFAULT_MAX_CHAR_INTERVAL_MS);
 	const maxCharsPerFrame = positiveOr(options?.maxCharsPerFrame, Infinity);
+	const minCommitMs = positiveOr(options?.minCommitMs, 0);
 	const [displayedText, setDisplayedText] = useState(state.status.type === "running" ? "" : text);
 	const aui = useAui();
 	const part = useAuiState(() => aui.part());
@@ -109,11 +115,13 @@ const useSmooth = (state, smooth = false) => {
 		animatorRef.drainMs = drainMs;
 		animatorRef.maxCharIntervalMs = maxCharIntervalMs;
 		animatorRef.maxCharsPerFrame = maxCharsPerFrame;
+		animatorRef.minCommitMs = minCommitMs;
 	}, [
 		animatorRef,
 		drainMs,
 		maxCharIntervalMs,
-		maxCharsPerFrame
+		maxCharsPerFrame,
+		minCommitMs
 	]);
 	const animatorPartRef = useRef(part);
 	useEffect(() => {
@@ -127,6 +135,7 @@ const useSmooth = (state, smooth = false) => {
 			if (state.status.type === "running") {
 				animatorRef.currentText = "";
 				animatorRef.targetText = text;
+				animatorRef.lastCommitTime = 0;
 				animatorRef.start();
 			} else {
 				animatorRef.currentText = text;

package/dist/utils/smooth/useSmooth.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSmooth.js","names":["useEffect","useMemo","useRef","useState","useAui","useAuiState","MessagePartStatus","ReasoningMessagePart","TextMessagePart","MessagePartState","useCallbackRef","useSmoothStatusStore","writableStore","SmoothOptions","drainMs","maxCharIntervalMs","maxCharsPerFrame","DEFAULT_DRAIN_MS","DEFAULT_MAX_CHAR_INTERVAL_MS","TextStreamAnimator","animationFrameId","lastUpdateTime","Date","now","targetText","Infinity","constructor","currentText","setText","newText","start","animate","stop","cancelAnimationFrame","currentTime","deltaTime","timeToConsume","remainingChars","length","baseTimePerChar","Math","min","frameLimit","charsToAdd","requestAnimationFrame","slice","SMOOTH_STATUS","Object","freeze","type","positiveOr","value","fallback","undefined","useSmooth","state","smooth","text","options","enabled","displayedText","setDisplayedText","status","aui","part","prevPart","setPrevPart","startsWith","smoothStatusStore","optional","target","setState","animatorRef","animatorPartRef","partChanged","current"],"sources":["../../../src/utils/smooth/useSmooth.ts"],"sourcesContent":["\"use client\";\n\nimport { useEffect, useMemo, useRef, useState } from \"react\";\nimport { useAui, useAuiState } from \"@assistant-ui/store\";\nimport type {\n  MessagePartStatus,\n  ReasoningMessagePart,\n  TextMessagePart,\n  MessagePartState,\n} from \"@assistant-ui/core\";\nimport { useCallbackRef } from \"@radix-ui/react-use-callback-ref\";\nimport { useSmoothStatusStore } from \"./SmoothContext\";\nimport { writableStore } from \"../../context/ReadonlyStore\";\n\n/**\n * Tuning options for the smooth text streaming animation.\n */\nexport type SmoothOptions = {\n  /**\n   * Target time in milliseconds to drain the backlog of unrevealed\n   * characters. Larger values reveal long backlogs more gradually.\n   * @default 250\n   */\n  drainMs?: number | undefined;\n  /**\n   * Maximum time in milliseconds between revealed characters, i.e. the\n   * slowest reveal rate when the backlog is short.\n   * @default 5\n   */\n  maxCharIntervalMs?: number | undefined;\n  /**\n   * Maximum number of characters revealed per animation frame.\n   * @default Infinity\n   */\n  maxCharsPerFrame?: number | undefined;\n};\n\nconst DEFAULT_DRAIN_MS = 250;\nconst DEFAULT_MAX_CHAR_INTERVAL_MS = 5;\n\nclass TextStreamAnimator {\n  private animationFrameId: number | null = null;\n  private lastUpdateTime: number = Date.now();\n\n  public targetText: string = \"\";\n  public drainMs: number = DEFAULT_DRAIN_MS;\n  public maxCharIntervalMs: number = DEFAULT_MAX_CHAR_INTERVAL_MS;\n  public maxCharsPerFrame: number = Infinity;\n\n  constructor(\n    public currentText: string,\n    private setText: (newText: string) => void,\n  ) {}\n\n  start() {\n    if (this.animationFrameId !== null) return;\n    this.lastUpdateTime = Date.now();\n    this.animate();\n  }\n\n  stop() {\n    if (this.animationFrameId !== null) {\n      cancelAnimationFrame(this.animationFrameId);\n      this.animationFrameId = null;\n    }\n  }\n\n  private animate = () => {\n    const currentTime = Date.now();\n    const deltaTime = currentTime - this.lastUpdateTime;\n    let timeToConsume = deltaTime;\n\n    const remainingChars = this.targetText.length - this.currentText.length;\n    const baseTimePerChar = Math.min(\n      this.maxCharIntervalMs,\n      this.drainMs / remainingChars,\n    );\n\n    const frameLimit = Math.min(remainingChars, this.maxCharsPerFrame);\n    let charsToAdd = 0;\n    while (timeToConsume >= baseTimePerChar && charsToAdd < frameLimit) {\n      charsToAdd++;\n      timeToConsume -= baseTimePerChar;\n    }\n    // A cap-limited frame must not bank its surplus time, or the next\n    // frame would burst past the cap.\n    if (charsToAdd === frameLimit && frameLimit === this.maxCharsPerFrame) {\n      timeToConsume = 0;\n    }\n\n    if (charsToAdd !== remainingChars) {\n      this.animationFrameId = requestAnimationFrame(this.animate);\n    } else {\n      this.animationFrameId = null;\n    }\n    if (charsToAdd === 0) return;\n\n    this.currentText = this.targetText.slice(\n      0,\n      this.currentText.length + charsToAdd,\n    );\n    this.lastUpdateTime = currentTime - timeToConsume;\n    this.setText(this.currentText);\n  };\n}\n\nconst SMOOTH_STATUS: MessagePartStatus = Object.freeze({\n  type: \"running\",\n});\n\nconst positiveOr = (value: number | undefined, fallback: number): number =>\n  value !== undefined && value > 0 ? value : fallback;\n\n/**\n * Animates streamed message part text with a typewriter-style reveal.\n *\n * Takes the current part state and a `smooth` argument: `false` disables,\n * `true` uses the default rate, and a {@link SmoothOptions} object tunes\n * the reveal. Returns the part state with `text` replaced by the revealed\n * prefix and `status` reporting `running` until the reveal catches up.\n *\n * @example\n * ```tsx\n * const { text, status } = useSmooth(useMessagePartText(), {\n *   drainMs: 500,\n *   maxCharsPerFrame: 30,\n * });\n * ```\n */\nexport const useSmooth = (\n  state: MessagePartState & (TextMessagePart | ReasoningMessagePart),\n  smooth: boolean | SmoothOptions = false,\n): MessagePartState & (TextMessagePart | ReasoningMessagePart) => {\n  const { text } = state;\n  const options =\n    typeof smooth === \"object\" && smooth !== null ? smooth : undefined;\n  const enabled = smooth !== false && smooth !== null;\n  const drainMs = positiveOr(options?.drainMs, DEFAULT_DRAIN_MS);\n  const maxCharIntervalMs = positiveOr(\n    options?.maxCharIntervalMs,\n    DEFAULT_MAX_CHAR_INTERVAL_MS,\n  );\n  const maxCharsPerFrame = positiveOr(options?.maxCharsPerFrame, Infinity);\n\n  const [displayedText, setDisplayedText] = useState(\n    state.status.type === \"running\" ? \"\" : text,\n  );\n\n  // Render-phase resync on part flip or text discontinuity, so the\n  // first paint after a thread switch never shows the previous\n  // part's text (#4051). `displayedText` is already a prefix of\n  // `text` during normal streaming, so use it as the previous-text\n  // reference instead of carrying separate state — avoids the\n  // double render per streaming token. Read part identity through\n  // `useAuiState` so we actually subscribe to its changes instead\n  // of relying on a render-time proxy reference that may be stable\n  // across thread swaps.\n  const aui = useAui();\n  const part = useAuiState(() => aui.part());\n  const [prevPart, setPrevPart] = useState(part);\n  if (part !== prevPart || !text.startsWith(displayedText)) {\n    setPrevPart(part);\n    setDisplayedText(state.status.type === \"running\" ? \"\" : text);\n  }\n\n  const smoothStatusStore = useSmoothStatusStore({ optional: true });\n  const setText = useCallbackRef((text: string) => {\n    setDisplayedText(text);\n    if (smoothStatusStore) {\n      const target =\n        displayedText !== text || state.status.type === \"running\"\n          ? SMOOTH_STATUS\n          : state.status;\n      writableStore(smoothStatusStore).setState(target, true);\n    }\n  });\n\n  // TODO this is hacky\n  useEffect(() => {\n    if (smoothStatusStore) {\n      const target =\n        enabled && (displayedText !== text || state.status.type === \"running\")\n          ? SMOOTH_STATUS\n          : state.status;\n      writableStore(smoothStatusStore).setState(target, true);\n    }\n  }, [smoothStatusStore, enabled, text, displayedText, state.status]);\n\n  const [animatorRef] = useState<TextStreamAnimator>(\n    new TextStreamAnimator(displayedText, setText),\n  );\n\n  useEffect(() => {\n    animatorRef.drainMs = drainMs;\n    animatorRef.maxCharIntervalMs = maxCharIntervalMs;\n    animatorRef.maxCharsPerFrame = maxCharsPerFrame;\n  }, [animatorRef, drainMs, maxCharIntervalMs, maxCharsPerFrame]);\n\n  const animatorPartRef = useRef(part);\n  useEffect(() => {\n    if (!enabled) {\n      animatorRef.stop();\n      return;\n    }\n\n    // Discontinuity: part flipped, or new text breaks continuation\n    // of the animator's current target. Either case requires\n    // resetting the cursor — without the part check, a new part\n    // whose text happens to share a prefix with the previous target\n    // would keep the stale cursor and flicker.\n    const partChanged = animatorPartRef.current !== part;\n    animatorPartRef.current = part;\n    if (partChanged || !text.startsWith(animatorRef.targetText)) {\n      if (state.status.type === \"running\") {\n        animatorRef.currentText = \"\";\n        animatorRef.targetText = text;\n        animatorRef.start();\n      } else {\n        animatorRef.currentText = text;\n        animatorRef.targetText = text;\n        animatorRef.stop();\n      }\n      return;\n    }\n\n    animatorRef.targetText = text;\n    animatorRef.start();\n  }, [animatorRef, enabled, text, state.status.type, part]);\n\n  useEffect(() => {\n    return () => {\n      animatorRef.stop();\n    };\n  }, [animatorRef]);\n\n  return useMemo(\n    () =>\n      enabled\n        ? {\n            ...state,\n            text: displayedText,\n            status: text === displayedText ? state.status : SMOOTH_STATUS,\n          }\n        : state,\n    [enabled, displayedText, state, text],\n  );\n};\n"],"mappings":"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"}
+{"version":3,"file":"useSmooth.js","names":["useEffect","useMemo","useRef","useState","useAui","useAuiState","MessagePartStatus","ReasoningMessagePart","TextMessagePart","MessagePartState","useCallbackRef","useSmoothStatusStore","writableStore","SmoothOptions","drainMs","maxCharIntervalMs","maxCharsPerFrame","minCommitMs","DEFAULT_DRAIN_MS","DEFAULT_MAX_CHAR_INTERVAL_MS","TextStreamAnimator","animationFrameId","lastUpdateTime","Date","now","lastCommitTime","targetText","Infinity","constructor","currentText","setText","newText","start","animate","stop","cancelAnimationFrame","currentTime","deltaTime","timeToConsume","remainingChars","length","baseTimePerChar","Math","min","frameLimit","charsToAdd","requestAnimationFrame","slice","isComplete","SMOOTH_STATUS","Object","freeze","type","positiveOr","value","fallback","undefined","useSmooth","state","smooth","text","options","enabled","displayedText","setDisplayedText","status","aui","part","prevPart","setPrevPart","startsWith","smoothStatusStore","optional","target","setState","animatorRef","animatorPartRef","partChanged","current"],"sources":["../../../src/utils/smooth/useSmooth.ts"],"sourcesContent":["\"use client\";\n\nimport { useEffect, useMemo, useRef, useState } from \"react\";\nimport { useAui, useAuiState } from \"@assistant-ui/store\";\nimport type {\n  MessagePartStatus,\n  ReasoningMessagePart,\n  TextMessagePart,\n  MessagePartState,\n} from \"@assistant-ui/core\";\nimport { useCallbackRef } from \"@radix-ui/react-use-callback-ref\";\nimport { useSmoothStatusStore } from \"./SmoothContext\";\nimport { writableStore } from \"../../context/ReadonlyStore\";\n\n/**\n * Tuning options for the smooth text streaming animation.\n */\nexport type SmoothOptions = {\n  /**\n   * Target time in milliseconds to drain the backlog of unrevealed\n   * characters. Larger values reveal long backlogs more gradually.\n   * @default 250\n   */\n  drainMs?: number | undefined;\n  /**\n   * Maximum time in milliseconds between revealed characters, i.e. the\n   * slowest reveal rate when the backlog is short.\n   * @default 5\n   */\n  maxCharIntervalMs?: number | undefined;\n  /**\n   * Maximum number of characters revealed per animation frame.\n   * @default Infinity\n   */\n  maxCharsPerFrame?: number | undefined;\n  /**\n   * Minimum time in milliseconds between committed updates. The reveal keeps\n   * advancing every frame, but the visible text (and the downstream re-render\n   * and markdown re-parse it triggers) is committed at most once per interval.\n   * The final frame always commits. `0` commits every frame.\n   * @default 0\n   */\n  minCommitMs?: number | undefined;\n};\n\nconst DEFAULT_DRAIN_MS = 250;\nconst DEFAULT_MAX_CHAR_INTERVAL_MS = 5;\n\nclass TextStreamAnimator {\n  private animationFrameId: number | null = null;\n  private lastUpdateTime: number = Date.now();\n  public lastCommitTime: number = 0;\n\n  public targetText: string = \"\";\n  public drainMs: number = DEFAULT_DRAIN_MS;\n  public maxCharIntervalMs: number = DEFAULT_MAX_CHAR_INTERVAL_MS;\n  public maxCharsPerFrame: number = Infinity;\n  public minCommitMs: number = 0;\n\n  constructor(\n    public currentText: string,\n    private setText: (newText: string) => void,\n  ) {}\n\n  start() {\n    if (this.animationFrameId !== null) return;\n    this.lastUpdateTime = Date.now();\n    this.animate();\n  }\n\n  stop() {\n    if (this.animationFrameId !== null) {\n      cancelAnimationFrame(this.animationFrameId);\n      this.animationFrameId = null;\n    }\n  }\n\n  private animate = () => {\n    const currentTime = Date.now();\n    const deltaTime = currentTime - this.lastUpdateTime;\n    let timeToConsume = deltaTime;\n\n    const remainingChars = this.targetText.length - this.currentText.length;\n    const baseTimePerChar = Math.min(\n      this.maxCharIntervalMs,\n      this.drainMs / remainingChars,\n    );\n\n    const frameLimit = Math.min(remainingChars, this.maxCharsPerFrame);\n    let charsToAdd = 0;\n    while (timeToConsume >= baseTimePerChar && charsToAdd < frameLimit) {\n      charsToAdd++;\n      timeToConsume -= baseTimePerChar;\n    }\n    // A cap-limited frame must not bank its surplus time, or the next\n    // frame would burst past the cap.\n    if (charsToAdd === frameLimit && frameLimit === this.maxCharsPerFrame) {\n      timeToConsume = 0;\n    }\n\n    if (charsToAdd !== remainingChars) {\n      this.animationFrameId = requestAnimationFrame(this.animate);\n    } else {\n      this.animationFrameId = null;\n    }\n    if (charsToAdd === 0) return;\n\n    this.currentText = this.targetText.slice(\n      0,\n      this.currentText.length + charsToAdd,\n    );\n    this.lastUpdateTime = currentTime - timeToConsume;\n\n    const isComplete = charsToAdd === remainingChars;\n    if (isComplete || currentTime - this.lastCommitTime >= this.minCommitMs) {\n      this.lastCommitTime = currentTime;\n      this.setText(this.currentText);\n    }\n  };\n}\n\nconst SMOOTH_STATUS: MessagePartStatus = Object.freeze({\n  type: \"running\",\n});\n\nconst positiveOr = (value: number | undefined, fallback: number): number =>\n  value !== undefined && value > 0 ? value : fallback;\n\n/**\n * Animates streamed message part text with a typewriter-style reveal.\n *\n * Takes the current part state and a `smooth` argument: `false` disables,\n * `true` uses the default rate, and a {@link SmoothOptions} object tunes\n * the reveal. Returns the part state with `text` replaced by the revealed\n * prefix and `status` reporting `running` until the reveal catches up.\n *\n * @example\n * ```tsx\n * const { text, status } = useSmooth(useMessagePartText(), {\n *   drainMs: 500,\n *   maxCharsPerFrame: 30,\n * });\n * ```\n */\nexport const useSmooth = (\n  state: MessagePartState & (TextMessagePart | ReasoningMessagePart),\n  smooth: boolean | SmoothOptions = false,\n): MessagePartState & (TextMessagePart | ReasoningMessagePart) => {\n  const { text } = state;\n  const options =\n    typeof smooth === \"object\" && smooth !== null ? smooth : undefined;\n  const enabled = smooth !== false && smooth !== null;\n  const drainMs = positiveOr(options?.drainMs, DEFAULT_DRAIN_MS);\n  const maxCharIntervalMs = positiveOr(\n    options?.maxCharIntervalMs,\n    DEFAULT_MAX_CHAR_INTERVAL_MS,\n  );\n  const maxCharsPerFrame = positiveOr(options?.maxCharsPerFrame, Infinity);\n  const minCommitMs = positiveOr(options?.minCommitMs, 0);\n\n  const [displayedText, setDisplayedText] = useState(\n    state.status.type === \"running\" ? \"\" : text,\n  );\n\n  // Render-phase resync on part flip or text discontinuity, so the\n  // first paint after a thread switch never shows the previous\n  // part's text (#4051). `displayedText` is already a prefix of\n  // `text` during normal streaming, so use it as the previous-text\n  // reference instead of carrying separate state — avoids the\n  // double render per streaming token. Read part identity through\n  // `useAuiState` so we actually subscribe to its changes instead\n  // of relying on a render-time proxy reference that may be stable\n  // across thread swaps.\n  const aui = useAui();\n  const part = useAuiState(() => aui.part());\n  const [prevPart, setPrevPart] = useState(part);\n  if (part !== prevPart || !text.startsWith(displayedText)) {\n    setPrevPart(part);\n    setDisplayedText(state.status.type === \"running\" ? \"\" : text);\n  }\n\n  const smoothStatusStore = useSmoothStatusStore({ optional: true });\n  const setText = useCallbackRef((text: string) => {\n    setDisplayedText(text);\n    if (smoothStatusStore) {\n      const target =\n        displayedText !== text || state.status.type === \"running\"\n          ? SMOOTH_STATUS\n          : state.status;\n      writableStore(smoothStatusStore).setState(target, true);\n    }\n  });\n\n  // TODO this is hacky\n  useEffect(() => {\n    if (smoothStatusStore) {\n      const target =\n        enabled && (displayedText !== text || state.status.type === \"running\")\n          ? SMOOTH_STATUS\n          : state.status;\n      writableStore(smoothStatusStore).setState(target, true);\n    }\n  }, [smoothStatusStore, enabled, text, displayedText, state.status]);\n\n  const [animatorRef] = useState<TextStreamAnimator>(\n    new TextStreamAnimator(displayedText, setText),\n  );\n\n  useEffect(() => {\n    animatorRef.drainMs = drainMs;\n    animatorRef.maxCharIntervalMs = maxCharIntervalMs;\n    animatorRef.maxCharsPerFrame = maxCharsPerFrame;\n    animatorRef.minCommitMs = minCommitMs;\n  }, [animatorRef, drainMs, maxCharIntervalMs, maxCharsPerFrame, minCommitMs]);\n\n  const animatorPartRef = useRef(part);\n  useEffect(() => {\n    if (!enabled) {\n      animatorRef.stop();\n      return;\n    }\n\n    // Discontinuity: part flipped, or new text breaks continuation\n    // of the animator's current target. Either case requires\n    // resetting the cursor — without the part check, a new part\n    // whose text happens to share a prefix with the previous target\n    // would keep the stale cursor and flicker.\n    const partChanged = animatorPartRef.current !== part;\n    animatorPartRef.current = part;\n    if (partChanged || !text.startsWith(animatorRef.targetText)) {\n      if (state.status.type === \"running\") {\n        animatorRef.currentText = \"\";\n        animatorRef.targetText = text;\n        animatorRef.lastCommitTime = 0;\n        animatorRef.start();\n      } else {\n        animatorRef.currentText = text;\n        animatorRef.targetText = text;\n        animatorRef.stop();\n      }\n      return;\n    }\n\n    animatorRef.targetText = text;\n    animatorRef.start();\n  }, [animatorRef, enabled, text, state.status.type, part]);\n\n  useEffect(() => {\n    return () => {\n      animatorRef.stop();\n    };\n  }, [animatorRef]);\n\n  return useMemo(\n    () =>\n      enabled\n        ? {\n            ...state,\n            text: displayedText,\n            status: text === displayedText ? state.status : SMOOTH_STATUS,\n          }\n        : state,\n    [enabled, displayedText, state, text],\n  );\n};\n"],"mappings":";;;;;;;AA6CA,MAAMkB,mBAAmB;AACzB,MAAMC,+BAA+B;AAErC,IAAMC,qBAAN,MAAyB;CAYdS;CACCC;CAZV,mBAA0C;CAC1C,iBAAiCP,KAAKC,IAAI;CAC1C,iBAAgC;CAEhC,aAA4B;CAC5B,UAAyBN;CACzB,oBAAmCC;CACnC,mBAAkCQ;CAClC,cAA6B;CAE7BC,YACE,aACA,SACA;EAFOC,KAAAA,cAAAA;EACCC,KAAAA,UAAAA;CACP;CAEHE,QAAQ;EACN,IAAI,KAAKX,qBAAqB,MAAM;EACpC,KAAKC,iBAAiBC,KAAKC,IAAI;EAC/B,KAAKS,QAAQ;CACf;CAEAC,OAAO;EACL,IAAI,KAAKb,qBAAqB,MAAM;GAClCc,qBAAqB,KAAKd,gBAAgB;GAC1C,KAAKA,mBAAmB;EAC1B;CACF;CAEA,gBAAwB;EACtB,MAAMe,cAAcb,KAAKC,IAAI;EAE7B,IAAIc,gBADcF,cAAc,KAAKd;EAGrC,MAAMiB,iBAAiB,KAAKb,WAAWc,SAAS,KAAKX,YAAYW;EACjE,MAAMC,kBAAkBC,KAAKC,IAC3B,KAAK5B,mBACL,KAAKD,UAAUyB,cACjB;EAEA,MAAMK,aAAaF,KAAKC,IAAIJ,gBAAgB,KAAKvB,gBAAgB;EACjE,IAAI6B,aAAa;EACjB,OAAOP,iBAAiBG,mBAAmBI,aAAaD,YAAY;GAClEC;GACAP,iBAAiBG;EACnB;EAGA,IAAII,eAAeD,cAAcA,eAAe,KAAK5B,kBACnDsB,gBAAgB;EAGlB,IAAIO,eAAeN,gBACjB,KAAKlB,mBAAmByB,sBAAsB,KAAKb,OAAO;OAE1D,KAAKZ,mBAAmB;EAE1B,IAAIwB,eAAe,GAAG;EAEtB,KAAKhB,cAAc,KAAKH,WAAWqB,MACjC,GACA,KAAKlB,YAAYW,SAASK,UAC5B;EACA,KAAKvB,iBAAiBc,cAAcE;EAGpC,IADmBO,eAAeN,kBAChBH,cAAc,KAAKX,kBAAkB,KAAKR,aAAa;GACvE,KAAKQ,iBAAiBW;GACtB,KAAKN,QAAQ,KAAKD,WAAW;EAC/B;CACF;AACF;AAEA,MAAMoB,gBAAmCC,OAAOC,OAAO,EACrDC,MAAM,UACR,CAAC;AAED,MAAMC,cAAcC,OAA2BC,aAC7CD,UAAUE,KAAAA,KAAaF,QAAQ,IAAIA,QAAQC;;;;;;;;;;;;;;;;;AAkB7C,MAAaE,aACXC,OACAC,SAAkC,UAC8B;CAChE,MAAM,EAAEC,SAASF;CACjB,MAAMG,UACJ,OAAOF,WAAW,YAAYA,WAAW,OAAOA,SAASH,KAAAA;CAC3D,MAAMM,UAAUH,WAAW,SAASA,WAAW;CAC/C,MAAM7C,UAAUuC,WAAWQ,SAAS/C,SAASI,gBAAgB;CAC7D,MAAMH,oBAAoBsC,WACxBQ,SAAS9C,mBACTI,4BACF;CACA,MAAMH,mBAAmBqC,WAAWQ,SAAS7C,kBAAkBW,QAAQ;CACvE,MAAMV,cAAcoC,WAAWQ,SAAS5C,aAAa,CAAC;CAEtD,MAAM,CAAC8C,eAAeC,oBAAoB7D,SACxCuD,MAAMO,OAAOb,SAAS,YAAY,KAAKQ,IACzC;CAWA,MAAMM,MAAM9D,OAAO;CACnB,MAAM+D,OAAO9D,kBAAkB6D,IAAIC,KAAK,CAAC;CACzC,MAAM,CAACC,UAAUC,eAAelE,SAASgE,IAAI;CAC7C,IAAIA,SAASC,YAAY,CAACR,KAAKU,WAAWP,aAAa,GAAG;EACxDM,YAAYF,IAAI;EAChBH,iBAAiBN,MAAMO,OAAOb,SAAS,YAAY,KAAKQ,IAAI;CAC9D;CAEA,MAAMW,oBAAoB5D,qBAAqB,EAAE6D,UAAU,KAAK,CAAC;CACjE,MAAM1C,UAAUpB,gBAAgBkD,WAAiB;EAC/CI,iBAAiBJ,MAAI;EACrB,IAAIW,mBAAmB;GACrB,MAAME,SACJV,kBAAkBH,UAAQF,MAAMO,OAAOb,SAAS,YAC5CH,gBACAS,MAAMO;GACZrD,cAAc2D,iBAAiB,CAAC,CAACG,SAASD,QAAQ,IAAI;EACxD;CACF,CAAC;CAGDzE,gBAAgB;EACd,IAAIuE,mBAAmB;GACrB,MAAME,WACJX,YAAYC,kBAAkBH,QAAQF,MAAMO,OAAOb,SAAS,aACxDH,gBACAS,MAAMO;GACZrD,cAAc2D,iBAAiB,CAAC,CAACG,SAASD,UAAQ,IAAI;EACxD;CACF,GAAG;EAACF;EAAmBT;EAASF;EAAMG;EAAeL,MAAMO;CAAM,CAAC;CAElE,MAAM,CAACU,eAAexE,SACpB,IAAIiB,mBAAmB2C,eAAejC,OAAO,CAC/C;CAEA9B,gBAAgB;EACd2E,YAAY7D,UAAUA;EACtB6D,YAAY5D,oBAAoBA;EAChC4D,YAAY3D,mBAAmBA;EAC/B2D,YAAY1D,cAAcA;CAC5B,GAAG;EAAC0D;EAAa7D;EAASC;EAAmBC;EAAkBC;CAAW,CAAC;CAE3E,MAAM2D,kBAAkB1E,OAAOiE,IAAI;CACnCnE,gBAAgB;EACd,IAAI,CAAC8D,SAAS;GACZa,YAAYzC,KAAK;GACjB;EACF;EAOA,MAAM2C,cAAcD,gBAAgBE,YAAYX;EAChDS,gBAAgBE,UAAUX;EAC1B,IAAIU,eAAe,CAACjB,KAAKU,WAAWK,YAAYjD,UAAU,GAAG;GAC3D,IAAIgC,MAAMO,OAAOb,SAAS,WAAW;IACnCuB,YAAY9C,cAAc;IAC1B8C,YAAYjD,aAAakC;IACzBe,YAAYlD,iBAAiB;IAC7BkD,YAAY3C,MAAM;GACpB,OAAO;IACL2C,YAAY9C,cAAc+B;IAC1Be,YAAYjD,aAAakC;IACzBe,YAAYzC,KAAK;GACnB;GACA;EACF;EAEAyC,YAAYjD,aAAakC;EACzBe,YAAY3C,MAAM;CACpB,GAAG;EAAC2C;EAAab;EAASF;EAAMF,MAAMO,OAAOb;EAAMe;CAAI,CAAC;CAExDnE,gBAAgB;EACd,aAAa;GACX2E,YAAYzC,KAAK;EACnB;CACF,GAAG,CAACyC,WAAW,CAAC;CAEhB,OAAO1E,cAEH6D,UACI;EACE,GAAGJ;EACHE,MAAMG;EACNE,QAAQL,SAASG,gBAAgBL,MAAMO,SAAShB;CAClD,IACAS,OACN;EAACI;EAASC;EAAeL;EAAOE;CAAI,CACtC;AACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@assistant-ui/react",
-  "version": "0.14.21",
+  "version": "0.14.22",
   "description": "Open-source TypeScript/React library for building production-grade AI chat experiences",
   "keywords": [
     "ai",
@@ -55,7 +55,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@assistant-ui/core": "^0.2.16",
+    "@assistant-ui/core": "^0.2.17",
     "@assistant-ui/store": "^0.2.18",
     "@assistant-ui/tap": "^0.9.2",
     "@radix-ui/primitive": "^1.1.4",

package/src/index.ts

@@ -124,6 +124,7 @@ export type {
 
 // --- external-store ---
 export type { ThreadMessageLike } from "@assistant-ui/core";
+export { fromThreadMessageLike, generateId } from "@assistant-ui/core";
 export {
   getExternalStoreMessages,
   bindExternalStoreMessage,
@@ -414,6 +415,12 @@ export {
   type Unstable_UseSlashCommandAdapterOptions,
 } from "./unstable/useSlashCommandAdapter";
 
+// Unstable - live (async) completion adapter helper
+export {
+  unstable_useLiveCompletionAdapter,
+  type Unstable_UseLiveCompletionAdapterOptions,
+} from "./unstable/useLiveCompletionAdapter";
+
 export type { ToolExecutionStatus } from "./internal";
 
 // Unstable - trigger popover (unified root for @ mentions, / slash commands, etc.)

package/src/internal.ts

@@ -10,10 +10,8 @@ export {
   CompositeContextProvider,
   MessageRepository,
   BaseAssistantRuntimeCore,
-  generateId,
   AssistantRuntimeImpl,
   ThreadRuntimeImpl,
-  fromThreadMessageLike,
   getAutoStatus,
 } from "@assistant-ui/core/internal";
 export type {

package/src/primitives/composer/trigger/TriggerPopover.tsx

@@ -72,6 +72,8 @@ export namespace ComposerPrimitiveTriggerPopover {
     readonly char: string;
     /** Adapter providing categories and items. */
     readonly adapter?: Unstable_TriggerAdapter | undefined;
+    /** Whether the adapter is resolving items, surfaced to the popover scope for async sources. @default false */
+    readonly isLoading?: boolean | undefined;
   };
 }
 
@@ -107,7 +109,14 @@ export const ComposerPrimitiveTriggerPopover = forwardRef<
   ComposerPrimitiveTriggerPopover.Props
 >(
   (
-    { char, adapter, "aria-label": ariaLabel, children, ...props },
+    {
+      char,
+      adapter,
+      isLoading = false,
+      "aria-label": ariaLabel,
+      children,
+      ...props
+    },
     forwardedRef,
   ) => {
     const aui = useAui();
@@ -159,6 +168,7 @@ export const ComposerPrimitiveTriggerPopover = forwardRef<
         behavior: behavior ?? undefined,
         aui,
         popoverId,
+        isLoading,
       }),
     );
 

package/src/primitives/composer/trigger/TriggerPopoverResource.ts

@@ -29,6 +29,8 @@ export type TriggerPopoverResourceOutput = {
   readonly items: readonly Unstable_TriggerItem[];
   readonly highlightedIndex: number;
   readonly isSearchMode: boolean;
+  /** Whether the adapter is currently resolving items (async sources). */
+  readonly isLoading: boolean;
   /** Stable ID prefix for generating accessible element IDs. */
   readonly popoverId: string;
   /** ID of the currently highlighted item (for aria-activedescendant). */
@@ -58,6 +60,7 @@ const useTriggerPopoverResource = ({
   behavior,
   aui,
   popoverId,
+  isLoading,
 }: {
   adapter: Unstable_TriggerAdapter | undefined;
   text: string;
@@ -66,6 +69,7 @@ const useTriggerPopoverResource = ({
   aui: AssistantClient;
   /** Stable ID for accessible element IDs (pass React's useId() from component layer). */
   popoverId: string;
+  isLoading: boolean;
 }): TriggerPopoverResourceOutput => {
   const detection = useResource(
     TriggerDetectionResource({ text, triggerChar }),
@@ -122,6 +126,7 @@ const useTriggerPopoverResource = ({
     items: navigation.items,
     highlightedIndex: keyboard.highlightedIndex,
     isSearchMode: navigation.isSearchMode,
+    isLoading,
     popoverId,
     highlightedItemId: keyboard.highlightedItemId,
     selectCategory: navigation.selectCategory,