@colletdev/docs 0.2.19 → 0.2.21

package/components.md

@@ -501,7 +501,7 @@ Import from `@colletdev/core/types`:
 
 Chat component.
 
-**Tag:** `<cx-chat>`  |  **Form:** no  |  **Slots:** header, footer  |  **Ref methods:** addMessage, scrollToBottom, clear, focus
+**Tag:** `<cx-chat>`  |  **Form:** no  |  **Slots:** header, footer  |  **Ref methods:** addMessage, addUserMessage, addAssistantMessage, addGroupMessage, addActivity, scrollToBottom, clear, focus, addFiles, clearAttachments
 
 #### Import
 
@@ -535,28 +535,48 @@ Chat component.
 | inputLabel | `string` | — |  |
 | submitLabel | `string` | — |  |
 | emptyState | `string` | — |  |
+| acceptFiles | `boolean` | `false` |  |
+| accept | `string` | — |  |
+| maxFileSize | `number` | `0` |  |
+| multipleFiles | `boolean` | `false` |  |
 
 #### Events
 
 | Event | React | Vue | Detail |
 |-------|-------|-----|--------|
 | `cx-submit` | `onSubmit` | `@cx-submit` | `ChatSubmitDetail` |
+| `cx-file-add` | `onFileAdd` | `@cx-file-add` | `FileAddDetail` |
+| `cx-file-remove` | `onFileRemove` | `@cx-file-remove` | `FileRemoveDetail` |
+| `cx-file-reject` | `onFileReject` | `@cx-file-reject` | `FileRejectDetail` |
 
 #### Ref Methods
 
 | Method | Description |
 |--------|-------------|
-| `addMessage(html: string): void` | Adds a pre-rendered message turn to the chat. |
+| `addMessage(html: string): void` | Adds a pre-rendered HTML turn to the chat (low-level). Prefer addUserMessage/addAssistantMessage. |
+| `addUserMessage(content: string, opts?: BubbleOptions): void` | Adds a user message. Renders via WASM automatically. |
+| `addAssistantMessage(content: string, opts?: BubbleOptions): void` | Adds an assistant message. Renders via WASM automatically. |
+| `addGroupMessage(role: "user" | "assistant", parts: GroupPart[], opts?: GroupOptions): void` | Adds a multi-part grouped message (text + code, etc.). |
+| `addActivity(opts?: ActivityOptions): void` | Adds a tool activity group (search, read, write, etc.). |
 | `scrollToBottom()` | Scrolls the message area to the bottom. |
 | `clear()` | Clears all messages from the chat. |
 | `focus()` | Focuses the chat input textarea. |
+| `addFiles(files: FileList): void` | Adds files programmatically to the chat input. |
+| `clearAttachments()` | Removes all file attachments from the chat input. |
 
 #### Structured Types
 
 Import from `@colletdev/core/types`:
 
+- `ActivityOptions`
+- `BubbleOptions`
 - `ChatSubmitDetail`
 - `ChatTurn`
+- `FileAddDetail`
+- `FileRejectDetail`
+- `FileRemoveDetail`
+- `GroupOptions`
+- `GroupPart`
 
 ---
 
@@ -564,7 +584,7 @@ Import from `@colletdev/core/types`:
 
 Multi-line text area optimized for chat message composition.
 
-**Tag:** `<cx-chat-input>`  |  **Form:** yes  |  **Ref methods:** focus
+**Tag:** `<cx-chat-input>`  |  **Form:** yes  |  **Ref methods:** focus, addFiles, getAttachments, clearAttachments
 
 #### Import
 
@@ -592,6 +612,10 @@ Multi-line text area optimized for chat message composition.
 | label | `string` | — |  |
 | maxLength | `number` | `0` |  |
 | slotted | `boolean` | `false` |  |
+| acceptFiles | `boolean` | `false` |  |
+| accept | `string` | — |  |
+| maxFileSize | `number` | `0` |  |
+| multipleFiles | `boolean` | `false` |  |
 
 #### Events
 
@@ -603,18 +627,28 @@ Multi-line text area optimized for chat message composition.
 | `cx-keyup` | `onKeyup` | `@cx-keyup` | `KeyboardDetail` |
 | `cx-submit` | `onSubmit` | `@cx-submit` | `ChatSubmitDetail` |
 | `cx-input` | `onInput` | `@cx-input` | `InputDetail` |
+| `cx-file-add` | `onFileAdd` | `@cx-file-add` | `FileAddDetail` |
+| `cx-file-remove` | `onFileRemove` | `@cx-file-remove` | `FileRemoveDetail` |
+| `cx-file-reject` | `onFileReject` | `@cx-file-reject` | `FileRejectDetail` |
 
 #### Ref Methods
 
 | Method | Description |
 |--------|-------------|
 | `focus()` | Focuses the textarea. |
+| `addFiles(files: FileList): void` | Adds files programmatically to the attachment tray. |
+| `getAttachments(): FileInfo[]` | Returns current attachments as FileInfo[]. |
+| `clearAttachments()` | Removes all file attachments. |
 
 #### Structured Types
 
 Import from `@colletdev/core/types`:
 
 - `ChatSubmitDetail`
+- `FileAddDetail`
+- `FileInfo`
+- `FileRejectDetail`
+- `FileRemoveDetail`
 - `FocusDetail`
 - `InputDetail`
 - `KeyboardDetail`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colletdev/docs",
-  "version": "0.2.19",
+  "version": "0.2.21",
   "description": "Collet component library documentation — API reference, framework guides, and AI agent setup",
   "type": "module",
   "bin": {