@grafana/plugin-ui 0.15.1 → 0.16.0

package/dist/cjs/index.d.cts

@@ -1295,4 +1295,390 @@ interface RequestLoopOptions<TQuery extends DataQuery$1 = DataQuery$1> {
  */
 declare function getRequestLooper<T extends DataQuery$1 = DataQuery$1>(req: DataQueryRequest<T>, options: RequestLoopOptions<T>): Observable<DataQueryResponse>;
 
-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 CustomMeta, type DB, DataLink, type DataLinkConfig, DataLinks, DataSourceDescription, DataSourcePicker, DatasetSelector, DatasourceWithAsyncBackend, 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 QueryWithDefaults, type RAQBFieldTypes, RawQuery, 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, 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, getRequestLooper, getStandardSQLCompletionProvider, language as grafanaStandardSQLLanguage, conf as grafanaStandardSQLLanguageConf, toOption };
+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;
+    /**
+     * 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;
+}
+interface FieldItemSchema {
+    /**
+     * Type of array items or map values.
+     * For arrays, describes each element.
+     * For maps, describes each value (keys are always strings).
+     */
+    valueType: ValueType;
+    /**
+     * Sub-fields for object items. Optional even when valueType = "object"
+     * (omitting allows an unconstrained object).
+     */
+    fields?: ConfigField[];
+}
+/**
+ * CEL expression string
+ */
+type Expression = string;
+type ValueType = 'string' | 'number' | 'boolean' | 'array' | 'object' | 'map' | 'any';
+type FieldKind = 'storage' | 'virtual';
+type TargetLocation = 'root' | 'jsonData' | 'secureJsonData';
+type UIComponent = 'input' | 'textarea' | 'select' | 'multiselect' | 'radio' | 'checkbox' | 'switch' | 'code' | 'keyvalue' | 'list' | 'fileUpload';
+type UIWidth = 'full' | 'half';
+/**
+ * UI configuration
+ */
+interface FieldUI {
+    component: UIComponent;
+    multiline?: boolean;
+    rows?: number;
+    options?: FieldOption[];
+    allowCustom?: boolean;
+    width?: UIWidth;
+    placeholder?: string;
+    /**
+     * Language hint for code editor components.
+     * Example: "promql", "logql", "traceql", "sql", "json"
+     */
+    language?: string;
+    /**
+     * Layout row index for item fields inside object arrays.
+     * Fields with the same row number are rendered horizontally.
+     * Fields without a row number use auto-layout:
+     * - ≤3 fields: all on one row
+     * - >3 fields: each on its own row
+     */
+    row?: number;
+    /**
+     * Accepted file types for fileUpload component.
+     * Uses HTML accept attribute format with leading dot.
+     * Example: [".json"]
+     */
+    accept?: string[];
+    /**
+     * 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>;
+}
+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[];
+    /**
+     * 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;
+}
+/**
+ * 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>;
+}
+
+/**
+ * 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 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 { 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 };