react-semaphor 0.0.37719 → 0.1.1

package/dist/types/surfboard.d.ts

@@ -1,22 +1,60 @@
+import { ColumnSizingState } from '@tanstack/react-table';
 import { FontSpec } from 'chart.js';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 
 export declare type AggregateCalc = 'AVG' | 'MIN' | 'MAX' | 'SUM' | 'COUNT' | 'COUNT_DISTINCT';
 
+declare type AggregateFunction = 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX' | 'MEDIAN' | 'DISTINCT';
+
+declare type AIContext = {
+    selectedEntities: SelectedEntities;
+    fileAttachments?: FileAttachment[];
+};
+
 export declare type AIScopeTable = {
     connectionId: string;
     connectionType: string;
-    databaseName?: string;
-    schemaName?: string;
-    tableName?: string;
-    datamodelName?: string;
+    databaseName: string;
+    schemaName: string;
+    tableName: string;
+    datamodelId: string;
+    datamodelName: string;
 };
 
+export declare type AssistantId = 'dashboard-assistant' | 'editor-assistant';
+
 export declare type AuthToken = {
     accessToken: string;
     refreshToken?: string;
 };
 
+export declare type AxisConfig = {
+    enabled?: boolean;
+    name?: {
+        enabled: boolean;
+        text?: string;
+    };
+    position?: 'auto' | 'top' | 'bottom' | 'left' | 'right';
+    labels?: {
+        enabled: boolean;
+        rotation?: 'auto' | 0 | 45 | 90 | -45 | -90;
+    };
+    formatOptions?: TFormatOptions;
+    scale?: {
+        min?: number | 'auto';
+        max?: number | 'auto';
+        stepSize?: number | 'auto';
+    };
+};
+
+declare interface BaseColumn {
+    id: string;
+    name: string;
+    label?: string;
+    type: ColumnType;
+    table?: string;
+}
+
 declare type BaseCustomCard = {
     cardId: string;
     replaceDefault?: boolean;
@@ -37,6 +75,59 @@ export declare type CacheConfig = {
     status: 'on' | 'on-refresh' | 'off';
 };
 
+declare interface CardConfig {
+    groupByColumns?: GroupByField[];
+    metricColumns?: MetricField[];
+    pivotByColumns?: PivotByField[];
+    sortByColumns?: SortByField[];
+    filters?: FilterGroup;
+    joinPlan?: JoinPlan;
+    rowLimit?: number;
+    /**
+     * One or more hierarchies that define drillable paths through dimensions.
+     */
+    drillHierarchies?: DrillHierarchy[];
+    /**
+     * Optional list of dimensions allowed for dynamic drill-down across this card.
+     * Used only when drill steps contain `mode: 'dynamicDrill'` or `type: 'dynamic'`.
+     */
+    allowedDrillTargets?: Field[];
+    /**
+     * NOT UOptional preload settings for inline drill previews
+     */
+    inlineDrillPreview?: {
+        enabled: boolean;
+        limit: number;
+        mode: 'lazy' | 'preloaded';
+    };
+    /**
+     * Configuration for on-click dashboard filters triggered by this card.
+     */
+    clickFilterInteractions?: ClickFilterInteraction[];
+    comparisonType?: 'none' | 'previous_period' | 'same_period_last_year' | 'target';
+    targetValue?: number;
+    showTrendline?: boolean;
+    trendlineWindow?: number;
+    trendlineGranularity?: 'day' | 'week' | 'month';
+    rowAggregates?: Array<{
+        label?: string;
+        function: AggregateFunction;
+        groupLevel: string | 'ALL';
+    }>;
+    columnAggregates?: Array<{
+        label?: string;
+        function: AggregateFunction;
+        pivotLevel: string | 'ALL';
+    }>;
+}
+
+declare interface CardInteractionConfig {
+    allowedDrillTargets?: Field[];
+    drillHierarchies?: DrillHierarchy[];
+    drillInteractions?: DrillInteraction[];
+    clickFilterInteractions?: ClickFilterInteraction[];
+}
+
 declare type CardWithContent = BaseCustomCard & {
     content: React.FC<{
         card: TCard;
@@ -55,25 +146,130 @@ declare type CardWithFooter = BaseCustomCard & {
     }>;
 };
 
+declare interface ClickFilterInteraction {
+    mode: 'clickFilter';
+    /**
+     * Fields from the chart element that should be used as filters.
+     * e.g., [region, ship_mode] from a stacked bar chart
+     */
+    filterFields: Field[];
+    /**
+     * Should this card visually highlight when clicked?
+     */
+    highlightSelf?: boolean;
+    /**
+     * Cards this filter applies to (inclusive).
+     * If omitted and `excludeCardIds` is also omitted → applies to all cards except self.
+     */
+    applyToCardIds?: string[];
+    /**
+     * Cards to explicitly exclude from receiving this filter.
+     * Takes effect only if `applyToCardIds` is undefined (acts as override).
+     */
+    excludeCardIds?: string[];
+    /**
+     * Optional UI label or tooltip.
+     */
+    label?: string;
+}
+
+export declare type ColorConfig = {
+    segments: Record<string, string>;
+};
+
 export declare type ColorRange = {
     start: number;
     end: number;
     color: string;
 };
 
+declare interface ColorRange_2 {
+    min: number;
+    max: number;
+    color: string;
+    applyTo: 'cell' | 'row';
+}
+
+declare interface ColumnSettings {
+    type: 'none' | 'text' | 'number' | 'date' | 'badge' | 'link' | 'progress';
+    textAlign: 'left' | 'center' | 'right';
+    width: number;
+    minWidth?: number;
+    maxWidth?: number;
+    textOverflow?: 'ellipsis' | 'wrap' | 'clip';
+    textWrap: 'wrap' | 'nowrap';
+    numberFormat: {
+        style: 'decimal' | 'currency' | 'percent';
+        currency: string;
+        locale: string;
+        minimumFractionDigits: number;
+        maximumFractionDigits: number;
+        showDataBar: boolean;
+        dataBarColor: string;
+        dataBarMinValue?: number;
+        dataBarMaxValue?: number;
+    };
+    dateFormat: {
+        format: string;
+        useCustomFormat: boolean;
+        customFormat: string;
+        useRelativeTime: boolean;
+        timezone?: string;
+        sourceTimezone?: string;
+    };
+    colorRanges: ColorRange_2[];
+}
+
+declare type ColumnSettingsMap = Record<string, ColumnSettings>;
+
+declare type ColumnType = 'string' | 'number' | 'date';
+
 export declare type ConnectionPolicy = {
     connectionId?: string;
     name: string;
     params: Params;
 };
 
+declare type ConnectionType = 'GoogleSheets' | 'MySQL' | 'MSSQL' | 'PostgreSQL' | 'BigQuery' | 'Redshift' | 'Snowflake' | 'S3' | 'clickhouse' | 'S3Tables' | 'API' | 'none';
+
 export declare type CustomCard = CardWithContent | CardWithFooter;
 
+export declare type DashboardEventHandlers = {
+    onExportData?: (payload: ExportDataPayload) => void;
+};
+
 declare type DashboardPlusProps = {
     showControls?: boolean;
     showFooter?: boolean;
 } & DashboardProps;
 
+/**
+ * Unified dashboard preferences for both card display and UI modes
+ */
+export declare type DashboardPreferences = {
+    /**
+     * Visual display preferences for cards
+     * Controls how card content is rendered (headers, footers, etc.)
+     */
+    cardDisplay?: VisualDisplayPreferences;
+    /**
+     * UI modes for developer and debug features
+     * Controls what developer tools and debug panels are available
+     */
+    uiMode?: {
+        /**
+         * Enable developer mode
+         * Shows additional controls and debug information
+         */
+        developer?: boolean;
+        /**
+         * Enable console mode
+         * Shows console panel for debugging
+         */
+        console?: boolean;
+    };
+};
+
 export declare type DashboardProps = {
     id?: string;
     /**
@@ -83,10 +279,7 @@ export declare type DashboardProps = {
     /**
      * Default filter values for the dashboard. The dashboard will be filtered by these values when the user loads the dashboard.
      */
-    defaultFilterValues?: {
-        filterId: string;
-        values: string[] | number[];
-    }[] | TFilterValue[];
+    defaultFilterValues?: TFilterValue[];
     customStyle?: TStyle;
     currentTheme?: Theme;
     version?: string;
@@ -98,6 +291,7 @@ export declare type DashboardProps = {
     onFilterValuesChange?: (filterValues: TFilterValue[]) => void;
     LoadingComponent?: (props: LoadingProps) => React.ReactNode;
     ErrorComponent?: (props: ErrorProps) => React.ReactNode;
+    eventHandlers?: DashboardEventHandlers;
     /**
      * Placeholders for the dashboard.
      */
@@ -106,20 +300,201 @@ export declare type DashboardProps = {
      * The id of the sheet to be selected when the dashboard is loaded.
      */
     selectedSheetId?: string;
+    /**
+     * Unified preferences for dashboard configuration
+     * Includes both card display preferences and UI mode settings
+     */
+    preferences?: DashboardPreferences;
 };
 
+declare interface DatabaseEntityReference {
+    connectionId: string;
+    connectionType: ConnectionType;
+    type: EntityType;
+    dbObjectType?: string;
+    dialect?: Dialect;
+    database?: string;
+    schema?: string;
+    name: string;
+}
+
+declare type DatabaseEntityType = 'table' | 'view';
+
+declare interface DataModelEntityReference extends DatabaseEntityReference {
+    type: 'model';
+    id: string;
+    label: string;
+    description: string;
+}
+
+declare interface DataSource {
+    connectionId: string;
+    semanticDomainId?: string;
+    connectionType: string;
+    mode: 'database' | 'upload' | 'url' | 'semanticDomain';
+    dbSelection?: {
+        database: string;
+        schema: string;
+        entityType: DatabaseEntityType;
+    };
+    selectedEntities: SelectedEntities;
+}
+
+declare const DATE_FORMAT_VALUES: readonly ["MM-DD-YYYY", "YYYY-MM-DD", "MM/DD/YYYY", "DD/MM/YYYY", "MMMM DD, YYYY", "MMM DD, YYYY", "DD MMM YYYY", "Week of MMM DD, YYYY", "Week of MMMM DD, YYYY", "YYYY-WW", "MMM YYYY", "MMMM YYYY", "YYYY-MM", "MM/YYYY", "YYYY MMM", "Q1 YYYY", "YYYY Q1", "1st Quarter YYYY", "YYYY-Q1", "Quarter 1, YYYY", "YYYY", "YY", "custom"];
+
+declare type DateFormatValue = (typeof DATE_FORMAT_VALUES)[number];
+
 export declare type DateOptions = {
     locale: string;
     format: string;
     options: Intl.DateTimeFormatOptions;
 };
 
+declare type Dialect = 'mysql' | 'postgres' | 'bigquery' | 'redshift' | 'snowflake' | 'clickhouse' | 'duckdb';
+
 export declare type DisplayDataType = 'string' | 'date' | 'number' | 'html' | 'none';
 
+declare interface DrillHierarchy {
+    id: string;
+    label?: string;
+    type: 'static';
+    steps: DrillHierarchyStep[];
+    default?: boolean;
+}
+
+declare interface DrillHierarchyStep {
+    field: Field;
+    mode: 'drillDown';
+    preferredChartType?: TChartType;
+    breadcrumbLabelTemplate?: string;
+    retainFilters?: boolean;
+    label?: string;
+    linkedInsightId?: string;
+}
+
+declare type DrillInteraction = DrillThroughInteraction | DrillToDetailInteraction | DrillToURLInteraction | InlineDrillInteraction;
+
+declare interface DrillThroughInteraction {
+    mode: 'drillThrough';
+    filterFields: Field[];
+    targetSheetId: string;
+    label?: string;
+}
+
+declare interface DrillToDetailInteraction {
+    mode: 'drillToDetail';
+    filterFields: Field[];
+    detailFields?: Field[];
+    sortBy?: SortByField[];
+    limit?: number;
+    detailTitle?: string;
+    label?: string;
+}
+
+declare interface DrillToURLInteraction {
+    mode: 'drillToURL';
+    filterFields: Field[];
+    urlTemplate: string;
+    label?: string;
+}
+
+export declare type DroppableId = 'droppable-group-by' | 'droppable-metric';
+
+export declare type EmailSettings = {
+    companyName: string;
+    dashboardUrl: string;
+    supportEmail: string;
+    senderTitle: string;
+};
+
+export declare const EMPTY_SELECTION: SelectionState;
+
+declare type EntityType = 'table' | 'view' | 'model' | 'file' | 'dataset' | 'url' | 'upload';
+
 export declare type ErrorProps = {
     message?: string;
 };
 
+export declare type ExportDataPayload = {
+    cardId: string;
+    title: string;
+    data: Record<string, any>[];
+    sql: string;
+};
+
+declare interface Field {
+    /**
+     * Unique identifier for this field instance (for joins, UI state, etc.).
+     * Should be unique within the context of the query or data model.
+     * Example: 'orders.customer_id', 'expr_12345', etc.
+     */
+    id: string;
+    /**
+     * The physical/source column name in the database or data source.
+     * Used for mapping to the underlying data model and SQL generation (unless overridden by expression).
+     */
+    name: string;
+    /**
+     * Human-friendly, localizable display name for the UI (table headers, chart axes, etc.).
+     */
+    label: string;
+    /**
+     * Unique, stable, machine-friendly reference name for SQL (AS alias), exports, and scripting.
+     * If not provided, should be auto-generated from label or name.
+     */
+    alias?: string;
+    qualifiedFieldName: string;
+    dataType: string;
+    description?: string;
+    qualifiedEntityName?: string;
+    dateFormat?: DateFormatValue;
+    customFormat?: string;
+    granularity?: TimeGranularity;
+    entityId: string;
+    entityName: string;
+    entityType: EntityType;
+    role?: 'groupby' | 'metric' | 'sortby' | 'pivotby';
+}
+
+declare type FileAttachment = {
+    id: string;
+    name: string;
+    size: number;
+    type: string;
+    data?: string;
+    url?: string;
+    preview?: string;
+    uploadProgress?: number;
+};
+
+declare interface FileEntityReference extends DatabaseEntityReference {
+    id: string;
+    type: 'file' | 'url' | 'upload';
+    label: string;
+    description: string;
+    originalName: string;
+    file?: File;
+    url?: string;
+}
+
+declare interface FilterByColumn extends BaseColumn {
+    role: 'filter';
+    operators?: string[];
+    mode?: 'include' | 'exclude';
+    sql?: string;
+    fetchValues?: boolean;
+    fetchLimit?: number;
+    valueSource?: 'distinct' | 'static' | 'range';
+    staticValues?: string[];
+}
+
+declare interface FilterCondition {
+    id: string;
+    field: Field;
+    operator: Operator;
+    value: FilterValue;
+}
+
 declare type FilterForBetween = BaseFilter & {
     operation: 'between' | 'not between';
     values: [number, number];
@@ -150,6 +525,14 @@ declare type FilterForString = BaseFilter & {
     values: [string];
 };
 
+declare interface FilterGroup {
+    id: string;
+    logicalOperator: LogicalOperator;
+    negate: boolean;
+    conditions: FilterCondition[];
+    groups: FilterGroup[];
+}
+
 declare type FilterLocation = 'dashboard' | 'frame' | undefined;
 
 declare type FilterOnClick = {
@@ -157,6 +540,8 @@ declare type FilterOnClick = {
     columnIndex: number;
 };
 
+declare type FilterValue = string | number | boolean | Date | null | [number, number] | [string, string] | string[] | number[];
+
 export declare type GetDashboardResponse = {
     dashboard: TDashboard;
     lenses: TLens[];
@@ -168,23 +553,122 @@ export declare type GetPluginsResponse = {
     plugins: {
         label: string;
         value: string;
+        type: PluginType;
     }[];
 };
 
+declare type Granularity = 'day' | 'week' | 'month' | 'year';
+
+declare interface GroupByColumn extends BaseColumn {
+    role: 'groupby';
+    granularity?: Granularity;
+    format?: string;
+}
+
+declare interface GroupByField extends Field {
+    role: 'groupby';
+    granularity?: 'day' | 'week' | 'month' | 'quarter' | 'year';
+    /**
+     * Optional SQL expression for grouping (e.g., DATE_TRUNC('month', order_date)).
+     * If present, used in SELECT and GROUP BY instead of just the column name.
+     */
+    expression?: string;
+    timeDrillPath?: TimeDrillStep[];
+}
+
 export declare type HtmlOptions = {
     html: string;
 };
 
+declare interface InlineDrillInteraction {
+    mode: 'inlineDrill';
+    filterFields: Field[];
+    fetchMode?: 'lazy' | 'preloaded';
+    inlineLimit?: number;
+    label?: string;
+}
+
+declare interface Join {
+    id: string;
+    source: DatabaseEntityReference;
+    target: DatabaseEntityReference;
+    joinType: 'INNER' | 'LEFT' | 'RIGHT' | 'FULL';
+    joinKeyGroups: JoinKeyGroup[];
+    sequence: number;
+}
+
+declare interface JoinKey {
+    id?: string;
+    source: Field;
+    target: Field;
+    operator: string;
+}
+
+declare interface JoinKeyGroup {
+    id: string;
+    operator: string;
+    keys: JoinKey[];
+}
+
+declare interface JoinPlan {
+    baseEntity: DatabaseEntityReference;
+    joins: Join[];
+}
+
 export declare type KPICardProps = {
     card: TCard;
     isLoading?: boolean;
     renderFilterInfo?: () => JSX.Element | null;
 };
 
+export declare type Level = 'database' | 'schema' | 'table';
+
 export declare type LoadingProps = {
     message?: string;
 };
 
+declare type LogicalOperator = 'AND' | 'OR';
+
+declare interface MetricColumn extends BaseColumn {
+    role: 'metric';
+    aggregate: AggregateFunction;
+    aliasTemplate?: string;
+}
+
+declare interface MetricField extends Field {
+    role: 'metric';
+    aggregate: AggregateFunction;
+    /**
+     * Optional SQL expression for the metric (e.g., ship_date - order_date).
+     * If present, used as aggregate(expression) instead of aggregate(name).
+     */
+    expression?: string;
+    /**
+     * Optional parameters for future extensibility (e.g., window functions).
+     * * Example:
+     * {
+     aggregate: "SUM",
+     name: "sales",
+     parameters: {
+     window: "PARTITION BY region ORDER BY date ROWS BETWEEN 1 PRECEDING AND CURRENT ROW"
+     }
+     }
+
+     {
+     aggregate: "COUNT",
+     name: "order_id",
+     parameters: {
+     filter: "status = 'Active'"
+     }
+     }
+     */
+    parameters?: {
+        filters?: FilterGroup;
+    };
+    aliasTemplate?: string;
+    valueAliases?: Record<string, string>;
+}
+
 declare type NoneOptions = {};
 
 export declare type NumberAxisFormat = {
@@ -201,8 +685,12 @@ export declare type NumberOptions = {
     colorRanges?: ColorRange[];
 };
 
+declare type OldFilterValue = string | number | null | (string | number)[] | RangeValue;
+
 declare type Operation = '=' | '>' | '<' | '>=' | '<=' | '!=' | 'in' | 'not in' | 'like' | 'not like' | 'between' | 'not between' | 'is null' | 'is not null';
 
+declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between' | 'isNull' | 'isNotNull';
+
 declare type OptionsMap = {
     number: NumberOptions;
     string: StringOptions;
@@ -211,10 +699,27 @@ declare type OptionsMap = {
     none: NoneOptions;
 };
 
+declare interface OrderBy {
+    columnId: string;
+    direction: 'asc' | 'desc';
+}
+
+/**
+ * Pagination configuration for table queries
+ */
+declare interface PaginationConfig {
+    page: number;
+    pageSize: number;
+}
+
 declare type Params = {
     [key: string]: string | number | string[] | number[];
 };
 
+declare interface PivotByField extends Field {
+    role: 'pivotby';
+}
+
 export declare type Placeholders = {
     /**
      * Placeholder for the card when there are no records to display.
@@ -226,6 +731,39 @@ export declare type Placeholders = {
     SessionExpired?: React.ReactNode;
 };
 
+export declare type PluginType = 'custom' | 'standard';
+
+declare interface QueryConfig {
+    groupByColumns?: GroupByColumn[];
+    pivotColumns?: GroupByColumn[];
+    metricColumns?: MetricColumn[];
+    filterColumns?: FilterByColumn[];
+    filters?: QueryFilter[];
+    limit?: number;
+    orderBy?: OrderBy[];
+}
+
+declare type QueryFilter = {
+    filterColumnName: string;
+    filterValue: OldFilterValue;
+};
+
+declare type RangeValue = {
+    gte?: string | number;
+    lte?: string | number;
+    lt?: string | number;
+    gt?: string | number;
+};
+
+declare type SelectedEntities = DatabaseEntityReference[] | DataModelEntityReference[] | FileEntityReference[];
+
+export declare type SelectionState = Record<Level, string | null>;
+
+declare interface SortByField extends Field {
+    role: 'sortby';
+    direction: 'asc' | 'desc';
+}
+
 export declare type SqlGen = {
     measures?: {
         name: string;
@@ -253,6 +791,14 @@ export declare type StyleProps = {
     dashboardCardContainer?: string;
     dashboardCard?: string;
     /** grid-layout config */
+    /**
+     * Border radius for the control inputs such as filter input, tabs, date picker, etc.
+     */
+    controlInputRadius?: number;
+    /**
+     * Border radius for the cards
+     */
+    cardBorderRadius?: number;
     gridLayout?: {
         /** css class for `react-grid-layout` */
         className?: string;
@@ -273,6 +819,15 @@ export declare type StyleProps = {
 
 export declare function Surfboard({ showControls, showFooter, ...rest }: DashboardPlusProps): JSX_2.Element;
 
+declare type TablePreferences = {
+    columnSettingsMap?: ColumnSettingsMap;
+    selectColumnVisible?: boolean;
+    columnVisibility?: Record<string, boolean>;
+    columnSizing?: ColumnSizingState;
+    pageSize?: number;
+    enableDevModePagination?: boolean;
+};
+
 export declare type TBaseQuery = {
     id: string;
     name: string;
@@ -294,7 +849,11 @@ export declare type TCard = {
     type: TChartType;
     sql?: string;
     python?: string;
-    cfg?: any;
+    dataSource?: DataSource;
+    config?: CardConfig;
+    interactionConfig?: CardInteractionConfig;
+    paginationConfig?: PaginationConfig;
+    queryConfig?: QueryConfig;
     customCfg?: any;
     preferences?: TCardPreferences;
     customCardPreferences?: TCustomCardPreferences;
@@ -303,6 +862,11 @@ export declare type TCard = {
     lastSelectedSchema?: string;
     lastSelectedTable?: string;
     refreshInterval?: string;
+    /**
+     * Card-specific display preferences that override dashboard-level preferences.
+     * If not specified, the card will use the dashboard's display preferences.
+     */
+    displayPreferences?: VisualDisplayPreferences;
 };
 
 export declare type TCardContext = {
@@ -330,6 +894,11 @@ export declare type TCardPreferences = {
     datasetOptions?: TDatasetOptions[];
     chartOptions?: TChartOptions;
     columnSettings?: TColumnSetting<DisplayDataType>[];
+    colorConfig?: ColorConfig;
+    xAxisConfig?: AxisConfig;
+    yAxisConfig?: AxisConfig;
+    dataLabelsConfig?: TDataLabelsConfig;
+    tablePrefs?: TablePreferences;
     allowDownload?: boolean;
     customVisualCode?: string;
     textVisualOptions?: {
@@ -345,32 +914,83 @@ export declare type TCardPreferences = {
         projectionOffset?: [number, number];
         colorScale?: string;
     };
+    kpiVisualOptions?: {
+        lowerIsBetter?: boolean;
+        countryLogoId?: string;
+        valueAlignment?: 'left' | 'center';
+        formatOptions?: TFormatOptions;
+        metricComparison?: {
+            enabled?: boolean;
+            calculationType?: 'difference' | 'change' | 'change_difference' | 'ratio';
+            formatOptions?: TFormatOptions;
+            showArrow?: boolean;
+            showColor?: boolean;
+            conditionalLabel?: boolean;
+            labelName?: string;
+            position?: 'left' | 'right' | 'top';
+            conditionalLabels?: {
+                increase?: string;
+                decrease?: string;
+                noChange?: string;
+            };
+            colorConfig?: {
+                increase?: 'green' | 'red' | 'neutral' | string;
+                decrease?: 'green' | 'red' | 'neutral' | string;
+                noChange?: 'green' | 'red' | 'neutral' | string;
+            };
+        };
+    };
+    pivotTableOptions?: {
+        showRowTotals?: boolean;
+        showColumnTotals?: boolean;
+        showGrandTotal?: boolean;
+        sortRowsBy?: 'label' | 'total' | 'metric';
+        sortColumnsBy?: 'label' | 'total' | 'metric';
+    };
+    displayOptions?: {
+        showFilterInfo?: boolean;
+        showCardToolbar?: boolean;
+        showChrome?: boolean;
+        allowScroll?: boolean;
+    };
 };
 
 export declare type TChartOptions = {
     type?: TChartType;
     scales?: {
         y?: {
-            type: 'linear' | 'logarithmic';
-            min: number;
-            max: number;
-            ticks: {
-                stepSize: number;
+            type?: 'linear' | 'logarithmic';
+            min?: number;
+            max?: number;
+            ticks?: {
+                stepSize?: number;
+            };
+            grid?: {
+                display?: boolean;
             };
         };
         x?: {
-            type: 'linear' | 'logarithmic';
-            min: number;
-            max: number;
-            ticks: {
-                stepSize: number;
+            type?: 'linear' | 'logarithmic';
+            min?: number;
+            max?: number;
+            ticks?: {
+                stepSize?: number;
+            };
+            grid?: {
+                display?: boolean;
             };
         };
     };
     indexAxis?: 'x' | 'y' | undefined;
+    plugins?: {
+        legend?: TLegendOptions;
+        datalabels?: {
+            anchor?: string;
+        };
+    };
 };
 
-declare type TChartType = 'bar' | 'horizontalBar' | 'line' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'kpi' | 'pyramid' | 'range' | 'text' | 'map' | 'custom';
+declare type TChartType = 'bar' | 'horizontalBar' | 'line' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'pivotTable' | 'aggregateTable' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'custom';
 
 export declare type TColumnSetting<T extends DisplayDataType> = {
     columnIdx: number;
@@ -385,6 +1005,7 @@ export declare type TCustomCardPreferences = {
     url: string;
     componentName: string;
     icon?: string;
+    pluginChartType?: string;
     type?: 'iframe' | 'component';
     visualType?: 'single' | 'multiple';
     settings?: any;
@@ -402,6 +1023,7 @@ export declare type TCustomCardPreferences = {
 export declare type TDashboard = {
     id: string;
     title?: string;
+    aiContext?: AIContext;
     description?: string;
     sheets?: TSheet[];
     style?: TStyle;
@@ -411,12 +1033,36 @@ export declare type TDashboard = {
     aiScopeTables?: AIScopeTable[];
     globalStyle?: TStyle;
     globalCacheConfig?: CacheConfig;
+    emailSettings?: EmailSettings;
+    defaultFilterValues?: TFilterValue[];
 };
 
 export declare type TDataColumn = {
     column_name: string;
     data_type: string;
     is_nullable?: string;
+    label?: string;
+    description?: string;
+    qualifiedFieldName?: string;
+};
+
+export declare type TDataLabelsConfig = {
+    enabled?: boolean;
+    position?: 'center' | 'top' | 'bottom' | 'left' | 'right' | 'auto' | 'custom';
+    anchor?: 'center' | 'start' | 'end';
+    align?: 'center' | 'start' | 'end' | 'top' | 'bottom' | number;
+    display?: 'auto' | boolean;
+    format?: 'auto' | 'number' | 'currency' | 'percent' | 'none';
+    formatOptions?: TFormatOptions;
+    font?: {
+        size?: number;
+        weight?: 'normal' | 'bold';
+    };
+    color?: 'auto' | string;
+    clamp?: boolean;
+    clip?: boolean;
+    rotation?: number;
+    showTotal?: boolean;
 };
 
 export declare type TDatasetOptions = {
@@ -432,6 +1078,11 @@ export declare type TDatasetOptions = {
     };
 };
 
+export declare type TDbCapabilities = {
+    path: Level[];
+    labels?: Partial<Record<Level, string>>;
+};
+
 export declare type TEvent = {
     type: 'success' | 'error' | 'info' | 'warning';
     message: any;
@@ -452,12 +1103,30 @@ declare type TFilter = {
     database: string;
     sql: string;
     operation: Operation;
+    applyToSheetIds?: string[];
+    excludeSheetIds?: string[];
+    applyToCardIds?: string[];
+    excludeCardIds?: string[];
 };
 
 declare type TFilterValue = FilterForString | FilterForEqual | FilterForCompare | FilterForBetween | FilterForIn | FilterForDate;
 
+export declare type TFormatOptions = {
+    type?: 'auto' | 'number' | 'currency' | 'percent' | 'scientific' | 'date';
+    decimalPlaces?: number;
+    currency?: string;
+    locale?: string;
+    prefix?: string;
+    suffix?: string;
+    useSuffix?: boolean;
+    negativeInParentheses?: boolean;
+    multiplyBy?: number;
+    dateFormat?: string;
+};
+
 export declare type TFrame = {
     id: string;
+    visualId?: string;
     filterId?: string;
     cards: TCard[];
     activeCardId: string;
@@ -465,6 +1134,21 @@ export declare type TFrame = {
 
 export declare type Theme = 'dark' | 'light' | 'system';
 
+declare interface TimeDrillStep {
+    granularity: TimeGranularity;
+    next?: TimeGranularity;
+    comparison?: 'previous_year' | 'previous_period';
+    rollingWindow?: number;
+}
+
+declare type TimeGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year';
+
+export declare type TLegendOptions = {
+    display?: boolean;
+    position?: 'top' | 'left' | 'bottom' | 'right';
+    align?: 'start' | 'center' | 'end';
+};
+
 export declare type TLens = {
     id: string;
     name: string;
@@ -492,4 +1176,41 @@ export declare type TStyle = {
     dark?: StyleProps;
 };
 
+/**
+ * Display mode for visual components - controls which UI elements are shown
+ */
+export declare type VisualDisplayMode = 'full' | 'content-only' | 'print' | 'embed' | 'table-print';
+
+/**
+ * Display preferences for controlling visual component rendering
+ */
+export declare type VisualDisplayPreferences = {
+    /**
+     * Predefined display mode
+     * - 'full': All UI elements (default)
+     * - 'content-only': Just the visualization/table content
+     * - 'print': Optimized for printing (shows title and description, hides interactive elements)
+     * - 'embed': Minimal chrome for embedding in other contexts
+     */
+    mode?: VisualDisplayMode;
+    /**
+     * Override specific UI elements visibility
+     * These overrides take precedence over the mode presets
+     */
+    overrides?: {
+        showHeader?: boolean;
+        showTitle?: boolean;
+        showDescription?: boolean;
+        showTabs?: boolean;
+        showFooter?: boolean;
+        showFilters?: boolean;
+        showBreadcrumbs?: boolean;
+        showRefreshIndicator?: boolean;
+        showFilterInfo?: boolean;
+        showPagination?: boolean;
+        showTableToolbar?: boolean;
+        showColumnSettings?: boolean;
+    };
+};
+
 export { }