bestax-mcp 1.18.9 → 1.18.10

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.
@@ -13117,6 +13117,7 @@
13117
13117
  "styled-radio": "Radio",
13118
13118
  "rate": "Rate",
13119
13119
  "reveal": "Reveal",
13120
+ "scroll-area": "ScrollArea",
13120
13121
  "sidebar": "Sidebar",
13121
13122
  "slider": "Slider",
13122
13123
  "steps": "Steps",
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.47.0"
5
+ "version": "5.48.0"
6
6
  },
7
7
  "docsBase": "https://bestax.io/docs",
8
8
  "categories": [
@@ -71,6 +71,7 @@
71
71
  "Panel",
72
72
  "Popover",
73
73
  "Reveal",
74
+ "ScrollArea",
74
75
  "SegmentedControl",
75
76
  "Sidebar",
76
77
  "Steps",
@@ -940,6 +941,17 @@
940
941
  "propCount": 11,
941
942
  "exampleCount": 5
942
943
  },
944
+ {
945
+ "name": "ScrollArea",
946
+ "kind": "component",
947
+ "category": "components",
948
+ "purpose": "The `ScrollArea` component renders a box whose content scrolls inside it, on the browser's own scrollbars in Bulma's colors.",
949
+ "slug": "components/scrollarea",
950
+ "import": "import { ScrollArea } from '@allxsmith/bestax-bulma';",
951
+ "compound": false,
952
+ "propCount": 12,
953
+ "exampleCount": 8
954
+ },
943
955
  {
944
956
  "name": "Section",
945
957
  "kind": "component",
@@ -2389,6 +2401,11 @@
2389
2401
  "--bulma-reveal-offset": ["Reveal"],
2390
2402
  "--bulma-reveal-offset-large": ["Reveal"],
2391
2403
  "--bulma-reveal-scale": ["Reveal"],
2404
+ "--bulma-scroll-area-fade-size": ["ScrollArea"],
2405
+ "--bulma-scroll-area-scrollbar-width": ["ScrollArea"],
2406
+ "--bulma-scroll-area-thumb-color": ["ScrollArea"],
2407
+ "--bulma-scroll-area-thumb-hover-color": ["ScrollArea"],
2408
+ "--bulma-scroll-area-track-color": ["ScrollArea"],
2392
2409
  "--bulma-section-padding": ["Section"],
2393
2410
  "--bulma-section-padding-desktop": ["Section"],
2394
2411
  "--bulma-section-padding-large": ["Section"],
@@ -0,0 +1,240 @@
1
+ {
2
+ "name": "ScrollArea",
3
+ "kind": "component",
4
+ "category": "components",
5
+ "slug": "components/scrollarea",
6
+ "docsUrl": "https://bestax.io/docs/api/components/scrollarea",
7
+ "examples": [
8
+ {
9
+ "title": "Basic Usage",
10
+ "code": "<Box p=\"0\">\n <ScrollArea height={200} aria-label=\"Release notes\">\n <Content p=\"4\">\n <h3>Version 3.2</h3>\n <p>\n Search now matches tags as well as titles, and remembers the last filter\n you used on each page.\n </p>\n <h3>Version 3.1</h3>\n <p>\n Exports include the time zone, and a CSV export keeps the column order\n you set in the table.\n </p>\n <h3>Version 3.0</h3>\n <p>\n A new dashboard, with the numbers you check most at the top and the rest\n a click away.\n </p>\n </Content>\n </ScrollArea>\n</Box>"
11
+ },
12
+ {
13
+ "title": "Named by a Heading",
14
+ "code": "<Card>\n <Card.Content>\n <Title as=\"h3\" textSize=\"5\" id=\"terms-title\">\n Terms of service\n </Title>\n <ScrollArea height={160} aria-labelledby=\"terms-title\" className=\"box p-0\">\n <Content p=\"4\">\n <p>\n These terms cover your use of the service. By making an account, you\n agree to them.\n </p>\n <p>\n You keep the rights to what you upload. We keep a copy only as long as\n it takes to run the service for you.\n </p>\n <p>\n We may change these terms. When we do, we tell you a month ahead, by\n email and on this page.\n </p>\n </Content>\n </ScrollArea>\n </Card.Content>\n</Card>"
15
+ },
16
+ {
17
+ "title": "Growing to a Height",
18
+ "code": "function example() {\n const [count, setCount] = useState(2);\n return (\n <>\n <Button size=\"small\" mb=\"3\" onClick={() => setCount(c => c + 2)}>\n Add two messages\n </Button>\n <ScrollArea maxHeight=\"14rem\" aria-label=\"Messages\" className=\"box p-0\">\n {Array.from({ length: count }, (_, i) => (\n <Message key={i} title={i % 2 ? 'Sam' : 'Ana'} m=\"3\">\n Message {i + 1}.\n </Message>\n ))}\n </ScrollArea>\n </>\n );\n}"
19
+ },
20
+ {
21
+ "title": "Fading the Edges",
22
+ "code": "<Notification color=\"info\" p=\"0\">\n <ScrollArea height={160} aria-label=\"Release notes\" hasFade>\n <Content p=\"4\">\n <p>\n Search now matches tags as well as titles, and remembers the last filter\n you used on each page.\n </p>\n <p>\n Exports include the time zone, and a CSV export keeps the column order\n you set in the table.\n </p>\n <p>\n A new dashboard, with the numbers you check most at the top and the rest\n a click away.\n </p>\n <p>Faster loading for long lists, and shortcuts for common actions.</p>\n </Content>\n </ScrollArea>\n</Notification>"
23
+ },
24
+ {
25
+ "title": "Which Way It Scrolls",
26
+ "code": "<ScrollArea\n orientation=\"horizontal\"\n aria-label=\"Quarterly results\"\n className=\"box p-0\"\n>\n <Table isNarrow mb=\"0\">\n <Thead>\n <Tr>\n <Th>Region</Th>\n <Th>Q1 2025</Th>\n <Th>Q2 2025</Th>\n <Th>Q3 2025</Th>\n <Th>Q4 2025</Th>\n <Th>Q1 2026</Th>\n <Th>Q2 2026</Th>\n <Th>Q3 2026</Th>\n </Tr>\n </Thead>\n <Tbody>\n <Tr>\n <Td>North</Td>\n <Td>1,812</Td>\n <Td>1,943</Td>\n <Td>2,074</Td>\n <Td>2,205</Td>\n <Td>2,336</Td>\n <Td>2,467</Td>\n <Td>2,598</Td>\n </Tr>\n <Tr>\n <Td>South</Td>\n <Td>1,715</Td>\n <Td>1,846</Td>\n <Td>1,977</Td>\n <Td>2,108</Td>\n <Td>2,239</Td>\n <Td>2,370</Td>\n <Td>2,501</Td>\n </Tr>\n </Tbody>\n </Table>\n</ScrollArea>"
27
+ },
28
+ {
29
+ "title": "When the Scrollbars Show",
30
+ "code": "<Columns>\n <Column>\n <ScrollArea height={140} aria-label=\"Notes, auto\" className=\"box p-0\">\n <Content p=\"4\">\n <p>auto: the bar shows whenever the content overflows.</p>\n <p>Scroll down to see the rest of the note.</p>\n <p>This is the end of it.</p>\n </Content>\n </ScrollArea>\n </Column>\n <Column>\n <ScrollArea\n height={140}\n showScrollbars=\"hover\"\n aria-label=\"Notes, hover\"\n className=\"box p-0\"\n >\n <Content p=\"4\">\n <p>hover: the bar shows while the pointer is over it.</p>\n <p>Scroll down to see the rest of the note.</p>\n <p>This is the end of it.</p>\n </Content>\n </ScrollArea>\n </Column>\n <Column>\n <ScrollArea\n height={140}\n showScrollbars=\"always\"\n aria-label=\"Notes, always\"\n className=\"box p-0\"\n >\n <Content p=\"4\">\n <p>always: the bar is there even when the content fits.</p>\n </Content>\n </ScrollArea>\n </Column>\n</Columns>"
31
+ },
32
+ {
33
+ "title": "A Sidebar Menu",
34
+ "code": "<Box p=\"0\">\n <ScrollArea\n height={220}\n aria-label=\"Sections\"\n showScrollbars=\"hover\"\n hasStableGutter\n >\n <Menu p=\"3\">\n <Menu.Label>General</Menu.Label>\n <Menu.List>\n <Menu.Item href=\"#dashboard\">Dashboard</Menu.Item>\n <Menu.Item href=\"#customers\">Customers</Menu.Item>\n <Menu.Item href=\"#orders\">Orders</Menu.Item>\n </Menu.List>\n <Menu.Label>Reports</Menu.Label>\n <Menu.List>\n <Menu.Item href=\"#sales\">Sales</Menu.Item>\n <Menu.Item href=\"#traffic\">Traffic</Menu.Item>\n <Menu.Item href=\"#retention\">Retention</Menu.Item>\n </Menu.List>\n <Menu.Label>Settings</Menu.Label>\n <Menu.List>\n <Menu.Item href=\"#team\">Team</Menu.Item>\n <Menu.Item href=\"#billing\">Billing</Menu.Item>\n </Menu.List>\n </Menu>\n </ScrollArea>\n</Box>"
35
+ },
36
+ {
37
+ "title": "Loading More at an Edge",
38
+ "code": "function example() {\n const [messages, setMessages] = useState(() =>\n Array.from({ length: 6 }, (_, i) => `Message ${i + 1}`)\n );\n const [status, setStatus] = useState('');\n\n function loadOlder() {\n setMessages(current => [\n ...Array.from(\n { length: 3 },\n (_, i) => `Older message ${current.length + i + 1}`\n ),\n ...current,\n ]);\n setStatus('Loaded three older messages');\n }\n\n return (\n <>\n <Paragraph role=\"status\" visibility=\"sr-only\">\n {status}\n </Paragraph>\n <ScrollArea\n height={220}\n aria-label=\"Messages\"\n hasFade\n className=\"box p-0\"\n onEdgeReach={edge => {\n if (edge === 'top') loadOlder();\n }}\n >\n {messages.map(text => (\n <Message key={text} m=\"3\">\n {text}\n </Message>\n ))}\n </ScrollArea>\n </>\n );\n}"
39
+ }
40
+ ],
41
+ "accessibility": "- **A tab stop while it overflows:** while the content overflows on an axis it scrolls, the\n viewport has `role=\"region\"` and `tabIndex={0}`, so a keyboard user can tab to it and scroll it\n with the arrow keys, Page Up, Page Down, Home, End and Space. Chrome and Firefox make a scroller\n reachable on their own, and Safari doesn't, which is what axe's `scrollable-region-focusable`\n rule catches. While the content fits, it's a plain box and no tab stop. One that stops\n overflowing while it has focus keeps its tab stop until focus leaves it.\n- **A name:** pass `aria-label`, or `aria-labelledby` with a visible heading's id. It's what a\n screen reader says when the area takes focus, and a development build warns when there's\n neither. It's rendered along with the region's role, while the content overflows, since ARIA\n doesn't allow naming a plain `div`.\n- **The scrollbars are the system's:** ScrollArea adds no key handling and draws no bars of its\n own, so scrolling works the way it does anywhere in the browser, and the system's settings for\n its bars still apply.\n- **Contrast:** the thumb is Bulma's `text-weak`, which clears WCAG's 3:1 against `scheme-main` in\n light and dark mode, and darker while the pointer is over the area.\n- **Forced colors:** the bars take the system's colors on their own, the focus ring is the\n system's text color, and the fade is off.\n- **More contrast:** the fade is off when the user asks for more contrast.\n- **Focus ring:** Bulma's focus outline, drawn on the frame, so the fade never clips it.\n- **Not live:** content that changes inside it announces nothing on its own. When loading more\n changes the content out of sight, say so in a `role=\"status\"` region, as in\n [Loading More at an Edge](https://bestax.io/docs/api/components/scrollarea#loading-more-at-an-edge).\n- **No motion:** nothing animates. Scrolling is the browser's own, so `scroll-behavior` and\n `prefers-reduced-motion` work as they do anywhere.",
42
+ "related": ["Box", "Card", "Menu", "Table", "useBulmaClasses"],
43
+ "storybook": "https://bestax.io/storybook/?path=/story/components-scrollarea--default",
44
+ "summary": "The `ScrollArea` component renders a box whose content scrolls inside it, on the browser's own scrollbars in Bulma's colors. The bars are the system's, made thin and colored from Bulma's tokens, so they follow dark mode and keep the system's own settings. While the content overflows, the viewport is a region you can tab to and scroll by keyboard, Safari included, named by `aria-label` or `aria-labelledby`. While it fits, it's a plain box. Setting the bars' colors turns off any `::-webkit-scrollbar` styles inside it.",
45
+ "import": "import { ScrollArea } from '@allxsmith/bestax-bulma';",
46
+ "sourceFile": "bulma-ui/src/components/ScrollArea.tsx",
47
+ "rootClass": "scroll-area",
48
+ "parts": [
49
+ {
50
+ "path": "ScrollArea",
51
+ "summary": "The `ScrollArea` component renders a box whose content scrolls inside it, on the browser's own scrollbars in Bulma's colors. The bars are the system's, made thin and colored from Bulma's tokens, so they follow dark mode and keep the system's own settings. While the content overflows, the viewport is a region you can tab to and scroll by keyboard, Safari included, named by `aria-label` or `aria-labelledby`. While it fits, it's a plain box. Setting the bars' colors turns off any `::-webkit-scrollbar` styles inside it.",
52
+ "component": null,
53
+ "props": [
54
+ {
55
+ "name": "className",
56
+ "type": "string",
57
+ "default": null,
58
+ "description": "Additional CSS classes for the outer frame.",
59
+ "required": false,
60
+ "inherited": false,
61
+ "deprecated": false
62
+ },
63
+ {
64
+ "name": "style",
65
+ "type": "React.CSSProperties",
66
+ "default": null,
67
+ "description": "Inline styles for the outer frame.",
68
+ "required": false,
69
+ "inherited": false,
70
+ "deprecated": false
71
+ },
72
+ {
73
+ "name": "children",
74
+ "type": "React.ReactNode",
75
+ "default": null,
76
+ "description": "What scrolls.",
77
+ "required": false,
78
+ "inherited": false,
79
+ "deprecated": false
80
+ },
81
+ {
82
+ "name": "height",
83
+ "type": "number | string",
84
+ "default": null,
85
+ "description": "The area's height. A number is pixels, and a string is any CSS length (`\"20rem\"`, `\"50vh\"`, `\"100%\"`).",
86
+ "required": false,
87
+ "inherited": false,
88
+ "deprecated": false
89
+ },
90
+ {
91
+ "name": "maxHeight",
92
+ "type": "number | string",
93
+ "default": null,
94
+ "description": "The height it grows to with its content, then scrolls past. A number is pixels. Use it in place of `height` for an area that's only as tall as it needs to be.",
95
+ "required": false,
96
+ "inherited": false,
97
+ "deprecated": false
98
+ },
99
+ {
100
+ "name": "orientation",
101
+ "type": "'vertical' | 'horizontal' | 'both'",
102
+ "default": "'both'",
103
+ "description": "Which way it scrolls. `vertical` and `horizontal` clip the other axis, and `both` scrolls whichever overflows.",
104
+ "required": false,
105
+ "inherited": false,
106
+ "deprecated": false
107
+ },
108
+ {
109
+ "name": "showScrollbars",
110
+ "type": "'auto' | 'hover' | 'always'",
111
+ "default": "'auto'",
112
+ "description": "When the scrollbars show. `auto`: whenever the content overflows, the way the system shows them. `hover`: colorless until the pointer is over the area or focus is in it, which hides that the area scrolls until then, so keep it for places where the layout makes that plain. `always`: on every axis it scrolls, even when the content fits. Where the system draws its bars over the content (macOS by default, phones and tablets), they still show only while you scroll, and in forced colors they always show.",
113
+ "required": false,
114
+ "inherited": false,
115
+ "deprecated": false
116
+ },
117
+ {
118
+ "name": "hasStableGutter",
119
+ "type": "boolean",
120
+ "default": "false",
121
+ "description": "Keeps room for the vertical scrollbar whether or not it shows, so the content doesn't shift when it starts to overflow. It does nothing where the system draws its bars over the content.",
122
+ "required": false,
123
+ "inherited": false,
124
+ "deprecated": false
125
+ },
126
+ {
127
+ "name": "hasFade",
128
+ "type": "boolean",
129
+ "default": "false",
130
+ "description": "Fades the content out toward each edge that has more past it, without fading the scrollbar. It's off in forced colors and when the user asks for more contrast.",
131
+ "required": false,
132
+ "inherited": false,
133
+ "deprecated": false
134
+ },
135
+ {
136
+ "name": "onEdgeReach",
137
+ "type": "(edge: ScrollAreaEdge) => void",
138
+ "default": null,
139
+ "description": "Called with the edge when scrolling reaches it, once each time it arrives, such as to load older messages at the top. It isn't called for the edge the area starts at, or when the content changes size.",
140
+ "required": false,
141
+ "inherited": false,
142
+ "deprecated": false
143
+ },
144
+ {
145
+ "name": "textColor",
146
+ "type": "Bulma color | 'inherit' | 'current'",
147
+ "default": null,
148
+ "description": "Text color helper.",
149
+ "required": false,
150
+ "inherited": false,
151
+ "deprecated": false,
152
+ "valuesRef": "helpers/valid-values"
153
+ },
154
+ {
155
+ "name": "bgColor",
156
+ "type": "Bulma color | 'inherit' | 'current'",
157
+ "default": null,
158
+ "description": "Background color helper.",
159
+ "required": false,
160
+ "inherited": false,
161
+ "deprecated": false,
162
+ "valuesRef": "helpers/valid-values"
163
+ }
164
+ ],
165
+ "extraProps": [
166
+ {
167
+ "name": "ref",
168
+ "type": "React.Ref<HTMLDivElement>",
169
+ "default": null,
170
+ "description": "Ref forwarded to the viewport, the element that scrolls, for `scrollTo` and the like.",
171
+ "required": false,
172
+ "inherited": false,
173
+ "deprecated": false
174
+ },
175
+ {
176
+ "name": "aria-label",
177
+ "type": "string",
178
+ "default": null,
179
+ "description": "Names the region, such as \"Release notes\". It needs a name, so pass this or `aria-labelledby`, and a development build warns when it has neither. The name is rendered with the region's role, while the content overflows, since ARIA doesn't allow naming a plain `div`.",
180
+ "required": false,
181
+ "inherited": false,
182
+ "deprecated": false
183
+ },
184
+ {
185
+ "name": "aria-labelledby",
186
+ "type": "string",
187
+ "default": null,
188
+ "description": "The id of a visible heading that names the region, in place of `aria-label`.",
189
+ "required": false,
190
+ "inherited": false,
191
+ "deprecated": false
192
+ },
193
+ {
194
+ "name": "onScroll",
195
+ "type": "React.UIEventHandler<HTMLDivElement>",
196
+ "default": null,
197
+ "description": "Called as the viewport scrolls.",
198
+ "required": false,
199
+ "inherited": false,
200
+ "deprecated": false
201
+ }
202
+ ],
203
+ "catchAll": "All standard <div> attributes and Bulma helper props",
204
+ "helperPropsNote": "The helper props go on the outer `<div>`, the `.scroll-area` frame, with `className` and `style`. The `ref`, the name, `onScroll` and the other attributes go on the `<div>` inside it, the viewport that scrolls.",
205
+ "types": []
206
+ }
207
+ ],
208
+ "cssVars": [
209
+ {
210
+ "css": "--bulma-scroll-area-scrollbar-width",
211
+ "sass": "$scroll-area-scrollbar-width",
212
+ "default": "thin",
213
+ "scope": "root"
214
+ },
215
+ {
216
+ "css": "--bulma-scroll-area-thumb-color",
217
+ "sass": "$scroll-area-thumb-color",
218
+ "default": "var(--bulma-text-weak)",
219
+ "scope": "root"
220
+ },
221
+ {
222
+ "css": "--bulma-scroll-area-thumb-hover-color",
223
+ "sass": "$scroll-area-thumb-hover-color",
224
+ "default": "var(--bulma-text)",
225
+ "scope": "root"
226
+ },
227
+ {
228
+ "css": "--bulma-scroll-area-track-color",
229
+ "sass": "$scroll-area-track-color",
230
+ "default": "transparent",
231
+ "scope": "root"
232
+ },
233
+ {
234
+ "css": "--bulma-scroll-area-fade-size",
235
+ "sass": "$scroll-area-fade-size",
236
+ "default": "2rem",
237
+ "scope": "root"
238
+ }
239
+ ]
240
+ }
@@ -37,7 +37,7 @@ instead of hand-writing markup.
37
37
  - Raw `*Base` form exports (`InputBase`, `SelectBase`, `TextAreaBase`, …) are
38
38
  escape-hatch variants of the convenience wrappers above them; see the Form docs.
39
39
 
40
- 104 documented components. Generated from the API docs — every exported
40
+ 105 documented components. Generated from the API docs — every exported
41
41
  component is guaranteed to appear (the generator fails if one lacks an API page).
42
42
 
43
43
  ## Elements
@@ -100,6 +100,7 @@ component is guaranteed to appear (the generator fails if one lacks an API page)
100
100
  - [Panel](https://bestax.io/docs/api/components/panel) — The `Panel` component implements Bulma's versatile panel block for React.
101
101
  - [Popover](https://bestax.io/docs/api/components/popover) — The `Popover` component opens a panel of interactive content, such as a filter form or a set of share options, anchored to the element that toggles it.
102
102
  - [Reveal](https://bestax.io/docs/api/components/reveal) — The `Reveal` component animates its content into view as it scrolls into the viewport, backed by `IntersectionObserver`.
103
+ - [ScrollArea](https://bestax.io/docs/api/components/scrollarea) — The `ScrollArea` component renders a box whose content scrolls inside it, on the browser's own scrollbars in Bulma's colors.
103
104
  - [SegmentedControl](https://bestax.io/docs/api/components/segmentedcontrol) — The `SegmentedControl` component renders a row of buttons where only one can be on, and tells a screen reader it's a radio group.
104
105
  - [Sidebar](https://bestax.io/docs/api/components/sidebar) — The `Sidebar` component provides a slide-out navigation panel that appears from the left or right side of the screen.
105
106
  - [Steps](https://bestax.io/docs/api/components/steps) — The `Steps` component provides a multi-step progress indicator for wizard flows, checkout processes, or any multi-step workflow.
@@ -122,6 +122,14 @@ Centered; a collection of items → Card grid. For mixed requests, pick the domi
122
122
  `defaultOpen` on the group holding the current page (or `open`/`onOpenChange` to hold the state).
123
123
  Its heading is a real button with `aria-expanded`, and its links stay links, each a tab stop.
124
124
  Not `TreeView`, and not a `Collapse` inside a hand-written `<li>`.
125
+ - **Content taller or wider than its space is `ScrollArea`** (release notes in a Card, a sidebar
126
+ longer than the screen, a feed that grows then scrolls, a wide table on a phone), not a `Box`
127
+ with `overflowY="auto"` and a height in a style: `<ScrollArea height={240} aria-label="…">`,
128
+ or `maxHeight="20rem"` to grow with its content first. It needs `aria-label` or
129
+ `aria-labelledby`, since while it overflows it's a region a keyboard user tabs to. The
130
+ helper props and `className` go on its frame and the `ref` on the element that scrolls.
131
+ `hasFade` fades the edges that have more, `orientation="horizontal"` suits a wide table, and
132
+ `onEdgeReach={edge => …}` loads more at an edge.
125
133
  - Link lists (footer nav, sidebars): a bare `UnorderedList` of `ListItem`s is already
126
134
  marker-less and flush — Bulma's reset unstyles `ul` — so no prop or CSS is needed;
127
135
  bullets appear only inside `Content`.
@@ -192,7 +192,7 @@ value is flagged. The same conversion covers the modifiers bestax has no prop fo
192
192
  bloomer forwarded no refs. bestax forwards a ref from the form controls, plus `Avatar`, `Button`,
193
193
  `Carousel`, `CarouselItem`, `Dialog`, `Dropdown`, `EmptyState`, `Kbd`, `Kbd.Group`, `Link`,
194
194
  `LinkButton`, `Loader`, `Menu.Item`, `Modal`, `Navbar`, `Navbar.Burger`, `Navbar.Dropdown`,
195
- `Navbar.Item`, `Navbar.Link`, `SegmentedControl`, `SegmentedControl.Segment`, `Sidebar`, `Timeline`,
195
+ `Navbar.Item`, `Navbar.Link`, `ScrollArea`, `SegmentedControl`, `SegmentedControl.Segment`, `Sidebar`, `Timeline`,
196
196
  `Timeline.Item`, `Toast`, `ToggleButton`, `TreeView` and `TreeView.Item` — pass `ref` directly on
197
197
  those. "The form controls" means the inputs themselves: the `Field`, `Field.Label`, `Field.Body`,
198
198
  `Checkboxes` and `Radios` wrappers around them forward nothing.
@@ -189,7 +189,7 @@ An existing `ref` is passed through untouched — which is safe only where the b
189
189
  one. rbx forwards a ref on every component; bestax does so on the form controls, plus `Avatar`,
190
190
  `Button`, `Carousel`, `CarouselItem`, `Dialog`, `Dropdown`, `EmptyState`, `Kbd`, `Kbd.Group`,
191
191
  `Link`, `LinkButton`, `Loader`, `Menu.Item`, `Modal`, `Navbar`, `Navbar.Burger`, `Navbar.Dropdown`,
192
- `Navbar.Item`, `Navbar.Link`, `SegmentedControl`, `SegmentedControl.Segment`, `Sidebar`, `Timeline`,
192
+ `Navbar.Item`, `Navbar.Link`, `ScrollArea`, `SegmentedControl`, `SegmentedControl.Segment`, `Sidebar`, `Timeline`,
193
193
  `Timeline.Item`, `Toast`, `ToggleButton`, `TreeView` and `TreeView.Item`. "The form controls" there
194
194
  means the inputs themselves: the `Field`, `Field.Label`, `Field.Body`, `Checkboxes` and `Radios`
195
195
  wrappers around them forward nothing, and `Field` is a target this codemod emits.
@@ -165,7 +165,7 @@ The same TODO marks a `Heading` that sets `size` and `textSize` both: drop `size
165
165
  bestax components don't take `domRef`, but many forward a plain `ref` — the form controls, plus
166
166
  `Avatar`, `Button`, `Carousel`, `CarouselItem`, `Dialog`, `Dropdown`, `EmptyState`, `Kbd`,
167
167
  `Kbd.Group`, `Link`, `LinkButton`, `Loader`, `Menu.Item`, `Modal`, `Navbar`, `Navbar.Burger`,
168
- `Navbar.Dropdown`, `Navbar.Item`, `Navbar.Link`, `SegmentedControl`, `SegmentedControl.Segment`,
168
+ `Navbar.Dropdown`, `Navbar.Item`, `Navbar.Link`, `ScrollArea`, `SegmentedControl`, `SegmentedControl.Segment`,
169
169
  `Sidebar`, `Timeline`, `Timeline.Item`, `Toast`, `ToggleButton`, `TreeView` and `TreeView.Item`. On
170
170
  those, rename `domRef` to `ref` and it works; do not restructure the markup. "The form controls"
171
171
  means the inputs themselves: the `Field`, `Field.Label`, `Field.Body`, `Checkboxes` and `Radios`
@@ -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`
84
+ `emptystate`, `timeline`, `treeview`, `scrollarea`
85
85
 
86
86
  **Form** (`@allxsmith/bestax-bulma/scss/form/<name>`):
87
87
  `checkbox`, `radio`, `switch`, `slider`, `numberinput`, `pininput`, `rate`, `autocomplete`,
@@ -621,6 +621,19 @@ the label text inside the `Radio`, since the whole label is the click target.
621
621
  `--bulma-reveal-duration`, `--bulma-reveal-easing`, `--bulma-reveal-flip-angle`,
622
622
  `--bulma-reveal-offset`, `--bulma-reveal-offset-large`, `--bulma-reveal-scale`
623
623
 
624
+ ### ScrollArea
625
+
626
+ Declared on the frame, `.scroll-area`, and read by the viewport inside it, so set them on the
627
+ frame, through `className` or `style`. `--bulma-scroll-area-scrollbar-width` takes what
628
+ `scrollbar-width` takes: `thin`, `auto` or `none`. `none` hides the bars while the area still
629
+ scrolls, which hides that it scrolls at all, so keep to `thin` or `auto`. Restyled bars owe
630
+ WCAG's 3:1, so keep a thumb color that clears it against the background in both schemes. In forced colors the browser gives the bars the system's colors
631
+ whatever these say.
632
+
633
+ `--bulma-scroll-area-fade-size`, `--bulma-scroll-area-scrollbar-width`,
634
+ `--bulma-scroll-area-thumb-color`, `--bulma-scroll-area-thumb-hover-color`,
635
+ `--bulma-scroll-area-track-color`
636
+
624
637
  ### Sidebar
625
638
 
626
639
  `--bulma-sidebar-background`, `--bulma-sidebar-close-color`,
@@ -79,6 +79,7 @@ Shades (`colorShade` / `backgroundColorShade`): `00, 05, 10, … 95, invert, lig
79
79
  | `Progress` | every `validColors` member (the `-bis`/`-ter` shades and the greys deprecated: no CSS, dev-warn, removed next major — see ⚠️) | `small \| medium \| large` | — |
80
80
  | `Radio` | `primary \| link \| info \| success \| warning \| danger` | `small \| normal \| medium \| large` | the 6 only |
81
81
  | `Rate` | `primary \| link \| info \| success \| warning \| danger` | `small \| medium \| large` | the 6 only |
82
+ | `ScrollArea` | — (no `color`: the thumb is `--bulma-scroll-area-thumb-color`) | — (`--bulma-scroll-area-scrollbar-width`: `thin`, `auto` or `none`) | the browser's own bars, so forced colors gives them the system's colors; retheme through `--bulma-scroll-area-*` |
82
83
  | `SegmentedControl` | `primary \| link \| info \| success \| warning \| danger` | `small \| medium \| large` | fills only the checked segment (default `link`); `size` is the row's `are-<size>`; segments take no `color` or `size` |
83
84
  | `Select` | `primary \| link \| info \| success \| warning \| danger \| black \| dark \| light \| white` | `small \| medium \| large` | also `isRounded` |
84
85
  | `Slider` | `primary \| link \| info \| success \| warning \| danger` | `small \| medium \| large` | also `isRounded`, `isCircle` |
package/data/skills.json CHANGED
@@ -10,7 +10,7 @@
10
10
  {
11
11
  "id": "component-catalog",
12
12
  "file": "references/component-catalog.md",
13
- "bytes": 20804
13
+ "bytes": 20998
14
14
  },
15
15
  {
16
16
  "id": "library-contributor",
@@ -93,7 +93,7 @@
93
93
  {
94
94
  "id": "bloomer-prop-map",
95
95
  "file": "references/bloomer/prop-map.md",
96
- "bytes": 26662
96
+ "bytes": 26676
97
97
  },
98
98
  {
99
99
  "id": "bloomer-unmappables",
@@ -128,7 +128,7 @@
128
128
  {
129
129
  "id": "rbx-prop-map",
130
130
  "file": "references/rbx/prop-map.md",
131
- "bytes": 15503
131
+ "bytes": 15517
132
132
  },
133
133
  {
134
134
  "id": "rbx-unmappables",
@@ -148,7 +148,7 @@
148
148
  {
149
149
  "id": "react-bulma-components-unmappables",
150
150
  "file": "references/react-bulma-components/unmappables.md",
151
- "bytes": 13145
151
+ "bytes": 13159
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": 12331
165
+ "bytes": 12345
166
166
  }
167
167
  ],
168
168
  "examples": []
@@ -176,12 +176,12 @@
176
176
  {
177
177
  "id": "css-variables",
178
178
  "file": "references/css-variables.md",
179
- "bytes": 51664
179
+ "bytes": 52405
180
180
  },
181
181
  {
182
182
  "id": "themeable-components",
183
183
  "file": "references/themeable-components.md",
184
- "bytes": 25101
184
+ "bytes": 25526
185
185
  }
186
186
  ],
187
187
  "examples": [
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bestax-mcp",
3
- "version": "1.18.9",
3
+ "version": "1.18.10",
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",
@@ -42,7 +42,7 @@
42
42
  "dependencies": {
43
43
  "@modelcontextprotocol/sdk": "^1.32.1",
44
44
  "zod": "^4.6.7",
45
- "@allxsmith/bestax-bulma": "^5.47.0"
45
+ "@allxsmith/bestax-bulma": "^5.48.0"
46
46
  },
47
47
  "devDependencies": {
48
48
  "@jest/globals": "^30.0.0",