@gjsify/cli 0.3.21 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gjsify/cli",
-  "version": "0.3.21",
+  "version": "0.4.0",
   "description": "CLI for Gjsify",
   "type": "module",
   "main": "lib/index.js",
@@ -9,12 +9,26 @@
   "bin": {
     "gjsify": "./lib/index.js"
   },
+  "gjsify": {
+    "bin": {
+      "gjsify": "./dist/cli.gjs.mjs"
+    }
+  },
+  "files": [
+    "lib",
+    "dist/cli.gjs.mjs",
+    "showcases.json"
+  ],
   "scripts": {
-    "clear": "rm -rf lib tsconfig.tsbuildinfo || exit 0",
+    "clear": "rm -rf lib dist tsconfig.tsbuildinfo || exit 0",
     "check": "tsc --noEmit",
     "start": "node lib/index.js",
     "build": "tsc && yarn chmod",
-    "chmod": "chmod +x ./lib/index.js"
+    "build:gjs-bundle": "node lib/index.js build src/index.ts --app gjs --outfile dist/cli.gjs.mjs",
+    "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": "yarn build:test:node && yarn test:node"
   },
   "keywords": [
     "gjs",
@@ -23,15 +37,16 @@
     "cli"
   ],
   "dependencies": {
-    "@gjsify/create-app": "^0.3.21",
-    "@gjsify/node-polyfills": "^0.3.21",
-    "@gjsify/npm-registry": "^0.3.21",
-    "@gjsify/resolve-npm": "^0.3.21",
-    "@gjsify/rolldown-plugin-gjsify": "^0.3.21",
-    "@gjsify/rolldown-plugin-pnp": "^0.3.21",
-    "@gjsify/semver": "^0.3.21",
-    "@gjsify/tar": "^0.3.21",
-    "@gjsify/web-polyfills": "^0.3.21",
+    "@gjsify/create-app": "^0.4.0",
+    "@gjsify/node-polyfills": "^0.4.0",
+    "@gjsify/npm-registry": "^0.4.0",
+    "@gjsify/resolve-npm": "^0.4.0",
+    "@gjsify/rolldown-plugin-gjsify": "^0.4.0",
+    "@gjsify/rolldown-plugin-pnp": "^0.4.0",
+    "@gjsify/semver": "^0.4.0",
+    "@gjsify/tar": "^0.4.0",
+    "@gjsify/web-polyfills": "^0.4.0",
+    "@gjsify/workspace": "^0.4.0",
     "cosmiconfig": "^9.0.1",
     "get-tsconfig": "^4.14.0",
     "pkg-types": "^2.3.1",
@@ -39,7 +54,16 @@
     "yargs": "^18.0.0"
   },
   "devDependencies": {
+    "@gjsify/unit": "^0.4.0",
     "@types/yargs": "^17.0.35",
     "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "@gjsify/rolldown-native": "^0.4.0"
+  },
+  "peerDependenciesMeta": {
+    "@gjsify/rolldown-native": {
+      "optional": true
+    }
   }
 }

package/src/actions/build.ts

@@ -1,431 +0,0 @@
-import type { ConfigData, BundlerOptions } from "../types/index.js";
-import type { App, PluginOptions } from "@gjsify/rolldown-plugin-gjsify";
-import type { RolldownOutput, RolldownPluginOption } from "rolldown";
-import { rolldown } from "rolldown";
-import { gjsifyPlugin, textLoaderPlugin, resolveShebangLine } from "@gjsify/rolldown-plugin-gjsify";
-import { resolveUserPlugins } from "../utils/resolve-plugin-by-name.js";
-import {
-    resolveGlobalsList,
-    writeRegisterInjectFile,
-    detectAutoGlobals,
-} from "@gjsify/rolldown-plugin-gjsify/globals";
-import { pnpPlugin } from "@gjsify/rolldown-plugin-pnp";
-import { dirname, extname } from "node:path";
-import { chmod, readFile, writeFile } from "node:fs/promises";
-import { normalizeBundlerOptions, mergeBundlerOptions } from "../utils/normalize-bundler-options.js";
-
-const DEFAULT_GJS_SHEBANG = "#!/usr/bin/env -S gjs -m";
-
-/**
- * `true` when `path` points at a location that's unsafe to use as a build
- * outfile (would overwrite source). Currently catches:
- *   - any TypeScript extension (`.ts`, `.tsx`, `.mts`, `.cts`, `.mtsx`, `.ctsx`)
- *   - paths that live under a `src/` segment (relative or absolute)
- */
-function isUnsafeDefaultOutput(path: string): boolean {
-    if (/\.[cm]?tsx?$/i.test(path)) return true;
-    const norm = path.replace(/\\/g, "/");
-    if (/(?:^|\/)src\//.test(norm)) return true;
-    return false;
-}
-
-/**
- * Resolve the gjsify-flavoured PnP plugin. Anchors the relay on this file's
- * URL so transitive `@gjsify/*` polyfills (reached via @gjsify/cli's deps on
- * @gjsify/{node,web}-polyfills) are resolvable for external consumers without
- * each one having to be a direct devDep.
- *
- * The path rewriter (`__filename`/`__dirname` + `import.meta.url` injection
- * for node_modules code) is registered separately by the orchestrator —
- * Rolldown's transform hooks all run sequentially, no shared `onLoad` race.
- */
-async function buildPnpPlugin(): Promise<RolldownPluginOption | null> {
-    return pnpPlugin({ issuerUrl: import.meta.url });
-}
-
-export class BuildAction {
-    constructor(readonly configData: ConfigData = {}) {}
-
-    /** Library mode */
-    async buildLibrary(): Promise<RolldownOutput[]> {
-        const { verbose, library, typescript, exclude, aliases } = this.configData;
-        const lib = library ?? {};
-        const userBundler = normalizeBundlerOptions(this.configData);
-
-        const moduleOutdir = lib.module ? dirname(lib.module) : undefined;
-        const mainOutdir = lib.main ? dirname(lib.main) : undefined;
-
-        const moduleOutExt = lib.module ? extname(lib.module) : ".js";
-        const mainOutExt = lib.main ? extname(lib.main) : ".js";
-
-        const multipleBuilds =
-            moduleOutdir && mainOutdir && moduleOutdir !== mainOutdir;
-
-        const pnp = await buildPnpPlugin();
-        const pnpPlugins: RolldownPluginOption[] = pnp ? [pnp] : [];
-
-        const results: RolldownOutput[] = [];
-
-        if (multipleBuilds) {
-            const moduleFormat: "esm" | "cjs" =
-                moduleOutdir.includes("/cjs") || moduleOutExt === ".cjs"
-                    ? "cjs"
-                    : "esm";
-            results.push(
-                await runOneLibraryBuild({
-                    pluginOpts: {
-                        debug: verbose,
-                        library: moduleFormat,
-                        exclude,
-                        reflection: typescript?.reflection,
-                        jsExtension: moduleOutExt,
-                    },
-                    userBundler,
-                    output: { dir: moduleOutdir },
-                    userAliases: aliases,
-                    pnpPlugins,
-                }),
-            );
-
-            const mainFormat: "esm" | "cjs" =
-                mainOutdir.includes("/cjs") || mainOutExt === ".cjs" ? "cjs" : "esm";
-            results.push(
-                await runOneLibraryBuild({
-                    pluginOpts: {
-                        debug: verbose,
-                        library: mainFormat,
-                        exclude,
-                        reflection: typescript?.reflection,
-                        jsExtension: mainOutExt,
-                    },
-                    userBundler,
-                    output: { dir: mainOutdir },
-                    userAliases: aliases,
-                    pnpPlugins,
-                }),
-            );
-        } else {
-            const outfilePath =
-                userBundler.output?.file ?? lib.module ?? lib.main;
-            const outExt = outfilePath ? extname(outfilePath) : ".js";
-            const outdir =
-                userBundler.output?.dir ?? (outfilePath ? dirname(outfilePath) : undefined);
-            const format: "esm" | "cjs" =
-                (userBundler.output?.format as "esm" | "cjs" | undefined) ??
-                (outdir?.includes("/cjs") || outExt === ".cjs" ? "cjs" : "esm");
-            results.push(
-                await runOneLibraryBuild({
-                    pluginOpts: {
-                        debug: verbose,
-                        library: format,
-                        exclude,
-                        reflection: typescript?.reflection,
-                        jsExtension: outExt,
-                    },
-                    userBundler,
-                    output: { dir: outdir },
-                    userAliases: aliases,
-                    pnpPlugins,
-                }),
-            );
-        }
-        return results;
-    }
-
-    /**
-     * Parse the `--globals` value into { autoMode, extras }.
-     * - `auto`             → { autoMode: true, extras: '' }
-     * - `auto,dom`         → { autoMode: true, extras: 'dom' }
-     * - `auto,dom,fetch`   → { autoMode: true, extras: 'dom,fetch' }
-     * - `dom,fetch`        → { autoMode: false, extras: 'dom,fetch' }
-     * - `none` / ``        → { autoMode: false, extras: '' }
-     * - `undefined`        → { autoMode: true, extras: '' }  (default)
-     */
-    private parseGlobalsValue(value: string | undefined): {
-        autoMode: boolean;
-        extras: string;
-    } {
-        if (value === undefined) return { autoMode: true, extras: "" };
-        if (value === "none" || value === "")
-            return { autoMode: false, extras: "" };
-
-        const tokens = value
-            .split(",")
-            .map((t) => t.trim())
-            .filter(Boolean);
-        const hasAuto = tokens.includes("auto");
-        const extras = tokens.filter((t) => t !== "auto").join(",");
-
-        return { autoMode: hasAuto, extras };
-    }
-
-    /**
-     * Resolve the `--globals` CLI list into a pre-computed inject stub path
-     * that the orchestrator appends to its input list. Only runs for
-     * `--app gjs` — Node and browser builds rely on native globals.
-     *
-     * Used only for the explicit-only path (no `auto` token in the value).
-     * The auto path is handled in `buildApp` via the iterative multi-pass build.
-     */
-    private async resolveGlobalsInject(
-        app: App,
-        globals: string,
-        verbose: boolean | undefined,
-    ): Promise<string | undefined> {
-        if (app !== "gjs") return undefined;
-        if (!globals) return undefined;
-
-        const registerPaths = resolveGlobalsList(globals);
-        if (registerPaths.size === 0) return undefined;
-
-        const injectPath = await writeRegisterInjectFile(
-            registerPaths,
-            process.cwd(),
-        );
-        if (verbose && injectPath) {
-            console.debug(
-                `[gjsify] globals: injected ${registerPaths.size} register module(s) from --globals ${globals}`,
-            );
-        }
-        return injectPath ?? undefined;
-    }
-
-    /**
-     * Post-processing: prepend the resolved shebang line and mark the
-     * output executable. Only runs for GJS app builds with a single outfile.
-     * The shebang plugin in `@gjsify/rolldown-plugin-gjsify` already injects
-     * during bundling — this hook is the safety net for anything that
-     * bypassed the plugin (e.g. user-supplied banners that out-ordered it),
-     * plus the chmod.
-     */
-    private async applyShebang(
-        outfile: string | undefined,
-        verbose: boolean | undefined,
-    ): Promise<void> {
-        if (!outfile) {
-            if (verbose)
-                console.warn(
-                    "[gjsify] --shebang skipped: no single outfile (use --outfile for GJS executables)",
-                );
-            return;
-        }
-
-        const line = resolveShebangLine(this.configData.shebang) ?? DEFAULT_GJS_SHEBANG;
-
-        const content = await readFile(outfile, "utf-8");
-        if (content.startsWith("#!")) {
-            if (verbose)
-                console.debug(
-                    `[gjsify] --shebang skipped: ${outfile} already starts with a shebang`,
-                );
-        } else {
-            await writeFile(outfile, line + "\n" + content);
-        }
-        await chmod(outfile, 0o755);
-        if (verbose)
-            console.debug(
-                `[gjsify] --shebang: wrote ${line} + chmod 0o755 to ${outfile}`,
-            );
-    }
-
-    /** Application mode */
-    async buildApp(app: App = "gjs"): Promise<RolldownOutput[]> {
-        const {
-            verbose,
-            typescript,
-            exclude,
-            library: pkg,
-            aliases,
-            excludeGlobals,
-        } = this.configData;
-
-        const userBundler = normalizeBundlerOptions(this.configData);
-
-        const formatRaw =
-            (userBundler.output?.format as "esm" | "cjs" | "iife" | undefined) ??
-            (userBundler.output?.file?.endsWith(".cjs") ? "cjs" : "esm");
-        // The orchestrator only handles esm/cjs (iife is not a GJS / Node /
-        // browser-bundle target we support). Coerce.
-        const format: "esm" | "cjs" = formatRaw === "iife" ? "esm" : formatRaw;
-
-        // Set default outfile if no outdir is set
-        let outfile = userBundler.output?.file;
-        let outdir = userBundler.output?.dir;
-        if (!outfile && !outdir && (pkg?.main || pkg?.module)) {
-            const candidate =
-                format === "cjs"
-                    ? pkg.main ?? pkg.module
-                    : pkg.module ?? pkg.main;
-            if (candidate && isUnsafeDefaultOutput(candidate)) {
-                throw new Error(
-                    `gjsify build: refusing to default --outfile to ${candidate} ` +
-                        `(would overwrite a TypeScript source file). Pass --outfile/--outdir ` +
-                        `explicitly, or set "gjsify.bundler.output.file" in package.json.`,
-                );
-            }
-            outfile = candidate;
-        }
-
-        const { consoleShim, globals } = this.configData;
-
-        const userExternal = Array.isArray(userBundler.external)
-            ? (userBundler.external as string[])
-            : undefined;
-        const userBanner = typeof userBundler.output?.banner === "string"
-            ? (userBundler.output.banner as string)
-            : undefined;
-
-        const pluginOpts: PluginOptions = {
-            debug: verbose,
-            app,
-            format,
-            exclude,
-            reflection: typescript?.reflection,
-            consoleShim,
-            ...(aliases ? { aliases } : {}),
-        };
-
-        const { autoMode, extras } = this.parseGlobalsValue(globals);
-
-        const pnp = await buildPnpPlugin();
-        const pnpPlugins: RolldownPluginOption[] = pnp ? [pnp] : [];
-
-        // User-supplied text loaders need to be available during BOTH the
-        // auto-globals pre-build (`detectAutoGlobals`) and the final build —
-        // otherwise Rolldown's parser hits unknown extensions like `.ui` /
-        // `.asm` during the pre-build, fails to parse them as JS/JSX, and
-        // the auto-globals iteration aborts before the final plugin chain is
-        // ever assembled. Build the user-plugin chain once, up front, and
-        // pass it into both passes.
-        const userTextLoader = textLoaderPlugin({ loaders: this.configData.loaders });
-        const userPlugins: RolldownPluginOption[] = userTextLoader ? [userTextLoader] : [];
-
-        // User-supplied bundler.plugins (mix of plugin objects + by-name
-        // entries) — resolved from the project's node_modules. Same
-        // ordering rationale as the text loader: must be present during
-        // auto-globals pre-build to avoid claiming the same files via
-        // Rolldown's default classifier.
-        if (userBundler.plugins?.length) {
-            const resolved = await resolveUserPlugins(userBundler.plugins, process.cwd());
-            userPlugins.push(...resolved);
-        }
-
-        // --- Auto mode (with optional extras): iterative multi-pass build ---
-        if (app === "gjs" && autoMode) {
-            const gjsifyPluginFactory = async (opts: PluginOptions) => {
-                const cfg = await gjsifyPlugin(
-                    {
-                        input: userBundler.input,
-                        output: { file: outfile, dir: outdir },
-                        userExternal,
-                        userBanner,
-                        userAliases: aliases,
-                        shebang: this.configData.shebang,
-                    },
-                    opts,
-                );
-                return cfg.plugins;
-            };
-
-            const { injectPath } = await detectAutoGlobals(
-                {
-                    input: userBundler.input,
-                    plugins: [...pnpPlugins, ...userPlugins],
-                    external: userBundler.external,
-                    transform: userBundler.transform,
-                    format,
-                },
-                pluginOpts,
-                gjsifyPluginFactory,
-                verbose,
-                { extraGlobalsList: extras, excludeGlobals },
-            );
-
-            pluginOpts.autoGlobalsInject = injectPath;
-        } else if (extras) {
-            pluginOpts.autoGlobalsInject = await this.resolveGlobalsInject(
-                app,
-                extras,
-                verbose,
-            );
-        }
-
-        // Final build: orchestrator → rolldown → write
-        const cfg = await gjsifyPlugin(
-            {
-                input: userBundler.input,
-                output: { file: outfile, dir: outdir },
-                userExternal,
-                userBanner,
-                userAliases: aliases,
-                shebang: this.configData.shebang,
-            },
-            pluginOpts,
-        );
-
-        const merged = mergeBundlerOptions(cfg.options as BundlerOptions, userBundler);
-
-        const finalOpts: BundlerOptions = {
-            ...merged,
-            // Drop user-config plugins from `merged` — they survived
-            // mergeBundlerOptions via spread but have already been resolved
-            // and appended into `userPlugins` above. Re-emitting the raw
-            // entries (which may include `BundlerPluginByName` shapes
-            // Rolldown doesn't understand) would crash the build.
-            plugins: [...pnpPlugins, ...userPlugins, ...cfg.plugins],
-        };
-
-        const build = await rolldown(finalOpts);
-        let writeResult: RolldownOutput;
-        try {
-            writeResult = await build.write(finalOpts.output ?? {});
-        } finally {
-            await build.close();
-        }
-
-        if (app === "gjs" && this.configData.shebang) {
-            await this.applyShebang(outfile, verbose);
-        }
-
-        return [writeResult];
-    }
-
-    async start(buildType: { library?: boolean; app?: App } = { app: "gjs" }) {
-        if (buildType.library) {
-            return await this.buildLibrary();
-        }
-        return await this.buildApp(buildType.app);
-    }
-}
-
-interface OneLibraryBuildArgs {
-    pluginOpts: PluginOptions;
-    userBundler: BundlerOptions;
-    output: { file?: string; dir?: string };
-    userAliases?: Record<string, string>;
-    pnpPlugins: RolldownPluginOption[];
-}
-
-async function runOneLibraryBuild(args: OneLibraryBuildArgs): Promise<RolldownOutput> {
-    const cfg = await gjsifyPlugin(
-        {
-            input: args.userBundler.input,
-            output: args.output,
-            userAliases: args.userAliases,
-        },
-        args.pluginOpts,
-    );
-
-    const merged = mergeBundlerOptions(cfg.options as BundlerOptions, args.userBundler);
-    const finalOpts: BundlerOptions = {
-        ...merged,
-        plugins: [...args.pnpPlugins, ...cfg.plugins],
-    };
-
-    const build = await rolldown(finalOpts);
-    try {
-        return await build.write(finalOpts.output ?? {});
-    } finally {
-        await build.close();
-    }
-}

package/src/actions/index.ts

@@ -1 +0,0 @@
-export * from './build.js';

package/src/commands/build.ts

@@ -1,146 +0,0 @@
-import { Config } from '../config.js';
-import { BuildAction } from '../actions/build.js';
-import type { Command, CliBuildOptions } from '../types/index.js';
-
-export const buildCommand: Command<any, CliBuildOptions> = {
-    command: 'build [entryPoints..]',
-    description: 'Build and bundle your Gjs project',
-    builder: (yargs) => {
-        return yargs
-            .option('entry-points', {
-                description: "The entry points you want to bundle. Defaults to bundler.input from package.json#gjsify or .gjsifyrc.js, falling back to src/index.ts when neither is set.",
-                array: true,
-                type: 'string',
-                normalize: true,
-                // No yargs `default` here on purpose. A yargs default value
-                // is indistinguishable from "user passed the flag" in the
-                // parsed args (cliArgs.entryPoints?.length is truthy either
-                // way), so the merge step in config.ts would unconditionally
-                // overwrite `bundler.input` declared in package.json#gjsify —
-                // silently ignoring `gjsify.bundler.input: "src/start.ts"`
-                // and producing a bundle from the wrong entry point. The
-                // fallback to src/index.ts is applied in config.ts AFTER
-                // merging with the cosmiconfig data.
-                defaultDescription: "src/index.ts (fallback)",
-                coerce: (arg: string[]) => {
-                    // Removes duplicates
-                    return [...new Set(arg)];
-                }
-            })
-            .option('exclude', {
-                description: "An array of glob patterns to exclude entry-points and aliases",
-                array: true,
-                type: 'string',
-                normalize: true,
-                default: []
-            })
-            .option('verbose', {
-                description: "Switch on the verbose mode",
-                type: 'boolean',
-                normalize: true,
-                default: false
-            })
-            .option('app', {
-                description: "Use this if you want to build an application, the platform node is usually only used for tests",
-                type: 'string',
-                choices: ['gjs', 'node', 'browser'],
-                normalize: true,
-                default: 'gjs'
-            })
-            .option('format', {
-                description: "Override the default output format",
-                type: 'string',
-                choices: ['iife', 'esm', 'cjs'],
-                normalize: true,
-            })
-            .option('minify', {
-                description: "Minify the bundled output. Defaults to true; use --no-minify to emit pretty-printed code (e.g. for debugging or readable bundle review).",
-                type: 'boolean',
-                normalize: true,
-                defaultDescription: 'true',
-            })
-            .option('library', {
-                description: "Use this if you want to build a library for Gjsify",
-                type: 'boolean',
-                normalize: true,
-                default: false
-            })
-            .option('outfile', {
-                alias: 'o',
-                description: "Sets the output file name for the build operation. If no outfile is specified, the outfile will be parsed from the package.json. Only used if application mode is active",
-                type: 'string',
-                normalize: true,
-            })
-            .option('outdir', {
-                alias: 'd',
-                description: "Sets the output directory for the build operation. If no outdir is specified, the outdir will be parsed from the package.json. Only used if library mode is active",
-                type: 'string',
-                normalize: true,
-            })
-            .option('reflection', {
-                alias: 'r',
-                description: "Enables TypeScript types on runtime using Deepkit's type compiler",
-                type: 'boolean',
-                normalize: true,
-                default: false
-            })
-            .option('log-level', {
-                description: "The log level can be changed to prevent esbuild from printing warning and/or error messages to the terminal",
-                type: 'string',
-                choices: ['silent', 'error', 'warning', 'info', 'debug', 'verbose'],
-                normalize: true,
-                default: 'warning'
-            })
-            .option('console-shim', {
-                description: "Inject a console shim into GJS builds for clean output without the GLib prefix and with working ANSI colors. Use --no-console-shim to disable. Only applies to GJS app builds.",
-                type: 'boolean',
-                normalize: true,
-                default: true
-            })
-            .option('globals', {
-                description: "Comma-separated list of global identifiers, 'auto' (default) to detect automatically from the bundled output, or 'none' to disable. The 'auto' token may be combined with explicit identifiers/groups (e.g. 'auto,dom') for cases where the detector cannot statically see a global because it's accessed via indirection. Each identifier is mapped to the corresponding `@gjsify/<pkg>/register` module and injected into the bundle. See the CLI Reference docs for the full list of known identifiers. Only applies to GJS app builds.",
-                type: 'string',
-                normalize: true,
-                default: 'auto'
-            })
-            .option('shebang', {
-                description: "Prepend a `#!/usr/bin/env -S gjs -m` shebang to the output and mark it executable (chmod 755). Only applies to GJS app builds with a single --outfile. Default: false (use --shebang to enable, or set `shebang: true` in `.gjsifyrc.js`).",
-                type: 'boolean',
-                normalize: true
-            })
-            .option('external', {
-                description: "Module names that should NOT be bundled. Repeat the flag or pass a comma-separated list (e.g. --external typedoc,prettier). Globs are forwarded to esbuild as-is. See https://esbuild.github.io/api/#external",
-                array: true,
-                type: 'string',
-                default: [] as string[],
-                coerce: (arg: string[]) => arg.flatMap((v) => v.split(',').map((s) => s.trim()).filter(Boolean)),
-            })
-            .option('define', {
-                description: "Substitute compile-time constants. Each entry is KEY=VALUE where VALUE is a JS expression (string literals must be quoted: --define VERSION='\"1.2.3\"'). Repeat the flag or pass comma-separated. See https://esbuild.github.io/api/#define",
-                array: true,
-                type: 'string',
-                default: [] as string[],
-            })
-            .option('alias', {
-                description: "Map module specifiers at bundle time. Each entry is FROM=TO (e.g. --alias typedoc=@gjsify/empty). Layered on top of the built-in alias map. Useful for stubbing heavy deps the test scenario never executes.",
-                array: true,
-                type: 'string',
-                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();
-        const configData = await config.forBuild(args);
-        const action = new BuildAction(configData);
-        await action.start({
-            library: args.library,
-            app: args.app,
-        })
-    }
-}