commons-shared-web-ui 0.0.83 → 0.0.85

package/index.d.ts

@@ -232,6 +232,16 @@ interface MultiSaveConfig {
      * '+ Add a [label]'.
      */
     addLabel?: string;
+    /**
+     * How many saved entries the section must hold before the form can be submitted.
+     * Defaults to 0 — the section is optional, and the blank editor it always renders
+     * is ignored so it can't make the whole form unsubmittable.
+     *
+     * Set to 1 (or more) for a section that genuinely requires entries: the blank editor
+     * then counts as the missing entry, and submitting with it empty fails validation and
+     * highlights its required fields.
+     */
+    minEntries?: number;
 }
 interface StepperConfig {
     children: FieldConfig[];
@@ -1381,6 +1391,17 @@ declare class ConfiguratorConfigPanelComponent implements OnChanges {
     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>;
 }
 
+/**
+ * Implemented by any field that hosts a repeatable (allowMulti) group.
+ * Declared here — rather than importing FormFieldComponent — so the controller
+ * stays free of a circular dependency on the component that injects it.
+ */
+interface RepeaterHost {
+    /** Saves entries the user filled in but never pressed Save on. True = one is incomplete. */
+    commitPendingInstances(): boolean;
+    /** Re-opens collapsed entries whose fields are invalid. True = at least one was revealed. */
+    revealInvalidInstances(): boolean;
+}
 declare class SmartFormController {
     private formData;
     /** Auth token sourced from the FormSchema configJSON (e.g. "Bearer eyJ…") */
@@ -1404,6 +1425,25 @@ declare class SmartFormController {
     selectedOptionsData: {
         [fieldName: string]: any;
     };
+    /**
+     * Repeater sections register themselves here so SmartFormComponent can reach them
+     * at submit time. A @ViewChildren query can't: the fields are rendered inside
+     * FormSectionComponent's template, which is a separate view, so the query never
+     * matches them.
+     */
+    private repeaters;
+    /**
+     * Set on the per-row controllers a repeater creates for its instances. Registrations
+     * walk up this chain so a repeater nested inside another repeater's row is still
+     * visible to the root form.
+     */
+    parent?: SmartFormController;
+    /** The controller the root SmartFormComponent owns — this one unless it is a row controller. */
+    private get rootController();
+    registerRepeater(host: RepeaterHost): void;
+    unregisterRepeater(host: RepeaterHost): void;
+    /** Every repeater currently rendered under the root form. */
+    get repeaterHosts(): RepeaterHost[];
     initialize(initialData: {
         [key: string]: any;
     }): void;
@@ -1537,7 +1577,7 @@ interface TimePickerConfig {
     disabledColor?: string;
 }
 
-declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
+declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy, RepeaterHost {
     private fb;
     private expressionService;
     private http;
@@ -1791,6 +1831,34 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     private setupFormulaValidation;
     addGroupInstance(initialData?: any): void;
     saveGroupInstance(index: number): void;
+    /**
+     * Saves any multi-save entry the user filled in but never pressed Save on.
+     *
+     * The card UI only pushes an entry into `groupFormArray` once Save is clicked, so an
+     * entry left open in the editor is invisible to the root form: its values never reach
+     * the payload and its required fields can't block the submit. SmartForm calls this
+     * before validating, which makes an open entry behave exactly as if Save had been
+     * pressed — complete entries are committed, incomplete ones stop the submit.
+     *
+     * Entries the user never touched are skipped: every multi-save section renders one
+     * blank editor by default, and that blank must not make the whole form unsubmittable.
+     *
+     * @returns true when an entry has content but is still invalid — it stays open with
+     *          its field errors and the section-level message on screen.
+     */
+    commitPendingInstances(): boolean;
+    /** Saved entries this section must hold before the form can be submitted (0 = optional). */
+    private get minEntries();
+    /**
+     * True when a blank editor can be passed over at submit time.
+     *
+     * Every multi-save section renders one blank editor, so an optional section (the
+     * default) must ignore it — otherwise its required fields would make the whole form
+     * permanently unsubmittable. A section with `minEntries` set that hasn't reached its
+     * quota is the opposite case: the blank editor IS the entry the user still owes, so
+     * it gets validated and lights up like any other incomplete entry.
+     */
+    private isIgnorableBlank;
     /**
      * Re-opens any repeater instance (multiSave card or standard accordion panel)
      * whose nested FormGroup is invalid, so errors hidden by a collapsed card/panel
@@ -1798,6 +1866,18 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
      * Returns true if at least one invalid instance was revealed.
      */
     revealInvalidInstances(): boolean;
+    /**
+     * True when the user has put nothing into this repeater entry.
+     *
+     * Value-based rather than `fg.pristine`, because several fields here (date picker,
+     * rich text, the custom dropdown overlays) write through `setValue`, which never
+     * marks the control dirty. `dirty` is still honoured as a second signal so a field
+     * whose value round-trips back to blank still counts as touched.
+     */
+    private isInstanceBlank;
+    /** Blank = nothing a user could have entered. `false` counts as blank so an unchecked
+     *  CHECKBOX (or one defaulted to false) doesn't make an otherwise empty entry look filled. */
+    private static isBlankValue;
     cancelGroupInstance(index: number): void;
     editGroupInstance(index: number): void;
     toggleExpandGroupInstance(index: number): void;
@@ -2218,6 +2298,18 @@ declare class SmartFormComponent implements OnInit, OnChanges, OnDestroy {
     private buildNestedPayload;
     private setNestedValue;
     private extractGroupValue;
+    /**
+     * Saves every multi-save repeater entry (Event Agenda, FAQs, …) that the user filled in
+     * but left open in its editor, so those values are part of `collectFormData()` even
+     * though the entry's own Save button was never clicked. An entry still missing a
+     * required field is left open with its errors showing rather than committed half-done.
+     *
+     * `validate()` calls this already. Hosts that collect form data on their own — a
+     * "Save as draft" button in an external footer, say — should call it first.
+     *
+     * @returns true when an open entry is incomplete.
+     */
+    commitOpenEntries(): boolean;
     validate(): boolean;
     scrollToFirstInvalidControl(): void;
     submitToApi(formData: any, actionType?: 'submit' | 'draft', btn?: ActionButtonConfig): void;
@@ -4292,6 +4384,18 @@ interface FilterSidebarConfig {
         icon?: string;
         visible?: boolean;
         showClose?: boolean;
+        /**
+         * Header bar look, mirroring cc-confirmation-modal. Defaults to 'light' —
+         * a full-width white bar with black title and a bottom divider across the
+         * top of the panel. 'dark' inverts it (black bar, white title, no divider).
+         */
+        theme?: 'light' | 'dark';
+        /** Overrides the theme's bar colour. */
+        backgroundColor?: string;
+        /** Overrides the theme's title colour. */
+        textColor?: string;
+        /** e.g. '1px solid #E0E0E0' or 'none' — overrides the theme's divider. */
+        borderBottom?: string;
     };
     footer?: {
         visible?: boolean;
@@ -4359,6 +4463,8 @@ declare class FilterSidebarComponent implements OnInit, ControlValueAccessor {
     get sidebarStyles(): {
         [key: string]: string;
     };
+    /** `cc-filter-header cc-filter-header--light|--dark` — light (white bar, black title) is the default. */
+    get headerClass(): string;
     trackByFn(index: number, item: FilterItem): any;
     static ɵfac: i0.ɵɵFactoryDeclaration<FilterSidebarComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<FilterSidebarComponent, "lib-filter-sidebar", never, { "config": { "alias": "config"; "required": false; }; "initialFilters": { "alias": "initialFilters"; "required": false; }; }, { "filterChange": "filterChange"; "filterApply": "filterApply"; "filterClear": "filterClear"; "showCodeSnippet": "showCodeSnippet"; "close": "close"; }, never, ["[header-actions]"], false, never>;
@@ -5034,6 +5140,12 @@ declare class SmartTableComponent implements OnInit, OnChanges, AfterViewInit, O
      * external-data mode. Must be kept in sync by the parent.
      */
     totalItemsCount?: number;
+    /**
+     * External loading state: when the table operates in external-data mode
+     * (i.e. [tableData] is provided), the parent controls the loading spinner
+     * via this input. Ignored in internal-data mode where loading is self-managed.
+     */
+    externalLoading: boolean;
     action: EventEmitter<{
         action: TableAction;
         row: any;
@@ -5066,6 +5178,12 @@ declare class SmartTableComponent implements OnInit, OnChanges, AfterViewInit, O
     currentPage: number;
     loading: boolean;
     originalRowsCache: Map<any, any>;
+    /**
+     * Unified loading state used by the template. In external-data mode,
+     * defers to `externalLoading` (parent-driven). In internal-data mode,
+     * uses the internally managed `loading` flag.
+     */
+    get isTableLoading(): boolean;
     activeSort: {
         key: string;
         direction: 'ASC' | 'DESC';
@@ -5251,7 +5369,7 @@ declare class SmartTableComponent implements OnInit, OnChanges, AfterViewInit, O
     /** Normalize Date objects back to ISO strings before sending payloads. */
     private normalizeDateFieldsForSave;
     static ɵfac: i0.ɵɵFactoryDeclaration<SmartTableComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<SmartTableComponent, "lib-smart-table", never, { "config": { "alias": "config"; "required": false; }; "tableData": { "alias": "tableData"; "required": false; }; "totalItemsCount": { "alias": "totalItemsCount"; "required": false; }; "selectedRows": { "alias": "selectedRows"; "required": false; }; }, { "action": "action"; "topAction": "topAction"; "filterChange": "filterChange"; "rowSelect": "rowSelect"; "columnClick": "columnClick"; "sortChange": "sortChange"; "pageChange": "pageChange"; "searchChange": "searchChange"; "rowSave": "rowSave"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SmartTableComponent, "lib-smart-table", never, { "config": { "alias": "config"; "required": false; }; "tableData": { "alias": "tableData"; "required": false; }; "totalItemsCount": { "alias": "totalItemsCount"; "required": false; }; "externalLoading": { "alias": "externalLoading"; "required": false; }; "selectedRows": { "alias": "selectedRows"; "required": false; }; }, { "action": "action"; "topAction": "topAction"; "filterChange": "filterChange"; "rowSelect": "rowSelect"; "columnClick": "columnClick"; "sortChange": "sortChange"; "pageChange": "pageChange"; "searchChange": "searchChange"; "rowSave": "rowSave"; }, never, never, false, never>;
 }
 
 /**
@@ -5501,4 +5619,4 @@ declare class SnackbarModule {
 }
 
 export { AlertComponent, AlertModule, ButtonComponent, ButtonDropdownComponent, ButtonDropdownModule, ButtonModule, CheckboxComponent, ClickOutsideDirective, ConfigColumnNodeComponent, ConfigFieldNodeComponent, ConfigSchemaTreeService, ConfigSectionNodeComponent, 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, FieldConfigurationService, FieldConfiguratorComponent, FieldSelectionComponent, FilterComponent, FilterModule, FilterSidebarComponent, FilterSidebarModule, FilterTableSelectorComponent, FilterTableSelectorModule, FormBuilderModule, FormComponentsModule, FormFieldConfigurationComponent, FormFieldConfigurationModule, 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, TableColumnConfigurationComponent, TableColumnConfigurationModule, TableColumnConfigurationService, TimePickerComponent, TimePickerModule, TimeWheelPanelComponent, ToggleComponent, ValidationUtils, appendBaseUrlRecursively, clearLocalStorage, clearSessionStorage, getLocalStorageItem, getSessionStorageItem, removeLocalStorageItem, removeSessionStorageItem, setLocalStorageItem, setSessionStorageItem, translateConfig };
-export type { ActionVisibility, AlertLabels, AlertVariant, AttachmentConfig, ButtonLabels, ButtonVariant, CheckboxConfig, CheckboxLabels, CheckboxOption, ColumnLookupConfig, ConfigColumnNode, ConfigFieldNode, ConfigSectionNode, ConfirmationModalConfig, DateConfig, DatePickerConfig, DatepickerLabels, DropdownAction, DropdownConfig, DropdownLabels, DropdownOption, EmailConfig, FieldColSpanPayload, FieldConfig, FieldEventPayload, FieldReorderPayload, 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, SuffixActionIcon, SummaryCardConfig, SummaryCardLabels, SummaryCardMeta, TableAction, TableActionItem, TableColumn, TableColumnSubField, TableConfig, TableDataChangeEvent, TableFilter, TableFilterChangeEvent, TableFilterColumn, TableFilterConfig, TableFilterItem, TableFilterLabels, TableFilterOutput, TableLabels, TableOption, TableRowSaveEvent, TableTheme, TextConfig, TimeMode, TimePickerConfig, TimePickerLabels, TimePickerVariant, ToggleConfig, ToggleLabels, UIConfig, UISubType, UIType, UploadedFile, ValidationResult, ValidationRules, VisibilityRule };
+export type { ActionVisibility, AlertLabels, AlertVariant, AttachmentConfig, ButtonLabels, ButtonVariant, CheckboxConfig, CheckboxLabels, CheckboxOption, ColumnLookupConfig, ConfigColumnNode, ConfigFieldNode, ConfigSectionNode, ConfirmationModalConfig, DateConfig, DatePickerConfig, DatepickerLabels, DropdownAction, DropdownConfig, DropdownLabels, DropdownOption, EmailConfig, FieldColSpanPayload, FieldConfig, FieldEventPayload, FieldReorderPayload, 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, RepeaterHost, 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, TimeMode, TimePickerConfig, TimePickerLabels, TimePickerVariant, ToggleConfig, ToggleLabels, UIConfig, UISubType, UIType, UploadedFile, ValidationResult, ValidationRules, VisibilityRule };

package/package.json

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

package/src/lib/modules/filter-sidebar/filter-sidebar.theme.scss

@@ -8,14 +8,21 @@ $default-filter-sidebar-config: (
     bg: #FEFEFE,
     border-radius: 0,
 
-    // Header
+    // Header — a full-width bar at the top of the panel; 'light' is the default theme:
+    // white bar, black title, divider along the bottom. 'dark' inverts it.
     header-height: 3rem,
+    header-padding: 0.5rem 1.5rem,
     header-title-size: 1.125rem,
     header-title-weight: 500,
     header-title-color: #202124,
+    header-bg-dark: #262125,
+    header-title-color-dark: #FFFFFF,
+    header-icon-color-dark: rgba(255, 255, 255, 0.7),
+    header-bg-light: #FFFFFF,
+    header-border-bottom-light: 1px solid #E0E0E0,
 
     // Footer
-    footer-padding: 1rem 0 0 0,
+    footer-padding: 1rem 1.5rem 1.5rem,
     footer-gap: 1rem,
 );
 
@@ -29,9 +36,15 @@ $default-filter-sidebar-config: (
     --cc-filter-sidebar-border-radius: #{map.get($config, border-radius)};
 
     --cc-filter-header-height: #{map.get($config, header-height)};
+    --cc-filter-header-padding: #{map.get($config, header-padding)};
     --cc-filter-header-title-size: #{map.get($config, header-title-size)};
     --cc-filter-header-title-weight: #{map.get($config, header-title-weight)};
     --cc-filter-header-title-color: #{map.get($config, header-title-color)};
+    --cc-filter-header-bg-dark: #{map.get($config, header-bg-dark)};
+    --cc-filter-header-title-color-dark: #{map.get($config, header-title-color-dark)};
+    --cc-filter-header-icon-color-dark: #{map.get($config, header-icon-color-dark)};
+    --cc-filter-header-bg-light: #{map.get($config, header-bg-light)};
+    --cc-filter-header-border-bottom-light: #{map.get($config, header-border-bottom-light)};
 
     --cc-filter-footer-padding: #{map.get($config, footer-padding)};
     --cc-filter-footer-gap: #{map.get($config, footer-gap)};