@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/toast/toast.html ADDED
@@ -0,0 +1,185 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/ui/toast" data-doc-id="core/components/ui/toast/toast">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Toast — Concorde by Supersoniks</title>
7
+ <meta name="description" content="Toasts show short-lived feedback in a fixed stack at the bottom right of the page. Call SonicToast.add() (also window.SonicToast); the sonic-toast host is created on first use. Use label for a heading">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/ui/toast/toast, toast, Toast, UI component, sonic-toast, web component, SonicToast.add(), window.SonicToast, label, preserve, status, text, title">
9
+ <meta name="concorde-doc-id" content="core/components/ui/toast/toast">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/core/components/ui/toast">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/ui/toast.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/toast">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 — Toast</strong>. Toasts show short-lived feedback in a fixed stack at the bottom right of the page. Call SonicToast.add() (also window.SonicToast); the sonic-toast host is created on first use. Use label for a heading <span>Doc ID: <code>core/components/ui/toast/toast</code>. Keywords: Concorde, supersoniks, core/components/ui/toast/toast, toast, Toast, UI component, sonic-toast, web component, SonicToast.add(), window.SonicToast, label, preserve, status, text, title. URL: <a href="https://concorde.supersoniks.org/core/components/ui/toast">https://concorde.supersoniks.org/core/components/ui/toast</a>.</span></p>
20
+ <h1 id="toast">Toast</h1>
21
+ <p>Toasts show short-lived feedback in a fixed stack at the bottom right of the page. Call <strong><code>SonicToast.add()</code></strong> (also <code>window.SonicToast</code>); the <strong><code>sonic-toast</code></strong> host is created on first use. Use <strong><code>label</code></strong> for a heading and <strong><code>preserve</code></strong> when the user must read or act before the toast goes away.</p>
22
+ <h2 id="basic-example">Basic example</h2>
23
+ <pre><code>&lt;sonic-button onclick=&quot;SonicToast.add({ text: &#39;Flight CN 001 is now boarding&#39; })&quot;&gt;
24
+ Show toast
25
+ &lt;/sonic-button&gt;
26
+ </code></pre>
27
+ <h2 id="status">Status</h2>
28
+ <p><strong><code>status</code></strong> sets the color, the icon and the live-region role. With no <code>status</code>, the toast is neutral.</p>
29
+ <pre><code>&lt;div class=&quot;flex flex-wrap gap-2&quot;&gt;
30
+ &lt;sonic-button onclick=&quot;SonicToast.add({ text: &#39;Default message&#39; })&quot;&gt;Default&lt;/sonic-button&gt;
31
+ &lt;sonic-button onclick=&quot;SonicToast.add({ text: &#39;Operation succeeded&#39;, status: &#39;success&#39; })&quot;&gt;Success&lt;/sonic-button&gt;
32
+ &lt;sonic-button onclick=&quot;SonicToast.add({ text: &#39;Something went wrong&#39;, status: &#39;error&#39; })&quot;&gt;Error&lt;/sonic-button&gt;
33
+ &lt;sonic-button onclick=&quot;SonicToast.add({ text: &#39;Check this detail&#39;, status: &#39;warning&#39; })&quot;&gt;Warning&lt;/sonic-button&gt;
34
+ &lt;sonic-button onclick=&quot;SonicToast.add({ text: &#39;Helpful context&#39;, status: &#39;info&#39; })&quot;&gt;Info&lt;/sonic-button&gt;
35
+ &lt;/div&gt;
36
+ </code></pre>
37
+ <h2 id="label">Label</h2>
38
+ <p><strong><code>label</code></strong> adds a bold heading above <strong><code>text</code></strong>. <code>title</code> is a deprecated alias.</p>
39
+ <pre><code>&lt;sonic-button
40
+ onclick=&quot;SonicToast.add({ label: &#39;Gate change&#39;, text: &#39;Flight CN 001 now departs from gate B12.&#39;, status: &#39;warning&#39; })&quot;
41
+ &gt;
42
+ Toast with label
43
+ &lt;/sonic-button&gt;
44
+ </code></pre>
45
+ <h2 id="html-in-text">HTML in text</h2>
46
+ <p><strong><code>text</code></strong> and <strong><code>label</code></strong> accept HTML strings. A link or form control in <strong><code>text</code></strong> turns on <strong><code>preserve</code></strong> automatically.</p>
47
+ <pre><code>&lt;sonic-button
48
+ onclick=&quot;SonicToast.add({ text: &#39;Message with &lt;strong&gt;HTML&lt;/strong&gt; and an &lt;a href=&amp;quot;#&amp;quot;&gt;action link&lt;/a&gt;&#39;, status: &#39;info&#39; })&quot;
49
+ &gt;
50
+ Toast with HTML
51
+ &lt;/sonic-button&gt;
52
+ </code></pre>
53
+ <h2 id="preserve">Preserve</h2>
54
+ <p>Toasts hide after 6 seconds; the timer pauses on hover and focus. <strong><code>preserve</code></strong> keeps the toast until the user closes it.</p>
55
+ <pre><code>&lt;sonic-button
56
+ onclick=&quot;SonicToast.add({ text: &#39;Turbulence ahead: please fasten your seat belt&#39;, status: &#39;info&#39;, preserve: true })&quot;
57
+ &gt;
58
+ Persistent toast
59
+ &lt;/sonic-button&gt;
60
+ </code></pre>
61
+ <h2 id="dismiss-forever">Dismiss forever</h2>
62
+ <p>With <strong><code>dismissForever</code></strong> and a stable <strong><code>id</code></strong>, closing the toast is stored in <code>localStorage</code> and later <code>add()</code> calls with that <code>id</code> are ignored. A toast identical to one already shown (ignoring <code>id</code>) is never added twice.</p>
63
+ <pre><code>&lt;sonic-button
64
+ onclick=&quot;SonicToast.add({ id: &#39;welcome-toast&#39;, label: &#39;Welcome&#39;, text: &#39;Close me and I will not come back after a reload.&#39;, status: &#39;info&#39;, dismissForever: true })&quot;
65
+ &gt;
66
+ Dismiss forever
67
+ &lt;/sonic-button&gt;
68
+ </code></pre>
69
+ <h2 id="ghost">Ghost</h2>
70
+ <p><strong><code>ghost</code></strong> renders a semi-transparent, non-interactive toast, for example for a background task.</p>
71
+ <pre><code>&lt;sonic-button
72
+ onclick=&quot;SonicToast.add({ text: &#39;Syncing in the background&#39;, status: &#39;info&#39;, ghost: true })&quot;
73
+ &gt;
74
+ Ghost toast
75
+ &lt;/sonic-button&gt;
76
+ </code></pre>
77
+ <h2 id="removing-toasts">Removing toasts</h2>
78
+ <p>Static helpers clear the stack from script, for example after navigation. <strong><code>removeAll()</code></strong> keeps ghost toasts; <strong><code>removeTemporaryItems()</code></strong> keeps preserved ones.</p>
79
+ <pre><code>&lt;div class=&quot;flex flex-wrap gap-2&quot;&gt;
80
+ &lt;sonic-button onclick=&quot;SonicToast.add({ text: &#39;Temporary success&#39;, status: &#39;success&#39; })&quot;&gt;Add success&lt;/sonic-button&gt;
81
+ &lt;sonic-button onclick=&quot;SonicToast.add({ text: &#39;Temporary error&#39;, status: &#39;error&#39; })&quot;&gt;Add error&lt;/sonic-button&gt;
82
+ &lt;sonic-button onclick=&quot;SonicToast.add({ text: &#39;Persistent info&#39;, status: &#39;info&#39;, preserve: true })&quot;&gt;Add persistent&lt;/sonic-button&gt;
83
+ &lt;/div&gt;
84
+ &lt;div class=&quot;flex flex-wrap gap-2 mt-3&quot;&gt;
85
+ &lt;sonic-button variant=&quot;outline&quot; onclick=&quot;SonicToast.removeItemsByStatus(&#39;success&#39;)&quot;&gt;Remove success&lt;/sonic-button&gt;
86
+ &lt;sonic-button variant=&quot;outline&quot; onclick=&quot;SonicToast.removeTemporaryItems()&quot;&gt;Remove temporary&lt;/sonic-button&gt;
87
+ &lt;sonic-button variant=&quot;outline&quot; onclick=&quot;SonicToast.removeAll()&quot;&gt;Remove all&lt;/sonic-button&gt;
88
+ &lt;/div&gt;
89
+ </code></pre>
90
+ <p>Inside an iframe, toasts are forwarded to the parent window&#39;s stack when the parent also loads Concorde.</p>
91
+ <h2 id="api-reference">API reference</h2>
92
+ <p>Options of <strong><code>SonicToast.add(options)</code></strong>:</p>
93
+ <table>
94
+ <thead>
95
+ <tr>
96
+ <th>Option</th>
97
+ <th>Values</th>
98
+ <th>Description</th>
99
+ </tr>
100
+ </thead>
101
+ <tbody><tr>
102
+ <td><code>text</code></td>
103
+ <td>string · Lit template</td>
104
+ <td>Body, required; HTML strings allowed</td>
105
+ </tr>
106
+ <tr>
107
+ <td><code>label</code></td>
108
+ <td>string · Lit template</td>
109
+ <td>Heading above <code>text</code></td>
110
+ </tr>
111
+ <tr>
112
+ <td><code>title</code></td>
113
+ <td>string · Lit template</td>
114
+ <td>Deprecated alias of <code>label</code></td>
115
+ </tr>
116
+ <tr>
117
+ <td><code>status</code></td>
118
+ <td><code>success</code> · <code>error</code> · <code>warning</code> · <code>info</code> (default neutral)</td>
119
+ <td>Color and icon; <code>error</code> gets <code>role=&quot;alert&quot;</code>, others <code>role=&quot;status&quot;</code></td>
120
+ </tr>
121
+ <tr>
122
+ <td><code>id</code></td>
123
+ <td>string · number (default timestamp)</td>
124
+ <td>Identifier for <code>removeItemById</code> and <code>dismissForever</code></td>
125
+ </tr>
126
+ <tr>
127
+ <td><code>preserve</code></td>
128
+ <td>boolean</td>
129
+ <td>No auto-hide; forced when <code>text</code> contains a link or control</td>
130
+ </tr>
131
+ <tr>
132
+ <td><code>ghost</code></td>
133
+ <td>boolean</td>
134
+ <td>Semi-transparent and non-interactive; kept by <code>removeAll</code></td>
135
+ </tr>
136
+ <tr>
137
+ <td><code>dismissForever</code></td>
138
+ <td>boolean</td>
139
+ <td>Remember the dismissal in <code>localStorage</code>; needs a stable <code>id</code></td>
140
+ </tr>
141
+ <tr>
142
+ <td><code>styleSheet</code></td>
143
+ <td><code>CSSResult</code> · <code>CSSStyleSheet</code> · array</td>
144
+ <td>Extra styles adopted by the toast</td>
145
+ </tr>
146
+ <tr>
147
+ <td><code>useSlot</code></td>
148
+ <td>boolean</td>
149
+ <td>Legacy: render <code>text</code> in the light DOM</td>
150
+ </tr>
151
+ </tbody></table>
152
+ <table>
153
+ <thead>
154
+ <tr>
155
+ <th>Method</th>
156
+ <th>Description</th>
157
+ </tr>
158
+ </thead>
159
+ <tbody><tr>
160
+ <td><code>SonicToast.add(options)</code></td>
161
+ <td>Show a toast; returns the stored config, or <code>null</code> when skipped</td>
162
+ </tr>
163
+ <tr>
164
+ <td><code>SonicToast.removeAll()</code></td>
165
+ <td>Remove every toast except ghosts</td>
166
+ </tr>
167
+ <tr>
168
+ <td><code>SonicToast.removeItemsByStatus(status)</code></td>
169
+ <td>Remove toasts with this <code>status</code></td>
170
+ </tr>
171
+ <tr>
172
+ <td><code>SonicToast.removeItemById(id)</code></td>
173
+ <td>Remove one toast</td>
174
+ </tr>
175
+ <tr>
176
+ <td><code>SonicToast.removeTemporaryItems()</code></td>
177
+ <td>Remove toasts without <code>preserve</code></td>
178
+ </tr>
179
+ </tbody></table>
180
+ <p><code>sonic-toast</code> and <code>sonic-toast-item</code> are created by <code>add()</code>; do not write them in markup. <code>sonic-toast-message-subscriber</code> shows a toast for each <code>{ type: &quot;public&quot;, content, status }</code> entry of its <code>messages</code> property.</p>
181
+
182
+ </article>
183
+ </main>
184
+ </body>
185
+ </html>
package/docs/core/components/ui/toast/toast.md ADDED
@@ -0,0 +1,147 @@
1
+ # Toast
2
+
3
+ Toasts show short-lived feedback in a fixed stack at the bottom right of the page. Call **`SonicToast.add()`** (also `window.SonicToast`); the **`sonic-toast`** host is created on first use. Use **`label`** for a heading and **`preserve`** when the user must read or act before the toast goes away.
4
+
5
+ ## Basic example
6
+
7
+ <sonic-code>
8
+ <template>
9
+ <sonic-button onclick="SonicToast.add({ text: 'Flight CN 001 is now boarding' })">
10
+ Show toast
11
+ </sonic-button>
12
+ </template>
13
+ </sonic-code>
14
+
15
+ ## Status
16
+
17
+ **`status`** sets the color, the icon and the live-region role. With no `status`, the toast is neutral.
18
+
19
+ <sonic-code>
20
+ <template>
21
+ <div class="flex flex-wrap gap-2">
22
+ <sonic-button onclick="SonicToast.add({ text: 'Default message' })">Default</sonic-button>
23
+ <sonic-button onclick="SonicToast.add({ text: 'Operation succeeded', status: 'success' })">Success</sonic-button>
24
+ <sonic-button onclick="SonicToast.add({ text: 'Something went wrong', status: 'error' })">Error</sonic-button>
25
+ <sonic-button onclick="SonicToast.add({ text: 'Check this detail', status: 'warning' })">Warning</sonic-button>
26
+ <sonic-button onclick="SonicToast.add({ text: 'Helpful context', status: 'info' })">Info</sonic-button>
27
+ </div>
28
+ </template>
29
+ </sonic-code>
30
+
31
+ ## Label
32
+
33
+ **`label`** adds a bold heading above **`text`**. `title` is a deprecated alias.
34
+
35
+ <sonic-code>
36
+ <template>
37
+ <sonic-button
38
+ onclick="SonicToast.add({ label: 'Gate change', text: 'Flight CN 001 now departs from gate B12.', status: 'warning' })"
39
+ >
40
+ Toast with label
41
+ </sonic-button>
42
+ </template>
43
+ </sonic-code>
44
+
45
+ ## HTML in text
46
+
47
+ **`text`** and **`label`** accept HTML strings. A link or form control in **`text`** turns on **`preserve`** automatically.
48
+
49
+ <sonic-code>
50
+ <template>
51
+ <sonic-button
52
+ onclick="SonicToast.add({ text: 'Message with <strong>HTML</strong> and an <a href=&quot;#&quot;>action link</a>', status: 'info' })"
53
+ >
54
+ Toast with HTML
55
+ </sonic-button>
56
+ </template>
57
+ </sonic-code>
58
+
59
+ ## Preserve
60
+
61
+ Toasts hide after 6 seconds; the timer pauses on hover and focus. **`preserve`** keeps the toast until the user closes it.
62
+
63
+ <sonic-code>
64
+ <template>
65
+ <sonic-button
66
+ onclick="SonicToast.add({ text: 'Turbulence ahead: please fasten your seat belt', status: 'info', preserve: true })"
67
+ >
68
+ Persistent toast
69
+ </sonic-button>
70
+ </template>
71
+ </sonic-code>
72
+
73
+ ## Dismiss forever
74
+
75
+ With **`dismissForever`** and a stable **`id`**, closing the toast is stored in `localStorage` and later `add()` calls with that `id` are ignored. A toast identical to one already shown (ignoring `id`) is never added twice.
76
+
77
+ <sonic-code>
78
+ <template>
79
+ <sonic-button
80
+ onclick="SonicToast.add({ id: 'welcome-toast', label: 'Welcome', text: 'Close me and I will not come back after a reload.', status: 'info', dismissForever: true })"
81
+ >
82
+ Dismiss forever
83
+ </sonic-button>
84
+ </template>
85
+ </sonic-code>
86
+
87
+ ## Ghost
88
+
89
+ **`ghost`** renders a semi-transparent, non-interactive toast, for example for a background task.
90
+
91
+ <sonic-code>
92
+ <template>
93
+ <sonic-button
94
+ onclick="SonicToast.add({ text: 'Syncing in the background', status: 'info', ghost: true })"
95
+ >
96
+ Ghost toast
97
+ </sonic-button>
98
+ </template>
99
+ </sonic-code>
100
+
101
+ ## Removing toasts
102
+
103
+ Static helpers clear the stack from script, for example after navigation. **`removeAll()`** keeps ghost toasts; **`removeTemporaryItems()`** keeps preserved ones.
104
+
105
+ <sonic-code>
106
+ <template>
107
+ <div class="flex flex-wrap gap-2">
108
+ <sonic-button onclick="SonicToast.add({ text: 'Temporary success', status: 'success' })">Add success</sonic-button>
109
+ <sonic-button onclick="SonicToast.add({ text: 'Temporary error', status: 'error' })">Add error</sonic-button>
110
+ <sonic-button onclick="SonicToast.add({ text: 'Persistent info', status: 'info', preserve: true })">Add persistent</sonic-button>
111
+ </div>
112
+ <div class="flex flex-wrap gap-2 mt-3">
113
+ <sonic-button variant="outline" onclick="SonicToast.removeItemsByStatus('success')">Remove success</sonic-button>
114
+ <sonic-button variant="outline" onclick="SonicToast.removeTemporaryItems()">Remove temporary</sonic-button>
115
+ <sonic-button variant="outline" onclick="SonicToast.removeAll()">Remove all</sonic-button>
116
+ </div>
117
+ </template>
118
+ </sonic-code>
119
+
120
+ Inside an iframe, toasts are forwarded to the parent window's stack when the parent also loads Concorde.
121
+
122
+ ## API reference
123
+
124
+ Options of **`SonicToast.add(options)`**:
125
+
126
+ | Option | Values | Description |
127
+ |----------|---------|-------------|
128
+ | `text` | string · Lit template | Body, required; HTML strings allowed |
129
+ | `label` | string · Lit template | Heading above `text` |
130
+ | `title` | string · Lit template | Deprecated alias of `label` |
131
+ | `status` | `success` · `error` · `warning` · `info` (default neutral) | Color and icon; `error` gets `role="alert"`, others `role="status"` |
132
+ | `id` | string · number (default timestamp) | Identifier for `removeItemById` and `dismissForever` |
133
+ | `preserve` | boolean | No auto-hide; forced when `text` contains a link or control |
134
+ | `ghost` | boolean | Semi-transparent and non-interactive; kept by `removeAll` |
135
+ | `dismissForever` | boolean | Remember the dismissal in `localStorage`; needs a stable `id` |
136
+ | `styleSheet` | `CSSResult` · `CSSStyleSheet` · array | Extra styles adopted by the toast |
137
+ | `useSlot` | boolean | Legacy: render `text` in the light DOM |
138
+
139
+ | Method | Description |
140
+ |--------|-------------|
141
+ | `SonicToast.add(options)` | Show a toast; returns the stored config, or `null` when skipped |
142
+ | `SonicToast.removeAll()` | Remove every toast except ghosts |
143
+ | `SonicToast.removeItemsByStatus(status)` | Remove toasts with this `status` |
144
+ | `SonicToast.removeItemById(id)` | Remove one toast |
145
+ | `SonicToast.removeTemporaryItems()` | Remove toasts without `preserve` |
146
+
147
+ `sonic-toast` and `sonic-toast-item` are created by `add()`; do not write them in markup. `sonic-toast-message-subscriber` shows a toast for each `{ type: "public", content, status }` entry of its `messages` property.
package/docs/core/components/ui/tooltip/tooltip.html ADDED
@@ -0,0 +1,112 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/ui/tooltip" data-doc-id="core/components/ui/tooltip/tooltip">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Tooltip — Concorde by Supersoniks</title>
7
+ <meta name="description" content="sonic-tooltip shows a short label in a bubble when the trigger in the default slot is hovered or receives focus. With no placement, the bubble sits on top, centered. An empty label hides the bubble, l">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/ui/tooltip/tooltip, tooltip, Tooltip, UI component, sonic-tooltip, web component, label, placement, top, disabled, bottom, left, right">
9
+ <meta name="concorde-doc-id" content="core/components/ui/tooltip/tooltip">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/core/components/ui/tooltip">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/ui/tooltip.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/tooltip">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 — Tooltip</strong>. sonic-tooltip shows a short label in a bubble when the trigger in the default slot is hovered or receives focus. With no placement, the bubble sits on top, centered. An empty label hides the bubble, l <span>Doc ID: <code>core/components/ui/tooltip/tooltip</code>. Keywords: Concorde, supersoniks, core/components/ui/tooltip/tooltip, tooltip, Tooltip, UI component, sonic-tooltip, web component, label, placement, top, disabled, bottom, left, right. URL: <a href="https://concorde.supersoniks.org/core/components/ui/tooltip">https://concorde.supersoniks.org/core/components/ui/tooltip</a>.</span></p>
20
+ <h1 id="tooltip">Tooltip</h1>
21
+ <p><strong><code>sonic-tooltip</code></strong> shows a short <code>label</code> in a bubble when the trigger in the default slot is hovered or receives focus. With no <code>placement</code>, the bubble sits on <code>top</code>, centered. An empty <code>label</code> hides the bubble, like <code>disabled</code>.</p>
22
+ <h2 id="basic-example">Basic example</h2>
23
+ <pre><code>&lt;sonic-tooltip label=&quot;Cruising at Mach 2.04&quot;&gt;
24
+ &lt;sonic-button variant=&quot;outline&quot;&gt;Hover me&lt;/sonic-button&gt;
25
+ &lt;/sonic-tooltip&gt;
26
+ </code></pre>
27
+ <h2 id="placement">Placement</h2>
28
+ <p><code>top</code> · <code>bottom</code> · <code>left</code> · <code>right</code> set the side. Add <code>-start</code> or <code>-end</code> to align the bubble with an edge of the trigger instead of its center. The bubble is repositioned while open to stay in the viewport.</p>
29
+ <pre><code>&lt;div class=&quot;flex flex-wrap gap-3&quot;&gt;
30
+ &lt;sonic-tooltip placement=&quot;top&quot; label=&quot;top&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;top&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
31
+ &lt;sonic-tooltip placement=&quot;top-start&quot; label=&quot;top-start&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;top-start&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
32
+ &lt;sonic-tooltip placement=&quot;top-end&quot; label=&quot;top-end&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;top-end&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
33
+ &lt;sonic-tooltip placement=&quot;bottom&quot; label=&quot;bottom&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;bottom&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
34
+ &lt;sonic-tooltip placement=&quot;bottom-start&quot; label=&quot;bottom-start&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;bottom-start&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
35
+ &lt;sonic-tooltip placement=&quot;bottom-end&quot; label=&quot;bottom-end&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;bottom-end&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
36
+ &lt;sonic-tooltip placement=&quot;left&quot; label=&quot;left&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;left&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
37
+ &lt;sonic-tooltip placement=&quot;left-start&quot; label=&quot;left-start&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;left-start&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
38
+ &lt;sonic-tooltip placement=&quot;left-end&quot; label=&quot;left-end&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;left-end&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
39
+ &lt;sonic-tooltip placement=&quot;right&quot; label=&quot;right&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;right&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
40
+ &lt;sonic-tooltip placement=&quot;right-start&quot; label=&quot;right-start&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;right-start&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
41
+ &lt;sonic-tooltip placement=&quot;right-end&quot; label=&quot;right-end&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;right-end&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
42
+ &lt;/div&gt;
43
+ </code></pre>
44
+ <h2 id="multiline-label">Multiline label</h2>
45
+ <p>Line breaks in <code>label</code> (a real newline or <code>&amp;#10;</code>) are kept. Each line is trimmed and the bubble wraps at <code>18rem</code>.</p>
46
+ <pre><code>&lt;sonic-tooltip label=&quot;Gate B12&amp;#10;Boarding at 08:15&quot;&gt;
47
+ &lt;sonic-button variant=&quot;outline&quot;&gt;Multiline label&lt;/sonic-button&gt;
48
+ &lt;/sonic-tooltip&gt;
49
+ </code></pre>
50
+ <h2 id="focusable">Focusable</h2>
51
+ <p>Set <code>focusable</code> when the trigger is not focusable itself (text, icon): the host gets <code>tabindex=&quot;0&quot;</code> so keyboard users can open the tooltip. The bubble uses <code>popover=&quot;hint&quot;</code>; without Popover API support, the label falls back to a native <code>title</code> on one line.</p>
52
+ <pre><code>&lt;sonic-tooltip
53
+ focusable
54
+ label=&quot;The Concorde made its first transatlantic crossing on September 26, 1973&quot;
55
+ &gt;
56
+ &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;chat-bubble-question&quot;&gt;&lt;/sonic-icon&gt;
57
+ Focus or hover this text
58
+ &lt;/sonic-tooltip&gt;
59
+ </code></pre>
60
+ <h2 id="disabled">Disabled</h2>
61
+ <p><code>disabled</code> never shows the bubble and sets <code>tabindex=&quot;-1&quot;</code> on the host.</p>
62
+ <pre><code>&lt;sonic-tooltip disabled label=&quot;Not shown&quot;&gt;
63
+ &lt;sonic-button&gt;Tooltip disabled&lt;/sonic-button&gt;
64
+ &lt;/sonic-tooltip&gt;
65
+ </code></pre>
66
+ <h2 id="api-reference">API reference</h2>
67
+ <table>
68
+ <thead>
69
+ <tr>
70
+ <th>Attribute</th>
71
+ <th>Values</th>
72
+ <th>Description</th>
73
+ </tr>
74
+ </thead>
75
+ <tbody><tr>
76
+ <td><code>label</code></td>
77
+ <td>string</td>
78
+ <td>Tooltip text; empty or whitespace-only hides the bubble</td>
79
+ </tr>
80
+ <tr>
81
+ <td><code>placement</code></td>
82
+ <td><code>top</code> (default) · <code>bottom</code> · <code>left</code> · <code>right</code>, each with optional <code>-start</code> · <code>-end</code></td>
83
+ <td>Side and alignment relative to the trigger</td>
84
+ </tr>
85
+ <tr>
86
+ <td><code>disabled</code></td>
87
+ <td>boolean</td>
88
+ <td>Never show the bubble; sets <code>tabindex=&quot;-1&quot;</code> on the host</td>
89
+ </tr>
90
+ <tr>
91
+ <td><code>focusable</code></td>
92
+ <td>boolean</td>
93
+ <td>Sets <code>tabindex=&quot;0&quot;</code> on the host so the tooltip opens on keyboard focus</td>
94
+ </tr>
95
+ </tbody></table>
96
+ <table>
97
+ <thead>
98
+ <tr>
99
+ <th>Slot</th>
100
+ <th>Description</th>
101
+ </tr>
102
+ </thead>
103
+ <tbody><tr>
104
+ <td><em>(default)</em></td>
105
+ <td>Trigger content</td>
106
+ </tr>
107
+ </tbody></table>
108
+
109
+ </article>
110
+ </main>
111
+ </body>
112
+ </html>
package/docs/core/components/ui/tooltip/tooltip.md ADDED
@@ -0,0 +1,89 @@
1
+ # Tooltip
2
+
3
+ **`sonic-tooltip`** shows a short `label` in a bubble when the trigger in the default slot is hovered or receives focus. With no `placement`, the bubble sits on `top`, centered. An empty `label` hides the bubble, like `disabled`.
4
+
5
+ ## Basic example
6
+
7
+ <sonic-code>
8
+ <template>
9
+ <sonic-tooltip label="Cruising at Mach 2.04">
10
+ <sonic-button variant="outline">Hover me</sonic-button>
11
+ </sonic-tooltip>
12
+ </template>
13
+ </sonic-code>
14
+
15
+ ## Placement
16
+
17
+ `top` · `bottom` · `left` · `right` set the side. Add `-start` or `-end` to align the bubble with an edge of the trigger instead of its center. The bubble is repositioned while open to stay in the viewport.
18
+
19
+ <sonic-code>
20
+ <template>
21
+ <div class="flex flex-wrap gap-3">
22
+ <sonic-tooltip placement="top" label="top"><sonic-button minWidth="9rem">top</sonic-button></sonic-tooltip>
23
+ <sonic-tooltip placement="top-start" label="top-start"><sonic-button minWidth="9rem">top-start</sonic-button></sonic-tooltip>
24
+ <sonic-tooltip placement="top-end" label="top-end"><sonic-button minWidth="9rem">top-end</sonic-button></sonic-tooltip>
25
+ <sonic-tooltip placement="bottom" label="bottom"><sonic-button minWidth="9rem">bottom</sonic-button></sonic-tooltip>
26
+ <sonic-tooltip placement="bottom-start" label="bottom-start"><sonic-button minWidth="9rem">bottom-start</sonic-button></sonic-tooltip>
27
+ <sonic-tooltip placement="bottom-end" label="bottom-end"><sonic-button minWidth="9rem">bottom-end</sonic-button></sonic-tooltip>
28
+ <sonic-tooltip placement="left" label="left"><sonic-button minWidth="9rem">left</sonic-button></sonic-tooltip>
29
+ <sonic-tooltip placement="left-start" label="left-start"><sonic-button minWidth="9rem">left-start</sonic-button></sonic-tooltip>
30
+ <sonic-tooltip placement="left-end" label="left-end"><sonic-button minWidth="9rem">left-end</sonic-button></sonic-tooltip>
31
+ <sonic-tooltip placement="right" label="right"><sonic-button minWidth="9rem">right</sonic-button></sonic-tooltip>
32
+ <sonic-tooltip placement="right-start" label="right-start"><sonic-button minWidth="9rem">right-start</sonic-button></sonic-tooltip>
33
+ <sonic-tooltip placement="right-end" label="right-end"><sonic-button minWidth="9rem">right-end</sonic-button></sonic-tooltip>
34
+ </div>
35
+ </template>
36
+ </sonic-code>
37
+
38
+ ## Multiline label
39
+
40
+ Line breaks in `label` (a real newline or `&#10;`) are kept. Each line is trimmed and the bubble wraps at `18rem`.
41
+
42
+ <sonic-code>
43
+ <template>
44
+ <sonic-tooltip label="Gate B12&#10;Boarding at 08:15">
45
+ <sonic-button variant="outline">Multiline label</sonic-button>
46
+ </sonic-tooltip>
47
+ </template>
48
+ </sonic-code>
49
+
50
+ ## Focusable
51
+
52
+ Set `focusable` when the trigger is not focusable itself (text, icon): the host gets `tabindex="0"` so keyboard users can open the tooltip. The bubble uses `popover="hint"`; without Popover API support, the label falls back to a native `title` on one line.
53
+
54
+ <sonic-code>
55
+ <template>
56
+ <sonic-tooltip
57
+ focusable
58
+ label="The Concorde made its first transatlantic crossing on September 26, 1973"
59
+ >
60
+ <sonic-icon library="iconoir" name="chat-bubble-question"></sonic-icon>
61
+ Focus or hover this text
62
+ </sonic-tooltip>
63
+ </template>
64
+ </sonic-code>
65
+
66
+ ## Disabled
67
+
68
+ `disabled` never shows the bubble and sets `tabindex="-1"` on the host.
69
+
70
+ <sonic-code>
71
+ <template>
72
+ <sonic-tooltip disabled label="Not shown">
73
+ <sonic-button>Tooltip disabled</sonic-button>
74
+ </sonic-tooltip>
75
+ </template>
76
+ </sonic-code>
77
+
78
+ ## API reference
79
+
80
+ | Attribute | Values | Description |
81
+ |----------|---------|-------------|
82
+ | `label` | string | Tooltip text; empty or whitespace-only hides the bubble |
83
+ | `placement` | `top` (default) · `bottom` · `left` · `right`, each with optional `-start` · `-end` | Side and alignment relative to the trigger |
84
+ | `disabled` | boolean | Never show the bubble; sets `tabindex="-1"` on the host |
85
+ | `focusable` | boolean | Sets `tabindex="0"` on the host so the tooltip opens on keyboard focus |
86
+
87
+ | Slot | Description |
88
+ |------|-------------|
89
+ | *(default)* | Trigger content |
package/docs/docs/decorators/ancestor-attribute.html ADDED
@@ -0,0 +1,71 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute" data-doc-id="docs/decorators/ancestor-attribute">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>@ancestorAttribute — Concorde by Supersoniks</title>
7
+ <meta name="description" content="Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as dataProvid">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/decorators/ancestor-attribute, ancestor-attribute, @ancestorAttribute, decorator, ancestorAttribute, dataProvider, connectedCallback, , &quot;&quot;, dataprovider, { dynamic: true }, null, @state(), &quot;${dataProvider}&quot;">
9
+ <meta name="concorde-doc-id" content="docs/decorators/ancestor-attribute">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute.md">
12
+ </head>
13
+ <body>
14
+ <header>
15
+ <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute">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 decorator — @ancestorAttribute</strong>. Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as dataProvid <span>Doc ID: <code>docs/decorators/ancestor-attribute</code>. Keywords: Concorde, supersoniks, docs/decorators/ancestor-attribute, ancestor-attribute, @ancestorAttribute, decorator, ancestorAttribute, dataProvider, connectedCallback, , &quot;&quot;, dataprovider, { dynamic: true }, null, @state(), &quot;${dataProvider}&quot;. URL: <a href="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute">https://concorde.supersoniks.org/docs/decorators/ancestor-attribute</a>.</span></p>
20
+ <h1 id="ancestorattribute">@ancestorAttribute</h1>
21
+ <p>Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as <code>dataProvider</code> without passing it down by hand, typically to feed a dynamic key of <a href="/docs/decorators/subscribe">@subscribe</a>.</p>
22
+ <h2 id="import">Import</h2>
23
+ <pre><code class="language-typescript">import { ancestorAttribute } from &quot;@supersoniks/concorde/decorators&quot;;
24
+
25
+ @ancestorAttribute(&quot;dataProvider&quot;)
26
+ dataProvider: string | null = null;
27
+ </code></pre>
28
+ <h2 id="read-once-at-connect">Read once at connect</h2>
29
+ <p>By default the value is read once, just before the component&#39;s <code>connectedCallback</code>, and never updated. The closest element with the attribute wins. If no ancestor has it, the property keeps its initial value.</p>
30
+ <pre><code>&lt;div dataProvider=&quot;flights.CN001&quot; gate=&quot;B12&quot;&gt;
31
+ &lt;docs-demo-sources for=&quot;demo-ancestor-attribute&quot;&gt;&lt;/docs-demo-sources&gt;
32
+ &lt;demo-ancestor-attribute&gt;&lt;/demo-ancestor-attribute&gt;
33
+ &lt;/div&gt;
34
+ </code></pre>
35
+ <p>An attribute present without a value (<code>&lt;div gate&gt;</code>) resolves to <code>&quot;&quot;</code>. A camelCase name also matches its lowercase form (<code>dataProvider</code> and <code>dataprovider</code>).</p>
36
+ <h2 id="follow-dom-changes">Follow DOM changes</h2>
37
+ <p>With <code>{ dynamic: true }</code>, the property stays in sync while the component is connected: when an ancestor changes the attribute, when a closer ancestor gains or loses it, and when the component is moved. When no ancestor has the attribute, the property becomes <code>null</code>. Add <code>@state()</code> so Lit re-renders on each assignment.</p>
38
+ <pre><code class="language-typescript">@ancestorAttribute(&quot;dataProvider&quot;, { dynamic: true })
39
+ @state()
40
+ dataProvider: string | null = null;
41
+ </code></pre>
42
+ <p>Change the parent or outer value, insert a closer wrapper, or remove an attribute: the child always shows the nearest one.</p>
43
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-ancestor-attribute-dynamic-section&quot;&gt;&lt;/docs-demo-sources&gt;
44
+ &lt;demo-ancestor-attribute-dynamic-section&gt;&lt;/demo-ancestor-attribute-dynamic-section&gt;
45
+ </code></pre>
46
+ <p>Keys of <a href="/docs/decorators/subscribe">@subscribe</a> and <a href="/docs/decorators/bind">@bind</a> that use the property as a placeholder (<code>&quot;${dataProvider}&quot;</code>) are re-resolved on each change.</p>
47
+ <h2 id="api-reference">API reference</h2>
48
+ <table>
49
+ <thead>
50
+ <tr>
51
+ <th>Argument</th>
52
+ <th>Type</th>
53
+ <th>Description</th>
54
+ </tr>
55
+ </thead>
56
+ <tbody><tr>
57
+ <td><code>attributeName</code></td>
58
+ <td><code>string</code></td>
59
+ <td>Attribute to look up on the host, then on its ancestors</td>
60
+ </tr>
61
+ <tr>
62
+ <td><code>options.dynamic</code></td>
63
+ <td><code>boolean</code> (default <code>false</code>)</td>
64
+ <td>Keep the property in sync with attribute changes and reparenting until disconnect; assigns <code>null</code> when no ancestor has the attribute</td>
65
+ </tr>
66
+ </tbody></table>
67
+
68
+ </article>
69
+ </main>
70
+ </body>
71
+ </html>