@particle-academy/react-fancy 5.30.0 → 5.32.0

package/dist/index-CDo7LyIB.d.ts

@@ -0,0 +1,132 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+
+/**
+ * A paste held beside a composer rather than inserted into it.
+ *
+ * There is deliberately **no `length` field.** It would be `text.length` and
+ * nothing else, and a derived value stored beside its source is a value that can
+ * disagree with it — the two drift the moment anything edits one. Read
+ * `paste.text.length`.
+ */
+interface HeldPaste {
+    id: string;
+    text: string;
+}
+/**
+ * The minimum of a clipboard event this hook touches.
+ *
+ * Structural rather than `React.ClipboardEvent` so a host can call it from a
+ * native listener, a synthetic one, or a test double. React's own event satisfies
+ * it.
+ */
+interface PasteEventLike {
+    clipboardData?: {
+        getData(type: string): string;
+    } | null;
+    preventDefault(): void;
+}
+interface UsePastePillsOptions {
+    /**
+     * Hold a paste of at least this many characters. Try 500 — about a long
+     * paragraph.
+     *
+     * **No default, on purpose.** Paste is a fundamental interaction, so holding one
+     * is something a host asks for rather than something it discovers. Omit this and
+     * `handlePaste` always returns `false` and touches nothing.
+     */
+    threshold?: number;
+    /** Own the list yourself. Omit to let the hook keep it. */
+    heldPastes?: HeldPaste[];
+    onHeldPastesChange?: (pastes: HeldPaste[]) => void;
+}
+interface UsePastePillsResult {
+    heldPastes: HeldPaste[];
+    /**
+     * Call this from your OWN paste handler. Returns `true` if it took the paste —
+     * in which case it has already called `preventDefault()` — and `false` if it
+     * declined, having touched nothing.
+     *
+     * Composable on purpose: a host whose handler already intercepts paste for its
+     * own reasons needs to ask "did you want this?" rather than hand over the event.
+     *
+     *     function onPaste(e) {
+     *       if (pills.handlePaste(e)) return;
+     *       // ...your own handling
+     *     }
+     */
+    handlePaste: (event: PasteEventLike) => boolean;
+    /**
+     * Removes the paste and returns its text, for the host to insert into its own
+     * surface. `undefined` if there is no such id.
+     *
+     * The hook cannot insert it — it owns no DOM and does not know what a host's
+     * surface is. That is the point.
+     */
+    expand: (id: string) => string | undefined;
+    /** Discard one without returning it. */
+    remove: (id: string) => void;
+    /** Empty the list, e.g. after a send. */
+    clear: () => void;
+}
+/**
+ * Hold a large paste as state, so a composer can show it as a pill instead of
+ * turning itself into a scrolling wall.
+ *
+ * ---------------------------------------------------------------------------
+ * Why this is a hook and not just a feature of `Composer`
+ * ---------------------------------------------------------------------------
+ *
+ * `Composer` shipped the behaviour in 5.31.0 and the MOIC estate, who specified it,
+ * then established something I had missed: their chat input is a contenteditable
+ * rendering inline `[deal:42|Acme]` badges, so they **cannot** adopt `Composer` (a
+ * plain textarea) however much they want its behaviour. Their plan to delete their
+ * own composer when ours landed could never have worked.
+ *
+ * So the logic lives here and **`Composer` is its first caller.** One
+ * implementation rather than two, which matters more than the convenience: two
+ * copies of a rule drift, and the copy nobody reads is the one that rots. The rule
+ * that must not drift is the one in `Composer`'s own tests — a send with pills
+ * still closed carries the text.
+ *
+ * It owns no DOM. The host renders the pills.
+ */
+declare function usePastePills({ threshold, heldPastes: controlledHeldPastes, onHeldPastesChange, }?: UsePastePillsOptions): UsePastePillsResult;
+
+interface ComposerProps {
+    value?: string;
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    onSubmit?: (value: string) => void;
+    placeholder?: string;
+    actions?: ReactNode;
+    disabled?: boolean;
+    className?: string;
+    /**
+     * Hold a paste of at least this many characters beside the composer as a pill,
+     * instead of inserting it. Try 500 — about a long paragraph.
+     *
+     * **Omit it and paste behaves exactly as it always has.** Opt-in on purpose:
+     * paste is a fundamental interaction and this library is past 1.0, so a minor
+     * release must not quietly change what pasting does for every consumer. There is
+     * no default threshold for the same reason.
+     *
+     * Below the threshold nothing changes at all — no prevented event, no pill, no
+     * ceremony for an address or a name.
+     */
+    pasteThreshold?: number;
+    /**
+     * The held pastes, if you want to own them.
+     *
+     * Controllable rather than internal because the component contract forbids
+     * internal-only state for anything an agent might need to read or write — an
+     * agent driving this surface has to be able to see that a paste is attached, and
+     * to attach one itself.
+     */
+    heldPastes?: HeldPaste[];
+    onHeldPastesChange?: (pastes: HeldPaste[]) => void;
+}
+
+declare const Composer: react.ForwardRefExoticComponent<ComposerProps & react.RefAttributes<HTMLDivElement>>;
+
+export { Composer as C, type HeldPaste as H, type PasteEventLike as P, type UsePastePillsOptions as U, type ComposerProps as a, type UsePastePillsResult as b, usePastePills as u };

package/dist/index.cjs

@@ -1,29 +1,29 @@
 'use strict';
 
 var chunkCOH45MGW_cjs = require('./chunk-COH45MGW.cjs');
-var chunkNR346SKH_cjs = require('./chunk-NR346SKH.cjs');
+var chunkYMDYDUBH_cjs = require('./chunk-YMDYDUBH.cjs');
 var chunkRLMU3NHQ_cjs = require('./chunk-RLMU3NHQ.cjs');
 var chunk7HMEDY24_cjs = require('./chunk-7HMEDY24.cjs');
 var chunk7VLRHXLQ_cjs = require('./chunk-7VLRHXLQ.cjs');
 require('./chunk-O5IO7TCO.cjs');
-var chunkIRD6UXDK_cjs = require('./chunk-IRD6UXDK.cjs');
+var chunkFVTCPERB_cjs = require('./chunk-FVTCPERB.cjs');
 require('./chunk-OYZDSMNP.cjs');
 require('./chunk-5FV6GMFP.cjs');
 var chunk6MDZQIMZ_cjs = require('./chunk-6MDZQIMZ.cjs');
-var chunkRKG2Q2HT_cjs = require('./chunk-RKG2Q2HT.cjs');
-var chunkJDRKYYXP_cjs = require('./chunk-JDRKYYXP.cjs');
+var chunkU7PFHQBN_cjs = require('./chunk-U7PFHQBN.cjs');
+var chunkBZDXX6E3_cjs = require('./chunk-BZDXX6E3.cjs');
 require('./chunk-URTLYNZI.cjs');
 require('./chunk-QGPMVFZJ.cjs');
-var chunkBJYTI2ID_cjs = require('./chunk-BJYTI2ID.cjs');
-var chunkUA2C2U3M_cjs = require('./chunk-UA2C2U3M.cjs');
+var chunkZUQUL53P_cjs = require('./chunk-ZUQUL53P.cjs');
+var chunkFPZYPD3N_cjs = require('./chunk-FPZYPD3N.cjs');
 require('./chunk-HXLSEBAL.cjs');
-var chunkLY7PZEF4_cjs = require('./chunk-LY7PZEF4.cjs');
+var chunk6IBBAOQC_cjs = require('./chunk-6IBBAOQC.cjs');
 var chunkAASQ6L6X_cjs = require('./chunk-AASQ6L6X.cjs');
 var chunk7Y2AENZD_cjs = require('./chunk-7Y2AENZD.cjs');
 var chunkO6GTY53I_cjs = require('./chunk-O6GTY53I.cjs');
 var chunkATJSHM6J_cjs = require('./chunk-ATJSHM6J.cjs');
-var chunkPWLBHNOA_cjs = require('./chunk-PWLBHNOA.cjs');
-var chunk3EIB7RPD_cjs = require('./chunk-3EIB7RPD.cjs');
+var chunkZ3NSPDTW_cjs = require('./chunk-Z3NSPDTW.cjs');
+var chunk3Q4NSAEA_cjs = require('./chunk-3Q4NSAEA.cjs');
 require('./chunk-XURQVDCN.cjs');
 var chunkPFEFKLUV_cjs = require('./chunk-PFEFKLUV.cjs');
 var chunkRWOH2ADL_cjs = require('./chunk-RWOH2ADL.cjs');
@@ -36,14 +36,14 @@ var chunkOS2QC3NE_cjs = require('./chunk-OS2QC3NE.cjs');
 var chunkTXCAIL5X_cjs = require('./chunk-TXCAIL5X.cjs');
 var chunkI6L7OP7G_cjs = require('./chunk-I6L7OP7G.cjs');
 var chunkQSFTWIUH_cjs = require('./chunk-QSFTWIUH.cjs');
-var chunk6LOV75CN_cjs = require('./chunk-6LOV75CN.cjs');
+var chunkXK5WHQ3O_cjs = require('./chunk-XK5WHQ3O.cjs');
 var chunkHIN6PHSE_cjs = require('./chunk-HIN6PHSE.cjs');
-var chunkYAJYIRQL_cjs = require('./chunk-YAJYIRQL.cjs');
+var chunkLLA33GKC_cjs = require('./chunk-LLA33GKC.cjs');
 var chunkWKNVZUWZ_cjs = require('./chunk-WKNVZUWZ.cjs');
-var chunkSCGE6DCE_cjs = require('./chunk-SCGE6DCE.cjs');
-var chunkB5KK7NYP_cjs = require('./chunk-B5KK7NYP.cjs');
-var chunkVUKIFFWK_cjs = require('./chunk-VUKIFFWK.cjs');
-var chunkLHNC42J3_cjs = require('./chunk-LHNC42J3.cjs');
+var chunkYMU3SS6D_cjs = require('./chunk-YMU3SS6D.cjs');
+var chunkY52NXM73_cjs = require('./chunk-Y52NXM73.cjs');
+var chunkBZZDHDMK_cjs = require('./chunk-BZZDHDMK.cjs');
+var chunkIPNJMHJ3_cjs = require('./chunk-IPNJMHJ3.cjs');
 var chunkFXP4JLGU_cjs = require('./chunk-FXP4JLGU.cjs');
 var chunkQAFAPHAF_cjs = require('./chunk-QAFAPHAF.cjs');
 var chunkSUCBR6L5_cjs = require('./chunk-SUCBR6L5.cjs');
@@ -59,7 +59,7 @@ var chunkTH7VP4CL_cjs = require('./chunk-TH7VP4CL.cjs');
 var chunkV35A6B7A_cjs = require('./chunk-V35A6B7A.cjs');
 var chunkRPVCMW64_cjs = require('./chunk-RPVCMW64.cjs');
 var chunkGBGJWAXZ_cjs = require('./chunk-GBGJWAXZ.cjs');
-var chunkJV6RDIA6_cjs = require('./chunk-JV6RDIA6.cjs');
+var chunkT45XK5GN_cjs = require('./chunk-T45XK5GN.cjs');
 var chunkLAQGBLIU_cjs = require('./chunk-LAQGBLIU.cjs');
 var chunkOOZCJLEF_cjs = require('./chunk-OOZCJLEF.cjs');
 require('./chunk-FJKZ5NOA.cjs');
@@ -69,11 +69,11 @@ var chunkF7YCIII4_cjs = require('./chunk-F7YCIII4.cjs');
 var chunkPV5WDIGM_cjs = require('./chunk-PV5WDIGM.cjs');
 var chunkZ43BI7CQ_cjs = require('./chunk-Z43BI7CQ.cjs');
 var chunkT5OCRKPD_cjs = require('./chunk-T5OCRKPD.cjs');
-var chunkHIOMHITU_cjs = require('./chunk-HIOMHITU.cjs');
+var chunkLQFQ2UKU_cjs = require('./chunk-LQFQ2UKU.cjs');
 var chunkHPNIEYSJ_cjs = require('./chunk-HPNIEYSJ.cjs');
 var chunkT6YELZPJ_cjs = require('./chunk-T6YELZPJ.cjs');
 var chunkAVU4JOYM_cjs = require('./chunk-AVU4JOYM.cjs');
-var chunkN6K2CTSU_cjs = require('./chunk-N6K2CTSU.cjs');
+var chunkWIS4QRGK_cjs = require('./chunk-WIS4QRGK.cjs');
 var chunkVGBZWDMM_cjs = require('./chunk-VGBZWDMM.cjs');
 var chunkWCWZADR2_cjs = require('./chunk-WCWZADR2.cjs');
 var chunk7B3HK6TY_cjs = require('./chunk-7B3HK6TY.cjs');
@@ -81,11 +81,11 @@ var chunkHE3JJXIL_cjs = require('./chunk-HE3JJXIL.cjs');
 require('./chunk-AIA5UNQ5.cjs');
 var chunkG7227RTY_cjs = require('./chunk-G7227RTY.cjs');
 require('./chunk-XFBLUPKF.cjs');
-var chunkJM2H642B_cjs = require('./chunk-JM2H642B.cjs');
+var chunkBVRPDMB7_cjs = require('./chunk-BVRPDMB7.cjs');
 var chunkTZHK3LEW_cjs = require('./chunk-TZHK3LEW.cjs');
 var chunkTXTRTTG7_cjs = require('./chunk-TXTRTTG7.cjs');
 var chunk3WGRVDQR_cjs = require('./chunk-3WGRVDQR.cjs');
-var chunkOGEE23SP_cjs = require('./chunk-OGEE23SP.cjs');
+var chunkWRQBV7GU_cjs = require('./chunk-WRQBV7GU.cjs');
 var chunkFQSSVOVQ_cjs = require('./chunk-FQSSVOVQ.cjs');
 require('./chunk-S3TRSECD.cjs');
 var chunkND5D7GJB_cjs = require('./chunk-ND5D7GJB.cjs');
@@ -104,18 +104,18 @@ var chunkLCNHEYIM_cjs = require('./chunk-LCNHEYIM.cjs');
 var chunk5F6V5HHT_cjs = require('./chunk-5F6V5HHT.cjs');
 var chunkXLFGWNW4_cjs = require('./chunk-XLFGWNW4.cjs');
 var chunk65HKNZFG_cjs = require('./chunk-65HKNZFG.cjs');
-var chunk6SO2ZX3J_cjs = require('./chunk-6SO2ZX3J.cjs');
+var chunkDHIUMQLP_cjs = require('./chunk-DHIUMQLP.cjs');
 var chunkN4VHOTMK_cjs = require('./chunk-N4VHOTMK.cjs');
-var chunkZTC3EQFZ_cjs = require('./chunk-ZTC3EQFZ.cjs');
+var chunkS5KUYX3Z_cjs = require('./chunk-S5KUYX3Z.cjs');
 var chunkQW66UHWO_cjs = require('./chunk-QW66UHWO.cjs');
-var chunkYTXBU6QC_cjs = require('./chunk-YTXBU6QC.cjs');
+var chunkQBNR5IVM_cjs = require('./chunk-QBNR5IVM.cjs');
 var chunkJ2DI6RMR_cjs = require('./chunk-J2DI6RMR.cjs');
 require('./chunk-KJ22KE56.cjs');
 var chunkL3V3BYVS_cjs = require('./chunk-L3V3BYVS.cjs');
 var chunkNBZC6LOB_cjs = require('./chunk-NBZC6LOB.cjs');
 var chunk57FQGQJK_cjs = require('./chunk-57FQGQJK.cjs');
 var chunkRXDRYWVD_cjs = require('./chunk-RXDRYWVD.cjs');
-var chunkOUOEQZHY_cjs = require('./chunk-OUOEQZHY.cjs');
+var chunkSNHU2AI4_cjs = require('./chunk-SNHU2AI4.cjs');
 var chunk5CXJ5Z4C_cjs = require('./chunk-5CXJ5Z4C.cjs');
 var chunkZU5Q77OT_cjs = require('./chunk-ZU5Q77OT.cjs');
 
@@ -127,7 +127,7 @@ Object.defineProperty(exports, "TimeGrid", {
 });
 Object.defineProperty(exports, "TimePicker", {
   enumerable: true,
-  get: function () { return chunkNR346SKH_cjs.TimePicker; }
+  get: function () { return chunkYMDYDUBH_cjs.TimePicker; }
 });
 Object.defineProperty(exports, "Timeline", {
   enumerable: true,
@@ -151,7 +151,7 @@ Object.defineProperty(exports, "useTreeNav", {
 });
 Object.defineProperty(exports, "Slider", {
   enumerable: true,
-  get: function () { return chunkIRD6UXDK_cjs.Slider; }
+  get: function () { return chunkFVTCPERB_cjs.Slider; }
 });
 Object.defineProperty(exports, "Form", {
   enumerable: true,
@@ -163,27 +163,27 @@ Object.defineProperty(exports, "FormProvider", {
 });
 Object.defineProperty(exports, "Checkbox", {
   enumerable: true,
-  get: function () { return chunkRKG2Q2HT_cjs.Checkbox; }
+  get: function () { return chunkU7PFHQBN_cjs.Checkbox; }
 });
 Object.defineProperty(exports, "CheckboxGroup", {
   enumerable: true,
-  get: function () { return chunkJDRKYYXP_cjs.CheckboxGroup; }
+  get: function () { return chunkBZDXX6E3_cjs.CheckboxGroup; }
 });
 Object.defineProperty(exports, "MultiSwitch", {
   enumerable: true,
-  get: function () { return chunkBJYTI2ID_cjs.MultiSwitch; }
+  get: function () { return chunkZUQUL53P_cjs.MultiSwitch; }
 });
 Object.defineProperty(exports, "RadioGroup", {
   enumerable: true,
-  get: function () { return chunkUA2C2U3M_cjs.RadioGroup; }
+  get: function () { return chunkFPZYPD3N_cjs.RadioGroup; }
 });
 Object.defineProperty(exports, "Sidebar", {
   enumerable: true,
-  get: function () { return chunkLY7PZEF4_cjs.Sidebar; }
+  get: function () { return chunk6IBBAOQC_cjs.Sidebar; }
 });
 Object.defineProperty(exports, "useSidebar", {
   enumerable: true,
-  get: function () { return chunkLY7PZEF4_cjs.useSidebar; }
+  get: function () { return chunk6IBBAOQC_cjs.useSidebar; }
 });
 Object.defineProperty(exports, "Skeleton", {
   enumerable: true,
@@ -207,15 +207,15 @@ Object.defineProperty(exports, "StickyNote", {
 });
 Object.defineProperty(exports, "Table", {
   enumerable: true,
-  get: function () { return chunkPWLBHNOA_cjs.Table; }
+  get: function () { return chunkZ3NSPDTW_cjs.Table; }
 });
 Object.defineProperty(exports, "Tabs", {
   enumerable: true,
-  get: function () { return chunk3EIB7RPD_cjs.Tabs; }
+  get: function () { return chunk3Q4NSAEA_cjs.Tabs; }
 });
 Object.defineProperty(exports, "useTabs", {
   enumerable: true,
-  get: function () { return chunk3EIB7RPD_cjs.useTabs; }
+  get: function () { return chunk3Q4NSAEA_cjs.useTabs; }
 });
 Object.defineProperty(exports, "Profile", {
   enumerable: true,
@@ -271,7 +271,7 @@ Object.defineProperty(exports, "useNavbar", {
 });
 Object.defineProperty(exports, "OtpInput", {
   enumerable: true,
-  get: function () { return chunk6LOV75CN_cjs.OtpInput; }
+  get: function () { return chunkXK5WHQ3O_cjs.OtpInput; }
 });
 Object.defineProperty(exports, "Pagination", {
   enumerable: true,
@@ -279,7 +279,7 @@ Object.defineProperty(exports, "Pagination", {
 });
 Object.defineProperty(exports, "Pillbox", {
   enumerable: true,
-  get: function () { return chunkYAJYIRQL_cjs.Pillbox; }
+  get: function () { return chunkLLA33GKC_cjs.Pillbox; }
 });
 Object.defineProperty(exports, "Popover", {
   enumerable: true,
@@ -291,63 +291,63 @@ Object.defineProperty(exports, "usePopover", {
 });
 Object.defineProperty(exports, "JSON_FIELD_TYPES", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.JSON_FIELD_TYPES; }
+  get: function () { return chunkYMU3SS6D_cjs.JSON_FIELD_TYPES; }
 });
 Object.defineProperty(exports, "JsonEditor", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.JsonEditor; }
+  get: function () { return chunkYMU3SS6D_cjs.JsonEditor; }
 });
 Object.defineProperty(exports, "applyJsonEdit", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.applyJsonEdit; }
+  get: function () { return chunkYMU3SS6D_cjs.applyJsonEdit; }
 });
 Object.defineProperty(exports, "describeEdit", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.describeEdit; }
+  get: function () { return chunkYMU3SS6D_cjs.describeEdit; }
 });
 Object.defineProperty(exports, "findJsonConflicts", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.findJsonConflicts; }
+  get: function () { return chunkYMU3SS6D_cjs.findJsonConflicts; }
 });
 Object.defineProperty(exports, "getAtPath", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.getAtPath; }
+  get: function () { return chunkYMU3SS6D_cjs.getAtPath; }
 });
 Object.defineProperty(exports, "inferType", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.inferType; }
+  get: function () { return chunkYMU3SS6D_cjs.inferType; }
 });
 Object.defineProperty(exports, "parseKeyMap", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.parseKeyMap; }
+  get: function () { return chunkYMU3SS6D_cjs.parseKeyMap; }
 });
 Object.defineProperty(exports, "parsePath", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.parsePath; }
+  get: function () { return chunkYMU3SS6D_cjs.parsePath; }
 });
 Object.defineProperty(exports, "pathToString", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.pathToString; }
+  get: function () { return chunkYMU3SS6D_cjs.pathToString; }
 });
 Object.defineProperty(exports, "resolveKeyRule", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.resolveKeyRule; }
+  get: function () { return chunkYMU3SS6D_cjs.resolveKeyRule; }
 });
 Object.defineProperty(exports, "typeMatches", {
   enumerable: true,
-  get: function () { return chunkSCGE6DCE_cjs.typeMatches; }
+  get: function () { return chunkYMU3SS6D_cjs.typeMatches; }
 });
 Object.defineProperty(exports, "Switch", {
   enumerable: true,
-  get: function () { return chunkB5KK7NYP_cjs.Switch; }
+  get: function () { return chunkY52NXM73_cjs.Switch; }
 });
 Object.defineProperty(exports, "DatePicker", {
   enumerable: true,
-  get: function () { return chunkVUKIFFWK_cjs.DatePicker; }
+  get: function () { return chunkBZZDHDMK_cjs.DatePicker; }
 });
 Object.defineProperty(exports, "Input", {
   enumerable: true,
-  get: function () { return chunkLHNC42J3_cjs.Input; }
+  get: function () { return chunkIPNJMHJ3_cjs.Input; }
 });
 Object.defineProperty(exports, "Select", {
   enumerable: true,
@@ -419,19 +419,19 @@ Object.defineProperty(exports, "useMobileMenu", {
 });
 Object.defineProperty(exports, "FileBrowser", {
   enumerable: true,
-  get: function () { return chunkJV6RDIA6_cjs.FileBrowser; }
+  get: function () { return chunkT45XK5GN_cjs.FileBrowser; }
 });
 Object.defineProperty(exports, "FileBrowserNewFolder", {
   enumerable: true,
-  get: function () { return chunkJV6RDIA6_cjs.FileBrowserNewFolder; }
+  get: function () { return chunkT45XK5GN_cjs.FileBrowserNewFolder; }
 });
 Object.defineProperty(exports, "useFileBrowser", {
   enumerable: true,
-  get: function () { return chunkJV6RDIA6_cjs.useFileBrowser; }
+  get: function () { return chunkT45XK5GN_cjs.useFileBrowser; }
 });
 Object.defineProperty(exports, "validateFolderName", {
   enumerable: true,
-  get: function () { return chunkJV6RDIA6_cjs.validateFolderName; }
+  get: function () { return chunkT45XK5GN_cjs.validateFolderName; }
 });
 Object.defineProperty(exports, "FileUpload", {
   enumerable: true,
@@ -499,11 +499,11 @@ Object.defineProperty(exports, "useDropdown", {
 });
 Object.defineProperty(exports, "Editor", {
   enumerable: true,
-  get: function () { return chunkHIOMHITU_cjs.Editor; }
+  get: function () { return chunkLQFQ2UKU_cjs.Editor; }
 });
 Object.defineProperty(exports, "useEditor", {
   enumerable: true,
-  get: function () { return chunkHIOMHITU_cjs.useEditor; }
+  get: function () { return chunkLQFQ2UKU_cjs.useEditor; }
 });
 Object.defineProperty(exports, "THEME_STORAGE_KEY", {
   enumerable: true,
@@ -551,7 +551,7 @@ Object.defineProperty(exports, "Emoji", {
 });
 Object.defineProperty(exports, "EmojiSelect", {
   enumerable: true,
-  get: function () { return chunkN6K2CTSU_cjs.EmojiSelect; }
+  get: function () { return chunkWIS4QRGK_cjs.EmojiSelect; }
 });
 Object.defineProperty(exports, "Eyebrow", {
   enumerable: true,
@@ -575,7 +575,7 @@ Object.defineProperty(exports, "CodeView", {
 });
 Object.defineProperty(exports, "ColorPicker", {
   enumerable: true,
-  get: function () { return chunkJM2H642B_cjs.ColorPicker; }
+  get: function () { return chunkBVRPDMB7_cjs.ColorPicker; }
 });
 Object.defineProperty(exports, "Command", {
   enumerable: true,
@@ -595,7 +595,11 @@ Object.defineProperty(exports, "useAnimation", {
 });
 Object.defineProperty(exports, "Composer", {
   enumerable: true,
-  get: function () { return chunkOGEE23SP_cjs.Composer; }
+  get: function () { return chunkWRQBV7GU_cjs.Composer; }
+});
+Object.defineProperty(exports, "usePastePills", {
+  enumerable: true,
+  get: function () { return chunkWRQBV7GU_cjs.usePastePills; }
 });
 Object.defineProperty(exports, "Container", {
   enumerable: true,
@@ -727,11 +731,11 @@ Object.defineProperty(exports, "Heading", {
 });
 Object.defineProperty(exports, "Carousel", {
   enumerable: true,
-  get: function () { return chunk6SO2ZX3J_cjs.Carousel; }
+  get: function () { return chunkDHIUMQLP_cjs.Carousel; }
 });
 Object.defineProperty(exports, "useCarousel", {
   enumerable: true,
-  get: function () { return chunk6SO2ZX3J_cjs.useCarousel; }
+  get: function () { return chunkDHIUMQLP_cjs.useCarousel; }
 });
 Object.defineProperty(exports, "Accordion", {
   enumerable: true,
@@ -743,27 +747,27 @@ Object.defineProperty(exports, "useAccordion", {
 });
 Object.defineProperty(exports, "AccordionPanel", {
   enumerable: true,
-  get: function () { return chunkZTC3EQFZ_cjs.AccordionPanel; }
+  get: function () { return chunkS5KUYX3Z_cjs.AccordionPanel; }
 });
 Object.defineProperty(exports, "AccordionPanelContent", {
   enumerable: true,
-  get: function () { return chunkZTC3EQFZ_cjs.AccordionPanelContent; }
+  get: function () { return chunkS5KUYX3Z_cjs.AccordionPanelContent; }
 });
 Object.defineProperty(exports, "AccordionPanelSection", {
   enumerable: true,
-  get: function () { return chunkZTC3EQFZ_cjs.AccordionPanelSection; }
+  get: function () { return chunkS5KUYX3Z_cjs.AccordionPanelSection; }
 });
 Object.defineProperty(exports, "AccordionPanelTrigger", {
   enumerable: true,
-  get: function () { return chunkZTC3EQFZ_cjs.AccordionPanelTrigger; }
+  get: function () { return chunkS5KUYX3Z_cjs.AccordionPanelTrigger; }
 });
 Object.defineProperty(exports, "useAccordionPanel", {
   enumerable: true,
-  get: function () { return chunkZTC3EQFZ_cjs.useAccordionPanel; }
+  get: function () { return chunkS5KUYX3Z_cjs.useAccordionPanel; }
 });
 Object.defineProperty(exports, "useAccordionSection", {
   enumerable: true,
-  get: function () { return chunkZTC3EQFZ_cjs.useAccordionSection; }
+  get: function () { return chunkS5KUYX3Z_cjs.useAccordionSection; }
 });
 Object.defineProperty(exports, "AudioViewer", {
   enumerable: true,
@@ -771,7 +775,7 @@ Object.defineProperty(exports, "AudioViewer", {
 });
 Object.defineProperty(exports, "Autocomplete", {
   enumerable: true,
-  get: function () { return chunkYTXBU6QC_cjs.Autocomplete; }
+  get: function () { return chunkQBNR5IVM_cjs.Autocomplete; }
 });
 Object.defineProperty(exports, "useFloatingPosition", {
   enumerable: true,
@@ -799,7 +803,7 @@ Object.defineProperty(exports, "useEscapeKey", {
 });
 Object.defineProperty(exports, "useControllableState", {
   enumerable: true,
-  get: function () { return chunkOUOEQZHY_cjs.useControllableState; }
+  get: function () { return chunkSNHU2AI4_cjs.useControllableState; }
 });
 Object.defineProperty(exports, "Avatar", {
   enumerable: true,

package/dist/index.d.cts

@@ -64,7 +64,7 @@ export { OtpInput, OtpInputProps } from './otp-input.cjs';
 export { FileUpload, FileUploadContextValue, FileUploadDropzoneProps, FileUploadListProps, FileUploadProps, useFileUpload } from './file-upload.cjs';
 export { TimePicker, TimePickerProps } from './time-picker.cjs';
 export { Calendar, CalendarMode, CalendarProps, DateRange } from './calendar.cjs';
-export { Composer, ComposerProps } from './composer.cjs';
+export { C as Composer, a as ComposerProps, H as HeldPaste, P as PasteEventLike, U as UsePastePillsOptions, b as UsePastePillsResult, u as usePastePills } from './index-CDo7LyIB.cjs';
 export { Chart, ChartAreaProps, ChartBarData, ChartBarProps, ChartCommonProps, ChartDonutData, ChartDonutProps, ChartHorizontalBarProps, ChartLineProps, ChartPieData, ChartPieProps, ChartSeries, ChartSparklineProps, ChartStackedBarProps } from './chart.cjs';
 export { Editor, EditorAction, EditorContentProps, EditorContextValue, EditorProps, EditorSourceToggleProps, EditorToolbarProps, useEditor } from './editor.cjs';
 export { CodeView, CodeViewProps } from './code-view.cjs';
@@ -134,6 +134,39 @@ declare function sanitizeHref(href: string | undefined | null): string | undefin
  */
 declare function sanitizeHtml(html: string): string;
 
+/**
+ * One state slot that works controlled or uncontrolled.
+ *
+ * ---------------------------------------------------------------------------
+ * Why the value is tracked in a ref (fixed 5.32.0)
+ * ---------------------------------------------------------------------------
+ *
+ * This resolved a functional update against the RENDER CLOSURE's `value` and then
+ * handed React an already-computed value:
+ *
+ *     const nextValue = typeof next === "function" ? next(value) : next;
+ *     setUncontrolledValue(nextValue);
+ *
+ * So `setValue(fn)` twice in one batch had both calls compute from the same stale
+ * `value`, and **the first update was silently lost.** React's own `setState`
+ * updater form does not have that problem precisely because React resolves it
+ * against the latest state; passing a pre-computed value gives that up.
+ *
+ * Found by a hook test that paste-held two items inside one `act()` and got one.
+ * It is not an exotic case — any caller that loops, or handles two events in a
+ * batch, hits it, and the symptom is a dropped update with nothing to indicate one
+ * happened.
+ *
+ * The fix cannot be "pass the updater to React", because `onChange` has to be
+ * called with the resulting value and an updater must stay pure — React may invoke
+ * it twice (StrictMode), which would fire `onChange` twice. So the previous value
+ * comes from a ref that is re-synced from the authoritative `value` on every render
+ * and advanced on every set. Within a batch the ref carries intent; after a render
+ * the real value wins.
+ *
+ * A side effect worth having: `setValue` no longer depends on `value`, so it is
+ * stable for the life of the component.
+ */
 declare function useControllableState<T>(controlledValue: T | undefined, defaultValue: T, onChange?: (value: T) => void): [T, (value: T | ((prev: T) => T)) => void];
 
 declare function useOutsideClick(ref: RefObject<HTMLElement | null>, handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean, ignoreRef?: RefObject<HTMLElement | null>): void;

package/dist/index.d.ts

@@ -64,7 +64,7 @@ export { OtpInput, OtpInputProps } from './otp-input.js';
 export { FileUpload, FileUploadContextValue, FileUploadDropzoneProps, FileUploadListProps, FileUploadProps, useFileUpload } from './file-upload.js';
 export { TimePicker, TimePickerProps } from './time-picker.js';
 export { Calendar, CalendarMode, CalendarProps, DateRange } from './calendar.js';
-export { Composer, ComposerProps } from './composer.js';
+export { C as Composer, a as ComposerProps, H as HeldPaste, P as PasteEventLike, U as UsePastePillsOptions, b as UsePastePillsResult, u as usePastePills } from './index-CDo7LyIB.js';
 export { Chart, ChartAreaProps, ChartBarData, ChartBarProps, ChartCommonProps, ChartDonutData, ChartDonutProps, ChartHorizontalBarProps, ChartLineProps, ChartPieData, ChartPieProps, ChartSeries, ChartSparklineProps, ChartStackedBarProps } from './chart.js';
 export { Editor, EditorAction, EditorContentProps, EditorContextValue, EditorProps, EditorSourceToggleProps, EditorToolbarProps, useEditor } from './editor.js';
 export { CodeView, CodeViewProps } from './code-view.js';
@@ -134,6 +134,39 @@ declare function sanitizeHref(href: string | undefined | null): string | undefin
  */
 declare function sanitizeHtml(html: string): string;
 
+/**
+ * One state slot that works controlled or uncontrolled.
+ *
+ * ---------------------------------------------------------------------------
+ * Why the value is tracked in a ref (fixed 5.32.0)
+ * ---------------------------------------------------------------------------
+ *
+ * This resolved a functional update against the RENDER CLOSURE's `value` and then
+ * handed React an already-computed value:
+ *
+ *     const nextValue = typeof next === "function" ? next(value) : next;
+ *     setUncontrolledValue(nextValue);
+ *
+ * So `setValue(fn)` twice in one batch had both calls compute from the same stale
+ * `value`, and **the first update was silently lost.** React's own `setState`
+ * updater form does not have that problem precisely because React resolves it
+ * against the latest state; passing a pre-computed value gives that up.
+ *
+ * Found by a hook test that paste-held two items inside one `act()` and got one.
+ * It is not an exotic case — any caller that loops, or handles two events in a
+ * batch, hits it, and the symptom is a dropped update with nothing to indicate one
+ * happened.
+ *
+ * The fix cannot be "pass the updater to React", because `onChange` has to be
+ * called with the resulting value and an updater must stay pure — React may invoke
+ * it twice (StrictMode), which would fire `onChange` twice. So the previous value
+ * comes from a ref that is re-synced from the authoritative `value` on every render
+ * and advanced on every set. Within a batch the ref carries intent; after a render
+ * the real value wins.
+ *
+ * A side effect worth having: `setValue` no longer depends on `value`, so it is
+ * stable for the life of the component.
+ */
 declare function useControllableState<T>(controlledValue: T | undefined, defaultValue: T, onChange?: (value: T) => void): [T, (value: T | ((prev: T) => T)) => void];
 
 declare function useOutsideClick(ref: RefObject<HTMLElement | null>, handler: (event: MouseEvent | TouchEvent) => void, enabled?: boolean, ignoreRef?: RefObject<HTMLElement | null>): void;