@grafana/plugin-ui 0.14.0-dev.1 → 0.14.1-dsconfig.0d5c985

package/dist/cjs/index.d.cts

@@ -4,6 +4,7 @@ import { DataSourceInstanceSettings, SelectableValue, DataSourceJsonData, Variab
 import { DataSourceSrv, DataSourceWithBackend, TemplateSrv } from '@grafana/runtime';
 import { JsonTree } from '@react-awesome-query-builder/ui';
 import { DataQuery } from '@grafana/schema';
+import { SqlLanguage } from 'sql-formatter';
 import { Grammar } from 'prismjs';
 
 interface QueryEditorRowProps {
@@ -99,9 +100,6 @@ type Props$q = {
 };
 declare const DataLink: (props: Props$q) => React.JSX.Element;
 
-declare function applyQueryDefaults(q?: SQLQuery): SQLQuery;
-type QueryWithDefaults = ReturnType<typeof applyQueryDefaults>;
-
 declare enum QueryEditorPropertyType {
     String = "string"
 }
@@ -136,6 +134,21 @@ interface QueryEditorFunctionParameterExpression {
     name?: string;
 }
 
+declare enum TokenType {
+    Parenthesis = "delimiter.parenthesis.sql",
+    Whitespace = "white.sql",
+    Keyword = "keyword.sql",
+    Delimiter = "delimiter.sql",
+    Operator = "operator.sql",
+    Identifier = "identifier.sql",
+    IdentifierQuote = "identifier.quote.sql",
+    Type = "type.sql",
+    Function = "predefined.sql",
+    Number = "number.sql",
+    String = "string.sql",
+    Variable = "variable.sql"
+}
+
 declare class LinkedToken {
     type: string;
     value: string;
@@ -164,17 +177,6 @@ declare class LinkedToken {
     getNextOfType(type: TokenType, value?: string): LinkedToken | null;
 }
 
-type StatementPositionResolver = (currentToken: LinkedToken | null, previousKeyword: LinkedToken | null, previousNonWhiteSpace: LinkedToken | null, previousIsSlash: Boolean) => Boolean;
-type SuggestionsResolver = <T extends PositionContext = PositionContext>(positionContext: T) => Promise<CustomSuggestion[]>;
-interface SQLMonarchLanguage extends monacoTypes.languages.IMonarchLanguage {
-    keywords?: string[];
-    builtinFunctions?: string[];
-    logicalOperators?: string[];
-    comparisonOperators?: string[];
-    /** Used by basic languages in the monaco registry **/
-    operators?: string[];
-}
-
 /**
  * Provides a context for suggestions resolver
  * @alpha
@@ -290,7 +292,25 @@ interface SQLCompletionItemProvider extends Omit<monacoTypes.languages.Completio
      */
     provideCompletionItems?: (model: monacoTypes.editor.ITextModel, position: monacoTypes.Position, context: monacoTypes.languages.CompletionContext, token: monacoTypes.CancellationToken, positionContext: PositionContext) => monacoTypes.languages.CompletionList;
 }
+interface SQLMonarchLanguage extends monacoTypes.languages.IMonarchLanguage {
+    keywords?: string[];
+    builtinFunctions?: string[];
+    logicalOperators?: string[];
+    comparisonOperators?: string[];
+    /** Used by basic languages in the monaco registry **/
+    operators?: string[];
+}
+type StatementPositionResolver = (currentToken: LinkedToken | null, previousKeyword: LinkedToken | null, previousNonWhiteSpace: LinkedToken | null, previousIsSlash: Boolean) => Boolean;
+type SuggestionsResolver = <T extends PositionContext = PositionContext>(positionContext: T) => Promise<CustomSuggestion[]>;
 type LanguageCompletionProvider = (m: Monaco, l?: SQLMonarchLanguage) => SQLCompletionItemProvider;
+interface LanguageDefinition extends monacoTypes.languages.ILanguageExtensionPoint {
+    loader?: (module: any) => Promise<{
+        language: SQLMonarchLanguage;
+        conf: monacoTypes.languages.LanguageConfiguration;
+    }>;
+    completionProvider?: (m: Monaco, language: SQLMonarchLanguage) => SQLCompletionItemProvider;
+    formatter?: (q: string) => string;
+}
 declare enum OperatorType {
     Comparison = 0,
     Logical = 1
@@ -302,20 +322,7 @@ declare enum MacroType {
     Column = 3,
     Table = 4
 }
-declare enum TokenType {
-    Parenthesis = "delimiter.parenthesis.sql",
-    Whitespace = "white.sql",
-    Keyword = "keyword.sql",
-    Delimiter = "delimiter.sql",
-    Operator = "operator.sql",
-    Identifier = "identifier.sql",
-    IdentifierQuote = "identifier.quote.sql",
-    Type = "type.sql",
-    Function = "predefined.sql",
-    Number = "number.sql",
-    String = "string.sql",
-    Variable = "variable.sql"
-}
+
 declare enum StatementPosition {
     Unknown = "unknown",
     SelectKeyword = "selectKeyword",
@@ -417,14 +424,6 @@ declare enum SQLEditorMode {
     Code = "code"
 }
 
-interface LanguageDefinition extends monacoTypes.languages.ILanguageExtensionPoint {
-    loader?: (module: any) => Promise<{
-        language: SQLMonarchLanguage;
-        conf: monacoTypes.languages.LanguageConfiguration;
-    }>;
-    completionProvider?: (m: Monaco, language: SQLMonarchLanguage) => SQLCompletionItemProvider;
-    formatter?: (q: string) => string;
-}
 interface SQLEditorProps {
     query: string;
     /**
@@ -640,6 +639,11 @@ interface MetaDefinition {
     completion?: string;
     kind: CompletionItemKind;
 }
+/**
+ * Represents a query with all default values applied.
+ * This is equivalent to SQLQuery since applyQueryDefaults returns SQLQuery.
+ */
+type QueryWithDefaults = SQLQuery;
 
 interface GroupByRowProps {
     sql: SQLExpression;
@@ -781,8 +785,9 @@ interface MetricFindQueryOptions extends SearchFilterOptions {
 }
 
 interface Props$p extends QueryEditorProps$1<SqlDatasource, SQLQuery, SQLOptions> {
+    language?: SqlLanguage;
 }
-declare function SqlQueryEditor({ datasource, query, onChange, onRunQuery, range }: Props$p): React.JSX.Element | null;
+declare function SqlQueryEditor({ datasource, query, onChange, onRunQuery, range, language }: Props$p): React.JSX.Element | null;
 
 type RunQueryButtonProps = {
     ariaLabel?: string;
@@ -1008,6 +1013,373 @@ 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;
+    /**
+     * Source of truth for configuration
+     */
+    fields: ConfigField[];
+    /**
+     * Optional UI grouping
+     */
+    groups?: ConfigGroup[];
+    /**
+     * Relationships between fields
+     */
+    relationships?: FieldRelationship[];
+}
+interface ConfigField {
+    /**
+     * Globally unique identifier
+     * Recommended format: dot-separated path
+     * Example: "auth.method", "httpHeaders.item.key"
+     */
+    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;
+    /**
+     * Semantic meaning (optional)
+     */
+    semanticType?: SemanticType;
+    /**
+     * 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;
+    /**
+     * Lifecycle state
+     */
+    lifecycle?: Lifecycle;
+    /**
+     * 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 SemanticType = 'url' | 'password' | 'token' | 'hostname' | 'duration' | 'datasourceUid' | 'query';
+type FieldKind = 'storage' | 'virtual';
+type Lifecycle = 'stable' | 'deprecated' | 'experimental';
+type TargetLocation = 'root' | 'jsonData' | 'secureJsonData';
+type UIComponent = 'input' | 'textarea' | 'select' | 'multiselect' | 'radio' | 'checkbox' | 'switch' | 'code' | 'keyvalue' | 'list';
+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;
+}
+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 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';
+    /**
+     * CEL expression.
+     *
+     * Should evaluate to true when the field value is valid.
+     */
+    expression: Expression;
+}
+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[];
+}
+/**
+ * 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;
+    };
+}
+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;
+    /**
+     * Must match parent field valueType.
+     * Must not be null.
+     */
+    value: NonNullable<unknown>;
+    /**
+     * Optional human-readable description of the option.
+     */
+    description?: string;
+}
+interface ConfigGroup {
+    id: string;
+    title: string;
+    description?: string;
+    order?: number;
+    /**
+     * When true, the group is optional and can be collapsed/hidden by default.
+     */
+    optional?: boolean;
+    /**
+     * References field IDs (not keys)
+     */
+    fieldRefs: string[];
+}
+type RelationshipType = 'pair' | 'group' | 'datasourceReference';
+interface FieldRelationship {
+    type: RelationshipType;
+    /**
+     * References field IDs
+     */
+    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>;
+}
+
+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;
+
 interface CustomHeader {
     id: string;
     name: string;
@@ -1232,4 +1604,158 @@ interface Props {
 }
 declare function RawQuery({ query, language, className }: Props): React.JSX.Element;
 
-export { AccessoryButton, AdvancedHttpSettings, type Aggregate, Auth, AuthMethod, type Props$c as AuthProps, BINARY_OPERATIONS_KEY, CatalogSelector, type ColumnDefinition, CompletionItemInsertTextRule, CompletionItemKind, CompletionItemPriority, ConfigDescriptionLink, ConfigSection, ConfigSubSection, ConnectionSettings, CustomHeadersSettings, type DB, DataLink, type DataLinkConfig, DataLinks, DataSourceDescription, DataSourcePicker, DatasetSelector, DatePicker, type DatePickerProps, DatePickerWithInput, type DatePickerWithInputProps, DebounceInput, type DebounceInputProps, EditorField, EditorFieldGroup, EditorHeader, EditorList, EditorMode, EditorRow, EditorRows, EditorStack, EditorSwitch, FlexItem, GroupByRow, InlineSelect, InputGroup, LabelFilters, type LanguageCompletionProvider, type LanguageDefinition, LinkedToken, MacroType, type MetaDefinition, type NameValue, OperationExplainedBox, OperationList, OperationListExplained, OperationsEditorRow, OperatorType, 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 RAQBFieldTypes, RawQuery, type ResourceSelectorProps, type ResponseParser, RunQueryButton, type SQLConnectionLimits, SQLEditor, SQLEditorMode, SQLEditorTestUtils, type SQLExpression, type SQLFilters, type SQLMonarchLanguage, type SQLOptions, type SQLQuery, type SQLSelectableValue, type SchemaDefinition, SecureSocksProxyToggle, Segment, type SegmentProps, Space, SqlDatasource, SqlQueryEditor, type SqlQueryForInterpolation, type SqlQueryModel, type State$1 as State, type StatementPlacementProvider, StatementPosition, SuggestionKind, type SuggestionKindProvider, TLSSettings, type Props$f as TLSSettingsProps, type TableDefinition, type TableFieldSchema, type TableIdentifier, type TableSchema, TableSelector, type TestQueryModel, TokenType, type ValidationResults, type VisualQuery, type VisualQueryBinary, type VisualQueryModeller, convertLegacyAuthProps, formatDate, getStandardSQLCompletionProvider, language as grafanaStandardSQLLanguage, conf as grafanaStandardSQLLanguageConf, toOption };
+/**
+ * Pure helper functions for working with DatasourceConfigSchema.
+ *
+ * Types are defined in schema.ts — import them from there directly.
+ */
+
+/**
+ * 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): Array<{
+    group: ConfigGroup;
+    fields: ConfigField[];
+}>;
+/**
+ * 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 "auth" group, 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): {
+    group: ConfigGroup;
+    fields: ConfigField[];
+} | 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;
+/**
+ * Parse a simple CEL-like dependsOn expression: "fieldId == 'value'" or "fieldId == true".
+ * Returns { field, value } or null if unparseable.
+ */
+declare function parseDependsOn(expr: string): {
+    field: string;
+    value: string;
+} | null;
+/**
+ * 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>;
+
+type DatasourceResponse = Record<string, unknown> & {
+    name: string;
+    id: number;
+    uid: string;
+    access?: 'proxy' | 'direct';
+    type?: string;
+    typeLogoUrl?: string;
+    url?: string;
+    withCredentials?: boolean;
+    basicAuth?: boolean;
+    basicAuthUser?: string;
+    user?: string;
+    database?: string;
+    jsonData?: Record<string, unknown>;
+    secureJsonFields?: Record<string, boolean>;
+    readOnly?: boolean;
+};
+type DatasourceConfigPayload = {
+    rootFields: Record<string, unknown>;
+    jsonData: Record<string, unknown>;
+    secureJsonData: Record<string, string>;
+    secureJsonFields: Record<string, boolean>;
+};
+type FormValues = Record<string, unknown>;
+
+declare const SECURE_FIELD_CONFIGURED = "__CONFIGURED__";
+type FetchExistingResult = {
+    values: FormValues;
+    readOnly: boolean;
+    error?: string;
+};
+/** Indexed pair item as stored in form values. Each item tracks its original storage index. */
+type IndexedPairItem = {
+    /** Original storage index (e.g. 1 for httpHeaderName1). 0 = new item, not yet persisted. */
+    index: number;
+    name: string;
+    value: string;
+};
+/**
+ * Expand indexed pair storage (e.g. httpHeaderName1..N / httpHeaderValue1..N)
+ * into an array of {index, name, value} items for the form.
+ * Each item's `index` tracks its storage position so deletes don't shift others.
+ * Scans all keys in the source record to find matching indices — no gap heuristics.
+ */
+declare function expandIndexedPair(field: ConfigField, ds: DatasourceResponse): IndexedPairItem[];
+/**
+ * Flatten an array of indexed pair items back into individual indexed keys
+ * for jsonData and secureJsonData.
+ */
+declare function flattenIndexedPair(field: ConfigField, items: IndexedPairItem[], jsonData: Record<string, unknown>, secureJsonData: Record<string, string>, secureJsonFields: Record<string, boolean>): void;
+declare function fetchExistingValues(dsUid: string, fields: ConfigField[]): Promise<FetchExistingResult>;
+declare function buildDatasourceConfigPayload(data: FormValues, fields: ConfigField[], existing: DatasourceResponse, isFieldVisible: (field: ConfigField) => boolean): DatasourceConfigPayload;
+declare function submitDatasourceConfig(dsUid: string, data: FormValues, fields: ConfigField[], isFieldVisible: (field: ConfigField) => boolean): Promise<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 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;
+
+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 CustomValidationRule, type DB, DataLink, type DataLinkConfig, DataLinks, DataSourceDescription, DataSourcePicker, DatasetSelector, type DatasourceConfigPayload, type DatasourceConfigSchema, DatasourceConfigWizard, type DatasourceConfigWizardProps, type DatasourceResponse, DatePicker, type DatePickerProps, DatePickerWithInput, type DatePickerWithInputProps, DebounceInput, type DebounceInputProps, type DirectMapping, EditorField, EditorFieldGroup, EditorHeader, EditorList, EditorMode, EditorRow, EditorRows, EditorStack, EditorSwitch, type Expression, type FetchExistingResult, type FieldEffect, type FieldItemSchema, type FieldKind, type FieldOption, type FieldOverride, type FieldRelationship, type FieldUI, type FieldValidationRule, FlexItem, type FormState, type FormValues, GroupByRow, type IndexedPairItem, type IndexedPairMapping, InlineSelect, InputGroup, type ItemCountValidationRule, LabelFilters, type LanguageCompletionProvider, type LanguageDefinition, type LengthValidationRule, type Lifecycle, 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, type RangeValidationRule, RawQuery, type RelationshipType, type ResourceSelectorProps, type ResponseParser, RunQueryButton, SECURE_FIELD_CONFIGURED, 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, type SemanticType, 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, buildDatasourceConfigPayload, computeVirtualFieldValues, convertLegacyAuthProps, datasourceToProvisioningYaml, evaluateComputedRead, expandIndexedPair, fetchExistingValues, flattenIndexedPair, formKey, formatDate, generateLLMHint, generateTroubleshootingFields, getStandardSQLCompletionProvider, language as grafanaStandardSQLLanguage, conf as grafanaStandardSQLLanguageConf, parseDependsOn, resolveActiveOverride, resolveGroups, resolveRequiredFieldsGroup, submitDatasourceConfig, toOption, toProvisioningYaml };

package/dist/esm/components/ConfigEditor/ConfigSection/ConfigDescriptionLink.js

@@ -6,7 +6,7 @@ import { useStyles2 } from '@grafana/ui';
 function ConfigDescriptionLink(props) {
   const { description, suffix, feature } = props;
   const text = `Learn more about ${feature}`;
-  const styles = useStyles2(getStyles$c);
+  const styles = useStyles2(getStyles$g);
   return /* @__PURE__ */ React.createElement("span", { className: styles.container }, description, /* @__PURE__ */ React.createElement(
     "a",
     {
@@ -18,7 +18,7 @@ function ConfigDescriptionLink(props) {
     text
   ));
 }
-const getStyles$c = (theme) => {
+const getStyles$g = (theme) => {
   return {
     container: css({
       color: theme.colors.text.secondary,