commons-shared-web-ui 0.0.40 → 0.0.41

package/index.d.ts

@@ -887,6 +887,12 @@ declare class FieldConfiguratorComponent implements OnChanges {
      * Defaults to true (show everything).
      */
     showOptionConfig: boolean;
+    /**
+     * Field names that must always remain enabled and cannot be toggled off.
+     * When a locked field is selected, the IS ENABLED / READ ONLY / DISABLED
+     * controls are hidden so the user cannot accidentally disable the field.
+     */
+    lockedFieldNames: string[];
     readonly store: FieldConfiguratorService;
     private readonly cdr;
     private readonly schemaMapOverride;
@@ -903,7 +909,7 @@ 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; }; "showOptionConfig": { "alias": "showOptionConfig"; "required": false; }; }, { "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; }; "lockedFieldNames": { "alias": "lockedFieldNames"; "required": false; }; }, { "schemaChange": "schemaChange"; }, never, never, false, never>;
 }
 
 declare class GroupNodeComponent {
@@ -1027,6 +1033,12 @@ declare class ConfiguratorConfigPanelComponent implements OnChanges {
      * option URLs — these are pre-filled by the developer in the master JSON.
      */
     showOptionConfig: boolean;
+    /**
+     * Field names that are mandatory and cannot be disabled.
+     * When the currently selected field is in this list, IS ENABLED / READ ONLY /
+     * DISABLED controls are hidden from the Field State step.
+     */
+    lockedFieldNames: string[];
     /** Exposed to the template for the native type-switcher select */
     readonly switchableFieldTypes: {
         label: string;
@@ -1073,10 +1085,15 @@ declare class ConfiguratorConfigPanelComponent implements OnChanges {
      * Also removes entire sections that become empty after filtering.
      */
     private _filterSchemaForOptionConfig;
+    /**
+     * Remove IS ENABLED, READ ONLY, and DISABLED controls from the config schema
+     * when the selected field is a mandatory/locked field.
+     */
+    private _filterSchemaForLockedField;
     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; }; "showOptionConfig": { "alias": "showOptionConfig"; "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; }; "lockedFieldNames": { "alias": "lockedFieldNames"; "required": false; }; }, { "configChange": "configChange"; "typeChange": "typeChange"; }, never, never, false, never>;
 }
 
 declare class SmartFormController {
@@ -1207,7 +1224,10 @@ declare class SmartFormComponent implements OnInit, OnChanges, OnDestroy {
     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;
@@ -1272,6 +1292,16 @@ declare class SmartFormComponent implements OnInit, OnChanges, OnDestroy {
     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"; "stepChange": "stepChange"; }, never, never, false, never>;
 }
@@ -1430,6 +1460,12 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
         label: string;
         code: any;
     }[];
+    /**
+     * Component-local option list for DROPDOWN/RADIO/CHECKBOX/CHIP fields.
+     * Using a local copy prevents shared-config mutation when the same field config
+     * object is reused across multiple allowMulti repeater instances.
+     */
+    localOptionList: any[];
     /** Cache of the latest dependency parameters for server-side autocomplete filtering */
     private _latestDependencyValues;
     /** For GROUP fields with allowMulti = true */
@@ -1443,6 +1479,8 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
      * cached values from bleeding into new instances.
      *
      * Enhanced with isEditing and isSaved flags for the 'multiSave' card UI.
+     * Each instance gets its own rowController so cascading dropdowns work
+     * independently within each repeater row.
      */
     instanceList: {
         id: number;
@@ -1451,6 +1489,7 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
         isEditing?: boolean;
         isSaved?: boolean;
         isExpanded?: boolean;
+        rowController: SmartFormController;
     }[];
     private _nextInstanceId;
     /** Tracks open accordion panels for standard (non-multiSave) GROUP repeaters. */
@@ -1941,6 +1980,7 @@ interface DropdownConfig {
 }
 
 declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChanges {
+    private el;
     config?: DropdownConfig;
     labels?: DropdownLabels;
     options: DropdownOption[];
@@ -1976,13 +2016,20 @@ declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChang
     selectionChange: EventEmitter<any>;
     viewport?: CdkVirtualScrollViewport;
     searchInput?: ElementRef;
+    triggerEl?: ElementRef;
     filteredOptions: DropdownOption[];
     searchTerm: string;
     value: any;
     isOpen: boolean;
     focusedIndex: number;
+    menuPosition: {
+        top: number;
+        left: number;
+        width: number;
+    };
     onChange: (value: any) => void;
     onTouched: () => void;
+    constructor(el: ElementRef);
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
     private get validOptions();
@@ -3918,6 +3965,28 @@ declare const DEFAULT_SIDE_NAV_TOOLTIP_POSITION = "right";
 
 declare function appendBaseUrlRecursively(obj: any, baseURL: string): void;
 
+interface HierarchyCfg {
+    templateApiUrl: string;
+    templateListPath: string | null;
+    templateSelect: 'default' | 'first' | 'byCode';
+    templateSelectField: string;
+    templateSelectCode?: string;
+    rootCodePath: string;
+    templateCodePath: string;
+    hierarchyListPath: string;
+    parentField: string;
+    childField: string;
+    dataApiUrl: string;
+    dataPath: string;
+    labelPath: string;
+    valuePath: string;
+    colSpan: number;
+    payloadPrefix: string;
+    dependencyParam: string;
+    nodes: Record<string, any>;
+    branchSubType: string;
+}
+
 declare class ValidationUtils {
     static email(): ValidatorFn;
     static phone(): ValidatorFn;
@@ -3966,4 +4035,4 @@ declare class SnackbarModule {
 }
 
 export { AlertComponent, AlertModule, ButtonComponent, ButtonDropdownComponent, ButtonDropdownModule, ButtonModule, CheckboxComponent, ConfigurableFormComponent, configurableForm_examples_d as ConfigurableFormExamples, ConfigurableFormModule, ConfirmationModalComponent, ConfirmationModalModule, DEFAULT_ITEMS_PER_PAGE, DEFAULT_PAGE_SIZE_OPTIONS, DEFAULT_SIDE_NAV_TOOLTIP_POSITION, DatepickerComponent, DropdownComponent, ExpressionService, FieldConfiguratorComponent, FieldSelectionComponent, FilterComponent, FilterModule, FilterSidebarComponent, FilterSidebarModule, FilterTableSelectorComponent, FilterTableSelectorModule, FormBuilderModule, FormComponentsModule, InputComponent, MaterialModule, NAV_ORIENTATION_DEFAULT, NAV_VARIANT_DEFAULT, NavComponent, NavModule, PAGINATION_THEME_DARK, PAGINATION_THEME_DEFAULT, PaginationComponent, PaginationModule, RadioComponent, SearchComponent, SharedUiModule, SideNavComponent, SideNavModule, SmartFormComponent, SmartFormController, smartForm_examples_d as SmartFormExamples, SmartFormModule, SmartTableComponent, SmartTableModule, SnackbarComponent, SnackbarModule, SnackbarService, StringUtils, SummaryCardComponent, SummaryCardModule, ToggleComponent, ValidationUtils, appendBaseUrlRecursively, clearLocalStorage, clearSessionStorage, getLocalStorageItem, getSessionStorageItem, removeLocalStorageItem, removeSessionStorageItem, setLocalStorageItem, setSessionStorageItem, translateConfig };
-export type { AlertLabels, AlertVariant, AttachmentConfig, ButtonLabels, ButtonVariant, CheckboxConfig, CheckboxLabels, CheckboxOption, ConfirmationModalConfig, DateConfig, DatePickerConfig, DatepickerLabels, DropdownAction, DropdownConfig, DropdownLabels, DropdownOption, EmailConfig, FieldConfig, FieldType, FilterChangeEvent, FilterConfig, FilterItem, FilterItemType, FilterOutput, FilterPanelConfig, FilterParamMap, FilterSearchConfig, FilterSidebarChangeEvent, FilterSidebarConfig, FilterSidebarOutput, FilterTableConfig, FilterTableSelectorConfig, FormConfig, FormField, FormOption, FormSchema, FormSection, GeneratedConfig, IconInput, InputConfig, InputLabels, InputType, JsonFieldConfig, JsonFormConfig, KeyType, LengthConstraint, LocationConfig, NavItem, NavStyleConfig, NestedStringConfig, NumberConfig, OptionConfig, OptionDTO, OptionItem, PaginationConfig, PaginationLabels, PhoneConfig, QueryParamsConfig, RadioConfig, RadioLabels, RadioOption, RangeConfig, RatingConfig, SearchConfig, SearchLabels, SectionConfig, SelectionConfig, SideNavItem, SideNavSection, SideNavStyleConfig, SnackbarConfig, SnackbarVariant, StepperConfig, SubmitConfig, SummaryCardConfig, SummaryCardLabels, SummaryCardMeta, TableAction, TableActionItem, TableColumn, TableColumnSubField, TableConfig, TableDataChangeEvent, TableFilter, TableFilterChangeEvent, TableFilterColumn, TableFilterConfig, TableFilterItem, TableFilterLabels, TableFilterOutput, TableLabels, TableOption, TableRowSaveEvent, TableTheme, TextConfig, ToggleConfig, ToggleLabels, UIConfig, UISubType, UIType, UploadedFile, ValidationResult, ValidationRules };
+export type { AlertLabels, AlertVariant, AttachmentConfig, ButtonLabels, ButtonVariant, CheckboxConfig, CheckboxLabels, CheckboxOption, ConfirmationModalConfig, DateConfig, DatePickerConfig, DatepickerLabels, DropdownAction, DropdownConfig, DropdownLabels, DropdownOption, EmailConfig, FieldConfig, FieldType, FilterChangeEvent, FilterConfig, FilterItem, FilterItemType, FilterOutput, FilterPanelConfig, FilterParamMap, FilterSearchConfig, FilterSidebarChangeEvent, FilterSidebarConfig, FilterSidebarOutput, FilterTableConfig, FilterTableSelectorConfig, FormConfig, FormField, FormOption, FormSchema, FormSection, GeneratedConfig, HierarchyCfg, IconInput, InputConfig, InputLabels, InputType, JsonFieldConfig, JsonFormConfig, KeyType, LengthConstraint, LocationConfig, NavItem, NavStyleConfig, NestedStringConfig, NumberConfig, OptionConfig, OptionDTO, OptionItem, PaginationConfig, PaginationLabels, PhoneConfig, QueryParamsConfig, RadioConfig, RadioLabels, RadioOption, RangeConfig, RatingConfig, SearchConfig, SearchLabels, SectionConfig, SelectionConfig, SideNavItem, SideNavSection, SideNavStyleConfig, SnackbarConfig, SnackbarVariant, StepperConfig, SubmitConfig, SummaryCardConfig, SummaryCardLabels, SummaryCardMeta, TableAction, TableActionItem, TableColumn, TableColumnSubField, TableConfig, TableDataChangeEvent, TableFilter, TableFilterChangeEvent, TableFilterColumn, TableFilterConfig, TableFilterItem, TableFilterLabels, TableFilterOutput, TableLabels, TableOption, TableRowSaveEvent, TableTheme, TextConfig, ToggleConfig, ToggleLabels, UIConfig, UISubType, UIType, UploadedFile, ValidationResult, ValidationRules };

package/package.json

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