@lotics/ui 44.0.0 → 44.1.0

package/docs/catalog.md

@@ -2036,6 +2036,16 @@ component rather than showing it at zero.
   `Popover` otherwise. A popover's own anchored-vs-sheet presentation is NOT one of them —
   `PopoverContent` reads this itself and takes no prop. Everything spatial wants
   `useContainerSize`.
+- **`use_debounced_callback`** — `useDebouncedCallback(fn, ms)`: run `fn` only once its caller
+  has stopped calling, returning the debounced function plus `.cancel()`. The latest `fn` always
+  wins (held by ref, so a new closure each render never resets the timer) and a pending call is
+  dropped on unmount. **Reach for it whenever typing drives a request** — a search box wired
+  straight to a query param spends one round trip per letter, and on a list screen each letter
+  is several (the page, its count, any sibling query). Keep the input's own value in state and
+  debounce the COMMIT to a second value: the two are genuinely different things, and a screen
+  usually needs both (what is being typed vs. what the results answer). `.cancel()` is for when
+  a trailing call has been overtaken — a picked option, a cleared box. `Combobox` searches
+  through it.
 - **`use_async_fn`** — `useAsyncFn`: wrap an async function into a manual-trigger mutation —
   `[run, {loading, data, error}]`, unmount-safe, the error lands in state AND rethrows; the
   pending-state engine for a submit/download/upload action.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lotics/ui",
-  "version": "44.0.0",
+  "version": "44.1.0",
   "type": "module",
   "exports": {
     "./vite": {
@@ -262,6 +262,7 @@
       "default": "./src/wave_avatar.web.tsx"
     },
     "./use_async_fn": "./src/use_async_fn.ts",
+    "./use_debounced_callback": "./src/use_debounced_callback.ts",
     "./use_form": "./src/use_form.ts",
     "./scroll_to_bottom": "./src/scroll_to_bottom.tsx",
     "./animation_fade_in": "./src/animation_fade_in.tsx",