bestax-migrate 2.1.1 → 2.1.3

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAqBxE,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;AA2ID;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,KAAK,EACT,KAAK,GAAE,QAAwB,EAC/B,MAAM,GAAE,QAAyB,EAGjC,aAAa,GAAE,OAAO,eAAiC,GACtD,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAyBzB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,EAAE,EAAE,KAAK,EACT,aAAa,GAAE,CAAC,EAAE,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAA0B,GAC7E,OAAO,CAAC,IAAI,CAAC,CAqBf;AAYD,wBAAgB,SAAS,CACvB,EAAE,GAAE,KAAkD,GACrD,OAAO,CAkHT"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEtD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAoB,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAqBxE,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;AA4ID;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,EAAE,EAAE,KAAK,EACT,KAAK,GAAE,QAAwB,EAC/B,MAAM,GAAE,QAAyB,EAGjC,aAAa,GAAE,OAAO,eAAiC,GACtD,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAyBzB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,EAAE,EAAE,KAAK,EACT,aAAa,GAAE,CAAC,EAAE,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,GAAG,IAAI,CAA0B,GAC7E,OAAO,CAAC,IAAI,CAAC,CAqBf;AAYD,wBAAgB,SAAS,CACvB,EAAE,GAAE,KAAkD,GACrD,OAAO,CAkHT"}

package/dist/cli.js

@@ -91,6 +91,7 @@ function migrateFiles(source, files, reporter, io, options) {
                 output = source.transformStyles
                     ? source.transformStyles(file, sourceText, collector, {
                         cssMode: options.cssMode,
+                        deps: options.deps,
                     })
                     : null;
             }

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

@@ -1 +1 @@
-{"version":3,"file":"specials.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/specials.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAUL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AA+xBD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,GACX,aAAa,CAIf;AAED,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAGjE,CAAC"}
+{"version":3,"file":"specials.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/specials.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAUL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAIxB,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AA21BD,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,GACX,aAAa,CAIf;AAED,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAGjE,CAAC"}

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

@@ -153,24 +153,68 @@ const SPECIALS = {
         addTodo(ctx, path, 'prop:remove', '`remove` has a dynamic value; this can render as either a Button or a Delete cross — split the branch by hand');
         return {};
     },
-    /** Heading → Title / SubTitle / plain `.heading` paragraph. */
+    /**
+     * Heading → Title / SubTitle / plain `.heading` paragraph, matching RBC's
+     * `title: !subtitle && !heading` / `subtitle: subtitle` — the *value* of
+     * each prop picks the target, not merely whether it was passed. Any
+     * statically-known literal resolves to a fixed truthiness at codemod time
+     * (a bare prop and `heading={true}`/`heading="heading"` are all truthy;
+     * `heading={false}`/`heading=""`/`heading={0}` are falsy and equivalent to
+     * the prop being absent), exactly as RBC evaluates the prop at runtime —
+     * this mirrors the Button `remove` handler so the two don't contradict each
+     * other on string/number literals. Only a genuine expression can't be
+     * resolved: it's left in place with a TODO and a conservative
+     * (Title/SubTitle, never the structural plain-element rewrite) fallback so
+     * the branch can be split by hand. The subtitle class is applied
+     * independently of heading in RBC, so a dynamic `subtitle` blocks the
+     * structural `heading` collapse — collapsing would silently drop it.
+     */
     heading(ctx, path, element) {
         const headingAttr = findAttr(element, 'heading');
-        if (headingAttr) {
+        const subtitleAttr = findAttr(element, 'subtitle');
+        const headingLit = headingAttr ? literalValueOf(headingAttr) : undefined;
+        const subtitleLit = subtitleAttr ? literalValueOf(subtitleAttr) : undefined;
+        const headingDynamic = headingLit?.kind === 'expression';
+        const subtitleDynamic = subtitleLit?.kind === 'expression';
+        // A resolvable literal (boolean/string/number) collapses to its runtime
+        // truthiness; an expression stays dynamic.
+        const headingTruthy = !!headingLit && headingLit.kind !== 'expression' && !!headingLit.value;
+        const subtitleTruthy = !!subtitleLit && subtitleLit.kind !== 'expression' && !!subtitleLit.value;
+        // Dynamic values can't be resolved to a target: leave the prop on the
+        // element (so its expression survives for hand-splitting) plus a TODO.
+        if (subtitleDynamic) {
+            addTodo(ctx, path, 'prop:subtitle', '`subtitle` has a dynamic value; pick between Title / SubTitle by hand');
+        }
+        if (headingDynamic) {
+            addTodo(ctx, path, 'prop:heading', '`heading` has a dynamic value; when truthy it renders a plain `<p className="heading">` instead of Title/SubTitle — resolve by hand');
+        }
+        // A truthy literal `heading` collapses to a plain `.heading` paragraph —
+        // but only when `subtitle` isn't a dynamic value the collapse would drop.
+        // A truthy *literal* `subtitle` is safe to collapse: RBC applies its class
+        // independently, so it rides along on the paragraph as `heading subtitle`
+        // (dropping it would be the same silent loss the dynamic guard prevents).
+        if (headingTruthy && !subtitleDynamic) {
             removeAttr(element, headingAttr);
-            const className = mergeClassName(ctx, path, element, 'heading', 'Heading');
+            const className = mergeClassName(ctx, path, element, subtitleTruthy ? 'heading subtitle' : 'heading', 'Heading');
             const rest = stripModifierProps(ctx, path, attributesOf(element).filter(a => !['size', 'weight', 'spaced', 'subtitle'].includes(a.name.name)), 'Heading');
             const replacement = plainElement(ctx.j, 'p', className, rest, element.children ?? []);
             path.replace(replacement);
             ctx.dirty = true;
             return { replaced: true };
         }
-        const subtitleAttr = findAttr(element, 'subtitle');
-        if (subtitleAttr) {
+        // A resolvable literal `heading` that didn't collapse (falsy, or truthy
+        // but blocked by a dynamic subtitle) behaves as if the prop were absent —
+        // drop it. A dynamic `heading` stays put (its TODO is already filed above).
+        if (headingLit && !headingDynamic) {
+            removeAttr(element, headingAttr);
+            ctx.dirty = true;
+        }
+        if (subtitleLit && !subtitleDynamic) {
             removeAttr(element, subtitleAttr);
             ctx.dirty = true;
-            return { target: 'SubTitle' };
+            return { target: subtitleTruthy ? 'SubTitle' : 'Title' };
         }
+        // Dynamic subtitle (attr kept) or no subtitle → conservative Title.
         return { target: 'Title' };
     },
     'level-side'(ctx, path, element) {

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

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,gBAAgB,CAAC;AAuKrE,eAAO,MAAM,eAAe,EAAE,eAmL7B,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,gBAAgB,CAAC;AA+MrE,eAAO,MAAM,eAAe,EAAE,eA2R7B,CAAC"}

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

@@ -55,9 +55,43 @@ const OTHER_BULMA_IMPORT = /^\s*@import\s+['"][^'"]*bulma[^'"]*['"]/;
 /**
  * Third-party Bulma extension packages (`bulma-checkradio`, `bulma-switch`,
  * …) — 0.9-era add-ons whose v1 compatibility varies; several are covered
- * by the bestax extras.
+ * by the bestax extras. The `bulma-` package name must start at a specifier
+ * segment boundary (right after the quote/`~`, or after a `/`) so this does
+ * not also match a name that merely *contains* `bulma-`, like
+ * `react-bulma-components` (see EXTENSION_IMPORT's own regression test).
  */
-const EXTENSION_IMPORT = /^\s*@import\s+['"][^'"]*\bbulma-([\w-]+?)(?:\/|\.|['"])/;
+const EXTENSION_IMPORT = /^\s*@import\s+['"](?:~|[^'"]*\/)?bulma-([\w-]+?)(?:\/|\.|['"])/;
+/**
+ * The source library's own stylesheet. This is not a third-party extension:
+ * it is the library being migrated away from, and `deps.ts` removes its
+ * package.json entry in the same run, so leaving the import in place breaks
+ * the Sass build. Any `react-bulma-components/…` specifier is dead the same
+ * way — the documented v3 setup paths (the bundled CSS, the "advanced" Sass
+ * entry point), but also deep partials and extensionless forms — so, like
+ * `transform.ts`, we match on the package prefix rather than enumerating
+ * shapes. The prefix may be bare, `~`-prefixed, or a relative node_modules
+ * path (the Parcel form `ROOT_IMPORT` also supports).
+ */
+const RBC_STYLE_IMPORT = /^(\s*)@import\s+(['"])((?:\.\.?\/)+node_modules\/|~)?react-bulma-components\/[^'"]*\2\s*;?\s*$/;
+/**
+ * The subset of RBC stylesheet imports that are the library's own *root*: the
+ * bare package specifier, the documented Sass entry point (`src/index`), and
+ * the bundled v3 CSS (`dist/react-bulma-components(.min).css`). These pull in
+ * the whole library, which `bulma/sass` supersedes — so when the file already
+ * has a Bulma root, dropping one of these loses nothing. A deep RBC partial
+ * (`src/components/navbar.sass`) is NOT a root: `bulma/sass` doesn't carry a
+ * given partial's styles, so removing one silently would drop CSS. We flag
+ * those instead (the package's "never a silent skip" rule).
+ */
+const RBC_ROOT_STYLESHEET = /^\s*@import\s+(['"])(?:(?:\.\.?\/)+node_modules\/|~)?react-bulma-components(?:\/src\/index(?:\.s[ac]ss)?|\/dist\/react-bulma-components(?:\.min)?\.css)?\1\s*;?\s*$/;
+/**
+ * A Bulma module root already pulled in via `@use` — the file's own
+ * `@use 'bulma/sass'` (any prefix, configured or not) or the bestax bundle
+ * (`scss/bestax`, which itself loads `bulma/sass with (…)`). When one is
+ * present we must not emit a second root: a duplicate `bulma/sass` namespace,
+ * or reconfiguring an already-loaded module, is a hard Sass error.
+ */
+const USE_BULMA_ROOT = /^\s*@use\s+(['"])(?:~|(?:\.\.?\/)+node_modules\/)?(?:bulma\/sass|@allxsmith\/bestax-bulma\/(?:src\/)?scss\/bestax)\1/;
 /** Any `$name: value;` declaration (with or without `!default`). */
 const VAR_DECL = /^\s*\$([\w-]+)\s*:\s*(.+?)\s*(!default)?\s*;\s*$/;
 /**
@@ -171,12 +205,23 @@ export const transformStyles = (filePath, source, collector, options) => {
     const out = [];
     let changed = false;
     let extrasAdded = source.includes('@allxsmith/bestax-bulma/scss');
-    // Pass 1: find safe leading variable overrides and the first root import.
+    // Pass 1: locate the file's Bulma root and the safe leading variable
+    // overrides that fold into it. A real `bulma/…` @import root wins; otherwise
+    // the RBC stylesheet, which we rewrite into a root the same way — so a file
+    // that starts from RBC and one that starts from a bulma @import converge on
+    // the identical shape. A pre-existing `@use` root means we create no new one.
     const rootImportIndex = lines.findIndex(line => ROOT_IMPORT.test(line));
+    const rbcRootIndex = lines.findIndex(line => RBC_STYLE_IMPORT.test(line) && !line.includes(TODO));
+    const hasUseBulmaRoot = lines.some(line => USE_BULMA_ROOT.test(line));
+    const foldTargetIndex = hasUseBulmaRoot
+        ? -1
+        : rootImportIndex !== -1
+            ? rootImportIndex
+            : rbcRootIndex;
     const foldableVars = [];
     const unsafeVarLines = [];
-    if (rootImportIndex !== -1) {
-        for (let i = 0; i < rootImportIndex; i += 1) {
+    if (foldTargetIndex !== -1) {
+        for (let i = 0; i < foldTargetIndex; i += 1) {
             const line = lines[i];
             const match = line.match(VAR_DECL);
             if (match && isFoldableValue(match[2])) {
@@ -188,36 +233,43 @@ export const transformStyles = (filePath, source, collector, options) => {
         }
     }
     const folded = new Set(foldableVars.map(v => v.index));
+    /**
+     * Emit a Bulma module root at `indent` (folding the leading var overrides
+     * gathered above into `with (…)`, flagging any unsafe ones), then, in
+     * bestax mode, the extras. `prefix` is a preserved relative-path prefix
+     * (raw-file toolchains resolve paths, not package specifiers) or ''.
+     */
+    const emitBulmaRoot = (indent, prefix, lineNo) => {
+        const bulmaSass = `${prefix}bulma/sass`;
+        if (foldableVars.length > 0) {
+            out.push(`${indent}@use '${bulmaSass}' with (`);
+            foldableVars.forEach(({ name, value }, index) => {
+                const comma = index < foldableVars.length - 1 ? ',' : '';
+                out.push(`${indent}  $${name}: ${formatFoldedValue(value)}${comma}`);
+            });
+            out.push(`${indent});`);
+        }
+        else {
+            out.push(`${indent}@use '${bulmaSass}';`);
+        }
+        if (unsafeVarLines.length > 0) {
+            out.push(`${indent}// ${TODO}: the variable override(s) above use computed values; move them into the @use "bulma/sass" with (…) configuration by hand`);
+            report(collector, filePath, lineNo, 'sass', 'variable overrides with computed values could not be folded into `with (…)`');
+        }
+        if (cssMode === 'bestax' && !extrasAdded) {
+            out.push(prefix
+                ? `${indent}@use '${prefix}@allxsmith/bestax-bulma/src/scss/extras';`
+                : `${indent}${EXTRAS_USE}`);
+            extrasAdded = true;
+        }
+    };
     for (let i = 0; i < lines.length; i += 1) {
         const line = lines[i];
         if (i === rootImportIndex) {
             const rootMatch = line.match(ROOT_IMPORT);
-            const indent = rootMatch?.[1] ?? '';
-            const bulmaSass = `${keptPrefix(rootMatch?.[3])}bulma/sass`;
-            if (foldableVars.length > 0) {
-                out.push(`${indent}@use '${bulmaSass}' with (`);
-                foldableVars.forEach(({ name, value }, index) => {
-                    const comma = index < foldableVars.length - 1 ? ',' : '';
-                    out.push(`${indent}  $${name}: ${formatFoldedValue(value)}${comma}`);
-                });
-                out.push(`${indent});`);
-            }
-            else {
-                out.push(`${indent}@use '${bulmaSass}';`);
-            }
-            if (unsafeVarLines.length > 0) {
-                out.push(`${indent}// ${TODO}: the variable override(s) above use computed values; move them into the @use "bulma/sass" with (…) configuration by hand`);
-                report(collector, filePath, i + 1, 'sass', 'variable overrides with computed values could not be folded into `with (…)`');
-            }
-            if (cssMode === 'bestax' && !extrasAdded) {
-                // A path-prefixed root import means the toolchain resolves raw file
-                // paths, not package specifiers — point at the shipped file directly.
-                const extrasPrefix = keptPrefix(rootMatch?.[3]);
-                out.push(extrasPrefix
-                    ? `${indent}@use '${extrasPrefix}@allxsmith/bestax-bulma/src/scss/extras';`
-                    : `${indent}${EXTRAS_USE}`);
-                extrasAdded = true;
-            }
+            // A path-prefixed root import means the toolchain resolves raw file
+            // paths, not package specifiers — point at the shipped files directly.
+            emitBulmaRoot(rootMatch?.[1] ?? '', keptPrefix(rootMatch?.[3]), i + 1);
             changed = true;
             continue;
         }
@@ -263,6 +315,62 @@ export const transformStyles = (filePath, source, collector, options) => {
             changed = true;
             continue;
         }
+        const rbcStyle = line.match(RBC_STYLE_IMPORT);
+        if (rbcStyle && !line.includes(TODO)) {
+            const indent = rbcStyle[1];
+            const prefix = keptPrefix(rbcStyle[3]);
+            if (i === rbcRootIndex && rootImportIndex === -1 && !hasUseBulmaRoot) {
+                // The library's own stylesheet never resolves post-migration (deps.ts
+                // removes react-bulma-components in the same run), and it is this
+                // file's only Bulma root, so rewrite it into one — the same shape the
+                // @import root path emits, folding any leading var overrides. Emitting
+                // a real `bulma/sass` (+ extras) rather than the hard-configured
+                // bestax bundle keeps this convergent with the @import path and avoids
+                // reconfiguring `bulma/sass` if a themed root exists elsewhere.
+                emitBulmaRoot(indent, prefix, i + 1);
+                if (cssMode === 'keep') {
+                    // The replacement is unavoidable even in keep mode: RBC's own
+                    // stylesheet is a v3 (Bulma 0.9) asset the migrated v1 components
+                    // can't use. What changed depends on whether the manifest step ran.
+                    const depsRan = options.deps !== false;
+                    const detail = depsRan
+                        ? 'its package.json entry is removed, so the old import no longer resolves; install bulma@^1'
+                        : 'it targets Bulma 0.9, not the v1 your components now use; --no-deps kept the dependency, so install bulma@^1 alongside it';
+                    out.push(`${indent}// ${TODO}: replaced react-bulma-components's own stylesheet with @use 'bulma/sass' — ${detail} — see ${GUIDE}`);
+                    report(collector, filePath, i + 1, 'sass', depsRan
+                        ? "replaced react-bulma-components's stylesheet import with bulma/sass; the package is removed from dependencies, so the old import would not resolve"
+                        : "replaced react-bulma-components's stylesheet import with bulma/sass; it is a Bulma 0.9 asset the migrated v1 components can't use (--no-deps left the package in place)");
+                }
+                else {
+                    // bestax/bulma modes rewrite the file's root without a TODO — still
+                    // report it so the migration summary reflects the restructured root.
+                    report(collector, filePath, i + 1, 'sass', "replaced react-bulma-components's stylesheet import with a Bulma v1 @use root");
+                }
+            }
+            else {
+                // A Bulma root already covers this file (a `bulma/…` @import we
+                // convert, the file's own `@use` root, or an earlier RBC line we
+                // rewrote). In bestax mode keep that root and add only the extras —
+                // never a second root, never the configured bundle that would
+                // reconfigure an already-loaded module.
+                if (cssMode === 'bestax' && !extrasAdded) {
+                    out.push(prefix
+                        ? `${indent}@use '${prefix}@allxsmith/bestax-bulma/src/scss/extras';`
+                        : `${indent}${EXTRAS_USE}`);
+                    extrasAdded = true;
+                }
+                // Dropping the RBC line is only safe for its root/index stylesheet,
+                // which `bulma/sass` supersedes. A deep RBC partial can carry styles
+                // `bulma/sass` doesn't, so removing it silently would lose CSS — flag
+                // it with a TODO + report entry instead (never a silent skip).
+                if (!RBC_ROOT_STYLESHEET.test(line)) {
+                    out.push(`${indent}// ${TODO}: dropped a react-bulma-components stylesheet partial that has no Bulma v1 root equivalent; port any styles it carried beyond Bulma's own by hand — see ${GUIDE}`);
+                    report(collector, filePath, i + 1, 'sass', 'react-bulma-components stylesheet partial dropped; port any styles it carried beyond Bulma’s own by hand');
+                }
+            }
+            changed = true;
+            continue;
+        }
         if (OTHER_BULMA_IMPORT.test(line) && !line.includes(TODO)) {
             const extension = line.match(EXTENSION_IMPORT);
             if (extension) {

package/dist/types.d.ts

@@ -95,6 +95,13 @@ export type CssMode = 'bestax' | 'bulma' | 'keep';
 export interface TransformOptions {
     collector?: TodoCollector;
     cssMode?: CssMode;
+    /**
+     * Whether the run also updates package.json (false under `--no-deps`).
+     * The stylesheet transform's messaging depends on it: it may only claim a
+     * dependency was removed when the manifest step actually runs. Undefined is
+     * treated as the CLI default (deps on).
+     */
+    deps?: boolean;
     [key: string]: unknown;
 }
 /** Options for the package.json dependency updater. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bestax-migrate",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "description": "Codemods for migrating existing React apps from other Bulma libraries to @allxsmith/bestax-bulma",
   "type": "module",
   "bin": {