@supersoniks/concorde 5.1.2 → 5.1.3-immutable.1

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 (497) hide show
  1. package/.agents/skills/concorde-docs/SKILL.md +1 -1
  2. package/.claude/skills +1 -0
  3. package/.github/workflows/ci.yml +21 -0
  4. package/.github-export-ignore +30 -0
  5. package/CONTRIBUTING.md +59 -0
  6. package/DEV.md +54 -0
  7. package/LICENSE +21 -0
  8. package/OPEN_SOURCE_CHECKPOINT.md +133 -0
  9. package/README.md +1 -1
  10. package/ai/README.md +29 -41
  11. package/ai/skills/concorde/SKILL.md +54 -324
  12. package/ai/skills/concorde/rules/composition.md +32 -0
  13. package/ai/skills/concorde/rules/data.md +47 -0
  14. package/ai/skills/concorde/rules/http.md +25 -0
  15. package/ai/skills/concorde/rules/lists-forms.md +35 -0
  16. package/ai/skills/concorde/rules/styling.md +46 -0
  17. package/ai/skills/concorde/rules/troubleshooting.md +45 -0
  18. package/build-infos.json +1 -1
  19. package/concorde-core.bundle.js +177 -177
  20. package/concorde-core.es.js +4993 -4833
  21. package/custom-elements-manifest.public.config.mjs +8 -0
  22. package/{.tmp-cem/custom-elements.json → custom-elements.json} +11722 -8868
  23. package/dist/concorde-core.bundle.js +177 -177
  24. package/dist/concorde-core.es.js +4993 -4833
  25. package/dist/docs-mock-api-sw.js +58 -223
  26. package/dist/docs-mock-api-sw.js.map +4 -4
  27. package/dist/img/og-concorde.jpg +0 -0
  28. package/dist/robots.txt +11 -10
  29. package/docs/assets/index-CD4WyL6o.css +1 -0
  30. package/docs/assets/index-D_alEsng.js +12122 -0
  31. package/docs/crawl/core/components/functional/date/date.html +190 -0
  32. package/docs/crawl/core/components/functional/fetch/fetch.html +109 -0
  33. package/docs/crawl/core/components/functional/if/if.html +27 -0
  34. package/docs/crawl/core/components/functional/jsonata/jsonata.html +79 -0
  35. package/docs/crawl/core/components/functional/list/list.html +70 -0
  36. package/docs/crawl/core/components/functional/mix/mix.html +45 -0
  37. package/docs/crawl/core/components/functional/queue/queue.html +96 -0
  38. package/docs/crawl/core/components/functional/router/router.html +106 -0
  39. package/docs/{core → crawl/core}/components/functional/sdui/sdui-extension-points.html +8 -9
  40. package/docs/crawl/core/components/functional/sdui/sdui.html +368 -0
  41. package/docs/crawl/core/components/functional/states/states.html +66 -0
  42. package/docs/crawl/core/components/functional/submit/submit.html +160 -0
  43. package/docs/{core → crawl/core}/components/functional/subscriber/subscriber.html +5 -6
  44. package/docs/crawl/core/components/functional/value/value.html +51 -0
  45. package/docs/{core → crawl/core}/components/ui/alert/alert.html +63 -53
  46. package/docs/{core → crawl/core}/components/ui/alert-messages/alert-messages.html +5 -6
  47. package/docs/{core → crawl/core}/components/ui/badge/badge.html +33 -33
  48. package/docs/crawl/core/components/ui/button/button.html +150 -0
  49. package/docs/crawl/core/components/ui/captcha/captcha.html +112 -0
  50. package/docs/{core → crawl/core}/components/ui/card/card.html +11 -12
  51. package/docs/{core → crawl/core}/components/ui/divider/divider.html +14 -14
  52. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +73 -0
  53. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +266 -0
  54. package/docs/{core → crawl/core}/components/ui/form/form-actions/form-actions.html +23 -23
  55. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +121 -0
  56. package/docs/crawl/core/components/ui/form/input/input.html +109 -0
  57. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +38 -0
  58. package/docs/crawl/core/components/ui/form/radio/radio.html +56 -0
  59. package/docs/crawl/core/components/ui/form/select/select.html +73 -0
  60. package/docs/crawl/core/components/ui/form/switch/switch.html +56 -0
  61. package/docs/crawl/core/components/ui/form/textarea/textarea.html +59 -0
  62. package/docs/crawl/core/components/ui/group/group.html +104 -0
  63. package/docs/{core → crawl/core}/components/ui/icon/icon.html +9 -10
  64. package/docs/crawl/core/components/ui/image/image.html +298 -0
  65. package/docs/{core → crawl/core}/components/ui/link/link.html +11 -12
  66. package/docs/crawl/core/components/ui/loader/loader.html +124 -0
  67. package/docs/{core → crawl/core}/components/ui/menu/menu.html +33 -34
  68. package/docs/crawl/core/components/ui/modal/modal.html +342 -0
  69. package/docs/crawl/core/components/ui/pop/pop.html +296 -0
  70. package/docs/{core → crawl/core}/components/ui/progress/progress.html +7 -8
  71. package/docs/crawl/core/components/ui/table/table.html +545 -0
  72. package/docs/crawl/core/components/ui/theme/theme.html +131 -0
  73. package/docs/crawl/core/components/ui/toast/toast.html +233 -0
  74. package/docs/crawl/core/components/ui/tooltip/tooltip.html +140 -0
  75. package/docs/{docs/getting-started → crawl/docs/_core-concept}/dataFlow.html +29 -26
  76. package/docs/crawl/docs/_core-concept/overview.html +66 -0
  77. package/docs/crawl/docs/_core-concept/subscriber.html +75 -0
  78. package/docs/crawl/docs/_decorators/ancestor-attribute.html +117 -0
  79. package/docs/crawl/docs/_decorators/auto-subscribe.html +202 -0
  80. package/docs/crawl/docs/_decorators/bind.html +141 -0
  81. package/docs/crawl/docs/_decorators/get.html +149 -0
  82. package/docs/crawl/docs/_decorators/handle.html +165 -0
  83. package/docs/crawl/docs/_decorators/on-assign.html +355 -0
  84. package/docs/crawl/docs/_decorators/patch.html +78 -0
  85. package/docs/crawl/docs/_decorators/post.html +139 -0
  86. package/docs/crawl/docs/_decorators/publish.html +61 -0
  87. package/docs/crawl/docs/_decorators/put.html +78 -0
  88. package/docs/crawl/docs/_decorators/subscribe.html +109 -0
  89. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +137 -0
  90. package/docs/crawl/docs/_directives/sub.html +93 -0
  91. package/docs/{docs/getting-started → crawl/docs/_getting-started}/ai-agents.html +11 -12
  92. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +100 -0
  93. package/docs/crawl/docs/_getting-started/concorde-outside.html +58 -0
  94. package/docs/{docs/getting-started → crawl/docs/_getting-started}/create-a-component.html +14 -11
  95. package/docs/{docs/getting-started → crawl/docs/_getting-started}/my-first-component.html +22 -13
  96. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +110 -0
  97. package/docs/crawl/docs/_getting-started/pubsub.html +62 -0
  98. package/docs/crawl/docs/_getting-started/start.html +76 -0
  99. package/docs/{docs/getting-started → crawl/docs/_getting-started}/theming.html +9 -10
  100. package/docs/{docs/misc → crawl/docs/_misc}/api-configuration.html +18 -18
  101. package/docs/{docs/misc → crawl/docs/_misc}/dataProviderKey.html +11 -12
  102. package/docs/{docs/misc → crawl/docs/_misc}/docs-mock-api.html +28 -25
  103. package/docs/{docs/misc → crawl/docs/_misc}/dynamic-path.html +15 -16
  104. package/docs/{docs/misc → crawl/docs/_misc}/endpoint.html +15 -16
  105. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +138 -0
  106. package/docs/{docs/misc → crawl/docs/_misc}/html-integration.html +15 -12
  107. package/docs/crawl/hubs/decorators.html +547 -0
  108. package/docs/crawl/hubs/form-components.html +381 -0
  109. package/docs/crawl/hubs/remote-data.html +452 -0
  110. package/docs/crawl/index.html +103 -0
  111. package/docs/docs-mock-api-sw.js +223 -58
  112. package/docs/docs-mock-api-sw.js.map +4 -4
  113. package/docs/index.html +68 -95
  114. package/docs/llms-full.txt +3610 -2231
  115. package/docs/llms.txt +86 -94
  116. package/docs/robots.txt +10 -11
  117. package/docs/sitemap.xml +84 -78
  118. package/docs/src/core/components/functional/date/date.md +231 -91
  119. package/docs/src/core/components/functional/fetch/fetch.md +83 -66
  120. package/docs/src/core/components/functional/if/if.md +3 -28
  121. package/docs/src/core/components/functional/jsonata/jsonata.md +37 -42
  122. package/docs/src/core/components/functional/list/list.md +43 -99
  123. package/docs/src/core/components/functional/mix/mix.md +26 -31
  124. package/docs/src/core/components/functional/queue/queue.md +61 -40
  125. package/docs/src/core/components/functional/router/router.md +65 -64
  126. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  127. package/docs/src/core/components/functional/sdui/component-catalog.json +1 -1
  128. package/docs/src/core/components/functional/sdui/example.json +86 -19
  129. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  130. package/docs/src/core/components/functional/sdui/sdui.md +358 -187
  131. package/docs/src/core/components/functional/states/states.md +61 -86
  132. package/docs/src/core/components/functional/submit/submit.md +72 -64
  133. package/docs/src/core/components/functional/value/value.md +22 -34
  134. package/docs/src/core/components/ui/alert/alert.md +58 -48
  135. package/docs/src/core/components/ui/badge/badge.md +34 -27
  136. package/docs/src/core/components/ui/button/button.md +106 -139
  137. package/docs/src/core/components/ui/captcha/captcha.md +32 -17
  138. package/docs/src/core/components/ui/card/card.md +6 -6
  139. package/docs/src/core/components/ui/divider/divider.md +11 -8
  140. package/docs/src/core/components/ui/form/checkbox/checkbox.md +42 -90
  141. package/docs/src/core/components/ui/form/fieldset/fieldset.md +75 -31
  142. package/docs/src/core/components/ui/form/form-actions/form-actions.md +16 -14
  143. package/docs/src/core/components/ui/form/form-layout/form-layout.md +29 -19
  144. package/docs/src/core/components/ui/form/input/input.md +95 -95
  145. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +29 -0
  146. package/docs/src/core/components/ui/form/radio/radio.md +34 -55
  147. package/docs/src/core/components/ui/form/select/select.md +45 -60
  148. package/docs/src/core/components/ui/form/switch/switch.md +34 -57
  149. package/docs/src/core/components/ui/form/textarea/textarea.md +38 -55
  150. package/docs/src/core/components/ui/group/group.md +33 -35
  151. package/docs/src/core/components/ui/icon/icon.md +4 -4
  152. package/docs/src/core/components/ui/image/image.md +107 -41
  153. package/docs/src/core/components/ui/link/link.md +6 -6
  154. package/docs/src/core/components/ui/loader/loader.md +55 -30
  155. package/docs/src/core/components/ui/menu/menu.md +27 -27
  156. package/docs/src/core/components/ui/modal/modal.md +96 -72
  157. package/docs/src/core/components/ui/pop/pop.md +158 -80
  158. package/docs/src/core/components/ui/progress/progress.md +2 -2
  159. package/docs/src/core/components/ui/table/table.md +255 -91
  160. package/docs/src/core/components/ui/theme/theme.md +36 -11
  161. package/docs/src/core/components/ui/toast/toast.md +117 -48
  162. package/docs/src/core/components/ui/tooltip/tooltip.md +62 -27
  163. package/docs/{docs/getting-started → src/docs/_core-concept}/dataFlow.md +18 -17
  164. package/docs/src/docs/_core-concept/overview.md +57 -0
  165. package/docs/src/docs/_core-concept/subscriber.md +75 -0
  166. package/docs/src/docs/_decorators/ancestor-attribute.md +128 -0
  167. package/docs/src/docs/_decorators/auto-subscribe.md +202 -0
  168. package/docs/src/docs/_decorators/bind.md +167 -0
  169. package/docs/src/docs/_decorators/get.md +162 -0
  170. package/docs/src/docs/_decorators/handle.md +175 -0
  171. package/docs/src/docs/_decorators/on-assign.md +390 -0
  172. package/docs/src/docs/_decorators/patch.md +70 -0
  173. package/docs/src/docs/_decorators/post.md +146 -0
  174. package/docs/src/docs/_decorators/publish.md +55 -0
  175. package/docs/src/docs/_decorators/put.md +70 -0
  176. package/docs/src/docs/_decorators/subscribe.md +100 -0
  177. package/docs/src/docs/_decorators/wait-for-ancestors.md +163 -0
  178. package/docs/src/docs/_directives/sub.md +91 -0
  179. package/docs/src/docs/{getting-started → _getting-started}/ai-agents.md +3 -3
  180. package/docs/src/docs/_getting-started/concorde-manual-install.md +133 -0
  181. package/docs/src/docs/_getting-started/concorde-outside.md +33 -0
  182. package/docs/{docs/getting-started → src/docs/_getting-started}/create-a-component.md +6 -3
  183. package/docs/src/docs/{getting-started → _getting-started}/my-first-component.md +14 -5
  184. package/docs/src/docs/_getting-started/my-first-subscriber.md +120 -0
  185. package/docs/src/docs/_getting-started/pubsub.md +37 -0
  186. package/docs/src/docs/{getting-started → _getting-started}/start.md +13 -1
  187. package/docs/src/docs/{getting-started → _getting-started}/theming.md +2 -2
  188. package/docs/src/docs/{misc → _misc}/api-configuration.md +12 -10
  189. package/docs/src/docs/{misc → _misc}/dataProviderKey.md +4 -4
  190. package/docs/{docs/misc → src/docs/_misc}/docs-mock-api.md +13 -12
  191. package/docs/{docs/misc → src/docs/_misc}/dynamic-path.md +8 -8
  192. package/docs/{docs/misc → src/docs/_misc}/endpoint.md +8 -8
  193. package/docs/src/docs/_misc/formelement-subscriber-removal.md +115 -0
  194. package/docs/{docs/misc → src/docs/_misc}/html-integration.md +5 -4
  195. package/docs/src/docs/search/docs-search.json +4375 -2420
  196. package/docs/src/tsconfig.declarations.json +22 -0
  197. package/docs/src/tsconfig.emit.json +23 -0
  198. package/docs/src/tsconfig.json +2 -23
  199. package/gitlab/job_github_mirror.sh +39 -0
  200. package/index.html +89 -0
  201. package/package.json +22 -4
  202. package/public/img/og-concorde.jpg +0 -0
  203. package/scripts/ai-init.mjs +104 -379
  204. package/scripts/ai-init.test.mjs +81 -239
  205. package/scripts/docs-markdown-vite-plugin.ts +11 -5
  206. package/scripts/docs-public-url.mjs +6 -0
  207. package/scripts/docs.htaccess +7 -0
  208. package/scripts/generate-cem.mjs +244 -0
  209. package/scripts/generate-cem.test.mjs +122 -0
  210. package/scripts/generate-crawl-docs.mjs +29 -5
  211. package/scripts/generate-sdui-catalog.mjs +11 -10
  212. package/scripts/github-export.mjs +150 -0
  213. package/scripts/post-build-docs.js +3 -0
  214. package/scripts/post-build.mjs +0 -0
  215. package/scripts/pre-publish.mjs +2 -1
  216. package/scripts/site-pages.mjs +212 -0
  217. package/scripts/site-pages.test.mjs +116 -0
  218. package/site-pages/about.md +22 -0
  219. package/site-pages/privacy.md +32 -0
  220. package/src/core/components/functional/date/date.md +1 -1
  221. package/src/core/components/functional/example/example.ts +3 -1
  222. package/src/core/components/functional/if/if.ts +0 -0
  223. package/src/core/components/functional/list/list.demo.ts +0 -0
  224. package/src/core/components/functional/list/list.md +6 -2
  225. package/src/core/components/functional/list/list.ts +17 -4
  226. package/src/core/components/functional/mix/mix.md +0 -0
  227. package/src/core/components/functional/router/router.demo.ts +0 -0
  228. package/src/core/components/functional/router/router.ts +0 -0
  229. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  230. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  231. package/src/core/components/functional/sdui/component-catalog.json +2 -2
  232. package/src/core/components/functional/sdui/example.json +0 -0
  233. package/src/core/components/functional/sdui/sdui-immutable.spec.ts +74 -0
  234. package/src/core/components/functional/sdui/sdui.ts +33 -8
  235. package/src/core/components/functional/sdui/types.ts +0 -0
  236. package/src/core/components/functional/states/states.ts +0 -0
  237. package/src/core/components/functional/submit/submit.spec.ts +60 -0
  238. package/src/core/components/functional/submit/submit.ts +6 -3
  239. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  240. package/src/core/components/functional/value/value.md +0 -0
  241. package/src/core/components/functional/value/value.ts +0 -0
  242. package/src/core/components/ui/_css/size.ts +0 -0
  243. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  244. package/src/core/components/ui/card/card.md +1 -1
  245. package/src/core/components/ui/form/input/input.md +19 -1
  246. package/src/core/components/ui/form/input/input.ts +8 -2
  247. package/src/core/components/ui/form/radio/radio.md +14 -0
  248. package/src/core/components/ui/image/image.md +17 -17
  249. package/src/core/components/ui/modal/modal.md +2 -2
  250. package/src/core/decorators/subscriber/bind.ts +9 -14
  251. package/src/core/decorators/subscriber/subscribe.ts +15 -9
  252. package/src/core/decorators/subscriber/subscribe.type-test.ts +14 -5
  253. package/src/core/mixins/Subscriber.ts +0 -0
  254. package/src/core/utils/DataBindObserver.ts +0 -0
  255. package/src/core/utils/Objects.ts +0 -0
  256. package/src/core/utils/PublisherProxy.ts +166 -125
  257. package/src/core/utils/deepReadonly.spec.ts +66 -0
  258. package/src/core/utils/deepReadonly.ts +71 -0
  259. package/src/core/utils/immutableValue.spec.ts +54 -0
  260. package/src/core/utils/immutableValue.ts +102 -0
  261. package/src/core/utils/nestedDotForm.spec.ts +88 -0
  262. package/src/core/utils/publisherImmutable.spec.ts +76 -0
  263. package/src/core/utils/route.ts +0 -0
  264. package/src/core/utils/strictGet.spec.ts +61 -0
  265. package/src/core/utils/strictGet.ts +102 -0
  266. package/src/css.d.ts +19 -0
  267. package/src/docs/components/docs-demo-sources.ts +3 -3
  268. package/src/docs/decorators/bind.md +23 -24
  269. package/src/docs/docs-location.spec.ts +10 -0
  270. package/src/docs/docs-location.ts +10 -0
  271. package/src/docs/example/decorators-demo-bind-demos.ts +11 -28
  272. package/src/docs/example/docs-toggle-demos.ts +1 -1
  273. package/src/docs/example/users.ts +0 -0
  274. package/src/docs/getting-started/ai-agents.md +29 -55
  275. package/src/docs/getting-started/dataFlow.md +2 -2
  276. package/src/docs/home/home.ts +3 -1
  277. package/src/docs/misc/publisher-get-immutability-docs-crawl.json +902 -0
  278. package/src/docs/misc/publisher-get-immutability-docs-recheck.json +13 -0
  279. package/src/docs/misc/publisher-get-immutability-study.md +229 -0
  280. package/src/docs/navigation/navigation.ts +5 -1
  281. package/src/docs/search/docs-search.json +358 -58
  282. package/src/docs/search/markdown-renderer.ts +6 -1
  283. package/src/docs/tailwind/css/docs/content.css +4 -5
  284. package/src/tsconfig.declarations.json +22 -0
  285. package/src/tsconfig.emit.json +23 -0
  286. package/src/tsconfig.json +53 -5
  287. package/src/tsconfig.tsbuildinfo +1 -1
  288. package/.taste-skill/after/desktop-fold.jpg +0 -0
  289. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  290. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  291. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  292. package/.taste-skill/after/mobile-fold.jpg +0 -0
  293. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  294. package/.taste-skill/after/report.json +0 -4103
  295. package/.taste-skill/after/tablet-fold.jpg +0 -0
  296. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  297. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  298. package/.taste-skill/before/desktop-fold.jpg +0 -0
  299. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  300. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  301. package/.taste-skill/before/mobile-fold.jpg +0 -0
  302. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  303. package/.taste-skill/before/report.json +0 -2556
  304. package/.taste-skill/before/tablet-fold.jpg +0 -0
  305. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  306. package/.taste-skill/direction.json +0 -510
  307. package/.taste-skill/notes.md +0 -84
  308. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  309. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  310. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  311. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  312. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  313. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  314. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  315. package/.taste-skill/prod/report.json +0 -1973
  316. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  317. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  318. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  319. package/AUDIT.md +0 -228
  320. package/PLAN-AMELIORATION.md +0 -220
  321. package/PLAN-DOCS-AGENTS.md +0 -80
  322. package/ai/AGENTS.md +0 -56
  323. package/ai/cursor/rules/concorde-menu.mdc +0 -15
  324. package/ai/cursor/rules/concorde-scope.mdc +0 -14
  325. package/ai/cursor/rules/concorde-theme.mdc +0 -13
  326. package/ai/cursor/rules/concorde.mdc +0 -66
  327. package/ai/jetbrains/rules/concorde.md +0 -53
  328. package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
  329. package/ai/skills/concorde-imports/SKILL.md +0 -78
  330. package/ai/skills/concorde-menu/SKILL.md +0 -74
  331. package/ai/skills/concorde-scope/SKILL.md +0 -70
  332. package/ai/skills/concorde-theme/SKILL.md +0 -57
  333. package/docs/.htaccess +0 -75
  334. package/docs/404.html +0 -15
  335. package/docs/404.md +0 -5
  336. package/docs/assets/index-BgG6FFPt.js +0 -11765
  337. package/docs/assets/index-x89XINSG.css +0 -1
  338. package/docs/core/components/functional/date/date.html +0 -211
  339. package/docs/core/components/functional/date/date.md +0 -150
  340. package/docs/core/components/functional/fetch/fetch.html +0 -180
  341. package/docs/core/components/functional/fetch/fetch.md +0 -108
  342. package/docs/core/components/functional/if/if.html +0 -65
  343. package/docs/core/components/functional/if/if.md +0 -34
  344. package/docs/core/components/functional/jsonata/jsonata.html +0 -110
  345. package/docs/core/components/functional/jsonata/jsonata.md +0 -61
  346. package/docs/core/components/functional/list/list.html +0 -198
  347. package/docs/core/components/functional/list/list.md +0 -121
  348. package/docs/core/components/functional/mix/mix.html +0 -78
  349. package/docs/core/components/functional/mix/mix.md +0 -46
  350. package/docs/core/components/functional/queue/queue.html +0 -155
  351. package/docs/core/components/functional/queue/queue.md +0 -51
  352. package/docs/core/components/functional/router/router.html +0 -154
  353. package/docs/core/components/functional/router/router.md +0 -93
  354. package/docs/core/components/functional/sdui/sdui-extension-points.md +0 -94
  355. package/docs/core/components/functional/sdui/sdui.html +0 -397
  356. package/docs/core/components/functional/sdui/sdui.md +0 -307
  357. package/docs/core/components/functional/states/states.html +0 -141
  358. package/docs/core/components/functional/states/states.md +0 -112
  359. package/docs/core/components/functional/submit/submit.html +0 -178
  360. package/docs/core/components/functional/submit/submit.md +0 -106
  361. package/docs/core/components/functional/subscriber/subscriber.md +0 -91
  362. package/docs/core/components/functional/translation/translation.html +0 -60
  363. package/docs/core/components/functional/translation/translation.md +0 -38
  364. package/docs/core/components/functional/value/value.html +0 -81
  365. package/docs/core/components/functional/value/value.md +0 -47
  366. package/docs/core/components/ui/alert/alert.md +0 -186
  367. package/docs/core/components/ui/alert-messages/alert-messages.md +0 -85
  368. package/docs/core/components/ui/badge/badge.md +0 -181
  369. package/docs/core/components/ui/button/button.html +0 -309
  370. package/docs/core/components/ui/button/button.md +0 -216
  371. package/docs/core/components/ui/captcha/captcha.html +0 -80
  372. package/docs/core/components/ui/captcha/captcha.md +0 -56
  373. package/docs/core/components/ui/card/card.md +0 -215
  374. package/docs/core/components/ui/divider/divider.md +0 -126
  375. package/docs/core/components/ui/form/checkbox/checkbox.html +0 -200
  376. package/docs/core/components/ui/form/checkbox/checkbox.md +0 -125
  377. package/docs/core/components/ui/form/fieldset/fieldset.html +0 -238
  378. package/docs/core/components/ui/form/fieldset/fieldset.md +0 -161
  379. package/docs/core/components/ui/form/form-actions/form-actions.md +0 -98
  380. package/docs/core/components/ui/form/form-layout/form-layout.html +0 -115
  381. package/docs/core/components/ui/form/form-layout/form-layout.md +0 -109
  382. package/docs/core/components/ui/form/input/input.html +0 -235
  383. package/docs/core/components/ui/form/input/input.md +0 -142
  384. package/docs/core/components/ui/form/radio/radio.html +0 -144
  385. package/docs/core/components/ui/form/radio/radio.md +0 -78
  386. package/docs/core/components/ui/form/select/select.html +0 -178
  387. package/docs/core/components/ui/form/select/select.md +0 -86
  388. package/docs/core/components/ui/form/switch/switch.html +0 -146
  389. package/docs/core/components/ui/form/switch/switch.md +0 -80
  390. package/docs/core/components/ui/form/textarea/textarea.html +0 -162
  391. package/docs/core/components/ui/form/textarea/textarea.md +0 -82
  392. package/docs/core/components/ui/group/group.html +0 -113
  393. package/docs/core/components/ui/group/group.md +0 -77
  394. package/docs/core/components/ui/icon/icon.md +0 -214
  395. package/docs/core/components/ui/image/image.html +0 -194
  396. package/docs/core/components/ui/image/image.md +0 -167
  397. package/docs/core/components/ui/link/link.md +0 -81
  398. package/docs/core/components/ui/loader/loader.html +0 -114
  399. package/docs/core/components/ui/loader/loader.md +0 -87
  400. package/docs/core/components/ui/menu/menu.md +0 -370
  401. package/docs/core/components/ui/modal/modal.html +0 -324
  402. package/docs/core/components/ui/modal/modal.md +0 -211
  403. package/docs/core/components/ui/pop/pop.html +0 -250
  404. package/docs/core/components/ui/pop/pop.md +0 -216
  405. package/docs/core/components/ui/progress/progress.md +0 -109
  406. package/docs/core/components/ui/table/table.html +0 -333
  407. package/docs/core/components/ui/table/table.md +0 -267
  408. package/docs/core/components/ui/theme/theme.html +0 -116
  409. package/docs/core/components/ui/theme/theme.md +0 -97
  410. package/docs/core/components/ui/toast/toast.html +0 -185
  411. package/docs/core/components/ui/toast/toast.md +0 -147
  412. package/docs/core/components/ui/tooltip/tooltip.html +0 -112
  413. package/docs/core/components/ui/tooltip/tooltip.md +0 -89
  414. package/docs/docs/decorators/ancestor-attribute.html +0 -71
  415. package/docs/docs/decorators/ancestor-attribute.md +0 -59
  416. package/docs/docs/decorators/auto-subscribe.html +0 -61
  417. package/docs/docs/decorators/auto-subscribe.md +0 -40
  418. package/docs/docs/decorators/bind.html +0 -86
  419. package/docs/docs/decorators/bind.md +0 -77
  420. package/docs/docs/decorators/get.html +0 -166
  421. package/docs/docs/decorators/get.md +0 -160
  422. package/docs/docs/decorators/handle.html +0 -139
  423. package/docs/docs/decorators/handle.md +0 -119
  424. package/docs/docs/decorators/on-assign.html +0 -72
  425. package/docs/docs/decorators/on-assign.md +0 -63
  426. package/docs/docs/decorators/patch.html +0 -76
  427. package/docs/docs/decorators/patch.md +0 -44
  428. package/docs/docs/decorators/post.html +0 -150
  429. package/docs/docs/decorators/post.md +0 -134
  430. package/docs/docs/decorators/publish.html +0 -74
  431. package/docs/docs/decorators/publish.md +0 -56
  432. package/docs/docs/decorators/put.html +0 -83
  433. package/docs/docs/decorators/put.md +0 -51
  434. package/docs/docs/decorators/subscribe.html +0 -91
  435. package/docs/docs/decorators/subscribe.md +0 -87
  436. package/docs/docs/decorators/wait-for-ancestors.html +0 -82
  437. package/docs/docs/decorators/wait-for-ancestors.md +0 -76
  438. package/docs/docs/directives/sub.html +0 -79
  439. package/docs/docs/directives/sub.md +0 -75
  440. package/docs/docs/directives/t.html +0 -91
  441. package/docs/docs/directives/t.md +0 -73
  442. package/docs/docs/getting-started/ai-agents.md +0 -76
  443. package/docs/docs/getting-started/components.html +0 -27
  444. package/docs/docs/getting-started/components.md +0 -5
  445. package/docs/docs/getting-started/installation.html +0 -69
  446. package/docs/docs/getting-started/installation.md +0 -36
  447. package/docs/docs/getting-started/my-first-component.md +0 -227
  448. package/docs/docs/getting-started/start.html +0 -47
  449. package/docs/docs/getting-started/start.md +0 -35
  450. package/docs/docs/getting-started/theming.md +0 -253
  451. package/docs/docs/index.html +0 -99
  452. package/docs/docs/misc/api-configuration.md +0 -79
  453. package/docs/docs/misc/dataProviderKey.md +0 -168
  454. package/docs/hubs/decorators.html +0 -443
  455. package/docs/hubs/form-components.html +0 -404
  456. package/docs/hubs/remote-data.html +0 -371
  457. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  458. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  459. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  460. package/docs/img/archive/credits.json +0 -28
  461. package/docs/index.md +0 -22
  462. package/docs/src/core/components/functional/translation/translation.md +0 -38
  463. package/docs/src/docs/decorators/ancestor-attribute.md +0 -59
  464. package/docs/src/docs/decorators/auto-subscribe.md +0 -40
  465. package/docs/src/docs/decorators/bind.md +0 -77
  466. package/docs/src/docs/decorators/get.md +0 -160
  467. package/docs/src/docs/decorators/handle.md +0 -119
  468. package/docs/src/docs/decorators/on-assign.md +0 -63
  469. package/docs/src/docs/decorators/patch.md +0 -44
  470. package/docs/src/docs/decorators/post.md +0 -134
  471. package/docs/src/docs/decorators/publish.md +0 -56
  472. package/docs/src/docs/decorators/put.md +0 -51
  473. package/docs/src/docs/decorators/subscribe.md +0 -87
  474. package/docs/src/docs/decorators/wait-for-ancestors.md +0 -76
  475. package/docs/src/docs/directives/sub.md +0 -75
  476. package/docs/src/docs/directives/t.md +0 -73
  477. package/docs/src/docs/getting-started/components.md +0 -5
  478. package/docs/src/docs/getting-started/create-a-component.md +0 -136
  479. package/docs/src/docs/getting-started/dataFlow.md +0 -87
  480. package/docs/src/docs/getting-started/installation.md +0 -36
  481. package/docs/src/docs/misc/docs-mock-api.md +0 -62
  482. package/docs/src/docs/misc/dynamic-path.md +0 -71
  483. package/docs/src/docs/misc/endpoint.md +0 -45
  484. package/docs/src/docs/misc/html-integration.md +0 -14
  485. /package/{docs → dist}/img/concorde/plane_01.jpg +0 -0
  486. /package/{docs → dist}/img/concorde/plane_02.jpg +0 -0
  487. /package/{docs → dist}/img/concorde/plane_03.jpg +0 -0
  488. /package/{docs → dist}/img/concorde/plane_04.jpg +0 -0
  489. /package/{docs → dist}/img/concorde/plane_05.jpg +0 -0
  490. /package/{docs → dist}/img/concorde/plane_06.jpg +0 -0
  491. /package/{docs → dist}/img/concorde/plane_07.jpg +0 -0
  492. /package/{docs → dist}/img/concorde/plane_08.jpg +0 -0
  493. /package/{docs → dist}/img/concorde/plane_09.jpg +0 -0
  494. /package/{docs → dist}/img/concorde/plane_10.jpg +0 -0
  495. /package/{docs → dist}/img/concorde/plane_11.jpg +0 -0
  496. /package/{docs → dist}/img/concorde/plane_12.jpg +0 -0
  497. /package/{docs → dist}/img/concorde/plane_13.jpg +0 -0
@@ -1,309 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/ui/button" data-doc-id="core/components/ui/button/button">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Button — Concorde by Supersoniks</title>
7
- <meta name="description" content="sonic-button is the clickable control of the library: a plain button, a link when href is set, or a form toggle when it has a name and value. It shares type / variant / size with sonic-badge, and expo">
8
- <meta name="keywords" content="Concorde, supersoniks, core/components/ui/button/button, button, Button, UI component, sonic-button, web component, href, name, value, type, variant, size, sonic-badge, prefix, suffix">
9
- <meta name="concorde-doc-id" content="core/components/ui/button/button">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/core/components/ui/button">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/ui/button.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/button">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 — Button</strong>. sonic-button is the clickable control of the library: a plain button, a link when href is set, or a form toggle when it has a name and value. It shares type / variant / size with sonic-badge, and expo <span>Doc ID: <code>core/components/ui/button/button</code>. Keywords: Concorde, supersoniks, core/components/ui/button/button, button, Button, UI component, sonic-button, web component, href, name, value, type, variant, size, sonic-badge, prefix, suffix. URL: <a href="https://concorde.supersoniks.org/core/components/ui/button">https://concorde.supersoniks.org/core/components/ui/button</a>.</span></p>
20
- <h1 id="button">Button</h1>
21
- <p><strong><code>sonic-button</code></strong> is the clickable control of the library: a plain button, a link when <code>href</code> is set, or a form toggle when it has a <code>name</code> and <code>value</code>. It shares <code>type</code> / <code>variant</code> / <code>size</code> with <strong><code>sonic-badge</code></strong>, and exposes <code>prefix</code> / <code>suffix</code> slots for icons.</p>
22
- <h2 id="type">Type</h2>
23
- <p>With no <code>type</code>, the button is <code>default</code>. Use <code>custom</code> with <code>--sc-btn-custom-color</code> and <code>--sc-btn-custom-bg</code> for a one-off color.</p>
24
- <pre><code>&lt;div class=&quot;flex flex-wrap gap-2&quot;&gt;
25
- &lt;sonic-button&gt;Default&lt;/sonic-button&gt;
26
- &lt;sonic-button type=&quot;primary&quot;&gt;Primary&lt;/sonic-button&gt;
27
- &lt;sonic-button type=&quot;neutral&quot;&gt;Neutral&lt;/sonic-button&gt;
28
- &lt;sonic-button type=&quot;warning&quot;&gt;Warning&lt;/sonic-button&gt;
29
- &lt;sonic-button type=&quot;info&quot;&gt;Info&lt;/sonic-button&gt;
30
- &lt;sonic-button type=&quot;success&quot;&gt;Success&lt;/sonic-button&gt;
31
- &lt;sonic-button type=&quot;danger&quot;&gt;Danger&lt;/sonic-button&gt;
32
- &lt;sonic-button type=&quot;custom&quot; style=&quot;--sc-btn-custom-color: #fde68a; --sc-btn-custom-bg: #5b21b6&quot;&gt;Custom&lt;/sonic-button&gt;
33
- &lt;/div&gt;
34
- </code></pre>
35
- <h2 id="variant">Variant</h2>
36
- <p>With no <code>variant</code>, the button is filled. The <code>outline</code> / <code>ghost</code> / <code>link</code> variants take their color from <code>type</code>. <code>unstyled</code> removes all styling so you can apply your own classes.</p>
37
- <pre><code>&lt;div class=&quot;flex flex-wrap gap-2&quot;&gt;
38
- &lt;sonic-button type=&quot;primary&quot;&gt;Default&lt;/sonic-button&gt;
39
- &lt;sonic-button type=&quot;primary&quot; variant=&quot;outline&quot;&gt;Outline&lt;/sonic-button&gt;
40
- &lt;sonic-button type=&quot;primary&quot; variant=&quot;ghost&quot;&gt;Ghost&lt;/sonic-button&gt;
41
- &lt;sonic-button type=&quot;primary&quot; variant=&quot;link&quot;&gt;Link&lt;/sonic-button&gt;
42
- &lt;sonic-button variant=&quot;unstyled&quot;&gt;Unstyled&lt;/sonic-button&gt;
43
- &lt;/div&gt;
44
- </code></pre>
45
- <h2 id="size">Size</h2>
46
- <p>With no <code>size</code>, the button is <code>md</code>.</p>
47
- <pre><code>&lt;div class=&quot;flex flex-wrap items-center gap-2&quot;&gt;
48
- &lt;sonic-button size=&quot;2xs&quot;&gt;2xs&lt;/sonic-button&gt;
49
- &lt;sonic-button size=&quot;xs&quot;&gt;xs&lt;/sonic-button&gt;
50
- &lt;sonic-button size=&quot;sm&quot;&gt;sm&lt;/sonic-button&gt;
51
- &lt;sonic-button&gt;md&lt;/sonic-button&gt;
52
- &lt;sonic-button size=&quot;lg&quot;&gt;lg&lt;/sonic-button&gt;
53
- &lt;sonic-button size=&quot;xl&quot;&gt;xl&lt;/sonic-button&gt;
54
- &lt;sonic-button size=&quot;2xl&quot;&gt;2xl&lt;/sonic-button&gt;
55
- &lt;/div&gt;
56
- </code></pre>
57
- <h2 id="shape">Shape</h2>
58
- <p><code>circle</code> and <code>square</code> make a fixed-size icon button. <code>block</code> stretches to the full width of the parent.</p>
59
- <pre><code>&lt;div class=&quot;flex flex-wrap items-center gap-2 mb-2&quot;&gt;
60
- &lt;sonic-button shape=&quot;circle&quot; type=&quot;primary&quot;&gt;&lt;sonic-icon library=&quot;iconoir&quot; name=&quot;plus&quot;&gt;&lt;/sonic-icon&gt;&lt;/sonic-button&gt;
61
- &lt;sonic-button shape=&quot;square&quot; type=&quot;primary&quot;&gt;&lt;sonic-icon library=&quot;iconoir&quot; name=&quot;plus&quot;&gt;&lt;/sonic-icon&gt;&lt;/sonic-button&gt;
62
- &lt;/div&gt;
63
- &lt;sonic-button shape=&quot;block&quot; type=&quot;primary&quot;&gt;Block&lt;/sonic-button&gt;
64
- </code></pre>
65
- <h2 id="prefix-and-suffix-slots">Prefix and suffix slots</h2>
66
- <pre><code>&lt;div class=&quot;flex flex-wrap gap-2&quot;&gt;
67
- &lt;sonic-button type=&quot;primary&quot; variant=&quot;outline&quot;&gt;
68
- &lt;sonic-icon library=&quot;iconoir&quot; slot=&quot;prefix&quot; name=&quot;arrow-left&quot;&gt;&lt;/sonic-icon&gt;
69
- Previous flight
70
- &lt;/sonic-button&gt;
71
- &lt;sonic-button type=&quot;primary&quot;&gt;
72
- Next flight
73
- &lt;sonic-icon library=&quot;iconoir&quot; slot=&quot;suffix&quot; name=&quot;arrow-right&quot;&gt;&lt;/sonic-icon&gt;
74
- &lt;/sonic-button&gt;
75
- &lt;/div&gt;
76
- </code></pre>
77
- <h2 id="loading">Loading</h2>
78
- <p><code>loading</code> replaces the content with a spinner and blocks clicks. The button keeps the width of its content.</p>
79
- <pre><code>&lt;div class=&quot;flex flex-wrap gap-2&quot;&gt;
80
- &lt;sonic-button loading&gt;&lt;/sonic-button&gt;
81
- &lt;sonic-button loading&gt;Loading button&lt;/sonic-button&gt;
82
- &lt;sonic-button loading type=&quot;primary&quot;&gt;
83
- &lt;sonic-icon library=&quot;iconoir&quot; slot=&quot;prefix&quot; name=&quot;check&quot;&gt;&lt;/sonic-icon&gt;
84
- Checking in
85
- &lt;/sonic-button&gt;
86
- &lt;/div&gt;
87
- </code></pre>
88
- <h2 id="link">Link</h2>
89
- <p>With <code>href</code>, the button renders as a link. For a relative <code>href</code>, the button gets <code>active</code> when the current URL matches, according to <code>autoActive</code> (default <code>partial</code>). Add <code>pushState</code> to navigate without reloading the page.</p>
90
- <pre><code>&lt;div class=&quot;flex flex-wrap gap-2&quot;&gt;
91
- &lt;sonic-button href=&quot;https://example.com&quot; target=&quot;_blank&quot; type=&quot;primary&quot;&gt;External link&lt;/sonic-button&gt;
92
- &lt;sonic-button href=&quot;/core/components/ui/button&quot; variant=&quot;ghost&quot;&gt;Current page&lt;/sonic-button&gt;
93
- &lt;/div&gt;
94
- </code></pre>
95
- <h2 id="toggle-and-radio">Toggle and radio</h2>
96
- <p>A button with <code>name</code> and <code>value</code> writes to its <code>formDataProvider</code> and toggles <code>active</code> when clicked. Add <code>radio</code> for a single choice in a group, or <code>unique</code> to also allow deselecting. Children marked <code>swap=&quot;on&quot;</code> / <code>swap=&quot;off&quot;</code> show only in the active / inactive state.</p>
97
- <pre><code>&lt;div class=&quot;flex flex-wrap items-center gap-4&quot;&gt;
98
- &lt;sonic-button formDataProvider=&quot;button-toggle-demo&quot; name=&quot;visible&quot; value=&quot;yes&quot; type=&quot;primary&quot; shape=&quot;circle&quot; variant=&quot;outline&quot;&gt;
99
- &lt;sonic-icon library=&quot;iconoir&quot; swap=&quot;on&quot; name=&quot;eye-empty&quot;&gt;&lt;/sonic-icon&gt;
100
- &lt;sonic-icon library=&quot;iconoir&quot; swap=&quot;off&quot; name=&quot;eye-off&quot;&gt;&lt;/sonic-icon&gt;
101
- &lt;/sonic-button&gt;
102
- &lt;sonic-group formDataProvider=&quot;button-radio-demo&quot;&gt;
103
- &lt;sonic-button radio minWidth=&quot;7rem&quot; name=&quot;plan&quot; value=&quot;free&quot;&gt;Free&lt;/sonic-button&gt;
104
- &lt;sonic-button radio minWidth=&quot;7rem&quot; name=&quot;plan&quot; value=&quot;pro&quot;&gt;Pro&lt;/sonic-button&gt;
105
- &lt;sonic-button radio minWidth=&quot;7rem&quot; name=&quot;plan&quot; value=&quot;team&quot;&gt;Team&lt;/sonic-button&gt;
106
- &lt;/sonic-group&gt;
107
- &lt;/div&gt;
108
- </code></pre>
109
- <h2 id="reset">Reset</h2>
110
- <p><code>reset</code> clears the button&#39;s own <code>formDataProvider</code>. Give it a value to clear another one by name.</p>
111
- <pre><code>&lt;div formDataProvider=&quot;button-reset-demo&quot; class=&quot;mb-2&quot;&gt;
112
- &lt;sonic-checkbox name=&quot;agree&quot; value=&quot;yes&quot;&gt;Extra baggage&lt;/sonic-checkbox&gt;
113
- &lt;sonic-button reset&gt;Reset this form&lt;/sonic-button&gt;
114
- &lt;/div&gt;
115
- &lt;sonic-button reset=&quot;button-reset-demo&quot;&gt;Reset by name&lt;/sonic-button&gt;
116
- </code></pre>
117
- <h2 id="go-back">Go back</h2>
118
- <p><code>goBack</code> navigates back in history. When there is no previous page on the same origin, it goes to the attribute value, or to the site root if empty.</p>
119
- <pre><code>&lt;sonic-button goBack=&quot;/&quot; variant=&quot;outline&quot;&gt;
120
- &lt;sonic-icon library=&quot;iconoir&quot; slot=&quot;prefix&quot; name=&quot;arrow-left&quot;&gt;&lt;/sonic-icon&gt;
121
- Back
122
- &lt;/sonic-button&gt;
123
- </code></pre>
124
- <h2 id="accessibility">Accessibility</h2>
125
- <p>Icon-only buttons need a label. Use <code>data-aria-label</code>, which is forwarded to the inner <code>button</code> (and link).</p>
126
- <pre><code>&lt;sonic-button shape=&quot;circle&quot; data-aria-label=&quot;Close&quot;&gt;
127
- &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;cancel&quot;&gt;&lt;/sonic-icon&gt;
128
- &lt;/sonic-button&gt;
129
- </code></pre>
130
- <h2 id="api-reference">API reference</h2>
131
- <table>
132
- <thead>
133
- <tr>
134
- <th>Attribute</th>
135
- <th>Values</th>
136
- <th>Description</th>
137
- </tr>
138
- </thead>
139
- <tbody><tr>
140
- <td><code>type</code></td>
141
- <td><code>default</code> (default) · <code>primary</code> · <code>neutral</code> · <code>warning</code> · <code>info</code> · <code>success</code> · <code>danger</code> · <code>custom</code></td>
142
- <td>Color; <code>custom</code> reads <code>--sc-btn-custom-color</code> and <code>--sc-btn-custom-bg</code></td>
143
- </tr>
144
- <tr>
145
- <td><code>variant</code></td>
146
- <td><code>default</code> (default) · <code>outline</code> · <code>ghost</code> · <code>link</code> · <code>unstyled</code></td>
147
- <td>Visual style</td>
148
- </tr>
149
- <tr>
150
- <td><code>size</code></td>
151
- <td><code>2xs</code> … <code>2xl</code> (default <code>md</code>) · <code>inherit</code></td>
152
- <td>Typography and padding</td>
153
- </tr>
154
- <tr>
155
- <td><code>shape</code></td>
156
- <td><code>default</code> (default) · <code>circle</code> · <code>square</code> · <code>block</code></td>
157
- <td>Icon button or full width</td>
158
- </tr>
159
- <tr>
160
- <td><code>icon</code></td>
161
- <td>boolean</td>
162
- <td>Enlarges a lone icon</td>
163
- </tr>
164
- <tr>
165
- <td><code>loading</code></td>
166
- <td>boolean</td>
167
- <td>Shows a spinner and blocks clicks</td>
168
- </tr>
169
- <tr>
170
- <td><code>disabled</code></td>
171
- <td>boolean</td>
172
- <td>Dims the button and blocks clicks</td>
173
- </tr>
174
- <tr>
175
- <td><code>active</code></td>
176
- <td>boolean</td>
177
- <td>Active state, set automatically for links and toggles</td>
178
- </tr>
179
- <tr>
180
- <td><code>align</code></td>
181
- <td><code>left</code> · <code>center</code> · <code>right</code></td>
182
- <td>Text alignment</td>
183
- </tr>
184
- <tr>
185
- <td><code>direction</code></td>
186
- <td>flex direction (default <code>row</code>)</td>
187
- <td>Layout of slots</td>
188
- </tr>
189
- <tr>
190
- <td><code>alignItems</code></td>
191
- <td>flex <code>align-items</code> (default <code>center</code>)</td>
192
- <td>Cross-axis alignment of slots</td>
193
- </tr>
194
- <tr>
195
- <td><code>justify</code></td>
196
- <td>flex <code>justify-content</code> (default <code>center</code>)</td>
197
- <td>Main-axis alignment of slots</td>
198
- </tr>
199
- <tr>
200
- <td><code>minWidth</code></td>
201
- <td>CSS length (default <code>0</code>)</td>
202
- <td>Minimum width of the button</td>
203
- </tr>
204
- <tr>
205
- <td><code>href</code></td>
206
- <td>URL</td>
207
- <td>Renders the button as a link</td>
208
- </tr>
209
- <tr>
210
- <td><code>target</code></td>
211
- <td><code>_self</code> · <code>_blank</code> · <code>_parent</code> · <code>_top</code></td>
212
- <td>Link target</td>
213
- </tr>
214
- <tr>
215
- <td><code>download</code></td>
216
- <td>string</td>
217
- <td>Link <code>download</code> attribute</td>
218
- </tr>
219
- <tr>
220
- <td><code>pushState</code></td>
221
- <td>boolean</td>
222
- <td>Navigates with <code>history.pushState</code></td>
223
- </tr>
224
- <tr>
225
- <td><code>autoActive</code></td>
226
- <td><code>partial</code> (default) · <code>strict</code> · <code>strict-path-only</code> · <code>disabled</code></td>
227
- <td>URL matching for <code>active</code></td>
228
- </tr>
229
- <tr>
230
- <td><code>goBack</code></td>
231
- <td>URL or empty</td>
232
- <td>Goes back in history, with a fallback URL</td>
233
- </tr>
234
- <tr>
235
- <td><code>reset</code></td>
236
- <td>empty or provider name</td>
237
- <td>Clears the current or named form data provider</td>
238
- </tr>
239
- <tr>
240
- <td><code>name</code> / <code>value</code></td>
241
- <td>string</td>
242
- <td>Form field written to the data provider</td>
243
- </tr>
244
- <tr>
245
- <td><code>formDataProvider</code></td>
246
- <td>string</td>
247
- <td>Data provider to write to (default: nearest ancestor)</td>
248
- </tr>
249
- <tr>
250
- <td><code>radio</code></td>
251
- <td>boolean</td>
252
- <td>Single choice among buttons with the same <code>name</code></td>
253
- </tr>
254
- <tr>
255
- <td><code>unique</code></td>
256
- <td>boolean</td>
257
- <td>Like <code>radio</code>, but can be deselected</td>
258
- </tr>
259
- <tr>
260
- <td><code>autoRepeat</code></td>
261
- <td>boolean</td>
262
- <td>Repeats the click while the pointer is held</td>
263
- </tr>
264
- <tr>
265
- <td><code>data-aria-label</code></td>
266
- <td>string</td>
267
- <td><code>aria-label</code> of the inner button</td>
268
- </tr>
269
- <tr>
270
- <td><code>data-aria-labelledby</code></td>
271
- <td>string</td>
272
- <td><code>aria-labelledby</code> of the inner button</td>
273
- </tr>
274
- <tr>
275
- <td><code>data-aria-controls</code></td>
276
- <td>string</td>
277
- <td><code>aria-controls</code> of the inner button</td>
278
- </tr>
279
- <tr>
280
- <td><code>data-aria-expanded</code></td>
281
- <td>boolean</td>
282
- <td><code>aria-expanded</code> of the inner button</td>
283
- </tr>
284
- </tbody></table>
285
- <table>
286
- <thead>
287
- <tr>
288
- <th>Slot</th>
289
- <th>Description</th>
290
- </tr>
291
- </thead>
292
- <tbody><tr>
293
- <td><em>(default)</em></td>
294
- <td>Label</td>
295
- </tr>
296
- <tr>
297
- <td><code>prefix</code></td>
298
- <td>Icon or text before the label</td>
299
- </tr>
300
- <tr>
301
- <td><code>suffix</code></td>
302
- <td>Icon or text after the label</td>
303
- </tr>
304
- </tbody></table>
305
-
306
- </article>
307
- </main>
308
- </body>
309
- </html>
@@ -1,216 +0,0 @@
1
- # Button
2
-
3
- **`sonic-button`** is the clickable control of the library: a plain button, a link when `href` is set, or a form toggle when it has a `name` and `value`. It shares `type` / `variant` / `size` with **`sonic-badge`**, and exposes `prefix` / `suffix` slots for icons.
4
-
5
- ## Type
6
-
7
- With no `type`, the button is `default`. Use `custom` with `--sc-btn-custom-color` and `--sc-btn-custom-bg` for a one-off color.
8
-
9
- <sonic-code>
10
- <template>
11
- <div class="flex flex-wrap gap-2">
12
- <sonic-button>Default</sonic-button>
13
- <sonic-button type="primary">Primary</sonic-button>
14
- <sonic-button type="neutral">Neutral</sonic-button>
15
- <sonic-button type="warning">Warning</sonic-button>
16
- <sonic-button type="info">Info</sonic-button>
17
- <sonic-button type="success">Success</sonic-button>
18
- <sonic-button type="danger">Danger</sonic-button>
19
- <sonic-button type="custom" style="--sc-btn-custom-color: #fde68a; --sc-btn-custom-bg: #5b21b6">Custom</sonic-button>
20
- </div>
21
- </template>
22
- </sonic-code>
23
-
24
- ## Variant
25
-
26
- With no `variant`, the button is filled. The `outline` / `ghost` / `link` variants take their color from `type`. `unstyled` removes all styling so you can apply your own classes.
27
-
28
- <sonic-code>
29
- <template>
30
- <div class="flex flex-wrap gap-2">
31
- <sonic-button type="primary">Default</sonic-button>
32
- <sonic-button type="primary" variant="outline">Outline</sonic-button>
33
- <sonic-button type="primary" variant="ghost">Ghost</sonic-button>
34
- <sonic-button type="primary" variant="link">Link</sonic-button>
35
- <sonic-button variant="unstyled">Unstyled</sonic-button>
36
- </div>
37
- </template>
38
- </sonic-code>
39
-
40
- ## Size
41
-
42
- With no `size`, the button is `md`.
43
-
44
- <sonic-code>
45
- <template>
46
- <div class="flex flex-wrap items-center gap-2">
47
- <sonic-button size="2xs">2xs</sonic-button>
48
- <sonic-button size="xs">xs</sonic-button>
49
- <sonic-button size="sm">sm</sonic-button>
50
- <sonic-button>md</sonic-button>
51
- <sonic-button size="lg">lg</sonic-button>
52
- <sonic-button size="xl">xl</sonic-button>
53
- <sonic-button size="2xl">2xl</sonic-button>
54
- </div>
55
- </template>
56
- </sonic-code>
57
-
58
- ## Shape
59
-
60
- `circle` and `square` make a fixed-size icon button. `block` stretches to the full width of the parent.
61
-
62
- <sonic-code>
63
- <template>
64
- <div class="flex flex-wrap items-center gap-2 mb-2">
65
- <sonic-button shape="circle" type="primary"><sonic-icon library="iconoir" name="plus"></sonic-icon></sonic-button>
66
- <sonic-button shape="square" type="primary"><sonic-icon library="iconoir" name="plus"></sonic-icon></sonic-button>
67
- </div>
68
- <sonic-button shape="block" type="primary">Block</sonic-button>
69
- </template>
70
- </sonic-code>
71
-
72
- ## Prefix and suffix slots
73
-
74
- <sonic-code>
75
- <template>
76
- <div class="flex flex-wrap gap-2">
77
- <sonic-button type="primary" variant="outline">
78
- <sonic-icon library="iconoir" slot="prefix" name="arrow-left"></sonic-icon>
79
- Previous flight
80
- </sonic-button>
81
- <sonic-button type="primary">
82
- Next flight
83
- <sonic-icon library="iconoir" slot="suffix" name="arrow-right"></sonic-icon>
84
- </sonic-button>
85
- </div>
86
- </template>
87
- </sonic-code>
88
-
89
- ## Loading
90
-
91
- `loading` replaces the content with a spinner and blocks clicks. The button keeps the width of its content.
92
-
93
- <sonic-code>
94
- <template>
95
- <div class="flex flex-wrap gap-2">
96
- <sonic-button loading></sonic-button>
97
- <sonic-button loading>Loading button</sonic-button>
98
- <sonic-button loading type="primary">
99
- <sonic-icon library="iconoir" slot="prefix" name="check"></sonic-icon>
100
- Checking in
101
- </sonic-button>
102
- </div>
103
- </template>
104
- </sonic-code>
105
-
106
- ## Link
107
-
108
- With `href`, the button renders as a link. For a relative `href`, the button gets `active` when the current URL matches, according to `autoActive` (default `partial`). Add `pushState` to navigate without reloading the page.
109
-
110
- <sonic-code>
111
- <template>
112
- <div class="flex flex-wrap gap-2">
113
- <sonic-button href="https://example.com" target="_blank" type="primary">External link</sonic-button>
114
- <sonic-button href="/core/components/ui/button" variant="ghost">Current page</sonic-button>
115
- </div>
116
- </template>
117
- </sonic-code>
118
-
119
- ## Toggle and radio
120
-
121
- A button with `name` and `value` writes to its `formDataProvider` and toggles `active` when clicked. Add `radio` for a single choice in a group, or `unique` to also allow deselecting. Children marked `swap="on"` / `swap="off"` show only in the active / inactive state.
122
-
123
- <sonic-code>
124
- <template>
125
- <div class="flex flex-wrap items-center gap-4">
126
- <sonic-button formDataProvider="button-toggle-demo" name="visible" value="yes" type="primary" shape="circle" variant="outline">
127
- <sonic-icon library="iconoir" swap="on" name="eye-empty"></sonic-icon>
128
- <sonic-icon library="iconoir" swap="off" name="eye-off"></sonic-icon>
129
- </sonic-button>
130
- <sonic-group formDataProvider="button-radio-demo">
131
- <sonic-button radio minWidth="7rem" name="plan" value="free">Free</sonic-button>
132
- <sonic-button radio minWidth="7rem" name="plan" value="pro">Pro</sonic-button>
133
- <sonic-button radio minWidth="7rem" name="plan" value="team">Team</sonic-button>
134
- </sonic-group>
135
- </div>
136
- </template>
137
- </sonic-code>
138
-
139
- ## Reset
140
-
141
- `reset` clears the button's own `formDataProvider`. Give it a value to clear another one by name.
142
-
143
- <sonic-code>
144
- <template>
145
- <div formDataProvider="button-reset-demo" class="mb-2">
146
- <sonic-checkbox name="agree" value="yes">Extra baggage</sonic-checkbox>
147
- <sonic-button reset>Reset this form</sonic-button>
148
- </div>
149
- <sonic-button reset="button-reset-demo">Reset by name</sonic-button>
150
- </template>
151
- </sonic-code>
152
-
153
- ## Go back
154
-
155
- `goBack` navigates back in history. When there is no previous page on the same origin, it goes to the attribute value, or to the site root if empty.
156
-
157
- <sonic-code>
158
- <template>
159
- <sonic-button goBack="/" variant="outline">
160
- <sonic-icon library="iconoir" slot="prefix" name="arrow-left"></sonic-icon>
161
- Back
162
- </sonic-button>
163
- </template>
164
- </sonic-code>
165
-
166
- ## Accessibility
167
-
168
- Icon-only buttons need a label. Use `data-aria-label`, which is forwarded to the inner `button` (and link).
169
-
170
- <sonic-code>
171
- <template>
172
- <sonic-button shape="circle" data-aria-label="Close">
173
- <sonic-icon library="iconoir" name="cancel"></sonic-icon>
174
- </sonic-button>
175
- </template>
176
- </sonic-code>
177
-
178
- ## API reference
179
-
180
- | Attribute | Values | Description |
181
- |----------|---------|-------------|
182
- | `type` | `default` (default) · `primary` · `neutral` · `warning` · `info` · `success` · `danger` · `custom` | Color; `custom` reads `--sc-btn-custom-color` and `--sc-btn-custom-bg` |
183
- | `variant` | `default` (default) · `outline` · `ghost` · `link` · `unstyled` | Visual style |
184
- | `size` | `2xs` … `2xl` (default `md`) · `inherit` | Typography and padding |
185
- | `shape` | `default` (default) · `circle` · `square` · `block` | Icon button or full width |
186
- | `icon` | boolean | Enlarges a lone icon |
187
- | `loading` | boolean | Shows a spinner and blocks clicks |
188
- | `disabled` | boolean | Dims the button and blocks clicks |
189
- | `active` | boolean | Active state, set automatically for links and toggles |
190
- | `align` | `left` · `center` · `right` | Text alignment |
191
- | `direction` | flex direction (default `row`) | Layout of slots |
192
- | `alignItems` | flex `align-items` (default `center`) | Cross-axis alignment of slots |
193
- | `justify` | flex `justify-content` (default `center`) | Main-axis alignment of slots |
194
- | `minWidth` | CSS length (default `0`) | Minimum width of the button |
195
- | `href` | URL | Renders the button as a link |
196
- | `target` | `_self` · `_blank` · `_parent` · `_top` | Link target |
197
- | `download` | string | Link `download` attribute |
198
- | `pushState` | boolean | Navigates with `history.pushState` |
199
- | `autoActive` | `partial` (default) · `strict` · `strict-path-only` · `disabled` | URL matching for `active` |
200
- | `goBack` | URL or empty | Goes back in history, with a fallback URL |
201
- | `reset` | empty or provider name | Clears the current or named form data provider |
202
- | `name` / `value` | string | Form field written to the data provider |
203
- | `formDataProvider` | string | Data provider to write to (default: nearest ancestor) |
204
- | `radio` | boolean | Single choice among buttons with the same `name` |
205
- | `unique` | boolean | Like `radio`, but can be deselected |
206
- | `autoRepeat` | boolean | Repeats the click while the pointer is held |
207
- | `data-aria-label` | string | `aria-label` of the inner button |
208
- | `data-aria-labelledby` | string | `aria-labelledby` of the inner button |
209
- | `data-aria-controls` | string | `aria-controls` of the inner button |
210
- | `data-aria-expanded` | boolean | `aria-expanded` of the inner button |
211
-
212
- | Slot | Description |
213
- |------|-------------|
214
- | *(default)* | Label |
215
- | `prefix` | Icon or text before the label |
216
- | `suffix` | Icon or text after the label |
@@ -1,80 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/ui/captcha" data-doc-id="core/components/ui/captcha/captcha">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Captcha — Concorde by Supersoniks</title>
7
- <meta name="description" content="sonic-captcha embeds an ALTCHA proof-of-work widget and makes the nearest form wait for it. Place it inside a form scope and put sonic-submit in its default slot: the widget renders above the slot con">
8
- <meta name="keywords" content="Concorde, supersoniks, core/components/ui/captcha/captcha, captcha, Captcha, UI component, sonic-captcha, web component, sonic-submit, headersDataProvider, formDataProvider, needsCaptchaValidation, true, captchaToken, captchaKey">
9
- <meta name="concorde-doc-id" content="core/components/ui/captcha/captcha">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/core/components/ui/captcha">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/ui/captcha.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/captcha">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 — Captcha</strong>. sonic-captcha embeds an ALTCHA proof-of-work widget and makes the nearest form wait for it. Place it inside a form scope and put sonic-submit in its default slot: the widget renders above the slot con <span>Doc ID: <code>core/components/ui/captcha/captcha</code>. Keywords: Concorde, supersoniks, core/components/ui/captcha/captcha, captcha, Captcha, UI component, sonic-captcha, web component, sonic-submit, headersDataProvider, formDataProvider, needsCaptchaValidation, true, captchaToken, captchaKey. URL: <a href="https://concorde.supersoniks.org/core/components/ui/captcha">https://concorde.supersoniks.org/core/components/ui/captcha</a>.</span></p>
20
- <h1 id="captcha">Captcha</h1>
21
- <p><strong><code>sonic-captcha</code></strong> embeds an <a href="https://altcha.org">ALTCHA</a> proof-of-work widget and makes the nearest form wait for it. Place it inside a form scope and put <strong><code>sonic-submit</code></strong> in its default slot: the widget renders above the slot content, and the submit sends only once a token is available.</p>
22
- <h2 id="basic-example">Basic example</h2>
23
- <p>The widget loads only on <strong>HTTPS</strong>. On plain HTTP the component renders nothing and the form is not blocked.</p>
24
- <pre><code>&lt;sonic-scope
25
- serviceURL=&quot;/docs-mock-api&quot;
26
- formDataProvider=&quot;captcha-docs-form&quot;
27
- submitResultDataProvider=&quot;captcha-docs-result&quot;
28
- &gt;
29
- &lt;sonic-captcha&gt;
30
- &lt;sonic-input class=&quot;mb-3 block&quot; name=&quot;email&quot; type=&quot;email&quot; label=&quot;Email&quot; value=&quot;demo@example.com&quot;&gt;&lt;/sonic-input&gt;
31
- &lt;sonic-submit endPoint=&quot;api/register&quot; onClick&gt;
32
- &lt;sonic-button type=&quot;primary&quot;&gt;Join the crew&lt;/sonic-button&gt;
33
- &lt;/sonic-submit&gt;
34
- &lt;/sonic-captcha&gt;
35
- &lt;/sonic-scope&gt;
36
- </code></pre>
37
- <h2 id="form-integration">Form integration</h2>
38
- <p>The component writes to the publisher named by the closest <code>headersDataProvider</code>, or else <code>formDataProvider</code>, on itself or an ancestor. On connect it sets <code>needsCaptchaValidation</code> to <code>true</code>. When <strong><code>sonic-submit</code></strong> sees that flag, it requests a token, the captcha copies the solved ALTCHA payload into <code>captchaToken</code> and its key into <code>captchaKey</code>, and the request is sent. <code>needsCaptchaValidation</code> is stripped from the payload. On disconnect both fields are reset.</p>
39
- <pre><code class="language-typescript">{
40
- email: &quot;demo@example.com&quot;,
41
- captchaKey: &quot;…&quot;,
42
- captchaToken: &quot;…&quot;
43
- }
44
- </code></pre>
45
- <h2 id="key-and-challenge-endpoint">Key and challenge endpoint</h2>
46
- <p>With no <code>key</code>, the component generates an encrypted key on connect. The widget fetches its challenge from the <code>chalengeUrl</code> property (a JavaScript property, not an attribute) with <code>key</code> and <code>maxNumber</code> (default <code>50000</code>) as query parameters. Point it at your own ALTCHA server and verify <code>captchaToken</code> there.</p>
47
- <p>Labels follow the page language: French when <code>&lt;html lang&gt;</code> starts with <code>fr</code>, English otherwise.</p>
48
- <h2 id="api-reference">API reference</h2>
49
- <table>
50
- <thead>
51
- <tr>
52
- <th>Attribute</th>
53
- <th>Values</th>
54
- <th>Description</th>
55
- </tr>
56
- </thead>
57
- <tbody><tr>
58
- <td><code>key</code></td>
59
- <td>string (default generated)</td>
60
- <td>Key sent to the challenge endpoint and copied to <code>captchaKey</code></td>
61
- </tr>
62
- </tbody></table>
63
- <table>
64
- <thead>
65
- <tr>
66
- <th>Slot</th>
67
- <th>Description</th>
68
- </tr>
69
- </thead>
70
- <tbody><tr>
71
- <td><em>(default)</em></td>
72
- <td>Form fields and actions, rendered below the widget</td>
73
- </tr>
74
- </tbody></table>
75
- <p>No events.</p>
76
-
77
- </article>
78
- </main>
79
- </body>
80
- </html>