@mastra/playground-ui 48.0.0-alpha.8 → 48.0.0

package/dist/src/ee/signals/theme-lifelines-data.d.ts

@@ -0,0 +1,35 @@
+import { ThemeFlowResponse, TraceSignalName } from './types';
+export type ThemeLifelinePoint = {
+    /** Index into the landmark run this point belongs to. */
+    snapshotIndex: number;
+    /** Share of the signal's cohort at that landmark (0..1). */
+    share: number;
+    traceCount: number;
+    /** The contributing theme node's id at that landmark, when it has one. */
+    themeId?: string;
+};
+export type ThemeLifeline = {
+    label: string;
+    points: ThemeLifelinePoint[];
+};
+export type LifelineConnector = {
+    from: ThemeLifelinePoint;
+    to: ThemeLifelinePoint;
+};
+/**
+ * Pairs of presence points at consecutive landmarks. Gaps stay unconnected so
+ * a theme's absence between two appearances remains visible.
+ */
+export declare function lifelineConnectors(points: ThemeLifelinePoint[]): LifelineConnector[];
+/**
+ * Runs of presence points at consecutive landmarks, single-point runs dropped —
+ * each run is one filled area under the lifeline, and gaps between runs stay
+ * unfilled so absence remains visible.
+ */
+export declare function lifelineSegments(points: ThemeLifelinePoint[]): ThemeLifelinePoint[][];
+/**
+ * One fixed row per theme label across an ordered run of landmark flows, most
+ * persistent first, so stable themes read as continuous spines and transient
+ * ones as short segments. Unloaded flows are skipped by passing undefined.
+ */
+export declare function buildThemeLifelines(flows: Array<ThemeFlowResponse | undefined>, signalName: TraceSignalName): ThemeLifeline[];

package/dist/src/ee/signals/theme-lifelines.d.ts

@@ -0,0 +1,17 @@
+import { ThemeSelection } from './theme-drilldown-data';
+import { ThemeSnapshot, TraceSignalName } from './types';
+/**
+ * Lifelines mode: every theme holds a fixed row while landmarks run left to
+ * right on the shared time axis, so persistent themes read as spines and
+ * transient ones as short-lived segments — change over time without replay.
+ */
+export declare function ThemeLifelines({ entityId, entityType, signalNames, snapshots, totalSnapshots, selectedIndex, onSnapshotSelect, onThemeSelect, }: {
+    entityId: string;
+    entityType: string;
+    signalNames: TraceSignalName[];
+    snapshots: ThemeSnapshot[];
+    totalSnapshots: number;
+    selectedIndex: number;
+    onSnapshotSelect: (index: number) => void;
+    onThemeSelect: (selection: ThemeSelection, snapshotIndex: number) => void;
+}): import("react").JSX.Element;

package/dist/src/ee/signals/theme-trend-chart.d.ts

@@ -0,0 +1,6 @@
+import { ThemeHistoryPoint } from './theme-trend';
+/** Trace count over time for one theme, with absent stretches dropping to the baseline. */
+export declare function ThemeTrendChart({ points, color }: {
+    points: ThemeHistoryPoint[];
+    color: string;
+}): import("react").JSX.Element | null;

package/dist/src/ee/signals/theme-trend.d.ts

@@ -0,0 +1,17 @@
+import { ThemeHistoryResponse } from '@mastra/client-js';
+export type ThemeHistoryPoint = ThemeHistoryResponse['points'][number];
+export type TrendDirection = 'growing' | 'fading' | 'steady';
+/**
+ * History points arrive newest-first from the API (`ORDER BY frameId DESC`);
+ * every presentation in the panel reads oldest-first.
+ */
+export declare function chronologicalHistoryPoints(points: ThemeHistoryPoint[]): ThemeHistoryPoint[];
+/**
+ * Whether a theme is gaining or losing traction across its history. Prefers
+ * the clustering pipeline's trend score on the latest point; falls back to
+ * comparing the mean trace count of the first and last thirds of the series.
+ *
+ * Points MUST be in chronological order (see `chronologicalHistoryPoints`) —
+ * raw API output is newest-first and would invert the answer.
+ */
+export declare function themeTrendDirection(points: ThemeHistoryPoint[]): TrendDirection;

package/dist/src/ee/signals/trace-insight-view.d.ts

@@ -0,0 +1,6 @@
+interface TraceInsightViewProps {
+    traceId: string;
+    onBack: () => void;
+}
+export declare function TraceInsightView({ traceId, onBack }: TraceInsightViewProps): import("react").JSX.Element;
+export {};

package/dist/src/ee/signals/trace-intelligence-context.d.ts

@@ -0,0 +1,10 @@
+import { LinkComponent } from '../../ds/types/link-component';
+export type TraceIntelligenceRequest = <Response>(path: string) => Promise<Response>;
+export interface TraceIntelligenceContextValue {
+    cacheScope: string;
+    request: TraceIntelligenceRequest;
+    LinkComponent: LinkComponent;
+    getTraceHref: (traceId: string) => string;
+}
+export declare const defaultTraceIntelligenceContextValue: TraceIntelligenceContextValue;
+export declare const TraceIntelligenceContext: import('react').Context<TraceIntelligenceContextValue>;

package/dist/src/ee/signals/trace-intelligence-explainer.d.ts

@@ -0,0 +1,2 @@
+/** Info tooltip for first-time viewers: signals → themes → snapshots. */
+export declare function TraceIntelligenceExplainer(): import("react").JSX.Element;

package/dist/src/ee/signals/trace-intelligence-provider.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+import { TraceIntelligenceRequest } from './trace-intelligence-context';
+import { LinkComponent } from '../../ds/types/link-component';
+export interface TraceIntelligenceProviderProps {
+    cacheScope: string;
+    children: ReactNode;
+    request?: TraceIntelligenceRequest;
+    LinkComponent?: LinkComponent;
+    getTraceHref?: (traceId: string) => string;
+}
+export declare function TraceIntelligenceProvider({ cacheScope, children, request, LinkComponent, getTraceHref, }: TraceIntelligenceProviderProps): import("react").JSX.Element;

package/dist/src/ee/signals/types.d.ts

@@ -0,0 +1 @@
+export type { EntityLearningProgressResponse, NoiseExamplesResponse, NoiseResponse, ThemeDetailResponse, ThemeEntitiesResponse, ThemeExamplesResponse, ThemeFlowResponse, ThemeHistoryResponse, ThemeLearningEntity, ThemeNode, ThemePathsResponse, ThemeSnapshot, ThemeSnapshotsResponse, TraceInsightResponse, TraceSignalName, } from '@mastra/client-js';

package/dist/src/ee/signals/use-trace-intelligence.d.ts

@@ -0,0 +1 @@
+export declare function useTraceIntelligence(): import('./trace-intelligence-context').TraceIntelligenceContextValue;

package/dist/src/ee/signals/view-mode-tab.d.ts

@@ -0,0 +1,6 @@
+export type SignalsViewMode = 'flow' | 'compare' | 'lifelines';
+export declare function ViewModeTab({ value, icon, label }: {
+    value: SignalsViewMode;
+    icon: React.ReactNode;
+    label: string;
+}): import("react").JSX.Element;

package/dist/src/test/msw-server.d.ts

@@ -0,0 +1 @@
+export declare const server: import('msw/node').SetupServer;

package/dist/src/test/vitest-setup.d.ts

@@ -0,0 +1 @@
+export {};