bestax-migrate 0.0.1

package/dist/sources/react-bulma-components/jsx-utils.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Small AST helpers shared by the react-bulma-components transform passes.
+ * All functions operate on the babel/tsx AST that jscodeshift's `tsx` parser
+ * produces, via the `j` builder API.
+ */
+import type { JSCodeshift } from 'jscodeshift';
+import type { ASTPath } from 'jscodeshift';
+import type { TodoCollector } from '../../types.js';
+export interface TransformContext {
+    j: JSCodeshift;
+    file: string;
+    collector: TodoCollector | undefined;
+    /** RBC top-level import names that must survive the import rewrite. */
+    retained: Set<string>;
+    /** bestax-bulma imports: imported name → local name (aliased on conflict). */
+    needed: Map<string, string>;
+    /**
+     * Registers a bestax root name for import and returns the local name to use
+     * in JSX — an alias like `BulmaField` when the plain name collides with an
+     * existing binding in the file.
+     */
+    reserve: (root: string) => string;
+    /**
+     * Target overrides set by a parent's structural handler for child elements
+     * it has contextual knowledge about (e.g. a Navbar.Dropdown inside a
+     * Navbar.Item becomes Navbar.DropdownMenu).
+     */
+    overrides: WeakMap<object, string>;
+    /** Resolves a JSX name node to its canonical RBC path (set by transform). */
+    resolve?: (name: any) => string[] | null;
+    dirty: boolean;
+}
+/** Flatten a JSXIdentifier / JSXMemberExpression chain into name parts. */
+export declare function jsxNameParts(name: any): string[] | null;
+/** Build a JSXIdentifier / JSXMemberExpression chain from a dotted name. */
+export declare function buildJsxName(j: JSCodeshift, dotted: string): any;
+/** Rename both the opening and (when present) closing element. */
+export declare function renameElement(j: JSCodeshift, element: any, dotted: string): void;
+/** Non-spread attributes of an element. */
+export declare function attributesOf(element: any): any[];
+export declare function findAttr(element: any, name: string): any | undefined;
+export declare function removeAttr(element: any, attr: any): void;
+export declare function addAttr(element: any, attr: any): void;
+export type LiteralValue = {
+    kind: 'boolean';
+    value: boolean;
+} | {
+    kind: 'string';
+    value: string;
+} | {
+    kind: 'number';
+    value: number;
+} | {
+    kind: 'expression';
+};
+/** Extract the literal value of a JSX attribute, if it has one. */
+export declare function literalValueOf(attr: any): LiteralValue;
+/** Create `name` (bare boolean) or `name="value"` attribute. */
+export declare function makeAttr(j: JSCodeshift, name: string, value?: string): any;
+/**
+ * Attach a `// TODO(bestax-migrate): ...` leading comment to the closest
+ * enclosing statement (comments inside JSX children are not valid JS, so the
+ * statement is the nearest place a line comment can live), and mirror the
+ * entry into the report collector with the element's original line number.
+ */
+export declare function addTodo(ctx: TransformContext, path: ASTPath<any>, rule: string, message: string): void;
+/** Build a plain HTML element (used where bestax has no component). */
+export declare function plainElement(j: JSCodeshift, tag: string, className: string | undefined, attrs: any[], children: any[], selfClosing?: boolean): any;
+//# sourceMappingURL=jsx-utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-utils.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/jsx-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;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,uEAAuE;IACvE,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,6EAA6E;IAC7E,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,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,GAAG,YAAY,CActD;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,CAuCN;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,CAcL"}

package/dist/sources/react-bulma-components/jsx-utils.js

@@ -0,0 +1,130 @@
+/**
+ * Small AST helpers shared by the react-bulma-components transform passes.
+ * All functions operate on the babel/tsx AST that jscodeshift's `tsx` parser
+ * produces, via the `j` builder API.
+ */
+/** Flatten a JSXIdentifier / JSXMemberExpression chain into name parts. */
+export function jsxNameParts(name) {
+    if (!name)
+        return null;
+    if (name.type === 'JSXIdentifier')
+        return [name.name];
+    if (name.type === 'JSXMemberExpression') {
+        const object = jsxNameParts(name.object);
+        if (!object)
+            return null;
+        return [...object, name.property.name];
+    }
+    return null;
+}
+/** Build a JSXIdentifier / JSXMemberExpression chain from a dotted name. */
+export function buildJsxName(j, dotted) {
+    const parts = dotted.split('.');
+    let node = j.jsxIdentifier(parts[0]);
+    for (const part of parts.slice(1)) {
+        node = j.jsxMemberExpression(node, j.jsxIdentifier(part));
+    }
+    return node;
+}
+/** Rename both the opening and (when present) closing element. */
+export function renameElement(j, element, dotted) {
+    element.openingElement.name = buildJsxName(j, dotted);
+    if (element.closingElement) {
+        element.closingElement.name = buildJsxName(j, dotted);
+    }
+}
+/** Non-spread attributes of an element. */
+export function attributesOf(element) {
+    return (element.openingElement.attributes ?? []).filter((a) => a.type === 'JSXAttribute');
+}
+export function findAttr(element, name) {
+    return attributesOf(element).find((a) => a.name.name === name);
+}
+export function removeAttr(element, attr) {
+    const attrs = element.openingElement.attributes ?? [];
+    const index = attrs.indexOf(attr);
+    if (index !== -1)
+        attrs.splice(index, 1);
+}
+export function addAttr(element, attr) {
+    element.openingElement.attributes = element.openingElement.attributes ?? [];
+    element.openingElement.attributes.push(attr);
+}
+/** Extract the literal value of a JSX attribute, if it has one. */
+export function literalValueOf(attr) {
+    if (attr.value == null)
+        return { kind: 'boolean', value: true };
+    const v = attr.value;
+    if (v.type === 'StringLiteral') {
+        return { kind: 'string', value: v.value };
+    }
+    if (v.type === 'JSXExpressionContainer') {
+        const e = v.expression;
+        if (e.type === 'StringLiteral')
+            return { kind: 'string', value: e.value };
+        if (e.type === 'NumericLiteral')
+            return { kind: 'number', value: e.value };
+        if (e.type === 'BooleanLiteral')
+            return { kind: 'boolean', value: e.value };
+        return { kind: 'expression' };
+    }
+    return { kind: 'expression' };
+}
+/** 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));
+}
+/**
+ * Attach a `// TODO(bestax-migrate): ...` leading comment to the closest
+ * enclosing statement (comments inside JSX children are not valid JS, so the
+ * statement is the nearest place a line comment can live), and mirror the
+ * entry into the report collector with the element's original line number.
+ */
+export function addTodo(ctx, path, rule, message) {
+    const { j } = ctx;
+    let statement = null;
+    let current = path;
+    while (current && current.node) {
+        if (/Statement$|Declaration$/.test(current.node.type) &&
+            current.node.type !== 'Program') {
+            statement = current;
+            break;
+        }
+        current = current.parent;
+    }
+    // A comment on the declaration inside `export const x = …` prints between
+    // `export` and `const`; hoist it to the export statement itself.
+    if (statement?.parent?.node &&
+        /^Export(Named|Default)Declaration$/.test(statement.parent.node.type)) {
+        statement = statement.parent;
+    }
+    const text = ` TODO(bestax-migrate): ${message}`;
+    if (statement) {
+        const node = statement.node;
+        node.comments = node.comments ?? [];
+        const exists = node.comments.some((c) => c.value === text);
+        if (!exists) {
+            const comment = j.commentLine(text, true, false);
+            node.comments.push(comment);
+        }
+    }
+    ctx.collector?.add({
+        file: ctx.file,
+        line: path.node?.loc?.start?.line ?? null,
+        rule,
+        message,
+    });
+    ctx.dirty = true;
+}
+/** Build a plain HTML element (used where bestax has no component). */
+export function plainElement(j, tag, className, attrs, children, selfClosing = false) {
+    const allAttrs = [...attrs];
+    if (className) {
+        allAttrs.unshift(makeAttr(j, 'className', className));
+    }
+    const opening = j.jsxOpeningElement(j.jsxIdentifier(tag), allAttrs, selfClosing);
+    const closing = selfClosing
+        ? null
+        : j.jsxClosingElement(j.jsxIdentifier(tag));
+    return j.jsxElement(opening, closing, selfClosing ? [] : children);
+}

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

@@ -0,0 +1,31 @@
+/**
+ * Declarative react-bulma-components (v4) → @allxsmith/bestax-bulma mapping.
+ *
+ * Every entry was verified against the react-bulma-components 4.1.0 type
+ * declarations on one side and bulma-ui/src on the other. `special` keys are
+ * implemented in transform.ts — they cover structural conversions a rename
+ * table can't express (align-driven targets, child rewrites, unwrapping).
+ *
+ * The mapping-coverage test asserts every name in RBC_EXPORTS (and every
+ * compound sub listed there) resolves to an entry here, so extending coverage
+ * later is a table edit that cannot silently regress.
+ */
+import type { ComponentMapping, PropAction } from '../../types.js';
+/**
+ * Universal RBC modifier props (ElementProps) → bestax useBulmaClasses props.
+ * Applied to every element that maps to a bestax component, after the
+ * component's own `props` actions.
+ */
+export declare const UNIVERSAL_PROPS: Record<string, PropAction>;
+/** Breakpoint-object props flattened by the responsive pass. */
+export declare const RESPONSIVE_BREAKPOINTS: Record<string, string | null>;
+export declare const MAPPING: Record<string, ComponentMapping>;
+/**
+ * The complete react-bulma-components v4.1.0 public surface, vendored from its
+ * src/index.d.ts + per-component declarations. The mapping-coverage test walks
+ * this list against MAPPING, so new RBC surface can never be silently ignored.
+ */
+export declare const RBC_EXPORTS: Record<string, string[]>;
+/** Resolve a canonical RBC path like ['Form','Field','Label'] in MAPPING. */
+export declare function resolveMapping(path: string[]): ComponentMapping | undefined;
+//# sourceMappingURL=mapping.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../src/sources/react-bulma-components/mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAOnE;;;;GAIG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAgFtD,CAAC;AAEF,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAUhE,CAAC;AAIF,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAspBpD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAsEhD,CAAC;AAEF,6EAA6E;AAC7E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,gBAAgB,GAAG,SAAS,CAM3E"}