@ifto/mantine-kit 0.0.0-stage → 0.2.0

package/dist/styles/print.css

@@ -0,0 +1,93 @@
+/*
+Print rules of the whole app, mainly used by the reports (PrintPage): the user prints the page or saves it as PDF with
+the browser itself.
+*/
+
+/*
+Named pages of the reports: the paper size, the margins and the page number in the margin (only Chrome/Edge 131+ show
+the page margins) apply only to the PrintPage, which uses one of them according to the orientation. Outside the
+reports, the user chooses the paper and the orientation in the print dialog. Both pages repeat the margins, since a
+named page does not inherit from another one. The page number is language neutral ("3 / 10"), since CSS cannot read
+the locale of the app. CSS cannot read the name of the system either: an app that wants the footer text (`footer` of
+the export texts) in the margin adds a `@bottom-left` to the `report` and `report-landscape` pages in its own CSS.
+*/
+@page report {
+    size: A4;
+    margin: 15mm 12mm 18mm;
+
+    @bottom-right {
+        content: counter(page) ' / ' counter(pages);
+        font-size: 8pt;
+        color: #5f6b7a;
+    }
+}
+
+/* Wide tables (e.g. a year per column). */
+@page report-landscape {
+    size: A4 landscape;
+    margin: 15mm 12mm 18mm;
+
+    @bottom-right {
+        content: counter(page) ' / ' counter(pages);
+        font-size: 8pt;
+        color: #5f6b7a;
+    }
+}
+
+[data-print-orientation='portrait'] {
+    page: report;
+}
+
+[data-print-orientation='landscape'] {
+    page: report-landscape;
+}
+
+@media print {
+    /* The header and the menu of the app are not part of the printed document. */
+    .mantine-AppShell-header,
+    .mantine-AppShell-navbar,
+    [data-print-hidden] {
+        display: none !important;
+    }
+
+    .mantine-AppShell-main {
+        padding: 0 !important;
+        min-height: 0 !important;
+    }
+
+    /* Only in the reports, colors and backgrounds are printed as on screen (e.g. the table header), without the user
+       having to check "Background graphics". In the other pages, the choice of the user in the print dialog applies. */
+    [data-print-orientation] {
+        print-color-adjust: exact;
+        -webkit-print-color-adjust: exact;
+    }
+
+    /* Repeats the table header on every page and does not cut a row in half. */
+    thead {
+        display: table-header-group;
+    }
+
+    tfoot {
+        display: table-footer-group;
+    }
+
+    tr,
+    [data-print-block] {
+        break-inside: avoid;
+    }
+
+    [data-print-new-page] {
+        break-before: page;
+    }
+
+    [data-print-keep-with-next] {
+        break-after: avoid;
+    }
+
+    /* A scroll container would make the browser cut the table, instead of splitting it across pages. */
+    .mantine-Table-scrollContainer,
+    .mantine-ScrollArea-root,
+    .mantine-ScrollArea-viewport {
+        overflow: visible !important;
+    }
+}

package/dist/styles.css

@@ -0,0 +1,188 @@
+.mk-App-module-main-8515C {
+    min-height: 95vh;
+}
+
+    [data-mantine-color-scheme='light'] .mk-App-module-main-8515C {
+        background-color: var(--mantine-color-gray-0);
+}
+
+    [data-mantine-color-scheme='dark'] .mk-App-module-main-8515C {
+        background-color: var(--mantine-color-dark-6);
+}
+
+    /* On paper, the page is white and only as tall as its content (see styles/print.css). */
+    @media print {.mk-App-module-main-8515C {
+        min-height: 0;
+        background-color: #fff !important
+}
+    }
+.mk-Stats-module-value-EAntx {
+    font-size: calc(1.5rem * var(--mantine-scale));
+    font-weight: 500;
+    line-height: 1;
+}
+
+.mk-Stats-module-diff-r3gSM {
+    line-height: 1;
+    display: flex;
+    align-items: center;
+}
+
+[data-mantine-color-scheme='dark'] .mk-Stats-module-icon-YG6b9 {
+        color: var(--mantine-color-dark-3);
+}
+
+[data-mantine-color-scheme='light'] .mk-Stats-module-icon-YG6b9 {
+        color: var(--mantine-color-gray-4);
+}
+
+.mk-Stats-module-title-MzSDP {
+    font-weight: 500;
+    text-transform: uppercase;
+}
+/*
+ * Tabs as wide as their own text (without stretching to fill the row), up to a maximum width.
+ * A title longer than the limit wraps in more than one line inside the tab, instead of widening it.
+ */
+.mk-DataTabList-module-tab-15vyU {
+    max-width: 14rem;
+    min-height: 2.5rem;
+    white-space: normal;
+    line-height: 1.25;
+
+    /* Border on the inactive tabs, so they look clickable, and not like loose text of the page. */
+    border: 1px solid var(--mantine-color-default-border);
+}
+
+.mk-DataTabList-module-tab-15vyU[data-active] {
+    border-color: var(--mantine-primary-color-filled);
+}
+
+/* Same size for any given icon, so all tabs have the same height. */
+.mk-DataTabList-module-tabSection-WA0SY svg {
+    width: 1rem;
+    height: 1rem;
+}
+
+.mk-DataTabList-module-panel-R37nf {
+    padding-top: var(--mantine-spacing-xs);
+}
+.mk-Navbar-module-navbar-0W9zF {
+    padding: var(--mantine-spacing-md);
+    display: flex;
+    flex-direction: column;
+    border-right: calc(0.0625rem * var(--mantine-scale)) solid var(--mantine-color-gray-3);
+}
+    [data-mantine-color-scheme='dark'] .mk-Navbar-module-navbar-0W9zF {
+    border-right: calc(0.0625rem * var(--mantine-scale)) solid var(--mantine-color-dark-4);
+}
+
+.mk-Navbar-module-navbarMain-QxMWi {
+    flex: 1;
+}
+
+.mk-Navbar-module-header-q16r1 {
+    padding-bottom: var(--mantine-spacing-md);
+    margin-bottom: calc(var(--mantine-spacing-md) * 1.5);
+    border-bottom: calc(0.0625rem * var(--mantine-scale)) solid var(--mantine-color-gray-3);
+}
+
+[data-mantine-color-scheme='dark'] .mk-Navbar-module-header-q16r1 {
+    border-bottom: calc(0.0625rem * var(--mantine-scale)) solid var(--mantine-color-dark-4);
+}
+
+.mk-Navbar-module-footer-48Z0e {
+    padding-top: var(--mantine-spacing-md);
+    margin-top: var(--mantine-spacing-md);
+    border-top: calc(0.0625rem * var(--mantine-scale)) solid var(--mantine-color-gray-3);
+}
+
+[data-mantine-color-scheme='dark'] .mk-Navbar-module-footer-48Z0e {
+    border-top: calc(0.0625rem * var(--mantine-scale)) solid var(--mantine-color-dark-4);
+}
+
+.mk-Navbar-module-link-eQT-Z {
+    border-radius: var(--mantine-radius-md);
+    font-weight: 500;
+}
+
+.mk-Navbar-module-linkIcon-5b3By {
+    color: var(--mantine-color-gray-6);
+}
+
+[data-mantine-color-scheme='dark'] .mk-Navbar-module-linkIcon-5b3By {
+    color: var(--mantine-color-dark-2);
+}
+
+.mk-Navbar-module-linkIcon-5b3By {
+    margin-right: var(--mantine-spacing-sm);
+    width: calc(1.5625rem * var(--mantine-scale));
+    height: calc(1.5625rem * var(--mantine-scale));
+}
+.mk-StatsGrid-module-root-zSIO5 {
+    padding: 0;
+}
+
+.mk-StatsGrid-module-value-wk1kb {
+    font-size: calc(1.5rem * var(--mantine-scale));
+    font-weight: 500;
+    line-height: 1;
+}
+
+.mk-StatsGrid-module-diff-AUfON {
+    line-height: 1;
+    display: flex;
+    align-items: center;
+}
+
+[data-mantine-color-scheme='dark'] .mk-StatsGrid-module-icon-ERQtf {
+        color: var(--mantine-color-dark-3);
+}
+
+[data-mantine-color-scheme='light'] .mk-StatsGrid-module-icon-ERQtf {
+        color: var(--mantine-color-gray-4);
+}
+
+.mk-StatsGrid-module-title-yuu3f {
+    font-weight: 500;
+    text-transform: uppercase;
+}
+.mk-Layout-module-shrinkable-JUv2C {
+    min-width: 0;
+}
+
+.mk-Layout-module-fixed-Z1ueS {
+    flex-shrink: 0;
+}
+
+.mk-Layout-module-icon-EDq-h {
+    width: 20px;
+    height: 20px;
+}
+
+[data-mantine-color-scheme='dark'] .mk-Layout-module-dark-Zx9Wz {
+        display: none;
+}
+
+[data-mantine-color-scheme='light'] .mk-Layout-module-dark-Zx9Wz {
+        display: block;
+}
+
+[data-mantine-color-scheme='light'] .mk-Layout-module-light--F7XT {
+        display: none;
+}
+
+[data-mantine-color-scheme='dark'] .mk-Layout-module-light--F7XT {
+        display: block;
+}
+
+/* Responsive spacing of the header groups: the `gap` prop of the Mantine Group accepts no values per breakpoint. */
+.mk-Layout-module-headerGap-VrPBg {
+    gap: var(--mantine-spacing-xs);
+}
+@media (min-width: 48em) {
+.mk-Layout-module-headerGap-VrPBg {
+        gap: var(--mantine-spacing-md)
+}
+}
+/*$vite$:1*/

package/dist/util/ArrayUtil.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Creates an array of the given size, with the values from 0 to size - 1.
+ * @param size size of the array
+ */
+export declare function createSequentialArray(size: number): number[];
+/**
+ * Creates an array of any size, filled with the given value.
+ * @param size size of the array
+ * @param fillValue value of every element
+ */
+export declare function createFilledArray(size: number, fillValue?: number): number[];
+/**
+ * Operation over two numbers that returns a new value from them.
+ * @param number1 a number
+ * @param number2 another number
+ * @return a new value computed from the two numbers
+ */
+export type NumbersMapFunction = (number1: number, number2: number) => number;
+/**
+ * Applies an operation to the elements at the same position of two arrays, mapping each pair of values to a new value.
+ * @param array1 an array
+ * @param array2 another array
+ * @param operation operation applied to each pair of elements at the same position (see {@link NumbersMapFunction})
+ * @param defaultItemValue value used when one array has no element at a position of the other one (when the arrays
+ *        have different sizes). A `NaN` (e.g. an empty year) is not replaced by the default: it propagates, so the
+ *        result for that position is empty too.
+ * @return a new array with the result of the operation for each position
+ */
+export declare function arraysMap(array1: number[], array2: number[], operation: NumbersMapFunction, defaultItemValue?: number): number[];
+/**
+ * Transposes a matrix, turning the rows into columns and vice versa.
+ * @param matrix matrix to transpose, where each row is an array of values
+ * @param defaultValForUndefinedCol value used when a row has no value for a column, which happens when the rows have
+ *        different sizes. Without it, the missing column is `undefined`. The parameter has no default value on purpose:
+ *        in JavaScript, passing `undefined` to a parameter with a default uses the default, so an `undefined`
+ *        explicitly asked by the caller would become another value.
+ * @return the transposed matrix
+ */
+export declare function transposeMatrix(matrix: number[][], defaultValForUndefinedCol?: number): number[][];

package/dist/util/ArrayUtil.js

@@ -0,0 +1,48 @@
+"use client";
+// src/util/ArrayUtil.ts
+/**
+* Creates an array of the given size, with the values from 0 to size - 1.
+* @param size size of the array
+*/
+function createSequentialArray(size) {
+	return Array.from({ length: size }, (_, i) => i);
+}
+/**
+* Creates an array of any size, filled with the given value.
+* @param size size of the array
+* @param fillValue value of every element
+*/
+function createFilledArray(size, fillValue = 0) {
+	return Array(size).fill(fillValue);
+}
+/**
+* Applies an operation to the elements at the same position of two arrays, mapping each pair of values to a new value.
+* @param array1 an array
+* @param array2 another array
+* @param operation operation applied to each pair of elements at the same position (see {@link NumbersMapFunction})
+* @param defaultItemValue value used when one array has no element at a position of the other one (when the arrays
+*        have different sizes). A `NaN` (e.g. an empty year) is not replaced by the default: it propagates, so the
+*        result for that position is empty too.
+* @return a new array with the result of the operation for each position
+*/
+function arraysMap(array1, array2, operation, defaultItemValue = 0) {
+	if (array1.length === 0) return array2;
+	if (array2.length === 0) return array1;
+	return createSequentialArray(Math.max(array1.length, array2.length)).map((i) => operation(array1[i] ?? defaultItemValue, array2[i] ?? defaultItemValue));
+}
+/**
+* Transposes a matrix, turning the rows into columns and vice versa.
+* @param matrix matrix to transpose, where each row is an array of values
+* @param defaultValForUndefinedCol value used when a row has no value for a column, which happens when the rows have
+*        different sizes. Without it, the missing column is `undefined`. The parameter has no default value on purpose:
+*        in JavaScript, passing `undefined` to a parameter with a default uses the default, so an `undefined`
+*        explicitly asked by the caller would become another value.
+* @return the transposed matrix
+*/
+function transposeMatrix(matrix, defaultValForUndefinedCol) {
+	const reducer = (acc, curr) => curr > acc ? curr : acc;
+	return createSequentialArray(matrix.map((line) => line.length).reduce(reducer, 0)).map((col) => matrix.map((line) => line[col] ?? defaultValForUndefinedCol));
+}
+export { arraysMap, createFilledArray, createSequentialArray, transposeMatrix };
+
+//# sourceMappingURL=ArrayUtil.js.map

package/dist/util/ArrayUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayUtil.js","names":[],"sources":["../../src/util/ArrayUtil.ts"],"sourcesContent":["/**\n * Creates an array of the given size, with the values from 0 to size - 1.\n * @param size size of the array\n */\nexport function createSequentialArray(size: number): number[] {\n    return Array.from({ length: size }, (_, i) => i);\n}\n\n/**\n * Creates an array of any size, filled with the given value.\n * @param size size of the array\n * @param fillValue value of every element\n */\nexport function createFilledArray(size: number, fillValue: number = 0): number[] {\n    return Array(size).fill(fillValue);\n}\n\n/**\n * Operation over two numbers that returns a new value from them.\n * @param number1 a number\n * @param number2 another number\n * @return a new value computed from the two numbers\n */\nexport type NumbersMapFunction = (number1: number, number2: number) => number;\n\n/**\n * Applies an operation to the elements at the same position of two arrays, mapping each pair of values to a new value.\n * @param array1 an array\n * @param array2 another array\n * @param operation operation applied to each pair of elements at the same position (see {@link NumbersMapFunction})\n * @param defaultItemValue value used when one array has no element at a position of the other one (when the arrays\n *        have different sizes). A `NaN` (e.g. an empty year) is not replaced by the default: it propagates, so the\n *        result for that position is empty too.\n * @return a new array with the result of the operation for each position\n */\nexport function arraysMap(\n    array1: number[],\n    array2: number[],\n    operation: NumbersMapFunction,\n    defaultItemValue: number = 0\n): number[] {\n    if (array1.length === 0) return array2;\n\n    if (array2.length === 0) return array1;\n\n    const maxLen = Math.max(array1.length, array2.length);\n\n    /* An array with just the indexes of the longest array, so that the result has the size of the longest one while\n       keeping the order of the arguments (which may change the result of the operation). */\n    const indexesArray = createSequentialArray(maxLen);\n    return indexesArray.map(i => operation(array1[i] ?? defaultItemValue, array2[i] ?? defaultItemValue));\n}\n\n/**\n * Transposes a matrix, turning the rows into columns and vice versa.\n * @param matrix matrix to transpose, where each row is an array of values\n * @param defaultValForUndefinedCol value used when a row has no value for a column, which happens when the rows have\n *        different sizes. Without it, the missing column is `undefined`. The parameter has no default value on purpose:\n *        in JavaScript, passing `undefined` to a parameter with a default uses the default, so an `undefined`\n *        explicitly asked by the caller would become another value.\n * @return the transposed matrix\n */\nexport function transposeMatrix(matrix: number[][], defaultValForUndefinedCol?: number): number[][] {\n    const reducer = (acc: number, curr: number) => (curr > acc ? curr : acc);\n\n    // Length of the longest row of the matrix\n    const maxCols = matrix.map(line => line.length).reduce(reducer, 0);\n    const colIndexes = createSequentialArray(maxCols);\n    // `??`, not `||`: a 0 (a real value) and a NaN (an empty year) are kept, and only a missing column uses the default.\n    return colIndexes.map(col => matrix.map(line => line[col] ?? defaultValForUndefinedCol));\n}\n"],"mappings":";;;;;;AAIA,SAAgB,sBAAsB,MAAwB;CAC1D,OAAO,MAAM,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,MAAM,CAAC;AACnD;;;;;;AAOA,SAAgB,kBAAkB,MAAc,YAAoB,GAAa;CAC7E,OAAO,MAAM,IAAI,CAAC,CAAC,KAAK,SAAS;AACrC;;;;;;;;;;;AAoBA,SAAgB,UACZ,QACA,QACA,WACA,mBAA2B,GACnB;CACR,IAAI,OAAO,WAAW,GAAG,OAAO;CAEhC,IAAI,OAAO,WAAW,GAAG,OAAO;CAOhC,OADqB,sBAJN,KAAK,IAAI,OAAO,QAAQ,OAAO,MAIH,CACpC,CAAA,CAAa,KAAI,MAAK,UAAU,OAAO,MAAM,kBAAkB,OAAO,MAAM,gBAAgB,CAAC;AACxG;;;;;;;;;;AAWA,SAAgB,gBAAgB,QAAoB,2BAAgD;CAChG,MAAM,WAAW,KAAa,SAAkB,OAAO,MAAM,OAAO;CAMpE,OAFmB,sBADH,OAAO,KAAI,SAAQ,KAAK,MAAM,CAAC,CAAC,OAAO,SAAS,CACvB,CAElC,CAAA,CAAW,KAAI,QAAO,OAAO,KAAI,SAAQ,KAAK,QAAQ,yBAAyB,CAAC;AAC3F"}

package/dist/util/ColorUtil.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Changes the shade of a hexadecimal color in the `#RRGGBB` format.
+ * @param hexColor hexadecimal color
+ * @param scale value added to (or, if negative, subtracted from) the color
+ * @return the hexadecimal color in a different shade, according to the scale
+ */
+export declare function changeColorShade(hexColor: string, scale: number): string;

package/dist/util/ColorUtil.js

@@ -0,0 +1,16 @@
+"use client";
+// src/util/ColorUtil.ts
+/**
+* Changes the shade of a hexadecimal color in the `#RRGGBB` format.
+* @param hexColor hexadecimal color
+* @param scale value added to (or, if negative, subtracted from) the color
+* @return the hexadecimal color in a different shade, according to the scale
+*/
+function changeColorShade(hexColor, scale) {
+	if (!/^#[0-9A-Fa-f]{6}$/.test(hexColor)) throw new Error("Invalid hexadecimal color code");
+	const hexDigits = hexColor.substring(1);
+	return "#" + (parseInt(hexDigits, 16) + scale).toString(16);
+}
+export { changeColorShade };
+
+//# sourceMappingURL=ColorUtil.js.map

package/dist/util/ColorUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ColorUtil.js","names":[],"sources":["../../src/util/ColorUtil.ts"],"sourcesContent":["/**\n * Changes the shade of a hexadecimal color in the `#RRGGBB` format.\n * @param hexColor hexadecimal color\n * @param scale value added to (or, if negative, subtracted from) the color\n * @return the hexadecimal color in a different shade, according to the scale\n */\nexport function changeColorShade(hexColor: string, scale: number): string {\n    if (!/^#[0-9A-Fa-f]{6}$/.test(hexColor)) {\n        throw new Error('Invalid hexadecimal color code');\n    }\n\n    // Hexadecimal code of the color, without the leading #\n    const hexDigits = hexColor.substring(1);\n    const gradedBgColorInt = parseInt(hexDigits, 16) + scale;\n    return '#' + gradedBgColorInt.toString(16);\n}\n"],"mappings":";;;;;;;;AAMA,SAAgB,iBAAiB,UAAkB,OAAuB;CACtE,IAAI,CAAC,oBAAoB,KAAK,QAAQ,GAClC,MAAM,IAAI,MAAM,gCAAgC;CAIpD,MAAM,YAAY,SAAS,UAAU,CAAC;CAEtC,OAAO,OADkB,SAAS,WAAW,EAAE,IAAI,MAAA,CACrB,SAAS,EAAE;AAC7C"}

package/dist/util/CompareUtil.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Comparison functions used to sort lists and tables according to a locale.
+ */
+/**
+ * Compares two texts according to a locale, to be used in `Array.prototype.sort`.
+ * @param locale locale of the comparison; defaults to `en-US`
+ * @return negative if `a` comes before `b`, positive if it comes after and 0 if they are equivalent
+ */
+export declare function compareText(a: string, b: string, locale?: string): number;
+/** Tells whether a value is absent (`null` or `undefined`). */
+export declare const isAbsent: (value: unknown) => value is null | undefined;
+/**
+ * Compares two values of any type in ascending order, to be used in `Array.prototype.sort`: numbers and dates by
+ * value, texts according to the locale and the other values by their text representation. Absent values
+ * (`null`/`undefined`) always come last.
+ * @param locale locale of the text comparison; defaults to `en-US`
+ * @return negative if `a` comes before `b`, positive if it comes after and 0 if they are equivalent
+ */
+export declare function compareValues(a: unknown, b: unknown, locale?: string): number;

package/dist/util/CompareUtil.js

@@ -0,0 +1,51 @@
+"use client";
+import { DEFAULT_LOCALE } from "../i18n/KitLocale.js";
+// src/util/CompareUtil.ts
+/**
+* Comparison functions used to sort lists and tables according to a locale.
+*/
+/**
+* Text collators already created, by locale. Creating an `Intl.Collator` is much more expensive than using it.
+* Accented letters stay with the letter without accent and upper case letters with the lower case ones (e.g.
+* "Émile" before "emma", which comes before "Frank"). Numbers inside the text are compared by value (`numeric`), so
+* "District 2" comes before "District 10".
+*/
+var collators = /* @__PURE__ */ new Map();
+/**
+* Returns the text collator of a locale, created only the first time.
+* @param locale locale of the comparison
+*/
+function collator(locale) {
+	let result = collators.get(locale);
+	if (!result) {
+		result = new Intl.Collator(locale, { numeric: true });
+		collators.set(locale, result);
+	}
+	return result;
+}
+/**
+* Compares two texts according to a locale, to be used in `Array.prototype.sort`.
+* @param locale locale of the comparison; defaults to `en-US`
+* @return negative if `a` comes before `b`, positive if it comes after and 0 if they are equivalent
+*/
+function compareText(a, b, locale = DEFAULT_LOCALE) {
+	return collator(locale).compare(a, b);
+}
+/** Tells whether a value is absent (`null` or `undefined`). */
+var isAbsent = (value) => value === null || value === void 0;
+/**
+* Compares two values of any type in ascending order, to be used in `Array.prototype.sort`: numbers and dates by
+* value, texts according to the locale and the other values by their text representation. Absent values
+* (`null`/`undefined`) always come last.
+* @param locale locale of the text comparison; defaults to `en-US`
+* @return negative if `a` comes before `b`, positive if it comes after and 0 if they are equivalent
+*/
+function compareValues(a, b, locale = DEFAULT_LOCALE) {
+	if (isAbsent(a) || isAbsent(b)) return Number(isAbsent(a)) - Number(isAbsent(b));
+	if (typeof a === "number" && typeof b === "number") return a - b;
+	if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime();
+	return compareText(String(a), String(b), locale);
+}
+export { compareText, compareValues, isAbsent };
+
+//# sourceMappingURL=CompareUtil.js.map

package/dist/util/CompareUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompareUtil.js","names":[],"sources":["../../src/util/CompareUtil.ts"],"sourcesContent":["/**\n * Comparison functions used to sort lists and tables according to a locale.\n */\n\nimport { DEFAULT_LOCALE } from '../i18n/KitLocale';\n\n/**\n * Text collators already created, by locale. Creating an `Intl.Collator` is much more expensive than using it.\n * Accented letters stay with the letter without accent and upper case letters with the lower case ones (e.g.\n * \"Émile\" before \"emma\", which comes before \"Frank\"). Numbers inside the text are compared by value (`numeric`), so\n * \"District 2\" comes before \"District 10\".\n */\nconst collators = new Map<string, Intl.Collator>();\n\n/**\n * Returns the text collator of a locale, created only the first time.\n * @param locale locale of the comparison\n */\nfunction collator(locale: string): Intl.Collator {\n    let result = collators.get(locale);\n    if (!result) {\n        result = new Intl.Collator(locale, { numeric: true });\n        collators.set(locale, result);\n    }\n\n    return result;\n}\n\n/**\n * Compares two texts according to a locale, to be used in `Array.prototype.sort`.\n * @param locale locale of the comparison; defaults to `en-US`\n * @return negative if `a` comes before `b`, positive if it comes after and 0 if they are equivalent\n */\nexport function compareText(a: string, b: string, locale: string = DEFAULT_LOCALE): number {\n    return collator(locale).compare(a, b);\n}\n\n/** Tells whether a value is absent (`null` or `undefined`). */\nexport const isAbsent = (value: unknown): value is null | undefined => value === null || value === undefined;\n\n/**\n * Compares two values of any type in ascending order, to be used in `Array.prototype.sort`: numbers and dates by\n * value, texts according to the locale and the other values by their text representation. Absent values\n * (`null`/`undefined`) always come last.\n * @param locale locale of the text comparison; defaults to `en-US`\n * @return negative if `a` comes before `b`, positive if it comes after and 0 if they are equivalent\n */\nexport function compareValues(a: unknown, b: unknown, locale: string = DEFAULT_LOCALE): number {\n    if (isAbsent(a) || isAbsent(b)) return Number(isAbsent(a)) - Number(isAbsent(b));\n    if (typeof a === 'number' && typeof b === 'number') return a - b;\n    if (a instanceof Date && b instanceof Date) return a.getTime() - b.getTime();\n\n    return compareText(String(a), String(b), locale);\n}\n"],"mappings":";;;;;;;;;;;;AAYA,IAAM,4BAAY,IAAI,IAA2B;;;;;AAMjD,SAAS,SAAS,QAA+B;CAC7C,IAAI,SAAS,UAAU,IAAI,MAAM;CACjC,IAAI,CAAC,QAAQ;EACT,SAAS,IAAI,KAAK,SAAS,QAAQ,EAAE,SAAS,KAAK,CAAC;EACpD,UAAU,IAAI,QAAQ,MAAM;CAChC;CAEA,OAAO;AACX;;;;;;AAOA,SAAgB,YAAY,GAAW,GAAW,SAAiB,gBAAwB;CACvF,OAAO,SAAS,MAAM,CAAC,CAAC,QAAQ,GAAG,CAAC;AACxC;;AAGA,IAAa,YAAY,UAA8C,UAAU,QAAQ,UAAU,KAAA;;;;;;;;AASnG,SAAgB,cAAc,GAAY,GAAY,SAAiB,gBAAwB;CAC3F,IAAI,SAAS,CAAC,KAAK,SAAS,CAAC,GAAG,OAAO,OAAO,SAAS,CAAC,CAAC,IAAI,OAAO,SAAS,CAAC,CAAC;CAC/E,IAAI,OAAO,MAAM,YAAY,OAAO,MAAM,UAAU,OAAO,IAAI;CAC/D,IAAI,aAAa,QAAQ,aAAa,MAAM,OAAO,EAAE,QAAQ,IAAI,EAAE,QAAQ;CAE3E,OAAO,YAAY,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,MAAM;AACnD"}

package/dist/util/DateUtil.d.ts

@@ -0,0 +1,38 @@
+/** Value of a date field: a `Date`, a text in the given format, or nothing. */
+export type DateFieldValue = Date | string | null | undefined;
+export declare const BR_DATE_FORMAT = "DD/MM/YYYY";
+export declare const ISO_DATE_FORMAT = "YYYY-MM-DD";
+/**
+ * Minimum value for a date to be considered valid when Zod coerces it. It is later than the date created by
+ * `new Date(null)` (12/31/1969), which Zod's `coerce` produces when a date field is not filled and receives `null`.
+ */
+export declare const MIN_VALID_DATE: Date;
+/**
+ * Formats a date.
+ * @param date date to format
+ * @param format format, in Day.js tokens; defaults to {@link BR_DATE_FORMAT}
+ * @return the formatted date, or `null` if there is no date
+ */
+export declare function formatDate(date: Date | undefined | null, format?: string): string | null;
+/**
+ * Formats a date in the ISO 8601 format.
+ * @param date date to format
+ * @see #ISO_DATE_FORMAT
+ */
+export declare function formatDateToISO(date: Date | undefined | null): string | null;
+/**
+ * Converts a date in the given format to a `Date` object.
+ * @param dateValue date to convert
+ * @param format format of the date, in Day.js tokens; defaults to {@link BR_DATE_FORMAT}
+ * @return the date, or `null` if there is no date
+ */
+export declare function parseDate(dateValue: DateFieldValue, format?: string): Date | null;
+/** @return the current year and month in the `YYYY-MM` format */
+export declare function getCurrentYearMonth(): string;
+/**
+ * Checks whether the end date is after the start date.
+ * @param startDate start of the interval
+ * @param endDate end of the interval; an absent or empty (before {@link MIN_VALID_DATE}) end date is valid
+ * @return `true` if the interval is valid
+ */
+export declare function validDateInterval(startDate: Date, endDate: Date | undefined): boolean;

package/dist/util/DateUtil.js

@@ -0,0 +1,55 @@
+"use client";
+import dayjs from "dayjs";
+import customParseFormat from "dayjs/plugin/customParseFormat.js";
+// src/util/DateUtil.ts
+dayjs.extend(customParseFormat);
+var BR_DATE_FORMAT = "DD/MM/YYYY";
+var ISO_DATE_FORMAT = "YYYY-MM-DD";
+/**
+* Minimum value for a date to be considered valid when Zod coerces it. It is later than the date created by
+* `new Date(null)` (12/31/1969), which Zod's `coerce` produces when a date field is not filled and receives `null`.
+*/
+var MIN_VALID_DATE = /* @__PURE__ */ new Date("01/01/1970");
+/**
+* Formats a date.
+* @param date date to format
+* @param format format, in Day.js tokens; defaults to {@link BR_DATE_FORMAT}
+* @return the formatted date, or `null` if there is no date
+*/
+function formatDate(date, format = BR_DATE_FORMAT) {
+	return date ? dayjs(date).format(format) : null;
+}
+/**
+* Formats a date in the ISO 8601 format.
+* @param date date to format
+* @see #ISO_DATE_FORMAT
+*/
+function formatDateToISO(date) {
+	return date ? dayjs(date).format(ISO_DATE_FORMAT) : null;
+}
+/**
+* Converts a date in the given format to a `Date` object.
+* @param dateValue date to convert
+* @param format format of the date, in Day.js tokens; defaults to {@link BR_DATE_FORMAT}
+* @return the date, or `null` if there is no date
+*/
+function parseDate(dateValue, format = BR_DATE_FORMAT) {
+	return dateValue ? dayjs(dateValue, format).toDate() : null;
+}
+/** @return the current year and month in the `YYYY-MM` format */
+function getCurrentYearMonth() {
+	const currentDate = /* @__PURE__ */ new Date();
+	return `${currentDate.getFullYear()}-${(currentDate.getMonth() + 1).toString().padStart(2, "0")}`;
+}
+/**
+* Checks whether the end date is after the start date.
+* @param startDate start of the interval
+* @param endDate end of the interval; an absent or empty (before {@link MIN_VALID_DATE}) end date is valid
+* @return `true` if the interval is valid
+*/
+function validDateInterval(startDate, endDate) {
+	return !endDate || endDate <= MIN_VALID_DATE || endDate > startDate;
+}
+export { BR_DATE_FORMAT, ISO_DATE_FORMAT, MIN_VALID_DATE, formatDate, formatDateToISO, getCurrentYearMonth, parseDate, validDateInterval };
+
+//# sourceMappingURL=DateUtil.js.map

package/dist/util/DateUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DateUtil.js","names":[],"sources":["../../src/util/DateUtil.ts"],"sourcesContent":["import dayjs from 'dayjs';\nimport customParseFormat from 'dayjs/plugin/customParseFormat.js';\n\n/* Without this plugin, Day.js ignores the format given to `dayjs(value, format)` and parses the text month first. */\ndayjs.extend(customParseFormat);\n\n/** Value of a date field: a `Date`, a text in the given format, or nothing. */\nexport type DateFieldValue = Date | string | null | undefined;\n\nexport const BR_DATE_FORMAT = 'DD/MM/YYYY';\nexport const ISO_DATE_FORMAT = 'YYYY-MM-DD';\n\n/**\n * Minimum value for a date to be considered valid when Zod coerces it. It is later than the date created by\n * `new Date(null)` (12/31/1969), which Zod's `coerce` produces when a date field is not filled and receives `null`.\n */\nexport const MIN_VALID_DATE = new Date('01/01/1970');\n\n/**\n * Formats a date.\n * @param date date to format\n * @param format format, in Day.js tokens; defaults to {@link BR_DATE_FORMAT}\n * @return the formatted date, or `null` if there is no date\n */\nexport function formatDate(date: Date | undefined | null, format: string = BR_DATE_FORMAT): string | null {\n    return date ? dayjs(date).format(format) : null;\n}\n\n/**\n * Formats a date in the ISO 8601 format.\n * @param date date to format\n * @see #ISO_DATE_FORMAT\n */\nexport function formatDateToISO(date: Date | undefined | null): string | null {\n    return date ? dayjs(date).format(ISO_DATE_FORMAT) : null;\n}\n\n/**\n * Converts a date in the given format to a `Date` object.\n * @param dateValue date to convert\n * @param format format of the date, in Day.js tokens; defaults to {@link BR_DATE_FORMAT}\n * @return the date, or `null` if there is no date\n */\nexport function parseDate(dateValue: DateFieldValue, format: string = BR_DATE_FORMAT): Date | null {\n    return dateValue ? dayjs(dateValue, format).toDate() : null;\n}\n\n/** @return the current year and month in the `YYYY-MM` format */\nexport function getCurrentYearMonth(): string {\n    const currentDate = new Date();\n    const year = currentDate.getFullYear();\n    const month = (currentDate.getMonth() + 1).toString().padStart(2, '0');\n    return `${year}-${month}`;\n}\n\n/**\n * Checks whether the end date is after the start date.\n * @param startDate start of the interval\n * @param endDate end of the interval; an absent or empty (before {@link MIN_VALID_DATE}) end date is valid\n * @return `true` if the interval is valid\n */\nexport function validDateInterval(startDate: Date, endDate: Date | undefined): boolean {\n    return !endDate || endDate <= MIN_VALID_DATE || endDate > startDate;\n}\n"],"mappings":";;;;AAIA,MAAM,OAAO,iBAAiB;AAK9B,IAAa,iBAAiB;AAC9B,IAAa,kBAAkB;;;;;AAM/B,IAAa,iCAAiB,IAAI,KAAK,YAAY;;;;;;;AAQnD,SAAgB,WAAW,MAA+B,SAAiB,gBAA+B;CACtG,OAAO,OAAO,MAAM,IAAI,CAAC,CAAC,OAAO,MAAM,IAAI;AAC/C;;;;;;AAOA,SAAgB,gBAAgB,MAA8C;CAC1E,OAAO,OAAO,MAAM,IAAI,CAAC,CAAC,OAAO,eAAe,IAAI;AACxD;;;;;;;AAQA,SAAgB,UAAU,WAA2B,SAAiB,gBAA6B;CAC/F,OAAO,YAAY,MAAM,WAAW,MAAM,CAAC,CAAC,OAAO,IAAI;AAC3D;;AAGA,SAAgB,sBAA8B;CAC1C,MAAM,8BAAc,IAAI,KAAK;CAG7B,OAAO,GAFM,YAAY,YAEf,EAAK,IADA,YAAY,SAAS,IAAI,EAAA,CAAG,SAAS,CAAC,CAAC,SAAS,GAAG,GAChD;AACtB;;;;;;;AAQA,SAAgB,kBAAkB,WAAiB,SAAoC;CACnF,OAAO,CAAC,WAAW,WAAW,kBAAkB,UAAU;AAC9D"}

package/dist/util/DownloadUtil.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Makes the browser download a content generated in the page itself (e.g. an exported file), as a download link would.
+ * @param blob content of the file
+ * @param fileName name of the saved file
+ */
+export declare function downloadBlob(blob: Blob, fileName: string): void;

package/dist/util/DownloadUtil.js

@@ -0,0 +1,25 @@
+"use client";
+// src/util/DownloadUtil.ts
+/**
+* Time (ms) until the URL of the downloaded content is released. The download starts after the click, asynchronously:
+* releasing the URL right after makes some browsers (e.g. Firefox and Safari) cancel the download or save an empty file.
+*/
+var REVOKE_DELAY = 1e4;
+/**
+* Makes the browser download a content generated in the page itself (e.g. an exported file), as a download link would.
+* @param blob content of the file
+* @param fileName name of the saved file
+*/
+function downloadBlob(blob, fileName) {
+	const url = URL.createObjectURL(blob);
+	const link = document.createElement("a");
+	link.href = url;
+	link.download = fileName;
+	document.body.appendChild(link);
+	link.click();
+	link.remove();
+	setTimeout(() => URL.revokeObjectURL(url), REVOKE_DELAY);
+}
+export { downloadBlob };
+
+//# sourceMappingURL=DownloadUtil.js.map

package/dist/util/DownloadUtil.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DownloadUtil.js","names":[],"sources":["../../src/util/DownloadUtil.ts"],"sourcesContent":["/**\n * Time (ms) until the URL of the downloaded content is released. The download starts after the click, asynchronously:\n * releasing the URL right after makes some browsers (e.g. Firefox and Safari) cancel the download or save an empty file.\n */\nconst REVOKE_DELAY = 10_000;\n\n/**\n * Makes the browser download a content generated in the page itself (e.g. an exported file), as a download link would.\n * @param blob content of the file\n * @param fileName name of the saved file\n */\nexport function downloadBlob(blob: Blob, fileName: string): void {\n    const url = URL.createObjectURL(blob);\n    const link = document.createElement('a');\n    link.href = url;\n    link.download = fileName;\n    document.body.appendChild(link);\n    link.click();\n    link.remove();\n    setTimeout(() => URL.revokeObjectURL(url), REVOKE_DELAY);\n}\n"],"mappings":";;;;;;AAIA,IAAM,eAAe;;;;;;AAOrB,SAAgB,aAAa,MAAY,UAAwB;CAC7D,MAAM,MAAM,IAAI,gBAAgB,IAAI;CACpC,MAAM,OAAO,SAAS,cAAc,GAAG;CACvC,KAAK,OAAO;CACZ,KAAK,WAAW;CAChB,SAAS,KAAK,YAAY,IAAI;CAC9B,KAAK,MAAM;CACX,KAAK,OAAO;CACZ,iBAAiB,IAAI,gBAAgB,GAAG,GAAG,YAAY;AAC3D"}

package/dist/util/EnumUtil.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Returns the number values of an enum. Values of other types are not returned.
+ * @param enumType enum to read the values from
+ */
+export declare function getEnumValues(enumType: object): number[];
+/**
+ * Returns the keys of an enum.
+ * @param enumType enum to read the keys from
+ * @template KeyType type of the returned keys. The keys are strings by default. To use them to read the enum values
+ *           as an array (`MyEnum[key]`), use `keyof typeof MyEnum`.
+ */
+export declare function getEnumKeys<KeyType = string>(enumType: object): KeyType[];
+/**
+ * Returns a `Map` whose keys are the values of the enum items and whose values are the keys of these items.
+ * @param enumType enum to read the entries from
+ * @template KeyType type of the returned keys. The keys are strings by default. To use them to read the enum values
+ *           as an array (`MyEnum[key]`), use `keyof typeof MyEnum`.
+ */
+export declare function getEnumEntries<KeyType = string>(enumType: object): Map<number, KeyType>;