@principal-ai/principal-view-core 0.5.6

package/dist/ValidationEngine.js

@@ -0,0 +1,158 @@
+/**
+ * ValidationEngine checks events against defined rules
+ */
+export class ValidationEngine {
+    constructor(rules) {
+        this.violationCount = 0;
+        this.warningCount = 0;
+        this.rules = rules;
+    }
+    /**
+     * Validate an event against all rules
+     */
+    validate(event, state) {
+        const violations = [];
+        const warnings = [];
+        // Check connection rules
+        if (event.category === 'edge' && event.operation === 'create') {
+            violations.push(...this.validateConnection(event, state));
+        }
+        // Check state transition rules
+        if (event.category === 'state') {
+            violations.push(...this.validateStateTransition(event, state));
+        }
+        // Check if event was expected
+        if (event.expected === false) {
+            violations.push(this.createUnexpectedEventViolation(event));
+        }
+        // Update counters
+        this.violationCount += violations.filter((v) => v.severity === 'error').length;
+        this.warningCount += violations.filter((v) => v.severity === 'warning').length;
+        return {
+            valid: violations.filter((v) => v.severity === 'error').length === 0,
+            violations,
+            warnings,
+            metrics: {
+                totalEvents: 1,
+                validEvents: violations.length === 0 ? 1 : 0,
+                violations: violations.filter((v) => v.severity === 'error').length,
+                warnings: violations.filter((v) => v.severity === 'warning').length,
+                unexpectedEvents: event.expected === false ? 1 : 0,
+                expectedEventsMissing: 0,
+            },
+        };
+    }
+    /**
+     * Check constraints across the entire graph state
+     */
+    checkConstraints(state) {
+        const violations = [];
+        // Check cardinality constraints
+        if (this.rules.cardinality) {
+            for (const [nodeType, rule] of Object.entries(this.rules.cardinality)) {
+                const count = Array.from(state.nodes.values()).filter((n) => n.type === nodeType).length;
+                if (rule.min !== undefined && count < rule.min) {
+                    violations.push({
+                        id: `cardinality-${nodeType}-min`,
+                        severity: 'error',
+                        type: 'cardinality',
+                        description: `Node type '${nodeType}' has ${count} instances but requires at least ${rule.min}`,
+                    });
+                }
+                if (rule.max !== undefined && count > rule.max) {
+                    violations.push({
+                        id: `cardinality-${nodeType}-max`,
+                        severity: 'error',
+                        type: 'cardinality',
+                        description: `Node type '${nodeType}' has ${count} instances but allows at most ${rule.max}`,
+                    });
+                }
+            }
+        }
+        return violations;
+    }
+    /**
+     * Validate connection rules
+     */
+    validateConnection(event, state) {
+        const violations = [];
+        const payload = event.payload;
+        // Get the nodes being connected
+        const fromNode = state.nodes.get(payload.from);
+        const toNode = state.nodes.get(payload.to);
+        if (!fromNode || !toNode) {
+            violations.push({
+                id: `connection-${event.id}`,
+                severity: 'error',
+                type: 'connection',
+                description: 'Cannot create edge: one or both nodes do not exist',
+                event,
+                context: {
+                    edgeId: payload.edgeId,
+                },
+            });
+            return violations;
+        }
+        // Check if this connection is allowed
+        const allowedConnections = state.configuration.allowedConnections || [];
+        const isAllowed = allowedConnections.some((rule) => rule.from === fromNode.type && rule.to === toNode.type && rule.via === payload.edgeType);
+        if (!isAllowed) {
+            violations.push({
+                id: `connection-${event.id}`,
+                severity: 'error',
+                type: 'connection',
+                description: `Connection from '${fromNode.type}' to '${toNode.type}' via '${payload.edgeType}' is not allowed`,
+                event,
+                context: {
+                    edgeId: payload.edgeId,
+                },
+            });
+        }
+        return violations;
+    }
+    /**
+     * Validate state transitions
+     */
+    validateStateTransition(event, state) {
+        const violations = [];
+        const payload = event.payload;
+        const node = state.nodes.get(payload.nodeId);
+        if (!node) {
+            return violations;
+        }
+        const transitions = this.rules.stateTransitions?.[node.type];
+        if (!transitions) {
+            return violations;
+        }
+        const currentState = payload.previousState || node.state;
+        const newState = payload.newState;
+        // Find valid transitions from current state
+        const validTransition = transitions.find((t) => t.from === currentState);
+        if (validTransition && !validTransition.to.includes(newState)) {
+            violations.push({
+                id: `state-transition-${event.id}`,
+                severity: 'error',
+                type: 'state',
+                description: `Invalid state transition for '${node.type}': ${currentState} -> ${newState}. Valid transitions: ${validTransition.to.join(', ')}`,
+                event,
+                context: {
+                    nodeId: payload.nodeId,
+                },
+            });
+        }
+        return violations;
+    }
+    /**
+     * Create violation for unexpected event
+     */
+    createUnexpectedEventViolation(event) {
+        return {
+            id: `unexpected-${event.id}`,
+            severity: 'warning',
+            type: 'unexpected_event',
+            description: `Unexpected event: ${event.type}`,
+            event,
+        };
+    }
+}
+//# sourceMappingURL=ValidationEngine.js.map

package/dist/ValidationEngine.js.map

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

package/dist/helpers/GraphInstrumentationHelper.d.ts

@@ -0,0 +1,93 @@
+import type { GraphConfiguration, GraphEvent } from '../types';
+/**
+ * Helper class for instrumenting tests with graph events
+ * Makes it easy to emit events from tests
+ */
+export declare class GraphInstrumentationHelper {
+    private configuration;
+    private eventEmitter?;
+    private eventCounter;
+    constructor(configuration: GraphConfiguration, eventEmitter?: (event: GraphEvent) => void);
+    /**
+     * Set the event emitter callback
+     */
+    setEventEmitter(emitter: (event: GraphEvent) => void): void;
+    /**
+     * Emit a node creation event
+     */
+    emitNodeCreated(id: string, type: string, data: Record<string, any>, options?: {
+        expected?: boolean;
+        position?: {
+            x: number;
+            y: number;
+        };
+        metadata?: Record<string, any>;
+    }): GraphEvent;
+    /**
+     * Emit a node update event
+     */
+    emitNodeUpdated(id: string, updates: Record<string, any>, options?: {
+        expected?: boolean;
+        metadata?: Record<string, any>;
+    }): GraphEvent;
+    /**
+     * Emit a node deletion event
+     */
+    emitNodeDeleted(id: string, options?: {
+        expected?: boolean;
+        metadata?: Record<string, any>;
+    }): GraphEvent;
+    /**
+     * Emit an edge creation event
+     */
+    emitEdgeCreated(id: string, type: string, from: string, to: string, options?: {
+        expected?: boolean;
+        data?: Record<string, any>;
+        metadata?: Record<string, any>;
+    }): GraphEvent;
+    /**
+     * Emit an edge animation event
+     */
+    emitEdgeAnimated(id: string, type: string, from: string, to: string, options?: {
+        duration?: number;
+        direction?: 'forward' | 'backward' | 'bidirectional';
+        metadata?: Record<string, any>;
+    }): GraphEvent;
+    /**
+     * Emit an edge deletion event
+     */
+    emitEdgeDeleted(id: string, options?: {
+        expected?: boolean;
+        metadata?: Record<string, any>;
+    }): GraphEvent;
+    /**
+     * Emit a state change event
+     */
+    emitStateChange(nodeId: string, newState: string, options?: {
+        previousState?: string;
+        expected?: boolean;
+        data?: Record<string, any>;
+        metadata?: Record<string, any>;
+    }): GraphEvent;
+    /**
+     * Emit a system reset event
+     */
+    emitReset(): GraphEvent;
+    /**
+     * Emit a system pause event
+     */
+    emitPause(): GraphEvent;
+    /**
+     * Emit a system resume event
+     */
+    emitResume(): GraphEvent;
+    /**
+     * Generate a unique event ID
+     */
+    private generateEventId;
+    /**
+     * Emit an event
+     */
+    private emit;
+}
+//# sourceMappingURL=GraphInstrumentationHelper.d.ts.map

package/dist/helpers/GraphInstrumentationHelper.d.ts.map

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

package/dist/helpers/GraphInstrumentationHelper.js

@@ -0,0 +1,248 @@
+/**
+ * Helper class for instrumenting tests with graph events
+ * Makes it easy to emit events from tests
+ */
+export class GraphInstrumentationHelper {
+    constructor(configuration, eventEmitter) {
+        this.eventCounter = 0;
+        this.configuration = configuration;
+        this.eventEmitter = eventEmitter;
+    }
+    /**
+     * Set the event emitter callback
+     */
+    setEventEmitter(emitter) {
+        this.eventEmitter = emitter;
+    }
+    /**
+     * Emit a node creation event
+     */
+    emitNodeCreated(id, type, data, options = {}) {
+        const event = {
+            id: this.generateEventId(),
+            type: 'node_created',
+            timestamp: Date.now(),
+            category: 'node',
+            operation: 'create',
+            payload: {
+                operation: 'create',
+                nodeId: id,
+                nodeType: type,
+                data,
+                position: options.position,
+            },
+            expected: options.expected ?? true,
+            metadata: options.metadata,
+        };
+        this.emit(event);
+        return event;
+    }
+    /**
+     * Emit a node update event
+     */
+    emitNodeUpdated(id, updates, options = {}) {
+        const event = {
+            id: this.generateEventId(),
+            type: 'node_updated',
+            timestamp: Date.now(),
+            category: 'node',
+            operation: 'update',
+            payload: {
+                operation: 'update',
+                nodeId: id,
+                nodeType: '', // Will be determined from state
+                data: updates,
+            },
+            expected: options.expected ?? true,
+            metadata: options.metadata,
+        };
+        this.emit(event);
+        return event;
+    }
+    /**
+     * Emit a node deletion event
+     */
+    emitNodeDeleted(id, options = {}) {
+        const event = {
+            id: this.generateEventId(),
+            type: 'node_deleted',
+            timestamp: Date.now(),
+            category: 'node',
+            operation: 'delete',
+            payload: {
+                operation: 'delete',
+                nodeId: id,
+                nodeType: '', // Will be determined from state
+            },
+            expected: options.expected ?? true,
+            metadata: options.metadata,
+        };
+        this.emit(event);
+        return event;
+    }
+    /**
+     * Emit an edge creation event
+     */
+    emitEdgeCreated(id, type, from, to, options = {}) {
+        const event = {
+            id: this.generateEventId(),
+            type: 'edge_created',
+            timestamp: Date.now(),
+            category: 'edge',
+            operation: 'create',
+            payload: {
+                operation: 'create',
+                edgeId: id,
+                edgeType: type,
+                from,
+                to,
+                data: options.data,
+            },
+            expected: options.expected ?? true,
+            metadata: options.metadata,
+        };
+        this.emit(event);
+        return event;
+    }
+    /**
+     * Emit an edge animation event
+     */
+    emitEdgeAnimated(id, type, from, to, options = {}) {
+        const event = {
+            id: this.generateEventId(),
+            type: 'edge_animated',
+            timestamp: Date.now(),
+            category: 'edge',
+            operation: 'animate',
+            payload: {
+                operation: 'animate',
+                edgeId: id,
+                edgeType: type,
+                from,
+                to,
+                animation: {
+                    duration: options.duration,
+                    direction: options.direction || 'forward',
+                },
+            },
+            expected: true,
+            metadata: options.metadata,
+        };
+        this.emit(event);
+        return event;
+    }
+    /**
+     * Emit an edge deletion event
+     */
+    emitEdgeDeleted(id, options = {}) {
+        const event = {
+            id: this.generateEventId(),
+            type: 'edge_deleted',
+            timestamp: Date.now(),
+            category: 'edge',
+            operation: 'delete',
+            payload: {
+                operation: 'delete',
+                edgeId: id,
+                edgeType: '', // Will be determined from state
+                from: '',
+                to: '',
+            },
+            expected: options.expected ?? true,
+            metadata: options.metadata,
+        };
+        this.emit(event);
+        return event;
+    }
+    /**
+     * Emit a state change event
+     */
+    emitStateChange(nodeId, newState, options = {}) {
+        const event = {
+            id: this.generateEventId(),
+            type: 'state_changed',
+            timestamp: Date.now(),
+            category: 'state',
+            operation: 'update',
+            payload: {
+                nodeId,
+                previousState: options.previousState,
+                newState,
+                data: options.data,
+            },
+            expected: options.expected ?? true,
+            metadata: options.metadata,
+        };
+        this.emit(event);
+        return event;
+    }
+    /**
+     * Emit a system reset event
+     */
+    emitReset() {
+        const event = {
+            id: this.generateEventId(),
+            type: 'system_reset',
+            timestamp: Date.now(),
+            category: 'system',
+            operation: 'update',
+            payload: {
+                action: 'reset',
+            },
+            expected: true,
+        };
+        this.emit(event);
+        return event;
+    }
+    /**
+     * Emit a system pause event
+     */
+    emitPause() {
+        const event = {
+            id: this.generateEventId(),
+            type: 'system_pause',
+            timestamp: Date.now(),
+            category: 'system',
+            operation: 'update',
+            payload: {
+                action: 'pause',
+            },
+            expected: true,
+        };
+        this.emit(event);
+        return event;
+    }
+    /**
+     * Emit a system resume event
+     */
+    emitResume() {
+        const event = {
+            id: this.generateEventId(),
+            type: 'system_resume',
+            timestamp: Date.now(),
+            category: 'system',
+            operation: 'update',
+            payload: {
+                action: 'resume',
+            },
+            expected: true,
+        };
+        this.emit(event);
+        return event;
+    }
+    /**
+     * Generate a unique event ID
+     */
+    generateEventId() {
+        return `evt-${++this.eventCounter}-${Date.now()}`;
+    }
+    /**
+     * Emit an event
+     */
+    emit(event) {
+        if (this.eventEmitter) {
+            this.eventEmitter(event);
+        }
+    }
+}
+//# sourceMappingURL=GraphInstrumentationHelper.js.map

package/dist/helpers/GraphInstrumentationHelper.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @principal-ai/principal-view-core
+ * Core logic and types for graph-based principal view framework
+ */
+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 { 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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AAG5G,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAGlF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,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,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACtF,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGrF,YAAY,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAGjF,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,34 @@
+/**
+ * @principal-ai/principal-view-core
+ * Core logic and types for graph-based principal view framework
+ */
+// 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 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 { 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';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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;AAGlE,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,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"}

package/dist/rules/config.d.ts

@@ -0,0 +1,57 @@
+/**
+ * VGC Configuration Loader and Validator
+ * Handles loading and validating .vgcrc files
+ */
+import type { PrivuConfig, RuleSeverity } from './types';
+/**
+ * Valid config file names in resolution order
+ */
+export declare const CONFIG_FILE_NAMES: readonly [".vgcrc.json", ".vgcrc.yaml", ".vgcrc.yml", "vgc.config.json", "vgc.config.yaml", "vgc.config.yml"];
+/**
+ * Default include patterns
+ */
+export declare const DEFAULT_INCLUDE_PATTERNS: string[];
+/**
+ * Default exclude patterns
+ */
+export declare const DEFAULT_EXCLUDE_PATTERNS: string[];
+/**
+ * Valid severity values
+ */
+export declare const VALID_SEVERITIES: readonly (RuleSeverity | false)[];
+/**
+ * All valid rule IDs
+ */
+export declare const VALID_RULE_IDS: readonly ["no-unknown-fields", "required-metadata", "valid-node-types", "valid-edge-types", "valid-color-format", "connection-type-references", "state-transition-references", "minimum-node-sources", "orphaned-node-types", "orphaned-edge-types", "unreachable-states", "dead-end-states", "valid-action-patterns", "library-node-type-match"];
+export type ValidRuleId = (typeof VALID_RULE_IDS)[number];
+/**
+ * Rule-specific valid options
+ */
+export declare const RULE_OPTIONS_SCHEMA: Record<string, string[]>;
+export interface ConfigValidationError {
+    path: string;
+    message: string;
+    suggestion?: string;
+}
+export interface ConfigValidationResult {
+    valid: boolean;
+    errors: ConfigValidationError[];
+    config?: PrivuConfig;
+}
+/**
+ * Validate a VGC configuration object
+ */
+export declare function validatePrivuConfig(config: unknown): ConfigValidationResult;
+/**
+ * Get the default VGC configuration
+ */
+export declare function getDefaultConfig(): PrivuConfig;
+/**
+ * Merge configs with proper precedence (later configs override earlier)
+ */
+export declare function mergeConfigs(...configs: (PrivuConfig | undefined)[]): PrivuConfig;
+/**
+ * Format config validation errors for display
+ */
+export declare function formatConfigErrors(errors: ConfigValidationError[]): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/rules/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/rules/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAc,MAAM,SAAS,CAAC;AAMrE;;GAEG;AACH,eAAO,MAAM,iBAAiB,+GAOpB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAAwD,CAAC;AAE9F;;GAEG;AACH,eAAO,MAAM,wBAAwB,UAAwC,CAAC;AAE9E;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,CAAC,YAAY,GAAG,KAAK,CAAC,EAQ7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,mVAoBjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAKxD,CAAC;AAMF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,qBAAqB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAMD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB,CA0H3E;AAoHD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAO9C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,OAAO,EAAE,CAAC,WAAW,GAAG,SAAS,CAAC,EAAE,GAAG,WAAW,CAkBjF;AAgED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,qBAAqB,EAAE,GAAG,MAAM,CAc1E"}