veryfront 0.1.1239 → 0.1.1241

package/esm/src/react/components/chat/chat/components/attachments-panel.d.ts

@@ -115,9 +115,9 @@ export interface AttachmentsPanelItemProps {
     className?: string;
     /**
      * Compose the row from the `AttachmentsPanel.Item.*` leaves (`.Icon` /
-     * `.Preview` / `.Remove`), the `AttachmentPill.*` parts (e.g. `.Label`), or
-     * your own text read from `useAttachmentPill()`. Omit for the default card
-     * (media + label + overflow menu).
+     * `.Preview` / `.Name` / `.Size` / `.Remove`), the `AttachmentPill.*` parts
+     * (e.g. `.Label`), or your own text read from `useAttachmentPill()`. Omit for
+     * the default card (media + label + overflow menu).
      */
     children?: React.ReactNode;
     /** React 19: ref is a regular prop (threaded to the underlying `AttachmentPill`). */
@@ -151,6 +151,28 @@ declare function AttachmentsPanelItemPreview({ className, ref, ...props }: React
 declare namespace AttachmentsPanelItemPreview {
     var displayName: string;
 }
+/**
+ * `AttachmentsPanel.Item.Name` — the file-name line. Deliberately plain text:
+ * unlike `AttachmentPill.Label`, it does not wrap the name in a shimmer while
+ * the attachment uploads. Compose `AttachmentPill.Label` for that treatment.
+ */
+declare function AttachmentsPanelItemName({ className, ref, ...props }: React.HTMLAttributes<HTMLParagraphElement> & {
+    ref?: React.Ref<HTMLParagraphElement>;
+}): React.JSX.Element;
+declare namespace AttachmentsPanelItemName {
+    var displayName: string;
+}
+/**
+ * `AttachmentsPanel.Item.Size` — the human-formatted byte label (`formatSize`).
+ * Renders nothing when the file has no size. Always the faint secondary color;
+ * the error/destructive state line stays with `AttachmentPill.Label`.
+ */
+declare function AttachmentsPanelItemSize({ className, ref, ...props }: React.HTMLAttributes<HTMLParagraphElement> & {
+    ref?: React.Ref<HTMLParagraphElement>;
+}): React.JSX.Element | null;
+declare namespace AttachmentsPanelItemSize {
+    var displayName: string;
+}
 /** Props for `AttachmentsPanel.Item.Remove`. */
 export interface AttachmentsPanelItemRemoveProps {
     className?: string;
@@ -233,6 +255,8 @@ export declare const AttachmentsPanel: typeof AttachmentsPanelRoot & {
     Item: typeof AttachmentsPanelItem & {
         Icon: typeof AttachmentsPanelItemIcon;
         Preview: typeof AttachmentsPanelItemPreview;
+        Name: typeof AttachmentsPanelItemName;
+        Size: typeof AttachmentsPanelItemSize;
         Remove: typeof AttachmentsPanelItemRemove;
     };
     Loading: typeof AttachmentsPanelLoading;

package/esm/src/react/components/chat/chat/components/attachments-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachments-panel.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/components/attachments-panel.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"attachments-panel.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/components/attachments-panel.tsx"],"names":[],"mappings":"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"}

package/esm/src/react/components/chat/chat/components/attachments-panel.js

@@ -5,7 +5,7 @@ import { FileTextIcon, MoreHorizontalIcon, PaperclipIcon, TrashIcon, XIcon, } fr
 import { Button } from "../../../ui/button.js";
 import { Skeleton } from "../../../ui/skeleton.js";
 import { DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuTrigger, } from "../../../ui/dropdown-menu.js";
-import { AttachmentPill, useAttachmentPill } from "./attachment-pill.js";
+import { AttachmentPill, formatSize, useAttachmentPill } from "./attachment-pill.js";
 import { createStrictContext } from "../../../create-strict-context.js";
 import { isSafeUploadUrl, openSafeUploadUrl } from "../upload-url.js";
 const [AttachmentsPanelContext, useAttachmentsPanelContext] = createStrictContext("useAttachmentsPanel", "an AttachmentsPanel");
@@ -119,12 +119,10 @@ function AttachmentsPanelItemMedia({ className }) {
         : React.createElement(AttachmentPill.Icon, { className: className });
 }
 // ---------------------------------------------------------------------------
-// AttachmentsPanel.Item.* — the row leaves that carry attachment-domain logic:
-// `.Icon` / `.Preview` (derived pill state) and `.Remove` (bound to the panel's
-// `onRemoveUpload`). Each reads the item's file from the enclosing
-// `AttachmentPill` context. Plain text (name / size) has no such logic — read it
-// from `useAttachmentPill()` / `useAttachments()` and render your own, or use
-// `AttachmentPill.Label`. Use these inside an `AttachmentsPanel.Item`.
+// AttachmentsPanel.Item.* — the row leaves: `.Icon` / `.Preview` (derived pill
+// state), `.Name` / `.Size` (the file's text lines), and `.Remove` (bound to
+// the panel's `onRemoveUpload`). Each reads the item's file from the enclosing
+// `AttachmentPill` context. Use these inside an `AttachmentsPanel.Item`.
 // ---------------------------------------------------------------------------
 /** `AttachmentsPanel.Item.Icon` — the file-type icon square. */
 function AttachmentsPanelItemIcon({ className, ref, ...props }) {
@@ -142,6 +140,28 @@ function AttachmentsPanelItemPreview({ className, ref, ...props }) {
     return React.createElement(AttachmentPill.Thumbnail, { ref: ref, className: className, ...props });
 }
 AttachmentsPanelItemPreview.displayName = "AttachmentsPanel.Item.Preview";
+/**
+ * `AttachmentsPanel.Item.Name` — the file-name line. Deliberately plain text:
+ * unlike `AttachmentPill.Label`, it does not wrap the name in a shimmer while
+ * the attachment uploads. Compose `AttachmentPill.Label` for that treatment.
+ */
+function AttachmentsPanelItemName({ className, ref, ...props }) {
+    const { attachment } = useAttachmentPill();
+    return (React.createElement("p", { ref: ref, className: cn("truncate text-sm font-medium leading-tight", className), ...props }, attachment.name || "Attachment"));
+}
+AttachmentsPanelItemName.displayName = "AttachmentsPanel.Item.Name";
+/**
+ * `AttachmentsPanel.Item.Size` — the human-formatted byte label (`formatSize`).
+ * Renders nothing when the file has no size. Always the faint secondary color;
+ * the error/destructive state line stays with `AttachmentPill.Label`.
+ */
+function AttachmentsPanelItemSize({ className, ref, ...props }) {
+    const { attachment } = useAttachmentPill();
+    if (attachment.size == null)
+        return null;
+    return (React.createElement("p", { ref: ref, className: cn("truncate text-xs leading-tight text-[var(--faint)]", className), ...props }, formatSize(attachment.size)));
+}
+AttachmentsPanelItemSize.displayName = "AttachmentsPanel.Item.Size";
 /**
  * `AttachmentsPanel.Item.Remove` — the delete control, wired to the panel's
  * `onRemoveUpload` for this item. Renders nothing when no remove handler is set.
@@ -158,6 +178,8 @@ AttachmentsPanelItemRemove.displayName = "AttachmentsPanel.Item.Remove";
 const AttachmentsPanelItemCompound = Object.assign(AttachmentsPanelItem, {
     Icon: AttachmentsPanelItemIcon,
     Preview: AttachmentsPanelItemPreview,
+    Name: AttachmentsPanelItemName,
+    Size: AttachmentsPanelItemSize,
     Remove: AttachmentsPanelItemRemove,
 });
 AttachmentsPanelItem.displayName = "AttachmentsPanel.Item";

package/esm/src/react/components/chat/chat/components/sidebar.d.ts

@@ -38,8 +38,8 @@
  * @module react/components/chat/chat/components/sidebar
  */
 import * as React from "react";
-import type { ChatSidebarEmptyProps, ChatSidebarGroupProps, ChatSidebarItemActionProps, ChatSidebarItemContextValue, ChatSidebarItemMenuProps, ChatSidebarItemProps, ChatSidebarListProps, ChatSidebarNewButtonProps, ChatSidebarProps, ChatSidebarRootProps } from "./sidebar.types.js";
-export type { ChatSidebarEmptyProps, ChatSidebarGroupProps, ChatSidebarItemActionProps, ChatSidebarItemContextValue, ChatSidebarItemMenuProps, ChatSidebarItemProps, ChatSidebarItemRenderOptions, ChatSidebarListProps, ChatSidebarNewButtonProps, ChatSidebarProps, ChatSidebarRootProps, } from "./sidebar.types.js";
+import type { ChatSidebarEmptyProps, ChatSidebarGroupProps, ChatSidebarItemActionProps, ChatSidebarItemContextValue, ChatSidebarItemMenuProps, ChatSidebarItemProps, ChatSidebarItemTitleProps, ChatSidebarListProps, ChatSidebarNewButtonProps, ChatSidebarProps, ChatSidebarRootProps } from "./sidebar.types.js";
+export type { ChatSidebarEmptyProps, ChatSidebarGroupProps, ChatSidebarItemActionProps, ChatSidebarItemContextValue, ChatSidebarItemMenuProps, ChatSidebarItemProps, ChatSidebarItemRenderOptions, ChatSidebarItemTitleProps, ChatSidebarListProps, ChatSidebarNewButtonProps, ChatSidebarProps, ChatSidebarRootProps, } from "./sidebar.types.js";
 /** Context provider + outer rail container for the compound sidebar. */
 export declare function ChatSidebarRoot(props: ChatSidebarRootProps): React.ReactElement | null;
 export declare namespace ChatSidebarRoot {
@@ -65,9 +65,17 @@ export declare namespace ChatSidebarNewButton {
  */
 export declare const useChatSidebarItem: () => ChatSidebarItemContextValue;
 /**
- * A single conversation row — select on click, rename/delete via a "…" menu.
- * The menu is a composable compound: pass a `<ChatSidebar.Item.Menu>` child to
- * add or reorder entries without re-implementing the row.
+ * The row's label: the conversation title (or custom children). Use it inside
+ * an `<ChatSidebar.Item>` to compose the row body and skip its default title.
+ */
+export declare function ChatSidebarItemTitle({ children, className, ref, ...props }: ChatSidebarItemTitleProps): React.ReactElement;
+export declare namespace ChatSidebarItemTitle {
+    var displayName: string;
+}
+/**
+ * A single conversation row with selection, rename, and delete behavior.
+ * A `<ChatSidebar.Item.Menu>` fills the action slot. A Title child composes the
+ * row label, with fragment-grouped leaves treated as direct children.
  */
 export declare function ChatSidebarItem({ conversation, className, children, ref, }: ChatSidebarItemProps): React.ReactElement;
 export declare namespace ChatSidebarItem {
@@ -113,8 +121,9 @@ declare function ChatSidebarBase(props: ChatSidebarProps): React.ReactElement |
 declare namespace ChatSidebarBase {
     var displayName: string;
 }
-/** `ChatSidebar.Item` compound — the row plus its composable menu leaves. */
+/** `ChatSidebar.Item` compound: the row plus its composable label and menu leaves. */
 export type ChatSidebarItemComponent = typeof ChatSidebarItem & {
+    Title: typeof ChatSidebarItemTitle;
     Menu: typeof ChatSidebarItemMenu;
     Rename: typeof ChatSidebarItemRename;
     Delete: typeof ChatSidebarItemDelete;

package/esm/src/react/components/chat/chat/components/sidebar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/components/sidebar.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/components/sidebar.tsx"],"names":[],"mappings":"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"}

package/esm/src/react/components/chat/chat/components/sidebar.js

@@ -169,9 +169,30 @@ const [ChatSidebarItemContext, useChatSidebarItemStrict] = createStrictContext("
  */
 export const useChatSidebarItem = useChatSidebarItemStrict;
 /**
- * A single conversation row — select on click, rename/delete via a "…" menu.
- * The menu is a composable compound: pass a `<ChatSidebar.Item.Menu>` child to
- * add or reorder entries without re-implementing the row.
+ * The row's label: the conversation title (or custom children). Use it inside
+ * an `<ChatSidebar.Item>` to compose the row body and skip its default title.
+ */
+export function ChatSidebarItemTitle({ children, className, ref, ...props }) {
+    const { conversation } = useChatSidebarItem();
+    return (React.createElement("span", { ...props, ref: ref, className: cn("block min-w-0 flex-1 truncate text-[13px] leading-snug", className) }, children ?? conversation.title));
+}
+ChatSidebarItemTitle.displayName = "ChatSidebar.Item.Title";
+function flattenItemParts(children, parentKey = "") {
+    return React.Children.toArray(children).flatMap((child) => {
+        if (!React.isValidElement(child))
+            return child;
+        const childKey = String(child.key);
+        const itemKey = `${parentKey}${childKey.length}:${childKey}`;
+        if (child.type !== React.Fragment)
+            return React.cloneElement(child, { key: itemKey });
+        const props = child.props;
+        return flattenItemParts(props.children, itemKey);
+    });
+}
+/**
+ * A single conversation row with selection, rename, and delete behavior.
+ * A `<ChatSidebar.Item.Menu>` fills the action slot. A Title child composes the
+ * row label, with fragment-grouped leaves treated as direct children.
  */
 export function ChatSidebarItem({ conversation, className, children, ref, }) {
     const { activeId, onSelect, onDelete, onRename } = useChatSidebarContext();
@@ -204,8 +225,19 @@ export function ChatSidebarItem({ conversation, className, children, ref, }) {
     if (editing) {
         return (React.createElement(ChatSidebarRenameEditor, { ref: ref, className: className, value: editValue, onChange: setEditValue, onCommit: commitRename, onCancel: () => setEditing(false) }));
     }
+    // A Title child moves children into the row body; otherwise they compose the action slot.
+    // Transparent fragments keep title and menu partitioning consistent without duplication.
+    const parts = flattenItemParts(children);
+    const composesTitle = parts.some((part) => React.isValidElement(part) && part.type === ChatSidebarItemTitle);
+    const menuParts = parts.filter((part) => React.isValidElement(part) && part.type === ChatSidebarItemMenu);
+    const bodyParts = parts.filter((part) => !menuParts.includes(part));
     return (React.createElement(ChatSidebarItemContext.Provider, { value: itemContext },
-        React.createElement(ListItem, { ref: ref, title: conversation.title, active: isActive || menuOpen, className: className, onActivate: () => onSelect(conversation.id), primaryActionProps: { "aria-current": isActive ? "page" : undefined }, action: children ?? React.createElement(ChatSidebarItemMenu, null) })));
+        React.createElement(ListItem, { ref: ref, title: composesTitle ? undefined : conversation.title, active: isActive || menuOpen, className: className, onActivate: () => onSelect(conversation.id), primaryActionProps: {
+                "aria-current": isActive ? "page" : undefined,
+                className: composesTitle ? "flex items-center gap-1" : undefined,
+            }, action: composesTitle
+                ? (menuParts.length > 0 ? menuParts : React.createElement(ChatSidebarItemMenu, null))
+                : children ?? React.createElement(ChatSidebarItemMenu, null) }, composesTitle ? bodyParts : undefined)));
 }
 ChatSidebarItem.displayName = "ChatSidebar.Item";
 /** The row's `…` dropdown. Reads row state from {@link useChatSidebarItem}. */
@@ -323,6 +355,7 @@ function ChatSidebarBase(props) {
 }
 ChatSidebarBase.displayName = "ChatSidebar";
 const ChatSidebarItemCompound = Object.assign(ChatSidebarItem, {
+    Title: ChatSidebarItemTitle,
     Menu: ChatSidebarItemMenu,
     Rename: ChatSidebarItemRename,
     Delete: ChatSidebarItemDelete,

package/esm/src/react/components/chat/chat/components/sidebar.types.d.ts

@@ -80,12 +80,23 @@ export interface ChatSidebarItemProps {
     className?: string;
     /**
      * Compose the row's action slot, typically a `<ChatSidebar.Item.Menu>`.
-     * Omit for the default `…` rename/delete menu.
+     * When the children include a `<ChatSidebar.Item.Title>`, they compose the
+     * row's label body instead; a sibling `<ChatSidebar.Item.Menu>` still fills
+     * the action slot when it is direct or grouped in a fragment (the default
+     * `…` menu is used when none is given). Omit for the default title + `…`
+     * rename/delete menu.
      */
     children?: React.ReactNode;
     /** React 19: ref is attached to the current row root in display and rename modes. */
     ref?: React.Ref<HTMLDivElement>;
 }
+/** Props for {@link ChatSidebarItemTitle}. */
+export interface ChatSidebarItemTitleProps extends React.HTMLAttributes<HTMLSpanElement> {
+    /** Override the label. Defaults to the conversation title. */
+    children?: React.ReactNode;
+    /** React 19: ref is a regular prop. */
+    ref?: React.Ref<HTMLSpanElement>;
+}
 /** Props for {@link ChatSidebarItemMenu}. */
 export interface ChatSidebarItemMenuProps {
     /** Override the trigger glyph. */

package/esm/src/react/components/chat/chat/components/sidebar.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidebar.types.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/components/sidebar.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sidebar.types.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/components/sidebar.types.ts"],"names":[],"mappings":"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"}

package/esm/src/react/components/chat/chat/composition/chat-composer.d.ts

@@ -41,7 +41,9 @@ export declare namespace ChatInputToolbar {
  * `ChatInput.Root` — the provider shell for a fully custom composer. Supplies
  * `ChatInputContext` from props and renders your children, so you arrange
  * `ChatInput.Field` + the toolbar sub-parts yourself (like `Message.Root`). The
- * default `<ChatInput>` is exactly this Root plus the standard body.
+ * default `<ChatInput>` is exactly this Root plus the standard body. Omitted
+ * props fall back to the surrounding `ChatContext` (`<Chat.Root chat={…}>`),
+ * so a propless Root wires itself to the shared session; explicit props win.
  */
 export declare function ChatInputRoot({ className, children, ref, ...state }: ChatInputRootProps): React.ReactElement;
 export declare namespace ChatInputRoot {

package/esm/src/react/components/chat/chat/composition/chat-composer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-composer.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/composition/chat-composer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,mBAAmB,0BAA0B,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;AAM1F,iCAAiC;AACjC,wBAAgB,cAAc,CAC5B,EAAE,WAAiC,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,GACnF,KAAK,CAAC,YAAY,CAqBpB;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAC5B,EAAE,SAAS,EAAE,EAAE,mBAAmB,GACjC,KAAK,CAAC,YAAY,GAAG,IAAI,CAa3B;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAC7B,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,oBAAoB,GAChE,KAAK,CAAC,YAAY,GAAG,IAAI,CAmB3B;yBArBe,eAAe;;;AAwB/B;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,qBAAqB,GAC5D,KAAK,CAAC,YAAY,CAWpB;yBAbe,gBAAgB;;;AAoBhC;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,GACzD,KAAK,CAAC,YAAY,CAepB;yBAjBe,aAAa;;;AAoB7B,2BAA2B;AAC3B,iBAAS,aAAa,CACpB,EACE,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,SAAiB,EACjB,WAAiC,EACjC,KAAK,EACL,IAAI,EACJ,OAAO,EACP,WAAmB,EACnB,UAAU,EACV,MAAM,EACN,KAAK,EACL,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,kBAAkB,EAClB,MAAM,EACN,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,QAAQ,EACR,GAAG,GACJ,EAAE,cAAc,GAChB,KAAK,CAAC,YAAY,CA0HpB;kBAtJQ,aAAa;;;AAyJtB;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;CAWpB,CAAC"}
+{"version":3,"file":"chat-composer.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/composition/chat-composer.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAa/B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,EAClB,qBAAqB,EACtB,MAAM,0BAA0B,CAAC;AAElC,mBAAmB,0BAA0B,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC;AAM1F,iCAAiC;AACjC,wBAAgB,cAAc,CAC5B,EAAE,WAAiC,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,mBAAmB,GACnF,KAAK,CAAC,YAAY,CAqBpB;AAED,yDAAyD;AACzD,wBAAgB,cAAc,CAC5B,EAAE,SAAS,EAAE,EAAE,mBAAmB,GACjC,KAAK,CAAC,YAAY,GAAG,IAAI,CAa3B;AAED,sDAAsD;AACtD,wBAAgB,eAAe,CAC7B,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,oBAAoB,GAChE,KAAK,CAAC,YAAY,GAAG,IAAI,CAmB3B;yBArBe,eAAe;;;AAwB/B;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,qBAAqB,GAC5D,KAAK,CAAC,YAAY,CAWpB;yBAbe,gBAAgB;;;AAoBhC;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,EAAE,kBAAkB,GACzD,KAAK,CAAC,YAAY,CAepB;yBAjBe,aAAa;;;AAoB7B,2BAA2B;AAC3B,iBAAS,aAAa,CACpB,EACE,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,QAAQ,EAIR,SAAS,EACT,WAAiC,EACjC,KAAK,EACL,IAAI,EACJ,OAAO,EACP,WAAmB,EACnB,UAAU,EACV,MAAM,EACN,KAAK,EACL,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,kBAAkB,EAClB,MAAM,EACN,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,SAAS,EACT,QAAQ,EACR,GAAG,GACJ,EAAE,cAAc,GAChB,KAAK,CAAC,YAAY,CA+HpB;kBA9JQ,aAAa;;;AAiKtB;;;GAGG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;CAWpB,CAAC"}

package/esm/src/react/components/chat/chat/composition/chat-composer.js

@@ -71,11 +71,13 @@ ChatInputToolbar.displayName = "ChatInput.Toolbar";
  * `ChatInput.Root` — the provider shell for a fully custom composer. Supplies
  * `ChatInputContext` from props and renders your children, so you arrange
  * `ChatInput.Field` + the toolbar sub-parts yourself (like `Message.Root`). The
- * default `<ChatInput>` is exactly this Root plus the standard body.
+ * default `<ChatInput>` is exactly this Root plus the standard body. Omitted
+ * props fall back to the surrounding `ChatContext` (`<Chat.Root chat={…}>`),
+ * so a propless Root wires itself to the shared session; explicit props win.
  */
 export function ChatInputRoot({ className, children, ref, ...state }) {
     const baseCtxValue = useComposerValue(state);
-    const { contextValue, fileInput } = useChatInputAttachmentPicker(baseCtxValue, state.onAttach, state.attachAccept);
+    const { contextValue, fileInput } = useChatInputAttachmentPicker(baseCtxValue, baseCtxValue.onAttach, state.attachAccept);
     return (React.createElement(ChatInputContextProvider, { value: contextValue },
         React.createElement("div", { ref: ref, className: cn("flex-shrink-0 pb-6 pt-2", className) },
             fileInput,
@@ -83,7 +85,11 @@ export function ChatInputRoot({ className, children, ref, ...state }) {
 }
 ChatInputRoot.displayName = "ChatInput.Root";
 /** Render the composer. */
-function ChatInputBase({ input, onChange, setInput, onSubmit, isLoading = false, placeholder = "Type a message...", theme, stop, onVoice, isListening = false, transcript, models, model, onModelChange, toolbarStart, onAttach, onSelectAttachment, onDrop, attachAccept, attachments, onRemoveAttachment, onAttachClick, className, children, ref, }) {
+function ChatInputBase({ input, onChange, setInput, onSubmit, 
+// No `= false` default: an omitted `isLoading` must stay `undefined` so
+// `useComposerValue` can inherit the surrounding session's loading state
+// (a default would always win over the context and hide Stop mid-turn).
+isLoading, placeholder = "Type a message...", theme, stop, onVoice, isListening = false, transcript, models, model, onModelChange, toolbarStart, onAttach, onSelectAttachment, onDrop, attachAccept, attachments, onRemoveAttachment, onAttachClick, className, children, ref, }) {
     {
         // Return focus to the editor after attaching (menu pick or drop) so the
         // user can keep typing without clicking back into the field.
@@ -98,7 +104,6 @@ function ChatInputBase({ input, onChange, setInput, onSubmit, isLoading = false,
             }
             : undefined, [focusField]);
         const handleAttach = withFocus(onAttach);
-        const { isDragActive, onDragEnter, onDragLeave, onDragOver, onDrop: onFileDrop, } = useDropZone(withFocus(onDrop ?? onAttach));
         const baseCtxValue = useComposerValue({
             input,
             onChange,
@@ -118,7 +123,13 @@ function ChatInputBase({ input, onChange, setInput, onSubmit, isLoading = false,
             attachments,
             onRemoveAttachment,
         });
-        const { contextValue, fileInput } = useChatInputAttachmentPicker(baseCtxValue, handleAttach, attachAccept);
+        // Attach + drop fall back to the context-resolved handler (like
+        // `ChatInput.Root`), so a propless composer inside `<Chat.Root chat={…}>`
+        // keeps a working picker and drop zone. Both explicit and inherited
+        // handlers restore field focus after a selection.
+        const resolvedAttach = handleAttach ?? withFocus(baseCtxValue.onAttach);
+        const { isDragActive, onDragEnter, onDragLeave, onDragOver, onDrop: onFileDrop, } = useDropZone(withFocus(onDrop) ?? resolvedAttach);
+        const { contextValue, fileInput } = useChatInputAttachmentPicker(baseCtxValue, resolvedAttach, attachAccept);
         return (React.createElement(ChatInputContextProvider, { value: contextValue },
             React.createElement("div", { ref: ref, className: cn("flex-shrink-0 pb-6", className) },
                 fileInput,
@@ -127,7 +138,7 @@ function ChatInputBase({ input, onChange, setInput, onSubmit, isLoading = false,
                     React.createElement(ChatInputForm, { onSubmit: contextValue.onSubmit },
                         React.createElement("div", { onDragEnter: onDragEnter, onDragLeave: onDragLeave, onDragOver: onDragOver, onDrop: onFileDrop, ref: fieldContainerRef, className: cn("relative overflow-hidden rounded-[var(--radius-lg)] border border-transparent bg-[var(--secondary)] px-3 py-2 shadow-sm transition-all md:px-4 md:py-3", isDragActive && "border-dashed border-[var(--edge-medium)]") },
                             React.createElement(DropZoneOverlay, { visible: isDragActive }),
-                            attachments && attachments.length > 0 && (React.createElement("div", { className: "mb-2.5 flex flex-wrap items-center gap-2" }, attachments.map((file) => (React.createElement(AttachmentPill, { key: file.id, attachment: file, onRemove: onRemoveAttachment, className: "w-[200px]" }))))),
+                            contextValue.attachments.length > 0 && (React.createElement("div", { className: "mb-2.5 flex flex-wrap items-center gap-2" }, contextValue.attachments.map((file) => (React.createElement(AttachmentPill, { key: file.id, attachment: file, onRemove: contextValue.onRemoveAttachment, className: "w-[200px]" }))))),
                             React.createElement(ChatInputField, { placeholder: placeholder, className: theme?.input }),
                             React.createElement("div", { className: "mt-2.5 flex min-h-[44px] items-center justify-between gap-1.5 md:gap-2" },
                                 React.createElement("div", { className: "flex min-w-0 items-center gap-1.5 md:gap-2" },

package/esm/src/react/components/chat/chat/composition/chat-composer.types.d.ts

@@ -105,12 +105,19 @@ export interface ChatInputToolbarProps extends React.HTMLAttributes<HTMLDivEleme
     /** React 19: ref is a regular prop. */
     ref?: React.Ref<HTMLDivElement>;
 }
-/** Props accepted by `ChatInput`. */
+/**
+ * Props accepted by `ChatInput`.
+ *
+ * Every prop is optional: omitted state falls back to the surrounding
+ * `ChatContext` (`<Chat.Root chat={…}>`), so a propless `<ChatInput />` wires
+ * itself to the shared session. Explicit props always win, and a standalone
+ * composer outside a `<Chat.Root>` still supplies its own `input`/`onChange`.
+ */
 export interface ChatInputProps {
-    /** Current text value of the composer input (controlled). */
-    input: string;
-    /** Fired as the user edits the input. */
-    onChange: (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
+    /** Current text value of the composer input (controlled). Falls back to `ChatContext.input`. */
+    input?: string;
+    /** Fired as the user edits the input. Falls back to `ChatContext.setInput`. */
+    onChange?: (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement>) => void;
     /**
      * Update the controlled input value for headless consumers. The preset wires
      * this automatically. Direct consumers must provide it before calling

package/esm/src/react/components/chat/chat/composition/chat-composer.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-composer.types.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/composition/chat-composer.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat-composer.types.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/composition/chat-composer.types.ts"],"names":[],"mappings":"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"}

package/esm/src/react/components/chat/chat/composition/chat-root.d.ts

@@ -7,26 +7,39 @@
  * @module react/components/chat/composition/chat-root
  */
 import * as React from "react";
-import type { ChatMessage, ChatStatus } from "../../../../../agent/react/index.js";
+import type { ChatMessage, ChatStatus, UseChatResult } from "../../../../../agent/react/index.js";
 import type { ChatTheme } from "../../theme.js";
 import type { ModelOption } from "../../model-selector.js";
 import type { AttachmentInfo } from "../components/attachment-pill.js";
 import type { FeedbackValue } from "../components/message-feedback.js";
 import type { Source } from "../components/sources.js";
 import type { BranchInfo } from "../../../../../agent/react/index.js";
-/** Props accepted by chat root. */
+/**
+ * Props accepted by chat root.
+ *
+ * Supply either `chat` (a `useChat()` session) or the flat props
+ * (`messages`, `input`, `onSubmit`, …). Both are optional so the two modes can
+ * mix, but a `<Chat.Root>` given neither renders an empty chat whose
+ * `setInput`/`onSubmit` are inert no-ops.
+ */
 export interface ChatRootProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
     children: React.ReactNode;
     /** React 19: ref is a regular prop. */
     ref?: React.Ref<HTMLDivElement>;
-    messages: ChatMessage[];
+    /**
+     * Drive the chat surface from a `useChat()` session you own:
+     * `<Chat.Root chat={useChat()}>`. Folds the session state into the shared
+     * context; the flat props below stay as an explicit override path.
+     */
+    chat?: UseChatResult;
+    messages?: ChatMessage[];
     isLoading?: boolean;
     /** Streaming lifecycle of the current turn (`useChat().status`). */
     status?: ChatStatus;
     /** Id of the assistant message currently streaming (`useChat().streamingMessageId`). */
     streamingMessageId?: string | null;
     error?: Error | null;
-    input: string;
+    input?: string;
     setInput?: (value: string) => void;
     onSubmit?: (e?: React.FormEvent) => void | Promise<void>;
     onStop?: () => void;
@@ -50,7 +63,7 @@ export interface ChatRootProps extends Omit<React.HTMLAttributes<HTMLDivElement>
     maxHeight?: string;
 }
 /** Render chat root. */
-export declare function ChatRoot({ children, messages, isLoading, status, streamingMessageId, error, input, setInput, onSubmit, onStop, onReload, model, models, onModelChange, agent, attachments, onAttach, onRemoveAttachment, editMessage, getBranches, switchBranch, onFeedback, onSourceClick, theme: userTheme, maxHeight, className, style, ref, ...containerProps }: ChatRootProps): React.ReactElement;
+export declare function ChatRoot({ children, chat, messages: messagesProp, isLoading: isLoadingProp, status: statusProp, streamingMessageId: streamingMessageIdProp, error: errorProp, input: inputProp, setInput: setInputProp, onSubmit: onSubmitProp, onStop: onStopProp, onReload: onReloadProp, model: modelProp, models, onModelChange: onModelChangeProp, agent, attachments, onAttach, onRemoveAttachment, editMessage: editMessageProp, getBranches: getBranchesProp, switchBranch: switchBranchProp, onFeedback, onSourceClick, theme: userTheme, maxHeight, className, style, ref, ...containerProps }: ChatRootProps): React.ReactElement;
 export declare namespace ChatRoot {
     var displayName: string;
 }

package/esm/src/react/components/chat/chat/composition/chat-root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chat-root.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/composition/chat-root.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat-root.d.ts","sourceRoot":"","sources":["../../../../../../../src/src/react/components/chat/chat/composition/chat-root.tsx"],"names":[],"mappings":"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"}

package/esm/src/react/components/chat/chat/composition/chat-root.js

@@ -11,8 +11,69 @@ import { ChatContainer } from "../../../../primitives/index.js";
 import { useDocumentNonce } from "../../../ui/csp-nonce.js";
 import { cn, defaultChatTheme, generateTokenCSS, mergeThemes, UI_SCOPE_ATTRS, } from "../../theme.js";
 import { ChatContextProvider } from "../contexts/chat-context.js";
+import { attachmentsToFileParts, hasPendingAttachments } from "../chat-attachments.js";
 /** Render chat root. */
-export function ChatRoot({ children, messages, isLoading = false, status, streamingMessageId, error = null, input, setInput, onSubmit, onStop, onReload, model, models = [], onModelChange, agent, attachments = [], onAttach, onRemoveAttachment, editMessage, getBranches, switchBranch, onFeedback, onSourceClick, theme: userTheme, maxHeight = "100%", className, style, ref, ...containerProps }) {
+export function ChatRoot({ children, chat, messages: messagesProp, isLoading: isLoadingProp, status: statusProp, streamingMessageId: streamingMessageIdProp, error: errorProp, input: inputProp, setInput: setInputProp, onSubmit: onSubmitProp, onStop: onStopProp, onReload: onReloadProp, model: modelProp, models = [], onModelChange: onModelChangeProp, agent, attachments = [], onAttach, onRemoveAttachment, editMessage: editMessageProp, getBranches: getBranchesProp, switchBranch: switchBranchProp, onFeedback, onSourceClick, theme: userTheme, maxHeight = "100%", className, style, ref, ...containerProps }) {
+    // `chat` folds the session's flat state into the context; each explicit flat
+    // prop wins over the session value (issue #69's override path).
+    const messages = messagesProp ?? chat?.messages ?? [];
+    const isLoading = isLoadingProp ?? chat?.isLoading ?? false;
+    const status = statusProp ?? chat?.status;
+    // Nullable props compare against `undefined`, not nullish: `error={null}` and
+    // `streamingMessageId={null}` are explicit overrides that clear the session
+    // value, so `??` would wrongly restore it from `chat`.
+    const streamingMessageId = streamingMessageIdProp !== undefined
+        ? streamingMessageIdProp
+        : chat?.streamingMessageId;
+    const error = errorProp !== undefined ? errorProp : (chat?.error ?? null);
+    const input = inputProp ?? chat?.input ?? "";
+    const setInput = setInputProp ?? chat?.setInput;
+    const model = modelProp ?? chat?.model;
+    const hasFlatSubmitState = inputProp !== undefined || setInputProp !== undefined ||
+        isLoadingProp !== undefined || modelProp !== undefined;
+    const submitSession = React.useCallback((e) => {
+        if (!chat)
+            return;
+        if (hasPendingAttachments(attachments)) {
+            e?.preventDefault();
+            return;
+        }
+        const files = attachmentsToFileParts(attachments);
+        if (files.length === 0 && !hasFlatSubmitState)
+            return chat.handleSubmit(e);
+        e?.preventDefault();
+        if (isLoading)
+            return;
+        const text = input.trim();
+        if (!text && files.length === 0)
+            return;
+        setInput?.("");
+        for (const attachment of attachments) {
+            if (attachment.url)
+                onRemoveAttachment?.(attachment.id);
+        }
+        return chat.sendMessage({
+            text,
+            ...(files.length > 0 ? { files } : {}),
+            ...(model !== undefined ? { model } : {}),
+        });
+    }, [
+        attachments,
+        chat,
+        hasFlatSubmitState,
+        input,
+        isLoading,
+        model,
+        onRemoveAttachment,
+        setInput,
+    ]);
+    const onSubmit = onSubmitProp ?? (chat ? submitSession : undefined);
+    const onStop = onStopProp ?? chat?.stop;
+    const onReload = onReloadProp ?? chat?.reload;
+    const onModelChange = onModelChangeProp ?? chat?.setModel;
+    const editMessage = editMessageProp ?? chat?.editMessage;
+    const getBranches = getBranchesProp ?? chat?.getBranches;
+    const switchBranch = switchBranchProp ?? chat?.switchBranch;
     const theme = React.useMemo(() => mergeThemes(defaultChatTheme, userTheme), [userTheme]);
     const nonce = useDocumentNonce();
     const tokenCSS = React.useMemo(() => generateTokenCSS(), []);
@@ -33,6 +94,7 @@ export function ChatRoot({ children, messages, isLoading = false, status, stream
         input,
         setInput: setInput ?? (() => { }),
         onSubmit: onSubmit ?? (() => { }),
+        sendMessage: onSubmitProp === undefined ? chat?.sendMessage : undefined,
         onStop,
         onReload,
         model,
@@ -60,6 +122,8 @@ export function ChatRoot({ children, messages, isLoading = false, status, stream
         input,
         setInput,
         onSubmit,
+        chat?.sendMessage,
+        onSubmitProp,
         onStop,
         onReload,
         model,