@particle-academy/react-fancy 5.64.0 → 5.65.0

package/dist/{index-BF5qsQur.d.cts → index-CCJVT9Hu.d.cts}

@@ -2,6 +2,96 @@ import * as react from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
 import { C as ComposerPastePreview, a as ComposerPasteClassNames } from './PastePills.types-CDyotkUb.cjs';
 
+/**
+ * A file in a saved draft — an attachment chip, or the image behind an image
+ * pill — described by data alone, so the draft survives `JSON.stringify`.
+ *
+ * The bytes are deliberately NOT in here. A `File` does not survive JSON, and
+ * putting base64 in the draft by default would make every saved draft as large
+ * as everything attached to it: a 6 MB screenshot becomes 8 MB of string written
+ * on every keystroke by a host that saves on change. Instead the host decides
+ * where bytes live, through `persistAttachment` (save) and `restoreAttachment`
+ * (load), and the draft carries only the host's handle for them in `ref`.
+ *
+ * A host that WANTS the bytes inline passes `promptFileToDataUrl` as
+ * `persistAttachment`, and `ref` is then a `data:` URL.
+ */
+interface PromptDraftFile {
+    /** Stable for the life of the draft. For an image pill, the pill's own id. */
+    id: string;
+    name: string;
+    /** MIME type, `""` when the browser did not know it. */
+    type: string;
+    bytes: number;
+    /**
+     * The host's handle for the stored bytes — whatever `persistAttachment`
+     * returned: a storage key, an upload URL, a `data:` URL. Absent when the host
+     * keeps nothing, in which case a restored attachment has no `File`.
+     */
+    ref?: string;
+}
+/** A paste held as a pill inside the message. Its marker sits in `text`. */
+type PromptDraftPill = {
+    kind: "text";
+    id: string;
+    text: string;
+} | {
+    kind: "image";
+    id: string;
+    label: string;
+    file: PromptDraftFile;
+};
+/**
+ * Everything a PromptInput holds, as JSON. Versioned, so a draft saved by one
+ * release and read by a later one is recognised or refused, never guessed at.
+ *
+ * `text` is the raw value: with paste pills on, each pill is a marker in it
+ * (`pasteMarker(id)`), because the message itself is the record of what is
+ * attached and where. Mentions and slash commands are plain text in it.
+ */
+interface PromptDraft {
+    v: 1;
+    text: string;
+    pills: PromptDraftPill[];
+    attachments: PromptDraftFile[];
+}
+interface PromptSetDraftOptions {
+    /**
+     * Focus the composer after restoring, caret at the end. Default `false`:
+     * restoring a draft never moves focus or anybody's caret on its own
+     * (genie#1235 was exactly that).
+     */
+    focus?: boolean;
+}
+/** The imperative handle a `ref` on `PromptInput` receives. */
+interface PromptInputHandle {
+    /** The current draft. A fresh JSON-safe copy; mutating it changes nothing. */
+    getDraft(): PromptDraft;
+    /**
+     * Replace the whole draft. Does NOT call `onChange` / `onDraftChange` (the
+     * host is the one setting it), does NOT focus unless `{ focus: true }`.
+     * A draft whose `v` this release does not know is refused with a warning.
+     */
+    setDraft(draft: PromptDraft, options?: PromptSetDraftOptions): void;
+    /** Focus the composer, caret at the end. */
+    focus(): void;
+}
+/**
+ * Read a File as a `data:` URL. Pass it as `persistAttachment` to keep the bytes
+ * IN the draft — simple, and fine for small files; every saved draft then carries
+ * every attached byte, base64-inflated by a third.
+ */
+declare function promptFileToDataUrl(file: Blob): Promise<string>;
+/**
+ * Turn a `data:` URL back into a File — the other half of `promptFileToDataUrl`:
+ *
+ *     restoreAttachment={(f) => f.ref ? promptDataUrlToFile(f.ref, f.name, f.type) : undefined}
+ *
+ * Synchronous, so the restored draft has its Files on the first render.
+ * `undefined` for anything that is not a `data:` URL.
+ */
+declare function promptDataUrlToFile(dataUrl: string, name: string, type?: string): File | undefined;
+
 /**
  * Which modifier key the user actually has.
  *
@@ -98,6 +188,12 @@ type PromptAttachment = {
     file?: File;
     /** MIME type. Hosts branch on this to decide whether a file can be sent as-is. */
     type?: string;
+    /**
+     * The host's handle for the stored bytes, from `persistAttachment`. On an
+     * attachment restored from a draft WITHOUT a File, this is how the host finds
+     * the bytes to send.
+     */
+    ref?: string;
 };
 /**
  * `...rest` reaches the root surface, so a consumer or a bridge can tag the
@@ -108,9 +204,50 @@ type PromptAttachment = {
  * calls it out: "Each interactive element has a stable identity. Agents never
  * guess DOM."
  */
-interface PromptInputProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSubmit" | "className"> {
+interface PromptInputProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSubmit" | "className" | "onChange" | "defaultValue"> {
     /** Extra classes on the root surface. MERGED, never replaced. */
     className?: string;
+    /**
+     * The text, controlled. With paste pills on it carries a marker per pill
+     * (`pasteMarker(id)`), exactly as `Composer`'s `value` does. Pills and
+     * attachments stay internal; use `draft` to control those too.
+     */
+    value?: string;
+    /** The starting text, uncontrolled. Ignored when `value` or `draft` is given. */
+    defaultValue?: string;
+    /**
+     * Called with the new text when the PERSON edits it, and with `""` after a
+     * send. Not called by `setDraft` or a prop change: the host made those.
+     */
+    onChange?: (value: string) => void;
+    /**
+     * The whole draft, controlled: text, paste pills and attachments, as JSON.
+     * Wins over `value`. Pair with `onDraftChange`.
+     */
+    draft?: PromptDraft;
+    /** The starting draft, uncontrolled. Wins over `defaultValue`. */
+    defaultDraft?: PromptDraft;
+    /**
+     * Called with the whole draft whenever the person changes any part of it —
+     * typing, a paste, an attach, a removal, a send (which empties it) — and when
+     * `persistAttachment` resolves a `ref`. Not called by `setDraft`.
+     */
+    onDraftChange?: (draft: PromptDraft) => void;
+    /**
+     * Keep an attached file somewhere and return a handle for it (a storage key, an
+     * upload URL — or a `data:` URL via `promptFileToDataUrl`). Called once per
+     * attached or pasted file; the result becomes the file's `ref` in the draft.
+     * May return a Promise; the draft is updated (and `onDraftChange` fires) when it
+     * resolves. Omit it and a draft carries file metadata only.
+     */
+    persistAttachment?: (file: File, entry: PromptDraftFile) => string | undefined | Promise<string | undefined>;
+    /**
+     * Get a File back for a draft entry restored without one (from `setDraft`,
+     * `defaultDraft` or a controlled `draft`). May return a Promise. Return
+     * `undefined` when there is none: the chip or pill still shows, and the
+     * attachment reaches `onSubmit` with its `ref` and no `file`.
+     */
+    restoreAttachment?: (entry: PromptDraftFile) => File | undefined | Promise<File | undefined>;
     /** Token budget for the meter. */
     budgetTokens: number;
     /** Slash-commands. Names must start with `/`. */
@@ -203,6 +340,6 @@ interface PromptInputProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSubmi
     /** Fraction of `budgetTokens` past which a `"near-limit"` meter takes the warning colour. Default 0.9. */
     meterWarnAt?: number;
 }
-declare function PromptInput({ budgetTokens, commands, mentions, showHint, platform, onSubmit, placeholder, charsPerToken, mentionColor, maxHeight, aboveInput, className, pasteThreshold, pasteImages, previewChars, renderPastePreview, pasteClassNames, pasteFilesName, attachButton, sendButton, usedTokens, meter, meterShowAt, meterWarnAt, ...rest }: PromptInputProps): react.JSX.Element;
+declare const PromptInput: react.ForwardRefExoticComponent<PromptInputProps & react.RefAttributes<PromptInputHandle>>;
 
-export { type FancyPlatform as F, type PlatformHints as P, type PromptAttachment as a, type PromptCmd as b, PromptInput as c, type PromptInputProps as d, type PromptMention as e, browserPlatformHints as f, detectPlatform as g, modifierKeyLabel as m };
+export { type FancyPlatform as F, type PlatformHints as P, type PromptAttachment as a, type PromptCmd as b, type PromptDraft as c, type PromptDraftFile as d, type PromptDraftPill as e, PromptInput as f, type PromptInputHandle as g, type PromptInputProps as h, type PromptMention as i, type PromptSetDraftOptions as j, browserPlatformHints as k, detectPlatform as l, modifierKeyLabel as m, promptFileToDataUrl as n, promptDataUrlToFile as p };

package/dist/{index-BZON-gXr.d.ts → index-DRlltbdV.d.ts}

@@ -2,6 +2,96 @@ import * as react from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
 import { C as ComposerPastePreview, a as ComposerPasteClassNames } from './PastePills.types-CDyotkUb.js';
 
+/**
+ * A file in a saved draft — an attachment chip, or the image behind an image
+ * pill — described by data alone, so the draft survives `JSON.stringify`.
+ *
+ * The bytes are deliberately NOT in here. A `File` does not survive JSON, and
+ * putting base64 in the draft by default would make every saved draft as large
+ * as everything attached to it: a 6 MB screenshot becomes 8 MB of string written
+ * on every keystroke by a host that saves on change. Instead the host decides
+ * where bytes live, through `persistAttachment` (save) and `restoreAttachment`
+ * (load), and the draft carries only the host's handle for them in `ref`.
+ *
+ * A host that WANTS the bytes inline passes `promptFileToDataUrl` as
+ * `persistAttachment`, and `ref` is then a `data:` URL.
+ */
+interface PromptDraftFile {
+    /** Stable for the life of the draft. For an image pill, the pill's own id. */
+    id: string;
+    name: string;
+    /** MIME type, `""` when the browser did not know it. */
+    type: string;
+    bytes: number;
+    /**
+     * The host's handle for the stored bytes — whatever `persistAttachment`
+     * returned: a storage key, an upload URL, a `data:` URL. Absent when the host
+     * keeps nothing, in which case a restored attachment has no `File`.
+     */
+    ref?: string;
+}
+/** A paste held as a pill inside the message. Its marker sits in `text`. */
+type PromptDraftPill = {
+    kind: "text";
+    id: string;
+    text: string;
+} | {
+    kind: "image";
+    id: string;
+    label: string;
+    file: PromptDraftFile;
+};
+/**
+ * Everything a PromptInput holds, as JSON. Versioned, so a draft saved by one
+ * release and read by a later one is recognised or refused, never guessed at.
+ *
+ * `text` is the raw value: with paste pills on, each pill is a marker in it
+ * (`pasteMarker(id)`), because the message itself is the record of what is
+ * attached and where. Mentions and slash commands are plain text in it.
+ */
+interface PromptDraft {
+    v: 1;
+    text: string;
+    pills: PromptDraftPill[];
+    attachments: PromptDraftFile[];
+}
+interface PromptSetDraftOptions {
+    /**
+     * Focus the composer after restoring, caret at the end. Default `false`:
+     * restoring a draft never moves focus or anybody's caret on its own
+     * (genie#1235 was exactly that).
+     */
+    focus?: boolean;
+}
+/** The imperative handle a `ref` on `PromptInput` receives. */
+interface PromptInputHandle {
+    /** The current draft. A fresh JSON-safe copy; mutating it changes nothing. */
+    getDraft(): PromptDraft;
+    /**
+     * Replace the whole draft. Does NOT call `onChange` / `onDraftChange` (the
+     * host is the one setting it), does NOT focus unless `{ focus: true }`.
+     * A draft whose `v` this release does not know is refused with a warning.
+     */
+    setDraft(draft: PromptDraft, options?: PromptSetDraftOptions): void;
+    /** Focus the composer, caret at the end. */
+    focus(): void;
+}
+/**
+ * Read a File as a `data:` URL. Pass it as `persistAttachment` to keep the bytes
+ * IN the draft — simple, and fine for small files; every saved draft then carries
+ * every attached byte, base64-inflated by a third.
+ */
+declare function promptFileToDataUrl(file: Blob): Promise<string>;
+/**
+ * Turn a `data:` URL back into a File — the other half of `promptFileToDataUrl`:
+ *
+ *     restoreAttachment={(f) => f.ref ? promptDataUrlToFile(f.ref, f.name, f.type) : undefined}
+ *
+ * Synchronous, so the restored draft has its Files on the first render.
+ * `undefined` for anything that is not a `data:` URL.
+ */
+declare function promptDataUrlToFile(dataUrl: string, name: string, type?: string): File | undefined;
+
 /**
  * Which modifier key the user actually has.
  *
@@ -98,6 +188,12 @@ type PromptAttachment = {
     file?: File;
     /** MIME type. Hosts branch on this to decide whether a file can be sent as-is. */
     type?: string;
+    /**
+     * The host's handle for the stored bytes, from `persistAttachment`. On an
+     * attachment restored from a draft WITHOUT a File, this is how the host finds
+     * the bytes to send.
+     */
+    ref?: string;
 };
 /**
  * `...rest` reaches the root surface, so a consumer or a bridge can tag the
@@ -108,9 +204,50 @@ type PromptAttachment = {
  * calls it out: "Each interactive element has a stable identity. Agents never
  * guess DOM."
  */
-interface PromptInputProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSubmit" | "className"> {
+interface PromptInputProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSubmit" | "className" | "onChange" | "defaultValue"> {
     /** Extra classes on the root surface. MERGED, never replaced. */
     className?: string;
+    /**
+     * The text, controlled. With paste pills on it carries a marker per pill
+     * (`pasteMarker(id)`), exactly as `Composer`'s `value` does. Pills and
+     * attachments stay internal; use `draft` to control those too.
+     */
+    value?: string;
+    /** The starting text, uncontrolled. Ignored when `value` or `draft` is given. */
+    defaultValue?: string;
+    /**
+     * Called with the new text when the PERSON edits it, and with `""` after a
+     * send. Not called by `setDraft` or a prop change: the host made those.
+     */
+    onChange?: (value: string) => void;
+    /**
+     * The whole draft, controlled: text, paste pills and attachments, as JSON.
+     * Wins over `value`. Pair with `onDraftChange`.
+     */
+    draft?: PromptDraft;
+    /** The starting draft, uncontrolled. Wins over `defaultValue`. */
+    defaultDraft?: PromptDraft;
+    /**
+     * Called with the whole draft whenever the person changes any part of it —
+     * typing, a paste, an attach, a removal, a send (which empties it) — and when
+     * `persistAttachment` resolves a `ref`. Not called by `setDraft`.
+     */
+    onDraftChange?: (draft: PromptDraft) => void;
+    /**
+     * Keep an attached file somewhere and return a handle for it (a storage key, an
+     * upload URL — or a `data:` URL via `promptFileToDataUrl`). Called once per
+     * attached or pasted file; the result becomes the file's `ref` in the draft.
+     * May return a Promise; the draft is updated (and `onDraftChange` fires) when it
+     * resolves. Omit it and a draft carries file metadata only.
+     */
+    persistAttachment?: (file: File, entry: PromptDraftFile) => string | undefined | Promise<string | undefined>;
+    /**
+     * Get a File back for a draft entry restored without one (from `setDraft`,
+     * `defaultDraft` or a controlled `draft`). May return a Promise. Return
+     * `undefined` when there is none: the chip or pill still shows, and the
+     * attachment reaches `onSubmit` with its `ref` and no `file`.
+     */
+    restoreAttachment?: (entry: PromptDraftFile) => File | undefined | Promise<File | undefined>;
     /** Token budget for the meter. */
     budgetTokens: number;
     /** Slash-commands. Names must start with `/`. */
@@ -203,6 +340,6 @@ interface PromptInputProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSubmi
     /** Fraction of `budgetTokens` past which a `"near-limit"` meter takes the warning colour. Default 0.9. */
     meterWarnAt?: number;
 }
-declare function PromptInput({ budgetTokens, commands, mentions, showHint, platform, onSubmit, placeholder, charsPerToken, mentionColor, maxHeight, aboveInput, className, pasteThreshold, pasteImages, previewChars, renderPastePreview, pasteClassNames, pasteFilesName, attachButton, sendButton, usedTokens, meter, meterShowAt, meterWarnAt, ...rest }: PromptInputProps): react.JSX.Element;
+declare const PromptInput: react.ForwardRefExoticComponent<PromptInputProps & react.RefAttributes<PromptInputHandle>>;
 
-export { type FancyPlatform as F, type PlatformHints as P, type PromptAttachment as a, type PromptCmd as b, PromptInput as c, type PromptInputProps as d, type PromptMention as e, browserPlatformHints as f, detectPlatform as g, modifierKeyLabel as m };
+export { type FancyPlatform as F, type PlatformHints as P, type PromptAttachment as a, type PromptCmd as b, type PromptDraft as c, type PromptDraftFile as d, type PromptDraftPill as e, PromptInput as f, type PromptInputHandle as g, type PromptInputProps as h, type PromptMention as i, type PromptSetDraftOptions as j, browserPlatformHints as k, detectPlatform as l, modifierKeyLabel as m, promptFileToDataUrl as n, promptDataUrlToFile as p };

package/dist/index.cjs

@@ -36,7 +36,7 @@ var chunkEZA6GWZL_cjs = require('./chunk-EZA6GWZL.cjs');
 var chunkKSU6RYWU_cjs = require('./chunk-KSU6RYWU.cjs');
 var chunkK5MQZTDW_cjs = require('./chunk-K5MQZTDW.cjs');
 var chunkB4YV2V7G_cjs = require('./chunk-B4YV2V7G.cjs');
-var chunkZ6LYBL5L_cjs = require('./chunk-Z6LYBL5L.cjs');
+var chunkC463C4MM_cjs = require('./chunk-C463C4MM.cjs');
 var chunkOASSZI6M_cjs = require('./chunk-OASSZI6M.cjs');
 require('./chunk-I27K6NLX.cjs');
 var chunkAQ4DZT4Y_cjs = require('./chunk-AQ4DZT4Y.cjs');
@@ -77,7 +77,7 @@ var chunkFQSSVOVQ_cjs = require('./chunk-FQSSVOVQ.cjs');
 require('./chunk-S3TRSECD.cjs');
 var chunkZ7SQMQTF_cjs = require('./chunk-Z7SQMQTF.cjs');
 var chunkAJPYGRLA_cjs = require('./chunk-AJPYGRLA.cjs');
-var chunkA6HWKQ4D_cjs = require('./chunk-A6HWKQ4D.cjs');
+var chunkXZOBGKZL_cjs = require('./chunk-XZOBGKZL.cjs');
 var chunkATIDUWY6_cjs = require('./chunk-ATIDUWY6.cjs');
 var chunkA2JUTNE6_cjs = require('./chunk-A2JUTNE6.cjs');
 var chunkT6YELZPJ_cjs = require('./chunk-T6YELZPJ.cjs');
@@ -373,19 +373,27 @@ Object.defineProperty(exports, "Progress", {
 });
 Object.defineProperty(exports, "PromptInput", {
   enumerable: true,
-  get: function () { return chunkZ6LYBL5L_cjs.PromptInput; }
+  get: function () { return chunkC463C4MM_cjs.PromptInput; }
 });
 Object.defineProperty(exports, "browserPlatformHints", {
   enumerable: true,
-  get: function () { return chunkZ6LYBL5L_cjs.browserPlatformHints; }
+  get: function () { return chunkC463C4MM_cjs.browserPlatformHints; }
 });
 Object.defineProperty(exports, "detectPlatform", {
   enumerable: true,
-  get: function () { return chunkZ6LYBL5L_cjs.detectPlatform; }
+  get: function () { return chunkC463C4MM_cjs.detectPlatform; }
 });
 Object.defineProperty(exports, "modifierKeyLabel", {
   enumerable: true,
-  get: function () { return chunkZ6LYBL5L_cjs.modifierKeyLabel; }
+  get: function () { return chunkC463C4MM_cjs.modifierKeyLabel; }
+});
+Object.defineProperty(exports, "promptDataUrlToFile", {
+  enumerable: true,
+  get: function () { return chunkC463C4MM_cjs.promptDataUrlToFile; }
+});
+Object.defineProperty(exports, "promptFileToDataUrl", {
+  enumerable: true,
+  get: function () { return chunkC463C4MM_cjs.promptFileToDataUrl; }
 });
 Object.defineProperty(exports, "Tooltip", {
   enumerable: true,
@@ -637,11 +645,11 @@ Object.defineProperty(exports, "useDrawer", {
 });
 Object.defineProperty(exports, "Dropdown", {
   enumerable: true,
-  get: function () { return chunkA6HWKQ4D_cjs.Dropdown; }
+  get: function () { return chunkXZOBGKZL_cjs.Dropdown; }
 });
 Object.defineProperty(exports, "useDropdown", {
   enumerable: true,
-  get: function () { return chunkA6HWKQ4D_cjs.useDropdown; }
+  get: function () { return chunkXZOBGKZL_cjs.useDropdown; }
 });
 Object.defineProperty(exports, "Editor", {
   enumerable: true,

package/dist/index.d.cts

@@ -87,7 +87,7 @@ export { Kanban, KanbanCardMoveHandler, KanbanCardProps, KanbanColumnHandleProps
 export { DropPosition, TreeNav, TreeNavContextValue, TreeNavProps, TreeNodeData, TreeNodeProps, useTreeNav } from './tree-nav.cjs';
 export { FileBrowser, FileBrowserContextValue, FileBrowserNewFolder, FileBrowserNodeProps, FileBrowserPathBarProps, FileBrowserProps, FileBrowserProvider, FileBrowserRow, FileBrowserToolbarProps, FileBrowserTreeProps, FileEntry, FileKind, FileLoadStatus, FileSelectMode, FileSnapshotNode, FileSort, FileSortDirection, FileSortField, useFileBrowser, validateFolderName } from './file-browser.cjs';
 export { M as MediaKind, a as MediaViewer, b as MediaViewerProps, R as ResolveMediaTypeInput, r as resolveMediaType } from './index-WG8UdfiE.cjs';
-export { F as FancyPlatform, P as PlatformHints, a as PromptAttachment, b as PromptCmd, c as PromptInput, d as PromptInputProps, e as PromptMention, f as browserPlatformHints, g as detectPlatform, m as modifierKeyLabel } from './index-BF5qsQur.cjs';
+export { F as FancyPlatform, P as PlatformHints, a as PromptAttachment, b as PromptCmd, c as PromptDraft, d as PromptDraftFile, e as PromptDraftPill, f as PromptInput, g as PromptInputHandle, h as PromptInputProps, i as PromptMention, j as PromptSetDraftOptions, k as browserPlatformHints, l as detectPlatform, m as modifierKeyLabel, p as promptDataUrlToFile, n as promptFileToDataUrl } from './index-CCJVT9Hu.cjs';
 import { P as Placement } from './types-DJI492iY.cjs';
 export { A as ActionColor, B as ButtonColor, C as Color, S as Size, V as Variant } from './types-DJI492iY.cjs';
 import { RefObject } from 'react';

package/dist/index.d.ts

@@ -87,7 +87,7 @@ export { Kanban, KanbanCardMoveHandler, KanbanCardProps, KanbanColumnHandleProps
 export { DropPosition, TreeNav, TreeNavContextValue, TreeNavProps, TreeNodeData, TreeNodeProps, useTreeNav } from './tree-nav.js';
 export { FileBrowser, FileBrowserContextValue, FileBrowserNewFolder, FileBrowserNodeProps, FileBrowserPathBarProps, FileBrowserProps, FileBrowserProvider, FileBrowserRow, FileBrowserToolbarProps, FileBrowserTreeProps, FileEntry, FileKind, FileLoadStatus, FileSelectMode, FileSnapshotNode, FileSort, FileSortDirection, FileSortField, useFileBrowser, validateFolderName } from './file-browser.js';
 export { M as MediaKind, a as MediaViewer, b as MediaViewerProps, R as ResolveMediaTypeInput, r as resolveMediaType } from './index-BiyyxWtb.js';
-export { F as FancyPlatform, P as PlatformHints, a as PromptAttachment, b as PromptCmd, c as PromptInput, d as PromptInputProps, e as PromptMention, f as browserPlatformHints, g as detectPlatform, m as modifierKeyLabel } from './index-BZON-gXr.js';
+export { F as FancyPlatform, P as PlatformHints, a as PromptAttachment, b as PromptCmd, c as PromptDraft, d as PromptDraftFile, e as PromptDraftPill, f as PromptInput, g as PromptInputHandle, h as PromptInputProps, i as PromptMention, j as PromptSetDraftOptions, k as browserPlatformHints, l as detectPlatform, m as modifierKeyLabel, p as promptDataUrlToFile, n as promptFileToDataUrl } from './index-DRlltbdV.js';
 import { P as Placement } from './types-DJI492iY.js';
 export { A as ActionColor, B as ButtonColor, C as Color, S as Size, V as Variant } from './types-DJI492iY.js';
 import { RefObject } from 'react';

package/dist/index.js

@@ -34,7 +34,7 @@ export { Sidebar, useSidebar } from './chunk-YJHP5FVA.js';
 export { Pillbox } from './chunk-G35XN5WV.js';
 export { Profile } from './chunk-GOE36IXL.js';
 export { Progress } from './chunk-UE3QO7R3.js';
-export { PromptInput, browserPlatformHints, detectPlatform, modifierKeyLabel } from './chunk-BTNF3QBR.js';
+export { PromptInput, browserPlatformHints, detectPlatform, modifierKeyLabel, promptDataUrlToFile, promptFileToDataUrl } from './chunk-COXHFZR6.js';
 export { Tooltip } from './chunk-GR2WKBER.js';
 import './chunk-SV5BW3IA.js';
 export { MediaViewer, resolveMediaType } from './chunk-5PHPJL7Z.js';
@@ -75,7 +75,7 @@ export { Container } from './chunk-VKMPVFQK.js';
 import './chunk-AUTW5O4W.js';
 export { ContextMenu, useContextMenu } from './chunk-NSJBVV7R.js';
 export { Drawer, useDrawer } from './chunk-PXZRYL5I.js';
-export { Dropdown, useDropdown } from './chunk-JG2DJK5A.js';
+export { Dropdown, useDropdown } from './chunk-BXPLERIJ.js';
 export { Editor, useEditor } from './chunk-CAUEKGMR.js';
 export { THEME_STORAGE_KEY, getThemePreference, initTheme, resolveTheme, setThemePreference, subscribeTheme, useId, useNodeRegistry, useTheme } from './chunk-2BXMMVQS.js';
 export { usePanZoom } from './chunk-CPY7NHXM.js';

package/dist/prompt-input.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkZ6LYBL5L_cjs = require('./chunk-Z6LYBL5L.cjs');
+var chunkC463C4MM_cjs = require('./chunk-C463C4MM.cjs');
 require('./chunk-OASSZI6M.cjs');
 require('./chunk-I27K6NLX.cjs');
 require('./chunk-AIA5UNQ5.cjs');
@@ -23,7 +23,15 @@ require('./chunk-ZU5Q77OT.cjs');
 
 Object.defineProperty(exports, "PromptInput", {
   enumerable: true,
-  get: function () { return chunkZ6LYBL5L_cjs.PromptInput; }
+  get: function () { return chunkC463C4MM_cjs.PromptInput; }
+});
+Object.defineProperty(exports, "promptDataUrlToFile", {
+  enumerable: true,
+  get: function () { return chunkC463C4MM_cjs.promptDataUrlToFile; }
+});
+Object.defineProperty(exports, "promptFileToDataUrl", {
+  enumerable: true,
+  get: function () { return chunkC463C4MM_cjs.promptFileToDataUrl; }
 });
 //# sourceMappingURL=prompt-input.cjs.map
 //# sourceMappingURL=prompt-input.cjs.map

package/dist/prompt-input.d.cts

@@ -1,3 +1,3 @@
-export { a as PromptAttachment, b as PromptCmd, c as PromptInput, d as PromptInputProps, e as PromptMention } from './index-BF5qsQur.cjs';
+export { a as PromptAttachment, b as PromptCmd, c as PromptDraft, d as PromptDraftFile, e as PromptDraftPill, f as PromptInput, g as PromptInputHandle, h as PromptInputProps, i as PromptMention, j as PromptSetDraftOptions, p as promptDataUrlToFile, n as promptFileToDataUrl } from './index-CCJVT9Hu.cjs';
 import 'react';
 import './PastePills.types-CDyotkUb.cjs';

package/dist/prompt-input.d.ts

@@ -1,3 +1,3 @@
-export { a as PromptAttachment, b as PromptCmd, c as PromptInput, d as PromptInputProps, e as PromptMention } from './index-BZON-gXr.js';
+export { a as PromptAttachment, b as PromptCmd, c as PromptDraft, d as PromptDraftFile, e as PromptDraftPill, f as PromptInput, g as PromptInputHandle, h as PromptInputProps, i as PromptMention, j as PromptSetDraftOptions, p as promptDataUrlToFile, n as promptFileToDataUrl } from './index-DRlltbdV.js';
 import 'react';
 import './PastePills.types-CDyotkUb.js';

package/dist/prompt-input.js

@@ -1,4 +1,4 @@
-export { PromptInput } from './chunk-BTNF3QBR.js';
+export { PromptInput, promptDataUrlToFile, promptFileToDataUrl } from './chunk-COXHFZR6.js';
 import './chunk-GR2WKBER.js';
 import './chunk-SV5BW3IA.js';
 import './chunk-TJ66S5K6.js';

package/docs/PromptInput.md

@@ -52,14 +52,91 @@ import { PromptInput } from "@particle-academy/react-fancy";
 | maxHeight | `number` | `280` | Max textarea height in pixels. |
 | aboveInput | `ReactNode` | — | Rendered inside the rounded shell, above the textarea. Use this for a drawer of tools/files/prompts/etc. so the drawer and composer share one visual panel — see [ChatDrawer](./ChatDrawer.md). Added in `3.2.0`. |
 
+### Controlled state and drafts
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| value | `string` | — | The text, controlled. With paste pills on, it carries a `pasteMarker(id)` per pill. |
+| defaultValue | `string` | `""` | The starting text, uncontrolled. |
+| onChange | `(text) => void` | — | Called when the person edits the text, and with `""` after a send. Not called by `setDraft`. |
+| draft | `PromptDraft` | — | The whole draft (text, pills, attachments), controlled. Takes precedence over `value`. |
+| defaultDraft | `PromptDraft` | — | The starting draft, uncontrolled. Takes precedence over `defaultValue`. |
+| onDraftChange | `(draft) => void` | — | Called on every change the person makes, and when a `persistAttachment` handle arrives. Not called by `setDraft`. |
+| persistAttachment | `(file, entry) => string \| undefined \| Promise<…>` | — | Stores an attached or pasted file and returns a handle. The handle becomes `entry.ref`. |
+| restoreAttachment | `(entry) => File \| undefined \| Promise<…>` | — | Gets the File back for a restored entry. |
+
+## Saving and restoring a draft
+
+The draft is plain JSON, so a host can store it anywhere:
+
+```tsx
+const composer = useRef<PromptInputHandle>(null);
+
+// save, e.g. on onDraftChange or before quitting
+localStorage.setItem(`draft:${chatId}`, JSON.stringify(composer.current!.getDraft()));
+
+// restore after a restart. This does not focus the composer or move any caret.
+const saved = localStorage.getItem(`draft:${chatId}`);
+if (saved) composer.current!.setDraft(JSON.parse(saved));
+
+<PromptInput ref={composer} budgetTokens={32000} pasteThreshold={500} pasteImages onSubmit={send} />
+```
+
+- `setDraft(draft, { focus?: false })` does **not** focus unless you pass `{ focus: true }`. It never moves the caret of whatever does have focus.
+- `setDraft` does not call `onChange` / `onDraftChange`. You set the draft yourself, so you already have it.
+- A draft with an unknown `v` is refused with a console warning.
+
+### Attachments: where the bytes go
+
+A `File` cannot be stored as JSON, and by default a draft does not carry the
+bytes. Base64 in every draft would make each save as large as everything
+attached, which matters for a host that saves on every keystroke. Each file in
+a draft is `{ id, name, type, bytes, ref? }`. You decide where the bytes live:
+
+```tsx
+// Your own store (IndexedDB, upload, disk): return a handle, async is fine.
+<PromptInput
+  persistAttachment={async (file, entry) => { await idb.put(entry.id, file); return entry.id; }}
+  restoreAttachment={(entry) => (entry.ref ? idb.get(entry.ref) : undefined)}
+  …
+/>
+
+// Or keep the bytes in the draft itself, simple for small files:
+<PromptInput
+  persistAttachment={promptFileToDataUrl}
+  restoreAttachment={(f) => (f.ref ? promptDataUrlToFile(f.ref, f.name, f.type) : undefined)}
+  …
+/>
+```
+
+When there is no File for a restored entry, its chip or pill still shows. It
+reaches `onSubmit` with its `ref` and `file: undefined`, and the host sends it
+from its own store.
+
 ## Types
 
 ```ts
 type PromptCmd = { name: string; hint: string };
 type PromptMention = { id: string; name: string; kind: string };
-type PromptAttachment = { id: string; name: string; bytes: number };
+type PromptAttachment = { id: string; name: string; bytes: number; file?: File; type?: string; ref?: string };
+
+interface PromptDraftFile { id: string; name: string; type: string; bytes: number; ref?: string }
+type PromptDraftPill =
+  | { kind: "text"; id: string; text: string }
+  | { kind: "image"; id: string; label: string; file: PromptDraftFile };
+interface PromptDraft { v: 1; text: string; pills: PromptDraftPill[]; attachments: PromptDraftFile[] }
+
+interface PromptInputHandle {
+  getDraft(): PromptDraft;
+  setDraft(draft: PromptDraft, options?: { focus?: boolean }): void;
+  focus(): void;
+}
 ```
 
+Data handles: the root `[data-react-fancy-prompt-input]`, each attachment chip
+`[data-react-fancy-prompt-input-attachment="<id>"]`, plus `-attach`, `-send`,
+`-meter` and `-hint`.
+
 ## Defaults
 
 | Mention kind | Default colour |

package/docs/ReorderableGrid.md

@@ -42,6 +42,8 @@ const [order, setOrder] = useState(fields.map((f) => f.id));
 
 Uncontrolled: leave out `value`, optionally pass `defaultValue`, and listen to `onReorder`.
 
+**The cell is already framed.** By default every cell draws its own border, surface and padding, so `renderItem` should return bare content, as above. If you wrap it in your own bordered card you get a frame inside a frame. To draw the cell yourself, pass `unstyled` (drag, keyboard and announcements are unchanged), or adjust the default frame with `cellClassName`.
+
 ## Order: `value` is a list of ids
 
 `items` carries the data and `value` (or `defaultValue`) carries the order. The order is not taken from `items`. This follows the kit's controlled pattern (`value` / `defaultValue`, see `useControllableState`), and it suits the two consumers:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@particle-academy/react-fancy",
-  "version": "5.64.0",
+  "version": "5.65.0",
   "description": "React UI component library for Human+ UX — controlled, agent-bridgeable primitives",
   "repository": {
     "type": "git",