@supersoniks/concorde 5.1.0 → 5.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (628) hide show
  1. package/.agents/skills/concorde-docs/SKILL.md +153 -0
  2. package/.agents/skills/{concorde-component-docs/template.md → concorde-docs/templates/component.md} +6 -2
  3. package/.agents/skills/concorde-docs/templates/decorator.md +43 -0
  4. package/.agents/skills/concorde-docs/templates/guide.md +25 -0
  5. package/.claude/launch.json +15 -0
  6. package/.claude/vite.http.config.mjs +7 -0
  7. package/.taste-skill/after/desktop-fold.jpg +0 -0
  8. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  9. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  10. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  11. package/.taste-skill/after/mobile-fold.jpg +0 -0
  12. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  13. package/.taste-skill/after/report.json +4103 -0
  14. package/.taste-skill/after/tablet-fold.jpg +0 -0
  15. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  16. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  17. package/.taste-skill/before/desktop-fold.jpg +0 -0
  18. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  19. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  20. package/.taste-skill/before/mobile-fold.jpg +0 -0
  21. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  22. package/.taste-skill/before/report.json +2556 -0
  23. package/.taste-skill/before/tablet-fold.jpg +0 -0
  24. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  25. package/.taste-skill/direction.json +510 -0
  26. package/.taste-skill/notes.md +84 -0
  27. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  28. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  29. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  30. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  31. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  32. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  33. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  34. package/.taste-skill/prod/report.json +1973 -0
  35. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  36. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  37. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  38. package/.tmp-cem/custom-elements.json +2013 -2013
  39. package/AUDIT.md +228 -0
  40. package/PLAN-AMELIORATION.md +220 -0
  41. package/PLAN-DOCS-AGENTS.md +80 -0
  42. package/README.md +3 -3
  43. package/ai/skills/concorde/SKILL.md +1 -1
  44. package/ai/skills/concorde-get-set-dp/SKILL.md +3 -3
  45. package/ai/skills/concorde-theme/SKILL.md +1 -1
  46. package/build-infos.json +1 -1
  47. package/concorde-core.bundle.js +16 -16
  48. package/concorde-core.es.js +235 -233
  49. package/dist/concorde-core.bundle.js +16 -16
  50. package/dist/concorde-core.es.js +235 -233
  51. package/dist/img/archive/concorde-001-2cv.webp +0 -0
  52. package/dist/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  53. package/dist/img/archive/concorde-red-arrows-2002.webm +0 -0
  54. package/dist/img/archive/credits.json +28 -0
  55. package/docs/.htaccess +75 -0
  56. package/docs/404.html +15 -0
  57. package/docs/404.md +5 -0
  58. package/docs/assets/index-BgG6FFPt.js +11765 -0
  59. package/docs/assets/index-x89XINSG.css +1 -0
  60. package/docs/core/components/functional/date/date.html +211 -0
  61. package/docs/core/components/functional/date/date.md +150 -0
  62. package/docs/core/components/functional/fetch/fetch.html +180 -0
  63. package/docs/core/components/functional/fetch/fetch.md +108 -0
  64. package/docs/core/components/functional/if/if.html +65 -0
  65. package/docs/core/components/functional/if/if.md +34 -0
  66. package/docs/core/components/functional/jsonata/jsonata.html +110 -0
  67. package/docs/core/components/functional/jsonata/jsonata.md +61 -0
  68. package/docs/core/components/functional/list/list.html +198 -0
  69. package/docs/core/components/functional/list/list.md +121 -0
  70. package/docs/core/components/functional/mix/mix.html +78 -0
  71. package/docs/core/components/functional/mix/mix.md +46 -0
  72. package/docs/core/components/functional/queue/queue.html +155 -0
  73. package/docs/core/components/functional/queue/queue.md +51 -0
  74. package/docs/core/components/functional/router/router.html +154 -0
  75. package/docs/core/components/functional/router/router.md +93 -0
  76. package/docs/core/components/functional/sdui/sdui-extension-points.html +127 -0
  77. package/docs/core/components/functional/sdui/sdui-extension-points.md +94 -0
  78. package/docs/core/components/functional/sdui/sdui.html +397 -0
  79. package/docs/core/components/functional/sdui/sdui.md +307 -0
  80. package/docs/core/components/functional/states/states.html +141 -0
  81. package/docs/core/components/functional/states/states.md +112 -0
  82. package/docs/core/components/functional/submit/submit.html +178 -0
  83. package/docs/core/components/functional/submit/submit.md +106 -0
  84. package/docs/{crawl/core → core}/components/functional/subscriber/subscriber.html +6 -5
  85. package/docs/core/components/functional/subscriber/subscriber.md +91 -0
  86. package/docs/core/components/functional/translation/translation.html +60 -0
  87. package/docs/core/components/functional/translation/translation.md +38 -0
  88. package/docs/core/components/functional/value/value.html +81 -0
  89. package/docs/core/components/functional/value/value.md +47 -0
  90. package/docs/core/components/ui/alert/alert.html +201 -0
  91. package/docs/core/components/ui/alert/alert.md +186 -0
  92. package/docs/core/components/ui/alert-messages/alert-messages.html +132 -0
  93. package/docs/core/components/ui/alert-messages/alert-messages.md +85 -0
  94. package/docs/core/components/ui/badge/badge.html +197 -0
  95. package/docs/core/components/ui/badge/badge.md +181 -0
  96. package/docs/core/components/ui/button/button.html +309 -0
  97. package/docs/core/components/ui/button/button.md +216 -0
  98. package/docs/core/components/ui/captcha/captcha.html +80 -0
  99. package/docs/core/components/ui/captcha/captcha.md +56 -0
  100. package/docs/core/components/ui/card/card.html +254 -0
  101. package/docs/core/components/ui/card/card.md +215 -0
  102. package/docs/core/components/ui/divider/divider.html +144 -0
  103. package/docs/core/components/ui/divider/divider.md +126 -0
  104. package/docs/core/components/ui/form/checkbox/checkbox.html +200 -0
  105. package/docs/core/components/ui/form/checkbox/checkbox.md +125 -0
  106. package/docs/core/components/ui/form/fieldset/fieldset.html +238 -0
  107. package/docs/core/components/ui/form/fieldset/fieldset.md +161 -0
  108. package/docs/core/components/ui/form/form-actions/form-actions.html +122 -0
  109. package/docs/core/components/ui/form/form-actions/form-actions.md +98 -0
  110. package/docs/core/components/ui/form/form-layout/form-layout.html +115 -0
  111. package/docs/core/components/ui/form/form-layout/form-layout.md +109 -0
  112. package/docs/core/components/ui/form/input/input.html +235 -0
  113. package/docs/core/components/ui/form/input/input.md +142 -0
  114. package/docs/core/components/ui/form/radio/radio.html +144 -0
  115. package/docs/core/components/ui/form/radio/radio.md +78 -0
  116. package/docs/core/components/ui/form/select/select.html +178 -0
  117. package/docs/core/components/ui/form/select/select.md +86 -0
  118. package/docs/core/components/ui/form/switch/switch.html +146 -0
  119. package/docs/core/components/ui/form/switch/switch.md +80 -0
  120. package/docs/core/components/ui/form/textarea/textarea.html +162 -0
  121. package/docs/core/components/ui/form/textarea/textarea.md +82 -0
  122. package/docs/core/components/ui/group/group.html +113 -0
  123. package/docs/core/components/ui/group/group.md +77 -0
  124. package/docs/core/components/ui/icon/icon.html +223 -0
  125. package/docs/core/components/ui/icon/icon.md +214 -0
  126. package/docs/core/components/ui/image/image.html +194 -0
  127. package/docs/core/components/ui/image/image.md +167 -0
  128. package/docs/core/components/ui/link/link.html +101 -0
  129. package/docs/core/components/ui/link/link.md +81 -0
  130. package/docs/core/components/ui/loader/loader.html +114 -0
  131. package/docs/core/components/ui/loader/loader.md +87 -0
  132. package/docs/{crawl/core → core}/components/ui/menu/menu.html +189 -116
  133. package/docs/core/components/ui/menu/menu.md +370 -0
  134. package/docs/core/components/ui/modal/modal.html +324 -0
  135. package/docs/core/components/ui/modal/modal.md +211 -0
  136. package/docs/core/components/ui/pop/pop.html +250 -0
  137. package/docs/core/components/ui/pop/pop.md +216 -0
  138. package/docs/core/components/ui/progress/progress.html +132 -0
  139. package/docs/core/components/ui/progress/progress.md +109 -0
  140. package/docs/core/components/ui/table/table.html +333 -0
  141. package/docs/core/components/ui/table/table.md +267 -0
  142. package/docs/core/components/ui/theme/theme.html +116 -0
  143. package/docs/core/components/ui/theme/theme.md +97 -0
  144. package/docs/core/components/ui/toast/toast.html +185 -0
  145. package/docs/core/components/ui/toast/toast.md +147 -0
  146. package/docs/core/components/ui/tooltip/tooltip.html +112 -0
  147. package/docs/core/components/ui/tooltip/tooltip.md +89 -0
  148. package/docs/docs/decorators/ancestor-attribute.html +71 -0
  149. package/docs/docs/decorators/ancestor-attribute.md +59 -0
  150. package/docs/docs/decorators/auto-subscribe.html +61 -0
  151. package/docs/docs/decorators/auto-subscribe.md +40 -0
  152. package/docs/docs/decorators/bind.html +86 -0
  153. package/docs/docs/decorators/bind.md +77 -0
  154. package/docs/docs/decorators/get.html +166 -0
  155. package/docs/docs/decorators/get.md +160 -0
  156. package/docs/docs/decorators/handle.html +139 -0
  157. package/docs/docs/decorators/handle.md +119 -0
  158. package/docs/docs/decorators/on-assign.html +72 -0
  159. package/docs/docs/decorators/on-assign.md +63 -0
  160. package/docs/docs/decorators/patch.html +76 -0
  161. package/docs/docs/decorators/patch.md +44 -0
  162. package/docs/docs/decorators/post.html +150 -0
  163. package/docs/docs/decorators/post.md +134 -0
  164. package/docs/docs/decorators/publish.html +74 -0
  165. package/docs/docs/decorators/publish.md +56 -0
  166. package/docs/docs/decorators/put.html +83 -0
  167. package/docs/docs/decorators/put.md +51 -0
  168. package/docs/docs/decorators/subscribe.html +91 -0
  169. package/docs/docs/decorators/subscribe.md +87 -0
  170. package/docs/docs/decorators/wait-for-ancestors.html +82 -0
  171. package/docs/docs/decorators/wait-for-ancestors.md +76 -0
  172. package/docs/docs/directives/sub.html +79 -0
  173. package/docs/docs/directives/sub.md +75 -0
  174. package/docs/docs/directives/t.html +91 -0
  175. package/docs/docs/directives/t.md +73 -0
  176. package/docs/{crawl/docs/_getting-started → docs/getting-started}/ai-agents.html +12 -11
  177. package/{src/docs/_getting-started → docs/docs/getting-started}/ai-agents.md +3 -3
  178. package/docs/docs/getting-started/components.html +27 -0
  179. package/docs/docs/getting-started/components.md +5 -0
  180. package/docs/{crawl/docs/_getting-started → docs/getting-started}/create-a-component.html +11 -14
  181. package/docs/{src/docs/_getting-started → docs/getting-started}/create-a-component.md +3 -6
  182. package/docs/{crawl/docs/_core-concept → docs/getting-started}/dataFlow.html +26 -29
  183. package/docs/{src/docs/_core-concept → docs/getting-started}/dataFlow.md +17 -18
  184. package/docs/docs/getting-started/installation.html +69 -0
  185. package/docs/docs/getting-started/installation.md +36 -0
  186. package/docs/{crawl/docs/_getting-started → docs/getting-started}/my-first-component.html +13 -22
  187. package/docs/{src/docs/_getting-started → docs/getting-started}/my-first-component.md +5 -14
  188. package/docs/docs/getting-started/start.html +47 -0
  189. package/{src/docs/_getting-started → docs/docs/getting-started}/start.md +1 -13
  190. package/docs/docs/getting-started/theming.html +334 -0
  191. package/{src/docs/_getting-started → docs/docs/getting-started}/theming.md +2 -2
  192. package/docs/docs/index.html +99 -0
  193. package/docs/{crawl/docs/_misc → docs/misc}/api-configuration.html +18 -18
  194. package/docs/{src/docs/_misc → docs/misc}/api-configuration.md +10 -12
  195. package/docs/{crawl/docs/_misc → docs/misc}/dataProviderKey.html +12 -11
  196. package/{src/docs/_misc → docs/docs/misc}/dataProviderKey.md +4 -4
  197. package/docs/{crawl/docs/_misc → docs/misc}/docs-mock-api.html +25 -28
  198. package/docs/{src/docs/_misc → docs/misc}/docs-mock-api.md +12 -13
  199. package/docs/{crawl/docs/_misc → docs/misc}/dynamic-path.html +16 -15
  200. package/{src/docs/_misc → docs/docs/misc}/dynamic-path.md +8 -8
  201. package/docs/{crawl/docs/_misc → docs/misc}/endpoint.html +16 -15
  202. package/{src/docs/_misc → docs/docs/misc}/endpoint.md +8 -8
  203. package/docs/{crawl/docs/_misc → docs/misc}/html-integration.html +12 -15
  204. package/docs/{src/docs/_misc → docs/misc}/html-integration.md +4 -5
  205. package/docs/docs-mock-api-sw.js +60 -223
  206. package/docs/docs-mock-api-sw.js.map +4 -4
  207. package/docs/hubs/decorators.html +443 -0
  208. package/docs/hubs/form-components.html +404 -0
  209. package/docs/hubs/remote-data.html +371 -0
  210. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  211. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  212. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  213. package/docs/img/archive/credits.json +28 -0
  214. package/docs/img/concorde/plane_01.jpg +0 -0
  215. package/docs/img/concorde/plane_02.jpg +0 -0
  216. package/docs/img/concorde/plane_03.jpg +0 -0
  217. package/docs/img/concorde/plane_04.jpg +0 -0
  218. package/docs/img/concorde/plane_05.jpg +0 -0
  219. package/docs/img/concorde/plane_06.jpg +0 -0
  220. package/docs/img/concorde/plane_07.jpg +0 -0
  221. package/docs/img/concorde/plane_08.jpg +0 -0
  222. package/docs/img/concorde/plane_09.jpg +0 -0
  223. package/docs/img/concorde/plane_10.jpg +0 -0
  224. package/docs/img/concorde/plane_11.jpg +0 -0
  225. package/docs/img/concorde/plane_12.jpg +0 -0
  226. package/docs/img/concorde/plane_13.jpg +0 -0
  227. package/docs/index.html +96 -67
  228. package/docs/index.md +22 -0
  229. package/docs/llms-full.txt +3329 -3295
  230. package/docs/llms.txt +94 -92
  231. package/docs/robots.txt +11 -10
  232. package/docs/sitemap.xml +78 -78
  233. package/docs/src/core/components/functional/date/date.md +91 -231
  234. package/docs/src/core/components/functional/fetch/fetch.md +66 -83
  235. package/docs/src/core/components/functional/if/if.md +28 -3
  236. package/docs/src/core/components/functional/jsonata/jsonata.md +42 -37
  237. package/docs/src/core/components/functional/list/list.md +99 -43
  238. package/docs/src/core/components/functional/mix/mix.md +31 -26
  239. package/docs/src/core/components/functional/queue/queue.md +40 -61
  240. package/docs/src/core/components/functional/router/router.md +64 -65
  241. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  242. package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
  243. package/docs/src/core/components/functional/sdui/example.json +19 -86
  244. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  245. package/docs/src/core/components/functional/sdui/sdui.md +196 -245
  246. package/docs/src/core/components/functional/states/states.md +86 -61
  247. package/docs/src/core/components/functional/submit/submit.md +64 -72
  248. package/docs/src/core/components/functional/translation/translation.md +38 -0
  249. package/docs/src/core/components/functional/value/value.md +34 -22
  250. package/docs/src/core/components/ui/alert/alert.md +139 -74
  251. package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
  252. package/docs/src/core/components/ui/badge/badge.md +137 -83
  253. package/docs/src/core/components/ui/button/button.md +139 -105
  254. package/docs/src/core/components/ui/captcha/captcha.md +50 -6
  255. package/docs/src/core/components/ui/card/card.md +183 -65
  256. package/docs/src/core/components/ui/divider/divider.md +104 -13
  257. package/docs/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  258. package/docs/src/core/components/ui/form/fieldset/fieldset.md +135 -103
  259. package/docs/src/core/components/ui/form/form-actions/form-actions.md +71 -50
  260. package/docs/src/core/components/ui/form/form-layout/form-layout.md +99 -34
  261. package/docs/src/core/components/ui/form/input/input.md +95 -95
  262. package/docs/src/core/components/ui/form/radio/radio.md +55 -34
  263. package/docs/src/core/components/ui/form/select/select.md +60 -45
  264. package/docs/src/core/components/ui/form/switch/switch.md +57 -34
  265. package/docs/src/core/components/ui/form/textarea/textarea.md +55 -38
  266. package/docs/src/core/components/ui/group/group.md +49 -47
  267. package/docs/src/core/components/ui/icon/icon.md +132 -43
  268. package/docs/src/core/components/ui/image/image.md +132 -72
  269. package/docs/src/core/components/ui/link/link.md +46 -8
  270. package/docs/src/core/components/ui/loader/loader.md +55 -23
  271. package/docs/src/core/components/ui/menu/menu.md +155 -114
  272. package/docs/src/core/components/ui/modal/modal.md +154 -62
  273. package/docs/src/core/components/ui/pop/pop.md +185 -65
  274. package/docs/src/core/components/ui/progress/progress.md +76 -30
  275. package/docs/src/core/components/ui/table/table.md +146 -334
  276. package/docs/src/core/components/ui/theme/theme.md +97 -0
  277. package/docs/src/core/components/ui/toast/toast.md +80 -99
  278. package/docs/src/core/components/ui/tooltip/tooltip.md +52 -45
  279. package/docs/src/docs/decorators/ancestor-attribute.md +59 -0
  280. package/docs/src/docs/decorators/auto-subscribe.md +40 -0
  281. package/docs/src/docs/decorators/bind.md +77 -0
  282. package/docs/src/docs/decorators/get.md +160 -0
  283. package/docs/src/docs/decorators/handle.md +119 -0
  284. package/docs/src/docs/decorators/on-assign.md +63 -0
  285. package/docs/src/docs/decorators/patch.md +44 -0
  286. package/docs/src/docs/decorators/post.md +134 -0
  287. package/docs/src/docs/decorators/publish.md +56 -0
  288. package/docs/src/docs/decorators/put.md +51 -0
  289. package/docs/src/docs/decorators/subscribe.md +87 -0
  290. package/docs/src/docs/decorators/wait-for-ancestors.md +76 -0
  291. package/docs/src/docs/directives/sub.md +75 -0
  292. package/docs/src/docs/directives/t.md +73 -0
  293. package/docs/src/docs/{_getting-started → getting-started}/ai-agents.md +3 -3
  294. package/docs/src/docs/getting-started/components.md +5 -0
  295. package/{src/docs/_getting-started → docs/src/docs/getting-started}/create-a-component.md +3 -6
  296. package/{src/docs/_core-concept → docs/src/docs/getting-started}/dataFlow.md +17 -18
  297. package/docs/src/docs/getting-started/installation.md +36 -0
  298. package/{src/docs/_getting-started → docs/src/docs/getting-started}/my-first-component.md +5 -14
  299. package/docs/src/docs/getting-started/start.md +35 -0
  300. package/docs/src/docs/getting-started/theming.md +253 -0
  301. package/{src/docs/_misc → docs/src/docs/misc}/api-configuration.md +10 -12
  302. package/docs/src/docs/{_misc → misc}/dataProviderKey.md +4 -4
  303. package/{src/docs/_misc → docs/src/docs/misc}/docs-mock-api.md +12 -13
  304. package/docs/src/docs/{_misc → misc}/dynamic-path.md +8 -8
  305. package/docs/src/docs/{_misc → misc}/endpoint.md +8 -8
  306. package/{src/docs/_misc → docs/src/docs/misc}/html-integration.md +4 -5
  307. package/docs/src/docs/search/docs-search.json +3729 -2949
  308. package/docs/src/tsconfig.json +176 -5
  309. package/index.html +94 -67
  310. package/package.json +11 -4
  311. package/public/docs-mock-api-sw.js +58 -223
  312. package/public/docs-mock-api-sw.js.map +4 -4
  313. package/public/img/archive/concorde-001-2cv.webp +0 -0
  314. package/public/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  315. package/public/img/archive/concorde-red-arrows-2002.webm +0 -0
  316. package/public/img/archive/credits.json +28 -0
  317. package/public/img/concorde/plane_01.jpg +0 -0
  318. package/public/img/concorde/plane_02.jpg +0 -0
  319. package/public/img/concorde/plane_03.jpg +0 -0
  320. package/public/img/concorde/plane_04.jpg +0 -0
  321. package/public/img/concorde/plane_05.jpg +0 -0
  322. package/public/img/concorde/plane_06.jpg +0 -0
  323. package/public/img/concorde/plane_07.jpg +0 -0
  324. package/public/img/concorde/plane_08.jpg +0 -0
  325. package/public/img/concorde/plane_09.jpg +0 -0
  326. package/public/img/concorde/plane_10.jpg +0 -0
  327. package/public/img/concorde/plane_11.jpg +0 -0
  328. package/public/img/concorde/plane_12.jpg +0 -0
  329. package/public/img/concorde/plane_13.jpg +0 -0
  330. package/public/robots.txt +11 -10
  331. package/scripts/docs-markdown-vite-plugin.ts +37 -0
  332. package/scripts/docs-public-url.mjs +50 -0
  333. package/scripts/docs.htaccess +75 -0
  334. package/scripts/generate-crawl-docs.mjs +207 -116
  335. package/scripts/generate-crawl-docs.test.mjs +124 -0
  336. package/scripts/post-build-docs.js +34 -50
  337. package/scripts/post-build.mjs +0 -0
  338. package/src/core/components/functional/date/date.md +91 -231
  339. package/src/core/components/functional/fetch/fetch.md +66 -83
  340. package/src/core/components/functional/if/if.md +28 -3
  341. package/src/core/components/functional/if/if.ts +0 -0
  342. package/src/core/components/functional/jsonata/jsonata.md +42 -37
  343. package/src/core/components/functional/list/list.demo.ts +0 -0
  344. package/src/core/components/functional/list/list.md +99 -43
  345. package/src/core/components/functional/mix/mix.md +31 -26
  346. package/src/core/components/functional/queue/queue.demo.ts +10 -7
  347. package/src/core/components/functional/queue/queue.md +40 -61
  348. package/src/core/components/functional/router/router.demo.ts +16 -16
  349. package/src/core/components/functional/router/router.md +64 -65
  350. package/src/core/components/functional/router/router.ts +0 -0
  351. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  352. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  353. package/src/core/components/functional/sdui/component-catalog.json +1 -1
  354. package/src/core/components/functional/sdui/example.json +19 -86
  355. package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  356. package/src/core/components/functional/sdui/sdui.md +187 -358
  357. package/src/core/components/functional/sdui/types.ts +0 -0
  358. package/src/core/components/functional/states/states.demo.ts +21 -22
  359. package/src/core/components/functional/states/states.md +86 -61
  360. package/src/core/components/functional/states/states.ts +1 -1
  361. package/src/core/components/functional/submit/submit.md +64 -72
  362. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  363. package/src/core/components/functional/translation/translation.md +38 -0
  364. package/src/core/components/functional/value/value.md +34 -22
  365. package/src/core/components/functional/value/value.ts +0 -0
  366. package/src/core/components/ui/_css/size.ts +0 -0
  367. package/src/core/components/ui/alert/alert.md +48 -58
  368. package/src/core/components/ui/badge/badge.md +27 -34
  369. package/src/core/components/ui/button/button.md +139 -106
  370. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  371. package/src/core/components/ui/captcha/captcha.md +17 -32
  372. package/src/core/components/ui/card/card.md +6 -6
  373. package/src/core/components/ui/divider/divider.md +8 -11
  374. package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  375. package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
  376. package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
  377. package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
  378. package/src/core/components/ui/form/input/input.md +95 -95
  379. package/src/core/components/ui/form/radio/radio.md +55 -34
  380. package/src/core/components/ui/form/select/select.md +60 -45
  381. package/src/core/components/ui/form/switch/switch.md +57 -34
  382. package/src/core/components/ui/form/textarea/textarea.md +55 -38
  383. package/src/core/components/ui/group/group.md +35 -33
  384. package/src/core/components/ui/icon/icon.md +4 -4
  385. package/src/core/components/ui/image/image.md +41 -107
  386. package/src/core/components/ui/link/link.md +6 -6
  387. package/src/core/components/ui/loader/loader.md +30 -55
  388. package/src/core/components/ui/menu/menu.md +27 -27
  389. package/src/core/components/ui/modal/modal.md +72 -96
  390. package/src/core/components/ui/modal/modal.ts +14 -11
  391. package/src/core/components/ui/pop/pop.md +80 -158
  392. package/src/core/components/ui/progress/progress.md +2 -2
  393. package/src/core/components/ui/table/table.md +91 -255
  394. package/src/core/components/ui/theme/theme.md +11 -36
  395. package/src/core/components/ui/toast/toast.md +48 -117
  396. package/src/core/components/ui/tooltip/tooltip.md +27 -62
  397. package/src/core/mixins/Subscriber.ts +0 -0
  398. package/src/core/utils/DataBindObserver.ts +0 -0
  399. package/src/core/utils/LocationHandler.spec.ts +80 -0
  400. package/src/core/utils/LocationHandler.ts +5 -9
  401. package/src/core/utils/Objects.ts +0 -0
  402. package/src/core/utils/route.ts +0 -0
  403. package/src/docs/code.ts +88 -75
  404. package/src/docs/components/docs-demo-sources.ts +70 -147
  405. package/src/docs/components/docs-lit-demo.ts +20 -40
  406. package/src/docs/components/docs-source-link.ts +0 -82
  407. package/src/docs/decorators/ancestor-attribute.md +59 -0
  408. package/src/docs/decorators/auto-subscribe.md +40 -0
  409. package/src/docs/decorators/bind.md +77 -0
  410. package/src/docs/decorators/get.md +160 -0
  411. package/src/docs/decorators/handle.md +119 -0
  412. package/src/docs/decorators/on-assign.md +63 -0
  413. package/src/docs/decorators/patch.md +44 -0
  414. package/src/docs/decorators/post.md +134 -0
  415. package/src/docs/decorators/publish.md +56 -0
  416. package/src/docs/decorators/put.md +51 -0
  417. package/src/docs/decorators/subscribe.md +87 -0
  418. package/src/docs/decorators/wait-for-ancestors.md +76 -0
  419. package/src/docs/directives/sub.md +75 -0
  420. package/src/docs/directives/t.md +73 -0
  421. package/src/docs/docs-location.spec.ts +46 -0
  422. package/src/docs/docs-location.ts +123 -32
  423. package/src/docs/docs.ts +6 -2
  424. package/src/docs/example/decorators-demo-bind-demos.ts +81 -116
  425. package/src/docs/example/decorators-demo-geo.ts +30 -19
  426. package/src/docs/example/decorators-demo-post.ts +88 -186
  427. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
  428. package/src/docs/example/decorators-demo.ts +85 -98
  429. package/src/docs/example/docs-api-config-demos.ts +19 -20
  430. package/src/docs/example/docs-boarding-pass-demo.ts +134 -0
  431. package/src/docs/example/docs-flight-demos.ts +147 -0
  432. package/src/docs/example/docs-jsonata-demos.ts +52 -52
  433. package/src/docs/example/docs-list-demos.ts +43 -123
  434. package/src/docs/example/docs-provider-keys.ts +33 -28
  435. package/src/docs/example/docs-queue-demos.ts +37 -77
  436. package/src/docs/example/docs-router-demos.ts +20 -25
  437. package/src/docs/example/docs-submit-demos.ts +48 -48
  438. package/src/docs/example/docs-toggle-demos.ts +4 -3
  439. package/src/docs/example/users.ts +0 -0
  440. package/src/docs/getting-started/ai-agents.md +76 -0
  441. package/src/docs/getting-started/components.md +5 -0
  442. package/src/docs/getting-started/create-a-component.md +136 -0
  443. package/src/docs/getting-started/dataFlow.md +87 -0
  444. package/src/docs/getting-started/installation.md +36 -0
  445. package/src/docs/getting-started/my-first-component.md +227 -0
  446. package/src/docs/getting-started/start.md +35 -0
  447. package/src/docs/getting-started/theming.md +253 -0
  448. package/src/docs/header/header.ts +240 -71
  449. package/src/docs/home/catalog.ts +44 -0
  450. package/src/docs/home/home.ts +520 -0
  451. package/src/docs/home/mach-stage.ts +389 -0
  452. package/src/docs/layout.ts +12 -11
  453. package/src/docs/misc/api-configuration.md +79 -0
  454. package/src/docs/misc/dataProviderKey.md +168 -0
  455. package/src/docs/misc/docs-mock-api.md +62 -0
  456. package/src/docs/misc/dynamic-path.md +71 -0
  457. package/src/docs/misc/endpoint.md +45 -0
  458. package/src/docs/misc/html-integration.md +14 -0
  459. package/src/docs/mock-api/api-config-mock.ts +5 -0
  460. package/src/docs/mock-api/fixtures.ts +0 -278
  461. package/src/docs/mock-api/flights.ts +89 -0
  462. package/src/docs/mock-api/router.ts +3 -4
  463. package/src/docs/mock-api/urls.ts +1 -2
  464. package/src/docs/navigation/components-index.ts +56 -0
  465. package/src/docs/navigation/navigation.ts +219 -232
  466. package/src/docs/navigation/pager.ts +67 -0
  467. package/src/docs/navigation/toc.ts +101 -0
  468. package/src/docs/search/docs-search.json +2419 -4374
  469. package/src/docs/search/markdown-renderer.ts +33 -7
  470. package/src/docs/search/page.ts +9 -6
  471. package/src/docs/search/search.ts +154 -122
  472. package/src/docs/shiki/index.ts +109 -0
  473. package/src/docs/tailwind/css/base/scrollbar.css +22 -0
  474. package/src/docs/tailwind/css/base/theme.css +96 -0
  475. package/src/docs/tailwind/css/base/typography.css +4 -0
  476. package/src/docs/tailwind/css/docs/boarding-pass.css +65 -0
  477. package/src/docs/tailwind/css/docs/content.css +32 -0
  478. package/src/docs/tailwind/css/docs/page.css +10 -0
  479. package/src/docs/tailwind/css/docs.css +9 -0
  480. package/src/docs/tailwind/css/home/hero.css +210 -0
  481. package/src/docs/tailwind/css/home/motion.css +84 -0
  482. package/src/docs/tailwind/css/home/sections.css +416 -0
  483. package/src/docs/tailwind/css/tailwind.css +7 -185
  484. package/src/tsconfig.json +23 -2
  485. package/src/tsconfig.tsbuildinfo +1 -1
  486. package/tailwind.config.js +8 -4
  487. package/vite.config.mts +11 -2
  488. package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
  489. package/.github/workflows/ci.yml +0 -21
  490. package/.github-export-ignore +0 -30
  491. package/CONTRIBUTING.md +0 -59
  492. package/DEV.md +0 -54
  493. package/LICENSE +0 -21
  494. package/OPEN_SOURCE_CHECKPOINT.md +0 -133
  495. package/concorde-3d.bundle.js +0 -3960
  496. package/concorde-3d.es.js +0 -33433
  497. package/concorde-hugging-face-infer.bundle.js +0 -32
  498. package/concorde-hugging-face-infer.es.js +0 -2952
  499. package/concorde-interactive.bundle.js +0 -1157
  500. package/concorde-interactive.es.js +0 -10734
  501. package/concorde-shader.bundle.js +0 -116
  502. package/concorde-shader.es.js +0 -8353
  503. package/concorde-webgpu.bundle.js +0 -307
  504. package/concorde-webgpu.es.js +0 -8627
  505. package/docs/assets/index-D8MVWqY6.js +0 -12251
  506. package/docs/assets/index-DiD0qYvE.css +0 -1
  507. package/docs/crawl/core/components/functional/date/date.html +0 -190
  508. package/docs/crawl/core/components/functional/fetch/fetch.html +0 -109
  509. package/docs/crawl/core/components/functional/if/if.html +0 -27
  510. package/docs/crawl/core/components/functional/jsonata/jsonata.html +0 -79
  511. package/docs/crawl/core/components/functional/list/list.html +0 -70
  512. package/docs/crawl/core/components/functional/mix/mix.html +0 -45
  513. package/docs/crawl/core/components/functional/queue/queue.html +0 -96
  514. package/docs/crawl/core/components/functional/router/router.html +0 -106
  515. package/docs/crawl/core/components/functional/sdui/sdui.html +0 -269
  516. package/docs/crawl/core/components/functional/states/states.html +0 -66
  517. package/docs/crawl/core/components/functional/submit/submit.html +0 -160
  518. package/docs/crawl/core/components/functional/value/value.html +0 -51
  519. package/docs/crawl/core/components/ui/alert/alert.html +0 -110
  520. package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +0 -23
  521. package/docs/crawl/core/components/ui/badge/badge.html +0 -119
  522. package/docs/crawl/core/components/ui/button/button.html +0 -149
  523. package/docs/crawl/core/components/ui/captcha/captcha.html +0 -30
  524. package/docs/crawl/core/components/ui/card/card.html +0 -99
  525. package/docs/crawl/core/components/ui/divider/divider.html +0 -58
  526. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +0 -73
  527. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +0 -135
  528. package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +0 -79
  529. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +0 -62
  530. package/docs/crawl/core/components/ui/form/input/input.html +0 -109
  531. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +0 -38
  532. package/docs/crawl/core/components/ui/form/radio/radio.html +0 -56
  533. package/docs/crawl/core/components/ui/form/select/select.html +0 -73
  534. package/docs/crawl/core/components/ui/form/switch/switch.html +0 -56
  535. package/docs/crawl/core/components/ui/form/textarea/textarea.html +0 -59
  536. package/docs/crawl/core/components/ui/group/group.html +0 -82
  537. package/docs/crawl/core/components/ui/icon/icon.html +0 -133
  538. package/docs/crawl/core/components/ui/image/image.html +0 -110
  539. package/docs/crawl/core/components/ui/link/link.html +0 -42
  540. package/docs/crawl/core/components/ui/loader/loader.html +0 -50
  541. package/docs/crawl/core/components/ui/modal/modal.html +0 -117
  542. package/docs/crawl/core/components/ui/pop/pop.html +0 -102
  543. package/docs/crawl/core/components/ui/progress/progress.html +0 -58
  544. package/docs/crawl/core/components/ui/table/table.html +0 -413
  545. package/docs/crawl/core/components/ui/toast/toast.html +0 -122
  546. package/docs/crawl/core/components/ui/tooltip/tooltip.html +0 -79
  547. package/docs/crawl/docs/_core-concept/overview.html +0 -66
  548. package/docs/crawl/docs/_core-concept/subscriber.html +0 -75
  549. package/docs/crawl/docs/_decorators/ancestor-attribute.html +0 -116
  550. package/docs/crawl/docs/_decorators/auto-subscribe.html +0 -202
  551. package/docs/crawl/docs/_decorators/bind.html +0 -141
  552. package/docs/crawl/docs/_decorators/get.html +0 -149
  553. package/docs/crawl/docs/_decorators/handle.html +0 -165
  554. package/docs/crawl/docs/_decorators/on-assign.html +0 -355
  555. package/docs/crawl/docs/_decorators/patch.html +0 -78
  556. package/docs/crawl/docs/_decorators/post.html +0 -139
  557. package/docs/crawl/docs/_decorators/publish.html +0 -61
  558. package/docs/crawl/docs/_decorators/put.html +0 -78
  559. package/docs/crawl/docs/_decorators/subscribe.html +0 -109
  560. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +0 -137
  561. package/docs/crawl/docs/_directives/sub.html +0 -93
  562. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +0 -100
  563. package/docs/crawl/docs/_getting-started/concorde-outside.html +0 -58
  564. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +0 -110
  565. package/docs/crawl/docs/_getting-started/pubsub.html +0 -62
  566. package/docs/crawl/docs/_getting-started/start.html +0 -76
  567. package/docs/crawl/docs/_getting-started/theming.html +0 -85
  568. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +0 -138
  569. package/docs/crawl/hubs/decorators.html +0 -547
  570. package/docs/crawl/hubs/form-components.html +0 -359
  571. package/docs/crawl/hubs/remote-data.html +0 -452
  572. package/docs/crawl/index.html +0 -101
  573. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  574. package/docs/src/docs/_core-concept/overview.md +0 -57
  575. package/docs/src/docs/_core-concept/subscriber.md +0 -75
  576. package/docs/src/docs/_decorators/ancestor-attribute.md +0 -127
  577. package/docs/src/docs/_decorators/auto-subscribe.md +0 -202
  578. package/docs/src/docs/_decorators/bind.md +0 -167
  579. package/docs/src/docs/_decorators/get.md +0 -162
  580. package/docs/src/docs/_decorators/handle.md +0 -175
  581. package/docs/src/docs/_decorators/on-assign.md +0 -390
  582. package/docs/src/docs/_decorators/patch.md +0 -70
  583. package/docs/src/docs/_decorators/post.md +0 -146
  584. package/docs/src/docs/_decorators/publish.md +0 -55
  585. package/docs/src/docs/_decorators/put.md +0 -70
  586. package/docs/src/docs/_decorators/subscribe.md +0 -100
  587. package/docs/src/docs/_decorators/wait-for-ancestors.md +0 -163
  588. package/docs/src/docs/_directives/sub.md +0 -91
  589. package/docs/src/docs/_getting-started/concorde-manual-install.md +0 -133
  590. package/docs/src/docs/_getting-started/concorde-outside.md +0 -33
  591. package/docs/src/docs/_getting-started/my-first-subscriber.md +0 -120
  592. package/docs/src/docs/_getting-started/pubsub.md +0 -37
  593. package/docs/src/docs/_getting-started/start.md +0 -47
  594. package/docs/src/docs/_getting-started/theming.md +0 -91
  595. package/docs/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  596. package/docs/src/tsconfig.declarations.json +0 -22
  597. package/docs/src/tsconfig.emit.json +0 -23
  598. package/gitlab/job_github_mirror.sh +0 -39
  599. package/scripts/github-export.mjs +0 -150
  600. package/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  601. package/src/css.d.ts +0 -19
  602. package/src/docs/_core-concept/overview.md +0 -57
  603. package/src/docs/_core-concept/subscriber.md +0 -75
  604. package/src/docs/_decorators/ancestor-attribute.md +0 -128
  605. package/src/docs/_decorators/auto-subscribe.md +0 -202
  606. package/src/docs/_decorators/bind.md +0 -167
  607. package/src/docs/_decorators/get.md +0 -162
  608. package/src/docs/_decorators/handle.md +0 -175
  609. package/src/docs/_decorators/on-assign.md +0 -390
  610. package/src/docs/_decorators/patch.md +0 -70
  611. package/src/docs/_decorators/post.md +0 -146
  612. package/src/docs/_decorators/publish.md +0 -55
  613. package/src/docs/_decorators/put.md +0 -70
  614. package/src/docs/_decorators/subscribe.md +0 -100
  615. package/src/docs/_decorators/wait-for-ancestors.md +0 -163
  616. package/src/docs/_directives/sub.md +0 -91
  617. package/src/docs/_getting-started/concorde-manual-install.md +0 -133
  618. package/src/docs/_getting-started/concorde-outside.md +0 -33
  619. package/src/docs/_getting-started/my-first-subscriber.md +0 -120
  620. package/src/docs/_getting-started/pubsub.md +0 -37
  621. package/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  622. package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
  623. package/src/docs/example/docs-joke-demos.ts +0 -297
  624. package/src/docs/prism/index.ts +0 -6
  625. package/src/docs/prism/prism.css +0 -158
  626. package/src/docs/prism/prism.js +0 -1022
  627. package/src/tsconfig.declarations.json +0 -22
  628. package/src/tsconfig.emit.json +0 -23
package/docs/core/components/functional/list/list.html ADDED
@@ -0,0 +1,198 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/functional/list" data-doc-id="core/components/functional/list/list">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>List — Concorde by Supersoniks</title>
7
+ <meta name="description" content="sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. From Lit, pass a row renderer on the items property; in plain HTML, declare &lt;template&gt; children. Each">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/functional/list/list, list, List, functional component, sonic-list, web component, props, fetch, items, , /list-item/, serviceURL, endPoint">
9
+ <meta name="concorde-doc-id" content="core/components/functional/list/list">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/core/components/functional/list">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/functional/list.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/functional/list">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 functional component — List</strong>. sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. From Lit, pass a row renderer on the items property; in plain HTML, declare &lt;template&gt; children. Each <span>Doc ID: <code>core/components/functional/list/list</code>. Keywords: Concorde, supersoniks, core/components/functional/list/list, list, List, functional component, sonic-list, web component, props, fetch, items, , /list-item/, serviceURL, endPoint. URL: <a href="https://concorde.supersoniks.org/core/components/functional/list">https://concorde.supersoniks.org/core/components/functional/list</a>.</span></p>
20
+ <h1 id="list">List</h1>
21
+ <p><strong><code>sonic-list</code></strong> renders one row per entry of its <code>props</code> array, either set directly or loaded with <code>fetch</code>. From Lit, pass a row renderer on the <code>items</code> property; in plain HTML, declare <code>&lt;template&gt;</code> children. Each row gets its own data provider at <code>&lt;dataProvider&gt;/list-item/&lt;index&gt;</code>.</p>
22
+ <h2 id="basic-example">Basic example</h2>
23
+ <p>Add <code>fetch</code> to load <code>props</code> from <code>serviceURL</code> + <code>endPoint</code> (or <code>dataProvider</code> when <code>endPoint</code> is empty). <code>key</code> picks the array inside the response. Without <code>fetch</code>, the list only renders the <code>props</code> it receives.</p>
24
+ <pre><code>&lt;sonic-list fetch serviceURL=&quot;/docs-mock-api&quot; dataProvider=&quot;flights?direction=arrivals&quot; key=&quot;flights&quot; class=&quot;grid gap-1&quot;&gt;
25
+ &lt;template&gt;
26
+ &lt;div class=&quot;text-sm&quot; data-bind ::inner-html=&quot;&lt;b&gt;$time&lt;/b&gt; $code from $city ($airport)&quot;&gt;&lt;/div&gt;
27
+ </code></pre>
28
+ <p>Fetch attributes (<code>lazyload</code> · <code>refetchEveryMs</code> · headers · authentication) are shared with <a href="/core/components/functional/fetch">Fetch</a>.</p>
29
+ <h2 id="row-renderer">Row renderer</h2>
30
+ <p>From a Lit component, set <code>.items</code> to a function <code>(item, metadata) =&gt; TemplateResult</code>. Functions only pass as properties, so always use the <code>.</code> binding: the same applies to <code>.separator</code> · <code>.noItems</code> · <code>.skeleton</code>. <code>metadata</code> holds <code>key</code> · <code>even</code> · <code>odd</code> · <code>firstChild</code> · <code>lastChild</code> · <code>onlyChild</code>.</p>
31
+ <p><docs-lit-demo for="docs-list-alternate-demo"></docs-lit-demo></p>
32
+ <h2 id="row-variants">Row variants</h2>
33
+ <p>In HTML, <code>templateKey</code> (default <code>template</code>) names the row field that selects a <code>&lt;template data-value=&quot;…&quot;&gt;</code>. Rows without a match cycle through the <code>&lt;template&gt;</code> children that have no <code>data-value</code>. From Lit, branch inside the <code>items</code> callback instead.</p>
34
+ <pre><code>&lt;sonic-list fetch serviceURL=&quot;/docs-mock-api&quot; dataProvider=&quot;flights?direction=departures&quot; key=&quot;flights&quot; templateKey=&quot;status&quot; class=&quot;grid gap-1&quot;&gt;
35
+ &lt;template&gt;
36
+ &lt;div class=&quot;text-sm&quot; data-bind ::inner-html=&quot;$code to $city&quot;&gt;&lt;/div&gt;
37
+ </code></pre>
38
+ <h2 id="separator-and-empty-list">Separator and empty list</h2>
39
+ <p><code>.separator</code> renders between rows (not after the last one). <code>.noItems</code> renders when the array is empty. In HTML, use <code>&lt;template data-value=&quot;separator&quot;&gt;</code> and <code>&lt;template data-value=&quot;no-item&quot;&gt;</code>.</p>
40
+ <p><docs-lit-demo for="docs-list-separator-demo"></docs-lit-demo></p>
41
+ <h2 id="limit-and-offset">Limit and offset</h2>
42
+ <p><code>limit</code> caps the number of rendered rows and <code>offset</code> skips the first ones, without changing the data. With no <code>limit</code>, every row is rendered.</p>
43
+ <pre><code>&lt;sonic-list fetch serviceURL=&quot;/docs-mock-api&quot; dataProvider=&quot;flights?direction=departures&quot; key=&quot;flights&quot; limit=&quot;3&quot; class=&quot;grid gap-1&quot;&gt;
44
+ &lt;template&gt;
45
+ &lt;div class=&quot;text-sm&quot; data-bind ::inner-html=&quot;&lt;b&gt;$time&lt;/b&gt; $code to $city&quot;&gt;&lt;/div&gt;
46
+ </code></pre>
47
+ <h2 id="objects-and-extractvalues">Objects and <code>extractValues</code></h2>
48
+ <p>When the data is an object, the list wraps it in a one-row array. Add <code>extractValues</code> to render one row per property instead, as <code>{ key, value }</code>.</p>
49
+ <p><docs-lit-demo for="docs-list-extract-values-demo"></docs-lit-demo></p>
50
+ <h2 id="loading-state">Loading state</h2>
51
+ <p>With no <code>loader</code>, nothing is shown while fetching. Set <code>loader</code> (<code>fixed</code>) or <code>loader=&quot;inline&quot;</code> to show a <a href="/core/components/ui/loader">Loader</a>, or provide <code>.skeleton</code> / <code>&lt;template skeleton&gt;</code> to render placeholder rows; a skeleton replaces the loader. Call <code>invalidate()</code> on the list publisher to fetch again.</p>
52
+ <pre><code>&lt;sonic-list fetch loader=&quot;inline&quot; serviceURL=&quot;/docs-mock-api&quot; dataProvider=&quot;flights?direction=arrivals&amp;status=landed&quot; key=&quot;flights&quot; class=&quot;grid gap-1&quot;&gt;
53
+ &lt;template&gt;
54
+ &lt;div class=&quot;text-sm&quot; data-bind ::inner-html=&quot;$code from $city: landed&quot;&gt;&lt;/div&gt;
55
+ </code></pre>
56
+ <h2 id="api-reference">API reference</h2>
57
+ <table>
58
+ <thead>
59
+ <tr>
60
+ <th>Attribute</th>
61
+ <th>Values</th>
62
+ <th>Description</th>
63
+ </tr>
64
+ </thead>
65
+ <tbody><tr>
66
+ <td><code>dataProvider</code></td>
67
+ <td>string</td>
68
+ <td>Publisher of the list. Also the endpoint when <code>endPoint</code> is empty. Inherited from ancestors</td>
69
+ </tr>
70
+ <tr>
71
+ <td><code>fetch</code></td>
72
+ <td>boolean</td>
73
+ <td>Loads <code>props</code> from the API. Without it, the list never fetches</td>
74
+ </tr>
75
+ <tr>
76
+ <td><code>serviceURL</code> · <code>endPoint</code> · <code>key</code></td>
77
+ <td>string</td>
78
+ <td>Request configuration, see <a href="/core/components/functional/fetch">Fetch</a></td>
79
+ </tr>
80
+ <tr>
81
+ <td><code>templateKey</code></td>
82
+ <td>string (default <code>template</code>)</td>
83
+ <td>Row field that selects a <code>&lt;template data-value&gt;</code></td>
84
+ </tr>
85
+ <tr>
86
+ <td><code>extractValues</code></td>
87
+ <td>boolean</td>
88
+ <td>Renders an object as one <code>{ key, value }</code> row per property</td>
89
+ </tr>
90
+ <tr>
91
+ <td><code>limit</code></td>
92
+ <td>number (default unlimited)</td>
93
+ <td>Maximum number of rendered rows</td>
94
+ </tr>
95
+ <tr>
96
+ <td><code>offset</code></td>
97
+ <td>number (default <code>0</code>)</td>
98
+ <td>Index of the first rendered row</td>
99
+ </tr>
100
+ <tr>
101
+ <td><code>loader</code></td>
102
+ <td><code>fixed</code> (when empty) · <code>inline</code></td>
103
+ <td>Loader shown while fetching. None by default</td>
104
+ </tr>
105
+ <tr>
106
+ <td><code>debug</code></td>
107
+ <td>boolean</td>
108
+ <td>Shows each row&#39;s data on hover</td>
109
+ </tr>
110
+ </tbody></table>
111
+ <table>
112
+ <thead>
113
+ <tr>
114
+ <th>Property</th>
115
+ <th>Type</th>
116
+ <th>Description</th>
117
+ </tr>
118
+ </thead>
119
+ <tbody><tr>
120
+ <td><code>props</code></td>
121
+ <td>array · object</td>
122
+ <td>Rows to render</td>
123
+ </tr>
124
+ <tr>
125
+ <td><code>items</code></td>
126
+ <td><code>(item, metadata) =&gt; TemplateResult</code></td>
127
+ <td>Row renderer</td>
128
+ </tr>
129
+ <tr>
130
+ <td><code>separator</code></td>
131
+ <td><code>() =&gt; TemplateResult</code></td>
132
+ <td>Rendered between rows</td>
133
+ </tr>
134
+ <tr>
135
+ <td><code>noItems</code></td>
136
+ <td><code>() =&gt; TemplateResult</code></td>
137
+ <td>Rendered when there are no rows</td>
138
+ </tr>
139
+ <tr>
140
+ <td><code>skeleton</code></td>
141
+ <td><code>() =&gt; TemplateResult</code></td>
142
+ <td>Rendered while fetching</td>
143
+ </tr>
144
+ <tr>
145
+ <td><code>itemPropertyMap</code></td>
146
+ <td>object</td>
147
+ <td><code>propertyMap</code> passed to each row subscriber</td>
148
+ </tr>
149
+ </tbody></table>
150
+ <table>
151
+ <thead>
152
+ <tr>
153
+ <th>Template</th>
154
+ <th>Description</th>
155
+ </tr>
156
+ </thead>
157
+ <tbody><tr>
158
+ <td><code>&lt;template&gt;</code></td>
159
+ <td>Row markup; several are used in turn</td>
160
+ </tr>
161
+ <tr>
162
+ <td><code>&lt;template data-value=&quot;…&quot;&gt;</code></td>
163
+ <td>Row variant selected by <code>templateKey</code></td>
164
+ </tr>
165
+ <tr>
166
+ <td><code>&lt;template data-value=&quot;separator&quot;&gt;</code></td>
167
+ <td>Between rows</td>
168
+ </tr>
169
+ <tr>
170
+ <td><code>&lt;template data-value=&quot;no-item&quot;&gt;</code></td>
171
+ <td>Empty list</td>
172
+ </tr>
173
+ <tr>
174
+ <td><code>&lt;template skeleton&gt;</code></td>
175
+ <td>While fetching</td>
176
+ </tr>
177
+ </tbody></table>
178
+ <table>
179
+ <thead>
180
+ <tr>
181
+ <th>Event</th>
182
+ <th>Description</th>
183
+ </tr>
184
+ </thead>
185
+ <tbody><tr>
186
+ <td><code>loading</code></td>
187
+ <td>A fetch starts</td>
188
+ </tr>
189
+ <tr>
190
+ <td><code>load</code></td>
191
+ <td>Data is loaded and assigned to <code>props</code></td>
192
+ </tr>
193
+ </tbody></table>
194
+
195
+ </article>
196
+ </main>
197
+ </body>
198
+ </html>
package/docs/core/components/functional/list/list.md ADDED
@@ -0,0 +1,121 @@
1
+ # List
2
+
3
+ **`sonic-list`** renders one row per entry of its `props` array, either set directly or loaded with `fetch`. From Lit, pass a row renderer on the `items` property; in plain HTML, declare `<template>` children. Each row gets its own data provider at `<dataProvider>/list-item/<index>`.
4
+
5
+ ## Basic example
6
+
7
+ Add `fetch` to load `props` from `serviceURL` + `endPoint` (or `dataProvider` when `endPoint` is empty). `key` picks the array inside the response. Without `fetch`, the list only renders the `props` it receives.
8
+
9
+ <sonic-code>
10
+ <template>
11
+ <sonic-list fetch serviceURL="/docs-mock-api" dataProvider="flights?direction=arrivals" key="flights" class="grid gap-1">
12
+ <template>
13
+ <div class="text-sm" data-bind ::inner-html="<b>$time</b> $code from $city ($airport)"></div>
14
+ </template>
15
+ </sonic-list>
16
+ </template>
17
+ </sonic-code>
18
+
19
+ Fetch attributes (`lazyload` · `refetchEveryMs` · headers · authentication) are shared with [Fetch](/core/components/functional/fetch).
20
+
21
+ ## Row renderer
22
+
23
+ From a Lit component, set `.items` to a function `(item, metadata) => TemplateResult`. Functions only pass as properties, so always use the `.` binding: the same applies to `.separator` · `.noItems` · `.skeleton`. `metadata` holds `key` · `even` · `odd` · `firstChild` · `lastChild` · `onlyChild`.
24
+
25
+ <docs-lit-demo for="docs-list-alternate-demo"></docs-lit-demo>
26
+
27
+ ## Row variants
28
+
29
+ In HTML, `templateKey` (default `template`) names the row field that selects a `<template data-value="…">`. Rows without a match cycle through the `<template>` children that have no `data-value`. From Lit, branch inside the `items` callback instead.
30
+
31
+ <sonic-code>
32
+ <template>
33
+ <sonic-list fetch serviceURL="/docs-mock-api" dataProvider="flights?direction=departures" key="flights" templateKey="status" class="grid gap-1">
34
+ <template>
35
+ <div class="text-sm" data-bind ::inner-html="$code to $city"></div>
36
+ </template>
37
+ <template data-value="delayed">
38
+ <div class="text-sm text-warning" data-bind ::inner-html="$code to $city: delayed"></div>
39
+ </template>
40
+ <template data-value="cancelled">
41
+ <div class="text-sm text-danger line-through" data-bind ::inner-html="$code to $city"></div>
42
+ </template>
43
+ </sonic-list>
44
+ </template>
45
+ </sonic-code>
46
+
47
+ ## Separator and empty list
48
+
49
+ `.separator` renders between rows (not after the last one). `.noItems` renders when the array is empty. In HTML, use `<template data-value="separator">` and `<template data-value="no-item">`.
50
+
51
+ <docs-lit-demo for="docs-list-separator-demo"></docs-lit-demo>
52
+
53
+ ## Limit and offset
54
+
55
+ `limit` caps the number of rendered rows and `offset` skips the first ones, without changing the data. With no `limit`, every row is rendered.
56
+
57
+ <sonic-code>
58
+ <template>
59
+ <sonic-list fetch serviceURL="/docs-mock-api" dataProvider="flights?direction=departures" key="flights" limit="3" class="grid gap-1">
60
+ <template>
61
+ <div class="text-sm" data-bind ::inner-html="<b>$time</b> $code to $city"></div>
62
+ </template>
63
+ </sonic-list>
64
+ </template>
65
+ </sonic-code>
66
+
67
+ ## Objects and `extractValues`
68
+
69
+ When the data is an object, the list wraps it in a one-row array. Add `extractValues` to render one row per property instead, as `{ key, value }`.
70
+
71
+ <docs-lit-demo for="docs-list-extract-values-demo"></docs-lit-demo>
72
+
73
+ ## Loading state
74
+
75
+ With no `loader`, nothing is shown while fetching. Set `loader` (`fixed`) or `loader="inline"` to show a [Loader](/core/components/ui/loader), or provide `.skeleton` / `<template skeleton>` to render placeholder rows; a skeleton replaces the loader. Call `invalidate()` on the list publisher to fetch again.
76
+
77
+ <sonic-code>
78
+ <template>
79
+ <sonic-list fetch loader="inline" serviceURL="/docs-mock-api" dataProvider="flights?direction=arrivals&status=landed" key="flights" class="grid gap-1">
80
+ <template>
81
+ <div class="text-sm" data-bind ::inner-html="$code from $city: landed"></div>
82
+ </template>
83
+ </sonic-list>
84
+ </template>
85
+ </sonic-code>
86
+
87
+ ## API reference
88
+
89
+ | Attribute | Values | Description |
90
+ |-----------|--------|-------------|
91
+ | `dataProvider` | string | Publisher of the list. Also the endpoint when `endPoint` is empty. Inherited from ancestors |
92
+ | `fetch` | boolean | Loads `props` from the API. Without it, the list never fetches |
93
+ | `serviceURL` · `endPoint` · `key` | string | Request configuration, see [Fetch](/core/components/functional/fetch) |
94
+ | `templateKey` | string (default `template`) | Row field that selects a `<template data-value>` |
95
+ | `extractValues` | boolean | Renders an object as one `{ key, value }` row per property |
96
+ | `limit` | number (default unlimited) | Maximum number of rendered rows |
97
+ | `offset` | number (default `0`) | Index of the first rendered row |
98
+ | `loader` | `fixed` (when empty) · `inline` | Loader shown while fetching. None by default |
99
+ | `debug` | boolean | Shows each row's data on hover |
100
+
101
+ | Property | Type | Description |
102
+ |----------|------|-------------|
103
+ | `props` | array · object | Rows to render |
104
+ | `items` | `(item, metadata) => TemplateResult` | Row renderer |
105
+ | `separator` | `() => TemplateResult` | Rendered between rows |
106
+ | `noItems` | `() => TemplateResult` | Rendered when there are no rows |
107
+ | `skeleton` | `() => TemplateResult` | Rendered while fetching |
108
+ | `itemPropertyMap` | object | `propertyMap` passed to each row subscriber |
109
+
110
+ | Template | Description |
111
+ |----------|-------------|
112
+ | `<template>` | Row markup; several are used in turn |
113
+ | `<template data-value="…">` | Row variant selected by `templateKey` |
114
+ | `<template data-value="separator">` | Between rows |
115
+ | `<template data-value="no-item">` | Empty list |
116
+ | `<template skeleton>` | While fetching |
117
+
118
+ | Event | Description |
119
+ |-------|-------------|
120
+ | `loading` | A fetch starts |
121
+ | `load` | Data is loaded and assigned to `props` |
package/docs/core/components/functional/mix/mix.html ADDED
@@ -0,0 +1,78 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/functional/mix" data-doc-id="core/components/functional/mix/mix">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Mix — Concorde by Supersoniks</title>
7
+ <meta name="description" content="sonic-mix builds a new data provider from parts of other ones. Each key of composition maps to a source data provider id, with an optional dot path to a sub-value. The mixed provider is named by the d">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/functional/mix/mix, mix, Mix, functional component, sonic-mix, web component, composition, dataProvider, flight, gate, docs-mix-gate, docs-mix-board.gate, &quot;providerId&quot;">
9
+ <meta name="concorde-doc-id" content="core/components/functional/mix/mix">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/core/components/functional/mix">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/functional/mix.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/functional/mix">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 functional component — Mix</strong>. sonic-mix builds a new data provider from parts of other ones. Each key of composition maps to a source data provider id, with an optional dot path to a sub-value. The mixed provider is named by the d <span>Doc ID: <code>core/components/functional/mix/mix</code>. Keywords: Concorde, supersoniks, core/components/functional/mix/mix, mix, Mix, functional component, sonic-mix, web component, composition, dataProvider, flight, gate, docs-mix-gate, docs-mix-board.gate, &quot;providerId&quot;. URL: <a href="https://concorde.supersoniks.org/core/components/functional/mix">https://concorde.supersoniks.org/core/components/functional/mix</a>.</span></p>
20
+ <h1 id="mix">Mix</h1>
21
+ <p><strong><code>sonic-mix</code></strong> builds a new data provider from parts of other ones. Each key of <code>composition</code> maps to a source data provider id, with an optional dot path to a sub-value. The mixed provider is named by the <code>dataProvider</code> attribute and stays in sync with its sources in both directions.</p>
22
+ <h2 id="basic-example">Basic example</h2>
23
+ <p>Two sources hold the flight and its gate. The mix exposes the whole flight under <code>flight</code> and only the gate number under <code>gate</code>; children read them like any other data provider.</p>
24
+ <pre><code>&lt;sonic-subscriber dataProvider=&quot;docs-mix-flight&quot; props=&#39;{&quot;code&quot;:&quot;CN 001&quot;,&quot;route&quot;:&quot;CDG → JFK&quot;}&#39;&gt;&lt;/sonic-subscriber&gt;
25
+ &lt;sonic-subscriber dataProvider=&quot;docs-mix-gate&quot; props=&#39;{&quot;gate&quot;:&quot;B12&quot;,&quot;terminal&quot;:&quot;2E&quot;}&#39;&gt;&lt;/sonic-subscriber&gt;
26
+ &lt;sonic-mix dataProvider=&quot;docs-mix-board&quot; composition=&#39;{&quot;flight&quot;:&quot;docs-mix-flight&quot;,&quot;gate&quot;:&quot;docs-mix-gate.gate&quot;}&#39;&gt;
27
+ &lt;p&gt;
28
+ &lt;sonic-value key=&quot;flight.code&quot;&gt;&lt;/sonic-value&gt; ·
29
+ &lt;sonic-value key=&quot;flight.route&quot;&gt;&lt;/sonic-value&gt; ·
30
+ gate &lt;sonic-value key=&quot;gate&quot;&gt;&lt;/sonic-value&gt;
31
+ &lt;/p&gt;
32
+ &lt;/sonic-mix&gt;
33
+ </code></pre>
34
+ <h2 id="two-way-sync">Two-way sync</h2>
35
+ <p>Writing to a source updates the mix, and writing to the mix updates the source. The button changes <code>docs-mix-gate</code>; the field writes to <code>docs-mix-board.gate</code>.</p>
36
+ <pre><code>&lt;div class=&quot;flex flex-wrap items-end gap-4&quot;&gt;
37
+ &lt;sonic-button size=&quot;sm&quot; onclick=&quot;SonicPublisherManager.get(&#39;docs-mix-gate&#39;).gate = &#39;C34&#39;&quot;&gt;Gate change to C34&lt;/sonic-button&gt;
38
+ &lt;sonic-input label=&quot;Gate (mixed provider)&quot; formDataProvider=&quot;docs-mix-board&quot; name=&quot;gate&quot;&gt;&lt;/sonic-input&gt;
39
+ &lt;/div&gt;
40
+ &lt;p class=&quot;mt-2&quot;&gt;Source gate: &lt;sonic-value dataProvider=&quot;docs-mix-gate&quot; key=&quot;gate&quot;&gt;&lt;/sonic-value&gt;&lt;/p&gt;
41
+ </code></pre>
42
+ <h2 id="api-reference">API reference</h2>
43
+ <table>
44
+ <thead>
45
+ <tr>
46
+ <th>Attribute</th>
47
+ <th>Values</th>
48
+ <th>Description</th>
49
+ </tr>
50
+ </thead>
51
+ <tbody><tr>
52
+ <td><code>dataProvider</code></td>
53
+ <td>string</td>
54
+ <td>Id of the mixed data provider. Its content is reset when the composition changes</td>
55
+ </tr>
56
+ <tr>
57
+ <td><code>composition</code></td>
58
+ <td>object (JSON)</td>
59
+ <td>Keys of the mixed provider mapped to <code>&quot;providerId&quot;</code> or <code>&quot;providerId.path.to.value&quot;</code></td>
60
+ </tr>
61
+ </tbody></table>
62
+ <table>
63
+ <thead>
64
+ <tr>
65
+ <th>Slot</th>
66
+ <th>Description</th>
67
+ </tr>
68
+ </thead>
69
+ <tbody><tr>
70
+ <td><em>(default)</em></td>
71
+ <td>Content that reads the mixed provider</td>
72
+ </tr>
73
+ </tbody></table>
74
+
75
+ </article>
76
+ </main>
77
+ </body>
78
+ </html>
package/docs/core/components/functional/mix/mix.md ADDED
@@ -0,0 +1,46 @@
1
+ # Mix
2
+
3
+ **`sonic-mix`** builds a new data provider from parts of other ones. Each key of `composition` maps to a source data provider id, with an optional dot path to a sub-value. The mixed provider is named by the `dataProvider` attribute and stays in sync with its sources in both directions.
4
+
5
+ ## Basic example
6
+
7
+ Two sources hold the flight and its gate. The mix exposes the whole flight under `flight` and only the gate number under `gate`; children read them like any other data provider.
8
+
9
+ <sonic-code>
10
+ <template>
11
+ <sonic-subscriber dataProvider="docs-mix-flight" props='{"code":"CN 001","route":"CDG → JFK"}'></sonic-subscriber>
12
+ <sonic-subscriber dataProvider="docs-mix-gate" props='{"gate":"B12","terminal":"2E"}'></sonic-subscriber>
13
+ <sonic-mix dataProvider="docs-mix-board" composition='{"flight":"docs-mix-flight","gate":"docs-mix-gate.gate"}'>
14
+ <p>
15
+ <sonic-value key="flight.code"></sonic-value> ·
16
+ <sonic-value key="flight.route"></sonic-value> ·
17
+ gate <sonic-value key="gate"></sonic-value>
18
+ </p>
19
+ </sonic-mix>
20
+ </template>
21
+ </sonic-code>
22
+
23
+ ## Two-way sync
24
+
25
+ Writing to a source updates the mix, and writing to the mix updates the source. The button changes `docs-mix-gate`; the field writes to `docs-mix-board.gate`.
26
+
27
+ <sonic-code>
28
+ <template>
29
+ <div class="flex flex-wrap items-end gap-4">
30
+ <sonic-button size="sm" onclick="SonicPublisherManager.get('docs-mix-gate').gate = 'C34'">Gate change to C34</sonic-button>
31
+ <sonic-input label="Gate (mixed provider)" formDataProvider="docs-mix-board" name="gate"></sonic-input>
32
+ </div>
33
+ <p class="mt-2">Source gate: <sonic-value dataProvider="docs-mix-gate" key="gate"></sonic-value></p>
34
+ </template>
35
+ </sonic-code>
36
+
37
+ ## API reference
38
+
39
+ | Attribute | Values | Description |
40
+ |-----------|--------|-------------|
41
+ | `dataProvider` | string | Id of the mixed data provider. Its content is reset when the composition changes |
42
+ | `composition` | object (JSON) | Keys of the mixed provider mapped to `"providerId"` or `"providerId.path.to.value"` |
43
+
44
+ | Slot | Description |
45
+ |------|-------------|
46
+ | *(default)* | Content that reads the mixed provider |
package/docs/core/components/functional/queue/queue.html ADDED
@@ -0,0 +1,155 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/functional/queue" data-doc-id="core/components/functional/queue/queue">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Queue — Concorde by Supersoniks</title>
7
+ <meta name="description" content="sonic-queue loads a paginated API in batches and renders each batch as an internal List. Choose it over sonic-list for long or endless lists; the key attributes are dataProviderExpression · limit · da">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/functional/queue/queue, queue, Queue, functional component, sonic-queue, web component, sonic-list, dataProviderExpression, limit, dataFilterProvider, $offset, $limit, offset, ) with ">
9
+ <meta name="concorde-doc-id" content="core/components/functional/queue/queue">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/core/components/functional/queue">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/functional/queue.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/functional/queue">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 functional component — Queue</strong>. sonic-queue loads a paginated API in batches and renders each batch as an internal List. Choose it over sonic-list for long or endless lists; the key attributes are dataProviderExpression · limit · da <span>Doc ID: <code>core/components/functional/queue/queue</code>. Keywords: Concorde, supersoniks, core/components/functional/queue/queue, queue, Queue, functional component, sonic-queue, web component, sonic-list, dataProviderExpression, limit, dataFilterProvider, $offset, $limit, offset, ) with . URL: <a href="https://concorde.supersoniks.org/core/components/functional/queue">https://concorde.supersoniks.org/core/components/functional/queue</a>.</span></p>
20
+ <h1 id="queue">Queue</h1>
21
+ <p><strong><code>sonic-queue</code></strong> loads a paginated API in batches and renders each batch as an internal <a href="/core/components/functional/list">List</a>. Choose it over <code>sonic-list</code> for long or endless lists; the key attributes are <code>dataProviderExpression</code> · <code>limit</code> · <code>dataFilterProvider</code>.</p>
22
+ <h2 id="lazy-load">Lazy load</h2>
23
+ <p><code>dataProviderExpression</code> is the request path: <code>$offset</code> and <code>$limit</code> are replaced for each batch. The first batch starts at <code>offset</code> (default <code>0</code>) with <code>limit</code> rows (default <code>5</code>, at most <code>15</code>). The next batch loads when the end of the list scrolls into view, and the queue stops at the first empty batch. Put the queue in a box with a fixed height and <code>overflow-y-auto</code>, then scroll inside it.</p>
24
+ <p><docs-lit-demo for="docs-queue-geo-demo"></docs-lit-demo></p>
25
+ <p>Rows come from the <code>.items</code> callback, as on <a href="/core/components/functional/list">List</a>; <code>.noItems</code> and <code>.skeleton</code> work the same way. Without <code>$offset</code> in the expression, the queue sends one request and behaves like a list. Set <code>noLazyload</code> to load every batch in a row without waiting for the scroll.</p>
26
+ <h2 id="filters">Filters</h2>
27
+ <p><code>dataFilterProvider</code> names a form store (<code>formDataProvider</code>). Each non-empty field is added to the query string; when a field changes, the queue drops the loaded batches and reloads from the first offset, after a <code>filterTimeoutMs</code> debounce (default <code>400</code>). Search a city, an airport or a flight number.</p>
28
+ <p><docs-lit-demo for="docs-queue-users-demo"></docs-lit-demo></p>
29
+ <p>To keep some form fields out of the request, list their names in <code>filteredFields</code>, separated by spaces.</p>
30
+ <h2 id="api-reference">API reference</h2>
31
+ <table>
32
+ <thead>
33
+ <tr>
34
+ <th>Attribute</th>
35
+ <th>Values</th>
36
+ <th>Description</th>
37
+ </tr>
38
+ </thead>
39
+ <tbody><tr>
40
+ <td><code>dataProviderExpression</code></td>
41
+ <td>string (default: closest ancestor <code>dataProvider</code>)</td>
42
+ <td>Request path; <code>$offset</code> and <code>$limit</code> are replaced for each batch</td>
43
+ </tr>
44
+ <tr>
45
+ <td><code>serviceURL</code></td>
46
+ <td>string</td>
47
+ <td>API base URL; inherited from the closest ancestor</td>
48
+ </tr>
49
+ <tr>
50
+ <td><code>key</code></td>
51
+ <td>string</td>
52
+ <td>Response property that holds the rows</td>
53
+ </tr>
54
+ <tr>
55
+ <td><code>limit</code></td>
56
+ <td>number (default <code>5</code>, max <code>15</code>)</td>
57
+ <td>Rows per batch</td>
58
+ </tr>
59
+ <tr>
60
+ <td><code>offset</code></td>
61
+ <td>number (default <code>0</code>)</td>
62
+ <td>Offset of the first batch</td>
63
+ </tr>
64
+ <tr>
65
+ <td><code>idKey</code></td>
66
+ <td>string (default <code>id</code>)</td>
67
+ <td>Row property used as identity</td>
68
+ </tr>
69
+ <tr>
70
+ <td><code>dataFilterProvider</code></td>
71
+ <td>string</td>
72
+ <td>Form store whose fields are added to the query; inherited from the closest ancestor</td>
73
+ </tr>
74
+ <tr>
75
+ <td><code>filteredFields</code></td>
76
+ <td>space-separated names</td>
77
+ <td>Form fields not sent to the API</td>
78
+ </tr>
79
+ <tr>
80
+ <td><code>filterTimeoutMs</code></td>
81
+ <td>number (default <code>400</code>)</td>
82
+ <td>Debounce before reloading after a filter change</td>
83
+ </tr>
84
+ <tr>
85
+ <td><code>noLazyload</code></td>
86
+ <td>boolean</td>
87
+ <td>Loads all batches without waiting for the scroll</td>
88
+ </tr>
89
+ <tr>
90
+ <td><code>lazyBoundsRatio</code></td>
91
+ <td>number (default <code>1</code>)</td>
92
+ <td>Lazy-load margin, as a multiple of the viewport size</td>
93
+ </tr>
94
+ <tr>
95
+ <td><code>loader</code></td>
96
+ <td><code>inline</code> · <code>fixed</code> (default <code>inline</code>)</td>
97
+ <td>Loader shown while a batch loads</td>
98
+ </tr>
99
+ <tr>
100
+ <td><code>cache</code></td>
101
+ <td><code>RequestCache</code> (default <code>default</code>)</td>
102
+ <td>Fetch cache mode</td>
103
+ </tr>
104
+ <tr>
105
+ <td><code>invalidateOnPageShow</code></td>
106
+ <td>boolean</td>
107
+ <td>Reloads batches when the page is restored from the back/forward cache</td>
108
+ </tr>
109
+ <tr>
110
+ <td><code>localStorage</code></td>
111
+ <td><code>disabled</code> · <code>enabled</code> (default <code>disabled</code>)</td>
112
+ <td>Forwarded to each batch list</td>
113
+ </tr>
114
+ <tr>
115
+ <td><code>debug</code></td>
116
+ <td>boolean</td>
117
+ <td>Shows a live inspector of each batch list&#39;s data</td>
118
+ </tr>
119
+ </tbody></table>
120
+ <table>
121
+ <thead>
122
+ <tr>
123
+ <th>Property</th>
124
+ <th>Type</th>
125
+ <th>Description</th>
126
+ </tr>
127
+ </thead>
128
+ <tbody><tr>
129
+ <td><code>items</code></td>
130
+ <td><code>ListItems</code></td>
131
+ <td>Row renderer</td>
132
+ </tr>
133
+ <tr>
134
+ <td><code>noItems</code></td>
135
+ <td><code>ListItems</code></td>
136
+ <td>Rendered when the first batch is empty</td>
137
+ </tr>
138
+ <tr>
139
+ <td><code>skeleton</code></td>
140
+ <td><code>ListItems</code></td>
141
+ <td>Rendered while a batch loads</td>
142
+ </tr>
143
+ <tr>
144
+ <td><code>itemPropertyMap</code></td>
145
+ <td>object</td>
146
+ <td>Forwarded to each batch list</td>
147
+ </tr>
148
+ </tbody></table>
149
+ <p>The queue publisher exposes <code>resultCount</code>, the number of rows loaded so far.</p>
150
+ <p>No slots. <code>&lt;template&gt;</code> children are used as row templates for hosts without Lit; see <a href="/docs/misc/html-integration">HTML integration</a>.</p>
151
+
152
+ </article>
153
+ </main>
154
+ </body>
155
+ </html>