@grafana/scenes 6.40.0--canary.1265.18325783397.0 → 6.40.0--canary.1272.18407272616.0

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import * as _grafana_data from '@grafana/data';
-import { BusEventWithPayload, EventBus, BusEvent, BusEventType, BusEventHandler, PanelMenuItem, DataQueryRequest, FieldConfigSource, PanelPlugin, AbsoluteTimeRange, PanelData, InterpolateFunction, PanelModel, TimeRange, DataTransformContext, DataFrame, DataSourceGetTagKeysOptions, DataSourceGetTagValuesOptions, IconName, PageLayoutType, UrlQueryMap, DataQuery as DataQuery$1, DataSourceApi, Registry, RegistryItem, ScopedVars, AdHocVariableFilter, GetTagResponse, MetricFindValue, SelectableValue, VariableRefresh as VariableRefresh$1, VariableSort, DrilldownsApplicability, Scope, EventFilterOptions, AnnotationEvent, AnnotationQuery, DataTransformerConfig, TimeOption, FieldConfig, FieldType, FieldValueMatcherConfig, ScopedVar, RawTimeRange } from '@grafana/data';
-import * as _grafana_schema from '@grafana/schema';
-import { VariableType, VariableHide, LoadingState, TimeZone, DataQuery, DataTopic, DataSourceRef, VariableRefresh, DashboardCursorSync, MatcherConfig, TableFieldOptions } from '@grafana/schema';
+import { BusEventWithPayload, EventBus, BusEvent, BusEventType, BusEventHandler, PanelMenuItem, FieldConfigSource, PanelPlugin, AbsoluteTimeRange, PanelData, InterpolateFunction, PanelModel, TimeRange, DataTransformContext, DataFrame, DataQueryRequest, DataSourceGetTagKeysOptions, DataSourceGetTagValuesOptions, IconName, PageLayoutType, UrlQueryMap, DataQuery as DataQuery$1, DataSourceApi, Registry, RegistryItem, ScopedVars, AdHocVariableFilter, SelectableValue, GetTagResponse, MetricFindValue, VariableRefresh as VariableRefresh$1, VariableSort, DrilldownsApplicability, Scope, EventFilterOptions, AnnotationEvent, AnnotationQuery, DataTransformerConfig, TimeOption, FieldConfig, FieldType, FieldValueMatcherConfig, ScopedVar, RawTimeRange } from '@grafana/data';
 import * as React$1 from 'react';
 import React__default, { ComponentType, CSSProperties, PointerEvent, ForwardRefExoticComponent } from 'react';
 import * as rxjs from 'rxjs';
 import { Observable, Subscription, Unsubscribable, MonoTypeOperatorFunction, ReplaySubject } from 'rxjs';
+import * as _grafana_schema from '@grafana/schema';
+import { VariableType, VariableHide, TimeZone, DataQuery, DataTopic, DataSourceRef, VariableRefresh, LoadingState, DashboardCursorSync, MatcherConfig, TableFieldOptions } from '@grafana/schema';
 import { PanelContext, WeekStart, IconName as IconName$1 } from '@grafana/ui';
 import { LocationService, VariableInterpolation, ScopesContextValue } from '@grafana/runtime';
 import { Location } from 'history';
@@ -315,118 +315,6 @@ declare class VariableDependencyConfig<TState extends SceneObjectState> implemen
     private handleTimeMacros;
 }
 
-interface LongFrameEvent {
-    duration: number;
-    timestamp: number;
-    method: 'manual' | 'loaf';
-}
-type LongFrameCallback = (event: LongFrameEvent) => void;
-
-interface QueryResultWithState {
-    state: LoadingState;
-}
-interface SceneQueryControllerEntry {
-    request?: DataQueryRequest;
-    type: SceneQueryControllerEntryType;
-    origin: SceneObject;
-    cancel?: () => void;
-}
-type SceneQueryControllerEntryType = 'data' | 'annotations' | 'variable' | 'alerts' | 'plugin' | string;
-
-
-
-interface SceneComponentInteractionEvent {
-    origin: string;
-    duration: number;
-    networkDuration: number;
-    startTs: number;
-    endTs: number;
-}
-interface SceneInteractionTrackerState extends SceneObjectState {
-    enableInteractionTracking?: boolean;
-    onInteractionComplete?(event: SceneComponentInteractionEvent): void;
-}
-interface SceneQueryStateControllerState extends SceneObjectState {
-    isRunning: boolean;
-    enableProfiling?: boolean;
-}
-interface SceneQueryControllerLike extends SceneObject<SceneQueryStateControllerState> {
-    isQueryController: true;
-    cancelAll(): void;
-    queryStarted(entry: SceneQueryControllerEntry): void;
-    queryCompleted(entry: SceneQueryControllerEntry): void;
-    startProfile(name: string): void;
-    cancelProfile(): void;
-    runningQueriesCount(): number;
-}
-
-interface QueryProfilerLike {
-    onQueryStarted(timestamp: number, entry: SceneQueryControllerEntry, queryId: string): ((endTimestamp: number, error?: any) => void) | null;
-}
-/**
- * Will look for a scene object with a behavior that is a SceneQueryController and register the query with it.
- * Optionally accepts a panel profiler for direct query tracking callbacks.
- */
-declare function registerQueryWithController<T extends QueryResultWithState>(entry: SceneQueryControllerEntry, profiler?: QueryProfilerLike): (queryStream: Observable<T>) => Observable<T>;
-
-interface VizPanelRenderProfilerState extends SceneObjectState {
-}
-/**
- * Tracks performance metrics for individual VizPanel instances using observer pattern.
- *
- * Performance events are sent to ScenePerformanceTracker observers, which are consumed
- * by Grafana's ScenePerformanceLogger and DashboardAnalyticsAggregator.
- */
-declare class VizPanelRenderProfiler extends SceneObjectBase<VizPanelRenderProfilerState> implements QueryProfilerLike {
-    private _panelKey?;
-    private _panelId?;
-    private _pluginId?;
-    private _pluginVersion?;
-    private _isTracking;
-    private _loadPluginStartTime?;
-    private _applyFieldConfigStartTime?;
-    private _activeQueries;
-    constructor(state?: Partial<VizPanelRenderProfilerState>);
-    private _onActivate;
-    private _handlePanelStateChange;
-    /**
-     * Track query execution with operation ID correlation
-     */
-    onQueryStarted(timestamp: number, entry: SceneQueryControllerEntry, queryId: string): ((endTimestamp: number, error?: any) => void) | null;
-    /**
-     * Track plugin loading with operation ID correlation
-     */
-    onPluginLoadStart(pluginId: string): ((plugin: any, fromCache?: boolean) => void) | null;
-    /**
-     * Track field config processing with operation ID correlation
-     */
-    onFieldConfigStart(timestamp: number): ((endTimestamp: number, dataPointsCount?: number, seriesCount?: number) => void) | null;
-    /**
-     * Get panel info for logging - truncates long titles for readability
-     */
-    private _getPanelInfo;
-    /**
-     * Track simple render timing with operation ID correlation
-     */
-    onSimpleRenderStart(timestamp: number): ((endTimestamp: number, duration: number) => void) | undefined;
-    /** Handle plugin changes */
-    private _onPluginChange;
-    /** Start tracking this panel */
-    private _startTracking;
-    /** Cleanup when behavior is deactivated */
-    private _cleanup;
-    /**
-     * Track data transformation with operation ID correlation
-     */
-    onDataTransformStart(timestamp: number, transformationId: string, metrics: {
-        transformationCount: number;
-        seriesTransformationCount: number;
-        annotationTransformationCount: number;
-    }): ((endTimestamp: number, duration: number, success: boolean, result?: {
-        error?: string;
-    }) => void) | null;
-}
-
 interface VizPanelState<TOptions = {}, TFieldConfig = {}> extends SceneObjectState {
     /**
      * This is usually a plugin id that references a core plugin or an external plugin. But this can also reference a
@@ -497,10 +385,6 @@ declare class VizPanel<TOptions = {}, TFieldConfig extends {} = {}> extends Scen
     private _dataWithFieldConfig?;
     private _structureRev;
     constructor(state: Partial<VizPanelState<TOptions, TFieldConfig>>);
-    /**
-     * Get the VizPanelRenderProfiler behavior if attached
-     */
-    getProfiler(): VizPanelRenderProfiler | undefined;
     private _onActivate;
     forceRender(): void;
     private _loadPlugin;
@@ -1240,6 +1124,7 @@ interface CustomVariableState extends MultiValueVariableState {
 declare class CustomVariable extends MultiValueVariable<CustomVariableState> {
     protected _variableDependency: VariableDependencyConfig<CustomVariableState>;
     constructor(initialState: Partial<CustomVariableState>);
+    transformCsvStringToOptions(str: string, interpolate?: boolean): VariableValueOption[];
     getValueOptions(args: VariableGetOptionsArgs): Observable<VariableValueOption[]>;
     static Component: ({ model }: SceneComponentProps<MultiValueVariable>) => React__default.JSX.Element;
 }
@@ -1401,6 +1286,30 @@ declare class GroupByVariable extends MultiValueVariable<GroupByVariableState> {
 }
 declare function GroupByVariableRenderer({ model }: SceneComponentProps<GroupByVariable>): React__default.JSX.Element;
 
+interface SwitchVariableState extends SceneVariableState {
+    value: string;
+    enabledValue: string;
+    disabledValue: string;
+}
+declare class SwitchVariable extends SceneObjectBase<SwitchVariableState> implements SceneVariable<SwitchVariableState> {
+    static Component: typeof SwitchVariableRenderer;
+    private _prevValue;
+    constructor(initialState: Partial<SwitchVariableState>);
+    /**
+     * This function is called on when SceneVariableSet is activated or when a dependency changes.
+     */
+    validateAndUpdate(): Observable<ValidateAndUpdateResult>;
+    setValue(newValue: string): void;
+    getValue(): VariableValue;
+    isEnabled(): boolean;
+    isDisabled(): boolean;
+    private getKey;
+    getKeys(): string[];
+    getUrlState(): SceneObjectUrlValues;
+    updateFromUrl(values: SceneObjectUrlValues): void;
+}
+declare function SwitchVariableRenderer({ model }: SceneComponentProps<SwitchVariable>): React__default.JSX.Element;
+
 declare function isAdHocVariable(variable: SceneVariable): variable is AdHocFiltersVariable;
 declare function isConstantVariable(variable: SceneVariable): variable is ConstantVariable;
 declare function isCustomVariable(variable: SceneVariable): variable is CustomVariable;
@@ -1409,6 +1318,7 @@ declare function isIntervalVariable(variable: SceneVariable): variable is Interv
 declare function isQueryVariable(variable: SceneVariable): variable is QueryVariable;
 declare function isTextBoxVariable(variable: SceneVariable): variable is TextBoxVariable;
 declare function isGroupByVariable(variable: SceneVariable): variable is GroupByVariable;
+declare function isSwitchVariable(variable: SceneVariable): variable is SwitchVariable;
 
 interface SceneObjectStateChangedPayload<TState extends SceneObjectState = SceneObjectState> {
     prevState: TState;
@@ -1433,6 +1343,65 @@ declare class UserActionEvent extends BusEventWithPayload<UserActionEventPayload
  */
 declare function lookupVariable(name: string, sceneObject: SceneObject): SceneVariable | null;
 
+interface LongFrameEvent {
+    duration: number;
+    timestamp: number;
+    method: 'manual' | 'loaf';
+}
+type LongFrameCallback = (event: LongFrameEvent) => void;
+
+interface QueryResultWithState {
+    state: LoadingState;
+}
+interface SceneQueryControllerEntry {
+    request?: DataQueryRequest;
+    type: SceneQueryControllerEntryType;
+    origin: SceneObject;
+    cancel?: () => void;
+}
+type SceneQueryControllerEntryType = 'data' | 'annotations' | 'variable' | 'alerts' | 'plugin' | string;
+
+
+
+interface SceneInteractionProfileEvent {
+    origin: string;
+    duration: number;
+    networkDuration: number;
+    jsHeapSizeLimit: number;
+    usedJSHeapSize: number;
+    totalJSHeapSize: number;
+    crumbs: string[];
+    startTs: number;
+    endTs: number;
+    longFramesCount: number;
+    longFramesTotalTime: number;
+}
+interface SceneComponentInteractionEvent {
+    origin: string;
+    duration: number;
+    networkDuration: number;
+    startTs: number;
+    endTs: number;
+}
+interface SceneInteractionTrackerState extends SceneObjectState {
+    enableInteractionTracking?: boolean;
+    onInteractionComplete?(event: SceneComponentInteractionEvent): void;
+}
+interface SceneQueryStateControllerState extends SceneObjectState {
+    isRunning: boolean;
+    enableProfiling?: boolean;
+    onProfileComplete?(event: SceneInteractionProfileEvent): void;
+}
+interface SceneQueryControllerLike extends SceneObject<SceneQueryStateControllerState> {
+    isQueryController: true;
+    cancelAll(): void;
+    queryStarted(entry: SceneQueryControllerEntry): void;
+    queryCompleted(entry: SceneQueryControllerEntry): void;
+    startProfile(name: string): void;
+    cancelProfile(): void;
+    runningQueriesCount(): number;
+}
+
 /**
  * Returns the closest query controller undefined if none found
  */
@@ -1612,10 +1581,6 @@ declare class PanelContextEventBus implements EventBus {
     newScopedBus(key: string, filter: EventFilterOptions): EventBus;
 }
 
-interface PanelProfilingConfig {
-    watchStateKey?: string;
-}
-
 /**
  * SceneRenderProfiler tracks dashboard interaction performance including:
  * - Total interaction duration
@@ -1635,17 +1600,9 @@ interface PanelProfilingConfig {
  */
 declare class SceneRenderProfiler {
     #private;
-    private metadata;
-    private _panelProfilingManager?;
     private queryController?;
-    constructor(panelProfilingConfig?: PanelProfilingConfig);
-    /** Set generic metadata for observer notifications */
-    setMetadata(metadata: Record<string, unknown>): void;
+    constructor(queryController?: SceneQueryControllerLike | undefined);
     setQueryController(queryController: SceneQueryControllerLike): void;
-    /** Attach panel profiling to a scene object */
-    attachPanelProfiling(sceneObject: SceneObject): void;
-    /** Attach profiler to a specific panel */
-    attachProfilerToPanel(panel: VizPanel): void;
     setInteractionCompleteHandler(handler?: (event: SceneComponentInteractionEvent) => void): void;
     private setupVisibilityChangeHandler;
     cleanup(): void;
@@ -1654,9 +1611,14 @@ declare class SceneRenderProfiler {
     stopInteraction(): void;
     getCurrentInteraction(): string | null;
     /**
-     * Start new performance profile
-     * @param name - Profile trigger (e.g., 'time_range_change')
-     * @param force - True if canceling existing profile, false if starting clean
+     * Starts a new profile for performance measurement.
+     *
+     * @param name - The origin/trigger of the profile (e.g., 'time_range_change', 'variable_value_changed')
+     * @param force - Whether this is a "forced" profile (true) or "clean" profile (false)
+     *               - "forced": Started by canceling an existing profile that was recording trailing frames
+     *                           This happens when a new user interaction occurs before the previous one
+     *                           finished measuring its performance impact
+     *               - "clean": Started when no profile is currently active
      */
     private _startNewProfile;
     private recordProfileTail;
@@ -1705,231 +1667,26 @@ declare class LiveNowTimer extends SceneObjectBase<LiveNowTimerState> {
     get isEnabled(): boolean;
 }
 
-/**
- * Centralized performance tracking system using observer pattern.
- * External systems (like Grafana) implement ScenePerformanceObserver to receive performance events.
- */
-declare function generateOperationId(prefix?: string): string;
-/** Base interface for all performance events */
-interface BasePerformanceEvent {
-    operationId: string;
-    timestamp: number;
-    duration?: number;
-    error?: string;
-}
-interface DashboardInteractionStartData extends BasePerformanceEvent {
-    interactionType: string;
-    metadata?: Record<string, unknown>;
-}
-interface DashboardInteractionMilestoneData extends BasePerformanceEvent {
-    interactionType: string;
-    milestone: string;
-    metadata?: Record<string, unknown>;
-}
-interface DashboardInteractionCompleteData extends BasePerformanceEvent {
-    interactionType: string;
-    networkDuration?: number;
-    longFramesCount: number;
-    longFramesTotalTime: number;
-    metadata?: Record<string, unknown>;
-}
-/** Metadata interface for transform operations */
-interface TransformMetadata {
-    transformationId: string;
-    transformationCount: number;
-    seriesTransformationCount: number;
-    annotationTransformationCount: number;
-    success?: boolean;
-    error?: string;
-}
-/** Metadata interface for query operations */
-interface QueryMetadata {
-    queryId: string;
-    queryType: string;
-}
-/** Metadata interface for render operations */
-interface RenderMetadata {
-}
-/** Metadata interface for plugin load operations */
-interface PluginLoadMetadata {
-    pluginId: string;
-    fromCache?: boolean;
-    pluginLoadTime?: number;
-}
-/** Metadata interface for field config operations */
-interface FieldConfigMetadata {
-}
-/** Base interface for panel performance events */
-interface BasePanelPerformanceData extends BasePerformanceEvent {
-    panelId: string;
-    panelKey: string;
-    pluginId: string;
-    pluginVersion?: string;
-    panelTitle?: string;
-}
-/** Transform operation performance data */
-interface PanelTransformPerformanceData extends BasePanelPerformanceData {
-    operation: 'transform';
-    metadata: TransformMetadata;
-}
-/** Query operation performance data */
-interface PanelQueryPerformanceData extends BasePanelPerformanceData {
-    operation: 'query';
-    metadata: QueryMetadata;
-}
-/** Render operation performance data */
-interface PanelRenderPerformanceData extends BasePanelPerformanceData {
-    operation: 'render';
-    metadata: RenderMetadata;
-}
-/** Plugin load operation performance data */
-interface PanelPluginLoadPerformanceData extends BasePanelPerformanceData {
-    operation: 'plugin-load';
-    metadata: PluginLoadMetadata;
-}
-/** Field config operation performance data */
-interface PanelFieldConfigPerformanceData extends BasePanelPerformanceData {
-    operation: 'fieldConfig';
-    metadata: FieldConfigMetadata;
-}
-/** Discriminated union of all panel performance data types */
-type PanelPerformanceData = PanelTransformPerformanceData | PanelQueryPerformanceData | PanelRenderPerformanceData | PanelPluginLoadPerformanceData | PanelFieldConfigPerformanceData;
-/** Non-panel query performance data for dashboard queries (annotations, variables, etc.) */
-interface QueryPerformanceData extends BasePerformanceEvent {
-    queryId: string;
-    queryType: string;
-    origin: string;
-}
-/**
- * Observer interface for performance monitoring
- * External systems implement this to receive performance notifications
- */
-interface ScenePerformanceObserver {
-    onDashboardInteractionStart?(data: DashboardInteractionStartData): void;
-    onDashboardInteractionMilestone?(data: DashboardInteractionMilestoneData): void;
-    onDashboardInteractionComplete?(data: DashboardInteractionCompleteData): void;
-    onPanelOperationStart?(data: PanelPerformanceData): void;
-    onPanelOperationComplete?(data: PanelPerformanceData): void;
-    onQueryStart?(data: QueryPerformanceData): void;
-    onQueryComplete?(data: QueryPerformanceData): void;
-}
-/**
- * Centralized performance tracker
- * Manages observers and provides methods for scene objects to report performance events
- */
-declare class ScenePerformanceTracker {
-    private static instance;
-    private observers;
-    static getInstance(): ScenePerformanceTracker;
-    /**
-     * Register a performance observer
-     */
-    addObserver(observer: ScenePerformanceObserver): () => void;
-    /**
-     * Remove all observers (for testing)
-     */
-    clearObservers(): void;
-    /**
-     * Get current observer count (for debugging)
-     */
-    getObserverCount(): number;
-    private notifyObservers;
-    notifyDashboardInteractionStart(data: DashboardInteractionStartData): void;
-    notifyDashboardInteractionMilestone(data: DashboardInteractionMilestoneData): void;
-    notifyDashboardInteractionComplete(data: DashboardInteractionCompleteData): void;
-    notifyPanelOperationStart(data: PanelPerformanceData): void;
-    notifyPanelOperationComplete(data: PanelPerformanceData): void;
-    notifyQueryStart(data: QueryPerformanceData): void;
-    notifyQueryComplete(data: QueryPerformanceData): void;
-}
-/**
- * Get the global performance tracker instance
- */
-declare function getScenePerformanceTracker(): ScenePerformanceTracker;
-
-/**
- * Constants for different types of dashboard interactions tracked by SceneRenderProfiler
- */
-declare const REFRESH_INTERACTION = "refresh";
-declare const TIME_RANGE_CHANGE_INTERACTION = "time_range_change";
-declare const FILTER_ADDED_INTERACTION = "filter_added";
-declare const FILTER_REMOVED_INTERACTION = "filter_removed";
-declare const FILTER_CHANGED_INTERACTION = "filter_changed";
-declare const FILTER_RESTORED_INTERACTION = "filter_restored";
-declare const VARIABLE_VALUE_CHANGED_INTERACTION = "variable_value_changed";
-declare const SCOPES_CHANGED_INTERACTION = "scopes_changed";
-declare const ADHOC_KEYS_DROPDOWN_INTERACTION = "adhoc_keys_dropdown";
-declare const ADHOC_VALUES_DROPDOWN_INTERACTION = "adhoc_values_dropdown";
-declare const GROUPBY_DIMENSIONS_INTERACTION = "groupby_dimensions";
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-declare const index$1_ADHOC_KEYS_DROPDOWN_INTERACTION: typeof ADHOC_KEYS_DROPDOWN_INTERACTION;
-declare const index$1_ADHOC_VALUES_DROPDOWN_INTERACTION: typeof ADHOC_VALUES_DROPDOWN_INTERACTION;
 type index$1_ActWhenVariableChanged = ActWhenVariableChanged;
 declare const index$1_ActWhenVariableChanged: typeof ActWhenVariableChanged;
-type index$1_BasePerformanceEvent = BasePerformanceEvent;
 type index$1_CursorSync = CursorSync;
 declare const index$1_CursorSync: typeof CursorSync;
-type index$1_DashboardInteractionCompleteData = DashboardInteractionCompleteData;
-type index$1_DashboardInteractionMilestoneData = DashboardInteractionMilestoneData;
-type index$1_DashboardInteractionStartData = DashboardInteractionStartData;
-declare const index$1_FILTER_ADDED_INTERACTION: typeof FILTER_ADDED_INTERACTION;
-declare const index$1_FILTER_CHANGED_INTERACTION: typeof FILTER_CHANGED_INTERACTION;
-declare const index$1_FILTER_REMOVED_INTERACTION: typeof FILTER_REMOVED_INTERACTION;
-declare const index$1_FILTER_RESTORED_INTERACTION: typeof FILTER_RESTORED_INTERACTION;
-type index$1_FieldConfigMetadata = FieldConfigMetadata;
-declare const index$1_GROUPBY_DIMENSIONS_INTERACTION: typeof GROUPBY_DIMENSIONS_INTERACTION;
 type index$1_LiveNowTimer = LiveNowTimer;
 declare const index$1_LiveNowTimer: typeof LiveNowTimer;
-type index$1_PanelFieldConfigPerformanceData = PanelFieldConfigPerformanceData;
-type index$1_PanelPerformanceData = PanelPerformanceData;
-type index$1_PanelPluginLoadPerformanceData = PanelPluginLoadPerformanceData;
-type index$1_PanelQueryPerformanceData = PanelQueryPerformanceData;
-type index$1_PanelRenderPerformanceData = PanelRenderPerformanceData;
-type index$1_PanelTransformPerformanceData = PanelTransformPerformanceData;
-type index$1_PluginLoadMetadata = PluginLoadMetadata;
-type index$1_QueryMetadata = QueryMetadata;
-type index$1_QueryPerformanceData = QueryPerformanceData;
-declare const index$1_REFRESH_INTERACTION: typeof REFRESH_INTERACTION;
-type index$1_RenderMetadata = RenderMetadata;
-declare const index$1_SCOPES_CHANGED_INTERACTION: typeof SCOPES_CHANGED_INTERACTION;
 type index$1_SceneInteractionTracker = SceneInteractionTracker;
 declare const index$1_SceneInteractionTracker: typeof SceneInteractionTracker;
-type index$1_ScenePerformanceObserver = ScenePerformanceObserver;
-type index$1_ScenePerformanceTracker = ScenePerformanceTracker;
-declare const index$1_ScenePerformanceTracker: typeof ScenePerformanceTracker;
 type index$1_SceneQueryController = SceneQueryController;
 declare const index$1_SceneQueryController: typeof SceneQueryController;
-declare const index$1_TIME_RANGE_CHANGE_INTERACTION: typeof TIME_RANGE_CHANGE_INTERACTION;
-type index$1_TransformMetadata = TransformMetadata;
-declare const index$1_VARIABLE_VALUE_CHANGED_INTERACTION: typeof VARIABLE_VALUE_CHANGED_INTERACTION;
-type index$1_VizPanelRenderProfiler = VizPanelRenderProfiler;
-declare const index$1_VizPanelRenderProfiler: typeof VizPanelRenderProfiler;
-declare const index$1_getScenePerformanceTracker: typeof getScenePerformanceTracker;
 declare namespace index$1 {
-  export { index$1_ADHOC_KEYS_DROPDOWN_INTERACTION as ADHOC_KEYS_DROPDOWN_INTERACTION, index$1_ADHOC_VALUES_DROPDOWN_INTERACTION as ADHOC_VALUES_DROPDOWN_INTERACTION, index$1_ActWhenVariableChanged as ActWhenVariableChanged, index$1_CursorSync as CursorSync, index$1_FILTER_ADDED_INTERACTION as FILTER_ADDED_INTERACTION, index$1_FILTER_CHANGED_INTERACTION as FILTER_CHANGED_INTERACTION, index$1_FILTER_REMOVED_INTERACTION as FILTER_REMOVED_INTERACTION, index$1_FILTER_RESTORED_INTERACTION as FILTER_RESTORED_INTERACTION, index$1_GROUPBY_DIMENSIONS_INTERACTION as GROUPBY_DIMENSIONS_INTERACTION, index$1_LiveNowTimer as LiveNowTimer, index$1_REFRESH_INTERACTION as REFRESH_INTERACTION, index$1_SCOPES_CHANGED_INTERACTION as SCOPES_CHANGED_INTERACTION, index$1_SceneInteractionTracker as SceneInteractionTracker, index$1_ScenePerformanceTracker as ScenePerformanceTracker, index$1_SceneQueryController as SceneQueryController, index$1_TIME_RANGE_CHANGE_INTERACTION as TIME_RANGE_CHANGE_INTERACTION, index$1_VARIABLE_VALUE_CHANGED_INTERACTION as VARIABLE_VALUE_CHANGED_INTERACTION, index$1_VizPanelRenderProfiler as VizPanelRenderProfiler, index$1_getScenePerformanceTracker as getScenePerformanceTracker };
-  export type { index$1_BasePerformanceEvent as BasePerformanceEvent, index$1_DashboardInteractionCompleteData as DashboardInteractionCompleteData, index$1_DashboardInteractionMilestoneData as DashboardInteractionMilestoneData, index$1_DashboardInteractionStartData as DashboardInteractionStartData, index$1_FieldConfigMetadata as FieldConfigMetadata, index$1_PanelFieldConfigPerformanceData as PanelFieldConfigPerformanceData, index$1_PanelPerformanceData as PanelPerformanceData, index$1_PanelPluginLoadPerformanceData as PanelPluginLoadPerformanceData, index$1_PanelQueryPerformanceData as PanelQueryPerformanceData, index$1_PanelRenderPerformanceData as PanelRenderPerformanceData, index$1_PanelTransformPerformanceData as PanelTransformPerformanceData, index$1_PluginLoadMetadata as PluginLoadMetadata, index$1_QueryMetadata as QueryMetadata, index$1_QueryPerformanceData as QueryPerformanceData, index$1_RenderMetadata as RenderMetadata, index$1_ScenePerformanceObserver as ScenePerformanceObserver, index$1_TransformMetadata as TransformMetadata };
+  export {
+    index$1_ActWhenVariableChanged as ActWhenVariableChanged,
+    index$1_CursorSync as CursorSync,
+    index$1_LiveNowTimer as LiveNowTimer,
+    index$1_SceneInteractionTracker as SceneInteractionTracker,
+    index$1_SceneQueryController as SceneQueryController,
+  };
 }
 
-declare function writePerformanceLog(logger: string, message: string, ...rest: unknown[]): void;
-
 /**
  * Base class for data layer. Handles common implementation including enabling/disabling layer and publishing results.
  */
@@ -2255,10 +2012,6 @@ declare class SceneDataTransformer extends SceneObjectBase<SceneDataTransformerS
     setContainerWidth(width: number): void;
     isDataReadyToDisplay(): boolean;
     reprocessTransformations(): void;
-    /**
-     * S3.1: Calculate transformation complexity metrics
-     */
-    private _calculateTransformationMetrics;
     cancelQuery(): void;
     getResultsStream(): ReplaySubject<SceneDataProviderResult>;
     clone(withState?: Partial<SceneDataTransformerState>): this;
@@ -2269,6 +2022,11 @@ declare class SceneDataTransformer extends SceneObjectBase<SceneDataTransformerS
     private _interpolateVariablesInTransformationConfigs;
 }
 
+/**
+ * Will look for a scene object with a behavior that is a SceneQueryController and register the query with it.
+ */
+declare function registerQueryWithController<T extends QueryResultWithState>(entry: SceneQueryControllerEntry): (queryStream: Observable<T>) => Observable<T>;
+
 interface VariableValueSelectorsState extends SceneObjectState {
     layout?: ControlsLayout;
 }
@@ -2456,6 +2214,121 @@ declare class LocalValueVariable extends SceneObjectBase<LocalValueVariableState
     isAncestorLoading(): boolean;
 }
 
+/**
+ * Controller state returned by useState hook
+ */
+interface AdHocFiltersControllerState {
+    filters: AdHocFilterWithLabels[];
+    originFilters?: AdHocFilterWithLabels[];
+    readOnly?: boolean;
+    allowCustomValue?: boolean;
+    supportsMultiValueOperators?: boolean;
+    onAddCustomValue?: OnAddCustomValueFn;
+    wip?: AdHocFilterWithLabels;
+    inputPlaceholder?: string;
+}
+/**
+ * Controller interface for adhoc filters combobox UI.
+ * Decouples the UI from AdHocFiltersVariable, allowing usage with or without a variable.
+ */
+interface AdHocFiltersController {
+    /**
+     * React hook to access controller state.
+     * Components should call this to get current filters and configuration.
+     */
+    useState(): AdHocFiltersControllerState;
+    /**
+     * Get possible keys given current filters.
+     * @param currentKey - The key being edited (to exclude from filter context)
+     */
+    getKeys(currentKey: string | null): Promise<Array<SelectableValue<string>>>;
+    /**
+     * Get possible values for a specific filter key.
+     * @param filter - The filter to get values for
+     */
+    getValuesFor(filter: AdHocFilterWithLabels): Promise<Array<SelectableValue<string>>>;
+    /**
+     * Get available operators based on configuration.
+     */
+    getOperators(): Array<SelectableValue<string>>;
+    /**
+     * Update a filter with partial changes.
+     * @param filter - The filter to update
+     * @param update - Partial filter properties to update
+     */
+    updateFilter(filter: AdHocFilterWithLabels, update: Partial<AdHocFilterWithLabels>): void;
+    /**
+     * Update a filter to match all values (=~ .*)
+     * @param filter - The filter to update
+     */
+    updateToMatchAll(filter: AdHocFilterWithLabels): void;
+    /**
+     * Remove a filter.
+     * @param filter - The filter to remove
+     */
+    removeFilter(filter: AdHocFilterWithLabels): void;
+    /**
+     * Remove the last filter in the list.
+     */
+    removeLastFilter(): void;
+    /**
+     * Handle backspace key in combobox (removes filter or navigates to previous).
+     * @param filter - The filter where backspace was pressed
+     */
+    handleComboboxBackspace(filter: AdHocFilterWithLabels): void;
+    /**
+     * Add a new work-in-progress filter.
+     */
+    addWip(): void;
+    /**
+     * Restore an origin filter to its original value.
+     * @param filter - The filter to restore
+     */
+    restoreOriginalFilter(filter: AdHocFilterWithLabels): void;
+    /**
+     * Optional: Start profiling an interaction (for performance tracking).
+     * @param name - The interaction name
+     */
+    startProfile?(name: string): void;
+    /**
+     * Optional: Start tracking an interaction (for analytics).
+     * @param name - The interaction name
+     */
+    startInteraction?(name: string): void;
+    /**
+     * Optional: Stop tracking the current interaction.
+     */
+    stopInteraction?(): void;
+}
+
+/**
+ * Adapter that wraps AdHocFiltersVariable to implement the AdHocFiltersController interface.
+ * This allows the combobox UI to work with the variable while keeping the UI decoupled.
+ */
+declare class VariableBackedAdHocFiltersController implements AdHocFiltersController {
+    private model;
+    constructor(model: AdHocFiltersVariable);
+    useState(): AdHocFiltersControllerState;
+    getKeys(currentKey: string | null): Promise<Array<SelectableValue<string>>>;
+    getValuesFor(filter: AdHocFilterWithLabels): Promise<Array<SelectableValue<string>>>;
+    getOperators(): Array<SelectableValue<string>>;
+    updateFilter(filter: AdHocFilterWithLabels, update: Partial<AdHocFilterWithLabels>): void;
+    updateToMatchAll(filter: AdHocFilterWithLabels): void;
+    removeFilter(filter: AdHocFilterWithLabels): void;
+    removeLastFilter(): void;
+    handleComboboxBackspace(filter: AdHocFilterWithLabels): void;
+    addWip(): void;
+    restoreOriginalFilter(filter: AdHocFilterWithLabels): void;
+    startProfile(name: string): void;
+    startInteraction(name: string): void;
+    stopInteraction(): void;
+}
+
+interface Props$2 {
+    controller: AdHocFiltersController;
+}
+declare const AdHocFiltersComboboxRenderer: React__default.NamedExoticComponent<Props$2>;
+
 declare function useUrlSync(sceneRoot: SceneObject, options?: SceneUrlSyncOptions): boolean;
 
 interface UrlSyncContextProviderProps extends SceneUrlSyncOptions {
@@ -3439,20 +3312,6 @@ declare const loadResources: ResourceLoader;
 
 
 
-
-
-
-
-
-
-
-
-
-
-
-
-
-
 
 
 
@@ -3485,9 +3344,10 @@ declare const sceneUtils: {
     isQueryVariable: typeof isQueryVariable;
     isTextBoxVariable: typeof isTextBoxVariable;
     isGroupByVariable: typeof isGroupByVariable;
+    isSwitchVariable: typeof isSwitchVariable;
     isRepeatCloneOrChildOf: typeof isRepeatCloneOrChildOf;
     buildPathIdFor: typeof buildPathIdFor;
 };
 
-export { ADHOC_KEYS_DROPDOWN_INTERACTION, ADHOC_VALUES_DROPDOWN_INTERACTION, AdHocFiltersVariable, ConstantVariable, ControlsLabel, CustomVariable, DataProviderProxy, DataSourceVariable, EmbeddedScene, FILTER_ADDED_INTERACTION, FILTER_CHANGED_INTERACTION, FILTER_REMOVED_INTERACTION, FILTER_RESTORED_INTERACTION, FieldConfigBuilder, FieldConfigBuilders, FieldConfigOverridesBuilder, GROUPBY_DIMENSIONS_INTERACTION, GroupByVariable, IntervalVariable, LazyLoader, LocalValueVariable, MultiOrSingleValueSelect, MultiValueVariable, NestedScene, NewSceneObjectAddedEvent, PATH_ID_SEPARATOR, PanelBuilders, PanelOptionsBuilders, QueryVariable, REFRESH_INTERACTION, RuntimeDataSource, SCOPES_CHANGED_INTERACTION, SafeSerializableSceneObject, SceneApp, SceneAppPage, SceneByFrameRepeater, SceneByVariableRepeater, SceneCSSGridItem, SceneCSSGridLayout, SceneCanvasText, SceneControlsSpacer, SceneDataLayerBase, SceneDataLayerControls, SceneDataLayerSet, SceneDataLayerSetBase, SceneDataNode, SceneDataTransformer, SceneDebugger, SceneFlexItem, SceneFlexLayout, SceneGridItem, SceneGridLayout, SceneGridLayoutDragStartEvent, SceneGridRow, SceneObjectBase, SceneObjectRef, SceneObjectStateChangedEvent, SceneObjectUrlSyncConfig, SceneQueryRunner, SceneReactObject, SceneRefreshPicker, SceneRenderProfiler, SceneTimePicker, SceneTimeRange, SceneTimeRangeCompare, SceneTimeRangeTransformerBase, SceneTimeZoneOverride, SceneToolbarButton, SceneToolbarInput, SceneVariableSet, SceneVariableValueChangedEvent, ScopesVariable, SplitLayout, TIME_RANGE_CHANGE_INTERACTION, TestVariable, TextBoxVariable, UrlSyncContextProvider, UrlSyncManager, UserActionEvent, VARIABLE_VALUE_CHANGED_INTERACTION, VariableDependencyConfig, VariableValueControl, VariableValueSelectWrapper, VariableValueSelectors, VizConfigBuilder, VizConfigBuilders, VizPanel, VizPanelBuilder, VizPanelExploreButton, VizPanelMenu, index$1 as behaviors, index as dataLayers, escapeUrlPipeDelimiters, formatRegistry, generateOperationId, getExploreURL, getScenePerformanceTracker, isCustomVariableValue, isDataLayer, isDataRequestEnricher, isFiltersRequestEnricher, isSceneObject, loadResources, registerQueryWithController, registerRuntimeDataSource, sceneGraph, sceneUtils, useSceneApp, useSceneObjectState, useUrlSync, writePerformanceLog };
-export type { AdHocFilterWithLabels, BasePerformanceEvent, CancelActivationHandler, ControlsLayout, CustomFormatterVariable, CustomTransformOperator, CustomTransformerDefinition, CustomVariableValue, DashboardInteractionCompleteData, DashboardInteractionMilestoneData, DashboardInteractionStartData, DataLayerFilter, DataRequestEnricher, DeepPartial, EmbeddedSceneState, ExtraQueryDataProcessor, ExtraQueryDescriptor, ExtraQueryProvider, FieldConfigMetadata, FiltersRequestEnricher, FormatVariable, InterpolationFormatParameter, MacroVariableConstructor, MultiValueVariableState, PanelFieldConfigPerformanceData, PanelPerformanceData, PanelPluginLoadPerformanceData, PanelQueryPerformanceData, PanelRenderPerformanceData, PanelTransformPerformanceData, PluginLoadMetadata, QueryMetadata, QueryPerformanceData, QueryRunnerState, RenderMetadata, SceneActivationHandler, SceneAppDrilldownView, SceneAppPageLike, SceneAppPageState, SceneAppRoute, SceneComponent, SceneComponentProps, SceneDataLayerProvider, SceneDataLayerProviderState, SceneDataProvider, SceneDataProviderResult, SceneDataQuery, SceneDataState, SceneDataTransformerState, SceneDeactivationHandler, SceneFlexItemLike, SceneFlexItemState, SceneGridItemLike, SceneGridItemStateLike, SceneLayout, SceneLayoutChildOptions, SceneLayoutState, SceneObject, SceneObjectState, SceneObjectStateChangedPayload, SceneObjectUrlSyncHandler, SceneObjectUrlValue, SceneObjectUrlValues, SceneObjectWithUrlSync, ScenePerformanceObserver, SceneQueryControllerEntry, SceneQueryControllerEntryType, SceneQueryControllerLike, SceneRefreshPickerState, SceneRouteMatch, SceneStateChangedHandler, SceneStatelessBehavior, SceneTimeRangeLike, SceneTimeRangeState, SceneUrlSyncOptions, SceneVariable, SceneVariableDependencyConfigLike, SceneVariableSetState, SceneVariableState, SceneVariables, TransformMetadata, UrlSyncManagerLike, UseStateHookOptions, ValidateAndUpdateResult, VariableCustomFormatterFn, VariableGetOptionsArgs, VariableValue, VariableValueOption, VariableValueSingle, VizConfig, VizPanelState };
+export { AdHocFiltersComboboxRenderer, AdHocFiltersVariable, ConstantVariable, ControlsLabel, CustomVariable, DataProviderProxy, DataSourceVariable, EmbeddedScene, FieldConfigBuilder, FieldConfigBuilders, FieldConfigOverridesBuilder, GroupByVariable, IntervalVariable, LazyLoader, LocalValueVariable, MultiOrSingleValueSelect, MultiValueVariable, NestedScene, NewSceneObjectAddedEvent, PATH_ID_SEPARATOR, PanelBuilders, PanelOptionsBuilders, QueryVariable, RuntimeDataSource, SafeSerializableSceneObject, SceneApp, SceneAppPage, SceneByFrameRepeater, SceneByVariableRepeater, SceneCSSGridItem, SceneCSSGridLayout, SceneCanvasText, SceneControlsSpacer, SceneDataLayerBase, SceneDataLayerControls, SceneDataLayerSet, SceneDataLayerSetBase, SceneDataNode, SceneDataTransformer, SceneDebugger, SceneFlexItem, SceneFlexLayout, SceneGridItem, SceneGridLayout, SceneGridLayoutDragStartEvent, SceneGridRow, SceneObjectBase, SceneObjectRef, SceneObjectStateChangedEvent, SceneObjectUrlSyncConfig, SceneQueryRunner, SceneReactObject, SceneRefreshPicker, SceneRenderProfiler, SceneTimePicker, SceneTimeRange, SceneTimeRangeCompare, SceneTimeRangeTransformerBase, SceneTimeZoneOverride, SceneToolbarButton, SceneToolbarInput, SceneVariableSet, SceneVariableValueChangedEvent, ScopesVariable, SplitLayout, SwitchVariable, TestVariable, TextBoxVariable, UrlSyncContextProvider, UrlSyncManager, UserActionEvent, VariableBackedAdHocFiltersController, VariableDependencyConfig, VariableValueControl, VariableValueSelectWrapper, VariableValueSelectors, VizConfigBuilder, VizConfigBuilders, VizPanel, VizPanelBuilder, VizPanelExploreButton, VizPanelMenu, index$1 as behaviors, index as dataLayers, escapeUrlPipeDelimiters, formatRegistry, getExploreURL, isCustomVariableValue, isDataLayer, isDataRequestEnricher, isFiltersRequestEnricher, isSceneObject, loadResources, registerQueryWithController, registerRuntimeDataSource, sceneGraph, sceneUtils, useSceneApp, useSceneObjectState, useUrlSync };
+export type { AdHocFilterWithLabels, AdHocFiltersController, AdHocFiltersControllerState, CancelActivationHandler, ControlsLayout, CustomFormatterVariable, CustomTransformOperator, CustomTransformerDefinition, CustomVariableValue, DataLayerFilter, DataRequestEnricher, DeepPartial, EmbeddedSceneState, ExtraQueryDataProcessor, ExtraQueryDescriptor, ExtraQueryProvider, FiltersRequestEnricher, FormatVariable, InterpolationFormatParameter, MacroVariableConstructor, MultiValueVariableState, QueryRunnerState, SceneActivationHandler, SceneAppDrilldownView, SceneAppPageLike, SceneAppPageState, SceneAppRoute, SceneComponent, SceneComponentProps, SceneDataLayerProvider, SceneDataLayerProviderState, SceneDataProvider, SceneDataProviderResult, SceneDataQuery, SceneDataState, SceneDataTransformerState, SceneDeactivationHandler, SceneFlexItemLike, SceneFlexItemState, SceneGridItemLike, SceneGridItemStateLike, SceneInteractionProfileEvent, SceneLayout, SceneLayoutChildOptions, SceneLayoutState, SceneObject, SceneObjectState, SceneObjectStateChangedPayload, SceneObjectUrlSyncHandler, SceneObjectUrlValue, SceneObjectUrlValues, SceneObjectWithUrlSync, SceneQueryControllerEntry, SceneQueryControllerEntryType, SceneQueryControllerLike, SceneRefreshPickerState, SceneRouteMatch, SceneStateChangedHandler, SceneStatelessBehavior, SceneTimeRangeLike, SceneTimeRangeState, SceneUrlSyncOptions, SceneVariable, SceneVariableDependencyConfigLike, SceneVariableSetState, SceneVariableState, SceneVariables, UrlSyncManagerLike, UseStateHookOptions, ValidateAndUpdateResult, VariableCustomFormatterFn, VariableGetOptionsArgs, VariableValue, VariableValueOption, VariableValueSingle, VizConfig, VizPanelState };