@gravitee/gamma-lib-observability 6.7.0 → 6.8.0

package/dist/dashboards/editor/dimension-reset.d.ts

@@ -1,13 +1,14 @@
+import { MetricCatalog } from '../metric-catalog';
 /**
  * The group-by to keep once a widget's metrics change: `field` when every
  * metric still accepts it under the host's API types, else nothing. The
  * measure is reset the same way when the metric changes; a group-by the new
  * metric refuses would send a query the engine answers with a 400.
  */
-export declare function acceptedDimension(field: string | undefined, metrics: readonly string[], apiTypes: readonly string[] | undefined): string | undefined;
+export declare function acceptedDimension(catalog: MetricCatalog, field: string | undefined, metrics: readonly string[], apiTypes: readonly string[] | undefined): string | undefined;
 /**
  * Same, for a widget that cannot go without a group-by (bars, doughnut, top
  * list, table): falls back to `API`, which every metric accepts.
  */
-export declare function acceptedDimensionOrDefault(field: string | undefined, metrics: readonly string[], apiTypes: readonly string[] | undefined): string;
+export declare function acceptedDimensionOrDefault(catalog: MetricCatalog, field: string | undefined, metrics: readonly string[], apiTypes: readonly string[] | undefined): string;
 //# sourceMappingURL=dimension-reset.d.ts.map

package/dist/dashboards/editor/dimension-reset.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dimension-reset.d.ts","sourceRoot":"","sources":["../../../src/dashboards/editor/dimension-reset.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACtC,MAAM,GAAG,SAAS,CAGpB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACtC,MAAM,CAER"}
+{"version":3,"file":"dimension-reset.d.ts","sourceRoot":"","sources":["../../../src/dashboards/editor/dimension-reset.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG1E;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACtC,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACtC,MAAM,CAER"}

package/dist/dashboards/editor/locked-filter-conflicts.d.ts

@@ -1,4 +1,5 @@
 import { FilterCondition, FilterOperator, Widget } from '../../types/domain';
+import { MetricCatalog } from '../metric-catalog';
 /** One side of a conflict, enough to describe it: `≤ 1000`, or `MCP`. */
 export interface ConflictingCondition {
     readonly operator: FilterOperator;
@@ -34,7 +35,7 @@ export interface LockedFilterConflict {
  * widget then fills again. Only what can be decided is flagged (see
  * `canOverlap`), so a warning is never a false alarm.
  */
-export declare function findLockedFilterConflicts(dashboardFilters: readonly FilterCondition[], widgets: readonly Widget[]): LockedFilterConflict[];
+export declare function findLockedFilterConflicts(catalog: MetricCatalog, dashboardFilters: readonly FilterCondition[], widgets: readonly Widget[]): LockedFilterConflict[];
 /**
  * Whether conditions on one field, ANDed, can still match a value. Only what
  * can be decided answers `false`:

package/dist/dashboards/editor/locked-filter-conflicts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locked-filter-conflicts.d.ts","sourceRoot":"","sources":["../../../src/dashboards/editor/locked-filter-conflicts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAIlF,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAClD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,gBAAgB,EAAE,SAAS,eAAe,EAAE,EAC5C,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,oBAAoB,EAAE,CA4BxB;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CA+B1E"}
+{"version":3,"file":"locked-filter-conflicts.d.ts","sourceRoot":"","sources":["../../../src/dashboards/editor/locked-filter-conflicts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAElF,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEpE,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAClD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,aAAa,EACtB,gBAAgB,EAAE,SAAS,eAAe,EAAE,EAC5C,OAAO,EAAE,SAAS,MAAM,EAAE,GACzB,oBAAoB,EAAE,CA4BxB;AAmBD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CA+B1E"}

package/dist/dashboards/editor/suggest-widget-title.d.ts

@@ -1,7 +1,8 @@
 import { Widget } from '../../types/domain';
+import { MetricCatalog } from '../metric-catalog';
 /**
  * Human title derived from the widget query, used when the user leaves the
  * title empty, because an untitled tile reads poorly on the dashboard.
  */
-export declare function suggestWidgetTitle(widget: Widget): string;
+export declare function suggestWidgetTitle(catalog: MetricCatalog, widget: Widget): string;
 //# sourceMappingURL=suggest-widget-title.d.ts.map

package/dist/dashboards/editor/suggest-widget-title.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"suggest-widget-title.d.ts","sourceRoot":"","sources":["../../../src/dashboards/editor/suggest-widget-title.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA2BzD"}
+{"version":3,"file":"suggest-widget-title.d.ts","sourceRoot":"","sources":["../../../src/dashboards/editor/suggest-widget-title.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAiD,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEtG;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA2BjF"}

package/dist/dashboards/editor/testing/select-options.d.ts

@@ -7,7 +7,7 @@ export declare function selectOptions(): HTMLElement[];
 /**
  * The option that stands for `name`. A catalog option reads label then
  * technical name; an entry outside the catalog, or one whose label is its
- * name (`API`), reads the name alone.
+ * name but for the case (`API`, `Plan`), reads the label alone.
  */
 export declare function selectOptionFor(name: string): HTMLElement | undefined;
 /** Which of `names` the open pickers offer, in the order given. */
@@ -18,4 +18,6 @@ export declare function offeredOptions(names: readonly string[]): string[];
  * click on a missing option fails where it is written.
  */
 export declare function selectOption(text: string): HTMLElement;
+/** The group labels of the open pickers, in order: a served family, or "Custom". */
+export declare function selectGroupLabels(container?: ParentNode): string[];
 //# sourceMappingURL=select-options.d.ts.map

package/dist/dashboards/editor/testing/select-options.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"select-options.d.ts","sourceRoot":"","sources":["../../../../src/dashboards/editor/testing/select-options.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,WAAW,EAAE,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAErE;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAItD"}
+{"version":3,"file":"select-options.d.ts","sourceRoot":"","sources":["../../../../src/dashboards/editor/testing/select-options.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,WAAW,EAAE,CAE7C;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAIrE;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAItD;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAAC,SAAS,GAAE,UAAqB,GAAG,MAAM,EAAE,CAE5E"}

package/dist/dashboards/editor/widget-auto-scope.d.ts

@@ -1,4 +1,5 @@
 import { FilterCondition, Widget } from '../../types/domain';
+import { MetricCatalog } from '../metric-catalog';
 /**
  * Ensures widgets whose metrics belong to a specific API type always carry the
  * owning `API_TYPE` filter, because querying a scoped metric without it fails
@@ -15,5 +16,5 @@ import { FilterCondition, Widget } from '../../types/domain';
  * impossible to remove: dropping it and then toggling any unrelated control
  * would silently bring it back.
  */
-export declare function withAutoScope(previous: Widget, next: Widget, upstream?: readonly FilterCondition[]): Widget;
+export declare function withAutoScope(catalog: MetricCatalog, previous: Widget, next: Widget, upstream?: readonly FilterCondition[]): Widget;
 //# sourceMappingURL=widget-auto-scope.d.ts.map

package/dist/dashboards/editor/widget-auto-scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widget-auto-scope.d.ts","sourceRoot":"","sources":["../../../src/dashboards/editor/widget-auto-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAqClE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,SAAS,eAAe,EAAO,GAAG,MAAM,CAK/G"}
+{"version":3,"file":"widget-auto-scope.d.ts","sourceRoot":"","sources":["../../../src/dashboards/editor/widget-auto-scope.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAA2C,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAoChG;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,SAAS,eAAe,EAAO,GACxC,MAAM,CAKR"}

package/dist/dashboards/metric-catalog.d.ts

@@ -1,39 +1,48 @@
+import { AnalyticsDefinition } from '../data-sources/http-analytics-definition-source';
 import { FilterCondition } from '../types/domain';
 /**
- * Curated catalog of the metrics, facet dimensions and measures the widget
- * editor offers. There is no analytics-definition endpoint yet, so this is the
- * single place to extend when new metrics land.
+ * The metrics, facet dimensions and measures the widget editor offers, and
+ * the names a dashboard labels its widgets by.
  *
- * Every entry states two things the editor keeps apart:
+ * The catalog is served by the Management API's analytics definition endpoint
+ * (`GET …/observability/analytics/definition?apiType=…`, OBS-73) and read
+ * through `useMetricCatalog`, which builds a {@link MetricCatalog} from the
+ * served families and dimensions with {@link createMetricCatalog}. The dataset
+ * at the bottom of this file is the **fallback only**: the hook hands it out
+ * while the definition loads, when no source is mounted, and when the request
+ * fails (an older backend answers 404). It is what the endpoint served for
+ * `apiType=HTTP_PROXY&apiType=LLM`, captured from APIM master d563f02c8
+ * (:8093) on 2026-10-30, without `filters`; the parity test pins it to the
+ * captured fixture. Being behind the backend is expected and must stay harmless:
+ * nothing here may rewrite a saved widget, only constrain what the editor
+ * offers.
  *
- * - `apis`: the API types the analytics engine computes the metric for, copied
- *   from the definition. The pickers offer an entry when its `apis` meet the
- *   API types the host declared (`analyticsApiTypes`, else `scopeApiTypes`).
+ * Every metric entry states two things the editor keeps apart:
+ *
+ * - `apis`: the API kinds the engine computes the metric for, as served. The
+ *   pickers offer an entry when its `apis` meet the API types the host declared
+ *   (`analyticsApiTypes`, else `scopeApiTypes`).
  * - `requiredScopes`: the `API_TYPE` values the editor stamps on the widget as
  *   a visible filter, because querying the metric without one fails
- *   server-side (GMA-414). LLM metrics and LLM/MCP dimensions only. Never a
- *   way to say where a metric is offered: an HTTP metric stamped with its five
- *   API types would fire the locked-filter conflict on every AIM dashboard and
- *   empty every AuthZ widget.
- *
- * Hand-mirrored from the Management API's `analytics-definition.yaml` as of
- * 2026-10-29. Being behind it is expected and must stay harmless: nothing here
- * may rewrite a saved widget, only constrain what the editor offers. When the
- * two disagree, the backend wins and this file is what gets updated.
+ *   server-side (GMA-414). The wire carries none: it is this library's rule,
+ *   {@link requiredScopesOf}, and it never says where a metric is offered. An
+ *   HTTP metric stamped with its five kinds would fire the locked-filter
+ *   conflict on every AIM dashboard, and an AuthZ metric stamped with `AUTHZ`
+ *   would empty every AuthZ widget, which scope on `RECORD_TYPE`.
  */
-/** Every API type the analytics definition computes metrics for (`spec.apis`). */
+/** Every API kind the analytics definition computes metrics for. */
 export declare const ANALYTICS_API_TYPES: readonly ["HTTP_PROXY", "LLM", "MESSAGE", "MCP", "A2A", "NATIVE", "EDGE", "AUTHZ"];
 export type AnalyticsApiType = (typeof ANALYTICS_API_TYPES)[number];
-/** The API types whose metrics and dimensions the engine refuses without an `API_TYPE` filter (GMA-414). */
+/** The API kinds whose metrics and dimensions the engine refuses without an `API_TYPE` filter (GMA-414). */
 export type MetricScope = 'LLM' | 'MCP';
 export interface MetricCatalogEntry {
     readonly name: string;
+    /** As served: the one vocabulary for metric names across every host (OBS-73). */
     readonly label: string;
-    readonly description?: string;
-    /** Unit suffix suggested for series using this metric (e.g. `ms`, `req`). */
+    /** Unit suffix for series and columns using this metric (`ms`, `%`, `B`); none for a plain number. */
     readonly unit?: string;
-    /** API types the engine computes this metric for: where the pickers offer it. */
-    readonly apis: readonly AnalyticsApiType[];
+    /** API kinds the engine computes this metric for: where the pickers offer it. */
+    readonly apis: readonly string[];
     /**
      * `API_TYPE` values the editor stamps as a widget filter when this metric is
      * picked, because the engine refuses the metric without one. Undefined for a
@@ -46,57 +55,82 @@ export interface MetricCatalogEntry {
      */
     readonly facets: readonly string[];
     /**
-     * Measures the analytics engine accepts for this metric. Requesting any other
-     * measure is refused with HTTP 400, so the editor only offers these. The
-     * first entry is the default.
+     * Measures the analytics engine accepts for this metric, as served; the
+     * first is the default. Requesting any other measure is refused with HTTP
+     * 400, so the editor only offers these. A measure this library does not
+     * know is offered as it came, never dropped.
      */
-    readonly measures: readonly Measure[];
+    readonly measures: readonly string[];
 }
 export interface DimensionCatalogEntry {
     readonly field: string;
     readonly label: string;
     /**
-     * API types that write this field. The definition declares none on facets;
-     * it is stated here for the LLM and MCP dimensions, which only the matching
-     * proxy fills. Undefined: offered under every API type.
+     * API kinds that write this field. The definition declares none on a
+     * dimension; it is derived from the name for the LLM and MCP dimensions,
+     * which only the matching proxy fills. Undefined: offered under every kind.
      */
-    readonly apis?: readonly AnalyticsApiType[];
+    readonly apis?: readonly MetricScope[];
     /** As on a metric: the `API_TYPE` values stamped when the dimension is picked. */
     readonly requiredScopes?: readonly MetricScope[];
 }
+/** A picker group: one served family. */
 export interface MetricCatalogGroup {
     readonly id: string;
     readonly label: string;
     readonly metrics: readonly MetricCatalogEntry[];
 }
-export declare const MEASURES: readonly ["COUNT", "AVG", "MIN", "MAX", "P50", "P90", "P95", "P99", "PERCENTAGE"];
+/** The measures the editor offers for a metric outside the catalog, whose own list is unknown. */
+export declare const MEASURES: readonly ["COUNT", "SUM", "AVG", "MIN", "MAX", "P50", "P90", "P95", "P99", "PERCENTAGE"];
 export type Measure = (typeof MEASURES)[number];
-export declare const METRIC_CATALOG_GROUPS: readonly MetricCatalogGroup[];
-export declare const DIMENSION_CATALOG: readonly DimensionCatalogEntry[];
-export declare function findMetricEntry(name: string): MetricCatalogEntry | undefined;
-export declare function findDimensionEntry(field: string): DimensionCatalogEntry | undefined;
-export declare function metricLabel(name: string): string;
+/** Where a catalog came from: the definition endpoint, or the copy bundled below. */
+export type MetricCatalogSource = 'served' | 'bundled';
+export interface MetricCatalog {
+    readonly source: MetricCatalogSource;
+    readonly groups: readonly MetricCatalogGroup[];
+    readonly dimensions: readonly DimensionCatalogEntry[];
+    readonly metricIndex: ReadonlyMap<string, MetricCatalogEntry>;
+    readonly dimensionIndex: ReadonlyMap<string, DimensionCatalogEntry>;
+}
+/**
+ * The `API_TYPE` values a metric must be queried with: the one kind it exists
+ * for, when that kind is LLM or MCP. A metric of several kinds, or of a kind
+ * whose widgets scope by another field (AuthZ on `RECORD_TYPE`), needs none.
+ */
+export declare function requiredScopesOf(apiTypes: readonly string[]): readonly MetricScope[] | undefined;
+/** The one kind a dimension belongs to, read from its name: `LLM_PROXY_*` to LLM, `MCP_PROXY_*` to MCP. */
+export declare function dimensionScopeOf(field: string): MetricScope | undefined;
+/** The catalog a definition reads as: served families as groups, in their order; dimensions in theirs. */
+export declare function createMetricCatalog(definition: AnalyticsDefinition, source: MetricCatalogSource): MetricCatalog;
+export declare function findMetricEntry(catalog: MetricCatalog, name: string): MetricCatalogEntry | undefined;
+export declare function findDimensionEntry(catalog: MetricCatalog, field: string): DimensionCatalogEntry | undefined;
+/** The served label of a metric, or its name for one the catalog does not know. */
+export declare function metricLabel(catalog: MetricCatalog, name: string): string;
+/** The served label of a dimension, or its field for one the catalog does not know. */
+export declare function dimensionLabel(catalog: MetricCatalog, field: string): string;
 /**
  * Measures the backend accepts for a metric. Undefined for metrics outside
  * the catalog (custom/JSON-authored): the editor then offers the full list.
  */
-export declare function supportedMeasuresFor(metric: string): readonly Measure[] | undefined;
+export declare function supportedMeasuresFor(catalog: MetricCatalog, metric: string): readonly string[] | undefined;
 /**
  * Returns `current` when the metric supports it, otherwise the metric's
  * default measure. Unknown metrics keep whatever the user configured.
  */
-export declare function resolveMeasureForMetric(metric: string, current: string | undefined): string | undefined;
-export declare function dimensionLabel(field: string): string;
+export declare function resolveMeasureForMetric(catalog: MetricCatalog, metric: string, current: string | undefined): string | undefined;
 /**
  * The metric groups the picker offers a host that declared `apiTypes`: every
  * group when it declared none, otherwise the metrics whose `apis` meet them,
  * a group left empty dropped.
  *
- * A declaration this catalog knows no metric for offers the whole catalog
- * rather than nothing. The catalog is behind the host then, not the other way
- * round, and an author with no metric to pick could not build any widget.
+ * A declaration no metric meets offers the whole catalog rather than nothing:
+ * an author with no metric to pick could not build any widget. It bites on
+ * the bundled catalog, which knows the Gateway and LLM families alone, and on
+ * a served one for a host whose declared kinds the analytics do not know
+ * (`['WEBHOOK']`): the definition of every kind was asked for, and all of it
+ * is offered.
  */
-export declare function offeredMetricGroups(apiTypes: readonly string[] | undefined): readonly MetricCatalogGroup[];
+export declare function offeredMetricGroups(catalog: MetricCatalog, apiTypes: readonly string[] | undefined): readonly MetricCatalogGroup[];
 /**
  * The dimensions the picker offers as a group-by for `metrics` under the
  * declared `apiTypes`: those every known metric lists among its facets, and
@@ -104,14 +138,31 @@ export declare function offeredMetricGroups(apiTypes: readonly string[] | undefi
  * nothing: what it accepts is unknown, and refusing every dimension would
  * leave the author none to pick.
  */
-export declare function offeredDimensions(metrics: readonly string[], apiTypes: readonly string[] | undefined): readonly DimensionCatalogEntry[];
+export declare function offeredDimensions(catalog: MetricCatalog, metrics: readonly string[], apiTypes: readonly string[] | undefined): readonly DimensionCatalogEntry[];
+/** What a new widget, series, tile or column starts on. */
+export interface DefaultMetric {
+    readonly name: string;
+    /** The metric's default measure, the first it is served with. */
+    readonly measure: string;
+    readonly unit?: string;
+}
+/**
+ * The first `count` metrics the host is offered, in picker order: what a new
+ * widget, series, tile or column starts on, so an author on an AuthZ or
+ * Kafka host starts on a metric of their own catalog rather than on an HTTP
+ * one shown under Custom. Never empty: a catalog with no metric at all falls
+ * back to the bundled one.
+ */
+export declare function defaultMetricsFor(catalog: MetricCatalog, apiTypes: readonly string[] | undefined, count?: number): readonly DefaultMetric[];
+/** The first metric the host is offered. See {@link defaultMetricsFor}. */
+export declare function defaultMetricFor(catalog: MetricCatalog, apiTypes: readonly string[] | undefined): DefaultMetric;
 /** The field the editor scopes a widget by when its metric belongs to an API type. */
 export declare const API_TYPE_FIELD = "API_TYPE";
 /**
  * Collects the API-type scopes required by the metrics/dimensions referenced
  * in a widget configuration. Returns undefined when nothing is scoped.
  */
-export declare function requiredScopesFor(names: {
+export declare function requiredScopesFor(catalog: MetricCatalog, names: {
     metrics: readonly string[];
     dimensions: readonly string[];
 }): readonly MetricScope[] | undefined;
@@ -121,8 +172,12 @@ export declare function requiredScopesFor(names: {
  * wins); removes nothing when scopes are no longer required, so a manual
  * broader scope survives metric changes.
  */
-export declare function withRequiredScopeFilter(filters: readonly FilterCondition[] | undefined, names: {
+export declare function withRequiredScopeFilter(catalog: MetricCatalog, filters: readonly FilterCondition[] | undefined, names: {
     metrics: readonly string[];
     dimensions: readonly string[];
 }): FilterCondition[] | undefined;
+/** The endpoint's answer to `apiType=HTTP_PROXY&apiType=LLM`, captured from APIM master d563f02c8 (:8093) on 2026-10-30, without `filters`. */
+export declare const BUNDLED_ANALYTICS_DEFINITION: AnalyticsDefinition;
+/** The catalog every reader gets until the served one is there, and for good when it never comes. */
+export declare const BUNDLED_METRIC_CATALOG: MetricCatalog;
 //# sourceMappingURL=metric-catalog.d.ts.map

package/dist/dashboards/metric-catalog.d.ts.map

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

package/dist/dashboards/renderers/CartesianWidgetRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CartesianWidgetRenderer.d.ts","sourceRoot":"","sources":["../../../src/dashboards/renderers/CartesianWidgetRenderer.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,oBAAoB,CAAC;AAO5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMvE,wBAAgB,uBAAuB,CAAC,EACtC,MAAM,EACN,SAAS,EACT,OAAO,EACP,eAAe,GAChB,EAAE,mBAAmB,CAAC,eAAe,CAAC,2CAoItC"}
+{"version":3,"file":"CartesianWidgetRenderer.d.ts","sourceRoot":"","sources":["../../../src/dashboards/renderers/CartesianWidgetRenderer.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,eAAe,EAAoB,MAAM,oBAAoB,CAAC;AAO5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMvE,wBAAgB,uBAAuB,CAAC,EACtC,MAAM,EACN,SAAS,EACT,OAAO,EACP,eAAe,GAChB,EAAE,mBAAmB,CAAC,eAAe,CAAC,2CAqItC"}

package/dist/dashboards/renderers/MetricGroupWidgetRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MetricGroupWidgetRenderer.d.ts","sourceRoot":"","sources":["../../../src/dashboards/renderers/MetricGroupWidgetRenderer.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAA6B,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AASvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMvE,wBAAgB,yBAAyB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,2CAkH/G"}
+{"version":3,"file":"MetricGroupWidgetRenderer.d.ts","sourceRoot":"","sources":["../../../src/dashboards/renderers/MetricGroupWidgetRenderer.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAA6B,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AASvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMvE,wBAAgB,yBAAyB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,2CAmH/G"}

package/dist/dashboards/renderers/TableWidgetRenderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TableWidgetRenderer.d.ts","sourceRoot":"","sources":["../../../src/dashboards/renderers/TableWidgetRenderer.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AA0BvE,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,mBAAmB,CAAC,WAAW,CAAC,2CAgH/G"}
+{"version":3,"file":"TableWidgetRenderer.d.ts","sourceRoot":"","sources":["../../../src/dashboards/renderers/TableWidgetRenderer.tsx"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAQjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AA0BvE,wBAAgB,mBAAmB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,mBAAmB,CAAC,WAAW,CAAC,2CAiH/G"}

package/dist/data-sources/http-analytics-definition-source.d.ts

@@ -0,0 +1,59 @@
+import { HttpOptions } from '../providers/http-provider';
+/**
+ * One metric as the analytics definition endpoint describes it.
+ *
+ * `unit`, `measures` and `origin` are open strings: the endpoint gains values
+ * (dynamic metrics are `DECLARED` or `DISCOVERED`, OBS-77) without a library
+ * release, and a value this library does not know is carried as it came, never
+ * refused.
+ */
+export interface AnalyticsMetricDefinition {
+    readonly name: string;
+    readonly label: string;
+    /** `NUMBER`, `MILLISECONDS`, `BYTES` or `PERCENT` today. */
+    readonly unit: string;
+    /** The API kinds the metric exists for. */
+    readonly apiTypes: readonly string[];
+    /** The measures the engine accepts for it; the first is the default. */
+    readonly measures: readonly string[];
+    /** Names of the dimensions the metric can be grouped by; their labels are in `dimensions`. */
+    readonly facets: readonly string[];
+    /** The filters the engine accepts on it. Served, not read by this library. */
+    readonly filters?: readonly string[];
+    readonly origin: string;
+}
+export interface AnalyticsMetricFamily {
+    /** `GATEWAY`, `LLM`, `MESSAGE`, `EDGE`, `NATIVE` or `AUTHZ`. */
+    readonly name: string;
+    readonly label: string;
+    readonly metrics: readonly AnalyticsMetricDefinition[];
+}
+export interface AnalyticsDimensionDefinition {
+    readonly name: string;
+    readonly label: string;
+    readonly origin: string;
+}
+/**
+ * The body of `GET {baseUrl}/observability/analytics/definition?apiType=…`
+ * (Management API, OBS-73): the metrics of the requested API kinds grouped by
+ * family, families in a fixed order and empty ones left out, and every
+ * dimension those metrics can be grouped by, once, in order of first
+ * appearance.
+ */
+export interface AnalyticsDefinition {
+    readonly families: readonly AnalyticsMetricFamily[];
+    readonly dimensions: readonly AnalyticsDimensionDefinition[];
+}
+export interface AnalyticsDefinitionSource {
+    /**
+     * What tells this source's answers apart in the query cache: the base URL
+     * for the HTTP source, which carries the organization and the environment,
+     * so an environment switch never reads the other environment's catalog.
+     * Any constant for an in-memory source.
+     */
+    readonly scope: string;
+    /** The definition for `apiTypes`, which must name at least one API kind. */
+    fetchAnalyticsDefinition(apiTypes: readonly string[], signal?: AbortSignal): Promise<AnalyticsDefinition>;
+}
+export declare function createHttpAnalyticsDefinitionSource(baseUrl: string, options?: HttpOptions): AnalyticsDefinitionSource;
+//# sourceMappingURL=http-analytics-definition-source.d.ts.map

package/dist/data-sources/http-analytics-definition-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-analytics-definition-source.d.ts","sourceRoot":"","sources":["../../src/data-sources/http-analytics-definition-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAI9D;;;;;;;GAOG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,SAAS,yBAAyB,EAAE,CAAC;CACxD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACpD,QAAQ,CAAC,UAAU,EAAE,SAAS,4BAA4B,EAAE,CAAC;CAC9D;AAED,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,wBAAwB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC3G;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,yBAAyB,CAsBrH"}

package/dist/data-sources/http-filter-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-filter-source.d.ts","sourceRoot":"","sources":["../../src/data-sources/http-filter-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAKf,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAiE9D,MAAM,WAAW,YAAY;IAC3B,sBAAsB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACxE;;;;OAIG;IACH,aAAa,CACX,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,EAChD,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACpD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,CA+H3F"}
+{"version":3,"file":"http-filter-source.d.ts","sourceRoot":"","sources":["../../src/data-sources/http-filter-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAKf,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAiE9D,MAAM,WAAW,YAAY;IAC3B,sBAAsB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACxE;;;;OAIG;IACH,aAAa,CACX,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,EAChD,MAAM,CAAC,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACpD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,YAAY,CAqH3F"}

package/dist/data-sources/http-traces-filter-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-traces-filter-source.d.ts","sourceRoot":"","sources":["../../src/data-sources/http-traces-filter-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AA2CzD,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,YAAY,CAmH/G"}
+{"version":3,"file":"http-traces-filter-source.d.ts","sourceRoot":"","sources":["../../src/data-sources/http-traces-filter-source.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AA2CzD,MAAM,WAAW,yBAA0B,SAAQ,WAAW;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,yBAAyB,GAAG,YAAY,CA0G/G"}

package/dist/data-sources/http-utils.d.ts

@@ -1,4 +1,10 @@
 import { HttpOptions } from '../providers/http-provider';
+/**
+ * The `RequestInit` of a call made with the shared HTTP options: `extra` (a
+ * signal, a method, a body) plus the host's headers and credentials, headers
+ * merged only when there are any so a bare GET stays a bare GET.
+ */
+export declare function buildRequestInit(options: HttpOptions | undefined, extra?: RequestInit): RequestInit;
 export declare function resolveHeaders(headers: HttpOptions['headers']): HeadersInit | undefined;
 /**
  * Merge multiple HeadersInit sources. Later sources override earlier ones

package/dist/data-sources/http-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-utils.d.ts","sourceRoot":"","sources":["../../src/data-sources/http-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,WAAW,GAAG,SAAS,CAGvF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,CAAC,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,GAAG,WAAW,CAOxF"}
+{"version":3,"file":"http-utils.d.ts","sourceRoot":"","sources":["../../src/data-sources/http-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,KAAK,CAAC,EAAE,WAAW,GAAG,WAAW,CAQnG;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,SAAS,CAAC,GAAG,WAAW,GAAG,SAAS,CAGvF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,CAAC,WAAW,GAAG,SAAS,GAAG,IAAI,CAAC,EAAE,GAAG,WAAW,CAOxF"}

package/dist/hooks/query-keys.d.ts

@@ -76,5 +76,15 @@ export declare const observabilityQueryKeys: {
     readonly filterLabels: (key: string, apiProduct?: string) => readonly ["observability", "filterLabels", string, {
         readonly apiProduct: string | undefined;
     }];
+    /**
+     * The analytics definition a dashboard reads its metric catalog from, keyed
+     * on the source's scope (the base URL, which carries the organization and
+     * the environment) and on the API kinds asked for, as a set: the endpoint
+     * answers the same body whatever their order.
+     */
+    readonly analyticsDefinition: (scope: string, apiTypes: readonly string[]) => readonly ["observability", "analytics-definition", {
+        readonly scope: string;
+        readonly apiTypes: string[];
+    }];
 };
 //# sourceMappingURL=query-keys.d.ts.map

package/dist/hooks/query-keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query-keys.d.ts","sourceRoot":"","sources":["../../src/hooks/query-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAyB3E,eAAO,MAAM,sBAAsB;;mCAItB,SAAS,kBAAkB,EAAE,aAC3B,SAAS,YACV,MAAM,YACN,eAAe,EAAE,OACtB,SAAS,MAAM,EAAE,UACd,MAAM,WACL,SAAS,YAAY,EAAE;;;;;;;;;0BAS5B,SAAS,MAAM,EAAE,aACV,SAAS,YACV,eAAe,EAAE,YACjB;QACR,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;QACxC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;;;;;;;;;iCAgBiB,SAAS,aAAa,EAAE,aAAa,SAAS,YAAY,eAAe,EAAE;;;;;+BAO7E,SAAS,YAAY,eAAe,EAAE;;;;6BAGxC,MAAM,SAAS,MAAM;+BAEnB,MAAM,SAAS,MAAM;6BAEvB,MAAM,aAAa,SAAS,YAAY,eAAe,EAAE;;;;;kCAGpD,MAAM,WAAW,MAAM;;;;;4CAIb,MAAM;;;4CAEN,MAAM,UAAU,MAAM;;;;iDAGjB,MAAM;;;6BAE1B,MAAM;IAEtB;;;;;OAKG;yCACyB,MAAM;;;IAElC;;;OAGG;mCACmB,MAAM,WAAW,MAAM;;;iCAEzB,MAAM,eAAe,MAAM;;;CACvC,CAAC"}
+{"version":3,"file":"query-keys.d.ts","sourceRoot":"","sources":["../../src/hooks/query-keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAyB3E,eAAO,MAAM,sBAAsB;;mCAItB,SAAS,kBAAkB,EAAE,aAC3B,SAAS,YACV,MAAM,YACN,eAAe,EAAE,OACtB,SAAS,MAAM,EAAE,UACd,MAAM,WACL,SAAS,YAAY,EAAE;;;;;;;;;0BAS5B,SAAS,MAAM,EAAE,aACV,SAAS,YACV,eAAe,EAAE,YACjB;QACR,OAAO,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;QACxC,MAAM,CAAC,EAAE,SAAS,YAAY,EAAE,CAAC;QACjC,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB;;;;;;;;;iCAgBiB,SAAS,aAAa,EAAE,aAAa,SAAS,YAAY,eAAe,EAAE;;;;;+BAO7E,SAAS,YAAY,eAAe,EAAE;;;;6BAGxC,MAAM,SAAS,MAAM;+BAEnB,MAAM,SAAS,MAAM;6BAEvB,MAAM,aAAa,SAAS,YAAY,eAAe,EAAE;;;;;kCAGpD,MAAM,WAAW,MAAM;;;;;4CAIb,MAAM;;;4CAEN,MAAM,UAAU,MAAM;;;;iDAGjB,MAAM;;;6BAE1B,MAAM;IAEtB;;;;;OAKG;yCACyB,MAAM;;;IAElC;;;OAGG;mCACmB,MAAM,WAAW,MAAM;;;iCAEzB,MAAM,eAAe,MAAM;;;IAE/C;;;;;OAKG;0CAC0B,MAAM,YAAY,SAAS,MAAM,EAAE;;;;CAExD,CAAC"}

package/dist/hooks/use-metric-catalog.d.ts

@@ -0,0 +1,36 @@
+import { MetricCatalog } from '../dashboards/metric-catalog';
+/** Aligned with the filter definitions: a catalog changes on a backend release, not between two edits. */
+export declare const ANALYTICS_DEFINITION_STALE_TIME: number;
+/**
+ * The API kinds asked of the definition endpoint for a host's declaration:
+ * the kinds it declared that the analytics know, in the endpoint's own order
+ * so the same set always builds the same URL; every kind when it declared
+ * none, or none the analytics know. A kind the analytics do not know is left
+ * out rather than sent: the endpoint refuses the whole request for one
+ * unknown token, and the catalog of the known kinds would be lost with it.
+ */
+export declare function requestedApiTypes(declared: readonly string[] | undefined): readonly string[];
+export interface MetricCatalogState {
+    readonly catalog: MetricCatalog;
+    /**
+     * The bundled catalog is standing in for the served one, for the current
+     * window: no source is mounted, or the request was refused or failed after
+     * the retry policy. Not while the first request is still in flight, nor
+     * when a refresh fails over a served catalog already in hand, which stays.
+     */
+    readonly onFallback: boolean;
+}
+/**
+ * The metric catalog of the environment, and whether it is the bundled one.
+ *
+ * Asked once per environment and set of API kinds, through the source in
+ * scope and the `observabilityQueryKeys` factory, and shared by every reader
+ * of the dashboard, editor and view mode alike. Nothing waits on it: until
+ * the served catalog is there the bundled one answers, so a saved widget
+ * renders at once with the labels it knows, and takes the served ones when
+ * they arrive.
+ */
+export declare function useMetricCatalogState(): MetricCatalogState;
+/** The metric catalog every reader labels and offers by. See {@link useMetricCatalogState}. */
+export declare function useMetricCatalog(): MetricCatalog;
+//# sourceMappingURL=use-metric-catalog.d.ts.map

package/dist/hooks/use-metric-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-metric-catalog.d.ts","sourceRoot":"","sources":["../../src/hooks/use-metric-catalog.ts"],"names":[],"mappings":"AAEA,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAQtC,0GAA0G;AAC1G,eAAO,MAAM,+BAA+B,QAAgB,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,MAAM,EAAE,CAG5F;AAiCD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CA2C1D;AAED,+FAA+F;AAC/F,wBAAgB,gBAAgB,IAAI,aAAa,CAEhD"}