bestax-migrate 2.3.8 → 2.4.0

package/dist/sources/_shared/deps-common.js

@@ -0,0 +1,115 @@
+/**
+ * The package.json steps every source's manifest pass takes once the source
+ * library itself is dealt with: bring in bestax-bulma, move the app's Bulma to
+ * v1, report peer ranges bestax-bulma cannot install beside, and swap the
+ * dead node-sass for dart-sass. Pure data-in/data-out, like the passes that
+ * call it: no package manager is ever invoked.
+ */
+import { isPreV1 } from './semver-range.js';
+const BESTAX_RANGE = '^5';
+export 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';
+export const DEP_SECTIONS = ['dependencies', 'devDependencies'];
+export function openManifest(filePath, pkg, collector) {
+    const changes = [];
+    const next = pkg;
+    const report = (rule, message) => collector?.add({ file: filePath, line: null, rule, message });
+    return {
+        next,
+        section: name => (next[name] ?? undefined),
+        note: message => {
+            changes.push(message);
+            report('deps', message);
+        },
+        report,
+        result: () => changes.length > 0 ? next : null,
+    };
+}
+/** Whether every alternative of a plain range names a major below `major`. */
+function majorBelow(range, major) {
+    const majors = range
+        .split('||')
+        .map(set => set.trim().match(/^[~^=v\s]*(\d+)(?:[.\s]|$)/)?.[1]);
+    return (majors.length > 0 &&
+        majors.every(found => found !== undefined && Number(found) < major));
+}
+/**
+ * @allxsmith/bestax-bulma comes in as a runtime dependency. An older major
+ * already declared is reported, not raised: the migrated code is written for
+ * the current one, and moving the app's existing bestax code across majors is
+ * the app's own step.
+ */
+export function addBestax(manifest) {
+    const dependencies = (manifest.next.dependencies ??= {});
+    const declared = dependencies['@allxsmith/bestax-bulma'] ??
+        manifest.section('devDependencies')?.['@allxsmith/bestax-bulma'];
+    if (declared === undefined) {
+        dependencies['@allxsmith/bestax-bulma'] = BESTAX_RANGE;
+        manifest.note(`added @allxsmith/bestax-bulma ${BESTAX_RANGE} to dependencies`);
+    }
+    else if (majorBelow(declared, 5)) {
+        manifest.report('peer-deps', `@allxsmith/bestax-bulma ${declared} is older than the ${BESTAX_RANGE} the migrated code is written for; upgrade it before installing (the bestax-bulma upgrade guides cover each major)`);
+    }
+}
+/**
+ * Bump a pre-1 Bulma range; add one only when sources still reference
+ * bulma/… directly (otherwise it arrives transitively via bestax-bulma).
+ */
+export function moveBulmaToV1(manifest, bulmaReferenced) {
+    const outcome = { declared: null, bumped: false, added: false };
+    for (const name of DEP_SECTIONS) {
+        const deps = manifest.section(name);
+        if (deps?.bulma) {
+            outcome.declared = deps.bulma;
+            if (isPreV1(deps.bulma)) {
+                deps.bulma = BULMA_RANGE;
+                outcome.bumped = true;
+                manifest.note(`bumped bulma to ${BULMA_RANGE} in ${name} (was pre-1.0)`);
+            }
+        }
+    }
+    if (outcome.declared === null && bulmaReferenced) {
+        const dependencies = (manifest.next.dependencies ??= {});
+        dependencies.bulma = BULMA_RANGE;
+        outcome.added = true;
+        manifest.note(`added bulma ${BULMA_RANGE} to dependencies (sources import bulma/… directly)`);
+    }
+    return outcome;
+}
+/**
+ * Report ranges bestax-bulma's peers cannot install beside. Report only: a
+ * React major and a Font Awesome major (whose icon names change) are the
+ * app's own migration steps.
+ */
+export function reportPeerRanges(manifest) {
+    for (const name of DEP_SECTIONS) {
+        const range = manifest.section(name)?.react;
+        if (range && /^[~^]?(?:[0-9]|1[0-7])(?:[.x]|$)/.test(range.trim())) {
+            manifest.report('peer-deps', `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.
+    for (const name of DEP_SECTIONS) {
+        const range = manifest.section(name)?.['@fortawesome/fontawesome-free'];
+        if (range && /^[~^]?[0-5](?:[.x]|$)/.test(range.trim())) {
+            manifest.report('peer-deps', `@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. */
+export function replaceNodeSass(manifest) {
+    for (const name of DEP_SECTIONS) {
+        const deps = manifest.section(name);
+        if (deps && 'node-sass' in deps) {
+            delete deps['node-sass'];
+            manifest.note(`removed node-sass from ${name}`);
+            const sassDeclared = DEP_SECTIONS.some(s => manifest.section(s)?.sass);
+            if (!sassDeclared) {
+                deps.sass = SASS_RANGE;
+                manifest.note(`added sass ${SASS_RANGE} to ${name} (replaces node-sass)`);
+            }
+        }
+    }
+}

package/dist/sources/_shared/jsx-utils.d.ts

@@ -98,8 +98,36 @@ export type Booleanish = 'truthy' | 'falsy' | 'expression';
  * resolvable, so they can't drift out of sync with each other.
  */
 export declare function resolveBooleanish(attr: any): Booleanish;
+/**
+ * A JSX attribute value holding `value`. A JSX attribute string has no
+ * escapes, so the printer's `\"` would end the string early and its `\\` would
+ * double a backslash: a value holding either goes in an expression
+ * (`name={"…"}`), where the escaping means what it says.
+ */
+export declare function jsxStringValue(j: JSCodeshift, value: string): any;
 /** Create `name` (bare boolean) or `name="value"` attribute. */
 export declare function makeAttr(j: JSCodeshift, name: string, value?: string): any;
+/**
+ * Call on the root just before `toSource`. recast reuses the original text of
+ * whatever an edit left alone, but it cannot patch a JSX element the source
+ * wrapped in parentheses (the usual `return ( … )`), so an edit anywhere in
+ * one reprints the whole element. Its printer trims the whitespace at the
+ * edges of every text child and decodes entities, so `</b> ends` came back as
+ * `</b>ends` and `&lt;` as a raw `<`: visible text changed, and some files no
+ * longer parsed. Dropping the parenthesized marker from the node and from
+ * recast's copy of the original lets it patch; the parentheses themselves are
+ * still in the reused text.
+ */
+export declare function forgetJsxParens(j: JSCodeshift, root: any): void;
+/**
+ * Call on the root just before `toSource`. When a statement is added at the
+ * top level (a new import), recast reprints the program: it reuses each
+ * directive's original text, semicolon included, and then adds a semicolon of
+ * its own, so `'use client';` came back as `'use client';;`. A new directive
+ * node has no original text to reuse, and carrying the raw string keeps its
+ * quotes as written.
+ */
+export declare function reprintDirectives(j: JSCodeshift, root: any): void;
 /**
  * Attach a `// TODO(bestax-migrate): ...` leading comment to the closest
  * enclosing statement (comments inside JSX children are not valid JS, so the

package/dist/sources/_shared/jsx-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsx-utils.d.ts","sourceRoot":"","sources":["../../../src/sources/_shared/jsx-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMpD,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,WAAW,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,GAAG,SAAS,CAAC;IACrC,2EAA2E;IAC3E,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,8EAA8E;IAC9E,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B;;;;OAIG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,EAAE,GAAG,IAAI,CAAC;IACzC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,CASvD;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAOhE;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAC3B,CAAC,EAAE,WAAW,EACd,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,GACb,IAAI,CAKN;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,CAIhD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAEpE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAIxD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAGrD;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAE3B;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM,CAM5D;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG,YAAY,CActD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAM1E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,CAIxD;AAED,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAGrD;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAKzD;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAKxD;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;AAE3D;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,UAAU,CAIvD;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,CAK1E;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,IAAI,CAgDN;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAC1B,CAAC,EAAE,WAAW,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,GAAG,EAAE,EACZ,QAAQ,EAAE,GAAG,EAAE,EACf,WAAW,UAAQ,GAClB,GAAG,CAsBL"}
+{"version":3,"file":"jsx-utils.d.ts","sourceRoot":"","sources":["../../../src/sources/_shared/jsx-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAMpD,MAAM,WAAW,gBAAgB;IAC/B,CAAC,EAAE,WAAW,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,aAAa,GAAG,SAAS,CAAC;IACrC,2EAA2E;IAC3E,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACtB,8EAA8E;IAC9E,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5B;;;;OAIG;IACH,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAClC;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC;;;OAGG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,EAAE,GAAG,IAAI,CAAC;IACzC,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,EAAE,GAAG,IAAI,CASvD;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,GAAG,GAAG,CAOhE;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAC3B,CAAC,EAAE,WAAW,EACd,OAAO,EAAE,GAAG,EACZ,MAAM,EAAE,MAAM,GACb,IAAI,CAKN;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,EAAE,CAIhD;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CAEpE;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAIxD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAGrD;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAE3B;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,MAAM,CAM5D;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG,YAAY,CActD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAM1E;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,CAIxD;AAED,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,GAAG,SAAS,CAGrD;AAED,kEAAkE;AAClE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAKzD;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,GAAG,GAAG,GAAG,GAAG,IAAI,CAKxD;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;AAE3D;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,GAAG,GAAG,UAAU,CAIvD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,GAAG,CAGjE;AAED,gEAAgE;AAChE,wBAAgB,QAAQ,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,GAAG,CAG1E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAW/D;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,CAajE;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CACrB,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,IAAI,CAgDN;AAED,uEAAuE;AACvE,wBAAgB,YAAY,CAC1B,CAAC,EAAE,WAAW,EACd,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,EAAE,GAAG,EAAE,EACZ,QAAQ,EAAE,GAAG,EAAE,EACf,WAAW,UAAQ,GAClB,GAAG,CAsBL"}

package/dist/sources/_shared/jsx-utils.js

@@ -148,9 +148,67 @@ export function resolveBooleanish(attr) {
         return 'expression';
     return literal.value ? 'truthy' : 'falsy';
 }
+/**
+ * A JSX attribute value holding `value`. A JSX attribute string has no
+ * escapes, so the printer's `\"` would end the string early and its `\\` would
+ * double a backslash: a value holding either goes in an expression
+ * (`name={"…"}`), where the escaping means what it says.
+ */
+export function jsxStringValue(j, value) {
+    const literal = j.stringLiteral(value);
+    return /["\\]/.test(value) ? j.jsxExpressionContainer(literal) : literal;
+}
 /** Create `name` (bare boolean) or `name="value"` attribute. */
 export function makeAttr(j, name, value) {
-    return j.jsxAttribute(j.jsxIdentifier(name), value === undefined ? null : j.stringLiteral(value));
+    if (value === undefined)
+        return j.jsxAttribute(j.jsxIdentifier(name), null);
+    return j.jsxAttribute(j.jsxIdentifier(name), jsxStringValue(j, value));
+}
+/**
+ * Call on the root just before `toSource`. recast reuses the original text of
+ * whatever an edit left alone, but it cannot patch a JSX element the source
+ * wrapped in parentheses (the usual `return ( … )`), so an edit anywhere in
+ * one reprints the whole element. Its printer trims the whitespace at the
+ * edges of every text child and decodes entities, so `</b> ends` came back as
+ * `</b>ends` and `&lt;` as a raw `<`: visible text changed, and some files no
+ * longer parsed. Dropping the parenthesized marker from the node and from
+ * recast's copy of the original lets it patch; the parentheses themselves are
+ * still in the reused text.
+ */
+export function forgetJsxParens(j, root) {
+    const clear = (node) => {
+        for (const copy of [node, node.original]) {
+            if (copy?.extra?.parenthesized) {
+                delete copy.extra.parenthesized;
+                delete copy.extra.parenStart;
+            }
+        }
+    };
+    root.find(j.JSXElement).forEach((path) => clear(path.node));
+    root.find(j.JSXFragment).forEach((path) => clear(path.node));
+}
+/**
+ * Call on the root just before `toSource`. When a statement is added at the
+ * top level (a new import), recast reprints the program: it reuses each
+ * directive's original text, semicolon included, and then adds a semicolon of
+ * its own, so `'use client';` came back as `'use client';;`. A new directive
+ * node has no original text to reuse, and carrying the raw string keeps its
+ * quotes as written.
+ */
+export function reprintDirectives(j, root) {
+    const program = root.find(j.Program).paths()[0]?.node;
+    if (!program?.directives?.length)
+        return;
+    program.directives = program.directives.map((directive) => {
+        const literal = j.directiveLiteral(directive.value.value);
+        const raw = directive.value.extra?.raw;
+        if (typeof raw === 'string') {
+            literal.extra = { raw, rawValue: directive.value.value };
+        }
+        const fresh = j.directive(literal);
+        fresh.comments = directive.comments;
+        return fresh;
+    });
 }
 /**
  * Attach a `// TODO(bestax-migrate): ...` leading comment to the closest

package/dist/sources/_shared/make-styles-transform.d.ts

@@ -14,8 +14,11 @@
  */
 import type { StylesTransform } from '../../types.js';
 export interface StylesConfig {
-    /** npm package name of the source library, e.g. `rbx`. */
-    packageName: string;
+    /**
+     * npm package name of the source library, e.g. `rbx`. Omitted for a source
+     * with no package, whose stylesheets only ever import Bulma itself.
+     */
+    packageName?: string;
     /** URL of that source's migration guide, linked from every TODO. */
     guideUrl: string;
     /**
@@ -32,6 +35,7 @@ export interface StylesConfig {
  * `packageName` drives two regexes — one matching any `@import` of that
  * package, one narrowing to its *root* stylesheet (which becomes a Bulma v1
  * root rather than being dropped). Everything else is Bulma-side and shared.
+ * Without a package neither can match, and only the Bulma rewriting runs.
  */
 export declare function makeStylesTransform(config: StylesConfig): StylesTransform;
 //# sourceMappingURL=make-styles-transform.d.ts.map

package/dist/sources/_shared/make-styles-transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make-styles-transform.d.ts","sourceRoot":"","sources":["../../../src/sources/_shared/make-styles-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,gBAAgB,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAyMD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CA6UzE"}
+{"version":3,"file":"make-styles-transform.d.ts","sourceRoot":"","sources":["../../../src/sources/_shared/make-styles-transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,gBAAgB,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAyMD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAsVzE"}

package/dist/sources/_shared/make-styles-transform.js

@@ -197,10 +197,14 @@ function report(collector, file, line, rule, message) {
  * `packageName` drives two regexes — one matching any `@import` of that
  * package, one narrowing to its *root* stylesheet (which becomes a Bulma v1
  * root rather than being dropped). Everything else is Bulma-side and shared.
+ * Without a package neither can match, and only the Bulma rewriting runs.
  */
 export function makeStylesTransform(config) {
     const { packageName, guideUrl: GUIDE } = config;
-    const pkg = packageName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // `packageName` is interpolated into messages only after one of these
+    // matched, so the no-package case never reaches them.
+    const NEVER = /(?!)/;
+    const pkg = packageName?.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
     // Already regex fragments — see StylesConfig.
     const roots = config.rootStylesheetSuffixes.join('|');
     /**
@@ -210,11 +214,15 @@ export function makeStylesTransform(config) {
      * and SOURCE_ROOT_STYLESHEET below already accepts that bare form — so
      * requiring the slash here made the bare case unreachable.
      */
-    const SOURCE_STYLE_IMPORT = new RegExp(`^(\\s*)@import\\s+(['"])((?:\\.\\.?/)+node_modules/|~)?${pkg}(?:/[^'"]*)?\\2\\s*;?\\s*(?://[^\\n]*)?\\s*$`);
+    const SOURCE_STYLE_IMPORT = pkg === undefined
+        ? NEVER
+        : new RegExp(`^(\\s*)@import\\s+(['"])((?:\\.\\.?/)+node_modules/|~)?${pkg}(?:/[^'"]*)?\\2\\s*;?\\s*(?://[^\\n]*)?\\s*$`);
     /** Cheap "is this file even about us?" pre-filter (see the guard below). */
-    const SOURCE_MENTION = new RegExp(pkg);
+    const SOURCE_MENTION = pkg === undefined ? NEVER : new RegExp(pkg);
     /** …narrowed to the ones that stand in for a whole Bulma root. */
-    const SOURCE_ROOT_STYLESHEET = new RegExp(`^\\s*@import\\s+(['"])(?:(?:\\.\\.?/)+node_modules/|~)?${pkg}${roots ? `(?:${roots})?` : ''}\\1\\s*;?\\s*(?://[^\\n]*)?\\s*$`);
+    const SOURCE_ROOT_STYLESHEET = pkg === undefined
+        ? NEVER
+        : new RegExp(`^\\s*@import\\s+(['"])(?:(?:\\.\\.?/)+node_modules/|~)?${pkg}${roots ? `(?:${roots})?` : ''}\\1\\s*;?\\s*(?://[^\\n]*)?\\s*$`);
     const transformStyles = (filePath, source, collector, options) => {
         const cssMode = options.cssMode ?? 'bestax';
         // Cheap pre-filter. It must accept a file that names only the SOURCE

package/dist/sources/_shared/props.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/sources/_shared/props.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EASL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAIxB;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,GAAG,GACR,IAAI,CAmBN;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,GACnB,IAAI,CAoBN;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,UAAU,GACjB,IAAI,CAqLN;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GACzC,IAAI,CAQN"}
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../../src/sources/_shared/props.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAUL,KAAK,gBAAgB,EACtB,MAAM,gBAAgB,CAAC;AAIxB;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GAAG,SAAS,GACxB,IAAI,CAEN;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,GAAG,GACR,IAAI,CAmBN;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,GAAG,EAAE,MAAM,EACX,YAAY,EAAE,MAAM,GACnB,IAAI,CAoBN;AAED,mDAAmD;AACnD,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,IAAI,EAAE,GAAG,EACT,MAAM,EAAE,UAAU,GACjB,IAAI,CAqLN;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,EACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,EAClB,OAAO,EAAE,GAAG,EACZ,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,EACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GACzC,IAAI,CAQN"}

package/dist/sources/_shared/props.js

@@ -6,7 +6,7 @@
  * imported, so each source keeps its own `UNIVERSAL_PROPS` in its `mapping.ts`
  * while sharing this interpreter.
  */
-import { addAttr, addTodo, attributesOf, findAttr, literalValueOf, makeAttr, removeAttr, resolveBooleanish, } from './jsx-utils.js';
+import { addAttr, addTodo, attributesOf, findAttr, jsxStringValue, literalValueOf, makeAttr, removeAttr, resolveBooleanish, } from './jsx-utils.js';
 /* eslint-disable @typescript-eslint/no-explicit-any */
 /**
  * Add a converted attribute unless the target name is already present — two
@@ -51,7 +51,7 @@ export function mergeClass(ctx, path, element, cls, originalName) {
         const classes = literal.value.split(/\s+/).filter(Boolean);
         if (!classes.includes(cls))
             classes.push(cls);
-        existing.value = j.stringLiteral(classes.join(' '));
+        existing.value = jsxStringValue(j, classes.join(' '));
         return;
     }
     addTodo(ctx, path, `prop:${originalName}`, `\`${originalName}\` becomes the \`${cls}\` class, but \`className\` is dynamic here; add \`${cls}\` to it by hand`);

package/dist/sources/_shared/specials-utils.d.ts

@@ -29,7 +29,7 @@ export declare function alignTarget(ctx: TransformContext, path: ASTPath<any>, e
  * bound for a plain HTML element (they only exist on bestax components),
  * leaving a TODO when any were dropped.
  */
-export declare function makeStripModifierProps(universalProps: Record<string, PropAction>, responsiveBreakpoints: Record<string, string | null>): (ctx: TransformContext, path: ASTPath<any>, attrs: any[], where: string) => any[];
+export declare function makeStripModifierProps(universalProps: Record<string, PropAction>, responsiveBreakpoints: Record<string, string | null>, refProp?: string): (ctx: TransformContext, path: ASTPath<any>, attrs: any[], where: string) => any[];
 /**
  * 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

package/dist/sources/_shared/specials-utils.d.ts.map

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

package/dist/sources/_shared/specials-utils.js

@@ -39,12 +39,30 @@ export function alignTarget(ctx, path, element, prop, targets, fallback) {
  * bound for a plain HTML element (they only exist on bestax components),
  * leaving a TODO when any were dropped.
  */
-export function makeStripModifierProps(universalProps, responsiveBreakpoints) {
+export function makeStripModifierProps(universalProps, responsiveBreakpoints, refProp) {
     return function stripModifierProps(ctx, path, attrs, where) {
         const kept = [];
         const dropped = [];
         for (const attr of attrs) {
             const name = attr?.name?.name;
+            // Both sources keep their ref escape hatch (`innerRef`, `domRef`) in
+            // the universal table so an unmapped one is flagged rather than passed
+            // through in silence. Neither is a Bulma modifier, and the intrinsic
+            // tag this rewrite produces takes a real `ref` — so it is renamed onto
+            // the tag here. Dropping it would delete a working ref and tell the
+            // user to "restyle with classes", which is advice for a modifier.
+            // The same collision `applyPropAction` guards: with a `ref` already on
+            // the element the rename would emit two, which does not compile.
+            if (refProp && name === refProp) {
+                if (attrs.some(other => other?.name?.name === 'ref')) {
+                    addTodo(ctx, path, `prop:${refProp}`, `${where}: \`${refProp}\` maps to \`ref\`, but \`ref\` is already set on this element, so \`${refProp}\` was dropped — reconcile by hand`);
+                    continue;
+                }
+                attr.name = ctx.j.jsxIdentifier('ref');
+                ctx.dirty = true;
+                kept.push(attr);
+                continue;
+            }
             if (name && (universalProps[name] || name in responsiveBreakpoints)) {
                 dropped.push(name);
             }

package/dist/sources/bloomer/deps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/sources/bloomer/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAUzD,eAAO,MAAM,kBAAkB,EAAE,kBAsHhC,CAAC"}
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../../src/sources/bloomer/deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAUzD,eAAO,MAAM,kBAAkB,EAAE,kBAwChC,CAAC"}

package/dist/sources/bloomer/deps.js

@@ -12,28 +12,17 @@
  * not the app's; if they appear here the app declared them for its own
  * reasons, so they are left alone.
  */
-import { isPreV1 } from '../_shared/semver-range.js';
-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'];
+import { DEP_SECTIONS, addBestax, moveBulmaToV1, openManifest, replaceNodeSass, reportPeerRanges, } from '../_shared/deps-common.js';
 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 });
-    };
+    const manifest = openManifest(filePath, pkg, collector);
     // bloomer goes away entirely.
     let removedSource = false;
     for (const name of DEP_SECTIONS) {
-        const deps = section(name);
+        const deps = manifest.section(name);
         if (deps && 'bloomer' in deps) {
             delete deps.bloomer;
             removedSource = true;
-            note(`removed bloomer from ${name}`);
+            manifest.note(`removed bloomer from ${name}`);
         }
     }
     // The transform deliberately RETAINS imports for components with no bestax
@@ -42,78 +31,14 @@ export const updateDependencies = (filePath, pkg, collector, options) => {
     // imports once the user runs the install the report asks for, so say so
     // rather than letting them find out at build time.
     if (removedSource && options.sourceStillImported) {
-        collector?.add({
-            file: filePath,
-            line: null,
-            rule: 'deps',
-            message: 'bloomer 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 bloomer until you have',
-        });
-    }
-    // @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; bloomer peer-depended on React ^16.2.
-    // 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. (A
-    // bloomer-era app more often loads Font Awesome 4 from a CDN <link>, which
-    // no manifest pass can see; the Icon conversion flags those in the code.)
-    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;
+        manifest.report('deps', 'bloomer 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 bloomer until you have');
+    }
+    addBestax(manifest);
+    moveBulmaToV1(manifest, options.bulmaReferenced);
+    // bloomer peer-depended on React ^16.2. A bloomer-era app more often loads
+    // Font Awesome 4 from a CDN <link>, which no manifest pass can see; the Icon
+    // conversion flags those in the code.
+    reportPeerRanges(manifest);
+    replaceNodeSass(manifest);
+    return manifest.result();
 };

package/dist/sources/bloomer/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/sources/bloomer/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAwDvD,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,gBAAqB,GAC7B,MAAM,GAAG,SAAS,CA86BpB"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/sources/bloomer/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAgDvD,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,gBAAqB,GAC7B,MAAM,GAAG,SAAS,CA8uBpB"}