@cldmv/slothlet 2.11.0 → 3.0.1

package/dist/lib/engine/slothlet_engine.mjs

@@ -1,372 +0,0 @@
-/*
-	Copyright 2026 CLDMV/Shinrai
-
-	Licensed under the Apache License, Version 2.0 (the "License");
-	you may not use this file except in compliance with the License.
-	You may obtain a copy of the License at
-
-		http://www.apache.org/licenses/LICENSE-2.0
-
-	Unless required by applicable law or agreed to in writing, software
-	distributed under the License is distributed on an "AS IS" BASIS,
-	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-	See the License for the specific language governing permissions and
-	limitations under the License.
-*/
-
-
-
-import { Worker } from "node:worker_threads";
-import { fork } from "node:child_process";
-import { fileURLToPath } from "node:url";
-import vm from "node:vm";
-import util from "node:util";
-
-import {
-	asUrl,
-	
-	HAS_STM,
-	makeNodeishContext,
-	installContextGlobalsVM,
-	bootSlothletVM,
-	
-	normalizeContext,
-	marshalArgsReplaceFunctions
-} from "./slothlet_helpers.mjs";
-
-let shutdownFn = null;
-
-export function setShutdown(fn) {
-	const prev = shutdownFn;
-	shutdownFn = fn;
-	return prev;
-}
-
-
-export async function createEngine(allOptions) {
-	const { entry, mode = "vm" } = allOptions ?? {};
-	if (!entry) throw new Error('createEngine: "entry" is required');
-
-	
-	const { context = null, reference = null, ...loadConfig } = allOptions;
-
-	if (mode === "vm") {
-		if (!HAS_STM) {
-			
-			return backendWorker(entry, loadConfig, { context, reference });
-		}
-		return backendVm(entry, loadConfig, { context, reference });
-	}
-
-	if (mode === "worker") {
-		return backendWorker(entry, loadConfig, { context, reference });
-	}
-
-	if (mode === "fork" || mode === "child") {
-		return backendFork(entry, loadConfig, { context, reference });
-	}
-
-	throw new Error(`Unknown mode "${mode}" (use "vm" | "worker" | "fork")`);
-}
-
-
-async function backendVm(entry, loadConfig, ctxRef) {
-	const context = makeNodeishContext();
-	installContextGlobalsVM(context, ctxRef.context);
-	await bootSlothletVM(context, asUrl(entry), loadConfig, ctxRef);
-
-	
-
-	
-	
-	
-	await vm.runInContext("slothletReady", context, { filename: "slothlet_engine-backendVm.mjs" });
-	const portal = vm.runInContext("_portal", context, { filename: "slothlet_engine-backendVm.mjs" });
-	
-	const api = makeFacade({
-		call: (path, args) => Promise.resolve(portal.call(path, args)),
-		batch: (ops) => Promise.resolve(portal.batch(ops))
-	});
-
-	const dispose = async () => {};
-	Object.defineProperty(api, "__dispose__", {
-		value: dispose,
-		writable: false,
-		enumerable: false,
-		configurable: false
-	});
-	return { api, dispose };
-}
-
-
-async function backendWorker(entry, loadConfig, ctxRef) {
-	const workerPath = new URL("./slothlet_worker.mjs", import.meta.url);
-	let nextId = 1;
-	const pending = new Map();
-	
-	let cbId = 1;
-	const callbacks = new Map();
-
-	const w = new Worker(workerPath, {
-		workerData: {
-			entry: asUrl(entry),
-			loadConfig,
-			
-			contextMap: normalizeContext(ctxRef.context),
-			reference: ctxRef.reference ?? null
-		}
-	});
-
-	w.on("message", (msg) => {
-		
-		if (msg && msg.t === "callback" && typeof msg.cb === "number") {
-			const fn = callbacks.get(msg.cb);
-			if (!fn) {
-				w.postMessage({ t: "callbackResult", cb: msg.cb, ok: false, error: "Callback not found" });
-				return;
-			}
-			Promise.resolve()
-				.then(() => fn(...(msg.args ?? [])))
-				.then((result) => {
-					w.postMessage({ t: "callbackResult", cb: msg.cb, ok: true, result });
-				})
-				.catch((error) => {
-					w.postMessage({ t: "callbackResult", cb: msg.cb, ok: false, error: error?.message || String(error) });
-				});
-			return;
-		}
-		
-		const { id, ok, result, error } = msg;
-		const rec = pending.get(id);
-		if (!rec) return;
-		pending.delete(id);
-		ok ? rec.resolve(result) : rec.reject(new Error(error));
-	});
-
-	
-	function registerCb(fn) {
-		const id = cbId++;
-		callbacks.set(id, fn);
-		return id;
-	}
-
-	
-	function marshalArgs(args) {
-		return marshalArgsReplaceFunctions(args, registerCb);
-	}
-
-	const rpc = (msg) =>
-		new Promise((resolve, reject) => {
-			const id = nextId++;
-			pending.set(id, { resolve, reject });
-			let message = { id, ...msg };
-			
-			if (Array.isArray(message.args)) {
-				message = { ...message, args: marshalArgs(message.args) };
-			}
-			w.postMessage(message);
-		});
-
-	const api = makeFacade({
-		call: (path, args) => rpc({ t: "call", path, args }),
-		batch: (ops) => rpc({ t: "batch", ops })
-	});
-
-	const dispose = async () => {
-		await rpc({ t: "dispose" });
-		await w.terminate();
-	};
-	Object.defineProperty(api, "__dispose__", {
-		value: dispose,
-		writable: false,
-		enumerable: false,
-		configurable: false
-	});
-	return { api, dispose };
-}
-
-
-async function backendFork(entry, loadConfig, ctxRef) {
-	const childPath = fileURLToPath(new URL("./slothlet_child.mjs", import.meta.url));
-	let nextId = 1;
-	const pending = new Map();
-
-	const cp = fork(childPath, [], { stdio: ["inherit", "inherit", "inherit", "ipc"] });
-
-	cp.on("message", ({ id, ok, result, error }) => {
-		const rec = pending.get(id);
-		if (!rec) return;
-		pending.delete(id);
-		ok ? rec.resolve(result) : rec.reject(new Error(error));
-	});
-
-	const rpc = (msg) =>
-		new Promise((resolve, reject) => {
-			const id = nextId++;
-			pending.set(id, { resolve, reject });
-			cp.send({ id, ...msg });
-		});
-
-	await rpc({
-		t: "init",
-		entry: asUrl(entry),
-		loadConfig,
-		contextMap: normalizeContext(ctxRef.context),
-		reference: ctxRef.reference ?? null
-	});
-
-	const api = makeFacade({
-		call: (path, args) => rpc({ t: "call", path, args }),
-		batch: (ops) => rpc({ t: "batch", ops })
-	});
-
-	const dispose = async () => {
-		await rpc({ t: "dispose" });
-	};
-	Object.defineProperty(api, "__dispose__", {
-		value: dispose,
-		writable: false,
-		enumerable: false,
-		configurable: false
-	});
-	return { api, dispose };
-}
-
-function makeFn(name) {
-	const fn = function () {
-		throw new Error("cross-thread stubs are not callable");
-	};
-	try {
-		Object.defineProperty(fn, "name", { value: name || "", configurable: true });
-	} catch {
-		
-	}
-	return fn;
-}
-
-function revive(x) {
-	if (x && typeof x === "object") {
-		if ("__fn" in x) {
-			
-			const fn = makeFn(x.__fn);
-			const props = x.props || {};
-			for (const [k, v] of Object.entries(props)) fn[k] = revive(v);
-			return fn; 
-		}
-		if (Array.isArray(x)) return x.map(revive);
-		const out = {};
-		for (const [k, v] of Object.entries(x)) out[k] = revive(v);
-		return out;
-	}
-	return x;
-}
-
-
-function makeFacade(portal) {
-	const build = (segs = []) => {
-		const proxy = new Proxy(function () {}, {
-			get: (_, prop) => {
-				if (prop === "then") return undefined;
-				if (prop === "describe") {
-					
-					return async () => {
-						const result = await portal.call(["describe"], []);
-						try {
-							
-							return revive(result);
-							
-						} catch {
-							return result;
-						}
-					};
-				}
-				return build(segs.concat(String(prop)));
-			},
-			apply: (_, __, args) => portal.call(segs, args)
-		});
-		return proxy;
-	};
-	return build([]);
-}
-
-function buildCallableFromDescribe(node, portal, path = []) {
-	
-	const isFnBox = node && typeof node === "object" && (node.__fn != null || node.__kind === "fn" || (node.name && node.props));
-
-	if (isFnBox) {
-		const name = node.__fn ?? node.name ?? "";
-		const props = node.props ?? {};
-		
-		const children = {};
-		for (const [k, v] of Object.entries(props)) {
-			children[k] = buildCallableFromDescribe(v, portal, path.concat(String(k)));
-		}
-		const label = `[Function${name ? `: ${name}` : ""}]`;
-
-		return new Proxy(function () {}, {
-			apply: (_t, _thisArg, args) => portal.call(path, args),
-
-			get: (_t, prop) => {
-				if (prop === "name") return name;
-				if (typeof util !== "undefined" && prop === util?.inspect?.custom) {
-					return function (_depth, opts, inspect = util.inspect) {
-						const head = opts?.colors ? opts.stylize(label, "special") : label;
-						const keys = Object.keys(children);
-						if (!keys.length) return head;
-						const body = keys.map((k) => `${k}: ${inspect(children[k], { ...opts, depth: (opts?.depth ?? 2) - 1 })}`).join(", ");
-						return `${head} { ${body} }`;
-					};
-				}
-				if (prop in children) return children[prop];
-				
-				return buildCallableFromDescribe({ __fn: String(prop), props: {} }, portal, path.concat(String(prop)));
-			},
-
-			ownKeys: () => Object.keys(children),
-			getOwnPropertyDescriptor: (_t, key) =>
-				key in children ? { enumerable: true, configurable: true, writable: true, value: children[key] } : undefined
-		});
-	}
-
-	if (node && typeof node === "object") {
-		if (Array.isArray(node)) {
-			return node.map((v, i) => buildCallableFromDescribe(v, portal, path.concat(String(i))));
-		}
-		const out = {};
-		for (const [k, v] of Object.entries(node)) {
-			out[k] = buildCallableFromDescribe(v, portal, path.concat(String(k)));
-		}
-		return out;
-	}
-	return node; 
-}
-
-export function makeFacade2(portal) {
-	const build = (segs = []) => {
-		const describe = async () => {
-			const shape = await portal.call(["describe"], []);
-			return buildCallableFromDescribe(shape, portal, []); 
-		};
-
-		return new Proxy(function () {}, {
-			get: (_t, prop) => {
-				
-				if (prop === "then") {
-					if (segs.length === 0) {
-						return (resolve, reject) => {
-							Promise.resolve().then(describe).then(resolve, reject);
-						};
-					}
-					return undefined; 
-				}
-				if (prop === "describe") return describe;
-
-				return build(segs.concat(String(prop)));
-			},
-
-			apply: (_t, _thisArg, args) => portal.call(segs, args)
-		});
-	};
-
-	return build([]);
-}

package/dist/lib/engine/slothlet_esm.mjs

@@ -1,230 +0,0 @@
-/*
-	Copyright 2026 CLDMV/Shinrai
-
-	Licensed under the Apache License, Version 2.0 (the "License");
-	you may not use this file except in compliance with the License.
-	You may obtain a copy of the License at
-
-		http://www.apache.org/licenses/LICENSE-2.0
-
-	Unless required by applicable law or agreed to in writing, software
-	distributed under the License is distributed on an "AS IS" BASIS,
-	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-	See the License for the specific language governing permissions and
-	limitations under the License.
-*/
-
-
-
-import fs from "node:fs/promises";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { builtinModules } from "module";
-const builtins = new Set(builtinModules);
-
-
-export async function loadEsmModuleFallback(context, fileUrl, visited = new Set()) {
-	
-	if (typeof context.fileURLToPath !== "function") {
-		const { fileURLToPath } = await import("node:url");
-		context.fileURLToPath = fileURLToPath;
-	}
-	
-	context.import = async (specifier) => import(specifier);
-	
-	let specToCheck = fileUrl;
-	if (specToCheck.startsWith("node:")) specToCheck = specToCheck.slice(5);
-	if (!fileUrl.startsWith("file:")) {
-		if (builtins.has(specToCheck) || /^[\w@][\w\-/]*$/.test(specToCheck)) {
-			return await import(fileUrl);
-		}
-		throw new Error(`Unsupported import specifier: ${fileUrl}`);
-	}
-	if (visited.has(fileUrl)) return context[fileUrl];
-	visited.add(fileUrl);
-	let code = await fs.readFile(fileURLToPath(fileUrl), "utf8");
-	
-	const commentRanges = [];
-	const blockCommentRegex = /\/\*[\s\S]*?\*\
-	const lineCommentRegex = /(^|[^:])\/\/.*$/gm;
-	let blockMatch;
-	while ((blockMatch = blockCommentRegex.exec(code))) {
-		commentRanges.push([blockMatch.index, blockCommentRegex.lastIndex]);
-	}
-	let lineMatch;
-	while ((lineMatch = lineCommentRegex.exec(code))) {
-		let start = lineMatch.index + (lineMatch[1] ? lineMatch[1].length : 0);
-		let end = code.indexOf("\n", lineMatch.index);
-		if (end === -1) end = code.length;
-		commentRanges.push([start, end]);
-	}
-	function inComment(idx) {
-		return commentRanges.some(([start, end]) => idx >= start && idx < end);
-	}
-	
-	const importRegex = /import\s+(?:([\w{}*, ]+)\s+from\s+)?["'](.+?)["'];?/g;
-	let match;
-	const imports = [];
-	while ((match = importRegex.exec(code))) {
-		if (!inComment(match.index)) {
-			imports.push({ spec: match[2], names: match[1] });
-		}
-	}
-	
-	for (const imp of imports) {
-		if (!imp.names) continue; 
-		let mod;
-		
-		if (imp.spec.startsWith("./") || imp.spec.startsWith("../")) {
-			const resolvedUrl = new URL(imp.spec, fileUrl).href;
-			mod = await loadEsmModuleFallback(context, resolvedUrl, visited);
-		} else {
-			mod = await import(imp.spec);
-		}
-		
-		const importStr = imp.names.trim();
-		if (importStr.startsWith("* as ")) {
-			
-			const nsName = importStr.slice(5).trim();
-			context[nsName] = mod;
-		} else if (importStr.startsWith("{")) {
-			
-			let fields = importStr
-				.slice(1, -1)
-				.split(",")
-				.map((f) => f.trim())
-				.filter(Boolean);
-			for (let field of fields) {
-				let [orig, alias] = field.split(" as ").map((x) => x.trim());
-				context[alias || orig] = mod[orig];
-			}
-		} else if (importStr) {
-			
-			
-			let parts = importStr
-				.split(/,(.+)/)
-				.map((s) => s.trim())
-				.filter(Boolean);
-			if (parts.length) {
-				const defaultName = parts[0];
-				context[defaultName] = mod.default || mod[defaultName];
-				if (parts[1] && parts[1].startsWith("{")) {
-					let fields = parts[1]
-						.slice(1, -1)
-						.split(",")
-						.map((f) => f.trim())
-						.filter(Boolean);
-					for (let field of fields) {
-						let [orig, alias] = field.split(" as ").map((x) => x.trim());
-						context[alias || orig] = mod[orig];
-					}
-				}
-			}
-		}
-	}
-	const dependencies = {};
-	for (const imp of imports) {
-		let specToCheck = imp.spec;
-		if (specToCheck.startsWith("node:")) specToCheck = specToCheck.slice(5);
-		if (builtins.has(specToCheck) || /^[\w@][\w\-/]*$/.test(specToCheck)) {
-			dependencies[imp.spec] = await import(imp.spec);
-		} else if (imp.spec.startsWith("file:")) {
-			const childUrl = new URL(imp.spec, fileUrl).href;
-			dependencies[imp.spec] = await loadEsmModuleFallback(context, childUrl, visited);
-		} else {
-			
-			const childUrl = new URL(imp.spec, fileUrl).href;
-			if (!childUrl.startsWith("file:")) {
-				throw new Error(`Unsupported import specifier: ${imp.spec}`);
-			}
-			dependencies[imp.spec] = await loadEsmModuleFallback(context, childUrl, visited);
-		}
-	}
-	
-	let evalCode = code
-		
-		.replace(/import\s+[^;]*?;\s*/gs, "")
-		
-		.replace(/import\s+type\s+[^;]*?;\s*/gs, "")
-		
-		
-		.replace(/export\s+default\s+([\w$]+)/g, "")
-		
-		.replace(/export\s+(const|let|var|function|class)\s+([\w$]+)/g, "$1 $2")
-		
-		.replace(/export\s+(default\s+)?/g, "")
-		
-		.replace(/import\.meta\.url/g, JSON.stringify(fileUrl));
-	
-	const localDefRegex = /(const|let|var|function|class)\s+([\w$]+)/g;
-	let localDefs = new Set();
-	let defMatch;
-	while ((defMatch = localDefRegex.exec(code))) {
-		if (!inComment(defMatch.index)) {
-			localDefs.add(defMatch[2]);
-		}
-	}
-	
-	const namedExportRegex = /export\s+(const|let|var|function|class)\s+([\w$]+)/g;
-	let namedExports = [];
-	let namedMatch;
-	while ((namedMatch = namedExportRegex.exec(code))) {
-		if (!inComment(namedMatch.index) && localDefs.has(namedMatch[2])) {
-			namedExports.push(namedMatch[2]);
-		}
-	}
-	
-	let exportDefaultMatch = null;
-	const exportDefaultRegex = /export\s+default\s+([\w$]+)/g;
-	let exportDefaultMatchRaw;
-	while ((exportDefaultMatchRaw = exportDefaultRegex.exec(code))) {
-		if (!inComment(exportDefaultMatchRaw.index)) {
-			exportDefaultMatch = exportDefaultMatchRaw;
-			break;
-		}
-	}
-	if (!context.__dynamicImport) {
-		
-		for (const name of namedExports) {
-			evalCode += `\nglobalThis["${name}"] = ${name};`;
-		}
-		if (exportDefaultMatch) {
-			evalCode += `\nglobalThis["default"] = ${exportDefaultMatch[1]};`;
-		}
-	}
-	
-	for (const [spec, ns] of Object.entries(dependencies)) {
-		const modName = path.basename(spec, path.extname(spec));
-		context[modName] = ns;
-	}
-	
-	const vm = await import("node:vm");
-	const script = new vm.Script(evalCode, {
-		filename: fileUrl,
-		importModuleDynamically: async (specifier) => import(specifier)
-	});
-	script.runInContext(context);
-	
-	const namespace = {};
-	for (const k of Object.keys(context)) {
-		if (k !== "globalThis" && k !== "global") {
-			namespace[k] = context[k];
-		}
-	}
-	context[fileUrl] = namespace;
-	return { namespace };
-}
-
-
-export async function isEsmFile(fileUrl) {
-	const ext = path.extname(fileURLToPath(fileUrl)).toLowerCase();
-	if (ext === ".mjs") return true;
-	if (ext === ".cjs") return false;
-	if (ext === ".js") {
-		const code = await fs.readFile(fileURLToPath(fileUrl), "utf8");
-		return /\bimport\b/.test(code);
-	}
-	return false;
-}
-
-