commons-shared-web-ui 0.0.40 → 0.0.42

package/index.d.ts

@@ -89,6 +89,12 @@ interface FormLabels {
     previousLabel?: string;
     addLabel?: string;
     removeLabel?: string;
+    /** File upload error messages. Supports placeholders: {fileName}, {maxSizeMB}, {maxFiles} */
+    fileTypeError?: string;
+    fileSizeError?: string;
+    maxFilesError?: string;
+    fileUploadFailed?: string;
+    fileDeleteFailed?: string;
 }
 interface SubmitConfig {
     apiUrl: string;
@@ -310,6 +316,10 @@ interface DateConfig {
     allowFuture?: boolean;
     minDate?: string;
     maxDate?: string;
+    /** When true, the text input is readonly (picker-only, no keyboard entry). */
+    inputReadonly?: boolean;
+    /** Name of a sibling field whose value is used as the dynamic minimum date. */
+    minDateField?: string;
 }
 interface OptionConfig$1 {
     optionClass?: string;
@@ -887,6 +897,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 +919,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 +1043,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 +1095,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 +1234,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 +1302,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>;
 }
@@ -1388,6 +1428,7 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     value: any;
     isVisible: boolean;
     showPassword: boolean;
+    dynamicMinDate: string | null;
     isMultiDropdownOpen: boolean;
     isDragOver: boolean;
     fileUploadError: string;
@@ -1430,6 +1471,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 +1490,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 +1500,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. */
@@ -1504,6 +1554,7 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
      */
     setupMatchValidation(): void;
     setupVisibility(): void;
+    setupMinDateField(): void;
     setupGeneratedField(): void;
     evaluateFormula(context: {
         [key: string]: any;
@@ -1517,6 +1568,7 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     /** Builds HttpHeaders using the token stored in the SmartFormController (sourced from configJSON)
      *  merged with any custom headers declared in optionConfig.headers.
      */
+    private _fileLabel;
     private getHeaders;
     updateValue(newValue: any): void;
     onCheckboxListChange(code: string, checked: boolean): void;
@@ -1941,9 +1993,11 @@ interface DropdownConfig {
 }
 
 declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChanges {
+    private el;
     config?: DropdownConfig;
     labels?: DropdownLabels;
     options: DropdownOption[];
+    selectedValue?: any;
     placeholder: string;
     label: string;
     multiple: boolean;
@@ -1976,13 +2030,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();
@@ -2022,7 +2083,7 @@ declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChang
         [key: string]: string | undefined;
     };
     static ɵfac: i0.ɵɵFactoryDeclaration<DropdownComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "lib-dropdown", never, { "config": { "alias": "config"; "required": false; }; "labels": { "alias": "labels"; "required": false; }; "options": { "alias": "options"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "label": { "alias": "label"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "required": { "alias": "required"; "required": false; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "width": { "alias": "width"; "required": false; }; "height": { "alias": "height"; "required": false; }; "borderRadius": { "alias": "borderRadius"; "required": false; }; "fontSize": { "alias": "fontSize"; "required": false; }; "gap": { "alias": "gap"; "required": false; }; "fontFamily": { "alias": "fontFamily"; "required": false; }; "labelColor": { "alias": "labelColor"; "required": false; }; "labelFontSize": { "alias": "labelFontSize"; "required": false; }; "labelFontWeight": { "alias": "labelFontWeight"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "borderColor": { "alias": "borderColor"; "required": false; }; "borderWidth": { "alias": "borderWidth"; "required": false; }; "padding": { "alias": "padding"; "required": false; }; "fontWeight": { "alias": "fontWeight"; "required": false; }; "color": { "alias": "color"; "required": false; }; "placeholderColor": { "alias": "placeholderColor"; "required": false; }; "focusBorderColor": { "alias": "focusBorderColor"; "required": false; }; "errorColor": { "alias": "errorColor"; "required": false; }; "disabledBackgroundColor": { "alias": "disabledBackgroundColor"; "required": false; }; "disabledColor": { "alias": "disabledColor"; "required": false; }; "boxShadow": { "alias": "boxShadow"; "required": false; }; }, { "selectionChange": "selectionChange"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "lib-dropdown", never, { "config": { "alias": "config"; "required": false; }; "labels": { "alias": "labels"; "required": false; }; "options": { "alias": "options"; "required": false; }; "selectedValue": { "alias": "selectedValue"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "label": { "alias": "label"; "required": false; }; "multiple": { "alias": "multiple"; "required": false; }; "searchable": { "alias": "searchable"; "required": false; }; "clearable": { "alias": "clearable"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "required": { "alias": "required"; "required": false; }; "errorMessage": { "alias": "errorMessage"; "required": false; }; "width": { "alias": "width"; "required": false; }; "height": { "alias": "height"; "required": false; }; "borderRadius": { "alias": "borderRadius"; "required": false; }; "fontSize": { "alias": "fontSize"; "required": false; }; "gap": { "alias": "gap"; "required": false; }; "fontFamily": { "alias": "fontFamily"; "required": false; }; "labelColor": { "alias": "labelColor"; "required": false; }; "labelFontSize": { "alias": "labelFontSize"; "required": false; }; "labelFontWeight": { "alias": "labelFontWeight"; "required": false; }; "backgroundColor": { "alias": "backgroundColor"; "required": false; }; "borderColor": { "alias": "borderColor"; "required": false; }; "borderWidth": { "alias": "borderWidth"; "required": false; }; "padding": { "alias": "padding"; "required": false; }; "fontWeight": { "alias": "fontWeight"; "required": false; }; "color": { "alias": "color"; "required": false; }; "placeholderColor": { "alias": "placeholderColor"; "required": false; }; "focusBorderColor": { "alias": "focusBorderColor"; "required": false; }; "errorColor": { "alias": "errorColor"; "required": false; }; "disabledBackgroundColor": { "alias": "disabledBackgroundColor"; "required": false; }; "disabledColor": { "alias": "disabledColor"; "required": false; }; "boxShadow": { "alias": "boxShadow"; "required": false; }; }, { "selectionChange": "selectionChange"; }, never, never, false, never>;
 }
 
 interface CheckboxOption {
@@ -3210,6 +3271,7 @@ interface TableColumn {
     headerClass?: string;
     sticky?: boolean;
     labelPath?: string;
+    emptyValue?: string;
     dateFormat?: string;
     clickAction?: 'route' | 'callback';
     clickRoute?: string;
@@ -3326,6 +3388,9 @@ interface TableConfig {
     token?: string;
     tokenHeader?: string;
     editingRowClass?: string;
+    /** Fallback text for any cell whose value is null, undefined, or empty string.
+     *  Overridden per-column via TableColumn.emptyValue. Library default: '-' */
+    emptyValue?: string;
 }
 interface SearchConfig {
     enabled: boolean;
@@ -3918,6 +3983,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 +4053,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.42",
   "peerDependencies": {
     "@angular/animations": "20.3.15",
     "@angular/cdk": "20.2.14",