@breadstone/mosaik-elements-foundation 0.0.31 → 0.0.33

package/Intl/Formatters/DateFormatter.js

@@ -0,0 +1,77 @@
+// #region Imports
+import { tryGet } from '../../Extensions/Extensions';
+// #endregion
+/**
+ * A utility class for formatting dates 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.
+ * - `ddd` : Abbreviated name of the day of the week (e.g., Mon, Tue).
+ * - `dddd`: Full name of the day of the week (e.g., Monday, Tuesday).
+ * - `M`   : Month (1-12) without leading zero.
+ * - `MM`  : Month (01-12) with leading zero.
+ * - `MMM` : Abbreviated name of the month (e.g., Jan, Feb).
+ * - `MMMM`: Full name of the month (e.g., January, February).
+ * - `y`   : Year as the last two digits without leading zero (e.g., 9 for 2009).
+ * - `yy`  : Year as the last two digits with leading zero (e.g., 09 for 2009).
+ * - `yyy` : Year with a minimum of three digits (e.g., 009, 2009).
+ * - `yyyy`: Year as a four-digit number (e.g., 2009).
+ * - `-`   : Custom separator (e.g., hyphen).
+ * - `/`   : Date separator (e.g., slash).
+ * - `.`   : Custom separator (e.g., dot).
+ *
+ * @public
+ */
+export class DateFormatter {
+    static _validSpecifiers = [
+        'd', 'dd', 'ddd', 'dddd', 'M', 'MM', 'MMM', 'MMMM', 'y', 'yy', 'yyy', 'yyyy', '-', '/', '.'
+    ];
+    static _formatMapping = {
+        d: { day: 'numeric' },
+        dd: { day: '2-digit' },
+        ddd: { weekday: 'short' },
+        dddd: { weekday: 'long' },
+        M: { month: 'numeric' },
+        MM: { month: '2-digit' },
+        MMM: { month: 'short' },
+        MMMM: { month: 'long' },
+        y: { year: '2-digit' },
+        yy: { year: '2-digit' },
+        yyy: { year: 'numeric' },
+        yyyy: { year: 'numeric' }
+    };
+    /**
+     * Formats a date using a date-specific format string.
+     *
+     * @param date The date to format.
+     * @param format The format string.
+     * @param locale The locale for Intl formatting (default: 'en-US').
+     * @returns The formatted date string.
+     */
+    static format(date, format, locale = 'en-US') {
+        if (typeof date === 'string') {
+            date = new Date(date);
+        }
+        const segments = format.match(/d{1,4}|y{1,4}|M{1,4}|[-/. ]+/g);
+        if (!segments) {
+            throw new Error(`Unable to parse format string: "${format}".`);
+        }
+        const formattedSegments = segments
+            .map((segment) => {
+            const intlOptions = tryGet(this._formatMapping, segment);
+            if (intlOptions) {
+                const formattedSegment = new Intl.DateTimeFormat(locale, intlOptions)
+                    .format(date);
+                return formattedSegment; // Return formatted date segment
+            }
+            else if ((/[-/. ]+/).test(segment)) {
+                return segment; // Return separator as-is
+            }
+            throw new Error(`Unknown date format segment: "${segment}".`);
+        });
+        const formattedSegment = formattedSegments.join('');
+        return formattedSegment;
+    }
+}
+//# sourceMappingURL=DateFormatter.js.map

package/Intl/Formatters/DateFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateFormatter.js","sourceRoot":"","sources":["../../../src/Intl/Formatters/DateFormatter.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,aAAa;AAEb;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,aAAa;IAEd,MAAM,CAAU,gBAAgB,GAAkB;QACtD,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG;KAC9F,CAAC;IACM,MAAM,CAAU,cAAc,GAA+C;QACjF,CAAC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE;QACrB,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE;QACtB,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;QACzB,IAAI,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;QACzB,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QACvB,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE;QACxB,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;QACvB,IAAI,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE;QACvB,CAAC,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QACtB,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QACvB,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QACxB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KAC5B,CAAC;IAEF;;;;;;;OAOG;IACI,MAAM,CAAC,MAAM,CAAC,IAAmB,EAAE,MAAc,EAAE,SAAiB,OAAO;QAC9E,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC/D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,IAAI,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,iBAAiB,GAAG,QAAQ;aAC7B,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACb,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YAEzD,IAAI,WAAW,EAAE,CAAC;gBACd,MAAM,gBAAgB,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC;qBAChE,MAAM,CAAC,IAAI,CAAC,CAAC;gBAClB,OAAO,gBAAgB,CAAC,CAAC,gCAAgC;YAC7D,CAAC;iBAAM,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,OAAO,OAAO,CAAC,CAAC,yBAAyB;YAC7C,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,IAAI,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QAEP,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpD,OAAO,gBAAgB,CAAC;IAC5B,CAAC"}

package/Intl/Formatters/DateTimeFormatter.d.ts

@@ -0,0 +1,55 @@
+/**
+ * A utility class for formatting dates 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.
+ * - `ddd` : Abbreviated name of the day of the week (e.g., Mon, Tue).
+ * - `dddd`: Full name of the day of the week (e.g., Monday, Tuesday).
+ * - `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.
+ * - `M`   : Month (1-12) without leading zero.
+ * - `MM`  : Month (01-12) with leading zero.
+ * - `MMM` : Abbreviated name of the month (e.g., Jan, Feb).
+ * - `MMMM`: Full name of the month (e.g., January, February).
+ * - `s`   : Second (0-59) without leading zero.
+ * - `ss`  : Second (00-59) with leading zero.
+ * - `t`   : First character of the AM/PM designator (e.g., A or P).
+ * - `tt`  : Full AM/PM designator (e.g., AM or PM).
+ * - `y`   : Year as the last two digits without leading zero (e.g., 9 for 2009).
+ * - `yy`  : Year as the last two digits with leading zero (e.g., 09 for 2009).
+ * - `yyy` : Year with a minimum of three digits (e.g., 009, 2009).
+ * - `yyyy`: Year as a four-digit number (e.g., 2009).
+ * - `:`   : Time separator (e.g., colon).
+ * - `/`   : Date separator (e.g., slash).
+ * - `-`   : Custom separator (e.g., hyphen).
+ * - `.`   : Custom separator (e.g., dot).
+ *
+ * @public
+ */
+export declare class DateTimeFormatter {
+    private static readonly _validSpecifiers;
+    private static readonly _formatMapping;
+    /**
+     * Validates that a format string contains only valid datetime format specifiers.
+     *
+     * @param format The format string.
+     * @returns A validated format string.
+     * @throws Error if the format contains invalid specifiers.
+     */
+    static validateFormat(format: string): string;
+    /**
+     * Formats a date using a format string.
+     *
+     * @param date The date to format.
+     * @param format The format string.
+     * @param locale The locale for Intl formatting (default: 'en-US').
+     * @returns The formatted date string.
+     */
+    static format(date: Date, format: string, locale?: string): string;
+}
+//# sourceMappingURL=DateTimeFormatter.d.ts.map

package/Intl/Formatters/DateTimeFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateTimeFormatter.d.ts","sourceRoot":"","sources":["../../../src/Intl/Formatters/DateTimeFormatter.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAStC;IACF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAuCpC;IAEF;;;;;;OAMG;WACW,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAYpD;;;;;;;OAOG;WACW,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM;CA0BrF"}

package/Intl/Formatters/DateTimeFormatter.js

@@ -0,0 +1,132 @@
+// #region Imports
+import { tryGet } from '../../Extensions/Extensions';
+// #endregion
+/**
+ * A utility class for formatting dates 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.
+ * - `ddd` : Abbreviated name of the day of the week (e.g., Mon, Tue).
+ * - `dddd`: Full name of the day of the week (e.g., Monday, Tuesday).
+ * - `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.
+ * - `M`   : Month (1-12) without leading zero.
+ * - `MM`  : Month (01-12) with leading zero.
+ * - `MMM` : Abbreviated name of the month (e.g., Jan, Feb).
+ * - `MMMM`: Full name of the month (e.g., January, February).
+ * - `s`   : Second (0-59) without leading zero.
+ * - `ss`  : Second (00-59) with leading zero.
+ * - `t`   : First character of the AM/PM designator (e.g., A or P).
+ * - `tt`  : Full AM/PM designator (e.g., AM or PM).
+ * - `y`   : Year as the last two digits without leading zero (e.g., 9 for 2009).
+ * - `yy`  : Year as the last two digits with leading zero (e.g., 09 for 2009).
+ * - `yyy` : Year with a minimum of three digits (e.g., 009, 2009).
+ * - `yyyy`: Year as a four-digit number (e.g., 2009).
+ * - `:`   : Time separator (e.g., colon).
+ * - `/`   : Date separator (e.g., slash).
+ * - `-`   : Custom separator (e.g., hyphen).
+ * - `.`   : Custom separator (e.g., dot).
+ *
+ * @public
+ */
+export class DateTimeFormatter {
+    static _validSpecifiers = [
+        'd', 'dd', 'ddd', 'dddd',
+        'h', 'hh', 'H', 'HH',
+        'm', 'mm',
+        'M', 'MM', 'MMM', 'MMMM',
+        's', 'ss',
+        't', 'tt',
+        'y', 'yy', 'yyy', 'yyyy',
+        ':', '/', '-', '.'
+    ];
+    static _formatMapping = {
+        'd': { day: 'numeric' },
+        'dd': { day: '2-digit' },
+        'ddd': { weekday: 'short' },
+        'dddd': { weekday: 'long' },
+        'h': {
+            hour: 'numeric',
+            hour12: true
+        },
+        'hh': {
+            hour: '2-digit',
+            hour12: true
+        },
+        'H': {
+            hour: 'numeric',
+            hour12: false
+        },
+        'HH': {
+            hour: '2-digit',
+            hour12: false
+        },
+        'm': { minute: 'numeric' },
+        'mm': { minute: '2-digit' },
+        'M': { month: 'numeric' },
+        'MM': { month: '2-digit' },
+        'MMM': { month: 'short' },
+        'MMMM': { month: 'long' },
+        's': { second: 'numeric' },
+        'ss': { second: '2-digit' },
+        't': {}, // AM/PM not directly supported
+        'tt': { hour12: true },
+        'y': { year: '2-digit' },
+        'yy': { year: '2-digit' },
+        'yyy': { year: 'numeric' },
+        'yyyy': { year: 'numeric' },
+        ':': {}, // Time separator
+        '/': {}, // Date separator
+        '-': {}, // Custom separator (hyphen)
+        '.': {} // Custom separator (dot)
+    };
+    /**
+     * Validates that a format string contains only valid datetime format specifiers.
+     *
+     * @param format The format string.
+     * @returns A validated format string.
+     * @throws Error if the format contains invalid specifiers.
+     */
+    static validateFormat(format) {
+        const regex = new RegExp(`^(${this._validSpecifiers.join('|')}|[-:/. ])+$`);
+        if (!regex.test(format)) {
+            throw new Error(`Invalid format string: "${format}".`);
+        }
+        return format;
+    }
+    /**
+     * Formats a date using a format string.
+     *
+     * @param date The date to format.
+     * @param format The format string.
+     * @param locale The locale for Intl formatting (default: 'en-US').
+     * @returns The formatted date string.
+     */
+    static format(date, format, locale = 'en-US') {
+        const segments = format.match(/d{1,4}|y{1,4}|M{1,4}|H{1,2}|h{1,2}|m{1,2}|s{1,2}|t{1,2}|[-:/. ]+/g);
+        if (!segments) {
+            throw new Error(`Unable to parse format string: "${format}".`);
+        }
+        return segments
+            .map((segment) => {
+            const intlOptions = tryGet(this._formatMapping, segment);
+            if (intlOptions) {
+                if ((/[-:/. ]+/).test(segment)) {
+                    return segment; // Return separator as-is
+                }
+                const d = new Intl.DateTimeFormat(locale, intlOptions).format(date);
+                console.log(segment, d);
+                return d;
+            }
+            // Unknown format segment
+            return segment;
+        })
+            .join('');
+    }
+}
+//# sourceMappingURL=DateTimeFormatter.js.map

package/Intl/Formatters/DateTimeFormatter.js.map

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

package/Intl/Formatters/TimeFormatter.d.ts

@@ -0,0 +1,33 @@
+/**
+ * A utility class for formatting times using format strings.
+ *
+ * Supported time format specifiers:
+ * - `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.
+ * - `t`   : First character of the AM/PM designator (e.g., A or P).
+ * - `tt`  : Full AM/PM designator (e.g., AM or PM).
+ * - `:`   : Time separator (e.g., colon).
+ * - `-`   : Custom separator (e.g., hyphen).
+ *
+ * @public
+ */
+export declare class TimeFormatter {
+    private static readonly _validSpecifiers;
+    private static readonly _formatMapping;
+    /**
+     * Formats a time using a time-specific format string.
+     *
+     * @param date The date object containing the time to format.
+     * @param format The format string.
+     * @param locale The locale for Intl formatting (default: 'en-US').
+     * @returns The formatted time string.
+     */
+    static format(date: Date, format: string, locale?: string): string;
+}
+//# sourceMappingURL=TimeFormatter.d.ts.map

package/Intl/Formatters/TimeFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeFormatter.d.ts","sourceRoot":"","sources":["../../../src/Intl/Formatters/TimeFormatter.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAEtC;IACF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAuBpC;IAEF;;;;;;;OAOG;WACW,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,MAAgB,GAAG,MAAM;CA0BrF"}

package/Intl/Formatters/TimeFormatter.js

@@ -0,0 +1,81 @@
+// #region Imports
+import { tryGet } from '../../Extensions/Extensions';
+// #endregion
+/**
+ * A utility class for formatting times using format strings.
+ *
+ * Supported time format specifiers:
+ * - `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.
+ * - `t`   : First character of the AM/PM designator (e.g., A or P).
+ * - `tt`  : Full AM/PM designator (e.g., AM or PM).
+ * - `:`   : Time separator (e.g., colon).
+ * - `-`   : Custom separator (e.g., hyphen).
+ *
+ * @public
+ */
+export class TimeFormatter {
+    static _validSpecifiers = [
+        'h', 'hh', 'H', 'HH', 'm', 'mm', 's', 'ss', 't', 'tt', ':', '-'
+    ];
+    static _formatMapping = {
+        h: {
+            hour: 'numeric',
+            hour12: true
+        },
+        hh: {
+            hour: '2-digit',
+            hour12: true
+        },
+        H: {
+            hour: 'numeric',
+            hour12: false
+        },
+        HH: {
+            hour: '2-digit',
+            hour12: false
+        },
+        m: { minute: 'numeric' },
+        mm: { minute: '2-digit' },
+        s: { second: 'numeric' },
+        ss: { second: '2-digit' },
+        t: {}, // AM/PM not directly supported
+        tt: { hour12: true }
+    };
+    /**
+     * Formats a time using a time-specific format string.
+     *
+     * @param date The date object containing the time to format.
+     * @param format The format string.
+     * @param locale The locale for Intl formatting (default: 'en-US').
+     * @returns The formatted time string.
+     */
+    static format(date, format, locale = 'en-US') {
+        const segments = format.match(/h{1,2}|H{1,2}|m{1,2}|s{1,2}|t{1,2}|[-: ]+/g);
+        if (!segments) {
+            throw new Error(`Unable to parse format string: "${format}".`);
+        }
+        const result = segments
+            .map((segment) => {
+            const intlOptions = tryGet(this._formatMapping, segment);
+            if (intlOptions) {
+                const formatted = new Intl.DateTimeFormat(locale, intlOptions)
+                    .format(date);
+                return formatted;
+            }
+            else if ((/[-: ]+/).test(segment)) {
+                return segment; // Return separator as-is
+            }
+            throw new Error(`Unknown time format segment: "${segment}".`);
+        })
+            .join('');
+        return result;
+    }
+}
+//# sourceMappingURL=TimeFormatter.js.map

package/Intl/Formatters/TimeFormatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeFormatter.js","sourceRoot":"","sources":["../../../src/Intl/Formatters/TimeFormatter.ts"],"names":[],"mappings":"AACA,kBAAkB;AAElB,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAErD,aAAa;AAEb;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,aAAa;IAEd,MAAM,CAAU,gBAAgB,GAAkB;QACtD,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG;KAClE,CAAC;IACM,MAAM,CAAU,cAAc,GAA+C;QACjF,CAAC,EAAE;YACC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,IAAI;SACf;QACD,EAAE,EAAE;YACA,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,IAAI;SACf;QACD,CAAC,EAAE;YACC,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,KAAK;SAChB;QACD,EAAE,EAAE;YACA,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,KAAK;SAChB;QACD,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;QACxB,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;QACzB,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;QACxB,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;QACzB,CAAC,EAAE,EAAE,EAAE,+BAA+B;QACtC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;KACvB,CAAC;IAEF;;;;;;;OAOG;IACI,MAAM,CAAC,MAAM,CAAC,IAAU,EAAE,MAAc,EAAE,SAAiB,OAAO;QACrE,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAC5E,IAAI,CAAC,QAAQ,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,IAAI,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ;aAClB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;YACb,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;YAEzD,IAAI,WAAW,EAAE,CAAC;gBACd,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,CAAC;qBACzD,MAAM,CAAC,IAAI,CAAC,CAAC;gBAElB,OAAO,SAAS,CAAC;YACrB,CAAC;iBAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClC,OAAO,OAAO,CAAC,CAAC,yBAAyB;YAC7C,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,iCAAiC,OAAO,IAAI,CAAC,CAAC;QAClE,CAAC,CAAC;aACD,IAAI,CAAC,EAAE,CAAC,CAAC;QAEd,OAAO,MAAM,CAAC;IAClB,CAAC"}

package/Layout/Breakpoint/BreakpointElementTemplate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BreakpointElementTemplate.d.ts","sourceRoot":"","sources":["../../../src/Layout/Breakpoint/BreakpointElementTemplate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI7D;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,iBAAiB,EAAE,CAAC,EAAE,CAAC,GAAG,cAAc,CAQ3F"}
+{"version":3,"file":"BreakpointElementTemplate.d.ts","sourceRoot":"","sources":["../../../src/Layout/Breakpoint/BreakpointElementTemplate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAI7D;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,iBAAiB,EAAE,CAAC,EAAE,CAAC,GAAG,cAAc,CAQ3F"}

package/Layout/Breakpoint/BreakpointElementTemplate.js

@@ -1,3 +1,4 @@
+/* eslint-disable lit/prefer-static-styles */
 // #region Imports
 import { html } from '../../Dom/Html';
 // #endregion

package/Layout/Breakpoint/BreakpointElementTemplate.js.map

@@ -1 +1 @@
-{"version":3,"file":"BreakpointElementTemplate.js","sourceRoot":"","sources":["../../../src/Layout/Breakpoint/BreakpointElementTemplate.ts"],"names":[],"mappings":"AAAA,kBAAkB;AAElB,OAAO,EAAE,IAAI,EAAuB,MAAM,gBAAgB,CAAC;AAG3D,aAAa;AAEb;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAA8B,CAAI;IACvE,OAAO,IAAI,CAAA;;;;;;KAMV,CAAC;AACN,CAAC"}
+{"version":3,"file":"BreakpointElementTemplate.js","sourceRoot":"","sources":["../../../src/Layout/Breakpoint/BreakpointElementTemplate.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,kBAAkB;AAElB,OAAO,EAAE,IAAI,EAAuB,MAAM,gBAAgB,CAAC;AAG3D,aAAa;AAEb;;;;GAIG;AACH,MAAM,UAAU,yBAAyB,CAA8B,CAAI;IACvE,OAAO,IAAI,CAAA;;;;;;KAMV,CAAC;AACN,CAAC"}

package/Routing/Controllers/RouterController.d.ts

@@ -21,30 +21,22 @@ export interface IRouterControllerConfig {
  * @public
  */
 export declare class RouterController implements ReactiveController {
+    private static readonly ROUTING_STRATEGIES;
     private static readonly ORIGIN;
     private readonly _childRoutes;
     private readonly _host;
-    /**
-         * State related to the current matching route.
-         *
-         * We keep this so that consuming code can access current parameters, and so
-         * that we can propagate tail matches to child routes if they are added after
-         * navigation / matching.
-         */
+    private readonly _callback;
+    private readonly _fallback;
     private _currentPathname;
     private _currentRoute;
     private _currentParams;
     private _parentRoutes;
-    /**
-         * Callback to call when this controller is disconnected.
-         *
-         * It's critical to call this immediately in hostDisconnected so that this
-         * controller instance doesn't receive a tail match meant for another route.
-         */
     private _onDisconnect;
     private _windowClickSubscription;
     private _windowPopStateSubscription;
     private _hostRoutesConnectedSubscription;
+    private _useHash;
+    private _routes;
     /**
      * Constructs a new instance of the `MutationController` class.
      *
@@ -66,15 +58,22 @@ export declare class RouterController implements ReactiveController {
      * Mutating this property does not trigger any route transitions. If the
      * changes may result is a different route matching for the current path, you
      * must instigate a route update with `navigate()`.
+     *
+     * @public
      */
-    routes: Array<RouteConfig>;
+    get routes(): Array<RouteConfig>;
+    set routes(value: Array<RouteConfig>);
     /**
-         * A default fallback route which will always be matched if none of the
-         * {@link routes} match. Implicitly matches to the path "/*".
-         */
-    readonly fallback?: IBaseRouteConfig | undefined;
-    readonly callback?: ((route: RouteConfig) => void) | undefined;
-    useHash: boolean;
+     * Gets or sets the `useHash` property.
+     *
+     * For example, if `useHash` is `true`, the URL will look like
+     * `http://example.com/#/path/to/resource` instead of
+     * `http://example.com/path/to/resource`.
+     *
+     * @public
+     */
+    get useHash(): boolean;
+    set useHash(value: boolean);
     /**
      * Gets or sets the `scrollRestoration` property.
      *
@@ -82,11 +81,32 @@ export declare class RouterController implements ReactiveController {
      */
     get scrollRestoration(): ScrollRestoration;
     set scrollRestoration(value: ScrollRestoration);
+    /**
+     * A default fallback route which will always be matched if none of the
+     * {@link routes} match. Implicitly matches to the path "/*".
+     *
+     * @public
+     * @readonly
+     */
+    get fallback(): IBaseRouteConfig | undefined;
+    /**
+     * Returns the `callback` property.
+     *
+     * @public
+     * @readonly
+     */
+    get callback(): ((type: RouteConfig) => void) | undefined;
     /**
      * The current parsed route parameters.
+     *
+     * @public
+     * @readonly
      */
     get params(): Record<string, string | undefined>;
     hostConnected(): void;
+    /**
+     * @public
+     */
     hostDisconnected(): void;
     /**
      * Navigates this routes controller to `pathname`.
@@ -94,23 +114,40 @@ export declare class RouterController implements ReactiveController {
      * This does not navigate parent routes, so it isn't (yet) a general page
      * navigation API. It does navigate child routes if pathname matches a
      * pattern with a tail wildcard pattern (`/*`).
+     *
+     * @public
      */
     navigate(pathname: string): Promise<void>;
     /**
      * Returns a URL string of the current route, including parent routes,
      * optionally replacing the local path with `pathname`.
+     *
+     * @public
      */
     link(pathname?: string): string;
     /**
      * The result of calling the current route's render() callback.
+     *
+     * @public
      */
     outlet(): IRouteView | HTMLTemplateResult | undefined;
     /**
      * Matches `url` against the installed routes and returns the first match.
+     *
+     * @private
      */
     private getRoute;
+    /**
+     * @private
+     */
     private onRoutesConnected;
+    /**
+     * @private
+     */
     private onWindowClick;
+    /**
+     * @private
+     */
     private onWindowPopState;
 }
 declare global {

package/Routing/Controllers/RouterController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouterController.d.ts","sourceRoot":"","sources":["../../../src/Routing/Controllers/RouterController.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAC;AACtE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAE3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAK3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IAIvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAA+D;IAC7F,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAEjE;;;;;;WAMO;IACH,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,aAAa,CAA+B;IAExD;;;;;WAKO;IAGH,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,wBAAwB,CAAoC;IACpE,OAAO,CAAC,2BAA2B,CAAoC;IACvE,OAAO,CAAC,gCAAgC,CAAoC;IAM5E;;;;OAIG;gBACgB,IAAI,EAAE,sBAAsB,GAAG,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,EAAE,uBAAuB;IAsB3H;;;;;;;;;;;;;;;OAeG;IACI,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,CAAM;IAE3C;;;WAGO;IACH,SAAgB,QAAQ,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACxD,SAAgB,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;IAC/D,OAAO,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,IAAW,iBAAiB,IAAI,iBAAiB,CAEhD;IAED,IAAW,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,EAEpD;IAED;;OAEG;IACH,IAAW,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAEtD;IAMM,aAAa,IAAI,IAAI;IAsBrB,gBAAgB,IAAI,IAAI;IAW/B;;;;;;OAMG;IACU,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoEtD;;;OAGG;IACI,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAiBtC;;OAEG;IACI,MAAM,IAAI,UAAU,GAAG,kBAAkB,GAAG,SAAS;IAe5D;;OAEG;IACH,OAAO,CAAC,QAAQ;IAuBhB,OAAO,CAAC,iBAAiB;IA2BzB,OAAO,CAAC,aAAa;IA8DrB,OAAO,CAAC,gBAAgB;CAqB3B;AAED,OAAO,CAAC,MAAM,CAAC;IAEX,UAAU,mBAAmB;QACzB,eAAe,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC;KAC7D;CACJ"}
+{"version":3,"file":"RouterController.d.ts","sourceRoot":"","sources":["../../../src/Routing/Controllers/RouterController.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,KAAK,CAAC;AACtE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,yCAAyC,CAAC;AAE3F,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAC3F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAK3D;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACpC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACzC;AAID;;;;;;;GAOG;AACH,qBAAa,gBAAiB,YAAW,kBAAkB;IAIvD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAGvC;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAA+D;IAC7F,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;IAC5D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IACtE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,aAAa,CAA0B;IAC/C,OAAO,CAAC,cAAc,CAA0C;IAChE,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,aAAa,CAA2B;IAChD,OAAO,CAAC,wBAAwB,CAAoC;IACpE,OAAO,CAAC,2BAA2B,CAAoC;IACvE,OAAO,CAAC,gCAAgC,CAAoC;IAC5E,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,OAAO,CAAqB;IAMpC;;;;OAIG;gBACgB,IAAI,EAAE,sBAAsB,GAAG,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,EAAE,uBAAuB;IAwB3H;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAW,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAEtC;IACD,IAAW,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,EAE1C;IAED;;;;;;;;OAQG;IACH,IAAW,OAAO,IAAI,OAAO,CAE5B;IACD,IAAW,OAAO,CAAC,KAAK,EAAE,OAAO,EAEhC;IAED;;;;OAIG;IACH,IAAW,iBAAiB,IAAI,iBAAiB,CAEhD;IACD,IAAW,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,EAEpD;IAED;;;;;;OAMG;IACH,IAAW,QAAQ,IAAI,gBAAgB,GAAG,SAAS,CAElD;IAED;;;;;OAKG;IACH,IAAW,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,SAAS,CAE/D;IAED;;;;;OAKG;IACH,IAAW,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAEtD;IAMM,aAAa,IAAI,IAAI;IAsB5B;;OAEG;IACI,gBAAgB,IAAI,IAAI;IAW/B;;;;;;;;OAQG;IACU,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAwDtD;;;;;OAKG;IACI,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAiBtC;;;;OAIG;IACI,MAAM,IAAI,UAAU,GAAG,kBAAkB,GAAG,SAAS;IAU5D;;;;OAIG;IACH,OAAO,CAAC,QAAQ;IAuBhB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,aAAa;IA6BrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqB3B;AAuFD,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,mBAAmB;QACzB,eAAe,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC;KAC7D;CACJ"}