@gnggln/ng-ui-system 1.0.0-alpha.20 → 1.0.0-alpha.21

package/form-builder/lib/components/form-builder/form-builder.component.d.ts

@@ -184,14 +184,18 @@ export declare class UiFormBuilderComponent implements OnInit, OnChanges, OnDest
     /**
      * Contesto passato a `ngTemplateOutlet` per il campo custom (CVA sul `control`).
      */
-    getCustomFieldOutletContext(field: UiFormFieldDescriptor, fg: FormGroup): UiCustomFieldTemplateContext;
+    getCustomFieldOutletContext(field: UiFormFieldDescriptor, fg: FormGroup, nestedErrorKeyPrefix?: string): UiCustomFieldTemplateContext;
     /**
      * Template e contesto in un solo oggetto (evita doppie valutazioni nel template).
      */
-    getCustomFieldOutlet(field: UiFormFieldDescriptor, fg: FormGroup): {
+    getCustomFieldOutlet(field: UiFormFieldDescriptor, fg: FormGroup, nestedErrorKeyPrefix?: string): {
         template: TemplateRef<unknown>;
         context: UiCustomFieldTemplateContext;
     } | null;
+    /** Prefisso chiavi errore per campi custom annidati (flat o repeatable). */
+    buildNestedErrorKeyPrefix(fieldKey: string, instanceKeyPrefix?: string): string;
+    /** Merge errori nested da CVA custom nel dettaglio error-summary. */
+    private appendCustomNestedFieldErrors;
     private isFormGroupValidExcluding;
     /** Stato di validazione completo. */
     getValidationState(): UiFormValidationState;

package/form-builder/lib/components/form-builder/types/field.types.d.ts

@@ -200,6 +200,11 @@ export interface UiCustomFieldTemplateContext {
     control: FormControl;
     /** Configurazione da `customConfig.config`. */
     config: Record<string, any>;
+    /**
+     * Prefisso per chiavi errore/scroll dei campi interni al CVA
+     * (es. `step9[0].sezioneRepertorioRegionale__`).
+     */
+    nestedErrorKeyPrefix?: string;
     /** Notifica eventi applicativi (inoltrati come `customEvent` dal form builder). */
     emitCustomEvent: (event: string, data?: any) => void;
 }

package/form-builder/lib/components/form-builder/types/index.d.ts

@@ -1,5 +1,5 @@
 export { UiFieldType, UiFieldOption, UiDynamicOptionsConfig, UiDependentOptionsConfig, UiIconTooltip, UiFileData, UiFileInputConfig, UiCustomComponentConfig, UiCustomFieldTemplateContext, UiCustomFormComponent, UiFormFieldDescriptor, } from './field.types';
-export { UiCrossFieldOperator, UiCrossFieldConfig, UiDateKeyword, UiDateValidationConfig, UiValidationType, UiValidationRule, UiFormValidationState, UiFormErrorDetail, } from './validation.types';
+export { UiCrossFieldOperator, UiCrossFieldConfig, UiDateKeyword, UiDateValidationConfig, UiValidationType, UiValidationRule, UiFormValidationState, UiFormErrorDetail, UI_FORM_NESTED_FIELD_ERRORS_KEY, } from './validation.types';
 export { UiConditionalOperator, UiFieldCondition, } from './condition.types';
 export { UiLocationFieldConfig, UiLocationConfig, UiLocationLabels, UiLocationValue, UiLocationTableConfig, UiLocationRow, } from './territoriale.types';
 export { UiGeocodedLocationType, UiGeocodedLocationInput, UiGeocodedItalianDetails, UiGeocodedForeignDetails, UiLocationGeocodedFieldConfig, } from './geocoded-location.types';

package/form-builder/lib/components/form-builder/types/validation.types.d.ts

@@ -161,6 +161,11 @@ export interface UiFormValidationState {
     /** Chiavi dei campi toccati. */
     touched: string[];
 }
+/**
+ * Chiave `ValidationErrors` usata dai CVA custom per esporre errori granulari
+ * sui campi interni (atomici) verso l'error-summary del form-builder.
+ */
+export declare const UI_FORM_NESTED_FIELD_ERRORS_KEY = "uiNestedFieldErrors";
 /**
  * Dettaglio di un errore per l'error summary.
  */

package/form-builder-editor/lib/components/form-builder/form-builder.component.d.ts

@@ -184,14 +184,18 @@ export declare class UiFormBuilderComponent implements OnInit, OnChanges, OnDest
     /**
      * Contesto passato a `ngTemplateOutlet` per il campo custom (CVA sul `control`).
      */
-    getCustomFieldOutletContext(field: UiFormFieldDescriptor, fg: FormGroup): UiCustomFieldTemplateContext;
+    getCustomFieldOutletContext(field: UiFormFieldDescriptor, fg: FormGroup, nestedErrorKeyPrefix?: string): UiCustomFieldTemplateContext;
     /**
      * Template e contesto in un solo oggetto (evita doppie valutazioni nel template).
      */
-    getCustomFieldOutlet(field: UiFormFieldDescriptor, fg: FormGroup): {
+    getCustomFieldOutlet(field: UiFormFieldDescriptor, fg: FormGroup, nestedErrorKeyPrefix?: string): {
         template: TemplateRef<unknown>;
         context: UiCustomFieldTemplateContext;
     } | null;
+    /** Prefisso chiavi errore per campi custom annidati (flat o repeatable). */
+    buildNestedErrorKeyPrefix(fieldKey: string, instanceKeyPrefix?: string): string;
+    /** Merge errori nested da CVA custom nel dettaglio error-summary. */
+    private appendCustomNestedFieldErrors;
     private isFormGroupValidExcluding;
     /** Stato di validazione completo. */
     getValidationState(): UiFormValidationState;

package/form-builder-editor/lib/components/form-builder/types/field.types.d.ts

@@ -200,6 +200,11 @@ export interface UiCustomFieldTemplateContext {
     control: FormControl;
     /** Configurazione da `customConfig.config`. */
     config: Record<string, any>;
+    /**
+     * Prefisso per chiavi errore/scroll dei campi interni al CVA
+     * (es. `step9[0].sezioneRepertorioRegionale__`).
+     */
+    nestedErrorKeyPrefix?: string;
     /** Notifica eventi applicativi (inoltrati come `customEvent` dal form builder). */
     emitCustomEvent: (event: string, data?: any) => void;
 }

package/form-builder-editor/lib/components/form-builder/types/index.d.ts

@@ -1,5 +1,5 @@
 export { UiFieldType, UiFieldOption, UiDynamicOptionsConfig, UiDependentOptionsConfig, UiIconTooltip, UiFileData, UiFileInputConfig, UiCustomComponentConfig, UiCustomFieldTemplateContext, UiCustomFormComponent, UiFormFieldDescriptor, } from './field.types';
-export { UiCrossFieldOperator, UiCrossFieldConfig, UiDateKeyword, UiDateValidationConfig, UiValidationType, UiValidationRule, UiFormValidationState, UiFormErrorDetail, } from './validation.types';
+export { UiCrossFieldOperator, UiCrossFieldConfig, UiDateKeyword, UiDateValidationConfig, UiValidationType, UiValidationRule, UiFormValidationState, UiFormErrorDetail, UI_FORM_NESTED_FIELD_ERRORS_KEY, } from './validation.types';
 export { UiConditionalOperator, UiFieldCondition, } from './condition.types';
 export { UiLocationFieldConfig, UiLocationConfig, UiLocationLabels, UiLocationValue, UiLocationTableConfig, UiLocationRow, } from './territoriale.types';
 export { UiGeocodedLocationType, UiGeocodedLocationInput, UiGeocodedItalianDetails, UiGeocodedForeignDetails, UiLocationGeocodedFieldConfig, } from './geocoded-location.types';

package/form-builder-editor/lib/components/form-builder/types/validation.types.d.ts

@@ -161,6 +161,11 @@ export interface UiFormValidationState {
     /** Chiavi dei campi toccati. */
     touched: string[];
 }
+/**
+ * Chiave `ValidationErrors` usata dai CVA custom per esporre errori granulari
+ * sui campi interni (atomici) verso l'error-summary del form-builder.
+ */
+export declare const UI_FORM_NESTED_FIELD_ERRORS_KEY = "uiNestedFieldErrors";
 /**
  * Dettaglio di un errore per l'error summary.
  */

package/lib/components/form-builder/form-builder.component.d.ts

@@ -184,14 +184,18 @@ export declare class UiFormBuilderComponent implements OnInit, OnChanges, OnDest
     /**
      * Contesto passato a `ngTemplateOutlet` per il campo custom (CVA sul `control`).
      */
-    getCustomFieldOutletContext(field: UiFormFieldDescriptor, fg: FormGroup): UiCustomFieldTemplateContext;
+    getCustomFieldOutletContext(field: UiFormFieldDescriptor, fg: FormGroup, nestedErrorKeyPrefix?: string): UiCustomFieldTemplateContext;
     /**
      * Template e contesto in un solo oggetto (evita doppie valutazioni nel template).
      */
-    getCustomFieldOutlet(field: UiFormFieldDescriptor, fg: FormGroup): {
+    getCustomFieldOutlet(field: UiFormFieldDescriptor, fg: FormGroup, nestedErrorKeyPrefix?: string): {
         template: TemplateRef<unknown>;
         context: UiCustomFieldTemplateContext;
     } | null;
+    /** Prefisso chiavi errore per campi custom annidati (flat o repeatable). */
+    buildNestedErrorKeyPrefix(fieldKey: string, instanceKeyPrefix?: string): string;
+    /** Merge errori nested da CVA custom nel dettaglio error-summary. */
+    private appendCustomNestedFieldErrors;
     private isFormGroupValidExcluding;
     /** Stato di validazione completo. */
     getValidationState(): UiFormValidationState;

package/lib/components/form-builder/types/field.types.d.ts

@@ -200,6 +200,11 @@ export interface UiCustomFieldTemplateContext {
     control: FormControl;
     /** Configurazione da `customConfig.config`. */
     config: Record<string, any>;
+    /**
+     * Prefisso per chiavi errore/scroll dei campi interni al CVA
+     * (es. `step9[0].sezioneRepertorioRegionale__`).
+     */
+    nestedErrorKeyPrefix?: string;
     /** Notifica eventi applicativi (inoltrati come `customEvent` dal form builder). */
     emitCustomEvent: (event: string, data?: any) => void;
 }

package/lib/components/form-builder/types/index.d.ts

@@ -1,5 +1,5 @@
 export { UiFieldType, UiFieldOption, UiDynamicOptionsConfig, UiDependentOptionsConfig, UiIconTooltip, UiFileData, UiFileInputConfig, UiCustomComponentConfig, UiCustomFieldTemplateContext, UiCustomFormComponent, UiFormFieldDescriptor, } from './field.types';
-export { UiCrossFieldOperator, UiCrossFieldConfig, UiDateKeyword, UiDateValidationConfig, UiValidationType, UiValidationRule, UiFormValidationState, UiFormErrorDetail, } from './validation.types';
+export { UiCrossFieldOperator, UiCrossFieldConfig, UiDateKeyword, UiDateValidationConfig, UiValidationType, UiValidationRule, UiFormValidationState, UiFormErrorDetail, UI_FORM_NESTED_FIELD_ERRORS_KEY, } from './validation.types';
 export { UiConditionalOperator, UiFieldCondition, } from './condition.types';
 export { UiLocationFieldConfig, UiLocationConfig, UiLocationLabels, UiLocationValue, UiLocationTableConfig, UiLocationRow, } from './territoriale.types';
 export { UiGeocodedLocationType, UiGeocodedLocationInput, UiGeocodedItalianDetails, UiGeocodedForeignDetails, UiLocationGeocodedFieldConfig, } from './geocoded-location.types';

package/lib/components/form-builder/types/validation.types.d.ts

@@ -161,6 +161,11 @@ export interface UiFormValidationState {
     /** Chiavi dei campi toccati. */
     touched: string[];
 }
+/**
+ * Chiave `ValidationErrors` usata dai CVA custom per esporre errori granulari
+ * sui campi interni (atomici) verso l'error-summary del form-builder.
+ */
+export declare const UI_FORM_NESTED_FIELD_ERRORS_KEY = "uiNestedFieldErrors";
 /**
  * Dettaglio di un errore per l'error summary.
  */

package/lib/version/ng-ui-system-version.d.ts

@@ -2,7 +2,7 @@
  * Versione del pacchetto `@gnggln/ng-ui-system` (allineata a `packages/ng-ui-system/package.json`).
  * Non modificare manualmente: eseguire `npm run version:sync` dalla root del workspace.
  */
-export declare const NG_UI_SYSTEM_VERSION: "1.0.0-alpha.19";
+export declare const NG_UI_SYSTEM_VERSION: "1.0.0-alpha.20";
 /**
  * Etichetta da mostrare in UI (prefisso `v` + SemVer npm).
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gnggln/ng-ui-system",
-  "version": "1.0.0-alpha.20",
+  "version": "1.0.0-alpha.21",
   "description": "Enterprise-grade Angular standalone component library with design tokens, a11y, and full TypeScript support.",
   "keywords": [
     "angular",
@@ -89,18 +89,18 @@
       "esm": "./esm2022/form-builder-editor/gnggln-ng-ui-system-form-builder-editor.mjs",
       "default": "./fesm2022/gnggln-ng-ui-system-form-builder-editor.mjs"
     },
-    "./layout-builder": {
-      "types": "./layout-builder/index.d.ts",
-      "esm2022": "./esm2022/layout-builder/gnggln-ng-ui-system-layout-builder.mjs",
-      "esm": "./esm2022/layout-builder/gnggln-ng-ui-system-layout-builder.mjs",
-      "default": "./fesm2022/gnggln-ng-ui-system-layout-builder.mjs"
-    },
     "./http": {
       "types": "./http/index.d.ts",
       "esm2022": "./esm2022/http/gnggln-ng-ui-system-http.mjs",
       "esm": "./esm2022/http/gnggln-ng-ui-system-http.mjs",
       "default": "./fesm2022/gnggln-ng-ui-system-http.mjs"
     },
+    "./layout-builder": {
+      "types": "./layout-builder/index.d.ts",
+      "esm2022": "./esm2022/layout-builder/gnggln-ng-ui-system-layout-builder.mjs",
+      "esm": "./esm2022/layout-builder/gnggln-ng-ui-system-layout-builder.mjs",
+      "default": "./fesm2022/gnggln-ng-ui-system-layout-builder.mjs"
+    },
     "./modal": {
       "types": "./modal/index.d.ts",
       "esm2022": "./esm2022/modal/gnggln-ng-ui-system-modal.mjs",