@nice2dev/ui-tools 1.0.10

package/dist/dashboard-designer.d.ts

@@ -0,0 +1,1238 @@
+/**
+ * @file dashboard-designer.ts
+ * @module @nice2dev/ui-tools
+ * @description PRO-15.1 — Dashboard Designer
+ *
+ * Types for dashboard designer: drag-drop dashboard builder, widgets, data connections,
+ * real-time updates, filters, drill-down, themes, sharing, embedding, alerts.
+ */
+/** Time range preset */
+export type TimeRangePreset = 'today' | 'yesterday' | 'last7days' | 'last30days' | 'last90days' | 'lastMonth' | 'lastQuarter' | 'lastYear' | 'thisMonth' | 'thisQuarter' | 'thisYear' | 'custom';
+/** Refresh interval */
+export type RefreshInterval = 'off' | '5s' | '10s' | '30s' | '1m' | '5m' | '15m' | '30m' | '1h';
+/** Dashboard layout mode */
+export type LayoutMode = 'grid' | 'freeform' | 'responsive';
+/** Dashboard designer configuration */
+export interface DashboardDesignerConfig {
+    /** Initial dashboard */
+    dashboard?: Dashboard;
+    /** Editor mode */
+    mode?: DashboardEditorMode;
+    /** Theme */
+    theme?: DashboardTheme;
+    /** Locale */
+    locale?: string;
+    /** Available widgets */
+    widgets?: WidgetDefinition[];
+    /** Custom widgets */
+    customWidgets?: CustomWidgetDefinition[];
+    /** Data sources */
+    dataSources?: DashboardDataSource[];
+    /** Enable real-time updates */
+    realtime?: boolean;
+    /** Default refresh interval */
+    refreshInterval?: RefreshInterval;
+    /** Enable collaboration */
+    collaboration?: boolean;
+    /** Enable comments */
+    comments?: boolean;
+    /** Enable version history */
+    versionHistory?: boolean;
+    /** Toolbar configuration */
+    toolbar?: DashboardToolbarConfig;
+    /** Sidebar configuration */
+    sidebar?: DashboardSidebarConfig;
+    /** Layout configuration */
+    layout?: DashboardLayoutConfig;
+    /** Export options */
+    exportOptions?: DashboardExportOptions;
+    /** Embedding options */
+    embedOptions?: DashboardEmbedOptions;
+    /** Alert configuration */
+    alertConfig?: DashboardAlertConfig;
+}
+/** Dashboard editor mode */
+export type DashboardEditorMode = 'edit' | 'preview' | 'view';
+/** Dashboard theme */
+export interface DashboardTheme {
+    name?: string;
+    primary?: string;
+    secondary?: string;
+    background?: string;
+    surface?: string;
+    text?: string;
+    border?: string;
+    grid?: string;
+    accent?: string;
+    error?: string;
+    warning?: string;
+    success?: string;
+    info?: string;
+    chart?: ChartColorPalette;
+}
+/** Chart color palette */
+export interface ChartColorPalette {
+    colors: string[];
+    gradients?: GradientConfig[];
+}
+/** Gradient configuration */
+export interface GradientConfig {
+    id: string;
+    type: 'linear' | 'radial';
+    stops: GradientStop[];
+    angle?: number;
+}
+/** Gradient stop */
+export interface GradientStop {
+    offset: number;
+    color: string;
+}
+/** Dashboard toolbar configuration */
+export interface DashboardToolbarConfig {
+    visible?: boolean;
+    items?: DashboardToolbarItem[];
+    customItems?: CustomToolbarItem[];
+}
+/** Dashboard toolbar item */
+export type DashboardToolbarItem = 'save' | 'undo' | 'redo' | 'preview' | 'share' | 'export' | 'fullscreen' | 'refresh' | 'timeRange' | 'filters' | 'addWidget' | 'settings' | 'separator';
+/** Custom toolbar item */
+export interface CustomToolbarItem {
+    id: string;
+    label?: string;
+    icon?: string;
+    tooltip?: string;
+    handler: () => void;
+    disabled?: boolean;
+    position?: number;
+}
+/** Dashboard sidebar configuration */
+export interface DashboardSidebarConfig {
+    visible?: boolean;
+    position?: 'left' | 'right';
+    width?: number;
+    tabs?: ('widgets' | 'data' | 'filters' | 'style' | 'settings')[];
+}
+/** Dashboard layout configuration */
+export interface DashboardLayoutConfig {
+    mode?: LayoutMode;
+    columns?: number;
+    rowHeight?: number;
+    margin?: [number, number];
+    containerPadding?: [number, number];
+    compactType?: 'vertical' | 'horizontal' | null;
+    preventCollision?: boolean;
+    isDraggable?: boolean;
+    isResizable?: boolean;
+    breakpoints?: LayoutBreakpoint[];
+}
+/** Layout breakpoint */
+export interface LayoutBreakpoint {
+    name: string;
+    width: number;
+    columns: number;
+}
+/** Dashboard export options */
+export interface DashboardExportOptions {
+    formats?: DashboardExportFormat[];
+    pageSize?: PageSize;
+    orientation?: 'portrait' | 'landscape';
+    includeFilters?: boolean;
+    includeTimestamp?: boolean;
+    customHeader?: string;
+    customFooter?: string;
+}
+/** Dashboard export format */
+export type DashboardExportFormat = 'pdf' | 'png' | 'svg' | 'csv' | 'xlsx' | 'json';
+/** Page size */
+export type PageSize = 'a4' | 'a3' | 'letter' | 'legal' | 'tabloid' | 'custom';
+/** Dashboard embed options */
+export interface DashboardEmbedOptions {
+    enabled?: boolean;
+    allowedDomains?: string[];
+    showToolbar?: boolean;
+    showFilters?: boolean;
+    interactivity?: 'full' | 'limited' | 'none';
+    authentication?: EmbedAuthentication;
+}
+/** Embed authentication */
+export interface EmbedAuthentication {
+    type: 'token' | 'jwt' | 'apiKey' | 'none';
+    tokenParam?: string;
+    expiry?: number;
+}
+/** Dashboard alert configuration */
+export interface DashboardAlertConfig {
+    enabled?: boolean;
+    channels?: AlertChannel[];
+    throttle?: number;
+    quietHours?: QuietHours;
+}
+/** Alert channel */
+export interface AlertChannel {
+    type: 'email' | 'slack' | 'teams' | 'webhook' | 'sms' | 'push';
+    config: Record<string, unknown>;
+    enabled?: boolean;
+}
+/** Quiet hours */
+export interface QuietHours {
+    enabled: boolean;
+    start: string;
+    end: string;
+    timezone: string;
+    days?: number[];
+}
+/** Dashboard */
+export interface Dashboard {
+    id: string;
+    name: string;
+    description?: string;
+    widgets: DashboardWidget[];
+    layout?: DashboardLayout;
+    filters?: DashboardFilter[];
+    parameters?: DashboardParameter[];
+    dataSources?: DashboardDataSource[];
+    theme?: DashboardTheme;
+    settings?: DashboardSettings;
+    metadata?: DashboardMetadata;
+    version?: string;
+}
+/** Dashboard layout */
+export interface DashboardLayout {
+    mode: LayoutMode;
+    items: LayoutItem[];
+    breakpoints?: LayoutBreakpointConfig[];
+}
+/** Layout item */
+export interface LayoutItem {
+    widgetId: string;
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+    minW?: number;
+    minH?: number;
+    maxW?: number;
+    maxH?: number;
+    static?: boolean;
+}
+/** Layout breakpoint config */
+export interface LayoutBreakpointConfig {
+    breakpoint: string;
+    items: LayoutItem[];
+}
+/** Dashboard settings */
+export interface DashboardSettings {
+    autoRefresh?: boolean;
+    refreshInterval?: RefreshInterval;
+    defaultTimeRange?: TimeRange;
+    timezone?: string;
+    dateFormat?: string;
+    numberFormat?: NumberFormat;
+    allowDrillDown?: boolean;
+    allowExport?: boolean;
+    allowFiltering?: boolean;
+    cacheEnabled?: boolean;
+    cacheTTL?: number;
+}
+/** Time range */
+export interface TimeRange {
+    preset?: TimeRangePreset;
+    start?: Date | string;
+    end?: Date | string;
+    relative?: RelativeTime;
+}
+/** Relative time */
+export interface RelativeTime {
+    value: number;
+    unit: 'minutes' | 'hours' | 'days' | 'weeks' | 'months' | 'years';
+}
+/** Number format */
+export interface NumberFormat {
+    locale?: string;
+    notation?: 'standard' | 'scientific' | 'engineering' | 'compact';
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+    useGrouping?: boolean;
+    currency?: string;
+    currencyDisplay?: 'symbol' | 'narrowSymbol' | 'code' | 'name';
+}
+/** Dashboard metadata */
+export interface DashboardMetadata {
+    created?: Date;
+    createdBy?: string;
+    modified?: Date;
+    modifiedBy?: string;
+    published?: boolean;
+    publishedDate?: Date;
+    status?: 'draft' | 'review' | 'approved' | 'published' | 'archived';
+    category?: string;
+    tags?: string[];
+    folder?: string;
+    thumbnail?: string;
+    views?: number;
+    favorites?: number;
+    sharing?: DashboardSharing;
+}
+/** Dashboard sharing */
+export interface DashboardSharing {
+    visibility: 'private' | 'team' | 'organization' | 'public';
+    sharedWith?: SharedUser[];
+    link?: ShareLink;
+    embedCode?: string;
+}
+/** Shared user */
+export interface SharedUser {
+    id: string;
+    email?: string;
+    name?: string;
+    role: 'viewer' | 'editor' | 'admin';
+    addedAt?: Date;
+    addedBy?: string;
+}
+/** Share link */
+export interface ShareLink {
+    url: string;
+    token?: string;
+    expiry?: Date;
+    password?: boolean;
+    views?: number;
+    maxViews?: number;
+}
+/** Dashboard widget */
+export interface DashboardWidget {
+    id: string;
+    type: WidgetType;
+    title?: string;
+    subtitle?: string;
+    description?: string;
+    dataSource?: WidgetDataSource;
+    config: WidgetConfig;
+    style?: WidgetStyle;
+    interactions?: WidgetInteraction[];
+    alerts?: WidgetAlert[];
+    visible?: boolean;
+    locked?: boolean;
+}
+/** Widget type */
+export type WidgetType = 'chart' | 'table' | 'kpi' | 'gauge' | 'map' | 'text' | 'image' | 'iframe' | 'filter' | 'list' | 'calendar' | 'timeline' | 'heatmap' | 'treemap' | 'sankey' | 'funnel' | 'scorecard' | 'custom';
+/** Widget data source */
+export interface WidgetDataSource {
+    type: 'query' | 'api' | 'static' | 'formula' | 'stream';
+    sourceId?: string;
+    query?: DataQuery;
+    apiConfig?: ApiDataConfig;
+    staticData?: unknown;
+    formula?: string;
+    streamConfig?: StreamConfig;
+    refresh?: WidgetRefreshConfig;
+    cache?: WidgetCacheConfig;
+}
+/** Data query */
+export interface DataQuery {
+    dimensions?: QueryDimension[];
+    measures?: QueryMeasure[];
+    filters?: QueryFilter[];
+    sort?: QuerySort[];
+    limit?: number;
+    offset?: number;
+    timeDimension?: TimeDimension;
+    segments?: string[];
+}
+/** Query dimension */
+export interface QueryDimension {
+    field: string;
+    alias?: string;
+    granularity?: 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'quarter' | 'year';
+}
+/** Query measure */
+export interface QueryMeasure {
+    field: string;
+    aggregation: AggregationType;
+    alias?: string;
+    format?: string;
+}
+/** Aggregation type */
+export type AggregationType = 'sum' | 'count' | 'countDistinct' | 'avg' | 'min' | 'max' | 'median' | 'percentile' | 'stddev' | 'variance' | 'first' | 'last';
+/** Query filter */
+export interface QueryFilter {
+    field: string;
+    operator: FilterOperator;
+    value: unknown;
+    and?: QueryFilter[];
+    or?: QueryFilter[];
+}
+/** Filter operator */
+export type FilterOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'greaterThan' | 'greaterThanOrEqual' | 'lessThan' | 'lessThanOrEqual' | 'between' | 'notBetween' | 'in' | 'notIn' | 'isNull' | 'isNotNull' | 'beforeDate' | 'afterDate' | 'inDateRange';
+/** Query sort */
+export interface QuerySort {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+/** Time dimension */
+export interface TimeDimension {
+    field: string;
+    granularity?: string;
+    dateRange?: [string, string] | string;
+}
+/** API data config */
+export interface ApiDataConfig {
+    url: string;
+    method?: 'GET' | 'POST';
+    headers?: Record<string, string>;
+    body?: unknown;
+    responseMapping?: ResponseMapping;
+    authentication?: ApiAuthentication;
+}
+/** Response mapping */
+export interface ResponseMapping {
+    dataPath?: string;
+    fields?: FieldMapping[];
+}
+/** Field mapping */
+export interface FieldMapping {
+    source: string;
+    target: string;
+    transform?: string;
+}
+/** API authentication */
+export interface ApiAuthentication {
+    type: 'none' | 'basic' | 'bearer' | 'apiKey' | 'oauth2';
+    credentials?: Record<string, string>;
+}
+/** Stream config */
+export interface StreamConfig {
+    type: 'websocket' | 'sse' | 'polling';
+    url: string;
+    messageType?: string;
+    reconnect?: boolean;
+    reconnectInterval?: number;
+}
+/** Widget refresh config */
+export interface WidgetRefreshConfig {
+    enabled?: boolean;
+    interval?: number;
+    onFilterChange?: boolean;
+    onTimeRangeChange?: boolean;
+}
+/** Widget cache config */
+export interface WidgetCacheConfig {
+    enabled?: boolean;
+    ttl?: number;
+    key?: string;
+}
+/** Widget configuration */
+export type WidgetConfig = ChartWidgetConfig | TableWidgetConfig | KPIWidgetConfig | GaugeWidgetConfig | MapWidgetConfig | TextWidgetConfig | ImageWidgetConfig | IframeWidgetConfig | FilterWidgetConfig | ListWidgetConfig | CalendarWidgetConfig | TimelineWidgetConfig | HeatmapWidgetConfig | TreemapWidgetConfig | SankeyWidgetConfig | FunnelWidgetConfig | ScorecardWidgetConfig | CustomWidgetConfig;
+/** Chart widget config */
+export interface ChartWidgetConfig {
+    chartType: ChartType;
+    series: ChartSeries[];
+    xAxis?: AxisConfig;
+    yAxis?: AxisConfig | AxisConfig[];
+    legend?: LegendConfig;
+    tooltip?: TooltipConfig;
+    animation?: AnimationConfig;
+    colors?: string[];
+    stacked?: boolean;
+    normalized?: boolean;
+    showDataLabels?: boolean;
+}
+/** Chart type */
+export type ChartType = 'line' | 'area' | 'bar' | 'column' | 'pie' | 'donut' | 'scatter' | 'bubble' | 'radar' | 'polar' | 'heatmap' | 'treemap' | 'sankey' | 'funnel' | 'waterfall' | 'boxplot' | 'candlestick' | 'histogram' | 'combination';
+/** Chart series */
+export interface ChartSeries {
+    name: string;
+    field: string;
+    type?: ChartType;
+    color?: string;
+    yAxisIndex?: number;
+    smooth?: boolean;
+    showSymbol?: boolean;
+    areaStyle?: AreaStyle;
+    lineStyle?: LineStyle;
+    itemStyle?: ItemStyle;
+}
+/** Area style */
+export interface AreaStyle {
+    opacity?: number;
+    color?: string | GradientConfig;
+}
+/** Line style */
+export interface LineStyle {
+    width?: number;
+    type?: 'solid' | 'dashed' | 'dotted';
+    color?: string;
+}
+/** Item style */
+export interface ItemStyle {
+    color?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderRadius?: number;
+}
+/** Axis config */
+export interface AxisConfig {
+    show?: boolean;
+    name?: string;
+    type?: 'category' | 'value' | 'time' | 'log';
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    min?: number | 'auto';
+    max?: number | 'auto';
+    splitNumber?: number;
+    axisLine?: AxisLine;
+    axisTick?: AxisTick;
+    axisLabel?: AxisLabel;
+    splitLine?: SplitLine;
+}
+/** Axis line */
+export interface AxisLine {
+    show?: boolean;
+    lineStyle?: LineStyle;
+}
+/** Axis tick */
+export interface AxisTick {
+    show?: boolean;
+    alignWithLabel?: boolean;
+}
+/** Axis label */
+export interface AxisLabel {
+    show?: boolean;
+    rotate?: number;
+    formatter?: string;
+}
+/** Split line */
+export interface SplitLine {
+    show?: boolean;
+    lineStyle?: LineStyle;
+}
+/** Legend config */
+export interface LegendConfig {
+    show?: boolean;
+    position?: 'top' | 'bottom' | 'left' | 'right';
+    orient?: 'horizontal' | 'vertical';
+    align?: 'left' | 'center' | 'right';
+}
+/** Tooltip config */
+export interface TooltipConfig {
+    show?: boolean;
+    trigger?: 'item' | 'axis' | 'none';
+    formatter?: string;
+    backgroundColor?: string;
+    borderColor?: string;
+    textStyle?: TextStyle;
+}
+/** Text style */
+export interface TextStyle {
+    color?: string;
+    fontSize?: number;
+    fontWeight?: string | number;
+    fontFamily?: string;
+}
+/** Animation config */
+export interface AnimationConfig {
+    enabled?: boolean;
+    duration?: number;
+    easing?: string;
+    delay?: number;
+}
+/** Table widget config */
+export interface TableWidgetConfig {
+    columns: TableColumn[];
+    pagination?: TablePagination;
+    sorting?: TableSorting;
+    filtering?: TableFiltering;
+    selection?: TableSelection;
+    rowActions?: RowAction[];
+    density?: 'compact' | 'standard' | 'comfortable';
+    striped?: boolean;
+    bordered?: boolean;
+    sticky?: 'header' | 'column' | 'both' | 'none';
+    expandable?: ExpandableConfig;
+    grouping?: GroupingConfig;
+}
+/** Table column */
+export interface TableColumn {
+    field: string;
+    header: string;
+    width?: number | string;
+    minWidth?: number;
+    maxWidth?: number;
+    align?: 'left' | 'center' | 'right';
+    sortable?: boolean;
+    filterable?: boolean;
+    hidden?: boolean;
+    pinned?: 'left' | 'right';
+    format?: ColumnFormat;
+    cellRenderer?: string;
+    aggregation?: AggregationType;
+}
+/** Column format */
+export interface ColumnFormat {
+    type: 'text' | 'number' | 'currency' | 'percentage' | 'date' | 'datetime' | 'boolean' | 'link' | 'image' | 'badge' | 'progress' | 'sparkline' | 'custom';
+    pattern?: string;
+    locale?: string;
+    currency?: string;
+    trueLabel?: string;
+    falseLabel?: string;
+    customFormatter?: string;
+}
+/** Table pagination */
+export interface TablePagination {
+    enabled?: boolean;
+    pageSize?: number;
+    pageSizeOptions?: number[];
+    showTotal?: boolean;
+}
+/** Table sorting */
+export interface TableSorting {
+    enabled?: boolean;
+    multi?: boolean;
+    defaultSort?: QuerySort[];
+}
+/** Table filtering */
+export interface TableFiltering {
+    enabled?: boolean;
+    inline?: boolean;
+    quickFilter?: boolean;
+}
+/** Table selection */
+export interface TableSelection {
+    enabled?: boolean;
+    mode?: 'single' | 'multiple';
+    checkbox?: boolean;
+}
+/** Row action */
+export interface RowAction {
+    id: string;
+    label: string;
+    icon?: string;
+    handler?: string;
+    visible?: string;
+    disabled?: string;
+}
+/** Expandable config */
+export interface ExpandableConfig {
+    enabled: boolean;
+    renderer?: string;
+    detailWidget?: string;
+}
+/** Grouping config */
+export interface GroupingConfig {
+    enabled: boolean;
+    fields?: string[];
+    expanded?: boolean;
+    aggregations?: GroupAggregation[];
+}
+/** Group aggregation */
+export interface GroupAggregation {
+    field: string;
+    aggregation: AggregationType;
+    label?: string;
+}
+/** KPI widget config */
+export interface KPIWidgetConfig {
+    value: KPIValue;
+    comparison?: KPIComparison;
+    trend?: KPITrend;
+    sparkline?: SparklineConfig;
+    icon?: string;
+    format?: NumberFormat;
+    thresholds?: KPIThreshold[];
+}
+/** KPI value */
+export interface KPIValue {
+    field: string;
+    aggregation?: AggregationType;
+    prefix?: string;
+    suffix?: string;
+}
+/** KPI comparison */
+export interface KPIComparison {
+    type: 'previousPeriod' | 'previousYear' | 'target' | 'custom';
+    value?: number;
+    label?: string;
+    showPercentage?: boolean;
+    invertColors?: boolean;
+}
+/** KPI trend */
+export interface KPITrend {
+    field: string;
+    periods?: number;
+    showDirection?: boolean;
+}
+/** Sparkline config */
+export interface SparklineConfig {
+    type: 'line' | 'area' | 'bar';
+    field: string;
+    height?: number;
+    color?: string;
+}
+/** KPI threshold */
+export interface KPIThreshold {
+    value: number;
+    color: string;
+    label?: string;
+}
+/** Gauge widget config */
+export interface GaugeWidgetConfig {
+    value: GaugeValue;
+    min?: number;
+    max?: number;
+    ranges?: GaugeRange[];
+    format?: NumberFormat;
+    showValue?: boolean;
+    showLabels?: boolean;
+    animation?: boolean;
+    arcWidth?: number;
+    type?: 'semicircle' | 'full' | 'linear';
+}
+/** Gauge value */
+export interface GaugeValue {
+    field: string;
+    aggregation?: AggregationType;
+}
+/** Gauge range */
+export interface GaugeRange {
+    from: number;
+    to: number;
+    color: string;
+    label?: string;
+}
+/** Map widget config */
+export interface MapWidgetConfig {
+    type: 'choropleth' | 'bubble' | 'heatmap' | 'marker' | 'flow';
+    geoField: string;
+    valueField?: string;
+    latField?: string;
+    lngField?: string;
+    sizeField?: string;
+    colorField?: string;
+    mapType?: 'world' | 'country' | 'state' | 'custom';
+    region?: string;
+    zoom?: number;
+    center?: [number, number];
+    colorScale?: string[];
+    legend?: LegendConfig;
+    tooltip?: TooltipConfig;
+    markerCluster?: boolean;
+}
+/** Text widget config */
+export interface TextWidgetConfig {
+    content: string;
+    format?: 'plain' | 'markdown' | 'html';
+    align?: 'left' | 'center' | 'right';
+    verticalAlign?: 'top' | 'middle' | 'bottom';
+    fontSize?: number;
+    fontWeight?: string | number;
+    fontFamily?: string;
+    color?: string;
+    backgroundColor?: string;
+    padding?: number | string;
+}
+/** Image widget config */
+export interface ImageWidgetConfig {
+    src: string;
+    alt?: string;
+    fit?: 'contain' | 'cover' | 'fill' | 'none' | 'scale-down';
+    position?: string;
+    link?: string;
+    caption?: string;
+}
+/** Iframe widget config */
+export interface IframeWidgetConfig {
+    src: string;
+    sandbox?: string;
+    allow?: string;
+    loading?: 'eager' | 'lazy';
+}
+/** Filter widget config */
+export interface FilterWidgetConfig {
+    filterType: 'select' | 'multiSelect' | 'dateRange' | 'slider' | 'search' | 'checkbox' | 'radio';
+    field: string;
+    label?: string;
+    placeholder?: string;
+    options?: FilterOption[];
+    optionsSource?: WidgetDataSource;
+    defaultValue?: unknown;
+    clearable?: boolean;
+    affects?: string[];
+}
+/** Filter option */
+export interface FilterOption {
+    value: unknown;
+    label: string;
+    icon?: string;
+    color?: string;
+}
+/** List widget config */
+export interface ListWidgetConfig {
+    itemTemplate: string;
+    emptyMessage?: string;
+    maxItems?: number;
+    showMore?: boolean;
+    clickAction?: DrillDownAction;
+}
+/** Calendar widget config */
+export interface CalendarWidgetConfig {
+    dateField: string;
+    titleField?: string;
+    colorField?: string;
+    view?: 'month' | 'week' | 'day' | 'agenda';
+    firstDayOfWeek?: number;
+    showWeekNumbers?: boolean;
+    eventClick?: DrillDownAction;
+}
+/** Timeline widget config */
+export interface TimelineWidgetConfig {
+    dateField: string;
+    titleField: string;
+    descriptionField?: string;
+    iconField?: string;
+    colorField?: string;
+    orientation?: 'vertical' | 'horizontal';
+    alternating?: boolean;
+}
+/** Heatmap widget config */
+export interface HeatmapWidgetConfig {
+    xField: string;
+    yField: string;
+    valueField: string;
+    colorScale?: string[];
+    showLabels?: boolean;
+    tooltip?: TooltipConfig;
+}
+/** Treemap widget config */
+export interface TreemapWidgetConfig {
+    hierarchyFields: string[];
+    valueField: string;
+    colorField?: string;
+    labelField?: string;
+    colorScale?: string[];
+    showBreadcrumb?: boolean;
+    drillDown?: boolean;
+}
+/** Sankey widget config */
+export interface SankeyWidgetConfig {
+    sourceField: string;
+    targetField: string;
+    valueField: string;
+    nodeAlign?: 'left' | 'right' | 'center' | 'justify';
+    nodeWidth?: number;
+    nodePadding?: number;
+    linkOpacity?: number;
+}
+/** Funnel widget config */
+export interface FunnelWidgetConfig {
+    labelField: string;
+    valueField: string;
+    sort?: 'descending' | 'ascending' | 'none';
+    labelPosition?: 'inside' | 'outside';
+    showConversion?: boolean;
+    colors?: string[];
+}
+/** Scorecard widget config */
+export interface ScorecardWidgetConfig {
+    metrics: ScorecardMetric[];
+    layout?: 'horizontal' | 'vertical' | 'grid';
+    columns?: number;
+}
+/** Scorecard metric */
+export interface ScorecardMetric {
+    label: string;
+    value: KPIValue;
+    comparison?: KPIComparison;
+    format?: NumberFormat;
+    icon?: string;
+    color?: string;
+}
+/** Custom widget config */
+export interface CustomWidgetConfig {
+    customType: string;
+    options?: Record<string, unknown>;
+}
+/** Widget style */
+export interface WidgetStyle {
+    backgroundColor?: string;
+    borderColor?: string;
+    borderWidth?: number;
+    borderRadius?: number;
+    boxShadow?: string;
+    padding?: number | string;
+    titleStyle?: TextStyle;
+    subtitleStyle?: TextStyle;
+}
+/** Widget interaction */
+export interface WidgetInteraction {
+    type: 'click' | 'hover' | 'select' | 'doubleClick';
+    target?: string;
+    action: InteractionAction;
+}
+/** Interaction action */
+export interface InteractionAction {
+    type: 'filter' | 'drillDown' | 'navigate' | 'openModal' | 'runQuery' | 'custom';
+    config: DrillDownAction | FilterAction | NavigateAction | ModalAction | QueryAction | CustomAction;
+}
+/** Drill down action */
+export interface DrillDownAction {
+    dashboard?: string;
+    widget?: string;
+    parameters?: Record<string, string>;
+    newTab?: boolean;
+}
+/** Filter action */
+export interface FilterAction {
+    field: string;
+    operator?: FilterOperator;
+    valueFrom?: string;
+    targets?: string[];
+}
+/** Navigate action */
+export interface NavigateAction {
+    url: string;
+    parameters?: Record<string, string>;
+    newTab?: boolean;
+}
+/** Modal action */
+export interface ModalAction {
+    title?: string;
+    widget?: string;
+    dashboard?: string;
+    width?: number | string;
+    height?: number | string;
+}
+/** Query action */
+export interface QueryAction {
+    queryId: string;
+    parameters?: Record<string, string>;
+}
+/** Custom action */
+export interface CustomAction {
+    handler: string;
+    parameters?: Record<string, unknown>;
+}
+/** Widget alert */
+export interface WidgetAlert {
+    id: string;
+    name: string;
+    enabled: boolean;
+    condition: AlertCondition;
+    channels: string[];
+    message?: string;
+    severity?: 'info' | 'warning' | 'error' | 'critical';
+    cooldown?: number;
+    schedule?: AlertSchedule;
+}
+/** Alert condition */
+export interface AlertCondition {
+    metric: string;
+    operator: FilterOperator;
+    threshold: number;
+    duration?: number;
+    aggregation?: AggregationType;
+}
+/** Alert schedule */
+export interface AlertSchedule {
+    enabled: boolean;
+    cron?: string;
+    timezone?: string;
+}
+/** Widget definition */
+export interface WidgetDefinition {
+    type: WidgetType;
+    name: string;
+    description?: string;
+    icon?: string;
+    category?: string;
+    defaultConfig: WidgetConfig;
+    configSchema?: WidgetConfigSchema;
+    thumbnail?: string;
+}
+/** Widget config schema */
+export interface WidgetConfigSchema {
+    properties: ConfigProperty[];
+    groups?: ConfigPropertyGroup[];
+}
+/** Config property */
+export interface ConfigProperty {
+    name: string;
+    label: string;
+    type: ConfigPropertyType;
+    defaultValue?: unknown;
+    required?: boolean;
+    options?: ConfigOption[];
+    min?: number;
+    max?: number;
+    group?: string;
+    description?: string;
+    advanced?: boolean;
+    dependsOn?: PropertyDependency;
+}
+/** Config property type */
+export type ConfigPropertyType = 'string' | 'number' | 'boolean' | 'select' | 'multiSelect' | 'color' | 'icon' | 'field' | 'fieldList' | 'query' | 'json' | 'code';
+/** Config option */
+export interface ConfigOption {
+    value: unknown;
+    label: string;
+    icon?: string;
+}
+/** Config property group */
+export interface ConfigPropertyGroup {
+    id: string;
+    label: string;
+    collapsed?: boolean;
+}
+/** Property dependency */
+export interface PropertyDependency {
+    property: string;
+    operator: 'equals' | 'notEquals' | 'in' | 'notIn';
+    value: unknown;
+}
+/** Custom widget definition */
+export interface CustomWidgetDefinition extends WidgetDefinition {
+    render: (props: CustomWidgetRenderProps) => unknown;
+    editor?: (props: CustomWidgetEditorProps) => unknown;
+}
+/** Custom widget render props */
+export interface CustomWidgetRenderProps {
+    config: CustomWidgetConfig;
+    data: unknown;
+    width: number;
+    height: number;
+    theme: DashboardTheme;
+}
+/** Custom widget editor props */
+export interface CustomWidgetEditorProps {
+    config: CustomWidgetConfig;
+    onChange: (config: CustomWidgetConfig) => void;
+}
+/** Dashboard filter */
+export interface DashboardFilter {
+    id: string;
+    field: string;
+    label?: string;
+    type: FilterWidgetType;
+    defaultValue?: unknown;
+    options?: FilterOption[];
+    optionsQuery?: DataQuery;
+    required?: boolean;
+    multiple?: boolean;
+    cascadeFrom?: string;
+    affectsAll?: boolean;
+    affects?: string[];
+    visible?: boolean;
+}
+/** Filter widget type */
+export type FilterWidgetType = 'dropdown' | 'multiDropdown' | 'dateRange' | 'datePicker' | 'slider' | 'rangeSlider' | 'text' | 'checkbox' | 'radio' | 'toggle' | 'custom';
+/** Dashboard parameter */
+export interface DashboardParameter {
+    id: string;
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'date' | 'array';
+    defaultValue?: unknown;
+    source?: 'url' | 'filter' | 'user' | 'system';
+    required?: boolean;
+}
+/** Dashboard data source */
+export interface DashboardDataSource {
+    id: string;
+    name: string;
+    type: DataSourceType;
+    connection: DataSourceConnection;
+    schema?: DataSourceSchema;
+    cacheConfig?: DataSourceCache;
+    rateLimiting?: RateLimiting;
+}
+/** Data source type */
+export type DataSourceType = 'sql' | 'rest' | 'graphql' | 'mongodb' | 'elasticsearch' | 'bigquery' | 'snowflake' | 'redshift' | 'databricks' | 'athena' | 'clickhouse' | 'timescale' | 'influxdb' | 'prometheus' | 'csv' | 'json' | 'googleSheets' | 'airtable' | 'salesforce' | 'hubspot' | 'stripe' | 'custom';
+/** Data source connection */
+export interface DataSourceConnection {
+    host?: string;
+    port?: number;
+    database?: string;
+    username?: string;
+    password?: string;
+    ssl?: boolean;
+    url?: string;
+    apiKey?: string;
+    authType?: 'none' | 'basic' | 'bearer' | 'oauth2' | 'apiKey';
+    credentials?: Record<string, string>;
+    options?: Record<string, unknown>;
+}
+/** Data source schema */
+export interface DataSourceSchema {
+    tables?: TableSchema[];
+    views?: ViewSchema[];
+    procedures?: ProcedureSchema[];
+}
+/** Table schema */
+export interface TableSchema {
+    name: string;
+    schema?: string;
+    columns: ColumnSchema[];
+    primaryKey?: string[];
+    foreignKeys?: ForeignKey[];
+}
+/** View schema */
+export interface ViewSchema {
+    name: string;
+    schema?: string;
+    columns: ColumnSchema[];
+    query?: string;
+}
+/** Column schema */
+export interface ColumnSchema {
+    name: string;
+    type: string;
+    nullable?: boolean;
+    defaultValue?: unknown;
+    description?: string;
+}
+/** Foreign key */
+export interface ForeignKey {
+    columns: string[];
+    referencedTable: string;
+    referencedColumns: string[];
+}
+/** Procedure schema */
+export interface ProcedureSchema {
+    name: string;
+    schema?: string;
+    parameters: ProcedureParameter[];
+    returnType?: string;
+}
+/** Procedure parameter */
+export interface ProcedureParameter {
+    name: string;
+    type: string;
+    direction: 'in' | 'out' | 'inout';
+    defaultValue?: unknown;
+}
+/** Data source cache */
+export interface DataSourceCache {
+    enabled: boolean;
+    ttl: number;
+    maxSize?: number;
+    invalidateOn?: string[];
+}
+/** Rate limiting */
+export interface RateLimiting {
+    enabled: boolean;
+    requestsPerSecond?: number;
+    requestsPerMinute?: number;
+    burstSize?: number;
+}
+/** Scheduled report */
+export interface ScheduledReport {
+    id: string;
+    dashboardId: string;
+    name: string;
+    enabled: boolean;
+    schedule: ReportSchedule;
+    format: DashboardExportFormat;
+    filters?: Record<string, unknown>;
+    recipients: ReportRecipient[];
+    options?: ScheduledReportOptions;
+}
+/** Report schedule */
+export interface ReportSchedule {
+    type: 'cron' | 'interval' | 'once';
+    cron?: string;
+    interval?: number;
+    runAt?: Date;
+    timezone?: string;
+}
+/** Report recipient */
+export interface ReportRecipient {
+    type: 'email' | 'slack' | 'teams' | 'webhook' | 's3' | 'ftp';
+    destination: string;
+    config?: Record<string, unknown>;
+}
+/** Scheduled report options */
+export interface ScheduledReportOptions {
+    timeRange?: TimeRange;
+    pageSize?: PageSize;
+    orientation?: 'portrait' | 'landscape';
+    includeFilters?: boolean;
+    includeTimestamp?: boolean;
+    password?: string;
+    compress?: boolean;
+}
+/** Dashboard annotation */
+export interface DashboardAnnotation {
+    id: string;
+    widgetId?: string;
+    type: AnnotationType;
+    content: string;
+    author?: string;
+    created?: Date;
+    modified?: Date;
+    position?: AnnotationPosition;
+    timeRange?: TimeRange;
+    visibility?: 'private' | 'team' | 'public';
+    tags?: string[];
+}
+/** Annotation type */
+export type AnnotationType = 'note' | 'highlight' | 'marker' | 'range' | 'line' | 'region';
+/** Annotation position */
+export interface AnnotationPosition {
+    x?: number;
+    y?: number;
+    x2?: number;
+    y2?: number;
+    dataPoint?: unknown;
+}
+/** Dashboard version */
+export interface DashboardVersion {
+    id: string;
+    dashboardId: string;
+    version: number;
+    name?: string;
+    description?: string;
+    dashboard: Dashboard;
+    author?: string;
+    created: Date;
+    changes?: VersionChange[];
+    tags?: string[];
+}
+/** Version change */
+export interface VersionChange {
+    type: 'add' | 'remove' | 'modify';
+    path: string;
+    widgetId?: string;
+    before?: unknown;
+    after?: unknown;
+}
+/** Dashboard collaboration session */
+export interface DashboardCollaborationSession {
+    id: string;
+    dashboardId: string;
+    users: CollaborationUser[];
+    cursors: UserCursor[];
+    selections: UserSelection[];
+    version: number;
+    lastModified: Date;
+}
+/** Collaboration user */
+export interface CollaborationUser {
+    id: string;
+    name: string;
+    color: string;
+    avatar?: string;
+    online: boolean;
+    lastActivity?: Date;
+}
+/** User cursor */
+export interface UserCursor {
+    userId: string;
+    widgetId?: string;
+    x?: number;
+    y?: number;
+    timestamp: Date;
+}
+/** User selection */
+export interface UserSelection {
+    userId: string;
+    widgetId?: string;
+    type?: 'widget' | 'range' | 'cell';
+    timestamp: Date;
+}
+//# sourceMappingURL=dashboard-designer.d.ts.map