| "default-choice-missing-source"

| "npm-integrity-without-source"

| "npm-spec-floating"

| "npm-spec-missing-integrity";

| "npm-spec-missing-integrity"

| "npm-spec-package-name-mismatch";

export type PluginInstallNpmPinState =

| "exact-with-integrity"

export type PluginInstallNpmSourceInfo = {

spec: string;

packageName: string;

expectedPackageName?: string;

selector?: string;

selectorKind: ParsedRegistryNpmSpec["selectorKind"];

exactVersion: boolean;

warnings: readonly PluginInstallSourceWarning[];

};

export type DescribePluginInstallSourceOptions = {

expectedPackageName?: string | null;

};

function resolveNpmPinState(params: {

exactVersion: boolean;

hasIntegrity: boolean;

return value === "npm" || value === "local" ? value : undefined;

}

function normalizeExpectedPackageName(value: string | null | undefined): string | undefined {

const expected = normalizeOptionalString(value);

if (!expected) {

return undefined;

}

return parseRegistryNpmSpec(expected)?.name ?? expected;

}

export function describePluginInstallSource(

install: PluginPackageInstall,

options?: DescribePluginInstallSourceOptions,

): PluginInstallSourceInfo {

const npmSpec = normalizeOptionalString(install.npmSpec);

const localPath = normalizeOptionalString(install.localPath);

const defaultChoice = resolveDefaultChoice(install.defaultChoice);

const expectedIntegrity = normalizeOptionalString(install.expectedIntegrity);

const expectedPackageName = normalizeExpectedPackageName(options?.expectedPackageName);

const warnings: PluginInstallSourceWarning[] = [];

let npm: PluginInstallNpmSourceInfo | undefined;

if (!hasIntegrity) {

warnings.push("npm-spec-missing-integrity");

}

if (expectedPackageName && parsed.name !== expectedPackageName) {

warnings.push("npm-spec-package-name-mismatch");

}

npm = {

spec: parsed.raw,

packageName: parsed.name,

...(expectedPackageName && parsed.name !== expectedPackageName

? { expectedPackageName }

: {}),

selectorKind: parsed.selectorKind,

exactVersion,

pinState: resolveNpmPinState({ exactVersion, hasIntegrity }),