@supersoniks/concorde 5.1.1 → 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 (438) 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/.tmp-cem/custom-elements.json +503 -503
  6. package/PLAN-DOCS-AGENTS.md +80 -0
  7. package/README.md +3 -3
  8. package/ai/skills/concorde/SKILL.md +1 -1
  9. package/ai/skills/concorde-get-set-dp/SKILL.md +3 -3
  10. package/ai/skills/concorde-theme/SKILL.md +1 -1
  11. package/build-infos.json +1 -1
  12. package/concorde-core.bundle.js +1 -1
  13. package/concorde-core.es.js +1 -1
  14. package/dist/concorde-core.bundle.js +1 -1
  15. package/dist/concorde-core.es.js +1 -1
  16. package/docs/.htaccess +75 -0
  17. package/docs/404.html +15 -0
  18. package/docs/404.md +5 -0
  19. package/docs/assets/{index-Bb-_LRyY.js → index-BgG6FFPt.js} +2582 -3097
  20. package/docs/assets/index-x89XINSG.css +1 -0
  21. package/docs/core/components/functional/date/date.html +211 -0
  22. package/docs/core/components/functional/date/date.md +150 -0
  23. package/docs/core/components/functional/fetch/fetch.html +180 -0
  24. package/docs/core/components/functional/fetch/fetch.md +108 -0
  25. package/docs/core/components/functional/if/if.html +65 -0
  26. package/docs/core/components/functional/if/if.md +34 -0
  27. package/docs/core/components/functional/jsonata/jsonata.html +110 -0
  28. package/docs/core/components/functional/jsonata/jsonata.md +61 -0
  29. package/docs/core/components/functional/list/list.html +198 -0
  30. package/docs/core/components/functional/list/list.md +121 -0
  31. package/docs/core/components/functional/mix/mix.html +78 -0
  32. package/docs/core/components/functional/mix/mix.md +46 -0
  33. package/docs/core/components/functional/queue/queue.html +155 -0
  34. package/docs/core/components/functional/queue/queue.md +51 -0
  35. package/docs/core/components/functional/router/router.html +154 -0
  36. package/docs/core/components/functional/router/router.md +93 -0
  37. package/docs/core/components/functional/sdui/sdui-extension-points.html +127 -0
  38. package/docs/core/components/functional/sdui/sdui-extension-points.md +94 -0
  39. package/docs/core/components/functional/sdui/sdui.html +397 -0
  40. package/docs/core/components/functional/sdui/sdui.md +307 -0
  41. package/docs/core/components/functional/states/states.html +141 -0
  42. package/docs/core/components/functional/states/states.md +112 -0
  43. package/docs/core/components/functional/submit/submit.html +178 -0
  44. package/docs/core/components/functional/submit/submit.md +106 -0
  45. package/docs/core/components/functional/subscriber/subscriber.html +68 -0
  46. package/docs/core/components/functional/subscriber/subscriber.md +91 -0
  47. package/docs/core/components/functional/translation/translation.html +60 -0
  48. package/docs/core/components/functional/translation/translation.md +38 -0
  49. package/docs/core/components/functional/value/value.html +81 -0
  50. package/docs/core/components/functional/value/value.md +47 -0
  51. package/docs/core/components/ui/alert/alert.html +201 -0
  52. package/docs/core/components/ui/alert/alert.md +186 -0
  53. package/docs/core/components/ui/alert-messages/alert-messages.html +132 -0
  54. package/docs/core/components/ui/alert-messages/alert-messages.md +85 -0
  55. package/docs/core/components/ui/badge/badge.html +197 -0
  56. package/docs/core/components/ui/badge/badge.md +181 -0
  57. package/docs/core/components/ui/button/button.html +309 -0
  58. package/docs/core/components/ui/button/button.md +216 -0
  59. package/docs/core/components/ui/captcha/captcha.html +80 -0
  60. package/docs/core/components/ui/captcha/captcha.md +56 -0
  61. package/docs/core/components/ui/card/card.html +254 -0
  62. package/docs/core/components/ui/card/card.md +215 -0
  63. package/docs/core/components/ui/divider/divider.html +144 -0
  64. package/docs/core/components/ui/divider/divider.md +126 -0
  65. package/docs/core/components/ui/form/checkbox/checkbox.html +200 -0
  66. package/docs/core/components/ui/form/checkbox/checkbox.md +125 -0
  67. package/docs/core/components/ui/form/fieldset/fieldset.html +238 -0
  68. package/docs/core/components/ui/form/fieldset/fieldset.md +161 -0
  69. package/docs/core/components/ui/form/form-actions/form-actions.html +122 -0
  70. package/docs/core/components/ui/form/form-actions/form-actions.md +98 -0
  71. package/docs/core/components/ui/form/form-layout/form-layout.html +115 -0
  72. package/docs/core/components/ui/form/form-layout/form-layout.md +109 -0
  73. package/docs/core/components/ui/form/input/input.html +235 -0
  74. package/docs/core/components/ui/form/input/input.md +142 -0
  75. package/docs/core/components/ui/form/radio/radio.html +144 -0
  76. package/docs/core/components/ui/form/radio/radio.md +78 -0
  77. package/docs/core/components/ui/form/select/select.html +178 -0
  78. package/docs/core/components/ui/form/select/select.md +86 -0
  79. package/docs/core/components/ui/form/switch/switch.html +146 -0
  80. package/docs/core/components/ui/form/switch/switch.md +80 -0
  81. package/docs/core/components/ui/form/textarea/textarea.html +162 -0
  82. package/docs/core/components/ui/form/textarea/textarea.md +82 -0
  83. package/docs/core/components/ui/group/group.html +113 -0
  84. package/docs/core/components/ui/group/group.md +77 -0
  85. package/docs/core/components/ui/icon/icon.html +223 -0
  86. package/docs/core/components/ui/icon/icon.md +214 -0
  87. package/docs/core/components/ui/image/image.html +194 -0
  88. package/docs/core/components/ui/image/image.md +167 -0
  89. package/docs/core/components/ui/link/link.html +101 -0
  90. package/docs/core/components/ui/link/link.md +81 -0
  91. package/docs/core/components/ui/loader/loader.html +114 -0
  92. package/docs/core/components/ui/loader/loader.md +87 -0
  93. package/docs/core/components/ui/menu/menu.html +395 -0
  94. package/docs/core/components/ui/menu/menu.md +370 -0
  95. package/docs/core/components/ui/modal/modal.html +324 -0
  96. package/docs/core/components/ui/modal/modal.md +211 -0
  97. package/docs/core/components/ui/pop/pop.html +250 -0
  98. package/docs/core/components/ui/pop/pop.md +216 -0
  99. package/docs/core/components/ui/progress/progress.html +132 -0
  100. package/docs/core/components/ui/progress/progress.md +109 -0
  101. package/docs/core/components/ui/table/table.html +333 -0
  102. package/docs/core/components/ui/table/table.md +267 -0
  103. package/docs/core/components/ui/theme/theme.html +116 -0
  104. package/docs/core/components/ui/theme/theme.md +97 -0
  105. package/docs/core/components/ui/toast/toast.html +185 -0
  106. package/docs/core/components/ui/toast/toast.md +147 -0
  107. package/docs/core/components/ui/tooltip/tooltip.html +112 -0
  108. package/docs/core/components/ui/tooltip/tooltip.md +89 -0
  109. package/docs/docs/decorators/ancestor-attribute.html +71 -0
  110. package/docs/docs/decorators/ancestor-attribute.md +59 -0
  111. package/docs/docs/decorators/auto-subscribe.html +61 -0
  112. package/docs/docs/decorators/auto-subscribe.md +40 -0
  113. package/docs/docs/decorators/bind.html +86 -0
  114. package/docs/docs/decorators/bind.md +77 -0
  115. package/docs/docs/decorators/get.html +166 -0
  116. package/docs/docs/decorators/get.md +160 -0
  117. package/docs/docs/decorators/handle.html +139 -0
  118. package/docs/docs/decorators/handle.md +119 -0
  119. package/docs/docs/decorators/on-assign.html +72 -0
  120. package/docs/docs/decorators/on-assign.md +63 -0
  121. package/docs/docs/decorators/patch.html +76 -0
  122. package/docs/docs/decorators/patch.md +44 -0
  123. package/docs/docs/decorators/post.html +150 -0
  124. package/docs/docs/decorators/post.md +134 -0
  125. package/docs/docs/decorators/publish.html +74 -0
  126. package/docs/docs/decorators/publish.md +56 -0
  127. package/docs/docs/decorators/put.html +83 -0
  128. package/docs/docs/decorators/put.md +51 -0
  129. package/docs/docs/decorators/subscribe.html +91 -0
  130. package/docs/docs/decorators/subscribe.md +87 -0
  131. package/docs/docs/decorators/wait-for-ancestors.html +82 -0
  132. package/docs/docs/decorators/wait-for-ancestors.md +76 -0
  133. package/docs/docs/directives/sub.html +79 -0
  134. package/docs/docs/directives/sub.md +75 -0
  135. package/docs/docs/directives/t.html +91 -0
  136. package/docs/docs/directives/t.md +73 -0
  137. package/docs/docs/getting-started/ai-agents.html +174 -0
  138. package/{src/docs/_getting-started → docs/docs/getting-started}/ai-agents.md +3 -3
  139. package/docs/docs/getting-started/components.html +27 -0
  140. package/docs/docs/getting-started/create-a-component.html +108 -0
  141. package/{src/docs/_getting-started → docs/docs/getting-started}/create-a-component.md +3 -6
  142. package/docs/docs/getting-started/dataFlow.html +174 -0
  143. package/{src/docs/_core-concept → docs/docs/getting-started}/dataFlow.md +17 -18
  144. package/docs/docs/getting-started/installation.html +69 -0
  145. package/docs/docs/getting-started/installation.md +36 -0
  146. package/docs/docs/getting-started/my-first-component.html +180 -0
  147. package/{src/docs/_getting-started → docs/docs/getting-started}/my-first-component.md +5 -14
  148. package/docs/docs/getting-started/start.html +47 -0
  149. package/{src/docs/_getting-started → docs/docs/getting-started}/start.md +1 -13
  150. package/docs/docs/getting-started/theming.html +334 -0
  151. package/docs/docs/index.html +99 -0
  152. package/docs/docs/misc/api-configuration.html +149 -0
  153. package/{src/docs/_misc → docs/docs/misc}/api-configuration.md +10 -12
  154. package/docs/docs/misc/dataProviderKey.html +136 -0
  155. package/{src/docs/_misc → docs/docs/misc}/dataProviderKey.md +4 -4
  156. package/docs/docs/misc/docs-mock-api.html +155 -0
  157. package/{src/docs/_misc → docs/docs/misc}/docs-mock-api.md +12 -13
  158. package/docs/docs/misc/dynamic-path.html +181 -0
  159. package/{src/docs/_misc → docs/docs/misc}/dynamic-path.md +8 -8
  160. package/docs/docs/misc/endpoint.html +51 -0
  161. package/{src/docs/_misc → docs/docs/misc}/endpoint.md +8 -8
  162. package/docs/docs/misc/html-integration.html +45 -0
  163. package/{src/docs/_misc → docs/docs/misc}/html-integration.md +4 -5
  164. package/docs/docs-mock-api-sw.js +58 -223
  165. package/docs/docs-mock-api-sw.js.map +4 -4
  166. package/docs/hubs/decorators.html +443 -0
  167. package/docs/hubs/form-components.html +404 -0
  168. package/docs/hubs/remote-data.html +371 -0
  169. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  170. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  171. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  172. package/docs/img/archive/credits.json +28 -0
  173. package/docs/img/concorde/plane_01.jpg +0 -0
  174. package/docs/img/concorde/plane_02.jpg +0 -0
  175. package/docs/img/concorde/plane_03.jpg +0 -0
  176. package/docs/img/concorde/plane_04.jpg +0 -0
  177. package/docs/img/concorde/plane_05.jpg +0 -0
  178. package/docs/img/concorde/plane_06.jpg +0 -0
  179. package/docs/img/concorde/plane_07.jpg +0 -0
  180. package/docs/img/concorde/plane_08.jpg +0 -0
  181. package/docs/img/concorde/plane_09.jpg +0 -0
  182. package/docs/img/concorde/plane_10.jpg +0 -0
  183. package/docs/img/concorde/plane_11.jpg +0 -0
  184. package/docs/img/concorde/plane_12.jpg +0 -0
  185. package/docs/img/concorde/plane_13.jpg +0 -0
  186. package/docs/index.html +95 -68
  187. package/docs/index.md +22 -0
  188. package/docs/llms-full.txt +5795 -0
  189. package/docs/llms.txt +106 -0
  190. package/docs/robots.txt +11 -10
  191. package/docs/sitemap.xml +237 -0
  192. package/docs/src/core/components/functional/date/date.md +150 -0
  193. package/docs/src/core/components/functional/fetch/fetch.md +108 -0
  194. package/docs/src/core/components/functional/if/if.md +34 -0
  195. package/docs/src/core/components/functional/jsonata/jsonata.md +61 -0
  196. package/docs/src/core/components/functional/list/list.md +121 -0
  197. package/docs/src/core/components/functional/mix/mix.md +46 -0
  198. package/docs/src/core/components/functional/queue/queue.md +51 -0
  199. package/docs/src/core/components/functional/router/router.md +93 -0
  200. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  201. package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
  202. package/docs/src/core/components/functional/sdui/default-library.json +108 -0
  203. package/docs/src/core/components/functional/sdui/example.json +32 -0
  204. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  205. package/docs/src/core/components/functional/sdui/sdui.md +307 -0
  206. package/docs/src/core/components/functional/states/states.md +112 -0
  207. package/docs/src/core/components/functional/submit/submit.md +106 -0
  208. package/docs/src/core/components/functional/subscriber/subscriber.md +91 -0
  209. package/docs/src/core/components/functional/translation/translation.md +38 -0
  210. package/docs/src/core/components/functional/value/value.md +47 -0
  211. package/docs/src/core/components/ui/alert/alert.md +186 -0
  212. package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
  213. package/docs/src/core/components/ui/badge/badge.md +181 -0
  214. package/docs/src/core/components/ui/button/button.md +216 -0
  215. package/docs/src/core/components/ui/captcha/captcha.md +56 -0
  216. package/docs/src/core/components/ui/card/card.md +215 -0
  217. package/docs/src/core/components/ui/divider/divider.md +126 -0
  218. package/docs/src/core/components/ui/form/checkbox/checkbox.md +125 -0
  219. package/docs/src/core/components/ui/form/fieldset/fieldset.md +161 -0
  220. package/docs/src/core/components/ui/form/form-actions/form-actions.md +98 -0
  221. package/docs/src/core/components/ui/form/form-layout/form-layout.md +109 -0
  222. package/docs/src/core/components/ui/form/input/input.md +142 -0
  223. package/docs/src/core/components/ui/form/radio/radio.md +78 -0
  224. package/docs/src/core/components/ui/form/select/select.md +86 -0
  225. package/docs/src/core/components/ui/form/switch/switch.md +80 -0
  226. package/docs/src/core/components/ui/form/textarea/textarea.md +82 -0
  227. package/docs/src/core/components/ui/group/group.md +77 -0
  228. package/docs/src/core/components/ui/icon/icon.md +214 -0
  229. package/docs/src/core/components/ui/icon/icons.json +1 -0
  230. package/docs/src/core/components/ui/image/image.md +167 -0
  231. package/docs/src/core/components/ui/link/link.md +81 -0
  232. package/docs/src/core/components/ui/loader/loader.md +87 -0
  233. package/docs/src/core/components/ui/menu/menu.md +370 -0
  234. package/docs/src/core/components/ui/modal/modal.md +211 -0
  235. package/docs/src/core/components/ui/pop/pop.md +216 -0
  236. package/docs/src/core/components/ui/progress/progress.md +109 -0
  237. package/docs/src/core/components/ui/table/table.md +267 -0
  238. package/docs/src/core/components/ui/theme/theme.md +97 -0
  239. package/docs/src/core/components/ui/toast/toast.md +147 -0
  240. package/docs/src/core/components/ui/tooltip/tooltip.md +89 -0
  241. package/docs/src/docs/decorators/ancestor-attribute.md +59 -0
  242. package/docs/src/docs/decorators/auto-subscribe.md +40 -0
  243. package/docs/src/docs/decorators/bind.md +77 -0
  244. package/docs/src/docs/decorators/get.md +160 -0
  245. package/docs/src/docs/decorators/handle.md +119 -0
  246. package/docs/src/docs/decorators/on-assign.md +63 -0
  247. package/docs/src/docs/decorators/patch.md +44 -0
  248. package/docs/src/docs/decorators/post.md +134 -0
  249. package/docs/src/docs/decorators/publish.md +56 -0
  250. package/docs/src/docs/decorators/put.md +51 -0
  251. package/docs/src/docs/decorators/subscribe.md +87 -0
  252. package/docs/src/docs/decorators/wait-for-ancestors.md +76 -0
  253. package/docs/src/docs/directives/sub.md +75 -0
  254. package/docs/src/docs/directives/t.md +73 -0
  255. package/docs/src/docs/getting-started/ai-agents.md +76 -0
  256. package/docs/src/docs/getting-started/components.md +5 -0
  257. package/docs/src/docs/getting-started/create-a-component.md +136 -0
  258. package/docs/src/docs/getting-started/dataFlow.md +87 -0
  259. package/docs/src/docs/getting-started/installation.md +36 -0
  260. package/docs/src/docs/getting-started/my-first-component.md +227 -0
  261. package/docs/src/docs/getting-started/start.md +35 -0
  262. package/docs/src/docs/getting-started/theming.md +253 -0
  263. package/docs/src/docs/misc/api-configuration.md +79 -0
  264. package/docs/src/docs/misc/dataProviderKey.md +168 -0
  265. package/docs/src/docs/misc/docs-mock-api.md +62 -0
  266. package/docs/src/docs/misc/dynamic-path.md +71 -0
  267. package/docs/src/docs/misc/endpoint.md +45 -0
  268. package/docs/src/docs/misc/html-integration.md +14 -0
  269. package/docs/src/docs/search/docs-search.json +10287 -0
  270. package/docs/src/tag-list.json +1 -0
  271. package/docs/src/tsconfig-model.json +23 -0
  272. package/docs/src/tsconfig.json +1353 -0
  273. package/index.html +68 -5
  274. package/package.json +1 -1
  275. package/public/docs-mock-api-sw.js +58 -223
  276. package/public/docs-mock-api-sw.js.map +4 -4
  277. package/public/img/concorde/plane_01.jpg +0 -0
  278. package/public/img/concorde/plane_02.jpg +0 -0
  279. package/public/img/concorde/plane_03.jpg +0 -0
  280. package/public/img/concorde/plane_04.jpg +0 -0
  281. package/public/img/concorde/plane_05.jpg +0 -0
  282. package/public/img/concorde/plane_06.jpg +0 -0
  283. package/public/img/concorde/plane_07.jpg +0 -0
  284. package/public/img/concorde/plane_08.jpg +0 -0
  285. package/public/img/concorde/plane_09.jpg +0 -0
  286. package/public/img/concorde/plane_10.jpg +0 -0
  287. package/public/img/concorde/plane_11.jpg +0 -0
  288. package/public/img/concorde/plane_12.jpg +0 -0
  289. package/public/img/concorde/plane_13.jpg +0 -0
  290. package/public/robots.txt +11 -10
  291. package/scripts/docs-markdown-vite-plugin.ts +37 -0
  292. package/scripts/docs-public-url.mjs +50 -0
  293. package/scripts/docs.htaccess +75 -0
  294. package/scripts/generate-crawl-docs.mjs +207 -116
  295. package/scripts/generate-crawl-docs.test.mjs +124 -0
  296. package/scripts/post-build-docs.js +34 -50
  297. package/src/core/components/functional/date/date.md +91 -231
  298. package/src/core/components/functional/fetch/fetch.md +66 -83
  299. package/src/core/components/functional/if/if.md +28 -3
  300. package/src/core/components/functional/jsonata/jsonata.md +42 -37
  301. package/src/core/components/functional/list/list.md +99 -43
  302. package/src/core/components/functional/mix/mix.md +31 -26
  303. package/src/core/components/functional/queue/queue.demo.ts +10 -7
  304. package/src/core/components/functional/queue/queue.md +40 -61
  305. package/src/core/components/functional/router/router.demo.ts +16 -16
  306. package/src/core/components/functional/router/router.md +64 -65
  307. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  308. package/src/core/components/functional/sdui/component-catalog.json +1 -1
  309. package/src/core/components/functional/sdui/example.json +19 -86
  310. package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  311. package/src/core/components/functional/sdui/sdui.md +187 -358
  312. package/src/core/components/functional/states/states.demo.ts +21 -22
  313. package/src/core/components/functional/states/states.md +86 -61
  314. package/src/core/components/functional/states/states.ts +1 -1
  315. package/src/core/components/functional/submit/submit.md +64 -72
  316. package/src/core/components/functional/translation/translation.md +38 -0
  317. package/src/core/components/functional/value/value.md +34 -22
  318. package/src/core/components/ui/alert/alert.md +48 -58
  319. package/src/core/components/ui/badge/badge.md +27 -34
  320. package/src/core/components/ui/button/button.md +139 -106
  321. package/src/core/components/ui/captcha/captcha.md +17 -32
  322. package/src/core/components/ui/card/card.md +6 -6
  323. package/src/core/components/ui/divider/divider.md +8 -11
  324. package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  325. package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
  326. package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
  327. package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
  328. package/src/core/components/ui/form/input/input.md +95 -95
  329. package/src/core/components/ui/form/radio/radio.md +55 -34
  330. package/src/core/components/ui/form/select/select.md +60 -45
  331. package/src/core/components/ui/form/switch/switch.md +57 -34
  332. package/src/core/components/ui/form/textarea/textarea.md +55 -38
  333. package/src/core/components/ui/group/group.md +35 -33
  334. package/src/core/components/ui/icon/icon.md +4 -4
  335. package/src/core/components/ui/image/image.md +41 -107
  336. package/src/core/components/ui/link/link.md +6 -6
  337. package/src/core/components/ui/loader/loader.md +30 -55
  338. package/src/core/components/ui/menu/menu.md +27 -27
  339. package/src/core/components/ui/modal/modal.md +72 -96
  340. package/src/core/components/ui/pop/pop.md +80 -158
  341. package/src/core/components/ui/progress/progress.md +2 -2
  342. package/src/core/components/ui/table/table.md +91 -255
  343. package/src/core/components/ui/theme/theme.md +11 -36
  344. package/src/core/components/ui/toast/toast.md +48 -117
  345. package/src/core/components/ui/tooltip/tooltip.md +27 -62
  346. package/src/core/utils/LocationHandler.spec.ts +80 -0
  347. package/src/core/utils/LocationHandler.ts +5 -9
  348. package/src/docs/components/docs-demo-sources.ts +55 -140
  349. package/src/docs/components/docs-lit-demo.ts +1 -3
  350. package/src/docs/components/docs-source-link.ts +0 -82
  351. package/src/docs/decorators/ancestor-attribute.md +59 -0
  352. package/src/docs/decorators/auto-subscribe.md +40 -0
  353. package/src/docs/decorators/bind.md +77 -0
  354. package/src/docs/decorators/get.md +160 -0
  355. package/src/docs/decorators/handle.md +119 -0
  356. package/src/docs/decorators/on-assign.md +63 -0
  357. package/src/docs/decorators/patch.md +44 -0
  358. package/src/docs/decorators/post.md +134 -0
  359. package/src/docs/decorators/publish.md +56 -0
  360. package/src/docs/decorators/put.md +51 -0
  361. package/src/docs/decorators/subscribe.md +87 -0
  362. package/src/docs/decorators/wait-for-ancestors.md +76 -0
  363. package/src/docs/directives/sub.md +75 -0
  364. package/src/docs/directives/t.md +73 -0
  365. package/src/docs/docs-location.spec.ts +46 -0
  366. package/src/docs/docs-location.ts +123 -32
  367. package/src/docs/docs.ts +1 -2
  368. package/src/docs/example/decorators-demo-bind-demos.ts +81 -116
  369. package/src/docs/example/decorators-demo-geo.ts +30 -19
  370. package/src/docs/example/decorators-demo-post.ts +88 -186
  371. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
  372. package/src/docs/example/decorators-demo.ts +85 -98
  373. package/src/docs/example/docs-api-config-demos.ts +19 -20
  374. package/src/docs/example/docs-flight-demos.ts +147 -0
  375. package/src/docs/example/docs-jsonata-demos.ts +52 -52
  376. package/src/docs/example/docs-list-demos.ts +43 -123
  377. package/src/docs/example/docs-provider-keys.ts +21 -28
  378. package/src/docs/example/docs-queue-demos.ts +37 -77
  379. package/src/docs/example/docs-router-demos.ts +20 -25
  380. package/src/docs/example/docs-submit-demos.ts +48 -48
  381. package/src/docs/example/docs-toggle-demos.ts +4 -3
  382. package/src/docs/getting-started/ai-agents.md +76 -0
  383. package/src/docs/getting-started/components.md +5 -0
  384. package/src/docs/getting-started/create-a-component.md +136 -0
  385. package/src/docs/getting-started/dataFlow.md +87 -0
  386. package/src/docs/getting-started/installation.md +36 -0
  387. package/src/docs/getting-started/my-first-component.md +227 -0
  388. package/src/docs/getting-started/start.md +35 -0
  389. package/src/docs/getting-started/theming.md +253 -0
  390. package/src/docs/header/header.ts +11 -6
  391. package/src/docs/home/catalog.ts +1 -1
  392. package/src/docs/home/home.ts +17 -10
  393. package/src/docs/layout.ts +12 -13
  394. package/src/docs/misc/api-configuration.md +79 -0
  395. package/src/docs/misc/dataProviderKey.md +168 -0
  396. package/src/docs/misc/docs-mock-api.md +62 -0
  397. package/src/docs/misc/dynamic-path.md +71 -0
  398. package/src/docs/misc/endpoint.md +45 -0
  399. package/src/docs/misc/html-integration.md +14 -0
  400. package/src/docs/mock-api/api-config-mock.ts +5 -0
  401. package/src/docs/mock-api/fixtures.ts +0 -278
  402. package/src/docs/mock-api/flights.ts +89 -0
  403. package/src/docs/mock-api/router.ts +3 -4
  404. package/src/docs/mock-api/urls.ts +1 -2
  405. package/src/docs/navigation/navigation.ts +82 -103
  406. package/src/docs/navigation/toc.ts +7 -4
  407. package/src/docs/search/docs-search.json +2845 -5110
  408. package/src/docs/search/markdown-renderer.ts +25 -7
  409. package/src/docs/search/page.ts +9 -6
  410. package/src/docs/search/search.ts +154 -122
  411. package/vite.config.mts +11 -2
  412. package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
  413. package/docs/assets/index-CD4WyL6o.css +0 -1
  414. package/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  415. package/src/docs/_core-concept/overview.md +0 -57
  416. package/src/docs/_core-concept/subscriber.md +0 -75
  417. package/src/docs/_decorators/ancestor-attribute.md +0 -128
  418. package/src/docs/_decorators/auto-subscribe.md +0 -202
  419. package/src/docs/_decorators/bind.md +0 -167
  420. package/src/docs/_decorators/get.md +0 -162
  421. package/src/docs/_decorators/handle.md +0 -175
  422. package/src/docs/_decorators/on-assign.md +0 -390
  423. package/src/docs/_decorators/patch.md +0 -70
  424. package/src/docs/_decorators/post.md +0 -146
  425. package/src/docs/_decorators/publish.md +0 -55
  426. package/src/docs/_decorators/put.md +0 -70
  427. package/src/docs/_decorators/subscribe.md +0 -100
  428. package/src/docs/_decorators/wait-for-ancestors.md +0 -163
  429. package/src/docs/_directives/sub.md +0 -91
  430. package/src/docs/_getting-started/concorde-manual-install.md +0 -133
  431. package/src/docs/_getting-started/concorde-outside.md +0 -33
  432. package/src/docs/_getting-started/my-first-subscriber.md +0 -120
  433. package/src/docs/_getting-started/pubsub.md +0 -37
  434. package/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  435. package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
  436. package/src/docs/example/docs-joke-demos.ts +0 -297
  437. /package/{src/docs/_getting-started → docs/docs/getting-started}/components.md +0 -0
  438. /package/{src/docs/_getting-started → docs/docs/getting-started}/theming.md +0 -0
package/docs/core/components/ui/captcha/captcha.md ADDED
@@ -0,0 +1,56 @@
1
+ # Captcha
2
+
3
+ **`sonic-captcha`** embeds an [ALTCHA](https://altcha.org) proof-of-work widget and makes the nearest form wait for it. Place it inside a form scope and put **`sonic-submit`** in its default slot: the widget renders above the slot content, and the submit sends only once a token is available.
4
+
5
+ ## Basic example
6
+
7
+ The widget loads only on **HTTPS**. On plain HTTP the component renders nothing and the form is not blocked.
8
+
9
+ <sonic-code>
10
+ <template>
11
+ <sonic-scope
12
+ serviceURL="/docs-mock-api"
13
+ formDataProvider="captcha-docs-form"
14
+ submitResultDataProvider="captcha-docs-result"
15
+ >
16
+ <sonic-captcha>
17
+ <sonic-input class="mb-3 block" name="email" type="email" label="Email" value="demo@example.com"></sonic-input>
18
+ <sonic-submit endPoint="api/register" onClick>
19
+ <sonic-button type="primary">Join the crew</sonic-button>
20
+ </sonic-submit>
21
+ </sonic-captcha>
22
+ </sonic-scope>
23
+ </template>
24
+ </sonic-code>
25
+
26
+ ## Form integration
27
+
28
+ The component writes to the publisher named by the closest `headersDataProvider`, or else `formDataProvider`, on itself or an ancestor. On connect it sets `needsCaptchaValidation` to `true`. When **`sonic-submit`** sees that flag, it requests a token, the captcha copies the solved ALTCHA payload into `captchaToken` and its key into `captchaKey`, and the request is sent. `needsCaptchaValidation` is stripped from the payload. On disconnect both fields are reset.
29
+
30
+ <sonic-code language="typescript">
31
+ <template>
32
+ {
33
+ email: "demo@example.com",
34
+ captchaKey: "…",
35
+ captchaToken: "…"
36
+ }
37
+ </template>
38
+ </sonic-code>
39
+
40
+ ## Key and challenge endpoint
41
+
42
+ With no `key`, the component generates an encrypted key on connect. The widget fetches its challenge from the `chalengeUrl` property (a JavaScript property, not an attribute) with `key` and `maxNumber` (default `50000`) as query parameters. Point it at your own ALTCHA server and verify `captchaToken` there.
43
+
44
+ Labels follow the page language: French when `<html lang>` starts with `fr`, English otherwise.
45
+
46
+ ## API reference
47
+
48
+ | Attribute | Values | Description |
49
+ |----------|---------|-------------|
50
+ | `key` | string (default generated) | Key sent to the challenge endpoint and copied to `captchaKey` |
51
+
52
+ | Slot | Description |
53
+ |------|-------------|
54
+ | *(default)* | Form fields and actions, rendered below the widget |
55
+
56
+ No events.
package/docs/core/components/ui/card/card.html ADDED
@@ -0,0 +1,254 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/ui/card" data-doc-id="core/components/ui/card/card">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Card — Concorde by Supersoniks</title>
7
+ <meta name="description" content="Cards group related content on a padded surface with radius, theme type colors, and elevation. Default shadow is lg. Compose sonic-card-header / sonic-card-main / sonic-card-footer, or place any marku">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/ui/card/card, card, Card, UI component, sonic-card, web component, type, shadow, lg, sonic-card-header, sonic-card-main, sonic-card-footer, base, default, light">
9
+ <meta name="concorde-doc-id" content="core/components/ui/card/card">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/core/components/ui/card">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/ui/card.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/card">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 — Card</strong>. Cards group related content on a padded surface with radius, theme type colors, and elevation. Default shadow is lg. Compose sonic-card-header / sonic-card-main / sonic-card-footer, or place any marku <span>Doc ID: <code>core/components/ui/card/card</code>. Keywords: Concorde, supersoniks, core/components/ui/card/card, card, Card, UI component, sonic-card, web component, type, shadow, lg, sonic-card-header, sonic-card-main, sonic-card-footer, base, default, light. URL: <a href="https://concorde.supersoniks.org/core/components/ui/card">https://concorde.supersoniks.org/core/components/ui/card</a>.</span></p>
20
+ <h1 id="card">Card</h1>
21
+ <p>Cards <strong>group related content</strong> on a padded surface with radius, theme <strong><code>type</code></strong> colors, and elevation. Default <strong><code>shadow</code></strong> is <code>lg</code>. Compose <strong><code>sonic-card-header</code></strong> / <strong><code>sonic-card-main</code></strong> / <strong><code>sonic-card-footer</code></strong>, or place any markup in the default slot.</p>
22
+ <h2 id="basic-example">Basic example</h2>
23
+ <pre><code>&lt;sonic-card class=&quot;max-w-sm&quot;&gt;
24
+ &lt;p class=&quot;m-0&quot;&gt;CN 001 · CDG → JFK · On time.&lt;/p&gt;
25
+ &lt;/sonic-card&gt;
26
+ </code></pre>
27
+ <h2 id="type">Type</h2>
28
+ <p>Default <strong><code>type</code></strong> is <code>base</code>. <strong><code>default</code></strong> and <strong><code>light</code></strong> share the same surface tokens.</p>
29
+ <pre><code>&lt;div class=&quot;flex flex-wrap gap-3&quot;&gt;
30
+ &lt;sonic-card type=&quot;base&quot; class=&quot;min-w-[8rem]&quot;&gt;Base&lt;/sonic-card&gt;
31
+ &lt;sonic-card type=&quot;light&quot; class=&quot;min-w-[8rem]&quot;&gt;Light&lt;/sonic-card&gt;
32
+ &lt;sonic-card type=&quot;default&quot; class=&quot;min-w-[8rem]&quot;&gt;Default&lt;/sonic-card&gt;
33
+ &lt;sonic-card type=&quot;primary&quot; class=&quot;min-w-[8rem]&quot;&gt;Primary&lt;/sonic-card&gt;
34
+ &lt;sonic-card type=&quot;info&quot; class=&quot;min-w-[8rem]&quot;&gt;Info&lt;/sonic-card&gt;
35
+ &lt;sonic-card type=&quot;success&quot; class=&quot;min-w-[8rem]&quot;&gt;Success&lt;/sonic-card&gt;
36
+ &lt;sonic-card type=&quot;warning&quot; class=&quot;min-w-[8rem]&quot;&gt;Warning&lt;/sonic-card&gt;
37
+ &lt;sonic-card type=&quot;danger&quot; class=&quot;min-w-[8rem]&quot;&gt;Danger&lt;/sonic-card&gt;
38
+ &lt;sonic-card type=&quot;neutral&quot; class=&quot;min-w-[8rem]&quot;&gt;Neutral&lt;/sonic-card&gt;
39
+ &lt;sonic-card type=&quot;invert&quot; class=&quot;min-w-[8rem]&quot;&gt;Invert&lt;/sonic-card&gt;
40
+ &lt;/div&gt;
41
+ </code></pre>
42
+ <h2 id="shadow">Shadow</h2>
43
+ <p>Set <strong><code>shadow</code></strong> to control elevation. Default is <code>lg</code>.</p>
44
+ <pre><code>&lt;div class=&quot;grid gap-4 sm:grid-cols-2 max-w-2xl&quot;&gt;
45
+ &lt;sonic-card shadow=&quot;none&quot; class=&quot;min-h-[5rem] flex items-center justify-center&quot;&gt;None&lt;/sonic-card&gt;
46
+ &lt;sonic-card shadow=&quot;sm&quot; class=&quot;min-h-[5rem] flex items-center justify-center&quot;&gt;Small&lt;/sonic-card&gt;
47
+ &lt;sonic-card shadow=&quot;md&quot; class=&quot;min-h-[5rem] flex items-center justify-center&quot;&gt;Medium&lt;/sonic-card&gt;
48
+ &lt;sonic-card shadow=&quot;lg&quot; class=&quot;min-h-[5rem] flex items-center justify-center&quot;&gt;Large&lt;/sonic-card&gt;
49
+ &lt;/div&gt;
50
+ </code></pre>
51
+ <h2 id="header">Header</h2>
52
+ <p>Quick titles with <strong><code>label</code></strong> and <strong><code>description</code></strong>, or full control through the default slot. <strong><code>slot=&quot;suffix&quot;</code></strong> aligns badges or actions on the right; suffix content does not shrink when the title wraps.</p>
53
+ <p><code>label</code> and <code>description</code> accept HTML (rendered as markup). Prefer plain text when possible; use <strong><code>sonic-card-header-description</code></strong> or the default slot for structured content.</p>
54
+ <pre><code>&lt;div class=&quot;grid gap-4 max-w-xl&quot;&gt;
55
+ &lt;sonic-card&gt;
56
+ &lt;sonic-card-header
57
+ label=&quot;Account settings&quot;
58
+ description=&quot;Manage your profile and preferences.&quot;
59
+ &gt;&lt;/sonic-card-header&gt;
60
+ &lt;p class=&quot;m-0 text-sm opacity-80&quot;&gt;Body content goes in the card slot or in &lt;code&gt;sonic-card-main&lt;/code&gt;.&lt;/p&gt;
61
+ &lt;/sonic-card&gt;
62
+
63
+ &lt;sonic-card type=&quot;neutral&quot;&gt;
64
+ &lt;sonic-card-header label=&quot;Notifications&quot;&gt;
65
+ &lt;sonic-card-header-description&gt;
66
+ Choose what we email you about.
67
+ &lt;/sonic-card-header-description&gt;
68
+ &lt;sonic-badge slot=&quot;suffix&quot; type=&quot;warning&quot; size=&quot;xs&quot;&gt;3 new&lt;/sonic-badge&gt;
69
+ &lt;/sonic-card-header&gt;
70
+ &lt;/sonic-card&gt;
71
+
72
+ &lt;sonic-card&gt;
73
+ &lt;sonic-card-header label=&quot;Team workspace&quot; description=&quot;Shared with 12 members&quot;&gt;
74
+ &lt;sonic-button
75
+ slot=&quot;suffix&quot;
76
+ shape=&quot;circle&quot;
77
+ variant=&quot;outline&quot;
78
+ size=&quot;sm&quot;
79
+ type=&quot;default&quot;
80
+ icon
81
+ data-aria-label=&quot;Workspace settings&quot;
82
+ &gt;
83
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;settings&quot;&gt;&lt;/sonic-icon&gt;
84
+ &lt;/sonic-button&gt;
85
+ &lt;/sonic-card-header&gt;
86
+ &lt;/sonic-card&gt;
87
+
88
+ &lt;sonic-card type=&quot;primary&quot;&gt;
89
+ &lt;sonic-card-header&gt;
90
+ &lt;div&gt;Custom header&lt;/div&gt;
91
+ &lt;sonic-card-header-description&gt;
92
+ Use the header slot when attributes are not enough.
93
+ &lt;/sonic-card-header-description&gt;
94
+ &lt;sonic-button slot=&quot;suffix&quot; shape=&quot;circle&quot; variant=&quot;ghost&quot; size=&quot;sm&quot; type=&quot;primary&quot; icon&gt;
95
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;nav-arrow-right&quot;&gt;&lt;/sonic-icon&gt;
96
+ &lt;/sonic-button&gt;
97
+ &lt;/sonic-card-header&gt;
98
+ &lt;/sonic-card&gt;
99
+ &lt;/div&gt;
100
+ </code></pre>
101
+ <h2 id="main">Main</h2>
102
+ <p>Optional wrapper for the primary content area (typography, media, forms).</p>
103
+ <pre><code>&lt;sonic-card class=&quot;max-w-xl&quot;&gt;
104
+ &lt;sonic-card-header label=&quot;Release notes&quot; description=&quot;Version 2.4&quot;&gt;&lt;/sonic-card-header&gt;
105
+ &lt;sonic-card-main&gt;
106
+ &lt;p class=&quot;mt-0&quot;&gt;
107
+ Improved performance on large lists and fixed an issue with keyboard navigation in menus.
108
+ &lt;/p&gt;
109
+ &lt;sonic-divider&gt;&lt;/sonic-divider&gt;
110
+ &lt;p class=&quot;mb-0 text-sm opacity-80&quot;&gt;See the changelog for details.&lt;/p&gt;
111
+ &lt;/sonic-card-main&gt;
112
+ &lt;/sonic-card&gt;
113
+ </code></pre>
114
+ <h2 id="footer">Footer</h2>
115
+ <p>Optional footer for actions, metadata, or secondary text.</p>
116
+ <pre><code>&lt;sonic-card class=&quot;max-w-xl&quot;&gt;
117
+ &lt;sonic-card-header label=&quot;Confirm deletion&quot;&gt;&lt;/sonic-card-header&gt;
118
+ &lt;sonic-card-main&gt;
119
+ &lt;p class=&quot;m-0&quot;&gt;This project and all of its data will be removed permanently.&lt;/p&gt;
120
+ &lt;/sonic-card-main&gt;
121
+ &lt;sonic-card-footer&gt;
122
+ &lt;sonic-divider&gt;&lt;/sonic-divider&gt;
123
+ &lt;div class=&quot;flex flex-wrap gap-2 justify-end&quot;&gt;
124
+ &lt;sonic-button variant=&quot;ghost&quot; size=&quot;sm&quot;&gt;Cancel&lt;/sonic-button&gt;
125
+ &lt;sonic-button type=&quot;danger&quot; size=&quot;sm&quot;&gt;Delete&lt;/sonic-button&gt;
126
+ &lt;/div&gt;
127
+ &lt;/sonic-card-footer&gt;
128
+ &lt;/sonic-card&gt;
129
+ </code></pre>
130
+ <h2 id="full-example">Full example</h2>
131
+ <p>Header, media, body, and footer together.</p>
132
+ <pre><code>&lt;sonic-card class=&quot;max-w-md&quot;&gt;
133
+ &lt;sonic-card-header label=&quot;Featured route&quot; description=&quot;CDG → JFK&quot;&gt;
134
+ &lt;sonic-icon slot=&quot;suffix&quot; library=&quot;iconoir&quot; name=&quot;airplane&quot; aria-hidden=&quot;true&quot;&gt;&lt;/sonic-icon&gt;
135
+ &lt;/sonic-card-header&gt;
136
+ &lt;sonic-card-main&gt;
137
+ &lt;sonic-image
138
+ rounded
139
+ ratio=&quot;16/9&quot;
140
+ src=&quot;img/concorde/plane_04.jpg&quot;
141
+ alt=&quot;Concorde on the apron under a blue sky&quot;
142
+ &gt;&lt;/sonic-image&gt;
143
+ &lt;p class=&quot;mb-0&quot;&gt;
144
+ Nonstop at Mach 2.04, with flexible dates.
145
+ &lt;/p&gt;
146
+ &lt;/sonic-card-main&gt;
147
+ &lt;sonic-card-footer&gt;
148
+ &lt;div class=&quot;flex items-center justify-between gap-3 flex-wrap&quot;&gt;
149
+ &lt;span class=&quot;text-sm font-semibold&quot;&gt;Cabin class: Business&lt;/span&gt;
150
+ &lt;sonic-button type=&quot;primary&quot; size=&quot;sm&quot;&gt;Book&lt;/sonic-button&gt;
151
+ &lt;/div&gt;
152
+ &lt;/sonic-card-footer&gt;
153
+ &lt;/sonic-card&gt;
154
+ </code></pre>
155
+ <h2 id="api-reference">API reference</h2>
156
+ <h3 id="sonic-card"><code>sonic-card</code></h3>
157
+ <table>
158
+ <thead>
159
+ <tr>
160
+ <th>Attribute</th>
161
+ <th>Values</th>
162
+ <th>Description</th>
163
+ </tr>
164
+ </thead>
165
+ <tbody><tr>
166
+ <td><code>type</code></td>
167
+ <td><code>base</code> (default) · <code>light</code> · <code>invert</code> · <code>default</code> · <code>primary</code> · <code>warning</code> · <code>danger</code> · <code>success</code> · <code>info</code> · <code>neutral</code></td>
168
+ <td>Semantic background and text (<code>default</code> and <code>light</code> share the same surface)</td>
169
+ </tr>
170
+ <tr>
171
+ <td><code>shadow</code></td>
172
+ <td><code>none</code> · <code>sm</code> · <code>md</code> · <code>lg</code> (default <code>lg</code>)</td>
173
+ <td>Elevation on the card surface</td>
174
+ </tr>
175
+ </tbody></table>
176
+ <table>
177
+ <thead>
178
+ <tr>
179
+ <th>Slot</th>
180
+ <th>Description</th>
181
+ </tr>
182
+ </thead>
183
+ <tbody><tr>
184
+ <td><em>(default)</em></td>
185
+ <td>Free-form content (header, main, footer, or direct markup)</td>
186
+ </tr>
187
+ </tbody></table>
188
+ <h3 id="sonic-card-header"><code>sonic-card-header</code></h3>
189
+ <table>
190
+ <thead>
191
+ <tr>
192
+ <th>Attribute</th>
193
+ <th>Values</th>
194
+ <th>Description</th>
195
+ </tr>
196
+ </thead>
197
+ <tbody><tr>
198
+ <td><code>label</code></td>
199
+ <td>HTML</td>
200
+ <td>Title (rendered as markup)</td>
201
+ </tr>
202
+ <tr>
203
+ <td><code>description</code></td>
204
+ <td>HTML</td>
205
+ <td>Subtitle below the title</td>
206
+ </tr>
207
+ </tbody></table>
208
+ <table>
209
+ <thead>
210
+ <tr>
211
+ <th>Slot</th>
212
+ <th>Description</th>
213
+ </tr>
214
+ </thead>
215
+ <tbody><tr>
216
+ <td><em>(default)</em></td>
217
+ <td>Custom title / description when attributes are not enough</td>
218
+ </tr>
219
+ <tr>
220
+ <td><code>suffix</code></td>
221
+ <td>Actions or badges aligned on the right (does not shrink)</td>
222
+ </tr>
223
+ </tbody></table>
224
+ <h3 id="sonic-card-header-description"><code>sonic-card-header-description</code></h3>
225
+ <table>
226
+ <thead>
227
+ <tr>
228
+ <th>Slot</th>
229
+ <th>Description</th>
230
+ </tr>
231
+ </thead>
232
+ <tbody><tr>
233
+ <td><em>(default)</em></td>
234
+ <td>Subtitle text; styled below the title when slotted in <strong><code>sonic-card-header</code></strong></td>
235
+ </tr>
236
+ </tbody></table>
237
+ <h3 id="sonic-card-main--sonic-card-footer"><code>sonic-card-main</code> · <code>sonic-card-footer</code></h3>
238
+ <table>
239
+ <thead>
240
+ <tr>
241
+ <th>Slot</th>
242
+ <th>Description</th>
243
+ </tr>
244
+ </thead>
245
+ <tbody><tr>
246
+ <td><em>(default)</em></td>
247
+ <td>Primary content (<code>main</code>) or actions / metadata (<code>footer</code>)</td>
248
+ </tr>
249
+ </tbody></table>
250
+
251
+ </article>
252
+ </main>
253
+ </body>
254
+ </html>
package/docs/core/components/ui/card/card.md ADDED
@@ -0,0 +1,215 @@
1
+ # Card
2
+
3
+ Cards **group related content** on a padded surface with radius, theme **`type`** colors, and elevation. Default **`shadow`** is `lg`. Compose **`sonic-card-header`** / **`sonic-card-main`** / **`sonic-card-footer`**, or place any markup in the default slot.
4
+
5
+ ## Basic example
6
+
7
+ <sonic-code>
8
+ <template>
9
+ <sonic-card class="max-w-sm">
10
+ <p class="m-0">CN 001 · CDG → JFK · On time.</p>
11
+ </sonic-card>
12
+ </template>
13
+ </sonic-code>
14
+
15
+ ## Type
16
+
17
+ Default **`type`** is `base`. **`default`** and **`light`** share the same surface tokens.
18
+
19
+ <sonic-code>
20
+ <template>
21
+ <div class="flex flex-wrap gap-3">
22
+ <sonic-card type="base" class="min-w-[8rem]">Base</sonic-card>
23
+ <sonic-card type="light" class="min-w-[8rem]">Light</sonic-card>
24
+ <sonic-card type="default" class="min-w-[8rem]">Default</sonic-card>
25
+ <sonic-card type="primary" class="min-w-[8rem]">Primary</sonic-card>
26
+ <sonic-card type="info" class="min-w-[8rem]">Info</sonic-card>
27
+ <sonic-card type="success" class="min-w-[8rem]">Success</sonic-card>
28
+ <sonic-card type="warning" class="min-w-[8rem]">Warning</sonic-card>
29
+ <sonic-card type="danger" class="min-w-[8rem]">Danger</sonic-card>
30
+ <sonic-card type="neutral" class="min-w-[8rem]">Neutral</sonic-card>
31
+ <sonic-card type="invert" class="min-w-[8rem]">Invert</sonic-card>
32
+ </div>
33
+ </template>
34
+ </sonic-code>
35
+
36
+ ## Shadow
37
+
38
+ Set **`shadow`** to control elevation. Default is `lg`.
39
+
40
+ <sonic-code>
41
+ <template>
42
+ <div class="grid gap-4 sm:grid-cols-2 max-w-2xl">
43
+ <sonic-card shadow="none" class="min-h-[5rem] flex items-center justify-center">None</sonic-card>
44
+ <sonic-card shadow="sm" class="min-h-[5rem] flex items-center justify-center">Small</sonic-card>
45
+ <sonic-card shadow="md" class="min-h-[5rem] flex items-center justify-center">Medium</sonic-card>
46
+ <sonic-card shadow="lg" class="min-h-[5rem] flex items-center justify-center">Large</sonic-card>
47
+ </div>
48
+ </template>
49
+ </sonic-code>
50
+
51
+ ## Header
52
+
53
+ Quick titles with **`label`** and **`description`**, or full control through the default slot. **`slot="suffix"`** aligns badges or actions on the right; suffix content does not shrink when the title wraps.
54
+
55
+ `label` and `description` accept HTML (rendered as markup). Prefer plain text when possible; use **`sonic-card-header-description`** or the default slot for structured content.
56
+
57
+ <sonic-code>
58
+ <template>
59
+ <div class="grid gap-4 max-w-xl">
60
+ <sonic-card>
61
+ <sonic-card-header
62
+ label="Account settings"
63
+ description="Manage your profile and preferences."
64
+ ></sonic-card-header>
65
+ <p class="m-0 text-sm opacity-80">Body content goes in the card slot or in <code>sonic-card-main</code>.</p>
66
+ </sonic-card>
67
+
68
+ <sonic-card type="neutral">
69
+ <sonic-card-header label="Notifications">
70
+ <sonic-card-header-description>
71
+ Choose what we email you about.
72
+ </sonic-card-header-description>
73
+ <sonic-badge slot="suffix" type="warning" size="xs">3 new</sonic-badge>
74
+ </sonic-card-header>
75
+ </sonic-card>
76
+
77
+ <sonic-card>
78
+ <sonic-card-header label="Team workspace" description="Shared with 12 members">
79
+ <sonic-button
80
+ slot="suffix"
81
+ shape="circle"
82
+ variant="outline"
83
+ size="sm"
84
+ type="default"
85
+ icon
86
+ data-aria-label="Workspace settings"
87
+ >
88
+ <sonic-icon library="iconoir" name="settings"></sonic-icon>
89
+ </sonic-button>
90
+ </sonic-card-header>
91
+ </sonic-card>
92
+
93
+ <sonic-card type="primary">
94
+ <sonic-card-header>
95
+ <div>Custom header</div>
96
+ <sonic-card-header-description>
97
+ Use the header slot when attributes are not enough.
98
+ </sonic-card-header-description>
99
+ <sonic-button slot="suffix" shape="circle" variant="ghost" size="sm" type="primary" icon>
100
+ <sonic-icon library="iconoir" name="nav-arrow-right"></sonic-icon>
101
+ </sonic-button>
102
+ </sonic-card-header>
103
+ </sonic-card>
104
+ </div>
105
+ </template>
106
+ </sonic-code>
107
+
108
+ ## Main
109
+
110
+ Optional wrapper for the primary content area (typography, media, forms).
111
+
112
+ <sonic-code>
113
+ <template>
114
+ <sonic-card class="max-w-xl">
115
+ <sonic-card-header label="Release notes" description="Version 2.4"></sonic-card-header>
116
+ <sonic-card-main>
117
+ <p class="mt-0">
118
+ Improved performance on large lists and fixed an issue with keyboard navigation in menus.
119
+ </p>
120
+ <sonic-divider></sonic-divider>
121
+ <p class="mb-0 text-sm opacity-80">See the changelog for details.</p>
122
+ </sonic-card-main>
123
+ </sonic-card>
124
+ </template>
125
+ </sonic-code>
126
+
127
+ ## Footer
128
+
129
+ Optional footer for actions, metadata, or secondary text.
130
+
131
+ <sonic-code>
132
+ <template>
133
+ <sonic-card class="max-w-xl">
134
+ <sonic-card-header label="Confirm deletion"></sonic-card-header>
135
+ <sonic-card-main>
136
+ <p class="m-0">This project and all of its data will be removed permanently.</p>
137
+ </sonic-card-main>
138
+ <sonic-card-footer>
139
+ <sonic-divider></sonic-divider>
140
+ <div class="flex flex-wrap gap-2 justify-end">
141
+ <sonic-button variant="ghost" size="sm">Cancel</sonic-button>
142
+ <sonic-button type="danger" size="sm">Delete</sonic-button>
143
+ </div>
144
+ </sonic-card-footer>
145
+ </sonic-card>
146
+ </template>
147
+ </sonic-code>
148
+
149
+ ## Full example
150
+
151
+ Header, media, body, and footer together.
152
+
153
+ <sonic-code>
154
+ <template>
155
+ <sonic-card class="max-w-md">
156
+ <sonic-card-header label="Featured route" description="CDG → JFK">
157
+ <sonic-icon slot="suffix" library="iconoir" name="airplane" aria-hidden="true"></sonic-icon>
158
+ </sonic-card-header>
159
+ <sonic-card-main>
160
+ <sonic-image
161
+ rounded
162
+ ratio="16/9"
163
+ src="img/concorde/plane_04.jpg"
164
+ alt="Concorde on the apron under a blue sky"
165
+ ></sonic-image>
166
+ <p class="mb-0">
167
+ Nonstop at Mach 2.04, with flexible dates.
168
+ </p>
169
+ </sonic-card-main>
170
+ <sonic-card-footer>
171
+ <div class="flex items-center justify-between gap-3 flex-wrap">
172
+ <span class="text-sm font-semibold">Cabin class: Business</span>
173
+ <sonic-button type="primary" size="sm">Book</sonic-button>
174
+ </div>
175
+ </sonic-card-footer>
176
+ </sonic-card>
177
+ </template>
178
+ </sonic-code>
179
+
180
+ ## API reference
181
+
182
+ ### `sonic-card`
183
+
184
+ | Attribute | Values | Description |
185
+ |----------|---------|-------------|
186
+ | `type` | `base` (default) · `light` · `invert` · `default` · `primary` · `warning` · `danger` · `success` · `info` · `neutral` | Semantic background and text (`default` and `light` share the same surface) |
187
+ | `shadow` | `none` · `sm` · `md` · `lg` (default `lg`) | Elevation on the card surface |
188
+
189
+ | Slot | Description |
190
+ |------|-------------|
191
+ | *(default)* | Free-form content (header, main, footer, or direct markup) |
192
+
193
+ ### `sonic-card-header`
194
+
195
+ | Attribute | Values | Description |
196
+ |----------|---------|-------------|
197
+ | `label` | HTML | Title (rendered as markup) |
198
+ | `description` | HTML | Subtitle below the title |
199
+
200
+ | Slot | Description |
201
+ |------|-------------|
202
+ | *(default)* | Custom title / description when attributes are not enough |
203
+ | `suffix` | Actions or badges aligned on the right (does not shrink) |
204
+
205
+ ### `sonic-card-header-description`
206
+
207
+ | Slot | Description |
208
+ |------|-------------|
209
+ | *(default)* | Subtitle text; styled below the title when slotted in **`sonic-card-header`** |
210
+
211
+ ### `sonic-card-main` · `sonic-card-footer`
212
+
213
+ | Slot | Description |
214
+ |------|-------------|
215
+ | *(default)* | Primary content (`main`) or actions / metadata (`footer`) |