@develia/commons 0.5.0 → 0.6.1

package/dist/stopwatch.js

@@ -2,7 +2,7 @@ import TimeSpan from "./timespan.js";
 export default class Stopwatch {
     constructor() {
         this.startTime = null;
-        this.elapsedTime = null;
+        this.elapsedMilliseconds = null;
     }
     /*static measure<T>(callback: () => T, measure: { value: TimeSpan | null }): T {
         const stopwatch = new Stopwatch();
@@ -11,30 +11,30 @@ export default class Stopwatch {
             return callback();
         } finally {
             stopwatch.stop();
-            measure.value = stopwatch.getElapsedTime();
+            measure.value = stopwatch.elapsedTime;
         }
     }*/
     start() {
         this.startTime = performance.now();
-        this.elapsedTime = null;
+        this.elapsedMilliseconds = null;
     }
     stop() {
         if (this.startTime !== null) {
-            this.elapsedTime = performance.now() - this.startTime;
+            this.elapsedMilliseconds = performance.now() - this.startTime;
             this.startTime = null;
         }
     }
     resume() {
-        if (this.elapsedTime !== null) {
-            this.startTime = performance.now() - this.elapsedTime;
-            this.elapsedTime = null;
+        if (this.elapsedMilliseconds !== null) {
+            this.startTime = performance.now() - this.elapsedMilliseconds;
+            this.elapsedMilliseconds = null;
         }
     }
-    getElapsedTime() {
+    get elapsedTime() {
         if (this.startTime !== null) {
             return TimeSpan.fromMilliseconds(performance.now() - this.startTime);
         }
-        return TimeSpan.fromMilliseconds(this.elapsedTime ?? 0.0);
+        return TimeSpan.fromMilliseconds(this.elapsedMilliseconds ?? 0.0);
     }
 }
 //# sourceMappingURL=stopwatch.js.map

package/dist/stopwatch.js.map

@@ -1 +1 @@
-{"version":3,"file":"stopwatch.js","sourceRoot":"","sources":["../src/stopwatch.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,MAAM,CAAC,OAAO,OAAO,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,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC,CAAC;IAC9D,CAAC;CACJ","sourcesContent":["import TimeSpan from \"./timespan.js\";\n\nexport default class Stopwatch {\n    private startTime: number | null = null;\n    private elapsedTime: number | null = null;\n\n    /*static measure<T>(callback: () => T, measure: { value: TimeSpan | null }): T {\n        const stopwatch = new Stopwatch();\n        stopwatch.start();\n        try {\n            return callback();\n        } finally {\n            stopwatch.stop();\n            measure.value = stopwatch.getElapsedTime();\n        }\n    }*/\n\n    start(): void {\n        this.startTime = performance.now();\n        this.elapsedTime = null;\n    }\n\n    stop(): void {\n        if (this.startTime !== null) {\n            this.elapsedTime = performance.now() - this.startTime;\n            this.startTime = null;\n        }\n    }\n\n    resume(): void {\n        if (this.elapsedTime !== null) {\n            this.startTime = performance.now() - this.elapsedTime;\n            this.elapsedTime = null;\n        }\n    }\n\n    getElapsedTime(): TimeSpan {\n        if (this.startTime !== null) {\n            return TimeSpan.fromMilliseconds(performance.now() - this.startTime);\n        }\n        return TimeSpan.fromMilliseconds(this.elapsedTime ?? 0.0);\n    }\n}\n"]}
+{"version":3,"file":"stopwatch.js","sourceRoot":"","sources":["../src/stopwatch.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,eAAe,CAAC;AAErC,MAAM,CAAC,OAAO,OAAO,SAAS;IAA9B;QACY,cAAS,GAAkB,IAAI,CAAC;QAChC,wBAAmB,GAAkB,IAAI,CAAC;IAsCtD,CAAC;IApCG;;;;;;;;;OASG;IAEH,KAAK;QACD,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;IACpC,CAAC;IAED,IAAI;QACA,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC1B,IAAI,CAAC,mBAAmB,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC;YAC9D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAC1B,CAAC;IACL,CAAC;IAED,MAAM;QACF,IAAI,IAAI,CAAC,mBAAmB,KAAK,IAAI,EAAE,CAAC;YACpC,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,mBAAmB,CAAC;YAC9D,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;QACpC,CAAC;IACL,CAAC;IAED,IAAI,WAAW;QACX,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC,gBAAgB,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,mBAAmB,IAAI,GAAG,CAAC,CAAC;IACtE,CAAC;CACJ","sourcesContent":["import TimeSpan from \"./timespan.js\";\n\nexport default class Stopwatch {\n    private startTime: number | null = null;\n    private elapsedMilliseconds: number | null = null;\n\n    /*static measure<T>(callback: () => T, measure: { value: TimeSpan | null }): T {\n        const stopwatch = new Stopwatch();\n        stopwatch.start();\n        try {\n            return callback();\n        } finally {\n            stopwatch.stop();\n            measure.value = stopwatch.elapsedTime;\n        }\n    }*/\n\n    start(): void {\n        this.startTime = performance.now();\n        this.elapsedMilliseconds = null;\n    }\n\n    stop(): void {\n        if (this.startTime !== null) {\n            this.elapsedMilliseconds = performance.now() - this.startTime;\n            this.startTime = null;\n        }\n    }\n\n    resume(): void {\n        if (this.elapsedMilliseconds !== null) {\n            this.startTime = performance.now() - this.elapsedMilliseconds;\n            this.elapsedMilliseconds = null;\n        }\n    }\n\n    get elapsedTime(): TimeSpan {\n        if (this.startTime !== null) {\n            return TimeSpan.fromMilliseconds(performance.now() - this.startTime);\n        }\n        return TimeSpan.fromMilliseconds(this.elapsedMilliseconds ?? 0.0);\n    }\n}\n"]}

package/dist/string.d.ts

@@ -73,4 +73,14 @@ export declare function toPascalCase(str: string): string;
  * @return {string} - The string converted to CONSTANT_CASE.
  */
 export declare function toConstantCase(str: string): string;
+/**
+ * Formats a size in bytes with the largest unit it fills, in powers of 1024: `340 B`, `1.2 MB`.
+ *
+ * Bytes are written whole and the larger units with at most one decimal, with the separators of the locale.
+ *
+ * @param {number} bytes - The size in bytes; a negative or non-finite size is formatted as zero.
+ * @param {string} [locale] - The locale of the number, such as `es-ES`; the one of the runtime when omitted.
+ * @return {string} The number, a space and the unit.
+ */
+export declare function formatFileSize(bytes: number, locale?: string): string;
 //# sourceMappingURL=string.d.ts.map

package/dist/string.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIhE;AAGD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAEzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAgB/D;AA0BD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD"}
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../src/string.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIhE;AAGD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAEzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIpD;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,MAAM,CAgB/D;AA0BD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAM/C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAID;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAWrE"}

package/dist/string.js

@@ -144,4 +144,24 @@ export function toPascalCase(str) {
 export function toConstantCase(str) {
     return toWords(str).join('_').toUpperCase();
 }
+const FILE_SIZE_UNITS = Object.freeze(['B', 'KB', 'MB', 'GB', 'TB', 'PB']);
+/**
+ * Formats a size in bytes with the largest unit it fills, in powers of 1024: `340 B`, `1.2 MB`.
+ *
+ * Bytes are written whole and the larger units with at most one decimal, with the separators of the locale.
+ *
+ * @param {number} bytes - The size in bytes; a negative or non-finite size is formatted as zero.
+ * @param {string} [locale] - The locale of the number, such as `es-ES`; the one of the runtime when omitted.
+ * @return {string} The number, a space and the unit.
+ */
+export function formatFileSize(bytes, locale) {
+    let size = Number.isFinite(bytes) && bytes > 0 ? bytes : 0;
+    let unitIndex = 0;
+    while (size >= 1024 && unitIndex < FILE_SIZE_UNITS.length - 1) {
+        size /= 1024;
+        unitIndex++;
+    }
+    const maximumFractionDigits = unitIndex === 0 ? 0 : 1;
+    return `${size.toLocaleString(locale, { maximumFractionDigits })} ${FILE_SIZE_UNITS[unitIndex]}`;
+}
 //# sourceMappingURL=string.js.map

package/dist/string.js.map

@@ -1 +1 @@
-{"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 * Null for an empty string, as `Str::nullIfEmpty()` of develia/commons for PHP; any other string as it is. Compose it\n * with `trim()` to turn a blank string into null: `nullIfEmpty(value.trim())`.\n */\nexport function nullIfEmpty(str: string | null | undefined): string | null {\n    return str === undefined || str === null || str === '' ? null : str;\n}\n\n/**\n * Normalizes Unicode whitespaces into single ASCII spaces and removes leading\n * and trailing whitespace.\n */\nexport function normalizeWhitespaces(str: string): string {\n    return str.replace(/[\\s\\u200B\\uFEFF]+/gu, ' ').trim();\n}\n\n/**\n * Removes Unicode diacritics while preserving the original letter casing.\n *\n * @example removeDiacritics('áÁñÑ') // 'aAnN'\n */\nexport function removeDiacritics(str: string): string {\n    return str\n        .normalize('NFD')\n        .replace(/\\p{M}+/gu, '')\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    const hasNamedPlaceholders = /{(?!\\d+})[^{}]+}/.test(template);\n    if (args.length === 1 && args[0] !== null && typeof args[0] === 'object' && hasNamedPlaceholders) {\n        args = args[0];\n        regex = /{(.+?)}/g;\n    } else {\n        regex = /{(\\d+?)}/g;\n    }\n\n    return template.replace(regex, (match, key) => {\n        return Object.prototype.hasOwnProperty.call(args, key) && typeof args[key] !== 'undefined'\n            ? args[key]\n            : \"\";\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(/([\\p{Ll}\\p{N}])(\\p{Lu})/gu, '$1 $2')\n        // Insert a space between consecutive uppercase letters followed by a lowercase letter (XMLParser -> XML Parser)\n        .replace(/(\\p{Lu}+)(\\p{Lu}\\p{Ll})/gu, '$1 $2')\n        // Replace any non-alphanumeric character with a space\n        .replace(/[^\\p{L}\\p{N}]+/gu, ' ')\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}\n"]}
+{"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 * Null for an empty string, as `Str::nullIfEmpty()` of develia/commons for PHP; any other string as it is. Compose it\n * with `trim()` to turn a blank string into null: `nullIfEmpty(value.trim())`.\n */\nexport function nullIfEmpty(str: string | null | undefined): string | null {\n    return str === undefined || str === null || str === '' ? null : str;\n}\n\n/**\n * Normalizes Unicode whitespaces into single ASCII spaces and removes leading\n * and trailing whitespace.\n */\nexport function normalizeWhitespaces(str: string): string {\n    return str.replace(/[\\s\\u200B\\uFEFF]+/gu, ' ').trim();\n}\n\n/**\n * Removes Unicode diacritics while preserving the original letter casing.\n *\n * @example removeDiacritics('áÁñÑ') // 'aAnN'\n */\nexport function removeDiacritics(str: string): string {\n    return str\n        .normalize('NFD')\n        .replace(/\\p{M}+/gu, '')\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    const hasNamedPlaceholders = /{(?!\\d+})[^{}]+}/.test(template);\n    if (args.length === 1 && args[0] !== null && typeof args[0] === 'object' && hasNamedPlaceholders) {\n        args = args[0];\n        regex = /{(.+?)}/g;\n    } else {\n        regex = /{(\\d+?)}/g;\n    }\n\n    return template.replace(regex, (match, key) => {\n        return Object.prototype.hasOwnProperty.call(args, key) && typeof args[key] !== 'undefined'\n            ? args[key]\n            : \"\";\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(/([\\p{Ll}\\p{N}])(\\p{Lu})/gu, '$1 $2')\n        // Insert a space between consecutive uppercase letters followed by a lowercase letter (XMLParser -> XML Parser)\n        .replace(/(\\p{Lu}+)(\\p{Lu}\\p{Ll})/gu, '$1 $2')\n        // Replace any non-alphanumeric character with a space\n        .replace(/[^\\p{L}\\p{N}]+/gu, ' ')\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}\n\nconst FILE_SIZE_UNITS: readonly string[] = Object.freeze(['B', 'KB', 'MB', 'GB', 'TB', 'PB']);\n\n/**\n * Formats a size in bytes with the largest unit it fills, in powers of 1024: `340 B`, `1.2 MB`.\n *\n * Bytes are written whole and the larger units with at most one decimal, with the separators of the locale.\n *\n * @param {number} bytes - The size in bytes; a negative or non-finite size is formatted as zero.\n * @param {string} [locale] - The locale of the number, such as `es-ES`; the one of the runtime when omitted.\n * @return {string} The number, a space and the unit.\n */\nexport function formatFileSize(bytes: number, locale?: string): string {\n    let size = Number.isFinite(bytes) && bytes > 0 ? bytes : 0;\n    let unitIndex = 0;\n    while (size >= 1024 && unitIndex < FILE_SIZE_UNITS.length - 1) {\n        size /= 1024;\n        unitIndex++;\n    }\n\n    const maximumFractionDigits = unitIndex === 0 ? 0 : 1;\n\n    return `${size.toLocaleString(locale, {maximumFractionDigits})} ${FILE_SIZE_UNITS[unitIndex]}`;\n}\n"]}

package/dist/timespan.d.ts

@@ -5,30 +5,25 @@ export default class TimeSpan {
     milliseconds: number;
     private constructor();
     /**
-     * Gets the time interval in seconds.
-     * @returns {number} The duration in seconds.
+     * The whole duration in seconds.
      */
-    getTotalSeconds(): number;
+    get totalSeconds(): number;
     /**
-     * Gets the time interval in minutes.
-     * @returns {number} The duration in minutes.
+     * The whole duration in minutes.
      */
-    getTotalMinutes(): number;
+    get totalMinutes(): number;
     /**
-     * Gets the time interval in hours.
-     * @returns {number} The duration in hours.
+     * The whole duration in hours.
      */
-    getTotalHours(): number;
+    get totalHours(): number;
     /**
-     * Gets the time interval in days.
-     * @returns {number} The duration in days.
+     * The whole duration in days.
      */
-    getTotalDays(): number;
+    get totalDays(): number;
     /**
-     * Gets the time interval in weeks.
-     * @returns {number} The duration in weeks.
+     * The whole duration in weeks.
      */
-    getTotalWeeks(): number;
+    get totalWeeks(): number;
     /**
      * Creates a TimeSpan from a specified number of milliseconds.
      * @param {number} milliseconds - The number of milliseconds.

package/dist/timespan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timespan.d.ts","sourceRoot":"","sources":["../src/timespan.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"timespan.d.ts","sourceRoot":"","sources":["../src/timespan.ts"],"names":[],"mappings":"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"}

package/dist/timespan.js

@@ -6,38 +6,33 @@ class TimeSpan {
         this.milliseconds = milliseconds;
     }
     /**
-     * Gets the time interval in seconds.
-     * @returns {number} The duration in seconds.
+     * The whole duration in seconds.
      */
-    getTotalSeconds() {
+    get totalSeconds() {
         return this.milliseconds / 1000;
     }
     /**
-     * Gets the time interval in minutes.
-     * @returns {number} The duration in minutes.
+     * The whole duration in minutes.
      */
-    getTotalMinutes() {
+    get totalMinutes() {
         return this.milliseconds / (1000 * 60);
     }
     /**
-     * Gets the time interval in hours.
-     * @returns {number} The duration in hours.
+     * The whole duration in hours.
      */
-    getTotalHours() {
+    get totalHours() {
         return this.milliseconds / (1000 * 60 * 60);
     }
     /**
-     * Gets the time interval in days.
-     * @returns {number} The duration in days.
+     * The whole duration in days.
      */
-    getTotalDays() {
+    get totalDays() {
         return this.milliseconds / (1000 * 60 * 60 * 24);
     }
     /**
-     * Gets the time interval in weeks.
-     * @returns {number} The duration in weeks.
+     * The whole duration in weeks.
      */
-    getTotalWeeks() {
+    get totalWeeks() {
         return this.milliseconds / (1000 * 60 * 60 * 24 * 7);
     }
     /**

package/dist/timespan.js.map

@@ -1 +1 @@
-{"version":3,"file":"timespan.js","sourceRoot":"","sources":["../src/timespan.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Represents a duration of time in milliseconds.\n */\nexport default class TimeSpan {\n    public milliseconds: number;\n\n    private constructor(milliseconds: number) {\n        this.milliseconds = milliseconds;\n    }\n\n\n    /**\n     * Gets the time interval in seconds.\n     * @returns {number} The duration in seconds.\n     */\n    getTotalSeconds(): number {\n        return this.milliseconds / 1000;\n    }\n\n    /**\n     * Gets the time interval in minutes.\n     * @returns {number} The duration in minutes.\n     */\n    getTotalMinutes(): number {\n        return this.milliseconds / (1000 * 60);\n    }\n\n    /**\n     * Gets the time interval in hours.\n     * @returns {number} The duration in hours.\n     */\n    getTotalHours(): number {\n        return this.milliseconds / (1000 * 60 * 60);\n    }\n\n    /**\n     * Gets the time interval in days.\n     * @returns {number} The duration in days.\n     */\n    getTotalDays(): number {\n        return this.milliseconds / (1000 * 60 * 60 * 24);\n    }\n\n    /**\n     * Gets the time interval in weeks.\n     * @returns {number} The duration in weeks.\n     */\n    getTotalWeeks(): number {\n        return this.milliseconds / (1000 * 60 * 60 * 24 * 7);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of milliseconds.\n     * @param {number} milliseconds - The number of milliseconds.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromMilliseconds(milliseconds: number): TimeSpan {\n        return new TimeSpan(milliseconds);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of seconds.\n     * @param {number} seconds - The number of seconds.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromSeconds(seconds: number): TimeSpan {\n        return new TimeSpan(seconds * 1000);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of minutes.\n     * @param {number} minutes - The number of minutes.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromMinutes(minutes: number): TimeSpan {\n        return new TimeSpan(minutes * 1000 * 60);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of hours.\n     * @param {number} hours - The number of hours.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromHours(hours: number): TimeSpan {\n        return new TimeSpan(hours * 1000 * 60 * 60);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of days.\n     * @param {number} days - The number of days.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromDays(days: number): TimeSpan {\n        return new TimeSpan(days * 1000 * 60 * 60 * 24);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of weeks.\n     * @param {number} weeks - The number of weeks.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromWeeks(weeks: number): TimeSpan {\n        return new TimeSpan(weeks * 1000 * 60 * 60 * 24 * 7);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of milliseconds to this instance.\n     * @param {number} milliseconds - The milliseconds to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addMilliseconds(milliseconds: number): TimeSpan {\n        return new TimeSpan(this.milliseconds + milliseconds);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of seconds to this instance.\n     * @param {number} seconds - The seconds to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addSeconds(seconds: number): TimeSpan {\n        return this.addMilliseconds(seconds * 1000);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of minutes to this instance.\n     * @param {number} minutes - The minutes to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addMinutes(minutes: number): TimeSpan {\n        return this.addMilliseconds(minutes * 1000 * 60);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of hours to this instance.\n     * @param {number} hours - The hours to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addHours(hours: number): TimeSpan {\n        return this.addMilliseconds(hours * 1000 * 60 * 60);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of days to this instance.\n     * @param {number} days - The days to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addDays(days: number): TimeSpan {\n        return this.addMilliseconds(days * 1000 * 60 * 60 * 24);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of weeks to this instance.\n     * @param {number} weeks - The weeks to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addWeeks(weeks: number): TimeSpan {\n        return this.addMilliseconds(weeks * 1000 * 60 * 60 * 24 * 7);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of milliseconds from this instance.\n     * @param {number} milliseconds - The milliseconds to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractMilliseconds(milliseconds: number): TimeSpan {\n        return new TimeSpan(this.milliseconds - milliseconds);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of seconds from this instance.\n     * @param {number} seconds - The seconds to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractSeconds(seconds: number): TimeSpan {\n        return this.subtractMilliseconds(seconds * 1000);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of minutes from this instance.\n     * @param {number} minutes - The minutes to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractMinutes(minutes: number): TimeSpan {\n        return this.subtractMilliseconds(minutes * 1000 * 60);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of hours from this instance.\n     * @param {number} hours - The hours to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractHours(hours: number): TimeSpan {\n        return this.subtractMilliseconds(hours * 1000 * 60 * 60);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of days from this instance.\n     * @param {number} days - The days to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractDays(days: number): TimeSpan {\n        return this.subtractMilliseconds(days * 1000 * 60 * 60 * 24);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of weeks from this instance.\n     * @param {number} weeks - The weeks to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractWeeks(weeks: number): TimeSpan {\n        return this.subtractMilliseconds(weeks * 1000 * 60 * 60 * 24 * 7);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified TimeSpan to this instance.\n     * @param {TimeSpan} other - The TimeSpan to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    add(other: TimeSpan): TimeSpan {\n        return new TimeSpan(this.milliseconds + other.milliseconds);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified TimeSpan from this instance.\n     * @param {TimeSpan} other - The TimeSpan to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtract(other: TimeSpan): TimeSpan {\n        return new TimeSpan(this.milliseconds - other.milliseconds);\n    }\n\n    /**\n     * Adds this TimeSpan to a specified Date.\n     * @param {Date} date - The date to add to.\n     * @returns {Date} A new Date instance.\n     */\n    addTo(date: Date): Date {\n        return new Date(date.getTime() + this.milliseconds);\n    }\n\n    /**\n     * Subtracts this TimeSpan from a specified Date.\n     * @param {Date} date - The date to subtract from.\n     * @returns {Date} A new Date instance.\n     */\n    subtractFrom(date: Date): Date {\n        return new Date(date.getTime() - this.milliseconds);\n    }\n\n    /**\n     * Creates a TimeSpan from the difference between two dates.\n     * @param {Date} earlierDate - The earlier date.\n     * @param {Date} laterDate - The later date.\n     * @returns {TimeSpan} A new TimeSpan instance representing the difference.\n     */\n    static fromDifference(earlierDate: Date, laterDate: Date): TimeSpan {\n        return new TimeSpan(laterDate.getTime() - earlierDate.getTime());\n    }\n\n    /**\n     * Formats the TimeSpan as a string.\n     * Supported tokens: hh, h, mm, m, ss, s.\n     * @param {string} format - The format string (default: 'hh:mm:ss').\n     * @returns {string} The formatted string.\n     */\n    format(format: string = 'hh:mm:ss'): string {\n        const formatLower = format.toLowerCase();\n        const hasHours = formatLower.includes(\"h\");\n        const hasMinutes = formatLower.includes(\"m\");\n\n        const sign = this.milliseconds < 0 ? \"-\" : \"\";\n        let hours = 0, minutes = 0, seconds = Math.floor(Math.abs(this.milliseconds) / 1000);\n\n        if (hasHours) {\n            hours = Math.floor(seconds / 3600);\n            seconds -= hours * 3600;\n        }\n        if (hasMinutes) {\n            minutes = Math.floor(seconds / 60);\n            seconds -= minutes * 60;\n        }\n\n        const hoursPadded = String(hours).padStart(2, '0');\n        const minutesPadded = String(minutes).padStart(2, '0');\n        const secondsPadded = String(seconds).padStart(2, '0');\n\n        const formatted = formatLower.replace(/hh|h|mm|m|ss|s/g, token => {\n            switch (token) {\n                case 'hh':\n                    return hoursPadded;\n                case 'h':\n                    return hours.toString();\n                case 'mm':\n                    return minutesPadded;\n                case 'm':\n                    return minutes.toString();\n                case 'ss':\n                    return secondsPadded;\n                case 's':\n                    return seconds.toString();\n                default:\n                    return token;\n            }\n        });\n\n        return sign + formatted;\n    }\n\n    /**\n     * Checks if this TimeSpan is equal to another.\n     * @param {TimeSpan} other - The other TimeSpan.\n     * @returns {boolean} True if equal.\n     */\n    eq(other: TimeSpan): boolean {\n        return this.milliseconds === other.milliseconds;\n    }\n\n    /**\n     * Checks if this TimeSpan is less than or equal to another.\n     * @param {TimeSpan} other - The other TimeSpan.\n     * @returns {boolean} True if less than or equal.\n     */\n    le(other: TimeSpan): boolean {\n        return this.milliseconds <= other.milliseconds;\n    }\n\n    /**\n     * Checks if this TimeSpan is less than another.\n     * @param {TimeSpan} other - The other TimeSpan.\n     * @returns {boolean} True if less than.\n     */\n    lt(other: TimeSpan): boolean {\n        return this.milliseconds < other.milliseconds;\n    }\n\n    /**\n     * Checks if this TimeSpan is greater than or equal to another.\n     * @param {TimeSpan} other - The other TimeSpan.\n     * @returns {boolean} True if greater than or equal.\n     */\n    ge(other: TimeSpan): boolean {\n        return this.milliseconds >= other.milliseconds;\n    }\n\n    /**\n     * Checks if this TimeSpan is greater than another.\n     * @param {TimeSpan} other - The other TimeSpan.\n     * @returns {boolean} True if greater than.\n     */\n    gt(other: TimeSpan): boolean {\n        return this.milliseconds > other.milliseconds;\n    }\n\n    /**\n     * Multiplies the TimeSpan by a number.\n     * @param {number} number - The multiplier.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    multiply(number: number): TimeSpan {\n        return new TimeSpan(this.milliseconds * number);\n    }\n\n    /**\n     * Divides the TimeSpan by a number.\n     * @param {number} number - The divisor.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    divide(number: number): TimeSpan {\n        return new TimeSpan(this.milliseconds / number);\n    }\n\n    /**\n     * Returns the absolute value of the TimeSpan.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    abs(): TimeSpan {\n        return new TimeSpan(Math.abs(this.milliseconds));\n    }\n\n    /**\n     * Infinite duration.\n     */\n    static readonly INFINITE = new TimeSpan(Number.POSITIVE_INFINITY);\n\n    /**\n     * Negative infinite duration.\n     */\n    static readonly NEGATIVE_INFINITE = new TimeSpan(Number.NEGATIVE_INFINITY);\n\n    /**\n     * Checks if the TimeSpan is infinite.\n     * @returns {boolean} True if infinite.\n     */\n    isInfinite() {\n        return this.milliseconds === Number.POSITIVE_INFINITY || this.milliseconds === Number.NEGATIVE_INFINITY\n    }\n\n    /**\n     * Checks if the TimeSpan is positive infinite.\n     * @returns {boolean} True if positive infinite.\n     */\n    isPositiveInfinite(): boolean {\n        return this.milliseconds === Number.POSITIVE_INFINITY;\n    }\n\n    /**\n     * Checks if the TimeSpan is negative infinite.\n     * @returns {boolean} True if negative infinite.\n     */\n    isNegativeInfinite(): boolean {\n        return this.milliseconds === Number.NEGATIVE_INFINITY;\n    }\n}"]}
+{"version":3,"file":"timespan.js","sourceRoot":"","sources":["../src/timespan.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Represents a duration of time in milliseconds.\n */\nexport default class TimeSpan {\n    public milliseconds: number;\n\n    private constructor(milliseconds: number) {\n        this.milliseconds = milliseconds;\n    }\n\n\n    /**\n     * The whole duration in seconds.\n     */\n    get totalSeconds(): number {\n        return this.milliseconds / 1000;\n    }\n\n    /**\n     * The whole duration in minutes.\n     */\n    get totalMinutes(): number {\n        return this.milliseconds / (1000 * 60);\n    }\n\n    /**\n     * The whole duration in hours.\n     */\n    get totalHours(): number {\n        return this.milliseconds / (1000 * 60 * 60);\n    }\n\n    /**\n     * The whole duration in days.\n     */\n    get totalDays(): number {\n        return this.milliseconds / (1000 * 60 * 60 * 24);\n    }\n\n    /**\n     * The whole duration in weeks.\n     */\n    get totalWeeks(): number {\n        return this.milliseconds / (1000 * 60 * 60 * 24 * 7);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of milliseconds.\n     * @param {number} milliseconds - The number of milliseconds.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromMilliseconds(milliseconds: number): TimeSpan {\n        return new TimeSpan(milliseconds);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of seconds.\n     * @param {number} seconds - The number of seconds.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromSeconds(seconds: number): TimeSpan {\n        return new TimeSpan(seconds * 1000);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of minutes.\n     * @param {number} minutes - The number of minutes.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromMinutes(minutes: number): TimeSpan {\n        return new TimeSpan(minutes * 1000 * 60);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of hours.\n     * @param {number} hours - The number of hours.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromHours(hours: number): TimeSpan {\n        return new TimeSpan(hours * 1000 * 60 * 60);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of days.\n     * @param {number} days - The number of days.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromDays(days: number): TimeSpan {\n        return new TimeSpan(days * 1000 * 60 * 60 * 24);\n    }\n\n    /**\n     * Creates a TimeSpan from a specified number of weeks.\n     * @param {number} weeks - The number of weeks.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    static fromWeeks(weeks: number): TimeSpan {\n        return new TimeSpan(weeks * 1000 * 60 * 60 * 24 * 7);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of milliseconds to this instance.\n     * @param {number} milliseconds - The milliseconds to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addMilliseconds(milliseconds: number): TimeSpan {\n        return new TimeSpan(this.milliseconds + milliseconds);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of seconds to this instance.\n     * @param {number} seconds - The seconds to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addSeconds(seconds: number): TimeSpan {\n        return this.addMilliseconds(seconds * 1000);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of minutes to this instance.\n     * @param {number} minutes - The minutes to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addMinutes(minutes: number): TimeSpan {\n        return this.addMilliseconds(minutes * 1000 * 60);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of hours to this instance.\n     * @param {number} hours - The hours to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addHours(hours: number): TimeSpan {\n        return this.addMilliseconds(hours * 1000 * 60 * 60);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of days to this instance.\n     * @param {number} days - The days to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addDays(days: number): TimeSpan {\n        return this.addMilliseconds(days * 1000 * 60 * 60 * 24);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified number of weeks to this instance.\n     * @param {number} weeks - The weeks to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    addWeeks(weeks: number): TimeSpan {\n        return this.addMilliseconds(weeks * 1000 * 60 * 60 * 24 * 7);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of milliseconds from this instance.\n     * @param {number} milliseconds - The milliseconds to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractMilliseconds(milliseconds: number): TimeSpan {\n        return new TimeSpan(this.milliseconds - milliseconds);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of seconds from this instance.\n     * @param {number} seconds - The seconds to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractSeconds(seconds: number): TimeSpan {\n        return this.subtractMilliseconds(seconds * 1000);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of minutes from this instance.\n     * @param {number} minutes - The minutes to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractMinutes(minutes: number): TimeSpan {\n        return this.subtractMilliseconds(minutes * 1000 * 60);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of hours from this instance.\n     * @param {number} hours - The hours to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractHours(hours: number): TimeSpan {\n        return this.subtractMilliseconds(hours * 1000 * 60 * 60);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of days from this instance.\n     * @param {number} days - The days to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractDays(days: number): TimeSpan {\n        return this.subtractMilliseconds(days * 1000 * 60 * 60 * 24);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified number of weeks from this instance.\n     * @param {number} weeks - The weeks to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtractWeeks(weeks: number): TimeSpan {\n        return this.subtractMilliseconds(weeks * 1000 * 60 * 60 * 24 * 7);\n    }\n\n    /**\n     * Returns a new TimeSpan that adds the specified TimeSpan to this instance.\n     * @param {TimeSpan} other - The TimeSpan to add.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    add(other: TimeSpan): TimeSpan {\n        return new TimeSpan(this.milliseconds + other.milliseconds);\n    }\n\n    /**\n     * Returns a new TimeSpan that subtracts the specified TimeSpan from this instance.\n     * @param {TimeSpan} other - The TimeSpan to subtract.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    subtract(other: TimeSpan): TimeSpan {\n        return new TimeSpan(this.milliseconds - other.milliseconds);\n    }\n\n    /**\n     * Adds this TimeSpan to a specified Date.\n     * @param {Date} date - The date to add to.\n     * @returns {Date} A new Date instance.\n     */\n    addTo(date: Date): Date {\n        return new Date(date.getTime() + this.milliseconds);\n    }\n\n    /**\n     * Subtracts this TimeSpan from a specified Date.\n     * @param {Date} date - The date to subtract from.\n     * @returns {Date} A new Date instance.\n     */\n    subtractFrom(date: Date): Date {\n        return new Date(date.getTime() - this.milliseconds);\n    }\n\n    /**\n     * Creates a TimeSpan from the difference between two dates.\n     * @param {Date} earlierDate - The earlier date.\n     * @param {Date} laterDate - The later date.\n     * @returns {TimeSpan} A new TimeSpan instance representing the difference.\n     */\n    static fromDifference(earlierDate: Date, laterDate: Date): TimeSpan {\n        return new TimeSpan(laterDate.getTime() - earlierDate.getTime());\n    }\n\n    /**\n     * Formats the TimeSpan as a string.\n     * Supported tokens: hh, h, mm, m, ss, s.\n     * @param {string} format - The format string (default: 'hh:mm:ss').\n     * @returns {string} The formatted string.\n     */\n    format(format: string = 'hh:mm:ss'): string {\n        const formatLower = format.toLowerCase();\n        const hasHours = formatLower.includes(\"h\");\n        const hasMinutes = formatLower.includes(\"m\");\n\n        const sign = this.milliseconds < 0 ? \"-\" : \"\";\n        let hours = 0, minutes = 0, seconds = Math.floor(Math.abs(this.milliseconds) / 1000);\n\n        if (hasHours) {\n            hours = Math.floor(seconds / 3600);\n            seconds -= hours * 3600;\n        }\n        if (hasMinutes) {\n            minutes = Math.floor(seconds / 60);\n            seconds -= minutes * 60;\n        }\n\n        const hoursPadded = String(hours).padStart(2, '0');\n        const minutesPadded = String(minutes).padStart(2, '0');\n        const secondsPadded = String(seconds).padStart(2, '0');\n\n        const formatted = formatLower.replace(/hh|h|mm|m|ss|s/g, token => {\n            switch (token) {\n                case 'hh':\n                    return hoursPadded;\n                case 'h':\n                    return hours.toString();\n                case 'mm':\n                    return minutesPadded;\n                case 'm':\n                    return minutes.toString();\n                case 'ss':\n                    return secondsPadded;\n                case 's':\n                    return seconds.toString();\n                default:\n                    return token;\n            }\n        });\n\n        return sign + formatted;\n    }\n\n    /**\n     * Checks if this TimeSpan is equal to another.\n     * @param {TimeSpan} other - The other TimeSpan.\n     * @returns {boolean} True if equal.\n     */\n    eq(other: TimeSpan): boolean {\n        return this.milliseconds === other.milliseconds;\n    }\n\n    /**\n     * Checks if this TimeSpan is less than or equal to another.\n     * @param {TimeSpan} other - The other TimeSpan.\n     * @returns {boolean} True if less than or equal.\n     */\n    le(other: TimeSpan): boolean {\n        return this.milliseconds <= other.milliseconds;\n    }\n\n    /**\n     * Checks if this TimeSpan is less than another.\n     * @param {TimeSpan} other - The other TimeSpan.\n     * @returns {boolean} True if less than.\n     */\n    lt(other: TimeSpan): boolean {\n        return this.milliseconds < other.milliseconds;\n    }\n\n    /**\n     * Checks if this TimeSpan is greater than or equal to another.\n     * @param {TimeSpan} other - The other TimeSpan.\n     * @returns {boolean} True if greater than or equal.\n     */\n    ge(other: TimeSpan): boolean {\n        return this.milliseconds >= other.milliseconds;\n    }\n\n    /**\n     * Checks if this TimeSpan is greater than another.\n     * @param {TimeSpan} other - The other TimeSpan.\n     * @returns {boolean} True if greater than.\n     */\n    gt(other: TimeSpan): boolean {\n        return this.milliseconds > other.milliseconds;\n    }\n\n    /**\n     * Multiplies the TimeSpan by a number.\n     * @param {number} number - The multiplier.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    multiply(number: number): TimeSpan {\n        return new TimeSpan(this.milliseconds * number);\n    }\n\n    /**\n     * Divides the TimeSpan by a number.\n     * @param {number} number - The divisor.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    divide(number: number): TimeSpan {\n        return new TimeSpan(this.milliseconds / number);\n    }\n\n    /**\n     * Returns the absolute value of the TimeSpan.\n     * @returns {TimeSpan} A new TimeSpan instance.\n     */\n    abs(): TimeSpan {\n        return new TimeSpan(Math.abs(this.milliseconds));\n    }\n\n    /**\n     * Infinite duration.\n     */\n    static readonly INFINITE = new TimeSpan(Number.POSITIVE_INFINITY);\n\n    /**\n     * Negative infinite duration.\n     */\n    static readonly NEGATIVE_INFINITE = new TimeSpan(Number.NEGATIVE_INFINITY);\n\n    /**\n     * Checks if the TimeSpan is infinite.\n     * @returns {boolean} True if infinite.\n     */\n    isInfinite() {\n        return this.milliseconds === Number.POSITIVE_INFINITY || this.milliseconds === Number.NEGATIVE_INFINITY\n    }\n\n    /**\n     * Checks if the TimeSpan is positive infinite.\n     * @returns {boolean} True if positive infinite.\n     */\n    isPositiveInfinite(): boolean {\n        return this.milliseconds === Number.POSITIVE_INFINITY;\n    }\n\n    /**\n     * Checks if the TimeSpan is negative infinite.\n     * @returns {boolean} True if negative infinite.\n     */\n    isNegativeInfinite(): boolean {\n        return this.milliseconds === Number.NEGATIVE_INFINITY;\n    }\n}"]}

package/dist/triggers.d.ts

@@ -6,7 +6,8 @@ import type { Supplier } from './types.js';
  */
 export declare class TimeTrigger<T> {
     private callback;
-    private interval;
+    /** Time that must pass between two runs. */
+    interval: TimeSpan;
     private lastRunTime;
     constructor(callback: Supplier<T | Promise<T>>, interval: TimeSpan);
     /**
@@ -21,21 +22,13 @@ export declare class TimeTrigger<T> {
      * Replaces the callback executed by this trigger.
      */
     setCallback(callback: Supplier<T | Promise<T>>): void;
-    /**
-     * Gets the configured time interval.
-     */
-    getInterval(): TimeSpan;
-    /**
-     * Replaces the configured time interval.
-     */
-    setInterval(interval: TimeSpan): void;
 }
 /**
  * Runs a callback after a configured number of checks.
  */
 export declare class CountTrigger<T> {
     private callback;
-    private interval;
+    private _interval;
     private checkCount;
     constructor(callback: Supplier<T | Promise<T>>, interval: number);
     /**
@@ -51,14 +44,12 @@ export declare class CountTrigger<T> {
      */
     setCallback(callback: Supplier<T | Promise<T>>): void;
     /**
-     * Gets the configured check interval.
+     * Number of checks after which the callback runs.
      */
-    getInterval(): number;
+    get interval(): number;
     /**
-     * Replaces the configured check interval.
-     *
      * @throws {RangeError} When the interval is less than one.
      */
-    setInterval(interval: number): void;
+    set interval(interval: number);
 }
 //# sourceMappingURL=triggers.d.ts.map

package/dist/triggers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../src/triggers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,EAAW,QAAQ,EAAC,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC;IACtB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,WAAW,CAAmB;gBAEnB,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ;IAMzE;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAYxC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IAKlC;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACI,WAAW,IAAI,QAAQ;IAI9B;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;CAK/C;AAED;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACvB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,UAAU,CAAa;gBAEZ,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM;IAKvE;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAUxC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IAKlC;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACI,WAAW,IAAI,MAAM;IAI5B;;;;OAIG;IACI,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;CAO7C"}
+{"version":3,"file":"triggers.d.ts","sourceRoot":"","sources":["../src/triggers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,aAAa,CAAC;AACxC,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,EAAW,QAAQ,EAAC,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC;IACtB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,4CAA4C;IACrC,QAAQ,EAAE,QAAQ,CAAC;IAC1B,OAAO,CAAC,WAAW,CAAmB;gBAEnB,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ;IAMzE;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAYxC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IAKlC;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;CAM/D;AAED;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACvB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,UAAU,CAAa;gBAEZ,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM;IAKvE;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAUxC;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IAKlC;;OAEG;IACI,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI5D;;OAEG;IACH,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED;;OAEG;IACH,IAAW,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAMnC;CACJ"}

package/dist/triggers.js

@@ -31,35 +31,23 @@ export class TimeTrigger {
     setCallback(callback) {
         this.callback = callback;
     }
-    /**
-     * Gets the configured time interval.
-     */
-    getInterval() {
-        return this.interval;
-    }
-    /**
-     * Replaces the configured time interval.
-     */
-    setInterval(interval) {
-        this.interval = interval;
-    }
 }
 /**
  * Runs a callback after a configured number of checks.
  */
 export class CountTrigger {
     constructor(callback, interval) {
-        this.interval = 1;
+        this._interval = 1;
         this.checkCount = 0;
         this.callback = callback;
-        this.setInterval(interval);
+        this.interval = interval;
     }
     /**
      * Executes the callback when the configured number of checks is reached.
      */
     async check() {
         this.checkCount++;
-        if (this.checkCount >= this.interval) {
+        if (this.checkCount >= this._interval) {
             return { success: true, output: await this.trigger() };
         }
         return { success: false };
@@ -78,21 +66,19 @@ export class CountTrigger {
         this.callback = callback;
     }
     /**
-     * Gets the configured check interval.
+     * Number of checks after which the callback runs.
      */
-    getInterval() {
-        return this.interval;
+    get interval() {
+        return this._interval;
     }
     /**
-     * Replaces the configured check interval.
-     *
      * @throws {RangeError} When the interval is less than one.
      */
-    setInterval(interval) {
+    set interval(interval) {
         if (interval < 1) {
             throw new RangeError('Interval must be greater than zero.');
         }
-        this.interval = interval;
+        this._interval = interval;
     }
 }
 //# sourceMappingURL=triggers.js.map

package/dist/triggers.js.map

@@ -1 +1 @@
-{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../src/triggers.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,WAAW;IAKpB,YAAmB,QAAkC,EAAE,QAAkB;QACrE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEtC,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI;eACtB,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,EACjE,CAAC;YACC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkB;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CAGJ;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IAKrB,YAAmB,QAAkC,EAAE,QAAgB;QAH/D,aAAQ,GAAW,CAAC,CAAC;QACrB,eAAU,GAAW,CAAC,CAAC;QAG3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,WAAW,CAAC,QAAgB;QAC/B,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CACJ","sourcesContent":["import type {Result} from './result.js';\nimport TimeSpan from './timespan.js';\nimport type {Nullable, Supplier} from './types.js';\n\n/**\n * Runs a callback at most once during a configured time interval.\n */\nexport class TimeTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    private interval: TimeSpan;\n    private lastRunTime: Nullable<number>;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: TimeSpan) {\n        this.callback = callback;\n        this.interval = interval;\n        this.lastRunTime = null;\n    }\n\n    /**\n     * Executes the callback when the configured interval has elapsed.\n     */\n    public async check(): Promise<Result<T>> {\n        const currentTime = performance.now();\n\n        if (this.lastRunTime === null\n            || currentTime - this.lastRunTime >= this.interval.milliseconds\n        ) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured interval.\n     */\n    public async trigger(): Promise<T> {\n        this.lastRunTime = performance.now();\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n    /**\n     * Gets the configured time interval.\n     */\n    public getInterval(): TimeSpan {\n        return this.interval;\n    }\n\n    /**\n     * Replaces the configured time interval.\n     */\n    public setInterval(interval: TimeSpan): void {\n        this.interval = interval;\n    }\n\n\n}\n\n/**\n * Runs a callback after a configured number of checks.\n */\nexport class CountTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    private interval: number = 1;\n    private checkCount: number = 0;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: number) {\n        this.callback = callback;\n        this.setInterval(interval);\n    }\n\n    /**\n     * Executes the callback when the configured number of checks is reached.\n     */\n    public async check(): Promise<Result<T>> {\n        this.checkCount++;\n\n        if (this.checkCount >= this.interval) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured check count.\n     */\n    public async trigger(): Promise<T> {\n        this.checkCount = 0;\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n    /**\n     * Gets the configured check interval.\n     */\n    public getInterval(): number {\n        return this.interval;\n    }\n\n    /**\n     * Replaces the configured check interval.\n     *\n     * @throws {RangeError} When the interval is less than one.\n     */\n    public setInterval(interval: number): void {\n        if (interval < 1) {\n            throw new RangeError('Interval must be greater than zero.');\n        }\n\n        this.interval = interval;\n    }\n}\n"]}
+{"version":3,"file":"triggers.js","sourceRoot":"","sources":["../src/triggers.ts"],"names":[],"mappings":"AAIA;;GAEG;AACH,MAAM,OAAO,WAAW;IAMpB,YAAmB,QAAkC,EAAE,QAAkB;QACrE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,MAAM,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEtC,IAAI,IAAI,CAAC,WAAW,KAAK,IAAI;eACtB,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,EACjE,CAAC;YACC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CAIJ;AAED;;GAEG;AACH,MAAM,OAAO,YAAY;IAKrB,YAAmB,QAAkC,EAAE,QAAgB;QAH/D,cAAS,GAAW,CAAC,CAAC;QACtB,eAAU,GAAW,CAAC,CAAC;QAG3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,KAAK;QACd,IAAI,CAAC,UAAU,EAAE,CAAC;QAElB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACpC,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE,EAAC,CAAC;QACzD,CAAC;QAED,OAAO,EAAC,OAAO,EAAE,KAAK,EAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACI,WAAW,CAAC,QAAkC;QACjD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAW,QAAQ,CAAC,QAAgB;QAChC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACf,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;CACJ","sourcesContent":["import type {Result} from './result.js';\nimport TimeSpan from './timespan.js';\nimport type {Nullable, Supplier} from './types.js';\n\n/**\n * Runs a callback at most once during a configured time interval.\n */\nexport class TimeTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    /** Time that must pass between two runs. */\n    public interval: TimeSpan;\n    private lastRunTime: Nullable<number>;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: TimeSpan) {\n        this.callback = callback;\n        this.interval = interval;\n        this.lastRunTime = null;\n    }\n\n    /**\n     * Executes the callback when the configured interval has elapsed.\n     */\n    public async check(): Promise<Result<T>> {\n        const currentTime = performance.now();\n\n        if (this.lastRunTime === null\n            || currentTime - this.lastRunTime >= this.interval.milliseconds\n        ) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured interval.\n     */\n    public async trigger(): Promise<T> {\n        this.lastRunTime = performance.now();\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n\n\n}\n\n/**\n * Runs a callback after a configured number of checks.\n */\nexport class CountTrigger<T> {\n    private callback: Supplier<T | Promise<T>>;\n    private _interval: number = 1;\n    private checkCount: number = 0;\n\n    public constructor(callback: Supplier<T | Promise<T>>, interval: number) {\n        this.callback = callback;\n        this.interval = interval;\n    }\n\n    /**\n     * Executes the callback when the configured number of checks is reached.\n     */\n    public async check(): Promise<Result<T>> {\n        this.checkCount++;\n\n        if (this.checkCount >= this._interval) {\n            return {success: true, output: await this.trigger()};\n        }\n\n        return {success: false};\n    }\n\n    /**\n     * Executes the callback regardless of the configured check count.\n     */\n    public async trigger(): Promise<T> {\n        this.checkCount = 0;\n        return this.callback();\n    }\n\n    /**\n     * Replaces the callback executed by this trigger.\n     */\n    public setCallback(callback: Supplier<T | Promise<T>>): void {\n        this.callback = callback;\n    }\n\n    /**\n     * Number of checks after which the callback runs.\n     */\n    public get interval(): number {\n        return this._interval;\n    }\n\n    /**\n     * @throws {RangeError} When the interval is less than one.\n     */\n    public set interval(interval: number) {\n        if (interval < 1) {\n            throw new RangeError('Interval must be greater than zero.');\n        }\n\n        this._interval = interval;\n    }\n}\n"]}

package/dist/uuid.d.ts

@@ -4,7 +4,7 @@ import { Nullable } from './types.js';
  * such as `019a4f8b-4bae-7d2e-9f10-4a5b6c7d8e9f`.
  *
  * It serializes to its string with `JSON.stringify`, so DTOs carry it as text; read those
- * strings back with {@link Uuid.parse} or {@link Uuid.parseOrThrow}.
+ * strings back with {@link Uuid.parse} or {@link Uuid.tryParse}.
  */
 export default class Uuid {
     private readonly value;
@@ -37,25 +37,25 @@ export default class Uuid {
     /**
      * Reads a UUID in canonical form, in any letter case, as {@link Uuid.isValid} accepts it.
      *
-     * @returns The UUID, or `null` when the value is not one.
+     * @throws {SyntaxError} If the value is not a UUID.
      */
-    static parse(value: unknown): Nullable<Uuid>;
+    static parse(value: string): Uuid;
     /**
-     * Reads a UUID in canonical form, in any letter case.
+     * Reads a UUID in canonical form, in any letter case, as {@link Uuid.isValid} accepts it.
      *
-     * @throws {SyntaxError} If the value is not a UUID.
+     * @returns The UUID, or `undefined` when the value is not one.
      */
-    static parseOrThrow(value: string): Uuid;
+    static tryParse(value: unknown): Uuid | undefined;
     /**
-     * Returns the RFC 9562 version, from 1 to 8, or 0 for the Nil UUID and 15 for the Max UUID.
+     * The RFC 9562 version, from 1 to 8, or 0 for the Nil UUID and 15 for the Max UUID.
      */
-    getVersion(): number;
+    get version(): number;
     /**
-     * Returns the moment a version 7 UUID encodes, with millisecond precision.
+     * The moment a version 7 UUID encodes, with millisecond precision.
      *
-     * @returns The moment, or `null` for other versions.
+     * It is `null` for other versions.
      */
-    getDate(): Nullable<Date>;
+    get date(): Nullable<Date>;
     equals(other: Uuid): boolean;
     /**
      * Returns the UUID in lowercase canonical form.

package/dist/uuid.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../src/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAQpC;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,OAAO;IAIP;;;;;OAKG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAOzB;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,GAAE,IAAiB,GAAG,IAAI;IAiBhD;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIvC;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC;IAQ5C;;;;OAIG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASxC;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;;;OAIG;IACH,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC;IASzB,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAI5B;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;IAIhB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;CAWnC"}
+{"version":3,"file":"uuid.d.ts","sourceRoot":"","sources":["../src/uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,QAAQ,EAAC,MAAM,YAAY,CAAC;AAQpC;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,OAAO;IAIP;;;;;OAKG;IACH,MAAM,CAAC,UAAU,IAAI,IAAI;IAOzB;;;;;;;;OAQG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,GAAE,IAAiB,GAAG,IAAI;IAiBhD;;;;;;OAMG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAIvC;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASjC;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS;IAQjD;;OAEG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;OAIG;IACH,IAAI,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,CAOzB;IAED,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAI5B;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB,MAAM,IAAI,MAAM;IAIhB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;CAWnC"}