@grafana/plugin-ui 0.17.0 → 0.17.1

package/dist/esm/index.d.ts

@@ -1,4 +1,4 @@
-import React, { ComponentProps, PureComponent, ReactElement, ReactNode, FunctionComponent, HTMLProps } from 'react';
+import React, { ComponentProps, PureComponent, ReactElement, ReactNode, Component, ErrorInfo, FunctionComponent, HTMLProps } from 'react';
 import { Input, Segment as Segment$1, monacoTypes, Monaco, ButtonProps, Field, PopoverContent, Switch, SelectCommonProps, InlineLabel } from '@grafana/ui';
 import { DataSourceInstanceSettings, SelectableValue, DataSourceJsonData, VariableSuggestion, TimeRange, DataFrame, MetricFindValue, ThemeSpacingTokens, ScopedVars, VariableModel, DataFrameView, QueryEditorProps as QueryEditorProps$1, DataSourceSettings, RegistryItem, DataSourceApi, Registry, DataQuery as DataQuery$1, PanelData, DataQueryRequest, DataQueryResponse, LoadingState } from '@grafana/data';
 import { DataSourceSrv, DataSourceWithBackend, TemplateSrv } from '@grafana/runtime';
@@ -1024,287 +1024,6 @@ type Props$a<C extends Config = Config> = {
 };
 declare const AdvancedHttpSettings: <C extends Config = Config>(props: Props$a<C>) => JSX.Element;
 
-interface CustomHeader {
-    id: string;
-    name: string;
-    value: string;
-    configured: boolean;
-}
-type CustomHeaders = CustomHeader[];
-interface Props$9 {
-    dataSourceConfig: DataSourceSettings<any, any>;
-    onChange: (config: DataSourceSettings) => void;
-}
-interface State {
-    headers: CustomHeaders;
-}
-declare class CustomHeadersSettings extends PureComponent<Props$9, State> {
-    state: State;
-    constructor(props: Props$9);
-    updateSettings: () => void;
-    onHeaderAdd: () => void;
-    onHeaderChange: (headerIndex: number, value: CustomHeader) => void;
-    onHeaderReset: (headerId: string) => void;
-    onHeaderRemove: (headerId: string) => void;
-    render(): React.JSX.Element;
-}
-
-interface QueryBuilderLabelFilter {
-    label: string;
-    op: string;
-    value: string;
-}
-interface QueryBuilderOperation {
-    id: string;
-    params: QueryBuilderOperationParamValue[];
-    disabled?: boolean;
-}
-interface QueryBuilderOperationDefinition<T = any> extends RegistryItem {
-    documentation?: string;
-    params: QueryBuilderOperationParamDef[];
-    defaultParams: QueryBuilderOperationParamValue[];
-    category: string;
-    hideFromList?: boolean;
-    alternativesKey?: string;
-    /** Can be used to control operation placement when adding a new operations, lower are placed first */
-    orderRank?: number;
-    renderer: QueryBuilderOperationRenderer;
-    addOperationHandler: QueryBuilderAddOperationHandler<T>;
-    paramChangedHandler?: QueryBuilderOnParamChangedHandler;
-    explainHandler?: QueryBuilderExplainOperationHandler;
-    changeTypeHandler?: (op: QueryBuilderOperation, newDef: QueryBuilderOperationDefinition<T>) => QueryBuilderOperation;
-    toggleable?: boolean;
-}
-type QueryBuilderAddOperationHandler<T> = (def: QueryBuilderOperationDefinition, query: T, modeller: VisualQueryModeller) => T;
-type QueryBuilderExplainOperationHandler = (op: QueryBuilderOperation, def?: QueryBuilderOperationDefinition) => string;
-type QueryBuilderOnParamChangedHandler = (index: number, operation: QueryBuilderOperation, operationDef: QueryBuilderOperationDefinition) => QueryBuilderOperation;
-type QueryBuilderOperationRenderer = (model: QueryBuilderOperation, def: QueryBuilderOperationDefinition, innerQuery: string) => string;
-type QueryBuilderOperationParamValue = string | number | boolean;
-interface QueryBuilderOperationParamDef {
-    name: string;
-    type: 'string' | 'number' | 'boolean';
-    options?: string[] | number[] | Array<SelectableValue<string>>;
-    hideName?: boolean;
-    restParam?: boolean;
-    optional?: boolean;
-    placeholder?: string;
-    description?: string;
-    minWidth?: number;
-    editor?: FunctionComponent<QueryBuilderOperationParamEditorProps>;
-    runQueryOnEnter?: boolean;
-}
-interface QueryBuilderOperationParamEditorProps {
-    value?: QueryBuilderOperationParamValue;
-    paramDef: QueryBuilderOperationParamDef;
-    /** Parameter index */
-    index: number;
-    operation: QueryBuilderOperation;
-    operationId: string;
-    query: any;
-    datasource: DataSourceApi;
-    timeRange?: TimeRange;
-    onChange: (index: number, value: QueryBuilderOperationParamValue) => void;
-    onRunQuery: () => void;
-    queryModeller: VisualQueryModeller;
-}
-declare enum QueryEditorMode {
-    Code = "code",
-    Builder = "builder"
-}
-type QueryStats = {
-    bytes: number;
-    message?: string;
-};
-interface VisualQueryModeller {
-    getOperationsForCategory(category: string): QueryBuilderOperationDefinition[];
-    getAlternativeOperations(key: string): QueryBuilderOperationDefinition[];
-    getCategories(): string[];
-    getOperationDefinition(id: string): QueryBuilderOperationDefinition | undefined;
-    renderQuery(query: VisualQuery, nested?: boolean): string;
-    renderLabels(labels: QueryBuilderLabelFilter[]): string;
-    innerQueryPlaceholder: string;
-}
-interface VisualQueryBinary<T> {
-    operator: string;
-    vectorMatchesType?: 'on' | 'ignoring';
-    vectorMatches?: string;
-    query: T;
-}
-declare const BINARY_OPERATIONS_KEY = "Binary operations";
-interface VisualQuery {
-    metric?: string;
-    labels: QueryBuilderLabelFilter[];
-    operations: QueryBuilderOperation[];
-    binaryQueries?: Array<VisualQueryBinary<VisualQuery>>;
-}
-
-declare abstract class QueryModellerBase implements VisualQueryModeller {
-    protected operationsRegistry: Registry<QueryBuilderOperationDefinition>;
-    private categories;
-    innerQueryPlaceholder: string;
-    constructor(operationDefinitions: QueryBuilderOperationDefinition[], innerQueryPlaceholder?: string);
-    protected setOperationCategories(categories: string[]): void;
-    abstract renderOperations(queryString: string, operations: QueryBuilderOperation[]): string;
-    abstract renderBinaryQueries(queryString: string, binaryQueries?: Array<VisualQueryBinary<VisualQuery>>): string;
-    abstract renderLabels(labels: QueryBuilderLabelFilter[]): string;
-    abstract renderQuery(query: VisualQuery, nested?: boolean): string;
-    getOperationsForCategory(category: string): QueryBuilderOperationDefinition<any>[];
-    getAlternativeOperations(key: string): QueryBuilderOperationDefinition<any>[];
-    getCategories(): string[];
-    getOperationDefinition(id: string): QueryBuilderOperationDefinition | undefined;
-    hasBinaryOp(query: VisualQuery): boolean;
-}
-
-interface Props$8 {
-    labelsFilters: QueryBuilderLabelFilter[];
-    onChange: (labelFilters: QueryBuilderLabelFilter[]) => void;
-    onGetLabelNames: (forLabel: Partial<QueryBuilderLabelFilter>) => Promise<SelectableValue[]>;
-    onGetLabelValues: (forLabel: Partial<QueryBuilderLabelFilter>) => Promise<SelectableValue[]>;
-    /** If set to true, component will show error message until at least 1 filter is selected */
-    labelFilterRequired?: boolean;
-    multiValueSeparator?: string;
-}
-declare function LabelFilters({ labelsFilters, onChange, onGetLabelNames, onGetLabelValues, labelFilterRequired, multiValueSeparator, }: Props$8): React.JSX.Element;
-
-interface Props$7 {
-    title?: React.ReactNode;
-    markdown?: string;
-    stepNumber?: number;
-}
-declare function OperationExplainedBox({ title, stepNumber, markdown, children }: React.PropsWithChildren<Props$7>): React.JSX.Element;
-
-interface Props$6<T extends VisualQuery> {
-    query: T;
-    datasource: DataSourceApi;
-    onChange: (query: T) => void;
-    onRunQuery: () => void;
-    queryModeller: VisualQueryModeller;
-    explainMode?: boolean;
-    highlightedOp?: QueryBuilderOperation;
-    timeRange?: TimeRange;
-    isConflictingOperation?: (operation: QueryBuilderOperation, otherOperations: QueryBuilderOperation[]) => boolean;
-}
-declare function OperationList<T extends VisualQuery>({ query, datasource, queryModeller, onChange, onRunQuery, highlightedOp, timeRange, isConflictingOperation, }: Props$6<T>): React.JSX.Element;
-
-interface Props$5<T extends VisualQuery> {
-    query: T;
-    queryModeller: VisualQueryModeller;
-    explainMode?: boolean;
-    stepNumber: number;
-    language: {
-        grammar: Grammar;
-        name: string;
-    };
-    onMouseEnter?: (op: QueryBuilderOperation, index: number) => void;
-    onMouseLeave?: (op: QueryBuilderOperation, index: number) => void;
-}
-declare function OperationListExplained<T extends VisualQuery>({ query, queryModeller, stepNumber, language, onMouseEnter, onMouseLeave, }: Props$5<T>): React.JSX.Element;
-
-declare function OperationsEditorRow({ children }: React.PropsWithChildren<{}>): React.JSX.Element;
-
-interface Props$4<TVisualQuery extends VisualQuery, TDataQuery extends DataQuery$1> {
-    query: TVisualQuery;
-    datasource: DataSourceApi<TDataQuery>;
-    queryModeller: VisualQueryModeller;
-    buildVisualQueryFromString: (queryString: string) => {
-        query: TVisualQuery;
-    };
-    buildDataQueryFromQueryString: (queryString: string) => TDataQuery;
-    buildQueryStringFromDataQuery: (dataQuery: TDataQuery) => string;
-    onChange: (update: TVisualQuery) => void;
-    data?: PanelData;
-}
-declare const QueryBuilderHints: {
-    <TVisualQuery extends VisualQuery, TDataQuery extends DataQuery$1>({ datasource, query: visualQuery, onChange, data, queryModeller, buildVisualQueryFromString, buildDataQueryFromQueryString, buildQueryStringFromDataQuery, }: Props$4<TVisualQuery, TDataQuery>): React.JSX.Element;
-    displayName: string;
-};
-
-interface Props$3 {
-    mode: QueryEditorMode;
-    onChange: (mode: QueryEditorMode) => void;
-}
-declare function QueryEditorModeToggle({ mode, onChange }: Props$3): React.JSX.Element;
-
-interface Props$2 extends Omit<HTMLProps<HTMLInputElement>, 'value' | 'ref'> {
-    value?: boolean;
-    label: string;
-}
-declare function QueryHeaderSwitch({ label, ...inputProps }: Props$2): React.JSX.Element;
-
-interface Props$1 {
-    title: string;
-    collapsedInfo: string[];
-    queryStats?: QueryStats | null;
-}
-declare function QueryOptionGroup({ title, children, collapsedInfo, queryStats }: React.PropsWithChildren<Props$1>): React.JSX.Element;
-
-interface Props {
-    query: string;
-    language: {
-        grammar: Grammar;
-        name: string;
-    };
-    className?: string;
-}
-declare function RawQuery({ query, language, className }: Props): React.JSX.Element;
-
-interface CustomMeta {
-    queryID: string;
-    status: string;
-}
-interface RunningQueryInfo {
-    queryID?: string;
-    shouldCancel?: boolean;
-}
-declare class DatasourceWithAsyncBackend<TQuery extends DataQuery$1 = DataQuery$1, TOptions extends DataSourceJsonData = DataSourceJsonData> extends DataSourceWithBackend<TQuery, TOptions> {
-    private runningQueries;
-    private requestCounter;
-    private requestIdPrefix;
-    constructor(instanceSettings: DataSourceInstanceSettings<TOptions>);
-    query(request: DataQueryRequest<TQuery>): Observable<DataQueryResponse>;
-    storeQuery(target: TQuery, queryInfo: RunningQueryInfo): void;
-    getQuery(target: TQuery): RunningQueryInfo;
-    removeQuery(target: TQuery): void;
-    doSingle(target: TQuery, request: DataQueryRequest<TQuery>): Observable<DataQueryResponse>;
-    cancel: (target: TQuery) => void;
-}
-
-interface RunQueryButtonsProps<TQuery extends DataQuery$1> {
-    enableRun?: boolean;
-    onRunQuery: () => void;
-    onCancelQuery: (query: TQuery) => void;
-    query: TQuery;
-    state?: LoadingState;
-}
-declare const RunQueryButtons: <TQuery extends DataQuery$1>(props: RunQueryButtonsProps<TQuery>) => React.JSX.Element;
-
-interface RequestLoopOptions<TQuery extends DataQuery$1 = DataQuery$1> {
-    /**
-     * If the response needs an additional request to execute, return it here
-     */
-    getNextQuery: (rsp: DataQueryResponse) => TQuery | undefined;
-    /**
-     * The datasource execute method
-     */
-    query: (req: DataQueryRequest<TQuery>) => Observable<DataQueryResponse>;
-    /**
-     * Process the results
-     */
-    process: (data: DataFrame[]) => DataFrame[];
-    /**
-     * Check if the query should be cancelled
-     */
-    shouldCancel: () => boolean;
-    /**
-     * Callback that gets executed when unsubscribed
-     */
-    onCancel: () => void;
-}
-/**
- * Continue executing requests as long as `getNextQuery` returns a query
- */
-declare function getRequestLooper<T extends DataQuery$1 = DataQuery$1>(req: DataQueryRequest<T>, options: RequestLoopOptions<T>): Observable<DataQueryResponse>;
-
 interface DatasourceConfigSchema {
     /**
      * Schema version (required)
@@ -1326,6 +1045,13 @@ interface DatasourceConfigSchema {
      * Optional documentation URL
      */
     docURL?: string;
+    /**
+     * SDK field packs to merge into this schema before validation.
+     * Pack fields are prepended to `fields` in declaration order.
+     * Plugin-declared fields with a matching ID take precedence over pack fields.
+     * Call `resolveBaseFields()` before consuming the schema.
+     */
+    baseFields?: BaseFieldRef[];
     /**
      * Source of truth for configuration
      */
@@ -1334,11 +1060,62 @@ interface DatasourceConfigSchema {
      * Optional UI grouping
      */
     groups?: ConfigGroup[];
+    /**
+     * Optional instructions rendered alongside the config form.
+     */
+    instructions?: Instruction[];
     /**
      * Relationships between fields
      */
     relationships?: FieldRelationship[];
 }
+interface Instruction {
+    msg: string;
+    tags?: string[];
+}
+/**
+ * Identifier of a built-in field pack defined by grafana/dsconfig.
+ * Convention: `<sdk_name>_settings`.
+ */
+type FieldPackID = 'plugin_sdk_settings' | 'aws_sdk_settings' | 'azure_sdk_settings' | 'google_sdk_settings' | 'sqleng_settings';
+/**
+ * Declares a single field pack to compose into the schema.
+ */
+interface BaseFieldRef {
+    /** Identifier of a built-in field pack. */
+    from: FieldPackID;
+    /**
+     * Field IDs from the pack to omit entirely.
+     * Each ID must exist in the pack (else resolution fails).
+     */
+    exclude?: string[];
+    /**
+     * Presentation-only overrides keyed by pack field ID.
+     * Structural properties (id, key, valueType, target, role) cannot be patched.
+     */
+    patch?: Record<string, FieldPatch>;
+}
+/**
+ * Safe-to-override presentation properties for a pack field.
+ * Only non-undefined values are applied.
+ */
+interface FieldPatch {
+    label?: string;
+    description?: string;
+    placeholder?: string;
+    defaultValue?: unknown;
+    required?: boolean;
+    /** When true, the field is dropped from the resolved schema. */
+    hidden?: boolean;
+}
+/**
+ * Named set of ConfigField definitions provided by an SDK.
+ * Pack field IDs are namespaced with the pack ID, e.g. `plugin_sdk_settings.url`.
+ */
+interface FieldPack {
+    id: FieldPackID;
+    fields: ConfigField[];
+}
 interface ConfigField {
     /**
      * Globally unique identifier
@@ -1364,6 +1141,11 @@ interface ConfigField {
      * Storage location (required for storage fields)
      */
     target?: TargetLocation;
+    /**
+     * Semantic role identifying what a field represents to the SDK.
+     * Field packs annotate their fields with roles (e.g. `endpoint.baseUrl`).
+     */
+    role?: Role;
     /**
      * Dotted path prefix within the target for nested objects.
      * Example: for jsonData.tracesToLogs.datasourceUid,
@@ -1374,329 +1156,857 @@ interface ConfigField {
      * Field kind.
      * @default "storage"
      */
-    kind?: FieldKind;
+    kind?: FieldKind;
+    /**
+     * True if field belongs to array item schema
+     */
+    isItemField?: boolean;
+    /**
+     * UI rendering hints
+     */
+    ui?: FieldUI;
+    /**
+     * Validations rules
+     */
+    validations?: FieldValidationRule[];
+    /**
+     * Visibility condition (CEL expression)
+     */
+    dependsOn?: Expression;
+    /**
+     * Always required
+     */
+    required?: boolean;
+    /**
+     * Conditionally required
+     */
+    requiredWhen?: Expression;
+    /**
+     * Disabled condition
+     */
+    disabledWhen?: Expression;
+    /**
+     * Dynamic overrides
+     */
+    overrides?: FieldOverride[];
+    /**
+     * Declarative multi-field write side-effects.
+     * When this field's value matches a condition, the listed target
+     * fields are set to specified values. Typically used on virtual
+     * selector fields (e.g. auth method dropdown).
+     */
+    effects?: FieldEffect[];
+    /**
+     * Item schema for array elements or map values.
+     * Required if valueType === "array" or "map".
+     */
+    item?: FieldItemSchema;
+    /**
+     * Legacy indexed fields (deprecated)
+     */
+    repeatable?: boolean;
+    pattern?: string;
+    /**
+     * Storage mapping
+     */
+    storage?: StorageMapping;
+    /**
+     * Metadata
+     */
+    tags?: string[];
+    examples?: unknown[];
+    defaultValue?: unknown;
+}
+interface FieldItemSchema {
+    /**
+     * Type of array items or map values.
+     * For arrays, describes each element.
+     * For maps, describes each value (keys are always strings).
+     */
+    valueType: ValueType;
+    /**
+     * Sub-fields for object items. Optional even when valueType = "object"
+     * (omitting allows an unconstrained object).
+     */
+    fields?: ConfigField[];
+}
+/**
+ * CEL expression string
+ */
+type Expression = string;
+type ValueType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'map' | 'any';
+type FieldKind = 'storage' | 'virtual';
+type TargetLocation = 'root' | 'jsonData' | 'secureJsonData';
+/**
+ * Semantic role identifying what a field represents to the SDK.
+ * Kept as `string` for forward compatibility with newer packs from
+ * grafana/dsconfig; see that repo for the canonical role list.
+ */
+type Role = string;
+type UIComponent = 'input' | 'textarea' | 'select' | 'multiselect' | 'radio' | 'checkbox' | 'switch' | 'code' | 'keyvalue' | 'list' | 'fileUpload';
+type UIWidth = 'full' | 'half';
+/**
+ * UI configuration
+ */
+interface FieldUI {
+    component: UIComponent;
+    multiline?: boolean;
+    rows?: number;
+    options?: FieldOption[];
+    allowCustom?: boolean;
+    width?: UIWidth;
+    placeholder?: string;
+    /**
+     * Language hint for code editor components.
+     * Example: "promql", "logql", "traceql", "sql", "json"
+     */
+    language?: string;
+    /**
+     * Layout row index for item fields inside object arrays.
+     * Fields with the same row number are rendered horizontally.
+     * Fields without a row number use auto-layout:
+     * - ≤3 fields: all on one row
+     * - >3 fields: each on its own row
+     */
+    row?: number;
+    /**
+     * Accepted file types for fileUpload component.
+     * Uses HTML accept attribute format with leading dot.
+     * Example: [".json"]
+     */
+    accept?: string[];
     /**
-     * True if field belongs to array item schema
+     * Maps keys in an uploaded JSON file to target field IDs.
+     * Used by fileUpload to distribute parsed values to other form fields.
+     * Example: { "private_key": "secureJsonData.privateKey", "client_email": "jsonData.clientEmail" }
      */
-    isItemField?: boolean;
+    fileMapping?: Record<string, string>;
+}
+type FieldValidationRule = PatternValidationRule | RangeValidationRule | LengthValidationRule | ItemCountValidationRule | AllowedValuesValidationRule | CustomValidationRule;
+interface BaseValidationRule {
     /**
-     * UI rendering hints
+     * Optional stable ID for the validation rule.
+     * Useful for docs, localization, and test snapshots.
      */
-    ui?: FieldUI;
+    id?: string;
     /**
-     * Validations rules
+     * Human-readable validation error message.
      */
-    validations?: FieldValidationRule[];
+    message?: string;
+}
+interface PatternValidationRule extends BaseValidationRule {
+    type: 'pattern';
+    pattern: string;
+}
+interface RangeValidationRule extends BaseValidationRule {
+    type: 'range';
+    min?: number;
+    max?: number;
+}
+interface LengthValidationRule extends BaseValidationRule {
+    type: 'length';
+    min?: number;
+    max?: number;
+}
+interface ItemCountValidationRule extends BaseValidationRule {
+    type: 'itemCount';
+    min?: number;
+    max?: number;
+}
+interface AllowedValuesValidationRule extends BaseValidationRule {
+    type: 'allowedValues';
+    values: unknown[];
+}
+interface CustomValidationRule extends BaseValidationRule {
+    type: 'custom';
     /**
-     * Visibility condition (CEL expression)
+     * CEL expression.
+     *
+     * Should evaluate to true when the field value is valid.
      */
-    dependsOn?: Expression;
+    expression: Expression;
+}
+interface FieldOverride {
     /**
-     * Always required
+     * CEL condition
      */
-    required?: boolean;
+    when: Expression;
+    defaultValue?: unknown;
     /**
-     * Conditionally required
+     * When true, the field is disabled/read-only while this override is active.
      */
-    requiredWhen?: Expression;
+    readOnly?: boolean;
+    description?: string;
+    placeholder?: string;
+    tooltip?: string;
+    validations?: FieldValidationRule[];
+    options?: FieldOption[];
     /**
-     * Disabled condition
+     * When present on an `isItemField` field, the value is routed to
+     * `secureJsonData` under the resolved key instead of being stored
+     * inline in the parent array.
+     *
+     * The template string supports placeholders:
+     * - `{index}`  — 0-based array position
+     * - `{index1}` — 1-based array position
+     * - `{item.KEY}` — value of sibling item field `KEY`
+     *
+     * Examples:
+     * - `"secureHttpHeaders.{item.name}"` (ClickHouse)
+     * - `"httpHeaderValue{index1}"` (Grafana core headers)
      */
-    disabledWhen?: Expression;
+    secureKey?: string;
+}
+/**
+ * Declares that when a field's value matches a condition,
+ * listed target fields should be set to specified values.
+ *
+ * Use "value" in the `when` expression to refer to the field's value.
+ */
+interface FieldEffect {
     /**
-     * Dynamic overrides
+     * CEL expression. Example: "value == 'basic-auth'"
      */
-    overrides?: FieldOverride[];
+    when: Expression;
     /**
-     * Declarative multi-field write side-effects.
-     * When this field's value matches a condition, the listed target
-     * fields are set to specified values. Typically used on virtual
-     * selector fields (e.g. auth method dropdown).
+     * Maps field IDs to the values they should be set to.
+     * Must contain at least one entry.
      */
-    effects?: FieldEffect[];
+    set: Record<string, unknown> & {
+        [k: string]: unknown;
+    };
+}
+type StorageMapping = DirectMapping | IndexedPairMapping | ComputedMapping;
+/**
+ * Direct mapping
+ */
+interface DirectMapping {
+    type: 'direct';
+}
+/**
+ * Indexed pair mapping (headers)
+ */
+interface IndexedPairMapping {
+    type: 'indexedPair';
+    key: MappingField;
+    value: MappingField;
+    startIndex?: number;
+}
+/**
+ * Computed mapping (virtual fields).
+ * At least one of `read` or `write` must be provided.
+ */
+type ComputedMapping = {
+    type: 'computed';
+    read: Expression;
+    write?: Expression;
+} | {
+    type: 'computed';
+    read?: Expression;
+    write: Expression;
+};
+/**
+ * Mapping field
+ */
+interface MappingField {
+    target: TargetLocation;
+    pattern: string;
+}
+interface FieldOption {
+    label: string;
     /**
-     * Item schema for array elements or map values.
-     * Required if valueType === "array" or "map".
+     * Must match parent field valueType.
+     * Must not be null.
      */
-    item?: FieldItemSchema;
+    value: NonNullable<unknown>;
     /**
-     * Legacy indexed fields (deprecated)
+     * Optional human-readable description of the option.
      */
-    repeatable?: boolean;
-    pattern?: string;
+    description?: string;
+}
+interface ConfigGroup {
+    id: string;
+    title: string;
+    description?: string;
+    order?: number;
     /**
-     * Storage mapping
+     * When true, the group is optional and can be collapsed/hidden by default.
      */
-    storage?: StorageMapping;
+    optional?: boolean;
     /**
-     * Metadata
+     * References field IDs (not keys)
      */
-    tags?: string[];
-    examples?: unknown[];
-    defaultValue?: unknown;
+    fieldRefs: string[];
 }
-interface FieldItemSchema {
+type RelationshipType = 'pair' | 'group' | 'datasourceReference';
+interface FieldRelationship {
+    type: RelationshipType;
     /**
-     * Type of array items or map values.
-     * For arrays, describes each element.
-     * For maps, describes each value (keys are always strings).
+     * References field IDs
      */
-    valueType: ValueType;
+    fields: string[];
+    description?: string;
     /**
-     * Sub-fields for object items. Optional even when valueType = "object"
-     * (omitting allows an unconstrained object).
+     * Constrains the datasource UID to a specific plugin type.
+     * Only applicable when type is "datasourceReference".
      */
-    fields?: ConfigField[];
+    targetPluginType?: string;
+}
+type SecureFieldState = {
+    type: 'unset';
+} | {
+    type: 'configured';
+} | {
+    type: 'updated';
+    value: string;
+};
+interface FormState {
+    values: Record<string, unknown>;
+    secure: Record<string, SecureFieldState>;
+}
+
+type DatasourceConfigWizardProps = {
+    schema: DatasourceConfigSchema;
+    dsUid: string;
+    dsName: string;
+    onSuccess: (status: string, message?: string) => void;
+    onSaving?: (saving: boolean) => void;
+    onRetest?: () => void;
+    onFollowup?: (intent: string) => void;
+    healthError?: string;
+    /** Optional render prop for custom action buttons (e.g. analyze/troubleshoot). */
+    renderActions?: (props: {
+        dsUid: string;
+        dsName: string;
+        dsType: string;
+        healthError?: string;
+    }) => ReactNode;
+};
+declare function DatasourceConfigWizard(props: DatasourceConfigWizardProps): React.JSX.Element;
+
+/** Lightweight error boundary scoped to datasource config widgets — won't crash the host UI. */
+declare class DatasourceErrorBoundary extends Component<{
+    children: ReactNode;
+    dsName?: string;
+}, {
+    error: Error | null;
+}> {
+    state: {
+        error: Error | null;
+    };
+    static getDerivedStateFromError(error: Error): {
+        error: Error;
+    };
+    componentDidCatch(error: Error, info: ErrorInfo): void;
+    render(): string | number | boolean | Iterable<React.ReactNode> | React.JSX.Element | null | undefined;
+}
+
+type HealthState = 'pending' | 'checking' | 'done';
+interface DatasourceHealth {
+    state: HealthState;
+    status?: string;
+    message?: string;
 }
 /**
- * CEL expression string
+ * Health check hook — on-demand only.
+ * Call `checkUids(uids)` to trigger checks for specific UIDs.
+ * Call `retry(uid)` to force re-check a single UID.
+ * UIDs that have already been checked (or are in-flight) are automatically skipped.
+ */
+declare function useHealthChecks(): {
+    healthMap: Record<string, DatasourceHealth>;
+    checkUids: (uids: string[]) => void;
+    retry: (uid: string) => void;
+};
+
+declare function resolvePluginName(pluginType: string): string;
+
+/**
+ * CEL (Common Expression Language) expression evaluator for schema conditions.
+ *
+ * Used by `dependsOn`, `requiredWhen`, `disabledWhen`, and `overrides[].when`.
+ * Wraps @marcbachmann/cel-js with field-ID-aware context building.
+ *
+ * Go equivalent: github.com/google/cel-go
+ */
+/**
+ * Build a nested context object from flat form values keyed by field IDs.
+ *
+ * CEL interprets dots as property access, so `jsonData.auth_method == 'oauth2'`
+ * requires `{ jsonData: { auth_method: 'oauth2' } }`.
+ *
+ * This function takes flat key-value pairs (from react-hook-form `watch()`)
+ * and builds the nested structure CEL expects.
+ *
+ * @param values - Flat map of form keys to values (e.g. `{ "auth_method": "oauth2", "oauth2.oauth2_type": "jwt" }`)
+ * @param fieldIdToFormKey - Optional map from field ID to form key for translation
+ */
+declare function buildCelContext(values: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Evaluate a CEL expression against a context of field values.
+ * Returns the boolean result, or `defaultValue` if the expression is invalid.
+ *
+ * @example
+ * ```ts
+ * evaluateCelExpression("jsonData.auth_method == 'oauth2'", { jsonData: { auth_method: 'oauth2' } })
+ * // => true
+ *
+ * evaluateCelExpression("auth_method == 'oauth2' && oauth2_type == 'jwt'", { auth_method: 'oauth2', oauth2_type: 'jwt' })
+ * // => true
+ * ```
+ */
+declare function evaluateCelExpression(expr: string, context: Record<string, unknown>, defaultValue?: boolean): boolean;
+/**
+ * Evaluate a CEL expression directly using `evaluate` (no caching).
+ * Useful for one-off evaluations or testing.
+ */
+declare function evaluateCelDirect(expr: string, context: Record<string, unknown>): unknown;
+/**
+ * Validate that a CEL expression can be parsed without errors.
+ * Returns true if valid, false otherwise.
+ */
+declare function isValidCelExpression(expr: string): boolean;
+/**
+ * Extract all field ID references from a simple expression.
+ * Used by `resolveRequiredFieldsGroup` to find dependency relationships.
+ *
+ * For simple expressions like `fieldA == 'x'`, returns `['fieldA']`.
+ * For compound expressions like `fieldA == 'x' && fieldB == 'y'`, returns `['fieldA', 'fieldB']`.
+ *
+ * This uses regex extraction (not AST walking) for simplicity and speed.
+ */
+declare function extractFieldRefs(expr: string): string[];
+/**
+ * Clear the expression cache. Useful for testing.
+ */
+declare function clearExpressionCache(): void;
+
+type TroubleShootingContext = {
+    label: string;
+    key: string;
+    target: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    defaultValue?: unknown;
+    options?: string[];
+    section?: string;
+    dependsOn?: string;
+};
+/**
+ * Generate LLM hints for select fields (used when creating datasources).
+ */
+declare function generateLLMHint(schema: DatasourceConfigSchema): string;
+/**
+ * Generate comprehensive structured field data for troubleshooting context.
+ * Returns an array of field descriptors the LLM can use to render rich tables.
+ */
+declare function generateTroubleshootingFields(schema: DatasourceConfigSchema): TroubleShootingContext[];
+
+type ProvisioningYamlOptions = {
+    /** Include comments with field descriptions. Default: true for template, false for export. */
+    comments?: boolean;
+    /** Override the emitted datasource name. */
+    name?: string;
+};
+/**
+ * Generate a Grafana provisioning YAML template from a dsconfig schema.
+ * Emits every schema field with sensible defaults and (by default) explanatory comments.
  */
-type Expression = string;
-type ValueType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'map' | 'any';
-type FieldKind = 'storage' | 'virtual';
-type TargetLocation = 'root' | 'jsonData' | 'secureJsonData';
-type UIComponent = 'input' | 'textarea' | 'select' | 'multiselect' | 'radio' | 'checkbox' | 'switch' | 'code' | 'keyvalue' | 'list' | 'fileUpload';
-type UIWidth = 'full' | 'half';
+declare function generateProvisioningTemplate(schema: DatasourceConfigSchema, options?: ProvisioningYamlOptions): string;
 /**
- * UI configuration
+ * Generate provisioning YAML from an existing Grafana datasource API response.
+ * If a dsconfig schema is available, uses it for field ordering and comments.
+ * If not, generates basic YAML from the raw API response.
  */
-interface FieldUI {
-    component: UIComponent;
-    multiline?: boolean;
-    rows?: number;
-    options?: FieldOption[];
-    allowCustom?: boolean;
-    width?: UIWidth;
+declare function datasourceToProvisioningYaml(ds: Record<string, unknown>, schema: DatasourceConfigSchema | null): string;
+declare const formatYamlDiff: (existing: Record<string, unknown>, body: Record<string, unknown>) => string;
+
+declare const ROOT_CONFIG_FIELDS: readonly ["name", "type", "id", "uid", "access", "url", "basicAuth", "basicAuthUser", "user", "isDefault", "database", "withCredentials"];
+type DatasourceConfig = Record<any, any>;
+declare const buildCreateDatasourcePayload: (input: DatasourceConfig) => DatasourceConfig;
+declare const buildCloneDatasourcePayload: (source: DatasourceConfig, name: string) => DatasourceConfig;
+declare const buildUpdateDatasourcePayload: (existing: DatasourceConfig, input: DatasourceConfig) => {
+    body: DatasourceConfig;
+    hasChanges: boolean;
+};
+
+declare function getConfigSchema(pluginType: string): Promise<DatasourceConfigSchema | null>;
+
+/**
+ * Pure helper functions for working with DatasourceConfigSchema.
+ *
+ * Types are defined in schema.ts — import them from there directly.
+ */
+
+/** A group paired with its resolved ConfigField objects (in fieldRefs order). */
+type ResolvedGroup = {
+    group: ConfigGroup;
+    fields: ConfigField[];
+};
+/**
+ * Group ids that denote the authentication section. Registry schemas use the
+ * full form `authentication`; `auth` is accepted for backwards compatibility
+ * with older/short-form schemas.
+ */
+declare const AUTH_GROUP_IDS: readonly string[];
+/** Whether a group id denotes the authentication group. */
+declare function isAuthGroupId(id: string): boolean;
+/**
+ * Resolve a schema's groups into arrays of ConfigField objects.
+ * If the schema has no groups, returns a single group containing all non-virtual fields.
+ */
+declare function resolveGroups(schema: DatasourceConfigSchema): ResolvedGroup[];
+/**
+ * Build a virtual "Required" group containing all required fields, any parent
+ * fields they depend on (via `dependsOn`), and any child fields that depend on
+ * required fields.  When the schema contains an authentication group (id
+ * `authentication` or `auth`), its fields are also pulled in (auth is
+ * effectively required for Prometheus/Loki/Tempo style datasources).  Fields
+ * are returned in schema order and de-duplicated.
+ * Returns `null` when the virtual group would be empty.
+ */
+declare function resolveRequiredFieldsGroup(schema: DatasourceConfigSchema): ResolvedGroup | null;
+/**
+ * Unique form key for a field. Section-scoped fields (e.g. section:"logs", key:"defaultTable")
+ * get a prefixed key ("logs.defaultTable") so they don't collide with top-level fields that
+ * share the same key name.
+ */
+declare function formKey(field: ConfigField): string;
+/**
+ * Resolve a possibly-dotted key against watchedValues from react-hook-form.
+ * RHF's `watch()` returns nested objects for dotted Controller names
+ * (e.g. "logs.otelEnabled" → { logs: { otelEnabled: true } }),
+ * so a flat `obj["logs.otelEnabled"]` lookup misses.
+ *
+ * For dotted keys we must try the nested path **first**: react-hook-form's
+ * Controller `onChange` writes nested objects via its internal `set()`, but
+ * `reset()` may have created a flat dotted key with the same name.  After user
+ * interaction the nested value is authoritative; the stale flat key must not
+ * shadow it.  This mirrors RHF's own `get()` semantics (nested-first, flat
+ * fallback).
+ */
+declare function getWatchedValue(watchedValues: Record<string, unknown>, key: string): unknown;
+/**
+ * Parse a simple CEL-like dependsOn expression: "fieldId == 'value'" or "fieldId != 'value'".
+ * Only single comparisons are supported — no &&, ||, or parentheses.
+ * Field IDs may contain dots and underscores (e.g. "jsonData.oauth2.oauth2_type").
+ * Values may be single-quoted, double-quoted, or unquoted literals (true/false/numbers).
+ * Returns { field, value, negate } or null if unparseable.
+ */
+declare function parseDependsOn(expr: string): {
+    field: string;
+    value: string;
+    negate: boolean;
+} | null;
+/**
+ * Evaluate a parsed dependsOn condition against a value.
+ * Handles both == and != operators.
+ */
+declare function evaluateDependsOn(parsed: {
+    value: string;
+    negate: boolean;
+}, currentValue: unknown): boolean;
+/**
+ * Resolve the first matching override for a field given current form values.
+ * Override `when` uses the same "fieldId == 'value'" syntax as dependsOn.
+ * Returns the matching override or undefined if none match.
+ */
+declare function resolveActiveOverride(field: ConfigField, watchedValues: Record<string, unknown>, fieldById: Map<string, ConfigField>): FieldOverride | undefined;
+/**
+ * Evaluate a simple computed.read expression against form values.
+ * Supports patterns used in dsconfig schemas:
+ *   - "fieldRef == true ? 'a' : (fieldRef == true ? 'b' : 'c')"
+ *   - Simple ternary chains with equality checks
+ * Falls back to the field's defaultValue if the expression can't be evaluated.
+ */
+declare function evaluateComputedRead(expr: string, values: Record<string, unknown>, fields: ConfigField[]): unknown;
+/**
+ * Compute initial values for all virtual fields that have storage.computed.read expressions.
+ * Call after loading existing storage field values.
+ */
+declare function computeVirtualFieldValues(schema: DatasourceConfigSchema, existingValues: Record<string, unknown>): Record<string, unknown>;
+
+interface CustomHeader {
+    id: string;
+    name: string;
+    value: string;
+    configured: boolean;
+}
+type CustomHeaders = CustomHeader[];
+interface Props$9 {
+    dataSourceConfig: DataSourceSettings<any, any>;
+    onChange: (config: DataSourceSettings) => void;
+}
+interface State {
+    headers: CustomHeaders;
+}
+declare class CustomHeadersSettings extends PureComponent<Props$9, State> {
+    state: State;
+    constructor(props: Props$9);
+    updateSettings: () => void;
+    onHeaderAdd: () => void;
+    onHeaderChange: (headerIndex: number, value: CustomHeader) => void;
+    onHeaderReset: (headerId: string) => void;
+    onHeaderRemove: (headerId: string) => void;
+    render(): React.JSX.Element;
+}
+
+interface QueryBuilderLabelFilter {
+    label: string;
+    op: string;
+    value: string;
+}
+interface QueryBuilderOperation {
+    id: string;
+    params: QueryBuilderOperationParamValue[];
+    disabled?: boolean;
+}
+interface QueryBuilderOperationDefinition<T = any> extends RegistryItem {
+    documentation?: string;
+    params: QueryBuilderOperationParamDef[];
+    defaultParams: QueryBuilderOperationParamValue[];
+    category: string;
+    hideFromList?: boolean;
+    alternativesKey?: string;
+    /** Can be used to control operation placement when adding a new operations, lower are placed first */
+    orderRank?: number;
+    renderer: QueryBuilderOperationRenderer;
+    addOperationHandler: QueryBuilderAddOperationHandler<T>;
+    paramChangedHandler?: QueryBuilderOnParamChangedHandler;
+    explainHandler?: QueryBuilderExplainOperationHandler;
+    changeTypeHandler?: (op: QueryBuilderOperation, newDef: QueryBuilderOperationDefinition<T>) => QueryBuilderOperation;
+    toggleable?: boolean;
+}
+type QueryBuilderAddOperationHandler<T> = (def: QueryBuilderOperationDefinition, query: T, modeller: VisualQueryModeller) => T;
+type QueryBuilderExplainOperationHandler = (op: QueryBuilderOperation, def?: QueryBuilderOperationDefinition) => string;
+type QueryBuilderOnParamChangedHandler = (index: number, operation: QueryBuilderOperation, operationDef: QueryBuilderOperationDefinition) => QueryBuilderOperation;
+type QueryBuilderOperationRenderer = (model: QueryBuilderOperation, def: QueryBuilderOperationDefinition, innerQuery: string) => string;
+type QueryBuilderOperationParamValue = string | number | boolean;
+interface QueryBuilderOperationParamDef {
+    name: string;
+    type: 'string' | 'number' | 'boolean';
+    options?: string[] | number[] | Array<SelectableValue<string>>;
+    hideName?: boolean;
+    restParam?: boolean;
+    optional?: boolean;
     placeholder?: string;
-    /**
-     * Language hint for code editor components.
-     * Example: "promql", "logql", "traceql", "sql", "json"
-     */
-    language?: string;
-    /**
-     * Layout row index for item fields inside object arrays.
-     * Fields with the same row number are rendered horizontally.
-     * Fields without a row number use auto-layout:
-     * - ≤3 fields: all on one row
-     * - >3 fields: each on its own row
-     */
-    row?: number;
-    /**
-     * Accepted file types for fileUpload component.
-     * Uses HTML accept attribute format with leading dot.
-     * Example: [".json"]
-     */
-    accept?: string[];
-    /**
-     * Maps keys in an uploaded JSON file to target field IDs.
-     * Used by fileUpload to distribute parsed values to other form fields.
-     * Example: { "private_key": "secureJsonData.privateKey", "client_email": "jsonData.clientEmail" }
-     */
-    fileMapping?: Record<string, string>;
+    description?: string;
+    minWidth?: number;
+    editor?: FunctionComponent<QueryBuilderOperationParamEditorProps>;
+    runQueryOnEnter?: boolean;
 }
-type FieldValidationRule = PatternValidationRule | RangeValidationRule | LengthValidationRule | ItemCountValidationRule | AllowedValuesValidationRule | CustomValidationRule;
-interface BaseValidationRule {
-    /**
-     * Optional stable ID for the validation rule.
-     * Useful for docs, localization, and test snapshots.
-     */
-    id?: string;
-    /**
-     * Human-readable validation error message.
-     */
+interface QueryBuilderOperationParamEditorProps {
+    value?: QueryBuilderOperationParamValue;
+    paramDef: QueryBuilderOperationParamDef;
+    /** Parameter index */
+    index: number;
+    operation: QueryBuilderOperation;
+    operationId: string;
+    query: any;
+    datasource: DataSourceApi;
+    timeRange?: TimeRange;
+    onChange: (index: number, value: QueryBuilderOperationParamValue) => void;
+    onRunQuery: () => void;
+    queryModeller: VisualQueryModeller;
+}
+declare enum QueryEditorMode {
+    Code = "code",
+    Builder = "builder"
+}
+type QueryStats = {
+    bytes: number;
     message?: string;
+};
+interface VisualQueryModeller {
+    getOperationsForCategory(category: string): QueryBuilderOperationDefinition[];
+    getAlternativeOperations(key: string): QueryBuilderOperationDefinition[];
+    getCategories(): string[];
+    getOperationDefinition(id: string): QueryBuilderOperationDefinition | undefined;
+    renderQuery(query: VisualQuery, nested?: boolean): string;
+    renderLabels(labels: QueryBuilderLabelFilter[]): string;
+    innerQueryPlaceholder: string;
 }
-interface PatternValidationRule extends BaseValidationRule {
-    type: 'pattern';
-    pattern: string;
+interface VisualQueryBinary<T> {
+    operator: string;
+    vectorMatchesType?: 'on' | 'ignoring';
+    vectorMatches?: string;
+    query: T;
 }
-interface RangeValidationRule extends BaseValidationRule {
-    type: 'range';
-    min?: number;
-    max?: number;
+declare const BINARY_OPERATIONS_KEY = "Binary operations";
+interface VisualQuery {
+    metric?: string;
+    labels: QueryBuilderLabelFilter[];
+    operations: QueryBuilderOperation[];
+    binaryQueries?: Array<VisualQueryBinary<VisualQuery>>;
+}
+
+declare abstract class QueryModellerBase implements VisualQueryModeller {
+    protected operationsRegistry: Registry<QueryBuilderOperationDefinition>;
+    private categories;
+    innerQueryPlaceholder: string;
+    constructor(operationDefinitions: QueryBuilderOperationDefinition[], innerQueryPlaceholder?: string);
+    protected setOperationCategories(categories: string[]): void;
+    abstract renderOperations(queryString: string, operations: QueryBuilderOperation[]): string;
+    abstract renderBinaryQueries(queryString: string, binaryQueries?: Array<VisualQueryBinary<VisualQuery>>): string;
+    abstract renderLabels(labels: QueryBuilderLabelFilter[]): string;
+    abstract renderQuery(query: VisualQuery, nested?: boolean): string;
+    getOperationsForCategory(category: string): QueryBuilderOperationDefinition<any>[];
+    getAlternativeOperations(key: string): QueryBuilderOperationDefinition<any>[];
+    getCategories(): string[];
+    getOperationDefinition(id: string): QueryBuilderOperationDefinition | undefined;
+    hasBinaryOp(query: VisualQuery): boolean;
+}
+
+interface Props$8 {
+    labelsFilters: QueryBuilderLabelFilter[];
+    onChange: (labelFilters: QueryBuilderLabelFilter[]) => void;
+    onGetLabelNames: (forLabel: Partial<QueryBuilderLabelFilter>) => Promise<SelectableValue[]>;
+    onGetLabelValues: (forLabel: Partial<QueryBuilderLabelFilter>) => Promise<SelectableValue[]>;
+    /** If set to true, component will show error message until at least 1 filter is selected */
+    labelFilterRequired?: boolean;
+    multiValueSeparator?: string;
+}
+declare function LabelFilters({ labelsFilters, onChange, onGetLabelNames, onGetLabelValues, labelFilterRequired, multiValueSeparator, }: Props$8): React.JSX.Element;
+
+interface Props$7 {
+    title?: React.ReactNode;
+    markdown?: string;
+    stepNumber?: number;
+}
+declare function OperationExplainedBox({ title, stepNumber, markdown, children }: React.PropsWithChildren<Props$7>): React.JSX.Element;
+
+interface Props$6<T extends VisualQuery> {
+    query: T;
+    datasource: DataSourceApi;
+    onChange: (query: T) => void;
+    onRunQuery: () => void;
+    queryModeller: VisualQueryModeller;
+    explainMode?: boolean;
+    highlightedOp?: QueryBuilderOperation;
+    timeRange?: TimeRange;
+    isConflictingOperation?: (operation: QueryBuilderOperation, otherOperations: QueryBuilderOperation[]) => boolean;
 }
-interface LengthValidationRule extends BaseValidationRule {
-    type: 'length';
-    min?: number;
-    max?: number;
+declare function OperationList<T extends VisualQuery>({ query, datasource, queryModeller, onChange, onRunQuery, highlightedOp, timeRange, isConflictingOperation, }: Props$6<T>): React.JSX.Element;
+
+interface Props$5<T extends VisualQuery> {
+    query: T;
+    queryModeller: VisualQueryModeller;
+    explainMode?: boolean;
+    stepNumber: number;
+    language: {
+        grammar: Grammar;
+        name: string;
+    };
+    onMouseEnter?: (op: QueryBuilderOperation, index: number) => void;
+    onMouseLeave?: (op: QueryBuilderOperation, index: number) => void;
 }
-interface ItemCountValidationRule extends BaseValidationRule {
-    type: 'itemCount';
-    min?: number;
-    max?: number;
+declare function OperationListExplained<T extends VisualQuery>({ query, queryModeller, stepNumber, language, onMouseEnter, onMouseLeave, }: Props$5<T>): React.JSX.Element;
+
+declare function OperationsEditorRow({ children }: React.PropsWithChildren<{}>): React.JSX.Element;
+
+interface Props$4<TVisualQuery extends VisualQuery, TDataQuery extends DataQuery$1> {
+    query: TVisualQuery;
+    datasource: DataSourceApi<TDataQuery>;
+    queryModeller: VisualQueryModeller;
+    buildVisualQueryFromString: (queryString: string) => {
+        query: TVisualQuery;
+    };
+    buildDataQueryFromQueryString: (queryString: string) => TDataQuery;
+    buildQueryStringFromDataQuery: (dataQuery: TDataQuery) => string;
+    onChange: (update: TVisualQuery) => void;
+    data?: PanelData;
 }
-interface AllowedValuesValidationRule extends BaseValidationRule {
-    type: 'allowedValues';
-    values: unknown[];
+declare const QueryBuilderHints: {
+    <TVisualQuery extends VisualQuery, TDataQuery extends DataQuery$1>({ datasource, query: visualQuery, onChange, data, queryModeller, buildVisualQueryFromString, buildDataQueryFromQueryString, buildQueryStringFromDataQuery, }: Props$4<TVisualQuery, TDataQuery>): React.JSX.Element;
+    displayName: string;
+};
+
+interface Props$3 {
+    mode: QueryEditorMode;
+    onChange: (mode: QueryEditorMode) => void;
 }
-interface CustomValidationRule extends BaseValidationRule {
-    type: 'custom';
-    /**
-     * CEL expression.
-     *
-     * Should evaluate to true when the field value is valid.
-     */
-    expression: Expression;
+declare function QueryEditorModeToggle({ mode, onChange }: Props$3): React.JSX.Element;
+
+interface Props$2 extends Omit<HTMLProps<HTMLInputElement>, 'value' | 'ref'> {
+    value?: boolean;
+    label: string;
 }
-interface FieldOverride {
-    /**
-     * CEL condition
-     */
-    when: Expression;
-    defaultValue?: unknown;
-    /**
-     * When true, the field is disabled/read-only while this override is active.
-     */
-    readOnly?: boolean;
-    description?: string;
-    placeholder?: string;
-    tooltip?: string;
-    validations?: FieldValidationRule[];
-    options?: FieldOption[];
-    /**
-     * When present on an `isItemField` field, the value is routed to
-     * `secureJsonData` under the resolved key instead of being stored
-     * inline in the parent array.
-     *
-     * The template string supports placeholders:
-     * - `{index}`  — 0-based array position
-     * - `{index1}` — 1-based array position
-     * - `{item.KEY}` — value of sibling item field `KEY`
-     *
-     * Examples:
-     * - `"secureHttpHeaders.{item.name}"` (ClickHouse)
-     * - `"httpHeaderValue{index1}"` (Grafana core headers)
-     */
-    secureKey?: string;
+declare function QueryHeaderSwitch({ label, ...inputProps }: Props$2): React.JSX.Element;
+
+interface Props$1 {
+    title: string;
+    collapsedInfo: string[];
+    queryStats?: QueryStats | null;
 }
-/**
- * Declares that when a field's value matches a condition,
- * listed target fields should be set to specified values.
- *
- * Use "value" in the `when` expression to refer to the field's value.
- */
-interface FieldEffect {
-    /**
-     * CEL expression. Example: "value == 'basic-auth'"
-     */
-    when: Expression;
-    /**
-     * Maps field IDs to the values they should be set to.
-     * Must contain at least one entry.
-     */
-    set: Record<string, unknown> & {
-        [k: string]: unknown;
+declare function QueryOptionGroup({ title, children, collapsedInfo, queryStats }: React.PropsWithChildren<Props$1>): React.JSX.Element;
+
+interface Props {
+    query: string;
+    language: {
+        grammar: Grammar;
+        name: string;
     };
+    className?: string;
 }
-type StorageMapping = DirectMapping | IndexedPairMapping | ComputedMapping;
-/**
- * Direct mapping
- */
-interface DirectMapping {
-    type: 'direct';
+declare function RawQuery({ query, language, className }: Props): React.JSX.Element;
+
+interface CustomMeta {
+    queryID: string;
+    status: string;
 }
-/**
- * Indexed pair mapping (headers)
- */
-interface IndexedPairMapping {
-    type: 'indexedPair';
-    key: MappingField;
-    value: MappingField;
-    startIndex?: number;
+interface RunningQueryInfo {
+    queryID?: string;
+    shouldCancel?: boolean;
 }
-/**
- * Computed mapping (virtual fields).
- * At least one of `read` or `write` must be provided.
- */
-type ComputedMapping = {
-    type: 'computed';
-    read: Expression;
-    write?: Expression;
-} | {
-    type: 'computed';
-    read?: Expression;
-    write: Expression;
-};
-/**
- * Mapping field
- */
-interface MappingField {
-    target: TargetLocation;
-    pattern: string;
+declare class DatasourceWithAsyncBackend<TQuery extends DataQuery$1 = DataQuery$1, TOptions extends DataSourceJsonData = DataSourceJsonData> extends DataSourceWithBackend<TQuery, TOptions> {
+    private runningQueries;
+    private requestCounter;
+    private requestIdPrefix;
+    constructor(instanceSettings: DataSourceInstanceSettings<TOptions>);
+    query(request: DataQueryRequest<TQuery>): Observable<DataQueryResponse>;
+    storeQuery(target: TQuery, queryInfo: RunningQueryInfo): void;
+    getQuery(target: TQuery): RunningQueryInfo;
+    removeQuery(target: TQuery): void;
+    doSingle(target: TQuery, request: DataQueryRequest<TQuery>): Observable<DataQueryResponse>;
+    cancel: (target: TQuery) => void;
 }
-interface FieldOption {
-    label: string;
-    /**
-     * Must match parent field valueType.
-     * Must not be null.
-     */
-    value: NonNullable<unknown>;
+
+interface RunQueryButtonsProps<TQuery extends DataQuery$1> {
+    enableRun?: boolean;
+    onRunQuery: () => void;
+    onCancelQuery: (query: TQuery) => void;
+    query: TQuery;
+    state?: LoadingState;
+}
+declare const RunQueryButtons: <TQuery extends DataQuery$1>(props: RunQueryButtonsProps<TQuery>) => React.JSX.Element;
+
+interface RequestLoopOptions<TQuery extends DataQuery$1 = DataQuery$1> {
     /**
-     * Optional human-readable description of the option.
+     * If the response needs an additional request to execute, return it here
      */
-    description?: string;
-}
-interface ConfigGroup {
-    id: string;
-    title: string;
-    description?: string;
-    order?: number;
+    getNextQuery: (rsp: DataQueryResponse) => TQuery | undefined;
     /**
-     * When true, the group is optional and can be collapsed/hidden by default.
+     * The datasource execute method
      */
-    optional?: boolean;
+    query: (req: DataQueryRequest<TQuery>) => Observable<DataQueryResponse>;
     /**
-     * References field IDs (not keys)
+     * Process the results
      */
-    fieldRefs: string[];
-}
-type RelationshipType = 'pair' | 'group' | 'datasourceReference';
-interface FieldRelationship {
-    type: RelationshipType;
+    process: (data: DataFrame[]) => DataFrame[];
     /**
-     * References field IDs
+     * Check if the query should be cancelled
      */
-    fields: string[];
-    description?: string;
+    shouldCancel: () => boolean;
     /**
-     * Constrains the datasource UID to a specific plugin type.
-     * Only applicable when type is "datasourceReference".
+     * Callback that gets executed when unsubscribed
      */
-    targetPluginType?: string;
-}
-type SecureFieldState = {
-    type: 'unset';
-} | {
-    type: 'configured';
-} | {
-    type: 'updated';
-    value: string;
-};
-interface FormState {
-    values: Record<string, unknown>;
-    secure: Record<string, SecureFieldState>;
+    onCancel: () => void;
 }
-
-declare function getConfigSchema(pluginType: string): Promise<DatasourceConfigSchema | null>;
-
-type ProvisioningYamlOptions = {
-    /** Include comments with field descriptions. Default: true for template, false for export. */
-    comments?: boolean;
-    /** Override the emitted datasource name. */
-    name?: string;
-};
-/**
- * Generate a Grafana provisioning YAML template from a dsconfig schema.
- * Emits every schema field with sensible defaults and (by default) explanatory comments.
- */
-declare function generateProvisioningTemplate(schema: DatasourceConfigSchema, options?: ProvisioningYamlOptions): string;
 /**
- * Generate provisioning YAML from an existing Grafana datasource API response.
- * If a dsconfig schema is available, uses it for field ordering and comments.
- * If not, generates basic YAML from the raw API response.
+ * Continue executing requests as long as `getNextQuery` returns a query
  */
-declare function datasourceToProvisioningYaml(ds: Record<string, unknown>, schema: DatasourceConfigSchema | null): string;
-declare const formatYamlDiff: (existing: Record<string, unknown>, body: Record<string, unknown>) => string;
+declare function getRequestLooper<T extends DataQuery$1 = DataQuery$1>(req: DataQueryRequest<T>, options: RequestLoopOptions<T>): Observable<DataQueryResponse>;
 
-export { AccessoryButton, AdvancedHttpSettings, Auth, AuthMethod, BINARY_OPERATIONS_KEY, CatalogSelector, CompletionItemInsertTextRule, CompletionItemKind, CompletionItemPriority, ConfigDescriptionLink, ConfigSection, ConfigSubSection, ConnectionSettings, CustomHeadersSettings, DataLink, DataLinks, DataSourceDescription, DataSourcePicker, DatasetSelector, DatasourceWithAsyncBackend, DatePicker, DatePickerWithInput, DebounceInput, EditorField, EditorFieldGroup, EditorHeader, EditorList, EditorMode, EditorRow, EditorRows, EditorStack, EditorSwitch, FlexItem, GroupByRow, InlineSelect, InputGroup, LabelFilters, LinkedToken, MacroType, OperationExplainedBox, OperationList, OperationListExplained, OperationsEditorRow, OperatorType, QUERY_FORMAT_OPTIONS, QueryBuilderHints, QueryEditorMode, QueryEditorModeToggle, QueryEditorRow, QueryFormat, QueryHeaderSwitch, QueryModellerBase, QueryOptionGroup, RawQuery, RunQueryButton, RunQueryButtons, SQLEditor, SQLEditorMode, SQLEditorTestUtils, SecureSocksProxyToggle, Segment, Space, SqlDatasource, SqlQueryEditor, StatementPosition, SuggestionKind, TLSSettings, TableSelector, TokenType, convertLegacyAuthProps, datasourceToProvisioningYaml, formatDate, formatYamlDiff, generateProvisioningTemplate, getConfigSchema, getRequestLooper, getStandardSQLCompletionProvider, language as grafanaStandardSQLLanguage, conf as grafanaStandardSQLLanguageConf, toOption };
-export type { Aggregate, AllowedValuesValidationRule, Props$c as AuthProps, BaseValidationRule, ColumnDefinition, ComputedMapping, ConfigField, ConfigGroup, CustomMeta, CustomValidationRule, DB, DataLinkConfig, DatasourceConfigSchema, DatePickerProps, DatePickerWithInputProps, DebounceInputProps, DirectMapping, Expression, FieldEffect, FieldItemSchema, FieldKind, FieldOption, FieldOverride, FieldRelationship, FieldUI, FieldValidationRule, FormState, IndexedPairMapping, ItemCountValidationRule, LanguageCompletionProvider, LanguageDefinition, LengthValidationRule, MappingField, MetaDefinition, NameValue, PatternValidationRule, PositionContext, Props$s as Props, QueryBuilderLabelFilter, QueryBuilderOperation, QueryBuilderOperationDefinition, QueryBuilderOperationParamDef, QueryBuilderOperationParamEditorProps, QueryBuilderOperationParamValue, QueryEditorProps, QueryRowFilter, QueryStats, QueryWithDefaults, RAQBFieldTypes, RangeValidationRule, RelationshipType, RequestLoopOptions, ResourceSelectorProps, ResponseParser, RunQueryButtonsProps, RunningQueryInfo, SQLConnectionLimits, SQLExpression, SQLFilters, SQLMonarchLanguage, SQLOptions, SQLQuery, SQLSelectableValue, SchemaDefinition, SecureFieldState, SegmentProps, SqlQueryForInterpolation, SqlQueryModel, State$1 as State, StatementPlacementProvider, StorageMapping, SuggestionKindProvider, Props$f as TLSSettingsProps, TableDefinition, TableFieldSchema, TableIdentifier, TableSchema, TargetLocation, TestQueryModel, UIComponent, UIWidth, ValidationResults, ValueType, VisualQuery, VisualQueryBinary, VisualQueryModeller };
+export { AUTH_GROUP_IDS, AccessoryButton, AdvancedHttpSettings, Auth, AuthMethod, BINARY_OPERATIONS_KEY, CatalogSelector, CompletionItemInsertTextRule, CompletionItemKind, CompletionItemPriority, ConfigDescriptionLink, ConfigSection, ConfigSubSection, ConnectionSettings, CustomHeadersSettings, DataLink, DataLinks, DataSourceDescription, DataSourcePicker, DatasetSelector, DatasourceConfigWizard, DatasourceErrorBoundary, DatasourceWithAsyncBackend, DatePicker, DatePickerWithInput, DebounceInput, EditorField, EditorFieldGroup, EditorHeader, EditorList, EditorMode, EditorRow, EditorRows, EditorStack, EditorSwitch, FlexItem, GroupByRow, InlineSelect, InputGroup, LabelFilters, LinkedToken, MacroType, OperationExplainedBox, OperationList, OperationListExplained, OperationsEditorRow, OperatorType, QUERY_FORMAT_OPTIONS, QueryBuilderHints, QueryEditorMode, QueryEditorModeToggle, QueryEditorRow, QueryFormat, QueryHeaderSwitch, QueryModellerBase, QueryOptionGroup, ROOT_CONFIG_FIELDS, RawQuery, RunQueryButton, RunQueryButtons, SQLEditor, SQLEditorMode, SQLEditorTestUtils, SecureSocksProxyToggle, Segment, Space, SqlDatasource, SqlQueryEditor, StatementPosition, SuggestionKind, TLSSettings, TableSelector, TokenType, buildCelContext, buildCloneDatasourcePayload, buildCreateDatasourcePayload, buildUpdateDatasourcePayload, clearExpressionCache, computeVirtualFieldValues, convertLegacyAuthProps, datasourceToProvisioningYaml, evaluateCelDirect, evaluateCelExpression, evaluateComputedRead, evaluateDependsOn, extractFieldRefs, formKey, formatDate, formatYamlDiff, generateLLMHint, generateProvisioningTemplate, generateTroubleshootingFields, getConfigSchema, getRequestLooper, getStandardSQLCompletionProvider, getWatchedValue, language as grafanaStandardSQLLanguage, conf as grafanaStandardSQLLanguageConf, isAuthGroupId, isValidCelExpression, parseDependsOn, resolveActiveOverride, resolveGroups, resolvePluginName, resolveRequiredFieldsGroup, toOption, useHealthChecks };
+export type { Aggregate, AllowedValuesValidationRule, Props$c as AuthProps, BaseFieldRef, BaseValidationRule, ColumnDefinition, ComputedMapping, ConfigField, ConfigGroup, CustomMeta, CustomValidationRule, DB, DataLinkConfig, DatasourceConfigSchema, DatasourceConfigWizardProps, DatasourceHealth, DatePickerProps, DatePickerWithInputProps, DebounceInputProps, DirectMapping, Expression, FieldEffect, FieldItemSchema, FieldKind, FieldOption, FieldOverride, FieldPack, FieldPackID, FieldPatch, FieldRelationship, FieldUI, FieldValidationRule, FormState, HealthState, IndexedPairMapping, Instruction, ItemCountValidationRule, LanguageCompletionProvider, LanguageDefinition, LengthValidationRule, MappingField, MetaDefinition, NameValue, PatternValidationRule, PositionContext, Props$s as Props, QueryBuilderLabelFilter, QueryBuilderOperation, QueryBuilderOperationDefinition, QueryBuilderOperationParamDef, QueryBuilderOperationParamEditorProps, QueryBuilderOperationParamValue, QueryEditorProps, QueryRowFilter, QueryStats, QueryWithDefaults, RAQBFieldTypes, RangeValidationRule, RelationshipType, RequestLoopOptions, ResolvedGroup, ResourceSelectorProps, ResponseParser, Role, RunQueryButtonsProps, RunningQueryInfo, SQLConnectionLimits, SQLExpression, SQLFilters, SQLMonarchLanguage, SQLOptions, SQLQuery, SQLSelectableValue, SchemaDefinition, SecureFieldState, SegmentProps, SqlQueryForInterpolation, SqlQueryModel, State$1 as State, StatementPlacementProvider, StorageMapping, SuggestionKindProvider, Props$f as TLSSettingsProps, TableDefinition, TableFieldSchema, TableIdentifier, TableSchema, TargetLocation, TestQueryModel, UIComponent, UIWidth, ValidationResults, ValueType, VisualQuery, VisualQueryBinary, VisualQueryModeller };