@supersoniks/concorde 5.1.1 → 5.1.3

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 (494) 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/PLAN-DOCS-AGENTS.md +80 -0
  6. package/README.md +4 -4
  7. package/ai/README.md +29 -41
  8. package/ai/skills/concorde/SKILL.md +54 -324
  9. package/ai/skills/concorde/rules/composition.md +32 -0
  10. package/ai/skills/concorde/rules/data.md +47 -0
  11. package/ai/skills/concorde/rules/http.md +25 -0
  12. package/ai/skills/concorde/rules/lists-forms.md +35 -0
  13. package/ai/skills/concorde/rules/styling.md +46 -0
  14. package/ai/skills/concorde/rules/troubleshooting.md +45 -0
  15. package/build-infos.json +1 -1
  16. package/concorde-core.bundle.js +21 -21
  17. package/concorde-core.es.js +977 -980
  18. package/custom-elements-manifest.public.config.mjs +8 -0
  19. package/{.tmp-cem/custom-elements.json → custom-elements.json} +11758 -8904
  20. package/dist/concorde-core.bundle.js +21 -21
  21. package/dist/concorde-core.es.js +977 -980
  22. package/dist/docs-mock-api-sw.js +58 -223
  23. package/dist/docs-mock-api-sw.js.map +4 -4
  24. package/dist/img/concorde/plane_01.jpg +0 -0
  25. package/dist/img/concorde/plane_02.jpg +0 -0
  26. package/dist/img/concorde/plane_03.jpg +0 -0
  27. package/dist/img/concorde/plane_04.jpg +0 -0
  28. package/dist/img/concorde/plane_05.jpg +0 -0
  29. package/dist/img/concorde/plane_06.jpg +0 -0
  30. package/dist/img/concorde/plane_07.jpg +0 -0
  31. package/dist/img/concorde/plane_08.jpg +0 -0
  32. package/dist/img/concorde/plane_09.jpg +0 -0
  33. package/dist/img/concorde/plane_10.jpg +0 -0
  34. package/dist/img/concorde/plane_11.jpg +0 -0
  35. package/dist/img/concorde/plane_12.jpg +0 -0
  36. package/dist/img/concorde/plane_13.jpg +0 -0
  37. package/dist/img/og-concorde.jpg +0 -0
  38. package/dist/robots.txt +11 -10
  39. package/docs/.htaccess +82 -0
  40. package/docs/404.html +15 -0
  41. package/docs/404.md +5 -0
  42. package/docs/about.html +111 -0
  43. package/docs/about.md +22 -0
  44. package/docs/assets/{index-Bb-_LRyY.js → index-6sS76xWj.js} +2625 -3158
  45. package/docs/assets/index-DkdPbH0F.css +1 -0
  46. package/docs/core/components/functional/date/date.html +211 -0
  47. package/docs/core/components/functional/date/date.md +150 -0
  48. package/docs/core/components/functional/fetch/fetch.html +180 -0
  49. package/docs/core/components/functional/fetch/fetch.md +108 -0
  50. package/docs/core/components/functional/if/if.html +65 -0
  51. package/docs/core/components/functional/if/if.md +34 -0
  52. package/docs/core/components/functional/jsonata/jsonata.html +110 -0
  53. package/docs/core/components/functional/jsonata/jsonata.md +61 -0
  54. package/docs/core/components/functional/list/list.html +200 -0
  55. package/docs/core/components/functional/list/list.md +125 -0
  56. package/docs/core/components/functional/mix/mix.html +78 -0
  57. package/docs/core/components/functional/mix/mix.md +46 -0
  58. package/docs/core/components/functional/queue/queue.html +155 -0
  59. package/docs/core/components/functional/queue/queue.md +51 -0
  60. package/docs/core/components/functional/router/router.html +154 -0
  61. package/docs/core/components/functional/router/router.md +93 -0
  62. package/docs/core/components/functional/sdui/sdui-extension-points.html +127 -0
  63. package/docs/core/components/functional/sdui/sdui-extension-points.md +94 -0
  64. package/docs/core/components/functional/sdui/sdui.html +397 -0
  65. package/docs/core/components/functional/sdui/sdui.md +307 -0
  66. package/docs/core/components/functional/states/states.html +141 -0
  67. package/docs/core/components/functional/states/states.md +112 -0
  68. package/docs/core/components/functional/submit/submit.html +178 -0
  69. package/docs/core/components/functional/submit/submit.md +106 -0
  70. package/docs/core/components/functional/subscriber/subscriber.html +68 -0
  71. package/docs/core/components/functional/subscriber/subscriber.md +91 -0
  72. package/docs/core/components/functional/translation/translation.html +60 -0
  73. package/docs/core/components/functional/translation/translation.md +38 -0
  74. package/docs/core/components/functional/value/value.html +81 -0
  75. package/docs/core/components/functional/value/value.md +47 -0
  76. package/docs/core/components/ui/alert/alert.html +201 -0
  77. package/docs/core/components/ui/alert/alert.md +186 -0
  78. package/docs/core/components/ui/alert-messages/alert-messages.html +132 -0
  79. package/docs/core/components/ui/alert-messages/alert-messages.md +85 -0
  80. package/docs/core/components/ui/badge/badge.html +197 -0
  81. package/docs/core/components/ui/badge/badge.md +181 -0
  82. package/docs/core/components/ui/button/button.html +309 -0
  83. package/docs/core/components/ui/button/button.md +216 -0
  84. package/docs/core/components/ui/captcha/captcha.html +80 -0
  85. package/docs/core/components/ui/captcha/captcha.md +56 -0
  86. package/docs/core/components/ui/card/card.html +254 -0
  87. package/docs/core/components/ui/card/card.md +215 -0
  88. package/docs/core/components/ui/divider/divider.html +144 -0
  89. package/docs/core/components/ui/divider/divider.md +126 -0
  90. package/docs/core/components/ui/form/checkbox/checkbox.html +200 -0
  91. package/docs/core/components/ui/form/checkbox/checkbox.md +125 -0
  92. package/docs/core/components/ui/form/fieldset/fieldset.html +238 -0
  93. package/docs/core/components/ui/form/fieldset/fieldset.md +161 -0
  94. package/docs/core/components/ui/form/form-actions/form-actions.html +122 -0
  95. package/docs/core/components/ui/form/form-actions/form-actions.md +98 -0
  96. package/docs/core/components/ui/form/form-layout/form-layout.html +115 -0
  97. package/docs/core/components/ui/form/form-layout/form-layout.md +109 -0
  98. package/docs/core/components/ui/form/input/input.html +235 -0
  99. package/docs/core/components/ui/form/input/input.md +142 -0
  100. package/docs/core/components/ui/form/radio/radio.html +144 -0
  101. package/docs/core/components/ui/form/radio/radio.md +78 -0
  102. package/docs/core/components/ui/form/select/select.html +178 -0
  103. package/docs/core/components/ui/form/select/select.md +86 -0
  104. package/docs/core/components/ui/form/switch/switch.html +146 -0
  105. package/docs/core/components/ui/form/switch/switch.md +80 -0
  106. package/docs/core/components/ui/form/textarea/textarea.html +162 -0
  107. package/docs/core/components/ui/form/textarea/textarea.md +82 -0
  108. package/docs/core/components/ui/group/group.html +113 -0
  109. package/docs/core/components/ui/group/group.md +77 -0
  110. package/docs/core/components/ui/icon/icon.html +223 -0
  111. package/docs/core/components/ui/icon/icon.md +214 -0
  112. package/docs/core/components/ui/image/image.html +194 -0
  113. package/docs/core/components/ui/image/image.md +167 -0
  114. package/docs/core/components/ui/link/link.html +101 -0
  115. package/docs/core/components/ui/link/link.md +81 -0
  116. package/docs/core/components/ui/loader/loader.html +114 -0
  117. package/docs/core/components/ui/loader/loader.md +87 -0
  118. package/docs/core/components/ui/menu/menu.html +395 -0
  119. package/docs/core/components/ui/menu/menu.md +370 -0
  120. package/docs/core/components/ui/modal/modal.html +324 -0
  121. package/docs/core/components/ui/modal/modal.md +211 -0
  122. package/docs/core/components/ui/pop/pop.html +250 -0
  123. package/docs/core/components/ui/pop/pop.md +216 -0
  124. package/docs/core/components/ui/progress/progress.html +132 -0
  125. package/docs/core/components/ui/progress/progress.md +109 -0
  126. package/docs/core/components/ui/table/table.html +333 -0
  127. package/docs/core/components/ui/table/table.md +267 -0
  128. package/docs/core/components/ui/theme/theme.html +116 -0
  129. package/docs/core/components/ui/theme/theme.md +97 -0
  130. package/docs/core/components/ui/toast/toast.html +185 -0
  131. package/docs/core/components/ui/toast/toast.md +147 -0
  132. package/docs/core/components/ui/tooltip/tooltip.html +112 -0
  133. package/docs/core/components/ui/tooltip/tooltip.md +89 -0
  134. package/docs/custom-elements.json +16559 -0
  135. package/docs/docs/decorators/ancestor-attribute.html +71 -0
  136. package/docs/docs/decorators/ancestor-attribute.md +59 -0
  137. package/docs/docs/decorators/auto-subscribe.html +61 -0
  138. package/docs/docs/decorators/auto-subscribe.md +40 -0
  139. package/docs/docs/decorators/bind.html +87 -0
  140. package/docs/docs/decorators/bind.md +76 -0
  141. package/docs/docs/decorators/get.html +166 -0
  142. package/docs/docs/decorators/get.md +160 -0
  143. package/docs/docs/decorators/handle.html +139 -0
  144. package/docs/docs/decorators/handle.md +119 -0
  145. package/docs/docs/decorators/on-assign.html +72 -0
  146. package/docs/docs/decorators/on-assign.md +63 -0
  147. package/docs/docs/decorators/patch.html +76 -0
  148. package/docs/docs/decorators/patch.md +44 -0
  149. package/docs/docs/decorators/post.html +150 -0
  150. package/docs/docs/decorators/post.md +134 -0
  151. package/docs/docs/decorators/publish.html +74 -0
  152. package/docs/docs/decorators/publish.md +56 -0
  153. package/docs/docs/decorators/put.html +83 -0
  154. package/docs/docs/decorators/put.md +51 -0
  155. package/docs/docs/decorators/subscribe.html +91 -0
  156. package/docs/docs/decorators/subscribe.md +87 -0
  157. package/docs/docs/decorators/wait-for-ancestors.html +82 -0
  158. package/docs/docs/decorators/wait-for-ancestors.md +76 -0
  159. package/docs/docs/directives/sub.html +79 -0
  160. package/docs/docs/directives/sub.md +75 -0
  161. package/docs/docs/directives/t.html +91 -0
  162. package/docs/docs/directives/t.md +73 -0
  163. package/docs/docs/getting-started/ai-agents.html +130 -0
  164. package/docs/docs/getting-started/ai-agents.md +50 -0
  165. package/docs/docs/getting-started/components.html +27 -0
  166. package/docs/docs/getting-started/create-a-component.html +108 -0
  167. package/{src/docs/_getting-started → docs/docs/getting-started}/create-a-component.md +3 -6
  168. package/docs/docs/getting-started/dataFlow.html +174 -0
  169. package/{src/docs/_core-concept → docs/docs/getting-started}/dataFlow.md +18 -19
  170. package/docs/docs/getting-started/installation.html +69 -0
  171. package/docs/docs/getting-started/installation.md +36 -0
  172. package/docs/docs/getting-started/my-first-component.html +180 -0
  173. package/{src/docs/_getting-started → docs/docs/getting-started}/my-first-component.md +5 -14
  174. package/docs/docs/getting-started/start.html +47 -0
  175. package/{src/docs/_getting-started → docs/docs/getting-started}/start.md +1 -13
  176. package/docs/docs/getting-started/theming.html +334 -0
  177. package/docs/docs/index.html +99 -0
  178. package/docs/docs/misc/api-configuration.html +149 -0
  179. package/{src/docs/_misc → docs/docs/misc}/api-configuration.md +10 -12
  180. package/docs/docs/misc/dataProviderKey.html +136 -0
  181. package/{src/docs/_misc → docs/docs/misc}/dataProviderKey.md +4 -4
  182. package/docs/docs/misc/docs-mock-api.html +155 -0
  183. package/{src/docs/_misc → docs/docs/misc}/docs-mock-api.md +12 -13
  184. package/docs/docs/misc/dynamic-path.html +181 -0
  185. package/{src/docs/_misc → docs/docs/misc}/dynamic-path.md +8 -8
  186. package/docs/docs/misc/endpoint.html +51 -0
  187. package/{src/docs/_misc → docs/docs/misc}/endpoint.md +8 -8
  188. package/docs/docs/misc/html-integration.html +45 -0
  189. package/{src/docs/_misc → docs/docs/misc}/html-integration.md +4 -5
  190. package/docs/docs-mock-api-sw.js +58 -223
  191. package/docs/docs-mock-api-sw.js.map +4 -4
  192. package/docs/hubs/decorators.html +438 -0
  193. package/docs/hubs/form-components.html +404 -0
  194. package/docs/hubs/remote-data.html +367 -0
  195. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  196. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  197. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  198. package/docs/img/archive/credits.json +28 -0
  199. package/docs/img/concorde/plane_01.jpg +0 -0
  200. package/docs/img/concorde/plane_02.jpg +0 -0
  201. package/docs/img/concorde/plane_03.jpg +0 -0
  202. package/docs/img/concorde/plane_04.jpg +0 -0
  203. package/docs/img/concorde/plane_05.jpg +0 -0
  204. package/docs/img/concorde/plane_06.jpg +0 -0
  205. package/docs/img/concorde/plane_07.jpg +0 -0
  206. package/docs/img/concorde/plane_08.jpg +0 -0
  207. package/docs/img/concorde/plane_09.jpg +0 -0
  208. package/docs/img/concorde/plane_10.jpg +0 -0
  209. package/docs/img/concorde/plane_11.jpg +0 -0
  210. package/docs/img/concorde/plane_12.jpg +0 -0
  211. package/docs/img/concorde/plane_13.jpg +0 -0
  212. package/docs/img/og-concorde.jpg +0 -0
  213. package/docs/index.html +184 -68
  214. package/docs/index.md +22 -0
  215. package/docs/llms-full.txt +5779 -0
  216. package/docs/llms.txt +108 -0
  217. package/docs/privacy.html +122 -0
  218. package/docs/privacy.md +32 -0
  219. package/docs/robots.txt +11 -10
  220. package/docs/sitemap.xml +243 -0
  221. package/docs/src/core/components/functional/date/date.md +150 -0
  222. package/docs/src/core/components/functional/fetch/fetch.md +108 -0
  223. package/docs/src/core/components/functional/if/if.md +34 -0
  224. package/docs/src/core/components/functional/jsonata/jsonata.md +61 -0
  225. package/docs/src/core/components/functional/list/list.md +125 -0
  226. package/docs/src/core/components/functional/mix/mix.md +46 -0
  227. package/docs/src/core/components/functional/queue/queue.md +51 -0
  228. package/docs/src/core/components/functional/router/router.md +93 -0
  229. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  230. package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
  231. package/docs/src/core/components/functional/sdui/default-library.json +108 -0
  232. package/docs/src/core/components/functional/sdui/example.json +32 -0
  233. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  234. package/docs/src/core/components/functional/sdui/sdui.md +307 -0
  235. package/docs/src/core/components/functional/states/states.md +112 -0
  236. package/docs/src/core/components/functional/submit/submit.md +106 -0
  237. package/docs/src/core/components/functional/subscriber/subscriber.md +91 -0
  238. package/docs/src/core/components/functional/translation/translation.md +38 -0
  239. package/docs/src/core/components/functional/value/value.md +47 -0
  240. package/docs/src/core/components/ui/alert/alert.md +186 -0
  241. package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
  242. package/docs/src/core/components/ui/badge/badge.md +181 -0
  243. package/docs/src/core/components/ui/button/button.md +216 -0
  244. package/docs/src/core/components/ui/captcha/captcha.md +56 -0
  245. package/docs/src/core/components/ui/card/card.md +215 -0
  246. package/docs/src/core/components/ui/divider/divider.md +126 -0
  247. package/docs/src/core/components/ui/form/checkbox/checkbox.md +125 -0
  248. package/docs/src/core/components/ui/form/fieldset/fieldset.md +161 -0
  249. package/docs/src/core/components/ui/form/form-actions/form-actions.md +98 -0
  250. package/docs/src/core/components/ui/form/form-layout/form-layout.md +109 -0
  251. package/docs/src/core/components/ui/form/input/input.md +142 -0
  252. package/docs/src/core/components/ui/form/radio/radio.md +78 -0
  253. package/docs/src/core/components/ui/form/select/select.md +86 -0
  254. package/docs/src/core/components/ui/form/switch/switch.md +80 -0
  255. package/docs/src/core/components/ui/form/textarea/textarea.md +82 -0
  256. package/docs/src/core/components/ui/group/group.md +77 -0
  257. package/docs/src/core/components/ui/icon/icon.md +214 -0
  258. package/docs/src/core/components/ui/icon/icons.json +1 -0
  259. package/docs/src/core/components/ui/image/image.md +167 -0
  260. package/docs/src/core/components/ui/link/link.md +81 -0
  261. package/docs/src/core/components/ui/loader/loader.md +87 -0
  262. package/docs/src/core/components/ui/menu/menu.md +370 -0
  263. package/docs/src/core/components/ui/modal/modal.md +211 -0
  264. package/docs/src/core/components/ui/pop/pop.md +216 -0
  265. package/docs/src/core/components/ui/progress/progress.md +109 -0
  266. package/docs/src/core/components/ui/table/table.md +267 -0
  267. package/docs/src/core/components/ui/theme/theme.md +97 -0
  268. package/docs/src/core/components/ui/toast/toast.md +147 -0
  269. package/docs/src/core/components/ui/tooltip/tooltip.md +89 -0
  270. package/docs/src/docs/decorators/ancestor-attribute.md +59 -0
  271. package/docs/src/docs/decorators/auto-subscribe.md +40 -0
  272. package/docs/src/docs/decorators/bind.md +76 -0
  273. package/docs/src/docs/decorators/get.md +160 -0
  274. package/docs/src/docs/decorators/handle.md +119 -0
  275. package/docs/src/docs/decorators/on-assign.md +63 -0
  276. package/docs/src/docs/decorators/patch.md +44 -0
  277. package/docs/src/docs/decorators/post.md +134 -0
  278. package/docs/src/docs/decorators/publish.md +56 -0
  279. package/docs/src/docs/decorators/put.md +51 -0
  280. package/docs/src/docs/decorators/subscribe.md +87 -0
  281. package/docs/src/docs/decorators/wait-for-ancestors.md +76 -0
  282. package/docs/src/docs/directives/sub.md +75 -0
  283. package/docs/src/docs/directives/t.md +73 -0
  284. package/docs/src/docs/getting-started/ai-agents.md +50 -0
  285. package/docs/src/docs/getting-started/components.md +5 -0
  286. package/docs/src/docs/getting-started/create-a-component.md +136 -0
  287. package/docs/src/docs/getting-started/dataFlow.md +87 -0
  288. package/docs/src/docs/getting-started/installation.md +36 -0
  289. package/docs/src/docs/getting-started/my-first-component.md +227 -0
  290. package/docs/src/docs/getting-started/start.md +35 -0
  291. package/docs/src/docs/getting-started/theming.md +253 -0
  292. package/docs/src/docs/misc/api-configuration.md +79 -0
  293. package/docs/src/docs/misc/dataProviderKey.md +168 -0
  294. package/docs/src/docs/misc/docs-mock-api.md +62 -0
  295. package/docs/src/docs/misc/dynamic-path.md +71 -0
  296. package/docs/src/docs/misc/endpoint.md +45 -0
  297. package/docs/src/docs/misc/html-integration.md +14 -0
  298. package/docs/src/docs/search/docs-search.json +10332 -0
  299. package/docs/src/tag-list.json +1 -0
  300. package/docs/src/tsconfig-model.json +23 -0
  301. package/docs/src/tsconfig.json +1359 -0
  302. package/index.html +157 -5
  303. package/package.json +8 -4
  304. package/public/docs-mock-api-sw.js +58 -223
  305. package/public/docs-mock-api-sw.js.map +4 -4
  306. package/public/img/concorde/plane_01.jpg +0 -0
  307. package/public/img/concorde/plane_02.jpg +0 -0
  308. package/public/img/concorde/plane_03.jpg +0 -0
  309. package/public/img/concorde/plane_04.jpg +0 -0
  310. package/public/img/concorde/plane_05.jpg +0 -0
  311. package/public/img/concorde/plane_06.jpg +0 -0
  312. package/public/img/concorde/plane_07.jpg +0 -0
  313. package/public/img/concorde/plane_08.jpg +0 -0
  314. package/public/img/concorde/plane_09.jpg +0 -0
  315. package/public/img/concorde/plane_10.jpg +0 -0
  316. package/public/img/concorde/plane_11.jpg +0 -0
  317. package/public/img/concorde/plane_12.jpg +0 -0
  318. package/public/img/concorde/plane_13.jpg +0 -0
  319. package/public/img/og-concorde.jpg +0 -0
  320. package/public/robots.txt +11 -10
  321. package/scripts/ai-init.mjs +104 -379
  322. package/scripts/ai-init.test.mjs +81 -239
  323. package/scripts/docs-markdown-vite-plugin.ts +43 -0
  324. package/scripts/docs-public-url.mjs +56 -0
  325. package/scripts/docs.htaccess +82 -0
  326. package/scripts/generate-cem.mjs +244 -0
  327. package/scripts/generate-cem.test.mjs +122 -0
  328. package/scripts/generate-crawl-docs.mjs +233 -118
  329. package/scripts/generate-crawl-docs.test.mjs +124 -0
  330. package/scripts/generate-sdui-catalog.mjs +11 -10
  331. package/scripts/post-build-docs.js +37 -50
  332. package/scripts/pre-publish.mjs +2 -1
  333. package/scripts/site-pages.mjs +212 -0
  334. package/scripts/site-pages.test.mjs +116 -0
  335. package/site-pages/about.md +22 -0
  336. package/site-pages/privacy.md +32 -0
  337. package/src/core/components/functional/date/date.md +91 -231
  338. package/src/core/components/functional/fetch/fetch.md +66 -83
  339. package/src/core/components/functional/if/if.md +28 -3
  340. package/src/core/components/functional/jsonata/jsonata.md +42 -37
  341. package/src/core/components/functional/list/list.md +103 -43
  342. package/src/core/components/functional/mix/mix.md +31 -26
  343. package/src/core/components/functional/queue/queue.demo.ts +10 -7
  344. package/src/core/components/functional/queue/queue.md +40 -61
  345. package/src/core/components/functional/router/router.demo.ts +16 -16
  346. package/src/core/components/functional/router/router.md +64 -65
  347. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  348. package/src/core/components/functional/sdui/component-catalog.json +1 -1
  349. package/src/core/components/functional/sdui/example.json +19 -86
  350. package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  351. package/src/core/components/functional/sdui/sdui.md +187 -358
  352. package/src/core/components/functional/states/states.demo.ts +21 -22
  353. package/src/core/components/functional/states/states.md +86 -61
  354. package/src/core/components/functional/states/states.ts +1 -1
  355. package/src/core/components/functional/submit/submit.md +64 -72
  356. package/src/core/components/functional/translation/translation.md +38 -0
  357. package/src/core/components/functional/value/value.md +34 -22
  358. package/src/core/components/ui/alert/alert.md +48 -58
  359. package/src/core/components/ui/badge/badge.md +27 -34
  360. package/src/core/components/ui/button/button.md +139 -106
  361. package/src/core/components/ui/captcha/captcha.md +17 -32
  362. package/src/core/components/ui/card/card.md +6 -6
  363. package/src/core/components/ui/divider/divider.md +8 -11
  364. package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  365. package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
  366. package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
  367. package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
  368. package/src/core/components/ui/form/input/input.md +95 -95
  369. package/src/core/components/ui/form/radio/radio.md +55 -34
  370. package/src/core/components/ui/form/select/select.md +60 -45
  371. package/src/core/components/ui/form/switch/switch.md +57 -34
  372. package/src/core/components/ui/form/textarea/textarea.md +55 -38
  373. package/src/core/components/ui/group/group.md +35 -33
  374. package/src/core/components/ui/icon/icon.md +4 -4
  375. package/src/core/components/ui/image/image.md +41 -107
  376. package/src/core/components/ui/link/link.md +6 -6
  377. package/src/core/components/ui/loader/loader.md +30 -55
  378. package/src/core/components/ui/menu/menu.md +27 -27
  379. package/src/core/components/ui/modal/modal.md +72 -96
  380. package/src/core/components/ui/pop/pop.md +80 -158
  381. package/src/core/components/ui/progress/progress.md +2 -2
  382. package/src/core/components/ui/table/table.md +91 -255
  383. package/src/core/components/ui/theme/theme.md +11 -36
  384. package/src/core/components/ui/toast/toast.md +48 -117
  385. package/src/core/components/ui/tooltip/tooltip.md +27 -62
  386. package/src/core/decorators/subscriber/bind.ts +9 -14
  387. package/src/core/utils/LocationHandler.spec.ts +80 -0
  388. package/src/core/utils/LocationHandler.ts +5 -9
  389. package/src/docs/components/docs-demo-sources.ts +55 -140
  390. package/src/docs/components/docs-lit-demo.ts +1 -3
  391. package/src/docs/components/docs-source-link.ts +0 -82
  392. package/src/docs/decorators/ancestor-attribute.md +59 -0
  393. package/src/docs/decorators/auto-subscribe.md +40 -0
  394. package/src/docs/decorators/bind.md +76 -0
  395. package/src/docs/decorators/get.md +160 -0
  396. package/src/docs/decorators/handle.md +119 -0
  397. package/src/docs/decorators/on-assign.md +63 -0
  398. package/src/docs/decorators/patch.md +44 -0
  399. package/src/docs/decorators/post.md +134 -0
  400. package/src/docs/decorators/publish.md +56 -0
  401. package/src/docs/decorators/put.md +51 -0
  402. package/src/docs/decorators/subscribe.md +87 -0
  403. package/src/docs/decorators/wait-for-ancestors.md +76 -0
  404. package/src/docs/directives/sub.md +75 -0
  405. package/src/docs/directives/t.md +73 -0
  406. package/src/docs/docs-location.spec.ts +56 -0
  407. package/src/docs/docs-location.ts +133 -32
  408. package/src/docs/docs.ts +1 -2
  409. package/src/docs/example/decorators-demo-bind-demos.ts +83 -135
  410. package/src/docs/example/decorators-demo-geo.ts +30 -19
  411. package/src/docs/example/decorators-demo-post.ts +88 -186
  412. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
  413. package/src/docs/example/decorators-demo.ts +85 -98
  414. package/src/docs/example/docs-api-config-demos.ts +19 -20
  415. package/src/docs/example/docs-flight-demos.ts +147 -0
  416. package/src/docs/example/docs-jsonata-demos.ts +52 -52
  417. package/src/docs/example/docs-list-demos.ts +43 -123
  418. package/src/docs/example/docs-provider-keys.ts +21 -28
  419. package/src/docs/example/docs-queue-demos.ts +37 -77
  420. package/src/docs/example/docs-router-demos.ts +20 -25
  421. package/src/docs/example/docs-submit-demos.ts +48 -48
  422. package/src/docs/example/docs-toggle-demos.ts +4 -3
  423. package/src/docs/getting-started/ai-agents.md +50 -0
  424. package/src/docs/getting-started/components.md +5 -0
  425. package/src/docs/getting-started/create-a-component.md +136 -0
  426. package/src/docs/getting-started/dataFlow.md +87 -0
  427. package/src/docs/getting-started/installation.md +36 -0
  428. package/src/docs/getting-started/my-first-component.md +227 -0
  429. package/src/docs/getting-started/start.md +35 -0
  430. package/src/docs/getting-started/theming.md +253 -0
  431. package/src/docs/header/header.ts +11 -6
  432. package/src/docs/home/catalog.ts +1 -1
  433. package/src/docs/home/home.ts +20 -11
  434. package/src/docs/layout.ts +12 -13
  435. package/src/docs/misc/api-configuration.md +79 -0
  436. package/src/docs/misc/dataProviderKey.md +168 -0
  437. package/src/docs/misc/docs-mock-api.md +62 -0
  438. package/src/docs/misc/dynamic-path.md +71 -0
  439. package/src/docs/misc/endpoint.md +45 -0
  440. package/src/docs/misc/html-integration.md +14 -0
  441. package/src/docs/mock-api/api-config-mock.ts +5 -0
  442. package/src/docs/mock-api/fixtures.ts +0 -278
  443. package/src/docs/mock-api/flights.ts +89 -0
  444. package/src/docs/mock-api/router.ts +3 -4
  445. package/src/docs/mock-api/urls.ts +1 -2
  446. package/src/docs/navigation/navigation.ts +82 -103
  447. package/src/docs/navigation/toc.ts +7 -4
  448. package/src/docs/search/docs-search.json +2804 -5024
  449. package/src/docs/search/markdown-renderer.ts +31 -8
  450. package/src/docs/search/page.ts +9 -6
  451. package/src/docs/search/search.ts +154 -122
  452. package/src/docs/tailwind/css/docs/content.css +4 -5
  453. package/src/tsconfig.json +11 -5
  454. package/src/tsconfig.tsbuildinfo +1 -1
  455. package/vite.config.mts +11 -2
  456. package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
  457. package/ai/AGENTS.md +0 -56
  458. package/ai/cursor/rules/concorde-menu.mdc +0 -15
  459. package/ai/cursor/rules/concorde-scope.mdc +0 -14
  460. package/ai/cursor/rules/concorde-theme.mdc +0 -13
  461. package/ai/cursor/rules/concorde.mdc +0 -66
  462. package/ai/jetbrains/rules/concorde.md +0 -53
  463. package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
  464. package/ai/skills/concorde-imports/SKILL.md +0 -78
  465. package/ai/skills/concorde-menu/SKILL.md +0 -74
  466. package/ai/skills/concorde-scope/SKILL.md +0 -70
  467. package/ai/skills/concorde-theme/SKILL.md +0 -57
  468. package/docs/assets/index-CD4WyL6o.css +0 -1
  469. package/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  470. package/src/docs/_core-concept/overview.md +0 -57
  471. package/src/docs/_core-concept/subscriber.md +0 -75
  472. package/src/docs/_decorators/ancestor-attribute.md +0 -128
  473. package/src/docs/_decorators/auto-subscribe.md +0 -202
  474. package/src/docs/_decorators/bind.md +0 -167
  475. package/src/docs/_decorators/get.md +0 -162
  476. package/src/docs/_decorators/handle.md +0 -175
  477. package/src/docs/_decorators/on-assign.md +0 -390
  478. package/src/docs/_decorators/patch.md +0 -70
  479. package/src/docs/_decorators/post.md +0 -146
  480. package/src/docs/_decorators/publish.md +0 -55
  481. package/src/docs/_decorators/put.md +0 -70
  482. package/src/docs/_decorators/subscribe.md +0 -100
  483. package/src/docs/_decorators/wait-for-ancestors.md +0 -163
  484. package/src/docs/_directives/sub.md +0 -91
  485. package/src/docs/_getting-started/ai-agents.md +0 -76
  486. package/src/docs/_getting-started/concorde-manual-install.md +0 -133
  487. package/src/docs/_getting-started/concorde-outside.md +0 -33
  488. package/src/docs/_getting-started/my-first-subscriber.md +0 -120
  489. package/src/docs/_getting-started/pubsub.md +0 -37
  490. package/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  491. package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
  492. package/src/docs/example/docs-joke-demos.ts +0 -297
  493. /package/{src/docs/_getting-started → docs/docs/getting-started}/components.md +0 -0
  494. /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`) |