refactor: deprecate primitive-hooks (#961)

* refactor: deprecate primitive-hooks

* changeset

.changeset/fresh-books-greet.md

@@ -0,0 +1,5 @@
+---
+"@assistant-ui/react": patch
+---
+
+refactor: deprecate primitive-hooks

packages/react/src/primitive-hooks/actionBar/index.ts

@@ -1,10 +1,39 @@
 export {
+  /**
+   * @deprecated Use `useMessageRuntime().copy()` instead. This will be removed in 0.6.
+   */
   useActionBarCopy,
+  /**
+   * @deprecated Use `useMessageRuntime().copy()` instead. This will be removed in 0.6.
+   */
   type UseActionBarCopyProps,
 } from "./useActionBarCopy";
+/**
+ * @deprecated Use `useMessageRuntime().composer.beginEdit()` instead. This will be removed in 0.6.
+ */
 export { useActionBarEdit } from "./useActionBarEdit";
+
+/**
+ * @deprecated Use `useMessageRuntime().reload()` instead. This will be removed in 0.6.
+ */
 export { useActionBarReload } from "./useActionBarReload";
+
+/**
+ * @deprecated Use `useMessageRuntime().speak()` instead. This will be removed in 0.6.
+ */
 export { useActionBarSpeak } from "./useActionBarSpeak";
+
+/**
+ * @deprecated Use `useMessageRuntime().stopSpeaking()` instead. This will be removed in 0.6.
+ */
 export { useActionBarStopSpeaking } from "./useActionBarStopSpeaking";
+
+/**
+ * @deprecated Use `useMessageRuntime().submitFeedback()` instead. This will be removed in 0.6.
+ */
 export { useActionBarFeedbackPositive } from "./useActionBarFeedbackPositive";
+
+/**
+ * @deprecated Use `useMessageRuntime().submitFeedback()` instead. This will be removed in 0.6.
+ */
 export { useActionBarFeedbackNegative } from "./useActionBarFeedbackNegative";

packages/react/src/primitive-hooks/branchPicker/index.ts

@@ -1,4 +1,18 @@
+/**
+ * @deprecated Use `useMessage(m => m.branhcCount)` instead. This will be removed in 0.6.
+ */
 export { useBranchPickerCount } from "./useBranchPickerCount";
+
+/**
+ * @deprecated Use `useMessageRuntime().switchToBranch({ position: "next" })` instead. This will be removed in 0.6.
+ */
 export { useBranchPickerNext } from "./useBranchPickerNext";
+/**
+ * @deprecated Use `useMessage(m => m.branchNumber)` instead. This will be removed in 0.6.
+ */
 export { useBranchPickerNumber } from "./useBranchPickerNumber";
+
+/**
+ * @deprecated Use `useMessageRuntime().switchToBranch({ position: "previous" })` instead. This will be removed in 0.6.
+ */
 export { useBranchPickerPrevious } from "./useBranchPickerPrevious";

packages/react/src/primitive-hooks/branchPicker/useBranchPickerNext.tsx

@@ -1,16 +1,12 @@
 import { useCallback } from "react";
-import { useCombinedStore } from "../../utils/combined/useCombinedStore";
-import { useEditComposerStore, useMessageStore } from "../../context";
-import { useMessageRuntime } from "../../context/react/MessageContext";
+import {
+  useMessage,
+  useMessageRuntime,
+} from "../../context/react/MessageContext";
 
 export const useBranchPickerNext = () => {
   const messageRuntime = useMessageRuntime();
-  const messageStore = useMessageStore();
-  const editComposerStore = useEditComposerStore();
-  const disabled = useCombinedStore(
-    [messageStore, editComposerStore],
-    (m, c) => c.isEditing || m.branchNumber >= m.branchCount,
-  );
+  const disabled = useMessage((m) => m.branchNumber >= m.branchCount);
 
   const callback = useCallback(() => {
     messageRuntime.switchToBranch({ position: "next" });

packages/react/src/primitive-hooks/branchPicker/useBranchPickerPrevious.tsx

@@ -1,19 +1,12 @@
 import { useCallback } from "react";
 import {
-  useEditComposerStore,
+  useMessage,
   useMessageRuntime,
-  useMessageStore,
 } from "../../context/react/MessageContext";
-import { useCombinedStore } from "../../utils/combined/useCombinedStore";
 
 export const useBranchPickerPrevious = () => {
   const messageRuntime = useMessageRuntime();
-  const messageStore = useMessageStore();
-  const editComposerStore = useEditComposerStore();
-  const disabled = useCombinedStore(
-    [messageStore, editComposerStore],
-    (m, c) => c.isEditing || m.branchNumber <= 1,
-  );
+  const disabled = useMessage((m) => m.branchNumber <= 1);
 
   const callback = useCallback(() => {
     messageRuntime.switchToBranch({ position: "previous" });

packages/react/src/primitive-hooks/composer/index.ts

@@ -1,4 +1,14 @@
+/**
+ * @deprecated Use `useComposerRuntime().cancel()` instead. This will be removed in 0.6.
+ */
 export { useComposerCancel } from "./useComposerCancel";
 export { useComposerIf } from "./useComposerIf";
+/**
+ * @deprecated Use `useComposerRuntime().send()` instead. This will be removed in 0.6.
+ */
 export { useComposerSend } from "./useComposerSend";
+
+/**
+ * @deprecated Use `useComposerRuntime().addAttachment()` instead. This will be removed in 0.6.
+ */
 export { useComposerAddAttachment } from "./useComposerAddAttachment";

packages/react/src/primitive-hooks/thread/index.ts

@@ -1,4 +1,10 @@
 export { useThreadEmpty } from "./useThreadEmpty";
 export { useThreadIf } from "./useThreadIf";
+/**
+ * @deprecated Use `useThreadViewport().scrollToBottom()` instead. This will be removed in 0.6.
+ */
 export { useThreadScrollToBottom } from "./useThreadScrollToBottom";
+/**
+ * @deprecated Use `useThreadRuntime().append()` instead. This will be removed in 0.6.
+ */
 export { useThreadSuggestion } from "./useThreadSuggestion";