@tangle-network/sandbox-ui 0.104.1 → 0.105.0

package/dist/chat.d.ts

@@ -60,10 +60,9 @@ declare function ReasoningLevelPicker({ value, onChange, disabled, className, tr
 /**
  * Limits applied when staging files onto a composer.
  *
- * @deprecated Composer-only helper of the legacy AgentComposer. Use
- * ChatComposer from `@tangle-network/agent-app/web-react` — the canonical
- * composer. AgentComposer is frozen and will be removed at sandbox-ui's next
- * breaking release.
+ * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` stages files without a validation or
+ * retry step, so it has no equivalent.
  */
 interface ComposerFileValidationConfig {
     /** Reject any single file larger than this. */
@@ -81,10 +80,9 @@ interface ComposerFileValidationConfig {
 }
 /** A file that failed validation, paired with a human-readable reason.
  *
- * @deprecated Composer-only helper of the legacy AgentComposer. Use
- * ChatComposer from `@tangle-network/agent-app/web-react` — the canonical
- * composer. AgentComposer is frozen and will be removed at sandbox-ui's next
- * breaking release. */
+ * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` stages files without a validation or
+ * retry step, so it has no equivalent. */
 interface ComposerFileRejection {
     file: File;
     reason: string;
@@ -94,10 +92,9 @@ interface ComposerFileRejection {
  * grammar as the native `<input accept>` attribute. An undefined or empty
  * `accept` accepts everything.
  *
- * @deprecated Composer-only helper of the legacy AgentComposer. Use
- * ChatComposer from `@tangle-network/agent-app/web-react` — the canonical
- * composer. AgentComposer is frozen and will be removed at sandbox-ui's next
- * breaking release.
+ * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` stages files without a validation or
+ * retry step, so it has no equivalent.
  */
 declare function isAcceptedType(file: File, accept?: string): boolean;
 /**
@@ -107,10 +104,9 @@ declare function isAcceptedType(file: File, accept?: string): boolean;
  * file and the limit it broke. Pure data in, pure data out — no throwing,
  * no console noise, so callers decide how to surface rejections.
  *
- * @deprecated Composer-only helper of the legacy AgentComposer. Use
- * ChatComposer from `@tangle-network/agent-app/web-react` — the canonical
- * composer. AgentComposer is frozen and will be removed at sandbox-ui's next
- * breaking release.
+ * Serves {@link AgentComposer}'s attachment lifecycle. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` stages files without a validation or
+ * retry step, so it has no equivalent.
  */
 declare function validateComposerFiles(files: File[] | FileList, config: ComposerFileValidationConfig): {
     accepted: File[];
@@ -120,9 +116,9 @@ declare function validateComposerFiles(files: File[] | FileList, config: Compose
 /** A selectable item in the `@`-mention popover. Generic — file semantics live
  * in the consuming app, not here.
  *
- * @deprecated Part of the legacy AgentComposer API. Use ChatComposer from
- * `@tangle-network/agent-app/web-react` — the canonical composer. AgentComposer
- * is frozen and will be removed at sandbox-ui's next breaking release. */
+ * Part of the {@link AgentComposer} API. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` has no equivalent — see
+ * {@link AgentComposer} for which composer fits a surface. */
 interface MentionItem {
     id: string;
     label: string;
@@ -134,9 +130,9 @@ interface MentionItem {
  * TipTap rich input that renders mentions as atomic pills; absent ⇒ exactly
  * today's plain-textarea behavior. Data-agnostic: the app supplies items.
  *
- * @deprecated Part of the legacy AgentComposer API. Use ChatComposer from
- * `@tangle-network/agent-app/web-react` — the canonical composer. AgentComposer
- * is frozen and will be removed at sandbox-ui's next breaking release.
+ * Part of the {@link AgentComposer} API. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` has no equivalent — see
+ * {@link AgentComposer} for which composer fits a surface.
  */
 interface AgentComposerMention {
     /** The character that opens the popover. Default "@". */
@@ -159,9 +155,9 @@ interface AgentComposerMention {
 }
 /** A staged attachment shown as a chip above the input.
  *
- * @deprecated Part of the legacy AgentComposer API. Use ChatComposer from
- * `@tangle-network/agent-app/web-react` — the canonical composer. AgentComposer
- * is frozen and will be removed at sandbox-ui's next breaking release. */
+ * Part of the {@link AgentComposer} API. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` has no equivalent — see
+ * {@link AgentComposer} for which composer fits a surface. */
 interface ComposerFile {
     id: string;
     name: string;
@@ -181,9 +177,9 @@ interface ComposerFile {
 }
 /** Context the agent will see alongside the next message.
  *
- * @deprecated Part of the legacy AgentComposer API. Use ChatComposer from
- * `@tangle-network/agent-app/web-react` — the canonical composer. AgentComposer
- * is frozen and will be removed at sandbox-ui's next breaking release. */
+ * Part of the {@link AgentComposer} API. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` has no equivalent — see
+ * {@link AgentComposer} for which composer fits a surface. */
 interface ComposerContextItem {
     id: string;
     label: string;
@@ -192,11 +188,11 @@ interface ComposerContextItem {
     onRemove?: () => void;
 }
 /**
- * Props of the legacy {@link AgentComposer}.
+ * Props of {@link AgentComposer}.
  *
- * @deprecated Part of the legacy AgentComposer API. Use ChatComposer from
- * `@tangle-network/agent-app/web-react` — the canonical composer. AgentComposer
- * is frozen and will be removed at sandbox-ui's next breaking release.
+ * Part of the {@link AgentComposer} API. `ChatComposer` in
+ * `@tangle-network/agent-app/web-react` has no equivalent — see
+ * {@link AgentComposer} for which composer fits a surface.
  */
 interface AgentComposerProps {
     /** Composer text (controlled). */
@@ -288,25 +284,35 @@ interface AgentComposerProps {
     autoFocus?: boolean;
 }
 /**
- * @deprecated Use `ChatComposer` from `@tangle-network/agent-app/web-react` —
- * the canonical composer. It adds send-failure recovery, seeds, control
- * placement, floating elevation, and the circular icon send via
- * `sendVariant="icon"`. Plan a port, not a rename: 14 of the 28 props here
- * have no same-named counterpart there, among them `contextItems`, `mention`,
- * `trailing`, `maxHeight`, `minRows`, and `autoFocus`. The control model also
- * differs — this component requires `value` and `onChange` and calls
- * `onSubmit` with no arguments, while `ChatComposer` can own its draft and
- * gives the message to a refusable `onSend`. This slot-shell is frozen and
- * will be removed at sandbox-ui's next breaking release.
+ * Sibling of `ChatComposer` in `@tangle-network/agent-app/web-react`, not a
+ * predecessor of it. The two composers cover different jobs, and neither is a
+ * superset of the other, so pick by the features a surface needs.
  *
- * The canonical agent chat input: one rounded surface holding an auto-growing
+ * Reach for `AgentComposer` when the surface needs `@`-mentions (`mention`,
+ * backed by a lazily loaded rich-text input that renders mention pills),
+ * `contextItems`, or the full attachment lifecycle — `attachments` plus
+ * `onRejectFiles` and `onRetryFile`. It also owns `autoFocus`,
+ * `canSubmitAttachmentsOnly`, `trailing`, `maxHeight`, and `minRows`.
+ *
+ * Reach for `ChatComposer` when the surface is a plain send box. It owns
+ * send-failure recovery (`onSendFailed`, `sendFailureMessage`), one-shot
+ * prefill (`seed`), `controlsPlacement`, `floating`, `sendVariant`,
+ * parts-aware sends (`onSendParts`), and an uncontrolled mode
+ * (`initialValue`) — none of which exist here.
+ *
+ * Moving between them is a port, not a rename: the control models differ. This
+ * component requires `value` and `onChange` and calls `onSubmit` with no
+ * arguments, while `ChatComposer` can own its draft and hands the message to a
+ * refusable `onSend`.
+ *
+ * The input itself: one rounded surface holding an auto-growing
  * textarea and a bottom row that runs left → right — attach buttons, the
  * control strip (supplied via the required `controls` prop), trailing slot,
  * and the send button on the far right. The strip is explicit: the canonical
  * pickers are `ModelPicker` / `EffortPicker` / `AgentSessionControls` from
  * `@tangle-network/agent-app/web-react` — this component only owns the slot.
  *
- * Opt-in extras make it the superset of every app's hand-rolled composer:
+ * Opt-in extras cover what apps otherwise hand-roll:
  * file/folder attachments with drag-and-drop + chips + clipboard paste
  * (`onAttach` also gates pasting files onto the textarea, auto-naming
  * generic clipboard image blobs `pasted-image-<n>.<ext>`), a streaming Stop
@@ -323,10 +329,9 @@ declare function AgentComposer({ value, onChange, onSubmit, placeholder, disable
  * importing it never pulls the lazily-loaded editor chunk into a consumer's
  * bundle.
  *
- * @deprecated Mention-pill contract of the legacy AgentComposer mention
- * feature. Use ChatComposer from `@tangle-network/agent-app/web-react` — the
- * canonical composer. AgentComposer is frozen and will be removed at
- * sandbox-ui's next breaking release.
+ * Mention-pill contract of {@link AgentComposer}'s mention feature.
+ * `ChatComposer` in `@tangle-network/agent-app/web-react` has no mention
+ * support, so it has no equivalent.
  */
 declare const MENTION_PILL_CLASS: string;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/sandbox-ui",
-  "version": "0.104.1",
+  "version": "0.105.0",
   "description": "Unified UI component library for Tangle Sandbox — primitives, chat, dashboard, terminal, editor, and workspace components",
   "repository": {
     "type": "git",