@industry-theme/principal-view-panels 0.1.46 → 0.1.48

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import type { PanelDefinition } from './types';
 export { EventControllerPanel } from './panels/EventControllerPanel';
 export type { EventControllerPanelProps, PlaybackState, PlaybackStatus } from './panels/EventControllerPanel';
 export { TraceViewerPanel } from './panels/TraceViewerPanel';
+export { ExecutionViewerPanel } from './panels/ExecutionViewerPanel';
 export { PanelFileSystemAdapter } from './adapters/PanelFileSystemAdapter';
 export type { FileTreeEntry, PanelFileSystemAdapterOptions } from './adapters/PanelFileSystemAdapter';
 /**

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,SAAS,CAAC;AAIlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,YAAY,EAAE,yBAAyB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAG7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,aAAa,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAEtG;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,eAAe,EAiEnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,qBAGzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,qBAG3B,CAAC;AAEF;;;GAGG;AACH,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAqB,MAAM,SAAS,CAAC;AAIlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,YAAY,EAAE,yBAAyB,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE9G,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAGrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,YAAY,EAAE,aAAa,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAEtG;;;GAGG;AACH,eAAO,MAAM,MAAM,EAAE,eAAe,EA+FnC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,qBAGzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,qBAG3B,CAAC;AAEF;;;GAGG;AACH,OAAO,EACL,uBAAuB,EACvB,+BAA+B,EAC/B,aAAa,EACb,aAAa,EACb,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/dist/panels/ExecutionViewerPanel.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import type { PanelComponentProps } from '@principal-ade/panel-framework-core';
+/**
+ * Execution Viewer Panel
+ *
+ * Displays execution artifacts (test runs, traces) overlaid on their corresponding canvas diagrams.
+ * Reads execution files from __executions__/ directories and automatically links them to canvas files.
+ */
+export declare const ExecutionViewerPanel: React.FC<PanelComponentProps>;
+//# sourceMappingURL=ExecutionViewerPanel.d.ts.map

package/dist/panels/ExecutionViewerPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionViewerPanel.d.ts","sourceRoot":"","sources":["../../src/panels/ExecutionViewerPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmD,MAAM,OAAO,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AA8B/E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAkpB9D,CAAC"}

package/dist/panels/ExecutionViewerPanel.stories.d.ts

@@ -0,0 +1,61 @@
+import type { StoryObj } from '@storybook/react-vite';
+import React from 'react';
+/**
+ * ExecutionViewerPanel Component
+ *
+ * Visualizes execution artifacts (test runs) overlaid on canvas diagrams.
+ * It discovers execution artifact files from __executions__/ directories.
+ *
+ * Features:
+ * - Auto-discovery of execution artifacts from __executions__/ directories
+ * - Automatic linking to matching canvas files
+ * - Event playback with timeline controls
+ * - Side-by-side canvas and event visualization
+ * - Package badges for monorepo support
+ * - Metadata display (spans, events, framework, status)
+ */
+declare const meta: {
+    title: string;
+    component: React.FC<import("@principal-ade/panel-framework-core").PanelComponentProps>;
+    parameters: {
+        layout: string;
+        docs: {
+            description: {
+                component: string;
+            };
+        };
+    };
+    tags: string[];
+    decorators: ((Story: import("storybook/internal/csf").PartialStoryFn<import("@storybook/react").ReactRenderer, {
+        context: import("@principal-ade/panel-framework-core").PanelContextValue;
+        actions: import("@principal-ade/panel-framework-core").PanelActions;
+        events: import("@principal-ade/panel-framework-core").PanelEventEmitter;
+    }>) => import("react/jsx-runtime").JSX.Element)[];
+};
+export default meta;
+type Story = StoryObj<typeof meta>;
+/**
+ * Basic execution viewer with single execution artifact
+ */
+export declare const SingleExecution: Story;
+/**
+ * Multiple execution artifacts from different packages
+ */
+export declare const MultipleExecutions: Story;
+/**
+ * Execution with error status
+ */
+export declare const ExecutionWithError: Story;
+/**
+ * No execution artifacts found
+ */
+export declare const NoExecutions: Story;
+/**
+ * Execution without matching canvas
+ */
+export declare const ExecutionWithoutCanvas: Story;
+/**
+ * Legacy format (direct array without metadata)
+ */
+export declare const LegacyFormat: Story;
+//# sourceMappingURL=ExecutionViewerPanel.stories.d.ts.map

package/dist/panels/ExecutionViewerPanel.stories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionViewerPanel.stories.d.ts","sourceRoot":"","sources":["../../src/panels/ExecutionViewerPanel.stories.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAQ,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,IAAI;;;;;;;;;;;;;;;;;CAsBmC,CAAC;AAE9C,eAAe,IAAI,CAAC;AACpB,KAAK,KAAK,GAAG,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;AA2LnC;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,KAwB7B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAoChC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,KA2ChC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,KAkB1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,KAkBpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,KAwB1B,CAAC"}

package/dist/panels/execution-viewer/EventNodeMapper.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Event Node Mapper
+ *
+ * Maps execution events to canvas nodes based on OTEL metadata.
+ * Uses event schemas defined in canvas nodes to determine which node
+ * should be highlighted when an event is played back.
+ */
+import type { ExtendedCanvas } from '@principal-ai/principal-view-core';
+/**
+ * Event from execution artifact
+ */
+export interface ExecutionEvent {
+    name: string;
+    time: number;
+    attributes?: Record<string, string | number | boolean>;
+}
+/**
+ * Maps an execution event to a canvas node ID.
+ *
+ * Strategy:
+ * 1. Primary: Match event name to node's pv.events keys
+ * 2. Fallback: Match event attributes to node's pv.otel.resourceMatch
+ * 3. Default: Return null (no highlight)
+ *
+ * @param event - The execution event to map
+ * @param canvas - The canvas containing nodes with OTEL metadata
+ * @returns Node ID to highlight, or null if no match
+ */
+export declare function mapEventToNodeId(event: ExecutionEvent, canvas: ExtendedCanvas | null): string | null;
+/**
+ * Pre-builds a mapping of event names to node IDs for faster lookups.
+ * Useful when processing many events sequentially.
+ *
+ * @param canvas - The canvas to build the mapping from
+ * @returns Map of event name to node ID
+ */
+export declare function buildEventToNodeMap(canvas: ExtendedCanvas | null): Map<string, string>;
+/**
+ * Debug helper to show which events map to which nodes.
+ *
+ * @param canvas - The canvas to analyze
+ * @returns Human-readable mapping information
+ */
+export declare function debugEventMapping(canvas: ExtendedCanvas | null): string;
+//# sourceMappingURL=EventNodeMapper.d.ts.map

package/dist/panels/execution-viewer/EventNodeMapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventNodeMapper.d.ts","sourceRoot":"","sources":["../../../src/panels/execution-viewer/EventNodeMapper.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACxD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EACrB,MAAM,EAAE,cAAc,GAAG,IAAI,GAC5B,MAAM,GAAG,IAAI,CA4Cf;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,GAAG,IAAI,GAC5B,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBrB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,MAAM,CA2BvE"}

package/dist/panels/execution-viewer/ExecutionLoader.d.ts

@@ -0,0 +1,97 @@
+export interface ExecutionFile {
+    /** Unique identifier for this execution (derived from filename) */
+    id: string;
+    /** Display name for this execution */
+    name: string;
+    /** Full file path */
+    path: string;
+    /** Canvas basename (without extension) that this execution is linked to */
+    canvasBasename: string;
+    /** Package name for monorepos (e.g., 'core' from 'packages/core/__executions__/') */
+    packageName?: string;
+}
+export interface ExecutionMetadata {
+    /** Execution name */
+    name: string;
+    /** Canvas name this execution is associated with */
+    canvasName?: string;
+    /** Export timestamp */
+    exportedAt?: string;
+    /** Source of execution (e.g., "test:event-validation") */
+    source?: string;
+    /** Test framework used */
+    framework?: string;
+    /** Execution status */
+    status?: 'success' | 'error' | 'OK';
+    /** Number of spans */
+    spanCount: number;
+    /** Number of events across all spans */
+    eventCount: number;
+}
+export interface ExecutionSpan {
+    id: string;
+    name: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    status?: string;
+    attributes?: Record<string, any>;
+    events: Array<{
+        time: number;
+        name: string;
+        attributes?: Record<string, any>;
+    }>;
+}
+export interface ExecutionArtifact {
+    metadata?: {
+        canvasName?: string;
+        exportedAt?: string;
+        source?: string;
+        framework?: string;
+        status?: 'success' | 'error';
+    };
+    spans?: ExecutionSpan[];
+    [key: number]: ExecutionSpan;
+}
+/**
+ * Utility for loading and parsing execution artifact files from __executions__/ folders
+ */
+export declare class ExecutionLoader {
+    /**
+     * Parse JSON execution artifact content
+     */
+    static parseExecutionArtifact(content: string): ExecutionArtifact;
+    /**
+     * Get spans array from artifact (handles both formats)
+     */
+    static getSpans(artifact: ExecutionArtifact): ExecutionSpan[];
+    /**
+     * Extract metadata from an execution artifact
+     */
+    static getExecutionMetadata(artifact: ExecutionArtifact): ExecutionMetadata;
+    /**
+     * Find all execution artifact files in the file tree
+     */
+    static findExecutionFiles(files: Array<{
+        path?: string;
+        relativePath?: string;
+        name?: string;
+    }>): ExecutionFile[];
+    /**
+     * Find execution artifact for a given canvas file path
+     */
+    static findExecutionForCanvas(canvasPath: string, files: Array<{
+        path?: string;
+        relativePath?: string;
+        name?: string;
+    }>): ExecutionFile | null;
+    /**
+     * Find canvas file for a given execution artifact path
+     */
+    static findCanvasForExecution(executionPath: string, files: Array<{
+        path?: string;
+        relativePath?: string;
+        name?: string;
+    }>): string | null;
+}
+//# sourceMappingURL=ExecutionLoader.d.ts.map

package/dist/panels/execution-viewer/ExecutionLoader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionLoader.d.ts","sourceRoot":"","sources":["../../../src/panels/execution-viewer/ExecutionLoader.ts"],"names":[],"mappings":"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"}

package/dist/panels/execution-viewer/ExecutionStats.d.ts

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { ExecutionMetadata } from './ExecutionLoader';
+interface ExecutionStatsProps {
+    metadata: ExecutionMetadata;
+}
+/**
+ * Footer component displaying execution artifact metadata and statistics
+ */
+export declare const ExecutionStats: React.FC<ExecutionStatsProps>;
+export {};
+//# sourceMappingURL=ExecutionStats.d.ts.map

package/dist/panels/execution-viewer/ExecutionStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExecutionStats.d.ts","sourceRoot":"","sources":["../../../src/panels/execution-viewer/ExecutionStats.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,UAAU,mBAAmB;IAC3B,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CAmHxD,CAAC"}