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

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

@@ -1,6 +1,6 @@
 import { EventEmitter, OnInit, OnDestroy, TemplateRef } from '@angular/core';
 import { UiFormBuilderComponent } from './form-builder.component';
-import { UiFormSchema, UiFormSection, UiFormData, UiWizardConfig, UiWizardState, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, UiWizardValidationFn, UiFormCustomEvent } from './types/schema.types';
+import { UiFormSchema, UiFormSection, UiFormData, UiWizardConfig, UiWizardState, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, UiWizardResumeOptions, UiWizardResumeResult, UiWizardValidationFn, UiFormCustomEvent } from './types/schema.types';
 import { UiFormValidationState } from './types/validation.types';
 import * as i0 from "@angular/core";
 /**
@@ -146,10 +146,19 @@ export declare class UiFormWizardComponent implements OnInit, OnDestroy {
     finishWizard(): Promise<void>;
     /** Salva lo step corrente manualmente. */
     saveCurrentStep(): Promise<void>;
+    /**
+     * Scansiona gli step in ordine, marca come completati quelli validi rispetto alle
+     * stesse regole di Next/Completa e posiziona il wizard sul primo step non valido
+     * (o sull'ultimo se tutti validi). Utile dopo il preload di `initialData` in edit.
+     */
+    resumeCompletedStepsFromValidation(options?: UiWizardResumeOptions): Promise<UiWizardResumeResult>;
     onValueChange(data: UiFormData): void;
     onValidationChange(state: UiFormValidationState): void;
     private navigateToStep;
     private validateCurrentStep;
+    /** Naviga allo step e attende il mount del form builder per la validazione resume. */
+    private prepareStepForValidation;
+    private waitForFormBuilderReady;
     /**
      * Raggruppa le sezioni con `wizardStep` per `stepNumber` (ordine stabile per numero, poi ordine di apparizione nello schema).
      */

package/form-builder/lib/components/form-builder/sub-components/specifica-territoriale/specifica-territoriale.component.d.ts

@@ -126,6 +126,7 @@ export declare class UiSpecificaTerritorialeComponent implements ControlValueAcc
     private loadLocationData;
     private processWriteValue;
     private handleItalyByDefaultValue;
+    private emitFormValueIfReady;
     private setupFormSubscriptions;
     private handleTerritorialChanges;
     private updateNationalityState;

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

@@ -3,4 +3,4 @@ export { UiCrossFieldOperator, UiCrossFieldConfig, UiDateKeyword, UiDateValidati
 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';
-export { UiRepeatableConfig, UiWizardStepValidation, UiWizardValidationFn, UiWizardStepConfig, UiFormSection, UiFormBuilderConfig, UiWizardConfig, UiWizardState, UiFormSchema, UiFormData, UiFormCustomEvent, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, } from './schema.types';
+export { UiRepeatableConfig, UiWizardStepValidation, UiWizardValidationFn, UiWizardStepConfig, UiFormSection, UiFormBuilderConfig, UiWizardConfig, UiWizardState, UiFormSchema, UiFormData, UiFormCustomEvent, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, UiWizardResumeOptions, UiWizardResumeResult, } from './schema.types';

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

@@ -302,3 +302,23 @@ export interface UiWizardStepCompleteEvent {
     /** Dati del form al momento del completamento. */
     data: Record<string, any>;
 }
+/**
+ * Opzioni per {@link UiFormWizardComponent.resumeCompletedStepsFromValidation}.
+ * Per default il resume aggiorna solo lo stato UI (`completedSteps`, step corrente)
+ * senza emettere eventi di salvataggio o completamento step.
+ */
+export interface UiWizardResumeOptions {
+    /** Se `true`, emette `stepComplete` per ogni step validato durante lo scan. @default false */
+    emitStepComplete?: boolean;
+    /** Se `true`, invoca `onStepSave` per ogni step validato durante lo scan. @default false */
+    emitStepSave?: boolean;
+}
+/**
+ * Risultato di {@link UiFormWizardComponent.resumeCompletedStepsFromValidation}.
+ */
+export interface UiWizardResumeResult {
+    /** Ultimo indice step (0-based) marcato come completato; `-1` se nessuno. */
+    lastCompletedStep: number;
+    /** Step corrente dopo il resume (primo non valido o ultimo se tutti validi). */
+    currentStep: number;
+}

package/form-builder/lib/core/logging/logger.service.d.ts

@@ -33,7 +33,7 @@ export declare class UiLoggerService {
     /**
      * Log azione wizard (stepChange, complete, validationFailed, etc).
      */
-    logWizardAction(action: 'init' | 'stepChange' | 'stepComplete' | 'stepValidationFailed' | 'complete' | 'navigation' | 'save' | 'valueChange' | 'keyboardNavigation' | 'destroy', payload: {
+    logWizardAction(action: 'init' | 'stepChange' | 'stepComplete' | 'stepValidationFailed' | 'complete' | 'navigation' | 'save' | 'valueChange' | 'keyboardNavigation' | 'destroy' | 'resume' | 'resumeComplete', payload: {
         wizardId?: string;
         step?: number;
         [key: string]: unknown;

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

@@ -126,6 +126,7 @@ export declare class UiSpecificaTerritorialeComponent implements ControlValueAcc
     private loadLocationData;
     private processWriteValue;
     private handleItalyByDefaultValue;
+    private emitFormValueIfReady;
     private setupFormSubscriptions;
     private handleTerritorialChanges;
     private updateNationalityState;

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

@@ -3,4 +3,4 @@ export { UiCrossFieldOperator, UiCrossFieldConfig, UiDateKeyword, UiDateValidati
 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';
-export { UiRepeatableConfig, UiWizardStepValidation, UiWizardValidationFn, UiWizardStepConfig, UiFormSection, UiFormBuilderConfig, UiWizardConfig, UiWizardState, UiFormSchema, UiFormData, UiFormCustomEvent, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, } from './schema.types';
+export { UiRepeatableConfig, UiWizardStepValidation, UiWizardValidationFn, UiWizardStepConfig, UiFormSection, UiFormBuilderConfig, UiWizardConfig, UiWizardState, UiFormSchema, UiFormData, UiFormCustomEvent, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, UiWizardResumeOptions, UiWizardResumeResult, } from './schema.types';

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

@@ -302,3 +302,23 @@ export interface UiWizardStepCompleteEvent {
     /** Dati del form al momento del completamento. */
     data: Record<string, any>;
 }
+/**
+ * Opzioni per {@link UiFormWizardComponent.resumeCompletedStepsFromValidation}.
+ * Per default il resume aggiorna solo lo stato UI (`completedSteps`, step corrente)
+ * senza emettere eventi di salvataggio o completamento step.
+ */
+export interface UiWizardResumeOptions {
+    /** Se `true`, emette `stepComplete` per ogni step validato durante lo scan. @default false */
+    emitStepComplete?: boolean;
+    /** Se `true`, invoca `onStepSave` per ogni step validato durante lo scan. @default false */
+    emitStepSave?: boolean;
+}
+/**
+ * Risultato di {@link UiFormWizardComponent.resumeCompletedStepsFromValidation}.
+ */
+export interface UiWizardResumeResult {
+    /** Ultimo indice step (0-based) marcato come completato; `-1` se nessuno. */
+    lastCompletedStep: number;
+    /** Step corrente dopo il resume (primo non valido o ultimo se tutti validi). */
+    currentStep: number;
+}

package/form-builder-editor/lib/core/logging/logger.service.d.ts

@@ -33,7 +33,7 @@ export declare class UiLoggerService {
     /**
      * Log azione wizard (stepChange, complete, validationFailed, etc).
      */
-    logWizardAction(action: 'init' | 'stepChange' | 'stepComplete' | 'stepValidationFailed' | 'complete' | 'navigation' | 'save' | 'valueChange' | 'keyboardNavigation' | 'destroy', payload: {
+    logWizardAction(action: 'init' | 'stepChange' | 'stepComplete' | 'stepValidationFailed' | 'complete' | 'navigation' | 'save' | 'valueChange' | 'keyboardNavigation' | 'destroy' | 'resume' | 'resumeComplete', payload: {
         wizardId?: string;
         step?: number;
         [key: string]: unknown;

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

@@ -1,6 +1,6 @@
 import { EventEmitter, OnInit, OnDestroy, TemplateRef } from '@angular/core';
 import { UiFormBuilderComponent } from './form-builder.component';
-import { UiFormSchema, UiFormSection, UiFormData, UiWizardConfig, UiWizardState, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, UiWizardValidationFn, UiFormCustomEvent } from './types/schema.types';
+import { UiFormSchema, UiFormSection, UiFormData, UiWizardConfig, UiWizardState, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, UiWizardResumeOptions, UiWizardResumeResult, UiWizardValidationFn, UiFormCustomEvent } from './types/schema.types';
 import { UiFormValidationState } from './types/validation.types';
 import * as i0 from "@angular/core";
 /**
@@ -146,10 +146,19 @@ export declare class UiFormWizardComponent implements OnInit, OnDestroy {
     finishWizard(): Promise<void>;
     /** Salva lo step corrente manualmente. */
     saveCurrentStep(): Promise<void>;
+    /**
+     * Scansiona gli step in ordine, marca come completati quelli validi rispetto alle
+     * stesse regole di Next/Completa e posiziona il wizard sul primo step non valido
+     * (o sull'ultimo se tutti validi). Utile dopo il preload di `initialData` in edit.
+     */
+    resumeCompletedStepsFromValidation(options?: UiWizardResumeOptions): Promise<UiWizardResumeResult>;
     onValueChange(data: UiFormData): void;
     onValidationChange(state: UiFormValidationState): void;
     private navigateToStep;
     private validateCurrentStep;
+    /** Naviga allo step e attende il mount del form builder per la validazione resume. */
+    private prepareStepForValidation;
+    private waitForFormBuilderReady;
     /**
      * Raggruppa le sezioni con `wizardStep` per `stepNumber` (ordine stabile per numero, poi ordine di apparizione nello schema).
      */

package/lib/components/form-builder/sub-components/specifica-territoriale/specifica-territoriale.component.d.ts

@@ -126,6 +126,7 @@ export declare class UiSpecificaTerritorialeComponent implements ControlValueAcc
     private loadLocationData;
     private processWriteValue;
     private handleItalyByDefaultValue;
+    private emitFormValueIfReady;
     private setupFormSubscriptions;
     private handleTerritorialChanges;
     private updateNationalityState;

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

@@ -3,4 +3,4 @@ export { UiCrossFieldOperator, UiCrossFieldConfig, UiDateKeyword, UiDateValidati
 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';
-export { UiRepeatableConfig, UiWizardStepValidation, UiWizardValidationFn, UiWizardStepConfig, UiFormSection, UiFormBuilderConfig, UiWizardConfig, UiWizardState, UiFormSchema, UiFormData, UiFormCustomEvent, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, } from './schema.types';
+export { UiRepeatableConfig, UiWizardStepValidation, UiWizardValidationFn, UiWizardStepConfig, UiFormSection, UiFormBuilderConfig, UiWizardConfig, UiWizardState, UiFormSchema, UiFormData, UiFormCustomEvent, UiWizardStepChangeEvent, UiWizardStepCompleteEvent, UiWizardResumeOptions, UiWizardResumeResult, } from './schema.types';

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

@@ -302,3 +302,23 @@ export interface UiWizardStepCompleteEvent {
     /** Dati del form al momento del completamento. */
     data: Record<string, any>;
 }
+/**
+ * Opzioni per {@link UiFormWizardComponent.resumeCompletedStepsFromValidation}.
+ * Per default il resume aggiorna solo lo stato UI (`completedSteps`, step corrente)
+ * senza emettere eventi di salvataggio o completamento step.
+ */
+export interface UiWizardResumeOptions {
+    /** Se `true`, emette `stepComplete` per ogni step validato durante lo scan. @default false */
+    emitStepComplete?: boolean;
+    /** Se `true`, invoca `onStepSave` per ogni step validato durante lo scan. @default false */
+    emitStepSave?: boolean;
+}
+/**
+ * Risultato di {@link UiFormWizardComponent.resumeCompletedStepsFromValidation}.
+ */
+export interface UiWizardResumeResult {
+    /** Ultimo indice step (0-based) marcato come completato; `-1` se nessuno. */
+    lastCompletedStep: number;
+    /** Step corrente dopo il resume (primo non valido o ultimo se tutti validi). */
+    currentStep: number;
+}

package/lib/core/logging/logger.service.d.ts

@@ -33,7 +33,7 @@ export declare class UiLoggerService {
     /**
      * Log azione wizard (stepChange, complete, validationFailed, etc).
      */
-    logWizardAction(action: 'init' | 'stepChange' | 'stepComplete' | 'stepValidationFailed' | 'complete' | 'navigation' | 'save' | 'valueChange' | 'keyboardNavigation' | 'destroy', payload: {
+    logWizardAction(action: 'init' | 'stepChange' | 'stepComplete' | 'stepValidationFailed' | 'complete' | 'navigation' | 'save' | 'valueChange' | 'keyboardNavigation' | 'destroy' | 'resume' | 'resumeComplete', payload: {
         wizardId?: string;
         step?: number;
         [key: string]: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gnggln/ng-ui-system",
-  "version": "1.0.0-alpha.21",
+  "version": "1.0.0-alpha.23",
   "description": "Enterprise-grade Angular standalone component library with design tokens, a11y, and full TypeScript support.",
   "keywords": [
     "angular",
@@ -47,18 +47,18 @@
       "esm": "./esm2022/accordion/gnggln-ng-ui-system-accordion.mjs",
       "default": "./fesm2022/gnggln-ng-ui-system-accordion.mjs"
     },
-    "./base-layout": {
-      "types": "./base-layout/index.d.ts",
-      "esm2022": "./esm2022/base-layout/gnggln-ng-ui-system-base-layout.mjs",
-      "esm": "./esm2022/base-layout/gnggln-ng-ui-system-base-layout.mjs",
-      "default": "./fesm2022/gnggln-ng-ui-system-base-layout.mjs"
-    },
     "./blackbox": {
       "types": "./blackbox/index.d.ts",
       "esm2022": "./esm2022/blackbox/gnggln-ng-ui-system-blackbox.mjs",
       "esm": "./esm2022/blackbox/gnggln-ng-ui-system-blackbox.mjs",
       "default": "./fesm2022/gnggln-ng-ui-system-blackbox.mjs"
     },
+    "./base-layout": {
+      "types": "./base-layout/index.d.ts",
+      "esm2022": "./esm2022/base-layout/gnggln-ng-ui-system-base-layout.mjs",
+      "esm": "./esm2022/base-layout/gnggln-ng-ui-system-base-layout.mjs",
+      "default": "./fesm2022/gnggln-ng-ui-system-base-layout.mjs"
+    },
     "./button": {
       "types": "./button/index.d.ts",
       "esm2022": "./esm2022/button/gnggln-ng-ui-system-button.mjs",
@@ -101,18 +101,18 @@
       "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",
-      "esm": "./esm2022/modal/gnggln-ng-ui-system-modal.mjs",
-      "default": "./fesm2022/gnggln-ng-ui-system-modal.mjs"
-    },
     "./page-header": {
       "types": "./page-header/index.d.ts",
       "esm2022": "./esm2022/page-header/gnggln-ng-ui-system-page-header.mjs",
       "esm": "./esm2022/page-header/gnggln-ng-ui-system-page-header.mjs",
       "default": "./fesm2022/gnggln-ng-ui-system-page-header.mjs"
     },
+    "./modal": {
+      "types": "./modal/index.d.ts",
+      "esm2022": "./esm2022/modal/gnggln-ng-ui-system-modal.mjs",
+      "esm": "./esm2022/modal/gnggln-ng-ui-system-modal.mjs",
+      "default": "./fesm2022/gnggln-ng-ui-system-modal.mjs"
+    },
     "./table": {
       "types": "./table/index.d.ts",
       "esm2022": "./esm2022/table/gnggln-ng-ui-system-table.mjs",