@ai-matrx/kit 0.5.0

package/CHANGELOG.md

@@ -0,0 +1,132 @@
+# Changelog
+
+## 0.5.0 — 2026-08-29
+
+- Added four subpaths, ported from their Matrx frontend originals:
+  - `@ai-matrx/kit/idb-store` — the typed, versioned IndexedDB wrapper
+    (`DBStoreManager` / `PublicStoreManager` / `FeatureStore`): declare object
+    stores and indexes in a `setupStores` upgrade hook; every operation resolves
+    `{ data, error }` and never throws, before or after init. Carries the `idb`
+    runtime dependency (the typed wrapper is the engine). The original's
+    static-field singleton convention is replaced by `getIdbStoreSingleton(key,
+    create)`, backed by `globalThis` under
+    `Symbol.for("ai-matrx.kit.idb-store-state")` so the ESM and CJS bundle
+    graphs share one instance registry (proven cross-graph by the tarball
+    canary).
+  - `@ai-matrx/kit/color-util` — the bidirectional Tailwind-token color
+    mapping, zero dependencies: `getColorFromTailwind` / fuzzy
+    `formatTailwindColor` (token → hex, with the verbatim palette table) and
+    `findNearestTailwindColor` (color → token). The original required a colord
+    instance; the seam is now structural — any `{ delta(hex) }` object still
+    works verbatim, and plain hex/`rgb()` strings are measured by a built-in
+    sRGB→Lab→CIEDE2000 engine reproducing the colord lab plugin's exact math
+    (cross-checked bit-identical against colord in the test suite). Also ports
+    the pure `format*` input normalizers and `createColorNormalizer({ isValid })`
+    (the `normalizeColorInput` waterfall with the validity check injected). The
+    one-line colord passthroughs (`isValidColor`, `convertColor`,
+    `getColorInfo`, `getColorString`, `getColorFormats`) deliberately stay
+    host-side — packaging them would drag colord in as a runtime dependency.
+  - `@ai-matrx/kit/react-tree` — `treeContainsComponent`, the safe React
+    children-tree scan (elements, arrays, fragments, iterables, portals; skips
+    non-renderable children with a loud dev scream instead of crashing at the
+    probe). Now the ONE home of the scanner: the `/confirm` subpath's internal
+    copy was removed and its alert-dialog imports this module.
+  - `@ai-matrx/kit/qr` — the platform QR decoder, verbatim: File/Blob,
+    `ImageData`, or `<video>`/`<canvas>` in; the encoded text or `null` out.
+    Native `BarcodeDetector` first with graceful capability detection
+    (`hasNativeQrDetector`); the `jsqr` runtime dependency is lazily imported
+    only when the native detector is absent.
+- Fixed a defect present in the original `treeContainsComponent` (and the
+  0.3.0 confirm-internal copy): a React portal passed as a child is a valid
+  child, but it fell through to the non-renderable branch — a false-positive
+  dev scream, and the portal's content was never scanned. Portals are now
+  recognized and traversed.
+- Fixed a defect present in the original `FeatureStore`: the constructor's
+  fire-and-forget `initDB()` left a failed `openDB` (e.g. private-mode storage
+  denial) as an unhandled promise rejection on top of the logged error. The
+  rejection is now absorbed after `initDB`'s own loud log; operations still
+  report "Database not initialized" through their `AsyncResult`.
+- Removed (deliberate divergence, logged here rather than silently): the
+  unconditional debug `console.log`s the original color utilities emitted on
+  every `formatLabString` / `formatLchString` / `normalizeColorInput` call.
+  Matching and return behavior are unchanged.
+
+## 0.4.0 — 2026-08-29
+
+- Added five subpaths, ported from their Matrx frontend originals:
+  - `@ai-matrx/kit/invalidation` — the zero-import name-keyed callback registry that
+    breaks import edges into heavy chunk clusters. Generic over names: the app-specific
+    key constants stay in the host. Registry state lives on `globalThis` under
+    `Symbol.for("ai-matrx.kit.invalidation-registry")` so the ESM and CJS bundle graphs
+    share one callback map (proven by the tarball canary's cross-graph register/fire).
+  - `@ai-matrx/kit/delimiter-guard` — keeps a stray streamed `$$` or `[` from swallowing
+    a section of markdown. Verbatim port; the app's `captureError` import inverted to an
+    optional injected `capture` sink on `reportDelimiterViolations` (payload shape
+    preserved exactly; console-only loud recovery without a sink).
+  - `@ai-matrx/kit/json-format` — JSON detection (fences, surrounding prose, tolerant
+    JSON5 tier, half-streamed/unterminated fences) + the three-style writer
+    (minify / width-aware compact / pretty, key sorting, fence add/strip/preserve).
+    Verbatim port incl. the original test suite; carries the `json5` runtime dependency
+    (tolerant parsing is the product) and its own `JsonValue` types so it stands alone.
+  - `@ai-matrx/kit/idle-scheduler` — priority-aware deferred execution
+    (load → paint → true browser idle, with the hidden-tab and no-registration-page
+    fixes) plus the four React hooks. Scheduler state moved to `globalThis` under
+    `Symbol.for("ai-matrx.kit.idle-scheduler-state")` (dual-graph rule); the
+    `window.__idleSched` diagnostics probe now installs on first use instead of at
+    import (entry points stay import-inert).
+  - `@ai-matrx/kit/url-state` — the canonical URL-state core: `useUrlState` + codecs,
+    `useMirroredUrlState`, `useUrlSearchParams`, `commitUrlParams`,
+    `historyModeForParamChange`. The original imports nothing from `next/navigation`
+    (History API + sync event) and that default is ported byte-identically; new
+    OPTIONAL `setUrlStateRouter({ push, replace, getLocation? })` seam for hosts whose
+    router must own the writes, stored on `globalThis` under
+    `Symbol.for("ai-matrx.kit.url-state-router")`.
+- Fixed a defect present in the original idle scheduler: a task registered WHILE the
+  flush loop was running landed back in the queue and silently never ran (the code's
+  own comment promised it would be scheduled post-flush). Late-during-flush
+  registrations now drain through the deferred chain after the flush completes.
+- Fixed the "use client" stamping policy: the banner previously led EVERY dist chunk,
+  which turns a pure module's exports into client references the moment a React Server
+  Component imports it. The build now stamps only React-touching chunks (autosave,
+  latest-request, clipboard, drafts, confirm, toast, idle-scheduler, url-state, index);
+  the pure chunks (search-scoring, concurrency, text-case, invalidation,
+  delimiter-guard, json-format) ship unstamped and are RSC-safe.
+
+## 0.3.0 — 2026-08-29
+
+- Added `@ai-matrx/kit/confirm` — the browser-dialog replacement, ported from the Matrx
+  frontend confirm-dialog system: imperative `await confirm({...})` through a
+  mount-once `<ConfirmDialogHost/>` (pre-mount calls queue, concurrent calls present
+  sequentially, no host means the promise stays pending — never a silent default), plus
+  the declarative `<ConfirmDialog/>` for flows where in-dialog busy state matters. The
+  Radix alert-dialog wrapper is inlined; `@radix-ui/react-alert-dialog` and
+  `tailwind-merge` are this subpath's runtime dependencies. Styling keeps the Matrx
+  Tailwind semantic-token classes verbatim; hosts on other design systems override via
+  `className` / `contentClassName` (last-wins merge). The busy spinner is one inlined
+  SVG (lucide `loader-circle` v1.22.0) instead of a lucide-react dependency.
+- Added `@ai-matrx/kit/toast` — the captured sonner wrapper as a factory:
+  `createMatrxToast({ toast, capture? })` returns a drop-in `toast` whose
+  `.error`/`.warning` also feed the injected capture sink (exact original payload
+  shape), plus `toastErrorAlreadyCaptured`. sonner is never imported — the host passes
+  its own `toast` object in and the input is typed structurally; the `sonner` peer is
+  optional and advisory-only.
+
+## 0.2.0 — 2026-08-28
+
+- Added four subpaths, ported verbatim from their Matrx frontend originals:
+  `/search-scoring` (relevance-weighted ranking), `/concurrency` (bounded worker
+  pool), `/text-case` (acronym-aware formatter), and `/drafts` (`useDurableDraft`
+  + the local-drafts store, with its original test suite).
+
+## 0.1.0 — 2026-08-28
+
+- Created the package with the first three subpaths, ported from the Matrx frontend
+  where each primitive originated: `useAutosave`, `useLatestRequest`, `useClipboard`
+  (toast coupling inverted to an injected notifier).
+- Fixed a defect present in the original `useAutosave`: a failed save's re-queued
+  payload was drained again immediately, producing an unbounded retry loop against a
+  persistently failing save. The package re-queues for the NEXT schedule/flush, exactly
+  as the status contract promises.
+- React >=18 peer, zero dependencies; ESM + CommonJS with `"use client"` stamped on
+  built chunks; the release gate installs the packed tarball into an empty project and
+  loads every entry point through both `import` and `require`.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AI Matrix Engine
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,72 @@
+# @ai-matrx/kit
+
+The always-include AI Matrx kit: the little primitives every Matrx application speaks,
+one capability per subpath, tree-shaken to what you use. React is the only required
+peer; only four subpaths carry runtime dependencies, each because the dependency IS
+the capability: `/confirm` (`@radix-ui/react-alert-dialog` + `tailwind-merge` — its
+product is the dialog), `/json-format` (`json5` — tolerant parsing is the feature),
+`/idb-store` (`idb` — the typed IndexedDB wrapper is the engine), and `/qr` (`jsqr`,
+loaded lazily only when the browser has no native `BarcodeDetector`).
+
+```bash
+npm install @ai-matrx/kit
+```
+
+| Subpath | Export | What it does |
+|---|---|---|
+| `@ai-matrx/kit/autosave` | `useAutosave` | Debounced autosave with in-flight coalescing, a UI status (`idle/unsaved/saving/saved/error`), loud non-throwing failures that re-queue the payload, and flush-on-unmount so no keystroke is ever lost. |
+| `@ai-matrx/kit/latest-request` | `useLatestRequest` | Makes a superseded async response impossible to apply: claim an attempt, then check the predicate before every state write after an `await`. Kills the out-of-order-response bug (the wrong record under a confident label) at the only moment that matters — apply time. Render-stable by construction. |
+| `@ai-matrx/kit/clipboard` | `useClipboard` | Copy/paste text, links, and images with the browser quirks solved: canvas→PNG re-encode for image copy, Safari `clipboard.read` feature detection, param-stripping link copy. Notifier injected — wrap your own toast. |
+
+| `@ai-matrx/kit/search-scoring` | `filterAndSortBySearch`, `computeSearchScore`, `matchesSearch`, `idMatchesQuery` | Relevance-weighted search ranking — title above description, exact above prefix above includes, pasted-UUID matching — instead of the naive `.includes()` filter. |
+| `@ai-matrx/kit/concurrency` | `runWithConcurrency` | Bounded worker pool over an array with per-item failure isolation and a cooperative `shouldStart()` cancel hook. |
+| `@ai-matrx/kit/text-case` | `formatText`, `createFormatter` | Acronym-aware normalization of messy DB/API strings into title/sentence case with word-replacement overrides. |
+| `@ai-matrx/kit/drafts` | `useDurableDraft` + the local-drafts store | User-authored text that survives anything: write-through localStorage drafts, restore on mount, key-change adoption, cleared only after content durably landed. |
+| `@ai-matrx/kit/confirm` | `confirm`, `ConfirmDialogHost`, `ConfirmDialog` | The `window.confirm` replacement, both shapes: mount `<ConfirmDialogHost/>` once at app root, then `await confirm({ title, variant: "destructive" })` from anywhere (pre-mount calls queue; concurrent calls present one at a time) — or the declarative `<ConfirmDialog/>` when in-dialog busy state matters. Bundles `@radix-ui/react-alert-dialog`; Tailwind semantic-token styling, overridable via `className`/`contentClassName`. |
+| `@ai-matrx/kit/toast` | `createMatrxToast` | The captured sonner wrapper as a factory: pass your sonner `toast` in, get a drop-in `toast` back whose `.error`/`.warning` also feed your injected error-capture sink, plus `toastErrorAlreadyCaptured` for notices whose failure was already captured upstream. No sonner import — the peer is advisory-only. |
+| `@ai-matrx/kit/invalidation` | `registerInvalidationCallback`, `fireInvalidation` | Zero-import, name-keyed callback registry that breaks import edges into heavy chunk clusters: the heavy cluster registers at its own module init, the ubiquitous module fires by name. Unregistered names are a deliberate no-op; a throwing callback screams and never breaks the caller. Keep your key constants in ONE host module. |
+| `@ai-matrx/kit/delimiter-guard` | `guardMarkdownDelimiters` (+ `guardMathDelimiters`, `guardRunawayLinks`, `reportDelimiterViolations`) | Keeps one stray streamed delimiter from swallowing a whole section: a `$$` that would turn prose into a red KaTeX error span, or an unclosed `[` that would turn a section into one giant link, gets invisibly neutralized while real math and links keep rendering. Pure; report violations loudly via the optional injected capture sink. |
+| `@ai-matrx/kit/json-format` | `detectJson`, `formatJsonText`, `stringifyJson` | "Is this text JSON, and what shape should it be in?" Detection survives code fences, surrounding prose, and tolerant (JSON5) input — `looksLikeJson` gates offering, `ok` gates running. The writer does `minify` / width-aware `compact` (inline + pack) / `pretty`, key sorting, fence add/strip/preserve. Never throws, never mangles text it did not parse. |
+| `@ai-matrx/kit/idle-scheduler` | `useIdleTask`, `useIdleReady`, `useIdleGate`, `useIdleRegister` + `registerIdleTask`, `onFlushComplete`, `whenPageIdle` | Priority-aware deferred execution: work waits for document load → paint → true browser idle (`scheduler.postTask` / `requestIdleCallback` / MessageChannel fallback, hidden tabs still flush), then runs 1-first…5-last. Zero re-renders to register; one re-render for the ready signal. |
+| `@ai-matrx/kit/url-state` | `useUrlState` + codecs, `useMirroredUrlState`, `useUrlSearchParams`, `commitUrlParams` | The URL as the source of truth for view state: refresh, copied links, and Back/Forward reproduce the same view. Codecs (string/enum/boolean/positive-integer/JSON) omit defaults so pristine URLs stay clean; discrete decisions push, high-frequency text replaces; every write notifies every other URL-backed control on the page. |
+| `@ai-matrx/kit/idb-store` | `DBStoreManager`, `PublicStoreManager`, `FeatureStore`, `getIdbStoreSingleton` | Typed, versioned IndexedDB stores over `idb`: subclass, declare your object stores/indexes in `setupStores`, and every operation resolves `{ data, error }` — never throws, before or after init. Hold each store's one instance with `getIdbStoreSingleton(key, create)` (a `globalThis` slot, so the ESM and CJS graphs share it). |
+| `@ai-matrx/kit/color-util` | `findNearestTailwindColor`, `getColorFromTailwind`, `formatTailwindColor`, `format*` normalizers, `createColorNormalizer`, `tailwindColors` | The bidirectional Tailwind-token color mapping with zero dependencies: token → hex lookups (including fuzzy input like `"skyblue598"`), and hex/`rgb()` → nearest token by perceptual CIEDE2000 distance (bit-identical to the colord lab plugin; a colord instance also plugs straight into the structural `{ delta(hex) }` seam). Plus the pure paste-anything input normalizers and the injected-validity `normalizeColorInput` waterfall. |
+| `@ai-matrx/kit/react-tree` | `treeContainsComponent` | Safe React children-tree scan for optional a11y children (is a `DialogDescription` anywhere under these children?): walks elements, arrays, fragments, iterables, and portals by hand, and SKIPS a non-renderable child with a loud dev scream instead of crashing at the probe like `React.Children.toArray` would. |
+| `@ai-matrx/kit/qr` | `decodeQrFromImageFile`, `decodeQrFromElement`, `decodeQrFromImageData`, `hasNativeQrDetector` | THE QR decoder, in memory and never uploaded: a pasted screenshot, a dropped file, or a live `<video>`/`<canvas>` frame in; the encoded text (or `null`) out. Native `BarcodeDetector` first; the pure-JS `jsqr` fallback is lazily imported only in browsers that lack it. |
+
+More subpaths are on the roadmap: copy-for-ai.
+
+## Host wiring: `/url-state`
+
+No wiring is required. The module writes through the History API
+(`history.pushState`/`replaceState`) and dispatches its own sync event — this
+is exactly how it runs inside the Next.js App Router host it was extracted
+from; do NOT pass the Next.js router. Inject a router only when your host's
+router must observe or perform the URL writes (react-router, a memory router
+in tests, a native shell):
+
+```ts
+import { setUrlStateRouter } from "@ai-matrx/kit/url-state";
+
+setUrlStateRouter({
+  push: (url) => myRouter.navigate(url),               // full relative URL: pathname?query#hash
+  replace: (url) => myRouter.navigate(url, { replace: true }),
+  // Optional: where the current URL is read from (default: window.location)
+  getLocation: () => ({ pathname, search, hash }),
+});
+```
+
+Call it once at app boot (`setUrlStateRouter(null)` removes it). With no
+router injected, behavior is byte-identical to the Matrx frontend original.
+
+## Design
+
+- One package, many subpaths — you always include the kit; you only bundle what you import.
+- Injected hosts (the clipboard notifier), opinionated behavior (the autosave status
+  contract, the apply-time guard). The opinions are the product.
+- ESM + CommonJS conditions with matching declarations, proven from the packed tarball.
+  The `"use client"` boundary is stamped per chunk: React-touching subpaths carry it,
+  pure ones (search-scoring, concurrency, text-case, invalidation, delimiter-guard,
+  json-format, idb-store, color-util, react-tree, qr) ship unstamped and RSC-safe.
+
+MIT © AI Matrx

package/dist/autosave.cjs

@@ -0,0 +1,92 @@
+"use client";
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/autosave.ts
+var autosave_exports = {};
+__export(autosave_exports, {
+  useAutosave: () => useAutosave
+});
+module.exports = __toCommonJS(autosave_exports);
+var import_react = require("react");
+function useAutosave(opts) {
+  const { save, debounceMs = 900 } = opts;
+  const [status, setStatus] = (0, import_react.useState)("idle");
+  const [lastSavedAt, setLastSavedAt] = (0, import_react.useState)(null);
+  const pendingRef = (0, import_react.useRef)(null);
+  const timerRef = (0, import_react.useRef)(null);
+  const savingRef = (0, import_react.useRef)(false);
+  const saveRef = (0, import_react.useRef)(save);
+  (0, import_react.useEffect)(() => {
+    saveRef.current = save;
+  });
+  async function saveNow() {
+    if (savingRef.current) return;
+    const pending = pendingRef.current;
+    if (!pending) return;
+    pendingRef.current = null;
+    savingRef.current = true;
+    setStatus("saving");
+    let failed = false;
+    try {
+      const res = await saveRef.current(pending.value);
+      if (res.error) {
+        failed = true;
+        pendingRef.current = pendingRef.current ?? pending;
+        setStatus("error");
+      } else {
+        setLastSavedAt(/* @__PURE__ */ new Date());
+        setStatus(pendingRef.current ? "unsaved" : "saved");
+      }
+    } catch {
+      failed = true;
+      pendingRef.current = pendingRef.current ?? pending;
+      setStatus("error");
+    } finally {
+      savingRef.current = false;
+      if (pendingRef.current && !failed) void saveNow();
+    }
+  }
+  function schedule(value) {
+    pendingRef.current = { value };
+    setStatus("unsaved");
+    if (timerRef.current) clearTimeout(timerRef.current);
+    timerRef.current = setTimeout(() => void saveNow(), debounceMs);
+  }
+  function flush() {
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    void saveNow();
+  }
+  (0, import_react.useEffect)(() => {
+    return () => {
+      if (timerRef.current) clearTimeout(timerRef.current);
+      const pending = pendingRef.current;
+      if (pending && !savingRef.current) {
+        pendingRef.current = null;
+        void saveRef.current(pending.value);
+      }
+    };
+  }, []);
+  return { status, lastSavedAt, schedule, flush };
+}
+//# sourceMappingURL=autosave.cjs.map

package/dist/autosave.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/autosave.ts"],"sourcesContent":["// A small, generic autosave primitive: debounce a payload, persist it through a\n// caller-supplied async save, and expose a status a UI can show (\"Saving…\" /\n// \"Saved\" / \"Unsaved changes\" / error). Entity-agnostic — the caller owns WHAT\n// to save (the save fn) and WHAT the payload is; this owns the debounce, the\n// in-flight coalescing, the status, and the flush-on-unmount so no keystroke is\n// ever lost. (Notes have their own coupled version; this is the reusable one.)\n// Never throws: the save fn returns `{ error }` (supabase-service style) and a\n// non-null error flips status to \"error\" and re-queues, so a blocked write is\n// loud, not silent.\n// React Compiler is on: no manual useMemo / useCallback — plain closures.\n\n\"use client\";\n\nimport { useEffect, useRef, useState } from \"react\";\n\nexport type AutosaveStatus = \"idle\" | \"unsaved\" | \"saving\" | \"saved\" | \"error\";\n\nexport interface UseAutosaveResult<T> {\n  status: AutosaveStatus;\n  lastSavedAt: Date | null;\n  /** Queue a payload and (re)start the debounce. */\n  schedule: (value: T) => void;\n  /** Cancel the debounce and save the pending payload immediately. */\n  flush: () => void;\n}\n\nexport function useAutosave<T>(opts: {\n  save: (value: T) => Promise<{ error: string | null }>;\n  debounceMs?: number;\n}): UseAutosaveResult<T> {\n  const { save, debounceMs = 900 } = opts;\n  const [status, setStatus] = useState<AutosaveStatus>(\"idle\");\n  const [lastSavedAt, setLastSavedAt] = useState<Date | null>(null);\n\n  const pendingRef = useRef<{ value: T } | null>(null);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const savingRef = useRef(false);\n  // Keep the latest save fn without threading it through closures (updated in an\n  // effect, never during render).\n  const saveRef = useRef(save);\n  useEffect(() => {\n    saveRef.current = save;\n  });\n\n  async function saveNow(): Promise<void> {\n    if (savingRef.current) return; // a later debounce flush picks up new edits\n    const pending = pendingRef.current;\n    if (!pending) return;\n    pendingRef.current = null;\n    savingRef.current = true;\n    setStatus(\"saving\");\n    let failed = false;\n    try {\n      const res = await saveRef.current(pending.value);\n      if (res.error) {\n        // Re-queue so the NEXT schedule/flush retries; surface loudly.\n        failed = true;\n        pendingRef.current = pendingRef.current ?? pending;\n        setStatus(\"error\");\n      } else {\n        setLastSavedAt(new Date());\n        setStatus(pendingRef.current ? \"unsaved\" : \"saved\");\n      }\n    } catch {\n      failed = true;\n      pendingRef.current = pendingRef.current ?? pending;\n      setStatus(\"error\");\n    } finally {\n      savingRef.current = false;\n      // If edits arrived mid-save, drain them promptly. NEVER drain after a\n      // failure: the re-queued payload waits for the next schedule/flush —\n      // draining it here is an unbounded immediate-retry loop against a\n      // persistently failing save. (The matrx-frontend original has exactly\n      // that loop; it dies with the original at the adoption swap.)\n      if (pendingRef.current && !failed) void saveNow();\n    }\n  }\n\n  function schedule(value: T): void {\n    pendingRef.current = { value };\n    setStatus(\"unsaved\");\n    if (timerRef.current) clearTimeout(timerRef.current);\n    timerRef.current = setTimeout(() => void saveNow(), debounceMs);\n  }\n\n  function flush(): void {\n    if (timerRef.current) {\n      clearTimeout(timerRef.current);\n      timerRef.current = null;\n    }\n    void saveNow();\n  }\n\n  // Flush any pending payload on unmount so an in-progress edit is never lost.\n  useEffect(() => {\n    return () => {\n      if (timerRef.current) clearTimeout(timerRef.current);\n      const pending = pendingRef.current;\n      if (pending && !savingRef.current) {\n        pendingRef.current = null;\n        void saveRef.current(pending.value);\n      }\n    };\n  }, []);\n\n  return { status, lastSavedAt, schedule, flush };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,mBAA4C;AAarC,SAAS,YAAe,MAGN;AACvB,QAAM,EAAE,MAAM,aAAa,IAAI,IAAI;AACnC,QAAM,CAAC,QAAQ,SAAS,QAAI,uBAAyB,MAAM;AAC3D,QAAM,CAAC,aAAa,cAAc,QAAI,uBAAsB,IAAI;AAEhE,QAAM,iBAAa,qBAA4B,IAAI;AACnD,QAAM,eAAW,qBAA6C,IAAI;AAClE,QAAM,gBAAY,qBAAO,KAAK;AAG9B,QAAM,cAAU,qBAAO,IAAI;AAC3B,8BAAU,MAAM;AACd,YAAQ,UAAU;AAAA,EACpB,CAAC;AAED,iBAAe,UAAyB;AACtC,QAAI,UAAU,QAAS;AACvB,UAAM,UAAU,WAAW;AAC3B,QAAI,CAAC,QAAS;AACd,eAAW,UAAU;AACrB,cAAU,UAAU;AACpB,cAAU,QAAQ;AAClB,QAAI,SAAS;AACb,QAAI;AACF,YAAM,MAAM,MAAM,QAAQ,QAAQ,QAAQ,KAAK;AAC/C,UAAI,IAAI,OAAO;AAEb,iBAAS;AACT,mBAAW,UAAU,WAAW,WAAW;AAC3C,kBAAU,OAAO;AAAA,MACnB,OAAO;AACL,uBAAe,oBAAI,KAAK,CAAC;AACzB,kBAAU,WAAW,UAAU,YAAY,OAAO;AAAA,MACpD;AAAA,IACF,QAAQ;AACN,eAAS;AACT,iBAAW,UAAU,WAAW,WAAW;AAC3C,gBAAU,OAAO;AAAA,IACnB,UAAE;AACA,gBAAU,UAAU;AAMpB,UAAI,WAAW,WAAW,CAAC,OAAQ,MAAK,QAAQ;AAAA,IAClD;AAAA,EACF;AAEA,WAAS,SAAS,OAAgB;AAChC,eAAW,UAAU,EAAE,MAAM;AAC7B,cAAU,SAAS;AACnB,QAAI,SAAS,QAAS,cAAa,SAAS,OAAO;AACnD,aAAS,UAAU,WAAW,MAAM,KAAK,QAAQ,GAAG,UAAU;AAAA,EAChE;AAEA,WAAS,QAAc;AACrB,QAAI,SAAS,SAAS;AACpB,mBAAa,SAAS,OAAO;AAC7B,eAAS,UAAU;AAAA,IACrB;AACA,SAAK,QAAQ;AAAA,EACf;AAGA,8BAAU,MAAM;AACd,WAAO,MAAM;AACX,UAAI,SAAS,QAAS,cAAa,SAAS,OAAO;AACnD,YAAM,UAAU,WAAW;AAC3B,UAAI,WAAW,CAAC,UAAU,SAAS;AACjC,mBAAW,UAAU;AACrB,aAAK,QAAQ,QAAQ,QAAQ,KAAK;AAAA,MACpC;AAAA,IACF;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,QAAQ,aAAa,UAAU,MAAM;AAChD;","names":[]}

package/dist/autosave.d.cts

@@ -0,0 +1,17 @@
+type AutosaveStatus = "idle" | "unsaved" | "saving" | "saved" | "error";
+interface UseAutosaveResult<T> {
+    status: AutosaveStatus;
+    lastSavedAt: Date | null;
+    /** Queue a payload and (re)start the debounce. */
+    schedule: (value: T) => void;
+    /** Cancel the debounce and save the pending payload immediately. */
+    flush: () => void;
+}
+declare function useAutosave<T>(opts: {
+    save: (value: T) => Promise<{
+        error: string | null;
+    }>;
+    debounceMs?: number;
+}): UseAutosaveResult<T>;
+
+export { type AutosaveStatus, type UseAutosaveResult, useAutosave };

package/dist/autosave.d.ts

@@ -0,0 +1,17 @@
+type AutosaveStatus = "idle" | "unsaved" | "saving" | "saved" | "error";
+interface UseAutosaveResult<T> {
+    status: AutosaveStatus;
+    lastSavedAt: Date | null;
+    /** Queue a payload and (re)start the debounce. */
+    schedule: (value: T) => void;
+    /** Cancel the debounce and save the pending payload immediately. */
+    flush: () => void;
+}
+declare function useAutosave<T>(opts: {
+    save: (value: T) => Promise<{
+        error: string | null;
+    }>;
+    debounceMs?: number;
+}): UseAutosaveResult<T>;
+
+export { type AutosaveStatus, type UseAutosaveResult, useAutosave };

package/dist/autosave.js

@@ -0,0 +1,72 @@
+"use client";
+"use client";
+
+// src/autosave.ts
+import { useEffect, useRef, useState } from "react";
+function useAutosave(opts) {
+  const { save, debounceMs = 900 } = opts;
+  const [status, setStatus] = useState("idle");
+  const [lastSavedAt, setLastSavedAt] = useState(null);
+  const pendingRef = useRef(null);
+  const timerRef = useRef(null);
+  const savingRef = useRef(false);
+  const saveRef = useRef(save);
+  useEffect(() => {
+    saveRef.current = save;
+  });
+  async function saveNow() {
+    if (savingRef.current) return;
+    const pending = pendingRef.current;
+    if (!pending) return;
+    pendingRef.current = null;
+    savingRef.current = true;
+    setStatus("saving");
+    let failed = false;
+    try {
+      const res = await saveRef.current(pending.value);
+      if (res.error) {
+        failed = true;
+        pendingRef.current = pendingRef.current ?? pending;
+        setStatus("error");
+      } else {
+        setLastSavedAt(/* @__PURE__ */ new Date());
+        setStatus(pendingRef.current ? "unsaved" : "saved");
+      }
+    } catch {
+      failed = true;
+      pendingRef.current = pendingRef.current ?? pending;
+      setStatus("error");
+    } finally {
+      savingRef.current = false;
+      if (pendingRef.current && !failed) void saveNow();
+    }
+  }
+  function schedule(value) {
+    pendingRef.current = { value };
+    setStatus("unsaved");
+    if (timerRef.current) clearTimeout(timerRef.current);
+    timerRef.current = setTimeout(() => void saveNow(), debounceMs);
+  }
+  function flush() {
+    if (timerRef.current) {
+      clearTimeout(timerRef.current);
+      timerRef.current = null;
+    }
+    void saveNow();
+  }
+  useEffect(() => {
+    return () => {
+      if (timerRef.current) clearTimeout(timerRef.current);
+      const pending = pendingRef.current;
+      if (pending && !savingRef.current) {
+        pendingRef.current = null;
+        void saveRef.current(pending.value);
+      }
+    };
+  }, []);
+  return { status, lastSavedAt, schedule, flush };
+}
+export {
+  useAutosave
+};
+//# sourceMappingURL=autosave.js.map

package/dist/autosave.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/autosave.ts"],"sourcesContent":["// A small, generic autosave primitive: debounce a payload, persist it through a\n// caller-supplied async save, and expose a status a UI can show (\"Saving…\" /\n// \"Saved\" / \"Unsaved changes\" / error). Entity-agnostic — the caller owns WHAT\n// to save (the save fn) and WHAT the payload is; this owns the debounce, the\n// in-flight coalescing, the status, and the flush-on-unmount so no keystroke is\n// ever lost. (Notes have their own coupled version; this is the reusable one.)\n// Never throws: the save fn returns `{ error }` (supabase-service style) and a\n// non-null error flips status to \"error\" and re-queues, so a blocked write is\n// loud, not silent.\n// React Compiler is on: no manual useMemo / useCallback — plain closures.\n\n\"use client\";\n\nimport { useEffect, useRef, useState } from \"react\";\n\nexport type AutosaveStatus = \"idle\" | \"unsaved\" | \"saving\" | \"saved\" | \"error\";\n\nexport interface UseAutosaveResult<T> {\n  status: AutosaveStatus;\n  lastSavedAt: Date | null;\n  /** Queue a payload and (re)start the debounce. */\n  schedule: (value: T) => void;\n  /** Cancel the debounce and save the pending payload immediately. */\n  flush: () => void;\n}\n\nexport function useAutosave<T>(opts: {\n  save: (value: T) => Promise<{ error: string | null }>;\n  debounceMs?: number;\n}): UseAutosaveResult<T> {\n  const { save, debounceMs = 900 } = opts;\n  const [status, setStatus] = useState<AutosaveStatus>(\"idle\");\n  const [lastSavedAt, setLastSavedAt] = useState<Date | null>(null);\n\n  const pendingRef = useRef<{ value: T } | null>(null);\n  const timerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const savingRef = useRef(false);\n  // Keep the latest save fn without threading it through closures (updated in an\n  // effect, never during render).\n  const saveRef = useRef(save);\n  useEffect(() => {\n    saveRef.current = save;\n  });\n\n  async function saveNow(): Promise<void> {\n    if (savingRef.current) return; // a later debounce flush picks up new edits\n    const pending = pendingRef.current;\n    if (!pending) return;\n    pendingRef.current = null;\n    savingRef.current = true;\n    setStatus(\"saving\");\n    let failed = false;\n    try {\n      const res = await saveRef.current(pending.value);\n      if (res.error) {\n        // Re-queue so the NEXT schedule/flush retries; surface loudly.\n        failed = true;\n        pendingRef.current = pendingRef.current ?? pending;\n        setStatus(\"error\");\n      } else {\n        setLastSavedAt(new Date());\n        setStatus(pendingRef.current ? \"unsaved\" : \"saved\");\n      }\n    } catch {\n      failed = true;\n      pendingRef.current = pendingRef.current ?? pending;\n      setStatus(\"error\");\n    } finally {\n      savingRef.current = false;\n      // If edits arrived mid-save, drain them promptly. NEVER drain after a\n      // failure: the re-queued payload waits for the next schedule/flush —\n      // draining it here is an unbounded immediate-retry loop against a\n      // persistently failing save. (The matrx-frontend original has exactly\n      // that loop; it dies with the original at the adoption swap.)\n      if (pendingRef.current && !failed) void saveNow();\n    }\n  }\n\n  function schedule(value: T): void {\n    pendingRef.current = { value };\n    setStatus(\"unsaved\");\n    if (timerRef.current) clearTimeout(timerRef.current);\n    timerRef.current = setTimeout(() => void saveNow(), debounceMs);\n  }\n\n  function flush(): void {\n    if (timerRef.current) {\n      clearTimeout(timerRef.current);\n      timerRef.current = null;\n    }\n    void saveNow();\n  }\n\n  // Flush any pending payload on unmount so an in-progress edit is never lost.\n  useEffect(() => {\n    return () => {\n      if (timerRef.current) clearTimeout(timerRef.current);\n      const pending = pendingRef.current;\n      if (pending && !savingRef.current) {\n        pendingRef.current = null;\n        void saveRef.current(pending.value);\n      }\n    };\n  }, []);\n\n  return { status, lastSavedAt, schedule, flush };\n}\n"],"mappings":";;;;AAaA,SAAS,WAAW,QAAQ,gBAAgB;AAarC,SAAS,YAAe,MAGN;AACvB,QAAM,EAAE,MAAM,aAAa,IAAI,IAAI;AACnC,QAAM,CAAC,QAAQ,SAAS,IAAI,SAAyB,MAAM;AAC3D,QAAM,CAAC,aAAa,cAAc,IAAI,SAAsB,IAAI;AAEhE,QAAM,aAAa,OAA4B,IAAI;AACnD,QAAM,WAAW,OAA6C,IAAI;AAClE,QAAM,YAAY,OAAO,KAAK;AAG9B,QAAM,UAAU,OAAO,IAAI;AAC3B,YAAU,MAAM;AACd,YAAQ,UAAU;AAAA,EACpB,CAAC;AAED,iBAAe,UAAyB;AACtC,QAAI,UAAU,QAAS;AACvB,UAAM,UAAU,WAAW;AAC3B,QAAI,CAAC,QAAS;AACd,eAAW,UAAU;AACrB,cAAU,UAAU;AACpB,cAAU,QAAQ;AAClB,QAAI,SAAS;AACb,QAAI;AACF,YAAM,MAAM,MAAM,QAAQ,QAAQ,QAAQ,KAAK;AAC/C,UAAI,IAAI,OAAO;AAEb,iBAAS;AACT,mBAAW,UAAU,WAAW,WAAW;AAC3C,kBAAU,OAAO;AAAA,MACnB,OAAO;AACL,uBAAe,oBAAI,KAAK,CAAC;AACzB,kBAAU,WAAW,UAAU,YAAY,OAAO;AAAA,MACpD;AAAA,IACF,QAAQ;AACN,eAAS;AACT,iBAAW,UAAU,WAAW,WAAW;AAC3C,gBAAU,OAAO;AAAA,IACnB,UAAE;AACA,gBAAU,UAAU;AAMpB,UAAI,WAAW,WAAW,CAAC,OAAQ,MAAK,QAAQ;AAAA,IAClD;AAAA,EACF;AAEA,WAAS,SAAS,OAAgB;AAChC,eAAW,UAAU,EAAE,MAAM;AAC7B,cAAU,SAAS;AACnB,QAAI,SAAS,QAAS,cAAa,SAAS,OAAO;AACnD,aAAS,UAAU,WAAW,MAAM,KAAK,QAAQ,GAAG,UAAU;AAAA,EAChE;AAEA,WAAS,QAAc;AACrB,QAAI,SAAS,SAAS;AACpB,mBAAa,SAAS,OAAO;AAC7B,eAAS,UAAU;AAAA,IACrB;AACA,SAAK,QAAQ;AAAA,EACf;AAGA,YAAU,MAAM;AACd,WAAO,MAAM;AACX,UAAI,SAAS,QAAS,cAAa,SAAS,OAAO;AACnD,YAAM,UAAU,WAAW;AAC3B,UAAI,WAAW,CAAC,UAAU,SAAS;AACjC,mBAAW,UAAU;AACrB,aAAK,QAAQ,QAAQ,QAAQ,KAAK;AAAA,MACpC;AAAA,IACF;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,QAAQ,aAAa,UAAU,MAAM;AAChD;","names":[]}

package/dist/clipboard.cjs

@@ -0,0 +1,152 @@
+"use client";
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/clipboard.ts
+var clipboard_exports = {};
+__export(clipboard_exports, {
+  useClipboard: () => useClipboard
+});
+module.exports = __toCommonJS(clipboard_exports);
+var import_react = require("react");
+function toError(err, fallback) {
+  if (err instanceof Error) return err;
+  if (typeof err === "string" && err) return new Error(err);
+  return new Error(fallback);
+}
+function useClipboard(options = {}) {
+  const { notify } = options;
+  const [lastCopied, setLastCopied] = (0, import_react.useState)(null);
+  const [error, setError] = (0, import_react.useState)(null);
+  const handleSuccess = (type, successMessage) => {
+    setLastCopied(type);
+    setError(null);
+    notify?.(
+      successMessage ?? `${type.charAt(0).toUpperCase() + type.slice(1)} copied to clipboard!`,
+      "success"
+    );
+  };
+  const handleError = (err, type) => {
+    const message = `Failed to copy ${type}`;
+    setError(toError(err, message));
+    console.error(message, err);
+    notify?.(message, "error");
+  };
+  const copyText = (0, import_react.useCallback)(
+    async (text, successMessage) => {
+      try {
+        await navigator.clipboard.writeText(text);
+        handleSuccess("text", successMessage);
+      } catch (err) {
+        handleError(err, "text");
+      }
+    },
+    [notify]
+  );
+  const copyImage = (0, import_react.useCallback)(
+    async (imageSrc, successMessage) => {
+      try {
+        const response = await fetch(imageSrc);
+        if (!response.ok)
+          throw new Error(`HTTP error! status: ${response.status}`);
+        const blob = await response.blob();
+        const canvas = document.createElement("canvas");
+        const ctx = canvas.getContext("2d");
+        if (!ctx) throw new Error("Failed to get canvas context");
+        return new Promise((resolve, reject) => {
+          const img = new Image();
+          img.onload = () => {
+            canvas.width = img.width;
+            canvas.height = img.height;
+            ctx.drawImage(img, 0, 0);
+            canvas.toBlob((pngBlob) => {
+              if (pngBlob) {
+                const item = new ClipboardItem({ "image/png": pngBlob });
+                navigator.clipboard.write([item]).then(
+                  () => {
+                    handleSuccess("image", successMessage);
+                    resolve();
+                  },
+                  (err) => reject(
+                    toError(err, "Failed to write image to clipboard")
+                  )
+                );
+              } else {
+                reject(new Error("Failed to convert image to PNG"));
+              }
+            }, "image/png");
+          };
+          img.onerror = () => reject(new Error("Failed to load image"));
+          img.src = URL.createObjectURL(blob);
+        });
+      } catch (err) {
+        handleError(err, "image");
+      }
+    },
+    [notify]
+  );
+  const copyLink = (0, import_react.useCallback)(
+    async (link, stripParams = false, successMessage) => {
+      try {
+        let value = link;
+        if (stripParams) {
+          const url = new URL(link);
+          value = `${url.origin}${url.pathname}`;
+        }
+        await navigator.clipboard.writeText(value);
+        handleSuccess("link", successMessage);
+      } catch (err) {
+        handleError(err, "link");
+      }
+    },
+    [notify]
+  );
+  const pasteText = (0, import_react.useCallback)(async () => {
+    try {
+      const text = await navigator.clipboard.readText();
+      setError(null);
+      return text;
+    } catch (err) {
+      setError(toError(err, "Failed to paste text"));
+      console.error("Failed to paste text: ", err);
+      return "";
+    }
+  }, []);
+  const pasteImage = (0, import_react.useCallback)(async () => {
+    try {
+      if (!navigator.clipboard?.read) return null;
+      const items = await navigator.clipboard.read();
+      for (const item of items) {
+        const imageType = item.types.find((type) => type.startsWith("image/"));
+        if (imageType) {
+          const blob = await item.getType(imageType);
+          return new File([blob], "pasted-image.png", { type: imageType });
+        }
+      }
+      return null;
+    } catch (err) {
+      setError(toError(err, "Failed to paste image"));
+      console.error("Failed to paste image: ", err);
+      return null;
+    }
+  }, []);
+  return { copyText, copyImage, copyLink, pasteText, pasteImage, lastCopied, error };
+}
+//# sourceMappingURL=clipboard.cjs.map

package/dist/clipboard.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/clipboard.ts"],"sourcesContent":["\"use client\";\n\n/**\n * useClipboard — copy/paste text, links, and images with the browser quirks\n * already solved: image copy re-encodes through a canvas to PNG (the only type\n * `ClipboardItem` reliably accepts), paste-image feature-detects\n * `clipboard.read` (absent in Safari < 16.4) instead of throwing, and link\n * copy can strip query params.\n *\n * The notifier is INJECTED — the package does not know your toast system. The\n * host passes `notify` once (usually wrapping its toast); without it, successes\n * are silent and failures still land in `error` + the console, so nothing is\n * ever swallowed.\n */\nimport { useCallback, useState } from \"react\";\n\nexport type ClipboardNotifyKind = \"success\" | \"error\";\n\nexport interface UseClipboardOptions {\n  /** Surface outcomes to the user — wrap your toast here. */\n  notify?: (message: string, kind: ClipboardNotifyKind) => void;\n}\n\nexport interface UseClipboardResult {\n  copyText: (text: string, successMessage?: string) => Promise<void>;\n  copyImage: (imageSrc: string, successMessage?: string) => Promise<void>;\n  copyLink: (\n    link: string,\n    stripParams?: boolean,\n    successMessage?: string,\n  ) => Promise<void>;\n  pasteText: () => Promise<string>;\n  pasteImage: () => Promise<File | null>;\n  lastCopied: string | null;\n  error: Error | null;\n}\n\nfunction toError(err: unknown, fallback: string): Error {\n  if (err instanceof Error) return err;\n  if (typeof err === \"string\" && err) return new Error(err);\n  return new Error(fallback);\n}\n\nexport function useClipboard(\n  options: UseClipboardOptions = {},\n): UseClipboardResult {\n  const { notify } = options;\n  const [lastCopied, setLastCopied] = useState<string | null>(null);\n  const [error, setError] = useState<Error | null>(null);\n\n  const handleSuccess = (type: string, successMessage: string | undefined) => {\n    setLastCopied(type);\n    setError(null);\n    notify?.(\n      successMessage ??\n        `${type.charAt(0).toUpperCase() + type.slice(1)} copied to clipboard!`,\n      \"success\",\n    );\n  };\n\n  const handleError = (err: unknown, type: string) => {\n    const message = `Failed to copy ${type}`;\n    setError(toError(err, message));\n    console.error(message, err);\n    notify?.(message, \"error\");\n  };\n\n  const copyText = useCallback(\n    async (text: string, successMessage?: string) => {\n      try {\n        await navigator.clipboard.writeText(text);\n        handleSuccess(\"text\", successMessage);\n      } catch (err) {\n        handleError(err, \"text\");\n      }\n    },\n    [notify],\n  );\n\n  const copyImage = useCallback(\n    async (imageSrc: string, successMessage?: string) => {\n      try {\n        const response = await fetch(imageSrc);\n        if (!response.ok)\n          throw new Error(`HTTP error! status: ${response.status}`);\n        const blob = await response.blob();\n\n        const canvas = document.createElement(\"canvas\");\n        const ctx = canvas.getContext(\"2d\");\n        if (!ctx) throw new Error(\"Failed to get canvas context\");\n\n        return new Promise<void>((resolve, reject) => {\n          const img = new Image();\n          img.onload = () => {\n            canvas.width = img.width;\n            canvas.height = img.height;\n            ctx.drawImage(img, 0, 0);\n\n            canvas.toBlob((pngBlob) => {\n              if (pngBlob) {\n                const item = new ClipboardItem({ \"image/png\": pngBlob });\n                navigator.clipboard.write([item]).then(\n                  () => {\n                    handleSuccess(\"image\", successMessage);\n                    resolve();\n                  },\n                  (err) =>\n                    reject(\n                      toError(err, \"Failed to write image to clipboard\"),\n                    ),\n                );\n              } else {\n                reject(new Error(\"Failed to convert image to PNG\"));\n              }\n            }, \"image/png\");\n          };\n          img.onerror = () => reject(new Error(\"Failed to load image\"));\n          img.src = URL.createObjectURL(blob);\n        });\n      } catch (err) {\n        handleError(err, \"image\");\n      }\n    },\n    [notify],\n  );\n\n  const copyLink = useCallback(\n    async (link: string, stripParams = false, successMessage?: string) => {\n      try {\n        let value = link;\n        if (stripParams) {\n          const url = new URL(link);\n          value = `${url.origin}${url.pathname}`;\n        }\n        await navigator.clipboard.writeText(value);\n        handleSuccess(\"link\", successMessage);\n      } catch (err) {\n        handleError(err, \"link\");\n      }\n    },\n    [notify],\n  );\n\n  const pasteText = useCallback(async () => {\n    try {\n      const text = await navigator.clipboard.readText();\n      setError(null);\n      return text;\n    } catch (err) {\n      setError(toError(err, \"Failed to paste text\"));\n      console.error(\"Failed to paste text: \", err);\n      return \"\";\n    }\n  }, []);\n\n  const pasteImage = useCallback(async () => {\n    try {\n      // clipboard.read() is not available in Safari < 16.4\n      if (!navigator.clipboard?.read) return null;\n      const items = await navigator.clipboard.read();\n      for (const item of items) {\n        const imageType = item.types.find((type) => type.startsWith(\"image/\"));\n        if (imageType) {\n          const blob = await item.getType(imageType);\n          return new File([blob], \"pasted-image.png\", { type: imageType });\n        }\n      }\n      return null;\n    } catch (err) {\n      setError(toError(err, \"Failed to paste image\"));\n      console.error(\"Failed to paste image: \", err);\n      return null;\n    }\n  }, []);\n\n  return { copyText, copyImage, copyLink, pasteText, pasteImage, lastCopied, error };\n}\n"],"mappings":"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","names":[]}