@pithos/core 2.0.0

package/dist/arkhe/is/predicate/is-equal.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Performs a deep comparison between two values to determine if they are equivalent.
+ *
+ * @param value - The value to compare.
+ * @param other - The other value to compare.
+ * @returns `true` if the values are equivalent, else `false`.
+ * @since 2.0.0
+ *
+ * @note Supports Date, RegExp, Map, Set, arrays, and plain objects. Uses SameValueZero (NaN === NaN). Handles circular references.
+ *
+ * @performance O(n) where n is the total number of properties/elements to compare.
+ * O(n²) for Sets containing objects (due to deep matching).
+ *
+ * @example
+ * ```typescript
+ * // Primitives
+ * isEqual(1, 1);                                  // => true
+ * isEqual('hello', 'hello');                      // => true
+ * isEqual(NaN, NaN);                              // => true
+ *
+ * // Objects and arrays
+ * isEqual({ a: 1 }, { a: 1 });                    // => true
+ * isEqual([1, 2, 3], [1, 2, 3]);                  // => true
+ * isEqual({ a: { b: 2 } }, { a: { b: 2 } });      // => true
+ *
+ * // Built-in types
+ * isEqual(new Date('2024-01-01'), new Date('2024-01-01')); // => true
+ * isEqual(/abc/gi, /abc/gi);                      // => true
+ * isEqual(new Map([['a', 1]]), new Map([['a', 1]])); // => true
+ * isEqual(new Set([1, 2]), new Set([1, 2]));     // => true
+ *
+ * // Different values
+ * isEqual({ a: 1 }, { a: 2 });                    // => false
+ * isEqual([1, 2], [1, 2, 3]);                     // => false
+ *
+ * // Different types
+ * isEqual([], {});                                // => false
+ * isEqual(new Date(), {});                        // => false
+ * ```
+ */
+export declare function isEqual(value: unknown, other: unknown): boolean;
+//# sourceMappingURL=is-equal.d.ts.map

package/dist/arkhe/is/predicate/is-equal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-equal.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/is/predicate/is-equal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAgB/D"}

package/dist/arkhe/is/predicate/is-equal.js

@@ -0,0 +1,150 @@
+/**
+ * Performs a deep comparison between two values to determine if they are equivalent.
+ *
+ * @param value - The value to compare.
+ * @param other - The other value to compare.
+ * @returns `true` if the values are equivalent, else `false`.
+ * @since 2.0.0
+ *
+ * @note Supports Date, RegExp, Map, Set, arrays, and plain objects. Uses SameValueZero (NaN === NaN). Handles circular references.
+ *
+ * @performance O(n) where n is the total number of properties/elements to compare.
+ * O(n²) for Sets containing objects (due to deep matching).
+ *
+ * @example
+ * ```typescript
+ * // Primitives
+ * isEqual(1, 1);                                  // => true
+ * isEqual('hello', 'hello');                      // => true
+ * isEqual(NaN, NaN);                              // => true
+ *
+ * // Objects and arrays
+ * isEqual({ a: 1 }, { a: 1 });                    // => true
+ * isEqual([1, 2, 3], [1, 2, 3]);                  // => true
+ * isEqual({ a: { b: 2 } }, { a: { b: 2 } });      // => true
+ *
+ * // Built-in types
+ * isEqual(new Date('2024-01-01'), new Date('2024-01-01')); // => true
+ * isEqual(/abc/gi, /abc/gi);                      // => true
+ * isEqual(new Map([['a', 1]]), new Map([['a', 1]])); // => true
+ * isEqual(new Set([1, 2]), new Set([1, 2]));     // => true
+ *
+ * // Different values
+ * isEqual({ a: 1 }, { a: 2 });                    // => false
+ * isEqual([1, 2], [1, 2, 3]);                     // => false
+ *
+ * // Different types
+ * isEqual([], {});                                // => false
+ * isEqual(new Date(), {});                        // => false
+ * ```
+ */
+export function isEqual(value, other) {
+    if (Object.is(value, other))
+        return true;
+    // Stryker disable next-line ConditionalExpression,LogicalOperator,BlockStatement: Early return optimization — isEqualDeep has identical guard for non-object/null values
+    if (
+    // Stryker disable next-line ConditionalExpression,LogicalOperator: Early return optimization — isEqualDeep has identical guard
+    typeof value !== "object" ||
+        // Stryker disable next-line ConditionalExpression,LogicalOperator: Early return optimization — isEqualDeep has identical guard
+        typeof other !== "object" ||
+        // Stryker disable next-line ConditionalExpression,LogicalOperator: Early return optimization — isEqualDeep has identical guard
+        value === null ||
+        // Stryker disable next-line ConditionalExpression: Early return optimization — isEqualDeep has identical guard
+        other === null) /* Stryker disable next-line BlockStatement: Early return optimization — isEqualDeep has identical guard */ {
+        return false;
+    }
+    return isEqualDeep(value, other, new Map());
+}
+/**
+ * Internal recursive comparison with circular reference tracking.
+ */
+function isEqualDeep(value, other, seen) {
+    if (Object.is(value, other)) {
+        return true;
+    }
+    if (value === null ||
+        other === null ||
+        // Stryker disable next-line ConditionalExpression: Optimization - constructor check handles primitives
+        typeof value !== "object" ||
+        // Stryker disable next-line ConditionalExpression: Optimization - constructor check handles primitives via auto-boxing
+        typeof other !== "object") {
+        return false;
+    }
+    if (value.constructor !== other.constructor) {
+        return false;
+    }
+    if (seen.has(value)) {
+        return seen.get(value) === other;
+    }
+    seen.set(value, other);
+    if (value instanceof Date) {
+        return value.getTime() === other.getTime();
+    }
+    if (value instanceof RegExp) {
+        const otherRegExp = other;
+        return (value.source === otherRegExp.source && value.flags === otherRegExp.flags);
+    }
+    if (value instanceof Map) {
+        const otherMap = other;
+        if (value.size !== otherMap.size) {
+            return false;
+        }
+        for (const [key, val] of value) {
+            if (!otherMap.has(key) || !isEqualDeep(val, otherMap.get(key), seen)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    if (value instanceof Set) {
+        const otherSet = other;
+        if (value.size !== otherSet.size) {
+            return false;
+        }
+        const matchedIndices = new Set();
+        for (const item of value) {
+            let found = false;
+            let index = 0;
+            for (const otherItem of otherSet) {
+                if (!matchedIndices.has(index) && isEqualDeep(item, otherItem, seen)) {
+                    matchedIndices.add(index);
+                    found = true;
+                    break;
+                }
+                // Stryker disable next-line UpdateOperator: Index direction irrelevant - uniqueness of indices is preserved
+                index++;
+            }
+            if (!found) {
+                return false;
+            }
+        }
+        return true;
+    }
+    // Stryker disable next-line ConditionalExpression,BlockStatement: Optimization - object comparison handles arrays
+    if (Array.isArray(value)) {
+        const otherArray = other;
+        if (value.length !== otherArray.length) {
+            return false;
+        }
+        // Stryker disable next-line EqualityOperator: Bounds check - accessing beyond length returns undefined which equals undefined
+        for (let i = 0; i < value.length; i++) {
+            if (!isEqualDeep(value[i], otherArray[i], seen)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    const valueKeys = Object.keys(value);
+    const otherKeys = Object.keys(other);
+    if (valueKeys.length !== otherKeys.length) {
+        return false;
+    }
+    for (const key of valueKeys) {
+        if (!Object.prototype.hasOwnProperty.call(other, key) ||
+            !isEqualDeep(value[key], other[key], seen)) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=is-equal.js.map

package/dist/arkhe/is/predicate/is-equal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-equal.js","sourceRoot":"","sources":["../../../../src/arkhe/is/predicate/is-equal.ts"],"names":[],"mappings":"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"}

package/dist/arkhe/is/predicate/is-float.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Checks if a value is a float (finite number that is not an integer).
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a float, `false` otherwise.
+ * @since 2.0.0
+ *
+ * @note This checks for numbers that have a decimal part.
+ *
+ * @example
+ * ```typescript
+ * isFloat(1.5);       // => true
+ * isFloat(1.0);       // => false
+ * isFloat(1);         // => false
+ * isFloat(Infinity);  // => false
+ * isFloat('1.5');     // => false
+ * ```
+ */
+export declare const isFloat: (value: unknown) => boolean;
+//# sourceMappingURL=is-float.d.ts.map

package/dist/arkhe/is/predicate/is-float.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-float.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/is/predicate/is-float.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,OAAO,GAAI,OAAO,OAAO,KAAG,OAIb,CAAC"}

package/dist/arkhe/is/predicate/is-float.js

@@ -0,0 +1,24 @@
+/**
+ * Checks if a value is a float (finite number that is not an integer).
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a float, `false` otherwise.
+ * @since 2.0.0
+ *
+ * @note This checks for numbers that have a decimal part.
+ *
+ * @example
+ * ```typescript
+ * isFloat(1.5);       // => true
+ * isFloat(1.0);       // => false
+ * isFloat(1);         // => false
+ * isFloat(Infinity);  // => false
+ * isFloat('1.5');     // => false
+ * ```
+ */
+export const isFloat = (value) => 
+// Stryker disable next-line ConditionalExpression: equivalent mutant, Number.isFinite returns false for all non-numbers
+typeof value === "number" &&
+    Number.isFinite(value) &&
+    !Number.isInteger(value);
+//# sourceMappingURL=is-float.js.map

package/dist/arkhe/is/predicate/is-float.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-float.js","sourceRoot":"","sources":["../../../../src/arkhe/is/predicate/is-float.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,KAAc,EAAW,EAAE;AAC/C,wHAAwH;AACxH,OAAO,KAAK,KAAK,QAAQ;IACzB,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;IACtB,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC"}

package/dist/arkhe/number/clamp.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Clamps a value between min and max bounds.
+ *
+ * @param value - Value to clamp.
+ * @param min - Minimum bound (inclusive).
+ * @param max - Maximum bound (inclusive).
+ * @returns The clamped value.
+ * @throws {RangeError} If min is greater than max.
+ * @since 2.0.0
+ *
+ * @performance O(1)
+ *
+ * @example
+ * ```typescript
+ * clamp(5, 0, 10);  // => 5
+ * clamp(-5, 0, 10); // => 0
+ * clamp(15, 0, 10); // => 10
+ * ```
+ */
+export declare function clamp(value: number, min: number, max: number): number;
+//# sourceMappingURL=clamp.d.ts.map

package/dist/arkhe/number/clamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.d.ts","sourceRoot":"","sources":["../../../src/arkhe/number/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAGrE"}

package/dist/arkhe/number/clamp.js

@@ -0,0 +1,25 @@
+/**
+ * Clamps a value between min and max bounds.
+ *
+ * @param value - Value to clamp.
+ * @param min - Minimum bound (inclusive).
+ * @param max - Maximum bound (inclusive).
+ * @returns The clamped value.
+ * @throws {RangeError} If min is greater than max.
+ * @since 2.0.0
+ *
+ * @performance O(1)
+ *
+ * @example
+ * ```typescript
+ * clamp(5, 0, 10);  // => 5
+ * clamp(-5, 0, 10); // => 0
+ * clamp(15, 0, 10); // => 10
+ * ```
+ */
+export function clamp(value, min, max) {
+    if (min > max)
+        throw new RangeError("min must be <= max");
+    return Math.max(min, Math.min(max, value));
+}
+//# sourceMappingURL=clamp.js.map

package/dist/arkhe/number/clamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clamp.js","sourceRoot":"","sources":["../../../src/arkhe/number/clamp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IAC3D,IAAI,GAAG,GAAG,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,oBAAoB,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/arkhe/number/in-range.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Checks if a number is within a specified range.
+ *
+ * @param value - The number to check.
+ * @param min - Minimum bound (inclusive). If `max` omitted, becomes max with min defaulting to 0.
+ * @param max - Maximum bound (exclusive).
+ * @returns `true` if value is in range [min, max), else `false`.
+ * @since 2.0.0
+ *
+ * @note Returns `false` for empty ranges (min >= max) and NaN values.
+ *
+ * @performance O(1)
+ *
+ * @example
+ * ```typescript
+ * inRange(3, 0, 5);  // => true (3 is in [0, 5))
+ * inRange(5, 0, 5);  // => false (5 is exclusive)
+ * inRange(3, 5);     // => true (equivalent to inRange(3, 0, 5))
+ * inRange(0, 0, 0);  // => false (empty range)
+ * ```
+ */
+/** @internal */
+export declare function inRange(value: number, min: number, max: number): boolean;
+/** @internal */
+export declare function inRange(value: number, max: number): boolean;
+//# sourceMappingURL=in-range.d.ts.map

package/dist/arkhe/number/in-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-range.d.ts","sourceRoot":"","sources":["../../../src/arkhe/number/in-range.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,gBAAgB;AAChB,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;AAC1E,gBAAgB;AAChB,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC"}

package/dist/arkhe/number/in-range.js

@@ -0,0 +1,12 @@
+export function inRange(value, min, max) {
+    if (max === undefined) {
+        max = min;
+        min = 0;
+    }
+    // Stryker disable next-line all: equivalent mutant, when min===max the range check value>=min && value<max always returns false
+    if (min >= max) {
+        return false;
+    }
+    return value >= min && value < max;
+}
+//# sourceMappingURL=in-range.js.map

package/dist/arkhe/number/in-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-range.js","sourceRoot":"","sources":["../../../src/arkhe/number/in-range.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,OAAO,CAAC,KAAa,EAAE,GAAW,EAAE,GAAY;IAC9D,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,GAAG,GAAG,GAAG,CAAC;QACV,GAAG,GAAG,CAAC,CAAC;IACV,CAAC;IAED,gIAAgI;IAChI,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACf,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,KAAK,IAAI,GAAG,IAAI,KAAK,GAAG,GAAG,CAAC;AACrC,CAAC"}

package/dist/arkhe/number/parsers/parse-float-def.d.ts

@@ -0,0 +1,24 @@
+import { Nullish } from "../../types/common/nullish";
+/**
+ * Parses a string to a float with a fallback default value.
+ *
+ * @param value - The string value to parse (can be nullish or empty).
+ * @param defaultValue - The value to return if parsing fails.
+ * @returns The parsed float or default value.
+ * @since 1.0.0
+ *
+ * @note Returns default for null, undefined, empty strings, and invalid inputs.
+ *
+ * @see parseFloat
+ * @see parseIntDef
+ *
+ * @example
+ * ```typescript
+ * parseFloatDef('42.99', 0);   // => 42.99
+ * parseFloatDef('invalid', 0); // => 0
+ * parseFloatDef('', 10.5);     // => 10.5
+ * parseFloatDef(null, 1.0);    // => 1.0
+ * ```
+ */
+export declare function parseFloatDef(value: Nullish<string>, defaultValue: number): number;
+//# sourceMappingURL=parse-float-def.d.ts.map

package/dist/arkhe/number/parsers/parse-float-def.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-float-def.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/number/parsers/parse-float-def.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAGtD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EACtB,YAAY,EAAE,MAAM,GACnB,MAAM,CAIR"}

package/dist/arkhe/number/parsers/parse-float-def.js

@@ -0,0 +1,29 @@
+import { parseFloat } from "./parse-float";
+/**
+ * Parses a string to a float with a fallback default value.
+ *
+ * @param value - The string value to parse (can be nullish or empty).
+ * @param defaultValue - The value to return if parsing fails.
+ * @returns The parsed float or default value.
+ * @since 1.0.0
+ *
+ * @note Returns default for null, undefined, empty strings, and invalid inputs.
+ *
+ * @see parseFloat
+ * @see parseIntDef
+ *
+ * @example
+ * ```typescript
+ * parseFloatDef('42.99', 0);   // => 42.99
+ * parseFloatDef('invalid', 0); // => 0
+ * parseFloatDef('', 10.5);     // => 10.5
+ * parseFloatDef(null, 1.0);    // => 1.0
+ * ```
+ */
+export function parseFloatDef(value, defaultValue) {
+    // Stryker disable next-line ConditionalExpression: equivalent mutant, parseFloat returns defaultValue for NaN which includes empty/null
+    if (!value)
+        return defaultValue;
+    return parseFloat(value, defaultValue);
+}
+//# sourceMappingURL=parse-float-def.js.map

package/dist/arkhe/number/parsers/parse-float-def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-float-def.js","sourceRoot":"","sources":["../../../../src/arkhe/number/parsers/parse-float-def.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAsB,EACtB,YAAoB;IAEpB,wIAAwI;IACxI,IAAI,CAAC,KAAK;QAAE,OAAO,YAAY,CAAC;IAChC,OAAO,UAAU,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;AACzC,CAAC"}

package/dist/arkhe/number/parsers/parse-float.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Parses a string to a float, returning default if invalid.
+ *
+ * @param value - The string value to parse.
+ * @param defaultValue - The value to return if parsing fails.
+ * @returns The parsed float or default value.
+ * @since 2.0.0
+ *
+ * @note Returns default for NaN, Infinity, and invalid strings. Assumes non-nullish input.
+ *
+ * @see parseFloatDef
+ *
+ * @example
+ * ```typescript
+ * parseFloat('42.99', 0);    // => 42.99
+ * parseFloat('invalid', 0);  // => 0
+ * parseFloat('Infinity', 0); // => 0
+ * parseFloat('NaN', 100);    // => 100
+ * ```
+ */
+export declare function parseFloat(value: string, defaultValue: number): number;
+//# sourceMappingURL=parse-float.d.ts.map

package/dist/arkhe/number/parsers/parse-float.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-float.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/number/parsers/parse-float.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAGtE"}

package/dist/arkhe/number/parsers/parse-float.js

@@ -0,0 +1,25 @@
+/**
+ * Parses a string to a float, returning default if invalid.
+ *
+ * @param value - The string value to parse.
+ * @param defaultValue - The value to return if parsing fails.
+ * @returns The parsed float or default value.
+ * @since 2.0.0
+ *
+ * @note Returns default for NaN, Infinity, and invalid strings. Assumes non-nullish input.
+ *
+ * @see parseFloatDef
+ *
+ * @example
+ * ```typescript
+ * parseFloat('42.99', 0);    // => 42.99
+ * parseFloat('invalid', 0);  // => 0
+ * parseFloat('Infinity', 0); // => 0
+ * parseFloat('NaN', 100);    // => 100
+ * ```
+ */
+export function parseFloat(value, defaultValue) {
+    const parsed = Number.parseFloat(value);
+    return isNaN(parsed) || !isFinite(parsed) ? defaultValue : parsed;
+}
+//# sourceMappingURL=parse-float.js.map

package/dist/arkhe/number/parsers/parse-float.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-float.js","sourceRoot":"","sources":["../../../../src/arkhe/number/parsers/parse-float.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,YAAoB;IAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxC,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;AACpE,CAAC"}

package/dist/arkhe/number/parsers/parse-int-def.d.ts

@@ -0,0 +1,25 @@
+import { Nullish } from "../../types/common/nullish";
+/**
+ * Parses a string to an integer with a fallback default value.
+ *
+ * @param value - The string value to parse (can be nullish or empty).
+ * @param defaultValue - The value to return if parsing fails.
+ * @param radix - The radix (base 2-36) for parsing.
+ * @returns The parsed integer or default value.
+ * @since 1.0.0
+ *
+ * @note Returns default for null, undefined, empty strings, and NaN results.
+ *
+ * @see parseFloatDef
+ *
+ * @example
+ * ```typescript
+ * parseIntDef('42');            // => 42
+ * parseIntDef('invalid');       // => null
+ * parseIntDef('invalid', 0);    // => 0
+ * parseIntDef('1010', null, 2); // => 10 (binary)
+ * parseIntDef('FF', null, 16);  // => 255 (hex)
+ * ```
+ */
+export declare function parseIntDef(value: Nullish<string>, defaultValue?: Nullish<number>, radix?: number): number | null;
+//# sourceMappingURL=parse-int-def.d.ts.map

package/dist/arkhe/number/parsers/parse-int-def.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-int-def.d.ts","sourceRoot":"","sources":["../../../../src/arkhe/number/parsers/parse-int-def.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EACtB,YAAY,GAAE,OAAO,CAAC,MAAM,CAAQ,EACpC,KAAK,CAAC,EAAE,MAAM,GACb,MAAM,GAAG,IAAI,CAKf"}

package/dist/arkhe/number/parsers/parse-int-def.js

@@ -0,0 +1,30 @@
+/**
+ * Parses a string to an integer with a fallback default value.
+ *
+ * @param value - The string value to parse (can be nullish or empty).
+ * @param defaultValue - The value to return if parsing fails.
+ * @param radix - The radix (base 2-36) for parsing.
+ * @returns The parsed integer or default value.
+ * @since 1.0.0
+ *
+ * @note Returns default for null, undefined, empty strings, and NaN results.
+ *
+ * @see parseFloatDef
+ *
+ * @example
+ * ```typescript
+ * parseIntDef('42');            // => 42
+ * parseIntDef('invalid');       // => null
+ * parseIntDef('invalid', 0);    // => 0
+ * parseIntDef('1010', null, 2); // => 10 (binary)
+ * parseIntDef('FF', null, 16);  // => 255 (hex)
+ * ```
+ */
+export function parseIntDef(value, defaultValue = null, radix) {
+    // Stryker disable next-line ConditionalExpression: equivalent mutant, parseInt returns NaN for empty/null which triggers defaultValue
+    if (!value)
+        return defaultValue;
+    const parsed = parseInt(value, radix);
+    return isNaN(parsed) ? defaultValue : parsed;
+}
+//# sourceMappingURL=parse-int-def.js.map

package/dist/arkhe/number/parsers/parse-int-def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-int-def.js","sourceRoot":"","sources":["../../../../src/arkhe/number/parsers/parse-int-def.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,WAAW,CACzB,KAAsB,EACtB,eAAgC,IAAI,EACpC,KAAc;IAEd,sIAAsI;IACtI,IAAI,CAAC,KAAK;QAAE,OAAO,YAAY,CAAC;IAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;AAC/C,CAAC"}

package/dist/arkhe/number/random.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Generates a random number within the specified range.
+ *
+ * @param min - Minimum bound (inclusive). If `max` omitted, becomes max with min defaulting to 0.
+ * @param max - Maximum bound (exclusive).
+ * @returns A random number in range [min, max).
+ * @since 2.0.0
+ *
+ * @note Returns `min` if min === max. Swaps bounds automatically if min > max.
+ * @note Impure function (uses Math.random()).
+ *
+ * @performance O(1)
+ *
+ * @example
+ * ```typescript
+ * random(0, 10); // => 7.234... (random in [0, 10))
+ * random(10);    // => 3.456... (random in [0, 10))
+ * random(5, 5);  // => 5 (min equals max)
+ * random(10, 5); // => 7.123... (bounds swapped)
+ * ```
+ */
+/** @internal */
+export declare function random(min: number, max: number): number;
+/** @internal */
+export declare function random(max: number): number;
+//# sourceMappingURL=random.d.ts.map

package/dist/arkhe/number/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../../src/arkhe/number/random.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,gBAAgB;AAChB,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;AACzD,gBAAgB;AAChB,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC"}

package/dist/arkhe/number/random.js

@@ -0,0 +1,15 @@
+export function random(min, max) {
+    if (max === undefined) {
+        max = min;
+        min = 0;
+    }
+    if (min === max) {
+        return min;
+    }
+    // Stryker disable next-line all: equivalent mutant, Math.random()*(max-min)+min produces same result with swapped bounds
+    if (min > max) {
+        [min, max] = [max, min];
+    }
+    return Math.random() * (max - min) + min;
+}
+//# sourceMappingURL=random.js.map

package/dist/arkhe/number/random.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.js","sourceRoot":"","sources":["../../../src/arkhe/number/random.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,MAAM,CAAC,GAAW,EAAE,GAAY;IAC9C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,GAAG,GAAG,GAAG,CAAC;QACV,GAAG,GAAG,CAAC,CAAC;IACV,CAAC;IAED,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,yHAAyH;IACzH,IAAI,GAAG,GAAG,GAAG,EAAE,CAAC;QACd,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC3C,CAAC"}

package/dist/arkhe/number/to-number.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Converts any value to a number with fallback handling.
+ *
+ * @param value - The value to convert.
+ * @param defaultValue - Default value if conversion fails.
+ * @returns A number representation of the value.
+ * @since 2.0.0
+ *
+ * @note Booleans convert to 1/0. Null/undefined/Symbol return default. NaN returns default.
+ * @note BigInt values are converted to number (may lose precision for large values).
+ *
+ * @performance O(1)
+ *
+ * @example
+ * ```typescript
+ * toNumber('42');          // => 42
+ * toNumber('3.14');        // => 3.14
+ * toNumber('invalid');     // => 0 (default)
+ * toNumber(true);          // => 1
+ * toNumber(false);         // => 0
+ * toNumber(null);          // => 0 (default)
+ * toNumber('invalid', 10); // => 10 (custom default)
+ * toNumber(10n);           // => 10 (BigInt)
+ * ```
+ */
+export declare function toNumber(value: unknown, defaultValue?: number): number;
+//# sourceMappingURL=to-number.d.ts.map

package/dist/arkhe/number/to-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-number.d.ts","sourceRoot":"","sources":["../../../src/arkhe/number/to-number.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,YAAY,SAAI,GAAG,MAAM,CAQjE"}