bestax-migrate 2.4.0 → 2.6.0

package/dist/sources/bulma-classes/class-map.d.ts

@@ -8,9 +8,9 @@
  * it: each root, modifier and helper here is rendered through the built
  * library and compared with the raw markup it replaces.
  *
- * Data only, and written so a generator in another package can import it
- * directly: nothing Node cannot strip, so no enums, no namespaces, type
- * imports only.
+ * Data only: `scripts/gen-mcp-index.mjs` imports it directly for the MCP
+ * server's `lookup_bulma_classes`, so nothing Node cannot strip (no enums, no
+ * namespaces, type imports only), and a change to it wants `pnpm gen:mcp`.
  */
 export interface PropWrite {
     readonly prop: string;
@@ -37,7 +37,10 @@ export interface Modifier {
 export type RootStatus = 'mapped' | 'todo' | 'plain';
 export interface RootEntry {
     readonly status: RootStatus;
-    /** bestax JSX name, dotted for a part (`Hero.Body`). */
+    /**
+     * bestax JSX name, dotted for a part (`Hero.Body`). On a `todo` family, the
+     * component a person converts the family to by hand.
+     */
     readonly target?: string;
     /** The tag the target renders with no `as`. */
     readonly tag?: string;
@@ -60,6 +63,24 @@ export interface RootEntry {
     readonly untypedAttrs?: readonly string[];
     /** The target's props type requires children. */
     readonly requiresChildren?: boolean;
+    /**
+     * The target renders its children inside an element of its own (`Card`
+     * inside `.card-content`) unless one of them is one of these parts, so the
+     * element converts only beside a direct child that converts to one.
+     * `whenEmpty`: it renders that element with no children too.
+     */
+    readonly wrapsChildren?: {
+        readonly in: string;
+        readonly unless: readonly string[];
+        readonly whenEmpty?: boolean;
+    };
+    /** The target takes no helper props, so every helper class stays a class. */
+    readonly noHelpers?: boolean;
+    /**
+     * The target drops its own class when it is given a `className`, so the
+     * element converts only when it carries no other class.
+     */
+    readonly ownClassOnly?: boolean;
     /**
      * Attributes the target types as numbers. A numeric string (`value="40"`)
      * becomes a number, which renders the same; any other string refuses.
@@ -78,6 +99,13 @@ export interface RootEntry {
     readonly part?: boolean;
     /** Why a `todo` or `plain` root is what it is; `todo` messages quote it. */
     readonly why?: string;
+    /**
+     * Modifiers left out of `modifiers` on purpose, because the prop that
+     * renders the class renders more than the class. They stay in `className`;
+     * the reason is for the MCP lookup, which would otherwise say bestax has
+     * no prop for them.
+     */
+    readonly omits?: Readonly<Record<string, string>>;
 }
 export declare const COLORS: readonly ["primary", "link", "info", "success", "warning", "danger", "black", "black-bis", "black-ter", "grey-darker", "grey-dark", "grey", "grey-light", "grey-lighter", "white", "white-bis", "white-ter", "light", "dark"];
 export declare const SIZES: readonly ["0", "1", "2", "3", "4", "5", "6", "auto"];

package/dist/sources/bulma-classes/class-map.d.ts.map

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

package/dist/sources/bulma-classes/class-map.js

@@ -8,9 +8,9 @@
  * it: each root, modifier and helper here is rendered through the built
  * library and compared with the raw markup it replaces.
  *
- * Data only, and written so a generator in another package can import it
- * directly: nothing Node cannot strip, so no enums, no namespaces, type
- * imports only.
+ * Data only: `scripts/gen-mcp-index.mjs` imports it directly for the MCP
+ * server's `lookup_bulma_classes`, so nothing Node cannot strip (no enums, no
+ * namespaces, type imports only), and a change to it wants `pnpm gen:mcp`.
  */
 export function inTagSet(set, tag) {
     return 'on' in set ? set.on.includes(tag) : !set.except.includes(tag);
@@ -246,7 +246,9 @@ export const ROOTS = {
                 'is-active': 'isActive',
                 'is-hovered': 'isHovered',
             }),
-            // No `is-disabled`: `isDisabled` writes attributes as well as the class.
+        },
+        omits: {
+            'is-disabled': 'bestax `Button` renders it through `isDisabled`, which also disables the element (`disabled`, or `aria-disabled` on a link)',
         },
         dropsAttr: {
             // Kept only on the elements `disabled` means something on.
@@ -318,6 +320,86 @@ export const ROOTS = {
             'size',
         ],
     },
+    // `Card` checks its children for a part (`hasCompoundComponents` in
+    // bulma-ui's Card.tsx), and `Card.Header` for a `Card.Header.Title`
+    // (`hasHeaderTitle`), and wraps them when there is none.
+    card: {
+        ...BASE,
+        target: 'Card',
+        tag: 'div',
+        wrapsChildren: {
+            in: 'card-content',
+            unless: [
+                'Card.Header',
+                'Card.Header.Icon',
+                'Card.Image',
+                'Card.Content',
+                'Card.Footer',
+                'Card.FooterItem',
+            ],
+        },
+        ownProps: [
+            'textColor',
+            'color',
+            'bgColor',
+            'hasShadow',
+            'header',
+            'headerCentered',
+            'headerIcon',
+            'footer',
+            'image',
+            'imageAlt',
+        ],
+    },
+    'card-header': {
+        ...BASE,
+        target: 'Card.Header',
+        tag: 'header',
+        wrapsChildren: {
+            in: 'card-header-title',
+            unless: ['Card.Header.Title'],
+            whenEmpty: true,
+        },
+        ownProps: ['color', 'bgColor', 'textColor', 'centered'],
+    },
+    'card-header-title': {
+        ...BASE,
+        target: 'Card.Header.Title',
+        tag: 'div',
+        modifiers: flags({ 'is-centered': 'centered' }),
+        ownProps: ['color', 'bgColor', 'textColor', 'centered'],
+    },
+    'card-header-icon': {
+        ...BASE,
+        target: 'Card.Header.Icon',
+        tag: 'button',
+        defaults: { 'aria-label': 'more options' },
+        ownProps: ['color', 'bgColor', 'textColor'],
+    },
+    'card-image': {
+        ...BASE,
+        target: 'Card.Image',
+        tag: 'div',
+        ownProps: ['color', 'bgColor', 'textColor'],
+    },
+    'card-content': {
+        ...BASE,
+        target: 'Card.Content',
+        tag: 'div',
+        ownProps: ['color', 'bgColor', 'textColor'],
+    },
+    'card-footer': {
+        ...BASE,
+        target: 'Card.Footer',
+        tag: 'footer',
+        ownProps: ['color', 'bgColor', 'textColor'],
+    },
+    'card-footer-item': {
+        ...BASE,
+        target: 'Card.FooterItem',
+        tag: 'span',
+        ownProps: ['color', 'bgColor', 'textColor'],
+    },
     columns: {
         ...BASE,
         target: 'Columns',
@@ -568,6 +650,86 @@ export const ROOTS = {
         tag: 'div',
         ownProps: ['color', 'bgColor', 'textColor'],
     },
+    // `Navbar` writes Bulma's own `role` and `aria-label`, so an element that
+    // already carries them renders the same.
+    navbar: {
+        ...BASE,
+        target: 'Navbar',
+        tag: 'nav',
+        modifiers: {
+            ...tokens('is-', COMPONENT_COLORS, 'color'),
+            ...tokens('is-fixed-', ['top', 'bottom'], 'fixed'),
+            ...flags({ 'is-transparent': 'transparent' }),
+        },
+        defaults: { role: 'navigation', 'aria-label': 'main navigation' },
+        ownProps: ['textColor', 'color', 'bgColor', 'transparent', 'fixed'],
+    },
+    // No background prop on these parts. Menu, Start and End spread `textColor`
+    // onto the element rather than reading it, and type `color` to six colors,
+    // so their text color stays a class.
+    'navbar-brand': {
+        ...BASE,
+        target: 'Navbar.Brand',
+        tag: 'div',
+        bgColor: null,
+        ownProps: ['textColor', 'color'],
+    },
+    'navbar-menu': {
+        ...BASE,
+        target: 'Navbar.Menu',
+        tag: 'div',
+        textColor: null,
+        bgColor: null,
+        modifiers: flags({ 'is-active': 'active' }),
+        ownProps: ['textColor', 'color', 'active'],
+    },
+    'navbar-start': {
+        ...BASE,
+        target: 'Navbar.Start',
+        tag: 'div',
+        textColor: null,
+        bgColor: null,
+        ownProps: ['textColor', 'color'],
+    },
+    'navbar-end': {
+        ...BASE,
+        target: 'Navbar.End',
+        tag: 'div',
+        textColor: null,
+        bgColor: null,
+        ownProps: ['textColor', 'color'],
+    },
+    // A `.has-dropdown` item stays a `Navbar.Item` with the class: a
+    // `Navbar.Dropdown` would hand its `.navbar-link` dropdown semantics.
+    'navbar-item': {
+        ...BASE,
+        target: 'Navbar.Item',
+        tag: 'a',
+        as: 'any',
+        modifiers: flags({ 'is-active': 'active' }),
+        ownProps: ['as', 'active', 'textColor', 'bgColor'],
+    },
+    'navbar-dropdown': {
+        status: 'mapped',
+        target: 'Navbar.DropdownMenu',
+        tag: 'div',
+        textColor: null,
+        bgColor: null,
+        noHelpers: true,
+        modifiers: flags({ 'is-right': 'right', 'is-up': 'up' }),
+        ownProps: ['right', 'up'],
+    },
+    'navbar-divider': {
+        status: 'mapped',
+        target: 'Navbar.Divider',
+        tag: 'hr',
+        textColor: null,
+        bgColor: null,
+        noHelpers: true,
+        // bulma-ui's Navbar.Divider spreads `className` over its own class.
+        ownClassOnly: true,
+        ownProps: [],
+    },
     notification: {
         ...BASE,
         target: 'Notification',
@@ -656,7 +818,9 @@ export const ROOTS = {
                 'is-rounded': 'isRounded',
                 'is-hoverable': 'isHoverable',
             }),
-            // No `is-delete`: `isDelete` turns the tag into a <button>.
+        },
+        omits: {
+            'is-delete': 'bestax `Tag` renders it through `isDelete`, which also turns the tag into a <button>',
         },
         ownProps: [
             'color',
@@ -698,51 +862,43 @@ export const ROOTS = {
         ownProps: ['size', 'isSpaced', 'as', 'hasSkeleton', 'textColor', 'bgColor'],
     },
     // ---- Families bestax has but that do not map element by element yet ------
-    breadcrumb: todo('bestax `Breadcrumb` renders the `<ul>` itself and adds an `aria-label`'),
-    card: todo('bestax `Card` wraps any child that is not one of its parts in `.card-content`, so convert the card and its parts together, by hand'),
-    'card-header': part(),
-    'card-header-title': part(),
-    'card-header-icon': part(),
-    'card-image': part(),
-    'card-content': part(),
-    'card-footer': part(),
-    'card-footer-item': part(),
-    cell: todo('this source leaves Grid markup as written; convert it to bestax `Grid` and `Cell` by hand (`Grid isFixed` renders the `.fixed-grid` wrapper itself)'),
-    grid: todo('this source leaves Grid markup as written; convert it to bestax `Grid` and `Cell` by hand (`Grid isFixed` renders the `.fixed-grid` wrapper itself)'),
-    'fixed-grid': todo('this source leaves Grid markup as written; convert it to bestax `Grid` and `Cell` by hand (`Grid isFixed` renders the `.fixed-grid` wrapper itself)'),
-    checkbox: todo("bestax `Checkbox` renders its own styled markup, not Bulma's"),
-    checkboxes: todo('bestax `Checkboxes` renders its own `.field` and `.control` wrappers'),
-    radio: todo("bestax `Radio` renders its own styled markup, not Bulma's"),
-    radios: todo('bestax `Radios` renders its own `.field` and `.control` wrappers'),
-    field: todo('bestax form controls render their own `.field` and `.control` wrappers; see the unmappables reference'),
+    breadcrumb: todo('Breadcrumb', 'bestax `Breadcrumb` renders the `<ul>` itself and adds an `aria-label`'),
+    cell: todo('Cell', 'this source leaves Grid markup as written; convert it to bestax `Grid` and `Cell` by hand (`Grid isFixed` renders the `.fixed-grid` wrapper itself)'),
+    grid: todo('Grid', 'this source leaves Grid markup as written; convert it to bestax `Grid` and `Cell` by hand (`Grid isFixed` renders the `.fixed-grid` wrapper itself)'),
+    'fixed-grid': todo('Grid', 'this source leaves Grid markup as written; convert it to bestax `Grid` and `Cell` by hand (`Grid isFixed` renders the `.fixed-grid` wrapper itself)'),
+    checkbox: todo('Checkbox', "bestax `Checkbox` renders its own styled markup, not Bulma's"),
+    checkboxes: todo('Checkboxes', 'bestax `Checkboxes` renders its own `.field` and `.control` wrappers'),
+    radio: todo('Radio', "bestax `Radio` renders its own styled markup, not Bulma's"),
+    radios: todo('Radios', 'bestax `Radios` renders its own `.field` and `.control` wrappers'),
+    field: todo('Field', 'bestax form controls render their own `.field` and `.control` wrappers; see the unmappables reference'),
     'field-label': part(),
     'field-body': part(),
     control: part(),
-    input: todo('bestax `Input` renders its own `.field` and `.control` wrappers'),
-    textarea: todo('bestax `TextArea` renders its own `.field` and `.control` wrappers'),
-    select: todo('bestax `Select` renders the `.select` wrapper and the `<select>` together'),
-    file: todo('bestax `File` renders the whole `.file-label` tree itself'),
+    input: todo('Input', 'bestax `Input` renders its own `.field` and `.control` wrappers'),
+    textarea: todo('TextArea', 'bestax `TextArea` renders its own `.field` and `.control` wrappers'),
+    select: todo('Select', 'bestax `Select` renders the `.select` wrapper and the `<select>` together'),
+    file: todo('File', 'bestax `File` renders the whole `.file-label` tree itself'),
     'file-label': part(),
     'file-input': part(),
     'file-cta': part(),
     'file-icon': part(),
     'file-name': part(),
-    dropdown: todo('bestax `Dropdown` renders its own trigger and menu from props'),
+    dropdown: todo('Dropdown', 'bestax `Dropdown` renders its own trigger and menu from props'),
     'dropdown-menu': part(),
     'dropdown-content': part(),
     'dropdown-item': part(),
     'dropdown-divider': part(),
-    icon: todo('bestax `Icon` renders its own `<i>` and adds an `aria-label`'),
-    'icon-text': todo('bestax `IconText` pairs with `Icon`, which renders its own `<i>`'),
-    image: todo('bestax `Image` renders its own `<img>`'),
-    menu: todo('bestax `Menu.Item` renders the `<li>` and the `<a>` together'),
+    icon: todo('Icon', 'bestax `Icon` renders its own `<i>` and adds an `aria-label`'),
+    'icon-text': todo('IconText', 'bestax `IconText` pairs with `Icon`, which renders its own `<i>`'),
+    image: todo('Image', 'bestax `Image` renders its own `<img>`'),
+    menu: todo('Menu', 'bestax `Menu.Item` renders the `<li>` and the `<a>` together'),
     'menu-label': part(),
     'menu-list': part(),
     'menu-item': part(),
-    message: todo('bestax `Message` always wraps its children in `.message-body`'),
+    message: todo('Message', 'bestax `Message` always wraps its children in `.message-body`'),
     'message-header': part(),
     'message-body': part(),
-    modal: todo('bestax `Modal` renders its own background and content parts, and adds dialog attributes'),
+    modal: todo('Modal', 'bestax `Modal` renders its own background and content parts, and adds dialog attributes'),
     'modal-background': part(),
     'modal-content': part(),
     'modal-card': part(),
@@ -751,34 +907,24 @@ export const ROOTS = {
     'modal-card-body': part(),
     'modal-card-foot': part(),
     'modal-close': part(),
-    navbar: todo('bestax `Navbar` adds navigation roles, and its burger renders its own spans'),
-    'navbar-brand': part(),
-    'navbar-burger': part(),
-    'navbar-menu': part(),
-    'navbar-start': part(),
-    'navbar-end': part(),
-    'navbar-item': part(),
-    'navbar-link': part(),
-    'navbar-dropdown': part(),
-    'navbar-divider': part(),
-    'navbar-content': part(),
-    'navbar-tabs': part(),
-    pagination: todo('bestax `Pagination` renders its own list items and adds navigation roles'),
+    'navbar-burger': todo('Navbar.Burger', 'bestax `Navbar.Burger` is a `<button>` that renders its own spans and `aria-expanded`, so rebuild the toggle with it, by hand'),
+    'navbar-link': todo('Navbar.Link', 'inside a `Navbar.Dropdown`, bestax `Navbar.Link` adds `aria-haspopup`, `aria-expanded` and keyboard handling, so convert the `.has-dropdown` item and its link together, by hand'),
+    pagination: todo('Pagination', 'bestax `Pagination` renders its own list items and adds navigation roles'),
     'pagination-list': part(),
     'pagination-link': part(),
     'pagination-ellipsis': part(),
     'pagination-previous': part(),
     'pagination-next': part(),
-    panel: todo('bestax `Panel` parts render their own tags and attributes (`Panel.Block` is an `<a>`, `Panel.Icon` adds an `aria-label`)'),
+    panel: todo('Panel', 'bestax `Panel` parts render their own tags and attributes (`Panel.Block` is an `<a>`, `Panel.Icon` adds an `aria-label`)'),
     'panel-heading': part(),
     'panel-tabs': part(),
     'panel-block': part(),
     'panel-icon': part(),
     'panel-list': part(),
-    tabs: todo("bestax `Tabs` renders each tab's `<li>` and `<a>` together, with tab roles"),
-    'table-container': todo('bestax renders `.table-container` from `Table isResponsive`'),
-    'skeleton-block': todo('bestax `Skeleton` renders its own markup'),
-    'skeleton-lines': todo('bestax `Skeleton` renders its own markup'),
+    tabs: todo('Tabs', "bestax `Tabs` renders each tab's `<li>` and `<a>` together, with tab roles"),
+    'table-container': todo('Table', 'bestax renders `.table-container` from `Table isResponsive`'),
+    'skeleton-block': todo('Skeleton', 'bestax `Skeleton` renders its own markup'),
+    'skeleton-lines': todo('Skeleton', 'bestax `Skeleton` renders its own markup'),
     // ---- Valid Bulma, nothing to convert to --------------------------------------
     // The other sources emit these on purpose where bestax has no component.
     help: plain('bestax renders `.help` only inside its form controls'),
@@ -786,14 +932,16 @@ export const ROOTS = {
     loader: plain("bestax `Loading` is an overlay, not Bulma's inline spinner"),
     'hero-buttons': plain('a layout class inside `.hero`; bestax has no part for it'),
     'hero-video': plain('a layout class inside `.hero`; bestax has no part for it'),
+    'navbar-content': plain('a layout class inside `.navbar`; bestax has no part for it'),
+    'navbar-tabs': plain('a layout class inside `.navbar`; bestax has no part for it'),
     'theme-dark': plain('a theme scope; bestax sets themes through `Theme`'),
     'theme-light': plain('a theme scope; bestax sets themes through `Theme`'),
     fa: plain("Font Awesome's own class, styled by Bulma inside `.icon`"),
     marginless: plain('a Bulma helper with no bestax prop'),
     paddingless: plain('a Bulma helper with no bestax prop'),
 };
-function todo(why) {
-    return { status: 'todo', why };
+function todo(target, why) {
+    return { status: 'todo', target, why };
 }
 function part() {
     return { status: 'todo', part: true };
@@ -824,6 +972,23 @@ export const PRECEDENCE = [
     'media-left',
     'media-content',
     'media-right',
+    // A part before a surface class, so the card around it still sees a part.
+    'card',
+    'card-header',
+    'card-header-title',
+    'card-header-icon',
+    'card-image',
+    'card-content',
+    'card-footer',
+    'card-footer-item',
+    'navbar',
+    'navbar-brand',
+    'navbar-menu',
+    'navbar-start',
+    'navbar-end',
+    'navbar-item',
+    'navbar-dropdown',
+    'navbar-divider',
     'buttons',
     'tags',
     'button',
@@ -839,7 +1004,12 @@ export const PRECEDENCE = [
     'block',
 ];
 /** Refs reach the element only through these targets. */
-export const FORWARDS_REF = ['Button', 'Link'];
+export const FORWARDS_REF = [
+    'Button',
+    'Link',
+    'Navbar',
+    'Navbar.Item',
+];
 /**
  * Plain tags bestax wraps, for an element with helper classes and no root
  * (`<p className="has-text-centered">` → `<Paragraph textAlign="centered">`).

package/dist/sources/bulma-classes/plan.d.ts

@@ -22,6 +22,12 @@ export interface ElementFacts {
     hasRef: boolean;
     /** Whether the element has children (JSX text, elements or expressions). */
     hasChildren: boolean;
+    /**
+     * The bestax components the element's child elements are, or convert to
+     * (`Card.Content`). Only a child written directly inside the element
+     * counts: one in an expression may not render.
+     */
+    childTargets?: readonly string[];
     /**
      * The component this element is the only child of, if any (`Link` for
      * `<Link href="/x"><a className="button">`), since that component can

package/dist/sources/bulma-classes/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/sources/bulma-classes/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,4EAA4E;IAC5E,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IACnD,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mEAAmE;IACnE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8DAA8D;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AA+BD,wBAAgB,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAgP9C"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/sources/bulma-classes/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,2DAA2D;IAC3D,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B;;;OAGG;IACH,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;IACtD,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,4EAA4E;IAC5E,WAAW,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,KAAK,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IACnD,4DAA4D;IAC5D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mEAAmE;IACnE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,8DAA8D;IAC9D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,KAAK,EAAE,IAAI,EAAE,CAAC;CACf;AA+BD,wBAAgB,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAwQ9C"}

package/dist/sources/bulma-classes/plan.js

@@ -48,7 +48,7 @@ export function plan(facts) {
             todos.push({ rule: ruleId('legacy', token), message: hint });
     }
     // A family this source leaves as markup keeps its element as markup, even
-    // beside a class it would convert (`card box`): the family's parts carry no
+    // beside a class it would convert (`navbar box`): the family's parts carry no
     // TODO of their own, so its outermost class is the one place it is flagged.
     const family = tokens.find(token => {
         const found = rootFor(token);
@@ -128,6 +128,16 @@ export function plan(facts) {
     if (entry.requiresChildren && !facts.hasChildren) {
         return refuse('children', target, `bestax \`${target}\` requires children, and this element has none; keep it as markup`);
     }
+    const wraps = entry.wrapsChildren;
+    if (wraps &&
+        (facts.hasChildren || wraps.whenEmpty) &&
+        !facts.childTargets?.some(child => wraps.unless.includes(child))) {
+        const parts = wraps.unless.map(part => `\`${part}\``);
+        const list = parts.length > 1
+            ? `${parts.slice(0, -1).join(', ')} or ${parts[parts.length - 1]}`
+            : parts[0];
+        return refuse('children', target, `bestax \`${target}\` renders its children inside a \`.${wraps.in}\` of its own unless one of them is a ${list}, so this element stays markup`);
+    }
     if (missing.length > 0) {
         const list = missing.map(([name, value]) => `\`${name}="${value}"\``);
         return refuse('defaults', target, `bestax \`${target}\` renders ${list.join(' and ')} when the element does not set ${missing.length === 1 ? 'it' : 'them'}; add ${missing.length === 1 ? 'it' : 'them'} here if that is what you want, then re-run`);
@@ -164,7 +174,7 @@ export function plan(facts) {
             converted.add(token);
             continue;
         }
-        const helper = HELPER_TOKENS.get(token);
+        const helper = entry.noHelpers ? undefined : HELPER_TOKENS.get(token);
         if (!helper)
             continue;
         const prop = helper.group === 'text-color'
@@ -218,6 +228,9 @@ export function plan(facts) {
         props.push(['as', as]);
     props.push(...writes);
     const rest = tokens.filter(token => !converted.has(token));
+    if (entry.ownClassOnly && rest.length > 0) {
+        return refuse('attr', 'className', `bestax \`${target}\` drops its own class when it is given a \`className\`, so this element's other classes would take the place of \`.${root}\`; keep it as markup`);
+    }
     return {
         conversion: {
             target,

package/dist/sources/bulma-classes/rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/sources/bulma-classes/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,eAAO,MAAM,KAAK,EAAE,WAAW,CAAC,MAAM,CAYpC,CAAC;AAqBH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK1D"}
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/sources/bulma-classes/rules.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAUH,eAAO,MAAM,KAAK,EAAE,WAAW,CAAC,MAAM,CAYpC,CAAC;AAuBH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK1D"}

package/dist/sources/bulma-classes/rules.js

@@ -41,6 +41,8 @@ const VOCABULARY = new Set([
     ...HELPER_PROPS,
     // Refused on every target, so no entry lists it.
     'dangerouslySetInnerHTML',
+    // Refused where the target drops its own class for one it is given.
+    'className',
 ]);
 export function inVocabulary(token) {
     return VOCABULARY.has(token);

package/dist/sources/bulma-classes/transform.d.ts

@@ -8,8 +8,9 @@
  *
  * Passes, in order:
  *   1. the shared stylesheet-import pass (a no-op under the default `keep`)
- *   2. plan every element in scope; a computed className is planned from the
- *      strings in it and becomes a TODO, never a conversion
+ *   2. plan every element in scope, children before parents; a computed
+ *      className is planned from the strings in it and becomes a TODO, never
+ *      a conversion
  *   3. file-level gates: a non-React JSX runtime, CommonJS, styled-jsx, and a
  *      Next.js server component (bestax's components are client components)
  *   4. TODOs in reading order; conversions innermost first

package/dist/sources/bulma-classes/transform.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/sources/bulma-classes/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAW,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAuRvD,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,gBAAqB,GAC7B,MAAM,GAAG,SAAS,CA4QpB"}
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../src/sources/bulma-classes/transform.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAW,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAmSvD,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,QAAQ,EAAE,QAAQ,EAClB,GAAG,EAAE,GAAG,EACR,OAAO,GAAE,gBAAqB,GAC7B,MAAM,GAAG,SAAS,CA2SpB"}

package/dist/sources/bulma-classes/transform.js

@@ -8,8 +8,9 @@
  *
  * Passes, in order:
  *   1. the shared stylesheet-import pass (a no-op under the default `keep`)
- *   2. plan every element in scope; a computed className is planned from the
- *      strings in it and becomes a TODO, never a conversion
+ *   2. plan every element in scope, children before parents; a computed
+ *      className is planned from the strings in it and becomes a TODO, never
+ *      a conversion
  *   3. file-level gates: a non-React JSX runtime, CommonJS, styled-jsx, and a
  *      Next.js server component (bestax's components are client components)
  *   4. TODOs in reading order; conversions innermost first
@@ -17,7 +18,7 @@
  */
 import path from 'node:path';
 import { addTodo, findAttr, forgetJsxParens, jsxNameParts, literalValueOf, makeAttr, renameElement, reprintDirectives, } from '../_shared/jsx-utils.js';
-import { collectBoundNames, makeReserve, prefersTabs, } from '../_shared/imports.js';
+import { collectBoundNames, makeReserve, prefersTabs, resolvesToBinding, } from '../_shared/imports.js';
 import { rewriteStylesheetImports } from '../_shared/css-imports.js';
 import { BESTAX, buildBestaxImport, placeBestaxImport, seedBestaxImport, } from '../_shared/bestax-import.js';
 import { plan } from './plan.js';
@@ -217,6 +218,17 @@ function isContent(child) {
     }
     return true;
 }
+/**
+ * Whether a JSX child reaches React at all. JSX drops a comment, and text
+ * made only of spaces and tabs split by a line break; it keeps the rest.
+ * `<div>  </div>` has a child, which `Card` would wrap, and so does an
+ * `&nbsp;` on its own line: `trim()` would drop it, and JSX does not.
+ */
+function reachesReact(child) {
+    if (child.type !== 'JSXText')
+        return isContent(child);
+    return /[^ \t\r\n]/.test(child.value) || !/[\r\n]/.test(child.value);
+}
 function insideForeignContent(elementPath) {
     let current = elementPath.parent;
     while (current) {
@@ -278,29 +290,55 @@ export default function transform(fileInfo, api, options = {}) {
     // every class a converted element renders.
     rewriteStylesheetImports(ctx, root, options.cssMode ?? 'keep');
     // ---- 2. Plan the elements in scope ----------------------------------------
-    const bestaxLocals = new Set();
+    // Each local bestax name, with the component path it stands for: `Card`
+    // for `import { Card as C }`, nothing for a namespace (`B.Card`).
+    const bestaxNames = new Map();
     root
         .find(j.ImportDeclaration, { source: { value: BESTAX } })
         .forEach((importPath) => {
         for (const spec of importPath.node.specifiers ?? []) {
-            if (spec.local)
-                bestaxLocals.add(spec.local.name);
+            if (!spec.local)
+                continue;
+            bestaxNames.set(spec.local.name, spec.type === 'ImportSpecifier' ? [spec.imported.name] : []);
         }
     });
+    const bestaxLocals = new Set(bestaxNames.keys());
+    // Children are planned before their parents (reverse document order), so
+    // a parent can see what its children become: `Card` converts only beside
+    // a child that is one of its parts.
+    const planned = new Map();
+    const programScope = root.find(j.Program).paths()[0]?.scope;
+    const childTargets = (elementPath) => (elementPath.node.children ?? []).flatMap((child) => {
+        if (child.type !== 'JSXElement')
+            return [];
+        const target = planned.get(child)?.conversion?.target;
+        if (target)
+            return [target];
+        // A part the file already uses counts when its name is the bestax
+        // import, not a local that shadows it. A direct child is looked up in
+        // the element's own scope, which is the child's.
+        const parts = jsxNameParts(child.openingElement.name);
+        const owner = parts && bestaxNames.get(parts[0]);
+        if (!owner || !resolvesToBinding(elementPath, parts[0], programScope)) {
+            return [];
+        }
+        return [[...owner, ...parts.slice(1)].join('.')];
+    });
     // `converts` is whether the element would become a component with its
     // classes written out, so it holds for a computed className too.
     const elements = [];
-    root.find(j.JSXElement).forEach(elementPath => {
+    const candidates = root.find(j.JSXElement).paths();
+    for (const elementPath of [...candidates].reverse()) {
         const element = elementPath.node;
         const name = element.openingElement.name;
         if (name.type !== 'JSXIdentifier' || !INTRINSIC.test(name.name))
-            return;
+            continue;
         if (FOREIGN_ROOTS.has(name.name) || insideForeignContent(elementPath)) {
-            return;
+            continue;
         }
         const classAttr = findAttr(element, 'className');
         if (!classAttr)
-            return;
+            continue;
         const attributes = new Map();
         for (const attr of element.openingElement.attributes ?? []) {
             if (attr.type !== 'JSXAttribute' || attr === classAttr)
@@ -316,7 +354,8 @@ export default function transform(fileInfo, api, options = {}) {
             attributes,
             hasSpread: (element.openingElement.attributes ?? []).some((attr) => attr.type === 'JSXSpreadAttribute'),
             hasRef: attributes.has('ref'),
-            hasChildren: (element.children ?? []).some(isContent),
+            hasChildren: (element.children ?? []).some(reachesReact),
+            childTargets: childTargets(elementPath),
             onlyChildOf: onlyChildOf(elementPath, bestaxLocals),
         };
         let result = plan(facts);
@@ -336,10 +375,11 @@ export default function transform(fileInfo, api, options = {}) {
                 ],
             };
         }
+        planned.set(element, result);
         if (result.conversion || result.todos.length > 0) {
-            elements.push({ path: elementPath, plan: result, converts });
+            elements.unshift({ path: elementPath, plan: result, converts });
         }
-    });
+    }
     if (elements.length === 0)
         return print();
     // ---- 3. File-level gates ------------------------------------------------------

package/package.json

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