@gjsify/cli 0.3.1 → 0.3.2

package/lib/actions/build.d.ts

@@ -1,6 +1,6 @@
 import type { ConfigData } from '../types/index.js';
 import type { App } from '@gjsify/esbuild-plugin-gjsify';
-import { BuildOptions, BuildResult } from 'esbuild';
+import { BuildOptions, BuildResult, Plugin } from 'esbuild';
 export declare class BuildAction {
     readonly configData: ConfigData;
     constructor(configData?: ConfigData);
@@ -34,7 +34,7 @@ export declare class BuildAction {
     /** Application mode */
     buildApp(app?: App): Promise<BuildResult<{
         format: "esm" | "cjs";
-        plugins: import("esbuild").Plugin[];
+        plugins: Plugin[];
         bundle?: boolean;
         splitting?: boolean;
         preserveSymlinks?: boolean;

package/lib/actions/build.js

@@ -1,9 +1,38 @@
 import { build } from 'esbuild';
 import { gjsifyPlugin } from '@gjsify/esbuild-plugin-gjsify';
 import { resolveGlobalsList, writeRegisterInjectFile, detectAutoGlobals } from '@gjsify/esbuild-plugin-gjsify/globals';
-import { dirname, extname } from 'node:path';
+import { dirname, extname, join } from 'node:path';
 import { chmod, readFile, writeFile } from 'node:fs/promises';
-const GJS_SHEBANG = '#!/usr/bin/env -S gjs -m\n';
+import { existsSync } from 'node:fs';
+const GJS_SHEBANG = "#!/usr/bin/env -S gjs -m\n";
+/** Walk up from dir until .pnp.cjs is found; return its directory or null. */
+function findPnpRoot(dir) {
+    let current = dir;
+    while (true) {
+        if (existsSync(join(current, ".pnp.cjs")))
+            return current;
+        const parent = dirname(current);
+        if (parent === current)
+            return null;
+        current = parent;
+    }
+}
+/**
+ * If the current project uses Yarn PnP, return the official
+ * @yarnpkg/esbuild-plugin-pnp plugin so esbuild can resolve
+ * modules from zip archives without manual extraction.
+ */
+async function getPnpPlugin() {
+    if (!findPnpRoot(process.cwd()))
+        return null;
+    try {
+        const { pnpPlugin } = await import("@yarnpkg/esbuild-plugin-pnp");
+        return pnpPlugin();
+    }
+    catch {
+        return null;
+    }
+}
 export class BuildAction {
     configData;
     constructor(configData = {}) {
@@ -23,45 +52,50 @@ export class BuildAction {
         typescript ||= {};
         const moduleOutdir = library?.module ? dirname(library.module) : undefined;
         const mainOutdir = library?.main ? dirname(library.main) : undefined;
-        const moduleOutExt = library.module ? extname(library.module) : '.js';
-        const mainOutExt = library.main ? extname(library.main) : '.js';
-        const multipleBuilds = moduleOutdir && mainOutdir && (moduleOutdir !== mainOutdir);
+        const moduleOutExt = library.module ? extname(library.module) : ".js";
+        const mainOutExt = library.main ? extname(library.main) : ".js";
+        const multipleBuilds = moduleOutdir && mainOutdir && moduleOutdir !== mainOutdir;
+        const pnpPlugin = await getPnpPlugin();
+        const pnpPlugins = pnpPlugin ? [pnpPlugin] : [];
         const results = [];
         if (multipleBuilds) {
-            const moduleFormat = moduleOutdir.includes('/cjs') || moduleOutExt === '.cjs' ? 'cjs' : 'esm';
+            const moduleFormat = moduleOutdir.includes("/cjs") || moduleOutExt === ".cjs" ? "cjs" : "esm";
             results.push(await build({
                 ...this.getEsBuildDefaults(),
                 ...esbuild,
                 format: moduleFormat,
                 outdir: moduleOutdir,
                 plugins: [
+                    ...pnpPlugins,
                     gjsifyPlugin({ debug: verbose, library: moduleFormat, exclude, reflection: typescript?.reflection, jsExtension: moduleOutExt }),
-                ]
+                ],
             }));
-            const mainFormat = mainOutdir.includes('/cjs') || mainOutExt === '.cjs' ? 'cjs' : 'esm';
+            const mainFormat = mainOutdir.includes("/cjs") || mainOutExt === ".cjs" ? "cjs" : "esm";
             results.push(await build({
                 ...this.getEsBuildDefaults(),
                 ...esbuild,
                 format: moduleFormat,
                 outdir: mainOutdir,
                 plugins: [
-                    gjsifyPlugin({ debug: verbose, library: mainFormat, exclude, reflection: typescript?.reflection, jsExtension: mainOutdir })
-                ]
+                    ...pnpPlugins,
+                    gjsifyPlugin({ debug: verbose, library: mainFormat, exclude, reflection: typescript?.reflection, jsExtension: mainOutdir }),
+                ],
             }));
         }
         else {
             const outfilePath = esbuild?.outfile || library?.module || library?.main;
-            const outExt = outfilePath ? extname(outfilePath) : '.js';
+            const outExt = outfilePath ? extname(outfilePath) : ".js";
             const outdir = esbuild?.outdir || (outfilePath ? dirname(outfilePath) : undefined);
-            const format = esbuild?.format ?? (outdir?.includes('/cjs') || outExt === '.cjs' ? 'cjs' : 'esm');
+            const format = esbuild?.format ?? (outdir?.includes("/cjs") || outExt === ".cjs" ? "cjs" : "esm");
             results.push(await build({
                 ...this.getEsBuildDefaults(),
                 ...esbuild,
                 format,
                 outdir,
                 plugins: [
-                    gjsifyPlugin({ debug: verbose, library: format, exclude, reflection: typescript?.reflection, jsExtension: outExt })
-                ]
+                    ...pnpPlugins,
+                    gjsifyPlugin({ debug: verbose, library: format, exclude, reflection: typescript?.reflection, jsExtension: outExt }),
+                ],
             }));
         }
         return results;
@@ -130,12 +164,12 @@ export class BuildAction {
             console.debug(`[gjsify] --shebang: wrote shebang + chmod 0o755 to ${outfile}`);
     }
     /** Application mode */
-    async buildApp(app = 'gjs') {
-        const { verbose, esbuild, typescript, exclude, library: pgk, aliases } = this.configData;
-        const format = esbuild?.format ?? (esbuild?.outfile?.endsWith('.cjs') ? 'cjs' : 'esm');
+    async buildApp(app = "gjs") {
+        const { verbose, esbuild, typescript, exclude, library: pgk, aliases, excludeGlobals } = this.configData;
+        const format = esbuild?.format ?? (esbuild?.outfile?.endsWith(".cjs") ? "cjs" : "esm");
         // Set default outfile if no outdir is set
         if (esbuild && !esbuild?.outfile && !esbuild?.outdir && (pgk?.main || pgk?.module)) {
-            esbuild.outfile = esbuild?.format === 'cjs' ? pgk.main || pgk.module : pgk.module || pgk.main;
+            esbuild.outfile = esbuild?.format === "cjs" ? pgk.main || pgk.module : pgk.module || pgk.main;
         }
         const { consoleShim, globals } = this.configData;
         const pluginOpts = {
@@ -148,44 +182,46 @@ export class BuildAction {
             ...(aliases ? { aliases } : {}),
         };
         const { autoMode, extras } = this.parseGlobalsValue(globals);
+        const pnpPlugin = await getPnpPlugin();
+        const pnpPlugins = pnpPlugin ? [pnpPlugin] : [];
         // --- Auto mode (with optional extras): iterative multi-pass build ---
         // The extras token is used for cases where the detector cannot
         // statically see a global (e.g. Excalibur indirects globalThis via
         // BrowserComponent.nativeComponent). Common pattern: --globals auto,dom
-        if (app === 'gjs' && autoMode) {
-            const { injectPath } = await detectAutoGlobals({ ...this.getEsBuildDefaults(), ...esbuild, format }, pluginOpts, verbose, { extraGlobalsList: extras });
+        if (app === "gjs" && autoMode) {
+            const { injectPath } = await detectAutoGlobals({ ...this.getEsBuildDefaults(), ...esbuild, format, plugins: pnpPlugins }, pluginOpts, verbose, { extraGlobalsList: extras, excludeGlobals });
             const result = await build({
                 ...this.getEsBuildDefaults(),
                 ...esbuild,
                 format,
                 plugins: [
+                    ...pnpPlugins,
                     gjsifyPlugin({
                         ...pluginOpts,
                         autoGlobalsInject: injectPath,
                     }),
                 ],
             });
-            if (app === 'gjs' && this.configData.shebang) {
+            if (app === "gjs" && this.configData.shebang) {
                 await this.applyShebang(esbuild?.outfile, verbose);
             }
             return [result];
         }
         // --- Explicit list (no `auto` token) or none mode ---
-        const autoGlobalsInject = extras
-            ? await this.resolveGlobalsInject(app, extras, verbose)
-            : undefined;
+        const autoGlobalsInject = extras ? await this.resolveGlobalsInject(app, extras, verbose) : undefined;
         const result = await build({
             ...this.getEsBuildDefaults(),
             ...esbuild,
             format,
             plugins: [
+                ...pnpPlugins,
                 gjsifyPlugin({
                     ...pluginOpts,
                     autoGlobalsInject,
                 }),
-            ]
+            ],
         });
-        if (app === 'gjs' && this.configData.shebang) {
+        if (app === "gjs" && this.configData.shebang) {
             await this.applyShebang(esbuild?.outfile, verbose);
         }
         return [result];

package/lib/commands/build.js

@@ -117,6 +117,11 @@ export const buildCommand = {
             type: 'string',
             default: [],
             coerce: (arg) => arg.flatMap((v) => v.split(',').map((s) => s.trim()).filter(Boolean)),
+        })
+            .option('exclude-globals', {
+            description: "Comma-separated global identifiers to remove from auto-detection results. Use for false positives from dead browser-compat code whose polyfills require unavailable native libraries (e.g. --exclude-globals fetch,XMLHttpRequest).",
+            type: 'string',
+            normalize: true,
         });
     },
     handler: async (args) => {

package/lib/config.js

@@ -73,6 +73,14 @@ export class Config {
             configData.globals = cliArgs.globals;
         if (cliArgs.shebang !== undefined)
             configData.shebang = cliArgs.shebang;
+        if (cliArgs.excludeGlobals) {
+            const raw = Array.isArray(cliArgs.excludeGlobals)
+                ? cliArgs.excludeGlobals.join(',')
+                : String(cliArgs.excludeGlobals);
+            const ids = raw.split(',').map((s) => s.trim()).filter(Boolean);
+            if (ids.length)
+                configData.excludeGlobals = [...(configData.excludeGlobals ?? []), ...ids];
+        }
         merge(configData.library ??= {}, pkg, configData.library);
         merge(configData.typescript ??= {}, tsConfig, configData.typescript);
         // Parse `KEY=VALUE` style flags into Record<string, string>.

package/lib/types/cli-build-options.d.ts

@@ -89,4 +89,11 @@ export interface CliBuildOptions {
      * scenario never executes). Layered on top of the built-in alias map.
      */
     alias?: string[];
+    /**
+     * Comma-separated global identifiers to remove from the auto-detected set.
+     * Useful for false positives from dead browser-compat code in npm deps
+     * whose polyfills require unavailable native libraries.
+     * Example: `--exclude-globals fetch,XMLHttpRequest`
+     */
+    excludeGlobals?: string[];
 }

package/lib/types/config-data.d.ts

@@ -27,4 +27,11 @@ export interface ConfigData {
      * Comes from `gjsify build --alias FROM=TO`.
      */
     aliases?: Record<string, string>;
+    /**
+     * Global identifiers to remove from the auto-detected set before writing
+     * the inject stub. Useful for false positives from dead browser-compat
+     * code in npm dependencies whose polyfills require unavailable native libs.
+     * Example: `["fetch", "XMLHttpRequest"]` excludes the HTTP polyfill stack.
+     */
+    excludeGlobals?: string[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gjsify/cli",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "CLI for Gjsify",
   "type": "module",
   "main": "lib/index.js",
@@ -23,15 +23,16 @@
     "cli"
   ],
   "dependencies": {
-    "@gjsify/create-app": "^0.3.1",
-    "@gjsify/esbuild-plugin-gjsify": "^0.3.1",
-    "@gjsify/example-dom-canvas2d-fireworks": "^0.3.1",
-    "@gjsify/example-dom-excalibur-jelly-jumper": "^0.3.1",
-    "@gjsify/example-dom-three-geometry-teapot": "^0.3.1",
-    "@gjsify/example-dom-three-postprocessing-pixel": "^0.3.1",
-    "@gjsify/example-node-express-webserver": "^0.3.1",
-    "@gjsify/node-polyfills": "^0.3.1",
-    "@gjsify/web-polyfills": "^0.3.1",
+    "@gjsify/create-app": "^0.3.2",
+    "@gjsify/esbuild-plugin-gjsify": "^0.3.2",
+    "@gjsify/example-dom-canvas2d-fireworks": "^0.3.2",
+    "@gjsify/example-dom-excalibur-jelly-jumper": "^0.3.2",
+    "@gjsify/example-dom-three-geometry-teapot": "^0.3.2",
+    "@gjsify/example-dom-three-postprocessing-pixel": "^0.3.2",
+    "@gjsify/example-node-express-webserver": "^0.3.2",
+    "@gjsify/node-polyfills": "^0.3.2",
+    "@gjsify/web-polyfills": "^0.3.2",
+    "@yarnpkg/esbuild-plugin-pnp": "^3.0.0-rc.15",
     "cosmiconfig": "^9.0.1",
     "esbuild": "^0.28.0",
     "get-tsconfig": "^4.14.0",

package/src/actions/build.ts

@@ -1,12 +1,39 @@
 import type { ConfigData } from '../types/index.js';
 import type { App } from '@gjsify/esbuild-plugin-gjsify';
-import { build, BuildOptions, BuildResult } from 'esbuild';
+import { build, BuildOptions, BuildResult, Plugin } from 'esbuild';
 import { gjsifyPlugin } from '@gjsify/esbuild-plugin-gjsify';
 import { resolveGlobalsList, writeRegisterInjectFile, detectAutoGlobals } from '@gjsify/esbuild-plugin-gjsify/globals';
-import { dirname, extname } from 'node:path';
+import { dirname, extname, join } from 'node:path';
 import { chmod, readFile, writeFile } from 'node:fs/promises';
-
-const GJS_SHEBANG = '#!/usr/bin/env -S gjs -m\n';
+import { existsSync } from 'node:fs';
+
+const GJS_SHEBANG = "#!/usr/bin/env -S gjs -m\n";
+
+/** Walk up from dir until .pnp.cjs is found; return its directory or null. */
+function findPnpRoot(dir: string): string | null {
+    let current = dir;
+    while (true) {
+        if (existsSync(join(current, ".pnp.cjs"))) return current;
+        const parent = dirname(current);
+        if (parent === current) return null;
+        current = parent;
+    }
+}
+
+/**
+ * If the current project uses Yarn PnP, return the official
+ * @yarnpkg/esbuild-plugin-pnp plugin so esbuild can resolve
+ * modules from zip archives without manual extraction.
+ */
+async function getPnpPlugin(): Promise<Plugin | null> {
+    if (!findPnpRoot(process.cwd())) return null;
+    try {
+        const { pnpPlugin } = await import("@yarnpkg/esbuild-plugin-pnp");
+        return pnpPlugin();
+    } catch {
+        return null;
+    }
+}
 
 export class BuildAction {
     constructor(readonly configData: ConfigData = {}) {
@@ -30,50 +57,61 @@ export class BuildAction {
         const moduleOutdir = library?.module ? dirname(library.module) : undefined;
         const mainOutdir = library?.main ? dirname(library.main) : undefined;
 
-        const moduleOutExt = library.module ? extname(library.module) : '.js';
-        const mainOutExt = library.main ? extname(library.main) : '.js';
+        const moduleOutExt = library.module ? extname(library.module) : ".js";
+        const mainOutExt = library.main ? extname(library.main) : ".js";
 
-        const multipleBuilds = moduleOutdir && mainOutdir && (moduleOutdir !== mainOutdir);
+        const multipleBuilds = moduleOutdir && mainOutdir && moduleOutdir !== mainOutdir;
+
+        const pnpPlugin = await getPnpPlugin();
+        const pnpPlugins: Plugin[] = pnpPlugin ? [pnpPlugin] : [];
 
         const results: BuildResult[] = [];
-    
-        if(multipleBuilds) {
 
-            const moduleFormat = moduleOutdir.includes('/cjs') || moduleOutExt === '.cjs' ? 'cjs' : 'esm';
-            results.push(await build({
-                ...this.getEsBuildDefaults(),
-                ...esbuild,
-                format: moduleFormat,
-                outdir: moduleOutdir,
-                plugins: [
-                    gjsifyPlugin({debug: verbose, library: moduleFormat, exclude, reflection: typescript?.reflection, jsExtension: moduleOutExt}),
-                ]
-            }));
-    
-            const mainFormat = mainOutdir.includes('/cjs') || mainOutExt === '.cjs' ? 'cjs' : 'esm';
-            results.push(await build({
-                ...this.getEsBuildDefaults(),
-                ...esbuild,
-                format: moduleFormat,
-                outdir: mainOutdir,
-                plugins: [
-                    gjsifyPlugin({debug: verbose, library: mainFormat, exclude, reflection: typescript?.reflection, jsExtension: mainOutdir})
-                ]
-            }));
+        if (multipleBuilds) {
+            const moduleFormat = moduleOutdir.includes("/cjs") || moduleOutExt === ".cjs" ? "cjs" : "esm";
+            results.push(
+                await build({
+                    ...this.getEsBuildDefaults(),
+                    ...esbuild,
+                    format: moduleFormat,
+                    outdir: moduleOutdir,
+                    plugins: [
+                        ...pnpPlugins,
+                        gjsifyPlugin({ debug: verbose, library: moduleFormat, exclude, reflection: typescript?.reflection, jsExtension: moduleOutExt }),
+                    ],
+                }),
+            );
+
+            const mainFormat = mainOutdir.includes("/cjs") || mainOutExt === ".cjs" ? "cjs" : "esm";
+            results.push(
+                await build({
+                    ...this.getEsBuildDefaults(),
+                    ...esbuild,
+                    format: moduleFormat,
+                    outdir: mainOutdir,
+                    plugins: [
+                        ...pnpPlugins,
+                        gjsifyPlugin({ debug: verbose, library: mainFormat, exclude, reflection: typescript?.reflection, jsExtension: mainOutdir }),
+                    ],
+                }),
+            );
         } else {
             const outfilePath = esbuild?.outfile || library?.module || library?.main;
-            const outExt = outfilePath ? extname(outfilePath) : '.js';
+            const outExt = outfilePath ? extname(outfilePath) : ".js";
             const outdir = esbuild?.outdir || (outfilePath ? dirname(outfilePath) : undefined);
-            const format: 'esm' | 'cjs' = (esbuild?.format as 'esm' | 'cjs') ?? (outdir?.includes('/cjs') || outExt === '.cjs' ? 'cjs' : 'esm');
-            results.push(await build({
-                ...this.getEsBuildDefaults(),
-                ...esbuild,
-                format,
-                outdir,
-                plugins: [
-                    gjsifyPlugin({debug: verbose, library: format, exclude, reflection: typescript?.reflection, jsExtension: outExt})
-                ]
-            }));
+            const format: "esm" | "cjs" = (esbuild?.format as "esm" | "cjs") ?? (outdir?.includes("/cjs") || outExt === ".cjs" ? "cjs" : "esm");
+            results.push(
+                await build({
+                    ...this.getEsBuildDefaults(),
+                    ...esbuild,
+                    format,
+                    outdir,
+                    plugins: [
+                        ...pnpPlugins,
+                        gjsifyPlugin({ debug: verbose, library: format, exclude, reflection: typescript?.reflection, jsExtension: outExt }),
+                    ],
+                }),
+            );
         }
         return results;
     }
@@ -147,15 +185,14 @@ export class BuildAction {
     }
 
     /** Application mode */
-    async buildApp(app: App = 'gjs') {
+    async buildApp(app: App = "gjs") {
+        const { verbose, esbuild, typescript, exclude, library: pgk, aliases, excludeGlobals } = this.configData;
 
-        const { verbose, esbuild, typescript, exclude, library: pgk, aliases } = this.configData;
-
-        const format: 'esm' | 'cjs' = (esbuild?.format as 'esm' | 'cjs') ?? (esbuild?.outfile?.endsWith('.cjs') ? 'cjs' : 'esm');
+        const format: "esm" | "cjs" = (esbuild?.format as "esm" | "cjs") ?? (esbuild?.outfile?.endsWith(".cjs") ? "cjs" : "esm");
 
         // Set default outfile if no outdir is set
-        if(esbuild && !esbuild?.outfile && !esbuild?.outdir && (pgk?.main || pgk?.module)) {
-            esbuild.outfile = esbuild?.format === 'cjs' ? pgk.main || pgk.module : pgk.module || pgk.main;
+        if (esbuild && !esbuild?.outfile && !esbuild?.outdir && (pgk?.main || pgk?.module)) {
+            esbuild.outfile = esbuild?.format === "cjs" ? pgk.main || pgk.module : pgk.module || pgk.main;
         }
 
         const { consoleShim, globals } = this.configData;
@@ -172,16 +209,19 @@ export class BuildAction {
 
         const { autoMode, extras } = this.parseGlobalsValue(globals);
 
+        const pnpPlugin = await getPnpPlugin();
+        const pnpPlugins: Plugin[] = pnpPlugin ? [pnpPlugin] : [];
+
         // --- Auto mode (with optional extras): iterative multi-pass build ---
         // The extras token is used for cases where the detector cannot
         // statically see a global (e.g. Excalibur indirects globalThis via
         // BrowserComponent.nativeComponent). Common pattern: --globals auto,dom
-        if (app === 'gjs' && autoMode) {
+        if (app === "gjs" && autoMode) {
             const { injectPath } = await detectAutoGlobals(
-                { ...this.getEsBuildDefaults(), ...esbuild, format },
+                { ...this.getEsBuildDefaults(), ...esbuild, format, plugins: pnpPlugins },
                 pluginOpts,
                 verbose,
-                { extraGlobalsList: extras },
+                { extraGlobalsList: extras, excludeGlobals },
             );
 
             const result = await build({
@@ -189,6 +229,7 @@ export class BuildAction {
                 ...esbuild,
                 format,
                 plugins: [
+                    ...pnpPlugins,
                     gjsifyPlugin({
                         ...pluginOpts,
                         autoGlobalsInject: injectPath,
@@ -196,7 +237,7 @@ export class BuildAction {
                 ],
             });
 
-            if (app === 'gjs' && this.configData.shebang) {
+            if (app === "gjs" && this.configData.shebang) {
                 await this.applyShebang(esbuild?.outfile, verbose);
             }
 
@@ -204,23 +245,22 @@ export class BuildAction {
         }
 
         // --- Explicit list (no `auto` token) or none mode ---
-        const autoGlobalsInject = extras
-            ? await this.resolveGlobalsInject(app, extras, verbose)
-            : undefined;
+        const autoGlobalsInject = extras ? await this.resolveGlobalsInject(app, extras, verbose) : undefined;
 
         const result = await build({
             ...this.getEsBuildDefaults(),
             ...esbuild,
             format,
             plugins: [
+                ...pnpPlugins,
                 gjsifyPlugin({
                     ...pluginOpts,
                     autoGlobalsInject,
                 }),
-            ]
+            ],
         });
 
-        if (app === 'gjs' && this.configData.shebang) {
+        if (app === "gjs" && this.configData.shebang) {
             await this.applyShebang(esbuild?.outfile, verbose);
         }
 

package/src/commands/build.ts

@@ -120,6 +120,11 @@ export const buildCommand: Command<any, CliBuildOptions> = {
                 default: [] as string[],
                 coerce: (arg: string[]) => arg.flatMap((v) => v.split(',').map((s) => s.trim()).filter(Boolean)),
             })
+            .option('exclude-globals', {
+                description: "Comma-separated global identifiers to remove from auto-detection results. Use for false positives from dead browser-compat code whose polyfills require unavailable native libraries (e.g. --exclude-globals fetch,XMLHttpRequest).",
+                type: 'string',
+                normalize: true,
+            })
     },
     handler: async (args) => {
         const config = new Config();

package/src/config.ts

@@ -84,6 +84,13 @@ export class Config {
         if (cliArgs.consoleShim !== undefined) configData.consoleShim = cliArgs.consoleShim;
         if (cliArgs.globals !== undefined) configData.globals = cliArgs.globals;
         if (cliArgs.shebang !== undefined) configData.shebang = cliArgs.shebang;
+        if (cliArgs.excludeGlobals) {
+            const raw = Array.isArray(cliArgs.excludeGlobals)
+                ? cliArgs.excludeGlobals.join(',')
+                : String(cliArgs.excludeGlobals);
+            const ids = raw.split(',').map((s: string) => s.trim()).filter(Boolean);
+            if (ids.length) configData.excludeGlobals = [...(configData.excludeGlobals ?? []), ...ids];
+        }
 
         merge(configData.library ??= {}, pkg, configData.library);
         merge(configData.typescript ??= {}, tsConfig, configData.typescript);

package/src/types/cli-build-options.ts

@@ -90,4 +90,11 @@ export interface CliBuildOptions {
    * scenario never executes). Layered on top of the built-in alias map.
    */
   alias?: string[];
+  /**
+   * Comma-separated global identifiers to remove from the auto-detected set.
+   * Useful for false positives from dead browser-compat code in npm deps
+   * whose polyfills require unavailable native libraries.
+   * Example: `--exclude-globals fetch,XMLHttpRequest`
+   */
+  excludeGlobals?: string[];
 }

package/src/types/config-data.ts

@@ -28,4 +28,11 @@ export interface ConfigData {
      * Comes from `gjsify build --alias FROM=TO`.
      */
     aliases?: Record<string, string>;
+    /**
+     * Global identifiers to remove from the auto-detected set before writing
+     * the inject stub. Useful for false positives from dead browser-compat
+     * code in npm dependencies whose polyfills require unavailable native libs.
+     * Example: `["fetch", "XMLHttpRequest"]` excludes the HTTP polyfill stack.
+     */
+    excludeGlobals?: string[];
 }