bways-report 0.1.6 → 0.1.8

package/lib/features/embed/bways-report-builder.component.d.ts

@@ -0,0 +1,48 @@
+import { OnInit } from '@angular/core';
+import { ReportDefinition, ReportSummary } from '../../core/models/report-definition.model';
+import * as i0 from "@angular/core";
+/**
+ * `<bways-report-builder>`
+ *
+ * Drop-in, single-tag visual report designer component for host applications.
+ *
+ * Wraps the full visual builder with:
+ * - Direct width and height inputs (`width="100%" height="calc(100vh - 64px)"`)
+ * - Built-in report selector dropdown and "+ New Report" button
+ * - Automatic persistence and menu synchronization
+ *
+ * Usage:
+ * ```html
+ * <!-- Drop anywhere in your admin or report management page -->
+ * <bways-report-builder width="100%" height="calc(100vh - 64px)" />
+ * ```
+ */
+export declare class BwaysReportBuilderComponent implements OnInit {
+    private readonly store;
+    private readonly destroyRef;
+    /** Width of the builder container. Defaults to '100%'. */
+    readonly width: import("@angular/core").InputSignal<string>;
+    /** Height of the builder container. Defaults to '100%'. */
+    readonly height: import("@angular/core").InputSignal<string>;
+    /** Initial report ID to open in the designer. */
+    readonly reportId: import("@angular/core").InputSignal<string | undefined>;
+    /** Whether to show the top switcher bar with report selector and "+ New" button. */
+    readonly showReportList: import("@angular/core").InputSignal<boolean>;
+    /** Emitted when a report definition is saved. */
+    readonly saved: import("@angular/core").OutputEmitterRef<ReportDefinition>;
+    /** Emitted when the report definition changes. */
+    readonly definitionChange: import("@angular/core").OutputEmitterRef<ReportDefinition>;
+    /** Emitted when a report is selected from the list. */
+    readonly reportSelect: import("@angular/core").OutputEmitterRef<string>;
+    readonly activeReportId: import("@angular/core").WritableSignal<string | null>;
+    readonly reportsList: import("@angular/core").WritableSignal<ReportSummary[]>;
+    readonly saveStatus: import("@angular/core").WritableSignal<string | null>;
+    readonly designerKey: import("@angular/core").WritableSignal<number>;
+    ngOnInit(): void;
+    onSelectReport(id: string): void;
+    createNewReport(): void;
+    onReportSaved(def: ReportDefinition): void;
+    private refreshReports;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BwaysReportBuilderComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BwaysReportBuilderComponent, "bways-report-builder", never, { "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "reportId": { "alias": "reportId"; "required": false; "isSignal": true; }; "showReportList": { "alias": "showReportList"; "required": false; "isSignal": true; }; }, { "saved": "saved"; "definitionChange": "definitionChange"; "reportSelect": "reportSelect"; }, never, never, true, never>;
+}

package/lib/features/embed/bways-report-menu.component.d.ts

@@ -0,0 +1,40 @@
+import { ReportMenuGroup, ReportMenuItem } from '../routing/models/report-route.models';
+import * as i0 from "@angular/core";
+export type ReportMenuVariant = 'sidebar' | 'navbar' | 'dropdown';
+/**
+ * Drop-in menu component for bways-report.
+ *
+ * Automatically displays saved and published report pages from the backend or storage.
+ *
+ * Usage:
+ * ```html
+ * <!-- Sidebar navigation -->
+ * <bways-report-menu variant="sidebar" />
+ *
+ * <!-- Horizontal navigation bar -->
+ * <bways-report-menu variant="navbar" />
+ *
+ * <!-- Header dropdown button -->
+ * <bways-report-menu variant="dropdown" />
+ * ```
+ */
+export declare class BwaysReportMenuComponent {
+    readonly variant: import("@angular/core").InputSignal<ReportMenuVariant>;
+    readonly basePath: import("@angular/core").InputSignal<string | undefined>;
+    readonly title: import("@angular/core").InputSignal<string>;
+    readonly showIcons: import("@angular/core").InputSignal<boolean>;
+    readonly allowSearch: import("@angular/core").InputSignal<boolean>;
+    readonly includeDrafts: import("@angular/core").InputSignal<boolean>;
+    readonly searchQuery: import("@angular/core").WritableSignal<string>;
+    readonly isOpen: import("@angular/core").WritableSignal<boolean>;
+    readonly collapsedGroups: import("@angular/core").WritableSignal<Set<string>>;
+    private readonly rawMenu;
+    private readonly rawGroups;
+    readonly totalItems: import("@angular/core").Signal<number>;
+    readonly filteredFlatItems: import("@angular/core").Signal<ReportMenuItem[]>;
+    readonly filteredGroups: import("@angular/core").Signal<ReportMenuGroup[]>;
+    isGroupCollapsed(category: string): boolean;
+    toggleGroup(category: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BwaysReportMenuComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BwaysReportMenuComponent, "bways-report-menu", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "basePath": { "alias": "basePath"; "required": false; "isSignal": true; }; "title": { "alias": "title"; "required": false; "isSignal": true; }; "showIcons": { "alias": "showIcons"; "required": false; "isSignal": true; }; "allowSearch": { "alias": "allowSearch"; "required": false; "isSignal": true; }; "includeDrafts": { "alias": "includeDrafts"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/lib/features/embed/bways-report-page.component.d.ts

@@ -0,0 +1,61 @@
+import { ReportDefinition } from '../../core/models/report-definition.model';
+import { GridRowClickAction } from '../../core/models/report-grid.model';
+import * as i0 from "@angular/core";
+/**
+ * `<bways-report-page>`
+ *
+ * Drop-in standalone component that loads a saved report by its slug (or ID)
+ * and renders the complete interactive live form, data filters, and grid.
+ *
+ * Usage:
+ * ```html
+ * <!-- By slug (recommended) -->
+ * <bways-report-page slug="sale-report" />
+ *
+ * <!-- Or pass parameters & overrides -->
+ * <bways-report-page
+ *   [slug]="currentSlug"
+ *   [parameters]="{ BranchId: 5 }"
+ *   [showExport]="true"
+ *   (rowClick)="onRowSelected($event)"
+ * />
+ * ```
+ */
+export declare class BwaysReportPageComponent {
+    private readonly store;
+    private readonly destroyRef;
+    /** Report slug (e.g. 'sale-report') or unique ID */
+    readonly slug: import("@angular/core").InputSignal<string | undefined>;
+    /** Alternative alias for ID or slug */
+    readonly id: import("@angular/core").InputSignal<string | undefined>;
+    /** Explicit in-memory ReportDefinition if already loaded */
+    readonly report: import("@angular/core").InputSignal<ReportDefinition | null>;
+    /** Default input parameter values for the report */
+    readonly parameters: import("@angular/core").InputSignal<Record<string, unknown>>;
+    /** Whether to show export controls (Excel, CSV, Print) */
+    readonly showExport: import("@angular/core").InputSignal<boolean>;
+    /** Whether to enable saved view presets */
+    readonly enablePresets: import("@angular/core").InputSignal<boolean>;
+    /** Whether to automatically execute the query when the page opens */
+    readonly autoExecute: import("@angular/core").InputSignal<boolean>;
+    /** Container width */
+    readonly width: import("@angular/core").InputSignal<string>;
+    /** Container height */
+    readonly height: import("@angular/core").InputSignal<string>;
+    readonly rowClick: import("@angular/core").OutputEmitterRef<{
+        row: Record<string, unknown>;
+        parameters: Record<string, unknown>;
+        action?: GridRowClickAction;
+    }>;
+    readonly dataLoaded: import("@angular/core").OutputEmitterRef<unknown[]>;
+    readonly selectionChange: import("@angular/core").OutputEmitterRef<any[]>;
+    readonly selectionChanged: import("@angular/core").OutputEmitterRef<any[]>;
+    readonly loading: import("@angular/core").WritableSignal<boolean>;
+    readonly error: import("@angular/core").WritableSignal<string | null>;
+    readonly reportDefinition: import("@angular/core").WritableSignal<ReportDefinition | null>;
+    constructor();
+    reloadReport(): void;
+    private fetchReport;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BwaysReportPageComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BwaysReportPageComponent, "bways-report-page", never, { "slug": { "alias": "slug"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "report": { "alias": "report"; "required": false; "isSignal": true; }; "parameters": { "alias": "parameters"; "required": false; "isSignal": true; }; "showExport": { "alias": "showExport"; "required": false; "isSignal": true; }; "enablePresets": { "alias": "enablePresets"; "required": false; "isSignal": true; }; "autoExecute": { "alias": "autoExecute"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; }, { "rowClick": "rowClick"; "dataLoaded": "dataLoaded"; "selectionChange": "selectionChange"; "selectionChanged": "selectionChanged"; }, never, never, true, never>;
+}

package/lib/features/embed/index.d.ts

@@ -0,0 +1,4 @@
+export { BwaysReportBuilderComponent } from './bways-report-builder.component';
+export { BwaysReportPageComponent } from './bways-report-page.component';
+export { BwaysReportMenuComponent, type ReportMenuVariant } from './bways-report-menu.component';
+export { injectReportMenu, injectReportMenuGroups, type InjectReportMenuOptions, } from './inject-report-menu';

package/lib/features/embed/inject-report-menu.d.ts

@@ -0,0 +1,44 @@
+import { Signal } from '@angular/core';
+import { ReportMenuGroup, ReportMenuItem } from '../routing/models/report-route.models';
+/**
+ * Options for `injectReportMenu`.
+ */
+export interface InjectReportMenuOptions {
+    /**
+     * Base route path for generated links.
+     * Defaults to configured `routeBase` (e.g. 'reports') or '/reports'.
+     */
+    basePath?: string;
+    /**
+     * Whether to include draft/unpublished reports.
+     * Default: false (only published reports appear in menus).
+     */
+    includeDrafts?: boolean;
+}
+/**
+ * Injects a reactive signal of published report menu items.
+ *
+ * Automatically triggers loading of report metadata from the persistence store/endpoint
+ * if not already loaded.
+ *
+ * Usage in component:
+ * ```typescript
+ * @Component({ ... })
+ * export class AppSidebarComponent {
+ *   readonly reportMenu = injectReportMenu();
+ * }
+ * ```
+ * Usage in template:
+ * ```html
+ * @for (item of reportMenu(); track item.slug) {
+ *   <a [routerLink]="item.route">{{ item.name }}</a>
+ * }
+ * ```
+ */
+export declare function injectReportMenu(options?: InjectReportMenuOptions): Signal<ReportMenuItem[]>;
+/**
+ * Injects a reactive signal of published report menu groups (hierarchical).
+ *
+ * Useful for sidebars that organize reports under collapsible group headings.
+ */
+export declare function injectReportMenuGroups(options?: InjectReportMenuOptions): Signal<ReportMenuGroup[]>;

package/lib/features/index.d.ts

@@ -3,3 +3,4 @@ export * from './designer';
 export * from './persistence';
 export * from './routing';
 export * from './export';
+export * from './embed';

package/lib/features/persistence/services/report-store.service.d.ts

@@ -31,6 +31,11 @@ export declare class ReportStoreService {
      * @param forceRefresh - If true, bypasses the in-memory cache.
      */
     loadReport(reportId: string, forceRefresh?: boolean): Observable<ReportDefinition>;
+    /**
+     * Loads a report definition by slug or ID.
+     * Resolves from cache, loaded summaries, or adapter.
+     */
+    loadReportBySlug(slugOrId: string, forceRefresh?: boolean): Observable<ReportDefinition>;
     /**
      * Saves a report definition, validates it, and updates local cache.
      */

package/lib/features/routing/index.d.ts

@@ -2,5 +2,5 @@ export type { ReportRoutingConfig, ReportMenuItem, ReportMenuGroup } from './mod
 export { reportResolver } from './resolvers/report.resolver';
 export { RoutedReportRuntimeComponent } from './components/routed-report-runtime.component';
 export { RoutedReportDesignerComponent } from './components/routed-report-designer.component';
-export { createReportRoutes } from './report-routes';
+export { createReportRoutes, bwaysReportRoutes, type BwaysReportRoutesOptions } from './report-routes';
 export { ReportMenuService, groupReportsByCategory } from './services/report-menu.service';

package/lib/features/routing/models/report-route.models.d.ts

@@ -29,6 +29,9 @@ export interface ReportMenuItem {
     code: string;
     name: string;
     category: string;
+    slug: string;
+    menuGroup?: string;
+    menuOrder?: number;
     icon?: string;
     route: string;
     isDraft?: boolean;

package/lib/features/routing/report-routes.d.ts

@@ -14,3 +14,43 @@ import { ReportRoutingConfig } from './models/report-route.models';
  * ```
  */
 export declare function createReportRoutes(config?: ReportRoutingConfig): Routes;
+/**
+ * Configuration options for `bwaysReportRoutes`.
+ */
+export interface BwaysReportRoutesOptions {
+    /**
+     * Whether to include designer/builder routes ('new' and ':slug/edit').
+     * Defaults to false (since developers can embed <bways-report-builder> directly).
+     */
+    includeBuilder?: boolean;
+    /**
+     * Custom route guards for live report pages.
+     */
+    runtimeGuards?: any[];
+    /**
+     * Custom route guards for builder/designer pages if enabled.
+     */
+    builderGuards?: any[];
+    /**
+     * Optional custom route parameter name. Defaults to 'slug'.
+     */
+    slugParam?: string;
+    /**
+     * Extra static data passed into the route definitions.
+     */
+    extraData?: Record<string, unknown>;
+}
+/**
+ * Drop-in route definitions for bways-report.
+ *
+ * Example usage in host application `app.routes.ts`:
+ * ```typescript
+ * export const routes: Routes = [
+ *   {
+ *     path: 'reports',
+ *     children: bwaysReportRoutes()  // /reports/:slug -> live report page
+ *   }
+ * ];
+ * ```
+ */
+export declare function bwaysReportRoutes(options?: BwaysReportRoutesOptions): Routes;

package/lib/features/routing/resolvers/report.resolver.d.ts

@@ -2,6 +2,6 @@ import { ResolveFn } from '@angular/router';
 import { ReportDefinition } from '../../../core/models';
 /**
  * Functional resolver that fetches a ReportDefinition using ReportStoreService
- * based on the :reportId route parameter.
+ * based on the :slug or :reportId route parameter.
  */
 export declare const reportResolver: ResolveFn<ReportDefinition | null>;

package/lib/features/runtime/dynamic-renderer.component.d.ts

@@ -56,6 +56,7 @@ export declare class DynamicRendererComponent {
     getGridRow(comp: ReportComponentDefinition): string;
     getComponentHeight(comp: ReportComponentDefinition): string;
     getComponentMinHeight(comp: ReportComponentDefinition): string;
+    isFormInput(type: string): boolean;
     isComponentVisible(comp: ReportComponentDefinition): boolean;
     onSubmit(): void;
     handleAction(action: ComponentActionDefinition, comp?: ReportComponentDefinition): void;

package/lib/features/runtime/report-grid-bridge.component.d.ts

@@ -19,6 +19,7 @@ export declare class RptGridOutletDirective implements OnDestroy {
     }>;
     readonly selectionChange: import("@angular/core").OutputEmitterRef<any[]>;
     constructor();
+    private canAcceptInput;
     private isReportStateMatching;
     private isColumnDefsMatching;
     private recreateComponent;
@@ -180,7 +181,6 @@ export declare class ReportGridBridgeComponent {
         reportState: any;
         pagination: boolean;
         pageSize: number;
-        rowSelection: "single" | "multiple";
     }>;
     readonly showRowNumbers: import("@angular/core").Signal<boolean>;
     readonly isPaginationEnabled: import("@angular/core").Signal<boolean>;

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

@@ -7,6 +7,9 @@ export declare class RptButtonComponent {
     readonly onAction: import("@angular/core").InputSignal<((action: ComponentActionDefinition) => void) | undefined>;
     readonly actionTriggered: import("@angular/core").OutputEmitterRef<ComponentActionDefinition>;
     readonly elementId: import("@angular/core").Signal<string>;
+    readonly showFieldLabel: import("@angular/core").Signal<boolean>;
+    readonly fieldLabel: import("@angular/core").Signal<string>;
+    readonly hasLabelSpacer: import("@angular/core").Signal<boolean>;
     readonly buttonLabel: import("@angular/core").Signal<string>;
     readonly buttonHtmlType: import("@angular/core").Signal<"submit" | "button" | "reset">;
     readonly isDisabled: import("@angular/core").Signal<boolean>;

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 {
@@ -10,13 +11,18 @@ export declare class RptDropdownComponent implements OnDestroy {
     private readonly masterDataProvider;
     private readonly lookupAdapter;
     private readonly sessionService;
-    private readonly reportingConfig;
     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?;
@@ -48,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>;
@@ -64,6 +75,8 @@ 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;
@@ -79,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`.
  */
@@ -116,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.6",
+  "version": "0.1.8",
   "description": "Enterprise-grade, metadata-driven reporting engine and visual page builder for Angular 18+ ERP applications.",
   "keywords": [
     "angular",