@industry-theme/principal-view-panels 0.11.1 → 0.11.3

package/dist/types/index.d.ts

@@ -4,4 +4,65 @@
  * Re-exports core types from @principal-ade/panel-framework-core
  */
 export type { DataSlice, WorkspaceMetadata, RepositoryMetadata, FileTreeSource, ActiveFileSlice, PanelEventType, PanelEvent, PanelEventEmitter, PanelActions, PanelContextValue, PanelComponentProps, PanelMetadata, PanelLifecycleHooks, PanelDefinition, PanelModule, PanelRegistryEntry, PanelLoader, PanelRegistryConfig, } from '@principal-ade/panel-framework-core';
+import type { PanelActions, PanelComponentProps, DataSlice } from '@principal-ade/panel-framework-core';
+import type { FileTree } from '@principal-ai/repository-abstraction';
+import type { VersionSnapshot } from '@principal-ai/principal-view-core';
+import type { RegisteredTrace } from './otel';
+/**
+ * Typed actions for panels that edit canvas files
+ */
+export interface CanvasEditorPanelActions extends PanelActions {
+    readFile: (path: string) => Promise<string>;
+}
+/**
+ * Typed context for CanvasEditorPanel
+ */
+export interface CanvasEditorPanelContext {
+    fileTree: DataSlice<FileTree>;
+}
+/**
+ * Typed panel props for CanvasEditorPanel
+ */
+export type CanvasEditorPanelPropsTyped = PanelComponentProps<CanvasEditorPanelActions, CanvasEditorPanelContext>;
+/**
+ * Typed context for WorkflowScenariosPanel
+ */
+export interface WorkflowScenariosPanelContext {
+    telemetry: DataSlice<RegisteredTrace[]>;
+}
+/**
+ * Typed panel props for WorkflowScenariosPanel
+ */
+export type WorkflowScenariosPanelPropsTyped = PanelComponentProps<PanelActions, WorkflowScenariosPanelContext>;
+/**
+ * Typed context for StoryboardListPanel
+ */
+export interface StoryboardListPanelContext {
+    fileTree: DataSlice<FileTree>;
+    git?: DataSlice<any>;
+}
+/**
+ * Typed panel props for StoryboardListPanel
+ */
+export type StoryboardListPanelPropsTyped = PanelComponentProps<PanelActions, StoryboardListPanelContext>;
+/**
+ * Typed actions for TraceListPanel
+ */
+export interface TraceListPanelActions extends PanelActions {
+    clearTelemetry?: () => Promise<void>;
+    readFile: (path: string) => Promise<string>;
+}
+/**
+ * Typed context for TraceListPanel
+ */
+export interface TraceListPanelContext {
+    telemetry: DataSlice<RegisteredTrace[]>;
+    schematics?: DataSlice<VersionSnapshot[]>;
+    fileTree?: DataSlice<FileTree>;
+    git?: DataSlice<any>;
+}
+/**
+ * Typed panel props for TraceListPanel
+ */
+export type TraceListPanelPropsTyped = PanelComponentProps<TraceListPanelActions, TraceListPanelContext>;
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAEV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,eAAe,EAGf,cAAc,EACd,UAAU,EACV,iBAAiB,EAGjB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EAGnB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,WAAW,EAGX,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,qCAAqC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAEV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,EACd,eAAe,EAGf,cAAc,EACd,UAAU,EACV,iBAAiB,EAGjB,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EAGnB,aAAa,EACb,mBAAmB,EACnB,eAAe,EACf,WAAW,EAGX,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,qCAAqC,CAAC;AAG7C,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,SAAS,EACV,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAM9C;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,YAAY;IAC5D,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,mBAAmB,CAC3D,wBAAwB,EACxB,wBAAwB,CACzB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,gCAAgC,GAAG,mBAAmB,CAChE,YAAY,EACZ,6BAA6B,CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG,mBAAmB,CAC7D,YAAY,EACZ,0BAA0B,CAC3B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC;IACxC,UAAU,CAAC,EAAE,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC;IAC1C,QAAQ,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC/B,GAAG,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,mBAAmB,CACxD,qBAAqB,EACrB,qBAAqB,CACtB,CAAC"}

package/dist/utils/traceHelpers.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Helper utilities for working with RegisteredTrace (new API)
+ *
+ * These helpers abstract away the complexity of the new multi-resource,
+ * multi-scope, three-category matching structure.
+ */
+import type { RegisteredTrace } from '@principal-ai/principal-view-core';
+/**
+ * Get primary service name from trace
+ * Uses first resource's serviceName
+ */
+export declare function getServiceName(trace: RegisteredTrace): string;
+/**
+ * Get all service names from trace (for multi-service traces)
+ */
+export declare function getAllServiceNames(trace: RegisteredTrace): string[];
+/**
+ * Get primary scope from trace
+ * Uses first resource's first scope
+ */
+export declare function getPrimaryScope(trace: RegisteredTrace): {
+    name: string;
+    version: string;
+} | null;
+/**
+ * Get all scopes from trace (across all resources)
+ */
+export declare function getAllScopes(trace: RegisteredTrace): Array<{
+    name: string;
+    version: string;
+}>;
+/**
+ * Check if trace has any matches (scenario or storyboard)
+ * Replaces: registryStatus === 'matched'
+ */
+export declare function isTraceMatched(trace: RegisteredTrace): boolean;
+/**
+ * Check if trace has full scenario matches
+ * More strict than isTraceMatched - requires actual scenario matches
+ */
+export declare function hasScenarioMatches(trace: RegisteredTrace): boolean;
+/**
+ * Get all scenario IDs that matched this trace
+ */
+export declare function getMatchedScenarioIds(trace: RegisteredTrace): string[];
+/**
+ * Get all storyboard IDs that matched this trace (from scenario matches)
+ */
+export declare function getMatchedStoryboardIds(trace: RegisteredTrace): string[];
+/**
+ * Get primary storyboard ID
+ * Returns first matched storyboard from scenario matches, then storyboard matches
+ */
+export declare function getPrimaryStoryboardId(trace: RegisteredTrace): string | null;
+/**
+ * Get primary scenario ID
+ * Returns first matched scenario ID
+ */
+export declare function getPrimaryScenarioId(trace: RegisteredTrace): string | null;
+/**
+ * Calculate matched nodes summary
+ * Replaces: trace.matchedNodesSummary
+ */
+export declare function getMatchedNodesSummary(trace: RegisteredTrace): {
+    totalNodes: number;
+    matchedNodes: number;
+    coveragePercent: number;
+};
+/**
+ * Filter traces by scenario ID
+ * Replaces: traces.filter(t => t.matchInfo?.scenarioId === scenarioId)
+ */
+export declare function filterTracesByScenario(traces: RegisteredTrace[], scenarioId: string): RegisteredTrace[];
+/**
+ * Filter traces by storyboard ID
+ */
+export declare function filterTracesByStoryboard(traces: RegisteredTrace[], storyboardId: string): RegisteredTrace[];
+/**
+ * Get match quality indicator
+ * Replaces: trace.registryStatus
+ */
+export declare function getMatchQuality(trace: RegisteredTrace): 'matched' | 'partial' | 'unmatched';
+/**
+ * Get scope version (schema version)
+ * Replaces: trace.scope.version or trace.matchInfo?.schemaVersion
+ */
+export declare function getSchemaVersion(trace: RegisteredTrace): string | null;
+/**
+ * Check if trace has validation issues
+ */
+export declare function hasValidationIssues(trace: RegisteredTrace): boolean;
+/**
+ * Get validation issues by severity
+ */
+export declare function getValidationIssuesBySeverity(trace: RegisteredTrace, severity: 'error' | 'warning' | 'info'): Array<{
+    category: string;
+    message: string;
+    suggestion?: string;
+}>;
+/**
+ * Create a grouping key for traces by service and scope
+ * Used for grouping traces in lists
+ */
+export declare function getTraceGroupKey(trace: RegisteredTrace): string;
+/**
+ * Get match info structure for backward compatibility
+ * Creates a structure similar to the old matchInfo for easier migration
+ */
+export declare function getMatchInfo(trace: RegisteredTrace): {
+    storyboardId: string | null;
+    scenarioId: string | null;
+    schemaVersion: string | null;
+    hasMatch: boolean;
+};
+//# sourceMappingURL=traceHelpers.d.ts.map

package/dist/utils/traceHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceHelpers.d.ts","sourceRoot":"","sources":["../../src/utils/traceHelpers.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAEzE;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CAEnE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOhG;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAa7F;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE9D;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAElE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CAEtE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CAOxE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAQ5E;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAK1E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG;IAC9D,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB,CA8BA;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,eAAe,EAAE,EACzB,UAAU,EAAE,MAAM,GACjB,eAAe,EAAE,CAInB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,eAAe,EAAE,EACzB,YAAY,EAAE,MAAM,GACnB,eAAe,EAAE,CAKnB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAQ3F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAGtE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GACrC,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAQnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAI/D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG;IACpD,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,OAAO,CAAC;CACnB,CASA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@industry-theme/principal-view-panels",
-  "version": "0.11.1",
+  "version": "0.11.3",
   "description": "Principal View Graph Panels for visualizing graph configurations from .principal-views/ folder as interactive diagrams",
   "type": "module",
   "main": "dist/panels.bundle.js",
@@ -52,18 +52,18 @@
     "build-storybook": "storybook build"
   },
   "peerDependencies": {
-    "@principal-ade/dynamic-file-tree": "^0.1.68",
+    "@principal-ade/dynamic-file-tree": "^0.1.69",
     "@principal-ade/industry-theme": "^0.1.7",
-    "@principal-ade/panel-framework-core": "^0.3.0",
+    "@principal-ade/panel-framework-core": "^0.4.2",
     "@principal-ade/utcp-panel-event": "^0.1.0",
     "@principal-ai/codebase-composition": "^0.2.43",
-    "@principal-ai/principal-view-core": "^0.24.0",
+    "@principal-ai/principal-view-core": "^0.24.11",
     "@principal-ai/repository-abstraction": "^0.5.7",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0"
   },
   "dependencies": {
-    "@principal-ai/principal-view-react": "0.13.4",
+    "@principal-ai/principal-view-react": "0.13.5",
     "@xyflow/react": "^12.0.0",
     "clsx": "^2.1.1",
     "framer-motion": "^11.0.0",
@@ -74,13 +74,13 @@
     "@chromatic-com/storybook": "^4.1.3",
     "@eslint/js": "^9.32.0",
     "@opentelemetry/api": "^1.9.0",
-    "@principal-ade/dynamic-file-tree": "^0.1.68",
+    "@principal-ade/dynamic-file-tree": "^0.1.69",
     "@principal-ade/industry-theme": "^0.1.7",
-    "@principal-ade/panel-framework-core": "^0.3.0",
+    "@principal-ade/panel-framework-core": "^0.4.2",
     "@principal-ade/panel-layouts": "^0.3.20",
     "@principal-ade/utcp-panel-event": "^0.1.0",
     "@principal-ai/codebase-composition": "^0.2.43",
-    "@principal-ai/principal-view-core": "^0.24.0",
+    "@principal-ai/principal-view-core": "^0.24.11",
     "@principal-ai/repository-abstraction": "^0.5.7",
     "@storybook/addon-docs": "10.1.2",
     "@storybook/addon-links": "10.1.2",

package/dist/utils/workflowMatching.d.ts

@@ -1,54 +0,0 @@
-/**
- * Workflow matching utilities for multi-workflow trace analysis
- *
- * @deprecated These utilities are deprecated in favor of registry-based matching in RegisteredTrace
- */
-import type { WorkflowTemplate, WorkflowMatch } from '@principal-ai/principal-view-core';
-import type { RegisteredTrace } from '../types/otel';
-export interface WorkflowMatchingResult {
-    matches: WorkflowMatch[];
-    unmatchedEventNames: string[];
-    totalEventCount: number;
-    matchedEventCount: number;
-}
-export interface WorkflowMetadata {
-    id: string;
-    storyboardId: string;
-    storyboardName: string;
-    template: WorkflowTemplate;
-}
-/**
- * Match a trace against multiple workflows to determine which workflows it touches
- *
- * This function:
- * 1. Converts trace spans to OtelEvents
- * 2. Runs renderWorkflow() against each workflow template
- * 3. Tracks which events matched vs unmatched
- * 4. Returns comprehensive matching results
- *
- * @deprecated Use registry-based matching in RegisteredTrace instead
- * @param trace - The trace to analyze
- * @param workflows - Array of workflows with metadata (from DiscoveredWorkflow)
- * @returns Matching results with matched workflows, unmatched events, and coverage metrics
- */
-export declare function matchTraceToWorkflows(trace: RegisteredTrace, workflows: WorkflowMetadata[]): WorkflowMatchingResult;
-/**
- * Enrich a trace with multi-workflow matching information
- *
- * This updates the trace object with matchedWorkflows, unmatchedEventNames, and totalEventCount
- *
- * @deprecated Use registry-based matching in RegisteredTrace instead
- * @param trace - The trace to enrich
- * @param workflows - Array of workflows with metadata to match against
- * @returns The enriched trace
- */
-export declare function enrichTraceWithWorkflowMatches(trace: RegisteredTrace, _workflows: WorkflowMetadata[]): RegisteredTrace;
-/**
- * Calculate coverage percentage for a trace
- *
- * @deprecated Use RegisteredTrace.matchedNodesSummary.coveragePercent instead
- * @param trace - Trace with workflow matching information
- * @returns Coverage percentage (0-100)
- */
-export declare function calculateCoveragePercentage(trace: RegisteredTrace): number;
-//# sourceMappingURL=workflowMatching.d.ts.map

package/dist/utils/workflowMatching.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"workflowMatching.d.ts","sourceRoot":"","sources":["../../src/utils/workflowMatching.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAyD,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAChJ,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAkCD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,gBAAgB,EAAE,GAC5B,sBAAsB,CAmExB;AAED;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,gBAAgB,EAAE,GAC7B,eAAe,CAIjB;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAE1E"}