@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/modal/modal.html ADDED
@@ -0,0 +1,324 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/ui/modal" data-doc-id="core/components/ui/modal/modal">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Modal — Concorde by Supersoniks</title>
7
+ <meta name="description" content="sonic-modal shows focused content in a dialog with a backdrop, an enter / exit animation and a built-in close button. Compose it with sonic-modal-title · sonic-modal-subtitle · sonic-modal-content · s">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/ui/modal/modal, modal, Modal, UI component, sonic-modal, web component, sonic-modal-title, sonic-modal-subtitle, sonic-modal-content, sonic-modal-actions, show(), hide(), hideModal, sonic-button">
9
+ <meta name="concorde-doc-id" content="core/components/ui/modal/modal">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/core/components/ui/modal">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/ui/modal.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/modal">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 — Modal</strong>. sonic-modal shows focused content in a dialog with a backdrop, an enter / exit animation and a built-in close button. Compose it with sonic-modal-title · sonic-modal-subtitle · sonic-modal-content · s <span>Doc ID: <code>core/components/ui/modal/modal</code>. Keywords: Concorde, supersoniks, core/components/ui/modal/modal, modal, Modal, UI component, sonic-modal, web component, sonic-modal-title, sonic-modal-subtitle, sonic-modal-content, sonic-modal-actions, show(), hide(), hideModal, sonic-button. URL: <a href="https://concorde.supersoniks.org/core/components/ui/modal">https://concorde.supersoniks.org/core/components/ui/modal</a>.</span></p>
20
+ <h1 id="modal">Modal</h1>
21
+ <p><strong><code>sonic-modal</code></strong> shows focused content in a dialog with a backdrop, an enter / exit animation and a built-in close button. Compose it with <strong><code>sonic-modal-title</code></strong> · <strong><code>sonic-modal-subtitle</code></strong> · <strong><code>sonic-modal-content</code></strong> · <strong><code>sonic-modal-actions</code></strong>, open it with <strong><code>show()</code></strong> and close it with <strong><code>hide()</code></strong> or a <strong><code>hideModal</code></strong> button.</p>
22
+ <h2 id="basic-example">Basic example</h2>
23
+ <p>Backdrop click, Escape and the close button all close the modal. In <strong><code>sonic-modal-actions</code></strong>, a <strong><code>sonic-button</code></strong> with <strong><code>hideModal</code></strong> closes it on click.</p>
24
+ <pre><code>&lt;sonic-button onclick=&quot;document.getElementById(&#39;modalExample&#39;).show()&quot;&gt;
25
+ Open modal
26
+ &lt;/sonic-button&gt;
27
+ &lt;sonic-modal id=&quot;modalExample&quot;&gt;
28
+ &lt;sonic-modal-title&gt;
29
+ Boarding pass ready
30
+ &lt;sonic-badge type=&quot;success&quot; size=&quot;sm&quot;&gt;New&lt;/sonic-badge&gt;
31
+ &lt;/sonic-modal-title&gt;
32
+ &lt;sonic-modal-subtitle&gt;Your check-in is complete.&lt;/sonic-modal-subtitle&gt;
33
+ &lt;sonic-modal-content&gt;
34
+ Download your boarding pass now or review your seat before departure.
35
+ &lt;/sonic-modal-content&gt;
36
+ &lt;sonic-modal-actions&gt;
37
+ &lt;sonic-button minWidth=&quot;8rem&quot; hideModal&gt;Later&lt;/sonic-button&gt;
38
+ &lt;sonic-button minWidth=&quot;8rem&quot; type=&quot;success&quot; hideModal&gt;Download&lt;/sonic-button&gt;
39
+ &lt;/sonic-modal-actions&gt;
40
+ &lt;/sonic-modal&gt;
41
+ </code></pre>
42
+ <p><strong><code>hideModal</code></strong> only works on <strong><code>sonic-button</code></strong> elements that are direct children of <strong><code>sonic-modal-actions</code></strong>.</p>
43
+ <h2 id="scrollable-content">Scrollable content</h2>
44
+ <p>Long content scrolls inside the dialog once it reaches <strong><code>maxHeight</code></strong> (default <code>90vh</code>). Content is left-aligned by default; set <strong><code>align</code></strong> to <code>center</code> or <code>right</code>.</p>
45
+ <pre><code>&lt;sonic-button onclick=&quot;document.getElementById(&#39;modalText&#39;).show()&quot;&gt;Baggage details&lt;/sonic-button&gt;
46
+ &lt;sonic-modal id=&quot;modalText&quot; maxHeight=&quot;20rem&quot;&gt;
47
+ &lt;sonic-modal-title&gt;Baggage allowance&lt;/sonic-modal-title&gt;
48
+ &lt;sonic-modal-content&gt;
49
+ &lt;div class=&quot;prose&quot;&gt;
50
+ &lt;p&gt;&lt;strong&gt;Cabin bag&lt;/strong&gt;&lt;br /&gt;One cabin bag and one personal item are included in every cabin class.&lt;/p&gt;
51
+ &lt;p&gt;&lt;strong&gt;Checked baggage&lt;/strong&gt;&lt;br /&gt;Drop checked bags at the counter at least one hour before departure.&lt;/p&gt;
52
+ &lt;p&gt;&lt;strong&gt;Extra baggage&lt;/strong&gt;&lt;br /&gt;Add extra baggage online up to 24 hours before the flight.&lt;/p&gt;
53
+ &lt;p&gt;&lt;strong&gt;Contact&lt;/strong&gt;&lt;br /&gt;support@example.com&lt;/p&gt;
54
+ &lt;/div&gt;
55
+ &lt;/sonic-modal-content&gt;
56
+ &lt;/sonic-modal&gt;
57
+ </code></pre>
58
+ <h2 id="force-action">Force action</h2>
59
+ <p>With <strong><code>forceAction</code></strong>, backdrop click, Escape and the close button are disabled. Provide <strong><code>hideModal</code></strong> buttons so users can finish the flow. <strong><code>noCloseButton</code></strong> only hides the close button.</p>
60
+ <pre><code>&lt;sonic-button onclick=&quot;document.getElementById(&#39;force&#39;).show()&quot;&gt;Cookie consent&lt;/sonic-button&gt;
61
+ &lt;sonic-modal forceAction id=&quot;force&quot;&gt;
62
+ &lt;sonic-modal-title&gt;Allow analytics cookies?&lt;/sonic-modal-title&gt;
63
+ &lt;sonic-modal-content&gt;
64
+ Analytics cookies measure traffic. You can change this later in settings.
65
+ &lt;/sonic-modal-content&gt;
66
+ &lt;sonic-modal-actions&gt;
67
+ &lt;sonic-button hideModal minWidth=&quot;8rem&quot;&gt;Decline&lt;/sonic-button&gt;
68
+ &lt;sonic-button hideModal minWidth=&quot;8rem&quot; type=&quot;success&quot;&gt;Accept&lt;/sonic-button&gt;
69
+ &lt;/sonic-modal-actions&gt;
70
+ &lt;/sonic-modal&gt;
71
+ </code></pre>
72
+ <h2 id="dimensions">Dimensions</h2>
73
+ <p>Set <strong><code>width</code></strong> · <strong><code>height</code></strong> · <strong><code>maxWidth</code></strong> · <strong><code>maxHeight</code></strong> with CSS lengths. Below 768px the panel becomes a bottom sheet. <strong><code>rounded=&quot;none&quot;</code></strong> removes the corner radius for edge-to-edge media.</p>
74
+ <pre><code>&lt;sonic-button onclick=&quot;document.getElementById(&#39;CustomWidth&#39;).show()&quot;&gt;Image preview&lt;/sonic-button&gt;
75
+ &lt;sonic-modal
76
+ rounded=&quot;none&quot;
77
+ maxHeight=&quot;50vh&quot;
78
+ maxWidth=&quot;90vw&quot;
79
+ width=&quot;100%&quot;
80
+ height=&quot;100%&quot;
81
+ id=&quot;CustomWidth&quot;
82
+ &gt;
83
+ &lt;sonic-image
84
+ cover
85
+ src=&quot;img/concorde/plane_12.jpg&quot;
86
+ alt=&quot;Concorde at the gate with boarding stairs&quot;
87
+ &gt;&lt;/sonic-image&gt;
88
+ &lt;/sonic-modal&gt;
89
+ </code></pre>
90
+ <h2 id="fullscreen">Fullscreen</h2>
91
+ <p><strong><code>fullscreen</code></strong> fills the viewport and hides the backdrop.</p>
92
+ <pre><code>&lt;sonic-button onclick=&quot;document.getElementById(&#39;Fullscreen&#39;).show()&quot;&gt;Fullscreen&lt;/sonic-button&gt;
93
+ &lt;sonic-modal fullscreen id=&quot;Fullscreen&quot;&gt;
94
+ &lt;sonic-image
95
+ cover
96
+ src=&quot;img/concorde/plane_10.jpg&quot;
97
+ alt=&quot;Concorde fleet parked in a star&quot;
98
+ &gt;&lt;/sonic-image&gt;
99
+ &lt;/sonic-modal&gt;
100
+ </code></pre>
101
+ <h2 id="programmatic-creation">Programmatic creation</h2>
102
+ <p><strong><code>Modal.create(options)</code></strong> (also <code>window.SonicModal.create</code>) appends a modal to the theme pop container, opens it and returns the element. <strong><code>title</code></strong> · <strong><code>subtitle</code></strong> · <strong><code>content</code></strong> · <strong><code>actions</code></strong> accept HTML strings or Lit templates. Set <strong><code>removeOnHide: true</code></strong> to remove it from the DOM after closing.</p>
103
+ <pre><code>&lt;sonic-button
104
+ onclick=&quot;window.SonicModal.create({
105
+ title: &#39;Announce gate change?&#39;,
106
+ subtitle: &#39;Passengers are notified immediately.&#39;,
107
+ content: &#39;Flight CN 001 now departs from gate B12.&#39;,
108
+ actions: &#39;&amp;lt;sonic-button hideModal minWidth=\&#39;8rem\&#39;&amp;gt;Cancel&amp;lt;/sonic-button&amp;gt;&amp;lt;sonic-button hideModal minWidth=\&#39;8rem\&#39; type=\&#39;success\&#39;&amp;gt;Send&amp;lt;/sonic-button&amp;gt;&#39;,
109
+ removeOnHide: true
110
+ })&quot;
111
+ &gt;
112
+ Open programmatic modal
113
+ &lt;/sonic-button&gt;
114
+ </code></pre>
115
+ <pre><code class="language-typescript">import { Modal } from &quot;@supersoniks/concorde/ui/modal&quot;;
116
+
117
+ const modal = Modal.create({
118
+ title: &quot;Remove flight CN 001?&quot;,
119
+ content: &quot;It will no longer appear on the departures board.&quot;,
120
+ actions: `
121
+ &amp;lt;sonic-button hideModal&amp;gt;Cancel&amp;lt;/sonic-button&amp;gt;
122
+ &amp;lt;sonic-button hideModal type=&quot;danger&quot;&amp;gt;Remove&amp;lt;/sonic-button&amp;gt;
123
+ `,
124
+ removeOnHide: true,
125
+ maxWidth: &quot;min(100vw, 28rem)&quot;,
126
+ });
127
+
128
+ modal.addEventListener(&quot;hidden&quot;, () =&gt; console.log(&quot;closed&quot;));
129
+ </code></pre>
130
+ <h2 id="api-reference">API reference</h2>
131
+ <h3 id="sonic-modal"><code>sonic-modal</code></h3>
132
+ <table>
133
+ <thead>
134
+ <tr>
135
+ <th>Attribute</th>
136
+ <th>Values</th>
137
+ <th>Description</th>
138
+ </tr>
139
+ </thead>
140
+ <tbody><tr>
141
+ <td><code>align</code></td>
142
+ <td><code>left</code> (default) · <code>center</code> · <code>right</code></td>
143
+ <td>Content alignment</td>
144
+ </tr>
145
+ <tr>
146
+ <td><code>width</code></td>
147
+ <td>CSS length (default <code>100%</code>)</td>
148
+ <td>Dialog width</td>
149
+ </tr>
150
+ <tr>
151
+ <td><code>height</code></td>
152
+ <td>CSS length (default <code>fit-content</code>)</td>
153
+ <td>Dialog height</td>
154
+ </tr>
155
+ <tr>
156
+ <td><code>maxWidth</code></td>
157
+ <td>CSS length (default <code>min(100vw, 40rem)</code>)</td>
158
+ <td>Dialog max width</td>
159
+ </tr>
160
+ <tr>
161
+ <td><code>maxHeight</code></td>
162
+ <td>CSS length (default <code>90vh</code>)</td>
163
+ <td>Dialog max height; content scrolls beyond</td>
164
+ </tr>
165
+ <tr>
166
+ <td><code>paddingX</code> · <code>paddingY</code></td>
167
+ <td>CSS length (default <code>1.5rem</code> · <code>2.5rem</code>)</td>
168
+ <td>Content padding</td>
169
+ </tr>
170
+ <tr>
171
+ <td><code>zIndex</code></td>
172
+ <td>number (default <code>990</code>)</td>
173
+ <td>Stacking order</td>
174
+ </tr>
175
+ <tr>
176
+ <td><code>effect</code></td>
177
+ <td><code>slide</code> (default) · <code>fade</code> · <code>none</code></td>
178
+ <td>Open / close animation</td>
179
+ </tr>
180
+ <tr>
181
+ <td><code>fullscreen</code></td>
182
+ <td>boolean</td>
183
+ <td>Fill the viewport, no backdrop</td>
184
+ </tr>
185
+ <tr>
186
+ <td><code>rounded</code></td>
187
+ <td><code>none</code></td>
188
+ <td>Remove the corner radius</td>
189
+ </tr>
190
+ <tr>
191
+ <td><code>forceAction</code></td>
192
+ <td>boolean</td>
193
+ <td>Disable backdrop click, Escape and close button</td>
194
+ </tr>
195
+ <tr>
196
+ <td><code>noCloseButton</code></td>
197
+ <td>boolean</td>
198
+ <td>Hide the close button only</td>
199
+ </tr>
200
+ <tr>
201
+ <td><code>closeButtonType</code></td>
202
+ <td><code>sonic-button</code> type</td>
203
+ <td>Color of the close button</td>
204
+ </tr>
205
+ <tr>
206
+ <td><code>visible</code></td>
207
+ <td>boolean</td>
208
+ <td>Opens or closes the modal when toggled</td>
209
+ </tr>
210
+ <tr>
211
+ <td><code>removeOnHide</code></td>
212
+ <td>boolean</td>
213
+ <td>Remove the element after closing</td>
214
+ </tr>
215
+ <tr>
216
+ <td><code>removeHashOnHide</code></td>
217
+ <td>boolean</td>
218
+ <td>Clear the URL hash after closing</td>
219
+ </tr>
220
+ <tr>
221
+ <td><code>closeOnLocationChange</code></td>
222
+ <td>boolean</td>
223
+ <td>Close when the location changes</td>
224
+ </tr>
225
+ <tr>
226
+ <td><code>resetDataProviderOnHide</code></td>
227
+ <td>publisher id</td>
228
+ <td>Reset this data provider to <code>{}</code> after closing</td>
229
+ </tr>
230
+ </tbody></table>
231
+ <p>JavaScript-only properties: <code>options</code> (same keys as <code>Modal.create</code>) and <code>styleSheet</code> (<code>CSSResult</code> or <code>CSSStyleSheet</code>, or an array, adopted in the shadow root).</p>
232
+ <table>
233
+ <thead>
234
+ <tr>
235
+ <th>Slot</th>
236
+ <th>Description</th>
237
+ </tr>
238
+ </thead>
239
+ <tbody><tr>
240
+ <td><em>(default)</em></td>
241
+ <td>Modal content, usually the <code>sonic-modal-*</code> children</td>
242
+ </tr>
243
+ </tbody></table>
244
+ <table>
245
+ <thead>
246
+ <tr>
247
+ <th>Method</th>
248
+ <th>Description</th>
249
+ </tr>
250
+ </thead>
251
+ <tbody><tr>
252
+ <td><code>show()</code></td>
253
+ <td>Open the modal</td>
254
+ </tr>
255
+ <tr>
256
+ <td><code>hide()</code></td>
257
+ <td>Close the modal (returns a promise)</td>
258
+ </tr>
259
+ <tr>
260
+ <td><code>dispose()</code></td>
261
+ <td>Close and remove the modal</td>
262
+ </tr>
263
+ <tr>
264
+ <td><code>Modal.create(options)</code></td>
265
+ <td>Static: create, append and open a modal</td>
266
+ </tr>
267
+ <tr>
268
+ <td><code>Modal.disposeAll()</code></td>
269
+ <td>Static: close and remove every modal</td>
270
+ </tr>
271
+ </tbody></table>
272
+ <table>
273
+ <thead>
274
+ <tr>
275
+ <th>Event</th>
276
+ <th>Description</th>
277
+ </tr>
278
+ </thead>
279
+ <tbody><tr>
280
+ <td><code>show</code></td>
281
+ <td>Open animation finished</td>
282
+ </tr>
283
+ <tr>
284
+ <td><code>hide</code></td>
285
+ <td>Close started</td>
286
+ </tr>
287
+ <tr>
288
+ <td><code>hidden</code></td>
289
+ <td>Close finished</td>
290
+ </tr>
291
+ </tbody></table>
292
+ <h3 id="sonic-modal-title--sonic-modal-subtitle--sonic-modal-content--sonic-modal-actions"><code>sonic-modal-title</code> · <code>sonic-modal-subtitle</code> · <code>sonic-modal-content</code> · <code>sonic-modal-actions</code></h3>
293
+ <p>No attributes. Default slot only. In <code>sonic-modal-actions</code>, child <code>sonic-button</code> elements with <code>hideModal</code> close the modal.</p>
294
+ <h3 id="sonic-modal-close"><code>sonic-modal-close</code></h3>
295
+ <p>Rendered automatically unless <code>forceAction</code> or <code>noCloseButton</code> is set. Place it manually to add a close button elsewhere.</p>
296
+ <table>
297
+ <thead>
298
+ <tr>
299
+ <th>Attribute</th>
300
+ <th>Values</th>
301
+ <th>Description</th>
302
+ </tr>
303
+ </thead>
304
+ <tbody><tr>
305
+ <td><code>type</code></td>
306
+ <td><code>sonic-button</code> type</td>
307
+ <td>Button color</td>
308
+ </tr>
309
+ <tr>
310
+ <td><code>reset</code></td>
311
+ <td>publisher id</td>
312
+ <td>Passed to the inner <code>sonic-button</code> <code>reset</code></td>
313
+ </tr>
314
+ <tr>
315
+ <td><code>translation</code></td>
316
+ <td>label object</td>
317
+ <td>Overrides the default <code>aria-label</code></td>
318
+ </tr>
319
+ </tbody></table>
320
+
321
+ </article>
322
+ </main>
323
+ </body>
324
+ </html>
package/docs/core/components/ui/modal/modal.md ADDED
@@ -0,0 +1,211 @@
1
+ # Modal
2
+
3
+ **`sonic-modal`** shows focused content in a dialog with a backdrop, an enter / exit animation and a built-in close button. Compose it with **`sonic-modal-title`** · **`sonic-modal-subtitle`** · **`sonic-modal-content`** · **`sonic-modal-actions`**, open it with **`show()`** and close it with **`hide()`** or a **`hideModal`** button.
4
+
5
+ ## Basic example
6
+
7
+ Backdrop click, Escape and the close button all close the modal. In **`sonic-modal-actions`**, a **`sonic-button`** with **`hideModal`** closes it on click.
8
+
9
+ <sonic-code>
10
+ <template>
11
+ <sonic-button onclick="document.getElementById('modalExample').show()">
12
+ Open modal
13
+ </sonic-button>
14
+ <sonic-modal id="modalExample">
15
+ <sonic-modal-title>
16
+ Boarding pass ready
17
+ <sonic-badge type="success" size="sm">New</sonic-badge>
18
+ </sonic-modal-title>
19
+ <sonic-modal-subtitle>Your check-in is complete.</sonic-modal-subtitle>
20
+ <sonic-modal-content>
21
+ Download your boarding pass now or review your seat before departure.
22
+ </sonic-modal-content>
23
+ <sonic-modal-actions>
24
+ <sonic-button minWidth="8rem" hideModal>Later</sonic-button>
25
+ <sonic-button minWidth="8rem" type="success" hideModal>Download</sonic-button>
26
+ </sonic-modal-actions>
27
+ </sonic-modal>
28
+ </template>
29
+ </sonic-code>
30
+
31
+ **`hideModal`** only works on **`sonic-button`** elements that are direct children of **`sonic-modal-actions`**.
32
+
33
+ ## Scrollable content
34
+
35
+ Long content scrolls inside the dialog once it reaches **`maxHeight`** (default `90vh`). Content is left-aligned by default; set **`align`** to `center` or `right`.
36
+
37
+ <sonic-code>
38
+ <template>
39
+ <sonic-button onclick="document.getElementById('modalText').show()">Baggage details</sonic-button>
40
+ <sonic-modal id="modalText" maxHeight="20rem">
41
+ <sonic-modal-title>Baggage allowance</sonic-modal-title>
42
+ <sonic-modal-content>
43
+ <div class="prose">
44
+ <p><strong>Cabin bag</strong><br />One cabin bag and one personal item are included in every cabin class.</p>
45
+ <p><strong>Checked baggage</strong><br />Drop checked bags at the counter at least one hour before departure.</p>
46
+ <p><strong>Extra baggage</strong><br />Add extra baggage online up to 24 hours before the flight.</p>
47
+ <p><strong>Contact</strong><br />support@example.com</p>
48
+ </div>
49
+ </sonic-modal-content>
50
+ </sonic-modal>
51
+ </template>
52
+ </sonic-code>
53
+
54
+ ## Force action
55
+
56
+ With **`forceAction`**, backdrop click, Escape and the close button are disabled. Provide **`hideModal`** buttons so users can finish the flow. **`noCloseButton`** only hides the close button.
57
+
58
+ <sonic-code>
59
+ <template>
60
+ <sonic-button onclick="document.getElementById('force').show()">Cookie consent</sonic-button>
61
+ <sonic-modal forceAction id="force">
62
+ <sonic-modal-title>Allow analytics cookies?</sonic-modal-title>
63
+ <sonic-modal-content>
64
+ Analytics cookies measure traffic. You can change this later in settings.
65
+ </sonic-modal-content>
66
+ <sonic-modal-actions>
67
+ <sonic-button hideModal minWidth="8rem">Decline</sonic-button>
68
+ <sonic-button hideModal minWidth="8rem" type="success">Accept</sonic-button>
69
+ </sonic-modal-actions>
70
+ </sonic-modal>
71
+ </template>
72
+ </sonic-code>
73
+
74
+ ## Dimensions
75
+
76
+ Set **`width`** · **`height`** · **`maxWidth`** · **`maxHeight`** with CSS lengths. Below 768px the panel becomes a bottom sheet. **`rounded="none"`** removes the corner radius for edge-to-edge media.
77
+
78
+ <sonic-code>
79
+ <template>
80
+ <sonic-button onclick="document.getElementById('CustomWidth').show()">Image preview</sonic-button>
81
+ <sonic-modal
82
+ rounded="none"
83
+ maxHeight="50vh"
84
+ maxWidth="90vw"
85
+ width="100%"
86
+ height="100%"
87
+ id="CustomWidth"
88
+ >
89
+ <sonic-image
90
+ cover
91
+ src="img/concorde/plane_12.jpg"
92
+ alt="Concorde at the gate with boarding stairs"
93
+ ></sonic-image>
94
+ </sonic-modal>
95
+ </template>
96
+ </sonic-code>
97
+
98
+ ## Fullscreen
99
+
100
+ **`fullscreen`** fills the viewport and hides the backdrop.
101
+
102
+ <sonic-code>
103
+ <template>
104
+ <sonic-button onclick="document.getElementById('Fullscreen').show()">Fullscreen</sonic-button>
105
+ <sonic-modal fullscreen id="Fullscreen">
106
+ <sonic-image
107
+ cover
108
+ src="img/concorde/plane_10.jpg"
109
+ alt="Concorde fleet parked in a star"
110
+ ></sonic-image>
111
+ </sonic-modal>
112
+ </template>
113
+ </sonic-code>
114
+
115
+ ## Programmatic creation
116
+
117
+ **`Modal.create(options)`** (also `window.SonicModal.create`) appends a modal to the theme pop container, opens it and returns the element. **`title`** · **`subtitle`** · **`content`** · **`actions`** accept HTML strings or Lit templates. Set **`removeOnHide: true`** to remove it from the DOM after closing.
118
+
119
+ <sonic-code>
120
+ <template>
121
+ <sonic-button
122
+ onclick="window.SonicModal.create({
123
+ title: 'Announce gate change?',
124
+ subtitle: 'Passengers are notified immediately.',
125
+ content: 'Flight CN 001 now departs from gate B12.',
126
+ actions: '&lt;sonic-button hideModal minWidth=\'8rem\'&gt;Cancel&lt;/sonic-button&gt;&lt;sonic-button hideModal minWidth=\'8rem\' type=\'success\'&gt;Send&lt;/sonic-button&gt;',
127
+ removeOnHide: true
128
+ })"
129
+ >
130
+ Open programmatic modal
131
+ </sonic-button>
132
+ </template>
133
+ </sonic-code>
134
+
135
+ <sonic-code language="typescript">
136
+ <template>
137
+ import { Modal } from "@supersoniks/concorde/ui/modal";
138
+
139
+ const modal = Modal.create({
140
+ title: "Remove flight CN 001?",
141
+ content: "It will no longer appear on the departures board.",
142
+ actions: `
143
+ &lt;sonic-button hideModal&gt;Cancel&lt;/sonic-button&gt;
144
+ &lt;sonic-button hideModal type="danger"&gt;Remove&lt;/sonic-button&gt;
145
+ `,
146
+ removeOnHide: true,
147
+ maxWidth: "min(100vw, 28rem)",
148
+ });
149
+
150
+ modal.addEventListener("hidden", () => console.log("closed"));
151
+ </template>
152
+ </sonic-code>
153
+
154
+ ## API reference
155
+
156
+ ### `sonic-modal`
157
+
158
+ | Attribute | Values | Description |
159
+ |----------|---------|-------------|
160
+ | `align` | `left` (default) · `center` · `right` | Content alignment |
161
+ | `width` | CSS length (default `100%`) | Dialog width |
162
+ | `height` | CSS length (default `fit-content`) | Dialog height |
163
+ | `maxWidth` | CSS length (default `min(100vw, 40rem)`) | Dialog max width |
164
+ | `maxHeight` | CSS length (default `90vh`) | Dialog max height; content scrolls beyond |
165
+ | `paddingX` · `paddingY` | CSS length (default `1.5rem` · `2.5rem`) | Content padding |
166
+ | `zIndex` | number (default `990`) | Stacking order |
167
+ | `effect` | `slide` (default) · `fade` · `none` | Open / close animation |
168
+ | `fullscreen` | boolean | Fill the viewport, no backdrop |
169
+ | `rounded` | `none` | Remove the corner radius |
170
+ | `forceAction` | boolean | Disable backdrop click, Escape and close button |
171
+ | `noCloseButton` | boolean | Hide the close button only |
172
+ | `closeButtonType` | `sonic-button` type | Color of the close button |
173
+ | `visible` | boolean | Opens or closes the modal when toggled |
174
+ | `removeOnHide` | boolean | Remove the element after closing |
175
+ | `removeHashOnHide` | boolean | Clear the URL hash after closing |
176
+ | `closeOnLocationChange` | boolean | Close when the location changes |
177
+ | `resetDataProviderOnHide` | publisher id | Reset this data provider to `{}` after closing |
178
+
179
+ JavaScript-only properties: `options` (same keys as `Modal.create`) and `styleSheet` (`CSSResult` or `CSSStyleSheet`, or an array, adopted in the shadow root).
180
+
181
+ | Slot | Description |
182
+ |------|-------------|
183
+ | *(default)* | Modal content, usually the `sonic-modal-*` children |
184
+
185
+ | Method | Description |
186
+ |--------|-------------|
187
+ | `show()` | Open the modal |
188
+ | `hide()` | Close the modal (returns a promise) |
189
+ | `dispose()` | Close and remove the modal |
190
+ | `Modal.create(options)` | Static: create, append and open a modal |
191
+ | `Modal.disposeAll()` | Static: close and remove every modal |
192
+
193
+ | Event | Description |
194
+ |-------|-------------|
195
+ | `show` | Open animation finished |
196
+ | `hide` | Close started |
197
+ | `hidden` | Close finished |
198
+
199
+ ### `sonic-modal-title` · `sonic-modal-subtitle` · `sonic-modal-content` · `sonic-modal-actions`
200
+
201
+ No attributes. Default slot only. In `sonic-modal-actions`, child `sonic-button` elements with `hideModal` close the modal.
202
+
203
+ ### `sonic-modal-close`
204
+
205
+ Rendered automatically unless `forceAction` or `noCloseButton` is set. Place it manually to add a close button elsewhere.
206
+
207
+ | Attribute | Values | Description |
208
+ |----------|---------|-------------|
209
+ | `type` | `sonic-button` type | Button color |
210
+ | `reset` | publisher id | Passed to the inner `sonic-button` `reset` |
211
+ | `translation` | label object | Overrides the default `aria-label` |