@principal-ai/principal-view-core 0.11.9 → 0.12.0

package/dist/index.d.ts

@@ -1,49 +1,33 @@
 /**
  * @principal-ai/principal-view-core
- * Core logic and types for graph-based principal view framework
+ * Browser-safe exports (no Node.js dependencies)
+ *
+ * This is the main entry point for the package and only includes browser-compatible code.
+ * Includes types, canvas utilities, YAML parsing, and narrative rendering.
+ *
+ * BREAKING CHANGE (v0.12.0):
+ * The main export now only includes browser-safe functionality.
+ *
+ * For Node.js-specific functionality (file system, code generation, rules engine, etc.), use:
+ * import { ... } from '@principal-ai/principal-view-core/node'
+ *
+ * For explicit browser usage (same as main export):
+ * import { ... } from '@principal-ai/principal-view-core/browser'
  */
-export * from './types';
-export { EventProcessor } from './EventProcessor';
-export type { ProcessingResult } from './EventProcessor';
-export { ValidationEngine } from './ValidationEngine';
-export { ConfigurationValidator } from './ConfigurationValidator';
-export type { ConfigurationValidationError, ConfigurationValidationResult, } from './ConfigurationValidator';
-export { GraphInstrumentationHelper } from './helpers/GraphInstrumentationHelper';
-export { PathBasedEventProcessor } from './PathBasedEventProcessor';
-export type { LogEntry } from './PathBasedEventProcessor';
-export { PathMatcher } from './utils/PathMatcher';
-export { GraphConverter } from './utils/GraphConverter';
+export type { GraphConfiguration, NodeState, EdgeState, NodeTypeDefinition, EdgeTypeDefinition, Violation, GraphEvent, NodeEvent, EdgeEvent, StateEvent, ComponentLibrary, LogLevel, GraphMetrics, Warning, ValidationResult, EventStream, ConnectionRule, LibraryNodeComponent, LibraryEdgeComponent, ComponentActivityEvent, ComponentActionEvent, EdgeAnimationEvent, PathBasedEvent, JsonValue, JsonObject, } from './types';
+export type { ConfigurationFile, ConfigurationLoadResult } from './ConfigurationLoader';
 export * from './types/canvas';
 export { CanvasConverter } from './utils/CanvasConverter';
 export type { ReactFlowNode, ReactFlowEdge } from './utils/CanvasConverter';
-export { EventValidator, createValidatedEmitter, EventValidationError } from './telemetry/event-validator';
-export type { ValidationResult } from './telemetry/event-validator';
-export { analyzeCoverage } from './telemetry/coverage';
-export type { CoverageMetrics, NodeCoverage, CanvasNode as CoverageCanvasNode } from './telemetry/coverage';
-export { generateTypes, TypeScriptGenerator, generatorRegistry } from './codegen/type-generator';
-export type { CodegenOptions, CodegenResult, CodeGenerator } from './codegen/type-generator';
-export { traceToCanvas, traceToCanvasJson } from './utils/TraceToCanvas';
-export type { TraceSpan, TraceExport, TraceToCanvasOptions, TraceCanvasResult, } from './utils/TraceToCanvas';
-export { SessionManager } from './SessionManager';
-export type { SessionStatus, SessionResult, SessionMetadata, EventSession, CreateSessionOptions, EndSessionOptions, SessionChangeCallback, SessionManagerConfig, } from './SessionManager';
-export { EventRecorderService } from './EventRecorderService';
-export type { ProtocolMessageType, ProtocolMessage, SessionStartMessage, SessionEndMessage, LogMessage, LogBatchMessage, PingMessage, PongMessage, ErrorMessage, AckMessage, IncomingMessage, OutgoingMessage, RecordingMode, EventCallback, EventBatchCallback, ConnectionState, EventRecorderServiceConfig, } from './EventRecorderService';
-export { ConfigurationLoader } from './ConfigurationLoader';
-export type { ConfigurationFile, ConfigurationLoadResult } from './ConfigurationLoader';
 export { parseYaml, isYamlFile, getConfigNameFromFilename } from './utils/YamlParser';
 export type { YamlParseResult } from './utils/YamlParser';
-export { LibraryLoader } from './LibraryLoader';
-export { LibraryConverter } from './utils/LibraryConverter';
-export type { CreateNodeOptions, CreateEdgeOptions } from './utils/LibraryConverter';
-export type { FileSystemAdapter } from '@principal-ai/repository-abstraction';
-export { InMemoryFileSystemAdapter } from '@principal-ai/repository-abstraction';
-export * from './rules';
-export { renderNarrative, parseTemplate, selectScenario, matchesCondition, hasEventMatching, computeAggregates, evaluateAssertion, getNestedValue, setNestedValue, createNarrativeValidator, NarrativeValidator, } from './narrative';
-export type { NarrativeTemplate, NarrativeScenario, NarrativeMode, ScenarioCondition, ScenarioTemplate, Assertion, FlowDirective, LogTemplates, FormattingOptions, OtelEvent, OtelSignal, NarrativeContext, NarrativeResult, ScenarioMatchResult, SpanTreeNode, NarrativeValidationContext, NarrativeViolation, NarrativeValidationResult, } from './narrative';
+export { renderNarrative } from './narrative/template-renderer';
+export { parseTemplate } from './narrative/template-parser';
+export { selectScenario, matchesCondition, hasEventMatching, computeAggregates, evaluateAssertion, getNestedValue, setNestedValue, } from './narrative/scenario-matcher';
+export type { NarrativeTemplate, NarrativeScenario, NarrativeMode, ScenarioCondition, ScenarioTemplate, Assertion, FlowDirective, LogTemplates, FormattingOptions, OtelEvent, OtelSignal, NarrativeContext, NarrativeResult, ScenarioMatchResult, SpanTreeNode, } from './narrative/types';
+export type { OtelAttributes, OtelAttributeValue, OtelLog, OtelSpan, OtelResource, OtelSeverity, OtelSeverityText, OtelSeverityNumber, OtelSpanKind, OtelSpanStatus, } from './types/otel';
 export { CanvasDiscovery } from './discovery/CanvasDiscovery';
 export type { DiscoveredCanvas, DiscoveredExecution, CanvasDiscoveryResult, DiscoveryOptions, CanvasType, ExecutionType, DiscoveredCanvasWithContent, DiscoveredExecutionWithContent, CanvasDiscoveryResultWithContent, } from './discovery/types';
 export { ExecutionValidator, createExecutionValidator } from './execution/ExecutionValidator';
 export type { ExecutionData, ValidationError, ExecutionValidationResult, } from './execution/ExecutionValidator';
-export { ExecutionLoader, createExecutionLoader } from './execution/ExecutionLoader';
-export type { ExecutionFile, ExecutionLoadResult, } from './execution/ExecutionLoader';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,YAAY,EACV,kBAAkB,EAClB,SAAS,EACT,SAAS,EACT,kBAAkB,EAClB,kBAAkB,EAClB,SAAS,EACT,UAAU,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,SAAS,EACT,UAAU,GACX,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAGxF,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG5E,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACtF,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,YAAY,GACb,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAC;AAGtB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,2BAA2B,EAC3B,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC9F,YAAY,EACV,aAAa,EACb,eAAe,EACf,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC"}

package/dist/index.js

@@ -1,50 +1,50 @@
 /**
  * @principal-ai/principal-view-core
- * Core logic and types for graph-based principal view framework
+ * Browser-safe exports (no Node.js dependencies)
+ *
+ * This is the main entry point for the package and only includes browser-compatible code.
+ * Includes types, canvas utilities, YAML parsing, and narrative rendering.
+ *
+ * BREAKING CHANGE (v0.12.0):
+ * The main export now only includes browser-safe functionality.
+ *
+ * For Node.js-specific functionality (file system, code generation, rules engine, etc.), use:
+ * import { ... } from '@principal-ai/principal-view-core/node'
+ *
+ * For explicit browser usage (same as main export):
+ * import { ... } from '@principal-ai/principal-view-core/browser'
  */
-// Export all types
-export * from './types';
-// Export core classes
-export { EventProcessor } from './EventProcessor';
-export { ValidationEngine } from './ValidationEngine';
-export { ConfigurationValidator } from './ConfigurationValidator';
-// Export helpers
-export { GraphInstrumentationHelper } from './helpers/GraphInstrumentationHelper';
-// Export path-based processing (Milestone 1 & 2)
-export { PathBasedEventProcessor } from './PathBasedEventProcessor';
-// Export path utilities
-export { PathMatcher } from './utils/PathMatcher';
-export { GraphConverter } from './utils/GraphConverter';
 // Export Canvas types and converter
 export * from './types/canvas';
 export { CanvasConverter } from './utils/CanvasConverter';
-// Export telemetry event validation
-export { EventValidator, createValidatedEmitter, EventValidationError } from './telemetry/event-validator';
-// Export telemetry coverage analysis
-export { analyzeCoverage } from './telemetry/coverage';
-// Export code generation
-export { generateTypes, TypeScriptGenerator, generatorRegistry } from './codegen/type-generator';
-// Export trace-to-canvas conversion
-export { traceToCanvas, traceToCanvasJson } from './utils/TraceToCanvas';
-// Export session management (Event Recording System)
-export { SessionManager } from './SessionManager';
-// Export event recorder service
-export { EventRecorderService } from './EventRecorderService';
-// Export configuration loading (Phase 2: Multi-config support)
-export { ConfigurationLoader } from './ConfigurationLoader';
+// Export YAML parsing (browser-compatible)
 export { parseYaml, isYamlFile, getConfigNameFromFilename } from './utils/YamlParser';
-// Export component library support
-export { LibraryLoader } from './LibraryLoader';
-export { LibraryConverter } from './utils/LibraryConverter';
-export { InMemoryFileSystemAdapter } from '@principal-ai/repository-abstraction';
-// Export rules engine
-export * from './rules';
-// Export narrative template system
-export { renderNarrative, parseTemplate, selectScenario, matchesCondition, hasEventMatching, computeAggregates, evaluateAssertion, getNestedValue, setNestedValue, createNarrativeValidator, NarrativeValidator, } from './narrative';
-// Export canvas and execution discovery
+// Export narrative template system (browser-safe)
+// Import directly from files to avoid pulling in Node.js validator
+export { renderNarrative } from './narrative/template-renderer';
+export { parseTemplate } from './narrative/template-parser';
+export { selectScenario, matchesCondition, hasEventMatching, computeAggregates, evaluateAssertion, getNestedValue, setNestedValue, } from './narrative/scenario-matcher';
+// Export canvas and execution discovery (browser-safe)
 export { CanvasDiscovery } from './discovery/CanvasDiscovery';
-// Export execution validation
+// Export execution validation (browser-safe - no Node.js dependencies)
 export { ExecutionValidator, createExecutionValidator } from './execution/ExecutionValidator';
-// Export execution loading
-export { ExecutionLoader, createExecutionLoader } from './execution/ExecutionLoader';
+// NOTE: The following require Node.js dependencies and are NOT exported in the main bundle.
+// Use '@principal-ai/principal-view-core/node' for Node.js-specific functionality:
+//
+// - EventProcessor, ValidationEngine, ConfigurationValidator (Node.js processing)
+// - GraphInstrumentationHelper, PathBasedEventProcessor (Node.js utilities)
+// - PathMatcher, GraphConverter (Node.js utilities)
+// - EventValidator, createValidatedEmitter (Node.js telemetry)
+// - analyzeCoverage (file system - uses fs/promises, path, glob)
+// - generateTypes, TypeScriptGenerator, generatorRegistry (code generation - file system)
+// - traceToCanvas, traceToCanvasJson (trace utilities)
+// - SessionManager, EventRecorderService (session management)
+// - ConfigurationLoader, LibraryLoader (file system loaders)
+// - LibraryConverter (library utilities)
+// - Rules engine (OpenTelemetry dependencies)
+// - NarrativeValidator, createNarrativeValidator (Node.js validator)
+// - ExecutionLoader, createExecutionLoader (file system loader)
+//
+// Example:
+// import { ConfigurationLoader, analyzeCoverage } from '@principal-ai/principal-view-core/node';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mBAAmB;AACnB,cAAc,SAAS,CAAC;AAExB,sBAAsB;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAMlE,iBAAiB;AACjB,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAElF,iDAAiD;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,oCAAoC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,oCAAoC;AACpC,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAG3G,qCAAqC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,yBAAyB;AACzB,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGjG,oCAAoC;AACpC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQzE,qDAAqD;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYlD,gCAAgC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAqB9D,+DAA+D;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,mCAAmC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAK5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,sBAAsB;AACtB,cAAc,SAAS,CAAC;AAExB,mCAAmC;AACnC,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAsBrB,wCAAwC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAa9D,8BAA8B;AAC9B,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAO9F,2BAA2B;AAC3B,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAkCH,oCAAoC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,2CAA2C;AAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,kDAAkD;AAClD,mEAAmE;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,8BAA8B,CAAC;AAiCtC,uDAAuD;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAa9D,uEAAuE;AACvE,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAO9F,4FAA4F;AAC5F,mFAAmF;AACnF,EAAE;AACF,kFAAkF;AAClF,4EAA4E;AAC5E,oDAAoD;AACpD,+DAA+D;AAC/D,iEAAiE;AACjE,0FAA0F;AAC1F,uDAAuD;AACvD,8DAA8D;AAC9D,6DAA6D;AAC7D,yCAAyC;AACzC,8CAA8C;AAC9C,qEAAqE;AACrE,gEAAgE;AAChE,EAAE;AACF,WAAW;AACX,iGAAiG"}

package/dist/node.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @principal-ai/principal-view-core/node
+ * Node.js-specific exports (require Node.js runtime)
+ *
+ * This entry point includes all functionality that depends on Node.js modules
+ * such as fs, path, glob, and other Node.js-only dependencies.
+ *
+ * For browser environments, use:
+ * - '@principal-ai/principal-view-core/browser' for browser-safe functionality
+ *
+ * For Node.js environments, you can use either:
+ * - '@principal-ai/principal-view-core' for all functionality (browser + Node.js)
+ * - '@principal-ai/principal-view-core/node' for Node.js-specific functionality only
+ */
+export * from './types';
+export { EventProcessor } from './EventProcessor';
+export type { ProcessingResult } from './EventProcessor';
+export { ValidationEngine } from './ValidationEngine';
+export { ConfigurationValidator } from './ConfigurationValidator';
+export type { ConfigurationValidationError, ConfigurationValidationResult, } from './ConfigurationValidator';
+export { GraphInstrumentationHelper } from './helpers/GraphInstrumentationHelper';
+export { PathBasedEventProcessor } from './PathBasedEventProcessor';
+export type { LogEntry } from './PathBasedEventProcessor';
+export { PathMatcher } from './utils/PathMatcher';
+export { GraphConverter } from './utils/GraphConverter';
+export * from './types/canvas';
+export { CanvasConverter } from './utils/CanvasConverter';
+export type { ReactFlowNode, ReactFlowEdge } from './utils/CanvasConverter';
+export { EventValidator, createValidatedEmitter, EventValidationError } from './telemetry/event-validator';
+export type { ValidationResult } from './telemetry/event-validator';
+export { analyzeCoverage } from './telemetry/coverage';
+export type { CoverageMetrics, NodeCoverage, CanvasNode as CoverageCanvasNode } from './telemetry/coverage';
+export { generateTypes, TypeScriptGenerator, generatorRegistry } from './codegen/type-generator';
+export type { CodegenOptions, CodegenResult, CodeGenerator } from './codegen/type-generator';
+export { traceToCanvas, traceToCanvasJson } from './utils/TraceToCanvas';
+export type { TraceSpan, TraceExport, TraceToCanvasOptions, TraceCanvasResult, } from './utils/TraceToCanvas';
+export { SessionManager } from './SessionManager';
+export type { SessionStatus, SessionResult, SessionMetadata, EventSession, CreateSessionOptions, EndSessionOptions, SessionChangeCallback, SessionManagerConfig, } from './SessionManager';
+export { EventRecorderService } from './EventRecorderService';
+export type { ProtocolMessageType, ProtocolMessage, SessionStartMessage, SessionEndMessage, LogMessage, LogBatchMessage, PingMessage, PongMessage, ErrorMessage, AckMessage, IncomingMessage, OutgoingMessage, RecordingMode, EventCallback, EventBatchCallback, ConnectionState, EventRecorderServiceConfig, } from './EventRecorderService';
+export { ConfigurationLoader } from './ConfigurationLoader';
+export type { ConfigurationFile, ConfigurationLoadResult } from './ConfigurationLoader';
+export { parseYaml, isYamlFile, getConfigNameFromFilename } from './utils/YamlParser';
+export type { YamlParseResult } from './utils/YamlParser';
+export { LibraryLoader } from './LibraryLoader';
+export { LibraryConverter } from './utils/LibraryConverter';
+export type { CreateNodeOptions, CreateEdgeOptions } from './utils/LibraryConverter';
+export type { FileSystemAdapter } from '@principal-ai/repository-abstraction';
+export { InMemoryFileSystemAdapter } from '@principal-ai/repository-abstraction';
+export * from './rules';
+export { renderNarrative, parseTemplate, selectScenario, matchesCondition, hasEventMatching, computeAggregates, evaluateAssertion, getNestedValue, setNestedValue, createNarrativeValidator, NarrativeValidator, } from './narrative';
+export type { NarrativeTemplate, NarrativeScenario, NarrativeMode, ScenarioCondition, ScenarioTemplate, Assertion, FlowDirective, LogTemplates, FormattingOptions, OtelEvent, OtelSignal, NarrativeContext, NarrativeResult, ScenarioMatchResult, SpanTreeNode, NarrativeValidationContext, NarrativeViolation, NarrativeValidationResult, } from './narrative';
+export { CanvasDiscovery } from './discovery/CanvasDiscovery';
+export type { DiscoveredCanvas, DiscoveredExecution, CanvasDiscoveryResult, DiscoveryOptions, CanvasType, ExecutionType, DiscoveredCanvasWithContent, DiscoveredExecutionWithContent, CanvasDiscoveryResultWithContent, } from './discovery/types';
+export { ExecutionValidator, createExecutionValidator } from './execution/ExecutionValidator';
+export type { ExecutionData, ValidationError, ExecutionValidationResult, } from './execution/ExecutionValidator';
+export { ExecutionLoader, createExecutionLoader } from './execution/ExecutionLoader';
+export type { ExecutionFile, ExecutionLoadResult, } from './execution/ExecutionLoader';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

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

package/dist/node.js

@@ -0,0 +1,60 @@
+/**
+ * @principal-ai/principal-view-core/node
+ * Node.js-specific exports (require Node.js runtime)
+ *
+ * This entry point includes all functionality that depends on Node.js modules
+ * such as fs, path, glob, and other Node.js-only dependencies.
+ *
+ * For browser environments, use:
+ * - '@principal-ai/principal-view-core/browser' for browser-safe functionality
+ *
+ * For Node.js environments, you can use either:
+ * - '@principal-ai/principal-view-core' for all functionality (browser + Node.js)
+ * - '@principal-ai/principal-view-core/node' for Node.js-specific functionality only
+ */
+// Export all types (safe in all environments)
+export * from './types';
+// Export core classes (Node.js processing)
+export { EventProcessor } from './EventProcessor';
+export { ValidationEngine } from './ValidationEngine';
+export { ConfigurationValidator } from './ConfigurationValidator';
+// Export helpers
+export { GraphInstrumentationHelper } from './helpers/GraphInstrumentationHelper';
+// Export path-based processing (Milestone 1 & 2)
+export { PathBasedEventProcessor } from './PathBasedEventProcessor';
+// Export path utilities
+export { PathMatcher } from './utils/PathMatcher';
+export { GraphConverter } from './utils/GraphConverter';
+// Export Canvas types and converter
+export * from './types/canvas';
+export { CanvasConverter } from './utils/CanvasConverter';
+// Export telemetry event validation
+export { EventValidator, createValidatedEmitter, EventValidationError } from './telemetry/event-validator';
+// Export telemetry coverage analysis (Node.js only - uses fs/promises, path, glob)
+export { analyzeCoverage } from './telemetry/coverage';
+// Export code generation (Node.js only - file system operations)
+export { generateTypes, TypeScriptGenerator, generatorRegistry } from './codegen/type-generator';
+// Export trace-to-canvas conversion
+export { traceToCanvas, traceToCanvasJson } from './utils/TraceToCanvas';
+// Export session management (Event Recording System)
+export { SessionManager } from './SessionManager';
+// Export event recorder service
+export { EventRecorderService } from './EventRecorderService';
+// Export configuration loading (Node.js only - file system)
+export { ConfigurationLoader } from './ConfigurationLoader';
+export { parseYaml, isYamlFile, getConfigNameFromFilename } from './utils/YamlParser';
+// Export component library support (Node.js only - file system)
+export { LibraryLoader } from './LibraryLoader';
+export { LibraryConverter } from './utils/LibraryConverter';
+export { InMemoryFileSystemAdapter } from '@principal-ai/repository-abstraction';
+// Export rules engine (Node.js only - OpenTelemetry dependencies)
+export * from './rules';
+// Export narrative template system (full system including Node.js validator)
+export { renderNarrative, parseTemplate, selectScenario, matchesCondition, hasEventMatching, computeAggregates, evaluateAssertion, getNestedValue, setNestedValue, createNarrativeValidator, NarrativeValidator, } from './narrative';
+// Export canvas and execution discovery
+export { CanvasDiscovery } from './discovery/CanvasDiscovery';
+// Export execution validation
+export { ExecutionValidator, createExecutionValidator } from './execution/ExecutionValidator';
+// Export execution loading (Node.js only - file system)
+export { ExecutionLoader, createExecutionLoader } from './execution/ExecutionLoader';
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,8CAA8C;AAC9C,cAAc,SAAS,CAAC;AAExB,2CAA2C;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAMlE,iBAAiB;AACjB,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAElF,iDAAiD;AACjD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,oCAAoC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,oCAAoC;AACpC,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAG3G,mFAAmF;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,iEAAiE;AACjE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGjG,oCAAoC;AACpC,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAQzE,qDAAqD;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYlD,gCAAgC;AAChC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAqB9D,4DAA4D;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,gEAAgE;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAK5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,kEAAkE;AAClE,cAAc,SAAS,CAAC;AAExB,6EAA6E;AAC7E,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAsBrB,wCAAwC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAa9D,8BAA8B;AAC9B,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAO9F,wDAAwD;AACxD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principal-ai/principal-view-core",
-  "version": "0.11.9",
+  "version": "0.12.0",
   "description": "Core logic and types for graph-based principal view framework",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,6 +16,12 @@
       "import": "./dist/browser.js",
       "require": "./dist/browser.js",
       "default": "./dist/browser.js"
+    },
+    "./node": {
+      "types": "./dist/node.d.ts",
+      "import": "./dist/node.js",
+      "require": "./dist/node.js",
+      "default": "./dist/node.js"
     }
   },
   "files": [

package/src/index.ts

@@ -1,117 +1,66 @@
 /**
  * @principal-ai/principal-view-core
- * Core logic and types for graph-based principal view framework
+ * Browser-safe exports (no Node.js dependencies)
+ *
+ * This is the main entry point for the package and only includes browser-compatible code.
+ * Includes types, canvas utilities, YAML parsing, and narrative rendering.
+ *
+ * BREAKING CHANGE (v0.12.0):
+ * The main export now only includes browser-safe functionality.
+ *
+ * For Node.js-specific functionality (file system, code generation, rules engine, etc.), use:
+ * import { ... } from '@principal-ai/principal-view-core/node'
+ *
+ * For explicit browser usage (same as main export):
+ * import { ... } from '@principal-ai/principal-view-core/browser'
  */
 
-// Export all types
-export * from './types';
-
-// Export core classes
-export { EventProcessor } from './EventProcessor';
-export type { ProcessingResult } from './EventProcessor';
-
-export { ValidationEngine } from './ValidationEngine';
-
-export { ConfigurationValidator } from './ConfigurationValidator';
+// Export essential types only
 export type {
-  ConfigurationValidationError,
-  ConfigurationValidationResult,
-} from './ConfigurationValidator';
-
-// Export helpers
-export { GraphInstrumentationHelper } from './helpers/GraphInstrumentationHelper';
-
-// Export path-based processing (Milestone 1 & 2)
-export { PathBasedEventProcessor } from './PathBasedEventProcessor';
-export type { LogEntry } from './PathBasedEventProcessor';
-
-// Export path utilities
-export { PathMatcher } from './utils/PathMatcher';
-export { GraphConverter } from './utils/GraphConverter';
+  GraphConfiguration,
+  NodeState,
+  EdgeState,
+  NodeTypeDefinition,
+  EdgeTypeDefinition,
+  Violation,
+  GraphEvent,
+  NodeEvent,
+  EdgeEvent,
+  StateEvent,
+  ComponentLibrary,
+  LogLevel,
+  GraphMetrics,
+  Warning,
+  ValidationResult,
+  EventStream,
+  ConnectionRule,
+  LibraryNodeComponent,
+  LibraryEdgeComponent,
+  ComponentActivityEvent,
+  ComponentActionEvent,
+  EdgeAnimationEvent,
+  PathBasedEvent,
+  JsonValue,
+  JsonObject,
+} from './types';
+
+// Export types from ConfigurationLoader (interfaces only, no implementation)
+export type { ConfigurationFile, ConfigurationLoadResult } from './ConfigurationLoader';
 
 // Export Canvas types and converter
 export * from './types/canvas';
 export { CanvasConverter } from './utils/CanvasConverter';
 export type { ReactFlowNode, ReactFlowEdge } from './utils/CanvasConverter';
 
-// Export telemetry event validation
-export { EventValidator, createValidatedEmitter, EventValidationError } from './telemetry/event-validator';
-export type { ValidationResult } from './telemetry/event-validator';
-
-// Export telemetry coverage analysis
-export { analyzeCoverage } from './telemetry/coverage';
-export type { CoverageMetrics, NodeCoverage, CanvasNode as CoverageCanvasNode } from './telemetry/coverage';
-
-// Export code generation
-export { generateTypes, TypeScriptGenerator, generatorRegistry } from './codegen/type-generator';
-export type { CodegenOptions, CodegenResult, CodeGenerator } from './codegen/type-generator';
-
-// Export trace-to-canvas conversion
-export { traceToCanvas, traceToCanvasJson } from './utils/TraceToCanvas';
-export type {
-  TraceSpan,
-  TraceExport,
-  TraceToCanvasOptions,
-  TraceCanvasResult,
-} from './utils/TraceToCanvas';
-
-// Export session management (Event Recording System)
-export { SessionManager } from './SessionManager';
-export type {
-  SessionStatus,
-  SessionResult,
-  SessionMetadata,
-  EventSession,
-  CreateSessionOptions,
-  EndSessionOptions,
-  SessionChangeCallback,
-  SessionManagerConfig,
-} from './SessionManager';
-
-// Export event recorder service
-export { EventRecorderService } from './EventRecorderService';
-export type {
-  ProtocolMessageType,
-  ProtocolMessage,
-  SessionStartMessage,
-  SessionEndMessage,
-  LogMessage,
-  LogBatchMessage,
-  PingMessage,
-  PongMessage,
-  ErrorMessage,
-  AckMessage,
-  IncomingMessage,
-  OutgoingMessage,
-  RecordingMode,
-  EventCallback,
-  EventBatchCallback,
-  ConnectionState,
-  EventRecorderServiceConfig,
-} from './EventRecorderService';
-
-// Export configuration loading (Phase 2: Multi-config support)
-export { ConfigurationLoader } from './ConfigurationLoader';
-export type { ConfigurationFile, ConfigurationLoadResult } from './ConfigurationLoader';
+// Export YAML parsing (browser-compatible)
 export { parseYaml, isYamlFile, getConfigNameFromFilename } from './utils/YamlParser';
 export type { YamlParseResult } from './utils/YamlParser';
 
-// Export component library support
-export { LibraryLoader } from './LibraryLoader';
-export { LibraryConverter } from './utils/LibraryConverter';
-export type { CreateNodeOptions, CreateEdgeOptions } from './utils/LibraryConverter';
-
-// Re-export FileSystemAdapter from repository-abstraction
-export type { FileSystemAdapter } from '@principal-ai/repository-abstraction';
-export { InMemoryFileSystemAdapter } from '@principal-ai/repository-abstraction';
-
-// Export rules engine
-export * from './rules';
-
-// Export narrative template system
+// Export narrative template system (browser-safe)
+// Import directly from files to avoid pulling in Node.js validator
+export { renderNarrative } from './narrative/template-renderer';
+export { parseTemplate } from './narrative/template-parser';
 export {
-  renderNarrative,
-  parseTemplate,
   selectScenario,
   matchesCondition,
   hasEventMatching,
@@ -119,9 +68,7 @@ export {
   evaluateAssertion,
   getNestedValue,
   setNestedValue,
-  createNarrativeValidator,
-  NarrativeValidator,
-} from './narrative';
+} from './narrative/scenario-matcher';
 export type {
   NarrativeTemplate,
   NarrativeScenario,
@@ -138,12 +85,23 @@ export type {
   NarrativeResult,
   ScenarioMatchResult,
   SpanTreeNode,
-  NarrativeValidationContext,
-  NarrativeViolation,
-  NarrativeValidationResult,
-} from './narrative';
+} from './narrative/types';
 
-// Export canvas and execution discovery
+// Export OTEL types
+export type {
+  OtelAttributes,
+  OtelAttributeValue,
+  OtelLog,
+  OtelSpan,
+  OtelResource,
+  OtelSeverity,
+  OtelSeverityText,
+  OtelSeverityNumber,
+  OtelSpanKind,
+  OtelSpanStatus,
+} from './types/otel';
+
+// Export canvas and execution discovery (browser-safe)
 export { CanvasDiscovery } from './discovery/CanvasDiscovery';
 export type {
   DiscoveredCanvas,
@@ -157,7 +115,7 @@ export type {
   CanvasDiscoveryResultWithContent,
 } from './discovery/types';
 
-// Export execution validation
+// Export execution validation (browser-safe - no Node.js dependencies)
 export { ExecutionValidator, createExecutionValidator } from './execution/ExecutionValidator';
 export type {
   ExecutionData,
@@ -165,9 +123,22 @@ export type {
   ExecutionValidationResult,
 } from './execution/ExecutionValidator';
 
-// Export execution loading
-export { ExecutionLoader, createExecutionLoader } from './execution/ExecutionLoader';
-export type {
-  ExecutionFile,
-  ExecutionLoadResult,
-} from './execution/ExecutionLoader';
+// NOTE: The following require Node.js dependencies and are NOT exported in the main bundle.
+// Use '@principal-ai/principal-view-core/node' for Node.js-specific functionality:
+//
+// - EventProcessor, ValidationEngine, ConfigurationValidator (Node.js processing)
+// - GraphInstrumentationHelper, PathBasedEventProcessor (Node.js utilities)
+// - PathMatcher, GraphConverter (Node.js utilities)
+// - EventValidator, createValidatedEmitter (Node.js telemetry)
+// - analyzeCoverage (file system - uses fs/promises, path, glob)
+// - generateTypes, TypeScriptGenerator, generatorRegistry (code generation - file system)
+// - traceToCanvas, traceToCanvasJson (trace utilities)
+// - SessionManager, EventRecorderService (session management)
+// - ConfigurationLoader, LibraryLoader (file system loaders)
+// - LibraryConverter (library utilities)
+// - Rules engine (OpenTelemetry dependencies)
+// - NarrativeValidator, createNarrativeValidator (Node.js validator)
+// - ExecutionLoader, createExecutionLoader (file system loader)
+//
+// Example:
+// import { ConfigurationLoader, analyzeCoverage } from '@principal-ai/principal-view-core/node';

package/src/node.ts

@@ -0,0 +1,183 @@
+/**
+ * @principal-ai/principal-view-core/node
+ * Node.js-specific exports (require Node.js runtime)
+ *
+ * This entry point includes all functionality that depends on Node.js modules
+ * such as fs, path, glob, and other Node.js-only dependencies.
+ *
+ * For browser environments, use:
+ * - '@principal-ai/principal-view-core/browser' for browser-safe functionality
+ *
+ * For Node.js environments, you can use either:
+ * - '@principal-ai/principal-view-core' for all functionality (browser + Node.js)
+ * - '@principal-ai/principal-view-core/node' for Node.js-specific functionality only
+ */
+
+// Export all types (safe in all environments)
+export * from './types';
+
+// Export core classes (Node.js processing)
+export { EventProcessor } from './EventProcessor';
+export type { ProcessingResult } from './EventProcessor';
+
+export { ValidationEngine } from './ValidationEngine';
+
+export { ConfigurationValidator } from './ConfigurationValidator';
+export type {
+  ConfigurationValidationError,
+  ConfigurationValidationResult,
+} from './ConfigurationValidator';
+
+// Export helpers
+export { GraphInstrumentationHelper } from './helpers/GraphInstrumentationHelper';
+
+// Export path-based processing (Milestone 1 & 2)
+export { PathBasedEventProcessor } from './PathBasedEventProcessor';
+export type { LogEntry } from './PathBasedEventProcessor';
+
+// Export path utilities
+export { PathMatcher } from './utils/PathMatcher';
+export { GraphConverter } from './utils/GraphConverter';
+
+// Export Canvas types and converter
+export * from './types/canvas';
+export { CanvasConverter } from './utils/CanvasConverter';
+export type { ReactFlowNode, ReactFlowEdge } from './utils/CanvasConverter';
+
+// Export telemetry event validation
+export { EventValidator, createValidatedEmitter, EventValidationError } from './telemetry/event-validator';
+export type { ValidationResult } from './telemetry/event-validator';
+
+// Export telemetry coverage analysis (Node.js only - uses fs/promises, path, glob)
+export { analyzeCoverage } from './telemetry/coverage';
+export type { CoverageMetrics, NodeCoverage, CanvasNode as CoverageCanvasNode } from './telemetry/coverage';
+
+// Export code generation (Node.js only - file system operations)
+export { generateTypes, TypeScriptGenerator, generatorRegistry } from './codegen/type-generator';
+export type { CodegenOptions, CodegenResult, CodeGenerator } from './codegen/type-generator';
+
+// Export trace-to-canvas conversion
+export { traceToCanvas, traceToCanvasJson } from './utils/TraceToCanvas';
+export type {
+  TraceSpan,
+  TraceExport,
+  TraceToCanvasOptions,
+  TraceCanvasResult,
+} from './utils/TraceToCanvas';
+
+// Export session management (Event Recording System)
+export { SessionManager } from './SessionManager';
+export type {
+  SessionStatus,
+  SessionResult,
+  SessionMetadata,
+  EventSession,
+  CreateSessionOptions,
+  EndSessionOptions,
+  SessionChangeCallback,
+  SessionManagerConfig,
+} from './SessionManager';
+
+// Export event recorder service
+export { EventRecorderService } from './EventRecorderService';
+export type {
+  ProtocolMessageType,
+  ProtocolMessage,
+  SessionStartMessage,
+  SessionEndMessage,
+  LogMessage,
+  LogBatchMessage,
+  PingMessage,
+  PongMessage,
+  ErrorMessage,
+  AckMessage,
+  IncomingMessage,
+  OutgoingMessage,
+  RecordingMode,
+  EventCallback,
+  EventBatchCallback,
+  ConnectionState,
+  EventRecorderServiceConfig,
+} from './EventRecorderService';
+
+// Export configuration loading (Node.js only - file system)
+export { ConfigurationLoader } from './ConfigurationLoader';
+export type { ConfigurationFile, ConfigurationLoadResult } from './ConfigurationLoader';
+export { parseYaml, isYamlFile, getConfigNameFromFilename } from './utils/YamlParser';
+export type { YamlParseResult } from './utils/YamlParser';
+
+// Export component library support (Node.js only - file system)
+export { LibraryLoader } from './LibraryLoader';
+export { LibraryConverter } from './utils/LibraryConverter';
+export type { CreateNodeOptions, CreateEdgeOptions } from './utils/LibraryConverter';
+
+// Re-export FileSystemAdapter from repository-abstraction
+export type { FileSystemAdapter } from '@principal-ai/repository-abstraction';
+export { InMemoryFileSystemAdapter } from '@principal-ai/repository-abstraction';
+
+// Export rules engine (Node.js only - OpenTelemetry dependencies)
+export * from './rules';
+
+// Export narrative template system (full system including Node.js validator)
+export {
+  renderNarrative,
+  parseTemplate,
+  selectScenario,
+  matchesCondition,
+  hasEventMatching,
+  computeAggregates,
+  evaluateAssertion,
+  getNestedValue,
+  setNestedValue,
+  createNarrativeValidator,
+  NarrativeValidator,
+} from './narrative';
+export type {
+  NarrativeTemplate,
+  NarrativeScenario,
+  NarrativeMode,
+  ScenarioCondition,
+  ScenarioTemplate,
+  Assertion,
+  FlowDirective,
+  LogTemplates,
+  FormattingOptions,
+  OtelEvent,
+  OtelSignal,
+  NarrativeContext,
+  NarrativeResult,
+  ScenarioMatchResult,
+  SpanTreeNode,
+  NarrativeValidationContext,
+  NarrativeViolation,
+  NarrativeValidationResult,
+} from './narrative';
+
+// Export canvas and execution discovery
+export { CanvasDiscovery } from './discovery/CanvasDiscovery';
+export type {
+  DiscoveredCanvas,
+  DiscoveredExecution,
+  CanvasDiscoveryResult,
+  DiscoveryOptions,
+  CanvasType,
+  ExecutionType,
+  DiscoveredCanvasWithContent,
+  DiscoveredExecutionWithContent,
+  CanvasDiscoveryResultWithContent,
+} from './discovery/types';
+
+// Export execution validation
+export { ExecutionValidator, createExecutionValidator } from './execution/ExecutionValidator';
+export type {
+  ExecutionData,
+  ValidationError,
+  ExecutionValidationResult,
+} from './execution/ExecutionValidator';
+
+// Export execution loading (Node.js only - file system)
+export { ExecutionLoader, createExecutionLoader } from './execution/ExecutionLoader';
+export type {
+  ExecutionFile,
+  ExecutionLoadResult,
+} from './execution/ExecutionLoader';