@ai-matrx/kit 0.5.0

package/dist/clipboard.d.cts

@@ -0,0 +1,17 @@
+type ClipboardNotifyKind = "success" | "error";
+interface UseClipboardOptions {
+    /** Surface outcomes to the user — wrap your toast here. */
+    notify?: (message: string, kind: ClipboardNotifyKind) => void;
+}
+interface UseClipboardResult {
+    copyText: (text: string, successMessage?: string) => Promise<void>;
+    copyImage: (imageSrc: string, successMessage?: string) => Promise<void>;
+    copyLink: (link: string, stripParams?: boolean, successMessage?: string) => Promise<void>;
+    pasteText: () => Promise<string>;
+    pasteImage: () => Promise<File | null>;
+    lastCopied: string | null;
+    error: Error | null;
+}
+declare function useClipboard(options?: UseClipboardOptions): UseClipboardResult;
+
+export { type ClipboardNotifyKind, type UseClipboardOptions, type UseClipboardResult, useClipboard };

package/dist/clipboard.d.ts

@@ -0,0 +1,17 @@
+type ClipboardNotifyKind = "success" | "error";
+interface UseClipboardOptions {
+    /** Surface outcomes to the user — wrap your toast here. */
+    notify?: (message: string, kind: ClipboardNotifyKind) => void;
+}
+interface UseClipboardResult {
+    copyText: (text: string, successMessage?: string) => Promise<void>;
+    copyImage: (imageSrc: string, successMessage?: string) => Promise<void>;
+    copyLink: (link: string, stripParams?: boolean, successMessage?: string) => Promise<void>;
+    pasteText: () => Promise<string>;
+    pasteImage: () => Promise<File | null>;
+    lastCopied: string | null;
+    error: Error | null;
+}
+declare function useClipboard(options?: UseClipboardOptions): UseClipboardResult;
+
+export { type ClipboardNotifyKind, type UseClipboardOptions, type UseClipboardResult, useClipboard };

package/dist/clipboard.js

@@ -0,0 +1,132 @@
+"use client";
+"use client";
+
+// src/clipboard.ts
+import { useCallback, useState } from "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] = useState(null);
+  const [error, setError] = 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 = useCallback(
+    async (text, successMessage) => {
+      try {
+        await navigator.clipboard.writeText(text);
+        handleSuccess("text", successMessage);
+      } catch (err) {
+        handleError(err, "text");
+      }
+    },
+    [notify]
+  );
+  const copyImage = 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 = 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 = 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 = 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 };
+}
+export {
+  useClipboard
+};
+//# sourceMappingURL=clipboard.js.map

package/dist/clipboard.js.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":";;;;AAcA,SAAS,aAAa,gBAAgB;AAuBtC,SAAS,QAAQ,KAAc,UAAyB;AACtD,MAAI,eAAe,MAAO,QAAO;AACjC,MAAI,OAAO,QAAQ,YAAY,IAAK,QAAO,IAAI,MAAM,GAAG;AACxD,SAAO,IAAI,MAAM,QAAQ;AAC3B;AAEO,SAAS,aACd,UAA+B,CAAC,GACZ;AACpB,QAAM,EAAE,OAAO,IAAI;AACnB,QAAM,CAAC,YAAY,aAAa,IAAI,SAAwB,IAAI;AAChE,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAuB,IAAI;AAErD,QAAM,gBAAgB,CAAC,MAAc,mBAAuC;AAC1E,kBAAc,IAAI;AAClB,aAAS,IAAI;AACb;AAAA,MACE,kBACE,GAAG,KAAK,OAAO,CAAC,EAAE,YAAY,IAAI,KAAK,MAAM,CAAC,CAAC;AAAA,MACjD;AAAA,IACF;AAAA,EACF;AAEA,QAAM,cAAc,CAAC,KAAc,SAAiB;AAClD,UAAM,UAAU,kBAAkB,IAAI;AACtC,aAAS,QAAQ,KAAK,OAAO,CAAC;AAC9B,YAAQ,MAAM,SAAS,GAAG;AAC1B,aAAS,SAAS,OAAO;AAAA,EAC3B;AAEA,QAAM,WAAW;AAAA,IACf,OAAO,MAAc,mBAA4B;AAC/C,UAAI;AACF,cAAM,UAAU,UAAU,UAAU,IAAI;AACxC,sBAAc,QAAQ,cAAc;AAAA,MACtC,SAAS,KAAK;AACZ,oBAAY,KAAK,MAAM;AAAA,MACzB;AAAA,IACF;AAAA,IACA,CAAC,MAAM;AAAA,EACT;AAEA,QAAM,YAAY;AAAA,IAChB,OAAO,UAAkB,mBAA4B;AACnD,UAAI;AACF,cAAM,WAAW,MAAM,MAAM,QAAQ;AACrC,YAAI,CAAC,SAAS;AACZ,gBAAM,IAAI,MAAM,uBAAuB,SAAS,MAAM,EAAE;AAC1D,cAAM,OAAO,MAAM,SAAS,KAAK;AAEjC,cAAM,SAAS,SAAS,cAAc,QAAQ;AAC9C,cAAM,MAAM,OAAO,WAAW,IAAI;AAClC,YAAI,CAAC,IAAK,OAAM,IAAI,MAAM,8BAA8B;AAExD,eAAO,IAAI,QAAc,CAAC,SAAS,WAAW;AAC5C,gBAAM,MAAM,IAAI,MAAM;AACtB,cAAI,SAAS,MAAM;AACjB,mBAAO,QAAQ,IAAI;AACnB,mBAAO,SAAS,IAAI;AACpB,gBAAI,UAAU,KAAK,GAAG,CAAC;AAEvB,mBAAO,OAAO,CAAC,YAAY;AACzB,kBAAI,SAAS;AACX,sBAAM,OAAO,IAAI,cAAc,EAAE,aAAa,QAAQ,CAAC;AACvD,0BAAU,UAAU,MAAM,CAAC,IAAI,CAAC,EAAE;AAAA,kBAChC,MAAM;AACJ,kCAAc,SAAS,cAAc;AACrC,4BAAQ;AAAA,kBACV;AAAA,kBACA,CAAC,QACC;AAAA,oBACE,QAAQ,KAAK,oCAAoC;AAAA,kBACnD;AAAA,gBACJ;AAAA,cACF,OAAO;AACL,uBAAO,IAAI,MAAM,gCAAgC,CAAC;AAAA,cACpD;AAAA,YACF,GAAG,WAAW;AAAA,UAChB;AACA,cAAI,UAAU,MAAM,OAAO,IAAI,MAAM,sBAAsB,CAAC;AAC5D,cAAI,MAAM,IAAI,gBAAgB,IAAI;AAAA,QACpC,CAAC;AAAA,MACH,SAAS,KAAK;AACZ,oBAAY,KAAK,OAAO;AAAA,MAC1B;AAAA,IACF;AAAA,IACA,CAAC,MAAM;AAAA,EACT;AAEA,QAAM,WAAW;AAAA,IACf,OAAO,MAAc,cAAc,OAAO,mBAA4B;AACpE,UAAI;AACF,YAAI,QAAQ;AACZ,YAAI,aAAa;AACf,gBAAM,MAAM,IAAI,IAAI,IAAI;AACxB,kBAAQ,GAAG,IAAI,MAAM,GAAG,IAAI,QAAQ;AAAA,QACtC;AACA,cAAM,UAAU,UAAU,UAAU,KAAK;AACzC,sBAAc,QAAQ,cAAc;AAAA,MACtC,SAAS,KAAK;AACZ,oBAAY,KAAK,MAAM;AAAA,MACzB;AAAA,IACF;AAAA,IACA,CAAC,MAAM;AAAA,EACT;AAEA,QAAM,YAAY,YAAY,YAAY;AACxC,QAAI;AACF,YAAM,OAAO,MAAM,UAAU,UAAU,SAAS;AAChD,eAAS,IAAI;AACb,aAAO;AAAA,IACT,SAAS,KAAK;AACZ,eAAS,QAAQ,KAAK,sBAAsB,CAAC;AAC7C,cAAQ,MAAM,0BAA0B,GAAG;AAC3C,aAAO;AAAA,IACT;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,QAAM,aAAa,YAAY,YAAY;AACzC,QAAI;AAEF,UAAI,CAAC,UAAU,WAAW,KAAM,QAAO;AACvC,YAAM,QAAQ,MAAM,UAAU,UAAU,KAAK;AAC7C,iBAAW,QAAQ,OAAO;AACxB,cAAM,YAAY,KAAK,MAAM,KAAK,CAAC,SAAS,KAAK,WAAW,QAAQ,CAAC;AACrE,YAAI,WAAW;AACb,gBAAM,OAAO,MAAM,KAAK,QAAQ,SAAS;AACzC,iBAAO,IAAI,KAAK,CAAC,IAAI,GAAG,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAAA,QACjE;AAAA,MACF;AACA,aAAO;AAAA,IACT,SAAS,KAAK;AACZ,eAAS,QAAQ,KAAK,uBAAuB,CAAC;AAC9C,cAAQ,MAAM,2BAA2B,GAAG;AAC5C,aAAO;AAAA,IACT;AAAA,EACF,GAAG,CAAC,CAAC;AAEL,SAAO,EAAE,UAAU,WAAW,UAAU,WAAW,YAAY,YAAY,MAAM;AACnF;","names":[]}