@particle-academy/react-fancy 5.64.1 → 5.66.0

package/CHANGELOG.md

@@ -11,6 +11,73 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [5.66.0] - 2026-10-27
+
+### Added
+
+- **`PromptInput`: text paste pills take an optional `label`** (genie#1280).
+  A text pill (`{ kind: "text", id, text, label? }` in `PromptDraft`) shows its
+  `label` in place of `Pasted text · N characters`. This mirrors the label image
+  pills already have. It lets a host that inserts a pill itself, such as Genie
+  sending a plan step into the chat, show which step it is.
+  - The label is display only. The submitted value still expands the pill to
+    the full `text`.
+  - The accessible name becomes `Insert this pasted text: <label>, N characters`,
+    so it still says the pill is pasted text.
+  - The label is drawn as plain text, never HTML. Whitespace, control characters
+    and U+FFFC are flattened to single spaces, and the label is capped at 80
+    characters with `…`. If it is blank or not a string, the generic text is
+    shown. A non-string `label` is dropped when a draft is read.
+  - It round-trips through `getDraft` / `setDraft`, `defaultDraft`, a controlled
+    `draft` and `onDraftChange`. `HeldPaste` (the `Composer` / `usePastePills`
+    shape) gains the same optional `label`.
+  - Additive. With no `label` the markup is unchanged, so you need do nothing.
+
+## [5.65.0] - 2026-10-27
+
+### Added
+
+- **`PromptInput`: controlled state and draft save/restore** (genie#1261).
+  Before this, nothing outside the composer could read or set what had been
+  typed, so a host could not keep a draft across a restart. That also broke the
+  component contract, which requires controlled state.
+  - `value` / `defaultValue` / `onChange(text)` cover the simple case. With
+    paste pills on, `value` carries a `pasteMarker(id)` for each pill, the same
+    as `Composer`'s `value`.
+  - `draft` / `defaultDraft` / `onDraftChange(draft)` cover the whole draft.
+    A `PromptDraft` is plain JSON:
+    `{ v: 1, text, pills: [{ kind: "text", id, text } | { kind: "image", id, label, file }], attachments: [{ id, name, type, bytes, ref? }] }`.
+  - A `ref` now resolves to a `PromptInputHandle`: `getDraft()`,
+    `setDraft(draft, { focus?: false })` and `focus()`.
+  - **Restoring a draft never moves focus or a caret** (genie#1235). This holds
+    when nothing is focused and when another input is. Pass `{ focus: true }`
+    to focus the composer.
+  - `setDraft` does **not** call `onChange` / `onDraftChange`. The host set the
+    draft and already has it, and firing the callbacks would make a restore
+    look like typing (a dirty flag, a typing indicator, a save over what was
+    just loaded). This is the same as assigning `input.value` in the DOM.
+  - The file bytes are not in the draft. `persistAttachment(file, entry)`
+    stores each attached or pasted file wherever the host chooses and returns
+    a handle, which becomes the entry's `ref`. It can be sync or async.
+    `restoreAttachment(entry)` gets the File back on restore. To keep the bytes
+    inline, use the new `promptFileToDataUrl` / `promptDataUrlToFile` helpers.
+    A restored entry with no File still shows its chip or pill, and reaches
+    `onSubmit` with its `ref` and `file: undefined`.
+  - `PromptAttachment` gains an optional `ref`. Each attachment chip gets a
+    stable `data-react-fancy-prompt-input-attachment="<id>"` handle.
+  - A draft whose `v` is unknown is refused with a console warning rather than
+    guessed at. Pills restored into a composer with no pills turned on are
+    expanded in place, and image pills become attachments, so no raw markers
+    show.
+
+  **What you must do: nothing, unless you opt in.** Existing usage renders the
+  same markup as 5.64.1, checked against a snapshot written by 5.64.1 itself.
+  Two edge cases. `ref`, `onChange` and `defaultValue` used to fall through
+  `...rest` to the root `<div>`, but none of them was in the props type, so a
+  TypeScript consumer could not have passed them. If you passed one anyway
+  (an untyped `onChange` that listened for DOM change events bubbling to the
+  root), it now means the new prop.
+
 ## [5.64.1] - 2026-10-27
 
 ### Fixed

package/dist/{PastePills.types-CDyotkUb.d.cts → PastePills.types-CpXzsuwJ.d.cts}

@@ -9,6 +9,8 @@
 interface HeldPaste {
     id: string;
     text: string;
+    /** Shown on the pill instead of `Pasted text · N characters`. Display only. */
+    label?: string;
 }
 /**
  * The minimum of a clipboard event this hook touches.

package/dist/{PastePills.types-CDyotkUb.d.ts → PastePills.types-CpXzsuwJ.d.ts}

@@ -9,6 +9,8 @@
 interface HeldPaste {
     id: string;
     text: string;
+    /** Shown on the pill instead of `Pasted text · N characters`. Display only. */
+    label?: string;
 }
 /**
  * The minimum of a clipboard event this hook touches.

package/dist/{PastedFilesInput-CrgNoEBd.d.ts → PastedFilesInput-Bt3KSTVN.d.ts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
-import { C as ComposerPastePreview, a as ComposerPasteClassNames, b as HeldPaste, H as HeldImage, f as UsePastePillsResult } from './PastePills.types-CDyotkUb.js';
+import { C as ComposerPastePreview, a as ComposerPasteClassNames, b as HeldPaste, H as HeldImage, f as UsePastePillsResult } from './PastePills.types-CpXzsuwJ.js';
 
 /** The attribute on the placeholder span a pill is portalled into. */
 declare const HOST_ATTR = "data-react-fancy-composer-paste-host";

package/dist/{PastedFilesInput-DQ1eZaHk.d.cts → PastedFilesInput-CUQeOeOA.d.cts}

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, RefObject } from 'react';
-import { C as ComposerPastePreview, a as ComposerPasteClassNames, b as HeldPaste, H as HeldImage, f as UsePastePillsResult } from './PastePills.types-CDyotkUb.cjs';
+import { C as ComposerPastePreview, a as ComposerPasteClassNames, b as HeldPaste, H as HeldImage, f as UsePastePillsResult } from './PastePills.types-CpXzsuwJ.cjs';
 
 /** The attribute on the placeholder span a pill is portalled into. */
 declare const HOST_ATTR = "data-react-fancy-composer-paste-host";

package/dist/{chunk-SZH7TFME.js → chunk-4EUDW2WU.js}

@@ -1,6 +1,6 @@
 import { Switch } from './chunk-DXZCKDYS.js';
 import { DatePicker } from './chunk-2UTN3EFK.js';
-import { Input } from './chunk-MVVHUTXA.js';
+import { Input } from './chunk-B4LVQ4QI.js';
 import { Select } from './chunk-FVI4JDLA.js';
 import { Textarea } from './chunk-UVUBV4VZ.js';
 import { DisplayValue } from './chunk-WX5XYDVN.js';
@@ -1337,5 +1337,5 @@ function buildItems({
 }
 
 export { JSON_FIELD_TYPES, JsonEditor, applyJsonEdit, describeEdit, findJsonConflicts, getAtPath, inferType, parseKeyMap, parsePath, pathToString, resolveKeyRule, typeMatches };
-//# sourceMappingURL=chunk-SZH7TFME.js.map
-//# sourceMappingURL=chunk-SZH7TFME.js.map
+//# sourceMappingURL=chunk-4EUDW2WU.js.map
+//# sourceMappingURL=chunk-4EUDW2WU.js.map