bways-report 0.1.6 → 0.1.7

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

@@ -0,0 +1,161 @@
+/**
+ * Simplified configuration for bways-report.
+ *
+ * This is the developer-facing config object that makes integration
+ * as simple as 3–4 endpoint URLs + optional overrides.
+ * The normalizer converts this into the internal `ReportingConfig`
+ * plus adapter wiring decisions.
+ */
+import { Type } from '@angular/core';
+import { SessionContextProvider, SessionContextSource } from '../tokens/session-context.token';
+/**
+ * Palette component category names the developer can use
+ * when restricting the designer component palette.
+ *
+ * Maps to internal registry category IDs:
+ * - `formInputs`    → `input`
+ * - `actionButtons` → `action`
+ * - `displayLabels` → `display`
+ * - `dataLookups`   → `data`
+ * - `layout`        → `layout`
+ */
+export type PaletteCategory = 'formInputs' | 'actionButtons' | 'displayLabels' | 'dataLookups' | 'layout';
+/**
+ * Mapping from friendly palette category names to internal category IDs.
+ */
+export declare const PALETTE_CATEGORY_MAP: Record<PaletteCategory, string>;
+/**
+ * Simplified, developer-facing configuration for bways-report.
+ *
+ * @example
+ * ```typescript
+ * const reportConfig: BwaysReportConfig = {
+ *   spEndpoint:      '/api/reporting/procedures',
+ *   tablesEndpoint:  '/api/reporting/tables',
+ *   executeEndpoint: '/api/reporting/execute',
+ *   reportsEndpoint: '/api/reporting/reports',
+ *   components: ['formInputs', 'actionButtons', 'displayLabels'],
+ *   autoParameter: true,
+ *   session: () => inject(AuthService).session(),
+ *   routeBase: 'reports',
+ * };
+ * ```
+ */
+export interface BwaysReportConfig {
+    /**
+     * GET endpoint returning the list of stored procedures with their parameters.
+     * Response: `[{ name, schema, parameters: [{ name, sqlType, required, defaultValue? }] }]`
+     */
+    spEndpoint: string;
+    /**
+     * GET endpoint returning the list of tables/views with their columns.
+     * Response: `[{ name, schema, type: 'table'|'view', columns: [{ name, sqlType }] }]`
+     */
+    tablesEndpoint: string;
+    /**
+     * POST endpoint that runs a stored procedure or table query and returns rows.
+     * Body: `{ kind: 'procedure'|'table', name, schema, parameters, columns?, top? }`
+     * Response: `rows[]`
+     */
+    executeEndpoint: string;
+    /**
+     * Optional POST endpoint for fetching dropdown master data and lookup options.
+     * Defaults to replacing `/execute` with `/lookup` if omitted.
+     */
+    lookupEndpoint?: string;
+    /**
+     * Optional CRUD endpoint for saving/loading report page definitions.
+     * When omitted, reports are saved to browser localStorage with a console warning.
+     * - GET    → list saved reports
+     * - GET /:id → load a specific report
+     * - POST   → save a new or updated report
+     * - DELETE /:id → delete a report
+     */
+    reportsEndpoint?: string;
+    /**
+     * Component palette groups to show in the designer.
+     * Defaults to all groups when not specified.
+     *
+     * @example ['formInputs', 'actionButtons', 'displayLabels']
+     */
+    components?: PaletteCategory[];
+    /**
+     * When true, stored procedure parameters like `@BranchId`, `@CompanyId`
+     * are automatically bound from the session context.
+     * Requires `session` to be provided.
+     *
+     * @default true
+     */
+    autoParameter?: boolean;
+    /**
+     * Session context provider for auto-parameter binding.
+     * Can be a service class implementing `SessionContextProvider`,
+     * a plain object, a factory function, an Observable, or a Signal.
+     *
+     * @example
+     * session: PlaygroundSessionService
+     * session: () => inject(AuthService).session()
+     * session: { branchId: 1, companyId: 10 }
+     */
+    session?: Type<SessionContextProvider> | SessionContextSource | (() => Record<string, unknown>);
+    /**
+     * Optional service class implementing `SessionContextProvider`.
+     * Equivalent to `session: MySessionService`.
+     */
+    sessionProvider?: Type<SessionContextProvider>;
+    /**
+     * Base path for live report pages.
+     * Generated report pages open at `/<routeBase>/<slug>`.
+     *
+     * @default 'reports'
+     */
+    routeBase?: string;
+    /**
+     * Optional Angular component for rendering data grids.
+     * Pass your grid component (BWays-grid, AG Grid wrapper, etc.).
+     */
+    grid?: Type<unknown>;
+    /**
+     * Optional Angular component for rendering charts.
+     */
+    chart?: Type<unknown>;
+    /** Default page size for grid results. @default 25 */
+    defaultPageSize?: number;
+    /** Date format string used across the library. @default 'dd/MM/yyyy' */
+    dateFormat?: string;
+    /** Timeout in ms for lookup/execute queries. @default 300000 */
+    lookupTimeoutMs?: number;
+}
+/**
+ * Result of normalizing a `BwaysReportConfig` for internal use.
+ */
+export interface NormalizedBwaysConfig {
+    /** Endpoint URLs */
+    spEndpoint: string;
+    tablesEndpoint: string;
+    executeEndpoint: string;
+    lookupEndpoint: string | null;
+    reportsEndpoint: string | null;
+    /** Resolved internal category IDs (e.g. ['input', 'action', 'display']) */
+    allowedCategories: string[] | null;
+    /** Whether auto-parameter binding is enabled */
+    autoParameter: boolean;
+    /** Route base path */
+    routeBase: string;
+    /** Session source */
+    session: Type<SessionContextProvider> | SessionContextSource | (() => Record<string, unknown>) | null;
+    sessionProvider: Type<SessionContextProvider> | null;
+    /** Grid component */
+    gridComponent: Type<unknown> | null;
+    /** Chart component */
+    chartComponent: Type<unknown> | null;
+    /** General config values */
+    defaultPageSize: number;
+    dateFormat: string;
+    lookupTimeoutMs: number;
+}
+/**
+ * Normalizes a `BwaysReportConfig` into the internal format.
+ * Validates required fields and maps friendly names to internal IDs.
+ */
+export declare function normalizeBwaysConfig(config: BwaysReportConfig): NormalizedBwaysConfig;

package/lib/core/index.d.ts

@@ -1,3 +1,4 @@
+export * from './config/bways-report-config';
 export * from './models';
 export * from './registry';
 export * from './tokens';

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

@@ -37,6 +37,14 @@ export interface ReportSummary {
     description?: string;
     /** Category or group for organizing reports. */
     category?: string;
+    /** URL-friendly slug for routing. */
+    slug?: string;
+    /** Menu group for organizing reports in navigation. */
+    menuGroup?: string;
+    /** Sort order within the menu group. */
+    menuOrder?: number;
+    /** Optional icon name. */
+    icon?: string;
     /** Current version number. */
     version: number;
     /** Whether the report is published (vs. draft). */
@@ -91,6 +99,14 @@ export interface ReportDefinition {
     grid?: ReportGridDefinition;
     /** Access control settings. */
     permissions?: ReportPermissionDefinition;
+    /** URL-friendly slug for routing (e.g. 'sale-report'). Auto-generated from name if not set. */
+    slug?: string;
+    /** Menu group for organizing reports in the sidebar (e.g. 'Sales', 'Finance'). */
+    menuGroup?: string;
+    /** Sort order within the menu group. Lower numbers appear first. */
+    menuOrder?: number;
+    /** Optional icon name for menu display. */
+    icon?: string;
     /** Custom metadata for host-specific extensions. */
     metadata?: Record<string, unknown>;
     /** ISO date of creation. */

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

@@ -27,6 +27,7 @@ export interface DerivedParametersResult {
 export declare class ReportSessionContextService implements OnDestroy {
     private readonly rawSource;
     private readonly sessionProvider;
+    private readonly reportingConfig;
     /** Internal manual runtime session overrides (e.g. set via setSessionContext or setSessionParameter) */
     private readonly manualRuntimeContext;
     private readonly latestObservableValue;

package/lib/core/tokens/reporting-config.token.d.ts

@@ -23,6 +23,22 @@ export interface ReportingConfig {
     enableSchemaDiscovery?: boolean;
     /** Optional timeout in milliseconds for dropdown lookup queries (defaults to 300000ms / 5 minutes). */
     lookupTimeoutMs?: number;
+    /**
+     * Internal category IDs to show in the designer palette.
+     * When null/undefined, all categories are shown.
+     * Set by the BwaysReportConfig normalizer from friendly names.
+     */
+    allowedCategories?: string[] | null;
+    /**
+     * Whether to auto-bind SP parameters from the session context.
+     * @default true
+     */
+    autoParameter?: boolean;
+    /**
+     * Base route path for live report pages.
+     * @default 'reports'
+     */
+    routeBase?: string;
 }
 /**
  * Injection token for the grid component.

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

@@ -13,3 +13,13 @@ export declare function extractRowArray<T = unknown>(response: unknown): T[];
  * Searches for exact match first, then lower-cased match, then normalized (ignoring underscores/dashes).
  */
 export declare function getFieldCaseInsensitive(record: Record<string, unknown> | null | undefined, targetKey: string): unknown;
+export interface NormalizedLookupOption {
+    value: string | number;
+    label: string;
+    raw?: Record<string, unknown>;
+}
+/**
+ * Normalizes an arbitrary database record into a standardized { value, label, raw } option item.
+ * Supports case-insensitive field matching and intelligent heuristics for SQL Server columns.
+ */
+export declare function extractLookupOptionItem(row: unknown, valueField?: string, displayField?: string): NormalizedLookupOption;

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

@@ -8,13 +8,30 @@ export declare function resolveContextPreset(key: string): string;
  * and compound date ranges (e.g. dateRange.from, dateRange_from, dateRangeFrom).
  */
 export declare function resolveCanvasFieldValue(formValues: Record<string, unknown>, inner: string): unknown;
+/**
+ * Sanitizes T-SQL parameter literals copied from SSMS, profilers, or SQL scripts:
+ * - Strips outer double quotes: "..."
+ * - Strips outer T-SQL quotes: N'...' or '...'
+ * - Unescapes doubled single quotes: '' -> '
+ */
+export declare function sanitizeSqlParamLiteral(val: unknown): unknown;
+export interface ParsedSqlExec {
+    procedureName?: string;
+    parameters: Record<string, string | number | boolean>;
+}
+/**
+ * Parses an SSMS / T-SQL EXEC statement such as:
+ * exec Get_HelpList @chrCOMPANYID=N'101',@chrTableName=N'MSTACCTGLSUB',@intExecFlag=1
+ * Extracts procedure name and unescapes parameter values.
+ */
+export declare function parseSqlExecStatement(sql: string): ParsedSqlExec | null;
 /**
  * Resolves one raw mapping value against session + canvas form values.
  * - `{{session.branchId}}`  -> session value (case-insensitive)
  * - `{{context.today}}`     -> computed date
  * - `{{fromDate}}`          -> value of canvas field with key `fromDate` (case-insensitive)
  * - `{{dateRange.from}}`    -> value of nested from property
- * - anything else           -> returned unchanged (fixed value)
+ * - anything else           -> sanitized literal value (fixed value)
  */
 export declare function resolveParameterValue(raw: unknown, session: Record<string, unknown>, formValues: Record<string, unknown>): unknown;
 /** Resolves every mapping into concrete values (de-duplicating `@name` / `name`). */

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

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

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

@@ -0,0 +1,14 @@
+import { Observable } from 'rxjs';
+import { LookupOptionItem, LookupQueryRequest, ReportLookupAdapter } from '../contracts/lookup.contract';
+import * as i0 from "@angular/core";
+export declare class EndpointLookupAdapter extends ReportLookupAdapter {
+    private readonly http;
+    private readonly endpoints;
+    private readonly sessionService;
+    private readonly cache;
+    private readonly inFlight;
+    fetchOptions(request: LookupQueryRequest): Observable<LookupOptionItem[]>;
+    private generateCacheKey;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EndpointLookupAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EndpointLookupAdapter>;
+}

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

@@ -0,0 +1,11 @@
+import { Observable } from 'rxjs';
+import { MasterDataItem, MasterDataOptions, MasterDataProvider } from '../contracts/master-data.provider';
+import * as i0 from "@angular/core";
+export declare class EndpointMasterDataAdapter extends MasterDataProvider {
+    private readonly http;
+    private readonly endpoints;
+    private readonly sessionService;
+    getMasterData(masterName: string, options?: MasterDataOptions): Observable<MasterDataItem[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EndpointMasterDataAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EndpointMasterDataAdapter>;
+}

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

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

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

@@ -0,0 +1,21 @@
+import { Observable } from 'rxjs';
+import { DatabaseEntityMetadata, DatabaseEntityType, EntityColumnMetadata, ProcedureParameterMetadata, ReportSchemaDiscoveryAdapter } from '../contracts/schema-discovery.contract';
+import * as i0 from "@angular/core";
+export declare class EndpointSchemaDiscoveryAdapter extends ReportSchemaDiscoveryAdapter {
+    private readonly http;
+    private readonly endpoints;
+    /** Cached list responses so we don't re-fetch on every getColumns/getParameters call */
+    private spCache$;
+    private tableCache$;
+    private spItems;
+    private tableItems;
+    getEntities(types?: DatabaseEntityType[]): Observable<DatabaseEntityMetadata[]>;
+    getColumns(entityName: string, schema?: string, type?: DatabaseEntityType): Observable<EntityColumnMetadata[]>;
+    getParameters(entityName: string, schema?: string): Observable<ProcedureParameterMetadata[]>;
+    /** Fetch and cache the SP list from the endpoint */
+    private fetchSps;
+    /** Fetch and cache the tables list from the endpoint */
+    private fetchTables;
+    static ɵfac: i0.ɵɵFactoryDeclaration<EndpointSchemaDiscoveryAdapter, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<EndpointSchemaDiscoveryAdapter>;
+}

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

@@ -0,0 +1,21 @@
+/**
+ * Injection tokens for the endpoint-based adapter configuration.
+ *
+ * When the developer uses `BwaysReportConfig` (simple config), these tokens
+ * are populated with the endpoint URLs so adapters can inject them.
+ */
+import { InjectionToken } from '@angular/core';
+/**
+ * Endpoint URLs used by the endpoint-based adapters.
+ */
+export interface BwaysReportEndpoints {
+    spEndpoint: string;
+    tablesEndpoint: string;
+    executeEndpoint: string;
+    lookupEndpoint?: string | null;
+    reportsEndpoint: string | null;
+}
+/**
+ * Injection token for the endpoint URLs.
+ */
+export declare const BWAYS_REPORT_ENDPOINTS: InjectionToken<BwaysReportEndpoints>;

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

@@ -5,3 +5,10 @@ export { HttpReportPersistenceAdapter, HttpPersistenceAdapter, } from './http-pe
 export { HttpMasterDataAdapter, } from './http-masterdata.adapter';
 export { LocalStorageReportPersistenceAdapter, } from './local-storage-persistence.adapter';
 export { MockReportDataSourceAdapter, } from './mock-datasource.adapter';
+export { EndpointSchemaDiscoveryAdapter } from './endpoint-schema-discovery.adapter';
+export { EndpointDataSourceAdapter } from './endpoint-datasource.adapter';
+export { EndpointLookupAdapter } from './endpoint-lookup.adapter';
+export { EndpointPersistenceAdapter } from './endpoint-persistence.adapter';
+export { EndpointMasterDataAdapter } from './endpoint-masterdata.adapter';
+export { BWAYS_REPORT_ENDPOINTS } from './endpoint-tokens';
+export type { BwaysReportEndpoints } from './endpoint-tokens';

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

@@ -7,8 +7,8 @@ export interface LookupQueryRequest {
     sourceType: DropdownSourceType;
     entityName?: string;
     schema?: string;
-    valueField: string;
-    displayField: string;
+    valueField?: string;
+    displayField?: string;
     filter?: Record<string, unknown>;
     parameters?: Record<string, unknown>;
     limit?: number;

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

@@ -3,6 +3,7 @@ import * as i0 from "@angular/core";
 export declare class ComponentPaletteComponent {
     private readonly registry;
     private readonly designerState;
+    private readonly reportingConfig;
     readonly collapseRequested: import("@angular/core").OutputEmitterRef<void>;
     readonly searchQuery: import("@angular/core").WritableSignal<string>;
     /** Layout view mode: 'grid' (2-column side-by-side grid) or 'list' (compact row list). Defaults to 'grid'. */

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

@@ -20,7 +20,7 @@ export declare class DesignCanvasComponent implements OnDestroy {
     readonly highlightedFieldKeys: import("@angular/core").WritableSignal<Set<string>>;
     readonly layoutJustUpdated: import("@angular/core").WritableSignal<boolean>;
     isFieldHighlighted(comp: ReportComponentDefinition): boolean;
-    onControlInteract(comp: ReportComponentDefinition, event: Event): void;
+    onControlInteract(comp: ReportComponentDefinition, event?: Event): void;
     getGridSummaryText(): string;
     highlightMissingFields(fields: string[]): void;
     readonly canvasGridData: import("@angular/core").WritableSignal<unknown[]>;

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

@@ -0,0 +1,34 @@
+import { ReportDefinition } from '../../../../core/models/report-definition.model';
+import * as i0 from "@angular/core";
+export interface ReportSavedDialogData {
+    report: ReportDefinition;
+    routeBase?: string;
+}
+export interface ReportSavedDialogResult {
+    action: 'back_to_designer' | 'open_live_page';
+    report: ReportDefinition;
+}
+export declare class ReportSavedDialogComponent {
+    private readonly dialogRef;
+    private readonly data;
+    private readonly store;
+    private readonly reportingConfig;
+    private readonly router;
+    readonly report: ReportDefinition;
+    readonly baseRoute: import("@angular/core").WritableSignal<string>;
+    readonly name: 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 fullRoute: import("@angular/core").Signal<string>;
+    readonly currentPreviewDef: import("@angular/core").Signal<ReportDefinition>;
+    onNameChange(newName: string): void;
+    copyRoute(): void;
+    saveUpdatedDefinition(): ReportDefinition;
+    close(action?: 'back_to_designer' | 'open_live_page'): void;
+    openLivePage(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReportSavedDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ReportSavedDialogComponent, "rpt-report-saved-dialog", never, {}, {}, never, never, true, never>;
+}

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

@@ -31,6 +31,7 @@ export declare class ParameterBindingEditorComponent {
     readonly selectedControlKey: import("@angular/core").Signal<string>;
     readonly selectedContextKey: import("@angular/core").Signal<string>;
     readonly booleanFixedValue: import("@angular/core").Signal<boolean>;
+    readonly isLongTextInput: import("@angular/core").Signal<boolean>;
     setMode(mode: ParameterBindingMode): void;
     onControlSelected(key: string): void;
     onBooleanChanged(checked: boolean): void;

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

@@ -1,15 +1,19 @@
-import { OnInit } from '@angular/core';
+import { OnDestroy, OnInit } 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';
 import * as i0 from "@angular/core";
 export interface StaticOptionItem {
     key: string;
     label: string;
 }
-export declare class PropertyEditorDatasourceComponent implements OnInit {
+export declare class PropertyEditorDatasourceComponent implements OnInit, OnDestroy {
     private readonly discoveryAdapter;
     private readonly sessionService;
     private readonly designerState;
+    private lastLoadedKey;
+    private columnsSub?;
+    private paramsSub?;
     readonly comp: import("@angular/core").InputSignal<ReportComponentDefinition>;
     readonly allComponents: import("@angular/core").InputSignal<ReportComponentDefinition[]>;
     readonly updateDataSource: import("@angular/core").OutputEmitterRef<ComponentDataSourceDefinition>;
@@ -47,8 +51,14 @@ export declare class PropertyEditorDatasourceComponent implements OnInit {
     }[]>;
     readonly availableParentFields: import("@angular/core").Signal<ReportComponentDefinition[]>;
     readonly staticOptions: import("@angular/core").Signal<StaticOptionItem[]>;
+    readonly procedureSelectOptions: import("@angular/core").Signal<SearchableSelectOption<any>[]>;
+    readonly tableSelectOptions: import("@angular/core").Signal<SearchableSelectOption<any>[]>;
+    readonly displayFieldSelectOptions: import("@angular/core").Signal<SearchableSelectOption<any>[]>;
+    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;
     /**

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

@@ -2,6 +2,7 @@ import { GridColumnDefinition, GridRowClickAction, ReportGridDefinition } from '
 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;
@@ -37,12 +38,21 @@ export declare class PropertyEditorGridComponent {
     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>;

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/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>;
+}