@arkyn/components 3.0.6 → 3.0.8

package/dist/modules/hooks/useCopyToClipboard.js

@@ -0,0 +1,28 @@
+//#region src/hooks/useCopyToClipboard.ts
+function e(e) {
+	let t = document.createElement("textarea");
+	t.value = e, t.style.position = "fixed", t.style.opacity = "0", document.body.appendChild(t), t.select();
+	try {
+		return document.execCommand("copy");
+	} finally {
+		document.body.removeChild(t);
+	}
+}
+function t() {
+	async function t(t) {
+		try {
+			return await navigator.clipboard.writeText(t), !0;
+		} catch {
+			try {
+				return e(t);
+			} catch {
+				return !1;
+			}
+		}
+	}
+	return { copyToClipboard: t };
+}
+//#endregion
+export { t as useCopyToClipboard };
+
+//# sourceMappingURL=useCopyToClipboard.js.map

package/dist/modules/hooks/useCopyToClipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCopyToClipboard.js","names":[],"sources":["../../../src/hooks/useCopyToClipboard.ts"],"sourcesContent":["/**\n * copyWithFallback, copies `text` using a hidden `<textarea>` + `document.execCommand(\"copy\")`.\n *\n * Used internally by `useCopyToClipboard` when `navigator.clipboard` is unavailable or rejects,\n * e.g. insecure contexts (non-HTTPS) or older browsers.\n *\n * @param text - Text to copy.\n * @returns `true` if the copy command succeeded, `false` otherwise.\n */\n\nfunction copyWithFallback(text: string) {\n\tconst textarea = document.createElement(\"textarea\");\n\ttextarea.value = text;\n\ttextarea.style.position = \"fixed\";\n\ttextarea.style.opacity = \"0\";\n\tdocument.body.appendChild(textarea);\n\ttextarea.select();\n\n\ttry {\n\t\treturn document.execCommand(\"copy\");\n\t} finally {\n\t\tdocument.body.removeChild(textarea);\n\t}\n}\n\n/**\n * useCopyToClipboard, copies text to the clipboard and reports whether it succeeded.\n *\n * Tries `navigator.clipboard.writeText` first. If it's unavailable or rejects, falls back\n * to a hidden `<textarea>` with `document.execCommand(\"copy\")`. Never throws; any failure\n * simply resolves to `false`.\n *\n * @returns An object with `copyToClipboard`, an async function that copies `text` and resolves\n * to `true` on success, `false` on failure.\n *\n * @example\n * ```tsx\n * function CopyButton({ value }) {\n *   const { copyToClipboard } = useCopyToClipboard();\n *\n *   async function handleClick() {\n *     const success = await copyToClipboard(value);\n *     if (success) console.log(\"Copied!\");\n *   }\n *\n *   return <button onClick={handleClick}>Copy</button>;\n * }\n * ```\n */\n\nfunction useCopyToClipboard() {\n\tasync function copyToClipboard(text: string) {\n\t\ttry {\n\t\t\tawait navigator.clipboard.writeText(text);\n\t\t\treturn true;\n\t\t} catch {\n\t\t\ttry {\n\t\t\t\treturn copyWithFallback(text);\n\t\t\t} catch {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\t}\n\n\treturn { copyToClipboard };\n}\n\nexport { useCopyToClipboard };\n"],"mappings":";AAUA,SAAS,EAAiB,GAAc;CACvC,IAAM,IAAW,SAAS,cAAc,UAAU;CAKlD,AAJA,EAAS,QAAQ,GACjB,EAAS,MAAM,WAAW,SAC1B,EAAS,MAAM,UAAU,KACzB,SAAS,KAAK,YAAY,CAAQ,GAClC,EAAS,OAAO;CAEhB,IAAI;EACH,OAAO,SAAS,YAAY,MAAM;CACnC,UAAU;EACT,SAAS,KAAK,YAAY,CAAQ;CACnC;AACD;AA2BA,SAAS,IAAqB;CAC7B,eAAe,EAAgB,GAAc;EAC5C,IAAI;GAEH,OADA,MAAM,UAAU,UAAU,UAAU,CAAI,GACjC;EACR,QAAQ;GACP,IAAI;IACH,OAAO,EAAiB,CAAI;GAC7B,QAAQ;IACP,OAAO;GACR;EACD;CACD;CAEA,OAAO,EAAE,mBAAgB;AAC1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arkyn/components",
-  "version": "3.0.6",
+  "version": "3.0.8",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -38,6 +38,7 @@
   "files": [
     "dist",
     "README.md",
+    "AGENTS.md",
     "LICENSE.txt",
     "styles.d.ts"
   ],
@@ -112,7 +113,7 @@
   "devDependencies": {
     "@react-google-maps/api": "^2.20.8",
     "@react-input/mask": "^2.0.4",
-    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/jest-dom": "^7.0.0",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.6.1",
     "@types/bun": "catalog:",
@@ -715,6 +716,11 @@
       "types": "./dist/hooks/useAutomation.d.ts",
       "default": "./dist/modules/hooks/useAutomation.js"
     },
+    "./useCopyToClipboard": {
+      "import": "./dist/modules/hooks/useCopyToClipboard.js",
+      "types": "./dist/hooks/useCopyToClipboard.d.ts",
+      "default": "./dist/modules/hooks/useCopyToClipboard.js"
+    },
     "./useDrawer": {
       "import": "./dist/modules/hooks/useDrawer.js",
       "types": "./dist/hooks/useDrawer.d.ts",
@@ -1105,6 +1111,9 @@
       "useAutomation": [
         "./dist/hooks/useAutomation.d.ts"
       ],
+      "useCopyToClipboard": [
+        "./dist/hooks/useCopyToClipboard.d.ts"
+      ],
       "useDrawer": [
         "./dist/hooks/useDrawer.d.ts"
       ],