@supersoniks/concorde 5.1.2 → 5.1.3-immutable.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (497) hide show
  1. package/.agents/skills/concorde-docs/SKILL.md +1 -1
  2. package/.claude/skills +1 -0
  3. package/.github/workflows/ci.yml +21 -0
  4. package/.github-export-ignore +30 -0
  5. package/CONTRIBUTING.md +59 -0
  6. package/DEV.md +54 -0
  7. package/LICENSE +21 -0
  8. package/OPEN_SOURCE_CHECKPOINT.md +133 -0
  9. package/README.md +1 -1
  10. package/ai/README.md +29 -41
  11. package/ai/skills/concorde/SKILL.md +54 -324
  12. package/ai/skills/concorde/rules/composition.md +32 -0
  13. package/ai/skills/concorde/rules/data.md +47 -0
  14. package/ai/skills/concorde/rules/http.md +25 -0
  15. package/ai/skills/concorde/rules/lists-forms.md +35 -0
  16. package/ai/skills/concorde/rules/styling.md +46 -0
  17. package/ai/skills/concorde/rules/troubleshooting.md +45 -0
  18. package/build-infos.json +1 -1
  19. package/concorde-core.bundle.js +177 -177
  20. package/concorde-core.es.js +4993 -4833
  21. package/custom-elements-manifest.public.config.mjs +8 -0
  22. package/{.tmp-cem/custom-elements.json → custom-elements.json} +11722 -8868
  23. package/dist/concorde-core.bundle.js +177 -177
  24. package/dist/concorde-core.es.js +4993 -4833
  25. package/dist/docs-mock-api-sw.js +58 -223
  26. package/dist/docs-mock-api-sw.js.map +4 -4
  27. package/dist/img/og-concorde.jpg +0 -0
  28. package/dist/robots.txt +11 -10
  29. package/docs/assets/index-CD4WyL6o.css +1 -0
  30. package/docs/assets/index-D_alEsng.js +12122 -0
  31. package/docs/crawl/core/components/functional/date/date.html +190 -0
  32. package/docs/crawl/core/components/functional/fetch/fetch.html +109 -0
  33. package/docs/crawl/core/components/functional/if/if.html +27 -0
  34. package/docs/crawl/core/components/functional/jsonata/jsonata.html +79 -0
  35. package/docs/crawl/core/components/functional/list/list.html +70 -0
  36. package/docs/crawl/core/components/functional/mix/mix.html +45 -0
  37. package/docs/crawl/core/components/functional/queue/queue.html +96 -0
  38. package/docs/crawl/core/components/functional/router/router.html +106 -0
  39. package/docs/{core → crawl/core}/components/functional/sdui/sdui-extension-points.html +8 -9
  40. package/docs/crawl/core/components/functional/sdui/sdui.html +368 -0
  41. package/docs/crawl/core/components/functional/states/states.html +66 -0
  42. package/docs/crawl/core/components/functional/submit/submit.html +160 -0
  43. package/docs/{core → crawl/core}/components/functional/subscriber/subscriber.html +5 -6
  44. package/docs/crawl/core/components/functional/value/value.html +51 -0
  45. package/docs/{core → crawl/core}/components/ui/alert/alert.html +63 -53
  46. package/docs/{core → crawl/core}/components/ui/alert-messages/alert-messages.html +5 -6
  47. package/docs/{core → crawl/core}/components/ui/badge/badge.html +33 -33
  48. package/docs/crawl/core/components/ui/button/button.html +150 -0
  49. package/docs/crawl/core/components/ui/captcha/captcha.html +112 -0
  50. package/docs/{core → crawl/core}/components/ui/card/card.html +11 -12
  51. package/docs/{core → crawl/core}/components/ui/divider/divider.html +14 -14
  52. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +73 -0
  53. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +266 -0
  54. package/docs/{core → crawl/core}/components/ui/form/form-actions/form-actions.html +23 -23
  55. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +121 -0
  56. package/docs/crawl/core/components/ui/form/input/input.html +109 -0
  57. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +38 -0
  58. package/docs/crawl/core/components/ui/form/radio/radio.html +56 -0
  59. package/docs/crawl/core/components/ui/form/select/select.html +73 -0
  60. package/docs/crawl/core/components/ui/form/switch/switch.html +56 -0
  61. package/docs/crawl/core/components/ui/form/textarea/textarea.html +59 -0
  62. package/docs/crawl/core/components/ui/group/group.html +104 -0
  63. package/docs/{core → crawl/core}/components/ui/icon/icon.html +9 -10
  64. package/docs/crawl/core/components/ui/image/image.html +298 -0
  65. package/docs/{core → crawl/core}/components/ui/link/link.html +11 -12
  66. package/docs/crawl/core/components/ui/loader/loader.html +124 -0
  67. package/docs/{core → crawl/core}/components/ui/menu/menu.html +33 -34
  68. package/docs/crawl/core/components/ui/modal/modal.html +342 -0
  69. package/docs/crawl/core/components/ui/pop/pop.html +296 -0
  70. package/docs/{core → crawl/core}/components/ui/progress/progress.html +7 -8
  71. package/docs/crawl/core/components/ui/table/table.html +545 -0
  72. package/docs/crawl/core/components/ui/theme/theme.html +131 -0
  73. package/docs/crawl/core/components/ui/toast/toast.html +233 -0
  74. package/docs/crawl/core/components/ui/tooltip/tooltip.html +140 -0
  75. package/docs/{docs/getting-started → crawl/docs/_core-concept}/dataFlow.html +29 -26
  76. package/docs/crawl/docs/_core-concept/overview.html +66 -0
  77. package/docs/crawl/docs/_core-concept/subscriber.html +75 -0
  78. package/docs/crawl/docs/_decorators/ancestor-attribute.html +117 -0
  79. package/docs/crawl/docs/_decorators/auto-subscribe.html +202 -0
  80. package/docs/crawl/docs/_decorators/bind.html +141 -0
  81. package/docs/crawl/docs/_decorators/get.html +149 -0
  82. package/docs/crawl/docs/_decorators/handle.html +165 -0
  83. package/docs/crawl/docs/_decorators/on-assign.html +355 -0
  84. package/docs/crawl/docs/_decorators/patch.html +78 -0
  85. package/docs/crawl/docs/_decorators/post.html +139 -0
  86. package/docs/crawl/docs/_decorators/publish.html +61 -0
  87. package/docs/crawl/docs/_decorators/put.html +78 -0
  88. package/docs/crawl/docs/_decorators/subscribe.html +109 -0
  89. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +137 -0
  90. package/docs/crawl/docs/_directives/sub.html +93 -0
  91. package/docs/{docs/getting-started → crawl/docs/_getting-started}/ai-agents.html +11 -12
  92. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +100 -0
  93. package/docs/crawl/docs/_getting-started/concorde-outside.html +58 -0
  94. package/docs/{docs/getting-started → crawl/docs/_getting-started}/create-a-component.html +14 -11
  95. package/docs/{docs/getting-started → crawl/docs/_getting-started}/my-first-component.html +22 -13
  96. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +110 -0
  97. package/docs/crawl/docs/_getting-started/pubsub.html +62 -0
  98. package/docs/crawl/docs/_getting-started/start.html +76 -0
  99. package/docs/{docs/getting-started → crawl/docs/_getting-started}/theming.html +9 -10
  100. package/docs/{docs/misc → crawl/docs/_misc}/api-configuration.html +18 -18
  101. package/docs/{docs/misc → crawl/docs/_misc}/dataProviderKey.html +11 -12
  102. package/docs/{docs/misc → crawl/docs/_misc}/docs-mock-api.html +28 -25
  103. package/docs/{docs/misc → crawl/docs/_misc}/dynamic-path.html +15 -16
  104. package/docs/{docs/misc → crawl/docs/_misc}/endpoint.html +15 -16
  105. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +138 -0
  106. package/docs/{docs/misc → crawl/docs/_misc}/html-integration.html +15 -12
  107. package/docs/crawl/hubs/decorators.html +547 -0
  108. package/docs/crawl/hubs/form-components.html +381 -0
  109. package/docs/crawl/hubs/remote-data.html +452 -0
  110. package/docs/crawl/index.html +103 -0
  111. package/docs/docs-mock-api-sw.js +223 -58
  112. package/docs/docs-mock-api-sw.js.map +4 -4
  113. package/docs/index.html +68 -95
  114. package/docs/llms-full.txt +3610 -2231
  115. package/docs/llms.txt +86 -94
  116. package/docs/robots.txt +10 -11
  117. package/docs/sitemap.xml +84 -78
  118. package/docs/src/core/components/functional/date/date.md +231 -91
  119. package/docs/src/core/components/functional/fetch/fetch.md +83 -66
  120. package/docs/src/core/components/functional/if/if.md +3 -28
  121. package/docs/src/core/components/functional/jsonata/jsonata.md +37 -42
  122. package/docs/src/core/components/functional/list/list.md +43 -99
  123. package/docs/src/core/components/functional/mix/mix.md +26 -31
  124. package/docs/src/core/components/functional/queue/queue.md +61 -40
  125. package/docs/src/core/components/functional/router/router.md +65 -64
  126. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  127. package/docs/src/core/components/functional/sdui/component-catalog.json +1 -1
  128. package/docs/src/core/components/functional/sdui/example.json +86 -19
  129. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  130. package/docs/src/core/components/functional/sdui/sdui.md +358 -187
  131. package/docs/src/core/components/functional/states/states.md +61 -86
  132. package/docs/src/core/components/functional/submit/submit.md +72 -64
  133. package/docs/src/core/components/functional/value/value.md +22 -34
  134. package/docs/src/core/components/ui/alert/alert.md +58 -48
  135. package/docs/src/core/components/ui/badge/badge.md +34 -27
  136. package/docs/src/core/components/ui/button/button.md +106 -139
  137. package/docs/src/core/components/ui/captcha/captcha.md +32 -17
  138. package/docs/src/core/components/ui/card/card.md +6 -6
  139. package/docs/src/core/components/ui/divider/divider.md +11 -8
  140. package/docs/src/core/components/ui/form/checkbox/checkbox.md +42 -90
  141. package/docs/src/core/components/ui/form/fieldset/fieldset.md +75 -31
  142. package/docs/src/core/components/ui/form/form-actions/form-actions.md +16 -14
  143. package/docs/src/core/components/ui/form/form-layout/form-layout.md +29 -19
  144. package/docs/src/core/components/ui/form/input/input.md +95 -95
  145. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +29 -0
  146. package/docs/src/core/components/ui/form/radio/radio.md +34 -55
  147. package/docs/src/core/components/ui/form/select/select.md +45 -60
  148. package/docs/src/core/components/ui/form/switch/switch.md +34 -57
  149. package/docs/src/core/components/ui/form/textarea/textarea.md +38 -55
  150. package/docs/src/core/components/ui/group/group.md +33 -35
  151. package/docs/src/core/components/ui/icon/icon.md +4 -4
  152. package/docs/src/core/components/ui/image/image.md +107 -41
  153. package/docs/src/core/components/ui/link/link.md +6 -6
  154. package/docs/src/core/components/ui/loader/loader.md +55 -30
  155. package/docs/src/core/components/ui/menu/menu.md +27 -27
  156. package/docs/src/core/components/ui/modal/modal.md +96 -72
  157. package/docs/src/core/components/ui/pop/pop.md +158 -80
  158. package/docs/src/core/components/ui/progress/progress.md +2 -2
  159. package/docs/src/core/components/ui/table/table.md +255 -91
  160. package/docs/src/core/components/ui/theme/theme.md +36 -11
  161. package/docs/src/core/components/ui/toast/toast.md +117 -48
  162. package/docs/src/core/components/ui/tooltip/tooltip.md +62 -27
  163. package/docs/{docs/getting-started → src/docs/_core-concept}/dataFlow.md +18 -17
  164. package/docs/src/docs/_core-concept/overview.md +57 -0
  165. package/docs/src/docs/_core-concept/subscriber.md +75 -0
  166. package/docs/src/docs/_decorators/ancestor-attribute.md +128 -0
  167. package/docs/src/docs/_decorators/auto-subscribe.md +202 -0
  168. package/docs/src/docs/_decorators/bind.md +167 -0
  169. package/docs/src/docs/_decorators/get.md +162 -0
  170. package/docs/src/docs/_decorators/handle.md +175 -0
  171. package/docs/src/docs/_decorators/on-assign.md +390 -0
  172. package/docs/src/docs/_decorators/patch.md +70 -0
  173. package/docs/src/docs/_decorators/post.md +146 -0
  174. package/docs/src/docs/_decorators/publish.md +55 -0
  175. package/docs/src/docs/_decorators/put.md +70 -0
  176. package/docs/src/docs/_decorators/subscribe.md +100 -0
  177. package/docs/src/docs/_decorators/wait-for-ancestors.md +163 -0
  178. package/docs/src/docs/_directives/sub.md +91 -0
  179. package/docs/src/docs/{getting-started → _getting-started}/ai-agents.md +3 -3
  180. package/docs/src/docs/_getting-started/concorde-manual-install.md +133 -0
  181. package/docs/src/docs/_getting-started/concorde-outside.md +33 -0
  182. package/docs/{docs/getting-started → src/docs/_getting-started}/create-a-component.md +6 -3
  183. package/docs/src/docs/{getting-started → _getting-started}/my-first-component.md +14 -5
  184. package/docs/src/docs/_getting-started/my-first-subscriber.md +120 -0
  185. package/docs/src/docs/_getting-started/pubsub.md +37 -0
  186. package/docs/src/docs/{getting-started → _getting-started}/start.md +13 -1
  187. package/docs/src/docs/{getting-started → _getting-started}/theming.md +2 -2
  188. package/docs/src/docs/{misc → _misc}/api-configuration.md +12 -10
  189. package/docs/src/docs/{misc → _misc}/dataProviderKey.md +4 -4
  190. package/docs/{docs/misc → src/docs/_misc}/docs-mock-api.md +13 -12
  191. package/docs/{docs/misc → src/docs/_misc}/dynamic-path.md +8 -8
  192. package/docs/{docs/misc → src/docs/_misc}/endpoint.md +8 -8
  193. package/docs/src/docs/_misc/formelement-subscriber-removal.md +115 -0
  194. package/docs/{docs/misc → src/docs/_misc}/html-integration.md +5 -4
  195. package/docs/src/docs/search/docs-search.json +4375 -2420
  196. package/docs/src/tsconfig.declarations.json +22 -0
  197. package/docs/src/tsconfig.emit.json +23 -0
  198. package/docs/src/tsconfig.json +2 -23
  199. package/gitlab/job_github_mirror.sh +39 -0
  200. package/index.html +89 -0
  201. package/package.json +22 -4
  202. package/public/img/og-concorde.jpg +0 -0
  203. package/scripts/ai-init.mjs +104 -379
  204. package/scripts/ai-init.test.mjs +81 -239
  205. package/scripts/docs-markdown-vite-plugin.ts +11 -5
  206. package/scripts/docs-public-url.mjs +6 -0
  207. package/scripts/docs.htaccess +7 -0
  208. package/scripts/generate-cem.mjs +244 -0
  209. package/scripts/generate-cem.test.mjs +122 -0
  210. package/scripts/generate-crawl-docs.mjs +29 -5
  211. package/scripts/generate-sdui-catalog.mjs +11 -10
  212. package/scripts/github-export.mjs +150 -0
  213. package/scripts/post-build-docs.js +3 -0
  214. package/scripts/post-build.mjs +0 -0
  215. package/scripts/pre-publish.mjs +2 -1
  216. package/scripts/site-pages.mjs +212 -0
  217. package/scripts/site-pages.test.mjs +116 -0
  218. package/site-pages/about.md +22 -0
  219. package/site-pages/privacy.md +32 -0
  220. package/src/core/components/functional/date/date.md +1 -1
  221. package/src/core/components/functional/example/example.ts +3 -1
  222. package/src/core/components/functional/if/if.ts +0 -0
  223. package/src/core/components/functional/list/list.demo.ts +0 -0
  224. package/src/core/components/functional/list/list.md +6 -2
  225. package/src/core/components/functional/list/list.ts +17 -4
  226. package/src/core/components/functional/mix/mix.md +0 -0
  227. package/src/core/components/functional/router/router.demo.ts +0 -0
  228. package/src/core/components/functional/router/router.ts +0 -0
  229. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  230. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  231. package/src/core/components/functional/sdui/component-catalog.json +2 -2
  232. package/src/core/components/functional/sdui/example.json +0 -0
  233. package/src/core/components/functional/sdui/sdui-immutable.spec.ts +74 -0
  234. package/src/core/components/functional/sdui/sdui.ts +33 -8
  235. package/src/core/components/functional/sdui/types.ts +0 -0
  236. package/src/core/components/functional/states/states.ts +0 -0
  237. package/src/core/components/functional/submit/submit.spec.ts +60 -0
  238. package/src/core/components/functional/submit/submit.ts +6 -3
  239. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  240. package/src/core/components/functional/value/value.md +0 -0
  241. package/src/core/components/functional/value/value.ts +0 -0
  242. package/src/core/components/ui/_css/size.ts +0 -0
  243. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  244. package/src/core/components/ui/card/card.md +1 -1
  245. package/src/core/components/ui/form/input/input.md +19 -1
  246. package/src/core/components/ui/form/input/input.ts +8 -2
  247. package/src/core/components/ui/form/radio/radio.md +14 -0
  248. package/src/core/components/ui/image/image.md +17 -17
  249. package/src/core/components/ui/modal/modal.md +2 -2
  250. package/src/core/decorators/subscriber/bind.ts +9 -14
  251. package/src/core/decorators/subscriber/subscribe.ts +15 -9
  252. package/src/core/decorators/subscriber/subscribe.type-test.ts +14 -5
  253. package/src/core/mixins/Subscriber.ts +0 -0
  254. package/src/core/utils/DataBindObserver.ts +0 -0
  255. package/src/core/utils/Objects.ts +0 -0
  256. package/src/core/utils/PublisherProxy.ts +166 -125
  257. package/src/core/utils/deepReadonly.spec.ts +66 -0
  258. package/src/core/utils/deepReadonly.ts +71 -0
  259. package/src/core/utils/immutableValue.spec.ts +54 -0
  260. package/src/core/utils/immutableValue.ts +102 -0
  261. package/src/core/utils/nestedDotForm.spec.ts +88 -0
  262. package/src/core/utils/publisherImmutable.spec.ts +76 -0
  263. package/src/core/utils/route.ts +0 -0
  264. package/src/core/utils/strictGet.spec.ts +61 -0
  265. package/src/core/utils/strictGet.ts +102 -0
  266. package/src/css.d.ts +19 -0
  267. package/src/docs/components/docs-demo-sources.ts +3 -3
  268. package/src/docs/decorators/bind.md +23 -24
  269. package/src/docs/docs-location.spec.ts +10 -0
  270. package/src/docs/docs-location.ts +10 -0
  271. package/src/docs/example/decorators-demo-bind-demos.ts +11 -28
  272. package/src/docs/example/docs-toggle-demos.ts +1 -1
  273. package/src/docs/example/users.ts +0 -0
  274. package/src/docs/getting-started/ai-agents.md +29 -55
  275. package/src/docs/getting-started/dataFlow.md +2 -2
  276. package/src/docs/home/home.ts +3 -1
  277. package/src/docs/misc/publisher-get-immutability-docs-crawl.json +902 -0
  278. package/src/docs/misc/publisher-get-immutability-docs-recheck.json +13 -0
  279. package/src/docs/misc/publisher-get-immutability-study.md +229 -0
  280. package/src/docs/navigation/navigation.ts +5 -1
  281. package/src/docs/search/docs-search.json +358 -58
  282. package/src/docs/search/markdown-renderer.ts +6 -1
  283. package/src/docs/tailwind/css/docs/content.css +4 -5
  284. package/src/tsconfig.declarations.json +22 -0
  285. package/src/tsconfig.emit.json +23 -0
  286. package/src/tsconfig.json +53 -5
  287. package/src/tsconfig.tsbuildinfo +1 -1
  288. package/.taste-skill/after/desktop-fold.jpg +0 -0
  289. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  290. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  291. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  292. package/.taste-skill/after/mobile-fold.jpg +0 -0
  293. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  294. package/.taste-skill/after/report.json +0 -4103
  295. package/.taste-skill/after/tablet-fold.jpg +0 -0
  296. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  297. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  298. package/.taste-skill/before/desktop-fold.jpg +0 -0
  299. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  300. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  301. package/.taste-skill/before/mobile-fold.jpg +0 -0
  302. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  303. package/.taste-skill/before/report.json +0 -2556
  304. package/.taste-skill/before/tablet-fold.jpg +0 -0
  305. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  306. package/.taste-skill/direction.json +0 -510
  307. package/.taste-skill/notes.md +0 -84
  308. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  309. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  310. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  311. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  312. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  313. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  314. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  315. package/.taste-skill/prod/report.json +0 -1973
  316. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  317. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  318. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  319. package/AUDIT.md +0 -228
  320. package/PLAN-AMELIORATION.md +0 -220
  321. package/PLAN-DOCS-AGENTS.md +0 -80
  322. package/ai/AGENTS.md +0 -56
  323. package/ai/cursor/rules/concorde-menu.mdc +0 -15
  324. package/ai/cursor/rules/concorde-scope.mdc +0 -14
  325. package/ai/cursor/rules/concorde-theme.mdc +0 -13
  326. package/ai/cursor/rules/concorde.mdc +0 -66
  327. package/ai/jetbrains/rules/concorde.md +0 -53
  328. package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
  329. package/ai/skills/concorde-imports/SKILL.md +0 -78
  330. package/ai/skills/concorde-menu/SKILL.md +0 -74
  331. package/ai/skills/concorde-scope/SKILL.md +0 -70
  332. package/ai/skills/concorde-theme/SKILL.md +0 -57
  333. package/docs/.htaccess +0 -75
  334. package/docs/404.html +0 -15
  335. package/docs/404.md +0 -5
  336. package/docs/assets/index-BgG6FFPt.js +0 -11765
  337. package/docs/assets/index-x89XINSG.css +0 -1
  338. package/docs/core/components/functional/date/date.html +0 -211
  339. package/docs/core/components/functional/date/date.md +0 -150
  340. package/docs/core/components/functional/fetch/fetch.html +0 -180
  341. package/docs/core/components/functional/fetch/fetch.md +0 -108
  342. package/docs/core/components/functional/if/if.html +0 -65
  343. package/docs/core/components/functional/if/if.md +0 -34
  344. package/docs/core/components/functional/jsonata/jsonata.html +0 -110
  345. package/docs/core/components/functional/jsonata/jsonata.md +0 -61
  346. package/docs/core/components/functional/list/list.html +0 -198
  347. package/docs/core/components/functional/list/list.md +0 -121
  348. package/docs/core/components/functional/mix/mix.html +0 -78
  349. package/docs/core/components/functional/mix/mix.md +0 -46
  350. package/docs/core/components/functional/queue/queue.html +0 -155
  351. package/docs/core/components/functional/queue/queue.md +0 -51
  352. package/docs/core/components/functional/router/router.html +0 -154
  353. package/docs/core/components/functional/router/router.md +0 -93
  354. package/docs/core/components/functional/sdui/sdui-extension-points.md +0 -94
  355. package/docs/core/components/functional/sdui/sdui.html +0 -397
  356. package/docs/core/components/functional/sdui/sdui.md +0 -307
  357. package/docs/core/components/functional/states/states.html +0 -141
  358. package/docs/core/components/functional/states/states.md +0 -112
  359. package/docs/core/components/functional/submit/submit.html +0 -178
  360. package/docs/core/components/functional/submit/submit.md +0 -106
  361. package/docs/core/components/functional/subscriber/subscriber.md +0 -91
  362. package/docs/core/components/functional/translation/translation.html +0 -60
  363. package/docs/core/components/functional/translation/translation.md +0 -38
  364. package/docs/core/components/functional/value/value.html +0 -81
  365. package/docs/core/components/functional/value/value.md +0 -47
  366. package/docs/core/components/ui/alert/alert.md +0 -186
  367. package/docs/core/components/ui/alert-messages/alert-messages.md +0 -85
  368. package/docs/core/components/ui/badge/badge.md +0 -181
  369. package/docs/core/components/ui/button/button.html +0 -309
  370. package/docs/core/components/ui/button/button.md +0 -216
  371. package/docs/core/components/ui/captcha/captcha.html +0 -80
  372. package/docs/core/components/ui/captcha/captcha.md +0 -56
  373. package/docs/core/components/ui/card/card.md +0 -215
  374. package/docs/core/components/ui/divider/divider.md +0 -126
  375. package/docs/core/components/ui/form/checkbox/checkbox.html +0 -200
  376. package/docs/core/components/ui/form/checkbox/checkbox.md +0 -125
  377. package/docs/core/components/ui/form/fieldset/fieldset.html +0 -238
  378. package/docs/core/components/ui/form/fieldset/fieldset.md +0 -161
  379. package/docs/core/components/ui/form/form-actions/form-actions.md +0 -98
  380. package/docs/core/components/ui/form/form-layout/form-layout.html +0 -115
  381. package/docs/core/components/ui/form/form-layout/form-layout.md +0 -109
  382. package/docs/core/components/ui/form/input/input.html +0 -235
  383. package/docs/core/components/ui/form/input/input.md +0 -142
  384. package/docs/core/components/ui/form/radio/radio.html +0 -144
  385. package/docs/core/components/ui/form/radio/radio.md +0 -78
  386. package/docs/core/components/ui/form/select/select.html +0 -178
  387. package/docs/core/components/ui/form/select/select.md +0 -86
  388. package/docs/core/components/ui/form/switch/switch.html +0 -146
  389. package/docs/core/components/ui/form/switch/switch.md +0 -80
  390. package/docs/core/components/ui/form/textarea/textarea.html +0 -162
  391. package/docs/core/components/ui/form/textarea/textarea.md +0 -82
  392. package/docs/core/components/ui/group/group.html +0 -113
  393. package/docs/core/components/ui/group/group.md +0 -77
  394. package/docs/core/components/ui/icon/icon.md +0 -214
  395. package/docs/core/components/ui/image/image.html +0 -194
  396. package/docs/core/components/ui/image/image.md +0 -167
  397. package/docs/core/components/ui/link/link.md +0 -81
  398. package/docs/core/components/ui/loader/loader.html +0 -114
  399. package/docs/core/components/ui/loader/loader.md +0 -87
  400. package/docs/core/components/ui/menu/menu.md +0 -370
  401. package/docs/core/components/ui/modal/modal.html +0 -324
  402. package/docs/core/components/ui/modal/modal.md +0 -211
  403. package/docs/core/components/ui/pop/pop.html +0 -250
  404. package/docs/core/components/ui/pop/pop.md +0 -216
  405. package/docs/core/components/ui/progress/progress.md +0 -109
  406. package/docs/core/components/ui/table/table.html +0 -333
  407. package/docs/core/components/ui/table/table.md +0 -267
  408. package/docs/core/components/ui/theme/theme.html +0 -116
  409. package/docs/core/components/ui/theme/theme.md +0 -97
  410. package/docs/core/components/ui/toast/toast.html +0 -185
  411. package/docs/core/components/ui/toast/toast.md +0 -147
  412. package/docs/core/components/ui/tooltip/tooltip.html +0 -112
  413. package/docs/core/components/ui/tooltip/tooltip.md +0 -89
  414. package/docs/docs/decorators/ancestor-attribute.html +0 -71
  415. package/docs/docs/decorators/ancestor-attribute.md +0 -59
  416. package/docs/docs/decorators/auto-subscribe.html +0 -61
  417. package/docs/docs/decorators/auto-subscribe.md +0 -40
  418. package/docs/docs/decorators/bind.html +0 -86
  419. package/docs/docs/decorators/bind.md +0 -77
  420. package/docs/docs/decorators/get.html +0 -166
  421. package/docs/docs/decorators/get.md +0 -160
  422. package/docs/docs/decorators/handle.html +0 -139
  423. package/docs/docs/decorators/handle.md +0 -119
  424. package/docs/docs/decorators/on-assign.html +0 -72
  425. package/docs/docs/decorators/on-assign.md +0 -63
  426. package/docs/docs/decorators/patch.html +0 -76
  427. package/docs/docs/decorators/patch.md +0 -44
  428. package/docs/docs/decorators/post.html +0 -150
  429. package/docs/docs/decorators/post.md +0 -134
  430. package/docs/docs/decorators/publish.html +0 -74
  431. package/docs/docs/decorators/publish.md +0 -56
  432. package/docs/docs/decorators/put.html +0 -83
  433. package/docs/docs/decorators/put.md +0 -51
  434. package/docs/docs/decorators/subscribe.html +0 -91
  435. package/docs/docs/decorators/subscribe.md +0 -87
  436. package/docs/docs/decorators/wait-for-ancestors.html +0 -82
  437. package/docs/docs/decorators/wait-for-ancestors.md +0 -76
  438. package/docs/docs/directives/sub.html +0 -79
  439. package/docs/docs/directives/sub.md +0 -75
  440. package/docs/docs/directives/t.html +0 -91
  441. package/docs/docs/directives/t.md +0 -73
  442. package/docs/docs/getting-started/ai-agents.md +0 -76
  443. package/docs/docs/getting-started/components.html +0 -27
  444. package/docs/docs/getting-started/components.md +0 -5
  445. package/docs/docs/getting-started/installation.html +0 -69
  446. package/docs/docs/getting-started/installation.md +0 -36
  447. package/docs/docs/getting-started/my-first-component.md +0 -227
  448. package/docs/docs/getting-started/start.html +0 -47
  449. package/docs/docs/getting-started/start.md +0 -35
  450. package/docs/docs/getting-started/theming.md +0 -253
  451. package/docs/docs/index.html +0 -99
  452. package/docs/docs/misc/api-configuration.md +0 -79
  453. package/docs/docs/misc/dataProviderKey.md +0 -168
  454. package/docs/hubs/decorators.html +0 -443
  455. package/docs/hubs/form-components.html +0 -404
  456. package/docs/hubs/remote-data.html +0 -371
  457. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  458. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  459. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  460. package/docs/img/archive/credits.json +0 -28
  461. package/docs/index.md +0 -22
  462. package/docs/src/core/components/functional/translation/translation.md +0 -38
  463. package/docs/src/docs/decorators/ancestor-attribute.md +0 -59
  464. package/docs/src/docs/decorators/auto-subscribe.md +0 -40
  465. package/docs/src/docs/decorators/bind.md +0 -77
  466. package/docs/src/docs/decorators/get.md +0 -160
  467. package/docs/src/docs/decorators/handle.md +0 -119
  468. package/docs/src/docs/decorators/on-assign.md +0 -63
  469. package/docs/src/docs/decorators/patch.md +0 -44
  470. package/docs/src/docs/decorators/post.md +0 -134
  471. package/docs/src/docs/decorators/publish.md +0 -56
  472. package/docs/src/docs/decorators/put.md +0 -51
  473. package/docs/src/docs/decorators/subscribe.md +0 -87
  474. package/docs/src/docs/decorators/wait-for-ancestors.md +0 -76
  475. package/docs/src/docs/directives/sub.md +0 -75
  476. package/docs/src/docs/directives/t.md +0 -73
  477. package/docs/src/docs/getting-started/components.md +0 -5
  478. package/docs/src/docs/getting-started/create-a-component.md +0 -136
  479. package/docs/src/docs/getting-started/dataFlow.md +0 -87
  480. package/docs/src/docs/getting-started/installation.md +0 -36
  481. package/docs/src/docs/misc/docs-mock-api.md +0 -62
  482. package/docs/src/docs/misc/dynamic-path.md +0 -71
  483. package/docs/src/docs/misc/endpoint.md +0 -45
  484. package/docs/src/docs/misc/html-integration.md +0 -14
  485. /package/{docs → dist}/img/concorde/plane_01.jpg +0 -0
  486. /package/{docs → dist}/img/concorde/plane_02.jpg +0 -0
  487. /package/{docs → dist}/img/concorde/plane_03.jpg +0 -0
  488. /package/{docs → dist}/img/concorde/plane_04.jpg +0 -0
  489. /package/{docs → dist}/img/concorde/plane_05.jpg +0 -0
  490. /package/{docs → dist}/img/concorde/plane_06.jpg +0 -0
  491. /package/{docs → dist}/img/concorde/plane_07.jpg +0 -0
  492. /package/{docs → dist}/img/concorde/plane_08.jpg +0 -0
  493. /package/{docs → dist}/img/concorde/plane_09.jpg +0 -0
  494. /package/{docs → dist}/img/concorde/plane_10.jpg +0 -0
  495. /package/{docs → dist}/img/concorde/plane_11.jpg +0 -0
  496. /package/{docs → dist}/img/concorde/plane_12.jpg +0 -0
  497. /package/{docs → dist}/img/concorde/plane_13.jpg +0 -0
@@ -1,180 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/functional/fetch" data-doc-id="core/components/functional/fetch/fetch">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Fetch — Concorde by Supersoniks</title>
7
- <meta name="description" content="sonic-fetch sends a GET request to serviceURL + endPoint and publishes the response under dataProvider, so its children and any subscriber of that provider can render it. In a Lit component, prefer th">
8
- <meta name="keywords" content="Concorde, supersoniks, core/components/functional/fetch/fetch, fetch, Fetch, functional component, sonic-fetch, web component, serviceURL, endPoint, dataProvider">
9
- <meta name="concorde-doc-id" content="core/components/functional/fetch/fetch">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/core/components/functional/fetch">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/functional/fetch.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/fetch">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 — Fetch</strong>. sonic-fetch sends a GET request to serviceURL + endPoint and publishes the response under dataProvider, so its children and any subscriber of that provider can render it. In a Lit component, prefer th <span>Doc ID: <code>core/components/functional/fetch/fetch</code>. Keywords: Concorde, supersoniks, core/components/functional/fetch/fetch, fetch, Fetch, functional component, sonic-fetch, web component, serviceURL, endPoint, dataProvider. URL: <a href="https://concorde.supersoniks.org/core/components/functional/fetch">https://concorde.supersoniks.org/core/components/functional/fetch</a>.</span></p>
20
- <h1 id="fetch">Fetch</h1>
21
- <p><strong><code>sonic-fetch</code></strong> sends a GET request to <code>serviceURL</code> + <code>endPoint</code> and publishes the response under <code>dataProvider</code>, so its children and any subscriber of that provider can render it. In a Lit component, prefer the <a href="/docs/decorators/get">@get</a> decorator; for collections, use <a href="/core/components/functional/list">List</a> or <a href="/core/components/functional/queue">Queue</a>.</p>
22
- <h2 id="basic-example">Basic example</h2>
23
- <p><code>dataProvider</code> is required; <code>serviceURL</code> and <code>dataProvider</code> can be set on an ancestor. Children are hidden while the request is pending. With no <code>serviceURL</code>, requests go to the page origin.</p>
24
- <pre><code>&lt;sonic-fetch serviceURL=&quot;/docs-mock-api&quot; endPoint=&quot;flights?direction=departures&quot; dataProvider=&quot;docsFetchNextDeparture&quot; key=&quot;flights.0&quot;&gt;
25
- &lt;p data-bind ::inner-html=&quot;Next departure: &lt;b&gt;$code&lt;/b&gt; to $city, gate $gate&quot;&gt;&lt;/p&gt;
26
- &lt;/sonic-fetch&gt;
27
- </code></pre>
28
- <h2 id="data-provider-as-endpoint">Data provider as endpoint</h2>
29
- <p>With no <code>endPoint</code>, the <code>dataProvider</code> value is used as the endpoint.</p>
30
- <pre><code>&lt;sonic-fetch serviceURL=&quot;/docs-mock-api&quot; dataProvider=&quot;flights?direction=arrivals&quot; key=&quot;flights.0&quot;&gt;
31
- &lt;p data-bind ::inner-html=&quot;Next arrival: &lt;b&gt;$code&lt;/b&gt; from $city at $time&quot;&gt;&lt;/p&gt;
32
- &lt;/sonic-fetch&gt;
33
- </code></pre>
34
- <h2 id="key">Key</h2>
35
- <p><code>key</code> keeps only part of the response, using a dot path: with <code>{ &quot;flights&quot;: [ … ] }</code> and <code>key=&quot;flights.1&quot;</code>, the provider holds the second flight. Add <code>preserveOtherKeys</code> to merge the target into the parent object instead of dropping its siblings. With no <code>key</code>, the whole response is published.</p>
36
- <pre><code>&lt;sonic-fetch serviceURL=&quot;/docs-mock-api&quot; endPoint=&quot;flights?direction=departures&quot; dataProvider=&quot;docsFetchKey&quot; key=&quot;flights.1&quot;&gt;
37
- &lt;p data-bind ::inner-html=&quot;$code to $city ($airport), status $status&quot;&gt;&lt;/p&gt;
38
- &lt;/sonic-fetch&gt;
39
- </code></pre>
40
- <h2 id="loader-and-skeleton">Loader and skeleton</h2>
41
- <p>With no <code>loader</code>, nothing is shown during the request. Set <code>loader</code> (<code>fixed</code> overlay) or <code>loader=&quot;inline&quot;</code> to show a <a href="/core/components/ui/loader">Loader</a>, or add a <code>&lt;template skeleton&gt;</code> child rendered in place of the content while loading.</p>
42
- <pre><code>&lt;sonic-fetch loader=&quot;inline&quot; serviceURL=&quot;/docs-mock-api&quot; endPoint=&quot;flights?direction=arrivals&quot; dataProvider=&quot;docsFetchLoader&quot; key=&quot;flights.2&quot;&gt;
43
- &lt;template skeleton&gt;
44
- &lt;p class=&quot;text-neutral-400&quot;&gt;Loading arrivals…&lt;/p&gt;
45
- </code></pre>
46
- <h2 id="text-responses">Text responses</h2>
47
- <p>When the response type starts with <code>text/</code>, the provider holds <code>{ text: &quot;…&quot; }</code>.</p>
48
- <pre><code>&lt;sonic-fetch endPoint=&quot;robots.txt&quot; dataProvider=&quot;docsFetchText&quot;&gt;
49
- &lt;pre class=&quot;max-h-40 overflow-auto text-xs&quot; data-bind ::inner-html=&quot;$text&quot;&gt;&lt;/pre&gt;
50
- &lt;/sonic-fetch&gt;
51
- </code></pre>
52
- <h2 id="reloading">Reloading</h2>
53
- <p><code>endPoint</code> is reactive: changing it fetches again. Call <code>invalidate()</code> on the publisher to reload the same endpoint, or set <code>refetchEveryMs</code> to poll. A request that fails with no data shows an error toast.</p>
54
- <pre><code class="language-typescript">import { PublisherManager } from &quot;@supersoniks/concorde/utils&quot;;
55
-
56
- PublisherManager.get(&quot;docsFetchNextDeparture&quot;).invalidate();
57
- </code></pre>
58
- <h2 id="api-reference">API reference</h2>
59
- <table>
60
- <thead>
61
- <tr>
62
- <th>Attribute</th>
63
- <th>Values</th>
64
- <th>Description</th>
65
- </tr>
66
- </thead>
67
- <tbody><tr>
68
- <td><code>dataProvider</code></td>
69
- <td>string</td>
70
- <td><strong>Required.</strong> Publisher that receives the data. Also the endpoint when <code>endPoint</code> is empty. Inherited from ancestors</td>
71
- </tr>
72
- <tr>
73
- <td><code>serviceURL</code></td>
74
- <td>URL (default page origin)</td>
75
- <td>Base URL of the API. Inherited from ancestors</td>
76
- </tr>
77
- <tr>
78
- <td><code>endPoint</code></td>
79
- <td>string</td>
80
- <td>Path appended to <code>serviceURL</code>. Reactive</td>
81
- </tr>
82
- <tr>
83
- <td><code>key</code></td>
84
- <td>dot path</td>
85
- <td>Part of the response to publish</td>
86
- </tr>
87
- <tr>
88
- <td><code>preserveOtherKeys</code></td>
89
- <td>boolean</td>
90
- <td>With <code>key</code>, keeps the sibling properties of the target</td>
91
- </tr>
92
- <tr>
93
- <td><code>loader</code></td>
94
- <td><code>fixed</code> (when empty) · <code>inline</code></td>
95
- <td>Loader shown during the request. None by default</td>
96
- </tr>
97
- <tr>
98
- <td><code>lazyload</code></td>
99
- <td>boolean</td>
100
- <td>Fetches when the element nears the viewport</td>
101
- </tr>
102
- <tr>
103
- <td><code>lazyBoundsRatio</code></td>
104
- <td>number (default <code>1</code>)</td>
105
- <td>Viewport ratio used as margin by <code>lazyload</code></td>
106
- </tr>
107
- <tr>
108
- <td><code>refetchEveryMs</code></td>
109
- <td>number (default <code>0</code>)</td>
110
- <td>Polling interval in milliseconds; <code>0</code> disables it</td>
111
- </tr>
112
- <tr>
113
- <td><code>headersDataProvider</code></td>
114
- <td>string</td>
115
- <td>Publisher whose data is sent as request headers. Inherited from ancestors</td>
116
- </tr>
117
- <tr>
118
- <td><code>token</code></td>
119
- <td>string</td>
120
- <td>Bearer token. Inherited from ancestors</td>
121
- </tr>
122
- <tr>
123
- <td><code>userName</code> · <code>password</code> · <code>tokenProvider</code></td>
124
- <td>string</td>
125
- <td>Basic auth used to get a token from <code>tokenProvider</code> when no <code>token</code> is set. Inherited from ancestors</td>
126
- </tr>
127
- <tr>
128
- <td><code>credentials</code></td>
129
- <td><code>omit</code> · <code>same-origin</code> · <code>include</code></td>
130
- <td><code>fetch</code> credentials mode. Inherited from ancestors</td>
131
- </tr>
132
- <tr>
133
- <td><code>cache</code></td>
134
- <td><code>RequestCache</code> value</td>
135
- <td><code>fetch</code> cache mode</td>
136
- </tr>
137
- <tr>
138
- <td><code>addHTTPResponse</code></td>
139
- <td>boolean</td>
140
- <td>Adds the HTTP response as <code>_sonic_http_response_</code> on the data. Inherited from ancestors</td>
141
- </tr>
142
- <tr>
143
- <td><code>localStorage</code></td>
144
- <td><code>disabled</code> (default) · <code>enabled</code></td>
145
- <td>Persists the publisher in <code>localStorage</code></td>
146
- </tr>
147
- </tbody></table>
148
- <table>
149
- <thead>
150
- <tr>
151
- <th>Slot</th>
152
- <th>Description</th>
153
- </tr>
154
- </thead>
155
- <tbody><tr>
156
- <td><em>(default)</em></td>
157
- <td>Content, hidden while the request is pending</td>
158
- </tr>
159
- </tbody></table>
160
- <table>
161
- <thead>
162
- <tr>
163
- <th>Event</th>
164
- <th>Description</th>
165
- </tr>
166
- </thead>
167
- <tbody><tr>
168
- <td><code>loading</code></td>
169
- <td>The request starts</td>
170
- </tr>
171
- <tr>
172
- <td><code>load</code></td>
173
- <td>The data is published</td>
174
- </tr>
175
- </tbody></table>
176
-
177
- </article>
178
- </main>
179
- </body>
180
- </html>
@@ -1,108 +0,0 @@
1
- # Fetch
2
-
3
- **`sonic-fetch`** sends a GET request to `serviceURL` + `endPoint` and publishes the response under `dataProvider`, so its children and any subscriber of that provider can render it. In a Lit component, prefer the [@get](/docs/decorators/get) decorator; for collections, use [List](/core/components/functional/list) or [Queue](/core/components/functional/queue).
4
-
5
- ## Basic example
6
-
7
- `dataProvider` is required; `serviceURL` and `dataProvider` can be set on an ancestor. Children are hidden while the request is pending. With no `serviceURL`, requests go to the page origin.
8
-
9
- <sonic-code>
10
- <template>
11
- <sonic-fetch serviceURL="/docs-mock-api" endPoint="flights?direction=departures" dataProvider="docsFetchNextDeparture" key="flights.0">
12
- <p data-bind ::inner-html="Next departure: <b>$code</b> to $city, gate $gate"></p>
13
- </sonic-fetch>
14
- </template>
15
- </sonic-code>
16
-
17
- ## Data provider as endpoint
18
-
19
- With no `endPoint`, the `dataProvider` value is used as the endpoint.
20
-
21
- <sonic-code>
22
- <template>
23
- <sonic-fetch serviceURL="/docs-mock-api" dataProvider="flights?direction=arrivals" key="flights.0">
24
- <p data-bind ::inner-html="Next arrival: <b>$code</b> from $city at $time"></p>
25
- </sonic-fetch>
26
- </template>
27
- </sonic-code>
28
-
29
- ## Key
30
-
31
- `key` keeps only part of the response, using a dot path: with `{ "flights": [ … ] }` and `key="flights.1"`, the provider holds the second flight. Add `preserveOtherKeys` to merge the target into the parent object instead of dropping its siblings. With no `key`, the whole response is published.
32
-
33
- <sonic-code>
34
- <template>
35
- <sonic-fetch serviceURL="/docs-mock-api" endPoint="flights?direction=departures" dataProvider="docsFetchKey" key="flights.1">
36
- <p data-bind ::inner-html="$code to $city ($airport), status $status"></p>
37
- </sonic-fetch>
38
- </template>
39
- </sonic-code>
40
-
41
- ## Loader and skeleton
42
-
43
- With no `loader`, nothing is shown during the request. Set `loader` (`fixed` overlay) or `loader="inline"` to show a [Loader](/core/components/ui/loader), or add a `<template skeleton>` child rendered in place of the content while loading.
44
-
45
- <sonic-code>
46
- <template>
47
- <sonic-fetch loader="inline" serviceURL="/docs-mock-api" endPoint="flights?direction=arrivals" dataProvider="docsFetchLoader" key="flights.2">
48
- <template skeleton>
49
- <p class="text-neutral-400">Loading arrivals…</p>
50
- </template>
51
- <p data-bind ::inner-html="<b>$code</b> from $city: $status"></p>
52
- </sonic-fetch>
53
- </template>
54
- </sonic-code>
55
-
56
- ## Text responses
57
-
58
- When the response type starts with `text/`, the provider holds `{ text: "…" }`.
59
-
60
- <sonic-code>
61
- <template>
62
- <sonic-fetch endPoint="robots.txt" dataProvider="docsFetchText">
63
- <pre class="max-h-40 overflow-auto text-xs" data-bind ::inner-html="$text"></pre>
64
- </sonic-fetch>
65
- </template>
66
- </sonic-code>
67
-
68
- ## Reloading
69
-
70
- `endPoint` is reactive: changing it fetches again. Call `invalidate()` on the publisher to reload the same endpoint, or set `refetchEveryMs` to poll. A request that fails with no data shows an error toast.
71
-
72
- <sonic-code language="typescript">
73
- <template>
74
- import { PublisherManager } from "@supersoniks/concorde/utils";
75
-
76
- PublisherManager.get("docsFetchNextDeparture").invalidate();
77
- </template>
78
- </sonic-code>
79
-
80
- ## API reference
81
-
82
- | Attribute | Values | Description |
83
- |-----------|--------|-------------|
84
- | `dataProvider` | string | **Required.** Publisher that receives the data. Also the endpoint when `endPoint` is empty. Inherited from ancestors |
85
- | `serviceURL` | URL (default page origin) | Base URL of the API. Inherited from ancestors |
86
- | `endPoint` | string | Path appended to `serviceURL`. Reactive |
87
- | `key` | dot path | Part of the response to publish |
88
- | `preserveOtherKeys` | boolean | With `key`, keeps the sibling properties of the target |
89
- | `loader` | `fixed` (when empty) · `inline` | Loader shown during the request. None by default |
90
- | `lazyload` | boolean | Fetches when the element nears the viewport |
91
- | `lazyBoundsRatio` | number (default `1`) | Viewport ratio used as margin by `lazyload` |
92
- | `refetchEveryMs` | number (default `0`) | Polling interval in milliseconds; `0` disables it |
93
- | `headersDataProvider` | string | Publisher whose data is sent as request headers. Inherited from ancestors |
94
- | `token` | string | Bearer token. Inherited from ancestors |
95
- | `userName` · `password` · `tokenProvider` | string | Basic auth used to get a token from `tokenProvider` when no `token` is set. Inherited from ancestors |
96
- | `credentials` | `omit` · `same-origin` · `include` | `fetch` credentials mode. Inherited from ancestors |
97
- | `cache` | `RequestCache` value | `fetch` cache mode |
98
- | `addHTTPResponse` | boolean | Adds the HTTP response as `_sonic_http_response_` on the data. Inherited from ancestors |
99
- | `localStorage` | `disabled` (default) · `enabled` | Persists the publisher in `localStorage` |
100
-
101
- | Slot | Description |
102
- |------|-------------|
103
- | *(default)* | Content, hidden while the request is pending |
104
-
105
- | Event | Description |
106
- |-------|-------------|
107
- | `loading` | The request starts |
108
- | `load` | The data is published |
@@ -1,65 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/functional/if" data-doc-id="core/components/functional/if/if">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>If — Concorde by Supersoniks</title>
7
- <meta name="description" content="sonic-if renders its default slot only while condition is true. Use it to show or hide a block from reactive state; with no condition, the content is not rendered. The host uses display: contents, so ">
8
- <meta name="keywords" content="Concorde, supersoniks, core/components/functional/if/if, if, If, functional component, sonic-if, web component, condition, display: contents, condition=&quot;false&quot;, .condition, @subscribe, formDataProvider">
9
- <meta name="concorde-doc-id" content="core/components/functional/if/if">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/core/components/functional/if">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/functional/if.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/if">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 — If</strong>. sonic-if renders its default slot only while condition is true. Use it to show or hide a block from reactive state; with no condition, the content is not rendered. The host uses display: contents, so <span>Doc ID: <code>core/components/functional/if/if</code>. Keywords: Concorde, supersoniks, core/components/functional/if/if, if, If, functional component, sonic-if, web component, condition, display: contents, condition=&quot;false&quot;, .condition, @subscribe, formDataProvider. URL: <a href="https://concorde.supersoniks.org/core/components/functional/if">https://concorde.supersoniks.org/core/components/functional/if</a>.</span></p>
20
- <h1 id="if">If</h1>
21
- <p><strong><code>sonic-if</code></strong> renders its default slot only while <code>condition</code> is true. Use it to show or hide a block from reactive state; with no <code>condition</code>, the content is not rendered. The host uses <code>display: contents</code>, so it adds no box to the layout.</p>
22
- <h2 id="basic-example">Basic example</h2>
23
- <pre><code>&lt;sonic-if condition&gt;
24
- &lt;sonic-badge type=&quot;success&quot;&gt;CN 001 · Boarding&lt;/sonic-badge&gt;
25
- &lt;/sonic-if&gt;
26
- &lt;sonic-if&gt;
27
- &lt;sonic-badge type=&quot;danger&quot;&gt;Never rendered&lt;/sonic-badge&gt;
28
- &lt;/sonic-if&gt;
29
- </code></pre>
30
- <p><code>condition</code> is a boolean attribute: <strong>any value, even <code>condition=&quot;false&quot;</code>, counts as true</strong>. To toggle it, remove the attribute or bind the property.</p>
31
- <h2 id="reactive-condition">Reactive condition</h2>
32
- <p>In Lit, bind <code>.condition</code> to state read with <code>@subscribe</code>. Here a checkbox writes to a <code>formDataProvider</code> and the component re-renders from it.</p>
33
- <p><docs-lit-demo for="docs-toggle-if-demo"></docs-lit-demo></p>
34
- <h2 id="api-reference">API reference</h2>
35
- <table>
36
- <thead>
37
- <tr>
38
- <th>Attribute</th>
39
- <th>Values</th>
40
- <th>Description</th>
41
- </tr>
42
- </thead>
43
- <tbody><tr>
44
- <td><code>condition</code></td>
45
- <td>boolean (default <code>false</code>)</td>
46
- <td>Renders the default slot when true</td>
47
- </tr>
48
- </tbody></table>
49
- <table>
50
- <thead>
51
- <tr>
52
- <th>Slot</th>
53
- <th>Description</th>
54
- </tr>
55
- </thead>
56
- <tbody><tr>
57
- <td><em>(default)</em></td>
58
- <td>Content rendered while <code>condition</code> is true</td>
59
- </tr>
60
- </tbody></table>
61
-
62
- </article>
63
- </main>
64
- </body>
65
- </html>
@@ -1,34 +0,0 @@
1
- # If
2
-
3
- **`sonic-if`** renders its default slot only while `condition` is true. Use it to show or hide a block from reactive state; with no `condition`, the content is not rendered. The host uses `display: contents`, so it adds no box to the layout.
4
-
5
- ## Basic example
6
-
7
- <sonic-code>
8
- <template>
9
- <sonic-if condition>
10
- <sonic-badge type="success">CN 001 · Boarding</sonic-badge>
11
- </sonic-if>
12
- <sonic-if>
13
- <sonic-badge type="danger">Never rendered</sonic-badge>
14
- </sonic-if>
15
- </template>
16
- </sonic-code>
17
-
18
- `condition` is a boolean attribute: **any value, even `condition="false"`, counts as true**. To toggle it, remove the attribute or bind the property.
19
-
20
- ## Reactive condition
21
-
22
- In Lit, bind `.condition` to state read with `@subscribe`. Here a checkbox writes to a `formDataProvider` and the component re-renders from it.
23
-
24
- <docs-lit-demo for="docs-toggle-if-demo"></docs-lit-demo>
25
-
26
- ## API reference
27
-
28
- | Attribute | Values | Description |
29
- |-----------|--------|-------------|
30
- | `condition` | boolean (default `false`) | Renders the default slot when true |
31
-
32
- | Slot | Description |
33
- |------|-------------|
34
- | *(default)* | Content rendered while `condition` is true |
@@ -1,110 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/functional/jsonata" data-doc-id="core/components/functional/jsonata/jsonata">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Jsonata — Concorde by Supersoniks</title>
7
- <meta name="description" content="sonic-jsonata reads one data provider, evaluates a JSONata expression on it and writes the result to another data provider. Use it for read-only aggregates such as groups, rankings and totals; use Mix">
8
- <meta name="keywords" content="Concorde, supersoniks, core/components/functional/jsonata/jsonata, jsonata, Jsonata, functional component, sonic-jsonata, web component, derive, inputProvider, $input, outputProvider, formDataProvider, $direction, $append([], …), ( … ), sonic-value">
9
- <meta name="concorde-doc-id" content="core/components/functional/jsonata/jsonata">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/core/components/functional/jsonata">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/functional/jsonata.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/jsonata">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 — Jsonata</strong>. sonic-jsonata reads one data provider, evaluates a JSONata expression on it and writes the result to another data provider. Use it for read-only aggregates such as groups, rankings and totals; use Mix <span>Doc ID: <code>core/components/functional/jsonata/jsonata</code>. Keywords: Concorde, supersoniks, core/components/functional/jsonata/jsonata, jsonata, Jsonata, functional component, sonic-jsonata, web component, derive, inputProvider, $input, outputProvider, formDataProvider, $direction, $append([], …), ( … ), sonic-value. URL: <a href="https://concorde.supersoniks.org/core/components/functional/jsonata">https://concorde.supersoniks.org/core/components/functional/jsonata</a>.</span></p>
20
- <h1 id="jsonata">Jsonata</h1>
21
- <p><strong><code>sonic-jsonata</code></strong> reads one data provider, evaluates a <a href="https://jsonata.org">JSONata</a> expression on it and writes the result to another data provider. Use it for read-only aggregates such as groups, rankings and totals; use <a href="/core/components/functional/mix">Mix</a> to compose data in both directions, and <a href="/docs/getting-started/dataFlow"><code>derive</code></a> for several inputs or a TypeScript function.</p>
22
- <h2 id="group-and-sort">Group and sort</h2>
23
- <p><code>inputProvider</code> is available as <code>$input</code> and the result is written to <code>outputProvider</code>. Each field of the optional <code>formDataProvider</code> store becomes a variable (<code>$direction</code> here): changing it recomputes the output without fetching again.</p>
24
- <p><docs-lit-demo for="docs-jsonata-space-cats-demo"></docs-lit-demo></p>
25
- <p>JSONata returns a single object instead of an array when only one item matches. Wrap the expression in <code>$append([], …)</code> when a list renders the output.</p>
26
- <h2 id="totals">Totals</h2>
27
- <p>A <code>( … )</code> block declares local variables and returns an object; read its fields with <code>sonic-value</code>. Change the reserve to recompute the block fuel.</p>
28
- <p><docs-lit-demo for="docs-jsonata-table-totals-demo"></docs-lit-demo></p>
29
- <h2 id="states">States</h2>
30
- <p>The evaluation state is published on <code>{outputProvider}/_state_</code> as <code>{ status, error }</code>, with <code>status</code> among <code>loading</code> · <code>ready</code> · <code>empty</code> · <code>error</code>. Display it with <a href="/core/components/functional/states">States</a>.</p>
31
- <pre><code>&lt;div serviceURL=&quot;/docs-mock-api&quot;&gt;
32
- &lt;sonic-fetch dataProvider=&quot;jsonataStateFlights&quot; endPoint=&quot;flights&quot; key=&quot;flights&quot;&gt;&lt;/sonic-fetch&gt;
33
- &lt;sonic-jsonata
34
- inputProvider=&quot;jsonataStateFlights&quot;
35
- outputProvider=&quot;jsonataLanded&quot;
36
- expression=&#39;{&quot;landed&quot;: $count($input[status=&quot;landed&quot;])}&#39;
37
- &gt;&lt;/sonic-jsonata&gt;
38
- &lt;sonic-states dataProvider=&quot;jsonataLanded/_state_&quot; data-path=&quot;status&quot;&gt;
39
- &lt;template data-value=&quot;loading&quot;&gt;Counting flights…
40
- </code></pre>
41
- <h2 id="api-reference">API reference</h2>
42
- <table>
43
- <thead>
44
- <tr>
45
- <th>Attribute</th>
46
- <th>Values</th>
47
- <th>Description</th>
48
- </tr>
49
- </thead>
50
- <tbody><tr>
51
- <td><code>inputProvider</code></td>
52
- <td>string</td>
53
- <td>Source data provider, bound to <code>$input</code>. Required</td>
54
- </tr>
55
- <tr>
56
- <td><code>outputProvider</code></td>
57
- <td>string</td>
58
- <td>Data provider that receives the result. Required</td>
59
- </tr>
60
- <tr>
61
- <td><code>expression</code></td>
62
- <td>JSONata string (max 8,000 characters)</td>
63
- <td>Expression to evaluate. Required</td>
64
- </tr>
65
- <tr>
66
- <td><code>formDataProvider</code></td>
67
- <td>string</td>
68
- <td>Store whose fields become variables (<code>$name</code>)</td>
69
- </tr>
70
- <tr>
71
- <td><code>outputSchema</code></td>
72
- <td>object</td>
73
- <td>Light check of the result: <code>type</code> and <code>required</code> only; a mismatch sets the <code>error</code> state</td>
74
- </tr>
75
- </tbody></table>
76
- <table>
77
- <thead>
78
- <tr>
79
- <th>Helper</th>
80
- <th>Description</th>
81
- </tr>
82
- </thead>
83
- <tbody><tr>
84
- <td><code>$ucFirst(value)</code></td>
85
- <td>Upper-cases the first letter</td>
86
- </tr>
87
- <tr>
88
- <td><code>$currency(value, locale?, currency?)</code></td>
89
- <td>Formats a price (default <code>fr-FR</code> and <code>EUR</code>)</td>
90
- </tr>
91
- <tr>
92
- <td><code>$percent(value, locale?, digits?)</code></td>
93
- <td>Formats a ratio as a percentage (default <code>fr-FR</code> and <code>0</code> digits)</td>
94
- </tr>
95
- <tr>
96
- <td><code>$date(value, locale?, optionsJson?)</code></td>
97
- <td>Formats a date (default <code>fr-FR</code>, medium style)</td>
98
- </tr>
99
- <tr>
100
- <td><code>$toChart(items, labelKey, valueKey, datasetLabel?)</code></td>
101
- <td>Converts rows to <code>{ labels, datasets }</code> for a chart</td>
102
- </tr>
103
- </tbody></table>
104
- <p>Expressions have no access to the DOM or the network.</p>
105
- <p>No slots.</p>
106
-
107
- </article>
108
- </main>
109
- </body>
110
- </html>
@@ -1,61 +0,0 @@
1
- # Jsonata
2
-
3
- **`sonic-jsonata`** reads one data provider, evaluates a [JSONata](https://jsonata.org) expression on it and writes the result to another data provider. Use it for read-only aggregates such as groups, rankings and totals; use [Mix](/core/components/functional/mix) to compose data in both directions, and [`derive`](/docs/getting-started/dataFlow) for several inputs or a TypeScript function.
4
-
5
- ## Group and sort
6
-
7
- `inputProvider` is available as `$input` and the result is written to `outputProvider`. Each field of the optional `formDataProvider` store becomes a variable (`$direction` here): changing it recomputes the output without fetching again.
8
-
9
- <docs-lit-demo for="docs-jsonata-space-cats-demo"></docs-lit-demo>
10
-
11
- JSONata returns a single object instead of an array when only one item matches. Wrap the expression in `$append([], …)` when a list renders the output.
12
-
13
- ## Totals
14
-
15
- A `( … )` block declares local variables and returns an object; read its fields with `sonic-value`. Change the reserve to recompute the block fuel.
16
-
17
- <docs-lit-demo for="docs-jsonata-table-totals-demo"></docs-lit-demo>
18
-
19
- ## States
20
-
21
- The evaluation state is published on `{outputProvider}/_state_` as `{ status, error }`, with `status` among `loading` · `ready` · `empty` · `error`. Display it with [States](/core/components/functional/states).
22
-
23
- <sonic-code>
24
- <template>
25
- <div serviceURL="/docs-mock-api">
26
- <sonic-fetch dataProvider="jsonataStateFlights" endPoint="flights" key="flights"></sonic-fetch>
27
- <sonic-jsonata
28
- inputProvider="jsonataStateFlights"
29
- outputProvider="jsonataLanded"
30
- expression='{"landed": $count($input[status="landed"])}'
31
- ></sonic-jsonata>
32
- <sonic-states dataProvider="jsonataLanded/_state_" data-path="status">
33
- <template data-value="loading">Counting flights…</template>
34
- <template data-value="ready">Landed flights: <sonic-value dataProvider="jsonataLanded" key="landed"></sonic-value></template>
35
- <template data-value="error">Expression error</template>
36
- </sonic-states>
37
- </div>
38
- </template>
39
- </sonic-code>
40
-
41
- ## API reference
42
-
43
- | Attribute | Values | Description |
44
- |-----------|--------|-------------|
45
- | `inputProvider` | string | Source data provider, bound to `$input`. Required |
46
- | `outputProvider` | string | Data provider that receives the result. Required |
47
- | `expression` | JSONata string (max 8,000 characters) | Expression to evaluate. Required |
48
- | `formDataProvider` | string | Store whose fields become variables (`$name`) |
49
- | `outputSchema` | object | Light check of the result: `type` and `required` only; a mismatch sets the `error` state |
50
-
51
- | Helper | Description |
52
- |--------|-------------|
53
- | `$ucFirst(value)` | Upper-cases the first letter |
54
- | `$currency(value, locale?, currency?)` | Formats a price (default `fr-FR` and `EUR`) |
55
- | `$percent(value, locale?, digits?)` | Formats a ratio as a percentage (default `fr-FR` and `0` digits) |
56
- | `$date(value, locale?, optionsJson?)` | Formats a date (default `fr-FR`, medium style) |
57
- | `$toChart(items, labelKey, valueKey, datasetLabel?)` | Converts rows to `{ labels, datasets }` for a chart |
58
-
59
- Expressions have no access to the DOM or the network.
60
-
61
- No slots.