bestax-migrate 2.1.6 → 2.2.0

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

@@ -1 +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"}
+{"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,kBAqHhC,CAAC"}

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

@@ -21,13 +21,29 @@ export const updateDependencies = (filePath, pkg, collector, options) => {
         collector?.add({ file: filePath, line: null, rule: 'deps', message });
     };
     // react-bulma-components goes away entirely.
+    let removedSource = false;
     for (const name of DEP_SECTIONS) {
         const deps = section(name);
         if (deps && 'react-bulma-components' in deps) {
             delete deps['react-bulma-components'];
+            removedSource = true;
             note(`removed react-bulma-components from ${name}`);
         }
     }
+    // The transform deliberately RETAINS imports for components with no bestax
+    // equivalent (Element, Tile) so a partially migrated app still runs.
+    // Removing the package from the manifest strands exactly those imports once
+    // the user runs the install the report asks for, so say so rather than
+    // letting them find out at build time. rbx has carried this warning since
+    // it shipped; this source retains imports the same way and did not.
+    if (removedSource && options.sourceStillImported) {
+        collector?.add({
+            file: filePath,
+            line: null,
+            rule: 'deps',
+            message: 'react-bulma-components was removed from package.json, but some files still import it for components with no bestax equivalent — resolve those `TODO(bestax-migrate)` imports before installing, or re-add react-bulma-components until you have',
+        });
+    }
     // @allxsmith/bestax-bulma comes in (runtime dependency).
     const dependencies = (next.dependencies ??= {});
     if (!dependencies['@allxsmith/bestax-bulma'] &&

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

@@ -11,7 +11,7 @@
  * TODO. Non-object or dynamic values get a TODO.
  */
 import type { ASTPath } from 'jscodeshift';
-import { type TransformContext } from './jsx-utils.js';
+import { type TransformContext } from '../_shared/jsx-utils.js';
 export type ResponsiveKind = 'generic' | 'columns' | 'column';
 export declare function flattenResponsiveProps(ctx: TransformContext, path: ASTPath<any>, element: any, kind: ResponsiveKind): void;
 //# sourceMappingURL=responsive.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"responsive.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/responsive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAIxB,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAkB9D,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,cAAc,GACnB,IAAI,CAkHN"}
+{"version":3,"file":"responsive.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/responsive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AAIjC,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAkB9D,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,cAAc,GACnB,IAAI,CAkHN"}

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

@@ -11,7 +11,7 @@
  * TODO. Non-object or dynamic values get a TODO.
  */
 import { RESPONSIVE_BREAKPOINTS } from './mapping.js';
-import { addAttr, addTodo, attributesOf, makeAttr, removeAttr, } from './jsx-utils.js';
+import { addAttr, addTodo, attributesOf, makeAttr, removeAttr, } from '../_shared/jsx-utils.js';
 const TEXT_ALIGN_MAP = {
     center: 'centered',
     justify: 'justified',

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

@@ -8,15 +8,9 @@
  * element `replaced` when it substituted the node itself.
  */
 import type { ASTPath } from 'jscodeshift';
-import { type TransformContext } from './jsx-utils.js';
-export interface SpecialResult {
-    /** Override the mapping's `target` for the rename step. */
-    target?: string;
-    /** The node was replaced outright — skip rename and prop passes. */
-    replaced?: boolean;
-    /** Prop names the handler consumed; skipped by the later prop passes. */
-    handledProps?: string[];
-}
+import { type TransformContext } from '../_shared/jsx-utils.js';
+import { type SpecialResult } from '../_shared/specials-utils.js';
+export type { SpecialResult };
 export declare function runSpecial(name: string, ctx: TransformContext, path: ASTPath<any>, element: any): SpecialResult;
 /** Responsive-flattening kinds keyed by mapping special names. */
 export declare const RESPONSIVE_KINDS: Record<string, 'columns' | 'column'>;

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,EAWL,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;AAo3BD,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,EAWL,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,aAAa,EAAE,CAAC;AAsvB9B,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

@@ -8,97 +8,10 @@
  * element `replaced` when it substituted the node itself.
  */
 import { RESPONSIVE_BREAKPOINTS, UNIVERSAL_PROPS } from './mapping.js';
-import { addAttr, addTodo, attributesOf, buildJsxName, findAttr, literalValueOf, makeAttr, plainElement, removeAttr, resolveBooleanish, } from './jsx-utils.js';
-/** Pick a target based on a literal align-style prop, removing the prop. */
-function alignTarget(ctx, path, element, prop, targets, fallback) {
-    const attr = findAttr(element, prop);
-    if (!attr)
-        return { target: fallback };
-    const literal = literalValueOf(attr);
-    if (literal.kind === 'string' && targets[literal.value]) {
-        removeAttr(element, attr);
-        ctx.dirty = true;
-        return { target: targets[literal.value] };
-    }
-    if (literal.kind === 'string') {
-        removeAttr(element, attr);
-        ctx.dirty = true;
-        return { target: fallback };
-    }
-    addTodo(ctx, path, `prop:${prop}`, `\`${prop}\` has a dynamic value; pick between ${Object.values(targets).join(' / ')} by hand`);
-    removeAttr(element, attr);
-    ctx.dirty = true;
-    return { target: fallback };
-}
-/**
- * Filter Bulma modifier props out of an attribute list bound for a plain HTML
- * element (they only exist on bestax components), leaving a TODO when any
- * were dropped.
- */
-function stripModifierProps(ctx, path, attrs, where) {
-    const kept = [];
-    const dropped = [];
-    for (const attr of attrs) {
-        const name = attr?.name?.name;
-        if (name && (UNIVERSAL_PROPS[name] || name in RESPONSIVE_BREAKPOINTS)) {
-            dropped.push(name);
-        }
-        else {
-            kept.push(attr);
-        }
-    }
-    if (dropped.length > 0) {
-        addTodo(ctx, path, 'plain-element', `${where} became a plain element; the Bulma helper prop(s) ${dropped
-            .map(d => `\`${d}\``)
-            .join(', ')} were dropped — restyle with classes`);
-    }
-    return kept;
-}
-/**
- * Consume the element's `className` so a plain-element rewrite can merge it
- * with its hard-coded Bulma class instead of dropping it. A dynamic value
- * can't be merged safely — keep the base class and leave a TODO.
- */
-function mergeClassName(ctx, path, element, base, where) {
-    const attr = findAttr(element, 'className');
-    if (!attr)
-        return base;
-    const literal = literalValueOf(attr);
-    removeAttr(element, attr);
-    if (literal.kind === 'string') {
-        return base ? `${base} ${literal.value}` : literal.value;
-    }
-    addTodo(ctx, path, 'prop:className', base
-        ? `dynamic ${where} className; merge it with the \`${base}\` class by hand`
-        : `dynamic ${where} className; re-apply it to the emitted element by hand`);
-    return base;
-}
-/** Parse an icon-font <i className="..."> into bestax Icon name/library/variant. */
-function parseIconClasses(className) {
-    const tokens = className.trim().split(/\s+/);
-    const faVariant = {
-        fas: 'solid',
-        far: 'regular',
-        fab: 'brands',
-        fal: 'light',
-        fad: 'duotone',
-    };
-    const faStyle = tokens.find(t => faVariant[t]);
-    const faName = tokens.find(t => /^fa-/.test(t) && !/^fa-(lg|xs|sm|\dx|fw|spin|pulse)$/.test(t));
-    if (faStyle && faName) {
-        return {
-            name: faName.replace(/^fa-/, ''),
-            library: 'fa',
-            variant: faVariant[faStyle],
-        };
-    }
-    if (tokens.includes('mdi')) {
-        const mdiName = tokens.find(t => /^mdi-/.test(t) && t !== 'mdi');
-        if (mdiName)
-            return { name: mdiName.replace(/^mdi-/, ''), library: 'mdi' };
-    }
-    return null;
-}
+import { addAttr, addTodo, attributesOf, buildJsxName, findAttr, literalValueOf, makeAttr, plainElement, removeAttr, resolveBooleanish, } from '../_shared/jsx-utils.js';
+import { alignTarget, makeStripModifierProps, mergeClassName, parseIconClasses, } from '../_shared/specials-utils.js';
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const stripModifierProps = makeStripModifierProps(UNIVERSAL_PROPS, RESPONSIVE_BREAKPOINTS);
 const SPECIALS = {
     /**
      * RBC defaults Columns `multiline` to TRUE (Bulma and bestax default to

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

@@ -1,13 +1,13 @@
 /**
- * Stylesheet migration for react-bulma-components apps: Bulma 0.9 Sass
- * (`@import` + `$var !default` overrides, `_all` aggregator partials) →
- * Bulma v1 modules (`@use "bulma/sass" with (…)`), plus the bestax extras.
+ * Stylesheet migration for react-bulma-components apps.
  *
- * Sass has no jscodeshift parser, so this is a conservative line-based text
- * transform: it only rewrites patterns it can prove safe and leaves a
- * `// TODO(bestax-migrate): …` everywhere else (line comments are valid in
- * both SCSS and indented Sass).
+ * All of the work — Bulma 0.9 `@import` → v1 `@use "bulma/sass" with (…)`,
+ * `$var !default` folding, `_all` partial mapping, the bestax extras — lives
+ * in the shared factory. Only the package's own specifiers differ per source.
+ *
+ * RBC's root stylesheets are its Sass entry (`src/index`) and the bundled v3
+ * CSS (`dist/react-bulma-components(.min).css`); both stand in for a whole
+ * Bulma root, so they are replaced rather than dropped.
  */
-import type { StylesTransform } from '../../types.js';
-export declare const transformStyles: StylesTransform;
+export declare const transformStyles: import("../../types.js").StylesTransform;
 //# sourceMappingURL=styles.d.ts.map

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;AA+MrE,eAAO,MAAM,eAAe,EAAE,eA2R7B,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,eAAO,MAAM,eAAe,0CAQ1B,CAAC"}

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

@@ -1,392 +1,20 @@
 /**
- * Stylesheet migration for react-bulma-components apps: Bulma 0.9 Sass
- * (`@import` + `$var !default` overrides, `_all` aggregator partials) →
- * Bulma v1 modules (`@use "bulma/sass" with (…)`), plus the bestax extras.
+ * Stylesheet migration for react-bulma-components apps.
  *
- * Sass has no jscodeshift parser, so this is a conservative line-based text
- * transform: it only rewrites patterns it can prove safe and leaves a
- * `// TODO(bestax-migrate): …` everywhere else (line comments are valid in
- * both SCSS and indented Sass).
- */
-import path from 'node:path';
-const TODO = 'TODO(bestax-migrate)';
-const GUIDE = 'https://bestax.io/docs/guides/getting-started/migration/react-bulma-components';
-const EXTRAS_USE = "@use '@allxsmith/bestax-bulma/scss/extras';";
-/** Bulma v1 sass tree — directories that replaced the 0.9 `_all` partials. */
-const V1_DIRS = new Set([
-    'utilities',
-    'base',
-    'elements',
-    'form',
-    'components',
-    'grid',
-    'layout',
-    'helpers',
-    'themes',
-]);
-/** Known Bulma v1 leaf partials (path after `bulma/sass/`). */
-const V1_LEAVES = new Set([
-    'utilities/initial-variables',
-    'utilities/derived-variables',
-    'utilities/css-variables',
-    'utilities/mixins',
-    'utilities/functions',
-    'utilities/controls',
-    'utilities/extends',
-    'themes/light',
-    'themes/dark',
-    'themes/setup',
-]);
-/**
- * The 0.9 root imports that become `@use "bulma/sass"`. The specifier may be
- * bare (`bulma/bulma`), tilde-prefixed (webpack), or a relative path into
- * node_modules (`../../node_modules/bulma/bulma`, common under Parcel) —
- * relative prefixes are preserved in the emitted `@use`.
- */
-const ROOT_IMPORT = /^(\s*)@import\s+(['"])((?:\.\.?\/)+node_modules\/|~)?bulma\/(?:bulma(?:\.sass|\.scss)?|css\/bulma(?:\.min)?\.css)\2\s*;?\s*$/;
-/** 0.9 partial imports under bulma/sass/… (same prefix forms as the root). */
-const PARTIAL_IMPORT = /^(\s*)@import\s+(['"])((?:\.\.?\/)+node_modules\/|~)?bulma\/sass\/([\w/-]+)\2\s*;?\s*$/;
-/** A preserved path prefix for the rewritten `@use` (tilde never survives). */
-function keptPrefix(prefix) {
-    return prefix && prefix !== '~' ? prefix : '';
-}
-/** Any other line that still `@import`s something bulma-ish. */
-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. 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+['"](?:~|[^'"]*\/)?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*$/;
-/**
- * Strips Sass block comments (slash-star … star-slash spans) from a value
- * before it is analyzed for foldability or top-level commas. A comment can
- * carry an unbalanced quote (an apostrophe in `user's`) or a stray `(`/`$`
- * that would otherwise fool the character scanners into mis-reading the
- * value's structure; the comment is inert to Sass, so removing it for
- * analysis is safe. The emitted value still carries the comment verbatim.
+ * All of the work — Bulma 0.9 `@import` → v1 `@use "bulma/sass" with (…)`,
+ * `$var !default` folding, `_all` partial mapping, the bestax extras — lives
+ * in the shared factory. Only the package's own specifiers differ per source.
  *
- * The scan tracks quote state first and only recognizes a block comment
- * outside a string, in one pass — a bare regex would treat a slash-star …
- * star-slash-shaped span that straddles two quoted strings (opening marker in
- * one string, closing marker in the next) as a comment and delete the real
- * top-level comma between them, so a genuine list would fold unparenthesized.
- * An unterminated comment consumes the rest of the value.
- */
-function stripSassComments(value) {
-    let result = '';
-    let quote = null;
-    let escaped = false;
-    for (let i = 0; i < value.length; i += 1) {
-        const char = value[i];
-        if (quote) {
-            result += char;
-            if (escaped) {
-                escaped = false;
-            }
-            else if (char === '\\') {
-                escaped = true;
-            }
-            else if (char === quote) {
-                quote = null;
-            }
-            continue;
-        }
-        if (char === '/' && value[i + 1] === '*') {
-            const end = value.indexOf('*/', i + 2);
-            if (end === -1)
-                break; // unterminated comment — drop the rest
-            i = end + 1; // resume after the closing */
-            continue;
-        }
-        if (char === '"' || char === "'")
-            quote = char;
-        result += char;
-    }
-    return result;
-}
-/**
- * A value is fold-safe for `with (…)` when it is a plain literal — no
- * function calls, interpolation, variable references, or at-rules. Hex
- * colors (`#ff6b35`) are fine; `#{…}` interpolation is not. Block comments are
- * ignored for this test — their contents don't make the value non-literal.
- */
-function isFoldableValue(value) {
-    return !/[()$@]|#\{/.test(stripSassComments(value));
-}
-/**
- * Whether `value` has a comma outside any quoted string — a bare Sass list
- * (`'Nunito', sans-serif`) that must be parenthesized before it can sit
- * inside `with (…)`, or Dart Sass reads the comma as an argument separator
- * instead of a list delimiter. Block comments are stripped first so a quote or
- * comma inside one (an apostrophe in `user's`) can't skew the scan.
- */
-function hasTopLevelComma(value) {
-    let quote = null;
-    let escaped = false;
-    for (const char of stripSassComments(value)) {
-        if (escaped) {
-            escaped = false;
-            continue;
-        }
-        if (char === '\\') {
-            escaped = true;
-            continue;
-        }
-        if (quote) {
-            if (char === quote)
-                quote = null;
-            continue;
-        }
-        if (char === '"' || char === "'") {
-            quote = char;
-        }
-        else if (char === ',') {
-            return true;
-        }
-    }
-    return false;
-}
-/** Formats a folded value for the `with (…)` clause, parenthesizing a bare list. */
-function formatFoldedValue(value) {
-    return hasTopLevelComma(value) ? `(${value})` : value;
-}
-function report(collector, file, line, rule, message) {
-    collector?.add({ file, line, rule, message });
-}
-export const transformStyles = (filePath, source, collector, options) => {
-    const cssMode = options.cssMode ?? 'bestax';
-    if (!/bulma/.test(source))
-        return null;
-    // Indented-syntax files: flag only — rewriting without a parser is unsafe.
-    if (path.extname(filePath) === '.sass') {
-        if (source.includes(`${TODO}`))
-            return null;
-        report(collector, filePath, 1, 'sass', `indented-syntax file references Bulma; convert its @import lines to @use "bulma/sass" by hand — see ${GUIDE}`);
-        return `// ${TODO}: convert Bulma 0.9 @import lines to @use "bulma/sass" with (…) — see ${GUIDE}\n${source}`;
-    }
-    const lines = source.split('\n');
-    const out = [];
-    let changed = false;
-    let extrasAdded = source.includes('@allxsmith/bestax-bulma/scss');
-    // 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 (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])) {
-                foldableVars.push({ index: i, name: match[1], value: match[2].trim() });
-            }
-            else if (/^\s*\$[\w-]+\s*:/.test(line)) {
-                unsafeVarLines.push(i);
-            }
-        }
-    }
-    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);
-            // 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;
-        }
-        if (folded.has(i)) {
-            changed = true; // folded into with(...) above
-            continue;
-        }
-        const partial = line.match(PARTIAL_IMPORT);
-        if (partial) {
-            const [, indent, , rawPrefix, importPath] = partial;
-            const prefix = keptPrefix(rawPrefix);
-            // Partial-only files (modular builds with no root import) still need
-            // the extras for the bestax components' styling; the extras tree only
-            // reads Bulma utilities, never configures them, so this is load-safe.
-            const pushExtras = () => {
-                if (cssMode !== 'bestax' || extrasAdded || rootImportIndex !== -1) {
-                    return;
-                }
-                out.push(prefix
-                    ? `${indent}@use '${prefix}@allxsmith/bestax-bulma/src/scss/extras';`
-                    : `${indent}${EXTRAS_USE}`);
-                extrasAdded = true;
-            };
-            const segments = importPath.split('/');
-            const last = segments[segments.length - 1].replace(/^_/, '');
-            const dir = segments[0];
-            if ((last === 'all' || last === 'index') && V1_DIRS.has(dir)) {
-                out.push(`${indent}@use '${prefix}bulma/sass/${dir}';`);
-                pushExtras();
-                changed = true;
-                continue;
-            }
-            const leaf = segments.map(s => s.replace(/^_/, '')).join('/');
-            if (V1_DIRS.has(leaf) || V1_LEAVES.has(leaf)) {
-                out.push(`${indent}@use '${prefix}bulma/sass/${leaf}';`);
-                pushExtras();
-                changed = true;
-                continue;
-            }
-            out.push(`${indent}// ${TODO}: this Bulma 0.9 partial path no longer exists in Bulma v1; find its replacement under bulma/sass/ — see ${GUIDE}`);
-            out.push(line);
-            report(collector, filePath, i + 1, 'sass', `Bulma 0.9 partial path \`bulma/sass/${importPath}\` has no direct v1 equivalent`);
-            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) {
-                out.push(`// ${TODO}: bulma-${extension[1]} is a Bulma 0.9-era extension — check its Bulma v1 compatibility; the bestax extras already style Radio/Checkbox and the advanced form controls — see ${GUIDE}`);
-                out.push(line);
-                report(collector, filePath, i + 1, 'sass', `third-party Bulma extension \`bulma-${extension[1]}\` left in place; verify it against Bulma v1 or replace it with the bestax extras`);
-                changed = true;
-                continue;
-            }
-            out.push(`// ${TODO}: Bulma v1 uses @use instead of @import — see ${GUIDE}`);
-            out.push(line);
-            report(collector, filePath, i + 1, 'sass', 'unrecognized Bulma @import left in place; convert to @use by hand');
-            changed = true;
-            continue;
-        }
-        out.push(line);
-    }
-    return changed ? out.join('\n') : null;
-};
+ * RBC's root stylesheets are its Sass entry (`src/index`) and the bundled v3
+ * CSS (`dist/react-bulma-components(.min).css`); both stand in for a whole
+ * Bulma root, so they are replaced rather than dropped.
+ */
+import { makeStylesTransform } from '../_shared/make-styles-transform.js';
+export const transformStyles = makeStylesTransform({
+    packageName: 'react-bulma-components',
+    guideUrl: 'https://bestax.io/docs/guides/getting-started/migration/react-bulma-components',
+    rootStylesheetSuffixes: [
+        '/src/index(?:\\.s[ac]ss)?',
+        '/dist/react-bulma-components(?:\\.min)?\\.css',
+    ],
+});

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

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAoCvD,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,gBAAqB,GAC7B,MAAM,GAAG,SAAS,CAofpB"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AA2CvD,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,gBAAqB,GAC7B,MAAM,GAAG,SAAS,CAyzBpB"}