@develia/commons 0.4.13 → 0.4.15

package/dist/esm/patch.js.map

@@ -1 +1 @@
-{"version":3,"file":"patch.js","sourceRoot":"","sources":["../../src/patch.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,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,MAAM,UAAU,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":"AAoBA;;;;GAIG;AACH,MAAM,UAAU,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,MAAM,UAAU,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/esm/stopwatch.js

@@ -4,6 +4,16 @@ export default 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/esm/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;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,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"}
+{"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\";\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/esm/string.js

@@ -1,13 +1,34 @@
+/**
+ * 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.
+ */
 export 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.
+ */
 export 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.
+ */
 export function format(template, ...args) {
     let regex;
     if (args.length === 1 && typeof args[0] === 'object') {
@@ -21,24 +42,53 @@ export 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.
+ */
 export 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.
+ */
 export 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.
+ */
 export function toCamelCase(str) {
     const words = toWords(str);
     if (words.length === 0)
@@ -47,11 +97,23 @@ export 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.
+ */
 export 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.
+ */
 export function toConstantCase(str) {
     return toWords(str).join('_').toUpperCase();
 }

package/dist/esm/string.js.map

@@ -1 +1 @@
-{"version":3,"file":"string.js","sourceRoot":"","sources":["../../src/string.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,MAAc;IACpD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;QACvB,OAAO,MAAM,GAAG,GAAG,CAAA;IACvB,OAAO,GAAG,CAAA;AACd,CAAC;AAUD,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,MAAc;IACpD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrB,OAAO,GAAG,GAAG,MAAM,CAAA;IACvB,OAAO,GAAG,CAAA;AACd,CAAC;AASD,MAAM,UAAU,MAAM,CAAC,QAAgB,EAAE,GAAG,IAAW;IAEnD,IAAI,KAAa,CAAC;IAClB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnD,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,KAAK,GAAG,UAAU,CAAC;IACvB,CAAC;SAAM,CAAC;QACJ,KAAK,GAAG,WAAW,CAAC;IACxB,CAAC;IAED,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1C,OAAO,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,CAAC,CAAC,CAAC;AACP,CAAC;AAUD,SAAS,OAAO,CAAC,GAAW;IACxB,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,OAAO,GAAG;SAEL,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SAEtC,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SAEzC,OAAO,CAAC,gBAAgB,EAAE,GAAG,CAAC;SAC9B,IAAI,EAAE;SACN,WAAW,EAAE;SACb,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAQD,MAAM,UAAU,WAAW,CAAC,GAAW;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAQD,MAAM,UAAU,WAAW,CAAC,GAAW;IACnC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAQD,MAAM,UAAU,WAAW,CAAC,GAAW;IACnC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAClC,OAAO,KAAK;SACP,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC/E,IAAI,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAQD,MAAM,UAAU,YAAY,CAAC,GAAW;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC;SACd,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACzD,IAAI,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC;AAQD,MAAM,UAAU,cAAc,CAAC,GAAW;IACtC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;AAChD,CAAC"}
+{"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/esm/timer.js

@@ -1,4 +1,11 @@
+/**
+ * A class representing a timer that executes a callback function at a specified interval.
+ */
 export default class Timer {
+    /**
+     * @param callback Callback
+     * @param interval Seconds between calls
+     */
     constructor(callback, interval) {
         this._callback = callback;
         this._interval = interval;

package/dist/esm/timer.js.map

@@ -1 +1 @@
-{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../src/timer.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,OAAO,OAAO,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"}
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../src/timer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,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","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/esm/timespan.js

@@ -1,91 +1,236 @@
+/**
+ * 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");
@@ -110,41 +255,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);
 export default TimeSpan;
 //# sourceMappingURL=timespan.js.map

package/dist/esm/timespan.js.map

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

package/dist/esm/type-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"type-code.js","sourceRoot":"","sources":["../../src/type-code.ts"],"names":[],"mappings":"AAAA,IAAK,QAYJ;AAZD,WAAK,QAAQ;IACT,6BAAoB,CAAA;IACpB,6BAAoB,CAAA;IACpB,+BAAqB,CAAA;IACrB,6BAAoB,CAAA;IACpB,6BAAoB,CAAA;IACpB,yBAAkB,CAAA;IAClB,mCAAuB,CAAA;IACvB,6BAAoB,CAAA;IACpB,iCAAsB,CAAA;IACtB,2BAAmB,CAAA;IACnB,+BAAqB,CAAA;AACzB,CAAC,EAZI,QAAQ,KAAR,QAAQ,QAYZ;AAGD,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"type-code.js","sourceRoot":"","sources":["../../src/type-code.ts"],"names":[],"mappings":"AAAA,IAAK,QAYJ;AAZD,WAAK,QAAQ;IACT,6BAAoB,CAAA;IACpB,6BAAoB,CAAA;IACpB,+BAAqB,CAAA;IACrB,6BAAoB,CAAA;IACpB,6BAAoB,CAAA;IACpB,yBAAkB,CAAA;IAClB,mCAAuB,CAAA;IACvB,6BAAoB,CAAA;IACpB,iCAAsB,CAAA;IACtB,2BAAmB,CAAA;IACnB,+BAAqB,CAAA;AACzB,CAAC,EAZI,QAAQ,KAAR,QAAQ,QAYZ;AAGD,eAAe,QAAQ,CAAC","sourcesContent":["enum TypeCode {\r\n    String    = 'string',\r\n    Number    = 'number',\r\n    Boolean   = 'boolean',\r\n    Symbol    = 'symbol',\r\n    BigInt    = 'bigint',\r\n    Null      = 'null',\r\n    Undefined = 'undefined',\r\n    Object    = 'object',\r\n    Function  = 'function',\r\n    Array     = 'array',\r\n    Unknown   = 'unknown',\r\n}\r\n\r\n\r\nexport default TypeCode;"]}