feat: ComposerPrimitive.Attachments (#767)

.changeset/seven-rings-call.md

@@ -0,0 +1,5 @@
+---
+"@assistant-ui/react": patch
+---
+
+feat: AttachmentContext

.changeset/swift-lemons-enjoy.md

@@ -0,0 +1,5 @@
+---
+"@assistant-ui/react": patch
+---
+
+feat: ComposerPrimitive.Attachments

apps/docs/components/docs/parameters/context.tsx

@@ -521,3 +521,27 @@ export const MessageUtilsState: ParametersTableProps = {
     },
   ],
 };
+
+export const AttachmentContextValue: ParametersTableProps = {
+  type: "AttachmentContextValue",
+  parameters: [
+    {
+      name: "useAttachment",
+      type: "ReadonlyStore<AttachmentState>",
+      required: true,
+      description: "Provides functions to perform actions on the attachment.",
+    },
+  ],
+};
+
+export const AttachmentState: ParametersTableProps = {
+  type: "AttachmentState",
+  parameters: [
+    {
+      name: "attachment",
+      type: "Attachment",
+      required: true,
+      description: "The current attachment.",
+    },
+  ],
+};

apps/docs/content/docs/reference/context.mdx

@@ -27,6 +27,8 @@ import {
   ContentPartState,
   MessageState,
   MessageUtilsState,
+  AttachmentContextValue,
+  AttachmentState,
 } from "@/components/docs/parameters/context";
 
 ## Assistant Context
@@ -352,3 +354,30 @@ const value = useComposer.getState().value;
 const setText = useComposer((m) => m.setText);
 const setText = useComposer.getState().setText;
 ```
+
+## Attachment Context
+
+Provides access to the current attachment state.
+
+### `useAttachmentContext`
+
+This hook provides access to the context stores.
+
+```tsx
+import { useAttachmentContext } from "@assistant-ui/react";
+
+const { useAttachment } = useAttachmentContext();
+```
+
+<ParametersTable {...AttachmentContextValue} />
+
+### `useAttachment`
+
+```tsx
+const { useAttachment } = useAttachmentContext();
+
+const attachment = useAttachment((m) => m.attachment);
+const attachment = useAttachment.getState().attachment;
+```
+
+<ParametersTable {...AttachmentState} />