bways-report 0.1.5 → 0.1.7

package/lib/primitives/components/dropdown/rpt-dropdown.component.d.ts

@@ -1,5 +1,6 @@
 import { ElementRef, OnDestroy } from '@angular/core';
 import { FormControl, FormGroup } from '@angular/forms';
+import { ConnectedPosition, ConnectedOverlayPositionChange, ScrollStrategy } from '@angular/cdk/overlay';
 import { ReportComponentDefinition } from '../../../core/models/report-component.model';
 import * as i0 from "@angular/core";
 export interface DropdownOption {
@@ -11,11 +12,17 @@ export declare class RptDropdownComponent implements OnDestroy {
     private readonly lookupAdapter;
     private readonly sessionService;
     private readonly elementRef;
+    private readonly reportingConfig;
+    private readonly overlay;
+    readonly scrollStrategy: ScrollStrategy;
+    readonly triggerWidth: import("@angular/core").WritableSignal<string | number>;
+    readonly overlayPositions: ConnectedPosition[];
     readonly config: import("@angular/core").InputSignal<ReportComponentDefinition>;
     readonly control: import("@angular/core").InputSignal<FormControl<any> | null | undefined>;
     readonly parentForm: import("@angular/core").InputSignal<FormGroup<any> | null>;
     /** Designer mode: shows a small status line (Loading / N records / Waiting for…). */
     readonly showStatus: import("@angular/core").InputSignal<boolean>;
+    readonly dropdownClick: import("@angular/core").OutputEmitterRef<void>;
     private readonly fallbackControl;
     readonly dynamicOptions: import("@angular/core").WritableSignal<DropdownOption[]>;
     private lookupSub?;
@@ -47,9 +54,14 @@ export declare class RptDropdownComponent implements OnDestroy {
     readonly selectedOption: import("@angular/core").Signal<DropdownOption | null>;
     readonly filteredOptions: import("@angular/core").Signal<DropdownOption[]>;
     readonly MAX_FILTER_RENDER = 200;
+    readonly INITIAL_FILTER_RENDER = 200;
+    readonly filterRenderLimit: import("@angular/core").WritableSignal<number>;
     readonly visibleFilteredOptions: import("@angular/core").Signal<DropdownOption[]>;
     readonly excessFilteredCount: import("@angular/core").Signal<number>;
-    readonly MAX_RENDERED_OPTIONS = 500;
+    onOptionsScroll(event: Event): void;
+    loadMoreFiltered(): void;
+    loadAllFiltered(): void;
+    readonly MAX_RENDERED_OPTIONS = 5000;
     readonly renderedOptions: import("@angular/core").Signal<DropdownOption[]>;
     readonly hasExcessOptions: import("@angular/core").Signal<boolean>;
     readonly excessOptionsCount: import("@angular/core").Signal<number>;
@@ -63,9 +75,13 @@ export declare class RptDropdownComponent implements OnDestroy {
     isSelected(opt: DropdownOption): boolean;
     toggleOpen(event?: Event): void;
     openDropdown(): void;
+    onPositionChange(change: ConnectedOverlayPositionChange): void;
+    onOverlayAttached(): void;
     closeDropdown(): void;
     selectOption(opt: DropdownOption): void;
     clearSelection(event: Event): void;
+    /** Manually retry loading dynamic lookup options (e.g. after database timeout). */
+    retryLookup(event?: Event): void;
     clearSearch(event: Event): void;
     onSearchInput(event: Event): void;
     onTriggerKeydown(event: KeyboardEvent): void;
@@ -76,5 +92,5 @@ export declare class RptDropdownComponent implements OnDestroy {
     private scheduleReload;
     private reloadDataSourceOptions;
     static ɵfac: i0.ɵɵFactoryDeclaration<RptDropdownComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RptDropdownComponent, "rpt-dropdown", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; "control": { "alias": "control"; "required": false; "isSignal": true; }; "parentForm": { "alias": "parentForm"; "required": false; "isSignal": true; }; "showStatus": { "alias": "showStatus"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RptDropdownComponent, "rpt-dropdown", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; "control": { "alias": "control"; "required": false; "isSignal": true; }; "parentForm": { "alias": "parentForm"; "required": false; "isSignal": true; }; "showStatus": { "alias": "showStatus"; "required": false; "isSignal": true; }; }, { "dropdownClick": "dropdownClick"; }, never, never, true, never>;
 }

package/lib/primitives/components/index.d.ts

@@ -12,3 +12,5 @@ export type { KpiTheme, TrendDirection } from './kpi-card/rpt-kpi-card.component
 export { ReportChartBridgeComponent } from './chart-bridge/report-chart-bridge.component';
 export type { ChartDataItem, ChartType } from './chart-bridge/report-chart-bridge.component';
 export { RptIconComponent } from './icon/rpt-icon.component';
+export { RptSearchableSelectComponent } from './searchable-select/rpt-searchable-select.component';
+export type { SearchableSelectOption } from './searchable-select/rpt-searchable-select.component';

package/lib/primitives/components/searchable-select/rpt-searchable-select.component.d.ts

@@ -0,0 +1,89 @@
+import { ElementRef } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { ConnectedPosition, ConnectedOverlayPositionChange, ScrollStrategy } from '@angular/cdk/overlay';
+import * as i0 from "@angular/core";
+export interface SearchableSelectOption<T = any> {
+    value: T;
+    label: string;
+    sublabel?: string;
+    badge?: string;
+    disabled?: boolean;
+    group?: string;
+    data?: any;
+}
+export declare class RptSearchableSelectComponent implements ControlValueAccessor {
+    private readonly elementRef;
+    private readonly overlay;
+    readonly panelId: string;
+    readonly scrollStrategy: ScrollStrategy;
+    readonly triggerWidth: import("@angular/core").WritableSignal<string | number>;
+    readonly overlayPositions: ConnectedPosition[];
+    constructor(elementRef: ElementRef<HTMLElement>);
+    readonly options: import("@angular/core").InputSignal<any[] | SearchableSelectOption<any>[]>;
+    readonly value: import("@angular/core").InputSignal<any>;
+    readonly placeholder: import("@angular/core").InputSignal<string>;
+    readonly searchPlaceholder: import("@angular/core").InputSignal<string>;
+    readonly disabled: import("@angular/core").InputSignal<boolean>;
+    readonly loading: import("@angular/core").InputSignal<boolean>;
+    readonly loadingText: import("@angular/core").InputSignal<string>;
+    readonly emptyText: import("@angular/core").InputSignal<string>;
+    readonly clearable: import("@angular/core").InputSignal<boolean>;
+    readonly searchable: import("@angular/core").InputSignal<boolean>;
+    readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg">;
+    readonly id: import("@angular/core").InputSignal<string>;
+    readonly ariaLabel: import("@angular/core").InputSignal<string>;
+    readonly valueKey: import("@angular/core").InputSignal<string>;
+    readonly labelKey: import("@angular/core").InputSignal<string>;
+    readonly sublabelKey: import("@angular/core").InputSignal<string>;
+    readonly badgeKey: import("@angular/core").InputSignal<string>;
+    readonly panelMaxHeight: import("@angular/core").InputSignal<string>;
+    readonly openAbove: import("@angular/core").InputSignal<boolean | undefined>;
+    readonly valueChange: import("@angular/core").OutputEmitterRef<any>;
+    readonly selectionChange: import("@angular/core").OutputEmitterRef<SearchableSelectOption<any>>;
+    readonly opened: import("@angular/core").OutputEmitterRef<void>;
+    readonly closed: import("@angular/core").OutputEmitterRef<void>;
+    readonly triggerBtnEl: import("@angular/core").Signal<ElementRef<HTMLButtonElement> | undefined>;
+    readonly searchInputEl: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
+    readonly optionsListEl: import("@angular/core").Signal<ElementRef<HTMLElement> | undefined>;
+    readonly internalValue: import("@angular/core").WritableSignal<any>;
+    readonly isOpen: import("@angular/core").WritableSignal<boolean>;
+    readonly opensAbove: import("@angular/core").WritableSignal<boolean>;
+    readonly searchTerm: import("@angular/core").WritableSignal<string>;
+    readonly focusedIndex: import("@angular/core").WritableSignal<number>;
+    private readonly cvaDisabled;
+    private onChange;
+    private onTouched;
+    readonly isDisabled: import("@angular/core").Signal<boolean>;
+    readonly normalizedOptions: import("@angular/core").Signal<SearchableSelectOption<any>[]>;
+    readonly filteredOptions: import("@angular/core").Signal<SearchableSelectOption<any>[]>;
+    readonly MAX_VISIBLE_OPTIONS = 150;
+    readonly INITIAL_VISIBLE_OPTIONS = 150;
+    readonly renderedLimit: import("@angular/core").WritableSignal<number>;
+    readonly visibleFilteredOptions: import("@angular/core").Signal<SearchableSelectOption<any>[]>;
+    readonly excessCount: import("@angular/core").Signal<number>;
+    onOptionsScroll(event: Event): void;
+    loadMore(): void;
+    loadAll(): void;
+    readonly selectedOption: import("@angular/core").Signal<SearchableSelectOption<any> | undefined>;
+    writeValue(obj: any): void;
+    registerOnChange(fn: any): void;
+    registerOnTouched(fn: any): void;
+    setDisabledState?(isDisabled: boolean): void;
+    toggle(event?: Event): void;
+    open(): void;
+    onPositionChange(change: ConnectedOverlayPositionChange): void;
+    onOverlayAttached(): void;
+    close(): void;
+    selectOption(opt: SearchableSelectOption): void;
+    clearSelection(event: Event): void;
+    clearSearch(event: Event): void;
+    onSearchInput(event: Event): void;
+    onTriggerKeydown(event: KeyboardEvent): void;
+    onSearchKeydown(event: KeyboardEvent): void;
+    private scrollFocusedIntoView;
+    isSelected(opt: SearchableSelectOption): boolean;
+    onDocumentClick(event: MouseEvent): void;
+    onEscape(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RptSearchableSelectComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RptSearchableSelectComponent, "rpt-searchable-select", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "loadingText": { "alias": "loadingText"; "required": false; "isSignal": true; }; "emptyText": { "alias": "emptyText"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "valueKey": { "alias": "valueKey"; "required": false; "isSignal": true; }; "labelKey": { "alias": "labelKey"; "required": false; "isSignal": true; }; "sublabelKey": { "alias": "sublabelKey"; "required": false; "isSignal": true; }; "badgeKey": { "alias": "badgeKey"; "required": false; "isSignal": true; }; "panelMaxHeight": { "alias": "panelMaxHeight"; "required": false; "isSignal": true; }; "openAbove": { "alias": "openAbove"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; "selectionChange": "selectionChange"; "opened": "opened"; "closed": "closed"; }, never, never, true, never>;
+}

package/lib/provide-reporting.d.ts

@@ -11,6 +11,7 @@ import { MasterDataProvider } from './data-access/contracts/master-data.provider
 import { ReportPersistenceAdapter } from './data-access/contracts/report-persistence.contract';
 import { ReportSchemaDiscoveryAdapter } from './data-access/contracts/schema-discovery.contract';
 import { ReportLookupAdapter } from './data-access/contracts/lookup.contract';
+import { BwaysReportConfig } from './core/config/bways-report-config';
 /**
  * Kinds of reporting features available in `provideBwaysReport`.
  */
@@ -23,6 +24,7 @@ export declare enum ReportingFeatureKind {
  */
 export interface ReportingFeature<KindT extends ReportingFeatureKind = ReportingFeatureKind> {
     ɵkind: KindT;
+    ɵconfig?: Partial<ReportingConfig>;
     ɵproviders: Provider[];
 }
 /**
@@ -34,6 +36,11 @@ export interface HttpAdaptersOptions {
      * @example 'http://localhost:3000/api/reporting'
      */
     apiBaseUrl: string;
+    /**
+     * Optional custom timeout in milliseconds for database lookup queries.
+     * Defaults to 300000ms (5 minutes).
+     */
+    lookupTimeoutMs?: number;
 }
 /**
  * Configures the built-in HTTP adapters for backend execution, persistence,
@@ -110,16 +117,31 @@ export type ProvideBwaysReportingOptions = ProvideBwaysReportOptions;
 /**
  * Provides the BWays-Report library to the Angular application.
  *
- * Supports modern idiomatic feature functions, e.g.:
- * `provideReporting({ apiBaseUrl: '/api/reporting' })`
- * or zero-backend sandbox mode:
- * `provideReporting(withLocalStorage())`
+ * **Simple config (recommended for most projects):**
+ * ```typescript
+ * provideBwaysReport({
+ *   spEndpoint:      '/api/reporting/procedures',
+ *   tablesEndpoint:  '/api/reporting/tables',
+ *   executeEndpoint: '/api/reporting/execute',
+ *   reportsEndpoint: '/api/reporting/reports',
+ *   components: ['formInputs', 'actionButtons'],
+ *   session: () => inject(AuthService).session(),
+ * })
+ * ```
+ *
+ * **Advanced config (existing adapter pattern):**
+ * ```typescript
+ * provideBwaysReport(
+ *   { apiBaseUrl: '/api/reporting' },
+ *   withHttpAdapters({ apiBaseUrl: '/api/reporting' })
+ * )
+ * ```
  *
- * @param options - Configuration and adapter implementations.
+ * @param options - Either a `BwaysReportConfig` (simple) or `ProvideBwaysReportOptions` (advanced).
  * @param features - Optional features like `withHttpAdapters(...)` or `withLocalStorage()`.
  * @returns Environment providers for the reporting library.
  */
-export declare function provideBwaysReport(options?: ProvideBwaysReportOptions, ...features: ReportingFeature[]): EnvironmentProviders;
+export declare function provideBwaysReport(options?: BwaysReportConfig | ProvideBwaysReportOptions, ...features: ReportingFeature[]): EnvironmentProviders;
 /** Alias for provideBwaysReport */
 export declare const provideBwaysReporting: typeof provideBwaysReport;
 /** Backward-compatible alias for provideBwaysReport */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bways-report",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "Enterprise-grade, metadata-driven reporting engine and visual page builder for Angular 18+ ERP applications.",
   "keywords": [
     "angular",