@supersoniks/concorde 5.1.2 → 5.1.3-immutable.1

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