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

package/lib/bridge.d.ts

@@ -0,0 +1,51 @@
+export type JsBridgeDeclaration = {
+    name: string;
+    value: JsBridgeValue;
+};
+export type JsBridgeValue = {
+    __jessBridge: true;
+    kind: 'scalar';
+    value: string | number | boolean;
+} | {
+    __jessBridge: true;
+    kind: 'dimension';
+    value: number;
+    unit?: string;
+} | {
+    __jessBridge: true;
+    kind: 'color';
+    rgb: [number, number, number];
+    alpha?: number;
+    format?: string;
+} | {
+    __jessBridge: true;
+    kind: 'quoted';
+    value: string;
+    quote?: '"' | '\'';
+    escaped?: boolean;
+} | {
+    __jessBridge: true;
+    kind: 'keyword';
+    value: string;
+} | {
+    __jessBridge: true;
+    kind: 'anonymous';
+    value: string;
+} | {
+    __jessBridge: true;
+    kind: 'list';
+    items: JsBridgeValue[];
+    separator?: ',' | ';' | '/';
+} | {
+    __jessBridge: true;
+    kind: 'sequence';
+    items: JsBridgeValue[];
+} | {
+    __jessBridge: true;
+    kind: 'detached';
+    rules: JsBridgeDeclaration[];
+};
+export declare function encodeBridgeValue(value: unknown): unknown;
+export declare function decodeBridgeValue(value: unknown): unknown;
+export declare function encodeBridgeArgs(args: unknown[]): unknown[];
+//# sourceMappingURL=bridge.d.ts.map

package/lib/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAEzE,MAAM,MAAM,aAAa,GACrB;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,GACxE;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACrG;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,GAAG,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAC5F;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACtD;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxD;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAC;IAAC,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;CAAE,GACzF;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,GAChE;IAAE,YAAY,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAAC;AAqC3E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAmEzD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CA+BzD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAE3D"}

package/lib/index.cjs

@@ -33,6 +33,99 @@ let node_path = require("node:path");
 node_path = __toESM(node_path);
 let node_url = require("node:url");
 let node_child_process = require("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 _jesscss_core.ColorFormat) return _jesscss_core.ColorFormat[value];
+	if (Object.values(_jesscss_core.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 _jesscss_core.Dimension) return {
+		__jessBridge: true,
+		kind: "dimension",
+		value: value.number,
+		unit: value.unit
+	};
+	if (value instanceof _jesscss_core.Color) return {
+		__jessBridge: true,
+		kind: "color",
+		rgb: value.rgb,
+		alpha: value.alpha,
+		format: value.options.format === void 0 ? void 0 : _jesscss_core.ColorFormat[value.options.format]
+	};
+	if (value instanceof _jesscss_core.Quoted) return {
+		__jessBridge: true,
+		kind: "quoted",
+		value: String(value.value),
+		quote: value.quote,
+		escaped: value.escaped
+	};
+	if (value instanceof _jesscss_core.Any) return {
+		__jessBridge: true,
+		kind: value.role === "keyword" ? "keyword" : "anonymous",
+		value: value.value
+	};
+	if (value instanceof _jesscss_core.List) return {
+		__jessBridge: true,
+		kind: "list",
+		items: value.value.map(encodeBridgeChildValue),
+		separator: value.options.sep
+	};
+	if (value instanceof _jesscss_core.Sequence) return {
+		__jessBridge: true,
+		kind: "sequence",
+		items: value.value.map(encodeBridgeChildValue)
+	};
+	if (value instanceof _jesscss_core.Rules) {
+		const rules = [];
+		for (const rule of value.rules ?? []) if (rule instanceof _jesscss_core.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 _jesscss_core.Any(String(value.value));
+		case "dimension": return new _jesscss_core.Dimension({
+			number: value.value,
+			unit: value.unit
+		});
+		case "color": return new _jesscss_core.Color({
+			rgb: value.rgb,
+			alpha: value.alpha
+		}, { format: colorFormatFromString(value.format) });
+		case "quoted": return new _jesscss_core.Quoted(value.value, {
+			quote: value.quote,
+			escaped: value.escaped
+		});
+		case "keyword": return new _jesscss_core.Any(value.value, { role: "keyword" });
+		case "anonymous": return new _jesscss_core.Any(value.value);
+		case "list": return new _jesscss_core.List(value.items.map((item) => decodeBridgeValue(item)), { sep: value.separator });
+		case "sequence": return new _jesscss_core.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",
@@ -90,6 +183,7 @@ var JsPlugin = class JsPlugin extends _jesscss_core.AbstractPlugin {
 	name = "js";
 	supportedExtensions = Array.from(SCRIPT_EXTENSIONS);
 	runtimeState = { status: "idle" };
+	shuttingDown = false;
 	brokerServer;
 	brokerSocketPath;
 	worker;
@@ -142,6 +236,7 @@ var JsPlugin = class JsPlugin extends _jesscss_core.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();
@@ -206,6 +301,7 @@ var JsPlugin = class JsPlugin extends _jesscss_core.AbstractPlugin {
 		const socketPath = this.createBrokerPath();
 		if (process.platform !== "win32" && node_fs.existsSync(socketPath)) node_fs.unlinkSync(socketPath);
 		const server = node_net.createServer((socket) => {
+			socket.unref();
 			let buf = "";
 			socket.setEncoding("utf8");
 			socket.on("data", (chunk) => {
@@ -236,6 +332,7 @@ var JsPlugin = class JsPlugin extends _jesscss_core.AbstractPlugin {
 			server.once("error", reject);
 			server.listen(socketPath, () => resolve());
 		});
+		server.unref();
 		this.brokerServer = server;
 		this.brokerSocketPath = socketPath;
 		return socketPath;
@@ -248,7 +345,8 @@ var JsPlugin = class JsPlugin extends _jesscss_core.AbstractPlugin {
 		const child = (0, node_child_process.spawn)(denoCommand, [
 			"run",
 			"--no-prompt",
-			node_fs.existsSync(compiledWorkerPath) ? compiledWorkerPath : sourceWorkerPath
+			node_fs.existsSync(compiledWorkerPath) ? compiledWorkerPath : sourceWorkerPath,
+			`--runtime-api=${this.opts.runtimeApi ?? "module"}`
 		], {
 			stdio: [
 				"pipe",
@@ -261,10 +359,19 @@ var JsPlugin = class JsPlugin extends _jesscss_core.AbstractPlugin {
 			}
 		});
 		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 = {
@@ -273,9 +380,13 @@ var JsPlugin = class JsPlugin extends _jesscss_core.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");
@@ -288,6 +399,7 @@ var JsPlugin = class JsPlugin extends _jesscss_core.AbstractPlugin {
 						if (JSON.parse(line).type === "ready") {
 							clearTimeout(timer);
 							child.stdout.off("data", onData);
+							child.stderr.off("data", onStderr);
 							resolve();
 							return;
 						}
@@ -295,9 +407,11 @@ var JsPlugin = class JsPlugin extends _jesscss_core.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);
 			});
 		});
@@ -366,7 +480,13 @@ var JsPlugin = class JsPlugin extends _jesscss_core.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();
@@ -379,7 +499,8 @@ var JsPlugin = class JsPlugin extends _jesscss_core.AbstractPlugin {
 	}
 	dispose() {
 		this.shutdown();
-		this.runtimeState = { status: "idle" };
+		JsPlugin.liveInstances.delete(this);
+		this.runtimeState = { status: "disposed" };
 	}
 	assertAllowedPath(absoluteFilePath) {
 		const resolvedPath = node_path.resolve(absoluteFilePath);
@@ -408,10 +529,10 @@ var JsPlugin = class JsPlugin extends _jesscss_core.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;
@@ -421,6 +542,36 @@ var JsPlugin = class JsPlugin extends _jesscss_core.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 = node_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 = node_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.
@@ -434,4 +585,5 @@ const jsPlugin = ((opts) => {
 //#endregion
 exports.JESS_PLUGIN_JS_GLOBAL = JESS_PLUGIN_JS_GLOBAL;
 exports.JsPlugin = JsPlugin;
+exports.__toESM = __toESM;
 exports.default = jsPlugin;

package/lib/index.d.ts

@@ -6,6 +6,13 @@ export type JavaScriptSandboxConfig = {
 };
 export interface JsPluginOptions extends JavaScriptSandboxConfig {
     denoCommand?: string;
+    /**
+     * Runtime API exposed inside the Deno worker.
+     *
+     * Jess `@-use`/script imports run as plain ESM modules. Legacy Less
+     * `@plugin` loading can opt into the Less-compatible global shape.
+     */
+    runtimeApi?: 'module' | 'less';
 }
 export declare class JsPlugin extends AbstractPlugin {
     opts: JsPluginOptions;
@@ -14,6 +21,7 @@ export declare class JsPlugin extends AbstractPlugin {
     name: string;
     supportedExtensions: string[];
     private runtimeState;
+    private shuttingDown;
     private brokerServer;
     private brokerSocketPath;
     private worker;
@@ -42,6 +50,15 @@ export declare class JsPlugin extends AbstractPlugin {
     dispose(): void;
     private assertAllowedPath;
     import(absoluteFilePath: string): Promise<Record<string, any>>;
+    /**
+     * 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.
+     */
+    importLessPlugin(absoluteFilePath: string): Promise<{
+        functions: Record<string, (...args: unknown[]) => Promise<unknown>>;
+    }>;
 }
 /**
  * Global flag set when @jesscss/plugin-js is loaded.

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACf,MAAM,eAAe,CAAC;AAOvB,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,eAAgB,SAAQ,uBAAuB;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqGD,qBAAa,QAAS,SAAQ,cAAc;IAmBvB,IAAI,EAAE,eAAe;IAlBxC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAS;IACzC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAuB;IACnD,IAAI,SAAQ;IACZ,mBAAmB,WAAiC;IACpD,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAIV;IAEL,OAAO,CAAC,SAAS,CAA6B;gBAE3B,IAAI,GAAE,eAAoB;IAM7C,OAAO;IAIP,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAkBrC,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,mBAAmB;YA0Bb,WAAW;IA4CzB,OAAO,CAAC,WAAW;YAmEL,YAAY;IAW1B,OAAO,CAAC,cAAc;IAiCtB,OAAO,CAAC,gBAAgB;YAQV,UAAU;IAsBxB,OAAO,CAAC,QAAQ;IAsBhB,OAAO;IAKP,OAAO,CAAC,iBAAiB;IAgBnB,MAAM,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CA8CrE;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAOpE,QAAA,MAAM,QAAQ,UAAY,eAAe,aAEtB,CAAC;AAEpB,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACf,MAAM,eAAe,CAAC;AAQvB,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,eAAgB,SAAQ,uBAAuB;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CAChC;AA8GD,qBAAa,QAAS,SAAQ,cAAc;IAoBvB,IAAI,EAAE,eAAe;IAnBxC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAS;IACzC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAuB;IACnD,IAAI,SAAQ;IACZ,mBAAmB,WAAiC;IACpD,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,MAAM,CAA6C;IAC3D,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,OAAO,CAIV;IAEL,OAAO,CAAC,SAAS,CAA6B;gBAE3B,IAAI,GAAE,eAAoB;IAM7C,OAAO;IAIP,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAkBrC,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,oBAAoB;IAY5B,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,mBAAmB;YA0Bb,WAAW;IA8CzB,OAAO,CAAC,WAAW;YAwFL,YAAY;IAW1B,OAAO,CAAC,cAAc;IAiCtB,OAAO,CAAC,gBAAgB;YAQV,UAAU;IAwBxB,OAAO,CAAC,QAAQ;IA0BhB,OAAO;IAMP,OAAO,CAAC,iBAAiB;IAgBnB,MAAM,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IA+CpE;;;;;OAKG;IACG,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAA;KAAE,CAAC;CA6BnI;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAOpE,QAAA,MAAM,QAAQ,UAAY,eAAe,aAEtB,CAAC;AAEpB,eAAe,QAAQ,CAAC"}

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",
@@ -61,6 +154,7 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 	name = "js";
 	supportedExtensions = Array.from(SCRIPT_EXTENSIONS);
 	runtimeState = { status: "idle" };
+	shuttingDown = false;
 	brokerServer;
 	brokerSocketPath;
 	worker;
@@ -113,6 +207,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 +272,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 +303,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 +316,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",
@@ -232,10 +330,19 @@ var JsPlugin = class JsPlugin extends AbstractPlugin {
 			}
 		});
 		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 +351,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 +370,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 +378,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 +451,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 +470,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 +500,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 +513,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.