@develia/commons 0.4.13 → 0.4.15

package/dist/cjs/parse.js.map

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

package/dist/cjs/patch.js

@@ -2,6 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.patch = patch;
 exports.unpatch = unpatch;
+/**
+ * Devuelve un Map donde:
+ *  - clave -> null    (método añadido nuevo)
+ *  - clave -> descriptorOriginal (método sustituido)
+ */
 function patch(targetOrCtor, fns) {
     const target = typeof targetOrCtor === "function" ? targetOrCtor.prototype : targetOrCtor;
     const result = new Map();
@@ -20,11 +25,14 @@ function patch(targetOrCtor, fns) {
             });
             result.set(key, prev ?? null);
         }
-        catch {
+        catch { /* ignorar */
         }
     }
     return result;
 }
+/**
+ * Revierte un patch a partir del mapa devuelto por `patch`.
+ */
 function unpatch(targetOrCtor, changes) {
     const target = typeof targetOrCtor === "function" ? targetOrCtor.prototype : targetOrCtor;
     for (const [key, prev] of changes) {
@@ -37,7 +45,7 @@ function unpatch(targetOrCtor, changes) {
                 Object.defineProperty(target, key, prev);
             }
         }
-        catch {
+        catch { /* ignorar */
         }
     }
 }

package/dist/cjs/patch.js.map

@@ -1 +1 @@
-{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../src/patch.ts"],"names":[],"mappings":";;AAyBA,sBA2BC;AAeD,0BAYC;AAtDD,SAAgB,KAAK,CACjB,YAAiB,EACjB,GAAmB;IAEnB,MAAM,MAAM,GAAG,OAAO,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;IAE1F,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0C,CAAC;IACjE,MAAM,OAAO,GACT,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAQ,CAAC;IAEzE,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,UAAyB,GAAG,IAAe;YACtD,OAAQ,EAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC;QACF,IAAI,CAAC;YACD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE;gBAC/B,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,KAAK;aACpB,CAAC,CAAC;YACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;QACT,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAeD,SAAgB,OAAO,CAAC,YAAiB,EAAE,OAAoD;IAC3F,MAAM,MAAM,GAAG,OAAO,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1F,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QAChC,IAAI,CAAC;YACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAChB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;oBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YAC9E,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7C,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;QACT,CAAC;IACL,CAAC;AACL,CAAC"}
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../src/patch.ts"],"names":[],"mappings":";;AAyBA,sBA2BC;AAeD,0BAYC;AA3DD;;;;GAIG;AACH,SAAgB,KAAK,CACjB,YAAiB,EACjB,GAAmB;IAEnB,MAAM,MAAM,GAAG,OAAO,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;IAE1F,MAAM,MAAM,GAAG,IAAI,GAAG,EAA0C,CAAC;IACjE,MAAM,OAAO,GACT,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAQ,CAAC;IAEzE,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,UAAyB,GAAG,IAAe;YACtD,OAAQ,EAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC;QACF,IAAI,CAAC;YACD,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE;gBAC/B,KAAK,EAAE,MAAM;gBACb,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,IAAI;gBAClB,UAAU,EAAE,KAAK;aACpB,CAAC,CAAC;YACH,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC,CAAC,aAAa;QACvB,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAYD;;GAEG;AACH,SAAgB,OAAO,CAAC,YAAiB,EAAE,OAAoD;IAC3F,MAAM,MAAM,GAAG,OAAO,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1F,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,OAAO,EAAE,CAAC;QAChC,IAAI,CAAC;YACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;gBAChB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC;oBAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;YAC9E,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAC7C,CAAC;QACL,CAAC;QAAC,MAAM,CAAC,CAAC,aAAa;QACvB,CAAC;IACL,CAAC;AACL,CAAC","sourcesContent":["import type {Constructor} from \"./types.js\";\r\n\r\nexport type PureMethod<T extends object, A extends any[] = any[], R = any> =\r\n    (obj: T, ...args: A) => R;\r\n\r\nexport type PatchSpec<T extends object> =\r\n    | Record<string, PureMethod<T, any[], any>>\r\n    | Map<PropertyKey, PureMethod<T, any[], any>>;\r\n\r\n\r\nexport function patch<C extends Constructor<any>>(\r\n    targetOrCtor: C,\r\n    fns: PatchSpec<InstanceType<C>>\r\n): Map<PropertyKey, PropertyDescriptor | null>;\r\n\r\nexport function patch<T extends object>(\r\n    targetOrCtor: T,\r\n    fns: PatchSpec<T>\r\n): Map<PropertyKey, PropertyDescriptor | null>;\r\n\r\n/**\r\n * Devuelve un Map donde:\r\n *  - clave -> null    (método añadido nuevo)\r\n *  - clave -> descriptorOriginal (método sustituido)\r\n */\r\nexport function patch(\r\n    targetOrCtor: any,\r\n    fns: PatchSpec<any>\r\n): Map<PropertyKey, PropertyDescriptor | null> {\r\n    const target = typeof targetOrCtor === \"function\" ? targetOrCtor.prototype : targetOrCtor;\r\n\r\n    const result = new Map<PropertyKey, PropertyDescriptor | null>();\r\n    const entries: Array<[PropertyKey, PureMethod<any>]> =\r\n        fns instanceof Map ? [...fns.entries()] : Object.entries(fns) as any;\r\n\r\n    for (const [key, fn] of entries) {\r\n        const prev = Object.getOwnPropertyDescriptor(target, key);\r\n        const method = function (this: unknown, ...args: unknown[]) {\r\n            return (fn as any)(this, ...args);\r\n        };\r\n        try {\r\n            Object.defineProperty(target, key, {\r\n                value: method,\r\n                writable: true,\r\n                configurable: true,\r\n                enumerable: false,\r\n            });\r\n            result.set(key, prev ?? null);\r\n        } catch { /* ignorar */\r\n        }\r\n    }\r\n    return result;\r\n}\r\n\r\n// Overloads unpatch\r\nexport function unpatch<C extends Constructor<any>>(\r\n    targetOrCtor: C,\r\n    changes: Map<PropertyKey, PropertyDescriptor | null>\r\n): void;\r\nexport function unpatch<T extends object>(\r\n    targetOrCtor: T,\r\n    changes: Map<PropertyKey, PropertyDescriptor | null>\r\n): void;\r\n\r\n/**\r\n * Revierte un patch a partir del mapa devuelto por `patch`.\r\n */\r\nexport function unpatch(targetOrCtor: any, changes: Map<PropertyKey, PropertyDescriptor | null>): void {\r\n    const target = typeof targetOrCtor === \"function\" ? targetOrCtor.prototype : targetOrCtor;\r\n    for (const [key, prev] of changes) {\r\n        try {\r\n            if (prev === null) {\r\n                if (Object.prototype.hasOwnProperty.call(target, key)) delete target[key];\r\n            } else {\r\n                Object.defineProperty(target, key, prev);\r\n            }\r\n        } catch { /* ignorar */\r\n        }\r\n    }\r\n}"]}

package/dist/cjs/stopwatch.js

@@ -9,6 +9,16 @@ class Stopwatch {
         this.startTime = null;
         this.elapsedTime = null;
     }
+    /*static measure<T>(callback: () => T, measure: { value: TimeSpan | null }): T {
+        const stopwatch = new Stopwatch();
+        stopwatch.start();
+        try {
+            return callback();
+        } finally {
+            stopwatch.stop();
+            measure.value = stopwatch.getElapsedTime();
+        }
+    }*/
     start() {
         this.startTime = performance.now();
         this.elapsedTime = null;

package/dist/cjs/stopwatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"stopwatch.js","sourceRoot":"","sources":["../../src/stopwatch.ts"],"names":[],"mappings":";;;;;AAAA,gEAAqC;AAErC,MAAqB,SAAS;IAA9B;QACY,cAAS,GAAkB,IAAI,CAAC;QAChC,gBAAW,GAAkB,IAAI,CAAC;IAsC9C,CAAC;IAzBG,KAAK;QACD,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,IAAI;QACA,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;YACtD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,CAAC;IACL,CAAC;IAED,MAAM;QACF,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;YACtD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,CAAC;IACL,CAAC;IAED,cAAc;QACV,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,qBAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,qBAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC;IAC9D,CAAC;CACJ;AAxCD,4BAwCC"}
+{"version":3,"file":"stopwatch.js","sourceRoot":"","sources":["../../src/stopwatch.ts"],"names":[],"mappings":";;;;;AAAA,gEAAqC;AAErC,MAAqB,SAAS;IAA9B;QACY,cAAS,GAAkB,IAAI,CAAC;QAChC,gBAAW,GAAkB,IAAI,CAAC;IAsC9C,CAAC;IApCG;;;;;;;;;OASG;IAEH,KAAK;QACD,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED,IAAI;QACA,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;YACtD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,CAAC;IACL,CAAC;IAED,MAAM;QACF,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC;YACtD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,CAAC;IACL,CAAC;IAED,cAAc;QACV,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,qBAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,qBAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC;IAC9D,CAAC;CACJ;AAxCD,4BAwCC","sourcesContent":["import TimeSpan from \"./timespan.js\";\r\n\r\nexport default class Stopwatch {\r\n    private startTime: number | null = null;\r\n    private elapsedTime: number | null = null;\r\n\r\n    /*static measure<T>(callback: () => T, measure: { value: TimeSpan | null }): T {\r\n        const stopwatch = new Stopwatch();\r\n        stopwatch.start();\r\n        try {\r\n            return callback();\r\n        } finally {\r\n            stopwatch.stop();\r\n            measure.value = stopwatch.getElapsedTime();\r\n        }\r\n    }*/\r\n\r\n    start(): void {\r\n        this.startTime = performance.now();\r\n        this.elapsedTime = null;\r\n    }\r\n\r\n    stop(): void {\r\n        if (this.startTime !== null) {\r\n            this.elapsedTime = performance.now() - this.startTime;\r\n            this.startTime = null;\r\n        }\r\n    }\r\n\r\n    resume(): void {\r\n        if (this.elapsedTime !== null) {\r\n            this.startTime = performance.now() - this.elapsedTime;\r\n            this.elapsedTime = null;\r\n        }\r\n    }\r\n\r\n    getElapsedTime(): TimeSpan {\r\n        if (this.startTime !== null) {\r\n            return TimeSpan.fromMilliseconds(performance.now() - this.startTime);\r\n        }\r\n        return TimeSpan.fromMilliseconds(this.elapsedTime ?? 0.0);\r\n    }\r\n}\r\n"]}

package/dist/cjs/string.js

@@ -8,16 +8,37 @@ exports.toKebabCase = toKebabCase;
 exports.toCamelCase = toCamelCase;
 exports.toPascalCase = toPascalCase;
 exports.toConstantCase = toConstantCase;
+/**
+ * Ensures that a given string has a specific prefix.
+ *
+ * @param {string} str - The string to ensure the prefix on.
+ * @param {string} prefix - The prefix to ensure on the string.
+ * @return {string} - The resulting string with the ensured prefix.
+ */
 function ensurePrefix(str, prefix) {
     if (!str.startsWith(prefix))
         return prefix + str;
     return str;
 }
+/**
+ * Ensures that a string ends with a specified suffix.
+ *
+ * @param {string} str - The original string.
+ * @param {string} suffix - The suffix to ensure.
+ * @return {string} - The modified string with the suffix added if it was not already present.
+ */
 function ensureSuffix(str, suffix) {
     if (!str.endsWith(suffix))
         return str + suffix;
     return str;
 }
+/**
+ * Formats a string using a template and provided arguments.
+ *
+ * @param {string} template - The template string containing placeholders.
+ * @param {any[]} args - Optional arguments to replace the placeholders in the template.
+ * @return {string} The formatted string.
+ */
 function format(template, ...args) {
     let regex;
     if (args.length === 1 && typeof args[0] === 'object') {
@@ -31,24 +52,53 @@ function format(template, ...args) {
         return typeof args[key] !== 'undefined' ? args[key] : "";
     });
 }
+/**
+ * Splits a string into its constituent words, regardless of the original case
+ * style (camelCase, PascalCase, snake_case, kebab-case, CONSTANT_CASE,
+ * space-separated, etc.).
+ *
+ * @param {string} str - The string to split into words.
+ * @return {string[]} - The list of lowercase words extracted from the input.
+ */
 function toWords(str) {
     if (!str)
         return [];
     return str
+        // Insert a space between a lowercase/digit and an uppercase letter (camelCase -> camel Case)
         .replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+        // Insert a space between consecutive uppercase letters followed by a lowercase letter (XMLParser -> XML Parser)
         .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+        // Replace any non-alphanumeric character with a space
         .replace(/[^a-zA-Z0-9]+/g, ' ')
         .trim()
         .toLowerCase()
         .split(/\s+/)
         .filter(Boolean);
 }
+/**
+ * Converts a string to snake_case.
+ *
+ * @param {string} str - The string to convert.
+ * @return {string} - The string converted to snake_case.
+ */
 function toSnakeCase(str) {
     return toWords(str).join('_');
 }
+/**
+ * Converts a string to kebab-case.
+ *
+ * @param {string} str - The string to convert.
+ * @return {string} - The string converted to kebab-case.
+ */
 function toKebabCase(str) {
     return toWords(str).join('-');
 }
+/**
+ * Converts a string to camelCase.
+ *
+ * @param {string} str - The string to convert.
+ * @return {string} - The string converted to camelCase.
+ */
 function toCamelCase(str) {
     const words = toWords(str);
     if (words.length === 0)
@@ -57,11 +107,23 @@ function toCamelCase(str) {
         .map((word, i) => i === 0 ? word : word.charAt(0).toUpperCase() + word.slice(1))
         .join('');
 }
+/**
+ * Converts a string to PascalCase.
+ *
+ * @param {string} str - The string to convert.
+ * @return {string} - The string converted to PascalCase.
+ */
 function toPascalCase(str) {
     return toWords(str)
         .map(word => word.charAt(0).toUpperCase() + word.slice(1))
         .join('');
 }
+/**
+ * Converts a string to CONSTANT_CASE (a.k.a. SCREAMING_SNAKE_CASE).
+ *
+ * @param {string} str - The string to convert.
+ * @return {string} - The string converted to CONSTANT_CASE.
+ */
 function toConstantCase(str) {
     return toWords(str).join('_').toUpperCase();
 }

package/dist/cjs/string.js.map

@@ -1 +1 @@
-{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/string.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/string.ts"],"names":[],"mappings":"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","sourcesContent":["\n/**\n * Ensures that a given string has a specific prefix.\n *\n * @param {string} str - The string to ensure the prefix on.\n * @param {string} prefix - The prefix to ensure on the string.\n * @return {string} - The resulting string with the ensured prefix.\n */\nexport function ensurePrefix(str: string, prefix: string): string {\n    if (!str.startsWith(prefix))\n        return prefix + str\n    return str\n}\n\n\n/**\n * Ensures that a string ends with a specified suffix.\n *\n * @param {string} str - The original string.\n * @param {string} suffix - The suffix to ensure.\n * @return {string} - The modified string with the suffix added if it was not already present.\n */\nexport function ensureSuffix(str: string, suffix: string): string {\n    if (!str.endsWith(suffix))\n        return str + suffix\n    return str\n}\n\n/**\n * Formats a string using a template and provided arguments.\n *\n * @param {string} template - The template string containing placeholders.\n * @param {any[]} args - Optional arguments to replace the placeholders in the template.\n * @return {string} The formatted string.\n */\nexport function format(template: string, ...args: any[]): string {\n\n    let regex: RegExp;\n    if (args.length === 1 && typeof args[0] === 'object') {\n        args = args[0];\n        regex = /{(.+?)}/g;\n    } else {\n        regex = /{(\\d+?)}/g;\n    }\n\n    return template.replace(regex, (match, key) => {\n        return typeof args[key] !== 'undefined' ? args[key] : \"\";\n    });\n}\n\n/**\n * Splits a string into its constituent words, regardless of the original case\n * style (camelCase, PascalCase, snake_case, kebab-case, CONSTANT_CASE,\n * space-separated, etc.).\n *\n * @param {string} str - The string to split into words.\n * @return {string[]} - The list of lowercase words extracted from the input.\n */\nfunction toWords(str: string): string[] {\n    if (!str) return [];\n\n    return str\n        // Insert a space between a lowercase/digit and an uppercase letter (camelCase -> camel Case)\n        .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n        // Insert a space between consecutive uppercase letters followed by a lowercase letter (XMLParser -> XML Parser)\n        .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')\n        // Replace any non-alphanumeric character with a space\n        .replace(/[^a-zA-Z0-9]+/g, ' ')\n        .trim()\n        .toLowerCase()\n        .split(/\\s+/)\n        .filter(Boolean);\n}\n\n/**\n * Converts a string to snake_case.\n *\n * @param {string} str - The string to convert.\n * @return {string} - The string converted to snake_case.\n */\nexport function toSnakeCase(str: string): string {\n    return toWords(str).join('_');\n}\n\n/**\n * Converts a string to kebab-case.\n *\n * @param {string} str - The string to convert.\n * @return {string} - The string converted to kebab-case.\n */\nexport function toKebabCase(str: string): string {\n    return toWords(str).join('-');\n}\n\n/**\n * Converts a string to camelCase.\n *\n * @param {string} str - The string to convert.\n * @return {string} - The string converted to camelCase.\n */\nexport function toCamelCase(str: string): string {\n    const words = toWords(str);\n    if (words.length === 0) return '';\n    return words\n        .map((word, i) => i === 0 ? word : word.charAt(0).toUpperCase() + word.slice(1))\n        .join('');\n}\n\n/**\n * Converts a string to PascalCase.\n *\n * @param {string} str - The string to convert.\n * @return {string} - The string converted to PascalCase.\n */\nexport function toPascalCase(str: string): string {\n    return toWords(str)\n        .map(word => word.charAt(0).toUpperCase() + word.slice(1))\n        .join('');\n}\n\n/**\n * Converts a string to CONSTANT_CASE (a.k.a. SCREAMING_SNAKE_CASE).\n *\n * @param {string} str - The string to convert.\n * @return {string} - The string converted to CONSTANT_CASE.\n */\nexport function toConstantCase(str: string): string {\n    return toWords(str).join('_').toUpperCase();\n}"]}

package/dist/cjs/timer.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * A class representing a timer that executes a callback function at a specified interval.
+ */
 class Timer {
+    /**
+     * @param callback Callback
+     * @param interval Seconds between calls
+     */
     constructor(callback, interval) {
         this._callback = callback;
         this._interval = interval;

package/dist/cjs/timer.js.map

@@ -1 +1 @@
-{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../src/timer.ts"],"names":[],"mappings":";;AAGA,MAAqB,KAAK;IAUtB,YAAY,QAAoB,EAAE,QAAgB;QAC9C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAGD,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC;IACvE,CAAC;IAED,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,IAAI,QAAQ,CAAC,KAAa;QACtB,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,IAAI,CAAC,OAAO;gBACZ,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;IACL,CAAC;IAED,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,IAAI,QAAQ,CAAC,KAAiB;QAC1B,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAC3B,CAAC;IACL,CAAC;IAGD,KAAK;QACD,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;gBAChC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI;oBACtB,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IAED,IAAI;QACA,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC5B,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,CAAC;IACL,CAAC;IAED,OAAO;QACH,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;CACJ;AAhED,wBAgEC"}
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../src/timer.ts"],"names":[],"mappings":";;AAAA;;GAEG;AACH,MAAqB,KAAK;IAMtB;;;OAGG;IACH,YAAY,QAAoB,EAAE,QAAgB;QAC9C,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAGD,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,WAAW,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC;IACvE,CAAC;IAED,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,IAAI,QAAQ,CAAC,KAAa;QACtB,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YACvB,IAAI,IAAI,CAAC,OAAO;gBACZ,IAAI,CAAC,OAAO,EAAE,CAAC;QACvB,CAAC;IACL,CAAC;IAED,IAAI,QAAQ;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,IAAI,QAAQ,CAAC,KAAiB;QAC1B,IAAI,KAAK,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAC3B,CAAC;IACL,CAAC;IAGD,KAAK;QACD,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE;gBAChC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI;oBACtB,IAAI,CAAC,SAAS,EAAE,CAAC;YACzB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IAED,IAAI;QACA,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;YAC5B,aAAa,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,CAAC;IACL,CAAC;IAED,OAAO;QACH,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,KAAK,EAAE,CAAC;IACjB,CAAC;CACJ;AAhED,wBAgEC","sourcesContent":["/**\r\n * A class representing a timer that executes a callback function at a specified interval.\r\n */\r\nexport default class Timer {\r\n\r\n    private _callback: () => void;\r\n    private _interval: number;\r\n    private _intervalId: any | null;\r\n\r\n    /**\r\n     * @param callback Callback\r\n     * @param interval Seconds between calls\r\n     */\r\n    constructor(callback: () => void, interval: number) {\r\n        this._callback = callback;\r\n        this._interval = interval;\r\n        this._intervalId = null;\r\n    }\r\n\r\n    \r\n    get running(): boolean {\r\n        return this._intervalId !== null && this._intervalId !== undefined;\r\n    }\r\n\r\n    get interval(): number {\r\n        return this._interval;\r\n    }\r\n\r\n    set interval(value: number) {\r\n        if (value != this._interval) {\r\n            this._interval = value;\r\n            if (this.running)\r\n                this.restart();\r\n        }\r\n    }\r\n\r\n    get callback(): () => void {\r\n        return this._callback;\r\n    }\r\n\r\n    set callback(value: () => void) {\r\n        if (value != this._callback) {\r\n            this._callback = value;\r\n        }\r\n    }\r\n\r\n\r\n    start(): void {\r\n        if (this._intervalId === null) {\r\n            this._intervalId = setInterval(() => {\r\n                if (this._callback != null)\r\n                    this._callback();\r\n            }, this._interval);\r\n        }\r\n    }\r\n\r\n    stop(): void {\r\n        if (this._intervalId !== null) {\r\n            clearInterval(this._intervalId);\r\n            this._intervalId = null;\r\n        }\r\n    }\r\n\r\n    restart(): void {\r\n        this.stop();\r\n        this.start();\r\n    }\r\n}"]}

package/dist/cjs/timespan.js

@@ -1,93 +1,238 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Represents a duration of time in milliseconds.
+ */
 class TimeSpan {
     constructor(milliseconds) {
         this.milliseconds = milliseconds;
     }
+    /**
+     * Gets the time interval in seconds.
+     * @returns {number} The duration in seconds.
+     */
     seconds() {
         return this.milliseconds / 1000;
     }
+    /**
+     * Gets the time interval in minutes.
+     * @returns {number} The duration in minutes.
+     */
     minutes() {
         return this.milliseconds / (1000 * 60);
     }
+    /**
+     * Gets the time interval in hours.
+     * @returns {number} The duration in hours.
+     */
     hours() {
         return this.milliseconds / (1000 * 60 * 60);
     }
+    /**
+     * Gets the time interval in days.
+     * @returns {number} The duration in days.
+     */
     days() {
         return this.milliseconds / (1000 * 60 * 60 * 24);
     }
+    /**
+     * Gets the time interval in weeks.
+     * @returns {number} The duration in weeks.
+     */
     weeks() {
         return this.milliseconds / (1000 * 60 * 60 * 24 * 7);
     }
+    /**
+     * Creates a TimeSpan from a specified number of milliseconds.
+     * @param {number} milliseconds - The number of milliseconds.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     static fromMilliseconds(milliseconds) {
         return new TimeSpan(milliseconds);
     }
+    /**
+     * Creates a TimeSpan from a specified number of seconds.
+     * @param {number} seconds - The number of seconds.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     static fromSeconds(seconds) {
         return new TimeSpan(seconds * 1000);
     }
+    /**
+     * Creates a TimeSpan from a specified number of minutes.
+     * @param {number} minutes - The number of minutes.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     static fromMinutes(minutes) {
         return new TimeSpan(minutes * 1000 * 60);
     }
+    /**
+     * Creates a TimeSpan from a specified number of hours.
+     * @param {number} hours - The number of hours.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     static fromHours(hours) {
         return new TimeSpan(hours * 1000 * 60 * 60);
     }
+    /**
+     * Creates a TimeSpan from a specified number of days.
+     * @param {number} days - The number of days.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     static fromDays(days) {
         return new TimeSpan(days * 1000 * 60 * 60 * 24);
     }
+    /**
+     * Creates a TimeSpan from a specified number of weeks.
+     * @param {number} weeks - The number of weeks.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     static fromWeeks(weeks) {
         return new TimeSpan(weeks * 1000 * 60 * 60 * 24 * 7);
     }
+    /**
+     * Returns a new TimeSpan that adds the specified number of milliseconds to this instance.
+     * @param {number} milliseconds - The milliseconds to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     addMilliseconds(milliseconds) {
         return new TimeSpan(this.milliseconds + milliseconds);
     }
+    /**
+     * Returns a new TimeSpan that adds the specified number of seconds to this instance.
+     * @param {number} seconds - The seconds to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     addSeconds(seconds) {
         return this.addMilliseconds(seconds * 1000);
     }
+    /**
+     * Returns a new TimeSpan that adds the specified number of minutes to this instance.
+     * @param {number} minutes - The minutes to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     addMinutes(minutes) {
         return this.addMilliseconds(minutes * 1000 * 60);
     }
+    /**
+     * Returns a new TimeSpan that adds the specified number of hours to this instance.
+     * @param {number} hours - The hours to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     addHours(hours) {
         return this.addMilliseconds(hours * 1000 * 60 * 60);
     }
+    /**
+     * Returns a new TimeSpan that adds the specified number of days to this instance.
+     * @param {number} days - The days to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     addDays(days) {
         return this.addMilliseconds(days * 1000 * 60 * 60 * 24);
     }
+    /**
+     * Returns a new TimeSpan that adds the specified number of weeks to this instance.
+     * @param {number} weeks - The weeks to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     addWeeks(weeks) {
         return this.addMilliseconds(weeks * 1000 * 60 * 60 * 24 * 7);
     }
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of milliseconds from this instance.
+     * @param {number} milliseconds - The milliseconds to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     subtractMilliseconds(milliseconds) {
         return new TimeSpan(this.milliseconds - milliseconds);
     }
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of seconds from this instance.
+     * @param {number} seconds - The seconds to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     subtractSeconds(seconds) {
         return this.subtractMilliseconds(seconds * 1000);
     }
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of minutes from this instance.
+     * @param {number} minutes - The minutes to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     subtractMinutes(minutes) {
         return this.subtractMilliseconds(minutes * 1000 * 60);
     }
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of hours from this instance.
+     * @param {number} hours - The hours to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     subtractHours(hours) {
         return this.subtractMilliseconds(hours * 1000 * 60 * 60);
     }
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of days from this instance.
+     * @param {number} days - The days to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     subtractDays(days) {
         return this.subtractMilliseconds(days * 1000 * 60 * 60 * 24);
     }
+    /**
+     * Returns a new TimeSpan that subtracts the specified number of weeks from this instance.
+     * @param {number} weeks - The weeks to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     subtractWeeks(weeks) {
         return this.subtractMilliseconds(weeks * 1000 * 60 * 60 * 24 * 7);
     }
+    /**
+     * Returns a new TimeSpan that adds the specified TimeSpan to this instance.
+     * @param {TimeSpan} other - The TimeSpan to add.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     add(other) {
         return new TimeSpan(this.milliseconds + other.milliseconds);
     }
+    /**
+     * Returns a new TimeSpan that subtracts the specified TimeSpan from this instance.
+     * @param {TimeSpan} other - The TimeSpan to subtract.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     subtract(other) {
         return new TimeSpan(this.milliseconds - other.milliseconds);
     }
+    /**
+     * Adds this TimeSpan to a specified Date.
+     * @param {Date} date - The date to add to.
+     * @returns {Date} A new Date instance.
+     */
     addTo(date) {
         return new Date(date.getTime() + this.milliseconds);
     }
+    /**
+     * Subtracts this TimeSpan from a specified Date.
+     * @param {Date} date - The date to subtract from.
+     * @returns {Date} A new Date instance.
+     */
     subtractFrom(date) {
         return new Date(date.getTime() - this.milliseconds);
     }
+    /**
+     * Creates a TimeSpan from the difference between two dates.
+     * @param {Date} earlierDate - The earlier date.
+     * @param {Date} laterDate - The later date.
+     * @returns {TimeSpan} A new TimeSpan instance representing the difference.
+     */
     static fromDifference(earlierDate, laterDate) {
         return new TimeSpan(laterDate.getTime() - earlierDate.getTime());
     }
+    /**
+     * Formats the TimeSpan as a string.
+     * Supported tokens: hh, h, mm, m, ss, s.
+     * @param {string} format - The format string (default: 'hh:mm:ss').
+     * @returns {string} The formatted string.
+     */
     format(format = 'hh:mm:ss') {
         const formatLower = format.toLowerCase();
         const hasHours = formatLower.includes("h");
@@ -112,41 +257,98 @@ class TimeSpan {
             .replace('ss', secondsPadded)
             .replace('s', seconds.toString());
     }
+    /**
+     * Checks if this TimeSpan is equal to another.
+     * @param {TimeSpan} other - The other TimeSpan.
+     * @returns {boolean} True if equal.
+     */
     eq(other) {
         return this.milliseconds === other.milliseconds;
     }
+    /**
+     * Checks if this TimeSpan is less than or equal to another.
+     * @param {TimeSpan} other - The other TimeSpan.
+     * @returns {boolean} True if less than or equal.
+     */
     le(other) {
         return this.milliseconds <= other.milliseconds;
     }
+    /**
+     * Checks if this TimeSpan is less than another.
+     * @param {TimeSpan} other - The other TimeSpan.
+     * @returns {boolean} True if less than.
+     */
     lt(other) {
         return this.milliseconds < other.milliseconds;
     }
+    /**
+     * Checks if this TimeSpan is greater than or equal to another.
+     * @param {TimeSpan} other - The other TimeSpan.
+     * @returns {boolean} True if greater than or equal.
+     */
     ge(other) {
         return this.milliseconds >= other.milliseconds;
     }
+    /**
+     * Checks if this TimeSpan is greater than another.
+     * @param {TimeSpan} other - The other TimeSpan.
+     * @returns {boolean} True if greater than.
+     */
     gt(other) {
         return this.milliseconds > other.milliseconds;
     }
+    /**
+     * Multiplies the TimeSpan by a number.
+     * @param {number} number - The multiplier.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     multiply(number) {
         return new TimeSpan(this.milliseconds * number);
     }
+    /**
+     * Divides the TimeSpan by a number.
+     * @param {number} number - The divisor.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     divide(number) {
         return new TimeSpan(this.milliseconds / number);
     }
+    /**
+     * Returns the absolute value of the TimeSpan.
+     * @returns {TimeSpan} A new TimeSpan instance.
+     */
     abs() {
         return new TimeSpan(Math.abs(this.milliseconds));
     }
+    /**
+     * Checks if the TimeSpan is infinite.
+     * @returns {boolean} True if infinite.
+     */
     isInfinite() {
         return this.milliseconds === Number.POSITIVE_INFINITY || this.milliseconds === Number.NEGATIVE_INFINITY;
     }
+    /**
+     * Checks if the TimeSpan is positive infinite.
+     * @returns {boolean} True if positive infinite.
+     */
     isPositiveInfinite() {
         return this.milliseconds === Number.POSITIVE_INFINITY;
     }
+    /**
+     * Checks if the TimeSpan is negative infinite.
+     * @returns {boolean} True if negative infinite.
+     */
     isNegativeInfinite() {
         return this.milliseconds === Number.NEGATIVE_INFINITY;
     }
 }
+/**
+ * Infinite duration.
+ */
 TimeSpan.INFINITE = new TimeSpan(Number.POSITIVE_INFINITY);
+/**
+ * Negative infinite duration.
+ */
 TimeSpan.NEGATIVE_INFINITE = new TimeSpan(Number.NEGATIVE_INFINITY);
 exports.default = TimeSpan;
 //# sourceMappingURL=timespan.js.map