@tangle-network/sandbox-ui 0.105.3 → 0.106.0

package/dist/chat.d.ts

@@ -60,9 +60,11 @@ declare function ReasoningLevelPicker({ value, onChange, disabled, className, tr
 /**
  * Limits applied when staging files onto a composer.
  *
- * 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.
+ * @deprecated Composer-only helper of the legacy AgentComposer. agent-app
+ * (≥0.46) splits this job: accept filtering lives in `filterAcceptedFiles`
+ * from `@tangle-network/agent-app/web-react`, and size/count limits belong to
+ * the staging queue (`useComposerAttachments`). AgentComposer is frozen and
+ * will be removed at sandbox-ui's next breaking release.
  */
 interface ComposerFileValidationConfig {
     /** Reject any single file larger than this. */
@@ -80,9 +82,11 @@ interface ComposerFileValidationConfig {
 }
 /** A file that failed validation, paired with a human-readable reason.
  *
- * 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. */
+ * @deprecated Composer-only helper of the legacy AgentComposer. Import
+ * `ComposerFileRejection` from `@tangle-network/agent-app/web-react`
+ * (agent-app ≥0.46) — the same shape, reported by `ChatComposer`'s
+ * `onRejectFiles`. AgentComposer is frozen and will be removed at sandbox-ui's
+ * next breaking release. */
 interface ComposerFileRejection {
     file: File;
     reason: string;
@@ -92,9 +96,10 @@ interface ComposerFileRejection {
  * grammar as the native `<input accept>` attribute. An undefined or empty
  * `accept` accepts everything.
  *
- * 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.
+ * @deprecated Composer-only helper of the legacy AgentComposer. Use
+ * `isAcceptedFileType` from `@tangle-network/agent-app/web-react`
+ * (agent-app ≥0.46) — the same `accept` grammar. AgentComposer is frozen and
+ * will be removed at sandbox-ui's next breaking release.
  */
 declare function isAcceptedType(file: File, accept?: string): boolean;
 /**
@@ -104,9 +109,11 @@ 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.
  *
- * 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.
+ * @deprecated Composer-only helper of the legacy AgentComposer. Use
+ * `filterAcceptedFiles` from `@tangle-network/agent-app/web-react`
+ * (agent-app ≥0.46) for accept filtering; size and count limits belong to the
+ * staging queue (`useComposerAttachments`). AgentComposer is frozen and will
+ * be removed at sandbox-ui's next breaking release.
  */
 declare function validateComposerFiles(files: File[] | FileList, config: ComposerFileValidationConfig): {
     accepted: File[];
@@ -116,9 +123,10 @@ 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.
  *
- * 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. */
+ * @deprecated Part of the legacy AgentComposer API. Import `MentionItem` from
+ * `@tangle-network/agent-app/web-react` (agent-app ≥0.46) — the same contract,
+ * now owned by the package that defines it. AgentComposer is frozen and will
+ * be removed at sandbox-ui's next breaking release. */
 interface MentionItem {
     id: string;
     label: string;
@@ -130,9 +138,10 @@ interface MentionItem {
  * TipTap rich input that renders mentions as atomic pills; absent ⇒ exactly
  * today's plain-textarea behavior. Data-agnostic: the app supplies items.
  *
- * 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.
+ * @deprecated Part of the legacy AgentComposer API. `ComposerMentionProp` in
+ * `@tangle-network/agent-app/web-react` (agent-app ≥0.46) is the same contract
+ * on `ChatComposer`'s `mention` prop. AgentComposer is frozen and will be
+ * removed at sandbox-ui's next breaking release.
  */
 interface AgentComposerMention {
     /** The character that opens the popover. Default "@". */
@@ -155,9 +164,10 @@ interface AgentComposerMention {
 }
 /** A staged attachment shown as a chip above the input.
  *
- * 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. */
+ * @deprecated Part of the legacy AgentComposer API. Import `ComposerFile` from
+ * `@tangle-network/agent-app/web-react` (agent-app ≥0.46) — the same shape,
+ * consumed by `ChatComposer`'s `pendingFiles`. AgentComposer is frozen and
+ * will be removed at sandbox-ui's next breaking release. */
 interface ComposerFile {
     id: string;
     name: string;
@@ -177,9 +187,11 @@ interface ComposerFile {
 }
 /** Context the agent will see alongside the next message.
  *
- * 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. */
+ * @deprecated Part of the legacy AgentComposer API. Import
+ * `ComposerContextItem` from `@tangle-network/agent-app/web-react`
+ * (agent-app ≥0.46) — the same shape, consumed by `ChatComposer`'s
+ * `contextItems`. AgentComposer is frozen and will be removed at sandbox-ui's
+ * next breaking release. */
 interface ComposerContextItem {
     id: string;
     label: string;
@@ -188,11 +200,12 @@ interface ComposerContextItem {
     onRemove?: () => void;
 }
 /**
- * Props of {@link AgentComposer}.
+ * Props of the legacy {@link AgentComposer}.
  *
- * 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.
+ * @deprecated Part of the legacy AgentComposer API. `ChatComposerProps` in
+ * `@tangle-network/agent-app/web-react` (agent-app ≥0.46) covers every prop
+ * here — see {@link AgentComposer} for the four renames. AgentComposer is
+ * frozen and will be removed at sandbox-ui's next breaking release.
  */
 interface AgentComposerProps {
     /** Composer text (controlled). */
@@ -284,26 +297,19 @@ interface AgentComposerProps {
     autoFocus?: boolean;
 }
 /**
- * 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.
- *
- * 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`.
+ * @deprecated Use `ChatComposer` from `@tangle-network/agent-app/web-react` —
+ * since agent-app 0.46 it is a strict superset of this component. Everything
+ * that once lived only here now lives there: `mention` (the same
+ * `ComposerMentionProp` contract), `contextItems`, the full attachment
+ * lifecycle (`pendingFiles` with `previewUrl` thumbnails, `onRejectFiles`,
+ * `onRetryFile`, clipboard paste with `pasted-image-<n>.<ext>` naming),
+ * `autoFocus`, `canSubmitAttachmentsOnly`, `canSubmitWhileBusy`, `trailing`,
+ * `maxHeight`, and `minRows`. Migration is four prop renames — `onChange` →
+ * `onValueChange`, `onSubmit()` → `onSend(message)`, `busy` → `isStreaming`,
+ * `attachments` → `pendingFiles`; every other prop carries across unchanged.
+ * Add `sendVariant="icon"` and `focusShortcut={false}` where a surface wants
+ * this component's exact chrome. AgentComposer is frozen and will be removed
+ * at sandbox-ui's next breaking release.
  *
  * The input itself: one rounded surface holding an auto-growing
  * textarea and a bottom row that runs left → right — attach buttons, the
@@ -329,9 +335,11 @@ declare function AgentComposer({ value, onChange, onSubmit, placeholder, disable
  * importing it never pulls the lazily-loaded editor chunk into a consumer's
  * bundle.
  *
- * 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.
+ * @deprecated Mention-pill contract of the legacy AgentComposer mention
+ * feature. Import `MENTION_PILL_CLASS` from
+ * `@tangle-network/agent-app/web-react` (agent-app ≥0.46) — `ChatComposer`
+ * owns the mention stack now. AgentComposer is frozen and will be removed at
+ * sandbox-ui's next breaking release.
  */
 declare const MENTION_PILL_CLASS: string;
 

package/package.json

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