toolbox-x 1.0.0 → 1.0.1-rc.2

package/README.md

@@ -0,0 +1,409 @@
+# Toolbox X
+
+> “I solve problems you face daily”
+
+<p>
+  <!-- Package Info -->
+  <a href="https://www.npmjs.com/package/toolbox-x" aria-label="NPM Downloads">
+    <img src="https://img.shields.io/npm/dm/toolbox-x.svg?label=DOWNLOADS&style=flat&color=red&logo=npm" alt="Downloads" />
+  </a>
+  <a href="https://www.npmjs.com/package/toolbox-x" aria-label="Latest Version">
+    <img src="https://img.shields.io/npm/v/toolbox-x.svg?label=NPM&style=flat&color=teal&logo=npm" alt="Latest Version" />
+  </a>
+  <a href="https://bundlejs.com/?q=toolbox-x" aria-label="Bundle Size">
+    <img src="https://img.shields.io/bundlejs/size/toolbox-x?label=Bundle%20Size&style=flat&color=blue&logo=npm" alt="Bundle Size" />
+  </a>
+
+  <!-- Project Metadata -->
+  <a href="https://github.com/nazmul-nhb/toolbox-x" aria-label="TypeScript">
+    <img src="https://img.shields.io/badge/BUILT%20with-TypeScript-3178C6?style=flat&logo=typescript&logoColor=blue" alt="Built with TypeScript" />
+  </a>
+  <a href="https://github.com/nazmul-nhb/toolbox-x/actions" aria-label="Build Status">
+    <img src="https://img.shields.io/github/actions/workflow/status/nazmul-nhb/toolbox-x/publish.yml?label=BUILD%20%26%20PUBLISH&style=flat&logo=github" alt="Build Status" />
+  </a>
+  <a href="https://github.com/nazmul-nhb/toolbox-x" aria-label="Project Status">
+    <img src="https://img.shields.io/badge/STATUS-maintained-brightgreen?style=flat&logo=git" alt="Maintained" />
+  </a>
+  <a href="https://github.com/nazmul-nhb/toolbox-x/commits/main" aria-label="Last Commit">
+    <img src="https://img.shields.io/github/last-commit/nazmul-nhb/toolbox-x?style=flat&label=LAST%20COMMIT&logo=git" alt="Last Commit" />
+  </a>
+
+  <!-- GitHub Meta -->
+  <a href="https://github.com/nazmul-nhb/toolbox-x/stargazers" aria-label="GitHub Stars">
+    <img src="https://img.shields.io/github/stars/nazmul-nhb/toolbox-x?style=flat&label=STARS&logo=github" alt="GitHub stars" />
+  </a>
+  <a href="https://github.com/nazmul-nhb/toolbox-x/issues" aria-label="Open Issues">
+    <img src="https://img.shields.io/github/issues/nazmul-nhb/toolbox-x?style=flat&label=ISSUES&logo=github" alt="Open Issues" />
+  </a>
+  <a href="https://github.com/nazmul-nhb/toolbox-x/pulls" aria-label="Open Pull Requests">
+    <img src="https://img.shields.io/github/issues-pr/nazmul-nhb/toolbox-x?style=flat&label=PRs&logo=github" alt="Pull Requests" />
+  </a>
+
+  <!-- License Info -->
+  <a href="https://www.npmjs.com/package/toolbox-x" aria-label="License">
+    <img src="https://img.shields.io/npm/l/toolbox-x.svg?label=LICENSE&style=flat&color=orange&logo=open-source-initiative" alt="License" />
+  </a>
+</p>
+
+## JavaScript/TypeScript Utility Library
+
+**NHB Toolbox** provides battle-tested utilities for professional JavaScript/TypeScript development. Carefully crafted to solve common challenges with elegant, production-ready solutions:
+
+- **Helper Functions & Classes**: Reusable solutions for everyday tasks
+- **Type Guards & Predicates**: Runtime safety with perfect type inference
+- **Validation Utilities**: Robust data validation patterns
+- **Zero Dependencies**: Framework-agnostic implementation using only native TS/JS with 0 external package
+
+> [Explore Full Documentation →](https://toolbox-x.nazmul-nhb.dev/)
+
+---
+
+## Installation
+
+Choose your preferred package manager:
+
+```shell
+npm i toolbox-x
+```
+
+```shell
+pnpm add toolbox-x
+```
+
+```shell
+yarn add toolbox-x
+```
+
+---
+
+## Changelog
+
+See [Changelog](CHANGELOG.md) for recent updates.
+
+---
+
+## Key Features
+
+- **Type-Safe Utilities**:Fully typed for perfect TypeScript integration with strict type checking
+- **Modular Design**: Tree-shaking friendly – import only what you need with zero bloat
+- **Zero Dependencies**: No external dependencies - works with any JS/TS framework
+- **IDE Support**: Full type hints with JSDoc-powered API references in your editor
+- **Comprehensive Documentation**: Learn with real-world use cases on [documentation site](https://toolbox-x.nazmul-nhb.dev/)
+- **Battle-Tested**: Reliable utilities refined through real-world production use
+- **Optimized for Production**: Focused on clean, efficient implementations
+
+---
+
+## Signature Utilities
+
+### 🎨 Professional Color Manipulation
+
+**`Color`** - Convert between color formats, generate palettes, check accessibility contrast, and perform advanced color math with perfect type safety.
+
+```typescript
+const blue = new Color('#0000ff');
+const darkerBlue = blue.applyDarkness(20); // 20% darker
+console.log(darkerBlue.hsl); // "hsl(240, 100%, 40%)" (was 50%)
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/classes/Color)
+
+---
+
+### 🔍 Optimized Array Search
+
+**`Finder`** - Blazing-fast array searching with binary search, fuzzy matching, and smart caching. Perfect for large datasets.
+
+```typescript
+const productFinder = new Finder(products);
+
+const laptop = productFinder.findOne('laptop', 'category', {
+ fuzzy: true,
+ caseInsensitive: false,
+});
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/classes/Finder)
+
+---
+
+### 🆔 Random ID Generation
+
+**`generateRandomID`** - Enterprise-grade unique ID generation with prefixes, timestamps, and formatting.
+
+```typescript
+generateRandomID({
+ prefix: 'user',
+ timeStamp: true,
+ length: 12,
+ caseOption: 'upper',
+}); // "USER-171234567890-AB3C4D5E6F7G"
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/string/generateRandomID)
+
+---
+
+### 🔢 Pluralize Strings and More
+
+**`pluralizer`** - Handles English word pluralization and singularization with support for irregular forms and uncountable nouns.
+
+```ts
+import { pluralizer } from 'toolbox-x';
+
+pluralizer.pluralize('child'); // "children"
+pluralizer.pluralize('category', { count: 3 }); // "categories"
+pluralizer.pluralize('child', { count: 1, inclusive: true }); // "1 child"
+
+pluralizer.toSingular('geese'); // "goose"
+pluralizer.toSingular('children'); // "child"
+
+pluralizer.isPlural('children'); // true
+pluralizer.isSingular('child'); // true
+pluralizer.isPlural('fish'); // true (uncountable)
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/string/pluralizer)
+
+---
+
+### 🎨 Color System Utilities
+
+**`getColorForInitial`** - Deterministic color mapping system for consistent UI theming
+
+```typescript
+// Get color palette for user avatars
+getColorForInitial(['Alice', 'Bob', 'Charlie']);
+// ['#00094C', '#00376E', '#005600']
+
+getColorForInitial('Banana', 50); // '#00376E80' (50% opacity)
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/color/getColorForInitial)
+
+---
+
+### 📄 FormData Preparation
+
+**`createFormData`** - Convert JavaScript objects into `FormData` with extensive configuration options for handling nested structures, files, and data transformations.
+
+```typescript
+import { createFormData } from 'toolbox-x';
+
+const formData = createFormData({
+  user: {
+    name: ' John Doe ',
+    age: 30,
+    preferences: { theme: 'dark' }
+  },
+  files: [file1, file2]
+}, {
+  trimStrings: true,
+  lowerCaseValues: ['user.name'],
+  dotNotateNested: ['user.preferences'],
+  breakArray: ['files']
+});
+
+// Resulting FormData:
+// user.name=john doe
+// user.age=30
+// user.preferences.theme=dark
+// files[0]=[File1]
+// files[1]=[File2]
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/form/createFormData)
+
+---
+
+### 🛡️ Data Sanitization
+
+**`sanitizeData`** - Clean and normalize strings/objects by trimming whitespace, removing empty values, and applying customizable filters.
+
+```typescript
+const user = {
+ name: '  John Doe  ',
+ age: null,
+ address: { city: '  NYC  ', zip: '' },
+ tags: [],
+};
+
+sanitizeData(user, { ignoreNullish: true, ignoreEmpty: true });
+// Returns { name: "John Doe", address: { city: "NYC" } } with exact input type which may cause issue when accessing missing properties
+
+sanitizeData(user, { ignoreNullish: true, ignoreEmpty: true }, 'partial');
+// Return type: $DeepPartial<typeof user> safe property access by making all the properties (nested objects/arrays) optional 
+// Returns { name: "John Doe", address: { city: "NYC" } }
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/object/sanitizeData)
+
+---
+
+### 🔄 JSON Hydration
+
+**`parseJSON`** - Bulletproof JSON parsing with primitive conversion
+
+```typescript
+parseJSON('{"value":"42"}'); // { value: 42 } (auto-converts numbers)
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/misc/parseJSON)
+
+---
+
+### 🔢 Number to Words
+
+**`numberToWords`** - Convert numbers to human-readable words (supports up to 100 quintillion).
+
+```typescript
+numberToWords(125); // "one hundred twenty-five"
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/number/numberToWords)
+
+---
+
+### 🔢 Advanced Number Operations
+
+**`getNumbersInRange`** - Generate intelligent number sequences with prime, even/odd, and custom filtering capabilities
+
+```typescript
+// Get primes between 10-30 as formatted string
+getNumbersInRange('prime', { min: 10, max: 30, getAsString: true });
+// "11, 13, 17, 19, 23, 29"
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/number/getNumbersInRange)
+
+**`calculatePercentage`** - Swiss Army knife for percentage calculations with 7 specialized modes
+
+```typescript
+// Calculate percentage change
+calculatePercentage({
+ mode: 'get-change-percent',
+ oldValue: 100,
+ newValue: 150,
+}); // 50 (50% increase)
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/number/calculatePercentage)
+
+---
+
+### 🔄 Extract Updated Fields
+
+**`extractUpdatedFields`** - Detect exactly what changed between two objects (including deep nested changes).
+
+```typescript
+const dbRecord = { id: 1, content: 'Hello', meta: { views: 0 } };
+const update = { content: 'Hello', meta: { views: 1 } };
+extractUpdatedFields(dbRecord, update);
+// { meta: { views: 1 } }
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/object/extractUpdatedFields)
+
+---
+
+### 🎨 Style Console Output(s)
+
+**`Stylog`** - `Chalk`-like minimal utility to style console output(s) in both Node.js & Browser environment(s) (supports named CSS colors).
+
+```typescript
+// Basic coloring
+Stylog.error.log('Error message');
+Stylog.success.log('Success message');
+Stylog.info.log('Info message');
+Stylog.whitesmoke.log('I am White!');
+
+// Multiple styles
+Stylog.blue.bold.underline.log('I am Bold Underlined Blue!');
+
+// With object stringification
+Stylog.magenta.italic.log({ data: 'value' }, true);
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/misc/stylog)
+
+---
+
+### ⚡ Performance Optimizers
+
+**`throttleAction`** - Precision control for high-frequency events
+
+```typescript
+// Smooth scroll handling
+throttleAction(updateScrollPosition, 100);
+```
+
+[Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/misc/throttleAction)
+
+**`debounceAction`** - Intelligent delay for expensive operations
+
+```typescript
+// Search-as-you-type
+debounceAction(fetchResults, 300);
+```
+
+[Full Documentation →](https://toolbox-x.nazmul-nhb.dev/docs/utilities/misc/debounceAction)
+
+> These utilities represent just a portion of the comprehensive `toolbox-x`. Each is designed with production-grade reliability and developer experience in mind. Explore more in the [full documentation](https://toolbox-x.nazmul-nhb.dev). All the utilities and classes are categorized.
+
+---
+
+## 🔗 Related Packages
+
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+  <a target="_blank" href="https://www.npmjs.com/package/chronos-date">
+    <img src="https://img.shields.io/badge/Chronos_Date-chronos-date-blue" alt="bn-calendar" />
+  </a>
+</div>
+
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+  <a target="_blank" href="https://www.npmjs.com/package/bn-calendar">
+    <img src="https://img.shields.io/badge/Bangla_Calendar-bn-calendar-blue" alt="bn-calendar" />
+  </a>
+</div>
+
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+  <a target="_blank" href="https://www.npmjs.com/package/nhb-hooks">
+    <img src="https://img.shields.io/badge/React_Hooks-nhb--hooks-blue" alt="nhb-hooks" />
+  </a>
+</div>
+
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+  <a target="_blank" href="https://www.npmjs.com/package/locality-idb">
+    <img src="https://img.shields.io/badge/IndexedDB_ORM-locality--idb-darkviolet" alt="locality-idb" />
+  </a>
+</div>
+
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+  <a target="_blank" href="https://www.npmjs.com/package/nhb-scripts">
+    <img src="https://img.shields.io/badge/Development_Scripts-nhb--scripts-red" alt="nhb-scripts" />
+  </a>
+</div>
+
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+  <a target="_blank" href="https://www.npmjs.com/package/nhb-express">
+    <img src="https://img.shields.io/badge/Express_Server_Scaffolder-nhb--express-orange" alt="nhb-express" />
+  </a>
+</div>
+
+<div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+  <a target="_blank" href="https://www.npmjs.com/package/nhb-anagram-generator">
+    <img src="https://img.shields.io/badge/Anagram_Generator-nhb--anagram--generator-teal" alt="nhb-anagram-generator" />
+  </a>
+</div>
+
+---
+
+## License
+
+This project is licensed under the [Apache License 2.0](LICENSE) with the following additional requirement:
+
+**Additional Requirement:**
+
+> Any fork, derivative work, or redistribution of this project must include clear attribution to [**Nazmul Hassan**](https://github.com/nazmul-nhb) in both the source code and any publicly available documentation.
+
+You are free to use, modify, and distribute this project under the terms of the Apache 2.0 License, provided that appropriate credit is given.

package/dist/{Color-B3mgF9Dh.d.cts → Color-BK-IISGk.d.cts}

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { $ as Maybe, V as Branded, rn as Percent } from "./object-Blq0Amdv.cjs";
-import { t as CSS_COLORS } from "./css-colors-Bx947Ng3.cjs";
+import { $ as Maybe, V as Branded, rn as Percent } from "./object-NOZEWHcC.cjs";
+import { t as CSS_COLORS } from "./css-colors-Dqz6Bfnp.cjs";
 
 //#region src/types/colors.d.ts
 /** - A string, number for generating color. */

package/dist/{Color-D38Xrw65.d.mts → Color-BrtYYm8M.d.mts}

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { $ as Maybe, V as Branded, rn as Percent } from "./object-B0TV3eHx.mjs";
-import { t as CSS_COLORS } from "./css-colors-CXTp1vvy.mjs";
+import { $ as Maybe, V as Branded, rn as Percent } from "./object-NOZEWHcC.mjs";
+import { t as CSS_COLORS } from "./css-colors-Dqz6Bfnp.mjs";
 
 //#region src/types/colors.d.ts
 /** - A string, number for generating color. */

package/dist/{Stylog-Df7eq3-j.d.cts → Stylog-BmrFKYBu.d.mts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { s as CSSColor } from "./Color-B3mgF9Dh.cjs";
+import { s as CSSColor } from "./Color-BrtYYm8M.mjs";
 
 //#region src/stylog/constants.d.ts
 /** Records of ANSI-16 colors with values */
@@ -88,7 +88,7 @@ type StylogChain = LogStyler & { [K in Styles]: StylogChain };
  *
  * @remarks
  * - Allows chaining of style methods or initializing with predefined styles.
- * - For fluent, chainable styling with zero configuration use {@link https://toolbox.nazmul-nhb.dev/docs/utilities/misc/stylog Stylog} (`LogStyler` chainable wrapper).
+ * - For fluent, chainable styling with zero configuration use {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/misc/stylog Stylog} (`LogStyler` chainable wrapper).
  *
  * @example
  * const styled = new LogStyler(['red', 'bold']);
@@ -185,7 +185,7 @@ declare class LogStyler {
    * @remarks
    * - This method is specifically designed for browser environments and returns a tuple containing the formatted string with `%c` placeholder and an array of CSS styles (`string[]`).
    * - Use this when you need direct access to the CSS styling for custom browser output.
-   * - If you want to format with ANSI escape codes, consider using {@link https://toolbox.nazmul-nhb.dev/docs/classes/LogStyler#toansiinput-stringify toANSI} method.
+   * - If you want to format with ANSI escape codes, consider using {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/LogStyler#toansiinput-stringify toANSI} method.
    *
    * @param input - Input to style before printing in the shell.
    * @param stringify - Whether to apply `JSON.stringify()` before styling. Defaults to `false`.
@@ -224,7 +224,7 @@ declare class LogStyler {
    *
    * @remarks
    * - This method returns ANSI-formatted strings suitable for environments that support ANSI escape codes (terminals, modern browser consoles, etc.).
-   * - For unsupported browsers, consider using the {@link https://toolbox.nazmul-nhb.dev/docs/classes/LogStyler#loginput-stringify log} method to print directly or {@link https://toolbox.nazmul-nhb.dev/docs/classes/LogStyler#tocssinput-stringify toCSS} to get styled tuple `[format, cssList]` for Browser.
+   * - For unsupported browsers, consider using the {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/LogStyler#loginput-stringify log} method to print directly or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/LogStyler#tocssinput-stringify toCSS} to get styled tuple `[format, cssList]` for Browser.
    *
    * @param input - Input to style before printing in the shell.
    * @param stringify - Whether to apply `JSON.stringify()` before styling. Defaults to `false`.
@@ -493,7 +493,7 @@ declare class LogStyler {
  * - In browsers, styles are applied using `CSS`; in `Node.js`, `ANSI` escape codes are used.
  * - When multiple styles of the same category are chained, the last one wins.
  * - Use `.log(value, stringify?)` to print; set `stringify` to `true` to serialize with `JSON.stringify`.
- * - If you need custom reusable style configurations, use {@link https://toolbox.nazmul-nhb.dev/docs/classes/LogStyler Stylog} class.
+ * - If you need custom reusable style configurations, use {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/LogStyler Stylog} class.
  *
  * @example
  * // Simple color

package/dist/{Stylog-jvlLcMQq.d.mts → Stylog-oNGfcRqH.d.cts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { s as CSSColor } from "./Color-D38Xrw65.mjs";
+import { s as CSSColor } from "./Color-BK-IISGk.cjs";
 
 //#region src/stylog/constants.d.ts
 /** Records of ANSI-16 colors with values */
@@ -88,7 +88,7 @@ type StylogChain = LogStyler & { [K in Styles]: StylogChain };
  *
  * @remarks
  * - Allows chaining of style methods or initializing with predefined styles.
- * - For fluent, chainable styling with zero configuration use {@link https://toolbox.nazmul-nhb.dev/docs/utilities/misc/stylog Stylog} (`LogStyler` chainable wrapper).
+ * - For fluent, chainable styling with zero configuration use {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/misc/stylog Stylog} (`LogStyler` chainable wrapper).
  *
  * @example
  * const styled = new LogStyler(['red', 'bold']);
@@ -185,7 +185,7 @@ declare class LogStyler {
    * @remarks
    * - This method is specifically designed for browser environments and returns a tuple containing the formatted string with `%c` placeholder and an array of CSS styles (`string[]`).
    * - Use this when you need direct access to the CSS styling for custom browser output.
-   * - If you want to format with ANSI escape codes, consider using {@link https://toolbox.nazmul-nhb.dev/docs/classes/LogStyler#toansiinput-stringify toANSI} method.
+   * - If you want to format with ANSI escape codes, consider using {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/LogStyler#toansiinput-stringify toANSI} method.
    *
    * @param input - Input to style before printing in the shell.
    * @param stringify - Whether to apply `JSON.stringify()` before styling. Defaults to `false`.
@@ -224,7 +224,7 @@ declare class LogStyler {
    *
    * @remarks
    * - This method returns ANSI-formatted strings suitable for environments that support ANSI escape codes (terminals, modern browser consoles, etc.).
-   * - For unsupported browsers, consider using the {@link https://toolbox.nazmul-nhb.dev/docs/classes/LogStyler#loginput-stringify log} method to print directly or {@link https://toolbox.nazmul-nhb.dev/docs/classes/LogStyler#tocssinput-stringify toCSS} to get styled tuple `[format, cssList]` for Browser.
+   * - For unsupported browsers, consider using the {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/LogStyler#loginput-stringify log} method to print directly or {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/LogStyler#tocssinput-stringify toCSS} to get styled tuple `[format, cssList]` for Browser.
    *
    * @param input - Input to style before printing in the shell.
    * @param stringify - Whether to apply `JSON.stringify()` before styling. Defaults to `false`.
@@ -493,7 +493,7 @@ declare class LogStyler {
  * - In browsers, styles are applied using `CSS`; in `Node.js`, `ANSI` escape codes are used.
  * - When multiple styles of the same category are chained, the last one wins.
  * - Use `.log(value, stringify?)` to print; set `stringify` to `true` to serialize with `JSON.stringify`.
- * - If you need custom reusable style configurations, use {@link https://toolbox.nazmul-nhb.dev/docs/classes/LogStyler Stylog} class.
+ * - If you need custom reusable style configurations, use {@link https://toolbox-x.nazmul-nhb.dev/docs/classes/LogStyler Stylog} class.
  *
  * @example
  * // Simple color

package/dist/{array-DvW0zIu6.d.mts → array-606C3HIi.d.cts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { E as NestedPrimitiveKey, nt as NormalPrimitiveKey, y as GenericObject } from "./object-B0TV3eHx.mjs";
+import { E as NestedPrimitiveKey, nt as NormalPrimitiveKey, y as GenericObject } from "./object-NOZEWHcC.cjs";
 
 //#region src/types/array.d.ts
 /** * Flatten Array or Wrap in Array */

package/dist/{array-rUnEVisO.d.cts → array-qTbLCFHP.d.mts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { E as NestedPrimitiveKey, nt as NormalPrimitiveKey, y as GenericObject } from "./object-Blq0Amdv.cjs";
+import { E as NestedPrimitiveKey, nt as NormalPrimitiveKey, y as GenericObject } from "./object-NOZEWHcC.mjs";
 
 //#region src/types/array.d.ts
 /** * Flatten Array or Wrap in Array */

package/dist/{basics-WEYWlnRO.d.cts → basics-BlJgwEqR.d.mts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { F as RandomIdOptions } from "./string-CsNsm_65.cjs";
+import { F as RandomIdOptions } from "./string-BhaQOeKm.mjs";
 
 //#region src/string/basics.d.ts
 /**
@@ -31,8 +31,8 @@ declare function truncateString(str: string, maxLength: number): string;
  * @param options Configuration options for random ID generation.
  * @returns The generated ID string composed of the random alphanumeric string of specified length with optional `timeStamp`, `prefix`, and `suffix`, `caseOption` and `separator`.
  *
- * @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/uuid uuid} for `uuid` generation
- * @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/randomHex randomHex} for random hexadecimal string generation
+ * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/hash/uuid uuid} for `uuid` generation
+ * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/hash/randomHex randomHex} for random hexadecimal string generation
  *
  * @example
  * // Generate an ID with all default options

package/dist/{basics-uBSfkBEI.d.mts → basics-CEMMxosO.d.cts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { F as RandomIdOptions } from "./string-CBAbxaG1.mjs";
+import { F as RandomIdOptions } from "./string-DN4hbA7H.cjs";
 
 //#region src/string/basics.d.ts
 /**
@@ -31,8 +31,8 @@ declare function truncateString(str: string, maxLength: number): string;
  * @param options Configuration options for random ID generation.
  * @returns The generated ID string composed of the random alphanumeric string of specified length with optional `timeStamp`, `prefix`, and `suffix`, `caseOption` and `separator`.
  *
- * @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/uuid uuid} for `uuid` generation
- * @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/randomHex randomHex} for random hexadecimal string generation
+ * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/hash/uuid uuid} for `uuid` generation
+ * @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/hash/randomHex randomHex} for random hexadecimal string generation
  *
  * @example
  * // Generate an ID with all default options

package/dist/{basics-D_eSv0cu.cjs → basics-CYqqguZr.cjs}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-const require_primitives = require('./primitives-B26uZolQ.cjs');
+const require_primitives = require('./primitives-CBGICrDR.cjs');
 
 //#region src/string/basics.ts
 /**
@@ -37,8 +37,8 @@ function truncateString(str, maxLength) {
 * @param options Configuration options for random ID generation.
 * @returns The generated ID string composed of the random alphanumeric string of specified length with optional `timeStamp`, `prefix`, and `suffix`, `caseOption` and `separator`.
 *
-* @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/uuid uuid} for `uuid` generation
-* @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/randomHex randomHex} for random hexadecimal string generation
+* @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/hash/uuid uuid} for `uuid` generation
+* @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/hash/randomHex randomHex} for random hexadecimal string generation
 *
 * @example
 * // Generate an ID with all default options

package/dist/{basics-Dp_aEK81.mjs → basics-DQe9mP_M.mjs}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { a as isNonEmptyString } from "./primitives-KsFUp3kQ.mjs";
+import { a as isNonEmptyString } from "./primitives-Djsevc69.mjs";
 
 //#region src/string/basics.ts
 /**
@@ -37,8 +37,8 @@ function truncateString(str, maxLength) {
 * @param options Configuration options for random ID generation.
 * @returns The generated ID string composed of the random alphanumeric string of specified length with optional `timeStamp`, `prefix`, and `suffix`, `caseOption` and `separator`.
 *
-* @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/uuid uuid} for `uuid` generation
-* @see {@link https://toolbox.nazmul-nhb.dev/docs/utilities/hash/randomHex randomHex} for random hexadecimal string generation
+* @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/hash/uuid uuid} for `uuid` generation
+* @see {@link https://toolbox-x.nazmul-nhb.dev/docs/utilities/hash/randomHex randomHex} for random hexadecimal string generation
 *
 * @example
 * // Generate an ID with all default options

package/dist/{case-BWIt8Ash.mjs → case-BQwn5N-k.mjs}

@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 
-import { a as isNonEmptyString } from "./primitives-KsFUp3kQ.mjs";
-import { t as LOWERCASE } from "./constants-2gAw23_7.mjs";
+import { a as isNonEmptyString } from "./primitives-Djsevc69.mjs";
+import { t as LOWERCASE } from "./constants-B0zJiNqH.mjs";
 
 //#region src/string/case.ts
 /** Lowercase words set for fast lookup */

package/dist/{case-C-S-b5YP.d.cts → case-BYCCZ2yI.d.cts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { B as TitleCase, I as SentenceCase, L as SnakeCase, M as PascalSnakeCase, N as PathCase, T as DotCase, V as TrainCase, f as CamelCase, g as ConstantCase, j as PascalCase, k as KebabCase, m as CaseFormat, p as CapitalizeOptions, z as StringCaseOptions } from "./string-CsNsm_65.cjs";
+import { B as TitleCase, I as SentenceCase, L as SnakeCase, M as PascalSnakeCase, N as PathCase, T as DotCase, V as TrainCase, f as CamelCase, g as ConstantCase, j as PascalCase, k as KebabCase, m as CaseFormat, p as CapitalizeOptions, z as StringCaseOptions } from "./string-DN4hbA7H.cjs";
 
 //#region src/string/case.d.ts
 /**

package/dist/{case-CybASFPD.d.mts → case-DF2Af4Fw.d.mts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { B as TitleCase, I as SentenceCase, L as SnakeCase, M as PascalSnakeCase, N as PathCase, T as DotCase, V as TrainCase, f as CamelCase, g as ConstantCase, j as PascalCase, k as KebabCase, m as CaseFormat, p as CapitalizeOptions, z as StringCaseOptions } from "./string-CBAbxaG1.mjs";
+import { B as TitleCase, I as SentenceCase, L as SnakeCase, M as PascalSnakeCase, N as PathCase, T as DotCase, V as TrainCase, f as CamelCase, g as ConstantCase, j as PascalCase, k as KebabCase, m as CaseFormat, p as CapitalizeOptions, z as StringCaseOptions } from "./string-BhaQOeKm.mjs";
 
 //#region src/string/case.d.ts
 /**