@gjsify/cli 0.4.28 → 0.4.30

package/lib/commands/fix.js

@@ -1,14 +1,16 @@
-// `gjsify fix` — runs biome's combined `check --write` mode.
+// `gjsify fix` — combined oxc fix pass.
 //
-// Equivalent to biome's `check` (format + safe-lint-fix + organize-imports).
-// Default writes fixes in-place; pass `--no-write` to report-only.
-// Naming: deliberately distinct from `gjsify check` (workspace TS check)
-// and `gjsify system-check` (system-dependency verifier).
+// Runs `oxfmt --write` (format JS/TS in place) followed by `oxlint --fix`
+// (apply safe lint fixes). Mirrors the one-shot ergonomics of the former
+// Biome `check --write`, now split across the two oxc tools.
+//
+// Naming: deliberately distinct from `gjsify check` (workspace TS check) and
+// `gjsify system-check` (system-dependency verifier).
 import { resolve } from 'node:path';
-import { BiomeNotFoundError, findBiomeConfig, printBiomeNotFound, runBiome, } from '../utils/biome-resolve.js';
+import { OxcNotFoundError, findOxfmtConfig, findOxlintConfig, printOxcNotFound, runOxfmt, runOxlint, } from '../utils/oxc-resolve.js';
 export const fixCommand = {
     command: 'fix [paths..]',
-    description: 'Run Biome check --write — format + safe-lint-fix + organize-imports in one pass.',
+    description: 'Run oxfmt --write then oxlint --fix — format + safe lint fixes in one pass.',
     builder: (yargs) => {
         return yargs
             .positional('paths', {
@@ -22,35 +24,43 @@ export const fixCommand = {
             default: true,
         })
             .option('config-path', {
-            description: 'Path to a biome.json. Default: walks up from cwd to find one.',
+            description: 'Path to an .oxlintrc.json. Default: walks up from cwd to find one.',
             type: 'string',
             normalize: true,
         })
             .option('verbose', {
-            description: 'Echo the resolved biome binary + args before spawning.',
+            description: 'Echo the resolved oxc launchers + args before spawning.',
             type: 'boolean',
             default: false,
         });
     },
     handler: async (args) => {
         const cwd = process.cwd();
-        const paths = args.paths?.length
-            ? args.paths
-            : ['.'];
-        const biomeArgs = ['check'];
-        if (args.write !== false)
-            biomeArgs.push('--write');
-        const configPath = args.configPath ?? findBiomeConfig(cwd) ?? undefined;
-        if (configPath)
-            biomeArgs.push(`--config-path=${resolve(configPath, '..')}`);
-        biomeArgs.push(...paths);
+        const paths = args.paths?.length ? args.paths : ['.'];
+        const verbose = args.verbose ?? false;
+        const writeMode = args.write !== false;
         try {
-            const code = await runBiome(biomeArgs, { cwd, verbose: args.verbose });
-            process.exitCode = code;
+            // 1. Format JS/TS in place (or report drift when --no-write).
+            const fmtArgs = [writeMode ? '--write' : '--list-different'];
+            const fmtConfig = args.configPath ?? findOxfmtConfig(cwd) ?? undefined;
+            if (fmtConfig)
+                fmtArgs.push('--config', resolve(fmtConfig));
+            fmtArgs.push(...paths);
+            const fmtCode = await runOxfmt(fmtArgs, { cwd, verbose });
+            // 2. Apply safe lint fixes (skipped in report-only mode).
+            const lintArgs = [];
+            if (writeMode)
+                lintArgs.push('--fix');
+            const lintConfig = args.configPath ?? findOxlintConfig(cwd) ?? undefined;
+            if (lintConfig)
+                lintArgs.push('--config', resolve(lintConfig));
+            lintArgs.push(...paths);
+            const lintCode = await runOxlint(lintArgs, { cwd, verbose });
+            process.exitCode = fmtCode || lintCode;
         }
         catch (err) {
-            if (err instanceof BiomeNotFoundError) {
-                printBiomeNotFound(err);
+            if (err instanceof OxcNotFoundError) {
+                printOxcNotFound(err);
                 process.exitCode = 1;
                 return;
             }

package/lib/commands/flatpak/build.js

@@ -88,12 +88,16 @@ export const flatpakBuildCommand = {
             rmSync(buildDir, { recursive: true, force: true });
         await runFlatpakBuilder([...sharedFlags, buildDir, manifest], { verbose: args.verbose });
         if (args.install) {
-            await runFlatpakBuilder(['--user', '--install', '--force-clean', buildDir, manifest], { verbose: args.verbose });
+            await runFlatpakBuilder(['--user', '--install', '--force-clean', buildDir, manifest], {
+                verbose: args.verbose,
+            });
         }
         if (args.repo) {
             const repoPath = resolve(cwd, args.repo);
             mkdirSync(dirname(repoPath), { recursive: true });
-            await runFlatpakBuilder([`--repo=${repoPath}`, '--force-clean', buildDir, manifest], { verbose: args.verbose });
+            await runFlatpakBuilder([`--repo=${repoPath}`, '--force-clean', buildDir, manifest], {
+                verbose: args.verbose,
+            });
         }
         if (args.bundle) {
             if (!args.repo) {

package/lib/commands/flatpak/check.js

@@ -101,7 +101,9 @@ function resolveAppId(explicit, flatpak, cwd) {
         if (looksLikeAppId(pkg.name))
             return pkg.name;
     }
-    catch { /* no pkg.json */ }
+    catch {
+        /* no pkg.json */
+    }
     if (explicit) {
         // strip `.json` extension if present
         return explicit.replace(/\.json$/, '');
@@ -130,8 +132,12 @@ function runLinter(bin, args, verbose) {
         if (!verbose) {
             child.stdout?.setEncoding('utf-8');
             child.stderr?.setEncoding('utf-8');
-            child.stdout?.on('data', (c) => { stdout += c; });
-            child.stderr?.on('data', (c) => { stderr += c; });
+            child.stdout?.on('data', (c) => {
+                stdout += c;
+            });
+            child.stderr?.on('data', (c) => {
+                stderr += c;
+            });
         }
         child.on('error', (err) => {
             const e = err;

package/lib/commands/flatpak/ci.js

@@ -61,8 +61,7 @@ export const flatpakCiCommand = {
         const configData = await cfg.forBuild({}).catch(() => ({}));
         const flatpak = configData.flatpak ?? {};
         const pkg = readPackageJson(cwd);
-        const appId = flatpak.appId ??
-            (looksLikeAppId(pkg.name) ? pkg.name : undefined);
+        const appId = flatpak.appId ?? (looksLikeAppId(pkg.name) ? pkg.name : undefined);
         if (!appId) {
             throw new Error('gjsify flatpak ci: no app id available. Set gjsify.flatpak.appId in package.json ' +
                 'or rename the package to a reverse-DNS id.');

package/lib/commands/flatpak/deps.js

@@ -53,8 +53,7 @@ export const flatpakDepsCommand = {
         if (!existsSync(lockfile)) {
             throw new Error(`gjsify flatpak deps: lockfile ${lockfile} not found (use --lockfile to override)`);
         }
-        const type = args.type ??
-            (lockfile.endsWith('package-lock.json') ? 'npm' : 'yarn');
+        const type = args.type ?? (lockfile.endsWith('package-lock.json') ? 'npm' : 'yarn');
         const out = resolve(cwd, args.out ?? 'flatpak-node-sources.json');
         mkdirSync(dirname(out), { recursive: true });
         const cmdArgs = [type, lockfile, '-o', out];

package/lib/commands/flatpak/diff.js

@@ -62,15 +62,11 @@ export const flatpakDiffCommand = {
         const cfg = new Config();
         const configData = await cfg.forBuild({}).catch(() => ({}));
         const flatpak = configData.flatpak ?? {};
-        const appId = args.appId ??
-            flatpak.appId ??
-            readPackageJson(cwd).name;
+        const appId = args.appId ?? flatpak.appId ?? readPackageJson(cwd).name;
         if (!appId) {
             throw new Error('[gjsify flatpak diff] no app id available — pass --app-id or set gjsify.flatpak.appId.');
         }
-        const flathubRepo = args.flathubRepo ??
-            flatpak.flathubRepo ??
-            `flathub/${appId}`;
+        const flathubRepo = args.flathubRepo ?? flatpak.flathubRepo ?? `flathub/${appId}`;
         const localVersion = args.version ?? (await resolveLatestTag(cwd, args.verbose));
         const remoteSource = await loadFlathubSource({ appId, flathubRepo, against: args.against, verbose: args.verbose }, args.sourceIndex);
         const remoteTag = remoteSource?.tag;

package/lib/commands/flatpak/init.js

@@ -16,7 +16,7 @@ import { dirname, resolve } from 'node:path';
 import { DEFAULT_CLI_FINISH_ARGS, DEFAULT_GUI_FINISH_ARGS, looksLikeAppId, readPackageJson, resolveRuntime, } from './utils.js';
 import { renderDesktop, renderFlathubJson, renderMetainfoApp, renderMetainfoCli, validateScaffoldInputs, } from './scaffold.js';
 import { Config } from '../../config.js';
-import { BiomeNotFoundError, hasBiomeDevDep, runBiome, } from '../../utils/biome-resolve.js';
+import { OxcNotFoundError, hasOxcDevDep, runOxfmt } from '../../utils/oxc-resolve.js';
 export const flatpakInitCommand = {
     command: 'init',
     description: 'Generate Flatpak manifest + MetaInfo XML + .desktop + flathub.json from `gjsify.flatpak` config.',
@@ -88,8 +88,9 @@ export const flatpakInitCommand = {
             default: false,
         })
             .option('format', {
-            description: 'Run `gjsify format --write` on the generated files when `@biomejs/biome` is detected in the project. ' +
-                'Default: true. Pass --no-format to skip.',
+            description: 'Run `oxfmt --write` on the generated JS/TS files when `oxfmt` is detected in the project. ' +
+                'Default: true. Pass --no-format to skip. Note: oxfmt formats JS/TS only — the JSON/XML/.desktop ' +
+                'manifests generated here are not reformatted (CSS/JSON formatting was dropped in the oxc migration).',
             type: 'boolean',
             default: true,
         });
@@ -107,9 +108,7 @@ export const flatpakInitCommand = {
             throw new Error('gjsify flatpak init: no app id available. Pass --app-id, set gjsify.flatpak.appId in package.json, ' +
                 'or rename the package to a reverse-DNS id like org.example.MyApp.');
         }
-        const kind = args.kind ??
-            flatpak.kind ??
-            (args.cliOnly ? 'cli' : 'app');
+        const kind = args.kind ?? flatpak.kind ?? (args.cliOnly ? 'cli' : 'app');
         const { runtime, runtimeId, sdk, runtimeVersion } = resolveRuntime(flatpak, {
             runtime: args.runtime,
             runtimeVersion: args.runtimeVersion,
@@ -120,8 +119,7 @@ export const flatpakInitCommand = {
         const explicitFinishArgs = args.finishArg;
         const finishArgs = explicitFinishArgs !== undefined
             ? explicitFinishArgs
-            : flatpak.finishArgs ??
-                (kind === 'cli' ? DEFAULT_CLI_FINISH_ARGS : DEFAULT_GUI_FINISH_ARGS);
+            : (flatpak.finishArgs ?? (kind === 'cli' ? DEFAULT_CLI_FINISH_ARGS : DEFAULT_GUI_FINISH_ARGS));
         const manifest = {
             id: appId,
             runtime: runtimeId,
@@ -199,20 +197,22 @@ export const flatpakInitCommand = {
             const flathubOut = args.flathubJson ?? 'flathub.json';
             trackWrite(writeIfFresh(resolve(cwd, flathubOut), renderFlathubJson(kind), args.force ?? false, 'flathub.json'));
         }
-        // Optional post-format: when biome is configured in the project,
-        // run `biome format --write` on the generated files so they match
-        // the project's prettier/biome style. Default behaviour (2-space
-        // JSON) already matches biome/prettier/Flathub defaults; this
-        // step harmonises edge-case fields (line endings, trailing commas
-        // in JSONC, key sort order if biome's organize-imports has rules).
-        if (writtenFiles.length > 0 && args.format !== false && hasBiomeDevDep(cwd)) {
+        // Optional post-format: when oxfmt is configured in the project, run
+        // `oxfmt --write` on any generated JS/TS files. oxfmt formats JS/TS
+        // (+TOML) only — the manifest/MetaInfo/.desktop/flathub outputs are
+        // JSON/XML/INI and are therefore left untouched (CSS/JSON formatting
+        // was dropped in the Biome → oxc migration). In practice flatpak init
+        // emits no JS/TS, so this is usually a no-op; it remains as a hook for
+        // any future JS/TS scaffold output.
+        const jsLikeFiles = writtenFiles.filter((p) => /\.(ts|tsx|mts|cts|js|jsx|mjs|cjs)$/.test(p));
+        if (jsLikeFiles.length > 0 && args.format !== false && hasOxcDevDep(cwd)) {
             try {
-                await runBiome(['format', '--write', ...writtenFiles], { cwd });
+                await runOxfmt(['--write', ...jsLikeFiles], { cwd });
             }
             catch (err) {
-                if (err instanceof BiomeNotFoundError) {
-                    // Biome configured but binary missing — non-fatal warning.
-                    console.warn(`[gjsify flatpak init] post-format skipped: @biomejs/biome declared but binary not installed. ` +
+                if (err instanceof OxcNotFoundError) {
+                    // oxfmt configured but binding missing — non-fatal warning.
+                    console.warn(`[gjsify flatpak init] post-format skipped: oxfmt declared but binding not installed. ` +
                         `Run \`gjsify install\` then re-run with --force, or pass --no-format.`);
                 }
                 else {

package/lib/commands/flatpak/release.js

@@ -22,7 +22,7 @@ export const flatpakReleaseCommand = {
     command: 'release <version>',
     description: 'Cut a release end-to-end: regenerate Flathub assets, run linters, create + push the git tag, then open the Flathub PR. Each step delegates to the equivalent `gjsify flatpak <sub>` command.',
     builder: (yargs) => {
-        return yargs
+        return (yargs
             // yargs' built-in `--version` flag would otherwise consume the
             // positional value.
             .version(false)
@@ -64,7 +64,7 @@ export const flatpakReleaseCommand = {
             description: 'Echo every sub-command invocation.',
             type: 'boolean',
             default: false,
-        });
+        }));
     },
     handler: async (args) => {
         const version = typeof args.version === 'string' ? args.version.trim() : '';

package/lib/commands/flatpak/scaffold.js

@@ -75,9 +75,7 @@ export function renderMetainfoCli(inputs) {
 export function renderDesktop(inputs) {
     const f = inputs.flatpak;
     const categoriesLine = (f.categories ?? ['Utility']).join(';') + ';';
-    const keywordsLine = f.keywords?.length
-        ? `Keywords=${f.keywords.join(';')};\n`
-        : '';
+    const keywordsLine = f.keywords?.length ? `Keywords=${f.keywords.join(';')};\n` : '';
     return substitute(loadDesktopTemplate(), {
         NAME: inputs.name,
         SUMMARY: f.summary ?? inputs.name,
@@ -265,9 +263,7 @@ function renderMetainfo(inputs, kind) {
 }
 // ─── Description block renderer ──────────────────────────────────────────
 function renderDescriptionBlocks(description, indent) {
-    const blocks = typeof description === 'string'
-        ? stringToBlocks(description)
-        : description;
+    const blocks = typeof description === 'string' ? stringToBlocks(description) : description;
     const out = [];
     for (const block of blocks) {
         if ('p' in block) {
@@ -319,9 +315,5 @@ function substitute(template, tokens) {
     return out;
 }
 function escapeXml(value) {
-    return value
-        .replace(/&/g, '&')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
 }

package/lib/commands/flatpak/sync-flathub.js

@@ -26,7 +26,7 @@ export const flatpakSyncFlathubCommand = {
     command: 'sync-flathub',
     description: 'Update the per-app Flathub tracking-repo manifest to a new git tag + commit. Clones, edits, commits, optionally opens a PR.',
     builder: (yargs) => {
-        return yargs
+        return (yargs
             // Disable yargs' built-in `--version` (which would otherwise
             // print the package version) so this command's `--version
             // <tag>` flag works.
@@ -69,22 +69,18 @@ export const flatpakSyncFlathubCommand = {
             description: 'Echo every git / gh invocation before running.',
             type: 'boolean',
             default: false,
-        });
+        }));
     },
     handler: async (args) => {
         const cwd = process.cwd();
         const cfg = new Config();
         const configData = await cfg.forBuild({}).catch(() => ({}));
         const flatpak = configData.flatpak ?? {};
-        const appId = args.appId ??
-            flatpak.appId ??
-            readPackageJson(cwd).name;
+        const appId = args.appId ?? flatpak.appId ?? readPackageJson(cwd).name;
         if (!appId) {
             throw new Error('[gjsify flatpak sync-flathub] no app id available — pass --app-id or set gjsify.flatpak.appId.');
         }
-        const flathubRepo = args.flathubRepo ??
-            flatpak.flathubRepo ??
-            `flathub/${appId}`;
+        const flathubRepo = args.flathubRepo ?? flatpak.flathubRepo ?? `flathub/${appId}`;
         const version = args.version ?? (await resolveLatestTag(cwd, args.verbose));
         if (!version) {
             throw new Error('[gjsify flatpak sync-flathub] no version resolved — pass --version vX.Y.Z or create a git tag locally.');
@@ -156,7 +152,7 @@ async function resolveCommitForTag(cwd, tag, verbose) {
     }
     catch (err) {
         throw new Error(`[gjsify flatpak sync-flathub] tag ${tag} not found locally. Run \`git fetch --tags\` or pass --commit <sha>.\n` +
-            `  underlying error: ${err?.message ?? err}`);
+            `  underlying error: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
 function normaliseBranchSegment(version) {

package/lib/commands/flatpak/utils.js

@@ -10,12 +10,7 @@ export const DEFAULT_GNOME_RUNTIME_VERSION = '50';
 /** Default Freedesktop-Platform runtime version (LTS-ish). */
 export const DEFAULT_FREEDESKTOP_RUNTIME_VERSION = '24.08';
 /** Permissive GUI defaults for GTK4 + Adwaita apps. */
-export const DEFAULT_GUI_FINISH_ARGS = [
-    '--device=dri',
-    '--share=ipc',
-    '--socket=fallback-x11',
-    '--socket=wayland',
-];
+export const DEFAULT_GUI_FINISH_ARGS = ['--device=dri', '--share=ipc', '--socket=fallback-x11', '--socket=wayland'];
 /** Lean defaults for headless CLI tools — no display, no GPU. */
 export const DEFAULT_CLI_FINISH_ARGS = [];
 /** Read package.json from a directory. Throws a helpful error if missing/invalid. */

package/lib/commands/foreach.d.ts

@@ -13,5 +13,5 @@ interface ForeachOptions {
     jobs?: number;
     exec?: boolean;
 }
-export declare const foreachCommand: Command<any, ForeachOptions>;
+export declare const foreachCommand: Command<unknown, ForeachOptions>;
 export {};

package/lib/commands/foreach.js

@@ -38,7 +38,7 @@ export const foreachCommand = {
         default: false,
     })
         .option('topological', {
-        description: 'Wait for each workspace\'s deps to finish before starting it (production deps only).',
+        description: "Wait for each workspace's deps to finish before starting it (production deps only).",
         type: 'boolean',
         alias: 't',
         default: false,
@@ -105,8 +105,7 @@ export const foreachCommand = {
             // With populate--:true, anything after the literal `--`
             // separator lands in top-level args['--']. yargs DOES NOT
             // attach it to args._ — it's a sibling array.
-            const fromDoubleDash = (args['--'] ?? [])
-                .filter((v) => typeof v === 'string');
+            const fromDoubleDash = (args['--'] ?? []).filter((v) => typeof v === 'string');
             if (fromDoubleDash.length > 0) {
                 if (!cmd) {
                     cmd = fromDoubleDash[0];
@@ -206,11 +205,7 @@ async function runTopologicalParallel(workspaces, script, args, concurrency, ver
     for (const ws of workspaces) {
         const wsDeps = new Set();
         const m = ws.manifest;
-        for (const block of [
-            m.dependencies,
-            includeDev ? m.devDependencies : undefined,
-            m.optionalDependencies,
-        ]) {
+        for (const block of [m.dependencies, includeDev ? m.devDependencies : undefined, m.optionalDependencies]) {
             if (!block)
                 continue;
             for (const [name, spec] of Object.entries(block)) {
@@ -284,9 +279,7 @@ async function runOne(ws, script, args, prefixOutput, verbose, exec) {
     // when nothing is detectable; the script-runner (D.5) will replace
     // this once `gjsify run` ships.
     const runner = detectPackageManager();
-    const argv = runner === 'gjsify'
-        ? ['run', script, ...args]
-        : ['run', script, ...(args.length > 0 ? ['--', ...args] : [])];
+    const argv = runner === 'gjsify' ? ['run', script, ...args] : ['run', script, ...(args.length > 0 ? ['--', ...args] : [])];
     if (verbose) {
         console.error(`[${ws.name}] $ ${runner} ${argv.join(' ')}`);
     }
@@ -307,9 +300,7 @@ function spawnPrefixed(cmd, args, cwd, prefix) {
     // Default FORCE_COLOR=1 unless the user explicitly opted out, so tools
     // that key on `process.stdout.isTTY` (chalk, picocolors, …) still emit
     // ANSI colors when run under gjsify foreach. Mirrors yarn / npm.
-    const colorEnv = process.env.FORCE_COLOR !== undefined || process.env.NO_COLOR !== undefined
-        ? {}
-        : { FORCE_COLOR: '1' };
+    const colorEnv = process.env.FORCE_COLOR !== undefined || process.env.NO_COLOR !== undefined ? {} : { FORCE_COLOR: '1' };
     return new Promise((resolve, reject) => {
         const child = spawn(cmd, args, {
             cwd,

package/lib/commands/format.js

@@ -1,19 +1,25 @@
-// `gjsify format` — wraps biome's `format` mode.
+// `gjsify format` — wraps oxfmt.
 //
-// Resolves biome's native binary from node_modules (skipping the Node
-// launcher in @biomejs/biome/bin/biome) and spawns it directly. This
-// keeps the Node-free promise intact: biome's per-platform package
-// (e.g. @biomejs/cli-linux-x64) carries a self-contained Rust binary.
+// Resolves oxfmt's Node launcher from node_modules
+// (`node_modules/oxfmt/bin/oxfmt` → `dist/cli.js`) and spawns it with the
+// current Node executable. oxfmt is a napi-rs hybrid CLI; the launcher carries
+// the per-platform `@oxfmt/binding-<target>` native code as an
+// optionalDependency, keeping the Node-free runtime promise for the bundled
+// CLI intact (the formatter runs in dev/CI, not in shipped GJS apps).
 //
-// `--init` writes a recommended biome.json template tuned for GJS/GNOME
-// projects (4-space JS/TS, 2-space JSON+CSS, single-quotes, lineWidth
-// 120, biome's recommended linter + a few GJS-specific opt-outs).
+// oxfmt formats JS/TS (+TOML) only. CSS/JSON formatting that the old Biome
+// toolchain handled is intentionally DROPPED in the oxc migration — no other
+// formatter is wired up for those file types.
+//
+// `--init` writes recommended `.oxlintrc.json` + `.oxfmtrc.json` templates
+// tuned for GJS/GNOME projects (4-space, single-quote, printWidth 120,
+// trailing-comma all, semicolons always, arrow parens always).
 import { existsSync, writeFileSync } from 'node:fs';
 import { resolve } from 'node:path';
-import { BiomeNotFoundError, findBiomeConfig, loadBiomeTemplate, printBiomeNotFound, runBiome, } from '../utils/biome-resolve.js';
+import { OxcNotFoundError, findOxfmtConfig, loadOxfmtTemplate, loadOxlintTemplate, printOxcNotFound, runOxfmt, } from '../utils/oxc-resolve.js';
 export const formatCommand = {
     command: 'format [paths..]',
-    description: 'Format source files via Biome (native binary spawn — no Node launcher).',
+    description: 'Format JS/TS source files via oxfmt (CSS/JSON formatting is not supported).',
     builder: (yargs) => {
         return yargs
             .positional('paths', {
@@ -22,7 +28,7 @@ export const formatCommand = {
             array: true,
         })
             .option('write', {
-            description: 'Modify files in place (default: stdout / report).',
+            description: 'Modify files in place (default: report drift without writing).',
             type: 'boolean',
             default: false,
         })
@@ -32,22 +38,22 @@ export const formatCommand = {
             default: false,
         })
             .option('config-path', {
-            description: 'Path to a biome.json. Default: walks up from cwd to find one.',
+            description: 'Path to an .oxfmtrc.json. Default: walks up from cwd to find one.',
             type: 'string',
             normalize: true,
         })
             .option('init', {
-            description: 'Write a recommended biome.json into cwd (skips if one exists; --force to overwrite).',
+            description: 'Write recommended .oxlintrc.json + .oxfmtrc.json into cwd (skips existing files unless --force).',
             type: 'boolean',
             default: false,
         })
             .option('force', {
-            description: 'Overwrite an existing biome.json with --init.',
+            description: 'Overwrite existing .oxlintrc.json / .oxfmtrc.json with --init.',
             type: 'boolean',
             default: false,
         })
             .option('verbose', {
-            description: 'Echo the resolved biome binary + args before spawning.',
+            description: 'Echo the resolved oxfmt launcher + args before spawning.',
             type: 'boolean',
             default: false,
         });
@@ -55,29 +61,33 @@ export const formatCommand = {
     handler: async (args) => {
         const cwd = process.cwd();
         if (args.init) {
-            await handleInit({ cwd, force: args.force ?? false });
+            handleInit({ cwd, force: args.force ?? false });
             return;
         }
-        const paths = args.paths?.length
-            ? args.paths
-            : ['.'];
-        const biomeArgs = ['format'];
-        if (args.write && !args.check)
-            biomeArgs.push('--write');
-        // --check is the CI semantic: don't write, exit non-zero on drift.
-        // Biome's default mode (no --write) already reports drift + exits
-        // non-zero. We forward neither flag and let biome's defaults apply.
-        const configPath = args.configPath ?? findBiomeConfig(cwd) ?? undefined;
+        const paths = args.paths?.length ? args.paths : ['.'];
+        const oxfmtArgs = [];
+        if (args.check) {
+            oxfmtArgs.push('--check');
+        }
+        else if (args.write) {
+            oxfmtArgs.push('--write');
+        }
+        else {
+            // No flag: report drift without modifying files. oxfmt's bare
+            // default is `--write`, so be explicit with `--list-different`.
+            oxfmtArgs.push('--list-different');
+        }
+        const configPath = args.configPath ?? findOxfmtConfig(cwd) ?? undefined;
         if (configPath)
-            biomeArgs.push(`--config-path=${resolve(configPath, '..')}`);
-        biomeArgs.push(...paths);
+            oxfmtArgs.push('--config', resolve(configPath));
+        oxfmtArgs.push(...paths);
         try {
-            const code = await runBiome(biomeArgs, { cwd, verbose: args.verbose });
+            const code = await runOxfmt(oxfmtArgs, { cwd, verbose: args.verbose });
             process.exitCode = code;
         }
         catch (err) {
-            if (err instanceof BiomeNotFoundError) {
-                printBiomeNotFound(err);
+            if (err instanceof OxcNotFoundError) {
+                printOxcNotFound(err);
                 process.exitCode = 1;
                 return;
             }
@@ -85,14 +95,17 @@ export const formatCommand = {
         }
     },
 };
-async function handleInit({ cwd, force }) {
-    const target = resolve(cwd, 'biome.json');
-    if (existsSync(target) && !force) {
-        console.log(`[gjsify format] biome.json exists at ${target} — pass --force to overwrite.`);
-        process.exitCode = 0;
-        return;
-    }
-    writeFileSync(target, loadBiomeTemplate(), 'utf-8');
-    console.log(`[gjsify format] wrote ${target}`);
-    console.log(`[gjsify format] Run \`gjsify format --write .\` to apply the formatter to the project.`);
+function handleInit({ cwd, force }) {
+    const writeOne = (name, contents) => {
+        const target = resolve(cwd, name);
+        if (existsSync(target) && !force) {
+            console.log(`[gjsify format] ${name} exists at ${target} — pass --force to overwrite.`);
+            return;
+        }
+        writeFileSync(target, contents, 'utf-8');
+        console.log(`[gjsify format] wrote ${target}`);
+    };
+    writeOne('.oxlintrc.json', loadOxlintTemplate());
+    writeOne('.oxfmtrc.json', loadOxfmtTemplate());
+    console.log('[gjsify format] Run `gjsify format --write .` to apply the formatter to the project.');
 }

package/lib/commands/generate-installer.d.ts

@@ -6,5 +6,5 @@ interface GenerateInstallerOptions {
     output: string;
     force: boolean;
 }
-export declare const generateInstallerCommand: Command<any, GenerateInstallerOptions>;
+export declare const generateInstallerCommand: Command<unknown, GenerateInstallerOptions>;
 export {};

package/lib/commands/gettext.d.ts

@@ -10,5 +10,5 @@ interface GettextOptions {
     removeXmlComments?: boolean;
     verbose?: boolean;
 }
-export declare const gettextCommand: Command<any, GettextOptions>;
+export declare const gettextCommand: Command<unknown, GettextOptions>;
 export {};