@entry-ui/utilities 0.6.0 → 0.7.0

package/dist/chunk-P7NW64IN.js

@@ -0,0 +1,2 @@
+var n=async a=>{let{value:p,onSuccess:e,onError:r}=a,t=document.defaultView||window;try{if(!t.navigator.clipboard?.writeText){r?.({type:"NOT_SUPPORTED"});return}await t.navigator.clipboard.writeText(p),e?.();}catch(o){let i=o instanceof Error?o.message:String(o);r?.({type:"COPY_FAILED",message:i});}};export{n as a};//# sourceMappingURL=chunk-P7NW64IN.js.map
+//# sourceMappingURL=chunk-P7NW64IN.js.map

package/dist/chunk-P7NW64IN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/copy-to-clipboard/copy-to-clipboard.ts"],"names":["copyToClipboard","params","value","onSuccess","onError","win","error","message"],"mappings":"AAqBO,IAAMA,CAAAA,CAAkB,MAAOC,CAAAA,EAAkC,CACtE,GAAM,CAAE,KAAA,CAAAC,CAAAA,CAAO,SAAA,CAAAC,CAAAA,CAAW,OAAA,CAAAC,CAAQ,EAAIH,CAAAA,CAEhCI,CAAAA,CAAM,QAAA,CAAS,WAAA,EAAe,MAAA,CAEpC,GAAI,CACF,GAAI,CAACA,CAAAA,CAAI,SAAA,CAAU,SAAA,EAAW,SAAA,CAAW,CACvCD,CAAAA,GAAU,CAAE,KAAM,eAAgB,CAAC,CAAA,CACnC,MACF,CAEA,MAAMC,CAAAA,CAAI,SAAA,CAAU,SAAA,CAAU,SAAA,CAAUH,CAAK,CAAA,CAC7CC,CAAAA,KACF,CAAA,MAASG,CAAAA,CAAO,CACd,IAAMC,CAAAA,CAAUD,CAAAA,YAAiB,KAAA,CAAQA,CAAAA,CAAM,OAAA,CAAU,MAAA,CAAOA,CAAK,CAAA,CACrEF,CAAAA,GAAU,CAAE,IAAA,CAAM,aAAA,CAAe,OAAA,CAAAG,CAAQ,CAAC,EAC5C,CACF","file":"chunk-P7NW64IN.js","sourcesContent":["import type { CopyToClipboardParams } from './copy-to-clipboard.types';\n\n/**\n * Asynchronously transfers text to the system clipboard using the Clipboard API.\n *\n * This utility provides a structured wrapper around `navigator.clipboard.writeText`,\n * offering specific error types to distinguish between unsupported environments\n * and runtime failures.\n *\n * This function expects a browser environment where `window` or\n * `document` is globally available.\n *\n * @example\n * ```ts\n * copyToClipboard({\n * \tvalue: \"Hello World\",\n * \tonSuccess: () => console.log(\"Text copied!\"),\n * \tonError: (err) => console.error(`Copy failed: ${err.type}, ${err.message}`),\n * });\n * ```\n */\nexport const copyToClipboard = async (params: CopyToClipboardParams) => {\n  const { value, onSuccess, onError } = params;\n\n  const win = document.defaultView || window;\n\n  try {\n    if (!win.navigator.clipboard?.writeText) {\n      onError?.({ type: 'NOT_SUPPORTED' });\n      return;\n    }\n\n    await win.navigator.clipboard.writeText(value);\n    onSuccess?.();\n  } catch (error) {\n    const message = error instanceof Error ? error.message : String(error);\n    onError?.({ type: 'COPY_FAILED', message });\n  }\n};\n"]}

package/dist/copy-to-clipboard/index.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Represents a structured error object returned when a clipboard operation fails.
+ *
+ * This interface provides a uniform error shape to distinguish between
+ * environment-level limitations and unexpected runtime failures,
+ * allowing consumers to handle each case appropriately.
+ */
+interface ClipboardError {
+    /**
+     * The classification of the failure.
+     * - `"NOT_SUPPORTED"`: The browser lacks `navigator.clipboard.writeText` support.
+     * - `"COPY_FAILED"`: The operation was rejected (e.g., lack of permissions).
+     */
+    type: 'NOT_SUPPORTED' | 'COPY_FAILED';
+    /**
+     * A descriptive message detailing the cause of the failure.
+     * This field is populated exclusively when the error `type` is `"COPY_FAILED"`,
+     * typically containing the message from the native `Error` object.
+     */
+    message?: string;
+}
+/**
+ * Configuration object for the `copyToClipboard` utility.
+ *
+ * This interface encapsulates the parameters required to perform a clipboard write operation.
+ * It allows the caller to define custom behavior for both successful data persistence
+ * and potential browser-level restrictions or runtime failures through dedicated
+ * callback handlers.
+ */
+interface CopyToClipboardParams {
+    /**
+     * The plaintext string to be transferred to the system clipboard.
+     * This value is processed as a standard UTF-16 string by the Clipboard API.
+     */
+    value: string;
+    /**
+     * An optional callback executed immediately after the value has been successfully
+     * written to the clipboard. Use this to trigger UI feedback like "Copied!" toasts
+     * or success state updates.
+     *
+     * @default undefined
+     */
+    onSuccess?: () => void;
+    /**
+     * An optional callback executed when the copy operation fails or is not supported.
+     * It provides structured error information to distinguish between environment
+     * limitations (`"NOT_SUPPORTED"`) and unexpected runtime rejections (`"COPY_FAILED"`).
+     *
+     * @default undefined
+     */
+    onError?: (error: ClipboardError) => void;
+}
+
+/**
+ * Asynchronously transfers text to the system clipboard using the Clipboard API.
+ *
+ * This utility provides a structured wrapper around `navigator.clipboard.writeText`,
+ * offering specific error types to distinguish between unsupported environments
+ * and runtime failures.
+ *
+ * This function expects a browser environment where `window` or
+ * `document` is globally available.
+ *
+ * @example
+ * ```ts
+ * copyToClipboard({
+ * 	value: "Hello World",
+ * 	onSuccess: () => console.log("Text copied!"),
+ * 	onError: (err) => console.error(`Copy failed: ${err.type}, ${err.message}`),
+ * });
+ * ```
+ */
+declare const copyToClipboard: (params: CopyToClipboardParams) => Promise<void>;
+
+export { type ClipboardError, type CopyToClipboardParams, copyToClipboard };

package/dist/copy-to-clipboard/index.js

@@ -0,0 +1,2 @@
+export{a as copyToClipboard}from'../chunk-P7NW64IN.js';//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/copy-to-clipboard/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { AddEventListenerOnceParams, AllEventMaps, addEventListenerOnce } from './add-event-listener-once/index.js';
 export { ClampParams, clamp } from './clamp/index.js';
+export { ClipboardError, CopyToClipboardParams, copyToClipboard } from './copy-to-clipboard/index.js';
 export { ErrorParams, error } from './error/index.js';
 export { FailParams, fail } from './fail/index.js';
 export { getComputedStyle } from './get-computed-style/index.js';

package/dist/index.js

@@ -1,2 +1,2 @@
-export{a as warn}from'./chunk-6L6DIP5N.js';export{a as mergeStyles}from'./chunk-NBN5PUZ6.js';export{a as scrollIntoViewIfNeeded}from'./chunk-YFUOSM2Q.js';export{a as visuallyHiddenInputStyle}from'./chunk-AYHMR4G2.js';export{a as visuallyHiddenStyle}from'./chunk-YRBGPPKC.js';export{a as wait}from'./chunk-OUZ54COH.js';export{a as addEventListenerOnce}from'./chunk-GLPQ4KOF.js';export{a as clamp}from'./chunk-BVBN4VWU.js';export{a as isValidNumber}from'./chunk-TAV72HQS.js';export{a as error}from'./chunk-GG6DRWSS.js';export{a as fail}from'./chunk-O4WYO5SA.js';export{a as getHiddenElementHeight}from'./chunk-RZEIOZGJ.js';export{a as getCssDimensions}from'./chunk-TJWADQ7V.js';export{a as isHTMLElement}from'./chunk-KSDRQLOI.js';export{a as hasWindow}from'./chunk-V3434ODU.js';export{a as getComputedStyle}from'./chunk-5BI2X7JA.js';export{a as getWindow}from'./chunk-H2U5U7XY.js';//# sourceMappingURL=index.js.map
+export{a as visuallyHiddenStyle}from'./chunk-YRBGPPKC.js';export{a as wait}from'./chunk-OUZ54COH.js';export{a as warn}from'./chunk-6L6DIP5N.js';export{a as getHiddenElementHeight}from'./chunk-RZEIOZGJ.js';export{a as mergeStyles}from'./chunk-NBN5PUZ6.js';export{a as scrollIntoViewIfNeeded}from'./chunk-YFUOSM2Q.js';export{a as visuallyHiddenInputStyle}from'./chunk-AYHMR4G2.js';export{a as addEventListenerOnce}from'./chunk-GLPQ4KOF.js';export{a as clamp}from'./chunk-BVBN4VWU.js';export{a as isValidNumber}from'./chunk-TAV72HQS.js';export{a as copyToClipboard}from'./chunk-P7NW64IN.js';export{a as error}from'./chunk-GG6DRWSS.js';export{a as fail}from'./chunk-O4WYO5SA.js';export{a as getCssDimensions}from'./chunk-TJWADQ7V.js';export{a as isHTMLElement}from'./chunk-KSDRQLOI.js';export{a as hasWindow}from'./chunk-V3434ODU.js';export{a as getComputedStyle}from'./chunk-5BI2X7JA.js';export{a as getWindow}from'./chunk-H2U5U7XY.js';//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@entry-ui/utilities",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "",
   "keywords": [],
   "homepage": "https://github.com/ZAHON/entry-ui/tree/main/packages/utilities#readme",