commons-shared-web-ui 0.0.63 → 0.0.65

package/index.d.ts

@@ -10,7 +10,7 @@ import * as i3$2 from '@angular/router';
 import { Router, ActivatedRoute } from '@angular/router';
 import { BehaviorSubject, Subject, Observable } from 'rxjs';
 import * as i8$1 from '@angular/cdk/overlay';
-import { ConnectedPosition } from '@angular/cdk/overlay';
+import { ScrollStrategy, Overlay, ConnectedPosition } from '@angular/cdk/overlay';
 import { DomSanitizer, SafeResourceUrl, SafeHtml } from '@angular/platform-browser';
 import * as i1 from '@angular/material/card';
 import * as i3 from '@angular/material/checkbox';
@@ -420,16 +420,70 @@ interface DropdownSearchConfig {
     mode?: 'local' | 'server';
     /** Query parameter key for the search term sent to the API (default: 'search'). Only used in 'server' mode. */
     searchKey?: string;
+    /** Handling mode: 'standard' (e.g. ?search=term) or 'nested_string' (e.g. ?params=...--SEARCH_TEXT=term) */
+    handling?: 'standard' | 'nested_string';
     /** Minimum characters required before triggering a server-side search (default: 3). Only used in 'server' mode. */
     minSearchLength?: number;
     /** Debounce delay in milliseconds before firing search (default: 300). */
     debounceTime?: number;
 }
+interface NestedStringConfig$1 {
+    /** Name of the URL query parameter holding the packed string. Default: 'params' */
+    paramName: string;
+    /** Static base string prepended before dynamic parameters. E.g. 'MARKET_ID=5' */
+    baseValue?: string;
+    /** Delimiter string between key-value pairs. Default: '--' */
+    separator: string;
+    /** Key-value assignment operator. Default: '=' */
+    assignment?: string;
+}
+interface QueryParamsConfig$1 {
+    /** Query parameter key for page index. Default: 'page' */
+    pageKey?: string;
+    /** Query parameter key for page size. Default: 'size' */
+    sizeKey?: string;
+    /** Page index offset adjustment (e.g. -1 or 0 or 1). Default: 0 */
+    pageIndexOffset?: number;
+    /** Handling mode: 'standard' or 'nested_string' */
+    filterHandling?: 'standard' | 'nested_string';
+    /** Nested string configuration for Dataset APIs */
+    nestedStringConfig?: NestedStringConfig$1;
+}
+interface TotalCountConfig {
+    /** 'same' (count returned in data response) or 'separate' (dedicated count endpoint). Default: 'same' */
+    source?: 'same' | 'separate';
+    /** Dedicated Count API URL (required when source === 'separate') */
+    apiUrl?: string;
+    /** Dot-notation path to extract count (e.g. '0.totalCount', '[0].totalCount', 'totalElements', 'data.total') */
+    responsePath?: string;
+}
+interface DropdownPaginationConfig {
+    /** Enable server-side pagination. */
+    enabled: boolean;
+    /** 'loadMore' button or 'infiniteScroll' on scroll. Default: 'loadMore' */
+    mode?: 'loadMore' | 'infiniteScroll';
+    /** Page size per request. Default: 10 */
+    pageSize?: number;
+    /** Query param for page index (shorthand when queryParamsConfig is not provided). Default: 'page' */
+    pageKey?: string;
+    /** Query param for page size (shorthand when queryParamsConfig is not provided). Default: 'size' */
+    sizeKey?: string;
+    /** 0 for 0-indexed APIs, 1 for 1-indexed APIs. Default: 0 */
+    pageOffset?: number;
+    /** Configuration for dataset separate count API or same-response count parsing */
+    totalCountConfig?: TotalCountConfig;
+    /** Shorthand for totalCountConfig.responsePath */
+    totalCountPath?: string;
+}
 interface OptionConfig$1 {
     optionClass?: string;
     optionUrl?: string;
     apiUrl?: string;
     apiUrls?: string[];
+    /** HTTP method for option API requests. Default: 'GET' */
+    apiMethod?: 'GET' | 'POST' | 'PUT' | 'PATCH';
+    /** Custom request payload body sent with POST/PUT/PATCH requests. */
+    apiPayload?: any;
     dataPath?: string;
     labelPath?: string;
     valuePath?: string;
@@ -442,6 +496,12 @@ interface OptionConfig$1 {
     optionList?: OptionItem[];
     /** Configuration for enabling search functionality inside the dropdown panel. */
     searchConfig?: DropdownSearchConfig;
+    /** Query parameters configuration matching smart-table (for pagination and dataset APIs). */
+    queryParamsConfig?: QueryParamsConfig$1;
+    /** Server-side pagination configuration (loadMore or infiniteScroll). */
+    pagination?: DropdownPaginationConfig;
+    /** Nested string config shorthand for Dataset APIs. */
+    nestedStringConfig?: NestedStringConfig$1;
     /** When true, renders a 'Select All' checkbox at the top of a MULTIPLE select dropdown. */
     showSelectAll?: boolean;
     /** When true, displays a loading spinner during options API requests. */
@@ -960,7 +1020,7 @@ interface ConfiguratorTreeNode {
     label: string;
     /** Node type */
     type: ConfiguratorNodeType;
-    /** Whether the node is expanded (for groups/sections) */
+    /** Whether the node is expanded (for groups/sections, and for a 'field' node with children — see geoClassCode) */
     expanded: boolean;
     /** Reference to the FieldConfig (only for field nodes) */
     fieldConfig: FieldConfig | null;
@@ -968,6 +1028,14 @@ interface ConfiguratorTreeNode {
     path: number[];
     /** Child nodes */
     children: ConfiguratorTreeNode[];
+    /**
+     * Set only on synthetic geography-hierarchy-level nodes (children of a GEOGRAPHY_DYNAMIC
+     * field, e.g. Country/State/District). These don't exist as real schema array children —
+     * they live in the parent field's nested `geographyConfig.field.nodes` map — so `path` on
+     * these nodes equals the PARENT GEOGRAPHY_DYNAMIC field's own path, and `geoClassCode` is
+     * what actually distinguishes one level (and the parent itself, where it's undefined).
+     */
+    geoClassCode?: string;
 }
 
 /**
@@ -980,6 +1048,16 @@ declare class FieldConfiguratorService {
     readonly tree: i0.Signal<ConfiguratorTreeNode[]>;
     readonly schema: i0.Signal<FormSchema>;
     readonly selectedFieldPath: i0.Signal<number[]>;
+    readonly selectedGeoClassCode: i0.Signal<string>;
+    /**
+     * Resolves to the real FieldConfig at the selected path — UNLESS the selection is a
+     * synthetic geography-hierarchy-level node (selectedGeoClassCode set), in which case this
+     * returns a small synthetic FieldConfig built from that level's entry in the parent
+     * GEOGRAPHY_DYNAMIC field's `geographyConfig.field.nodes` map instead. Every downstream
+     * consumer (selectedFieldInfo, selectedFieldBuilderType, the config panel itself) works
+     * against whichever shape comes out of here unchanged — mapFieldTypeToBuilderType('GEOGRAPHY_NODE')
+     * resolves the right minimal config schema (label/colSpan only, see field-type-schema.map.ts).
+     */
     readonly selectedField: i0.Signal<FieldConfig>;
     readonly selectedFieldInfo: i0.Signal<ConfiguratorFieldInfo>;
     /**
@@ -992,9 +1070,11 @@ declare class FieldConfiguratorService {
      */
     loadSchema(schema: FormSchema, preserveSelection?: boolean): void;
     /**
-     * Select a field by its path. Pass null to deselect.
+     * Select a field by its path. Pass null to deselect. `geoClassCode` selects a synthetic
+     * geography-hierarchy-level child of the GEOGRAPHY_DYNAMIC field at `path` instead of the
+     * field itself — see ConfiguratorTreeNode.geoClassCode / selectedField above.
      */
-    selectField(path: number[] | null): void;
+    selectField(path: number[] | null, geoClassCode?: string | null): void;
     /**
      * Toggle a tree node's expanded state.
      */
@@ -1007,7 +1087,8 @@ declare class FieldConfiguratorService {
     /**
      * Change the type (and optionally subType) of the currently selected field.
      * Mapping goes from builderType keys (e.g. 'richText') → {type, subType?}.
-     * DROPDOWN fields cannot be changed and are guarded here as well.
+     * DROPDOWN fields cannot be changed and are guarded here as well — same for a synthetic
+     * geography-hierarchy-level selection, which has no real `type` to switch at all.
      */
     changeFieldType(builderType: string): void;
     /**
@@ -1048,7 +1129,10 @@ declare class FieldConfiguratorComponent implements OnChanges {
     finalFieldTypeSchemaMap: Record<string, FormSchema>;
     private _isInternalChange;
     ngOnChanges(changes: SimpleChanges): void;
-    onFieldSelected(path: number[]): void;
+    onFieldSelected(selection: {
+        path: number[];
+        geoClassCode?: string;
+    }): void;
     onNodeToggleExpanded(nodeId: string): void;
     onConfigChange(patch: Record<string, unknown>): void;
     onTypeChange(builderType: string): void;
@@ -1128,7 +1212,13 @@ declare class SelectionFieldNodeComponent {
 declare class ConfiguratorTreeComponent {
     tree: ConfiguratorTreeNode[];
     selectedFieldPath: number[] | null;
-    selectField: EventEmitter<number[]>;
+    /** Distinguishes a GEOGRAPHY_DYNAMIC field itself from one of its synthetic hierarchy-level
+     *  children — both share the same `path`, so `path` alone can't tell them apart. */
+    selectedGeoClassCode: string | null;
+    selectField: EventEmitter<{
+        path: number[];
+        geoClassCode?: string;
+    }>;
     toggleExpanded: EventEmitter<string>;
     onNodeClick(node: ConfiguratorTreeNode): void;
     onFieldSelect(node: ConfiguratorTreeNode): void;
@@ -1137,7 +1227,7 @@ declare class ConfiguratorTreeComponent {
     trackByNodeId(_index: number, node: ConfiguratorTreeNode): string;
     private pathsEqual;
     static ɵfac: i0.ɵɵFactoryDeclaration<ConfiguratorTreeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ConfiguratorTreeComponent, "lib-configurator-tree", never, { "tree": { "alias": "tree"; "required": false; }; "selectedFieldPath": { "alias": "selectedFieldPath"; "required": false; }; }, { "selectField": "selectField"; "toggleExpanded": "toggleExpanded"; }, never, never, false, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ConfiguratorTreeComponent, "lib-configurator-tree", never, { "tree": { "alias": "tree"; "required": false; }; "selectedFieldPath": { "alias": "selectedFieldPath"; "required": false; }; "selectedGeoClassCode": { "alias": "selectedGeoClassCode"; "required": false; }; }, { "selectField": "selectField"; "toggleExpanded": "toggleExpanded"; }, never, never, false, never>;
 }
 
 type SnackbarVariant = 'success' | 'error' | 'warning' | 'info';
@@ -1200,7 +1290,8 @@ declare class ConfiguratorConfigPanelComponent implements OnChanges {
     currentBuilderType: string | null;
     /** Identity key of the currently rendered field — used to detect real field switches. */
     private _currentFieldKey;
-    /** True when the current field type is DROPDOWN — type switching is disabled for these fields. */
+    /** True when type switching should be disabled — DROPDOWN-based fields, and synthetic
+     *  geography-hierarchy-level nodes (GEOGRAPHY_NODE), which have no real `type` to switch. */
     get isDropdownType(): boolean;
     ngOnChanges(changes: SimpleChanges): void;
     /**
@@ -1402,6 +1493,7 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     private expressionService;
     private http;
     private hostRef;
+    private overlay;
     config: FieldConfig;
     controller: SmartFormController;
     /**
@@ -1450,6 +1542,10 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     get effectiveMaxTime(): string | null;
     isMultiDropdownOpen: boolean;
     isSingleDropdownOpen: boolean;
+    dropdownCurrentPage: number;
+    dropdownTotalCount: number;
+    hasMoreDropdownPages: boolean;
+    isDropdownLoadingMore: boolean;
     searchText: string;
     filteredOptionList: any[];
     dropdownSearch$: Subject<string>;
@@ -1542,9 +1638,11 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
      * Priority: sectionConfig.name > field.name > camelCase(label) > '__group__'
      */
     get groupKey(): string;
-    constructor(fb: FormBuilder, expressionService: ExpressionService, http: HttpClient, hostRef: ElementRef<HTMLElement>);
+    readonly dropdownScrollStrategy: ScrollStrategy;
+    constructor(fb: FormBuilder, expressionService: ExpressionService, http: HttpClient, hostRef: ElementRef<HTMLElement>, overlay: Overlay);
     /** Portal root, resolved from this component's own node rather than the global document. */
     private get portalRoot();
+    private _onGlobalScroll;
     ngOnInit(): void;
     get addMultiLabel(): string;
     /** Getter for Select placeholder label */
@@ -1565,6 +1663,8 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     get singleSelectedLabel(): string;
     /** Whether the dropdown search feature is enabled for this field */
     get isSearchableDropdown(): boolean;
+    /** Whether the custom single-select dropdown overlay is required (for search OR pagination) */
+    get isCustomSingleDropdown(): boolean;
     private initGroupField;
     /**
      * Sets up cross-field validation based on the `onValidate` formula.
@@ -1640,9 +1740,21 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     }): any;
     extractFunctionName(formula: string): string | null;
     setupDependencies(): void;
+    /** Extracts the total item count from an API response using the configured path or fallbacks. */
+    private extractTotalCount;
+    /** Builds HttpParams for dropdown requests supporting both standard and nested_string (dataset) formats. */
+    private buildDropdownQueryParams;
+    /**
+     * Loads options for DROPDOWN / AUTOCOMPLETE fields.
+     * Supports server-side pagination, separate Dataset count endpoints, and nested_string params.
+     */
     loadDropdownOptions(dynamicParams?: {
         [key: string]: any;
-    }): void;
+    }, pageIndex?: number, isLoadMore?: boolean): void;
+    /** Triggers loading the next page of dropdown options. */
+    loadMoreDropdownOptions(): void;
+    /** Handles scroll event on the dropdown options panel for infiniteScroll mode. */
+    onDropdownScroll(event: Event): void;
     private getValueByPath;
     /**
      * Replaces `{placeholder}` tokens in a URL with values resolved from the
@@ -1692,6 +1804,7 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     toggleSingleDropdown(event: MouseEvent): void;
     selectSingleOption(option: any): void;
     onDocumentClick(): void;
+    onWindowResize(): void;
     onEscapeKey(): void;
     get multiSelectedCount(): number;
     /** Cache of values currently chosen for this field name by OTHER repeater instances.
@@ -4962,9 +5075,22 @@ declare function appendBaseUrlRecursively(obj: any, baseURL: string): void;
 interface HierarchyCfg {
     templateApiUrl: string;
     templateListPath: string | null;
-    templateSelect: 'default' | 'first' | 'byCode';
+    templateSelect: 'default' | 'first' | 'byCode' | 'byId';
     templateSelectField: string;
     templateSelectCode?: string;
+    /** Used when templateSelect === 'byId' — matches a template by its numeric `id`, since
+     *  multiple templates can share the same templateCode (distinguished by templateName). */
+    templateSelectId?: number;
+    /**
+     * When set, the caller already has the resolved MdmClassHierarchyTemplateDTO-shaped object
+     * (e.g. it fetched and picked it client-side already) — used as-is, skipping the runtime's
+     * own HTTP GET to templateApiUrl and the templateSelect/templateSelectId matching entirely.
+     * Trades the always-live "re-fetch and re-match by id" behavior for zero extra network
+     * round-trips; the caller is responsible for re-supplying fresh data if the underlying
+     * template changes later. Analogous to how optionConfig.optionList is a static alternative
+     * to optionConfig.apiUrl for dropdown fields.
+     */
+    templateData?: any;
     rootCodePath: string;
     templateCodePath: string;
     hierarchyListPath: string;

package/package.json

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