react-semaphor 0.1.259 → 0.1.261

package/dist/surfboard/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("../chunks/index-DAhkssOV.js"),a=require("../types/index.cjs"),e=require("../chunks/dashboard-summary-settings-dialog-DMWYgbwB.js");exports.Surfboard=r.DashboardPlus;exports.EMPTY_SELECTION=a.EMPTY_SELECTION;exports.CalendarPreferencesDialog=e.CalendarPreferencesDialog;exports.DashboardSummarySettingsDialog=e.DashboardSummarySettingsDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("../chunks/index-BoJEr_9F.js"),e=require("../types/index.cjs"),r=require("../chunks/dashboard-summary-settings-dialog-Be3JilRI.js");exports.Surfboard=a.DashboardPlus;exports.CONTROL_CARD_DEFAULT_VALUE=e.CONTROL_CARD_DEFAULT_VALUE;exports.EMPTY_SELECTION=e.EMPTY_SELECTION;exports.CalendarPreferencesDialog=r.CalendarPreferencesDialog;exports.DashboardSummarySettingsDialog=r.DashboardSummarySettingsDialog;

package/dist/surfboard/index.js

@@ -1,9 +1,10 @@
-import { a as o } from "../chunks/index-DpSxZvI0.js";
-import { EMPTY_SELECTION as s } from "../types/index.js";
-import { C as m, D as t } from "../chunks/dashboard-summary-settings-dialog-CxZAMb8B.js";
+import { a as o } from "../chunks/index-C2c-_lPE.js";
+import { CONTROL_CARD_DEFAULT_VALUE as s, EMPTY_SELECTION as D } from "../types/index.js";
+import { C as m, D as t } from "../chunks/dashboard-summary-settings-dialog-B9zRCvc-.js";
 export {
+  s as CONTROL_CARD_DEFAULT_VALUE,
   m as CalendarPreferencesDialog,
   t as DashboardSummarySettingsDialog,
-  s as EMPTY_SELECTION,
+  D as EMPTY_SELECTION,
   o as Surfboard
 };

package/dist/types/dashboard.d.ts

@@ -309,6 +309,78 @@ export declare type ConnectionPolicy = {
 
 declare type ConnectionType = 'GoogleSheets' | 'FileUpload' | 'MySQL' | 'MSSQL' | 'PostgreSQL' | 'BigQuery' | 'Redshift' | 'Snowflake' | 'S3' | 'clickhouse' | 'S3Tables' | 'API' | 'none';
 
+export declare const CONTROL_CARD_DEFAULT_VALUE: "__card_default__";
+
+export declare type ControlBinding = {
+    controlId: string;
+    target: 'sql_param';
+    paramId: string;
+} | {
+    controlId: string;
+    target: 'config_metric_selector';
+    mapping: Record<string, StructuralMetricSelectorTarget>;
+} | {
+    controlId: string;
+    target: 'config_field_selector';
+    mapping: Record<string, StructuralFieldSelectorTarget>;
+} | {
+    controlId: string;
+    target: 'config_aggregation';
+    mapping: Record<string, string>;
+} | {
+    controlId: string;
+    target: 'config_grain';
+    mapping: Record<string, string>;
+};
+
+export declare type ControlDefinition = {
+    id: string;
+    label: string;
+    scope: ControlScope;
+    type: ControlType;
+    source: ControlSource;
+    initialValueStrategy: ControlInitialValueStrategy;
+    defaultValue?: unknown;
+    requiredAtExecution: boolean;
+    hidden?: boolean;
+    locked?: boolean;
+    helpText?: string;
+    placement?: 'toolbar' | 'card_header' | 'advanced';
+    showLabel?: boolean;
+    toolbarWidth?: number;
+};
+
+export declare type ControlInitialValueStrategy = 'saved_default' | 'builtin' | 'embed_required' | 'schedule_snapshot';
+
+export declare type ControlOption = {
+    value: string;
+    label: string;
+    presentation?: {
+        granularity?: TimeGranularity;
+        dateFormat?: DateFormatValue;
+        customFormat?: string;
+    };
+};
+
+export declare type ControlScope = 'dashboard' | 'card';
+
+export declare type ControlSource = {
+    kind: 'manual';
+    options: ControlOption[];
+} | {
+    kind: 'dataset_values';
+    fieldId: string;
+    connectionId?: string;
+} | {
+    kind: 'field_allowlist';
+    fieldIds: string[];
+} | {
+    kind: 'metric_allowlist';
+    metricIds: string[];
+};
+
+export declare type ControlType = 'enum' | 'multi_enum' | 'text' | 'number' | 'boolean' | 'date' | 'field_selector' | 'metric_selector' | 'aggregation_selector' | 'grain_selector';
+
 export declare type CustomCard = CardWithContent | CardWithFooter;
 
 export declare function Dashboard(props: DashboardProps): JSX.Element | null;
@@ -360,6 +432,20 @@ 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?: TFilterValue[];
+    /**
+     * Default runtime control values for the dashboard. Used by print/render flows
+     * and other external entry points that need deterministic control state.
+     */
+    defaultControlValues?: Record<string, unknown>;
+    /**
+     * Optional control contract override used by print/replay entry points that
+     * need to execute against a saved card/dashboard control contract snapshot.
+     */
+    controlContractOverrides?: {
+        controlDefinitions?: ControlDefinition[];
+        cardControlDefinitions?: ControlDefinition[];
+        controlBindings?: ControlBinding[];
+    };
     customStyle?: TStyle;
     currentTheme?: Theme;
     version?: string;
@@ -799,6 +885,11 @@ export declare type FilterLayoutSettings = {
      * Useful when embedding Dashboard component without Surfboard's controls
      */
     showDownloadButton?: boolean;
+    /**
+     * Mixed toolbar item order for dashboard-level filter and control chips.
+     * Values use prefixed ids like `filter:<id>` and `control:<id>`.
+     */
+    toolbarItemOrder?: string[];
 };
 
 declare type FilterLocation = 'dashboard' | 'frame' | 'sheet' | undefined;
@@ -1205,6 +1296,10 @@ declare type StringOptions = {
     maxLength?: number;
 };
 
+export declare type StructuralFieldSelectorTarget = GroupByField;
+
+export declare type StructuralMetricSelectorTarget = MetricField;
+
 /**
  * Style propeerites for the dashboard
  */
@@ -1428,6 +1523,14 @@ export declare type TCard = {
      * Configured by editors via the visual editor settings.
      */
     inlineFilters?: TInlineFilter[];
+    /**
+     * Card-scoped control definitions for this card.
+     */
+    controls?: ControlDefinition[];
+    /**
+     * Per-card bindings that connect dashboard or card controls to this card's runtime targets.
+     */
+    controlBindings?: ControlBinding[];
 };
 
 export declare type TCardContext = {
@@ -1644,6 +1747,8 @@ export declare type TDashboard = {
     globalCacheConfig?: CacheConfig;
     emailSettings?: EmailSettings;
     defaultFilterValues?: TFilterValue[];
+    controls?: ControlDefinition[];
+    defaultControlValues?: Record<string, unknown>;
     filterLayout?: FilterLayoutSettings;
 };
 

package/dist/types/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const E={mode:"all"},T={tz:"UTC",weekStart:1,anchor:"now"},t={database:null,schema:null,table:null};exports.DEFAULT_CALENDAR_CONTEXT=T;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=E;exports.EMPTY_SELECTION=t;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _={mode:"all"},E={tz:"UTC",weekStart:1,anchor:"now"},A={database:null,schema:null,table:null},T="__card_default__";exports.CONTROL_CARD_DEFAULT_VALUE=T;exports.DEFAULT_CALENDAR_CONTEXT=E;exports.DEFAULT_SEMANTIC_DOMAIN_ACCESS=_;exports.EMPTY_SELECTION=A;

package/dist/types/index.js

@@ -1,4 +1,4 @@
-const l = {
+const _ = {
   mode: "all"
 }, t = {
   tz: "UTC",
@@ -9,9 +9,10 @@ const l = {
   database: null,
   schema: null,
   table: null
-};
+}, a = "__card_default__";
 export {
+  a as CONTROL_CARD_DEFAULT_VALUE,
   t as DEFAULT_CALENDAR_CONTEXT,
-  l as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
+  _ as DEFAULT_SEMANTIC_DOMAIN_ACCESS,
   E as EMPTY_SELECTION
 };

package/dist/types/main.d.ts

@@ -11,6 +11,7 @@ import { JSX } from 'react/jsx-runtime';
 import { JSX as JSX_2 } from 'react';
 import { QueryObserverResult } from '@tanstack/query-core';
 import * as React_2 from 'react';
+import { ReactNode } from 'react';
 import { RefetchOptions } from '@tanstack/query-core';
 import { StoreApi } from 'zustand';
 import { UseBoundStore } from 'zustand';
@@ -39,6 +40,10 @@ declare type Actions_2 = {
     setInitStore: () => void;
     setGlobalStyle: (style: TStyle) => void;
     setDefaultFilterValues: (filterValues: TFilterValue[] | undefined) => void;
+    setDefaultControlValues: (controlValues: Record<string, unknown> | undefined) => void;
+    setDashboardControlsModel: (controls: ControlDefinition[], defaultValues?: Record<string, unknown>, options?: DashboardControlsModelOptions) => void;
+    updateDashboardControl: (controlId: string, updates: Partial<ControlDefinition>) => void;
+    reorderDashboardControls: (orderedControlIds: string[]) => void;
     updateEmailSettings: (emailSettings: EmailSettings) => void;
     setIsDownloadingPdf: (isDownloadingPdf: boolean) => void;
     setLenses: (lenses: TLens[]) => void;
@@ -56,7 +61,8 @@ declare type Actions_2 = {
     setAuthToken: (authToken: AuthToken) => void;
     setThemeStyle: (themeStyle: StyleProps) => void;
     setDashboard: (dashboard: TDashboard) => void;
-    setDashboardWithFilterValues: (dashboard: TDashboard, filterValues: TFilterValue[]) => void;
+    setDashboardWithFilterValues: (dashboard: TDashboard, filterValues: TFilterValue[], runtimeOverrides?: Record<string, unknown>) => void;
+    hydrateRuntimeControlValues: (dashboard: TDashboard, runtimeOverrides?: Record<string, unknown>) => void;
     setDashboardTheme: (theme: 'light' | 'dark' | 'system') => void;
     setDashboardTitle: (title: string) => void;
     setDashboardDescription: (description: string) => void;
@@ -81,6 +87,16 @@ declare type Actions_2 = {
     setCardInlineFilterValue: (cardId: string, filterValue: TFilterValue) => void;
     removeCardInlineFilterValue: (cardId: string, filterId: string) => void;
     getCardInlineFilterValues: (cardId: string) => TFilterValue[];
+    setControlValue: (controlId: string, value: unknown) => void;
+    removeControlValue: (controlId: string) => void;
+    setCardControlValue: (cardId: string, controlId: string, value: unknown) => void;
+    removeCardControlValue: (cardId: string, controlId: string) => void;
+    setCardControlRuntimeModel: (cardId: string, controls: ControlDefinition[], options?: {
+        renamed?: {
+            oldId: string;
+            newId: string;
+        };
+    }) => void;
     clearAllInlineFilterValues: () => void;
     setInlineFilterValuesMap: (map: Record<string, TFilterValue[]>) => void;
     setCardInlineFilterMode: (sheetId: string, cardId: string, filterId: string, filterMode: 'include' | 'exclude') => void;
@@ -386,6 +402,10 @@ declare type AlertDraft = {
     deliveryConfig?: Partial<DeliveryConfig>;
 };
 
+export declare type AlertExecutionControlContext = {
+    values: Record<string, unknown>;
+};
+
 export declare type AlertExecutionFilterContext = {
     active_filters: TFilterValue[];
 };
@@ -522,6 +542,10 @@ export declare type AlertSource = {
     executionSnapshot: {
         queryConfig: AlertExecutionQueryConfig;
         filterContext: AlertExecutionFilterContext;
+        controlContext?: AlertExecutionControlContext;
+        controlDefinitions?: ControlDefinition[];
+        cardControlDefinitions?: ControlDefinition[];
+        controlBindings?: ControlBinding[];
         connectionId: string;
         calendarContext?: {
             tz: string;
@@ -1114,6 +1138,80 @@ export declare type ContextSource = {
     outputAs?: string;
 };
 
+export declare const CONTROL_CARD_DEFAULT_VALUE: "__card_default__";
+
+export declare type ControlBinding = {
+    controlId: string;
+    target: 'sql_param';
+    paramId: string;
+} | {
+    controlId: string;
+    target: 'config_metric_selector';
+    mapping: Record<string, StructuralMetricSelectorTarget>;
+} | {
+    controlId: string;
+    target: 'config_field_selector';
+    mapping: Record<string, StructuralFieldSelectorTarget>;
+} | {
+    controlId: string;
+    target: 'config_aggregation';
+    mapping: Record<string, string>;
+} | {
+    controlId: string;
+    target: 'config_grain';
+    mapping: Record<string, string>;
+};
+
+declare type ControlBindingsByCardId = Record<string, ControlBinding[] | undefined>;
+
+export declare type ControlDefinition = {
+    id: string;
+    label: string;
+    scope: ControlScope;
+    type: ControlType;
+    source: ControlSource;
+    initialValueStrategy: ControlInitialValueStrategy;
+    defaultValue?: unknown;
+    requiredAtExecution: boolean;
+    hidden?: boolean;
+    locked?: boolean;
+    helpText?: string;
+    placement?: 'toolbar' | 'card_header' | 'advanced';
+    showLabel?: boolean;
+    toolbarWidth?: number;
+};
+
+export declare type ControlInitialValueStrategy = 'saved_default' | 'builtin' | 'embed_required' | 'schedule_snapshot';
+
+export declare type ControlOption = {
+    value: string;
+    label: string;
+    presentation?: {
+        granularity?: TimeGranularity;
+        dateFormat?: DateFormatValue;
+        customFormat?: string;
+    };
+};
+
+export declare type ControlScope = 'dashboard' | 'card';
+
+export declare type ControlSource = {
+    kind: 'manual';
+    options: ControlOption[];
+} | {
+    kind: 'dataset_values';
+    fieldId: string;
+    connectionId?: string;
+} | {
+    kind: 'field_allowlist';
+    fieldIds: string[];
+} | {
+    kind: 'metric_allowlist';
+    metricIds: string[];
+};
+
+export declare type ControlType = 'enum' | 'multi_enum' | 'text' | 'number' | 'boolean' | 'date' | 'field_selector' | 'metric_selector' | 'aggregation_selector' | 'grain_selector';
+
 export declare function createAlert(apiServiceUrl: string, token: string, payload: CreateAlertRequest): Promise<{
     alert: Alert;
 }>;
@@ -1162,6 +1260,10 @@ export declare interface CreateExportRequest {
     cardConfig: CardConfig;
     cardDataSource: DataSource;
     active_filters: TFilterValue[];
+    controlValues?: Record<string, unknown>;
+    controlDefinitions?: ControlDefinition[];
+    cardControlDefinitions?: ControlDefinition[];
+    controlBindings?: ControlBinding[];
     timezone?: string;
     totalRows: number;
     format: ExportFormat;
@@ -1198,6 +1300,26 @@ declare type DashboardAIContext = AIContext & {
 
 declare type DashboardAIContextMode = 'auto' | 'fixed';
 
+declare type DashboardControlsModelOptions = {
+    renamed?: {
+        oldId: string;
+        newId: string;
+    };
+    removedControlId?: string;
+    cardBindingsById?: ControlBindingsByCardId;
+    affectedBindingControlIds?: string[];
+};
+
+export declare function DashboardControlsSettings({ open, onOpenChange, trigger, showTrigger, initialMode, }: DashboardControlsSettingsProps): JSX.Element;
+
+declare type DashboardControlsSettingsProps = {
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    trigger?: ReactNode;
+    showTrigger?: boolean;
+    initialMode?: 'manage' | 'create';
+};
+
 export declare type DashboardEventHandlers = {
     onExportData?: (payload: ExportDataPayload) => void;
 };
@@ -1209,6 +1331,21 @@ declare interface DashboardExportDialogProps {
     onOpenChange: (open: boolean) => void;
 }
 
+export declare function DashboardFilterControlsButton({ showFilters, onToggleFilters, onAddFilter, onAddControl, onManageControls, size, className, primaryButtonClassName, secondaryButtonClassName, dropdownContentClassName, }: DashboardFilterControlsButtonProps): JSX.Element;
+
+declare type DashboardFilterControlsButtonProps = {
+    showFilters: boolean;
+    onToggleFilters: () => void;
+    onAddFilter: () => void;
+    onAddControl: () => void;
+    onManageControls: () => void;
+    size?: 'default' | 'toolbar';
+    className?: string;
+    primaryButtonClassName?: string;
+    secondaryButtonClassName?: string;
+    dropdownContentClassName?: string;
+};
+
 declare type DashboardPlusProps = {
     showControls?: boolean;
     showFooter?: boolean;
@@ -1251,6 +1388,20 @@ 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?: TFilterValue[];
+    /**
+     * Default runtime control values for the dashboard. Used by print/render flows
+     * and other external entry points that need deterministic control state.
+     */
+    defaultControlValues?: Record<string, unknown>;
+    /**
+     * Optional control contract override used by print/replay entry points that
+     * need to execute against a saved card/dashboard control contract snapshot.
+     */
+    controlContractOverrides?: {
+        controlDefinitions?: ControlDefinition[];
+        cardControlDefinitions?: ControlDefinition[];
+        controlBindings?: ControlBinding[];
+    };
     customStyle?: TStyle;
     currentTheme?: Theme;
     version?: string;
@@ -1304,6 +1455,10 @@ export declare type DashboardStore = {
     filterValues?: TFilterValue[];
     /** Runtime-only inline filter values, keyed by cardId. Not persisted with dashboard. */
     inlineFilterValuesMap: Record<string, TFilterValue[]>;
+    /** Runtime-only dashboard control values keyed by globally unique controlId. */
+    controlValues: Record<string, unknown>;
+    /** Runtime-only card-scoped control values, keyed by cardId then controlId. */
+    cardControlValuesMap: Record<string, Record<string, unknown>>;
     isDashboardPanelOpen: boolean;
     drillHistory: Array<{
         sourceDashboardId: string;
@@ -2229,6 +2384,11 @@ export declare type FilterLayoutSettings = {
      * Useful when embedding Dashboard component without Surfboard's controls
      */
     showDownloadButton?: boolean;
+    /**
+     * Mixed toolbar item order for dashboard-level filter and control chips.
+     * Values use prefixed ids like `filter:<id>` and `control:<id>`.
+     */
+    toolbarItemOrder?: string[];
 };
 
 declare type FilterLocation = 'dashboard' | 'frame' | 'sheet' | undefined;
@@ -3169,6 +3329,10 @@ declare type StringOptions = {
     maxLength?: number;
 };
 
+export declare type StructuralFieldSelectorTarget = GroupByField;
+
+export declare type StructuralMetricSelectorTarget = MetricField;
+
 /**
  * Style propeerites for the dashboard
  */
@@ -3487,6 +3651,14 @@ export declare type TCard = {
      * Configured by editors via the visual editor settings.
      */
     inlineFilters?: TInlineFilter[];
+    /**
+     * Card-scoped control definitions for this card.
+     */
+    controls?: ControlDefinition[];
+    /**
+     * Per-card bindings that connect dashboard or card controls to this card's runtime targets.
+     */
+    controlBindings?: ControlBinding[];
 };
 
 export declare type TCardContext = {
@@ -3705,6 +3877,8 @@ export declare type TDashboard = {
     globalCacheConfig?: CacheConfig;
     emailSettings?: EmailSettings;
     defaultFilterValues?: TFilterValue[];
+    controls?: ControlDefinition[];
+    defaultControlValues?: Record<string, unknown>;
     filterLayout?: FilterLayoutSettings;
 };
 

package/dist/types/shared.d.ts

@@ -290,6 +290,76 @@ declare type ColumnType = 'string' | 'number' | 'date';
 
 declare type ConnectionType = 'GoogleSheets' | 'FileUpload' | 'MySQL' | 'MSSQL' | 'PostgreSQL' | 'BigQuery' | 'Redshift' | 'Snowflake' | 'S3' | 'clickhouse' | 'S3Tables' | 'API' | 'none';
 
+declare type ControlBinding = {
+    controlId: string;
+    target: 'sql_param';
+    paramId: string;
+} | {
+    controlId: string;
+    target: 'config_metric_selector';
+    mapping: Record<string, StructuralMetricSelectorTarget>;
+} | {
+    controlId: string;
+    target: 'config_field_selector';
+    mapping: Record<string, StructuralFieldSelectorTarget>;
+} | {
+    controlId: string;
+    target: 'config_aggregation';
+    mapping: Record<string, string>;
+} | {
+    controlId: string;
+    target: 'config_grain';
+    mapping: Record<string, string>;
+};
+
+declare type ControlDefinition = {
+    id: string;
+    label: string;
+    scope: ControlScope;
+    type: ControlType;
+    source: ControlSource;
+    initialValueStrategy: ControlInitialValueStrategy;
+    defaultValue?: unknown;
+    requiredAtExecution: boolean;
+    hidden?: boolean;
+    locked?: boolean;
+    helpText?: string;
+    placement?: 'toolbar' | 'card_header' | 'advanced';
+    showLabel?: boolean;
+    toolbarWidth?: number;
+};
+
+declare type ControlInitialValueStrategy = 'saved_default' | 'builtin' | 'embed_required' | 'schedule_snapshot';
+
+declare type ControlOption = {
+    value: string;
+    label: string;
+    presentation?: {
+        granularity?: TimeGranularity;
+        dateFormat?: DateFormatValue;
+        customFormat?: string;
+    };
+};
+
+declare type ControlScope = 'dashboard' | 'card';
+
+declare type ControlSource = {
+    kind: 'manual';
+    options: ControlOption[];
+} | {
+    kind: 'dataset_values';
+    fieldId: string;
+    connectionId?: string;
+} | {
+    kind: 'field_allowlist';
+    fieldIds: string[];
+} | {
+    kind: 'metric_allowlist';
+    metricIds: string[];
+};
+
+declare type ControlType = 'enum' | 'multi_enum' | 'text' | 'number' | 'boolean' | 'date' | 'field_selector' | 'metric_selector' | 'aggregation_selector' | 'grain_selector';
+
 declare type CustomCard = CardWithContent | CardWithFooter;
 
 declare type DashboardAIContext = AIContext & {
@@ -695,6 +765,11 @@ declare type FilterLayoutSettings = {
      * Useful when embedding Dashboard component without Surfboard's controls
      */
     showDownloadButton?: boolean;
+    /**
+     * Mixed toolbar item order for dashboard-level filter and control chips.
+     * Values use prefixed ids like `filter:<id>` and `control:<id>`.
+     */
+    toolbarItemOrder?: string[];
 };
 
 declare type FilterLocation = 'dashboard' | 'frame' | 'sheet' | undefined;
@@ -1063,6 +1138,10 @@ declare type StringOptions = {
     maxLength?: number;
 };
 
+declare type StructuralFieldSelectorTarget = GroupByField;
+
+declare type StructuralMetricSelectorTarget = MetricField;
+
 /**
  * Style propeerites for the dashboard
  */
@@ -1286,6 +1365,14 @@ declare type TCard = {
      * Configured by editors via the visual editor settings.
      */
     inlineFilters?: TInlineFilter[];
+    /**
+     * Card-scoped control definitions for this card.
+     */
+    controls?: ControlDefinition[];
+    /**
+     * Per-card bindings that connect dashboard or card controls to this card's runtime targets.
+     */
+    controlBindings?: ControlBinding[];
 };
 
 declare type TCardPreferences = {
@@ -1495,6 +1582,8 @@ declare type TDashboard = {
     globalCacheConfig?: CacheConfig;
     emailSettings?: EmailSettings;
     defaultFilterValues?: TFilterValue[];
+    controls?: ControlDefinition[];
+    defaultControlValues?: Record<string, unknown>;
     filterLayout?: FilterLayoutSettings;
 };