@kikiutils/shared 9.1.0 → 9.3.0

package/README.md

@@ -5,24 +5,25 @@
 [![codecov][codecov-src]][codecov-href]
 [![License][license-src]][license-href]
 
-A lightweight modular utility library for JavaScript and TypeScript, offering secure hashing, flexible logging, date utilities, Vue/web helpers, and more.
+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.
 
 - [✨ Release Notes](./CHANGELOG.md)
 
 ## Features
 
-- 📜 Simple and flexible logging with Consola and Pino
-- 🔒 Secure hash utilities: MD5, SHA3-224/256/384/512
-- 📅 Datetime utilities for formatting, ranges, and offsets
-- 🔢 Enum helpers to extract values and keys
-- 🌱 Environment variable checker with error handling (Node only)
-- 📈 Math utilities like percentage formatting and rounding
-- 💎 Number formatting (e.g. compact, currency, padding)
-- 🔤 String tools such as random string generation and casing helpers
-- 🌐 URL utilities for parsing and building query strings
-- 🖥️ Web utilities using DOM APIs (e.g. `scrollToTop`) (Browser only)
-- 🧩 Vue 3 utilities
-- ⚙️ General-purpose utilities like value extractors and type guards
+- 📋 Clipboard utilities — copy text and blobs using the modern Clipboard API (Browser only)
+- 📜 Logging utilities — simple and extensible logging via Consola and Pino
+- 🔒 Crypto utilities — secure hashing functions: MD5, SHA3-224/256/384/512
+- 📅 Datetime utilities — manipulate, format, and offset dates and ranges
+- 🔢 Enum utilities — extract enum keys and values (number or string)
+- 🌱 Environment helpers — safe env var access with error handling (Node only)
+- 📈 Math utilities — rounding, formatting percentages, and ratios
+- 💎 Number utilities — number padding, compact display, currency formatting
+- 🔤 String utilities — casing, trimming, random string generation, etc.
+- 🌐 URL utilities — parse and construct query strings and redirect URLs
+- 🧩 Vue 3 utilities — composables like scroll preservation and key handling
+- 🖥️ Web utilities — browser DOM helpers (e.g. scroll to top, key matching)
+- 🗄️ Storage utilities — enhanced localStorage, Redis, and LRU abstractions
 - 📦 Modular by design — import only what you need via `@kikiutils/shared/<module>`
 
 ## Requirements
@@ -66,9 +67,14 @@ logger.info(value);
 
 Each module file includes function-level comments and usage examples.
 
+### [clipboard](./src/clipboard.ts)
+
+- `copyBlobToClipboard`
+- `copyTextToClipboard`
+
 ### [consola](./src/consola.ts)
 
-- Console logger integration
+Console logger integration.
 
 ### [crypto-hash](./src/crypto-hash.ts)
 
@@ -114,12 +120,28 @@ Each module file includes function-level comments and usage examples.
 
 ### [pino](./src/pino.ts)
 
-- Pino logger integration
+Pino logger integration.
 
 ### [random](./src/random.ts)
 
 - `generateWithNestedRandomLength`
 
+### storage
+
+#### [enhanced-local](./src/storage/enhanced/local/index.ts)
+
+- `createKeyedEnhancedLocalStore`
+- `enhancedLocalStorage`
+
+#### [enhanced-redis](./src/storage/enhanced/redis/index.ts)
+
+- `createEnhancedRedisStorage`
+- `createKeyedEnhancedRedisStore`
+
+#### [lru/keyed-store](./src/storage/lru/keyed-store.ts)
+
+- `createKeyedLruStore`
+
 ### [string](./src/string.ts)
 
 - `randomString`

package/dist/clipboard.cjs

@@ -0,0 +1,87 @@
+'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
+ * 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
+ * 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

@@ -0,0 +1 @@
+{"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 * 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 * 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;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;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,mDAAmD,CAAC;AACrE,YAAA,EAAE,EAAE,KAAK;SACZ;;AAGL,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;;IACrB,OAAO,KAAK,EAAE;QACZ,OAAO;YACH,KAAK;AACL,YAAA,EAAE,EAAE,KAAK;SACZ;;AAET;AAEA;;;;;;;;;;;;;;;;;;;;;;;AAuBG;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;;IACrB,OAAO,KAAK,EAAE;QACZ,OAAO;YACH,KAAK;AACL,YAAA,EAAE,EAAE,KAAK;SACZ;;AAET;;;;;"}

package/dist/clipboard.d.ts

@@ -0,0 +1,60 @@
+type CopyResult = {
+    error: unknown;
+    ok: false;
+} | {
+    ok: true;
+};
+/**
+ * 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
+ * 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);
+ * }
+ * ```
+ */
+export declare function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions): Promise<CopyResult>;
+/**
+ * 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
+ * const result = await copyTextToClipboard('Hello!');
+ * if (result.ok) {
+ *     console.log('Copied!');
+ * } else {
+ *     console.error('Copy failed:', result.error);
+ * }
+ * ```
+ */
+export declare function copyTextToClipboard(text: string): Promise<CopyResult>;
+export {};
+//# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../src/clipboard.ts"],"names":[],"mappings":"AAAA,KAAK,UAAU,GACX;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,KAAK,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkBzG;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAU3E"}

package/dist/clipboard.mjs

@@ -0,0 +1,84 @@
+/**
+ * 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
+ * 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
+ * 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

@@ -0,0 +1 @@
+{"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 * 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 * 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;;;;;;;;;;;;;;;;;;;;;;;;;AAyBG;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,mDAAmD,CAAC;AACrE,YAAA,EAAE,EAAE,KAAK;SACZ;;AAGL,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;;IACrB,OAAO,KAAK,EAAE;QACZ,OAAO;YACH,KAAK;AACL,YAAA,EAAE,EAAE,KAAK;SACZ;;AAET;AAEA;;;;;;;;;;;;;;;;;;;;;;;AAuBG;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;;IACrB,OAAO,KAAK,EAAE;QACZ,OAAO;YACH,KAAK;AACL,YAAA,EAAE,EAAE,KAAK;SACZ;;AAET;;;;"}

package/dist/env.cjs

@@ -22,9 +22,12 @@ class EnvironmentNotFoundError extends Error {
     }
 }
 /**
- * Retrieves the value of an environment variable, or throws an error if not set.
+ * Retrieves the value of an environment variable, or throws an error if it is not defined.
  *
- * @param {string} key - The environment variable key to check.
+ * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string
+ * value like `'0'` or `'false'` is considered a valid (defined) value.
+ *
+ * @param {string} key - The environment variable key to retrieve.
  *
  * @returns {string} The value of the environment variable.
  *
@@ -32,21 +35,15 @@ class EnvironmentNotFoundError extends Error {
  *
  * @example
  * ```typescript
- * import { checkAndGetEnvValue } from '@kikiutils/shared/env';
- *
- * // When the environment variable 'API_KEY' is set:
- * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY
+ * process.env.API_KEY = '';
+ * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered "defined")
  *
- * // When the environment variable 'API_KEY' is not set:
- * try {
- *   const apiKey = checkAndGetEnvValue('API_KEY');
- * } catch (error) {
- *   console.error(error); // Missing environment variable: API_KEY
- * }
+ * delete process.env.API_KEY;
+ * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError
  * ```
  */
 function checkAndGetEnvValue(key) {
-    if (!process.env[key])
+    if (process.env[key] === undefined)
         throw new EnvironmentNotFoundError(key);
     return process.env[key];
 }

package/dist/env.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.cjs","sources":["../src/env.ts"],"sourcesContent":["/**\n * Custom error class for handling missing environment variables.\n *\n * Extends the built-in `Error` class and includes the missing key.\n *\n * @extends {Error}\n */\nexport class EnvironmentNotFoundError extends Error {\n    readonly key: string;\n\n    /**\n     * Creates a new EnvironmentNotFoundError.\n     *\n     * @param {string} key - The missing environment variable key.\n     */\n    constructor(key: string) {\n        super(`Missing environment variable: ${key}`);\n        this.key = key;\n        this.name = this.constructor.name;\n        Error.captureStackTrace?.(this, this.constructor);\n    }\n}\n\n/**\n * Retrieves the value of an environment variable, or throws an error if not set.\n *\n * @param {string} key - The environment variable key to check.\n *\n * @returns {string} The value of the environment variable.\n *\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined.\n *\n * @example\n * ```typescript\n * import { checkAndGetEnvValue } from '@kikiutils/shared/env';\n *\n * // When the environment variable 'API_KEY' is set:\n * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY\n *\n * // When the environment variable 'API_KEY' is not set:\n * try {\n *   const apiKey = checkAndGetEnvValue('API_KEY');\n * } catch (error) {\n *   console.error(error); // Missing environment variable: API_KEY\n * }\n * ```\n */\nexport function checkAndGetEnvValue(key: string): string {\n    if (!process.env[key]) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"names":[],"mappings":";;AAAA;;;;;;AAMG;AACG,MAAO,wBAAyB,SAAQ,KAAK,CAAA;AACtC,IAAA,GAAG;AAEZ;;;;AAIG;AACH,IAAA,WAAA,CAAY,GAAW,EAAA;AACnB,QAAA,KAAK,CAAC,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAE,CAAC;AAC7C,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI;QACjC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;;AAExD;AAED;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACG,SAAU,mBAAmB,CAAC,GAAW,EAAA;AAC3C,IAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAAE,QAAA,MAAM,IAAI,wBAAwB,CAAC,GAAG,CAAC;AAC9D,IAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3B;;;;;"}
+{"version":3,"file":"env.cjs","sources":["../src/env.ts"],"sourcesContent":["/**\n * Custom error class for handling missing environment variables.\n *\n * Extends the built-in `Error` class and includes the missing key.\n *\n * @extends {Error}\n */\nexport class EnvironmentNotFoundError extends Error {\n    readonly key: string;\n\n    /**\n     * Creates a new EnvironmentNotFoundError.\n     *\n     * @param {string} key - The missing environment variable key.\n     */\n    constructor(key: string) {\n        super(`Missing environment variable: ${key}`);\n        this.key = key;\n        this.name = this.constructor.name;\n        Error.captureStackTrace?.(this, this.constructor);\n    }\n}\n\n/**\n * Retrieves the value of an environment variable, or throws an error if it is not defined.\n *\n * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string\n * value like `'0'` or `'false'` is considered a valid (defined) value.\n *\n * @param {string} key - The environment variable key to retrieve.\n *\n * @returns {string} The value of the environment variable.\n *\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined.\n *\n * @example\n * ```typescript\n * process.env.API_KEY = '';\n * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered \"defined\")\n *\n * delete process.env.API_KEY;\n * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError\n * ```\n */\nexport function checkAndGetEnvValue(key: string): string {\n    if (process.env[key] === undefined) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"names":[],"mappings":";;AAAA;;;;;;AAMG;AACG,MAAO,wBAAyB,SAAQ,KAAK,CAAA;AACtC,IAAA,GAAG;AAEZ;;;;AAIG;AACH,IAAA,WAAA,CAAY,GAAW,EAAA;AACnB,QAAA,KAAK,CAAC,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAE,CAAC;AAC7C,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI;QACjC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;;AAExD;AAED;;;;;;;;;;;;;;;;;;;;AAoBG;AACG,SAAU,mBAAmB,CAAC,GAAW,EAAA;AAC3C,IAAA,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;AAAE,QAAA,MAAM,IAAI,wBAAwB,CAAC,GAAG,CAAC;AAC3E,IAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3B;;;;;"}

package/dist/env.d.ts

@@ -15,9 +15,12 @@ export declare class EnvironmentNotFoundError extends Error {
     constructor(key: string);
 }
 /**
- * Retrieves the value of an environment variable, or throws an error if not set.
+ * Retrieves the value of an environment variable, or throws an error if it is not defined.
  *
- * @param {string} key - The environment variable key to check.
+ * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string
+ * value like `'0'` or `'false'` is considered a valid (defined) value.
+ *
+ * @param {string} key - The environment variable key to retrieve.
  *
  * @returns {string} The value of the environment variable.
  *
@@ -25,17 +28,11 @@ export declare class EnvironmentNotFoundError extends Error {
  *
  * @example
  * ```typescript
- * import { checkAndGetEnvValue } from '@kikiutils/shared/env';
- *
- * // When the environment variable 'API_KEY' is set:
- * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY
+ * process.env.API_KEY = '';
+ * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered "defined")
  *
- * // When the environment variable 'API_KEY' is not set:
- * try {
- *   const apiKey = checkAndGetEnvValue('API_KEY');
- * } catch (error) {
- *   console.error(error); // Missing environment variable: API_KEY
- * }
+ * delete process.env.API_KEY;
+ * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError
  * ```
  */
 export declare function checkAndGetEnvValue(key: string): string;

package/dist/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;;;OAIG;gBACS,GAAG,EAAE,MAAM;CAM1B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvD"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,wBAAyB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;;;OAIG;gBACS,GAAG,EAAE,MAAM;CAM1B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/dist/env.mjs

@@ -20,9 +20,12 @@ class EnvironmentNotFoundError extends Error {
     }
 }
 /**
- * Retrieves the value of an environment variable, or throws an error if not set.
+ * Retrieves the value of an environment variable, or throws an error if it is not defined.
  *
- * @param {string} key - The environment variable key to check.
+ * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string
+ * value like `'0'` or `'false'` is considered a valid (defined) value.
+ *
+ * @param {string} key - The environment variable key to retrieve.
  *
  * @returns {string} The value of the environment variable.
  *
@@ -30,21 +33,15 @@ class EnvironmentNotFoundError extends Error {
  *
  * @example
  * ```typescript
- * import { checkAndGetEnvValue } from '@kikiutils/shared/env';
- *
- * // When the environment variable 'API_KEY' is set:
- * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY
+ * process.env.API_KEY = '';
+ * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered "defined")
  *
- * // When the environment variable 'API_KEY' is not set:
- * try {
- *   const apiKey = checkAndGetEnvValue('API_KEY');
- * } catch (error) {
- *   console.error(error); // Missing environment variable: API_KEY
- * }
+ * delete process.env.API_KEY;
+ * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError
  * ```
  */
 function checkAndGetEnvValue(key) {
-    if (!process.env[key])
+    if (process.env[key] === undefined)
         throw new EnvironmentNotFoundError(key);
     return process.env[key];
 }

package/dist/env.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"env.mjs","sources":["../src/env.ts"],"sourcesContent":["/**\n * Custom error class for handling missing environment variables.\n *\n * Extends the built-in `Error` class and includes the missing key.\n *\n * @extends {Error}\n */\nexport class EnvironmentNotFoundError extends Error {\n    readonly key: string;\n\n    /**\n     * Creates a new EnvironmentNotFoundError.\n     *\n     * @param {string} key - The missing environment variable key.\n     */\n    constructor(key: string) {\n        super(`Missing environment variable: ${key}`);\n        this.key = key;\n        this.name = this.constructor.name;\n        Error.captureStackTrace?.(this, this.constructor);\n    }\n}\n\n/**\n * Retrieves the value of an environment variable, or throws an error if not set.\n *\n * @param {string} key - The environment variable key to check.\n *\n * @returns {string} The value of the environment variable.\n *\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined.\n *\n * @example\n * ```typescript\n * import { checkAndGetEnvValue } from '@kikiutils/shared/env';\n *\n * // When the environment variable 'API_KEY' is set:\n * console.log(checkAndGetEnvValue('API_KEY')); // value of API_KEY\n *\n * // When the environment variable 'API_KEY' is not set:\n * try {\n *   const apiKey = checkAndGetEnvValue('API_KEY');\n * } catch (error) {\n *   console.error(error); // Missing environment variable: API_KEY\n * }\n * ```\n */\nexport function checkAndGetEnvValue(key: string): string {\n    if (!process.env[key]) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"names":[],"mappings":"AAAA;;;;;;AAMG;AACG,MAAO,wBAAyB,SAAQ,KAAK,CAAA;AACtC,IAAA,GAAG;AAEZ;;;;AAIG;AACH,IAAA,WAAA,CAAY,GAAW,EAAA;AACnB,QAAA,KAAK,CAAC,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAE,CAAC;AAC7C,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI;QACjC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;;AAExD;AAED;;;;;;;;;;;;;;;;;;;;;;;AAuBG;AACG,SAAU,mBAAmB,CAAC,GAAW,EAAA;AAC3C,IAAA,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAAE,QAAA,MAAM,IAAI,wBAAwB,CAAC,GAAG,CAAC;AAC9D,IAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3B;;;;"}
+{"version":3,"file":"env.mjs","sources":["../src/env.ts"],"sourcesContent":["/**\n * Custom error class for handling missing environment variables.\n *\n * Extends the built-in `Error` class and includes the missing key.\n *\n * @extends {Error}\n */\nexport class EnvironmentNotFoundError extends Error {\n    readonly key: string;\n\n    /**\n     * Creates a new EnvironmentNotFoundError.\n     *\n     * @param {string} key - The missing environment variable key.\n     */\n    constructor(key: string) {\n        super(`Missing environment variable: ${key}`);\n        this.key = key;\n        this.name = this.constructor.name;\n        Error.captureStackTrace?.(this, this.constructor);\n    }\n}\n\n/**\n * Retrieves the value of an environment variable, or throws an error if it is not defined.\n *\n * Only checks for `process.env[key] === undefined`. An empty string (e.g. '') or any falsy string\n * value like `'0'` or `'false'` is considered a valid (defined) value.\n *\n * @param {string} key - The environment variable key to retrieve.\n *\n * @returns {string} The value of the environment variable.\n *\n * @throws {EnvironmentNotFoundError} If the environment variable is not defined.\n *\n * @example\n * ```typescript\n * process.env.API_KEY = '';\n * checkAndGetEnvValue('API_KEY'); // ✅ Returns '' (still considered \"defined\")\n *\n * delete process.env.API_KEY;\n * checkAndGetEnvValue('API_KEY'); // ❌ Throws EnvironmentNotFoundError\n * ```\n */\nexport function checkAndGetEnvValue(key: string): string {\n    if (process.env[key] === undefined) throw new EnvironmentNotFoundError(key);\n    return process.env[key];\n}\n"],"names":[],"mappings":"AAAA;;;;;;AAMG;AACG,MAAO,wBAAyB,SAAQ,KAAK,CAAA;AACtC,IAAA,GAAG;AAEZ;;;;AAIG;AACH,IAAA,WAAA,CAAY,GAAW,EAAA;AACnB,QAAA,KAAK,CAAC,CAAA,8BAAA,EAAiC,GAAG,CAAA,CAAE,CAAC;AAC7C,QAAA,IAAI,CAAC,GAAG,GAAG,GAAG;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI;QACjC,KAAK,CAAC,iBAAiB,GAAG,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC;;AAExD;AAED;;;;;;;;;;;;;;;;;;;;AAoBG;AACG,SAAU,mBAAmB,CAAC,GAAW,EAAA;AAC3C,IAAA,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;AAAE,QAAA,MAAM,IAAI,wBAAwB,CAAC,GAAG,CAAC;AAC3E,IAAA,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;AAC3B;;;;"}

package/dist/storage/enhanced/local/core.cjs

@@ -0,0 +1,103 @@
+'use strict';
+
+const superjson = require('superjson');
+
+var StorageValueEncodingType;
+(function (StorageValueEncodingType) {
+    StorageValueEncodingType["Json"] = "0";
+    StorageValueEncodingType["String"] = "1";
+})(StorageValueEncodingType || (StorageValueEncodingType = {}));
+const customValueHeader = '​⁠';
+const customValueHeaderLength = customValueHeader.length + 1;
+const toCustomValue = (type, payload) => `${customValueHeader}${type}${payload}`;
+/**
+ * An enhanced localStorage wrapper that supports storing
+ * complex data types (e.g. Dates, Maps, Sets) using SuperJSON encoding.
+ *
+ * This utility preserves type structure when saving and retrieving values.
+ *
+ * @example
+ * ```typescript
+ * enhancedLocalStorage.setItem('user', { name: 'user', createdAt: new Date() });
+ * const user = enhancedLocalStorage.getItem<{ name: string, createdAt: Date }>('user');
+ * ```
+ */
+const enhancedLocalStorage = Object.freeze({
+    /**
+     * Removes all items from localStorage.
+     */
+    clear: () => window.localStorage.clear(),
+    /**
+     * Retrieves a value by key and decodes it using SuperJSON or raw string.
+     *
+     * @template T - The expected type of the value.
+     *
+     * @param {string} key - The key of the value to retrieve.
+     *
+     * @returns {null | T} The decoded value or null if not found.
+     */
+    getItem(key) {
+        const rawValue = window.localStorage.getItem(key);
+        return rawValue ? decodeStorageValue(rawValue) : null;
+    },
+    /**
+     * Checks whether a key exists in localStorage.
+     *
+     * @param {string} key - The key to check.
+     *
+     * @returns {boolean} True if the key exists, false otherwise.
+     */
+    hasItem: (key) => window.localStorage.getItem(key) !== null,
+    /**
+     * Returns the number of items stored in localStorage.
+     *
+     * @returns {number} The number of items stored in localStorage.
+     */
+    get length() {
+        return window.localStorage.length;
+    },
+    /**
+     * Removes a specific key from localStorage.
+     *
+     * @param {string} key - The key to remove.
+     */
+    removeItem: (key) => window.localStorage.removeItem(key),
+    /**
+     * Stores a value in localStorage with automatic serialization.
+     *
+     * @param {string} key - The key to store the value under.
+     * @param {any} value - The value to store.
+     */
+    setItem: (key, value) => window.localStorage.setItem(key, encodeToStorageValue(value)),
+});
+function decodeStorageValue(data) {
+    if (!isCustomFormat(data))
+        return data;
+    const payload = data.substring(customValueHeaderLength);
+    const type = data.charAt(customValueHeader.length);
+    switch (type) {
+        case StorageValueEncodingType.Json:
+            try {
+                return superjson.deserialize(JSON.parse(payload));
+            }
+            catch {
+                throw new Error('[EnhancedLocalStorage] Failed to parse JSON payload.');
+            }
+        case StorageValueEncodingType.String: return payload;
+        default:
+            throw new Error(`[EnhancedLocalStorage] Unknown encoding type: ${type}.`);
+    }
+}
+function encodeToStorageValue(value) {
+    if (typeof value === 'string')
+        return toCustomValue(StorageValueEncodingType.String, value);
+    return toCustomValue(StorageValueEncodingType.Json, JSON.stringify(superjson.serialize(value)));
+}
+function isCustomFormat(data) {
+    return (data.length >= customValueHeaderLength
+        && data[0] === customValueHeader[0]
+        && data[1] === customValueHeader[1]);
+}
+
+exports.enhancedLocalStorage = enhancedLocalStorage;
+//# sourceMappingURL=core.cjs.map

package/dist/storage/enhanced/local/core.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.cjs","sources":["../../../../src/storage/enhanced/local/core.ts"],"sourcesContent":["import {\n    deserialize,\n    serialize,\n} from 'superjson';\n\nenum StorageValueEncodingType {\n    Json = '0',\n    String = '1',\n}\n\nconst customValueHeader = '​⁠';\nconst customValueHeaderLength = customValueHeader.length + 1;\nconst toCustomValue = (type: StorageValueEncodingType, payload: string) => `${customValueHeader}${type}${payload}`;\n\n/**\n * An enhanced localStorage wrapper that supports storing\n * complex data types (e.g. Dates, Maps, Sets) using SuperJSON encoding.\n *\n * This utility preserves type structure when saving and retrieving values.\n *\n * @example\n * ```typescript\n * enhancedLocalStorage.setItem('user', { name: 'user', createdAt: new Date() });\n * const user = enhancedLocalStorage.getItem<{ name: string, createdAt: Date }>('user');\n * ```\n */\nexport const enhancedLocalStorage = Object.freeze({\n    /**\n     * Removes all items from localStorage.\n     */\n    clear: () => window.localStorage.clear(),\n    /**\n     * Retrieves a value by key and decodes it using SuperJSON or raw string.\n     *\n     * @template T - The expected type of the value.\n     *\n     * @param {string} key - The key of the value to retrieve.\n     *\n     * @returns {null | T} The decoded value or null if not found.\n     */\n    getItem<T = unknown>(key: string) {\n        const rawValue = window.localStorage.getItem(key);\n        return rawValue ? decodeStorageValue(rawValue) as T : null;\n    },\n    /**\n     * Checks whether a key exists in localStorage.\n     *\n     * @param {string} key - The key to check.\n     *\n     * @returns {boolean} True if the key exists, false otherwise.\n     */\n    hasItem: (key: string) => window.localStorage.getItem(key) !== null,\n    /**\n     * Returns the number of items stored in localStorage.\n     *\n     * @returns {number} The number of items stored in localStorage.\n     */\n    get length() {\n        return window.localStorage.length;\n    },\n    /**\n     * Removes a specific key from localStorage.\n     *\n     * @param {string} key - The key to remove.\n     */\n    removeItem: (key: string) => window.localStorage.removeItem(key),\n    /**\n     * Stores a value in localStorage with automatic serialization.\n     *\n     * @param {string} key - The key to store the value under.\n     * @param {any} value - The value to store.\n     */\n    setItem: (key: string, value: any) => window.localStorage.setItem(key, encodeToStorageValue(value)),\n});\n\nfunction decodeStorageValue(data: string) {\n    if (!isCustomFormat(data)) return data;\n    const payload = data.substring(customValueHeaderLength);\n    const type = data.charAt(customValueHeader.length);\n    switch (type) {\n        case StorageValueEncodingType.Json:\n            try {\n                return deserialize(JSON.parse(payload));\n            } catch {\n                throw new Error('[EnhancedLocalStorage] Failed to parse JSON payload.');\n            }\n        case StorageValueEncodingType.String: return payload;\n        default:\n            throw new Error(`[EnhancedLocalStorage] Unknown encoding type: ${type}.`);\n    }\n}\n\nfunction encodeToStorageValue(value: any) {\n    if (typeof value === 'string') return toCustomValue(StorageValueEncodingType.String, value);\n    return toCustomValue(StorageValueEncodingType.Json, JSON.stringify(serialize(value)));\n}\n\nfunction isCustomFormat(data: string) {\n    return (\n        data.length >= customValueHeaderLength\n        && data[0] === customValueHeader[0]\n        && data[1] === customValueHeader[1]\n    );\n}\n"],"names":["deserialize","serialize"],"mappings":";;;;AAKA,IAAK,wBAGJ;AAHD,CAAA,UAAK,wBAAwB,EAAA;AACzB,IAAA,wBAAA,CAAA,MAAA,CAAA,GAAA,GAAU;AACV,IAAA,wBAAA,CAAA,QAAA,CAAA,GAAA,GAAY;AAChB,CAAC,EAHI,wBAAwB,KAAxB,wBAAwB,GAG5B,EAAA,CAAA,CAAA;AAED,MAAM,iBAAiB,GAAG,IAAI;AAC9B,MAAM,uBAAuB,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC;AAC5D,MAAM,aAAa,GAAG,CAAC,IAA8B,EAAE,OAAe,KAAK,CAAA,EAAG,iBAAiB,CAAG,EAAA,IAAI,CAAG,EAAA,OAAO,EAAE;AAElH;;;;;;;;;;;AAWG;AACU,MAAA,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;AAC9C;;AAEG;IACH,KAAK,EAAE,MAAM,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE;AACxC;;;;;;;;AAQG;AACH,IAAA,OAAO,CAAc,GAAW,EAAA;QAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;AACjD,QAAA,OAAO,QAAQ,GAAG,kBAAkB,CAAC,QAAQ,CAAM,GAAG,IAAI;KAC7D;AACD;;;;;;AAMG;AACH,IAAA,OAAO,EAAE,CAAC,GAAW,KAAK,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI;AACnE;;;;AAIG;AACH,IAAA,IAAI,MAAM,GAAA;AACN,QAAA,OAAO,MAAM,CAAC,YAAY,CAAC,MAAM;KACpC;AACD;;;;AAIG;AACH,IAAA,UAAU,EAAE,CAAC,GAAW,KAAK,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;AAChE;;;;;AAKG;IACH,OAAO,EAAE,CAAC,GAAW,EAAE,KAAU,KAAK,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC;AACtG,CAAA;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAA;AACpC,IAAA,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;AAAE,QAAA,OAAO,IAAI;IACtC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC;IAClD,QAAQ,IAAI;QACR,KAAK,wBAAwB,CAAC,IAAI;AAC9B,YAAA,IAAI;gBACA,OAAOA,qBAAW,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;;AACzC,YAAA,MAAM;AACJ,gBAAA,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC;;AAE/E,QAAA,KAAK,wBAAwB,CAAC,MAAM,EAAE,OAAO,OAAO;AACpD,QAAA;AACI,YAAA,MAAM,IAAI,KAAK,CAAC,iDAAiD,IAAI,CAAA,CAAA,CAAG,CAAC;;AAErF;AAEA,SAAS,oBAAoB,CAAC,KAAU,EAAA;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,wBAAwB,CAAC,MAAM,EAAE,KAAK,CAAC;AAC3F,IAAA,OAAO,aAAa,CAAC,wBAAwB,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAACC,mBAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AACzF;AAEA,SAAS,cAAc,CAAC,IAAY,EAAA;AAChC,IAAA,QACI,IAAI,CAAC,MAAM,IAAI;AACZ,WAAA,IAAI,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC;WAC/B,IAAI,CAAC,CAAC,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC;AAE3C;;;;"}