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 CHANGED
@@ -2,7 +2,7 @@
2
2
  "schemaVersion": 2,
3
3
  "generatedFrom": {
4
4
  "package": "@allxsmith/bestax-bulma",
5
- "version": "5.57.0"
5
+ "version": "5.57.2"
6
6
  },
7
7
  "docsBase": "https://bestax.io/docs",
8
8
  "categories": [
@@ -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 className=\"heading\">Posts</Paragraph>\n <Title as=\"p\">1,234</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph className=\"heading\">Following</Paragraph>\n <Title as=\"p\">6789</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph className=\"heading\">Followers</Paragraph>\n <Title as=\"p\">123K</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph className=\"heading\">Likes</Paragraph>\n <Title as=\"p\">9876</Title>\n </Block>\n </Level.Item>\n</Level>"
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 className=\"heading\">Posts</Paragraph>\n <Title as=\"p\">1,234</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph className=\"heading\">Following</Paragraph>\n <Title as=\"p\">4567</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph className=\"heading\">Followers</Paragraph>\n <Title as=\"p\">123K</Title>\n </Block>\n </Level.Item>\n <Level.Item hasTextCentered>\n <Block>\n <Paragraph className=\"heading\">Likes</Paragraph>\n <Title as=\"p\">9876</Title>\n </Block>\n </Level.Item>\n</Level>"
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 box 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.",
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, jest tests, docs page, wiring.
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 # Jest + RTL tests
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 jest meta-test.
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`, Jest + `@testing-library/react`. Cover render, each prop →
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-caps label. It becomes the plain `<p className="heading">`
204
- bloomer rendered, but Bulma v1 no longer ships styles for that class, so restyle it:
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>Label</Heading>
208
- <Title as="p" size={6} textTransform="uppercase" textWeight="semibold">Label</Title>
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_ | mapped |
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": 22090
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": 17913
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": 15120
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": 14012
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": 13389
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": 13622
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.22",
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.1",
43
+ "@modelcontextprotocol/sdk": "^1.32.2",
44
44
  "zod": "^4.6.7",
45
- "@allxsmith/bestax-bulma": "^5.57.0"
45
+ "@allxsmith/bestax-bulma": "^5.57.2"
46
46
  },
47
47
  "devDependencies": {
48
- "@jest/globals": "^30.0.0",
49
- "@types/jest": "^30.0.0",
50
- "@types/node": "^26.6.5",
51
- "jest": "^30.2.0",
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 && NODE_OPTIONS=\"--experimental-vm-modules\" jest",
62
- "test:watch": "node scripts/sync-skills.mjs && NODE_OPTIONS=\"--experimental-vm-modules\" jest --watch",
63
- "test:coverage": "node scripts/sync-skills.mjs && NODE_OPTIONS=\"--experimental-vm-modules\" jest --coverage",
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\"",