@gjsify/cli 0.4.28 → 0.4.30

package/lib/actions/barrels-generate.js

@@ -15,11 +15,7 @@
 import { readdir, readFile, writeFile } from 'node:fs/promises';
 import { basename, extname, join, resolve } from 'node:path';
 export const DEFAULT_BARRELS_HEADER = '// Auto-generated by `gjsify barrels` — do not edit by hand.';
-export const DEFAULT_BARRELS_EXCLUDES = [
-    '\\.test\\.',
-    '\\.spec\\.',
-    '\\.test-data\\.',
-];
+export const DEFAULT_BARRELS_EXCLUDES = ['\\.test\\.', '\\.spec\\.', '\\.test-data\\.'];
 const SOURCE_FILE_RE = /\.(ts|tsx|mts|cts)$/;
 /**
  * Regenerate `index.ts` in every directory in `args.paths`.

package/lib/actions/build.d.ts

@@ -1,6 +1,6 @@
-import type { ConfigData } from "../types/index.js";
-import type { App } from "@gjsify/rolldown-plugin-gjsify";
-import type { RolldownOutput } from "rolldown";
+import type { ConfigData } from '../types/index.js';
+import type { App } from '@gjsify/rolldown-plugin-gjsify';
+import type { RolldownOutput } from 'rolldown';
 export declare class BuildAction {
     readonly configData: ConfigData;
     constructor(configData?: ConfigData);

package/lib/actions/build.js

@@ -1,12 +1,12 @@
-import { runBundle, runWatch, bundleToChunks } from "../bundler-pick.js";
-import { gjsifyPlugin, textLoaderPlugin, resolveShebangLine, NODE_SHEBANG } 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";
+import { runBundle, runWatch, bundleToChunks } from '../bundler-pick.js';
+import { gjsifyPlugin, textLoaderPlugin, resolveShebangLine, NODE_SHEBANG } 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:
@@ -16,7 +16,7 @@ const DEFAULT_GJS_SHEBANG = "#!/usr/bin/env -S gjs -m";
 function isUnsafeDefaultOutput(path) {
     if (/\.[cm]?tsx?$/i.test(path))
         return true;
-    const norm = path.replace(/\\/g, "/");
+    const norm = path.replace(/\\/g, '/');
     if (/(?:^|\/)src\//.test(norm))
         return true;
     return false;
@@ -46,16 +46,14 @@ export class BuildAction {
         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 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 = pnp ? [pnp] : [];
         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 runOneLibraryBuild({
                 pluginOpts: {
                     debug: verbose,
@@ -69,7 +67,7 @@ export class BuildAction {
                 userAliases: aliases,
                 pnpPlugins,
             }));
-            const mainFormat = mainOutdir.includes("/cjs") || mainOutExt === ".cjs" ? "cjs" : "esm";
+            const mainFormat = mainOutdir.includes('/cjs') || mainOutExt === '.cjs' ? 'cjs' : 'esm';
             results.push(await runOneLibraryBuild({
                 pluginOpts: {
                     debug: verbose,
@@ -86,10 +84,10 @@ export class BuildAction {
         }
         else {
             const outfilePath = userBundler.output?.file ?? lib.module ?? lib.main;
-            const outExt = outfilePath ? extname(outfilePath) : ".js";
+            const outExt = outfilePath ? extname(outfilePath) : '.js';
             const outdir = userBundler.output?.dir ?? (outfilePath ? dirname(outfilePath) : undefined);
             const format = userBundler.output?.format ??
-                (outdir?.includes("/cjs") || outExt === ".cjs" ? "cjs" : "esm");
+                (outdir?.includes('/cjs') || outExt === '.cjs' ? 'cjs' : 'esm');
             results.push(await runOneLibraryBuild({
                 pluginOpts: {
                     debug: verbose,
@@ -117,15 +115,15 @@ export class BuildAction {
      */
     parseGlobalsValue(value) {
         if (value === undefined)
-            return { autoMode: true, extras: "" };
-        if (value === "none" || value === "")
-            return { autoMode: false, extras: "" };
+            return { autoMode: true, extras: '' };
+        if (value === 'none' || value === '')
+            return { autoMode: false, extras: '' };
         const tokens = value
-            .split(",")
+            .split(',')
             .map((t) => t.trim())
             .filter(Boolean);
-        const hasAuto = tokens.includes("auto");
-        const extras = tokens.filter((t) => t !== "auto").join(",");
+        const hasAuto = tokens.includes('auto');
+        const extras = tokens.filter((t) => t !== 'auto').join(',');
         return { autoMode: hasAuto, extras };
     }
     /**
@@ -137,7 +135,7 @@ export class BuildAction {
      * The auto path is handled in `buildApp` via the iterative multi-pass build.
      */
     async resolveGlobalsInject(app, globals, verbose) {
-        if (app !== "gjs")
+        if (app !== 'gjs')
             return undefined;
         if (!globals)
             return undefined;
@@ -164,39 +162,37 @@ export class BuildAction {
     async applyShebang(app, outfile, verbose) {
         if (!outfile) {
             if (verbose)
-                console.warn("[gjsify] --shebang skipped: no single outfile (use --outfile for executables)");
+                console.warn('[gjsify] --shebang skipped: no single outfile (use --outfile for executables)');
             return;
         }
-        const defaultLine = app === "node" ? NODE_SHEBANG : DEFAULT_GJS_SHEBANG;
+        const defaultLine = app === 'node' ? NODE_SHEBANG : DEFAULT_GJS_SHEBANG;
         const line = resolveShebangLine(this.configData.shebang, defaultLine) ?? defaultLine;
-        const content = await readFile(outfile, "utf-8");
-        if (content.startsWith("#!")) {
+        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 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 = "gjs", opts = {}) {
-        const { verbose, typescript, exclude, library: pkg, aliases, excludeGlobals, } = this.configData;
+    async buildApp(app = 'gjs', opts = {}) {
+        const { verbose, typescript, exclude, library: pkg, aliases, excludeGlobals } = this.configData;
         const userBundler = normalizeBundlerOptions(this.configData);
         const formatRaw = userBundler.output?.format ??
-            (userBundler.output?.file?.endsWith(".cjs") ? "cjs" : "esm");
+            (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 = formatRaw === "iife" ? "esm" : formatRaw;
+        const format = 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;
+            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 ` +
@@ -205,12 +201,8 @@ export class BuildAction {
             outfile = candidate;
         }
         const { consoleShim, globals } = this.configData;
-        const userExternal = Array.isArray(userBundler.external)
-            ? userBundler.external
-            : undefined;
-        const userBanner = typeof userBundler.output?.banner === "string"
-            ? userBundler.output.banner
-            : undefined;
+        const userExternal = Array.isArray(userBundler.external) ? userBundler.external : undefined;
+        const userBanner = typeof userBundler.output?.banner === 'string' ? userBundler.output.banner : undefined;
         const pluginOpts = {
             debug: verbose,
             app,
@@ -242,7 +234,7 @@ export class BuildAction {
             userPlugins.push(...resolved);
         }
         // --- Auto mode (with optional extras): iterative multi-pass build ---
-        if (app === "gjs" && autoMode) {
+        if (app === 'gjs' && autoMode) {
             // Return the full orchestrator config (options + plugins) so
             // auto-globals can reuse the per-app `resolve.conditionNames` /
             // `mainFields` / `external` / `treeshake` for the in-memory
@@ -297,7 +289,7 @@ export class BuildAction {
             return [];
         }
         const writeResult = await runBundle(finalOpts);
-        if ((app === "gjs" || app === "node") && this.configData.shebang) {
+        if ((app === 'gjs' || app === 'node') && this.configData.shebang) {
             await this.applyShebang(app, outfile, verbose);
         }
         return [writeResult];
@@ -311,36 +303,36 @@ export class BuildAction {
     async runWatchLoop(finalOpts, app, outfile, verbose) {
         const watcher = await runWatch(finalOpts);
         const closed = new Promise((resolve) => {
-            watcher.on("close", () => resolve());
+            watcher.on('close', () => resolve());
         });
         let closing = false;
         const shutdown = async () => {
             if (closing)
                 return;
             closing = true;
-            console.log("\n[gjsify build --watch] stopping watcher…");
+            console.log('\n[gjsify build --watch] stopping watcher…');
             try {
                 await watcher.close();
             }
             catch (err) {
-                console.error("[gjsify build --watch] watcher close error:", err);
+                console.error('[gjsify build --watch] watcher close error:', err);
             }
         };
-        process.on("SIGINT", shutdown);
-        process.on("SIGTERM", shutdown);
-        watcher.on("event", async (event) => {
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        watcher.on('event', async (event) => {
             switch (event.code) {
-                case "START":
+                case 'START':
                     if (verbose)
-                        console.log("[gjsify build --watch] rebuild start");
+                        console.log('[gjsify build --watch] rebuild start');
                     break;
-                case "BUNDLE_START":
-                    console.log("[gjsify build --watch] building…");
+                case 'BUNDLE_START':
+                    console.log('[gjsify build --watch] building…');
                     break;
-                case "BUNDLE_END":
+                case 'BUNDLE_END':
                     console.log(`[gjsify build --watch] built in ${event.duration}ms`);
                     try {
-                        if ((app === "gjs" || app === "node") && this.configData.shebang) {
+                        if ((app === 'gjs' || app === 'node') && this.configData.shebang) {
                             await this.applyShebang(app, outfile, verbose);
                         }
                     }
@@ -348,11 +340,11 @@ export class BuildAction {
                         await event.result.close();
                     }
                     break;
-                case "END":
-                    console.log("[gjsify build --watch] waiting for changes…");
+                case 'END':
+                    console.log('[gjsify build --watch] waiting for changes…');
                     break;
-                case "ERROR":
-                    console.error("[gjsify build --watch] build failed:", event.error?.message ?? event.error);
+                case 'ERROR':
+                    console.error('[gjsify build --watch] build failed:', event.error?.message ?? event.error);
                     if (verbose && event.error?.stack)
                         console.error(event.error.stack);
                     try {
@@ -365,16 +357,16 @@ export class BuildAction {
             }
         });
         if (verbose) {
-            watcher.on("change", (id, change) => {
+            watcher.on('change', (id, change) => {
                 console.log(`[gjsify build --watch] ${change.event}: ${id}`);
             });
         }
         await closed;
     }
-    async start(buildType = { app: "gjs" }) {
+    async start(buildType = { app: 'gjs' }) {
         if (buildType.library) {
             if (buildType.watch) {
-                throw new Error("gjsify build: --watch is not supported with --library (library mode would emit watcher rebuilds for every produced format; use --app gjs|node|browser instead).");
+                throw new Error('gjsify build: --watch is not supported with --library (library mode would emit watcher rebuilds for every produced format; use --app gjs|node|browser instead).');
             }
             return await this.buildLibrary();
         }

package/lib/bundler-pick.d.ts

@@ -1,4 +1,4 @@
-import type { RolldownOutput } from 'rolldown';
+import type { RolldownOutput, InputOptions, RolldownWatcher } from 'rolldown';
 import type { BundlerOptions } from './types/index.js';
 export interface NativePluginContext {
     resolve(specifier: string, importer?: string, opts?: {
@@ -62,7 +62,7 @@ export interface NativePlugin {
  * the GJS-bundled CLI doesn't try to load the unloadable npm crate.
  */
 export declare function bundleToChunks(input: {
-    rolldownInput: import('rolldown').InputOptions;
+    rolldownInput: InputOptions;
     format: 'esm' | 'cjs' | 'iife';
 }): Promise<string[]>;
 /**
@@ -71,7 +71,7 @@ export declare function bundleToChunks(input: {
  * Returns the watcher; the caller registers `event` / `close` listeners
  * and is responsible for invoking `watcher.close()` on shutdown.
  */
-export declare function runWatch(finalOpts: BundlerOptions): Promise<import('rolldown').RolldownWatcher>;
+export declare function runWatch(finalOpts: BundlerOptions): Promise<RolldownWatcher>;
 /**
  * Run a bundle with the picked engine. Drop-in replacement for the
  * `rolldown(opts).write(opts.output)` flow used directly in build.ts.

package/lib/bundler-pick.js

@@ -206,10 +206,11 @@ async function runNativeBundle(finalOpts) {
     void _droppedPlugins;
     const bundlerOpts = liftTransformExtras(stripUnserializable({
         ...rest,
-        ...(outputOpts ?? {}),
+        ...outputOpts,
         input: normalizeInputForNative(finalOpts.input),
     }));
-    if (globalThis.process?.env?.GJSIFY_DEBUG_NATIVE_OPTS) {
+    if (globalThis.process?.env
+        ?.GJSIFY_DEBUG_NATIVE_OPTS) {
         // Debug switch to inspect the shape we ship to the native facade —
         // mismatches surface as Rust serde parse errors that point at column
         // numbers in this JSON.
@@ -225,9 +226,7 @@ async function runNativeBundle(finalOpts) {
         await fs.mkdir(outDir, { recursive: true });
     for (const item of result.output) {
         if (item.type === 'chunk') {
-            const target = outputCfg.file && result.output.length === 1
-                ? outputCfg.file
-                : path.join(outDir, item.fileName);
+            const target = outputCfg.file && result.output.length === 1 ? outputCfg.file : path.join(outDir, item.fileName);
             await fs.writeFile(target, item.code, 'utf8');
         }
     }
@@ -316,7 +315,7 @@ function normalizeInputForNative(input) {
     if (typeof input === 'string')
         return [{ import: input }];
     if (Array.isArray(input)) {
-        return input.map((v) => typeof v === 'string' ? { import: v } : v);
+        return input.map((v) => (typeof v === 'string' ? { import: v } : v));
     }
     return Object.entries(input).map(([name, file]) => ({ name, import: file }));
 }

package/lib/commands/build.d.ts

@@ -1,2 +1,2 @@
 import type { Command, CliBuildOptions } from '../types/index.js';
-export declare const buildCommand: Command<any, CliBuildOptions>;
+export declare const buildCommand: Command<unknown, CliBuildOptions>;

package/lib/commands/build.js

@@ -6,7 +6,7 @@ export const buildCommand = {
     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.",
+            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,
@@ -19,59 +19,59 @@ export const buildCommand = {
             // 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)",
+            defaultDescription: 'src/index.ts (fallback)',
             coerce: (arg) => {
                 // Removes duplicates
                 return [...new Set(arg)];
-            }
+            },
         })
             .option('exclude', {
-            description: "An array of glob patterns to exclude entry-points and aliases",
+            description: 'An array of glob patterns to exclude entry-points and aliases',
             array: true,
             type: 'string',
             normalize: true,
-            default: []
+            default: [],
         })
             .option('verbose', {
-            description: "Switch on the verbose mode",
+            description: 'Switch on the verbose mode',
             type: 'boolean',
             normalize: true,
-            default: false
+            default: false,
         })
             .option('app', {
-            description: "Use this if you want to build an application, the platform node is usually only used for tests",
+            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'
+            default: 'gjs',
         })
             .option('format', {
-            description: "Override the default output 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).",
+            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",
+            description: 'Use this if you want to build a library for Gjsify',
             type: 'boolean',
             normalize: true,
-            default: false
+            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",
+            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",
+            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,
         })
@@ -80,60 +80,66 @@ export const buildCommand = {
             description: "Enables TypeScript types on runtime using Deepkit's type compiler",
             type: 'boolean',
             normalize: true,
-            default: false
+            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",
+            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'
+            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.",
+            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
+            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'
+            default: 'auto',
         })
             .option('shebang', {
-            description: "Prepend a target-appropriate shebang to the output and mark it executable (chmod 755): `#!/usr/bin/env -S gjs -m` for --app gjs, `#!/usr/bin/env node` for --app node. Applies to GJS and Node app builds with a single --outfile. Default: false (use --shebang to enable, or set `shebang: true` in `.gjsifyrc.js`).",
+            description: 'Prepend a target-appropriate shebang to the output and mark it executable (chmod 755): `#!/usr/bin/env -S gjs -m` for --app gjs, `#!/usr/bin/env node` for --app node. Applies to GJS and Node app builds with a single --outfile. Default: false (use --shebang to enable, or set `shebang: true` in `.gjsifyrc.js`).',
             type: 'boolean',
-            normalize: true
+            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",
+            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: [],
-            coerce: (arg) => arg.flatMap((v) => v.split(',').map((s) => s.trim()).filter(Boolean)),
+            coerce: (arg) => 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",
+            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: [],
         })
             .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.",
+            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: [],
-            coerce: (arg) => arg.flatMap((v) => v.split(',').map((s) => s.trim()).filter(Boolean)),
+            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).",
+            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,
         })
             .option('watch', {
             alias: 'w',
-            description: "Watch source files and rebuild on change. Logs each rebuild with duration; clean SIGINT shutdown. Only valid with --app gjs|node|browser (rejected with --library). Requires the npm `rolldown` engine — run under Node, not the GJS-bundled CLI.",
+            description: 'Watch source files and rebuild on change. Logs each rebuild with duration; clean SIGINT shutdown. Only valid with --app gjs|node|browser (rejected with --library). Requires the npm `rolldown` engine — run under Node, not the GJS-bundled CLI.',
             type: 'boolean',
             normalize: true,
             default: false,
@@ -148,5 +154,5 @@ export const buildCommand = {
             app: args.app,
             watch: args.watch,
         });
-    }
+    },
 };

package/lib/commands/check.js

@@ -7,7 +7,7 @@
 // In a single package (or anywhere a `package.json` with a `check` script
 // is reachable from cwd): runs the local `check` script directly. This is
 // the natural "tsc --noEmit on the current scope" invocation, analogous to
-// `gjsify format` / `lint` / `fix` (which all wrap Biome workspace-wide).
+// `gjsify format` / `lint` / `fix` (which all wrap oxc workspace-wide).
 //
 // The legacy system-dep-check shape lives under `gjsify system-check` after
 // PR #254. The `check` alias on `system-check` stays valid for one release
@@ -18,7 +18,7 @@ import { spawn, spawnSync } from 'node:child_process';
 import { existsSync, readFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { cpus } from 'node:os';
-import { discoverWorkspaces, filterWorkspaces, } from '@gjsify/workspace';
+import { discoverWorkspaces, filterWorkspaces } from '@gjsify/workspace';
 import { findWorkspaceRoot } from '../utils/workspace-root.js';
 function readPackageJson(dir) {
     const path = join(dir, 'package.json');
@@ -147,7 +147,7 @@ export const checkCommand = {
                     firstFail = code;
             }
             if (firstFail !== 0)
-                console.error(`gjsify check: failures in ${targets.filter(async (ws) => await runCheck(ws, null) !== 0).length}+ workspaces`);
+                console.error(`gjsify check: failures in ${targets.filter(async (ws) => (await runCheck(ws, null)) !== 0).length}+ workspaces`);
             process.exit(firstFail);
         }
         // ---- Parallel mode (default) ----

package/lib/commands/create.d.ts

@@ -5,5 +5,5 @@ interface CreateOptions {
     force: boolean;
     install: boolean;
 }
-export declare const createCommand: Command<any, CreateOptions>;
+export declare const createCommand: Command<unknown, CreateOptions>;
 export {};

package/lib/commands/dlx.d.ts

@@ -9,5 +9,5 @@ interface DlxOptions {
     verbose: boolean;
     registry?: string;
 }
-export declare const dlxCommand: Command<any, DlxOptions>;
+export declare const dlxCommand: Command<unknown, DlxOptions>;
 export {};