@develia/commons 0.5.0 → 0.6.1

package/dist/parse.d.ts

@@ -1,5 +1,5 @@
 /**
- * Options for {@link parseBoolean}.
+ * Options for {@link tryParseBoolean} and {@link parseBoolean}.
  */
 export interface ParseBooleanOptions {
     /**
@@ -16,7 +16,7 @@ export interface ParseBooleanOptions {
     extraFalsy?: string[];
 }
 /**
- * Options for {@link parseInteger}.
+ * Options for {@link tryParseInteger} and {@link parseInteger}.
  */
 export interface ParseIntegerOptions {
     /**
@@ -32,7 +32,7 @@ export interface ParseIntegerOptions {
     thousandsSeparator?: string;
 }
 /**
- * Options for {@link parseDecimal}.
+ * Options for {@link tryParseDecimal} and {@link parseDecimal}.
  */
 export interface ParseDecimalOptions {
     /**
@@ -49,34 +49,40 @@ export interface ParseDecimalOptions {
 }
 /**
  * Safely parses a value into an integer.
- * Returns `null` if the value cannot be parsed.
+ * Returns `undefined` if the value cannot be parsed.
  *
- * - `null` or `undefined` → `null`
+ * - `null` or `undefined` → `undefined`
  * - `number` → returned as-is (floats are truncated)
  * - `string` → parsed with the given options
  *
  * @param value - The value to parse.
  * @param options - Optional parsing configuration.
- * @returns The parsed integer, or `null` on failure.
+ * @returns The parsed integer, or `undefined` on failure.
  *
  * @example
  * ```ts
- * parseInteger(42)                                        // 42
- * parseInteger(3.7)                                       // 3
- * parseInteger(null)                                      // null
- * parseInteger(undefined)                                 // null
- * parseInteger("42")                                      // 42
- * parseInteger("1.234.567", { thousandsSeparator: "." })  // 1234567
- * parseInteger("FF", { radix: 16 })                       // 255
- * parseInteger("abc")                                     // null
+ * tryParseInteger(42)                                        // 42
+ * tryParseInteger(3.7)                                       // 3
+ * tryParseInteger(null)                                      // undefined
+ * tryParseInteger(undefined)                                 // undefined
+ * tryParseInteger("42")                                      // 42
+ * tryParseInteger("1.234.567", { thousandsSeparator: "." })  // 1234567
+ * tryParseInteger("FF", { radix: 16 })                       // 255
+ * tryParseInteger("abc")                                     // undefined
  * ```
  */
-export declare function parseInteger(value: string | number | null | undefined, options?: ParseIntegerOptions): number | null;
+export declare function tryParseInteger(value: string | number | null | undefined, options?: ParseIntegerOptions): number | undefined;
+/**
+ * Parses a value into an integer as {@link tryParseInteger} does.
+ *
+ * @throws {SyntaxError} If the value cannot be parsed.
+ */
+export declare function parseInteger(value: string | number, options?: ParseIntegerOptions): number;
 /**
  * Safely parses a value into a floating-point number.
- * Returns `null` if the value cannot be parsed.
+ * Returns `undefined` if the value cannot be parsed.
  *
- * - `null` or `undefined` → `null`
+ * - `null` or `undefined` → `undefined`
  * - `number` → returned as-is (if finite)
  * - `string` → parsed with the given options
  *
@@ -85,25 +91,31 @@ export declare function parseInteger(value: string | number | null | undefined,
  *
  * @param value - The value to parse.
  * @param options - Optional parsing configuration.
- * @returns The parsed float, or `null` on failure.
+ * @returns The parsed float, or `undefined` on failure.
  *
  * @example
  * ```ts
- * parseDecimal(3.14)                                                       // 3.14
- * parseDecimal(null)                                                       // null
- * parseDecimal(undefined)                                                  // null
- * parseDecimal("3.14")                                                     // 3.14
- * parseDecimal("3,14", { decimalSeparator: "," })                          // 3.14
- * parseDecimal("1.234,56", { decimalSeparator: ",", thousandsSeparator: "." }) // 1234.56
- * parseDecimal("abc")                                                      // null
+ * tryParseDecimal(3.14)                                                       // 3.14
+ * tryParseDecimal(null)                                                       // undefined
+ * tryParseDecimal(undefined)                                                  // undefined
+ * tryParseDecimal("3.14")                                                     // 3.14
+ * tryParseDecimal("3,14", { decimalSeparator: "," })                          // 3.14
+ * tryParseDecimal("1.234,56", { decimalSeparator: ",", thousandsSeparator: "." }) // 1234.56
+ * tryParseDecimal("abc")                                                      // undefined
  * ```
  */
-export declare function parseDecimal(value: string | number | null | undefined, options?: ParseDecimalOptions): number | null;
+export declare function tryParseDecimal(value: string | number | null | undefined, options?: ParseDecimalOptions): number | undefined;
+/**
+ * Parses a value into a decimal number as {@link tryParseDecimal} does.
+ *
+ * @throws {SyntaxError} If the value cannot be parsed.
+ */
+export declare function parseDecimal(value: string | number, options?: ParseDecimalOptions): number;
 /**
  * Safely parses a value into a boolean.
- * Returns `null` if the value cannot be interpreted as boolean.
+ * Returns `undefined` if the value cannot be interpreted as boolean.
  *
- * - `null` or `undefined` → `null`
+ * - `null` or `undefined` → `undefined`
  * - `boolean` → returned as-is
  * - `number` → `0` is `false`, any other finite number is `true`
  * - `string` → matched case-insensitively against known truthy/falsy values
@@ -113,25 +125,31 @@ export declare function parseDecimal(value: string | number | null | undefined,
  *
  * @param value - The value to parse.
  * @param options - Optional parsing configuration.
- * @returns The parsed boolean, or `null` on failure.
+ * @returns The parsed boolean, or `undefined` on failure.
  *
  * @example
  * ```ts
- * parseBoolean(true)                                    // true
- * parseBoolean(false)                                   // false
- * parseBoolean(1)                                       // true
- * parseBoolean(0)                                       // false
- * parseBoolean(null)                                    // null
- * parseBoolean(undefined)                               // null
- * parseBoolean("yes")                                   // true
- * parseBoolean("no")                                    // false
- * parseBoolean("sí")                                    // true
- * parseBoolean("TRUE")                                  // true
- * parseBoolean("oui")                                   // null
- * parseBoolean("oui", { extraTruthy: ["oui"] })         // true
- * parseBoolean("nein", { extraFalsy: ["nein"] })        // false
- * parseBoolean("whatever")                              // null
+ * tryParseBoolean(true)                                    // true
+ * tryParseBoolean(false)                                   // false
+ * tryParseBoolean(1)                                       // true
+ * tryParseBoolean(0)                                       // false
+ * tryParseBoolean(null)                                    // undefined
+ * tryParseBoolean(undefined)                               // undefined
+ * tryParseBoolean("yes")                                   // true
+ * tryParseBoolean("no")                                    // false
+ * tryParseBoolean("sí")                                    // true
+ * tryParseBoolean("TRUE")                                  // true
+ * tryParseBoolean("oui")                                   // undefined
+ * tryParseBoolean("oui", { extraTruthy: ["oui"] })         // true
+ * tryParseBoolean("nein", { extraFalsy: ["nein"] })        // false
+ * tryParseBoolean("whatever")                              // undefined
  * ```
  */
-export declare function parseBoolean(value: string | number | boolean | null | undefined, options?: ParseBooleanOptions): boolean | null;
+export declare function tryParseBoolean(value: string | number | boolean | null | undefined, options?: ParseBooleanOptions): boolean | undefined;
+/**
+ * Parses a value into a boolean as {@link tryParseBoolean} does.
+ *
+ * @throws {SyntaxError} If the value cannot be parsed.
+ */
+export declare function parseBoolean(value: string | number | boolean, options?: ParseBooleanOptions): boolean;
 //# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAE7B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AA0BD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,YAAY,CACxB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,OAAO,GAAE,mBAAwB,GAClC,MAAM,GAAG,IAAI,CAiBf;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CACxB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,OAAO,GAAE,mBAAwB,GAClC,MAAM,GAAG,IAAI,CAwBf;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,YAAY,CACxB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,OAAO,GAAE,mBAAwB,GAClC,OAAO,GAAG,IAAI,CAsBhB"}
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,GAAG,GAAG,GAAG,CAAC;IAE7B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC/B;AA0BD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,OAAO,GAAE,mBAAwB,GAClC,MAAM,GAAG,SAAS,CAiBpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAO9F;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,OAAO,GAAE,mBAAwB,GAClC,MAAM,GAAG,SAAS,CAwBpB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAO9F;AASD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,eAAe,CAC3B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,OAAO,GAAE,mBAAwB,GAClC,OAAO,GAAG,SAAS,CAsBrB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAOzG"}

package/dist/parse.js

@@ -16,55 +16,67 @@ function isValidInteger(value, radix) {
     return [...signless.toLowerCase()].every((char) => digits.includes(char));
 }
 // ============================================
-// parseInteger
+// tryParseInteger / parseInteger
 // ============================================
 /**
  * Safely parses a value into an integer.
- * Returns `null` if the value cannot be parsed.
+ * Returns `undefined` if the value cannot be parsed.
  *
- * - `null` or `undefined` → `null`
+ * - `null` or `undefined` → `undefined`
  * - `number` → returned as-is (floats are truncated)
  * - `string` → parsed with the given options
  *
  * @param value - The value to parse.
  * @param options - Optional parsing configuration.
- * @returns The parsed integer, or `null` on failure.
+ * @returns The parsed integer, or `undefined` on failure.
  *
  * @example
  * ```ts
- * parseInteger(42)                                        // 42
- * parseInteger(3.7)                                       // 3
- * parseInteger(null)                                      // null
- * parseInteger(undefined)                                 // null
- * parseInteger("42")                                      // 42
- * parseInteger("1.234.567", { thousandsSeparator: "." })  // 1234567
- * parseInteger("FF", { radix: 16 })                       // 255
- * parseInteger("abc")                                     // null
+ * tryParseInteger(42)                                        // 42
+ * tryParseInteger(3.7)                                       // 3
+ * tryParseInteger(null)                                      // undefined
+ * tryParseInteger(undefined)                                 // undefined
+ * tryParseInteger("42")                                      // 42
+ * tryParseInteger("1.234.567", { thousandsSeparator: "." })  // 1234567
+ * tryParseInteger("FF", { radix: 16 })                       // 255
+ * tryParseInteger("abc")                                     // undefined
  * ```
  */
-export function parseInteger(value, options = {}) {
+export function tryParseInteger(value, options = {}) {
     if (value === null || value === undefined)
-        return null;
+        return undefined;
     if (typeof value === "number") {
-        return Number.isFinite(value) ? Math.trunc(value) : null;
+        return Number.isFinite(value) ? Math.trunc(value) : undefined;
     }
     const { radix = 10, thousandsSeparator } = options;
     const cleaned = stripThousands(value.trim(), thousandsSeparator);
     if (cleaned === "")
-        return null;
+        return undefined;
     if (!isValidInteger(cleaned, radix))
-        return null;
+        return undefined;
     const parsed = Number.parseInt(cleaned, radix);
-    return Number.isNaN(parsed) ? null : parsed;
+    return Number.isNaN(parsed) ? undefined : parsed;
+}
+/**
+ * Parses a value into an integer as {@link tryParseInteger} does.
+ *
+ * @throws {SyntaxError} If the value cannot be parsed.
+ */
+export function parseInteger(value, options = {}) {
+    const parsed = tryParseInteger(value, options);
+    if (parsed === undefined) {
+        throw new SyntaxError(`Invalid integer "${value}".`);
+    }
+    return parsed;
 }
 // ============================================
-// parseDecimal
+// tryParseDecimal / parseDecimal
 // ============================================
 /**
  * Safely parses a value into a floating-point number.
- * Returns `null` if the value cannot be parsed.
+ * Returns `undefined` if the value cannot be parsed.
  *
- * - `null` or `undefined` → `null`
+ * - `null` or `undefined` → `undefined`
  * - `number` → returned as-is (if finite)
  * - `string` → parsed with the given options
  *
@@ -73,50 +85,62 @@ export function parseInteger(value, options = {}) {
  *
  * @param value - The value to parse.
  * @param options - Optional parsing configuration.
- * @returns The parsed float, or `null` on failure.
+ * @returns The parsed float, or `undefined` on failure.
  *
  * @example
  * ```ts
- * parseDecimal(3.14)                                                       // 3.14
- * parseDecimal(null)                                                       // null
- * parseDecimal(undefined)                                                  // null
- * parseDecimal("3.14")                                                     // 3.14
- * parseDecimal("3,14", { decimalSeparator: "," })                          // 3.14
- * parseDecimal("1.234,56", { decimalSeparator: ",", thousandsSeparator: "." }) // 1234.56
- * parseDecimal("abc")                                                      // null
+ * tryParseDecimal(3.14)                                                       // 3.14
+ * tryParseDecimal(null)                                                       // undefined
+ * tryParseDecimal(undefined)                                                  // undefined
+ * tryParseDecimal("3.14")                                                     // 3.14
+ * tryParseDecimal("3,14", { decimalSeparator: "," })                          // 3.14
+ * tryParseDecimal("1.234,56", { decimalSeparator: ",", thousandsSeparator: "." }) // 1234.56
+ * tryParseDecimal("abc")                                                      // undefined
  * ```
  */
-export function parseDecimal(value, options = {}) {
+export function tryParseDecimal(value, options = {}) {
     if (value === null || value === undefined)
-        return null;
+        return undefined;
     if (typeof value === "number") {
-        return Number.isFinite(value) ? value : null;
+        return Number.isFinite(value) ? value : undefined;
     }
     const { decimalSeparator = ".", thousandsSeparator } = options;
     let cleaned = stripThousands(value.trim(), thousandsSeparator);
     if (cleaned === "")
-        return null;
+        return undefined;
     if (decimalSeparator === ",") {
         const commaCount = (cleaned.match(/,/g) || []).length;
         if (commaCount > 1)
-            return null;
+            return undefined;
         cleaned = cleaned.replace(",", ".");
     }
     if (!/^[+-]?\d+(\.\d+)?$/.test(cleaned))
-        return null;
+        return undefined;
     const parsed = Number.parseFloat(cleaned);
-    return Number.isNaN(parsed) || !Number.isFinite(parsed) ? null : parsed;
+    return Number.isNaN(parsed) || !Number.isFinite(parsed) ? undefined : parsed;
+}
+/**
+ * Parses a value into a decimal number as {@link tryParseDecimal} does.
+ *
+ * @throws {SyntaxError} If the value cannot be parsed.
+ */
+export function parseDecimal(value, options = {}) {
+    const parsed = tryParseDecimal(value, options);
+    if (parsed === undefined) {
+        throw new SyntaxError(`Invalid decimal number "${value}".`);
+    }
+    return parsed;
 }
 // ============================================
-// parseBoolean
+// tryParseBoolean / parseBoolean
 // ============================================
 const DEFAULT_TRUTHY = ["true", "1", "yes", "si", "sí", "on"];
 const DEFAULT_FALSY = ["false", "0", "no", "off"];
 /**
  * Safely parses a value into a boolean.
- * Returns `null` if the value cannot be interpreted as boolean.
+ * Returns `undefined` if the value cannot be interpreted as boolean.
  *
- * - `null` or `undefined` → `null`
+ * - `null` or `undefined` → `undefined`
  * - `boolean` → returned as-is
  * - `number` → `0` is `false`, any other finite number is `true`
  * - `string` → matched case-insensitively against known truthy/falsy values
@@ -126,44 +150,56 @@ const DEFAULT_FALSY = ["false", "0", "no", "off"];
  *
  * @param value - The value to parse.
  * @param options - Optional parsing configuration.
- * @returns The parsed boolean, or `null` on failure.
+ * @returns The parsed boolean, or `undefined` on failure.
  *
  * @example
  * ```ts
- * parseBoolean(true)                                    // true
- * parseBoolean(false)                                   // false
- * parseBoolean(1)                                       // true
- * parseBoolean(0)                                       // false
- * parseBoolean(null)                                    // null
- * parseBoolean(undefined)                               // null
- * parseBoolean("yes")                                   // true
- * parseBoolean("no")                                    // false
- * parseBoolean("sí")                                    // true
- * parseBoolean("TRUE")                                  // true
- * parseBoolean("oui")                                   // null
- * parseBoolean("oui", { extraTruthy: ["oui"] })         // true
- * parseBoolean("nein", { extraFalsy: ["nein"] })        // false
- * parseBoolean("whatever")                              // null
+ * tryParseBoolean(true)                                    // true
+ * tryParseBoolean(false)                                   // false
+ * tryParseBoolean(1)                                       // true
+ * tryParseBoolean(0)                                       // false
+ * tryParseBoolean(null)                                    // undefined
+ * tryParseBoolean(undefined)                               // undefined
+ * tryParseBoolean("yes")                                   // true
+ * tryParseBoolean("no")                                    // false
+ * tryParseBoolean("sí")                                    // true
+ * tryParseBoolean("TRUE")                                  // true
+ * tryParseBoolean("oui")                                   // undefined
+ * tryParseBoolean("oui", { extraTruthy: ["oui"] })         // true
+ * tryParseBoolean("nein", { extraFalsy: ["nein"] })        // false
+ * tryParseBoolean("whatever")                              // undefined
  * ```
  */
-export function parseBoolean(value, options = {}) {
+export function tryParseBoolean(value, options = {}) {
     if (value === null || value === undefined)
-        return null;
+        return undefined;
     if (typeof value === "boolean")
         return value;
     if (typeof value === "number") {
-        return Number.isFinite(value) ? value !== 0 : null;
+        return Number.isFinite(value) ? value !== 0 : undefined;
     }
     const { extraTruthy = [], extraFalsy = [] } = options;
     const normalized = value.trim().toLowerCase();
     if (normalized === "")
-        return null;
+        return undefined;
     const truthy = [...DEFAULT_TRUTHY, ...extraTruthy.map((s) => s.toLowerCase())];
     const falsy = [...DEFAULT_FALSY, ...extraFalsy.map((s) => s.toLowerCase())];
     if (truthy.includes(normalized))
         return true;
     if (falsy.includes(normalized))
         return false;
-    return null;
+    return undefined;
+}
+/**
+ * Parses a value into a boolean as {@link tryParseBoolean} does.
+ *
+ * @throws {SyntaxError} If the value cannot be parsed.
+ */
+export function parseBoolean(value, options = {}) {
+    const parsed = tryParseBoolean(value, options);
+    if (parsed === undefined) {
+        throw new SyntaxError(`Invalid boolean "${value}".`);
+    }
+    return parsed;
 }
 //# sourceMappingURL=parse.js.map

package/dist/parse.js.map

@@ -1 +1 @@
-{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"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","sourcesContent":["// parse.ts\n/**\n * Options for {@link parseBoolean}.\n */\nexport interface ParseBooleanOptions {\n    /**\n     * Additional strings to consider as `true`.\n     * These are matched case-insensitively.\n     * @example [\"oui\", \"ja\"]\n     */\n    extraTruthy?: string[];\n\n    /**\n     * Additional strings to consider as `false`.\n     * These are matched case-insensitively.\n     * @example [\"non\", \"nein\"]\n     */\n    extraFalsy?: string[];\n}\n\n/**\n * Options for {@link parseInteger}.\n */\nexport interface ParseIntegerOptions {\n    /**\n     * Numeric base for conversion.\n     * @default 10\n     */\n    radix?: number;\n\n    /**\n     * Thousands separator to strip before parsing.\n     * @example \".\" for \"1.234.567\" → 1234567\n     * @example \",\" for \"1,234,567\" → 1234567\n     */\n    thousandsSeparator?: string;\n}\n\n/**\n * Options for {@link parseDecimal}.\n */\nexport interface ParseDecimalOptions {\n    /**\n     * Character used as decimal point.\n     * @default \".\"\n     */\n    decimalSeparator?: \".\" | \",\";\n\n    /**\n     * Thousands separator to strip before parsing.\n     * @example \".\" for \"1.234,56\" (EU format)\n     * @example \",\" for \"1,234.56\" (US format)\n     */\n    thousandsSeparator?: string;\n}\n\n// ============================================\n// HELPERS\n// ============================================\n\nfunction stripThousands(value: string, separator?: string): string {\n    if (!separator) return value;\n    return value.split(separator).join(\"\");\n}\n\nfunction isValidInteger(value: string, radix: number): boolean {\n    if (!Number.isInteger(radix) || radix < 2 || radix > 36) return false;\n\n    const signless = value.replace(/^[+-]/, \"\");\n    if (signless === \"\") return false;\n\n    const digits = \"0123456789abcdefghijklmnopqrstuvwxyz\".slice(0, radix);\n\n    return [...signless.toLowerCase()].every((char) => digits.includes(char));\n}\n\n// ============================================\n// parseInteger\n// ============================================\n\n/**\n * Safely parses a value into an integer.\n * Returns `null` if the value cannot be parsed.\n *\n * - `null` or `undefined` → `null`\n * - `number` → returned as-is (floats are truncated)\n * - `string` → parsed with the given options\n *\n * @param value - The value to parse.\n * @param options - Optional parsing configuration.\n * @returns The parsed integer, or `null` on failure.\n *\n * @example\n * ```ts\n * parseInteger(42)                                        // 42\n * parseInteger(3.7)                                       // 3\n * parseInteger(null)                                      // null\n * parseInteger(undefined)                                 // null\n * parseInteger(\"42\")                                      // 42\n * parseInteger(\"1.234.567\", { thousandsSeparator: \".\" })  // 1234567\n * parseInteger(\"FF\", { radix: 16 })                       // 255\n * parseInteger(\"abc\")                                     // null\n * ```\n */\nexport function parseInteger(\n    value: string | number | null | undefined,\n    options: ParseIntegerOptions = {}\n): number | null {\n    if (value === null || value === undefined) return null;\n\n    if (typeof value === \"number\") {\n        return Number.isFinite(value) ? Math.trunc(value) : null;\n    }\n\n    const { radix = 10, thousandsSeparator } = options;\n\n    const cleaned = stripThousands(value.trim(), thousandsSeparator);\n\n    if (cleaned === \"\") return null;\n    if (!isValidInteger(cleaned, radix)) return null;\n\n    const parsed = Number.parseInt(cleaned, radix);\n\n    return Number.isNaN(parsed) ? null : parsed;\n}\n\n// ============================================\n// parseDecimal\n// ============================================\n\n/**\n * Safely parses a value into a floating-point number.\n * Returns `null` if the value cannot be parsed.\n *\n * - `null` or `undefined` → `null`\n * - `number` → returned as-is (if finite)\n * - `string` → parsed with the given options\n *\n * Supports custom decimal and thousands separators, making it suitable\n * for both US (`1,234.56`) and EU (`1.234,56`) number formats.\n *\n * @param value - The value to parse.\n * @param options - Optional parsing configuration.\n * @returns The parsed float, or `null` on failure.\n *\n * @example\n * ```ts\n * parseDecimal(3.14)                                                       // 3.14\n * parseDecimal(null)                                                       // null\n * parseDecimal(undefined)                                                  // null\n * parseDecimal(\"3.14\")                                                     // 3.14\n * parseDecimal(\"3,14\", { decimalSeparator: \",\" })                          // 3.14\n * parseDecimal(\"1.234,56\", { decimalSeparator: \",\", thousandsSeparator: \".\" }) // 1234.56\n * parseDecimal(\"abc\")                                                      // null\n * ```\n */\nexport function parseDecimal(\n    value: string | number | null | undefined,\n    options: ParseDecimalOptions = {}\n): number | null {\n    if (value === null || value === undefined) return null;\n\n    if (typeof value === \"number\") {\n        return Number.isFinite(value) ? value : null;\n    }\n\n    const { decimalSeparator = \".\", thousandsSeparator } = options;\n\n    let cleaned = stripThousands(value.trim(), thousandsSeparator);\n\n    if (cleaned === \"\") return null;\n\n    if (decimalSeparator === \",\") {\n        const commaCount = (cleaned.match(/,/g) || []).length;\n        if (commaCount > 1) return null;\n        cleaned = cleaned.replace(\",\", \".\");\n    }\n\n    if (!/^[+-]?\\d+(\\.\\d+)?$/.test(cleaned)) return null;\n\n    const parsed = Number.parseFloat(cleaned);\n\n    return Number.isNaN(parsed) || !Number.isFinite(parsed) ? null : parsed;\n}\n\n// ============================================\n// parseBoolean\n// ============================================\n\nconst DEFAULT_TRUTHY = [\"true\", \"1\", \"yes\", \"si\", \"sí\", \"on\"];\nconst DEFAULT_FALSY = [\"false\", \"0\", \"no\", \"off\"];\n\n/**\n * Safely parses a value into a boolean.\n * Returns `null` if the value cannot be interpreted as boolean.\n *\n * - `null` or `undefined` → `null`\n * - `boolean` → returned as-is\n * - `number` → `0` is `false`, any other finite number is `true`\n * - `string` → matched case-insensitively against known truthy/falsy values\n *\n * Default truthy: `\"true\"`, `\"1\"`, `\"yes\"`, `\"si\"`, `\"sí\"`, `\"on\"`\n * Default falsy:  `\"false\"`, `\"0\"`, `\"no\"`, `\"off\"`\n *\n * @param value - The value to parse.\n * @param options - Optional parsing configuration.\n * @returns The parsed boolean, or `null` on failure.\n *\n * @example\n * ```ts\n * parseBoolean(true)                                    // true\n * parseBoolean(false)                                   // false\n * parseBoolean(1)                                       // true\n * parseBoolean(0)                                       // false\n * parseBoolean(null)                                    // null\n * parseBoolean(undefined)                               // null\n * parseBoolean(\"yes\")                                   // true\n * parseBoolean(\"no\")                                    // false\n * parseBoolean(\"sí\")                                    // true\n * parseBoolean(\"TRUE\")                                  // true\n * parseBoolean(\"oui\")                                   // null\n * parseBoolean(\"oui\", { extraTruthy: [\"oui\"] })         // true\n * parseBoolean(\"nein\", { extraFalsy: [\"nein\"] })        // false\n * parseBoolean(\"whatever\")                              // null\n * ```\n */\nexport function parseBoolean(\n    value: string | number | boolean | null | undefined,\n    options: ParseBooleanOptions = {}\n): boolean | null {\n    if (value === null || value === undefined) return null;\n\n    if (typeof value === \"boolean\") return value;\n\n    if (typeof value === \"number\") {\n        return Number.isFinite(value) ? value !== 0 : null;\n    }\n\n    const { extraTruthy = [], extraFalsy = [] } = options;\n\n    const normalized = value.trim().toLowerCase();\n\n    if (normalized === \"\") return null;\n\n    const truthy = [...DEFAULT_TRUTHY, ...extraTruthy.map((s) => s.toLowerCase())];\n    const falsy = [...DEFAULT_FALSY, ...extraFalsy.map((s) => s.toLowerCase())];\n\n    if (truthy.includes(normalized)) return true;\n    if (falsy.includes(normalized)) return false;\n\n    return null;\n}"]}
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"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","sourcesContent":["// parse.ts\n/**\n * Options for {@link tryParseBoolean} and {@link parseBoolean}.\n */\nexport interface ParseBooleanOptions {\n    /**\n     * Additional strings to consider as `true`.\n     * These are matched case-insensitively.\n     * @example [\"oui\", \"ja\"]\n     */\n    extraTruthy?: string[];\n\n    /**\n     * Additional strings to consider as `false`.\n     * These are matched case-insensitively.\n     * @example [\"non\", \"nein\"]\n     */\n    extraFalsy?: string[];\n}\n\n/**\n * Options for {@link tryParseInteger} and {@link parseInteger}.\n */\nexport interface ParseIntegerOptions {\n    /**\n     * Numeric base for conversion.\n     * @default 10\n     */\n    radix?: number;\n\n    /**\n     * Thousands separator to strip before parsing.\n     * @example \".\" for \"1.234.567\" → 1234567\n     * @example \",\" for \"1,234,567\" → 1234567\n     */\n    thousandsSeparator?: string;\n}\n\n/**\n * Options for {@link tryParseDecimal} and {@link parseDecimal}.\n */\nexport interface ParseDecimalOptions {\n    /**\n     * Character used as decimal point.\n     * @default \".\"\n     */\n    decimalSeparator?: \".\" | \",\";\n\n    /**\n     * Thousands separator to strip before parsing.\n     * @example \".\" for \"1.234,56\" (EU format)\n     * @example \",\" for \"1,234.56\" (US format)\n     */\n    thousandsSeparator?: string;\n}\n\n// ============================================\n// HELPERS\n// ============================================\n\nfunction stripThousands(value: string, separator?: string): string {\n    if (!separator) return value;\n    return value.split(separator).join(\"\");\n}\n\nfunction isValidInteger(value: string, radix: number): boolean {\n    if (!Number.isInteger(radix) || radix < 2 || radix > 36) return false;\n\n    const signless = value.replace(/^[+-]/, \"\");\n    if (signless === \"\") return false;\n\n    const digits = \"0123456789abcdefghijklmnopqrstuvwxyz\".slice(0, radix);\n\n    return [...signless.toLowerCase()].every((char) => digits.includes(char));\n}\n\n// ============================================\n// tryParseInteger / parseInteger\n// ============================================\n\n/**\n * Safely parses a value into an integer.\n * Returns `undefined` if the value cannot be parsed.\n *\n * - `null` or `undefined` → `undefined`\n * - `number` → returned as-is (floats are truncated)\n * - `string` → parsed with the given options\n *\n * @param value - The value to parse.\n * @param options - Optional parsing configuration.\n * @returns The parsed integer, or `undefined` on failure.\n *\n * @example\n * ```ts\n * tryParseInteger(42)                                        // 42\n * tryParseInteger(3.7)                                       // 3\n * tryParseInteger(null)                                      // undefined\n * tryParseInteger(undefined)                                 // undefined\n * tryParseInteger(\"42\")                                      // 42\n * tryParseInteger(\"1.234.567\", { thousandsSeparator: \".\" })  // 1234567\n * tryParseInteger(\"FF\", { radix: 16 })                       // 255\n * tryParseInteger(\"abc\")                                     // undefined\n * ```\n */\nexport function tryParseInteger(\n    value: string | number | null | undefined,\n    options: ParseIntegerOptions = {}\n): number | undefined {\n    if (value === null || value === undefined) return undefined;\n\n    if (typeof value === \"number\") {\n        return Number.isFinite(value) ? Math.trunc(value) : undefined;\n    }\n\n    const { radix = 10, thousandsSeparator } = options;\n\n    const cleaned = stripThousands(value.trim(), thousandsSeparator);\n\n    if (cleaned === \"\") return undefined;\n    if (!isValidInteger(cleaned, radix)) return undefined;\n\n    const parsed = Number.parseInt(cleaned, radix);\n\n    return Number.isNaN(parsed) ? undefined : parsed;\n}\n\n/**\n * Parses a value into an integer as {@link tryParseInteger} does.\n *\n * @throws {SyntaxError} If the value cannot be parsed.\n */\nexport function parseInteger(value: string | number, options: ParseIntegerOptions = {}): number {\n    const parsed = tryParseInteger(value, options);\n    if (parsed === undefined) {\n        throw new SyntaxError(`Invalid integer \"${value}\".`);\n    }\n\n    return parsed;\n}\n\n// ============================================\n// tryParseDecimal / parseDecimal\n// ============================================\n\n/**\n * Safely parses a value into a floating-point number.\n * Returns `undefined` if the value cannot be parsed.\n *\n * - `null` or `undefined` → `undefined`\n * - `number` → returned as-is (if finite)\n * - `string` → parsed with the given options\n *\n * Supports custom decimal and thousands separators, making it suitable\n * for both US (`1,234.56`) and EU (`1.234,56`) number formats.\n *\n * @param value - The value to parse.\n * @param options - Optional parsing configuration.\n * @returns The parsed float, or `undefined` on failure.\n *\n * @example\n * ```ts\n * tryParseDecimal(3.14)                                                       // 3.14\n * tryParseDecimal(null)                                                       // undefined\n * tryParseDecimal(undefined)                                                  // undefined\n * tryParseDecimal(\"3.14\")                                                     // 3.14\n * tryParseDecimal(\"3,14\", { decimalSeparator: \",\" })                          // 3.14\n * tryParseDecimal(\"1.234,56\", { decimalSeparator: \",\", thousandsSeparator: \".\" }) // 1234.56\n * tryParseDecimal(\"abc\")                                                      // undefined\n * ```\n */\nexport function tryParseDecimal(\n    value: string | number | null | undefined,\n    options: ParseDecimalOptions = {}\n): number | undefined {\n    if (value === null || value === undefined) return undefined;\n\n    if (typeof value === \"number\") {\n        return Number.isFinite(value) ? value : undefined;\n    }\n\n    const { decimalSeparator = \".\", thousandsSeparator } = options;\n\n    let cleaned = stripThousands(value.trim(), thousandsSeparator);\n\n    if (cleaned === \"\") return undefined;\n\n    if (decimalSeparator === \",\") {\n        const commaCount = (cleaned.match(/,/g) || []).length;\n        if (commaCount > 1) return undefined;\n        cleaned = cleaned.replace(\",\", \".\");\n    }\n\n    if (!/^[+-]?\\d+(\\.\\d+)?$/.test(cleaned)) return undefined;\n\n    const parsed = Number.parseFloat(cleaned);\n\n    return Number.isNaN(parsed) || !Number.isFinite(parsed) ? undefined : parsed;\n}\n\n/**\n * Parses a value into a decimal number as {@link tryParseDecimal} does.\n *\n * @throws {SyntaxError} If the value cannot be parsed.\n */\nexport function parseDecimal(value: string | number, options: ParseDecimalOptions = {}): number {\n    const parsed = tryParseDecimal(value, options);\n    if (parsed === undefined) {\n        throw new SyntaxError(`Invalid decimal number \"${value}\".`);\n    }\n\n    return parsed;\n}\n\n// ============================================\n// tryParseBoolean / parseBoolean\n// ============================================\n\nconst DEFAULT_TRUTHY = [\"true\", \"1\", \"yes\", \"si\", \"sí\", \"on\"];\nconst DEFAULT_FALSY = [\"false\", \"0\", \"no\", \"off\"];\n\n/**\n * Safely parses a value into a boolean.\n * Returns `undefined` if the value cannot be interpreted as boolean.\n *\n * - `null` or `undefined` → `undefined`\n * - `boolean` → returned as-is\n * - `number` → `0` is `false`, any other finite number is `true`\n * - `string` → matched case-insensitively against known truthy/falsy values\n *\n * Default truthy: `\"true\"`, `\"1\"`, `\"yes\"`, `\"si\"`, `\"sí\"`, `\"on\"`\n * Default falsy:  `\"false\"`, `\"0\"`, `\"no\"`, `\"off\"`\n *\n * @param value - The value to parse.\n * @param options - Optional parsing configuration.\n * @returns The parsed boolean, or `undefined` on failure.\n *\n * @example\n * ```ts\n * tryParseBoolean(true)                                    // true\n * tryParseBoolean(false)                                   // false\n * tryParseBoolean(1)                                       // true\n * tryParseBoolean(0)                                       // false\n * tryParseBoolean(null)                                    // undefined\n * tryParseBoolean(undefined)                               // undefined\n * tryParseBoolean(\"yes\")                                   // true\n * tryParseBoolean(\"no\")                                    // false\n * tryParseBoolean(\"sí\")                                    // true\n * tryParseBoolean(\"TRUE\")                                  // true\n * tryParseBoolean(\"oui\")                                   // undefined\n * tryParseBoolean(\"oui\", { extraTruthy: [\"oui\"] })         // true\n * tryParseBoolean(\"nein\", { extraFalsy: [\"nein\"] })        // false\n * tryParseBoolean(\"whatever\")                              // undefined\n * ```\n */\nexport function tryParseBoolean(\n    value: string | number | boolean | null | undefined,\n    options: ParseBooleanOptions = {}\n): boolean | undefined {\n    if (value === null || value === undefined) return undefined;\n\n    if (typeof value === \"boolean\") return value;\n\n    if (typeof value === \"number\") {\n        return Number.isFinite(value) ? value !== 0 : undefined;\n    }\n\n    const { extraTruthy = [], extraFalsy = [] } = options;\n\n    const normalized = value.trim().toLowerCase();\n\n    if (normalized === \"\") return undefined;\n\n    const truthy = [...DEFAULT_TRUTHY, ...extraTruthy.map((s) => s.toLowerCase())];\n    const falsy = [...DEFAULT_FALSY, ...extraFalsy.map((s) => s.toLowerCase())];\n\n    if (truthy.includes(normalized)) return true;\n    if (falsy.includes(normalized)) return false;\n\n    return undefined;\n}\n\n/**\n * Parses a value into a boolean as {@link tryParseBoolean} does.\n *\n * @throws {SyntaxError} If the value cannot be parsed.\n */\nexport function parseBoolean(value: string | number | boolean, options: ParseBooleanOptions = {}): boolean {\n    const parsed = tryParseBoolean(value, options);\n    if (parsed === undefined) {\n        throw new SyntaxError(`Invalid boolean \"${value}\".`);\n    }\n\n    return parsed;\n}\n"]}

package/dist/range.d.ts

@@ -1,6 +1,6 @@
 export default class Range<T> {
-    private readonly start;
-    private readonly end;
+    readonly start: T;
+    readonly end: T;
     /**
      * Range constructor.
      * @param start
@@ -36,14 +36,6 @@ export default class Range<T> {
      * @returns Returns true if the specified value is within the range, false otherwise.
      */
     contains(obj: T, inclusive?: boolean): boolean;
-    /**
-     * @returns T
-     */
-    getStart(): T;
-    /**
-     * @returns T
-     */
-    getEnd(): T;
     /**
      * Finds the intersection between two sets of ranges.
      *

package/dist/range.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../src/range.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,KAAK,CAAC,CAAC;IAExB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAI;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAI;IAExB;;;;OAIG;gBACS,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IAK5B;;;;;OAKG;IACI,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI;IAWlD;;;;;OAKG;IACI,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;IAoB5C;;;;;OAKG;IACI,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO;IAWzC;;;;;;OAMG;IACI,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS,GAAE,OAAc,GAAG,OAAO;IAM3D;;OAEG;IACI,QAAQ,IAAI,CAAC;IAIpB;;OAEG;IACI,MAAM,IAAI,CAAC;IAIlB;;;;;;OAMG;WACW,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;IAatF;;;;;;OAMG;WACW,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO;IAW/E;;;;;;OAMG;WACW,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;CAiBxF"}
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../src/range.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,OAAO,OAAO,KAAK,CAAC,CAAC;IAExB,SAAgB,KAAK,EAAE,CAAC,CAAC;IACzB,SAAgB,GAAG,EAAE,CAAC,CAAC;IAEvB;;;;OAIG;gBACS,KAAK,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC;IAK5B;;;;;OAKG;IACI,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI;IAWlD;;;;;OAKG;IACI,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;IAoB5C;;;;;OAKG;IACI,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO;IAWzC;;;;;;OAMG;IACI,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,SAAS,GAAE,OAAc,GAAG,OAAO;IAM3D;;;;;;OAMG;WACW,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;IAatF;;;;;;OAMG;WACW,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO;IAW/E;;;;;;OAMG;WACW,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE;CAiBxF"}

package/dist/range.js

@@ -75,18 +75,6 @@ export default class Range {
             (this.start <= obj && this.end >= obj) :
             (this.start < obj && this.end > obj);
     }
-    /**
-     * @returns T
-     */
-    getStart() {
-        return this.start;
-    }
-    /**
-     * @returns T
-     */
-    getEnd() {
-        return this.end;
-    }
     /**
      * Finds the intersection between two sets of ranges.
      *

package/dist/range.js.map

@@ -1 +1 @@
-{"version":3,"file":"range.js","sourceRoot":"","sources":["../src/range.ts"],"names":[],"mappings":"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","sourcesContent":["export default class Range<T> {\n\n    private readonly start: T;\n    private readonly end: T;\n\n    /**\n     * Range constructor.\n     * @param start\n     * @param end\n     */\n    constructor(start: T, end: T) {\n        this.start = start;\n        this.end = end;\n    }\n\n    /**\n     * Finds the intersection between two ranges.\n     *\n     * @param other The Range object to intersect with.\n     * @returns The intersected Range object, or null if there is no intersection.\n     */\n    public intersect(other: Range<T>): Range<T> | null {\n        const start = (this.start > other.start) ? this.start : other.start;\n        const end = (this.end < other.end) ? this.end : other.end;\n\n        if (start < end) {\n            return new Range(start, end);\n        } else {\n            return null;\n        }\n    }\n\n    /**\n     * Subtract the given range from this range.\n     *\n     * @param other The range to subtract from this range.\n     * @returns An array of Range objects representing the result of the subtraction.\n     */\n    public subtract(other: Range<T>): Range<T>[] {\n        const result: Range<T>[] = [];\n\n        if (this.start >= other.end || this.end <= other.start) {\n            result.push(new Range(this.start, this.end));\n        } else if (other.start <= this.start && other.end >= this.end) {\n            return result;\n        } else {\n            if (this.start < other.start) {\n                result.push(new Range(this.start, other.start));\n            }\n\n            if (this.end > other.end) {\n                result.push(new Range(other.end, this.end));\n            }\n        }\n\n        return result;\n    }\n\n    /**\n     * Determines if the given range overlaps with the current range.\n     *\n     * @param other The range to be checked for overlap.\n     * @returns Returns true if there is an overlap between the ranges, false otherwise.\n     */\n    public overlaps(other: Range<T>): boolean {\n        const s1 = this.start;\n        const e1 = this.end;\n        const s2 = other.start;\n        const e2 = other.end;\n\n        return (s2 > s1 && s2 < e1 || e2 > s1 && e2 < e1) ||\n            (s1 > s2 && s1 < e2 || e1 > s2 && e1 < e2) ||\n            (s1 === s2 && e1 === e2);\n    }\n\n    /**\n     * Determines whether the specified value is within the range defined by the start and end values.\n     *\n     * @param obj The value to check if it is within the range.\n     * @param inclusive Optional. If set to true, the range boundaries are considered inclusive.\n     * @returns Returns true if the specified value is within the range, false otherwise.\n     */\n    public contains(obj: T, inclusive: boolean = true): boolean {\n        return inclusive ?\n            (this.start <= obj && this.end >= obj) :\n            (this.start < obj && this.end > obj);\n    }\n\n    /**\n     * @returns T\n     */\n    public getStart(): T {\n        return this.start;\n    }\n\n    /**\n     * @returns T\n     */\n    public getEnd(): T {\n        return this.end;\n    }\n\n    /**\n     * Finds the intersection between two sets of ranges.\n     *\n     * @param ranges1\n     * @param ranges2\n     * @returns\n     */\n    public static intersectRanges<T>(ranges1: Range<T>[], ranges2: Range<T>[]): Range<T>[] {\n        const result: Range<T>[] = [];\n        for (const r1 of ranges1) {\n            for (const r2 of ranges2) {\n                const intersection = r1.intersect(r2);\n                if (intersection !== null) {\n                    result.push(intersection);\n                }\n            }\n        }\n        return result;\n    }\n\n    /**\n     * Determines if any range in the first set overlaps with any range in the second set.\n     *\n     * @param ranges1\n     * @param ranges2\n     * @returns\n     */\n    public static overlapsAny<T>(ranges1: Range<T>[], ranges2: Range<T>[]): boolean {\n        for (const r1 of ranges1) {\n            for (const r2 of ranges2) {\n                if (r1.overlaps(r2)) {\n                    return true;\n                }\n            }\n        }\n        return false;\n    }\n\n    /**\n     * Subtracts the second set of ranges from the first set of ranges.\n     *\n     * @param ranges1\n     * @param ranges2\n     * @returns\n     */\n    public static subtractRanges<T>(ranges1: Range<T>[], ranges2: Range<T>[]): Range<T>[] {\n        let currentRanges = ranges1;\n        for (const r2 of ranges2) {\n            const nextRanges: Range<T>[] = [];\n            for (const r1 of currentRanges) {\n                const subtracted = r1.subtract(r2);\n                for (const s of subtracted) {\n                    nextRanges.push(s);\n                }\n            }\n            currentRanges = nextRanges;\n            if (currentRanges.length === 0) {\n                break;\n            }\n        }\n        return currentRanges;\n    }\n}\n"]}
+{"version":3,"file":"range.js","sourceRoot":"","sources":["../src/range.ts"],"names":[],"mappings":"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","sourcesContent":["export default class Range<T> {\n\n    public readonly start: T;\n    public readonly end: T;\n\n    /**\n     * Range constructor.\n     * @param start\n     * @param end\n     */\n    constructor(start: T, end: T) {\n        this.start = start;\n        this.end = end;\n    }\n\n    /**\n     * Finds the intersection between two ranges.\n     *\n     * @param other The Range object to intersect with.\n     * @returns The intersected Range object, or null if there is no intersection.\n     */\n    public intersect(other: Range<T>): Range<T> | null {\n        const start = (this.start > other.start) ? this.start : other.start;\n        const end = (this.end < other.end) ? this.end : other.end;\n\n        if (start < end) {\n            return new Range(start, end);\n        } else {\n            return null;\n        }\n    }\n\n    /**\n     * Subtract the given range from this range.\n     *\n     * @param other The range to subtract from this range.\n     * @returns An array of Range objects representing the result of the subtraction.\n     */\n    public subtract(other: Range<T>): Range<T>[] {\n        const result: Range<T>[] = [];\n\n        if (this.start >= other.end || this.end <= other.start) {\n            result.push(new Range(this.start, this.end));\n        } else if (other.start <= this.start && other.end >= this.end) {\n            return result;\n        } else {\n            if (this.start < other.start) {\n                result.push(new Range(this.start, other.start));\n            }\n\n            if (this.end > other.end) {\n                result.push(new Range(other.end, this.end));\n            }\n        }\n\n        return result;\n    }\n\n    /**\n     * Determines if the given range overlaps with the current range.\n     *\n     * @param other The range to be checked for overlap.\n     * @returns Returns true if there is an overlap between the ranges, false otherwise.\n     */\n    public overlaps(other: Range<T>): boolean {\n        const s1 = this.start;\n        const e1 = this.end;\n        const s2 = other.start;\n        const e2 = other.end;\n\n        return (s2 > s1 && s2 < e1 || e2 > s1 && e2 < e1) ||\n            (s1 > s2 && s1 < e2 || e1 > s2 && e1 < e2) ||\n            (s1 === s2 && e1 === e2);\n    }\n\n    /**\n     * Determines whether the specified value is within the range defined by the start and end values.\n     *\n     * @param obj The value to check if it is within the range.\n     * @param inclusive Optional. If set to true, the range boundaries are considered inclusive.\n     * @returns Returns true if the specified value is within the range, false otherwise.\n     */\n    public contains(obj: T, inclusive: boolean = true): boolean {\n        return inclusive ?\n            (this.start <= obj && this.end >= obj) :\n            (this.start < obj && this.end > obj);\n    }\n\n    /**\n     * Finds the intersection between two sets of ranges.\n     *\n     * @param ranges1\n     * @param ranges2\n     * @returns\n     */\n    public static intersectRanges<T>(ranges1: Range<T>[], ranges2: Range<T>[]): Range<T>[] {\n        const result: Range<T>[] = [];\n        for (const r1 of ranges1) {\n            for (const r2 of ranges2) {\n                const intersection = r1.intersect(r2);\n                if (intersection !== null) {\n                    result.push(intersection);\n                }\n            }\n        }\n        return result;\n    }\n\n    /**\n     * Determines if any range in the first set overlaps with any range in the second set.\n     *\n     * @param ranges1\n     * @param ranges2\n     * @returns\n     */\n    public static overlapsAny<T>(ranges1: Range<T>[], ranges2: Range<T>[]): boolean {\n        for (const r1 of ranges1) {\n            for (const r2 of ranges2) {\n                if (r1.overlaps(r2)) {\n                    return true;\n                }\n            }\n        }\n        return false;\n    }\n\n    /**\n     * Subtracts the second set of ranges from the first set of ranges.\n     *\n     * @param ranges1\n     * @param ranges2\n     * @returns\n     */\n    public static subtractRanges<T>(ranges1: Range<T>[], ranges2: Range<T>[]): Range<T>[] {\n        let currentRanges = ranges1;\n        for (const r2 of ranges2) {\n            const nextRanges: Range<T>[] = [];\n            for (const r1 of currentRanges) {\n                const subtracted = r1.subtract(r2);\n                for (const s of subtracted) {\n                    nextRanges.push(s);\n                }\n            }\n            currentRanges = nextRanges;\n            if (currentRanges.length === 0) {\n                break;\n            }\n        }\n        return currentRanges;\n    }\n}\n"]}

package/dist/stopwatch.d.ts

@@ -1,10 +1,10 @@
 import TimeSpan from "./timespan.js";
 export default class Stopwatch {
     private startTime;
-    private elapsedTime;
+    private elapsedMilliseconds;
     start(): void;
     stop(): void;
     resume(): void;
-    getElapsedTime(): TimeSpan;
+    get elapsedTime(): TimeSpan;
 }
 //# sourceMappingURL=stopwatch.d.ts.map

package/dist/stopwatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stopwatch.d.ts","sourceRoot":"","sources":["../src/stopwatch.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,MAAM,CAAC,OAAO,OAAO,SAAS;IAC1B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAAuB;IAa1C,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAOZ,MAAM,IAAI,IAAI;IAOd,cAAc,IAAI,QAAQ;CAM7B"}
+{"version":3,"file":"stopwatch.d.ts","sourceRoot":"","sources":["../src/stopwatch.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,MAAM,CAAC,OAAO,OAAO,SAAS;IAC1B,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,mBAAmB,CAAuB;IAalD,KAAK,IAAI,IAAI;IAKb,IAAI,IAAI,IAAI;IAOZ,MAAM,IAAI,IAAI;IAOd,IAAI,WAAW,IAAI,QAAQ,CAK1B;CACJ"}