@raypx-kit/devkit 0.0.0-alpha.0

package/dist/process.mjs

@@ -0,0 +1,82 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { spawn } from "node:child_process";
+import { config } from "@dotenvx/dotenvx";
+//#region src/process.ts
+/**
+* Copies the current environment and layers local dotenv files beneath it; values
+* already set in the process win. Loaded secrets are never printed.
+*/
+function developmentEnvironment(root, files = [".env.local", ".env"]) {
+	const env = Object.fromEntries(Object.entries(process.env).filter((entry) => entry[1] !== void 0));
+	for (const file of files) {
+		const path = join(root, file);
+		if (existsSync(path)) config({
+			path,
+			processEnv: env,
+			quiet: true
+		});
+	}
+	return env;
+}
+/** Runs a command with inherited output, forwarding interrupts and rejecting on failure. */
+function run(command, args, cwd, env = process.env) {
+	return new Promise((resolve, reject) => {
+		const child = spawn(command, args, {
+			cwd,
+			env,
+			stdio: "inherit",
+			windowsHide: true
+		});
+		const forward = (signal) => {
+			child.kill(signal);
+		};
+		const interrupt = () => forward("SIGINT");
+		const terminate = () => forward("SIGTERM");
+		process.once("SIGINT", interrupt);
+		process.once("SIGTERM", terminate);
+		const cleanup = () => {
+			process.off("SIGINT", interrupt);
+			process.off("SIGTERM", terminate);
+		};
+		child.once("error", (error) => {
+			cleanup();
+			reject(error);
+		});
+		child.once("exit", (code, signal) => {
+			cleanup();
+			if (code === 0) resolve();
+			else reject(/* @__PURE__ */ new Error(`${command} exited ${code ?? signal}`));
+		});
+	});
+}
+/**
+* Runs a Turbo task under Bun. Untrusted runs drop remote cache credentials and use
+* the local cache only, so forks never read or write the shared remote cache.
+*/
+function turbo(root, task, args = [], { developmentTasks = ["dev", "build"], env: extra = {}, trustedCacheEnv = "DEVKIT_REMOTE_CACHE_TRUSTED" } = {}) {
+	const env = {
+		...developmentTasks.includes(task) ? developmentEnvironment(root) : process.env,
+		...extra
+	};
+	if (env[trustedCacheEnv] !== "true") {
+		for (const key of [
+			"TURBO_TOKEN",
+			"TURBO_TEAM",
+			"TURBO_REMOTE_CACHE_SIGNATURE_KEY"
+		]) delete env[key];
+		delete env.TURBO_REMOTE_ONLY;
+		args = ["--cache=local:rw", ...args];
+	}
+	return run(process.execPath, [
+		"--bun",
+		"turbo",
+		"run",
+		task,
+		...args
+	], root, env);
+}
+//#endregion
+export { developmentEnvironment, run, turbo };
+
+//# sourceMappingURL=process.mjs.map

package/dist/process.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.mjs","names":[],"sources":["../src/process.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { existsSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { config } from \"@dotenvx/dotenvx\";\n\n/**\n * Copies the current environment and layers local dotenv files beneath it; values\n * already set in the process win. Loaded secrets are never printed.\n */\nexport function developmentEnvironment(\n  root: string,\n  files: readonly string[] = [\".env.local\", \".env\"],\n): NodeJS.ProcessEnv {\n  const env: Record<string, string> = Object.fromEntries(\n    Object.entries(process.env).filter(\n      (entry): entry is [string, string] => entry[1] !== undefined,\n    ),\n  );\n  for (const file of files) {\n    const path = join(root, file);\n    if (existsSync(path)) config({ path, processEnv: env, quiet: true });\n  }\n  return env;\n}\n\n/** Runs a command with inherited output, forwarding interrupts and rejecting on failure. */\nexport function run(\n  command: string,\n  args: string[],\n  cwd: string,\n  env = process.env,\n): Promise<void> {\n  return new Promise((resolve, reject) => {\n    const child = spawn(command, args, { cwd, env, stdio: \"inherit\", windowsHide: true });\n    const forward = (signal: NodeJS.Signals) => {\n      child.kill(signal);\n    };\n    const interrupt = () => forward(\"SIGINT\");\n    const terminate = () => forward(\"SIGTERM\");\n    process.once(\"SIGINT\", interrupt);\n    process.once(\"SIGTERM\", terminate);\n    const cleanup = () => {\n      process.off(\"SIGINT\", interrupt);\n      process.off(\"SIGTERM\", terminate);\n    };\n    child.once(\"error\", (error) => {\n      cleanup();\n      reject(error);\n    });\n    child.once(\"exit\", (code, signal) => {\n      cleanup();\n      if (code === 0) resolve();\n      else reject(new Error(`${command} exited ${code ?? signal}`));\n    });\n  });\n}\n\nexport interface TurboOptions {\n  /** Load development dotenv files for these tasks. */\n  developmentTasks?: readonly string[];\n  /** Environment entries added to every task, such as a cache platform key. */\n  env?: Record<string, string>;\n  /** Only when this variable is `\"true\"` are remote cache credentials passed through. */\n  trustedCacheEnv?: string;\n}\n\n/**\n * Runs a Turbo task under Bun. Untrusted runs drop remote cache credentials and use\n * the local cache only, so forks never read or write the shared remote cache.\n */\nexport function turbo(\n  root: string,\n  task: string,\n  args: string[] = [],\n  {\n    developmentTasks = [\"dev\", \"build\"],\n    env: extra = {},\n    trustedCacheEnv = \"DEVKIT_REMOTE_CACHE_TRUSTED\",\n  }: TurboOptions = {},\n): Promise<void> {\n  const env = {\n    ...(developmentTasks.includes(task) ? developmentEnvironment(root) : process.env),\n    ...extra,\n  };\n  if (env[trustedCacheEnv] !== \"true\") {\n    for (const key of [\"TURBO_TOKEN\", \"TURBO_TEAM\", \"TURBO_REMOTE_CACHE_SIGNATURE_KEY\"])\n      delete env[key];\n    delete env.TURBO_REMOTE_ONLY;\n    args = [\"--cache=local:rw\", ...args];\n  }\n  return run(process.execPath, [\"--bun\", \"turbo\", \"run\", task, ...args], root, env);\n}\n"],"mappings":";;;;;;;;;AASA,SAAgB,uBACd,MACA,QAA2B,CAAC,cAAc,MAAM,GAC7B;CACnB,MAAM,MAA8B,OAAO,YACzC,OAAO,QAAQ,QAAQ,GAAG,CAAC,CAAC,QACzB,UAAqC,MAAM,OAAO,KAAA,CACrD,CACF;CACA,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,OAAO,KAAK,MAAM,IAAI;EAC5B,IAAI,WAAW,IAAI,GAAG,OAAO;GAAE;GAAM,YAAY;GAAK,OAAO;EAAK,CAAC;CACrE;CACA,OAAO;AACT;;AAGA,SAAgB,IACd,SACA,MACA,KACA,MAAM,QAAQ,KACC;CACf,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,QAAQ,MAAM,SAAS,MAAM;GAAE;GAAK;GAAK,OAAO;GAAW,aAAa;EAAK,CAAC;EACpF,MAAM,WAAW,WAA2B;GAC1C,MAAM,KAAK,MAAM;EACnB;EACA,MAAM,kBAAkB,QAAQ,QAAQ;EACxC,MAAM,kBAAkB,QAAQ,SAAS;EACzC,QAAQ,KAAK,UAAU,SAAS;EAChC,QAAQ,KAAK,WAAW,SAAS;EACjC,MAAM,gBAAgB;GACpB,QAAQ,IAAI,UAAU,SAAS;GAC/B,QAAQ,IAAI,WAAW,SAAS;EAClC;EACA,MAAM,KAAK,UAAU,UAAU;GAC7B,QAAQ;GACR,OAAO,KAAK;EACd,CAAC;EACD,MAAM,KAAK,SAAS,MAAM,WAAW;GACnC,QAAQ;GACR,IAAI,SAAS,GAAG,QAAQ;QACnB,uBAAO,IAAI,MAAM,GAAG,QAAQ,UAAU,QAAQ,QAAQ,CAAC;EAC9D,CAAC;CACH,CAAC;AACH;;;;;AAeA,SAAgB,MACd,MACA,MACA,OAAiB,CAAC,GAClB,EACE,mBAAmB,CAAC,OAAO,OAAO,GAClC,KAAK,QAAQ,CAAC,GACd,kBAAkB,kCACF,CAAC,GACJ;CACf,MAAM,MAAM;EACV,GAAI,iBAAiB,SAAS,IAAI,IAAI,uBAAuB,IAAI,IAAI,QAAQ;EAC7E,GAAG;CACL;CACA,IAAI,IAAI,qBAAqB,QAAQ;EACnC,KAAK,MAAM,OAAO;GAAC;GAAe;GAAc;EAAkC,GAChF,OAAO,IAAI;EACb,OAAO,IAAI;EACX,OAAO,CAAC,oBAAoB,GAAG,IAAI;CACrC;CACA,OAAO,IAAI,QAAQ,UAAU;EAAC;EAAS;EAAS;EAAO;EAAM,GAAG;CAAI,GAAG,MAAM,GAAG;AAClF"}

package/dist/toolchain.d.mts

@@ -0,0 +1,27 @@
+//#region src/toolchain.d.ts
+export interface Toolchain {
+  node: string;
+  bun: string;
+}
+export interface ToolchainOptions {
+  /** Repository-relative documents whose `Node x.y.z` and `Bun x.y.z` mentions must match. */
+  documents?: readonly string[];
+  /** Files every Turbo cache key must include when `turbo.json` exists. */
+  turboGlobalDependencies?: readonly string[];
+}
+export interface RuntimeOptions {
+  /** Environment variable that may select a Node executable outside PATH. */
+  nodeBinaryEnv?: string;
+}
+/** `.nvmrc` pins Node and the root `packageManager` pins Bun; every other pin follows them. */
+export declare function readToolchain(root: string): Toolchain;
+/** Returns the Node executable after confirming it provides the pinned release. */
+export declare function pinnedNode(root: string, { nodeBinaryEnv }?: RuntimeOptions): string;
+/** The binary override changes the consumer executable, never the required version. */
+export declare function assertToolchainRuntime(root: string, options?: RuntimeOptions): Toolchain & {
+  nodeBinary: string;
+};
+/** Check duplicated declarations without installing tools or running application code. */
+export declare function checkToolchain(root: string, { documents, turboGlobalDependencies }?: ToolchainOptions): string[];
+//#endregion
+//# sourceMappingURL=toolchain.d.mts.map

package/dist/toolchain.mjs

@@ -0,0 +1,213 @@
+import { workspacePatterns } from "./workspaces.mjs";
+import { existsSync, globSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { execFileSync } from "node:child_process";
+import { parseTOML } from "confbox/toml";
+import { parseYAML } from "confbox/yaml";
+//#region src/toolchain.ts
+const exactVersion = /^\d+\.\d+\.\d+$/;
+const manifestAt = (root, file = "package.json") => JSON.parse(readFileSync(join(root, file), "utf8"));
+const catalogsOf = (manifest) => {
+	const workspaces = manifest.workspaces;
+	if (!workspaces || typeof workspaces !== "object" || Array.isArray(workspaces)) return [];
+	const { catalog, catalogs } = workspaces;
+	return [...catalog ? [catalog] : [], ...Object.values(catalogs ?? {})];
+};
+/** `.nvmrc` pins Node and the root `packageManager` pins Bun; every other pin follows them. */
+function readToolchain(root) {
+	const node = readFileSync(join(root, ".nvmrc"), "utf8").trim().replace(/^v/, "");
+	const bun = /^bun@(.+)$/.exec(manifestAt(root).packageManager ?? "")?.[1] ?? "";
+	if (!exactVersion.test(node) || !exactVersion.test(bun)) throw new Error("Pin exact Node and Bun versions in .nvmrc and package.json packageManager.");
+	return {
+		node,
+		bun
+	};
+}
+/** Returns the Node executable after confirming it provides the pinned release. */
+function pinnedNode(root, { nodeBinaryEnv = "DEVKIT_NODE_BINARY" } = {}) {
+	const pins = readToolchain(root);
+	const nodeBinary = process.env[nodeBinaryEnv] || "node";
+	let node;
+	try {
+		node = execFileSync(nodeBinary, ["--version"], {
+			encoding: "utf8",
+			stdio: "pipe"
+		}).trim();
+	} catch {
+		throw new Error(`Node is unavailable; select Node ${pins.node} from .nvmrc or set ${nodeBinaryEnv}.`);
+	}
+	if (node !== `v${pins.node}`) throw new Error(`Expected Node ${pins.node}, got ${node}; select the pinned Node from .nvmrc or set ${nodeBinaryEnv}.`);
+	return nodeBinary;
+}
+/** The binary override changes the consumer executable, never the required version. */
+function assertToolchainRuntime(root, options = {}) {
+	const pins = readToolchain(root);
+	if (process.versions.bun !== pins.bun) throw new Error(`Expected Bun ${pins.bun}, got ${process.versions.bun ?? "none"}.`);
+	return {
+		...pins,
+		nodeBinary: pinnedNode(root, options)
+	};
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function checkMise(root) {
+	const file = "mise.toml";
+	const path = join(root, file);
+	if (!existsSync(path)) return [`${file}: missing runtime manager configuration`];
+	let mise;
+	try {
+		mise = parseTOML(readFileSync(path, "utf8"));
+	} catch {
+		return [`${file}: invalid TOML configuration`];
+	}
+	if (!isRecord(mise)) return [`${file}: configuration must be a table`];
+	const findings = [];
+	if (Object.hasOwn(mise, "tools")) findings.push(`${file}: read existing pins instead of declaring [tools] versions`);
+	const tools = isRecord(mise.settings) ? mise.settings.idiomatic_version_file_enable_tools : void 0;
+	if (!Array.isArray(tools) || tools.length !== 2 || !["node", "bun"].every((tool) => tools.includes(tool))) findings.push(`${file}: enable idiomatic version files for node and bun`);
+	return findings;
+}
+function checkSetupStep(file, location, step) {
+	if (typeof step.uses !== "string") return [];
+	const refSeparator = step.uses.indexOf("@");
+	if (refSeparator < 0) return [];
+	const repository = step.uses.slice(0, refSeparator).toLowerCase();
+	const setup = [[
+		"node",
+		"actions/setup-node",
+		".nvmrc"
+	], [
+		"bun",
+		"oven-sh/setup-bun",
+		"package.json"
+	]].find(([, action]) => repository === action);
+	if (!setup) return [];
+	const [tool, , source] = setup;
+	const findings = [];
+	if (step.with !== void 0 && !isRecord(step.with)) findings.push(`${file}: ${location}.with must be a mapping`);
+	const inputs = isRecord(step.with) ? step.with : {};
+	if (Object.hasOwn(inputs, `${tool}-version`)) findings.push(`${file}: read ${tool}-version-file: ${source} instead of a literal version`);
+	const versionFile = inputs[`${tool}-version-file`];
+	if (versionFile === void 0) findings.push(`${file}: every ${tool} setup must read ${source}`);
+	else if (versionFile !== source) findings.push(`${file}: ${tool}-version-file must be ${source}`);
+	return findings;
+}
+function checkSetupSteps(file, location, steps) {
+	if (!Array.isArray(steps)) return [`${file}: ${location} must be an array`];
+	const findings = [];
+	for (const [index, step] of steps.entries()) {
+		const stepLocation = `${location}[${index}]`;
+		if (!isRecord(step)) {
+			findings.push(`${file}: ${stepLocation} must be a mapping`);
+			continue;
+		}
+		findings.push(...checkSetupStep(file, stepLocation, step));
+	}
+	return findings;
+}
+function checkWorkflows(root) {
+	const findings = [];
+	for (const file of globSync(".github/workflows/*.{yml,yaml}", { cwd: root })) {
+		let workflow;
+		try {
+			workflow = parseYAML(readFileSync(join(root, file), "utf8"), { filename: file });
+		} catch {
+			findings.push(`${file}: invalid YAML configuration`);
+			continue;
+		}
+		if (!isRecord(workflow) || !isRecord(workflow.jobs)) {
+			findings.push(`${file}: workflow jobs must be a mapping`);
+			continue;
+		}
+		for (const [name, job] of Object.entries(workflow.jobs)) {
+			const location = `jobs.${name}`;
+			if (!isRecord(job)) {
+				findings.push(`${file}: ${location} must be a mapping`);
+				continue;
+			}
+			if (job.steps === void 0) continue;
+			findings.push(...checkSetupSteps(file, `${location}.steps`, job.steps));
+		}
+	}
+	return findings;
+}
+function checkCompositeActions(root) {
+	const findings = [];
+	for (const file of globSync(".github/actions/**/action.{yml,yaml}", { cwd: root })) {
+		let action;
+		try {
+			action = parseYAML(readFileSync(join(root, file), "utf8"), { filename: file });
+		} catch {
+			findings.push(`${file}: invalid YAML configuration`);
+			continue;
+		}
+		if (!isRecord(action) || !isRecord(action.runs)) {
+			findings.push(`${file}: action runs must be a mapping`);
+			continue;
+		}
+		if (action.runs.using !== "composite") continue;
+		findings.push(...checkSetupSteps(file, "runs.steps", action.runs.steps));
+	}
+	return findings;
+}
+/** Check duplicated declarations without installing tools or running application code. */
+function checkToolchain(root, { documents = ["README.md", "AGENTS.md"], turboGlobalDependencies = [".nvmrc", "mise.toml"] } = {}) {
+	let pins;
+	try {
+		pins = readToolchain(root);
+	} catch (error) {
+		return [error instanceof Error ? error.message : String(error)];
+	}
+	const findings = [];
+	const manifest = manifestAt(root);
+	const expect = (file, label, actual, expected) => {
+		if (actual !== expected) findings.push(`${file}: ${label} is ${actual ?? "missing"}, expected ${expected}`);
+	};
+	expect("package.json", "engines.node", manifest.engines?.node, pins.node);
+	for (const key of ["packageManager", "runtime"]) {
+		const engine = manifest.devEngines?.[key];
+		expect("package.json", `devEngines.${key}`, `${engine?.name}@${engine?.version}`, `bun@${pins.bun}`);
+		expect("package.json", `devEngines.${key}.onFail`, engine?.onFail, "error");
+	}
+	for (const file of [
+		".node-version",
+		".bun-version",
+		".tool-versions"
+	]) if (existsSync(join(root, file))) findings.push(`${file}: use .nvmrc and package.json instead of a second version source`);
+	findings.push(...checkMise(root));
+	const nodeMajor = pins.node.split(".")[0];
+	const version = (range) => range && !/^[a-z]+:/.test(range) ? range.replace(/^[\^~]/, "") : void 0;
+	const checkTypes = (file, dependencies) => {
+		const node = version(dependencies?.["@types/node"]);
+		if (node && node.split(".")[0] !== nodeMajor) findings.push(`${file}: @types/node must match the Node ${nodeMajor} major`);
+		const bun = version(dependencies?.["@types/bun"]);
+		if (bun) expect(file, "@types/bun", bun, pins.bun);
+	};
+	for (const catalog of catalogsOf(manifest)) checkTypes("package.json catalog", catalog);
+	for (const file of ["package.json", ...globSync(workspacePatterns(manifest).map((path) => `${path}/package.json`), { cwd: root })]) checkTypes(file, manifestAt(root, file).devDependencies);
+	for (const file of globSync("**/Dockerfile", {
+		cwd: root,
+		exclude: ["**/node_modules/**"]
+	})) {
+		const source = readFileSync(join(root, file), "utf8");
+		for (const [, version] of source.matchAll(/^FROM\s+node:(\d+\.\d+\.\d+)/gm)) expect(file, "node image", version, pins.node);
+		for (const [, version] of source.matchAll(/^FROM\s+oven\/bun:(\d+\.\d+\.\d+)/gm)) expect(file, "bun image", version, pins.bun);
+	}
+	findings.push(...checkWorkflows(root), ...checkCompositeActions(root));
+	for (const file of documents) {
+		if (!existsSync(join(root, file))) continue;
+		const document = readFileSync(join(root, file), "utf8").replaceAll("**", "");
+		for (const [, tool, version] of document.matchAll(/\b(Node|Bun) v?(\d+\.\d+\.\d+)\b/g)) expect(file, `documented ${tool}`, version, tool === "Node" ? pins.node : pins.bun);
+	}
+	const turboFile = join(root, "turbo.json");
+	if (existsSync(turboFile)) {
+		const turbo = JSON.parse(readFileSync(turboFile, "utf8"));
+		for (const file of turboGlobalDependencies) if (!turbo.globalDependencies?.includes(file)) findings.push(`turbo.json: include ${file} in globalDependencies`);
+	}
+	return [...new Set(findings)];
+}
+//#endregion
+export { assertToolchainRuntime, checkToolchain, pinnedNode, readToolchain };
+
+//# sourceMappingURL=toolchain.mjs.map

package/dist/toolchain.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolchain.mjs","names":[],"sources":["../src/toolchain.ts"],"sourcesContent":["import { execFileSync } from \"node:child_process\";\nimport { existsSync, globSync, readFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\nimport { parseTOML } from \"confbox/toml\";\nimport { parseYAML } from \"confbox/yaml\";\nimport { workspacePatterns } from \"./workspaces.js\";\n\nexport interface Toolchain {\n  node: string;\n  bun: string;\n}\n\nexport interface ToolchainOptions {\n  /** Repository-relative documents whose `Node x.y.z` and `Bun x.y.z` mentions must match. */\n  documents?: readonly string[];\n  /** Files every Turbo cache key must include when `turbo.json` exists. */\n  turboGlobalDependencies?: readonly string[];\n}\n\nexport interface RuntimeOptions {\n  /** Environment variable that may select a Node executable outside PATH. */\n  nodeBinaryEnv?: string;\n}\n\ninterface Manifest {\n  packageManager?: string;\n  engines?: { node?: string };\n  devEngines?: Record<string, { name?: string; version?: string; onFail?: string }>;\n  devDependencies?: Record<string, string>;\n  workspaces?: unknown;\n}\n\nconst exactVersion = /^\\d+\\.\\d+\\.\\d+$/;\nconst manifestAt = (root: string, file = \"package.json\"): Manifest =>\n  JSON.parse(readFileSync(join(root, file), \"utf8\")) as Manifest;\nconst catalogsOf = (manifest: Manifest): Record<string, string>[] => {\n  const workspaces = manifest.workspaces;\n  if (!workspaces || typeof workspaces !== \"object\" || Array.isArray(workspaces)) return [];\n  const { catalog, catalogs } = workspaces as {\n    catalog?: Record<string, string>;\n    catalogs?: Record<string, Record<string, string>>;\n  };\n  return [...(catalog ? [catalog] : []), ...Object.values(catalogs ?? {})];\n};\n\n/** `.nvmrc` pins Node and the root `packageManager` pins Bun; every other pin follows them. */\nexport function readToolchain(root: string): Toolchain {\n  const node = readFileSync(join(root, \".nvmrc\"), \"utf8\").trim().replace(/^v/, \"\");\n  const bun = /^bun@(.+)$/.exec(manifestAt(root).packageManager ?? \"\")?.[1] ?? \"\";\n  if (!exactVersion.test(node) || !exactVersion.test(bun))\n    throw new Error(\"Pin exact Node and Bun versions in .nvmrc and package.json packageManager.\");\n  return { node, bun };\n}\n\n/** Returns the Node executable after confirming it provides the pinned release. */\nexport function pinnedNode(\n  root: string,\n  { nodeBinaryEnv = \"DEVKIT_NODE_BINARY\" }: RuntimeOptions = {},\n) {\n  const pins = readToolchain(root);\n  const nodeBinary = process.env[nodeBinaryEnv] || \"node\";\n  let node: string;\n  try {\n    node = execFileSync(nodeBinary, [\"--version\"], { encoding: \"utf8\", stdio: \"pipe\" }).trim();\n  } catch {\n    throw new Error(\n      `Node is unavailable; select Node ${pins.node} from .nvmrc or set ${nodeBinaryEnv}.`,\n    );\n  }\n  if (node !== `v${pins.node}`)\n    throw new Error(\n      `Expected Node ${pins.node}, got ${node}; select the pinned Node from .nvmrc or set ${nodeBinaryEnv}.`,\n    );\n  return nodeBinary;\n}\n\n/** The binary override changes the consumer executable, never the required version. */\nexport function assertToolchainRuntime(\n  root: string,\n  options: RuntimeOptions = {},\n): Toolchain & { nodeBinary: string } {\n  const pins = readToolchain(root);\n  if (process.versions.bun !== pins.bun)\n    throw new Error(`Expected Bun ${pins.bun}, got ${process.versions.bun ?? \"none\"}.`);\n  return { ...pins, nodeBinary: pinnedNode(root, options) };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction checkMise(root: string): string[] {\n  const file = \"mise.toml\";\n  const path = join(root, file);\n  if (!existsSync(path)) return [`${file}: missing runtime manager configuration`];\n  let mise: unknown;\n  try {\n    mise = parseTOML(readFileSync(path, \"utf8\"));\n  } catch {\n    return [`${file}: invalid TOML configuration`];\n  }\n  if (!isRecord(mise)) return [`${file}: configuration must be a table`];\n  const findings: string[] = [];\n  if (Object.hasOwn(mise, \"tools\"))\n    findings.push(`${file}: read existing pins instead of declaring [tools] versions`);\n  const tools = isRecord(mise.settings)\n    ? mise.settings.idiomatic_version_file_enable_tools\n    : undefined;\n  if (\n    !Array.isArray(tools) ||\n    tools.length !== 2 ||\n    ![\"node\", \"bun\"].every((tool) => tools.includes(tool))\n  )\n    findings.push(`${file}: enable idiomatic version files for node and bun`);\n  return findings;\n}\n\nfunction checkSetupStep(file: string, location: string, step: Record<string, unknown>): string[] {\n  if (typeof step.uses !== \"string\") return [];\n  const refSeparator = step.uses.indexOf(\"@\");\n  if (refSeparator < 0) return [];\n  const repository = step.uses.slice(0, refSeparator).toLowerCase();\n  const setup = (\n    [\n      [\"node\", \"actions/setup-node\", \".nvmrc\"],\n      [\"bun\", \"oven-sh/setup-bun\", \"package.json\"],\n    ] as const\n  ).find(([, action]) => repository === action);\n  if (!setup) return [];\n  const [tool, , source] = setup;\n  const findings: string[] = [];\n  if (step.with !== undefined && !isRecord(step.with))\n    findings.push(`${file}: ${location}.with must be a mapping`);\n  const inputs = isRecord(step.with) ? step.with : {};\n  if (Object.hasOwn(inputs, `${tool}-version`))\n    findings.push(`${file}: read ${tool}-version-file: ${source} instead of a literal version`);\n  const versionFile = inputs[`${tool}-version-file`];\n  if (versionFile === undefined) findings.push(`${file}: every ${tool} setup must read ${source}`);\n  else if (versionFile !== source) findings.push(`${file}: ${tool}-version-file must be ${source}`);\n  return findings;\n}\n\nfunction checkSetupSteps(file: string, location: string, steps: unknown): string[] {\n  if (!Array.isArray(steps)) return [`${file}: ${location} must be an array`];\n  const findings: string[] = [];\n  for (const [index, step] of steps.entries()) {\n    const stepLocation = `${location}[${index}]`;\n    if (!isRecord(step)) {\n      findings.push(`${file}: ${stepLocation} must be a mapping`);\n      continue;\n    }\n    findings.push(...checkSetupStep(file, stepLocation, step));\n  }\n  return findings;\n}\n\nfunction checkWorkflows(root: string): string[] {\n  const findings: string[] = [];\n  for (const file of globSync(\".github/workflows/*.{yml,yaml}\", { cwd: root })) {\n    let workflow: unknown;\n    try {\n      workflow = parseYAML(readFileSync(join(root, file), \"utf8\"), { filename: file });\n    } catch {\n      findings.push(`${file}: invalid YAML configuration`);\n      continue;\n    }\n    if (!isRecord(workflow) || !isRecord(workflow.jobs)) {\n      findings.push(`${file}: workflow jobs must be a mapping`);\n      continue;\n    }\n    for (const [name, job] of Object.entries(workflow.jobs)) {\n      const location = `jobs.${name}`;\n      if (!isRecord(job)) {\n        findings.push(`${file}: ${location} must be a mapping`);\n        continue;\n      }\n      if (job.steps === undefined) continue;\n      findings.push(...checkSetupSteps(file, `${location}.steps`, job.steps));\n    }\n  }\n  return findings;\n}\n\nfunction checkCompositeActions(root: string): string[] {\n  const findings: string[] = [];\n  for (const file of globSync(\".github/actions/**/action.{yml,yaml}\", { cwd: root })) {\n    let action: unknown;\n    try {\n      action = parseYAML(readFileSync(join(root, file), \"utf8\"), { filename: file });\n    } catch {\n      findings.push(`${file}: invalid YAML configuration`);\n      continue;\n    }\n    if (!isRecord(action) || !isRecord(action.runs)) {\n      findings.push(`${file}: action runs must be a mapping`);\n      continue;\n    }\n    if (action.runs.using !== \"composite\") continue;\n    findings.push(...checkSetupSteps(file, \"runs.steps\", action.runs.steps));\n  }\n  return findings;\n}\n\n/** Check duplicated declarations without installing tools or running application code. */\nexport function checkToolchain(\n  root: string,\n  {\n    documents = [\"README.md\", \"AGENTS.md\"],\n    turboGlobalDependencies = [\".nvmrc\", \"mise.toml\"],\n  }: ToolchainOptions = {},\n): string[] {\n  let pins: Toolchain;\n  try {\n    pins = readToolchain(root);\n  } catch (error) {\n    return [error instanceof Error ? error.message : String(error)];\n  }\n  const findings: string[] = [];\n  const manifest = manifestAt(root);\n  const expect = (file: string, label: string, actual: string | undefined, expected: string) => {\n    if (actual !== expected)\n      findings.push(`${file}: ${label} is ${actual ?? \"missing\"}, expected ${expected}`);\n  };\n  expect(\"package.json\", \"engines.node\", manifest.engines?.node, pins.node);\n  for (const key of [\"packageManager\", \"runtime\"]) {\n    const engine = manifest.devEngines?.[key];\n    expect(\n      \"package.json\",\n      `devEngines.${key}`,\n      `${engine?.name}@${engine?.version}`,\n      `bun@${pins.bun}`,\n    );\n    expect(\"package.json\", `devEngines.${key}.onFail`, engine?.onFail, \"error\");\n  }\n  for (const file of [\".node-version\", \".bun-version\", \".tool-versions\"])\n    if (existsSync(join(root, file)))\n      findings.push(`${file}: use .nvmrc and package.json instead of a second version source`);\n  findings.push(...checkMise(root));\n\n  // Runtime type packages follow the pins: @types/node by major, @types/bun exactly.\n  const nodeMajor = pins.node.split(\".\")[0]!;\n  // Protocol ranges such as catalog: and workspace: are checked where they resolve.\n  const version = (range: string | undefined) =>\n    range && !/^[a-z]+:/.test(range) ? range.replace(/^[\\^~]/, \"\") : undefined;\n  const checkTypes = (file: string, dependencies: Record<string, string> | undefined) => {\n    const node = version(dependencies?.[\"@types/node\"]);\n    if (node && node.split(\".\")[0] !== nodeMajor)\n      findings.push(`${file}: @types/node must match the Node ${nodeMajor} major`);\n    const bun = version(dependencies?.[\"@types/bun\"]);\n    if (bun) expect(file, \"@types/bun\", bun, pins.bun);\n  };\n  for (const catalog of catalogsOf(manifest)) checkTypes(\"package.json catalog\", catalog);\n  for (const file of [\n    \"package.json\",\n    ...globSync(\n      workspacePatterns(manifest).map((path) => `${path}/package.json`),\n      { cwd: root },\n    ),\n  ])\n    checkTypes(file, manifestAt(root, file).devDependencies);\n\n  for (const file of globSync(\"**/Dockerfile\", { cwd: root, exclude: [\"**/node_modules/**\"] })) {\n    const source = readFileSync(join(root, file), \"utf8\");\n    for (const [, version] of source.matchAll(/^FROM\\s+node:(\\d+\\.\\d+\\.\\d+)/gm))\n      expect(file, \"node image\", version, pins.node);\n    for (const [, version] of source.matchAll(/^FROM\\s+oven\\/bun:(\\d+\\.\\d+\\.\\d+)/gm))\n      expect(file, \"bun image\", version, pins.bun);\n  }\n  findings.push(...checkWorkflows(root), ...checkCompositeActions(root));\n  for (const file of documents) {\n    if (!existsSync(join(root, file))) continue;\n    const document = readFileSync(join(root, file), \"utf8\").replaceAll(\"**\", \"\");\n    for (const [, tool, version] of document.matchAll(/\\b(Node|Bun) v?(\\d+\\.\\d+\\.\\d+)\\b/g))\n      expect(file, `documented ${tool}`, version, tool === \"Node\" ? pins.node : pins.bun);\n  }\n  const turboFile = join(root, \"turbo.json\");\n  if (existsSync(turboFile)) {\n    const turbo = JSON.parse(readFileSync(turboFile, \"utf8\")) as { globalDependencies?: string[] };\n    for (const file of turboGlobalDependencies)\n      if (!turbo.globalDependencies?.includes(file))\n        findings.push(`turbo.json: include ${file} in globalDependencies`);\n  }\n  return [...new Set(findings)];\n}\n"],"mappings":"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"}

package/dist/workspaces.d.mts

@@ -0,0 +1,71 @@
+//#region src/workspaces.d.ts
+export declare const targets: readonly ["universal", "browser", "native", "node", "bun"];
+export type Target = (typeof targets)[number];
+export declare const kinds: readonly ["app", "library", "tooling"];
+export type Kind = (typeof kinds)[number];
+/** Per-workspace boundary metadata, supplied explicitly or read from package.json. */
+export interface Metadata {
+  kind: Kind;
+  target: Target;
+  entryTargets?: Record<string, Target>;
+  sourceTargets?: Record<string, Target>;
+  /** Maintained source behind an export whose published target is generated. */
+  sourceEntries?: Record<string, string>;
+  /** Development dependencies explicitly bundled into the published runtime. */
+  bundledDependencies?: string[];
+}
+export interface Manifest {
+  name: string;
+  private?: boolean;
+  type?: string;
+  exports?: Record<string, unknown>;
+  imports?: Record<string, string>;
+  scripts?: Record<string, string>;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+  peerDependencies?: Record<string, string>;
+  [key: string]: unknown;
+}
+export interface Workspace {
+  path: string;
+  manifest: Manifest;
+  metadata: Metadata | undefined;
+  aliases: Record<string, string[]>;
+}
+export interface WorkspaceIndex {
+  root: string;
+  metadataKey: string;
+  /** Origin of workspace metadata; omitted legacy indexes use the manifest. */
+  metadataSource?: "manifest" | "options";
+  workspaces: Workspace[];
+  byName: Map<string, Workspace>;
+  findings: string[];
+}
+export interface DiscoverOptions {
+  /** Complete metadata by exact workspace-relative path; never merged with manifests. */
+  metadata?: Readonly<Record<string, Metadata>>;
+  /** The package.json field holding {@link Metadata}, used only when metadata is omitted. */
+  metadataKey?: string;
+  /** Directories whose children must each be a workspace. */
+  containers?: readonly string[];
+}
+/** Matches package export, import-map and tsconfig path patterns, including `**`. */
+export declare function matches(pattern: string, value: string): boolean;
+/** Reads workspace patterns from the array or Bun/Yarn object form of `workspaces`. */
+export declare function workspacePatterns(manifest: {
+  workspaces?: unknown;
+}): string[];
+export declare function discover(root: string, { metadata, metadataKey, containers }?: DiscoverOptions): WorkspaceIndex;
+export declare function workspaceFor(index: WorkspaceIndex, file: string): Workspace | undefined;
+export declare function sourceTarget(workspace: Workspace, file: string): Target;
+export declare function compatible(from: Target, to: Target): boolean;
+export declare function exportPaths(value: unknown): string[];
+export declare function resolveImport(index: WorkspaceIndex, from: Workspace, file: string, request: string): {
+  target: Workspace | undefined;
+  subpath: string;
+  internalPath: boolean;
+  paths: string[];
+  targetPlatform: "browser" | "bun" | "native" | "node" | "universal";
+};
+//#endregion
+//# sourceMappingURL=workspaces.d.mts.map

package/dist/workspaces.mjs

@@ -0,0 +1,139 @@
+import { existsSync, globSync, readFileSync, readdirSync } from "node:fs";
+import { join, posix } from "node:path";
+//#region src/workspaces.ts
+const targets = [
+	"universal",
+	"browser",
+	"native",
+	"node",
+	"bun"
+];
+const kinds = [
+	"app",
+	"library",
+	"tooling"
+];
+/** Matches package export, import-map and tsconfig path patterns, including `**`. */
+function matches(pattern, value) {
+	let regex = "^";
+	for (let i = 0; i < pattern.length; i++) {
+		const char = pattern[i];
+		if (char === "*" && pattern[i + 1] === "*") {
+			if (pattern[i + 2] === "/") {
+				regex += "(?:.*/)?";
+				i += 2;
+			} else {
+				regex += ".*";
+				i++;
+			}
+		} else if (char === "*") regex += "[^/]*";
+		else regex += char.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	}
+	return new RegExp(`${regex}$`).test(value);
+}
+/** Reads workspace patterns from the array or Bun/Yarn object form of `workspaces`. */
+function workspacePatterns(manifest) {
+	const value = manifest.workspaces;
+	if (Array.isArray(value)) return value;
+	if (value && typeof value === "object" && Array.isArray(value.packages)) return value.packages;
+	return [];
+}
+function discover(root, { metadata, metadataKey = "devkit", containers = ["apps", "packages"] } = {}) {
+	const manifest = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+	const findings = [];
+	const workspaces = [];
+	for (const file of globSync(workspacePatterns(manifest).map((p) => `${p}/package.json`), { cwd: root }).sort()) {
+		const path = file.replaceAll("\\", "/").slice(0, -13);
+		const entry = JSON.parse(readFileSync(join(root, file), "utf8"));
+		const workspaceMetadata = metadata === void 0 ? entry[metadataKey] : Object.hasOwn(metadata, path) ? metadata[path] : void 0;
+		if (metadata !== void 0 && workspaceMetadata === void 0) findings.push(`${path}: missing supplied workspace metadata`);
+		let aliases = {};
+		const config = join(root, path, "tsconfig.json");
+		if (existsSync(config)) try {
+			aliases = JSON.parse(readFileSync(config, "utf8")).compilerOptions?.paths ?? {};
+		} catch {
+			findings.push(`${path}/tsconfig.json: expected valid JSON`);
+		}
+		workspaces.push({
+			path,
+			manifest: entry,
+			metadata: workspaceMetadata,
+			aliases
+		});
+	}
+	const byName = /* @__PURE__ */ new Map();
+	for (const workspace of workspaces) {
+		if (byName.has(workspace.manifest.name)) findings.push(`duplicate workspace: ${workspace.manifest.name}`);
+		byName.set(workspace.manifest.name, workspace);
+	}
+	if (metadata !== void 0) {
+		const paths = new Set(workspaces.map((workspace) => workspace.path));
+		for (const path of Object.keys(metadata).sort()) if (!paths.has(path)) findings.push(`${path}: metadata supplied for unknown workspace`);
+	}
+	for (const parent of containers) {
+		if (!existsSync(join(root, parent))) continue;
+		for (const child of readdirSync(join(root, parent), { withFileTypes: true })) {
+			if (!child.isDirectory() || child.name.startsWith(".")) continue;
+			const path = `${parent}/${child.name}`;
+			if (!workspaces.some((w) => w.path === path)) findings.push(`${path}: missing workspace manifest`);
+		}
+	}
+	return {
+		root,
+		metadataKey,
+		metadataSource: metadata === void 0 ? "manifest" : "options",
+		workspaces,
+		byName,
+		findings
+	};
+}
+function workspaceFor(index, file) {
+	return index.workspaces.find((w) => file.startsWith(`${w.path}/`));
+}
+function sourceTarget(workspace, file) {
+	const relative = file.slice(workspace.path.length + 1);
+	return Object.entries(workspace.metadata?.sourceTargets ?? {}).filter(([pattern]) => matches(pattern, relative)).sort(([a], [b]) => b.replaceAll("*", "").length - a.replaceAll("*", "").length)[0]?.[1] ?? workspace.metadata?.target ?? "universal";
+}
+function compatible(from, to) {
+	return to === "universal" || from === to || from === "bun" && to === "node";
+}
+function exportPaths(value) {
+	if (typeof value === "string") return [value];
+	if (value && typeof value === "object") return Object.values(value).flatMap(exportPaths);
+	return [];
+}
+function resolveImport(index, from, file, request) {
+	const name = request.startsWith("@") ? request.split("/").slice(0, 2).join("/") : request.split("/")[0];
+	const target = index.byName.get(name);
+	if (target) {
+		const subpath = request === name ? "." : `.${request.slice(name.length)}`;
+		const entry = Object.entries(target.manifest.exports ?? {}).find(([pattern]) => matches(pattern, subpath));
+		const suffix = entry?.[0].includes("*") ? subpath.slice(entry[0].split("*")[0].length) : "";
+		const source = entry && target.metadata?.sourceEntries?.[entry[0]];
+		return {
+			target,
+			subpath,
+			internalPath: !entry,
+			paths: entry ? (source ? [source] : exportPaths(entry[1])).map((p) => posix.join(target.path, p.replace("*", suffix))) : [],
+			targetPlatform: target.metadata?.entryTargets?.[entry?.[0] ?? subpath] ?? target.metadata?.target ?? "universal"
+		};
+	}
+	const alias = Object.entries(from.aliases).find(([pattern]) => matches(pattern, request));
+	const internal = Object.entries(from.manifest.imports ?? {}).find(([pattern]) => matches(pattern, request));
+	const pattern = internal?.[0] ?? alias?.[0];
+	const mapped = internal?.[1] ?? alias?.[1][0];
+	const suffix = pattern?.includes("*") ? request.slice(pattern.split("*")[0].length) : "";
+	const path = request.startsWith(".") ? posix.join(posix.dirname(file), request) : mapped ? posix.join(from.path, mapped.replace("*", suffix)) : void 0;
+	const owner = path ? workspaceFor(index, path) : void 0;
+	return {
+		target: owner,
+		subpath: ".",
+		internalPath: !!owner && owner !== from,
+		paths: path ? [path] : [],
+		targetPlatform: owner ? sourceTarget(owner, path) : "universal"
+	};
+}
+//#endregion
+export { compatible, discover, exportPaths, kinds, matches, resolveImport, sourceTarget, targets, workspaceFor, workspacePatterns };
+
+//# sourceMappingURL=workspaces.mjs.map

package/dist/workspaces.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspaces.mjs","names":[],"sources":["../src/workspaces.ts"],"sourcesContent":["import { existsSync, globSync, readFileSync, readdirSync } from \"node:fs\";\nimport { join, posix } from \"node:path\";\n\nexport const targets = [\"universal\", \"browser\", \"native\", \"node\", \"bun\"] as const;\nexport type Target = (typeof targets)[number];\nexport const kinds = [\"app\", \"library\", \"tooling\"] as const;\nexport type Kind = (typeof kinds)[number];\n\n/** Per-workspace boundary metadata, supplied explicitly or read from package.json. */\nexport interface Metadata {\n  kind: Kind;\n  target: Target;\n  entryTargets?: Record<string, Target>;\n  sourceTargets?: Record<string, Target>;\n  /** Maintained source behind an export whose published target is generated. */\n  sourceEntries?: Record<string, string>;\n  /** Development dependencies explicitly bundled into the published runtime. */\n  bundledDependencies?: string[];\n}\nexport interface Manifest {\n  name: string;\n  private?: boolean;\n  type?: string;\n  exports?: Record<string, unknown>;\n  imports?: Record<string, string>;\n  scripts?: Record<string, string>;\n  dependencies?: Record<string, string>;\n  devDependencies?: Record<string, string>;\n  peerDependencies?: Record<string, string>;\n  [key: string]: unknown;\n}\nexport interface Workspace {\n  path: string;\n  manifest: Manifest;\n  metadata: Metadata | undefined;\n  aliases: Record<string, string[]>;\n}\nexport interface WorkspaceIndex {\n  root: string;\n  metadataKey: string;\n  /** Origin of workspace metadata; omitted legacy indexes use the manifest. */\n  metadataSource?: \"manifest\" | \"options\";\n  workspaces: Workspace[];\n  byName: Map<string, Workspace>;\n  findings: string[];\n}\nexport interface DiscoverOptions {\n  /** Complete metadata by exact workspace-relative path; never merged with manifests. */\n  metadata?: Readonly<Record<string, Metadata>>;\n  /** The package.json field holding {@link Metadata}, used only when metadata is omitted. */\n  metadataKey?: string;\n  /** Directories whose children must each be a workspace. */\n  containers?: readonly string[];\n}\n\n/** Matches package export, import-map and tsconfig path patterns, including `**`. */\nexport function matches(pattern: string, value: string): boolean {\n  let regex = \"^\";\n  for (let i = 0; i < pattern.length; i++) {\n    const char = pattern[i]!;\n    if (char === \"*\" && pattern[i + 1] === \"*\") {\n      if (pattern[i + 2] === \"/\") {\n        regex += \"(?:.*/)?\";\n        i += 2;\n      } else {\n        regex += \".*\";\n        i++;\n      }\n    } else if (char === \"*\") regex += \"[^/]*\";\n    else regex += char.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n  }\n  return new RegExp(`${regex}$`).test(value);\n}\n\n/** Reads workspace patterns from the array or Bun/Yarn object form of `workspaces`. */\nexport function workspacePatterns(manifest: { workspaces?: unknown }): string[] {\n  const value = manifest.workspaces;\n  if (Array.isArray(value)) return value as string[];\n  if (\n    value &&\n    typeof value === \"object\" &&\n    Array.isArray((value as { packages?: unknown }).packages)\n  )\n    return (value as { packages: string[] }).packages;\n  return [];\n}\n\nexport function discover(\n  root: string,\n  { metadata, metadataKey = \"devkit\", containers = [\"apps\", \"packages\"] }: DiscoverOptions = {},\n): WorkspaceIndex {\n  const manifest = JSON.parse(readFileSync(join(root, \"package.json\"), \"utf8\"));\n  const findings: string[] = [];\n  const workspaces: Workspace[] = [];\n  for (const file of globSync(\n    workspacePatterns(manifest).map((p) => `${p}/package.json`),\n    { cwd: root },\n  ).sort()) {\n    const path = file.replaceAll(\"\\\\\", \"/\").slice(0, -13);\n    const entry = JSON.parse(readFileSync(join(root, file), \"utf8\")) as Manifest;\n    const workspaceMetadata =\n      metadata === undefined\n        ? (entry[metadataKey] as Metadata | undefined)\n        : Object.hasOwn(metadata, path)\n          ? metadata[path]\n          : undefined;\n    if (metadata !== undefined && workspaceMetadata === undefined)\n      findings.push(`${path}: missing supplied workspace metadata`);\n    let aliases: Record<string, string[]> = {};\n    const config = join(root, path, \"tsconfig.json\");\n    if (existsSync(config)) {\n      try {\n        aliases = JSON.parse(readFileSync(config, \"utf8\")).compilerOptions?.paths ?? {};\n      } catch {\n        findings.push(`${path}/tsconfig.json: expected valid JSON`);\n      }\n    }\n    workspaces.push({\n      path,\n      manifest: entry,\n      metadata: workspaceMetadata,\n      aliases,\n    });\n  }\n  const byName = new Map<string, Workspace>();\n  for (const workspace of workspaces) {\n    if (byName.has(workspace.manifest.name))\n      findings.push(`duplicate workspace: ${workspace.manifest.name}`);\n    byName.set(workspace.manifest.name, workspace);\n  }\n  if (metadata !== undefined) {\n    const paths = new Set(workspaces.map((workspace) => workspace.path));\n    for (const path of Object.keys(metadata).sort()) {\n      if (!paths.has(path)) findings.push(`${path}: metadata supplied for unknown workspace`);\n    }\n  }\n  for (const parent of containers) {\n    if (!existsSync(join(root, parent))) continue;\n    for (const child of readdirSync(join(root, parent), { withFileTypes: true })) {\n      if (!child.isDirectory() || child.name.startsWith(\".\")) continue;\n      const path = `${parent}/${child.name}`;\n      if (!workspaces.some((w) => w.path === path))\n        findings.push(`${path}: missing workspace manifest`);\n    }\n  }\n  return {\n    root,\n    metadataKey,\n    metadataSource: metadata === undefined ? \"manifest\" : \"options\",\n    workspaces,\n    byName,\n    findings,\n  };\n}\n\nexport function workspaceFor(index: WorkspaceIndex, file: string) {\n  return index.workspaces.find((w) => file.startsWith(`${w.path}/`));\n}\n\nexport function sourceTarget(workspace: Workspace, file: string): Target {\n  const relative = file.slice(workspace.path.length + 1);\n  const scopes = Object.entries(workspace.metadata?.sourceTargets ?? {})\n    .filter(([pattern]) => matches(pattern, relative))\n    .sort(([a], [b]) => b.replaceAll(\"*\", \"\").length - a.replaceAll(\"*\", \"\").length);\n  return scopes[0]?.[1] ?? workspace.metadata?.target ?? \"universal\";\n}\n\nexport function compatible(from: Target, to: Target): boolean {\n  return to === \"universal\" || from === to || (from === \"bun\" && to === \"node\");\n}\n\nexport function exportPaths(value: unknown): string[] {\n  if (typeof value === \"string\") return [value];\n  if (value && typeof value === \"object\") return Object.values(value).flatMap(exportPaths);\n  return [];\n}\n\nexport function resolveImport(\n  index: WorkspaceIndex,\n  from: Workspace,\n  file: string,\n  request: string,\n) {\n  const name = request.startsWith(\"@\")\n    ? request.split(\"/\").slice(0, 2).join(\"/\")\n    : request.split(\"/\")[0]!;\n  const target = index.byName.get(name);\n  if (target) {\n    const subpath = request === name ? \".\" : `.${request.slice(name.length)}`;\n    const entry = Object.entries(target.manifest.exports ?? {}).find(([pattern]) =>\n      matches(pattern, subpath),\n    );\n    const suffix = entry?.[0].includes(\"*\") ? subpath.slice(entry[0].split(\"*\")[0]!.length) : \"\";\n    const source = entry && target.metadata?.sourceEntries?.[entry[0]];\n    return {\n      target,\n      subpath,\n      internalPath: !entry,\n      paths: entry\n        ? (source ? [source] : exportPaths(entry[1])).map((p) =>\n            posix.join(target.path, p.replace(\"*\", suffix)),\n          )\n        : [],\n      targetPlatform:\n        target.metadata?.entryTargets?.[entry?.[0] ?? subpath] ??\n        target.metadata?.target ??\n        \"universal\",\n    };\n  }\n  const alias = Object.entries(from.aliases).find(([pattern]) => matches(pattern, request));\n  const internal = Object.entries(from.manifest.imports ?? {}).find(([pattern]) =>\n    matches(pattern, request),\n  );\n  const pattern = internal?.[0] ?? alias?.[0];\n  const mapped = internal?.[1] ?? alias?.[1][0];\n  const suffix = pattern?.includes(\"*\") ? request.slice(pattern.split(\"*\")[0]!.length) : \"\";\n  const path = request.startsWith(\".\")\n    ? posix.join(posix.dirname(file), request)\n    : mapped\n      ? posix.join(from.path, mapped.replace(\"*\", suffix))\n      : undefined;\n  const owner = path ? workspaceFor(index, path) : undefined;\n  return {\n    target: owner,\n    subpath: \".\",\n    internalPath: !!owner && owner !== from,\n    paths: path ? [path] : [],\n    targetPlatform: owner ? sourceTarget(owner, path!) : (\"universal\" as Target),\n  };\n}\n"],"mappings":"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"}