@gjsify/cli 0.37.0 → 0.38.1

package/lib/utils/node-script.js

@@ -17,6 +17,10 @@
 //                            injects the globals the script reads, and resolves bare
 //                            specifiers), then run the bundle.
 //
+// "the globals the script reads" is auto-detection: a syntactic answer to a runtime question,
+// blind to a dead branch. The script's own package overrides it through `gjsify.nodeScript` /
+// `gjsify.globals` (`Config.forNodeScript`) — the shim path has no command line for a flag.
+//
 // `import.meta.url` is the whole trick: the bundle does not live where the source lives, and
 // a script's own location is how it finds what it operates on — all four scripts this was
 // built for derive their package root from `dirname(fileURLToPath(import.meta.url))`. Left
@@ -29,6 +33,7 @@ import { existsSync, statSync } from 'node:fs';
 import { basename, resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { hostRuntime } from '@gjsify/rolldown-plugin-gjsify/runtime';
+import { Config } from '../config.js';
 import { runGjsBundle } from './run-gjs.js';
 import { runRuntimeBundle } from './run-node.js';
 /**
@@ -73,6 +78,7 @@ export async function runNodeScript(file, extraArgs = [], options = {}) {
     // Dynamic import keeps the bundler machinery out of the eager module graph
     // of every `gjsify run`, matching how config.ts pulls it.
     const { BuildAction } = await import('../actions/build.js');
+    const { globals, excludeGlobals } = await new Config().forNodeScript(scriptPath);
     let bundlePath;
     try {
         bundlePath = await BuildAction.bundleFileForGjsCached(scriptPath, {
@@ -82,6 +88,8 @@ export async function runNodeScript(file, extraArgs = [], options = {}) {
             // A script is executed, never imported — no default export to preserve.
             preserveDefaultExport: false,
             define: { 'import.meta.url': JSON.stringify(pathToFileURL(scriptPath).href) },
+            globals,
+            excludeGlobals,
         });
     }
     catch (err) {
@@ -90,6 +98,6 @@ export async function runNodeScript(file, extraArgs = [], options = {}) {
             `workspace packages, pure-JS npm deps). (${err.message})`);
     }
     // Quiet for the same reason as the node path above; the bundle's location is
-    // deterministic (`node_modules/.cache/gjsify/node-scripts/<name>-<hash>.mjs`).
+    // deterministic (`node_modules/.cache/gjsify/node-scripts/<name>-<hash>/<name>.mjs`).
     await runGjsBundle(bundlePath, extraArgs, { exitOnSuccess: options.exitOnSuccess, quiet: true });
 }

package/lib/utils/publish-headers.d.ts

@@ -38,3 +38,4 @@ export interface PublishHeaderOptions {
  * and a wildcard here misses the create route.
  */
 export declare function buildPublishHeaders(url: string, opts: PublishHeaderOptions): Record<string, string>;
+export declare function cliVersion(): string;

package/lib/utils/publish-headers.js

@@ -82,9 +82,14 @@ export function buildPublishHeaders(url, opts) {
  *    `lib/`, `dist/` and an installed `node_modules/@gjsify/cli/**` alike.
  *
  * `GJSIFY_CLI_PACKAGE_JSON` overrides both, matching `self-update.ts`.
+ *
+ * Exported because `showcase` needs the SAME answer rather than a fourth
+ * resolver: it PINS the showcase package to this version, so a version it cannot
+ * read is a showcase left unpinned and `dlx` serves a stale cached one
+ * (`docs/code-anti-patterns.md`). Returns `'unknown'`, never `undefined`.
  */
 let cachedCliVersion;
-function cliVersion() {
+export function cliVersion() {
     if (cachedCliVersion !== undefined)
         return cachedCliVersion;
     cachedCliVersion =

package/lib/utils/system-gi.d.ts

@@ -60,3 +60,21 @@ export declare function systemGiLibraryDirs({ platform, env, existsDir, searchDi
  * pins both.
  */
 export declare function pathCovers(wanted: readonly string[], current: readonly string[]): boolean;
+/**
+ * dyld's OWN default fallback list, verbatim from `dyld(1)`. Setting
+ * `DYLD_FALLBACK_LIBRARY_PATH` REPLACES it, so anything composed for that
+ * variable must carry it as a tail. The incident that bought this rule is in the
+ * ORIGINAL (`packages/node-gi/node-gi/system-gi.js`); the mirror does not
+ * restate it.
+ */
+export declare function dyldDefaultFallbackDirs(env?: Record<string, string | undefined>): string[];
+/**
+ * Compose a `DYLD_FALLBACK_LIBRARY_PATH` value: `wanted`, then the launching
+ * environment's own value, then {@link dyldDefaultFallbackDirs} —
+ * unconditionally, so a child launched through gjsify never searches LESS than
+ * one launched without it. Deduplicated: `systemGiLibraryDirs()` can legitimately
+ * yield a directory the tail also names, and a repeated entry costs the loader a
+ * second stat on every miss. First occurrence wins everywhere, so dropping later
+ * repeats is behaviour-preserving.
+ */
+export declare function composeDyldFallback(wanted: readonly string[], env?: Record<string, string | undefined>): string;

package/lib/utils/system-gi.js

@@ -174,3 +174,28 @@ export function systemGiLibraryDirs({ platform = process.platform, env = process
 export function pathCovers(wanted, current) {
     return wanted.every((dir) => current.includes(dir));
 }
+/**
+ * dyld's OWN default fallback list, verbatim from `dyld(1)`. Setting
+ * `DYLD_FALLBACK_LIBRARY_PATH` REPLACES it, so anything composed for that
+ * variable must carry it as a tail. The incident that bought this rule is in the
+ * ORIGINAL (`packages/node-gi/node-gi/system-gi.js`); the mirror does not
+ * restate it.
+ */
+export function dyldDefaultFallbackDirs(env = process.env) {
+    const home = env['HOME'];
+    return [...(home ? [`${home}/lib`] : []), '/usr/local/lib', '/lib', '/usr/lib'];
+}
+/**
+ * Compose a `DYLD_FALLBACK_LIBRARY_PATH` value: `wanted`, then the launching
+ * environment's own value, then {@link dyldDefaultFallbackDirs} —
+ * unconditionally, so a child launched through gjsify never searches LESS than
+ * one launched without it. Deduplicated: `systemGiLibraryDirs()` can legitimately
+ * yield a directory the tail also names, and a repeated entry costs the loader a
+ * second stat on every miss. First occurrence wins everywhere, so dropping later
+ * repeats is behaviour-preserving.
+ */
+export function composeDyldFallback(wanted, env = process.env) {
+    return [
+        ...new Set([...wanted, ...splitSearchPath(env['DYLD_FALLBACK_LIBRARY_PATH']), ...dyldDefaultFallbackDirs(env)]),
+    ].join(':');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/cli",
-    "version": "0.37.0",
+    "version": "0.38.1",
     "description": "CLI for Gjsify",
     "type": "module",
     "main": "lib/index.js",
@@ -134,20 +134,20 @@
         "cli"
     ],
     "dependencies": {
-        "@gjsify/buffer": "^0.37.0",
-        "@gjsify/create-app": "^0.37.0",
-        "@gjsify/node-globals": "^0.37.0",
-        "@gjsify/node-polyfills": "^0.37.0",
-        "@gjsify/npm-registry": "^0.37.0",
-        "@gjsify/resolve-npm": "^0.37.0",
-        "@gjsify/rolldown-plugin-gjsify": "^0.37.0",
-        "@gjsify/vite-plugin-blueprint": "^0.37.0",
-        "@gjsify/rolldown-plugin-pnp": "^0.37.0",
-        "@gjsify/semver": "^0.37.0",
-        "@gjsify/tar": "^0.37.0",
-        "@gjsify/tsc": "^0.37.0",
-        "@gjsify/web-polyfills": "^0.37.0",
-        "@gjsify/workspace": "^0.37.0",
+        "@gjsify/buffer": "^0.38.1",
+        "@gjsify/create-app": "^0.38.1",
+        "@gjsify/node-globals": "^0.38.1",
+        "@gjsify/node-polyfills": "^0.38.1",
+        "@gjsify/npm-registry": "^0.38.1",
+        "@gjsify/resolve-npm": "^0.38.1",
+        "@gjsify/rolldown-plugin-gjsify": "^0.38.1",
+        "@gjsify/vite-plugin-blueprint": "^0.38.1",
+        "@gjsify/rolldown-plugin-pnp": "^0.38.1",
+        "@gjsify/semver": "^0.38.1",
+        "@gjsify/tar": "^0.38.1",
+        "@gjsify/tsc": "^0.38.1",
+        "@gjsify/web-polyfills": "^0.38.1",
+        "@gjsify/workspace": "^0.38.1",
         "cosmiconfig": "^9.0.2",
         "get-tsconfig": "^4.14.0",
         "pkg-types": "^2.3.1",
@@ -155,13 +155,13 @@
         "yargs": "^18.0.0"
     },
     "devDependencies": {
-        "@gjsify/unit": "^0.37.0",
+        "@gjsify/unit": "^0.38.1",
         "@types/yargs": "^17.0.35",
         "typescript": "^6.0.3"
     },
     "peerDependencies": {
-        "@gjsify/oxfmt-native": "^0.37.0",
-        "@gjsify/rolldown-native": "^0.37.0"
+        "@gjsify/oxfmt-native": "^0.38.1",
+        "@gjsify/rolldown-native": "^0.38.1"
     },
     "peerDependenciesMeta": {
         "@gjsify/oxfmt-native": {