@supersoniks/concorde 5.1.1 → 5.1.3-immutable.1

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 (459) hide show
  1. package/.agents/skills/concorde-docs/SKILL.md +153 -0
  2. package/.agents/skills/{concorde-component-docs/template.md → concorde-docs/templates/component.md} +6 -2
  3. package/.agents/skills/concorde-docs/templates/decorator.md +43 -0
  4. package/.agents/skills/concorde-docs/templates/guide.md +25 -0
  5. package/.claude/skills +1 -0
  6. package/.github/workflows/ci.yml +21 -0
  7. package/.github-export-ignore +30 -0
  8. package/CONTRIBUTING.md +59 -0
  9. package/DEV.md +54 -0
  10. package/LICENSE +21 -0
  11. package/OPEN_SOURCE_CHECKPOINT.md +133 -0
  12. package/README.md +4 -4
  13. package/ai/README.md +29 -41
  14. package/ai/skills/concorde/SKILL.md +54 -324
  15. package/ai/skills/concorde/rules/composition.md +32 -0
  16. package/ai/skills/concorde/rules/data.md +47 -0
  17. package/ai/skills/concorde/rules/http.md +25 -0
  18. package/ai/skills/concorde/rules/lists-forms.md +35 -0
  19. package/ai/skills/concorde/rules/styling.md +46 -0
  20. package/ai/skills/concorde/rules/troubleshooting.md +45 -0
  21. package/build-infos.json +1 -1
  22. package/concorde-core.bundle.js +177 -177
  23. package/concorde-core.es.js +4993 -4833
  24. package/custom-elements-manifest.public.config.mjs +8 -0
  25. package/{.tmp-cem/custom-elements.json → custom-elements.json} +11758 -8904
  26. package/dist/concorde-core.bundle.js +177 -177
  27. package/dist/concorde-core.es.js +4993 -4833
  28. package/dist/docs-mock-api-sw.js +58 -223
  29. package/dist/docs-mock-api-sw.js.map +4 -4
  30. package/dist/img/concorde/plane_01.jpg +0 -0
  31. package/dist/img/concorde/plane_02.jpg +0 -0
  32. package/dist/img/concorde/plane_03.jpg +0 -0
  33. package/dist/img/concorde/plane_04.jpg +0 -0
  34. package/dist/img/concorde/plane_05.jpg +0 -0
  35. package/dist/img/concorde/plane_06.jpg +0 -0
  36. package/dist/img/concorde/plane_07.jpg +0 -0
  37. package/dist/img/concorde/plane_08.jpg +0 -0
  38. package/dist/img/concorde/plane_09.jpg +0 -0
  39. package/dist/img/concorde/plane_10.jpg +0 -0
  40. package/dist/img/concorde/plane_11.jpg +0 -0
  41. package/dist/img/concorde/plane_12.jpg +0 -0
  42. package/dist/img/concorde/plane_13.jpg +0 -0
  43. package/dist/img/og-concorde.jpg +0 -0
  44. package/dist/robots.txt +11 -10
  45. package/docs/assets/index-D_alEsng.js +12122 -0
  46. package/docs/crawl/core/components/functional/date/date.html +190 -0
  47. package/docs/crawl/core/components/functional/fetch/fetch.html +109 -0
  48. package/docs/crawl/core/components/functional/if/if.html +27 -0
  49. package/docs/crawl/core/components/functional/jsonata/jsonata.html +79 -0
  50. package/docs/crawl/core/components/functional/list/list.html +70 -0
  51. package/docs/crawl/core/components/functional/mix/mix.html +45 -0
  52. package/docs/crawl/core/components/functional/queue/queue.html +96 -0
  53. package/docs/crawl/core/components/functional/router/router.html +106 -0
  54. package/docs/crawl/core/components/functional/sdui/sdui-extension-points.html +126 -0
  55. package/docs/crawl/core/components/functional/sdui/sdui.html +368 -0
  56. package/docs/crawl/core/components/functional/states/states.html +66 -0
  57. package/docs/crawl/core/components/functional/submit/submit.html +160 -0
  58. package/docs/crawl/core/components/functional/subscriber/subscriber.html +67 -0
  59. package/docs/crawl/core/components/functional/value/value.html +51 -0
  60. package/docs/crawl/core/components/ui/alert/alert.html +211 -0
  61. package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +131 -0
  62. package/docs/crawl/core/components/ui/badge/badge.html +197 -0
  63. package/docs/crawl/core/components/ui/button/button.html +150 -0
  64. package/docs/crawl/core/components/ui/captcha/captcha.html +112 -0
  65. package/docs/crawl/core/components/ui/card/card.html +253 -0
  66. package/docs/crawl/core/components/ui/divider/divider.html +144 -0
  67. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +73 -0
  68. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +266 -0
  69. package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +122 -0
  70. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +121 -0
  71. package/docs/crawl/core/components/ui/form/input/input.html +109 -0
  72. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +38 -0
  73. package/docs/crawl/core/components/ui/form/radio/radio.html +56 -0
  74. package/docs/crawl/core/components/ui/form/select/select.html +73 -0
  75. package/docs/crawl/core/components/ui/form/switch/switch.html +56 -0
  76. package/docs/crawl/core/components/ui/form/textarea/textarea.html +59 -0
  77. package/docs/crawl/core/components/ui/group/group.html +104 -0
  78. package/docs/crawl/core/components/ui/icon/icon.html +222 -0
  79. package/docs/crawl/core/components/ui/image/image.html +298 -0
  80. package/docs/crawl/core/components/ui/link/link.html +100 -0
  81. package/docs/crawl/core/components/ui/loader/loader.html +124 -0
  82. package/docs/crawl/core/components/ui/menu/menu.html +394 -0
  83. package/docs/crawl/core/components/ui/modal/modal.html +342 -0
  84. package/docs/crawl/core/components/ui/pop/pop.html +296 -0
  85. package/docs/crawl/core/components/ui/progress/progress.html +131 -0
  86. package/docs/crawl/core/components/ui/table/table.html +545 -0
  87. package/docs/crawl/core/components/ui/theme/theme.html +131 -0
  88. package/docs/crawl/core/components/ui/toast/toast.html +233 -0
  89. package/docs/crawl/core/components/ui/tooltip/tooltip.html +140 -0
  90. package/docs/crawl/docs/_core-concept/dataFlow.html +177 -0
  91. package/docs/crawl/docs/_core-concept/overview.html +66 -0
  92. package/docs/crawl/docs/_core-concept/subscriber.html +75 -0
  93. package/docs/crawl/docs/_decorators/ancestor-attribute.html +117 -0
  94. package/docs/crawl/docs/_decorators/auto-subscribe.html +202 -0
  95. package/docs/crawl/docs/_decorators/bind.html +141 -0
  96. package/docs/crawl/docs/_decorators/get.html +149 -0
  97. package/docs/crawl/docs/_decorators/handle.html +165 -0
  98. package/docs/crawl/docs/_decorators/on-assign.html +355 -0
  99. package/docs/crawl/docs/_decorators/patch.html +78 -0
  100. package/docs/crawl/docs/_decorators/post.html +139 -0
  101. package/docs/crawl/docs/_decorators/publish.html +61 -0
  102. package/docs/crawl/docs/_decorators/put.html +78 -0
  103. package/docs/crawl/docs/_decorators/subscribe.html +109 -0
  104. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +137 -0
  105. package/docs/crawl/docs/_directives/sub.html +93 -0
  106. package/docs/crawl/docs/_getting-started/ai-agents.html +173 -0
  107. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +100 -0
  108. package/docs/crawl/docs/_getting-started/concorde-outside.html +58 -0
  109. package/docs/crawl/docs/_getting-started/create-a-component.html +111 -0
  110. package/docs/crawl/docs/_getting-started/my-first-component.html +189 -0
  111. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +110 -0
  112. package/docs/crawl/docs/_getting-started/pubsub.html +62 -0
  113. package/docs/crawl/docs/_getting-started/start.html +76 -0
  114. package/docs/crawl/docs/_getting-started/theming.html +333 -0
  115. package/docs/crawl/docs/_misc/api-configuration.html +149 -0
  116. package/docs/crawl/docs/_misc/dataProviderKey.html +135 -0
  117. package/docs/crawl/docs/_misc/docs-mock-api.html +158 -0
  118. package/docs/crawl/docs/_misc/dynamic-path.html +180 -0
  119. package/docs/crawl/docs/_misc/endpoint.html +50 -0
  120. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +138 -0
  121. package/docs/crawl/docs/_misc/html-integration.html +48 -0
  122. package/docs/crawl/hubs/decorators.html +547 -0
  123. package/docs/crawl/hubs/form-components.html +381 -0
  124. package/docs/crawl/hubs/remote-data.html +452 -0
  125. package/docs/crawl/index.html +103 -0
  126. package/docs/index.html +1 -1
  127. package/docs/llms-full.txt +7174 -0
  128. package/docs/llms.txt +98 -0
  129. package/docs/sitemap.xml +243 -0
  130. package/docs/src/core/components/functional/date/date.md +290 -0
  131. package/docs/src/core/components/functional/fetch/fetch.md +125 -0
  132. package/docs/src/core/components/functional/if/if.md +9 -0
  133. package/docs/src/core/components/functional/jsonata/jsonata.md +56 -0
  134. package/docs/src/core/components/functional/list/list.md +65 -0
  135. package/docs/src/core/components/functional/mix/mix.md +41 -0
  136. package/docs/src/core/components/functional/queue/queue.md +72 -0
  137. package/docs/src/core/components/functional/router/router.md +94 -0
  138. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  139. package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
  140. package/docs/src/core/components/functional/sdui/default-library.json +108 -0
  141. package/docs/src/core/components/functional/sdui/example.json +99 -0
  142. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  143. package/docs/src/core/components/functional/sdui/sdui.md +478 -0
  144. package/docs/src/core/components/functional/states/states.md +87 -0
  145. package/docs/src/core/components/functional/submit/submit.md +114 -0
  146. package/docs/src/core/components/functional/subscriber/subscriber.md +91 -0
  147. package/docs/src/core/components/functional/value/value.md +35 -0
  148. package/docs/src/core/components/ui/alert/alert.md +196 -0
  149. package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
  150. package/docs/src/core/components/ui/badge/badge.md +188 -0
  151. package/docs/src/core/components/ui/button/button.md +183 -0
  152. package/docs/src/core/components/ui/captcha/captcha.md +71 -0
  153. package/docs/src/core/components/ui/card/card.md +215 -0
  154. package/docs/src/core/components/ui/divider/divider.md +129 -0
  155. package/docs/src/core/components/ui/form/checkbox/checkbox.md +77 -0
  156. package/docs/src/core/components/ui/form/fieldset/fieldset.md +205 -0
  157. package/docs/src/core/components/ui/form/form-actions/form-actions.md +100 -0
  158. package/docs/src/core/components/ui/form/form-layout/form-layout.md +119 -0
  159. package/docs/src/core/components/ui/form/input/input.md +142 -0
  160. package/docs/src/core/components/ui/form/radio/radio.md +57 -0
  161. package/docs/src/core/components/ui/form/select/select.md +71 -0
  162. package/docs/src/core/components/ui/form/switch/switch.md +57 -0
  163. package/docs/src/core/components/ui/form/textarea/textarea.md +65 -0
  164. package/docs/src/core/components/ui/group/group.md +75 -0
  165. package/docs/src/core/components/ui/icon/icon.md +214 -0
  166. package/docs/src/core/components/ui/icon/icons.json +1 -0
  167. package/docs/src/core/components/ui/image/image.md +233 -0
  168. package/docs/src/core/components/ui/link/link.md +81 -0
  169. package/docs/src/core/components/ui/loader/loader.md +112 -0
  170. package/docs/src/core/components/ui/menu/menu.md +370 -0
  171. package/docs/src/core/components/ui/modal/modal.md +235 -0
  172. package/docs/src/core/components/ui/pop/pop.md +294 -0
  173. package/docs/src/core/components/ui/progress/progress.md +109 -0
  174. package/docs/src/core/components/ui/table/table.md +431 -0
  175. package/docs/src/core/components/ui/theme/theme.md +122 -0
  176. package/docs/src/core/components/ui/toast/toast.md +216 -0
  177. package/docs/src/core/components/ui/tooltip/tooltip.md +124 -0
  178. package/{src → docs/src}/docs/_core-concept/subscriber.md +0 -0
  179. package/{src → docs/src}/docs/_getting-started/my-first-subscriber.md +0 -0
  180. package/{src → docs/src}/docs/_getting-started/pubsub.md +0 -0
  181. package/docs/src/docs/_getting-started/theming.md +253 -0
  182. package/docs/src/docs/search/docs-search.json +12242 -0
  183. package/docs/src/tag-list.json +1 -0
  184. package/docs/src/tsconfig-model.json +23 -0
  185. package/docs/src/tsconfig.declarations.json +22 -0
  186. package/docs/src/tsconfig.emit.json +23 -0
  187. package/docs/src/tsconfig.json +1332 -0
  188. package/gitlab/job_github_mirror.sh +39 -0
  189. package/index.html +157 -5
  190. package/package.json +22 -4
  191. package/public/docs-mock-api-sw.js +58 -223
  192. package/public/docs-mock-api-sw.js.map +4 -4
  193. package/public/img/concorde/plane_01.jpg +0 -0
  194. package/public/img/concorde/plane_02.jpg +0 -0
  195. package/public/img/concorde/plane_03.jpg +0 -0
  196. package/public/img/concorde/plane_04.jpg +0 -0
  197. package/public/img/concorde/plane_05.jpg +0 -0
  198. package/public/img/concorde/plane_06.jpg +0 -0
  199. package/public/img/concorde/plane_07.jpg +0 -0
  200. package/public/img/concorde/plane_08.jpg +0 -0
  201. package/public/img/concorde/plane_09.jpg +0 -0
  202. package/public/img/concorde/plane_10.jpg +0 -0
  203. package/public/img/concorde/plane_11.jpg +0 -0
  204. package/public/img/concorde/plane_12.jpg +0 -0
  205. package/public/img/concorde/plane_13.jpg +0 -0
  206. package/public/img/og-concorde.jpg +0 -0
  207. package/public/robots.txt +11 -10
  208. package/scripts/ai-init.mjs +104 -379
  209. package/scripts/ai-init.test.mjs +81 -239
  210. package/scripts/docs-markdown-vite-plugin.ts +43 -0
  211. package/scripts/docs-public-url.mjs +56 -0
  212. package/scripts/docs.htaccess +82 -0
  213. package/scripts/generate-cem.mjs +244 -0
  214. package/scripts/generate-cem.test.mjs +122 -0
  215. package/scripts/generate-crawl-docs.mjs +233 -118
  216. package/scripts/generate-crawl-docs.test.mjs +124 -0
  217. package/scripts/generate-sdui-catalog.mjs +11 -10
  218. package/scripts/github-export.mjs +150 -0
  219. package/scripts/post-build-docs.js +37 -50
  220. package/scripts/post-build.mjs +0 -0
  221. package/scripts/pre-publish.mjs +2 -1
  222. package/scripts/site-pages.mjs +212 -0
  223. package/scripts/site-pages.test.mjs +116 -0
  224. package/site-pages/about.md +22 -0
  225. package/site-pages/privacy.md +32 -0
  226. package/src/core/components/functional/date/date.md +91 -231
  227. package/src/core/components/functional/example/example.ts +3 -1
  228. package/src/core/components/functional/fetch/fetch.md +66 -83
  229. package/src/core/components/functional/if/if.md +28 -3
  230. package/src/core/components/functional/if/if.ts +0 -0
  231. package/src/core/components/functional/jsonata/jsonata.md +42 -37
  232. package/src/core/components/functional/list/list.demo.ts +0 -0
  233. package/src/core/components/functional/list/list.md +103 -43
  234. package/src/core/components/functional/list/list.ts +17 -4
  235. package/src/core/components/functional/mix/mix.md +31 -26
  236. package/src/core/components/functional/queue/queue.demo.ts +10 -7
  237. package/src/core/components/functional/queue/queue.md +40 -61
  238. package/src/core/components/functional/router/router.demo.ts +16 -16
  239. package/src/core/components/functional/router/router.md +64 -65
  240. package/src/core/components/functional/router/router.ts +0 -0
  241. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  242. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  243. package/src/core/components/functional/sdui/component-catalog.json +2 -2
  244. package/src/core/components/functional/sdui/example.json +19 -86
  245. package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  246. package/src/core/components/functional/sdui/sdui-immutable.spec.ts +74 -0
  247. package/src/core/components/functional/sdui/sdui.md +187 -358
  248. package/src/core/components/functional/sdui/sdui.ts +33 -8
  249. package/src/core/components/functional/sdui/types.ts +0 -0
  250. package/src/core/components/functional/states/states.demo.ts +21 -22
  251. package/src/core/components/functional/states/states.md +86 -61
  252. package/src/core/components/functional/states/states.ts +1 -1
  253. package/src/core/components/functional/submit/submit.md +64 -72
  254. package/src/core/components/functional/submit/submit.spec.ts +60 -0
  255. package/src/core/components/functional/submit/submit.ts +6 -3
  256. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  257. package/src/core/components/functional/translation/translation.md +38 -0
  258. package/src/core/components/functional/value/value.md +34 -22
  259. package/src/core/components/functional/value/value.ts +0 -0
  260. package/src/core/components/ui/_css/size.ts +0 -0
  261. package/src/core/components/ui/alert/alert.md +48 -58
  262. package/src/core/components/ui/badge/badge.md +27 -34
  263. package/src/core/components/ui/button/button.md +139 -106
  264. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  265. package/src/core/components/ui/captcha/captcha.md +17 -32
  266. package/src/core/components/ui/card/card.md +6 -6
  267. package/src/core/components/ui/divider/divider.md +8 -11
  268. package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  269. package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
  270. package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
  271. package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
  272. package/src/core/components/ui/form/input/input.md +108 -90
  273. package/src/core/components/ui/form/input/input.ts +8 -2
  274. package/src/core/components/ui/form/radio/radio.md +65 -30
  275. package/src/core/components/ui/form/select/select.md +60 -45
  276. package/src/core/components/ui/form/switch/switch.md +57 -34
  277. package/src/core/components/ui/form/textarea/textarea.md +55 -38
  278. package/src/core/components/ui/group/group.md +35 -33
  279. package/src/core/components/ui/icon/icon.md +4 -4
  280. package/src/core/components/ui/image/image.md +41 -107
  281. package/src/core/components/ui/link/link.md +6 -6
  282. package/src/core/components/ui/loader/loader.md +30 -55
  283. package/src/core/components/ui/menu/menu.md +27 -27
  284. package/src/core/components/ui/modal/modal.md +72 -96
  285. package/src/core/components/ui/pop/pop.md +80 -158
  286. package/src/core/components/ui/progress/progress.md +2 -2
  287. package/src/core/components/ui/table/table.md +91 -255
  288. package/src/core/components/ui/theme/theme.md +11 -36
  289. package/src/core/components/ui/toast/toast.md +48 -117
  290. package/src/core/components/ui/tooltip/tooltip.md +27 -62
  291. package/src/core/decorators/subscriber/bind.ts +9 -14
  292. package/src/core/decorators/subscriber/subscribe.ts +15 -9
  293. package/src/core/decorators/subscriber/subscribe.type-test.ts +14 -5
  294. package/src/core/mixins/Subscriber.ts +0 -0
  295. package/src/core/utils/DataBindObserver.ts +0 -0
  296. package/src/core/utils/LocationHandler.spec.ts +80 -0
  297. package/src/core/utils/LocationHandler.ts +5 -9
  298. package/src/core/utils/Objects.ts +0 -0
  299. package/src/core/utils/PublisherProxy.ts +166 -125
  300. package/src/core/utils/deepReadonly.spec.ts +66 -0
  301. package/src/core/utils/deepReadonly.ts +71 -0
  302. package/src/core/utils/immutableValue.spec.ts +54 -0
  303. package/src/core/utils/immutableValue.ts +102 -0
  304. package/src/core/utils/nestedDotForm.spec.ts +88 -0
  305. package/src/core/utils/publisherImmutable.spec.ts +76 -0
  306. package/src/core/utils/route.ts +0 -0
  307. package/src/core/utils/strictGet.spec.ts +61 -0
  308. package/src/core/utils/strictGet.ts +102 -0
  309. package/src/css.d.ts +19 -0
  310. package/src/docs/components/docs-demo-sources.ts +55 -140
  311. package/src/docs/components/docs-lit-demo.ts +1 -3
  312. package/src/docs/components/docs-source-link.ts +0 -82
  313. package/src/docs/decorators/ancestor-attribute.md +59 -0
  314. package/src/docs/decorators/auto-subscribe.md +40 -0
  315. package/src/docs/decorators/bind.md +76 -0
  316. package/src/docs/decorators/get.md +160 -0
  317. package/src/docs/decorators/handle.md +119 -0
  318. package/src/docs/decorators/on-assign.md +63 -0
  319. package/src/docs/decorators/patch.md +44 -0
  320. package/src/docs/decorators/post.md +134 -0
  321. package/src/docs/decorators/publish.md +56 -0
  322. package/src/docs/decorators/put.md +51 -0
  323. package/src/docs/decorators/subscribe.md +87 -0
  324. package/src/docs/decorators/wait-for-ancestors.md +76 -0
  325. package/src/docs/directives/sub.md +75 -0
  326. package/src/docs/directives/t.md +73 -0
  327. package/src/docs/docs-location.spec.ts +56 -0
  328. package/src/docs/docs-location.ts +133 -32
  329. package/src/docs/docs.ts +1 -2
  330. package/src/docs/example/decorators-demo-bind-demos.ts +83 -135
  331. package/src/docs/example/decorators-demo-geo.ts +30 -19
  332. package/src/docs/example/decorators-demo-post.ts +88 -186
  333. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
  334. package/src/docs/example/decorators-demo.ts +85 -98
  335. package/src/docs/example/docs-api-config-demos.ts +19 -20
  336. package/src/docs/example/docs-flight-demos.ts +147 -0
  337. package/src/docs/example/docs-jsonata-demos.ts +52 -52
  338. package/src/docs/example/docs-list-demos.ts +43 -123
  339. package/src/docs/example/docs-provider-keys.ts +21 -28
  340. package/src/docs/example/docs-queue-demos.ts +37 -77
  341. package/src/docs/example/docs-router-demos.ts +20 -25
  342. package/src/docs/example/docs-submit-demos.ts +48 -48
  343. package/src/docs/example/docs-toggle-demos.ts +4 -3
  344. package/src/docs/example/users.ts +0 -0
  345. package/src/docs/getting-started/ai-agents.md +50 -0
  346. package/src/docs/getting-started/create-a-component.md +136 -0
  347. package/src/docs/getting-started/dataFlow.md +87 -0
  348. package/src/docs/getting-started/installation.md +36 -0
  349. package/src/docs/getting-started/my-first-component.md +227 -0
  350. package/src/docs/getting-started/start.md +35 -0
  351. package/src/docs/header/header.ts +11 -6
  352. package/src/docs/home/catalog.ts +1 -1
  353. package/src/docs/home/home.ts +20 -11
  354. package/src/docs/layout.ts +12 -13
  355. package/src/docs/misc/api-configuration.md +79 -0
  356. package/src/docs/misc/dataProviderKey.md +168 -0
  357. package/src/docs/misc/docs-mock-api.md +62 -0
  358. package/src/docs/misc/dynamic-path.md +71 -0
  359. package/src/docs/misc/endpoint.md +45 -0
  360. package/src/docs/misc/html-integration.md +14 -0
  361. package/src/docs/misc/publisher-get-immutability-docs-crawl.json +902 -0
  362. package/src/docs/misc/publisher-get-immutability-docs-recheck.json +13 -0
  363. package/src/docs/misc/publisher-get-immutability-study.md +229 -0
  364. package/src/docs/mock-api/api-config-mock.ts +5 -0
  365. package/src/docs/mock-api/fixtures.ts +0 -278
  366. package/src/docs/mock-api/flights.ts +89 -0
  367. package/src/docs/mock-api/router.ts +3 -4
  368. package/src/docs/mock-api/urls.ts +1 -2
  369. package/src/docs/navigation/navigation.ts +84 -101
  370. package/src/docs/navigation/toc.ts +7 -4
  371. package/src/docs/search/docs-search.json +3188 -5153
  372. package/src/docs/search/markdown-renderer.ts +31 -8
  373. package/src/docs/search/page.ts +9 -6
  374. package/src/docs/search/search.ts +154 -122
  375. package/src/docs/tailwind/css/docs/content.css +4 -5
  376. package/src/tsconfig.declarations.json +22 -0
  377. package/src/tsconfig.emit.json +23 -0
  378. package/src/tsconfig.json +53 -5
  379. package/src/tsconfig.tsbuildinfo +1 -1
  380. package/vite.config.mts +11 -2
  381. package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
  382. package/.taste-skill/after/desktop-fold.jpg +0 -0
  383. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  384. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  385. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  386. package/.taste-skill/after/mobile-fold.jpg +0 -0
  387. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  388. package/.taste-skill/after/report.json +0 -4103
  389. package/.taste-skill/after/tablet-fold.jpg +0 -0
  390. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  391. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  392. package/.taste-skill/before/desktop-fold.jpg +0 -0
  393. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  394. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  395. package/.taste-skill/before/mobile-fold.jpg +0 -0
  396. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  397. package/.taste-skill/before/report.json +0 -2556
  398. package/.taste-skill/before/tablet-fold.jpg +0 -0
  399. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  400. package/.taste-skill/direction.json +0 -510
  401. package/.taste-skill/notes.md +0 -84
  402. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  403. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  404. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  405. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  406. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  407. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  408. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  409. package/.taste-skill/prod/report.json +0 -1973
  410. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  411. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  412. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  413. package/AUDIT.md +0 -228
  414. package/PLAN-AMELIORATION.md +0 -220
  415. package/ai/AGENTS.md +0 -56
  416. package/ai/cursor/rules/concorde-menu.mdc +0 -15
  417. package/ai/cursor/rules/concorde-scope.mdc +0 -14
  418. package/ai/cursor/rules/concorde-theme.mdc +0 -13
  419. package/ai/cursor/rules/concorde.mdc +0 -66
  420. package/ai/jetbrains/rules/concorde.md +0 -53
  421. package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
  422. package/ai/skills/concorde-imports/SKILL.md +0 -78
  423. package/ai/skills/concorde-menu/SKILL.md +0 -74
  424. package/ai/skills/concorde-scope/SKILL.md +0 -70
  425. package/ai/skills/concorde-theme/SKILL.md +0 -57
  426. package/docs/assets/index-Bb-_LRyY.js +0 -12280
  427. package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
  428. package/src/docs/example/docs-joke-demos.ts +0 -297
  429. /package/{src → docs/src}/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -0
  430. /package/{src → docs/src}/docs/_core-concept/dataFlow.md +0 -0
  431. /package/{src → docs/src}/docs/_core-concept/overview.md +0 -0
  432. /package/{src → docs/src}/docs/_decorators/ancestor-attribute.md +0 -0
  433. /package/{src → docs/src}/docs/_decorators/auto-subscribe.md +0 -0
  434. /package/{src → docs/src}/docs/_decorators/bind.md +0 -0
  435. /package/{src → docs/src}/docs/_decorators/get.md +0 -0
  436. /package/{src → docs/src}/docs/_decorators/handle.md +0 -0
  437. /package/{src → docs/src}/docs/_decorators/on-assign.md +0 -0
  438. /package/{src → docs/src}/docs/_decorators/patch.md +0 -0
  439. /package/{src → docs/src}/docs/_decorators/post.md +0 -0
  440. /package/{src → docs/src}/docs/_decorators/publish.md +0 -0
  441. /package/{src → docs/src}/docs/_decorators/put.md +0 -0
  442. /package/{src → docs/src}/docs/_decorators/subscribe.md +0 -0
  443. /package/{src → docs/src}/docs/_decorators/wait-for-ancestors.md +0 -0
  444. /package/{src → docs/src}/docs/_directives/sub.md +0 -0
  445. /package/{src → docs/src}/docs/_getting-started/ai-agents.md +0 -0
  446. /package/{src → docs/src}/docs/_getting-started/concorde-manual-install.md +0 -0
  447. /package/{src → docs/src}/docs/_getting-started/concorde-outside.md +0 -0
  448. /package/{src → docs/src}/docs/_getting-started/create-a-component.md +0 -0
  449. /package/{src → docs/src}/docs/_getting-started/my-first-component.md +0 -0
  450. /package/{src → docs/src}/docs/_getting-started/start.md +0 -0
  451. /package/{src → docs/src}/docs/_misc/api-configuration.md +0 -0
  452. /package/{src → docs/src}/docs/_misc/dataProviderKey.md +0 -0
  453. /package/{src → docs/src}/docs/_misc/docs-mock-api.md +0 -0
  454. /package/{src → docs/src}/docs/_misc/dynamic-path.md +0 -0
  455. /package/{src → docs/src}/docs/_misc/endpoint.md +0 -0
  456. /package/{src → docs/src}/docs/_misc/formelement-subscriber-removal.md +0 -0
  457. /package/{src → docs/src}/docs/_misc/html-integration.md +0 -0
  458. /package/src/docs/{_getting-started → getting-started}/components.md +0 -0
  459. /package/src/docs/{_getting-started → getting-started}/theming.md +0 -0
package/docs/crawl/core/components/ui/loader/loader.html ADDED
@@ -0,0 +1,124 @@
1
+ <!DOCTYPE html>
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html" data-doc-id="core/components/ui/loader/loader">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Loader — Concorde</title>
7
+ <meta name="description" content="sonic-loader shows a loading animation in the page or as a viewport overlay. Default mode is fixed (centered overlay). Use inline inside lists and fetch placeholders. Pair noDelay when the spinner sho">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/ui/loader/loader, loader, Loader, UI component, sonic-loader, web component, mode, fixed, inline, noDelay, sonic-fetch, sonic-list, currentColor">
9
+ <meta name="concorde-doc-id" content="core/components/ui/loader/loader">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html">
11
+ </head>
12
+ <body>
13
+ <header>
14
+ <p><a href="../../../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#core/components/ui/loader/loader.md/loader" rel="nofollow">interactive version</a></p>
15
+ </header>
16
+ <main>
17
+ <article>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde UI component — Loader</strong>. sonic-loader shows a loading animation in the page or as a viewport overlay. Default mode is fixed (centered overlay). Use inline inside lists and fetch placeholders. Pair noDelay when the spinner sho <span>Doc ID: <code>core/components/ui/loader/loader</code>. Keywords: Concorde, supersoniks, core/components/ui/loader/loader, loader, Loader, UI component, sonic-loader, web component, mode, fixed, inline, noDelay, sonic-fetch, sonic-list, currentColor. URL: <a href="https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html">https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html</a>.</span></p>
19
+ <h1 id="loader">Loader</h1>
20
+ <p><strong><code>sonic-loader</code></strong> shows a loading animation in the page or as a viewport overlay. Default <strong><code>mode</code></strong> is <strong><code>fixed</code></strong> (centered overlay). Use <strong><code>inline</code></strong> inside lists and fetch placeholders. Pair <strong><code>noDelay</code></strong> when the spinner should appear without the default fade-in wait. For <strong><code>sonic-fetch</code></strong> / <strong><code>sonic-list</code></strong>, set the parent <strong><code>loader</code></strong> attribute instead of embedding a tag manually.</p>
21
+ <h2 id="basic-example">Basic example</h2>
22
+ <p>Inline loaders fit content areas; they use the theme primary color unless <strong><code>currentColor</code></strong> is set.</p>
23
+ <pre><code>&lt;sonic-loader mode=&quot;inline&quot;&gt;&lt;/sonic-loader&gt;
24
+ </code></pre>
25
+ <h2 id="mode">Mode</h2>
26
+ <p><strong><code>inline</code></strong> — ellipsis animation in the document flow. <strong><code>fixed</code></strong> — centered overlay (<code>position: fixed</code>); default when the tag is omitted.</p>
27
+ <pre><code>&lt;sonic-loader mode=&quot;inline&quot;&gt;&lt;/sonic-loader&gt;
28
+ </code></pre>
29
+ <p>Use the checkbox below to toggle a <strong><code>fixed</code></strong> loader over the page (default <strong><code>mode</code></strong> on <strong><code>sonic-loader</code></strong>).</p>
30
+ <p><docs-lit-demo for="docs-toggle-loader-demo"></docs-lit-demo></p>
31
+ <h2 id="inline-alignment-and-color">Inline alignment and color</h2>
32
+ <p><strong><code>align</code></strong> only affects <strong><code>mode=&quot;inline&quot;</code></strong>: <strong><code>left</code></strong> · <strong><code>center</code></strong> (default) · <strong><code>right</code></strong>. Set <strong><code>currentColor</code></strong> so dots follow the host <code>color</code> (for example on a purple parent).</p>
33
+ <pre><code>&lt;div class=&quot;grid gap-4&quot;&gt;
34
+ &lt;sonic-loader mode=&quot;inline&quot; currentColor style=&quot;color: purple;&quot;&gt;&lt;/sonic-loader&gt;
35
+ &lt;div class=&quot;flex flex-col gap-2&quot;&gt;
36
+ &lt;sonic-loader mode=&quot;inline&quot; align=&quot;left&quot;&gt;&lt;/sonic-loader&gt;
37
+ &lt;sonic-loader mode=&quot;inline&quot; align=&quot;center&quot;&gt;&lt;/sonic-loader&gt;
38
+ &lt;sonic-loader mode=&quot;inline&quot; align=&quot;right&quot;&gt;&lt;/sonic-loader&gt;
39
+ &lt;/div&gt;
40
+ &lt;/div&gt;
41
+ </code></pre>
42
+ <h2 id="nodelay"><code>noDelay</code></h2>
43
+ <p>By default <strong><code>mode=&quot;fixed&quot;</code></strong> waits briefly before fading in. <strong><code>mode=&quot;inline&quot;</code></strong> already skips that wait. Set <strong><code>noDelay</code></strong> on <strong><code>fixed</code></strong> (or pass <strong><code>noDelay: true</code></strong> to <strong><code>Loader.show()</code></strong>) to appear immediately.</p>
44
+ <pre><code>&lt;sonic-loader mode=&quot;inline&quot; noDelay&gt;&lt;/sonic-loader&gt;
45
+ </code></pre>
46
+ <h2 id="accessibility-announce">Accessibility (<code>announce</code>)</h2>
47
+ <p>The animation is <strong><code>aria-hidden</code></strong> by default so screen readers are not spammed on every fetch. Set <strong><code>announce</code></strong> when the loader is injected <strong>after</strong> user action (for example a global overlay): the host gets <strong><code>role=&quot;status&quot;</code></strong>, <strong><code>aria-live=&quot;polite&quot;</code></strong>, and a localized <strong><code>aria-label</code></strong> (“Loading” / “Chargement en cours”, …). For in-button loading, prefer <strong><code>sonic-button</code></strong> <strong><code>loading</code></strong> and <strong><code>aria-busy</code></strong> on the control—not on the loader.</p>
48
+ <pre><code>&lt;sonic-loader mode=&quot;inline&quot; announce&gt;&lt;/sonic-loader&gt;
49
+ </code></pre>
50
+ <h2 id="show-and-hide-programmatically">Show and hide programmatically</h2>
51
+ <p>Import <strong><code>Loader</code></strong> and call <strong><code>Loader.show()</code></strong> / <strong><code>Loader.hide()</code></strong>. <strong><code>hide()</code></strong> is reference-counted: call it once per <strong><code>show()</code></strong>. With no <strong><code>container</code></strong>, the loader is appended to the theme pop container and <strong><code>mode</code></strong> is always <strong><code>fixed</code></strong>. Pass <strong><code>container</code></strong> and <strong><code>mode: &quot;inline&quot;</code></strong> to mount an inline instance in a specific element.</p>
52
+ <pre><code class="language-javascript">import { Loader } from &quot;@supersoniks/concorde/core/components/ui/loader/loader&quot;;
53
+
54
+ Loader.show({
55
+ mode: &quot;fixed&quot;,
56
+ noDelay: false,
57
+ announce: true,
58
+ container: document.querySelector(&quot;#foo&quot;),
59
+ });
60
+
61
+ Loader.hide();
62
+ </code></pre>
63
+ <h2 id="composition">Composition</h2>
64
+ <p><strong><code>sonic-button</code></strong> <strong><code>loading</code></strong> shows an icon spinner and sets <strong><code>aria-busy</code></strong> on the button. <strong><code>sonic-fetch</code></strong> and <strong><code>sonic-list</code></strong> render <strong><code>sonic-loader</code></strong> when their <strong><code>loader</code></strong> attribute is set: <strong><code>true</code></strong> or an empty string maps to <strong><code>fixed</code></strong>; otherwise use <strong><code>inline</code></strong> or <strong><code>fixed</code></strong>.</p>
65
+ <pre><code>&lt;sonic-button loading&gt;Save changes&lt;/sonic-button&gt;
66
+ </code></pre>
67
+ <h2 id="api-reference">API reference</h2>
68
+ <table>
69
+ <thead>
70
+ <tr>
71
+ <th>Attribute</th>
72
+ <th>Values</th>
73
+ <th>Description</th>
74
+ </tr>
75
+ </thead>
76
+ <tbody><tr>
77
+ <td><code>mode</code></td>
78
+ <td><code>inline</code> · <code>fixed</code> (default <code>fixed</code>)</td>
79
+ <td>Layout: in-flow ellipsis vs viewport-centered overlay</td>
80
+ </tr>
81
+ <tr>
82
+ <td><code>noDelay</code></td>
83
+ <td>boolean</td>
84
+ <td>Skips the initial fade-in delay before the animation appears</td>
85
+ </tr>
86
+ <tr>
87
+ <td><code>announce</code></td>
88
+ <td>boolean</td>
89
+ <td><strong><code>role=&quot;status&quot;</code></strong> and <strong><code>aria-live=&quot;polite&quot;</code></strong> with localized loading label when the loader should be announced</td>
90
+ </tr>
91
+ <tr>
92
+ <td><code>align</code></td>
93
+ <td><code>left</code> · <code>center</code> · <code>right</code></td>
94
+ <td>Horizontal alignment for <strong><code>mode=&quot;inline&quot;</code></strong> only (attribute selector; default centered)</td>
95
+ </tr>
96
+ <tr>
97
+ <td><code>currentColor</code></td>
98
+ <td>boolean</td>
99
+ <td>Uses <code>currentColor</code> for dot fill instead of <strong><code>--sc-primary</code></strong></td>
100
+ </tr>
101
+ </tbody></table>
102
+ <p>This component has <strong>no slots</strong>. The animation markup is internal.</p>
103
+ <h3 id="static-methods">Static methods</h3>
104
+ <table>
105
+ <thead>
106
+ <tr>
107
+ <th>Method</th>
108
+ <th>Description</th>
109
+ </tr>
110
+ </thead>
111
+ <tbody><tr>
112
+ <td><code>Loader.show(conf?)</code></td>
113
+ <td>Mounts the shared loader instance. <strong><code>conf.mode</code></strong>, <strong><code>conf.noDelay</code></strong>, <strong><code>conf.announce</code></strong>, optional <strong><code>conf.container</code></strong>. Without <strong><code>container</code></strong>, uses the theme pop container and forces <strong><code>fixed</code></strong>.</td>
114
+ </tr>
115
+ <tr>
116
+ <td><code>Loader.hide()</code></td>
117
+ <td>Decrements the show counter and removes the instance from the DOM when it reaches zero.</td>
118
+ </tr>
119
+ </tbody></table>
120
+
121
+ </article>
122
+ </main>
123
+ </body>
124
+ </html>
package/docs/crawl/core/components/ui/menu/menu.html ADDED
@@ -0,0 +1,394 @@
1
+ <!DOCTYPE html>
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/core/components/ui/menu/menu.html" data-doc-id="core/components/ui/menu/menu">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Menu — Concorde</title>
7
+ <meta name="description" content="sonic-menu lays out navigation or actions as a direction row or column of sonic-menu-item entries (ghost variant and block shape by default), optional sonic-divider separators, and overflow content in">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/ui/menu/menu, menu, Menu, UI component, sonic-menu, web component, direction, sonic-menu-item, variant, shape, sonic-divider, more, href, pushstate, autoActive">
9
+ <meta name="concorde-doc-id" content="core/components/ui/menu/menu">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/core/components/ui/menu/menu.html">
11
+ </head>
12
+ <body>
13
+ <header>
14
+ <p><a href="../../../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#core/components/ui/menu/menu.md/menu" rel="nofollow">interactive version</a></p>
15
+ </header>
16
+ <main>
17
+ <article>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde UI component — Menu</strong>. sonic-menu lays out navigation or actions as a direction row or column of sonic-menu-item entries (ghost variant and block shape by default), optional sonic-divider separators, and overflow content in <span>Doc ID: <code>core/components/ui/menu/menu</code>. Keywords: Concorde, supersoniks, core/components/ui/menu/menu, menu, Menu, UI component, sonic-menu, web component, direction, sonic-menu-item, variant, shape, sonic-divider, more, href, pushstate, autoActive. URL: <a href="https://concorde.supersoniks.org/crawl/core/components/ui/menu/menu.html">https://concorde.supersoniks.org/crawl/core/components/ui/menu/menu.html</a>.</span></p>
19
+ <h1 id="menu">Menu</h1>
20
+ <p><strong><code>sonic-menu</code></strong> lays out navigation or actions as a <strong><code>direction</code></strong> row or column of <strong><code>sonic-menu-item</code></strong> entries (ghost <strong><code>variant</code></strong> and block <strong><code>shape</code></strong> by default), optional <strong><code>sonic-divider</code></strong> separators, and overflow content in the <strong><code>more</code></strong> slot (popover “…” trigger). Set <strong><code>href</code></strong> / <strong><code>pushstate</code></strong> / <strong><code>autoActive</code></strong> on each <strong><code>sonic-menu-item</code></strong>—same API as <strong><code>sonic-button</code></strong>—not on the menu host.</p>
21
+ <h2 id="basic-example">Basic example</h2>
22
+ <pre><code>&lt;sonic-menu direction=&quot;row&quot;&gt;
23
+ &lt;sonic-menu-item variant=&quot;ghost&quot;&gt;
24
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;home&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
25
+ Home
26
+ &lt;/sonic-menu-item&gt;
27
+ &lt;sonic-menu-item&gt;
28
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
29
+ Profile
30
+ &lt;/sonic-menu-item&gt;
31
+ &lt;sonic-menu-item type=&quot;danger&quot;&gt;
32
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;log-out&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
33
+ Log out
34
+ &lt;/sonic-menu-item&gt;
35
+ &lt;/sonic-menu&gt;
36
+ </code></pre>
37
+ <h2 id="direction">Direction</h2>
38
+ <p>Default <strong><code>direction</code></strong> is <strong><code>column</code></strong>. Use <strong><code>row</code></strong> for horizontal toolbars or tabs.</p>
39
+ <pre><code>&lt;sonic-menu direction=&quot;row&quot;&gt;
40
+ &lt;sonic-menu-item variant=&quot;ghost&quot;&gt;
41
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;arrow-right&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
42
+ Row
43
+ &lt;/sonic-menu-item&gt;
44
+ &lt;sonic-menu-item&gt;
45
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
46
+ Profile
47
+ &lt;/sonic-menu-item&gt;
48
+ &lt;sonic-menu-item&gt;
49
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;clock-outline&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
50
+ History
51
+ &lt;/sonic-menu-item&gt;
52
+ &lt;sonic-menu-item&gt;
53
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;bag&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
54
+ Orders
55
+ &lt;/sonic-menu-item&gt;
56
+ &lt;sonic-menu-item type=&quot;danger&quot;&gt;
57
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;log-out&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
58
+ Log out
59
+ &lt;/sonic-menu-item&gt;
60
+ &lt;/sonic-menu&gt;
61
+ &lt;sonic-menu direction=&quot;column&quot;&gt;
62
+ &lt;sonic-menu-item variant=&quot;ghost&quot;&gt;
63
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;arrow-down&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
64
+ Column
65
+ &lt;/sonic-menu-item&gt;
66
+ &lt;sonic-menu-item&gt;
67
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
68
+ Profile
69
+ &lt;/sonic-menu-item&gt;
70
+ &lt;sonic-menu-item&gt;
71
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;clock-outline&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
72
+ History
73
+ &lt;/sonic-menu-item&gt;
74
+ &lt;sonic-menu-item&gt;
75
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;bag&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
76
+ Orders
77
+ &lt;/sonic-menu-item&gt;
78
+ &lt;sonic-menu-item type=&quot;danger&quot;&gt;
79
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;log-out&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
80
+ Log out
81
+ &lt;/sonic-menu-item&gt;
82
+ &lt;/sonic-menu&gt;
83
+ </code></pre>
84
+ <h2 id="size">Size</h2>
85
+ <p><strong><code>size</code></strong> on the menu propagates to items and the <strong><code>more</code></strong> trigger when they omit their own <strong><code>size</code></strong>.</p>
86
+ <pre><code>&lt;div class=&quot;grid gap-3&quot;&gt;
87
+ &lt;sonic-menu size=&quot;xs&quot; direction=&quot;row&quot;&gt;
88
+ &lt;sonic-menu-item&gt;XS&lt;/sonic-menu-item&gt;
89
+ &lt;sonic-menu-item&gt;
90
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
91
+ Profile
92
+ &lt;/sonic-menu-item&gt;
93
+ &lt;sonic-menu-item&gt;
94
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;clock-outline&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
95
+ History
96
+ &lt;/sonic-menu-item&gt;
97
+ &lt;sonic-menu-item&gt;
98
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;bag&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
99
+ Orders
100
+ &lt;/sonic-menu-item&gt;
101
+ &lt;/sonic-menu&gt;
102
+ &lt;sonic-menu size=&quot;sm&quot; direction=&quot;row&quot;&gt;
103
+ &lt;sonic-menu-item&gt;Small&lt;/sonic-menu-item&gt;
104
+ &lt;sonic-menu-item&gt;
105
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
106
+ Profile
107
+ &lt;/sonic-menu-item&gt;
108
+ &lt;sonic-menu-item&gt;
109
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;clock-outline&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
110
+ History
111
+ &lt;/sonic-menu-item&gt;
112
+ &lt;sonic-menu-item&gt;
113
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;bag&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
114
+ Orders
115
+ &lt;/sonic-menu-item&gt;
116
+ &lt;/sonic-menu&gt;
117
+ &lt;sonic-menu direction=&quot;row&quot;&gt;
118
+ &lt;sonic-menu-item&gt;Medium&lt;/sonic-menu-item&gt;
119
+ &lt;sonic-menu-item&gt;
120
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
121
+ Profile
122
+ &lt;/sonic-menu-item&gt;
123
+ &lt;sonic-menu-item&gt;
124
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;clock-outline&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
125
+ History
126
+ &lt;/sonic-menu-item&gt;
127
+ &lt;sonic-menu-item&gt;
128
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;bag&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
129
+ Orders
130
+ &lt;/sonic-menu-item&gt;
131
+ &lt;/sonic-menu&gt;
132
+ &lt;sonic-menu size=&quot;lg&quot; direction=&quot;row&quot;&gt;
133
+ &lt;sonic-menu-item&gt;Large&lt;/sonic-menu-item&gt;
134
+ &lt;sonic-menu-item&gt;
135
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
136
+ Profile
137
+ &lt;/sonic-menu-item&gt;
138
+ &lt;sonic-menu-item&gt;
139
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;clock-outline&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
140
+ History
141
+ &lt;/sonic-menu-item&gt;
142
+ &lt;sonic-menu-item&gt;
143
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;bag&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
144
+ Orders
145
+ &lt;/sonic-menu-item&gt;
146
+ &lt;/sonic-menu&gt;
147
+ &lt;sonic-menu size=&quot;xl&quot; direction=&quot;row&quot;&gt;
148
+ &lt;sonic-menu-item&gt;XL&lt;/sonic-menu-item&gt;
149
+ &lt;sonic-menu-item&gt;
150
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
151
+ Profile
152
+ &lt;/sonic-menu-item&gt;
153
+ &lt;sonic-menu-item&gt;
154
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;clock-outline&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
155
+ History
156
+ &lt;/sonic-menu-item&gt;
157
+ &lt;sonic-menu-item&gt;
158
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;bag&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
159
+ Orders
160
+ &lt;/sonic-menu-item&gt;
161
+ &lt;/sonic-menu&gt;
162
+ &lt;/div&gt;
163
+ </code></pre>
164
+ <h2 id="shadow">Shadow</h2>
165
+ <p>Optional <strong><code>shadow</code></strong> wraps the menu surface (no shadow when omitted).</p>
166
+ <pre><code>&lt;div class=&quot;grid gap-3&quot;&gt;
167
+ &lt;sonic-menu direction=&quot;row&quot;&gt;
168
+ &lt;sonic-menu-item&gt;None&lt;/sonic-menu-item&gt;
169
+ &lt;/sonic-menu&gt;
170
+ &lt;sonic-menu shadow=&quot;sm&quot; direction=&quot;row&quot;&gt;
171
+ &lt;sonic-menu-item&gt;Small&lt;/sonic-menu-item&gt;
172
+ &lt;/sonic-menu&gt;
173
+ &lt;sonic-menu shadow=&quot;md&quot; direction=&quot;row&quot;&gt;
174
+ &lt;sonic-menu-item&gt;Medium&lt;/sonic-menu-item&gt;
175
+ &lt;/sonic-menu&gt;
176
+ &lt;sonic-menu shadow=&quot;lg&quot; direction=&quot;row&quot;&gt;
177
+ &lt;sonic-menu-item&gt;Large&lt;/sonic-menu-item&gt;
178
+ &lt;/sonic-menu&gt;
179
+ &lt;/div&gt;
180
+ </code></pre>
181
+ <h2 id="align">Align</h2>
182
+ <p><strong><code>align</code></strong> propagates to items except square / circle <strong><code>shape</code></strong>.</p>
183
+ <pre><code>&lt;div class=&quot;grid gap-3&quot;&gt;
184
+ &lt;sonic-menu align=&quot;center&quot;&gt;
185
+ &lt;sonic-menu-item variant=&quot;ghost&quot;&gt;
186
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;home&quot;&gt;&lt;/sonic-icon&gt;
187
+ Home
188
+ &lt;/sonic-menu-item&gt;
189
+ &lt;sonic-menu-item&gt;
190
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot;&gt;&lt;/sonic-icon&gt;
191
+ Profile
192
+ &lt;/sonic-menu-item&gt;
193
+ &lt;/sonic-menu&gt;
194
+ &lt;sonic-menu align=&quot;left&quot;&gt;
195
+ &lt;sonic-menu-item variant=&quot;ghost&quot;&gt;
196
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;home&quot;&gt;&lt;/sonic-icon&gt;
197
+ Home
198
+ &lt;/sonic-menu-item&gt;
199
+ &lt;sonic-menu-item&gt;
200
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot;&gt;&lt;/sonic-icon&gt;
201
+ Profile
202
+ &lt;/sonic-menu-item&gt;
203
+ &lt;/sonic-menu&gt;
204
+ &lt;sonic-menu align=&quot;right&quot;&gt;
205
+ &lt;sonic-menu-item variant=&quot;ghost&quot;&gt;
206
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;home&quot;&gt;&lt;/sonic-icon&gt;
207
+ Home
208
+ &lt;/sonic-menu-item&gt;
209
+ &lt;sonic-menu-item&gt;
210
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot;&gt;&lt;/sonic-icon&gt;
211
+ Profile
212
+ &lt;/sonic-menu-item&gt;
213
+ &lt;/sonic-menu&gt;
214
+ &lt;/div&gt;
215
+ </code></pre>
216
+ <h2 id="more">More</h2>
217
+ <p>Assign nodes to <strong><code>slot=&quot;more&quot;</code></strong> to show the overflow popover. The trigger appears only when the slot has content. Icon orientation follows <strong><code>direction</code></strong> (vertical ellipsis in a row menu).</p>
218
+ <pre><code>&lt;sonic-menu direction=&quot;row&quot;&gt;
219
+ &lt;sonic-menu-item variant=&quot;ghost&quot;&gt;
220
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;home&quot;&gt;&lt;/sonic-icon&gt;
221
+ Home
222
+ &lt;/sonic-menu-item&gt;
223
+ &lt;sonic-menu-item&gt;
224
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot;&gt;&lt;/sonic-icon&gt;
225
+ Profile
226
+ &lt;/sonic-menu-item&gt;
227
+ &lt;sonic-menu-item&gt;
228
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;clock-outline&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
229
+ History
230
+ &lt;/sonic-menu-item&gt;
231
+ &lt;sonic-menu-item&gt;
232
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;bag&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
233
+ Orders
234
+ &lt;/sonic-menu-item&gt;
235
+ &lt;sonic-menu slot=&quot;more&quot;&gt;
236
+ &lt;sonic-menu-item&gt;
237
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;settings&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
238
+ Settings
239
+ &lt;/sonic-menu-item&gt;
240
+ &lt;sonic-menu-item&gt;
241
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;chat-bubble&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
242
+ Messages
243
+ &lt;/sonic-menu-item&gt;
244
+ &lt;sonic-divider&gt;&lt;/sonic-divider&gt;
245
+ &lt;sonic-menu-item type=&quot;danger&quot;&gt;
246
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;log-out&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
247
+ Log out
248
+ &lt;/sonic-menu-item&gt;
249
+ &lt;/sonic-menu&gt;
250
+ &lt;/sonic-menu&gt;
251
+ </code></pre>
252
+ <h2 id="scrollable">Scrollable</h2>
253
+ <p>With <strong><code>scrollable</code></strong>, the main slot scrolls with edge fade masks; drag-to-scroll works on pointer devices. When exactly one item is <strong><code>active</code></strong>, the menu scrolls it into view.</p>
254
+ <pre><code>&lt;sonic-menu direction=&quot;row&quot; scrollable&gt;
255
+ &lt;sonic-menu-item variant=&quot;ghost&quot;&gt;
256
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;home&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
257
+ Home
258
+ &lt;/sonic-menu-item&gt;
259
+ &lt;sonic-menu-item&gt;
260
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
261
+ Profile
262
+ &lt;/sonic-menu-item&gt;
263
+ &lt;sonic-menu-item&gt;
264
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;clock-outline&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
265
+ History
266
+ &lt;/sonic-menu-item&gt;
267
+ &lt;sonic-menu-item&gt;
268
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;bag&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
269
+ Orders
270
+ &lt;/sonic-menu-item&gt;
271
+ &lt;sonic-menu-item variant=&quot;ghost&quot;&gt;
272
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;home&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
273
+ Home
274
+ &lt;/sonic-menu-item&gt;
275
+ &lt;sonic-menu-item&gt;
276
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
277
+ Profile
278
+ &lt;/sonic-menu-item&gt;
279
+ &lt;sonic-menu-item&gt;
280
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;clock-outline&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
281
+ History
282
+ &lt;/sonic-menu-item&gt;
283
+ &lt;sonic-menu-item&gt;
284
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;bag&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
285
+ Orders
286
+ &lt;/sonic-menu-item&gt;
287
+ &lt;sonic-menu-item variant=&quot;ghost&quot;&gt;
288
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;home&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
289
+ Home
290
+ &lt;/sonic-menu-item&gt;
291
+ &lt;sonic-menu-item&gt;
292
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;user&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
293
+ Profile
294
+ &lt;/sonic-menu-item&gt;
295
+ &lt;sonic-menu-item&gt;
296
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;clock-outline&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
297
+ History
298
+ &lt;/sonic-menu-item&gt;
299
+ &lt;sonic-menu-item&gt;
300
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;bag&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
301
+ Orders
302
+ &lt;/sonic-menu-item&gt;
303
+ &lt;sonic-menu-item&gt;
304
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;settings&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
305
+ Settings
306
+ &lt;/sonic-menu-item&gt;
307
+ &lt;sonic-menu-item&gt;
308
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;chat-bubble&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
309
+ Messages
310
+ &lt;/sonic-menu-item&gt;
311
+ &lt;sonic-menu slot=&quot;more&quot;&gt;
312
+ &lt;sonic-menu-item&gt;
313
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;settings&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
314
+ Settings
315
+ &lt;/sonic-menu-item&gt;
316
+ &lt;sonic-menu-item&gt;
317
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;chat-bubble&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
318
+ Messages
319
+ &lt;/sonic-menu-item&gt;
320
+ &lt;sonic-divider&gt;&lt;/sonic-divider&gt;
321
+ &lt;sonic-menu-item type=&quot;danger&quot;&gt;
322
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;log-out&quot; slot=&quot;prefix&quot;&gt;&lt;/sonic-icon&gt;
323
+ Log out
324
+ &lt;/sonic-menu-item&gt;
325
+ &lt;/sonic-menu&gt;
326
+ &lt;/sonic-menu&gt;
327
+ </code></pre>
328
+ <h2 id="api-reference">API reference</h2>
329
+ <table>
330
+ <thead>
331
+ <tr>
332
+ <th>Attribute</th>
333
+ <th>Values</th>
334
+ <th>Description</th>
335
+ </tr>
336
+ </thead>
337
+ <tbody><tr>
338
+ <td><code>direction</code></td>
339
+ <td><code>column</code> (default) · <code>row</code></td>
340
+ <td>Vertical list or horizontal bar</td>
341
+ </tr>
342
+ <tr>
343
+ <td><code>align</code></td>
344
+ <td><code>left</code> (default) · <code>center</code> · <code>right</code></td>
345
+ <td>Alignment propagated to items (except square / circle <strong><code>shape</code></strong>)</td>
346
+ </tr>
347
+ <tr>
348
+ <td><code>size</code></td>
349
+ <td><code>xs</code> · <code>sm</code> · <code>md</code> · <code>lg</code> · <code>xl</code></td>
350
+ <td>Propagated to items and the <strong><code>more</code></strong> trigger when unset on the item</td>
351
+ </tr>
352
+ <tr>
353
+ <td><code>shadow</code></td>
354
+ <td><code>sm</code> · <code>md</code> · <code>lg</code></td>
355
+ <td>Shadow around the menu; omitted for none</td>
356
+ </tr>
357
+ <tr>
358
+ <td><code>minWidth</code></td>
359
+ <td>CSS length</td>
360
+ <td>Minimum width of the container (default <code>0</code>)</td>
361
+ </tr>
362
+ <tr>
363
+ <td><code>scrollable</code></td>
364
+ <td>boolean</td>
365
+ <td>Scroll with edge fade; auto-scroll when a single item is <strong><code>active</code></strong></td>
366
+ </tr>
367
+ <tr>
368
+ <td><code>moreShape</code></td>
369
+ <td><code>circle</code> (default) · <code>square</code></td>
370
+ <td>Shape of the <strong><code>more</code></strong> slot trigger button</td>
371
+ </tr>
372
+ </tbody></table>
373
+ <table>
374
+ <thead>
375
+ <tr>
376
+ <th>Slot</th>
377
+ <th>Description</th>
378
+ </tr>
379
+ </thead>
380
+ <tbody><tr>
381
+ <td><em>(default)</em></td>
382
+ <td>Visible items: <strong><code>sonic-menu-item</code></strong>, <strong><code>sonic-divider</code></strong>, nested <strong><code>sonic-menu</code></strong></td>
383
+ </tr>
384
+ <tr>
385
+ <td><code>more</code></td>
386
+ <td>Popover content for the “…” control; shown only when the slot has assigned nodes</td>
387
+ </tr>
388
+ </tbody></table>
389
+ <p><strong><code>sonic-menu-item</code></strong> extends <strong><code>sonic-button</code></strong> (defaults: <strong><code>variant=&quot;ghost&quot;</code></strong>, <strong><code>shape=&quot;block&quot;</code></strong>). Use the button docs for <strong><code>type</code></strong>, <strong><code>variant</code></strong>, <strong><code>href</code></strong>, <strong><code>pushstate</code></strong>, <strong><code>autoActive</code></strong>, and item slots.</p>
390
+
391
+ </article>
392
+ </main>
393
+ </body>
394
+ </html>