@kikiutils/shared 11.0.0 → 13.0.0

package/README.md

@@ -28,7 +28,7 @@ A lightweight and modular utility library for modern JavaScript and TypeScript
 
 ## Requirements
 
-- **Node.js** `>= 20.0.0`
+- **Node.js** `>= 22.0.0`
 
 ## Installation
 
@@ -67,6 +67,10 @@ logger.info(value);
 
 Each module file includes function-level comments and usage examples.
 
+### [buffer](./src/buffer.ts)
+
+- `toBuffer`
+
 ### [clipboard](./src/clipboard.ts)
 
 - `copyBlobToClipboard`
@@ -98,6 +102,7 @@ Console logger integration.
 
 - `getEnumStringValues`
 - `getEnumNumberValues`
+- `getEnumValues`
 
 ### [env](./src/env.ts)
 
@@ -122,6 +127,10 @@ Console logger integration.
 
 - `toCompactNumberString`
 
+### [object](./src/object.ts)
+
+- `stringifyObjectDeterministically`
+
 ### [pino](./src/pino.ts)
 
 Pino logger integration.

package/dist/buffer.d.ts

@@ -1,5 +1,7 @@
-import { Buffer } from 'node:buffer';
-import type { Blob as NodeBlob, File as NodeFile } from 'node:buffer';
+import { Blob as Blob$1, Buffer, File as File$1 } from "node:buffer";
+
+//#region src/buffer.d.ts
+
 /**
  * Converts a Blob, Buffer, or File to a Buffer.
  *
@@ -31,5 +33,7 @@ import type { Blob as NodeBlob, File as NodeFile } from 'node:buffer';
  * console.log(result3.toString()); // 'File content'
  * ```
  */
-export declare function toBuffer(input: Blob | Buffer | File | NodeBlob | NodeFile): Promise<Buffer<ArrayBufferLike>>;
+declare function toBuffer(input: Blob | Buffer | File | Blob$1 | File$1): Promise<Buffer<ArrayBufferLike>>;
+//#endregion
+export { toBuffer };
 //# sourceMappingURL=buffer.d.ts.map

package/dist/buffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../src/buffer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,EACR,IAAI,IAAI,QAAQ,EAChB,IAAI,IAAI,QAAQ,EACnB,MAAM,aAAa,CAAC;AAErB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,QAAQ,GAAG,QAAQ,oCAG/E"}
+{"version":3,"file":"buffer.d.ts","names":[],"sources":["../src/buffer.ts"],"sourcesContent":[],"mappings":";;;;;AAqCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAAsB,QAAA,QAAgB,OAAO,SAAS,OAAO,SAAW,SAAQ,QAAA,OAAA"}

package/dist/buffer.js

@@ -0,0 +1,42 @@
+import { Buffer } from "node:buffer";
+
+//#region src/buffer.ts
+/**
+* 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());
+}
+
+//#endregion
+export { toBuffer };
+//# sourceMappingURL=buffer.js.map

package/dist/buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.js","names":[],"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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,eAAsB,SAAS,OAAmD;AAC9E,KAAI,OAAO,SAAS,MAAM,CAAE,QAAO;AACnC,QAAO,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC"}

package/dist/clipboard.d.ts

@@ -1,8 +1,9 @@
+//#region src/clipboard.d.ts
 type CopyResult = {
-    error: unknown;
-    ok: false;
+  error: unknown;
+  ok: false;
 } | {
-    ok: true;
+  ok: true;
 };
 /**
  * Attempts to copy a Blob (e.g. image, plain text, HTML) to the user's clipboard using the ClipboardItem API.
@@ -32,7 +33,7 @@ type CopyResult = {
  * }
  * ```
  */
-export declare function copyBlobToClipboard(blob: Blob, options?: ClipboardItemOptions): Promise<CopyResult>;
+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.
  *
@@ -59,6 +60,7 @@ export declare function copyBlobToClipboard(blob: Blob, options?: ClipboardItemO
  * }
  * ```
  */
-export declare function copyTextToClipboard(text: string): Promise<CopyResult>;
-export {};
+declare function copyTextToClipboard(text: string): Promise<CopyResult>;
+//#endregion
+export { copyBlobToClipboard, copyTextToClipboard };
 //# sourceMappingURL=clipboard.d.ts.map

package/dist/clipboard.d.ts.map

@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,UAAU,CAAC,CAkBzG;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAU3E"}
+{"version":3,"file":"clipboard.d.ts","names":[],"sources":["../src/clipboard.ts"],"sourcesContent":[],"mappings":";KAAK,UAAA;EAAA,KAAA,EAAA,OAAU;EAgCO,EAAA,EAAA,KAAA;CAAmB,GAAA;MAAO,IAAA;;;;;AA8ChD;;;;;;;;;;;;;;;;;;;;;;;;;iBA9CsB,mBAAA,OAA0B,gBAAgB,uBAAuB,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8CzE,mBAAA,gBAAmC,QAAQ"}

package/dist/clipboard.js

@@ -0,0 +1,86 @@
+//#region src/clipboard.ts
+/**
+* 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: /* @__PURE__ */ 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
+		};
+	}
+}
+
+//#endregion
+export { copyBlobToClipboard, copyTextToClipboard };
+//# sourceMappingURL=clipboard.js.map

package/dist/clipboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clipboard.js","names":[],"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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,eAAsB,oBAAoB,MAAY,SAAqD;AACvG,KAAI,CAAC,UAAU,WAAW,MACtB,QAAO;EACH,uBAAO,IAAI,MAAM,mDAAmD;EACpE,IAAI;EACP;AAGL,KAAI;EACA,MAAM,OAAO,IAAI,cAAc,GAAG,KAAK,OAAO,MAAM,EAAE,QAAQ;AAC9D,QAAM,UAAU,UAAU,MAAM,CAAC,KAAK,CAAC;AACvC,SAAO,EAAE,IAAI,MAAM;UACd,OAAO;AACZ,SAAO;GACH;GACA,IAAI;GACP;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BT,eAAsB,oBAAoB,MAAmC;AACzE,KAAI;AACA,QAAM,UAAU,UAAU,UAAU,KAAK;AACzC,SAAO,EAAE,IAAI,MAAM;UACd,OAAO;AACZ,SAAO;GACH;GACA,IAAI;GACP"}

package/dist/consola.d.ts

@@ -1,3 +1,7 @@
+import * as consola0 from "consola";
+
+//#region src/consola.d.ts
+
 /**
  * A consola logger instance.
  *
@@ -19,6 +23,8 @@
  * logger.level = 3;
  * ```
  */
-export declare const consolaLogger: import("consola").ConsolaInstance;
-export declare const logger: import("consola").ConsolaInstance;
+declare const consolaLogger: consola0.ConsolaInstance;
+declare const logger: consola0.ConsolaInstance;
+//#endregion
+export { consolaLogger, logger };
 //# sourceMappingURL=consola.d.ts.map

package/dist/consola.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consola.d.ts","sourceRoot":"","sources":["../src/consola.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,aAAa,mCAAkB,CAAC;AAC7C,eAAO,MAAM,MAAM,mCAAgB,CAAC"}
+{"version":3,"file":"consola.d.ts","names":[],"sources":["../src/consola.ts"],"sourcesContent":[],"mappings":";;;;;;;AAuBA;AACA;;;;;;;;;;;;;;;;;cADa,eAA+B,QAAA,CAAlB;cACb,QAAsB,QAAA,CAAhB"}

package/dist/consola.js

@@ -0,0 +1,32 @@
+import { createConsola } from "consola";
+
+//#region src/consola.ts
+/**
+* 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 !== void 0) consolaLogger.level = +process.env.CONSOLA_LOGGER_LEVEL;
+else consolaLogger.level = process.env.NODE_ENV === "production" ? 0 : consolaLogger.level;
+
+//#endregion
+export { consolaLogger, logger };
+//# sourceMappingURL=consola.js.map

package/dist/consola.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consola.js","names":[],"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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,gBAAgB,eAAe;AAC5C,MAAa,SAAS;AACtB,IAAI,QAAQ,IAAI,yBAAyB,OAAW,eAAc,QAAQ,CAAC,QAAQ,IAAI;IAClF,eAAc,QAAQ,QAAQ,IAAI,aAAa,eAAe,IAAI,cAAc"}

package/dist/crypto-hash.d.ts

@@ -1,27 +1,17 @@
-/**
- * This file provides a set of functions for creating hash digests using different algorithms and bit lengths.
- * It includes functions for generating SHA-3 hash digests with bit lengths of 224, 256, 384, and 512,
- * as well as a function for generating MD5 hash digests.
- *
- * These functions use the Node.js crypto module to generate the hashes.
- * Can only be used in Node.js/Deno/Bun runtimes.
- *
- * @example
- * ```typescript
- * import { cryptoSha3256 } from '@kikiutils/shared/crypto-hash';
- *
- * console.log(cryptoSha3256('test')); // 36f028580bb02cc8272a9a020f4200e346e276ae664e45ee80745574e2f5ab80
- * ```
- */
-import type { BinaryLike, BinaryToTextEncoding } from 'node:crypto';
-export declare function cryptoMd5(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
-export declare function cryptoMd5ToBuffer(data: BinaryLike): Buffer<ArrayBufferLike>;
-export declare function cryptoSha3224(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
-export declare function cryptoSha3224ToBuffer(data: BinaryLike): Buffer<ArrayBufferLike>;
-export declare function cryptoSha3256(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
-export declare function cryptoSha3256ToBuffer(data: BinaryLike): Buffer<ArrayBufferLike>;
-export declare function cryptoSha3384(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
-export declare function cryptoSha3384ToBuffer(data: BinaryLike): Buffer<ArrayBufferLike>;
-export declare function cryptoSha3512(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
-export declare function cryptoSha3512ToBuffer(data: BinaryLike): Buffer<ArrayBufferLike>;
+import { BinaryLike, BinaryToTextEncoding } from "node:crypto";
+
+//#region src/crypto-hash.d.ts
+
+declare function cryptoMd5(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+declare function cryptoMd5ToBuffer(data: BinaryLike): Buffer<ArrayBufferLike>;
+declare function cryptoSha3224(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+declare function cryptoSha3224ToBuffer(data: BinaryLike): Buffer<ArrayBufferLike>;
+declare function cryptoSha3256(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+declare function cryptoSha3256ToBuffer(data: BinaryLike): Buffer<ArrayBufferLike>;
+declare function cryptoSha3384(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+declare function cryptoSha3384ToBuffer(data: BinaryLike): Buffer<ArrayBufferLike>;
+declare function cryptoSha3512(data: BinaryLike, outputEncoding?: BinaryToTextEncoding): string;
+declare function cryptoSha3512ToBuffer(data: BinaryLike): Buffer<ArrayBufferLike>;
+//#endregion
+export { cryptoMd5, cryptoMd5ToBuffer, cryptoSha3224, cryptoSha3224ToBuffer, cryptoSha3256, cryptoSha3256ToBuffer, cryptoSha3384, cryptoSha3384ToBuffer, cryptoSha3512, cryptoSha3512ToBuffer };
 //# sourceMappingURL=crypto-hash.d.ts.map

package/dist/crypto-hash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crypto-hash.d.ts","sourceRoot":"","sources":["../src/crypto-hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EACR,UAAU,EACV,oBAAoB,EACvB,MAAM,aAAa,CAAC;AAErB,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,GAAE,oBAA4B,UAEvF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,2BAEjD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,GAAE,oBAA4B,UAE3F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,2BAErD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,GAAE,oBAA4B,UAE3F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,2BAErD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,GAAE,oBAA4B,UAE3F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,2BAErD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,GAAE,oBAA4B,UAE3F;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,2BAErD"}
+{"version":3,"file":"crypto-hash.d.ts","names":[],"sources":["../src/crypto-hash.ts"],"sourcesContent":[],"mappings":";;;;AA8BoC,iBARpB,SAAA,CAQoB,IAAA,EARJ,UAQI,EAAA,cAAA,CAAA,EARwB,oBAQxB,CAAA,EAAA,MAAA;AAA4B,iBAJhD,iBAAA,CAIgD,IAAA,EAJxB,UAIwB,CAAA,EAJd,MAIc,CAJd,eAIc,CAAA;AAA4B,iBAA5E,aAAA,CAA4E,IAAA,EAAxD,UAAwD,EAAA,cAAA,CAAA,EAA5B,oBAA4B,CAAA,EAAA,MAAA;AAI5E,iBAAA,qBAAA,CAAqB,IAAA,EAAO,UAAP,CAAA,EAAiB,MAAjB,CAAiB,eAAjB,CAAA;AAAA,iBAIrB,aAAA,CAJqB,IAAA,EAID,UAJC,EAAA,cAAA,CAAA,EAI2B,oBAJ3B,CAAA,EAAA,MAAA;AAAO,iBAQ5B,qBAAA,CAR4B,IAAA,EAQA,UARA,CAAA,EAQU,MARV,CAQU,eARV,CAAA;AAAU,iBAYtC,aAAA,CAZsC,IAAA,EAYlB,UAZkB,EAAA,cAAA,CAAA,EAYU,oBAZV,CAAA,EAAA,MAAA;AAAA,iBAgBtC,qBAAA,CAhBsC,IAAA,EAgBV,UAhBU,CAAA,EAgBA,MAhBA,CAgBA,eAhBA,CAAA;AAAA,iBAoBtC,aAAA,CApBsC,IAAA,EAoBlB,UApBkB,EAAA,cAAA,CAAA,EAoBU,oBApBV,CAAA,EAAA,MAAA;AAItC,iBAoBA,qBAAA,CApBa,IAAA,EAoBe,UApBf,CAAA,EAoByB,MApBzB,CAoByB,eApBzB,CAAA"}

package/dist/crypto-hash.js

@@ -0,0 +1,37 @@
+import { createHash } from "node:crypto";
+
+//#region src/crypto-hash.ts
+function cryptoMd5(data, outputEncoding = "hex") {
+	return createHash("md5").update(data).digest(outputEncoding);
+}
+function cryptoMd5ToBuffer(data) {
+	return createHash("md5").update(data).digest();
+}
+function cryptoSha3224(data, outputEncoding = "hex") {
+	return createHash("sha3-224").update(data).digest(outputEncoding);
+}
+function cryptoSha3224ToBuffer(data) {
+	return createHash("sha3-224").update(data).digest();
+}
+function cryptoSha3256(data, outputEncoding = "hex") {
+	return createHash("sha3-256").update(data).digest(outputEncoding);
+}
+function cryptoSha3256ToBuffer(data) {
+	return createHash("sha3-256").update(data).digest();
+}
+function cryptoSha3384(data, outputEncoding = "hex") {
+	return createHash("sha3-384").update(data).digest(outputEncoding);
+}
+function cryptoSha3384ToBuffer(data) {
+	return createHash("sha3-384").update(data).digest();
+}
+function cryptoSha3512(data, outputEncoding = "hex") {
+	return createHash("sha3-512").update(data).digest(outputEncoding);
+}
+function cryptoSha3512ToBuffer(data) {
+	return createHash("sha3-512").update(data).digest();
+}
+
+//#endregion
+export { cryptoMd5, cryptoMd5ToBuffer, cryptoSha3224, cryptoSha3224ToBuffer, cryptoSha3256, cryptoSha3256ToBuffer, cryptoSha3384, cryptoSha3384ToBuffer, cryptoSha3512, cryptoSha3512ToBuffer };
+//# sourceMappingURL=crypto-hash.js.map

package/dist/crypto-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-hash.js","names":[],"sources":["../src/crypto-hash.ts"],"sourcesContent":["/**\n * This file provides a set of functions for creating hash digests using different algorithms and bit lengths.\n * It includes functions for generating SHA-3 hash digests with bit lengths of 224, 256, 384, and 512,\n * as well as a function for generating MD5 hash digests.\n *\n * These functions use the Node.js crypto module to generate the hashes.\n * Can only be used in Node.js/Deno/Bun runtimes.\n *\n * @example\n * ```typescript\n * import { cryptoSha3256 } from '@kikiutils/shared/crypto-hash';\n *\n * console.log(cryptoSha3256('test')); // 36f028580bb02cc8272a9a020f4200e346e276ae664e45ee80745574e2f5ab80\n * ```\n */\n\nimport { createHash } from 'node:crypto';\nimport type {\n    BinaryLike,\n    BinaryToTextEncoding,\n} from 'node:crypto';\n\nexport function cryptoMd5(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('md5').update(data).digest(outputEncoding);\n}\n\nexport function cryptoMd5ToBuffer(data: BinaryLike) {\n    return createHash('md5').update(data).digest();\n}\n\nexport function cryptoSha3224(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-224').update(data).digest(outputEncoding);\n}\n\nexport function cryptoSha3224ToBuffer(data: BinaryLike) {\n    return createHash('sha3-224').update(data).digest();\n}\n\nexport function cryptoSha3256(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-256').update(data).digest(outputEncoding);\n}\n\nexport function cryptoSha3256ToBuffer(data: BinaryLike) {\n    return createHash('sha3-256').update(data).digest();\n}\n\nexport function cryptoSha3384(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-384').update(data).digest(outputEncoding);\n}\n\nexport function cryptoSha3384ToBuffer(data: BinaryLike) {\n    return createHash('sha3-384').update(data).digest();\n}\n\nexport function cryptoSha3512(data: BinaryLike, outputEncoding: BinaryToTextEncoding = 'hex') {\n    return createHash('sha3-512').update(data).digest(outputEncoding);\n}\n\nexport function cryptoSha3512ToBuffer(data: BinaryLike) {\n    return createHash('sha3-512').update(data).digest();\n}\n"],"mappings":";;;AAsBA,SAAgB,UAAU,MAAkB,iBAAuC,OAAO;AACtF,QAAO,WAAW,MAAM,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;AAGhE,SAAgB,kBAAkB,MAAkB;AAChD,QAAO,WAAW,MAAM,CAAC,OAAO,KAAK,CAAC,QAAQ;;AAGlD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;AAGrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ;;AAGvD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;AAGrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ;;AAGvD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;AAGrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ;;AAGvD,SAAgB,cAAc,MAAkB,iBAAuC,OAAO;AAC1F,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,OAAO,eAAe;;AAGrE,SAAgB,sBAAsB,MAAkB;AACpD,QAAO,WAAW,WAAW,CAAC,OAAO,KAAK,CAAC,QAAQ"}

package/dist/datetime.d.ts

@@ -1,5 +1,7 @@
-import type { DateArg, Day, FormatOptions } from 'date-fns';
-export type DateRangeType = 'lastMonth' | 'lastWeek' | 'thisMonth' | 'thisWeek' | 'today' | 'yesterday';
+import { DateArg, Day, FormatOptions } from "date-fns";
+
+//#region src/datetime.d.ts
+type DateRangeType = 'lastMonth' | 'lastWeek' | 'thisMonth' | 'thisWeek' | 'today' | 'yesterday';
 /**
  * Formats a given date, timestamp, or date string into a specified format.
  *
@@ -27,7 +29,7 @@ export type DateRangeType = 'lastMonth' | 'lastWeek' | 'thisMonth' | 'thisWeek'
  *
  * @see https://date-fns.org/docs/format
  */
-export declare function formatDate(date: DateArg<Date> & {}, format?: string, options?: FormatOptions): string;
+declare function formatDate(date: DateArg<Date> & {}, format?: string, options?: FormatOptions): string;
 /**
  * Get the date range (start and end) based on a given date and range type.
  *
@@ -55,12 +57,12 @@ export declare function formatDate(date: DateArg<Date> & {}, format?: string, op
  * // { startDate: 2023-06-25T00:00:00.000Z, endDate: 2023-07-01T23:59:59.999Z }
  * ```
  */
-export declare function getDateRangeFromDate(date: Date, type: DateRangeType, options?: {
-    setEndDateToNextDayStart?: boolean;
-    weekStartsOn?: Day;
+declare function getDateRangeFromDate(date: Date, type: DateRangeType, options?: {
+  setEndDateToNextDayStart?: boolean;
+  weekStartsOn?: Day;
 }): {
-    endDate: Date;
-    startDate: Date;
+  endDate: Date;
+  startDate: Date;
 };
 /**
  * Returns a `Date` object set to midnight (00:00:00) of today, with an optional day offset.
@@ -78,5 +80,7 @@ export declare function getDateRangeFromDate(date: Date, type: DateRangeType, op
  * console.log(getMidnightDateFromToday(-1)); // yesterday at 00:00:00
  * ```
  */
-export declare function getMidnightDateFromToday(offsetDays?: number): Date;
+declare function getMidnightDateFromToday(offsetDays?: number): Date;
+//#endregion
+export { DateRangeType, formatDate, getDateRangeFromDate, getMidnightDateFromToday };
 //# sourceMappingURL=datetime.d.ts.map

package/dist/datetime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../src/datetime.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACR,OAAO,EACP,GAAG,EACH,aAAa,EAChB,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAExG;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,GAAE,MAA8B,EAAE,OAAO,CAAC,EAAE,aAAa,UAEnH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE;IACN,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,YAAY,CAAC,EAAE,GAAG,CAAC;CACtB;;;EAiDJ;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wBAAwB,CAAC,UAAU,GAAE,MAAU,QAK9D"}
+{"version":3,"file":"datetime.d.ts","names":[],"sources":["../src/datetime.ts"],"sourcesContent":[],"mappings":";;;KAkBY,aAAA;;AAAZ;AA6BA;;;;;;AA+BA;;;;;;;;AAyEA;;;;;;;;;;;iBAxGgB,UAAA,OAAiB,QAAQ,uCAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+BvF,oBAAA,OACN,YACA;;iBAGa;;;;;;;;;;;;;;;;;;;;;iBAoEP,wBAAA,uBAA+C"}

package/dist/datetime.js

@@ -0,0 +1,131 @@
+import { endOfDay, endOfMonth, endOfWeek, format, startOfDay, startOfMonth, startOfWeek, subDays, subMonths, subWeeks } from "date-fns";
+
+//#region src/datetime.ts
+/**
+* Formats a given date, timestamp, or date string into a specified format.
+*
+* This function is a wrapper around `date-fns/format`.
+*
+* @param {DateArg<Date>} date - The input date to format. Can be a Date object, a timestamp, or a string
+* @param {string} [format] - The target format string
+* @param {FormatOptions} [options] - Optional formatting options passed to `date-fns/format`
+*
+* @returns {string} The formatted date string
+*
+* @example
+* ```typescript
+* import { formatDate } from '@kikiutils/shared/datetime';
+*
+* // Format a Date object
+* console.log(formatDate(new Date(), 'yyyy-MM-dd')); // 2024-07-10
+*
+* // Format a timestamp
+* console.log(formatDate(1657814400000, 'yyyy-MM-dd')); // 2022-07-15
+*
+* // Format a date string
+* console.log(formatDate('2024-07-10T00:00:00Z', 'yyyy-MM-dd')); // 2024-07-10
+* ```
+*
+* @see https://date-fns.org/docs/format
+*/
+function formatDate(date, format$1 = "yyyy-MM-dd HH:mm:ss", options) {
+	return format(date, format$1, options);
+}
+/**
+* Get the date range (start and end) based on a given date and range type.
+*
+* Supports common range types like 'lastMonth', 'lastWeek', 'thisMonth', 'thisWeek', 'today', and 'yesterday'.
+*
+* @param {Date} date - The reference date
+* @param {DateRangeType} type - The range type to compute
+* @param {object} [options] - Optional settings
+* @param {boolean} [options.setEndDateToNextDayStart] - If true, set `endDate` to 00:00:00.000 of the next day
+* @param {Day} [options.weekStartsOn] - The start day of the week (0 = Sunday, 1 = Monday, ..., 6 = Saturday)
+*
+* @returns {{ startDate: Date, endDate: Date }} An object with `startDate` and `endDate`
+*
+* @example
+* ```typescript
+* import { getDateRangeFromDate } from '@kikiutils/shared/datetime';
+*
+* // Get the date range for last month
+* const date = new Date('2023-07-01');
+* console.log(getDateRangeFromDate(date, 'lastMonth'));
+* // { startDate: 2023-06-01T00:00:00.000Z, endDate: 2023-06-30T23:59:59.999Z }
+*
+* // Get this week's range with Sunday as the first day
+* console.log(getDateRangeFromDate(date, 'thisWeek', { weekStartsOn: 0 }));
+* // { startDate: 2023-06-25T00:00:00.000Z, endDate: 2023-07-01T23:59:59.999Z }
+* ```
+*/
+function getDateRangeFromDate(date, type, options) {
+	let endDate;
+	let startDate;
+	switch (type) {
+		case "lastMonth":
+			{
+				const lastMonth = subMonths(date, 1);
+				endDate = endOfMonth(lastMonth);
+				startDate = startOfMonth(lastMonth);
+			}
+			break;
+		case "lastWeek":
+			{
+				const lastWeek = subWeeks(date, 1);
+				endDate = endOfWeek(lastWeek, { weekStartsOn: options?.weekStartsOn ?? 1 });
+				startDate = startOfWeek(lastWeek, { weekStartsOn: options?.weekStartsOn ?? 1 });
+			}
+			break;
+		case "thisMonth":
+			endDate = endOfMonth(date);
+			startDate = startOfMonth(date);
+			break;
+		case "thisWeek":
+			endDate = endOfWeek(date, { weekStartsOn: options?.weekStartsOn ?? 1 });
+			startDate = startOfWeek(date, { weekStartsOn: options?.weekStartsOn ?? 1 });
+			break;
+		case "today":
+			endDate = endOfDay(date);
+			startDate = startOfDay(date);
+			break;
+		case "yesterday":
+			{
+				const yesterday = subDays(date, 1);
+				endDate = endOfDay(yesterday);
+				startDate = startOfDay(yesterday);
+			}
+			break;
+		default: throw new Error(`Unsupported date range type: ${type}`);
+	}
+	if (options?.setEndDateToNextDayStart) endDate.setHours(24, 0, 0, 0);
+	return {
+		endDate,
+		startDate
+	};
+}
+/**
+* Returns a `Date` object set to midnight (00:00:00) of today, with an optional day offset.
+*
+* @param {number} [offsetDays] - Number of days to offset from today. Can be negative
+*
+* @returns {Date} A `Date` object at 00:00:00 of the offset day
+*
+* @example
+* ```typescript
+* import { getMidnightDateFromToday } from '@kikiutils/shared/datetime';
+*
+* console.log(getMidnightDateFromToday()); // today at 00:00:00
+* console.log(getMidnightDateFromToday(3)); // 3 days from today at 00:00:00
+* console.log(getMidnightDateFromToday(-1)); // yesterday at 00:00:00
+* ```
+*/
+function getMidnightDateFromToday(offsetDays = 0) {
+	const date = /* @__PURE__ */ new Date();
+	date.setDate(date.getDate() + offsetDays);
+	date.setHours(0, 0, 0, 0);
+	return date;
+}
+
+//#endregion
+export { formatDate, getDateRangeFromDate, getMidnightDateFromToday };
+//# sourceMappingURL=datetime.js.map

package/dist/datetime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.js","names":["dateFnsFormat","format","endDate: Date","startDate: Date"],"sources":["../src/datetime.ts"],"sourcesContent":["import {\n    format as dateFnsFormat,\n    endOfDay,\n    endOfMonth,\n    endOfWeek,\n    startOfDay,\n    startOfMonth,\n    startOfWeek,\n    subDays,\n    subMonths,\n    subWeeks,\n} from 'date-fns';\nimport type {\n    DateArg,\n    Day,\n    FormatOptions,\n} from 'date-fns';\n\nexport type DateRangeType = 'lastMonth' | 'lastWeek' | 'thisMonth' | 'thisWeek' | 'today' | 'yesterday';\n\n/**\n * Formats a given date, timestamp, or date string into a specified format.\n *\n * This function is a wrapper around `date-fns/format`.\n *\n * @param {DateArg<Date>} date - The input date to format. Can be a Date object, a timestamp, or a string\n * @param {string} [format] - The target format string\n * @param {FormatOptions} [options] - Optional formatting options passed to `date-fns/format`\n *\n * @returns {string} The formatted date string\n *\n * @example\n * ```typescript\n * import { formatDate } from '@kikiutils/shared/datetime';\n *\n * // Format a Date object\n * console.log(formatDate(new Date(), 'yyyy-MM-dd')); // 2024-07-10\n *\n * // Format a timestamp\n * console.log(formatDate(1657814400000, 'yyyy-MM-dd')); // 2022-07-15\n *\n * // Format a date string\n * console.log(formatDate('2024-07-10T00:00:00Z', 'yyyy-MM-dd')); // 2024-07-10\n * ```\n *\n * @see https://date-fns.org/docs/format\n */\nexport function formatDate(date: DateArg<Date> & {}, format: string = 'yyyy-MM-dd HH:mm:ss', options?: FormatOptions) {\n    return dateFnsFormat(date, format, options);\n}\n\n/**\n * Get the date range (start and end) based on a given date and range type.\n *\n * Supports common range types like 'lastMonth', 'lastWeek', 'thisMonth', 'thisWeek', 'today', and 'yesterday'.\n *\n * @param {Date} date - The reference date\n * @param {DateRangeType} type - The range type to compute\n * @param {object} [options] - Optional settings\n * @param {boolean} [options.setEndDateToNextDayStart] - If true, set `endDate` to 00:00:00.000 of the next day\n * @param {Day} [options.weekStartsOn] - The start day of the week (0 = Sunday, 1 = Monday, ..., 6 = Saturday)\n *\n * @returns {{ startDate: Date, endDate: Date }} An object with `startDate` and `endDate`\n *\n * @example\n * ```typescript\n * import { getDateRangeFromDate } from '@kikiutils/shared/datetime';\n *\n * // Get the date range for last month\n * const date = new Date('2023-07-01');\n * console.log(getDateRangeFromDate(date, 'lastMonth'));\n * // { startDate: 2023-06-01T00:00:00.000Z, endDate: 2023-06-30T23:59:59.999Z }\n *\n * // Get this week's range with Sunday as the first day\n * console.log(getDateRangeFromDate(date, 'thisWeek', { weekStartsOn: 0 }));\n * // { startDate: 2023-06-25T00:00:00.000Z, endDate: 2023-07-01T23:59:59.999Z }\n * ```\n */\nexport function getDateRangeFromDate(\n    date: Date,\n    type: DateRangeType,\n    options?: {\n        setEndDateToNextDayStart?: boolean;\n        weekStartsOn?: Day;\n    },\n) {\n    let endDate: Date;\n    let startDate: Date;\n    switch (type) {\n        case 'lastMonth':\n            {\n                const lastMonth = subMonths(date, 1);\n                endDate = endOfMonth(lastMonth);\n                startDate = startOfMonth(lastMonth);\n            }\n\n            break;\n        case 'lastWeek':\n            {\n                const lastWeek = subWeeks(date, 1);\n                endDate = endOfWeek(lastWeek, { weekStartsOn: options?.weekStartsOn ?? 1 });\n                startDate = startOfWeek(lastWeek, { weekStartsOn: options?.weekStartsOn ?? 1 });\n            }\n\n            break;\n        case 'thisMonth':\n            endDate = endOfMonth(date);\n            startDate = startOfMonth(date);\n            break;\n        case 'thisWeek':\n            endDate = endOfWeek(date, { weekStartsOn: options?.weekStartsOn ?? 1 });\n            startDate = startOfWeek(date, { weekStartsOn: options?.weekStartsOn ?? 1 });\n            break;\n        case 'today':\n            endDate = endOfDay(date);\n            startDate = startOfDay(date);\n            break;\n        case 'yesterday':\n            {\n                const yesterday = subDays(date, 1);\n                endDate = endOfDay(yesterday);\n                startDate = startOfDay(yesterday);\n            }\n\n            break;\n        default: throw new Error(`Unsupported date range type: ${type}`);\n    }\n\n    if (options?.setEndDateToNextDayStart) endDate.setHours(24, 0, 0, 0);\n    return {\n        endDate,\n        startDate,\n    };\n}\n\n/**\n * Returns a `Date` object set to midnight (00:00:00) of today, with an optional day offset.\n *\n * @param {number} [offsetDays] - Number of days to offset from today. Can be negative\n *\n * @returns {Date} A `Date` object at 00:00:00 of the offset day\n *\n * @example\n * ```typescript\n * import { getMidnightDateFromToday } from '@kikiutils/shared/datetime';\n *\n * console.log(getMidnightDateFromToday()); // today at 00:00:00\n * console.log(getMidnightDateFromToday(3)); // 3 days from today at 00:00:00\n * console.log(getMidnightDateFromToday(-1)); // yesterday at 00:00:00\n * ```\n */\nexport function getMidnightDateFromToday(offsetDays: number = 0) {\n    const date = new Date();\n    date.setDate(date.getDate() + offsetDays);\n    date.setHours(0, 0, 0, 0);\n    return date;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+CA,SAAgB,WAAW,MAA0B,WAAiB,uBAAuB,SAAyB;AAClH,QAAOA,OAAc,MAAMC,UAAQ,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8B/C,SAAgB,qBACZ,MACA,MACA,SAIF;CACE,IAAIC;CACJ,IAAIC;AACJ,SAAQ,MAAR;EACI,KAAK;GACD;IACI,MAAM,YAAY,UAAU,MAAM,EAAE;AACpC,cAAU,WAAW,UAAU;AAC/B,gBAAY,aAAa,UAAU;;AAGvC;EACJ,KAAK;GACD;IACI,MAAM,WAAW,SAAS,MAAM,EAAE;AAClC,cAAU,UAAU,UAAU,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;AAC3E,gBAAY,YAAY,UAAU,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;;AAGnF;EACJ,KAAK;AACD,aAAU,WAAW,KAAK;AAC1B,eAAY,aAAa,KAAK;AAC9B;EACJ,KAAK;AACD,aAAU,UAAU,MAAM,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;AACvE,eAAY,YAAY,MAAM,EAAE,cAAc,SAAS,gBAAgB,GAAG,CAAC;AAC3E;EACJ,KAAK;AACD,aAAU,SAAS,KAAK;AACxB,eAAY,WAAW,KAAK;AAC5B;EACJ,KAAK;GACD;IACI,MAAM,YAAY,QAAQ,MAAM,EAAE;AAClC,cAAU,SAAS,UAAU;AAC7B,gBAAY,WAAW,UAAU;;AAGrC;EACJ,QAAS,OAAM,IAAI,MAAM,gCAAgC,OAAO;;AAGpE,KAAI,SAAS,yBAA0B,SAAQ,SAAS,IAAI,GAAG,GAAG,EAAE;AACpE,QAAO;EACH;EACA;EACH;;;;;;;;;;;;;;;;;;AAmBL,SAAgB,yBAAyB,aAAqB,GAAG;CAC7D,MAAM,uBAAO,IAAI,MAAM;AACvB,MAAK,QAAQ,KAAK,SAAS,GAAG,WAAW;AACzC,MAAK,SAAS,GAAG,GAAG,GAAG,EAAE;AACzB,QAAO"}

package/dist/element-plus.d.ts

@@ -1,6 +1,8 @@
-import type { RuleType } from 'async-validator';
-import type { FormItemRule } from 'element-plus';
-export type DoNotRemoveOrUseThisType = RuleType;
+import { RuleType } from "async-validator";
+import { FormItemRule } from "element-plus";
+
+//#region src/element-plus.d.ts
+type DoNotRemoveOrUseThisType = RuleType;
 /**
  * Creates a reusable Element Plus `<el-form-item>` validation rule with sensible defaults.
  *
@@ -24,5 +26,7 @@ export type DoNotRemoveOrUseThisType = RuleType;
  * const optionalRule = createElFormItemRuleWithDefaults('Optional field', { required: false });
  * ```
  */
-export declare function createElFormItemRuleWithDefaults(message: string, options?: FormItemRule): FormItemRule;
+declare function createElFormItemRuleWithDefaults(message: string, options?: FormItemRule): FormItemRule;
+//#endregion
+export { DoNotRemoveOrUseThisType, createElFormItemRuleWithDefaults };
 //# sourceMappingURL=element-plus.d.ts.map

package/dist/element-plus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"element-plus.d.ts","sourceRoot":"","sources":["../src/element-plus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,YAAiB,GAAG,YAAY,CAQ1G"}
+{"version":3,"file":"element-plus.d.ts","names":[],"sources":["../src/element-plus.ts"],"sourcesContent":[],"mappings":";;;;KAGY,wBAAA,GAA2B;;AAAvC;AAyBA;;;;;;;;;;;;;;;;;;;;;iBAAgB,gCAAA,4BAA2D,eAAoB"}