@particle-academy/react-fancy 5.31.0 → 5.32.0

package/CHANGELOG.md

@@ -11,6 +11,68 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [5.32.0] - 2026-10-02
+
+### Added
+
+- **`usePastePills` — the paste-holding logic without a surface.**
+
+  ```ts
+  const pills = usePastePills({ threshold: 500, heldPastes, onHeldPastesChange });
+
+  function onPaste(e) {
+    if (pills.handlePaste(e)) return;   // it took the paste and called preventDefault
+    // ...your own handling
+  }
+  ```
+
+  Returns `heldPastes`, `handlePaste(event) => boolean`, `expand(id) => string | undefined`
+  (removes it and hands back the text for you to insert), `remove(id)` and `clear()`.
+
+  **It owns no DOM** — you render the pills. And `handlePaste` is **composable**: it
+  returns `true` only if it took the paste, having called `preventDefault()` itself,
+  and otherwise declines *without touching the event*, so a host whose own handler
+  already intercepts paste can ask "did you want this?" rather than hand over.
+
+  `HeldPaste` carries `id` and `text` and deliberately **no `length`** — it would be
+  `text.length` and nothing else, and a derived value stored beside its source is a
+  value that can disagree with it.
+
+  Exists because the estate that specified 5.31.0's `Composer` feature then
+  established that they cannot use `Composer` at all: their chat input is a
+  contenteditable rendering inline `[deal:42|Acme]` badges, which a textarea cannot
+  do. **`Composer` is now this hook's first caller** — one implementation rather than
+  two, because two copies of a rule drift and the copy nobody reads is the one that
+  rots.
+
+  **What you must DO: nothing.** `Composer`'s behaviour is unchanged and its tests
+  are the proof — all 15 from 5.31.0 pass untouched across the refactor.
+
+### Fixed
+
+- **`useControllableState` silently lost an update when two functional updates
+  batched.** It resolved `setValue(fn)` against the **render closure's** value and
+  handed React a pre-computed result, so two calls before a re-render both computed
+  from the same stale value and **the first was dropped**:
+
+  ```
+  setItems(c => [...c, "a"]);
+  setItems(c => [...c, "b"]);   // -> ["b"], not ["a", "b"]
+  ```
+
+  Most stateful components in this library use this hook, so the blast radius was
+  everything — but it only surfaces when a caller updates twice in one batch, which
+  is why it survived. No error, no warning: just less state than you asked for.
+
+  Found by a `usePastePills` test that held two pastes inside one `act()` and got
+  one. Four of the five new regression tests fail against the previous
+  implementation.
+
+  **What you must DO: nothing**, and one thing you may notice: **the setter is now
+  stable across renders.** It used to change identity on every update, which
+  invalidated any consumer `useCallback`/`useEffect` depending on it. If you were
+  relying on that churn to re-run an effect, you were relying on a bug.
+
 ## [5.31.0] - 2026-10-02
 
 ### Added

package/dist/accordion-panel.cjs

@@ -1,34 +1,34 @@
 'use strict';
 
-var chunkZTC3EQFZ_cjs = require('./chunk-ZTC3EQFZ.cjs');
-require('./chunk-OUOEQZHY.cjs');
+var chunkS5KUYX3Z_cjs = require('./chunk-S5KUYX3Z.cjs');
+require('./chunk-SNHU2AI4.cjs');
 require('./chunk-ZU5Q77OT.cjs');
 
 
 
 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; }
 });
 //# sourceMappingURL=accordion-panel.cjs.map
 //# sourceMappingURL=accordion-panel.cjs.map

package/dist/accordion-panel.js

@@ -1,5 +1,5 @@
-export { AccordionPanel, AccordionPanelContent, AccordionPanelSection, AccordionPanelTrigger, useAccordionPanel, useAccordionSection } from './chunk-I3RPL3GE.js';
-import './chunk-6FQGMVF2.js';
+export { AccordionPanel, AccordionPanelContent, AccordionPanelSection, AccordionPanelTrigger, useAccordionPanel, useAccordionSection } from './chunk-RUSRAKKA.js';
+import './chunk-EDYAXGUM.js';
 import './chunk-MMW2JGKZ.js';
 //# sourceMappingURL=accordion-panel.js.map
 //# sourceMappingURL=accordion-panel.js.map

package/dist/autocomplete.cjs

@@ -1,20 +1,20 @@
 'use strict';
 
-var chunkYTXBU6QC_cjs = require('./chunk-YTXBU6QC.cjs');
+var chunkQBNR5IVM_cjs = require('./chunk-QBNR5IVM.cjs');
 require('./chunk-J2DI6RMR.cjs');
 require('./chunk-KJ22KE56.cjs');
 require('./chunk-L3V3BYVS.cjs');
 require('./chunk-NBZC6LOB.cjs');
 require('./chunk-57FQGQJK.cjs');
 require('./chunk-RXDRYWVD.cjs');
-require('./chunk-OUOEQZHY.cjs');
+require('./chunk-SNHU2AI4.cjs');
 require('./chunk-ZU5Q77OT.cjs');
 
 
 
 Object.defineProperty(exports, "Autocomplete", {
   enumerable: true,
-  get: function () { return chunkYTXBU6QC_cjs.Autocomplete; }
+  get: function () { return chunkQBNR5IVM_cjs.Autocomplete; }
 });
 //# sourceMappingURL=autocomplete.cjs.map
 //# sourceMappingURL=autocomplete.cjs.map

package/dist/autocomplete.js

@@ -1,11 +1,11 @@
-export { Autocomplete } from './chunk-MIUSTEIV.js';
+export { Autocomplete } from './chunk-O2ZHORSC.js';
 import './chunk-MQ6VGG62.js';
 import './chunk-OL53XYHF.js';
 import './chunk-NRXK42LO.js';
 import './chunk-WHEXTDPV.js';
 import './chunk-RGANGU7X.js';
 import './chunk-JXE5XID6.js';
-import './chunk-6FQGMVF2.js';
+import './chunk-EDYAXGUM.js';
 import './chunk-MMW2JGKZ.js';
 //# sourceMappingURL=autocomplete.js.map
 //# sourceMappingURL=autocomplete.js.map

package/dist/carousel.cjs

@@ -1,34 +1,34 @@
 'use strict';
 
-var chunk6SO2ZX3J_cjs = require('./chunk-6SO2ZX3J.cjs');
-require('./chunk-OUOEQZHY.cjs');
+var chunkDHIUMQLP_cjs = require('./chunk-DHIUMQLP.cjs');
+require('./chunk-SNHU2AI4.cjs');
 require('./chunk-ZU5Q77OT.cjs');
 
 
 
 Object.defineProperty(exports, "Carousel", {
   enumerable: true,
-  get: function () { return chunk6SO2ZX3J_cjs.Carousel; }
+  get: function () { return chunkDHIUMQLP_cjs.Carousel; }
 });
 Object.defineProperty(exports, "CarouselControls", {
   enumerable: true,
-  get: function () { return chunk6SO2ZX3J_cjs.CarouselControls; }
+  get: function () { return chunkDHIUMQLP_cjs.CarouselControls; }
 });
 Object.defineProperty(exports, "CarouselPanels", {
   enumerable: true,
-  get: function () { return chunk6SO2ZX3J_cjs.CarouselPanels; }
+  get: function () { return chunkDHIUMQLP_cjs.CarouselPanels; }
 });
 Object.defineProperty(exports, "CarouselSlide", {
   enumerable: true,
-  get: function () { return chunk6SO2ZX3J_cjs.CarouselSlide; }
+  get: function () { return chunkDHIUMQLP_cjs.CarouselSlide; }
 });
 Object.defineProperty(exports, "CarouselSteps", {
   enumerable: true,
-  get: function () { return chunk6SO2ZX3J_cjs.CarouselSteps; }
+  get: function () { return chunkDHIUMQLP_cjs.CarouselSteps; }
 });
 Object.defineProperty(exports, "useCarousel", {
   enumerable: true,
-  get: function () { return chunk6SO2ZX3J_cjs.useCarousel; }
+  get: function () { return chunkDHIUMQLP_cjs.useCarousel; }
 });
 //# sourceMappingURL=carousel.cjs.map
 //# sourceMappingURL=carousel.cjs.map

package/dist/carousel.js

@@ -1,5 +1,5 @@
-export { Carousel, CarouselControls, CarouselPanels, CarouselSlide, CarouselSteps, useCarousel } from './chunk-RFLPFQFF.js';
-import './chunk-6FQGMVF2.js';
+export { Carousel, CarouselControls, CarouselPanels, CarouselSlide, CarouselSteps, useCarousel } from './chunk-BMTTSBHF.js';
+import './chunk-EDYAXGUM.js';
 import './chunk-MMW2JGKZ.js';
 //# sourceMappingURL=carousel.js.map
 //# sourceMappingURL=carousel.js.map

package/dist/checkbox-group.cjs

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunkJDRKYYXP_cjs = require('./chunk-JDRKYYXP.cjs');
+var chunkBZDXX6E3_cjs = require('./chunk-BZDXX6E3.cjs');
 require('./chunk-XKDW6B7X.cjs');
 require('./chunk-BBOIFV27.cjs');
 require('./chunk-YLGTDBB2.cjs');
 require('./chunk-KJ22KE56.cjs');
 require('./chunk-L3V3BYVS.cjs');
-require('./chunk-OUOEQZHY.cjs');
+require('./chunk-SNHU2AI4.cjs');
 require('./chunk-ZU5Q77OT.cjs');
 
 
 
 Object.defineProperty(exports, "CheckboxGroup", {
   enumerable: true,
-  get: function () { return chunkJDRKYYXP_cjs.CheckboxGroup; }
+  get: function () { return chunkBZDXX6E3_cjs.CheckboxGroup; }
 });
 //# sourceMappingURL=checkbox-group.cjs.map
 //# sourceMappingURL=checkbox-group.cjs.map

package/dist/checkbox-group.js

@@ -1,10 +1,10 @@
-export { CheckboxGroup } from './chunk-JP4C3ROX.js';
+export { CheckboxGroup } from './chunk-FNJDMGJ3.js';
 import './chunk-KKWNKBKR.js';
 import './chunk-5MU6X3KO.js';
 import './chunk-GFYSELJF.js';
 import './chunk-OL53XYHF.js';
 import './chunk-NRXK42LO.js';
-import './chunk-6FQGMVF2.js';
+import './chunk-EDYAXGUM.js';
 import './chunk-MMW2JGKZ.js';
 //# sourceMappingURL=checkbox-group.js.map
 //# sourceMappingURL=checkbox-group.js.map

package/dist/checkbox.cjs

@@ -1,17 +1,17 @@
 'use strict';
 
-var chunkRKG2Q2HT_cjs = require('./chunk-RKG2Q2HT.cjs');
+var chunkU7PFHQBN_cjs = require('./chunk-U7PFHQBN.cjs');
 require('./chunk-YLGTDBB2.cjs');
 require('./chunk-KJ22KE56.cjs');
 require('./chunk-L3V3BYVS.cjs');
-require('./chunk-OUOEQZHY.cjs');
+require('./chunk-SNHU2AI4.cjs');
 require('./chunk-ZU5Q77OT.cjs');
 
 
 
 Object.defineProperty(exports, "Checkbox", {
   enumerable: true,
-  get: function () { return chunkRKG2Q2HT_cjs.Checkbox; }
+  get: function () { return chunkU7PFHQBN_cjs.Checkbox; }
 });
 //# sourceMappingURL=checkbox.cjs.map
 //# sourceMappingURL=checkbox.cjs.map

package/dist/checkbox.js

@@ -1,8 +1,8 @@
-export { Checkbox } from './chunk-H6F6ZWAG.js';
+export { Checkbox } from './chunk-4HRD4S25.js';
 import './chunk-GFYSELJF.js';
 import './chunk-OL53XYHF.js';
 import './chunk-NRXK42LO.js';
-import './chunk-6FQGMVF2.js';
+import './chunk-EDYAXGUM.js';
 import './chunk-MMW2JGKZ.js';
 //# sourceMappingURL=checkbox.js.map
 //# sourceMappingURL=checkbox.js.map

package/dist/{chunk-TQFQUNV3.js → chunk-2KAJ4L7C.js}

@@ -1,4 +1,4 @@
-import { useControllableState } from './chunk-6FQGMVF2.js';
+import { useControllableState } from './chunk-EDYAXGUM.js';
 import { cn } from './chunk-MMW2JGKZ.js';
 import { createContext, useState, useMemo, useRef, useCallback, useEffect, Fragment as Fragment$1, useContext } from 'react';
 import { Loader2, ChevronRight, Search, X, ArrowUp, ArrowDown, Pencil, CircleAlert, RotateCw, FolderPlus } from 'lucide-react';
@@ -1079,5 +1079,5 @@ var FileBrowser = Object.assign(FileBrowserRoot, {
 });
 
 export { FileBrowser, FileBrowserNewFolder, useFileBrowser, validateFolderName };
-//# sourceMappingURL=chunk-TQFQUNV3.js.map
-//# sourceMappingURL=chunk-TQFQUNV3.js.map
+//# sourceMappingURL=chunk-2KAJ4L7C.js.map
+//# sourceMappingURL=chunk-2KAJ4L7C.js.map