@supersoniks/concorde 5.1.0 → 5.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (628) 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/launch.json +15 -0
  6. package/.claude/vite.http.config.mjs +7 -0
  7. package/.taste-skill/after/desktop-fold.jpg +0 -0
  8. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  9. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  10. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  11. package/.taste-skill/after/mobile-fold.jpg +0 -0
  12. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  13. package/.taste-skill/after/report.json +4103 -0
  14. package/.taste-skill/after/tablet-fold.jpg +0 -0
  15. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  16. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  17. package/.taste-skill/before/desktop-fold.jpg +0 -0
  18. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  19. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  20. package/.taste-skill/before/mobile-fold.jpg +0 -0
  21. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  22. package/.taste-skill/before/report.json +2556 -0
  23. package/.taste-skill/before/tablet-fold.jpg +0 -0
  24. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  25. package/.taste-skill/direction.json +510 -0
  26. package/.taste-skill/notes.md +84 -0
  27. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  28. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  29. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  30. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  31. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  32. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  33. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  34. package/.taste-skill/prod/report.json +1973 -0
  35. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  36. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  37. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  38. package/.tmp-cem/custom-elements.json +2013 -2013
  39. package/AUDIT.md +228 -0
  40. package/PLAN-AMELIORATION.md +220 -0
  41. package/PLAN-DOCS-AGENTS.md +80 -0
  42. package/README.md +3 -3
  43. package/ai/skills/concorde/SKILL.md +1 -1
  44. package/ai/skills/concorde-get-set-dp/SKILL.md +3 -3
  45. package/ai/skills/concorde-theme/SKILL.md +1 -1
  46. package/build-infos.json +1 -1
  47. package/concorde-core.bundle.js +16 -16
  48. package/concorde-core.es.js +235 -233
  49. package/dist/concorde-core.bundle.js +16 -16
  50. package/dist/concorde-core.es.js +235 -233
  51. package/dist/img/archive/concorde-001-2cv.webp +0 -0
  52. package/dist/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  53. package/dist/img/archive/concorde-red-arrows-2002.webm +0 -0
  54. package/dist/img/archive/credits.json +28 -0
  55. package/docs/.htaccess +75 -0
  56. package/docs/404.html +15 -0
  57. package/docs/404.md +5 -0
  58. package/docs/assets/index-BgG6FFPt.js +11765 -0
  59. package/docs/assets/index-x89XINSG.css +1 -0
  60. package/docs/core/components/functional/date/date.html +211 -0
  61. package/docs/core/components/functional/date/date.md +150 -0
  62. package/docs/core/components/functional/fetch/fetch.html +180 -0
  63. package/docs/core/components/functional/fetch/fetch.md +108 -0
  64. package/docs/core/components/functional/if/if.html +65 -0
  65. package/docs/core/components/functional/if/if.md +34 -0
  66. package/docs/core/components/functional/jsonata/jsonata.html +110 -0
  67. package/docs/core/components/functional/jsonata/jsonata.md +61 -0
  68. package/docs/core/components/functional/list/list.html +198 -0
  69. package/docs/core/components/functional/list/list.md +121 -0
  70. package/docs/core/components/functional/mix/mix.html +78 -0
  71. package/docs/core/components/functional/mix/mix.md +46 -0
  72. package/docs/core/components/functional/queue/queue.html +155 -0
  73. package/docs/core/components/functional/queue/queue.md +51 -0
  74. package/docs/core/components/functional/router/router.html +154 -0
  75. package/docs/core/components/functional/router/router.md +93 -0
  76. package/docs/core/components/functional/sdui/sdui-extension-points.html +127 -0
  77. package/docs/core/components/functional/sdui/sdui-extension-points.md +94 -0
  78. package/docs/core/components/functional/sdui/sdui.html +397 -0
  79. package/docs/core/components/functional/sdui/sdui.md +307 -0
  80. package/docs/core/components/functional/states/states.html +141 -0
  81. package/docs/core/components/functional/states/states.md +112 -0
  82. package/docs/core/components/functional/submit/submit.html +178 -0
  83. package/docs/core/components/functional/submit/submit.md +106 -0
  84. package/docs/{crawl/core → core}/components/functional/subscriber/subscriber.html +6 -5
  85. package/docs/core/components/functional/subscriber/subscriber.md +91 -0
  86. package/docs/core/components/functional/translation/translation.html +60 -0
  87. package/docs/core/components/functional/translation/translation.md +38 -0
  88. package/docs/core/components/functional/value/value.html +81 -0
  89. package/docs/core/components/functional/value/value.md +47 -0
  90. package/docs/core/components/ui/alert/alert.html +201 -0
  91. package/docs/core/components/ui/alert/alert.md +186 -0
  92. package/docs/core/components/ui/alert-messages/alert-messages.html +132 -0
  93. package/docs/core/components/ui/alert-messages/alert-messages.md +85 -0
  94. package/docs/core/components/ui/badge/badge.html +197 -0
  95. package/docs/core/components/ui/badge/badge.md +181 -0
  96. package/docs/core/components/ui/button/button.html +309 -0
  97. package/docs/core/components/ui/button/button.md +216 -0
  98. package/docs/core/components/ui/captcha/captcha.html +80 -0
  99. package/docs/core/components/ui/captcha/captcha.md +56 -0
  100. package/docs/core/components/ui/card/card.html +254 -0
  101. package/docs/core/components/ui/card/card.md +215 -0
  102. package/docs/core/components/ui/divider/divider.html +144 -0
  103. package/docs/core/components/ui/divider/divider.md +126 -0
  104. package/docs/core/components/ui/form/checkbox/checkbox.html +200 -0
  105. package/docs/core/components/ui/form/checkbox/checkbox.md +125 -0
  106. package/docs/core/components/ui/form/fieldset/fieldset.html +238 -0
  107. package/docs/core/components/ui/form/fieldset/fieldset.md +161 -0
  108. package/docs/core/components/ui/form/form-actions/form-actions.html +122 -0
  109. package/docs/core/components/ui/form/form-actions/form-actions.md +98 -0
  110. package/docs/core/components/ui/form/form-layout/form-layout.html +115 -0
  111. package/docs/core/components/ui/form/form-layout/form-layout.md +109 -0
  112. package/docs/core/components/ui/form/input/input.html +235 -0
  113. package/docs/core/components/ui/form/input/input.md +142 -0
  114. package/docs/core/components/ui/form/radio/radio.html +144 -0
  115. package/docs/core/components/ui/form/radio/radio.md +78 -0
  116. package/docs/core/components/ui/form/select/select.html +178 -0
  117. package/docs/core/components/ui/form/select/select.md +86 -0
  118. package/docs/core/components/ui/form/switch/switch.html +146 -0
  119. package/docs/core/components/ui/form/switch/switch.md +80 -0
  120. package/docs/core/components/ui/form/textarea/textarea.html +162 -0
  121. package/docs/core/components/ui/form/textarea/textarea.md +82 -0
  122. package/docs/core/components/ui/group/group.html +113 -0
  123. package/docs/core/components/ui/group/group.md +77 -0
  124. package/docs/core/components/ui/icon/icon.html +223 -0
  125. package/docs/core/components/ui/icon/icon.md +214 -0
  126. package/docs/core/components/ui/image/image.html +194 -0
  127. package/docs/core/components/ui/image/image.md +167 -0
  128. package/docs/core/components/ui/link/link.html +101 -0
  129. package/docs/core/components/ui/link/link.md +81 -0
  130. package/docs/core/components/ui/loader/loader.html +114 -0
  131. package/docs/core/components/ui/loader/loader.md +87 -0
  132. package/docs/{crawl/core → core}/components/ui/menu/menu.html +189 -116
  133. package/docs/core/components/ui/menu/menu.md +370 -0
  134. package/docs/core/components/ui/modal/modal.html +324 -0
  135. package/docs/core/components/ui/modal/modal.md +211 -0
  136. package/docs/core/components/ui/pop/pop.html +250 -0
  137. package/docs/core/components/ui/pop/pop.md +216 -0
  138. package/docs/core/components/ui/progress/progress.html +132 -0
  139. package/docs/core/components/ui/progress/progress.md +109 -0
  140. package/docs/core/components/ui/table/table.html +333 -0
  141. package/docs/core/components/ui/table/table.md +267 -0
  142. package/docs/core/components/ui/theme/theme.html +116 -0
  143. package/docs/core/components/ui/theme/theme.md +97 -0
  144. package/docs/core/components/ui/toast/toast.html +185 -0
  145. package/docs/core/components/ui/toast/toast.md +147 -0
  146. package/docs/core/components/ui/tooltip/tooltip.html +112 -0
  147. package/docs/core/components/ui/tooltip/tooltip.md +89 -0
  148. package/docs/docs/decorators/ancestor-attribute.html +71 -0
  149. package/docs/docs/decorators/ancestor-attribute.md +59 -0
  150. package/docs/docs/decorators/auto-subscribe.html +61 -0
  151. package/docs/docs/decorators/auto-subscribe.md +40 -0
  152. package/docs/docs/decorators/bind.html +86 -0
  153. package/docs/docs/decorators/bind.md +77 -0
  154. package/docs/docs/decorators/get.html +166 -0
  155. package/docs/docs/decorators/get.md +160 -0
  156. package/docs/docs/decorators/handle.html +139 -0
  157. package/docs/docs/decorators/handle.md +119 -0
  158. package/docs/docs/decorators/on-assign.html +72 -0
  159. package/docs/docs/decorators/on-assign.md +63 -0
  160. package/docs/docs/decorators/patch.html +76 -0
  161. package/docs/docs/decorators/patch.md +44 -0
  162. package/docs/docs/decorators/post.html +150 -0
  163. package/docs/docs/decorators/post.md +134 -0
  164. package/docs/docs/decorators/publish.html +74 -0
  165. package/docs/docs/decorators/publish.md +56 -0
  166. package/docs/docs/decorators/put.html +83 -0
  167. package/docs/docs/decorators/put.md +51 -0
  168. package/docs/docs/decorators/subscribe.html +91 -0
  169. package/docs/docs/decorators/subscribe.md +87 -0
  170. package/docs/docs/decorators/wait-for-ancestors.html +82 -0
  171. package/docs/docs/decorators/wait-for-ancestors.md +76 -0
  172. package/docs/docs/directives/sub.html +79 -0
  173. package/docs/docs/directives/sub.md +75 -0
  174. package/docs/docs/directives/t.html +91 -0
  175. package/docs/docs/directives/t.md +73 -0
  176. package/docs/{crawl/docs/_getting-started → docs/getting-started}/ai-agents.html +12 -11
  177. package/{src/docs/_getting-started → docs/docs/getting-started}/ai-agents.md +3 -3
  178. package/docs/docs/getting-started/components.html +27 -0
  179. package/docs/docs/getting-started/components.md +5 -0
  180. package/docs/{crawl/docs/_getting-started → docs/getting-started}/create-a-component.html +11 -14
  181. package/docs/{src/docs/_getting-started → docs/getting-started}/create-a-component.md +3 -6
  182. package/docs/{crawl/docs/_core-concept → docs/getting-started}/dataFlow.html +26 -29
  183. package/docs/{src/docs/_core-concept → docs/getting-started}/dataFlow.md +17 -18
  184. package/docs/docs/getting-started/installation.html +69 -0
  185. package/docs/docs/getting-started/installation.md +36 -0
  186. package/docs/{crawl/docs/_getting-started → docs/getting-started}/my-first-component.html +13 -22
  187. package/docs/{src/docs/_getting-started → docs/getting-started}/my-first-component.md +5 -14
  188. package/docs/docs/getting-started/start.html +47 -0
  189. package/{src/docs/_getting-started → docs/docs/getting-started}/start.md +1 -13
  190. package/docs/docs/getting-started/theming.html +334 -0
  191. package/{src/docs/_getting-started → docs/docs/getting-started}/theming.md +2 -2
  192. package/docs/docs/index.html +99 -0
  193. package/docs/{crawl/docs/_misc → docs/misc}/api-configuration.html +18 -18
  194. package/docs/{src/docs/_misc → docs/misc}/api-configuration.md +10 -12
  195. package/docs/{crawl/docs/_misc → docs/misc}/dataProviderKey.html +12 -11
  196. package/{src/docs/_misc → docs/docs/misc}/dataProviderKey.md +4 -4
  197. package/docs/{crawl/docs/_misc → docs/misc}/docs-mock-api.html +25 -28
  198. package/docs/{src/docs/_misc → docs/misc}/docs-mock-api.md +12 -13
  199. package/docs/{crawl/docs/_misc → docs/misc}/dynamic-path.html +16 -15
  200. package/{src/docs/_misc → docs/docs/misc}/dynamic-path.md +8 -8
  201. package/docs/{crawl/docs/_misc → docs/misc}/endpoint.html +16 -15
  202. package/{src/docs/_misc → docs/docs/misc}/endpoint.md +8 -8
  203. package/docs/{crawl/docs/_misc → docs/misc}/html-integration.html +12 -15
  204. package/docs/{src/docs/_misc → docs/misc}/html-integration.md +4 -5
  205. package/docs/docs-mock-api-sw.js +60 -223
  206. package/docs/docs-mock-api-sw.js.map +4 -4
  207. package/docs/hubs/decorators.html +443 -0
  208. package/docs/hubs/form-components.html +404 -0
  209. package/docs/hubs/remote-data.html +371 -0
  210. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  211. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  212. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  213. package/docs/img/archive/credits.json +28 -0
  214. package/docs/img/concorde/plane_01.jpg +0 -0
  215. package/docs/img/concorde/plane_02.jpg +0 -0
  216. package/docs/img/concorde/plane_03.jpg +0 -0
  217. package/docs/img/concorde/plane_04.jpg +0 -0
  218. package/docs/img/concorde/plane_05.jpg +0 -0
  219. package/docs/img/concorde/plane_06.jpg +0 -0
  220. package/docs/img/concorde/plane_07.jpg +0 -0
  221. package/docs/img/concorde/plane_08.jpg +0 -0
  222. package/docs/img/concorde/plane_09.jpg +0 -0
  223. package/docs/img/concorde/plane_10.jpg +0 -0
  224. package/docs/img/concorde/plane_11.jpg +0 -0
  225. package/docs/img/concorde/plane_12.jpg +0 -0
  226. package/docs/img/concorde/plane_13.jpg +0 -0
  227. package/docs/index.html +96 -67
  228. package/docs/index.md +22 -0
  229. package/docs/llms-full.txt +3329 -3295
  230. package/docs/llms.txt +94 -92
  231. package/docs/robots.txt +11 -10
  232. package/docs/sitemap.xml +78 -78
  233. package/docs/src/core/components/functional/date/date.md +91 -231
  234. package/docs/src/core/components/functional/fetch/fetch.md +66 -83
  235. package/docs/src/core/components/functional/if/if.md +28 -3
  236. package/docs/src/core/components/functional/jsonata/jsonata.md +42 -37
  237. package/docs/src/core/components/functional/list/list.md +99 -43
  238. package/docs/src/core/components/functional/mix/mix.md +31 -26
  239. package/docs/src/core/components/functional/queue/queue.md +40 -61
  240. package/docs/src/core/components/functional/router/router.md +64 -65
  241. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  242. package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
  243. package/docs/src/core/components/functional/sdui/example.json +19 -86
  244. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  245. package/docs/src/core/components/functional/sdui/sdui.md +196 -245
  246. package/docs/src/core/components/functional/states/states.md +86 -61
  247. package/docs/src/core/components/functional/submit/submit.md +64 -72
  248. package/docs/src/core/components/functional/translation/translation.md +38 -0
  249. package/docs/src/core/components/functional/value/value.md +34 -22
  250. package/docs/src/core/components/ui/alert/alert.md +139 -74
  251. package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
  252. package/docs/src/core/components/ui/badge/badge.md +137 -83
  253. package/docs/src/core/components/ui/button/button.md +139 -105
  254. package/docs/src/core/components/ui/captcha/captcha.md +50 -6
  255. package/docs/src/core/components/ui/card/card.md +183 -65
  256. package/docs/src/core/components/ui/divider/divider.md +104 -13
  257. package/docs/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  258. package/docs/src/core/components/ui/form/fieldset/fieldset.md +135 -103
  259. package/docs/src/core/components/ui/form/form-actions/form-actions.md +71 -50
  260. package/docs/src/core/components/ui/form/form-layout/form-layout.md +99 -34
  261. package/docs/src/core/components/ui/form/input/input.md +95 -95
  262. package/docs/src/core/components/ui/form/radio/radio.md +55 -34
  263. package/docs/src/core/components/ui/form/select/select.md +60 -45
  264. package/docs/src/core/components/ui/form/switch/switch.md +57 -34
  265. package/docs/src/core/components/ui/form/textarea/textarea.md +55 -38
  266. package/docs/src/core/components/ui/group/group.md +49 -47
  267. package/docs/src/core/components/ui/icon/icon.md +132 -43
  268. package/docs/src/core/components/ui/image/image.md +132 -72
  269. package/docs/src/core/components/ui/link/link.md +46 -8
  270. package/docs/src/core/components/ui/loader/loader.md +55 -23
  271. package/docs/src/core/components/ui/menu/menu.md +155 -114
  272. package/docs/src/core/components/ui/modal/modal.md +154 -62
  273. package/docs/src/core/components/ui/pop/pop.md +185 -65
  274. package/docs/src/core/components/ui/progress/progress.md +76 -30
  275. package/docs/src/core/components/ui/table/table.md +146 -334
  276. package/docs/src/core/components/ui/theme/theme.md +97 -0
  277. package/docs/src/core/components/ui/toast/toast.md +80 -99
  278. package/docs/src/core/components/ui/tooltip/tooltip.md +52 -45
  279. package/docs/src/docs/decorators/ancestor-attribute.md +59 -0
  280. package/docs/src/docs/decorators/auto-subscribe.md +40 -0
  281. package/docs/src/docs/decorators/bind.md +77 -0
  282. package/docs/src/docs/decorators/get.md +160 -0
  283. package/docs/src/docs/decorators/handle.md +119 -0
  284. package/docs/src/docs/decorators/on-assign.md +63 -0
  285. package/docs/src/docs/decorators/patch.md +44 -0
  286. package/docs/src/docs/decorators/post.md +134 -0
  287. package/docs/src/docs/decorators/publish.md +56 -0
  288. package/docs/src/docs/decorators/put.md +51 -0
  289. package/docs/src/docs/decorators/subscribe.md +87 -0
  290. package/docs/src/docs/decorators/wait-for-ancestors.md +76 -0
  291. package/docs/src/docs/directives/sub.md +75 -0
  292. package/docs/src/docs/directives/t.md +73 -0
  293. package/docs/src/docs/{_getting-started → getting-started}/ai-agents.md +3 -3
  294. package/docs/src/docs/getting-started/components.md +5 -0
  295. package/{src/docs/_getting-started → docs/src/docs/getting-started}/create-a-component.md +3 -6
  296. package/{src/docs/_core-concept → docs/src/docs/getting-started}/dataFlow.md +17 -18
  297. package/docs/src/docs/getting-started/installation.md +36 -0
  298. package/{src/docs/_getting-started → docs/src/docs/getting-started}/my-first-component.md +5 -14
  299. package/docs/src/docs/getting-started/start.md +35 -0
  300. package/docs/src/docs/getting-started/theming.md +253 -0
  301. package/{src/docs/_misc → docs/src/docs/misc}/api-configuration.md +10 -12
  302. package/docs/src/docs/{_misc → misc}/dataProviderKey.md +4 -4
  303. package/{src/docs/_misc → docs/src/docs/misc}/docs-mock-api.md +12 -13
  304. package/docs/src/docs/{_misc → misc}/dynamic-path.md +8 -8
  305. package/docs/src/docs/{_misc → misc}/endpoint.md +8 -8
  306. package/{src/docs/_misc → docs/src/docs/misc}/html-integration.md +4 -5
  307. package/docs/src/docs/search/docs-search.json +3729 -2949
  308. package/docs/src/tsconfig.json +176 -5
  309. package/index.html +94 -67
  310. package/package.json +11 -4
  311. package/public/docs-mock-api-sw.js +58 -223
  312. package/public/docs-mock-api-sw.js.map +4 -4
  313. package/public/img/archive/concorde-001-2cv.webp +0 -0
  314. package/public/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  315. package/public/img/archive/concorde-red-arrows-2002.webm +0 -0
  316. package/public/img/archive/credits.json +28 -0
  317. package/public/img/concorde/plane_01.jpg +0 -0
  318. package/public/img/concorde/plane_02.jpg +0 -0
  319. package/public/img/concorde/plane_03.jpg +0 -0
  320. package/public/img/concorde/plane_04.jpg +0 -0
  321. package/public/img/concorde/plane_05.jpg +0 -0
  322. package/public/img/concorde/plane_06.jpg +0 -0
  323. package/public/img/concorde/plane_07.jpg +0 -0
  324. package/public/img/concorde/plane_08.jpg +0 -0
  325. package/public/img/concorde/plane_09.jpg +0 -0
  326. package/public/img/concorde/plane_10.jpg +0 -0
  327. package/public/img/concorde/plane_11.jpg +0 -0
  328. package/public/img/concorde/plane_12.jpg +0 -0
  329. package/public/img/concorde/plane_13.jpg +0 -0
  330. package/public/robots.txt +11 -10
  331. package/scripts/docs-markdown-vite-plugin.ts +37 -0
  332. package/scripts/docs-public-url.mjs +50 -0
  333. package/scripts/docs.htaccess +75 -0
  334. package/scripts/generate-crawl-docs.mjs +207 -116
  335. package/scripts/generate-crawl-docs.test.mjs +124 -0
  336. package/scripts/post-build-docs.js +34 -50
  337. package/scripts/post-build.mjs +0 -0
  338. package/src/core/components/functional/date/date.md +91 -231
  339. package/src/core/components/functional/fetch/fetch.md +66 -83
  340. package/src/core/components/functional/if/if.md +28 -3
  341. package/src/core/components/functional/if/if.ts +0 -0
  342. package/src/core/components/functional/jsonata/jsonata.md +42 -37
  343. package/src/core/components/functional/list/list.demo.ts +0 -0
  344. package/src/core/components/functional/list/list.md +99 -43
  345. package/src/core/components/functional/mix/mix.md +31 -26
  346. package/src/core/components/functional/queue/queue.demo.ts +10 -7
  347. package/src/core/components/functional/queue/queue.md +40 -61
  348. package/src/core/components/functional/router/router.demo.ts +16 -16
  349. package/src/core/components/functional/router/router.md +64 -65
  350. package/src/core/components/functional/router/router.ts +0 -0
  351. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  352. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  353. package/src/core/components/functional/sdui/component-catalog.json +1 -1
  354. package/src/core/components/functional/sdui/example.json +19 -86
  355. package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  356. package/src/core/components/functional/sdui/sdui.md +187 -358
  357. package/src/core/components/functional/sdui/types.ts +0 -0
  358. package/src/core/components/functional/states/states.demo.ts +21 -22
  359. package/src/core/components/functional/states/states.md +86 -61
  360. package/src/core/components/functional/states/states.ts +1 -1
  361. package/src/core/components/functional/submit/submit.md +64 -72
  362. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  363. package/src/core/components/functional/translation/translation.md +38 -0
  364. package/src/core/components/functional/value/value.md +34 -22
  365. package/src/core/components/functional/value/value.ts +0 -0
  366. package/src/core/components/ui/_css/size.ts +0 -0
  367. package/src/core/components/ui/alert/alert.md +48 -58
  368. package/src/core/components/ui/badge/badge.md +27 -34
  369. package/src/core/components/ui/button/button.md +139 -106
  370. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  371. package/src/core/components/ui/captcha/captcha.md +17 -32
  372. package/src/core/components/ui/card/card.md +6 -6
  373. package/src/core/components/ui/divider/divider.md +8 -11
  374. package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  375. package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
  376. package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
  377. package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
  378. package/src/core/components/ui/form/input/input.md +95 -95
  379. package/src/core/components/ui/form/radio/radio.md +55 -34
  380. package/src/core/components/ui/form/select/select.md +60 -45
  381. package/src/core/components/ui/form/switch/switch.md +57 -34
  382. package/src/core/components/ui/form/textarea/textarea.md +55 -38
  383. package/src/core/components/ui/group/group.md +35 -33
  384. package/src/core/components/ui/icon/icon.md +4 -4
  385. package/src/core/components/ui/image/image.md +41 -107
  386. package/src/core/components/ui/link/link.md +6 -6
  387. package/src/core/components/ui/loader/loader.md +30 -55
  388. package/src/core/components/ui/menu/menu.md +27 -27
  389. package/src/core/components/ui/modal/modal.md +72 -96
  390. package/src/core/components/ui/modal/modal.ts +14 -11
  391. package/src/core/components/ui/pop/pop.md +80 -158
  392. package/src/core/components/ui/progress/progress.md +2 -2
  393. package/src/core/components/ui/table/table.md +91 -255
  394. package/src/core/components/ui/theme/theme.md +11 -36
  395. package/src/core/components/ui/toast/toast.md +48 -117
  396. package/src/core/components/ui/tooltip/tooltip.md +27 -62
  397. package/src/core/mixins/Subscriber.ts +0 -0
  398. package/src/core/utils/DataBindObserver.ts +0 -0
  399. package/src/core/utils/LocationHandler.spec.ts +80 -0
  400. package/src/core/utils/LocationHandler.ts +5 -9
  401. package/src/core/utils/Objects.ts +0 -0
  402. package/src/core/utils/route.ts +0 -0
  403. package/src/docs/code.ts +88 -75
  404. package/src/docs/components/docs-demo-sources.ts +70 -147
  405. package/src/docs/components/docs-lit-demo.ts +20 -40
  406. package/src/docs/components/docs-source-link.ts +0 -82
  407. package/src/docs/decorators/ancestor-attribute.md +59 -0
  408. package/src/docs/decorators/auto-subscribe.md +40 -0
  409. package/src/docs/decorators/bind.md +77 -0
  410. package/src/docs/decorators/get.md +160 -0
  411. package/src/docs/decorators/handle.md +119 -0
  412. package/src/docs/decorators/on-assign.md +63 -0
  413. package/src/docs/decorators/patch.md +44 -0
  414. package/src/docs/decorators/post.md +134 -0
  415. package/src/docs/decorators/publish.md +56 -0
  416. package/src/docs/decorators/put.md +51 -0
  417. package/src/docs/decorators/subscribe.md +87 -0
  418. package/src/docs/decorators/wait-for-ancestors.md +76 -0
  419. package/src/docs/directives/sub.md +75 -0
  420. package/src/docs/directives/t.md +73 -0
  421. package/src/docs/docs-location.spec.ts +46 -0
  422. package/src/docs/docs-location.ts +123 -32
  423. package/src/docs/docs.ts +6 -2
  424. package/src/docs/example/decorators-demo-bind-demos.ts +81 -116
  425. package/src/docs/example/decorators-demo-geo.ts +30 -19
  426. package/src/docs/example/decorators-demo-post.ts +88 -186
  427. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
  428. package/src/docs/example/decorators-demo.ts +85 -98
  429. package/src/docs/example/docs-api-config-demos.ts +19 -20
  430. package/src/docs/example/docs-boarding-pass-demo.ts +134 -0
  431. package/src/docs/example/docs-flight-demos.ts +147 -0
  432. package/src/docs/example/docs-jsonata-demos.ts +52 -52
  433. package/src/docs/example/docs-list-demos.ts +43 -123
  434. package/src/docs/example/docs-provider-keys.ts +33 -28
  435. package/src/docs/example/docs-queue-demos.ts +37 -77
  436. package/src/docs/example/docs-router-demos.ts +20 -25
  437. package/src/docs/example/docs-submit-demos.ts +48 -48
  438. package/src/docs/example/docs-toggle-demos.ts +4 -3
  439. package/src/docs/example/users.ts +0 -0
  440. package/src/docs/getting-started/ai-agents.md +76 -0
  441. package/src/docs/getting-started/components.md +5 -0
  442. package/src/docs/getting-started/create-a-component.md +136 -0
  443. package/src/docs/getting-started/dataFlow.md +87 -0
  444. package/src/docs/getting-started/installation.md +36 -0
  445. package/src/docs/getting-started/my-first-component.md +227 -0
  446. package/src/docs/getting-started/start.md +35 -0
  447. package/src/docs/getting-started/theming.md +253 -0
  448. package/src/docs/header/header.ts +240 -71
  449. package/src/docs/home/catalog.ts +44 -0
  450. package/src/docs/home/home.ts +520 -0
  451. package/src/docs/home/mach-stage.ts +389 -0
  452. package/src/docs/layout.ts +12 -11
  453. package/src/docs/misc/api-configuration.md +79 -0
  454. package/src/docs/misc/dataProviderKey.md +168 -0
  455. package/src/docs/misc/docs-mock-api.md +62 -0
  456. package/src/docs/misc/dynamic-path.md +71 -0
  457. package/src/docs/misc/endpoint.md +45 -0
  458. package/src/docs/misc/html-integration.md +14 -0
  459. package/src/docs/mock-api/api-config-mock.ts +5 -0
  460. package/src/docs/mock-api/fixtures.ts +0 -278
  461. package/src/docs/mock-api/flights.ts +89 -0
  462. package/src/docs/mock-api/router.ts +3 -4
  463. package/src/docs/mock-api/urls.ts +1 -2
  464. package/src/docs/navigation/components-index.ts +56 -0
  465. package/src/docs/navigation/navigation.ts +219 -232
  466. package/src/docs/navigation/pager.ts +67 -0
  467. package/src/docs/navigation/toc.ts +101 -0
  468. package/src/docs/search/docs-search.json +2419 -4374
  469. package/src/docs/search/markdown-renderer.ts +33 -7
  470. package/src/docs/search/page.ts +9 -6
  471. package/src/docs/search/search.ts +154 -122
  472. package/src/docs/shiki/index.ts +109 -0
  473. package/src/docs/tailwind/css/base/scrollbar.css +22 -0
  474. package/src/docs/tailwind/css/base/theme.css +96 -0
  475. package/src/docs/tailwind/css/base/typography.css +4 -0
  476. package/src/docs/tailwind/css/docs/boarding-pass.css +65 -0
  477. package/src/docs/tailwind/css/docs/content.css +32 -0
  478. package/src/docs/tailwind/css/docs/page.css +10 -0
  479. package/src/docs/tailwind/css/docs.css +9 -0
  480. package/src/docs/tailwind/css/home/hero.css +210 -0
  481. package/src/docs/tailwind/css/home/motion.css +84 -0
  482. package/src/docs/tailwind/css/home/sections.css +416 -0
  483. package/src/docs/tailwind/css/tailwind.css +7 -185
  484. package/src/tsconfig.json +23 -2
  485. package/src/tsconfig.tsbuildinfo +1 -1
  486. package/tailwind.config.js +8 -4
  487. package/vite.config.mts +11 -2
  488. package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
  489. package/.github/workflows/ci.yml +0 -21
  490. package/.github-export-ignore +0 -30
  491. package/CONTRIBUTING.md +0 -59
  492. package/DEV.md +0 -54
  493. package/LICENSE +0 -21
  494. package/OPEN_SOURCE_CHECKPOINT.md +0 -133
  495. package/concorde-3d.bundle.js +0 -3960
  496. package/concorde-3d.es.js +0 -33433
  497. package/concorde-hugging-face-infer.bundle.js +0 -32
  498. package/concorde-hugging-face-infer.es.js +0 -2952
  499. package/concorde-interactive.bundle.js +0 -1157
  500. package/concorde-interactive.es.js +0 -10734
  501. package/concorde-shader.bundle.js +0 -116
  502. package/concorde-shader.es.js +0 -8353
  503. package/concorde-webgpu.bundle.js +0 -307
  504. package/concorde-webgpu.es.js +0 -8627
  505. package/docs/assets/index-D8MVWqY6.js +0 -12251
  506. package/docs/assets/index-DiD0qYvE.css +0 -1
  507. package/docs/crawl/core/components/functional/date/date.html +0 -190
  508. package/docs/crawl/core/components/functional/fetch/fetch.html +0 -109
  509. package/docs/crawl/core/components/functional/if/if.html +0 -27
  510. package/docs/crawl/core/components/functional/jsonata/jsonata.html +0 -79
  511. package/docs/crawl/core/components/functional/list/list.html +0 -70
  512. package/docs/crawl/core/components/functional/mix/mix.html +0 -45
  513. package/docs/crawl/core/components/functional/queue/queue.html +0 -96
  514. package/docs/crawl/core/components/functional/router/router.html +0 -106
  515. package/docs/crawl/core/components/functional/sdui/sdui.html +0 -269
  516. package/docs/crawl/core/components/functional/states/states.html +0 -66
  517. package/docs/crawl/core/components/functional/submit/submit.html +0 -160
  518. package/docs/crawl/core/components/functional/value/value.html +0 -51
  519. package/docs/crawl/core/components/ui/alert/alert.html +0 -110
  520. package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +0 -23
  521. package/docs/crawl/core/components/ui/badge/badge.html +0 -119
  522. package/docs/crawl/core/components/ui/button/button.html +0 -149
  523. package/docs/crawl/core/components/ui/captcha/captcha.html +0 -30
  524. package/docs/crawl/core/components/ui/card/card.html +0 -99
  525. package/docs/crawl/core/components/ui/divider/divider.html +0 -58
  526. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +0 -73
  527. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +0 -135
  528. package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +0 -79
  529. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +0 -62
  530. package/docs/crawl/core/components/ui/form/input/input.html +0 -109
  531. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +0 -38
  532. package/docs/crawl/core/components/ui/form/radio/radio.html +0 -56
  533. package/docs/crawl/core/components/ui/form/select/select.html +0 -73
  534. package/docs/crawl/core/components/ui/form/switch/switch.html +0 -56
  535. package/docs/crawl/core/components/ui/form/textarea/textarea.html +0 -59
  536. package/docs/crawl/core/components/ui/group/group.html +0 -82
  537. package/docs/crawl/core/components/ui/icon/icon.html +0 -133
  538. package/docs/crawl/core/components/ui/image/image.html +0 -110
  539. package/docs/crawl/core/components/ui/link/link.html +0 -42
  540. package/docs/crawl/core/components/ui/loader/loader.html +0 -50
  541. package/docs/crawl/core/components/ui/modal/modal.html +0 -117
  542. package/docs/crawl/core/components/ui/pop/pop.html +0 -102
  543. package/docs/crawl/core/components/ui/progress/progress.html +0 -58
  544. package/docs/crawl/core/components/ui/table/table.html +0 -413
  545. package/docs/crawl/core/components/ui/toast/toast.html +0 -122
  546. package/docs/crawl/core/components/ui/tooltip/tooltip.html +0 -79
  547. package/docs/crawl/docs/_core-concept/overview.html +0 -66
  548. package/docs/crawl/docs/_core-concept/subscriber.html +0 -75
  549. package/docs/crawl/docs/_decorators/ancestor-attribute.html +0 -116
  550. package/docs/crawl/docs/_decorators/auto-subscribe.html +0 -202
  551. package/docs/crawl/docs/_decorators/bind.html +0 -141
  552. package/docs/crawl/docs/_decorators/get.html +0 -149
  553. package/docs/crawl/docs/_decorators/handle.html +0 -165
  554. package/docs/crawl/docs/_decorators/on-assign.html +0 -355
  555. package/docs/crawl/docs/_decorators/patch.html +0 -78
  556. package/docs/crawl/docs/_decorators/post.html +0 -139
  557. package/docs/crawl/docs/_decorators/publish.html +0 -61
  558. package/docs/crawl/docs/_decorators/put.html +0 -78
  559. package/docs/crawl/docs/_decorators/subscribe.html +0 -109
  560. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +0 -137
  561. package/docs/crawl/docs/_directives/sub.html +0 -93
  562. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +0 -100
  563. package/docs/crawl/docs/_getting-started/concorde-outside.html +0 -58
  564. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +0 -110
  565. package/docs/crawl/docs/_getting-started/pubsub.html +0 -62
  566. package/docs/crawl/docs/_getting-started/start.html +0 -76
  567. package/docs/crawl/docs/_getting-started/theming.html +0 -85
  568. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +0 -138
  569. package/docs/crawl/hubs/decorators.html +0 -547
  570. package/docs/crawl/hubs/form-components.html +0 -359
  571. package/docs/crawl/hubs/remote-data.html +0 -452
  572. package/docs/crawl/index.html +0 -101
  573. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  574. package/docs/src/docs/_core-concept/overview.md +0 -57
  575. package/docs/src/docs/_core-concept/subscriber.md +0 -75
  576. package/docs/src/docs/_decorators/ancestor-attribute.md +0 -127
  577. package/docs/src/docs/_decorators/auto-subscribe.md +0 -202
  578. package/docs/src/docs/_decorators/bind.md +0 -167
  579. package/docs/src/docs/_decorators/get.md +0 -162
  580. package/docs/src/docs/_decorators/handle.md +0 -175
  581. package/docs/src/docs/_decorators/on-assign.md +0 -390
  582. package/docs/src/docs/_decorators/patch.md +0 -70
  583. package/docs/src/docs/_decorators/post.md +0 -146
  584. package/docs/src/docs/_decorators/publish.md +0 -55
  585. package/docs/src/docs/_decorators/put.md +0 -70
  586. package/docs/src/docs/_decorators/subscribe.md +0 -100
  587. package/docs/src/docs/_decorators/wait-for-ancestors.md +0 -163
  588. package/docs/src/docs/_directives/sub.md +0 -91
  589. package/docs/src/docs/_getting-started/concorde-manual-install.md +0 -133
  590. package/docs/src/docs/_getting-started/concorde-outside.md +0 -33
  591. package/docs/src/docs/_getting-started/my-first-subscriber.md +0 -120
  592. package/docs/src/docs/_getting-started/pubsub.md +0 -37
  593. package/docs/src/docs/_getting-started/start.md +0 -47
  594. package/docs/src/docs/_getting-started/theming.md +0 -91
  595. package/docs/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  596. package/docs/src/tsconfig.declarations.json +0 -22
  597. package/docs/src/tsconfig.emit.json +0 -23
  598. package/gitlab/job_github_mirror.sh +0 -39
  599. package/scripts/github-export.mjs +0 -150
  600. package/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  601. package/src/css.d.ts +0 -19
  602. package/src/docs/_core-concept/overview.md +0 -57
  603. package/src/docs/_core-concept/subscriber.md +0 -75
  604. package/src/docs/_decorators/ancestor-attribute.md +0 -128
  605. package/src/docs/_decorators/auto-subscribe.md +0 -202
  606. package/src/docs/_decorators/bind.md +0 -167
  607. package/src/docs/_decorators/get.md +0 -162
  608. package/src/docs/_decorators/handle.md +0 -175
  609. package/src/docs/_decorators/on-assign.md +0 -390
  610. package/src/docs/_decorators/patch.md +0 -70
  611. package/src/docs/_decorators/post.md +0 -146
  612. package/src/docs/_decorators/publish.md +0 -55
  613. package/src/docs/_decorators/put.md +0 -70
  614. package/src/docs/_decorators/subscribe.md +0 -100
  615. package/src/docs/_decorators/wait-for-ancestors.md +0 -163
  616. package/src/docs/_directives/sub.md +0 -91
  617. package/src/docs/_getting-started/concorde-manual-install.md +0 -133
  618. package/src/docs/_getting-started/concorde-outside.md +0 -33
  619. package/src/docs/_getting-started/my-first-subscriber.md +0 -120
  620. package/src/docs/_getting-started/pubsub.md +0 -37
  621. package/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  622. package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
  623. package/src/docs/example/docs-joke-demos.ts +0 -297
  624. package/src/docs/prism/index.ts +0 -6
  625. package/src/docs/prism/prism.css +0 -158
  626. package/src/docs/prism/prism.js +0 -1022
  627. package/src/tsconfig.declarations.json +0 -22
  628. package/src/tsconfig.emit.json +0 -23
@@ -0,0 +1,80 @@
1
+ # Switch
2
+
3
+ **`sonic-switch`** is a toggle-styled [Checkbox](/core/components/ui/form/checkbox) in `unique` mode: when on, it stores its `value` under `name` in the **`formDataProvider`** data; when off, it stores `null`. Switches sharing a `name` behave as one choice, so give independent switches distinct names. Label goes in the default slot or `label`, helper text in the `description` slot.
4
+
5
+ ## Basic example
6
+
7
+ <sonic-code>
8
+ <template>
9
+ <div formDataProvider="switch-basic-demo" class="grid gap-2">
10
+ <sonic-switch name="notifications" value="on" checked>
11
+ Notifications
12
+ <span slot="description">Get an alert when your gate changes.</span>
13
+ </sonic-switch>
14
+ <div>Value: <sonic-value dataProvider="switch-basic-demo" key="notifications"></sonic-value></div>
15
+ </div>
16
+ </template>
17
+ </sonic-code>
18
+
19
+ ## Size
20
+
21
+ With no `size`, the switch follows `md` (1rem).
22
+
23
+ <sonic-code>
24
+ <template>
25
+ <div class="grid gap-2">
26
+ <sonic-switch size="2xs">2xs</sonic-switch>
27
+ <sonic-switch size="xs">xs</sonic-switch>
28
+ <sonic-switch size="sm">sm</sonic-switch>
29
+ <sonic-switch>Default</sonic-switch>
30
+ <sonic-switch size="lg">lg</sonic-switch>
31
+ <sonic-switch size="xl">xl</sonic-switch>
32
+ <sonic-switch size="2xl">2xl</sonic-switch>
33
+ </div>
34
+ </template>
35
+ </sonic-code>
36
+
37
+ ## Checked and disabled
38
+
39
+ `checked` sets the initial state. `disabled` blocks interaction and dims the control.
40
+
41
+ <sonic-code>
42
+ <template>
43
+ <div class="grid gap-2">
44
+ <sonic-switch checked>Checked</sonic-switch>
45
+ <sonic-switch disabled>Disabled</sonic-switch>
46
+ <sonic-switch disabled checked>Disabled and checked</sonic-switch>
47
+ <sonic-switch>I accept the <sonic-link href="#" class="underline">terms</sonic-link></sonic-switch>
48
+ </div>
49
+ </template>
50
+ </sonic-code>
51
+
52
+ ## Filtering a list
53
+
54
+ On, the switch writes `status=delayed` to the store used as `dataFilterProvider` by a `sonic-queue`; off, it writes `null` and the filter is dropped.
55
+
56
+ <docs-lit-demo for="docs-flight-delayed-switch-demo"></docs-lit-demo>
57
+
58
+ ## API reference
59
+
60
+ | Attribute | Values | Description |
61
+ |----------|---------|-------------|
62
+ | `name` | string | Key in the form data (dot notation supported) |
63
+ | `value` | string | Value stored when on |
64
+ | `formDataProvider` | string | Form data id; inherited from the closest ancestor when omitted |
65
+ | `checked` | boolean | Initial state |
66
+ | `unsetOnDisconnect` | boolean | Removes the value from the data when the element is removed |
67
+ | `label` | string (HTML) | Label, rendered before the default slot |
68
+ | `description` | string (HTML) | Helper text, rendered in the `description` slot |
69
+ | `size` | `2xs` … `2xl` · `inherit` (default `md`) | Font size and track size |
70
+ | `disabled` | boolean | Blocks interaction |
71
+ | `required` | boolean | Native validation on form submit |
72
+ | `autofocus` | boolean | Focuses the input on load |
73
+ | `data-aria-label` · `data-aria-labelledby` | string | Forwarded to the inner input as `aria-label` / `aria-labelledby` |
74
+
75
+ | Slot | Description |
76
+ |------|-------------|
77
+ | *(default)* | Label content (text, links) |
78
+ | `description` | Helper text under the label |
79
+
80
+ Fires a `change` event on each click.
@@ -0,0 +1,162 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/ui/form/textarea" data-doc-id="core/components/ui/form/textarea/textarea">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Textarea — Concorde by Supersoniks</title>
7
+ <meta name="description" content="sonic-textarea wraps a native &lt;textarea&gt; with a label, a description and Concorde sizes. Native attributes (rows, cols, maxlength, wrap, …) are passed through. Bind the value to a store with formDataP">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/ui/form/textarea/textarea, textarea, Textarea, UI component, form, sonic-textarea, web component, , rows, cols, maxlength, wrap, formDataProvider, name, resize">
9
+ <meta name="concorde-doc-id" content="core/components/ui/form/textarea/textarea">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/core/components/ui/form/textarea">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/ui/form/textarea.md">
12
+ </head>
13
+ <body>
14
+ <header>
15
+ <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/core/components/ui/form/textarea">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
16
+ </header>
17
+ <main>
18
+ <article>
19
+ <p class="doc-lead" id="doc-summary"><strong>Concorde UI component — Textarea</strong>. sonic-textarea wraps a native &lt;textarea&gt; with a label, a description and Concorde sizes. Native attributes (rows, cols, maxlength, wrap, …) are passed through. Bind the value to a store with formDataP <span>Doc ID: <code>core/components/ui/form/textarea/textarea</code>. Keywords: Concorde, supersoniks, core/components/ui/form/textarea/textarea, textarea, Textarea, UI component, form, sonic-textarea, web component, , rows, cols, maxlength, wrap, formDataProvider, name, resize. URL: <a href="https://concorde.supersoniks.org/core/components/ui/form/textarea">https://concorde.supersoniks.org/core/components/ui/form/textarea</a>.</span></p>
20
+ <h1 id="textarea">Textarea</h1>
21
+ <p><strong><code>sonic-textarea</code></strong> wraps a native <code>&lt;textarea&gt;</code> with a label, a description and Concorde sizes. Native attributes (<code>rows</code>, <code>cols</code>, <code>maxlength</code>, <code>wrap</code>, …) are passed through. Bind the value to a store with <strong><code>formDataProvider</code></strong> and <strong><code>name</code></strong>, set on the field or on an ancestor.</p>
22
+ <h2 id="basic-example">Basic example</h2>
23
+ <pre><code>&lt;sonic-textarea label=&quot;Comments to the crew&quot; placeholder=&quot;Write your message&quot; description=&quot;Plain text only.&quot;&gt;&lt;/sonic-textarea&gt;
24
+ </code></pre>
25
+ <h2 id="rows-and-resize">Rows and resize</h2>
26
+ <p><code>rows</code> sets the visible height. With no <code>resize</code>, the user can resize vertically only.</p>
27
+ <pre><code>&lt;div class=&quot;grid gap-3&quot;&gt;
28
+ &lt;sonic-textarea rows=&quot;6&quot; label=&quot;Six rows&quot;&gt;&lt;/sonic-textarea&gt;
29
+ &lt;sonic-textarea resize=&quot;none&quot; label=&quot;Not resizable&quot;&gt;&lt;/sonic-textarea&gt;
30
+ &lt;/div&gt;
31
+ </code></pre>
32
+ <h2 id="size-and-status">Size and status</h2>
33
+ <p>With no <code>size</code>, the textarea uses <code>md</code>. <code>status</code> colors the field; it defaults to <code>default</code>.</p>
34
+ <pre><code>&lt;div class=&quot;grid gap-3&quot;&gt;
35
+ &lt;sonic-textarea rows=&quot;1&quot; size=&quot;2xs&quot; value=&quot;2xs&quot;&gt;&lt;/sonic-textarea&gt;
36
+ &lt;sonic-textarea rows=&quot;1&quot; size=&quot;xs&quot; value=&quot;xs&quot;&gt;&lt;/sonic-textarea&gt;
37
+ &lt;sonic-textarea rows=&quot;1&quot; size=&quot;sm&quot; value=&quot;sm&quot;&gt;&lt;/sonic-textarea&gt;
38
+ &lt;sonic-textarea rows=&quot;1&quot; value=&quot;default&quot;&gt;&lt;/sonic-textarea&gt;
39
+ &lt;sonic-textarea rows=&quot;1&quot; size=&quot;lg&quot; value=&quot;lg&quot;&gt;&lt;/sonic-textarea&gt;
40
+ &lt;sonic-textarea rows=&quot;1&quot; size=&quot;xl&quot; value=&quot;xl&quot;&gt;&lt;/sonic-textarea&gt;
41
+ &lt;sonic-textarea rows=&quot;1&quot; size=&quot;2xl&quot; value=&quot;2xl&quot;&gt;&lt;/sonic-textarea&gt;
42
+ &lt;sonic-textarea rows=&quot;1&quot; status=&quot;success&quot; value=&quot;success&quot;&gt;&lt;/sonic-textarea&gt;
43
+ &lt;sonic-textarea rows=&quot;1&quot; status=&quot;error&quot; value=&quot;error&quot;&gt;&lt;/sonic-textarea&gt;
44
+ &lt;sonic-textarea rows=&quot;1&quot; status=&quot;warning&quot; value=&quot;warning&quot;&gt;&lt;/sonic-textarea&gt;
45
+ &lt;sonic-textarea rows=&quot;1&quot; status=&quot;info&quot; value=&quot;info&quot;&gt;&lt;/sonic-textarea&gt;
46
+ &lt;/div&gt;
47
+ </code></pre>
48
+ <h2 id="validation">Validation</h2>
49
+ <p><code>required</code>, <code>minlength</code> and <code>maxlength</code> are checked by the browser. Feedback styles apply once the field is <code>touched</code> (after blur).</p>
50
+ <pre><code>&lt;sonic-textarea required minlength=&quot;10&quot; label=&quot;Special assistance request&quot; placeholder=&quot;At least 10 characters&quot;&gt;&lt;/sonic-textarea&gt;
51
+ </code></pre>
52
+ <h2 id="api-reference">API reference</h2>
53
+ <table>
54
+ <thead>
55
+ <tr>
56
+ <th>Attribute</th>
57
+ <th>Values</th>
58
+ <th>Description</th>
59
+ </tr>
60
+ </thead>
61
+ <tbody><tr>
62
+ <td><code>name</code></td>
63
+ <td>string</td>
64
+ <td>Key in the form store (dot notation allowed)</td>
65
+ </tr>
66
+ <tr>
67
+ <td><code>value</code></td>
68
+ <td>string</td>
69
+ <td>Initial value</td>
70
+ </tr>
71
+ <tr>
72
+ <td><code>formDataProvider</code></td>
73
+ <td>string</td>
74
+ <td>Store id; inherited from the closest ancestor</td>
75
+ </tr>
76
+ <tr>
77
+ <td><code>label</code></td>
78
+ <td>string (HTML)</td>
79
+ <td>Label; or use the <code>label</code> slot</td>
80
+ </tr>
81
+ <tr>
82
+ <td><code>description</code></td>
83
+ <td>string (HTML)</td>
84
+ <td>Help text under the field; or use the <code>description</code> slot</td>
85
+ </tr>
86
+ <tr>
87
+ <td><code>placeholder</code></td>
88
+ <td>string</td>
89
+ <td>Native placeholder</td>
90
+ </tr>
91
+ <tr>
92
+ <td><code>size</code></td>
93
+ <td><code>2xs</code> … <code>2xl</code> (default <code>md</code>)</td>
94
+ <td>Typography and padding</td>
95
+ </tr>
96
+ <tr>
97
+ <td><code>status</code></td>
98
+ <td><code>default</code> · <code>success</code> · <code>error</code> · <code>warning</code> · <code>info</code></td>
99
+ <td>Field color</td>
100
+ </tr>
101
+ <tr>
102
+ <td><code>rows</code> · <code>cols</code></td>
103
+ <td>number</td>
104
+ <td>Native dimensions</td>
105
+ </tr>
106
+ <tr>
107
+ <td><code>minlength</code> · <code>maxlength</code></td>
108
+ <td>number</td>
109
+ <td>Native length constraints</td>
110
+ </tr>
111
+ <tr>
112
+ <td><code>wrap</code></td>
113
+ <td><code>soft</code> · <code>hard</code></td>
114
+ <td>Native wrapping</td>
115
+ </tr>
116
+ <tr>
117
+ <td><code>resize</code></td>
118
+ <td><code>vertical</code> · <code>horizontal</code> · <code>both</code> · <code>none</code> · <code>block</code> · <code>inline</code> (default <code>vertical</code>)</td>
119
+ <td>CSS resize handle</td>
120
+ </tr>
121
+ <tr>
122
+ <td><code>required</code> · <code>disabled</code> · <code>readonly</code> · <code>autofocus</code></td>
123
+ <td>boolean</td>
124
+ <td>Native flags</td>
125
+ </tr>
126
+ <tr>
127
+ <td><code>autocomplete</code> · <code>tabindex</code></td>
128
+ <td>native</td>
129
+ <td>Passed to the inner <code>&lt;textarea&gt;</code></td>
130
+ </tr>
131
+ <tr>
132
+ <td><code>data-aria-label</code> · <code>data-aria-labelledby</code></td>
133
+ <td>string</td>
134
+ <td>Forwarded as <code>aria-label</code> and <code>aria-labelledby</code></td>
135
+ </tr>
136
+ <tr>
137
+ <td><code>unsetOnDisconnect</code></td>
138
+ <td>boolean</td>
139
+ <td>Clears the store value when the element is removed</td>
140
+ </tr>
141
+ </tbody></table>
142
+ <table>
143
+ <thead>
144
+ <tr>
145
+ <th>Slot</th>
146
+ <th>Description</th>
147
+ </tr>
148
+ </thead>
149
+ <tbody><tr>
150
+ <td><code>label</code></td>
151
+ <td>Rich label content</td>
152
+ </tr>
153
+ <tr>
154
+ <td><code>description</code></td>
155
+ <td>Rich help text</td>
156
+ </tr>
157
+ </tbody></table>
158
+
159
+ </article>
160
+ </main>
161
+ </body>
162
+ </html>
@@ -0,0 +1,82 @@
1
+ # Textarea
2
+
3
+ **`sonic-textarea`** wraps a native `<textarea>` with a label, a description and Concorde sizes. Native attributes (`rows`, `cols`, `maxlength`, `wrap`, …) are passed through. Bind the value to a store with **`formDataProvider`** and **`name`**, set on the field or on an ancestor.
4
+
5
+ ## Basic example
6
+
7
+ <sonic-code>
8
+ <template>
9
+ <sonic-textarea label="Comments to the crew" placeholder="Write your message" description="Plain text only."></sonic-textarea>
10
+ </template>
11
+ </sonic-code>
12
+
13
+ ## Rows and resize
14
+
15
+ `rows` sets the visible height. With no `resize`, the user can resize vertically only.
16
+
17
+ <sonic-code>
18
+ <template>
19
+ <div class="grid gap-3">
20
+ <sonic-textarea rows="6" label="Six rows"></sonic-textarea>
21
+ <sonic-textarea resize="none" label="Not resizable"></sonic-textarea>
22
+ </div>
23
+ </template>
24
+ </sonic-code>
25
+
26
+ ## Size and status
27
+
28
+ With no `size`, the textarea uses `md`. `status` colors the field; it defaults to `default`.
29
+
30
+ <sonic-code>
31
+ <template>
32
+ <div class="grid gap-3">
33
+ <sonic-textarea rows="1" size="2xs" value="2xs"></sonic-textarea>
34
+ <sonic-textarea rows="1" size="xs" value="xs"></sonic-textarea>
35
+ <sonic-textarea rows="1" size="sm" value="sm"></sonic-textarea>
36
+ <sonic-textarea rows="1" value="default"></sonic-textarea>
37
+ <sonic-textarea rows="1" size="lg" value="lg"></sonic-textarea>
38
+ <sonic-textarea rows="1" size="xl" value="xl"></sonic-textarea>
39
+ <sonic-textarea rows="1" size="2xl" value="2xl"></sonic-textarea>
40
+ <sonic-textarea rows="1" status="success" value="success"></sonic-textarea>
41
+ <sonic-textarea rows="1" status="error" value="error"></sonic-textarea>
42
+ <sonic-textarea rows="1" status="warning" value="warning"></sonic-textarea>
43
+ <sonic-textarea rows="1" status="info" value="info"></sonic-textarea>
44
+ </div>
45
+ </template>
46
+ </sonic-code>
47
+
48
+ ## Validation
49
+
50
+ `required`, `minlength` and `maxlength` are checked by the browser. Feedback styles apply once the field is `touched` (after blur).
51
+
52
+ <sonic-code>
53
+ <template>
54
+ <sonic-textarea required minlength="10" label="Special assistance request" placeholder="At least 10 characters"></sonic-textarea>
55
+ </template>
56
+ </sonic-code>
57
+
58
+ ## API reference
59
+
60
+ | Attribute | Values | Description |
61
+ |----------|---------|-------------|
62
+ | `name` | string | Key in the form store (dot notation allowed) |
63
+ | `value` | string | Initial value |
64
+ | `formDataProvider` | string | Store id; inherited from the closest ancestor |
65
+ | `label` | string (HTML) | Label; or use the `label` slot |
66
+ | `description` | string (HTML) | Help text under the field; or use the `description` slot |
67
+ | `placeholder` | string | Native placeholder |
68
+ | `size` | `2xs` … `2xl` (default `md`) | Typography and padding |
69
+ | `status` | `default` · `success` · `error` · `warning` · `info` | Field color |
70
+ | `rows` · `cols` | number | Native dimensions |
71
+ | `minlength` · `maxlength` | number | Native length constraints |
72
+ | `wrap` | `soft` · `hard` | Native wrapping |
73
+ | `resize` | `vertical` · `horizontal` · `both` · `none` · `block` · `inline` (default `vertical`) | CSS resize handle |
74
+ | `required` · `disabled` · `readonly` · `autofocus` | boolean | Native flags |
75
+ | `autocomplete` · `tabindex` | native | Passed to the inner `<textarea>` |
76
+ | `data-aria-label` · `data-aria-labelledby` | string | Forwarded as `aria-label` and `aria-labelledby` |
77
+ | `unsetOnDisconnect` | boolean | Clears the store value when the element is removed |
78
+
79
+ | Slot | Description |
80
+ |------|-------------|
81
+ | `label` | Rich label content |
82
+ | `description` | Rich help text |
@@ -0,0 +1,113 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/ui/group" data-doc-id="core/components/ui/group/group">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Group — Concorde by Supersoniks</title>
7
+ <meta name="description" content="sonic-group lays out sonic-button · sonic-input and sonic-select controls in one row with a shared corner radius: only the outer corners of the first and last items stay rounded. Use it for button gro">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/ui/group/group, group, Group, UI component, sonic-group, web component, sonic-button, sonic-input, sonic-select, label, description, radio, name, value">
9
+ <meta name="concorde-doc-id" content="core/components/ui/group/group">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/core/components/ui/group">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/ui/group.md">
12
+ </head>
13
+ <body>
14
+ <header>
15
+ <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/core/components/ui/group">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
16
+ </header>
17
+ <main>
18
+ <article>
19
+ <p class="doc-lead" id="doc-summary"><strong>Concorde UI component — Group</strong>. sonic-group lays out sonic-button · sonic-input and sonic-select controls in one row with a shared corner radius: only the outer corners of the first and last items stay rounded. Use it for button gro <span>Doc ID: <code>core/components/ui/group/group</code>. Keywords: Concorde, supersoniks, core/components/ui/group/group, group, Group, UI component, sonic-group, web component, sonic-button, sonic-input, sonic-select, label, description, radio, name, value. URL: <a href="https://concorde.supersoniks.org/core/components/ui/group">https://concorde.supersoniks.org/core/components/ui/group</a>.</span></p>
20
+ <h1 id="group">Group</h1>
21
+ <p><strong><code>sonic-group</code></strong> lays out <code>sonic-button</code> · <code>sonic-input</code> and <code>sonic-select</code> controls in one row with a <strong>shared corner radius</strong>: only the outer corners of the first and last items stay rounded. Use it for button groups, radio rows or a field with an attached action. Optional <code>label</code> and <code>description</code> follow form field styling.</p>
22
+ <h2 id="radio-group">Radio group</h2>
23
+ <p>Give each <code>sonic-button</code> the <code>radio</code> attribute and a shared <code>name</code>. The selected <code>value</code> is written to the <code>formDataProvider</code> set on the group (inherited by the buttons).</p>
24
+ <pre><code>&lt;sonic-group formDataProvider=&quot;groupPlanDemo&quot;&gt;
25
+ &lt;sonic-button radio name=&quot;plan&quot; value=&quot;free&quot; type=&quot;default&quot;&gt;Free&lt;/sonic-button&gt;
26
+ &lt;sonic-button radio checked name=&quot;plan&quot; value=&quot;pro&quot; type=&quot;default&quot;&gt;Pro&lt;/sonic-button&gt;
27
+ &lt;sonic-button radio name=&quot;plan&quot; value=&quot;team&quot; type=&quot;default&quot;&gt;Team&lt;/sonic-button&gt;
28
+ &lt;/sonic-group&gt;
29
+ </code></pre>
30
+ <h2 id="button-group">Button group</h2>
31
+ <p>Adjacent action buttons that stay independent controls.</p>
32
+ <pre><code>&lt;sonic-group&gt;
33
+ &lt;sonic-button type=&quot;default&quot;&gt;
34
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;align-left&quot;&gt;&lt;/sonic-icon&gt;
35
+ &lt;/sonic-button&gt;
36
+ &lt;sonic-button type=&quot;default&quot;&gt;
37
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;align-center&quot;&gt;&lt;/sonic-icon&gt;
38
+ &lt;/sonic-button&gt;
39
+ &lt;sonic-button type=&quot;default&quot;&gt;
40
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;align-right&quot;&gt;&lt;/sonic-icon&gt;
41
+ &lt;/sonic-button&gt;
42
+ &lt;/sonic-group&gt;
43
+ </code></pre>
44
+ <h2 id="field-with-action">Field with action</h2>
45
+ <p>Put the action before or after the field. <code>label</code> and <code>description</code> annotate the whole row.</p>
46
+ <pre><code>&lt;div class=&quot;grid gap-4 max-w-md&quot;&gt;
47
+ &lt;sonic-group label=&quot;Search&quot; description=&quot;Type a flight number, then confirm.&quot;&gt;
48
+ &lt;sonic-input placeholder=&quot;CN 001&quot;&gt;&lt;/sonic-input&gt;
49
+ &lt;sonic-button type=&quot;primary&quot; shape=&quot;square&quot;&gt;
50
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;search&quot;&gt;&lt;/sonic-icon&gt;
51
+ &lt;/sonic-button&gt;
52
+ &lt;/sonic-group&gt;
53
+ &lt;sonic-group label=&quot;Extra baggage&quot;&gt;
54
+ &lt;sonic-button type=&quot;default&quot; shape=&quot;square&quot;&gt;
55
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;minus&quot;&gt;&lt;/sonic-icon&gt;
56
+ &lt;/sonic-button&gt;
57
+ &lt;sonic-input type=&quot;number&quot; value=&quot;1&quot;&gt;&lt;/sonic-input&gt;
58
+ &lt;sonic-button type=&quot;default&quot; shape=&quot;square&quot;&gt;
59
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;plus&quot;&gt;&lt;/sonic-icon&gt;
60
+ &lt;/sonic-button&gt;
61
+ &lt;/sonic-group&gt;
62
+ &lt;/div&gt;
63
+ </code></pre>
64
+ <h2 id="api-reference">API reference</h2>
65
+ <table>
66
+ <thead>
67
+ <tr>
68
+ <th>Attribute</th>
69
+ <th>Values</th>
70
+ <th>Description</th>
71
+ </tr>
72
+ </thead>
73
+ <tbody><tr>
74
+ <td><code>label</code></td>
75
+ <td>string (HTML)</td>
76
+ <td>Label above the row; content of <code>slot=&quot;label&quot;</code> is appended</td>
77
+ </tr>
78
+ <tr>
79
+ <td><code>description</code></td>
80
+ <td>string (HTML)</td>
81
+ <td>Help text below the row; content of <code>slot=&quot;description&quot;</code> replaces it</td>
82
+ </tr>
83
+ <tr>
84
+ <td><code>alignItems</code></td>
85
+ <td>CSS <code>align-items</code> value (default <code>center</code>)</td>
86
+ <td>Cross-axis alignment of the row</td>
87
+ </tr>
88
+ </tbody></table>
89
+ <table>
90
+ <thead>
91
+ <tr>
92
+ <th>Slot</th>
93
+ <th>Description</th>
94
+ </tr>
95
+ </thead>
96
+ <tbody><tr>
97
+ <td><em>(default)</em></td>
98
+ <td><code>sonic-button</code> · <code>sonic-input</code> · <code>sonic-select</code> in visual order</td>
99
+ </tr>
100
+ <tr>
101
+ <td><code>label</code></td>
102
+ <td>Custom label markup</td>
103
+ </tr>
104
+ <tr>
105
+ <td><code>description</code></td>
106
+ <td>Custom description markup</td>
107
+ </tr>
108
+ </tbody></table>
109
+
110
+ </article>
111
+ </main>
112
+ </body>
113
+ </html>
@@ -0,0 +1,77 @@
1
+ # Group
2
+
3
+ **`sonic-group`** lays out `sonic-button` · `sonic-input` and `sonic-select` controls in one row with a **shared corner radius**: only the outer corners of the first and last items stay rounded. Use it for button groups, radio rows or a field with an attached action. Optional `label` and `description` follow form field styling.
4
+
5
+ ## Radio group
6
+
7
+ Give each `sonic-button` the `radio` attribute and a shared `name`. The selected `value` is written to the `formDataProvider` set on the group (inherited by the buttons).
8
+
9
+ <sonic-code>
10
+ <template>
11
+ <sonic-group formDataProvider="groupPlanDemo">
12
+ <sonic-button radio name="plan" value="free" type="default">Free</sonic-button>
13
+ <sonic-button radio checked name="plan" value="pro" type="default">Pro</sonic-button>
14
+ <sonic-button radio name="plan" value="team" type="default">Team</sonic-button>
15
+ </sonic-group>
16
+ </template>
17
+ </sonic-code>
18
+
19
+ ## Button group
20
+
21
+ Adjacent action buttons that stay independent controls.
22
+
23
+ <sonic-code>
24
+ <template>
25
+ <sonic-group>
26
+ <sonic-button type="default">
27
+ <sonic-icon library="iconoir" name="align-left"></sonic-icon>
28
+ </sonic-button>
29
+ <sonic-button type="default">
30
+ <sonic-icon library="iconoir" name="align-center"></sonic-icon>
31
+ </sonic-button>
32
+ <sonic-button type="default">
33
+ <sonic-icon library="iconoir" name="align-right"></sonic-icon>
34
+ </sonic-button>
35
+ </sonic-group>
36
+ </template>
37
+ </sonic-code>
38
+
39
+ ## Field with action
40
+
41
+ Put the action before or after the field. `label` and `description` annotate the whole row.
42
+
43
+ <sonic-code>
44
+ <template>
45
+ <div class="grid gap-4 max-w-md">
46
+ <sonic-group label="Search" description="Type a flight number, then confirm.">
47
+ <sonic-input placeholder="CN 001"></sonic-input>
48
+ <sonic-button type="primary" shape="square">
49
+ <sonic-icon library="iconoir" name="search"></sonic-icon>
50
+ </sonic-button>
51
+ </sonic-group>
52
+ <sonic-group label="Extra baggage">
53
+ <sonic-button type="default" shape="square">
54
+ <sonic-icon library="iconoir" name="minus"></sonic-icon>
55
+ </sonic-button>
56
+ <sonic-input type="number" value="1"></sonic-input>
57
+ <sonic-button type="default" shape="square">
58
+ <sonic-icon library="iconoir" name="plus"></sonic-icon>
59
+ </sonic-button>
60
+ </sonic-group>
61
+ </div>
62
+ </template>
63
+ </sonic-code>
64
+
65
+ ## API reference
66
+
67
+ | Attribute | Values | Description |
68
+ |----------|---------|-------------|
69
+ | `label` | string (HTML) | Label above the row; content of `slot="label"` is appended |
70
+ | `description` | string (HTML) | Help text below the row; content of `slot="description"` replaces it |
71
+ | `alignItems` | CSS `align-items` value (default `center`) | Cross-axis alignment of the row |
72
+
73
+ | Slot | Description |
74
+ |------|-------------|
75
+ | *(default)* | `sonic-button` · `sonic-input` · `sonic-select` in visual order |
76
+ | `label` | Custom label markup |
77
+ | `description` | Custom description markup |