@intentius/chant-lexicon-grafana 0.96.0

package/dist/schema/tempo.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempo.gen.d.ts","sourceRoot":"","sources":["../../src/schema/tempo.gen.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACpC;;OAEG;IACH,0BAA0B,CAAC,EAAE,OAAO,CAAC;IACrC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B;;OAEG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B;;OAEG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,iBAAiB,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAEvH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,SAAS,CAAC;AAEnD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,eAAe,GAAG,YAAY,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,GAAG,OAAO,CAAC;AAE1H;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd"}

package/dist/schema/text.gen.d.ts

@@ -0,0 +1,16 @@
+export type TextMode = "html" | "markdown" | "code";
+export type CodeLanguage = "json" | "yaml" | "xml" | "typescript" | "sql" | "go" | "markdown" | "html" | "plaintext";
+export interface CodeOptions {
+    /**
+     * The language passed to monaco code editor
+     */
+    language: CodeLanguage;
+    showLineNumbers: boolean;
+    showMiniMap: boolean;
+}
+export interface Options {
+    mode: TextMode;
+    code?: CodeOptions;
+    content: string;
+}
+//# sourceMappingURL=text.gen.d.ts.map

package/dist/schema/text.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.gen.d.ts","sourceRoot":"","sources":["../../src/schema/text.gen.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAEpD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,YAAY,GAAG,KAAK,GAAG,IAAI,GAAG,UAAU,GAAG,MAAM,GAAG,WAAW,CAAC;AAErH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,EAAE,YAAY,CAAC;IACvB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/schema/timeseries.gen.d.ts

@@ -0,0 +1,179 @@
+export interface Options {
+    timezone?: TimeZone[];
+    legend: VizLegendOptions;
+    tooltip: VizTooltipOptions;
+    orientation?: VizOrientation;
+}
+export type FieldConfig = GraphFieldConfig;
+/**
+ * A specific timezone from https://en.wikipedia.org/wiki/Tz_database
+ */
+export type TimeZone = string;
+/**
+ * TODO docs
+ */
+export interface VizLegendOptions {
+    displayMode: LegendDisplayMode;
+    placement: LegendPlacement;
+    showLegend: boolean;
+    asTable?: boolean;
+    isVisible?: boolean;
+    sortBy?: string;
+    sortDesc?: boolean;
+    width?: number;
+    calcs: string[];
+}
+/**
+ * TODO docs
+ */
+export interface VizTooltipOptions {
+    mode: TooltipDisplayMode;
+    sort: SortOrder;
+    maxWidth?: number;
+    maxHeight?: number;
+    hideZeros?: boolean;
+}
+/**
+ * TODO docs
+ */
+export type VizOrientation = "auto" | "vertical" | "horizontal";
+/**
+ * TODO docs
+ */
+export interface GraphFieldConfig {
+    drawStyle?: GraphDrawStyle;
+    gradientMode?: GraphGradientMode;
+    thresholdsStyle?: GraphThresholdsStyleConfig;
+    transform?: GraphTransform;
+    lineColor?: string;
+    lineWidth?: number;
+    lineInterpolation?: LineInterpolation;
+    lineStyle?: LineStyle;
+    fillColor?: string;
+    fillOpacity?: number;
+    showPoints?: VisibilityMode;
+    pointSize?: number;
+    pointColor?: string;
+    axisPlacement?: AxisPlacement;
+    axisColorMode?: AxisColorMode;
+    axisLabel?: string;
+    axisWidth?: number;
+    axisSoftMin?: number;
+    axisSoftMax?: number;
+    axisGridShow?: boolean;
+    scaleDistribution?: ScaleDistributionConfig;
+    axisCenteredZero?: boolean;
+    barAlignment?: BarAlignment;
+    barWidthFactor?: number;
+    stacking?: StackingConfig;
+    hideFrom?: HideSeriesConfig;
+    insertNulls?: boolean | number;
+    /**
+     * Indicate if null values should be treated as gaps or connected.
+     * When the value is a number, it represents the maximum delta in the
+     * X axis that should be considered connected.  For timeseries, this is milliseconds
+     */
+    spanNulls?: boolean | number;
+    fillBelowTo?: string;
+    pointSymbol?: string;
+    axisBorderShow?: boolean;
+    barMaxWidth?: number;
+}
+/**
+ * TODO docs
+ * Note: "hidden" needs to remain as an option for plugins compatibility
+ */
+export type LegendDisplayMode = "list" | "table" | "hidden";
+/**
+ * TODO docs
+ */
+export type LegendPlacement = "bottom" | "right";
+/**
+ * TODO docs
+ */
+export type TooltipDisplayMode = "single" | "multi" | "none";
+/**
+ * TODO docs
+ */
+export type SortOrder = "asc" | "desc" | "none";
+/**
+ * TODO docs
+ */
+export type GraphDrawStyle = "line" | "bars" | "points";
+/**
+ * TODO docs
+ */
+export type GraphGradientMode = "none" | "opacity" | "hue" | "scheme";
+/**
+ * TODO docs
+ */
+export interface GraphThresholdsStyleConfig {
+    mode: GraphThresholdsStyleMode;
+}
+/**
+ * TODO docs
+ */
+export type GraphTransform = "constant" | "negative-Y";
+/**
+ * TODO docs
+ */
+export type LineInterpolation = "linear" | "smooth" | "stepBefore" | "stepAfter";
+/**
+ * TODO docs
+ */
+export interface LineStyle {
+    fill?: "solid" | "dash" | "dot" | "square";
+    dash?: number[];
+}
+/**
+ * TODO docs
+ */
+export type VisibilityMode = "auto" | "never" | "always";
+/**
+ * TODO docs
+ */
+export type AxisPlacement = "auto" | "top" | "right" | "bottom" | "left" | "hidden";
+/**
+ * TODO docs
+ */
+export type AxisColorMode = "text" | "series";
+/**
+ * TODO docs
+ */
+export interface ScaleDistributionConfig {
+    type: ScaleDistribution;
+    log?: number;
+    linearThreshold?: number;
+}
+/**
+ * TODO docs
+ */
+export type BarAlignment = -1 | 0 | 1;
+/**
+ * TODO docs
+ */
+export interface StackingConfig {
+    mode?: StackingMode;
+    group?: string;
+}
+/**
+ * TODO docs
+ */
+export interface HideSeriesConfig {
+    tooltip: boolean;
+    legend: boolean;
+    viz: boolean;
+}
+/**
+ * TODO docs
+ */
+export type GraphThresholdsStyleMode = "off" | "line" | "dashed" | "area" | "line+area" | "dashed+area" | "series";
+/**
+ * TODO docs
+ */
+export type ScaleDistribution = "linear" | "log" | "ordinal" | "symlog";
+/**
+ * TODO docs
+ */
+export type StackingMode = "none" | "normal" | "percent";
+//# sourceMappingURL=timeseries.gen.d.ts.map

package/dist/schema/timeseries.gen.d.ts.map

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

package/dist/schema-validate.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Validate built Grafana JSON against the vendored schemas at
+ * `GRAFANA_SCHEMA_PIN`, offline.
+ *
+ * The dashboard is checked against the dashboard schema as it stands. Panel
+ * options, `fieldConfig.defaults.custom` and each query are checked against
+ * their plugin's schema with every `required` list removed, because Grafana
+ * fills in options a panel leaves out: what still fails is a key the schema
+ * doesn't have or a value it doesn't allow.
+ */
+export interface SchemaProblem {
+    /** JSON pointer into the dashboard. */
+    path: string;
+    message: string;
+}
+type Json = Record<string, unknown>;
+/** Everything in one dashboard that the pinned schemas reject. */
+export declare function validateDashboardSchema(dashboard: Json): SchemaProblem[];
+export {};
+//# sourceMappingURL=schema-validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validate.d.ts","sourceRoot":"","sources":["../src/schema-validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,MAAM,WAAW,aAAa;IAC5B,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAiED,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAcpC,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,IAAI,GAAG,aAAa,EAAE,CAyCxE"}

package/dist/serializer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Grafana serializer.
+ *
+ * Emits Grafana's own files, as `SerializerResult.files` keyed by path
+ * relative to the output directory:
+ *
+ * - `dashboards/[<folder>/]<uid>.json`: one per dashboard, the JSON Grafana
+ *   imports as it is (UI import, the HTTP API, or file provisioning).
+ * - `provisioning/datasources/chant.yaml`: every declared datasource.
+ * - `provisioning/dashboards/chant.yaml`: the provider that loads the
+ *   dashboard files, a default one unless a `DashboardProvider` is declared.
+ *
+ * Mount `provisioning/` at `/etc/grafana/provisioning` and `dashboards/` at
+ * the provider's path (`/var/lib/grafana/dashboards` by default).
+ *
+ * The primary output is a small JSON index of what was built. Grafana's
+ * files have no metadata channel chant could use without changing what
+ * Grafana imports, so no ownership marker is stamped.
+ */
+import type { Serializer } from "@intentius/chant/serializer";
+export declare const grafanaSerializer: Serializer;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../src/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,6BAA6B,CAAC;AAIhF,eAAO,MAAM,iBAAiB,EAAE,UAW/B,CAAC"}

package/dist/skill-defs.d.ts

@@ -0,0 +1,3 @@
+/** The grafana lexicon's AI skills, read from src/skills/. */
+export declare const grafanaSkills: () => import("packages/core/src").SkillDefinition[];
+//# sourceMappingURL=skill-defs.d.ts.map

package/dist/skill-defs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-defs.d.ts","sourceRoot":"","sources":["../src/skill-defs.ts"],"names":[],"mappings":"AAEA,8DAA8D;AAC9D,eAAO,MAAM,aAAa,qDA2BxB,CAAC"}

package/dist/skills/chant-grafana-provisioning.md

@@ -0,0 +1,42 @@
+---
+skill: chant-grafana-provisioning
+description: Load chant-built Grafana dashboards and datasources into a running Grafana through its provisioning directories, in Docker or Kubernetes
+user-invocable: true
+---
+
+# Provisioning chant-built dashboards into Grafana
+
+`chant build src --lexicon grafana -o dist/grafana/index.json` writes, next to the index:
+
+| Path | What Grafana does with it |
+|---|---|
+| `provisioning/datasources/chant.yaml` | creates or updates every declared `Datasource` |
+| `provisioning/dashboards/chant.yaml` | a file provider pointing at the dashboards directory |
+| `dashboards/<uid>.json`, `dashboards/<folder>/<uid>.json` | one dashboard each; the subdirectory becomes the folder |
+
+## Docker
+
+```bash
+docker run -p 3000:3000 \
+  -v "$PWD/dist/grafana/provisioning:/etc/grafana/provisioning:ro" \
+  -v "$PWD/dist/grafana/dashboards:/var/lib/grafana/dashboards:ro" \
+  grafana/grafana:12.4.11
+```
+
+## Kubernetes
+
+Put the two provisioning files in one ConfigMap mounted at `/etc/grafana/provisioning/datasources` and `/etc/grafana/provisioning/dashboards` (a `subPath` each, or two ConfigMaps), and the dashboard JSON in another mounted at `/var/lib/grafana/dashboards`. `grafanaFiles(entities)` returns every file by path, so a k8s composite can build those ConfigMaps from the same declarations without a second build.
+
+## Changing where dashboards live
+
+Declare a `DashboardProvider` to change the mount path, pin a folder, or allow UI edits:
+
+```ts
+export const provider = new DashboardProvider({ name: "team", path: "/dashboards", allowUiUpdates: true });
+```
+
+With no provider declared, chant writes one named `chant` that reads `/var/lib/grafana/dashboards` and maps subdirectories to folders.
+
+## Checking before Grafana does
+
+`chant lint` and `chant build` run GRAF101-GRAF107 on the output, including a check against Grafana's dashboard schema at the pinned version. To check against a real Grafana, the lexicon's `import.test.ts` boots `grafana/grafana` with Docker, provisions the example and reads each dashboard back over the HTTP API.

package/dist/skills/chant-grafana.md

@@ -0,0 +1,93 @@
+---
+skill: chant-grafana
+description: Declare Grafana dashboards, panels, typed Prometheus/Tempo/Loki queries and datasources as chant entities, and build dashboard JSON Grafana imports as it is
+user-invocable: true
+---
+
+# Grafana dashboards with chant
+
+The grafana lexicon (`@intentius/chant-lexicon-grafana`) types what a dashboard shows: datasources, dashboards, rows, panels, queries and variables. Grafana server settings, users and plugins are out of scope. `chant build` writes one JSON file per dashboard plus Grafana's provisioning files.
+
+## Project setup
+
+```ts
+// chant.config.ts
+export default { lexicons: ["grafana"] };
+```
+
+## Datasources, declared once
+
+```ts
+import { Datasource } from "@intentius/chant-lexicon-grafana";
+
+const prometheus = new Datasource({ name: "Prometheus", type: "prometheus", url: "http://prometheus:9090", isDefault: true });
+const tempo = new Datasource({ name: "Tempo", type: "tempo", url: "http://tempo:3200" });
+
+export { prometheus, tempo };
+```
+
+The uid defaults to the name as a uid (`prometheus`, `tempo`). Secrets go in `secureJsonData` as `"$__env{NAME}"` or `"$__file{/path}"`, never literally (GRAF002). A declared `Datasource` inside `jsonData` is written as its uid, which is how a Tempo datasource links to Loki or Prometheus.
+
+## Queries
+
+`PromQuery` (PromQL in `expr`), `TempoQuery` (TraceQL in `query`) and `LokiQuery` (LogQL in `expr`). Fields are typed from Grafana's own query schemas. `datasource` only accepts a datasource of the query's plugin type, so a PromQL query can't be pointed at Tempo.
+
+```ts
+const requestRate = new PromQuery({
+  expr: 'sum by (service) (rate(http_server_request_duration_seconds_count{service="$service"}[$__rate_interval]))',
+  legendFormat: "{{service}}",
+});
+```
+
+## Panels and dashboards
+
+Panel classes: `TimeSeriesPanel`, `StatPanel`, `GaugePanel`, `TablePanel`, `LogsPanel`, `TracesPanel`, `HeatmapPanel`, `TextPanel`, plus `Row`. `options` and `fieldConfig.defaults.custom` are typed from each panel's schema, and every option is optional because Grafana fills in the rest.
+
+```ts
+const rate = new TimeSeriesPanel({ title: "Request rate", datasource: prometheus, targets: [requestRate] });
+const traces = new TablePanel({ title: "Slow traces", datasource: tempo, targets: [slowTraces] });
+const service = new QueryVariable({ name: "service", datasource: prometheus, query: "label_values(up, service)" });
+
+export const overview = new Dashboard({
+  title: "Service overview",
+  variables: [service],
+  panels: [rate, traces],
+});
+```
+
+Leave `gridPos` out and panels are placed left to right, wrapping at 24 columns; give `x` and `y` to place one exactly. `Row({ title, panels, collapsed })` starts a full-width row. Dashboard uids default to the export name as a uid (`overview`).
+
+chant's lint wants flat declarations: extract nested objects (`time`, `options`) to named consts, keep at most eight declarations per file, and export entities with `export { a, b }`.
+
+## Dashboards built from other declarations
+
+Three composites build a whole dashboard from what another lexicon declares, reading metric names at build time so a rename at the source moves the queries:
+
+```ts
+import { Datasource, RedDashboard, SloDashboard, AgentDashboard } from "@intentius/chant-lexicon-grafana";
+import { spans, genai } from "./collector";   // an otel SpanMetricsConnector and genAiComponents(...)
+import { checkout } from "./slo";            // a prometheus Slo(...)
+
+const services = RedDashboard({ spanMetrics: spans, datasource: prometheus });     // rate, errors, p50/p95/p99 per service
+const checkoutSlo = SloDashboard({ slo: checkout, datasource: prometheus });      // SLI, budget left, burn rate per alert window
+const agents = AgentDashboard({ genAi: genai, datasource: prometheus });          // per model and tool, tokens per model
+
+export { services, checkoutSlo, agents };
+```
+
+Pass the `prometheus` exporter as `exporter` to `RedDashboard` when its `namespace` changes the names. `datasource` may be a `{ type: "prometheus", uid }` ref to a datasource declared elsewhere. Never hand-write the span-metric or SLO series names in a query next to these; use `spanMetricsNames()` (otel), `sloMetrics()` (prometheus) or `genAiMetrics()` (otel), or the composites' `redQueries`, `sloQueries` and `agentQueries`.
+
+## Rules
+
+- GRAF101: every panel, query and query variable names a declared datasource. GRAF102: of the right type.
+- GRAF103: every `$name`/`${name}` in a query, title or repeat is a declared variable (`$__*` are Grafana's own).
+- GRAF104: unique dashboard uids, datasource uids and names, panel ids, variable names and refIds.
+- GRAF105: panels fit the 24-column grid and don't overlap.
+- GRAF106: uids of 1-40 letters, digits, `-`, `_`; dashboards have titles.
+- GRAF107: the dashboard matches Grafana's schema at the pinned version.
+
+GRAF101 and GRAF102 compare against the datasources in the same build root, so keep datasources and dashboards in one `chant build` (chant #1939).
+
+## Other plugins
+
+`definePanel<Options, Custom>()({ type, className, defaultSize })` adds a panel plugin chant doesn't ship, and `defineQuery<Model>()({ datasourceType, className })` a datasource's query class. Both serialize and lint like the built-ins.

package/dist/spec/fetch-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+export {};
+//# sourceMappingURL=fetch-cli.d.ts.map

package/dist/spec/fetch-cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-cli.d.ts","sourceRoot":"","sources":["../../src/spec/fetch-cli.ts"],"names":[],"mappings":""}

package/dist/spec/schemas.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Read the vendored Grafana schemas (`src/spec/schemas/*.jsonschema.json`) and check
+ * them against the digests in `GRAFANA_SCHEMA_PIN`.
+ */
+import { type SchemaName } from "../pin.js";
+/**
+ * Where the vendored files live: beside this module, under `src/`, so they
+ * ship with the source the package runs from and GRAF107 can read them.
+ * A function, not a module-scope constant, so edge bundles that import the
+ * lexicon never evaluate a filesystem path at load.
+ */
+export declare function schemasDir(): string;
+export declare function schemaPath(name: SchemaName): string;
+export declare function sha256(text: string | Buffer): string;
+/** The raw bytes of one vendored schema. */
+export declare function readSchemaText(name: SchemaName): string;
+/** One vendored schema, parsed (cached per process). */
+export declare function loadSchema(name: SchemaName): Record<string, unknown>;
+/** Vendored files whose digest does not match the pin, with what was found. */
+export declare function digestMismatches(): Array<{
+    name: SchemaName;
+    expected: string;
+    actual: string;
+}>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/spec/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/spec/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAoC,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE3E;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEnD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAEpD;AAED,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEvD;AAID,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAOpE;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,IAAI,KAAK,CAAC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAQhG"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+// The grafana lexicon's entity classes are hand-written in src/, with panel
+// and query types generated into src/schema/; this entry re-exports them.
+export * from "../index.js";

package/dist/util.d.ts

@@ -0,0 +1,17 @@
+/** Small helpers shared by the entity modules and the builder. */
+/** Every field optional, all the way down; arrays keep their element type partial too. */
+export type DeepPartial<T> = T extends (infer U)[] ? DeepPartial<U>[] : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+/** Grafana's uid alphabet: letters, digits, `-` and `_`, at most 40 characters. */
+export declare const UID_PATTERN: RegExp;
+export declare function isValidUid(uid: string): boolean;
+/**
+ * A uid from free text (an export name or a datasource name): camelCase and
+ * spaces become `-`, anything outside the uid alphabet is dropped, and the
+ * result is cut to 40 characters.
+ */
+export declare function slugUid(text: string): string;
+/** Copy `value` with every `undefined` property dropped, recursively; keeps key order. */
+export declare function compact<T>(value: T): T;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +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"}

package/dist/validate-cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env tsx
+export {};
+//# sourceMappingURL=validate-cli.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-cli.d.ts","sourceRoot":"","sources":["../src/validate-cli.ts"],"names":[],"mappings":""}

package/dist/validate-output.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The checks behind GRAF101-GRAF107, as plain functions over built Grafana
+ * output: dashboard JSON documents and provisioned datasources. 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.
+ */
+import type { ProvisionedDatasource } from "./build.js";
+export type GrafanaIssueCode = "GRAF101" | "GRAF102" | "GRAF103" | "GRAF104" | "GRAF105" | "GRAF106" | "GRAF107";
+export interface GrafanaIssue {
+    code: GrafanaIssueCode;
+    severity: "error" | "warning";
+    message: string;
+    /** The dashboard uid or datasource name the issue is about. */
+    entity?: string;
+}
+export interface DashboardDoc {
+    /** Where it came from, e.g. its output file. */
+    source?: string;
+    json: Record<string, unknown>;
+}
+export interface GrafanaArtifacts {
+    dashboards: DashboardDoc[];
+    datasources: ProvisionedDatasource[];
+}
+/** Every variable name referenced in a string. */
+export declare function variableReferences(text: string): string[];
+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[];
+export declare function checkSchema(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. */
+export declare function validateGrafanaOutput(a: GrafanaArtifacts): GrafanaIssue[];
+//# sourceMappingURL=validate-output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate-output.d.ts","sourceRoot":"","sources":["../src/validate-output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAOrD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,WAAW,EAAE,qBAAqB,EAAE,CAAC;CACtC;AA2CD,kDAAkD;AAClD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIzD;AAoCD,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CA0DvE;AAID,wBAAgB,cAAc,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAkClE;AAaD,wBAAgB,eAAe,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAyBnE;AAsBD,wBAAgB,SAAS,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAiC7D;AAID,wBAAgB,aAAa,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CA2BjE;AAID,wBAAgB,WAAW,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAa/D;AAYD,kCAAkC;AAClC,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAErF;AAED,oDAAoD;AACpD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAEzE"}

package/dist/validate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Validate the grafana lexicon's own artifacts: the vendored schemas match
+ * their pinned digests, the committed schema types match what generate would
+ * write, every required class is in the registry, and every built-in panel
+ * renders to a dashboard the pinned schema accepts.
+ */
+import type { ValidateResult } from "@intentius/chant/codegen/validate";
+export type { ValidateCheck, ValidateResult } from "@intentius/chant/codegen/validate";
+/** Every entity class the package must keep exporting. */
+export declare const REQUIRED_NAMES: string[];
+export declare function validate(): Promise<ValidateResult>;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAiB,cAAc,EAAE,MAAM,mCAAmC,CAAC;AASvF,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAEvF,0DAA0D;AAC1D,eAAO,MAAM,cAAc,UAsB1B,CAAC;AAIF,wBAAsB,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC,CA2DxD"}