@intentius/chant-lexicon-grafana 0.97.0 → 0.99.0

package/dist/okf/types/ClassicConditionsExpression.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: ClassicConditionsExpression
+description: grafana resource type Grafana::Expression::classic_conditions
+name: ClassicConditionsExpression
+lexicon: grafana
+resource_type: Grafana::Expression::classic_conditions
+---
+`Grafana::Expression::classic_conditions`, a resource type of the grafana lexicon.

package/dist/okf/types/ContactPoint.md

@@ -0,0 +1,14 @@
+---
+type: resource-type
+title: ContactPoint
+description: grafana resource type Grafana::ContactPoint
+name: ContactPoint
+lexicon: grafana
+resource_type: Grafana::ContactPoint
+---
+`Grafana::ContactPoint`, a resource type of the grafana lexicon.
+
+## Governed by
+
+- [GRAF002](/rules/GRAF002.md): a datasource or contact point secret written as a literal.
+- [GRAF113](/rules/GRAF113.md): Alerting routes to a contact point or mute timing the build does not declare, or a policy matcher does not parse

package/dist/okf/types/Dashboard.md

@@ -12,3 +12,4 @@ resource_type: Grafana::Dashboard
 
 - [GRAF001](/rules/GRAF001.md): a uid Grafana rejects, or a variable name queries cannot reference.
 - [GRAF104](/rules/GRAF104.md): Two dashboards, datasources, panels, variables or queries share an id
+- [GRAF109](/rules/GRAF109.md): Dashboard provisioning puts a dashboard somewhere other than its declared folder, or loads it twice

package/dist/okf/types/Datasource.md

@@ -11,6 +11,7 @@ resource_type: Grafana::Datasource
 ## Governed by
 
 - [GRAF001](/rules/GRAF001.md): a uid Grafana rejects, or a variable name queries cannot reference.
-- [GRAF002](/rules/GRAF002.md): a datasource secret written as a literal.
-- [GRAF101](/rules/GRAF101.md): A panel, query or variable uses a datasource no Datasource in the build declares
+- [GRAF002](/rules/GRAF002.md): a datasource or contact point secret written as a literal.
+- [GRAF101](/rules/GRAF101.md): A panel, query or variable uses a datasource no Datasource or ExternalDatasource in the build declares
 - [GRAF102](/rules/GRAF102.md): A query is sent to a datasource of another plugin type
+- [GRAF112](/rules/GRAF112.md): An alert rule queries a datasource the build does not declare, or of another type

package/dist/okf/types/ExternalDatasource.md

@@ -0,0 +1,15 @@
+---
+type: resource-type
+title: ExternalDatasource
+description: grafana resource type Grafana::ExternalDatasource
+name: ExternalDatasource
+lexicon: grafana
+resource_type: Grafana::ExternalDatasource
+---
+`Grafana::ExternalDatasource`, a resource type of the grafana lexicon.
+
+## Governed by
+
+- [GRAF101](/rules/GRAF101.md): A panel, query or variable uses a datasource no Datasource or ExternalDatasource in the build declares
+- [GRAF102](/rules/GRAF102.md): A query is sent to a datasource of another plugin type
+- [GRAF112](/rules/GRAF112.md): An alert rule queries a datasource the build does not declare, or of another type

package/dist/okf/types/FlameGraphPanel.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: FlameGraphPanel
+description: grafana resource type Grafana::Panel::flamegraph
+name: FlameGraphPanel
+lexicon: grafana
+resource_type: Grafana::Panel::flamegraph
+---
+`Grafana::Panel::flamegraph`, a resource type of the grafana lexicon.

package/dist/okf/types/GeomapPanel.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: GeomapPanel
+description: grafana resource type Grafana::Panel::geomap
+name: GeomapPanel
+lexicon: grafana
+resource_type: Grafana::Panel::geomap
+---
+`Grafana::Panel::geomap`, a resource type of the grafana lexicon.

package/dist/okf/types/HistogramPanel.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: HistogramPanel
+description: grafana resource type Grafana::Panel::histogram
+name: HistogramPanel
+lexicon: grafana
+resource_type: Grafana::Panel::histogram
+---
+`Grafana::Panel::histogram`, a resource type of the grafana lexicon.

package/dist/okf/types/MathExpression.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: MathExpression
+description: grafana resource type Grafana::Expression::math
+name: MathExpression
+lexicon: grafana
+resource_type: Grafana::Expression::math
+---
+`Grafana::Expression::math`, a resource type of the grafana lexicon.

package/dist/okf/types/MuteTiming.md

@@ -0,0 +1,13 @@
+---
+type: resource-type
+title: MuteTiming
+description: grafana resource type Grafana::MuteTiming
+name: MuteTiming
+lexicon: grafana
+resource_type: Grafana::MuteTiming
+---
+`Grafana::MuteTiming`, a resource type of the grafana lexicon.
+
+## Governed by
+
+- [GRAF113](/rules/GRAF113.md): Alerting routes to a contact point or mute timing the build does not declare, or a policy matcher does not parse

package/dist/okf/types/NodeGraphPanel.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: NodeGraphPanel
+description: grafana resource type Grafana::Panel::nodeGraph
+name: NodeGraphPanel
+lexicon: grafana
+resource_type: Grafana::Panel::nodeGraph
+---
+`Grafana::Panel::nodeGraph`, a resource type of the grafana lexicon.

package/dist/okf/types/NotificationPolicy.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: NotificationPolicy
+description: grafana resource type Grafana::NotificationPolicy
+name: NotificationPolicy
+lexicon: grafana
+resource_type: Grafana::NotificationPolicy
+---
+`Grafana::NotificationPolicy`, a resource type of the grafana lexicon.

package/dist/okf/types/NotificationTemplate.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: NotificationTemplate
+description: grafana resource type Grafana::NotificationTemplate
+name: NotificationTemplate
+lexicon: grafana
+resource_type: Grafana::NotificationTemplate
+---
+`Grafana::NotificationTemplate`, a resource type of the grafana lexicon.

package/dist/okf/types/PieChartPanel.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: PieChartPanel
+description: grafana resource type Grafana::Panel::piechart
+name: PieChartPanel
+lexicon: grafana
+resource_type: Grafana::Panel::piechart
+---
+`Grafana::Panel::piechart`, a resource type of the grafana lexicon.

package/dist/okf/types/ReduceExpression.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: ReduceExpression
+description: grafana resource type Grafana::Expression::reduce
+name: ReduceExpression
+lexicon: grafana
+resource_type: Grafana::Expression::reduce
+---
+`Grafana::Expression::reduce`, a resource type of the grafana lexicon.

package/dist/okf/types/ResampleExpression.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: ResampleExpression
+description: grafana resource type Grafana::Expression::resample
+name: ResampleExpression
+lexicon: grafana
+resource_type: Grafana::Expression::resample
+---
+`Grafana::Expression::resample`, a resource type of the grafana lexicon.

package/dist/okf/types/SqlExpression.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: SqlExpression
+description: grafana resource type Grafana::Expression::sql
+name: SqlExpression
+lexicon: grafana
+resource_type: Grafana::Expression::sql
+---
+`Grafana::Expression::sql`, a resource type of the grafana lexicon.

package/dist/okf/types/StateTimelinePanel.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: StateTimelinePanel
+description: grafana resource type Grafana::Panel::state-timeline
+name: StateTimelinePanel
+lexicon: grafana
+resource_type: Grafana::Panel::state-timeline
+---
+`Grafana::Panel::state-timeline`, a resource type of the grafana lexicon.

package/dist/okf/types/StatusHistoryPanel.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: StatusHistoryPanel
+description: grafana resource type Grafana::Panel::status-history
+name: StatusHistoryPanel
+lexicon: grafana
+resource_type: Grafana::Panel::status-history
+---
+`Grafana::Panel::status-history`, a resource type of the grafana lexicon.

package/dist/okf/types/ThresholdExpression.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: ThresholdExpression
+description: grafana resource type Grafana::Expression::threshold
+name: ThresholdExpression
+lexicon: grafana
+resource_type: Grafana::Expression::threshold
+---
+`Grafana::Expression::threshold`, a resource type of the grafana lexicon.

package/dist/okf/types/TrendPanel.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: TrendPanel
+description: grafana resource type Grafana::Panel::trend
+name: TrendPanel
+lexicon: grafana
+resource_type: Grafana::Panel::trend
+---
+`Grafana::Panel::trend`, a resource type of the grafana lexicon.

package/dist/okf/types/XYChartPanel.md

@@ -0,0 +1,9 @@
+---
+type: resource-type
+title: XYChartPanel
+description: grafana resource type Grafana::Panel::xychart
+name: XYChartPanel
+lexicon: grafana
+resource_type: Grafana::Panel::xychart
+---
+`Grafana::Panel::xychart`, a resource type of the grafana lexicon.

package/dist/op/activities/grafana-apply.d.ts

@@ -0,0 +1,75 @@
+/**
+ * `grafanaApply`, the Op activity for the Grafana API applier (#2948), and
+ * `toApplyResult`, its projection onto core's apply envelope (#1446).
+ *
+ * It reads a build's output (the index the serializer writes as its primary
+ * output, and the dashboard files beside it), binds the environment's
+ * Grafana the way observe and export do (`grafana.profiles.<env>`, else
+ * `GRAFANA_URL`; ../../api/bind.ts), and hands the plan to `applyGrafana`
+ * (../../api/apply.ts), which holds the API decisions.
+ *
+ * The ownership marker is the project's: `ownership.stack` and
+ * `ownership.env` from `chant.config.ts`, or `stack`/`ownershipEnv` passed
+ * in. Without a stack the apply still runs, stamping only the managed-by
+ * label, and a prune declines (as `not-prunable`) rather than delete
+ * another stack's dashboards.
+ */
+import type { ChantConfig } from "@intentius/chant/config";
+import type { OwnershipMarker } from "@intentius/chant/ownership";
+import { type ApplyResult } from "@intentius/chant/apply";
+import type { GrafanaHttp } from "../../api/client.js";
+import { type BuiltDashboardInput, type GrafanaApplyOutcome } from "../../api/apply.js";
+export type { GrafanaApplyOutcome } from "../../api/apply.js";
+export interface GrafanaApplyArgs {
+    /**
+     * The build's primary output: the index the grafana serializer writes
+     * (`chant build -o dist/grafana.json`). The dashboard files it lists are
+     * read from the same directory. A combined multi-lexicon output works too;
+     * its `grafana` key is used.
+     */
+    indexPath: string;
+    /** The chant environment, which selects `grafana.profiles.<environment>`. */
+    environment?: string;
+    /**
+     * Delete this project's dashboards and folders that the build no longer
+     * declares: only those carrying its ownership marker, stack and env.
+     * Destructive, so off by default.
+     */
+    prune?: boolean;
+    /** Ownership stack. Default: `ownership.stack` in `chant.config.ts`. */
+    stack?: string;
+    /** Ownership env. Default: `ownership.env` in `chant.config.ts` (a literal; a `{ param }` reference needs this). */
+    ownershipEnv?: string;
+    /** Project directory for `chant.config.ts`. Default: the working directory. */
+    cwd?: string;
+}
+/** What a test (or an embedding caller) may inject instead of the project's config, the process env and `fetch`. */
+export interface GrafanaApplyDeps {
+    http?: GrafanaHttp;
+    config?: Pick<ChantConfig, "grafana" | "ownership">;
+    env?: Record<string, string | undefined>;
+}
+/**
+ * The dashboards a build wrote, read from its index and the files beside
+ * it. Pure but for the file reads.
+ */
+export declare function readBuiltDashboards(indexPath: string, read?: (path: string) => string): BuiltDashboardInput[];
+/** The marker to stamp and prune by: the arguments, else the project's `ownership` config. */
+export declare function resolveMarker(args: Pick<GrafanaApplyArgs, "stack" | "ownershipEnv">, config: Pick<ChantConfig, "ownership"> | undefined): OwnershipMarker | undefined;
+/**
+ * Apply a grafana build to the environment's Grafana over its HTTP API.
+ * Dashboards and folders get chant's ownership labels; with `prune`, this
+ * project's dashboards and folders the build no longer has are deleted.
+ * A target that cannot be bound returns every resource as not attempted,
+ * with the binding's reason.
+ */
+export declare function grafanaApply(args: GrafanaApplyArgs, signal?: AbortSignal, deps?: GrafanaApplyDeps): Promise<GrafanaApplyOutcome>;
+/**
+ * Project a grafana apply outcome onto core's apply envelope. The outcome
+ * keeps what the envelope has no room for (the request path, the API
+ * version, the binding's source); a kind the prune could not consider has no
+ * single resource name, so it is reported as `<kind>/*`, `not-prunable`,
+ * as the gcp applier does.
+ */
+export declare function toApplyResult(outcome: GrafanaApplyOutcome): ApplyResult;
+//# sourceMappingURL=grafana-apply.d.ts.map

package/dist/op/activities/grafana-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grafana-apply.d.ts","sourceRoot":"","sources":["../../../src/op/activities/grafana-apply.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAIL,KAAK,WAAW,EAEjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAkE,KAAK,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAErJ,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,wEAAwE;IACxE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oHAAoH;IACpH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,oHAAoH;AACpH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,WAAW,CAAC,CAAC;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAQD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAuC,GAAG,mBAAmB,EAAE,CAW7I;AAWD,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAUrK;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,IAAI,GAAE,gBAAqB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAqC1I;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,CAOvE"}

package/dist/op/activities/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Grafana Op activities, resolved by the core activity registry when a
+ * project's `chant.config.ts` lists the `grafana` lexicon. Contributes the
+ * API applier (`grafanaApply`, #2948) and its envelope projection
+ * (`toApplyResult`), which core's apply activity looks up by name.
+ */
+export { grafanaApply, toApplyResult, readBuiltDashboards, resolveMarker } from "./grafana-apply.js";
+export type { GrafanaApplyArgs, GrafanaApplyDeps, GrafanaApplyOutcome } from "./grafana-apply.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/op/activities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/op/activities/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAClG,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

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,67 @@
+/**
+ * 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";
+/** 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;
+};
+//# 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;AAEtD,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"}

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;