bways-report 0.1.8 → 0.2.0

package/lib/data-access/contracts/report-persistence.contract.d.ts

@@ -6,6 +6,17 @@
  */
 import { Observable } from 'rxjs';
 import { ReportDefinition, ReportSummary } from '../../core/models/report-definition.model';
+export interface ReportSaveOptions {
+    /** Reject an existing ID instead of updating it. Hosts should enforce this atomically. */
+    createOnly?: boolean;
+    /** Update only an existing report at this version; reject missing or changed records. */
+    expectedVersion?: number;
+}
+export interface ReportIdStatus {
+    exists: boolean;
+    name?: string;
+    version?: number;
+}
 /**
  * Contract for persisting report definitions.
  *
@@ -23,10 +34,14 @@ import { ReportDefinition, ReportSummary } from '../../core/models/report-defini
  * ```
  */
 export declare abstract class ReportPersistenceAdapter {
+    /** Returns true when this ID exists. Legacy host adapters may use the catalog fallback. */
+    checkId(reportId: string): Observable<boolean>;
+    /** Compact identity metadata used to confirm an overwrite. Legacy hosts use summaries. */
+    inspectId(reportId: string): Observable<ReportIdStatus>;
     /** Load a full report definition by ID. */
     abstract load(reportId: string): Observable<ReportDefinition>;
     /** Save (create or update) a report definition. */
-    abstract save(report: ReportDefinition): Observable<ReportDefinition>;
+    abstract save(report: ReportDefinition, options?: ReportSaveOptions): Observable<ReportDefinition>;
     /** List available reports (summaries only). */
     abstract list(): Observable<ReportSummary[]>;
     /** Delete a report by ID. */

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/design-canvas/design-canvas.component.d.ts

@@ -5,6 +5,8 @@ import { ReportComponentDefinition } from '../../../../core/models/report-compon
 import { getComponentIconName } from '../../utilities/canvas-layout.util';
 import * as i0 from "@angular/core";
 export declare class DesignCanvasComponent implements OnDestroy {
+    private readonly requests;
+    constructor();
     private readonly designerState;
     private gridFilterDebounceTimer;
     private pendingGridState;

package/lib/features/designer/components/dialogs/report-saved-dialog.component.d.ts

@@ -8,27 +8,59 @@ export interface ReportSavedDialogResult {
     action: 'back_to_designer' | 'open_live_page';
     report: ReportDefinition;
 }
+interface UpdateConfirmation {
+    report: ReportDefinition;
+    action: ReportSavedDialogResult['action'];
+    expectedVersion: number;
+    existingName: string;
+    contextKey: string;
+}
 export declare class ReportSavedDialogComponent {
     private readonly dialogRef;
     private readonly data;
     private readonly store;
+    private readonly destroyRef;
     private readonly reportingConfig;
-    private readonly router;
+    private idCheck?;
+    private customSlug;
     readonly report: ReportDefinition;
     readonly baseRoute: import("@angular/core").WritableSignal<string>;
+    readonly reportId: import("@angular/core").WritableSignal<string>;
+    readonly isCheckingId: import("@angular/core").WritableSignal<boolean>;
+    readonly isPreparingSave: import("@angular/core").WritableSignal<boolean>;
+    readonly updateConfirmation: import("@angular/core").WritableSignal<UpdateConfirmation | null>;
+    readonly idAttempted: import("@angular/core").WritableSignal<boolean>;
+    readonly idStatus: import("@angular/core").WritableSignal<"error" | "duplicate" | "unchecked" | "checking" | "available" | "current">;
+    readonly idMessage: import("@angular/core").WritableSignal<string>;
+    readonly idChanged: import("@angular/core").Signal<boolean>;
+    readonly idError: import("@angular/core").Signal<"Enter a report ID." | "Use a report ID of at most 100 characters." | "Use letters, numbers, underscores or hyphens, starting with a letter or number." | "Choose another ID; \"new\" is reserved for the report builder." | null>;
     readonly name: import("@angular/core").WritableSignal<string>;
+    readonly description: import("@angular/core").WritableSignal<string>;
+    readonly category: import("@angular/core").WritableSignal<string>;
     readonly slug: import("@angular/core").WritableSignal<string>;
     readonly menuGroup: import("@angular/core").WritableSignal<string>;
     readonly isPublished: import("@angular/core").WritableSignal<boolean>;
     readonly copied: import("@angular/core").WritableSignal<boolean>;
-    readonly savedStateMessage: import("@angular/core").WritableSignal<string | null>;
+    readonly isSaving: import("@angular/core").WritableSignal<boolean>;
+    readonly attempted: import("@angular/core").WritableSignal<boolean>;
+    readonly saveError: import("@angular/core").WritableSignal<string | null>;
+    readonly nameError: import("@angular/core").Signal<"Enter a report name." | null>;
+    readonly slugError: import("@angular/core").Signal<"Enter a URL slug." | "Use lowercase letters, numbers, and single hyphens." | "Choose a different slug; \"new\" is reserved for the report builder." | null>;
     readonly fullRoute: import("@angular/core").Signal<string>;
     readonly currentPreviewDef: import("@angular/core").Signal<ReportDefinition>;
-    onNameChange(newName: string): void;
+    onIdChange(value: string): void;
+    randomizeId(): void;
+    verifyId(): void;
+    onNameChange(value: string): void;
+    onSlugChange(value: string): void;
     copyRoute(): void;
-    saveUpdatedDefinition(): ReportDefinition;
-    close(action?: 'back_to_designer' | 'open_live_page'): void;
+    save(action?: ReportSavedDialogResult['action']): void;
+    cancelUpdate(): void;
+    confirmUpdate(): void;
+    private persist;
+    close(): void;
     openLivePage(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<ReportSavedDialogComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<ReportSavedDialogComponent, "rpt-report-saved-dialog", never, {}, {}, never, never, true, never>;
 }
+export {};

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

@@ -1,4 +1,4 @@
-import { OnDestroy, OnInit } from '@angular/core';
+import { OnDestroy } from '@angular/core';
 import { ComponentDataSourceDefinition, DropdownSourceType, ReportComponentDefinition } from '../../../../core/models/report-component.model';
 import { DatabaseEntityMetadata, EntityColumnMetadata, ProcedureParameterMetadata } from '../../../../data-access/contracts/schema-discovery.contract';
 import { SearchableSelectOption } from '../../../../primitives/components';
@@ -7,10 +7,14 @@ export interface StaticOptionItem {
     key: string;
     label: string;
 }
-export declare class PropertyEditorDatasourceComponent implements OnInit, OnDestroy {
+export declare class PropertyEditorDatasourceComponent implements OnDestroy {
+    private readonly endpointScope;
+    private entitiesSub?;
     private readonly discoveryAdapter;
     private readonly sessionService;
     private readonly designerState;
+    private readonly dataDiscovery;
+    private readonly endpoints;
     private lastLoadedKey;
     private columnsSub?;
     private paramsSub?;
@@ -23,11 +27,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>;
@@ -57,7 +71,6 @@ export declare class PropertyEditorDatasourceComponent implements OnInit, OnDest
     readonly valueFieldSelectOptions: import("@angular/core").Signal<SearchableSelectOption<any>[]>;
     readonly parentFieldSelectOptions: import("@angular/core").Signal<SearchableSelectOption<any>[]>;
     constructor();
-    ngOnInit(): void;
     ngOnDestroy(): void;
     loadEntities(): void;
     loadEntityDetails(entityName: string, type: DropdownSourceType): void;
@@ -72,6 +85,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

@@ -5,7 +5,9 @@ import { DatabaseEntityMetadata, ProcedureParameterMetadata } from '../../../../
 import { SearchableSelectOption } from '../../../../primitives/components';
 import * as i0 from "@angular/core";
 export declare class PropertyEditorGridComponent {
+    private readonly endpointScope;
     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 +35,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 +60,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 +69,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

@@ -18,6 +18,7 @@ export declare class PropertyEditorComponent {
     private readonly discoveryAdapter;
     private readonly lookupAdapter;
     private readonly sessionService;
+    private readonly endpointScope;
     private readonly dataDiscovery;
     readonly isDetectingColumns: import("@angular/core").WritableSignal<boolean>;
     readonly gridDetectionStatus: import("@angular/core").WritableSignal<{
@@ -57,7 +58,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/components/toolbar/designer-toolbar.component.d.ts

@@ -3,8 +3,13 @@ import { ReportBlueprint } from '../../services/report-template.service';
 import { ReportDefinition } from '../../../../core/models/report-definition.model';
 import * as i0 from "@angular/core";
 export declare class DesignerToolbarComponent {
+    private readonly requests;
+    readonly catalogLoading: import("@angular/core").WritableSignal<boolean>;
+    readonly catalogError: import("@angular/core").WritableSignal<string | null>;
+    readonly isSwitchingReport: import("@angular/core").WritableSignal<boolean>;
     private readonly designerState;
     private readonly templateService;
+    private readonly endpointScope;
     private readonly reportStore;
     readonly definition: import("@angular/core").WritableSignal<ReportDefinition>;
     readonly viewMode: import("@angular/core").WritableSignal<DesignerViewMode>;
@@ -26,7 +31,8 @@ export declare class DesignerToolbarComponent {
     saveRename(): void;
     cancelRename(): void;
     createNewReport(): void;
-    onSwitchReport(reportId: string): void;
+    refreshReports(): void;
+    onSwitchReport(reportId: string, select?: HTMLSelectElement): void;
     private toSlug;
     setMode(mode: DesignerViewMode): void;
     undo(): void;

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

@@ -1,12 +1,26 @@
+import { BwaysReportConfig } from '../../core/config/bways-report-config';
 import { OnInit } from '@angular/core';
 import { ReportDefinition } from '../../core/models/report-definition.model';
 import { DesignerStateService } from './services/designer-state.service';
+import { BwaysReportApiUrls } from '../../data-access/adapters/endpoint-tokens';
 import * as i0 from "@angular/core";
 export declare class DesignerComponent implements OnInit {
+    private readonly requests;
+    readonly loadError: import("@angular/core").WritableSignal<string | null>;
+    private readonly injector;
+    private readonly destroyRef;
+    private saveDialogOpen;
+    private readonly endpointScope;
+    private readonly configuration;
+    /** Page-local settings; omitted values inherit optional application defaults. */
+    set config(value: BwaysReportConfig | null | undefined);
+    /** Override any subset of configured URLs for this designer and its preview. */
+    set apiUrl(value: BwaysReportApiUrls | null | undefined);
     readonly designerState: DesignerStateService;
     private readonly persistenceAdapter;
     private readonly dataSourceAdapter;
     private readonly sessionService;
+    private readonly executionService;
     private readonly dialog;
     private readonly router;
     private readonly reportingConfig;
@@ -45,8 +59,8 @@ export declare class DesignerComponent implements OnInit {
     private lastEmittedDef;
     constructor();
     ngOnInit(): void;
+    retryLoad(): void;
     onSave(): void;
-    private openSavedDialog;
     onPreviewExecute(event: {
         definition: ReportDefinition;
         parameters: Record<string, unknown>;
@@ -58,5 +72,5 @@ export declare class DesignerComponent implements OnInit {
     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>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DesignerComponent, "rpt-designer", never, { "config": { "alias": "config"; "required": false; }; "apiUrl": { "alias": "apiUrl"; "required": false; }; "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/designer/rpt-report-designer.component.d.ts

@@ -1,3 +1,5 @@
+import { BwaysReportConfig } from '../../core/config/bways-report-config';
+import { BwaysReportApiUrls } from '../../data-access/adapters/endpoint-tokens';
 import { ReportDefinition } from '../../core/models/report-definition.model';
 import * as i0 from "@angular/core";
 /**
@@ -16,6 +18,8 @@ import * as i0 from "@angular/core";
  * ```
  */
 export declare class RptReportDesignerComponent {
+    readonly config: import("@angular/core").InputSignal<BwaysReportConfig | null>;
+    readonly apiUrl: import("@angular/core").InputSignal<BwaysReportApiUrls | null>;
     /** Report ID to automatically load via configured ReportPersistenceAdapter */
     readonly id: import("@angular/core").InputSignal<string | undefined>;
     /** Report definition to load directly in memory */
@@ -34,5 +38,5 @@ export declare class RptReportDesignerComponent {
     onDefinitionChange(definition: ReportDefinition): void;
     onClose(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<RptReportDesignerComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<RptReportDesignerComponent, "rpt-report-designer, rpt-designer-view", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "report": { "alias": "report"; "required": false; "isSignal": true; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; }, { "saved": "saved"; "closed": "closed"; "definitionChange": "definitionChange"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<RptReportDesignerComponent, "rpt-report-designer, rpt-designer-view", never, { "config": { "alias": "config"; "required": false; "isSignal": true; }; "apiUrl": { "alias": "apiUrl"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "report": { "alias": "report"; "required": false; "isSignal": true; }; "showCloseButton": { "alias": "showCloseButton"; "required": false; "isSignal": true; }; "closeLabel": { "alias": "closeLabel"; "required": false; "isSignal": true; }; }, { "saved": "saved"; "closed": "closed"; "definitionChange": "definitionChange"; }, never, never, true, never>;
 }

package/lib/features/designer/services/designer-config.service.d.ts

@@ -0,0 +1,13 @@
+import { BwaysReportConfig } from '../../../core/config/bways-report-config';
+import { ReportingConfig } from '../../../core/tokens/reporting-config.token';
+import * as i0 from "@angular/core";
+export declare class DesignerConfigService {
+    private readonly inherited;
+    readonly local: import("@angular/core").WritableSignal<BwaysReportConfig | null>;
+    private readonly effective;
+    readonly reporting: ReportingConfig;
+    constructor();
+    set(value: BwaysReportConfig | null | undefined): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DesignerConfigService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DesignerConfigService>;
+}

package/lib/features/designer/services/designer-endpoints.service.d.ts

@@ -0,0 +1,25 @@
+import { Provider, Type } from '@angular/core';
+import { BwaysReportApiUrls, BwaysReportEndpoints } from '../../../data-access/adapters/endpoint-tokens';
+import * as i0 from "@angular/core";
+/** Private state owned by one designer; never mutates application providers. */
+export declare class DesignerEndpointsService {
+    private readonly defaults;
+    private readonly config;
+    private readonly injector;
+    private readonly pageConfig;
+    private readonly adapters;
+    private overrides;
+    readonly revision: import("@angular/core").WritableSignal<number>;
+    private readonly resolved;
+    readonly endpoints: BwaysReportEndpoints;
+    setOverrides(value: BwaysReportApiUrls | null | undefined): void;
+    hasOverride(keys: (keyof BwaysReportApiUrls)[]): boolean;
+    adapter<T>(type: Type<T>): T;
+    isConfigured(): boolean;
+    refresh(): void;
+    usesDefaultStorageBase(): boolean;
+    private merged;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DesignerEndpointsService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DesignerEndpointsService>;
+}
+export declare const DESIGNER_ENDPOINT_PROVIDERS: Provider[];

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

@@ -1,5 +1,6 @@
 import { Observable } from 'rxjs';
 import { ReportDefinition, ReportSummary } from '../../../core/models/report-definition.model';
+import { ReportSaveOptions, ReportIdStatus } from '../../../data-access/contracts/report-persistence.contract';
 import * as i0 from "@angular/core";
 /**
  * ReportStoreService manages application-wide cached report states,
@@ -8,6 +9,12 @@ import * as i0 from "@angular/core";
 export declare class ReportStoreService {
     private readonly adapter;
     private readonly validator;
+    private readonly session;
+    private readonly endpoints;
+    private cacheContext;
+    private currentCacheContext;
+    private guardCacheContext;
+    private ensureCacheContext;
     /** List of all known report summaries */
     readonly summaries: import("@angular/core").WritableSignal<ReportSummary[]>;
     /** In-memory cache of loaded full report definitions by ID */
@@ -39,7 +46,14 @@ export declare class ReportStoreService {
     /**
      * Saves a report definition, validates it, and updates local cache.
      */
-    saveReport(report: ReportDefinition): Observable<ReportDefinition>;
+    /** Opaque endpoint/session identity for pending user confirmations. */
+    getStorageContextKey(): string;
+    inspectReportId(id: string): Observable<ReportIdStatus>;
+    checkReportId(id: string): Observable<boolean>;
+    /** Saves a validated report definition and updates the local cache. */
+    saveReport(report: ReportDefinition, options?: ReportSaveOptions): Observable<ReportDefinition>;
+    /** Accepts an already persisted report without issuing another database write. */
+    cacheSavedReport(report: ReportDefinition): void;
     /**
      * Deletes a report definition by ID.
      */

package/lib/features/persistence/services/schema-validator.service.d.ts

@@ -16,6 +16,8 @@ export interface SchemaValidationResult {
  * - Column span boundary violations
  */
 export declare function validateReportSchema(definition: ReportDefinition): SchemaValidationResult;
+/** Normalize legacy optional collections only after verifying unknown input is safe. */
+export declare function normalizeReportDefinition(value: unknown): ReportDefinition;
 /**
  * SchemaValidatorService provides schema verification methods.
  */

package/lib/features/routing/resolvers/report-route-identifier.d.ts

@@ -0,0 +1,2 @@
+import { ActivatedRouteSnapshot } from '@angular/router';
+export declare function reportRouteIdentifier(route: ActivatedRouteSnapshot): string | null;

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

@@ -6,8 +6,12 @@ import * as i0 from "@angular/core";
  * Live Preview and the designer canvas so all three behave identically.
  */
 export declare class ReportExecutionService {
+    private readonly config;
+    private readonly endpoints;
+    private guard;
     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,9 +27,10 @@ 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 designerConfig;
     private readonly injectedGrid;
     private readonly storage;
     constructor();
@@ -104,6 +106,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

@@ -4,6 +4,7 @@ import { ComponentActionDefinition } from '../../core/models/component-event.mod
 import { GridRowClickAction } from '../../core/models/report-grid.model';
 import * as i0 from "@angular/core";
 export declare class ReportRuntimeComponent {
+    private readonly requests;
     private readonly persistenceAdapter;
     private readonly dataSourceAdapter;
     private readonly sessionService;
@@ -12,9 +13,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 +120,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/features/runtime/rpt-report.component.d.ts

@@ -10,6 +10,10 @@ export interface ReportViewPreset {
     createdAt?: string;
 }
 export declare class RptReportComponent {
+    private readonly requests;
+    readonly presetError: import("@angular/core").WritableSignal<string | null>;
+    readonly isSavingPreset: import("@angular/core").WritableSignal<boolean>;
+    private readonly persistedDefinition;
     private readonly exportService;
     private readonly persistence;
     readonly id: import("@angular/core").InputSignal<string | undefined>;
@@ -61,6 +65,7 @@ export declare class RptReportComponent {
     closeSavePresetModal(): void;
     saveCurrentPreset(): void;
     deletePreset(presetId: string): void;
+    private persistPresets;
     onExportExcel(): void;
     onExportCsv(): void;
     onPrintReport(): void;

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

@@ -8,7 +8,9 @@ export interface ChartDataItem {
 }
 export type ChartType = 'bar' | 'line' | 'donut';
 export declare class ReportChartBridgeComponent {
-    readonly hostChartComponent: Type<unknown> | null;
+    private readonly injectedChart;
+    private readonly designerConfig;
+    get hostChartComponent(): Type<unknown> | null;
     readonly definition: import("@angular/core").InputSignal<ReportComponentDefinition | undefined>;
     readonly customData: import("@angular/core").InputSignal<ChartDataItem[] | undefined>;
     readonly customChartType: import("@angular/core").InputSignal<ChartType | undefined>;

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';