react-semaphor 0.0.3932 → 0.0.5321

package/dist/types/main.d.ts

@@ -1,24 +1,39 @@
+import { AIContext as AIContext_2 } from '../../lib/types/assistant-types';
 import { AIScopeTable as AIScopeTable_2 } from '..';
 import { CacheConfig as CacheConfig_2 } from '..';
 import { Chart } from 'chart.js';
 import { ChartConfiguration } from 'chart.js';
+import { ComboBoxOption as ComboBoxOption_2 } from '../../components/surfboard/filter/types';
 import { CustomCard as CustomCard_2 } from '..';
 import { DateRange } from 'react-day-picker';
 import { default as default_2 } from 'react-grid-layout';
+import { Dialect as Dialect_2 } from '../types/explorer-types';
+import { DropdownItem as DropdownItem_2 } from '../types/dropdown-types';
+import { EmailSettings as EmailSettings_2 } from '..';
 import { FontSpec } from 'chart.js';
+import { GroupByField as GroupByField_2 } from '../types/explorer-types';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { MetricField as MetricField_2 } from '../types/explorer-types';
+import { PivotByField as PivotByField_2 } from '../types/explorer-types';
 import { QueryObserverResult } from '@tanstack/query-core';
 import { RefetchOptions } from '@tanstack/query-core';
 import { StoreApi } from 'zustand';
 import { TBaseQuery as TBaseQuery_2 } from '..';
+import { TDbCapabilities as TDbCapabilities_2 } from '../types';
 import { TFilter as TFilter_2 } from '../surfboard/filter/types';
+import { TFilterValue as TFilterValue_2 } from '..';
 import { TStyle as TStyle_2 } from '..';
 import { UseBoundStore } from 'zustand';
 import { WritableDraft } from 'immer';
 
 declare type Actions = {
+    setAiContext: (aiContext: AIContext) => void;
+    setHandleOpenAssistantProfile: (handleOpenAssistantProfile: () => void) => void;
+    setFilterMode: (filterId: string, filterMode: 'include' | 'exclude') => void;
     setInitStore: () => void;
     setGlobalStyle: (style: TStyle) => void;
+    setDefaultFilterValues: (filterValues: TFilterValue[] | undefined) => void;
+    updateEmailSettings: (emailSettings: EmailSettings) => void;
     setIsDownloadingPdf: (isDownloadingPdf: boolean) => void;
     setLenses: (lenses: TLens[]) => void;
     setSelectedLensId: (lensId: string) => void;
@@ -55,6 +70,7 @@ declare type Actions = {
     updateFrame: (sheetId: string, frame: TFrame) => void;
     updateCard: (sheetId: string, card: TCard) => void;
     updateFrameCard?: (sheetId: string, frameId: string, card: TCard) => void;
+    updateCurrentDashboardCard: (card: TCard) => void;
     removeFrame: (sheetId: string, frameId: string) => void;
     removeCard: (sheetId: string, card: TCard) => void;
     setIsDashboardEditing: (editing: boolean) => void;
@@ -93,7 +109,41 @@ declare type Actions = {
     setBaseQueries: (baseQueries: TBaseQuery[]) => void;
 };
 
-declare type Actions_2 = {
+declare type Actions_2 = TableActions & ExplorerActions & DrillActions & {
+    setEditorFilterMode: (filterColumnName: string, filterMode: 'include' | 'exclude') => void;
+    setLowerIsBetter: (lowerIsBetter: boolean) => void;
+    clearEditorFilter: (filterColumn: FilterByColumn) => void;
+    removeEditorFilter: (filterColumn: FilterByColumn) => void;
+    updateEditorFilterValue: (filterColumnName: string, filterValue: OldFilterValue, clearFilter?: boolean) => void;
+    setTempQueryData: (tempQueryData: {
+        queryKey: string[];
+        queryData: any;
+    }) => void;
+    clearQueryConfig: () => void;
+    setQueryConfig: (queryConfig: QueryConfig | undefined) => void;
+    setCardTitle: (title: string) => void;
+    setCardDescription: (description: string) => void;
+    setCountryLogo: (countryLogoId: string | null) => void;
+    setIsDevMode: (isDevMode: boolean) => void;
+    setOrderByColumns: (orderByColumns: OrderBy[]) => void;
+    addOrderByColumn: (orderByColumn: OrderBy) => void;
+    removeOrderByColumn: (orderByColumn: OrderBy) => void;
+    updateOrderByColumn: (orderByColumn: OrderBy) => void;
+    setGroupByColumns: (groupByColumns: GroupByColumn[]) => void;
+    setMetricColumns: (metricColumns: MetricColumn[]) => void;
+    setPivotByColumns: (pivotColumns: GroupByColumn[]) => void;
+    removeColumnFromGroupBy: (columnId: string) => void;
+    removeColumnFromMetricColumns: (columnId: string) => void;
+    removeColumnFromPivotBy: (columnId: string) => void;
+    addColumnToGroupBy: (column: GroupByColumn) => void;
+    addColumnToMetricColumns: (column: MetricColumn) => void;
+    setFilterColumns: (filterColumns: FilterByColumn[]) => void;
+    addColumnToFilterColumns: (column: FilterByColumn) => void;
+    removeColumnFromFilterColumns: (columnId: string) => void;
+    updateMetricColumnOld: (columnId: string, column: MetricColumn) => void;
+    updateGroupByColumnOld: (columnId: string, column: GroupByColumn) => void;
+    updatePivotByColumnOld: (columnId: string, column: GroupByColumn) => void;
+    updateFilterColumn: (columnId: string, column: FilterByColumn) => void;
     setCurrentAssitantScope: (currentAssitantScope: AIScopeTable[]) => void;
     setChartGrid: (chartGrid: 'xy' | 'x' | 'y' | 'none') => void;
     setLegendOptions: (legendOptions: TLegendOptions) => void;
@@ -129,7 +179,7 @@ declare type Actions_2 = {
     setCardPython: (python: string | undefined) => void;
     setPythonStdOut: (pythonStdOut: string) => void;
     setCardCustomCfg: (cfg: any) => void;
-    setCardCfg: (cfg: any) => void;
+    setCardConfig: (config: CardConfig | undefined) => void;
     setShowFilters: (showFilters: boolean) => void;
     setApplyFilters: (applyFilters: boolean) => void;
     setFilterValues: (filterValues: TFilterValue[]) => void;
@@ -138,7 +188,6 @@ declare type Actions_2 = {
     setSelectedDatabaseName: (databaseName: string) => void;
     setSelectedSchemaName: (schemaName: string) => void;
     setSelectedTableName: (tableName: string) => void;
-    setCurrentColumns: (columns: TDataColumn[]) => void;
     setOnConnectionChange: (onConnectionChange: (connectionId: string) => void) => void;
     setOnDatabaseChange: (onDatabaseChange: (databaseName: string) => void) => void;
     setOnSchemaChange: (onSchemaChange: (schemaName: string) => void) => void;
@@ -149,6 +198,12 @@ declare type Actions_2 = {
 
 export declare type AggregateCalc = 'AVG' | 'MIN' | 'MAX' | 'SUM' | 'COUNT' | 'COUNT_DISTINCT';
 
+export declare type AggregateFunction = 'COUNT' | 'SUM' | 'AVG' | 'MIN' | 'MAX' | 'MEDIAN' | 'DISTINCT';
+
+declare type AIContext = {
+    selectedEntities: SelectedEntities;
+};
+
 export declare type AIScopeTable = {
     connectionId: string;
     connectionType: string;
@@ -159,11 +214,21 @@ export declare type AIScopeTable = {
     datamodelName: string;
 };
 
+export declare type AssistantId = 'dashboard-assistant' | 'editor-assistant';
+
 export declare type AuthToken = {
     accessToken: string;
     refreshToken?: string;
 };
 
+export declare interface BaseColumn {
+    id: string;
+    name: string;
+    label?: string;
+    type: ColumnType;
+    table?: string;
+}
+
 declare type BaseCustomCard = {
     cardId: string;
     replaceDefault?: boolean;
@@ -184,6 +249,51 @@ export declare type CacheConfig = {
     status: 'on' | 'on-refresh' | 'off';
 };
 
+export 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';
+}
+
+declare interface CardInteractionConfig {
+    allowedDrillTargets?: Field[];
+    drillHierarchies?: DrillHierarchy[];
+    drillInteractions?: DrillInteraction[];
+    clickFilterInteractions?: ClickFilterInteraction[];
+}
+
+export declare type CardMode = 'explorer' | 'dev';
+
 declare type CardWithContent = BaseCustomCard & {
     content: React.FC<{
         card: TCard;
@@ -204,24 +314,107 @@ declare type CardWithFooter = BaseCustomCard & {
 
 export declare function cleanCard(card: TCard): TCard;
 
+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 ColorRange = {
     start: number;
     end: number;
     color: string;
 };
 
+declare interface ColorRange_2 {
+    min: number;
+    max: number;
+    color: string;
+    applyTo: 'cell' | 'row';
+}
+
+export declare type ColumnRole = 'groupby' | 'trendby' | 'metric' | 'filter';
+
+declare interface ColumnSettings {
+    type: 'none' | 'text' | 'number' | 'date' | 'badge' | 'link' | 'progress';
+    textAlign: 'left' | 'center' | 'right';
+    width: string;
+    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;
+    };
+    colorRanges: ColorRange_2[];
+}
+
+declare type ColumnSettingsMap = Record<string, ColumnSettings>;
+
+export declare type ColumnType = 'string' | 'number' | 'date';
+
+declare type ComboBoxOption = {
+    id: number | string;
+    value: string;
+    [key: string]: number | string;
+};
+
+export declare type ConnectionItem = DropdownItem & {
+    type: string;
+};
+
 export declare type ConnectionPolicy = {
     connectionId?: string;
     name: string;
     params: Params;
 };
 
+export declare type ConnectionType = 'GoogleSheets' | 'MySQL' | 'MSSQL' | 'PostgreSQL' | 'BigQuery' | 'Redshift' | 'Snowflake' | 'S3' | 'clickhouse' | 'S3Tables' | 'API' | 'none';
+
+export declare type ContainerId = 'groupBy' | 'metrics' | 'pivotBy' | 'sortBy' | 'source';
+
 export declare function createSqlGenConfig(column: TDataColumn, preSqlGen: SqlGen, calc?: AggregateCalc): SqlGen;
 
 export declare type CustomCard = CardWithContent | CardWithFooter;
 
 export declare function Dashboard(props: DashboardProps): JSX_2.Element;
 
+export declare type DashboardEventHandlers = {
+    onExportData?: (payload: ExportDataPayload) => void;
+};
+
 declare type DashboardPlusProps = {
     showControls?: boolean;
     showFooter?: boolean;
@@ -251,6 +444,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.
      */
@@ -262,6 +456,7 @@ export declare type DashboardProps = {
 };
 
 export declare type DashboardStore = {
+    handleOpenAssistantProfile?: () => void;
     isDownloadingPdf?: boolean;
     isSessionExpired: boolean;
     authToken?: AuthToken;
@@ -283,7 +478,7 @@ export declare type DashboardStore = {
     showFilters: boolean;
     filterValues?: TFilterValue[];
     onEvent?: (event: TEvent) => void;
-    onSaveFunction?: (dashboard: TDashboard) => void;
+    onSaveFunction?: (dashboard: TDashboard, description?: string) => void;
     onAddFrame?: (card: TFrame, sheetId: string) => void;
     onAcceptChanges?: (frame: TFrame, dashboard: TDashboard) => void;
     onUpdateCard?: (card: TCard, sheetId: string) => void;
@@ -293,6 +488,59 @@ export declare type DashboardStore = {
 
 export declare const DashboardWC: CustomElementConstructor;
 
+export declare interface DatabaseEntityReference {
+    connectionId: string;
+    connectionType: ConnectionType;
+    type: EntityType;
+    dialect?: Dialect;
+    database?: string;
+    schema?: string;
+    name: string;
+}
+
+export declare type DatabaseEntityType = 'table' | 'view';
+
+export declare type DatabaseItem = DropdownItem;
+
+export declare interface DataModelEntityReference extends DatabaseEntityReference {
+    type: 'model';
+    id: string;
+    label: string;
+    description: string;
+}
+
+export declare interface DatasetEntityReference extends DatabaseEntityReference {
+    type: 'dataset';
+    id: string;
+    domainId: string;
+    label: string;
+    description: string;
+}
+
+export declare interface DataSource {
+    connectionId: string;
+    semanticDomainId?: string;
+    connectionType: string;
+    mode: 'database' | 'upload' | 'url' | 'semanticDomain';
+    dbSelection?: {
+        database: string;
+        schema: string;
+        entityType: DatabaseEntityType;
+    };
+    selectedEntities: SelectedEntities;
+}
+
+export declare type DataType = 'string' | 'number' | 'date' | 'datetime' | 'boolean' | 'json' | 'geo';
+
+export 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", "YYYY-MM", "MMMM YYYY", "custom"];
+
+export declare type DateFormatOption = {
+    value: DateFormatValue;
+    label: string;
+};
+
+export declare type DateFormatValue = (typeof DATE_FORMAT_VALUES)[number];
+
 export declare type DateOptions = {
     locale: string;
     format: string;
@@ -301,11 +549,94 @@ export declare type DateOptions = {
 
 export { DateRange }
 
+export declare type Dialect = 'mysql' | 'postgresql' | 'bigquery' | 'redshift' | 'snowflake' | 'clickhouse' | 'duckdb';
+
 export declare type DisplayDataType = 'string' | 'date' | 'number' | 'html' | 'none';
 
 export declare function downloadPdf(): Promise<void>;
 
-declare type EditorStore = {
+declare interface DrillActions {
+    updateDrillHierarchies: (h: DrillHierarchy[]) => void;
+    addDrillHierarchy: (h: DrillHierarchy) => void;
+    removeDrillHierarchy: (hierarchyId: string) => void;
+    updateDrillHierarchy: (hierarchyId: string, updates: Partial<DrillHierarchy>) => void;
+    setDefaultHierarchy: (hierarchyId: string) => void;
+    updateAllowedDrillTargets: (t: Field[]) => void;
+    addDrillTarget: (t: Field) => void;
+    removeDrillTarget: (targetId: string) => void;
+    updateDrillInteractions: (i: DrillInteraction[]) => void;
+    addDrillInteraction: (i: DrillInteraction) => void;
+    removeDrillInteraction: (index: number) => void;
+    updateClickFilterInteractions: (i: ClickFilterInteraction[]) => void;
+    addClickFilterInteraction: (i: ClickFilterInteraction) => void;
+    removeClickFilterInteraction: (fieldId: string) => void;
+    updateInlineDrillPreview: (s: {
+        enabled: boolean;
+        limit: number;
+        mode: 'lazy' | 'preloaded';
+    }) => void;
+    toggleInlineDrillPreview: (enabled: boolean) => void;
+    updateInteractionConfig: (c: Partial<CardInteractionConfig>) => void;
+    resetDrillConfiguration: () => void;
+}
+
+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 DropdownItem = {
+    id: string;
+    name: string;
+};
+
+export declare type DroppableId = 'droppable-group-by' | 'droppable-metric';
+
+export declare type EditorStore = {
+    tempQueryData?: {
+        queryKey: string[];
+        queryData: any;
+    };
+    isDevMode: boolean;
     isShowingVisual: boolean;
     showAIDialog: boolean;
     userInputForAI: string;
@@ -328,7 +659,6 @@ declare type EditorStore = {
     selectedDatabaseName?: string;
     selectedSchemaName?: string;
     selectedTableName?: string;
-    currentColumns?: TDataColumn[];
     currentAssitantScope?: AIScopeTable[];
     onConnectionChange?: (connectionId: string) => void;
     onDatamodelChange?: (datamodelId: string) => void;
@@ -339,10 +669,141 @@ declare type EditorStore = {
     onClose?: () => void;
 };
 
+export declare type EmailSettings = {
+    companyName: string;
+    dashboardUrl: string;
+    supportEmail: string;
+    senderTitle: string;
+};
+
+export declare const EMPTY_SELECTION: SelectionState;
+
+export declare type EntityColumnGroup = {
+    entityId: string;
+    entityType: EntityType;
+    entityName: string;
+    qualifiedEntityName: string;
+    label?: string;
+    description?: string;
+    columns: Field[];
+};
+
+export declare type EntityType = 'table' | 'view' | 'model' | 'file' | 'dataset' | 'url' | 'upload';
+
 export declare type ErrorProps = {
     message?: string;
 };
 
+declare interface ExplorerActions {
+    updateFrame: (updates: Partial<TFrame>) => void;
+    setActiveCardInFrame: (cardId: string) => void;
+    addCard: () => void;
+    removeCard: (cardId: string) => void;
+    updateCard: (cardId: string, updates: Partial<TCard>) => void;
+    setActiveCard: (cardId: string) => void;
+    setActiveTabCard: (cardId: string | null) => void;
+    updateDataSource: (dataSource: DataSource) => void;
+    setDataSource: (dataSource: DataSource) => void;
+    updateSemanticDomain: (semanticDomainId: string) => void;
+    updateDirectSource: (updates: Partial<DataSource>) => void;
+    getAvailableFields: () => Array<{
+        id: string;
+        name: string;
+        label: string;
+        dataType: string;
+        icon: any;
+        qualifiedEntityName?: string;
+    }>;
+    updateCardConfig: (cardId: string, config: Partial<CardConfig>) => void;
+    updateRowLimit: (cardId: string, rowLimit: number) => void;
+    addGroupByColumn: (cardId: string, column: GroupByField) => void;
+    removeGroupByColumn: (cardId: string, columnId: string) => void;
+    updateGroupByColumn: (cardId: string, columnId: string, updates: Partial<GroupByField>) => void;
+    addMetricColumn: (cardId: string, column: MetricField) => void;
+    removeMetricColumn: (cardId: string, columnId: string) => void;
+    updateMetricColumn: (cardId: string, columnId: string, updates: Partial<MetricField>) => void;
+    addPivotByColumn: (cardId: string, column: PivotByField) => void;
+    removePivotByColumn: (cardId: string, columnId: string) => void;
+    updatePivotByColumn: (cardId: string, columnId: string, updates: Partial<PivotByField>) => void;
+    addSortByColumn: (cardId: string, column: SortByField) => void;
+    removeSortByColumn: (cardId: string, columnId: string) => void;
+    updateSortByColumn: (cardId: string, columnId: string, updates: Partial<SortByField>) => void;
+    updateFilters: (cardId: string, filters: FilterGroup) => void;
+    clearFilters: (cardId: string) => void;
+    addJoin: (cardId: string, join: Join) => void;
+    removeJoin: (cardId: string, joinId: string) => void;
+    updateJoin: (cardId: string, joinId: string, updates: Partial<Join>) => void;
+    reorderJoins: (cardId: string, joinIds: string[]) => void;
+}
+
+export declare type ExportDataPayload = {
+    cardId: string;
+    title: string;
+    data: Record<string, any>[];
+    sql: string;
+};
+
+export 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;
+    dataType: string;
+    description?: string;
+    qualifiedEntityName?: string;
+    dateFormat?: DateFormatValue;
+    customFormat?: string;
+    granularity?: TimeGranularity;
+    entityId: string;
+    entityName: string;
+    entityType: EntityType;
+    role?: 'groupby' | 'metric' | 'sortby' | 'pivotby';
+}
+
+export declare interface FileEntityReference extends DatabaseEntityReference {
+    id: string;
+    type: 'file' | 'url' | 'upload';
+    label: string;
+    description: string;
+    originalName: string;
+    file?: File;
+    url?: string;
+}
+
+export declare interface FilterByColumn extends BaseColumn {
+    role: 'filter';
+    operators?: string[];
+    mode?: 'include' | 'exclude';
+    sql?: string;
+    fetchValues?: boolean;
+    fetchLimit?: number;
+    valueSource?: 'distinct' | 'static' | 'range';
+    staticValues?: string[];
+}
+
+export declare interface FilterCondition {
+    id: string;
+    field: Field;
+    operator: Operator;
+    value: FilterValue;
+}
+
 declare type FilterForBetween = BaseFilter & {
     operation: 'between' | 'not between';
     values: [number, number];
@@ -373,6 +834,14 @@ declare type FilterForString = BaseFilter & {
     values: [string];
 };
 
+export declare interface FilterGroup {
+    id: string;
+    logicalOperator: LogicalOperator;
+    negate: boolean;
+    conditions: FilterCondition[];
+    groups: FilterGroup[];
+}
+
 declare type FilterLocation = 'dashboard' | 'frame' | undefined;
 
 declare type FilterOnClick = {
@@ -380,6 +849,8 @@ declare type FilterOnClick = {
     columnIndex: number;
 };
 
+export declare type FilterValue = string | number | boolean | Date | [number, number] | [string, string] | string[] | number[];
+
 export declare function fmt(str: string): string;
 
 export declare function getColumnDataType(column: TDataColumn): string;
@@ -401,6 +872,7 @@ export declare function getDashbaordStateWithoutData(dashboardState: TDashboard)
     }[] | undefined;
     id: string;
     title?: string;
+    aiContext?: AIContext_2;
     description?: string;
     style?: TStyle_2;
     filters?: TFilter_2[];
@@ -409,6 +881,8 @@ export declare function getDashbaordStateWithoutData(dashboardState: TDashboard)
     aiScopeTables?: AIScopeTable_2[];
     globalStyle?: TStyle_2;
     globalCacheConfig?: CacheConfig_2;
+    emailSettings?: EmailSettings_2;
+    defaultFilterValues?: TFilterValue_2[];
 };
 
 export declare type GetDashboardResponse = {
@@ -420,28 +894,62 @@ export declare type GetDashboardResponse = {
 
 export declare function getFilterValueType(filter: TFilter): "string" | "number" | "date" | "boolean";
 
-export declare function getFormattedTableNameForQuery({ schemaName, tableName, modelName, connectionType, }: {
+export declare function getFormattedTableNameForQuery({ schemaName, tableName, modelName, connectionType, databaseName, }: {
     schemaName: string;
     tableName: string;
     modelName: string | undefined;
-    connectionType: string;
+    connectionType: string | undefined;
+    databaseName: string;
 }): string;
 
 export declare type GetPluginsResponse = {
     plugins: {
         label: string;
         value: string;
+        type: PluginType;
     }[];
 };
 
-export declare function getQualifiedTableName(schemaName: string, tableName: string, connectionType: string): string;
+export declare function getQualifiedTableName({ schemaName, tableName, connectionType, databaseName, }: {
+    schemaName: string;
+    tableName: string;
+    connectionType: string | undefined;
+    databaseName: string;
+}): string;
+
+export declare function getSql(config: SqlGen, schemaName: string, tableName: string, modelName: string, connectionType: string | undefined, databaseName: string): string | undefined;
+
+export declare type Granularity = 'day' | 'week' | 'month' | 'year';
 
-export declare function getSql(config: SqlGen, schemaName: string, tableName: string, modelName: string, connectionType: string): string | undefined;
+export declare interface GroupByColumn extends BaseColumn {
+    role: 'groupby';
+    granularity?: Granularity;
+    format?: string;
+}
+
+export 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;
+}
+
 export declare function invalidateToken(): Promise<any>;
 
 export declare function isBooleanDataType(dataType: string): boolean;
@@ -454,16 +962,87 @@ export declare function isNumberDataType(dataType: string): boolean;
 
 export declare function isTextDataType(dataType: string): boolean;
 
+export declare interface Join {
+    id: string;
+    source: DatabaseEntityReference;
+    target: DatabaseEntityReference;
+    joinType: 'INNER' | 'LEFT' | 'RIGHT' | 'FULL';
+    joinKeyGroups: JoinKeyGroup[];
+    sequence: number;
+}
+
+export declare interface JoinKey {
+    id?: string;
+    source: Field;
+    target: Field;
+    operator: string;
+}
+
+export declare interface JoinKeyGroup {
+    id: string;
+    operator: string;
+    keys: JoinKey[];
+}
+
+export 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;
 };
 
+export declare type LogicalOperator = 'AND' | 'OR';
+
+export declare interface MetricColumn extends BaseColumn {
+    role: 'metric';
+    aggregate: AggregateFunction;
+    aliasTemplate?: string;
+}
+
+export 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?: Record<string, any>;
+    aliasTemplate?: string;
+    valueAliases?: Record<string, string>;
+}
+
+export declare type ModelItem = DropdownItem;
+
 declare type NoneOptions = {};
 
 export declare type NumberAxisFormat = {
@@ -480,8 +1059,12 @@ export declare type NumberOptions = {
     colorRanges?: ColorRange[];
 };
 
+export 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';
 
+export declare type Operator = '=' | '!=' | '>' | '>=' | '<' | '<=' | 'contains' | 'startsWith' | 'endsWith' | 'in' | 'not in' | 'between';
+
 declare type OptionsMap = {
     number: NumberOptions;
     string: StringOptions;
@@ -490,10 +1073,19 @@ declare type OptionsMap = {
     none: NoneOptions;
 };
 
+export declare interface OrderBy {
+    columnId: string;
+    direction: 'asc' | 'desc';
+}
+
 declare type Params = {
     [key: string]: string | number | string[] | number[];
 };
 
+export declare interface PivotByField extends Field {
+    role: 'pivotby';
+}
+
 export declare type Placeholders = {
     /**
      * Placeholder for the card when there are no records to display.
@@ -505,11 +1097,47 @@ export declare type Placeholders = {
     SessionExpired?: React.ReactNode;
 };
 
+export declare type PluginType = 'custom' | 'standard';
+
+export declare type QueryColumn = GroupByColumn | MetricColumn | FilterByColumn;
+
+export declare interface QueryConfig {
+    groupByColumns?: GroupByColumn[];
+    pivotColumns?: GroupByColumn[];
+    metricColumns?: MetricColumn[];
+    filterColumns?: FilterByColumn[];
+    filters?: QueryFilter[];
+    limit?: number;
+    orderBy?: OrderBy[];
+}
+
+export declare type QueryFilter = {
+    filterColumnName: string;
+    filterValue: OldFilterValue;
+};
+
+export declare type RangeValue = {
+    gte?: string | number;
+    lte?: string | number;
+    lt?: string | number;
+    gt?: string | number;
+};
+
 export declare function resolveDatamodelName(datamodelName: string): string;
 
 export declare const resolveDataType: (value: any) => string;
 
-export declare function SelectComponent({ title, items, value, isLoading, isError, refetch, connectionTooltip, onChange, showNone, className, showIcon, disabled, type, }: SelectProps): JSX_2.Element;
+export declare function ScheduleDashboard({ triggerButtonClassName, }: {
+    triggerButtonClassName?: string;
+}): JSX_2.Element;
+
+export declare type SchemaItem = DropdownItem;
+
+export declare function SelectComponent({ title, items, value, isLoading, isError, refetch, onChange, showNone, className, disabled, type, }: SelectProps): JSX_2.Element;
+
+export declare type SelectedEntities = DatabaseEntityReference[] | DataModelEntityReference[] | FileEntityReference[];
+
+export declare type SelectionState = Record<Level, string | null>;
 
 declare type SelectProps = {
     title: string;
@@ -536,6 +1164,13 @@ declare function SemaphorQueryClient({ children, }: {
 export { SemaphorQueryClient as SemaphorDataProvider }
 export { SemaphorQueryClient }
 
+export declare interface SortByField extends Field {
+    role: 'sortby';
+    direction: 'asc' | 'desc';
+}
+
+export declare type SortDirection = 'asc' | 'desc';
+
 export declare type SqlGen = {
     measures?: {
         name: string;
@@ -563,6 +1198,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;
@@ -583,6 +1226,33 @@ export declare type StyleProps = {
 
 export declare function Surfboard({ showControls, showFooter, ...rest }: DashboardPlusProps): JSX_2.Element;
 
+declare interface TableActions {
+    updateColumnSettingsMap: (columnSettings: ColumnSettingsMap) => void;
+    updateColumnVisibility: (columnId: string, isVisible: boolean) => void;
+    updatePageSize: (pageSize: number) => void;
+    showAllColumns: () => void;
+    hideAllColumns: () => void;
+    toggleSelectColumn: (isVisible: boolean) => void;
+    initializeColumnVisibility: (columnIds: string[]) => void;
+    updateAllColumnVisibility: (visibility: Record<string, boolean>) => void;
+}
+
+export declare type TableConfig = {
+    databaseName: string;
+    schemaName: string;
+    tableName: string;
+    datamodelId: string;
+};
+
+export declare type TableItem = DropdownItem;
+
+declare type TablePreferences = {
+    columnSettingsMap?: ColumnSettingsMap;
+    selectColumnVisible?: boolean;
+    columnVisibility?: Record<string, boolean>;
+    pageSize?: number;
+};
+
 export declare type TBaseQuery = {
     id: string;
     name: string;
@@ -604,7 +1274,10 @@ export declare type TCard = {
     type: TChartType;
     sql?: string;
     python?: string;
-    cfg?: any;
+    dataSource?: DataSource;
+    config?: CardConfig;
+    interactionConfig?: CardInteractionConfig;
+    queryConfig?: QueryConfig;
     customCfg?: any;
     preferences?: TCardPreferences;
     customCardPreferences?: TCustomCardPreferences;
@@ -640,6 +1313,7 @@ export declare type TCardPreferences = {
     datasetOptions?: TDatasetOptions[];
     chartOptions?: TChartOptions;
     columnSettings?: TColumnSetting<DisplayDataType>[];
+    tablePrefs?: TablePreferences;
     allowDownload?: boolean;
     customVisualCode?: string;
     textVisualOptions?: {
@@ -655,6 +1329,10 @@ export declare type TCardPreferences = {
         projectionOffset?: [number, number];
         colorScale?: string;
     };
+    kpiVisualOptions?: {
+        lowerIsBetter?: boolean;
+        countryLogoId?: string;
+    };
 };
 
 declare type TChartConfiguration = ChartConfiguration;
@@ -688,10 +1366,13 @@ export declare type TChartOptions = {
     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' | 'kpi' | 'pyramid' | 'tornado' | 'range' | 'text' | 'map' | 'funnel' | 'custom';
 
 export declare type TColumnSetting<T extends DisplayDataType> = {
     columnIdx: number;
@@ -706,6 +1387,7 @@ export declare type TCustomCardPreferences = {
     url: string;
     componentName: string;
     icon?: string;
+    pluginChartType?: string;
     type?: 'iframe' | 'component';
     visualType?: 'single' | 'multiple';
     settings?: any;
@@ -723,6 +1405,7 @@ export declare type TCustomCardPreferences = {
 export declare type TDashboard = {
     id: string;
     title?: string;
+    aiContext?: AIContext;
     description?: string;
     sheets?: TSheet[];
     style?: TStyle;
@@ -732,12 +1415,16 @@ 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;
 };
 
 export declare type TDatasetOptions = {
@@ -753,6 +1440,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;
@@ -786,6 +1478,15 @@ 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;
+}
+
+export declare type TimeGranularity = 'day' | 'week' | 'month' | 'quarter' | 'year';
+
 export declare type TLegendOptions = {
     display?: boolean;
     position?: 'top' | 'left' | 'bottom' | 'right';
@@ -801,12 +1502,103 @@ export declare type TLens = {
     shared?: boolean;
 };
 
-export declare type TSelectedRecord = {
-    id: number | string;
-    value: string;
-    [key: string]: number | string;
+/**
+ * Parameters for customizing token behavior and formatting.
+ */
+export declare type TokenParams = {
+    currencyFormat: {
+        /**
+         * Locale identifier (e.g., 'en-US', 'fr-FR').
+         */
+        locale: string;
+        /**
+         * Currency code compliant with ISO 4217 (e.g., 'USD', 'EUR').
+         */
+        currency: string;
+    };
+};
+
+/**
+ * Main payload for generating a secure access token for a dashboard.
+ */
+export declare type TokenRequest = {
+    /**
+     * Identifier of the dashboard to be accessed.
+     */
+    dashboardId: string;
+    /**
+     * Secret key used for validating access to the dashboard.
+     */
+    dashboardSecret: string;
+    /**
+     * Token expiry duration in seconds.
+     */
+    tokenExpiry?: number;
+    /**
+     * Unique identifier of the tenant.
+     */
+    tenantId?: string;
+    /**
+     * Unique identifier of the end user accessing the dashboard.
+     */
+    endUserId?: string;
+    /**
+     * Email of the end user (for personalization, audit, or identification).
+     */
+    endUserEmail?: string;
+    /**
+     * Enables self-service editing and lens creation by the end user.
+     */
+    allowEdit?: boolean;
+    /**
+     * Connection-level security policies.
+     * Can be a single policy or an array of policies.
+     */
+    cls?: TokenSecurityPolicy[] | TokenSecurityPolicy;
+    /**
+     * Row-level security policies.
+     * Can be a single policy or an array of policies.
+     */
+    rcls?: TokenSecurityPolicy[] | TokenSecurityPolicy;
+    /**
+     * Parameter overrides and preferences (e.g., formatting).
+     */
+    params?: TokenParams;
+    /**
+     * UI behavior and feature flags.
+     */
+    config?: UIConfig;
+};
+
+/**
+ * Defines a security policy that can be applied at connection or row level.
+ */
+export declare type TokenSecurityPolicy = {
+    /**
+     * Name of the policy (e.g., 'store_sales_primary', 'region_filter').
+     */
+    name: string;
+    /**
+     * Arbitrary parameters associated with the policy.
+     * Examples:
+     *
+     * // Single value
+     * {
+     *   tenant: 'tenant_abc_123'
+     * }
+     *
+     * // Multiple values
+     * {
+     *   state: ['California', 'Nevada', 'Washington']
+     * }
+     */
+    params: {
+        [key: string]: string | number | string[] | number[];
+    };
 };
 
+export declare type TSelectedRecord = ComboBoxOption;
+
 export declare type TSheet = {
     id: string;
     title?: string;
@@ -825,9 +1617,30 @@ export declare type TStyle = {
     dark?: StyleProps;
 };
 
+/**
+ * UI and behavior configuration for the embedded dashboard.
+ */
+export declare type UIConfig = {
+    /**
+     * Enables self-service editing and lens creation by the end user. Legacy field. Use config.allowEdit instead.
+     */
+    allowEdit?: boolean;
+    /**
+     * Enables advanced mode features in the dashboard.
+     * Defaults to true unless explicitly disabled.
+     */
+    showAdvancedMode?: boolean;
+    /**
+     * Enables the AI-powered dashboard assistant.
+     * Defaults to true unless explicitly disabled.
+     */
+    showDashboardAssistant?: boolean;
+};
+
 export declare function useCard(cardId: string): {
     data: any;
     card: TCard;
+    isPending: boolean;
     isError: boolean;
     isLoading: boolean;
     isFetching: boolean;
@@ -837,12 +1650,30 @@ export declare function useCard(cardId: string): {
     queryKey: string[];
 };
 
+export declare const useCurrentActiveCard: () => TCard | undefined;
+
+export declare const useCurrentCardConfig: () => {
+    metricFields: MetricField_2[];
+    groupByFields: GroupByField_2[];
+    pivotByFields: PivotByField_2[];
+};
+
+export declare const useCurrentSheetActiveCards: () => TCard[];
+
 export declare const useDashboardActions: () => Actions;
 
 export declare const useDashboardStore: UseBoundStore<Omit<StoreApi<DashboardStore>, "setState"> & {
 setState(nextStateOrUpdater: DashboardStore | Partial<DashboardStore> | ((state: WritableDraft<DashboardStore>) => void), shouldReplace?: boolean | undefined): void;
 }>;
 
+export declare function useDataColumns(token?: AuthToken): {
+    columns: TDataColumn[];
+    isColumnsLoading: boolean;
+    isColumnsFetching: boolean;
+    isColumnsError: boolean;
+    refetchColumns: (options?: RefetchOptions) => Promise<QueryObserverResult<any, Error>>;
+};
+
 export declare function useDateFilterHook(filterId: string): {
     records: any;
     isLoading: boolean;
@@ -852,34 +1683,48 @@ export declare function useDateFilterHook(filterId: string): {
     dateRange: DateRange | undefined;
     handleClear: () => void;
     handleChange: (date: DateRange | undefined) => void;
+    handleReset: () => void;
 };
 
 export declare const useEditorActions: () => Actions_2;
 
 export declare function useEditorAside(token?: AuthToken, _connectionQueryKey?: string): {
-    connectionItems: any;
+    connectionItems: ConnectionItem[];
+    selectedConnectionId: string | undefined;
+    selectedConnection: {
+        id: string;
+        name: string;
+        type: string;
+        dialect?: Dialect_2;
+        uiType?: "database" | "api" | "s3";
+        capabilities: TDbCapabilities_2;
+    } | undefined;
     isConnectionsLoading: boolean;
     isConnectionsError: boolean;
-    modelItems: any;
+    modelItems: DropdownItem_2[];
     selectedDatamodelId: string | undefined;
     selectedDatamodelName: any;
     isModelsLoading: boolean;
     isModelsError: boolean;
-    databaseItems: any;
+    selectedDatabaseName: string | undefined;
+    databaseItems: DropdownItem_2[];
     isDatabasesLoadingOrFetching: boolean;
     isDatabaseError: boolean;
-    schemaItems: any;
+    schemaItems: DropdownItem_2[];
+    selectedSchemaName: string | undefined;
     isSchemaLoadingOrFetching: boolean;
     isSchemaError: boolean;
-    tableItems: any;
+    tableItems: DropdownItem_2[];
+    selectedTableName: string | undefined;
     isTableLoadingOrFetching: boolean;
     isTableError: boolean;
     columns: TDataColumn[];
     isColumnsLoadingOrFetching: boolean;
     isColumnsError: boolean;
     isNonDbConnection: boolean;
-    connectionType: any;
-    tableName: any;
+    connectionType: string | undefined;
+    tableName: string;
+    formattedTableName: string;
     schemaName: string;
     refetchConnections: (options?: RefetchOptions) => Promise<QueryObserverResult<any, Error>>;
     refetchModels: (options?: RefetchOptions) => Promise<QueryObserverResult<any, Error>>;
@@ -891,6 +1736,7 @@ export declare function useEditorAside(token?: AuthToken, _connectionQueryKey?:
     handleDatamodelChange: (value: string) => void;
     handleDatabaseChange: (value: string) => void;
     handleSchemaChange: (value: string) => void;
+    handleTableChange: (value: string) => void;
 };
 
 export declare const useEditorStore: UseBoundStore<Omit<StoreApi<EditorStore>, "setState"> & {
@@ -901,12 +1747,12 @@ export declare function useTextFilterHook(filterId: string): {
     isLoading: boolean;
     isFetching: boolean;
     isError: boolean;
-    records: TSelectedRecord[];
-    selectedRecords: TSelectedRecord[];
+    records: ComboBoxOption_2[];
+    selectedRecords: ComboBoxOption_2[];
     handleChange: (selectedRecords: TSelectedRecord[]) => void;
     handleClear: () => void;
     handleSelectAll: (checked: boolean) => void;
-    filteredRecords: TSelectedRecord[];
+    filteredRecords: ComboBoxOption_2[];
     isSingleSelect: boolean;
     allSelected: boolean;
 };