@kikiutils/shared 11.0.0 → 13.0.0

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@kikiutils/shared",
-  "version": "11.0.0",
+  "type": "module",
+  "version": "13.0.0",
   "description": "A lightweight and modular utility library for modern JavaScript and TypeScript — includes secure hashing, flexible logging, datetime tools, Vue/web helpers, storage abstraction, and more.",
   "author": "kiki-kanri",
   "license": "MIT",
@@ -32,31 +33,43 @@
   ],
   "sideEffects": false,
   "exports": {
-    "./*": {
-      "types": "./dist/*.d.ts",
-      "import": "./dist/*.mjs",
-      "require": "./dist/*.cjs"
-    },
-    "./storage/enhanced/local": {
-      "types": "./dist/storage/enhanced/local/index.d.ts",
-      "import": "./dist/storage/enhanced/local/index.mjs",
-      "require": "./dist/storage/enhanced/local/index.cjs"
-    },
-    "./storage/enhanced/redis": {
-      "types": "./dist/storage/enhanced/redis/index.d.ts",
-      "import": "./dist/storage/enhanced/redis/index.mjs",
-      "require": "./dist/storage/enhanced/redis/index.cjs"
-    }
+    "./buffer": "./dist/buffer.js",
+    "./clipboard": "./dist/clipboard.js",
+    "./consola": "./dist/consola.js",
+    "./crypto-hash": "./dist/crypto-hash.js",
+    "./datetime": "./dist/datetime.js",
+    "./element-plus": "./dist/element-plus.js",
+    "./enum": "./dist/enum.js",
+    "./env": "./dist/env.js",
+    "./general": "./dist/general.js",
+    "./hash": "./dist/hash.js",
+    "./math": "./dist/math.js",
+    "./number": "./dist/number.js",
+    "./object": "./dist/object.js",
+    "./pino": "./dist/pino.js",
+    "./random": "./dist/random.js",
+    "./storage/enhanced/local": "./dist/storage/enhanced/local/index.js",
+    "./storage/enhanced/local/core": "./dist/storage/enhanced/local/core.js",
+    "./storage/enhanced/local/keyed-store": "./dist/storage/enhanced/local/keyed-store.js",
+    "./storage/enhanced/redis": "./dist/storage/enhanced/redis/index.js",
+    "./storage/enhanced/redis/core": "./dist/storage/enhanced/redis/core.js",
+    "./storage/enhanced/redis/keyed-store": "./dist/storage/enhanced/redis/keyed-store.js",
+    "./storage/lru/keyed-store": "./dist/storage/lru/keyed-store.js",
+    "./string": "./dist/string.js",
+    "./url": "./dist/url.js",
+    "./vue": "./dist/vue.js",
+    "./web": "./dist/web.js",
+    "./package.json": "./package.json"
   },
   "files": [
     "./dist",
     "./src"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "scripts": {
-    "build": "ts-project-builder './src/**/*.ts' --clean --preserve-modules --sourcemaps",
+    "build": "tsdown",
     "bumplog": "changelogen --bump --hideAuthorEmail",
     "depcheck": "depcheck",
     "lint": "eslint --max-warnings 0",
@@ -68,32 +81,95 @@
     "typecheck": "tsc --noEmit",
     "unused-exports": "ts-unused-exports ./tsconfig.json"
   },
+  "peerDependencies": {
+    "@noble/hashes": "^2.0.0",
+    "async-validator": "^4.2.5",
+    "consola": "^3.4.2",
+    "date-fns": "^4.1.0",
+    "decimal.js": "^10.6.0",
+    "element-plus": "^2.11.1",
+    "ioredis": "^5.7.0",
+    "lru-cache": "^11.1.0",
+    "millify": "^6.1.0",
+    "pino": "^9.9.0",
+    "pino-pretty": "^13.1.1",
+    "superjson": "^2.2.2",
+    "vue": "^3.5.20",
+    "vue-router": "^4.5.1"
+  },
+  "peerDependenciesMeta": {
+    "@noble/hashes": {
+      "optional": true
+    },
+    "async-validator": {
+      "optional": true
+    },
+    "consola": {
+      "optional": true
+    },
+    "date-fns": {
+      "optional": true
+    },
+    "decimal.js": {
+      "optional": true
+    },
+    "element-plus": {
+      "optional": true
+    },
+    "ioredis": {
+      "optional": true
+    },
+    "lru-cache": {
+      "optional": true
+    },
+    "millify": {
+      "optional": true
+    },
+    "pino": {
+      "optional": true
+    },
+    "pino-pretty": {
+      "optional": true
+    },
+    "superjson": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "vue-router": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "@kikiutils/changelogen": "^0.8.1",
-    "@kikiutils/eslint-config": "^1.2.7",
+    "@kikiutils/changelogen": "^0.9.0",
+    "@kikiutils/eslint-config": "^2.1.1",
     "@kikiutils/tsconfigs": "^5.0.4",
-    "@noble/hashes": "^1.8.0",
-    "@types/node": "^24.0.14",
+    "@noble/hashes": "^2.0.0",
+    "@types/node": "^24.3.3",
     "@vitest/coverage-v8": "^3.2.4",
     "async-validator": "^4.2.5",
     "consola": "^3.4.2",
-    "cross-env": "^7.0.3",
+    "cross-env": "^10.0.0",
     "date-fns": "^4.1.0",
     "decimal.js": "^10.6.0",
     "depcheck": "^1.4.7",
-    "element-plus": "^2.10.4",
-    "ioredis": "^5.6.1",
-    "jsdom": "^26.1.0",
-    "lru-cache": "^11.1.0",
+    "element-plus": "^2.11.2",
+    "ioredis": "^5.7.0",
+    "jsdom": "^27.0.0",
+    "lru-cache": "^11.2.1",
     "millify": "^6.1.0",
-    "pino": "^9.7.0",
-    "pino-pretty": "^13.0.0",
+    "pino": "^9.9.5",
+    "pino-pretty": "^13.1.1",
+    "publint": "^0.3.12",
     "superjson": "^2.2.2",
-    "ts-project-builder": "^5.0.2",
     "ts-unused-exports": "^11.0.1",
-    "typescript": "^5.8.3",
+    "tsconfck": "^3.1.6",
+    "tsdown": "^0.15.1",
+    "typescript": "^5.9.2",
+    "unplugin-unused": "^0.5.3",
     "vitest": "^3.2.4",
-    "vue": "^3.5.17",
+    "vue": "^3.5.21",
     "vue-router": "^4.5.1"
   },
   "pnpm": {

package/src/hash.ts

@@ -18,9 +18,23 @@ import {
     sha3_384,
     sha3_512,
 } from '@noble/hashes/sha3';
-import { bytesToHex } from '@noble/hashes/utils';
+import {
+    bytesToHex,
+    utf8ToBytes,
+} from '@noble/hashes/utils';
+
+export function sha3224(data: string | Uint8Array) {
+    return bytesToHex(sha3_224(typeof data === 'string' ? utf8ToBytes(data) : data));
+}
+
+export function sha3256(data: string | Uint8Array) {
+    return bytesToHex(sha3_256(typeof data === 'string' ? utf8ToBytes(data) : data));
+}
+
+export function sha3384(data: string | Uint8Array) {
+    return bytesToHex(sha3_384(typeof data === 'string' ? utf8ToBytes(data) : data));
+}
 
-export const sha3224 = (data: string | Uint8Array) => bytesToHex(sha3_224(data));
-export const sha3256 = (data: string | Uint8Array) => bytesToHex(sha3_256(data));
-export const sha3384 = (data: string | Uint8Array) => bytesToHex(sha3_384(data));
-export const sha3512 = (data: string | Uint8Array) => bytesToHex(sha3_512(data));
+export function sha3512(data: string | Uint8Array) {
+    return bytesToHex(sha3_512(typeof data === 'string' ? utf8ToBytes(data) : data));
+}

package/src/vue.ts

@@ -5,7 +5,7 @@ import {
     useRoute,
 } from 'vue-router';
 
-import { appendRedirectParamToUrl } from './url';
+import { appendRedirectParamToUrl } from '@/url';
 
 /**
  * Appends the current Vue Router route's fullPath as the `redirect` query parameter to the given URL.

package/src/web.ts

@@ -1,4 +1,4 @@
-import { appendRedirectParamToUrl } from './url';
+import { appendRedirectParamToUrl } from '@/url';
 
 /**
  * Appends the current browser URL (including path, query, and hash) as the `redirect` query parameter to the given URL.

package/dist/buffer.cjs

@@ -1,43 +0,0 @@
-'use strict';
-
-const node_buffer = require('node:buffer');
-
-/**
- * Converts a Blob, Buffer, or File to a Buffer.
- *
- * This function provides a unified way to convert various binary data types
- * to Node.js Buffer. If the input is already a Buffer, it returns it as-is.
- * For Blob or File inputs, it converts them to Buffer via ArrayBuffer.
- *
- * @param {Blob | Buffer | File} input - The input to convert to Buffer
- *
- * @returns {Promise<Buffer>} A Promise that resolves to a Buffer
- *
- * @example
- * ```typescript
- * import { toBuffer } from '@kikiutils/shared/general';
- *
- * // Convert a Buffer (returns as-is)
- * const buffer = Buffer.from('Hello World');
- * const result1 = await toBuffer(buffer);
- * console.log(result1); // <Buffer 48 65 6c 6c 6f 20 57 6f 72 6c 64>
- *
- * // Convert a Blob
- * const blob = new Blob(['Hello from Blob'], { type: 'text/plain' });
- * const result2 = await toBuffer(blob);
- * console.log(result2.toString()); // 'Hello from Blob'
- *
- * // Convert a File
- * const file = new File(['File content'], 'test.txt', { type: 'text/plain' });
- * const result3 = await toBuffer(file);
- * console.log(result3.toString()); // 'File content'
- * ```
- */
-async function toBuffer(input) {
-    if (node_buffer.Buffer.isBuffer(input))
-        return input;
-    return node_buffer.Buffer.from(await input.arrayBuffer());
-}
-
-exports.toBuffer = toBuffer;
-//# sourceMappingURL=buffer.cjs.map

package/dist/buffer.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"buffer.cjs","sources":["../src/buffer.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\nimport type {\n    Blob as NodeBlob,\n    File as NodeFile,\n} from 'node:buffer';\n\n/**\n * Converts a Blob, Buffer, or File to a Buffer.\n *\n * This function provides a unified way to convert various binary data types\n * to Node.js Buffer. If the input is already a Buffer, it returns it as-is.\n * For Blob or File inputs, it converts them to Buffer via ArrayBuffer.\n *\n * @param {Blob | Buffer | File} input - The input to convert to Buffer\n *\n * @returns {Promise<Buffer>} A Promise that resolves to a Buffer\n *\n * @example\n * ```typescript\n * import { toBuffer } from '@kikiutils/shared/general';\n *\n * // Convert a Buffer (returns as-is)\n * const buffer = Buffer.from('Hello World');\n * const result1 = await toBuffer(buffer);\n * console.log(result1); // <Buffer 48 65 6c 6c 6f 20 57 6f 72 6c 64>\n *\n * // Convert a Blob\n * const blob = new Blob(['Hello from Blob'], { type: 'text/plain' });\n * const result2 = await toBuffer(blob);\n * console.log(result2.toString()); // 'Hello from Blob'\n *\n * // Convert a File\n * const file = new File(['File content'], 'test.txt', { type: 'text/plain' });\n * const result3 = await toBuffer(file);\n * console.log(result3.toString()); // 'File content'\n * ```\n */\nexport async function toBuffer(input: Blob | Buffer | File | NodeBlob | NodeFile) {\n    if (Buffer.isBuffer(input)) return input;\n    return Buffer.from(await input.arrayBuffer());\n}\n"],"names":["Buffer"],"mappings":";;;;AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BG;AACI,eAAe,QAAQ,CAAC,KAAiD,EAAA;AAC5E,IAAA,IAAIA,kBAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;AAAE,QAAA,OAAO,KAAK;IACxC,OAAOA,kBAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;AACjD;;;;"}

package/dist/buffer.mjs

@@ -1,41 +0,0 @@
-import { Buffer } from 'node:buffer';
-
-/**
- * Converts a Blob, Buffer, or File to a Buffer.
- *
- * This function provides a unified way to convert various binary data types
- * to Node.js Buffer. If the input is already a Buffer, it returns it as-is.
- * For Blob or File inputs, it converts them to Buffer via ArrayBuffer.
- *
- * @param {Blob | Buffer | File} input - The input to convert to Buffer
- *
- * @returns {Promise<Buffer>} A Promise that resolves to a Buffer
- *
- * @example
- * ```typescript
- * import { toBuffer } from '@kikiutils/shared/general';
- *
- * // Convert a Buffer (returns as-is)
- * const buffer = Buffer.from('Hello World');
- * const result1 = await toBuffer(buffer);
- * console.log(result1); // <Buffer 48 65 6c 6c 6f 20 57 6f 72 6c 64>
- *
- * // Convert a Blob
- * const blob = new Blob(['Hello from Blob'], { type: 'text/plain' });
- * const result2 = await toBuffer(blob);
- * console.log(result2.toString()); // 'Hello from Blob'
- *
- * // Convert a File
- * const file = new File(['File content'], 'test.txt', { type: 'text/plain' });
- * const result3 = await toBuffer(file);
- * console.log(result3.toString()); // 'File content'
- * ```
- */
-async function toBuffer(input) {
-    if (Buffer.isBuffer(input))
-        return input;
-    return Buffer.from(await input.arrayBuffer());
-}
-
-export { toBuffer };
-//# sourceMappingURL=buffer.mjs.map

package/dist/buffer.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"buffer.mjs","sources":["../src/buffer.ts"],"sourcesContent":["import { Buffer } from 'node:buffer';\nimport type {\n    Blob as NodeBlob,\n    File as NodeFile,\n} from 'node:buffer';\n\n/**\n * Converts a Blob, Buffer, or File to a Buffer.\n *\n * This function provides a unified way to convert various binary data types\n * to Node.js Buffer. If the input is already a Buffer, it returns it as-is.\n * For Blob or File inputs, it converts them to Buffer via ArrayBuffer.\n *\n * @param {Blob | Buffer | File} input - The input to convert to Buffer\n *\n * @returns {Promise<Buffer>} A Promise that resolves to a Buffer\n *\n * @example\n * ```typescript\n * import { toBuffer } from '@kikiutils/shared/general';\n *\n * // Convert a Buffer (returns as-is)\n * const buffer = Buffer.from('Hello World');\n * const result1 = await toBuffer(buffer);\n * console.log(result1); // <Buffer 48 65 6c 6c 6f 20 57 6f 72 6c 64>\n *\n * // Convert a Blob\n * const blob = new Blob(['Hello from Blob'], { type: 'text/plain' });\n * const result2 = await toBuffer(blob);\n * console.log(result2.toString()); // 'Hello from Blob'\n *\n * // Convert a File\n * const file = new File(['File content'], 'test.txt', { type: 'text/plain' });\n * const result3 = await toBuffer(file);\n * console.log(result3.toString()); // 'File content'\n * ```\n */\nexport async function toBuffer(input: Blob | Buffer | File | NodeBlob | NodeFile) {\n    if (Buffer.isBuffer(input)) return input;\n    return Buffer.from(await input.arrayBuffer());\n}\n"],"names":[],"mappings":";;AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BG;AACI,eAAe,QAAQ,CAAC,KAAiD,EAAA;AAC5E,IAAA,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;AAAE,QAAA,OAAO,KAAK;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;AACjD;;;;"}

package/dist/clipboard.cjs

@@ -1,91 +0,0 @@
-'use strict';
-
-/**
- * Attempts to copy a Blob (e.g. image, plain text, HTML) to the user's clipboard using the ClipboardItem API.
- *
- * ⚠️ Usage Notes:
- * - Must be called in a **secure context** (HTTPS or localhost).
- * - Must be called **in response to a user interaction** (e.g. click, input).
- * - Not supported in Safari and some older browsers.
- *
- * @param {Blob} blob - The Blob object to copy (e.g. from a File, image, or text content)
- * @param {ClipboardItemOptions} [options] - Optional options passed to the ClipboardItem constructor
- *
- * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:
- *   - `{ ok: true }` if the copy succeeded
- *   - `{ ok: false, error }` if the copy failed, with the error included
- *
- * @example
- * ```typescript
- * import { copyBlobToClipboard } from '@kikiutils/shared/clipboard';
- *
- * const blob = new Blob(['Hello world'], { type: 'text/plain' });
- * const result = await copyBlobToClipboard(blob);
- * if (result.ok) {
- *     console.log('Copied blob!');
- * } else {
- *     console.error('Copy failed:', result.error);
- * }
- * ```
- */
-async function copyBlobToClipboard(blob, options) {
-    if (!navigator.clipboard?.write) {
-        return {
-            error: new Error('Clipboard.write is not supported in this browser'),
-            ok: false,
-        };
-    }
-    try {
-        const item = new ClipboardItem({ [blob.type]: blob }, options);
-        await navigator.clipboard.write([item]);
-        return { ok: true };
-    }
-    catch (error) {
-        return {
-            error,
-            ok: false,
-        };
-    }
-}
-/**
- * Attempts to copy the given text to the user's clipboard using the modern Clipboard API.
- *
- * ⚠️ Usage Notes:
- * - Must be called in a **secure context** (HTTPS or localhost).
- * - Must be called **in response to a user interaction** (e.g. click, input).
- * - Not supported in some older browsers (especially legacy Safari).
- *
- * @param {string} text - The string to be copied to the clipboard
- *
- * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:
- *   - `{ ok: true }` if the copy succeeded
- *   - `{ ok: false, error }` if the copy failed, with the error included
- *
- * @example
- * ```typescript
- * import { copyTextToClipboard } from '@kikiutils/shared/clipboard';
- *
- * const result = await copyTextToClipboard('Hello!');
- * if (result.ok) {
- *     console.log('Copied!');
- * } else {
- *     console.error('Copy failed:', result.error);
- * }
- * ```
- */
-async function copyTextToClipboard(text) {
-    try {
-        await navigator.clipboard.writeText(text);
-        return { ok: true };
-    }
-    catch (error) {
-        return {
-            error,
-            ok: false,
-        };
-    }
-}
-
-exports.copyBlobToClipboard = copyBlobToClipboard;
-exports.copyTextToClipboard = copyTextToClipboard;
-//# sourceMappingURL=clipboard.cjs.map

package/dist/clipboard.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"clipboard.cjs","sources":["../src/clipboard.ts"],"sourcesContent":["type CopyResult =\n  | { error: unknown; ok: false }\n  | { ok: true };\n\n/**\n * Attempts to copy a Blob (e.g. image, plain text, HTML) to the user's clipboard using the ClipboardItem API.\n *\n * ⚠️ Usage Notes:\n * - Must be called in a **secure context** (HTTPS or localhost).\n * - Must be called **in response to a user interaction** (e.g. click, input).\n * - Not supported in Safari and some older browsers.\n *\n * @param {Blob} blob - The Blob object to copy (e.g. from a File, image, or text content)\n * @param {ClipboardItemOptions} [options] - Optional options passed to the ClipboardItem constructor\n *\n * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:\n *   - `{ ok: true }` if the copy succeeded\n *   - `{ ok: false, error }` if the copy failed, with the error included\n *\n * @example\n * ```typescript\n * import { copyBlobToClipboard } from '@kikiutils/shared/clipboard';\n *\n * const blob = new Blob(['Hello world'], { type: 'text/plain' });\n * const result = await copyBlobToClipboard(blob);\n * if (result.ok) {\n *     console.log('Copied blob!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions): Promise<CopyResult> {\n    if (!navigator.clipboard?.write) {\n        return {\n            error: new Error('Clipboard.write is not supported in this browser'),\n            ok: false,\n        };\n    }\n\n    try {\n        const item = new ClipboardItem({ [blob.type]: blob }, options);\n        await navigator.clipboard.write([item]);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n\n/**\n * Attempts to copy the given text to the user's clipboard using the modern Clipboard API.\n *\n * ⚠️ Usage Notes:\n * - Must be called in a **secure context** (HTTPS or localhost).\n * - Must be called **in response to a user interaction** (e.g. click, input).\n * - Not supported in some older browsers (especially legacy Safari).\n *\n * @param {string} text - The string to be copied to the clipboard\n *\n * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:\n *   - `{ ok: true }` if the copy succeeded\n *   - `{ ok: false, error }` if the copy failed, with the error included\n *\n * @example\n * ```typescript\n * import { copyTextToClipboard } from '@kikiutils/shared/clipboard';\n *\n * const result = await copyTextToClipboard('Hello!');\n * if (result.ok) {\n *     console.log('Copied!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyTextToClipboard(text: string): Promise<CopyResult> {\n    try {\n        await navigator.clipboard.writeText(text);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n"],"names":[],"mappings":";;AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;AACI,eAAe,mBAAmB,CAAC,IAAU,EAAE,OAA8B,EAAA;AAChF,IAAA,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE;QAC7B,OAAO;AACH,YAAA,KAAK,EAAE,IAAI,KAAK,CAAC,kDAAkD,CAAC;AACpE,YAAA,EAAE,EAAE,KAAK;SACZ;IACL;AAEA,IAAA,IAAI;AACA,QAAA,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,EAAE,OAAO,CAAC;QAC9D,MAAM,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;AACvC,QAAA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE;IACvB;IAAE,OAAO,KAAK,EAAE;QACZ,OAAO;YACH,KAAK;AACL,YAAA,EAAE,EAAE,KAAK;SACZ;IACL;AACJ;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACI,eAAe,mBAAmB,CAAC,IAAY,EAAA;AAClD,IAAA,IAAI;QACA,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC;AACzC,QAAA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE;IACvB;IAAE,OAAO,KAAK,EAAE;QACZ,OAAO;YACH,KAAK;AACL,YAAA,EAAE,EAAE,KAAK;SACZ;IACL;AACJ;;;;;"}

package/dist/clipboard.mjs

@@ -1,88 +0,0 @@
-/**
- * Attempts to copy a Blob (e.g. image, plain text, HTML) to the user's clipboard using the ClipboardItem API.
- *
- * ⚠️ Usage Notes:
- * - Must be called in a **secure context** (HTTPS or localhost).
- * - Must be called **in response to a user interaction** (e.g. click, input).
- * - Not supported in Safari and some older browsers.
- *
- * @param {Blob} blob - The Blob object to copy (e.g. from a File, image, or text content)
- * @param {ClipboardItemOptions} [options] - Optional options passed to the ClipboardItem constructor
- *
- * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:
- *   - `{ ok: true }` if the copy succeeded
- *   - `{ ok: false, error }` if the copy failed, with the error included
- *
- * @example
- * ```typescript
- * import { copyBlobToClipboard } from '@kikiutils/shared/clipboard';
- *
- * const blob = new Blob(['Hello world'], { type: 'text/plain' });
- * const result = await copyBlobToClipboard(blob);
- * if (result.ok) {
- *     console.log('Copied blob!');
- * } else {
- *     console.error('Copy failed:', result.error);
- * }
- * ```
- */
-async function copyBlobToClipboard(blob, options) {
-    if (!navigator.clipboard?.write) {
-        return {
-            error: new Error('Clipboard.write is not supported in this browser'),
-            ok: false,
-        };
-    }
-    try {
-        const item = new ClipboardItem({ [blob.type]: blob }, options);
-        await navigator.clipboard.write([item]);
-        return { ok: true };
-    }
-    catch (error) {
-        return {
-            error,
-            ok: false,
-        };
-    }
-}
-/**
- * Attempts to copy the given text to the user's clipboard using the modern Clipboard API.
- *
- * ⚠️ Usage Notes:
- * - Must be called in a **secure context** (HTTPS or localhost).
- * - Must be called **in response to a user interaction** (e.g. click, input).
- * - Not supported in some older browsers (especially legacy Safari).
- *
- * @param {string} text - The string to be copied to the clipboard
- *
- * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:
- *   - `{ ok: true }` if the copy succeeded
- *   - `{ ok: false, error }` if the copy failed, with the error included
- *
- * @example
- * ```typescript
- * import { copyTextToClipboard } from '@kikiutils/shared/clipboard';
- *
- * const result = await copyTextToClipboard('Hello!');
- * if (result.ok) {
- *     console.log('Copied!');
- * } else {
- *     console.error('Copy failed:', result.error);
- * }
- * ```
- */
-async function copyTextToClipboard(text) {
-    try {
-        await navigator.clipboard.writeText(text);
-        return { ok: true };
-    }
-    catch (error) {
-        return {
-            error,
-            ok: false,
-        };
-    }
-}
-
-export { copyBlobToClipboard, copyTextToClipboard };
-//# sourceMappingURL=clipboard.mjs.map

package/dist/clipboard.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"clipboard.mjs","sources":["../src/clipboard.ts"],"sourcesContent":["type CopyResult =\n  | { error: unknown; ok: false }\n  | { ok: true };\n\n/**\n * Attempts to copy a Blob (e.g. image, plain text, HTML) to the user's clipboard using the ClipboardItem API.\n *\n * ⚠️ Usage Notes:\n * - Must be called in a **secure context** (HTTPS or localhost).\n * - Must be called **in response to a user interaction** (e.g. click, input).\n * - Not supported in Safari and some older browsers.\n *\n * @param {Blob} blob - The Blob object to copy (e.g. from a File, image, or text content)\n * @param {ClipboardItemOptions} [options] - Optional options passed to the ClipboardItem constructor\n *\n * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:\n *   - `{ ok: true }` if the copy succeeded\n *   - `{ ok: false, error }` if the copy failed, with the error included\n *\n * @example\n * ```typescript\n * import { copyBlobToClipboard } from '@kikiutils/shared/clipboard';\n *\n * const blob = new Blob(['Hello world'], { type: 'text/plain' });\n * const result = await copyBlobToClipboard(blob);\n * if (result.ok) {\n *     console.log('Copied blob!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions): Promise<CopyResult> {\n    if (!navigator.clipboard?.write) {\n        return {\n            error: new Error('Clipboard.write is not supported in this browser'),\n            ok: false,\n        };\n    }\n\n    try {\n        const item = new ClipboardItem({ [blob.type]: blob }, options);\n        await navigator.clipboard.write([item]);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n\n/**\n * Attempts to copy the given text to the user's clipboard using the modern Clipboard API.\n *\n * ⚠️ Usage Notes:\n * - Must be called in a **secure context** (HTTPS or localhost).\n * - Must be called **in response to a user interaction** (e.g. click, input).\n * - Not supported in some older browsers (especially legacy Safari).\n *\n * @param {string} text - The string to be copied to the clipboard\n *\n * @returns {Promise<CopyResult>} A promise resolving to a `CopyResult`:\n *   - `{ ok: true }` if the copy succeeded\n *   - `{ ok: false, error }` if the copy failed, with the error included\n *\n * @example\n * ```typescript\n * import { copyTextToClipboard } from '@kikiutils/shared/clipboard';\n *\n * const result = await copyTextToClipboard('Hello!');\n * if (result.ok) {\n *     console.log('Copied!');\n * } else {\n *     console.error('Copy failed:', result.error);\n * }\n * ```\n */\nexport async function copyTextToClipboard(text: string): Promise<CopyResult> {\n    try {\n        await navigator.clipboard.writeText(text);\n        return { ok: true };\n    } catch (error) {\n        return {\n            error,\n            ok: false,\n        };\n    }\n}\n"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2BG;AACI,eAAe,mBAAmB,CAAC,IAAU,EAAE,OAA8B,EAAA;AAChF,IAAA,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE;QAC7B,OAAO;AACH,YAAA,KAAK,EAAE,IAAI,KAAK,CAAC,kDAAkD,CAAC;AACpE,YAAA,EAAE,EAAE,KAAK;SACZ;IACL;AAEA,IAAA,IAAI;AACA,QAAA,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,EAAE,EAAE,OAAO,CAAC;QAC9D,MAAM,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;AACvC,QAAA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE;IACvB;IAAE,OAAO,KAAK,EAAE;QACZ,OAAO;YACH,KAAK;AACL,YAAA,EAAE,EAAE,KAAK;SACZ;IACL;AACJ;AAEA;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;AACI,eAAe,mBAAmB,CAAC,IAAY,EAAA;AAClD,IAAA,IAAI;QACA,MAAM,SAAS,CAAC,SAAS,CAAC,SAAS,CAAC,IAAI,CAAC;AACzC,QAAA,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE;IACvB;IAAE,OAAO,KAAK,EAAE;QACZ,OAAO;YACH,KAAK;AACL,YAAA,EAAE,EAAE,KAAK;SACZ;IACL;AACJ;;;;"}

package/dist/consola.cjs

@@ -1,35 +0,0 @@
-'use strict';
-
-const consola = require('consola');
-
-/**
- * A consola logger instance.
- *
- * The logger's level is determined based on the `CONSOLA_LOGGER_LEVEL` and `NODE_ENV` environment variables.
- * If `CONSOLA_LOGGER_LEVEL` is set, it will be used; otherwise, if `NODE_ENV` is `production`,
- * the level will be set to `0`.
- *
- * To manually change the level, assign the desired level to `logger.level`.
- *
- * See available levels [here](https://github.com/unjs/consola?tab=readme-ov-file#log-level).
- *
- * @example
- * ```typescript
- * import { logger } from '@kikiutils/shared/consola';
- *
- * logger.info('test'); // ℹ test 3:56:30 AM
- *
- * // Manually change the level
- * logger.level = 3;
- * ```
- */
-const consolaLogger = consola.createConsola();
-const logger = consolaLogger;
-if (process.env.CONSOLA_LOGGER_LEVEL !== undefined)
-    consolaLogger.level = +process.env.CONSOLA_LOGGER_LEVEL;
-else
-    consolaLogger.level = process.env.NODE_ENV === 'production' ? 0 : consolaLogger.level;
-
-exports.consolaLogger = consolaLogger;
-exports.logger = logger;
-//# sourceMappingURL=consola.cjs.map

package/dist/consola.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"consola.cjs","sources":["../src/consola.ts"],"sourcesContent":["import { createConsola } from 'consola';\n\n/**\n * A consola logger instance.\n *\n * The logger's level is determined based on the `CONSOLA_LOGGER_LEVEL` and `NODE_ENV` environment variables.\n * If `CONSOLA_LOGGER_LEVEL` is set, it will be used; otherwise, if `NODE_ENV` is `production`,\n * the level will be set to `0`.\n *\n * To manually change the level, assign the desired level to `logger.level`.\n *\n * See available levels [here](https://github.com/unjs/consola?tab=readme-ov-file#log-level).\n *\n * @example\n * ```typescript\n * import { logger } from '@kikiutils/shared/consola';\n *\n * logger.info('test'); // ℹ test 3:56:30 AM\n *\n * // Manually change the level\n * logger.level = 3;\n * ```\n */\nexport const consolaLogger = createConsola();\nexport const logger = consolaLogger;\nif (process.env.CONSOLA_LOGGER_LEVEL !== undefined) consolaLogger.level = +process.env.CONSOLA_LOGGER_LEVEL;\nelse consolaLogger.level = process.env.NODE_ENV === 'production' ? 0 : consolaLogger.level;\n"],"names":["createConsola"],"mappings":";;;;AAEA;;;;;;;;;;;;;;;;;;;;AAoBG;AACI,MAAM,aAAa,GAAGA,qBAAa;AACnC,MAAM,MAAM,GAAG;AACtB,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,SAAS;IAAE,aAAa,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB;;IACtG,aAAa,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK;;;;;"}

package/dist/consola.mjs

@@ -1,32 +0,0 @@
-import { createConsola } from 'consola';
-
-/**
- * A consola logger instance.
- *
- * The logger's level is determined based on the `CONSOLA_LOGGER_LEVEL` and `NODE_ENV` environment variables.
- * If `CONSOLA_LOGGER_LEVEL` is set, it will be used; otherwise, if `NODE_ENV` is `production`,
- * the level will be set to `0`.
- *
- * To manually change the level, assign the desired level to `logger.level`.
- *
- * See available levels [here](https://github.com/unjs/consola?tab=readme-ov-file#log-level).
- *
- * @example
- * ```typescript
- * import { logger } from '@kikiutils/shared/consola';
- *
- * logger.info('test'); // ℹ test 3:56:30 AM
- *
- * // Manually change the level
- * logger.level = 3;
- * ```
- */
-const consolaLogger = createConsola();
-const logger = consolaLogger;
-if (process.env.CONSOLA_LOGGER_LEVEL !== undefined)
-    consolaLogger.level = +process.env.CONSOLA_LOGGER_LEVEL;
-else
-    consolaLogger.level = process.env.NODE_ENV === 'production' ? 0 : consolaLogger.level;
-
-export { consolaLogger, logger };
-//# sourceMappingURL=consola.mjs.map

package/dist/consola.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"consola.mjs","sources":["../src/consola.ts"],"sourcesContent":["import { createConsola } from 'consola';\n\n/**\n * A consola logger instance.\n *\n * The logger's level is determined based on the `CONSOLA_LOGGER_LEVEL` and `NODE_ENV` environment variables.\n * If `CONSOLA_LOGGER_LEVEL` is set, it will be used; otherwise, if `NODE_ENV` is `production`,\n * the level will be set to `0`.\n *\n * To manually change the level, assign the desired level to `logger.level`.\n *\n * See available levels [here](https://github.com/unjs/consola?tab=readme-ov-file#log-level).\n *\n * @example\n * ```typescript\n * import { logger } from '@kikiutils/shared/consola';\n *\n * logger.info('test'); // ℹ test 3:56:30 AM\n *\n * // Manually change the level\n * logger.level = 3;\n * ```\n */\nexport const consolaLogger = createConsola();\nexport const logger = consolaLogger;\nif (process.env.CONSOLA_LOGGER_LEVEL !== undefined) consolaLogger.level = +process.env.CONSOLA_LOGGER_LEVEL;\nelse consolaLogger.level = process.env.NODE_ENV === 'production' ? 0 : consolaLogger.level;\n"],"names":[],"mappings":";;AAEA;;;;;;;;;;;;;;;;;;;;AAoBG;AACI,MAAM,aAAa,GAAG,aAAa;AACnC,MAAM,MAAM,GAAG;AACtB,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,KAAK,SAAS;IAAE,aAAa,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB;;IACtG,aAAa,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK;;;;"}