@breadstone/mosaik-elements-foundation 0.0.264 → 0.0.266

package/Intl/parsers/DateParser.js

@@ -0,0 +1,139 @@
+/**
+ * A utility class for parsing date strings using format strings.
+ *
+ * Supported date format specifiers:
+ * - `d`   : Day of the month (1-31) without leading zero.
+ * - `dd`  : Day of the month (01-31) with leading zero.
+ * - `M`   : Month (1-12) without leading zero.
+ * - `MM`  : Month (01-12) with leading zero.
+ * - `y`   : Year as the last two digits without leading zero.
+ * - `yy`  : Year as the last two digits with leading zero.
+ * - `yyyy`: Year as a four-digit number.
+ * - `-`   : Separator (hyphen).
+ * - `/`   : Separator (slash).
+ * - `.`   : Separator (dot).
+ * - ` `   : Separator (space).
+ *
+ * @public
+ */
+export class DateParser {
+    // #region Fields
+    static _segmentRegex = /d{1,2}|y{1,4}|M{1,2}|[-/. ]+/g;
+    // #endregion
+    // #region Methods
+    /**
+     * Attempts to parse a date string using the provided format.
+     * Returns `null` if parsing fails or produces an invalid date.
+     *
+     * @param value The date string to parse.
+     * @param format The expected format of the date string.
+     * @param locale The locale (reserved for future use).
+     * @returns The parsed Date or null.
+     */
+    static tryParse(value, format, locale) {
+        try {
+            const date = this.parse(value, format, locale);
+            if (!this.isValidDate(date)) {
+                return null;
+            }
+            return date;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Parses a date string according to the given format string.
+     *
+     * @param value The date string to parse.
+     * @param format The format string describing the layout.
+     * @param locale The locale (reserved for future use).
+     * @returns The parsed Date.
+     * @throws Error if the format or value cannot be parsed.
+     */
+    static parse(value, format, locale) {
+        const segments = format.match(this._segmentRegex);
+        if (!segments) {
+            throw new Error(`Unable to parse format string: "${format}".`);
+        }
+        let position = 0;
+        let day = 1;
+        let month = 0;
+        let year = 0;
+        for (const segment of segments) {
+            if ((/[-/. ]+/).test(segment)) {
+                // Skip separator characters in the value
+                position += segment.length;
+                continue;
+            }
+            const extracted = this.extractNumericValue(value, position, segment);
+            position += extracted.length;
+            switch (segment) {
+                case 'd':
+                case 'dd':
+                    day = extracted.value;
+                    break;
+                case 'M':
+                case 'MM':
+                    month = extracted.value - 1; // Months are zero-based
+                    break;
+                case 'y':
+                case 'yy':
+                    year = extracted.value < 100 ? 2000 + extracted.value : extracted.value;
+                    break;
+                case 'yyy':
+                case 'yyyy':
+                    year = extracted.value;
+                    break;
+                default:
+                    throw new Error(`Unknown date format segment: "${segment}".`);
+            }
+        }
+        const date = new Date(year, month, day);
+        // Validate that the constructed date matches the parsed values
+        if (date.getFullYear() !== year || date.getMonth() !== month || date.getDate() !== day) {
+            throw new Error(`Invalid date values: day=${day}, month=${month + 1}, year=${year}.`);
+        }
+        return date;
+    }
+    /**
+     * Extracts a numeric value from the input string at the given position.
+     * The number of digits consumed is determined by the format segment:
+     * - `yyyy` / `yyy`: up to 4 digits (min 3 or 4 depending on specifier length).
+     * - `dd` / `MM` / `yy`: exactly 2 digits.
+     * - `d` / `M` / `y`: 1 to 2 digits (greedy).
+     *
+     * @param value - The full input string being parsed.
+     * @param position - The current character index in `value`.
+     * @param segment - The format segment (e.g., `"dd"`, `"M"`, `"yyyy"`).
+     * @returns An object containing the parsed numeric `value` and the `length` of characters consumed.
+     * @throws Error if fewer digits are found than the segment requires.
+     */
+    static extractNumericValue(value, position, segment) {
+        const maxLength = segment === 'yyyy' || segment === 'yyy' ? 4 : segment.length === 2 ? 2 : 2;
+        const minLength = segment.length === 1 ? 1 : segment.length;
+        let end = position;
+        while (end < value.length && end - position < maxLength && (/\d/).test(value[end])) {
+            end++;
+        }
+        const extracted = value.substring(position, end);
+        if (extracted.length < minLength) {
+            throw new Error(`Expected at least ${minLength} digit(s) for segment "${segment}" at position ${position}, got "${extracted}".`);
+        }
+        const numericValue = parseInt(extracted, 10);
+        if (isNaN(numericValue)) {
+            throw new Error(`Unable to parse numeric value for segment "${segment}" at position ${position}.`);
+        }
+        return { value: numericValue, length: extracted.length };
+    }
+    /**
+     * Checks whether the given Date object represents a valid point in time.
+     *
+     * @param date - The Date object to validate.
+     * @returns `true` if the date is valid (not `NaN`), otherwise `false`.
+     */
+    static isValidDate(date) {
+        return !isNaN(date.getTime());
+    }
+}
+//# sourceMappingURL=DateParser.js.map

package/Intl/parsers/DateParser.js.map

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

package/Intl/parsers/DateTimeParser.d.ts

@@ -0,0 +1,85 @@
+/**
+ * A utility class for parsing date-time strings using format strings.
+ *
+ * Supported format specifiers:
+ * - `d`   : Day of the month (1-31) without leading zero.
+ * - `dd`  : Day of the month (01-31) with leading zero.
+ * - `M`   : Month (1-12) without leading zero.
+ * - `MM`  : Month (01-12) with leading zero.
+ * - `h`   : Hour (1-12) in 12-hour format without leading zero.
+ * - `hh`  : Hour (01-12) in 12-hour format with leading zero.
+ * - `H`   : Hour (0-23) in 24-hour format without leading zero.
+ * - `HH`  : Hour (00-23) in 24-hour format with leading zero.
+ * - `m`   : Minute (0-59) without leading zero.
+ * - `mm`  : Minute (00-59) with leading zero.
+ * - `s`   : Second (0-59) without leading zero.
+ * - `ss`  : Second (00-59) with leading zero.
+ * - `tt`  : AM/PM designator.
+ * - `y`   : Year as the last two digits without leading zero.
+ * - `yy`  : Year as the last two digits with leading zero.
+ * - `yyyy`: Year as a four-digit number.
+ * - `:`   : Time separator.
+ * - `/`   : Date separator.
+ * - `-`   : Separator (hyphen).
+ * - `.`   : Separator (dot).
+ * - ` `   : Separator (space).
+ *
+ * @public
+ */
+export declare class DateTimeParser {
+    private static readonly _segmentRegex;
+    /**
+     * Attempts to parse a date-time string using the provided format.
+     * Returns `null` if parsing fails or produces an invalid date.
+     *
+     * @param value The date-time string to parse.
+     * @param format The expected format of the date-time string.
+     * @param locale The locale (reserved for future use).
+     * @returns The parsed Date or null.
+     */
+    static tryParse(value: string, format: string, locale: string): Date | null;
+    /**
+     * Parses a date-time string according to the given format string.
+     *
+     * @param value The date-time string to parse.
+     * @param format The format string describing the layout.
+     * @param locale The locale (reserved for future use).
+     * @returns The parsed Date.
+     * @throws Error if the format or value cannot be parsed.
+     */
+    static parse(value: string, format: string, locale: string): Date;
+    /**
+     * Extracts a numeric value from the input string at the given position.
+     * The number of digits consumed is determined by the format segment:
+     * - `yyyy` / `yyy`: up to 4 digits.
+     * - All other segments (`dd`, `MM`, `HH`, `hh`, `mm`, `ss`, etc.): up to 2 digits.
+     * Single-character specifiers (`d`, `M`, `H`, `h`, `m`, `s`) require at least 1 digit;
+     * two-character specifiers require exactly 2.
+     *
+     * @param value - The full input string being parsed.
+     * @param position - The current character index in `value`.
+     * @param segment - The format segment (e.g., `"HH"`, `"m"`, `"yyyy"`).
+     * @returns An object containing the parsed numeric `value` and the `length` of characters consumed.
+     * @throws Error if fewer digits are found than the segment requires.
+     */
+    private static extractNumericValue;
+    /**
+     * Extracts the AM/PM designator from the input string at the given position.
+     * Recognized patterns (case-insensitive): `"AM"`, `"PM"`, `"A.M."`, `"P.M."`,
+     * and single characters `"A"` / `"P"` (for the `t` specifier).
+     *
+     * @param value - The full input string being parsed.
+     * @param position - The current character index in `value`.
+     * @returns An object with `isPm` (true for PM) and `length` of characters consumed.
+     * @throws Error if no valid AM/PM designator is found at the position.
+     */
+    private static extractAmPm;
+    /**
+     * Checks whether the given Date object represents a valid point in time.
+     *
+     * @param date - The Date object to validate.
+     * @returns `true` if the date is valid (not `NaN`), otherwise `false`.
+     */
+    private static isValidDate;
+}
+//# sourceMappingURL=DateTimeParser.d.ts.map

package/Intl/parsers/DateTimeParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateTimeParser.d.ts","sourceRoot":"","sources":["../../../src/Intl/parsers/DateTimeParser.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,cAAc;IAIvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAuE;IAM5G;;;;;;;;OAQG;WACW,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAalF;;;;;;;;OAQG;WACW,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAoGxE;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAsBlC;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAyB1B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;CAM7B"}

package/Intl/parsers/DateTimeParser.js

@@ -0,0 +1,223 @@
+/**
+ * A utility class for parsing date-time strings using format strings.
+ *
+ * Supported format specifiers:
+ * - `d`   : Day of the month (1-31) without leading zero.
+ * - `dd`  : Day of the month (01-31) with leading zero.
+ * - `M`   : Month (1-12) without leading zero.
+ * - `MM`  : Month (01-12) with leading zero.
+ * - `h`   : Hour (1-12) in 12-hour format without leading zero.
+ * - `hh`  : Hour (01-12) in 12-hour format with leading zero.
+ * - `H`   : Hour (0-23) in 24-hour format without leading zero.
+ * - `HH`  : Hour (00-23) in 24-hour format with leading zero.
+ * - `m`   : Minute (0-59) without leading zero.
+ * - `mm`  : Minute (00-59) with leading zero.
+ * - `s`   : Second (0-59) without leading zero.
+ * - `ss`  : Second (00-59) with leading zero.
+ * - `tt`  : AM/PM designator.
+ * - `y`   : Year as the last two digits without leading zero.
+ * - `yy`  : Year as the last two digits with leading zero.
+ * - `yyyy`: Year as a four-digit number.
+ * - `:`   : Time separator.
+ * - `/`   : Date separator.
+ * - `-`   : Separator (hyphen).
+ * - `.`   : Separator (dot).
+ * - ` `   : Separator (space).
+ *
+ * @public
+ */
+export class DateTimeParser {
+    // #region Fields
+    static _segmentRegex = /d{1,2}|y{1,4}|M{1,2}|H{1,2}|h{1,2}|m{1,2}|s{1,2}|t{1,2}|[-:/. ]+/g;
+    // #endregion
+    // #region Methods
+    /**
+     * Attempts to parse a date-time string using the provided format.
+     * Returns `null` if parsing fails or produces an invalid date.
+     *
+     * @param value The date-time string to parse.
+     * @param format The expected format of the date-time string.
+     * @param locale The locale (reserved for future use).
+     * @returns The parsed Date or null.
+     */
+    static tryParse(value, format, locale) {
+        try {
+            const date = this.parse(value, format, locale);
+            if (!this.isValidDate(date)) {
+                return null;
+            }
+            return date;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Parses a date-time string according to the given format string.
+     *
+     * @param value The date-time string to parse.
+     * @param format The format string describing the layout.
+     * @param locale The locale (reserved for future use).
+     * @returns The parsed Date.
+     * @throws Error if the format or value cannot be parsed.
+     */
+    static parse(value, format, locale) {
+        const segments = format.match(this._segmentRegex);
+        if (!segments) {
+            throw new Error(`Unable to parse format string: "${format}".`);
+        }
+        let position = 0;
+        let day = 1;
+        let month = 0;
+        let year = 0;
+        let hours = 0;
+        let minutes = 0;
+        let seconds = 0;
+        let isPm = null;
+        let is12Hour = false;
+        for (const segment of segments) {
+            if ((/[-:/. ]+/).test(segment)) {
+                position += segment.length;
+                continue;
+            }
+            if (segment === 't' || segment === 'tt') {
+                const amPm = this.extractAmPm(value, position);
+                isPm = amPm.isPm;
+                position += amPm.length;
+                continue;
+            }
+            const extracted = this.extractNumericValue(value, position, segment);
+            position += extracted.length;
+            switch (segment) {
+                case 'd':
+                case 'dd':
+                    day = extracted.value;
+                    break;
+                case 'M':
+                case 'MM':
+                    month = extracted.value - 1;
+                    break;
+                case 'y':
+                case 'yy':
+                    year = extracted.value < 100 ? 2000 + extracted.value : extracted.value;
+                    break;
+                case 'yyy':
+                case 'yyyy':
+                    year = extracted.value;
+                    break;
+                case 'h':
+                case 'hh':
+                    hours = extracted.value;
+                    is12Hour = true;
+                    break;
+                case 'H':
+                case 'HH':
+                    hours = extracted.value;
+                    break;
+                case 'm':
+                case 'mm':
+                    minutes = extracted.value;
+                    break;
+                case 's':
+                case 'ss':
+                    seconds = extracted.value;
+                    break;
+                default:
+                    throw new Error(`Unknown datetime format segment: "${segment}".`);
+            }
+        }
+        // Validate 12-hour range (must be 1-12)
+        if (is12Hour && (hours < 1 || hours > 12)) {
+            throw new Error(`Invalid 12-hour value: ${hours}. Must be between 1 and 12.`);
+        }
+        // Convert 12-hour to 24-hour
+        if (is12Hour && isPm !== null) {
+            if (isPm && hours !== 12) {
+                hours += 12;
+            }
+            else if (!isPm && hours === 12) {
+                hours = 0;
+            }
+        }
+        const date = new Date(year, month, day, hours, minutes, seconds);
+        // Validate that the constructed date matches the parsed values
+        if (date.getFullYear() !== year || date.getMonth() !== month || date.getDate() !== day) {
+            throw new Error(`Invalid date values: day=${day}, month=${month + 1}, year=${year}.`);
+        }
+        // Validate that the constructed time matches the parsed values
+        if (date.getHours() !== hours || date.getMinutes() !== minutes || date.getSeconds() !== seconds) {
+            throw new Error(`Invalid time values: hours=${hours}, minutes=${minutes}, seconds=${seconds}.`);
+        }
+        return date;
+    }
+    /**
+     * Extracts a numeric value from the input string at the given position.
+     * The number of digits consumed is determined by the format segment:
+     * - `yyyy` / `yyy`: up to 4 digits.
+     * - All other segments (`dd`, `MM`, `HH`, `hh`, `mm`, `ss`, etc.): up to 2 digits.
+     * Single-character specifiers (`d`, `M`, `H`, `h`, `m`, `s`) require at least 1 digit;
+     * two-character specifiers require exactly 2.
+     *
+     * @param value - The full input string being parsed.
+     * @param position - The current character index in `value`.
+     * @param segment - The format segment (e.g., `"HH"`, `"m"`, `"yyyy"`).
+     * @returns An object containing the parsed numeric `value` and the `length` of characters consumed.
+     * @throws Error if fewer digits are found than the segment requires.
+     */
+    static extractNumericValue(value, position, segment) {
+        const maxLength = segment === 'yyyy' || segment === 'yyy' ? 4 : 2;
+        const minLength = segment.length === 1 ? 1 : segment.length;
+        let end = position;
+        while (end < value.length && end - position < maxLength && (/\d/).test(value[end])) {
+            end++;
+        }
+        const extracted = value.substring(position, end);
+        if (extracted.length < minLength) {
+            throw new Error(`Expected at least ${minLength} digit(s) for segment "${segment}" at position ${position}, got "${extracted}".`);
+        }
+        const numericValue = parseInt(extracted, 10);
+        if (isNaN(numericValue)) {
+            throw new Error(`Unable to parse numeric value for segment "${segment}" at position ${position}.`);
+        }
+        return { value: numericValue, length: extracted.length };
+    }
+    /**
+     * Extracts the AM/PM designator from the input string at the given position.
+     * Recognized patterns (case-insensitive): `"AM"`, `"PM"`, `"A.M."`, `"P.M."`,
+     * and single characters `"A"` / `"P"` (for the `t` specifier).
+     *
+     * @param value - The full input string being parsed.
+     * @param position - The current character index in `value`.
+     * @returns An object with `isPm` (true for PM) and `length` of characters consumed.
+     * @throws Error if no valid AM/PM designator is found at the position.
+     */
+    static extractAmPm(value, position) {
+        const remaining = value.substring(position).toUpperCase();
+        if (remaining.startsWith('PM') || remaining.startsWith('P.M.')) {
+            const length = remaining.startsWith('P.M.') ? 4 : 2;
+            return { isPm: true, length };
+        }
+        if (remaining.startsWith('AM') || remaining.startsWith('A.M.')) {
+            const length = remaining.startsWith('A.M.') ? 4 : 2;
+            return { isPm: false, length };
+        }
+        // Single character: 't' specifier
+        if (remaining.startsWith('P')) {
+            return { isPm: true, length: 1 };
+        }
+        if (remaining.startsWith('A')) {
+            return { isPm: false, length: 1 };
+        }
+        throw new Error(`Unable to parse AM/PM designator at position ${position}.`);
+    }
+    /**
+     * Checks whether the given Date object represents a valid point in time.
+     *
+     * @param date - The Date object to validate.
+     * @returns `true` if the date is valid (not `NaN`), otherwise `false`.
+     */
+    static isValidDate(date) {
+        return !isNaN(date.getTime());
+    }
+}
+//# sourceMappingURL=DateTimeParser.js.map

package/Intl/parsers/DateTimeParser.js.map

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

package/Routing/PathToRegexp.d.ts

@@ -91,7 +91,7 @@ export interface Options {
      */
     encode?: (value: string) => string;
 }
-export declare function modifierToString(modifier: Modifier): "" | "*" | "+" | "?";
+export declare function modifierToString(modifier: Modifier): "" | "*" | "?" | "+";
 /**
  * Expose a function for taking tokens and returning a RegExp.
  */