bestax-mcp 1.14.0 → 1.14.2

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.
Files changed (108) hide show
  1. package/README.md +30 -6
  2. package/data/bulma-classes.json +507 -24
  3. package/data/catalog.json +1291 -897
  4. package/data/components/Autocomplete.json +10 -10
  5. package/data/components/Avatar.json +1 -1
  6. package/data/components/Avatars.json +1 -1
  7. package/data/components/Button.json +3 -3
  8. package/data/components/Buttons.json +2 -2
  9. package/data/components/Carousel.json +1 -1
  10. package/data/components/Cell.json +2 -2
  11. package/data/components/Checkboxes.json +5 -5
  12. package/data/components/ClientOnly.json +38 -7
  13. package/data/components/Collapse.json +4 -4
  14. package/data/components/Columns.json +3 -3
  15. package/data/components/ConfigProvider.json +46 -6
  16. package/data/components/Control.json +3 -3
  17. package/data/components/DateInput.json +46 -30
  18. package/data/components/DateRangeInput.json +962 -0
  19. package/data/components/DateTimeInput.json +44 -28
  20. package/data/components/Dialog.json +2 -2
  21. package/data/components/Dropdown.json +2 -2
  22. package/data/components/Field.json +8 -8
  23. package/data/components/File.json +21 -8
  24. package/data/components/Grid.json +12 -7
  25. package/data/components/Icon.json +3 -3
  26. package/data/components/IconText.json +2 -2
  27. package/data/components/Input.json +7 -7
  28. package/data/components/Link.json +2 -2
  29. package/data/components/LinkButton.json +3 -3
  30. package/data/components/Menu.json +2 -2
  31. package/data/components/Modal.json +1 -1
  32. package/data/components/Navbar.json +3 -3
  33. package/data/components/Notification.json +1 -1
  34. package/data/components/Numberinput.json +8 -8
  35. package/data/components/Panel.json +3 -3
  36. package/data/components/Portal.json +45 -5
  37. package/data/components/Progress.json +2 -2
  38. package/data/components/Radio.json +1 -1
  39. package/data/components/Radios.json +5 -5
  40. package/data/components/Rate.json +5 -5
  41. package/data/components/Select.json +1 -1
  42. package/data/components/Skeleton.json +1 -1
  43. package/data/components/Slider.json +5 -5
  44. package/data/components/SubTitle.json +1 -1
  45. package/data/components/Switch.json +1 -1
  46. package/data/components/Tabs.json +51 -9
  47. package/data/components/Tag.json +2 -2
  48. package/data/components/Taginput.json +10 -10
  49. package/data/components/Tags.json +1 -1
  50. package/data/components/TextArea.json +5 -5
  51. package/data/components/Theme.json +411 -5
  52. package/data/components/TimeInput.json +30 -26
  53. package/data/components/Title.json +1 -1
  54. package/data/components/Toast.json +2 -2
  55. package/data/components/Valid value constants.json +3 -2
  56. package/data/components/classNames.json +2 -1
  57. package/data/components/useBulmaClasses.json +8 -3
  58. package/data/components/useFocusTrap.json +7 -2
  59. package/data/components/usePrefixedClassNames.json +3 -2
  60. package/data/skills/bestax-custom-component/SKILL.md +3 -4
  61. package/data/skills/bestax-custom-component/examples/stat-card.tsx +3 -4
  62. package/data/skills/bestax-custom-component/references/api.md +11 -9
  63. package/data/skills/bestax-custom-component/references/component-catalog.md +5 -4
  64. package/data/skills/bestax-custom-component/references/library-contributor.md +6 -0
  65. package/data/skills/bestax-form/SKILL.md +38 -20
  66. package/data/skills/bestax-form/references/api.md +76 -33
  67. package/data/skills/bestax-icons/SKILL.md +8 -6
  68. package/data/skills/bestax-icons/examples/icon-usage.tsx +3 -3
  69. package/data/skills/bestax-icons/references/icon-libraries.md +3 -3
  70. package/data/skills/bestax-layout-scaffold/SKILL.md +5 -2
  71. package/data/skills/bestax-layout-scaffold/examples/app-shell.tsx +1 -1
  72. package/data/skills/bestax-layout-scaffold/examples/card-grid.tsx +0 -1
  73. package/data/skills/bestax-layout-scaffold/examples/centered.tsx +0 -1
  74. package/data/skills/bestax-layout-scaffold/examples/content-page.tsx +0 -1
  75. package/data/skills/bestax-layout-scaffold/examples/landing.tsx +1 -1
  76. package/data/skills/bestax-layout-scaffold/references/layout-components.md +15 -15
  77. package/data/skills/bestax-migrate/references/bulma-classes/component-map.md +5 -4
  78. package/data/skills/bestax-migrate/references/bulma-classes/prop-map.md +26 -8
  79. package/data/skills/bestax-migrate/references/bulma-classes/unmappables.md +5 -1
  80. package/data/skills/bestax-optimize/SKILL.md +12 -7
  81. package/data/skills/bestax-optimize/references/modular-build.md +14 -3
  82. package/data/skills/bestax-theming/SKILL.md +4 -3
  83. package/data/skills/bestax-theming/examples/dark-mode.tsx +5 -4
  84. package/data/skills/bestax-theming/examples/theme-config.tsx +2 -2
  85. package/data/skills/bestax-theming/references/css-variables.md +23 -2
  86. package/data/skills/bestax-theming/references/themeable-components.md +2 -1
  87. package/data/skills.json +21 -21
  88. package/dist/bulma-classes.d.ts +2 -0
  89. package/dist/bulma-classes.d.ts.map +1 -1
  90. package/dist/bulma-classes.js +20 -1
  91. package/dist/data.d.ts +25 -3
  92. package/dist/data.d.ts.map +1 -1
  93. package/dist/data.js +32 -3
  94. package/dist/format.d.ts +66 -7
  95. package/dist/format.d.ts.map +1 -1
  96. package/dist/format.js +265 -37
  97. package/dist/helper-props.d.ts +2 -2
  98. package/dist/helper-props.d.ts.map +1 -1
  99. package/dist/helper-props.js +7 -3
  100. package/dist/search.d.ts +31 -0
  101. package/dist/search.d.ts.map +1 -1
  102. package/dist/search.js +230 -18
  103. package/dist/server.d.ts.map +1 -1
  104. package/dist/server.js +156 -48
  105. package/dist/version.d.ts +19 -0
  106. package/dist/version.d.ts.map +1 -1
  107. package/dist/version.js +33 -4
  108. package/package.json +4 -4
package/README.md CHANGED
@@ -36,6 +36,14 @@ Each release is published to the official
36
36
  claude mcp add bestax -- npx -y bestax-mcp@1
37
37
  ```
38
38
 
39
+ Or install the [`bestax` plugin](https://github.com/allxsmith/bestax-skills) instead. It runs
40
+ this same server and adds the bestax [Agent Skills](https://bestax.io/docs/skills/intro):
41
+
42
+ ```text
43
+ /plugin marketplace add allxsmith/bestax-skills
44
+ /plugin install bestax@bestax
45
+ ```
46
+
39
47
  ### Cursor, Claude Desktop, Windsurf, Cline
40
48
 
41
49
  Add to your MCP config (`.cursor/mcp.json`, `claude_desktop_config.json`, …):
@@ -51,8 +59,23 @@ Add to your MCP config (`.cursor/mcp.json`, `claude_desktop_config.json`, …):
51
59
  }
52
60
  ```
53
61
 
54
- Run it from your project directory so it can find your installed
55
- `@allxsmith/bestax-bulma` and check it against the indexed version.
62
+ The server checks your installed `@allxsmith/bestax-bulma` against the version it documents,
63
+ looking for it from the directory it starts in. If your client starts servers somewhere other than
64
+ your project, point it at the project with `BESTAX_MCP_PROJECT_DIR` in the config's `env`:
65
+
66
+ ```json
67
+ {
68
+ "mcpServers": {
69
+ "bestax": {
70
+ "command": "npx",
71
+ "args": ["-y", "bestax-mcp@1"],
72
+ "env": { "BESTAX_MCP_PROJECT_DIR": "/path/to/your/project" }
73
+ }
74
+ }
75
+ }
76
+ ```
77
+
78
+ If it finds no installed copy, its first answer says so.
56
79
 
57
80
  The `@1` pins the major version. Without it, `npx` resolves whatever is newest on every
58
81
  launch — so a breaking change, or a compromised release, reaches your agent the next time it
@@ -66,7 +89,7 @@ Start with `list_components` — its output names the tool to call next. Reach f
66
89
 
67
90
  | Tool | What it gives you |
68
91
  | ---------------------- | -------------------------------------------------------------------------------------------------------- |
69
- | `list_components` | All 87 components with a one-line purpose, by category |
92
+ | `list_components` | Every component with a one-line purpose, by category |
70
93
  | `search_bestax` | Components, props, examples, CSS variables and skills in one ranked list |
71
94
  | `get_component` | Import, summary and props; optionally examples, CSS variables, accessibility, related |
72
95
  | `get_props` | One prop table, including compound sub-paths (`Navbar.Brand`) |
@@ -90,9 +113,10 @@ One per skill, so a task can start from the library's own guidance:
90
113
 
91
114
  ## Environment
92
115
 
93
- | Variable | Effect |
94
- | ----------------------------- | ------------------------------------------------------- |
95
- | `BESTAX_MCP_NO_VERSION_CHECK` | Set to `1` to skip the installed-version check entirely |
116
+ | Variable | Effect |
117
+ | ----------------------------- | ------------------------------------------------------------------------------------------------------ |
118
+ | `BESTAX_MCP_NO_VERSION_CHECK` | Set to `1` to skip the installed-version check entirely |
119
+ | `BESTAX_MCP_PROJECT_DIR` | Your project's path, for a client that starts the server outside it; defaults to the working directory |
96
120
 
97
121
  ## Links
98
122