angular-my-report 0.1.0 → 0.1.1

package/lib/ui/designer/canvas.component.d.ts

@@ -0,0 +1,41 @@
+import type { Band, ReportElement } from '../../model/types';
+import { type FieldRef } from '../../model/factories';
+import { DesignerStore } from '../designer.store';
+import * as i0 from "@angular/core";
+export declare const DRAG_MIME = "application/x-report-item";
+export type DragPayload = {
+    kind: 'text' | 'line' | 'rect' | 'image';
+} | {
+    kind: 'table' | 'chart' | 'barcode' | 'qrcode' | 'crosstab';
+    fields: FieldRef[];
+} | {
+    kind: 'field';
+    field: string;
+    type?: string;
+    template?: string;
+};
+type DragMode = 'move' | 'e' | 's' | 'se';
+/** Builds the element a toolbox/field drop creates, adjusted for the target band. */
+export declare function elementFromPayload(p: DragPayload, band: Band, x: number, y: number, width: number): ReportElement;
+export declare class CanvasComponent {
+    protected readonly store: DesignerStore;
+    protected readonly labels: Record<import("angular-my-report").BandType, string>;
+    protected readonly titleHeight = 20;
+    protected readonly width: import("@angular/core").Signal<number>;
+    protected readonly bands: import("@angular/core").Signal<Band[]>;
+    protected readonly totalHeight: import("@angular/core").Signal<number>;
+    protected isSelected(el: ReportElement): boolean;
+    protected isBandSelected(band: Band): boolean;
+    protected groupField(band: Band): string | null;
+    protected onBackgroundDown(e: PointerEvent): void;
+    protected onBodyDown(e: PointerEvent, band: Band): void;
+    protected onDragOver(e: DragEvent): void;
+    protected onDrop(e: DragEvent, band: Band): void;
+    protected startBandResize(e: PointerEvent, band: Band): void;
+    protected onElementDown(e: PointerEvent, el: ReportElement, band: Band): void;
+    protected onHandleDown(e: PointerEvent, el: ReportElement, band: Band, mode: DragMode): void;
+    private beginDrag;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CanvasComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CanvasComponent, "rpt-canvas", never, {}, {}, never, never, true, never>;
+}
+export {};

package/lib/ui/designer/data-source-dialog.component.d.ts

@@ -0,0 +1,37 @@
+import type { DataSourceDef } from '../../model/types';
+import { type LoadResult } from '../../engine/dataSources';
+import * as i0 from "@angular/core";
+export declare class DataSourceDialogComponent {
+    private readonly store;
+    readonly closed: import("@angular/core").OutputEmitterRef<void>;
+    /** Working copy, edited with two-way binding and applied on "Apply". */
+    protected ds: DataSourceDef;
+    protected readonly busy: import("@angular/core").WritableSignal<boolean>;
+    protected readonly result: import("@angular/core").WritableSignal<LoadResult | null>;
+    protected readonly error: import("@angular/core").WritableSignal<string>;
+    protected readonly sets: import("@angular/core").WritableSignal<string[]>;
+    protected readonly setsMsg: import("@angular/core").WritableSignal<string>;
+    private readonly cdr;
+    /**
+     * Closes when clicking outside the dialog. Must return nothing: an Angular event handler that
+     * returns `false` calls preventDefault(), which would stop clicks from focusing the inputs.
+     */
+    protected onBackdropDown(e: PointerEvent): void;
+    protected readonly detecting: import("@angular/core").WritableSignal<boolean>;
+    protected readonly detectMsg: import("@angular/core").WritableSignal<{
+        text: string;
+        error: boolean;
+    } | null>;
+    /** Pasting a URL into the URL field configures the source straight away. */
+    protected onPaste(e: ClipboardEvent): void;
+    /** Fetches the URL, decides JSON vs OData, fills in the whole form and tests it. */
+    protected detect(): Promise<void>;
+    protected odataUrl(): string;
+    protected fieldSummary(res: LoadResult): string;
+    private normalized;
+    protected runTest(): Promise<void>;
+    protected fetchSets(): Promise<void>;
+    protected apply(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DataSourceDialogComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<DataSourceDialogComponent, "rpt-data-source-dialog", never, {}, { "closed": "closed"; }, never, never, true, never>;
+}

package/lib/ui/designer/element-box.component.d.ts

@@ -0,0 +1,32 @@
+import { type Row } from '../../engine/expressions';
+import type { ReportElement } from '../../model/types';
+import { type TableRenderData } from './table-view.component';
+import * as i0 from "@angular/core";
+/** Draws one report element. Used by both the designer canvas and the preview. */
+export declare class ElementBoxComponent {
+    readonly el: import("@angular/core").InputSignal<ReportElement>;
+    readonly content: import("@angular/core").InputSignal<string>;
+    readonly design: import("@angular/core").InputSignal<boolean>;
+    /** Overrides for grown/shifted elements in the preview. */
+    readonly top: import("@angular/core").InputSignal<number | undefined>;
+    readonly height: import("@angular/core").InputSignal<number | undefined>;
+    /** Rows to draw for a table; omitted in the designer (templates are shown). */
+    readonly tableData: import("@angular/core").InputSignal<TableRenderData | undefined>;
+    /** Rows for a chart / cross table in the preview (its band's scope). */
+    readonly rows: import("@angular/core").InputSignal<Row[] | undefined>;
+    private readonly store;
+    readonly designData: import("@angular/core").Signal<TableRenderData>;
+    /** In the designer, charts and cross tables show the loaded data. */
+    readonly chartRows: import("@angular/core").Signal<Row[]>;
+    readonly crosstab: import("@angular/core").Signal<{
+        table: ReportElement;
+        data: Row[];
+        render: TableRenderData;
+    } | null>;
+    /** Barcode/QR value: the evaluated text in the preview; in the designer, evaluated on the first data row. */
+    readonly codeValue: import("@angular/core").Signal<string>;
+    readonly hostStyle: import("@angular/core").Signal<string>;
+    readonly lineStyle: import("@angular/core").Signal<string>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ElementBoxComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ElementBoxComponent, "rpt-element", never, { "el": { "alias": "el"; "required": true; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; "design": { "alias": "design"; "required": false; "isSignal": true; }; "top": { "alias": "top"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "tableData": { "alias": "tableData"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
+}

package/lib/ui/designer/graphics.components.d.ts

@@ -0,0 +1,36 @@
+import type { ReportElement } from '../../model/types';
+import type { Row } from '../../engine/expressions';
+import * as i0 from "@angular/core";
+/** Chart element: SVG drawn from the engine's layout primitives. Marks carry a hover tooltip. */
+export declare class ChartViewComponent {
+    readonly el: import("@angular/core").InputSignal<ReportElement>;
+    readonly rows: import("@angular/core").InputSignal<Row[]>;
+    readonly prims: import("@angular/core").Signal<import("../../engine/chartLayout").Prim[]>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ChartViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ChartViewComponent, "rpt-chart-view", never, { "el": { "alias": "el"; "required": true; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/** Barcode element (Code 128 / EAN-13): bars as one crisp SVG path, optional human-readable text. */
+export declare class BarcodeViewComponent {
+    readonly el: import("@angular/core").InputSignal<ReportElement>;
+    readonly value: import("@angular/core").InputSignal<string>;
+    readonly color: import("@angular/core").Signal<string>;
+    readonly model: import("@angular/core").Signal<{
+        error: string;
+        d: string;
+        text: string;
+        showText: boolean;
+    }>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BarcodeViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BarcodeViewComponent, "rpt-barcode-view", never, { "el": { "alias": "el"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/** QR code element: dark modules as one SVG path, centred, with a 4-module quiet zone. */
+export declare class QrViewComponent {
+    readonly el: import("@angular/core").InputSignal<ReportElement>;
+    readonly value: import("@angular/core").InputSignal<string>;
+    readonly model: import("@angular/core").Signal<{
+        error: string;
+        d: string;
+    }>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<QrViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<QrViewComponent, "rpt-qr-view", never, { "el": { "alias": "el"; "required": true; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/lib/ui/designer/left-panel.component.d.ts

@@ -0,0 +1,37 @@
+import { DesignerStore } from '../designer.store';
+import { type DragPayload } from './canvas.component';
+import * as i0 from "@angular/core";
+type DataToolKind = 'table' | 'chart' | 'crosstab' | 'barcode' | 'qrcode';
+export declare class LeftPanelComponent {
+    protected readonly store: DesignerStore;
+    readonly openDataSource: import("@angular/core").OutputEmitterRef<void>;
+    readonly openBandedTable: import("@angular/core").OutputEmitterRef<void>;
+    protected readonly dataTools: {
+        kind: DataToolKind;
+        label: string;
+        icon: string;
+        hint: string;
+    }[];
+    protected readonly tools: {
+        kind: "text" | "line" | "rect" | "image";
+        label: string;
+        icon: string;
+    }[];
+    protected readonly specials: {
+        label: string;
+        template: string;
+    }[];
+    protected readonly typeIcon: Record<string, string>;
+    protected readonly data: import("@angular/core").WritableSignal<import("../designer.store").DataState>;
+    protected readonly params: import("@angular/core").Signal<import("angular-my-report").ReportParameter[]>;
+    protected readonly ds: import("@angular/core").Signal<import("angular-my-report").DataSourceDef>;
+    protected readonly dsLabel: import("@angular/core").Signal<string>;
+    /** Toolbox items that are pre-configured from the current data fields. */
+    protected dataPayload(kind: DataToolKind): DragPayload;
+    protected dragStart(e: DragEvent, payload: DragPayload): void;
+    /** Click / double-click: add to the selected band (or Detail) at the top-left. */
+    protected add(payload: DragPayload): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<LeftPanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<LeftPanelComponent, "rpt-left-panel", never, {}, { "openDataSource": "openDataSource"; "openBandedTable": "openBandedTable"; }, never, never, true, never>;
+}
+export {};

package/lib/ui/designer/safe-image.pipe.d.ts

@@ -0,0 +1,13 @@
+import { PipeTransform } from '@angular/core';
+import { type SafeUrl } from '@angular/platform-browser';
+import * as i0 from "@angular/core";
+/**
+ * Image source for <img [src]>. Angular's sanitizer rejects some data: images (e.g. SVG); uploads
+ * are embedded as data:image/… URLs, so those are trusted here. An <img> never runs scripts.
+ */
+export declare class SafeImagePipe implements PipeTransform {
+    private readonly sanitizer;
+    transform(url: string | null | undefined): SafeUrl | string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SafeImagePipe, never>;
+    static ɵpipe: i0.ɵɵPipeDeclaration<SafeImagePipe, "safeImage", true>;
+}

package/lib/ui/designer/table-view.component.d.ts

@@ -0,0 +1,19 @@
+import type { ReportElement } from '../../model/types';
+import { type TableRenderData } from '../../engine/table';
+import * as i0 from "@angular/core";
+export type { TableRenderData };
+/** Data for drawing a table in the designer: the column templates themselves. */
+export declare function designTableData(el: ReportElement): TableRenderData;
+/** Draws the inside of a table element (fills its parent box). Shared by designer and preview. */
+export declare class TableViewComponent {
+    readonly el: import("@angular/core").InputSignal<ReportElement>;
+    readonly data: import("@angular/core").InputSignal<TableRenderData>;
+    private readonly line;
+    readonly hostStyle: import("@angular/core").Signal<string>;
+    readonly cellStyles: import("@angular/core").Signal<string[]>;
+    readonly headerRowStyle: import("@angular/core").Signal<string>;
+    readonly footerRowStyle: import("@angular/core").Signal<string>;
+    rowStyle(index: number, height: number): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<TableViewComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<TableViewComponent, "rpt-table-view", never, { "el": { "alias": "el"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}

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

@@ -0,0 +1,59 @@
+import type { DataSourceType, ReportDefinition } from '../model/types';
+import { DesignerStore } from './designer.store';
+import * as i0 from "@angular/core";
+/**
+ * The report designer.
+ *
+ * ```html
+ * <myreport-designer path="/reports/sales.report.json" (save)="store($event)" />
+ * ```
+ */
+export declare class MyReportDesignerComponent {
+    protected readonly store: DesignerStore;
+    private readonly host;
+    /** URL of a .report.json to open. */
+    readonly path: import("@angular/core").InputSignal<string | null | undefined>;
+    /** A report definition to open (object or JSON string); used when `path` is empty. */
+    readonly report: import("@angular/core").InputSignal<string | ReportDefinition | null | undefined>;
+    /** Replaces the report's data source while designing: a URL, a JSON string, or the data itself. */
+    readonly datasource: import("@angular/core").InputSignal<unknown>;
+    /** How `datasource` is read: `json` (default) or `odata`. */
+    readonly type: import("@angular/core").InputSignal<DataSourceType | null | undefined>;
+    /** Parameter values (object, JSON string or query string `a=1&b=2`). */
+    readonly params: import("@angular/core").InputSignal<string | Record<string, unknown> | null | undefined>;
+    /** localStorage key to autosave the report to (and restore from when no path/report is given). */
+    readonly persistKey: import("@angular/core").InputSignal<string | null | undefined>;
+    /** Shows a "Viewer ↗" link in the toolbar pointing at this URL. */
+    readonly viewerUrl: import("@angular/core").InputSignal<string | null | undefined>;
+    /** Save downloads a .report.json file (default true). The `save` event fires either way. */
+    readonly download: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+    /** Toolbar title. */
+    readonly brand: import("@angular/core").InputSignal<string | null | undefined>;
+    /** Fires with the report when the user clicks Save. */
+    readonly save: import("@angular/core").OutputEmitterRef<ReportDefinition>;
+    /** Fires with the report after every change. */
+    readonly reportChange: import("@angular/core").OutputEmitterRef<ReportDefinition>;
+    /** Fires with the report after it was loaded from `path`. */
+    readonly loaded: import("@angular/core").OutputEmitterRef<ReportDefinition>;
+    /** Fires with a message when `path` could not be loaded. */
+    readonly loadError: import("@angular/core").OutputEmitterRef<string>;
+    protected readonly status: import("@angular/core").WritableSignal<{
+        text: string;
+        error?: boolean;
+    } | null>;
+    protected readonly showData: import("@angular/core").WritableSignal<boolean>;
+    protected readonly showPreview: import("@angular/core").WritableSignal<boolean>;
+    protected readonly showBanded: import("@angular/core").WritableSignal<boolean>;
+    protected readonly zooms: number[];
+    private clipboard;
+    constructor();
+    /** Starts a new report from a template (the select resets itself to "New ▾"). */
+    protected newFrom(kind: string): void;
+    protected saveReport(): void;
+    protected open(e: Event): Promise<void>;
+    /** Keys belong to the designer only when focus is inside it (or nowhere in particular). */
+    private ownsKey;
+    protected onKey(e: KeyboardEvent): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MyReportDesignerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MyReportDesignerComponent, "myreport-designer", never, { "path": { "alias": "path"; "required": false; "isSignal": true; }; "report": { "alias": "report"; "required": false; "isSignal": true; }; "datasource": { "alias": "datasource"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "params": { "alias": "params"; "required": false; "isSignal": true; }; "persistKey": { "alias": "persistKey"; "required": false; "isSignal": true; }; "viewerUrl": { "alias": "viewerUrl"; "required": false; "isSignal": true; }; "download": { "alias": "download"; "required": false; "isSignal": true; }; "brand": { "alias": "brand"; "required": false; "isSignal": true; }; }, { "save": "save"; "reportChange": "reportChange"; "loaded": "loaded"; "loadError": "loadError"; }, never, never, true, never>;
+}

package/lib/ui/designer.store.d.ts

@@ -0,0 +1,82 @@
+import type { Band, DataSourceDef, DataSourceType, ReportDefinition, ReportElement } from '../model/types';
+import { type FieldInfo } from '../engine/dataSources';
+import { type Row } from '../engine/expressions';
+import * as i0 from "@angular/core";
+export interface Selection {
+    elementIds: string[];
+    bandId: string | null;
+}
+export interface DataState {
+    rows: Row[];
+    /** The whole loaded document (root.x in formulas) and its scalar fields. */
+    root?: unknown;
+    docFields?: {
+        name: string;
+        type: string;
+    }[];
+    fields: FieldInfo[];
+    status: 'idle' | 'loading' | 'ready' | 'error';
+    error?: string;
+}
+export declare const GRID = 8;
+/**
+ * Data the host page supplies instead of the report's own data source:
+ * a URL (JSON file/API, or OData service / entity-set URL), a JSON string, or the data itself.
+ */
+export interface DataOverride {
+    source: unknown;
+    type: DataSourceType;
+}
+/** Applies a host-supplied data source on top of the report's data source definition. */
+export declare function overrideDataSource(ds: DataSourceDef, o: DataOverride | null): DataSourceDef;
+export declare function findElement(r: ReportDefinition, id: string): {
+    band: Band;
+    el: ReportElement;
+} | null;
+/**
+ * All designer/viewer state: the report (with undo/redo), selection, view options and loaded data.
+ * Provided per component (myreport-designer / myreport-viewer), so several can live on one page.
+ */
+export declare class DesignerStore {
+    readonly report: import("@angular/core").WritableSignal<ReportDefinition>;
+    readonly selection: import("@angular/core").WritableSignal<Selection>;
+    readonly zoom: import("@angular/core").WritableSignal<number>;
+    readonly snap: import("@angular/core").WritableSignal<boolean>;
+    readonly data: import("@angular/core").WritableSignal<DataState>;
+    /** localStorage key the report is autosaved to; null = no autosave. */
+    readonly persistKey: import("@angular/core").WritableSignal<string | null>;
+    /** Data supplied by the host page, replacing the report's data source. */
+    readonly dataOverride: import("@angular/core").WritableSignal<DataOverride | null>;
+    /** Parameter values supplied by the host page (below values typed in the parameter bar). */
+    readonly externalParams: import("@angular/core").WritableSignal<Record<string, unknown>>;
+    private readonly past;
+    private readonly future;
+    readonly canUndo: import("@angular/core").Signal<boolean>;
+    readonly canRedo: import("@angular/core").Signal<boolean>;
+    private readonly reloadToken;
+    /** Values typed in the preview's parameter bar (raw text), on top of host values and defaults. */
+    readonly paramInput: import("@angular/core").WritableSignal<Record<string, unknown>>;
+    /** Effective, typed parameter values. */
+    readonly params: import("@angular/core").Signal<import("../engine/parameters").ParamValues>;
+    /** The data source actually used: the report's own, or the host's override. */
+    readonly effectiveDataSource: import("@angular/core").Signal<DataSourceDef>;
+    /** Data source with {@Param} placeholders filled in; reloads when they change. */
+    private readonly dsKey;
+    constructor();
+    /** Applies a change to a copy of the report. `history=false` for live drag updates (after `checkpoint()`). */
+    update(recipe: (r: ReportDefinition) => void, history?: boolean): void;
+    checkpoint(): void;
+    undo(): void;
+    redo(): void;
+    load(r: ReportDefinition): void;
+    /** Loads the report autosaved under `key` (if any) and keeps autosaving there. */
+    restore(key: string): boolean;
+    select(s: Selection): void;
+    snapValue(v: number): number;
+    reloadData(): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<DesignerStore, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<DesignerStore>;
+}
+/** Fetches a .report.json and checks it looks like a report definition. */
+export declare function fetchReport(path: string, signal?: AbortSignal): Promise<ReportDefinition>;
+export declare function validateReport(r: unknown): ReportDefinition;

package/lib/ui/inputs.d.ts

@@ -0,0 +1,8 @@
+import type { ReportDefinition } from '../model/types';
+/**
+ * Normalizes a report given as an object or a JSON string (Web Component attributes are strings).
+ * Returns null when nothing usable was given.
+ */
+export declare function parseReport(v: ReportDefinition | string | null | undefined): ReportDefinition | null;
+/** Parameter values as an object, a JSON string, or a query string ("Country=Egypt&Year=2024"). */
+export declare function parseParams(v: Record<string, unknown> | string | null | undefined): Record<string, unknown>;

package/lib/ui/properties/band-props.component.d.ts

@@ -0,0 +1,15 @@
+import * as i0 from "@angular/core";
+export declare class BandPropsComponent {
+    private readonly store;
+    readonly bandId: import("@angular/core").InputSignal<string>;
+    protected readonly labels: Record<import("angular-my-report").BandType, string>;
+    protected readonly band: import("@angular/core").Signal<import("angular-my-report").Band | undefined>;
+    protected readonly group: import("@angular/core").Signal<import("angular-my-report").Group | undefined>;
+    protected setHeight(v: number | null): void;
+    /** Removes the section from the report (kept hidden with its elements, so it can be shown again). */
+    protected hide(id: string): void;
+    protected setGroup(k: 'field' | 'direction', v: string): void;
+    protected removeGroup(gid: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BandPropsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BandPropsComponent, "rpt-band-props", never, { "bandId": { "alias": "bandId"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/lib/ui/properties/element-props.component.d.ts

@@ -0,0 +1,46 @@
+import type { ElementStyle, FormatKind, ReportElement, StyleRule } from '../../model/types';
+import * as i0 from "@angular/core";
+export declare const FORMAT_KINDS: FormatKind[];
+export declare class ElementPropsComponent {
+    private readonly store;
+    readonly el: import("@angular/core").InputSignal<ReportElement>;
+    readonly count: import("@angular/core").InputSignal<number>;
+    protected readonly formatKinds: FormatKind[];
+    protected readonly numericFormats: string[];
+    protected readonly aggregates: string;
+    protected readonly isText: import("@angular/core").Signal<boolean>;
+    protected readonly isTable: import("@angular/core").Signal<boolean>;
+    protected readonly isCode: import("@angular/core").Signal<boolean>;
+    /** Elements that draw text with the element font (beyond labels/fields/tables). */
+    protected readonly hasFont: import("@angular/core").Signal<boolean>;
+    protected readonly title: import("@angular/core").Signal<string>;
+    private readonly width;
+    protected readonly setX: (v: number) => (e: ReportElement) => number;
+    protected readonly setY: (v: number) => (e: ReportElement) => number;
+    protected readonly setW: (v: number) => (e: ReportElement) => number;
+    protected readonly setH: (v: number) => (e: ReportElement) => number;
+    protected readonly setDecimals: (v: number) => (e: ReportElement) => number;
+    protected setText: (v: string) => (e: ReportElement) => string;
+    protected setDash: (v: "solid" | "dashed" | "dotted") => (e: ReportElement) => "dashed" | "dotted" | undefined;
+    protected setFit: (v: "contain" | "cover" | "fill") => (e: ReportElement) => "contain" | "cover" | "fill";
+    protected setVisible: (v: string) => (e: ReportElement) => string | undefined;
+    protected setGrow: (v: boolean) => (e: ReportElement) => boolean;
+    protected setFormatKind: (v: FormatKind) => (e: ReportElement) => FormatKind;
+    protected setCurrency: (v: string) => (e: ReportElement) => string;
+    protected readonly options: import("@angular/core").Signal<{
+        nullText: string;
+        hideDuplicates: boolean;
+        rules: StyleRule[];
+    }>;
+    protected setNullText(v: string): void;
+    protected setHideDuplicates(v: boolean): void;
+    protected addRule(): void;
+    protected setRule<K extends keyof StyleRule>(i: number, k: K, v: StyleRule[K]): void;
+    protected removeRule(i: number): void;
+    protected set(fn: (e: ReportElement) => void): void;
+    protected num(v: number | null, setter: (v: number) => (e: ReportElement) => void): void;
+    protected style<K extends keyof ElementStyle>(k: K, v: ElementStyle[K]): void;
+    protected numStyle(k: 'fontSize' | 'padding' | 'borderWidth', v: number | null): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ElementPropsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ElementPropsComponent, "rpt-element-props", never, { "el": { "alias": "el"; "required": true; "isSignal": true; }; "count": { "alias": "count"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}

package/lib/ui/properties/expr-input.component.d.ts

@@ -0,0 +1,43 @@
+import * as i0 from "@angular/core";
+interface Suggestion {
+    label: string;
+    insert: string;
+    kind: 'field' | 'param' | 'fn' | 'special';
+    detail: string;
+}
+/**
+ * Text box for templates ("Total: {sum(Amount)}") or bare expressions ("Amount > 100") with
+ * autocomplete of fields, @parameters, functions and special fields, plus live validation.
+ * Template mode suggests inside {…}; expression mode suggests anywhere. Ctrl+Space opens the list.
+ */
+export declare class ExprInputComponent {
+    private readonly store;
+    readonly value: import("@angular/core").InputSignal<string>;
+    readonly mode: import("@angular/core").InputSignal<"template" | "expression">;
+    readonly rows: import("@angular/core").InputSignal<number>;
+    readonly placeholder: import("@angular/core").InputSignal<string>;
+    readonly valueChange: import("@angular/core").OutputEmitterRef<string>;
+    private readonly box;
+    protected readonly icons: {
+        readonly field: "Ab";
+        readonly param: "@";
+        readonly fn: "ƒ";
+        readonly special: "★";
+    };
+    protected readonly open: import("@angular/core").WritableSignal<boolean>;
+    protected readonly active: import("@angular/core").WritableSignal<number>;
+    protected readonly items: import("@angular/core").WritableSignal<Suggestion[]>;
+    /** The partial word being completed: [start, end) in the box. */
+    private word;
+    protected readonly error: import("@angular/core").Signal<string | null>;
+    private readonly all;
+    protected onInput(): void;
+    /** Works out whether the caret is inside an expression and which word is being typed. */
+    protected refresh(force?: boolean): void;
+    protected onKey(e: KeyboardEvent): void;
+    /** Inserts the suggestion; functions get "()" with the caret inside, templates get a closing "}". */
+    protected accept(s: Suggestion): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ExprInputComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ExprInputComponent, "rpt-expr-input", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}
+export {};

package/lib/ui/properties/graphics-props.component.d.ts

@@ -0,0 +1,52 @@
+import type { AggregateKind, ChartType, FormatKind, ReportElement } from '../../model/types';
+import { DesignerStore } from '../designer.store';
+import * as i0 from "@angular/core";
+/** Base: edits one element in place by id (one undo step per change). */
+declare abstract class SpecEditor {
+    protected readonly store: DesignerStore;
+    readonly el: import("@angular/core").InputSignal<ReportElement>;
+    protected readonly aggregates: AggregateKind[];
+    protected readonly valueFormats: FormatKind[];
+    protected edit(fn: (e: ReportElement) => void): void;
+    protected positive(v: number | null, fn: (n: number) => void): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<SpecEditor, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<SpecEditor, never, never, { "el": { "alias": "el"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+export declare class ChartPropsComponent extends SpecEditor {
+    protected readonly maxSeries: number;
+    protected readonly types: {
+        value: ChartType;
+        label: string;
+        icon: string;
+    }[];
+    protected readonly pie: import("@angular/core").Signal<boolean>;
+    protected set: <K extends keyof NonNullable<ReportElement["chart"]>>(k: K, v: NonNullable<ReportElement["chart"]>[K]) => (e: ReportElement) => import("angular-my-report").ChartSpec[K];
+    protected setMax: (n: number) => void;
+    protected setFormat: (k: FormatKind) => (e: ReportElement) => FormatKind;
+    protected setValues(v: string): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ChartPropsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ChartPropsComponent, "rpt-chart-props", never, {}, {}, never, never, true, never>;
+}
+export declare class BarcodePropsComponent extends SpecEditor {
+    protected setType: (v: "code128" | "ean13") => (e: ReportElement) => "code128" | "ean13";
+    protected setShowText: (v: boolean) => (e: ReportElement) => boolean;
+    protected setColor: (v: string) => (e: ReportElement) => string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<BarcodePropsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<BarcodePropsComponent, "rpt-barcode-props", never, {}, {}, never, never, true, never>;
+}
+export declare class QrPropsComponent extends SpecEditor {
+    protected setLevel: (v: "L" | "M" | "Q" | "H") => (e: ReportElement) => "L" | "M" | "Q" | "H";
+    protected setColor: (v: string) => (e: ReportElement) => string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<QrPropsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<QrPropsComponent, "rpt-qr-props", never, {}, {}, never, never, true, never>;
+}
+export declare class CrosstabPropsComponent extends SpecEditor {
+    protected set: <K extends keyof NonNullable<ReportElement["crosstab"]>>(k: K, v: NonNullable<ReportElement["crosstab"]>[K]) => (e: ReportElement) => import("angular-my-report").CrossTabSpec[K];
+    protected setFormat: (k: FormatKind) => (e: ReportElement) => FormatKind;
+    protected setDecimals: (n: number) => void;
+    protected setHeaderH: (n: number) => void;
+    protected setRowH: (n: number) => void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<CrosstabPropsComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CrosstabPropsComponent, "rpt-crosstab-props", never, {}, {}, never, never, true, never>;
+}
+export {};

package/lib/ui/properties/image-picker.component.d.ts

@@ -0,0 +1,15 @@
+import * as i0 from "@angular/core";
+/** Image source: a URL (may contain {Field}) or an uploaded file embedded as a base64 data URL. */
+export declare class ImagePickerComponent {
+    readonly value: import("@angular/core").InputSignal<string>;
+    readonly placeholder: import("@angular/core").InputSignal<string>;
+    readonly valueChange: import("@angular/core").OutputEmitterRef<string>;
+    protected readonly message: import("@angular/core").WritableSignal<string>;
+    protected readonly embedded: import("@angular/core").Signal<boolean>;
+    /** Approximate decoded size of the embedded image. */
+    protected readonly size: import("@angular/core").Signal<string>;
+    /** Reads the file as base64 (data URL) so the image travels inside the report file. */
+    protected upload(e: Event): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ImagePickerComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ImagePickerComponent, "rpt-image-picker", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; }, { "valueChange": "valueChange"; }, never, never, true, never>;
+}

package/lib/ui/properties/properties-panel.component.d.ts

@@ -0,0 +1,13 @@
+import { DesignerStore } from '../designer.store';
+import * as i0 from "@angular/core";
+/** Right-hand panel: properties of the selected element(s), else the selected band, else the report. */
+export declare class PropertiesPanelComponent {
+    protected readonly store: DesignerStore;
+    protected readonly first: import("@angular/core").Signal<{
+        band: import("angular-my-report").Band;
+        el: import("angular-my-report").ReportElement;
+    } | null>;
+    protected readonly bandId: import("@angular/core").Signal<string | null>;
+    static ɵfac: i0.ɵɵFactoryDeclaration<PropertiesPanelComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<PropertiesPanelComponent, "rpt-properties-panel", never, {}, {}, never, never, true, never>;
+}

package/lib/ui/properties/report-extras.component.d.ts

@@ -0,0 +1,40 @@
+import type { PageBackground, ParameterType, ReportParameter, Watermark } from '../../model/types';
+import * as i0 from "@angular/core";
+/** Report-level settings: parameters, row filter, watermark and page background. */
+export declare class ReportExtrasComponent {
+    private readonly store;
+    protected readonly types: ParameterType[];
+    protected readonly parameters: import("@angular/core").Signal<ReportParameter[]>;
+    protected readonly filter: import("@angular/core").Signal<string>;
+    protected readonly watermark: import("@angular/core").Signal<{
+        enabled: boolean;
+        kind: "text" | "image";
+        text: string;
+        image: string;
+        opacity: number;
+        angle: number;
+        fontSize: number;
+        color: string;
+        bold: boolean;
+        imageScale: number;
+        layer: "behind" | "front";
+        pages: "all" | "first";
+    }>;
+    protected readonly background: import("@angular/core").Signal<{
+        enabled: boolean;
+        image: string;
+        fit: "cover" | "contain" | "stretch" | "center";
+        pages: "all" | "first";
+    }>;
+    /** Parameter names: letters, digits and _ only (they are used as @Name). */
+    protected clean(v: string): string;
+    protected addParam(): void;
+    protected setParam<K extends keyof ReportParameter>(i: number, k: K, v: ReportParameter[K]): void;
+    protected removeParam(i: number): void;
+    protected setFilter(v: string): void;
+    protected setWm<K extends keyof Watermark>(k: K, v: Watermark[K]): void;
+    protected num(v: number | null, k: 'fontSize' | 'imageScale', min: number): void;
+    protected setBg<K extends keyof PageBackground>(k: K, v: PageBackground[K]): void;
+    static ɵfac: i0.ɵɵFactoryDeclaration<ReportExtrasComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<ReportExtrasComponent, "rpt-report-extras", never, {}, {}, never, never, true, never>;
+}