@hashicorp/kits 0.1.0

package/dist/resolution/version-resolver.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Version resolver for semver-based primitive version matching.
+ *
+ * Uses the semver library to resolve version specifications to concrete
+ * versions from the available version list.
+ */
+import type { PrimitiveVersionEntry } from "../core/types.js";
+import type { VersionResolutionResult } from "./types.js";
+/**
+ * Error thrown when version resolution fails.
+ */
+export declare class VersionResolutionError extends Error {
+    readonly spec: string;
+    readonly available: string[];
+    constructor(spec: string, available: string[], message: string);
+}
+/**
+ * Resolves a version specification to the highest matching version.
+ *
+ * @param versions - Array of available version entries
+ * @param spec - The version specification (e.g., "^1.0.0", "latest", "1.2.3")
+ * @returns The highest matching version entry, or null if no match
+ */
+export declare function resolveVersion(versions: PrimitiveVersionEntry[], spec: string): PrimitiveVersionEntry | null;
+/**
+ * Finds the highest version matching a semver specification.
+ *
+ * @param versions - Array of version strings
+ * @param spec - The version specification
+ * @returns The highest matching version string, or null if no match
+ */
+export declare function findHighestMatching(versions: string[], spec: string): string | null;
+/**
+ * Checks if a version satisfies a version specification.
+ *
+ * @param version - The version to check
+ * @param spec - The version specification
+ * @returns True if the version satisfies the spec
+ */
+export declare function satisfies(version: string, spec: string): boolean;
+/**
+ * Filters versions that satisfy a version specification.
+ *
+ * @param versions - Array of version entries
+ * @param spec - The version specification
+ * @returns Array of matching version entries, sorted newest first
+ */
+export declare function filterSatisfying(versions: PrimitiveVersionEntry[], spec: string): PrimitiveVersionEntry[];
+/**
+ * Gets version information for display purposes.
+ *
+ * @param spec - The version specification
+ * @returns Human-readable description of the spec
+ */
+export declare function describeVersionSpec(spec: string): string;
+/**
+ * Compares two version specifications to determine if they might conflict.
+ *
+ * @param specA - First version specification
+ * @param specB - Second version specification
+ * @returns True if the specs could resolve to different versions
+ */
+export declare function specsCouldConflict(specA: string, specB: string): boolean;
+/**
+ * Finds the highest version that satisfies multiple specifications.
+ *
+ * @param versions - Array of version strings
+ * @param specs - Array of version specifications
+ * @returns The highest version satisfying all specs, or null if none
+ */
+export declare function findHighestMatchingAll(versions: string[], specs: string[]): string | null;
+/**
+ * Creates a version resolution result from a version entry and base path.
+ */
+export declare function createVersionResolution(entry: PrimitiveVersionEntry, basePath: string): VersionResolutionResult;
+//# sourceMappingURL=version-resolver.d.ts.map

package/dist/resolution/version-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-resolver.d.ts","sourceRoot":"","sources":["../../src/resolution/version-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG1D;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;aAE7B,IAAI,EAAE,MAAM;aACZ,SAAS,EAAE,MAAM,EAAE;gBADnB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EAAE,EACnC,OAAO,EAAE,MAAM;CAKlB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,qBAAqB,EAAE,EACjC,IAAI,EAAE,MAAM,GACX,qBAAqB,GAAG,IAAI,CAyB9B;AAwBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBnF;AA4CD;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAkBhE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,qBAAqB,EAAE,EACjC,IAAI,EAAE,MAAM,GACX,qBAAqB,EAAE,CAWzB;AAuBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBxD;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAqBxE;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAczF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,qBAAqB,EAC5B,QAAQ,EAAE,MAAM,GACf,uBAAuB,CAOzB"}

package/dist/resolution/version-resolver.js

@@ -0,0 +1,269 @@
+/**
+ * Version resolver for semver-based primitive version matching.
+ *
+ * Uses the semver library to resolve version specifications to concrete
+ * versions from the available version list.
+ */
+import * as semver from "semver";
+import { parseVersionSpec } from "./reference-parser.js";
+/**
+ * Error thrown when version resolution fails.
+ */
+export class VersionResolutionError extends Error {
+    spec;
+    available;
+    constructor(spec, available, message) {
+        super(message);
+        this.spec = spec;
+        this.available = available;
+        this.name = "VersionResolutionError";
+    }
+}
+/**
+ * Resolves a version specification to the highest matching version.
+ *
+ * @param versions - Array of available version entries
+ * @param spec - The version specification (e.g., "^1.0.0", "latest", "1.2.3")
+ * @returns The highest matching version entry, or null if no match
+ */
+export function resolveVersion(versions, spec) {
+    if (!versions || versions.length === 0) {
+        return null;
+    }
+    // Parse the version spec to determine type
+    const parsed = parseVersionSpec(spec);
+    // Handle "latest" keyword
+    if (parsed.type === "latest") {
+        return resolveLatest(versions);
+    }
+    // Get version strings for semver matching
+    const versionStrings = versions.map((v) => v.version);
+    // Use semver to find the highest matching version
+    const matchingVersion = findHighestMatching(versionStrings, spec);
+    if (!matchingVersion) {
+        return null;
+    }
+    // Return the full version entry
+    return versions.find((v) => v.version === matchingVersion) || null;
+}
+/**
+ * Resolves "latest" to the highest available version.
+ */
+function resolveLatest(versions) {
+    if (versions.length === 0) {
+        return null;
+    }
+    // Filter to valid semver versions and sort
+    const validVersions = versions.filter((v) => semver.valid(v.version));
+    if (validVersions.length === 0) {
+        // Fallback to first version if none are valid semver
+        return versions[0] ?? null;
+    }
+    // Sort by semver descending and return highest
+    const sorted = validVersions.sort((a, b) => semver.rcompare(a.version, b.version));
+    return sorted[0] ?? null;
+}
+/**
+ * Finds the highest version matching a semver specification.
+ *
+ * @param versions - Array of version strings
+ * @param spec - The version specification
+ * @returns The highest matching version string, or null if no match
+ */
+export function findHighestMatching(versions, spec) {
+    if (!versions || versions.length === 0) {
+        return null;
+    }
+    // Handle exact version match first
+    if (semver.valid(spec)) {
+        // Check if exact version exists
+        const exactMatch = versions.find((v) => v === spec || semver.eq(v, spec));
+        if (exactMatch) {
+            return exactMatch;
+        }
+        return null;
+    }
+    // Parse the range
+    const range = normalizeRange(spec);
+    if (!range) {
+        return null;
+    }
+    // Use semver.maxSatisfying to find highest matching
+    return semver.maxSatisfying(versions, range);
+}
+/**
+ * Normalizes a version specification to a semver range string.
+ *
+ * @param spec - The version specification
+ * @returns Normalized range string or null if invalid
+ */
+function normalizeRange(spec) {
+    const trimmed = spec.trim();
+    // Handle special cases
+    if (trimmed.toLowerCase() === "latest" || trimmed === "*") {
+        return "*";
+    }
+    // Try to validate as a valid range
+    const validRange = semver.validRange(trimmed);
+    if (validRange) {
+        return validRange;
+    }
+    // Handle wildcard patterns like "1.x" or "1"
+    if (/^\d+\.x$/.test(trimmed)) {
+        const major = trimmed.split(".")[0] ?? "0";
+        return `>=${major}.0.0 <${parseInt(major) + 1}.0.0`;
+    }
+    if (/^\d+$/.test(trimmed)) {
+        const major = parseInt(trimmed);
+        return `>=${major}.0.0 <${major + 1}.0.0`;
+    }
+    // Handle partial versions like "1.2"
+    if (/^\d+\.\d+$/.test(trimmed)) {
+        const parts = trimmed.split(".").map(Number);
+        const major = parts[0] ?? 0;
+        const minor = parts[1] ?? 0;
+        return `>=${major}.${minor}.0 <${major}.${minor + 1}.0`;
+    }
+    return null;
+}
+/**
+ * Checks if a version satisfies a version specification.
+ *
+ * @param version - The version to check
+ * @param spec - The version specification
+ * @returns True if the version satisfies the spec
+ */
+export function satisfies(version, spec) {
+    // Handle latest
+    if (spec.toLowerCase() === "latest") {
+        return true;
+    }
+    // Handle exact match
+    if (semver.valid(spec)) {
+        return version === spec || semver.eq(version, spec);
+    }
+    // Handle range
+    const range = normalizeRange(spec);
+    if (!range) {
+        return false;
+    }
+    return semver.satisfies(version, range);
+}
+/**
+ * Filters versions that satisfy a version specification.
+ *
+ * @param versions - Array of version entries
+ * @param spec - The version specification
+ * @returns Array of matching version entries, sorted newest first
+ */
+export function filterSatisfying(versions, spec) {
+    // Handle latest - return all versions sorted
+    if (spec.toLowerCase() === "latest") {
+        return sortVersionsDescending(versions);
+    }
+    // Filter matching versions
+    const matching = versions.filter((v) => satisfies(v.version, spec));
+    // Sort by version descending
+    return sortVersionsDescending(matching);
+}
+/**
+ * Sorts version entries by version descending (newest first).
+ */
+function sortVersionsDescending(versions) {
+    return [...versions].sort((a, b) => {
+        const validA = semver.valid(a.version);
+        const validB = semver.valid(b.version);
+        if (validA && validB) {
+            return semver.rcompare(a.version, b.version);
+        }
+        // Non-semver versions sort after semver versions
+        if (validA)
+            return -1;
+        if (validB)
+            return 1;
+        // Lexicographic fallback
+        return b.version.localeCompare(a.version);
+    });
+}
+/**
+ * Gets version information for display purposes.
+ *
+ * @param spec - The version specification
+ * @returns Human-readable description of the spec
+ */
+export function describeVersionSpec(spec) {
+    const parsed = parseVersionSpec(spec);
+    switch (parsed.type) {
+        case "latest":
+            return "latest available version";
+        case "exact":
+            return `exact version ${spec}`;
+        case "caret":
+            return `compatible with ${spec.slice(1)}`;
+        case "tilde":
+            return `approximately ${spec.slice(1)}`;
+        case "range":
+            return `range: ${spec}`;
+        case "wildcard":
+            return `any version matching ${spec}`;
+        default:
+            return spec;
+    }
+}
+/**
+ * Compares two version specifications to determine if they might conflict.
+ *
+ * @param specA - First version specification
+ * @param specB - Second version specification
+ * @returns True if the specs could resolve to different versions
+ */
+export function specsCouldConflict(specA, specB) {
+    // Same spec never conflicts
+    if (specA === specB) {
+        return false;
+    }
+    // Latest matches everything
+    if (specA.toLowerCase() === "latest" || specB.toLowerCase() === "latest") {
+        return false;
+    }
+    // Exact versions conflict if different
+    const validA = semver.valid(specA);
+    const validB = semver.valid(specB);
+    if (validA && validB) {
+        return !semver.eq(specA, specB);
+    }
+    // Ranges might overlap or not - this is a heuristic
+    // For safety, assume they could conflict
+    return true;
+}
+/**
+ * Finds the highest version that satisfies multiple specifications.
+ *
+ * @param versions - Array of version strings
+ * @param specs - Array of version specifications
+ * @returns The highest version satisfying all specs, or null if none
+ */
+export function findHighestMatchingAll(versions, specs) {
+    if (specs.length === 0) {
+        return null;
+    }
+    // Filter to versions that satisfy all specs
+    const satisfyingAll = versions.filter((v) => specs.every((spec) => satisfies(v, spec)));
+    if (satisfyingAll.length === 0) {
+        return null;
+    }
+    // Return highest
+    return semver.maxSatisfying(satisfyingAll, "*");
+}
+/**
+ * Creates a version resolution result from a version entry and base path.
+ */
+export function createVersionResolution(entry, basePath) {
+    return {
+        version: entry.version,
+        path: basePath + "/" + entry.path,
+        released: entry.released,
+        changelog: entry.changelog,
+    };
+}
+//# sourceMappingURL=version-resolver.js.map

package/dist/resolution/version-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-resolver.js","sourceRoot":"","sources":["../../src/resolution/version-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAIjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAE7B;IACA;IAFlB,YACkB,IAAY,EACZ,SAAmB,EACnC,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,SAAI,GAAJ,IAAI,CAAQ;QACZ,cAAS,GAAT,SAAS,CAAU;QAInC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAiC,EACjC,IAAY;IAEZ,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2CAA2C;IAC3C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEtC,0BAA0B;IAC1B,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,0CAA0C;IAC1C,MAAM,cAAc,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAEtD,kDAAkD;IAClD,MAAM,eAAe,GAAG,mBAAmB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAElE,IAAI,CAAC,eAAe,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gCAAgC;IAChC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,eAAe,CAAC,IAAI,IAAI,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,QAAiC;IACtD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,2CAA2C;IAC3C,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAEtE,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,qDAAqD;QACrD,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IAC7B,CAAC;IAED,+CAA+C;IAC/C,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAEnF,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC3B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,QAAkB,EAAE,IAAY;IAClE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mCAAmC;IACnC,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,gCAAgC;QAChC,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;QAC1E,IAAI,UAAU,EAAE,CAAC;YACf,OAAO,UAAU,CAAC;QACpB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kBAAkB;IAClB,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oDAAoD;IACpD,OAAO,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAE5B,uBAAuB;IACvB,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,QAAQ,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QAC1D,OAAO,GAAG,CAAC;IACb,CAAC;IAED,mCAAmC;IACnC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,6CAA6C;IAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QAC3C,OAAO,KAAK,KAAK,SAAS,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC;IACtD,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,KAAK,KAAK,SAAS,KAAK,GAAG,CAAC,MAAM,CAAC;IAC5C,CAAC;IAED,qCAAqC;IACrC,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,KAAK,KAAK,IAAI,KAAK,OAAO,KAAK,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC;IAC1D,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,IAAY;IACrD,gBAAgB;IAChB,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,qBAAqB;IACrB,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,eAAe;IACf,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAiC,EACjC,IAAY;IAEZ,6CAA6C;IAC7C,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;QACpC,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,2BAA2B;IAC3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAEpE,6BAA6B;IAC7B,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAS,sBAAsB,CAAC,QAAiC;IAC/D,OAAO,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAEvC,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;YACrB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAC/C,CAAC;QAED,iDAAiD;QACjD,IAAI,MAAM;YAAE,OAAO,CAAC,CAAC,CAAC;QACtB,IAAI,MAAM;YAAE,OAAO,CAAC,CAAC;QAErB,yBAAyB;QACzB,OAAO,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAEtC,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,OAAO,0BAA0B,CAAC;QACpC,KAAK,OAAO;YACV,OAAO,iBAAiB,IAAI,EAAE,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,mBAAmB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,KAAK,OAAO;YACV,OAAO,iBAAiB,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1C,KAAK,OAAO;YACV,OAAO,UAAU,IAAI,EAAE,CAAC;QAC1B,KAAK,UAAU;YACb,OAAO,wBAAwB,IAAI,EAAE,CAAC;QACxC;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,KAAa;IAC7D,4BAA4B;IAC5B,IAAI,KAAK,KAAK,KAAK,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,4BAA4B;IAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,QAAQ,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,QAAQ,EAAE,CAAC;QACzE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,uCAAuC;IACvC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;QACrB,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC;IAED,oDAAoD;IACpD,yCAAyC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAkB,EAAE,KAAe;IACxE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,4CAA4C;IAC5C,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAExF,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB;IACjB,OAAO,MAAM,CAAC,aAAa,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,KAA4B,EAC5B,QAAgB;IAEhB,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,QAAQ,GAAG,GAAG,GAAG,KAAK,CAAC,IAAI;QACjC,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC;AACJ,CAAC"}

package/dist/tui/compatibility.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Compatibility check screen.
+ *
+ * Displays compatibility matrix between selected kits and harnesses,
+ * showing missing primitives and experimental features.
+ */
+import type { HarnessName, InstallationScope, PrimitiveType } from "../core/types.js";
+import type { DiscoveredKit } from "../discovery/types.js";
+import type { CompatibilityDisplay, CompatibilityMatrixDisplay, CompatibilityCheckResult, DetectedHarnessDisplay } from "./types.js";
+/**
+ * Check compatibility of a kit against a harness.
+ */
+export declare function checkKitHarnessCompatibility(kit: DiscoveredKit, harness: DetectedHarnessDisplay): CompatibilityDisplay;
+/**
+ * Build compatibility matrix for selected kits and harnesses.
+ */
+export declare function buildCompatibilityMatrix(kits: DiscoveredKit[], harnesses: DetectedHarnessDisplay[]): CompatibilityMatrixDisplay[];
+/**
+ * Display compatibility matrix for a single kit.
+ */
+export declare function displayKitCompatibility(matrix: CompatibilityMatrixDisplay): void;
+/**
+ * Display full compatibility matrix.
+ */
+export declare function displayCompatibilityMatrix(matrices: CompatibilityMatrixDisplay[], context: {
+    kits: DiscoveredKit[];
+    harnesses: DetectedHarnessDisplay[];
+    scope: InstallationScope;
+}): void;
+/**
+ * Check if any incompatibilities exist in the matrix.
+ */
+export declare function hasIncompatibilities(matrices: CompatibilityMatrixDisplay[]): boolean;
+/**
+ * Get incompatible kit-harness pairs.
+ */
+export declare function getIncompatiblePairs(matrices: CompatibilityMatrixDisplay[]): {
+    kit: string;
+    harness: HarnessName;
+    missing: PrimitiveType[];
+}[];
+/**
+ * Get compatible kit-harness pairs.
+ */
+export declare function getCompatiblePairs(matrices: CompatibilityMatrixDisplay[]): {
+    kit: string;
+    harness: HarnessName;
+}[];
+/**
+ * Display incompatibility summary.
+ */
+export declare function displayIncompatibilitySummary(matrices: CompatibilityMatrixDisplay[], scope: InstallationScope): void;
+/**
+ * Prompt user how to handle incompatibilities.
+ */
+export declare function promptIncompatibilityChoice(matrices: CompatibilityMatrixDisplay[], scope: InstallationScope): Promise<CompatibilityCheckResult>;
+/**
+ * Run compatibility check flow.
+ * Returns the check result and filtered compatible pairs.
+ */
+export declare function runCompatibilityCheck(kits: DiscoveredKit[], harnesses: DetectedHarnessDisplay[], scope: InstallationScope, options?: {
+    showMatrix?: boolean;
+    promptOnIncompatible?: boolean;
+}): Promise<{
+    matrices: CompatibilityMatrixDisplay[];
+    result: CompatibilityCheckResult;
+    compatiblePairs: {
+        kit: string;
+        harness: HarnessName;
+    }[];
+}>;
+/**
+ * Get kits that are compatible with at least one selected harness.
+ */
+export declare function getCompatibleKits(matrices: CompatibilityMatrixDisplay[]): string[];
+/**
+ * Get harnesses that are compatible with at least one selected kit.
+ */
+export declare function getCompatibleHarnesses(matrices: CompatibilityMatrixDisplay[]): HarnessName[];
+//# sourceMappingURL=compatibility.d.ts.map

package/dist/tui/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/tui/compatibility.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EAExB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,sBAAsB,GAC9B,oBAAoB,CAqBtB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,aAAa,EAAE,EACrB,SAAS,EAAE,sBAAsB,EAAE,GAClC,0BAA0B,EAAE,CAc9B;AAmBD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI,CA4BhF;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,0BAA0B,EAAE,EACtC,OAAO,EAAE;IACP,IAAI,EAAE,aAAa,EAAE,CAAC;IACtB,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,KAAK,EAAE,iBAAiB,CAAC;CAC1B,GACA,IAAI,CA2DN;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,0BAA0B,EAAE,GAAG,OAAO,CAEpF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,0BAA0B,EAAE,GACrC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAA;CAAE,EAAE,CAgBnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,0BAA0B,EAAE,GACrC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,WAAW,CAAA;CAAE,EAAE,CAezC;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,0BAA0B,EAAE,EACtC,KAAK,EAAE,iBAAiB,GACvB,IAAI,CAsBN;AAED;;GAEG;AACH,wBAAsB,2BAA2B,CAC/C,QAAQ,EAAE,0BAA0B,EAAE,EACtC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,wBAAwB,CAAC,CAkDnC;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,aAAa,EAAE,EACrB,SAAS,EAAE,sBAAsB,EAAE,EACnC,KAAK,EAAE,iBAAiB,EACxB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GACA,OAAO,CAAC;IACT,QAAQ,EAAE,0BAA0B,EAAE,CAAC;IACvC,MAAM,EAAE,wBAAwB,CAAC;IACjC,eAAe,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,WAAW,CAAA;KAAE,EAAE,CAAC;CAC1D,CAAC,CAkFD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,0BAA0B,EAAE,GACrC,MAAM,EAAE,CAaV;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,0BAA0B,EAAE,GACrC,WAAW,EAAE,CAYf"}