@supersoniks/concorde 5.0.5 → 5.1.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 (282) hide show
  1. package/.claude/launch.json +15 -0
  2. package/.claude/vite.http.config.mjs +7 -0
  3. package/.taste-skill/after/desktop-fold.jpg +0 -0
  4. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  5. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  6. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  7. package/.taste-skill/after/mobile-fold.jpg +0 -0
  8. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  9. package/.taste-skill/after/report.json +4103 -0
  10. package/.taste-skill/after/tablet-fold.jpg +0 -0
  11. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  12. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  13. package/.taste-skill/before/desktop-fold.jpg +0 -0
  14. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  15. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  16. package/.taste-skill/before/mobile-fold.jpg +0 -0
  17. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  18. package/.taste-skill/before/report.json +2556 -0
  19. package/.taste-skill/before/tablet-fold.jpg +0 -0
  20. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  21. package/.taste-skill/direction.json +510 -0
  22. package/.taste-skill/notes.md +84 -0
  23. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  24. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  25. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  26. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  27. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  28. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  29. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  30. package/.taste-skill/prod/report.json +1973 -0
  31. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  32. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  33. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  34. package/.tmp-cem/custom-elements.json +13705 -0
  35. package/AUDIT.md +228 -0
  36. package/PLAN-AMELIORATION.md +220 -0
  37. package/build-infos.json +1 -1
  38. package/concorde-core.bundle.js +196 -196
  39. package/concorde-core.es.js +3854 -3572
  40. package/custom-elements-manifest.config.mjs +14 -0
  41. package/dist/concorde-core.bundle.js +196 -196
  42. package/dist/concorde-core.es.js +3854 -3572
  43. package/dist/img/archive/concorde-001-2cv.webp +0 -0
  44. package/dist/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  45. package/dist/img/archive/concorde-red-arrows-2002.webm +0 -0
  46. package/dist/img/archive/credits.json +28 -0
  47. package/docs/assets/index-Bb-_LRyY.js +12280 -0
  48. package/docs/index.html +1 -1
  49. package/index.html +27 -63
  50. package/package.json +44 -3
  51. package/public/img/archive/concorde-001-2cv.webp +0 -0
  52. package/public/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  53. package/public/img/archive/concorde-red-arrows-2002.webm +0 -0
  54. package/public/img/archive/credits.json +28 -0
  55. package/scripts/generate-sdui-catalog.mjs +250 -0
  56. package/scripts/generate-sdui-catalog.spec.ts +91 -0
  57. package/scripts/pre-build.mjs +15 -0
  58. package/src/core/components/functional/fetch/fetch.md +2 -2
  59. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +5 -5
  60. package/src/core/components/functional/sdui/__fixtures__/descriptors.ts +251 -0
  61. package/src/core/components/functional/sdui/__snapshots__/sdui-action.spec.ts.snap +73 -0
  62. package/src/core/components/functional/sdui/__snapshots__/sdui-incremental.spec.ts.snap +50 -0
  63. package/src/core/components/functional/sdui/__snapshots__/sdui-partial.spec.ts.snap +50 -0
  64. package/src/core/components/functional/sdui/__snapshots__/sdui.regression.spec.ts.snap +461 -0
  65. package/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  66. package/src/core/components/functional/sdui/component-catalog.json +3103 -0
  67. package/src/core/components/functional/sdui/component-catalog.spec.ts +23 -0
  68. package/src/core/components/functional/sdui/sdui-action.spec.ts +99 -0
  69. package/src/core/components/functional/sdui/sdui-dom-snapshot.ts +61 -0
  70. package/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  71. package/src/core/components/functional/sdui/sdui-incremental.spec.ts +137 -0
  72. package/src/core/components/functional/sdui/sdui-partial.spec.ts +83 -0
  73. package/src/core/components/functional/sdui/sdui-partial.ts +19 -0
  74. package/src/core/components/functional/sdui/sdui-safe.spec.ts +188 -0
  75. package/src/core/components/functional/sdui/sdui-safe.ts +100 -0
  76. package/src/core/components/functional/sdui/sdui.md +122 -0
  77. package/src/core/components/functional/sdui/sdui.regression.spec.ts +64 -0
  78. package/src/core/components/functional/sdui/sdui.ts +442 -34
  79. package/src/core/components/functional/sdui/types.ts +49 -0
  80. package/src/core/components/ui/modal/modal.ts +14 -11
  81. package/src/docs/_getting-started/components.md +5 -0
  82. package/src/docs/_getting-started/theming.md +2 -2
  83. package/src/docs/code.ts +88 -75
  84. package/src/docs/components/docs-demo-sources.ts +16 -8
  85. package/src/docs/components/docs-lit-demo.ts +19 -37
  86. package/src/docs/docs.ts +5 -0
  87. package/src/docs/example/docs-boarding-pass-demo.ts +134 -0
  88. package/src/docs/example/docs-provider-keys.ts +12 -0
  89. package/src/docs/header/header.ts +233 -69
  90. package/src/docs/home/catalog.ts +44 -0
  91. package/src/docs/home/home.ts +513 -0
  92. package/src/docs/home/mach-stage.ts +389 -0
  93. package/src/docs/layout.ts +3 -1
  94. package/src/docs/navigation/components-index.ts +56 -0
  95. package/src/docs/navigation/navigation.ts +240 -232
  96. package/src/docs/navigation/pager.ts +67 -0
  97. package/src/docs/navigation/toc.ts +98 -0
  98. package/src/docs/search/docs-search.json +330 -20
  99. package/src/docs/search/markdown-renderer.ts +11 -3
  100. package/src/docs/shiki/index.ts +109 -0
  101. package/src/docs/tailwind/css/base/scrollbar.css +22 -0
  102. package/src/docs/tailwind/css/base/theme.css +96 -0
  103. package/src/docs/tailwind/css/base/typography.css +4 -0
  104. package/src/docs/tailwind/css/docs/boarding-pass.css +65 -0
  105. package/src/docs/tailwind/css/docs/content.css +32 -0
  106. package/src/docs/tailwind/css/docs/page.css +10 -0
  107. package/src/docs/tailwind/css/docs.css +9 -0
  108. package/src/docs/tailwind/css/home/hero.css +210 -0
  109. package/src/docs/tailwind/css/home/motion.css +84 -0
  110. package/src/docs/tailwind/css/home/sections.css +416 -0
  111. package/src/docs/tailwind/css/tailwind.css +7 -185
  112. package/src/tsconfig.json +113 -2
  113. package/src/tsconfig.tsbuildinfo +1 -1
  114. package/tailwind.config.js +8 -4
  115. package/docs/assets/index-wVZpLVYW.js +0 -12122
  116. package/docs/crawl/core/components/functional/date/date.html +0 -190
  117. package/docs/crawl/core/components/functional/fetch/fetch.html +0 -109
  118. package/docs/crawl/core/components/functional/if/if.html +0 -27
  119. package/docs/crawl/core/components/functional/jsonata/jsonata.html +0 -79
  120. package/docs/crawl/core/components/functional/list/list.html +0 -70
  121. package/docs/crawl/core/components/functional/mix/mix.html +0 -45
  122. package/docs/crawl/core/components/functional/queue/queue.html +0 -96
  123. package/docs/crawl/core/components/functional/router/router.html +0 -106
  124. package/docs/crawl/core/components/functional/sdui/sdui.html +0 -269
  125. package/docs/crawl/core/components/functional/states/states.html +0 -66
  126. package/docs/crawl/core/components/functional/submit/submit.html +0 -160
  127. package/docs/crawl/core/components/functional/subscriber/subscriber.html +0 -67
  128. package/docs/crawl/core/components/functional/value/value.html +0 -51
  129. package/docs/crawl/core/components/ui/alert/alert.html +0 -211
  130. package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +0 -131
  131. package/docs/crawl/core/components/ui/badge/badge.html +0 -197
  132. package/docs/crawl/core/components/ui/button/button.html +0 -150
  133. package/docs/crawl/core/components/ui/captcha/captcha.html +0 -112
  134. package/docs/crawl/core/components/ui/card/card.html +0 -253
  135. package/docs/crawl/core/components/ui/divider/divider.html +0 -144
  136. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +0 -73
  137. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +0 -266
  138. package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +0 -122
  139. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +0 -121
  140. package/docs/crawl/core/components/ui/form/input/input.html +0 -109
  141. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +0 -38
  142. package/docs/crawl/core/components/ui/form/radio/radio.html +0 -56
  143. package/docs/crawl/core/components/ui/form/select/select.html +0 -73
  144. package/docs/crawl/core/components/ui/form/switch/switch.html +0 -56
  145. package/docs/crawl/core/components/ui/form/textarea/textarea.html +0 -59
  146. package/docs/crawl/core/components/ui/group/group.html +0 -104
  147. package/docs/crawl/core/components/ui/icon/icon.html +0 -222
  148. package/docs/crawl/core/components/ui/image/image.html +0 -298
  149. package/docs/crawl/core/components/ui/link/link.html +0 -100
  150. package/docs/crawl/core/components/ui/loader/loader.html +0 -124
  151. package/docs/crawl/core/components/ui/menu/menu.html +0 -394
  152. package/docs/crawl/core/components/ui/modal/modal.html +0 -342
  153. package/docs/crawl/core/components/ui/pop/pop.html +0 -296
  154. package/docs/crawl/core/components/ui/progress/progress.html +0 -131
  155. package/docs/crawl/core/components/ui/table/table.html +0 -545
  156. package/docs/crawl/core/components/ui/theme/theme.html +0 -131
  157. package/docs/crawl/core/components/ui/toast/toast.html +0 -233
  158. package/docs/crawl/core/components/ui/tooltip/tooltip.html +0 -140
  159. package/docs/crawl/docs/_core-concept/dataFlow.html +0 -177
  160. package/docs/crawl/docs/_core-concept/overview.html +0 -66
  161. package/docs/crawl/docs/_core-concept/subscriber.html +0 -75
  162. package/docs/crawl/docs/_decorators/ancestor-attribute.html +0 -117
  163. package/docs/crawl/docs/_decorators/auto-subscribe.html +0 -202
  164. package/docs/crawl/docs/_decorators/bind.html +0 -141
  165. package/docs/crawl/docs/_decorators/get.html +0 -149
  166. package/docs/crawl/docs/_decorators/handle.html +0 -165
  167. package/docs/crawl/docs/_decorators/on-assign.html +0 -355
  168. package/docs/crawl/docs/_decorators/patch.html +0 -78
  169. package/docs/crawl/docs/_decorators/post.html +0 -139
  170. package/docs/crawl/docs/_decorators/publish.html +0 -61
  171. package/docs/crawl/docs/_decorators/put.html +0 -78
  172. package/docs/crawl/docs/_decorators/subscribe.html +0 -109
  173. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +0 -137
  174. package/docs/crawl/docs/_directives/sub.html +0 -93
  175. package/docs/crawl/docs/_getting-started/ai-agents.html +0 -173
  176. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +0 -100
  177. package/docs/crawl/docs/_getting-started/concorde-outside.html +0 -58
  178. package/docs/crawl/docs/_getting-started/create-a-component.html +0 -111
  179. package/docs/crawl/docs/_getting-started/my-first-component.html +0 -189
  180. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +0 -110
  181. package/docs/crawl/docs/_getting-started/pubsub.html +0 -62
  182. package/docs/crawl/docs/_getting-started/start.html +0 -76
  183. package/docs/crawl/docs/_getting-started/theming.html +0 -333
  184. package/docs/crawl/docs/_misc/api-configuration.html +0 -149
  185. package/docs/crawl/docs/_misc/dataProviderKey.html +0 -135
  186. package/docs/crawl/docs/_misc/docs-mock-api.html +0 -158
  187. package/docs/crawl/docs/_misc/dynamic-path.html +0 -180
  188. package/docs/crawl/docs/_misc/endpoint.html +0 -50
  189. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +0 -138
  190. package/docs/crawl/docs/_misc/html-integration.html +0 -48
  191. package/docs/crawl/hubs/decorators.html +0 -547
  192. package/docs/crawl/hubs/form-components.html +0 -381
  193. package/docs/crawl/hubs/remote-data.html +0 -452
  194. package/docs/crawl/index.html +0 -102
  195. package/docs/llms-full.txt +0 -7008
  196. package/docs/llms.txt +0 -97
  197. package/docs/sitemap.xml +0 -240
  198. package/docs/src/core/components/functional/date/date.md +0 -290
  199. package/docs/src/core/components/functional/fetch/fetch.md +0 -125
  200. package/docs/src/core/components/functional/if/if.md +0 -9
  201. package/docs/src/core/components/functional/jsonata/jsonata.md +0 -56
  202. package/docs/src/core/components/functional/list/list.md +0 -65
  203. package/docs/src/core/components/functional/mix/mix.md +0 -41
  204. package/docs/src/core/components/functional/queue/queue.md +0 -72
  205. package/docs/src/core/components/functional/router/router.md +0 -94
  206. package/docs/src/core/components/functional/sdui/default-library.json +0 -108
  207. package/docs/src/core/components/functional/sdui/example.json +0 -99
  208. package/docs/src/core/components/functional/sdui/sdui.md +0 -356
  209. package/docs/src/core/components/functional/states/states.md +0 -87
  210. package/docs/src/core/components/functional/submit/submit.md +0 -114
  211. package/docs/src/core/components/functional/subscriber/subscriber.md +0 -91
  212. package/docs/src/core/components/functional/value/value.md +0 -35
  213. package/docs/src/core/components/ui/alert/alert.md +0 -196
  214. package/docs/src/core/components/ui/alert-messages/alert-messages.md +0 -85
  215. package/docs/src/core/components/ui/badge/badge.md +0 -188
  216. package/docs/src/core/components/ui/button/button.md +0 -183
  217. package/docs/src/core/components/ui/captcha/captcha.md +0 -71
  218. package/docs/src/core/components/ui/card/card.md +0 -215
  219. package/docs/src/core/components/ui/divider/divider.md +0 -129
  220. package/docs/src/core/components/ui/form/checkbox/checkbox.md +0 -77
  221. package/docs/src/core/components/ui/form/fieldset/fieldset.md +0 -205
  222. package/docs/src/core/components/ui/form/form-actions/form-actions.md +0 -100
  223. package/docs/src/core/components/ui/form/form-layout/form-layout.md +0 -119
  224. package/docs/src/core/components/ui/form/input/input.md +0 -142
  225. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  226. package/docs/src/core/components/ui/form/radio/radio.md +0 -57
  227. package/docs/src/core/components/ui/form/select/select.md +0 -71
  228. package/docs/src/core/components/ui/form/switch/switch.md +0 -57
  229. package/docs/src/core/components/ui/form/textarea/textarea.md +0 -65
  230. package/docs/src/core/components/ui/group/group.md +0 -75
  231. package/docs/src/core/components/ui/icon/icon.md +0 -214
  232. package/docs/src/core/components/ui/icon/icons.json +0 -1
  233. package/docs/src/core/components/ui/image/image.md +0 -233
  234. package/docs/src/core/components/ui/link/link.md +0 -81
  235. package/docs/src/core/components/ui/loader/loader.md +0 -112
  236. package/docs/src/core/components/ui/menu/menu.md +0 -370
  237. package/docs/src/core/components/ui/modal/modal.md +0 -235
  238. package/docs/src/core/components/ui/pop/pop.md +0 -294
  239. package/docs/src/core/components/ui/progress/progress.md +0 -109
  240. package/docs/src/core/components/ui/table/table.md +0 -431
  241. package/docs/src/core/components/ui/theme/theme.md +0 -122
  242. package/docs/src/core/components/ui/toast/toast.md +0 -216
  243. package/docs/src/core/components/ui/tooltip/tooltip.md +0 -124
  244. package/docs/src/docs/_core-concept/dataFlow.md +0 -88
  245. package/docs/src/docs/_core-concept/overview.md +0 -57
  246. package/docs/src/docs/_core-concept/subscriber.md +0 -75
  247. package/docs/src/docs/_decorators/ancestor-attribute.md +0 -128
  248. package/docs/src/docs/_decorators/auto-subscribe.md +0 -202
  249. package/docs/src/docs/_decorators/bind.md +0 -167
  250. package/docs/src/docs/_decorators/get.md +0 -162
  251. package/docs/src/docs/_decorators/handle.md +0 -175
  252. package/docs/src/docs/_decorators/on-assign.md +0 -390
  253. package/docs/src/docs/_decorators/patch.md +0 -70
  254. package/docs/src/docs/_decorators/post.md +0 -146
  255. package/docs/src/docs/_decorators/publish.md +0 -55
  256. package/docs/src/docs/_decorators/put.md +0 -70
  257. package/docs/src/docs/_decorators/subscribe.md +0 -100
  258. package/docs/src/docs/_decorators/wait-for-ancestors.md +0 -163
  259. package/docs/src/docs/_directives/sub.md +0 -91
  260. package/docs/src/docs/_getting-started/ai-agents.md +0 -76
  261. package/docs/src/docs/_getting-started/concorde-manual-install.md +0 -133
  262. package/docs/src/docs/_getting-started/concorde-outside.md +0 -33
  263. package/docs/src/docs/_getting-started/create-a-component.md +0 -139
  264. package/docs/src/docs/_getting-started/my-first-component.md +0 -236
  265. package/docs/src/docs/_getting-started/my-first-subscriber.md +0 -120
  266. package/docs/src/docs/_getting-started/pubsub.md +0 -37
  267. package/docs/src/docs/_getting-started/start.md +0 -47
  268. package/docs/src/docs/_getting-started/theming.md +0 -253
  269. package/docs/src/docs/_misc/api-configuration.md +0 -81
  270. package/docs/src/docs/_misc/dataProviderKey.md +0 -168
  271. package/docs/src/docs/_misc/docs-mock-api.md +0 -63
  272. package/docs/src/docs/_misc/dynamic-path.md +0 -71
  273. package/docs/src/docs/_misc/endpoint.md +0 -45
  274. package/docs/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  275. package/docs/src/docs/_misc/html-integration.md +0 -15
  276. package/docs/src/docs/search/docs-search.json +0 -12242
  277. package/docs/src/tag-list.json +0 -1
  278. package/docs/src/tsconfig-model.json +0 -23
  279. package/docs/src/tsconfig.json +0 -1242
  280. package/src/docs/prism/index.ts +0 -6
  281. package/src/docs/prism/prism.css +0 -158
  282. package/src/docs/prism/prism.js +0 -1022
@@ -1,205 +0,0 @@
1
- # Fieldset
2
-
3
- **`sonic-fieldset`** groups related form controls with a bordered container and an accessible **`<fieldset>`** semantics layer. Put fields in the **default slot**; add a title with **`sonic-legend`** or the shorthand **`label`** / **`description`** / **`iconName`** attributes. Default **`variant`** is `default`. Pair the body with **`sonic-form-layout`** for responsive columns.
4
-
5
- ## Basic example
6
-
7
- <sonic-code>
8
- <template>
9
- <sonic-fieldset>
10
- <sonic-legend label="Contact details"></sonic-legend>
11
- <sonic-form-layout>
12
- <sonic-input autocomplete="email" label="Email" name="email" type="email"></sonic-input>
13
- <sonic-input autocomplete="tel" label="Phone" name="phone" type="tel"></sonic-input>
14
- </sonic-form-layout>
15
- </sonic-fieldset>
16
- </template>
17
- </sonic-code>
18
-
19
- ## Variant
20
-
21
- **`ghost`** and **`shadow`** use a transparent border; **`shadow`** also applies **`--sc-shadow-lg`**.
22
-
23
- <sonic-code>
24
- <template>
25
- <div class="grid gap-4">
26
- <sonic-fieldset variant="default">
27
- <sonic-legend label="Default"></sonic-legend>
28
- <sonic-input label="Field" name="a"></sonic-input>
29
- </sonic-fieldset>
30
- <sonic-fieldset variant="ghost">
31
- <sonic-legend label="Ghost"></sonic-legend>
32
- <sonic-input label="Field" name="b"></sonic-input>
33
- </sonic-fieldset>
34
- <sonic-fieldset variant="shadow">
35
- <sonic-legend label="Shadow"></sonic-legend>
36
- <sonic-input label="Field" name="c"></sonic-input>
37
- </sonic-fieldset>
38
- </div>
39
- </template>
40
- </sonic-code>
41
-
42
- ## Tight layout
43
-
44
- Set **`tight`** to remove horizontal padding and side borders (flat strip inside a parent).
45
-
46
- <sonic-code>
47
- <template>
48
- <sonic-fieldset tight variant="ghost">
49
- <sonic-legend label="Tight fieldset"></sonic-legend>
50
- <sonic-input label="Field" name="tight"></sonic-input>
51
- </sonic-fieldset>
52
- </template>
53
- </sonic-code>
54
-
55
- ## Legend
56
-
57
- Use **`sonic-legend`** for the group title. Set **`label`** and **`description`** for simple copy, or use the **default slot** for custom markup. Add secondary text with **`sonic-legend-description`**. Place actions in **`slot="suffix"`** on the legend.
58
-
59
- Attribute values on **`sonic-legend`** are rendered as HTML—use only trusted content.
60
-
61
- <sonic-code>
62
- <template>
63
- <div class="grid gap-4">
64
- <sonic-fieldset>
65
- <sonic-legend label="Attributes" description="Short description via attributes"></sonic-legend>
66
- <sonic-input label="Field" name="attr"></sonic-input>
67
- </sonic-fieldset>
68
- <sonic-fieldset>
69
- <sonic-legend iconLibrary="iconoir" iconName="pin-alt">
70
- Custom title in the default slot
71
- <sonic-legend-description>Description via sonic-legend-description</sonic-legend-description>
72
- </sonic-legend>
73
- <sonic-input label="Field" name="slot"></sonic-input>
74
- </sonic-fieldset>
75
- </div>
76
- </template>
77
- </sonic-code>
78
-
79
- ## Shorthand legend on the fieldset
80
-
81
- When **`label`** is set on **`sonic-fieldset`**, the component renders **`sonic-legend`** for you. Pass **`description`** **`iconName`** **`iconLibrary`** and **`iconPrefix`** the same way. Do not combine shorthand **`label`** with a separate slotted **`sonic-legend`**—you will get two legends.
82
-
83
- <sonic-code>
84
- <template>
85
- <sonic-fieldset
86
- label="Account"
87
- description="Basic profile fields"
88
- iconLibrary="iconoir"
89
- iconName="user"
90
- >
91
- <sonic-input label="Display name" name="display_name"></sonic-input>
92
- </sonic-fieldset>
93
- </template>
94
- </sonic-code>
95
-
96
- ## Legend actions
97
-
98
- Use **`slot="suffix"`** on **`sonic-legend`** for menus or icon buttons aligned to the end of the legend row.
99
-
100
- <sonic-code>
101
- <template>
102
- <sonic-fieldset>
103
- <sonic-legend label="Personal information">
104
- <sonic-pop class="inline-block" slot="suffix">
105
- <sonic-button shape="circle" variant="ghost">
106
- <sonic-icon library="iconoir" size="lg" name="more-vert"></sonic-icon>
107
- </sonic-button>
108
- <sonic-menu slot="content" minWidth="12rem">
109
- <sonic-menu-item>Legal notice</sonic-menu-item>
110
- <sonic-menu-item>Terms of use</sonic-menu-item>
111
- </sonic-menu>
112
- </sonic-pop>
113
- </sonic-legend>
114
- <sonic-form-layout>
115
- <sonic-input autocomplete="family-name" label="Last name" name="last_name"></sonic-input>
116
- <sonic-input autocomplete="given-name" label="First name" name="first_name"></sonic-input>
117
- </sonic-form-layout>
118
- </sonic-fieldset>
119
- </template>
120
- </sonic-code>
121
-
122
- ## Form association and disabled state
123
-
124
- ### Associating a distant `form`
125
-
126
- Set **`form`** on **`sonic-fieldset`** to the **`id`** of a **`<form>`** elsewhere in the page (same as the native **`form`** attribute on **`<fieldset>`**). Named fields in the fieldset then belong to that form for submit and constraint validation—for example a toolbar **`form`** and a field group rendered lower on the layout.
127
-
128
- <sonic-code>
129
- <template>
130
- <div class="grid gap-4">
131
- <form id="billing-form" class="flex flex-wrap items-center gap-2">
132
- <sonic-button submit type="primary">Save billing</sonic-button>
133
- </form>
134
- <sonic-fieldset form="billing-form" label="Billing address">
135
- <sonic-form-layout>
136
- <sonic-input label="Street" name="street" autocomplete="street-address"></sonic-input>
137
- <sonic-input label="Postal code" required name="postal_code" autocomplete="postal-code"></sonic-input>
138
- <sonic-input label="City" name="city" autocomplete="address-level2"></sonic-input>
139
- </sonic-form-layout>
140
- </sonic-fieldset>
141
- </div>
142
- </template>
143
- </sonic-code>
144
-
145
- ### Disabling a group
146
-
147
- Set **`disabled`** on **`sonic-fieldset`** to disable the inner **`<fieldset>`** and every control in the group (same as a native fieldset). Use it for read-only steps or sections gated by permissions.
148
-
149
- <sonic-code>
150
- <template>
151
- <div class="grid gap-4">
152
- <sonic-fieldset label="Editable">
153
- <sonic-input label="Display name" name="display_name"></sonic-input>
154
- </sonic-fieldset>
155
- <sonic-fieldset label="Locked" disabled>
156
- <sonic-input label="Account ID" name="account_id" value="acct_42"></sonic-input>
157
- </sonic-fieldset>
158
- </div>
159
- </template>
160
- </sonic-code>
161
-
162
- ## Accessibility
163
-
164
- The inner **`<fieldset>`** carries grouping semantics. **`disabled`** is applied on that element so nested controls are disabled in the usual way. **`sonic-legend`** renders a native **`<legend>`** for the group label.
165
-
166
- ## API reference
167
-
168
- ### `sonic-fieldset`
169
-
170
- | Attribute | Values | Description |
171
- |----------|---------|-------------|
172
- | `variant` | `default` · `ghost` · `shadow` (default `default`) | Border and shadow treatment |
173
- | `tight` | boolean | Removes horizontal padding and side borders |
174
- | `label` | string | Shorthand legend title; renders **`sonic-legend`** when set |
175
- | `description` | string | Shorthand legend description (HTML) |
176
- | `iconName` | string | Shorthand legend icon **`name`** |
177
- | `iconLibrary` | string | Shorthand legend icon **`library`** |
178
- | `iconPrefix` | string | Shorthand legend icon **`prefix`** |
179
- | `disabled` | boolean | Disables the native **`<fieldset>`** and its controls |
180
- | `form` | string | **`id`** of an associated **`form`** |
181
- | `dataProvider` | string | Subscriber key; can autofill properties that match publisher fields (e.g. **`label`**) |
182
-
183
- | Slot | Description |
184
- |------|-------------|
185
- | *(default)* | Legend (optional) and field group content in visual order |
186
-
187
- ### `sonic-legend`
188
-
189
- | Attribute | Values | Description |
190
- |----------|---------|-------------|
191
- | `label` | string | Title HTML when not using the default slot |
192
- | `description` | string | Description HTML (wrapped in **`sonic-legend-description`**) |
193
- | `iconName` | string | Leading **`sonic-icon`** **`name`** |
194
- | `iconLibrary` | string | Icon **`library`** |
195
- | `iconPrefix` | string | Icon **`prefix`** |
196
- | `forceAutoFill` | boolean | Allows Subscriber autofill to override attribute-backed **`label`** / **`description`** |
197
-
198
- | Slot | Description |
199
- |------|-------------|
200
- | *(default)* | Legend title and description components |
201
- | `suffix` | Trailing actions (menus, icon buttons) |
202
-
203
- ### `sonic-legend-description`
204
-
205
- Muted description line below the legend title. No attributes—project content through the **default slot**.
@@ -1,100 +0,0 @@
1
- # Form actions
2
-
3
- **`sonic-form-actions`** lays out submit / cancel and other **form footer controls** in a **wrapping flex row** with a small fixed gap. Place it inside **`sonic-form-layout`** (full-width row) or any block that should end with actions. Defaults: **`direction`** `row` · **`justify`** `flex-start` · **`alignItems`** `center`.
4
-
5
- ## Basic example
6
-
7
- With no attributes, actions align to the **start** of the row (typical for left-to-right forms).
8
-
9
- <sonic-code>
10
- <template>
11
- <form>
12
- <sonic-form-layout>
13
- <sonic-input label="First name"></sonic-input>
14
- <sonic-input label="Last name"></sonic-input>
15
- <sonic-form-actions>
16
- <sonic-button type="success"><sonic-icon name="check" library="iconoir"></sonic-icon> Submit</sonic-button>
17
- <sonic-button type="danger" variant="ghost"><sonic-icon name="undo" library="iconoir"></sonic-icon> Cancel</sonic-button>
18
- </sonic-form-actions>
19
- </sonic-form-layout>
20
- </form>
21
- </template>
22
- </sonic-code>
23
-
24
- ## Justify content
25
-
26
- **`justify`** maps to CSS **`justify-content`**. Use **`flex-end`** for dialog-style footers or **`center`** for balanced toolbars.
27
-
28
- <sonic-code>
29
- <template>
30
- <form>
31
- <sonic-form-layout>
32
- <sonic-input label="First name"></sonic-input>
33
- <sonic-input label="Last name"></sonic-input>
34
- <sonic-form-actions justify="flex-end">
35
- <sonic-button type="success"><sonic-icon name="check" library="iconoir"></sonic-icon> Submit</sonic-button>
36
- <sonic-button type="danger" variant="ghost"><sonic-icon name="undo" library="iconoir"></sonic-icon> Cancel</sonic-button>
37
- </sonic-form-actions>
38
- </sonic-form-layout>
39
- </form>
40
- </template>
41
- </sonic-code>
42
-
43
- ## Flex direction
44
-
45
- **`direction`** maps to **`flex-direction`**. **`row-reverse`** swaps visual order while keeping DOM order (focus order unchanged).
46
-
47
- <sonic-code>
48
- <template>
49
- <form>
50
- <sonic-form-layout>
51
- <sonic-input label="First name"></sonic-input>
52
- <sonic-input label="Last name"></sonic-input>
53
- <sonic-form-actions direction="row-reverse">
54
- <sonic-button type="success"><sonic-icon name="check" library="iconoir"></sonic-icon> Submit</sonic-button>
55
- <sonic-button type="danger" variant="ghost"><sonic-icon name="undo" library="iconoir"></sonic-icon> Cancel</sonic-button>
56
- </sonic-form-actions>
57
- </sonic-form-layout>
58
- </form>
59
- </template>
60
- </sonic-code>
61
-
62
- ## Mixed controls
63
-
64
- Combine **`sonic-button`** with **`sonic-divider vertical`** or other slotted content. Default **`alignItems`** `center` keeps unlike heights aligned on the cross axis.
65
-
66
- <sonic-code>
67
- <template>
68
- <form>
69
- <sonic-form-layout>
70
- <sonic-input label="First name"></sonic-input>
71
- <sonic-input label="Last name"></sonic-input>
72
- <sonic-form-actions justify="center">
73
- <sonic-button type="info" minWidth="12rem">
74
- <sonic-icon name="nav-arrow-left" library="iconoir" slot="prefix"></sonic-icon>
75
- Left seats
76
- </sonic-button>
77
- <sonic-divider vertical></sonic-divider>
78
- <sonic-button type="info" minWidth="12rem">
79
- <sonic-icon name="nav-arrow-right" library="iconoir" slot="suffix"></sonic-icon>
80
- Right seats
81
- </sonic-button>
82
- </sonic-form-actions>
83
- </sonic-form-layout>
84
- </form>
85
- </template>
86
- </sonic-code>
87
-
88
- ## API reference
89
-
90
- | Attribute | Values | Description |
91
- |----------|---------|-------------|
92
- | `direction` | `row` (default) · `column` · `row-reverse` · `column-reverse` | Main-axis layout of slotted controls |
93
- | `justify` | CSS justify-content (default `flex-start`) | Distribution along the main axis |
94
- | `alignItems` | CSS align-items (default `center`) | Cross-axis alignment when items differ in height |
95
-
96
- The component exposes a single unnamed slot; there are no named slots. Slotted nodes use the host’s flex **`gap`** (`0.3rem`) and **`flex-wrap`**.
97
-
98
- | Slot | Description |
99
- |------|-------------|
100
- | *(default)* | Footer actions (**`sonic-button`** and related controls) |
@@ -1,119 +0,0 @@
1
- # Form layout
2
-
3
- **`sonic-form-layout`** arranges slotted form controls in a **responsive CSS grid** with consistent vertical spacing. Pair **`sonic-input`** · **`sonic-select`** and **`sonic-input-autocomplete`** fields side by side when the host is wider than **440px**; **textareas**, **toggles**, **dividers**, and **`sonic-form-actions`** span the full width. Wrap a **`form`** or **`sonic-fieldset`** body—no attributes are required.
4
-
5
- ## Basic example
6
-
7
- Typical registration-style form: short fields flow in two columns on wide layouts; long or grouped blocks stay full width.
8
-
9
- <sonic-code>
10
- <template>
11
- <form>
12
- <sonic-form-layout>
13
- <sonic-input autocomplete="family-name" label="Last name" name="last_name"></sonic-input>
14
- <sonic-input autocomplete="given-name" label="First name" name="first_name"></sonic-input>
15
- <sonic-select autocomplete="sex" label="Gender" name="gender">
16
- <option value="" selected="selected">— Select —</option>
17
- <option value="prefer-not">Prefer not to say</option>
18
- <option value="male">Male</option>
19
- <option value="female">Female</option>
20
- </sonic-select>
21
- <sonic-input autocomplete="bday" label="Date of birth" name="birth_date" type="date"></sonic-input>
22
- <sonic-divider></sonic-divider>
23
- <sonic-input autocomplete="email" label="Email" name="email" type="email"></sonic-input>
24
- <sonic-input
25
- autocomplete="email"
26
- label="Confirm email"
27
- name="email_confirmation"
28
- type="email"
29
- ></sonic-input>
30
- <sonic-input autocomplete="new-password" label="Password" name="password" type="password"></sonic-input>
31
- <sonic-input
32
- autocomplete="new-password"
33
- label="Confirm password"
34
- name="password_confirmation"
35
- type="password"
36
- ></sonic-input>
37
- <sonic-divider></sonic-divider>
38
- <sonic-textarea label="Message" rows="5"></sonic-textarea>
39
- <sonic-switch>Enable optional feature</sonic-switch>
40
- <sonic-checkbox>Subscribe to newsletter</sonic-checkbox>
41
- <sonic-checkbox>
42
- I accept the
43
- <sonic-link href="#" class="underline">terms and conditions</sonic-link>
44
- </sonic-checkbox>
45
- <sonic-form-actions>
46
- <sonic-button type="success">Submit</sonic-button>
47
- </sonic-form-actions>
48
- </sonic-form-layout>
49
- </form>
50
- </template>
51
- </sonic-code>
52
-
53
- ## Responsive columns
54
-
55
- When the host **`offsetWidth`** is **greater than 440px**, the grid uses **two equal columns** with slightly larger gap (**1.75rem**). Below that breakpoint, fields stack in a **single column** (**1.5rem** gap).
56
-
57
- If the slot contains **exactly one** direct **`sonic-input`**, **`sonic-select`**, or **`sonic-input-autocomplete`**, the layout stays **one column** even above the breakpoint so a lone field does not sit in half an empty row.
58
-
59
- <sonic-code>
60
- <template>
61
- <div class="grid gap-8 md:grid-cols-2 mb-6">
62
- <div>
63
- <sonic-form-layout style="max-width: 20rem">
64
- <sonic-divider align="left">Narrow host (single column)</sonic-divider>
65
- <sonic-input label="Email" name="email_narrow" type="email"></sonic-input>
66
- <sonic-input label="Confirm email" name="email_confirm_narrow" type="email"></sonic-input>
67
- </sonic-form-layout>
68
- </div>
69
- </div>
70
- <div>
71
- <sonic-form-layout>
72
- <sonic-divider align="left">Wide host (two columns for inputs)</sonic-divider>
73
- <sonic-input label="Email" name="email_wide" type="email"></sonic-input>
74
- <sonic-input label="Confirm email" name="email_confirm_wide" type="email"></sonic-input>
75
- </sonic-form-layout>
76
- </div>
77
- </template>
78
- </sonic-code>
79
-
80
- ## Full-width slotted blocks
81
-
82
- Everything except **`sonic-input`**, **`sonic-select`**, **`sonic-input-autocomplete`**, and slotted elements with class **`form-item-container`** is assigned **`grid-column: 1 / -1`**. Use this for **`sonic-textarea`**, **`sonic-checkbox`**, **`sonic-switch`**, **`sonic-form-actions`**, **`sonic-divider`**, and similar blocks.
83
-
84
- Slotted **`sonic-divider`** sets **`--sc-divider-my: 0`** so divider spacing matches the grid rhythm. Slotted **`sonic-submit`** uses **`display: contents`** so submit controls participate in the grid without an extra wrapper box.
85
-
86
- <sonic-code>
87
- <template>
88
- <sonic-form-layout>
89
- <sonic-input label="Subject" name="subject"></sonic-input>
90
- <sonic-textarea label="Details" rows="4"></sonic-textarea>
91
- <sonic-form-actions>
92
- <sonic-button type="primary">Send</sonic-button>
93
- </sonic-form-actions>
94
- </sonic-form-layout>
95
- </template>
96
- </sonic-code>
97
-
98
- ## Custom column wrapper
99
-
100
- Add class **`form-item-container`** on a slotted wrapper (for example a **`div`**) when a field is not a direct **`sonic-input`** / **`sonic-select`** / **`sonic-input-autocomplete`** but should still share the two-column flow with short inputs.
101
-
102
- <sonic-code>
103
- <template>
104
- <sonic-form-layout>
105
- <sonic-input label="City" name="city"></sonic-input>
106
- <div class="form-item-container">
107
- <sonic-input label="Postal code" name="postal_code"></sonic-input>
108
- </div>
109
- </sonic-form-layout>
110
- </template>
111
- </sonic-code>
112
-
113
- ## API reference
114
-
115
- No public attributes — layout follows slotted children and host width.
116
-
117
- | Slot | Description |
118
- |------|-------------|
119
- | *(default)* | Form fields and blocks in visual order; column vs full-width rules apply per slotted tag or **`form-item-container`** class |
@@ -1,142 +0,0 @@
1
- # Input
2
-
3
- <sonic-button type="info" size="sm" target="_blank" href="https://www.w3schools.com/tags/tag_input.asp#midcontentadcontainer">
4
- <sonic-icon library="iconoir" name="open-new-window" slot="prefix" ></sonic-icon>
5
- Native attributes list
6
- </sonic-button>
7
-
8
- ## Label
9
- <sonic-code>
10
- <template>
11
- <sonic-input label="Label"></sonic-input>
12
- </template>
13
- </sonic-code>
14
-
15
- ## Placeholder
16
- <sonic-code>
17
- <template>
18
- <sonic-input placeholder="placeholder"></sonic-input>
19
- </template>
20
- </sonic-code>
21
-
22
- ## Value
23
- <sonic-code>
24
- <template>
25
- <sonic-input value="value"></sonic-input>
26
- </template>
27
- </sonic-code>
28
-
29
- ## Required
30
- <sonic-code>
31
- <template>
32
- <sonic-input required type="email" placeholder="you@email.com" label="Feedback on blur"></sonic-input>
33
- </template>
34
- </sonic-code>
35
-
36
- ## Description
37
- <sonic-code>
38
- <template>
39
- <sonic-input description="Description goes here" ></sonic-input>
40
- </template>
41
- </sonic-code>
42
-
43
- ## Type
44
- <sonic-button size="2xs" type="info" target="_blank" href="https://www.w3schools.com/html/html_form_input_types.asp">Liste des types</sonic-button>
45
-
46
- <sonic-code>
47
- <template>
48
- <div class="grid gap-3">
49
- <sonic-input type="text" label="Text">Text</sonic-input>
50
- <sonic-input type="email" label="Email" placeholder="plop@kiki.com"></sonic-input>
51
- <sonic-input type="password" label="Password"></sonic-input>
52
- <sonic-input type="date" label="Date"></sonic-input>
53
- <sonic-input type="number" label="Number"></sonic-input>
54
- <sonic-input type="color" label="Color" value="#ffff00"></sonic-input>
55
- </div>
56
- </template>
57
- </sonic-code>
58
-
59
- ## Size
60
- <sonic-code>
61
- <template>
62
- <div class="grid gap-3">
63
- <sonic-input size="2xs" value="2xs"></sonic-input>
64
- <sonic-input size="xs" value="xs"></sonic-input>
65
- <sonic-input size="sm" value="sm"></sonic-input>
66
- <sonic-input size="md" value="md"></sonic-input>
67
- <sonic-input value="default"></sonic-input>
68
- <sonic-input size="lg" value="lg"></sonic-input>
69
- <sonic-input size="xl" value="xl"></sonic-input>
70
- <sonic-input size="2xl" value="2xl"></sonic-input>
71
- </div>
72
- </template>
73
- </sonic-code>
74
-
75
- ## List
76
- <sonic-alert status="error" label="Non fonctionnel" class="mb-4"></sonic-alert>
77
-
78
- <sonic-code>
79
- <template>
80
- <sonic-input list="browsers"></sonic-input>
81
- <datalist id="browsers">
82
- <option value="Internet Explorer">
83
- <option value="Firefox">
84
- <option value="Google Chrome">
85
- <option value="Opera">
86
- <option value="Safari">
87
- </datalist>
88
- </template>
89
- </sonic-code>
90
-
91
- ## Prefix & suffix
92
-
93
- <sonic-code>
94
- <template>
95
- <div class="grid grid-cols-2 gap-3">
96
- <sonic-input type="search" label="Search" placeholder="Search plane">
97
- <sonic-icon library="iconoir" name="search" slot="prefix"></sonic-icon>
98
- </sonic-input>
99
- <sonic-input type="number" label="Amount" placeholder="0">
100
- <sonic-icon library="iconoir" name="euro" slot="suffix"></sonic-icon>
101
- </sonic-input>
102
- </div>
103
- </template>
104
- </sonic-code>
105
-
106
- ## InlineContent
107
-
108
- <sonic-code>
109
- <template>
110
- <div class="grid grid-cols-2 gap-3">
111
- <sonic-input inlineContent type="search" label="Search icon in input" placeholder="Search plane">
112
- <sonic-icon library="iconoir" name="search" slot="prefix"></sonic-icon>
113
- </sonic-input>
114
- <sonic-input inlineContent type="number" label="Number of seats" placeholder="0">
115
- <div slot="suffix" class="flex gap-2 items-center">
116
- <sonic-badge type="danger" size="sm">4 max</sonic-badge>
117
- <sonic-icon library="iconoir" name="euro" ></sonic-icon>
118
- </div>
119
- </sonic-input>
120
- </div>
121
- </template>
122
- </sonic-code>
123
-
124
-
125
-
126
- ## Example of use — search + queue
127
-
128
- Filter with **`formDataProvider`** + **`name="contains"`** (mock API: substring on joke text). Caption and rows via Lit (`@subscribe`, `.items` on `sonic-queue`):
129
-
130
- <docs-lit-demo for="docs-joke-search-demo"></docs-lit-demo>
131
-
132
-
133
- <sonic-code>
134
- <template>
135
- <sonic-input type="search" placeholder="Search plane" class="inline-block">
136
- </sonic-input>
137
- <sonic-button type="danger" label="Amount" placeholder="0">azdazd
138
- </sonic-button>
139
- </template>
140
- </sonic-code>
141
-
142
- <!-- <sonic-input type="password" inlineContent size="2xl"><span slot="suffix">PLOP</span></sonic-input> -->
@@ -1,29 +0,0 @@
1
- # Input-autocomplete
2
-
3
- Champ formulaire + suggestions via [queue](#core/components/functional/queue/queue.md/queue). Valeur via `formDataProvider` + `name` ; la recherche filtre la queue (store interne).
4
-
5
- Rendu des lignes : propriété **`.items`** (callback Lit) — voir les démos ci-dessous. Mock : `serviceURL="/docs-mock-api/geo/"`.
6
-
7
- ## Simple
8
-
9
- `name` = paramètre de recherche = valeur formulaire.
10
-
11
- <docs-lit-demo for="docs-input-autocomplete-basic-demo"></docs-lit-demo>
12
-
13
- ## Valeur ≠ paramètre de recherche
14
-
15
- Recherche sur `nom`, valeur formulaire = `code`. Préremplissage via `value`.
16
-
17
- <docs-lit-demo for="docs-input-autocomplete-code-demo"></docs-lit-demo>
18
-
19
- ## Mode select
20
-
21
- À la fermeture du pop, seule une valeur de la liste (ou vide) est conservée.
22
-
23
- <docs-lit-demo for="docs-input-autocomplete-select-demo"></docs-lit-demo>
24
-
25
- ## Navigation clavier
26
-
27
- `data-keyboard-nav` sur le champ et les items (flèches haut / bas).
28
-
29
- <docs-lit-demo for="docs-input-autocomplete-keyboard-demo"></docs-lit-demo>
@@ -1,57 +0,0 @@
1
- # Radio
2
-
3
- ## Size
4
- <sonic-code>
5
- <template>
6
- <div class="grid gap-2" formDataProvider="radioSizeExemple">
7
- <sonic-radio name="size" value="2xs" size="2xs">2xs radio</sonic-radio>
8
- <sonic-radio name="size" value="xs" size="xs">xs radio</sonic-radio>
9
- <sonic-radio name="size" value="sm" size="sm">sm radio</sonic-radio>
10
- <sonic-radio name="size" value="default" >default radio</sonic-radio>
11
- <sonic-radio name="size" value="lg" size="lg">lg radio</sonic-radio>
12
- <sonic-radio name="size" value="xl" size="xl">xl radio</sonic-radio>
13
- <sonic-radio name="size" value="2xl" size="2xl">2xl radio</sonic-radio>
14
- </div>
15
- </template>
16
- </sonic-code>
17
-
18
- ## Checked
19
- <sonic-code>
20
- <template>
21
- <sonic-radio checked
22
- >Already checked radio
23
- </sonic-radio>
24
- </template>
25
- </sonic-code>
26
-
27
- ## Disabled
28
- <sonic-code>
29
- <template>
30
- <sonic-radio disabled
31
- >Disabled radio
32
- </sonic-radio>
33
- </template>
34
- </sonic-code>
35
-
36
- ## Disabled and checked
37
- <sonic-code>
38
- <template>
39
- <sonic-radio disabled checked
40
- >Disabled but already checked radio
41
- </sonic-radio>
42
- </template>
43
- </sonic-code>
44
-
45
- ## radio with link
46
- <sonic-code>
47
- <template>
48
- <sonic-radio name="link" value="link">radio with <sonic-link href="#" class="underline text-info">link</sonic-link>
49
- </template>
50
- </sonic-code>
51
-
52
-
53
- ## Example of use — blacklist + queue
54
-
55
- Same mock filter as [Checkbox](#core/components/ui/form/checkbox/checkbox.md/checkbox) (`blacklistFlags` query param). Radio sends **one** flag at a time.
56
-
57
- <docs-lit-demo for="docs-joke-blacklist-radio-demo"></docs-lit-demo>