bways-report 0.1.2 → 0.1.4

package/lib/core/index.d.ts

@@ -5,3 +5,5 @@ export * from './errors';
 export * from './validation';
 export * from './services';
 export * from './utilities';
+export * from './utils/data-normalization.util';
+export * from './utils/report-parameter.util';

package/lib/core/models/report-datasource.model.d.ts

@@ -17,6 +17,15 @@ export interface ReportDataSourceDefinition {
     endpoint: string;
     /** HTTP method or execution method hint. */
     method?: 'GET' | 'POST' | 'STORED_PROCEDURE' | 'CUSTOM';
+    /** Database schema (defaults to 'dbo'). */
+    schema?: string;
+    /** Backend execution type. */
+    type?: 'stored_procedure' | 'table' | 'view' | 'sql' | string;
+    /**
+     * Stored procedure parameter mappings. Values may be fixed, or tokens:
+     * `{{session.branchId}}`, `{{context.today}}`, `{{fieldKey}}` (canvas field).
+     */
+    parameterMappings?: Record<string, string | number | boolean>;
     /**
      * Parameter keys that this data source requires.
      * These are resolved from the report's current parameter values

package/lib/core/models/report-definition.model.d.ts

@@ -77,6 +77,8 @@ export interface ReportDefinition {
     version: number;
     /** Category or group for organizing reports. */
     category?: string;
+    /** Whether the report is published (vs. draft). */
+    isPublished?: boolean;
     /** Page layout configuration. */
     layout: ReportLayoutDefinition;
     /** Components (controls, buttons, display elements) on this report page. */

package/lib/core/models/report-grid.model.d.ts

@@ -6,6 +6,36 @@
  * library's API. The `ReportGridBridgeComponent` translates this into
  * whatever the host's grid component (BWays-grid, AG Grid, etc.) expects.
  */
+/**
+ * Interactive action triggered when a row or cell in the result grid is clicked.
+ */
+export interface GridRowClickAction {
+    /**
+     * Action type:
+     * - 'drilldown-report': navigates to or opens a target sub-report
+     * - 'open-drawer': opens an in-page slide-over drawer running the target report
+     * - 'navigate': opens an external URL or application route
+     * - 'emit-custom': emits a custom event for the host application
+     */
+    type: 'drilldown-report' | 'open-drawer' | 'navigate' | 'emit-custom';
+    /** Target report ID to open/drill into (e.g. 'rep_customer_ledger'). */
+    targetReportId?: string;
+    /** External URL or route template if type === 'navigate'. Supports `{{row.field}}` replacements. */
+    targetUrl?: string;
+    /** Target browsing context: '_blank' | '_self' when navigating. */
+    openNewTab?: boolean;
+    /** Title for the slide-over drawer or dialog. Supports `{{row.field}}` replacements. */
+    drawerTitle?: string;
+    /** Width of the slide drawer (CSS value, e.g. '680px', '50vw'). Default: '720px'. */
+    drawerWidth?: string;
+    /**
+     * Maps parameter keys of the target sub-report to expressions:
+     * e.g. { "@CustCode": "row.customerId", "@BranchId": "session.branchId", "fromDate": "form.fromDate" }
+     */
+    parameterMapping?: Record<string, string>;
+    /** Custom event or action identifier when type === 'emit-custom'. */
+    customActionName?: string;
+}
 /**
  * Defines the result grid for a report.
  */
@@ -16,6 +46,8 @@ export interface ReportGridDefinition {
     columns: GridColumnDefinition[];
     /** Grid-level options. */
     options?: GridOptionsDefinition;
+    /** Declarative row-click action for master-detail drill-downs. */
+    rowClickAction?: GridRowClickAction;
 }
 /**
  * Defines a single column in the result grid.
@@ -45,6 +77,12 @@ export interface GridColumnDefinition {
     order?: number;
     /** Aggregate function to display in a footer row. */
     aggregate?: 'sum' | 'avg' | 'count' | 'min' | 'max' | 'none';
+    /** Whether to render a selection checkbox in this column's cells. */
+    checkboxSelection?: boolean;
+    /** Whether to render a select-all checkbox in this column's header. */
+    headerCheckboxSelection?: boolean;
+    /** Optional cell-specific click action (overrides grid-level rowClickAction for this column). */
+    action?: GridRowClickAction;
 }
 /**
  * Grid-level options.
@@ -56,8 +94,14 @@ export interface GridOptionsDefinition {
     pagination?: boolean;
     /** Whether row selection is enabled. */
     selectable?: boolean;
-    /** Selection mode when selectable is true. */
+    /** Selection mode when selectable is true. Defaults to 'multiple'. */
     selectionMode?: 'single' | 'multiple';
+    /** Selection mode alias (compatible with UltraGrid and AG Grid rowSelection). */
+    rowSelection?: 'single' | 'multiple';
+    /** Whether to render selection checkboxes on rows. Defaults to true when selectable is true. */
+    checkboxSelection?: boolean;
+    /** Whether to render a select-all checkbox in the header. Defaults to true when multi-row checkbox selection is active. */
+    headerCheckboxSelection?: boolean;
     /** Whether to show row numbers. */
     showRowNumbers?: boolean;
     /** Whether to allow column reordering. */
@@ -70,4 +114,26 @@ export interface GridOptionsDefinition {
     showFooter?: boolean;
     /** Height of the grid (CSS value). */
     height?: string;
+    /** Active column grouping fields in order (e.g. ['branch', 'customer']). */
+    groupModel?: string[];
+    /** Active sort model definitions. */
+    sortModel?: unknown[];
+    /** Complete serialized grid report state (filters, highlights, groups). */
+    reportState?: Record<string, unknown>;
+    /** View presets / saved custom grid views. */
+    presets?: unknown[];
+    /**
+     * Whether the grid side panel (tool panels for columns, filters, highlights, export, analytics, AI chat) is enabled.
+     * Standard BWays-grid / UltraGrid feature. Defaults to `true`.
+     */
+    sideBar?: boolean | {
+        visible?: boolean;
+        panel?: ('columns' | 'filters' | 'highlights' | 'export' | 'analytics' | 'chat')[];
+    };
+    /** Whether the real-time global search bar is enabled. Defaults to `true`. */
+    globalSearch?: boolean;
+    /** Whether the bottom status bar is enabled. Defaults to `true`. */
+    statusBar?: boolean;
+    /** Declarative row-click action for master-detail drill-downs. */
+    rowClickAction?: GridRowClickAction;
 }

package/lib/core/services/report-session-context.service.d.ts

@@ -64,10 +64,15 @@ export declare class ReportSessionContextService implements OnDestroy {
      * Always pulls the latest runtime state. Never throws or crashes the thread.
      */
     getCurrentSessionContext(): SessionContextMap;
+    /**
+     * Safely detects session parameters from host project browser storage
+     * (sessionStorage: user_Info, currentUser; localStorage: currentUser, CompanyData, user_Info).
+     */
+    private detectBrowserSession;
     /**
      * Normalizes a parameter or session key into a lowercase alphanumeric string
      * for reliable, case-insensitive, and symbol-insensitive matching.
-     * E.g. '@BranchId' -> 'branchid', 'branch_id' -> 'branchid', 'BranchID' -> 'branchid'
+     * Strips SQL Server Hungarian type prefixes (e.g. '@chrCompanyId' -> 'companyid').
      */
     normalizeKey(key: string): string;
     /**

package/lib/core/utils/data-normalization.util.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Utility to normalize arbitrary backend HTTP responses into standard array of records.
+ *
+ * Supports:
+ * - Direct array payloads: `[ { ... }, { ... } ]`
+ * - Standard envelope wrappers: `{ data: [...] }`, `{ rows: [...] }`, `{ result: [...] }`, `{ items: [...] }`
+ * - OData envelopes: `{ value: [...] }`
+ * - Paginated wrappers: `{ total: 100, page: 1, data: [...] }`
+ */
+export declare function extractRowArray<T = unknown>(response: unknown): T[];
+/**
+ * Case-insensitive lookup in an object/record.
+ * Searches for exact match first, then lower-cased match, then normalized (ignoring underscores/dashes).
+ */
+export declare function getFieldCaseInsensitive(record: Record<string, unknown> | null | undefined, targetKey: string): unknown;

package/lib/core/utils/report-parameter.util.d.ts

@@ -0,0 +1,35 @@
+import { ReportDefinition } from '../models/report-definition.model';
+import { ReportDataSourceDefinition } from '../models/report-datasource.model';
+export type ParameterMappings = Record<string, string | number | boolean>;
+/** Resolves `{{context.xxx}}` presets such as today / startOfMonth. */
+export declare function resolveContextPreset(key: string): string;
+/**
+ * Looks up a field value from formValues supporting direct names, dot paths (a.b),
+ * and compound date ranges (e.g. dateRange.from, dateRange_from, dateRangeFrom).
+ */
+export declare function resolveCanvasFieldValue(formValues: Record<string, unknown>, inner: string): unknown;
+/**
+ * Resolves one raw mapping value against session + canvas form values.
+ * - `{{session.branchId}}`  -> session value (case-insensitive)
+ * - `{{context.today}}`     -> computed date
+ * - `{{fromDate}}`          -> value of canvas field with key `fromDate` (case-insensitive)
+ * - `{{dateRange.from}}`    -> value of nested from property
+ * - anything else           -> returned unchanged (fixed value)
+ */
+export declare function resolveParameterValue(raw: unknown, session: Record<string, unknown>, formValues: Record<string, unknown>): unknown;
+/** Resolves every mapping into concrete values (de-duplicating `@name` / `name`). */
+export declare function resolveParameterMappings(mappings: ParameterMappings | undefined, session: Record<string, unknown>, formValues: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Returns canvas field keys referenced by mappings that currently have no value.
+ * Session / context / fixed values never block execution.
+ */
+export declare function findMissingCanvasFields(mappings: ParameterMappings | undefined, formValues: Record<string, unknown>): string[];
+/**
+ * Picks the data source the result grid should run:
+ * 1. the one referenced by `grid.dataSourceId`
+ * 2. otherwise the first declared data source
+ * 3. otherwise a procedure/table bound to a component (legacy reports)
+ */
+export declare function resolveExecutionDataSource(def: ReportDefinition): ReportDataSourceDefinition | null;
+/** Strips SQL Server Hungarian prefixes: `@chrFromDate` -> `fromDate`. */
+export declare function toFieldKey(paramName: string): string;

package/lib/data-access/adapters/http-datasource.adapter.d.ts

@@ -0,0 +1,20 @@
+import { Observable } from 'rxjs';
+import { ReportDataSourceAdapter } from '../contracts/data-source.contract';
+import { ReportDataSourceDefinition } from '../../core/models/report-datasource.model';
+import * as i0 from "@angular/core";
+/**
+ * Built-in HTTP adapter for executing report data sources against the reporting backend.
+ * Automatically injects active multi-tenant session headers (X-Company-Id, X-Branch-Id)
+ * and includes rich development fallback data when the backend is unreachable.
+ */
+export declare class HttpReportDataSourceAdapter extends ReportDataSourceAdapter {
+    private readonly http;
+    private readonly config;
+    private readonly sessionService;
+    execute(dataSource: ReportDataSourceDefinition, parameters: Record<string, unknown>): Observable<unknown[]>;
+    private getMockExecutionData;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HttpReportDataSourceAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<HttpReportDataSourceAdapter>;
+}
+/** Convenience alias */
+export declare const HttpDataSourceAdapter: typeof HttpReportDataSourceAdapter;

package/lib/data-access/adapters/http-lookup.adapter.d.ts

@@ -8,6 +8,7 @@ import * as i0 from "@angular/core";
 export declare class HttpReportLookupAdapter extends ReportLookupAdapter {
     private readonly http;
     private readonly config;
+    private readonly sessionService;
     private readonly cache;
     private readonly mockDataStore;
     fetchOptions(request: LookupQueryRequest): Observable<LookupOptionItem[]>;
@@ -17,3 +18,5 @@ export declare class HttpReportLookupAdapter extends ReportLookupAdapter {
     static ɵfac: i0.ɵɵFactoryDeclaration<HttpReportLookupAdapter, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<HttpReportLookupAdapter>;
 }
+/** Convenience alias */
+export declare const HttpLookupAdapter: typeof HttpReportLookupAdapter;

package/lib/data-access/adapters/http-masterdata.adapter.d.ts

@@ -0,0 +1,13 @@
+import { Observable } from 'rxjs';
+import { MasterDataItem, MasterDataOptions, MasterDataProvider } from '../contracts/master-data.provider';
+import * as i0 from "@angular/core";
+/**
+ * Built-in HTTP adapter for legacy master data queries.
+ * Integrates directly with the reporting backend lookup service.
+ */
+export declare class HttpMasterDataAdapter extends MasterDataProvider {
+    private readonly lookupAdapter;
+    getMasterData(masterName: string, options?: MasterDataOptions): Observable<MasterDataItem[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HttpMasterDataAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<HttpMasterDataAdapter>;
+}

package/lib/data-access/adapters/http-persistence.adapter.d.ts

@@ -0,0 +1,27 @@
+import { Observable } from 'rxjs';
+import { ReportDefinition, ReportSummary } from '../../core/models/report-definition.model';
+import { ReportPersistenceAdapter } from '../contracts/report-persistence.contract';
+import * as i0 from "@angular/core";
+/**
+ * Built-in HTTP adapter for report definitions persistence.
+ * Connects to NestJS `/api/reporting/reports` endpoints.
+ * Includes in-memory mock fallback when the remote backend is unreachable.
+ */
+export declare class HttpReportPersistenceAdapter extends ReportPersistenceAdapter {
+    private readonly http;
+    private readonly config;
+    private readonly mockStore;
+    constructor();
+    load(reportId: string): Observable<ReportDefinition>;
+    save(report: ReportDefinition): Observable<ReportDefinition>;
+    list(): Observable<ReportSummary[]>;
+    delete(reportId: string): Observable<void>;
+    publish(reportId: string, version: number): Observable<void>;
+    private getMockReport;
+    private getMockSummaries;
+    private seedDefaultMockReports;
+    static ɵfac: i0.ɵɵFactoryDeclaration<HttpReportPersistenceAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<HttpReportPersistenceAdapter>;
+}
+/** Convenience alias */
+export declare const HttpPersistenceAdapter: typeof HttpReportPersistenceAdapter;

package/lib/data-access/adapters/http-schema-discovery.adapter.d.ts

@@ -18,3 +18,5 @@ export declare class HttpReportSchemaDiscoveryAdapter extends ReportSchemaDiscov
     static ɵfac: i0.ɵɵFactoryDeclaration<HttpReportSchemaDiscoveryAdapter, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<HttpReportSchemaDiscoveryAdapter>;
 }
+/** Convenience alias */
+export declare const HttpSchemaDiscoveryAdapter: typeof HttpReportSchemaDiscoveryAdapter;

package/lib/data-access/adapters/index.d.ts

@@ -1,2 +1,7 @@
-export { HttpReportSchemaDiscoveryAdapter } from './http-schema-discovery.adapter';
-export { HttpReportLookupAdapter } from './http-lookup.adapter';
+export { HttpReportSchemaDiscoveryAdapter, HttpSchemaDiscoveryAdapter, } from './http-schema-discovery.adapter';
+export { HttpReportLookupAdapter, HttpLookupAdapter, } from './http-lookup.adapter';
+export { HttpReportDataSourceAdapter, HttpDataSourceAdapter, } from './http-datasource.adapter';
+export { HttpReportPersistenceAdapter, HttpPersistenceAdapter, } from './http-persistence.adapter';
+export { HttpMasterDataAdapter, } from './http-masterdata.adapter';
+export { LocalStorageReportPersistenceAdapter, } from './local-storage-persistence.adapter';
+export { MockReportDataSourceAdapter, } from './mock-datasource.adapter';

package/lib/data-access/adapters/local-storage-persistence.adapter.d.ts

@@ -0,0 +1,19 @@
+import { Observable } from 'rxjs';
+import { ReportPersistenceAdapter } from '../contracts/report-persistence.contract';
+import { ReportDefinition, ReportSummary } from '../../core/models/report-definition.model';
+import * as i0 from "@angular/core";
+export declare class LocalStorageReportPersistenceAdapter extends ReportPersistenceAdapter {
+    private readonly templateService;
+    constructor();
+    private seedDefaultBlueprintsIfEmpty;
+    private getIndex;
+    private saveIndex;
+    private saveDirect;
+    load(reportId: string): Observable<ReportDefinition>;
+    save(report: ReportDefinition): Observable<ReportDefinition>;
+    list(): Observable<ReportSummary[]>;
+    delete(reportId: string): Observable<void>;
+    publish(reportId: string, version: number): Observable<void>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LocalStorageReportPersistenceAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<LocalStorageReportPersistenceAdapter>;
+}

package/lib/data-access/adapters/mock-datasource.adapter.d.ts

@@ -0,0 +1,9 @@
+import { Observable } from 'rxjs';
+import { ReportDataSourceAdapter } from '../contracts/data-source.contract';
+import { ReportDataSourceDefinition } from '../../core/models/report-datasource.model';
+import * as i0 from "@angular/core";
+export declare class MockReportDataSourceAdapter extends ReportDataSourceAdapter {
+    execute(dataSource: ReportDataSourceDefinition, parameters: Record<string, unknown>): Observable<unknown[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MockReportDataSourceAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<MockReportDataSourceAdapter>;
+}

package/lib/data-access/contracts/api-dtos.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Shared API Contract DTOs for BWays Reporting.
+ * These types match the REST contract implemented by the backend and used by HTTP adapters.
+ */
+import { ReportDataSourceDefinition } from '../../core/models/report-datasource.model';
+import { ReportDefinition, ReportSummary } from '../../core/models/report-definition.model';
+export interface ExecuteReportRequest {
+    /** The data source configuration to execute */
+    dataSource: ReportDataSourceDefinition;
+    /** Filter/parameter values provided by the runtime form or user */
+    parameters: Record<string, unknown>;
+    /** Optional session context values (e.g. branchId, companyId, userId) */
+    sessionContext?: Record<string, unknown>;
+}
+export type ReportSummaryDto = ReportSummary;
+export interface SaveReportRequestDto {
+    id: string;
+    name: string;
+    description?: string;
+    category?: string;
+    version: number;
+    isPublished?: boolean;
+    definition: ReportDefinition;
+}
+export interface LookupQueryRequestDto {
+    sourceType: 'table' | 'view' | 'stored_procedure';
+    entityName: string;
+    valueField: string;
+    displayField: string;
+    filter?: Record<string, unknown>;
+    parameters?: Record<string, unknown>;
+}
+export interface LookupOptionResponseDto {
+    value: string | number;
+    label: string;
+    raw?: Record<string, unknown>;
+}
+export interface SchemaEntityDto {
+    name: string;
+    schema: string;
+    type: 'table' | 'view' | 'stored_procedure';
+    friendlyName?: string;
+    category?: string;
+    description?: string;
+}
+export interface SchemaColumnDto {
+    field: string;
+    label: string;
+    dataType: 'string' | 'number' | 'date' | 'boolean';
+    nullable: boolean;
+    sqlType?: string;
+}
+export interface SchemaProcedureParamDto {
+    name: string;
+    friendlyLabel?: string;
+    dataType: 'string' | 'number' | 'date' | 'boolean';
+    sqlType?: string;
+    required?: boolean;
+    defaultValue?: unknown;
+    description?: string;
+}
+export interface CompanySummaryDto {
+    id: string | number;
+    name: string;
+    uniqueName?: string;
+    isDefault?: boolean;
+}

package/lib/data-access/contracts/index.d.ts

@@ -7,3 +7,4 @@ export { ReportSchemaDiscoveryAdapter } from './schema-discovery.contract';
 export type { DatabaseEntityType, DatabaseEntityMetadata, EntityColumnMetadata, ProcedureParameterMetadata, } from './schema-discovery.contract';
 export { ReportLookupAdapter } from './lookup.contract';
 export type { LookupQueryRequest, LookupOptionItem } from './lookup.contract';
+export * from './api-dtos';

package/lib/features/designer/components/component-palette/component-palette.component.d.ts

@@ -3,6 +3,7 @@ import * as i0 from "@angular/core";
 export declare class ComponentPaletteComponent {
     private readonly registry;
     private readonly designerState;
+    readonly collapseRequested: import("@angular/core").OutputEmitterRef<void>;
     readonly searchQuery: import("@angular/core").WritableSignal<string>;
     /** Layout view mode: 'grid' (2-column side-by-side grid) or 'list' (compact row list). Defaults to 'grid'. */
     readonly layoutMode: import("@angular/core").WritableSignal<"grid" | "list">;
@@ -27,7 +28,7 @@ export declare class ComponentPaletteComponent {
     onItemDoubleClick(type: string): void;
     onAddClick(event: MouseEvent, type: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ComponentPaletteComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ComponentPaletteComponent, "rpt-component-palette", never, {}, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ComponentPaletteComponent, "rpt-component-palette", never, {}, { "collapseRequested": "collapseRequested"; }, never, never, true, never>;
 }
 /** Dictionary of synonyms for component types and UI concepts */
 export declare const COMPONENT_SYNONYMS: Record<string, string[]>;

package/lib/features/designer/components/design-canvas/design-canvas.component.d.ts

@@ -1,12 +1,28 @@
+import { FormControl, FormGroup } from '@angular/forms';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import { ReportComponentDefinition } from '../../../../core/models/report-component.model';
 import { getComponentIconName } from '../../utilities/canvas-layout.util';
 import * as i0 from "@angular/core";
 export declare class DesignCanvasComponent {
     private readonly designerState;
+    private readonly templateService;
+    private readonly formBuilder;
+    private readonly executionService;
     readonly definition: import("@angular/core").WritableSignal<import("bways-report").ReportDefinition>;
     readonly components: import("@angular/core").Signal<ReportComponentDefinition[]>;
     readonly selectedId: import("@angular/core").WritableSignal<string | null>;
+    private readonly _stableCanvasForm;
+    readonly canvasForm: import("@angular/core").Signal<FormGroup<any>>;
+    getCanvasControl(comp: ReportComponentDefinition): FormControl | null;
+    readonly highlightedFieldKeys: import("@angular/core").WritableSignal<Set<string>>;
+    readonly layoutJustUpdated: import("@angular/core").WritableSignal<boolean>;
+    isFieldHighlighted(comp: ReportComponentDefinition): boolean;
+    onControlInteract(comp: ReportComponentDefinition, event: Event): void;
+    getGridSummaryText(): string;
+    highlightMissingFields(fields: string[]): void;
+    readonly canvasGridData: import("@angular/core").WritableSignal<unknown[]>;
+    readonly isExecutingGrid: import("@angular/core").WritableSignal<boolean>;
+    readonly gridExecError: import("@angular/core").WritableSignal<string | null>;
     readonly totalColumns: import("@angular/core").Signal<number>;
     readonly gridTemplateColumns: import("@angular/core").Signal<string>;
     readonly sortedComponents: import("@angular/core").Signal<ReportComponentDefinition[]>;
@@ -38,7 +54,13 @@ export declare class DesignCanvasComponent {
     resetDimensions(comp: ReportComponentDefinition, event?: MouseEvent): void;
     onDrop(event: CdkDragDrop<ReportComponentDefinition[], unknown, unknown>): void;
     addResultGrid(event?: MouseEvent): void;
+    executeCanvasReport(event?: MouseEvent): void;
+    onCanvasButtonClick(comp: ReportComponentDefinition, event: MouseEvent): void;
+    onCanvasGridStateChange(state: any): void;
+    onCanvasColumnDefsChange(defs: any[]): void;
     removeGrid(event?: MouseEvent): void;
+    applyBlueprint(blueprintId: string): void;
+    addStarterComponent(type: string): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<DesignCanvasComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DesignCanvasComponent, "rpt-design-canvas", never, {}, {}, never, never, true, never>;
 }

package/lib/features/designer/components/property-editor/parameter-binding-editor.component.d.ts

@@ -18,7 +18,7 @@ export declare class ParameterBindingEditorComponent {
     readonly internalMode: import("@angular/core").WritableSignal<ParameterBindingMode | null>;
     readonly sessionMatch: import("@angular/core").Signal<import("../../../../core/services/report-session-context.service").SessionParamMatch | null>;
     readonly friendlyLabel: import("@angular/core").Signal<string>;
-    readonly displayType: import("@angular/core").Signal<"Text" | "Date" | "Number" | "Yes / No">;
+    readonly displayType: import("@angular/core").Signal<"Date" | "Text" | "Number" | "Yes / No">;
     readonly compatibleControls: import("@angular/core").Signal<ReportComponentDefinition[]>;
     readonly hasValue: import("@angular/core").Signal<boolean>;
     readonly activeMode: import("@angular/core").Signal<ParameterBindingMode>;

package/lib/features/designer/components/property-editor/property-editor-action.component.d.ts

@@ -0,0 +1,33 @@
+import { ReportComponentDefinition } from '../../../../core/models/report-component.model';
+import * as i0 from "@angular/core";
+export interface ActionTypeOption {
+    key: string;
+    label: string;
+    icon: string;
+    description: string;
+}
+/**
+ * Dedicated property editor for configuring Action Button click behavior.
+ * Empowers non-developers to configure actions such as Running Reports, Resetting Filters,
+ * Exporting to Excel/PDF, Crystal Report Printing, and Navigation.
+ */
+export declare class PropertyEditorActionComponent {
+    private readonly designerState;
+    private readonly discoveryAdapter;
+    readonly comp: import("@angular/core").InputSignal<ReportComponentDefinition>;
+    readonly updateProperty: import("@angular/core").OutputEmitterRef<{
+        key: string;
+        value: unknown;
+    }>;
+    readonly actionOptions: ActionTypeOption[];
+    readonly currentActionType: import("@angular/core").Signal<string>;
+    readonly currentActionDescription: import("@angular/core").Signal<string>;
+    readonly hasGridOnCanvas: import("@angular/core").Signal<boolean>;
+    getActionParam<T>(paramKey: string, defaultValue: T): T;
+    onActionTypeChange(newType: string): void;
+    setActionParam(paramKey: string, value: unknown): void;
+    ensureResultGridForReport(): void;
+    private fallbackGridCreation;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PropertyEditorActionComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PropertyEditorActionComponent, "rpt-property-editor-action", never, { "comp": { "alias": "comp"; "required": true; "isSignal": true; }; }, { "updateProperty": "updateProperty"; }, never, never, true, never>;
+}

package/lib/features/designer/components/property-editor/property-editor-datasource.component.d.ts

@@ -8,6 +8,8 @@ export interface StaticOptionItem {
 }
 export declare class PropertyEditorDatasourceComponent implements OnInit {
     private readonly discoveryAdapter;
+    private readonly sessionService;
+    private readonly designerState;
     readonly comp: import("@angular/core").InputSignal<ReportComponentDefinition>;
     readonly allComponents: import("@angular/core").InputSignal<ReportComponentDefinition[]>;
     readonly updateDataSource: import("@angular/core").OutputEmitterRef<ComponentDataSourceDefinition>;
@@ -16,6 +18,7 @@ export declare class PropertyEditorDatasourceComponent implements OnInit {
         value: unknown;
     }>;
     readonly isAdvancedMode: import("@angular/core").WritableSignal<boolean>;
+    readonly isLoadingEntities: import("@angular/core").WritableSignal<boolean>;
     readonly allEntities: import("@angular/core").WritableSignal<DatabaseEntityMetadata[]>;
     readonly entityColumns: import("@angular/core").WritableSignal<EntityColumnMetadata[]>;
     readonly procedureParameters: import("@angular/core").WritableSignal<ProcedureParameterMetadata[]>;
@@ -48,6 +51,16 @@ export declare class PropertyEditorDatasourceComponent implements OnInit {
     ngOnInit(): void;
     loadEntities(): void;
     loadEntityDetails(entityName: string, type: DropdownSourceType): void;
+    /**
+     * Non-destructive linking: binds parameters to session or already-existing canvas fields.
+     * Never mutates or adds new components to the canvas.
+     */
+    autoLinkExistingParameters(paramsList?: ProcedureParameterMetadata[]): void;
+    /**
+     * Explicit user-initiated action: links existing fields, and creates missing filter inputs on canvas.
+     * Restores selection to the current dropdown component so the user stays in this property editor.
+     */
+    autoWireAllParameters(paramsList?: ProcedureParameterMetadata[]): void;
     setSourceType(type: DropdownSourceType): void;
     onEntitySelected(entityName: string): void;
     onValueFieldChanged(valueField: string): void;

package/lib/features/designer/components/property-editor/property-editor-grid.component.d.ts

@@ -1,10 +1,11 @@
-import { GridColumnDefinition, ReportGridDefinition } from '../../../../core/models/report-grid.model';
+import { GridColumnDefinition, GridRowClickAction, ReportGridDefinition } from '../../../../core/models/report-grid.model';
 import * as i0 from "@angular/core";
 export declare class PropertyEditorGridComponent {
     readonly grid: import("@angular/core").InputSignal<ReportGridDefinition | undefined>;
     readonly addGrid: import("@angular/core").OutputEmitterRef<void>;
     readonly removeGrid: import("@angular/core").OutputEmitterRef<void>;
     readonly addColumn: import("@angular/core").OutputEmitterRef<void>;
+    readonly autoDetectColumns: import("@angular/core").OutputEmitterRef<void>;
     readonly removeColumn: import("@angular/core").OutputEmitterRef<number>;
     readonly updateColumn: import("@angular/core").OutputEmitterRef<{
         index: number;
@@ -15,8 +16,21 @@ export declare class PropertyEditorGridComponent {
         field: string;
         value: unknown;
     }>;
+    readonly updateRowClickAction: import("@angular/core").OutputEmitterRef<GridRowClickAction | undefined>;
     readonly columns: import("@angular/core").Signal<GridColumnDefinition[]>;
+    readonly rowClickAction: import("@angular/core").Signal<GridRowClickAction | undefined>;
+    readonly hasRowClickAction: import("@angular/core").Signal<boolean>;
+    readonly parameterMappings: import("@angular/core").Signal<{
+        key: string;
+        value: string;
+    }[]>;
     onUpdateCol(index: number, field: string, value: unknown): void;
+    toggleRowClickAction(enabled: boolean): void;
+    updateRowActionField(field: keyof GridRowClickAction, value: unknown): void;
+    addParameterMapping(): void;
+    updateMappingKey(index: number, newKey: string): void;
+    updateMappingValue(index: number, newValue: string): void;
+    removeMapping(index: number): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<PropertyEditorGridComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PropertyEditorGridComponent, "rpt-property-editor-grid", never, { "grid": { "alias": "grid"; "required": false; "isSignal": true; }; }, { "addGrid": "addGrid"; "removeGrid": "removeGrid"; "addColumn": "addColumn"; "removeColumn": "removeColumn"; "updateColumn": "updateColumn"; "updateOption": "updateOption"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PropertyEditorGridComponent, "rpt-property-editor-grid", never, { "grid": { "alias": "grid"; "required": false; "isSignal": true; }; }, { "addGrid": "addGrid"; "removeGrid": "removeGrid"; "addColumn": "addColumn"; "autoDetectColumns": "autoDetectColumns"; "removeColumn": "removeColumn"; "updateColumn": "updateColumn"; "updateOption": "updateOption"; "updateRowClickAction": "updateRowClickAction"; }, never, never, true, never>;
 }

package/lib/features/designer/components/property-editor/property-editor.component.d.ts

@@ -1,6 +1,7 @@
 import { DesignerActiveTab } from '../../services/designer-state.service';
 import { PropertyDefinition } from '../../../../core/registry/property-definition.model';
 import { ComponentLayoutDefinition } from '../../../../core/models/report-layout.model';
+import { GridRowClickAction } from '../../../../core/models/report-grid.model';
 import { ComponentDataSourceDefinition, ReportComponentDefinition } from '../../../../core/models/report-component.model';
 import * as i0 from "@angular/core";
 /**
@@ -12,15 +13,19 @@ import * as i0 from "@angular/core";
 export declare class PropertyEditorComponent {
     private readonly designerState;
     private readonly registry;
+    private readonly discoveryAdapter;
     readonly definition: import("@angular/core").WritableSignal<import("bways-report").ReportDefinition>;
     readonly activeTab: import("@angular/core").WritableSignal<DesignerActiveTab>;
     readonly selectedComponent: import("@angular/core").Signal<ReportComponentDefinition | null>;
+    readonly collapseRequested: import("@angular/core").OutputEmitterRef<void>;
     readonly maxColumns: import("@angular/core").Signal<number>;
     readonly allComponents: import("@angular/core").Signal<ReportComponentDefinition[]>;
     readonly propertySchema: import("@angular/core").Signal<PropertyDefinition[]>;
     setTab(tab: DesignerActiveTab): void;
     updateCompDataSource(id: string, dataSource: ComponentDataSourceDefinition): void;
     deselect(): void;
+    duplicateComponent(id: string): void;
+    deleteComponent(id: string): void;
     updateComp(field: string, value: unknown): void;
     updateProp(id: string, key: string, value: unknown): void;
     updateLayout(key: keyof ComponentLayoutDefinition, value: unknown): void;
@@ -35,12 +40,15 @@ export declare class PropertyEditorComponent {
     removeColumn(index: number): void;
     updateColumn(index: number, field: string, value: unknown): void;
     updateGridOption(field: string, value: unknown): void;
+    updateGridRowClickAction(action: GridRowClickAction | undefined): void;
+    autoDetectGridColumns(): void;
     readonly expandedSections: import("@angular/core").WritableSignal<Record<string, boolean>>;
     toggleSection(section: string): void;
     isSectionExpanded(section: string): boolean;
+    getActionBadge(comp: ReportComponentDefinition): string;
     getDatasourceBadge(comp: ReportComponentDefinition): string;
     getLayoutBadge(comp: ReportComponentDefinition): string;
     getValidationBadge(comp: ReportComponentDefinition): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<PropertyEditorComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<PropertyEditorComponent, "rpt-property-editor", never, {}, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PropertyEditorComponent, "rpt-property-editor", never, {}, { "collapseRequested": "collapseRequested"; }, never, never, true, never>;
 }