commons-shared-web-ui 0.0.46 → 0.0.48

package/index.d.ts

@@ -1,10 +1,10 @@
 import * as i0 from '@angular/core';
-import { OnChanges, EventEmitter, SimpleChanges, ChangeDetectorRef, OnInit, OnDestroy, ElementRef, PipeTransform, NgZone, AfterViewInit, QueryList } from '@angular/core';
+import { OnChanges, EventEmitter, SimpleChanges, ChangeDetectorRef, OnInit, OnDestroy, ElementRef, QueryList, PipeTransform, NgZone, AfterViewInit } from '@angular/core';
 import * as i2 from '@angular/material/snack-bar';
 import { MatSnackBar, MatSnackBarRef } from '@angular/material/snack-bar';
 import * as i2$1 from '@angular/common';
 import * as i3$1 from '@angular/forms';
-import { FormGroup, FormBuilder, FormArray, FormControl, ValidatorFn, ControlValueAccessor, AbstractControl, ValidationErrors } from '@angular/forms';
+import { FormGroup, FormControl, FormArray, FormBuilder, ValidatorFn, ControlValueAccessor, AbstractControl, ValidationErrors } from '@angular/forms';
 import { HttpClient, HttpHeaders } from '@angular/common/http';
 import * as i3$2 from '@angular/router';
 import { Router, ActivatedRoute } from '@angular/router';
@@ -1215,212 +1215,6 @@ declare class ExpressionService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ExpressionService>;
 }
 
-declare class SmartFormComponent implements OnInit, OnChanges, OnDestroy {
-    private fb;
-    controller: SmartFormController;
-    private expressionService;
-    private http;
-    private snackbarService;
-    private router;
-    private cdr;
-    private destroy$;
-    formJson: string;
-    initialValues?: {
-        [key: string]: any;
-    };
-    enableDraftAutoSave: boolean;
-    /** Flat i18n labels map passed by the consuming app.
-     *  After JSON parse the schema is walked and every string value that
-     *  matches a key in this map is replaced with the translated value.
-     *  Mirrors the pattern used by ConfigurableFormComponent + translateConfig.
-     */
-    labels: any;
-    mode: 'CREATE' | 'EDIT';
-    /** When true, all form fields are disabled and the action bar is hidden (preview/read-only mode). */
-    readOnly: boolean;
-    submit: EventEmitter<{
-        [key: string]: any;
-    }>;
-    draftSave: EventEmitter<string>;
-    /**
-     * Emitted when a button with a custom `type` (not 'cancel', 'draft', or
-     * 'submit') is clicked. Payload contains the button `id` and the current
-     * form data snapshot.
-     */
-    actionClick: EventEmitter<{
-        id: string;
-        formData: {
-            [key: string]: any;
-        };
-    }>;
-    valueChange: EventEmitter<{
-        [key: string]: any;
-    }>;
-    fileAdded: EventEmitter<any>;
-    fileUploadFinished: EventEmitter<any>;
-    fileRemoved: EventEmitter<any>;
-    /** Emitted when a suffixActionIcon is clicked. Payload: { fieldName, actionId } */
-    suffixActionClick: EventEmitter<{
-        fieldName: string;
-        actionId: string;
-    }>;
-    /** Emitted whenever the active section step changes. Carries current state so the
-     *  host can show/hide Previous/Next/Submit buttons in its own footer. */
-    stepChange: EventEmitter<{
-        currentStep: number;
-        totalSteps: number;
-        isFirst: boolean;
-        isLast: boolean;
-        stepLabel: string;
-    }>;
-    formSchema: FormSchema;
-    formGroup: FormGroup;
-    fieldList: FieldConfig[];
-    isStepper: boolean;
-    currentStep: number;
-    isLoading: boolean;
-    isDraftLoading: boolean;
-    /** True when sectionStepper mode is active (SECTION form with top-level GROUPs as steps). */
-    isSectionStepper: boolean;
-    /** Index of the currently visible section step. */
-    currentSectionStep: number;
-    /** Flat list of top-level GROUP FieldConfigs that become the stepper steps. */
-    sectionSteps: FieldConfig[];
-    /** Validation state per section step — drives badge colour/icon. */
-    stepValidationStates: ('untouched' | 'valid' | 'warning')[];
-    /** Flat field-name lists per step used for targeted validation. */
-    private stepFieldNames;
-    /** Controls skeleton visibility. Stays false until schema is parsed AND
-     *  any EDIT-mode data fetch completes, but always shows for at least
-     *  SKELETON_MIN_MS so the animation is visible even on fast loads. */
-    isFormReady: boolean;
-    private readonly SKELETON_MIN_MS;
-    private _skeletonStart;
-    constructor(fb: FormBuilder, controller: SmartFormController, expressionService: ExpressionService, http: HttpClient, snackbarService: SnackbarService, router: Router, cdr: ChangeDetectorRef);
-    ngOnInit(): void;
-    loadEditData(): void;
-    /** Flips isFormReady=true after the skeleton has been visible for at least SKELETON_MIN_MS. */
-    private _markReady;
-    ngOnChanges(changes: SimpleChanges): void;
-    ngOnDestroy(): void;
-    /** Public backward-compatible entry point — delegates to _startForm. */
-    parseFormJson(): void;
-    private _startForm;
-    private _applySchema;
-    initializeForm(): void;
-    collectFields(fields: FieldConfig[]): void;
-    handleSubmit(): void;
-    /**
-     * Universal action handler for any button click.
-     * One handler decides how to process based on action.kind.
-     */
-    handleButtonClick(btn: ActionButtonConfig): void;
-    private fireActionApiCall;
-    /**
-     * Constructs nested payload by checking field properties on form controls.
-     */
-    collectFormData(): {
-        [key: string]: any;
-    };
-    /**
-     * Deep merges the source object (e.g. extraPayload) into the target object (e.g. form payload).
-     */
-    private deepMerge;
-    private buildNestedPayload;
-    private setNestedValue;
-    private extractGroupValue;
-    validate(): boolean;
-    scrollToFirstInvalidControl(): void;
-    submitToApi(formData: any, actionType?: 'submit' | 'draft', btn?: ActionButtonConfig): void;
-    showAlert(type: 'success' | 'error' | 'warning' | 'info', message: string, customConfig?: any): void;
-    /** Builds HttpHeaders from the token stored in the controller (sourced from configJSON). */
-    getHeaders(): HttpHeaders;
-    nextStep(): void;
-    previousStep(): void;
-    get canGoNext(): boolean;
-    get canGoPrevious(): boolean;
-    get currentStepConfig(): FieldConfig | undefined;
-    /** Advance to the next section step. Called by the host footer "Next" button.
-     *  Validates the current step first — marks it valid (green) or warning (orange). */
-    navigateToNext(): void;
-    /** Go back to the previous section step. Called by the host footer "Previous" button. */
-    navigateToPrevious(): void;
-    /** Jump directly to a specific section step by index.
-     *  Validates the step being left so the badge state updates correctly. */
-    goToSectionStep(index: number): void;
-    get isSectionStepFirst(): boolean;
-    get isSectionStepLast(): boolean;
-    /** Returns the SectionConfig for a given step — passed to lib-form-section.
-     *  The outer label is intentionally omitted because the stepper nav already
-     *  displays it; showing it again inside the content would be redundant. */
-    getSectionStepConfig(step: FieldConfig): any;
-    private _emitStepChange;
-    /** Marks all controls in the given step as touched and records valid/warning state. */
-    private _validateStep;
-    /** Recursively collects all leaf field names from a set of FieldConfigs. */
-    private _collectFieldNames;
-    get nextLabel(): string;
-    get submitLabel(): string;
-    get previousLabel(): string;
-    get actionBarConfig(): ActionBarConfig | undefined;
-    /**
-     * Returns buttons for a given alignment, sorted by `order` (stable).
-     */
-    getButtonsForAlignment(alignment: 'left' | 'right'): ActionButtonConfig[];
-    getButtonLabel(btn: ActionButtonConfig): string;
-    isButtonDisabled(btn: ActionButtonConfig): boolean;
-    private getButtonByActionKind;
-    private navigateTo;
-    private _hasHierarchyDynamic;
-    private _expandHierarchyNodes;
-    private _expandNodeRecursive;
-    private _expandSingleNode;
-    private _normalizeHierarchyCfg;
-    private _fetchHierarchyTemplate;
-    private _buildHierarchyFields;
-    private _getPathValue;
-    private _codeToFieldName;
-    private _codeToLabel;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SmartFormComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SmartFormComponent, "lib-smart-form", never, { "formJson": { "alias": "formJson"; "required": false; }; "initialValues": { "alias": "initialValues"; "required": false; }; "enableDraftAutoSave": { "alias": "enableDraftAutoSave"; "required": false; }; "labels": { "alias": "labels"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "readOnly": { "alias": "readOnly"; "required": false; }; }, { "submit": "submit"; "draftSave": "draftSave"; "actionClick": "actionClick"; "valueChange": "valueChange"; "fileAdded": "fileAdded"; "fileUploadFinished": "fileUploadFinished"; "fileRemoved": "fileRemoved"; "suffixActionClick": "suffixActionClick"; "stepChange": "stepChange"; }, never, never, false, never>;
-}
-
-declare class FormSectionComponent implements OnInit, OnDestroy {
-    private fb;
-    config: SectionConfig;
-    controller: SmartFormController;
-    formGroup: FormGroup;
-    /**
-     * For allowMulti sections: the FormArray registered on the root formGroup.
-     * Each element is a FormGroup representing one repeater instance.
-     */
-    repeaterFormArray: FormArray;
-    /** Tracks which accordion panels are open (by index). New instances start expanded. */
-    expandedInstances: Set<number>;
-    /**
-     * The key under which the FormArray is registered in the root formGroup.
-     * Falls back to config.name or a generated key.
-     */
-    get arrayKey(): string;
-    constructor(fb: FormBuilder);
-    ngOnInit(): void;
-    ngOnDestroy(): void;
-    /** Creates a fresh FormGroup for one repeater instance */
-    private createInstanceGroup;
-    addInstance(): void;
-    removeInstance(index: number): void;
-    toggleInstance(index: number): void;
-    isExpanded(index: number): boolean;
-    getInstanceGroup(index: number): FormGroup;
-    get instanceGroups(): FormGroup[];
-    /** For non-allowMulti sections we simply pass the root formGroup down */
-    get flatFormGroup(): FormGroup;
-    /** Flatten a field tree to get all leaf fields (for ROW children etc.) */
-    getFlatFields(fields: FieldConfig[]): FieldConfig[];
-    static ɵfac: i0.ɵɵFactoryDeclaration<FormSectionComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FormSectionComponent, "lib-form-section", never, { "config": { "alias": "config"; "required": false; }; "controller": { "alias": "controller"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; }, {}, never, never, false, never>;
-}
-
 interface ConfirmationModalConfig {
     title: string;
     headerTheme?: 'light' | 'dark';
@@ -1628,6 +1422,13 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     private setupFormulaValidation;
     addGroupInstance(initialData?: any): void;
     saveGroupInstance(index: number): void;
+    /**
+     * Re-opens any repeater instance (multiSave card or standard accordion panel)
+     * whose nested FormGroup is invalid, so errors hidden by a collapsed card/panel
+     * become visible. Called by the root form when a submit attempt is blocked.
+     * Returns true if at least one invalid instance was revealed.
+     */
+    revealInvalidInstances(): boolean;
     cancelGroupInstance(index: number): void;
     editGroupInstance(index: number): void;
     toggleExpandGroupInstance(index: number): void;
@@ -1818,6 +1619,213 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<FormFieldComponent, "lib-form-field", never, { "config": { "alias": "config"; "required": false; }; "controller": { "alias": "controller"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; "allowMulti": { "alias": "allowMulti"; "required": false; }; }, {}, never, never, false, never>;
 }
 
+declare class SmartFormComponent implements OnInit, OnChanges, OnDestroy {
+    private fb;
+    controller: SmartFormController;
+    private expressionService;
+    private http;
+    private snackbarService;
+    private router;
+    private cdr;
+    formFieldComponents: QueryList<FormFieldComponent>;
+    private destroy$;
+    formJson: string;
+    initialValues?: {
+        [key: string]: any;
+    };
+    enableDraftAutoSave: boolean;
+    /** Flat i18n labels map passed by the consuming app.
+     *  After JSON parse the schema is walked and every string value that
+     *  matches a key in this map is replaced with the translated value.
+     *  Mirrors the pattern used by ConfigurableFormComponent + translateConfig.
+     */
+    labels: any;
+    mode: 'CREATE' | 'EDIT';
+    /** When true, all form fields are disabled and the action bar is hidden (preview/read-only mode). */
+    readOnly: boolean;
+    submit: EventEmitter<{
+        [key: string]: any;
+    }>;
+    draftSave: EventEmitter<string>;
+    /**
+     * Emitted when a button with a custom `type` (not 'cancel', 'draft', or
+     * 'submit') is clicked. Payload contains the button `id` and the current
+     * form data snapshot.
+     */
+    actionClick: EventEmitter<{
+        id: string;
+        formData: {
+            [key: string]: any;
+        };
+    }>;
+    valueChange: EventEmitter<{
+        [key: string]: any;
+    }>;
+    fileAdded: EventEmitter<any>;
+    fileUploadFinished: EventEmitter<any>;
+    fileRemoved: EventEmitter<any>;
+    /** Emitted when a suffixActionIcon is clicked. Payload: { fieldName, actionId } */
+    suffixActionClick: EventEmitter<{
+        fieldName: string;
+        actionId: string;
+    }>;
+    /** Emitted whenever the active section step changes. Carries current state so the
+     *  host can show/hide Previous/Next/Submit buttons in its own footer. */
+    stepChange: EventEmitter<{
+        currentStep: number;
+        totalSteps: number;
+        isFirst: boolean;
+        isLast: boolean;
+        stepLabel: string;
+    }>;
+    formSchema: FormSchema;
+    formGroup: FormGroup;
+    fieldList: FieldConfig[];
+    isStepper: boolean;
+    currentStep: number;
+    isLoading: boolean;
+    isDraftLoading: boolean;
+    /** True when sectionStepper mode is active (SECTION form with top-level GROUPs as steps). */
+    isSectionStepper: boolean;
+    /** Index of the currently visible section step. */
+    currentSectionStep: number;
+    /** Flat list of top-level GROUP FieldConfigs that become the stepper steps. */
+    sectionSteps: FieldConfig[];
+    /** Validation state per section step — drives badge colour/icon. */
+    stepValidationStates: ('untouched' | 'valid' | 'warning')[];
+    /** Flat field-name lists per step used for targeted validation. */
+    private stepFieldNames;
+    /** Controls skeleton visibility. Stays false until schema is parsed AND
+     *  any EDIT-mode data fetch completes, but always shows for at least
+     *  SKELETON_MIN_MS so the animation is visible even on fast loads. */
+    isFormReady: boolean;
+    private readonly SKELETON_MIN_MS;
+    private _skeletonStart;
+    constructor(fb: FormBuilder, controller: SmartFormController, expressionService: ExpressionService, http: HttpClient, snackbarService: SnackbarService, router: Router, cdr: ChangeDetectorRef);
+    ngOnInit(): void;
+    loadEditData(): void;
+    /** Flips isFormReady=true after the skeleton has been visible for at least SKELETON_MIN_MS. */
+    private _markReady;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngOnDestroy(): void;
+    /** Public backward-compatible entry point — delegates to _startForm. */
+    parseFormJson(): void;
+    private _startForm;
+    private _applySchema;
+    initializeForm(): void;
+    collectFields(fields: FieldConfig[]): void;
+    handleSubmit(): void;
+    /**
+     * Universal action handler for any button click.
+     * One handler decides how to process based on action.kind.
+     */
+    handleButtonClick(btn: ActionButtonConfig): void;
+    private fireActionApiCall;
+    /**
+     * Constructs nested payload by checking field properties on form controls.
+     */
+    collectFormData(): {
+        [key: string]: any;
+    };
+    /**
+     * Deep merges the source object (e.g. extraPayload) into the target object (e.g. form payload).
+     */
+    private deepMerge;
+    private buildNestedPayload;
+    private setNestedValue;
+    private extractGroupValue;
+    validate(): boolean;
+    scrollToFirstInvalidControl(): void;
+    submitToApi(formData: any, actionType?: 'submit' | 'draft', btn?: ActionButtonConfig): void;
+    showAlert(type: 'success' | 'error' | 'warning' | 'info', message: string, customConfig?: any): void;
+    /** Builds HttpHeaders from the token stored in the controller (sourced from configJSON). */
+    getHeaders(): HttpHeaders;
+    nextStep(): void;
+    previousStep(): void;
+    get canGoNext(): boolean;
+    get canGoPrevious(): boolean;
+    get currentStepConfig(): FieldConfig | undefined;
+    /** Advance to the next section step. Called by the host footer "Next" button.
+     *  Validates the current step first — marks it valid (green) or warning (orange). */
+    navigateToNext(): void;
+    /** Go back to the previous section step. Called by the host footer "Previous" button. */
+    navigateToPrevious(): void;
+    /** Jump directly to a specific section step by index.
+     *  Validates the step being left so the badge state updates correctly. */
+    goToSectionStep(index: number): void;
+    get isSectionStepFirst(): boolean;
+    get isSectionStepLast(): boolean;
+    /** Returns the SectionConfig for a given step — passed to lib-form-section.
+     *  The outer label is intentionally omitted because the stepper nav already
+     *  displays it; showing it again inside the content would be redundant. */
+    getSectionStepConfig(step: FieldConfig): any;
+    private _emitStepChange;
+    /** Marks all controls in the given step as touched and records valid/warning state. */
+    private _validateStep;
+    /** Recursively collects all leaf field names from a set of FieldConfigs. */
+    private _collectFieldNames;
+    get nextLabel(): string;
+    get submitLabel(): string;
+    get previousLabel(): string;
+    get actionBarConfig(): ActionBarConfig | undefined;
+    /**
+     * Returns buttons for a given alignment, sorted by `order` (stable).
+     */
+    getButtonsForAlignment(alignment: 'left' | 'right'): ActionButtonConfig[];
+    getButtonLabel(btn: ActionButtonConfig): string;
+    isButtonDisabled(btn: ActionButtonConfig): boolean;
+    private getButtonByActionKind;
+    private navigateTo;
+    private _hasHierarchyDynamic;
+    private _expandHierarchyNodes;
+    private _expandNodeRecursive;
+    private _expandSingleNode;
+    private _normalizeHierarchyCfg;
+    private _fetchHierarchyTemplate;
+    private _buildHierarchyFields;
+    private _getPathValue;
+    private _codeToFieldName;
+    private _codeToLabel;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SmartFormComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SmartFormComponent, "lib-smart-form", never, { "formJson": { "alias": "formJson"; "required": false; }; "initialValues": { "alias": "initialValues"; "required": false; }; "enableDraftAutoSave": { "alias": "enableDraftAutoSave"; "required": false; }; "labels": { "alias": "labels"; "required": false; }; "mode": { "alias": "mode"; "required": false; }; "readOnly": { "alias": "readOnly"; "required": false; }; }, { "submit": "submit"; "draftSave": "draftSave"; "actionClick": "actionClick"; "valueChange": "valueChange"; "fileAdded": "fileAdded"; "fileUploadFinished": "fileUploadFinished"; "fileRemoved": "fileRemoved"; "suffixActionClick": "suffixActionClick"; "stepChange": "stepChange"; }, never, never, false, never>;
+}
+
+declare class FormSectionComponent implements OnInit, OnDestroy {
+    private fb;
+    config: SectionConfig;
+    controller: SmartFormController;
+    formGroup: FormGroup;
+    /**
+     * For allowMulti sections: the FormArray registered on the root formGroup.
+     * Each element is a FormGroup representing one repeater instance.
+     */
+    repeaterFormArray: FormArray;
+    /** Tracks which accordion panels are open (by index). New instances start expanded. */
+    expandedInstances: Set<number>;
+    /**
+     * The key under which the FormArray is registered in the root formGroup.
+     * Falls back to config.name or a generated key.
+     */
+    get arrayKey(): string;
+    constructor(fb: FormBuilder);
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    /** Creates a fresh FormGroup for one repeater instance */
+    private createInstanceGroup;
+    addInstance(): void;
+    removeInstance(index: number): void;
+    toggleInstance(index: number): void;
+    isExpanded(index: number): boolean;
+    getInstanceGroup(index: number): FormGroup;
+    get instanceGroups(): FormGroup[];
+    /** For non-allowMulti sections we simply pass the root formGroup down */
+    get flatFormGroup(): FormGroup;
+    /** Flatten a field tree to get all leaf fields (for ROW children etc.) */
+    getFlatFields(fields: FieldConfig[]): FieldConfig[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<FormSectionComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FormSectionComponent, "lib-form-section", never, { "config": { "alias": "config"; "required": false; }; "controller": { "alias": "controller"; "required": false; }; "formGroup": { "alias": "formGroup"; "required": false; }; }, {}, never, never, false, never>;
+}
+
 /**
  * Bypasses Angular's DomSanitizer for resource URLs (e.g. YouTube embed iframes).
  * Used only for trusted URLs such as YouTube embed links derived from user-provided video IDs.
@@ -3923,8 +3931,15 @@ declare class SmartTableComponent implements OnInit, OnChanges, AfterViewInit, O
 }
 
 /**
- * Sanitizes and bypasses Angular's DomSanitizer security for HTML content.
- * Prevents execution of unsafe scripts/attributes while allowing safe rendering of formatting tags in [innerHTML].
+ * Marks rich-text HTML (e.g. from a smart-table "html" column, always sourced from this
+ * app's own rich-text editor output, never arbitrary external/user-supplied markup) as
+ * trusted so [innerHTML] renders it without Angular's default HTML sanitizer stripping it.
+ *
+ * Deliberately does NOT run the value through DomSanitizer.sanitize(SecurityContext.HTML, ...)
+ * first — that sanitizer strips `style` attributes entirely (they're not in its allowlist),
+ * which silently destroyed rich-text formatting like text color and highlight color while
+ * leaving semantic-tag formatting (bold/italic/underline) untouched, since only tags — not
+ * inline styles — survive that pass.
  */
 declare class SafeHtmlPipe implements PipeTransform {
     private sanitizer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "commons-shared-web-ui",
-  "version": "0.0.46",
+  "version": "0.0.48",
   "peerDependencies": {
     "@angular/animations": "20.3.15",
     "@angular/cdk": "20.2.14",