@arsedizioni/ars-utils 22.5.72 → 22.6.75

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arsedizioni/ars-utils",
-  "version": "22.5.72",
+  "version": "22.6.75",
   "author": {
     "email": "software@arsedizioni.it",
     "name": "Fabio Buscaroli, Alberto Doria"

package/types/arsedizioni-ars-utils-core.validators.d.ts

@@ -438,6 +438,25 @@ declare function dateRange<TValue extends string | Date | null | undefined, TPat
  * @returns void
  */
 declare function notFuture<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
+/**
+ * Requires the value to be a date that is not in the past.
+ *
+ * The mirror image of {@link notFuture}, for the fields that can only look forward: an expiry, a
+ * deadline, the date of a course still to be held. Today counts as valid — the comparison is made
+ * on the start of the day, so a date picked this afternoon for today does not become invalid
+ * because the clock has moved on.
+ *
+ * Like {@link date}, and unlike the older {@link notFuture}, 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.scadenza); notPast(p.scadenza); });
+ */
+declare function notPast<TValue extends string | Date | null | undefined, TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<TValue, TPathKind>): void;
 /**
  * Requires the value to be a well-formed URL. An empty value passes, as everywhere else here.
  *
@@ -538,6 +557,46 @@ declare function equals<TValue, TPathKind extends PathKind = PathKind.Root>(path
  * @returns void
  */
 declare function otp<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
+/**
+ * Requires the value to be a valid Italian VAT number (partita IVA).
+ *
+ * Eleven digits whose last one is the check digit of D.P.R. 633/72, so a mistyped or invented
+ * number is caught here rather than by the backend that will refuse the invoice. An `IT` prefix
+ * and the spacing of a pasted value are tolerated, because that is the shape the number arrives
+ * in; what is stored is still whatever the user typed, since this rule only judges.
+ *
+ * An empty value passes, as everywhere else here: declaring the field mandatory is `required()`'s
+ * job.
+ *
+ * @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.partitaIva); italianVat(p.partitaIva); });
+ */
+declare function italianVat<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
+/**
+ * Requires the value to be a valid Italian fiscal code (codice fiscale).
+ *
+ * Both shapes a registry form receives are accepted: the sixteen-character code of a natural
+ * person, control character recomputed and compared, and the eleven digits of a company or a
+ * public body, whose fiscal code IS its VAT number. Nothing has to tell the rule which one is
+ * coming — the value says it by its own length.
+ *
+ * Codes altered by an "omocodia" substitution (digits replaced by letters when two people would
+ * otherwise share a code) are accepted: they are issued by the Agenzia delle Entrate and rejecting
+ * them is the classic way a form turns away a real person.
+ *
+ * An empty value passes. Pair with `required()` when the field is mandatory, and reach for
+ * {@link italianVat} instead on a field that is specifically a VAT number.
+ *
+ * @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.codiceFiscale); italianFiscalCode(p.codiceFiscale); });
+ */
+declare function italianFiscalCode<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
 /** Helpers around signal forms that are not validators themselves. */
 declare class SignalsUtils {
     /**
@@ -558,5 +617,5 @@ declare class SignalsUtils {
     }[], message?: string): string | undefined;
 }
 
-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, maxTerms, notEmpty, notEqual, notFuture, 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, sqlDate, time, url, validIf };
 export type { ArsValidatorConfig };