@arsedizioni/ars-utils 22.6.82 → 22.6.85

package/fesm2022/arsedizioni-ars-utils-core.validators.mjs

@@ -888,20 +888,21 @@ function isValidItalianFiscalCode(value) {
  * leave the map with a kind nobody produces.
  */
 /**
- * Earliest date {@link date} and {@link dateRange} accept: 1 January 1970.
+ * Earliest year {@link date} and {@link dateRange} accept: 1750.
  *
- * Everything this application stores — events, certificates, payments, communications — happened
- * after it, so an earlier value is always a typo (a two-digit year, a slipped keystroke) and never
- * real data. The floor is deliberately higher than the one of {@link sqlDate}, which only asks
- * what SQL Server can physically store.
+ * It is the floor of what the backend can store, and it is set that low on purpose: a birth date,
+ * the date of an old norm or the commissioning of an old machine are real data well before 1970.
+ * What it does catch is the 01/01/0001 or 01/01/0020 that a mistyped year produces, which SQL
+ * Server would reject with an error nobody can read.
  */
-const MIN_VALID_YEAR = 1970;
+const MIN_VALID_YEAR = 1750;
 const ARS_VALIDATOR_MESSAGES = {
     required: 'Obbligatorio',
     guid: 'Ticket non riconosciuto',
     password: 'Password non sufficientemente robusta',
     notEmpty: 'Non può essere vuoto o contenere solo spazi.',
     notEqual: 'Deve essere diverso dall\'altro valore',
+    // Emitted by `SqlDateValidatorDirective`, which a `[formField]` on a ControlValueAccessor still reads.
     sqlDate: 'Data non valida',
     date: 'Data non valida',
     dateRange: 'Intervallo non valido',
@@ -1019,31 +1020,6 @@ function notEqual(path, other, config) {
         return isValid ? null : { kind: 'notEqual', message: config?.message ?? ARS_VALIDATOR_MESSAGES['notEqual'] };
     });
 }
-/**
- * Requires the value to be a date the backend can store: parseable, and after 1750.
- *
- * The signal-form counterpart of `SqlDateValidatorDirective`. The year floor is not arbitrary —
- * it is what separates a real date from the 01/01/0001 that a mistyped year produces, which SQL
- * Server rejects with an error nobody can read.
- *
- * @param path   - Path of the field to validate.
- * @param config - Optional message override and `when` condition.
- * @returns void
- */
-function sqlDate(path, config) {
-    validate(path, ctx => {
-        if (config?.when && !config.when(ctx))
-            return null;
-        const input = ctx.value();
-        if (!input || input.length === 0)
-            return null;
-        const parsed = SystemUtils.parseDate(input);
-        const invalid = { kind: 'sqlDate', message: config?.message ?? ARS_VALIDATOR_MESSAGES['sqlDate'] };
-        if (!parsed)
-            return invalid;
-        return endOfDay(parsed).getFullYear() > 1750 ? null : invalid;
-    });
-}
 /**
  * Requires the value to be a real date, as {@link SystemUtils.parseDate} understands one.
  *
@@ -1052,11 +1028,11 @@ function sqlDate(path, config) {
  * `parseDate` handles the shapes this codebase produces (ISO, `dd/MM/yyyy`, `yyyy-MM-dd`, and the
  * shorthand forms). Empty passes — saying "obbligatorio" is the job of `required()`.
  *
- * A date earlier than {@link MIN_VALID_YEAR} (1 January 1970) is rejected: nothing this
- * application stores predates it, so an earlier value is a typo rather than data.
+ * A date earlier than {@link MIN_VALID_YEAR} (1750) is rejected: it is what the backend can
+ * store, so an earlier value is a mistyped year rather than data.
  *
- * Distinct from {@link sqlDate} on purpose: that one is about what the DATABASE can store (the
- * 1750 floor), this one is about whether the value is a date at all. Pair them when both matter.
+ * It is also the signal-form counterpart of `SqlDateValidatorDirective`: one rule for every date,
+ * whether it is typed or picked.
  *
  * @param path   - Path of the field to validate.
  * @param config - Optional message override and `when` condition.
@@ -1083,7 +1059,7 @@ function date(path, config) {
  * Written for the two inputs of a `mat-date-range-input`, whose start and end live in two
  * separate fields of the model. Each end is checked with the same rule as {@link date}, and the
  * ordering is checked only when BOTH ends are filled in — a half-open range ("from today
- * onwards") is a legitimate filter, not an error. The 1 January 1970 floor of {@link date}
+ * onwards") is a legitimate filter, not an error. The {@link MIN_VALID_YEAR} floor of {@link date}
  * applies to both ends.
  *
  * The rule is bound to BOTH paths, so the error appears on whichever end the user is looking at
@@ -1140,16 +1116,22 @@ function dateRange(from, to, config) {
  * comparison is made on the end of the day, so a date entered this morning does not become
  * invalid because the clock says 09:00.
  *
+ * Like {@link notPast}, it accepts both the `Date` a Material datepicker writes into the model and
+ * the text of a plain input. An empty value passes: saying "obbligatorio" is the job of
+ * `required()`.
+ *
  * @param path   - Path of the field to validate.
  * @param config - Optional message override and `when` condition.
  * @returns void
+ * @example
+ * const f = form(this.model, p => { required(p.executionDate); notFuture(p.executionDate); });
  */
 function notFuture(path, config) {
     validate(path, ctx => {
         if (config?.when && !config.when(ctx))
             return null;
         const input = ctx.value();
-        if (!input || input.length === 0)
+        if (input === undefined || input === null || input === '')
             return null;
         const parsed = SystemUtils.parseDate(input);
         const invalid = { kind: 'notFuture', message: config?.message ?? ARS_VALIDATOR_MESSAGES['notFuture'] };
@@ -1539,5 +1521,5 @@ class SignalsUtils {
  * Generated bundle index. Do not edit.
  */
 
-export { ARS_VALIDATOR_MESSAGES, EmailsValidatorDirective, EqualsValidatorDirective, FileSizeValidatorDirective, GuidValidatorDirective, MIN_VALID_YEAR, MaxTermsValidatorDirective, NotEmptyValidatorDirective, NotEqualValidatorDirective, NotFutureValidatorDirective, PasswordValidatorDirective, SignalsUtils, SqlDateValidatorDirective, TimeValidatorDirective, UrlValidatorDirective, ValidIfDirective, ValidatorDirective, date, dateRange, emails, equals, fileSize, guid, italianFiscalCode, italianVat, maxTerms, notEmpty, notEqual, notFuture, notPast, otp, password, sqlDate, time, url, validIf };
+export { ARS_VALIDATOR_MESSAGES, EmailsValidatorDirective, EqualsValidatorDirective, FileSizeValidatorDirective, GuidValidatorDirective, MIN_VALID_YEAR, MaxTermsValidatorDirective, NotEmptyValidatorDirective, NotEqualValidatorDirective, NotFutureValidatorDirective, PasswordValidatorDirective, SignalsUtils, SqlDateValidatorDirective, TimeValidatorDirective, UrlValidatorDirective, ValidIfDirective, ValidatorDirective, date, dateRange, emails, equals, fileSize, guid, italianFiscalCode, italianVat, maxTerms, notEmpty, notEqual, notFuture, notPast, otp, password, time, url, validIf };
 //# sourceMappingURL=arsedizioni-ars-utils-core.validators.mjs.map