bestax-mcp 1.18.28 → 1.18.29
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 +16 -1
- package/data/components/Affix.json +135 -0
- package/data/skills/bestax-custom-component/references/component-catalog.md +2 -1
- package/data/skills/bestax-layout-scaffold/SKILL.md +9 -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 +2 -1
- package/data/skills/bestax-theming/references/css-variables.md +12 -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
|
@@ -13094,6 +13094,7 @@
|
|
|
13094
13094
|
}
|
|
13095
13095
|
],
|
|
13096
13096
|
"ownClasses": {
|
|
13097
|
+
"affix": "Affix",
|
|
13097
13098
|
"autocomplete": "Autocomplete",
|
|
13098
13099
|
"avatar": "Avatar",
|
|
13099
13100
|
"avatars": "Avatars",
|
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.60.0"
|
|
6
6
|
},
|
|
7
7
|
"docsBase": "https://bestax.io/docs",
|
|
8
8
|
"categories": [
|
|
@@ -54,6 +54,7 @@
|
|
|
54
54
|
"id": "components",
|
|
55
55
|
"label": "Components",
|
|
56
56
|
"components": [
|
|
57
|
+
"Affix",
|
|
57
58
|
"Avatar",
|
|
58
59
|
"Avatars",
|
|
59
60
|
"Badge",
|
|
@@ -164,6 +165,17 @@
|
|
|
164
165
|
}
|
|
165
166
|
],
|
|
166
167
|
"components": [
|
|
168
|
+
{
|
|
169
|
+
"name": "Affix",
|
|
170
|
+
"kind": "component",
|
|
171
|
+
"category": "components",
|
|
172
|
+
"purpose": "The `Affix` component keeps its content fixed to a corner of the viewport while the page scrolls under it.",
|
|
173
|
+
"slug": "components/affix",
|
|
174
|
+
"import": "import { Affix } from '@allxsmith/bestax-bulma';",
|
|
175
|
+
"compound": false,
|
|
176
|
+
"propCount": 4,
|
|
177
|
+
"exampleCount": 8
|
|
178
|
+
},
|
|
167
179
|
{
|
|
168
180
|
"name": "Autocomplete",
|
|
169
181
|
"kind": "component",
|
|
@@ -1530,6 +1542,9 @@
|
|
|
1530
1542
|
}
|
|
1531
1543
|
],
|
|
1532
1544
|
"cssVarIndex": {
|
|
1545
|
+
"--bulma-affix-offset-horizontal": ["Affix"],
|
|
1546
|
+
"--bulma-affix-offset-vertical": ["Affix"],
|
|
1547
|
+
"--bulma-affix-z-index": ["Affix"],
|
|
1533
1548
|
"--bulma-autocomplete-border-color": ["Autocomplete"],
|
|
1534
1549
|
"--bulma-autocomplete-border-hover-color": ["Autocomplete"],
|
|
1535
1550
|
"--bulma-autocomplete-dropdown-background": ["Autocomplete"],
|
|
@@ -0,0 +1,135 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "Affix",
|
|
3
|
+
"kind": "component",
|
|
4
|
+
"category": "components",
|
|
5
|
+
"slug": "components/affix",
|
|
6
|
+
"docsUrl": "https://bestax.io/docs/api/components/affix",
|
|
7
|
+
"examples": [
|
|
8
|
+
{
|
|
9
|
+
"title": "Basic Usage",
|
|
10
|
+
"code": "function example() {\n const [shown, setShown] = useState(false);\n return (\n <>\n <Button onClick={() => setShown(!shown)}>\n {shown ? 'Hide the Help button' : 'Show the Help button'}\n </Button>\n {shown && (\n <Affix position=\"bottom-left\">\n <Button color=\"primary\">Help</Button>\n </Affix>\n )}\n </>\n );\n}"
|
|
11
|
+
},
|
|
12
|
+
{
|
|
13
|
+
"title": "Corners",
|
|
14
|
+
"code": "import type { AffixPosition } from '@allxsmith/bestax-bulma';\n\nfunction example() {\n const [position, setPosition] = useState<AffixPosition | null>(null);\n const corners: AffixPosition[] = [\n 'top-left',\n 'top-right',\n 'bottom-left',\n 'bottom-right',\n ];\n return (\n <>\n <Buttons>\n {corners.map(corner => (\n <Button key={corner} onClick={() => setPosition(corner)}>\n {corner}\n </Button>\n ))}\n <Button disabled={!position} onClick={() => setPosition(null)}>\n Hide\n </Button>\n </Buttons>\n {position && (\n <Affix\n position={position}\n mt={position.startsWith('top') ? '6' : undefined}\n mb={position === 'bottom-right' ? '6' : undefined}\n >\n <Button color=\"primary\">Feedback</Button>\n </Affix>\n )}\n </>\n );\n}"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"title": "Nudging One Affix",
|
|
18
|
+
"code": "function example() {\n const [shown, setShown] = useState(false);\n return (\n <>\n <Button onClick={() => setShown(!shown)}>\n {shown ? 'Hide the chat button' : 'Show the chat button'}\n </Button>\n {shown && (\n <Affix position=\"bottom-left\" mb=\"6\">\n <IconButton\n icon=\"comments\"\n color=\"link\"\n isRounded\n aria-label=\"Open chat\"\n />\n </Affix>\n )}\n </>\n );\n}"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"title": "Offsets and the Safe Area",
|
|
22
|
+
"code": "<Affix className=\"above-the-tab-bar\">\n <Button color=\"primary\">Help</Button>\n</Affix>"
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
"title": "Out of a Transformed Ancestor",
|
|
26
|
+
"code": "function example() {\n const [shown, setShown] = useState(false);\n return (\n <>\n <Button onClick={() => setShown(!shown)}>\n {shown ? 'Hide the portaled button' : 'Show the portaled button'}\n </Button>\n {shown && (\n <Affix portal position=\"bottom-left\">\n <Button color=\"primary\">Feedback</Button>\n </Affix>\n )}\n </>\n );\n}"
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"title": "Several Things in One Corner",
|
|
30
|
+
"code": "function example() {\n const [shown, setShown] = useState(false);\n return (\n <>\n <Button onClick={() => setShown(!shown)}>\n {shown ? 'Hide the buttons' : 'Show the buttons'}\n </Button>\n {shown && (\n <Affix\n position=\"bottom-left\"\n display=\"flex\"\n flexDirection=\"column\"\n gap=\"2\"\n >\n <IconButton icon=\"comments\" color=\"link\" aria-label=\"Open chat\" />\n <IconButton icon=\"question\" color=\"primary\" aria-label=\"Help\" />\n </Affix>\n )}\n </>\n );\n}"
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
"title": "A Consent Notice",
|
|
34
|
+
"code": "function example() {\n const [shown, setShown] = useState(false);\n return (\n <>\n <Button onClick={() => setShown(true)}>Show the notice</Button>\n {shown && (\n <Affix position=\"bottom-left\">\n <Box role=\"region\" aria-label=\"Cookie consent\" mb=\"0\">\n <ScrollArea\n maxHeight=\"calc(100dvh - 2 * var(--bulma-affix-offset-vertical) - env(safe-area-inset-top, 0px) - env(safe-area-inset-bottom, 0px) - 7rem)\"\n aria-label=\"What we store\"\n mb=\"3\"\n >\n <Paragraph>\n We use one cookie to remember your theme. Nothing else is\n stored, and nothing is shared.\n </Paragraph>\n </ScrollArea>\n <Buttons>\n <Button color=\"primary\" onClick={() => setShown(false)}>\n Accept\n </Button>\n <Button onClick={() => setShown(false)}>Decline</Button>\n </Buttons>\n </Box>\n </Affix>\n )}\n </>\n );\n}"
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
"title": "Right-to-Left",
|
|
38
|
+
"code": "function example() {\n const [shown, setShown] = useState(false);\n return (\n <LocaleProvider locale=\"ar\" dir=\"rtl\">\n <Button onClick={() => setShown(!shown)}>\n {shown ? 'إخفاء' : 'إظهار'}\n </Button>\n {shown && (\n <Affix position=\"bottom-left\">\n <Button color=\"primary\">ملاحظات</Button>\n </Affix>\n )}\n </LocaleProvider>\n );\n}"
|
|
39
|
+
}
|
|
40
|
+
],
|
|
41
|
+
"accessibility": "- **No role:** it's a positioning wrapper, and what's inside keeps its own role. Content that needs\n a landmark, such as a consent notice, brings its own `role=\"region\"` and name, as in\n [A Consent Notice](https://bestax.io/docs/api/components/affix#a-consent-notice).\n- **Reading and Tab order are DOM order:** the corner it shows in says nothing about when a screen\n reader or the Tab key reaches it. In place, that's where you write it, so put it where it belongs\n in the reading order, usually after the page's main content. With `portal` it's appended to its\n container when it mounts, so it comes after what's already there.\n- **Focus not obscured:** a fixed box can cover a focused link near its corner, which fails\n [WCAG 2.4.11](https://www.w3.org/WAI/WCAG22/Understanding/focus-not-obscured-minimum) when it\n hides it entirely. On a page with a bottom-corner Affix, give `html` a `scroll-padding-bottom` at\n least its height plus its offset\n ([technique C43](https://www.w3.org/WAI/WCAG22/Techniques/css/C43)), so a link that Tab scrolls\n into view stops above it, and leave as much room at the end of the page, so the last link can\n scroll clear too:\n\n ```css\n html {\n scroll-padding-bottom: 5rem;\n }\n\n main {\n padding-bottom: 5rem;\n }\n ```\n\n A top-corner Affix takes `scroll-padding-top` the same way. Not every browser scrolls to a\n focused link that's already on screen, so the padding lowers the odds rather than ruling it out,\n and a small Affix leaves less of the page under it.\n\n- **Reflow:** it's never wider than the viewport less its offsets, at 320px too, so its text wraps\n rather than running off the side. It doesn't scroll, so content that can be taller than the\n screen at high zoom has to scroll itself, as in [A Consent Notice](https://bestax.io/docs/api/components/affix#a-consent-notice), with the\n controls that matter outside the scrolling part. A fixed box takes a bigger share of the screen\n at high zoom, so keep what's in it small.\n- **Forced colors:** it draws nothing of its own, so what's inside keeps its own forced colors.\n- **Motion:** it has no motion of its own. What's inside keeps its own transitions.\n- **Right-to-left:** the corner stays where `position` puts it. See\n [Right-to-Left](https://bestax.io/docs/api/components/affix#right-to-left).",
|
|
42
|
+
"related": [
|
|
43
|
+
"Badge",
|
|
44
|
+
"Box",
|
|
45
|
+
"Button",
|
|
46
|
+
"Modal",
|
|
47
|
+
"Portal",
|
|
48
|
+
"ScrollArea",
|
|
49
|
+
"Toast",
|
|
50
|
+
"useBulmaClasses"
|
|
51
|
+
],
|
|
52
|
+
"storybook": "https://bestax.io/storybook/?path=/story/components-affix--default",
|
|
53
|
+
"summary": "The `Affix` component keeps its content fixed to a corner of the viewport while the page scrolls under it. It's a `<div>` with no role, so what's inside keeps its own. It sits `--bulma-affix-offset-vertical` and `--bulma-affix-offset-horizontal` from its corner's edges, plus the device's safe-area inset, and stacks at `--bulma-affix-z-index`, over the page's content and under its navbar, static or fixed, its menus, popovers, the Sidebar, the modals, Tooltip and Toast. It's as wide as its content and never wider than the viewport less its offsets. It doesn't scroll, so nothing inside it is clipped, and content that can be taller than the screen scrolls itself. Its place in the reading and Tab order is its place in the DOM, whatever corner it shows in.",
|
|
54
|
+
"import": "import { Affix } from '@allxsmith/bestax-bulma';",
|
|
55
|
+
"sourceFile": "bulma-ui/src/components/Affix.tsx",
|
|
56
|
+
"rootClass": "affix",
|
|
57
|
+
"parts": [
|
|
58
|
+
{
|
|
59
|
+
"path": "Affix",
|
|
60
|
+
"summary": "The `Affix` component keeps its content fixed to a corner of the viewport while the page scrolls under it. It's a `<div>` with no role, so what's inside keeps its own. It sits `--bulma-affix-offset-vertical` and `--bulma-affix-offset-horizontal` from its corner's edges, plus the device's safe-area inset, and stacks at `--bulma-affix-z-index`, over the page's content and under its navbar, static or fixed, its menus, popovers, the Sidebar, the modals, Tooltip and Toast. It's as wide as its content and never wider than the viewport less its offsets. It doesn't scroll, so nothing inside it is clipped, and content that can be taller than the screen scrolls itself. Its place in the reading and Tab order is its place in the DOM, whatever corner it shows in.",
|
|
61
|
+
"component": null,
|
|
62
|
+
"props": [
|
|
63
|
+
{
|
|
64
|
+
"name": "className",
|
|
65
|
+
"type": "string",
|
|
66
|
+
"default": null,
|
|
67
|
+
"description": "Additional CSS classes to apply.",
|
|
68
|
+
"required": false,
|
|
69
|
+
"inherited": false,
|
|
70
|
+
"deprecated": false
|
|
71
|
+
},
|
|
72
|
+
{
|
|
73
|
+
"name": "children",
|
|
74
|
+
"type": "React.ReactNode",
|
|
75
|
+
"default": null,
|
|
76
|
+
"description": "What stays in the corner.",
|
|
77
|
+
"required": false,
|
|
78
|
+
"inherited": false,
|
|
79
|
+
"deprecated": false
|
|
80
|
+
},
|
|
81
|
+
{
|
|
82
|
+
"name": "position",
|
|
83
|
+
"type": "'top-right' | 'top-left' | 'bottom-right' | 'bottom-left'",
|
|
84
|
+
"default": "'bottom-right'",
|
|
85
|
+
"description": "The corner of the viewport it's fixed to. Physical, as Badge's and Toast's are: `'bottom-right'` stays on the right in right-to-left text. Its distance from the edges is `--bulma-affix-offset-vertical` and `--bulma-affix-offset-horizontal` plus the device's safe-area inset; a margin from the spacing helpers (`mb`, `mr`, …) adds to it. A margin on one side also takes that much of the width its content can have, which the offset variables don't, so move it far with those.",
|
|
86
|
+
"required": false,
|
|
87
|
+
"inherited": false,
|
|
88
|
+
"deprecated": false
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
"name": "portal",
|
|
92
|
+
"type": "boolean | string | HTMLElement",
|
|
93
|
+
"default": "false",
|
|
94
|
+
"description": "Renders it into another container, for a page where an ancestor's `transform`, `filter` or `contain` would capture `position: fixed`. `true` portals to the `portalContainer` a `ConfigProvider` sets, `document.body` by default; a string is used as a `document.querySelector` selector; an element is used directly. Renders in place on the server and while hydrating, moving into the portal once the client takes over, so hydration matches. Portaled, it's appended to that container when it mounts, so it comes after what's already there in the reading and Tab order.",
|
|
95
|
+
"required": false,
|
|
96
|
+
"inherited": false,
|
|
97
|
+
"deprecated": false
|
|
98
|
+
}
|
|
99
|
+
],
|
|
100
|
+
"extraProps": [
|
|
101
|
+
{
|
|
102
|
+
"name": "ref",
|
|
103
|
+
"type": "React.Ref<HTMLDivElement>",
|
|
104
|
+
"default": null,
|
|
105
|
+
"description": "Ref forwarded to the `<div>`, wherever it renders.",
|
|
106
|
+
"required": false,
|
|
107
|
+
"inherited": false,
|
|
108
|
+
"deprecated": false
|
|
109
|
+
}
|
|
110
|
+
],
|
|
111
|
+
"catchAll": "All standard <div> attributes and Bulma helper props",
|
|
112
|
+
"types": []
|
|
113
|
+
}
|
|
114
|
+
],
|
|
115
|
+
"cssVars": [
|
|
116
|
+
{
|
|
117
|
+
"css": "--bulma-affix-offset-vertical",
|
|
118
|
+
"sass": "$affix-offset-vertical",
|
|
119
|
+
"default": "$block-spacing",
|
|
120
|
+
"scope": "root"
|
|
121
|
+
},
|
|
122
|
+
{
|
|
123
|
+
"css": "--bulma-affix-offset-horizontal",
|
|
124
|
+
"sass": "$affix-offset-horizontal",
|
|
125
|
+
"default": "$block-spacing",
|
|
126
|
+
"scope": "root"
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
"css": "--bulma-affix-z-index",
|
|
130
|
+
"sass": "$affix-z-index",
|
|
131
|
+
"default": "$extras-z-index-dropdown - 1",
|
|
132
|
+
"scope": "root"
|
|
133
|
+
}
|
|
134
|
+
]
|
|
135
|
+
}
|
|
@@ -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
|
+
125 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
|
|
@@ -83,6 +83,7 @@ component is guaranteed to appear (the generator fails if one lacks an API page)
|
|
|
83
83
|
|
|
84
84
|
## Components
|
|
85
85
|
|
|
86
|
+
- [Affix](https://bestax.io/docs/api/components/affix) — The `Affix` component keeps its content fixed to a corner of the viewport while the page scrolls under it.
|
|
86
87
|
- [Avatar](https://bestax.io/docs/api/components/avatar) — The `Avatar` component represents a person or entity as a compact image.
|
|
87
88
|
- [Avatars](https://bestax.io/docs/api/components/avatars) — The `Avatars` component renders an overlapping/stacked group of `Avatar`s, the "members" list pattern.
|
|
88
89
|
- [Badge](https://bestax.io/docs/api/components/badge) — The `Badge` component is a small status/count indicator overlaid on the corner of another element, or rendered standalone.
|
|
@@ -169,6 +169,15 @@ Centered; a collection of items → Card grid. For mixed requests, pick the domi
|
|
|
169
169
|
helper props and `className` go on its frame and the `ref` on the element that scrolls.
|
|
170
170
|
`hasFade` fades the edges that have more, `orientation="horizontal"` suits a wide table, and
|
|
171
171
|
`onEdgeReach={edge => …}` loads more at an edge.
|
|
172
|
+
- **Something that stays in a corner of the screen (a floating button, a chat or help launcher,
|
|
173
|
+
a feedback tab, a consent notice) is `Affix`**, not `pos="fixed"` with offsets in a style:
|
|
174
|
+
`<Affix position="bottom-left"><Button color="primary">Feedback</Button></Affix>`.
|
|
175
|
+
`position` is one of the four corners, `'bottom-right'` by default, and stays physical in
|
|
176
|
+
right-to-left text. The spacing helpers nudge one further in (`mb="6"` lifts it over a bottom
|
|
177
|
+
bar), and `portal` moves it out of an ancestor with a `transform`. Two in one corner overlap,
|
|
178
|
+
so put what shares a corner in one Affix. Tab reaches it where it is in the markup, whatever
|
|
179
|
+
corner it shows in, so write it after the main content. For an element pinned once the page
|
|
180
|
+
scrolls past it, use `pos="sticky"` with a `top` instead.
|
|
172
181
|
- **A command palette (⌘K or Ctrl+K) is `Command.Dialog`**, not a `Modal` with an `Input` and a
|
|
173
182
|
hand-written `keydown` listener: `<Command.Dialog shortcut="mod+k" placeholder="…" actions={[…]} />`,
|
|
174
183
|
each action `{ id, label, onSelect }` with `group`, `keywords`, `description`, `icon` and `hint`
|
|
@@ -189,7 +189,7 @@ value is flagged. The same conversion covers the modifiers bestax has no prop fo
|
|
|
189
189
|
|
|
190
190
|
## Refs
|
|
191
191
|
|
|
192
|
-
bloomer forwarded no refs. bestax forwards a ref from the form controls, plus `Avatar`, `Button`,
|
|
192
|
+
bloomer forwarded no refs. bestax forwards a ref from the form controls, plus `Affix`, `Avatar`, `Button`,
|
|
193
193
|
`Carousel`, `CarouselItem`, `Center`, `ColorSwatch`, `Command`, `Command.Dialog`, `Command.Input`, `DataTable`, `DescriptionList`, `DescriptionList.Item`, `DescriptionList.Label`, `DescriptionList.Value`, `Dialog`, `Dropdown`, `EmptyState`, `Flex`, `Group`, `IconButton`, `Kbd`, `Kbd.Group`, `Link`,
|
|
194
194
|
`LinkButton`, `Loader`, `LocaleProvider`, `Menu.Item`, `Modal`, `Navbar`, `Navbar.Burger`, `Navbar.Dropdown`,
|
|
195
195
|
`Navbar.Item`, `Navbar.Link`, `NumberFormatter`, `RingProgress`, `ScrollArea`, `SegmentedControl`, `SegmentedControl.Segment`, `Sidebar`, `Splitter`, `Splitter.Pane`, `Stack`, `Timeline`,
|
|
@@ -186,7 +186,7 @@ Beside a `ref` the element already has, a rename leaves `innerRef` in place with
|
|
|
186
186
|
TODO rather than write a second `ref`; keep whichever one you meant.
|
|
187
187
|
|
|
188
188
|
An existing `ref` is passed through untouched — which is safe only where the bestax target forwards
|
|
189
|
-
one. rbx forwards a ref on every component; bestax does so on the form controls, plus `Avatar`,
|
|
189
|
+
one. rbx forwards a ref on every component; bestax does so on the form controls, plus `Affix`, `Avatar`,
|
|
190
190
|
`Button`, `Carousel`, `CarouselItem`, `Center`, `ColorSwatch`, `Command`, `Command.Dialog`, `Command.Input`, `DataTable`, `DescriptionList`, `DescriptionList.Item`, `DescriptionList.Label`, `DescriptionList.Value`, `Dialog`, `Dropdown`, `EmptyState`, `Flex`, `Group`, `IconButton`, `Kbd`, `Kbd.Group`,
|
|
191
191
|
`Link`, `LinkButton`, `Loader`, `LocaleProvider`, `Menu.Item`, `Modal`, `Navbar`, `Navbar.Burger`, `Navbar.Dropdown`,
|
|
192
192
|
`Navbar.Item`, `Navbar.Link`, `NumberFormatter`, `RingProgress`, `ScrollArea`, `SegmentedControl`, `SegmentedControl.Segment`, `Sidebar`, `Splitter`, `Splitter.Pane`, `Stack`, `Timeline`,
|
|
@@ -189,7 +189,7 @@ The same TODO marks a `Heading` that sets `size` and `textSize` both: drop `size
|
|
|
189
189
|
## `domRef`
|
|
190
190
|
|
|
191
191
|
bestax components don't take `domRef`, but many forward a plain `ref` — the form controls, plus
|
|
192
|
-
`Avatar`, `Button`, `Carousel`, `CarouselItem`, `Center`, `ColorSwatch`, `Command`, `Command.Dialog`, `Command.Input`, `DataTable`, `DescriptionList`, `DescriptionList.Item`, `DescriptionList.Label`, `DescriptionList.Value`, `Dialog`, `Dropdown`, `EmptyState`, `Flex`, `Group`, `IconButton`, `Kbd`,
|
|
192
|
+
`Affix`, `Avatar`, `Button`, `Carousel`, `CarouselItem`, `Center`, `ColorSwatch`, `Command`, `Command.Dialog`, `Command.Input`, `DataTable`, `DescriptionList`, `DescriptionList.Item`, `DescriptionList.Label`, `DescriptionList.Value`, `Dialog`, `Dropdown`, `EmptyState`, `Flex`, `Group`, `IconButton`, `Kbd`,
|
|
193
193
|
`Kbd.Group`, `Link`, `LinkButton`, `Loader`, `LocaleProvider`, `Menu.Item`, `Modal`, `Navbar`, `Navbar.Burger`,
|
|
194
194
|
`Navbar.Dropdown`, `Navbar.Item`, `Navbar.Link`, `NumberFormatter`, `RingProgress`, `ScrollArea`, `SegmentedControl`, `SegmentedControl.Segment`,
|
|
195
195
|
`Sidebar`, `Splitter`, `Splitter.Pane`, `Stack`, `Timeline`, `Timeline.Item`, `Toast`, `ToggleButton`, `TreeView` and `TreeView.Item`. On
|
|
@@ -81,7 +81,8 @@ 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`, `pagination
|
|
84
|
+
`emptystate`, `timeline`, `treeview`, `scrollarea`, `command`, `datatable`, `pagination`,
|
|
85
|
+
`affix`
|
|
85
86
|
|
|
86
87
|
**Layout** (`@allxsmith/bestax-bulma/scss/layout/<name>`): `splitter`, `stack`
|
|
87
88
|
|
|
@@ -303,6 +303,18 @@ The remaining extras register the variables below — names only; each default l
|
|
|
303
303
|
component's SCSS partial under `bulma-ui/src/scss/` as a `$<name> !default` variable. The same
|
|
304
304
|
own-selector override rule applies.
|
|
305
305
|
|
|
306
|
+
### Affix
|
|
307
|
+
|
|
308
|
+
The offsets start at Bulma's `$block-spacing` as a value, so a Sass build that sets it moves every
|
|
309
|
+
Affix, and a Field, where Bulma narrows `--bulma-block-spacing`, doesn't. Each edge adds the
|
|
310
|
+
device's safe-area inset on top in the stylesheet, which is 0 unless the page sets
|
|
311
|
+
`viewport-fit=cover`; there's no variable for it. The variables are declared on `.affix`, so a theme
|
|
312
|
+
sets them there with a selector that outweighs the library's, such as `:root .affix`. A spacing
|
|
313
|
+
helper margin (`mb="6"`) moves one Affix further in without touching the variables. The z-index
|
|
314
|
+
starts one step under the dropdown layer, so menus open over it.
|
|
315
|
+
|
|
316
|
+
`--bulma-affix-offset-horizontal`, `--bulma-affix-offset-vertical`, `--bulma-affix-z-index`
|
|
317
|
+
|
|
306
318
|
### Autocomplete
|
|
307
319
|
|
|
308
320
|
`--bulma-autocomplete-border-color`, `--bulma-autocomplete-border-hover-color`,
|
|
@@ -58,6 +58,7 @@ Shades (`colorShade` / `backgroundColorShade`): `00, 05, 10, … 95, invert, lig
|
|
|
58
58
|
| `Badge` | `primary \| link \| info \| success \| warning \| danger \| black \| dark \| light \| white` | — | pill background; default `danger` |
|
|
59
59
|
| `Title` | — (no `color`; use `textColor`) | `1`–`6` (string or number) | also `isSpaced`; `size` also sets the heading level unless `as="p"`: pair `as` with `textSize` instead |
|
|
60
60
|
| `SubTitle` | — (no `color`; use `textColor`) | `1`–`6` (string or number) | `size` also sets the heading level unless `as="p"` (an `<h1>` with neither): pair `as` with `textSize` instead |
|
|
61
|
+
| `Affix` | — (no `color`: it draws nothing of its own) | — | `position` picks the corner; the offsets from the edges and the z-index are `--bulma-affix-*`, and a spacing helper margin nudges one |
|
|
61
62
|
| `Autocomplete` | `primary \| link \| info \| success \| warning \| danger` | `small \| medium \| large` | the 6 only |
|
|
62
63
|
| `Checkbox` | `primary \| link \| info \| success \| warning \| danger` | `small \| normal \| medium \| large` | the 6 only |
|
|
63
64
|
| `CheckboxCard` | `primary \| link \| info \| success \| warning \| danger` | — | the indicator and a checked edge; the surface is Bulma's `.card`, so `--bulma-card-*` styles it |
|
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": 24821
|
|
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": 26984
|
|
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": 15825
|
|
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": 14176
|
|
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": 16277
|
|
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": 65689
|
|
180
180
|
},
|
|
181
181
|
{
|
|
182
182
|
"id": "themeable-components",
|
|
183
183
|
"file": "references/themeable-components.md",
|
|
184
|
-
"bytes":
|
|
184
|
+
"bytes": 36394
|
|
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.29",
|
|
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.2",
|
|
44
44
|
"zod": "^4.6.7",
|
|
45
|
-
"@allxsmith/bestax-bulma": "^5.
|
|
45
|
+
"@allxsmith/bestax-bulma": "^5.60.0"
|
|
46
46
|
},
|
|
47
47
|
"devDependencies": {
|
|
48
48
|
"@types/node": "^26.6.6",
|