@gravitee/gamma-lib-observability 3.1.1 → 3.2.0-amp-demo.da2facd

package/INTEGRATION.md

@@ -17,6 +17,7 @@ This guide walks through integrating the observability library into a Gamma modu
 - [Feature: Logs](#feature-logs)
 - [Feature: Widget Embedding](#feature-widget-embedding)
 - [Feature: Traces (preview)](#feature-traces-preview)
+- [Feature: Targets](#feature-targets)
 - [Navigation & Breadcrumbs](#navigation--breadcrumbs)
 - [Capabilities (RBAC)](#capabilities-rbac)
 - [Advanced Topics](#advanced-topics)
@@ -803,6 +804,65 @@ When `tracesBaseUrl` is omitted, the lib falls back to `baseUrl`. Both now produ
 
 ---
 
+## Feature: Targets
+
+A **performance target** declares what "good" looks like for a subject — an API, an agent, anything the gateway reports telemetry for — as rules over the analytics vocabulary (`HTTP_GATEWAY_RESPONSE_TIME P95 ≤ 2000`, `HTTP_SERVER_ERROR_RATE PERCENTAGE ≤ 1`) evaluated on a rolling window. The Management API v2 stores the targets and evaluates them on a schedule (`/environments/{envId}/performance-targets`); this library ships the "Targets" tab and the list badge that read and write them.
+
+The components know nothing about APIs versus agents. The host says what the subject is through three props, and the module that owns the subject keeps `apiIds` current (an API page passes its own id; an agent page passes the APIs its lineage resolved to):
+
+| Prop        | Value                                                                                                      |
+| ----------- | ---------------------------------------------------------------------------------------------------------- |
+| `reference` | The lookup key the host will use to find these targets again — the API id, the agent's catalog id, …       |
+| `apiIds`    | The API ids whose gateway telemetry is evaluated. May be empty while nothing is attributed yet.            |
+| `apiTypes`  | The `ApiType` of those APIs (`PROXY`, `LLM_PROXY`, `MCP_PROXY`, `A2A_PROXY`, …); drives the metric picker. |
+
+### Mounting the tab
+
+Wrap the panel in a `TargetsProvider` whose `baseUrl` is the **Management API v2 environment root** (`{managementBaseURL}/v2/environments/{envId}`), where the targets and the analytics definition live. This is not the Gamma-scoped URL `observability.Routes` takes; a Gamma host builds it from the bootstrap's `managementBaseURL`. The provider reuses the nearest `HttpProvider` for `fetch`/headers/credentials, or takes an `http` prop of its own. `baseUrl` may be `undefined` while the host resolves it: badges then wait, and the panel should be mounted once it is known.
+
+```tsx
+import { TargetsPanel, TargetsProvider } from '@gravitee/gamma-lib-observability';
+
+function ApiTargetsTab({ api }: { api: ApiDetailDto }) {
+  const { baseUrl } = useObservabilityBaseUrl();
+  return (
+    <TargetsProvider baseUrl={baseUrl} http={observabilityHttpOptions}>
+      <TargetsPanel
+        reference={api.id}
+        apiIds={[api.id]}
+        apiTypes={[api.type]}
+        readOnly={!canUpdateApi} // hides define / edit / delete / evaluate now
+      />
+    </TargetsProvider>
+  );
+}
+```
+
+The panel renders, in order: the empty state ("No targets declared", with the reason when `apiIds` is empty), one card per target with the latest verdict, a banner naming the missed rule and how long the miss has lasted, each rule's observed value against its threshold with deviation and sample count, the last windows as a strip, and "Evaluate now", which counts the server's rate limit down before offering again. `NOT_EVALUABLE` rules say why: no API attributed, no traffic in the window, or fewer samples than the target's minimum.
+
+"Define targets" lists only the metrics the analytics definition serves for the subject's `apiTypes` (`GET /analytics/definition/apis/{apiName}/metrics`), shows the per-type scope only when the subject spans several types, and offers a filter only on metrics with a protocol dimension to scope by (MCP tool or method, LLM model, HTTP method or path, …). A server refusal that blames one rule (`parameters.ruleIndex`) lands under that rule.
+
+### List badges
+
+For a table, ask once for the whole page of rows and hand each row its answer; the hook batches by 500 references and never issues a request per row:
+
+```tsx
+import { TargetStatusBadge, useLatestTargetEvaluations } from '@gravitee/gamma-lib-observability';
+
+function StatusColumn({ rows }: { rows: { id: string }[] }) {
+  const latest = useLatestTargetEvaluations(rows.map((row) => row.id));
+  return rows.map((row) => <TargetStatusBadge key={row.id} evaluation={latest.data?.[row.id]} />);
+}
+```
+
+`evaluation` is `undefined` while loading, `null` when the reference has no target or no evaluation yet, and otherwise the latest evaluation (the worst one when several targets share the reference).
+
+### Testing a host mount
+
+`@gravitee/gamma-lib-observability/testing` exports `createInMemoryTargetsSource`, a `TargetsSource` over plain arrays with the server's refusals reproduced (400 with `ruleIndex`, 429 with `Retry-After`), and `SAMPLE_METRIC_SPECS`, a cut of the analytics definition. Pass it to `TargetsProvider` through the `source` prop.
+
+---
+
 ## Navigation & Breadcrumbs
 
 ### Sidebar navigation

package/QUERYING.md

@@ -74,13 +74,14 @@ the same metric/range) dedupe.
 
 ## 4. Widget → request mapping
 
-| Widget         | Endpoint    | Mapping                                                                                                                                                                                                  |
-| -------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `metric`       | measures    | `{ metric, measure }` → one `MetricRequest`. Widget `filters` → top-level filters.                                                                                                                       |
-| `metric-group` | measures    | each `items[]` → one `MetricRequest` (`metric`, `measure`, per-item `filters`). Identical (metric+filters) items are deduped.                                                                            |
-| `cartesian`    | time-series | each `series[]` → one query. `metric`/`measure` → `metrics[0]`; `by` → `by[]`; `filters`/`sorts`/`ranges`/`limit` forwarded. Results are merged on the shared time bucket (`category`) before rendering. |
-| `doughnut`     | facets      | `by` → `by[]`; `metric`/`measure`/`sorts` → `metrics[0]`; `ranges`/`limit` forwarded.                                                                                                                    |
-| `bar`          | facets      | same as `doughnut`, plus `barLayout`.                                                                                                                                                                    |
+| Widget         | Endpoint    | Mapping                                                                                                                                                                                                                                                                                                              |
+| -------------- | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `metric`       | measures    | `{ metric, measure }` → one `MetricRequest`. Widget `filters` → top-level filters.                                                                                                                                                                                                                                   |
+| `metric-group` | measures    | each `items[]` → one `MetricRequest` (`metric`, `measure`, per-item `filters`). Identical (metric+filters) items are deduped.                                                                                                                                                                                        |
+| `cartesian`    | time-series | each `series[]` → one query. `metric`/`measure` → `metrics[0]`; `by` → `by[]`; `filters`/`sorts`/`ranges`/`limit` forwarded. Results are merged on the shared time bucket (`category`) before rendering.                                                                                                             |
+| `doughnut`     | facets      | `by` → `by[]`; `metric`/`measure`/`sorts` → `metrics[0]`; `ranges`/`limit` forwarded.                                                                                                                                                                                                                                |
+| `bar`          | facets      | same as `doughnut`, plus `barLayout`.                                                                                                                                                                                                                                                                                |
+| `table`        | facets      | `by` → `by[]`; `columns[]` grouped by distinct `metric` → one `metrics[]` entry each, measures de-duplicated; `sorts` goes on **exactly one** metric, the one owning the sort column; `ranges`/`limit` forwarded. With `showTotals` or a `share` column, one extra measures request with the same filters and range. |
 
 **Presentation-only fields** (not sent to analytics; consumed by `CartesianPresentation` / graphene-charts):
 
@@ -109,6 +110,11 @@ chart total.
   sent to the backend but flattened onto the first level.
 - Distinct visual series for several measures of one metric are best expressed as one `series[]` entry
   per measure (e.g. P90/P95/P99), which the renderer keys apart by measure.
+- `table` rows come from the metric carrying `sorts`; the other metrics are joined on the bucket key.
+  The backend aggregates each metric separately, so a sort on anything but a count can leave a row
+  without a value for another column: the cell renders `—` and the widget reports how many rows are
+  incomplete. A single-column table issues exactly the request a top list on the same query issues, and
+  shares its cache entry.
 
 ---
 
@@ -224,6 +230,51 @@ series to keep a single left axis (backward compatible).
 
 ---
 
+### 5.7 Multi-metric table (one facets request, sort on one metric)
+
+```json
+{
+  "type": "table",
+  "by": ["API"],
+  "columns": [
+    { "metric": "HTTP_REQUESTS", "measure": "COUNT", "share": true },
+    {
+      "metric": "HTTP_ERROR_RATE",
+      "measure": "PERCENTAGE",
+      "thresholds": [{ "color": "red", "op": "gte", "value": 5 }]
+    },
+    { "metric": "HTTP_GATEWAY_RESPONSE_TIME", "measure": "P95", "pinned": true }
+  ],
+  "sort": { "columnId": "HTTP_GATEWAY_RESPONSE_TIME:P95", "order": "DESC" },
+  "limit": 10,
+  "showTotals": true
+}
+```
+
+Facets request (`sorts` on the P95 metric only, the others unordered):
+
+```json
+{
+  "by": ["API"],
+  "limit": 10,
+  "metrics": [
+    { "name": "HTTP_REQUESTS", "measures": ["COUNT"] },
+    { "name": "HTTP_ERROR_RATE", "measures": ["PERCENTAGE"] },
+    { "name": "HTTP_GATEWAY_RESPONSE_TIME", "measures": ["P95"], "sorts": [{ "measure": "P95", "order": "DESC" }] }
+  ]
+}
+```
+
+Plus, because `showTotals` is on, one measures request for the same three metrics under the same
+filters and range. A column's id is `metric:measure` unless it declares an `id`; the sort refers to it.
+A threshold is an alert tier: `{ color, op, value, basis? }` paints the cell `color` (`red`, `amber`
+or `green`) when it crosses `value`, `op` being `gte` (at or above) or `lte` (at or below) and `basis`
+what is compared: the cell's own value (default) or its share of the column total in percent
+(`"basis": "share"`, which also triggers the measures request for the total). Thresholds are ordered rules: the first one a cell matches decides its colour, so the author's
+order is the priority.
+
+---
+
 ## 6. Filter semantics
 
 Filters merge in this order, later layers win on a field conflict:

package/README.md

@@ -11,6 +11,7 @@ This library provides a **contributor model**: it exports page components, route
 - **Dashboards** — read-only preset dashboards with CSS Grid widget layout
 - **Embeddable widgets** — `WidgetItem` and `WidgetGroup` for embedding KPIs/charts on any page, with auto (data-fetching) and manual (host-provided data) modes
 - **Logs** — `LogsExplorerPage` with search, filters, pagination, and column visibility
+- **Targets** — `TargetsPanel` and `TargetStatusBadge` for performance targets declared on any subject (API, agent), evaluated by the Management API against gateway telemetry
 - **Filters & time range** — `<FilterBar>`, `<TimeRangePicker>`, URL state codec
 - **DI providers** — DataSource ports (Metrics, Logs, Traces), Capability, Persistence
 - **Routing** — `defineObservabilityFeatures` for zero-config route + nav integration

package/USAGE_GUIDE.md

@@ -492,6 +492,8 @@ import { MetricPresentation, BarPresentation } from '@gravitee/gamma-lib-observa
 | Manual | `CartesianWidget`   | `CartesianWidgetData`   |
 | Manual | `BarWidget`         | `BarWidgetData`         |
 | Manual | `DoughnutWidget`    | `DoughnutWidgetData`    |
+| Manual | `BreakdownWidget`   | `BreakdownWidgetData`   |
+| Manual | `TableWidget`       | `TableWidgetData`       |
 
 Shared props (available in all modes):
 
@@ -504,12 +506,46 @@ Shared props (available in all modes):
 
 #### `WidgetGroupProps`
 
-| Prop        | Type                         | Required | Default     | Description                                               |
-| ----------- | ---------------------------- | -------- | ----------- | --------------------------------------------------------- |
-| `timeRange` | `TimeRange`                  | Yes      |             | Time range propagated to all nested `WidgetItem`s         |
-| `filters`   | `readonly FilterCondition[]` | No       | `[]`        | Filters propagated to all nested `WidgetItem`s            |
-| `align`     | `WidgetGroupAlign`           | No       | `'stretch'` | Cross-axis alignment: `stretch`, `center`, `start`, `end` |
-| `children`  | `ReactNode`                  | Yes      |             | `WidgetItem` children                                     |
+| Prop          | Type                            | Required | Default     | Description                                                |
+| ------------- | ------------------------------- | -------- | ----------- | ---------------------------------------------------------- |
+| `timeRange`   | `TimeRange`                     | Yes      |             | Time range propagated to all nested `WidgetItem`s          |
+| `filters`     | `readonly FilterCondition[]`    | No       | `[]`        | Filters propagated to all nested `WidgetItem`s             |
+| `align`       | `WidgetGroupAlign`              | No       | `'stretch'` | Cross-axis alignment: `stretch`, `center`, `start`, `end`  |
+| `interaction` | `WidgetInteractionContextValue` | No       |             | Receives what a reader acts on inside a widget (see below) |
+| `children`    | `ReactNode`                     | Yes      |             | `WidgetItem` children                                      |
+
+#### Widget interactions (row drill-down)
+
+A widget can send a value the reader acted on back to the page — a table row, today — through a
+`WidgetInteraction { kind, field, value, label? }`. `DashboardView` and `WidgetGroup` both take an
+`interaction` prop; `ObservabilityDashboardPage` wires it for you (a row click adds a filter chip on
+the widget's dimension, clicking the same row again clears it, a locked dashboard filter is never
+overridden). When embedding widgets yourself:
+
+```tsx
+<WidgetGroup
+  timeRange={timeRange}
+  filters={filters}
+  interaction={{
+    onInteract: ({ kind, field, value }) => {
+      if (kind === 'filter') setFilters(upsertFilterCondition(filters, field, value));
+    },
+    // Optional: which kinds the page can act on, per field. Only `filter` is
+    // offered when omitted; `exclude` needs the field's provider to advertise
+    // `not_in`, `view-logs` / `view-traces` / `open-entity` need a route.
+    supports: (kind) => kind === 'filter',
+  }}
+>
+  <WidgetItem widget={topApisTable} />
+</WidgetGroup>
+```
+
+Widgets rendered without an `interaction` upstream show no row affordance at all rather than a dead
+one. The built-in dashboard page offers **View logs** / **View traces** only for a sibling screen the
+host enabled in `defineObservabilityFeatures` (and the reader may read), and **View traces** only on
+the `API` dimension, since the tracing screen is per API (`tracing/:apiId`). A layout may declare `minCols` / `minRows`, which `DashboardView` forwards to the grid; no
+widget type sets them by default. A table that gets too small degrades in steps instead: compact
+numbers, collapsed columns, a top list, then an explicit "Enlarge the widget" state.
 
 ---
 
@@ -1206,4 +1242,45 @@ import { TracingScreen, SpanDetailPanel, TracingApiSelector } from '@gravitee/ga
 
 ---
 
+## Targets
+
+Performance targets declared on a subject and evaluated by the Management API v2 (`/environments/{envId}/performance-targets`). Mounting and the subject props are covered in [`INTEGRATION.md`](./INTEGRATION.md#feature-targets); this is the API surface.
+
+### Components
+
+| Export              | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
+| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `TargetsProvider`   | Hands the components their `TargetsSource`: `baseUrl` (+ optional `http`, else the nearest `HttpProvider`) or a ready `source` for tests                                                                                                                                                                                                                                                                                                                     |
+| `TargetsPanel`      | The "Targets" tab: `{ reference, apiIds, apiTypes, readOnly? }` — empty state, one card per target, the define/edit form, delete, evaluate                                                                                                                                                                                                                                                                                                                   |
+| `TargetStatusBadge` | List badge: `evaluation` is `undefined` (loading), `null` (no target) or the latest `TargetEvaluation`                                                                                                                                                                                                                                                                                                                                                       |
+| `TargetHeatmap`     | The history as one status timeline per rule: runs of equal verdicts drawn as flat blocks (green met, red missed, grey not evaluable, blank where nothing was recorded or the rule did not exist yet), each window keeping its exact share of the strip; a cursor follows the pointer or the arrow keys one window at a time, and the card names the window and the run it sits in; `windows` pads the strip to the range the panel picked (2 h / 6 h / 24 h) |
+| `RuleTrend`         | One rule's readings over the windows with the threshold as a dashed line, coloured per stretch by which side of the line it sat on; gaps where a window could not be evaluated                                                                                                                                                                                                                                                                               |
+
+### Hooks
+
+All hooks read the source from `TargetsProvider` and key their queries under `observabilityQueryKeys.targets*`.
+
+| Hook                                       | Returns                                                                                                          |
+| ------------------------------------------ | ---------------------------------------------------------------------------------------------------------------- |
+| `useTargetsByReference(reference)`         | `PerformanceTarget[]` declared under the reference                                                               |
+| `useTargetHistory(targetId, perPage = 24)` | `{ data: TargetEvaluation[], totalCount }`, most recent first                                                    |
+| `useLatestTargetEvaluations(references)`   | `Record<reference, TargetEvaluation \| null>`; batched by 500, one request per batch                             |
+| `useTargetMetricCatalog(apiTypes)`         | `{ metrics, isLoading, error }` — the definition's metrics for those types, merged, `apis` covering every type   |
+| `useTargetFilterSpecs(metricName)`         | The definition's filters for one metric                                                                          |
+| `useTargetMutations(reference)`            | `{ create, update, remove, evaluateNow }` mutations that refresh the list, the history and the badges they touch |
+
+### Errors
+
+`TargetsApiError` carries the `status` and, on a 400 that blames one rule, `ruleIndex`; `TargetRateLimitedError` (429) carries `retryAfterSeconds`. Branch on `isTargetRateLimited(error)` and `targetErrorRuleIndex(error)` rather than `instanceof`, for the same reason as the dashboard errors.
+
+### Vocabulary helpers
+
+`analyticsApiName(apiType)` maps an `ApiType` to the analytics definition's API name (`PROXY` → `HTTP_PROXY`, `LLM_PROXY` → `LLM`, …). `describeRule(rule, { label, unit })` renders `p95 Gateway response time ≤ 2,000 ms`; `formatMetricValue`, `formatDeviation`, `statusLabel` (`Met` / `Missed` / `Not evaluable`) and `notEvaluableReason` produce the words the panel uses, so a host can quote a target consistently elsewhere.
+
+### Testing
+
+`@gravitee/gamma-lib-observability/testing` exports `createInMemoryTargetsSource(options)` — targets, evaluations, a metric catalog (`SAMPLE_METRIC_SPECS` by default), an `evaluate` function for "evaluate now", `rateLimitedForSeconds`, `latencyMs` and `failure` — to drive `TargetsPanel` through `TargetsProvider`'s `source` prop.
+
+---
+
 _This guide will be expanded as new features are added (custom dashboards)._

package/dist/dashboards/DashboardView.d.ts

@@ -1,5 +1,6 @@
 import { BreakpointCols } from '@gravitee/graphene-charts/dashboard-grid';
 import { Dashboard, FilterCondition, TimeRange, Widget, WidgetLayout } from '../types/domain';
+import { WidgetInteractionContextValue } from './WidgetInteractionContext';
 export interface DashboardViewProps {
     readonly dashboard: Dashboard;
     readonly timeRange: TimeRange;
@@ -28,6 +29,12 @@ export interface DashboardViewProps {
      * user knows the grid copy will be replaced on save.
      */
     readonly highlightedWidgetId?: string;
+    /**
+     * Receives what a reader acted on inside a widget — a table row, say — so the
+     * page can turn it into a dashboard filter or a navigation. Left out, widgets
+     * render without the affordance rather than with a dead one.
+     */
+    readonly interaction?: WidgetInteractionContextValue;
 }
-export declare function DashboardView({ dashboard, timeRange, filters, editable, rowHeight, breakpointCols, onLayoutChange, widgetActions, highlightedWidgetId, }: DashboardViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function DashboardView({ dashboard, timeRange, filters, editable, rowHeight, breakpointCols, onLayoutChange, widgetActions, highlightedWidgetId, interaction, }: DashboardViewProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=DashboardView.d.ts.map

package/dist/dashboards/DashboardView.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DashboardView.d.ts","sourceRoot":"","sources":["../../src/dashboards/DashboardView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,0CAA0C,CAAC;AAIrG,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAgCnG,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,iIAAiI;IACjI,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,IAAI,CAAC;IAC/E;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7D;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,SAAS,EACT,OAAuB,EACvB,QAAgB,EAChB,SAAS,EACT,cAAwC,EACxC,cAAc,EACd,aAAa,EACb,mBAAmB,GACpB,EAAE,kBAAkB,2CA2EpB"}
+{"version":3,"file":"DashboardView.d.ts","sourceRoot":"","sources":["../../src/dashboards/DashboardView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAwB,MAAM,0CAA0C,CAAC;AAIrG,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEnG,OAAO,EAA6B,KAAK,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AA+B3G,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,iIAAiI;IACjI,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IACzC,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,IAAI,CAAC;IAC/E;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC;IAC7D;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,6BAA6B,CAAC;CACtD;AAED,wBAAgB,aAAa,CAAC,EAC5B,SAAS,EACT,SAAS,EACT,OAAuB,EACvB,QAAgB,EAChB,SAAS,EACT,cAAwC,EACxC,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,WAAW,GACZ,EAAE,kBAAkB,2CAoFpB"}

package/dist/dashboards/WidgetGroup.d.ts

@@ -1,10 +1,16 @@
 import { ReactNode } from 'react';
 import { FilterCondition, TimeRange } from '../types/domain';
+import { WidgetInteractionContextValue } from './WidgetInteractionContext';
 export type WidgetGroupAlign = 'stretch' | 'center' | 'start' | 'end';
 export interface WidgetGroupProps {
     readonly timeRange: TimeRange;
     readonly filters?: readonly FilterCondition[];
     readonly align?: WidgetGroupAlign;
+    /**
+     * Receives what a reader acted on inside a widget. Same contract as on
+     * `DashboardView`, so an embedded group behaves like a dashboard does.
+     */
+    readonly interaction?: WidgetInteractionContextValue;
     readonly children: ReactNode;
 }
 /**
@@ -12,5 +18,5 @@ export interface WidgetGroupProps {
  * `filters` context. Renders children in a responsive flex layout where
  * each child takes equal width.
  */
-export declare function WidgetGroup({ timeRange, filters, align, children }: WidgetGroupProps): import("react/jsx-runtime").JSX.Element;
+export declare function WidgetGroup({ timeRange, filters, align, interaction, children, }: WidgetGroupProps): import("react/jsx-runtime").JSX.Element;
 //# sourceMappingURL=WidgetGroup.d.ts.map

package/dist/dashboards/WidgetGroup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetGroup.d.ts","sourceRoot":"","sources":["../../src/dashboards/WidgetGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGlE,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AASD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,OAAuB,EAAE,KAAiB,EAAE,QAAQ,EAAE,EAAE,gBAAgB,2CAQhH"}
+{"version":3,"file":"WidgetGroup.d.ts","sourceRoot":"","sources":["../../src/dashboards/WidgetGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAA6B,KAAK,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAE3G,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,6BAA6B,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;CAC9B;AASD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,OAAuB,EACvB,KAAiB,EACjB,WAAW,EACX,QAAQ,GACT,EAAE,gBAAgB,2CAYlB"}

package/dist/dashboards/WidgetInteractionContext.d.ts

@@ -0,0 +1,31 @@
+/**
+ * What a widget can ask the page to do with one of its values.
+ *
+ * `filter` and `exclude` are the drill-down proper. The three navigation kinds
+ * exist because the widget cannot build those links itself: the library
+ * contributes routes but never owns them, so only the page knows its base path
+ * and, for `open-entity`, what a value even points at. The widget offers the
+ * affordance; the page decides what it means.
+ */
+export type WidgetInteractionKind = 'filter' | 'exclude' | 'view-logs' | 'view-traces' | 'open-entity';
+export interface WidgetInteraction {
+    readonly kind: WidgetInteractionKind;
+    /** Dimension the value belongs to, which is also its filter field. */
+    readonly field: string;
+    readonly value: string;
+    /** Human-readable form of `value`, when the data source resolved one. */
+    readonly label?: string;
+}
+export type WidgetInteractionHandler = (interaction: WidgetInteraction) => void;
+export interface WidgetInteractionContextValue {
+    readonly onInteract: WidgetInteractionHandler;
+    /**
+     * Whether the page can act on a kind for a given field. A widget offers only
+     * what the page answers for: an entry that silently does nothing is worse
+     * than no entry at all. Everything is offered when this is omitted.
+     */
+    readonly supports?: (kind: WidgetInteractionKind, field: string) => boolean;
+}
+export declare const WidgetInteractionProvider: import('react').Provider<WidgetInteractionContextValue | null>;
+export declare function useWidgetInteractionContext(): WidgetInteractionContextValue | null;
+//# sourceMappingURL=WidgetInteractionContext.d.ts.map

package/dist/dashboards/WidgetInteractionContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WidgetInteractionContext.d.ts","sourceRoot":"","sources":["../../src/dashboards/WidgetInteractionContext.tsx"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC;AAEvG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,WAAW,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAEhF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;CAC7E;AAUD,eAAO,MAAM,yBAAyB,gEAAoC,CAAC;AAE3E,wBAAgB,2BAA2B,IAAI,6BAA6B,GAAG,IAAI,CAElF"}

package/dist/dashboards/WidgetItem.d.ts

@@ -1,5 +1,5 @@
-import { BarWidget, BreakdownWidget, CartesianWidget, DoughnutWidget, FilterCondition, MetricGroupWidget, MetricWidget, TimeRange, Widget } from '../types/domain';
-import { BarWidgetData, BreakdownWidgetData, CartesianWidgetData, DoughnutWidgetData, MetricGroupWidgetData, MetricWidgetData } from './widget-data';
+import { BarWidget, BreakdownWidget, CartesianWidget, DoughnutWidget, FilterCondition, MetricGroupWidget, MetricWidget, TableWidget, TimeRange, Widget } from '../types/domain';
+import { BarWidgetData, BreakdownWidgetData, CartesianWidgetData, DoughnutWidgetData, MetricGroupWidgetData, MetricWidgetData, TableWidgetData } from './widget-data';
 interface WidgetItemBaseProps {
     readonly timeRange?: TimeRange;
     readonly filters?: readonly FilterCondition[];
@@ -32,11 +32,15 @@ interface WidgetItemManualBreakdownProps extends WidgetItemBaseProps {
     readonly widget: BreakdownWidget;
     readonly data: BreakdownWidgetData;
 }
+interface WidgetItemManualTableProps extends WidgetItemBaseProps {
+    readonly widget: TableWidget;
+    readonly data: TableWidgetData;
+}
 /**
  * Props for `WidgetItem`. The union ensures that when `data` is provided,
  * `data.type` is paired with the correct `widget` subtype at compile time.
  */
-export type WidgetItemProps = WidgetItemAutoProps | WidgetItemManualMetricProps | WidgetItemManualMetricGroupProps | WidgetItemManualCartesianProps | WidgetItemManualBarProps | WidgetItemManualDoughnutProps | WidgetItemManualBreakdownProps;
+export type WidgetItemProps = WidgetItemAutoProps | WidgetItemManualMetricProps | WidgetItemManualMetricGroupProps | WidgetItemManualCartesianProps | WidgetItemManualBarProps | WidgetItemManualDoughnutProps | WidgetItemManualBreakdownProps | WidgetItemManualTableProps;
 /**
  * Standalone widget that resolves a renderer from the widget registry.
  *

package/dist/dashboards/WidgetItem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WidgetItem.d.ts","sourceRoot":"","sources":["../../src/dashboards/WidgetItem.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,MAAM,EACP,MAAM,iBAAiB,CAAC;AAUzB,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAEjB,MAAM,eAAe,CAAC;AAKvB,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAED,UAAU,mBAAoB,SAAQ,mBAAmB;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;CAC3B;AAED,UAAU,2BAA4B,SAAQ,mBAAmB;IAC/D,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC;AAED,UAAU,gCAAiC,SAAQ,mBAAmB;IACpE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;CACtC;AAED,UAAU,8BAA+B,SAAQ,mBAAmB;IAClE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CACpC;AAED,UAAU,wBAAyB,SAAQ,mBAAmB;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,UAAU,6BAA8B,SAAQ,mBAAmB;IACjE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;CACnC;AAED,UAAU,8BAA+B,SAAQ,mBAAmB;IAClE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,mBAAmB,GACnB,2BAA2B,GAC3B,gCAAgC,GAChC,8BAA8B,GAC9B,wBAAwB,GACxB,6BAA6B,GAC7B,8BAA8B,CAAC;AAEnC;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,2CAMhD"}
+{"version":3,"file":"WidgetItem.d.ts","sourceRoot":"","sources":["../../src/dashboards/WidgetItem.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,WAAW,EACX,SAAS,EACT,MAAM,EACP,MAAM,iBAAiB,CAAC;AAazB,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,gBAAgB,EAChB,eAAe,EAEhB,MAAM,eAAe,CAAC;AAKvB,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CAC/C;AAED,UAAU,mBAAoB,SAAQ,mBAAmB;IACvD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC;CAC3B;AAED,UAAU,2BAA4B,SAAQ,mBAAmB;IAC/D,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC;AAED,UAAU,gCAAiC,SAAQ,mBAAmB;IACpE,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;CACtC;AAED,UAAU,8BAA+B,SAAQ,mBAAmB;IAClE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CACpC;AAED,UAAU,wBAAyB,SAAQ,mBAAmB;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;CAC9B;AAED,UAAU,6BAA8B,SAAQ,mBAAmB;IACjE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;CACnC;AAED,UAAU,8BAA+B,SAAQ,mBAAmB;IAClE,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;CACpC;AAED,UAAU,0BAA2B,SAAQ,mBAAmB;IAC9D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACvB,mBAAmB,GACnB,2BAA2B,GAC3B,gCAAgC,GAChC,8BAA8B,GAC9B,wBAAwB,GACxB,6BAA6B,GAC7B,8BAA8B,GAC9B,0BAA0B,CAAC;AAE/B;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,2CAMhD"}

package/dist/dashboards/analytics-table/AnalyticsTable.d.ts

@@ -0,0 +1,54 @@
+import { ChartState } from '@gravitee/graphene-charts';
+import { ReactNode } from 'react';
+import { TableRowMarker, TableSort } from '../../types/domain';
+import { AnalyticsTableRow, ResolvedTableColumn } from './analytics-table-model';
+import { RowColorResolver } from './row-color';
+/** Key of the synthetic totals row. Never a real dimension value. */
+export declare const TOTALS_ROW_KEY = "__totals__";
+export declare function isTotalsRow(row: AnalyticsTableRow): boolean;
+export interface AnalyticsTableProps {
+    readonly columns: readonly ResolvedTableColumn[];
+    readonly rows: readonly AnalyticsTableRow[];
+    /** Header of the label column, e.g. `API`. */
+    readonly dimensionLabel: string;
+    readonly state: ChartState;
+    /** Active sort when controlled; the initial sort otherwise. */
+    readonly sort: TableSort | undefined;
+    /**
+     * Makes the sort controlled. Left out — in manual mode, or in a story — the
+     * table sorts itself over the rows it was handed, which is the only thing it
+     * can do without a query to re-issue.
+     */
+    readonly onSortChange?: (sort: TableSort) => void;
+    /** Overall metric totals, keyed by column id. Also the share denominator. */
+    readonly totals?: Readonly<Record<string, number>>;
+    readonly showTotals?: boolean;
+    /** How many rows the response could not fill completely. */
+    readonly partialRows?: number;
+    /** Ceiling on the rows shown per page; the height decides the rest. */
+    readonly pageSize?: number;
+    readonly rowMarker?: TableRowMarker;
+    /** Colour of a row's swatch when the dimension has semantic colours. */
+    readonly rowColorFor?: RowColorResolver;
+    readonly onRowSelect?: (row: AnalyticsTableRow) => void;
+    /** Extra entries for the per-row menu. The menu only exists when this is set. */
+    readonly renderRowMenuItems?: (row: AnalyticsTableRow) => ReactNode;
+    /**
+     * Ranked-list rendering used when the widget is too narrow for even one value
+     * column. Supplied by the caller so the fallback is the real top-list
+     * presentation rather than a second implementation of it.
+     */
+    readonly renderTopList?: (sortColumn: ResolvedTableColumn) => ReactNode;
+    readonly emptyMessage?: ReactNode;
+}
+/**
+ * The table itself: sorting, paging, totals and degradation, over data someone
+ * else fetched.
+ *
+ * It measures its own body and adapts in discrete steps — compact numbers, then
+ * collapsed columns, then a top list, then an explicit "too small" state. It
+ * never scales and never scrolls: the widget lives in a box the grid clips, so
+ * anything that does not fit has to be decided about, not pushed out of view.
+ */
+export declare function AnalyticsTable({ columns, rows, dimensionLabel, state, sort, onSortChange, totals, showTotals, partialRows, pageSize, rowMarker, rowColorFor, onRowSelect, renderRowMenuItems, renderTopList, emptyMessage, }: AnalyticsTableProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=AnalyticsTable.d.ts.map

package/dist/dashboards/analytics-table/AnalyticsTable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsTable.d.ts","sourceRoot":"","sources":["../../../src/dashboards/analytics-table/AnalyticsTable.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAe5D,OAAO,EAAkC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvE,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACzB,MAAM,yBAAyB,CAAC;AAGjC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,qEAAqE;AACrE,eAAO,MAAM,cAAc,eAAe,CAAC;AAM3C,wBAAgB,WAAW,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAE3D;AAyGD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,8CAA8C;IAC9C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IACrC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IAClD,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,4DAA4D;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,wEAAwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACxD,iFAAiF;IACjF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,SAAS,CAAC;IACpE;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,SAAS,CAAC;IACxE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC;CACnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,EAC7B,OAAO,EACP,IAAI,EACJ,cAAc,EACd,KAAK,EACL,IAAI,EACJ,YAAY,EACZ,MAAM,EACN,UAAkB,EAClB,WAAe,EACf,QAAQ,EACR,SAAS,EACT,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,YAAyC,GAC1C,EAAE,mBAAmB,2CAgPrB"}

package/dist/dashboards/analytics-table/analytics-table-model.d.ts

@@ -0,0 +1,73 @@
+import { SortOrder, TableColumn, TableColumnFormat, TableSort, TableThreshold } from '../../types/domain';
+import { FacetBucket } from '../../types/responses';
+/**
+ * A column with every default resolved: the identity used for sorting and for
+ * the collapse plan, the label and unit taken from the metric catalog when the
+ * author did not override them, and the flags turned into plain booleans.
+ *
+ * Resolution happens at render time, never at save time, so a table follows the
+ * catalog as it is corrected or extended instead of freezing a copy of it into
+ * the dashboard (see OBS-73 / OBS-81).
+ */
+export interface ResolvedTableColumn {
+    readonly id: string;
+    readonly metric: string;
+    readonly measure: string;
+    readonly label: string;
+    readonly unit?: string;
+    readonly format: TableColumnFormat;
+    readonly thresholds: readonly TableThreshold[];
+    readonly share: boolean;
+    readonly pinned: boolean;
+}
+export interface AnalyticsTableRow {
+    /** Bucket key — the value a row click filters on. */
+    readonly key: string;
+    readonly label: string;
+    /**
+     * Column id to value. A missing entry is a cell the response did not carry,
+     * which renders as "—" rather than as a zero: the two mean different things
+     * and reading "0 errors" where the backend said nothing is a lie.
+     */
+    readonly values: Readonly<Record<string, number>>;
+}
+export interface AnalyticsTableModel {
+    readonly rows: readonly AnalyticsTableRow[];
+    /** Rows missing at least one column's value. */
+    readonly partialRows: number;
+}
+/** A column's identity is its metric/measure pair unless the author named it. */
+export declare function tableColumnId(column: TableColumn): string;
+export declare function resolveTableColumn(column: TableColumn): ResolvedTableColumn;
+export declare function resolveTableColumns(columns: readonly TableColumn[]): ResolvedTableColumn[];
+/**
+ * The sort the widget actually applies: the author's when it still names a
+ * column, otherwise the first column descending. A saved sort pointing at a
+ * column that has since been removed must not leave the table unordered.
+ */
+export declare function resolveTableSort(columns: readonly ResolvedTableColumn[], sort: TableSort | undefined): TableSort | undefined;
+/**
+ * Joins the buckets of several metrics into one row per dimension value.
+ *
+ * The row list — and its order — comes from the metric that carries the sort,
+ * because that is the only aggregation the backend ordered. Every other metric
+ * is looked up by key, and a key it does not carry leaves a hole: with one
+ * `terms` aggregation per metric, a sort on something other than a count lets
+ * the other aggregations return a different top-N. Holes are counted so the
+ * widget can say how much of the table is incomplete rather than passing off a
+ * partial join as a full one.
+ */
+export declare function buildTableModel(buckets: readonly FacetBucket[], columns: readonly ResolvedTableColumn[], sortMetric: string): AnalyticsTableModel;
+/**
+ * Denominator for a share column: the metric's overall total when totals were
+ * fetched, otherwise the sum of what is on screen. The two answer different
+ * questions ("share of all traffic" vs "share of the top N"), so which one is
+ * in play has to reach the cell — hence the flag rather than a bare number.
+ */
+export declare function resolveShareBase(column: ResolvedTableColumn, rows: readonly AnalyticsTableRow[], totals: Readonly<Record<string, number>> | undefined): {
+    readonly base: number;
+    readonly ofTotal: boolean;
+};
+/** Client-side ordering over the top-N the backend returned. */
+export declare function sortTableRows(rows: readonly AnalyticsTableRow[], columnId: string, order: SortOrder): AnalyticsTableRow[];
+//# sourceMappingURL=analytics-table-model.d.ts.map

package/dist/dashboards/analytics-table/analytics-table-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-table-model.d.ts","sourceRoot":"","sources":["../../../src/dashboards/analytics-table/analytics-table-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC/G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC5C,gDAAgD;IAChD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAEzD;AAaD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,CAc3E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,mBAAmB,EAAE,CAE1F;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,IAAI,EAAE,SAAS,GAAG,SAAS,GAC1B,SAAS,GAAG,SAAS,CAKvB;AAYD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,WAAW,EAAE,EAC/B,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,UAAU,EAAE,MAAM,GACjB,mBAAmB,CAmCrB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE,SAAS,iBAAiB,EAAE,EAClC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,GACnD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAKtD;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAC3B,IAAI,EAAE,SAAS,iBAAiB,EAAE,EAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,GACf,iBAAiB,EAAE,CAWrB"}

package/dist/dashboards/analytics-table/format-table-value.d.ts

@@ -0,0 +1,31 @@
+import { TableColumnFormat, TableThreshold, TableTierColor } from '../../types/domain';
+import { ResolvedTableColumn } from './analytics-table-model';
+import { TableDensity } from './plan-columns';
+/** What an absent cell reads as. Never a zero — see `AnalyticsTableRow.values`. */
+export declare const MISSING_CELL = "\u2014";
+export interface FormatTableValueOptions {
+    readonly format: TableColumnFormat;
+    readonly unit?: string;
+    /** Compact density switches plain numbers to `1.28M`. @default 'comfortable' */
+    readonly density?: TableDensity;
+}
+/**
+ * Formats one cell. The unit suffix is only appended to plain numbers: a
+ * percentage, a duration and a byte size all carry their own, and repeating it
+ * gives "2.3% %".
+ */
+export declare function formatTableValue(value: number, options: FormatTableValueOptions): string;
+/** Formats a cell of a resolved column, or the placeholder when it has no value. */
+export declare function formatColumnValue(value: number | undefined, column: ResolvedTableColumn, density: TableDensity): string;
+/**
+ * The colour a cell takes, or none. Thresholds are ordered rules and **the
+ * first one that matches wins**, the way conditional formatting works in
+ * Datadog, Metabase or a spreadsheet: the author's order is the priority, and
+ * a later rule never overrides an earlier one. Each rule is checked against
+ * what it asks for: the cell's value, or its share of the column total (a
+ * ratio here, a percentage in the rule).
+ */
+export declare function resolveThresholdColor(value: number | undefined, share: number | undefined, thresholds: readonly TableThreshold[]): TableTierColor | undefined;
+/** Design-system tokens, so both themes are covered without a theme branch. */
+export declare const THRESHOLD_TEXT_CLASS: Record<TableTierColor, string>;
+//# sourceMappingURL=format-table-value.d.ts.map

package/dist/dashboards/analytics-table/format-table-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-table-value.d.ts","sourceRoot":"","sources":["../../../src/dashboards/analytics-table/format-table-value.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAKnD,mFAAmF;AACnF,eAAO,MAAM,YAAY,WAAM,CAAC;AAuBhC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;CACjC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAkBxF;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,YAAY,GACpB,MAAM,CAOR;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,UAAU,EAAE,SAAS,cAAc,EAAE,GACpC,cAAc,GAAG,SAAS,CAU5B;AAED,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAI/D,CAAC"}

package/dist/dashboards/analytics-table/index.d.ts

@@ -0,0 +1,6 @@
+export { AnalyticsTable, TOTALS_ROW_KEY, isTotalsRow, type AnalyticsTableProps } from './AnalyticsTable';
+export { buildTableModel, resolveShareBase, resolveTableColumn, resolveTableColumns, resolveTableSort, sortTableRows, tableColumnId, type AnalyticsTableModel, type AnalyticsTableRow, type ResolvedTableColumn, } from './analytics-table-model';
+export { MISSING_CELL, formatColumnValue, formatTableValue, resolveThresholdColor, type FormatTableValueOptions, } from './format-table-value';
+export { planColumns, resolveRowsPerPage, type ColumnPlan, type PageSizePlan, type PlanColumnsOptions, type TableDensity, type TableLayoutMode, } from './plan-columns';
+export { buildTableMetrics, useAnalyticsTableQuery, type AnalyticsTableQueryResult, type UseAnalyticsTableQueryParams, } from './use-analytics-table-query';
+//# sourceMappingURL=index.d.ts.map

package/dist/dashboards/analytics-table/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dashboards/analytics-table/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACzG,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,qBAAqB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,WAAW,EACX,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,GAClC,MAAM,6BAA6B,CAAC"}