commons-shared-web-ui 0.0.64 → 0.0.66

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.
@@ -3585,6 +3667,12 @@ interface TableConfig {
     theme?: TableTheme;
     requestParams?: Function;
     selectable?: boolean;
+    /**
+     * When `selectable` is true: `true`/omitted renders a checkbox per row (multiple rows
+     * selectable, plus a "select all" header checkbox). `false` renders a radio button per
+     * row instead — only one row selectable at a time, and the header checkbox is hidden.
+     */
+    multiSelect?: boolean;
     queryParamsConfig?: QueryParamsConfig;
     labels?: TableLabels;
     searchConfig?: SearchConfig;
@@ -4481,14 +4569,10 @@ interface FilterTableSelectorConfig {
     selectionConfig: SelectionConfig;
 }
 /**
- * Extended TableConfig for FilterTableSelector — adds multiSelect support.
+ * Extended TableConfig for FilterTableSelector.
+ * `multiSelect` (checkbox vs. radio row selection) is inherited from `TableConfig`.
  */
 interface FilterTableConfig extends TableConfig {
-    /**
-     * When true (and selectable=true), multiple rows can be selected simultaneously.
-     * When false, only one row can be selected at a time (radio behaviour).
-     */
-    multiSelect?: boolean;
 }
 
 declare class FilterTableSelectorComponent implements OnInit, OnChanges, OnDestroy {
@@ -4608,6 +4692,9 @@ declare class SmartTableComponent implements OnInit, OnChanges, AfterViewInit, O
     private router;
     private cdr;
     private ngZone;
+    private static instanceCounter;
+    /** Unique per-instance name for the row-selection radio group (see `isMultiSelect`). */
+    readonly radioGroupName: string;
     config: TableConfig;
     /**
      * External data mode: pass table rows directly from the parent.
@@ -4736,8 +4823,12 @@ declare class SmartTableComponent implements OnInit, OnChanges, AfterViewInit, O
     onDeleteCancel(): void;
     onTopAction(action: TableAction): void;
     private executeApiAction;
+    /** `false` (via `config.multiSelect`) switches row selection from checkboxes to a radio button per row. */
+    get isMultiSelect(): boolean;
     onSelectAll(event: Event): void;
     onRowSelect(row: any): void;
+    /** Single-select mode: the newly picked row replaces the entire selection, including across pages. */
+    onRowSelectSingle(row: any): void;
     updateSelectedRows(): void;
     getCellValue(row: any, col: TableColumn): any;
     getBadgeClass(row: any, col: TableColumn): string;

package/package.json

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