@develia/commons 0.4.14 → 0.4.16

package/dist/web/range.js

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

package/dist/web/range.js.map

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

package/dist/web/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/web/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/web/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/web/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/web/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/web/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}"]}