@arsedizioni/ars-utils 22.6.82 → 22.6.85

package/package.json

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

package/types/arsedizioni-ars-utils-clipper.ui.d.ts

@@ -1173,7 +1173,7 @@ declare class ClipperDocumentMenuComponent {
     private readonly renderer2;
     private readonly clipperService;
     readonly useSelections: _angular_core.InputSignal<boolean>;
-    readonly selectionSource: _angular_core.InputSignal<"bag" | "selection" | "none">;
+    readonly selectionSource: _angular_core.InputSignal<"none" | "bag" | "selection">;
     /**
      * Computed signal that returns the current effective document selection.
      * Re-evaluates when any input signal or the underlying selection model changes.

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

@@ -299,14 +299,14 @@ interface ArsValidatorConfig<TValue = string, TPathKind extends PathKind = PathK
  * 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.
  */
-declare const MIN_VALID_YEAR = 1970;
+declare const MIN_VALID_YEAR = 1750;
 declare const ARS_VALIDATOR_MESSAGES: Record<string, string>;
 /**
  * Requires the value to be a well-formed GUID / UUID.
@@ -372,18 +372,6 @@ declare function notEmpty<TValue extends string | readonly unknown[] | undefined
  * @returns void
  */
 declare function notEqual<TValue, TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<TValue, SchemaPathRules.Supported, TPathKind>, other: SchemaPath<TValue, SchemaPathRules.Supported>, config?: ArsValidatorConfig<TValue, TPathKind>): void;
-/**
- * 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
- */
-declare function sqlDate<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
 /**
  * Requires the value to be a real date, as {@link SystemUtils.parseDate} understands one.
  *
@@ -392,11 +380,11 @@ declare function sqlDate<TPathKind extends PathKind = PathKind.Root>(path: Schem
  * `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.
@@ -411,7 +399,7 @@ declare function date<TValue extends string | Date | null | undefined, TPathKind
  * 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
@@ -433,11 +421,17 @@ declare function dateRange<TValue extends string | Date | null | undefined, TPat
  * 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); });
  */
-declare function notFuture<TPathKind extends PathKind = PathKind.Root>(path: SchemaPath<string, SchemaPathRules.Supported, TPathKind>, config?: ArsValidatorConfig<string, TPathKind>): void;
+declare function notFuture<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 date that is not in the past.
  *
@@ -617,5 +611,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, 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 };
 export type { ArsValidatorConfig };

package/types/arsedizioni-ars-utils-ui.controls.d.ts

@@ -163,7 +163,7 @@ declare class ChipsSelectorComponent implements OnDestroy, ControlValueAccessor
     /** When `true`, at least one item must remain selected. */
     readonly mustSelect: _angular_core.InputSignal<boolean>;
     /** Layout mode: `'collapsed'` forces dropdown mode, `'dynamic'` collapses based on `collapseAt`. */
-    readonly mode: _angular_core.InputSignal<"collapsed" | "dynamic">;
+    readonly mode: _angular_core.InputSignal<"dynamic" | "collapsed">;
     /** When `true`, chips are stacked vertically instead of wrapping horizontally. */
     readonly stacked: _angular_core.InputSignal<boolean>;
     /** Chips below this index receive extra padding to align with other UI elements. */

package/types/arsedizioni-ars-utils-ui.navigation.d.ts

@@ -522,7 +522,7 @@ declare class NavigationBarComponent {
      * `compact` wraps the icon only (56x32 pill), `wide` wraps icon and label
      * together, exactly as described by the M3 Expressive specs.
      */
-    protected readonly indicatorMode: _angular_core.Signal<"compact" | "wide">;
+    protected readonly indicatorMode: _angular_core.Signal<"wide" | "compact">;
     /** Tooltip placement derived from the variant and from the anchoring edge. */
     protected readonly tooltipPosition: _angular_core.Signal<TooltipPosition>;
     /** Inline width override for the rail / drawer, or `undefined` to keep the spec default. */
@@ -568,13 +568,6 @@ declare class NavigationBarComponent {
      * branch leaves this set empty and `ancestorIds` marks the trail instead.
      */
     protected readonly highlightedIds: _angular_core.Signal<ReadonlySet<string>>;
-    /**
-     * Ids of the rows that close an expanded branch: the last nested destination
-     * before the list goes back to the top level, or before it ends. They are what
-     * carries the gap that separates a branch from what follows it — a margin on
-     * the parent would not do, because the branch it opens is not inside it.
-     */
-    protected readonly branchEndIds: _angular_core.Signal<ReadonlySet<string>>;
     /**
      * Ids of the ancestors of the active destination. No variant ever shows a parent
      * as selected, so this trail is what tells the user where they are: it marks the