toolbox-x 2.4.1 → 2.4.2

package/CHANGELOG.md

@@ -4,6 +4,13 @@ All notable changes to **toolbox-x** will be documented in this file.
 
 > Auto-generated from git history using [changelog-maker](https://github.com/nodejs/changelog-maker).
 
+## [v2.4.2](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.4.2) — 2026-06-17
+
+[Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.4.1...v2.4.2)
+
+* \[[`9ce8196718`](https://github.com/nazmul-nhb/toolbox-x/commit/9ce8196718)] - 🔧 update(string-diff): updated type defs and docs for diff utils (Nazmul Hassan)
+* \[[`6bd96bf45d`](https://github.com/nazmul-nhb/toolbox-x/commit/6bd96bf45d)] - 📚 docs: updated CHANGELOG.md for v2.4.1 (github-actions\[bot])
+
 ## [v2.4.1](https://github.com/nazmul-nhb/toolbox-x/releases/tag/v2.4.1) — 2026-06-17
 
 [Compare changes](https://github.com/nazmul-nhb/toolbox-x/compare/v2.4.0...v2.4.1)

package/dist/{basics-DY7AX7D4.d.mts → basics-BuHQJCNG.d.mts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { I as RandomIdOptions } from "./string-GQsmDdYa.mjs";
+import { z as RandomIdOptions } from "./string-edtZyJHf.mjs";
 
 //#region src/string/basics.d.ts
 /**

package/dist/{basics-DlwGpXu-.d.cts → basics-CLwtIxap.d.cts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { I as RandomIdOptions } from "./string-EMT7czsU.cjs";
+import { z as RandomIdOptions } from "./string-Ok_IMpHP.cjs";
 
 //#region src/string/basics.d.ts
 /**

package/dist/{case-CcoD-jFV.d.mts → case-BmB2aGyp.d.cts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { A as KebabCase, B as StringCaseOptions, E as DotCase, H as TrainCase, L as SentenceCase, M as PascalCase, N as PascalSnakeCase, P as PathCase, R as SnakeCase, V as TitleCase, _ as ConstantCase, h as CaseFormat, m as CapitalizeOptions, p as CamelCase, u as $WidenEmpty } from "./string-GQsmDdYa.mjs";
+import { F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, K as TrainCase, L as PathCase, N as KebabCase, V as SentenceCase, W as StringCaseOptions, g as CaseFormat, h as CapitalizeOptions, k as DotCase, m as CamelCase, u as $WidenEmpty, v as ConstantCase } from "./string-Ok_IMpHP.cjs";
 
 //#region src/string/case.d.ts
 /**

package/dist/{case-DMCkxWbW.d.cts → case-Ce8HJI8I.d.mts}

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-import { A as KebabCase, B as StringCaseOptions, E as DotCase, H as TrainCase, L as SentenceCase, M as PascalCase, N as PascalSnakeCase, P as PathCase, R as SnakeCase, V as TitleCase, _ as ConstantCase, h as CaseFormat, m as CapitalizeOptions, p as CamelCase, u as $WidenEmpty } from "./string-EMT7czsU.cjs";
+import { F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, K as TrainCase, L as PathCase, N as KebabCase, V as SentenceCase, W as StringCaseOptions, g as CaseFormat, h as CapitalizeOptions, k as DotCase, m as CamelCase, u as $WidenEmpty, v as ConstantCase } from "./string-edtZyJHf.mjs";
 
 //#region src/string/case.d.ts
 /**

package/dist/change-case.d.cts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-DMCkxWbW.cjs";
+import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-BmB2aGyp.cjs";
 export { capitalizeString, convertStringCase, toCamelCase, toConstantCase, toDotCase, toKebabCase, toPascalCase, toPascalSnakeCase, toPathCase, toSentenceCase, toSnakeCase, toTitleCase, toTrainCase };

package/dist/change-case.d.mts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-CcoD-jFV.mjs";
+import { a as toDotCase, c as toPascalSnakeCase, d as toSnakeCase, f as toTitleCase, i as toConstantCase, l as toPathCase, n as convertStringCase, o as toKebabCase, p as toTrainCase, r as toCamelCase, s as toPascalCase, t as capitalizeString, u as toSentenceCase } from "./case-Ce8HJI8I.mjs";
 export { capitalizeString, convertStringCase, toCamelCase, toConstantCase, toDotCase, toKebabCase, toPascalCase, toPascalSnakeCase, toPathCase, toSentenceCase, toSnakeCase, toTitleCase, toTrainCase };

package/dist/dom/index.d.cts

@@ -15,8 +15,8 @@
  */
 
 import { J as Deserializer, ft as Serializer, y as GenericObject } from "../object-DyVg8BFt.cjs";
-import { a as updateQueryParam, i as parseQueryStringLiteral, n as getQueryParams, r as parseQueryString, t as generateQueryParams } from "../query-BLsaWi3q.cjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-DA-YShnM.cjs";
+import { a as updateQueryParam, i as parseQueryStringLiteral, n as getQueryParams, r as parseQueryString, t as generateQueryParams } from "../query-BMtRmMSC.cjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-DhsFvo_D.cjs";
 
 //#region src/dom/storage.d.ts
 /**

package/dist/dom/index.d.mts

@@ -15,8 +15,8 @@
  */
 
 import { J as Deserializer, ft as Serializer, y as GenericObject } from "../object-DyVg8BFt.mjs";
-import { a as updateQueryParam, i as parseQueryStringLiteral, n as getQueryParams, r as parseQueryString, t as generateQueryParams } from "../query-Bi_ofCBp.mjs";
-import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-DIYoIS0E.mjs";
+import { a as updateQueryParam, i as parseQueryStringLiteral, n as getQueryParams, r as parseQueryString, t as generateQueryParams } from "../query-C-r5ZbO-.mjs";
+import { a as OriginFileObj, i as FormDataConfigs, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-D_5I437n.mjs";
 
 //#region src/dom/storage.d.ts
 /**

package/dist/{form-DIYoIS0E.d.mts → form-D_5I437n.d.mts}

@@ -15,7 +15,7 @@
  */
 
 import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, at as NormalPrimitive, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.mjs";
-import { F as QueryString } from "./string-GQsmDdYa.mjs";
+import { R as QueryString } from "./string-edtZyJHf.mjs";
 import { f as TypeOrArray } from "./array-CbAKXvhH.mjs";
 
 //#region src/types/form.d.ts

package/dist/{form-DA-YShnM.d.cts → form-DhsFvo_D.d.cts}

@@ -15,7 +15,7 @@
  */
 
 import { S as KeyForObject, T as NestedKeyString, ai as RequireExactly, at as NormalPrimitive, u as DotNotationKey, x as KeyForArray } from "./object-DyVg8BFt.cjs";
-import { F as QueryString } from "./string-EMT7czsU.cjs";
+import { R as QueryString } from "./string-Ok_IMpHP.cjs";
 import { f as TypeOrArray } from "./array-EVkwcL_k.cjs";
 
 //#region src/types/form.d.ts

package/dist/hash/index.d.cts

@@ -17,7 +17,7 @@
 import { nt as Maybe, y as GenericObject } from "../object-DyVg8BFt.cjs";
 import { _ as VerifiedToken, d as SignetPayload, l as SignOptions, p as TokenString, s as DecodedToken, v as VerifyOptions } from "../hash-DHawpylk.cjs";
 import { a as isUUIDv4, c as isUUIDv7, i as isUUIDv3, l as isUUIDv8, n as isUUIDv1, o as isUUIDv5, r as isUUIDv2, s as isUUIDv6, t as decodeUUID, u as uuid, w as isUUID } from "../uuid-CMNRM9NO.cjs";
-import { t as generateRandomID } from "../basics-DlwGpXu-.cjs";
+import { t as generateRandomID } from "../basics-CLwtIxap.cjs";
 
 //#region src/hash/Cipher.d.ts
 /**

package/dist/hash/index.d.mts

@@ -17,7 +17,7 @@
 import { nt as Maybe, y as GenericObject } from "../object-DyVg8BFt.mjs";
 import { _ as VerifiedToken, d as SignetPayload, l as SignOptions, p as TokenString, s as DecodedToken, v as VerifyOptions } from "../hash-2mygGWLk.mjs";
 import { a as isUUIDv4, c as isUUIDv7, i as isUUIDv3, l as isUUIDv8, n as isUUIDv1, o as isUUIDv5, r as isUUIDv2, s as isUUIDv6, t as decodeUUID, u as uuid, w as isUUID } from "../uuid-DvQsIl9p.mjs";
-import { t as generateRandomID } from "../basics-DY7AX7D4.mjs";
+import { t as generateRandomID } from "../basics-BuHQJCNG.mjs";
 
 //#region src/hash/Cipher.d.ts
 /**

package/dist/index.cjs

@@ -274,10 +274,8 @@ function computeTextDiff(originalText, modifiedText) {
 				usedIndices.add(idx);
 			}
 		} else if (line.type !== "added" || !usedIndices.has(idx)) {
-			if (line.type !== "added" || !usedIndices.has(idx)) {
-				processedLines.push(line);
-				usedIndices.add(idx);
-			}
+			processedLines.push(line);
+			usedIndices.add(idx);
 		}
 	}
 	let linesAdded = 0;

package/dist/index.d.cts

@@ -15,12 +15,12 @@
  */
 
 import { $n as NumberType, Bn as DecimalOptions, D as NumericDotKey, E as NestedPrimitiveKey, F as SanitizeOptions, I as SanitizedData, In as BnDigitResult, Ln as ConvertOptions, O as ObjectEntry, Q as FlattenPartial, Rn as ConvertedDecimal, Un as FrankFurterCurrency, V as BasicPrimitive, Xn as LocaleCode, Zn as LooseRomanNumeral, a as ConvertObjectOptions, ar as RomanCapital, c as DeepKeys, ci as Tuple, ct as Numeric, g as FlattenDotValue, ir as RangedNumbers, k as Objects, lt as OwnKeys, nr as RandomNumberOptions, nt as Maybe, o as ConvertedObject, p as ExpandAll, pi as Unit, rr as RangeOptions, s as CountryDetails, tr as PercentageOptions, u as DotNotationKey, ut as PartialOrRequired, v as FlattenLeafValue, w as MergeAll, y as GenericObject, z as Any, zn as CurrencyCode } from "./object-DyVg8BFt.cjs";
-import { T as DiffResult, f as AnagramOptions, g as CharDiffResult, j as MaskOptions } from "./string-EMT7czsU.cjs";
-import { n as convertStringCase, t as capitalizeString } from "./case-DMCkxWbW.cjs";
-import { i as parseQueryStringLiteral, r as parseQueryString, t as generateQueryParams } from "./query-BLsaWi3q.cjs";
+import { D as DiffResult, P as MaskOptions, _ as CharDiffResult, p as AnagramOptions } from "./string-Ok_IMpHP.cjs";
+import { n as convertStringCase, t as capitalizeString } from "./case-BmB2aGyp.cjs";
+import { i as parseQueryStringLiteral, r as parseQueryString, t as generateQueryParams } from "./query-BMtRmMSC.cjs";
 import { c as OrderOption, l as SortByOption, n as FindOptions, s as OptionsConfig, t as FieldValue, u as SortNature } from "./array-EVkwcL_k.cjs";
 import { C as shuffleArray, S as isInvalidOrEmptyArray, _ as findPrimeNumbers, a as deepParsePrimitives, b as flattenArray, c as getInstanceGetterNames, d as getStaticMethodNames, f as isDeepEqual, g as throttleAction, h as stripJsonEdgeGarbage, i as debounceAction, l as getInstanceMethodNames, m as stableStringify, n as countInstanceMethods, o as definePrototypeMethod, p as parseJSON, r as countStaticMethods, s as getClassDetails, t as convertArrayToString, u as getStaticGetterNames, v as isPrime, x as getLastArrayElement, y as filterArrayOfObjects } from "./index-D00Uqm9S.cjs";
-import { n as trimString, r as truncateString, t as generateRandomID } from "./basics-DlwGpXu-.cjs";
+import { n as trimString, r as truncateString, t as generateRandomID } from "./basics-CLwtIxap.cjs";
 
 //#region src/string/anagram.d.ts
 /**

package/dist/index.d.mts

@@ -15,12 +15,12 @@
  */
 
 import { $n as NumberType, Bn as DecimalOptions, D as NumericDotKey, E as NestedPrimitiveKey, F as SanitizeOptions, I as SanitizedData, In as BnDigitResult, Ln as ConvertOptions, O as ObjectEntry, Q as FlattenPartial, Rn as ConvertedDecimal, Un as FrankFurterCurrency, V as BasicPrimitive, Xn as LocaleCode, Zn as LooseRomanNumeral, a as ConvertObjectOptions, ar as RomanCapital, c as DeepKeys, ci as Tuple, ct as Numeric, g as FlattenDotValue, ir as RangedNumbers, k as Objects, lt as OwnKeys, nr as RandomNumberOptions, nt as Maybe, o as ConvertedObject, p as ExpandAll, pi as Unit, rr as RangeOptions, s as CountryDetails, tr as PercentageOptions, u as DotNotationKey, ut as PartialOrRequired, v as FlattenLeafValue, w as MergeAll, y as GenericObject, z as Any, zn as CurrencyCode } from "./object-DyVg8BFt.mjs";
-import { T as DiffResult, f as AnagramOptions, g as CharDiffResult, j as MaskOptions } from "./string-GQsmDdYa.mjs";
-import { n as convertStringCase, t as capitalizeString } from "./case-CcoD-jFV.mjs";
-import { i as parseQueryStringLiteral, r as parseQueryString, t as generateQueryParams } from "./query-Bi_ofCBp.mjs";
+import { D as DiffResult, P as MaskOptions, _ as CharDiffResult, p as AnagramOptions } from "./string-edtZyJHf.mjs";
+import { n as convertStringCase, t as capitalizeString } from "./case-Ce8HJI8I.mjs";
+import { i as parseQueryStringLiteral, r as parseQueryString, t as generateQueryParams } from "./query-C-r5ZbO-.mjs";
 import { c as OrderOption, l as SortByOption, n as FindOptions, s as OptionsConfig, t as FieldValue, u as SortNature } from "./array-CbAKXvhH.mjs";
 import { C as shuffleArray, S as isInvalidOrEmptyArray, _ as findPrimeNumbers, a as deepParsePrimitives, b as flattenArray, c as getInstanceGetterNames, d as getStaticMethodNames, f as isDeepEqual, g as throttleAction, h as stripJsonEdgeGarbage, i as debounceAction, l as getInstanceMethodNames, m as stableStringify, n as countInstanceMethods, o as definePrototypeMethod, p as parseJSON, r as countStaticMethods, s as getClassDetails, t as convertArrayToString, u as getStaticGetterNames, v as isPrime, x as getLastArrayElement, y as filterArrayOfObjects } from "./index-BbBnKdBb.mjs";
-import { n as trimString, r as truncateString, t as generateRandomID } from "./basics-DY7AX7D4.mjs";
+import { n as trimString, r as truncateString, t as generateRandomID } from "./basics-BuHQJCNG.mjs";
 
 //#region src/string/anagram.d.ts
 /**

package/dist/index.mjs

@@ -273,10 +273,8 @@ function computeTextDiff(originalText, modifiedText) {
 				usedIndices.add(idx);
 			}
 		} else if (line.type !== "added" || !usedIndices.has(idx)) {
-			if (line.type !== "added" || !usedIndices.has(idx)) {
-				processedLines.push(line);
-				usedIndices.add(idx);
-			}
+			processedLines.push(line);
+			usedIndices.add(idx);
 		}
 	}
 	let linesAdded = 0;

package/dist/{query-BLsaWi3q.d.cts → query-BMtRmMSC.d.cts}

@@ -15,7 +15,7 @@
  */
 
 import { M as ParsedQueryGeneric, N as QueryObject, j as ParsedQuery } from "./object-DyVg8BFt.cjs";
-import { F as QueryString } from "./string-EMT7czsU.cjs";
+import { R as QueryString } from "./string-Ok_IMpHP.cjs";
 
 //#region src/dom/query.d.ts
 /**

package/dist/{query-Bi_ofCBp.d.mts → query-C-r5ZbO-.d.mts}

@@ -15,7 +15,7 @@
  */
 
 import { M as ParsedQueryGeneric, N as QueryObject, j as ParsedQuery } from "./object-DyVg8BFt.mjs";
-import { F as QueryString } from "./string-GQsmDdYa.mjs";
+import { R as QueryString } from "./string-edtZyJHf.mjs";
 
 //#region src/dom/query.d.ts
 /**

package/dist/{string-EMT7czsU.d.cts → string-Ok_IMpHP.d.cts}

@@ -221,36 +221,57 @@ type IsAlphabet<T extends string> = T extends `${infer Head}${infer Tail}` ? Hea
 type Alphabet<T extends string> = IsAlphabet<T> extends true ? T : never;
 /** Types related to string diffing and similarity calculations. */
 type DiffLineType = 'added' | 'removed' | 'unchanged' | 'modified';
-/** A single line difference between two strings, including the type of difference and the content of the line in both original and modified strings. */
-interface DiffLine {
-  /** The type of difference: 'added', 'removed', 'unchanged', or 'modified'. */
-  type: DiffLineType;
-  /** The content of the original line. Undefined for added lines. */
-  original?: string;
-  /** The content of the modified line. Undefined for removed lines. */
-  modified?: string;
-  /** The line number in the original string (1-based). Undefined for added lines. */
-  originalLineNum?: number;
-  /** The line number in the modified string (1-based). Undefined for removed lines. */
-  modifiedLineNum?: number;
+/** Represents a single line's diff status between two strings, including the type of difference and the content of the line in both original and modified strings. */
+type DiffLine = UnchangedOrModifiedDiffLine | AddedDiffLine | RemovedDiffLine;
+/** Represents the details of a single line in the diff, including its content and line number. */
+interface DiffLineDetails {
+  /** The content of the original line, omitted for `added` lines. */
+  original: string;
+  /** The content of the modified line, omitted for `removed` lines. */
+  modified: string;
+  /** The line number in the original string (1-based), omitted for `added` lines. */
+  originalLineNum: number;
+  /** The line number in the modified string (1-based), omitted for `removed` lines. */
+  modifiedLineNum: number;
+}
+/** Represents an unchanged or modified line, including both original and modified content and their respective line numbers. */
+interface UnchangedOrModifiedDiffLine extends DiffLineDetails {
+  /** The type of difference, either `'unchanged'` or `'modified'`. */
+  type: 'unchanged' | 'modified';
+}
+/** Represents an added line, including only its content and line number in the modified string. */
+interface AddedDiffLine extends Omit<DiffLineDetails, 'originalLineNum' | 'original'> {
+  /** The type of difference, fixed to `'added'`. */
+  type: 'added';
+}
+/** Represents a removed line, including only its content and line number in the original string. */
+interface RemovedDiffLine extends Omit<DiffLineDetails, 'modifiedLineNum' | 'modified'> {
+  /** The type of difference, fixed to `'removed'`. */
+  type: 'removed';
+}
+/** Statistics summarizing the diff results, including counts of added, removed, changed, and unchanged lines. */
+interface DiffStats {
+  /** Total number of lines that were added in the modified string compared to the original. */
+  linesAdded: number;
+  /** Total number of lines that were removed from the original string in the modified version. */
+  linesRemoved: number;
+  /** Total number of lines that were modified (changed content) between the original and modified strings. */
+  linesChanged: number;
+  /** Total number of lines that remained unchanged between the original and modified strings. */
+  linesUnchanged: number;
 }
 /** The result of a line-level diff operation, including an array of line differences and summary statistics. */
 interface DiffResult {
   /** An array of line differences, where each line is categorized as 'added', 'removed', 'unchanged', or 'modified'. */
   lines: DiffLine[];
   /** Statistics summarizing the diff results, including counts of added, removed, changed, and unchanged lines. */
-  stats: {
-    /** Total number of lines that were added in the modified string compared to the original. */linesAdded: number; /** Total number of lines that were removed from the original string in the modified version. */
-    linesRemoved: number; /** Total number of lines that were modified (changed content) between the original and modified strings. */
-    linesChanged: number; /** Total number of lines that remained unchanged between the original and modified strings. */
-    linesUnchanged: number;
-  };
+  stats: DiffStats;
 }
 /** A single character annotated with a `highlighted` flag indicating whether it differs from the other string in a diff operation. */
 interface HighlightedText {
-  /** Character text. */
+  /** The text content of the character. */
   text: string;
-  /** Whether the character is different from the other string. */
+  /** Whether the character is different from the other string in a diff operation. */
   highlighted: boolean;
 }
 /** Result of a character-level diff, mapping each character in both strings to a `highlighted` flag. */
@@ -261,4 +282,4 @@ interface CharDiffResult {
   modified: HighlightedText[];
 }
 //#endregion
-export { KebabCase as A, StringCaseOptions as B, DiffLine as C, HighlightedText as D, DotCase as E, QueryString as F, TrainCase as H, RandomIdOptions as I, SentenceCase as L, PascalCase as M, PascalSnakeCase as N, Includes as O, PathCase as P, SnakeCase as R, CountryShortISO as S, DiffResult as T, Trim as U, TitleCase as V, ConstantCase as _, $NormalizeString as a, CountryISO as b, $TrimRight as c, Alphabet as d, AnagramOptions as f, CharDiffResult as g, CaseFormat as h, $LowercaseWords as i, MaskOptions as j, IsAlphabet as k, $UppercaseWords as l, CapitalizeOptions as m, $EnsureString as n, $TitleCaseWords as o, CamelCase as p, $LowerCaseWord as r, $TrimLeft as s, $CapitalizeWords as t, $WidenEmpty as u, Country as v, DiffLineType as w, CountryName as x, CountryCode as y, SpecialCharacter as z };
+export { HighlightedText as A, RemovedDiffLine as B, CountryShortISO as C, DiffResult as D, DiffLineType as E, PascalCase as F, TitleCase as G, SnakeCase as H, PascalSnakeCase as I, UnchangedOrModifiedDiffLine as J, TrainCase as K, PathCase as L, IsAlphabet as M, KebabCase as N, DiffStats as O, MaskOptions as P, QueryString as R, CountryName as S, DiffLineDetails as T, SpecialCharacter as U, SentenceCase as V, StringCaseOptions as W, CharDiffResult as _, $NormalizeString as a, CountryCode as b, $TrimRight as c, AddedDiffLine as d, Alphabet as f, CaseFormat as g, CapitalizeOptions as h, $LowercaseWords as i, Includes as j, DotCase as k, $UppercaseWords as l, CamelCase as m, $EnsureString as n, $TitleCaseWords as o, AnagramOptions as p, Trim as q, $LowerCaseWord as r, $TrimLeft as s, $CapitalizeWords as t, $WidenEmpty as u, ConstantCase as v, DiffLine as w, CountryISO as x, Country as y, RandomIdOptions as z };

package/dist/{string-GQsmDdYa.d.mts → string-edtZyJHf.d.mts}

@@ -221,36 +221,57 @@ type IsAlphabet<T extends string> = T extends `${infer Head}${infer Tail}` ? Hea
 type Alphabet<T extends string> = IsAlphabet<T> extends true ? T : never;
 /** Types related to string diffing and similarity calculations. */
 type DiffLineType = 'added' | 'removed' | 'unchanged' | 'modified';
-/** A single line difference between two strings, including the type of difference and the content of the line in both original and modified strings. */
-interface DiffLine {
-  /** The type of difference: 'added', 'removed', 'unchanged', or 'modified'. */
-  type: DiffLineType;
-  /** The content of the original line. Undefined for added lines. */
-  original?: string;
-  /** The content of the modified line. Undefined for removed lines. */
-  modified?: string;
-  /** The line number in the original string (1-based). Undefined for added lines. */
-  originalLineNum?: number;
-  /** The line number in the modified string (1-based). Undefined for removed lines. */
-  modifiedLineNum?: number;
+/** Represents a single line's diff status between two strings, including the type of difference and the content of the line in both original and modified strings. */
+type DiffLine = UnchangedOrModifiedDiffLine | AddedDiffLine | RemovedDiffLine;
+/** Represents the details of a single line in the diff, including its content and line number. */
+interface DiffLineDetails {
+  /** The content of the original line, omitted for `added` lines. */
+  original: string;
+  /** The content of the modified line, omitted for `removed` lines. */
+  modified: string;
+  /** The line number in the original string (1-based), omitted for `added` lines. */
+  originalLineNum: number;
+  /** The line number in the modified string (1-based), omitted for `removed` lines. */
+  modifiedLineNum: number;
+}
+/** Represents an unchanged or modified line, including both original and modified content and their respective line numbers. */
+interface UnchangedOrModifiedDiffLine extends DiffLineDetails {
+  /** The type of difference, either `'unchanged'` or `'modified'`. */
+  type: 'unchanged' | 'modified';
+}
+/** Represents an added line, including only its content and line number in the modified string. */
+interface AddedDiffLine extends Omit<DiffLineDetails, 'originalLineNum' | 'original'> {
+  /** The type of difference, fixed to `'added'`. */
+  type: 'added';
+}
+/** Represents a removed line, including only its content and line number in the original string. */
+interface RemovedDiffLine extends Omit<DiffLineDetails, 'modifiedLineNum' | 'modified'> {
+  /** The type of difference, fixed to `'removed'`. */
+  type: 'removed';
+}
+/** Statistics summarizing the diff results, including counts of added, removed, changed, and unchanged lines. */
+interface DiffStats {
+  /** Total number of lines that were added in the modified string compared to the original. */
+  linesAdded: number;
+  /** Total number of lines that were removed from the original string in the modified version. */
+  linesRemoved: number;
+  /** Total number of lines that were modified (changed content) between the original and modified strings. */
+  linesChanged: number;
+  /** Total number of lines that remained unchanged between the original and modified strings. */
+  linesUnchanged: number;
 }
 /** The result of a line-level diff operation, including an array of line differences and summary statistics. */
 interface DiffResult {
   /** An array of line differences, where each line is categorized as 'added', 'removed', 'unchanged', or 'modified'. */
   lines: DiffLine[];
   /** Statistics summarizing the diff results, including counts of added, removed, changed, and unchanged lines. */
-  stats: {
-    /** Total number of lines that were added in the modified string compared to the original. */linesAdded: number; /** Total number of lines that were removed from the original string in the modified version. */
-    linesRemoved: number; /** Total number of lines that were modified (changed content) between the original and modified strings. */
-    linesChanged: number; /** Total number of lines that remained unchanged between the original and modified strings. */
-    linesUnchanged: number;
-  };
+  stats: DiffStats;
 }
 /** A single character annotated with a `highlighted` flag indicating whether it differs from the other string in a diff operation. */
 interface HighlightedText {
-  /** Character text. */
+  /** The text content of the character. */
   text: string;
-  /** Whether the character is different from the other string. */
+  /** Whether the character is different from the other string in a diff operation. */
   highlighted: boolean;
 }
 /** Result of a character-level diff, mapping each character in both strings to a `highlighted` flag. */
@@ -261,4 +282,4 @@ interface CharDiffResult {
   modified: HighlightedText[];
 }
 //#endregion
-export { KebabCase as A, StringCaseOptions as B, DiffLine as C, HighlightedText as D, DotCase as E, QueryString as F, TrainCase as H, RandomIdOptions as I, SentenceCase as L, PascalCase as M, PascalSnakeCase as N, Includes as O, PathCase as P, SnakeCase as R, CountryShortISO as S, DiffResult as T, Trim as U, TitleCase as V, ConstantCase as _, $NormalizeString as a, CountryISO as b, $TrimRight as c, Alphabet as d, AnagramOptions as f, CharDiffResult as g, CaseFormat as h, $LowercaseWords as i, MaskOptions as j, IsAlphabet as k, $UppercaseWords as l, CapitalizeOptions as m, $EnsureString as n, $TitleCaseWords as o, CamelCase as p, $LowerCaseWord as r, $TrimLeft as s, $CapitalizeWords as t, $WidenEmpty as u, Country as v, DiffLineType as w, CountryName as x, CountryCode as y, SpecialCharacter as z };
+export { HighlightedText as A, RemovedDiffLine as B, CountryShortISO as C, DiffResult as D, DiffLineType as E, PascalCase as F, TitleCase as G, SnakeCase as H, PascalSnakeCase as I, UnchangedOrModifiedDiffLine as J, TrainCase as K, PathCase as L, IsAlphabet as M, KebabCase as N, DiffStats as O, MaskOptions as P, QueryString as R, CountryName as S, DiffLineDetails as T, SpecialCharacter as U, SentenceCase as V, StringCaseOptions as W, CharDiffResult as _, $NormalizeString as a, CountryCode as b, $TrimRight as c, AddedDiffLine as d, Alphabet as f, CaseFormat as g, CapitalizeOptions as h, $LowercaseWords as i, Includes as j, DotCase as k, $UppercaseWords as l, CamelCase as m, $EnsureString as n, $TitleCaseWords as o, AnagramOptions as p, Trim as q, $LowerCaseWord as r, $TrimLeft as s, $CapitalizeWords as t, $WidenEmpty as u, ConstantCase as v, DiffLine as w, CountryISO as x, Country as y, RandomIdOptions as z };

package/dist/types/form.d.cts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { a as OriginFileObj, i as FormDataConfigs, n as FileError, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-DA-YShnM.cjs";
+import { a as OriginFileObj, i as FormDataConfigs, n as FileError, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-DhsFvo_D.cjs";
 export { CustomFile, FileError, FileUpload, FormDataConfigs, OriginFileObj, ParsedFormData, SerializedForm };

package/dist/types/form.d.mts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { a as OriginFileObj, i as FormDataConfigs, n as FileError, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-DIYoIS0E.mjs";
+import { a as OriginFileObj, i as FormDataConfigs, n as FileError, o as ParsedFormData, r as FileUpload, s as SerializedForm, t as CustomFile } from "../form-D_5I437n.mjs";
 export { CustomFile, FileError, FileUpload, FormDataConfigs, OriginFileObj, ParsedFormData, SerializedForm };

package/dist/types/string.d.cts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { A as KebabCase, B as StringCaseOptions, C as DiffLine, D as HighlightedText, E as DotCase, F as QueryString, H as TrainCase, I as RandomIdOptions, L as SentenceCase, M as PascalCase, N as PascalSnakeCase, O as Includes, P as PathCase, R as SnakeCase, S as CountryShortISO, T as DiffResult, U as Trim, V as TitleCase, _ as ConstantCase, a as $NormalizeString, b as CountryISO, c as $TrimRight, d as Alphabet, f as AnagramOptions, g as CharDiffResult, h as CaseFormat, i as $LowercaseWords, j as MaskOptions, k as IsAlphabet, l as $UppercaseWords, m as CapitalizeOptions, n as $EnsureString, o as $TitleCaseWords, p as CamelCase, r as $LowerCaseWord, s as $TrimLeft, t as $CapitalizeWords, u as $WidenEmpty, v as Country, w as DiffLineType, x as CountryName, y as CountryCode, z as SpecialCharacter } from "../string-EMT7czsU.cjs";
-export { $CapitalizeWords, $EnsureString, $LowerCaseWord, $LowercaseWords, $NormalizeString, $TitleCaseWords, $TrimLeft, $TrimRight, $UppercaseWords, $WidenEmpty, Alphabet, AnagramOptions, CamelCase, CapitalizeOptions, CaseFormat, CharDiffResult, ConstantCase, Country, CountryCode, CountryISO, CountryName, CountryShortISO, DiffLine, DiffLineType, DiffResult, DotCase, HighlightedText, Includes, IsAlphabet, KebabCase, MaskOptions, PascalCase, PascalSnakeCase, PathCase, QueryString, RandomIdOptions, SentenceCase, SnakeCase, SpecialCharacter, StringCaseOptions, TitleCase, TrainCase, Trim };
+import { A as HighlightedText, B as RemovedDiffLine, C as CountryShortISO, D as DiffResult, E as DiffLineType, F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, J as UnchangedOrModifiedDiffLine, K as TrainCase, L as PathCase, M as IsAlphabet, N as KebabCase, O as DiffStats, P as MaskOptions, R as QueryString, S as CountryName, T as DiffLineDetails, U as SpecialCharacter, V as SentenceCase, W as StringCaseOptions, _ as CharDiffResult, a as $NormalizeString, b as CountryCode, c as $TrimRight, d as AddedDiffLine, f as Alphabet, g as CaseFormat, h as CapitalizeOptions, i as $LowercaseWords, j as Includes, k as DotCase, l as $UppercaseWords, m as CamelCase, n as $EnsureString, o as $TitleCaseWords, p as AnagramOptions, q as Trim, r as $LowerCaseWord, s as $TrimLeft, t as $CapitalizeWords, u as $WidenEmpty, v as ConstantCase, w as DiffLine, x as CountryISO, y as Country, z as RandomIdOptions } from "../string-Ok_IMpHP.cjs";
+export { $CapitalizeWords, $EnsureString, $LowerCaseWord, $LowercaseWords, $NormalizeString, $TitleCaseWords, $TrimLeft, $TrimRight, $UppercaseWords, $WidenEmpty, AddedDiffLine, Alphabet, AnagramOptions, CamelCase, CapitalizeOptions, CaseFormat, CharDiffResult, ConstantCase, Country, CountryCode, CountryISO, CountryName, CountryShortISO, DiffLine, DiffLineDetails, DiffLineType, DiffResult, DiffStats, DotCase, HighlightedText, Includes, IsAlphabet, KebabCase, MaskOptions, PascalCase, PascalSnakeCase, PathCase, QueryString, RandomIdOptions, RemovedDiffLine, SentenceCase, SnakeCase, SpecialCharacter, StringCaseOptions, TitleCase, TrainCase, Trim, UnchangedOrModifiedDiffLine };

package/dist/types/string.d.mts

@@ -14,5 +14,5 @@
  * limitations under the License.
  */
 
-import { A as KebabCase, B as StringCaseOptions, C as DiffLine, D as HighlightedText, E as DotCase, F as QueryString, H as TrainCase, I as RandomIdOptions, L as SentenceCase, M as PascalCase, N as PascalSnakeCase, O as Includes, P as PathCase, R as SnakeCase, S as CountryShortISO, T as DiffResult, U as Trim, V as TitleCase, _ as ConstantCase, a as $NormalizeString, b as CountryISO, c as $TrimRight, d as Alphabet, f as AnagramOptions, g as CharDiffResult, h as CaseFormat, i as $LowercaseWords, j as MaskOptions, k as IsAlphabet, l as $UppercaseWords, m as CapitalizeOptions, n as $EnsureString, o as $TitleCaseWords, p as CamelCase, r as $LowerCaseWord, s as $TrimLeft, t as $CapitalizeWords, u as $WidenEmpty, v as Country, w as DiffLineType, x as CountryName, y as CountryCode, z as SpecialCharacter } from "../string-GQsmDdYa.mjs";
-export { $CapitalizeWords, $EnsureString, $LowerCaseWord, $LowercaseWords, $NormalizeString, $TitleCaseWords, $TrimLeft, $TrimRight, $UppercaseWords, $WidenEmpty, Alphabet, AnagramOptions, CamelCase, CapitalizeOptions, CaseFormat, CharDiffResult, ConstantCase, Country, CountryCode, CountryISO, CountryName, CountryShortISO, DiffLine, DiffLineType, DiffResult, DotCase, HighlightedText, Includes, IsAlphabet, KebabCase, MaskOptions, PascalCase, PascalSnakeCase, PathCase, QueryString, RandomIdOptions, SentenceCase, SnakeCase, SpecialCharacter, StringCaseOptions, TitleCase, TrainCase, Trim };
+import { A as HighlightedText, B as RemovedDiffLine, C as CountryShortISO, D as DiffResult, E as DiffLineType, F as PascalCase, G as TitleCase, H as SnakeCase, I as PascalSnakeCase, J as UnchangedOrModifiedDiffLine, K as TrainCase, L as PathCase, M as IsAlphabet, N as KebabCase, O as DiffStats, P as MaskOptions, R as QueryString, S as CountryName, T as DiffLineDetails, U as SpecialCharacter, V as SentenceCase, W as StringCaseOptions, _ as CharDiffResult, a as $NormalizeString, b as CountryCode, c as $TrimRight, d as AddedDiffLine, f as Alphabet, g as CaseFormat, h as CapitalizeOptions, i as $LowercaseWords, j as Includes, k as DotCase, l as $UppercaseWords, m as CamelCase, n as $EnsureString, o as $TitleCaseWords, p as AnagramOptions, q as Trim, r as $LowerCaseWord, s as $TrimLeft, t as $CapitalizeWords, u as $WidenEmpty, v as ConstantCase, w as DiffLine, x as CountryISO, y as Country, z as RandomIdOptions } from "../string-edtZyJHf.mjs";
+export { $CapitalizeWords, $EnsureString, $LowerCaseWord, $LowercaseWords, $NormalizeString, $TitleCaseWords, $TrimLeft, $TrimRight, $UppercaseWords, $WidenEmpty, AddedDiffLine, Alphabet, AnagramOptions, CamelCase, CapitalizeOptions, CaseFormat, CharDiffResult, ConstantCase, Country, CountryCode, CountryISO, CountryName, CountryShortISO, DiffLine, DiffLineDetails, DiffLineType, DiffResult, DiffStats, DotCase, HighlightedText, Includes, IsAlphabet, KebabCase, MaskOptions, PascalCase, PascalSnakeCase, PathCase, QueryString, RandomIdOptions, RemovedDiffLine, SentenceCase, SnakeCase, SpecialCharacter, StringCaseOptions, TitleCase, TrainCase, Trim, UnchangedOrModifiedDiffLine };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolbox-x",
-  "version": "2.4.1",
+  "version": "2.4.2",
   "description": "A versatile collection of smart, efficient, and reusable utility functions, classes and types for everyday development needs.",
   "main": "./dist/index.cjs",
   "type": "module",