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

package/dist/{select-field-block-DXw3tD0y.js.map → select-field-block-D1Na8gZW.js.map}

@@ -1 +1 @@
-{"version":3,"file":"select-field-block-DXw3tD0y.js","sources":["../src/ds/components/FormFieldBlocks/fields/select-field-block.tsx"],"sourcesContent":["import type { SelectTriggerProps } from '../../Select/select';\nimport { FieldBlock } from '../block/field-block';\nimport type { FieldBlockErrorMsgProps } from '../block/field-block-error-msg';\nimport type { FieldBlockHelpTextProps } from '../block/field-block-help-text';\nimport type { FieldBlockLabelProps } from '../block/field-block-label';\nimport type { FieldBlockLayoutProps } from '../block/field-block-layout';\nimport { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/ds/components/Select';\nimport { VisuallyHidden } from '@/ds/primitives/visually-hidden';\n\nexport type SelectFieldBlockProps = Pick<FieldBlockLayoutProps, 'layout' | 'labelColumnWidth'> &\n  Pick<FieldBlockLabelProps, 'name' | 'required'> & {\n    testId?: string;\n    label?: string | null;\n    labelIsHidden?: boolean;\n    labelSize?: FieldBlockLabelProps['size'];\n    disabled?: boolean;\n    value?: string;\n    options: { value: string; label: string }[];\n    placeholder?: string;\n    onValueChange: (value: string) => void;\n    helpText?: FieldBlockHelpTextProps['children'];\n    errorMsg?: FieldBlockErrorMsgProps['children'];\n    error?: boolean;\n    className?: string;\n    size?: SelectTriggerProps['size'];\n  };\n\nexport function SelectFieldBlock({\n  name,\n  helpText,\n  errorMsg,\n  required = false,\n  disabled = false,\n  size = 'md',\n  value,\n  label,\n  labelIsHidden = false,\n  layout = 'vertical',\n  labelColumnWidth,\n  options,\n  placeholder = 'Select an option',\n  onValueChange,\n  className,\n}: SelectFieldBlockProps) {\n  return (\n    <FieldBlock.Layout layout={layout} labelColumnWidth={labelColumnWidth} className={className}>\n      {layout === 'horizontal' ? (\n        <FieldBlock.Column>\n          <FieldBlock.Label name={name} required={required}>\n            {labelIsHidden ? <VisuallyHidden>{label}</VisuallyHidden> : label}\n          </FieldBlock.Label>\n        </FieldBlock.Column>\n      ) : null}\n      <FieldBlock.Column>\n        {layout === 'vertical' && label && !labelIsHidden ? (\n          <FieldBlock.Label name={name} required={required}>\n            {label}\n          </FieldBlock.Label>\n        ) : null}\n        <Select\n          aria-label={labelIsHidden ? label : undefined}\n          name={name}\n          value={value}\n          onValueChange={onValueChange}\n          disabled={disabled}\n        >\n          <SelectTrigger size={size}>\n            <SelectValue placeholder={placeholder} />\n          </SelectTrigger>\n          <SelectContent>\n            {options.map(option => (\n              <SelectItem key={option.value} value={option.value}>\n                {option.label}\n              </SelectItem>\n            ))}\n          </SelectContent>\n        </Select>\n        {helpText && <FieldBlock.HelpText>{helpText}</FieldBlock.HelpText>}\n        {errorMsg && <FieldBlock.ErrorMsg>{errorMsg}</FieldBlock.ErrorMsg>}\n      </FieldBlock.Column>\n    </FieldBlock.Layout>\n  );\n}\n"],"names":[],"mappings":";;;;;AA2BO,SAAS,gBAAA,CAAiB;AAAA,EAC/B,IAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA,GAAW,KAAA;AAAA,EACX,QAAA,GAAW,KAAA;AAAA,EACX,IAAA,GAAO,IAAA;AAAA,EACP,KAAA;AAAA,EACA,KAAA;AAAA,EACA,aAAA,GAAgB,KAAA;AAAA,EAChB,MAAA,GAAS,UAAA;AAAA,EACT,gBAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA,GAAc,kBAAA;AAAA,EACd,aAAA;AAAA,EACA;AACF,CAAA,EAA0B;AACxB,EAAA,4BACG,UAAA,CAAW,MAAA,EAAX,EAAkB,MAAA,EAAgB,kBAAoC,SAAA,EACpE,QAAA,EAAA;AAAA,IAAA,MAAA,KAAW,+BACV,GAAA,CAAC,UAAA,CAAW,QAAX,EACC,QAAA,kBAAA,GAAA,CAAC,WAAW,KAAA,EAAX,EAAiB,IAAA,EAAY,QAAA,EAC3B,0CAAgB,GAAA,CAAC,cAAA,EAAA,EAAgB,iBAAM,CAAA,GAAoB,KAAA,EAC9D,GACF,CAAA,GACE,IAAA;AAAA,oBACJ,IAAA,CAAC,UAAA,CAAW,MAAA,EAAX,EACE,QAAA,EAAA;AAAA,MAAA,MAAA,KAAW,UAAA,IAAc,KAAA,IAAS,CAAC,aAAA,mBAClC,GAAA,CAAC,UAAA,CAAW,KAAA,EAAX,EAAiB,IAAA,EAAY,QAAA,EAC3B,QAAA,EAAA,KAAA,EACH,CAAA,GACE,IAAA;AAAA,sBACJ,IAAA;AAAA,QAAC,MAAA;AAAA,QAAA;AAAA,UACC,YAAA,EAAY,gBAAgB,KAAA,GAAQ,MAAA;AAAA,UACpC,IAAA;AAAA,UACA,KAAA;AAAA,UACA,aAAA;AAAA,UACA,QAAA;AAAA,UAEA,QAAA,EAAA;AAAA,4BAAA,GAAA,CAAC,aAAA,EAAA,EAAc,IAAA,EACb,QAAA,kBAAA,GAAA,CAAC,WAAA,EAAA,EAAY,aAA0B,CAAA,EACzC,CAAA;AAAA,4BACA,GAAA,CAAC,aAAA,EAAA,EACE,QAAA,EAAA,OAAA,CAAQ,GAAA,CAAI,4BACX,GAAA,CAAC,UAAA,EAAA,EAA8B,KAAA,EAAO,MAAA,CAAO,OAC1C,QAAA,EAAA,MAAA,CAAO,KAAA,EAAA,EADO,MAAA,CAAO,KAExB,CACD,CAAA,EACH;AAAA;AAAA;AAAA,OACF;AAAA,MACC,QAAA,oBAAY,GAAA,CAAC,UAAA,CAAW,QAAA,EAAX,EAAqB,QAAA,EAAA,QAAA,EAAS,CAAA;AAAA,MAC3C,QAAA,oBAAY,GAAA,CAAC,UAAA,CAAW,QAAA,EAAX,EAAqB,QAAA,EAAA,QAAA,EAAS;AAAA,KAAA,EAC9C;AAAA,GAAA,EACF,CAAA;AAEJ;;;;"}
+{"version":3,"file":"select-field-block-D1Na8gZW.js","sources":["../src/ds/components/FormFieldBlocks/fields/select-field-block.tsx"],"sourcesContent":["import type { SelectTriggerProps } from '../../Select/select';\nimport { FieldBlock } from '../block/field-block';\nimport type { FieldBlockErrorMsgProps } from '../block/field-block-error-msg';\nimport type { FieldBlockHelpTextProps } from '../block/field-block-help-text';\nimport type { FieldBlockLabelProps } from '../block/field-block-label';\nimport type { FieldBlockLayoutProps } from '../block/field-block-layout';\nimport { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from '@/ds/components/Select';\nimport { VisuallyHidden } from '@/ds/primitives/visually-hidden';\n\nexport type SelectFieldBlockProps = Pick<FieldBlockLayoutProps, 'layout' | 'labelColumnWidth'> &\n  Pick<FieldBlockLabelProps, 'name' | 'required'> & {\n    testId?: string;\n    label?: string | null;\n    labelIsHidden?: boolean;\n    labelSize?: FieldBlockLabelProps['size'];\n    disabled?: boolean;\n    value?: string;\n    options: { value: string; label: string }[];\n    placeholder?: string;\n    onValueChange: (value: string) => void;\n    helpText?: FieldBlockHelpTextProps['children'];\n    errorMsg?: FieldBlockErrorMsgProps['children'];\n    error?: boolean;\n    className?: string;\n    size?: SelectTriggerProps['size'];\n  };\n\nexport function SelectFieldBlock({\n  name,\n  helpText,\n  errorMsg,\n  required = false,\n  disabled = false,\n  size = 'md',\n  value,\n  label,\n  labelIsHidden = false,\n  layout = 'vertical',\n  labelColumnWidth,\n  options,\n  placeholder = 'Select an option',\n  onValueChange,\n  className,\n}: SelectFieldBlockProps) {\n  return (\n    <FieldBlock.Layout layout={layout} labelColumnWidth={labelColumnWidth} className={className}>\n      {layout === 'horizontal' ? (\n        <FieldBlock.Column>\n          <FieldBlock.Label name={name} required={required}>\n            {labelIsHidden ? <VisuallyHidden>{label}</VisuallyHidden> : label}\n          </FieldBlock.Label>\n        </FieldBlock.Column>\n      ) : null}\n      <FieldBlock.Column>\n        {layout === 'vertical' && label && !labelIsHidden ? (\n          <FieldBlock.Label name={name} required={required}>\n            {label}\n          </FieldBlock.Label>\n        ) : null}\n        <Select\n          aria-label={labelIsHidden ? label : undefined}\n          name={name}\n          value={value}\n          onValueChange={onValueChange}\n          disabled={disabled}\n        >\n          <SelectTrigger size={size}>\n            <SelectValue placeholder={placeholder} />\n          </SelectTrigger>\n          <SelectContent>\n            {options.map(option => (\n              <SelectItem key={option.value} value={option.value}>\n                {option.label}\n              </SelectItem>\n            ))}\n          </SelectContent>\n        </Select>\n        {helpText && <FieldBlock.HelpText>{helpText}</FieldBlock.HelpText>}\n        {errorMsg && <FieldBlock.ErrorMsg>{errorMsg}</FieldBlock.ErrorMsg>}\n      </FieldBlock.Column>\n    </FieldBlock.Layout>\n  );\n}\n"],"names":[],"mappings":";;;;;AA2BO,SAAS,gBAAA,CAAiB;AAAA,EAC/B,IAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA,GAAW,KAAA;AAAA,EACX,QAAA,GAAW,KAAA;AAAA,EACX,IAAA,GAAO,IAAA;AAAA,EACP,KAAA;AAAA,EACA,KAAA;AAAA,EACA,aAAA,GAAgB,KAAA;AAAA,EAChB,MAAA,GAAS,UAAA;AAAA,EACT,gBAAA;AAAA,EACA,OAAA;AAAA,EACA,WAAA,GAAc,kBAAA;AAAA,EACd,aAAA;AAAA,EACA;AACF,CAAA,EAA0B;AACxB,EAAA,4BACG,UAAA,CAAW,MAAA,EAAX,EAAkB,MAAA,EAAgB,kBAAoC,SAAA,EACpE,QAAA,EAAA;AAAA,IAAA,MAAA,KAAW,+BACV,GAAA,CAAC,UAAA,CAAW,QAAX,EACC,QAAA,kBAAA,GAAA,CAAC,WAAW,KAAA,EAAX,EAAiB,IAAA,EAAY,QAAA,EAC3B,0CAAgB,GAAA,CAAC,cAAA,EAAA,EAAgB,iBAAM,CAAA,GAAoB,KAAA,EAC9D,GACF,CAAA,GACE,IAAA;AAAA,oBACJ,IAAA,CAAC,UAAA,CAAW,MAAA,EAAX,EACE,QAAA,EAAA;AAAA,MAAA,MAAA,KAAW,UAAA,IAAc,KAAA,IAAS,CAAC,aAAA,mBAClC,GAAA,CAAC,UAAA,CAAW,KAAA,EAAX,EAAiB,IAAA,EAAY,QAAA,EAC3B,QAAA,EAAA,KAAA,EACH,CAAA,GACE,IAAA;AAAA,sBACJ,IAAA;AAAA,QAAC,MAAA;AAAA,QAAA;AAAA,UACC,YAAA,EAAY,gBAAgB,KAAA,GAAQ,MAAA;AAAA,UACpC,IAAA;AAAA,UACA,KAAA;AAAA,UACA,aAAA;AAAA,UACA,QAAA;AAAA,UAEA,QAAA,EAAA;AAAA,4BAAA,GAAA,CAAC,aAAA,EAAA,EAAc,IAAA,EACb,QAAA,kBAAA,GAAA,CAAC,WAAA,EAAA,EAAY,aAA0B,CAAA,EACzC,CAAA;AAAA,4BACA,GAAA,CAAC,aAAA,EAAA,EACE,QAAA,EAAA,OAAA,CAAQ,GAAA,CAAI,4BACX,GAAA,CAAC,UAAA,EAAA,EAA8B,KAAA,EAAO,MAAA,CAAO,OAC1C,QAAA,EAAA,MAAA,CAAO,KAAA,EAAA,EADO,MAAA,CAAO,KAExB,CACD,CAAA,EACH;AAAA;AAAA;AAAA,OACF;AAAA,MACC,QAAA,oBAAY,GAAA,CAAC,UAAA,CAAW,QAAA,EAAX,EAAqB,QAAA,EAAA,QAAA,EAAS,CAAA;AAAA,MAC3C,QAAA,oBAAY,GAAA,CAAC,UAAA,CAAW,QAAA,EAAX,EAAqB,QAAA,EAAA,QAAA,EAAS;AAAA,KAAA,EAC9C;AAAA,GAAA,EACF,CAAA;AAEJ;;;;"}

package/dist/src/domains/traces/hooks/use-entity-names.d.ts

@@ -1,6 +1,7 @@
 import { EntityType } from '@mastra/core/observability';
+type EntityTypeValue = `${EntityType}`;
 type UseEntityNamesOptions = {
-    entityType?: EntityType;
+    entityType?: EntityTypeValue;
     rootOnly?: boolean;
 };
 export declare const useEntityNames: ({ entityType, rootOnly }?: UseEntityNamesOptions) => import('@tanstack/react-query').UseQueryResult<string[], Error>;

package/dist/src/ds/components/ChatShell/chat-shell.d.ts

@@ -8,9 +8,10 @@ export type ChatShellProps = ComponentPropsWithoutRef<'div'> & {
  * composer docks inside it, every region shares one column.
  *
  * Tuned through custom properties, all defaulted here: `--chat-column` (column
- * width), `--chat-surface` (page colour), `--chat-gutter` (room above and below
- * the composer), `--chat-veil` (what the dock paints with), `--chat-inset-end`
- * (room an overlay panel claims on the end edge).
+ * width), `--chat-surface` (page colour), `--chat-fade` (the band the veil ramps
+ * in across, above the composer), `--chat-veil` (strongest it ever gets — the
+ * transcript keeps showing through), `--chat-gutter` (room below the composer),
+ * `--chat-inset-end` (room an overlay panel claims on the end edge).
  */
 export declare function ChatShellRoot({ className, scroller, ...props }: ChatShellProps): import("react").JSX.Element;
 /**
@@ -25,7 +26,7 @@ export declare function ChatShellStage({ className, ...props }: ComponentPropsWi
  * same room would drag the scrollbar inward, off the true edge.
  */
 export declare function ChatShellViewport({ className, children, ...props }: MessageScrollerViewportProps): import("react").JSX.Element;
-/** Scrolling content. Its bottom padding is the unveiled air above the composer. */
+/** Scrolling content. The air above the composer belongs to the dock's fade band. */
 export declare function ChatShellContent({ className, ...props }: MessageScrollerContentProps): import("react").JSX.Element;
 /** The shared reading column. Every chat region must go through it. */
 export declare function ChatShellColumn({ className, ...props }: ComponentPropsWithoutRef<'div'>): import("react").JSX.Element;
@@ -34,8 +35,10 @@ export declare function ChatShellColumn({ className, ...props }: ComponentPropsW
  * transcript scrolls behind, so nothing measures it and a composer growing under
  * the cursor resizes no box the scroller watches.
  *
- * The veil is a background, not an overlay, so it passes behind the composer card
- * and dims the transcript in its rounded corners too.
+ * Behind it, one sheet of the page masked in over `--chat-fade` of air and never
+ * past `--chat-veil`, so the transcript dims as it slides under but stays
+ * readable through the card's surroundings. The ramp runs three times the air, so
+ * it tops out behind the card and its end never shows.
  */
 export declare function ChatShellDock({ className, ...props }: ComponentPropsWithoutRef<'div'>): import("react").JSX.Element;
 /**

package/dist/src/ds/components/MainSidebar/main-sidebar-nav-item-classes.d.ts

@@ -4,13 +4,24 @@ declare const navItemVariants: (props?: ({
 } & import('class-variance-authority/types').ClassProp) | undefined) => string;
 type NavItemVariantProps = VariantProps<typeof navItemVariants>;
 export type MainSidebarNavItemSize = NonNullable<NavItemVariantProps['size']>;
-type ItemStyleOptions = {
+type NavRowSurfaceOptions = {
     isActive?: boolean;
-    isCollapsed?: boolean;
     isFeatured?: boolean;
+};
+type NavItemLayoutOptions = {
+    isCollapsed?: boolean;
     level?: number;
     size?: MainSidebarNavItemSize;
 };
+type ItemStyleOptions = NavRowSurfaceOptions & NavItemLayoutOptions;
+/**
+ * Color chrome of a nav row: background, text, and icon states. Belongs on
+ * whatever element spans the whole row box — the interactive element itself, or
+ * the flex wrapper holding it next to a trailing action.
+ */
+export declare const navRowSurfaceClasses: ({ isActive, isFeatured }: NavRowSurfaceOptions) => string;
+/** Box and typography of a nav row, without the colour chrome. */
+export declare const navItemLayoutClasses: ({ isCollapsed, level, size }: NavItemLayoutOptions) => string;
 /**
  * Shared classes for any sidebar nav row element (anchor, button, custom).
  * Apply directly to the interactive element so `asChild` and custom slotted

package/dist/src/ds/components/MainSidebar/main-sidebar-nav-link.d.ts

@@ -1,4 +1,4 @@
-import { default as React, ComponentPropsWithoutRef } from 'react';
+import { default as React, ComponentProps } from 'react';
 import { SidebarState } from './main-sidebar-context';
 import { MainSidebarNavItemSize } from './main-sidebar-nav-item-classes';
 import { LinkComponent } from '../../types/link-component';
@@ -13,7 +13,7 @@ export type NavLink = {
     /** @deprecated Prefer nested `children`; accepted for callers still rendering manual sublinks. */
     indent?: boolean;
 };
-export type MainSidebarNavLinkProps = Omit<ComponentPropsWithoutRef<'li'>, 'children'> & {
+export type MainSidebarNavLinkProps = Omit<ComponentProps<'li'>, 'children'> & {
     link?: NavLink;
     isActive?: boolean;
     state?: SidebarState;

package/dist/src/ds/components/MarkdownRenderer/markdown-renderer.d.ts

@@ -1,6 +1,8 @@
 import { default as React } from 'react';
+export type MarkdownExternalLinkTarget = 'tab' | 'window';
 export type MarkdownRendererProps = {
     children: string;
+    externalLinkTarget?: MarkdownExternalLinkTarget;
 };
-export declare function MarkdownRenderer({ children }: MarkdownRendererProps): React.JSX.Element;
+export declare function MarkdownRenderer({ children, externalLinkTarget }: MarkdownRendererProps): React.JSX.Element;
 export default MarkdownRenderer;

package/dist/src/ds/components/SankeyChart/sankey-chart.d.ts

@@ -1,6 +1,6 @@
 import { ComponentProps, CSSProperties } from 'react';
 import { Sankey as RechartsSankey } from 'recharts';
-import { SankeyChartCurveSelection, SankeyChartNodeSelection } from './sankey-chart-utils';
+import { SankeyChartColumn, SankeyChartCurveSelection, SankeyChartNodeSelection } from './sankey-chart-utils';
 export type SankeyChartProps = {
     height?: CSSProperties['height'];
     className?: string;
@@ -8,5 +8,10 @@ export type SankeyChartProps = {
     onCurveClick?: (selection: SankeyChartCurveSelection) => void;
     onNodeClick?: (selection: SankeyChartNodeSelection) => void;
     isNodeClickable?: (selection: SankeyChartNodeSelection) => boolean;
+    getColumnDescription?: (column: SankeyChartColumn) => string | undefined;
+    /** Suppress the built-in SVG column headers when the caller renders its own header row. */
+    hideColumnLabels?: boolean;
+    /** Animate fixed node and ribbon geometry when this perspective key changes. */
+    geometryTransitionKey?: string;
 };
-export declare function SankeyChart({ height, className, margin, onCurveClick, onNodeClick, isNodeClickable, }: SankeyChartProps): import("react").JSX.Element;
+export declare function SankeyChart({ height, className, margin, onCurveClick, onNodeClick, isNodeClickable, getColumnDescription, hideColumnLabels, geometryTransitionKey, }: SankeyChartProps): import("react").JSX.Element;

package/dist/src/ds/components/SankeyChart/sankey-portal-tooltip.d.ts

@@ -0,0 +1,8 @@
+import { SankeyTooltipPosition } from './use-sankey-hover-tooltip';
+export declare function SankeyPortalTooltip({ id, title, description, position, visible, }: {
+    id: string;
+    title: string;
+    description: string;
+    position: SankeyTooltipPosition | undefined;
+    visible: boolean;
+}): import('react').ReactPortal | null;

package/dist/src/ds/components/SankeyChart/use-sankey-geometry-transition.d.ts

@@ -0,0 +1,11 @@
+import { FixedSankeyGeometry } from './sankey-chart-utils';
+/**
+ * Preserves node identity while pairing replaced links by render order. That
+ * synthetic pairing keeps every ribbon moving continuously through a reorder,
+ * even though changing adjacency means the old and new links have different IDs.
+ */
+export declare function interpolateSankeyGeometry(from: FixedSankeyGeometry, to: FixedSankeyGeometry, progress: number): FixedSankeyGeometry;
+export declare function useSankeyGeometryTransition({ geometry, transitionKey, }: {
+    geometry?: FixedSankeyGeometry;
+    transitionKey?: string;
+}): FixedSankeyGeometry | undefined;

package/dist/src/ds/components/SankeyChart/use-sankey-hover-tooltip.d.ts

@@ -0,0 +1,15 @@
+export type SankeyTooltipPosition = {
+    left: number;
+    top: number;
+    placement: 'above' | 'below';
+};
+export declare const SANKEY_TOOLTIP_MAX_WIDTH_PX = 320;
+export declare function useSankeyHoverTooltip(enabled: boolean): {
+    id: string;
+    position: SankeyTooltipPosition | undefined;
+    isVisible: boolean;
+    showOnHover(target: Element): void;
+    hideOnLeave(): void;
+    showOnFocus(target: Element): void;
+    hideOnBlur(): void;
+};

package/dist/src/ds/components/ThreadRail/thread-rail-turns.d.ts

@@ -8,4 +8,6 @@ export interface ThreadRailTurn {
     hiddenFileCount: number;
 }
 export declare const getClientMessageKey: (message: MastraDBMessage) => string;
+/** What opens a turn: a rail stop, and the row the scroller parks at the top. */
+export declare const startsUserTurn: (message: MastraDBMessage) => boolean;
 export declare const buildThreadRailTurns: (messages: MastraDBMessage[]) => ThreadRailTurn[];

package/dist/src/ee/signals/entity-learning-api.d.ts

@@ -0,0 +1,13 @@
+import { TraceIntelligenceRequest } from './trace-intelligence-context';
+import { NoiseResponse, ThemeDetailResponse, EntityLearningProgressResponse, ThemeEntitiesResponse, ThemeExamplesResponse, ThemeFlowResponse, ThemeHistoryResponse, ThemePathsResponse, ThemeSnapshotsResponse, TraceInsightResponse, TraceSignalName } from './types';
+export declare function fetchThemeEntities(request: TraceIntelligenceRequest, entityType: string): Promise<ThemeEntitiesResponse>;
+export declare function fetchEntityLearningProgress(request: TraceIntelligenceRequest, entityId: string, entityType: string): Promise<EntityLearningProgressResponse>;
+export declare function fetchThemeSnapshots(request: TraceIntelligenceRequest, entityId: string, entityType: string, signalNames: string[], dateFrom?: Date, dateTo?: Date, limit?: number): Promise<ThemeSnapshotsResponse>;
+export declare function fetchThemeFlow(request: TraceIntelligenceRequest, entityId: string, entityType: string, signalNames: string[], snapshotId: string, themeLimitPerStage?: number): Promise<ThemeFlowResponse>;
+export declare function fetchThemeDetail(request: TraceIntelligenceRequest, entityId: string, entityType: string, signalName: TraceSignalName, snapshotId: string, themeId: string): Promise<ThemeDetailResponse>;
+export declare function fetchThemeExamples(request: TraceIntelligenceRequest, entityId: string, entityType: string, signalName: TraceSignalName, snapshotId: string, themeId: string, limit?: number, offset?: number): Promise<ThemeExamplesResponse>;
+export declare function fetchThemeHistory(request: TraceIntelligenceRequest, entityId: string, entityType: string, signalName: TraceSignalName, themeId: string, limit?: number): Promise<ThemeHistoryResponse>;
+export declare function fetchNoise(request: TraceIntelligenceRequest, entityId: string, entityType: string, signalName: TraceSignalName, snapshotId: string): Promise<NoiseResponse>;
+export declare function fetchNoiseExamples(request: TraceIntelligenceRequest, entityId: string, entityType: string, signalName: TraceSignalName, snapshotId: string, limit?: number, offset?: number): Promise<ThemeExamplesResponse>;
+export declare function fetchThemePaths(request: TraceIntelligenceRequest, entityId: string, entityType: string, signalNames: TraceSignalName[], snapshotId: string): Promise<ThemePathsResponse>;
+export declare function fetchTraceInsight(request: TraceIntelligenceRequest, traceId: string): Promise<TraceInsightResponse>;

package/dist/src/ee/signals/examples-pager.d.ts

@@ -0,0 +1,7 @@
+export declare const EXAMPLES_PAGE_SIZE = 5;
+/** Numbered pager for detail-panel example lists — page count derives from the theme's trace count. */
+export declare function ExamplesPager({ traceCount, offset, onOffsetChange, }: {
+    traceCount: number;
+    offset: number;
+    onOffsetChange: (offset: number) => void;
+}): import("react").JSX.Element | null;

package/dist/src/ee/signals/flow-card.d.ts

@@ -0,0 +1,14 @@
+import { ThemeFlowResponse, TraceSignalName } from './types';
+import { SankeyChartColumn, SankeyChartNodeSelection, SankeyChartRecord } from '../../ds/components/SankeyChart';
+export declare function FlowCard({ columns, records, stages, height, onNodeClick, isNodeClickable, drillInDisabledReason, onOrderChange, signalOrder, reorderDisabled, }: {
+    columns: SankeyChartColumn[];
+    records: SankeyChartRecord[];
+    stages: ThemeFlowResponse['stages'];
+    height?: number;
+    onNodeClick?: (selection: SankeyChartNodeSelection) => void;
+    isNodeClickable?: (selection: SankeyChartNodeSelection) => boolean;
+    drillInDisabledReason?: string;
+    onOrderChange: (signalNames: TraceSignalName[]) => void;
+    signalOrder: TraceSignalName[];
+    reorderDisabled: boolean;
+}): import("react").JSX.Element;

package/dist/src/ee/signals/hooks/index.d.ts

@@ -0,0 +1,11 @@
+export { useNoise } from './use-noise';
+export { useNoiseExamples } from './use-noise-examples';
+export { useEntityLearningProgress } from './use-entity-learning-progress';
+export { useThemeDetail } from './use-theme-detail';
+export { useThemeEntities } from './use-theme-entities';
+export { useThemeExamples } from './use-theme-examples';
+export { useThemeFlow } from './use-theme-flow';
+export { useThemeHistory } from './use-theme-history';
+export { useThemePaths } from './use-theme-paths';
+export { useThemeSnapshots } from './use-theme-snapshots';
+export { useTraceInsight } from './use-trace-insight';

package/dist/src/ee/signals/hooks/theme-query-guards.d.ts

@@ -0,0 +1,3 @@
+export declare function isNumericThemeId(themeId: string | undefined): themeId is string;
+export declare function requireNumericThemeId(themeId: string | undefined): string;
+export declare function requireSnapshotId(snapshotId: string | undefined): string;

package/dist/src/ee/signals/hooks/use-entity-learning-progress.d.ts

@@ -0,0 +1 @@
+export declare function useEntityLearningProgress(entityId: string | undefined, entityType: string, enabled?: boolean): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').EntityLearningProgressResponse, Error>;

package/dist/src/ee/signals/hooks/use-noise-examples.d.ts

@@ -0,0 +1,2 @@
+import { TraceSignalName } from '../types';
+export declare function useNoiseExamples(entityId: string, entityType: string, signalName: TraceSignalName | undefined, snapshotId: string | undefined, limit?: number, offset?: number): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').ThemeExamplesResponse, Error>;

package/dist/src/ee/signals/hooks/use-noise.d.ts

@@ -0,0 +1,2 @@
+import { TraceSignalName } from '../types';
+export declare function useNoise(entityId: string, entityType: string, signalName: TraceSignalName | undefined, snapshotId: string | undefined): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').NoiseResponse, Error>;

package/dist/src/ee/signals/hooks/use-snapshot-playback.d.ts

@@ -0,0 +1,9 @@
+type SnapshotPlaybackOptions<SnapshotCursor> = {
+    isPlaying: boolean;
+    isPlaybackBlocked: boolean;
+    nextSnapshot: SnapshotCursor | undefined;
+    onAdvance: (snapshot: SnapshotCursor | undefined) => void;
+    snapshotCount: number;
+};
+export declare function useSnapshotPlayback<SnapshotCursor>({ isPlaying, isPlaybackBlocked, nextSnapshot, onAdvance, snapshotCount, }: SnapshotPlaybackOptions<SnapshotCursor>): void;
+export {};

package/dist/src/ee/signals/hooks/use-theme-detail.d.ts

@@ -0,0 +1,2 @@
+import { TraceSignalName } from '../types';
+export declare function useThemeDetail(entityId: string, entityType: string, signalName: TraceSignalName, snapshotId: string | undefined, themeId: string | undefined): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').ThemeDetailResponse, Error>;

package/dist/src/ee/signals/hooks/use-theme-entities.d.ts

@@ -0,0 +1 @@
+export declare function useThemeEntities(entityType: string): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').ThemeEntitiesResponse, Error>;

package/dist/src/ee/signals/hooks/use-theme-examples.d.ts

@@ -0,0 +1,2 @@
+import { TraceSignalName } from '../types';
+export declare function useThemeExamples(entityId: string, entityType: string, signalName: TraceSignalName, snapshotId: string | undefined, themeId: string | undefined, limit?: number, offset?: number): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').ThemeExamplesResponse, Error>;

package/dist/src/ee/signals/hooks/use-theme-flow.d.ts

@@ -0,0 +1,2 @@
+import { TraceSignalName } from '../types';
+export declare function useThemeFlow(entityId: string, entityType: string, signalNames: TraceSignalName[], snapshotId: string | undefined): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').ThemeFlowResponse, Error>;

package/dist/src/ee/signals/hooks/use-theme-flows.d.ts

@@ -0,0 +1,2 @@
+import { TraceSignalName } from '../types';
+export declare function useThemeFlows(entityId: string, entityType: string, signalNames: TraceSignalName[], snapshotIds: string[]): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').ThemeFlowResponse, Error>[];

package/dist/src/ee/signals/hooks/use-theme-history.d.ts

@@ -0,0 +1,2 @@
+import { TraceSignalName } from '../types';
+export declare function useThemeHistory(entityId: string, entityType: string, signalName: TraceSignalName, themeId: string | undefined, limit?: number): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').ThemeHistoryResponse, Error>;

package/dist/src/ee/signals/hooks/use-theme-paths.d.ts

@@ -0,0 +1,2 @@
+import { TraceSignalName } from '../types';
+export declare function useThemePaths(entityId: string, entityType: string, signalNames: TraceSignalName[], snapshotId: string | undefined, themeId: string | undefined): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').ThemePathsResponse, Error>;

package/dist/src/ee/signals/hooks/use-theme-snapshots.d.ts

@@ -0,0 +1,2 @@
+import { TraceSignalName } from '../types';
+export declare function useThemeSnapshots(entityId: string, entityType: string, signalNames: TraceSignalName[], dateFrom?: Date, dateTo?: Date): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').ThemeSnapshotsResponse, Error>;

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

@@ -0,0 +1 @@
+export declare function useTraceInsight(traceId: string | undefined): import('@tanstack/react-query').UseQueryResult<import('@mastra/client-js').TraceInsightResponse, Error>;

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

@@ -1,2 +1,11 @@
 export * from './components';
+export * from './hooks';
+export * from './sankey-signals';
 export * from './signal-colors';
+export { SIGNAL_PROCESSING_ORDER } from './signal-formatting';
+export * from './signals-error-state';
+export * from './signals-loading-skeleton';
+export * from './trace-intelligence-context';
+export * from './trace-intelligence-provider';
+export * from './use-trace-intelligence';
+export type * from './types';

package/dist/src/ee/signals/lifeline-point.d.ts

@@ -0,0 +1,8 @@
+/** A theme-presence point with an instant portal tooltip. */
+export declare function LifelinePoint({ title, positionPercent, height, color, onSelect, }: {
+    title: string;
+    positionPercent: number | undefined;
+    height: number;
+    color: string;
+    onSelect: (() => void) | undefined;
+}): import("react").JSX.Element | null;

package/dist/src/ee/signals/lifeline-row.d.ts

@@ -0,0 +1,11 @@
+import { ThemeSelection } from './theme-drilldown-data';
+import { ThemeLifeline } from './theme-lifelines-data';
+import { ThemeSnapshot, TraceSignalName } from './types';
+export declare function LifelineRow({ row, signalName, snapshots, positions, hue, onThemeSelect, }: {
+    row: ThemeLifeline;
+    signalName: TraceSignalName;
+    snapshots: ThemeSnapshot[];
+    positions: number[];
+    hue: number;
+    onThemeSelect: (selection: ThemeSelection, snapshotIndex: number) => void;
+}): import("react").JSX.Element;

package/dist/src/ee/signals/noise-detail-panel.d.ts

@@ -0,0 +1,10 @@
+import { TraceSignalName } from './types';
+interface NoiseDetailPanelProps {
+    entityId: string;
+    entityType: string;
+    snapshotId: string;
+    signalName: TraceSignalName | undefined;
+    onClose: () => void;
+}
+export declare function NoiseDetailPanel({ entityId, entityType, snapshotId, signalName, onClose }: NoiseDetailPanelProps): import("react").JSX.Element;
+export {};

package/dist/src/ee/signals/sankey-signals-data.d.ts

@@ -0,0 +1,41 @@
+import { ThemeFlowResponse, ThemeSnapshot } from './types';
+import { SankeyChartColumn, SankeyChartRecord } from '../../ds/components/SankeyChart';
+type StableThemeFlowLink = ThemeFlowResponse['links'][number] & {
+    layoutTraceCount: number;
+};
+type StableThemeFlowResponse = Omit<ThemeFlowResponse, 'links'> & {
+    links: StableThemeFlowLink[];
+};
+export declare function getSignalRecordNodeId(record: SankeyChartRecord, column: SankeyChartColumn): string;
+export declare function getSignalRecordNodeLabel(record: SankeyChartRecord, column: SankeyChartColumn): string;
+export declare function getSignalRecordNodeValue(record: SankeyChartRecord, column: SankeyChartColumn): number;
+export declare function themeFlowToSankeyData(flow: ThemeFlowResponse): {
+    columns: SankeyChartColumn[];
+    records: SankeyChartRecord[];
+};
+export declare function buildSignalGraphSummary(flow: ThemeFlowResponse): {
+    columns: SankeyChartColumn[];
+    records: SankeyChartRecord[];
+};
+/**
+ * Snapshot ids whose flows the timeline needs right now: the selected landmark
+ * plus its previous and next playback neighbors (playback wraps around).
+ */
+export declare function selectFlowSnapshotIds(snapshots: Array<{
+    snapshotId: string;
+}>, selectedIndex: number): string[];
+/**
+ * Keeps node ordering and ribbon layout widths consistent across the playback
+ * window without inventing content: only nodes and links present in the
+ * current snapshot render (no zero-count ghosts from neighboring flows), but
+ * their order and layout weight come from the whole window so shared themes
+ * hold their position while scrubbing.
+ */
+export declare function stabilizeThemeFlow(flow: ThemeFlowResponse, windowFlows: ThemeFlowResponse[]): StableThemeFlowResponse;
+/**
+ * "Date · N traces · N themes" line rendered under the timeline in every view
+ * mode. Counts come from the charted flow (cohort stage totals), so a drilled
+ * flow reports the drilled subset; date-only while the flow is loading.
+ */
+export declare function snapshotSummaryLabel(snapshot: ThemeSnapshot, flow: ThemeFlowResponse | undefined): string;
+export {};

package/dist/src/ee/signals/sankey-signals.d.ts

@@ -0,0 +1,12 @@
+import { TraceSignalName } from './types';
+export interface SankeySignalsProps {
+    entityId: string;
+    entityType?: string;
+    signalNames: TraceSignalName[];
+    dateFrom?: Date;
+    dateTo?: Date;
+    height?: number;
+    /** Date range control rendered in line with the view mode tabs. */
+    dateRangePicker?: React.ReactNode;
+}
+export declare function SankeySignals({ entityId, entityType, signalNames: initialSignalNames, dateFrom, dateTo, height, dateRangePicker, }: SankeySignalsProps): import("react").JSX.Element;

package/dist/src/ee/signals/signal-delta-column.d.ts

@@ -0,0 +1,12 @@
+import { ThemeSelection } from './theme-drilldown-data';
+import { ThemeFlowResponse, TraceSignalName } from './types';
+export declare function SignalDeltaColumn({ signalName, fromFlow, toFlow, flows, positions, fromIndex, toIndex, onThemeSelect, }: {
+    signalName: TraceSignalName;
+    fromFlow: ThemeFlowResponse;
+    toFlow: ThemeFlowResponse;
+    flows: Array<ThemeFlowResponse | undefined>;
+    positions: number[];
+    fromIndex: number;
+    toIndex: number;
+    onThemeSelect: (selection: ThemeSelection, snapshotIndex: number) => void;
+}): import("react").JSX.Element;

package/dist/src/ee/signals/signal-formatting.d.ts

@@ -0,0 +1,15 @@
+import { TraceSignalName } from './types';
+/** Order signals are produced during an interaction. */
+export declare const SIGNAL_PROCESSING_ORDER: TraceSignalName[];
+export declare function formatSignalName(signalName: TraceSignalName): string;
+/** Plain-language meaning of each trace signal, shown wherever a signal heading appears. */
+export declare const SIGNAL_DESCRIPTIONS: Record<TraceSignalName, string>;
+/** Signal description lookup for callers that only hold an untyped column id. */
+export declare function getSignalDescription(signalName: string): string | undefined;
+export declare function traceLabel(count: number): string;
+export declare function themeLabel(count: number): string;
+/** "28 of 70 traces in this snapshot (40%)" — replaces the old "Stage share" stat. */
+export declare function shareSentence(traceCount: number, coverage: number): string;
+export declare function formatSnapshotDate(value: string): string;
+export declare function formatSnapshotCutoff(cutoffAt: string): string;
+export declare function formatSnapshotWindow(startedAt: string, endedAt: string): string;

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

@@ -0,0 +1,9 @@
+import { ThemeSelection } from './theme-drilldown-data';
+import { ThemeFlowResponse, ThemeSnapshot, TraceSignalName } from './types';
+export declare function SignalLifelines({ signalName, flows, snapshots, positions, onThemeSelect, }: {
+    signalName: TraceSignalName;
+    flows: Array<ThemeFlowResponse | undefined>;
+    snapshots: ThemeSnapshot[];
+    positions: number[];
+    onThemeSelect: (selection: ThemeSelection, snapshotIndex: number) => void;
+}): import("react").JSX.Element;

package/dist/src/ee/signals/signals-error-state.d.ts

@@ -0,0 +1,5 @@
+export declare function SignalsErrorState({ message, onRetry, onClear, }: {
+    message: string;
+    onRetry: () => void;
+    onClear?: () => void;
+}): import("react").JSX.Element;

package/dist/src/ee/signals/signals-loading-skeleton.d.ts

@@ -0,0 +1,2 @@
+export declare function SignalsFrameLoadingSkeleton(): import("react").JSX.Element;
+export declare function SignalsLoadingSkeleton(): import("react").JSX.Element;

package/dist/src/ee/signals/snapshot-timeline-data.d.ts

@@ -0,0 +1,12 @@
+import { ThemeSnapshot } from './types';
+/**
+ * Positions each landmark on a 0–100% time axis by its cutoff. Falls back to
+ * even index spacing when cutoffs are unavailable (older servers).
+ */
+export declare function timelineTickPositions(snapshots: ThemeSnapshot[]): number[];
+export declare function snapshotTickLabel(snapshot: ThemeSnapshot, totalCount: number): string;
+/**
+ * Day label ("07/24") for each tick whose cutoff starts a new day compared to
+ * the previous tick; undefined otherwise so the axis only marks day starts.
+ */
+export declare function timelineDayLabels(snapshots: ThemeSnapshot[]): Array<string | undefined>;

package/dist/src/ee/signals/snapshot-timeline.d.ts

@@ -0,0 +1,25 @@
+import { ThemeSnapshot } from './types';
+export type TimelineMarkerKind = 'selected' | 'compare-point';
+/**
+ * Time-axis landmark track shared by the flow timeline and compare mode. Each
+ * landmark renders as a tick placed proportionally to when its snapshot became
+ * the current state, with a day label under the first tick of each new day, so
+ * bursty capture times and quiet gaps stay legible.
+ */
+export declare function TimelineTrack({ snapshots, totalCount, markers, grabbedIndex, onTickSelect, }: {
+    snapshots: ThemeSnapshot[];
+    totalCount: number;
+    markers: ReadonlyMap<number, TimelineMarkerKind>;
+    /** Landmark index of a grabbed compare point — the next tick click moves it. */
+    grabbedIndex?: number;
+    onTickSelect: (index: number) => void;
+}): import("react").JSX.Element;
+export declare function SnapshotTimeline({ snapshots, selectedIndex, totalSnapshots, summary, isPlaying, onPlayingChange, onSnapshotChange, }: {
+    snapshots: ThemeSnapshot[];
+    selectedIndex: number;
+    totalSnapshots?: number;
+    summary: string;
+    isPlaying: boolean;
+    onPlayingChange: (isPlaying: boolean) => void;
+    onSnapshotChange: (index: number) => void;
+}): import("react").JSX.Element | null;

package/dist/src/ee/signals/sortable-signal-headers.d.ts

@@ -0,0 +1,6 @@
+import { TraceSignalName } from './types';
+export declare function SortableSignalHeaders({ signalNames, reorderDisabled, onOrderChange, }: {
+    signalNames: TraceSignalName[];
+    reorderDisabled: boolean;
+    onOrderChange: (signalNames: TraceSignalName[]) => void;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,24 @@
+import { ThemeFlowResponse, TraceSignalName } from './types';
+export type ThemeShareDelta = {
+    label: string;
+    /** The theme's id on whichever compared side still has the theme. */
+    themeId?: string;
+    /** Share of the signal's traces at point A (0..1). */
+    fromShare: number;
+    /** Share of the signal's traces at point B (0..1). */
+    toShare: number;
+    delta: number;
+    isNew: boolean;
+    isGone: boolean;
+};
+/**
+ * Per-theme share movement between two snapshots of one signal, largest
+ * absolute change first. Powers the compare-mode delta columns.
+ */
+export declare function computeThemeShareDeltas(fromFlow: ThemeFlowResponse, toFlow: ThemeFlowResponse, signalName: TraceSignalName, limit?: number): ThemeShareDelta[];
+/**
+ * Share of one theme across an ordered run of snapshot flows, for compare-mode
+ * sparklines. Entries align with the flows array; unloaded flows are skipped
+ * by passing undefined.
+ */
+export declare function themeShareSeries(flows: Array<ThemeFlowResponse | undefined>, signalName: TraceSignalName, label: string): Array<number | undefined>;

package/dist/src/ee/signals/theme-compare-sparkline.d.ts

@@ -0,0 +1,5 @@
+export declare function ThemeCompareSparkline({ series, positions, markerIndexes, }: {
+    series: Array<number | undefined>;
+    positions: number[];
+    markerIndexes: number[];
+}): import("react").JSX.Element | null;

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

@@ -0,0 +1,17 @@
+import { ThemeSelection } from './theme-drilldown-data';
+import { ThemeSnapshot, TraceSignalName } from './types';
+/**
+ * Compare mode: two interchangeable points on the shared time axis show how
+ * each signal's theme mix moved between them (always read earlier → later),
+ * with per-theme sparklines across every landmark in range. Clicking an
+ * unmarked landmark moves the nearest point; clicking a marked landmark grabs
+ * that point so the next click moves it specifically.
+ */
+export declare function ThemeCompare({ entityId, entityType, signalNames, snapshots, totalSnapshots, onThemeSelect, }: {
+    entityId: string;
+    entityType: string;
+    signalNames: TraceSignalName[];
+    snapshots: ThemeSnapshot[];
+    totalSnapshots: number;
+    onThemeSelect: (selection: ThemeSelection, snapshotIndex: number) => void;
+}): import("react").JSX.Element | null;

package/dist/src/ee/signals/theme-detail-panel.d.ts

@@ -0,0 +1,11 @@
+import { ThemeSelection } from './theme-drilldown-data';
+interface ThemeDetailPanelProps {
+    entityId: string;
+    entityType: string;
+    snapshotId: string;
+    snapshotTotal: number;
+    selection: ThemeSelection | undefined;
+    onClose: () => void;
+}
+export declare function ThemeDetailPanel({ entityId, entityType, snapshotId, snapshotTotal, selection, onClose, }: ThemeDetailPanelProps): import("react").JSX.Element;
+export {};

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

@@ -0,0 +1,10 @@
+import { ThemeFlowResponse, ThemePathsResponse, TraceSignalName } from './types';
+export type ThemeSelection = {
+    signalName: TraceSignalName;
+    themeId: string;
+    label: string;
+};
+export declare function findThemeSelection(flow: ThemeFlowResponse, signalName: string, nodeId: string | number): ThemeSelection | undefined;
+/** Resolves a chart node to its trace signal when the node is that stage's noise bucket. */
+export declare function findNoiseSelection(flow: ThemeFlowResponse, signalName: string, nodeId: string | number): TraceSignalName | undefined;
+export declare function buildDrilledThemeFlow(flow: ThemeFlowResponse, pathsResponse: ThemePathsResponse, selection: ThemeSelection): ThemeFlowResponse;

package/dist/src/ee/signals/theme-filter-banner.d.ts

@@ -0,0 +1,8 @@
+import { ThemeSelection } from './theme-drilldown-data';
+export declare function ThemeFilterBanner({ selection, filteredTraceCount, totalTraceCount, onViewDetails, onClear, }: {
+    selection: ThemeSelection;
+    filteredTraceCount?: number;
+    totalTraceCount: number;
+    onViewDetails: () => void;
+    onClear: () => void;
+}): import("react").JSX.Element;