@specverse/engines 4.1.0

package/dist/parser/convention-processor.js

@@ -0,0 +1,349 @@
+/**
+ * SpecVerse Convention Processor
+ *
+ * Processes YAML + conventions into structured AST
+ * Handles v3.1 container format with namespaces and "name: Type modifiers" patterns
+ *
+ * Convention processors are discovered from entity modules via the entity registry.
+ * Each entity module provides its own processor; this class orchestrates them.
+ */
+import { bootstrapEntityModules, getEntityRegistry, BehaviouralConventionProcessor } from '@specverse/entities';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { createRequire } from 'module';
+import { existsSync } from 'fs';
+export class ConventionProcessor {
+    warnings = [];
+    entityProcessors;
+    behaviouralProcessor;
+    // Entity type names derived from registered processors (not hardcoded)
+    componentEntityTypes;
+    constructor() {
+        // Bootstrap entity modules and discover convention processors from registry
+        bootstrapEntityModules();
+        this.entityProcessors = getEntityRegistry().getConventionProcessors();
+        // Derive component entity types from registered convention processors.
+        // Exclude top-level types (deployments) and types not yet in the component schema.
+        // This is an exclude-list (small, stable) rather than an include-list (grows with each entity).
+        const NON_COMPONENT_TYPES = new Set(['deployments', 'conventions', 'measures']);
+        this.componentEntityTypes = Array.from(this.entityProcessors.keys())
+            .filter(name => !NON_COMPONENT_TYPES.has(name));
+        // Load behavioural convention grammars from entity modules
+        this.behaviouralProcessor = new BehaviouralConventionProcessor();
+        try {
+            let entitiesDir = null;
+            // Primary: resolve from @specverse/engine-entities package (works in all layouts)
+            try {
+                const req = createRequire(import.meta.url);
+                const pkgPath = req.resolve('@specverse/entities/package.json');
+                entitiesDir = resolve(dirname(pkgPath), 'src');
+            }
+            catch { /* package not installed */ }
+            // Fallback: relative paths for legacy layouts
+            if (!entitiesDir || !existsSync(entitiesDir)) {
+                const thisDir = dirname(fileURLToPath(import.meta.url));
+                const legacyPath = resolve(thisDir, '..', 'entities');
+                if (existsSync(legacyPath))
+                    entitiesDir = legacyPath;
+            }
+            if (entitiesDir && existsSync(entitiesDir)) {
+                this.behaviouralProcessor.loadGrammarsFromEntities(entitiesDir);
+            }
+        }
+        catch {
+            // Grammars are optional — not available in all contexts (packaged builds, test environments)
+        }
+    }
+    /**
+     * Get accumulated warnings
+     */
+    getWarnings() {
+        return this.warnings;
+    }
+    /**
+     * Clear accumulated warnings
+     */
+    clearWarnings() {
+        this.warnings = [];
+    }
+    /**
+     * Add a warning
+     */
+    addWarning(message) {
+        this.warnings.push(message);
+    }
+    /**
+     * Main processing entry point for v3.1 container format
+     */
+    process(yamlData) {
+        const result = {
+            components: [],
+            deployments: [],
+            manifests: []
+        };
+        // Process components section (v3.1 container format only)
+        if (yamlData.components) {
+            for (const [componentName, componentData] of Object.entries(yamlData.components)) {
+                result.components.push(this.processComponent(componentName, componentData));
+            }
+        }
+        // Process deployments section via entity registry
+        if (yamlData.deployments) {
+            const deploymentsProcessor = this.entityProcessors.get('deployments');
+            if (deploymentsProcessor) {
+                const deployments = deploymentsProcessor.process(yamlData.deployments, this);
+                result.deployments.push(...deployments);
+            }
+        }
+        // Process manifests section
+        if (yamlData.manifests) {
+            for (const [manifestName, manifestData] of Object.entries(yamlData.manifests)) {
+                result.manifests.push(this.processManifest(manifestName, manifestData));
+            }
+        }
+        return result;
+    }
+    /**
+     * Process a single component
+     */
+    processComponent(componentName, componentData) {
+        // Known valid properties for components (static props + entity types from registry)
+        const validProperties = [
+            'version', 'description', 'tags', 'import', 'export', 'primitives',
+            'constraints',
+            ...this.componentEntityTypes
+        ];
+        // Check for unknown properties and warn about them
+        const unknownProperties = Object.keys(componentData).filter(key => !validProperties.includes(key));
+        if (unknownProperties.length > 0) {
+            this.warnings.push(`Component '${componentName}' contains unknown properties that will be preserved for validation: ${unknownProperties.join(', ')}`);
+        }
+        // Process known properties but also preserve unknown ones for schema validation
+        const processedComponent = {
+            name: componentName,
+            namespace: componentName, // For now, name = namespace
+            version: componentData.version,
+            description: componentData.description,
+            tags: componentData.tags || [],
+            imports: componentData.import || [],
+            exports: componentData.export || {},
+            primitives: this.processPrimitives(componentData.primitives || {}),
+        };
+        // Process each component section via entity registry convention processors.
+        // Core entity types default to [] when absent; extension types are only included when present.
+        const registry = getEntityRegistry();
+        const coreModuleNames = new Set(registry.getInDependencyOrder().filter(m => m.type === 'core').map(m => m.name));
+        for (const entityType of this.componentEntityTypes) {
+            if (componentData[entityType]) {
+                const processor = this.entityProcessors.get(entityType);
+                if (processor) {
+                    processedComponent[entityType] = processor.process(componentData[entityType], this);
+                }
+            }
+            else if (coreModuleNames.has(entityType)) {
+                processedComponent[entityType] = [];
+            }
+            // Extension types omitted when not present — avoids schema type mismatches
+        }
+        // Process behavioural constraints into expanded Quint specifications
+        if (componentData.constraints && Array.isArray(componentData.constraints)) {
+            const expandedConstraints = [];
+            for (const constraint of componentData.constraints) {
+                const result = this.behaviouralProcessor.expand(constraint);
+                if (result) {
+                    expandedConstraints.push(result);
+                }
+                else {
+                    this.warnings.push(`Component '${componentName}': Unrecognized constraint "${constraint}". No matching behavioural convention found.`);
+                }
+            }
+            processedComponent.constraints = expandedConstraints;
+        }
+        // Add any unknown properties to be caught by schema validation
+        unknownProperties.forEach(prop => {
+            processedComponent[prop] = componentData[prop];
+        });
+        return processedComponent;
+    }
+    /**
+     * Process a single manifest
+     */
+    processManifest(manifestName, manifestData) {
+        // Preserve all manifest properties as-is for diagram generation
+        return {
+            name: manifestName,
+            namespace: manifestName, // For now, name = namespace
+            ...manifestData
+        };
+    }
+    /**
+     * Process types section with convention expansion
+     * "ProductCode: String pattern='^[A-Z]{3}-\\d{4}$'" -> Full type model
+     */
+    processPrimitives(primitivesData) {
+        const primitives = [];
+        for (const [typeName, definition] of Object.entries(primitivesData)) {
+            if (typeof definition === 'string') {
+                // Parse convention: "String pattern='^[A-Z]{3}-\\d{4}$' description='Product code'"
+                const expanded = this.parsePrimitiveConvention(typeName, definition);
+                primitives.push(expanded);
+            }
+            else if (typeof definition === 'object') {
+                // Already expanded format
+                primitives.push({
+                    name: typeName,
+                    baseType: definition.baseType || 'String',
+                    description: definition.description || `Custom type: ${typeName}`,
+                    typeAlias: true,
+                    required: definition.required,
+                    unique: definition.unique,
+                    validation: definition.validation
+                });
+            }
+        }
+        return primitives;
+    }
+    /**
+     * Parse type convention string
+     * "String pattern='^[A-Z]{3}-\\d{4}$' required description='Product code'"
+     */
+    parsePrimitiveConvention(name, convention) {
+        const parts = this.smartSplit(convention.trim());
+        const baseType = parts[0];
+        const modifiers = parts.slice(1);
+        const spec = {
+            name,
+            baseType,
+            description: `Custom type: ${name}`,
+            validation: {},
+            typeAlias: true
+        };
+        // Data-driven primitive modifier definitions
+        const BOOL_MODS = {
+            'required': { target: 'spec', field: 'required', value: true },
+            'unique': { target: 'spec', field: 'unique', value: true },
+        };
+        const KV_MODS = {
+            'pattern': { target: 'validation', field: 'pattern', parse: 'quoted' },
+            'values': { target: 'validation', field: 'values', parse: 'array' },
+            'min': { target: 'validation', field: 'min', parse: 'number' },
+            'max': { target: 'validation', field: 'max', parse: 'number' },
+            'format': { target: 'validation', field: 'format', parse: 'string' },
+            'description': { target: 'spec', field: 'description', parse: 'quoted' },
+        };
+        for (const modifier of modifiers) {
+            // Boolean modifiers (exact keyword)
+            const boolMod = BOOL_MODS[modifier];
+            if (boolMod) {
+                const obj = boolMod.target === 'spec' ? spec : spec.validation;
+                obj[boolMod.field] = boolMod.value;
+                continue;
+            }
+            // Key=value modifiers
+            const eqIndex = modifier.indexOf('=');
+            if (eqIndex > 0) {
+                const key = modifier.substring(0, eqIndex);
+                const kvMod = KV_MODS[key];
+                if (kvMod) {
+                    const obj = kvMod.target === 'spec' ? spec : spec.validation;
+                    switch (kvMod.parse) {
+                        case 'string':
+                            obj[kvMod.field] = modifier.split('=')[1];
+                            break;
+                        case 'quoted':
+                            obj[kvMod.field] = this.parseQuotedValue(modifier);
+                            break;
+                        case 'number':
+                            obj[kvMod.field] = parseFloat(modifier.split('=')[1]);
+                            break;
+                        case 'array':
+                            obj[kvMod.field] = this.parseArrayValue(modifier);
+                            break;
+                    }
+                }
+            }
+        }
+        return spec;
+    }
+    /**
+     * Smart split that respects brackets and quotes
+     * "String values=['a', 'b', 'c'] required" -> ["String", "values=['a', 'b', 'c']", "required"]
+     */
+    smartSplit(text) {
+        const parts = [];
+        let current = '';
+        let inBrackets = 0;
+        let inQuotes = false;
+        let quoteChar = '';
+        for (let i = 0; i < text.length; i++) {
+            const char = text[i];
+            const prevChar = i > 0 ? text[i - 1] : '';
+            // Handle quotes
+            if ((char === '"' || char === "'") && prevChar !== '\\') {
+                if (!inQuotes) {
+                    inQuotes = true;
+                    quoteChar = char;
+                }
+                else if (char === quoteChar) {
+                    inQuotes = false;
+                    quoteChar = '';
+                }
+            }
+            // Handle brackets (only when not in quotes)
+            if (!inQuotes) {
+                if (char === '[')
+                    inBrackets++;
+                if (char === ']')
+                    inBrackets--;
+            }
+            // Split on whitespace only when not in brackets or quotes
+            if (char.match(/\s/) && !inQuotes && inBrackets === 0) {
+                if (current.trim()) {
+                    parts.push(current.trim());
+                    current = '';
+                }
+            }
+            else {
+                current += char;
+            }
+        }
+        // Add the last part
+        if (current.trim()) {
+            parts.push(current.trim());
+        }
+        return parts;
+    }
+    /**
+     * Parse quoted value from modifier: pattern="value" -> "value"
+     */
+    parseQuotedValue(modifier) {
+        // First try double quotes
+        const doubleQuoteMatch = modifier.match(/="([^\"]*)"/);
+        if (doubleQuoteMatch) {
+            return doubleQuoteMatch[1];
+        }
+        // Then try single quotes  
+        const singleQuoteMatch = modifier.match(/='([^']*)'/);
+        if (singleQuoteMatch) {
+            return singleQuoteMatch[1];
+        }
+        // No quotes, return the value after =
+        return modifier.split('=')[1];
+    }
+    /**
+     * Parse array value from modifier: values=["a","b","c"] -> ["a","b","c"]
+     */
+    parseArrayValue(modifier) {
+        const match = modifier.match(/=\[([^\]]*)\]/);
+        if (match) {
+            const content = match[1].trim();
+            // If empty brackets [], return empty array
+            if (!content) {
+                return [];
+            }
+            return content.split(',').map(v => v.trim().replace(/^['"]|['"]$/g, ''));
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=convention-processor.js.map

package/dist/parser/convention-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-processor.js","sourceRoot":"","sources":["../../src/parser/convention-processor.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAChH,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,UAAU,EAAgB,MAAM,IAAI,CAAC;AAE9C,MAAM,OAAO,mBAAmB;IACvB,QAAQ,GAAa,EAAE,CAAC;IAEvB,gBAAgB,CAAyC;IACzD,oBAAoB,CAAiC;IAC7D,uEAAuE;IAC/D,oBAAoB,CAAW;IAEvC;QACE,4EAA4E;QAC5E,sBAAsB,EAAE,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,iBAAiB,EAAE,CAAC,uBAAuB,EAAE,CAAC;QACtE,uEAAuE;QACvE,mFAAmF;QACnF,gGAAgG;QAChG,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,aAAa,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;aACjE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;QAElD,2DAA2D;QAC3D,IAAI,CAAC,oBAAoB,GAAG,IAAI,8BAA8B,EAAE,CAAC;QACjE,IAAI,CAAC;YACH,IAAI,WAAW,GAAkB,IAAI,CAAC;YAEtC,kFAAkF;YAClF,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC3C,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,kCAAkC,CAAC,CAAC;gBAChE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,CAAC,CAAC;YACjD,CAAC;YAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;YAEvC,8CAA8C;YAC9C,IAAI,CAAC,WAAW,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxD,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;gBACtD,IAAI,UAAU,CAAC,UAAU,CAAC;oBAAE,WAAW,GAAG,UAAU,CAAC;YACvD,CAAC;YAED,IAAI,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC3C,IAAI,CAAC,oBAAoB,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC;YAClE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6FAA6F;QAC/F,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,OAAe;QACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,QAAa;QACnB,MAAM,MAAM,GAAiB;YAC3B,UAAU,EAAE,EAAE;YACd,WAAW,EAAE,EAAE;YACf,SAAS,EAAE,EAAE;SACd,CAAC;QAEF,0DAA0D;QAC1D,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACxB,KAAK,MAAM,CAAC,aAAa,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjF,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAoB,CAAC,CAAC,CAAC;YACrF,CAAC;QACH,CAAC;QAED,kDAAkD;QAClD,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YACzB,MAAM,oBAAoB,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;YACtE,IAAI,oBAAoB,EAAE,CAAC;gBACzB,MAAM,WAAW,GAAG,oBAAoB,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;gBAC7E,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,KAAK,MAAM,CAAC,YAAY,EAAE,YAAY,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC9E,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,YAAmB,CAAC,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,aAAqB,EAAE,aAAkB;QAChE,oFAAoF;QACpF,MAAM,eAAe,GAAG;YACtB,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY;YAClE,aAAa;YACb,GAAG,IAAI,CAAC,oBAAoB;SAC7B,CAAC;QAEF,mDAAmD;QACnD,MAAM,iBAAiB,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,CACzD,GAAG,CAAC,EAAE,CAAC,CAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CACtC,CAAC;QAEF,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,cAAc,aAAa,wEAAwE,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClI,CAAC;QACJ,CAAC;QAED,gFAAgF;QAChF,MAAM,kBAAkB,GAAQ;YAC9B,IAAI,EAAE,aAAa;YACnB,SAAS,EAAE,aAAa,EAAE,4BAA4B;YACtD,OAAO,EAAE,aAAa,CAAC,OAAO;YAC9B,WAAW,EAAE,aAAa,CAAC,WAAW;YACtC,IAAI,EAAE,aAAa,CAAC,IAAI,IAAI,EAAE;YAC9B,OAAO,EAAE,aAAa,CAAC,MAAM,IAAI,EAAE;YACnC,OAAO,EAAE,aAAa,CAAC,MAAM,IAAI,EAAE;YACnC,UAAU,EAAE,IAAI,CAAC,iBAAiB,CAAC,aAAa,CAAC,UAAU,IAAI,EAAE,CAAC;SACnE,CAAC;QAEF,4EAA4E;QAC5E,+FAA+F;QAC/F,MAAM,QAAQ,GAAG,iBAAiB,EAAE,CAAC;QACrC,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,QAAQ,CAAC,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAChF,CAAC;QACF,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACnD,IAAI,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACxD,IAAI,SAAS,EAAE,CAAC;oBACd,kBAAkB,CAAC,UAAU,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;gBACtF,CAAC;YACH,CAAC;iBAAM,IAAI,eAAe,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3C,kBAAkB,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;YACtC,CAAC;YACD,2EAA2E;QAC7E,CAAC;QAED,qEAAqE;QACrE,IAAI,aAAa,CAAC,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;YAC1E,MAAM,mBAAmB,GAAyB,EAAE,CAAC;YACrD,KAAK,MAAM,UAAU,IAAI,aAAa,CAAC,WAAW,EAAE,CAAC;gBACnD,MAAM,MAAM,GAAG,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;gBAC5D,IAAI,MAAM,EAAE,CAAC;oBACX,mBAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,QAAQ,CAAC,IAAI,CAChB,cAAc,aAAa,+BAA+B,UAAU,8CAA8C,CACnH,CAAC;gBACJ,CAAC;YACH,CAAC;YACD,kBAAkB,CAAC,WAAW,GAAG,mBAAmB,CAAC;QACvD,CAAC;QAED,+DAA+D;QAC/D,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YAC9B,kBAA0B,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,YAAoB,EAAE,YAAiB;QAC7D,gEAAgE;QAChE,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,SAAS,EAAE,YAAY,EAAE,4BAA4B;YACrD,GAAG,YAAY;SAChB,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,iBAAiB,CAAC,cAAmB;QAC3C,MAAM,UAAU,GAAoB,EAAE,CAAC;QAEvC,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,CAAC;YACpE,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBACnC,oFAAoF;gBACpF,MAAM,QAAQ,GAAG,IAAI,CAAC,wBAAwB,CAAC,QAAQ,EAAE,UAAoB,CAAC,CAAC;gBAC/E,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC5B,CAAC;iBAAM,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;gBAC1C,0BAA0B;gBAC1B,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAE,QAAQ;oBACd,QAAQ,EAAG,UAAkB,CAAC,QAAQ,IAAI,QAAQ;oBAClD,WAAW,EAAG,UAAkB,CAAC,WAAW,IAAI,gBAAgB,QAAQ,EAAE;oBAC1E,SAAS,EAAE,IAAI;oBACf,QAAQ,EAAG,UAAkB,CAAC,QAAQ;oBACtC,MAAM,EAAG,UAAkB,CAAC,MAAM;oBAClC,UAAU,EAAG,UAAkB,CAAC,UAAU;iBAC3C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;OAGG;IACK,wBAAwB,CAAC,IAAY,EAAE,UAAkB;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAgD,CAAC;QACzE,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAEjC,MAAM,IAAI,GAAkB;YAC1B,IAAI;YACJ,QAAQ;YACR,WAAW,EAAE,gBAAgB,IAAI,EAAE;YACnC,UAAU,EAAE,EAAE;YACd,SAAS,EAAE,IAAI;SAChB,CAAC;QAEF,6CAA6C;QAC7C,MAAM,SAAS,GAAqF;YAClG,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE;YAC9D,QAAQ,EAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE;SAC7D,CAAC;QACF,MAAM,OAAO,GAAsH;YACjI,SAAS,EAAM,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE;YAC1E,QAAQ,EAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE;YACxE,KAAK,EAAU,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE;YACtE,KAAK,EAAU,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE;YACtE,QAAQ,EAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE;YACzE,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE;SACzE,CAAC;QAEF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,oCAAoC;YACpC,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;YACpC,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAW,CAAC;gBAC/D,GAAW,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC;gBAC5C,SAAS;YACX,CAAC;YAED,sBAAsB;YACtB,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;gBAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC3B,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAW,CAAC;oBAC9D,QAAQ,KAAK,CAAC,KAAK,EAAE,CAAC;wBACpB,KAAK,QAAQ;4BAAI,GAAW,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;4BAAC,MAAM;wBAC1E,KAAK,QAAQ;4BAAI,GAAW,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;4BAAC,MAAM;wBACnF,KAAK,QAAQ;4BAAI,GAAW,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;4BAAC,MAAM;wBACtF,KAAK,OAAO;4BAAK,GAAW,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;4BAAC,MAAM;oBACpF,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACK,UAAU,CAAC,IAAY;QAC7B,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,OAAO,GAAG,EAAE,CAAC;QACjB,IAAI,UAAU,GAAG,CAAC,CAAC;QACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,IAAI,SAAS,GAAG,EAAE,CAAC;QAEnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACrB,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAE1C,gBAAgB;YAChB,IAAI,CAAC,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;gBACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,QAAQ,GAAG,IAAI,CAAC;oBAChB,SAAS,GAAG,IAAI,CAAC;gBACnB,CAAC;qBAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBAC9B,QAAQ,GAAG,KAAK,CAAC;oBACjB,SAAS,GAAG,EAAE,CAAC;gBACjB,CAAC;YACH,CAAC;YAED,4CAA4C;YAC5C,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,IAAI,IAAI,KAAK,GAAG;oBAAE,UAAU,EAAE,CAAC;gBAC/B,IAAI,IAAI,KAAK,GAAG;oBAAE,UAAU,EAAE,CAAC;YACjC,CAAC;YAED,0DAA0D;YAC1D,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACtD,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;oBACnB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC3B,OAAO,GAAG,EAAE,CAAC;gBACf,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,OAAO,IAAI,IAAI,CAAC;YAClB,CAAC;QACH,CAAC;QAED,oBAAoB;QACpB,IAAI,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7B,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,QAAgB;QACvC,0BAA0B;QAC1B,MAAM,gBAAgB,GAAG,QAAQ,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACvD,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,2BAA2B;QAC3B,MAAM,gBAAgB,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACtD,IAAI,gBAAgB,EAAE,CAAC;YACrB,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAED,sCAAsC;QACtC,OAAO,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,QAAgB;QACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;QAC9C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAChC,2CAA2C;YAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,EAAE,CAAC;YACZ,CAAC;YACD,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/parser/import-resolver/cache.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Local cache for URL imports
+ */
+import { CachedItem, CacheOptions } from './types.js';
+export declare class LocalCache {
+    private cacheDir;
+    private defaultTTL;
+    constructor(cacheDir?: string, defaultTTL?: number);
+    /**
+     * Get cached content for a URL
+     */
+    get(url: string): Promise<CachedItem | null>;
+    /**
+     * Store content in cache
+     */
+    put(url: string, content: string, options?: CacheOptions): Promise<void>;
+    /**
+     * Remove cached content
+     */
+    remove(url: string): Promise<void>;
+    /**
+     * Clear all cached content
+     */
+    clear(): Promise<void>;
+    /**
+     * Get cache statistics
+     */
+    stats(): Promise<{
+        size: number;
+        count: number;
+        oldestEntry: number | null;
+        newestEntry: number | null;
+    }>;
+    /**
+     * Get the cache directory path
+     */
+    getCacheDir(): string;
+    /**
+     * List all cached URLs
+     */
+    list(): Promise<Array<{
+        url: string;
+        cached: number;
+        expires: number;
+        size: number;
+    }>>;
+    /**
+     * Generate hash for URL (used as filename)
+     */
+    private hashUrl;
+    /**
+     * Detect content type from URL or content
+     */
+    private detectContentType;
+}
+//# sourceMappingURL=cache.d.ts.map

package/dist/parser/import-resolver/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/parser/import-resolver/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EAAE,UAAU,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAC;AAErE,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;gBAEf,QAAQ,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;IAKlD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAiClD;;OAEG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB9E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAaxC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,CAAC;IAwCF;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAyB5F;;OAEG;IACH,OAAO,CAAC,OAAO;IAIf;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAY1B"}

package/dist/parser/import-resolver/cache.js

@@ -0,0 +1,191 @@
+/**
+ * Local cache for URL imports
+ */
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+export class LocalCache {
+    cacheDir;
+    defaultTTL;
+    constructor(cacheDir, defaultTTL) {
+        this.cacheDir = cacheDir || path.join(os.homedir(), '.specverse', 'cache');
+        this.defaultTTL = defaultTTL || 24 * 60 * 60 * 1000; // 24 hours default
+    }
+    /**
+     * Get cached content for a URL
+     */
+    async get(url) {
+        const hash = this.hashUrl(url);
+        const cachePath = path.join(this.cacheDir, hash);
+        const metaPath = `${cachePath}.meta`;
+        try {
+            // Check if cache files exist
+            await fs.access(cachePath);
+            await fs.access(metaPath);
+            // Read metadata
+            const metaContent = await fs.readFile(metaPath, 'utf8');
+            const meta = JSON.parse(metaContent);
+            // Check if expired
+            if (Date.now() > meta.expires) {
+                await this.remove(url);
+                return null;
+            }
+            // Read content
+            const content = await fs.readFile(cachePath, 'utf8');
+            return {
+                content,
+                meta
+            };
+        }
+        catch (error) {
+            // Cache miss or error reading cache
+            return null;
+        }
+    }
+    /**
+     * Store content in cache
+     */
+    async put(url, content, options) {
+        // Ensure cache directory exists
+        await fs.mkdir(this.cacheDir, { recursive: true });
+        const hash = this.hashUrl(url);
+        const cachePath = path.join(this.cacheDir, hash);
+        const metaPath = `${cachePath}.meta`;
+        const ttl = options?.ttl || this.defaultTTL;
+        const now = Date.now();
+        const meta = {
+            url,
+            cached: now,
+            expires: now + ttl,
+            etag: options?.etag,
+            contentType: this.detectContentType(url, content),
+            size: Buffer.byteLength(content, 'utf8')
+        };
+        // Write content and metadata
+        await fs.writeFile(cachePath, content, 'utf8');
+        await fs.writeFile(metaPath, JSON.stringify(meta, null, 2), 'utf8');
+    }
+    /**
+     * Remove cached content
+     */
+    async remove(url) {
+        const hash = this.hashUrl(url);
+        const cachePath = path.join(this.cacheDir, hash);
+        const metaPath = `${cachePath}.meta`;
+        try {
+            await fs.unlink(cachePath);
+            await fs.unlink(metaPath);
+        }
+        catch (error) {
+            // Ignore errors if files don't exist
+        }
+    }
+    /**
+     * Clear all cached content
+     */
+    async clear() {
+        try {
+            const files = await fs.readdir(this.cacheDir);
+            for (const file of files) {
+                const filePath = path.join(this.cacheDir, file);
+                await fs.unlink(filePath);
+            }
+        }
+        catch (error) {
+            // Ignore if cache directory doesn't exist
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    async stats() {
+        try {
+            const files = await fs.readdir(this.cacheDir);
+            const metaFiles = files.filter(f => f.endsWith('.meta'));
+            let totalSize = 0;
+            let oldest = null;
+            let newest = null;
+            for (const metaFile of metaFiles) {
+                const metaPath = path.join(this.cacheDir, metaFile);
+                const metaContent = await fs.readFile(metaPath, 'utf8');
+                const meta = JSON.parse(metaContent);
+                totalSize += meta.size;
+                if (oldest === null || meta.cached < oldest) {
+                    oldest = meta.cached;
+                }
+                if (newest === null || meta.cached > newest) {
+                    newest = meta.cached;
+                }
+            }
+            return {
+                size: totalSize,
+                count: metaFiles.length,
+                oldestEntry: oldest,
+                newestEntry: newest
+            };
+        }
+        catch (error) {
+            return {
+                size: 0,
+                count: 0,
+                oldestEntry: null,
+                newestEntry: null
+            };
+        }
+    }
+    /**
+     * Get the cache directory path
+     */
+    getCacheDir() {
+        return this.cacheDir;
+    }
+    /**
+     * List all cached URLs
+     */
+    async list() {
+        try {
+            const files = await fs.readdir(this.cacheDir);
+            const metaFiles = files.filter(f => f.endsWith('.meta'));
+            const entries = [];
+            for (const metaFile of metaFiles) {
+                const metaPath = path.join(this.cacheDir, metaFile);
+                const metaContent = await fs.readFile(metaPath, 'utf8');
+                const meta = JSON.parse(metaContent);
+                entries.push({
+                    url: meta.url,
+                    cached: meta.cached,
+                    expires: meta.expires,
+                    size: meta.size
+                });
+            }
+            return entries;
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Generate hash for URL (used as filename)
+     */
+    hashUrl(url) {
+        return crypto.createHash('sha256').update(url).digest('hex');
+    }
+    /**
+     * Detect content type from URL or content
+     */
+    detectContentType(url, content) {
+        // Check URL extension
+        if (url.endsWith('.json'))
+            return 'json';
+        if (url.endsWith('.yaml') || url.endsWith('.yml'))
+            return 'yaml';
+        // Try to detect from content
+        const trimmed = content.trim();
+        if (trimmed.startsWith('{') || trimmed.startsWith('['))
+            return 'json';
+        // Default to YAML
+        return 'yaml';
+    }
+}
+//# sourceMappingURL=cache.js.map

package/dist/parser/import-resolver/cache.js.map

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

package/dist/parser/import-resolver/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * SpecVerse Import Resolver
+ *
+ * Simplified import resolution for SpecVerse v3.1
+ * Supports: Local files, NPM packages, and URLs (with caching)
+ */
+export { ImportResolver } from './resolver.js';
+export { LocalCache } from './cache.js';
+export type { ImportSpec, ResolvedImport, ImportResolverOptions, CacheOptions, CachedItem } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/parser/import-resolver/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/parser/import-resolver/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EACV,UAAU,EACV,cAAc,EACd,qBAAqB,EACrB,YAAY,EACZ,UAAU,EACX,MAAM,YAAY,CAAC"}

package/dist/parser/import-resolver/index.js

@@ -0,0 +1,9 @@
+/**
+ * SpecVerse Import Resolver
+ *
+ * Simplified import resolution for SpecVerse v3.1
+ * Supports: Local files, NPM packages, and URLs (with caching)
+ */
+export { ImportResolver } from './resolver.js';
+export { LocalCache } from './cache.js';
+//# sourceMappingURL=index.js.map

package/dist/parser/import-resolver/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/parser/import-resolver/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}