@supersoniks/concorde 5.1.1 → 5.1.3

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