commons-shared-web-ui 0.0.42 → 0.0.44

package/index.d.ts

@@ -233,6 +233,22 @@ interface StepperConfig {
     showStep?: boolean;
     isHorizontal?: boolean;
 }
+/**
+ * Describes a clickable action icon rendered as a suffix inside a TEXT_INPUT
+ * or NUMBER_INPUT field. Multiple icons can be shown side-by-side.
+ * When clicked, the field name and actionId are emitted via the
+ * SmartFormComponent's `suffixActionClick` output.
+ */
+interface SuffixActionIcon {
+    /** Material icon name (e.g. 'edit', 'refresh', 'check', 'lock') */
+    icon: string;
+    /** Unique action identifier emitted on click (e.g. 'enable_edit', 'reset_code') */
+    actionId: string;
+    /** Optional tooltip shown on hover */
+    tooltip?: string;
+    /** Optional custom color override (e.g. '#16A34A' for a green check icon) */
+    color?: string;
+}
 interface FieldConfig {
     name?: string;
     label?: string;
@@ -265,6 +281,12 @@ interface FieldConfig {
     suffix?: string;
     /** Whether the field is read-only (shows lock icon) */
     readonly?: boolean;
+    /**
+     * Clickable action icons rendered as suffixes inside the input.
+     * Ignored when `readonly` is true (the built-in lock icon takes precedence).
+     * Each icon emits a `suffixActionClick` event with `{ fieldName, actionId }`.
+     */
+    suffixActionIcons?: SuffixActionIcon[];
     sectionConfig?: SectionConfig;
     /**
      * Cross-field validation config for SUBFIELDS groups.
@@ -278,6 +300,7 @@ interface FieldConfig {
     phoneConfig?: PhoneConfig;
     numberConfig?: NumberConfig;
     dateConfig?: DateConfig;
+    timeConfig?: TimeConfig;
     optionConfig?: OptionConfig$1;
     autocompleteConfig?: AutocompleteConfig;
     generatedConfig?: GeneratedConfig;
@@ -314,6 +337,8 @@ interface NumberConfig {
 }
 interface DateConfig {
     allowFuture?: boolean;
+    /** When false, dates before today are disabled (today is the minimum). When true (default), all past dates are allowed. */
+    allowPast?: boolean;
     minDate?: string;
     maxDate?: string;
     /** When true, the text input is readonly (picker-only, no keyboard entry). */
@@ -321,6 +346,20 @@ interface DateConfig {
     /** Name of a sibling field whose value is used as the dynamic minimum date. */
     minDateField?: string;
 }
+interface TimeConfig {
+    /** Explicit minimum time in "HH:mm" 24-hour format (e.g. "09:00"). */
+    minTime?: string;
+    /** Explicit maximum time in "HH:mm" 24-hour format (e.g. "18:00"). */
+    maxTime?: string;
+    /** When true, the input is readonly. */
+    inputReadonly?: boolean;
+    /**
+     * Name of a sibling TIME field whose value is used as the dynamic minimum time.
+     * When the sibling changes, this field's minimum updates and any now-invalid
+     * value (earlier than the new minimum) is cleared. Mirrors DateConfig.minDateField.
+     */
+    minTimeField?: string;
+}
 interface OptionConfig$1 {
     optionClass?: string;
     optionUrl?: string;
@@ -1120,6 +1159,11 @@ declare class SmartFormController {
     fileAdded$: Subject<any>;
     fileUploadFinished$: Subject<any>;
     fileRemoved$: Subject<any>;
+    /** Emitted when a suffixActionIcon is clicked inside a form field */
+    suffixActionClick$: Subject<{
+        fieldName: string;
+        actionId: string;
+    }>;
     initialize(initialData: {
         [key: string]: any;
     }): void;
@@ -1195,6 +1239,11 @@ declare class SmartFormComponent implements OnInit, OnChanges, OnDestroy {
     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<{
@@ -1313,7 +1362,7 @@ declare class SmartFormComponent implements OnInit, OnChanges, OnDestroy {
     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>;
+    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 {
@@ -1429,6 +1478,21 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     isVisible: boolean;
     showPassword: boolean;
     dynamicMinDate: string | null;
+    dynamicMinTime: string | null;
+    /**
+     * Effective minimum date for the datepicker.
+     * Priority: dynamic (sibling field) → explicit minDate → today (when allowPast is false).
+     * When allowPast is not false, past dates stay allowed unless an explicit min is set.
+     */
+    get effectiveMinDate(): string | null;
+    /**
+     * Effective minimum time for the time input.
+     * Priority: dynamic (sibling field) → explicit minTime.
+     * Mirrors {@link effectiveMinDate} for TIME fields.
+     */
+    get effectiveMinTime(): string | null;
+    /** Effective maximum time for the time input (explicit maxTime only). */
+    get effectiveMaxTime(): string | null;
     isMultiDropdownOpen: boolean;
     isDragOver: boolean;
     fileUploadError: string;
@@ -1541,6 +1605,8 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
         fg: FormGroup;
     }): number;
     ngAfterViewInit(): void;
+    /** Handles click on a suffix action icon and emits via the controller */
+    onSuffixActionClick(actionId: string): void;
     ngOnDestroy(): void;
     registerControl(): void;
     getValidators(): ValidatorFn[];
@@ -1555,6 +1621,13 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
     setupMatchValidation(): void;
     setupVisibility(): void;
     setupMinDateField(): void;
+    /**
+     * Wires up a dynamic minimum for a TIME field from a sibling TIME field
+     * (config.timeConfig.minTimeField). When the source changes, this field's
+     * minimum updates and any now-invalid value (earlier than the new minimum)
+     * is cleared. Mirrors {@link setupMinDateField} for TIME fields.
+     */
+    setupMinTimeField(): void;
     setupGeneratedField(): void;
     evaluateFormula(context: {
         [key: string]: any;
@@ -1565,6 +1638,16 @@ declare class FormFieldComponent implements OnInit, OnDestroy {
         [key: string]: any;
     }): void;
     private getValueByPath;
+    /**
+     * Replaces `{placeholder}` tokens in a URL with values resolved from the
+     * current form data (supports dot / array-index paths via getValueByPath).
+     * Returns the interpolated URL plus whether EVERY token was resolved.
+     *
+     * Used by the delete flows: when a required id (e.g. `{entityId}`) is missing
+     * — as in CREATE mode before the entity exists — `resolved` is false and the
+     * caller skips the server delete and just removes the item from the form.
+     */
+    private resolveUrlPlaceholders;
     /** Builds HttpHeaders using the token stored in the SmartFormController (sourced from configJSON)
      *  merged with any custom headers declared in optionConfig.headers.
      */
@@ -4053,4 +4136,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, 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 };
+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, SuffixActionIcon, 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.42",
+  "version": "0.0.44",
   "peerDependencies": {
     "@angular/animations": "20.3.15",
     "@angular/cdk": "20.2.14",