@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
@@ -0,0 +1,59 @@
1
+ {
2
+ "components": {
3
+ "components-overlay-atldialog": {
4
+ "id": "components-overlay-atldialog",
5
+ "name": "AtlDialog",
6
+ "path": "./libs/angular/src/lib/dialog/atl-dialog.stories.ts",
7
+ "stories": {
8
+ "components-overlay-atldialog--default": {
9
+ "id": "components-overlay-atldialog--default",
10
+ "name": "Default",
11
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDialog } from './atl-dialog';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDialog],\n template: `\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(true)\">\n Open Dialog\n </button>\n <atl-dialog [(open)]=\"open\" [size]=\"size\" [closeOnBackdrop]=\"closeOnBackdrop\">\n <atl-dialog-header>Confirm Action</atl-dialog-header>\n <atl-dialog-content>\n <p>\n Are you sure you want to proceed with this action? This cannot be undone.\n </p>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(false)\">\n Cancel\n </button>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Confirm\n </button>\n </atl-dialog-footer>\n </atl-dialog>`,\n})\nexport class DemoComponent {\n size = 'md';\n closeOnBackdrop = true;\n openChange(event: unknown) {}\n}",
12
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
13
+ },
14
+ "components-overlay-atldialog--pre-opened": {
15
+ "id": "components-overlay-atldialog--pre-opened",
16
+ "name": "Pre-opened (no trigger)",
17
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDialog } from './atl-dialog';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDialog],\n template: `\n <atl-dialog [(open)]=\"open\" [size]=\"size\">\n <atl-dialog-header>Pre-opened Dialog</atl-dialog-header>\n <atl-dialog-content>\n <p>This dialog is open on load.</p>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Close\n </button>\n </atl-dialog-footer>\n </atl-dialog>`,\n})\nexport class DemoComponent {\n size = 'md';\n openChange(event: unknown) {}\n}",
18
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
19
+ },
20
+ "components-overlay-atldialog--close-button-dismiss": {
21
+ "id": "components-overlay-atldialog--close-button-dismiss",
22
+ "name": "Close via header X button",
23
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDialog } from './atl-dialog';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDialog],\n template: `\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(true)\">\n Open Dialog\n </button>\n <atl-dialog [(open)]=\"open\" [size]=\"size\" [closeOnBackdrop]=\"closeOnBackdrop\">\n <atl-dialog-header>Confirm Action</atl-dialog-header>\n <atl-dialog-content>\n <p>\n Are you sure you want to proceed with this action? This cannot be undone.\n </p>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(false)\">\n Cancel\n </button>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Confirm\n </button>\n </atl-dialog-footer>\n </atl-dialog>`,\n})\nexport class DemoComponent {\n size = 'md';\n closeOnBackdrop = true;\n openChange(event: unknown) {}\n}",
24
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
25
+ },
26
+ "components-overlay-atldialog--escape-to-close": {
27
+ "id": "components-overlay-atldialog--escape-to-close",
28
+ "name": "Escape key closes dialog",
29
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDialog } from './atl-dialog';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDialog],\n template: `\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(true)\">\n Open Dialog\n </button>\n <atl-dialog [(open)]=\"open\" [size]=\"size\" [closeOnBackdrop]=\"closeOnBackdrop\">\n <atl-dialog-header>Confirm Action</atl-dialog-header>\n <atl-dialog-content>\n <p>\n Are you sure you want to proceed with this action? This cannot be undone.\n </p>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(false)\">\n Cancel\n </button>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Confirm\n </button>\n </atl-dialog-footer>\n </atl-dialog>`,\n})\nexport class DemoComponent {\n size = 'md';\n closeOnBackdrop = true;\n openChange(event: unknown) {}\n}",
30
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
31
+ },
32
+ "components-overlay-atldialog--size-variants": {
33
+ "id": "components-overlay-atldialog--size-variants",
34
+ "name": "Size Variants",
35
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDialog } from './atl-dialog';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDialog],\n template: `\n <div style=\"display: flex; gap: 0.5rem; flex-wrap: wrap;\">\n <button\n atl-button\n variant=\"outline\"\n size=\"sm\"\n (click)=\"smOpen.set(true)\">\n Small\n </button>\n <button\n atl-button\n variant=\"outline\"\n size=\"sm\"\n (click)=\"mdOpen.set(true)\">\n Medium\n </button>\n <button\n atl-button\n variant=\"outline\"\n size=\"sm\"\n (click)=\"lgOpen.set(true)\">\n Large\n </button>\n <button\n atl-button\n variant=\"outline\"\n size=\"sm\"\n (click)=\"xlOpen.set(true)\">\n Extra Large\n </button>\n <button\n atl-button\n variant=\"outline\"\n size=\"sm\"\n (click)=\"fullOpen.set(true)\">\n Full Screen\n </button>\n </div>\n <atl-dialog [(open)]=\"smOpen\" size=\"sm\">\n <atl-dialog-header>Small Dialog</atl-dialog-header>\n <atl-dialog-content>\n <p>This is a small (sm) dialog.</p>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"smOpen.set(false)\">\n Close\n </button>\n </atl-dialog-footer>\n </atl-dialog>\n <atl-dialog [(open)]=\"mdOpen\" size=\"md\">\n <atl-dialog-header>Medium Dialog</atl-dialog-header>\n <atl-dialog-content>\n <p>This is a medium (md) dialog — the default size.</p>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"mdOpen.set(false)\">\n Close\n </button>\n </atl-dialog-footer>\n </atl-dialog>\n <atl-dialog [(open)]=\"lgOpen\" size=\"lg\">\n <atl-dialog-header>Large Dialog</atl-dialog-header>\n <atl-dialog-content>\n <p>This is a large (lg) dialog.</p>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"lgOpen.set(false)\">\n Close\n </button>\n </atl-dialog-footer>\n </atl-dialog>\n <atl-dialog [(open)]=\"xlOpen\" size=\"xl\">\n <atl-dialog-header>Extra Large Dialog</atl-dialog-header>\n <atl-dialog-content>\n <p>This is an extra large (xl) dialog.</p>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"xlOpen.set(false)\">\n Close\n </button>\n </atl-dialog-footer>\n </atl-dialog>\n <atl-dialog [(open)]=\"fullOpen\" size=\"full\">\n <atl-dialog-header>Full Screen Dialog</atl-dialog-header>\n <atl-dialog-content>\n <p>This dialog fills the entire viewport.</p>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"fullOpen.set(false)\">\n Close\n </button>\n </atl-dialog-footer>\n </atl-dialog>`,\n})\nexport class DemoComponent {\n openChange(event: unknown) {}\n}",
36
+ "warning": "Incomplete snippet: `smOpen`, `mdOpen`, `lgOpen`, `xlOpen`, `fullOpen` could not be provided, since the story declares no such arg."
37
+ },
38
+ "components-overlay-atldialog--with-form": {
39
+ "id": "components-overlay-atldialog--with-form",
40
+ "name": "With Form",
41
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDialog } from './atl-dialog';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDialog],\n template: `\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(true)\">\n Open Form Dialog\n </button>\n <atl-dialog [(open)]=\"open\" [size]=\"size\">\n <atl-dialog-header>User Details</atl-dialog-header>\n <atl-dialog-content>\n <div style=\"display: flex; flex-direction: column; gap: 1rem;\">\n <div>\n <label\n style=\"display: block; margin-bottom: 0.25rem; font-size: 0.875rem; font-weight: 500;\">\n Name\n </label>\n <atl-input\n aria-label=\"Enter your name\"\n [(value)]=\"name\"\n placeholder=\"Enter your name\" />\n </div>\n <div>\n <label\n style=\"display: block; margin-bottom: 0.25rem; font-size: 0.875rem; font-weight: 500;\">\n Country\n </label>\n <atl-select\n aria-label=\"Select a country\"\n [(value)]=\"country\"\n placeholder=\"Select a country\">\n <atl-option optionValue=\"us\">United States</atl-option>\n <atl-option optionValue=\"ca\">Canada</atl-option>\n <atl-option optionValue=\"uk\">United Kingdom</atl-option>\n </atl-select>\n </div>\n </div>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(false)\">\n Cancel\n </button>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Save\n </button>\n </atl-dialog-footer>\n </atl-dialog>`,\n})\nexport class DemoComponent {\n size = 'md';\n openChange(event: unknown) {}\n}",
42
+ "warning": "Incomplete snippet: `open`, `name`, `country` could not be provided, since the story declares no such arg."
43
+ },
44
+ "components-overlay-atldialog--long-content": {
45
+ "id": "components-overlay-atldialog--long-content",
46
+ "name": "Long Content",
47
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDialog } from './atl-dialog';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDialog],\n template: `\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(true)\">\n Open Long Content Dialog\n </button>\n <atl-dialog [(open)]=\"open\" [size]=\"size\">\n <atl-dialog-header>Terms of Service</atl-dialog-header>\n <atl-dialog-content>\n <p>\n Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.\n </p>\n <p>\n Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat.\n </p>\n <p>\n Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur.\n </p>\n <p>\n Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.\n </p>\n <p>\n Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium.\n </p>\n <p>\n Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit, sed quia consequuntur.\n </p>\n <p>\n Neque porro quisquam est, qui dolorem ipsum quia dolor sit amet, consectetur, adipisci velit.\n </p>\n <p>\n Ut labore et dolore magnam aliquam quaerat voluptatem. Ut enim ad minima veniam.\n </p>\n <p>\n Quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae consequatur.\n </p>\n <p>\n At vero eos et accusamus et iusto odio dignissimos ducimus qui blanditiis praesentium.\n </p>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(false)\">\n Decline\n </button>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Accept\n </button>\n </atl-dialog-footer>\n </atl-dialog>`,\n})\nexport class DemoComponent {\n size = 'md';\n openChange(event: unknown) {}\n}",
48
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
49
+ },
50
+ "components-overlay-atldialog--no-backdrop-close": {
51
+ "id": "components-overlay-atldialog--no-backdrop-close",
52
+ "name": "No Backdrop Close",
53
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDialog } from './atl-dialog';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDialog],\n template: `\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(true)\">\n Open Dialog\n </button>\n <atl-dialog [(open)]=\"open\" [closeOnBackdrop]=\"false\">\n <atl-dialog-header>Important Decision</atl-dialog-header>\n <atl-dialog-content>\n <p>\n This dialog cannot be closed by clicking the backdrop. You must use one of the buttons below.\n </p>\n </atl-dialog-content>\n <atl-dialog-footer>\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(false)\">\n Cancel\n </button>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Confirm\n </button>\n </atl-dialog-footer>\n </atl-dialog>`,\n})\nexport class DemoComponent {\n openChange(event: unknown) {}\n}",
54
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
55
+ }
56
+ }
57
+ }
58
+ }
59
+ }
@@ -0,0 +1,59 @@
1
+ {
2
+ "components": {
3
+ "components-overlay-atldrawer": {
4
+ "id": "components-overlay-atldrawer",
5
+ "name": "AtlDrawer",
6
+ "path": "./libs/angular/src/lib/drawer/atl-drawer.stories.ts",
7
+ "stories": {
8
+ "components-overlay-atldrawer--default": {
9
+ "id": "components-overlay-atldrawer--default",
10
+ "name": "Default",
11
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDrawer } from './atl-drawer';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDrawer],\n template: `\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(true)\">\n Open Drawer\n </button>\n <atl-drawer\n [(open)]=\"open\"\n [position]=\"position\"\n [size]=\"size\"\n [closeOnBackdrop]=\"closeOnBackdrop\">\n <atl-drawer-header>Settings</atl-drawer-header>\n <atl-drawer-content>\n <p>\n Drawer content goes here. You can put any form controls or content inside.\n </p>\n </atl-drawer-content>\n <atl-drawer-footer>\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(false)\">\n Cancel\n </button>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Save\n </button>\n </atl-drawer-footer>\n </atl-drawer>`,\n})\nexport class DemoComponent {\n position = 'right';\n size = 'md';\n closeOnBackdrop = true;\n openChange(event: unknown) {}\n}",
12
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
13
+ },
14
+ "components-overlay-atldrawer--pre-opened": {
15
+ "id": "components-overlay-atldrawer--pre-opened",
16
+ "name": "Pre-opened (no trigger)",
17
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDrawer } from './atl-drawer';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDrawer],\n template: `\n <atl-drawer [(open)]=\"open\" [position]=\"position\" [size]=\"size\">\n <atl-drawer-header>Pre-opened Drawer</atl-drawer-header>\n <atl-drawer-content>\n <p>This drawer is open on load.</p>\n </atl-drawer-content>\n <atl-drawer-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Close\n </button>\n </atl-drawer-footer>\n </atl-drawer>`,\n})\nexport class DemoComponent {\n position = 'right';\n size = 'md';\n openChange(event: unknown) {}\n}",
18
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
19
+ },
20
+ "components-overlay-atldrawer--left": {
21
+ "id": "components-overlay-atldrawer--left",
22
+ "name": "Left",
23
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDrawer } from './atl-drawer';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDrawer],\n template: `\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(true)\">\n Open Left Drawer\n </button>\n <atl-drawer [(open)]=\"open\" position=\"left\" [size]=\"size\">\n <atl-drawer-header>Navigation</atl-drawer-header>\n <atl-drawer-content>\n <p>Left-side navigation drawer.</p>\n </atl-drawer-content>\n <atl-drawer-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Close\n </button>\n </atl-drawer-footer>\n </atl-drawer>`,\n})\nexport class DemoComponent {\n size = 'md';\n openChange(event: unknown) {}\n}",
24
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
25
+ },
26
+ "components-overlay-atldrawer--top": {
27
+ "id": "components-overlay-atldrawer--top",
28
+ "name": "Top",
29
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDrawer } from './atl-drawer';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDrawer],\n template: `\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(true)\">\n Open Top Drawer\n </button>\n <atl-drawer [(open)]=\"open\" position=\"top\" [size]=\"size\">\n <atl-drawer-header>Filters</atl-drawer-header>\n <atl-drawer-content>\n <p>Top panel for filters or search.</p>\n </atl-drawer-content>\n <atl-drawer-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Apply\n </button>\n </atl-drawer-footer>\n </atl-drawer>`,\n})\nexport class DemoComponent {\n size = 'md';\n openChange(event: unknown) {}\n}",
30
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
31
+ },
32
+ "components-overlay-atldrawer--bottom": {
33
+ "id": "components-overlay-atldrawer--bottom",
34
+ "name": "Bottom",
35
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDrawer } from './atl-drawer';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDrawer],\n template: `\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(true)\">\n Open Bottom Drawer\n </button>\n <atl-drawer [(open)]=\"open\" position=\"bottom\" [size]=\"size\">\n <atl-drawer-header>Action Sheet</atl-drawer-header>\n <atl-drawer-content>\n <p>Mobile-style action sheet from the bottom.</p>\n </atl-drawer-content>\n <atl-drawer-footer>\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(false)\">\n Cancel\n </button>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Confirm\n </button>\n </atl-drawer-footer>\n </atl-drawer>`,\n})\nexport class DemoComponent {\n size = 'md';\n openChange(event: unknown) {}\n}",
36
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
37
+ },
38
+ "components-overlay-atldrawer--size-variants": {
39
+ "id": "components-overlay-atldrawer--size-variants",
40
+ "name": "Size Variants",
41
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDrawer } from './atl-drawer';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDrawer],\n template: `\n <div style=\"display: flex; gap: 0.5rem; flex-wrap: wrap;\">\n <button\n atl-button\n variant=\"outline\"\n size=\"sm\"\n (click)=\"smOpen.set(true)\">\n Small\n </button>\n <button\n atl-button\n variant=\"outline\"\n size=\"sm\"\n (click)=\"mdOpen.set(true)\">\n Medium\n </button>\n <button\n atl-button\n variant=\"outline\"\n size=\"sm\"\n (click)=\"lgOpen.set(true)\">\n Large\n </button>\n <button\n atl-button\n variant=\"outline\"\n size=\"sm\"\n (click)=\"fullOpen.set(true)\">\n Full\n </button>\n </div>\n <atl-drawer [(open)]=\"smOpen\" size=\"sm\">\n <atl-drawer-header>Small Drawer</atl-drawer-header>\n <atl-drawer-content>\n <p>Width: 20rem</p>\n </atl-drawer-content>\n <atl-drawer-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"smOpen.set(false)\">\n Close\n </button>\n </atl-drawer-footer>\n </atl-drawer>\n <atl-drawer [(open)]=\"mdOpen\" size=\"md\">\n <atl-drawer-header>Medium Drawer</atl-drawer-header>\n <atl-drawer-content>\n <p>Width: 28rem (default)</p>\n </atl-drawer-content>\n <atl-drawer-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"mdOpen.set(false)\">\n Close\n </button>\n </atl-drawer-footer>\n </atl-drawer>\n <atl-drawer [(open)]=\"lgOpen\" size=\"lg\">\n <atl-drawer-header>Large Drawer</atl-drawer-header>\n <atl-drawer-content>\n <p>Width: 40rem</p>\n </atl-drawer-content>\n <atl-drawer-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"lgOpen.set(false)\">\n Close\n </button>\n </atl-drawer-footer>\n </atl-drawer>\n <atl-drawer [(open)]=\"fullOpen\" size=\"full\">\n <atl-drawer-header>Full Drawer</atl-drawer-header>\n <atl-drawer-content>\n <p>Width: 100vw</p>\n </atl-drawer-content>\n <atl-drawer-footer>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"fullOpen.set(false)\">\n Close\n </button>\n </atl-drawer-footer>\n </atl-drawer>`,\n})\nexport class DemoComponent {\n openChange(event: unknown) {}\n}",
42
+ "warning": "Incomplete snippet: `smOpen`, `mdOpen`, `lgOpen`, `fullOpen` could not be provided, since the story declares no such arg."
43
+ },
44
+ "components-overlay-atldrawer--no-backdrop-close": {
45
+ "id": "components-overlay-atldrawer--no-backdrop-close",
46
+ "name": "No Backdrop Close",
47
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDrawer } from './atl-drawer';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDrawer],\n template: `\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(true)\">\n Open Drawer\n </button>\n <atl-drawer [(open)]=\"open\" [closeOnBackdrop]=\"false\">\n <atl-drawer-header>Required Action</atl-drawer-header>\n <atl-drawer-content>\n <p>\n This drawer cannot be closed by clicking the backdrop. Use the buttons below.\n </p>\n </atl-drawer-content>\n <atl-drawer-footer>\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(false)\">\n Cancel\n </button>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Confirm\n </button>\n </atl-drawer-footer>\n </atl-drawer>`,\n})\nexport class DemoComponent {\n openChange(event: unknown) {}\n}",
48
+ "warning": "Incomplete snippet: `open` could not be provided, since the story declares no such arg."
49
+ },
50
+ "components-overlay-atldrawer--with-form": {
51
+ "id": "components-overlay-atldrawer--with-form",
52
+ "name": "With Form",
53
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlDrawer } from './atl-drawer';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlDrawer],\n template: `\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(true)\">\n Edit Profile\n </button>\n <atl-drawer [(open)]=\"open\" [size]=\"size\">\n <atl-drawer-header>Edit Profile</atl-drawer-header>\n <atl-drawer-content>\n <div style=\"display: flex; flex-direction: column; gap: 1rem;\">\n <div>\n <label\n style=\"display: block; margin-bottom: 0.25rem; font-size: 0.875rem; font-weight: 500;\">\n Name\n </label>\n <atl-input\n aria-label=\"Your name\"\n [(value)]=\"name\"\n placeholder=\"Your name\" />\n </div>\n <div>\n <label\n style=\"display: block; margin-bottom: 0.25rem; font-size: 0.875rem; font-weight: 500;\">\n Email\n </label>\n <atl-input\n aria-label=\"you@example.com\"\n type=\"email\"\n [(value)]=\"email\"\n placeholder=\"you@example.com\" />\n </div>\n </div>\n </atl-drawer-content>\n <atl-drawer-footer>\n <button\n atl-button\n variant=\"outline\"\n (click)=\"open.set(false)\">\n Cancel\n </button>\n <button\n atl-button\n variant=\"primary\"\n (click)=\"open.set(false)\">\n Save Changes\n </button>\n </atl-drawer-footer>\n </atl-drawer>`,\n})\nexport class DemoComponent {\n size = 'md';\n openChange(event: unknown) {}\n}",
54
+ "warning": "Incomplete snippet: `open`, `name`, `email` could not be provided, since the story declares no such arg."
55
+ }
56
+ }
57
+ }
58
+ }
59
+ }
@@ -0,0 +1,56 @@
1
+ {
2
+ "components": {
3
+ "components-overlay-atltoast": {
4
+ "id": "components-overlay-atltoast",
5
+ "name": "AtlToast",
6
+ "path": "./libs/angular/src/lib/toast/atl-toast.stories.ts",
7
+ "stories": {
8
+ "components-overlay-atltoast--default": {
9
+ "id": "components-overlay-atltoast--default",
10
+ "name": "Default",
11
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlToast } from './atl-toast';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlToast],\n template: `<toast-story-wrapper />`,\n})\nexport class DemoComponent {}"
12
+ },
13
+ "components-overlay-atltoast--all-variants": {
14
+ "id": "components-overlay-atltoast--all-variants",
15
+ "name": "All Variants",
16
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlToast } from './atl-toast';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlToast],\n template: `<toast-all-variants-wrapper />`,\n})\nexport class DemoComponent {}"
17
+ },
18
+ "components-overlay-atltoast--success": {
19
+ "id": "components-overlay-atltoast--success",
20
+ "name": "Success",
21
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlToast } from './atl-toast';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlToast],\n template: `<toast-story-wrapper [variant]=\"'success'\" />`,\n})\nexport class DemoComponent {}"
22
+ },
23
+ "components-overlay-atltoast--warning": {
24
+ "id": "components-overlay-atltoast--warning",
25
+ "name": "Warning",
26
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlToast } from './atl-toast';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlToast],\n template: `<toast-story-wrapper [variant]=\"'warning'\" />`,\n})\nexport class DemoComponent {}"
27
+ },
28
+ "components-overlay-atltoast--danger": {
29
+ "id": "components-overlay-atltoast--danger",
30
+ "name": "Danger",
31
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlToast } from './atl-toast';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlToast],\n template: `<toast-story-wrapper [variant]=\"'danger'\" />`,\n})\nexport class DemoComponent {}"
32
+ },
33
+ "components-overlay-atltoast--info": {
34
+ "id": "components-overlay-atltoast--info",
35
+ "name": "Info",
36
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlToast } from './atl-toast';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlToast],\n template: `<toast-story-wrapper [variant]=\"'info'\" />`,\n})\nexport class DemoComponent {}"
37
+ },
38
+ "components-overlay-atltoast--auto-dismiss": {
39
+ "id": "components-overlay-atltoast--auto-dismiss",
40
+ "name": "Auto Dismiss",
41
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlToast } from './atl-toast';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlToast],\n template: `<toast-auto-dismiss-wrapper />`,\n})\nexport class DemoComponent {}"
42
+ },
43
+ "components-overlay-atltoast--persistent": {
44
+ "id": "components-overlay-atltoast--persistent",
45
+ "name": "Persistent",
46
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlToast } from './atl-toast';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlToast],\n template: `<toast-persistent-wrapper />`,\n})\nexport class DemoComponent {}"
47
+ },
48
+ "components-overlay-atltoast--playground": {
49
+ "id": "components-overlay-atltoast--playground",
50
+ "name": "Playground",
51
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlToast } from './atl-toast';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlToast],\n template: `\n <toast-story-wrapper\n [variant]=\"variant\"\n [duration]=\"duration\"\n [dismissible]=\"dismissible\"\n [message]=\"message\"\n [position]=\"position\" />`,\n})\nexport class DemoComponent {\n variant = 'default';\n dismissible = true;\n message = 'Playground toast notification.';\n position = 'bottom-right';\n duration = 5000;\n}"
52
+ }
53
+ }
54
+ }
55
+ }
56
+ }
@@ -0,0 +1,42 @@
1
+ {
2
+ "components": {
3
+ "components-overlay-atltooltip": {
4
+ "id": "components-overlay-atltooltip",
5
+ "name": "AtlTooltip",
6
+ "path": "./libs/angular/src/lib/tooltip/atl-tooltip.stories.ts",
7
+ "stories": {
8
+ "components-overlay-atltooltip--default": {
9
+ "id": "components-overlay-atltooltip--default",
10
+ "name": "Default",
11
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlTooltip } from './atl-tooltip';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlTooltip],\n template: `\n <div style=\"padding: 4rem; display: flex; justify-content: center;\">\n <button atl-button atlTooltip=\"Save your changes\">Save</button>\n </div>`,\n})\nexport class DemoComponent {}"
12
+ },
13
+ "components-overlay-atltooltip--positions": {
14
+ "id": "components-overlay-atltooltip--positions",
15
+ "name": "Positions",
16
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlTooltip } from './atl-tooltip';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlTooltip],\n template: `\n <div\n style=\"padding: 6rem; display: flex; gap: 2rem; justify-content: center; flex-wrap: wrap;\">\n <button\n atl-button\n atlTooltip=\"Tooltip above\"\n atlTooltipPosition=\"above\">\n Above\n </button>\n <button\n atl-button\n atlTooltip=\"Tooltip below\"\n atlTooltipPosition=\"below\">\n Below\n </button>\n <button\n atl-button\n atlTooltip=\"Tooltip left\"\n atlTooltipPosition=\"left\">\n Left\n </button>\n <button\n atl-button\n atlTooltip=\"Tooltip right\"\n atlTooltipPosition=\"right\">\n Right\n </button>\n </div>`,\n})\nexport class DemoComponent {}"
17
+ },
18
+ "components-overlay-atltooltip--long-text": {
19
+ "id": "components-overlay-atltooltip--long-text",
20
+ "name": "Long Text",
21
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlTooltip } from './atl-tooltip';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlTooltip],\n template: `\n <div style=\"padding: 4rem; display: flex; justify-content: center;\">\n <button\n atl-button\n atlTooltip=\"This is a longer tooltip message that will wrap across multiple lines when it exceeds the maximum width of the tooltip container.\">\n Hover for details\n </button>\n </div>`,\n})\nexport class DemoComponent {}"
22
+ },
23
+ "components-overlay-atltooltip--disabled": {
24
+ "id": "components-overlay-atltooltip--disabled",
25
+ "name": "Disabled",
26
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlTooltip } from './atl-tooltip';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlTooltip],\n template: `\n <div style=\"padding: 4rem; display: flex; gap: 2rem; justify-content: center;\">\n <button atl-button atlTooltip=\"This tooltip is active\">Enabled</button>\n <button\n atl-button\n atlTooltip=\"This tooltip is hidden\"\n [atlTooltipDisabled]=\"true\">\n Disabled\n </button>\n </div>`,\n})\nexport class DemoComponent {}"
27
+ },
28
+ "components-overlay-atltooltip--custom-delay": {
29
+ "id": "components-overlay-atltooltip--custom-delay",
30
+ "name": "Custom Delay",
31
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlTooltip } from './atl-tooltip';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlTooltip],\n template: `\n <div style=\"padding: 4rem; display: flex; gap: 2rem; justify-content: center;\">\n <button\n atl-button\n atlTooltip=\"No delay\"\n [atlTooltipShowDelay]=\"0\">\n Instant\n </button>\n <button atl-button atlTooltip=\"300ms delay (default)\">Default</button>\n <button\n atl-button\n atlTooltip=\"1 second delay\"\n [atlTooltipShowDelay]=\"1000\">\n Slow\n </button>\n </div>`,\n})\nexport class DemoComponent {}"
32
+ },
33
+ "components-overlay-atltooltip--playground": {
34
+ "id": "components-overlay-atltooltip--playground",
35
+ "name": "Playground",
36
+ "snippet": "import { Component } from '@angular/core';\nimport { AtlTooltip } from './atl-tooltip';\n\n@Component({\n selector: 'app-demo',\n imports: [AtlTooltip],\n template: `\n <div style=\"padding: 6rem; display: flex; justify-content: center;\">\n <button\n atl-button\n [atlTooltip]=\"tooltipText\"\n [atlTooltipPosition]=\"atlTooltipPosition\"\n [atlTooltipShowDelay]=\"atlTooltipShowDelay\"\n [atlTooltipHideDelay]=\"atlTooltipHideDelay\"\n [atlTooltipDisabled]=\"atlTooltipDisabled\">\n Hover me\n </button>\n </div>`,\n})\nexport class DemoComponent {\n atlTooltipPosition = 'above';\n atlTooltipShowDelay = 300;\n atlTooltipHideDelay = 0;\n atlTooltipDisabled = false;\n}",
37
+ "warning": "Incomplete snippet: `tooltipText` could not be provided, since the story declares no such arg."
38
+ }
39
+ }
40
+ }
41
+ }
42
+ }
@@ -0,0 +1,39 @@
1
+ {
2
+ "components": {
3
+ "cookbook": {
4
+ "id": "cookbook",
5
+ "name": "Cookbook",
6
+ "path": "./libs/angular/src/lib/cookbook.stories.ts",
7
+ "stories": {
8
+ "cookbook--login-form": {
9
+ "id": "cookbook--login-form",
10
+ "name": "Login Form"
11
+ },
12
+ "cookbook--login-form-with-validation-errors": {
13
+ "id": "cookbook--login-form-with-validation-errors",
14
+ "name": "Login Form / With Validation Errors"
15
+ },
16
+ "cookbook--settings-page": {
17
+ "id": "cookbook--settings-page",
18
+ "name": "Settings Page"
19
+ },
20
+ "cookbook--confirmation-dialog": {
21
+ "id": "cookbook--confirmation-dialog",
22
+ "name": "Confirmation Dialog"
23
+ },
24
+ "cookbook--data-list-with-actions": {
25
+ "id": "cookbook--data-list-with-actions",
26
+ "name": "Data List with Actions"
27
+ },
28
+ "cookbook--notification-center": {
29
+ "id": "cookbook--notification-center",
30
+ "name": "Notification Center"
31
+ },
32
+ "cookbook--management-dashboard": {
33
+ "id": "cookbook--management-dashboard",
34
+ "name": "Management Dashboard"
35
+ }
36
+ }
37
+ }
38
+ }
39
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "components": {
3
+ "showcase-all-components": {
4
+ "id": "showcase-all-components",
5
+ "name": "ShowcaseAllComponent",
6
+ "path": "./libs/angular/src/lib/showcase/atl-showcase.stories.ts",
7
+ "stories": {
8
+ "showcase-all-components--all-components": {
9
+ "id": "showcase-all-components--all-components",
10
+ "name": "All Components",
11
+ "snippet": "import { Component } from '@angular/core';\n\n@Component({\n selector: 'app-demo',\n imports: [ShowcaseAllComponent],\n template: `<atl-showcase-all />`,\n})\nexport class DemoComponent {}",
12
+ "warning": "ShowcaseAllComponent is declared in the story file, so the snippet references it without importing it."
13
+ }
14
+ }
15
+ }
16
+ }
17
+ }
@@ -0,0 +1,17 @@
1
+ {
2
+ "components": {
3
+ "showcase-kitchen-sink": {
4
+ "id": "showcase-kitchen-sink",
5
+ "name": "KitchenSinkDemoComponent",
6
+ "path": "./libs/angular/src/lib/kitchen-sink.stories.ts",
7
+ "stories": {
8
+ "showcase-kitchen-sink--default": {
9
+ "id": "showcase-kitchen-sink--default",
10
+ "name": "Default",
11
+ "snippet": "import { Component } from '@angular/core';\n\n@Component({\n selector: 'app-demo',\n imports: [KitchenSinkDemoComponent],\n template: `<kitchen-sink-demo />`,\n})\nexport class DemoComponent {}",
12
+ "warning": "KitchenSinkDemoComponent is declared in the story file, so the snippet references it without importing it."
13
+ }
14
+ }
15
+ }
16
+ }
17
+ }
@@ -0,0 +1,29 @@
1
+ // Server `instructions`: the rules that reach the agent before it calls any tool (the
2
+ // `initialize` response). Layers contribute their own sections (see layers.mjs); a version note
3
+ // goes first so a mismatch is the first thing read.
4
+
5
+ /**
6
+ * Hard rules of the base layer. Every claim here was checked against the repo: the tokens import
7
+ * is the one libs/angular/README.md prescribes, component CSS comes in through each component's
8
+ * own `styleUrl`.
9
+ */
10
+ export const API_RULES = `## Atelier UI (@atelier-ui/angular)
11
+
12
+ Fixed rules for the Angular library "@atelier-ui/angular":
13
+
14
+ 1. Include the design tokens once, in the app's global stylesheet: \`@import '@atelier-ui/angular/styles/tokens.css';\`. Components bring their own CSS, but without the tokens they render without colours, spacing and type.
15
+ 2. Style only with the library's \`--ui-*\` custom properties. Never write raw colour values (hex, rgb, hsl) and never invent a token name; a token that no docs page shows does not exist.
16
+ 3. Call docs-list and docs-show before writing code that uses a component. Use only the inputs and outputs docs-show lists; never guess ids or props.
17
+ 4. Write no CSS for Atelier components and invent no CSS classes. Choose a documented variant or size instead.
18
+ 5. Components are standalone: import the class docs-show names (for example \`AtlButton\`) from "@atelier-ui/angular" into the consuming component's \`imports\`.`;
19
+
20
+ /**
21
+ * @param {{ versionNote?: string | null, layers: Array<{ instructions?: string[] }> }} input
22
+ * @returns {string}
23
+ */
24
+ export function buildInstructions({ versionNote, layers }) {
25
+ const sections = [];
26
+ if (versionNote) sections.push(versionNote);
27
+ for (const layer of layers) sections.push(...(layer.instructions ?? []));
28
+ return sections.join('\n\n');
29
+ }
@@ -0,0 +1,24 @@
1
+ // Reads a knowledge file of the shipped snapshot (see scripts/build-knowledge.mjs). Cached per
2
+ // path: the snapshot cannot change under a running server.
3
+ import { readFileSync } from 'node:fs';
4
+ import { join } from 'node:path';
5
+
6
+ const cache = new Map();
7
+
8
+ /**
9
+ * @param {string} root snapshot root
10
+ * @param {'components' | 'tokens' | 'patterns'} name
11
+ */
12
+ export function loadKnowledge(root, name) {
13
+ const file = join(root, 'knowledge', `${name}.json`);
14
+ if (!cache.has(file)) {
15
+ try {
16
+ cache.set(file, JSON.parse(readFileSync(file, 'utf8')));
17
+ } catch (err) {
18
+ throw new Error(
19
+ `Knowledge file "${file}" cannot be read (${err.message}). Rebuild the snapshot: npm run build -w libs/mcp.`,
20
+ );
21
+ }
22
+ }
23
+ return cache.get(file);
24
+ }
@@ -0,0 +1,77 @@
1
+ // L5 `composition`: which arrangements of components are wrong, from the cookbook patterns. Like
2
+ // L1 it is delivered inside `docs-show`, not as a tool: an agent that is about to nest a tab group
3
+ // in a tab group has opened the tab group's page, and that page is where the warning has to be.
4
+ // A pattern spans several components, so each component's page lists the patterns it appears in.
5
+ //
6
+ // A component that appears in more than SUBJECT_MAX patterns (AtlButton, AtlCard) is a building
7
+ // block, not the subject of any of them; a pattern's warnings do not belong on its page, so it gets
8
+ // one index line per pattern. The cut is derived from the data, nothing names a component here.
9
+ import { COMPONENT_PAYLOAD } from './layer-purpose.mjs';
10
+ import { loadKnowledge } from './knowledge.mjs';
11
+ import { SNAPSHOT_ROOT } from './manifest-provider.mjs';
12
+
13
+ export const SUBJECT_MAX = 2;
14
+
15
+ export const COMPOSITION_INSTRUCTIONS = `## Composing several components
16
+
17
+ A component page from docs-show can end with "Composition patterns": the cookbook patterns the component appears in, with "Not for" (layouts the pattern is the wrong choice for, and what to use instead) and "Common mistakes". Read them before you arrange components into a screen. A layout listed under "Not for" is ruled out: use the alternative it names, and say so. Do not nest a component in another of its own kind unless a page shows it.`;
18
+
19
+ /**
20
+ * @param {{ id: string, title: string, components: string[], whenNotToUse: string[], pitfalls: string[] }} pattern
21
+ * @param {string} name the component whose page is being rendered
22
+ * @param {boolean} detailed
23
+ */
24
+ function renderPattern(pattern, name, detailed) {
25
+ const others = pattern.components.filter((component) => component !== name);
26
+ const head = `- **${pattern.title}**${others.length > 0 ? ` (with ${others.join(', ')})` : ''}`;
27
+ if (!detailed) return head;
28
+ const lines = [head];
29
+ if (pattern.whenNotToUse.length > 0)
30
+ lines.push(' Not for:', ...pattern.whenNotToUse.map((s) => ` - ${s}`));
31
+ if (pattern.pitfalls.length > 0)
32
+ lines.push(
33
+ ' Common mistakes:',
34
+ ...pattern.pitfalls.map((s) => ` - ${s}`),
35
+ );
36
+ return lines.join('\n');
37
+ }
38
+
39
+ /**
40
+ * @param {Array<{ id: string, title: string, components: string[], whenNotToUse: string[], pitfalls: string[] }>} patterns
41
+ * @param {string} name component name, for example AtlDialog
42
+ * @returns {string} the block to append, or '' when the component is in no pattern
43
+ */
44
+ export function renderComposition(patterns, name) {
45
+ const using = patterns.filter((pattern) => pattern.components.includes(name));
46
+ if (using.length === 0) return '';
47
+ const detailed = using.length <= SUBJECT_MAX;
48
+ return [
49
+ '**Composition patterns** (cookbook patterns this component appears in)',
50
+ ...using.map((pattern) => renderPattern(pattern, name, detailed)),
51
+ ].join('\n');
52
+ }
53
+
54
+ /**
55
+ * @param {{ root?: string }} [options] `root`: snapshot root, a parameter for tests
56
+ */
57
+ export function createCompositionLayer({ root = SNAPSHOT_ROOT } = {}) {
58
+ return {
59
+ id: 'composition',
60
+ summary:
61
+ 'cookbook patterns, their wrong-choice cases and pitfalls appended to the docs-show page of each component they use (L5)',
62
+ instructions: [COMPOSITION_INSTRUCTIONS],
63
+ transformManifest(manifestPath, text) {
64
+ if (!COMPONENT_PAYLOAD.test(manifestPath)) return text;
65
+ const { patterns } = loadKnowledge(root, 'patterns');
66
+ const shard = JSON.parse(text);
67
+ for (const component of Object.values(shard.components ?? {})) {
68
+ const block = renderComposition(patterns, component.name);
69
+ if (!block) continue;
70
+ component.description = [component.description, block]
71
+ .filter(Boolean)
72
+ .join('\n\n');
73
+ }
74
+ return JSON.stringify(shard);
75
+ },
76
+ };
77
+ }
@@ -0,0 +1,70 @@
1
+ // L1 `purpose`: when to use which component. Delivered by enriching the description that
2
+ // `docs-show` already prints, not by a new tool: the agent has to open a component's page before
3
+ // it writes code with it (API_RULES, rule 3), and that is the moment the "not for this" matters.
4
+ // The enrichment happens one level below `@storybook/mcp`, in the manifest provider: the docgen
5
+ // shard a component's page is built from gets a guidance block appended to its description. The
6
+ // first lines (what `docs-list` shows, and the purpose from ADR-0176) stay where they were.
7
+ import { loadKnowledge } from './knowledge.mjs';
8
+ import { SNAPSHOT_ROOT } from './manifest-provider.mjs';
9
+
10
+ export const PURPOSE_INSTRUCTIONS = `## Choosing a component
11
+
12
+ Each component page from docs-show ends its description with "When to use", "When not to use" and "Related". Read these before you pick a component for a role in the UI. A "when not to use" entry outranks a name or an input list that looks like a fit: if the role you need is listed there, use what it names instead, or plain HTML, and say so. Do not bend a component to a job its page rules out.`;
13
+
14
+ // Both carry `{ components: { <id>: { name, description } } }`, and `@storybook/mcp` lets the
15
+ // manifest entry's description win over the docgen shard's, so both must be enriched.
16
+ export const COMPONENT_PAYLOAD =
17
+ /(?:services\/core\/docgen\/[^/]+|manifests\/components)\.json$/;
18
+
19
+ /** @param {{ whenToUse: string[], whenNotToUse: Array<{ statement: string, useInstead?: string }>, related: string[] }} entry */
20
+ export function renderGuidance(entry) {
21
+ const sections = [];
22
+ if (entry.whenToUse.length > 0) {
23
+ sections.push(
24
+ ['**When to use**', ...entry.whenToUse.map((item) => `- ${item}`)].join(
25
+ '\n',
26
+ ),
27
+ );
28
+ }
29
+ if (entry.whenNotToUse.length > 0) {
30
+ sections.push(
31
+ [
32
+ '**When not to use**',
33
+ ...entry.whenNotToUse.map(
34
+ ({ statement, useInstead }) =>
35
+ `- ${statement}${useInstead ? ` Use instead: ${useInstead}` : ''}`,
36
+ ),
37
+ ].join('\n'),
38
+ );
39
+ }
40
+ if (entry.related.length > 0)
41
+ sections.push(`**Related:** ${entry.related.join(', ')}`);
42
+ return sections.join('\n\n');
43
+ }
44
+
45
+ /**
46
+ * @param {{ root?: string }} [options] `root`: snapshot root, a parameter for tests
47
+ */
48
+ export function createPurposeLayer({ root = SNAPSHOT_ROOT } = {}) {
49
+ return {
50
+ id: 'purpose',
51
+ summary:
52
+ 'when-to-use, anti-patterns and related components appended to each docs-show page (L1)',
53
+ instructions: [PURPOSE_INSTRUCTIONS],
54
+ transformManifest(manifestPath, text) {
55
+ if (!COMPONENT_PAYLOAD.test(manifestPath)) return text;
56
+ const knowledge = loadKnowledge(root, 'components');
57
+ const shard = JSON.parse(text);
58
+ for (const component of Object.values(shard.components ?? {})) {
59
+ const entry = knowledge[component.name];
60
+ if (!entry) continue;
61
+ const guidance = renderGuidance(entry);
62
+ if (!guidance) continue;
63
+ component.description = [component.description, guidance]
64
+ .filter(Boolean)
65
+ .join('\n\n');
66
+ }
67
+ return JSON.stringify(shard);
68
+ },
69
+ };
70
+ }