@marinoscar/platform-web 0.1.0-next.3 → 0.1.0-next.4

package/dist/telemetry/ui/components/dashboard/panels/builtinPanelViews.js

@@ -0,0 +1,59 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * The platform's own dashboard panels, `api` and `logs`, as views (PP-14.18).
+ *
+ * Each is the JSX the dashboard page used to hold inline, moved here unchanged:
+ * a `DashboardPanel` frame around the timeline chart, with the panel's own data
+ * hook, its "Open in Explorer" / "Ask assistant" actions from the page's
+ * `host` and its empty message. They register through the same
+ * `registerPlatformDashboardPanelView` an app's view uses, so the dashboard
+ * draws its two headline panels the way it draws any panel.
+ */
+import { useMemo } from 'react';
+import { useDashboardTimeseries } from '../../../../headless/hooks/useTelemetryDashboard.js';
+import { ApiTimelineChart } from '../ApiTimelineChart.js';
+import { DashboardPanel } from '../DashboardPanel.js';
+import { LogSeverityChart } from '../LogSeverityChart.js';
+import { SeverityChips } from '../severity.js';
+import { timelineHeight } from '../timelineAxis.js';
+import { getDashboardPanelView, registerPlatformDashboardPanelView, } from './dashboardPanelViews.js';
+/** Zoom gestures per layout: drag on desktop, drag or tap on tablet, tap on phones. */
+const ZOOM_MODES = {
+    desktop: { drag: true, tap: false },
+    tablet: { drag: true, tap: true },
+    phone: { drag: false, tap: true },
+};
+/** Whether any bucket holds a record of a selected band (`other` rides with `info`). */
+function hasSelectedLogs(buckets, sev) {
+    return buckets.some((bucket) => (sev.includes('error') && bucket.error > 0) ||
+        (sev.includes('warn') && bucket.warn > 0) ||
+        (sev.includes('info') && bucket.info + bucket.other > 0));
+}
+/** The platform's `api` panel: requests per bucket by status class, and p95. */
+export function ApiPanelView({ query, tick, layout, spanMs, host }) {
+    const series = useDashboardTimeseries('api', query, tick);
+    const isPhone = layout === 'phone';
+    return (_jsx(DashboardPanel, { id: "panel-api", title: "API requests", actions: host.actionsFor('panel-api', series.data?.sql, series.data ? { kind: 'api', title: 'API requests', buckets: series.data.buckets } : null), sql: series.data?.sql, isLoading: series.isLoading, isRefreshing: series.isRefreshing, error: series.error, onRetry: series.reload, isEmpty: !!series.data && series.data.buckets.length === 0, emptyMessage: "No requests in this window.", skeletonHeight: timelineHeight(layout), children: series.data && (_jsx(ApiTimelineChart, { buckets: series.data.buckets, height: timelineHeight(layout), spanMs: spanMs, compact: isPhone, zoom: ZOOM_MODES[layout], onZoomBuckets: host.zoomTo(series.data.buckets.map((bucket) => bucket.t), series.data.range.bucketSeconds) })) }));
+}
+/** The platform's `logs` panel: log records per bucket by severity, with the severity filter. */
+export function LogsPanelView({ query, tick, layout, spanMs, host }) {
+    const series = useDashboardTimeseries('logs', query, tick);
+    const isPhone = layout === 'phone';
+    const { state, update } = host;
+    const headerExtra = useMemo(() => (_jsx(SeverityChips, { value: state.sev, onChange: (sev) => update({ sev }), large: isPhone, label: "Log severity filter" })), [state.sev, update, isPhone]);
+    return (_jsx(DashboardPanel, { id: "panel-logs", title: "Log severity", headerExtra: headerExtra, actions: host.actionsFor('panel-logs', series.data?.sql, series.data
+            ? { kind: 'logs', title: 'Log severity', buckets: series.data.buckets, severities: state.sev }
+            : null), sql: series.data?.sql, isLoading: series.isLoading, isRefreshing: series.isRefreshing, error: series.error, onRetry: series.reload, isEmpty: !!series.data && !hasSelectedLogs(series.data.buckets, state.sev), emptyMessage: "No log records of the selected severities in this window.", skeletonHeight: timelineHeight(layout), children: series.data && (_jsx(LogSeverityChart, { buckets: series.data.buckets, severities: state.sev, height: timelineHeight(layout), spanMs: spanMs, compact: isPhone, zoom: ZOOM_MODES[layout], onZoomBuckets: host.zoomTo(series.data.buckets.map((bucket) => bucket.t), series.data.range.bucketSeconds) })) }));
+}
+/**
+ * Registers the `api` and `logs` views, once. The dashboard page calls it at
+ * module scope (a bare import for the side effect would be dropped by a
+ * bundler that honours `sideEffects: false`).
+ */
+export function registerPlatformDashboardPanelViews() {
+    if (!getDashboardPanelView('api'))
+        registerPlatformDashboardPanelView('api', ApiPanelView);
+    if (!getDashboardPanelView('logs'))
+        registerPlatformDashboardPanelView('logs', LogsPanelView);
+}
+//# sourceMappingURL=builtinPanelViews.js.map

package/dist/telemetry/ui/components/dashboard/panels/builtinPanelViews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtinPanelViews.js","sourceRoot":"","sources":["../../../../../../src/telemetry/ui/components/dashboard/panels/builtinPanelViews.tsx"],"names":[],"mappings":"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"}

package/dist/telemetry/ui/components/dashboard/panels/dashboardPanelViews.d.ts

@@ -0,0 +1,155 @@
+/**
+ * The dashboard-panel view registry (PP-14.18).
+ *
+ * A dashboard panel has two halves, joined by its id: the API registers
+ * `registerDashboardPanel({ id, label, order, data })` and serves the panel's
+ * payload at `GET …/dashboard/panels/:id`; the web registers the VIEW that draws
+ * that payload, here, with `registerDashboardPanelView(id, View)`. The platform's
+ * own `api` and `logs` panels are views registered through the same function
+ * (`registerPlatformDashboardPanelViews`), which draw their own frame and read
+ * their own data.
+ *
+ * The dashboard draws, in `order`, the app's panels the API lists that have a
+ * view registered here; a listed panel with no view is skipped, a view whose
+ * panel the API does not list is never drawn.
+ *
+ * Register at import time, from a file the app's entry loads (the registry is a
+ * module-level map: the app's registration and the dashboard page share one
+ * instance because they import this one module).
+ */
+import type { ComponentType } from 'react';
+import type { DashboardState } from '../../../../headless/lib/dashboardState.js';
+import type { AssistantPanelContext } from '../../../../headless/lib/dashboard/assistantPrompt.js';
+import type { DashboardPanelMeta, DashboardQuery } from '../../../../headless/services/telemetryDashboard.js';
+import type { DashboardLayout } from '../DashboardFilterBar.js';
+import type { PanelAction } from '../DashboardPanel.js';
+/**
+ * What the dashboard page offers a panel view: the page's own state and the
+ * header actions it gives every panel ("Ask assistant", "Open in Explorer").
+ * Read-only data and callbacks; no API client.
+ *
+ * @stability experimental
+ */
+export interface DashboardPanelHost {
+    /** The dashboard's URL state: range, filters, severities, refresh. */
+    readonly state: DashboardState;
+    /** Changes the dashboard's URL state (zoom to a window, change the severities). */
+    update(patch: Partial<DashboardState>): void;
+    /**
+     * The header actions the page gives a panel: "Ask assistant" (when the
+     * assistant is available) and "Open in Explorer" with the panel's `sql`.
+     *
+     * @param panelId - the panel's DOM test id (`panel-signups`).
+     * @param sql - the statement(s) the panel ran, primary first.
+     * @param context - what "Ask assistant" describes, or `null`.
+     * @internal Used by the platform's own panels; a view that wants the frame's actions returns a `sql` in its payload instead.
+     */
+    actionsFor(panelId: string, sql: string | string[] | undefined, context: AssistantPanelContext | null): PanelAction[];
+    /**
+     * A chart-zoom handler: the window the buckets from `first` to `last` span
+     * becomes the dashboard's window.
+     *
+     * @param starts - the buckets' start instants.
+     * @param bucketSeconds - the bucket size.
+     */
+    zoomTo(starts: string[], bucketSeconds: number): (first: number, last: number) => void;
+}
+/**
+ * What a panel view receives.
+ *
+ * @typeParam Payload - the shape the app's API panel returns (agreed between the two).
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export interface DashboardPanelViewProps<Payload = unknown> {
+    /** The panel as the API lists it. */
+    panel: DashboardPanelMeta;
+    /** The payload the API returned for the dashboard's window (`frame: 'page'`); `undefined` for a view that draws its own frame and reads its own data. */
+    payload: Payload;
+    /** The window and filters the dashboard asks every panel for (the series query: 30 buckets on a phone). */
+    query: DashboardQuery;
+    /** The dashboard's refresh counter: a view that fetches for itself refetches when it changes. */
+    tick: number;
+    /** Phone, tablet or desktop, decided by the page. */
+    layout: DashboardLayout;
+    /** The window's length in milliseconds. */
+    spanMs: number;
+    /** The page's state and header actions. */
+    host: DashboardPanelHost;
+}
+/**
+ * How a view is registered.
+ *
+ * @stability experimental
+ */
+export interface DashboardPanelViewOptions {
+    /**
+     * Who draws the panel's frame (title, loading skeleton, error with Retry,
+     * header actions). `page` (the default): the dashboard does, and the view
+     * draws only the payload. `self`: the view draws everything, including its own
+     * `DashboardPanel`, and reads its own data (the platform's `api` and `logs`).
+     */
+    frame?: 'page' | 'self';
+}
+/**
+ * A registered view.
+ *
+ * @stability experimental
+ */
+export interface RegisteredDashboardPanelView {
+    /** The panel id. */
+    readonly id: string;
+    /** The component. */
+    readonly View: ComponentType<DashboardPanelViewProps<never>>;
+    /** Who draws the frame. */
+    readonly frame: 'page' | 'self';
+    /** Whether the platform registered it (`api`, `logs`). */
+    readonly builtin: boolean;
+}
+/**
+ * Registers the view that draws the dashboard panel `id`. The API half is
+ * `registerDashboardPanel` (`@marinoscar/platform-api/telemetry`).
+ *
+ * @typeParam Payload - the shape of the payload the API panel returns.
+ * @param id - the panel id (the API registers the same one).
+ * @param View - the component; it receives {@link DashboardPanelViewProps}.
+ * @param options - who draws the frame.
+ * @throws Error when `id` is malformed, or another view is already registered for it.
+ *
+ * @example
+ * ```tsx
+ * registerDashboardPanelView<{ total: number }>('signups', ({ payload }) => <Typography>{payload.total} sign-ups</Typography>);
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function registerDashboardPanelView<Payload = unknown>(id: string, View: ComponentType<DashboardPanelViewProps<Payload>>, options?: DashboardPanelViewOptions): void;
+/**
+ * Registers one of the platform's own panel views. Not part of the public
+ * surface (the `ui` index does not export it); the dashboard page calls
+ * `registerPlatformDashboardPanelViews`, which uses it.
+ */
+export declare function registerPlatformDashboardPanelView(id: string, View: ComponentType<DashboardPanelViewProps<never>>): void;
+/**
+ * The view registered for `id`.
+ *
+ * @param id - a panel id.
+ * @returns the registered view, or `undefined`.
+ *
+ * @stability experimental
+ */
+export declare function getDashboardPanelView(id: string): RegisteredDashboardPanelView | undefined;
+/**
+ * Every registered view, in registration order.
+ *
+ * @returns the views.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export declare function dashboardPanelViews(): RegisteredDashboardPanelView[];
+/** Empties the registry. For tests only: nothing in a running app calls it. */
+export declare function resetDashboardPanelViewsForTests(): void;
+//# sourceMappingURL=dashboardPanelViews.d.ts.map

package/dist/telemetry/ui/components/dashboard/panels/dashboardPanelViews.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardPanelViews.d.ts","sourceRoot":"","sources":["../../../../../../src/telemetry/ui/components/dashboard/panels/dashboardPanelViews.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAG3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AACjF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uDAAuD,CAAC;AACnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,qDAAqD,CAAC;AAC9G,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,mFAAmF;IACnF,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAAC;IAC7C;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI,GAAG,WAAW,EAAE,CAAC;IACtH;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACxF;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,uBAAuB,CAAC,OAAO,GAAG,OAAO;IACxD,qCAAqC;IACrC,KAAK,EAAE,kBAAkB,CAAC;IAC1B,yJAAyJ;IACzJ,OAAO,EAAE,OAAO,CAAC;IACjB,2GAA2G;IAC3G,KAAK,EAAE,cAAc,CAAC;IACtB,iGAAiG;IACjG,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,MAAM,EAAE,eAAe,CAAC;IACxB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,oBAAoB;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7D,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAoBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,GAAG,OAAO,EAC1D,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,aAAa,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC,EACrD,OAAO,GAAE,yBAA8B,GACtC,IAAI,CAEN;AAED;;;;GAIG;AACH,wBAAgB,kCAAkC,CAChD,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,aAAa,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,GAClD,IAAI,CAEN;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,4BAA4B,GAAG,SAAS,CAE1F;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,IAAI,4BAA4B,EAAE,CAEpE;AAED,+EAA+E;AAC/E,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}

package/dist/telemetry/ui/components/dashboard/panels/dashboardPanelViews.js

@@ -0,0 +1,74 @@
+import { DASHBOARD_PANEL_ID_PATTERN } from '@marinoscar/platform-contract/telemetry';
+const views = new Map();
+function put(id, View, frame, builtin) {
+    if (!DASHBOARD_PANEL_ID_PATTERN.test(id)) {
+        throw new Error(`Dashboard panel view id "${id}" must match ${DASHBOARD_PANEL_ID_PATTERN}.`);
+    }
+    if (typeof View !== 'function' && (typeof View !== 'object' || View === null)) {
+        throw new Error(`Dashboard panel view "${id}" needs a React component.`);
+    }
+    const existing = views.get(id);
+    if (existing) {
+        // The same component again is a no-op (a re-evaluated module); another one is a clash.
+        if (existing.View === View && existing.frame === frame)
+            return;
+        throw new Error(`A dashboard panel view is already registered for "${id}".`);
+    }
+    views.set(id, Object.freeze({ id, View, frame, builtin }));
+}
+/**
+ * Registers the view that draws the dashboard panel `id`. The API half is
+ * `registerDashboardPanel` (`@marinoscar/platform-api/telemetry`).
+ *
+ * @typeParam Payload - the shape of the payload the API panel returns.
+ * @param id - the panel id (the API registers the same one).
+ * @param View - the component; it receives {@link DashboardPanelViewProps}.
+ * @param options - who draws the frame.
+ * @throws Error when `id` is malformed, or another view is already registered for it.
+ *
+ * @example
+ * ```tsx
+ * registerDashboardPanelView<{ total: number }>('signups', ({ payload }) => <Typography>{payload.total} sign-ups</Typography>);
+ * ```
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export function registerDashboardPanelView(id, View, options = {}) {
+    put(id, View, options.frame ?? 'page', false);
+}
+/**
+ * Registers one of the platform's own panel views. Not part of the public
+ * surface (the `ui` index does not export it); the dashboard page calls
+ * `registerPlatformDashboardPanelViews`, which uses it.
+ */
+export function registerPlatformDashboardPanelView(id, View) {
+    put(id, View, 'self', true);
+}
+/**
+ * The view registered for `id`.
+ *
+ * @param id - a panel id.
+ * @returns the registered view, or `undefined`.
+ *
+ * @stability experimental
+ */
+export function getDashboardPanelView(id) {
+    return views.get(id);
+}
+/**
+ * Every registered view, in registration order.
+ *
+ * @returns the views.
+ *
+ * @extensionPoint registry
+ * @stability experimental
+ */
+export function dashboardPanelViews() {
+    return [...views.values()];
+}
+/** Empties the registry. For tests only: nothing in a running app calls it. */
+export function resetDashboardPanelViewsForTests() {
+    views.clear();
+}
+//# sourceMappingURL=dashboardPanelViews.js.map

package/dist/telemetry/ui/components/dashboard/panels/dashboardPanelViews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboardPanelViews.js","sourceRoot":"","sources":["../../../../../../src/telemetry/ui/components/dashboard/panels/dashboardPanelViews.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAC;AAgGrF,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwC,CAAC;AAE9D,SAAS,GAAG,CAAC,EAAU,EAAE,IAAmD,EAAE,KAAsB,EAAE,OAAgB;IACpH,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,4BAA4B,EAAE,gBAAgB,0BAA0B,GAAG,CAAC,CAAC;IAC/F,CAAC;IACD,IAAI,OAAO,IAAI,KAAK,UAAU,IAAI,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,yBAAyB,EAAE,4BAA4B,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,IAAI,QAAQ,EAAE,CAAC;QACb,uFAAuF;QACvF,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO;QAC/D,MAAM,IAAI,KAAK,CAAC,qDAAqD,EAAE,IAAI,CAAC,CAAC;IAC/E,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,0BAA0B,CACxC,EAAU,EACV,IAAqD,EACrD,UAAqC,EAAE;IAEvC,GAAG,CAAC,EAAE,EAAE,IAAqD,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,EAAE,KAAK,CAAC,CAAC;AACjG,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kCAAkC,CAChD,EAAU,EACV,IAAmD;IAEnD,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,EAAU;IAC9C,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,gCAAgC;IAC9C,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/dist/telemetry/ui/dashboard-page.d.ts

@@ -1,2 +1,3 @@
 export { default, default as TelemetryDashboardPage } from './pages/TelemetryDashboardPage.js';
+export type { TelemetryDashboardPageProps, TelemetryDashboardPageSlots } from './pages/TelemetryDashboardPage.js';
 //# sourceMappingURL=dashboard-page.d.ts.map

package/dist/telemetry/ui/dashboard-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dashboard-page.d.ts","sourceRoot":"","sources":["../../../src/telemetry/ui/dashboard-page.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"dashboard-page.d.ts","sourceRoot":"","sources":["../../../src/telemetry/ui/dashboard-page.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC/F,YAAY,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/telemetry/ui/dashboard-panels.d.ts

@@ -0,0 +1,5 @@
+export { dashboardPanelViews, getDashboardPanelView, registerDashboardPanelView, } from './components/dashboard/panels/dashboardPanelViews.js';
+export type { DashboardPanelHost, DashboardPanelViewOptions, DashboardPanelViewProps, RegisteredDashboardPanelView, } from './components/dashboard/panels/dashboardPanelViews.js';
+export type { PanelAction } from './components/dashboard/DashboardPanel.js';
+export type { DashboardLayout } from './components/dashboard/DashboardFilterBar.js';
+//# sourceMappingURL=dashboard-panels.d.ts.map

package/dist/telemetry/ui/dashboard-panels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-panels.d.ts","sourceRoot":"","sources":["../../../src/telemetry/ui/dashboard-panels.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,sDAAsD,CAAC;AAC9D,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,sDAAsD,CAAC;AAC9D,YAAY,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAC;AAC5E,YAAY,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC"}

package/dist/telemetry/ui/dashboard-panels.js

@@ -0,0 +1,8 @@
+// `@marinoscar/platform-web/telemetry/ui/dashboard-panels` (PP-14.18): the
+// dashboard-panel view registry alone, with none of the three pages. An app
+// registers the views of the dashboard panels its API registered
+// (`registerDashboardPanelView`) from a file its entry point loads at boot; a
+// page chunk loaded later reads the same registry. Importing this entry pulls no
+// page into the app's main chunk (the `ui` index would). Documented in ../README.md.
+export { dashboardPanelViews, getDashboardPanelView, registerDashboardPanelView, } from './components/dashboard/panels/dashboardPanelViews.js';
+//# sourceMappingURL=dashboard-panels.js.map

package/dist/telemetry/ui/dashboard-panels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dashboard-panels.js","sourceRoot":"","sources":["../../../src/telemetry/ui/dashboard-panels.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,iEAAiE;AACjE,8EAA8E;AAC9E,iFAAiF;AACjF,qFAAqF;AAErF,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,sDAAsD,CAAC"}

package/dist/telemetry/ui/explorer-page.d.ts

@@ -1,2 +1,3 @@
 export { default, default as TelemetryExplorerPage } from './pages/TelemetryExplorerPage.js';
+export type { TelemetryExplorerPageProps, TelemetryExplorerPageSlots } from './pages/TelemetryExplorerPage.js';
 //# sourceMappingURL=explorer-page.d.ts.map

package/dist/telemetry/ui/explorer-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"explorer-page.d.ts","sourceRoot":"","sources":["../../../src/telemetry/ui/explorer-page.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"explorer-page.d.ts","sourceRoot":"","sources":["../../../src/telemetry/ui/explorer-page.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC7F,YAAY,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/telemetry/ui/index.d.ts

@@ -1,6 +1,11 @@
 export { telemetryAdminCards } from './admin.js';
 export type { TelemetryAdminCard } from './admin.js';
 export { default as TelemetrySettingsPage } from './pages/TelemetrySettingsPage.js';
+export type { TelemetrySettingsPageProps, TelemetrySettingsPageSlots } from './pages/TelemetrySettingsPage.js';
 export { default as TelemetryExplorerPage } from './pages/TelemetryExplorerPage.js';
+export type { TelemetryExplorerPageProps, TelemetryExplorerPageSlots } from './pages/TelemetryExplorerPage.js';
 export { default as TelemetryDashboardPage } from './pages/TelemetryDashboardPage.js';
+export type { TelemetryDashboardPageProps, TelemetryDashboardPageSlots } from './pages/TelemetryDashboardPage.js';
+export { dashboardPanelViews, getDashboardPanelView, registerDashboardPanelView } from './components/dashboard/panels/dashboardPanelViews.js';
+export type { DashboardPanelHost, DashboardPanelViewOptions, DashboardPanelViewProps, RegisteredDashboardPanelView, } from './components/dashboard/panels/dashboardPanelViews.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/telemetry/ui/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/ui/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/ui/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACpF,YAAY,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC/G,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACpF,YAAY,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAC/G,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACtF,YAAY,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAGlH,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC;AAC9I,YAAY,EACV,kBAAkB,EAClB,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,sDAAsD,CAAC"}

package/dist/telemetry/ui/index.js

@@ -7,4 +7,7 @@ export { telemetryAdminCards } from './admin.js';
 export { default as TelemetrySettingsPage } from './pages/TelemetrySettingsPage.js';
 export { default as TelemetryExplorerPage } from './pages/TelemetryExplorerPage.js';
 export { default as TelemetryDashboardPage } from './pages/TelemetryDashboardPage.js';
+// The dashboard-panel view registry (PP-14.18). An app that wants it without the pages
+// imports `./dashboard-panels` instead.
+export { dashboardPanelViews, getDashboardPanelView, registerDashboardPanelView } from './components/dashboard/panels/dashboardPanelViews.js';
 //# sourceMappingURL=index.js.map

package/dist/telemetry/ui/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/ui/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,yEAAyE;AACzE,4EAA4E;AAC5E,yEAAyE;AACzE,gBAAgB;AAEhB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/ui/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,yEAAyE;AACzE,4EAA4E;AAC5E,yEAAyE;AACzE,gBAAgB;AAEhB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEpF,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAEpF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEtF,uFAAuF;AACvF,wCAAwC;AACxC,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,sDAAsD,CAAC"}

package/dist/telemetry/ui/pages/TelemetryDashboardPage.d.ts

@@ -1,3 +1,19 @@
+import type { PageSlotsBase } from '../../../core/index.js';
+/**
+ * The `slots` of {@link TelemetryDashboardPage}: the packaged-page slot contract, no more.
+ *
+ * @stability experimental
+ */
+export type TelemetryDashboardPageSlots = PageSlotsBase;
+/**
+ * The props of {@link TelemetryDashboardPage}.
+ *
+ * @stability experimental
+ */
+export interface TelemetryDashboardPageProps {
+    /** Header, banner and extra sections around the dashboard (the packaged-page slot contract). */
+    slots?: TelemetryDashboardPageSlots;
+}
 /**
  * The Telemetry Dashboard (`/admin/settings/telemetry/dashboard`): the
  * verdict, KPI tiles, API and log timelines, top problems, events and one
@@ -5,10 +21,16 @@
  * titled from their metadata). Its state lives in the URL. Route it behind the
  * app's permission gate for `telemetry:query` and `RequireTelemetryEnabled`.
  *
+ * @param props - `slots`: the packaged-page slot contract.
  * @returns the page.
  *
+ * @example
+ * ```tsx
+ * <TelemetryDashboardPage slots={{ BeforeContent: () => <Alert severity="info">Deploy freeze until Monday.</Alert> }} />
+ * ```
+ *
  * @extensionPoint component
  * @stability experimental
  */
-export default function TelemetryDashboardPage(): import("react").JSX.Element;
+export default function TelemetryDashboardPage({ slots }?: TelemetryDashboardPageProps): import("react").JSX.Element;
 //# sourceMappingURL=TelemetryDashboardPage.d.ts.map

package/dist/telemetry/ui/pages/TelemetryDashboardPage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TelemetryDashboardPage.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/ui/pages/TelemetryDashboardPage.tsx"],"names":[],"mappings":"AA0QA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,gCAsZ7C"}
+{"version":3,"file":"TelemetryDashboardPage.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/ui/pages/TelemetryDashboardPage.tsx"],"names":[],"mappings":"AA6DA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAkR5D;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,aAAa,CAAC;AAExD;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,gGAAgG;IAChG,KAAK,CAAC,EAAE,2BAA2B,CAAC;CACrC;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,UAAU,sBAAsB,CAAC,EAAE,KAAK,EAAE,GAAE,2BAAgC,+BA2czF"}