bestax-mcp 1.18.22 → 1.18.24
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/data/catalog.json +1 -1
- package/data/components/CheckboxCard.json +1 -1
- package/data/components/Checkboxes.json +1 -1
- package/data/components/DataTable.json +1 -1
- package/data/components/Level.json +2 -2
- package/data/components/Pagination.json +1 -1
- package/data/components/RadioCard.json +1 -1
- package/data/components/Radios.json +1 -1
- package/data/components/Rate.json +2 -2
- package/data/components/Table.json +1 -1
- package/data/components/Toast.json +3 -3
- package/data/skills/bestax-custom-component/SKILL.md +1 -1
- package/data/skills/bestax-custom-component/references/library-contributor.md +3 -3
- package/data/skills/bestax-migrate/references/bloomer/unmappables.md +20 -4
- package/data/skills/bestax-migrate/references/rbx/component-map.md +1 -1
- package/data/skills/bestax-migrate/references/rbx/unmappables.md +26 -0
- package/data/skills/bestax-migrate/references/react-bulma-components/component-map.md +34 -34
- package/data/skills/bestax-migrate/references/react-bulma-components/unmappables.md +26 -0
- package/data/skills/bestax-optimize/references/modular-build.md +10 -1
- package/data/skills.json +6 -6
- package/package.json +10 -12
package/data/catalog.json
CHANGED
|
@@ -161,7 +161,7 @@
|
|
|
161
161
|
"name": "value",
|
|
162
162
|
"type": "string",
|
|
163
163
|
"default": null,
|
|
164
|
-
"description": "What a form sends for the card when it's checked. Inside a `Checkboxes` group that takes `value`, `defaultValue` or `onChange`, the card is checked while the group's value holds it.",
|
|
164
|
+
"description": "What a form sends for the card when it's checked. Inside a `Checkboxes` group that takes `value`, `defaultValue` or `onChange`, the card is checked while the group's value holds it. A group given only `onChange` starts from the cards' own `defaultChecked`.",
|
|
165
165
|
"required": false,
|
|
166
166
|
"inherited": false,
|
|
167
167
|
"deprecated": false
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
"name": "onChange",
|
|
102
102
|
"type": "(values: string[]) => void",
|
|
103
103
|
"default": null,
|
|
104
|
-
"description": "Fires when the selection changes; receives the new array.",
|
|
104
|
+
"description": "Fires when the selection changes; receives the new array. Passed without `value` or `defaultValue`, it still has the group manage the selection, starting from the checkboxes' own `defaultChecked`: a box that starts checked stays checked when another is clicked, and the first array holds it.",
|
|
105
105
|
"required": false,
|
|
106
106
|
"inherited": false,
|
|
107
107
|
"deprecated": false
|
|
@@ -66,7 +66,7 @@
|
|
|
66
66
|
"code": "<DataTable\n caption=\"Mitglieder\"\n columns={[{ id: 'name', header: 'Name', sortable: true, isRowHeader: true }]}\n data={[\n { id: 'm1', name: 'Emmy Noether' },\n { id: 'm2', name: 'Lise Meitner' },\n { id: 'm3', name: 'Konrad Zuse' },\n ]}\n selectionMode=\"multiple\"\n hasSearch\n pageSize={2}\n isFullwidth\n labels={{\n selectAll: 'Alle Zeilen dieser Seite auswählen',\n selectRow: label => `${label} auswählen`,\n sortHint: 'Spaltenköpfe mit Schaltflächen sind sortierbar',\n search: 'Suchen',\n results: count => (count === 1 ? '1 Treffer' : `${count} Treffer`),\n pageRange: (first, last, total) => `${first} bis ${last} von ${total}`,\n loading: 'Wird geladen',\n pagination: 'Mitglieder, Seiten',\n empty: 'Noch keine Mitglieder.',\n noResults: 'Keine Treffer.',\n }}\n/>"
|
|
67
67
|
}
|
|
68
68
|
],
|
|
69
|
-
"accessibility": "- **A native table,** as in the ARIA Authoring Practices' Sortable Table example: `th scope=\"col\"`\n headers, `th scope=\"row\"` for the row header, and a `caption` or your `aria-label` or\n `aria-labelledby` as its name. A development build warns when it has none.\n- **Sorting:** a sortable header holds a `<button>` with the header's text, and only the sorted\n header has `aria-sort`, `ascending` or `descending`, which screen readers read out as they reach\n it. That headers with buttons sort is said once, hidden at the end of the caption, or as a hidden\n caption of its own when `aria-label` names the table. The indicator is drawn in CSS, so it's not\n read.\n- **Selection** rides on the checkboxes: each is named \"Select\" and the row's label, and the one in\n the header is mixed (`aria-checked=\"mixed\"`) when some of the page is selected. Rows get Bulma's\n selected look and no `aria-selected`, which ARIA gives the rows of a grid rather than a table.\n- **A status message** in a polite live region says how many rows match a short while after the\n search or a filter changes, the range shown after a page change, and \"Loading\" while `loading` is\n on after one of those. Nothing is said as the page loads, or for a sort, which `aria-sort` covers.\n- **The pager** is a `navigation` named after the table, so two tables on a page have two named\n pagers.\n- **Busy:** `aria-busy` is on the table while `loading`, and the skeleton rows are hidden from\n assistive tech.\n- **Wide tables:** with `isResponsive`, the `ScrollArea` around the table is a tab stop and a\n named region while it overflows, so it can be scrolled from the keyboard.\n- **Forced colors:** the sort indicator is painted in the system's button text color, and the sort\n button's focus ring is an outline. A selected row's fill is a color forced colors takes away, so\n the checked checkbox carries the selection there.\n- **No motion:** nothing animates but the skeleton, which stops under reduced motion.",
|
|
69
|
+
"accessibility": "- **A native table,** as in the ARIA Authoring Practices' Sortable Table example: `th scope=\"col\"`\n headers, `th scope=\"row\"` for the row header, and a `caption` or your `aria-label` or\n `aria-labelledby` as its name. A development build warns when it has none.\n- **Sorting:** a sortable header holds a `<button>` with the header's text, and only the sorted\n header has `aria-sort`, `ascending` or `descending`, which screen readers read out as they reach\n it. That headers with buttons sort is said once, hidden at the end of the caption, or as a hidden\n caption of its own when `aria-label` names the table. The indicator is drawn in CSS, so it's not\n read.\n- **Selection** rides on the checkboxes: each is named \"Select\" and the row's label, and the one in\n the header is mixed (`aria-checked=\"mixed\"`) when some of the page is selected. Rows get Bulma's\n selected look and no `aria-selected`, which ARIA gives the rows of a grid rather than a table.\n- **A status message** in a polite live region says how many rows match a short while after the\n search or a filter changes, the range shown after a page change, and \"Loading\" while `loading` is\n on after one of those. Nothing is said as the page loads, or for a sort, which `aria-sort` covers.\n- **The pager** is a `navigation` named after the table, so two tables on a page have two named\n pagers.\n- **Busy:** `aria-busy` is on the table while `loading`, and the skeleton rows are hidden from\n assistive tech.\n- **Wide tables:** with `isResponsive`, the `ScrollArea` around the table is a tab stop and a\n named region while it overflows, so it can be scrolled from the keyboard.\n- **Forced colors:** the sort indicator is painted in the system's button text color, and the sort\n button's focus ring is an outline. A selected row's fill is a color forced colors takes away, so\n the checked checkbox carries the selection there. The pager's current page is drawn in the\n system's highlight colors, as [Pagination](https://bestax.io/docs/api/components/pagination)'s is.\n- **No motion:** nothing animates but the skeleton, which stops under reduced motion.",
|
|
70
70
|
"related": [
|
|
71
71
|
"Checkbox",
|
|
72
72
|
"EmptyState",
|
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
},
|
|
12
12
|
{
|
|
13
13
|
"title": "Centered Level (Statistics)",
|
|
14
|
-
"code": "<Level>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph
|
|
14
|
+
"code": "<Level>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph\n textSize=\"7\"\n textTransform=\"uppercase\"\n textWeight=\"semibold\"\n mb=\"1\"\n >\n Posts\n </Paragraph>\n <Title as=\"p\">1,234</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph\n textSize=\"7\"\n textTransform=\"uppercase\"\n textWeight=\"semibold\"\n mb=\"1\"\n >\n Following\n </Paragraph>\n <Title as=\"p\">6789</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph\n textSize=\"7\"\n textTransform=\"uppercase\"\n textWeight=\"semibold\"\n mb=\"1\"\n >\n Followers\n </Paragraph>\n <Title as=\"p\">123K</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph\n textSize=\"7\"\n textTransform=\"uppercase\"\n textWeight=\"semibold\"\n mb=\"1\"\n >\n Likes\n </Paragraph>\n <Title as=\"p\">9876</Title>\n </Block>\n </Level.Item>\n</Level>"
|
|
15
15
|
},
|
|
16
16
|
{
|
|
17
17
|
"title": "Centered Level Menu",
|
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
},
|
|
20
20
|
{
|
|
21
21
|
"title": "Mobile Level",
|
|
22
|
-
"code": "<Level isMobile>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph
|
|
22
|
+
"code": "<Level isMobile>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph\n textSize=\"7\"\n textTransform=\"uppercase\"\n textWeight=\"semibold\"\n mb=\"1\"\n >\n Posts\n </Paragraph>\n <Title as=\"p\">1,234</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph\n textSize=\"7\"\n textTransform=\"uppercase\"\n textWeight=\"semibold\"\n mb=\"1\"\n >\n Following\n </Paragraph>\n <Title as=\"p\">4567</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph\n textSize=\"7\"\n textTransform=\"uppercase\"\n textWeight=\"semibold\"\n mb=\"1\"\n >\n Followers\n </Paragraph>\n <Title as=\"p\">123K</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph\n textSize=\"7\"\n textTransform=\"uppercase\"\n textWeight=\"semibold\"\n mb=\"1\"\n >\n Likes\n </Paragraph>\n <Title as=\"p\">9876</Title>\n </Block>\n </Level.Item>\n</Level>"
|
|
23
23
|
},
|
|
24
24
|
{
|
|
25
25
|
"title": "Compound (dot-notation) usage",
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
"code": "<Pagination>\n <Pagination.Previous>Previous</Pagination.Previous>\n <Pagination.Next>Next page</Pagination.Next>\n <Pagination.List>\n <Pagination.Link active>1</Pagination.Link>\n <Pagination.Link>2</Pagination.Link>\n <Pagination.Ellipsis />\n <Pagination.Link>10</Pagination.Link>\n </Pagination.List>\n</Pagination>"
|
|
43
43
|
}
|
|
44
44
|
],
|
|
45
|
-
"accessibility": "- The root `Pagination` renders as a semantic `<nav role=\"navigation\" aria-label=\"pagination\">`.\n- Use `aria-label` on page links for better screen reader support.\n- Disabled and active states are handled with ARIA attributes and classes.\n- Rendered from `total`, each page's link is named for its page (\"Page 3\"; pass `getPageLabel` for your own words), and the current page's link carries `aria-current=\"page\"`. Without `getPageHref` the links have no `href`, so they carry `role=\"button\"` and choose a page with Enter or Space.\n\n:::note\nPagination links are rendered as `<a>` elements for accessibility and keyboard navigation.\n:::",
|
|
45
|
+
"accessibility": "- The root `Pagination` renders as a semantic `<nav role=\"navigation\" aria-label=\"pagination\">`.\n- Use `aria-label` on page links for better screen reader support.\n- Disabled and active states are handled with ARIA attributes and classes.\n- Rendered from `total`, each page's link is named for its page (\"Page 3\"; pass `getPageLabel` for your own words), and the current page's link carries `aria-current=\"page\"`. Without `getPageHref` the links have no `href`, so they carry `role=\"button\"` and choose a page with Enter or Space.\n- **Forced colors:** Bulma marks the current page with colors alone, which forced colors (Windows' contrast themes) replaces, so bestax's styles draw it in the system's highlight colors there instead. A link with Bulma's `is-current` or `is-selected` class gets them, so a [DataTable](https://bestax.io/docs/api/components/datatable)'s pager does too.\n\n:::note\nPagination links are rendered as `<a>` elements for accessibility and keyboard navigation.\n:::",
|
|
46
46
|
"related": ["Button", "useBulmaClasses"],
|
|
47
47
|
"storybook": "https://bestax.io/storybook/?path=/story/components-pagination--basic",
|
|
48
48
|
"summary": "The `Pagination` component provides a flexible, composable Bulma pagination navigation for your Bulma React UI.",
|
|
@@ -159,7 +159,7 @@
|
|
|
159
159
|
"name": "value",
|
|
160
160
|
"type": "string",
|
|
161
161
|
"default": null,
|
|
162
|
-
"description": "What a form sends when this card is the one picked. Inside a `Radios` group that takes `value`, `defaultValue` or `onChange`, the card is checked while the group's value is this.",
|
|
162
|
+
"description": "What a form sends when this card is the one picked. Inside a `Radios` group that takes `value`, `defaultValue` or `onChange`, the card is checked while the group's value is this. A group given only `onChange` starts from the card with `defaultChecked`.",
|
|
163
163
|
"required": false,
|
|
164
164
|
"inherited": false,
|
|
165
165
|
"deprecated": false
|
|
@@ -101,7 +101,7 @@
|
|
|
101
101
|
"name": "onChange",
|
|
102
102
|
"type": "(value: string) => void",
|
|
103
103
|
"default": null,
|
|
104
|
-
"description": "Fires when the selection changes.",
|
|
104
|
+
"description": "Fires when the selection changes; receives the value picked. Passed without `value` or `defaultValue`, it still has the group manage the selection, starting from the radio with `defaultChecked`.",
|
|
105
105
|
"required": false,
|
|
106
106
|
"inherited": false,
|
|
107
107
|
"deprecated": false
|
|
@@ -51,7 +51,7 @@
|
|
|
51
51
|
"code": "function example() {\n return (\n <Field\n horizontal\n label=\"Rating\"\n labelProps={{ id: 'rating-label-control', htmlFor: undefined }}\n >\n <Field.Body>\n <Field>\n <Control>\n <Rate aria-labelledby=\"rating-label-control\" defaultValue={3} />\n </Control>\n </Field>\n </Field.Body>\n </Field>\n );\n}"
|
|
52
52
|
}
|
|
53
53
|
],
|
|
54
|
-
"accessibility": "- Uses `role=\"radiogroup\"` for the container\n- The `label` prop names the group via `aria-labelledby` (the rendered `<label>` gets an id — yours via `labelProps.id`, or a generated one); without a label the container falls back to `aria-label=\"Rating\"`. Inside a labeled `Field`, that `Field`'s label names the group the same way and replaces the fallback. An `aria-label` or `aria-labelledby` you set on the Rate yourself wins over either label\n- Each star has `role=\"radio\"` with `aria-checked`, and the star the value falls in is the checked one, so the value travels with it. A fractional value names that star by the value itself (\"3.5 stars\")\n- Focus stays on the group, which points `aria-activedescendant` at the checked star, so a screen reader announces it as the arrow keys change the value\n- Full keyboard navigation with arrow keys\n- Home/End keys jump to 0/max values",
|
|
54
|
+
"accessibility": "- Uses `role=\"radiogroup\"` for the container\n- The `label` prop names the group via `aria-labelledby` (the rendered `<label>` gets an id — yours via `labelProps.id`, or a generated one); without a label the container falls back to `aria-label=\"Rating\"`. Inside a labeled `Field`, that `Field`'s label names the group the same way and replaces the fallback. An `aria-label` or `aria-labelledby` you set on the Rate yourself wins over either label\n- Each star has `role=\"radio\"` with `aria-checked`, and the star the value falls in is the checked one, so the value travels with it. A fractional value names that star by the value itself (\"3.5 stars\")\n- Focus stays on the group, which points `aria-activedescendant` at the checked star, so a screen reader announces it as the arrow keys change the value\n- Full keyboard navigation with arrow keys\n- Home/End keys jump to 0/max values\n- `disabled` sets `aria-disabled` on the group and on every star, so a screen reader announces them as unavailable, and takes the group out of the tab order",
|
|
55
55
|
"related": ["Input", "Slider"],
|
|
56
56
|
"storybook": "https://bestax.io/storybook/?path=/story/form-rate",
|
|
57
57
|
"summary": "The `Rate` component provides a star/icon-based rating system.",
|
|
@@ -140,7 +140,7 @@
|
|
|
140
140
|
"name": "disabled",
|
|
141
141
|
"type": "boolean",
|
|
142
142
|
"default": "false",
|
|
143
|
-
"description": "Whether the rating is disabled.",
|
|
143
|
+
"description": "Whether the rating is disabled. A disabled Rate ignores clicks and keys, leaves the tab order, and sets `aria-disabled` on the group and on every star, so a screen reader announces them as unavailable.",
|
|
144
144
|
"required": false,
|
|
145
145
|
"inherited": false,
|
|
146
146
|
"deprecated": false
|
|
@@ -240,7 +240,7 @@
|
|
|
240
240
|
"name": "isSelected",
|
|
241
241
|
"type": "boolean",
|
|
242
242
|
"default": "false",
|
|
243
|
-
"description": "Whether the row is selected (adds Bulma's is-selected class). It's a look only: it says nothing to assistive tech, so pair it with a checkbox named for the row when the selection matters. A bestax `Checkbox` placed straight in one of the row's cells takes the row's text color, so a checked
|
|
243
|
+
"description": "Whether the row is selected (adds Bulma's is-selected class). It's a look only: it says nothing to assistive tech, so pair it with a checkbox named for the row when the selection matters. A bestax `Checkbox` or `Radio` placed straight in one of the row's cells takes the row's text color, so a checked one shows on the row's fill. One in a menu or a table nested in a cell, or in a cell with a `color` of its own, keeps its own colors, since it sits on that surface instead, and so does every one in a row with a `color`, whose cells paint that color over the fill.",
|
|
244
244
|
"required": false,
|
|
245
245
|
"inherited": false,
|
|
246
246
|
"deprecated": false
|
|
@@ -186,7 +186,7 @@
|
|
|
186
186
|
"name": "container",
|
|
187
187
|
"type": "string | HTMLElement",
|
|
188
188
|
"default": null,
|
|
189
|
-
"description": "CSS selector or DOM node to mount the toast into.",
|
|
189
|
+
"description": "CSS selector or DOM node to mount the toast into. Through `toast.show()`, a toast with one portals there in a box of its own, rather than joining `ToastContainer`'s stack for its position.",
|
|
190
190
|
"required": false,
|
|
191
191
|
"inherited": false,
|
|
192
192
|
"deprecated": false
|
|
@@ -195,7 +195,7 @@
|
|
|
195
195
|
"name": "inline",
|
|
196
196
|
"type": "boolean",
|
|
197
197
|
"default": "false",
|
|
198
|
-
"description": "Renders inline instead of using a portal.",
|
|
198
|
+
"description": "Renders inline instead of using a portal. Through `toast.show()`, a toast already renders inline in `ToastContainer`'s stack for its position, and `inline` keeps one with a `container` in that stack too.",
|
|
199
199
|
"required": false,
|
|
200
200
|
"inherited": false,
|
|
201
201
|
"deprecated": false
|
|
@@ -226,7 +226,7 @@
|
|
|
226
226
|
},
|
|
227
227
|
{
|
|
228
228
|
"path": "ToastContainer",
|
|
229
|
-
"summary": "Container component for rendering programmatic toasts. Place once at your app root to enable the toast API. A toast shown with a `position` appears there, and one shown without goes to the container's `position`.",
|
|
229
|
+
"summary": "Container component for rendering programmatic toasts. Place once at your app root to enable the toast API. A toast shown with a `position` appears there, and one shown without goes to the container's `position`. The toasts at one position stack in one `.toast-container`, with a gap between them, in the order they were shown, growing away from the edge of the screen. A toast shown with a `container` of its own, and not `inline`, portals there instead, in a box of its own.",
|
|
230
230
|
"component": null,
|
|
231
231
|
"props": [
|
|
232
232
|
{
|
|
@@ -13,7 +13,7 @@ pieces in an app, or as a full library "extra" inside the bestax monorepo.
|
|
|
13
13
|
|
|
14
14
|
- **The bestax monorepo** (the repo contains `bulma-ui/src/`) → follow
|
|
15
15
|
`references/library-contributor.md` instead of this file: five-file layout, SCSS partial,
|
|
16
|
-
stories,
|
|
16
|
+
stories, Vitest tests, docs page, wiring.
|
|
17
17
|
- **An app depending on `@allxsmith/bestax-bulma`** (e.g. scaffolded by `npm create bestax`) →
|
|
18
18
|
continue here. Everything below assumes public package imports and a plain Vite app.
|
|
19
19
|
|
|
@@ -13,7 +13,7 @@ Every custom component has five files. Mirror the existing names exactly (Pascal
|
|
|
13
13
|
```
|
|
14
14
|
bulma-ui/src/components/MyComponent.tsx # React + TS component
|
|
15
15
|
bulma-ui/src/components/MyComponent.stories.tsx # Storybook stories
|
|
16
|
-
bulma-ui/src/components/__tests__/MyComponent.test.tsx #
|
|
16
|
+
bulma-ui/src/components/__tests__/MyComponent.test.tsx # Vitest + RTL tests
|
|
17
17
|
bulma-ui/src/scss/components/_mycomponent.scss # SCSS partial
|
|
18
18
|
docs/docs/api/components/mycomponent.md # Docusaurus docs page
|
|
19
19
|
```
|
|
@@ -265,7 +265,7 @@ The canonical reference file is `bulma-ui/src/scss/components/_dialog.scss`.
|
|
|
265
265
|
|
|
266
266
|
`MyComponent.stories.tsx` beside the component. Use `tags: ['autodocs']` so the JSDoc becomes
|
|
267
267
|
the docs page, declare `argTypes`, and write one named `function`-style render per variant.
|
|
268
|
-
Give every argType a `description` — enforced by a
|
|
268
|
+
Give every argType a `description` — enforced by a meta-test.
|
|
269
269
|
|
|
270
270
|
```tsx
|
|
271
271
|
import type { Meta, StoryObj } from '@storybook/react-vite';
|
|
@@ -310,7 +310,7 @@ export const Colors: Story = {
|
|
|
310
310
|
|
|
311
311
|
## Tests
|
|
312
312
|
|
|
313
|
-
`__tests__/MyComponent.test.tsx`,
|
|
313
|
+
`__tests__/MyComponent.test.tsx`, Vitest + `@testing-library/react`. Cover render, each prop →
|
|
314
314
|
class mapping, the helper-prop passthrough, ref forwarding, the ConfigProvider prefix, and any
|
|
315
315
|
interaction/a11y.
|
|
316
316
|
|
|
@@ -200,12 +200,28 @@ covers the common "render as a router link" case.
|
|
|
200
200
|
|
|
201
201
|
## `component:Heading` — Bulma v1 dropped `.heading`
|
|
202
202
|
|
|
203
|
-
bloomer's `Heading` is Bulma's small
|
|
204
|
-
|
|
203
|
+
bloomer's `Heading` is Bulma 0.9's small uppercase label, and bestax has no component for it. It
|
|
204
|
+
becomes the plain `<p className="heading">` bloomer rendered (or the element its `tag` named), but
|
|
205
|
+
Bulma v1 has no rule for that class, so the label renders as body text. Restyle it with helper
|
|
206
|
+
props, as a small, uppercase, semibold `Paragraph`:
|
|
205
207
|
|
|
206
208
|
```jsx
|
|
207
|
-
<Heading>
|
|
208
|
-
<
|
|
209
|
+
<Heading>Followers</Heading>
|
|
210
|
+
<Paragraph textSize="7" textTransform="uppercase" textWeight="semibold" mb="1">
|
|
211
|
+
Followers
|
|
212
|
+
</Paragraph>
|
|
213
|
+
```
|
|
214
|
+
|
|
215
|
+
Or keep the class and give it a rule of your own. Bulma 0.9's was:
|
|
216
|
+
|
|
217
|
+
```css
|
|
218
|
+
.heading {
|
|
219
|
+
display: block;
|
|
220
|
+
font-size: 11px;
|
|
221
|
+
letter-spacing: 1px;
|
|
222
|
+
margin-bottom: 5px;
|
|
223
|
+
text-transform: uppercase;
|
|
224
|
+
}
|
|
209
225
|
```
|
|
210
226
|
|
|
211
227
|
## `prop:isFullWidth` — not a universal helper in bestax
|
|
@@ -54,7 +54,7 @@ test holds to rbx's own export surface in both directions.
|
|
|
54
54
|
| `File.Name` | — _(see unmappables)_ | todo |
|
|
55
55
|
| `Footer` | `Footer` | mapped |
|
|
56
56
|
| `Generic` | — _(see unmappables)_ | todo |
|
|
57
|
-
| `Heading` | _structural_ |
|
|
57
|
+
| `Heading` | _structural_ | partial |
|
|
58
58
|
| `Help` | _structural_ | mapped |
|
|
59
59
|
| `Hero` | `Hero` | mapped |
|
|
60
60
|
| `Hero.Body` | `Hero.Body` | mapped |
|
|
@@ -29,6 +29,32 @@ become `<Cell>`, and `size={n}` becomes a column span.
|
|
|
29
29
|
<Grid><Cell colSpan={4}>x</Cell></Grid>
|
|
30
30
|
```
|
|
31
31
|
|
|
32
|
+
## `component:Heading` — Bulma v1 dropped `.heading`
|
|
33
|
+
|
|
34
|
+
rbx's `Heading` is Bulma 0.9's small uppercase label, and bestax has no component for it. It becomes
|
|
35
|
+
the plain `<p className="heading">` rbx rendered, but Bulma v1 has no rule for that class, so the
|
|
36
|
+
label renders as body text. Restyle it with helper props, as a small, uppercase, semibold
|
|
37
|
+
`Paragraph`:
|
|
38
|
+
|
|
39
|
+
```jsx
|
|
40
|
+
<Heading>Followers</Heading>
|
|
41
|
+
<Paragraph textSize="7" textTransform="uppercase" textWeight="semibold" mb="1">
|
|
42
|
+
Followers
|
|
43
|
+
</Paragraph>
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
Or keep the class and give it a rule of your own. Bulma 0.9's was:
|
|
47
|
+
|
|
48
|
+
```css
|
|
49
|
+
.heading {
|
|
50
|
+
display: block;
|
|
51
|
+
font-size: 11px;
|
|
52
|
+
letter-spacing: 1px;
|
|
53
|
+
margin-bottom: 5px;
|
|
54
|
+
text-transform: uppercase;
|
|
55
|
+
}
|
|
56
|
+
```
|
|
57
|
+
|
|
32
58
|
## `component:File.*` — the file-input parts
|
|
33
59
|
|
|
34
60
|
bestax's `<File>` renders the whole Bulma structure itself, so `File.Label`, `File.Input`,
|
|
@@ -6,40 +6,40 @@ codemod converts it; **Flagged** = it leaves a `TODO(bestax-migrate)` comment (s
|
|
|
6
6
|
|
|
7
7
|
## Top-level components
|
|
8
8
|
|
|
9
|
-
| RBC | bestax | Notes
|
|
10
|
-
| -------------- | -------------------------------------------- |
|
|
11
|
-
| `Block` | `Block` | Auto
|
|
12
|
-
| `Box` | `Box` | Auto
|
|
13
|
-
| `Breadcrumb` | `Breadcrumb` | Auto; `align` → `alignment` (`center`→`centered`)
|
|
14
|
-
| `Button` | `Button` | Auto for literal `remove` (by value, not presence — truthy → `<Delete/>`, `remove={false}` stays `Button`); dynamic flagged
|
|
15
|
-
| `Card` | `Card` | Auto
|
|
16
|
-
| `Columns` | `Columns` | Auto; `breakpoint="mobile"`→`isMobile`, `multiline`→`isMultiline`, …
|
|
17
|
-
| `Container` | `Container` | Auto; `breakpoint="fluid"`→`fluid`, `max`→`isMax`
|
|
18
|
-
| `Content` | `Content` | Auto
|
|
19
|
-
| `Dropdown` | `Dropdown` | Structure auto; controlled `value`/`onChange` flagged
|
|
20
|
-
| `Element` | — | Flagged: no generic element; use a semantic component + helper props
|
|
21
|
-
| `Footer` | `Footer` | Auto
|
|
22
|
-
| `Form.*` | flat imports | See Form table below
|
|
23
|
-
| `Heading` | `Title` / `SubTitle` / `<p class="heading">` | Auto for literal `subtitle`/`heading` (by value, not presence — `subtitle={false}` is `Title`); dynamic value flagged; `size` may become `textSize` |
|
|
24
|
-
| `Hero` | `Hero` | Auto; `hasNavbar`→`fullheightWithNavbar`; `halfheight`/`gradient` flagged
|
|
25
|
-
| `Icon` | `Icon` | `<i class="fas fa-x">` children → `name`/`library`/`variant` props; else flagged
|
|
26
|
-
| `Image` | `Image` | Auto; numeric `size={128}` → `size="128x128"`, `rounded`→`isRounded`
|
|
27
|
-
| `Level` | `Level` | Auto; `breakpoint="mobile"`→`isMobile`
|
|
28
|
-
| `Loader` | plain `<div className="loader">` | Auto (Bulma v1 still ships the class); swap in bestax's `Loader` by hand for its progressbar role and accessible name
|
|
29
|
-
| `Media` | `Media` | Auto
|
|
30
|
-
| `Menu` | `Menu` | Auto
|
|
31
|
-
| `Message` | `Message` | Auto; unknown or dynamic `size` flagged
|
|
32
|
-
| `Modal` | `Modal` | `show`→`active`, `closeOnEsc`→`closeOnEscape`; `closeOnBlur`/`showClose` flagged (compound form renders neither)
|
|
33
|
-
| `Navbar` | `Navbar` | Auto; see dropdown note below
|
|
34
|
-
| `Notification` | `Notification` | Auto; `light`→`isLight`
|
|
35
|
-
| `Pagination` | `Pagination` | `onChange`→`onPageChange`, `delta`→`siblingCount`, `next`/`previous`→`nextLabel`/`previousLabel`; `showFirstLast`/`showPrevNext`/`autoHide` flagged
|
|
36
|
-
| `Panel` | `Panel` | Auto
|
|
37
|
-
| `Progress` | `Progress` | Auto
|
|
38
|
-
| `Section` | `Section` | Auto
|
|
39
|
-
| `Table` | `Table` | Auto; `size="fullwidth"`→`isFullwidth`, `striped`→`isStriped`, …
|
|
40
|
-
| `Tabs` | `Tabs` | Auto; children wrapped in `Tabs.List`; `type="toggle-rounded"`→`toggle rounded`
|
|
41
|
-
| `Tag` | `Tag` | Auto; `remove`→`isDelete`, `rounded`→`isRounded`
|
|
42
|
-
| `Tile` | — | Flagged: Bulma v1 replaced tiles with `Grid`/`Cell`
|
|
9
|
+
| RBC | bestax | Notes |
|
|
10
|
+
| -------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
|
11
|
+
| `Block` | `Block` | Auto |
|
|
12
|
+
| `Box` | `Box` | Auto |
|
|
13
|
+
| `Breadcrumb` | `Breadcrumb` | Auto; `align` → `alignment` (`center`→`centered`) |
|
|
14
|
+
| `Button` | `Button` | Auto for literal `remove` (by value, not presence — truthy → `<Delete/>`, `remove={false}` stays `Button`); dynamic flagged |
|
|
15
|
+
| `Card` | `Card` | Auto |
|
|
16
|
+
| `Columns` | `Columns` | Auto; `breakpoint="mobile"`→`isMobile`, `multiline`→`isMultiline`, … |
|
|
17
|
+
| `Container` | `Container` | Auto; `breakpoint="fluid"`→`fluid`, `max`→`isMax` |
|
|
18
|
+
| `Content` | `Content` | Auto |
|
|
19
|
+
| `Dropdown` | `Dropdown` | Structure auto; controlled `value`/`onChange` flagged |
|
|
20
|
+
| `Element` | — | Flagged: no generic element; use a semantic component + helper props |
|
|
21
|
+
| `Footer` | `Footer` | Auto |
|
|
22
|
+
| `Form.*` | flat imports | See Form table below |
|
|
23
|
+
| `Heading` | `Title` / `SubTitle` / `<p class="heading">` | Auto for literal `subtitle`/`heading` (by value, not presence — `subtitle={false}` is `Title`); the `heading` paragraph flagged, since Bulma v1 has no rule for the class; dynamic value flagged; `size` may become `textSize` |
|
|
24
|
+
| `Hero` | `Hero` | Auto; `hasNavbar`→`fullheightWithNavbar`; `halfheight`/`gradient` flagged |
|
|
25
|
+
| `Icon` | `Icon` | `<i class="fas fa-x">` children → `name`/`library`/`variant` props; else flagged |
|
|
26
|
+
| `Image` | `Image` | Auto; numeric `size={128}` → `size="128x128"`, `rounded`→`isRounded` |
|
|
27
|
+
| `Level` | `Level` | Auto; `breakpoint="mobile"`→`isMobile` |
|
|
28
|
+
| `Loader` | plain `<div className="loader">` | Auto (Bulma v1 still ships the class); swap in bestax's `Loader` by hand for its progressbar role and accessible name |
|
|
29
|
+
| `Media` | `Media` | Auto |
|
|
30
|
+
| `Menu` | `Menu` | Auto |
|
|
31
|
+
| `Message` | `Message` | Auto; unknown or dynamic `size` flagged |
|
|
32
|
+
| `Modal` | `Modal` | `show`→`active`, `closeOnEsc`→`closeOnEscape`; `closeOnBlur`/`showClose` flagged (compound form renders neither) |
|
|
33
|
+
| `Navbar` | `Navbar` | Auto; see dropdown note below |
|
|
34
|
+
| `Notification` | `Notification` | Auto; `light`→`isLight` |
|
|
35
|
+
| `Pagination` | `Pagination` | `onChange`→`onPageChange`, `delta`→`siblingCount`, `next`/`previous`→`nextLabel`/`previousLabel`; `showFirstLast`/`showPrevNext`/`autoHide` flagged |
|
|
36
|
+
| `Panel` | `Panel` | Auto |
|
|
37
|
+
| `Progress` | `Progress` | Auto |
|
|
38
|
+
| `Section` | `Section` | Auto |
|
|
39
|
+
| `Table` | `Table` | Auto; `size="fullwidth"`→`isFullwidth`, `striped`→`isStriped`, … |
|
|
40
|
+
| `Tabs` | `Tabs` | Auto; children wrapped in `Tabs.List`; `type="toggle-rounded"`→`toggle rounded` |
|
|
41
|
+
| `Tag` | `Tag` | Auto; `remove`→`isDelete`, `rounded`→`isRounded` |
|
|
42
|
+
| `Tile` | — | Flagged: Bulma v1 replaced tiles with `Grid`/`Cell` |
|
|
43
43
|
|
|
44
44
|
## Compound sub-components
|
|
45
45
|
|
|
@@ -43,6 +43,32 @@ https://bestax.io/docs/api/grid):
|
|
|
43
43
|
|
|
44
44
|
Match the old proportions with `Cell` span props; tiles' `vertical` becomes grid flow.
|
|
45
45
|
|
|
46
|
+
## `component:Heading` — Bulma v1 dropped `.heading`
|
|
47
|
+
|
|
48
|
+
A `Heading` with a truthy `heading` is Bulma 0.9's small uppercase label, and bestax has no
|
|
49
|
+
component for it. It becomes a plain `<p className="heading">`, but Bulma v1 has no rule for that
|
|
50
|
+
class, so it styles nothing. Restyle it with helper props, as a small, uppercase, semibold
|
|
51
|
+
`Paragraph`:
|
|
52
|
+
|
|
53
|
+
```jsx
|
|
54
|
+
<Heading heading>Followers</Heading>
|
|
55
|
+
<Paragraph textSize="7" textTransform="uppercase" textWeight="semibold" mb="1">
|
|
56
|
+
Followers
|
|
57
|
+
</Paragraph>
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
Or keep the class and give it a rule of your own. Bulma 0.9's was:
|
|
61
|
+
|
|
62
|
+
```css
|
|
63
|
+
.heading {
|
|
64
|
+
display: block;
|
|
65
|
+
font-size: 11px;
|
|
66
|
+
letter-spacing: 1px;
|
|
67
|
+
margin-bottom: 5px;
|
|
68
|
+
text-transform: uppercase;
|
|
69
|
+
}
|
|
70
|
+
```
|
|
71
|
+
|
|
46
72
|
## Controlled `Dropdown` (`value` / `onChange`, `Dropdown.Item value`)
|
|
47
73
|
|
|
48
74
|
bestax `Dropdown` is compositional — you own the selection state:
|
|
@@ -81,7 +81,7 @@ is **more complete** than the docs page's Option C example, which omits several)
|
|
|
81
81
|
**Components** (`@allxsmith/bestax-bulma/scss/components/<name>`):
|
|
82
82
|
`loading`, `collapse`, `tooltip`, `popover`, `hovercard`, `contextmenu`, `steps`, `sidebar`,
|
|
83
83
|
`toast`, `dialog`, `carousel`, `tabs`, `menu`, `reveal`, `avatar`, `avatars`, `badge`,
|
|
84
|
-
`emptystate`, `timeline`, `treeview`, `scrollarea`, `command`, `datatable`
|
|
84
|
+
`emptystate`, `timeline`, `treeview`, `scrollarea`, `command`, `datatable`, `pagination`
|
|
85
85
|
|
|
86
86
|
**Layout** (`@allxsmith/bestax-bulma/scss/layout/<name>`): `splitter`
|
|
87
87
|
|
|
@@ -121,6 +121,15 @@ Notes:
|
|
|
121
121
|
@use '@allxsmith/bestax-bulma/scss/components/menu' as bestax-menu;
|
|
122
122
|
```
|
|
123
123
|
|
|
124
|
+
- The `pagination` partial **extends** stock Bulma pagination (it keeps the current page marked
|
|
125
|
+
in forced colors, where Bulma's colors for it are replaced), so an app using `Pagination`, or a
|
|
126
|
+
`DataTable` with pages, whose pager is one, needs both, in either order:
|
|
127
|
+
|
|
128
|
+
```scss
|
|
129
|
+
@use 'bulma/sass/components/pagination';
|
|
130
|
+
@use '@allxsmith/bestax-bulma/scss/components/pagination' as bestax-pagination;
|
|
131
|
+
```
|
|
132
|
+
|
|
124
133
|
- The `file` partial **extends** stock Bulma file (File's keyboard focus ring, and the rounded
|
|
125
134
|
corners of a boxed `hasName` File with no name to show), so an app using `File` needs both, in
|
|
126
135
|
either order:
|
package/data/skills.json
CHANGED
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
{
|
|
16
16
|
"id": "library-contributor",
|
|
17
17
|
"file": "references/library-contributor.md",
|
|
18
|
-
"bytes":
|
|
18
|
+
"bytes": 22089
|
|
19
19
|
},
|
|
20
20
|
{ "id": "patterns", "file": "references/patterns.md", "bytes": 4601 }
|
|
21
21
|
],
|
|
@@ -98,7 +98,7 @@
|
|
|
98
98
|
{
|
|
99
99
|
"id": "bloomer-unmappables",
|
|
100
100
|
"file": "references/bloomer/unmappables.md",
|
|
101
|
-
"bytes":
|
|
101
|
+
"bytes": 18303
|
|
102
102
|
},
|
|
103
103
|
{
|
|
104
104
|
"id": "bulma-classes-component-map",
|
|
@@ -133,12 +133,12 @@
|
|
|
133
133
|
{
|
|
134
134
|
"id": "rbx-unmappables",
|
|
135
135
|
"file": "references/rbx/unmappables.md",
|
|
136
|
-
"bytes":
|
|
136
|
+
"bytes": 15829
|
|
137
137
|
},
|
|
138
138
|
{
|
|
139
139
|
"id": "react-bulma-components-component-map",
|
|
140
140
|
"file": "references/react-bulma-components/component-map.md",
|
|
141
|
-
"bytes":
|
|
141
|
+
"bytes": 16562
|
|
142
142
|
},
|
|
143
143
|
{
|
|
144
144
|
"id": "react-bulma-components-prop-map",
|
|
@@ -148,7 +148,7 @@
|
|
|
148
148
|
{
|
|
149
149
|
"id": "react-bulma-components-unmappables",
|
|
150
150
|
"file": "references/react-bulma-components/unmappables.md",
|
|
151
|
-
"bytes":
|
|
151
|
+
"bytes": 14098
|
|
152
152
|
}
|
|
153
153
|
],
|
|
154
154
|
"examples": []
|
|
@@ -162,7 +162,7 @@
|
|
|
162
162
|
{
|
|
163
163
|
"id": "modular-build",
|
|
164
164
|
"file": "references/modular-build.md",
|
|
165
|
-
"bytes":
|
|
165
|
+
"bytes": 14048
|
|
166
166
|
}
|
|
167
167
|
],
|
|
168
168
|
"examples": []
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "bestax-mcp",
|
|
3
|
-
"version": "1.18.
|
|
3
|
+
"version": "1.18.24",
|
|
4
4
|
"mcpName": "io.github.allxsmith/bestax-mcp",
|
|
5
5
|
"description": "MCP server for @allxsmith/bestax-bulma — component props, examples, CSS variables and agent skills, served offline from a version-pinned index",
|
|
6
6
|
"type": "module",
|
|
@@ -40,17 +40,15 @@
|
|
|
40
40
|
"url": "https://github.com/allxsmith/bestax/issues"
|
|
41
41
|
},
|
|
42
42
|
"dependencies": {
|
|
43
|
-
"@modelcontextprotocol/sdk": "^1.32.
|
|
43
|
+
"@modelcontextprotocol/sdk": "^1.32.2",
|
|
44
44
|
"zod": "^4.6.7",
|
|
45
|
-
"@allxsmith/bestax-bulma": "^5.57.
|
|
45
|
+
"@allxsmith/bestax-bulma": "^5.57.2"
|
|
46
46
|
},
|
|
47
47
|
"devDependencies": {
|
|
48
|
-
"@
|
|
49
|
-
"@
|
|
50
|
-
"
|
|
51
|
-
"
|
|
52
|
-
"ts-jest": "^29.4.15",
|
|
53
|
-
"typescript": "^6.0.3"
|
|
48
|
+
"@types/node": "^26.6.6",
|
|
49
|
+
"@vitest/coverage-istanbul": "^5.0.5",
|
|
50
|
+
"typescript": "^6.0.3",
|
|
51
|
+
"vitest": "^5.0.5"
|
|
54
52
|
},
|
|
55
53
|
"publishConfig": {
|
|
56
54
|
"access": "public"
|
|
@@ -58,9 +56,9 @@
|
|
|
58
56
|
"scripts": {
|
|
59
57
|
"build": "node scripts/sync-skills.mjs && tsc",
|
|
60
58
|
"dev": "tsc --watch",
|
|
61
|
-
"test": "node scripts/sync-skills.mjs &&
|
|
62
|
-
"test:watch": "node scripts/sync-skills.mjs &&
|
|
63
|
-
"test:coverage": "node scripts/sync-skills.mjs &&
|
|
59
|
+
"test": "node scripts/sync-skills.mjs && vitest run",
|
|
60
|
+
"test:watch": "node scripts/sync-skills.mjs && vitest",
|
|
61
|
+
"test:coverage": "node scripts/sync-skills.mjs && vitest run --coverage",
|
|
64
62
|
"lint": "eslint src",
|
|
65
63
|
"typecheck": "tsc --noEmit",
|
|
66
64
|
"format": "prettier --write \"src/**/*.ts\"",
|