@nice2dev/ui-tools 1.0.10

package/dist/report-designer.d.ts

@@ -0,0 +1,1153 @@
+/**
+ * @file report-designer.ts
+ * @module @nice2dev/ui-tools
+ * @description PRO-14.5 — Report Designer
+ *
+ * Types for WYSIWYG report designer: data sources, query builder, report bands,
+ * parameters, charts, subreports, cross-tab, grouping/sorting, export, scheduling.
+ */
+/** Report output format */
+export type ReportOutputFormat = 'pdf' | 'html' | 'excel' | 'word' | 'csv' | 'xml' | 'json' | 'rtf' | 'text' | 'image';
+/** Data type */
+export type ReportDataType = 'string' | 'number' | 'integer' | 'decimal' | 'boolean' | 'date' | 'datetime' | 'time' | 'binary' | 'object' | 'array';
+/** Alignment */
+export type ReportAlignment = 'left' | 'center' | 'right' | 'justify';
+/** Vertical alignment */
+export type ReportVerticalAlignment = 'top' | 'middle' | 'bottom';
+/** Report designer configuration */
+export interface ReportDesignerConfig {
+    /** Initial report definition */
+    report?: ReportDefinition;
+    /** Available data sources */
+    dataSources?: DataSourceDefinition[];
+    /** Available parameters */
+    parameters?: ReportParameter[];
+    /** Theme */
+    theme?: ReportDesignerTheme;
+    /** Locale */
+    locale?: string;
+    /** Enable preview */
+    preview?: boolean;
+    /** Enable undo/redo */
+    undoRedo?: boolean;
+    /** Show rulers */
+    showRulers?: boolean;
+    /** Show grid */
+    showGrid?: boolean;
+    /** Grid size */
+    gridSize?: number;
+    /** Snap to grid */
+    snapToGrid?: boolean;
+    /** Unit */
+    unit?: 'inch' | 'cm' | 'px' | 'pt';
+    /** Toolbar configuration */
+    toolbar?: ReportToolbarConfig;
+    /** Toolbox configuration */
+    toolbox?: ReportToolboxConfig;
+    /** Properties panel */
+    propertiesPanel?: boolean;
+    /** Field list panel */
+    fieldListPanel?: boolean;
+    /** Report explorer panel */
+    reportExplorerPanel?: boolean;
+    /** Custom components */
+    customComponents?: CustomReportComponent[];
+}
+/** Report designer theme */
+export interface ReportDesignerTheme {
+    name?: string;
+    primary?: string;
+    secondary?: string;
+    background?: string;
+    surface?: string;
+    text?: string;
+    border?: string;
+    canvas?: string;
+    selection?: string;
+    ruler?: string;
+    grid?: string;
+}
+/** Report toolbar configuration */
+export interface ReportToolbarConfig {
+    visible?: boolean;
+    items?: ReportToolbarItem[];
+    customItems?: CustomToolbarItem[];
+}
+/** Toolbar item */
+export type ReportToolbarItem = 'new' | 'open' | 'save' | 'saveAs' | 'undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'delete' | 'selectAll' | 'preview' | 'print' | 'export' | 'zoom' | 'zoomIn' | 'zoomOut' | 'fitPage' | 'fitWidth' | 'showGrid' | 'snapToGrid' | 'alignLeft' | 'alignCenter' | 'alignRight' | 'alignTop' | 'alignMiddle' | 'alignBottom' | 'sameWidth' | 'sameHeight' | 'sameSize' | 'bringToFront' | 'sendToBack' | 'bringForward' | 'sendBackward' | 'group' | 'ungroup' | 'separator';
+/** Custom toolbar item */
+export interface CustomToolbarItem {
+    id: string;
+    label?: string;
+    icon?: string;
+    tooltip?: string;
+    handler: () => void;
+    disabled?: boolean;
+    position?: number;
+}
+/** Report toolbox configuration */
+export interface ReportToolboxConfig {
+    visible?: boolean;
+    position?: 'left' | 'right';
+    width?: number;
+    categories?: ReportToolboxCategory[];
+}
+/** Toolbox category */
+export interface ReportToolboxCategory {
+    id: string;
+    name: string;
+    expanded?: boolean;
+    items: ReportToolboxItem[];
+}
+/** Toolbox item */
+export interface ReportToolboxItem {
+    type: ReportItemType;
+    label: string;
+    icon?: string;
+    defaultConfig?: Partial<ReportItem>;
+}
+/** Custom report component */
+export interface CustomReportComponent {
+    type: string;
+    label: string;
+    icon?: string;
+    category?: string;
+    defaultConfig: Partial<ReportItem>;
+    renderer: (item: ReportItem, data: unknown) => string;
+    editor?: string;
+}
+/** Report definition */
+export interface ReportDefinition {
+    id: string;
+    name: string;
+    description?: string;
+    version?: string;
+    author?: string;
+    created?: Date;
+    modified?: Date;
+    page?: ReportPage;
+    dataSources: ReportDataSource[];
+    parameters?: ReportParameter[];
+    variables?: ReportVariable[];
+    bands: ReportBand[];
+    styles?: ReportStyle[];
+    scripts?: ReportScript[];
+    subreports?: SubreportDefinition[];
+    settings?: ReportSettings;
+    metadata?: Record<string, unknown>;
+}
+/** Report page settings */
+export interface ReportPage {
+    size?: PageSize;
+    customSize?: {
+        width: number;
+        height: number;
+    };
+    orientation?: 'portrait' | 'landscape';
+    margins?: ReportMargins;
+    columns?: number;
+    columnSpacing?: number;
+    watermark?: Watermark;
+    background?: PageBackground;
+}
+/** Page size */
+export type PageSize = 'letter' | 'legal' | 'tabloid' | 'ledger' | 'a0' | 'a1' | 'a2' | 'a3' | 'a4' | 'a5' | 'b4' | 'b5' | 'custom';
+/** Report margins */
+export interface ReportMargins {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/** Watermark */
+export interface Watermark {
+    type: 'text' | 'image';
+    text?: string;
+    image?: string;
+    font?: ReportFont;
+    color?: string;
+    opacity?: number;
+    rotation?: number;
+    position?: 'center' | 'tile';
+    showInPreview?: boolean;
+    showInExport?: boolean;
+}
+/** Page background */
+export interface PageBackground {
+    type: 'color' | 'image' | 'gradient';
+    color?: string;
+    image?: string;
+    gradient?: GradientDef;
+    imageMode?: 'stretch' | 'tile' | 'center' | 'fit';
+}
+/** Gradient definition */
+export interface GradientDef {
+    type: 'linear' | 'radial';
+    angle?: number;
+    stops: {
+        position: number;
+        color: string;
+    }[];
+}
+/** Report settings */
+export interface ReportSettings {
+    showReportHeader?: boolean;
+    showReportFooter?: boolean;
+    showPageHeader?: boolean;
+    showPageFooter?: boolean;
+    repeatColumnHeaders?: boolean;
+    keepTogether?: boolean;
+    allowPrintOnFirstPage?: boolean;
+    allowPrintOnLastPage?: boolean;
+    culture?: string;
+    numberFormat?: string;
+    dateFormat?: string;
+    timeFormat?: string;
+    currencySymbol?: string;
+    decimalSeparator?: string;
+    thousandSeparator?: string;
+    cacheTTL?: number;
+    timeout?: number;
+    maxRows?: number;
+    encoding?: string;
+}
+/** Data source definition */
+export interface DataSourceDefinition {
+    id: string;
+    name: string;
+    type: DataSourceType;
+    connection?: ConnectionConfig;
+    query?: QueryConfig;
+    fields?: DataField[];
+    parameters?: DataSourceParameter[];
+    calculated?: CalculatedField[];
+    relations?: DataRelation[];
+    caching?: CachingConfig;
+}
+/** Data source type */
+export type DataSourceType = 'sql' | 'oracle' | 'mysql' | 'postgresql' | 'mongodb' | 'rest' | 'graphql' | 'xml' | 'json' | 'csv' | 'excel' | 'olap' | 'custom';
+/** Connection configuration */
+export interface ConnectionConfig {
+    connectionString?: string;
+    server?: string;
+    port?: number;
+    database?: string;
+    username?: string;
+    password?: string;
+    integrated?: boolean;
+    timeout?: number;
+    pooling?: boolean;
+    maxPoolSize?: number;
+    ssl?: boolean;
+    options?: Record<string, unknown>;
+}
+/** Query configuration */
+export interface QueryConfig {
+    type: 'text' | 'storedProcedure' | 'table' | 'view';
+    query?: string;
+    procedure?: string;
+    table?: string;
+    view?: string;
+    filter?: string;
+    orderBy?: string;
+    parameters?: QueryParameter[];
+}
+/** Query parameter */
+export interface QueryParameter {
+    name: string;
+    type: ReportDataType;
+    direction?: 'input' | 'output' | 'inputOutput' | 'returnValue';
+    defaultValue?: unknown;
+    expression?: string;
+}
+/** Data field */
+export interface DataField {
+    name: string;
+    displayName?: string;
+    type: ReportDataType;
+    format?: string;
+    nullable?: boolean;
+    length?: number;
+    precision?: number;
+    scale?: number;
+    description?: string;
+    visible?: boolean;
+}
+/** Data source parameter */
+export interface DataSourceParameter {
+    name: string;
+    type: ReportDataType;
+    defaultValue?: unknown;
+    expression?: string;
+    promptUser?: boolean;
+}
+/** Calculated field */
+export interface CalculatedField {
+    name: string;
+    expression: string;
+    type: ReportDataType;
+    format?: string;
+    description?: string;
+}
+/** Data relation */
+export interface DataRelation {
+    name: string;
+    parentDataSource: string;
+    childDataSource: string;
+    parentFields: string[];
+    childFields: string[];
+    type: 'inner' | 'left' | 'right' | 'full';
+}
+/** Caching configuration */
+export interface CachingConfig {
+    enabled: boolean;
+    ttl?: number;
+    key?: string;
+    invalidateOn?: string[];
+}
+/** Report data source */
+export interface ReportDataSource {
+    id: string;
+    name: string;
+    definition: string;
+    filters?: DataFilter[];
+    sorting?: DataSorting[];
+    grouping?: DataGrouping[];
+}
+/** Data filter */
+export interface DataFilter {
+    field: string;
+    operator: FilterOperator;
+    value?: unknown;
+    expression?: string;
+    parameter?: string;
+}
+/** Filter operator */
+export type FilterOperator = 'equals' | 'notEquals' | 'greaterThan' | 'greaterThanOrEqual' | 'lessThan' | 'lessThanOrEqual' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'isNull' | 'isNotNull' | 'in' | 'notIn' | 'between' | 'like' | 'regex';
+/** Data sorting */
+export interface DataSorting {
+    field: string;
+    direction: 'ascending' | 'descending';
+    nullsFirst?: boolean;
+}
+/** Data grouping */
+export interface DataGrouping {
+    field: string;
+    expression?: string;
+    sortDirection?: 'ascending' | 'descending';
+    groupInterval?: GroupInterval;
+}
+/** Group interval */
+export type GroupInterval = 'none' | 'year' | 'quarter' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'alphabetical' | 'numeric';
+/** Report parameter */
+export interface ReportParameter {
+    id: string;
+    name: string;
+    displayName?: string;
+    type: ReportDataType;
+    defaultValue?: unknown;
+    allowNull?: boolean;
+    allowBlank?: boolean;
+    multiValue?: boolean;
+    hidden?: boolean;
+    promptUser?: boolean;
+    prompt?: string;
+    validValues?: ParameterValidValues;
+    validation?: ParameterValidation;
+    dependencies?: string[];
+    cascading?: boolean;
+}
+/** Parameter valid values */
+export interface ParameterValidValues {
+    type: 'none' | 'list' | 'query';
+    values?: ParameterValue[];
+    dataSource?: string;
+    valueField?: string;
+    labelField?: string;
+    filter?: string;
+}
+/** Parameter value */
+export interface ParameterValue {
+    value: unknown;
+    label?: string;
+}
+/** Parameter validation */
+export interface ParameterValidation {
+    required?: boolean;
+    min?: unknown;
+    max?: unknown;
+    pattern?: string;
+    customScript?: string;
+    errorMessage?: string;
+}
+/** Report variable */
+export interface ReportVariable {
+    id: string;
+    name: string;
+    expression: string;
+    type: ReportDataType;
+    resetType?: ResetType;
+    resetGroup?: string;
+    calculation?: VariableCalculation;
+    initialValue?: unknown;
+}
+/** Reset type */
+export type ResetType = 'none' | 'report' | 'page' | 'column' | 'group';
+/** Variable calculation */
+export type VariableCalculation = 'nothing' | 'count' | 'distinctCount' | 'sum' | 'average' | 'min' | 'max' | 'first' | 'last' | 'standardDeviation' | 'variance' | 'system';
+/** Report band */
+export interface ReportBand {
+    id: string;
+    type: BandType;
+    height: number;
+    items: ReportItem[];
+    visible?: boolean;
+    visibilityExpression?: string;
+    backgroundColor?: string;
+    printOnFirstPage?: boolean;
+    printOnLastPage?: boolean;
+    printOnEveryPage?: boolean;
+    printWhenGroupChanges?: string;
+    keepTogether?: boolean;
+    repeatOnNewPage?: boolean;
+    splitType?: SplitType;
+    groupExpression?: string;
+    groupHeader?: ReportGroupBand;
+    groupFooter?: ReportGroupBand;
+}
+/** Band type */
+export type BandType = 'reportHeader' | 'pageHeader' | 'columnHeader' | 'groupHeader' | 'detail' | 'groupFooter' | 'columnFooter' | 'pageFooter' | 'reportFooter' | 'noData' | 'background';
+/** Split type */
+export type SplitType = 'stretch' | 'prevent' | 'immediate';
+/** Group band */
+export interface ReportGroupBand {
+    id: string;
+    height: number;
+    items: ReportItem[];
+    visible?: boolean;
+    visibilityExpression?: string;
+    backgroundColor?: string;
+    keepTogether?: boolean;
+    repeatOnNewPage?: boolean;
+    startNewPage?: boolean;
+    startNewColumn?: boolean;
+    resetPageNumber?: boolean;
+}
+/** Report item type */
+export type ReportItemType = 'label' | 'textbox' | 'field' | 'expression' | 'image' | 'line' | 'rectangle' | 'ellipse' | 'chart' | 'barcode' | 'qrcode' | 'table' | 'matrix' | 'list' | 'subreport' | 'pageBreak' | 'columnBreak' | 'richText' | 'html' | 'gauge' | 'sparkline' | 'map' | 'crosstab' | 'custom';
+/** Report item */
+export interface ReportItem {
+    id: string;
+    type: ReportItemType;
+    name?: string;
+    position: ItemPosition;
+    size: ItemSize;
+    style?: ItemStyle;
+    visible?: boolean;
+    visibilityExpression?: string;
+    tooltip?: string;
+    bookmark?: string;
+    hyperlinkExpression?: string;
+    properties?: ItemProperties;
+}
+/** Item position */
+export interface ItemPosition {
+    x: number;
+    y: number;
+    anchorTop?: boolean;
+    anchorBottom?: boolean;
+    anchorLeft?: boolean;
+    anchorRight?: boolean;
+}
+/** Item size */
+export interface ItemSize {
+    width: number;
+    height: number;
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+    canGrow?: boolean;
+    canShrink?: boolean;
+}
+/** Item style */
+export interface ItemStyle {
+    backgroundColor?: string;
+    backgroundImage?: string;
+    foregroundColor?: string;
+    font?: ReportFont;
+    padding?: ReportPadding;
+    border?: ReportBorder;
+    alignment?: ReportAlignment;
+    verticalAlignment?: ReportVerticalAlignment;
+    textRotation?: number;
+    lineSpacing?: number;
+    direction?: 'leftToRight' | 'rightToLeft';
+}
+/** Report font */
+export interface ReportFont {
+    family?: string;
+    size?: number;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    strikethrough?: boolean;
+    color?: string;
+}
+/** Report padding */
+export interface ReportPadding {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+}
+/** Report border */
+export interface ReportBorder {
+    style?: BorderLineStyle;
+    width?: number;
+    color?: string;
+    top?: BorderSide;
+    right?: BorderSide;
+    bottom?: BorderSide;
+    left?: BorderSide;
+}
+/** Border line style */
+export type BorderLineStyle = 'none' | 'solid' | 'dashed' | 'dotted' | 'double' | 'groove' | 'ridge' | 'inset' | 'outset';
+/** Border side */
+export interface BorderSide {
+    style?: BorderLineStyle;
+    width?: number;
+    color?: string;
+}
+/** Item properties */
+export type ItemProperties = LabelProperties | TextboxProperties | FieldProperties | ExpressionProperties | ImageProperties | LineProperties | ShapeProperties | ChartProperties | BarcodeProperties | TableProperties | MatrixProperties | ListProperties | SubreportProperties | GaugeProperties | SparklineProperties | MapProperties | CrosstabProperties;
+/** Label properties */
+export interface LabelProperties {
+    text: string;
+    markup?: 'none' | 'html' | 'rtf' | 'styled';
+}
+/** Textbox properties */
+export interface TextboxProperties {
+    text?: string;
+    expression?: string;
+    format?: string;
+    markup?: 'none' | 'html' | 'rtf' | 'styled';
+    textWrap?: boolean;
+    trimming?: 'none' | 'character' | 'word' | 'ellipsisCharacter' | 'ellipsisWord' | 'ellipsisPath';
+}
+/** Field properties */
+export interface FieldProperties {
+    dataSource: string;
+    field: string;
+    format?: string;
+    nullValue?: string;
+    aggregation?: AggregationType;
+}
+/** Aggregation type */
+export type AggregationType = 'none' | 'sum' | 'average' | 'count' | 'countDistinct' | 'min' | 'max' | 'first' | 'last' | 'standardDeviation' | 'variance' | 'running';
+/** Expression properties */
+export interface ExpressionProperties {
+    expression: string;
+    format?: string;
+    evaluationTime?: EvaluationTime;
+    evaluationGroup?: string;
+}
+/** Evaluation time */
+export type EvaluationTime = 'now' | 'report' | 'page' | 'column' | 'group' | 'band' | 'auto';
+/** Image properties */
+export interface ImageProperties {
+    source: ImageSource;
+    url?: string;
+    expression?: string;
+    base64?: string;
+    scaleMode?: 'none' | 'fill' | 'uniform' | 'uniformToFill';
+    alignment?: ReportAlignment;
+    verticalAlignment?: ReportVerticalAlignment;
+}
+/** Image source */
+export type ImageSource = 'url' | 'expression' | 'embedded' | 'database';
+/** Line properties */
+export interface LineProperties {
+    direction: 'horizontal' | 'vertical' | 'topLeftToBottomRight' | 'topRightToBottomLeft';
+    lineWidth?: number;
+    lineColor?: string;
+    lineStyle?: BorderLineStyle;
+}
+/** Shape properties */
+export interface ShapeProperties {
+    shapeType: 'rectangle' | 'roundedRectangle' | 'ellipse' | 'triangle';
+    radius?: number;
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    strokeStyle?: BorderLineStyle;
+}
+/** Chart properties */
+export interface ChartProperties {
+    chartType: ChartType;
+    dataSource: string;
+    series: ChartSeries[];
+    categories?: ChartCategories;
+    title?: ChartTitle;
+    legend?: ChartLegend;
+    axes?: ChartAxes;
+    plotArea?: ChartPlotArea;
+    colors?: string[];
+    animation?: boolean;
+    threeDimensional?: boolean;
+    palette?: string;
+}
+/** Chart type */
+export type ChartType = 'column' | 'bar' | 'line' | 'area' | 'pie' | 'doughnut' | 'scatter' | 'bubble' | 'radar' | 'polar' | 'stock' | 'candlestick' | 'funnel' | 'pyramid' | 'gantt' | 'waterfall' | 'boxPlot' | 'heatmap' | 'treemap' | 'sunburst';
+/** Chart series */
+export interface ChartSeries {
+    name?: string;
+    valueField: string;
+    categoryField?: string;
+    colorField?: string;
+    labelField?: string;
+    type?: ChartType;
+    color?: string;
+    showLabels?: boolean;
+    labelFormat?: string;
+    marker?: ChartMarker;
+    line?: ChartLine;
+}
+/** Chart marker */
+export interface ChartMarker {
+    type: 'none' | 'circle' | 'square' | 'diamond' | 'triangle' | 'cross' | 'star';
+    size?: number;
+    color?: string;
+    borderColor?: string;
+    borderWidth?: number;
+}
+/** Chart line */
+export interface ChartLine {
+    width?: number;
+    style?: 'solid' | 'dashed' | 'dotted';
+    color?: string;
+}
+/** Chart categories */
+export interface ChartCategories {
+    field?: string;
+    labels?: string[];
+    dateGrouping?: GroupInterval;
+}
+/** Chart title */
+export interface ChartTitle {
+    text?: string;
+    visible?: boolean;
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    font?: ReportFont;
+}
+/** Chart legend */
+export interface ChartLegend {
+    visible?: boolean;
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    font?: ReportFont;
+}
+/** Chart axes */
+export interface ChartAxes {
+    category?: ChartAxis;
+    value?: ChartAxis;
+    secondaryValue?: ChartAxis;
+}
+/** Chart axis */
+export interface ChartAxis {
+    visible?: boolean;
+    title?: ChartTitle;
+    min?: number;
+    max?: number;
+    majorUnit?: number;
+    minorUnit?: number;
+    logarithmic?: boolean;
+    reversed?: boolean;
+    format?: string;
+    labels?: AxisLabels;
+    gridLines?: AxisGridLines;
+}
+/** Axis labels */
+export interface AxisLabels {
+    visible?: boolean;
+    font?: ReportFont;
+    rotation?: number;
+    format?: string;
+}
+/** Axis grid lines */
+export interface AxisGridLines {
+    visible?: boolean;
+    color?: string;
+    style?: BorderLineStyle;
+    width?: number;
+}
+/** Chart plot area */
+export interface ChartPlotArea {
+    backgroundColor?: string;
+    border?: ReportBorder;
+}
+/** Barcode properties */
+export interface BarcodeProperties {
+    barcodeType: BarcodeType;
+    value: string;
+    expression?: string;
+    showText?: boolean;
+    textPosition?: 'top' | 'bottom';
+    quietZone?: number;
+    barWidth?: number;
+    barHeight?: number;
+    rotation?: number;
+    checksum?: boolean;
+}
+/** Barcode type */
+export type BarcodeType = 'code39' | 'code128' | 'code128A' | 'code128B' | 'code128C' | 'ean8' | 'ean13' | 'upcA' | 'upcE' | 'itf14' | 'code93' | 'codabar' | 'dataMatrix' | 'qrCode' | 'pdf417' | 'aztec' | 'maxiCode';
+/** Table properties */
+export interface TableProperties {
+    dataSource: string;
+    columns: TableColumn[];
+    rows?: TableRow[];
+    header?: TableHeader;
+    footer?: TableFooter;
+    grouping?: TableGrouping[];
+    alternateRowColor?: string;
+    repeatHeader?: boolean;
+    repeatFooter?: boolean;
+}
+/** Table column */
+export interface TableColumn {
+    field?: string;
+    expression?: string;
+    header?: string;
+    footer?: string;
+    width?: number;
+    format?: string;
+    alignment?: ReportAlignment;
+    style?: ItemStyle;
+    visible?: boolean;
+    sortable?: boolean;
+}
+/** Table row */
+export interface TableRow {
+    height?: number;
+    cells: TableCell[];
+    style?: ItemStyle;
+}
+/** Table cell */
+export interface TableCell {
+    content?: string;
+    expression?: string;
+    colspan?: number;
+    rowspan?: number;
+    style?: ItemStyle;
+}
+/** Table header */
+export interface TableHeader {
+    rows: TableRow[];
+    style?: ItemStyle;
+}
+/** Table footer */
+export interface TableFooter {
+    rows: TableRow[];
+    style?: ItemStyle;
+    aggregations?: TableAggregation[];
+}
+/** Table aggregation */
+export interface TableAggregation {
+    field: string;
+    type: AggregationType;
+    format?: string;
+}
+/** Table grouping */
+export interface TableGrouping {
+    field: string;
+    header?: TableRow[];
+    footer?: TableRow[];
+    pageBreak?: boolean;
+    keepTogether?: boolean;
+}
+/** Matrix properties */
+export interface MatrixProperties {
+    dataSource: string;
+    rowGroups: MatrixGroup[];
+    columnGroups: MatrixGroup[];
+    values: MatrixValue[];
+    rowTotals?: MatrixTotals;
+    columnTotals?: MatrixTotals;
+    grandTotals?: boolean;
+    style?: ItemStyle;
+}
+/** Matrix group */
+export interface MatrixGroup {
+    field: string;
+    expression?: string;
+    header?: string;
+    sortDirection?: 'ascending' | 'descending';
+    subtotal?: boolean;
+}
+/** Matrix value */
+export interface MatrixValue {
+    field: string;
+    aggregation: AggregationType;
+    format?: string;
+    style?: ItemStyle;
+}
+/** Matrix totals */
+export interface MatrixTotals {
+    visible?: boolean;
+    position?: 'before' | 'after';
+    label?: string;
+    style?: ItemStyle;
+}
+/** List properties */
+export interface ListProperties {
+    dataSource: string;
+    template: ReportItem[];
+    direction?: 'vertical' | 'horizontal';
+    columns?: number;
+    spacing?: number;
+    noDataTemplate?: ReportItem[];
+}
+/** Subreport properties */
+export interface SubreportProperties {
+    reportPath?: string;
+    reportDefinition?: ReportDefinition;
+    parameters?: SubreportParameterMapping[];
+    dataSource?: string;
+    keepTogether?: boolean;
+}
+/** Subreport parameter mapping */
+export interface SubreportParameterMapping {
+    parameterName: string;
+    value?: unknown;
+    expression?: string;
+    parentParameter?: string;
+}
+/** Gauge properties */
+export interface GaugeProperties {
+    gaugeType: 'linear' | 'radial';
+    value: number | string;
+    min?: number;
+    max?: number;
+    ranges?: GaugeRange[];
+    pointer?: GaugePointer;
+    scale?: GaugeScale;
+    labels?: GaugeLabels;
+}
+/** Gauge range */
+export interface GaugeRange {
+    from: number;
+    to: number;
+    color: string;
+    label?: string;
+}
+/** Gauge pointer */
+export interface GaugePointer {
+    type?: 'needle' | 'marker' | 'bar';
+    color?: string;
+    width?: number;
+}
+/** Gauge scale */
+export interface GaugeScale {
+    startAngle?: number;
+    sweepAngle?: number;
+    majorTicks?: number;
+    minorTicks?: number;
+    tickColor?: string;
+}
+/** Gauge labels */
+export interface GaugeLabels {
+    visible?: boolean;
+    font?: ReportFont;
+    format?: string;
+}
+/** Sparkline properties */
+export interface SparklineProperties {
+    sparklineType: 'line' | 'column' | 'winLoss';
+    dataSource: string;
+    valueField: string;
+    color?: string;
+    negativeColor?: string;
+    firstColor?: string;
+    lastColor?: string;
+    highColor?: string;
+    lowColor?: string;
+    showMarkers?: boolean;
+    showAxis?: boolean;
+    lineWidth?: number;
+}
+/** Map properties */
+export interface MapProperties {
+    mapType: 'geographic' | 'shape';
+    mapPath?: string;
+    dataSource?: string;
+    locationField?: string;
+    valueField?: string;
+    colorField?: string;
+    layers?: MapLayer[];
+    legend?: ChartLegend;
+    projection?: string;
+    center?: {
+        lat: number;
+        lng: number;
+    };
+    zoom?: number;
+}
+/** Map layer */
+export interface MapLayer {
+    type: 'polygon' | 'point' | 'line' | 'bubble' | 'heatmap';
+    dataSource?: string;
+    latitudeField?: string;
+    longitudeField?: string;
+    sizeField?: string;
+    colorField?: string;
+    labelField?: string;
+    style?: MapLayerStyle;
+}
+/** Map layer style */
+export interface MapLayerStyle {
+    fill?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+}
+/** Crosstab properties */
+export interface CrosstabProperties {
+    dataSource: string;
+    rowGroups: CrosstabGroup[];
+    columnGroups: CrosstabGroup[];
+    measures: CrosstabMeasure[];
+    rowTotals?: CrosstabTotals;
+    columnTotals?: CrosstabTotals;
+    headerCell?: ItemStyle;
+    dataCell?: ItemStyle;
+    totalCell?: ItemStyle;
+    alternateRowColors?: boolean;
+}
+/** Crosstab group */
+export interface CrosstabGroup {
+    field: string;
+    header?: string;
+    sortDirection?: 'ascending' | 'descending';
+    sortByMeasure?: string;
+    subtotal?: boolean;
+    subtotalPosition?: 'before' | 'after';
+}
+/** Crosstab measure */
+export interface CrosstabMeasure {
+    field: string;
+    aggregation: AggregationType;
+    format?: string;
+    header?: string;
+}
+/** Crosstab totals */
+export interface CrosstabTotals {
+    visible?: boolean;
+    position?: 'before' | 'after';
+    label?: string;
+}
+/** Report style */
+export interface ReportStyle {
+    id: string;
+    name: string;
+    parentStyle?: string;
+    style: ItemStyle;
+    conditionalStyles?: ConditionalStyle[];
+}
+/** Conditional style */
+export interface ConditionalStyle {
+    condition: string;
+    style: ItemStyle;
+}
+/** Report script */
+export interface ReportScript {
+    id: string;
+    name: string;
+    language: 'javascript' | 'vbscript';
+    code: string;
+    event?: ScriptEvent;
+}
+/** Script event */
+export type ScriptEvent = 'beforePrint' | 'afterPrint' | 'beforeBand' | 'afterBand' | 'beforeField' | 'afterField' | 'beforePage' | 'afterPage' | 'beforeGroup' | 'afterGroup' | 'onError';
+/** Subreport definition */
+export interface SubreportDefinition {
+    id: string;
+    name: string;
+    report: ReportDefinition;
+}
+/** Report execution request */
+export interface ReportExecutionRequest {
+    reportId: string;
+    parameters?: Record<string, unknown>;
+    outputFormat: ReportOutputFormat;
+    options?: ReportOutputOptions;
+}
+/** Report output options */
+export interface ReportOutputOptions {
+    pdfVersion?: '1.4' | '1.5' | '1.6' | '1.7' | '2.0';
+    pdfA?: boolean;
+    embedFonts?: boolean;
+    imageQuality?: number;
+    excelFormat?: 'xls' | 'xlsx';
+    onePagePerSheet?: boolean;
+    autoFitColumns?: boolean;
+    htmlEncoding?: string;
+    embedImages?: boolean;
+    inlineStyles?: boolean;
+    imageFormat?: 'png' | 'jpeg' | 'gif' | 'bmp' | 'tiff';
+    imageDpi?: number;
+    pageRange?: string;
+    watermark?: Watermark;
+    password?: string;
+}
+/** Report execution result */
+export interface ReportExecutionResult {
+    success: boolean;
+    data?: ArrayBuffer;
+    url?: string;
+    mimeType?: string;
+    filename?: string;
+    pages?: number;
+    executionTime?: number;
+    errors?: ReportError[];
+    warnings?: ReportWarning[];
+}
+/** Report error */
+export interface ReportError {
+    code: string;
+    message: string;
+    source?: string;
+    line?: number;
+}
+/** Report warning */
+export interface ReportWarning {
+    code: string;
+    message: string;
+    source?: string;
+}
+/** Report schedule */
+export interface ReportSchedule {
+    id: string;
+    reportId: string;
+    name: string;
+    description?: string;
+    enabled: boolean;
+    schedule: ScheduleConfig;
+    parameters?: Record<string, unknown>;
+    output: ScheduleOutput;
+    delivery: ScheduleDelivery[];
+    notifications?: ScheduleNotification[];
+    lastRun?: Date;
+    nextRun?: Date;
+    status?: ScheduleStatus;
+}
+/** Schedule configuration */
+export interface ScheduleConfig {
+    type: 'once' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'cron';
+    startDate?: Date;
+    endDate?: Date;
+    time?: string;
+    timezone?: string;
+    daysOfWeek?: number[];
+    daysOfMonth?: number[];
+    months?: number[];
+    cronExpression?: string;
+    retryOnFailure?: boolean;
+    maxRetries?: number;
+}
+/** Schedule output */
+export interface ScheduleOutput {
+    format: ReportOutputFormat;
+    options?: ReportOutputOptions;
+    filename?: string;
+    filenamePattern?: string;
+    compress?: boolean;
+}
+/** Schedule delivery */
+export interface ScheduleDelivery {
+    type: 'email' | 'ftp' | 'sftp' | 'sharepoint' | 'filesystem' | 'webhook';
+    config: DeliveryConfig;
+}
+/** Delivery configuration */
+export interface DeliveryConfig {
+    to?: string[];
+    cc?: string[];
+    bcc?: string[];
+    subject?: string;
+    body?: string;
+    attachReport?: boolean;
+    host?: string;
+    port?: number;
+    username?: string;
+    password?: string;
+    path?: string;
+    siteUrl?: string;
+    libraryName?: string;
+    folderPath?: string;
+    directory?: string;
+    overwrite?: boolean;
+    url?: string;
+    method?: string;
+    headers?: Record<string, string>;
+    includeReportData?: boolean;
+}
+/** Schedule notification */
+export interface ScheduleNotification {
+    type: 'email' | 'sms' | 'webhook';
+    event: 'success' | 'failure' | 'both';
+    recipients: string[];
+    template?: string;
+}
+/** Schedule status */
+export interface ScheduleStatus {
+    lastRunStatus: 'success' | 'failure' | 'running' | 'cancelled';
+    lastRunTime?: Date;
+    lastRunDuration?: number;
+    lastError?: string;
+    consecutiveFailures?: number;
+}
+/** Report gallery item */
+export interface ReportGalleryItem {
+    id: string;
+    name: string;
+    description?: string;
+    category?: string;
+    tags?: string[];
+    thumbnail?: string;
+    author?: string;
+    created?: Date;
+    modified?: Date;
+    downloads?: number;
+    rating?: number;
+    reportDefinition: ReportDefinition;
+}
+/** Report gallery category */
+export interface ReportGalleryCategory {
+    id: string;
+    name: string;
+    description?: string;
+    icon?: string;
+    parent?: string;
+    count?: number;
+}
+/** Drill-down action */
+export interface DrillDownAction {
+    type: 'report' | 'url' | 'javascript';
+    target?: string;
+    parameters?: DrillDownParameter[];
+    newWindow?: boolean;
+}
+/** Drill-down parameter */
+export interface DrillDownParameter {
+    name: string;
+    value?: unknown;
+    expression?: string;
+    field?: string;
+}
+/** Drill-through configuration */
+export interface DrillThroughConfig {
+    enabled: boolean;
+    targetReport?: string;
+    parameters?: DrillDownParameter[];
+    preserveParameters?: boolean;
+    openInNewWindow?: boolean;
+}
+//# sourceMappingURL=report-designer.d.ts.map