@principal-ai/principal-view-core 0.5.6

package/dist/LibraryLoader.js

@@ -0,0 +1,188 @@
+/**
+ * Library Loader
+ *
+ * Loads component library files (.yaml, .yml, or .json) from the .vgc/ folder.
+ * Component libraries contain reusable node and edge type definitions.
+ */
+import * as yaml from 'js-yaml';
+/**
+ * Default library file names to search for (in order of preference)
+ */
+const DEFAULT_LIBRARY_FILES = ['library.yaml', 'library.yml', 'library.json'];
+/**
+ * Configuration directory name
+ */
+const CONFIG_DIR = '.vgc';
+/**
+ * Loader for component library files
+ */
+export class LibraryLoader {
+    constructor(fsAdapter) {
+        this.fsAdapter = fsAdapter;
+    }
+    /**
+     * Load the component library from the .vgc/ folder
+     *
+     * Searches for library.yaml, library.yml, or library.json (in that order).
+     *
+     * @param baseDir - Base directory containing .vgc/ folder
+     * @returns Library load result
+     */
+    load(baseDir) {
+        const configPath = this.fsAdapter.join(baseDir, CONFIG_DIR);
+        // Check if .vgc directory exists
+        if (!this.fsAdapter.exists(configPath) || !this.fsAdapter.isDirectory(configPath)) {
+            return {
+                success: false,
+                error: 'Configuration directory .vgc/ not found',
+                path: configPath,
+            };
+        }
+        // Try each default library file name
+        for (const fileName of DEFAULT_LIBRARY_FILES) {
+            const fullPath = this.fsAdapter.join(configPath, fileName);
+            if (this.fsAdapter.exists(fullPath)) {
+                return this.loadFromPath(fullPath);
+            }
+        }
+        return {
+            success: false,
+            error: `No library file found. Expected one of: ${DEFAULT_LIBRARY_FILES.join(', ')}`,
+            path: configPath,
+        };
+    }
+    /**
+     * Load a library from a specific file path
+     *
+     * @param filePath - Full path to the library file
+     * @returns Library load result
+     */
+    loadFromPath(filePath) {
+        try {
+            const content = this.fsAdapter.readFile(filePath);
+            const isJson = filePath.endsWith('.json');
+            const library = isJson ? this.parseJson(content, filePath) : this.parseYaml(content, filePath);
+            const validationError = this.validate(library, filePath);
+            if (validationError) {
+                return {
+                    success: false,
+                    error: validationError,
+                    path: filePath,
+                };
+            }
+            return {
+                success: true,
+                library,
+                path: filePath,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                error: `Failed to load library: ${errorMessage}`,
+                path: filePath,
+            };
+        }
+    }
+    /**
+     * Check if a library file exists in the .vgc/ folder
+     *
+     * @param baseDir - Base directory containing .vgc/ folder
+     * @returns True if a library file exists
+     */
+    hasLibrary(baseDir) {
+        const configPath = this.fsAdapter.join(baseDir, CONFIG_DIR);
+        if (!this.fsAdapter.exists(configPath) || !this.fsAdapter.isDirectory(configPath)) {
+            return false;
+        }
+        return DEFAULT_LIBRARY_FILES.some((fileName) => this.fsAdapter.exists(this.fsAdapter.join(configPath, fileName)));
+    }
+    /**
+     * Get the path where the library file would be located
+     *
+     * @param baseDir - Base directory
+     * @param format - Preferred format ('yaml' or 'json')
+     * @returns Full path to the library file
+     */
+    getLibraryPath(baseDir, format = 'yaml') {
+        const fileName = format === 'json' ? 'library.json' : 'library.yaml';
+        return this.fsAdapter.join(baseDir, CONFIG_DIR, fileName);
+    }
+    /**
+     * Parse YAML content into a library object
+     */
+    parseYaml(content, filePath) {
+        const data = yaml.load(content);
+        if (!data || typeof data !== 'object') {
+            throw new Error(`Empty or invalid YAML in ${filePath}`);
+        }
+        return data;
+    }
+    /**
+     * Parse JSON content into a library object
+     */
+    parseJson(content, filePath) {
+        try {
+            const data = JSON.parse(content);
+            return data;
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Invalid JSON in ${filePath}: ${errorMessage}`);
+        }
+    }
+    /**
+     * Validate the library structure
+     *
+     * @param library - Parsed library object
+     * @param filePath - File path for error messages
+     * @returns Error message if invalid, undefined if valid
+     */
+    validate(library, filePath) {
+        if (!library.version) {
+            return `Missing required field 'version' in ${filePath}`;
+        }
+        if (!library.name) {
+            return `Missing required field 'name' in ${filePath}`;
+        }
+        if (!library.nodeComponents || typeof library.nodeComponents !== 'object') {
+            return `Missing or invalid 'nodeComponents' in ${filePath}`;
+        }
+        if (!library.edgeComponents || typeof library.edgeComponents !== 'object') {
+            return `Missing or invalid 'edgeComponents' in ${filePath}`;
+        }
+        // Validate node components
+        for (const [key, node] of Object.entries(library.nodeComponents)) {
+            if (!node.shape) {
+                return `Node component '${key}' is missing required field 'shape' in ${filePath}`;
+            }
+        }
+        // Validate edge components
+        for (const [key, edge] of Object.entries(library.edgeComponents)) {
+            if (!edge.style) {
+                return `Edge component '${key}' is missing required field 'style' in ${filePath}`;
+            }
+        }
+        // Validate connection rules if present
+        if (library.connectionRules) {
+            for (const [index, rule] of library.connectionRules.entries()) {
+                if (!rule.from || !rule.to || !rule.via) {
+                    return `Connection rule at index ${index} is missing required fields (from, to, via) in ${filePath}`;
+                }
+                // Check that referenced types exist
+                if (!library.nodeComponents[rule.from]) {
+                    return `Connection rule references unknown node type '${rule.from}' in ${filePath}`;
+                }
+                if (!library.nodeComponents[rule.to]) {
+                    return `Connection rule references unknown node type '${rule.to}' in ${filePath}`;
+                }
+                if (!library.edgeComponents[rule.via]) {
+                    return `Connection rule references unknown edge type '${rule.via}' in ${filePath}`;
+                }
+            }
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=LibraryLoader.js.map

package/dist/LibraryLoader.js.map

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

package/dist/PathBasedEventProcessor.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Path-Based Event Processor
+ *
+ * Converts log entries to graph events by associating logs with components
+ * based on source file paths.
+ *
+ * Milestone 1: Basic component activity events
+ * Milestone 2: Action pattern matching and edge activation
+ */
+import type { PathBasedGraphConfiguration, PathBasedEvent, LogLevel } from './types/path-based-config';
+/**
+ * Log entry from logger (simplified interface to avoid circular dependency)
+ */
+export interface LogEntry {
+    message: string;
+    metadata: {
+        timestamp: number;
+        level: LogLevel;
+        source?: {
+            file: string;
+            line?: number;
+            column?: number;
+        };
+        /**
+         * Instance identifier for multi-instance components.
+         * Used to differentiate between multiple nodes of the same type
+         * (e.g., "client-1", "client-2" for components of type "client").
+         */
+        instanceId?: string;
+    };
+    args?: any[];
+}
+/**
+ * Path-based event processor
+ */
+export declare class PathBasedEventProcessor {
+    private componentSourceMap;
+    private config;
+    constructor(config: PathBasedGraphConfiguration);
+    /**
+     * Build the component-to-source-path mapping from configuration
+     */
+    private buildComponentSourceMap;
+    /**
+     * Process a log entry and convert to graph event(s)
+     *
+     * @param log Log entry from enhanced logger
+     * @returns Array of graph events (can be multiple if action triggers edges)
+     */
+    processLog(log: LogEntry): PathBasedEvent[];
+    /**
+     * Find component by matching source path against configured patterns
+     */
+    private findComponentByPath;
+    /**
+     * Try to match log message against action patterns (Milestone 2)
+     */
+    private tryMatchActionPattern;
+    /**
+     * Extract metadata from regex capture groups
+     */
+    private extractMetadata;
+    /**
+     * Get edge animations triggered by a component action (Milestone 2)
+     */
+    private getEdgeAnimationsForAction;
+    /**
+     * Batch process multiple log entries
+     */
+    processLogs(logs: LogEntry[]): PathBasedEvent[];
+    /**
+     * Get statistics about component source mappings
+     */
+    getStats(): {
+        totalComponents: number;
+        componentsWithSources: number;
+        componentsWithActions: number;
+        totalSourcePatterns: number;
+        totalActionPatterns: number;
+    };
+    /**
+     * Validate configuration and return warnings/errors
+     */
+    validate(): Array<{
+        type: 'error' | 'warning';
+        message: string;
+        componentId?: string;
+    }>;
+}
+//# sourceMappingURL=PathBasedEventProcessor.d.ts.map

package/dist/PathBasedEventProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PathBasedEventProcessor.d.ts","sourceRoot":"","sources":["../src/PathBasedEventProcessor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EACV,2BAA2B,EAI3B,cAAc,EAEd,QAAQ,EACT,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,QAAQ,CAAC;QAChB,MAAM,CAAC,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;QACF;;;;WAIG;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;CACd;AAWD;;GAEG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,MAAM,CAA8B;gBAEhC,MAAM,EAAE,2BAA2B;IAK/C;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAc/B;;;;;OAKG;IACI,UAAU,CAAC,GAAG,EAAE,QAAQ,GAAG,cAAc,EAAE;IAqDlD;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoC7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IA+BlC;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,cAAc,EAAE;IAUtD;;OAEG;IACI,QAAQ,IAAI;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,qBAAqB,EAAE,MAAM,CAAC;QAC9B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,mBAAmB,EAAE,MAAM,CAAC;KAC7B;IAUD;;OAEG;IACI,QAAQ,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CA2C/F"}

package/dist/PathBasedEventProcessor.js

@@ -0,0 +1,239 @@
+/**
+ * Path-Based Event Processor
+ *
+ * Converts log entries to graph events by associating logs with components
+ * based on source file paths.
+ *
+ * Milestone 1: Basic component activity events
+ * Milestone 2: Action pattern matching and edge activation
+ */
+import { PathMatcher } from './utils/PathMatcher';
+/**
+ * Path-based event processor
+ */
+export class PathBasedEventProcessor {
+    constructor(config) {
+        this.componentSourceMap = [];
+        this.config = config;
+        this.buildComponentSourceMap();
+    }
+    /**
+     * Build the component-to-source-path mapping from configuration
+     */
+    buildComponentSourceMap() {
+        this.componentSourceMap = [];
+        for (const [componentId, nodeType] of Object.entries(this.config.nodeTypes)) {
+            if (nodeType.sources && nodeType.sources.length > 0) {
+                this.componentSourceMap.push({
+                    componentId,
+                    sources: nodeType.sources,
+                    actions: nodeType.actions
+                });
+            }
+        }
+    }
+    /**
+     * Process a log entry and convert to graph event(s)
+     *
+     * @param log Log entry from enhanced logger
+     * @returns Array of graph events (can be multiple if action triggers edges)
+     */
+    processLog(log) {
+        const events = [];
+        // Skip logs without source information
+        if (!log.metadata.source?.file) {
+            return events;
+        }
+        // Find component by matching source path
+        const component = this.findComponentByPath(log.metadata.source.file);
+        if (!component) {
+            // Log doesn't match any configured component
+            return events;
+        }
+        // Milestone 2: Try to match action patterns first (if enabled)
+        if (this.config.pathBasedConfig?.enableActionPatterns && component.actions) {
+            const actionEvent = this.tryMatchActionPattern(log, component);
+            if (actionEvent) {
+                events.push(actionEvent);
+                // Check if this action triggers any edge animations
+                const edgeEvents = this.getEdgeAnimationsForAction(component.componentId, actionEvent.action);
+                events.push(...edgeEvents);
+                return events; // Action pattern matched, don't create activity event
+            }
+        }
+        // Milestone 1: Fallback to generic component activity event
+        const activityEvent = {
+            type: 'component-activity',
+            componentId: component.componentId,
+            instanceId: log.metadata.instanceId,
+            timestamp: log.metadata.timestamp,
+            level: log.metadata.level,
+            message: log.message,
+            source: {
+                file: log.metadata.source.file,
+                line: log.metadata.source.line,
+                column: log.metadata.source.column
+            },
+            args: log.args
+        };
+        events.push(activityEvent);
+        return events;
+    }
+    /**
+     * Find component by matching source path against configured patterns
+     */
+    findComponentByPath(logPath) {
+        for (const component of this.componentSourceMap) {
+            // Check if any of the component's source patterns match the log path
+            for (const sourcePattern of component.sources) {
+                if (PathMatcher.matches(logPath, sourcePattern)) {
+                    return component;
+                }
+            }
+        }
+        return null;
+    }
+    /**
+     * Try to match log message against action patterns (Milestone 2)
+     */
+    tryMatchActionPattern(log, component) {
+        if (!component.actions) {
+            return null;
+        }
+        for (const actionPattern of component.actions) {
+            const regex = new RegExp(actionPattern.pattern);
+            const match = log.message.match(regex);
+            if (match) {
+                // Extract metadata from capture groups
+                const metadata = this.extractMetadata(match, actionPattern.metadata || {});
+                return {
+                    type: 'component-action',
+                    componentId: component.componentId,
+                    instanceId: log.metadata.instanceId,
+                    action: actionPattern.event,
+                    state: actionPattern.state,
+                    timestamp: log.metadata.timestamp,
+                    metadata,
+                    source: {
+                        file: log.metadata.source.file,
+                        line: log.metadata.source.line,
+                        column: log.metadata.source.column
+                    }
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Extract metadata from regex capture groups
+     */
+    extractMetadata(match, template) {
+        const metadata = {};
+        for (const [key, value] of Object.entries(template)) {
+            // Value is a template like "$lockId" that references a named capture group
+            if (value.startsWith('$') && match.groups) {
+                const groupName = value.slice(1);
+                metadata[key] = match.groups[groupName];
+            }
+            else {
+                // Static value
+                metadata[key] = value;
+            }
+        }
+        return metadata;
+    }
+    /**
+     * Get edge animations triggered by a component action (Milestone 2)
+     */
+    getEdgeAnimationsForAction(componentId, action) {
+        const events = [];
+        // Check all edges to see if they're activated by this action
+        for (const [edgeId, edgeType] of Object.entries(this.config.edgeTypes)) {
+            if (edgeType.activatedBy) {
+                for (const trigger of edgeType.activatedBy) {
+                    if (trigger.action === action) {
+                        events.push({
+                            type: 'edge-animation',
+                            edgeId,
+                            animation: trigger.animation,
+                            direction: trigger.direction,
+                            duration: trigger.duration || 2000,
+                            timestamp: Date.now(),
+                            triggeredBy: {
+                                componentId,
+                                action
+                            }
+                        });
+                    }
+                }
+            }
+        }
+        return events;
+    }
+    /**
+     * Batch process multiple log entries
+     */
+    processLogs(logs) {
+        const events = [];
+        for (const log of logs) {
+            events.push(...this.processLog(log));
+        }
+        return events;
+    }
+    /**
+     * Get statistics about component source mappings
+     */
+    getStats() {
+        return {
+            totalComponents: Object.keys(this.config.nodeTypes).length,
+            componentsWithSources: this.componentSourceMap.length,
+            componentsWithActions: this.componentSourceMap.filter(c => c.actions && c.actions.length > 0).length,
+            totalSourcePatterns: this.componentSourceMap.reduce((sum, c) => sum + c.sources.length, 0),
+            totalActionPatterns: this.componentSourceMap.reduce((sum, c) => sum + (c.actions?.length || 0), 0)
+        };
+    }
+    /**
+     * Validate configuration and return warnings/errors
+     */
+    validate() {
+        const issues = [];
+        // Check for overlapping source patterns
+        for (let i = 0; i < this.componentSourceMap.length; i++) {
+            for (let j = i + 1; j < this.componentSourceMap.length; j++) {
+                const comp1 = this.componentSourceMap[i];
+                const comp2 = this.componentSourceMap[j];
+                // Check if any patterns overlap
+                for (const pattern1 of comp1.sources) {
+                    for (const pattern2 of comp2.sources) {
+                        if (pattern1 === pattern2) {
+                            issues.push({
+                                type: 'warning',
+                                message: `Components "${comp1.componentId}" and "${comp2.componentId}" both use pattern "${pattern1}". Logs will be associated with the first match.`,
+                                componentId: comp1.componentId
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        // Validate action patterns (check for valid regex)
+        for (const component of this.componentSourceMap) {
+            if (component.actions) {
+                for (const action of component.actions) {
+                    try {
+                        new RegExp(action.pattern);
+                    }
+                    catch (error) {
+                        issues.push({
+                            type: 'error',
+                            message: `Invalid regex pattern in action "${action.event}": ${action.pattern}`,
+                            componentId: component.componentId
+                        });
+                    }
+                }
+            }
+        }
+        return issues;
+    }
+}
+//# sourceMappingURL=PathBasedEventProcessor.js.map

package/dist/PathBasedEventProcessor.js.map

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