bways-report 0.1.1 → 0.1.3

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

@@ -3,10 +3,12 @@ import { ComponentActionDefinition } from '../../../core/models/component-event.
 import * as i0 from "@angular/core";
 export declare class RptButtonComponent {
     readonly config: import("@angular/core").InputSignal<ReportComponentDefinition>;
+    readonly control: import("@angular/core").InputSignal<unknown>;
+    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 buttonLabel: import("@angular/core").Signal<string>;
-    readonly buttonHtmlType: import("@angular/core").Signal<"submit" | "button">;
+    readonly buttonHtmlType: import("@angular/core").Signal<"submit" | "button" | "reset">;
     readonly isDisabled: import("@angular/core").Signal<boolean>;
     readonly icon: import("@angular/core").Signal<string>;
     readonly buttonClasses: import("@angular/core").Signal<string>;
@@ -14,6 +16,7 @@ export declare class RptButtonComponent {
     readonly customHeight: import("@angular/core").Signal<string | null>;
     readonly customWidth: import("@angular/core").Signal<string | null>;
     onClick(event: MouseEvent): void;
+    private resolveAction;
     static ɵfac: i0.ɵɵFactoryDeclaration<RptButtonComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RptButtonComponent, "rpt-button", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; }, { "actionTriggered": "actionTriggered"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RptButtonComponent, "rpt-button", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; "control": { "alias": "control"; "required": false; "isSignal": true; }; "onAction": { "alias": "onAction"; "required": false; "isSignal": true; }; }, { "actionTriggered": "actionTriggered"; }, never, never, true, never>;
 }

package/lib/primitives/components/chart-bridge/report-chart-bridge.component.d.ts

@@ -24,6 +24,7 @@ export declare class ReportChartBridgeComponent {
     readonly maxValue: import("@angular/core").Signal<number>;
     readonly totalValue: import("@angular/core").Signal<number>;
     getBarPercentage(value: number): number;
+    formatValue(val: number): string;
     readonly donutSegments: import("@angular/core").Signal<{
         label: string;
         color: string;

package/lib/primitives/components/date-range/rpt-date-range.component.d.ts

@@ -0,0 +1,43 @@
+import { OnDestroy, OnInit } from '@angular/core';
+import { FormControl } from '@angular/forms';
+import { ReportComponentDefinition } from '../../../core/models/report-component.model';
+import * as i0 from "@angular/core";
+export interface DateRangeValue {
+    from: string;
+    to: string;
+    preset?: string;
+}
+export interface DateRangePreset {
+    id: string;
+    label: string;
+}
+export declare class RptDateRangeComponent implements OnInit, OnDestroy {
+    readonly config: import("@angular/core").InputSignal<ReportComponentDefinition>;
+    readonly control: import("@angular/core").InputSignal<FormControl<any> | null | undefined>;
+    private readonly fallbackControl;
+    readonly formControl: import("@angular/core").Signal<FormControl<any>>;
+    readonly elementId: import("@angular/core").Signal<string>;
+    readonly minDate: import("@angular/core").Signal<string | null>;
+    readonly maxDate: import("@angular/core").Signal<string | null>;
+    readonly showPresets: import("@angular/core").Signal<boolean>;
+    readonly presets: DateRangePreset[];
+    readonly fromDate: import("@angular/core").WritableSignal<string>;
+    readonly toDate: import("@angular/core").WritableSignal<string>;
+    readonly activePreset: import("@angular/core").WritableSignal<string>;
+    readonly hasValue: import("@angular/core").Signal<boolean>;
+    readonly rangeError: import("@angular/core").Signal<"" | "'From' date cannot be after 'To' date">;
+    readonly isInvalid: import("@angular/core").Signal<boolean>;
+    readonly errorMessage: import("@angular/core").Signal<string>;
+    private controlSub?;
+    constructor();
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    private syncControlValue;
+    applyPreset(presetId: string): void;
+    onFromChange(event: Event): void;
+    onToChange(event: Event): void;
+    clearRange(event: Event): void;
+    private emitRangeChange;
+    static ɵfac: i0.ɵɵFactoryDeclaration<RptDateRangeComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RptDateRangeComponent, "rpt-date-range", never, { "config": { "alias": "config"; "required": true; "isSignal": true; }; "control": { "alias": "control"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

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

@@ -1,32 +1,80 @@
-import { OnDestroy, OnInit } from '@angular/core';
-import { FormControl } from '@angular/forms';
+import { ElementRef, OnDestroy } from '@angular/core';
+import { FormControl, FormGroup } from '@angular/forms';
 import { ReportComponentDefinition } from '../../../core/models/report-component.model';
 import * as i0 from "@angular/core";
 export interface DropdownOption {
     key: string | number;
     label: string;
 }
-export declare class RptDropdownComponent implements OnInit, OnDestroy {
+export declare class RptDropdownComponent implements OnDestroy {
     private readonly masterDataProvider;
     private readonly lookupAdapter;
     private readonly sessionService;
+    private readonly elementRef;
     readonly config: import("@angular/core").InputSignal<ReportComponentDefinition>;
-    readonly control: import("@angular/core").InputSignal<FormControl<any> | undefined>;
+    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>;
     private readonly fallbackControl;
-    private readonly dynamicOptions;
+    readonly dynamicOptions: import("@angular/core").WritableSignal<DropdownOption[]>;
     private lookupSub?;
     private masterDataSub?;
+    private formChangesSub?;
+    private reloadTimer?;
+    private lastRequestKey;
+    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>;
+    readonly currentValue: import("@angular/core").WritableSignal<unknown>;
+    readonly comboboxWrapperEl: import("@angular/core").Signal<ElementRef<HTMLElement> | undefined>;
+    readonly searchInputEl: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
+    readonly optionsListEl: import("@angular/core").Signal<ElementRef<HTMLElement> | undefined>;
+    private controlSub?;
     readonly formControl: import("@angular/core").Signal<FormControl<any>>;
     readonly elementId: import("@angular/core").Signal<string>;
     readonly placeholder: import("@angular/core").Signal<string>;
+    readonly isSearchable: import("@angular/core").Signal<boolean>;
+    readonly isLoading: import("@angular/core").WritableSignal<boolean>;
+    readonly hasLoaded: import("@angular/core").WritableSignal<boolean>;
+    readonly loadError: import("@angular/core").WritableSignal<string | null>;
+    /** Canvas field keys that must be filled before the lookup can run. */
+    readonly waitingFor: import("@angular/core").WritableSignal<string[]>;
+    readonly isDynamicSource: import("@angular/core").Signal<boolean>;
     readonly staticOptions: import("@angular/core").Signal<DropdownOption[]>;
     readonly allOptions: import("@angular/core").Signal<DropdownOption[]>;
+    readonly selectedOption: import("@angular/core").Signal<DropdownOption | null>;
+    readonly filteredOptions: import("@angular/core").Signal<DropdownOption[]>;
+    readonly MAX_FILTER_RENDER = 200;
+    readonly visibleFilteredOptions: import("@angular/core").Signal<DropdownOption[]>;
+    readonly excessFilteredCount: import("@angular/core").Signal<number>;
+    readonly MAX_RENDERED_OPTIONS = 500;
+    readonly renderedOptions: import("@angular/core").Signal<DropdownOption[]>;
+    readonly hasExcessOptions: import("@angular/core").Signal<boolean>;
+    readonly excessOptionsCount: import("@angular/core").Signal<number>;
+    readonly waitingLabel: import("@angular/core").Signal<string>;
+    readonly statusKind: import("@angular/core").Signal<"error" | "idle" | "loading" | "ok" | "waiting" | "empty">;
+    readonly statusText: import("@angular/core").Signal<string>;
     readonly isInvalid: import("@angular/core").Signal<boolean>;
     readonly errorMessage: import("@angular/core").Signal<string>;
+    onDocumentClick(event: MouseEvent): void;
+    onEscape(): void;
+    isSelected(opt: DropdownOption): boolean;
+    toggleOpen(event?: Event): void;
+    openDropdown(): void;
+    closeDropdown(): void;
+    selectOption(opt: DropdownOption): void;
+    clearSelection(event: Event): void;
+    clearSearch(event: Event): void;
+    onSearchInput(event: Event): void;
+    onTriggerKeydown(event: KeyboardEvent): void;
+    onSearchKeydown(event: KeyboardEvent): void;
+    private scrollFocusedIntoView;
     constructor();
-    ngOnInit(): void;
     ngOnDestroy(): void;
+    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; }; }, {}, 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; }; }, {}, never, never, true, never>;
 }

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

@@ -2,6 +2,8 @@ export { RptInputComponent } from './input/rpt-input.component';
 export { RptDropdownComponent } from './dropdown/rpt-dropdown.component';
 export type { DropdownOption } from './dropdown/rpt-dropdown.component';
 export { RptDateComponent } from './date/rpt-date.component';
+export { RptDateRangeComponent } from './date-range/rpt-date-range.component';
+export type { DateRangeValue, DateRangePreset } from './date-range/rpt-date-range.component';
 export { RptNumberComponent } from './number/rpt-number.component';
 export { RptCheckboxComponent } from './checkbox/rpt-checkbox.component';
 export { RptButtonComponent } from './button/rpt-button.component';

package/lib/provide-reporting.d.ts

@@ -1,9 +1,9 @@
 /**
- * Reporting library root provider function.
+ * Reporting library root provider function and feature functions.
  *
  * Configures the library, its tokens, and registers built-in primitives.
  */
-import { EnvironmentProviders, Type } from '@angular/core';
+import { EnvironmentProviders, Provider, Type } from '@angular/core';
 import { ReportingConfig } from './core/tokens/reporting-config.token';
 import { SessionContextProvider, SessionContextSource } from './core/tokens/session-context.token';
 import { ReportDataSourceAdapter } from './data-access/contracts/data-source.contract';
@@ -12,9 +12,60 @@ import { ReportPersistenceAdapter } from './data-access/contracts/report-persist
 import { ReportSchemaDiscoveryAdapter } from './data-access/contracts/schema-discovery.contract';
 import { ReportLookupAdapter } from './data-access/contracts/lookup.contract';
 /**
- * Configuration options for `provideReporting()`.
+ * Kinds of reporting features available in `provideBwaysReport`.
  */
-export interface ProvideReportingOptions extends Partial<ReportingConfig> {
+export declare enum ReportingFeatureKind {
+    HttpAdapters = 0,
+    LocalStorage = 1
+}
+/**
+ * Represents a feature that can be passed to `provideBwaysReport(...)`.
+ */
+export interface ReportingFeature<KindT extends ReportingFeatureKind = ReportingFeatureKind> {
+    ɵkind: KindT;
+    ɵproviders: Provider[];
+}
+/**
+ * Options for configuring built-in HTTP adapters via `withHttpAdapters(...)`.
+ */
+export interface HttpAdaptersOptions {
+    /**
+     * The base URL for the backend reporting REST API endpoints.
+     * @example 'http://localhost:3000/api/reporting'
+     */
+    apiBaseUrl: string;
+}
+/**
+ * Configures the built-in HTTP adapters for backend execution, persistence,
+ * schema discovery, lookup, and master data queries.
+ *
+ * @example
+ * ```typescript
+ * provideReporting(
+ *   { defaultPageSize: 50 },
+ *   withHttpAdapters({ apiBaseUrl: 'http://localhost:3000/api/reporting' })
+ * )
+ * ```
+ */
+export declare function withHttpAdapters(options: HttpAdaptersOptions): ReportingFeature<ReportingFeatureKind.HttpAdapters>;
+/**
+ * Zero-backend sandbox mode using browser LocalStorage for report definitions
+ * and mock realistic datasets for query execution.
+ *
+ * Ideal for local development, prototyping, and offline testing without spinning up backends.
+ *
+ * @example
+ * ```typescript
+ * provideReporting(withLocalStorage())
+ * ```
+ */
+export declare function withLocalStorage(): ReportingFeature<ReportingFeatureKind.LocalStorage>;
+/** Alias for withLocalStorage */
+export declare const withMockAdapters: typeof withLocalStorage;
+/**
+ * Configuration options for `provideBwaysReport()` (and `provideReporting()`).
+ */
+export interface ProvideBwaysReportOptions extends Partial<ReportingConfig> {
     /**
      * The Angular component to use for rendering report result grids.
      * BWays-grid is the recommended default. Host can provide any grid component.
@@ -31,45 +82,47 @@ export interface ProvideReportingOptions extends Partial<ReportingConfig> {
     masterDataProvider?: Type<MasterDataProvider>;
     /** Host's implementation of the persistence adapter. */
     persistenceAdapter?: Type<ReportPersistenceAdapter>;
-    /** Host's implementation of the schema discovery adapter (defaults to HttpReportSchemaDiscoveryAdapter). */
+    /** Host's implementation of the schema discovery adapter. */
     schemaDiscoveryAdapter?: Type<ReportSchemaDiscoveryAdapter>;
-    /** Host's implementation of the lookup adapter (defaults to HttpReportLookupAdapter). */
+    /** Host's implementation of the lookup adapter. */
     lookupAdapter?: Type<ReportLookupAdapter>;
+    /**
+     * Inline session context parameters or factory function:
+     * e.g. `session: () => ({ branchId: auth.branchId(), user: auth.user() })`
+     */
+    session?: SessionContextSource | (() => Record<string, unknown>);
     /**
      * Host application's session context parameters (e.g. { branchId: 1, companyId: 10, userId: 'usr-1' }).
-     * Can be a static object, an Angular Signal, an Observable, or a dynamic getter function.
-     * Stored procedures automatically bind matching parameters (like @BranchId, @CompanyId) to this context.
      */
     sessionContext?: SessionContextSource;
     /**
      * Host application service class implementing `SessionContextProvider`.
-     * Resolves session parameters dynamically at runtime (e.g. from user auth state, active branch switcher).
      */
     sessionContextProvider?: Type<SessionContextProvider>;
     /**
      * Factory function that returns a SessionContextSource with dependency injection context.
-     * E.g. `sessionContextFactory: () => inject(AuthService).currentSessionSignal`
      */
     sessionContextFactory?: () => SessionContextSource;
 }
+/** Backward compatibility and alternative naming aliases */
+export type ProvideReportingOptions = ProvideBwaysReportOptions;
+export type ProvideBwaysReportingOptions = ProvideBwaysReportOptions;
 /**
- * Provides the BWays-Report library to the application.
+ * 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())`
  *
  * @param options - Configuration and adapter implementations.
+ * @param features - Optional features like `withHttpAdapters(...)` or `withLocalStorage()`.
  * @returns Environment providers for the reporting library.
- *
- * @example
- * ```typescript
- * // app.config.ts
- * export const appConfig: ApplicationConfig = {
- *   providers: [
- *     provideReporting({
- *       apiBaseUrl: 'http://localhost:3000/api/reporting',
- *       gridComponent: BwaysGridComponent,
- *       defaultPageSize: 50,
- *     }),
- *   ],
- * };
- * ```
  */
-export declare function provideReporting(options?: ProvideReportingOptions): EnvironmentProviders;
+export declare function provideBwaysReport(options?: ProvideBwaysReportOptions, ...features: ReportingFeature[]): EnvironmentProviders;
+/** Alias for provideBwaysReport */
+export declare const provideBwaysReporting: typeof provideBwaysReport;
+/** Backward-compatible alias for provideBwaysReport */
+export declare const provideReporting: typeof provideBwaysReport;
+/** Semantic alias for BWays report providers */
+export declare const bwaysReportProviders: typeof provideBwaysReport;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bways-report",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Enterprise-grade, metadata-driven reporting engine and visual page builder for Angular 18+ ERP applications.",
   "keywords": [
     "angular",
@@ -30,6 +30,7 @@
   "dependencies": {
     "tslib": "^2.3.0"
   },
+  "schematics": "./schematics/collection.json",
   "sideEffects": false,
   "module": "fesm2022/bways-report.mjs",
   "typings": "index.d.ts",

package/schematics/collection.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../../../node_modules/@angular-devkit/schematics/collection-schema.json",
+  "schematics": {
+    "ng-add": {
+      "description": "Add bways-report reporting engine and designer to an Angular project",
+      "factory": "./ng-add/index#ngAdd",
+      "schema": "./ng-add/schema.json"
+    }
+  }
+}

package/schematics/ng-add/index.js

@@ -0,0 +1,45 @@
+function ngAdd(options) {
+  return (tree, context) => {
+    const configPath = 'src/app/app.config.ts';
+    const apiBase = (options && options.apiBaseUrl) ? options.apiBaseUrl : '/api';
+
+    if (tree.exists(configPath)) {
+      const buffer = tree.read(configPath);
+      if (buffer) {
+        let content = buffer.toString('utf-8');
+
+        // 1. Add import if not present
+        if (!content.includes('provideReporting')) {
+          content = "import { provideReporting } from 'bways-report';\n" + content;
+        }
+
+        // 2. Add provider into ApplicationConfig providers array
+        if (!content.includes('provideReporting(')) {
+          const providersIndex = content.indexOf('providers: [');
+          if (providersIndex !== -1) {
+            const insertPos = providersIndex + 'providers: ['.length;
+            content =
+              content.slice(0, insertPos) +
+              `\n    provideReporting({ apiBaseUrl: '${apiBase}' }),` +
+              content.slice(insertPos);
+            tree.overwrite(configPath, content);
+            context.logger.info(`✓ Added provideReporting({ apiBaseUrl: '${apiBase}' }) to app.config.ts`);
+          }
+        }
+      }
+    } else {
+      context.logger.warn(
+        `Could not find src/app/app.config.ts. Remember to add provideReporting({ apiBaseUrl: '${apiBase}' }) to your application providers.`
+      );
+    }
+
+    context.logger.info(
+      '🎉 bways-report configured successfully! You can now use <rpt-report [id]="\'reportId\'" /> or <rpt-report-designer [id]="\'reportId\'" /> in your Angular templates.'
+    );
+    return tree;
+  };
+}
+
+module.exports = {
+  ngAdd,
+};

package/schematics/ng-add/schema.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "BwaysReportNgAddSchema",
+  "title": "Bways Report ng-add Options",
+  "type": "object",
+  "properties": {
+    "project": {
+      "type": "string",
+      "description": "The name of the Angular project to configure."
+    },
+    "apiBaseUrl": {
+      "type": "string",
+      "description": "Backend API base URL for report endpoints",
+      "default": "/api"
+    }
+  }
+}