@rtorcato/js-common 1.8.1 → 2.0.1

package/CHANGELOG.md

@@ -1,3 +1,27 @@
+## [2.0.1](https://github.com/rtorcato/js-common/compare/v2.0.0...v2.0.1) (2026-06-10)
+
+
+### Bug Fixes
+
+* **build:** ship .d.ts files in published tarball ([946cd8a](https://github.com/rtorcato/js-common/commit/946cd8a27ba52923cbcf857d996f52590d9008d5))
+
+# [2.0.0](https://github.com/rtorcato/js-common/compare/v1.8.1...v2.0.0) (2026-06-01)
+
+
+* refactor!: maintenance sweep + rename errors.tryCatch ([#47](https://github.com/rtorcato/js-common/issues/47)) ([9bd28a6](https://github.com/rtorcato/js-common/commit/9bd28a68b7566806169812ffed5ccb649d30e6c3))
+
+
+### Bug Fixes
+
+* **ci:** env-var commit message in check-skip ([#48](https://github.com/rtorcato/js-common/issues/48)) ([1037b0c](https://github.com/rtorcato/js-common/commit/1037b0c31c377bbc80eda57cbe3e411579437685)), closes [#47](https://github.com/rtorcato/js-common/issues/47)
+
+
+### BREAKING CHANGES
+
+* `tryCatch` from `@rtorcato/js-common/errors` is
+renamed to `tryWithFallback`. For Result-pattern error handling,
+import `tryCatch` from `@rtorcato/js-common/try` instead.
+
 ## [1.8.1](https://github.com/rtorcato/js-common/compare/v1.8.0...v1.8.1) (2026-05-29)
 
 

package/README.md

@@ -6,20 +6,20 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D22.0.0-brightgreen.svg)](https://nodejs.org/)
+[![codecov](https://codecov.io/gh/rtorcato/js-common/branch/main/graph/badge.svg)](https://codecov.io/gh/rtorcato/js-common)
 [![Docs](https://img.shields.io/badge/docs-rtorcato.github.io%2Fjs--common-blue.svg)](https://rtorcato.github.io/js-common/)
 
 A comprehensive set of common JavaScript and TypeScript utilities for Node.js projects.
 
 📘 **Documentation:** <https://rtorcato.github.io/js-common/>
 
-## ✨ Features
+## Features
 
-- 📦 **Tree-shakeable** - Import only what you need via subpath exports
-- 🔧 **TypeScript** - Full type safety and IntelliSense
-- 🖥️ **CLI included** - Optional binary for use in scripts and terminals
-- 📚 **Modular** - One module per concern, ~40 subpaths
-- ⚡ **Minimal runtime deps** - Only `date-fns`, `luxon`, `pino`, `uuid`, `short-uuid`, `zod`. CLI packages (`chalk`, `commander`, `figlet`, …) are `optionalDependencies` and only needed for the CLI.
-- 🧪 **Well tested** - Comprehensive test coverage
+- **Tree-shakeable** — import only what you need via subpath exports
+- **TypeScript** — full type definitions, JSDoc on every public API
+- **CLI included** — optional binary for use in scripts and terminals
+- **Modular** — one module per concern, 46 subpaths
+- **Minimal runtime deps** — only `date-fns`, `date-fns-tz`, `luxon`, `pino`, `uuid`, `short-uuid`, `zod`. CLI packages (`chalk`, `commander`, `figlet`, …) are `optionalDependencies` and only needed for the CLI.
 
 ## Installation
 
@@ -27,6 +27,30 @@ A comprehensive set of common JavaScript and TypeScript utilities for Node.js pr
 npm install @rtorcato/js-common
 ```
 
+## Migrating from 1.x to 2.x
+
+The only breaking change in 2.0 is a rename in the `errors` module:
+
+```ts
+// 1.x — swallow errors and fall back to a default value
+import { tryCatch } from '@rtorcato/js-common/errors'
+const data = await tryCatch(() => fetchData(), [])
+
+// 2.x — same function, renamed for clarity
+import { tryWithFallback } from '@rtorcato/js-common/errors'
+const data = await tryWithFallback(() => fetchData(), [])
+```
+
+The name `tryCatch` is now reserved for the Result-pattern helper in `@rtorcato/js-common/try`, which returns `{ data, error }` instead of swallowing:
+
+```ts
+import { tryCatch } from '@rtorcato/js-common/try'
+const { data, error } = await tryCatch(() => fetchData())
+if (error) { /* handle */ }
+```
+
+Prefer the Result-style `tryCatch` for new code; reserve `tryWithFallback` for cases where the fallback is genuinely safe.
+
 ## CLI Usage
 
 This package includes a command-line interface for many utilities:
@@ -50,7 +74,7 @@ See [CLI.md](./CLI.md) for complete CLI documentation.
 ## Library Usage
 
 ```typescript
-// 🎯 Import specific modules (recommended for tree-shaking)
+// Import specific modules (recommended for tree-shaking)
 import { formatDate, today, daysBetween } from '@rtorcato/js-common/date'
 import { validateEmail, isValidEmail } from '@rtorcato/js-common/emails'
 import { generateUUID, isValidUUID } from '@rtorcato/js-common/uuid'
@@ -58,7 +82,7 @@ import { sum, average, roundTo } from '@rtorcato/js-common/numbers'
 import { capitalize, toTitleCase } from '@rtorcato/js-common/formatting'
 
 // Example usage
-console.log(today()) // "2025-10-24"
+console.log(today()) // "2026-05-29"
 console.log(sum([1, 2, 3, 4, 5])) // 15
 console.log(capitalize('hello world')) // "Hello world"
 console.log(generateUUID()) // "f47ac10b-58cc-4372-a567-0e02b2c3d479"
@@ -68,102 +92,93 @@ console.log(generateUUID()) // "f47ac10b-58cc-4372-a567-0e02b2c3d479"
 
 Each module is shipped as its own subpath export so bundlers only include what you import. Individual modules range from ~100 bytes (e.g. `sleep`) to ~2 KB (e.g. `currency`) when minified. Measure against your own bundle with [bundlejs.com](https://bundlejs.com/?q=@rtorcato/js-common/numbers).
 
-### 🎯 **TypeScript Support**
-
-This package is built with TypeScript and includes complete type definitions out of the box:
-
-- ✅ **Full type safety** - All functions have accurate TypeScript types
-- ✅ **Generic support** - Functions like `unique<T>()` preserve your data types  
-- ✅ **JSDoc integration** - Rich documentation in your IDE
-- ✅ **Tree-shakable** - Import only what you need with perfect type inference
-
-```typescript
-// TypeScript automatically infers types
-const numbers = [1, 2, 3, 4, 5]
-const result: number = sum(numbers)  // ✅ Type: number
-
-const users = [{ name: 'John' }, { name: 'Jane' }]
-const uniqueUsers = unique(users)    // ✅ Type: { name: string }[]
-
-// IDE shows full documentation and type hints
-import { today } from '@rtorcato/js-common/date'
-//      ^ JSDoc: Returns today's date as YYYY-MM-DD string
-```
-
 ## Available Modules
 
-### 📅 **Date & Time**
+### Date & Time
 ```typescript
 import { today, formatDate, daysBetween, isLeapYear } from '@rtorcato/js-common/date'
 import { nowIso, formatDateTimeLocal, unixTimestamp } from '@rtorcato/js-common/datetime'
 import { nowTime, parseTime, secondsBetween } from '@rtorcato/js-common/time'
+import { runInterval, clearIntervalById } from '@rtorcato/js-common/interval'
 ```
 
-### 🔢 **Numbers & Math**
+### Numbers & Math
 ```typescript
 import { sum, average, roundTo, clamp, getRandomInt } from '@rtorcato/js-common/numbers'
 import { add, subtract, multiply, divide } from '@rtorcato/js-common/math'
+import { randomInt, randomFloat, randomBool, randomElement } from '@rtorcato/js-common/random'
 ```
 
-### 📝 **Text & Strings**
+### Text & Strings
 ```typescript
 import { capitalize, toTitleCase, padZero } from '@rtorcato/js-common/formatting'
 import { slugify, truncate, removeEmojis } from '@rtorcato/js-common/strings'
+import { escapeHtml, unescapeHtml, stripHtmlTags } from '@rtorcato/js-common/html'
+import { escapeRegExp, matchAll, replaceAllRegex } from '@rtorcato/js-common/regex'
+import { detectLanguage, formatNumber, t, pluralize } from '@rtorcato/js-common/i18n'
 ```
 
-### 🔐 **Security & Validation**
+### Security & Validation
 ```typescript
 import { isStrongPassword, generateSecureToken } from '@rtorcato/js-common/security'
 import { isValidEmail, validateEmail } from '@rtorcato/js-common/emails'
 import { isValidUrl } from '@rtorcato/js-common/url'
 import { isString, isNumber, isArray, isObject } from '@rtorcato/js-common/validation'
+import { toBoolean, isBoolean, xor } from '@rtorcato/js-common/boolean'
 ```
 
-### 🗂️ **Data Structures**
+### Data Structures
 ```typescript
 import { flatten, unique, chunk, groupBy } from '@rtorcato/js-common/arrays'
 import { deepMerge, pick, omit, deepClone } from '@rtorcato/js-common/objects'
 import { safeJsonParse, safeJsonStringify } from '@rtorcato/js-common/json'
+import { invertMap, mapValues, objectToMap, mapToObject } from '@rtorcato/js-common/maps'
+import { union, intersection, difference, isSubset } from '@rtorcato/js-common/sets'
 ```
 
-### 🔄 **Async & Control Flow**
+### Async & Control Flow
 ```typescript
 import { delay, timeout, retry } from '@rtorcato/js-common/promises'
 import { debounce, throttle, once } from '@rtorcato/js-common/functions'
 import { sleep } from '@rtorcato/js-common/sleep'
+import { tryCatch } from '@rtorcato/js-common/try'
+import { createAbortController, withAbort, abortAfter } from '@rtorcato/js-common/abortController'
+import { createCustomError, getErrorMessage, assert } from '@rtorcato/js-common/errors'
 ```
 
-### 🌈 **And More...**
-- **Colors** - Color manipulation and conversion
-- **Console** - Enhanced console utilities  
-- **Crypto** - Cryptographic functions
-- **Currency** - Currency formatting and conversion
-- **Events** - Event handling utilities
-- **Fetch** - HTTP request utilities
-- **File** - File system utilities
-- **UUID** - UUID generation and validation
-- **Process** - Process and environment utilities
-- **Geometry** - 2D geometry calculations
+### System & Process
+```typescript
+import { getENV, isDev, isProd, getNodeEnv, checkEnv } from '@rtorcato/js-common/env'
+import { getOsPlatform, getOsArch, getHomeDir } from '@rtorcato/js-common/os'
+import { getNodeMajorVersion, isNode, requireOptional } from '@rtorcato/js-common/node'
+import { getProcessId, getCwd, exitProcess, isCI } from '@rtorcato/js-common/process'
+import { isMacOs, isWindows, isLinux, getPlatform } from '@rtorcato/js-common/system'
+import { disableConsole, clearConsole } from '@rtorcato/js-common/console'
+```
+
+### Logging
+```typescript
+import { logger } from '@rtorcato/js-common/logger'                   // pino-based
+import { info, warn, error, captureConsole } from '@rtorcato/js-common/logging'
+```
+
+### Other
+- `colors` — color manipulation and conversion
+- `crypto` — cryptographic helpers
+- `currency` — currency formatting and conversion
+- `events` — event emitter utilities
+- `fetch` — HTTP request helpers
+- `file` — file system helpers
+- `geometry` — 2D geometry calculations
+- `mime-types` — MIME-type lookup
+- `uuid` — UUID generation and validation
+- `types` — shared TypeScript type definitions (types-only export)
 
 ## Requirements
 
 - **Node.js** >= 22.0.0 (enforced via the `engines` field)
 - **TypeScript** >= 5.0.0 (for TypeScript projects)
 
-## Why This Library?
-
-### 🎯 **Focused & Lightweight**
-Unlike larger utility libraries, js-common is designed for modern applications:
-- **Tiny bundle size** - Won't bloat your application
-- **Tree-shakeable** - Only import what you use
-- **CLI included** - Use utilities in scripts and terminal
-
-### 🛠️ **Modern Development**
-- Built with **TypeScript** for excellent DX
-- **ESM-only**, native subpath exports
-- **Minimal runtime deps** — CLI packages (`chalk`, `commander`, `figlet`, …) are `optionalDependencies` and only fetched when you opt in to the CLI
-- Comprehensive **test coverage**
-
 ## Development
 
 ```bash

package/dist/abortController/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Creates a new AbortController and returns its controller and signal.
+ * @returns {{ controller: AbortController, signal: AbortSignal }}
+ */
+export declare function createAbortController(): {
+    controller: AbortController;
+    signal: AbortSignal;
+};
+/**
+ * Returns a promise that rejects when the given AbortSignal is aborted.
+ * @param signal The AbortSignal to listen to.
+ * @returns {Promise<never>}
+ */
+export declare function abortPromise(signal: AbortSignal): Promise<never>;
+/**
+ * Wraps a promise and rejects it if the signal is aborted.
+ * @param promise The promise to wrap.
+ * @param signal The AbortSignal.
+ * @returns {Promise<T>}
+ */
+export declare function withAbort<T>(promise: Promise<T>, signal: AbortSignal): Promise<T>;
+/**
+ * Aborts the given controller after a timeout (ms).
+ * @param controller The AbortController.
+ * @param ms Timeout in milliseconds.
+ * @returns {NodeJS.Timeout | number} The timeout ID.
+ */
+export declare function abortAfter(controller: AbortController, ms: number): ReturnType<typeof setTimeout>;
+//# sourceMappingURL=index.d.ts.map

package/dist/abortController/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/abortController/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,qBAAqB;;;EAGpC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAchE;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAEjF;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAEjG"}

package/dist/arrays/index.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Returns the first element of an array, or undefined if the array is empty.
+ *
+ * @example
+ * ```typescript
+ * first([1, 2, 3]) // 1
+ * first([]) // undefined
+ * first(['a', 'b']) // 'a'
+ * ```
+ *
+ * @param arr The array to get the first element from
+ * @returns The first element or undefined if array is empty
+ * @category Array Utilities
+ */
+export declare function first<T>(arr: T[]): T | undefined;
+/**
+ * Returns the last element of an array, or undefined if the array is empty.
+ *
+ * @example
+ * ```typescript
+ * last([1, 2, 3]) // 3
+ * last([]) // undefined
+ * last(['a', 'b']) // 'b'
+ * ```
+ *
+ * @param arr The array to get the last element from
+ * @returns The last element or undefined if array is empty
+ * @category Array Utilities
+ */
+export declare function last<T>(arr: T[]): T | undefined;
+/**
+ * Removes duplicate values from an array while preserving order.
+ * Uses Set for O(n) performance with primitive values.
+ *
+ * @example
+ * ```typescript
+ * unique([1, 2, 2, 3, 1]) // [1, 2, 3]
+ * unique(['a', 'b', 'a']) // ['a', 'b']
+ * unique([{id: 1}, {id: 2}, {id: 1}]) // [{id: 1}, {id: 2}, {id: 1}] (objects by reference)
+ * ```
+ *
+ * @param arr The array to remove duplicates from
+ * @returns A new array with unique values
+ * @category Array Utilities
+ */
+export declare function unique<T>(arr: T[]): T[];
+/**
+ * Flattens an array one level deep.
+ *
+ * @example
+ * ```typescript
+ * flatten([[1, 2], [3, 4]]) // [1, 2, 3, 4]
+ * flatten([1, [2, 3], 4]) // [1, 2, 3, 4]
+ * flatten([[1, [2]], [3]]) // [1, [2], 3] (only one level deep)
+ * ```
+ *
+ * @param arr The array to flatten
+ * @returns A new flattened array
+ * @category Array Utilities
+ */
+export declare function flatten<T>(arr: readonly (T | T[])[]): T[];
+/**
+ * Chunks an array into smaller arrays of a specified size.
+ * The last chunk may be smaller if the array length is not evenly divisible.
+ *
+ * @example
+ * ```typescript
+ * chunk([1, 2, 3, 4, 5], 2) // [[1, 2], [3, 4], [5]]
+ * chunk(['a', 'b', 'c'], 2) // [['a', 'b'], ['c']]
+ * chunk([1, 2, 3], 5) // [[1, 2, 3]]
+ * ```
+ *
+ * @param arr The array to chunk
+ * @param size The size of each chunk (must be positive)
+ * @returns An array of chunks
+ * @throws {Error} When size is less than 1
+ * @category Array Utilities
+ */
+export declare function chunk<T>(arr: T[], size: number): T[][];
+/**
+ * Removes all falsy values from an array.
+ * Falsy values: false, 0, -0, 0n, "", null, undefined, NaN
+ *
+ * @example
+ * ```typescript
+ * compact([0, 1, false, 2, '', 3, null, undefined, NaN]) // [1, 2, 3]
+ * compact(['', 'hello', 0, 'world']) // ['hello', 'world']
+ * compact([true, false, 1, 0]) // [true, 1]
+ * ```
+ *
+ * @param arr The array to filter
+ * @returns A new array with only truthy values
+ * @category Array Utilities
+ */
+export declare function compact<T>(arr: T[]): T[];
+/**
+ * Shuffles an array using the Fisher-Yates algorithm.
+ * Returns a new array without modifying the original.
+ *
+ * @example
+ * ```typescript
+ * shuffle([1, 2, 3, 4, 5]) // [3, 1, 5, 2, 4] (random order)
+ * shuffle(['a', 'b', 'c']) // ['c', 'a', 'b'] (random order)
+ *
+ * // Original array is unchanged
+ * const original = [1, 2, 3]
+ * const shuffled = shuffle(original)
+ * console.log(original) // [1, 2, 3]
+ * ```
+ *
+ * @param arr The array to shuffle
+ * @returns A new shuffled array
+ * @category Array Utilities
+ */
+export declare function shuffle<T>(arr: T[]): T[];
+/**
+ * Groups array elements by a key derived from each element.
+ *
+ * @example
+ * ```typescript
+ * groupBy([1, 2, 3, 4], n => n % 2 === 0 ? 'even' : 'odd')
+ * // { odd: [1, 3], even: [2, 4] }
+ *
+ * groupBy([{ type: 'a' }, { type: 'b' }, { type: 'a' }], x => x.type)
+ * // { a: [{ type: 'a' }, { type: 'a' }], b: [{ type: 'b' }] }
+ * ```
+ *
+ * @param arr The array to group
+ * @param fn Function that returns the group key for each element
+ * @returns An object mapping keys to arrays of elements
+ * @category Array Utilities
+ */
+export declare function groupBy<T>(arr: T[], fn: (item: T) => string | number): Record<string | number, T[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/arrays/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/arrays/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAEhD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,GAAG,SAAS,CAE/C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEvC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEzD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,EAAE,CAOtD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAExC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAOxC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EACxB,GAAG,EAAE,CAAC,EAAE,EACR,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,GAC9B,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,CAO9B"}

package/dist/arrays/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function o(n){return n[0]}function T(n){return n.length?n[n.length-1]:void 0}function f(n){return Array.from(new Set(n))}function i(n){return n.flat()}function l(n,e){if(e<1)throw new Error("Chunk size must be at least 1");let t=[];for(let r=0;r<n.length;r+=e)t.push(n.slice(r,r+e));return t}function s(n){return n.filter(Boolean)}function c(n){let e=n.slice();for(let t=e.length-1;t>0;t--){let r=Math.floor(Math.random()*(t+1));[e[t],e[r]]=[e[r],e[t]]}return e}function h(n,e){return n.reduce((t,r)=>{let u=e(r);return t[u]||(t[u]=[]),t[u].push(r),t},{})}export{l as chunk,s as compact,o as first,i as flatten,h as groupBy,T as last,c as shuffle,f as unique};
+import"../chunks/chunk-ANN5UYCF.js";function u(n){return n[0]}function T(n){return n.length?n[n.length-1]:void 0}function f(n){return Array.from(new Set(n))}function i(n){return n.flat()}function l(n,e){if(e<1)throw new Error("Chunk size must be at least 1");let t=[];for(let r=0;r<n.length;r+=e)t.push(n.slice(r,r+e));return t}function s(n){return n.filter(Boolean)}function c(n){let e=n.slice();for(let t=e.length-1;t>0;t--){let r=Math.floor(Math.random()*(t+1));[e[t],e[r]]=[e[r],e[t]]}return e}function h(n,e){return n.reduce((t,r)=>{let o=e(r);return t[o]||(t[o]=[]),t[o].push(r),t},{})}export{l as chunk,s as compact,u as first,i as flatten,h as groupBy,T as last,c as shuffle,f as unique};

package/dist/boolean/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Converts a value to a boolean.
+ * Accepts 'true', '1', 1 as true; 'false', '0', 0 as false.
+ * @param value The value to convert.
+ * @returns The boolean representation.
+ */
+export declare function toBoolean(value: unknown): boolean;
+/**
+ * Checks if a value is a boolean.
+ * @param value The value to check.
+ * @returns True if the value is a boolean, false otherwise.
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * Returns the logical exclusive OR (XOR) of two booleans.
+ * @param a First boolean.
+ * @param b Second boolean.
+ * @returns True if exactly one of a or b is true.
+ */
+export declare function xor(a: boolean, b: boolean): boolean;
+/**
+ * Logical AND for two booleans.
+ * @param a First boolean.
+ * @param b Second boolean.
+ * @returns True if both a and b are true.
+ */
+export declare function and(a: boolean, b: boolean): boolean;
+/**
+ * Logical OR for two booleans.
+ * @param a First boolean.
+ * @param b Second boolean.
+ * @returns True if either a or b is true.
+ */
+export declare function or(a: boolean, b: boolean): boolean;
+/**
+ * Logical NOT for a boolean.
+ * @param a The boolean to negate.
+ * @returns The negated boolean.
+ */
+export declare function not(a: boolean): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/boolean/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/boolean/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAWjD;AAED;;;;GAIG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CAElD;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAEvC"}

package/dist/boolean/index.js

@@ -1 +1 @@
-import"../chunks/chunk-ANN5UYCF.js";function e(o){if(typeof o=="boolean")return o;if(typeof o=="string"){let n=o.trim().toLowerCase();if(n==="true"||n==="1")return!0;if(n==="false"||n==="0")return!1}return typeof o=="number"?o===1:!!o}function r(o){return typeof o=="boolean"}function t(o,n){return!!(o?!n:n)}function a(o,n){return o&&n}function f(o,n){return o||n}function b(o){return!o}export{a as and,r as isBoolean,b as not,f as or,e as toBoolean,t as xor};
+import"../chunks/chunk-ANN5UYCF.js";function e(o){if(typeof o=="boolean")return o;if(typeof o=="string"){let n=o.trim().toLowerCase();if(n==="true"||n==="1")return!0;if(n==="false"||n==="0")return!1}return typeof o=="number"?o===1:!!o}function r(o){return typeof o=="boolean"}function t(o,n){return!!(o?!n:n)}function a(o,n){return o&&n}function f(o,n){return o||n}function u(o){return!o}export{a as and,r as isBoolean,u as not,f as or,e as toBoolean,t as xor};

package/dist/colors/index.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Generates a random hex color string.
+ *
+ * @returns {string} A string representing a random color in hexadecimal format (e.g., `#a1b2c3`).
+ */
+export declare function randomColor(): string;
+/**
+ * Generates a random color with a given alpha value.
+ *
+ * @export
+ * @param {string} color
+ * @return {*}
+ */
+export declare function matchingTextColor(color: string): "#000" | "#fff";
+/**
+ * Converts a hex color string to an RGB object.
+ *
+ * @export
+ * @param {string} hex
+ * @return {*}  {({ r: number; g: number; b: number } | null)}
+ */
+export declare function hexToRgb(hex: string): {
+    r: number;
+    g: number;
+    b: number;
+} | null;
+/**
+ * Converts RGB values to a hex color string.
+ *
+ * @export
+ * @param {number} r
+ * @param {number} g
+ * @param {number} b
+ * @return {*}  {string}
+ */
+export declare function rgbToHex(r: number, g: number, b: number): string;
+/**
+ * Converts a hex color string to an HSL object.
+ *
+ * @export
+ * @param {string} hex
+ * @return {*}  {({ h: number; s: number; l: number } | null)}
+ */
+export declare function isValidHex(hex: string): boolean;
+/**
+ * Darkens a hex color by a given percentage.
+ *
+ * @export
+ * @param {string} hex
+ * @param {number} percent
+ * @return {*}  {string}
+ */
+export declare function darken(hex: string, percent: number): string;
+/**
+ * Lightens a hex color by a given percentage.
+ *
+ * @export
+ * @param {string} hex
+ * @param {number} percent
+ * @return {*}  {string}
+ */
+export declare function lighten(hex: string, percent: number): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/colors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/colors/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,mBAO9C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQhF;AAED;;;;;;;;GAQG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOhE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAO5D"}

package/dist/console/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @fileoverview Console utility functions for logging and disabling console output in production.
+ * @module console
+ */
+/**
+ * Disables console output in production environment.
+ */
+export declare const disableConsole: () => void;
+/**
+ * Clears the console.
+ *
+ * @export
+ * @return {*}  {void}
+ */
+export declare const clearConsole: () => void;
+//# sourceMappingURL=index.d.ts.map

package/dist/console/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/console/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc,YAK1B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,QAAO,IAE/B,CAAA"}

package/dist/crypto/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Hashes a string using the specified algorithm.
+ * @param str The string to hash.
+ * @param algorithm The hash algorithm (default: 'sha256').
+ * @returns The hex-encoded hash.
+ */
+export declare function hashString(str: string, algorithm?: string): string;
+/**
+ * Generates a random hex string of the specified length (in bytes).
+ * @param length The number of bytes (not hex chars).
+ * @returns A random hex string.
+ */
+export declare function randomHex(length?: number): string;
+/**
+ * Creates an HMAC hash of a string using a secret and algorithm.
+ * @param str The string to hash.
+ * @param secret The secret key.
+ * @param algorithm The hash algorithm (default: 'sha256').
+ * @returns The hex-encoded HMAC.
+ */
+export declare function hmacHash(str: string, secret: string, algorithm?: string): string;
+/**
+ * Encodes a string to base64.
+ * @param str The string to encode.
+ * @returns The base64-encoded string.
+ */
+export declare function base64Encode(str: string): string;
+/**
+ * Decodes a base64 string.
+ * @param b64 The base64 string to decode.
+ * @returns The decoded string.
+ */
+export declare function base64Decode(b64: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/crypto/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/crypto/index.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,MAAM,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,MAAM,SAAK,GAAG,MAAM,CAE7C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,MAAM,CAElF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/currency/currencies.d.ts

@@ -0,0 +1,16 @@
+/**
+ * List of supported currency codes.
+ *
+ * This array contains ISO 4217 currency codes and some special codes
+ * (such as precious metals and testing codes) used in financial applications.
+ *
+ * @remarks
+ * - Some codes represent fiat currencies (e.g., 'USD', 'EUR').
+ * - Some codes represent precious metals (e.g., 'XAU' for gold).
+ * - Some codes are reserved for testing or special purposes (e.g., 'XTS', 'XXX').
+ *
+ * @see {@link https://www.iso.org/iso-4217-currency-codes.html ISO 4217 Currency Codes}
+ */
+export declare const currencies: string[];
+export default currencies;
+//# sourceMappingURL=currencies.d.ts.map

package/dist/currency/currencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencies.d.ts","sourceRoot":"","sources":["../../src/currency/currencies.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,UAAU,UA4CtB,CAAA;AAED,eAAe,UAAU,CAAA"}