@arsedizioni/ars-utils 22.0.43 → 22.0.47

package/package.json

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

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

@@ -1049,7 +1049,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<"selection" | "bag" | "none">;
     /**
      * 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.d.ts

@@ -405,20 +405,20 @@ declare class EmailsValidatorDirective implements Validator {
  * The host control is re-validated whenever the OTHER control's value changes:
  * without this, typing a new password AFTER the confirmation field was filled
  * left the form incorrectly valid (the classic password/confirm bug).
+ *
+ * IMPORTANT (reciprocal-binding safety): the re-validation triggered from the
+ * other control's `valueChanges` runs with `{ emitEvent: false }`. Calling
+ * Angular's `onValidatorChange` instead would re-emit valueChanges, so a
+ * reciprocal setup (A [equals]=B and B [equals]=A) would overflow the stack.
  */
 declare class EqualsValidatorDirective implements Validator {
     /** The control whose value must match the host control's value. */
     readonly equals: i0.InputSignal<AbstractControl<any, any, any>>;
-    /** Callback registered by Angular forms to re-run validation on the host control. */
-    private onValidatorChange?;
+    /** The host control, captured on the first validate() call. */
+    private hostControl?;
     /** Subscription to the other control's valueChanges. */
     private subscription?;
     constructor();
-    /**
-     * Registers the callback Angular invokes to re-run this validator.
-     * @param fn - The revalidation callback provided by the forms API.
-     */
-    registerOnValidatorChange(fn: () => void): void;
     /**
      * Validates that the host control value equals the bound control's value.
      * Returns `null` (valid) when no control is bound.
@@ -504,20 +504,21 @@ declare class NotEmptyValidatorDirective implements Validator {
  *
  * The host control is re-validated whenever the OTHER control's value changes,
  * so editing either field keeps both error states consistent.
+ *
+ * IMPORTANT (reciprocal-binding safety): the re-validation triggered from the
+ * other control's `valueChanges` is run with `{ emitEvent: false }`. Using
+ * Angular's `onValidatorChange` here instead would call `host.updateValueAndValidity()`
+ * WITH events, so a reciprocal setup (A [notEqual]=B and B [notEqual]=A) would
+ * ping-pong valueChanges between the two controls and overflow the stack.
  */
 declare class NotEqualValidatorDirective implements Validator {
     /** The control whose value must differ from the host control's value. */
     readonly notEqual: i0.InputSignal<AbstractControl<any, any, any>>;
-    /** Callback registered by Angular forms to re-run validation on the host control. */
-    private onValidatorChange?;
+    /** The host control, captured on the first validate() call. */
+    private hostControl?;
     /** Subscription to the other control's valueChanges. */
     private subscription?;
     constructor();
-    /**
-     * Registers the callback Angular invokes to re-run this validator.
-     * @param fn - The revalidation callback provided by the forms API.
-     */
-    registerOnValidatorChange(fn: () => void): void;
     /**
      * Validates that the host control value is not equal to the bound control's value.
      * Also clears the `notequal` error on the other control when the host becomes valid.

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

@@ -1293,6 +1293,7 @@ declare function applyVisibility(el: {
         display: string;
     };
 }, setStyle: (prop: string, value: string) => void, removeStyle: (prop: string) => void, visible: boolean, prevDisplay: string | null): string | null;
+declare function toBool(v: string | boolean | null | undefined): boolean | undefined;
 declare class FxShowHideDirective extends ResponsiveBaseDirective {
     readonly fxShow: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
     readonly showXs: _angular_core.InputSignalWithTransform<boolean, string | boolean>;
@@ -1344,29 +1345,48 @@ declare class FxShowHideDirective extends ResponsiveBaseDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FxShowHideDirective, "    [fxShow],    [fxHide],    [fxShow.xs],    [fxShow.sm],    [fxShow.md],    [fxShow.lg],    [fxShow.xl],    [fxShow.lt-sm],    [fxShow.lt-md],    [fxShow.lt-lg],    [fxShow.lt-xl],    [fxShow.gt-xs],    [fxShow.gt-sm],    [fxShow.gt-md],    [fxShow.gt-lg],    [fxShow.sm-up],    [fxShow.md-up],    [fxShow.lg-up],    [fxShow.xl-up],    [fxShow.sm-down],    [fxShow.md-down],    [fxShow.lg-down],    [fxHide.xs],    [fxHide.sm],    [fxHide.md],    [fxHide.lg],    [fxHide.xl],    [fxHide.lt-sm],    [fxHide.lt-md],    [fxHide.lt-lg],    [fxHide.lt-xl],    [fxHide.gt-xs],    [fxHide.gt-sm],    [fxHide.gt-md],    [fxHide.gt-lg],    [fxHide.sm-up],    [fxHide.md-up],    [fxHide.lg-up],    [fxHide.xl-up],    [fxHide.sm-down],    [fxHide.md-down],    [fxHide.lg-down]  ", never, { "fxShow": { "alias": "fxShow"; "required": false; "isSignal": true; }; "showXs": { "alias": "fxShow.xs"; "required": false; "isSignal": true; }; "showSm": { "alias": "fxShow.sm"; "required": false; "isSignal": true; }; "showMd": { "alias": "fxShow.md"; "required": false; "isSignal": true; }; "showLg": { "alias": "fxShow.lg"; "required": false; "isSignal": true; }; "showXl": { "alias": "fxShow.xl"; "required": false; "isSignal": true; }; "showLtSm": { "alias": "fxShow.lt-sm"; "required": false; "isSignal": true; }; "showLtMd": { "alias": "fxShow.lt-md"; "required": false; "isSignal": true; }; "showLtLg": { "alias": "fxShow.lt-lg"; "required": false; "isSignal": true; }; "showLtXl": { "alias": "fxShow.lt-xl"; "required": false; "isSignal": true; }; "showGtXs": { "alias": "fxShow.gt-xs"; "required": false; "isSignal": true; }; "showGtSm": { "alias": "fxShow.gt-sm"; "required": false; "isSignal": true; }; "showGtMd": { "alias": "fxShow.gt-md"; "required": false; "isSignal": true; }; "showGtLg": { "alias": "fxShow.gt-lg"; "required": false; "isSignal": true; }; "showSmUp": { "alias": "fxShow.sm-up"; "required": false; "isSignal": true; }; "showMdUp": { "alias": "fxShow.md-up"; "required": false; "isSignal": true; }; "showLgUp": { "alias": "fxShow.lg-up"; "required": false; "isSignal": true; }; "showXlUp": { "alias": "fxShow.xl-up"; "required": false; "isSignal": true; }; "showSmDown": { "alias": "fxShow.sm-down"; "required": false; "isSignal": true; }; "showMdDown": { "alias": "fxShow.md-down"; "required": false; "isSignal": true; }; "showLgDown": { "alias": "fxShow.lg-down"; "required": false; "isSignal": true; }; "fxHide": { "alias": "fxHide"; "required": false; "isSignal": true; }; "hideXs": { "alias": "fxHide.xs"; "required": false; "isSignal": true; }; "hideSm": { "alias": "fxHide.sm"; "required": false; "isSignal": true; }; "hideMd": { "alias": "fxHide.md"; "required": false; "isSignal": true; }; "hideLg": { "alias": "fxHide.lg"; "required": false; "isSignal": true; }; "hideXl": { "alias": "fxHide.xl"; "required": false; "isSignal": true; }; "hideLtSm": { "alias": "fxHide.lt-sm"; "required": false; "isSignal": true; }; "hideLtMd": { "alias": "fxHide.lt-md"; "required": false; "isSignal": true; }; "hideLtLg": { "alias": "fxHide.lt-lg"; "required": false; "isSignal": true; }; "hideLtXl": { "alias": "fxHide.lt-xl"; "required": false; "isSignal": true; }; "hideGtXs": { "alias": "fxHide.gt-xs"; "required": false; "isSignal": true; }; "hideGtSm": { "alias": "fxHide.gt-sm"; "required": false; "isSignal": true; }; "hideGtMd": { "alias": "fxHide.gt-md"; "required": false; "isSignal": true; }; "hideGtLg": { "alias": "fxHide.gt-lg"; "required": false; "isSignal": true; }; "hideSmUp": { "alias": "fxHide.sm-up"; "required": false; "isSignal": true; }; "hideMdUp": { "alias": "fxHide.md-up"; "required": false; "isSignal": true; }; "hideLgUp": { "alias": "fxHide.lg-up"; "required": false; "isSignal": true; }; "hideXlUp": { "alias": "fxHide.xl-up"; "required": false; "isSignal": true; }; "hideSmDown": { "alias": "fxHide.sm-down"; "required": false; "isSignal": true; }; "hideMdDown": { "alias": "fxHide.md-down"; "required": false; "isSignal": true; }; "hideLgDown": { "alias": "fxHide.lg-down"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** A single style value. Numbers are stringified; an optional `.unit` suffix on the key is appended. */
+type StyleValue = string | number | null | undefined;
+/**
+ * NgStyle-compatible style input (same shape accepted by @ngbracket/ngx-layout):
+ *   - a raw style string:                 `'max-width: 30px; color: red'`
+ *   - an array of strings / maps:         `['color: red', { 'max-width.px': 30 }]`
+ *   - a property→value map, with optional `.unit` suffix on the key:
+ *                                         `{ 'max-width.px': 30, color: 'red' }`
+ */
+type StyleInput = string | Array<string | Record<string, StyleValue>> | Record<string, StyleValue>;
+/** Internal, fully-resolved representation handed to the DOM effect. */
 type StyleMap = Record<string, string>;
+/**
+ * Flattens any {@link StyleInput} into a plain `{ property: cssValue }` map,
+ * resolving `'prop.unit': value` keys (e.g. `'max-width.px': 30` → `max-width: '30px'`)
+ * and stringifying numeric values. `null` / `undefined` / `''` values are skipped.
+ * @param v - The raw style input (or undefined).
+ * @returns A normalised `{ property: value }` map ready for `Renderer2.setStyle`.
+ */
+declare function normalizeStyle(v: StyleInput | undefined): StyleMap;
 declare class FxStyleDirective extends ResponsiveBaseDirective {
-    readonly fxStyle: _angular_core.InputSignal<StyleMap>;
-    readonly xs: _angular_core.InputSignal<StyleMap>;
-    readonly sm: _angular_core.InputSignal<StyleMap>;
-    readonly md: _angular_core.InputSignal<StyleMap>;
-    readonly lg: _angular_core.InputSignal<StyleMap>;
-    readonly xl: _angular_core.InputSignal<StyleMap>;
-    readonly ltSm: _angular_core.InputSignal<StyleMap>;
-    readonly ltMd: _angular_core.InputSignal<StyleMap>;
-    readonly ltLg: _angular_core.InputSignal<StyleMap>;
-    readonly ltXl: _angular_core.InputSignal<StyleMap>;
-    readonly gtXs: _angular_core.InputSignal<StyleMap>;
-    readonly gtSm: _angular_core.InputSignal<StyleMap>;
-    readonly gtMd: _angular_core.InputSignal<StyleMap>;
-    readonly gtLg: _angular_core.InputSignal<StyleMap>;
-    readonly smUp: _angular_core.InputSignal<StyleMap>;
-    readonly mdUp: _angular_core.InputSignal<StyleMap>;
-    readonly lgUp: _angular_core.InputSignal<StyleMap>;
-    readonly xlUp: _angular_core.InputSignal<StyleMap>;
-    readonly smDown: _angular_core.InputSignal<StyleMap>;
-    readonly mdDown: _angular_core.InputSignal<StyleMap>;
-    readonly lgDown: _angular_core.InputSignal<StyleMap>;
+    readonly fxStyle: _angular_core.InputSignal<StyleInput>;
+    readonly xs: _angular_core.InputSignal<StyleInput>;
+    readonly sm: _angular_core.InputSignal<StyleInput>;
+    readonly md: _angular_core.InputSignal<StyleInput>;
+    readonly lg: _angular_core.InputSignal<StyleInput>;
+    readonly xl: _angular_core.InputSignal<StyleInput>;
+    readonly ltSm: _angular_core.InputSignal<StyleInput>;
+    readonly ltMd: _angular_core.InputSignal<StyleInput>;
+    readonly ltLg: _angular_core.InputSignal<StyleInput>;
+    readonly ltXl: _angular_core.InputSignal<StyleInput>;
+    readonly gtXs: _angular_core.InputSignal<StyleInput>;
+    readonly gtSm: _angular_core.InputSignal<StyleInput>;
+    readonly gtMd: _angular_core.InputSignal<StyleInput>;
+    readonly gtLg: _angular_core.InputSignal<StyleInput>;
+    readonly smUp: _angular_core.InputSignal<StyleInput>;
+    readonly mdUp: _angular_core.InputSignal<StyleInput>;
+    readonly lgUp: _angular_core.InputSignal<StyleInput>;
+    readonly xlUp: _angular_core.InputSignal<StyleInput>;
+    readonly smDown: _angular_core.InputSignal<StyleInput>;
+    readonly mdDown: _angular_core.InputSignal<StyleInput>;
+    readonly lgDown: _angular_core.InputSignal<StyleInput>;
     private readonly _resolved;
     /** Tracks which CSS properties were last applied — plain field, not a signal. */
     private _appliedProps;
@@ -1375,6 +1395,12 @@ declare class FxStyleDirective extends ResponsiveBaseDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<FxStyleDirective, "    [fxStyle],    [fxStyle.xs],    [fxStyle.sm],    [fxStyle.md],    [fxStyle.lg],    [fxStyle.xl],    [fxStyle.lt-sm],    [fxStyle.lt-md],    [fxStyle.lt-lg],    [fxStyle.lt-xl],    [fxStyle.gt-xs],    [fxStyle.gt-sm],    [fxStyle.gt-md],    [fxStyle.gt-lg],    [fxStyle.sm-up],    [fxStyle.md-up],    [fxStyle.lg-up],    [fxStyle.xl-up],    [fxStyle.sm-down],    [fxStyle.md-down],    [fxStyle.lg-down]  ", never, { "fxStyle": { "alias": "fxStyle"; "required": false; "isSignal": true; }; "xs": { "alias": "fxStyle.xs"; "required": false; "isSignal": true; }; "sm": { "alias": "fxStyle.sm"; "required": false; "isSignal": true; }; "md": { "alias": "fxStyle.md"; "required": false; "isSignal": true; }; "lg": { "alias": "fxStyle.lg"; "required": false; "isSignal": true; }; "xl": { "alias": "fxStyle.xl"; "required": false; "isSignal": true; }; "ltSm": { "alias": "fxStyle.lt-sm"; "required": false; "isSignal": true; }; "ltMd": { "alias": "fxStyle.lt-md"; "required": false; "isSignal": true; }; "ltLg": { "alias": "fxStyle.lt-lg"; "required": false; "isSignal": true; }; "ltXl": { "alias": "fxStyle.lt-xl"; "required": false; "isSignal": true; }; "gtXs": { "alias": "fxStyle.gt-xs"; "required": false; "isSignal": true; }; "gtSm": { "alias": "fxStyle.gt-sm"; "required": false; "isSignal": true; }; "gtMd": { "alias": "fxStyle.gt-md"; "required": false; "isSignal": true; }; "gtLg": { "alias": "fxStyle.gt-lg"; "required": false; "isSignal": true; }; "smUp": { "alias": "fxStyle.sm-up"; "required": false; "isSignal": true; }; "mdUp": { "alias": "fxStyle.md-up"; "required": false; "isSignal": true; }; "lgUp": { "alias": "fxStyle.lg-up"; "required": false; "isSignal": true; }; "xlUp": { "alias": "fxStyle.xl-up"; "required": false; "isSignal": true; }; "smDown": { "alias": "fxStyle.sm-down"; "required": false; "isSignal": true; }; "mdDown": { "alias": "fxStyle.md-down"; "required": false; "isSignal": true; }; "lgDown": { "alias": "fxStyle.lg-down"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 type ClassInput = string | string[] | Record<string, boolean>;
+/**
+ * Converts any {@link ClassInput} into a flat set of active class names.
+ * @param v - The class input (string, array, or `{ class: enabled }` map), or undefined.
+ * @returns A `Set` of the class names that should be applied.
+ */
+declare function toClassSet(v: ClassInput | undefined): Set<string>;
 declare class FxClassDirective extends ResponsiveBaseDirective {
     readonly fxClass: _angular_core.InputSignal<ClassInput>;
     readonly xs: _angular_core.InputSignal<ClassInput>;
@@ -1411,5 +1437,5 @@ declare class FlexLayoutModule {
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<FlexLayoutModule>;
 }
 
-export { ALIAS_FAMILIES, ALIAS_INDEX, BS5_BREAKPOINTS, BusyDialogComponent, BusyTimer, CANONICAL_ALIASES, ConfirmDialogComponent, CredentialsDialogComponent, DeleteDialogComponent, DeleteDialogConfirmMode, DialogService, FlexLayoutModule, FxClassDirective, FxFlexAlignDirective, FxFlexDirective, FxFlexFillDirective, FxFlexOffsetDirective, FxFlexOrderDirective, FxGridAreaDirective, FxGridColumnDirective, FxGridDirective, FxLayoutAlignDirective, FxLayoutDirective, FxLayoutGapDirective, FxLayoutWrapDirective, FxShowHideDirective, FxStyleDirective, IfBpDirective, InfoDialogComponent, LAYOUT_BREAKPOINTS, LAYOUT_VALUES, MediaObserver, NON_CANONICAL_PRIORITY, OtpInputComponent, PaginatorIntl, PasswordStrengthComponent, RecoverPasswordDialogComponent, ResetPasswordDialogComponent, ResponsiveBaseDirective, ToastComponent, UIService, applyVisibility, buildAlignStyles, buildFlexStyles, buildLayoutCSS, resolve, resolveAll, resolveFlexInput, resolveNonCanonical, resolveParentFlow, validateBasis, validateLayoutValue, validateWrapValue };
+export { ALIAS_FAMILIES, ALIAS_INDEX, BS5_BREAKPOINTS, BusyDialogComponent, BusyTimer, CANONICAL_ALIASES, ConfirmDialogComponent, CredentialsDialogComponent, DeleteDialogComponent, DeleteDialogConfirmMode, DialogService, FlexLayoutModule, FxClassDirective, FxFlexAlignDirective, FxFlexDirective, FxFlexFillDirective, FxFlexOffsetDirective, FxFlexOrderDirective, FxGridAreaDirective, FxGridColumnDirective, FxGridDirective, FxLayoutAlignDirective, FxLayoutDirective, FxLayoutGapDirective, FxLayoutWrapDirective, FxShowHideDirective, FxStyleDirective, IfBpDirective, InfoDialogComponent, LAYOUT_BREAKPOINTS, LAYOUT_VALUES, MediaObserver, NON_CANONICAL_PRIORITY, OtpInputComponent, PaginatorIntl, PasswordStrengthComponent, RecoverPasswordDialogComponent, ResetPasswordDialogComponent, ResponsiveBaseDirective, ToastComponent, UIService, applyVisibility, buildAlignStyles, buildFlexStyles, buildLayoutCSS, normalizeStyle, resolve, resolveAll, resolveFlexInput, resolveNonCanonical, resolveParentFlow, toBool, toClassSet, validateBasis, validateLayoutValue, validateWrapValue };
 export type { BpValues, BreakpointAlias, CanonicalKey, ConfirmDialogData, ConfirmDialogOption, CredentialsDialogData, CredentialsDialogResult, DeleteDialogData, DialogOption, DialogResult, IDialogService, InfoDialogData, NcValues, NonCanonicalKey, RecoverPasswordDialogData, RecoverPasswordDialogResult, ResetPasswordDialogData, ResetPasswordDialogMode, ResetPasswordDialogResult, ToastData };