commons-shared-web-ui 0.0.25 → 0.0.27

package/index.d.ts

@@ -1,5 +1,7 @@
 import * as i0 from '@angular/core';
 import { OnChanges, EventEmitter, SimpleChanges, ChangeDetectorRef, OnInit, OnDestroy, ElementRef, PipeTransform, AfterViewInit, QueryList, NgZone } 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';
@@ -7,8 +9,6 @@ import { HttpClient, HttpHeaders } from '@angular/common/http';
 import * as i3$2 from '@angular/router';
 import { Router, ActivatedRoute } from '@angular/router';
 import { BehaviorSubject, Subject, Observable } from 'rxjs';
-import * as i2 from '@angular/material/snack-bar';
-import { MatSnackBar, MatSnackBarRef } from '@angular/material/snack-bar';
 import { DomSanitizer, SafeResourceUrl } from '@angular/platform-browser';
 import * as i1 from '@angular/material/card';
 import * as i3 from '@angular/material/checkbox';
@@ -632,8 +632,15 @@ declare class FieldSelectionService {
      * Initialize the store from a FormSchema.
      */
     loadSchema(schema: FormSchema): void;
+    /**
+     * Load a schema while preserving the expanded/collapsed state of sections and groups.
+     * Used when the schema structure hasn't changed but field selections have.
+     * This prevents the UI from unexpectedly collapsing sections when the user toggles a field.
+     */
+    loadSchemaPreservingExpanded(schema: FormSchema): void;
     /**
      * Toggle a group's enabled state. Disabling cascades to all sections + fields.
+     * When enabling, all fields are selected (unless locked).
      */
     toggleGroup(groupIndex: number): void;
     /**
@@ -658,9 +665,19 @@ declare class FieldSelectionService {
      */
     buildUpdatedSchema(): FormSchema | null;
     private _disableAllSections;
+    /**
+     * Enable all sections and their fields (except locked ones).
+     * Used when toggling a section/group back ON to restore field selections.
+     */
+    private _enableAllSections;
     private _toggleSectionAtPath;
     private _toggleExpandedAtPath;
     private _toggleFieldAtPath;
+    /**
+     * Recursively merge expansion state from old sections into new sections.
+     * Preserves which sections were expanded/collapsed by the user.
+     */
+    private _mergeExpandedSections;
     static ɵfac: i0.ɵɵFactoryDeclaration<FieldSelectionService, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<FieldSelectionService>;
 }
@@ -668,7 +685,20 @@ declare class FieldSelectionService {
 declare class FieldSelectionComponent implements OnChanges {
     schema: FormSchema;
     schemaChange: EventEmitter<FormSchema>;
+    /**
+     * When true, the enable/disable toggle is hidden for option-driven field types
+     * (DROPDOWN, RADIO, MULTI_SELECT, etc.).
+     * Useful for business-user-facing form configurators where developers
+     * pre-fill the option data and these fields should always be included.
+     * Defaults to false (show toggle for all fields).
+     */
+    hideToggleForOptionTypes: boolean;
     protected readonly store: FieldSelectionService;
+    /**
+     * Flag to track if the next schema change is from internal toggles.
+     * When true, we'll use loadSchemaPreservingExpanded() to keep user's expansion state.
+     */
+    private _isInternalChange;
     ngOnChanges(changes: SimpleChanges): void;
     onToggleGroup(groupIndex: number): void;
     onToggleGroupExpanded(groupIndex: number): void;
@@ -678,7 +708,7 @@ declare class FieldSelectionComponent implements OnChanges {
     trackByGroupIndex(index: number): number;
     private _emitChange;
     static ɵfac: i0.ɵɵFactoryDeclaration<FieldSelectionComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FieldSelectionComponent, "lib-field-selection", never, { "schema": { "alias": "schema"; "required": true; }; }, { "schemaChange": "schemaChange"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FieldSelectionComponent, "lib-field-selection", never, { "schema": { "alias": "schema"; "required": true; }; "hideToggleForOptionTypes": { "alias": "hideToggleForOptionTypes"; "required": false; }; }, { "schemaChange": "schemaChange"; }, never, never, false, never>;
 }
 
 /**
@@ -771,6 +801,13 @@ declare class FieldConfiguratorService {
 declare class FieldConfiguratorComponent implements OnChanges {
     schema: FormSchema;
     schemaChange: EventEmitter<FormSchema>;
+    /**
+     * When false, the optionConfig section (apiUrl, dataPath, etc.) is hidden
+     * from the configurator panel. Useful for business-user-facing configurators
+     * where option URLs are pre-filled by the developer.
+     * Defaults to true (show everything).
+     */
+    showOptionConfig: boolean;
     readonly store: FieldConfiguratorService;
     private readonly schemaMapOverride;
     /**
@@ -786,12 +823,14 @@ declare class FieldConfiguratorComponent implements OnChanges {
     onTypeChange(builderType: string): void;
     private _emitChange;
     static ɵfac: i0.ɵɵFactoryDeclaration<FieldConfiguratorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<FieldConfiguratorComponent, "lib-field-configurator", never, { "schema": { "alias": "schema"; "required": true; }; }, { "schemaChange": "schemaChange"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<FieldConfiguratorComponent, "lib-field-configurator", never, { "schema": { "alias": "schema"; "required": true; }; "showOptionConfig": { "alias": "showOptionConfig"; "required": false; }; }, { "schemaChange": "schemaChange"; }, never, never, false, never>;
 }
 
 declare class GroupNodeComponent {
     group: SelectionGroupNode;
     groupIndex: number;
+    /** Propagated from FieldSelectionComponent — see SelectionFieldNodeComponent for details. */
+    hideToggleForOptionTypes: boolean;
     toggleEnabled: EventEmitter<void>;
     toggleExpanded: EventEmitter<void>;
     sectionToggleEnabled: EventEmitter<number[]>;
@@ -808,13 +847,15 @@ declare class GroupNodeComponent {
     }): void;
     trackBySectionIndex(index: number): number;
     static ɵfac: i0.ɵɵFactoryDeclaration<GroupNodeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<GroupNodeComponent, "lib-group-node", never, { "group": { "alias": "group"; "required": true; }; "groupIndex": { "alias": "groupIndex"; "required": true; }; }, { "toggleEnabled": "toggleEnabled"; "toggleExpanded": "toggleExpanded"; "sectionToggleEnabled": "sectionToggleEnabled"; "sectionToggleExpanded": "sectionToggleExpanded"; "fieldToggle": "fieldToggle"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<GroupNodeComponent, "lib-group-node", never, { "group": { "alias": "group"; "required": true; }; "groupIndex": { "alias": "groupIndex"; "required": true; }; "hideToggleForOptionTypes": { "alias": "hideToggleForOptionTypes"; "required": false; }; }, { "toggleEnabled": "toggleEnabled"; "toggleExpanded": "toggleExpanded"; "sectionToggleEnabled": "sectionToggleEnabled"; "sectionToggleExpanded": "sectionToggleExpanded"; "fieldToggle": "fieldToggle"; }, never, never, false, never>;
 }
 
 declare class SelectionSectionNodeComponent {
     section: SelectionSectionNode;
     sectionIndex: number;
     depth: number;
+    /** Propagated from FieldSelectionComponent — see SelectionFieldNodeComponent for details. */
+    hideToggleForOptionTypes: boolean;
     /** Emits the sub-path from this node downward (empty [] for self) */
     toggleEnabled: EventEmitter<number[]>;
     toggleExpanded: EventEmitter<number[]>;
@@ -836,14 +877,21 @@ declare class SelectionSectionNodeComponent {
     trackByFieldIndex(index: number): number;
     trackBySubsectionIndex(index: number): number;
     static ɵfac: i0.ɵɵFactoryDeclaration<SelectionSectionNodeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SelectionSectionNodeComponent, "lib-selection-section-node", never, { "section": { "alias": "section"; "required": true; }; "sectionIndex": { "alias": "sectionIndex"; "required": true; }; "depth": { "alias": "depth"; "required": false; }; }, { "toggleEnabled": "toggleEnabled"; "toggleExpanded": "toggleExpanded"; "fieldToggle": "fieldToggle"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SelectionSectionNodeComponent, "lib-selection-section-node", never, { "section": { "alias": "section"; "required": true; }; "sectionIndex": { "alias": "sectionIndex"; "required": true; }; "depth": { "alias": "depth"; "required": false; }; "hideToggleForOptionTypes": { "alias": "hideToggleForOptionTypes"; "required": false; }; }, { "toggleEnabled": "toggleEnabled"; "toggleExpanded": "toggleExpanded"; "fieldToggle": "fieldToggle"; }, never, never, false, never>;
 }
 
 declare class SelectionFieldNodeComponent {
     field: SelectionFieldNode;
     toggleSelected: EventEmitter<void>;
+    /**
+     * When true, the enable/disable toggle is hidden for option-driven field types
+     * (DROPDOWN, RADIO, MULTI_SELECT, etc.). These types have their options
+     * pre-configured by the developer and shouldn't be toggled by business users.
+     */
+    hideToggleForOptionTypes: boolean;
+    get isOptionDrivenType(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<SelectionFieldNodeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SelectionFieldNodeComponent, "lib-selection-field-node", never, { "field": { "alias": "field"; "required": true; }; }, { "toggleSelected": "toggleSelected"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SelectionFieldNodeComponent, "lib-selection-field-node", never, { "field": { "alias": "field"; "required": true; }; "hideToggleForOptionTypes": { "alias": "hideToggleForOptionTypes"; "required": false; }; }, { "toggleSelected": "toggleSelected"; }, never, never, false, never>;
 }
 
 declare class ConfiguratorTreeComponent {
@@ -861,15 +909,44 @@ declare class ConfiguratorTreeComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<ConfiguratorTreeComponent, "lib-configurator-tree", never, { "tree": { "alias": "tree"; "required": false; }; "selectedFieldPath": { "alias": "selectedFieldPath"; "required": false; }; }, { "selectField": "selectField"; "toggleExpanded": "toggleExpanded"; }, never, never, false, never>;
 }
 
+type SnackbarVariant = 'success' | 'error' | 'warning' | 'info';
+interface SnackbarConfig {
+    message: string;
+    variant?: SnackbarVariant;
+    duration?: number;
+    horizontalPosition?: 'start' | 'center' | 'end' | 'left' | 'right';
+    verticalPosition?: 'top' | 'bottom';
+    showCloseButton?: boolean;
+}
+
+declare class SnackbarService {
+    private snackBar;
+    constructor(snackBar: MatSnackBar);
+    show(config: SnackbarConfig): void;
+    success(message: string, duration?: number): void;
+    error(message: string, duration?: number): void;
+    warning(message: string, duration?: number): void;
+    info(message: string, duration?: number): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SnackbarService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<SnackbarService>;
+}
+
 declare class ConfiguratorConfigPanelComponent implements OnChanges {
     private cdr;
-    constructor(cdr: ChangeDetectorRef);
+    private snackbarService;
+    constructor(cdr: ChangeDetectorRef, snackbarService: SnackbarService);
     selectedField: FieldConfig | null;
     selectedFieldInfo: ConfiguratorFieldInfo | null;
     builderFieldType: string | null;
     fieldTypeSchemaMap: Record<string, FormSchema>;
     configChange: EventEmitter<Record<string, unknown>>;
     typeChange: EventEmitter<string>;
+    /**
+     * When false, all `optionConfig.*` fields (apiUrl, dataPath, labelPath, etc.)
+     * are hidden from the config panel. Business users don't need to configure
+     * option URLs — these are pre-filled by the developer in the master JSON.
+     */
+    showOptionConfig: boolean;
     /** Exposed to the template for the native type-switcher select */
     readonly switchableFieldTypes: {
         label: string;
@@ -905,10 +982,21 @@ declare class ConfiguratorConfigPanelComponent implements OnChanges {
      * guarantee a completely fresh SmartForm instance is mounted.
      */
     private _buildConfigFormForType;
+    /**
+     * Deep-clones the schema and removes any field whose `name` matches developer-only fields.
+     * This prevents end users from modifying system-level configurations like:
+     * - optionConfig.* (API URLs, data paths, etc.)
+     * - payloadPath (payload mapping)
+     * - className (CSS styling)
+     * - name (system identifier)
+     *
+     * Also removes entire sections that become empty after filtering.
+     */
+    private _filterSchemaForOptionConfig;
     private _extractInitialValuesFromField;
     private _buildPatchFromFormData;
     static ɵfac: i0.ɵɵFactoryDeclaration<ConfiguratorConfigPanelComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ConfiguratorConfigPanelComponent, "lib-configurator-config-panel", never, { "selectedField": { "alias": "selectedField"; "required": false; }; "selectedFieldInfo": { "alias": "selectedFieldInfo"; "required": false; }; "builderFieldType": { "alias": "builderFieldType"; "required": false; }; "fieldTypeSchemaMap": { "alias": "fieldTypeSchemaMap"; "required": false; }; }, { "configChange": "configChange"; "typeChange": "typeChange"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ConfiguratorConfigPanelComponent, "lib-configurator-config-panel", never, { "selectedField": { "alias": "selectedField"; "required": false; }; "selectedFieldInfo": { "alias": "selectedFieldInfo"; "required": false; }; "builderFieldType": { "alias": "builderFieldType"; "required": false; }; "fieldTypeSchemaMap": { "alias": "fieldTypeSchemaMap"; "required": false; }; "showOptionConfig": { "alias": "showOptionConfig"; "required": false; }; }, { "configChange": "configChange"; "typeChange": "typeChange"; }, never, never, false, never>;
 }
 
 declare class SmartFormController {
@@ -956,28 +1044,6 @@ declare class ExpressionService {
     static ɵprov: i0.ɵɵInjectableDeclaration<ExpressionService>;
 }
 
-type SnackbarVariant = 'success' | 'error' | 'warning' | 'info';
-interface SnackbarConfig {
-    message: string;
-    variant?: SnackbarVariant;
-    duration?: number;
-    horizontalPosition?: 'start' | 'center' | 'end' | 'left' | 'right';
-    verticalPosition?: 'top' | 'bottom';
-    showCloseButton?: boolean;
-}
-
-declare class SnackbarService {
-    private snackBar;
-    constructor(snackBar: MatSnackBar);
-    show(config: SnackbarConfig): void;
-    success(message: string, duration?: number): void;
-    error(message: string, duration?: number): void;
-    warning(message: string, duration?: number): void;
-    info(message: string, duration?: number): void;
-    static ɵfac: i0.ɵɵFactoryDeclaration<SnackbarService, never>;
-    static ɵprov: i0.ɵɵInjectableDeclaration<SnackbarService>;
-}
-
 declare class SmartFormComponent implements OnInit, OnChanges, OnDestroy {
     private fb;
     controller: SmartFormController;
@@ -998,6 +1064,8 @@ declare class SmartFormComponent implements OnInit, OnChanges, OnDestroy {
      */
     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;
     }>;
@@ -1078,7 +1146,7 @@ declare class SmartFormComponent implements OnInit, OnChanges, OnDestroy {
     private getButtonByActionKind;
     private navigateTo;
     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; }; }, { "submit": "submit"; "draftSave": "draftSave"; "actionClick": "actionClick"; "valueChange": "valueChange"; "fileAdded": "fileAdded"; "fileUploadFinished": "fileUploadFinished"; "fileRemoved": "fileRemoved"; }, never, never, false, 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"; }, never, never, false, never>;
 }
 
 declare class FormSectionComponent implements OnInit, OnDestroy {

package/package.json

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