@grafana/scenes 6.12.0--canary.1121.15045230319.0 → 6.12.0--canary.1122.15063334499.0

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import * as _grafana_data from '@grafana/data';
-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, GetTagResponse, MetricFindValue, SelectableValue, VariableRefresh as VariableRefresh$1, VariableSort, Scope, EventFilterOptions, AnnotationEvent, AnnotationQuery, DataTransformerConfig, TimeOption, FieldConfig, FieldType, FieldValueMatcherConfig, ScopedVar, RawTimeRange } from '@grafana/data';
+import { BusEventWithPayload, EventBus, BusEvent, BusEventType, BusEventHandler, PanelMenuItem, FieldConfigSource, PanelPlugin, AbsoluteTimeRange, PanelData, InterpolateFunction, PanelModel, TimeRange, DataTransformContext, DataFrame, DataQueryRequest, DataSourceGetTagKeysOptions, DataSourceGetTagValuesOptions, Scope, IconName, PageLayoutType, UrlQueryMap, DataQuery as DataQuery$1, DataSourceApi, Registry, RegistryItem, ScopedVars, AdHocVariableFilter, GetTagResponse, MetricFindValue, SelectableValue, VariableRefresh as VariableRefresh$1, VariableSort, EventFilterOptions, AnnotationEvent, AnnotationQuery, DataTransformerConfig, TimeOption, FieldConfig, FieldType, FieldValueMatcherConfig, ScopedVar, RawTimeRange } from '@grafana/data';
 import * as React$1 from 'react';
-import React__default, { ComponentType, ReactNode, CSSProperties, PointerEvent, ForwardRefExoticComponent } 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 { ScopesContextValue, LocationService, VariableInterpolation } from '@grafana/runtime';
 import { Location } from 'history';
 import ReactGridLayout from 'react-grid-layout';
 import { Options, FieldConfig as FieldConfig$1 } from '@grafana/schema/dist/esm/raw/composable/barchart/panelcfg/x/BarChartPanelCfg_types.gen';
@@ -63,10 +63,6 @@ interface SceneVariable<TState extends SceneVariableState = SceneVariableState>
      * Allows cancelling variable execution.
      */
     onCancel?(): void;
-    /**
-     * Edge case for variables that is hidden but wants to be render to access react contexts (ScopesVariable)
-     */
-    hiddenRender?(): React.ReactNode;
     /**
      * @experimental
      * Indicates that a variable loads values lazily when user interacts with the variable dropdown.
@@ -279,10 +275,6 @@ interface VariableDependencyConfigOptions<TState extends SceneObjectState> {
      * Handle time macros.
      */
     handleTimeMacros?: boolean;
-    /**
-     * Depends on scopes
-     */
-    dependsOnScopes?: boolean;
 }
 declare class VariableDependencyConfig<TState extends SceneObjectState> implements SceneVariableDependencyConfigLike {
     private _sceneObject;
@@ -374,7 +366,7 @@ interface VizPanelState<TOptions = {}, TFieldConfig = {}> extends SceneObjectSta
 }
 declare class VizPanel<TOptions = {}, TFieldConfig extends {} = {}> extends SceneObjectBase<VizPanelState<TOptions, TFieldConfig>> {
     static Component: typeof VizPanelRenderer;
-    protected _variableDependency: VariableDependencyConfig<VizPanelState<TOptions, TFieldConfig>>;
+    protected _variableDependency: VariableDependencyConfig<VizPanelState<{}, {}>>;
     protected _panelContext?: PanelContext;
     private _plugin?;
     private _prevData?;
@@ -414,7 +406,7 @@ declare class VizPanel<TOptions = {}, TFieldConfig extends {} = {}> extends Scen
     private _onSeriesVisibilityChange;
     private _onInstanceStateChange;
     private _onToggleLegendSort;
-    clone(): this;
+    clone(withState?: Partial<VizPanelState>): this;
     private buildPanelContext;
 }
 
@@ -659,6 +651,36 @@ declare class EmbeddedScene extends SceneObjectBase<EmbeddedSceneState> {
 }
 declare function EmbeddedSceneRenderer({ model }: SceneComponentProps<EmbeddedScene>): React__default.JSX.Element;
 
+declare class SceneScopesBridge extends SceneObjectBase {
+    static Component: typeof SceneScopesBridgeRenderer;
+    protected _renderBeforeActivation: boolean;
+    private _contextSubject;
+    getValue(): Scope[];
+    /**
+     * Emits values of the selected scopes array. It emits the current value and the previous value if there is a change.
+     * @param cb
+     */
+    subscribeToValue(cb: (newScopes: Scope[], prevScopes: Scope[]) => void): Unsubscribable;
+    isLoading(): boolean;
+    subscribeToLoading(cb: (loading: boolean) => void): Unsubscribable;
+    setEnabled(enabled: boolean): void;
+    setReadOnly(readOnly: boolean): void;
+    /**
+     * This method is used to keep the context up to date with the scopes context received from React
+     *
+     * Its rationale is:
+     *   - When a new context is available, check if we have pending scopes passed from the URL
+     *      - If we have pending scopes, ask the new context to load them
+     *      - The loading should happen in a setTimeout to allow the existing context to pass its values to the URL sync handler
+     *   - If a new context is received, propagate it as a new value in the behavior subject
+     *   - If a new value is received, force a re-render to trigger the URL sync handler
+     */
+    updateContext(newContext: ScopesContextValue | undefined): void;
+    private get context();
+    private get contextObservable();
+}
+declare function SceneScopesBridgeRenderer({ model }: SceneComponentProps<SceneScopesBridge>): null;
+
 interface SceneRouteMatch<Params extends {
     [K in keyof Params]?: string;
 } = {}> {
@@ -671,6 +693,7 @@ interface SceneAppState extends SceneObjectState {
     pages: SceneAppPageLike[];
     name?: string;
     urlSyncOptions?: SceneUrlSyncOptions;
+    scopesBridge?: SceneScopesBridge;
 }
 interface SceneAppRoute {
     path: string;
@@ -715,6 +738,7 @@ interface SceneAppPageState extends SceneObjectState {
      */
     getFallbackPage?: () => SceneAppPageLike;
     layout?: PageLayoutType;
+    useScopes?: boolean;
 }
 interface SceneAppPageLike extends SceneObject<SceneAppPageState>, DataRequestEnricher {
     initializeScene(scene: SceneObject): void;
@@ -942,9 +966,8 @@ declare class AdHocFiltersVariable extends SceneObjectBase<AdHocFiltersVariableS
     static Component: typeof AdHocFiltersVariableRenderer;
     private _scopedVars;
     private _dataSourceSrv;
+    private _scopesBridge;
     private _originalValues;
-    /** Needed for scopes dependency */
-    protected _variableDependency: VariableDependencyConfig<AdHocFiltersVariableState>;
     protected _urlSync: AdHocFiltersVariableUrlSyncHandler;
     constructor(state: Partial<AdHocFiltersVariableState>);
     private _activationHandler;
@@ -1165,6 +1188,10 @@ interface GroupByVariableState extends MultiValueVariableState {
     baseFilters?: AdHocVariableFilter[];
     /** Datasource to use for getTagKeys and also controls which scene queries the group by should apply to */
     datasource: DataSourceRef | null;
+    defaultValues?: {
+        text: VariableValue;
+        value: VariableValue;
+    };
     /** Controls if the group by can be changed */
     readOnly?: boolean;
     /**
@@ -1197,10 +1224,14 @@ declare class GroupByVariable extends MultiValueVariable<GroupByVariableState> {
     static Component: typeof GroupByVariableRenderer;
     isLazy: boolean;
     protected _urlSync: SceneObjectUrlSyncHandler;
+    private _scopesBridge;
     validateAndUpdate(): Observable<ValidateAndUpdateResult>;
     private _updateValueGivenNewOptions;
     getValueOptions(args: VariableGetOptionsArgs): Observable<VariableValueOption[]>;
     constructor(initialState: Partial<GroupByVariableState>);
+    private _activationHandler;
+    checkIfRestorable(values: VariableValue): boolean;
+    restoreDefaultValues(): void;
     /**
      * Get possible keys given current filters. Do not call from plugins directly
      */
@@ -1393,9 +1424,9 @@ declare function getAncestor<ParentType>(sceneObject: SceneObject, ancestorType:
  */
 declare function findDescendents<T extends SceneObject>(scene: SceneObject, descendentType: SceneType<T>): T[];
 /**
- * Will return the scopes from the scopes variable if available.
+ * Will walk up the scene object graph to the closest $scopesBridge scene object
  */
-declare function getScopes(sceneObject: SceneObject): Scope[] | undefined;
+declare function getScopesBridge(sceneObject: SceneObject): SceneScopesBridge | undefined;
 
 declare const sceneGraph: {
     getVariables: typeof getVariables;
@@ -1413,7 +1444,7 @@ declare const sceneGraph: {
     getAncestor: typeof getAncestor;
     getQueryController: typeof getQueryController;
     findDescendents: typeof findDescendents;
-    getScopes: typeof getScopes;
+    getScopesBridge: typeof getScopesBridge;
 };
 
 interface ActWhenVariableChangedState extends SceneObjectState {
@@ -1680,6 +1711,8 @@ declare class SceneQueryRunner extends SceneObjectBase<QueryRunnerState> impleme
     private _dataLayersMerger;
     private _timeSub?;
     private _timeSubRange?;
+    private _scopesSub?;
+    private _scopesSubBridge?;
     private _containerWidth?;
     private _variableValueRecorder;
     private _results;
@@ -1718,11 +1751,12 @@ declare class SceneQueryRunner extends SceneObjectBase<QueryRunnerState> impleme
     private _onDeactivate;
     setContainerWidth(width: number): void;
     isDataReadyToDisplay(): boolean;
+    private subscribeToScopesChanges;
     private subscribeToTimeRangeChanges;
     runQueries(): void;
     private getMaxDataPoints;
     cancelQuery(): void;
-    private runWithTimeRange;
+    private runWithTimeRangeAndScopes;
     clone(withState?: Partial<QueryRunnerState>): this;
     private prepareRequests;
     private onDataReceived;
@@ -1857,7 +1891,7 @@ interface VariableSelectProps {
     /** To provide an option to hide the label in the variable value selector */
     hideLabel?: boolean;
 }
-declare function VariableValueSelectWrapper({ variable, layout, showAlways, hideLabel }: VariableSelectProps): string | number | boolean | React__default.JSX.Element | Iterable<React__default.ReactNode> | null | undefined;
+declare function VariableValueSelectWrapper({ variable, layout, showAlways, hideLabel }: VariableSelectProps): React__default.JSX.Element | null;
 
 interface VariableValueControlState extends SceneObjectState {
     layout?: ControlsLayout;
@@ -1872,6 +1906,8 @@ declare class VariableValueControl extends SceneObjectBase<VariableValueControlS
 declare function VariableValueControlRenderer({ model }: SceneComponentProps<VariableValueControl>): React__default.JSX.Element | null;
 
 declare class SceneVariableSet extends SceneObjectBase<SceneVariableSetState> implements SceneVariables {
+    /** Variables that have changed in since the activation or since the first manual value change */
+    private _variablesThatHaveChanged;
     /** Variables that are scheduled to be validated and updated */
     private _variablesToUpdate;
     /** Variables currently updating  */
@@ -1974,41 +2010,6 @@ declare class TestVariable extends MultiValueVariable<TestVariableState> {
     static Component: ({ model }: SceneComponentProps<MultiValueVariable>) => React__default.JSX.Element;
 }
 
-interface ScopesVariableState extends SceneVariableState {
-    /**
-     * Last captured state from ScopesContext
-     */
-    scopes: Scope[];
-    /**
-     * Set to true if you want to the variable to enable / disable scopes when activated / deactivated
-     */
-    enable?: boolean;
-}
-declare class ScopesVariable extends SceneObjectBase<ScopesVariableState> implements SceneVariable<ScopesVariableState> {
-    protected _renderBeforeActivation: boolean;
-    protected _context: ScopesContextValue | undefined;
-    constructor(state: Partial<ScopesVariableState>);
-    /**
-     * Temporary simple implementation to stringify the scopes.
-     */
-    getValue(fieldPath: string): VariableValue;
-    getScopes(): Scope[] | undefined;
-    /**
-     * This method is used to keep the context up to date with the scopes context received from React
-     * 1) Subscribes to ScopesContext state changes and synchronizes it with the variable state
-     * 2) Handles enable / disabling of scopes based on variable enable option.
-     */
-    setContext(context: ScopesContextValue | undefined): (() => void) | undefined;
-    updateStateFromContext(state: {
-        loading: boolean;
-        value: Scope[];
-    }): void;
-    /**
-     * Special function that enables variables to be hidden but still render to access react contexts
-     */
-    hiddenRender(): ReactNode;
-}
-
 interface LocalValueVariableState extends SceneVariableState {
     value: VariableValue;
     text: VariableValue;
@@ -2498,6 +2499,9 @@ declare class SceneAppPage extends SceneObjectBase<SceneAppPageState> implements
     static Component: typeof SceneAppPageRenderer;
     private _sceneCache;
     private _drilldownCache;
+    private _scopesBridge;
+    constructor(state: SceneAppPageState);
+    private _activationHandler;
     initializeScene(scene: EmbeddedScene): void;
     getScene(routeMatch: SceneRouteMatch): EmbeddedScene;
     getDrilldownPage(drilldown: SceneAppDrilldownView, routeMatch: SceneRouteMatch<{}>): SceneAppPageLike;
@@ -3032,5 +3036,5 @@ declare const sceneUtils: {
     isGroupByVariable: typeof isGroupByVariable;
 };
 
-export { AdHocFiltersVariable, ConstantVariable, ControlsLabel, CustomVariable, DataProviderProxy, DataSourceVariable, EmbeddedScene, FieldConfigBuilder, FieldConfigBuilders, FieldConfigOverridesBuilder, GroupByVariable, IntervalVariable, LazyLoader, LocalValueVariable, MultiOrSingleValueSelect, MultiValueVariable, NestedScene, NewSceneObjectAddedEvent, 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, SceneTimePicker, SceneTimeRange, SceneTimeRangeCompare, SceneTimeRangeTransformerBase, SceneTimeZoneOverride, SceneToolbarButton, SceneToolbarInput, SceneVariableSet, SceneVariableValueChangedEvent, ScopesVariable, SplitLayout, TestVariable, TextBoxVariable, UrlSyncContextProvider, UrlSyncManager, UserActionEvent, VariableDependencyConfig, VariableValueControl, VariableValueSelectWrapper, VariableValueSelectors, VizConfigBuilder, VizConfigBuilders, VizPanel, VizPanelBuilder, VizPanelExploreButton, VizPanelMenu, index$1 as behaviors, index as dataLayers, formatRegistry, getExploreURL, isCustomVariableValue, isDataLayer, isDataRequestEnricher, isFiltersRequestEnricher, isSceneObject, registerQueryWithController, registerRuntimeDataSource, sceneGraph, sceneUtils, useSceneApp, useSceneObjectState, useUrlSync };
+export { AdHocFiltersVariable, ConstantVariable, ControlsLabel, CustomVariable, DataProviderProxy, DataSourceVariable, EmbeddedScene, FieldConfigBuilder, FieldConfigBuilders, FieldConfigOverridesBuilder, GroupByVariable, IntervalVariable, LazyLoader, LocalValueVariable, MultiOrSingleValueSelect, MultiValueVariable, NestedScene, NewSceneObjectAddedEvent, 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, SceneScopesBridge, SceneTimePicker, SceneTimeRange, SceneTimeRangeCompare, SceneTimeRangeTransformerBase, SceneTimeZoneOverride, SceneToolbarButton, SceneToolbarInput, SceneVariableSet, SceneVariableValueChangedEvent, SplitLayout, TestVariable, TextBoxVariable, UrlSyncContextProvider, UrlSyncManager, UserActionEvent, VariableDependencyConfig, VariableValueControl, VariableValueSelectWrapper, VariableValueSelectors, VizConfigBuilder, VizConfigBuilders, VizPanel, VizPanelBuilder, VizPanelExploreButton, VizPanelMenu, index$1 as behaviors, index as dataLayers, formatRegistry, getExploreURL, isCustomVariableValue, isDataLayer, isDataRequestEnricher, isFiltersRequestEnricher, isSceneObject, registerQueryWithController, registerRuntimeDataSource, sceneGraph, sceneUtils, useSceneApp, useSceneObjectState, useUrlSync };
 export type { AdHocFilterWithLabels, 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 };