@intentius/chant-lexicon-grafana 0.98.0 → 0.100.0

package/dist/op/builders.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Typed step builder for this lexicon's activity (chant #1288 Stage 2),
+ * beside its `*Args` interface for the reason `lexicons/k8s/src/op/builders.ts`
+ * gives: core cannot import a lexicon's types. `opts` is
+ * {@link GrafanaApplyArgs} itself (via `Omit`/`WithStepRefs`), never
+ * restated.
+ */
+import { type ActivityStep, type NamedActivityStep, type WithStepRefs } from "@intentius/chant/op";
+import type { GrafanaApplyArgs } from "./activities/grafana-apply.js";
+/** Extra opts the builder accepts alongside the activity's own fields. */
+type StepOpts = {
+    profile?: ActivityStep["profile"];
+    id?: string;
+};
+/**
+ * Apply a grafana build to the environment's Grafana over its HTTP API
+ * (#2948): folders, library panels and dashboards, stamped with chant's
+ * ownership labels, and with `prune`, this project's orphans deleted.
+ * `opts` is {@link GrafanaApplyArgs} minus the positional `indexPath`.
+ * Defaults to the `longInfra` profile, as the other API appliers do.
+ */
+export declare const grafanaApply: (indexPath: string, opts?: WithStepRefs<Omit<GrafanaApplyArgs, "indexPath">> & StepOpts) => NamedActivityStep;
+export {};
+//# sourceMappingURL=builders.d.ts.map

package/dist/op/builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.d.ts","sourceRoot":"","sources":["../../src/op/builders.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,0EAA0E;AAC1E,KAAK,QAAQ,GAAG;IAAE,OAAO,CAAC,EAAE,YAAY,CAAC,SAAS,CAAC,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GACvB,WAAW,MAAM,EACjB,OAAO,YAAY,CAAC,IAAI,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC,GAAG,QAAQ,KAClE,iBAGF,CAAC"}

package/dist/ownership.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Whose a live dashboard is (#2946).
+ *
+ * `serializer.ts` used to say Grafana had no metadata channel. It has two,
+ * both on the `dashboard.grafana.app` resource and neither in the dashboard
+ * JSON:
+ *
+ * - **`metadata.labels`**, which Grafana keeps as written for a dashboard
+ *   created or updated through `/apis`. chant's marker there is the shared
+ *   Kubernetes label convention, `LABEL_OWNERSHIP_KEYS`
+ *   (`app.kubernetes.io/managed-by: chant` plus the stack and env labels).
+ *   The API applier (#2948) stamps it with {@link grafanaOwnershipLabels};
+ *   this reads it back, stack and env included.
+ * - **`metadata.annotations`**, which Grafana writes itself for a
+ *   file-provisioned dashboard: `grafana.app/managedBy:
+ *   classic-file-provisioning` and `grafana.app/managerId: <provider name>`.
+ *   The provider name is the one chant writes into
+ *   `provisioning/dashboards/chant.yaml` (`chant` unless a
+ *   `DashboardProvider` names another), so a dashboard whose manager is one
+ *   of the project's providers is chant's. That channel carries no stack or
+ *   env, so it gives a verdict and never a marker.
+ *
+ * Anything else a read can see (a dashboard saved in the UI, one another
+ * provider or tool manages) is `foreign`.
+ *
+ * Two reads have no channel at all, and say `unknown` rather than guess:
+ * the legacy `/api/dashboards/uid` read Grafana 11 is observed through, and
+ * every datasource read (`/api/datasources` returns no labels, and the
+ * `readOnly` flag says a datasource is provisioned, not by whom).
+ */
+import { type ChannelKeys, type OwnershipMarker } from "@intentius/chant/ownership";
+import type { LiveDashboard } from "./api/dashboards.js";
+import type { LiveFolder } from "./api/folders.js";
+/** The label keys chant's marker uses on a `dashboard.grafana.app` resource. */
+export declare const GRAFANA_OWNERSHIP_KEYS: ChannelKeys;
+export declare const MANAGED_BY_ANNOTATION = "grafana.app/managedBy";
+export declare const MANAGER_ID_ANNOTATION = "grafana.app/managerId";
+/** `grafana.app/managedBy` for a dashboard loaded by a file provider. */
+export declare const FILE_PROVISIONING_MANAGER = "classic-file-provisioning";
+/**
+ * The provider name the build writes when a project declares none. It is
+ * chant's managed-by value on purpose: it comes back from Grafana as the
+ * `grafana.app/managerId` of every dashboard the provider loads.
+ */
+export declare const DEFAULT_PROVIDER_NAME = "chant";
+export type OwnershipVerdict = "owned" | "foreign" | "unknown";
+/** The labels the API applier (#2948) writes on a dashboard it creates, for this build's stack and env. */
+export declare function grafanaOwnershipLabels(ownership: {
+    stack: string;
+    env?: string;
+}): Record<string, string>;
+/**
+ * The provider names that load this project's dashboards: every declared
+ * `DashboardProvider`, or the default one the build writes when there is
+ * none.
+ */
+export declare function chantProviderNames(entities: Iterable<{
+    entityType: string;
+    props: Record<string, unknown>;
+}>): Set<string>;
+/** Why a verdict is what it is, for an `owned: true` read to put in its `filtered` detail. */
+export declare function ownershipGap(dashboard: LiveDashboard): string;
+/** A dashboard's ownership verdict, and the stack/env marker when its labels carry one. */
+export declare function dashboardOwnership(dashboard: LiveDashboard, providers: ReadonlySet<string>): {
+    ownership: OwnershipVerdict;
+    marker?: OwnershipMarker;
+};
+/**
+ * A folder's ownership verdict, read the way a dashboard's is: chant's labels
+ * (the API applier's), else the manager annotations Grafana writes on a
+ * folder that file provisioning made for one of this project's providers.
+ * A folder read over `/api/folders` (Grafana 11) has neither: `unknown`.
+ */
+export declare function folderOwnership(folder: LiveFolder, providers: ReadonlySet<string>): {
+    ownership: OwnershipVerdict;
+    marker?: OwnershipMarker;
+};
+//# sourceMappingURL=ownership.d.ts.map

package/dist/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../src/ownership.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAOL,KAAK,WAAW,EAChB,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,EAAE,WAAkC,CAAC;AAExE,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAC7D,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AAErE;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,UAA6B,CAAC;AAEhE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/D,2GAA2G;AAC3G,wBAAgB,sBAAsB,CAAC,SAAS,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAO1H;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM,CAI7D;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,aAAa,EACxB,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B;IAAE,SAAS,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,CAAA;CAAE,CAW3D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG;IAAE,SAAS,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,eAAe,CAAA;CAAE,CAU7I"}

package/dist/panel-options.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Hand-written option types for the built-in panels that have no schema.
+ *
+ * The alert list and flame graph panels define their options in TypeScript
+ * inside Grafana's frontend, with no CUE kind, so foundation-sdk publishes
+ * no JSON Schema for them and `npm run generate` has nothing to read. The
+ * types here follow Grafana's source at v13.2.2, cited per type. GRAF107
+ * checks these panels' envelope (the dashboard schema's `Panel`) but not
+ * their `options`; the traces panel is in the same position and keeps
+ * untyped options.
+ */
+import type { ThresholdsConfig, ValueMapping } from "./schema/dashboard.gen.js";
+/**
+ * How the alert list orders rules: `SortOrder` in
+ * public/app/plugins/panel/alertlist/types.ts:4-10 (a numeric enum starting at 1).
+ * 1 alphabetical ascending, 2 descending, 3 by importance, 4 time ascending, 5 time descending.
+ */
+export type AlertListSortOrder = 1 | 2 | 3 | 4 | 5;
+/** Which rule states the alert list shows: `StateFilter`, public/app/plugins/panel/alertlist/types.ts:22-30. */
+export interface AlertListStateFilter {
+    firing: boolean;
+    pending: boolean;
+    /** Kept for dashboards saved before 9.x. */
+    inactive: boolean;
+    recovering: boolean;
+    noData: boolean;
+    normal: boolean;
+    error: boolean;
+}
+/**
+ * The alert list panel's options: `UnifiedAlertListOptions`,
+ * public/app/plugins/panel/alertlist/types.ts:32-49 at v13.2.2. Defaults are in
+ * public/app/plugins/panel/alertlist/module.tsx.
+ */
+export interface AlertListOptions {
+    maxItems: number;
+    sortOrder: AlertListSortOrder;
+    /** Only rules from the dashboard the panel is on. */
+    dashboardAlerts: boolean;
+    groupMode: "default" | "custom";
+    groupBy: string[];
+    alertName: string;
+    showInstances: boolean;
+    /** Only rules in this folder; null for any. */
+    folder: {
+        uid: string;
+        title: string;
+    } | null;
+    stateFilter: AlertListStateFilter;
+    alertInstanceLabelFilter: string;
+    /** The rule source's datasource name, or null for all. */
+    datasource: string | null;
+    viewMode: "list" | "stat";
+    showInactiveAlerts: boolean;
+    /** `BigValueColorMode`, packages/grafana-ui/src/components/BigValue/BigValueTypes.ts:8-13. */
+    statColorMode: "background" | "background_solid" | "none" | "value";
+    statThresholds: ThresholdsConfig;
+    statValueMappings: ValueMapping[];
+}
+/** The flame graph panel's options: `Options`, public/app/plugins/panel/flamegraph/types.ts:1-3 at v13.2.2. */
+export interface FlameGraphOptions {
+    /** Hide the top table and show only the flame graph. */
+    showFlameGraphOnly: boolean;
+}
+//# sourceMappingURL=panel-options.d.ts.map

package/dist/panel-options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panel-options.d.ts","sourceRoot":"","sources":["../src/panel-options.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE7E;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEnD,gHAAgH;AAChH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,qDAAqD;IACrD,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,SAAS,GAAG,QAAQ,CAAC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,+CAA+C;IAC/C,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9C,WAAW,EAAE,oBAAoB,CAAC;IAClC,wBAAwB,EAAE,MAAM,CAAC;IACjC,0DAA0D;IAC1D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,8FAA8F;IAC9F,aAAa,EAAE,YAAY,GAAG,kBAAkB,GAAG,MAAM,GAAG,OAAO,CAAC;IACpE,cAAc,EAAE,gBAAgB,CAAC;IACjC,iBAAiB,EAAE,YAAY,EAAE,CAAC;CACnC;AAED,+GAA+G;AAC/G,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,kBAAkB,EAAE,OAAO,CAAC;CAC7B"}

package/dist/panels.d.ts

@@ -11,15 +11,17 @@
  *
  * `gridPos` is optional. A panel without `x` and `y` is placed by the
  * dashboard: left to right in declaration order, wrapping at Grafana's
- * 24-column width, below the previous row of panels. A panel with both is
- * placed exactly there, and GRAF105 reports overlaps.
+ * 24-column width, below the previous row of panels, and around any cells
+ * already taken. A panel with both is placed exactly there and reserves its
+ * cells first; GRAF105 reports overlaps between explicit panels. A panel
+ * with only `x` or only `y` keeps that column or line.
  */
 import type { Declarable } from "@intentius/chant/declarable";
 import type { DeepPartial } from "./util.js";
 import type { DatasourceInput, QueryEntity } from "./query.js";
 import type { VariableEntity } from "./variables.js";
 import type { SchemaName } from "./pin.js";
-import type { DashboardLink, DataTransformerConfig, FieldConfig, FieldConfigSource, GridPos } from "./schema/dashboard.gen.js";
+import type { DashboardLink, FieldConfig, FieldConfigSource, GridPos } from "./schema/dashboard.gen.js";
 import type * as timeseries from "./schema/timeseries.gen.js";
 import type * as stat from "./schema/stat.gen.js";
 import type * as gauge from "./schema/gauge.gen.js";
@@ -27,6 +29,19 @@ import type * as table from "./schema/table.gen.js";
 import type * as logs from "./schema/logs.gen.js";
 import type * as heatmap from "./schema/heatmap.gen.js";
 import type * as text from "./schema/text.gen.js";
+import type * as barchart from "./schema/barchart.gen.js";
+import type * as bargauge from "./schema/bargauge.gen.js";
+import type * as piechart from "./schema/piechart.gen.js";
+import type * as statetimeline from "./schema/statetimeline.gen.js";
+import type * as statushistory from "./schema/statushistory.gen.js";
+import type * as histogram from "./schema/histogram.gen.js";
+import type * as nodegraph from "./schema/nodegraph.gen.js";
+import type * as xychart from "./schema/xychart.gen.js";
+import type * as trend from "./schema/trend.gen.js";
+import type * as canvas from "./schema/canvas.gen.js";
+import type * as geomap from "./schema/geomap.gen.js";
+import type { AlertListOptions, FlameGraphOptions } from "./panel-options.js";
+import type { Transformation } from "./transformations.js";
 /** `fieldConfig` with `defaults.custom` typed for the panel. */
 export interface PanelFieldConfig<C> {
     defaults?: DeepPartial<Omit<FieldConfig, "custom">> & {
@@ -51,7 +66,8 @@ export interface PanelProps<O = Record<string, unknown>, C = Record<string, unkn
     /** The panel plugin's own options, typed from its schema. */
     options?: DeepPartial<O>;
     fieldConfig?: PanelFieldConfig<C>;
-    transformations?: DataTransformerConfig[];
+    /** Typed per transformer: `{ id: "organize", options: { ... } }`, `transformation(id, options)`, or `customTransformation()` for an id or option the types don't know. */
+    transformations?: Transformation[];
     links?: PanelLink[];
     /** Repeat the panel once per value of this variable. */
     repeat?: VariableEntity | string;
@@ -100,12 +116,12 @@ export declare function panelDefinitionFor(type: string): PanelDefinition | unde
  *
  * @example
  * ```ts
- * interface PieOptions { pieType?: "pie" | "donut"; legend?: { showLegend?: boolean } }
+ * interface ClockOptions { mode?: "time" | "countdown"; clockType?: "24 hour" | "12 hour" }
  *
- * export const PieChartPanel = definePanel<PieOptions>()({
- *   type: "piechart",
- *   className: "PieChartPanel",
- *   defaultSize: { w: 8, h: 8 },
+ * export const ClockPanel = definePanel<ClockOptions>()({
+ *   type: "grafana-clock-panel",
+ *   className: "ClockPanel",
+ *   defaultSize: { w: 6, h: 4 },
  * });
  * ```
  */
@@ -119,6 +135,19 @@ export declare const LogsPanel: PanelClass<"logs", logs.Options, Record<string,
 export declare const TracesPanel: PanelClass<"traces", Record<string, unknown>, Record<string, unknown>>;
 export declare const HeatmapPanel: PanelClass<"heatmap", heatmap.Options, heatmap.FieldConfig>;
 export declare const TextPanel: PanelClass<"text", text.Options, Record<string, unknown>>;
+export declare const BarChartPanel: PanelClass<"barchart", barchart.Options, barchart.FieldConfig>;
+export declare const BarGaugePanel: PanelClass<"bargauge", bargauge.Options, Record<string, unknown>>;
+export declare const PieChartPanel: PanelClass<"piechart", piechart.Options, piechart.HideableFieldConfig>;
+export declare const StateTimelinePanel: PanelClass<"state-timeline", statetimeline.Options, statetimeline.FieldConfig>;
+export declare const StatusHistoryPanel: PanelClass<"status-history", statushistory.Options, statushistory.FieldConfig>;
+export declare const HistogramPanel: PanelClass<"histogram", histogram.Options, histogram.FieldConfig>;
+export declare const NodeGraphPanel: PanelClass<"nodeGraph", nodegraph.Options, Record<string, unknown>>;
+export declare const XYChartPanel: PanelClass<"xychart", xychart.Options, xychart.FieldConfig>;
+export declare const TrendPanel: PanelClass<"trend", trend.Options, trend.GraphFieldConfig>;
+export declare const CanvasPanel: PanelClass<"canvas", canvas.Options, Record<string, unknown>>;
+export declare const GeomapPanel: PanelClass<"geomap", geomap.Options, Record<string, unknown>>;
+export declare const FlameGraphPanel: PanelClass<"flamegraph", FlameGraphOptions, Record<string, unknown>>;
+export declare const AlertListPanel: PanelClass<"alertlist", AlertListOptions, Record<string, unknown>>;
 export interface RowProps {
     title: string;
     /** Collapsed rows keep their panels inside the row until opened. */
@@ -128,6 +157,14 @@ export interface RowProps {
     repeat?: VariableEntity | string;
     datasource?: DatasourceInput<any>;
     id?: number;
+    /**
+     * The grid line the row header sits on. Without it, the row goes on the
+     * first free line below everything declared before it. A row header is
+     * always full width and one line high, so `y` is all it takes.
+     */
+    gridPos?: {
+        y: number;
+    };
 }
 export interface RowEntity extends Declarable {
     readonly props: RowProps;

package/dist/panels.d.ts.map

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

package/dist/pin.d.ts

@@ -5,12 +5,19 @@
  * kinds. `grafana/grafana-foundation-sdk` runs them through cog and
  * publishes, beside its builder libraries, one JSON Schema per kind under
  * `jsonschema/`. This lexicon vendors the files it uses into `src/spec/schemas/`
- * (exact bytes, at the commit below) and generates `src/schema/*.gen.ts`
- * from them. Nothing is fetched at build or test time.
+ * (exact bytes, at the commit below), applies the correction overlay in
+ * `src/spec/overlay/` (see `src/spec/overlay.ts`), and generates
+ * `src/schema/*.gen.ts` from the result. Nothing is fetched at build or test
+ * time.
+ *
+ * The types track Grafana 12.4 and 13.x: v0.0.20 is labelled with the
+ * v11.6.x kind registry, but its dashboard schema largely matches those
+ * releases, and the overlay covers the rest.
  *
  * Bumping the pin: change `ref` and `commit`, run `just fetch-schemas`
  * (downloads and prints the new digests), paste the digests here, run
- * `npm run generate`, and review the diff of `src/schema/`.
+ * `npm run generate` (it refuses overlay patches the new schemas already
+ * carry; delete those), and review the diff of `src/schema/`.
  */
 export interface GrafanaSchemaPin {
     /** Where the schema files come from. */
@@ -19,14 +26,29 @@ export interface GrafanaSchemaPin {
     ref: string;
     /** The exact commit the vendored files were taken from. */
     commit: string;
-    /** The Grafana kind registry version cog generated the schemas from. */
+    /**
+     * The kind registry label the SDK publishes the schemas under. It lags the
+     * content: the v0.0.20 schemas are labelled v11.6.x and cover 12.4 and 13.x.
+     */
     kindRegistry: string;
     /** sha256 of each vendored file, keyed by schema name (`src/spec/schemas/<name>.jsonschema.json`). */
-    files: Readonly<Record<SchemaName, string>>;
+    files: Readonly<Record<VendoredSchemaName, string>>;
 }
-export declare const SCHEMA_NAMES: readonly ["dashboard", "timeseries", "stat", "gauge", "table", "logs", "heatmap", "text", "prometheus", "tempo", "loki"];
+export declare const SCHEMA_NAMES: readonly ["dashboard", "timeseries", "stat", "gauge", "table", "logs", "heatmap", "text", "barchart", "bargauge", "piechart", "statetimeline", "statushistory", "histogram", "nodegraph", "xychart", "trend", "canvas", "geomap", "prometheus", "tempo", "loki", "elasticsearch", "cloudwatch", "azuremonitor", "googlecloudmonitoring", "bigquery", "grafanapyroscope", "expr"];
 export type SchemaName = (typeof SCHEMA_NAMES)[number];
+/**
+ * Schemas vendored from the same commit for reading, not for types: no
+ * `.gen.ts` is generated from them and GRAF107 does not use them, since chant
+ * builds classic dashboards. `dashboardv2` is the v2 dashboard kind the
+ * importer reads (#2947); `src/import/v2.test.ts` checks the importer knows
+ * every key it defines.
+ */
+export declare const IMPORT_ONLY_SCHEMA_NAMES: readonly ["dashboardv2"];
+export type ImportOnlySchemaName = (typeof IMPORT_ONLY_SCHEMA_NAMES)[number];
+/** Every schema file under `src/spec/schemas/`. */
+export type VendoredSchemaName = SchemaName | ImportOnlySchemaName;
+export declare const VENDORED_SCHEMA_NAMES: readonly VendoredSchemaName[];
 export declare const GRAFANA_SCHEMA_PIN: GrafanaSchemaPin;
 /** The raw URL of one schema file at the pinned commit. */
-export declare function schemaUrl(name: SchemaName, pin?: GrafanaSchemaPin): string;
+export declare function schemaUrl(name: VendoredSchemaName, pin?: GrafanaSchemaPin): string;
 //# sourceMappingURL=pin.d.ts.map

package/dist/pin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pin.d.ts","sourceRoot":"","sources":["../src/pin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,sGAAsG;IACtG,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;CAC7C;AAED,eAAO,MAAM,YAAY,0HAYf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD,eAAO,MAAM,kBAAkB,EAAE,gBAkB/B,CAAC;AAEH,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,GAAG,GAAE,gBAAqC,GAAG,MAAM,CAE9F"}
+{"version":3,"file":"pin.d.ts","sourceRoot":"","sources":["../src/pin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB,sGAAsG;IACtG,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAED,eAAO,MAAM,YAAY,kXA8Bf,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvD;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,0BAA2B,CAAC;AAEjE,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE7E,mDAAmD;AACnD,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,oBAAoB,CAAC;AAEnE,eAAO,MAAM,qBAAqB,EAAE,SAAS,kBAAkB,EAAmD,CAAC;AAEnH,eAAO,MAAM,kBAAkB,EAAE,gBAqC/B,CAAC;AAEH,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,IAAI,EAAE,kBAAkB,EAAE,GAAG,GAAE,gBAAqC,GAAG,MAAM,CAEtG"}

package/dist/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA0B9D;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,aAgF3B,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAmD9D;;;;;;;;GAQG;AACH,eAAO,MAAM,aAAa,EAAE,aAkI3B,CAAC"}

package/dist/promql-check.d.ts

@@ -0,0 +1,51 @@
+/**
+ * GRAF108: the PromQL a dashboard sends to Prometheus, syntax-checked with
+ * the prometheus lexicon's `checkPromql` (the grammar behind the Prometheus
+ * web UI's editor, `@prometheus-io/lezer-promql`).
+ *
+ * Only queries that reach a Prometheus datasource are parsed, as
+ * `datasourceUses()` resolves them: a query's own ref, else its panel's, a
+ * datasource variable's plugin type, or an undeclared ref's own `type`. A
+ * query whose datasource can't be told (no ref at all, a `-- Mixed --` panel
+ * query with none of its own) is left alone.
+ *
+ * Grafana interpolates template variables before Prometheus sees the query,
+ * so `$var`, `${var}`, `${var:format}`, `[[var]]` and the `$__` macros are
+ * replaced with a placeholder that parses where they stand: a duration
+ * inside `[...]` or after `offset`, a number for the `_ms`/`_s` macros and
+ * `$__from`/`$__to`, an identifier anywhere else. Inside a string literal
+ * they are left as they are.
+ */
+import { type KnownDatasource } from "./datasource-refs.js";
+type Json = Record<string, unknown>;
+export interface Substituted {
+    text: string;
+    /** Maps an offset in `text` back to one in the original query. */
+    originalOffset(at: number): number;
+}
+/** Replace every template variable outside a string literal with a placeholder that parses in its place. */
+export declare function substituteTemplateVariables(query: string): Substituted;
+export type PromqlSyntax = {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+};
+/** Check one query's PromQL syntax after substituting its template variables. */
+export declare function checkGrafanaPromql(query: string): PromqlSyntax;
+/**
+ * The PromQL inside a Prometheus query variable's query. Grafana handles
+ * `label_names()`, `label_values(selector, label)`, `metrics(regex)` and
+ * `query_result(expr)` itself and sends only the selector or expression; any
+ * other text is a series selector (`/api/v1/series?match[]=`).
+ */
+export declare function variablePromql(query: string): string[];
+/** One piece of PromQL a dashboard sends to Prometheus, and where it is written. */
+export interface PromqlUse {
+    where: string;
+    expr: string;
+}
+/** Every PromQL query a dashboard sends to Prometheus: panel queries, query variables and the library panels an export embeds in `__elements`. */
+export declare function prometheusQueries(dashboard: Json, known: ReadonlyMap<string, KnownDatasource>): PromqlUse[];
+export {};
+//# sourceMappingURL=promql-check.d.ts.map

package/dist/promql-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promql-check.d.ts","sourceRoot":"","sources":["../src/promql-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAA+B,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEtF,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAsBpC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;CACpC;AAED,4GAA4G;AAC5G,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CA0DtE;AAED,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAS9D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAWtD;AASD,oFAAoF;AACpF,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAuBD,kJAAkJ;AAClJ,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS,EAAE,CAa3G"}

package/dist/query-models.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Hand-written query models for the datasources that have no schema.
+ *
+ * PostgreSQL, MySQL and Microsoft SQL Server share one query model, defined
+ * in TypeScript in Grafana's `@grafana/sql` package with no CUE kind, so
+ * foundation-sdk publishes no JSON Schema for it and `npm run generate` has
+ * nothing to read. The types here follow `packages/grafana-sql/src` at
+ * Grafana v13.2.2, cited per type. The three plugins bundled with
+ * grafana/grafana:13.2.2 (grafana-postgresql-datasource 13.0.3, mysql 13.1.2,
+ * mssql 13.0.5) use this model unchanged. GRAF107 does not check these
+ * queries' fields; the dashboard schema's `Panel` still checks the panel.
+ */
+/** `QueryEditorExpressionType`, packages/grafana-sql/src/expressions.ts:34-42. */
+export type SqlExpressionType = "property" | "operator" | "or" | "and" | "groupBy" | "function" | "functionParameter";
+/** `QueryEditorProperty`, packages/grafana-sql/src/expressions.ts:5-8 (its type is the one-member `QueryEditorPropertyType`). */
+export interface SqlProperty {
+    type: "string";
+    name?: string;
+}
+/** `QueryEditorFunctionParameterExpression`, packages/grafana-sql/src/expressions.ts:64-67. */
+export interface SqlFunctionParameterExpression {
+    type: "functionParameter";
+    name?: string;
+}
+/** `QueryEditorFunctionExpression`, packages/grafana-sql/src/expressions.ts:57-62: a selected column, optionally wrapped in an aggregation. */
+export interface SqlFunctionExpression {
+    type: "function";
+    name?: string;
+    alias?: string;
+    parameters?: SqlFunctionParameterExpression[];
+}
+/** `QueryEditorGroupByExpression`, packages/grafana-sql/src/expressions.ts:52-55. */
+export interface SqlGroupByExpression {
+    type: "groupBy";
+    property: SqlProperty;
+}
+/** `QueryEditorPropertyExpression`, packages/grafana-sql/src/expressions.ts:29-32. */
+export interface SqlPropertyExpression {
+    type: "property";
+    property: SqlProperty;
+}
+/**
+ * The visual builder's query: `SQLExpression`, packages/grafana-sql/src/types.ts:67-77.
+ * `whereJsonTree` is react-awesome-query-builder's `JsonTree`, carried as data.
+ */
+export interface SqlBuilderQuery {
+    columns?: SqlFunctionExpression[];
+    whereJsonTree?: Record<string, unknown>;
+    whereString?: string;
+    filters?: Array<{
+        name: string;
+        value: string;
+    }>;
+    groupBy?: SqlGroupByExpression[];
+    orderBy?: SqlPropertyExpression;
+    orderByDirection?: "ASC" | "DESC";
+    limit?: number;
+    offset?: number;
+}
+/** `QueryFormat`, packages/grafana-sql/src/types.ts:39-42. */
+export type SqlQueryFormat = "time_series" | "table";
+/**
+ * A PostgreSQL, MySQL or MSSQL query: `SQLQuery`, packages/grafana-sql/src/types.ts:46-56,
+ * over `DataQuery` from @grafana/schema (refId, hide, key, queryType, datasource).
+ *
+ * In code mode (`editorMode: "code"`, `rawQuery: true`) `rawSql` is the
+ * query; in builder mode `dataset`, `table` and `sql` describe it and Grafana
+ * writes the generated SQL to `rawSql`.
+ */
+export interface SqlQueryModel {
+    refId?: string;
+    hide?: boolean;
+    key?: string;
+    queryType?: string;
+    datasource?: {
+        type?: string;
+        uid?: string;
+    };
+    /** The SQL, with Grafana's `$__timeFilter()` and other macros. */
+    rawSql?: string;
+    format?: SqlQueryFormat;
+    alias?: string;
+    dataset?: string;
+    table?: string;
+    sql?: SqlBuilderQuery;
+    /** `EditorMode` from @grafana/plugin-ui: the raw SQL editor or the visual builder. */
+    editorMode?: "code" | "builder";
+    rawQuery?: boolean;
+    /** `SQLQueryMeta`, packages/grafana-sql/src/types.ts:44: which columns a variable query takes its values and texts from. */
+    meta?: {
+        valueField?: string;
+        textField?: string;
+    };
+}
+//# sourceMappingURL=query-models.d.ts.map

package/dist/query-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-models.d.ts","sourceRoot":"","sources":["../src/query-models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kFAAkF;AAClF,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,IAAI,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,mBAAmB,CAAC;AAEtH,iIAAiI;AACjI,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,+FAA+F;AAC/F,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,mBAAmB,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,+IAA+I;AAC/I,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,8BAA8B,EAAE,CAAC;CAC/C;AAED,qFAAqF;AACrF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED,sFAAsF;AACtF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,WAAW,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAClC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjD,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACjC,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,gBAAgB,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,OAAO,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,4HAA4H;IAC5H,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD"}