bestax-mcp 1.18.8 → 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.
- package/data/bulma-classes.json +1 -0
- package/data/catalog.json +18 -1
- package/data/components/ScrollArea.json +240 -0
- package/data/components/TreeView.json +19 -1
- package/data/skills/bestax-custom-component/references/component-catalog.md +2 -1
- package/data/skills/bestax-layout-scaffold/SKILL.md +8 -0
- package/data/skills/bestax-migrate/references/bloomer/prop-map.md +1 -1
- package/data/skills/bestax-migrate/references/rbx/prop-map.md +1 -1
- package/data/skills/bestax-migrate/references/react-bulma-components/unmappables.md +1 -1
- package/data/skills/bestax-optimize/references/modular-build.md +1 -1
- package/data/skills/bestax-theming/references/css-variables.md +13 -0
- package/data/skills/bestax-theming/references/themeable-components.md +1 -0
- package/data/skills.json +7 -7
- package/package.json +2 -2
package/data/bulma-classes.json
CHANGED
|
@@ -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.
|
|
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
|
+
}
|
|
@@ -42,7 +42,7 @@
|
|
|
42
42
|
"code": "<TreeView\n aria-label=\"Files\"\n selectionMode=\"single\"\n defaultSelected=\"src/App.tsx\"\n defaultExpanded={['src']}\n>\n <TreeView.Item value=\"src\" label=\"src\" icon=\"folder\">\n <TreeView.Item value=\"src/index.ts\" label=\"index.ts\" icon=\"file\" />\n <TreeView.Item value=\"src/App.tsx\" label=\"App.tsx\" icon=\"file\" />\n <TreeView.Item value=\"src/legacy.ts\" label=\"legacy.ts\" disabled />\n </TreeView.Item>\n <TreeView.Item value=\"package.json\" label=\"package.json\" icon=\"file\" />\n</TreeView>"
|
|
43
43
|
}
|
|
44
44
|
],
|
|
45
|
-
"accessibility": "`TreeView` follows the [APG Tree View Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/treeview/).\n\n- **Roles:** the root is a `<ul role=\"tree\">`, each item an `<li role=\"treeitem\">`, and an open\n parent's children sit in a `<ul role=\"group\">` inside it. A closed item's children have no\n markup.\n- **A name:** a tree needs one, from `aria-label` or `aria-labelledby`, and a development build\n warns when it has neither. Each item is named by `aria-labelledby` pointing at its own label, and\n declares its `aria-level`, which VoiceOver needs according to\n [GitHub's testing](https://github.blog/engineering/user-experience/considerations-for-making-a-tree-view-component-accessible/).\n `aria-expanded` is on parents only.\n- **One tab stop, with real focus:** one item holds `tabIndex={0}` and the rest `-1`, and focus\n moves from item to item, rather than through `aria-activedescendant`. When focus comes into the\n tree, it lands on the selected item, or in a checkbox tree on the first checked item on the page.\n Without one, it lands where focus last was, or on the first item. If the item holding the stop\n goes away, its nearest ancestor on the page takes it, and focus goes too if it had focus.\n- **Selection:** a `single` tree marks each enabled item `aria-selected`, `true` or `false`. A\n `checkbox` tree marks `aria-checked` on every item, `true`, `false` or `mixed`, disabled ones\n included, and adds `aria-multiselectable=\"true\"` to the tree. A tree never has both, and a tree\n with no `selectionMode` has neither. Selection doesn't follow focus.\n- **The box** is a [`Checkbox`](https://bestax.io/docs/api/form/checkbox) inside an `aria-hidden` span, with\n `tabIndex={-1}`, so it's neither a tab stop nor a second thing for a screen reader to read. The\n item's `aria-checked` is what a screen reader hears.\n- **Disabled items** are `aria-disabled` and stay reachable from the arrow keys, Home, End and\n typing, so a screen reader user finds them. They're never selected, checked, opened or closed.\n One that's already open stays open, so what's under it is still reachable.\n- **A loading item's row** is a `treeitem` that says Loading…, marked `aria-disabled` and reached\n the way a disabled item is, so a screen reader user who moves into the folder hears what's\n happening. It has no value: it's never selected or checked, it has no `aria-selected` or\n `aria-checked`, and a checkbox tree doesn't count it. If it goes with focus on it, focus moves to\n the item it was loading for. Bulma's loader turns in its chevron's place, hidden from assistive\n tech.\n- **A failed load's row** is a `treeitem` named by its message and the Retry button's text, such\n as \"Couldn't load src Retry\". Enter, Space or a click on the row calls `onRetry`, in every mode.\n The button is drawn inside an `aria-hidden` span and takes no focus, the way an item's box is,\n so the tree keeps its one tab stop, and nothing in the message should be a link or a button\n either. A retry that starts loading keeps the same row, so focus stays on it. With no `onRetry`,\n the row is disabled and shows the message alone.\n- **Announcements:** a visually hidden `role=\"status\"` region with `aria-live=\"polite\"` sits right\n after the tree, one for the whole tree, from the moment it mounts, so a screen reader is already\n listening when something is written into it. It says \"Loading src\" when an open item starts\n loading, a failed load's message, and \"src loaded\" when the loading row or a failed load's row\n goes with the item still open.\n The name is the item's label as a screen reader reads it. A closed item, or one in a closed\n branch, says nothing. Each announcement is written a moment after the change and cleared soon\n after, so the page doesn't keep a second copy of the text.\n\nEnter and Space do the item's one thing, which depends on the mode:\n\n| Key | No `selectionMode` | `single` | `checkbox` |\n| ----- | ------------------------ | ---------------- | ------------------------ |\n| Enter | Opens or closes a parent | Selects the item | Opens or closes a parent |\n| Space | Opens or closes a parent | Selects the item | Checks or unchecks it |\n\nOn a failed load's row, both retry, whatever the mode. The rest work the same in every mode:\n\n| Key | What it does |\n| ---------- | ----------------------------------------------------------------------------------------- |\n| Down, Up | The next or previous item on the page, without wrapping |\n| Right | Opens a closed parent, and focus stays. On an open parent, moves to its first child |\n| Left | Closes an open parent. Otherwise moves to its parent |\n| Home, End | The first item, and the last one on the page |\n| `*` | Opens every closed parent beside the focused item, itself included. Focus stays |\n| Characters | Moves to the next item whose label starts with what's typed, several characters adding up |\n| Tab | Leaves the tree |\n\n- **Right to left:** Right and Left swap in a right-to-left page, and the chevron points to the\n left while closed.\n- **Keys it leaves alone:** anything with Control, Alt or Meta held, anything while an input method\n is composing, and Escape, so it reaches a Modal or Popover around the tree. An item's own\n `onKeyDown` runs first, and calling `preventDefault()` there keeps the tree from acting on the\n key.\n- **Clicks:** the chevron only opens and closes. The rest of the row does the item's one thing:\n opens or closes it with no `selectionMode`, selects it (and opens or closes a parent) in a\n `single` tree, and checks it in a `checkbox` tree. A click moves focus and the tab stop to the\n item.\n- **Not for site navigation:** APG's own\n [navigation tree example](https://www.w3.org/WAI/ARIA/apg/patterns/treeview/examples/treeview-navigation/)\n says \"A pattern more suited for typical site navigation with expandable groups of links is the\n disclosure pattern\", and a tree's items aren't links. Keep a sidebar on [`Menu`](https://bestax.io/docs/api/components/menu),\n whose `Menu.Section` is that disclosure pattern.\n- **Focus and the selected look differ:** the focus ring sits outside the row, so it shows on the\n selected fill as well as on a plain row.\n- **Forced colors:** in Windows high contrast mode the selected row is the system's Highlight and\n HighlightText, a disabled row or a loading one is GrayText, and the focus ring, the chevrons and\n the guide lines stay visible, since they're outlines and borders. A mixed box keeps its dash, and\n the loader's ring stays open.\n- **Motion:** the chevron turns with a short transition, and the loader spins. Both stop when the\n reader asks for reduced motion, and the loader stays drawn.",
|
|
45
|
+
"accessibility": "`TreeView` follows the [APG Tree View Pattern](https://www.w3.org/WAI/ARIA/apg/patterns/treeview/).\n\n- **Roles:** the root is a `<ul role=\"tree\">`, each item an `<li role=\"treeitem\">`, and an open\n parent's children sit in a `<ul role=\"group\">` inside it. A closed item's children have no\n markup.\n- **A name:** a tree needs one, from `aria-label` or `aria-labelledby`, and a development build\n warns when it has neither. Each item is named by `aria-labelledby` pointing at its own label, and\n declares its `aria-level`, which VoiceOver needs according to\n [GitHub's testing](https://github.blog/engineering/user-experience/considerations-for-making-a-tree-view-component-accessible/).\n `aria-expanded` is on parents only.\n- **Positions:** each item also declares `aria-posinset` and `aria-setsize`, its place among the\n items beside it, so a screen reader that doesn't work positions out for itself still has them.\n The tree reads them off the page once it mounts, and again whenever items open, close, load or\n move, so server markup leaves them to the browser until then. They're the values a browser works\n out on its own: a loading row or a failed load's row counts with the items beside it. When the\n page holds only part of a set, such as the first page of a long folder, pass both on every item\n of that set: yours win, and the tree's own stay on any item without them.\n- **One tab stop, with real focus:** one item holds `tabIndex={0}` and the rest `-1`, and focus\n moves from item to item, rather than through `aria-activedescendant`. When focus comes into the\n tree, it lands on the selected item, or in a checkbox tree on the first checked item on the page.\n Without one, it lands where focus last was, or on the first item. If the item holding the stop\n goes away, its nearest ancestor on the page takes it, and focus goes too if it had focus.\n- **Selection:** a `single` tree marks each enabled item `aria-selected`, `true` or `false`. A\n `checkbox` tree marks `aria-checked` on every item, `true`, `false` or `mixed`, disabled ones\n included, and adds `aria-multiselectable=\"true\"` to the tree. A tree never has both, and a tree\n with no `selectionMode` has neither. Selection doesn't follow focus.\n- **The box** is a [`Checkbox`](https://bestax.io/docs/api/form/checkbox) inside an `aria-hidden` span, with\n `tabIndex={-1}`, so it's neither a tab stop nor a second thing for a screen reader to read. The\n item's `aria-checked` is what a screen reader hears.\n- **Disabled items** are `aria-disabled` and stay reachable from the arrow keys, Home, End and\n typing, so a screen reader user finds them. They're never selected, checked, opened or closed.\n One that's already open stays open, so what's under it is still reachable. In a `single` tree a\n disabled item has no `aria-selected`. In a `checkbox` tree it keeps `aria-checked`, so the state\n its box shows is heard as well as seen, such as \"checked, disabled\".\n- **A loading item's row** is a `treeitem` that says Loading…, marked `aria-disabled` and reached\n the way a disabled item is, so a screen reader user who moves into the folder hears what's\n happening. It has no value: it's never selected or checked, it has no `aria-selected` or\n `aria-checked`, and a checkbox tree doesn't count it. If it goes with focus on it, focus moves to\n the item it was loading for. Bulma's loader turns in its chevron's place, hidden from assistive\n tech.\n- **A failed load's row** is a `treeitem` named by its message and the Retry button's text, such\n as \"Couldn't load src Retry\". Enter, Space or a click on the row calls `onRetry`, in every mode.\n The button is drawn inside an `aria-hidden` span and takes no focus, the way an item's box is,\n so the tree keeps its one tab stop, and nothing in the message should be a link or a button\n either. A retry that starts loading keeps the same row, so focus stays on it. With no `onRetry`,\n the row is disabled and shows the message alone.\n- **Announcements:** a visually hidden `role=\"status\"` region with `aria-live=\"polite\"` sits right\n after the tree, one for the whole tree, from the moment it mounts, so a screen reader is already\n listening when something is written into it. It says \"Loading src\" when an open item starts\n loading, a failed load's message, and \"src loaded\" when the loading row or a failed load's row\n goes with the item still open.\n The name is the item's label as a screen reader reads it. A closed item, or one in a closed\n branch, says nothing. Each announcement is written a moment after the change and cleared soon\n after, so the page doesn't keep a second copy of the text. A selection or a check isn't written\n there: it changes `aria-selected` or `aria-checked` on the focused item, which a screen reader\n reads out again, as the simulated one below does.\n\nEnter and Space do the item's one thing, which depends on the mode:\n\n| Key | No `selectionMode` | `single` | `checkbox` |\n| ----- | ------------------------ | ---------------- | ------------------------ |\n| Enter | Opens or closes a parent | Selects the item | Opens or closes a parent |\n| Space | Opens or closes a parent | Selects the item | Checks or unchecks it |\n\nOn a failed load's row, both retry, whatever the mode. The rest work the same in every mode:\n\n| Key | What it does |\n| ---------- | ----------------------------------------------------------------------------------------- |\n| Down, Up | The next or previous item on the page, without wrapping |\n| Right | Opens a closed parent, and focus stays. On an open parent, moves to its first child |\n| Left | Closes an open parent. Otherwise moves to its parent |\n| Home, End | The first item, and the last one on the page |\n| `*` | Opens every closed parent beside the focused item, itself included. Focus stays |\n| Characters | Moves to the next item whose label starts with what's typed, several characters adding up |\n| Tab | Leaves the tree |\n\n- **Right to left:** Right and Left swap in a right-to-left page, and the chevron points to the\n left while closed.\n- **Keys it leaves alone:** anything with Control, Alt or Meta held, anything while an input method\n is composing, and Escape, so it reaches a Modal or Popover around the tree. An item's own\n `onKeyDown` runs first, and calling `preventDefault()` there keeps the tree from acting on the\n key.\n- **Clicks:** the chevron only opens and closes. The rest of the row does the item's one thing:\n opens or closes it with no `selectionMode`, selects it (and opens or closes a parent) in a\n `single` tree, and checks it in a `checkbox` tree. A click moves focus and the tab stop to the\n item.\n- **Not for site navigation:** APG's own\n [navigation tree example](https://www.w3.org/WAI/ARIA/apg/patterns/treeview/examples/treeview-navigation/)\n says \"A pattern more suited for typical site navigation with expandable groups of links is the\n disclosure pattern\", and a tree's items aren't links. Keep a sidebar on [`Menu`](https://bestax.io/docs/api/components/menu),\n whose `Menu.Section` is that disclosure pattern.\n- **Focus and the selected look differ:** the focus ring sits outside the row, so it shows on the\n selected fill as well as on a plain row.\n- **Forced colors:** in Windows high contrast mode the selected row is the system's Highlight and\n HighlightText, a disabled row or a loading one is GrayText, and the focus ring, the chevrons and\n the guide lines stay visible, since they're outlines and borders. A mixed box keeps its dash, and\n the loader's ring stays open.\n- **Motion:** the chevron turns with a short transition, and the loader spins. Both stop when the\n reader asks for reduced motion, and the loader stays drawn.\n\n**What a screen reader says.** What follows is simulated, with\n[Guidepup's Virtual Screen Reader](https://www.guidepup.dev/docs/virtual) 0.33.0, which reads the\naccessibility tree the way the ARIA and HTML specs describe. It isn't a recording of NVDA, JAWS\nor VoiceOver, and each of those words things its own way. The library's tests press these keys\nthrough it on the FileBrowser, Permissions and DeepTree stories, and fail if what it says changes.\n\n1. **Onto a closed parent, then Right and Left:** \"treeitem, helpers, not expanded, level 2,\n position 2, not selected, set size 3\". Right reads it again as \"expanded\" and Left as \"not\n expanded\", with focus staying on it. The items that appear are read when focus reaches them.\n2. **Enter and Space with no `selectionMode`:** each press on a parent reads it again with its new\n state, \"treeitem, src, not expanded, level 1, position 1, set size 4\", then \"expanded\". A tree\n with no selection says nothing about one.\n3. **A level deeper and back up:** Right from components reads its first child, \"treeitem,\n Button.tsx, level 3, position 1, not selected, set size 3\", and Left goes back to \"treeitem,\n components, expanded, level 2, position 1, not selected, set size 3\".\n4. **Enter in a `single` tree:** the item is read again, \"treeitem, TreeView.tsx, level 3, position\n 3, selected, set size 3\". The item that lost the selection says \"not selected\" when focus gets\n back to it.\n5. **Space in a `checkbox` tree:** the item is read again as \"checked\". Its parent turns mixed\n without a word, and Left to it reads \"treeitem, Billing, partially checked, expanded, level 1,\n position 2, set size 2\". Space on the parent reads \"checked\", and so does each item under it as\n focus reaches it.\n6. **A disabled item:** in a `single` tree, \"treeitem, legacy.ts, disabled, level 2, position 3, set\n size 3\", with no selection state. In a `checkbox` tree, \"treeitem, Delete, not checked,\n disabled, level 4, position 3, set size 3\", or \"checked, disabled\" for one its own value checks.\n Enter and Space on it change nothing and say nothing.\n7. **Positions:** each item says its place among the items beside it, such as \"position 2\" and \"set\n size 3\", at every level.\n8. **Tab in and back out, with an item selected:** Tab lands on the selected item, \"treeitem,\n Card.tsx, level 3, position 2, selected, set size 3\", and Tab again leaves the tree for the next\n control. Shift+Tab comes back to Card.tsx, wherever focus was in the tree before.\n\nStill open in [#1171](https://github.com/allxsmith/bestax/issues/1171): recordings with NVDA, JAWS\nand VoiceOver on macOS and iOS, a real Windows contrast theme in place of Chromium's forced colors\nemulation, and runs in Firefox and Safari.",
|
|
46
46
|
"related": [
|
|
47
47
|
"Checkbox",
|
|
48
48
|
"Collapse",
|
|
@@ -345,6 +345,24 @@
|
|
|
345
345
|
}
|
|
346
346
|
],
|
|
347
347
|
"extraProps": [
|
|
348
|
+
{
|
|
349
|
+
"name": "aria-posinset",
|
|
350
|
+
"type": "number",
|
|
351
|
+
"default": null,
|
|
352
|
+
"description": "The item's number among the items beside it. The tree declares it, and `aria-setsize`, from the items on the page once it mounts. When the page holds only part of a set, such as the first page of a long folder, pass both on every item of that set: yours win, and the tree's own stay on any item without them.",
|
|
353
|
+
"required": false,
|
|
354
|
+
"inherited": false,
|
|
355
|
+
"deprecated": false
|
|
356
|
+
},
|
|
357
|
+
{
|
|
358
|
+
"name": "aria-setsize",
|
|
359
|
+
"type": "number",
|
|
360
|
+
"default": null,
|
|
361
|
+
"description": "How many items sit beside it, itself included. Declared by the tree like `aria-posinset`, and `-1` says the count isn't known.",
|
|
362
|
+
"required": false,
|
|
363
|
+
"inherited": false,
|
|
364
|
+
"deprecated": false
|
|
365
|
+
},
|
|
348
366
|
{
|
|
349
367
|
"name": "ref",
|
|
350
368
|
"type": "React.Ref<HTMLLIElement>",
|
|
@@ -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
|
-
|
|
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":
|
|
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":
|
|
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":
|
|
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":
|
|
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":
|
|
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":
|
|
179
|
+
"bytes": 52405
|
|
180
180
|
},
|
|
181
181
|
{
|
|
182
182
|
"id": "themeable-components",
|
|
183
183
|
"file": "references/themeable-components.md",
|
|
184
|
-
"bytes":
|
|
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.
|
|
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.
|
|
45
|
+
"@allxsmith/bestax-bulma": "^5.48.0"
|
|
46
46
|
},
|
|
47
47
|
"devDependencies": {
|
|
48
48
|
"@jest/globals": "^30.0.0",
|