semaphor 0.0.128 → 0.0.130

package/dist/types/surfboard.d.ts

@@ -75,6 +75,48 @@ export declare type CacheConfig = {
     status: 'on' | 'on-refresh' | 'off';
 };
 
+/**
+ * Formula metadata for calculated fields (UI-only metadata)
+ * This is supplementary data to help the UI display and edit calculated fields.
+ * The `expression` field remains the source of truth for the backend.
+ *
+ * IMPORTANT: This metadata is ALWAYS updated atomically with the expression field.
+ * Both are generated together from the same dialog inputs, preventing drift.
+ */
+declare interface CalculatedFieldFormula {
+    operation: CalculatedFieldOperation;
+    /**
+     * Array of full MetricField objects used as inputs to the calculated field.
+     *
+     * Storing complete Field objects eliminates the need for runtime lookups and ensures:
+     * - Table alias resolution works with schema-qualified tables (Issue 1)
+     * - All field metadata is available even if the input field isn't selected on the card (Issue 2)
+     * - Aggregate functions, filters, and entity info are preserved
+     *
+     * Each input field contains complete metadata:
+     * - name, entityId, entityName, qualifiedEntityName (for table qualification)
+     * - aggregate (for proper post-aggregation: SUM(sales) / COUNT(orders))
+     * - parameters.filters (for filtered metrics)
+     * - dataType and other properties
+     *
+     * Example: [
+     *   {name: 'sales', aggregate: 'SUM', entityName: 'sales_data', ...},
+     *   {name: 'order_id', aggregate: 'COUNT', entityName: 'sales_data', ...}
+     * ]
+     */
+    inputFields: MetricField[];
+    /**
+     * Constant value used in scale operations (e.g., multiply by 0.15)
+     * Only applicable for 'scale' operation type
+     */
+    constant?: number;
+}
+
+/**
+ * Operations supported for calculated fields
+ */
+declare type CalculatedFieldOperation = 'sum' | 'difference' | 'product' | 'ratio' | 'change' | 'percentage' | 'scale' | 'custom';
+
 declare interface CardConfig {
     groupByColumns?: GroupByField[];
     metricColumns?: MetricField[];
@@ -104,8 +146,9 @@ declare interface CardConfig {
      * Configuration for on-click dashboard filters triggered by this card.
      */
     clickFilterInteractions?: ClickFilterInteraction[];
-    comparisonType?: 'none' | 'previous_period' | 'same_period_last_year' | 'target';
+    comparisonType?: 'none' | 'previous_period' | 'same_period_last_year' | 'target' | 'start_vs_end';
     targetValue?: number;
+    showComparisonInLegend?: boolean;
     showTrendline?: boolean;
     trendlineWindow?: number;
     trendlineGranularity?: 'day' | 'week' | 'month';
@@ -122,10 +165,13 @@ declare interface CardConfig {
 }
 
 declare interface CardInteractionConfig {
+    /**
+     * V2: Unified interactions array.
+     * Each interaction includes a trigger that specifies what element must be clicked.
+     */
+    interactions?: Interaction[];
     allowedDrillTargets?: Field[];
     drillHierarchies?: DrillHierarchy[];
-    drillInteractions?: DrillInteraction[];
-    clickFilterInteractions?: ClickFilterInteraction[];
 }
 
 declare type CardWithContent = BaseCustomCard & {
@@ -148,6 +194,14 @@ declare type CardWithFooter = BaseCustomCard & {
 
 declare interface ClickFilterInteraction {
     mode: 'clickFilter';
+    /**
+     * What element must be clicked to trigger this interaction.
+     * Determines both the matching logic and the filtering behavior.
+     *
+     * @migration Optional during migration. Will be required in V2.
+     * Old configs without trigger will apply to any click (legacy behavior).
+     */
+    trigger?: InteractionTrigger;
     /**
      * Fields from the chart element that should be used as filters.
      * e.g., [region, ship_mode] from a stacked bar chart
@@ -217,6 +271,7 @@ declare interface ColumnSettings {
         timezone?: string;
         sourceTimezone?: string;
     };
+    linkFormat: LinkFormat;
     colorRanges: ColorRange_2[];
 }
 
@@ -318,7 +373,7 @@ declare interface DatabaseEntityReference {
     name: string;
 }
 
-declare type DatabaseEntityType = 'table' | 'view';
+declare type DatabaseEntityType = 'table' | 'view' | 'materialized view';
 
 declare interface DataModelEntityReference extends DatabaseEntityReference {
     type: 'model';
@@ -350,16 +405,33 @@ export declare type DateOptions = {
     options: Intl.DateTimeFormatOptions;
 };
 
-declare type Dialect = 'mysql' | 'postgres' | 'bigquery' | 'redshift' | 'snowflake' | 'clickhouse' | 'duckdb';
+declare type DateSelectionMode = 'range' | 'months';
+
+declare type DateUnit = 'day' | 'week' | 'month' | 'quarter' | 'year';
+
+declare type Dialect = 'mysql' | 'postgres' | 'bigquery' | 'redshift' | 'snowflake' | 'clickhouse' | 'duckdb' | 'mssql';
 
 export declare type DisplayDataType = 'string' | 'date' | 'number' | 'html' | 'none';
 
+declare interface DrillDownInteraction {
+    mode: 'drillDown';
+    /**
+     * What element must be clicked to trigger this drill-down.
+     * Optional during configuration, but must be defined before execution.
+     */
+    trigger?: InteractionTrigger;
+    filterFields: Field[];
+    hierarchyId?: string;
+    label?: string;
+}
+
 declare interface DrillHierarchy {
     id: string;
     label?: string;
-    type: 'static';
+    type: 'static' | 'date';
     steps: DrillHierarchyStep[];
     default?: boolean;
+    baseField?: Field;
 }
 
 declare interface DrillHierarchyStep {
@@ -372,34 +444,116 @@ declare interface DrillHierarchyStep {
     linkedInsightId?: string;
 }
 
-declare type DrillInteraction = DrillThroughInteraction | DrillToDetailInteraction | DrillToURLInteraction | InlineDrillInteraction;
-
 declare interface DrillThroughInteraction {
     mode: 'drillThrough';
+    /**
+     * What element must be clicked to trigger this drill-through.
+     * @migration Optional during migration. Will be required in V2.
+     */
+    trigger?: InteractionTrigger;
     filterFields: Field[];
-    targetSheetId: string;
+    targetDashboardId: string;
+    /**
+     * How to pass context to the target dashboard
+     * @default 'interactionFilters'
+     */
+    contextMode?: 'interactionFilters' | 'full' | 'none';
     label?: string;
 }
 
 declare interface DrillToDetailInteraction {
     mode: 'drillToDetail';
+    /**
+     * What element must be clicked to trigger this drill to detail.
+     * @migration Optional during migration. Will be required in V2.
+     */
+    trigger?: InteractionTrigger;
     filterFields: Field[];
     detailFields?: Field[];
     sortBy?: SortByField[];
     limit?: number;
     detailTitle?: string;
+    /**
+     * Target insight ID to navigate to
+     */
+    targetInsightId?: string;
+    /**
+     * How to pass context to the target insight
+     * @default 'interactionFilters'
+     */
+    contextMode?: 'interactionFilters' | 'full' | 'none';
+    /**
+     * How to display the insight
+     * @default 'modal'
+     */
+    displayMode?: 'modal' | 'replace-card';
     label?: string;
 }
 
 declare interface DrillToURLInteraction {
     mode: 'drillToURL';
+    /**
+     * What element must be clicked to trigger this URL drill.
+     */
+    trigger?: InteractionTrigger;
     filterFields: Field[];
+    /**
+     * URL template with placeholders (e.g., 'https://example.com/product/{{product_id}}')
+     */
     urlTemplate: string;
+    /**
+     * List of parameters used in the URL template
+     */
+    parameters: URLParameter[];
+    /**
+     * Whether to URL-encode parameter values
+     * @default true
+     */
+    encodeParameters?: boolean;
+    /**
+     * Custom label for this interaction in the menu
+     */
+    label?: string;
+}
+
+declare interface DrillUpInteraction {
+    mode: 'drillUp';
+    /**
+     * What element must be clicked to trigger this drill-up.
+     * For synthetic drill-up interactions, this is inherited from the original drill-down.
+     */
+    trigger?: InteractionTrigger;
+    /**
+     * The hierarchy ID to reference for display purposes.
+     * Used to show the parent level name in the interaction menu.
+     */
+    hierarchyId?: string;
     label?: string;
 }
 
 export declare type DroppableId = 'droppable-group-by' | 'droppable-metric';
 
+declare interface DynamicDrillInteraction {
+    mode: 'dynamicDrill';
+    /**
+     * What element must be clicked to trigger this dynamic drill menu.
+     * When this trigger fires, user sees a menu of available fields to explore.
+     */
+    trigger?: InteractionTrigger;
+    /**
+     * List of fields available for dynamic exploration.
+     * User can choose which field to drill into at runtime.
+     * Only drillable fields (string, boolean types) should be included.
+     */
+    availableFields: Field[];
+    /**
+     * Optional label for the menu item.
+     * Defaults to "Explore Fields" if not specified.
+     */
+    label?: string;
+    /* Excluded from this release type: drillField */
+}
+
 export declare type EmailSettings = {
     companyName: string;
     dashboardUrl: string;
@@ -409,7 +563,7 @@ export declare type EmailSettings = {
 
 export declare const EMPTY_SELECTION: SelectionState;
 
-declare type EntityType = 'table' | 'view' | 'model' | 'file' | 'dataset' | 'url' | 'upload';
+declare type EntityType = 'table' | 'view' | 'materialized view' | 'model' | 'file' | 'dataset' | 'url' | 'upload';
 
 export declare type ErrorProps = {
     message?: string;
@@ -508,6 +662,7 @@ declare type FilterForCompare = BaseFilter & {
 declare type FilterForDate = BaseFilter & {
     operation: 'between' | 'not between';
     values: [Date, Date];
+    relativeMeta?: RelativeDateFilter;
 };
 
 declare type FilterForEqual = BaseFilter & {
@@ -533,7 +688,7 @@ declare interface FilterGroup {
     groups: FilterGroup[];
 }
 
-declare type FilterLocation = 'dashboard' | 'frame' | undefined;
+declare type FilterLocation = 'dashboard' | 'frame' | 'sheet' | undefined;
 
 declare type FilterOnClick = {
     expression?: string;
@@ -547,6 +702,7 @@ export declare type GetDashboardResponse = {
     lenses: TLens[];
     filterValues?: TFilterValue[];
     defaultLensId?: string;
+    assistantProfileId?: string;
 };
 
 export declare type GetPluginsResponse = {
@@ -582,12 +738,72 @@ export declare type HtmlOptions = {
 
 declare interface InlineDrillInteraction {
     mode: 'inlineDrill';
+    /**
+     * What element must be clicked to trigger this inline drill.
+     * @migration Optional during migration. Will be required in V2.
+     */
+    trigger?: InteractionTrigger;
     filterFields: Field[];
+    /**
+     * When to fetch the detailed data
+     * @default 'lazy'
+     */
     fetchMode?: 'lazy' | 'preloaded';
+    /**
+     * Maximum number of records to show (0 for unlimited)
+     * @default 100
+     */
     inlineLimit?: number;
+    /**
+     * How to display the detailed records
+     * @default 'table'
+     */
+    displayMode?: 'table' | 'list' | 'cards';
+    /**
+     * Whether to show records in a modal overlay
+     * @default false
+     */
+    showInModal?: boolean;
+    /**
+     * Whether to allow exporting the detailed records
+     * @default true
+     */
+    allowExport?: boolean;
     label?: string;
 }
 
+/**
+ * Unified Interaction type (V2)
+ * Combines all interaction types into a single union for the new interactions array.
+ */
+declare type Interaction = ClickFilterInteraction | DrillDownInteraction | DrillThroughInteraction | DrillToDetailInteraction | DrillToURLInteraction | InlineDrillInteraction | DrillUpInteraction | DynamicDrillInteraction;
+
+/**
+ * Defines what element must be clicked to trigger an interaction.
+ *
+ * The `type` determines filtering behavior:
+ * - 'metric': Captures intersection of ALL dimensions (e.g., country='USA' AND state='CA')
+ * - 'attribute': Captures ONLY the clicked dimension (e.g., country='USA')
+ *
+ * Note: `trigger.type` is different from `field.type`:
+ * - trigger.type = filtering behavior ('metric' | 'attribute')
+ * - field.type = data type ('dimension' | 'metric' | 'measure')
+ */
+declare interface InteractionTrigger {
+    /**
+     * Determines filtering behavior when this trigger fires:
+     * - 'metric': Capture intersection of all dimensions
+     * - 'attribute': Capture only this specific dimension
+     */
+    type: 'metric' | 'attribute';
+    /**
+     * The field (metric or attribute) that must be clicked.
+     * For multi-series charts: Use the specific metric Field with unique ID
+     * (e.g., Field with id='count_of_orders')
+     */
+    field: Field;
+}
+
 declare interface Join {
     id: string;
     source: DatabaseEntityReference;
@@ -623,6 +839,14 @@ export declare type KPICardProps = {
 
 export declare type Level = 'database' | 'schema' | 'table';
 
+declare interface LinkFormat {
+    urlTemplate: string;
+    labelType: 'value' | 'static' | 'column';
+    staticLabel?: string;
+    labelColumn?: string;
+    openInNewTab: boolean;
+}
+
 export declare type LoadingProps = {
     message?: string;
 };
@@ -667,6 +891,15 @@ declare interface MetricField extends Field {
     };
     aliasTemplate?: string;
     valueAliases?: Record<string, string>;
+    /**
+     * Formula metadata for calculated fields (UI-only metadata)
+     * This is supplementary data to help the UI display and edit calculated fields.
+     * The `expression` field remains the source of truth for the backend.
+     *
+     * IMPORTANT: This metadata is ALWAYS updated atomically with the expression field.
+     * Both are generated together from the same dialog inputs, preventing drift.
+     */
+    calculatedFormula?: CalculatedFieldFormula;
 }
 
 declare type NoneOptions = {};
@@ -689,7 +922,7 @@ declare type OldFilterValue = string | number | null | (string | number)[] | Ran
 
 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 Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between' | 'not between' | 'isNull' | 'isNotNull';
 
 declare type OptionsMap = {
     number: NumberOptions;
@@ -755,6 +988,25 @@ declare type RangeValue = {
     gt?: string | number;
 };
 
+declare type RelativeDateFilter = {
+    mode: 'last';
+    n: number;
+    unit: DateUnit;
+    complete?: boolean;
+} | {
+    mode: 'this';
+    unit: DateUnit;
+    toDate?: boolean;
+} | {
+    mode: 'previous';
+    unit: DateUnit;
+} | {
+    mode: 'between';
+    unit: DateUnit;
+    from: number;
+    to: number;
+};
+
 declare type SelectedEntities = DatabaseEntityReference[] | DataModelEntityReference[] | FileEntityReference[];
 
 export declare type SelectionState = Record<Level, string | null>;
@@ -826,6 +1078,7 @@ declare type TablePreferences = {
     columnSizing?: ColumnSizingState;
     pageSize?: number;
     enableDevModePagination?: boolean;
+    forceClientPagination?: boolean;
 };
 
 export declare type TBaseQuery = {
@@ -837,6 +1090,104 @@ export declare type TBaseQuery = {
     description?: string;
 };
 
+export declare type TBubbleScatterConfig = {
+    /**
+     * Explicit key for X-axis metric. Falls back to auto-detection.
+     */
+    xMetricKey?: string;
+    /**
+     * Explicit key for Y-axis metric. Falls back to auto-detection.
+     */
+    yMetricKey?: string;
+    /**
+     * Explicit key for radius metric (bubble only). Falls back to auto-detection.
+     */
+    radiusMetricKey?: string;
+    /**
+     * Key for point labels (first dimension).
+     */
+    labelKey?: string;
+    /**
+     * Whether to group points into series. Defaults to auto-detect in card config mode.
+     */
+    enableGrouping?: boolean;
+    /**
+     * Key for series grouping. Can be any data type (string, number, date).
+     */
+    groupKey?: string;
+    /**
+     * Scaling mode for bubble radius.
+     */
+    radiusScale?: 'linear' | 'sqrt' | 'fixed';
+    /**
+     * Fixed radius value when radiusScale is 'fixed' or for scatter charts.
+     */
+    fixedRadius?: number;
+    /**
+     * Minimum radius for bubble scaling.
+     */
+    minRadius?: number;
+    /**
+     * Maximum radius for bubble scaling.
+     */
+    maxRadius?: number;
+};
+
+export declare type TBulletConfig = {
+    /**
+     * Orientation of the bullet chart. Defaults to horizontal.
+     */
+    orientation?: 'horizontal' | 'vertical';
+    /**
+     * Explicit metric key to use for target markers. Falls back to the next metric column.
+     */
+    targetMetricKey?: string;
+    /**
+     * Optional comparative metric (e.g., previous period).
+     */
+    comparativeMetricKey?: string;
+    /**
+     * When true, disables automatic comparative assignment even if a metric exists.
+     */
+    disableAutoComparative?: boolean;
+    /**
+     * Mapping of qualitative range names to column keys.
+     */
+    rangeKeys?: TBulletRangeKeys;
+    /**
+     * Static range values if columns are not provided.
+     */
+    ranges?: TBulletRangeValues;
+    /**
+     * Global target value if a column is not provided.
+     */
+    targetValue?: number;
+    /**
+     * Show numeric labels on the actual bar. Default true.
+     */
+    showValueLabels?: boolean;
+    /**
+     * Treat provided range values as percentages (0-1) when true.
+     */
+    rangesArePercentages?: boolean;
+    /**
+     * Whether qualitative ranges should be rendered.
+     */
+    showRanges?: boolean;
+    /**
+     * Display labels for qualitative ranges.
+     */
+    rangeLabels?: TBulletRangeLabelOverrides;
+};
+
+export declare type TBulletRangeKeys = Partial<Record<TBulletRangeLabels, string>>;
+
+export declare type TBulletRangeLabelOverrides = Partial<Record<TBulletRangeLabels, string>>;
+
+export declare type TBulletRangeLabels = 'poor' | 'satisfactory' | 'good';
+
+export declare type TBulletRangeValues = Partial<Record<TBulletRangeLabels, number>>;
+
 export declare type TCard = {
     id: string;
     title: string;
@@ -867,6 +1218,11 @@ export declare type TCard = {
      * If not specified, the card will use the dashboard's display preferences.
      */
     displayPreferences?: VisualDisplayPreferences;
+    /**
+     * Inline filter definitions for this card.
+     * Configured by editors via the visual editor settings.
+     */
+    inlineFilters?: TInlineFilter[];
 };
 
 export declare type TCardContext = {
@@ -898,6 +1254,10 @@ export declare type TCardPreferences = {
     xAxisConfig?: AxisConfig;
     yAxisConfig?: AxisConfig;
     dataLabelsConfig?: TDataLabelsConfig;
+    bulletConfig?: TBulletConfig;
+    heatmapConfig?: THeatmapConfig;
+    bubbleScatterConfig?: TBubbleScatterConfig;
+    funnelConfig?: TFunnelConfig;
     tablePrefs?: TablePreferences;
     allowDownload?: boolean;
     customVisualCode?: string;
@@ -952,6 +1312,7 @@ export declare type TCardPreferences = {
         showCardToolbar?: boolean;
         showChrome?: boolean;
         allowScroll?: boolean;
+        showInlineFilterBar?: boolean;
     };
 };
 
@@ -988,9 +1349,10 @@ export declare type TChartOptions = {
             anchor?: string;
         };
     };
+    treemapColorMode?: 'branch' | 'category';
 };
 
-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';
+declare type TChartType = 'bar' | 'horizontalBar' | 'line' | 'pie' | 'doughnut' | 'radar' | 'polarArea' | 'bubble' | 'scatter' | 'stackedBar' | 'stackedLine' | 'table' | 'pivotTable' | 'aggregateTable' | 'tableBuilder' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'bullet' | 'heatmap' | 'treemap' | 'custom';
 
 export declare type TColumnSetting<T extends DisplayDataType> = {
     columnIdx: number;
@@ -1020,6 +1382,14 @@ export declare type TCustomCardPreferences = {
     }[];
 };
 
+declare type TCustomFilterPreferences = {
+    url: string;
+    componentName: string;
+    pluginFilterType?: string;
+    icon?: string;
+    settings?: Record<string, string | number | boolean>;
+};
+
 export declare type TDashboard = {
     id: string;
     title?: string;
@@ -1052,7 +1422,7 @@ export declare type TDataLabelsConfig = {
     anchor?: 'center' | 'start' | 'end';
     align?: 'center' | 'start' | 'end' | 'top' | 'bottom' | number;
     display?: 'auto' | boolean;
-    format?: 'auto' | 'number' | 'currency' | 'percent' | 'none';
+    format?: 'auto' | 'number' | 'currency' | 'percent' | 'date' | 'scientific' | 'none';
     formatOptions?: TFormatOptions;
     font?: {
         size?: number;
@@ -1063,6 +1433,7 @@ export declare type TDataLabelsConfig = {
     clip?: boolean;
     rotation?: number;
     showTotal?: boolean;
+    offset?: number;
 };
 
 export declare type TDatasetOptions = {
@@ -1090,7 +1461,10 @@ export declare type TEvent = {
 
 declare type TFilter = {
     type?: 'single' | 'multiple';
-    uiType?: 'radio' | 'dropdown';
+    uiType?: 'radio' | 'dropdown' | 'tabs';
+    dateSelectionMode?: DateSelectionMode;
+    defaultValues?: (string | number)[];
+    defaultDateFilter?: RelativeDateFilter;
     sheetId?: string;
     location?: FilterLocation;
     hide?: boolean;
@@ -1103,10 +1477,14 @@ declare type TFilter = {
     database: string;
     sql: string;
     operation: Operation;
+    searchMode?: 'text' | 'numeric' | 'auto';
     applyToSheetIds?: string[];
     excludeSheetIds?: string[];
     applyToCardIds?: string[];
     excludeCardIds?: string[];
+    customFilterPreferences?: TCustomFilterPreferences;
+    /** Whether to show the label above the filter (default: true) */
+    showLabel?: boolean;
 };
 
 declare type TFilterValue = FilterForString | FilterForEqual | FilterForCompare | FilterForBetween | FilterForIn | FilterForDate;
@@ -1132,6 +1510,50 @@ export declare type TFrame = {
     activeCardId: string;
 };
 
+export declare type TFunnelConfig = {
+    /**
+     * How to calculate percentage in tooltips and data labels.
+     * - 'percentOfTotal': Each stage shows % of total sum (default/current behavior)
+     * - 'percentOfFirst': First stage = 100%, others relative to first
+     */
+    percentMode?: TFunnelPercentMode;
+    /**
+     * Controls how much funnel segments narrow based on their values.
+     * - 0: No shrink (all segments same width)
+     * - 1: Full shrink (segments narrow proportionally to values, default)
+     * Lower values prevent segments from becoming too narrow for labels.
+     */
+    shrinkFraction?: number;
+    /**
+     * Hide labels for segments smaller than this percentage of total.
+     * - 0: Show all labels (default)
+     * - 10: Hide labels for segments < 10% of total
+     * Range: 0-25
+     */
+    labelThreshold?: number;
+};
+
+/**
+ * Tooltip/data label percentage calculation mode for funnel charts.
+ * - 'percentOfTotal': Percentage relative to sum of all values (default)
+ * - 'percentOfFirst': Percentage relative to the first stage value (first stage = 100%)
+ */
+export declare type TFunnelPercentMode = 'percentOfTotal' | 'percentOfFirst';
+
+export declare type THeatmapConfig = {
+    colorMode?: 'continuous' | 'stepped';
+    steps?: number;
+    colorRange?: [string, string];
+    colorPalette?: 'blue' | 'green' | 'purple' | 'orange' | 'custom';
+    showLegend?: boolean;
+    legendPosition?: 'top' | 'bottom' | 'left' | 'right';
+    showDataLabels?: boolean;
+    nullFillColor?: string;
+    fillMissingCells?: boolean;
+    xAxisBuckets?: string[];
+    yAxisBuckets?: string[];
+};
+
 export declare type Theme = 'dark' | 'light' | 'system';
 
 declare interface TimeDrillStep {
@@ -1143,10 +1565,49 @@ declare interface TimeDrillStep {
 
 declare type TimeGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year';
 
+/**
+ * Inline filter definition stored on a card.
+ * Inline filters appear on the right-hand side of the card header,
+ * allowing ad-hoc data exploration without affecting other cards.
+ */
+export declare type TInlineFilter = {
+    id: string;
+    column: string;
+    title: string;
+    dataType: string;
+    table: string;
+    database: string;
+    connectionId: string;
+    operation: Operation;
+    sql: string;
+    /** Selection type: 'single' allows one value, 'multiple' allows many */
+    type?: 'single' | 'multiple';
+    /** UI component for single-select filters */
+    uiType?: 'radio' | 'dropdown' | 'tabs';
+    /** Date picker type: 'range' for full calendar, 'months' for month picker */
+    dateSelectionMode?: DateSelectionMode;
+    /** Default values applied when the dashboard first loads */
+    defaultValues?: (string | number)[];
+    /** Default relative date filter (e.g., "Last 7 days") applied on dashboard load */
+    defaultDateFilter?: RelativeDateFilter;
+    /** Search mode for numeric filters: 'text' treats as text, 'numeric' enables operators (>, <, =) */
+    searchMode?: 'text' | 'numeric' | 'auto';
+    /** Custom filter UI from a plugin */
+    customFilterPreferences?: TCustomFilterPreferences;
+    /** Width of the inline filter in pixels (default: 250) */
+    width?: number;
+    /** Whether to show the label above the filter (default: true) */
+    showLabel?: boolean;
+};
+
 export declare type TLegendOptions = {
     display?: boolean;
     position?: 'top' | 'left' | 'bottom' | 'right';
     align?: 'start' | 'center' | 'end';
+    labels?: {
+        generateLabels?: (chart: any) => any[];
+        [key: string]: any;
+    };
 };
 
 export declare type TLens = {
@@ -1176,10 +1637,56 @@ export declare type TStyle = {
     dark?: StyleProps;
 };
 
+export declare interface UpdateUserPreferenceRequest {
+    defaultDashboardId: string | null;
+}
+
+/**
+ * URL Parameter for drill-to-URL interpolation
+ * Represents a placeholder in the URL template (e.g., {{product_id}})
+ */
+declare interface URLParameter {
+    /**
+     * Unique identifier for the parameter (e.g., 'product_id', 'card_id')
+     * Used in template as {{id}}
+     */
+    id: string;
+    /**
+     * Display label for the parameter
+     */
+    label: string;
+    /**
+     * Category of the parameter
+     * - attribute: From card dimensions/attributes (e.g., product name, region)
+     * - identifier: System values (card_id, frame_id, sheet_id)
+     */
+    category: 'attribute' | 'identifier';
+    /**
+     * For attribute parameters: the complete field object
+     * Provides access to all field properties (name, qualifiedFieldName, dataType, etc.)
+     */
+    field?: Field;
+}
+
+export declare interface UserPreference {
+    id: string;
+    actorType: 'ORG_USER' | 'TENANT_USER';
+    projectId: string;
+    defaultDashboardId: string | null;
+    defaultDashboard?: {
+        id: string;
+        title: string;
+        description: string;
+    };
+    preferences: Record<string, any> | null;
+    createdAt: string;
+    updatedAt: string;
+}
+
 /**
  * Display mode for visual components - controls which UI elements are shown
  */
-export declare type VisualDisplayMode = 'full' | 'content-only' | 'print' | 'embed' | 'table-print';
+export declare type VisualDisplayMode = 'full' | 'print' | 'table-print';
 
 /**
  * Display preferences for controlling visual component rendering
@@ -1188,9 +1695,8 @@ 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
+     * - 'table-print': Table-specific print mode (title only, no pagination/toolbar)
      */
     mode?: VisualDisplayMode;
     /**