bways-report 0.1.7 → 0.1.9

package/lib/core/config/bways-report-config.d.ts

@@ -8,6 +8,7 @@
  */
 import { Type } from '@angular/core';
 import { SessionContextProvider, SessionContextSource } from '../tokens/session-context.token';
+import { ReportApiEndpointDefinition } from '../models/report-api-endpoint.model';
 /**
  * Palette component category names the developer can use
  * when restricting the designer component palette.
@@ -72,6 +73,16 @@ export interface BwaysReportConfig {
      * - DELETE /:id → delete a report
      */
     reportsEndpoint?: string;
+    /**
+     * Optional GET endpoint returning the catalog of registered REST APIs.
+     * Response: ReportApiEndpointDefinition[]
+     */
+    apisEndpoint?: string;
+    /**
+     * Optional static/in-memory API endpoints registered directly in the host application.
+     * Merged with backend-discovered APIs in the Visual Designer.
+     */
+    apiEndpoints?: ReportApiEndpointDefinition[];
     /**
      * Component palette groups to show in the designer.
      * Defaults to all groups when not specified.
@@ -136,6 +147,8 @@ export interface NormalizedBwaysConfig {
     executeEndpoint: string;
     lookupEndpoint: string | null;
     reportsEndpoint: string | null;
+    apisEndpoint: string | null;
+    apiEndpoints: ReportApiEndpointDefinition[];
     /** Resolved internal category IDs (e.g. ['input', 'action', 'display']) */
     allowedCategories: string[] | null;
     /** Whether auto-parameter binding is enabled */

package/lib/core/models/index.d.ts

@@ -2,7 +2,8 @@
  * Barrel export for all core domain models.
  */
 export type { ReportDefinition, ReportSummary, ReportPermissionDefinition, } from './report-definition.model';
-export type { ReportComponentDefinition, ComponentBindingDefinition, ComponentDataSourceDefinition, VisibilityDefinition, } from './report-component.model';
+export type { ReportComponentDefinition, ComponentBindingDefinition, ComponentDataSourceDefinition, DropdownSourceType, VisibilityDefinition, } from './report-component.model';
+export type { ReportApiEndpointDefinition, ReportApiParameterDefinition, } from './report-api-endpoint.model';
 export type { ReportParameterDefinition, } from './report-parameter.model';
 export type { ReportDataSourceDefinition, DataSourceCacheDefinition, } from './report-datasource.model';
 export type { ReportGridDefinition, GridColumnDefinition, GridOptionsDefinition, } from './report-grid.model';

package/lib/core/models/report-api-endpoint.model.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Definitions for API-based data retrieval endpoints.
+ *
+ * Enables reports and form components to consume REST / HTTP APIs
+ * with parameter interpolation, custom headers, and data path resolution.
+ */
+export interface ReportApiParameterDefinition {
+    name: string;
+    label?: string;
+    type: 'string' | 'number' | 'boolean' | 'date' | 'array';
+    in: 'query' | 'path' | 'body' | 'header';
+    required?: boolean;
+    defaultValue?: unknown;
+    description?: string;
+}
+export interface ReportApiEndpointDefinition {
+    id: string;
+    name: string;
+    url?: string;
+    endpoint?: string;
+    method?: 'GET' | 'POST' | 'PUT';
+    description?: string;
+    category?: string;
+    dataPath?: string;
+    totalPath?: string;
+    parameters?: ReportApiParameterDefinition[];
+    headers?: Record<string, string>;
+    responseSample?: Record<string, unknown>[];
+    useProxy?: boolean;
+}

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

@@ -20,13 +20,13 @@ export interface ComponentBindingDefinition {
     /** The parameter key this component writes to (for input components). */
     parameterKey?: string;
 }
-export type DropdownSourceType = 'static' | 'table' | 'procedure' | 'master';
+export type DropdownSourceType = 'static' | 'table' | 'procedure' | 'master' | 'api';
 /**
  * Data source configuration for components that load their own data
- * (e.g., dropdowns loading options from database tables, stored procedures, or master data).
+ * (e.g., dropdowns loading options from database tables, stored procedures, master data, or REST APIs).
  */
 export interface ComponentDataSourceDefinition {
-    /** Source type: 'static' | 'table' | 'procedure' | 'master' */
+    /** Source type: 'static' | 'table' | 'procedure' | 'master' | 'api' */
     sourceType?: DropdownSourceType;
     /** Database schema, e.g. 'dbo' (defaults to 'dbo'). */
     schema?: string;
@@ -40,12 +40,24 @@ export interface ComponentDataSourceDefinition {
     valueField?: string;
     /** Optional static filter parameters (e.g. { isActive: 1 }). */
     filter?: Record<string, unknown>;
-    /** Stored procedure parameter mappings (e.g. { '@BranchId': '{{branchSelect}}', '@ActiveOnly': true }). */
+    /** Parameter mappings (e.g. { '@BranchId': '{{branchSelect}}', '@ActiveOnly': true }). */
     parameterMappings?: Record<string, string | number | boolean>;
     /** Keys of other form components whose values this data source depends on (for Cascading Dropdowns). */
     dependsOn?: string[];
     /** Cache time-to-live in seconds (default 300s). */
     cacheTtl?: number;
+    /** Registered API endpoint ID or raw URL path (e.g. 'api-customers' or '/api/v1/customers') */
+    apiEndpoint?: string;
+    /** HTTP method to use (defaults to 'GET') */
+    apiMethod?: 'GET' | 'POST';
+    /** Dot-notation path to the array of items in the response JSON (e.g. 'data.items' or 'rows') */
+    dataPath?: string;
+    /** Custom query parameters or payload mappings for the API request */
+    apiParams?: Record<string, unknown>;
+    /** Optional custom headers (e.g. { 'X-Custom-Tenant': '{{session.tenantId}}' }) */
+    apiHeaders?: Record<string, string>;
+    /** Whether request should be proxied via backend reporting gateway */
+    useProxy?: boolean;
 }
 /**
  * Controls when a component is visible based on other component values.

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

@@ -20,9 +20,9 @@ export interface ReportDataSourceDefinition {
     /** Database schema (defaults to 'dbo'). */
     schema?: string;
     /** Backend execution type. */
-    type?: 'stored_procedure' | 'table' | 'view' | 'sql' | string;
+    type?: 'stored_procedure' | 'table' | 'view' | 'sql' | 'api' | string;
     /**
-     * Stored procedure parameter mappings. Values may be fixed, or tokens:
+     * Parameter mappings. Values may be fixed, or tokens:
      * `{{session.branchId}}`, `{{context.today}}`, `{{fieldKey}}` (canvas field).
      */
     parameterMappings?: Record<string, string | number | boolean>;
@@ -36,6 +36,20 @@ export interface ReportDataSourceDefinition {
     autoExecute?: boolean;
     /** Caching strategy. */
     cache?: DataSourceCacheDefinition;
+    /** Base URL override (if calling an external service outside apiBaseUrl) */
+    baseUrl?: string;
+    /** Dot-notation path to the array of records in the response (e.g. 'data.items' or 'rows') */
+    dataPath?: string;
+    /** Dot-notation path to total count for server-side pagination (e.g. 'result.total') */
+    totalPath?: string;
+    /** Parameter placement: 'query' | 'body' | 'auto' */
+    paramPlacement?: 'query' | 'body' | 'auto';
+    /** Request body template for POST requests */
+    bodyTemplate?: Record<string, unknown>;
+    /** Custom HTTP headers to include with the API request */
+    headers?: Record<string, string>;
+    /** Whether to route through the backend proxy gateway */
+    useProxy?: boolean;
 }
 /**
  * Caching configuration for a data source.

package/lib/core/services/index.d.ts

@@ -3,3 +3,4 @@ export { ReportSessionContextService } from './report-session-context.service';
 export type { SessionParamMatch, DerivedParametersResult, } from './report-session-context.service';
 export { ReportStorageService } from './report-storage.service';
 export { ReportDataDiscoveryService } from './report-data-discovery.service';
+export { ReportApiExecutionService } from './report-api-execution.service';

package/lib/core/services/report-api-execution.service.d.ts

@@ -0,0 +1,41 @@
+import { Observable } from 'rxjs';
+import { ReportApiEndpointDefinition } from '../models/report-api-endpoint.model';
+import * as i0 from "@angular/core";
+export interface ApiExecutionOptions {
+    url?: string;
+    endpoint?: string;
+    method?: string;
+    dataPath?: string;
+    totalPath?: string;
+    headers?: Record<string, string>;
+    useProxy?: boolean;
+    bodyTemplate?: Record<string, unknown>;
+}
+/**
+ * Service responsible for executing API-based data retrieval requests.
+ *
+ * Supports URL path parameter interpolation (:id, {{id}}), query string parameter
+ * placement, JSON payload mapping, session header substitution, proxy routing,
+ * and dot-path response data extraction.
+ */
+export declare class ReportApiExecutionService {
+    private readonly http;
+    private readonly session;
+    private readonly reportingConfig;
+    private readonly endpoints;
+    getRegisteredEndpoints(): ReportApiEndpointDefinition[];
+    /**
+     * Executes a parameterized REST API request and extracts the result array.
+     *
+     * @param options Target endpoint configuration, URL, method, and data path.
+     * @param formValues Active parameter and filter values from the form/context.
+     * @param customMappings Additional fixed or mapped parameter values.
+     */
+    executeApi(options: ApiExecutionOptions | Partial<ReportApiEndpointDefinition>, formValues?: Record<string, unknown>, customMappings?: Record<string, unknown>): Observable<unknown[]>;
+    /**
+     * Dot-notation extractor: 'data.items' -> response.data.items
+     */
+    extractDataArray(response: any, dataPath?: string): unknown[];
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReportApiExecutionService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<ReportApiExecutionService>;
+}

package/lib/core/services/report-data-discovery.service.d.ts

@@ -16,6 +16,7 @@ export declare class ReportDataDiscoveryService {
     private readonly discoveryAdapter;
     private readonly lookupAdapter;
     private readonly sessionService;
+    private readonly apiExecutionService;
     /**
      * Retrieves all database tables, views, and stored procedures.
      */
@@ -29,8 +30,29 @@ export declare class ReportDataDiscoveryService {
      * 1. Attempts static schema discovery via ReportSchemaDiscoveryAdapter.
      * 2. If static discovery returns 0 columns or throws an error (e.g. SQL Error 11526 with #temp tables),
      *    automatically runs dynamic sample query via ReportLookupAdapter using resolved parameters.
+     * 3. For REST APIs, executes a dynamic test sample and extracts columns from the result array.
      */
-    autoDetectColumns(entityName: string, entityType?: 'table' | 'stored_procedure', mappings?: Record<string, unknown>, schema?: string): Observable<GridColumnDefinition[]>;
+    autoDetectColumns(entityName: string, entityType?: 'table' | 'stored_procedure' | 'api', mappings?: Record<string, unknown>, schema?: string, apiOptions?: {
+        dataPath?: string;
+        method?: string;
+        headers?: Record<string, string>;
+        useProxy?: boolean;
+    }): Observable<GridColumnDefinition[]>;
+    /**
+     * Executes a sample API call and infers grid column definitions from the response records.
+     */
+    autoDetectApiColumns(urlOrOptions: string | {
+        endpoint?: string;
+        url?: string;
+        method?: string;
+        dataPath?: string;
+        headers?: Record<string, string>;
+        useProxy?: boolean;
+    }, dataPathOrParams?: string | Record<string, unknown>, params?: Record<string, unknown>, options?: {
+        method?: string;
+        headers?: Record<string, string>;
+        useProxy?: boolean;
+    }): Observable<GridColumnDefinition[]>;
     private mapStaticColumnsToGrid;
     private fallbackDynamicDetection;
     static ɵfac: i0.ɵɵFactoryDeclaration<ReportDataDiscoveryService, never>;

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

@@ -6,8 +6,10 @@ export declare class EndpointDataSourceAdapter extends ReportDataSourceAdapter {
     private readonly http;
     private readonly endpoints;
     private readonly sessionService;
+    private readonly apiExecutionService;
     execute(dataSource: ReportDataSourceDefinition, parameters: Record<string, unknown>): Observable<unknown[]>;
     private resolveKind;
+    private isApiSource;
     static ɵfac: i0.ɵɵFactoryDeclaration<EndpointDataSourceAdapter, never>;
     static ɵprov: i0.ɵɵInjectableDeclaration<EndpointDataSourceAdapter>;
 }

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

@@ -5,6 +5,7 @@ export declare class EndpointLookupAdapter extends ReportLookupAdapter {
     private readonly http;
     private readonly endpoints;
     private readonly sessionService;
+    private readonly apiExecutionService;
     private readonly cache;
     private readonly inFlight;
     fetchOptions(request: LookupQueryRequest): Observable<LookupOptionItem[]>;

package/lib/data-access/adapters/endpoint-tokens.d.ts

@@ -5,6 +5,7 @@
  * are populated with the endpoint URLs so adapters can inject them.
  */
 import { InjectionToken } from '@angular/core';
+import { ReportApiEndpointDefinition } from '../../core/models/report-api-endpoint.model';
 /**
  * Endpoint URLs used by the endpoint-based adapters.
  */
@@ -14,6 +15,8 @@ export interface BwaysReportEndpoints {
     executeEndpoint: string;
     lookupEndpoint?: string | null;
     reportsEndpoint: string | null;
+    apisEndpoint?: string | null;
+    apiEndpoints?: ReportApiEndpointDefinition[];
 }
 /**
  * Injection token for the endpoint URLs.

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

@@ -2,13 +2,14 @@ import { Observable } from 'rxjs';
 import { LookupOptionItem, LookupQueryRequest, ReportLookupAdapter } from '../contracts/lookup.contract';
 import * as i0 from "@angular/core";
 /**
- * Built-in HTTP adapter for fetching dropdown options from backend database tables and SPs.
+ * Built-in HTTP adapter for fetching dropdown options from backend database tables, SPs, and REST APIs.
  * Includes in-memory caching with TTL, in-flight request deduplication, and fallback mock data.
  */
 export declare class HttpReportLookupAdapter extends ReportLookupAdapter {
     private readonly http;
     private readonly config;
     private readonly sessionService;
+    private readonly apiExecutionService;
     private readonly cache;
     private readonly inFlight;
     private readonly mockDataStore;

package/lib/data-access/contracts/lookup.contract.d.ts

@@ -12,6 +12,9 @@ export interface LookupQueryRequest {
     filter?: Record<string, unknown>;
     parameters?: Record<string, unknown>;
     limit?: number;
+    apiEndpoint?: string;
+    dataPath?: string;
+    useProxy?: boolean;
 }
 /**
  * Normalized option item for dropdowns and selectors

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

@@ -6,6 +6,8 @@ export declare class ComponentPaletteComponent {
     private readonly reportingConfig;
     readonly collapseRequested: import("@angular/core").OutputEmitterRef<void>;
     readonly searchQuery: import("@angular/core").WritableSignal<string>;
+    /** Selected category filter tab: 'all' or specific category name */
+    readonly selectedCategory: 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">;
     /** Set of expanded category IDs */
@@ -15,6 +17,12 @@ export declare class ComponentPaletteComponent {
         label: string;
         icon: string;
     }>;
+    /** Computed list of category tabs for quick one-click filtering */
+    readonly availableCategories: import("@angular/core").Signal<{
+        id: string;
+        label: string;
+        count: number;
+    }[]>;
     readonly filteredCategories: import("@angular/core").Signal<{
         name: string;
         label: string;
@@ -22,15 +30,23 @@ export declare class ComponentPaletteComponent {
         items: ReportingComponentMeta[];
     }[]>;
     readonly allExpanded: import("@angular/core").Signal<boolean>;
+    selectCategory(category: string): void;
     isCategoryExpanded(categoryName: string): boolean;
     toggleCategory(categoryName: string): void;
     toggleAllCategories(): void;
     getIconName(item: ReportingComponentMeta): string;
+    getComponentDescription(item: ReportingComponentMeta): string;
+    getGridLabel(item: ReportingComponentMeta): string;
+    getCategoryTheme(item: ReportingComponentMeta): string;
     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, {}, { "collapseRequested": "collapseRequested"; }, never, never, true, never>;
 }
+/** Concise labels optimized for 2-column compact grid tiles (zero truncation) */
+export declare const COMPONENT_SHORT_LABELS: Record<string, string>;
+/** Dictionary of user-friendly micro-copy descriptions explaining each component's purpose */
+export declare const COMPONENT_DESCRIPTIONS: Record<string, string>;
 /** Dictionary of synonyms for component types and UI concepts */
 export declare const COMPONENT_SYNONYMS: Record<string, string[]>;
 /** Compute Levenshtein distance between two strings for typo tolerance */

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

@@ -11,6 +11,8 @@ export declare class PropertyEditorDatasourceComponent implements OnInit, OnDest
     private readonly discoveryAdapter;
     private readonly sessionService;
     private readonly designerState;
+    private readonly dataDiscovery;
+    private readonly endpoints;
     private lastLoadedKey;
     private columnsSub?;
     private paramsSub?;
@@ -23,11 +25,21 @@ export declare class PropertyEditorDatasourceComponent implements OnInit, OnDest
     }>;
     readonly isAdvancedMode: import("@angular/core").WritableSignal<boolean>;
     readonly isLoadingEntities: import("@angular/core").WritableSignal<boolean>;
+    readonly isTestingApi: import("@angular/core").WritableSignal<boolean>;
+    readonly apiTestStatus: import("@angular/core").WritableSignal<{
+        message: string;
+        kind: "success" | "error";
+    } | null>;
     readonly allEntities: import("@angular/core").WritableSignal<DatabaseEntityMetadata[]>;
     readonly entityColumns: import("@angular/core").WritableSignal<EntityColumnMetadata[]>;
     readonly procedureParameters: import("@angular/core").WritableSignal<ProcedureParameterMetadata[]>;
     readonly currentSourceType: import("@angular/core").Signal<DropdownSourceType>;
     readonly selectedEntity: import("@angular/core").Signal<string>;
+    readonly selectedApiEndpoint: import("@angular/core").Signal<string>;
+    readonly selectedApiMethod: import("@angular/core").Signal<"GET" | "POST">;
+    readonly selectedDataPath: import("@angular/core").Signal<string>;
+    readonly selectedUseProxy: import("@angular/core").Signal<boolean>;
+    readonly registeredApis: import("@angular/core").Signal<SearchableSelectOption<any>[]>;
     readonly selectedValueField: import("@angular/core").Signal<string>;
     readonly selectedDisplayField: import("@angular/core").Signal<string>;
     readonly selectedDependsOn: import("@angular/core").Signal<string>;
@@ -72,6 +84,11 @@ export declare class PropertyEditorDatasourceComponent implements OnInit, OnDest
      */
     autoWireAllParameters(paramsList?: ProcedureParameterMetadata[]): void;
     setSourceType(type: DropdownSourceType): void;
+    onApiEndpointSelected(endpoint: string): void;
+    onApiMethodChanged(method: 'GET' | 'POST'): void;
+    onDataPathChanged(dataPath: string): void;
+    onUseProxyChanged(useProxy: boolean): void;
+    testAndDetectApiColumns(): void;
     onEntitySelected(entityName: string): void;
     onValueFieldChanged(valueField: string): void;
     onDisplayFieldChanged(displayField: string): void;

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

@@ -6,6 +6,7 @@ import { SearchableSelectOption } from '../../../../primitives/components';
 import * as i0 from "@angular/core";
 export declare class PropertyEditorGridComponent {
     private readonly dataDiscovery;
+    private readonly endpoints;
     readonly grid: import("@angular/core").InputSignal<ReportGridDefinition | undefined>;
     readonly dataSource: import("@angular/core").InputSignal<ReportDataSourceDefinition | undefined>;
     readonly availableEntities: import("@angular/core").InputSignal<DatabaseEntityMetadata[]>;
@@ -33,11 +34,22 @@ export declare class PropertyEditorGridComponent {
     readonly updateDataSourceParameters: import("@angular/core").OutputEmitterRef<Record<string, unknown>>;
     readonly entityChanged: import("@angular/core").OutputEmitterRef<{
         name: string;
-        type: "stored_procedure" | "table";
+        type: "stored_procedure" | "table" | "api";
     }>;
     readonly internalParameters: import("@angular/core").WritableSignal<ProcedureParameterMetadata[]>;
     readonly effectiveParameters: import("@angular/core").Signal<ProcedureParameterMetadata[]>;
-    readonly selectedSourceType: import("@angular/core").WritableSignal<"table" | "stored_procedure">;
+    readonly internalEntities: import("@angular/core").WritableSignal<DatabaseEntityMetadata[]>;
+    readonly allEntities: import("@angular/core").Signal<DatabaseEntityMetadata[]>;
+    readonly activeSourceType: import("@angular/core").WritableSignal<"table" | "api" | "stored_procedure">;
+    readonly currentSourceType: import("@angular/core").Signal<"table" | "api" | "stored_procedure">;
+    readonly activeEntityName: import("@angular/core").Signal<string>;
+    readonly apiEndpoint: import("@angular/core").Signal<string>;
+    readonly apiMethod: import("@angular/core").Signal<"GET" | "POST">;
+    readonly apiDataPath: import("@angular/core").Signal<string>;
+    readonly apiUseProxy: import("@angular/core").Signal<boolean>;
+    readonly registeredApis: import("@angular/core").Signal<SearchableSelectOption<any>[]>;
+    readonly availableTables: import("@angular/core").Signal<DatabaseEntityMetadata[]>;
+    readonly availableProcedures: import("@angular/core").Signal<DatabaseEntityMetadata[]>;
     readonly isExecSnippetOpen: import("@angular/core").WritableSignal<boolean>;
     readonly execSnippetText: import("@angular/core").WritableSignal<string>;
     readonly execParseStatus: import("@angular/core").WritableSignal<{
@@ -47,10 +59,6 @@ export declare class PropertyEditorGridComponent {
     toggleExecSnippet(): void;
     applyExecSnippet(): void;
     constructor();
-    readonly currentSourceType: import("@angular/core").Signal<"table" | "stored_procedure">;
-    readonly activeEntityName: import("@angular/core").Signal<string>;
-    readonly availableTables: import("@angular/core").Signal<DatabaseEntityMetadata[]>;
-    readonly availableProcedures: import("@angular/core").Signal<DatabaseEntityMetadata[]>;
     readonly activeEntityList: import("@angular/core").Signal<DatabaseEntityMetadata[]>;
     readonly gridEntitySelectOptions: import("@angular/core").Signal<SearchableSelectOption<any>[]>;
     readonly columns: import("@angular/core").Signal<GridColumnDefinition[]>;
@@ -60,7 +68,11 @@ export declare class PropertyEditorGridComponent {
         key: string;
         value: string;
     }[]>;
-    onSourceTypeChange(type: 'stored_procedure' | 'table'): void;
+    onSourceTypeChange(type: 'stored_procedure' | 'table' | 'api'): void;
+    onApiEndpointChange(endpoint: string): void;
+    onApiMethodChange(method: 'GET' | 'POST'): void;
+    onApiDataPathChange(dataPath: string): void;
+    onApiUseProxyChange(useProxy: boolean): void;
     onSelectEntity(entityName: string): void;
     getParameterValue(paramName: string): string | number | boolean;
     onParameterChange(paramName: string, value: string | number | boolean): void;

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

@@ -57,7 +57,7 @@ export declare class PropertyEditorComponent {
     updateGridRowClickAction(action: GridRowClickAction | undefined): void;
     onGridEntityChanged(event: {
         name: string;
-        type: 'stored_procedure' | 'table';
+        type: 'stored_procedure' | 'table' | 'api';
     }): void;
     onGridDataSourceParametersChanged(mappings: Record<string, unknown>): void;
     autoDetectGridColumns(): void;

package/lib/features/designer/designer.component.d.ts

@@ -7,6 +7,7 @@ export declare class DesignerComponent implements OnInit {
     private readonly persistenceAdapter;
     private readonly dataSourceAdapter;
     private readonly sessionService;
+    private readonly executionService;
     private readonly dialog;
     private readonly router;
     private readonly reportingConfig;
@@ -33,6 +34,13 @@ export declare class DesignerComponent implements OnInit {
     onResize(): void;
     onKeyDown(event: KeyboardEvent): void;
     readonly formattedJson: import("@angular/core").Signal<string>;
+    readonly editorTheme: import("@angular/core").WritableSignal<"light" | "dark">;
+    readonly wrapLines: import("@angular/core").WritableSignal<boolean>;
+    readonly jsonStats: import("@angular/core").Signal<{
+        lines: number;
+        sizeKb: string;
+    }>;
+    readonly highlightedLines: import("@angular/core").Signal<string[]>;
     private loadedReportId;
     private loadedReportDef;
     private lastEmittedDef;
@@ -45,6 +53,10 @@ export declare class DesignerComponent implements OnInit {
         parameters: Record<string, unknown>;
     }): void;
     copyJson(): void;
+    downloadJson(): void;
+    toggleEditorTheme(): void;
+    toggleWrapLines(): void;
+    private syntaxHighlightJson;
     private showToast;
     static ɵfac: i0.ɵɵFactoryDeclaration<DesignerComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<DesignerComponent, "rpt-designer", never, { "reportId": { "alias": "reportId"; "required": false; "isSignal": true; }; "definition": { "alias": "initialReport"; "required": false; "isSignal": true; }; }, { "reportSaved": "save"; "definitionChanged": "definitionChange"; }, never, never, true, never>;

package/lib/features/runtime/report-execution.service.d.ts

@@ -8,6 +8,7 @@ import * as i0 from "@angular/core";
 export declare class ReportExecutionService {
     private readonly adapter;
     private readonly session;
+    private readonly apiExecutionService;
     /** Canvas field keys the user still has to fill before the report can run. */
     getMissingFields(def: ReportDefinition, formValues: Record<string, unknown>): string[];
     execute(def: ReportDefinition, formValues: Record<string, unknown>): Observable<unknown[]>;

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

@@ -9,6 +9,7 @@ export declare class RptGridOutletDirective implements OnDestroy {
     private lastEmittedColumnDefs;
     private readonly appliedInputs;
     readonly componentType: import("@angular/core").InputSignal<Type<any> | null>;
+    readonly instanceKey: import("@angular/core").InputSignal<string | null>;
     readonly inputs: import("@angular/core").InputSignal<Record<string, unknown>>;
     readonly gridStateChange: import("@angular/core").OutputEmitterRef<any>;
     readonly columnDefsChange: import("@angular/core").OutputEmitterRef<any>;
@@ -26,7 +27,7 @@ export declare class RptGridOutletDirective implements OnDestroy {
     private clear;
     ngOnDestroy(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RptGridOutletDirective, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<RptGridOutletDirective, "[rptGridOutlet]", never, { "componentType": { "alias": "rptGridOutlet"; "required": false; "isSignal": true; }; "inputs": { "alias": "inputs"; "required": false; "isSignal": true; }; }, { "gridStateChange": "gridStateChange"; "columnDefsChange": "columnDefsChange"; "rowClick": "rowClick"; "selectionChange": "selectionChange"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<RptGridOutletDirective, "[rptGridOutlet]", never, { "componentType": { "alias": "rptGridOutlet"; "required": false; "isSignal": true; }; "instanceKey": { "alias": "instanceKey"; "required": false; "isSignal": true; }; "inputs": { "alias": "inputs"; "required": false; "isSignal": true; }; }, { "gridStateChange": "gridStateChange"; "columnDefsChange": "columnDefsChange"; "rowClick": "rowClick"; "selectionChange": "selectionChange"; }, never, never, true, never>;
 }
 export declare class ReportGridBridgeComponent {
     private readonly injectedGrid;
@@ -104,6 +105,7 @@ export declare class ReportGridBridgeComponent {
         statusBar: boolean;
         rowClickAction?: import("../../core/models/report-grid.model").GridRowClickAction;
     }>;
+    private reconcileColumnGroupDefs;
     readonly gridReportState: import("@angular/core").Signal<any>;
     readonly gridInputs: import("@angular/core").Signal<{
         columns: {

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

@@ -12,9 +12,21 @@ export declare class ReportRuntimeComponent {
     readonly reportId: import("@angular/core").InputSignal<string | undefined>;
     /** Directly passed report definition (skips persistence adapter) */
     readonly definition: import("@angular/core").InputSignal<ReportDefinition | null>;
+    /** Optional pre-loaded or canvas-shared result data */
+    readonly initialData: import("@angular/core").InputSignal<unknown[] | null>;
     readonly resetRequested: import("@angular/core").OutputEmitterRef<{
         definition: ReportDefinition;
     }>;
+    readonly execute: import("@angular/core").OutputEmitterRef<{
+        definition: ReportDefinition;
+        parameters: Record<string, unknown>;
+        data: unknown[] | null;
+    }>;
+    readonly executed: import("@angular/core").OutputEmitterRef<{
+        definition: ReportDefinition;
+        parameters: Record<string, unknown>;
+        data: unknown[] | null;
+    }>;
     readonly exportRequested: import("@angular/core").OutputEmitterRef<{
         format: string;
         fileName?: string;
@@ -107,5 +119,5 @@ export declare class ReportRuntimeComponent {
     retryDrawer(): void;
     retry(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ReportRuntimeComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<ReportRuntimeComponent, "rpt-report-runtime, rpt-runtime", never, { "reportId": { "alias": "reportId"; "required": false; "isSignal": true; }; "definition": { "alias": "report"; "required": false; "isSignal": true; }; }, { "resetRequested": "resetRequested"; "exportRequested": "exportRequested"; "printRequested": "printRequested"; "customActionTriggered": "customActionTriggered"; "gridStateChange": "gridStateChange"; "columnDefsChange": "columnDefsChange"; "selectionChange": "selectionChange"; "selectionChanged": "selectionChanged"; "rowActionTriggered": "rowActionTriggered"; "drilldownRequested": "drilldownRequested"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ReportRuntimeComponent, "rpt-report-runtime, rpt-runtime", never, { "reportId": { "alias": "reportId"; "required": false; "isSignal": true; }; "definition": { "alias": "report"; "required": false; "isSignal": true; }; "initialData": { "alias": "resultData"; "required": false; "isSignal": true; }; }, { "resetRequested": "resetRequested"; "execute": "execute"; "executed": "executed"; "exportRequested": "exportRequested"; "printRequested": "printRequested"; "customActionTriggered": "customActionTriggered"; "gridStateChange": "gridStateChange"; "columnDefsChange": "columnDefsChange"; "selectionChange": "selectionChange"; "selectionChanged": "selectionChanged"; "rowActionTriggered": "rowActionTriggered"; "drilldownRequested": "drilldownRequested"; }, never, never, true, never>;
 }

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

@@ -14,3 +14,5 @@ export type { ChartDataItem, ChartType } from './chart-bridge/report-chart-bridg
 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';
+export { RptRadioComponent } from './radio/rpt-radio.component';
+export type { RadioOption } from './radio/rpt-radio.component';