@specverse/engines 4.1.0

package/dist/registry/types/validation.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Validation Type Definitions
+ *
+ * Types for manifest validation and error reporting.
+ *
+ * @module registry/types/validation
+ * @version 2.0.0
+ */
+import type { RegistryResponse } from './registry.js';
+/**
+ * Validation severity levels
+ */
+export type ValidationSeverity = 'error' | 'warning' | 'info';
+/**
+ * Validation stage
+ */
+export type ValidationStage = 'manifest' | 'installation';
+/**
+ * Validation issue/error
+ *
+ * Represents a single validation problem found during manifest or installation validation.
+ */
+export interface ValidationIssue {
+    /** Error code (e.g., "MANIFEST-001") */
+    code: string;
+    /** Severity level */
+    severity: ValidationSeverity;
+    /** Validation stage where this issue was found */
+    stage: ValidationStage;
+    /** Short title for the issue */
+    title: string;
+    /** Detailed message explaining the issue */
+    message: string;
+    /** File where the issue was found */
+    file: string;
+    /** Line number in the file (0 if unknown) */
+    line: number;
+    /** Column number in the file (0 if unknown) */
+    column: number;
+    /** Code snippet showing the problematic section (optional) */
+    snippet?: string;
+    /** Suggestions for fixing the issue */
+    suggestions?: string[];
+    /** Auto-fix command (e.g., "npm install @specverse/factories-prisma@3.3.0") */
+    fix?: string;
+    /** URL to learn more about this issue */
+    learnMoreUrl?: string;
+}
+/**
+ * Validation result
+ *
+ * Complete result of running validation on a manifest.
+ */
+export interface ValidationResult {
+    /** True if validation passed (no errors) */
+    valid: boolean;
+    /** List of errors found */
+    errors: ValidationIssue[];
+    /** List of warnings found */
+    warnings: ValidationIssue[];
+    /** List of informational messages */
+    info: ValidationIssue[];
+}
+/**
+ * Validation rule interface
+ *
+ * All validation rules must implement this interface.
+ */
+export interface ValidationRule {
+    /** Unique error code for this rule */
+    code: string;
+    /** Human-readable name for this rule */
+    name: string;
+    /** Default severity for issues from this rule */
+    severity: ValidationSeverity;
+    /** Stage where this rule runs */
+    stage: ValidationStage;
+    /**
+     * Validate manifest against registry metadata
+     *
+     * @param manifest - The manifest to validate
+     * @param registry - Registry metadata to validate against
+     * @returns Array of validation issues found
+     */
+    validate(manifest: any, registry: RegistryResponse): ValidationIssue[];
+}
+/**
+ * Manifest validation options
+ */
+export interface ManifestValidationOptions {
+    /** Treat warnings as errors */
+    strict?: boolean;
+    /** Skip deprecated factory checks */
+    skipDeprecated?: boolean;
+    /** File path for error reporting */
+    filePath?: string;
+}
+/**
+ * Installation validation options
+ */
+export interface InstallationValidationOptions {
+    /** Auto-install missing packages */
+    autoInstall?: boolean;
+    /** Check git sources (requires git command) */
+    checkGit?: boolean;
+    /** Check URL sources (requires network) */
+    checkUrl?: boolean;
+}
+/**
+ * Combined validation options
+ */
+export interface ValidationOptions extends ManifestValidationOptions, InstallationValidationOptions {
+    /** Run manifest validation (Stage 2) */
+    checkManifest?: boolean;
+    /** Run installation validation (Stage 3) */
+    checkInstalled?: boolean;
+    /** Use offline mode (cached registry metadata) */
+    offline?: boolean;
+}
+/**
+ * Type guard to check if issue is an error
+ */
+export declare function isError(issue: ValidationIssue): boolean;
+/**
+ * Type guard to check if issue is a warning
+ */
+export declare function isWarning(issue: ValidationIssue): boolean;
+/**
+ * Type guard to check if issue is info
+ */
+export declare function isInfo(issue: ValidationIssue): boolean;
+/**
+ * Helper to filter issues by severity
+ */
+export declare function filterBySeverity(issues: ValidationIssue[], severity: ValidationSeverity): ValidationIssue[];
+/**
+ * Helper to filter issues by stage
+ */
+export declare function filterByStage(issues: ValidationIssue[], stage: ValidationStage): ValidationIssue[];
+/**
+ * Helper to check if validation result has errors
+ */
+export declare function hasErrors(result: ValidationResult): boolean;
+/**
+ * Helper to check if validation result has warnings
+ */
+export declare function hasWarnings(result: ValidationResult): boolean;
+/**
+ * Helper to get total issue count
+ */
+export declare function getTotalIssues(result: ValidationResult): number;
+/**
+ * Helper to merge multiple validation results
+ */
+export declare function mergeResults(...results: ValidationResult[]): ValidationResult;
+/**
+ * Helper to create a validation issue
+ */
+export declare function createIssue(code: string, severity: ValidationSeverity, stage: ValidationStage, title: string, message: string, file?: string, line?: number, column?: number): ValidationIssue;
+/**
+ * Helper to add suggestions to an issue
+ */
+export declare function withSuggestions(issue: ValidationIssue, suggestions: string[]): ValidationIssue;
+/**
+ * Helper to add fix command to an issue
+ */
+export declare function withFix(issue: ValidationIssue, fix: string): ValidationIssue;
+/**
+ * Helper to add learn more URL to an issue
+ */
+export declare function withLearnMore(issue: ValidationIssue, url: string): ValidationIssue;
+/**
+ * Error code constants
+ */
+export declare const ErrorCodes: {
+    readonly FACTORY_NOT_FOUND: "MANIFEST-001";
+    readonly FACTORY_DEPRECATED: "MANIFEST-002";
+    readonly INVALID_CAPABILITY_MAPPING: "MANIFEST-004";
+    readonly NETWORK_ERROR: "MANIFEST-005";
+    readonly STALE_CACHE: "MANIFEST-006";
+    readonly PACKAGE_NOT_INSTALLED: "REALIZE-001";
+    readonly FACTORY_FILE_NOT_FOUND: "REALIZE-002";
+    readonly VERSION_MISMATCH: "REALIZE-003";
+};
+/**
+ * Type for error codes
+ */
+export type ErrorCode = typeof ErrorCodes[keyof typeof ErrorCodes];
+/**
+ * Learn more URLs
+ */
+export declare const LearnMoreUrls: {
+    readonly REGISTRY: "https://registry.specverse.com/factories";
+    readonly MIGRATION: "https://docs.specverse.com/migration";
+    readonly CAPABILITIES: "https://docs.specverse.com/capabilities";
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/registry/types/validation.d.ts.map

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

package/dist/registry/types/validation.js

@@ -0,0 +1,140 @@
+/**
+ * Validation Type Definitions
+ *
+ * Types for manifest validation and error reporting.
+ *
+ * @module registry/types/validation
+ * @version 2.0.0
+ */
+/**
+ * Type guard to check if issue is an error
+ */
+export function isError(issue) {
+    return issue.severity === 'error';
+}
+/**
+ * Type guard to check if issue is a warning
+ */
+export function isWarning(issue) {
+    return issue.severity === 'warning';
+}
+/**
+ * Type guard to check if issue is info
+ */
+export function isInfo(issue) {
+    return issue.severity === 'info';
+}
+/**
+ * Helper to filter issues by severity
+ */
+export function filterBySeverity(issues, severity) {
+    return issues.filter(issue => issue.severity === severity);
+}
+/**
+ * Helper to filter issues by stage
+ */
+export function filterByStage(issues, stage) {
+    return issues.filter(issue => issue.stage === stage);
+}
+/**
+ * Helper to check if validation result has errors
+ */
+export function hasErrors(result) {
+    return result.errors.length > 0;
+}
+/**
+ * Helper to check if validation result has warnings
+ */
+export function hasWarnings(result) {
+    return result.warnings.length > 0;
+}
+/**
+ * Helper to get total issue count
+ */
+export function getTotalIssues(result) {
+    return result.errors.length + result.warnings.length + result.info.length;
+}
+/**
+ * Helper to merge multiple validation results
+ */
+export function mergeResults(...results) {
+    const merged = {
+        valid: true,
+        errors: [],
+        warnings: [],
+        info: []
+    };
+    for (const result of results) {
+        merged.errors.push(...result.errors);
+        merged.warnings.push(...result.warnings);
+        merged.info.push(...result.info);
+    }
+    merged.valid = merged.errors.length === 0;
+    return merged;
+}
+/**
+ * Helper to create a validation issue
+ */
+export function createIssue(code, severity, stage, title, message, file = 'manifests/implementation.yaml', line = 0, column = 0) {
+    return {
+        code,
+        severity,
+        stage,
+        title,
+        message,
+        file,
+        line,
+        column
+    };
+}
+/**
+ * Helper to add suggestions to an issue
+ */
+export function withSuggestions(issue, suggestions) {
+    return {
+        ...issue,
+        suggestions
+    };
+}
+/**
+ * Helper to add fix command to an issue
+ */
+export function withFix(issue, fix) {
+    return {
+        ...issue,
+        fix
+    };
+}
+/**
+ * Helper to add learn more URL to an issue
+ */
+export function withLearnMore(issue, url) {
+    return {
+        ...issue,
+        learnMoreUrl: url
+    };
+}
+/**
+ * Error code constants
+ */
+export const ErrorCodes = {
+    // Stage 2: Manifest validation
+    FACTORY_NOT_FOUND: 'MANIFEST-001',
+    FACTORY_DEPRECATED: 'MANIFEST-002',
+    INVALID_CAPABILITY_MAPPING: 'MANIFEST-004',
+    NETWORK_ERROR: 'MANIFEST-005',
+    STALE_CACHE: 'MANIFEST-006',
+    // Stage 3: Installation validation
+    PACKAGE_NOT_INSTALLED: 'REALIZE-001',
+    FACTORY_FILE_NOT_FOUND: 'REALIZE-002',
+    VERSION_MISMATCH: 'REALIZE-003'
+};
+/**
+ * Learn more URLs
+ */
+export const LearnMoreUrls = {
+    REGISTRY: 'https://registry.specverse.com/factories',
+    MIGRATION: 'https://docs.specverse.com/migration',
+    CAPABILITIES: 'https://docs.specverse.com/capabilities'
+};
+//# sourceMappingURL=validation.js.map

package/dist/registry/types/validation.js.map

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

package/dist/registry/utils/manifest-adapter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Manifest Adapter
+ *
+ * Bridges between ManifestConfig (realize format) and SpecVerseManifest (validation format).
+ * Converts the unified manifest format to the structure expected by validators.
+ *
+ * @module registry/utils/manifest-adapter
+ * @version 1.0.0
+ */
+import type { SpecVerseManifest } from '../validators/manifest-validator.js';
+import type { ManifestConfig } from '../../realize/index.js';
+/**
+ * Convert ManifestConfig to SpecVerseManifest
+ *
+ * Extracts instance factories and capability mappings from the unified format.
+ * Supports both v3.6 (defaults/overrides) and v3.3 (capabilityMappings/instanceMappings).
+ *
+ * @param manifestConfig - Full manifest configuration
+ * @returns SpecVerseManifest suitable for validation
+ */
+export declare function manifestConfigToSpecVerseManifest(manifestConfig: ManifestConfig): SpecVerseManifest;
+/**
+ * Validate that capability mappings reference declared factories
+ *
+ * Supports both v3.6 (defaults/overrides) and v3.3 (capabilityMappings/instanceMappings).
+ *
+ * @param manifest - Manifest configuration to validate
+ * @returns Validation errors (empty if valid)
+ */
+export declare function validateFactoryReferences(manifest: ManifestConfig): string[];
+/**
+ * Get all factory names from manifest
+ *
+ * Extracts factory names from instanceFactories, overrides, capabilityMappings, and instanceMappings.
+ * Supports both v3.6 and v3.3 formats.
+ * Useful for determining what needs to be declared.
+ *
+ * @param manifest - Manifest configuration
+ * @returns Set of factory names
+ */
+export declare function getReferencedFactoryNames(manifest: ManifestConfig): Set<string>;
+//# sourceMappingURL=manifest-adapter.d.ts.map

package/dist/registry/utils/manifest-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-adapter.d.ts","sourceRoot":"","sources":["../../../src/registry/utils/manifest-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAA8B,MAAM,wBAAwB,CAAC;AAGzF;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAC/C,cAAc,EAAE,cAAc,GAC7B,iBAAiB,CAkDnB;AAyCD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE,CAoD5E;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,cAAc,GAAG,GAAG,CAAC,MAAM,CAAC,CAkC/E"}

package/dist/registry/utils/manifest-adapter.js

@@ -0,0 +1,182 @@
+/**
+ * Manifest Adapter
+ *
+ * Bridges between ManifestConfig (realize format) and SpecVerseManifest (validation format).
+ * Converts the unified manifest format to the structure expected by validators.
+ *
+ * @module registry/utils/manifest-adapter
+ * @version 1.0.0
+ */
+import { getEffectiveMappings } from '../../realize/index.js';
+/**
+ * Convert ManifestConfig to SpecVerseManifest
+ *
+ * Extracts instance factories and capability mappings from the unified format.
+ * Supports both v3.6 (defaults/overrides) and v3.3 (capabilityMappings/instanceMappings).
+ *
+ * @param manifestConfig - Full manifest configuration
+ * @returns SpecVerseManifest suitable for validation
+ */
+export function manifestConfigToSpecVerseManifest(manifestConfig) {
+    // Extract instance factories if present
+    const instanceFactories = [];
+    if (manifestConfig.instanceFactories) {
+        for (const factory of manifestConfig.instanceFactories) {
+            // Convert source metadata to string format for validation
+            const sourceString = getSourceString(factory);
+            instanceFactories.push({
+                name: factory.name,
+                source: sourceString
+            });
+        }
+    }
+    // Get effective mappings (auto-migrates v3.3 to v3.6 if needed)
+    const { defaults, overrides, system } = getEffectiveMappings(manifestConfig);
+    // Build capability mappings from effective mappings
+    const capabilityMappings = [];
+    // If using v3.6 format, convert overrides with capability targets
+    if (system === 'v3.6' && overrides) {
+        for (const override of overrides) {
+            // Only include capability targets (not instance names)
+            if (isCapabilityTarget(override.target)) {
+                capabilityMappings.push({
+                    capability: override.target,
+                    instanceFactory: override.factory
+                });
+            }
+        }
+    }
+    // If using v3.3 format, use original legacy mappings (not migrated)
+    if (system === 'v3.3' && manifestConfig.capabilityMappings) {
+        capabilityMappings.push(...manifestConfig.capabilityMappings.map(mapping => ({
+            capability: mapping.capability,
+            instanceFactory: mapping.instanceFactory
+        })));
+    }
+    return {
+        specVersion: manifestConfig.specVersion,
+        instanceFactories,
+        capabilityMappings
+    };
+}
+/**
+ * Determine if a target is a capability pattern
+ *
+ * Capability patterns contain dots (e.g., "storage.database")
+ * Instance names typically don't (e.g., "primary-db")
+ *
+ * @param target - Target string to check
+ * @returns True if target looks like a capability
+ */
+function isCapabilityTarget(target) {
+    return /^[a-z]+\.[a-z]+(\.[a-z]+)*$/.test(target);
+}
+/**
+ * Get source string from factory declaration
+ *
+ * Converts structured source metadata to a string representation.
+ *
+ * @param factory - Instance factory declaration
+ * @returns Source string (e.g., "@specverse/factories-prisma")
+ */
+function getSourceString(factory) {
+    const { source } = factory;
+    switch (source.type) {
+        case 'npm':
+            return source.package || '';
+        case 'git':
+            return source.url || '';
+        case 'url':
+            return source.url || '';
+        default:
+            return '';
+    }
+}
+/**
+ * Validate that capability mappings reference declared factories
+ *
+ * Supports both v3.6 (defaults/overrides) and v3.3 (capabilityMappings/instanceMappings).
+ *
+ * @param manifest - Manifest configuration to validate
+ * @returns Validation errors (empty if valid)
+ */
+export function validateFactoryReferences(manifest) {
+    const errors = [];
+    if (!manifest.instanceFactories || manifest.instanceFactories.length === 0) {
+        // If no instance factories declared, skip validation
+        // (backward compatibility with old manifests)
+        return errors;
+    }
+    // Build map of declared factory names
+    const declaredFactories = new Set(manifest.instanceFactories.map(f => f.name));
+    // Check v3.6 overrides
+    if (manifest.overrides) {
+        for (const override of manifest.overrides) {
+            if (!declaredFactories.has(override.factory)) {
+                errors.push(`Override references undeclared factory: "${override.factory}" for target "${override.target}". ` +
+                    `Add it to instanceFactories section.`);
+            }
+        }
+    }
+    // Check v3.3 capability mappings
+    if (manifest.capabilityMappings) {
+        for (const mapping of manifest.capabilityMappings) {
+            if (!declaredFactories.has(mapping.instanceFactory)) {
+                errors.push(`Capability mapping references undeclared factory: "${mapping.instanceFactory}". ` +
+                    `Add it to instanceFactories section.`);
+            }
+        }
+    }
+    // Check v3.3 instance mappings
+    if (manifest.instanceMappings) {
+        for (const mapping of manifest.instanceMappings) {
+            const factoryName = mapping.instanceFactory;
+            if (factoryName && !declaredFactories.has(factoryName)) {
+                errors.push(`Instance mapping references undeclared factory: "${factoryName}". ` +
+                    `Add it to instanceFactories section.`);
+            }
+        }
+    }
+    return errors;
+}
+/**
+ * Get all factory names from manifest
+ *
+ * Extracts factory names from instanceFactories, overrides, capabilityMappings, and instanceMappings.
+ * Supports both v3.6 and v3.3 formats.
+ * Useful for determining what needs to be declared.
+ *
+ * @param manifest - Manifest configuration
+ * @returns Set of factory names
+ */
+export function getReferencedFactoryNames(manifest) {
+    const names = new Set();
+    // From instance factories
+    if (manifest.instanceFactories) {
+        for (const factory of manifest.instanceFactories) {
+            names.add(factory.name);
+        }
+    }
+    // From v3.6 overrides
+    if (manifest.overrides) {
+        for (const override of manifest.overrides) {
+            names.add(override.factory);
+        }
+    }
+    // From v3.3 capability mappings
+    if (manifest.capabilityMappings) {
+        for (const mapping of manifest.capabilityMappings) {
+            names.add(mapping.instanceFactory);
+        }
+    }
+    // From v3.3 instance mappings
+    if (manifest.instanceMappings) {
+        for (const mapping of manifest.instanceMappings) {
+            if (mapping.instanceFactory) {
+                names.add(mapping.instanceFactory);
+            }
+        }
+    }
+    return names;
+}
+//# sourceMappingURL=manifest-adapter.js.map

package/dist/registry/utils/manifest-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-adapter.js","sourceRoot":"","sources":["../../../src/registry/utils/manifest-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,UAAU,iCAAiC,CAC/C,cAA8B;IAE9B,wCAAwC;IACxC,MAAM,iBAAiB,GAA4C,EAAE,CAAC;IAEtE,IAAI,cAAc,CAAC,iBAAiB,EAAE,CAAC;QACrC,KAAK,MAAM,OAAO,IAAI,cAAc,CAAC,iBAAiB,EAAE,CAAC;YACvD,0DAA0D;YAC1D,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAE9C,iBAAiB,CAAC,IAAI,CAAC;gBACrB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,MAAM,EAAE,YAAY;aACrB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,oBAAoB,CAAC,cAAc,CAAC,CAAC;IAE7E,oDAAoD;IACpD,MAAM,kBAAkB,GAA2D,EAAE,CAAC;IAEtF,kEAAkE;IAClE,IAAI,MAAM,KAAK,MAAM,IAAI,SAAS,EAAE,CAAC;QACnC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,uDAAuD;YACvD,IAAI,kBAAkB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACxC,kBAAkB,CAAC,IAAI,CAAC;oBACtB,UAAU,EAAE,QAAQ,CAAC,MAAM;oBAC3B,eAAe,EAAE,QAAQ,CAAC,OAAO;iBAClC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,oEAAoE;IACpE,IAAI,MAAM,KAAK,MAAM,IAAI,cAAc,CAAC,kBAAkB,EAAE,CAAC;QAC3D,kBAAkB,CAAC,IAAI,CACrB,GAAG,cAAc,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACnD,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,eAAe,EAAE,OAAO,CAAC,eAAe;SACzC,CAAC,CAAC,CACJ,CAAC;IACJ,CAAC;IAED,OAAO;QACL,WAAW,EAAE,cAAc,CAAC,WAAW;QACvC,iBAAiB;QACjB,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,kBAAkB,CAAC,MAAc;IACxC,OAAO,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,eAAe,CAAC,OAAmC;IAC1D,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAE3B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC;QAE9B,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;QAE1B,KAAK,KAAK;YACR,OAAO,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC;QAE1B;YACE,OAAO,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAwB;IAChE,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,QAAQ,CAAC,iBAAiB,IAAI,QAAQ,CAAC,iBAAiB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3E,qDAAqD;QACrD,8CAA8C;QAC9C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sCAAsC;IACtC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAC/B,QAAQ,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAC5C,CAAC;IAEF,uBAAuB;IACvB,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC1C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7C,MAAM,CAAC,IAAI,CACT,4CAA4C,QAAQ,CAAC,OAAO,iBAAiB,QAAQ,CAAC,MAAM,KAAK;oBACjG,sCAAsC,CACvC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QAChC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;YAClD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;gBACpD,MAAM,CAAC,IAAI,CACT,sDAAsD,OAAO,CAAC,eAAe,KAAK;oBAClF,sCAAsC,CACvC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAChD,MAAM,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;YAC5C,IAAI,WAAW,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBACvD,MAAM,CAAC,IAAI,CACT,oDAAoD,WAAW,KAAK;oBACpE,sCAAsC,CACvC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAwB;IAChE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAEhC,0BAA0B;IAC1B,IAAI,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QAC/B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,iBAAiB,EAAE,CAAC;YACjD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,MAAM,QAAQ,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YAC1C,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;QAChC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,kBAAkB,EAAE,CAAC;YAClD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,8BAA8B;IAC9B,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;QAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,gBAAgB,EAAE,CAAC;YAChD,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;gBAC5B,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/registry/validators/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Registry Validators
+ *
+ * @module registry/validators
+ */
+export { Validator } from './validator.js';
+export { ManifestValidator } from './manifest-validator.js';
+export { InstallationValidator } from './installation-validator.js';
+export type { ValidatorOptions, ValidationReport } from './validator.js';
+export type { SpecVerseManifest, ManifestValidationOptions } from './manifest-validator.js';
+export type { InstallationValidationOptions, PackageInfo } from './installation-validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/registry/validators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/validators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACzE,YAAY,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAC5F,YAAY,EAAE,6BAA6B,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/registry/validators/index.js

@@ -0,0 +1,9 @@
+/**
+ * Registry Validators
+ *
+ * @module registry/validators
+ */
+export { Validator } from './validator.js';
+export { ManifestValidator } from './manifest-validator.js';
+export { InstallationValidator } from './installation-validator.js';
+//# sourceMappingURL=index.js.map

package/dist/registry/validators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/registry/validators/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}