@gjsify/cli 0.17.0 → 0.19.0

package/lib/utils/runtimes.js

@@ -0,0 +1,97 @@
+// Shared runtime-selector tooling for running gjsify examples/showcases across
+// the FOUR runtimes gjsify targets: gjs, node, bun, deno.
+//
+// This is the single source of truth generalized from the node-gi quad-runtime
+// example's `harness.mjs`. Both the CLI (`gjsify run`/`gjsify showcase
+// --runtime`) and the examples (the node-gi `harness.mjs`) consume it — so the
+// RUNTIMES map, the runtime→build-target mapping and `availableRuntimes()` live
+// in ONE place instead of a per-example copy.
+//
+// The module is intentionally PURE (only `node:child_process` and the pure,
+// side-effect-free `@gjsify/rolldown-plugin-gjsify/runtime` host detector, no
+// `gi://` / native imports) so an external example can deep-import it from the
+// installed CLI (`@gjsify/cli/lib/utils/runtimes.js`) without pulling the whole
+// bundler in. Mirrors the existing `@gjsify/cli/lib/utils/run-gjs.js`
+// deep-import precedent used by the dlx e2e suites.
+import { execFileSync } from 'node:child_process';
+import { hostRuntime } from '@gjsify/rolldown-plugin-gjsify/runtime';
+/** All runtimes, in canonical order (gjs first — it is the reference). */
+export const EXAMPLE_RUNTIMES = ['gjs', 'node', 'bun', 'deno'];
+/**
+ * The runtime map — the generalization of the node-gi harness's `RUNTIMES`.
+ * `deno` uses `--node-modules-dir=manual`: `auto` would re-resolve the example's
+ * heavy build-time dep tree (`@gjsify/cli` + platform binaries) and hang, when
+ * the app only needs the already-linked runtime dep `@gjsify/node-gi`.
+ */
+export const RUNTIMES = {
+    gjs: { probe: 'gjs', buildApp: 'gjs', launch: (e, a = []) => ['gjs', ['-m', e, ...a]] },
+    node: { probe: 'node', buildApp: 'node', launch: (e, a = []) => ['node', [e, ...a]] },
+    bun: { probe: 'bun', buildApp: 'node', launch: (e, a = []) => ['bun', [e, ...a]] },
+    deno: {
+        probe: 'deno',
+        buildApp: 'node',
+        launch: (e, a = []) => ['deno', ['run', '-A', '--node-modules-dir=manual', e, ...a]],
+    },
+};
+/** Type guard: is `value` one of the four known runtimes? */
+export function isExampleRuntime(value) {
+    return EXAMPLE_RUNTIMES.includes(value);
+}
+/** The `gjsify build --app <target>` a runtime consumes (`gjs`, else `node`). */
+export function buildAppForRuntime(runtime) {
+    return RUNTIMES[runtime].buildApp;
+}
+/** Whether `<probe> --version` succeeds (i.e. the runtime binary is on PATH). */
+export function isRuntimeOnPath(probe) {
+    try {
+        execFileSync(probe, ['--version'], { stdio: 'ignore', timeout: 15000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Whether a specific runtime is runnable here. The HOST runtime (the one the
+ * CLI itself executes in — gjs / node / bun / deno) is always available: we are
+ * running on it, so no PATH probe is needed. Every other runtime is probed via
+ * `<binary> --version`.
+ */
+export function isRuntimeAvailable(runtime) {
+    return runtime === hostRuntime() ? true : isRuntimeOnPath(RUNTIMES[runtime].probe);
+}
+/** Which of gjs/node/bun/deno are runnable on this host. */
+export function availableRuntimes() {
+    return EXAMPLE_RUNTIMES.filter((rt) => isRuntimeAvailable(rt));
+}
+/**
+ * Read a package's declared example runtimes. Returns the (validated) list, or
+ * `null` when the package declares none — the "unconstrained / permissive" case.
+ * Unknown entries in the list are dropped (so a future runtime name doesn't hard
+ * error against an older CLI).
+ */
+export function readDeclaredRuntimes(pkg) {
+    const list = pkg?.gjsify?.example?.runtimes;
+    if (!Array.isArray(list))
+        return null;
+    return list.filter((v) => typeof v === 'string' && isExampleRuntime(v));
+}
+/**
+ * Validate a requested runtime against a package's declaration. A `null`
+ * declaration is permissive (always ok). When the runtime is not in the
+ * declared set, returns a clear, actionable error message (never throws) so
+ * callers can print it and exit cleanly.
+ */
+export function checkRuntimeSupported(runtime, declared, name) {
+    if (declared === null)
+        return { ok: true };
+    if (declared.includes(runtime))
+        return { ok: true };
+    const supported = declared.length > 0 ? declared.join(', ') : '(none)';
+    return {
+        ok: false,
+        message: `"${name}" does not support --runtime ${runtime}.\n` +
+            `  Declared runtimes: ${supported}.\n` +
+            `  Run it on one of the declared runtimes, e.g. --runtime ${declared[0] ?? 'gjs'}.`,
+    };
+}

package/lib/utils/workspace-root.js

@@ -11,17 +11,10 @@
 // monorepo must actually contain `start` as one of its workspaces.
 // Without this guard, a grand-parent monorepo unrelated to `start`
 // could be picked up.
-import { existsSync, readFileSync } from 'node:fs';
+import { existsSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { discoverWorkspaces } from '@gjsify/workspace';
-function readPackageJson(path) {
-    try {
-        return JSON.parse(readFileSync(path, 'utf-8'));
-    }
-    catch {
-        return null;
-    }
-}
+import { readPackageJson } from './pkg-json.js';
 export function findWorkspaceRoot(start) {
     let dir = start;
     for (let i = 0; i < 12; i++) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/cli",
-    "version": "0.17.0",
+    "version": "0.19.0",
     "description": "CLI for Gjsify",
     "type": "module",
     "main": "lib/index.js",
@@ -113,6 +113,9 @@
         "chmod": "chmod +x ./lib/index.js",
         "build:test:node": "node lib/index.js build src/test.mts --app node --outfile dist/test.node.mjs",
         "test:node": "node dist/test.node.mjs",
+        "test:bun": "bun dist/test.node.mjs",
+        "test:deno": "deno run -A --no-lock --node-modules-dir=none dist/test.node.mjs",
+        "test:cross-runtime": "gjsify run build:test:node && gjsify run test:node && gjsify run test:bun && gjsify run test:deno",
         "test": "gjsify run build:test:node && gjsify run test:node"
     },
     "keywords": [
@@ -122,19 +125,19 @@
         "cli"
     ],
     "dependencies": {
-        "@gjsify/buffer": "^0.17.0",
-        "@gjsify/create-app": "^0.17.0",
-        "@gjsify/node-globals": "^0.17.0",
-        "@gjsify/node-polyfills": "^0.17.0",
-        "@gjsify/npm-registry": "^0.17.0",
-        "@gjsify/resolve-npm": "^0.17.0",
-        "@gjsify/rolldown-plugin-gjsify": "^0.17.0",
-        "@gjsify/rolldown-plugin-pnp": "^0.17.0",
-        "@gjsify/semver": "^0.17.0",
-        "@gjsify/tar": "^0.17.0",
-        "@gjsify/tsc": "^0.17.0",
-        "@gjsify/web-polyfills": "^0.17.0",
-        "@gjsify/workspace": "^0.17.0",
+        "@gjsify/buffer": "^0.19.0",
+        "@gjsify/create-app": "^0.19.0",
+        "@gjsify/node-globals": "^0.19.0",
+        "@gjsify/node-polyfills": "^0.19.0",
+        "@gjsify/npm-registry": "^0.19.0",
+        "@gjsify/resolve-npm": "^0.19.0",
+        "@gjsify/rolldown-plugin-gjsify": "^0.19.0",
+        "@gjsify/rolldown-plugin-pnp": "^0.19.0",
+        "@gjsify/semver": "^0.19.0",
+        "@gjsify/tar": "^0.19.0",
+        "@gjsify/tsc": "^0.19.0",
+        "@gjsify/web-polyfills": "^0.19.0",
+        "@gjsify/workspace": "^0.19.0",
         "cosmiconfig": "^9.0.2",
         "get-tsconfig": "^4.14.0",
         "pkg-types": "^2.3.1",
@@ -142,13 +145,13 @@
         "yargs": "^18.0.0"
     },
     "devDependencies": {
-        "@gjsify/unit": "^0.17.0",
+        "@gjsify/unit": "^0.19.0",
         "@types/yargs": "^17.0.35",
         "typescript": "^6.0.3"
     },
     "peerDependencies": {
-        "@gjsify/oxfmt-native": "^0.17.0",
-        "@gjsify/rolldown-native": "^0.17.0"
+        "@gjsify/oxfmt-native": "^0.19.0",
+        "@gjsify/rolldown-native": "^0.19.0"
     },
     "peerDependenciesMeta": {
         "@gjsify/oxfmt-native": {