@intentius/chant-lexicon-grafana 0.97.0 → 0.99.0

package/dist/transformations.d.ts

@@ -0,0 +1,459 @@
+/**
+ * Panel transformations, typed per transformer.
+ *
+ * The dashboard schema types a transformation as `{ id: string; options:
+ * {} }`: foundation-sdk v0.0.20 has no schema for any transformer's options.
+ * The option types below are transcribed from the transformers Grafana
+ * v13.2.2 registers (tag v13.2.2, commit
+ * 3db12332b66497c31f8ad2a5fb0eb0fe0ca05a7e):
+ *
+ * - `packages/grafana-data/src/transformations/transformers/<id>.ts` for the
+ *   standard transformers, `transformers/ids.ts` for their ids;
+ * - `public/app/features/transformers/**` for the ones the app registers
+ *   (heatmap, extractFields, configFromData, rowsToFields, joinByLabels,
+ *   partitionByValues, prepareTimeSeries, timeSeriesTable, regression,
+ *   smoothing, spatial, fieldLookup);
+ * - enums from `fieldReducer.ts` (ReducerID), `utils/binaryOperators.ts`,
+ *   `utils/unaryOperators.ts`, `types/dataFrame.ts` (FieldType,
+ *   EnumFieldConfig), `types/data.ts` (NullValueMode),
+ *   `types/transformations.ts` (SpecialValue),
+ *   `transformers/joinShared.ts` (JoinMode) and
+ *   `matchers/nameMatcher.ts` (RegexpOrNamesMatcherOptions).
+ *
+ * Every top-level option is optional: Grafana spreads each transformer's
+ * `defaultOptions` under the stored options before it runs
+ * (`transformDataFrame`), so a dashboard stores only what was set. Nested
+ * objects keep Grafana's required fields.
+ *
+ * A transformation whose id Grafana doesn't register (a plugin's), or whose
+ * options this file doesn't know, goes through `customTransformation()`.
+ */
+import type { MatcherConfig } from "./schema/dashboard.gen.js";
+import type { HeatmapCalculationOptions } from "./schema/heatmap.gen.js";
+import type { FrameGeometrySource } from "./schema/geomap.gen.js";
+/** `ReducerID` in `fieldReducer.ts`. */
+export type ReducerId = "sum" | "max" | "min" | "logmin" | "mean" | "variance" | "stdDev" | "last" | "median" | "first" | "count" | "countAll" | "range" | "diff" | "diffperc" | "delta" | "step" | "firstNotNull" | "lastNotNull" | "changeCount" | "distinctCount" | "allIsZero" | "allIsNull" | "allValues" | "uniqueValues" | `p${Percentile}`;
+type Digit = "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9";
+type NonZeroDigit = Exclude<Digit, "0">;
+/** p1 to p99. */
+type Percentile = NonZeroDigit | `${NonZeroDigit}${Digit}`;
+/** `FieldType` in `types/dataFrame.ts`. */
+export type FieldTypeId = "time" | "number" | "string" | "boolean" | "trace" | "geo" | "enum" | "other" | "frame" | "nestedFrames";
+/** `SpecialValue` in `types/transformations.ts`. */
+export type SpecialValue = "true" | "false" | "null" | "empty" | "zero";
+/** `NullValueMode` in `types/data.ts`. */
+export type NullValueMode = "null" | "connected" | "null as zero";
+/** `RegexpOrNamesMatcherOptions` in `matchers/nameMatcher.ts`. */
+export interface RegexpOrNamesMatcherOptions {
+    pattern?: string;
+    names?: string[];
+    variable?: string;
+}
+/** `calculateField.ts`. */
+export interface CalculateFieldOptions {
+    timeSeries?: boolean;
+    mode?: "reduceRow" | "cumulativeFunctions" | "windowFunctions" | "binary" | "unary" | "index";
+    reduce?: {
+        include?: string[];
+        reducer: ReducerId;
+        nullValueMode?: NullValueMode;
+    };
+    window?: {
+        field?: string;
+        reducer: ReducerId;
+        windowSize?: number;
+        windowSizeMode?: "percentage" | "fixed";
+        windowAlignment?: "trailing" | "centered";
+    };
+    cumulative?: {
+        field?: string;
+        reducer: ReducerId;
+    };
+    binary?: {
+        left: CalculateFieldBinaryValue;
+        operator: "+" | "-" | "/" | "*";
+        right: CalculateFieldBinaryValue;
+    };
+    unary?: {
+        operator: "abs" | "exp" | "ln" | "round" | "floor" | "ceil" | "percent";
+        fieldName: string;
+    };
+    index?: {
+        asPercentile: boolean;
+    };
+    replaceFields?: boolean;
+    alias?: string;
+}
+/**
+ * One side of a binary calculation. Grafana 10.3 and later store
+ * `{ fixed }` or `{ matcher: { id: "byName", options } }`; older
+ * dashboards store the field name or number as a plain string, which
+ * Grafana still reads.
+ */
+export type CalculateFieldBinaryValue = string | {
+    fixed?: string;
+    matcher?: {
+        id?: string;
+        options?: string;
+    };
+};
+/** `concat.ts`. */
+export interface ConcatenateOptions {
+    frameNameMode?: "drop" | "field" | "label";
+    frameNameLabel?: string;
+}
+/** `convertFieldType.ts`. */
+export interface ConvertFieldTypeOptions {
+    conversions?: Array<{
+        targetField?: string;
+        destinationType?: FieldTypeId;
+        dateFormat?: string;
+        joinWith?: string;
+        timezone?: string;
+        enumConfig?: {
+            text?: string[];
+            color?: string[];
+            icon?: string[];
+            description?: string[];
+        };
+    }>;
+}
+/** `convertFrameType.ts`. */
+export interface ConvertFrameTypeOptions {
+    targetType?: "exemplar" | "timeRegion" | "annotation";
+}
+/** `filter.ts` (filterFields and filterFrames). */
+export interface FilterOptions {
+    include?: MatcherConfig;
+    exclude?: MatcherConfig;
+}
+/** `filterByName.ts`. */
+export interface FilterFieldsByNameOptions {
+    include?: RegexpOrNamesMatcherOptions;
+    exclude?: RegexpOrNamesMatcherOptions;
+    byVariable?: boolean;
+}
+/** `filterByRefId.ts`. */
+export interface FilterByRefIdOptions {
+    include?: string;
+    exclude?: string;
+}
+/** `filterByValue.ts`. `config` is a value matcher: `{ id: "greater", options: { value: 10 } }`. */
+export interface FilterByValueOptions {
+    filters?: Array<{
+        fieldName: string;
+        config: MatcherConfig;
+    }>;
+    type?: "exclude" | "include";
+    match?: "all" | "any";
+}
+/** `formatString.ts`. */
+export interface FormatStringOptions {
+    stringField?: string;
+    substringStart?: number;
+    substringEnd?: number;
+    outputFormat?: "Upper Case" | "Lower Case" | "Sentence Case" | "Title Case" | "Pascal Case" | "Camel Case" | "Snake Case" | "Kebab Case" | "Trim" | "Substring";
+}
+/** `formatTime.ts`. `useTimezone` is in its `defaultOptions`. */
+export interface FormatTimeOptions {
+    timeField?: string;
+    outputFormat?: string;
+    timezone?: string;
+    useTimezone?: boolean;
+}
+/** `groupBy.ts`, per field. */
+export interface GroupByFieldOptions {
+    aggregations: ReducerId[];
+    operation: "aggregate" | "groupby" | null;
+}
+/** `groupBy.ts`. */
+export interface GroupByOptions {
+    fields?: Record<string, GroupByFieldOptions>;
+}
+/** `groupToNestedTable.ts`: per-field options, or (V2) matcher rules. */
+export interface GroupToNestedTableOptions {
+    showSubframeHeaders?: boolean;
+    expandAllRows?: boolean;
+    fields?: Record<string, GroupByFieldOptions>;
+    rules?: Array<{
+        matcher: MatcherConfig;
+        operation: "aggregate" | "groupby" | null;
+        aggregations: ReducerId[];
+        keepNestedField?: boolean;
+    }>;
+}
+/** `groupingToMatrix.ts`. */
+export interface GroupingToMatrixOptions {
+    columnField?: string;
+    rowField?: string;
+    valueField?: string;
+    emptyValue?: SpecialValue;
+}
+/** `histogram.ts`. The editor stores sizes and offsets as numbers or strings. */
+export interface HistogramOptions {
+    bucketCount?: number;
+    bucketSize?: number | string;
+    bucketOffset?: number | string;
+    combine?: boolean;
+}
+/** `joinByField.ts` (and the deprecated `seriesToColumns`). */
+export interface JoinByFieldOptions {
+    byField?: string;
+    mode?: "outer" | "inner" | "outerTabular";
+}
+/** `labelsToFields.ts`. */
+export interface LabelsToFieldsOptions {
+    mode?: "columns" | "rows";
+    keepLabels?: string[];
+    valueLabel?: string;
+}
+/** `limit.ts`. A string is a variable reference. */
+export interface LimitOptions {
+    limitField?: number | string;
+}
+/** `order.ts`. */
+export interface OrderOptions {
+    indexByName?: Record<string, number>;
+    orderByMode?: "manual" | "auto";
+    orderBy?: Array<{
+        type: "name" | "label";
+        name?: string;
+        desc?: boolean;
+    }>;
+}
+/** `rename.ts`. */
+export interface RenameOptions {
+    renameByName?: Record<string, string>;
+}
+/** `organize.ts`: order, rename and exclude in one. */
+export interface OrganizeOptions extends OrderOptions, RenameOptions {
+    excludeByName?: Record<string, boolean>;
+    includeByName?: Record<string, boolean>;
+}
+/** `reduce.ts`. `fields` limits which fields are reduced. */
+export interface ReduceOptions {
+    reducers?: ReducerId[];
+    fields?: MatcherConfig;
+    mode?: "seriesToRows" | "reduceFields";
+    includeTimeField?: boolean;
+    labelsToFields?: boolean;
+}
+/** `renameByRegex.ts`. */
+export interface RenameByRegexOptions {
+    regex?: string;
+    renamePattern?: string;
+}
+/** `sortBy.ts`. Grafana uses only the first entry. */
+export interface SortByOptions {
+    sort?: Array<{
+        field: string;
+        desc?: boolean;
+        index?: number;
+    }>;
+}
+/** `transpose.ts`. */
+export interface TransposeOptions {
+    firstFieldName?: string;
+    restFieldsName?: string;
+    emptyValue?: SpecialValue;
+}
+/** A transformer that takes no options (merge, noop, seriesToRows, ensureColumns). */
+export type NoOptions = Record<string, never>;
+/** `fieldToConfigMapping/fieldToConfigMapping.ts`. */
+export interface FieldToConfigMapping {
+    fieldName: string;
+    reducerId?: ReducerId;
+    handlerKey: string | null;
+    handlerArguments?: {
+        threshold?: {
+            color?: string;
+        };
+    };
+}
+/** `configFromQuery/configFromQuery.ts`. */
+export interface ConfigFromDataOptions {
+    configRefId?: string;
+    mappings?: FieldToConfigMapping[];
+    applyTo?: MatcherConfig;
+}
+/** `extractFields/types.ts`. */
+export interface ExtractFieldsOptions {
+    source?: string;
+    jsonPaths?: Array<{
+        path: string;
+        alias?: string;
+    }>;
+    delimiter?: string;
+    regExp?: string;
+    format?: "json" | "kvp" | "auto" | "regexp" | "delimiter";
+    replace?: boolean;
+    keepTime?: boolean;
+}
+/** `lookupGazetteer/fieldLookup.ts`. */
+export interface FieldLookupOptions {
+    lookupField?: string;
+    gazetteer?: string;
+}
+/** `calculateHeatmap/heatmap.ts`: the heatmap panel's calculation options, plus `keepOriginalData`. */
+export interface HeatmapTransformOptions extends HeatmapCalculationOptions {
+    keepOriginalData?: boolean;
+}
+/** `joinByLabels/joinByLabels.ts`. */
+export interface JoinByLabelsOptions {
+    value?: string;
+    join?: string[];
+}
+/** `partitionByValues/partitionByValues.ts`. */
+export interface PartitionByValuesOptions {
+    fields?: string[];
+    naming?: {
+        asLabels?: boolean;
+        append?: boolean;
+        withNames?: boolean;
+        separator1?: string;
+        separator2?: string;
+    };
+    keepFields?: boolean;
+}
+/** `prepareTimeSeries/prepareTimeSeries.ts`. */
+export interface PrepareTimeSeriesOptions {
+    format?: "wide" | "long" | "multi" | "many";
+}
+/** `regression/regression.ts`. */
+export interface RegressionOptions {
+    modelType?: "linear" | "polynomial";
+    degree?: number;
+    xFieldName?: string;
+    yFieldName?: string;
+    predictionCount?: number;
+}
+/** `rowsToFields/rowsToFields.ts`. */
+export interface RowsToFieldsOptions {
+    nameField?: string;
+    valueField?: string;
+    mappings?: FieldToConfigMapping[];
+}
+/** `smoothing/smoothing.ts`. */
+export interface SmoothingOptions {
+    resolution?: number;
+}
+/** `spatial/models.gen.ts`. */
+export interface SpatialOptions {
+    action?: "prepare" | "calculate" | "modify";
+    source?: FrameGeometrySource;
+    calculate?: {
+        calc?: "heading" | "distance" | "area";
+        field?: string;
+    };
+    modify?: {
+        op: "asLine" | "lineBuilder";
+        target?: FrameGeometrySource;
+    };
+}
+/** `timeSeriesTable/timeSeriesTableTransformer.ts`: per query refId. */
+export type TimeSeriesTableOptions = Record<string, {
+    stat?: ReducerId;
+    timeField?: string;
+    inlineStat?: boolean;
+}>;
+/** Every transformer Grafana v13.2.2 registers, by the id a dashboard stores, and its options. */
+export interface TransformationOptionsById {
+    calculateField: CalculateFieldOptions;
+    concatenate: ConcatenateOptions;
+    configFromData: ConfigFromDataOptions;
+    convertFieldType: ConvertFieldTypeOptions;
+    convertFrameType: ConvertFrameTypeOptions;
+    ensureColumns: NoOptions;
+    extractFields: ExtractFieldsOptions;
+    fieldLookup: FieldLookupOptions;
+    filterByRefId: FilterByRefIdOptions;
+    filterByValue: FilterByValueOptions;
+    filterFields: FilterOptions;
+    filterFieldsByName: FilterFieldsByNameOptions;
+    filterFrames: FilterOptions;
+    formatString: FormatStringOptions;
+    formatTime: FormatTimeOptions;
+    groupBy: GroupByOptions;
+    groupToNestedTable: GroupToNestedTableOptions;
+    groupingToMatrix: GroupingToMatrixOptions;
+    heatmap: HeatmapTransformOptions;
+    histogram: HistogramOptions;
+    joinByField: JoinByFieldOptions;
+    joinByLabels: JoinByLabelsOptions;
+    labelsToFields: LabelsToFieldsOptions;
+    limit: LimitOptions;
+    merge: NoOptions;
+    noop: NoOptions;
+    order: OrderOptions;
+    organize: OrganizeOptions;
+    partitionByValues: PartitionByValuesOptions;
+    prepareTimeSeries: PrepareTimeSeriesOptions;
+    reduce: ReduceOptions;
+    regression: RegressionOptions;
+    rename: RenameOptions;
+    renameByRegex: RenameByRegexOptions;
+    rowsToFields: RowsToFieldsOptions;
+    /** Deprecated in Grafana for `joinByField`, which takes the same options. */
+    seriesToColumns: JoinByFieldOptions;
+    seriesToRows: NoOptions;
+    smoothing: SmoothingOptions;
+    sortBy: SortByOptions;
+    spatial: SpatialOptions;
+    timeSeriesTable: TimeSeriesTableOptions;
+    transpose: TransposeOptions;
+}
+export type TransformationId = keyof TransformationOptionsById;
+/** The fields every transformation has besides its id and options (`DataTransformerConfig`). */
+export interface TransformationCommon {
+    /** A disabled transformation is skipped. */
+    disabled?: boolean;
+    /** Apply it only to the frames this matcher selects. */
+    filter?: MatcherConfig;
+    /** Where its input frames come from. */
+    topic?: "series" | "annotations" | "alertStates";
+}
+/** A transformation Grafana registers, with its options typed. */
+export type KnownTransformation = {
+    [K in TransformationId]: TransformationCommon & {
+        id: K;
+        options?: TransformationOptionsById[K];
+    };
+}[TransformationId];
+declare const custom: unique symbol;
+/** A transformation built by `customTransformation()`: any id, untyped options. */
+export interface CustomTransformation extends TransformationCommon {
+    id: string;
+    options: Record<string, unknown>;
+    /** Type-only: a plain object literal can't pose as one, so a typo in a known id or option is still an error. */
+    readonly [custom]: true;
+}
+/** What a panel's `transformations` takes. */
+export type Transformation = KnownTransformation | CustomTransformation;
+/**
+ * A transformation Grafana registers, typed by its id:
+ *
+ * ```ts
+ * transformation("organize", { excludeByName: { Time: true }, renameByName: { Value: "Requests" } })
+ * ```
+ *
+ * The same as writing `{ id: "organize", options: { ... } }` in `transformations`.
+ */
+export declare function transformation<K extends TransformationId>(id: K, options?: TransformationOptionsById[K], common?: TransformationCommon): Extract<KnownTransformation, {
+    id: K;
+}>;
+/**
+ * A transformation with any id and options, for a plugin's transformer, or
+ * options newer than the ones typed here. Written to the dashboard as given,
+ * with any other keys in `common` beside them.
+ */
+export declare function customTransformation(id: string, options?: Record<string, unknown>, common?: TransformationCommon & Record<string, unknown>): CustomTransformation;
+export declare const TRANSFORMATION_IDS: readonly TransformationId[];
+/**
+ * Why a transformation as stored can't be written as a typed one, or
+ * undefined when it can: an id Grafana doesn't register, a key beside
+ * `options` the config doesn't have, or an option key its transformer
+ * doesn't take.
+ */
+export declare function untypedTransformationReason(t: Record<string, unknown>): string | undefined;
+export {};
+//# sourceMappingURL=transformations.d.ts.map

package/dist/transformations.d.ts.map

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

package/dist/util.d.ts

@@ -3,6 +3,12 @@
 export type DeepPartial<T> = T extends (infer U)[] ? DeepPartial<U>[] : T extends object ? {
     [K in keyof T]?: DeepPartial<T[K]>;
 } : T;
+/**
+ * The props a declaration class takes: `PropsOf<typeof TimeSeriesPanel>["options"]`
+ * types a const that is passed as a panel's `options`. The TypeScript
+ * `chant import` writes annotates its lifted consts this way.
+ */
+export type PropsOf<C extends abstract new (props: any) => unknown> = NonNullable<ConstructorParameters<C>[0]>;
 /** Grafana's uid alphabet: letters, digits, `-` and `_`, at most 40 characters. */
 export declare const UID_PATTERN: RegExp;
 export declare function isValidUid(uid: string): boolean;

package/dist/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,0FAA0F;AAC1F,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC9C,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACtC,CAAC,CAAC;AAER,mFAAmF;AACnF,eAAO,MAAM,WAAW,QAA0B,CAAC;AAEnD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ5C;AAED,0FAA0F;AAC1F,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAUtC"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAElE,0FAA0F;AAC1F,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAC9C,WAAW,CAAC,CAAC,CAAC,EAAE,GAChB,CAAC,SAAS,MAAM,GACd;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACtC,CAAC,CAAC;AAER;;;;GAIG;AAEH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,QAAQ,MAAM,KAAK,EAAE,GAAG,KAAK,OAAO,IAAI,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/G,mFAAmF;AACnF,eAAO,MAAM,WAAW,QAA0B,CAAC;AAEnD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ5C;AAED,0FAA0F;AAC1F,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAUtC"}

package/dist/validate-alerting.d.ts

@@ -0,0 +1,65 @@
+/**
+ * The checks behind GRAF111-GRAF114, and the alert-rule half of GRAF108, as
+ * plain functions over alerting provisioning files (parsed). The
+ * post-synth checks run them over a build's output; a test or another
+ * lexicon holding the same YAML can call them directly.
+ *
+ * - GRAF111: a rule's queries and expressions fit together: its condition,
+ *   each expression's inputs and a recording rule's `record.from` name a
+ *   refId of the rule, refIds are unique, and each expression model is
+ *   valid for the pinned `expr` schema.
+ * - GRAF112: each query's datasource is one the build knows (provisioned or
+ *   `ExternalDatasource`), and of the type the query model says.
+ * - GRAF113: the policy tree and rules route to contact points and mute
+ *   timings the build declares, and their matchers parse.
+ * - GRAF114: uids, names, titles and intervals Grafana accepts, and nothing
+ *   declared twice (a duplicate stops Grafana provisioning every alerting
+ *   file at startup).
+ *
+ * Like GRAF101, a reference check only reports an error when the build
+ * declares things of that kind; with none declared it warns once that it
+ * cannot check, since the thing may already exist in Grafana.
+ */
+import type { KnownDatasource } from "./datasource-refs.js";
+type Json = Record<string, unknown>;
+/** One alerting provisioning file, parsed, and where it came from. */
+export interface AlertingDoc {
+    source?: string;
+    json: Json;
+}
+export type AlertingIssueCode = "GRAF108" | "GRAF111" | "GRAF112" | "GRAF113" | "GRAF114";
+export interface AlertingIssue {
+    code: AlertingIssueCode;
+    severity: "error" | "warning";
+    message: string;
+    /** The rule uid, contact point or group the issue is about. */
+    entity?: string;
+}
+/** Contact point names Grafana has without provisioning: the default email contact point. */
+export declare const BUILTIN_CONTACT_POINTS: ReadonlySet<string>;
+export interface RuleInfo {
+    rule: Json;
+    group: Json;
+    /** `rule "<title>" (uid <uid>)`. */
+    where: string;
+}
+/** Every rule of every group across the files. */
+export declare function alertRules(docs: readonly AlertingDoc[]): RuleInfo[];
+/** The refIds an expression reads. */
+export declare function expressionInputs(model: Json): string[];
+export declare function checkRuleQueries(docs: readonly AlertingDoc[]): AlertingIssue[];
+export declare function checkRuleDatasources(docs: readonly AlertingDoc[], known: ReadonlyMap<string, KnownDatasource>): AlertingIssue[];
+/** Every PromQL expression an alert rule sends to Prometheus, and where it is written. */
+export declare function alertRulePromql(docs: readonly AlertingDoc[], known: ReadonlyMap<string, KnownDatasource>): Array<{
+    where: string;
+    expr: string;
+    entity: string;
+}>;
+/** GRAF108 over alert rules: the PromQL of each query that reaches Prometheus parses. */
+export declare function checkRulePromql(docs: readonly AlertingDoc[], known: ReadonlyMap<string, KnownDatasource>): AlertingIssue[];
+export declare function checkNotificationRefs(docs: readonly AlertingDoc[]): AlertingIssue[];
+/** Grafana's scheduler ticks every 10 seconds; a group's interval must be a positive multiple of it. */
+export declare const BASE_INTERVAL_SECONDS = 10;
+export declare function checkAlertingIdentity(docs: readonly AlertingDoc[]): AlertingIssue[];
+export {};
+//# sourceMappingURL=validate-alerting.d.ts.map

package/dist/validate-alerting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-alerting.d.ts","sourceRoot":"","sources":["../src/validate-alerting.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKzD,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEpC,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,6FAA6F;AAC7F,eAAO,MAAM,sBAAsB,EAAE,WAAW,CAAC,MAAM,CAAsC,CAAC;AAe9F,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,IAAI,CAAC;IACX,KAAK,EAAE,IAAI,CAAC;IACZ,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;CACf;AAED,kDAAkD;AAClD,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,GAAG,QAAQ,EAAE,CAUnE;AAYD,sCAAsC;AACtC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,CAwBtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,GAAG,aAAa,EAAE,CA0C9E;AAaD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,aAAa,EAAE,CA6C/H;AAED,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAajK;AAED,yFAAyF;AACzF,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,aAAa,EAAE,CAO1H;AAqBD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,GAAG,aAAa,EAAE,CAiEnF;AAaD,wGAAwG;AACxG,eAAO,MAAM,qBAAqB,KAAK,CAAC;AAIxC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,GAAG,aAAa,EAAE,CA2EnF"}

package/dist/validate-output.d.ts

@@ -1,16 +1,22 @@
 /**
- * The checks behind GRAF101-GRAF107, as plain functions over built Grafana
- * output: dashboard JSON documents and provisioned datasources. The
+ * The checks behind GRAF101-GRAF109, GRAF111-GRAF114 and GRAF115, as plain
+ * functions over built Grafana output: dashboard JSON documents, provisioned
+ * datasources, dashboard providers and alerting provisioning files (the
+ * alerting checks are in `validate-alerting.ts`). The
  * post-synth checks run them over a build; anything else holding the same
  * JSON (a test, another lexicon embedding dashboards) can call them directly.
  *
  * Checks that join a dashboard against datasources (GRAF101, GRAF102) only
- * see the datasources passed in. In a build that is the build root being
- * built (chant #1939): with no datasource declared in it they report
- * nothing, and a datasource declared in another build root looks undeclared.
+ * see the datasources passed in: the ones provisioned and the ones declared
+ * with `ExternalDatasource`. In a build that is the build root being built
+ * (chant #1939). With none declared they warn that references cannot be
+ * checked; a datasource that exists in Grafana but is not declared looks
+ * undeclared, so declare it with `ExternalDatasource`.
  */
-import type { ProvisionedDatasource } from "./build.js";
-export type GrafanaIssueCode = "GRAF101" | "GRAF102" | "GRAF103" | "GRAF104" | "GRAF105" | "GRAF106" | "GRAF107";
+import type { ExternalDatasourceRecord, ProvisionedDatasource } from "./build.js";
+import { variableReferences, type KnownDatasource } from "./datasource-refs.js";
+import { type AlertingDoc } from "./validate-alerting.js";
+export type GrafanaIssueCode = "GRAF101" | "GRAF102" | "GRAF103" | "GRAF104" | "GRAF105" | "GRAF106" | "GRAF107" | "GRAF108" | "GRAF109" | "GRAF111" | "GRAF112" | "GRAF113" | "GRAF114" | "GRAF115";
 export interface GrafanaIssue {
     code: GrafanaIssueCode;
     severity: "error" | "warning";
@@ -25,16 +31,50 @@ export interface DashboardDoc {
 }
 export interface GrafanaArtifacts {
     dashboards: DashboardDoc[];
+    /** Datasources the build provisions. */
     datasources: ProvisionedDatasource[];
+    /** Datasources the build references but does not provision (`ExternalDatasource`). */
+    externalDatasources?: ExternalDatasourceRecord[];
+    /** Entries of `providers:` in dashboard provisioning files, as written: any field may be missing. */
+    providers?: Array<Record<string, unknown>>;
+    /** Alerting provisioning files (rule groups, contact points, policies, mute timings, templates). */
+    alerting?: AlertingDoc[];
 }
-/** Every variable name referenced in a string. */
-export declare function variableReferences(text: string): string[];
+export type { AlertingDoc };
+export { variableReferences };
+type Json = Record<string, unknown>;
+/** The datasources a set of artifacts knows by uid: provisioned and external. */
+export declare function knownDatasourcesOf(a: GrafanaArtifacts): Map<string, KnownDatasource>;
 export declare function checkDatasourceRefs(a: GrafanaArtifacts): GrafanaIssue[];
 export declare function checkVariables(a: GrafanaArtifacts): GrafanaIssue[];
 export declare function checkDuplicates(a: GrafanaArtifacts): GrafanaIssue[];
 export declare function checkGrid(a: GrafanaArtifacts): GrafanaIssue[];
 export declare function checkIdentity(a: GrafanaArtifacts): GrafanaIssue[];
+/**
+ * A value the pinned schemas (with the correction overlay) do not allow is
+ * an error; a key they do not know is a warning, since newer Grafana
+ * versions add keys the pin has not caught up with.
+ */
 export declare function checkSchema(a: GrafanaArtifacts): GrafanaIssue[];
+/**
+ * Each panel query, query variable and alert rule query that reaches a
+ * Prometheus datasource is parsed as PromQL, with its template variables replaced by placeholders
+ * first (see `promql-check.ts`). A query whose datasource can't be told is
+ * not parsed.
+ */
+export declare function checkPromqlSyntax(a: GrafanaArtifacts): GrafanaIssue[];
+/** Every unit a panel sets, with where: field defaults, `unit` overrides, heatmap axes and cells, and a legacy graph panel's y-axes. */
+export declare function panelUnits(panel: Json): Array<{
+    where: string;
+    unit: string;
+}>;
+/**
+ * A unit Grafana doesn't register (at v13.2.2) and that isn't a custom
+ * `<kind>:` unit is shown as a literal suffix, so `"byte"` renders `5 byte`.
+ * A warning: it renders, just not as meant.
+ */
+export declare function checkUnits(a: GrafanaArtifacts): GrafanaIssue[];
+export declare function checkProvisioning(a: GrafanaArtifacts): GrafanaIssue[];
 /** The issues one check finds. */
 export declare function issuesFor(code: GrafanaIssueCode, a: GrafanaArtifacts): GrafanaIssue[];
 /** Every issue every check finds, in code order. */