@gjsify/rolldown-plugin-gjsify 0.38.0 → 0.39.0

package/lib/index.d.ts

@@ -5,6 +5,7 @@ export * from './library/index.js';
 export { REWRITE_FILTER, extractPackageSpec, getBundleDirFromOutput, rewriteContents, shouldRewrite, nodeModulesPathRewritePlugin, } from './plugins/rewrite-node-modules-paths.js';
 export type { NodeModulesPathRewriteOptions, RewriteResult } from './plugins/rewrite-node-modules-paths.js';
 export { processStubPlugin, GJS_PROCESS_STUB, composeBanner } from './plugins/process-stub.js';
+export { giRuntimePathsStub } from './plugins/gi-runtime-paths.js';
 export type { ProcessStubPluginOptions } from './plugins/process-stub.js';
 export { cssAsStringPlugin } from './plugins/css-as-string.js';
 export { textLoaderPlugin } from './plugins/text-loader.js';

package/lib/index.js

@@ -5,6 +5,7 @@ export * from './app/index.js';
 export * from './library/index.js';
 export { REWRITE_FILTER, extractPackageSpec, getBundleDirFromOutput, rewriteContents, shouldRewrite, nodeModulesPathRewritePlugin, } from './plugins/rewrite-node-modules-paths.js';
 export { processStubPlugin, GJS_PROCESS_STUB, composeBanner } from './plugins/process-stub.js';
+export { giRuntimePathsStub } from './plugins/gi-runtime-paths.js';
 export { cssAsStringPlugin } from './plugins/css-as-string.js';
 export { textLoaderPlugin } from './plugins/text-loader.js';
 export { shebangPlugin, GJS_SHEBANG, NODE_SHEBANG, expandEnvTemplate, resolveShebangLine } from './plugins/shebang.js';

package/lib/plugins/gi-runtime-paths.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The byte-1 prologue that prepends `dirs` to the default repository's typelib
+ * search path and library path. Empty list → `''`: a no-op prologue in every
+ * bundle is a guard that can never fire, and a banner that is not there cannot
+ * drift.
+ *
+ * @param dirs directories RELATIVE to the program's own directory, `/`-separated —
+ *   an absolute path baked at build time is the BUILD machine's
+ */
+export declare function giRuntimePathsStub(dirs: readonly string[]): string;

package/lib/plugins/gi-runtime-paths.js

@@ -0,0 +1,37 @@
+// Tell GI where a bundle's own typelibs and their backing libraries are — from
+// INSIDE the process, so a `--app gjs` bundle needs no launcher and no environment.
+// Why it exists, what it does NOT cover (a dylib reached through another dylib's
+// link closure never passes through GI, so only `@rpath`/`$ORIGIN` reaches it) and
+// the macOS measurements behind it: `status/open-todos.md` § "A globally installed
+// GJS launcher still cannot load a system GTK on macOS", ADR 0023 § 4.
+/**
+ * The byte-1 prologue that prepends `dirs` to the default repository's typelib
+ * search path and library path. Empty list → `''`: a no-op prologue in every
+ * bundle is a guard that can never fire, and a banner that is not there cannot
+ * drift.
+ *
+ * @param dirs directories RELATIVE to the program's own directory, `/`-separated —
+ *   an absolute path baked at build time is the BUILD machine's
+ */
+export function giRuntimePathsStub(dirs) {
+    if (dirs.length === 0)
+        return '';
+    const list = dirs.map((d) => JSON.stringify(d)).join(',');
+    // Four rules, each pinned with its incident by `gi-runtime-paths-banner.spec.ts`:
+    // every ambient global through `globalThis.` (a bare `imports` at byte 1 binds to
+    // a bundled module's own top-level `const imports`, still in its TDZ); guarded
+    // probes, not try/catch (no call here has a throw path, so a catch would hide a
+    // real absence); one line (the banner precedes source-map-aware machinery); both
+    // prepends (search path alone finds the typelib, then fails the dlopen).
+    return (`(function(){var i=globalThis.imports;if(!i||!i.gi||!i.system)return;` +
+        `var R=i.gi.GIRepository;if(!R||!R.Repository||!R.Repository.dup_default)return;` +
+        `var r=R.Repository.dup_default();if(!r||!r.prepend_search_path||!r.prepend_library_path)return;` +
+        `var p=i.system.programPath||i.system.programInvocationName||'';` +
+        // Both separators: the program path is the HOST's, and on win32 a `/`-only
+        // cut matches nothing (same rule as `lastPathSeparatorIndex`, #1143).
+        `var m=/^(.*)[\\/\\\\][^\\/\\\\]*$/.exec(p);if(!m)return;` +
+        // Absolute stays absolute: joining a system libdir under the program dir names nothing.
+        `var b=m[1];for(var d of [${list}]){var f=/^([A-Za-z]:[\\/\\\\]|[\\/\\\\])/.test(d)?d:b+'/'+d;` +
+        `r.prepend_search_path(f);r.prepend_library_path(f)}` +
+        `})();`);
+}

package/lib/plugins/process-stub.d.ts

@@ -1,26 +1,12 @@
 import type { Plugin } from 'rolldown';
 export declare const GJS_PROCESS_STUB: string;
 /**
- * Compose the GJS process stub with the user-supplied banner so the result
- * is valid syntax for `gjs -m`. A leading `#!shebang` line in the user
- * banner is hoisted to byte 0 of the output. Any `#` character that appears
- * anywhere except byte 0 is a fatal SyntaxError under SpiderMonkey 128+ —
- * putting our process stub before the user's shebang would break the bundle.
- *
- * Output shape:
- *   [#!shebang\n][<process-stub>\n<rest-of-user-banner>]
- *
- * Either side of the bracket may be empty; the result is always concatenated
- * without leading whitespace.
+ * Compose the GJS process stub with the user-supplied banner so the result is
+ * valid syntax for `gjs -m`, hoisting a leading `#!shebang` to byte 0: a `#`
+ * anywhere except byte 0 is a fatal SyntaxError under SpiderMonkey 128+, so
+ * putting the stub before the user's shebang would break the bundle.
  */
 export declare function composeBanner(stub: string, userBanner: string): string;
-/**
- * Build a Rolldown plugin that injects the GJS process stub as a chunk
- * banner. Runs with `enforce: 'post'`-equivalent ordering so the stub
- * lands *after* any user `output.banner` value, except when the user
- * banner starts with a `#!shebang` line — which is hoisted to byte 0
- * by `composeBanner`.
- */
 export interface ProcessStubPluginOptions {
     /** User-supplied banner string. May contain a leading `#!shebang`. */
     userBanner?: string;
@@ -29,5 +15,14 @@ export interface ProcessStubPluginOptions {
      * ESM-only — set by the orchestrator when `format === 'esm'`.
      */
     captureBundleUrl?: boolean;
+    /**
+     * Directories, RELATIVE to the program's own directory, holding typelibs and
+     * their backing libraries. Emitted as a byte-1 prologue that hands them to GI at
+     * runtime, so the bundle needs no `GI_TYPELIB_PATH` / loader-path environment and
+     * therefore no launcher (see `gi-runtime-paths.ts` for the measurement).
+     * Empty or unset emits nothing.
+     */
+    giRuntimePaths?: readonly string[];
 }
+/** Inject the byte-1 banner as a chunk banner, after any user `output.banner`. */
 export declare function processStubPlugin(options?: ProcessStubPluginOptions): Plugin;

package/lib/plugins/process-stub.js

@@ -1,5 +1,6 @@
 import { BUNDLE_URL_BANNER } from './bundle-url-banner.js';
 import { GJS_WELLKNOWN_SYMBOLS_STUB } from './wellknown-symbols-banner.js';
+import { giRuntimePathsStub } from './gi-runtime-paths.js';
 // Every GJS ambient global is reached through `globalThis.` — NEVER as a bare
 // identifier. The banner shares the module's top-level scope with the bundled
 // code, so a bare `imports` binds to any top-level `const imports` a bundled
@@ -7,29 +8,22 @@ import { GJS_WELLKNOWN_SYMBOLS_STUB } from './wellknown-symbols-banner.js';
 // in its temporal dead zone: `ReferenceError: can't access lexical declaration
 // 'imports' before initialization`, thrown at load, before a single line of
 // program code runs. `@girs/gjs`'s `gjs.js` declares exactly that
-// (`const imports = globalThis.imports || {}`), so the failure is real and
-// arrives whenever tree-shaking happens to retain that module. It was found
-// via `@gjsify/web-streams`, whose GJS test leg died the moment `@gjsify/utils`
-// became more shakeable — but nothing about it is specific to either package.
+// (`const imports = globalThis.imports || {}`), so the failure arrives whenever
+// tree-shaking happens to retain that module.
 export const GJS_PROCESS_STUB = 'if(typeof globalThis.process==="undefined"){' +
     'const _s=globalThis.imports.system,_G=globalThis.imports.gi.GLib;' +
-    // process.hrtime needs a `.bigint` property attached to the function
-    // itself (Node API shape: `process.hrtime.bigint()` — used by execa,
-    // perf-tracking libs, …). Build it as a named local so we can
-    // attach the property before stashing it on the stub object.
+    // `process.hrtime.bigint()` is the shape execa and perf-tracking libs reach
+    // for, so `.bigint` has to hang off the function itself.
     'const _h=t=>t?[0,0]:[0,0];_h.bigint=()=>0n;' +
-    // `platform`/`arch`, answered LAZILY by the same `uname -sm` probe
-    // `@gjsify/process` uses (`packages/node/process/src/internal/uname.ts`),
-    // with `@gjsify/utils`' `platform-names.ts` mapping tables inlined minimally
-    // — a banner runs before the module system exists and cannot import the
-    // canonical ones. Those two are the source of truth; keep this in step or a
-    // bundle answers differently depending on whether it pulled
-    // `@gjsify/process` in. These used to be the literals `"linux"`/`"x64"`,
-    // which is a WRONG answer on two of three OSes rather than a missing one.
-    // Lazy, so the cost falls only on a bundle that reads the field AND never
-    // loads `@gjsify/process` (whose register replaces this object): nothing is
-    // spawned at load. Windows is answered from the environment — `uname` is not
-    // on a native Windows PATH, and the env answer is exact.
+    // `platform`/`arch` from the same `uname -sm` probe `@gjsify/process` uses
+    // (`packages/node/process/src/internal/uname.ts`) plus `@gjsify/utils`'
+    // `platform-names.ts` tables, inlined minimally because a banner runs before
+    // the module system exists. Those two are the source of truth; keep this in
+    // step or a bundle answers differently depending on whether it pulled
+    // `@gjsify/process` in. These used to be the literals `"linux"`/`"x64"` — a
+    // WRONG answer on two of three OSes rather than a missing one. Lazy, so
+    // nothing is spawned at load. Windows is answered from the environment:
+    // `uname` is not on a native Windows PATH, and the env answer is exact.
     'let _pc;const _p=()=>{if(_pc)return _pc;_pc={platform:"linux",arch:"x64"};' +
     'try{' +
     'if(_G.getenv("OS")==="Windows_NT"||_G.getenv("SystemRoot")){' +
@@ -65,17 +59,10 @@ export const GJS_PROCESS_STUB = 'if(typeof globalThis.process==="undefined"){' +
     '};' +
     '}';
 /**
- * Compose the GJS process stub with the user-supplied banner so the result
- * is valid syntax for `gjs -m`. A leading `#!shebang` line in the user
- * banner is hoisted to byte 0 of the output. Any `#` character that appears
- * anywhere except byte 0 is a fatal SyntaxError under SpiderMonkey 128+ —
- * putting our process stub before the user's shebang would break the bundle.
- *
- * Output shape:
- *   [#!shebang\n][<process-stub>\n<rest-of-user-banner>]
- *
- * Either side of the bracket may be empty; the result is always concatenated
- * without leading whitespace.
+ * Compose the GJS process stub with the user-supplied banner so the result is
+ * valid syntax for `gjs -m`, hoisting a leading `#!shebang` to byte 0: a `#`
+ * anywhere except byte 0 is a fatal SyntaxError under SpiderMonkey 128+, so
+ * putting the stub before the user's shebang would break the bundle.
  */
 export function composeBanner(stub, userBanner) {
     if (!userBanner)
@@ -88,13 +75,17 @@ export function composeBanner(stub, userBanner) {
     const rest = userBanner.slice(shebang.length);
     return shebang + stub + (rest ? '\n' + rest : '');
 }
+/** Inject the byte-1 banner as a chunk banner, after any user `output.banner`. */
 export function processStubPlugin(options = {}) {
-    // The anchor capture must precede the process stub so it runs at the very
-    // top of the chunk (where `import.meta.url` is the bundle's own URL). The
-    // well-known-symbols polyfill must also run before any module init, so it
-    // joins the byte-1 banner. All three pieces are single-line (no source-map
-    // drift) and idempotent.
-    const stub = (options.captureBundleUrl ? BUNDLE_URL_BANNER : '') + GJS_WELLKNOWN_SYMBOLS_STUB + GJS_PROCESS_STUB;
+    // Order is load-bearing: the anchor capture first, because `import.meta.url`
+    // is the bundle's own URL only at the very top of the chunk; the GI path
+    // prologue last, because it reads `imports.system`, which the process stub
+    // neither provides nor disturbs. Everything here runs before module init and
+    // is single-line and idempotent.
+    const stub = (options.captureBundleUrl ? BUNDLE_URL_BANNER : '') +
+        GJS_WELLKNOWN_SYMBOLS_STUB +
+        GJS_PROCESS_STUB +
+        giRuntimePathsStub(options.giRuntimePaths ?? []);
     const banner = composeBanner(stub, options.userBanner ?? '');
     return {
         name: 'gjsify-process-stub',

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gjsify/rolldown-plugin-gjsify",
-    "version": "0.38.0",
+    "version": "0.39.0",
     "description": "Rolldown / Rollup / Vite plugin orchestrator for GJS, Node, and Browser targets",
     "type": "module",
     "main": "lib/index.js",
@@ -55,11 +55,11 @@
     ],
     "license": "MIT",
     "dependencies": {
-        "@gjsify/console": "^0.38.0",
-        "@gjsify/resolve-npm": "^0.38.0",
-        "@gjsify/rolldown-plugin-deepkit": "^0.38.0",
-        "@gjsify/rolldown-plugin-pnp": "^0.38.0",
-        "@gjsify/vite-plugin-blueprint": "^0.38.0",
+        "@gjsify/console": "^0.39.0",
+        "@gjsify/resolve-npm": "^0.39.0",
+        "@gjsify/rolldown-plugin-deepkit": "^0.39.0",
+        "@gjsify/rolldown-plugin-pnp": "^0.39.0",
+        "@gjsify/vite-plugin-blueprint": "^0.39.0",
         "@rollup/pluginutils": "^5.4.0",
         "acorn": "^8.17.0",
         "acorn-walk": "^8.3.5",
@@ -68,7 +68,7 @@
         "sass": "^1.101.0"
     },
     "peerDependencies": {
-        "@gjsify/lightningcss-native": "^0.38.0",
+        "@gjsify/lightningcss-native": "^0.39.0",
         "rolldown": "^1.1.4"
     },
     "peerDependenciesMeta": {