expect(satisfiesPluginApiRange("invalid", "^1.2.0")).toBe(false);

});

it("accepts legacy bare major.minor plugin api ranges as lower bounds", () => {

expect(satisfiesPluginApiRange("2026.5.2", "2026.4")).toBe(true);

expect(satisfiesPluginApiRange("2026.4.0", "2026.4")).toBe(true);

expect(satisfiesPluginApiRange("2026.3.99", "2026.4")).toBe(false);

expect(satisfiesPluginApiRange("2026.5.2", "=2026.4")).toBe(false);

expect(satisfiesPluginApiRange("invalid", "2026.4")).toBe(false);

});

it.each(["*", "x", "X", "=*", "=x", ">=*", ">=x", "<=*", "^*", "~*"] as const)(

"accepts plugin api wildcard range %s for valid runtime versions",

(range) => {

return undefined;

}

function normalizePartialComparableVersion(version: string): {

version: string;

isPartial: boolean;

} {

const trimmed = version.trim();

return /^[vV]?[0-9]+\.[0-9]+$/.test(trimmed)

? { version: `${trimmed}.0`, isPartial: true }

: { version: trimmed, isPartial: false };

}

function compareSemver(left: string, right: string): number | null {

return compareComparableSemver(parseComparableSemver(left), parseComparableSemver(right));

return compareComparableSemver(

parseComparableSemver(normalizePartialComparableVersion(left).version),

parseComparableSemver(normalizePartialComparableVersion(right).version),

);

}

function upperBoundForCaret(version: string): string | null {

const parsed = parseComparableSemver(version);

const parsed = parseComparableSemver(normalizePartialComparableVersion(version).version);

if (!parsed) {

return null;

}

if (!match) {

return false;

}

const operator = match[1] ?? "=";

const operator = match[1];

const target = match[2]?.trim();

if (!target) {

return false;

}

const cmp = compareSemver(version, target);

const normalizedTarget = normalizePartialComparableVersion(target);

const cmp = compareSemver(version, normalizedTarget.version);

if (cmp == null) {

return false;

}

return cmp < 0;

case "=":

default:

return cmp === 0;

return normalizedTarget.isPartial && !operator ? cmp >= 0 : cmp === 0;

}

}