bestax-migrate 0.0.1

package/README.md

@@ -0,0 +1,59 @@
+# bestax-migrate
+
+Codemods that migrate existing React apps to [`@allxsmith/bestax-bulma`](https://www.npmjs.com/package/@allxsmith/bestax-bulma) — the actively maintained React component library for **Bulma v1**.
+
+Currently supported source libraries:
+
+| Source                                                                           | Status                                                            |
+| -------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
+| [`react-bulma-components`](https://github.com/couds/react-bulma-components) (v4) | ✅ All 32 components mapped (a few patterns are flagged as TODOs) |
+
+## Usage
+
+```bash
+# Preview what would change (no writes)
+pnpm dlx bestax-migrate react-bulma-components src/ --dry
+
+# Apply the migration
+pnpm dlx bestax-migrate react-bulma-components src/
+```
+
+npm and yarn work too: `npx bestax-migrate …` / `yarn dlx bestax-migrate …`.
+
+The codemod uses [jscodeshift](https://github.com/facebook/jscodeshift) to:
+
+- rewrite `react-bulma-components` imports to `@allxsmith/bestax-bulma` (including `const { Input } = Form` destructuring and namespace imports)
+- rename components and compound sub-components (`Form.Textarea` → `TextArea`, `Card.Footer.Item` → `Card.FooterItem`, `Hero.Footer` → `Hero.Foot`, …)
+- convert props (`renderAs` → `as`, `loading` → `isLoading`, numeric spacing/text sizes → string unions, `textAlign="center"` → `textAlign="centered"`, …)
+- flatten responsive breakpoint objects (`mobile={{ size: 4 }}` → `sizeMobile={4}`)
+- restructure patterns bestax models differently (`Table.Container`, Navbar dropdowns, `Form.Help`, icon-font children → `<Icon name=…>`)
+- migrate stylesheets: CSS imports converge on `@allxsmith/bestax-bulma/bestax.css`, and SCSS files move from Bulma 0.9's `@import` + `$var !default` overrides to `@use 'bulma/sass' with (…)` plus `@use '@allxsmith/bestax-bulma/scss/extras'`
+- update `package.json`: remove `react-bulma-components`, add `@allxsmith/bestax-bulma`, bump `bulma` to `^1`, and swap the dead `node-sass` for dart `sass` (no install is ever run)
+
+Anything without a safe automatic conversion is left in place with a `// TODO(bestax-migrate): …` comment, and the run ends with a report of every TODO by file and line. TODOs are expected output, not errors — resolve them with the [migration guide](https://bestax.io/docs/guides/getting-started/migration/react-bulma-components), or let the [`bestax-migrate` Agent Skill](https://bestax.io/docs/skills/intro) walk them for you:
+
+```bash
+npx skills add https://github.com/allxsmith/bestax --skill bestax-migrate
+```
+
+## Options
+
+| Flag                 | Description                                                    |
+| -------------------- | -------------------------------------------------------------- |
+| `--dry`, `-d`        | Report what would change without writing files                 |
+| `--print`, `-p`      | Print transformed sources to stdout                            |
+| `--extensions`, `-e` | File extensions to include (default `js,jsx,ts,tsx,scss,sass`) |
+| `--css <mode>`       | Stylesheet target: `bestax` (default), `bulma`, or `keep`      |
+| `--no-deps`          | Skip updating package.json dependencies                        |
+
+## After the codemod
+
+1. Run your package manager's install (the codemod rewrote `package.json` but never installs)
+2. Search for `TODO(bestax-migrate)` and resolve each comment
+3. Typecheck/build and review the rendered app
+
+Full walkthrough: [react-bulma-components migration guide](https://bestax.io/docs/guides/getting-started/migration/react-bulma-components).
+
+## License
+
+MIT © Alex Smith

package/dist/cli.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The bestax-migrate CLI:
+ *
+ *   bestax-migrate <source> <paths...> [--dry] [--print] [--extensions ...]
+ *                  [--css bestax|bulma|keep] [--no-deps]
+ *
+ * Walks the given files/directories, routes each file by type (JS/TSX →
+ * jscodeshift transform, .scss/.sass → the source's stylesheet transform),
+ * updates the nearest package.json (unless --no-deps), writes results back
+ * (unless --dry), and prints the run report. TODO annotations are expected
+ * output — the exit code is 0 whenever the run itself succeeds.
+ */
+import { Command } from 'commander';
+export declare function collectFiles(targets: string[], extensions: string[]): string[];
+/** Nearest package.json for each target, walking up to the filesystem root. */
+export declare function findPackageJsons(targets: string[]): string[];
+export interface CliIo {
+    log: (message: string) => void;
+    error: (message: string) => void;
+}
+export declare function createCLI(io?: CliIo): Command;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwBpC,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EAAE,EACjB,UAAU,EAAE,MAAM,EAAE,GACnB,MAAM,EAAE,CAkBV;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAkB5D;AAED,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AA+HD,wBAAgB,SAAS,CACvB,EAAE,GAAE,KAAkD,GACrD,OAAO,CA0FT"}

package/dist/cli.js

@@ -0,0 +1,225 @@
+/**
+ * The bestax-migrate CLI:
+ *
+ *   bestax-migrate <source> <paths...> [--dry] [--print] [--extensions ...]
+ *                  [--css bestax|bulma|keep] [--no-deps]
+ *
+ * Walks the given files/directories, routes each file by type (JS/TSX →
+ * jscodeshift transform, .scss/.sass → the source's stylesheet transform),
+ * updates the nearest package.json (unless --no-deps), writes results back
+ * (unless --dry), and prints the run report. TODO annotations are expected
+ * output — the exit code is 0 whenever the run itself succeeds.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { Reporter } from './report.js';
+import { runTransform } from './runner.js';
+import { getSource, sourceNames } from './sources/registry.js';
+const SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'coverage',
+    '.next',
+]);
+const STYLE_EXTENSIONS = new Set(['scss', 'sass']);
+const CSS_MODES = ['bestax', 'bulma', 'keep'];
+/**
+ * Component formats the codemod cannot parse (no jscodeshift grammar) but
+ * that can still import the source library — flagged, never rewritten.
+ */
+const UNSUPPORTED_EXTENSIONS = ['astro', 'vue', 'svelte', 'mdx'];
+export function collectFiles(targets, extensions) {
+    const files = [];
+    const visit = (target) => {
+        const stat = fs.statSync(target, { throwIfNoEntry: false });
+        if (!stat) {
+            throw new Error(`no such file or directory: ${target}`);
+        }
+        if (stat.isDirectory()) {
+            if (SKIP_DIRS.has(path.basename(target)))
+                return;
+            for (const entry of fs.readdirSync(target).sort()) {
+                visit(path.join(target, entry));
+            }
+        }
+        else if (extensions.includes(path.extname(target).replace(/^\./, ''))) {
+            files.push(target);
+        }
+    };
+    for (const target of targets)
+        visit(target);
+    return files;
+}
+/** Nearest package.json for each target, walking up to the filesystem root. */
+export function findPackageJsons(targets) {
+    const found = new Set();
+    for (const target of targets) {
+        const stat = fs.statSync(target, { throwIfNoEntry: false });
+        if (!stat)
+            continue;
+        let dir = path.resolve(stat.isDirectory() ? target : path.dirname(target));
+        for (;;) {
+            const candidate = path.join(dir, 'package.json');
+            if (fs.existsSync(candidate)) {
+                found.add(candidate);
+                break;
+            }
+            const parent = path.dirname(dir);
+            if (parent === dir)
+                break;
+            dir = parent;
+        }
+    }
+    return [...found].sort();
+}
+function migrateFiles(source, files, reporter, io, options) {
+    let bulmaReferenced = false;
+    for (const file of files) {
+        const sourceText = fs.readFileSync(file, 'utf8');
+        const collector = reporter.startFile();
+        const extension = path.extname(file).replace(/^\./, '');
+        let output;
+        try {
+            if (STYLE_EXTENSIONS.has(extension)) {
+                output = source.transformStyles
+                    ? source.transformStyles(file, sourceText, collector, {
+                        cssMode: options.cssMode,
+                    })
+                    : null;
+            }
+            else {
+                output = runTransform(source.transform, file, sourceText, collector, {
+                    cssMode: options.cssMode,
+                }).output;
+            }
+        }
+        catch (error) {
+            io.error(chalk.red(`✖ ${file}: ${error.message}`));
+            reporter.finishFile(file, false, collector.entries);
+            continue;
+        }
+        if (/['"](?:~?bulma\/)/.test(output ?? sourceText)) {
+            bulmaReferenced = true;
+        }
+        if (output !== null) {
+            if (options.print)
+                io.log(output);
+            if (!options.dry)
+                fs.writeFileSync(file, output);
+        }
+        reporter.finishFile(file, output !== null, collector.entries);
+    }
+    return bulmaReferenced;
+}
+/**
+ * Surface files in unparseable formats (.astro, .vue, …) that import the
+ * source library, so a migration never silently skips them.
+ */
+function reportUnsupportedFiles(source, targets, reporter, extensions) {
+    const unsupported = UNSUPPORTED_EXTENSIONS.filter(ext => !extensions.includes(ext));
+    if (unsupported.length === 0)
+        return;
+    for (const file of collectFiles(targets, unsupported)) {
+        const text = fs.readFileSync(file, 'utf8');
+        if (!text.includes(source.name))
+            continue;
+        const collector = reporter.startFile();
+        const line = text.split('\n').findIndex(l => l.includes(source.name)) + 1 || null;
+        collector.add({
+            file,
+            line,
+            rule: 'unsupported-file',
+            message: `imports ${source.name}, but ${path.extname(file)} files cannot be parsed by the codemod — migrate this file by hand`,
+        });
+        reporter.finishFile(file, false, collector.entries);
+    }
+}
+function migrateDependencies(source, targets, reporter, io, options, bulmaReferenced) {
+    if (!options.deps || !source.updateDependencies)
+        return;
+    for (const pkgPath of findPackageJsons(targets)) {
+        const collector = reporter.startFile();
+        let changed = false;
+        try {
+            const raw = fs.readFileSync(pkgPath, 'utf8');
+            const pkg = JSON.parse(raw);
+            const next = source.updateDependencies(pkgPath, pkg, collector, {
+                cssMode: options.cssMode,
+                bulmaReferenced,
+            });
+            if (next !== null) {
+                changed = true;
+                if (!options.dry) {
+                    // Keep the manifest's own indentation (tabs, 4-space, …) so the
+                    // diff stays limited to the dependency changes.
+                    const indent = raw.match(/^([ \t]+)"/m)?.[1] ?? '  ';
+                    fs.writeFileSync(pkgPath, `${JSON.stringify(next, null, indent)}\n`);
+                }
+            }
+        }
+        catch (error) {
+            io.error(chalk.red(`✖ ${pkgPath}: ${error.message}`));
+        }
+        reporter.finishFile(pkgPath, changed, collector.entries);
+        if (changed) {
+            io.log(chalk.yellow(options.dry
+                ? `Would update ${pkgPath}.`
+                : `Updated ${pkgPath} — run your package manager's install to apply.`));
+        }
+    }
+}
+export function createCLI(io = { log: console.log, error: console.error }) {
+    const program = new Command();
+    program
+        .name('bestax-migrate')
+        .description('Codemods that migrate existing apps to @allxsmith/bestax-bulma')
+        .argument('<source>', `library to migrate from (${sourceNames().join(', ')})`)
+        .argument('<paths...>', 'files or directories to transform')
+        .option('-d, --dry', 'dry run — report what would change without writing', false)
+        .option('-p, --print', 'print transformed sources to stdout', false)
+        .option('-e, --extensions <list>', 'comma-separated file extensions to include', 'js,jsx,ts,tsx,scss,sass')
+        .option('--css <mode>', `stylesheet target: ${CSS_MODES.join(', ')}`, 'bestax')
+        .option('--no-deps', 'skip updating package.json dependencies')
+        .action((sourceName, targets, options) => {
+        const source = getSource(sourceName);
+        if (!source) {
+            io.error(`${chalk.red('Unknown source')} "${sourceName}". Available sources: ${sourceNames().join(', ')}`);
+            program.error('', { exitCode: 1 });
+            return;
+        }
+        if (!CSS_MODES.includes(options.css)) {
+            io.error(`${chalk.red('Unknown --css mode')} "${options.css}". Valid modes: ${CSS_MODES.join(', ')}`);
+            program.error('', { exitCode: 1 });
+            return;
+        }
+        const extensions = String(options.extensions)
+            .split(',')
+            .map(ext => ext.trim())
+            .filter(Boolean);
+        let files;
+        try {
+            files = collectFiles(targets, extensions);
+        }
+        catch (error) {
+            io.error(chalk.red(error.message));
+            program.error('', { exitCode: 1 });
+            return;
+        }
+        const runOptions = {
+            dry: Boolean(options.dry),
+            print: Boolean(options.print),
+            deps: options.deps !== false,
+            cssMode: options.css,
+        };
+        const reporter = new Reporter();
+        const bulmaReferenced = migrateFiles(source, files, reporter, io, runOptions);
+        reportUnsupportedFiles(source, targets, reporter, extensions);
+        migrateDependencies(source, targets, reporter, io, runOptions, bulmaReferenced);
+        io.log(reporter.render(source.label + (runOptions.dry ? ' (dry run)' : '')));
+    });
+    return program;
+}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * bin entry for bestax-migrate. Keep this thin — the program lives in cli.ts
+ * so tests can drive it without spawning a process.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/index.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * bin entry for bestax-migrate. Keep this thin — the program lives in cli.ts
+ * so tests can drive it without spawning a process.
+ */
+import { createCLI } from './cli.js';
+const [major] = process.versions.node.split('.').map(Number);
+if (major < 18) {
+    console.error(`bestax-migrate requires Node 18 or newer (found ${process.versions.node}).`);
+    process.exit(1);
+}
+createCLI().parse();

package/dist/report.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Run reporting: collects per-file results and prints the end-of-run summary.
+ * TODO annotations are expected output, not failures — the CLI exits 0 when
+ * files were transformed and TODOs remain.
+ */
+import type { FileResult, TodoCollector, TodoEntry } from './types.js';
+export declare class Reporter {
+    private results;
+    /** Returns a collector for one file's run; call `finishFile` when done. */
+    startFile(): TodoCollector & {
+        entries: TodoEntry[];
+    };
+    finishFile(file: string, changed: boolean, todos: TodoEntry[]): void;
+    get files(): FileResult[];
+    get changedCount(): number;
+    get todos(): TodoEntry[];
+    /** TODO counts grouped by rule, highest first. */
+    todosByRule(): Array<{
+        rule: string;
+        entries: TodoEntry[];
+    }>;
+    render(label: string): string;
+}
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvE,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAoB;IAEnC,2EAA2E;IAC3E,SAAS,IAAI,aAAa,GAAG;QAAE,OAAO,EAAE,SAAS,EAAE,CAAA;KAAE;IAUrD,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI;IAIpE,IAAI,KAAK,IAAI,UAAU,EAAE,CAExB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,KAAK,IAAI,SAAS,EAAE,CAEvB;IAED,kDAAkD;IAClD,WAAW,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAY5D,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CA8B9B"}

package/dist/report.js

@@ -0,0 +1,66 @@
+/**
+ * Run reporting: collects per-file results and prints the end-of-run summary.
+ * TODO annotations are expected output, not failures — the CLI exits 0 when
+ * files were transformed and TODOs remain.
+ */
+import chalk from 'chalk';
+export class Reporter {
+    results = [];
+    /** Returns a collector for one file's run; call `finishFile` when done. */
+    startFile() {
+        const entries = [];
+        return {
+            entries,
+            add(entry) {
+                entries.push(entry);
+            },
+        };
+    }
+    finishFile(file, changed, todos) {
+        this.results.push({ file, changed, todos });
+    }
+    get files() {
+        return this.results;
+    }
+    get changedCount() {
+        return this.results.filter(r => r.changed).length;
+    }
+    get todos() {
+        return this.results.flatMap(r => r.todos);
+    }
+    /** TODO counts grouped by rule, highest first. */
+    todosByRule() {
+        const byRule = new Map();
+        for (const todo of this.todos) {
+            const list = byRule.get(todo.rule) ?? [];
+            list.push(todo);
+            byRule.set(todo.rule, list);
+        }
+        return [...byRule.entries()]
+            .map(([rule, entries]) => ({ rule, entries }))
+            .sort((a, b) => b.entries.length - a.entries.length);
+    }
+    render(label) {
+        const lines = [];
+        lines.push('');
+        lines.push(chalk.bold(`bestax-migrate — ${label}`));
+        lines.push(`${this.results.length} file(s) scanned, ` +
+            `${chalk.green(String(this.changedCount))} transformed, ` +
+            `${chalk.yellow(String(this.todos.length))} TODO(s) left`);
+        for (const { rule, entries } of this.todosByRule()) {
+            lines.push('');
+            lines.push(chalk.yellow(`  ${rule} (${entries.length})`));
+            for (const entry of entries) {
+                const location = entry.line === null ? entry.file : `${entry.file}:${entry.line}`;
+                lines.push(`    ${location} — ${entry.message}`);
+            }
+        }
+        if (this.todos.length > 0) {
+            lines.push('');
+            lines.push(`Search for ${chalk.bold('TODO(bestax-migrate)')} comments to finish the migration by hand,`);
+            lines.push('or let the bestax-migrate skill walk them: https://bestax.io/docs/skills/intro');
+        }
+        lines.push('');
+        return lines.join('\n');
+    }
+}

package/dist/runner.d.ts

@@ -0,0 +1,16 @@
+/**
+ * In-process transform runner shared by the CLI, the fixture tests, and the
+ * kitchen-sink e2e. jscodeshift's worker-based Runner API is deliberately not
+ * used: it spawns CJS child processes (fragile from an ESM package) and hides
+ * per-file results, which the report needs.
+ */
+import type { API } from 'jscodeshift';
+import type { TodoCollector, Transform } from './types.js';
+/** A jscodeshift `api` object for direct transform invocation. */
+export declare function makeApi(): API;
+export interface RunResult {
+    /** Transformed source, or null when the file needed no changes. */
+    output: string | null;
+}
+export declare function runTransform(transform: Transform, path: string, source: string, collector?: TodoCollector, options?: Record<string, unknown>): RunResult;
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AA8C3D,kEAAkE;AAClE,wBAAgB,OAAO,IAAI,GAAG,CAO7B;AAED,MAAM,WAAW,SAAS;IACxB,mEAAmE;IACnE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,wBAAgB,YAAY,CAC1B,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,aAAa,EACzB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACpC,SAAS,CASX"}

package/dist/runner.js

@@ -0,0 +1,69 @@
+/**
+ * In-process transform runner shared by the CLI, the fixture tests, and the
+ * kitchen-sink e2e. jscodeshift's worker-based Runner API is deliberately not
+ * used: it spawns CJS child processes (fragile from an ESM package) and hides
+ * per-file results, which the report needs.
+ */
+import { parse } from '@babel/parser';
+import jscodeshift from 'jscodeshift';
+/**
+ * jscodeshift's stock `tsx` parser options plus `deprecatedImportAssert`,
+ * so files using the legacy `import x from 'y' assert { type: 'json' }`
+ * syntax (still emitted by many tools) parse instead of crashing the run.
+ */
+const PARSER_OPTIONS = {
+    sourceType: 'module',
+    allowImportExportEverywhere: true,
+    allowReturnOutsideFunction: true,
+    startLine: 1,
+    tokens: true,
+    plugins: [
+        'jsx',
+        'asyncGenerators',
+        'decoratorAutoAccessors',
+        'bigInt',
+        'classPrivateMethods',
+        'classPrivateProperties',
+        'classProperties',
+        'decorators-legacy',
+        'doExpressions',
+        'dynamicImport',
+        'exportDefaultFrom',
+        'exportNamespaceFrom',
+        'functionBind',
+        'functionSent',
+        'importAttributes',
+        'deprecatedImportAssert',
+        'importMeta',
+        'nullishCoalescingOperator',
+        'numericSeparator',
+        'objectRestSpread',
+        'optionalCatchBinding',
+        'optionalChaining',
+        ['pipelineOperator', { proposal: 'minimal' }],
+        'throwExpressions',
+        'typescript',
+    ],
+};
+const j = jscodeshift.withParser({
+    parse: (code) => parse(code, PARSER_OPTIONS),
+});
+/** A jscodeshift `api` object for direct transform invocation. */
+export function makeApi() {
+    return {
+        j,
+        jscodeshift: j,
+        stats: () => { },
+        report: () => { },
+    };
+}
+export function runTransform(transform, path, source, collector, options = {}) {
+    const result = transform({ path, source }, makeApi(), {
+        collector,
+        ...options,
+    });
+    if (result === undefined || result === null || result === source) {
+        return { output: null };
+    }
+    return { output: result };
+}

package/dist/sources/react-bulma-components/deps.d.ts

@@ -0,0 +1,9 @@
+/**
+ * package.json migration: swap react-bulma-components for
+ * @allxsmith/bestax-bulma, move Bulma to v1, and replace the dead node-sass
+ * with dart-sass. Pure data-in/data-out — the CLI owns file IO, and no
+ * package manager is ever invoked (the report tells the user to install).
+ */
+import type { DependenciesUpdate } from '../../types.js';
+export declare const updateDependencies: DependenciesUpdate;
+//# sourceMappingURL=deps.d.ts.map

package/dist/sources/react-bulma-components/deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/deps.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAazD,eAAO,MAAM,kBAAkB,EAAE,kBAmGhC,CAAC"}

package/dist/sources/react-bulma-components/deps.js

@@ -0,0 +1,96 @@
+/**
+ * package.json migration: swap react-bulma-components for
+ * @allxsmith/bestax-bulma, move Bulma to v1, and replace the dead node-sass
+ * with dart-sass. Pure data-in/data-out — the CLI owns file IO, and no
+ * package manager is ever invoked (the report tells the user to install).
+ */
+const BESTAX_RANGE = '^5';
+const BULMA_RANGE = '^1.0.4';
+// Bulma v1's sass tree uses `color.channel(…)` — needs dart-sass ≥ 1.79.
+const SASS_RANGE = '^1.79.0';
+const DEP_SECTIONS = ['dependencies', 'devDependencies'];
+function isPreV1(range) {
+    return /^[~^]?0[.x]/.test(range.trim());
+}
+export const updateDependencies = (filePath, pkg, collector, options) => {
+    const changes = [];
+    const next = pkg;
+    const section = (name) => (next[name] ?? undefined);
+    const note = (message) => {
+        changes.push(message);
+        collector?.add({ file: filePath, line: null, rule: 'deps', message });
+    };
+    // react-bulma-components goes away entirely.
+    for (const name of DEP_SECTIONS) {
+        const deps = section(name);
+        if (deps && 'react-bulma-components' in deps) {
+            delete deps['react-bulma-components'];
+            note(`removed react-bulma-components from ${name}`);
+        }
+    }
+    // @allxsmith/bestax-bulma comes in (runtime dependency).
+    const dependencies = (next.dependencies ??= {});
+    if (!dependencies['@allxsmith/bestax-bulma'] &&
+        !section('devDependencies')?.['@allxsmith/bestax-bulma']) {
+        dependencies['@allxsmith/bestax-bulma'] = BESTAX_RANGE;
+        note(`added @allxsmith/bestax-bulma ${BESTAX_RANGE} to dependencies`);
+    }
+    // Bulma: bump a pre-1 range; add only when sources still reference bulma/…
+    // directly (otherwise it arrives transitively via bestax-bulma).
+    let bulmaDeclared = false;
+    for (const name of DEP_SECTIONS) {
+        const deps = section(name);
+        if (deps?.bulma) {
+            bulmaDeclared = true;
+            if (isPreV1(deps.bulma)) {
+                deps.bulma = BULMA_RANGE;
+                note(`bumped bulma to ${BULMA_RANGE} in ${name} (was pre-1.0)`);
+            }
+        }
+    }
+    if (!bulmaDeclared && options.bulmaReferenced) {
+        dependencies.bulma = BULMA_RANGE;
+        note(`added bulma ${BULMA_RANGE} to dependencies (sources import bulma/… directly)`);
+    }
+    // bestax-bulma requires React 18/19; RBC v4 also ran on 17. Report only —
+    // a React major upgrade is the app's own migration step.
+    for (const name of DEP_SECTIONS) {
+        const range = section(name)?.react;
+        if (range && /^[~^]?(?:[0-9]|1[0-7])(?:[.x]|$)/.test(range.trim())) {
+            collector?.add({
+                file: filePath,
+                line: null,
+                rule: 'peer-deps',
+                message: `react ${range} predates bestax-bulma's peer range (^18 || ^19) — upgrade react and react-dom to 18 or 19 before installing`,
+            });
+        }
+    }
+    // Font Awesome older than 6 conflicts with bestax-bulma's optional peer
+    // range and makes `npm install` fail with ERESOLVE. Report only — icon
+    // names change across FA majors, so upgrading is the app's decision.
+    for (const name of DEP_SECTIONS) {
+        const range = section(name)?.['@fortawesome/fontawesome-free'];
+        if (range && /^[~^]?[0-5](?:[.x]|$)/.test(range.trim())) {
+            collector?.add({
+                file: filePath,
+                line: null,
+                rule: 'peer-deps',
+                message: `@fortawesome/fontawesome-free ${range} predates bestax-bulma's optional peer range (^6.7.2 || ^7.0.0) — upgrade it, or install with \`npm install --legacy-peer-deps\``,
+            });
+        }
+    }
+    // node-sass is dead; dart-sass replaces it in the same section.
+    for (const name of DEP_SECTIONS) {
+        const deps = section(name);
+        if (deps && 'node-sass' in deps) {
+            delete deps['node-sass'];
+            note(`removed node-sass from ${name}`);
+            const sassDeclared = DEP_SECTIONS.some(s => section(s)?.sass);
+            if (!sassDeclared) {
+                deps.sass = SASS_RANGE;
+                note(`added sass ${SASS_RANGE} to ${name} (replaces node-sass)`);
+            }
+        }
+    }
+    return changes.length > 0 ? next : null;
+};

package/dist/sources/react-bulma-components/index.d.ts

@@ -0,0 +1,3 @@
+import type { MigrationSource } from '../../types.js';
+export declare const reactBulmaComponents: MigrationSource;
+//# sourceMappingURL=index.d.ts.map

package/dist/sources/react-bulma-components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKtD,eAAO,MAAM,oBAAoB,EAAE,eAMlC,CAAC"}

package/dist/sources/react-bulma-components/index.js

@@ -0,0 +1,10 @@
+import transform from './transform.js';
+import { transformStyles } from './styles.js';
+import { updateDependencies } from './deps.js';
+export const reactBulmaComponents = {
+    name: 'react-bulma-components',
+    label: 'react-bulma-components (v4) → @allxsmith/bestax-bulma',
+    transform,
+    transformStyles,
+    updateDependencies,
+};