@bamboocss/parser 1.48.5 → 1.50.0

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { Node, Project as Project$1, ScriptKind, ts } from "ts-morph";
+import { Node, Project as Project$1, ScriptKind, childOf, createResolver, getAliasNode, getExportDeclarations, getImportDeclarations, getLineAndColumnAtPos, getModuleSpecifierValue, getName, getNamedExports, getNamedImports, getNamespaceExport, getNamespaceImport, isStarExport, isTypeOnly, nameNodeOf, pathOf, ts } from "@bamboocss/ts-ast";
 import { box, clearBoxNodeCache, extract, getExportedVarDeclarationWithName, invalidateDependencyPath, maybeBoxNode, unbox, unwrapExpression } from "@bamboocss/extractor";
 import { BambooError, compact, createPatternFns, getOrCreateSet } from "@bamboocss/shared";
 import { createHash } from "node:crypto";
@@ -410,20 +410,6 @@ function createReportMaps() {
 	};
 }
 //#endregion
-//#region src/get-module-specifier-value.ts
-/**
-* Both declaration kinds carry a specifier, and `export { x } from './m'` is how a barrel
-* forwards a recipe — so this reads either. An `export { x }` with no `from` returns
-* undefined, which is the same answer the throwing case gives.
-*/
-const getModuleSpecifierValue = (node) => {
-	try {
-		return node.getModuleSpecifierValue();
-	} catch {
-		return;
-	}
-};
-//#endregion
 //#region src/imported-recipes.ts
 /**
 * A module's exported recipes, memoized.
@@ -439,15 +425,15 @@ const clearImportedRecipeCache = () => {
 /** The names a file bound `cva`/`sva` to, or empty when it imports neither. */
 const recipeFactoryAliases = (sourceFile, imports) => {
 	const aliases = /* @__PURE__ */ new Set();
-	for (const declaration of sourceFile.getImportDeclarations()) {
-		if (declaration.isTypeOnly()) continue;
+	for (const declaration of getImportDeclarations(sourceFile)) {
+		if (isTypeOnly(declaration)) continue;
 		const mod = getModuleSpecifierValue(declaration);
 		if (!mod) continue;
-		for (const specifier of declaration.getNamedImports()) {
-			if (specifier.isTypeOnly()) continue;
-			const name = specifier.getNameNode().getText();
+		for (const specifier of getNamedImports(declaration)) {
+			if (isTypeOnly(specifier)) continue;
+			const name = nameNodeOf(specifier)?.getText();
 			if (name !== "cva" && name !== "sva") continue;
-			const alias = specifier.getAliasNode()?.getText() || name;
+			const alias = getAliasNode(specifier)?.getText() || name;
 			if (!imports.match({
 				name,
 				alias,
@@ -468,8 +454,8 @@ const declaredRecipes = (sourceFile, imports) => {
 		declared,
 		exported
 	};
-	const filePath = sourceFile.getFilePath();
-	for (const statement of sourceFile.compilerNode.statements) {
+	const filePath = pathOf(sourceFile);
+	for (const statement of sourceFile.statements) {
 		if (!ts.isVariableStatement(statement)) continue;
 		if (!(statement.declarationList.flags & ts.NodeFlags.Const)) continue;
 		for (const declaration of statement.declarationList.declarations) {
@@ -529,13 +515,13 @@ const walkExports = (sourceFile, imports, resolveModule, seen) => {
 	const imported = walkImports(sourceFile, imports, resolveModule, seen);
 	complete &&= imported.complete;
 	for (const [alias, origin] of imported.bindings) if (!local.has(alias)) local.set(alias, origin);
-	for (const declaration of sourceFile.getExportDeclarations()) {
-		if (declaration.isTypeOnly()) continue;
+	for (const declaration of getExportDeclarations(sourceFile)) {
+		if (isTypeOnly(declaration)) continue;
 		const specifier = getModuleSpecifierValue(declaration);
 		const target = specifier ? resolveModule(specifier, sourceFile) : void 0;
 		if (specifier && !target) continue;
-		if (declaration.getNamespaceExport()) continue;
-		if (declaration.isNamespaceExport()) {
+		if (getNamespaceExport(declaration)) continue;
+		if (isStarExport(declaration)) {
 			if (!target) continue;
 			const walk = walkExports(target, imports, resolveModule, seen);
 			complete &&= walk.complete;
@@ -555,11 +541,11 @@ const walkExports = (sourceFile, imports, resolveModule, seen) => {
 			complete &&= walk.complete;
 			source = walk.names;
 		}
-		for (const exportSpecifier of declaration.getNamedExports()) {
-			if (exportSpecifier.isTypeOnly()) continue;
-			const name = exportSpecifier.getNameNode().getText();
-			const origin = source.get(name);
-			if (origin) names.set(exportSpecifier.getAliasNode()?.getText() || name, origin);
+		for (const exportSpecifier of getNamedExports(declaration)) {
+			if (isTypeOnly(exportSpecifier)) continue;
+			const name = nameNodeOf(exportSpecifier)?.getText();
+			const origin = source.get(name ?? "");
+			if (origin) names.set(getAliasNode(exportSpecifier)?.getText() || (name ?? ""), origin);
 		}
 	}
 	for (const [name, origin] of starred) if (!names.has(name) && !ambiguous.has(name)) names.set(name, origin);
@@ -579,9 +565,9 @@ const walkExports = (sourceFile, imports, resolveModule, seen) => {
 const walkImports = (sourceFile, imports, resolveModule, seen) => {
 	const bindings = /* @__PURE__ */ new Map();
 	let complete = true;
-	for (const declaration of sourceFile.getImportDeclarations()) {
-		if (declaration.isTypeOnly()) continue;
-		const named = declaration.getNamedImports();
+	for (const declaration of getImportDeclarations(sourceFile)) {
+		if (isTypeOnly(declaration)) continue;
+		const named = getNamedImports(declaration);
 		if (named.length === 0) continue;
 		const specifier = getModuleSpecifierValue(declaration);
 		if (!specifier) continue;
@@ -592,10 +578,10 @@ const walkImports = (sourceFile, imports, resolveModule, seen) => {
 		const { names } = walk;
 		if (names.size === 0) continue;
 		for (const importSpecifier of named) {
-			if (importSpecifier.isTypeOnly()) continue;
-			const origin = names.get(importSpecifier.getNameNode().getText());
+			if (isTypeOnly(importSpecifier)) continue;
+			const origin = names.get(nameNodeOf(importSpecifier)?.getText() ?? "");
 			if (!origin) continue;
-			bindings.set(importSpecifier.getAliasNode()?.getText() || importSpecifier.getNameNode().getText(), origin);
+			bindings.set(getAliasNode(importSpecifier)?.getText() || (nameNodeOf(importSpecifier)?.getText() ?? ""), origin);
 		}
 	}
 	return {
@@ -644,7 +630,7 @@ const digestExportValue = (sourceFile, exportedName, resolveModule, onCrossing)
 	try {
 		const declaration = getExportedVarDeclarationWithName(exportedName, sourceFile, [], boxCtx);
 		if (!declaration) return "bamboo:export-missing";
-		const initializer = declaration.getInitializer?.();
+		const initializer = childOf(declaration, "initializer");
 		if (!initializer) return void 0;
 		const box = maybeBoxNode(initializer, [], boxCtx);
 		if (!box || Array.isArray(box)) return void 0;
@@ -659,17 +645,18 @@ const digestExportValue = (sourceFile, exportedName, resolveModule, onCrossing)
 };
 //#endregion
 //#region src/get-import-declarations.ts
-function getImportDeclarations(context, sourceFile) {
+function getImportDeclarations$1(context, sourceFile) {
 	const { imports, tsOptions } = context;
 	const importDeclarations = [];
-	sourceFile.getImportDeclarations().forEach((node) => {
+	getImportDeclarations(sourceFile).forEach((node) => {
 		const mod = getModuleSpecifierValue(node);
 		if (!mod) return;
-		node.getNamedImports().forEach((specifier) => {
-			const name = specifier.getNameNode().getText();
+		getNamedImports(node).forEach((specifier) => {
+			const name = nameNodeOf(specifier)?.getText();
+			const alias = getAliasNode(specifier)?.getText() || name;
 			const result = {
-				name,
-				alias: specifier.getAliasNode()?.getText() || name,
+				name: name ?? "",
+				alias: alias ?? "",
 				mod,
 				kind: "named"
 			};
@@ -679,7 +666,7 @@ function getImportDeclarations(context, sourceFile) {
 			})) return;
 			importDeclarations.push(result);
 		});
-		const namespace = node.getNamespaceImport();
+		const namespace = getNamespaceImport(node);
 		if (namespace) {
 			const name = namespace.getText();
 			const result = {
@@ -740,16 +727,16 @@ const findUnresolvable = (node, path, out, seen = /* @__PURE__ */ new Set()) =>
 const writtenProps = (node) => {
 	let literal = node;
 	if (literal && Node.isCallExpression(literal)) {
-		const args = literal.getArguments();
+		const args = literal.arguments;
 		if (args.length !== 1) return void 0;
 		literal = args[0];
 	}
 	if (!literal || !Node.isObjectLiteralExpression(literal)) return void 0;
 	const names = [];
 	let uncertain = false;
-	for (const property of literal.getProperties()) {
+	for (const property of literal.properties) {
 		if (Node.isPropertyAssignment(property) || Node.isShorthandPropertyAssignment(property)) {
-			const name = property.getName();
+			const name = getName(property) ?? "";
 			if (name.startsWith("[")) {
 				uncertain = true;
 				continue;
@@ -786,7 +773,7 @@ const findUnresolvedInValue = (node, resolved, path, out) => {
 	const value = node ? unwrapExpression(node) : void 0;
 	if (!value) return;
 	if (Node.isArrayLiteralExpression(value)) {
-		value.getElements().forEach((element, index) => {
+		value.elements.forEach((element, index) => {
 			const at = path ? `${path}.${index}` : String(index);
 			const element_ = resolved?.[index];
 			if (Node.isSpreadElement(element) && element_ == null) {
@@ -801,16 +788,16 @@ const findUnresolvedInValue = (node, resolved, path, out) => {
 		return;
 	}
 	if (!Node.isObjectLiteralExpression(value)) return;
-	const properties = value.getProperties();
+	const properties = value.properties;
 	const written = [];
 	let uncertain = false;
 	for (const property of properties) {
 		if (Node.isSpreadAssignment(property)) {
-			const spread = unwrapExpression(property.getExpression());
+			const spread = unwrapExpression(property.expression);
 			if (Node.isObjectLiteralExpression(spread)) {
-				for (const inner of spread.getProperties()) {
+				for (const inner of spread.properties) {
 					if (!Node.isPropertyAssignment(inner) && !Node.isShorthandPropertyAssignment(inner)) continue;
-					const innerName = inner.getName();
+					const innerName = getName(inner) ?? "";
 					if (!innerName.startsWith("[")) written.push(innerName.replace(/^['"]|['"]$/g, ""));
 				}
 				continue;
@@ -819,7 +806,7 @@ const findUnresolvedInValue = (node, resolved, path, out) => {
 			continue;
 		}
 		if (!Node.isPropertyAssignment(property) && !Node.isShorthandPropertyAssignment(property)) continue;
-		const name = property.getName();
+		const name = getName(property) ?? "";
 		if (name.startsWith("[")) {
 			uncertain = true;
 			continue;
@@ -837,9 +824,9 @@ const findUnresolvedInValue = (node, resolved, path, out) => {
 	});
 	for (const property of properties) {
 		if (!Node.isPropertyAssignment(property)) continue;
-		const name = property.getName().replace(/^['"]|['"]$/g, "");
+		const name = (getName(property) ?? "").replace(/^['"]|['"]$/g, "");
 		if (name.startsWith("[")) continue;
-		findUnresolvedInValue(property.getInitializer(), resolved?.[name], path ? `${path}.${name}` : name, out);
+		findUnresolvedInValue(property.initializer, resolved?.[name], path ? `${path}.${name}` : name, out);
 	}
 };
 /** A recipe config the build could not fully read — see `findUnresolvedInValue`. */
@@ -849,7 +836,7 @@ const findUnresolvedRecipeStyles = (item) => {
 	if (!node || !sourceFile) return [];
 	let argument = node;
 	if (Node.isCallExpression(argument)) {
-		const args = argument.getArguments();
+		const args = argument.arguments;
 		if (args.length !== 1) return [];
 		argument = args[0];
 	}
@@ -858,10 +845,10 @@ const findUnresolvedRecipeStyles = (item) => {
 	if (!config || !Node.isObjectLiteralExpression(config)) losses.push({ reason: "unresolvable-value" });
 	else findUnresolvedInValue(config, item.data[0], "", losses);
 	if (!losses.length) return [];
-	const { line, column } = sourceFile.getLineAndColumnAtPos(node.getStart());
+	const { line, column } = getLineAndColumnAtPos(sourceFile, node.getStart());
 	return losses.map((loss) => ({
 		column,
-		filePath: sourceFile.getFilePath(),
+		filePath: pathOf(sourceFile),
 		kind: "recipe",
 		line,
 		...loss
@@ -891,9 +878,9 @@ const findUnresolvedStyles = (item, kind) => {
 		if (written.uncertain && !hasKeyOutside(resolved, written.names)) losses.push({ reason: "unenumerable-keys" });
 	}
 	if (!losses.length) return [];
-	const { line, column } = sourceFile.getLineAndColumnAtPos(node.getStart());
+	const { line, column } = getLineAndColumnAtPos(sourceFile, node.getStart());
 	const at = {
-		filePath: sourceFile.getFilePath(),
+		filePath: pathOf(sourceFile),
 		line,
 		column
 	};
@@ -1119,7 +1106,7 @@ var ParserResult = class {
 		const visit = (node) => {
 			if (!node || seen.has(node)) return;
 			seen.add(node);
-			const path = node.getNode?.()?.getSourceFile().getFilePath().replaceAll("\\", "/");
+			const path = pathOf(node.getNode?.()?.getSourceFile())?.replaceAll("\\", "/");
 			if (path && path !== own) paths.add(path);
 			if (box.isMap(node)) for (const child of node.value.values()) visit(child);
 			else if (box.isArray(node)) for (const child of node.value) visit(child);
@@ -1171,6 +1158,17 @@ const combineResult = (unboxed) => {
 		...unboxed.spreadConditions
 	];
 };
+/** The exact binding token accounting visits for a token call. */
+const tokenCalleeRange = (call) => {
+	if (!Node.isCallExpression(call)) return void 0;
+	let current = call.expression;
+	while (Node.isPropertyAccessExpression(current)) current = current.expression;
+	if (!Node.isIdentifier(current)) return void 0;
+	return {
+		start: current.getStart(),
+		end: current.getEnd()
+	};
+};
 const defaultEnv = { preset: "ECMA" };
 /**
 * `fallback()` is generated into `styled-system/css`, so evaluating a call to it would mean
@@ -1184,16 +1182,16 @@ function createParser(context) {
 	const { jsx, imports, recipes } = context;
 	return function parse(sourceFile, encoder, options, resolveModule) {
 		if (!sourceFile) return;
-		const importDeclarations = getImportDeclarations(context, sourceFile);
+		const importDeclarations = getImportDeclarations$1(context, sourceFile);
 		const file = imports.file(importDeclarations);
-		const filePath = sourceFile.getFilePath();
+		const filePath = pathOf(sourceFile);
 		logger.debug("ast:import", !file.isEmpty() ? `Found import { ${file.toString()} } in ${filePath}` : `No import found in ${filePath}`);
 		const parserResult = new ParserResult(context, encoder);
 		const importedRecipes = resolveModule ? importedRecipeBindings(sourceFile, imports, resolveModule) : /* @__PURE__ */ new Map();
 		if (file.isEmpty() && !jsx.isEnabled && importedRecipes.size === 0) return parserResult;
 		parserResult.importedRecipes = importedRecipes;
 		for (const binding of importedRecipes.keys()) file.addLocalRecipe(binding);
-		if (file.importsRecipeFactory()) for (const statement of sourceFile.compilerNode.statements) {
+		if (file.importsRecipeFactory()) for (const statement of sourceFile.statements) {
 			if (!ts.isVariableStatement(statement)) continue;
 			if (!(statement.declarationList.flags & ts.NodeFlags.Const)) continue;
 			for (const declaration of statement.declarationList.declarations) {
@@ -1218,7 +1216,7 @@ function createParser(context) {
 		* Defined out here rather than inside `getEvaluateOptions`, which runs per call node.
 		*/
 		const reportUnresolvedRaw = (base, at) => {
-			const { line, column } = sourceFile.getLineAndColumnAtPos(at.getStart());
+			const { line, column } = getLineAndColumnAtPos(sourceFile, at.getStart());
 			parserResult.unresolved.push({
 				kind: "atomic",
 				prop: base,
@@ -1261,7 +1259,7 @@ function createParser(context) {
 			},
 			getEvaluateOptions: (node) => {
 				if (!Node.isCallExpression(node)) return evaluateOptions;
-				const propAccessExpr = node.getExpression();
+				const propAccessExpr = node.expression;
 				if (Node.isIdentifier(propAccessExpr)) {
 					const local = propAccessExpr.getText();
 					if (!file.match(local) || file.getName(local) !== "fallback") return evaluateOptions;
@@ -1306,7 +1304,8 @@ function createParser(context) {
 						if (query.kind === "call-expression") parserResult.setToken({
 							name: "token.value",
 							box: query.box.value[0] ?? box.fallback(query.box),
-							data: combineResult(unbox(query.box.value[0]))
+							data: combineResult(unbox(query.box.value[0])),
+							tokenCalleeRange: tokenCalleeRange(query.box.getNode())
 						}, "tokenValue");
 					});
 					return;
@@ -1329,12 +1328,13 @@ function createParser(context) {
 						if (query.kind === "call-expression") parserResult.setToken({
 							name,
 							box: query.box.value[0] ?? box.fallback(query.box),
-							data: combineResult(unbox(query.box.value[0]))
+							data: combineResult(unbox(query.box.value[0])),
+							tokenCalleeRange: tokenCalleeRange(query.box.getNode())
 						});
 					});
 				}).when(file.isValidPattern, (name) => {
 					result.queryList.forEach((query) => {
-						if (query.kind === "call-expression") parserResult.setPattern(name, {
+						if (query.kind === "call-expression") parserResult.setPattern(name ?? "", {
 							name,
 							box: query.box.value[0] ?? box.fallback(query.box),
 							data: combineResult(unbox(query.box.value[0]))
@@ -1342,7 +1342,7 @@ function createParser(context) {
 					});
 				}).when(file.isValidRecipe, (name) => {
 					result.queryList.forEach((query) => {
-						if (query.kind === "call-expression") parserResult.setRecipe(name, {
+						if (query.kind === "call-expression") parserResult.setRecipe(name ?? "", {
 							name,
 							box: query.box.value[0] ?? box.fallback(query.box),
 							data: combineResult(unbox(query.box.value[0]))
@@ -1360,8 +1360,8 @@ function createParser(context) {
 			} else if (jsx.isEnabled && result.kind === "component") result.queryList.forEach((query) => {
 				const data = combineResult(unbox(query.box));
 				for (const tag of [name, alias]) {
-					if (!jsx.isJsxTagRecipe(tag)) continue;
-					recipes.filter(tag).forEach((recipe) => {
+					if (!jsx.isJsxTagRecipe(tag ?? "")) continue;
+					recipes.filter(tag ?? "").forEach((recipe) => {
 						parserResult.setRecipe(recipe.baseName, {
 							type: "jsx-recipe",
 							name: tag,
@@ -1374,19 +1374,16 @@ function createParser(context) {
 			});
 		});
 		parserResult.deadCalls = file.getDeadCalls();
-		if (exportReadPairs.size) {
-			const project = sourceFile.getProject();
-			parserResult.setExportReads([...exportReadPairs].map((pair) => {
-				const at = pair.indexOf("\0");
-				const file = pair.slice(0, at);
-				const name = pair.slice(at + 1);
-				return {
-					file,
-					name,
-					digest: digestExportValue(project.getSourceFile(file), name, resolveModule)
-				};
-			}));
-		}
+		if (exportReadPairs.size) parserResult.setExportReads([...exportReadPairs].map((pair) => {
+			const at = pair.indexOf("\0");
+			const file = pair.slice(0, at);
+			const name = pair.slice(at + 1);
+			return {
+				file,
+				name,
+				digest: digestExportValue(resolveModule?.(file, sourceFile), name, resolveModule)
+			};
+		}));
 		return parserResult;
 	};
 }
@@ -1403,11 +1400,16 @@ const invalidateResolutions = () => {
 	clearBoxNodeCache();
 	clearImportedRecipeCache();
 };
-const normalizeCompilerOptions = (raw, basePath = process.cwd()) => {
-	if (!raw) return {};
-	const { options } = ts.convertCompilerOptionsFromJson(raw, basePath);
-	return options;
-};
+/**
+* Compiler options as given.
+*
+* TypeScript 6 needed `convertCompilerOptionsFromJson` to turn a tsconfig's JSON spellings —
+* `"target": "esnext"`, relative `paths` — into the enum values and absolute paths a program
+* consumed. TypeScript 7 parses the tsconfig in the Go process and hands back options already
+* in that form, so there is nothing left to convert; the argument survives because callers pass
+* overrides that are already normalized.
+*/
+const normalizeCompilerOptions = (raw, _basePath = process.cwd()) => raw ?? {};
 /** Snapshot the JSON-shaped ts-morph options while retaining opaque hosts and callbacks. */
 const snapshotProjectOption = (value) => {
 	if (Array.isArray(value)) return value.map(snapshotProjectOption);
@@ -1618,32 +1620,33 @@ var Project = class {
 		this.#assertSourceFilesAccessor();
 		const revision = this.#sourceFiles.revision;
 		this.#sourceFiles.phase = "loading";
+		let candidate;
 		try {
-			const candidate = createTsProject(this.#sourceFiles.projectOptions);
+			candidate = createTsProject(this.#sourceFiles.projectOptions);
 			this.#assertSourceFilesTransaction(revision);
 			let loaded = 0;
+			const entries = [];
 			for (const [index, file] of this.#sourceFiles.initialFiles.entries()) try {
 				const content = read(file, index);
 				this.#assertSourceFilesTransaction(revision);
-				candidate.createSourceFile(file, content, {
-					overwrite: true,
-					scriptKind: scriptKindFor(file)
-				});
+				entries.push([file, content]);
 				this.#assertSourceFilesTransaction(revision);
 				loaded++;
 			} catch (error) {
 				this.#assertSourceFilesTransaction(revision);
 				if (!skipMissing || error?.code !== "ENOENT") throw error;
 			}
+			candidate.addSourceFiles(entries);
 			this.#assertSourceFilesTransaction(revision);
 			if (loaded > 0) invalidateResolutions();
-			this.#moduleResolutionCache = void 0;
+			this.#resolver = void 0;
 			this.#fileTreeRevision++;
 			this.#assertSourceFilesTransaction(revision);
 			this.#sourceFiles.project = candidate;
 			this.#sourceFiles.phase = "ready";
 			return;
 		} catch (error) {
+			candidate?.dispose();
 			this.#sourceFiles.project = void 0;
 			this.#sourceFiles.phase = "pending";
 			throw error;
@@ -1716,7 +1719,7 @@ var Project = class {
 		sourceFilesRead: 0
 	};
 	resetResolutionState = () => {
-		this.#moduleResolutionCache = void 0;
+		this.#resolver = void 0;
 		this.#fileTreeRevision++;
 		this.dependents = /* @__PURE__ */ new Map();
 		this.dependencies = /* @__PURE__ */ new Map();
@@ -1757,12 +1760,24 @@ var Project = class {
 	};
 	getSourceFile = (filePath) => {
 		this.#assertNotLoading();
+		if (!this.project.has(filePath)) return void 0;
 		return this.project.getSourceFile(filePath);
 	};
+	/**
+	* How many syntax errors this file's parse produced.
+	*
+	* Asked by the token accounting, which may only speak for a file whose tree it can trust: a
+	* construct the parser could not read leaves an ast that stops early, and every call below
+	* the offending line silently ceases to exist. Zero means the file parsed as written.
+	*/
+	getSyntacticDiagnosticCount = (filePath) => {
+		this.#assertNotLoading();
+		return this.project.getSyntacticDiagnosticCount(filePath);
+	};
 	/** ts-morph reports forward slashes; normalize callers' paths to match on Windows. */
 	normalizePath = (filePath) => filePath.replaceAll("\\", "/");
 	/** Shared filesystem-only resolution cache; no type checker is constructed. */
-	#moduleResolutionCache;
+	#resolver;
 	/**
 	* Everything memoized against the shape of the file tree, including the negative half.
 	*
@@ -1795,7 +1810,7 @@ var Project = class {
 		}
 		invalidateResolutions();
 		if (fileTreeChanged) {
-			this.#moduleResolutionCache = void 0;
+			this.#resolver = void 0;
 			this.#fileTreeRevision++;
 		}
 	};
@@ -1818,17 +1833,10 @@ var Project = class {
 				...this.#sourceFiles.projectOptions,
 				compilerOptions: snapshotProjectOption(next)
 			};
-			if (this.#sourceFiles.phase === "ready") {
-				const current = this.project.getCompilerOptions();
-				const cleared = Object.fromEntries(Object.keys(current).map((key) => [key, void 0]));
-				this.project.compilerOptions.set({
-					...cleared,
-					...next
-				});
-			}
+			this.#sourceFiles.project?.setCompilerOptions(next);
 		}
 		invalidateResolutions();
-		this.#moduleResolutionCache = void 0;
+		this.#resolver = void 0;
 		this.#fileTreeRevision++;
 		this.sourcePreparations.clear();
 	};
@@ -1874,33 +1882,33 @@ var Project = class {
 		this.#assertNotLoading();
 		const project = this.project;
 		const compilerOptions = project.getCompilerOptions();
-		this.#moduleResolutionCache ??= ts.createModuleResolutionCache(project.getFileSystem().getCurrentDirectory(), (f) => f, compilerOptions);
 		const configurationFiles = /* @__PURE__ */ new Set();
-		const resolutionHost = project.getModuleResolutionHost();
 		const recordConfigurationFile = (filePath) => {
 			const normalized = this.normalizePath(filePath);
 			if (!normalized.endsWith("/package.json") || normalized.includes("/node_modules/")) return;
 			if (!this.isInCheckout(normalized)) return;
 			configurationFiles.add(normalized);
 		};
-		const host = {
-			...resolutionHost,
-			fileExists: (filePath) => {
-				recordConfigurationFile(filePath);
-				return resolutionHost.fileExists(filePath);
-			},
-			readFile: (filePath) => {
-				recordConfigurationFile(filePath);
-				return resolutionHost.readFile?.(filePath);
+		this.#resolver ??= createResolver({
+			cwd: project.getCurrentDirectory(),
+			fs: {
+				fileExists: (filePath) => project.fileExists(filePath),
+				readFile: (filePath) => project.readFile(filePath)
 			}
-		};
+		});
+		const configured = this.#sourceFiles.projectOptions.compilerOptions ?? compilerOptions;
 		this.resolutionWork.moduleResolutionsAttempted++;
-		const resolved = ts.resolveModuleName(moduleName, from.getFilePath(), compilerOptions, host, this.#moduleResolutionCache);
-		const failedLookupLocations = resolved.failedLookupLocations;
-		const affectingLocations = resolved.affectingLocations;
-		for (const filePath of affectingLocations ?? []) recordConfigurationFile(filePath);
-		const pendingCandidates = this.getLocalFailedLookupCandidates(failedLookupLocations);
-		const module = resolved.resolvedModule;
+		const resolved = this.#resolver(moduleName, {
+			importer: pathOf(from),
+			baseUrl: configured?.baseUrl,
+			paths: configured?.paths
+		});
+		for (const filePath of resolved.affectingFiles) recordConfigurationFile(filePath);
+		const pendingCandidates = this.getLocalFailedLookupCandidates(resolved.failedLookups);
+		const module = resolved.path ? {
+			resolvedFileName: resolved.path,
+			isExternalLibraryImport: resolved.path.includes("/node_modules/")
+		} : void 0;
 		if (!module) return {
 			configurationFiles: [...configurationFiles].sort(),
 			local: this.isUnresolvedLocalSpecifier(moduleName, pendingCandidates) || moduleName.startsWith("#"),
@@ -1917,7 +1925,7 @@ var Project = class {
 			local: this.isUnresolvedLocalSpecifier(moduleName, pendingCandidates),
 			pendingCandidates
 		};
-		const existing = project.getSourceFile(name);
+		const existing = this.project.has(name) ? project.getSourceFile(name) : void 0;
 		if (existing) {
 			this.removedSourcePaths.delete(name);
 			return {
@@ -1936,12 +1944,10 @@ var Project = class {
 		try {
 			this.resolutionWork.sourceFilesRead++;
 			const content = project.getFileSystem().readFileSync(name);
-			const sourceFile = project.createSourceFile(name, content, {
-				overwrite: true,
-				scriptKind: scriptKindFor(name)
-			});
+			const sourceFile = project.createSourceFile(name, content, { scriptKind: scriptKindFor(name) });
+			if (!sourceFile) throw new Error(`bamboo: resolved ${name} but the project produced no source file`);
 			this.resolutionWork.sourceFilesAdded++;
-			this.canonicalPaths.set(name, this.normalizePath(sourceFile.getFilePath()));
+			this.canonicalPaths.set(name, this.normalizePath(pathOf(sourceFile)));
 			return {
 				configurationFiles: [...configurationFiles].sort(),
 				local: true,
@@ -1995,28 +2001,28 @@ var Project = class {
 	};
 	ensureResolutionFacts = (sourceFile) => {
 		this.#assertNotLoading();
-		const importer = this.normalizePath(sourceFile.getFilePath());
+		const importer = this.normalizePath(pathOf(sourceFile));
 		const text = sourceFile.getFullText();
 		const cached = this.resolutionsByImporter.get(importer);
 		if (cached?.sourceFile === sourceFile && cached.text === text && cached.treeRevision === this.#fileTreeRevision) return cached;
-		const declarations = [...sourceFile.getImportDeclarations().map((declaration) => ({
+		const declarations = [...getImportDeclarations(sourceFile).map((declaration) => ({
 			declaration,
 			kind: "import"
-		})), ...sourceFile.getExportDeclarations().map((declaration) => ({
+		})), ...getExportDeclarations(sourceFile).map((declaration) => ({
 			declaration,
 			kind: "export"
-		}))].filter(({ declaration }) => declaration.getModuleSpecifierValue() !== void 0).sort((left, right) => left.declaration.getStart() - right.declaration.getStart());
+		}))].filter(({ declaration }) => getModuleSpecifierValue(declaration) !== void 0).sort((left, right) => left.declaration.getStart() - right.declaration.getStart());
 		const facts = [];
 		const pendingCandidates = [];
 		const configurationFiles = [];
 		for (const [ordinal, { declaration, kind }] of declarations.entries()) {
-			const specifier = declaration.getModuleSpecifierValue();
+			const specifier = getModuleSpecifierValue(declaration);
 			if (!specifier) continue;
 			const resolved = this.resolveSpecifier(specifier, sourceFile);
 			if (!resolved.local) continue;
 			facts.push(Object.freeze({
 				importer,
-				target: resolved.sourceFile ? this.normalizePath(resolved.sourceFile.getFilePath()) : null,
+				target: resolved.sourceFile ? this.normalizePath(pathOf(resolved.sourceFile)) : null,
 				specifier,
 				kind,
 				ordinal
@@ -2041,22 +2047,22 @@ var Project = class {
 	};
 	/** The sole cross-file source resolver supplied to parser and extractor. */
 	resolveModule = (specifier, from) => {
-		const target = this.ensureResolutionFacts(from).facts.find((fact) => fact.specifier === specifier)?.target;
+		const target = this.ensureResolutionFacts(from).facts.find((fact) => fact.specifier === specifier)?.target ?? (specifier.startsWith("/") ? specifier : void 0);
 		if (!target) return;
 		const sourceFile = this.project.getSourceFile(target);
 		if (!sourceFile) return;
-		this.prepareEffectiveSource(sourceFile.getFilePath(), sourceFile);
+		this.prepareEffectiveSource(pathOf(sourceFile), sourceFile);
 		return sourceFile;
 	};
 	trackDependencies = (filePath, sourceFile) => {
 		this.#assertNotLoading();
-		const importer = this.normalizePath(sourceFile.getFilePath());
+		const importer = this.normalizePath(pathOf(sourceFile));
 		this.canonicalPaths.set(this.normalizePath(filePath), importer);
 		this.canonicalPaths.set(importer, importer);
 		this.ensureResolutionFacts(sourceFile);
 	};
 	invalidateSourcePreparation = (filePath, sourceFile) => {
-		const sourcePath = this.normalizePath(sourceFile?.getFilePath() ?? filePath);
+		const sourcePath = this.normalizePath(pathOf(sourceFile) ?? filePath);
 		const preparation = this.sourcePreparations.get(sourcePath);
 		if (preparation?.state === "preparing") preparation.invalidated = true;
 		this.sourcePreparations.delete(sourcePath);
@@ -2072,7 +2078,7 @@ var Project = class {
 	*/
 	prepareEffectiveSource = (filePath, sourceFile, hookFilePath = filePath) => {
 		this.#assertNotLoading();
-		const sourcePath = this.normalizePath(sourceFile.getFilePath());
+		const sourcePath = this.normalizePath(pathOf(sourceFile));
 		const currentText = sourceFile.getFullText();
 		const current = this.sourcePreparations.get(sourcePath);
 		if (current?.state === "ready" && current.sourceFile === sourceFile && current.effectiveText === currentText) {
@@ -2117,7 +2123,7 @@ var Project = class {
 			assertTransaction(currentText);
 			const transformed = custom ?? this.transformFile(hookFilePath, currentText);
 			assertTransaction(currentText);
-			if (currentText !== transformed) sourceFile.replaceWithText(transformed);
+			if (currentText !== transformed) sourceFile = this.project.addSourceFile(filePath, transformed) ?? sourceFile;
 			assertTransaction(transformed);
 			this.trackDependencies(filePath, sourceFile);
 			assertTransaction(transformed);
@@ -2134,7 +2140,7 @@ var Project = class {
 			if (this.sourcePreparations.get(sourcePath) === transaction) this.sourcePreparations.delete(sourcePath);
 			this.retractImporter(sourcePath);
 			try {
-				if (sourceFile.getFullText() !== currentText) sourceFile.replaceWithText(currentText);
+				if (sourceFile.getFullText() !== currentText) this.project.addSourceFile(filePath, currentText);
 			} catch {}
 			throw error;
 		}
@@ -2161,7 +2167,7 @@ var Project = class {
 		this.retractImporter(target);
 		this.removedSourcePaths.add(target);
 		this.canonicalPaths.set(target, target);
-		this.canonicalPaths.set(this.normalizePath(sourceFile.getFilePath()), target);
+		this.canonicalPaths.set(this.normalizePath(pathOf(sourceFile)), target);
 	};
 	/**
 	* Every file that transitively imports `filePath`, so a watcher can re-parse the
@@ -2170,7 +2176,7 @@ var Project = class {
 	getDependents = (filePath) => {
 		this.#assertNotLoading();
 		const given = this.normalizePath(filePath);
-		const resolved = this.project.getSourceFile(filePath)?.getFilePath();
+		const resolved = pathOf(this.project.getSourceFile(filePath));
 		const start = resolved ? this.normalizePath(resolved) : this.canonicalPaths.get(given) ?? given;
 		const seen = /* @__PURE__ */ new Set();
 		const queue = [start];
@@ -2198,7 +2204,7 @@ var Project = class {
 	getDependencies = (filePath, targets) => {
 		this.#assertNotLoading();
 		const given = this.normalizePath(filePath);
-		const resolved = this.project.getSourceFile(filePath)?.getFilePath();
+		const resolved = pathOf(this.project.getSourceFile(filePath));
 		const start = resolved ? this.normalizePath(resolved) : this.canonicalPaths.get(given) ?? given;
 		const seen = /* @__PURE__ */ new Set();
 		const importersByDependency = /* @__PURE__ */ new Map();
@@ -2219,7 +2225,7 @@ var Project = class {
 		const selected = /* @__PURE__ */ new Set();
 		const reverse = Array.from(targets, (target) => {
 			const normalized = this.normalizePath(target);
-			const source = this.project.getSourceFile(target)?.getFilePath();
+			const source = pathOf(this.project.getSourceFile(target));
 			return source ? this.normalizePath(source) : this.canonicalPaths.get(normalized) ?? normalized;
 		}).filter((target) => seen.has(target));
 		let reverseCursor = 0;
@@ -2245,7 +2251,7 @@ var Project = class {
 		const selected = new Set(dependencies);
 		const retained = new Set([...previous?.dependencies ?? [], ...previous?.pendingCandidates ?? []]);
 		const given = this.normalizePath(filePath);
-		const resolved = this.project.getSourceFile(filePath)?.getFilePath();
+		const resolved = pathOf(this.project.getSourceFile(filePath));
 		const start = resolved ? this.normalizePath(resolved) : this.canonicalPaths.get(given) ?? given;
 		const pendingCandidates = /* @__PURE__ */ new Set();
 		for (const importer of [start, ...dependencies]) {
@@ -2278,7 +2284,7 @@ var Project = class {
 		const selected = new Set(dependencies);
 		const retained = new Set(Array.from(previous, (file) => this.normalizePath(file)));
 		const given = this.normalizePath(filePath);
-		const resolved = this.project.getSourceFile(filePath)?.getFilePath();
+		const resolved = pathOf(this.project.getSourceFile(filePath));
 		const start = resolved ? this.normalizePath(resolved) : this.canonicalPaths.get(given) ?? given;
 		const files = /* @__PURE__ */ new Set();
 		let hasSemanticFact = false;
@@ -2305,10 +2311,9 @@ var Project = class {
 		this.invalidateSourcePreparation(filePath, existing);
 		this.removedSourcePaths.delete(this.normalizePath(filePath));
 		this.invalidate();
-		return this.project.createSourceFile(filePath, content, {
-			overwrite: true,
-			scriptKind: scriptKindFor(filePath)
-		});
+		const created = this.project.createSourceFile(filePath, content, { scriptKind: scriptKindFor(filePath) });
+		if (!created) throw new Error(`bamboo: could not add ${filePath} to the project`);
+		return created;
 	};
 	createSourceFiles = () => {
 		this.#assertNotLoading();
@@ -2347,17 +2352,15 @@ var Project = class {
 		* matches its own source, falls through, and is overwritten exactly as before.
 		*/
 		if (existing && existing.getFullText() === content) {
-			this.markAuxiliary(existing.getFilePath(), options.auxiliary);
+			this.markAuxiliary(pathOf(existing), options.auxiliary);
 			return existing;
 		}
 		this.invalidateSourcePreparation(filePath, existing);
 		this.removedSourcePaths.delete(this.normalizePath(filePath));
-		this.invalidate(!existing, existing?.getFilePath());
-		const sourceFile = this.project.createSourceFile(filePath, content, {
-			overwrite: true,
-			scriptKind: scriptKindFor(filePath)
-		});
-		this.markAuxiliary(sourceFile.getFilePath(), options.auxiliary);
+		this.invalidate(!existing, pathOf(existing));
+		const sourceFile = this.project.createSourceFile(filePath, content, { scriptKind: scriptKindFor(filePath) });
+		if (!sourceFile) throw new Error(`bamboo: could not add ${filePath} to the project`);
+		this.markAuxiliary(pathOf(sourceFile), options.auxiliary);
 		return sourceFile;
 	};
 	/** Claim or release compiler ownership of one source, in the ledger's own spelling. */
@@ -2373,10 +2376,10 @@ var Project = class {
 		if (sourceFile) {
 			this.invalidate();
 			this.invalidateSourcePreparation(filePath, sourceFile);
-			this.markTargetRemoved(this.normalizePath(sourceFile.getFilePath()), sourceFile);
-			this.options.parserOptions.encoder.releaseFile(sourceFile.getFilePath());
-			this.auxiliarySources.delete(this.normalizePath(sourceFile.getFilePath()));
-			return this.project.removeSourceFile(sourceFile);
+			this.markTargetRemoved(this.normalizePath(pathOf(sourceFile)), sourceFile);
+			this.options.parserOptions.encoder.releaseFile(pathOf(sourceFile));
+			this.auxiliarySources.delete(this.normalizePath(pathOf(sourceFile)));
+			return this.project.removeSourceFile(pathOf(sourceFile));
 		}
 		return false;
 	};
@@ -2395,10 +2398,10 @@ var Project = class {
 		this.#assertNotLoading();
 		this.#ensureSourceFiles();
 		const sourceFile = this.getSourceFile(filePath);
-		this.invalidate(false, sourceFile?.getFilePath());
+		this.invalidate(false, pathOf(sourceFile));
 		if (!sourceFile) return;
 		this.invalidateSourcePreparation(filePath, sourceFile);
-		return sourceFile.refreshFromFileSystemSync();
+		return this.project.reloadSourceFile(filePath);
 	};
 	reloadSourceFiles = () => {
 		this.#assertNotLoading();
@@ -2409,7 +2412,7 @@ var Project = class {
 			const source = this.getSourceFile(file);
 			if (source) {
 				this.invalidateSourcePreparation(file, source);
-				source.refreshFromFileSystemSync();
+				this.project.reloadSourceFile(file);
 			} else {
 				this.invalidateSourcePreparation(file);
 				this.removedSourcePaths.delete(this.normalizePath(file));
@@ -2451,10 +2454,12 @@ var Project = class {
 		const { hooks } = this.options;
 		const hookFilePath = options.hookFilePath ?? filePath;
 		if (filePath.endsWith(".json")) return this.parseJson(filePath, encoder);
-		const sourceFile = this.project.getSourceFile(filePath);
+		let sourceFile = this.project.getSourceFile(filePath);
 		if (!sourceFile) return;
-		const { options: parserOptions } = this.prepareEffectiveSource(filePath, sourceFile, hookFilePath);
-		const result = (encoder ?? this.options.parserOptions.encoder).withOwner("parse", sourceFile.getFilePath(), () => this.parser(sourceFile, encoder, parserOptions, this.resolveModule))?.setFilePath(filePath);
+		const prepared = this.prepareEffectiveSource(filePath, sourceFile, hookFilePath);
+		const parserOptions = prepared.options;
+		sourceFile = prepared.sourceFile ?? sourceFile;
+		const result = (encoder ?? this.options.parserOptions.encoder).withOwner("parse", pathOf(sourceFile), () => this.parser(sourceFile, encoder, parserOptions, this.resolveModule))?.setFilePath(filePath);
 		hooks["parser:after"]?.({
 			filePath: hookFilePath,
 			result