@atelier-ui/mcp 0.0.0-stage → 0.4.12

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 (295) hide show
  1. package/README.md +25 -2
  2. package/bin/atelier-mcp.mjs +9 -0
  3. package/package.json +45 -4
  4. package/snapshot/knowledge/components.json +1 -0
  5. package/snapshot/knowledge/patterns.json +1 -0
  6. package/snapshot/knowledge/tokens.json +1 -0
  7. package/snapshot/manifests/components.json +355 -0
  8. package/snapshot/manifests/docs.json +37 -0
  9. package/snapshot/services/addon-docs/mdx/foundation-colors--docs.json +18 -0
  10. package/snapshot/services/addon-docs/mdx/foundation-spacing--docs.json +18 -0
  11. package/snapshot/services/addon-docs/mdx/foundation-typography--docs.json +18 -0
  12. package/snapshot/services/addon-docs/mdx/introduction--docs.json +18 -0
  13. package/snapshot/services/core/docgen/components-ai-atlchat.json +158 -0
  14. package/snapshot/services/core/docgen/components-display-atlavatar.json +144 -0
  15. package/snapshot/services/core/docgen/components-display-atlbadge.json +97 -0
  16. package/snapshot/services/core/docgen/components-display-atlcard.json +103 -0
  17. package/snapshot/services/core/docgen/components-display-atlcodeblock.json +165 -0
  18. package/snapshot/services/core/docgen/components-display-atlicon.json +172 -0
  19. package/snapshot/services/core/docgen/components-display-atlprogress.json +177 -0
  20. package/snapshot/services/core/docgen/components-display-atlskeleton.json +125 -0
  21. package/snapshot/services/core/docgen/components-display-atltable.json +100 -0
  22. package/snapshot/services/core/docgen/components-feedback-atlaccordiongroup.json +105 -0
  23. package/snapshot/services/core/docgen/components-feedback-atlalert.json +124 -0
  24. package/snapshot/services/core/docgen/components-inputs-atlbutton.json +153 -0
  25. package/snapshot/services/core/docgen/components-inputs-atlcheckbox.json +226 -0
  26. package/snapshot/services/core/docgen/components-inputs-atlcombobox.json +244 -0
  27. package/snapshot/services/core/docgen/components-inputs-atlinput.json +302 -0
  28. package/snapshot/services/core/docgen/components-inputs-atlradio.json +114 -0
  29. package/snapshot/services/core/docgen/components-inputs-atlradiogroup.json +243 -0
  30. package/snapshot/services/core/docgen/components-inputs-atlselect.json +257 -0
  31. package/snapshot/services/core/docgen/components-inputs-atltextarea.json +311 -0
  32. package/snapshot/services/core/docgen/components-inputs-atltoggle.json +209 -0
  33. package/snapshot/services/core/docgen/components-navigation-atlbreadcrumbs.json +55 -0
  34. package/snapshot/services/core/docgen/components-navigation-atlmenu.json +45 -0
  35. package/snapshot/services/core/docgen/components-navigation-atlpagination.json +193 -0
  36. package/snapshot/services/core/docgen/components-navigation-atlstepper.json +156 -0
  37. package/snapshot/services/core/docgen/components-navigation-atltabgroup.json +79 -0
  38. package/snapshot/services/core/docgen/components-overlay-atldialog.json +216 -0
  39. package/snapshot/services/core/docgen/components-overlay-atldrawer.json +190 -0
  40. package/snapshot/services/core/docgen/components-overlay-atltoast.json +145 -0
  41. package/snapshot/services/core/docgen/components-overlay-atltooltip.json +128 -0
  42. package/snapshot/services/core/docgen/cookbook.json +3 -0
  43. package/snapshot/services/core/docgen/showcase-all-components.json +191 -0
  44. package/snapshot/services/core/docgen/showcase-kitchen-sink.json +20 -0
  45. package/snapshot/services/core/story-docs/components-ai-atlchat.json +73 -0
  46. package/snapshot/services/core/story-docs/components-display-atlavatar.json +61 -0
  47. package/snapshot/services/core/story-docs/components-display-atlbadge.json +61 -0
  48. package/snapshot/services/core/story-docs/components-display-atlcard.json +61 -0
  49. package/snapshot/services/core/story-docs/components-display-atlcodeblock.json +41 -0
  50. package/snapshot/services/core/story-docs/components-display-atlicon.json +52 -0
  51. package/snapshot/services/core/story-docs/components-display-atlprogress.json +41 -0
  52. package/snapshot/services/core/story-docs/components-display-atlskeleton.json +46 -0
  53. package/snapshot/services/core/story-docs/components-display-atltable.json +65 -0
  54. package/snapshot/services/core/story-docs/components-feedback-atlaccordiongroup.json +56 -0
  55. package/snapshot/services/core/story-docs/components-feedback-atlalert.json +51 -0
  56. package/snapshot/services/core/story-docs/components-inputs-atlbutton.json +76 -0
  57. package/snapshot/services/core/story-docs/components-inputs-atlcheckbox.json +57 -0
  58. package/snapshot/services/core/story-docs/components-inputs-atlcombobox.json +41 -0
  59. package/snapshot/services/core/story-docs/components-inputs-atlinput.json +70 -0
  60. package/snapshot/services/core/story-docs/components-inputs-atlradio.json +35 -0
  61. package/snapshot/services/core/story-docs/components-inputs-atlradiogroup.json +59 -0
  62. package/snapshot/services/core/story-docs/components-inputs-atlselect.json +65 -0
  63. package/snapshot/services/core/story-docs/components-inputs-atltextarea.json +65 -0
  64. package/snapshot/services/core/story-docs/components-inputs-atltoggle.json +52 -0
  65. package/snapshot/services/core/story-docs/components-navigation-atlbreadcrumbs.json +37 -0
  66. package/snapshot/services/core/story-docs/components-navigation-atlmenu.json +37 -0
  67. package/snapshot/services/core/story-docs/components-navigation-atlpagination.json +41 -0
  68. package/snapshot/services/core/story-docs/components-navigation-atlstepper.json +37 -0
  69. package/snapshot/services/core/story-docs/components-navigation-atltabgroup.json +47 -0
  70. package/snapshot/services/core/story-docs/components-overlay-atldialog.json +59 -0
  71. package/snapshot/services/core/story-docs/components-overlay-atldrawer.json +59 -0
  72. package/snapshot/services/core/story-docs/components-overlay-atltoast.json +56 -0
  73. package/snapshot/services/core/story-docs/components-overlay-atltooltip.json +42 -0
  74. package/snapshot/services/core/story-docs/cookbook.json +39 -0
  75. package/snapshot/services/core/story-docs/showcase-all-components.json +17 -0
  76. package/snapshot/services/core/story-docs/showcase-kitchen-sink.json +17 -0
  77. package/src/instructions.mjs +29 -0
  78. package/src/knowledge.mjs +24 -0
  79. package/src/layer-composition.mjs +77 -0
  80. package/src/layer-purpose.mjs +70 -0
  81. package/src/layer-tokens.mjs +133 -0
  82. package/src/layers.mjs +80 -0
  83. package/src/manifest-provider.mjs +58 -0
  84. package/src/server.mjs +71 -0
  85. package/src/version-check.mjs +50 -0
  86. package/storybook/.atelier-inputs.json +1 -0
  87. package/storybook/angular-logo.jpg +0 -0
  88. package/storybook/artelier-logo.png +0 -0
  89. package/storybook/assets/Color-6AOWCN3U-BRruRKIt.js +1 -0
  90. package/storybook/assets/DocsRenderer-JROSPFPF-BqCGyKpa.js +10 -0
  91. package/storybook/assets/WithTooltip-CDUNV5IS-B5RANF3w.js +9 -0
  92. package/storybook/assets/_a11y-module-chunk-kh2BWFEb.js +20 -0
  93. package/storybook/assets/_array-chunk-jnVVFUvi.js +1 -0
  94. package/storybook/assets/_focus-key-manager-chunk-Czlxh_qX.js +1 -0
  95. package/storybook/assets/_focus-monitor-chunk-CHxlrCHn.js +1 -0
  96. package/storybook/assets/_id-generator-chunk-B9zuB3qN.js +1 -0
  97. package/storybook/assets/_list-key-manager-chunk-K-6zSVll.js +1 -0
  98. package/storybook/assets/_overlay-module-chunk-CwW5mIh4.js +140 -0
  99. package/storybook/assets/_style-loader-chunk-CjoWl1jk.js +1 -0
  100. package/storybook/assets/_unique-selection-dispatcher-chunk-Xqv9LIWR.js +1 -0
  101. package/storybook/assets/a11y-dev-warn-BbRozqAf.js +1 -0
  102. package/storybook/assets/angular-platform-ChS-QjTV.js +23 -0
  103. package/storybook/assets/async-CzUT0aHo.js +1 -0
  104. package/storybook/assets/atl-accordion-dZ-zVPC1.js +37 -0
  105. package/storybook/assets/atl-accordion.stories-CTKEKqfF.js +379 -0
  106. package/storybook/assets/atl-alert-BnnQXl74.js +18 -0
  107. package/storybook/assets/atl-alert.stories-WOsUlWre.js +88 -0
  108. package/storybook/assets/atl-avatar-NUYXSZhH.js +20 -0
  109. package/storybook/assets/atl-avatar.stories-GM0sQR9h.js +281 -0
  110. package/storybook/assets/atl-badge-BUEz7duN.js +6 -0
  111. package/storybook/assets/atl-badge.stories-BZ-58GLo.js +102 -0
  112. package/storybook/assets/atl-breadcrumbs-nQEvjjLz.js +22 -0
  113. package/storybook/assets/atl-breadcrumbs.stories-CFFrRRcs.js +161 -0
  114. package/storybook/assets/atl-button-BzQndwCt.js +6 -0
  115. package/storybook/assets/atl-button.stories-D8MwkQrM.js +138 -0
  116. package/storybook/assets/atl-card-WY9a7AGL.js +1 -0
  117. package/storybook/assets/atl-card.stories-DqUwE2Lw.js +195 -0
  118. package/storybook/assets/atl-chat.stories-BhfNwpcy.js +717 -0
  119. package/storybook/assets/atl-checkbox-C-oNMpz8.js +25 -0
  120. package/storybook/assets/atl-checkbox.stories-tfTegOD3.js +60 -0
  121. package/storybook/assets/atl-code-block-CWbd7cP-.js +34 -0
  122. package/storybook/assets/atl-code-block.stories-BPKM1keU.js +104 -0
  123. package/storybook/assets/atl-combobox.stories-DUHRpNOg.js +153 -0
  124. package/storybook/assets/atl-dialog-B2-2GVTo.js +27 -0
  125. package/storybook/assets/atl-dialog.stories-DGZaeKea.js +442 -0
  126. package/storybook/assets/atl-drawer-87lAgOgh.js +27 -0
  127. package/storybook/assets/atl-drawer.stories-Bo48zu1P.js +377 -0
  128. package/storybook/assets/atl-icon-ChO59f9V.js +16 -0
  129. package/storybook/assets/atl-icon.stories-D__7KUC6.js +114 -0
  130. package/storybook/assets/atl-input-CiyTZXDL.js +32 -0
  131. package/storybook/assets/atl-input.stories-CAorMMo9.js +95 -0
  132. package/storybook/assets/atl-menu-CyZvGLYl.js +6 -0
  133. package/storybook/assets/atl-menu.stories-DW8fQ-KN.js +168 -0
  134. package/storybook/assets/atl-option-o6FHvhn_.js +67 -0
  135. package/storybook/assets/atl-pagination-BFumZjwB.js +75 -0
  136. package/storybook/assets/atl-pagination.stories-hcbOcm5L.js +136 -0
  137. package/storybook/assets/atl-progress-CEvOvPrm.js +5 -0
  138. package/storybook/assets/atl-progress.stories-IPzUxTop.js +130 -0
  139. package/storybook/assets/atl-radio-C-KjJXL1.js +25 -0
  140. package/storybook/assets/atl-radio-group.stories-B-LXwjaI.js +135 -0
  141. package/storybook/assets/atl-radio.stories-BPeNuZ5i.js +70 -0
  142. package/storybook/assets/atl-select.stories-BlnLgKMb.js +133 -0
  143. package/storybook/assets/atl-showcase.stories-DEEN9_7E.js +563 -0
  144. package/storybook/assets/atl-skeleton-LlrKrRul.js +1 -0
  145. package/storybook/assets/atl-skeleton.stories-BjntxCgy.js +109 -0
  146. package/storybook/assets/atl-stepper.stories-TlX9iAtl.js +259 -0
  147. package/storybook/assets/atl-table-9yowirTt.js +71 -0
  148. package/storybook/assets/atl-table.stories-Da-Cdx4f.js +699 -0
  149. package/storybook/assets/atl-tabs-C3TYjTt4.js +34 -0
  150. package/storybook/assets/atl-tabs.stories-fnuIid_J.js +220 -0
  151. package/storybook/assets/atl-textarea-CaajGH3D.js +60 -0
  152. package/storybook/assets/atl-textarea.stories-BHLuood4.js +71 -0
  153. package/storybook/assets/atl-toast-C8wfEw8o.js +23 -0
  154. package/storybook/assets/atl-toast.stories-DuabFeLE.js +141 -0
  155. package/storybook/assets/atl-toggle-DufKJw7U.js +29 -0
  156. package/storybook/assets/atl-toggle.stories-C9TIh6EI.js +49 -0
  157. package/storybook/assets/atl-tooltip-DHtMg2_a.js +1 -0
  158. package/storybook/assets/atl-tooltip.stories-BtN7RqXO.js +126 -0
  159. package/storybook/assets/auditTime-D5qIDf8P.js +1 -0
  160. package/storybook/assets/axe-DB4aLaTh.js +20 -0
  161. package/storybook/assets/blocks-CwmsPXDF.js +192 -0
  162. package/storybook/assets/chunk-242VQQM5-D6GShWaB.js +1 -0
  163. package/storybook/assets/chunk-7PIQR4A3-BhwBlWeH.js +1 -0
  164. package/storybook/assets/chunk-DRQKCCAG-BwzuojA1.js +1 -0
  165. package/storybook/assets/chunk-IMSF75WX-CZt3_hro.js +6 -0
  166. package/storybook/assets/chunk-QQBDHPVZ-0u620C8G.js +1 -0
  167. package/storybook/assets/chunk-RDNWKK3U-DhgVKaEi.js +15 -0
  168. package/storybook/assets/chunk-UAWMPV5J-CVFtGjk9.js +1 -0
  169. package/storybook/assets/chunk-W22LQPXL-nedkz_O_.js +18 -0
  170. package/storybook/assets/colors-BtTAbCUR.js +34 -0
  171. package/storybook/assets/components-DUcVPgtb.js +92 -0
  172. package/storybook/assets/cookbook.stories-Cvcwdpgq.js +913 -0
  173. package/storybook/assets/debounceTime-CPR6CVzN.js +1 -0
  174. package/storybook/assets/dist-BfbfS1eq.js +28 -0
  175. package/storybook/assets/empty-C9s5w39U.js +1 -0
  176. package/storybook/assets/filter-CCMzlFeO.js +1 -0
  177. package/storybook/assets/formatter-L2YTDE3Q-De5wWUxX.js +1 -0
  178. package/storybook/assets/iframe-BYbOm3Rx.js +1 -0
  179. package/storybook/assets/iframe-BvjIbyPm.css +1 -0
  180. package/storybook/assets/iframe-h-GGOSFN.js +1131 -0
  181. package/storybook/assets/introduction-bzJGqrr1.js +51 -0
  182. package/storybook/assets/kitchen-sink.stories-DgdRp06g.js +155 -0
  183. package/storybook/assets/matchers-JIUQ3HVY-1Tc8fpol.js +28 -0
  184. package/storybook/assets/preload-helper-BLE838kL.js +1 -0
  185. package/storybook/assets/radio.metadata-D1zBdRKO.js +1 -0
  186. package/storybook/assets/react-CFS0r9Lk.js +1 -0
  187. package/storybook/assets/react-NI1vexfW.js +1 -0
  188. package/storybook/assets/rolldown-runtime-D_-wTCJc.js +1 -0
  189. package/storybook/assets/spacing-CVdkEC7L.js +23 -0
  190. package/storybook/assets/syntaxhighlighter-4REYKNEV-CaO5n5UG.js +6 -0
  191. package/storybook/assets/theming-6wiCKx_Z.js +39 -0
  192. package/storybook/assets/typography-B6Dotum2.js +49 -0
  193. package/storybook/favicon-wrapper.svg +46 -0
  194. package/storybook/favicon.svg +1 -0
  195. package/storybook/iframe.html +756 -0
  196. package/storybook/index.html +170 -0
  197. package/storybook/index.json +1 -0
  198. package/storybook/manifests/components.html +12595 -0
  199. package/storybook/manifests/components.json +355 -0
  200. package/storybook/manifests/docs.json +37 -0
  201. package/storybook/nunito-sans-bold-italic.woff2 +0 -0
  202. package/storybook/nunito-sans-bold.woff2 +0 -0
  203. package/storybook/nunito-sans-italic.woff2 +0 -0
  204. package/storybook/nunito-sans-regular.woff2 +0 -0
  205. package/storybook/package.json +32 -0
  206. package/storybook/project.json +1 -0
  207. package/storybook/react-logo.png +0 -0
  208. package/storybook/sb-addons/a11y-2/manager-bundle.js +57 -0
  209. package/storybook/sb-addons/designs-3/register-panel-bundle.js +1009 -0
  210. package/storybook/sb-addons/designs-3/register-panel-bundle.js.LEGAL.txt +8 -0
  211. package/storybook/sb-addons/docs-4/manager-bundle.js +18 -0
  212. package/storybook/sb-addons/libs-angular-storybook-6/manager-bundle.js +3 -0
  213. package/storybook/sb-addons/storybook-core-server-presets-0/common-manager-bundle.js +632 -0
  214. package/storybook/sb-addons/themes-5/manager-bundle.js +3 -0
  215. package/storybook/sb-addons/vitest-1/manager-bundle.js +3 -0
  216. package/storybook/sb-common-assets/favicon-wrapper.svg +46 -0
  217. package/storybook/sb-common-assets/favicon.svg +1 -0
  218. package/storybook/sb-common-assets/nunito-sans-bold-italic.woff2 +0 -0
  219. package/storybook/sb-common-assets/nunito-sans-bold.woff2 +0 -0
  220. package/storybook/sb-common-assets/nunito-sans-italic.woff2 +0 -0
  221. package/storybook/sb-common-assets/nunito-sans-regular.woff2 +0 -0
  222. package/storybook/sb-manager/globals-runtime.js +79132 -0
  223. package/storybook/sb-manager/globals.js +24 -0
  224. package/storybook/sb-manager/manager-stores.js +23 -0
  225. package/storybook/sb-manager/runtime.js +28317 -0
  226. package/storybook/services/addon-docs/mdx/foundation-colors--docs.json +18 -0
  227. package/storybook/services/addon-docs/mdx/foundation-spacing--docs.json +18 -0
  228. package/storybook/services/addon-docs/mdx/foundation-typography--docs.json +18 -0
  229. package/storybook/services/addon-docs/mdx/introduction--docs.json +18 -0
  230. package/storybook/services/core/docgen/components-ai-atlchat.json +158 -0
  231. package/storybook/services/core/docgen/components-display-atlavatar.json +144 -0
  232. package/storybook/services/core/docgen/components-display-atlbadge.json +97 -0
  233. package/storybook/services/core/docgen/components-display-atlcard.json +103 -0
  234. package/storybook/services/core/docgen/components-display-atlcodeblock.json +165 -0
  235. package/storybook/services/core/docgen/components-display-atlicon.json +172 -0
  236. package/storybook/services/core/docgen/components-display-atlprogress.json +177 -0
  237. package/storybook/services/core/docgen/components-display-atlskeleton.json +125 -0
  238. package/storybook/services/core/docgen/components-display-atltable.json +100 -0
  239. package/storybook/services/core/docgen/components-feedback-atlaccordiongroup.json +105 -0
  240. package/storybook/services/core/docgen/components-feedback-atlalert.json +124 -0
  241. package/storybook/services/core/docgen/components-inputs-atlbutton.json +153 -0
  242. package/storybook/services/core/docgen/components-inputs-atlcheckbox.json +226 -0
  243. package/storybook/services/core/docgen/components-inputs-atlcombobox.json +244 -0
  244. package/storybook/services/core/docgen/components-inputs-atlinput.json +302 -0
  245. package/storybook/services/core/docgen/components-inputs-atlradio.json +114 -0
  246. package/storybook/services/core/docgen/components-inputs-atlradiogroup.json +243 -0
  247. package/storybook/services/core/docgen/components-inputs-atlselect.json +257 -0
  248. package/storybook/services/core/docgen/components-inputs-atltextarea.json +311 -0
  249. package/storybook/services/core/docgen/components-inputs-atltoggle.json +209 -0
  250. package/storybook/services/core/docgen/components-navigation-atlbreadcrumbs.json +55 -0
  251. package/storybook/services/core/docgen/components-navigation-atlmenu.json +45 -0
  252. package/storybook/services/core/docgen/components-navigation-atlpagination.json +193 -0
  253. package/storybook/services/core/docgen/components-navigation-atlstepper.json +156 -0
  254. package/storybook/services/core/docgen/components-navigation-atltabgroup.json +79 -0
  255. package/storybook/services/core/docgen/components-overlay-atldialog.json +216 -0
  256. package/storybook/services/core/docgen/components-overlay-atldrawer.json +190 -0
  257. package/storybook/services/core/docgen/components-overlay-atltoast.json +145 -0
  258. package/storybook/services/core/docgen/components-overlay-atltooltip.json +128 -0
  259. package/storybook/services/core/docgen/cookbook.json +3 -0
  260. package/storybook/services/core/docgen/showcase-all-components.json +191 -0
  261. package/storybook/services/core/docgen/showcase-kitchen-sink.json +20 -0
  262. package/storybook/services/core/story-docs/components-ai-atlchat.json +73 -0
  263. package/storybook/services/core/story-docs/components-display-atlavatar.json +61 -0
  264. package/storybook/services/core/story-docs/components-display-atlbadge.json +61 -0
  265. package/storybook/services/core/story-docs/components-display-atlcard.json +61 -0
  266. package/storybook/services/core/story-docs/components-display-atlcodeblock.json +41 -0
  267. package/storybook/services/core/story-docs/components-display-atlicon.json +52 -0
  268. package/storybook/services/core/story-docs/components-display-atlprogress.json +41 -0
  269. package/storybook/services/core/story-docs/components-display-atlskeleton.json +46 -0
  270. package/storybook/services/core/story-docs/components-display-atltable.json +65 -0
  271. package/storybook/services/core/story-docs/components-feedback-atlaccordiongroup.json +56 -0
  272. package/storybook/services/core/story-docs/components-feedback-atlalert.json +51 -0
  273. package/storybook/services/core/story-docs/components-inputs-atlbutton.json +76 -0
  274. package/storybook/services/core/story-docs/components-inputs-atlcheckbox.json +57 -0
  275. package/storybook/services/core/story-docs/components-inputs-atlcombobox.json +41 -0
  276. package/storybook/services/core/story-docs/components-inputs-atlinput.json +70 -0
  277. package/storybook/services/core/story-docs/components-inputs-atlradio.json +35 -0
  278. package/storybook/services/core/story-docs/components-inputs-atlradiogroup.json +59 -0
  279. package/storybook/services/core/story-docs/components-inputs-atlselect.json +65 -0
  280. package/storybook/services/core/story-docs/components-inputs-atltextarea.json +65 -0
  281. package/storybook/services/core/story-docs/components-inputs-atltoggle.json +52 -0
  282. package/storybook/services/core/story-docs/components-navigation-atlbreadcrumbs.json +37 -0
  283. package/storybook/services/core/story-docs/components-navigation-atlmenu.json +37 -0
  284. package/storybook/services/core/story-docs/components-navigation-atlpagination.json +41 -0
  285. package/storybook/services/core/story-docs/components-navigation-atlstepper.json +37 -0
  286. package/storybook/services/core/story-docs/components-navigation-atltabgroup.json +47 -0
  287. package/storybook/services/core/story-docs/components-overlay-atldialog.json +59 -0
  288. package/storybook/services/core/story-docs/components-overlay-atldrawer.json +59 -0
  289. package/storybook/services/core/story-docs/components-overlay-atltoast.json +56 -0
  290. package/storybook/services/core/story-docs/components-overlay-atltooltip.json +42 -0
  291. package/storybook/services/core/story-docs/cookbook.json +39 -0
  292. package/storybook/services/core/story-docs/showcase-all-components.json +17 -0
  293. package/storybook/services/core/story-docs/showcase-kitchen-sink.json +17 -0
  294. package/storybook/vite-inject-mocker-entry.js +2 -0
  295. package/storybook/vue-logo.jpeg +0 -0
package/README.md CHANGED
@@ -1,3 +1,26 @@
1
- # Temporary Holding Version
1
+ # @atelier-ui/mcp
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ MCP server for consumers of `@atelier-ui/angular` (ADR-0177). It answers `docs-list`, `docs-show`
4
+ and `docs-show-story` over stdio from a Storybook manifest snapshot built from the same commit as
5
+ the library. No network, no port.
6
+
7
+ ```json
8
+ { "mcpServers": { "atelier": { "command": "npx", "args": ["atelier-mcp"] } } }
9
+ ```
10
+
11
+ - **Version check.** At start the server compares the `@atelier-ui/angular` installed in its
12
+ working directory with its own version and warns in the `instructions` and on stderr on a
13
+ mismatch. It never aborts.
14
+ - **Layers.** `ATELIER_MCP_LAYERS` (comma list of ids, unset = all) switches knowledge layers on
15
+ and off for ablation runs; see `src/layers.mjs`. Ids: `api` (L0), `purpose` (L1), `tokens` (L2), `composition` (L5). An unknown id is an error.
16
+ `ATELIER_MCP_VERSION_CHECK=off` disables the version note for the evaluation lab.
17
+ - **Snapshot.** `snapshot/` is generated (`npm run build`, also run by `prepack`) from
18
+ `dist/storybook/angular`; build that first with `npx nx build-storybook angular`. It is not
19
+ committed.
20
+ - **Gate.** `npm run check:mcp-package` runs the unit tests and `scripts/smoke-test.mjs`, which
21
+ packs the tarball and talks to the unpacked bin over stdio, offline.
22
+ - **Static Storybook.** The tarball also ships the library's static Angular Storybook under
23
+ `storybook/` (copied from `dist/storybook/angular` by `prepack`, not committed). Its assets use
24
+ relative URLs, so it can be mounted at a sub-path of your own Storybook:
25
+ `staticDirs: [{ from: '<path to @atelier-ui/mcp>/storybook', to: '/atelier' }]`, then open
26
+ `/atelier/index.html`.
@@ -0,0 +1,9 @@
1
+ #!/usr/bin/env node
2
+ // Thin entry point for the `atelier-mcp` bin. The server itself lives in src/server.mjs so it
3
+ // can be imported and tested without spawning a child process.
4
+ import { startServer } from '../src/server.mjs';
5
+
6
+ startServer().catch((err) => {
7
+ console.error('[atelier-mcp] failed to start:', err);
8
+ process.exitCode = 1;
9
+ });
package/package.json CHANGED
@@ -1,6 +1,47 @@
1
1
  {
2
2
  "name": "@atelier-ui/mcp",
3
- "version": "0.0.0-stage",
4
- "stub": true,
5
- "description": "Temporary package placeholder for staged publishing"
6
- }
3
+ "version": "0.4.12",
4
+ "description": "MCP server for consumers of @atelier-ui/angular: answers docs-list, docs-show and docs-show-story over stdio from a manifest snapshot built from the same commit, with no network access.",
5
+ "license": "MIT",
6
+ "repository": {
7
+ "type": "git",
8
+ "url": "https://github.com/DominikPieper/atelier-ui.git",
9
+ "directory": "libs/mcp"
10
+ },
11
+ "type": "module",
12
+ "bin": {
13
+ "atelier-mcp": "bin/atelier-mcp.mjs"
14
+ },
15
+ "files": [
16
+ "bin",
17
+ "src",
18
+ "snapshot",
19
+ "storybook",
20
+ "README.md"
21
+ ],
22
+ "engines": {
23
+ "node": ">=22.12.0"
24
+ },
25
+ "dependencies": {
26
+ "@storybook/mcp": "10.6.0",
27
+ "@tmcp/adapter-valibot": "^0.1.5",
28
+ "@tmcp/transport-stdio": "0.5.0",
29
+ "tmcp": "^1.19.4",
30
+ "valibot": "^1.4.0"
31
+ },
32
+ "scripts": {
33
+ "build": "node scripts/build-snapshot.mjs",
34
+ "prepack": "node scripts/prepack.mjs",
35
+ "test": "node --test test/*.test.mjs",
36
+ "test:smoke": "node scripts/smoke-test.mjs"
37
+ },
38
+ "keywords": [
39
+ "mcp",
40
+ "mcp-server",
41
+ "model-context-protocol",
42
+ "design-system",
43
+ "atelier-ui",
44
+ "angular",
45
+ "storybook"
46
+ ]
47
+ }
@@ -0,0 +1 @@
1
+ {"AtlAccordionGroup":{"whenToUse":["Compressing a long FAQ or help page so the user scans titles first and expands only what is relevant.","Grouping optional or advanced settings beneath labelled sections in a settings or preferences view.","Splitting a long-form document into reviewable sections (terms, policy, changelog) without forcing a scroll.","Collapsing supplementary detail inside a card, drawer, or sidebar where vertical space is tight."],"whenNotToUse":[{"statement":"Switching between sibling views of the same parent context.","useInstead":"AtlTabs — tabs swap one panel at a time and are the right primitive for peer views."},{"statement":"Presenting a linear ordered workflow as collapsible sections.","useInstead":"AtlStepper — steppers communicate progress and ordering, accordions do not."},{"statement":"Building a tree of nested categories the user can drill into.","useInstead":"A dedicated tree component with `role=\"tree\"` and proper expanded-state semantics."}],"related":["AtlStepper","AtlTabGroup"]},"AtlAccordionItem":{"whenToUse":["Compressing a long FAQ or help page so the user scans titles first and expands only what is relevant.","Grouping optional or advanced settings beneath labelled sections in a settings or preferences view.","Splitting a long-form document into reviewable sections (terms, policy, changelog) without forcing a scroll.","Collapsing supplementary detail inside a card, drawer, or sidebar where vertical space is tight."],"whenNotToUse":[{"statement":"Switching between sibling views of the same parent context.","useInstead":"AtlTabs — tabs swap one panel at a time and are the right primitive for peer views."},{"statement":"Presenting a linear ordered workflow as collapsible sections.","useInstead":"AtlStepper — steppers communicate progress and ordering, accordions do not."},{"statement":"Building a tree of nested categories the user can drill into.","useInstead":"A dedicated tree component with `role=\"tree\"` and proper expanded-state semantics."}],"related":["AtlStepper","AtlTabGroup"]},"AtlAlert":{"whenToUse":["Surfacing a result after a form submit (saved, failed, partial success) above or below the form.","Warning the user about a consequence of a destructive action before they confirm.","Communicating a system-level notice that should stay visible until acknowledged (`dismissible: true`).","Highlighting a tip or note inside documentation or a settings panel."],"whenNotToUse":[{"statement":"Tagging an item with a short status word next to other content.","useInstead":"AtlBadge — badges are inline labels, alerts are block-level messages with a role."},{"statement":"Showing a transient confirmation that disappears on its own.","useInstead":"A toast/snackbar component — alerts stay in the layout until dismissed or unmounted."},{"statement":"Blocking the page to demand a decision.","useInstead":"AtlDialog — modal dialogs interrupt; alerts coexist with the surrounding content."}],"related":["AtlBadge","AtlDialog"]},"AtlAvatar":{"whenToUse":["Showing the author of a message, comment, or activity entry in a list.","Identifying the signed-in user in a header or account menu.","Stacking participants of a thread, room, or shared document via AvatarGroup with a +N overflow.","Surfacing a presence indicator next to a name in a roster or sidebar."],"whenNotToUse":[{"statement":"Displaying a decorative product image or thumbnail.","useInstead":"A plain `<img>` or a media component — avatars carry identity semantics and initial fallbacks."},{"statement":"Communicating standalone status without an identity (system online, build healthy).","useInstead":"AtlBadge — badges are the right primitive for status pills that do not belong to a person."}],"related":["AtlBadge","AtlMenu"]},"AtlAvatarGroup":{"whenToUse":["Showing the author of a message, comment, or activity entry in a list.","Identifying the signed-in user in a header or account menu.","Stacking participants of a thread, room, or shared document via AvatarGroup with a +N overflow.","Surfacing a presence indicator next to a name in a roster or sidebar."],"whenNotToUse":[{"statement":"Displaying a decorative product image or thumbnail.","useInstead":"A plain `<img>` or a media component — avatars carry identity semantics and initial fallbacks."},{"statement":"Communicating standalone status without an identity (system online, build healthy).","useInstead":"AtlBadge — badges are the right primitive for status pills that do not belong to a person."}],"related":["AtlBadge","AtlMenu"]},"AtlBadge":{"whenToUse":["Marking the status of a row or card (active, pending, error) next to its title.","Showing a numeric count attached to a navigation item (unread, queued, total).","Tagging a list entry with a short category or version label.","Annotating a heading or button with a \"new\" / \"beta\" marker."],"whenNotToUse":[{"statement":"Surfacing a dismissable system-level message.","useInstead":"AtlAlert — alerts carry a role and live region, badges do not."},{"statement":"Holding a removable user-entered chip (filter, recipient).","useInstead":"There is no chip component; build one from AtlButton: one small outline button (variant outline, size sm) holding the label and an aria-hidden × glyph, with an aria-label that names what it removes (e.g. \"Remove filter: <label>\") and a click handler that removes the item. Wrap a group of them in a container with an accessible label (role=\"group\" plus aria-label)."}],"related":["AtlAlert","AtlAvatar","AtlButton"]},"AtlBreadcrumbs":{"whenToUse":["Surfacing the position of a deep page inside a multi-level information architecture (settings, docs, file trees).","Letting users navigate one or several levels back without relying on the browser back button.","Reinforcing where a detail view sits relative to its parent list."],"whenNotToUse":[{"statement":"Switching between sibling sections of a flat app.","useInstead":"AtlTabs — tabs communicate peer relationships, breadcrumbs communicate depth."},{"statement":"Stepping through an ordered flow (wizard, checkout).","useInstead":"A dedicated stepper component — steps imply forward/backward progress, not nested location."}],"related":["AtlMenu","AtlTabGroup"]},"AtlBreadcrumbItem":{"whenToUse":["Surfacing the position of a deep page inside a multi-level information architecture (settings, docs, file trees).","Letting users navigate one or several levels back without relying on the browser back button.","Reinforcing where a detail view sits relative to its parent list."],"whenNotToUse":[{"statement":"Switching between sibling sections of a flat app.","useInstead":"AtlTabs — tabs communicate peer relationships, breadcrumbs communicate depth."},{"statement":"Stepping through an ordered flow (wizard, checkout).","useInstead":"A dedicated stepper component — steps imply forward/backward progress, not nested location."}],"related":["AtlMenu","AtlTabGroup"]},"AtlButton":{"whenToUse":["Initiating an action that changes state on the current page (submit, save, delete, open).","Triggering navigation in flows where a button is more semantically correct than a link.","Surfacing the primary call-to-action in a form, dialog, or empty state."],"whenNotToUse":[{"statement":"Navigating to a new URL where the destination is the meaning of the interaction.","useInstead":"A plain `<a>` link — links say \"go somewhere\", buttons say \"do something\"."},{"statement":"Toggling a binary on/off state.","useInstead":"AtlToggle — communicates the persistent state to assistive tech."},{"statement":"Selecting an option from a list.","useInstead":"AtlSelect, AtlCombobox, or AtlRadioGroup, depending on cardinality and search needs."}],"related":["AtlDialog","AtlMenu","AtlToggle"]},"AtlCard":{"whenToUse":["Wrapping a self-contained piece of content (a post, a stat, a settings panel) so it reads as one unit.","Building a grid or list of comparable items — products, plans, dashboard tiles.","Separating a form section or summary panel from surrounding page chrome.","Highlighting a feature, callout, or empty-state block within a larger view."],"whenNotToUse":[{"statement":"Showing a dismissable system message inside a card.","useInstead":"AtlAlert — alerts carry the right role and live-region semantics for transient messages."},{"statement":"Using a card as a modal container layered over the page.","useInstead":"AtlDialog — dialogs handle focus trapping, scrim, and dismiss behaviour."},{"statement":"Adding `role=\"article\"` to every card by default to look more semantic.","useInstead":"Leave `role` unset for visual grouping; only set it when the card is a real landmark in the page outline."}],"related":["AtlAlert","AtlDialog"]},"AtlChat":{"whenToUse":["Embedding an assistant alongside the current page as a side drawer that does not displace the workspace.","Offering a focused, modal-like popup chat anchored to a launcher button.","Composing a chat inline inside a larger layout (a docs page, a settings panel).","Reflecting in-flight assistant work via `status=\"streaming\"` and surfacing failures via `status=\"error\"`."],"whenNotToUse":[{"statement":"Confirming or asking the user for a single decision.","useInstead":"AtlDialog — short-lived, focused, with explicit confirm/cancel actions."},{"statement":"Showing transient system notifications.","useInstead":"AtlToast — notifications are unidirectional and ephemeral, chat is a two-way log."}],"related":["AtlDialog","AtlDrawer","AtlTextarea"]},"AtlCheckbox":{"whenToUse":["Opting into a single boolean choice (terms accepted, remember me, subscribe).","Selecting zero or more items from a list — each row is its own checkbox.","Driving a \"select all\" header that flips to indeterminate when only some children are checked."],"whenNotToUse":[{"statement":"Switching a setting on/off where the change applies immediately.","useInstead":"AtlToggle — communicates the \"switch\" affordance and instant effect to assistive tech."},{"statement":"Picking exactly one option from a small set.","useInstead":"AtlRadioGroup — radios enforce single-select and announce the group."}],"related":["AtlRadioGroup","AtlRadio","AtlToggle"]},"AtlCombobox":{"whenToUse":["Picking one value from a list long enough that scrolling beats scanning (countries, currencies, users).","Letting the user type a few characters to filter options instead of opening every group.","Driving an autocomplete where the available values are known upfront, not free text."],"whenNotToUse":[{"statement":"Accepting any freeform string the user types.","useInstead":"AtlInput — combobox commits to a value from the option list."},{"statement":"Picking from a list short enough to fit a native dropdown.","useInstead":"AtlSelect — no search overhead, inherits native mobile UI."},{"statement":"Selecting many values at once.","useInstead":"A multi-select combobox (not in this spec) or a list of AtlCheckbox rows."}],"related":["AtlInput","AtlSelect"]},"AtlDialog":{"whenToUse":["Confirming a destructive action (delete, discard, sign out) before it commits.","Hosting a short focused task — edit a row, pick a date, complete a one-step form — without navigating away.","Showing detail content (preview, full-size image, expanded record) on top of the current view.","Asking for a decision that must be answered before the user can continue with the underlying flow."],"whenNotToUse":[{"statement":"Showing a transient, non-blocking system message.","useInstead":"AtlToast or AtlAlert — neither demands focus or blocks interaction."},{"statement":"Sliding in a side panel for secondary navigation or filters.","useInstead":"AtlDrawer — drawers anchor to an edge and are the right primitive for persistent side surfaces."},{"statement":"Hosting a long, multi-step workflow that needs its own URL and history.","useInstead":"A dedicated route or wizard page — dialogs should not own deep flows the user might want to share or refresh."}],"related":["AtlAlert","AtlButton","AtlDrawer"]},"AtlDrawer":{"whenToUse":["Surfacing primary navigation on narrow viewports where a persistent sidebar does not fit.","Exposing filters, settings, or facets that the user toggles on and off while scanning a list.","Inspecting a record or row in a detail panel without losing the surrounding list context.","Presenting a longer task or form that benefits from screen-edge anchoring rather than a centred modal."],"whenNotToUse":[{"statement":"Blocking the page for a short confirmation or single-decision prompt.","useInstead":"AtlDialog — dialogs are centred, scoped, and the right primitive for one focused decision."},{"statement":"Showing a transient notification that should not require dismissal.","useInstead":"AtlToast — toasts auto-dismiss and do not anchor to a screen edge."},{"statement":"Building a dropdown menu attached to a trigger button.","useInstead":"AtlMenu — menus position relative to the trigger and use roving focus, not focus trapping."}],"related":["AtlDialog","AtlMenu"]},"AtlIcon":{"whenToUse":["Reinforcing the meaning of a button or menu item with a recognisable glyph.","Carrying status meaning inside a badge, alert, or toast (success, warning, danger, info).","Indicating direction or affordance (chevrons for disclosure, arrows for navigation, sort markers in headers).","Standing alone as a meaningful symbol — in which case `label` is required so assistive tech can announce it."],"whenNotToUse":[{"statement":"Rendering a user avatar or product image.","useInstead":"AtlAvatar or a plain `<img>` — icons are abstract glyphs, not raster content."},{"statement":"Conveying status without an adjacent label and without setting `label`.","useInstead":"Pair the icon with visible text or pass `label` — decorative icons are hidden from screen readers."}],"related":["AtlAlert","AtlBadge","AtlButton"]},"AtlInput":{"whenToUse":["Collecting a short freeform string — name, title, search query.","Capturing a typed value (email, password, number, tel, url) where the browser keyboard hint matters.","Driving a typeahead or filter where the user types and the page reacts on each change."],"whenNotToUse":[{"statement":"Accepting multi-line prose, descriptions, or comments.","useInstead":"AtlTextarea — sized for wrapping text with an optional auto-resize."},{"statement":"Picking one option from a known list.","useInstead":"AtlSelect for short lists, AtlCombobox when the list is long enough to need search."},{"statement":"Toggling a boolean.","useInstead":"AtlCheckbox or AtlToggle — both encode the binary state for assistive tech."}],"related":["AtlCombobox","AtlSelect","AtlTextarea"]},"AtlMenu":{"whenToUse":["Grouping secondary or contextual row actions (edit, duplicate, archive, delete) behind a single trigger.","Offering an account or user menu attached to an avatar in the header.","Surfacing an overflow set of toolbar actions that do not fit inline.","Showing a right-click or long-press context menu scoped to a specific element."],"whenNotToUse":[{"statement":"Letting the user pick a value to fill a form field.","useInstead":"AtlSelect or AtlCombobox — those carry the right form-control semantics and value state."},{"statement":"Hosting site-level navigation links.","useInstead":"A real nav with `<a>` links — menus are for actions, navigation is for changing location."},{"statement":"Anchoring a persistent side panel of filters or controls.","useInstead":"AtlDrawer — drawers stay open and anchor to a screen edge; menus are transient."}],"related":["AtlButton","AtlDrawer","AtlSelect"]},"AtlMenuItem":{"whenToUse":["Grouping secondary or contextual row actions (edit, duplicate, archive, delete) behind a single trigger.","Offering an account or user menu attached to an avatar in the header.","Surfacing an overflow set of toolbar actions that do not fit inline.","Showing a right-click or long-press context menu scoped to a specific element."],"whenNotToUse":[{"statement":"Letting the user pick a value to fill a form field.","useInstead":"AtlSelect or AtlCombobox — those carry the right form-control semantics and value state."},{"statement":"Hosting site-level navigation links.","useInstead":"A real nav with `<a>` links — menus are for actions, navigation is for changing location."},{"statement":"Anchoring a persistent side panel of filters or controls.","useInstead":"AtlDrawer — drawers stay open and anchor to a screen edge; menus are transient."}],"related":["AtlButton","AtlDrawer","AtlSelect"]},"AtlPagination":{"whenToUse":["Splitting a long list or table into fixed-size pages where the total count is known.","Letting users jump directly to a specific page rather than scrolling.","Surfacing position within a result set (current page out of total)."],"whenNotToUse":[{"statement":"Loading more rows continuously as the user scrolls.","useInstead":"An infinite-scroll pattern with a sentinel — pagination implies discrete, addressable pages."},{"statement":"Stepping through a fixed multi-step flow.","useInstead":"A stepper — steps represent ordered stages, not interchangeable pages of data."}],"related":["AtlButton","AtlTable"]},"AtlProgress":{"whenToUse":["Reporting upload, download, or file-processing progress where bytes or items completed are known.","Showing form completion across multiple steps as a percentage.","Indicating an in-flight background operation with `indeterminate` when the total is unknown.","Visualising quota or capacity usage against a maximum."],"whenNotToUse":[{"statement":"Reserving the layout slot for content that has not loaded yet.","useInstead":"AtlSkeleton — sized to the missing content, not a generic bar."},{"statement":"Acknowledging a momentary action (saved, copied).","useInstead":"AtlToast — transient confirmation belongs in a live region, not a progress bar."}],"related":["AtlSkeleton","AtlToast"]},"AtlRadio":{"whenToUse":["Picking exactly one option from a short, visible list (2–7 items).","Choosing a plan, size, or shipping method where seeing every option side by side matters.","Selecting one variant from a set inside a form where the choices stay on screen."],"whenNotToUse":[{"statement":"Picking one option from a long list that would dominate the layout.","useInstead":"AtlSelect, or AtlCombobox once the list needs search."},{"statement":"Allowing zero or more selections.","useInstead":"AtlCheckbox — one per option, no single-select constraint."},{"statement":"Flipping a single boolean.","useInstead":"AtlCheckbox or AtlToggle — a one-option radio group is never the right shape."}],"related":["AtlCheckbox","AtlCombobox","AtlSelect"]},"AtlRadioGroup":{"whenToUse":["Picking exactly one option from a short, visible list (2–7 items).","Choosing a plan, size, or shipping method where seeing every option side by side matters.","Selecting one variant from a set inside a form where the choices stay on screen."],"whenNotToUse":[{"statement":"Picking one option from a long list that would dominate the layout.","useInstead":"AtlSelect, or AtlCombobox once the list needs search."},{"statement":"Allowing zero or more selections.","useInstead":"AtlCheckbox — one per option, no single-select constraint."},{"statement":"Flipping a single boolean.","useInstead":"AtlCheckbox or AtlToggle — a one-option radio group is never the right shape."}],"related":["AtlCheckbox","AtlCombobox","AtlSelect"]},"AtlSelect":{"whenToUse":["Choosing one value from a known list of 7 or more items where radios would crowd the layout.","Capturing a structured choice (country, currency, language) inside a form.","Rendering a compact picker where the options are plain labels. In React and Vue the native `<select>` also brings the platform picker on mobile."],"whenNotToUse":[{"statement":"Picking from a list long enough that scanning becomes painful.","useInstead":"AtlCombobox — adds typeahead search over the same options."},{"statement":"Showing every option inline so users can compare them.","useInstead":"AtlRadioGroup — keeps the choices visible without an open/close step."},{"statement":"Triggering navigation when an option is picked.","useInstead":"A menu of links — a select implies a form value, not a route change."}],"related":["AtlCombobox","AtlRadioGroup"]},"AtlOption":{"whenToUse":["Choosing one value from a known list of 7 or more items where radios would crowd the layout.","Capturing a structured choice (country, currency, language) inside a form.","Rendering a compact picker where the options are plain labels. In React and Vue the native `<select>` also brings the platform picker on mobile."],"whenNotToUse":[{"statement":"Picking from a list long enough that scanning becomes painful.","useInstead":"AtlCombobox — adds typeahead search over the same options."},{"statement":"Showing every option inline so users can compare them.","useInstead":"AtlRadioGroup — keeps the choices visible without an open/close step."},{"statement":"Triggering navigation when an option is picked.","useInstead":"A menu of links — a select implies a form value, not a route change."}],"related":["AtlCombobox","AtlRadioGroup"]},"AtlSkeleton":{"whenToUse":["Filling the slot where a chunk of fetched data — card body, table row, avatar — will land, so the layout does not jump on arrival.","Standing in for a single line of text while a label or value loads.","Reserving the footprint of an image or media thumbnail during async load."],"whenNotToUse":[{"statement":"Communicating an indeterminate background operation with no associated content slot.","useInstead":"AtlProgress with `indeterminate` — has the right role and announces progress."},{"statement":"Holding empty space when there is genuinely nothing to render.","useInstead":"An empty state with explanation; skeletons promise content that is coming."}],"related":["AtlAvatar","AtlProgress"]},"AtlStepper":{"whenToUse":["Walking the user through a checkout, signup, or onboarding flow split across pages.","Showing progress through a fixed sequence of tasks where the user can see what comes next.","Enforcing order with `linear: true` so a later step cannot be jumped to until every earlier step is completed or optional (optional steps can be passed)."],"whenNotToUse":[{"statement":"Navigating between sibling sections that have no inherent order.","useInstead":"AtlTabGroup — tabs imply parallel views, steppers imply progression."},{"statement":"Reporting a single percentage or determinate loading state.","useInstead":"A progress bar — steppers communicate discrete stages, not continuous progress."},{"statement":"Collapsing and expanding sections of a form on one page.","useInstead":"AtlAccordionGroup — accordions are spatial, steppers are sequential."}],"related":["AtlAccordionGroup","AtlTabGroup"]},"AtlStep":{"whenToUse":["Walking the user through a checkout, signup, or onboarding flow split across pages.","Showing progress through a fixed sequence of tasks where the user can see what comes next.","Enforcing order with `linear: true` so a later step cannot be jumped to until every earlier step is completed or optional (optional steps can be passed)."],"whenNotToUse":[{"statement":"Navigating between sibling sections that have no inherent order.","useInstead":"AtlTabGroup — tabs imply parallel views, steppers imply progression."},{"statement":"Reporting a single percentage or determinate loading state.","useInstead":"A progress bar — steppers communicate discrete stages, not continuous progress."},{"statement":"Collapsing and expanding sections of a form on one page.","useInstead":"AtlAccordionGroup — accordions are spatial, steppers are sequential."}],"related":["AtlAccordionGroup","AtlTabGroup"]},"AtlTable":{"whenToUse":["Displaying a list of records where each record has the same set of comparable fields.","Surfacing data users need to scan across rows or columns (totals, status, timestamps).","Wrapping a sortable column set where header clicks reorder rows.","Showing data dense enough to benefit from a sticky header while scrolling."],"whenNotToUse":[{"statement":"Laying out two-dimensional UI that is not actually tabular data (cards in a grid).","useInstead":"A CSS grid layout — `<table>` semantics confuse assistive tech when there is no row/column meaning."},{"statement":"Rendering a single record with field/value pairs.","useInstead":"A description list or a labelled key/value layout — tables imply multiple comparable rows."},{"statement":"Picking one option from a list.","useInstead":"AtlSelect, AtlCombobox, or AtlRadioGroup depending on cardinality."}],"related":["AtlBadge","AtlCheckbox","AtlPagination"]},"AtlTbody":{"whenToUse":["Displaying a list of records where each record has the same set of comparable fields.","Surfacing data users need to scan across rows or columns (totals, status, timestamps).","Wrapping a sortable column set where header clicks reorder rows.","Showing data dense enough to benefit from a sticky header while scrolling."],"whenNotToUse":[{"statement":"Laying out two-dimensional UI that is not actually tabular data (cards in a grid).","useInstead":"A CSS grid layout — `<table>` semantics confuse assistive tech when there is no row/column meaning."},{"statement":"Rendering a single record with field/value pairs.","useInstead":"A description list or a labelled key/value layout — tables imply multiple comparable rows."},{"statement":"Picking one option from a list.","useInstead":"AtlSelect, AtlCombobox, or AtlRadioGroup depending on cardinality."}],"related":["AtlBadge","AtlCheckbox","AtlPagination"]},"AtlTr":{"whenToUse":["Displaying a list of records where each record has the same set of comparable fields.","Surfacing data users need to scan across rows or columns (totals, status, timestamps).","Wrapping a sortable column set where header clicks reorder rows.","Showing data dense enough to benefit from a sticky header while scrolling."],"whenNotToUse":[{"statement":"Laying out two-dimensional UI that is not actually tabular data (cards in a grid).","useInstead":"A CSS grid layout — `<table>` semantics confuse assistive tech when there is no row/column meaning."},{"statement":"Rendering a single record with field/value pairs.","useInstead":"A description list or a labelled key/value layout — tables imply multiple comparable rows."},{"statement":"Picking one option from a list.","useInstead":"AtlSelect, AtlCombobox, or AtlRadioGroup depending on cardinality."}],"related":["AtlBadge","AtlCheckbox","AtlPagination"]},"AtlTh":{"whenToUse":["Displaying a list of records where each record has the same set of comparable fields.","Surfacing data users need to scan across rows or columns (totals, status, timestamps).","Wrapping a sortable column set where header clicks reorder rows.","Showing data dense enough to benefit from a sticky header while scrolling."],"whenNotToUse":[{"statement":"Laying out two-dimensional UI that is not actually tabular data (cards in a grid).","useInstead":"A CSS grid layout — `<table>` semantics confuse assistive tech when there is no row/column meaning."},{"statement":"Rendering a single record with field/value pairs.","useInstead":"A description list or a labelled key/value layout — tables imply multiple comparable rows."},{"statement":"Picking one option from a list.","useInstead":"AtlSelect, AtlCombobox, or AtlRadioGroup depending on cardinality."}],"related":["AtlBadge","AtlCheckbox","AtlPagination"]},"AtlTd":{"whenToUse":["Displaying a list of records where each record has the same set of comparable fields.","Surfacing data users need to scan across rows or columns (totals, status, timestamps).","Wrapping a sortable column set where header clicks reorder rows.","Showing data dense enough to benefit from a sticky header while scrolling."],"whenNotToUse":[{"statement":"Laying out two-dimensional UI that is not actually tabular data (cards in a grid).","useInstead":"A CSS grid layout — `<table>` semantics confuse assistive tech when there is no row/column meaning."},{"statement":"Rendering a single record with field/value pairs.","useInstead":"A description list or a labelled key/value layout — tables imply multiple comparable rows."},{"statement":"Picking one option from a list.","useInstead":"AtlSelect, AtlCombobox, or AtlRadioGroup depending on cardinality."}],"related":["AtlBadge","AtlCheckbox","AtlPagination"]},"AtlTabGroup":{"whenToUse":["Splitting a settings or profile page into named sections that do not need their own URL.","Toggling between alternate representations of the same data (chart vs table, raw vs formatted).","Organising the contents of a dialog or drawer into a small number of named pages.","Grouping closely related forms or lists where the user typically only looks at one at a time."],"whenNotToUse":[{"statement":"Wiring tabs as top-level site navigation across distinct pages.","useInstead":"A real nav with `<a>` links and URLs — tabs swap panels in place, navigation changes location."},{"statement":"Hiding optional, rarely-read content behind a tab to reduce page length.","useInstead":"AtlAccordion — accordions are the right primitive for collapsing supplementary sections."},{"statement":"Presenting a linear, ordered workflow as tabs.","useInstead":"AtlStepper — steppers communicate progress and ordering, tabs do not."}],"related":["AtlAccordionGroup","AtlStepper"]},"AtlTab":{"whenToUse":["Splitting a settings or profile page into named sections that do not need their own URL.","Toggling between alternate representations of the same data (chart vs table, raw vs formatted).","Organising the contents of a dialog or drawer into a small number of named pages.","Grouping closely related forms or lists where the user typically only looks at one at a time."],"whenNotToUse":[{"statement":"Wiring tabs as top-level site navigation across distinct pages.","useInstead":"A real nav with `<a>` links and URLs — tabs swap panels in place, navigation changes location."},{"statement":"Hiding optional, rarely-read content behind a tab to reduce page length.","useInstead":"AtlAccordion — accordions are the right primitive for collapsing supplementary sections."},{"statement":"Presenting a linear, ordered workflow as tabs.","useInstead":"AtlStepper — steppers communicate progress and ordering, tabs do not."}],"related":["AtlAccordionGroup","AtlStepper"]},"AtlTextarea":{"whenToUse":["Collecting a description, comment, or message body where line breaks are part of the input.","Capturing a code snippet, log paste, or long-form note.","Editing freeform content where the visible height should grow with the text (`autoResize: true`)."],"whenNotToUse":[{"statement":"Collecting a single short value such as a title or email.","useInstead":"AtlInput — sized for one-line entry with type-specific keyboard hints."},{"statement":"Building a rich-text editor with formatting toolbars.","useInstead":"A dedicated editor (Tiptap, Lexical) — textarea is plain text only."}],"related":["AtlInput"]},"AtlToggle":{"whenToUse":["Flipping a setting that applies the moment it changes (dark mode, notifications, autosave).","Enabling or disabling a feature inside a settings panel or preferences row.","Acting as the trigger for revealing a dependent block of controls when on."],"whenNotToUse":[{"statement":"Choosing among more than two states.","useInstead":"AtlRadioGroup or AtlSelect — switches only encode true/false."},{"statement":"Collecting a binary value that is only committed on form submit.","useInstead":"AtlCheckbox — checkboxes carry the \"stage a change\" semantics; switches imply immediate effect."}],"related":["AtlCheckbox"]},"AtlTooltip":{"whenToUse":["Naming an icon-only button or control so it reads correctly to assistive tech and on hover.","Annotating an abbreviation, truncated label, or terse column header with its full form.","Adding a short keyboard-shortcut hint to a button or menu item.","Explaining why a disabled control is disabled, without committing to a popover."],"whenNotToUse":[{"statement":"Holding rich content, links, or interactive controls inside the tip.","useInstead":"A popover or dialog — tooltips are non-interactive label text only."},{"statement":"Communicating critical information that the user must read to complete a task.","useInstead":"AtlAlert, inline help text, or visible labels — tooltips disappear on blur and are skipped on touch."},{"statement":"Acting as the only accessible name for an interactive element.","useInstead":"A proper `aria-label` or visible label — pair the tooltip with that label rather than relying on it alone."}],"related":["AtlButton","AtlMenu"]}}
@@ -0,0 +1 @@
1
+ {"patterns":[{"id":"login-form","title":"Login Form","description":"The most frequent AI-generated page. Shows Card composition, validation error display, and loading states.","components":["AtlCard","AtlInput","AtlButton","AtlAlert","AtlCheckbox"],"whenNotToUse":["Multi-step onboarding flows — reach for AtlStepper instead.","Passwordless / magic-link flows where the response is a separate state, not a form error.","When the form needs more than one Card column or section — switch to a Settings-style tabbed layout."],"pitfalls":["LLMs love to put `aria-required` on every field. Mark required state via the validation schema and the visible label, not as a duplicate ARIA attribute.","Returning the password value into the input on a failed submit reveals it in the DOM — clear it on error like a native browser would.","Using `<button type=\"button\">` instead of `type=\"submit\"` breaks Enter-to-submit. Cookbook story uses native submit semantics."]},{"id":"settings-page","title":"Settings Page","description":"Exercises tabs, form controls, and layout composition. The bread and butter of SaaS applications.","components":["AtlTabGroup","AtlToggle","AtlSelect","AtlInput","AtlButton","AtlAlert"],"whenNotToUse":["Single-screen inline edit of one or two values — use an AtlCard with the input directly, not a tabbed shell.","Wizard-style sequences where order matters — AtlStepper enforces progression that TabGroup intentionally does not.","Nested settings that need their own sub-tabs — collapse to an accordion or a list-detail layout instead of nesting tab groups."],"pitfalls":["LLMs frequently hoist tab content into a giant switch in the parent. Each AtlTab's body is the projected child — keep state co-located with the inputs, not the parent.","Saving a partial form across tab switches breaks the user's mental model. Either persist optimistically per change or block the save button until the user returns to a complete state.","Don't bind `AtlSelect` to a tuple `{value, label}` — bind the primitive value and let the option element project the label."]},{"id":"confirmation-dialog","title":"Confirmation Dialog","description":"Accessible modal flow for destructive actions. Shows trigger → dialog → action logic.","components":["AtlDialog","AtlAlert","AtlButton"],"whenNotToUse":["Reversible actions where the undo lives elsewhere in your UI (AtlToast has no action button — it carries a message and an optional dismiss button, so an \"Undo\" must be built outside it).","Form-style multi-field confirmation (\"type the project name to confirm\") — that's a destructive form, render it on its own page or in an AtlDrawer.","As an \"are you sure?\" wrapper around every save button. Confirmation fatigue trains users to click through."],"pitfalls":["LLMs frequently add `autoFocus` to the destructive button — this nudges users into an accidental confirm. The first Tab stop should be Cancel.","Forgetting to gate the trigger when the action is already in flight produces double-deletes; flip the dialog's `open` to false only after the mutation resolves.","Putting body content as a raw string inside `AtlDialogContent` skips the AtlAlert composition the cookbook recommends — the Alert carries the warning message."]},{"id":"data-list","title":"Data List with Actions","description":"Inline actions on a list of items. The core pattern for dashboards and admin panels — Card + Badge + Button composition.","components":["AtlCard","AtlBadge","AtlButton","AtlMenu","AtlTooltip"],"whenNotToUse":["More than ~50 items — switch to AtlTable with sorting, sticky header, and pagination.","Items whose primary affordance is reading, not acting — use a plain styled list without per-row buttons.","Lists that need column alignment across rows — Cards collapse content; Tables align it."],"pitfalls":["LLMs render `<a>` and `<button>` interchangeably for row actions — use `<button>` for \"Edit\", `<a>` only for navigation. Mixing breaks Cmd-click behaviour.","Putting the entire row inside a `<button>` swallows the inner buttons' click handlers. Use a clickable region pattern (cursor + keydown) rather than a wrapping button.","The cookbook story uses AtlMenu for Edit / Duplicate / Delete because each is a separate operation. If you only have one secondary action, drop the menu and inline the button."]},{"id":"notification-center","title":"Notification Center","description":"Structural feedback grouping using Accordion and Alert. Useful for monitoring and admin tools.","components":["AtlAccordionGroup","AtlAlert","AtlBadge","AtlButton"],"whenNotToUse":["Transient toast-style notifications — use AtlToast (a `role=\"status\"` polite live region for every variant), not an accordion.","A single critical message — inline AtlAlert above the page is louder and harder to ignore than a collapsed accordion section.","Real-time logs / streaming output — the accordion expansion animation fights the auto-scroll. Use a virtual-scrolled list instead."],"pitfalls":["LLMs frequently nest AtlAccordionGroup inside another accordion — flat groupings work better; switch to AtlTabGroup if you really need two axes.","Auto-collapsing the section when its last item is dismissed is jarring on keyboard users mid-action — leave it open and show an empty-state row.","Marking everything as `variant=\"danger\"` so the user \"really sees it\" trains them to ignore the colour. Reserve danger for actual failures."]},{"id":"management-dashboard","title":"Management Dashboard","description":"The densest cookbook pattern — metric cards, activity table, and quota indicators combined. Shows how Card, Table, TabGroup, Badge, Alert, and Progress fit together.","components":["AtlCard","AtlTable","AtlTabGroup","AtlBadge","AtlAlert","AtlProgress","AtlButton"],"whenNotToUse":["Single-metric pages — all this scaffolding is overkill for one number with a sparkline.","Pages where the data is the whole point and side-by-side cards add no value — render the table full-bleed instead.","Real-time dashboards with sub-second updates — these fight the static layout; use an SVG/canvas chart and drop the Card grids."],"pitfalls":["LLMs love to project tab content into a giant `ngSwitch` / ternary that re-renders the entire grid on each tab change. Bind only the data-fetch scope to the tab; let the layout stay static.","Using `variant=\"warning\"` Alerts for every quota above 50 % numbs the signal. Reserve for crossings of the actual SLA / billing threshold.","Putting the table and the side panel into a single AtlCard collapses their independent scroll regions. They're siblings, not parent/child."]}]}
@@ -0,0 +1 @@
1
+ {"tokens":[{"name":"--ui-font-family","light":"'Instrument Sans', ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif","intent":"Default UI typeface stack. Instrument Sans first, with system fallbacks for offline / first-paint (ADR-0035).","constraints":["Declare it once on each component root — not per rule, and not left to the app shell: a component that depends on the consumer applying it renders in the app's font while its neighbours render this one (measured; ADR-0049).","Use --ui-font-display for the one display line per surface; everything interactive stays on this stack."]},{"name":"--ui-font-display","light":"'Instrument Serif', Georgia, 'Times New Roman', serif"},{"name":"--ui-font-mono","light":"'JetBrains Mono', ui-monospace, SFMono-Regular, Menlo, Monaco, 'Courier New', monospace"},{"name":"--ui-font-size-2xs","light":"0.625rem","intent":"Smaller than the smallest readable size (0.625rem). For text inside a box too small to hold --ui-font-size-xs: the initials in a 24px avatar and the count in its overflow badge.","constraints":["Only for text a user identifies rather than reads. Never for a label, a caption or body copy.","Do not introduce further steps below this one; the two literals it replaced were the library's entire off-scale type population."]},{"name":"--ui-font-size-xs","light":"0.75rem","intent":"Smallest readable size (0.75rem). Use for badges, captions, table meta, and dense labels.","constraints":["Do not use for body copy or interactive labels users must read at a glance.","Pair with --ui-color-text-muted for secondary information."]},{"name":"--ui-font-size-sm","light":"0.875rem","intent":"Compact size (0.875rem). Use for secondary text, helper messages, and dense form labels.","constraints":["Do not interpolate between scale steps; pick the nearest defined value.","Avoid combining with --ui-line-height-tight for multi-line copy — readability suffers."]},{"name":"--ui-font-size-md","light":"1rem","intent":"Body copy size (1rem). The default for paragraphs and form inputs.","constraints":["Do not interpolate between scale steps; pick the nearest defined value.","Treat this as the baseline — only step up/down when a hierarchy demands it."]},{"name":"--ui-font-size-lg","light":"1.125rem","intent":"Emphasised body / small headings (1.125rem). Use for card titles and dialog headings.","constraints":["Pair with --ui-font-weight-semibold or --ui-font-weight-medium for hierarchy.","Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-font-size-xl","light":"1.25rem","intent":"Section heading size (1.25rem). Use for page sub-headings and modal titles.","constraints":["Pair with --ui-line-height-tight for compact headings.","Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-font-size-2xl","light":"1.5rem"},{"name":"--ui-letter-spacing-tight","light":"-0.01em","intent":"Negative tracking (-0.01em) for large headings to prevent loose appearance.","constraints":["Use only at --ui-font-size-xl and above; tightening small text hurts legibility."]},{"name":"--ui-letter-spacing-normal","light":"0"},{"name":"--ui-letter-spacing-wide","light":"0.01em","intent":"Positive tracking (0.01em) for all-caps labels, badges, and eyebrows.","constraints":["Pair with --ui-font-size-xs or --ui-font-size-sm and uppercase casing.","Do not apply to lowercase running text."]},{"name":"--ui-letter-spacing-uppercase","light":"0.08em"},{"name":"--ui-font-size-3xl","light":"2.25rem"},{"name":"--ui-row-inset","light":"0.25rem"},{"name":"--ui-row-height-sm","light":"calc( var(--ui-control-height-sm) + 2 * var(--ui-row-inset) )","intent":"The height of a repeating row that holds sm-step content: a menu item, a dropdown option, a checkbox / radio / toggle row, a compact table row.","constraints":["A row CENTRES its content: `min-height: var(--ui-row-height-sm); padding-block: 0; line-height: var(--ui-line-height-tight)`. ADR-0041's derived-padding formula is for controls and produces the wrong box here — a size-md cell with derived padding renders 62.5px holding an md button.","min-height, not height: a row whose content wraps has to grow rather than clip (ADR-0041's own reasoning).","Not for breadcrumbs or for card / dialog / drawer / chat headers — see ADR-0052."]},{"name":"--ui-row-height-md","light":"calc( var(--ui-control-height-md) + 2 * var(--ui-row-inset) )","intent":"The default repeating row: a table row, a list row that holds md-step controls.","constraints":["Same recipe as --ui-row-height-sm: state the height, zero the block padding, state the line-height.","Any control of the md step fits without a convention; that is the whole reason this ladder exists."]},{"name":"--ui-row-height-lg","light":"calc( var(--ui-control-height-lg) + 2 * var(--ui-row-inset) )","intent":"A roomy repeating row — a comfortable table, a touch-first list.","constraints":["Same recipe. Reach for it when the content is a lg-step control or when density is deliberately low, not to create emphasis."]},{"name":"--ui-control-height-sm","light":"2rem","intent":"Height of a small interactive control (2rem). Buttons, inputs, selects, chips that sit in dense rows.","constraints":["Derive block padding from this, do not state it: calc((height - line-height * font-size) / 2 - border).","Two controls of the same size step must resolve to the same height — that is the entire point of the token."]},{"name":"--ui-control-height-md","light":"2.5rem","intent":"Height of the default interactive control (2.5rem). The size a form row is built from.","constraints":["Derive block padding from this, do not state it.","Use the control line-height (--ui-line-height-tight) in the derivation; the prose line-height makes the box taller than the token claims."]},{"name":"--ui-control-height-lg","light":"3rem","intent":"Height of a large interactive control (3rem). Primary actions and touch-first surfaces.","constraints":["Derive block padding from this, do not state it.","The derived padding is fractional (11.75px at the current type scale). That is correct: the height is the round number, not the padding."]},{"name":"--ui-font-weight-normal","light":"400"},{"name":"--ui-font-weight-medium","light":"500","intent":"Subtle emphasis weight (500). Use for form labels, button text, and table headers.","constraints":["Prefer this over bold for inline emphasis inside body copy."]},{"name":"--ui-font-weight-semibold","light":"600","intent":"Strong emphasis weight (600). Use for headings and primary calls-to-action.","constraints":["Do not use weights above 600 — the type stack is not loaded with heavier cuts."]},{"name":"--ui-font-weight-bold","light":"700","intent":"Bold (700). The heaviest weight in the system; carries headline-level emphasis.","constraints":["Instrument Sans only — the display face ships a single weight, so this must never be applied to --ui-font-display.","One bold element per view; a second one cancels the first."]},{"name":"--ui-line-height-tight","light":"1.25","intent":"Compact leading (1.25) for headings and single-line UI text.","constraints":["Do not use for multi-line body copy — readability suffers."]},{"name":"--ui-line-height-normal","light":"1.5","intent":"Default leading (1.5) for body copy and multi-line UI text.","constraints":["This is the implicit baseline — only set explicitly when overriding a parent."]},{"name":"--ui-line-height-code","light":"1.65"},{"name":"--ui-type-display","light":"italic var(--ui-font-weight-normal) var(--ui-font-size-3xl) / var(--ui-line-height-tight) var(--ui-font-display)"},{"name":"--ui-type-headline","light":"var(--ui-font-weight-bold) var(--ui-font-size-2xl) / var(--ui-line-height-tight) var(--ui-font-family)"},{"name":"--ui-type-title","light":"var(--ui-font-weight-semibold) var(--ui-font-size-lg) / var(--ui-line-height-tight) var(--ui-font-family)"},{"name":"--ui-type-body-lg","light":"var(--ui-font-weight-normal) var(--ui-font-size-lg) / var(--ui-line-height-normal) var(--ui-font-family)"},{"name":"--ui-type-body-md","light":"var(--ui-font-weight-normal) var(--ui-font-size-md) / var(--ui-line-height-normal) var(--ui-font-family)","intent":"Body role, default (1rem). The workhorse — every paragraph and every interactive label unless a role says otherwise.","constraints":["If unsure which role a piece of text is, it is this one."]},{"name":"--ui-type-body-sm","light":"var(--ui-font-weight-normal) var(--ui-font-size-sm) / var(--ui-line-height-normal) var(--ui-font-family)","intent":"Body role, small (0.875rem). Helper text, table meta, secondary descriptions.","constraints":["Pair with --ui-color-text-muted so the size and the colour agree about importance."]},{"name":"--ui-type-label","light":"var(--ui-font-weight-medium) var(--ui-font-size-xs) / var(--ui-line-height-tight) var(--ui-font-family)"},{"name":"--ui-type-code","light":"var(--ui-font-weight-normal) var(--ui-font-size-sm) / var(--ui-line-height-code) var(--ui-font-mono)"},{"name":"--ui-type-control","light":"var(--ui-font-weight-medium) var(--ui-font-size-sm) / var(--ui-line-height-tight) var(--ui-font-family)"},{"name":"--ui-type-action","light":"var(--ui-font-weight-semibold) var(--ui-font-size-md) / var(--ui-line-height-tight) var(--ui-font-family)"},{"name":"--ui-type-row","light":"var(--ui-font-weight-normal) var(--ui-font-size-md) / var(--ui-line-height-tight) var(--ui-font-family)"},{"name":"--ui-type-row-sm","light":"var(--ui-font-weight-normal) var(--ui-font-size-sm) / var(--ui-line-height-tight) var(--ui-font-family)"},{"name":"--ui-type-emphasis","light":"var(--ui-font-weight-semibold) var(--ui-font-size-sm) / var(--ui-line-height-tight) var(--ui-font-family)","intent":"Emphasis role: semibold 0.875rem, tight. The text of a small element that is stressed rather than read — a badge, a step marker, the current breadcrumb.","constraints":["Letter-spacing and text-transform are not part of the role — a badge adds its own tracking.","Tight leading, for the same reason as the row roles: these elements take their height from padding or a stated box, not from the text.","Added with 3 CSS rules and 15 Figma text nodes (ADR-0162). The semibold xs combination has no role — only 2 clean CSS rules."]},{"name":"--ui-color-teal-50","light":"#99f4f4"},{"name":"--ui-color-teal-100","light":"#87efef"},{"name":"--ui-color-teal-200","light":"#5ee5e5"},{"name":"--ui-color-teal-300","light":"#34d8d8"},{"name":"--ui-color-teal-400","light":"#27babd"},{"name":"--ui-color-teal-500","light":"#1a9ca3"},{"name":"--ui-color-teal-600","light":"#0d7f89"},{"name":"--ui-color-teal-700","light":"#006470"},{"name":"--ui-color-teal-800","light":"#004e58"},{"name":"--ui-color-teal-900","light":"#003a42"},{"name":"--ui-color-red-100","light":"#fee2e2"},{"name":"--ui-color-red-200","light":"#fecaca"},{"name":"--ui-color-red-300","light":"#fca5a5"},{"name":"--ui-color-red-400","light":"#f87171"},{"name":"--ui-color-red-500","light":"#e35856"},{"name":"--ui-color-red-600","light":"#ce3d3b"},{"name":"--ui-color-red-700","light":"#b91c1c"},{"name":"--ui-color-red-800","light":"#991b1b"},{"name":"--ui-color-red-900","light":"#7f1d1d"},{"name":"--ui-color-red-950","light":"#3a1414"},{"name":"--ui-color-green-100","light":"#dcfce7"},{"name":"--ui-color-green-200","light":"#b4f6ca"},{"name":"--ui-color-green-300","light":"#86efac"},{"name":"--ui-color-green-400","light":"#4ade80"},{"name":"--ui-color-green-500","light":"#39be69"},{"name":"--ui-color-green-600","light":"#279e53"},{"name":"--ui-color-green-700","light":"#15803d"},{"name":"--ui-color-green-800","light":"#166534"},{"name":"--ui-color-green-900","light":"#15582f"},{"name":"--ui-color-green-950","light":"#0f3320"},{"name":"--ui-color-amber-100","light":"#fef3c7"},{"name":"--ui-color-amber-200","light":"#fde68a"},{"name":"--ui-color-amber-300","light":"#fcd361"},{"name":"--ui-color-amber-400","light":"#fbbf24"},{"name":"--ui-color-amber-500","light":"#e49b1b"},{"name":"--ui-color-amber-600","light":"#cc7712"},{"name":"--ui-color-amber-700","light":"#b45309"},{"name":"--ui-color-amber-800","light":"#854d0e"},{"name":"--ui-color-amber-900","light":"#714311"},{"name":"--ui-color-amber-950","light":"#3a2510"},{"name":"--ui-color-sky-100","light":"#e0f2fe"},{"name":"--ui-color-sky-200","light":"#bae6fd"},{"name":"--ui-color-sky-300","light":"#82d2fb"},{"name":"--ui-color-sky-400","light":"#38bdf8"},{"name":"--ui-color-sky-500","light":"#28a0da"},{"name":"--ui-color-sky-600","light":"#1784bd"},{"name":"--ui-color-sky-700","light":"#0369a1"},{"name":"--ui-color-sky-800","light":"#0a5784"},{"name":"--ui-color-sky-900","light":"#0c4a6e"},{"name":"--ui-color-sky-950","light":"#102338"},{"name":"--ui-color-primary","light":"var(--ui-color-teal-700)","dark":"var(--ui-color-teal-300)","intent":"Primary call-to-action colour and link text. Brand anchor on light backgrounds.","constraints":["Must meet >=4.5:1 contrast against the surface it renders on.","Reserve for one primary action per view — do not stack two side-by-side.","Pair foreground text with --ui-color-text-on-primary when used as a fill."]},{"name":"--ui-color-primary-hover","light":"var(--ui-color-teal-800)","dark":"var(--ui-color-teal-200)","intent":"Hover state for primary surfaces and links — one shade deeper than --ui-color-primary.","constraints":["Only use as :hover / :focus-visible state — never as a resting fill.","Must preserve >=4.5:1 contrast against text-on-primary."]},{"name":"--ui-color-primary-active","light":"var(--ui-color-teal-900)","dark":"var(--ui-color-teal-100)","intent":"Pressed / active state for primary surfaces — deepest step of the primary ramp.","constraints":["Only use as :active state — never as a resting fill."]},{"name":"--ui-color-primary-light","light":"rgba(0, 100, 112, 0.08)","dark":"rgba(52, 216, 216, 0.15)","intent":"Soft tinted background for selected / hovered ghost states and subtle primary surfaces.","constraints":["Decorative only — does not meet text-contrast requirements as a fill.","Pair with --ui-color-primary or --ui-color-text for foreground content."]},{"name":"--ui-color-secondary","light":"#475569","dark":"#94a3b8","intent":"Neutral secondary action colour (slate). Use for opt-in secondary buttons and chrome.","constraints":["Reserve for components that explicitly opt in — primary actions should use --ui-color-primary.","Pair foreground text with --ui-color-text-on-secondary when used as a fill."]},{"name":"--ui-color-secondary-hover","light":"#334155","dark":"#cbd5e1","intent":"Hover state for secondary surfaces — one shade deeper than --ui-color-secondary.","constraints":["Only use as :hover / :focus-visible state — never as a resting fill."]},{"name":"--ui-color-secondary-active","light":"#1e293b","dark":"#e2e8f0","intent":"Pressed / active state for secondary surfaces — deepest step of the secondary ramp.","constraints":["Only use as :active state — never as a resting fill."]},{"name":"--ui-color-danger","light":"var(--ui-color-red-700)","dark":"var(--ui-color-red-400)","intent":"Destructive action and error signal colour. Use for delete buttons and form errors.","constraints":["Pair with text + icon — never rely on colour alone for state.","Do not use for decorative emphasis.","Pair foreground text with --ui-color-text-on-danger when used as a fill."]},{"name":"--ui-color-danger-hover","light":"var(--ui-color-red-800)","dark":"var(--ui-color-red-300)","intent":"Hover state for danger surfaces — one shade deeper than --ui-color-danger.","constraints":["Only use as :hover / :focus-visible state — never as a resting fill."]},{"name":"--ui-color-danger-active","light":"var(--ui-color-red-900)","dark":"var(--ui-color-red-200)","intent":"Pressed / active state for danger surfaces — deepest step of the danger ramp.","constraints":["Only use as :active state — never as a resting fill."]},{"name":"--ui-color-success","light":"var(--ui-color-green-700)","dark":"var(--ui-color-green-400)","intent":"Positive confirmation signal colour. Use for success buttons and confirmation icons.","constraints":["Pair with text + icon — never rely on colour alone for state.","Do not use for decorative emphasis.","Pair foreground text with --ui-color-text-on-success when used as a fill."]},{"name":"--ui-color-warning","light":"var(--ui-color-amber-700)","dark":"var(--ui-color-amber-400)","intent":"Caution signal colour. Use for warning alerts and pending states.","constraints":["Pair with text + icon — never rely on colour alone for state.","Do not use for decorative emphasis."]},{"name":"--ui-color-info","light":"var(--ui-color-sky-700)","dark":"var(--ui-color-sky-400)"},{"name":"--ui-color-success-bg","light":"var(--ui-color-green-100)","dark":"var(--ui-color-green-950)","intent":"Tinted background for success badges, alerts, and toasts. AA-safe pair with --ui-color-success-text.","constraints":["Only use as a fill — pair foreground with --ui-color-success-text for guaranteed contrast.","Do not place arbitrary text colours on this surface — the AA pairing is specific."]},{"name":"--ui-color-success-text","light":"var(--ui-color-green-800)","dark":"var(--ui-color-green-300)","intent":"AA-safe foreground for use on --ui-color-success-bg in success badges, alerts, and toasts.","constraints":["Only use as foreground on --ui-color-success-bg; contrast is guaranteed against that surface and no other."]},{"name":"--ui-color-warning-bg","light":"var(--ui-color-amber-100)","dark":"var(--ui-color-amber-950)","intent":"Tinted background for warning badges, alerts, and toasts. AA-safe pair with --ui-color-warning-text.","constraints":["Only use as a fill — pair foreground with --ui-color-warning-text for guaranteed contrast.","Do not place arbitrary text colours on this surface — the AA pairing is specific."]},{"name":"--ui-color-warning-text","light":"var(--ui-color-amber-800)","dark":"var(--ui-color-amber-200)","intent":"AA-safe foreground for use on --ui-color-warning-bg in warning badges, alerts, and toasts.","constraints":["Only use as foreground on --ui-color-warning-bg; contrast is guaranteed against that surface and no other."]},{"name":"--ui-color-danger-bg","light":"var(--ui-color-red-100)","dark":"var(--ui-color-red-950)","intent":"Tinted background for danger badges, alerts, and toasts. AA-safe pair with --ui-color-danger-text.","constraints":["Only use as a fill — pair foreground with --ui-color-danger-text for guaranteed contrast.","Do not place arbitrary text colours on this surface — the AA pairing is specific."]},{"name":"--ui-color-danger-text","light":"var(--ui-color-red-800)","dark":"var(--ui-color-red-300)","intent":"AA-safe foreground for use on --ui-color-danger-bg in danger badges, alerts, and toasts.","constraints":["Only use as foreground on --ui-color-danger-bg; contrast is guaranteed against that surface and no other."]},{"name":"--ui-color-info-bg","light":"var(--ui-color-sky-100)","dark":"var(--ui-color-sky-950)","intent":"Tinted background for info badges, alerts, and toasts. AA-safe pair with --ui-color-info-text.","constraints":["Only use as a fill — pair foreground with --ui-color-info-text for guaranteed contrast.","Do not place arbitrary text colours on this surface — the AA pairing is specific."]},{"name":"--ui-color-info-text","light":"var(--ui-color-sky-900)","dark":"var(--ui-color-sky-200)","intent":"AA-safe foreground for use on --ui-color-info-bg in info badges, alerts, and toasts.","constraints":["Only use as foreground on --ui-color-info-bg; contrast is guaranteed against that surface and no other."]},{"name":"--ui-color-surface","light":"#ffffff","dark":"#0a1116","intent":"Base page background. The canvas every other surface elevates from.","constraints":["Pair with --ui-color-text or --ui-color-text-muted only — never raw black/white.","Do not stack two surfaces of the same level on top of each other — use -raised or -sunken."]},{"name":"--ui-color-surface-raised","light":"#f8fafc","dark":"#131c24","intent":"Slightly elevated surface for cards, popovers, and panels resting above the page.","constraints":["Pair with --ui-color-text or --ui-color-text-muted only — never raw black/white.","Combine with --ui-shadow-sm or --ui-shadow-md for perceived elevation."]},{"name":"--ui-color-surface-sunken","light":"#f1f5f9","dark":"#060c10","intent":"Recessed surface for input fields, code blocks, and inset containers.","constraints":["Pair with --ui-color-text or --ui-color-text-muted only — never raw black/white.","Do not combine with elevation shadows — sunken surfaces should read as inset."]},{"name":"--ui-color-overlay","light":"rgba(0, 0, 0, 0.5)","dark":"rgba(0, 0, 0, 0.7)","intent":"Scrim behind modals, drawers, and full-screen overlays.","constraints":["Only use as a backdrop layer — never as a fill for interactive surfaces.","Pair with --ui-z-overlay or higher; do not place at base z-index."]},{"name":"--ui-color-border","light":"#e2e8f0","dark":"#1e293b","intent":"Decorative border for cards, dividers, and resting input outlines. Below 3:1 contrast — informational only.","constraints":["Decorative only — do not use as the sole indicator of a functional boundary (WCAG 1.4.11).","For functional borders (interactive controls), use --ui-color-border-strong."]},{"name":"--ui-color-border-hover","light":"#cbd5e1","dark":"#334155","intent":"Hover state for decorative borders — slightly deeper than --ui-color-border.","constraints":["Only use as :hover state — never as a resting border."]},{"name":"--ui-color-border-strong","light":"#64748b","dark":"#64748b","intent":"Functional border meeting >=3:1 contrast (WCAG 1.4.11). Use for input outlines, focus rings, and meaningful dividers.","constraints":["Use whenever the border carries meaning (control boundaries, separators users must perceive).","Do not use for purely decorative chrome — use --ui-color-border instead."]},{"name":"--ui-color-text","light":"#0f172a","dark":"#f1f5f9","intent":"Primary body and heading text colour. Use on --ui-color-surface and its raised/sunken variants.","constraints":["Must meet >=4.5:1 contrast against the surface it renders on (verified for all --ui-color-surface* pairs).","Do not use as a fill colour — this is a foreground token."]},{"name":"--ui-color-text-muted","light":"#475569","dark":"#94a3b8","intent":"Secondary text colour for helper copy, captions, and de-emphasised content.","constraints":["Must meet >=4.5:1 contrast — verified against --ui-color-surface* but not against tinted surfaces.","Do not use for primary actions, form labels, or anything users must scan quickly."]},{"name":"--ui-color-text-on-primary","light":"#ffffff","dark":"#0a1116","intent":"Foreground colour for text and icons rendered on --ui-color-primary fills.","constraints":["Only use as foreground on the matching brand surface; contrast is guaranteed against that surface and no other."]},{"name":"--ui-color-text-on-secondary","light":"#ffffff","dark":"#0f172a","intent":"Foreground colour for text and icons rendered on --ui-color-secondary fills.","constraints":["Only use as foreground on the matching brand surface; contrast is guaranteed against that surface and no other."]},{"name":"--ui-color-text-on-danger","light":"#ffffff","dark":"#0a1116","intent":"Foreground colour for text and icons rendered on --ui-color-danger fills.","constraints":["Only use as foreground on the matching brand surface; contrast is guaranteed against that surface and no other."]},{"name":"--ui-color-text-on-success","light":"#ffffff","dark":"#0a1116"},{"name":"--ui-color-brand-corporate","light":"#00bebe"},{"name":"--ui-color-brand-agile","light":"#00d296"},{"name":"--ui-color-brand-architecture","light":"#009696"},{"name":"--ui-color-brand-development","light":"#00b4ff"},{"name":"--ui-color-brand-petrol","light":"#005064"},{"name":"--ui-color-brand-ai","light":"#b5e61c","intent":"Conciso AI sub-brand colour (lime). Opt-in for AI-themed surfaces and accents.","constraints":["Reserve for explicit AI-branded surfaces — do not use as a generic warning or highlight.","Contrast not guaranteed against arbitrary text colours; verify per use."]},{"name":"--ui-color-brand-light-blue","light":"#00ebff"},{"name":"--ui-color-brand-light-green","light":"#a0fa50"},{"name":"--ui-opacity-disabled","light":"0.5","dark":"0.65","intent":"Opacity applied to disabled interactive controls so their colour reads as inert.","constraints":["Apply via opacity on the disabled element — do not bake into colour tokens. The button is the exception: it uses --ui-color-disabled-* because opacity kept its brand hue (ADR-0159).","Do not use for de-emphasis of non-disabled content; use --ui-color-text-muted instead."]},{"name":"--ui-radius-sm","light":"0.5rem","intent":"Small rounding (0.5rem) for compact controls — badges, tags, inline chips.","constraints":["Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-radius-md","light":"0.625rem","intent":"Default rounding for interactive surfaces — buttons, inputs, cards. Modern, mildly soft.","constraints":["Treat as the baseline radius — only step up/down for hierarchy or emphasis.","Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-radius-lg","light":"0.875rem","intent":"Large rounding for prominent panels — modals, popovers, hero cards.","constraints":["Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-radius-xl","light":"1.25rem","intent":"Extra-large rounding for marketing surfaces and oversized panels.","constraints":["Reserve for large surfaces — applied to small controls it reads as a misuse.","Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-radius-full","light":"9999px","intent":"Fully rounded (pill) shape. Use for avatar masks, status dots, and pill buttons.","constraints":["Use on equal-sided elements (circles) or fixed-height pills — applied to rectangles it produces inconsistent corners."]},{"name":"--ui-border-width","light":"1px","intent":"The hairline that separates one surface from another: card and panel outlines, input borders, table rules, the transparent border a button reserves so its box does not move between variants.","constraints":["Every border in the library uses this or --ui-border-width-thick; a literal width fails check:token-bypass.","Keep it a whole pixel — a half-pixel border renders blurry at 1x device-pixel-ratio."]},{"name":"--ui-border-width-thick","light":"2px","intent":"The heavier weight that marks a control rather than separating surfaces: the avatar status ring, the stepper circle, the checkbox mark, the rule under a table header.","constraints":["Reserve it for marks and rings. Using it for surface separation flattens the distinction it exists to make.","Not for graphic devices drawn with border-width (AtlToast's accent bar, AtlRadio's dot) — those are dimensions, and are exempted by name in check:token-bypass."]},{"name":"--ui-spacing-1","light":"0.25rem","intent":"Hairline spacing (0.25rem). Use for icon-to-label gaps and tightest groupings.","constraints":["Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-spacing-2","light":"0.5rem","intent":"Tight spacing (0.5rem). Use for compact button padding and dense list rows.","constraints":["Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-spacing-3","light":"0.75rem","intent":"Snug spacing (0.75rem). Use for default form-control padding and chip insets.","constraints":["Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-spacing-4","light":"1rem","intent":"Default inter-element spacing (1rem). Use for gaps inside cards, between form fields, between list items.","constraints":["Treat as the baseline spacing — only step up/down for hierarchy or density.","Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-spacing-5","light":"1.25rem","intent":"Comfortable spacing (1.25rem). Use for card padding and form section gaps.","constraints":["Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-spacing-6","light":"1.5rem","intent":"Loose spacing (1.5rem). Use for dialog padding and prominent component insets.","constraints":["Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-spacing-8","light":"2rem","intent":"Section spacing (2rem). Use between distinct content blocks on a page.","constraints":["Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-spacing-10","light":"2.5rem"},{"name":"--ui-spacing-12","light":"3rem","intent":"Generous section spacing (3rem). Use for page-level layout gutters.","constraints":["Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-spacing-16","light":"4rem"},{"name":"--ui-shadow-xs","light":"0 1px 2px 0 rgba(15, 23, 42, 0.05)","dark":"0 1px 2px 0 rgba(0, 0, 0, 0.3)","intent":"Minimal elevation — a faint shadow used for inputs and resting interactive controls.","constraints":["Combine with a 1px subtle border for clarity on busy backgrounds.","Avoid stacking with --ui-shadow-md or above on the same surface."]},{"name":"--ui-shadow-sm","light":"0 1px 3px 0 rgba(15, 23, 42, 0.08), 0 1px 2px -1px rgba(15, 23, 42, 0.06)","dark":"0 1px 3px 0 rgba(0, 0, 0, 0.4), 0 1px 2px -1px rgba(0, 0, 0, 0.3)","intent":"Low elevation for resting cards and panels that lift slightly off the page.","constraints":["Combine with a 1px subtle border for clarity on busy backgrounds.","Avoid stacking with --ui-shadow-lg on the same surface."]},{"name":"--ui-shadow-md","light":"0 4px 6px -1px rgba(15, 23, 42, 0.08), 0 2px 4px -2px rgba(15, 23, 42, 0.05)","dark":"0 4px 6px -1px rgba(0, 0, 0, 0.45), 0 2px 4px -2px rgba(0, 0, 0, 0.3)","intent":"Default elevation for raised surfaces (cards, dropdowns at rest).","constraints":["Combine with a 1px subtle border for clarity on busy backgrounds.","Avoid stacking with --ui-shadow-lg on the same surface."]},{"name":"--ui-shadow-lg","light":"0 10px 15px -3px rgba(15, 23, 42, 0.08), 0 4px 6px -4px rgba(15, 23, 42, 0.04)","dark":"0 10px 15px -3px rgba(0, 0, 0, 0.5), 0 4px 6px -4px rgba(0, 0, 0, 0.25)","intent":"High elevation for popovers, menus, and floating panels detached from the page.","constraints":["Reserve for transient floating UI — overusing flattens the elevation hierarchy.","Avoid stacking with --ui-shadow-xl on the same surface."]},{"name":"--ui-shadow-xl","light":"0 20px 25px -5px rgba(15, 23, 42, 0.1), 0 8px 10px -6px rgba(15, 23, 42, 0.04)","dark":"0 20px 25px -5px rgba(0, 0, 0, 0.5), 0 8px 10px -6px rgba(0, 0, 0, 0.25)","intent":"Maximum elevation for modals and command palettes that own the screen.","constraints":["Reserve for top-level dialogs — there is no higher step.","Pair with --ui-color-overlay to anchor the elevation."]},{"name":"--ui-ease-out","light":"cubic-bezier(0.16, 1, 0.3, 1)","intent":"Decelerating easing curve. Use for entrances and elements arriving on screen.","constraints":["Use --ui-ease-out for entrances, --ui-ease-in-out for movement, --ui-ease-spring for emphasised transitions."]},{"name":"--ui-ease-in-out","light":"cubic-bezier(0.45, 0, 0.55, 1)","intent":"Symmetrical easing curve. Use for elements moving across the screen.","constraints":["Use --ui-ease-out for entrances, --ui-ease-in-out for movement, --ui-ease-spring for emphasised transitions."]},{"name":"--ui-ease-spring","light":"cubic-bezier(0.34, 1.56, 0.64, 1)","intent":"Overshoot easing curve. Use sparingly for emphasised transitions (e.g. toasts, success confirmations).","constraints":["Use --ui-ease-out for entrances, --ui-ease-in-out for movement, --ui-ease-spring for emphasised transitions.","Collapses to \"ease\" under prefers-reduced-motion — do not rely on the overshoot for meaning."]},{"name":"--ui-duration-fast","light":"150ms","intent":"Short transition (150ms). Use for hover/focus state changes and micro-interactions.","constraints":["Respects prefers-reduced-motion via the @media block — do not override durations elsewhere.","Do not interpolate between scale steps; pick the nearest defined value."]},{"name":"--ui-duration-normal","light":"200ms","intent":"Default transition (200ms). Use for property changes on interactive components.","constraints":["Respects prefers-reduced-motion via the @media block — do not override durations elsewhere.","Treat as the baseline — only step up/down for emphasis."]},{"name":"--ui-duration-slow","light":"300ms","intent":"Long transition (300ms). Use for enter/exit animations on overlays and panels.","constraints":["Respects prefers-reduced-motion via the @media block — do not override durations elsewhere.","Avoid for state changes users repeat often — it feels sluggish."]},{"name":"--ui-transition-fast","light":"var(--ui-duration-fast) var(--ui-ease-out)","intent":"Composed transition shorthand: fast duration + ease-out. Use for hover/focus micro-interactions.","constraints":["Apply to the `transition` property with the property name (e.g. `color var(--ui-transition-fast)`).","Respects prefers-reduced-motion through its constituent --ui-duration-fast token."]},{"name":"--ui-transition-normal","light":"var(--ui-duration-normal) var(--ui-ease-out)","intent":"Composed transition shorthand: normal duration + ease-out. Default for interactive state changes.","constraints":["Apply to the `transition` property with the property name (e.g. `background var(--ui-transition-normal)`).","Respects prefers-reduced-motion through its constituent --ui-duration-normal token."]},{"name":"--ui-transition-slow","light":"var(--ui-duration-slow) var(--ui-ease-out)"},{"name":"--ui-focus-ring","light":"0 0 0 2px var(--ui-color-surface), 0 0 0 4px var(--ui-color-primary)","intent":"Double-ring box-shadow for :focus-visible — surface-coloured inner + primary outer for light/dark compatibility.","constraints":["Apply via box-shadow on :focus-visible — never on :focus alone (mouse focus would flash the ring).","Do not override per component; consistency is the entire point of a global focus ring."]},{"name":"--ui-focus-ring-danger","light":"0 0 0 2px var(--ui-color-surface), 0 0 0 4px var(--ui-color-danger)","intent":"The focus ring for a control that is currently invalid. Same double-ring geometry as --ui-focus-ring, with the accent replaced by the danger colour.","constraints":["Only on a control in an invalid state — a danger ring on a valid field reads as an error that is not there.","Do not restate the geometry in component CSS; that is what this token exists to prevent."]},{"name":"--ui-color-input-bg","light":"var(--ui-color-surface-sunken)","intent":"Resting background for text inputs, selects, and textareas. Sunken to read as fillable.","constraints":["Pair with --ui-color-text for foreground; do not place tinted text on input surfaces.","Switch to --ui-color-input-bg-focus on :focus to signal interaction."]},{"name":"--ui-color-input-bg-focus","light":"var(--ui-color-surface)","intent":"Focused background for text inputs — lifts to surface level to signal active editing.","constraints":["Only use as :focus / :focus-within state — never as a resting fill."]},{"name":"--ui-color-input-border","light":"var(--ui-color-border-strong)","dark":"var(--ui-color-border-strong)","intent":"Resting border for text inputs, selects, and textareas. Functional (>=3:1 contrast).","constraints":["Functional border — do not swap for --ui-color-border (decorative, sub-3:1).","Switch to --ui-color-input-border-focus on :focus, --ui-color-input-border-invalid on error."]},{"name":"--ui-color-input-border-hover","light":"#475569","dark":"#94a3b8","intent":"Hover state for input borders — one shade deeper than --ui-color-input-border.","constraints":["Only use as :hover state — never as a resting border."]},{"name":"--ui-color-input-border-focus","light":"var(--ui-color-primary)","intent":"Focused border for inputs — primary-coloured to match the focus ring.","constraints":["Only use as :focus / :focus-within state — never as a resting border.","Pair with --ui-focus-ring on the same element for the full focus treatment."]},{"name":"--ui-color-input-border-invalid","light":"var(--ui-color-danger)","intent":"Border for inputs in an error / aria-invalid state.","constraints":["Pair with a visible error message (via --ui-color-error-text) — never rely on colour alone for state.","Apply when aria-invalid=\"true\" or the equivalent framework signal is present."]},{"name":"--ui-color-placeholder","light":"#566579","dark":"#94a3b8","intent":"Placeholder text colour for inputs. Meets AA (4.5:1) on the input fill and its focus fill in light mode.","constraints":["Reserve for true placeholders (input::placeholder) — never use as a substitute for a real label.","Do not use as a foreground for content users need to read; use --ui-color-text-muted instead."]},{"name":"--ui-color-disabled-bg","light":"#e2e8f0","dark":"#1e293b","intent":"Fill of a disabled (and loading) button: a desaturated neutral slate, so it cannot be mistaken for an enabled brand-coloured button.","constraints":["Button only — other controls still use --ui-opacity-disabled.","Pair with --ui-color-disabled-text and --ui-color-disabled-border; WCAG exempts disabled controls, the gate enforces only a legibility floor."]},{"name":"--ui-color-disabled-text","light":"#64748b","dark":"#94a3b8","intent":"Label (and loading spinner) colour on a disabled button, drawn on --ui-color-disabled-bg.","constraints":["Use only on --ui-color-disabled-bg; never for enabled or informational text."]},{"name":"--ui-color-disabled-border","light":"#cbd5e1","dark":"#334155","intent":"Border of a disabled button; the only visible edge of a disabled outline button, whose fill is transparent.","constraints":["Button only; pair with --ui-color-disabled-bg and --ui-color-disabled-text."]},{"name":"--ui-color-error-text","light":"var(--ui-color-danger-text)","intent":"Foreground colour for inline form error messages. Aliased to --ui-color-danger-text.","constraints":["Pair with --ui-color-input-border-invalid on the associated input — colour alone is not a sufficient error signal.","Do not use as a generic body-text colour — its meaning is \"error\"."]},{"name":"--ui-z-base","light":"0"},{"name":"--ui-z-dropdown","light":"100","intent":"Stacking level for popovers, dropdowns, and menus that float above page content.","constraints":["Layer ordering: base < dropdown < overlay < modal < toast. Do not exceed the scale; if you need more, restructure."]},{"name":"--ui-z-overlay","light":"200"},{"name":"--ui-z-modal","light":"300"},{"name":"--ui-z-toast","light":"400"}],"rules":[{"id":"atelier/no-raw-color-literal","codes":["RAW-COLOR"],"summary":"A component (or docs-site) stylesheet must not spell a colour as a raw literal — a hex triplet/quad (`#fff`, `#00647055`), or an `rgb()`/`rgba()`/ `hsl()`/`hsla()` function call — anywhere a declaration's value is not itself the argument list of a `var(...)` call."},{"id":"atelier/no-undeclared-token","codes":["UNDECLARED"],"summary":"Every `--ui-*` custom property a stylesheet READS via `var(--ui-x, ...)` must be declared somewhere in the token source(s) named by the `tokenFiles` secondary option (repo-root-relative paths, e.g. `['libs/styles/src/tokens.css']`)."},{"id":"atelier/no-token-bypass","codes":["BYPASS","BORDER"],"summary":"Catches a literal whose value a token already holds — the one kind of unbound value that is objectively wrong. This rule deliberately does NOT demand that every value be a token: of the ~190 literals in the component stylesheets, most are component dimensions (an avatar size, a toggle track, a step circle) with exactly one user, and tokenising them would produce a hundred single-use tokens — the rule of three violated in token form."}]}