@jesscss/plugin-js 2.0.0-alpha.6 → 2.0.0-alpha.8

package/lib/index.js

@@ -1,9 +1,102 @@
-import { AbstractPlugin } from "@jesscss/core";
+import { AbstractPlugin, Any, Color, ColorFormat, Declaration, Dimension, List, Quoted, Rules, Sequence } from "@jesscss/core";
 import * as fs from "node:fs";
 import * as net from "node:net";
 import * as path from "node:path";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { spawn, spawnSync } from "node:child_process";
+//#region src/bridge.ts
+const isBridgeValue = (value) => typeof value === "object" && value !== null && value.__jessBridge === true && typeof value.kind === "string";
+const colorFormatFromString = (value) => {
+	if (!value) return;
+	if (value in ColorFormat) return ColorFormat[value];
+	if (Object.values(ColorFormat).includes(value)) return value;
+};
+function encodeBridgeChildValue(value) {
+	const encoded = encodeBridgeValue(value);
+	if (isBridgeValue(encoded)) return encoded;
+	return {
+		__jessBridge: true,
+		kind: "scalar",
+		value: typeof encoded === "string" || typeof encoded === "number" || typeof encoded === "boolean" ? encoded : String(encoded)
+	};
+}
+function encodeBridgeValue(value) {
+	if (value instanceof Dimension) return {
+		__jessBridge: true,
+		kind: "dimension",
+		value: value.number,
+		unit: value.unit
+	};
+	if (value instanceof Color) return {
+		__jessBridge: true,
+		kind: "color",
+		rgb: value.rgb,
+		alpha: value.alpha,
+		format: value.options.format === void 0 ? void 0 : ColorFormat[value.options.format]
+	};
+	if (value instanceof Quoted) return {
+		__jessBridge: true,
+		kind: "quoted",
+		value: String(value.value),
+		quote: value.quote,
+		escaped: value.escaped
+	};
+	if (value instanceof Any) return {
+		__jessBridge: true,
+		kind: value.role === "keyword" ? "keyword" : "anonymous",
+		value: value.value
+	};
+	if (value instanceof List) return {
+		__jessBridge: true,
+		kind: "list",
+		items: value.value.map(encodeBridgeChildValue),
+		separator: value.options.sep
+	};
+	if (value instanceof Sequence) return {
+		__jessBridge: true,
+		kind: "sequence",
+		items: value.value.map(encodeBridgeChildValue)
+	};
+	if (value instanceof Rules) {
+		const rules = [];
+		for (const rule of value.rules ?? []) if (rule instanceof Declaration && typeof rule.name === "string") rules.push({
+			name: rule.name,
+			value: encodeBridgeChildValue(rule.value)
+		});
+		return {
+			__jessBridge: true,
+			kind: "detached",
+			rules
+		};
+	}
+	return value;
+}
+function decodeBridgeValue(value) {
+	if (!isBridgeValue(value)) return value;
+	switch (value.kind) {
+		case "scalar": return new Any(String(value.value));
+		case "dimension": return new Dimension({
+			number: value.value,
+			unit: value.unit
+		});
+		case "color": return new Color({
+			rgb: value.rgb,
+			alpha: value.alpha
+		}, { format: colorFormatFromString(value.format) });
+		case "quoted": return new Quoted(value.value, {
+			quote: value.quote,
+			escaped: value.escaped
+		});
+		case "keyword": return new Any(value.value, { role: "keyword" });
+		case "anonymous": return new Any(value.value);
+		case "list": return new List(value.items.map((item) => decodeBridgeValue(item)), { sep: value.separator });
+		case "sequence": return new Sequence(value.items.map((item) => decodeBridgeValue(item)));
+	}
+}
+function encodeBridgeArgs(args) {
+	return args.map(encodeBridgeValue);
+}
+//#endregion
 //#region src/index.ts
 const SCRIPT_EXTENSIONS = new Set([
 	".js",
@@ -22,6 +115,33 @@ const RUNTIME_MISSING_MESSAGE = [
 const BOOT_TIMEOUT_MS = 8e3;
 const REQUEST_TIMEOUT_MS = 1e4;
 const IDLE_SHUTDOWN_MS = 5e3;
+/**
+* Environment variables that inject a Node.js debugger/inspector bootloader
+* into child processes (VS Code / Cursor "Auto Attach", `node --inspect`, etc.).
+*
+* These must never leak into the sandboxed Deno worker: the injected bootloader
+* tries to read the environment, the Jess Deno sandbox denies `env` permission,
+* and the worker never signals ready — producing a spurious
+* "Timed out waiting for Deno worker startup" failure. Deno does not use any of
+* these vars, so stripping them is safe.
+*/
+const DEBUG_ENV_KEY_RE = /^(NODE_OPTIONS|NODE_INSPECT|VSCODE_INSPECTOR_OPTIONS)/i;
+const DEBUG_ENV_VALUE_RE = /js-debug|bootloader/i;
+/**
+* Returns a copy of `env` with Node debugger/inspector-attach variables removed,
+* so a spawned Deno subprocess starts regardless of the parent's debug env.
+* The Deno permission sandbox is untouched; this only stops leaking the debugger
+* into it.
+*/
+const sanitizeSpawnEnv = (env = process.env) => {
+	const clean = {};
+	for (const [key, value] of Object.entries(env)) {
+		if (DEBUG_ENV_KEY_RE.test(key)) continue;
+		if (typeof value === "string" && DEBUG_ENV_VALUE_RE.test(value)) continue;
+		clean[key] = value;
+	}
+	return clean;
+};
 const isPathInside = (candidatePath, rootPath) => {
 	const rel = path.relative(rootPath, candidatePath);
 	return rel === "" || !rel.startsWith("..") && !path.isAbsolute(rel);
@@ -61,6 +181,7 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 	name = "js";
 	supportedExtensions = Array.from(SCRIPT_EXTENSIONS);
 	runtimeState = { status: "idle" };
+	shuttingDown = false;
 	brokerServer;
 	brokerSocketPath;
 	worker;
@@ -104,7 +225,10 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 		this.idleTimer.unref?.();
 	}
 	ensureRuntimeAvailable() {
-		if (spawnSync(this.opts.denoCommand ?? "deno", ["--version"], { stdio: "ignore" }).status !== 0) throw new Error(RUNTIME_MISSING_MESSAGE);
+		if (spawnSync(this.opts.denoCommand ?? "deno", ["--version"], {
+			stdio: "ignore",
+			env: sanitizeSpawnEnv(process.env)
+		}).status !== 0) throw new Error(RUNTIME_MISSING_MESSAGE);
 	}
 	ensureRuntime() {
 		if (this.runtimeState.status === "ready") {
@@ -113,6 +237,7 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 		}
 		if (this.runtimeState.status === "initializing") return this.runtimeState.promise;
 		if (this.runtimeState.status === "failed") return Promise.reject(this.runtimeState.error);
+		if (this.runtimeState.status === "disposed") return Promise.reject(/* @__PURE__ */ new Error("Deno worker has been disposed."));
 		const promise = this.startRuntime().then(() => {
 			this.runtimeState = { status: "ready" };
 			this.scheduleIdleShutdown();
@@ -177,6 +302,7 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 		const socketPath = this.createBrokerPath();
 		if (process.platform !== "win32" && fs.existsSync(socketPath)) fs.unlinkSync(socketPath);
 		const server = net.createServer((socket) => {
+			socket.unref();
 			let buf = "";
 			socket.setEncoding("utf8");
 			socket.on("data", (chunk) => {
@@ -207,6 +333,7 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 			server.once("error", reject);
 			server.listen(socketPath, () => resolve());
 		});
+		server.unref();
 		this.brokerServer = server;
 		this.brokerSocketPath = socketPath;
 		return socketPath;
@@ -219,7 +346,8 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 		const child = spawn(denoCommand, [
 			"run",
 			"--no-prompt",
-			fs.existsSync(compiledWorkerPath) ? compiledWorkerPath : sourceWorkerPath
+			fs.existsSync(compiledWorkerPath) ? compiledWorkerPath : sourceWorkerPath,
+			`--runtime-api=${this.opts.runtimeApi ?? "module"}`
 		], {
 			stdio: [
 				"pipe",
@@ -227,15 +355,24 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 				"pipe"
 			],
 			env: {
-				...process.env,
+				...sanitizeSpawnEnv(process.env),
 				DENO_PERMISSION_BROKER_PATH: socketPath
 			}
 		});
 		this.worker = child;
+		child.unref();
+		child.stdin.unref?.();
+		child.stdout.unref?.();
+		child.stderr.unref?.();
 		child.stdout.setEncoding("utf8");
 		child.stderr.setEncoding("utf8");
 		child.stdout.on("data", (chunk) => this.onWorkerStdout(chunk));
 		child.on("exit", () => {
+			this.worker = void 0;
+			if (this.shuttingDown) {
+				this.shuttingDown = false;
+				return;
+			}
 			const err = /* @__PURE__ */ new Error("Deno worker exited unexpectedly.");
 			this.rejectAllPending(err);
 			if (this.runtimeState.status !== "failed") this.runtimeState = {
@@ -244,9 +381,13 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 			};
 		});
 		return new Promise((resolve, reject) => {
+			let stderrText = "";
 			const timer = setTimeout(() => {
-				reject(/* @__PURE__ */ new Error("Timed out waiting for Deno worker startup."));
+				reject(/* @__PURE__ */ new Error(stderrText.trim() ? `Timed out waiting for Deno worker startup.\n${stderrText.trim()}` : "Timed out waiting for Deno worker startup."));
 			}, BOOT_TIMEOUT_MS);
+			const onStderr = (chunk) => {
+				stderrText += chunk;
+			};
 			const onData = (chunk) => {
 				this.workerBuffer += chunk;
 				let idx = this.workerBuffer.indexOf("\n");
@@ -259,6 +400,7 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 						if (JSON.parse(line).type === "ready") {
 							clearTimeout(timer);
 							child.stdout.off("data", onData);
+							child.stderr.off("data", onStderr);
 							resolve();
 							return;
 						}
@@ -266,9 +408,11 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 				}
 			};
 			child.stdout.on("data", onData);
+			child.stderr.on("data", onStderr);
 			child.once("error", (err) => {
 				clearTimeout(timer);
 				child.stdout.off("data", onData);
+				child.stderr.off("data", onStderr);
 				reject(err);
 			});
 		});
@@ -337,7 +481,13 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 	}
 	shutdown() {
 		this.clearIdleTimer();
-		if (this.worker && !this.worker.killed) this.worker.kill();
+		if (this.worker && !this.worker.killed) {
+			this.shuttingDown = true;
+			this.worker.stdin.destroy();
+			this.worker.stdout.destroy();
+			this.worker.stderr.destroy();
+			this.worker.kill();
+		}
 		this.worker = void 0;
 		if (this.brokerServer) {
 			this.brokerServer.close();
@@ -350,7 +500,8 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 	}
 	dispose() {
 		this.shutdown();
-		this.runtimeState = { status: "idle" };
+		JsPlugin.liveInstances.delete(this);
+		this.runtimeState = { status: "disposed" };
 	}
 	assertAllowedPath(absoluteFilePath) {
 		const resolvedPath = path.resolve(absoluteFilePath);
@@ -379,10 +530,10 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 					type: "invoke",
 					modulePath,
 					exportName: item.name,
-					args
+					args: encodeBridgeArgs(args)
 				});
 				if (!invokeResult.ok) throw new Error(invokeResult.error);
-				return invokeResult.value;
+				return decodeBridgeValue(invokeResult.value);
 			};
 			else moduleObject[item.name] = item.value;
 			return moduleObject;
@@ -392,6 +543,36 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 		for (const [key, value] of Object.entries(module)) if (typeof value === "function" || isJsonValue(value)) safeModule[key] = value;
 		return safeModule;
 	}
+	/**
+	* Loads a legacy Less `@plugin` wrapper file in Deno Less-compat mode.
+	*
+	* @deprecated Less `@plugin` is deprecated. Prefer `@-from` for
+	* ESM-style script imports or `@-use` for Sass-module-style namespace imports.
+	*/
+	async importLessPlugin(absoluteFilePath) {
+		const ext = path.extname(absoluteFilePath);
+		if (!SCRIPT_EXTENSIONS.has(ext)) throw new Error(`Plugin "${this.name}" cannot import Less plugin "${absoluteFilePath}"`);
+		this.assertAllowedPath(absoluteFilePath);
+		await this.ensureRuntime();
+		const modulePath = path.resolve(absoluteFilePath);
+		const loadResult = await this.callWorker({
+			type: "loadLessPlugin",
+			modulePath
+		});
+		if (!loadResult.ok) throw new Error(loadResult.error);
+		const functions = {};
+		for (const functionName of loadResult.functions ?? []) functions[functionName] = async (...args) => {
+			const invokeResult = await this.callWorker({
+				type: "invokeLessPluginFunction",
+				modulePath,
+				functionName,
+				args: encodeBridgeArgs(args)
+			});
+			if (!invokeResult.ok) throw new Error(invokeResult.error);
+			return decodeBridgeValue(invokeResult.value);
+		};
+		return { functions };
+	}
 };
 /**
 * Global flag set when @jesscss/plugin-js is loaded.
@@ -403,4 +584,4 @@ const jsPlugin = ((opts) => {
 	return new JsPlugin(opts);
 });
 //#endregion
-export { JESS_PLUGIN_JS_GLOBAL, JsPlugin, jsPlugin as default };
+export { JESS_PLUGIN_JS_GLOBAL, JsPlugin, jsPlugin as default, sanitizeSpawnEnv };