universal-plugin 0.7.0 → 0.9.0

package/dist/run.mjs

@@ -1,271 +0,0 @@
-#!/usr/bin/env node
-import * as fsNode from "node:fs";
-import * as path from "node:path";
-import * as semver$1 from "semver";
-import { spawnSync } from "node:child_process";
-//#region src/run/fs.ts
-function readInstall(dir) {
-	try {
-		const raw = fsNode.readFileSync(path.join(dir, "package.json"), "utf8");
-		const pkg = JSON.parse(raw);
-		if (typeof pkg.version !== "string") return void 0;
-		return {
-			dir,
-			version: pkg.version,
-			bin: pkg.bin
-		};
-	} catch {
-		return;
-	}
-}
-function packageDirIn(nodeModulesDir, pkg) {
-	return path.join(nodeModulesDir, ...pkg.split("/"));
-}
-/** Every ancestor `node_modules` directory from `startDir` up to the filesystem root, nearest
-*  first. */
-function ancestorNodeModulesDirs(startDir) {
-	const dirs = [];
-	let dir = startDir;
-	for (;;) {
-		dirs.push(path.join(dir, "node_modules"));
-		const parent = path.dirname(dir);
-		if (parent === dir) break;
-		dir = parent;
-	}
-	return dirs;
-}
-/** Walks `node_modules` from `cwd` up through its ancestors, nearest first, collecting every
-*  install of `pkg` found along the way (an install missing a readable `package.json` version is
-*  skipped, not a match). */
-function findLocalInstalls(pkg, cwd) {
-	const installs = [];
-	for (const nodeModulesDir of ancestorNodeModulesDirs(cwd)) {
-		const install = readInstall(packageDirIn(nodeModulesDir, pkg));
-		if (install) installs.push(install);
-	}
-	return installs;
-}
-function globalRoot() {
-	try {
-		const out = spawnSync("npm", ["root", "-g"], { encoding: "utf8" }).stdout?.trim();
-		return out ? out : void 0;
-	} catch {
-		return;
-	}
-}
-function findGlobalInstall(pkg) {
-	const root = globalRoot();
-	if (!root) return void 0;
-	return readInstall(packageDirIn(root, pkg));
-}
-function spawnBin(binPath, args) {
-	const result = spawnSync(binPath, args, { stdio: "inherit" });
-	if (result.error) throw result.error;
-	return result.status ?? 1;
-}
-function spawnNpx(args) {
-	const result = spawnSync("npx", args, { stdio: "inherit" });
-	if (result.error) throw result.error;
-	return result.status ?? 1;
-}
-function realRunFs() {
-	return {
-		findLocalInstalls: (pkg) => findLocalInstalls(pkg, process.cwd()),
-		findGlobalInstall,
-		spawnBin,
-		spawnNpx
-	};
-}
-//#endregion
-//#region src/run/run.ts
-const NPM_NAME_PATTERN = /^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/;
-/** A loose approximation of npm's package-name rules: lowercase, alphanumeric/`.`/`_`/`-`, an
-*  optional `@scope/` prefix, non-empty. Good enough to reject the obviously malformed without
-*  chasing every edge npm itself enforces. */
-function isValidPackageName(name) {
-	if (!name || name.length > 214) return false;
-	return NPM_NAME_PATTERN.test(name);
-}
-/** Splits `<pkg>@<range>` on the **last** `@` at index > 0, so a scoped name's leading `@` survives.
-*  No `@` after index 0 — or a trailing `@` with an empty range — is a bare package (range `*`). A
-*  package name that is empty or violates npm's naming rules is a fail-loud error. */
-function parseSpec(spec) {
-	if (!spec) return {
-		ok: false,
-		error: "error: no package spec given"
-	};
-	const lastAt = spec.lastIndexOf("@");
-	let pkg;
-	let rangeRaw;
-	if (lastAt <= 0) {
-		pkg = spec;
-		rangeRaw = "";
-	} else {
-		pkg = spec.slice(0, lastAt);
-		rangeRaw = spec.slice(lastAt + 1);
-	}
-	if (!isValidPackageName(pkg)) return {
-		ok: false,
-		error: `error: unparseable package spec "${spec}"`
-	};
-	const bare = rangeRaw === "";
-	return {
-		ok: true,
-		spec: {
-			pkg,
-			range: bare ? "*" : rangeRaw,
-			bare
-		}
-	};
-}
-/** A valid semver range drives local-first matching; a non-empty non-semver spec (`next`,
-*  `latest`) is a dist-tag that can't be matched against an installed `package.json` version. */
-function isSemverRange(range) {
-	return semver$1.validRange(range) !== null;
-}
-/** Nearest-local → global, first install whose version satisfies `range`. `locals` must already be
-*  nearest-first. */
-function selectInstall(range, locals, globalInstall) {
-	for (const install of locals) if (semver$1.satisfies(install.version, range)) return install;
-	if (globalInstall && semver$1.satisfies(globalInstall.version, range)) return globalInstall;
-}
-/** Resolves the executable from a `package.json` `bin` field: a string bin, an object entry keyed
-*  by the package's unscoped name (even among several bins), or a single-entry object. A
-*  multi-entry object with no name match, or a missing `bin` field entirely, fails loud — `upx`
-*  never guesses which bin to run. */
-function resolveBinPath(pkgName, bin) {
-	if (bin === void 0) return {
-		ok: false,
-		error: `error: package "${pkgName}" declares no bin field`
-	};
-	if (typeof bin === "string") return {
-		ok: true,
-		bin
-	};
-	const entries = Object.entries(bin);
-	if (entries.length === 0) return {
-		ok: false,
-		error: `error: package "${pkgName}" declares no bin field`
-	};
-	if (entries.length === 1) return {
-		ok: true,
-		bin: entries[0][1]
-	};
-	const match = bin[pkgName.includes("/") ? pkgName.slice(pkgName.lastIndexOf("/") + 1) : pkgName] ?? bin[pkgName];
-	if (match) return {
-		ok: true,
-		bin: match
-	};
-	return {
-		ok: false,
-		error: `error: package "${pkgName}" declares multiple bins and none matches its name — upx never guesses which to run`
-	};
-}
-const KNOWN_LEADING_FLAGS = new Set(["--help", "-h"]);
-/** A flag is a token starting with `-`; `upx`'s own flags are recognized only before the first
-*  non-flag token (the package spec) — everything from the spec onward belongs to the child. An
-*  unknown flag before the spec fails loud. */
-function parseArgv(argv) {
-	if (argv.length === 0) return {
-		ok: false,
-		error: "error: no package spec given"
-	};
-	const first = argv[0];
-	if (first.startsWith("-")) {
-		if (KNOWN_LEADING_FLAGS.has(first)) return {
-			ok: true,
-			args: {
-				help: true,
-				spec: void 0,
-				childArgs: []
-			}
-		};
-		return {
-			ok: false,
-			error: `error: unknown flag "${first}"`
-		};
-	}
-	return {
-		ok: true,
-		args: {
-			help: false,
-			spec: first,
-			childArgs: argv.slice(1)
-		}
-	};
-}
-function fallbackNotice(pkg, range) {
-	return `upx: no installed ${pkg} satisfies "${range}", using npx`;
-}
-/** A dist-tag (`next`, `latest`) is not a version range, so the miss notice must not claim the
-*  installed versions failed to "satisfy" it — it never could. Keeps the fixed
-*  `upx: no installed <pkg>` prefix shared with {@link fallbackNotice}. */
-function distTagNotice(pkg, tag) {
-	return `upx: no installed ${pkg}; "${tag}" is a dist-tag, using npx`;
-}
-const HELP_TEXT = `Usage: upx <pkg>@<range> [args…]
-
-Runs a package's CLI from a local or global install matching <range>, falling
-back to npx when nothing installed satisfies it.
-
-Example:
-  $ upx cyberplace@^1.0.0 build
-`;
-/** Resolves `argv` (everything after `upx`) to a running child, per the Resolution algorithm in
-*  the spec: parse → classify the range → search local-then-global → resolve the bin → spawn, or
-*  fall back to npx with the spec exactly as given. */
-function runUpx(argv, fs) {
-	const parsedArgv = parseArgv(argv);
-	if (!parsedArgv.ok) return {
-		kind: "error",
-		message: parsedArgv.error
-	};
-	if (parsedArgv.args.help) return {
-		kind: "help",
-		text: HELP_TEXT
-	};
-	const specResult = parseSpec(parsedArgv.args.spec);
-	if (!specResult.ok) return {
-		kind: "error",
-		message: specResult.error
-	};
-	const { pkg, range, bare } = specResult.spec;
-	const childArgs = parsedArgv.args.childArgs;
-	const semverRange = isSemverRange(range);
-	if (semverRange) {
-		const install = selectInstall(range, fs.findLocalInstalls(pkg), fs.findGlobalInstall(pkg));
-		if (install) {
-			const binResult = resolveBinPath(pkg, install.bin);
-			if (!binResult.ok) return {
-				kind: "error",
-				message: binResult.error
-			};
-			const binPath = path.join(install.dir, binResult.bin);
-			return {
-				kind: "exit",
-				code: fs.spawnBin(binPath, childArgs)
-			};
-		}
-	}
-	const npxSpec = bare ? pkg : `${pkg}@${range}`;
-	return {
-		kind: "exit",
-		code: fs.spawnNpx([npxSpec, ...childArgs]),
-		notice: semverRange ? fallbackNotice(pkg, range) : distTagNotice(pkg, range)
-	};
-}
-//#endregion
-//#region src/run/cli.ts
-const outcome = runUpx(process.argv.slice(2), realRunFs());
-if (outcome.kind === "help") {
-	process.stdout.write(outcome.text);
-	process.exit(0);
-}
-if (outcome.kind === "error") {
-	process.stderr.write(`${outcome.message}\n`);
-	process.exit(1);
-}
-if (outcome.notice) process.stderr.write(`${outcome.notice}\n`);
-process.exit(outcome.code);
-//#endregion
-export {};