@intentius/chant-lexicon-grafana 0.96.0

package/dist/variables.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Dashboard variables (Grafana's "templating"): query, custom, interval,
+ * datasource, constant and textbox.
+ *
+ * A variable is declared on its own and listed in a dashboard's
+ * `variables`. Queries reference it as `$name` or `${name}` in their
+ * expression; GRAF103 checks every such reference names a declared
+ * variable. A `DatasourceVariable` can stand in for a datasource on a panel
+ * or query, and the reference becomes `${name}`.
+ */
+import type { Declarable } from "@intentius/chant/declarable";
+import type { DatasourceEntity, DatasourceRef } from "./datasource.js";
+import type { VariableOption } from "./schema/dashboard.gen.js";
+export type VariableKind = "query" | "custom" | "interval" | "datasource" | "constant" | "textbox";
+/** Where the variable shows: with its label, without it, or not at all. */
+export type VariableHide = "label" | "valueOnly" | "hidden";
+interface CommonVariableProps {
+    /** The name queries use, `$name`. Letters, digits and `_`. */
+    name: string;
+    label?: string;
+    description?: string;
+    hide?: VariableHide;
+    /** Keep the value out of the URL. */
+    skipUrlSync?: boolean;
+    /** The value selected when the dashboard loads. */
+    current?: VariableOption;
+}
+interface MultiValueProps {
+    multi?: boolean;
+    includeAll?: boolean;
+    /** What `All` expands to, e.g. `.*` for a regex matcher. */
+    allValue?: string;
+}
+/** A variable anything can hold before its datasource is known: its own datasource ref or a datasource variable. */
+export type VariableDatasource = DatasourceEntity<any> | DatasourceRef | DatasourceVariableEntity<any>;
+export interface QueryVariableProps extends CommonVariableProps, MultiValueProps {
+    datasource: VariableDatasource;
+    /** The datasource's variable query, e.g. `label_values(up, job)` for Prometheus. */
+    query: string;
+    regex?: string;
+    /** When to re-run the query. Defaults to on dashboard load. */
+    refresh?: "never" | "onLoad" | "onTimeRangeChange";
+    /** Grafana's `VariableSort` (0 disabled, 1 alphabetical asc, 2 desc, 3 numerical asc, …). */
+    sort?: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+}
+export interface CustomVariableProps extends CommonVariableProps, MultiValueProps {
+    values: string[];
+}
+export interface IntervalVariableProps extends CommonVariableProps {
+    /** e.g. `["1m", "5m", "1h"]`. */
+    values: string[];
+    auto?: boolean;
+    autoCount?: number;
+    autoMin?: string;
+}
+export interface DatasourceVariableProps<T extends string = string> extends CommonVariableProps, MultiValueProps {
+    /** The datasource plugin id to choose among, e.g. `prometheus`. */
+    pluginType: T;
+    /** Only datasources whose name matches. */
+    regex?: string;
+}
+export interface ConstantVariableProps extends Omit<CommonVariableProps, "hide"> {
+    value: string;
+}
+export interface TextboxVariableProps extends CommonVariableProps {
+    value?: string;
+}
+export interface VariableEntity<P = CommonVariableProps> extends Declarable {
+    readonly props: P;
+    readonly variableKind: VariableKind;
+    /** The variable name, `$name` in queries. */
+    readonly variableName: string;
+}
+export interface DatasourceVariableEntity<T extends string = string> extends VariableEntity<DatasourceVariableProps<T>> {
+    readonly variableKind: "datasource";
+    readonly pluginType: T;
+}
+export declare const VARIABLE_TYPE_PREFIX = "Grafana::Variable::";
+/** A variable whose values come from a datasource query. */
+export declare const QueryVariable: new (props: QueryVariableProps) => VariableEntity<QueryVariableProps>;
+/** A variable with a fixed list of values. */
+export declare const CustomVariable: new (props: CustomVariableProps) => VariableEntity<CustomVariableProps>;
+/** A time interval to choose, used as `$name` in range selectors. */
+export declare const IntervalVariable: new (props: IntervalVariableProps) => VariableEntity<IntervalVariableProps>;
+/** A choice of datasource of one plugin type. Usable wherever a datasource is. */
+export declare const DatasourceVariable: {
+    new <T extends string>(props: DatasourceVariableProps<T>): DatasourceVariableEntity<T>;
+};
+/** A hidden, fixed value. */
+export declare const ConstantVariable: new (props: ConstantVariableProps) => VariableEntity<ConstantVariableProps>;
+/** A free-text box. */
+export declare const TextboxVariable: new (props: TextboxVariableProps) => VariableEntity<TextboxVariableProps>;
+export declare function isVariableEntity(value: unknown): value is VariableEntity;
+export declare function isDatasourceVariable(value: unknown): value is DatasourceVariableEntity;
+/** Variable names Grafana defines itself; queries may use them without declaring anything. */
+export declare function isBuiltinVariable(name: string): boolean;
+/** A valid variable name: what `$name` can match. */
+export declare const VARIABLE_NAME: RegExp;
+export {};
+//# sourceMappingURL=variables.d.ts.map

package/dist/variables.d.ts.map

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

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@intentius/chant-lexicon-grafana",
+  "version": "0.96.0",
+  "description": "Grafana lexicon for chant — typed dashboards, panels, queries and datasources, serialized to dashboard JSON and Grafana provisioning files",
+  "license": "Apache-2.0",
+  "homepage": "https://intentius.io/chant",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/INTENTIUS/chant.git",
+    "directory": "lexicons/grafana"
+  },
+  "bugs": {
+    "url": "https://github.com/INTENTIUS/chant/issues"
+  },
+  "keywords": [
+    "infrastructure-as-code",
+    "iac",
+    "typescript",
+    "grafana",
+    "dashboards",
+    "observability",
+    "prometheus",
+    "tempo",
+    "loki",
+    "chant"
+  ],
+  "type": "module",
+  "files": [
+    "src/",
+    "dist/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "development": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./src/index.ts"
+    },
+    "./*": {
+      "development": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "default": "./src/*.ts"
+    },
+    "./lint/post-synth": {
+      "development": "./src/lint/post-synth/index.ts",
+      "types": "./dist/lint/post-synth/index.d.ts",
+      "default": "./src/lint/post-synth/index.ts"
+    },
+    "./manifest": "./dist/manifest.json",
+    "./meta": "./dist/meta.json",
+    "./types": "./dist/types/index.d.ts"
+  },
+  "scripts": {
+    "generate": "tsx src/codegen/generate-cli.ts",
+    "bundle": "tsx src/package-cli.ts",
+    "validate": "tsx src/validate-cli.ts",
+    "docs": "tsx src/codegen/docs-cli.ts",
+    "prepack": "npm run generate && npm run bundle && npm run validate && npm run build",
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json && find dist -type f \\( -name \"*.js\" -o -name \"*.js.map\" \\) -delete"
+  },
+  "dependencies": {
+    "@intentius/chant-lexicon-otel": "*",
+    "@intentius/chant-lexicon-prometheus": "*",
+    "ajv": "^8.20.0",
+    "js-yaml": "^4.3.1"
+  },
+  "devDependencies": {
+    "@intentius/chant": "*",
+    "@types/js-yaml": "^4.0.9",
+    "tsc-alias": "^1.8.17",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@intentius/chant": "^0.96.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/build.test.ts

@@ -0,0 +1,210 @@
+import { describe, expect, test } from "vitest";
+import { Datasource } from "./datasource";
+import { Dashboard } from "./dashboard";
+import { Row, StatPanel, TextPanel, TimeSeriesPanel, TablePanel, definePanel } from "./panels";
+import { PromQuery, TempoQuery, LokiQuery, defineQuery } from "./query";
+import {
+  CustomVariable,
+  ConstantVariable,
+  DatasourceVariable,
+  IntervalVariable,
+  QueryVariable,
+  TextboxVariable,
+} from "./variables";
+import { panelsJson, renderDashboard, variableModel, dashboardJson, grafanaFiles, type PanelJson } from "./build";
+
+/** The panels array, read as plain panels (the tests below build no rows unless they say so). */
+function panelsOnly(items: Parameters<typeof panelsJson>[0]): PanelJson[] {
+  return panelsJson(items) as PanelJson[];
+}
+import { validateDashboardSchema } from "./schema-validate";
+
+const prometheus = new Datasource({ name: "Prometheus", type: "prometheus" });
+const tempo = new Datasource({ name: "Tempo", type: "tempo" });
+
+describe("layout", () => {
+  test("panels flow left to right and wrap at 24 columns", () => {
+    const stats = [1, 2, 3, 4, 5].map((i) => new StatPanel({ title: `s${i}` }));
+    const panels = panelsJson(stats);
+    expect(panels.map((p) => p.gridPos)).toEqual([
+      { h: 4, w: 6, x: 0, y: 0 },
+      { h: 4, w: 6, x: 6, y: 0 },
+      { h: 4, w: 6, x: 12, y: 0 },
+      { h: 4, w: 6, x: 18, y: 0 },
+      { h: 4, w: 6, x: 0, y: 4 },
+    ]);
+  });
+
+  test("a new line starts below the tallest panel of the line before", () => {
+    const panels = panelsJson([new StatPanel(), new TimeSeriesPanel(), new StatPanel(), new TextPanel()]);
+    expect(panels.map((p) => p.gridPos)).toEqual([
+      { h: 4, w: 6, x: 0, y: 0 },
+      { h: 8, w: 12, x: 6, y: 0 },
+      { h: 4, w: 6, x: 18, y: 0 },
+      { h: 3, w: 24, x: 0, y: 8 },
+    ]);
+  });
+
+  test("an explicit position is kept, and w/h without x/y only resize", () => {
+    const panels = panelsJson([
+      new StatPanel({ gridPos: { x: 12, y: 20, w: 12, h: 2 } }),
+      new StatPanel({ gridPos: { w: 24 } }),
+    ]);
+    expect(panels.map((p) => p.gridPos)).toEqual([
+      { h: 2, w: 12, x: 12, y: 20 },
+      { h: 4, w: 24, x: 0, y: 0 },
+    ]);
+  });
+
+  test("rows start below everything and their panels follow; a collapsed row nests them", () => {
+    const panels = panelsJson([
+      new TimeSeriesPanel({ title: "top" }),
+      new Row({ title: "open", panels: [new StatPanel({ title: "a" }), new StatPanel({ title: "b" })] }),
+      new Row({ title: "shut", collapsed: true, panels: [new TablePanel({ title: "c" })] }),
+      new StatPanel({ title: "after" }),
+    ]);
+    expect(panels.map((p) => [p.type, p.title, p.gridPos, p.id])).toEqual([
+      ["timeseries", "top", { h: 8, w: 12, x: 0, y: 0 }, 1],
+      ["row", "open", { h: 1, w: 24, x: 0, y: 8 }, 2],
+      ["stat", "a", { h: 4, w: 6, x: 0, y: 9 }, 3],
+      ["stat", "b", { h: 4, w: 6, x: 6, y: 9 }, 4],
+      ["row", "shut", { h: 1, w: 24, x: 0, y: 13 }, 5],
+      ["stat", "after", { h: 4, w: 6, x: 0, y: 14 }, 7],
+    ]);
+    const shut = panels[4] as unknown as { collapsed: boolean; panels: Array<{ title: string; id: number; gridPos: unknown }> };
+    expect(shut.collapsed).toBe(true);
+    expect(shut.panels.map((p) => [p.title, p.id, p.gridPos])).toEqual([["c", 6, { h: 8, w: 12, x: 0, y: 14 }]]);
+    expect((panels[1] as unknown as { panels: unknown[] }).panels).toEqual([]);
+  });
+
+  test("auto ids skip ids set explicitly", () => {
+    const panels = panelsJson([new StatPanel(), new StatPanel({ id: 1 }), new StatPanel()]);
+    expect(panels.map((p) => p.id)).toEqual([2, 1, 3]);
+  });
+});
+
+describe("datasources and targets", () => {
+  test("refIds default to A, B, C; an explicit refId is kept", () => {
+    const [panel] = panelsOnly([
+      new TimeSeriesPanel({ datasource: prometheus, targets: [new PromQuery({ expr: "a" }), new PromQuery({ expr: "b", refId: "errors" }), new PromQuery({ expr: "c" })] }),
+    ]);
+    expect(panel.targets!.map((t) => (t as { refId: string }).refId)).toEqual(["A", "errors", "C"]);
+  });
+
+  test("queries on different datasources make the panel Mixed", () => {
+    const [panel] = panelsOnly([
+      new TablePanel({ targets: [new PromQuery({ expr: "up", datasource: prometheus }), new TempoQuery({ query: "{}", datasource: tempo })] }),
+    ]);
+    expect(panel.datasource).toEqual({ type: "datasource", uid: "-- Mixed --" });
+    expect(panel.targets!.map((t) => (t as { datasource: unknown }).datasource)).toEqual([
+      { type: "prometheus", uid: "prometheus" },
+      { type: "tempo", uid: "tempo" },
+    ]);
+  });
+
+  test("a panel takes its queries' shared datasource, and a row passes its own down", () => {
+    const [shared] = panelsOnly([new StatPanel({ targets: [new PromQuery({ expr: "up", datasource: prometheus })] })]);
+    expect(shared.datasource).toEqual({ type: "prometheus", uid: "prometheus" });
+    const [, child] = panelsOnly([new Row({ title: "r", datasource: prometheus, panels: [new StatPanel({ targets: [new PromQuery({ expr: "up" })] })] })]);
+    expect((child.targets![0] as { datasource: unknown }).datasource).toEqual({ type: "prometheus", uid: "prometheus" });
+  });
+
+  test("a datasource variable is referenced as ${name}; a plain ref passes through", () => {
+    const ds = new DatasourceVariable({ name: "ds", pluginType: "prometheus" });
+    const [a, b] = panelsOnly([
+      new StatPanel({ datasource: ds, targets: [new PromQuery({ expr: "up" })] }),
+      new StatPanel({ datasource: { type: "prometheus", uid: "mimir" }, targets: [new PromQuery({ expr: "up" })] }),
+    ]);
+    expect(a.datasource).toEqual({ type: "prometheus", uid: "${ds}" });
+    expect(b.datasource).toEqual({ type: "prometheus", uid: "mimir" });
+  });
+
+  test("Tempo queries get the fields the schema requires", () => {
+    const [panel] = panelsOnly([new TablePanel({ datasource: tempo, targets: [new TempoQuery({ query: "{ status = error }" })] })]);
+    expect(panel.targets![0]).toEqual({ datasource: { type: "tempo", uid: "tempo" }, refId: "A", filters: [], queryType: "traceql", query: "{ status = error }" });
+  });
+
+  test("Loki queries carry their expression as expr", () => {
+    const loki = new Datasource({ name: "Loki", type: "loki" });
+    const [panel] = panelsOnly([new TablePanel({ datasource: loki, targets: [new LokiQuery({ expr: '{app="x"}', maxLines: 100 })] })]);
+    expect(panel.targets![0]).toMatchObject({ expr: '{app="x"}', maxLines: 100 });
+  });
+});
+
+describe("variables", () => {
+  test("each kind renders to a VariableModel", () => {
+    expect(variableModel(new QueryVariable({ name: "svc", datasource: prometheus, query: "label_values(up, job)", multi: true }))).toEqual({
+      type: "query",
+      name: "svc",
+      datasource: { type: "prometheus", uid: "prometheus" },
+      query: "label_values(up, job)",
+      definition: "label_values(up, job)",
+      refresh: 1,
+      multi: true,
+      options: [],
+    });
+    expect(variableModel(new CustomVariable({ name: "env", values: ["prod", "a,b"] }))).toMatchObject({
+      type: "custom",
+      query: "prod,a\\,b",
+      current: { text: "prod", value: "prod" },
+      options: [
+        { selected: true, text: "prod", value: "prod" },
+        { selected: false, text: "a,b", value: "a,b" },
+      ],
+    });
+    expect(variableModel(new IntervalVariable({ name: "step", values: ["1m", "5m"] }))).toMatchObject({ type: "interval", query: "1m,5m", auto: false, refresh: 2 });
+    expect(variableModel(new DatasourceVariable({ name: "ds", pluginType: "loki", hide: "valueOnly" }))).toMatchObject({ type: "datasource", query: "loki", hide: 1 });
+    expect(variableModel(new ConstantVariable({ name: "cluster", value: "prod-1" }))).toMatchObject({ type: "constant", query: "prod-1", hide: 2 });
+    expect(variableModel(new TextboxVariable({ name: "q" }))).toMatchObject({ type: "textbox", query: "" });
+  });
+
+  test("a dashboard with every variable kind matches the dashboard schema", () => {
+    const dash = new Dashboard({
+      title: "Vars",
+      variables: [
+        new QueryVariable({ name: "svc", datasource: prometheus, query: "label_values(up, job)" }),
+        new CustomVariable({ name: "env", values: ["prod", "dev"] }),
+        new IntervalVariable({ name: "step", values: ["1m"] }),
+        new DatasourceVariable({ name: "ds", pluginType: "prometheus" }),
+        new ConstantVariable({ name: "cluster", value: "x" }),
+        new TextboxVariable({ name: "q", value: "y" }),
+      ],
+    });
+    expect(validateDashboardSchema(renderDashboard(dash) as unknown as Record<string, unknown>)).toEqual([]);
+  });
+});
+
+describe("extension points", () => {
+  test("definePanel and defineQuery produce classes that render and lay out like built-ins", () => {
+    const PieChartPanel = definePanel<{ pieType?: "pie" | "donut" }>()({ type: "piechart", className: "PieChartPanel", defaultSize: { w: 8, h: 8 } });
+    const ElasticQuery = defineQuery<{ query: string; refId?: string }>()({ datasourceType: "elasticsearch", className: "ElasticQuery" });
+    const es = new Datasource({ name: "Logs ES", type: "elasticsearch" });
+    const json = renderDashboard(
+      new Dashboard({ title: "Custom", panels: [new PieChartPanel({ options: { pieType: "donut" }, datasource: es, targets: [new ElasticQuery({ query: "*" })] })] }),
+    );
+    expect(json.panels![0]).toMatchObject({
+      type: "piechart",
+      gridPos: { w: 8, h: 8, x: 0, y: 0 },
+      options: { pieType: "donut" },
+      datasource: { type: "elasticsearch", uid: "logs-es" },
+      targets: [{ refId: "A", query: "*" }],
+    });
+    expect(validateDashboardSchema(json as unknown as Record<string, unknown>)).toEqual([]);
+  });
+
+  test("redefining a built-in panel or query type throws", () => {
+    expect(() => definePanel()({ type: "stat", className: "MyStat", defaultSize: { w: 1, h: 1 } })).toThrow(/built in/);
+    expect(() => defineQuery()({ datasourceType: "prometheus", className: "MyProm" })).toThrow(/built in/);
+    expect(() => definePanel()({ type: "row", className: "R", defaultSize: { w: 1, h: 1 } })).toThrow(/Row/);
+  });
+
+  test("dashboardJson and grafanaFiles render without a build", () => {
+    const dash = new Dashboard({ title: "Plain", uid: "plain" });
+    expect(JSON.parse(dashboardJson(dash)).uid).toBe("plain");
+    expect(Object.keys(grafanaFiles([dash, prometheus])).sort()).toEqual([
+      "dashboards/plain.json",
+      "provisioning/dashboards/chant.yaml",
+      "provisioning/datasources/chant.yaml",
+    ]);
+  });
+});