@gravitee/gamma-lib-observability 3.1.1 → 3.2.0

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/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.
 
 ---
 

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"}

package/dist/dashboards/analytics-table/plan-columns.d.ts

@@ -0,0 +1,102 @@
+import { TableRowMarker } from '../../types/domain';
+import { ResolvedTableColumn } from './analytics-table-model';
+/**
+ * Intrinsic minimum widths, in pixels, for each kind of cell. They are what the
+ * content needs to stay readable, not a share of the widget: an API name needs
+ * room for more than an ellipsis, and a number needs room for its unit.
+ */
+export declare const LABEL_COLUMN_MIN_WIDTH = 140;
+export declare const VALUE_COLUMN_MIN_WIDTH = 88;
+/** A value column drawing a share bar next to its number. */
+export declare const SHARE_COLUMN_MIN_WIDTH = 120;
+export declare const ROW_MENU_WIDTH = 28;
+/** Room the row marker takes in front of the label, gap included. */
+export declare const ROW_MARKER_WIDTH: Readonly<Record<TableRowMarker, number>>;
+/**
+ * Below either of these nothing legible fits at all, so the widget says so
+ * instead of drawing a table nobody can read — the same call `MetricGroup`
+ * makes with its own emergency threshold.
+ */
+export declare const EMERGENCY_WIDTH = 180;
+export declare const EMERGENCY_HEIGHT = 90;
+export declare const TABLE_ROW_HEIGHT = 36;
+export declare const TABLE_HEADER_HEIGHT = 40;
+export declare const TABLE_PAGINATION_HEIGHT = 36;
+export type TableDensity = 'comfortable' | 'compact';
+/**
+ * - `table` — the visualization the author asked for, possibly with columns
+ *   collapsed away.
+ * - `top-list` — not even one value column fits next to the labels, so the
+ *   widget falls back to the ranked-list presentation on the sort column.
+ * - `emergency` — too small for either.
+ */
+export type TableLayoutMode = 'table' | 'top-list' | 'emergency';
+export interface ColumnPlan {
+    readonly mode: TableLayoutMode;
+    readonly density: TableDensity;
+    /** Column ids to render, in author order. */
+    readonly visible: readonly string[];
+    /** Column ids collapsed away, in author order. */
+    readonly hidden: readonly string[];
+    /**
+     * Pixels left to the label column once the visible value columns and the
+     * row menu have taken theirs, marker included. The table caps the labels at
+     * this so a long value truncates instead of widening its column: table
+     * layout gives a cell what its text asks for, and one long label would push
+     * the last value column out of the widget. Zero outside `table` mode.
+     */
+    readonly labelWidth: number;
+}
+export interface PlanColumnsOptions {
+    readonly width: number;
+    readonly height: number;
+    readonly columns: readonly ResolvedTableColumn[];
+    /** The column ordering the rows. Never collapsed while a table is rendered. */
+    readonly sortColumnId: string | undefined;
+    /** Reserves room for the per-row actions button. @default false */
+    readonly hasRowMenu?: boolean;
+    /** Header of the label column, so a long dimension name is budgeted for. */
+    readonly labelHeader?: string;
+    readonly rowMarker?: TableRowMarker;
+}
+/**
+ * Room a header needs to stay on one line. An estimate, not a measurement:
+ * the plan runs before anything is laid out, and a per-character average is
+ * within a few pixels of the truth for the labels a catalog produces. Without
+ * it a column budgeted at its numeric minimum would be handed a header wider
+ * than that, and the table layout would take the missing pixels from a
+ * neighbour — folding "300 req 99%" onto two lines while the plan swears
+ * everything fits.
+ */
+export declare function estimateHeaderWidth(label: string): number;
+/**
+ * Decides which columns fit the measured width, and how tightly they draw.
+ *
+ * Pure, and separate from the component, because it is the whole of the
+ * degradation contract: hide in reverse author order, keep the label, the sort
+ * column and the pinned ones, fall back to a top list rather than clip. A
+ * pinned column is dropped only when the alternative is losing the table
+ * altogether — pinning asks for priority, and priority cannot conjure pixels.
+ */
+export declare function planColumns({ width, height, columns, sortColumnId, hasRowMenu, labelHeader, rowMarker, }: PlanColumnsOptions): ColumnPlan;
+export interface PageSizePlan {
+    readonly rowsPerPage: number;
+    readonly paginated: boolean;
+}
+/**
+ * Rows per page derived from the height that is actually available, capped by
+ * the author's `pageSize`.
+ *
+ * Derived rather than fixed because the widget must never clip: a table asked
+ * for ten rows in a box that holds four has to show four and page, not four and
+ * a half. The author's number is therefore a ceiling — it can ask for fewer
+ * rows than fit, never for more.
+ *
+ * Two passes, because the pagination bar only exists if there is something to
+ * page through, and it costs a row's worth of height when it does.
+ */
+export declare function resolveRowsPerPage(height: number, totalRows: number, options?: {
+    readonly showTotals?: boolean;
+    readonly pageSize?: number;
+}): PageSizePlan;
+//# sourceMappingURL=plan-columns.d.ts.map

package/dist/dashboards/analytics-table/plan-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-columns.d.ts","sourceRoot":"","sources":["../../../src/dashboards/analytics-table/plan-columns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,sBAAsB,KAAK,CAAC;AACzC,6DAA6D;AAC7D,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAA6B,CAAC;AAEpG;;;;GAIG;AACH,eAAO,MAAM,eAAe,MAAM,CAAC;AACnC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;;;;OAMG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;CACrC;AAOD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEzD;AAOD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,MAAM,EACN,OAAO,EACP,YAAY,EACZ,UAAkB,EAClB,WAAgB,EAChB,SAAS,GACV,EAAE,kBAAkB,GAAG,UAAU,CAsDjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1E,YAAY,CASd"}

package/dist/dashboards/analytics-table/row-color.d.ts

@@ -0,0 +1,11 @@
+import { AnalyticsTableRow } from './analytics-table-model';
+/** CSS colour for a row's swatch, or `undefined` to let the index palette decide. */
+export type RowColorResolver = (row: AnalyticsTableRow) => string | undefined;
+/**
+ * Rows of a status dimension keep their semantic colours (2XX green, 5XX red),
+ * the same `status-palette` every other widget applies to that dimension, so a
+ * table and a bar chart of the same values never disagree. Any other dimension
+ * gets no resolver: its rows follow the index palette, like the top list.
+ */
+export declare function rowColorResolver(dimension: string | undefined): RowColorResolver | undefined;
+//# sourceMappingURL=row-color.d.ts.map

package/dist/dashboards/analytics-table/row-color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"row-color.d.ts","sourceRoot":"","sources":["../../../src/dashboards/analytics-table/row-color.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,iBAAiB,KAAK,MAAM,GAAG,SAAS,CAAC;AAE9E;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAG5F"}