@wyw-in-js/transform 1.1.0 → 2.0.0-alpha.1

package/esm/eval/runner.js

@@ -0,0 +1,1878 @@
+/* eslint-disable no-underscore-dangle */
+/* global BigInt */
+import fs from "node:fs";
+import { Console } from "node:console";
+import { Writable } from "node:stream";
+import vm from "node:vm";
+import path from "node:path";
+import NativeModule, { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
+import { Minimatch } from "minimatch";
+class LruCache {
+	constructor(maxSize) {
+		this.maxSize = Math.max(1, maxSize);
+		this.map = new Map();
+	}
+	get(key) {
+		if (!this.map.has(key)) return undefined;
+		const value = this.map.get(key);
+		this.map.delete(key);
+		this.map.set(key, value);
+		return value;
+	}
+	set(key, value) {
+		if (this.map.has(key)) {
+			this.map.delete(key);
+		}
+		this.map.set(key, value);
+		if (this.map.size > this.maxSize) {
+			const firstKey = this.map.keys().next().value;
+			if (firstKey !== undefined) {
+				this.map.delete(firstKey);
+			}
+		}
+	}
+	delete(key) {
+		this.map.delete(key);
+	}
+	clear() {
+		this.map.clear();
+	}
+}
+const NOOP = () => {};
+// stdout is reserved for the JSON IPC protocol; host-side logs must not share it.
+const prefixStream = (getPrefix) => new Writable({ write(chunk, _enc, cb) {
+	const p = getPrefix();
+	const s = chunk.toString();
+	// Prefix interior newlines but not the trailing one — avoids
+	// double-prefix when consecutive writes each start with a prefix.
+	const tail = s.endsWith("\n") ? "\n" : "";
+	const body = tail ? s.slice(0, -1) : s;
+	process.stderr.write(p + body.replaceAll("\n", `\n${p}`) + tail, cb);
+} });
+// require'd modules outside vm use host console — must not write to stdout (IPC channel).
+global.console = new Console({
+	stdout: prefixStream(() => "[wyw-runner:host stdout] "),
+	stderr: prefixStream(() => "[wyw-runner:host stderr] ")
+});
+const VITE_VIRTUAL_PREFIX = "/@";
+const REACT_REFRESH_VIRTUAL_ID = "/@react-refresh";
+const reactRefreshRuntime = { createSignatureFunctionForTransform: () => () => {} };
+const builtins = {
+	assert: true,
+	buffer: true,
+	child_process: false,
+	cluster: false,
+	console: true,
+	constants: true,
+	crypto: true,
+	dgram: false,
+	dns: false,
+	domain: true,
+	events: true,
+	fs: false,
+	http: true,
+	https: true,
+	module: false,
+	net: false,
+	os: true,
+	path: true,
+	punycode: true,
+	process: true,
+	querystring: true,
+	readline: false,
+	repl: false,
+	stream: true,
+	string_decoder: true,
+	sys: true,
+	timers: true,
+	tls: false,
+	tty: true,
+	url: true,
+	util: true,
+	vm: true,
+	zlib: true
+};
+const RESOLVE_CACHE_SIZE = 5e3;
+const LOAD_CACHE_SIZE = 1e3;
+const MODULE_VARIANT_LIMIT = 8;
+const isBuiltinSpecifier = (specifier) => {
+	const normalized = specifier.startsWith("node:") ? specifier.slice(5) : specifier;
+	return NativeModule.builtinModules?.includes(normalized) || NativeModule.builtinModules?.includes(`node:${normalized}`);
+};
+const packageTypeCache = new Map();
+const getPackageType = (filename) => {
+	let dir = path.dirname(filename);
+	while (dir && dir !== path.dirname(dir)) {
+		const cached = packageTypeCache.get(dir);
+		if (cached === "module" || cached === "commonjs") return cached;
+		const pkgPath = path.join(dir, "package.json");
+		if (fs.existsSync(pkgPath)) {
+			try {
+				const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
+				const type = pkg?.type === "module" ? "module" : "commonjs";
+				packageTypeCache.set(dir, type);
+				return type;
+			} catch {
+				packageTypeCache.set(dir, null);
+				return null;
+			}
+		}
+		packageTypeCache.set(dir, null);
+		dir = path.dirname(dir);
+	}
+	return null;
+};
+const shouldPreferImport = (resolvedFile) => {
+	if (!resolvedFile) return false;
+	if (!path.isAbsolute(resolvedFile)) return false;
+	if (resolvedFile.endsWith(".mjs")) return true;
+	if (resolvedFile.endsWith(".cjs")) return false;
+	if (!resolvedFile.endsWith(".js")) return false;
+	return getPackageType(resolvedFile) === "module";
+};
+const isPlainObject = (value) => {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) {
+		return false;
+	}
+	const prototype = Object.getPrototypeOf(value);
+	if (prototype === null || prototype === Object.prototype) {
+		return true;
+	}
+	return Object.getPrototypeOf(prototype) === null;
+};
+const ENCODED_GLOBAL_ENVELOPE_KEY = "__wyw_eval_global";
+const ENCODED_GLOBAL_SIGNATURE = "wyw-eval-global";
+const ENCODED_GLOBAL_VERSION = 1;
+const IDENTIFIER_RE = /^[A-Za-z_$][\w$]*$/u;
+const ARRAY_INDEX_RE = /^(?:0|[1-9]\d*)$/;
+const IPC_SUPPORTED_VALUE_HINT = "Use importOverrides to mock the import or return plain data: null, booleans, strings, numbers, bigint, undefined, arrays, plain objects, and Error.";
+const getObjectTypeName = (value) => {
+	const { constructor } = value ?? {};
+	if (constructor && typeof constructor.name === "string" && constructor.name.length > 0) {
+		return constructor.name;
+	}
+	const tag = Object.prototype.toString.call(value);
+	return tag.slice(8, -1) || "Object";
+};
+const getBoxedPrimitiveValue = (value) => {
+	const tag = Object.prototype.toString.call(value);
+	if (tag === "[object String]") {
+		return {
+			kind: "string",
+			value: String(value.valueOf())
+		};
+	}
+	if (tag === "[object Number]") {
+		return {
+			kind: "number",
+			value: Number(value.valueOf())
+		};
+	}
+	if (tag === "[object Boolean]") {
+		return {
+			kind: "boolean",
+			value: Boolean(value.valueOf())
+		};
+	}
+	return null;
+};
+const formatPath = (rootLabel, pathSegments) => pathSegments.reduce((acc, segment) => {
+	if (typeof segment === "number") {
+		return `${acc}[${segment}]`;
+	}
+	if (typeof segment === "symbol") {
+		return `${acc}[${String(segment)}]`;
+	}
+	if (IDENTIFIER_RE.test(segment)) {
+		return `${acc}.${segment}`;
+	}
+	return `${acc}[${JSON.stringify(segment)}]`;
+}, rootLabel);
+const formatGlobalsPath = (pathSegments) => formatPath("eval.globals", pathSegments);
+const restoreGlobalFunction = (source, pathSegments) => {
+	try {
+		// eslint-disable-next-line no-eval
+		const restored = eval(`(${source})`);
+		if (typeof restored !== "function") {
+			throw new TypeError("decoded source is not a function");
+		}
+		return restored;
+	} catch (error) {
+		throw new Error(`[wyw-in-js] Failed to restore eval.globals function at ${formatGlobalsPath(pathSegments)}. ` + `Ensure the value is a user-defined function expression/arrow function. ` + `Native and bound functions are not supported. ` + `Original error: ${String(error)}`);
+	}
+};
+const isEncodedGlobalPayload = (value) => {
+	if (!isPlainObject(value)) {
+		return false;
+	}
+	if (value.signature !== ENCODED_GLOBAL_SIGNATURE || value.version !== ENCODED_GLOBAL_VERSION) {
+		return false;
+	}
+	if (value.kind === "function") {
+		return typeof value.source === "string";
+	}
+	if (value.kind === "symbol") {
+		return typeof value.description === "string";
+	}
+	return false;
+};
+const isEncodedGlobalEnvelope = (value) => {
+	if (!isPlainObject(value)) {
+		return false;
+	}
+	const keys = Object.keys(value);
+	if (keys.length !== 1 || keys[0] !== ENCODED_GLOBAL_ENVELOPE_KEY) {
+		return false;
+	}
+	return isEncodedGlobalPayload(value[ENCODED_GLOBAL_ENVELOPE_KEY]);
+};
+const canonicalizeForSignature = (value) => {
+	if (Array.isArray(value)) {
+		return value.map((item) => canonicalizeForSignature(item));
+	}
+	if (isPlainObject(value)) {
+		return Object.fromEntries(Object.keys(value).sort().map((key) => [key, canonicalizeForSignature(value[key])]));
+	}
+	return value;
+};
+const decodeGlobals = (value, pathSegments = []) => {
+	if (Array.isArray(value)) {
+		return value.map((item, index) => decodeGlobals(item, [...pathSegments, index]));
+	}
+	if (isEncodedGlobalEnvelope(value)) {
+		const payload = value[ENCODED_GLOBAL_ENVELOPE_KEY];
+		if (payload.kind === "function") {
+			return restoreGlobalFunction(payload.source, pathSegments);
+		}
+		return Symbol(payload.description);
+	}
+	if (isPlainObject(value)) {
+		return Object.fromEntries(Object.entries(value).map(([key, item]) => [key, decodeGlobals(item, [...pathSegments, key])]));
+	}
+	return value;
+};
+const getEnumerableSymbolKeys = (value) => Object.getOwnPropertySymbols(value).filter((key) => Object.prototype.propertyIsEnumerable.call(value, key));
+const isLikeError = (value) => typeof value === "object" && value !== null && !isPlainObject(value) && "message" in value && typeof value.message === "string" && ("stack" in value || "name" in value);
+const throwUnsupportedIpcValue = (rootLabel, pathSegments, description) => {
+	throw new Error(`[wyw-in-js] ${rootLabel} contains ${description} at ${formatPath(rootLabel, pathSegments)}. ${IPC_SUPPORTED_VALUE_HINT}`);
+};
+const serializeValueAtPath = (value, rootLabel, pathSegments, seen, allowFunctions, allowSymbols) => {
+	if (value === null) {
+		return { kind: "null" };
+	}
+	if (value === undefined) return { kind: "undefined" };
+	if (typeof value === "boolean") {
+		return {
+			kind: "boolean",
+			value
+		};
+	}
+	if (typeof value === "string") {
+		return {
+			kind: "string",
+			value
+		};
+	}
+	if (typeof value === "number") {
+		if (Number.isNaN(value)) return { kind: "nan" };
+		if (value === Infinity) return { kind: "infinity" };
+		if (value === -Infinity) return { kind: "-infinity" };
+		return {
+			kind: "number",
+			value
+		};
+	}
+	if (typeof value === "bigint") {
+		return {
+			kind: "bigint",
+			value: value.toString()
+		};
+	}
+	if (typeof value === "function") {
+		if (allowFunctions) {
+			// __wywPreval consumers only rely on function-ness, not implementation
+			// identity. Preserve that signal explicitly instead of letting JSON
+			// coerce to null/undefined.
+			return { kind: "function" };
+		}
+		throwUnsupportedIpcValue(rootLabel, pathSegments, "an unsupported function");
+	}
+	if (typeof value === "symbol") {
+		if (allowSymbols) {
+			return {
+				kind: "symbol",
+				description: value.description ?? ""
+			};
+		}
+		throwUnsupportedIpcValue(rootLabel, pathSegments, "an unsupported symbol");
+	}
+	if (typeof value === "object" && value !== null) {
+		const boxed = getBoxedPrimitiveValue(value);
+		if (boxed) {
+			if (boxed.kind === "number") {
+				if (Number.isNaN(boxed.value)) return { kind: "nan" };
+				if (boxed.value === Infinity) return { kind: "infinity" };
+				if (boxed.value === -Infinity) return { kind: "-infinity" };
+			}
+			return boxed;
+		}
+	}
+	if (isLikeError(value)) {
+		return {
+			kind: "error",
+			error: {
+				message: value.message,
+				name: value.name,
+				stack: value.stack
+			}
+		};
+	}
+	const currentPath = formatPath(rootLabel, pathSegments);
+	const seenAt = seen.get(value);
+	if (seenAt) {
+		throw new Error(`[wyw-in-js] ${rootLabel} contains a circular reference at ${currentPath} (from ${seenAt}). ${IPC_SUPPORTED_VALUE_HINT}`);
+	}
+	if (Array.isArray(value)) {
+		const symbolKeys = getEnumerableSymbolKeys(value);
+		if (symbolKeys.length > 0) {
+			throwUnsupportedIpcValue(rootLabel, [...pathSegments, symbolKeys[0]], "an unsupported symbol-keyed property");
+		}
+		const extraKey = Object.keys(value).find((key) => !ARRAY_INDEX_RE.test(key) || Number(key) >= value.length);
+		if (extraKey !== undefined) {
+			throwUnsupportedIpcValue(rootLabel, [...pathSegments, extraKey], "an unsupported non-index array property");
+		}
+		seen.set(value, currentPath);
+		try {
+			return {
+				kind: "array",
+				items: Array.from({ length: value.length }, (_, index) => serializeValueAtPath(value[index], rootLabel, [...pathSegments, index], seen, allowFunctions, allowSymbols))
+			};
+		} finally {
+			seen.delete(value);
+		}
+	}
+	if (!isPlainObject(value)) {
+		throwUnsupportedIpcValue(rootLabel, pathSegments, `an unsupported non-plain object (${getObjectTypeName(value)})`);
+	}
+	const symbolKeys = getEnumerableSymbolKeys(value);
+	if (symbolKeys.length > 0) {
+		throwUnsupportedIpcValue(rootLabel, [...pathSegments, symbolKeys[0]], "an unsupported symbol-keyed property");
+	}
+	seen.set(value, currentPath);
+	try {
+		return {
+			kind: "object",
+			entries: Object.fromEntries(Object.entries(value).map(([key, item]) => [key, serializeValueAtPath(item, rootLabel, [...pathSegments, key], seen, allowFunctions, allowSymbols)]))
+		};
+	} finally {
+		seen.delete(value);
+	}
+};
+const isErrRequireEsm = (error) => typeof error === "object" && error !== null && "code" in error && error.code === "ERR_REQUIRE_ESM";
+const serializeValue = (value, options = {}) => serializeValueAtPath(value, options.rootLabel ?? "value", options.path ?? [], new WeakMap(), options.allowFunctions ?? false, options.allowSymbols ?? false);
+const deserializeValue = (value) => {
+	switch (value?.kind) {
+		case "null": return null;
+		case "boolean":
+		case "string":
+		case "number": return value.value;
+		case "undefined": return undefined;
+		case "bigint": return BigInt(value.value);
+		case "nan": return Number.NaN;
+		case "infinity": return Infinity;
+		case "-infinity": return -Infinity;
+		case "function": return () => {};
+		case "symbol":
+ // eslint-disable-next-line symbol-description
+		return value.description ? Symbol.for(value.description) : Symbol();
+		case "error": {
+			const error = new Error(value.error?.message ?? "");
+			if (value.error?.name) {
+				error.name = value.error.name;
+			}
+			if (value.error?.stack) {
+				error.stack = value.error.stack;
+			}
+			return error;
+		}
+		case "array": return value.items.map((item) => deserializeValue(item));
+		case "object": return Object.fromEntries(Object.entries(value.entries).map(([key, item]) => [key, deserializeValue(item)]));
+		case "value":
+		default: return value?.value;
+	}
+};
+const IMPORT_META_ENV = "__wyw_import_meta_env";
+let importMetaEnvWarned = false;
+let happyDomLoadWarned = false;
+let happyDomUnavailable = false;
+let happyDomImportPromise = null;
+const debugEnabled = Boolean(process.env.WYW_EVAL_RUNNER_DEBUG);
+const debug = (...args) => {
+	if (!debugEnabled) return;
+	// eslint-disable-next-line no-console
+	console.warn("[wyw-eval-runner:debug]", ...args);
+};
+const processShim = {
+	nextTick: (fn) => setTimeout(fn, 0),
+	platform: "browser",
+	arch: "browser",
+	execPath: "browser",
+	title: "browser",
+	pid: 1,
+	browser: true,
+	argv: [],
+	binding() {
+		throw new Error("No such module. (Possibly not yet loaded)");
+	},
+	cwd: () => "/",
+	exit: NOOP,
+	kill: NOOP,
+	chdir: NOOP,
+	umask: NOOP,
+	dlopen: NOOP,
+	uptime: NOOP,
+	memoryUsage: NOOP,
+	uvCounters: NOOP,
+	features: {},
+	env: process.env
+};
+const createImportMetaEnvProxy = () => {
+	const target = Object.create(null);
+	const warnOnce = () => {
+		if (importMetaEnvWarned) return;
+		importMetaEnvWarned = true;
+		// eslint-disable-next-line no-console
+		console.warn([
+			`[wyw-in-js] import.meta.env was accessed during build-time evaluation, but no env values were provided.`,
+			``,
+			`If you're using Vite, make sure @wyw-in-js/vite plugin is enabled (it injects Vite env for evaluation).`,
+			`Otherwise provide "__wyw_import_meta_env" via pluginOptions.overrideContext.`
+		].join("\n"));
+	};
+	return new Proxy(target, {
+		get(obj, key) {
+			if (typeof key === "symbol") return Reflect.get(obj, key);
+			warnOnce();
+			return obj[key];
+		},
+		has(obj, key) {
+			if (typeof key === "symbol") return Reflect.has(obj, key);
+			warnOnce();
+			return Reflect.has(obj, key);
+		},
+		getOwnPropertyDescriptor(obj, key) {
+			return Reflect.getOwnPropertyDescriptor(obj, key);
+		},
+		ownKeys(obj) {
+			return Reflect.ownKeys(obj);
+		},
+		set(obj, key, value) {
+			if (typeof key === "symbol") return Reflect.set(obj, key, value);
+			warnOnce();
+			return Reflect.set(obj, key, value);
+		}
+	});
+};
+const HAPPY_DOM_TIMEOUT_MS = Number(process.env.WYW_EVAL_HAPPYDOM_INIT_TIMEOUT_MS ?? process.env.WYW_HAPPYDOM_TIMEOUT_MS ?? 15e3);
+const withTimeout = (promise, timeoutMs, label) => {
+	if (!timeoutMs || timeoutMs <= 0) return promise;
+	let timeoutId;
+	const timeout = new Promise((_, reject) => {
+		timeoutId = setTimeout(() => {
+			const error = new Error(`[wyw-in-js] Timed out while waiting for ${label}.`);
+			error.code = "WYW_HAPPYDOM_TIMEOUT";
+			reject(error);
+		}, timeoutMs);
+	});
+	return Promise.race([promise, timeout]).finally(() => {
+		if (timeoutId) clearTimeout(timeoutId);
+	});
+};
+const loadHappyDom = async () => {
+	if (!happyDomImportPromise) {
+		happyDomImportPromise = import("happy-dom");
+	}
+	return happyDomImportPromise;
+};
+const createWindow = async () => {
+	if (happyDomUnavailable) return undefined;
+	try {
+		debug("happyDom:import:start");
+		const importStart = Date.now();
+		const { Window, GlobalWindow } = await withTimeout(loadHappyDom(), HAPPY_DOM_TIMEOUT_MS, "happy-dom import");
+		debug("happyDom:import:done", Date.now() - importStart);
+		const HappyWindow = GlobalWindow || Window;
+		const windowStart = Date.now();
+		const win = new HappyWindow();
+		debug("happyDom:window:done", Date.now() - windowStart);
+		win.Buffer = Buffer;
+		win.Uint8Array = Uint8Array;
+		return win;
+	} catch (error) {
+		happyDomUnavailable = true;
+		happyDomImportPromise = null;
+		if (!happyDomLoadWarned) {
+			happyDomLoadWarned = true;
+			// eslint-disable-next-line no-console
+			console.warn([
+				`[wyw-in-js] DOM emulation is enabled (features.happyDOM), but "happy-dom" could not be loaded in this build-time runtime.`,
+				`WyW will continue without DOM emulation (as if features.happyDOM:false).`,
+				``,
+				`To silence this warning: set features: { happyDOM: false }.`,
+				`To restore DOM emulation, ensure "happy-dom" can be imported in the build-time runtime.`
+			].join("\n"));
+		}
+		return undefined;
+	}
+};
+const setReferencePropertyIfNotPresent = (context, key) => {
+	if (context[key] === context) return;
+	context[key] = context;
+};
+const createBaseContext = (win, additionalContext) => {
+	const baseContext = win ?? {};
+	setReferencePropertyIfNotPresent(baseContext, "window");
+	setReferencePropertyIfNotPresent(baseContext, "self");
+	setReferencePropertyIfNotPresent(baseContext, "top");
+	setReferencePropertyIfNotPresent(baseContext, "parent");
+	setReferencePropertyIfNotPresent(baseContext, "global");
+	setReferencePropertyIfNotPresent(baseContext, "process");
+	baseContext.document = win?.document;
+	baseContext.process = processShim;
+	baseContext.clearImmediate = NOOP;
+	baseContext.clearInterval = NOOP;
+	baseContext.clearTimeout = NOOP;
+	baseContext.setImmediate = NOOP;
+	baseContext.requestAnimationFrame = NOOP;
+	baseContext.setInterval = NOOP;
+	baseContext.setTimeout = NOOP;
+	Object.assign(baseContext, additionalContext);
+	return baseContext;
+};
+const featureMatchers = new Map();
+const isFeatureEnabled = (features, featureName, filename) => {
+	const value = features?.[featureName] ?? false;
+	if (typeof value === "boolean") return value;
+	if (value === "*" || value === "**/*") return true;
+	const array = Array.isArray(value) ? value : [value];
+	return array.map((pattern) => {
+		let matcher = featureMatchers.get(pattern);
+		if (!matcher) {
+			matcher = [pattern.startsWith("!"), new Minimatch(pattern)];
+			featureMatchers.set(pattern, matcher);
+		}
+		return [matcher[0], matcher[1].match(filename)];
+	}).reduce((acc, [negated, match]) => negated ? acc && match : acc || match, false);
+};
+const createVmContext = async (filename, features, globals) => {
+	const isHappyDomEnabled = isFeatureEnabled(features, "happyDOM", filename);
+	const win = isHappyDomEnabled ? await createWindow() : undefined;
+	const envContext = { [IMPORT_META_ENV]: createImportMetaEnvProxy() };
+	const baseContext = createBaseContext(win, {
+		__filename: filename,
+		...envContext,
+		...globals
+	});
+	// Evaluated code must never write to stdout — it is the IPC channel.
+	const vmIdent = () => `vm(${path.basename(baseContext.__filename ?? "?")})`;
+	baseContext.console = new Console({
+		stdout: prefixStream(() => `[wyw-runner:${vmIdent()} stdout] `),
+		stderr: prefixStream(() => `[wyw-runner:${vmIdent()} stderr] `)
+	});
+	const context = vm.createContext(baseContext);
+	return {
+		context,
+		teardown: () => {
+			if (win?.happyDOM) {
+				win.happyDOM.abort();
+			}
+		}
+	};
+};
+const stripQueryAndHash = (value) => value.split("?")[0]?.split("#")[0] ?? value;
+const normalizeResolvedId = (resolvedId, specifier, importer, extensions) => {
+	const stripped = stripQueryAndHash(resolvedId);
+	if (!stripped) return resolvedId;
+	if (path.extname(stripped)) return resolvedId;
+	const isFileSpecifier = specifier.startsWith(".") || path.isAbsolute(specifier);
+	if (!isFileSpecifier && !path.isAbsolute(stripped)) {
+		return resolvedId;
+	}
+	let candidate = stripped;
+	if (!path.isAbsolute(candidate)) {
+		if (!importer) {
+			return resolvedId;
+		}
+		const importerFile = stripQueryAndHash(importer);
+		candidate = path.resolve(path.dirname(importerFile), candidate);
+	}
+	const suffix = resolvedId.slice(stripped.length);
+	const resolvedExtensions = extensions ?? [];
+	for (let index = 0; index < resolvedExtensions.length; index += 1) {
+		const ext = resolvedExtensions[index];
+		const fileCandidate = `${candidate}${ext}`;
+		if (fs.existsSync(fileCandidate)) {
+			return `${fileCandidate}${suffix}`;
+		}
+		const indexCandidate = path.join(candidate, `index${ext}`);
+		if (fs.existsSync(indexCandidate)) {
+			return `${indexCandidate}${suffix}`;
+		}
+	}
+	if (importer) {
+		try {
+			const importerFile = stripQueryAndHash(importer);
+			const nodeRequire = createRequire(pathToFileURL(importerFile).href);
+			const resolved = nodeRequire.resolve(stripQueryAndHash(specifier));
+			if (resolved && resolved !== stripped) {
+				return `${resolved}${suffix}`;
+			}
+		} catch {}
+	}
+	return resolvedId;
+};
+const isNodeModulesId = (id) => {
+	if (!id) return false;
+	const normalized = stripQueryAndHash(id).replace(/\\/g, "/");
+	return normalized.includes("/node_modules/");
+};
+const mergeOnly = (current, next) => {
+	if (!current || current.length === 0) return next ?? [];
+	if (!next || next.length === 0) return current;
+	if (current.includes("*") || next.includes("*")) {
+		return ["*"];
+	}
+	return Array.from(new Set([...current, ...next]));
+};
+const toCanonicalFileKey = (resolved, root) => {
+	const rootDir = root ? path.resolve(root) : process.cwd();
+	const normalizedResolved = path.resolve(resolved);
+	let relative = path.relative(rootDir, normalizedResolved);
+	if (path.sep !== path.posix.sep) {
+		relative = relative.split(path.sep).join(path.posix.sep);
+	}
+	if (!relative.startsWith(".")) {
+		relative = `./${relative}`;
+	}
+	return relative;
+};
+const toImportKey = ({ source, resolved, root }) => {
+	const isFileImport = source.startsWith(".") || path.isAbsolute(source);
+	if (isFileImport && resolved) {
+		return {
+			key: toCanonicalFileKey(resolved, root),
+			kind: "file"
+		};
+	}
+	return {
+		key: source,
+		kind: "package"
+	};
+};
+const minimatchOptions = {
+	dot: true,
+	nocomment: true,
+	nonegate: true
+};
+const compileImportOverrides = (importOverrides) => {
+	const matchers = Object.entries(importOverrides).map(([pattern, override]) => ({
+		matcher: new Minimatch(pattern, minimatchOptions),
+		override,
+		pattern
+	})).sort((a, b) => b.pattern.length - a.pattern.length);
+	return { matchers };
+};
+const compiledOverridesCache = new WeakMap();
+const getImportOverride = (importOverrides, key) => {
+	if (!importOverrides) return undefined;
+	const direct = importOverrides[key];
+	if (direct) return direct;
+	let compiled = compiledOverridesCache.get(importOverrides);
+	if (!compiled) {
+		compiled = compileImportOverrides(importOverrides);
+		compiledOverridesCache.set(importOverrides, compiled);
+	}
+	return compiled.matchers.find(({ matcher }) => matcher.match(key))?.override;
+};
+const resolveMockSpecifier = ({ mock, importer, root }) => {
+	const specifier = mock.startsWith(".") && root ? path.resolve(root, mock) : mock;
+	const nodeRequire = createRequire(pathToFileURL(importer).href);
+	return nodeRequire.resolve(specifier);
+};
+const state = {
+	context: null,
+	teardown: null,
+	happyDomEnabled: null,
+	globalsSignature: null,
+	evalOptions: {
+		errors: "strict",
+		require: "warn-and-run",
+		globals: {},
+		importOverrides: undefined,
+		root: undefined,
+		extensions: []
+	},
+	features: {},
+	debugEvalFiles: false,
+	entrypoint: "eval-runner"
+};
+const moduleCache = new LruCache(LOAD_CACHE_SIZE);
+const moduleHashes = new Map();
+const moduleData = new Map();
+const moduleOnly = new Map();
+const moduleVariants = new Map();
+const moduleLastVariant = new Map();
+const linkPromises = new Map();
+const loadInFlight = new Map();
+const externalInFlight = new Map();
+const resolveCache = new LruCache(RESOLVE_CACHE_SIZE);
+const resolveInFlight = new Map();
+const pending = new Map();
+const loadResultChunks = new Map();
+// Ids evicted during the in-flight EVAL session via resetSingleModuleState.
+// Surfaced in EVAL_RESULT so the broker can drop matching entries from its
+// "what runner has" mirror (lastSentLoadByModule) — otherwise the broker would
+// keep short-circuiting subsequent LOADs with empty `code` and the runner
+// would have no way to obtain fresh source.
+const evictedThisSession = new Set();
+let nextId = 0;
+const stdoutWriteQueue = [];
+let stdoutWriteInFlight = false;
+let stdoutWriteFailed = null;
+let shutdownRequested = false;
+let shutdownFinished = false;
+// Tracks the SourceTextModule identifier (versioned with hash) that was last
+// included in an EVAL_RESULT for each id. Reused module variants don't need
+// re-serialization across eval sessions — same variant = same namespace =
+// same exports the broker already has cached.
+const sentNamespaceIdentifiers = new Map();
+const resetModuleState = () => {
+	moduleCache.clear();
+	moduleHashes.clear();
+	moduleData.clear();
+	moduleOnly.clear();
+	moduleVariants.clear();
+	moduleLastVariant.clear();
+	linkPromises.clear();
+	loadInFlight.clear();
+	externalInFlight.clear();
+	resolveInFlight.clear();
+	resolveCache.clear();
+	sentNamespaceIdentifiers.clear();
+};
+const resetSingleModuleState = (id, cachedModule = moduleCache.get(id)) => {
+	if (cachedModule) {
+		linkPromises.delete(cachedModule);
+	}
+	const variants = moduleVariants.get(id);
+	if (variants) {
+		variants.forEach((variant) => linkPromises.delete(variant));
+	}
+	moduleCache.delete(id);
+	moduleHashes.delete(id);
+	moduleData.delete(id);
+	moduleVariants.delete(id);
+	moduleLastVariant.delete(id);
+	sentNamespaceIdentifiers.delete(id);
+};
+// Stronger reset for error paths: clears moduleOnly too and records the id so
+// the broker can drop its lastSentLoadByModule entry. Used when a module's
+// SourceTextModule has reached an unrecoverable state (e.g. link errored
+// against a transient missing import) and should not be reused.
+const evictPoisonedModule = (id) => {
+	resetSingleModuleState(id);
+	moduleOnly.delete(id);
+	evictedThisSession.add(id);
+};
+const isFullModuleLoad = (loaded) => !loaded.only || loaded.only.length === 1 && loaded.only[0] === "*";
+const getModuleVariant = (id, hash) => moduleVariants.get(id)?.get(hash);
+const setModuleVariant = (id, hash, module) => {
+	let variants = moduleVariants.get(id);
+	if (!variants) {
+		variants = new Map();
+		moduleVariants.set(id, variants);
+	}
+	variants.set(hash, module);
+	moduleLastVariant.set(id, module);
+	if (variants.size > MODULE_VARIANT_LIMIT) {
+		const oldestHash = variants.keys().next().value;
+		if (oldestHash !== undefined) {
+			const oldest = variants.get(oldestHash);
+			if (oldest) {
+				linkPromises.delete(oldest);
+			}
+			variants.delete(oldestHash);
+		}
+	}
+};
+const toSourceModuleId = (id) => stripQueryAndHash(String(id));
+const toVersionedModuleIdentifier = (id, hash) => {
+	if (!hash) return id;
+	const separator = id.includes("?") ? "&" : "?";
+	return `${id}${separator}wyw-hash=${hash}`;
+};
+const resetEvaluationState = () => {
+	if (state.teardown) {
+		state.teardown();
+	}
+	state.context = null;
+	state.teardown = null;
+	state.happyDomEnabled = null;
+	state.globalsSignature = null;
+	resetModuleState();
+};
+const normalizeWriteError = (label, error) => {
+	if (error instanceof Error) {
+		return error;
+	}
+	return new Error(`[wyw-in-js] Failed to write to ${label}: ${String(error)}`);
+};
+const keepAlive = setInterval(() => {}, 6e4);
+const finishShutdown = (exitCode = 0) => {
+	if (shutdownFinished) {
+		return;
+	}
+	shutdownFinished = true;
+	clearInterval(keepAlive);
+	if (state.teardown) {
+		state.teardown();
+	}
+	process.exit(exitCode);
+};
+const flushStdoutWriteQueue = () => {
+	if (stdoutWriteInFlight || stdoutWriteFailed) {
+		return;
+	}
+	const next = stdoutWriteQueue.shift();
+	if (!next) {
+		if (shutdownRequested) {
+			finishShutdown(0);
+		}
+		return;
+	}
+	stdoutWriteInFlight = true;
+	let settled = false;
+	let writeCompleted = false;
+	let drainCompleted = true;
+	let onClose;
+	let onDrain;
+	let onError;
+	const cleanup = () => {
+		process.stdout.off("close", onClose);
+		process.stdout.off("drain", onDrain);
+		process.stdout.off("error", onError);
+	};
+	const finish = (error) => {
+		if (settled) {
+			return;
+		}
+		if (error) {
+			settled = true;
+			stdoutWriteInFlight = false;
+			cleanup();
+			stdoutWriteFailed = normalizeWriteError("eval runner stdout", error);
+			next.reject(stdoutWriteFailed);
+			while (stdoutWriteQueue.length > 0) {
+				stdoutWriteQueue.shift().reject(stdoutWriteFailed);
+			}
+			process.stderr.write(`[wyw-eval-runner] ${stdoutWriteFailed.message}\n`);
+			finishShutdown(1);
+			return;
+		}
+		if (!writeCompleted || !drainCompleted) {
+			return;
+		}
+		settled = true;
+		stdoutWriteInFlight = false;
+		cleanup();
+		next.resolve();
+		flushStdoutWriteQueue();
+	};
+	onClose = () => {
+		finish(new Error("eval runner stdout closed before pending write completed"));
+	};
+	onDrain = () => {
+		drainCompleted = true;
+		finish();
+	};
+	onError = (error) => {
+		finish(error);
+	};
+	process.stdout.once("close", onClose);
+	process.stdout.once("error", onError);
+	const needsDrain = !process.stdout.write(next.chunk, (error) => {
+		writeCompleted = true;
+		if (error) {
+			finish(error);
+			return;
+		}
+		finish();
+	});
+	if (needsDrain) {
+		drainCompleted = false;
+		process.stdout.once("drain", onDrain);
+	}
+};
+const queueStdoutWrite = (chunk) => new Promise((resolve, reject) => {
+	if (stdoutWriteFailed) {
+		reject(stdoutWriteFailed);
+		return;
+	}
+	stdoutWriteQueue.push({
+		chunk,
+		resolve,
+		reject
+	});
+	flushStdoutWriteQueue();
+});
+const sendMessage = (message) => {
+	queueStdoutWrite(`${JSON.stringify(message)}\n`).catch(() => {});
+};
+const shutdown = () => {
+	shutdownRequested = true;
+	if (!stdoutWriteInFlight && stdoutWriteQueue.length === 0) {
+		finishShutdown(0);
+	}
+};
+const sendWarn = (warning) => {
+	sendMessage({
+		type: "WARN",
+		payload: warning
+	});
+};
+const reviveSerializedError = (error) => {
+	if (error instanceof Error) {
+		return error;
+	}
+	const revived = new Error(error?.message ?? String(error));
+	if (error?.name) {
+		revived.name = error.name;
+	}
+	if (error?.stack) {
+		revived.stack = error.stack;
+	}
+	if (error?.cause) {
+		revived.cause = reviveSerializedError(error.cause);
+	}
+	return revived;
+};
+const serializeError = (error) => {
+	const result = {
+		message: error?.message ?? String(error),
+		stack: error?.stack
+	};
+	if (error?.cause instanceof Error) {
+		result.cause = serializeError(error.cause);
+	}
+	return result;
+};
+const request = (type, payload) => {
+	nextId += 1;
+	const id = `${nextId}`;
+	sendMessage({
+		type,
+		id,
+		payload
+	});
+	return new Promise((resolve, reject) => {
+		pending.set(id, {
+			resolve,
+			reject
+		});
+	});
+};
+const resolvePending = (id, payload) => {
+	const pendingItem = pending.get(id);
+	if (!pendingItem) return;
+	pending.delete(id);
+	pendingItem.resolve(payload);
+};
+const handleLoadResult = (id, payload) => {
+	if (!payload || typeof payload.codeChunk !== "string" || typeof payload.chunkIndex !== "number" || typeof payload.chunkCount !== "number") {
+		resolvePending(id, payload);
+		return;
+	}
+	let entry = loadResultChunks.get(id);
+	if (!entry) {
+		entry = {
+			chunks: new Array(payload.chunkCount),
+			received: 0,
+			meta: null
+		};
+		loadResultChunks.set(id, entry);
+	}
+	if (!entry.chunks[payload.chunkIndex]) {
+		entry.received += 1;
+	}
+	entry.chunks[payload.chunkIndex] = payload.codeChunk;
+	if (payload.chunkIndex === 0) {
+		const { codeChunk, chunkIndex, chunkCount, ...meta } = payload;
+		entry.meta = meta;
+	}
+	if (entry.received >= payload.chunkCount) {
+		const code = entry.chunks.join("");
+		const finalPayload = {
+			...entry.meta ?? {},
+			code
+		};
+		loadResultChunks.delete(id);
+		resolvePending(id, finalPayload);
+	}
+};
+const buildPreamble = (id) => [
+	`const __wyw_module = __wyw_getModule(${JSON.stringify(id)});`,
+	`let exports = __wyw_module.exports;`,
+	`const module = __wyw_module.module;`,
+	`const require = __wyw_module.require;`,
+	`const __filename = __wyw_module.filename;`,
+	`const __dirname = __wyw_module.dirname;`,
+	`const __wyw_dynamic_import = __wyw_module.dynamicImport;`,
+	``
+].join("\n");
+const getImporterPackage = (importer) => {
+	const normalized = importer.replace(/\\/g, "/");
+	const marker = "/node_modules/";
+	const idx = normalized.lastIndexOf(marker);
+	if (idx === -1) return path.basename(importer);
+	const rest = normalized.slice(idx + marker.length);
+	if (rest.startsWith("@")) {
+		const [scope, name] = rest.split("/").slice(0, 2);
+		return `${scope}/${name}`;
+	}
+	return rest.split("/")[0];
+};
+const warnedRequires = new Set();
+const createRequireFn = (importer) => {
+	const importerFile = stripQueryAndHash(importer);
+	const nodeRequire = createRequire(pathToFileURL(importerFile).href);
+	return (specifier, nonLiteralOrResolved, maybeResolved) => {
+		const hasNonLiteralFlag = typeof nonLiteralOrResolved === "boolean";
+		const nonLiteral = hasNonLiteralFlag ? nonLiteralOrResolved : false;
+		const resolvedOverride = hasNonLiteralFlag ? maybeResolved : nonLiteralOrResolved;
+		const hasResolvedOverride = typeof resolvedOverride === "string" && resolvedOverride.length > 0;
+		if (state.evalOptions.require === "off") {
+			throw new Error(`[wyw-in-js] require() fallback is disabled by eval.require: 'off'.`);
+		}
+		if (nonLiteral || typeof specifier !== "string") {
+			if (state.evalOptions.errors === "strict") {
+				throw new Error(`[wyw-in-js] Non-literal require() is not supported during eval.\n` + `importer: ${importerFile}\n` + `hint: make it a string literal or mock the import via importOverrides.`);
+			}
+			sendWarn({
+				code: "require-error",
+				message: "[wyw-in-js] Non-literal require() reached during eval (eval.errors: \"loose\").",
+				importer: importerFile
+			});
+			return {};
+		}
+		if (specifier === REACT_REFRESH_VIRTUAL_ID) {
+			return reactRefreshRuntime;
+		}
+		if (specifier.startsWith(VITE_VIRTUAL_PREFIX) || specifier.startsWith("virtual:")) {
+			return {};
+		}
+		const normalized = specifier.startsWith("node:") ? specifier.slice(5) : specifier;
+		if (NativeModule.builtinModules?.includes(normalized) || NativeModule.builtinModules?.includes(`node:${normalized}`)) {
+			if (normalized in builtins) {
+				if (builtins[normalized]) {
+					return nodeRequire(normalized);
+				}
+				return null;
+			}
+		}
+		const extensions = NativeModule._extensions;
+		const added = [];
+		try {
+			state.evalOptions.extensions?.forEach((ext) => {
+				if (ext === ".cjs" || ext === ".mjs") return;
+				if (ext in extensions) return;
+				extensions[ext] = NOOP;
+				added.push(ext);
+			});
+			let resolved = hasResolvedOverride ? stripQueryAndHash(resolvedOverride) : nodeRequire.resolve(stripQueryAndHash(specifier));
+			const isFileSpecifier = specifier.startsWith(".") || path.isAbsolute(specifier);
+			if (isFileSpecifier && path.extname(specifier) === "" && resolved.endsWith(".cjs")) {
+				const candidate = `${resolved.slice(0, -4)}.js`;
+				if (fs.existsSync(candidate)) {
+					resolved = candidate;
+				}
+			}
+			const keyInfo = toImportKey({
+				source: specifier,
+				resolved,
+				root: state.evalOptions.root
+			});
+			const override = getImportOverride(state.evalOptions.importOverrides, keyInfo.key);
+			let finalResolved = resolved;
+			if (override?.mock) {
+				finalResolved = resolveMockSpecifier({
+					mock: override.mock,
+					importer: importerFile,
+					root: state.evalOptions.root,
+					stack: [importerFile]
+				});
+			}
+			const basePolicy = state.evalOptions.require === "warn-and-run" ? "warn" : "error";
+			let policy = override?.unknown ?? (override ? "allow" : basePolicy);
+			if (state.evalOptions.require === "off" && policy !== "error") {
+				policy = "error";
+			}
+			if (policy === "error") {
+				throw new Error([
+					`[wyw-in-js] require() fallback reached during eval but eval.require='error'.`,
+					``,
+					`importer: ${importerFile}`,
+					`source:   ${specifier}`,
+					`hint: add importOverrides or set eval.require to "warn-and-run".`
+				].join("\n"));
+			}
+			if (policy === "warn") {
+				const key = `${specifier}::${getImporterPackage(importerFile)}`;
+				if (!warnedRequires.has(key)) {
+					warnedRequires.add(key);
+					sendWarn({
+						code: "require-fallback",
+						message: [
+							`[wyw-in-js] Runtime require() fallback during eval`,
+							``,
+							`importer: ${importerFile}`,
+							`source:   ${specifier}`,
+							`resolved: ${resolved}`,
+							override?.mock ? `mock:     ${override.mock} -> ${finalResolved}` : ``,
+							``,
+							`hint: use importOverrides to mock runtime-only deps and avoid eval-time requires.`
+						].filter(Boolean).join("\n"),
+						importer: importerFile,
+						specifier,
+						resolved
+					});
+				}
+			}
+			return nodeRequire(finalResolved);
+		} finally {
+			added.forEach((ext) => delete extensions[ext]);
+		}
+	};
+};
+function createSyntheticModule(id, exportsValue, cache = true) {
+	const exportNames = new Set(Object.keys(exportsValue));
+	if (!exportNames.has("default")) {
+		exportNames.add("default");
+	}
+	const module = new vm.SyntheticModule([...exportNames], function init() {
+		exportNames.forEach((key) => {
+			const value = key === "default" ? exportsValue.default : exportsValue[key];
+			this.setExport(key, value);
+		});
+	}, {
+		context: state.context,
+		identifier: id
+	});
+	if (cache) {
+		moduleCache.set(id, module);
+	}
+	return module;
+}
+const toSyntheticExports = (value) => {
+	if (value && (typeof value === "object" || typeof value === "function")) {
+		const exportsValue = {};
+		Object.keys(value).forEach((key) => {
+			exportsValue[key] = value[key];
+		});
+		exportsValue.default = Object.prototype.hasOwnProperty.call(value, "default") || Object.prototype.hasOwnProperty.call(exportsValue, "default") ? value.default : value;
+		return exportsValue;
+	}
+	return { default: value };
+};
+const loadExternalModule = async (resolvedId, importer, specifier) => {
+	const cacheId = resolvedId ?? specifier;
+	const cached = moduleCache.get(cacheId);
+	if (cached) return cached;
+	const inFlight = externalInFlight.get(cacheId);
+	if (inFlight) return inFlight;
+	const task = (async () => {
+		const start = Date.now();
+		debug("external:start", {
+			specifier,
+			resolvedId,
+			importer
+		});
+		const requireFn = createRequireFn(importer);
+		let value;
+		let hasValue = false;
+		const resolvedFile = resolvedId ? stripQueryAndHash(resolvedId) : null;
+		const importTarget = resolvedFile && path.isAbsolute(resolvedFile) ? pathToFileURL(resolvedFile).href : specifier;
+		if (shouldPreferImport(resolvedFile)) {
+			value = await import(importTarget);
+			hasValue = true;
+		}
+		if (!hasValue) {
+			try {
+				value = requireFn(specifier, resolvedId ?? null);
+				hasValue = true;
+			} catch (error) {
+				if (!isErrRequireEsm(error)) {
+					throw error;
+				}
+				const isFileSpecifier = specifier.startsWith(".") || path.isAbsolute(specifier);
+				const isPackageSpecifier = !isFileSpecifier && !isBuiltinSpecifier(specifier);
+				if (resolvedId && isPackageSpecifier) {
+					try {
+						value = requireFn(specifier, null);
+						hasValue = true;
+					} catch (retryError) {
+						if (!isErrRequireEsm(retryError)) {
+							throw retryError;
+						}
+					}
+				}
+				if (!hasValue) {
+					value = await import(importTarget);
+					hasValue = true;
+				}
+			}
+		}
+		const module = createSyntheticModule(cacheId, toSyntheticExports(value));
+		debug("external:done", {
+			specifier,
+			resolvedId,
+			durationMs: Date.now() - start
+		});
+		return module;
+	})();
+	externalInFlight.set(cacheId, task);
+	try {
+		return await task;
+	} finally {
+		externalInFlight.delete(cacheId);
+	}
+};
+let resolveModule;
+let loadModule;
+const linkModule = async (module) => {
+	const cached = linkPromises.get(module);
+	if (cached) return cached;
+	if (module.status !== "unlinked") return module;
+	const linking = (async () => {
+		try {
+			await module.link((specifier, referencingModule) => resolveModule(specifier, referencingModule.identifier, "import"));
+			return module;
+		} catch (error) {
+			// The vm SourceTextModule is now in 'errored' (or partially-linked)
+			// state and can never be re-linked. With reuseModules:true the cached
+			// module would otherwise stick around and short-circuit linkModule's
+			// status guard above on the next session — surfacing the original
+			// failure forever even after the user fixes the underlying problem.
+			// Drop it so the next LOAD rebuilds a fresh SourceTextModule.
+			const identifier = typeof module.identifier === "string" ? module.identifier : null;
+			if (identifier) {
+				evictPoisonedModule(toSourceModuleId(identifier));
+			}
+			// ERR_VM_MODULE_LINK_FAILURE means a dependency is in "errored" state.
+			// Node chains .cause through the link failure hierarchy. Walk to the
+			// deepest cause to surface the original evaluation error (e.g. a
+			// TypeError in user code), not intermediate "resolved to errored" hops.
+			if (error?.code === "ERR_VM_MODULE_LINK_FAILURE") {
+				let rootCause = error;
+				while (rootCause.cause instanceof Error) {
+					rootCause = rootCause.cause;
+				}
+				if (rootCause !== error) {
+					const enhanced = new Error(`${error.message}\n` + `  Root cause: ${rootCause.name ?? "Error"}: ${rootCause.message}`);
+					enhanced.cause = rootCause;
+					throw enhanced;
+				}
+			}
+			throw error;
+		} finally {
+			linkPromises.delete(module);
+		}
+	})();
+	linkPromises.set(module, linking);
+	return linking;
+};
+resolveModule = async (specifier, importer, kind) => {
+	const importerId = toSourceModuleId(importer);
+	if (process.env.WYW_DEBUG_EVAL_RESOLVE) {
+		process.stderr.write(`[wyw-eval-runner:resolve] ${JSON.stringify({
+			specifier,
+			importer: importerId,
+			kind
+		})}\n`);
+	}
+	if (specifier === REACT_REFRESH_VIRTUAL_ID) {
+		return createSyntheticModule(specifier, reactRefreshRuntime);
+	}
+	if (specifier.startsWith(VITE_VIRTUAL_PREFIX) || specifier.startsWith("virtual:")) {
+		return createSyntheticModule(specifier, { default: {} });
+	}
+	const key = `${kind}:${importerId}:${specifier}`;
+	const cached = resolveCache.get(key);
+	if (cached) {
+		if (!cached.resolvedId) {
+			if (state.evalOptions.errors === "loose") {
+				return createSyntheticModule(specifier, { default: undefined });
+			}
+			throw new Error([
+				`[wyw-in-js] Unable to resolve "${specifier}" during evaluation.`,
+				``,
+				`importer: ${importerId}`,
+				`hint: check eval.resolver/customResolver or add importOverrides for this specifier.`
+			].join("\n"));
+		}
+		const treatExternal = cached.external || isBuiltinSpecifier(specifier) || isNodeModulesId(cached.resolvedId);
+		if (treatExternal) {
+			const normalized = normalizeResolvedId(cached.resolvedId, specifier, importerId, state.evalOptions.extensions);
+			const externalModule = await loadExternalModule(normalized, importerId, specifier);
+			return externalModule;
+		}
+		const normalized = normalizeResolvedId(cached.resolvedId, specifier, importerId, state.evalOptions.extensions);
+		return loadModule(normalized, importerId, specifier);
+	}
+	const inFlight = resolveInFlight.get(key);
+	if (inFlight) return inFlight;
+	const task = (async () => {
+		const resolved = await request("RESOLVE", {
+			specifier,
+			importerId,
+			kind
+		});
+		if (resolved.error) {
+			throw new Error(resolved.error.message);
+		}
+		const normalized = resolved.resolvedId ? normalizeResolvedId(resolved.resolvedId, specifier, importerId, state.evalOptions.extensions) : resolved.resolvedId;
+		if (process.env.WYW_DEBUG_EVAL_RESOLVE) {
+			process.stderr.write(`[wyw-eval-runner:resolved] ${JSON.stringify({
+				specifier,
+				importer: importerId,
+				resolved: resolved.resolvedId ?? null,
+				normalized: normalized ?? null,
+				external: Boolean(resolved.external)
+			})}\n`);
+		}
+		resolveCache.set(key, {
+			resolvedId: normalized,
+			external: Boolean(resolved.external)
+		});
+		if (!normalized) {
+			if (state.evalOptions.errors === "loose") {
+				return createSyntheticModule(specifier, { default: undefined });
+			}
+			throw new Error([
+				`[wyw-in-js] Unable to resolve "${specifier}" during evaluation.`,
+				``,
+				`importer: ${importerId}`,
+				`hint: check eval.resolver/customResolver or add importOverrides for this specifier.`
+			].join("\n"));
+		}
+		const treatExternal = resolved.external || isBuiltinSpecifier(specifier) || isNodeModulesId(normalized);
+		if (treatExternal) {
+			return loadExternalModule(normalized, importerId, specifier);
+		}
+		return loadModule(normalized, importerId, specifier);
+	})();
+	resolveInFlight.set(key, task);
+	try {
+		return await task;
+	} finally {
+		resolveInFlight.delete(key);
+	}
+};
+loadModule = async (id, importer, requestSpec) => {
+	let cached = moduleCache.get(id);
+	const inFlight = loadInFlight.get(id);
+	if (inFlight) {
+		await inFlight;
+		cached = moduleCache.get(id);
+	}
+	const task = (async () => {
+		const loadStart = Date.now();
+		const loaded = await request("LOAD", {
+			id,
+			importerId: importer,
+			request: requestSpec ?? null
+		});
+		debug("load:done", {
+			id,
+			importer,
+			durationMs: Date.now() - loadStart
+		});
+		if (loaded.error) {
+			// Surface the importer + specifier alongside the broker's message.
+			// Without this, ENOENT and similar load failures bubble up as a bare
+			// path (or, after Node's VM wraps them, as the opaque
+			// ERR_VM_MODULE_STATUS) leaving no clue which file's import is broken.
+			const detail = [
+				`[wyw-in-js] Failed to load module during evaluation.`,
+				`  importer: ${importer ?? "(unknown)"}`,
+				`  request:  ${requestSpec ?? id}`,
+				`  resolved: ${id}`,
+				`  cause:    ${loaded.error.message}`
+			].join("\n");
+			// The importer's SourceTextModule (if it was already created and
+			// cached) compiled this `import` against `id`; reusing it next session
+			// would link against the same id and either re-trigger the failure or
+			// skip linking via the status guard. Drop both so the next session
+			// pulls fresh code for both ends of the broken edge.
+			if (importer && importer !== id) {
+				evictPoisonedModule(toSourceModuleId(importer));
+			}
+			evictPoisonedModule(id);
+			const enhanced = new Error(detail);
+			enhanced.cause = reviveSerializedError(loaded.error);
+			throw enhanced;
+		}
+		if (loaded.only) {
+			const current = moduleOnly.get(id) ?? [];
+			moduleOnly.set(id, mergeOnly(current, loaded.only));
+		}
+		if (loaded.exports) {
+			// Serialized exports are a narrow slice — only the keys the importer
+			// requested. If we have a fully evaluated module (in moduleCache or as
+			// a variant), prefer it: its namespace has ALL exports, so any consumer
+			// can link against it without "does not provide export" errors.
+			//
+			// An evaluated variant is only safe to reuse when its namespace covers
+			// the serialized key set. A narrow variant that was evaluated first may
+			// lack exports that a wider consumer needs (the 4df6e915 race).
+			const requiredKeys = Object.keys(loaded.exports);
+			const coversKeys = (mod) => {
+				const ns = mod.namespace;
+				return requiredKeys.every((k) => k in ns);
+			};
+			let evaluated = cached && cached.status === "evaluated" && coversKeys(cached) ? cached : undefined;
+			if (!evaluated) {
+				const variants = moduleVariants.get(id);
+				if (variants) {
+					evaluated = Array.from(variants.values()).find((variant) => variant.status === "evaluated" && coversKeys(variant));
+				}
+			}
+			if (evaluated) {
+				return evaluated;
+			}
+			// Reuse a previously created SyntheticModule for this exact serialized set
+			if (loaded.hash) {
+				const existing = getModuleVariant(id, loaded.hash);
+				if (existing) {
+					return existing;
+				}
+			}
+			const exportsValue = {};
+			Object.entries(loaded.exports).forEach(([key, serialized]) => {
+				exportsValue[key] = deserializeValue(serialized);
+			});
+			const module = createSyntheticModule(id, exportsValue, false);
+			if (loaded.hash) {
+				setModuleVariant(id, loaded.hash, module);
+			}
+			return module;
+		}
+		const usePrimaryCache = isFullModuleLoad(loaded);
+		if (usePrimaryCache) {
+			if (cached && loaded.hash && moduleHashes.get(id) === loaded.hash) {
+				return cached;
+			}
+		} else if (loaded.hash) {
+			const variant = getModuleVariant(id, loaded.hash);
+			if (variant) {
+				return variant;
+			}
+		}
+		// The broker only ships empty `code` when it expects the runner to reuse
+		// a cached module via the hash-match short-circuit above. Reaching this
+		// point with no code means the broker's "what runner has" mirror is out
+		// of sync with our actual moduleCache/moduleVariants — fail loudly rather
+		// than feeding empty source into vm.SourceTextModule.
+		if (loaded.code == null || loaded.code === "") {
+			throw new Error(`[wyw-in-js] LoadResult for ${id} has empty code but no cached module ` + `matched hash ${loaded.hash ?? "(none)"}. ` + `This indicates a broker/runner cache desync.`);
+		}
+		if (usePrimaryCache) {
+			resetSingleModuleState(id, cached);
+		}
+		const module = new vm.SourceTextModule(`${buildPreamble(id)}${loaded.code ?? ""}`, {
+			context: state.context,
+			identifier: toVersionedModuleIdentifier(id, loaded.hash),
+			initializeImportMeta(meta, targetModule) {
+				const identifier = typeof targetModule.identifier === "string" ? targetModule.identifier : id;
+				const fileId = stripQueryAndHash(identifier);
+				// eslint-disable-next-line no-param-reassign
+				meta.url = path.isAbsolute(fileId) ? pathToFileURL(fileId).href : fileId;
+			},
+			importModuleDynamically(specifier, referencingModule) {
+				return resolveModule(specifier, referencingModule.identifier, "dynamic-import");
+			}
+		});
+		if (usePrimaryCache) {
+			moduleCache.set(id, module);
+			if (loaded.hash) {
+				moduleHashes.set(id, loaded.hash);
+			}
+		} else if (loaded.hash) {
+			setModuleVariant(id, loaded.hash, module);
+		}
+		return module;
+	})();
+	loadInFlight.set(id, task);
+	try {
+		return await task;
+	} finally {
+		loadInFlight.delete(id);
+	}
+};
+const createDynamicImportFn = (importer) => {
+	return async (specifier) => {
+		if (typeof specifier !== "string") {
+			sendWarn({
+				code: "eval-error",
+				message: "[wyw-in-js] Dynamic import with non-string specifier during eval.",
+				importer
+			});
+			if (state.evalOptions.errors === "strict") {
+				throw new Error(`[wyw-in-js] Dynamic import with non-string specifier is not supported during eval.\n` + `importer: ${importer}\n` + `hint: make it a string literal or mock the import via importOverrides.`);
+			}
+			return createSyntheticModule(`dynamic:${String(specifier)}`, { default: undefined });
+		}
+		sendWarn({
+			code: "dynamic-import",
+			message: `[wyw-in-js] Dynamic import executed during eval: ${specifier}`,
+			importer,
+			specifier
+		});
+		const resolved = await resolveModule(specifier, importer, "dynamic-import");
+		await linkModule(resolved);
+		await resolved.evaluate();
+		return resolved;
+	};
+};
+const getModuleData = (id) => {
+	const cached = moduleData.get(id);
+	if (cached) return cached;
+	const filename = stripQueryAndHash(id);
+	const exportsValue = {};
+	const moduleObj = { exports: exportsValue };
+	const data = {
+		exports: exportsValue,
+		module: moduleObj,
+		require: createRequireFn(id),
+		filename,
+		dirname: path.dirname(filename),
+		dynamicImport: createDynamicImportFn(id)
+	};
+	moduleData.set(id, data);
+	return data;
+};
+const resolveExportValue = (source, key) => {
+	if (key === "default") {
+		if (source && typeof source === "object" && "default" in source) {
+			return source.default;
+		}
+		return source;
+	}
+	if (source && (typeof source === "object" || typeof source === "function")) {
+		if (key in source) {
+			return source[key];
+		}
+		if (source.default && typeof source.default === "object" && key in source.default) {
+			return source.default[key];
+		}
+	}
+	return undefined;
+};
+const stringifyDebugValue = (value) => {
+	try {
+		const json = JSON.stringify(value);
+		if (json !== undefined) return json;
+	} catch {}
+	try {
+		return String(value);
+	} catch {
+		return Object.prototype.toString.call(value);
+	}
+};
+const serializeDebugReason = (error) => error instanceof Error ? error.message : String(error);
+const collectModuleExports = () => {
+	const exportsByModule = {};
+	const debugEvalFiles = state.debugEvalFiles ? {} : undefined;
+	moduleOnly.forEach((only, id) => {
+		if (!only || only.length === 0) return;
+		const module = moduleCache.get(id) ?? moduleLastVariant.get(id);
+		const data = moduleData.get(id);
+		if (!module || !data) return;
+		// The broker already has the serialized exports for this exact variant
+		// from a prior eval session. Re-serializing here just wastes CPU on the
+		// runner side and bloats the EVAL_RESULT payload. Same variant identifier
+		// ⇒ same namespace ⇒ no change to send.
+		const moduleIdentifier = typeof module.identifier === "string" ? module.identifier : id;
+		if (sentNamespaceIdentifiers.get(id) === moduleIdentifier) {
+			return;
+		}
+		// .namespace is only safe on fully evaluated modules. Modules that
+		// errored or were never evaluated (stale from a prior failed session
+		// with reuseModules) have TDZ bindings that crash Object.keys().
+		if (module.status !== "evaluated") {
+			sendWarn({
+				code: "eval-stale-module",
+				message: `[wyw-in-js] Skipping export collection for ${id}: ` + `module status is "${module.status}" (expected "evaluated"). ` + `Cached exports for this module may be stale.`
+			});
+			return;
+		}
+		const { namespace } = module;
+		const hasNamespace = namespace && typeof namespace === "object" && Object.keys(namespace).length;
+		const source = hasNamespace ? namespace : data.module.exports;
+		const discoveredKeys = Object.keys(source ?? {}).filter((key) => key !== "__wywPreval" && key !== "side-effect" && key !== "*");
+		const requestedKeys = only.filter((key) => key !== "__wywPreval" && key !== "side-effect" && key !== "*");
+		const keys = Array.from(new Set([...requestedKeys, ...discoveredKeys]));
+		if (keys.length === 0) return;
+		const serialized = {};
+		const debugExports = state.debugEvalFiles ? {} : undefined;
+		keys.forEach((key) => {
+			const value = resolveExportValue(source, key);
+			try {
+				serialized[key] = serializeValue(value, {
+					rootLabel: "module exports",
+					path: [id, key]
+				});
+				if (debugExports) {
+					debugExports[key] = {
+						serialized: serialized[key],
+						status: "serialized"
+					};
+				}
+			} catch (error) {
+				if (debugExports) {
+					debugExports[key] = {
+						reason: serializeDebugReason(error),
+						status: "stringified",
+						stringified: stringifyDebugValue(value)
+					};
+				}
+			}
+		});
+		if (debugEvalFiles && debugExports && Object.keys(debugExports).length) {
+			debugEvalFiles[id] = { exports: debugExports };
+		}
+		if (Object.keys(serialized).length) {
+			exportsByModule[id] = serialized;
+			sentNamespaceIdentifiers.set(id, moduleIdentifier);
+		}
+	});
+	return {
+		debugEvalFiles,
+		modules: exportsByModule
+	};
+};
+async function evaluateEntrypoint(id) {
+	const evalStart = Date.now();
+	debug("eval:start", id);
+	const module = await loadModule(id, id, id);
+	debug("eval:loaded", {
+		id,
+		durationMs: Date.now() - evalStart
+	});
+	await linkModule(module);
+	debug("eval:linked", {
+		id,
+		durationMs: Date.now() - evalStart
+	});
+	await module.evaluate();
+	debug("eval:evaluated", {
+		id,
+		durationMs: Date.now() - evalStart
+	});
+	const data = getModuleData(id);
+	const exportsValue = data.module.exports;
+	const hasPrevalExport = exportsValue && typeof exportsValue === "object" && "__wywPreval" in exportsValue;
+	const { namespace } = module;
+	const hasPrevalNamespace = namespace && typeof namespace === "object" && "__wywPreval" in namespace;
+	const { debugEvalFiles, modules } = collectModuleExports();
+	if (!hasPrevalExport && !hasPrevalNamespace) {
+		return {
+			debugEvalFiles,
+			values: null,
+			modules
+		};
+	}
+	const preval = hasPrevalExport ? exportsValue.__wywPreval : namespace.__wywPreval;
+	if (!preval || typeof preval !== "object") {
+		return {
+			debugEvalFiles,
+			values: null,
+			modules
+		};
+	}
+	const values = {};
+	const debugPreval = state.debugEvalFiles ? {} : undefined;
+	Object.entries(preval).forEach(([key, lazy]) => {
+		let value;
+		try {
+			value = typeof lazy === "function" ? lazy() : lazy;
+		} catch (error) {
+			value = error;
+		}
+		values[key] = serializeValue(value, {
+			allowFunctions: true,
+			allowSymbols: true,
+			rootLabel: "__wywPreval",
+			path: [key]
+		});
+		if (debugPreval) {
+			debugPreval[key] = {
+				serialized: values[key],
+				status: "serialized"
+			};
+		}
+	});
+	if (debugEvalFiles && debugPreval && Object.keys(debugPreval).length) {
+		debugEvalFiles[id] = {
+			...debugEvalFiles[id] ?? {},
+			preval: debugPreval
+		};
+	}
+	return {
+		debugEvalFiles,
+		values,
+		modules
+	};
+}
+const handleMessage = async (message) => {
+	switch (message.type) {
+		case "INIT": {
+			try {
+				const initStart = Date.now();
+				debug("init:start", message.payload.entrypoint ?? "eval-runner");
+				const encodedGlobals = message.payload.evalOptions.globals ?? {};
+				const nextGlobalsSignature = JSON.stringify(canonicalizeForSignature(encodedGlobals));
+				const nextFeatures = message.payload.features ?? {};
+				const nextDebugEvalFiles = Boolean(message.payload.debugEvalFiles);
+				const nextEntrypoint = message.payload.entrypoint ?? "eval-runner";
+				const nextHappyDomEnabled = isFeatureEnabled(nextFeatures, "happyDOM", nextEntrypoint);
+				const globalsChanged = state.globalsSignature !== null && state.globalsSignature !== nextGlobalsSignature;
+				const nextGlobals = !globalsChanged && state.globalsSignature !== null ? state.evalOptions.globals : decodeGlobals(encodedGlobals);
+				const nextEvalOptions = {
+					...state.evalOptions,
+					...message.payload.evalOptions,
+					globals: nextGlobals
+				};
+				const canReuseContext = state.context && state.happyDomEnabled === nextHappyDomEnabled && !globalsChanged;
+				const reuseModules = Boolean(message.payload.reuseModules);
+				if (canReuseContext) {
+					const modulesReset = !reuseModules;
+					if (modulesReset) {
+						resetModuleState();
+					} else {
+						// Clear resolution caches between sessions even when reusing modules.
+						// The broker rebuilds onlyByModule from scratch each session (cleared
+						// in evaluate()). If the runner's resolveCache persists, RESOLVE
+						// requests for previously-seen (importer, specifier) pairs are
+						// skipped, preventing the broker from learning what exports are
+						// needed. This can cause a barrel module to be served with a stale
+						// `only` set that's missing exports a consumer actually imports,
+						// leading to "does not provide an export named 'X'" link errors.
+						resolveCache.clear();
+						resolveInFlight.clear();
+						loadInFlight.clear();
+					}
+					state.evalOptions = nextEvalOptions;
+					state.features = nextFeatures;
+					state.debugEvalFiles = nextDebugEvalFiles;
+					state.entrypoint = nextEntrypoint;
+					Object.assign(state.context, {
+						__dirname: path.dirname(nextEntrypoint),
+						__filename: nextEntrypoint,
+						...nextEvalOptions.globals,
+						__wyw_getModule: (moduleId) => getModuleData(moduleId)
+					});
+					state.globalsSignature = nextGlobalsSignature;
+					debug("init:reuse", Date.now() - initStart);
+					sendMessage({
+						type: "INIT_ACK",
+						id: message.id,
+						modulesReset
+					});
+					break;
+				}
+				resetEvaluationState();
+				state.evalOptions = nextEvalOptions;
+				state.features = nextFeatures;
+				state.debugEvalFiles = nextDebugEvalFiles;
+				state.entrypoint = nextEntrypoint;
+				debug("init:globals", Date.now() - initStart);
+				const windowStart = Date.now();
+				const { context, teardown } = await createVmContext(state.entrypoint, state.features, {
+					...state.evalOptions.globals,
+					__wyw_getModule: (moduleId) => getModuleData(moduleId)
+				});
+				debug("init:context", Date.now() - windowStart);
+				state.context = context;
+				state.teardown = teardown;
+				state.happyDomEnabled = nextHappyDomEnabled;
+				state.globalsSignature = nextGlobalsSignature;
+				// Full context rebuild ⇒ moduleCache was cleared by resetEvaluationState.
+				sendMessage({
+					type: "INIT_ACK",
+					id: message.id,
+					modulesReset: true
+				});
+				debug("init:done", Date.now() - initStart);
+			} catch (error) {
+				sendMessage({
+					type: "INIT_ACK",
+					id: message.id,
+					error: serializeError(error)
+				});
+			}
+			break;
+		}
+		case "EVAL": {
+			evictedThisSession.clear();
+			try {
+				const { debugEvalFiles, values, modules } = await evaluateEntrypoint(message.payload.id);
+				sendMessage({
+					type: "EVAL_RESULT",
+					id: message.id,
+					payload: {
+						...debugEvalFiles ? { debugEvalFiles } : {},
+						values,
+						modules,
+						evictedIds: Array.from(evictedThisSession)
+					}
+				});
+			} catch (error) {
+				sendMessage({
+					type: "EVAL_RESULT",
+					id: message.id,
+					payload: {
+						values: null,
+						evictedIds: Array.from(evictedThisSession)
+					},
+					error: serializeError(error)
+				});
+			}
+			break;
+		}
+		case "RESOLVE_RESULT": {
+			resolvePending(message.id, message.payload);
+			break;
+		}
+		case "LOAD_RESULT": {
+			handleLoadResult(message.id, message.payload);
+			break;
+		}
+		default: break;
+	}
+};
+let buffer = "";
+process.stdin.setEncoding("utf8");
+process.stdin.resume();
+process.stdin.on("data", (chunk) => {
+	buffer += chunk;
+	const lines = buffer.split("\n");
+	buffer = lines.pop() ?? "";
+	lines.forEach((line) => {
+		if (!line.trim()) return;
+		const message = JSON.parse(line);
+		handleMessage(message);
+	});
+});
+process.stdin.on("close", shutdown);
+//# sourceMappingURL=runner.js.map