@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.3

package/dist/telemetry/headless/lib/explorerHandoff.d.ts

@@ -0,0 +1,62 @@
+/**
+ * The Telemetry Explorer's route (the `Telemetry Explorer` card's path).
+ *
+ * @stability experimental
+ */
+export declare const TELEMETRY_EXPLORER_PATH = "/admin/settings/telemetry/explorer";
+/**
+ * The Telemetry Dashboard's route (the `Telemetry Dashboard` card's path).
+ *
+ * @stability experimental
+ */
+export declare const TELEMETRY_DASHBOARD_PATH = "/admin/settings/telemetry/dashboard";
+/**
+ * The Telemetry settings page's route (the `Telemetry` card's path).
+ *
+ * @stability experimental
+ */
+export declare const TELEMETRY_SETTINGS_PATH = "/admin/settings/telemetry";
+/**
+ * The query parameter the explorer reads a handed statement from.
+ *
+ * @stability experimental
+ */
+export declare const EXPLORER_SQL_PARAM = "sql";
+/**
+ * The router state a page hands the explorer a statement in.
+ *
+ * @stability experimental
+ */
+export interface ExplorerHandoffState {
+    /** The statement to seed the editor with (never run on arrival). */
+    sql: string;
+}
+/**
+ * A statement the explorer would accept from a handoff, or `null`.
+ *
+ * @stability experimental
+ */
+export declare function acceptableHandoffSql(value: unknown): string | null;
+/**
+ * The `navigate()` arguments that open the explorer with `sql` in its editor.
+ *
+ * @stability experimental
+ */
+export declare function explorerHandoff(sql: string): {
+    to: string;
+    state: ExplorerHandoffState;
+};
+/**
+ * An explorer URL carrying `sql` as `?sql=` — for a link rather than a navigation.
+ *
+ * @stability experimental
+ */
+export declare function explorerSqlUrl(sql: string): string;
+/**
+ * The statement handed to the explorer on this navigation: `location.state.sql`
+ * first, then `?sql=`. `null` when there is none or it is not acceptable.
+ *
+ * @stability experimental
+ */
+export declare function readExplorerHandoff(state: unknown, params: URLSearchParams): string | null;
+//# sourceMappingURL=explorerHandoff.d.ts.map

package/dist/telemetry/headless/lib/explorerHandoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorerHandoff.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/explorerHandoff.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,uCAAuC,CAAC;AAC5E;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,wCAAwC,CAAC;AAC9E;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,8BAA8B,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AAExC;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAIlE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,oBAAoB,CAAA;CAAE,CAExF;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAI1F"}

package/dist/telemetry/headless/lib/explorerHandoff.js

@@ -0,0 +1,77 @@
+/**
+ * Handing a SQL statement to the Telemetry Explorer — issue #579, epic #576.
+ *
+ * The Telemetry Dashboard's "Open in Explorer" and "View trace" navigate to the
+ * explorer with the statement in the router's `location.state` (`{ sql }`).
+ * A plain link can carry it instead as `?sql=<URL-encoded>` — the fallback for
+ * a bookmark or a link pasted from elsewhere; `state` wins when both are set.
+ *
+ * The explorer puts a handed statement in its editor and NEVER runs it: the
+ * reader reviews it and presses Run. Anything empty, not a string, or longer
+ * than {@link TELEMETRY_SQL_MAX_LENGTH} (what the API would refuse anyway) is
+ * ignored, and the explorer opens as usual.
+ */
+import { TELEMETRY_SQL_MAX_LENGTH } from '../services/telemetry.js';
+/**
+ * The Telemetry Explorer's route (the `Telemetry Explorer` card's path).
+ *
+ * @stability experimental
+ */
+export const TELEMETRY_EXPLORER_PATH = '/admin/settings/telemetry/explorer';
+/**
+ * The Telemetry Dashboard's route (the `Telemetry Dashboard` card's path).
+ *
+ * @stability experimental
+ */
+export const TELEMETRY_DASHBOARD_PATH = '/admin/settings/telemetry/dashboard';
+/**
+ * The Telemetry settings page's route (the `Telemetry` card's path).
+ *
+ * @stability experimental
+ */
+export const TELEMETRY_SETTINGS_PATH = '/admin/settings/telemetry';
+/**
+ * The query parameter the explorer reads a handed statement from.
+ *
+ * @stability experimental
+ */
+export const EXPLORER_SQL_PARAM = 'sql';
+/**
+ * A statement the explorer would accept from a handoff, or `null`.
+ *
+ * @stability experimental
+ */
+export function acceptableHandoffSql(value) {
+    if (typeof value !== 'string')
+        return null;
+    if (value.trim() === '' || value.length > TELEMETRY_SQL_MAX_LENGTH)
+        return null;
+    return value;
+}
+/**
+ * The `navigate()` arguments that open the explorer with `sql` in its editor.
+ *
+ * @stability experimental
+ */
+export function explorerHandoff(sql) {
+    return { to: TELEMETRY_EXPLORER_PATH, state: { sql } };
+}
+/**
+ * An explorer URL carrying `sql` as `?sql=` — for a link rather than a navigation.
+ *
+ * @stability experimental
+ */
+export function explorerSqlUrl(sql) {
+    return `${TELEMETRY_EXPLORER_PATH}?${new URLSearchParams({ [EXPLORER_SQL_PARAM]: sql })}`;
+}
+/**
+ * The statement handed to the explorer on this navigation: `location.state.sql`
+ * first, then `?sql=`. `null` when there is none or it is not acceptable.
+ *
+ * @stability experimental
+ */
+export function readExplorerHandoff(state, params) {
+    const fromState = typeof state === 'object' && state !== null ? acceptableHandoffSql(state.sql) : null;
+    return fromState ?? acceptableHandoffSql(params.get(EXPLORER_SQL_PARAM));
+}
+//# sourceMappingURL=explorerHandoff.js.map

package/dist/telemetry/headless/lib/explorerHandoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorerHandoff.js","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/explorerHandoff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,oCAAoC,CAAC;AAC5E;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,qCAAqC,CAAC;AAC9E;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAEnE;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AAYxC;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,GAAG,wBAAwB;QAAE,OAAO,IAAI,CAAC;IAChF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,EAAE,EAAE,EAAE,uBAAuB,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC;AACzD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,OAAO,GAAG,uBAAuB,IAAI,IAAI,eAAe,CAAC,EAAE,CAAC,kBAAkB,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;AAC5F,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,MAAuB;IACzE,MAAM,SAAS,GACb,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAE,KAA2B,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9G,OAAO,SAAS,IAAI,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/telemetry/headless/lib/format.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Number, time and change formatting for the Telemetry Dashboard (#578).
+ * Pure functions, so the tiles and tables stay presentation-only.
+ */
+/**
+ * A tile value as a number, or `null` (`int8` may arrive as a string).
+ *
+ * @stability experimental
+ */
+export declare function toNumber(value: number | string | null | undefined): number | null;
+/**
+ * A duration in milliseconds at a readable scale: `8.5 ms`, `120 ms`, `1.25 s`.
+ *
+ * @param ms - the duration in milliseconds.
+ * @returns the value and its unit, separated by a space.
+ *
+ * @stability experimental
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * A byte count in binary units: `512 B`, `1.5 KB`, `3.2 GB`.
+ *
+ * @param bytes - the count.
+ * @returns the value and its unit, separated by a space.
+ *
+ * @stability experimental
+ */
+export declare function formatBytes(bytes: number): string;
+/**
+ * A duration in seconds at a readable scale: `42 s`, `12.5 min`, `3.2 h`,
+ * `4.1 d` — a queue age of 5400 s reads better as 1.5 h.
+ *
+ * @stability experimental
+ */
+export declare function formatSeconds(seconds: number): string;
+/**
+ * `value` and its unit, split so a tile can style them apart. Covers the
+ * summary's units (`req/min`, `%`, `ms`, `count`, `bytes`, `timestamp`) and
+ * every metric unit of `/metrics` (#601): `bytes/s`, `per_s`, `per_min`,
+ * `seconds`, `hours`, `days`, `cores`, `load`, `text` and `boolean`. An
+ * unknown unit is shown as given.
+ *
+ * @stability experimental
+ */
+export declare function formatTileValue(value: number | string | null, unit: string, now?: number): {
+    value: string;
+    unit: string;
+};
+/**
+ * A tile value or table cell as one string (`—` for nothing), e.g. `35.6%`, `1.2 GB`, `Yes`.
+ *
+ * @stability experimental
+ */
+export declare function formatMetricValue(value: number | string | boolean | null | undefined, unit: string, now?: number): string;
+/**
+ * "5s ago", "3m ago", "2h ago", "4d ago"; "just now" under a second.
+ *
+ * @stability experimental
+ */
+export declare function formatRelative(iso: string, now?: number): string;
+/**
+ * A readable absolute timestamp (local time, to the second).
+ *
+ * @stability experimental
+ */
+export declare function formatTimestamp(iso: string | null): string;
+/**
+ * A bucket's x-axis label: time of day, plus the date for multi-day spans.
+ *
+ * @stability experimental
+ */
+export declare function formatBucketLabel(iso: string, spanMs: number): string;
+/**
+ * Which direction is bad for a tile: up for errors and latency, none for
+ * traffic (more requests is neither good nor bad on its own).
+ *
+ * @stability experimental
+ */
+export type ChangeDirection = 'up-is-bad' | 'down-is-bad' | 'neutral';
+/**
+ * Whether a rising value is bad, good or neither for the tile `key`.
+ *
+ * @param key - the tile's key.
+ * @returns the tile's direction (`neutral` for an unknown key).
+ *
+ * @stability experimental
+ */
+export declare function tileDirection(key: string): ChangeDirection;
+/**
+ * A tile's change against the previous window of equal length.
+ *
+ * @stability experimental
+ */
+export interface TileChange {
+    /** Percent change, rounded; `null` when there is no comparable previous value. */
+    pct: number | null;
+    /** Which way the value moved. */
+    trend: 'up' | 'down' | 'flat';
+    /** How to colour it. */
+    tone: 'good' | 'bad' | 'neutral';
+}
+/**
+ * A tile's change against its previous value, toned by `direction`.
+ *
+ * @param value - the current value.
+ * @param previous - the previous window's value.
+ * @param direction - from {@link tileDirection}.
+ * @returns the change, its trend and its tone.
+ *
+ * @stability experimental
+ */
+export declare function tileChange(value: number | string | null, previous: number | string | null, direction: ChangeDirection): TileChange;
+//# sourceMappingURL=format.d.ts.map

package/dist/telemetry/headless/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIjF;AAKD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAGjD;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASjD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAOrD;AAOD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC7B,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAmB,GACvB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CA8CjC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EACnD,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAmB,GACvB,MAAM,CAQR;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAmB,GAAG,MAAM,CAW5E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAY1D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAQrE;AAED;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;AAuCtE;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAE1D;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,kFAAkF;IAClF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,iCAAiC;IACjC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9B,wBAAwB;IACxB,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAC7B,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAChC,SAAS,EAAE,eAAe,GACzB,UAAU,CAeZ"}

package/dist/telemetry/headless/lib/format.js

@@ -0,0 +1,280 @@
+/**
+ * Number, time and change formatting for the Telemetry Dashboard (#578).
+ * Pure functions, so the tiles and tables stay presentation-only.
+ */
+/**
+ * A tile value as a number, or `null` (`int8` may arrive as a string).
+ *
+ * @stability experimental
+ */
+export function toNumber(value) {
+    if (value === null || value === undefined || value === '')
+        return null;
+    const n = typeof value === 'number' ? value : Number(value);
+    return Number.isFinite(n) ? n : null;
+}
+const compact = (n, digits = 1) => n.toLocaleString(undefined, { maximumFractionDigits: digits });
+/**
+ * A duration in milliseconds at a readable scale: `8.5 ms`, `120 ms`, `1.25 s`.
+ *
+ * @param ms - the duration in milliseconds.
+ * @returns the value and its unit, separated by a space.
+ *
+ * @stability experimental
+ */
+export function formatDuration(ms) {
+    if (ms >= 1000)
+        return `${compact(ms / 1000, 2)} s`;
+    return `${compact(ms, ms < 10 ? 1 : 0)} ms`;
+}
+/**
+ * A byte count in binary units: `512 B`, `1.5 KB`, `3.2 GB`.
+ *
+ * @param bytes - the count.
+ * @returns the value and its unit, separated by a space.
+ *
+ * @stability experimental
+ */
+export function formatBytes(bytes) {
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    let value = bytes;
+    let unit = 0;
+    while (Math.abs(value) >= 1024 && unit < units.length - 1) {
+        value /= 1024;
+        unit += 1;
+    }
+    return `${compact(value, unit === 0 ? 0 : 1)} ${units[unit]}`;
+}
+/**
+ * A duration in seconds at a readable scale: `42 s`, `12.5 min`, `3.2 h`,
+ * `4.1 d` — a queue age of 5400 s reads better as 1.5 h.
+ *
+ * @stability experimental
+ */
+export function formatSeconds(seconds) {
+    const abs = Math.abs(seconds);
+    if (abs < 1)
+        return `${compact(seconds * 1000, 0)} ms`;
+    if (abs < 60)
+        return `${compact(seconds, abs < 10 ? 2 : 1)} s`;
+    if (abs < 3600)
+        return `${compact(seconds / 60, 1)} min`;
+    if (abs < 48 * 3600)
+        return `${compact(seconds / 3600, 1)} h`;
+    return `${compact(seconds / 86_400, 1)} d`;
+}
+function split(text) {
+    const at = text.indexOf(' ');
+    return at < 0 ? { value: text, unit: '' } : { value: text.slice(0, at), unit: text.slice(at + 1) };
+}
+/**
+ * `value` and its unit, split so a tile can style them apart. Covers the
+ * summary's units (`req/min`, `%`, `ms`, `count`, `bytes`, `timestamp`) and
+ * every metric unit of `/metrics` (#601): `bytes/s`, `per_s`, `per_min`,
+ * `seconds`, `hours`, `days`, `cores`, `load`, `text` and `boolean`. An
+ * unknown unit is shown as given.
+ *
+ * @stability experimental
+ */
+export function formatTileValue(value, unit, now = Date.now()) {
+    if (unit === 'timestamp') {
+        if (typeof value !== 'string' || !Number.isFinite(Date.parse(value)))
+            return { value: '—', unit: '' };
+        return { value: formatRelative(value, now), unit: '' };
+    }
+    if (unit === 'text') {
+        return value === null || value === '' ? { value: '—', unit: '' } : { value: String(value), unit: '' };
+    }
+    const n = toNumber(value);
+    if (n === null)
+        return { value: '—', unit: '' };
+    switch (unit) {
+        case '%':
+            return { value: compact(n, 2), unit: '%' };
+        case 'ms': {
+            const [amount, suffix] = formatDuration(n).split(' ');
+            return { value: amount, unit: suffix };
+        }
+        case 'bytes': {
+            const [amount, suffix] = formatBytes(n).split(' ');
+            return { value: amount, unit: suffix };
+        }
+        case 'count':
+            return { value: Math.round(n).toLocaleString(), unit: '' };
+        case 'bytes/s': {
+            const [amount, suffix] = formatBytes(n).split(' ');
+            return { value: amount, unit: `${suffix}/s` };
+        }
+        case 'per_s':
+            return { value: compact(n, 2), unit: '/s' };
+        case 'per_min':
+            return { value: compact(n, 2), unit: '/min' };
+        case 'seconds':
+            return split(formatSeconds(n));
+        case 'hours':
+            return n >= 48 ? { value: compact(n / 24, 1), unit: 'd' } : { value: compact(n, 1), unit: 'h' };
+        case 'days':
+            return { value: compact(n, 1), unit: Math.abs(n) === 1 ? 'day' : 'days' };
+        case 'cores':
+            return { value: compact(n, 2), unit: Math.abs(n) === 1 ? 'core' : 'cores' };
+        case 'load':
+            return { value: compact(n, 2), unit: '' };
+        case 'boolean':
+            return { value: n >= 1 ? 'Yes' : 'No', unit: '' };
+        default:
+            return { value: compact(n, 2), unit };
+    }
+}
+/**
+ * A tile value or table cell as one string (`—` for nothing), e.g. `35.6%`, `1.2 GB`, `Yes`.
+ *
+ * @stability experimental
+ */
+export function formatMetricValue(value, unit, now = Date.now()) {
+    if (value === undefined || value === null)
+        return '—';
+    if (typeof value === 'boolean')
+        return value ? 'Yes' : 'No';
+    const formatted = formatTileValue(value, unit, now);
+    if (!formatted.unit)
+        return formatted.value;
+    return formatted.unit === '%' || formatted.unit.startsWith('/')
+        ? `${formatted.value}${formatted.unit}`
+        : `${formatted.value} ${formatted.unit}`;
+}
+/**
+ * "5s ago", "3m ago", "2h ago", "4d ago"; "just now" under a second.
+ *
+ * @stability experimental
+ */
+export function formatRelative(iso, now = Date.now()) {
+    const then = Date.parse(iso);
+    if (!Number.isFinite(then))
+        return '—';
+    const seconds = Math.max(0, Math.round((now - then) / 1000));
+    if (seconds < 1)
+        return 'just now';
+    if (seconds < 60)
+        return `${seconds}s ago`;
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60)
+        return `${minutes}m ago`;
+    const hours = Math.floor(minutes / 60);
+    if (hours < 48)
+        return `${hours}h ago`;
+    return `${Math.floor(hours / 24)}d ago`;
+}
+/**
+ * A readable absolute timestamp (local time, to the second).
+ *
+ * @stability experimental
+ */
+export function formatTimestamp(iso) {
+    if (!iso)
+        return '—';
+    const then = Date.parse(iso);
+    if (!Number.isFinite(then))
+        return iso;
+    return new Date(then).toLocaleString(undefined, {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+    });
+}
+/**
+ * A bucket's x-axis label: time of day, plus the date for multi-day spans.
+ *
+ * @stability experimental
+ */
+export function formatBucketLabel(iso, spanMs) {
+    const then = Date.parse(iso);
+    if (!Number.isFinite(then))
+        return iso;
+    const date = new Date(then);
+    if (spanMs > 24 * 60 * 60_000) {
+        return date.toLocaleString(undefined, { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' });
+    }
+    return date.toLocaleTimeString(undefined, { hour: '2-digit', minute: '2-digit' });
+}
+const TILE_DIRECTIONS = {
+    requestsPerMin: 'neutral',
+    errorRatePct: 'up-is-bad',
+    p95Ms: 'up-is-bad',
+    errorLogs: 'up-is-bad',
+    warnLogs: 'up-is-bad',
+    unknownRoutes: 'up-is-bad',
+    heapUsedBytes: 'up-is-bad',
+    eventLoopDelayP99Ms: 'up-is-bad',
+    // `/metrics` tiles (#601): utilization, ages, failures and stalls up is bad;
+    // headroom (cache hits, healthy nodes, certificate days) down is bad.
+    cpuUtilization: 'up-is-bad',
+    memoryUtilization: 'up-is-bad',
+    load1m: 'up-is-bad',
+    filesystemUtilization: 'up-is-bad',
+    dbConnectionUtilization: 'up-is-bad',
+    dbCacheHitRatio: 'down-is-bad',
+    dbRollbacks: 'up-is-bad',
+    dbDeadlocks: 'up-is-bad',
+    'queueDepth.pending': 'up-is-bad',
+    oldestPendingAge: 'up-is-bad',
+    jobFailureRatio: 'up-is-bad',
+    jobDurationP95: 'up-is-bad',
+    backupAge: 'up-is-bad',
+    'nodesByHealth.healthy': 'down-is-bad',
+    'nodesByHealth.stale': 'up-is-bad',
+    'nodesByHealth.offline': 'up-is-bad',
+    noEligibleNode: 'up-is-bad',
+    httpDuration: 'up-is-bad',
+    tlsDaysLeft: 'down-is-bad',
+    exporterFailed: 'up-is-bad',
+    exporterQueueUtilization: 'up-is-bad',
+    receiverRefused: 'up-is-bad',
+    greptimeWriteStalls: 'up-is-bad',
+    scrapeTargetsDown: 'up-is-bad',
+};
+/**
+ * Whether a rising value is bad, good or neither for the tile `key`.
+ *
+ * @param key - the tile's key.
+ * @returns the tile's direction (`neutral` for an unknown key).
+ *
+ * @stability experimental
+ */
+export function tileDirection(key) {
+    return TILE_DIRECTIONS[key] ?? 'neutral';
+}
+/**
+ * A tile's change against its previous value, toned by `direction`.
+ *
+ * @param value - the current value.
+ * @param previous - the previous window's value.
+ * @param direction - from {@link tileDirection}.
+ * @returns the change, its trend and its tone.
+ *
+ * @stability experimental
+ */
+export function tileChange(value, previous, direction) {
+    const current = toNumber(value);
+    const before = toNumber(previous);
+    if (current === null || before === null)
+        return { pct: null, trend: 'flat', tone: 'neutral' };
+    if (before === 0) {
+        if (current === 0)
+            return { pct: 0, trend: 'flat', tone: 'neutral' };
+        return { pct: null, trend: 'up', tone: direction === 'up-is-bad' ? 'bad' : direction === 'down-is-bad' ? 'good' : 'neutral' };
+    }
+    const pct = Math.round(((current - before) / Math.abs(before)) * 1000) / 10;
+    if (pct === 0)
+        return { pct: 0, trend: 'flat', tone: 'neutral' };
+    const trend = pct > 0 ? 'up' : 'down';
+    let tone = 'neutral';
+    if (direction === 'up-is-bad')
+        tone = trend === 'up' ? 'bad' : 'good';
+    if (direction === 'down-is-bad')
+        tone = trend === 'down' ? 'bad' : 'good';
+    return { pct, trend, tone };
+}
+//# sourceMappingURL=format.js.map

package/dist/telemetry/headless/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../../../src/telemetry/headless/lib/format.ts"],"names":[],"mappings":"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"}

package/dist/telemetry/headless/lib/metrics/metricSections.d.ts

@@ -0,0 +1,44 @@
+/**
+ * The Telemetry Dashboard's infrastructure sections — issue #602, epic #576.
+ *
+ * One section per `/metrics` group (#601). WHICH sections, their titles and
+ * their order come from the API's `GET …/metric-groups` (#680,
+ * `DashboardMetricGroupMeta`), so a group an application registers renders
+ * without a web change. This file keeps the anchor a verdict reason links to,
+ * and which reason belongs to which section, read off the wording of the API's
+ * infrastructure verdict rules (`telemetry-dashboard.verdict.ts`,
+ * docs/specs/telemetry.md §11.7); a reason no pattern matches (the traffic
+ * rules, "no data", an app group) simply gets no link.
+ */
+import type { DashboardMetricGroup, DashboardMetricGroupMeta } from '../../services/telemetryDashboard.js';
+/** A section's metadata: one `/metric-groups` entry. */
+export type MetricSectionMeta = DashboardMetricGroupMeta;
+/**
+ * Fallback titles for two platform groups whose dashboard title is not their
+ * id, used only while (or when) the API's group metadata does not list the
+ * group. The metadata always wins: an app group (EvoPath's `coach`) is titled
+ * from it with no entry here.
+ *
+ * @stability experimental
+ */
+export declare const METRIC_SECTION_TITLES: Readonly<Partial<Record<DashboardMetricGroup, string>>>;
+/**
+ * The section title the API gives `group`; else {@link METRIC_SECTION_TITLES};
+ * else the id itself.
+ *
+ * @param group - the metric group id.
+ * @param groups - the API's group metadata (`GET …/metric-groups`).
+ * @returns the title to show.
+ *
+ * @stability experimental
+ */
+export declare function metricSectionTitle(group: DashboardMetricGroup, groups?: readonly Pick<DashboardMetricGroupMeta, 'id' | 'title'>[]): string;
+/** The DOM id of a section's anchor (the verdict banner scrolls to it). */
+export declare function metricSectionAnchor(group: DashboardMetricGroup): string;
+/** The section's `DashboardPanel` id (tests, and the ⋮ menu focus return). */
+export declare function metricPanelId(group: DashboardMetricGroup): string;
+/** The section a verdict reason is about, or null for the traffic and no-data rules. */
+export declare function verdictReasonGroup(reason: string): DashboardMetricGroup | null;
+/** Scroll a section into view and move focus to it (its region is focusable for this). */
+export declare function scrollToMetricSection(group: DashboardMetricGroup): void;
+//# sourceMappingURL=metricSections.d.ts.map

package/dist/telemetry/headless/lib/metrics/metricSections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricSections.d.ts","sourceRoot":"","sources":["../../../../../src/telemetry/headless/lib/metrics/metricSections.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC;AAE3G,wDAAwD;AACxD,MAAM,MAAM,iBAAiB,GAAG,wBAAwB,CAAC;AAEzD;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC,CAGxF,CAAC;AAEH;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,oBAAoB,EAC3B,MAAM,GAAE,SAAS,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,OAAO,CAAC,EAAO,GACrE,MAAM,CAER;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEvE;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CAEjE;AAeD,wFAAwF;AACxF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,GAAG,IAAI,CAG9E;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAKvE"}