commons-shared-web-ui 0.0.76 → 0.0.78

package/index.d.ts

@@ -526,6 +526,33 @@ interface OptionConfig$1 {
      * pagination is added.
      */
     customUI?: boolean;
+    /** Edit-mode lookup for resolving primitive initial values (id/code) into full option objects via targeted API call. */
+    lookupConfig?: LookupConfig;
+}
+/**
+ * Configuration for resolving primitive initial values (id/code) into full
+ * option objects during edit-mode form initialization.
+ * Only fires when selectedOptionsData is absent and initialValues contains
+ * a primitive (not a full object).
+ */
+interface LookupConfig {
+    /** Endpoint URL. Supports {value} placeholder for single-item GET. */
+    apiUrl: string;
+    /** HTTP method. Default: 'GET'. Same convention as OptionConfig.apiMethod. */
+    apiMethod?: 'GET' | 'POST';
+    /** Static base payload for POST. Lookup value(s) merged via paramName key. */
+    apiPayload?: any;
+    /** Parameter key for the lookup value.
+     *  GET: query param (?id=2415 or ?ids=5,12,18)
+     *  POST: body key ({ "codes": ["MATH_01"] })
+     *  Default: 'id' (single) / 'ids' (multiple). */
+    paramName?: string;
+    /** Response path to extract results. Falls back to parent optionConfig.dataPath. */
+    dataPath?: string;
+    /** Custom HTTP headers. Same convention as AutocompleteConfig.headers. */
+    headers?: {
+        [key: string]: string;
+    };
 }
 interface AutocompleteDisplayField {
     /** Dot-notation path to the value in the API response item (e.g. 'login', 'contact.phone'). */
@@ -883,6 +910,10 @@ interface SelectionFieldNode {
     selected: boolean;
     /** If true, the field cannot be deselected by the user */
     isLocked: boolean;
+    /** True for a synthetic per-level node under a GEOGRAPHY_DYNAMIC master field (Country/State/
+     *  District/...) — lets the UI render it nested under its master and disable it while the
+     *  master is off, instead of showing it as an unrelated flat sibling. */
+    isGeographyLevel?: boolean;
 }
 /**
  * Wraps a section (SUBFIELDS / nested sectionConfig) with toggle + tree metadata.
@@ -942,6 +973,19 @@ declare class FieldSelectionService {
      * This prevents the UI from unexpectedly collapsing sections when the user toggles a field.
      */
     loadSchemaPreservingExpanded(schema: FormSchema): void;
+    /**
+     * A freshly-parsed group/section's `enabled` comes straight from its persisted
+     * FieldConfig.isEnabled — unlike toggleField()/toggleSection(), which always follow a mutation
+     * with `_recomputeEnabledFromChildren()` to keep the section/group toggle in sync with its
+     * children's actual selected state. Without this, a schema saved with e.g. Address.isEnabled:
+     * false but its Country/State/District checkboxes individually selected (a state that toggling
+     * from within the UI can never itself produce, but stale/pre-fix persisted data can) loads with
+     * checked child boxes sitting under a section toggle that shows OFF — contradicting what the
+     * checkboxes say and, worse, matching what the Configurator tree/actual form use to prune the
+     * whole section. Runs the same reconciliation parse-time gets on every load, so the toggle
+     * always reflects reality regardless of how the persisted schema got into this state.
+     */
+    private _reconcileGroupsFromChildren;
     /**
      * Toggle a group's enabled state. Disabling cascades to all sections + fields.
      * When enabling, all fields are selected (unless locked).
@@ -974,6 +1018,15 @@ declare class FieldSelectionService {
      * Used when toggling a section/group back ON to restore field selections.
      */
     private _enableAllSections;
+    /**
+     * Re-derives `enabled` bottom-up for every section in the list, from its own current
+     * fields/subsections — mirroring "Master Toggle Reflects Children" (already true for the
+     * GROUP toggle vs. its sections) at every level: a section is ON as long as at least one of
+     * its fields is selected or a subsection is ON. Without this, re-selecting a single field
+     * after its parent section was switched off left the section's own toggle stuck OFF even
+     * though a child was visibly selected again.
+     */
+    private _recomputeEnabledFromChildren;
     private _toggleSectionAtPath;
     private _toggleExpandedAtPath;
     private _toggleFieldAtPath;
@@ -1210,6 +1263,17 @@ declare class SelectionSectionNodeComponent {
     get selectedCount(): number;
     get isLocked(): boolean;
     trackByFieldIndex(index: number): number;
+    /**
+     * A GEOGRAPHY_DYNAMIC field's per-level nodes (Country/State/District/...) are built as flat
+     * entries immediately following their master in `section.fields` (see
+     * FormSchemaTreeService._buildGeographyFieldNodes) — there's no real nested schema structure
+     * to walk, so "master" here just means the nearest preceding non-level field.
+     */
+    private masterFieldFor;
+    /** True for a geography level whose master field is currently unselected — locked out so the
+     *  user can't leave an individually-checked level under an unchecked (and therefore pruned)
+     *  master; see masterFieldFor(). */
+    isFieldDisabled(field: SelectionFieldNode, index: number): boolean;
     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; }; "hideToggleForOptionTypes": { "alias": "hideToggleForOptionTypes"; "required": false; }; }, { "toggleEnabled": "toggleEnabled"; "toggleExpanded": "toggleExpanded"; "fieldToggle": "fieldToggle"; }, never, never, false, never>;
@@ -1224,9 +1288,17 @@ declare class SelectionFieldNodeComponent {
      * pre-configured by the developer and shouldn't be toggled by business users.
      */
     hideToggleForOptionTypes: boolean;
+    /**
+     * Set when the enclosing section is off. A field can never be meaningfully "selected" while
+     * its parent section is disabled — the Field Configuration step prunes the whole disabled
+     * branch regardless of individual field state — so the checkbox is locked out here to make
+     * that constraint visible instead of letting the user set a checked state that won't survive.
+     */
+    disabled: boolean;
+    onCheckedChange(): void;
     get isOptionDrivenType(): boolean;
     static ɵfac: i0.ɵɵFactoryDeclaration<SelectionFieldNodeComponent, 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>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<SelectionFieldNodeComponent, "lib-selection-field-node", never, { "field": { "alias": "field"; "required": true; }; "hideToggleForOptionTypes": { "alias": "hideToggleForOptionTypes"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "toggleSelected": "toggleSelected"; }, never, never, false, never>;
 }
 
 declare class ConfiguratorTreeComponent {
@@ -1515,6 +1587,7 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     private hostRef;
     private overlay;
     private dateAdapter;
+    private cdr;
     config: FieldConfig;
     controller: SmartFormController;
     /**
@@ -1663,6 +1736,12 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     private defaultStateSnapshot;
     /** Tracks whether the current localOptionList is filtered by an active server-side search query */
     private _isServerSearchActive;
+    /** True from the moment "Select All" is turned on until the user deselects a single option,
+     *  toggles it back off, or starts a new search. While active, each newly-arrived paginated
+     *  page (loadMoreDropdownOptions) is auto-merged into the selection — see loadDropdownOptions
+     *  — so the selected count keeps pace with what's been scrolled into view (e.g. 10 -> 20 -> 34)
+     *  instead of freezing at whatever was loaded the moment "Select All" was clicked. */
+    private _selectAllActive;
     /** Dedicated cache of currently selected option objects */
     selectedItems: any[];
     /** Cache of the latest dependency parameters for server-side autocomplete filtering */
@@ -1716,7 +1795,7 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
      */
     get groupKey(): string;
     readonly dropdownScrollStrategy: ScrollStrategy;
-    constructor(fb: FormBuilder, expressionService: ExpressionService, http: HttpClient, hostRef: ElementRef<HTMLElement>, overlay: Overlay, dateAdapter: DateAdapter<Date>);
+    constructor(fb: FormBuilder, expressionService: ExpressionService, http: HttpClient, hostRef: ElementRef<HTMLElement>, overlay: Overlay, dateAdapter: DateAdapter<Date>, cdr: ChangeDetectorRef);
     isFieldVisible(field: FieldConfig, rowController?: SmartFormController): boolean;
     /** Portal root, resolved from this component's own node rather than the global document. */
     private get portalRoot();
@@ -1922,6 +2001,12 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     resetDropdownSearch(forceLoad?: boolean, bypassCache?: boolean): void;
     /** Merges option(s) from selectedOptionsData into the local dropdown options list */
     mergeSelectedOptionsIntoList(): void;
+    /**
+     * If the field's initial value is a primitive (not an object) and no
+     * selectedOptionsData was provided, uses lookupConfig to fire a targeted
+     * API call to resolve the display label for edit-mode prefilling.
+     */
+    private _resolveLookupIfNeeded;
     /**
      * Extracts option(s) and their corresponding raw codes from an initial value object or array of objects.
      * If the value is a primitive but initialLabelField is configured, it looks up the sibling field value.
@@ -1936,6 +2021,9 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     isSomeSelected(): boolean;
     /** Toggles selection of all filtered options. */
     toggleSelectAll(checked: boolean): void;
+    /** Merges every currently-loaded filtered option into the selection — used to keep an
+     *  already-active "Select All" in sync as more paginated pages arrive (see loadDropdownOptions). */
+    private applySelectAllToLoadedOptions;
     get isTextField(): boolean;
     get isNumberField(): boolean;
     get isDateField(): boolean;
@@ -2760,6 +2848,7 @@ declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChang
     selectionChange: EventEmitter<any>;
     searchTermChange: EventEmitter<string>;
     loadMore: EventEmitter<void>;
+    opened: EventEmitter<void>;
     viewport?: CdkVirtualScrollViewport;
     searchInput?: ElementRef;
     triggerEl?: ElementRef;
@@ -2775,6 +2864,7 @@ declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChang
     };
     onChange: (value: any) => void;
     onTouched: () => void;
+    private selectAllActive;
     private search$;
     constructor(el: ElementRef);
     ngOnInit(): void;
@@ -2798,6 +2888,9 @@ declare class DropdownComponent implements ControlValueAccessor, OnInit, OnChang
     close(): void;
     get isAllFilteredSelected(): boolean;
     toggleSelectAll(): void;
+    /** Merges every currently-loaded selectable option into the selection — used to keep a
+     *  "Select All" that's already active in sync as more lazy-loaded pages arrive. */
+    private applySelectAllToLoadedOptions;
     selectOption(option: DropdownOption): void;
     isSelected(option: DropdownOption): boolean;
     onSearch(term: string): void;
@@ -2820,7 +2913,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; }; "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; }; "serverSearch": { "alias": "serverSearch"; "required": false; }; "searchDebounceMs": { "alias": "searchDebounceMs"; "required": false; }; "lazyLoad": { "alias": "lazyLoad"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "loadingMore": { "alias": "loadingMore"; "required": false; }; "hasMore": { "alias": "hasMore"; "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"; "searchTermChange": "searchTermChange"; "loadMore": "loadMore"; }, 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; }; "serverSearch": { "alias": "serverSearch"; "required": false; }; "searchDebounceMs": { "alias": "searchDebounceMs"; "required": false; }; "lazyLoad": { "alias": "lazyLoad"; "required": false; }; "loading": { "alias": "loading"; "required": false; }; "loadingMore": { "alias": "loadingMore"; "required": false; }; "hasMore": { "alias": "hasMore"; "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"; "searchTermChange": "searchTermChange"; "loadMore": "loadMore"; "opened": "opened"; }, never, never, false, never>;
 }
 
 interface CheckboxOption {
@@ -5330,6 +5423,10 @@ interface HierarchyCfg {
     /** Passed straight through onto every generated level's DROPDOWN optionConfig — same shape as
      *  optionConfig.pagination documented in smart-form.md (loadMore/infiniteScroll). */
     pagination?: any;
+    /** optionConfig.sortBy path applied to every generated level (Country/State/District/...).
+     *  Defaults to `labelPath` when not set — see _buildHierarchyFields(). Set explicitly (or to
+     *  an empty string to opt out) if a template needs different, or no, ordering. */
+    sortBy?: string;
 }
 
 declare class ValidationUtils {

package/package.json

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