commons-shared-web-ui 0.0.64 → 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. */
@@ -1433,6 +1493,7 @@ declare class FormFieldComponent implements OnInit, AfterViewInit, OnDestroy {
     private expressionService;
     private http;
     private hostRef;
+    private overlay;
     config: FieldConfig;
     controller: SmartFormController;
     /**
@@ -1481,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>;
@@ -1573,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 */
@@ -1596,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.
@@ -1671,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
@@ -1723,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.

package/package.json

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