@grafana/plugin-ui 0.16.0-dsconfig.d7f2506 → 0.16.1

package/dist/cjs/index.d.cts

@@ -1,4 +1,4 @@
-import React, { ComponentProps, PureComponent, ReactElement, ReactNode, Component, ErrorInfo, FunctionComponent, HTMLProps } from 'react';
+import React, { ComponentProps, PureComponent, ReactElement, ReactNode, 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, DataFrameView, VariableModel, 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';
@@ -1014,1002 +1014,671 @@ type Props$a<C extends Config = Config> = {
 };
 declare const AdvancedHttpSettings: <C extends Config = Config>(props: Props$a<C>) => JSX.Element;
 
-interface DatasourceConfigSchema {
-    /**
-     * Schema version (required)
-     * Used for compatibility and migrations
-     *
-     * Example: "v2"
-     */
-    schemaVersion: string;
-    /**
-     * Unique datasource plugin identifier
-     * Example: "prometheus"
-     */
-    pluginType: string;
-    /**
-     * Human-readable name
-     */
-    pluginName: string;
-    /**
-     * 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
-     */
-    fields: ConfigField[];
-    /**
-     * Optional UI grouping
-     */
-    groups?: ConfigGroup[];
-    /**
-     * Optional instructions rendered alongside the config form.
-     */
-    instructions?: Instruction[];
-    /**
-     * Relationships between fields
-     */
-    relationships?: FieldRelationship[];
+interface CustomHeader {
+    id: string;
+    name: string;
+    value: string;
+    configured: boolean;
 }
-interface Instruction {
-    msg: string;
-    tags?: string[];
+type CustomHeaders = CustomHeader[];
+interface Props$9 {
+    dataSourceConfig: DataSourceSettings<any, any>;
+    onChange: (config: DataSourceSettings) => void;
 }
-/**
- * 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>;
+interface State {
+    headers: CustomHeaders;
 }
-/**
- * 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;
+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;
 }
-/**
- * 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 QueryBuilderLabelFilter {
+    label: string;
+    op: string;
+    value: string;
 }
-interface ConfigField {
-    /**
-     * Globally unique identifier
-     * Recommended format: dot-separated path
-     * Example: "auth.method", "httpHeaders.item.key"
-     */
+interface QueryBuilderOperation {
     id: string;
-    /**
-     * Local key used in storage or object
-     */
-    key: string;
-    /**
-     * UI metadata
-     */
-    label?: string;
-    description?: string;
-    docURL?: string;
-    /**
-     * Core type of the field
-     */
-    valueType: ValueType;
-    /**
-     * 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,
-     * target="jsonData", section="tracesToLogs", key="datasourceUid".
-     */
-    section?: string;
-    /**
-     * Field kind.
-     * @default "storage"
-     */
-    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;
+    params: QueryBuilderOperationParamValue[];
+    disabled?: boolean;
 }
-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[];
+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;
 }
-/**
- * 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;
+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.
-     */
-    message?: string;
+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;
 }
-interface PatternValidationRule extends BaseValidationRule {
-    type: 'pattern';
-    pattern: string;
+declare enum QueryEditorMode {
+    Code = "code",
+    Builder = "builder"
 }
-interface RangeValidationRule extends BaseValidationRule {
-    type: 'range';
-    min?: number;
-    max?: number;
+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 LengthValidationRule extends BaseValidationRule {
-    type: 'length';
-    min?: number;
-    max?: number;
+interface VisualQueryBinary<T> {
+    operator: string;
+    vectorMatchesType?: 'on' | 'ignoring';
+    vectorMatches?: string;
+    query: T;
 }
-interface ItemCountValidationRule extends BaseValidationRule {
-    type: 'itemCount';
-    min?: number;
-    max?: number;
+declare const BINARY_OPERATIONS_KEY = "Binary operations";
+interface VisualQuery {
+    metric?: string;
+    labels: QueryBuilderLabelFilter[];
+    operations: QueryBuilderOperation[];
+    binaryQueries?: Array<VisualQueryBinary<VisualQuery>>;
 }
-interface AllowedValuesValidationRule extends BaseValidationRule {
-    type: 'allowedValues';
-    values: unknown[];
+
+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 CustomValidationRule extends BaseValidationRule {
-    type: 'custom';
-    /**
-     * CEL expression.
-     *
-     * Should evaluate to true when the field value is valid.
-     */
-    expression: Expression;
+
+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;
 }
-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 LabelFilters({ labelsFilters, onChange, onGetLabelNames, onGetLabelValues, labelFilterRequired, multiValueSeparator, }: Props$8): React.JSX.Element;
+
+interface Props$7 {
+    title?: React.ReactNode;
+    markdown?: string;
+    stepNumber?: number;
 }
-/**
- * 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 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;
 }
-type StorageMapping = DirectMapping | IndexedPairMapping | ComputedMapping;
-/**
- * Direct mapping
- */
-interface DirectMapping {
-    type: 'direct';
+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;
 }
-/**
- * Indexed pair mapping (headers)
- */
-interface IndexedPairMapping {
-    type: 'indexedPair';
-    key: MappingField;
-    value: MappingField;
-    startIndex?: 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;
 }
-/**
- * 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;
+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;
 };
-/**
- * Mapping field
- */
-interface MappingField {
-    target: TargetLocation;
-    pattern: string;
+
+interface Props$3 {
+    mode: QueryEditorMode;
+    onChange: (mode: QueryEditorMode) => void;
 }
-interface FieldOption {
+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> {
     /**
-     * Must match parent field valueType.
-     * Must not be null.
-     */
-    value: NonNullable<unknown>;
-    /**
-     * Optional human-readable description of the option.
+     * If the response needs an additional request to execute, return it here
      */
-    description?: string;
+    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;
 }
-interface ConfigGroup {
-    id: string;
-    title: string;
-    description?: string;
-    order?: number;
+/**
+ * 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 {
     /**
-     * When true, the group is optional and can be collapsed/hidden by default.
+     * Schema version (required)
+     * Used for compatibility and migrations
+     *
+     * Example: "v2"
      */
-    optional?: boolean;
+    schemaVersion: string;
     /**
-     * References field IDs (not keys)
+     * Unique datasource plugin identifier
+     * Example: "prometheus"
      */
-    fieldRefs: string[];
+    pluginType: string;
+    /**
+     * Human-readable name
+     */
+    pluginName: string;
+    /**
+     * Optional documentation URL
+     */
+    docURL?: string;
+    /**
+     * Source of truth for configuration
+     */
+    fields: ConfigField[];
+    /**
+     * Optional UI grouping
+     */
+    groups?: ConfigGroup[];
+    /**
+     * Relationships between fields
+     */
+    relationships?: FieldRelationship[];
 }
-type RelationshipType = 'pair' | 'group' | 'datasourceReference';
-interface FieldRelationship {
-    type: RelationshipType;
+interface ConfigField {
     /**
-     * References field IDs
+     * Globally unique identifier
+     * Recommended format: dot-separated path
+     * Example: "auth.method", "httpHeaders.item.key"
      */
-    fields: string[];
+    id: string;
+    /**
+     * Local key used in storage or object
+     */
+    key: string;
+    /**
+     * UI metadata
+     */
+    label?: string;
     description?: string;
+    docURL?: string;
     /**
-     * Constrains the datasource UID to a specific plugin type.
-     * Only applicable when type is "datasourceReference".
+     * Core type of the field
      */
-    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;
-    mode?: 'tab' | 'wizard';
-    /** 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;
+    valueType: ValueType;
+    /**
+     * Storage location (required for storage fields)
+     */
+    target?: TargetLocation;
+    /**
+     * Dotted path prefix within the target for nested objects.
+     * Example: for jsonData.tracesToLogs.datasourceUid,
+     * target="jsonData", section="tracesToLogs", key="datasourceUid".
+     */
+    section?: string;
+    /**
+     * Field kind.
+     * @default "storage"
+     */
+    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;
 }
-
-type HealthState = 'pending' | 'checking' | 'done';
-interface DatasourceHealth {
-    state: HealthState;
-    status?: string;
-    message?: string;
+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[];
 }
 /**
- * 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.
+ * CEL expression string
  */
-declare function useHealthChecks(): {
-    healthMap: Record<string, DatasourceHealth>;
-    checkUids: (uids: string[]) => void;
-    retry: (uid: string) => void;
-};
-
-declare function resolvePluginName(pluginType: string): string;
-
+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';
 /**
- * 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;
-
-/**
- * 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): Array<{
-    label: string;
-    key: string;
-    target: string;
-    type: string;
-    required: boolean;
-    description?: string;
-    defaultValue?: unknown;
-    options?: string[];
-    section?: string;
-    dependsOn?: string;
-}>;
-
-type YamlRenderOptions = {
-    jsonDataKeys?: string[];
-    secureKeys?: string[];
-};
-type ProvisioningYamlOptions = {
-    /** Include comments with field descriptions. Default: true for template, false for export. */
-    comments?: boolean;
-    /** Name override (used in template mode). */
-    name?: string;
-};
-/**
- * Generate a Grafana provisioning YAML from a dsconfig schema.
- * In template mode (no values), emits all fields with defaults and comments.
- * When values are provided, emits actual values — used for existing datasource export.
- */
-declare function toProvisioningYaml(schema: DatasourceConfigSchema, values?: Record<string, unknown>, 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.
- */
-declare function datasourceToProvisioningYaml(ds: Record<string, unknown>, schema: DatasourceConfigSchema | null): string;
-declare const configToYaml: (ds: Record<string, unknown>, options?: YamlRenderOptions) => string;
-declare const formatYamlDiff: (existing: Record<string, unknown>, body: Record<string, unknown>) => string;
-
-type UseDatasourceSchemaResult = {
-    schema: DatasourceConfigSchema | null;
-    loading: boolean;
-    error: string | null;
-};
-declare function useDatasourceSchema(pluginType: string): UseDatasourceSchemaResult;
-declare function fetchConfigSchema(pluginType: string): Promise<DatasourceConfigSchema | null>;
-
-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.
+ * UI configuration
  */
-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;
+interface FieldUI {
+    component: UIComponent;
+    multiline?: boolean;
+    rows?: number;
+    options?: FieldOption[];
+    allowCustom?: boolean;
+    width?: UIWidth;
     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;
+    /**
+     * 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>;
 }
-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;
+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.
+     */
+    message?: string;
 }
-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 PatternValidationRule extends BaseValidationRule {
+    type: 'pattern';
+    pattern: string;
 }
-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 RangeValidationRule extends BaseValidationRule {
+    type: 'range';
+    min?: number;
+    max?: number;
 }
-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 LengthValidationRule extends BaseValidationRule {
+    type: 'length';
+    min?: number;
+    max?: number;
 }
-declare function QueryEditorModeToggle({ mode, onChange }: Props$3): React.JSX.Element;
-
-interface Props$2 extends Omit<HTMLProps<HTMLInputElement>, 'value' | 'ref'> {
-    value?: boolean;
-    label: string;
+interface ItemCountValidationRule extends BaseValidationRule {
+    type: 'itemCount';
+    min?: number;
+    max?: number;
 }
-declare function QueryHeaderSwitch({ label, ...inputProps }: Props$2): React.JSX.Element;
-
-interface Props$1 {
-    title: string;
-    collapsedInfo: string[];
-    queryStats?: QueryStats | null;
+interface AllowedValuesValidationRule extends BaseValidationRule {
+    type: 'allowedValues';
+    values: 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;
+interface CustomValidationRule extends BaseValidationRule {
+    type: 'custom';
+    /**
+     * CEL expression.
+     *
+     * Should evaluate to true when the field value is valid.
+     */
+    expression: Expression;
 }
-declare function RawQuery({ query, language, className }: Props): React.JSX.Element;
-
-interface CustomMeta {
-    queryID: string;
-    status: 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;
 }
-interface RunningQueryInfo {
-    queryID?: string;
-    shouldCancel?: boolean;
+/**
+ * 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 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;
+type StorageMapping = DirectMapping | IndexedPairMapping | ComputedMapping;
+/**
+ * Direct mapping
+ */
+interface DirectMapping {
+    type: 'direct';
 }
-
-interface RunQueryButtonsProps<TQuery extends DataQuery$1> {
-    enableRun?: boolean;
-    onRunQuery: () => void;
-    onCancelQuery: (query: TQuery) => void;
-    query: TQuery;
-    state?: LoadingState;
+/**
+ * Indexed pair mapping (headers)
+ */
+interface IndexedPairMapping {
+    type: 'indexedPair';
+    key: MappingField;
+    value: MappingField;
+    startIndex?: number;
 }
-declare const RunQueryButtons: <TQuery extends DataQuery$1>(props: RunQueryButtonsProps<TQuery>) => React.JSX.Element;
-
-interface RequestLoopOptions<TQuery extends DataQuery$1 = DataQuery$1> {
+/**
+ * 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;
     /**
-     * If the response needs an additional request to execute, return it here
+     * Must match parent field valueType.
+     * Must not be null.
      */
-    getNextQuery: (rsp: DataQueryResponse) => TQuery | undefined;
+    value: NonNullable<unknown>;
     /**
-     * The datasource execute method
+     * Optional human-readable description of the option.
      */
-    query: (req: DataQueryRequest<TQuery>) => Observable<DataQueryResponse>;
+    description?: string;
+}
+interface ConfigGroup {
+    id: string;
+    title: string;
+    description?: string;
+    order?: number;
     /**
-     * Process the results
+     * When true, the group is optional and can be collapsed/hidden by default.
      */
-    process: (data: DataFrame[]) => DataFrame[];
+    optional?: boolean;
     /**
-     * Check if the query should be cancelled
+     * References field IDs (not keys)
      */
-    shouldCancel: () => boolean;
+    fieldRefs: string[];
+}
+type RelationshipType = 'pair' | 'group' | 'datasourceReference';
+interface FieldRelationship {
+    type: RelationshipType;
     /**
-     * Callback that gets executed when unsubscribed
+     * References field IDs
      */
-    onCancel: () => void;
+    fields: string[];
+    description?: string;
+    /**
+     * Constrains the datasource UID to a specific plugin type.
+     * Only applicable when type is "datasourceReference".
+     */
+    targetPluginType?: string;
+}
+type SecureFieldState = {
+    type: 'unset';
+} | {
+    type: 'configured';
+} | {
+    type: 'updated';
+    value: string;
+};
+interface FormState {
+    values: Record<string, unknown>;
+    secure: Record<string, SecureFieldState>;
 }
+
 /**
- * Continue executing requests as long as `getNextQuery` returns a query
+ * Bundled datasource config schemas, used as a fallback when a schema cannot be
+ * fetched from the Grafana plugins CDN (for example, when the CDN returns 404).
  */
-declare function getRequestLooper<T extends DataQuery$1 = DataQuery$1>(req: DataQueryRequest<T>, options: RequestLoopOptions<T>): Observable<DataQueryResponse>;
+declare const staticSchemaRegistry: Map<string, DatasourceConfigSchema>;
+/**
+ * Returns the bundled fallback schema for a plugin type, or `null` if none is
+ * bundled.
+ */
+declare function getStaticConfigSchema(pluginType: string): DatasourceConfigSchema | null;
+
+declare function getConfigSchemaUrl(pluginType: string): string;
+declare function getConfigSchema(pluginType: string): Promise<DatasourceConfigSchema | null>;
 
-export { AUTH_GROUP_IDS, AccessoryButton, AdvancedHttpSettings, type Aggregate, type AllowedValuesValidationRule, Auth, AuthMethod, type Props$c as AuthProps, BINARY_OPERATIONS_KEY, type BaseFieldRef, type BaseValidationRule, CatalogSelector, type ColumnDefinition, CompletionItemInsertTextRule, CompletionItemKind, CompletionItemPriority, type ComputedMapping, ConfigDescriptionLink, type ConfigField, type ConfigGroup, ConfigSection, ConfigSubSection, ConnectionSettings, CustomHeadersSettings, type CustomMeta, type CustomValidationRule, type DB, DataLink, type DataLinkConfig, DataLinks, DataSourceDescription, DataSourcePicker, DatasetSelector, type DatasourceConfigSchema, DatasourceConfigWizard, type DatasourceConfigWizardProps, DatasourceErrorBoundary, type DatasourceHealth, DatasourceWithAsyncBackend, DatePicker, type DatePickerProps, DatePickerWithInput, type DatePickerWithInputProps, DebounceInput, type DebounceInputProps, type DirectMapping, EditorField, EditorFieldGroup, EditorHeader, EditorList, EditorMode, EditorRow, EditorRows, EditorStack, EditorSwitch, type Expression, type FieldEffect, type FieldItemSchema, type FieldKind, type FieldOption, type FieldOverride, type FieldPack, type FieldPackID, type FieldPatch, type FieldRelationship, type FieldUI, type FieldValidationRule, FlexItem, type FormState, GroupByRow, type HealthState, type IndexedPairMapping, InlineSelect, InputGroup, type Instruction, type ItemCountValidationRule, LabelFilters, type LanguageCompletionProvider, type LanguageDefinition, type LengthValidationRule, LinkedToken, MacroType, type MappingField, type MetaDefinition, type NameValue, OperationExplainedBox, OperationList, OperationListExplained, OperationsEditorRow, OperatorType, type PatternValidationRule, type PositionContext, type Props$s as Props, type ProvisioningYamlOptions, QUERY_FORMAT_OPTIONS, QueryBuilderHints, type QueryBuilderLabelFilter, type QueryBuilderOperation, type QueryBuilderOperationDefinition, type QueryBuilderOperationParamDef, type QueryBuilderOperationParamEditorProps, type QueryBuilderOperationParamValue, QueryEditorMode, QueryEditorModeToggle, type QueryEditorProps, QueryEditorRow, QueryFormat, QueryHeaderSwitch, QueryModellerBase, QueryOptionGroup, type QueryRowFilter, type QueryStats, type QueryWithDefaults, type RAQBFieldTypes, ROOT_CONFIG_FIELDS, type RangeValidationRule, RawQuery, type RelationshipType, type RequestLoopOptions, type ResolvedGroup, type ResourceSelectorProps, type ResponseParser, type Role, RunQueryButton, RunQueryButtons, type RunQueryButtonsProps, type RunningQueryInfo, type SQLConnectionLimits, SQLEditor, SQLEditorMode, SQLEditorTestUtils, type SQLExpression, type SQLFilters, type SQLMonarchLanguage, type SQLOptions, type SQLQuery, type SQLSelectableValue, type SchemaDefinition, type SecureFieldState, SecureSocksProxyToggle, Segment, type SegmentProps, Space, SqlDatasource, SqlQueryEditor, type SqlQueryForInterpolation, type SqlQueryModel, type State$1 as State, type StatementPlacementProvider, StatementPosition, type StorageMapping, SuggestionKind, type SuggestionKindProvider, TLSSettings, type Props$f as TLSSettingsProps, type TableDefinition, type TableFieldSchema, type TableIdentifier, type TableSchema, TableSelector, type TargetLocation, type TestQueryModel, TokenType, type UIComponent, type UIWidth, type ValidationResults, type ValueType, type VisualQuery, type VisualQueryBinary, type VisualQueryModeller, buildCelContext, buildCloneDatasourcePayload, buildCreateDatasourcePayload, buildUpdateDatasourcePayload, clearExpressionCache, computeVirtualFieldValues, configToYaml, convertLegacyAuthProps, datasourceToProvisioningYaml, evaluateCelDirect, evaluateCelExpression, evaluateComputedRead, evaluateDependsOn, extractFieldRefs, fetchConfigSchema, formKey, formatDate, formatYamlDiff, generateLLMHint, generateTroubleshootingFields, getConfigSchema, getRequestLooper, getStandardSQLCompletionProvider, getWatchedValue, language as grafanaStandardSQLLanguage, conf as grafanaStandardSQLLanguageConf, isAuthGroupId, isValidCelExpression, parseDependsOn, resolveActiveOverride, resolveGroups, resolvePluginName, resolveRequiredFieldsGroup, toOption, toProvisioningYaml, useDatasourceSchema, useHealthChecks };
+export { AccessoryButton, AdvancedHttpSettings, type Aggregate, type AllowedValuesValidationRule, Auth, AuthMethod, type Props$c as AuthProps, BINARY_OPERATIONS_KEY, type BaseValidationRule, CatalogSelector, type ColumnDefinition, CompletionItemInsertTextRule, CompletionItemKind, CompletionItemPriority, type ComputedMapping, ConfigDescriptionLink, type ConfigField, type ConfigGroup, ConfigSection, ConfigSubSection, ConnectionSettings, CustomHeadersSettings, type CustomMeta, type CustomValidationRule, type DB, DataLink, type DataLinkConfig, DataLinks, DataSourceDescription, DataSourcePicker, DatasetSelector, type DatasourceConfigSchema, DatasourceWithAsyncBackend, DatePicker, type DatePickerProps, DatePickerWithInput, type DatePickerWithInputProps, DebounceInput, type DebounceInputProps, type DirectMapping, EditorField, EditorFieldGroup, EditorHeader, EditorList, EditorMode, EditorRow, EditorRows, EditorStack, EditorSwitch, type Expression, type FieldEffect, type FieldItemSchema, type FieldKind, type FieldOption, type FieldOverride, type FieldRelationship, type FieldUI, type FieldValidationRule, FlexItem, type FormState, GroupByRow, type IndexedPairMapping, InlineSelect, InputGroup, type ItemCountValidationRule, LabelFilters, type LanguageCompletionProvider, type LanguageDefinition, type LengthValidationRule, LinkedToken, MacroType, type MappingField, type MetaDefinition, type NameValue, OperationExplainedBox, OperationList, OperationListExplained, OperationsEditorRow, OperatorType, type PatternValidationRule, type PositionContext, type Props$s as Props, QUERY_FORMAT_OPTIONS, QueryBuilderHints, type QueryBuilderLabelFilter, type QueryBuilderOperation, type QueryBuilderOperationDefinition, type QueryBuilderOperationParamDef, type QueryBuilderOperationParamEditorProps, type QueryBuilderOperationParamValue, QueryEditorMode, QueryEditorModeToggle, type QueryEditorProps, QueryEditorRow, QueryFormat, QueryHeaderSwitch, QueryModellerBase, QueryOptionGroup, type QueryRowFilter, type QueryStats, type QueryWithDefaults, type RAQBFieldTypes, type RangeValidationRule, RawQuery, type RelationshipType, type RequestLoopOptions, type ResourceSelectorProps, type ResponseParser, RunQueryButton, RunQueryButtons, type RunQueryButtonsProps, type RunningQueryInfo, type SQLConnectionLimits, SQLEditor, SQLEditorMode, SQLEditorTestUtils, type SQLExpression, type SQLFilters, type SQLMonarchLanguage, type SQLOptions, type SQLQuery, type SQLSelectableValue, type SchemaDefinition, type SecureFieldState, SecureSocksProxyToggle, Segment, type SegmentProps, Space, SqlDatasource, SqlQueryEditor, type SqlQueryForInterpolation, type SqlQueryModel, type State$1 as State, type StatementPlacementProvider, StatementPosition, type StorageMapping, SuggestionKind, type SuggestionKindProvider, TLSSettings, type Props$f as TLSSettingsProps, type TableDefinition, type TableFieldSchema, type TableIdentifier, type TableSchema, TableSelector, type TargetLocation, type TestQueryModel, TokenType, type UIComponent, type UIWidth, type ValidationResults, type ValueType, type VisualQuery, type VisualQueryBinary, type VisualQueryModeller, convertLegacyAuthProps, formatDate, getConfigSchema, getConfigSchemaUrl, getRequestLooper, getStandardSQLCompletionProvider, getStaticConfigSchema, language as grafanaStandardSQLLanguage, conf as grafanaStandardSQLLanguageConf, staticSchemaRegistry, toOption };