bways-report 0.1.5 → 0.1.7

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

@@ -1,7 +1,19 @@
 import { GridColumnDefinition, GridRowClickAction, ReportGridDefinition } from '../../../../core/models/report-grid.model';
+import { ReportDataSourceDefinition } from '../../../../core/models/report-datasource.model';
+import { ReportComponentDefinition } from '../../../../core/models/report-component.model';
+import { DatabaseEntityMetadata, ProcedureParameterMetadata } from '../../../../data-access/contracts/schema-discovery.contract';
+import { SearchableSelectOption } from '../../../../primitives/components';
 import * as i0 from "@angular/core";
 export declare class PropertyEditorGridComponent {
+    private readonly dataDiscovery;
     readonly grid: import("@angular/core").InputSignal<ReportGridDefinition | undefined>;
+    readonly dataSource: import("@angular/core").InputSignal<ReportDataSourceDefinition | undefined>;
+    readonly availableEntities: import("@angular/core").InputSignal<DatabaseEntityMetadata[]>;
+    readonly procedureParameters: import("@angular/core").InputSignal<ProcedureParameterMetadata[]>;
+    readonly allComponents: import("@angular/core").InputSignal<ReportComponentDefinition[]>;
+    readonly isDetecting: import("@angular/core").InputSignal<boolean>;
+    readonly statusMessage: import("@angular/core").InputSignal<string | null>;
+    readonly statusKind: import("@angular/core").InputSignal<"error" | "success" | "info" | null>;
     readonly addGrid: import("@angular/core").OutputEmitterRef<void>;
     readonly removeGrid: import("@angular/core").OutputEmitterRef<void>;
     readonly addColumn: import("@angular/core").OutputEmitterRef<void>;
@@ -17,6 +29,30 @@ export declare class PropertyEditorGridComponent {
         value: unknown;
     }>;
     readonly updateRowClickAction: import("@angular/core").OutputEmitterRef<GridRowClickAction | undefined>;
+    readonly setDataSource: import("@angular/core").OutputEmitterRef<ReportDataSourceDefinition>;
+    readonly updateDataSourceParameters: import("@angular/core").OutputEmitterRef<Record<string, unknown>>;
+    readonly entityChanged: import("@angular/core").OutputEmitterRef<{
+        name: string;
+        type: "stored_procedure" | "table";
+    }>;
+    readonly internalParameters: import("@angular/core").WritableSignal<ProcedureParameterMetadata[]>;
+    readonly effectiveParameters: import("@angular/core").Signal<ProcedureParameterMetadata[]>;
+    readonly selectedSourceType: import("@angular/core").WritableSignal<"table" | "stored_procedure">;
+    readonly isExecSnippetOpen: import("@angular/core").WritableSignal<boolean>;
+    readonly execSnippetText: import("@angular/core").WritableSignal<string>;
+    readonly execParseStatus: import("@angular/core").WritableSignal<{
+        message: string;
+        kind: "success" | "error";
+    } | null>;
+    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[]>;
     readonly rowClickAction: import("@angular/core").Signal<GridRowClickAction | undefined>;
     readonly hasRowClickAction: import("@angular/core").Signal<boolean>;
@@ -24,6 +60,10 @@ export declare class PropertyEditorGridComponent {
         key: string;
         value: string;
     }[]>;
+    onSourceTypeChange(type: 'stored_procedure' | 'table'): void;
+    onSelectEntity(entityName: string): void;
+    getParameterValue(paramName: string): string | number | boolean;
+    onParameterChange(paramName: string, value: string | number | boolean): void;
     onUpdateCol(index: number, field: string, value: unknown): void;
     toggleRowClickAction(enabled: boolean): void;
     updateRowActionField(field: keyof GridRowClickAction, value: unknown): void;
@@ -32,5 +72,5 @@ export declare class PropertyEditorGridComponent {
     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"; "autoDetectColumns": "autoDetectColumns"; "removeColumn": "removeColumn"; "updateColumn": "updateColumn"; "updateOption": "updateOption"; "updateRowClickAction": "updateRowClickAction"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PropertyEditorGridComponent, "rpt-property-editor-grid", never, { "grid": { "alias": "grid"; "required": false; "isSignal": true; }; "dataSource": { "alias": "dataSource"; "required": false; "isSignal": true; }; "availableEntities": { "alias": "availableEntities"; "required": false; "isSignal": true; }; "procedureParameters": { "alias": "procedureParameters"; "required": false; "isSignal": true; }; "allComponents": { "alias": "allComponents"; "required": false; "isSignal": true; }; "isDetecting": { "alias": "isDetecting"; "required": false; "isSignal": true; }; "statusMessage": { "alias": "statusMessage"; "required": false; "isSignal": true; }; "statusKind": { "alias": "statusKind"; "required": false; "isSignal": true; }; }, { "addGrid": "addGrid"; "removeGrid": "removeGrid"; "addColumn": "addColumn"; "autoDetectColumns": "autoDetectColumns"; "removeColumn": "removeColumn"; "updateColumn": "updateColumn"; "updateOption": "updateOption"; "updateRowClickAction": "updateRowClickAction"; "setDataSource": "setDataSource"; "updateDataSourceParameters": "updateDataSourceParameters"; "entityChanged": "entityChanged"; }, never, never, true, never>;
 }

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

@@ -3,6 +3,8 @@ import { PropertyDefinition } from '../../../../core/registry/property-definitio
 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 { DatabaseEntityMetadata, ProcedureParameterMetadata } from '../../../../data-access/contracts/schema-discovery.contract';
+import { ReportDataSourceDefinition } from '../../../../core/models/report-datasource.model';
 import * as i0 from "@angular/core";
 /**
  * Property Editor coordinator component.
@@ -14,12 +16,24 @@ export declare class PropertyEditorComponent {
     private readonly designerState;
     private readonly registry;
     private readonly discoveryAdapter;
+    private readonly lookupAdapter;
+    private readonly sessionService;
+    private readonly dataDiscovery;
+    readonly isDetectingColumns: import("@angular/core").WritableSignal<boolean>;
+    readonly gridDetectionStatus: import("@angular/core").WritableSignal<{
+        message: string;
+        kind: "info" | "success" | "error";
+    } | null>;
+    readonly availableEntities: import("@angular/core").WritableSignal<DatabaseEntityMetadata[]>;
+    readonly gridProcedureParameters: import("@angular/core").WritableSignal<ProcedureParameterMetadata[]>;
     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 gridDataSource: import("@angular/core").Signal<ReportDataSourceDefinition | undefined>;
+    constructor();
     readonly propertySchema: import("@angular/core").Signal<PropertyDefinition[]>;
     setTab(tab: DesignerActiveTab): void;
     updateCompDataSource(id: string, dataSource: ComponentDataSourceDefinition): void;
@@ -41,6 +55,11 @@ export declare class PropertyEditorComponent {
     updateColumn(index: number, field: string, value: unknown): void;
     updateGridOption(field: string, value: unknown): void;
     updateGridRowClickAction(action: GridRowClickAction | undefined): void;
+    onGridEntityChanged(event: {
+        name: string;
+        type: 'stored_procedure' | 'table';
+    }): void;
+    onGridDataSourceParametersChanged(mappings: Record<string, unknown>): void;
     autoDetectGridColumns(): void;
     readonly expandedSections: import("@angular/core").WritableSignal<Record<string, boolean>>;
     toggleSection(section: string): void;

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

@@ -1,21 +1,33 @@
 import { DesignerViewMode } from '../../services/designer-state.service';
 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 designerState;
     private readonly templateService;
-    readonly definition: import("@angular/core").WritableSignal<import("bways-report").ReportDefinition>;
+    private readonly reportStore;
+    readonly definition: import("@angular/core").WritableSignal<ReportDefinition>;
     readonly viewMode: import("@angular/core").WritableSignal<DesignerViewMode>;
     readonly isDirty: import("@angular/core").WritableSignal<boolean>;
     readonly canUndo: import("@angular/core").Signal<boolean>;
     readonly canRedo: import("@angular/core").Signal<boolean>;
     readonly isTemplatesModalOpen: import("@angular/core").WritableSignal<boolean>;
     readonly availableBlueprints: ReportBlueprint[];
+    readonly isEditingName: import("@angular/core").WritableSignal<boolean>;
+    readonly nameDraft: import("@angular/core").WritableSignal<string>;
+    readonly reportSummaries: import("@angular/core").Signal<import("../../../../core/models/report-definition.model").ReportSummary[]>;
     readonly isLeftPanelCollapsed: import("@angular/core").InputSignal<boolean>;
     readonly isRightPanelCollapsed: import("@angular/core").InputSignal<boolean>;
     readonly toggleLeftPanel: import("@angular/core").OutputEmitterRef<void>;
     readonly toggleRightPanel: import("@angular/core").OutputEmitterRef<void>;
     readonly saveRequested: import("@angular/core").OutputEmitterRef<void>;
+    constructor();
+    startRename(): void;
+    saveRename(): void;
+    cancelRename(): void;
+    createNewReport(): void;
+    onSwitchReport(reportId: string): void;
+    private toSlug;
     setMode(mode: DesignerViewMode): void;
     undo(): void;
     redo(): void;

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

@@ -7,6 +7,9 @@ export declare class DesignerComponent implements OnInit {
     private readonly persistenceAdapter;
     private readonly dataSourceAdapter;
     private readonly sessionService;
+    private readonly dialog;
+    private readonly router;
+    private readonly reportingConfig;
     /** Optional reportId to load from persistence adapter */
     readonly reportId: import("@angular/core").InputSignal<string | undefined>;
     /** Optional definition to load directly */
@@ -36,6 +39,7 @@ export declare class DesignerComponent implements OnInit {
     constructor();
     ngOnInit(): void;
     onSave(): void;
+    private openSavedDialog;
     onPreviewExecute(event: {
         definition: ReportDefinition;
         parameters: Record<string, unknown>;

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

@@ -2,6 +2,7 @@ import { ReportDefinition } from '../../../core/models/report-definition.model';
 import { ReportComponentDefinition } from '../../../core/models/report-component.model';
 import { ComponentLayoutDefinition } from '../../../core/models/report-layout.model';
 import { ReportGridDefinition } from '../../../core/models/report-grid.model';
+import { ReportDataSourceDefinition } from '../../../core/models/report-datasource.model';
 import * as i0 from "@angular/core";
 export type DesignerViewMode = 'design' | 'preview' | 'json';
 export type DesignerActiveTab = 'properties' | 'report' | 'grid';
@@ -80,7 +81,17 @@ export declare class DesignerStateService {
     /**
      * Updates grid definition settings.
      */
-    updateGridSettings(grid: ReportGridDefinition | undefined): void;
+    updateGridSettings(grid: ReportGridDefinition | undefined, options?: {
+        skipHistory?: boolean;
+    }): void;
+    /**
+     * Sets or updates the primary data source for the report's result grid.
+     */
+    setGridDataSource(ds: ReportDataSourceDefinition): void;
+    /**
+     * Updates the parameter mappings for the primary grid data source.
+     */
+    updateGridDataSourceParameters(mappings: Record<string, unknown>): void;
     /**
      * Reverts to the previous state in history.
      */

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

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

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

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

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

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

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

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

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

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

package/lib/features/index.d.ts

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -5,6 +5,9 @@ export declare class RptGridOutletDirective implements OnDestroy {
     private readonly vcr;
     private compRef;
     private subs;
+    private lastEmittedReportState;
+    private lastEmittedColumnDefs;
+    private readonly appliedInputs;
     readonly componentType: import("@angular/core").InputSignal<Type<any> | null>;
     readonly inputs: import("@angular/core").InputSignal<Record<string, unknown>>;
     readonly gridStateChange: import("@angular/core").OutputEmitterRef<any>;
@@ -16,6 +19,9 @@ export declare class RptGridOutletDirective implements OnDestroy {
     }>;
     readonly selectionChange: import("@angular/core").OutputEmitterRef<any[]>;
     constructor();
+    private canAcceptInput;
+    private isReportStateMatching;
+    private isColumnDefsMatching;
     private recreateComponent;
     private clear;
     ngOnDestroy(): void;
@@ -98,35 +104,7 @@ export declare class ReportGridBridgeComponent {
         statusBar: boolean;
         rowClickAction?: import("../../core/models/report-grid.model").GridRowClickAction;
     }>;
-    readonly gridReportState: import("@angular/core").Signal<{
-        columnGroupDefs: null;
-        columnDefs: {
-            headerName: string;
-            header: string;
-            title: string;
-            hide: boolean;
-            width: number | undefined;
-            aggFunc: "sum" | "avg" | "count" | "min" | "max" | undefined;
-            checkboxSelection: boolean | undefined;
-            headerCheckboxSelection: boolean | undefined;
-            field: string;
-            label: string;
-            dataType?: "string" | "number" | "date" | "boolean" | "currency";
-            format?: string;
-            sortable?: boolean;
-            filterable?: boolean;
-            align?: "left" | "center" | "right";
-            visible?: boolean;
-            pinned?: "left" | "right" | false;
-            order?: number;
-            aggregate?: "sum" | "avg" | "count" | "min" | "max" | "none";
-            action?: import("../../core/models/report-grid.model").GridRowClickAction;
-        }[];
-        sortModel: any;
-        groupModel: string[];
-        activeFilters: {};
-        highlightRules: never[];
-    }>;
+    readonly gridReportState: import("@angular/core").Signal<any>;
     readonly gridInputs: import("@angular/core").Signal<{
         columns: {
             headerName: string;
@@ -200,38 +178,9 @@ export declare class ReportGridBridgeComponent {
             statusBar: boolean;
             rowClickAction?: import("../../core/models/report-grid.model").GridRowClickAction;
         };
-        reportState: {
-            columnGroupDefs: null;
-            columnDefs: {
-                headerName: string;
-                header: string;
-                title: string;
-                hide: boolean;
-                width: number | undefined;
-                aggFunc: "sum" | "avg" | "count" | "min" | "max" | undefined;
-                checkboxSelection: boolean | undefined;
-                headerCheckboxSelection: boolean | undefined;
-                field: string;
-                label: string;
-                dataType?: "string" | "number" | "date" | "boolean" | "currency";
-                format?: string;
-                sortable?: boolean;
-                filterable?: boolean;
-                align?: "left" | "center" | "right";
-                visible?: boolean;
-                pinned?: "left" | "right" | false;
-                order?: number;
-                aggregate?: "sum" | "avg" | "count" | "min" | "max" | "none";
-                action?: import("../../core/models/report-grid.model").GridRowClickAction;
-            }[];
-            sortModel: any;
-            groupModel: string[];
-            activeFilters: {};
-            highlightRules: never[];
-        };
+        reportState: any;
         pagination: boolean;
         pageSize: number;
-        rowSelection: "single" | "multiple";
     }>;
     readonly showRowNumbers: import("@angular/core").Signal<boolean>;
     readonly isPaginationEnabled: import("@angular/core").Signal<boolean>;

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

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