@intentius/chant-lexicon-grafana 0.98.0 → 0.100.0

package/dist/import/report.d.ts

@@ -0,0 +1,26 @@
+/** How the importers report what they could not carry: warnings, and the edits that make the source equal the rebuilt output. */
+import type { ImportEdit } from "./edits.js";
+/** `a`, `a and b`, `a, b and c`. */
+export declare function list(keys: string[]): string;
+/** Collects edits, and warnings grouped by what they are about. */
+export declare class Report {
+    readonly edits: ImportEdit[];
+    private readonly headlines;
+    private readonly grouped;
+    /** A warning of its own. */
+    warn(message: string): void;
+    /** `key` of `subject`, at `path`, is not carried. No warning when `why` is undefined (it is at Grafana's default). */
+    drop(path: string, subject: string, key: string, why?: string): void;
+    /**
+     * The value at `path` is written as `value`. No warning when `why` is
+     * undefined (Grafana reads both the same); otherwise the warning reads
+     * `<subject>: <key> <why>`.
+     */
+    replace(path: string, value: unknown, subject: string, key: string, why?: string): void;
+    edit(edit: ImportEdit): void;
+    private note;
+    warnings(): string[];
+}
+/** The `why` of a key no prop takes. */
+export declare const NO_PROP = "(no prop takes it)";
+//# sourceMappingURL=report.d.ts.map

package/dist/import/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/import/report.ts"],"names":[],"mappings":"AAAA,iIAAiI;AAEjI,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,oCAAoC;AACpC,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAE3C;AAED,mEAAmE;AACnE,qBAAa,MAAM;IACjB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAM;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiG;IAEzH,4BAA4B;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3B,sHAAsH;IACtH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAKpE;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAKvF,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAI5B,OAAO,CAAC,IAAI;IAOZ,QAAQ,IAAI,MAAM,EAAE;CAWrB;AAED,wCAAwC;AACxC,eAAO,MAAM,OAAO,uBAAuB,CAAC"}

package/dist/import/testdata/fixtures.d.ts

@@ -0,0 +1,41 @@
+export declare const pkgDir: string;
+export declare const repoRoot: string;
+export declare const fixturesDir: string;
+/** A fixture file's text, by path under test/fixtures. */
+export declare const read: (...p: string[]) => string;
+/** The classic UI exports (every export but the v1 and v2 resources), as paths under test/fixtures. */
+export declare const UI_EXPORTS: readonly string[];
+/** v2 dashboards (#2947): the checkout V2 Resource UI export, and the tabs dashboard as the v2 API reads it. */
+export declare const V2_EXPORTS: readonly string[];
+/** The tabs dashboard read at dashboard.grafana.app/v1: Grafana's lossy down-conversion of a dashboard it stores as v2. */
+export declare const LOSSY_V1_EXPORT = "exports/grafana-13.2.2/tabs.v1-resource.json";
+/** The grafana.com dashboards, as paths under test/fixtures. */
+export declare const COMMUNITY: readonly string[];
+/** kube-prometheus v0.19.0's dashboards, one file per dashboard, as paths under test/fixtures. */
+export declare const KUBE_PROMETHEUS: readonly string[];
+/**
+ * Datasource provisioning files (test/fixtures/provisioning/, provenance in
+ * its README): one written for chant with every plugin whose settings are
+ * typed, and grafana/docker-otel-lgtm's.
+ */
+export declare const PROVISIONING: readonly string[];
+/**
+ * The alerting provisioning corpus (test/fixtures/alerting/, provenance and
+ * licenses in its README): Grafana 12.4.11 and 13.2.2 exports, and files
+ * from projects that provision Grafana alerting from files.
+ */
+export declare const ALERTING: readonly string[];
+/** Every file each example builds, keyed `<example>/<path>`. */
+export declare function exampleOutputs(): Promise<Array<[string, string]>>;
+/** A chant project directory inside the package, so the lexicon resolves as it does for a user. */
+export declare function projectDir(): string;
+/** Write generated files under `dir`, creating their directories. */
+export declare function writeFiles(dir: string, files: ReadonlyArray<{
+    path: string;
+    content: string;
+}>): string[];
+/** Remove a directory made by `projectDir`. */
+export declare function removeDir(dir: string): void;
+/** Every `.ts` file under a directory, recursively. */
+export declare function tsFiles(dir: string): string[];
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/import/testdata/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/import/testdata/fixtures.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,MAAM,QAA2C,CAAC;AAC/D,eAAO,MAAM,QAAQ,QAA2B,CAAC;AACjD,eAAO,MAAM,WAAW,QAAmC,CAAC;AAE5D,0DAA0D;AAC1D,eAAO,MAAM,IAAI,GAAI,GAAG,GAAG,MAAM,EAAE,KAAG,MAAwD,CAAC;AAE/F,uGAAuG;AACvG,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAKvC,CAAC;AAEF,gHAAgH;AAChH,eAAO,MAAM,UAAU,EAAE,SAAS,MAAM,EAAyG,CAAC;AAElJ,2HAA2H;AAC3H,eAAO,MAAM,eAAe,iDAAiD,CAAC;AAE9E,gEAAgE;AAChE,eAAO,MAAM,SAAS,EAAE,SAAS,MAAM,EAQtC,CAAC;AAEF,kGAAkG;AAClG,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAGR,CAAC;AAEtC;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAsG,CAAC;AAEjJ;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,SAAS,MAAM,EAKrC,CAAC;AASF,gEAAgE;AAChE,wBAAsB,cAAc,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAWvE;AAED,mGAAmG;AACnG,wBAAgB,UAAU,IAAI,MAAM,CAMnC;AAED,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,EAAE,CASzG;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,uDAAuD;AACvD,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ7C"}

package/dist/import/v2.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Read a v2 dashboard (`dashboard.grafana.app/v2` or `v2beta1`, Grafana 13's
+ * default "V2 Resource" export) as the classic (v1) dashboard JSON chant
+ * builds, for `chant import` (#2947).
+ *
+ * The conversion follows Grafana's own v2 -> v1 conversion at v13.2.2
+ * (`apps/dashboard/pkg/migration/conversion/v2alpha1_to_v1.go` and
+ * `v2_to_v1_layout_conversion.md`), so what comes out is what Grafana itself
+ * serves when the same dashboard is read at v1: tabs become expanded rows,
+ * an auto grid gets the fixed positions Grafana computes, nested rows are
+ * flattened, and row ids follow the largest panel id.
+ *
+ * Grafana does that silently. Here, everything v2 can say that the classic
+ * model cannot is a warning: tabs, auto grids, nested rows, a hidden row
+ * header after the first row, conditional rendering, section variables,
+ * dashboard preferences, "show in controls menu", and any key the vendored
+ * `dashboardv2` schema (`src/spec/schemas/dashboardv2.jsonschema.json`) does
+ * not know. `V2_KEYS` names, per schema definition, which keys are carried
+ * and which are reported; `v2.test.ts` checks it against the schema, so a
+ * pin bump that adds a v2 key fails until the key is placed in one of them.
+ *
+ * What the classic model can hold but chant cannot yet (library panels,
+ * annotations) is written to the classic JSON as Grafana would and reported
+ * by the classic importer (`./parser.ts`), as for any classic dashboard. Ad
+ * hoc, group by and switch variables are written the same way and imported
+ * by the classic importer's variable mappings (`./mappings.ts`).
+ *
+ * A classic read of a dashboard Grafana stores as v2 is the lossy direction:
+ * `storedAsV2` recognises it from the resource's
+ * `status.conversion.storedVersion`, and the parser refuses it unless the
+ * caller opts in.
+ */
+type Json = Record<string, unknown>;
+/**
+ * Per `dashboardv2` schema definition, the keys this module reads.
+ *
+ * - `carried`: written into the classic dashboard (or structural, like `kind`).
+ * - `reported`: v2-only, with the reason the warning gives when the key is
+ *   set to anything but its default.
+ */
+export declare const V2_KEYS: Readonly<Record<string, {
+    carried: readonly string[];
+    reported: Readonly<Record<string, string>>;
+}>>;
+/** What reading one v2 dashboard gave. */
+export interface V2Read {
+    /** The classic dashboard JSON. */
+    dashboard: Json;
+    /** What v2 said that the classic dashboard does not. */
+    warnings: string[];
+}
+/**
+ * Read a v2 dashboard: a `dashboard.grafana.app/v2` or `v2beta1` resource,
+ * or a bare v2 spec. Throws for `v2alpha1`, whose panel queries have another
+ * shape; Grafana serves every stored dashboard at v2, so the fix is to read
+ * it there.
+ */
+export declare function readV2Dashboard(data: Json): V2Read;
+/**
+ * The version Grafana stores a dashboard at, when a `dashboard.grafana.app`
+ * resource read at v0 or v1 says it is stored as v2 (`status.conversion`):
+ * that read is a down-conversion that drops whatever v2 has and v1 does not
+ * (tabs, auto grids, conditional rendering), with nothing in the spec to show
+ * it. Also returns the stored version when the conversion failed. Undefined
+ * for everything else.
+ */
+export declare function lossyV1Read(data: unknown): {
+    apiVersion: string;
+    storedVersion: string;
+    failed: boolean;
+} | undefined;
+export {};
+//# sourceMappingURL=v2.d.ts.map

package/dist/import/v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v2.d.ts","sourceRoot":"","sources":["../../src/import/v2.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAKH,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpC;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CAAE,CAAC,CA8FxH,CAAC;AA2EF,0CAA0C;AAC1C,MAAM,WAAW,MAAM;IACrB,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA8hBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAgBlD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CASrH"}

package/dist/index.d.ts

@@ -1,17 +1,36 @@
 export { grafanaPlugin } from "./plugin.js";
 export { grafanaSerializer } from "./serializer.js";
-export { Datasource, DATASOURCE_TYPE, BUILTIN_DATASOURCE_UIDS, isDatasourceEntity, type DatasourceProps, type DatasourceEntity, type DatasourceConstructor, type DatasourceRef, type DatasourceAccess, type KnownDatasourceType, } from "./datasource.js";
-export { Dashboard, DashboardProvider, DASHBOARD_TYPE, DASHBOARD_PROVIDER_TYPE, DEFAULT_DASHBOARDS_PATH, isDashboardEntity, isDashboardProviderEntity, type DashboardProps, type DashboardEntity, type DashboardLinkInput, type DashboardProviderProps, type DashboardProviderEntity, } from "./dashboard.js";
-export { TimeSeriesPanel, StatPanel, GaugePanel, TablePanel, LogsPanel, TracesPanel, HeatmapPanel, TextPanel, Row, definePanel, registeredPanels, panelDefinitionFor, isPanelEntity, isRowEntity, PANEL_TYPE_PREFIX, ROW_TYPE, type PanelProps, type PanelFieldConfig, type PanelLink, type PanelDefinition, type PanelEntity, type PanelClass, type RowProps, type RowEntity, } from "./panels.js";
-export { PromQuery, TempoQuery, LokiQuery, defineQuery, registeredQueries, queryDefinitionFor, isQueryEntity, QUERY_TYPE_PREFIX, type DatasourceInput, type QueryModel, type QueryProps, type QueryDefinition, type QueryEntity, type QueryClass, type PromQueryEntity, type TempoQueryEntity, type LokiQueryEntity, } from "./query.js";
-export { QueryVariable, CustomVariable, IntervalVariable, DatasourceVariable, ConstantVariable, TextboxVariable, isVariableEntity, isDatasourceVariable, isBuiltinVariable, VARIABLE_NAME, VARIABLE_TYPE_PREFIX, type VariableKind, type VariableHide, type VariableEntity, type VariableDatasource, type DatasourceVariableEntity, type QueryVariableProps, type CustomVariableProps, type IntervalVariableProps, type DatasourceVariableProps, type ConstantVariableProps, type TextboxVariableProps, } from "./variables.js";
+export { Datasource, DATASOURCE_TYPE, ExternalDatasource, EXTERNAL_DATASOURCE_TYPE, BUILTIN_DATASOURCE_UIDS, isDatasourceEntity, isExternalDatasource, isDatasourceDeclaration, DatasourceProvisioning, DATASOURCE_PROVISIONING_TYPE, isDatasourceProvisioningEntity, type DatasourceProvisioningProps, type DatasourceProvisioningEntity, type DeletedDatasource, type ExternalDatasourceProps, type ExternalDatasourceEntity, type ExternalDatasourceConstructor, type DatasourceProps, type DatasourceEntity, type DatasourceConstructor, type DatasourceRef, type DatasourceAccess, type KnownDatasourceType, } from "./datasource.js";
+export { JSONDATA_LINKS, TRACING_DATASOURCE_TYPES, TRACE_TO_LOGS_DATASOURCE_TYPES, TRACE_TO_METRICS_DATASOURCE_TYPES, type JsonDataLink, type LinkedDatasource, type TracingDatasourceType, type TraceToLogsDatasourceType, type TraceToMetricsDatasourceType, type TypedDatasourceType, type DatasourceJsonData, type DatasourceSecureJsonData, type DatasourceJsonDataTypes, type DatasourceSecureJsonKeys, type CommonJsonData, type HttpJsonData, type HttpSecureJsonKey, type PrometheusJsonData, type ExemplarTraceIdDestination, type LokiJsonData, type DerivedFieldConfig, type TempoJsonData, type TraceToLogsTag, type TraceToLogsOptions, type TraceToLogsOptionsV2, type TraceToMetricsOptions, type TraceToProfilesOptions, type ElasticsearchJsonData, type ElasticsearchDataLink, type ElasticsearchSecureJsonKey, type AwsAuthJsonData, type AwsAuthSecureJsonKey, type CloudWatchJsonData, type CloudWatchLogGroup, type CloudWatchSecureJsonKey, type AzureCloudName, type AzureCredentials, type AzureMonitorJsonData, type AzureMonitorSecureJsonKey, type GoogleAuthJsonData, type GoogleAuthSecureJsonKey, type CloudMonitoringJsonData, type CloudMonitoringSecureJsonKey, type BigQueryJsonData, type BigQuerySecureJsonKey, type PyroscopeJsonData, type PyroscopeSecureJsonKey, type SqlJsonData, type PostgresJsonData, type PostgresSecureJsonKey, type MySQLJsonData, type MySQLSecureJsonKey, type MSSQLJsonData, type MSSQLSecureJsonKey, } from "./datasource-settings.js";
+export { Dashboard, DashboardProvider, DASHBOARD_TYPE, DASHBOARD_PROVIDER_TYPE, DEFAULT_DASHBOARDS_PATH, isDashboardEntity, isDashboardProviderEntity, type DashboardProps, type DashboardEntity, type DashboardLinkInput, type DashboardProviderProps, type DashboardProviderEntity, type DashboardEntityProps, type DashboardProviderEntityProps, } from "./dashboard.js";
+export { Folder, FOLDER_TYPE, isFolderEntity, folderLevels, type FolderProps, type FolderEntity } from "./folder.js";
+export { annotationJson, ANNOTATION_REF_ID, type AnnotationInput } from "./annotations.js";
+export { AlertRuleGroup, AlertRule, AlertQuery, ReduceExpression, MathExpression, ThresholdExpression, ResampleExpression, ClassicConditionsExpression, SqlExpression, ContactPoint, NotificationPolicy, MuteTiming, NotificationTemplate, ALERT_RULE_GROUP_TYPE, ALERT_RULE_TYPE, ALERT_QUERY_TYPE, EXPRESSION_TYPE_PREFIX, EXPRESSION_DATASOURCE_UID, CONTACT_POINT_TYPE, NOTIFICATION_POLICY_TYPE, MUTE_TIMING_TYPE, NOTIFICATION_TEMPLATE_TYPE, isAlertRuleGroupEntity, isAlertRuleEntity, isAlertQueryEntity, isExpressionEntity, isContactPointEntity, isNotificationPolicyEntity, isMuteTimingEntity, isNotificationTemplateEntity, type AlertRuleGroupProps, type AlertRuleGroupEntity, type AlertRuleProps, type AlertRuleEntity, type AlertRuleData, type AlertRuleNotificationSettings, type AlertRuleRecord, type AlertQueryProps, type AlertQueryEntity, type AlertDuration, type RelativeTimeRange, type ExpressionEntity, type ExpressionKind, type ReduceExpressionProps, type MathExpressionProps, type ThresholdExpressionProps, type ResampleExpressionProps, type ClassicConditionsExpressionProps, type SqlExpressionProps, type NoDataState, type ExecErrState, type ContactPointProps, type ContactPointEntity, type ContactPointReceiver, type ContactPointIntegrationType, type NotificationPolicyProps, type NotificationPolicyEntity, type PolicyRoute, type ObjectMatcher, type MuteTimingProps, type MuteTimingEntity, type NotificationTemplateProps, type NotificationTemplateEntity, } from "./alerting.js";
+export { buildAlerting, alertingYaml, alertRuleJson, alertQueryJson, ruleGroupJson, contactPointJson, notificationPolicyJson, muteTimingJson, notificationTemplateJson, durationSeconds, ALERTING_FILE, ALERTING_FILE_KEYS, DEFAULT_RELATIVE_TIME_RANGE, DEFAULT_GROUP_INTERVAL, type AlertingFile, type AlertingIndex, type ProvisionedRuleGroup, type ProvisionedAlertRule, type ProvisionedAlertQuery, type ProvisionedContactPoint, type ProvisionedMuteTiming, type ProvisionedTemplate, } from "./alerting-build.js";
+export { CONTACT_POINT_SECRET_SETTINGS } from "./contact-point-secrets.js";
+export { TimeSeriesPanel, StatPanel, GaugePanel, TablePanel, LogsPanel, TracesPanel, HeatmapPanel, TextPanel, BarChartPanel, BarGaugePanel, PieChartPanel, StateTimelinePanel, StatusHistoryPanel, HistogramPanel, NodeGraphPanel, XYChartPanel, TrendPanel, CanvasPanel, GeomapPanel, FlameGraphPanel, AlertListPanel, Row, definePanel, registeredPanels, panelDefinitionFor, isPanelEntity, isRowEntity, PANEL_TYPE_PREFIX, ROW_TYPE, type PanelProps, type PanelFieldConfig, type PanelLink, type PanelDefinition, type PanelEntity, type PanelClass, type RowProps, type RowEntity, } from "./panels.js";
+export { PromQuery, TempoQuery, LokiQuery, ElasticsearchQuery, CloudWatchQuery, AzureMonitorQuery, CloudMonitoringQuery, BigQueryQuery, PyroscopeQuery, PostgresQuery, MySQLQuery, MSSQLQuery, defineQuery, registeredQueries, queryDefinitionFor, isQueryEntity, QUERY_TYPE_PREFIX, type DatasourceInput, type QueryModel, type Loosen, type MergedModel, type QueryProps, type QueryDefinition, type QueryEntity, type QueryClass, type PromQueryEntity, type TempoQueryEntity, type LokiQueryEntity, type ElasticsearchQueryEntity, type CloudWatchQueryEntity, type AzureMonitorQueryEntity, type CloudMonitoringQueryEntity, type BigQueryQueryEntity, type PyroscopeQueryEntity, type PostgresQueryEntity, type MySQLQueryEntity, type MSSQLQueryEntity, } from "./query.js";
+export type { SqlQueryModel, SqlBuilderQuery, SqlQueryFormat, SqlExpressionType, SqlProperty, SqlFunctionExpression, SqlFunctionParameterExpression, SqlGroupByExpression, SqlPropertyExpression, } from "./query-models.js";
+export { QueryVariable, CustomVariable, IntervalVariable, DatasourceVariable, ConstantVariable, TextboxVariable, isVariableEntity, isDatasourceVariable, isBuiltinVariable, VARIABLE_NAME, VARIABLE_TYPE_PREFIX, type VariableKind, type VariableHide, type VariableEntity, type VariableDatasource, type DatasourceVariableEntity, type QueryVariableProps, type CustomVariableProps, type IntervalVariableProps, type DatasourceVariableProps, type ConstantVariableProps, type TextboxVariableProps, AdhocVariable, GroupByVariable, SwitchVariable, MULTI_VALUE_KINDS, type AdhocVariableProps, type GroupByVariableProps, type SwitchVariableProps, type AdhocFilter, type VariableKeyOption, type VariableQueryObject, type PrometheusVariableQuery, } from "./variables.js";
 export * as schema from "./schema/index.js";
 export { DASHBOARD_SCHEMA_VERSION } from "./schema/index.js";
-export { GRAFANA_SCHEMA_PIN, SCHEMA_NAMES, type GrafanaSchemaPin, type SchemaName } from "./pin.js";
-export { buildGrafana, grafanaFiles, renderDashboard, dashboardJson, dashboardUid, panelsJson, targetJson, variableModel, datasourceRef, provisionedDatasource, provisionedProvider, datasourcesYaml, dashboardProvidersYaml, GRID_COLUMNS, DATASOURCES_FILE, DASHBOARD_PROVIDERS_FILE, DASHBOARDS_DIR, type BuiltGrafana, type BuiltDashboard, type GrafanaIndex, type ProvisionedDatasource, type ProvisionedProvider, type DashboardJson, type PanelJson, type RowPanelJson, type VariableModel, type DataSourceRef, } from "./build.js";
-export { validateGrafanaOutput, issuesFor, variableReferences, type GrafanaIssue, type GrafanaIssueCode, type GrafanaArtifacts, type DashboardDoc, } from "./validate-output.js";
-export { validateDashboardSchema, type SchemaProblem } from "./schema-validate.js";
-export { looksLikeDashboard, looksLikeDatasourceProvisioning, looksLikeDashboardProvisioning } from "./detect.js";
-export { slugUid, isValidUid, UID_PATTERN, type DeepPartial } from "./util.js";
-export { RedDashboard, redQueries, SloDashboard, sloQueries, AgentDashboard, agentQueries, type RedDashboardProps, type RedDashboardMembers, type RedDashboardInstance, type SloDashboardProps, type SloDashboardMembers, type SloDashboardInstance, type AgentDashboardProps, type AgentDashboardMembers, type AgentDashboardInstance, type DashboardOptions, } from "./composites/index.js";
+export { GRAFANA_SCHEMA_PIN, SCHEMA_NAMES, IMPORT_ONLY_SCHEMA_NAMES, VENDORED_SCHEMA_NAMES, type GrafanaSchemaPin, type SchemaName, type ImportOnlySchemaName, type VendoredSchemaName, } from "./pin.js";
+export type { AlertListOptions, AlertListSortOrder, AlertListStateFilter, FlameGraphOptions } from "./panel-options.js";
+export { transformation, customTransformation, TRANSFORMATION_IDS, type Transformation, type KnownTransformation, type CustomTransformation, type TransformationCommon, type TransformationId, type TransformationOptionsById, type ReducerId, } from "./transformations.js";
+export { buildGrafana, grafanaFiles, renderDashboard, dashboardJson, dashboardUid, panelsJson, targetJson, variableModel, customVariableOptions, datasourceRef, provisionedDatasource, externalDatasourceRecord, provisionedProvider, datasourcesYaml, datasourceFileSettings, dashboardProvidersYaml, GRID_COLUMNS, DATASOURCES_FILE, DASHBOARD_PROVIDERS_FILE, DASHBOARDS_DIR, type BuiltGrafana, type BuiltDashboard, type GrafanaIndex, type ProvisionedDatasource, type ExternalDatasourceRecord, type ProvisionedProvider, type DatasourceFileSettings, type DashboardJson, type PanelJson, type RowPanelJson, type VariableModel, type DataSourceRef, } from "./build.js";
+export { datasourceUses, variableReferences, resolveDatasourceRef, knownDatasources, type DatasourceUse, type ResolvedDatasource, type KnownDatasource, type DatasourceRefJson, } from "./datasource-refs.js";
+export { looksLikeDashboard, looksLikeDatasourceProvisioning, looksLikeDashboardProvisioning, looksLikeAlertingProvisioning } from "./detect.js";
+export { slugUid, isValidUid, UID_PATTERN, type DeepPartial, type PropsOf } from "./util.js";
+export { RedDashboard, redQueries, RED_DEFAULT_SPAN_KINDS, SloDashboard, sloQueries, AgentDashboard, agentQueries, type RedDashboardProps, type RedDashboardMembers, type RedDashboardInstance, type SpanKind, type SloDashboardProps, type SloDashboardMembers, type SloDashboardInstance, type AgentDashboardProps, type AgentDashboardMembers, type AgentDashboardInstance, type DashboardOptions, SloAlertRules, sloAlertQueries, type SloAlertRulesProps, type SloAlertRulesMembers, type SloAlertRulesInstance, } from "./composites/index.js";
+export { grafanaConfigSchema, resolveGrafanaTarget } from "./config.js";
+export type { GrafanaConfig, GrafanaProfile } from "./config.js";
+export { GRAFANA_OWNERSHIP_KEYS, DEFAULT_PROVIDER_NAME, grafanaOwnershipLabels, dashboardOwnership, } from "./ownership.js";
+export { GrafanaClient, GrafanaApiError, grafanaHttp, namespaceOf, statusVerdict } from "./api/client.js";
+export type { GrafanaAuth, GrafanaHttp, GrafanaResponse, GrafanaTarget, StatusVerdict } from "./api/client.js";
+export { bindGrafana, classifyGrafanaFailure, GrafanaBindingError } from "./api/bind.js";
+export { grafanaApply } from "./op/builders.js";
+export { applyGrafana, planFromDashboards, GRAFANA_APPLY_KINDS } from "./api/apply.js";
+export type { GrafanaApplyPlan, GrafanaApplyOutcome, DashboardPlan, BuiltDashboardInput } from "./api/apply.js";
+export { folderUidFor, foldersForDashboards, resolveFolders, liveFolderPath, type FolderPlan, type ResolvedFolders } from "./api/folders.js";
+export { GrafanaActions, grafanaActionsFor, type GrafanaAccessLevel } from "./actions/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/init-templates.d.ts

@@ -0,0 +1,27 @@
+/**
+ * `chant init --lexicon grafana` scaffolds.
+ *
+ * - default: a Prometheus datasource and a job overview dashboard with a
+ *   typed variable, in a folder.
+ * - `red`: rate, errors and duration per service from the OpenTelemetry
+ *   collector's span metrics, over a Prometheus Grafana already has
+ *   (`ExternalDatasource`), in a pinned `Folder`.
+ * - `k8s-pods`: CPU, memory, restarts and pod phase per namespace, delivered
+ *   as ConfigMaps the Grafana Helm chart's sidecar loads, from the `/k8s`
+ *   subpath. Builds with the k8s lexicon.
+ * - `slo`: an SLO's recording rules, its dashboard and its burn-rate alerts
+ *   as Grafana-managed rules. Builds with the prometheus lexicon.
+ *
+ * The otel, prometheus and k8s lexicons these import are dependencies of
+ * the grafana lexicon, so they are installed with it. The templates that
+ * build with a second lexicon ship their own `chant.config.ts` and a build
+ * script without `--lexicon`, so every lexicon's output and checks run.
+ */
+import type { InitTemplateSet } from "@intentius/chant/lexicon";
+export declare const DEFAULT_TEMPLATE: InitTemplateSet;
+export declare const RED_TEMPLATE: InitTemplateSet;
+export declare const K8S_PODS_TEMPLATE: InitTemplateSet;
+export declare const SLO_TEMPLATE: InitTemplateSet;
+/** The template names `chant init --lexicon grafana --template <name>` takes, besides the default. */
+export declare const TEMPLATE_NAMES: readonly ["red", "k8s-pods", "slo"];
+//# sourceMappingURL=init-templates.d.ts.map

package/dist/init-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-templates.d.ts","sourceRoot":"","sources":["../src/init-templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AA8ShE,eAAO,MAAM,gBAAgB,EAAE,eAE9B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAE1B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,eAU/B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,eAI1B,CAAC;AAEF,sGAAsG;AACtG,eAAO,MAAM,cAAc,qCAAsC,CAAC"}

package/dist/integrity.json

@@ -1,22 +1,32 @@
 {
   "algorithm": "sha256",
   "artifacts": {
-    "manifest.json": "a8eecc6ebe0fb2b1fe75304345772a1a75feb8f389ac8171968c6b1ca7acac7f",
-    "meta.json": "cc3a6d1fa7baf5fd95c2f454ea1490e15ab88e59194333afb116e9ba0c82b731",
+    "manifest.json": "6b9780bbfbc00f2317658e520c26391d7a7dbfbd01f6e640b6fdf376821e8d18",
+    "meta.json": "d30a7da8926eb2970ca428a6df98671533acba9b175ea251ce0b103aaf95bc65",
     "types/index.d.ts": "ad385264290f2486f7a54be205684de8415a25b74eee5b809ca625ae19fb08da",
     "rules/grafana-ast.ts": "51f4fac423f7a5c6d6f577074e95b4a70d4ab0a05883a86e04970a50c63d92e8",
-    "rules/literal-secret.ts": "c3622ec95fdc485c565f9637de95fd856449531f42060d001d4f9e142a0fe6ad",
+    "rules/literal-secret.ts": "bc3e13bff3bfa5f4b66f2b43682efb8605ce5ef2fe5c53bca2de07369fca496f",
     "rules/uid-syntax.ts": "ea6fc0053afcdfb50fd6420d6845cba37352a66411d4f06e7e76876b063e7184",
-    "rules/graf101.ts": "e30e6fa3eaa184d59a658de275e5fcc5a3248aa8af2dc7120f0c28f7b0bb2113",
-    "rules/graf102.ts": "6186f51b89133464c78a22a7226d6071956a91189b5f1dd79ff81dd9a89d5c33",
+    "rules/graf101.ts": "cc1c75a890a01b8f5a5e079769d905d810a7943290bed32203364ec1d940d996",
+    "rules/graf102.ts": "c05d50461adc8cf6d4e913de77dc1ecdb27e3d0eaa2929fca8757101f58d69ee",
     "rules/graf103.ts": "d4a035f9fb2dad5e6f415c3fd684789517b0fa38455965b79e221ef2c4c443cf",
-    "rules/graf104.ts": "3a46afbc9afd6840079b5c0053d8b17d878dc6735dcf1d1d09d66971de4bccc8",
+    "rules/graf104.ts": "26f6ec4aa0e138db37d58bfe27f2682be8ac9de0396b953b70b50c01b6d8cf51",
     "rules/graf105.ts": "98264894350f1ce21841922dfefc3dc85abc0ec5c9db91afdfa5c180a8c306f1",
-    "rules/graf106.ts": "c7f96e236eda49e0b782ef064bb6f21ef93d797d435389fa89e26c697b73d69a",
-    "rules/graf107.ts": "f58f8258c596e66b92eba0ef5d48f3a785f84992c6a78d2cb9f6017d6504e3c1",
-    "rules/grafana-helpers.ts": "4cf58bcdcfd2c06b8c5c084d77ba780903952487d82773c2f42e6d27c7d3592d",
-    "skills/chant-grafana.md": "8976cd1dff9729ca655f31e86fce3fff14c90d7c65358947397ccc12bb61f2a4",
-    "skills/chant-grafana-provisioning.md": "8066d58ef6b8b58724b343cd054b9b210ffffcebe2d1587a6702bae33ab0c12e"
+    "rules/graf106.ts": "21b7402e60b807806f59834689bb5f9f33b8a248c25245beacfc2c3b8f3088f7",
+    "rules/graf107.ts": "e43db67d184b967f1f870dd6a4aac8548a54ad5abd0f58080ca68a2d49c2b20c",
+    "rules/graf108.ts": "dda5ef25f56af51905aaeb8648733887bf4778b59a19a4ef67979e7180c0df62",
+    "rules/graf109.ts": "8b796ee02c0b1bab129805825dee2ef8e0c5afa743a0241d5c251e2b4484039e",
+    "rules/graf110.ts": "c79e2f28a2c933be977979f50541ec3f9b3d58bdc239a4d45825f4fabfceb080",
+    "rules/graf111.ts": "acd727a91e33526787bb877550d8a3c12674d34b2a660a23fcb20dec0ffebe03",
+    "rules/graf112.ts": "cfe779df7f82969b7d7428394d062f46e07540b16889a255b6cb066c7e6e3430",
+    "rules/graf113.ts": "81dfb6512e1c0514a5bb105e3fb841110a290c28725ce435283c2c5abd95dd56",
+    "rules/graf114.ts": "0732be823ed7d1e6850abffc5374c95c0cfc4c8a3f8490efa1555319cc260587",
+    "rules/graf115.ts": "eb6b5cb7b275ab27f9602eb5bdc3e2bc8e698ae6d0ffcd984d71e2315e4d6315",
+    "rules/grafana-helpers.ts": "0a538daafb10f32077dd6cda4c03b541f703b0a10abc51bfd241eae9365c9be6",
+    "skills/chant-grafana.md": "90cf6fef49ebdf81ba6684f4b4ea5a92ae567d722d45e67de67137d07dddf48f",
+    "skills/chant-grafana-provisioning.md": "55bcf20dbd02b74c880dfb682a4fbe047bd4386158781fe9b94fa76715569e7a",
+    "skills/chant-grafana-alerting.md": "d9648dc14c848851bdccbe069dac54ad06115066f9466c90c4137d07dde6d4ad",
+    "skills/chant-grafana-operations.md": "4235ee74c4faa95b8dcb1926b4cbabb827380c9c13666bf38ef0be0dd2d3bfa2"
   },
-  "composite": "94253d8d6a1deca764a32f094b767967e06d394f12639a2a867ca1ce921a712d"
+  "composite": "268a39021dbd5a3b56d10f25d0be57225458b54113ac4ef79c2476f7a6c2898d"
 }

package/dist/k8s.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Grafana dashboards and provisioning delivered to Kubernetes as ConfigMaps
+ * (#2954), from `@intentius/chant-lexicon-grafana/k8s`.
+ *
+ * `GrafanaConfigMaps` writes one ConfigMap per dashboard and one for the
+ * datasource provisioning file, labelled the way the Grafana Helm chart's
+ * sidecar (kiwigrid/k8s-sidecar, also in kube-prometheus-stack) finds them:
+ * `grafana_dashboard: "1"` and `grafana_datasource: "1"`. A dashboard's
+ * folder goes in the `k8s-sidecar-target-directory` annotation the sidecar
+ * reads by default. Each dashboard ConfigMap holds `<uid>.json`, the same
+ * text as `dashboardJson(dashboard)`, which is also what the k8s importer
+ * turns such a ConfigMap back into (#2962).
+ *
+ * A Grafana run without the sidecar (a plain Deployment, as in
+ * `examples/agent-observability`) mounts the same ConfigMaps with
+ * `grafanaVolumes()`, which also needs the dashboard provider file that
+ * `GrafanaConfigMaps` writes to a third ConfigMap. The provisioning files go
+ * under `/etc/grafana/provisioning` and each dashboard folder is a volume of
+ * its own under the provider's path: inside a ConfigMap volume a
+ * subdirectory is a symlink, and Grafana's dashboard provider does not
+ * follow symlinked directories.
+ *
+ * This module is the only part of the grafana lexicon that loads the k8s
+ * lexicon; nothing else imports it.
+ */
+import { type CompositeInstance } from "@intentius/chant/composite";
+import type { Declarable } from "@intentius/chant/declarable";
+import { ConfigMap } from "@intentius/chant-lexicon-k8s/generated/index";
+/** The label the Grafana Helm chart's sidecar looks for on dashboard ConfigMaps (`sidecar.dashboards.label`). */
+export declare const SIDECAR_DASHBOARD_LABEL = "grafana_dashboard";
+/** The label it looks for on datasource ConfigMaps (`sidecar.datasources.label`). */
+export declare const SIDECAR_DATASOURCE_LABEL = "grafana_datasource";
+/** The annotation the sidecar reads a dashboard's target directory from, by default (its `FOLDER_ANNOTATION`). */
+export declare const SIDECAR_FOLDER_ANNOTATION = "k8s-sidecar-target-directory";
+/** Where Grafana reads provisioning files. */
+export declare const GRAFANA_PROVISIONING_PATH = "/etc/grafana/provisioning";
+export interface GrafanaConfigMapsProps {
+    /** The grafana declarations to deliver: dashboards, datasources, `DashboardProvider`s. Anything else is ignored. */
+    entities: Iterable<Declarable>;
+    namespace?: string;
+    /** Prefix of every ConfigMap name. Defaults to `grafana`. */
+    name?: string;
+    /** Labels added to every ConfigMap, beside the sidecar's. */
+    labels?: Record<string, string>;
+    /** The dashboard label as `[key, value]`, or `false` for none. Defaults to `["grafana_dashboard", "1"]`. */
+    dashboardLabel?: readonly [string, string] | false;
+    /** The datasource label as `[key, value]`, or `false` for none. Defaults to `["grafana_datasource", "1"]`. */
+    datasourceLabel?: readonly [string, string] | false;
+    /** The annotation holding a dashboard's folder, or `false` for none. Defaults to `k8s-sidecar-target-directory`. */
+    folderAnnotation?: string | false;
+}
+/** The `metadata.name` of each ConfigMap, and which file it holds. */
+export interface GrafanaConfigMapLayout {
+    dashboards: Array<{
+        configMap: string;
+        key: string;
+        folder: string;
+        uid: string;
+        text: string;
+    }>;
+    datasources?: {
+        configMap: string;
+        key: string;
+        text: string;
+    };
+    providers?: {
+        configMap: string;
+        key: string;
+        text: string;
+    };
+}
+/** Which ConfigMap each file goes in, and under which key. `GrafanaConfigMaps` and `grafanaVolumes` both read it. */
+export declare function grafanaConfigMapLayout(props: Pick<GrafanaConfigMapsProps, "entities" | "name">): GrafanaConfigMapLayout;
+type ConfigMapEntity = InstanceType<typeof ConfigMap> & Declarable;
+export type GrafanaConfigMapsMembers = Record<string, ConfigMapEntity>;
+export type GrafanaConfigMapsInstance = CompositeInstance<GrafanaConfigMapsMembers> & GrafanaConfigMapsMembers;
+/**
+ * One ConfigMap per dashboard, one for the datasources and one for the
+ * dashboard provider, labelled for the Grafana sidecar. Export the result
+ * from a k8s build root; the members are named after the ConfigMaps
+ * (`dashboardGenaiAgents`, `datasources`, `dashboardProviders`).
+ */
+export declare const GrafanaConfigMaps: import("@intentius/chant/composite").CompositeDefinition<GrafanaConfigMapsProps, GrafanaConfigMapsMembers>;
+export interface GrafanaVolumesOptions {
+    /** Where the dashboard provider reads dashboards. Defaults to `/var/lib/grafana/dashboards`, the provider chant writes by default. */
+    dashboardsPath?: string;
+    /** Prefix of the volume names. Defaults to `grafana`. */
+    volumeName?: string;
+}
+export interface GrafanaVolumes {
+    volumes: Array<Record<string, unknown>>;
+    volumeMounts: Array<{
+        name: string;
+        mountPath: string;
+        readOnly: true;
+    }>;
+}
+/**
+ * The pod volumes and container mounts that put `GrafanaConfigMaps`'s files
+ * where a Grafana without the sidecar reads them: the provisioning files
+ * under `/etc/grafana/provisioning`, and each dashboard folder under the
+ * provider's path, one projected volume per folder. Pass the same `entities`
+ * and `name` as to `GrafanaConfigMaps`.
+ */
+export declare function grafanaVolumes(props: Pick<GrafanaConfigMapsProps, "entities" | "name">, options?: GrafanaVolumesOptions): GrafanaVolumes;
+export {};
+//# sourceMappingURL=k8s.d.ts.map

package/dist/k8s.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"k8s.d.ts","sourceRoot":"","sources":["../src/k8s.ts"],"names":[],"mappings":"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"}

package/dist/lint/audit-catalog.d.ts

@@ -2,7 +2,8 @@
  * The grafana lexicon's chant audit catalog, contributed via
  * `grafanaPlugin.auditCatalog()` (#687, #1346).
  *
- * GRAF101-GRAF107 read the emitted dashboard JSON and provisioning files, so
+ * GRAF101-GRAF110, GRAF111-GRAF114 and GRAF115 read the emitted dashboard
+ * JSON and provisioning files (alerting included), so
  * they fire on an audit of files chant didn't build too, and are
  * `yamlBased`. GRAF001 and GRAF002 read TypeScript source, so they are
  * constructed with `yamlBased: false`; they are listed for a reader who

package/dist/lint/audit-catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit-catalog.d.ts","sourceRoot":"","sources":["../../src/lint/audit-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAM1E,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAqExD,CAAC"}
+{"version":3,"file":"audit-catalog.d.ts","sourceRoot":"","sources":["../../src/lint/audit-catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAa,KAAK,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAM1E,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAqIxD,CAAC"}

package/dist/lint/post-synth/graf101.d.ts

@@ -1,7 +1,7 @@
 /**
- * GRAF101: A panel, query or variable uses a datasource no Datasource in the build declares
+ * GRAF101: A panel, query, variable or annotation uses a datasource no Datasource or ExternalDatasource in the build declares, or one the build deletes
  *
- * Grafana shows "datasource not found" on the panel. Typed references cannot go wrong this way, so it mostly catches a { type, uid } ref or a hand-edited dashboard. A panel with queries and no datasource at all is a warning: Grafana sends them to its default datasource. This check joins dashboards against the Datasource declarations of the same build root, so it goes silent across build roots (chant #1939): with no Datasource declared in the build it reports nothing, and a datasource declared in another build root looks undeclared. Keep datasources and the dashboards that use them in one build root.
+ * Grafana shows "datasource not found" on the panel. Typed references cannot go wrong this way, so it mostly catches a { type, uid } ref or a hand-edited dashboard. A datasource variable whose plugin type no declared datasource has is an error too. A panel with queries and no datasource at all is a warning: Grafana sends them to its default datasource. This check joins dashboards against the datasources of the same build root (chant #1939): declare one that exists in Grafana but is provisioned elsewhere with ExternalDatasource, which the check counts and the build never provisions. A build that declares no datasource at all gets one warning per dashboard that references any, since nothing can be checked.
  */
 import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
 export declare const graf101: PostSynthCheck;

package/dist/lint/post-synth/graf102.d.ts

@@ -1,7 +1,7 @@
 /**
  * GRAF102: A query is sent to a datasource of another plugin type
  *
- * A PromQL query sent to Tempo fails at query time. The typed classes prevent this at compile time; the check catches refs, datasource variables of the wrong plugin type and hand-edited dashboards. Like GRAF101 it joins against the Datasource declarations of the same build root and goes silent across build roots (chant #1939).
+ * A PromQL query sent to Tempo fails at query time. The typed classes prevent this at compile time; the check catches refs, datasource variables of the wrong plugin type and hand-edited dashboards. Like GRAF101 it joins against the Datasource and ExternalDatasource declarations of the same build root (chant #1939).
  */
 import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
 export declare const graf102: PostSynthCheck;

package/dist/lint/post-synth/graf104.d.ts

@@ -1,7 +1,7 @@
 /**
- * GRAF104: Two dashboards, datasources, panels, variables or queries share an id
+ * GRAF104: Two dashboards, datasources, folders, panels, variables or queries share an id
  *
- * Dashboard uids and datasource uids and names must be unique across the build, panel ids and variable names within a dashboard, and refIds within a panel. Grafana keeps one of two dashboards with the same uid and silently drops the other.
+ * Dashboard, folder and datasource uids and datasource names must be unique across the build, panel ids and variable names within a dashboard, and refIds within a panel. Grafana keeps one of two dashboards with the same uid and silently drops the other.
  */
 import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
 export declare const graf104: PostSynthCheck;

package/dist/lint/post-synth/graf106.d.ts

@@ -1,7 +1,7 @@
 /**
- * GRAF106: A dashboard or datasource uid Grafana rejects, or a dashboard with no title
+ * GRAF106: A dashboard, folder or datasource uid Grafana rejects, or a dashboard with no title
  *
- * Grafana accepts uids of 1-40 letters, digits, - and _, and refuses to save a dashboard without a title.
+ * Grafana accepts uids of 1-40 letters, digits, - and _, refuses the folder uid general (its root), and refuses to save a dashboard without a title.
  */
 import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
 export declare const graf106: PostSynthCheck;

package/dist/lint/post-synth/graf107.d.ts

@@ -1,7 +1,7 @@
 /**
  * GRAF107: A dashboard does not match the pinned Grafana schema
  *
- * The dashboard is validated against the dashboard schema at GRAFANA_SCHEMA_PIN, and each panel's options, fieldConfig.defaults.custom and queries against their plugin's schema with required fields relaxed (Grafana fills those in). What fails is a key the schema does not have or a value it does not allow: the edits Grafana would otherwise need on import.
+ * The dashboard is validated against the dashboard schema at GRAFANA_SCHEMA_PIN, with the correction overlay in src/spec/overlay/ applied, and each panel's options, fieldConfig.defaults.custom and queries against their plugin's schema with required fields relaxed (Grafana fills those in). Library panel models embedded in an export's __elements are checked the same way. A value the schema does not allow is an error: the edits Grafana would otherwise need on import. A key the schema does not know is a warning, since newer Grafana versions add keys before the pin catches up.
  */
 import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
 export declare const graf107: PostSynthCheck;

package/dist/lint/post-synth/graf108.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GRAF108: A query sent to Prometheus is not valid PromQL
+ *
+ * Each panel query, query variable and alert rule query whose datasource resolves to a prometheus datasource is parsed with the prometheus lexicon's checkPromql (@prometheus-io/lezer-promql), after its template variables ($var, ${var}, [[var]], $__interval, $__rate_interval, $__range and the other $__ macros) are replaced with placeholders that parse where they stand. A query whose datasource can't be told is not parsed; an alert rule query is parsed when its datasourceUid is a declared prometheus datasource or its model says `datasource.type: prometheus`. It is a syntax check: an unbalanced bracket or a bad duration fails, rate over an instant vector does not.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const graf108: PostSynthCheck;
+//# sourceMappingURL=graf108.d.ts.map

package/dist/lint/post-synth/graf108.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graf108.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/graf108.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,OAAO,EAAE,cAOrB,CAAC"}

package/dist/lint/post-synth/graf109.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GRAF109: Dashboard provisioning puts a dashboard somewhere other than its declared folder, or loads it twice
+ *
+ * Read from the dashboard provisioning file and where each dashboard file sits under dashboards/. Two providers in one org whose paths are the same or nested load every dashboard twice, and Grafana then takes database writes away from both: an error. A provider that sets folder and folderUid with foldersFromFilesStructure is refused by Grafana: an error; with one of them, that folder is ignored: a warning. Dashboards that declare a folder when no provider sets foldersFromFilesStructure all land in the provider's folder: a warning. A nested folder ("Platform/Kubernetes") is a warning: Grafana 13.1 and later nest the folders, 12.4 and 13.0 use only the last level; past Grafana's default depth of 4 it says so, and past its hard limit of 7 it is an error.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const graf109: PostSynthCheck;
+//# sourceMappingURL=graf109.d.ts.map

package/dist/lint/post-synth/graf109.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graf109.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/graf109.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,OAAO,EAAE,cAOrB,CAAC"}

package/dist/lint/post-synth/graf110.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GRAF110: A panel or row repeats over a variable that cannot give it more than one value
+ *
+ * Grafana repeats a panel or row once per selected value of a query, custom, datasource or group by variable. Over an ad hoc, constant, interval, textbox or switch variable it shows the panel once and logs an error; over a query, custom or datasource variable with neither multi nor includeAll there is only ever one value. A repeat naming no variable is GRAF103.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const graf110: PostSynthCheck;
+//# sourceMappingURL=graf110.d.ts.map

package/dist/lint/post-synth/graf110.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graf110.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/graf110.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,OAAO,EAAE,cAOrB,CAAC"}

package/dist/lint/post-synth/graf111.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GRAF111: An alert rule's condition, expression inputs or refIds do not fit together
+ *
+ * Each alert rule's condition, each server-side expression's inputs (a reduce, threshold or resample `expression`, the `$A` references of a math expression, a classic condition's query) and a recording rule's record.from must name a refId of the same rule; refIds must be unique, and a rule needs a condition unless it records. Each expression model is also validated against the pinned `expr` schema (a missing reducer, an unknown evaluator type). Grafana refuses such a rule, and a refused rule stops it provisioning every alerting file at startup.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const graf111: PostSynthCheck;
+//# sourceMappingURL=graf111.d.ts.map

package/dist/lint/post-synth/graf111.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graf111.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/graf111.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,OAAO,EAAE,cAOrB,CAAC"}

package/dist/lint/post-synth/graf112.d.ts

@@ -0,0 +1,8 @@
+/**
+ * GRAF112: An alert rule queries a datasource the build does not declare, or of another type
+ *
+ * Each alert rule query's datasourceUid must be a datasource the build declares: a Datasource it provisions or an ExternalDatasource that already exists in Grafana. A query whose model states a datasource type (model.datasource.type) must match the declared type, and a recording rule's targetDatasourceUid must be a declared Prometheus datasource. With no datasource declared at all, it warns once that it cannot check.
+ */
+import type { PostSynthCheck } from "@intentius/chant/lint/post-synth";
+export declare const graf112: PostSynthCheck;
+//# sourceMappingURL=graf112.d.ts.map

package/dist/lint/post-synth/graf112.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graf112.d.ts","sourceRoot":"","sources":["../../../src/lint/post-synth/graf112.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAyC,MAAM,kCAAkC,CAAC;AAG9G,eAAO,MAAM,OAAO,EAAE,cAOrB,CAAC"}