@supersoniks/concorde 5.1.0 → 5.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (628) hide show
  1. package/.agents/skills/concorde-docs/SKILL.md +153 -0
  2. package/.agents/skills/{concorde-component-docs/template.md → concorde-docs/templates/component.md} +6 -2
  3. package/.agents/skills/concorde-docs/templates/decorator.md +43 -0
  4. package/.agents/skills/concorde-docs/templates/guide.md +25 -0
  5. package/.claude/launch.json +15 -0
  6. package/.claude/vite.http.config.mjs +7 -0
  7. package/.taste-skill/after/desktop-fold.jpg +0 -0
  8. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  9. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  10. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  11. package/.taste-skill/after/mobile-fold.jpg +0 -0
  12. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  13. package/.taste-skill/after/report.json +4103 -0
  14. package/.taste-skill/after/tablet-fold.jpg +0 -0
  15. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  16. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  17. package/.taste-skill/before/desktop-fold.jpg +0 -0
  18. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  19. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  20. package/.taste-skill/before/mobile-fold.jpg +0 -0
  21. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  22. package/.taste-skill/before/report.json +2556 -0
  23. package/.taste-skill/before/tablet-fold.jpg +0 -0
  24. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  25. package/.taste-skill/direction.json +510 -0
  26. package/.taste-skill/notes.md +84 -0
  27. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  28. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  29. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  30. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  31. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  32. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  33. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  34. package/.taste-skill/prod/report.json +1973 -0
  35. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  36. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  37. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  38. package/.tmp-cem/custom-elements.json +2013 -2013
  39. package/AUDIT.md +228 -0
  40. package/PLAN-AMELIORATION.md +220 -0
  41. package/PLAN-DOCS-AGENTS.md +80 -0
  42. package/README.md +3 -3
  43. package/ai/skills/concorde/SKILL.md +1 -1
  44. package/ai/skills/concorde-get-set-dp/SKILL.md +3 -3
  45. package/ai/skills/concorde-theme/SKILL.md +1 -1
  46. package/build-infos.json +1 -1
  47. package/concorde-core.bundle.js +16 -16
  48. package/concorde-core.es.js +235 -233
  49. package/dist/concorde-core.bundle.js +16 -16
  50. package/dist/concorde-core.es.js +235 -233
  51. package/dist/img/archive/concorde-001-2cv.webp +0 -0
  52. package/dist/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  53. package/dist/img/archive/concorde-red-arrows-2002.webm +0 -0
  54. package/dist/img/archive/credits.json +28 -0
  55. package/docs/.htaccess +75 -0
  56. package/docs/404.html +15 -0
  57. package/docs/404.md +5 -0
  58. package/docs/assets/index-BgG6FFPt.js +11765 -0
  59. package/docs/assets/index-x89XINSG.css +1 -0
  60. package/docs/core/components/functional/date/date.html +211 -0
  61. package/docs/core/components/functional/date/date.md +150 -0
  62. package/docs/core/components/functional/fetch/fetch.html +180 -0
  63. package/docs/core/components/functional/fetch/fetch.md +108 -0
  64. package/docs/core/components/functional/if/if.html +65 -0
  65. package/docs/core/components/functional/if/if.md +34 -0
  66. package/docs/core/components/functional/jsonata/jsonata.html +110 -0
  67. package/docs/core/components/functional/jsonata/jsonata.md +61 -0
  68. package/docs/core/components/functional/list/list.html +198 -0
  69. package/docs/core/components/functional/list/list.md +121 -0
  70. package/docs/core/components/functional/mix/mix.html +78 -0
  71. package/docs/core/components/functional/mix/mix.md +46 -0
  72. package/docs/core/components/functional/queue/queue.html +155 -0
  73. package/docs/core/components/functional/queue/queue.md +51 -0
  74. package/docs/core/components/functional/router/router.html +154 -0
  75. package/docs/core/components/functional/router/router.md +93 -0
  76. package/docs/core/components/functional/sdui/sdui-extension-points.html +127 -0
  77. package/docs/core/components/functional/sdui/sdui-extension-points.md +94 -0
  78. package/docs/core/components/functional/sdui/sdui.html +397 -0
  79. package/docs/core/components/functional/sdui/sdui.md +307 -0
  80. package/docs/core/components/functional/states/states.html +141 -0
  81. package/docs/core/components/functional/states/states.md +112 -0
  82. package/docs/core/components/functional/submit/submit.html +178 -0
  83. package/docs/core/components/functional/submit/submit.md +106 -0
  84. package/docs/{crawl/core → core}/components/functional/subscriber/subscriber.html +6 -5
  85. package/docs/core/components/functional/subscriber/subscriber.md +91 -0
  86. package/docs/core/components/functional/translation/translation.html +60 -0
  87. package/docs/core/components/functional/translation/translation.md +38 -0
  88. package/docs/core/components/functional/value/value.html +81 -0
  89. package/docs/core/components/functional/value/value.md +47 -0
  90. package/docs/core/components/ui/alert/alert.html +201 -0
  91. package/docs/core/components/ui/alert/alert.md +186 -0
  92. package/docs/core/components/ui/alert-messages/alert-messages.html +132 -0
  93. package/docs/core/components/ui/alert-messages/alert-messages.md +85 -0
  94. package/docs/core/components/ui/badge/badge.html +197 -0
  95. package/docs/core/components/ui/badge/badge.md +181 -0
  96. package/docs/core/components/ui/button/button.html +309 -0
  97. package/docs/core/components/ui/button/button.md +216 -0
  98. package/docs/core/components/ui/captcha/captcha.html +80 -0
  99. package/docs/core/components/ui/captcha/captcha.md +56 -0
  100. package/docs/core/components/ui/card/card.html +254 -0
  101. package/docs/core/components/ui/card/card.md +215 -0
  102. package/docs/core/components/ui/divider/divider.html +144 -0
  103. package/docs/core/components/ui/divider/divider.md +126 -0
  104. package/docs/core/components/ui/form/checkbox/checkbox.html +200 -0
  105. package/docs/core/components/ui/form/checkbox/checkbox.md +125 -0
  106. package/docs/core/components/ui/form/fieldset/fieldset.html +238 -0
  107. package/docs/core/components/ui/form/fieldset/fieldset.md +161 -0
  108. package/docs/core/components/ui/form/form-actions/form-actions.html +122 -0
  109. package/docs/core/components/ui/form/form-actions/form-actions.md +98 -0
  110. package/docs/core/components/ui/form/form-layout/form-layout.html +115 -0
  111. package/docs/core/components/ui/form/form-layout/form-layout.md +109 -0
  112. package/docs/core/components/ui/form/input/input.html +235 -0
  113. package/docs/core/components/ui/form/input/input.md +142 -0
  114. package/docs/core/components/ui/form/radio/radio.html +144 -0
  115. package/docs/core/components/ui/form/radio/radio.md +78 -0
  116. package/docs/core/components/ui/form/select/select.html +178 -0
  117. package/docs/core/components/ui/form/select/select.md +86 -0
  118. package/docs/core/components/ui/form/switch/switch.html +146 -0
  119. package/docs/core/components/ui/form/switch/switch.md +80 -0
  120. package/docs/core/components/ui/form/textarea/textarea.html +162 -0
  121. package/docs/core/components/ui/form/textarea/textarea.md +82 -0
  122. package/docs/core/components/ui/group/group.html +113 -0
  123. package/docs/core/components/ui/group/group.md +77 -0
  124. package/docs/core/components/ui/icon/icon.html +223 -0
  125. package/docs/core/components/ui/icon/icon.md +214 -0
  126. package/docs/core/components/ui/image/image.html +194 -0
  127. package/docs/core/components/ui/image/image.md +167 -0
  128. package/docs/core/components/ui/link/link.html +101 -0
  129. package/docs/core/components/ui/link/link.md +81 -0
  130. package/docs/core/components/ui/loader/loader.html +114 -0
  131. package/docs/core/components/ui/loader/loader.md +87 -0
  132. package/docs/{crawl/core → core}/components/ui/menu/menu.html +189 -116
  133. package/docs/core/components/ui/menu/menu.md +370 -0
  134. package/docs/core/components/ui/modal/modal.html +324 -0
  135. package/docs/core/components/ui/modal/modal.md +211 -0
  136. package/docs/core/components/ui/pop/pop.html +250 -0
  137. package/docs/core/components/ui/pop/pop.md +216 -0
  138. package/docs/core/components/ui/progress/progress.html +132 -0
  139. package/docs/core/components/ui/progress/progress.md +109 -0
  140. package/docs/core/components/ui/table/table.html +333 -0
  141. package/docs/core/components/ui/table/table.md +267 -0
  142. package/docs/core/components/ui/theme/theme.html +116 -0
  143. package/docs/core/components/ui/theme/theme.md +97 -0
  144. package/docs/core/components/ui/toast/toast.html +185 -0
  145. package/docs/core/components/ui/toast/toast.md +147 -0
  146. package/docs/core/components/ui/tooltip/tooltip.html +112 -0
  147. package/docs/core/components/ui/tooltip/tooltip.md +89 -0
  148. package/docs/docs/decorators/ancestor-attribute.html +71 -0
  149. package/docs/docs/decorators/ancestor-attribute.md +59 -0
  150. package/docs/docs/decorators/auto-subscribe.html +61 -0
  151. package/docs/docs/decorators/auto-subscribe.md +40 -0
  152. package/docs/docs/decorators/bind.html +86 -0
  153. package/docs/docs/decorators/bind.md +77 -0
  154. package/docs/docs/decorators/get.html +166 -0
  155. package/docs/docs/decorators/get.md +160 -0
  156. package/docs/docs/decorators/handle.html +139 -0
  157. package/docs/docs/decorators/handle.md +119 -0
  158. package/docs/docs/decorators/on-assign.html +72 -0
  159. package/docs/docs/decorators/on-assign.md +63 -0
  160. package/docs/docs/decorators/patch.html +76 -0
  161. package/docs/docs/decorators/patch.md +44 -0
  162. package/docs/docs/decorators/post.html +150 -0
  163. package/docs/docs/decorators/post.md +134 -0
  164. package/docs/docs/decorators/publish.html +74 -0
  165. package/docs/docs/decorators/publish.md +56 -0
  166. package/docs/docs/decorators/put.html +83 -0
  167. package/docs/docs/decorators/put.md +51 -0
  168. package/docs/docs/decorators/subscribe.html +91 -0
  169. package/docs/docs/decorators/subscribe.md +87 -0
  170. package/docs/docs/decorators/wait-for-ancestors.html +82 -0
  171. package/docs/docs/decorators/wait-for-ancestors.md +76 -0
  172. package/docs/docs/directives/sub.html +79 -0
  173. package/docs/docs/directives/sub.md +75 -0
  174. package/docs/docs/directives/t.html +91 -0
  175. package/docs/docs/directives/t.md +73 -0
  176. package/docs/{crawl/docs/_getting-started → docs/getting-started}/ai-agents.html +12 -11
  177. package/{src/docs/_getting-started → docs/docs/getting-started}/ai-agents.md +3 -3
  178. package/docs/docs/getting-started/components.html +27 -0
  179. package/docs/docs/getting-started/components.md +5 -0
  180. package/docs/{crawl/docs/_getting-started → docs/getting-started}/create-a-component.html +11 -14
  181. package/docs/{src/docs/_getting-started → docs/getting-started}/create-a-component.md +3 -6
  182. package/docs/{crawl/docs/_core-concept → docs/getting-started}/dataFlow.html +26 -29
  183. package/docs/{src/docs/_core-concept → docs/getting-started}/dataFlow.md +17 -18
  184. package/docs/docs/getting-started/installation.html +69 -0
  185. package/docs/docs/getting-started/installation.md +36 -0
  186. package/docs/{crawl/docs/_getting-started → docs/getting-started}/my-first-component.html +13 -22
  187. package/docs/{src/docs/_getting-started → docs/getting-started}/my-first-component.md +5 -14
  188. package/docs/docs/getting-started/start.html +47 -0
  189. package/{src/docs/_getting-started → docs/docs/getting-started}/start.md +1 -13
  190. package/docs/docs/getting-started/theming.html +334 -0
  191. package/{src/docs/_getting-started → docs/docs/getting-started}/theming.md +2 -2
  192. package/docs/docs/index.html +99 -0
  193. package/docs/{crawl/docs/_misc → docs/misc}/api-configuration.html +18 -18
  194. package/docs/{src/docs/_misc → docs/misc}/api-configuration.md +10 -12
  195. package/docs/{crawl/docs/_misc → docs/misc}/dataProviderKey.html +12 -11
  196. package/{src/docs/_misc → docs/docs/misc}/dataProviderKey.md +4 -4
  197. package/docs/{crawl/docs/_misc → docs/misc}/docs-mock-api.html +25 -28
  198. package/docs/{src/docs/_misc → docs/misc}/docs-mock-api.md +12 -13
  199. package/docs/{crawl/docs/_misc → docs/misc}/dynamic-path.html +16 -15
  200. package/{src/docs/_misc → docs/docs/misc}/dynamic-path.md +8 -8
  201. package/docs/{crawl/docs/_misc → docs/misc}/endpoint.html +16 -15
  202. package/{src/docs/_misc → docs/docs/misc}/endpoint.md +8 -8
  203. package/docs/{crawl/docs/_misc → docs/misc}/html-integration.html +12 -15
  204. package/docs/{src/docs/_misc → docs/misc}/html-integration.md +4 -5
  205. package/docs/docs-mock-api-sw.js +60 -223
  206. package/docs/docs-mock-api-sw.js.map +4 -4
  207. package/docs/hubs/decorators.html +443 -0
  208. package/docs/hubs/form-components.html +404 -0
  209. package/docs/hubs/remote-data.html +371 -0
  210. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  211. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  212. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  213. package/docs/img/archive/credits.json +28 -0
  214. package/docs/img/concorde/plane_01.jpg +0 -0
  215. package/docs/img/concorde/plane_02.jpg +0 -0
  216. package/docs/img/concorde/plane_03.jpg +0 -0
  217. package/docs/img/concorde/plane_04.jpg +0 -0
  218. package/docs/img/concorde/plane_05.jpg +0 -0
  219. package/docs/img/concorde/plane_06.jpg +0 -0
  220. package/docs/img/concorde/plane_07.jpg +0 -0
  221. package/docs/img/concorde/plane_08.jpg +0 -0
  222. package/docs/img/concorde/plane_09.jpg +0 -0
  223. package/docs/img/concorde/plane_10.jpg +0 -0
  224. package/docs/img/concorde/plane_11.jpg +0 -0
  225. package/docs/img/concorde/plane_12.jpg +0 -0
  226. package/docs/img/concorde/plane_13.jpg +0 -0
  227. package/docs/index.html +96 -67
  228. package/docs/index.md +22 -0
  229. package/docs/llms-full.txt +3329 -3295
  230. package/docs/llms.txt +94 -92
  231. package/docs/robots.txt +11 -10
  232. package/docs/sitemap.xml +78 -78
  233. package/docs/src/core/components/functional/date/date.md +91 -231
  234. package/docs/src/core/components/functional/fetch/fetch.md +66 -83
  235. package/docs/src/core/components/functional/if/if.md +28 -3
  236. package/docs/src/core/components/functional/jsonata/jsonata.md +42 -37
  237. package/docs/src/core/components/functional/list/list.md +99 -43
  238. package/docs/src/core/components/functional/mix/mix.md +31 -26
  239. package/docs/src/core/components/functional/queue/queue.md +40 -61
  240. package/docs/src/core/components/functional/router/router.md +64 -65
  241. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  242. package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
  243. package/docs/src/core/components/functional/sdui/example.json +19 -86
  244. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  245. package/docs/src/core/components/functional/sdui/sdui.md +196 -245
  246. package/docs/src/core/components/functional/states/states.md +86 -61
  247. package/docs/src/core/components/functional/submit/submit.md +64 -72
  248. package/docs/src/core/components/functional/translation/translation.md +38 -0
  249. package/docs/src/core/components/functional/value/value.md +34 -22
  250. package/docs/src/core/components/ui/alert/alert.md +139 -74
  251. package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
  252. package/docs/src/core/components/ui/badge/badge.md +137 -83
  253. package/docs/src/core/components/ui/button/button.md +139 -105
  254. package/docs/src/core/components/ui/captcha/captcha.md +50 -6
  255. package/docs/src/core/components/ui/card/card.md +183 -65
  256. package/docs/src/core/components/ui/divider/divider.md +104 -13
  257. package/docs/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  258. package/docs/src/core/components/ui/form/fieldset/fieldset.md +135 -103
  259. package/docs/src/core/components/ui/form/form-actions/form-actions.md +71 -50
  260. package/docs/src/core/components/ui/form/form-layout/form-layout.md +99 -34
  261. package/docs/src/core/components/ui/form/input/input.md +95 -95
  262. package/docs/src/core/components/ui/form/radio/radio.md +55 -34
  263. package/docs/src/core/components/ui/form/select/select.md +60 -45
  264. package/docs/src/core/components/ui/form/switch/switch.md +57 -34
  265. package/docs/src/core/components/ui/form/textarea/textarea.md +55 -38
  266. package/docs/src/core/components/ui/group/group.md +49 -47
  267. package/docs/src/core/components/ui/icon/icon.md +132 -43
  268. package/docs/src/core/components/ui/image/image.md +132 -72
  269. package/docs/src/core/components/ui/link/link.md +46 -8
  270. package/docs/src/core/components/ui/loader/loader.md +55 -23
  271. package/docs/src/core/components/ui/menu/menu.md +155 -114
  272. package/docs/src/core/components/ui/modal/modal.md +154 -62
  273. package/docs/src/core/components/ui/pop/pop.md +185 -65
  274. package/docs/src/core/components/ui/progress/progress.md +76 -30
  275. package/docs/src/core/components/ui/table/table.md +146 -334
  276. package/docs/src/core/components/ui/theme/theme.md +97 -0
  277. package/docs/src/core/components/ui/toast/toast.md +80 -99
  278. package/docs/src/core/components/ui/tooltip/tooltip.md +52 -45
  279. package/docs/src/docs/decorators/ancestor-attribute.md +59 -0
  280. package/docs/src/docs/decorators/auto-subscribe.md +40 -0
  281. package/docs/src/docs/decorators/bind.md +77 -0
  282. package/docs/src/docs/decorators/get.md +160 -0
  283. package/docs/src/docs/decorators/handle.md +119 -0
  284. package/docs/src/docs/decorators/on-assign.md +63 -0
  285. package/docs/src/docs/decorators/patch.md +44 -0
  286. package/docs/src/docs/decorators/post.md +134 -0
  287. package/docs/src/docs/decorators/publish.md +56 -0
  288. package/docs/src/docs/decorators/put.md +51 -0
  289. package/docs/src/docs/decorators/subscribe.md +87 -0
  290. package/docs/src/docs/decorators/wait-for-ancestors.md +76 -0
  291. package/docs/src/docs/directives/sub.md +75 -0
  292. package/docs/src/docs/directives/t.md +73 -0
  293. package/docs/src/docs/{_getting-started → getting-started}/ai-agents.md +3 -3
  294. package/docs/src/docs/getting-started/components.md +5 -0
  295. package/{src/docs/_getting-started → docs/src/docs/getting-started}/create-a-component.md +3 -6
  296. package/{src/docs/_core-concept → docs/src/docs/getting-started}/dataFlow.md +17 -18
  297. package/docs/src/docs/getting-started/installation.md +36 -0
  298. package/{src/docs/_getting-started → docs/src/docs/getting-started}/my-first-component.md +5 -14
  299. package/docs/src/docs/getting-started/start.md +35 -0
  300. package/docs/src/docs/getting-started/theming.md +253 -0
  301. package/{src/docs/_misc → docs/src/docs/misc}/api-configuration.md +10 -12
  302. package/docs/src/docs/{_misc → misc}/dataProviderKey.md +4 -4
  303. package/{src/docs/_misc → docs/src/docs/misc}/docs-mock-api.md +12 -13
  304. package/docs/src/docs/{_misc → misc}/dynamic-path.md +8 -8
  305. package/docs/src/docs/{_misc → misc}/endpoint.md +8 -8
  306. package/{src/docs/_misc → docs/src/docs/misc}/html-integration.md +4 -5
  307. package/docs/src/docs/search/docs-search.json +3729 -2949
  308. package/docs/src/tsconfig.json +176 -5
  309. package/index.html +94 -67
  310. package/package.json +11 -4
  311. package/public/docs-mock-api-sw.js +58 -223
  312. package/public/docs-mock-api-sw.js.map +4 -4
  313. package/public/img/archive/concorde-001-2cv.webp +0 -0
  314. package/public/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  315. package/public/img/archive/concorde-red-arrows-2002.webm +0 -0
  316. package/public/img/archive/credits.json +28 -0
  317. package/public/img/concorde/plane_01.jpg +0 -0
  318. package/public/img/concorde/plane_02.jpg +0 -0
  319. package/public/img/concorde/plane_03.jpg +0 -0
  320. package/public/img/concorde/plane_04.jpg +0 -0
  321. package/public/img/concorde/plane_05.jpg +0 -0
  322. package/public/img/concorde/plane_06.jpg +0 -0
  323. package/public/img/concorde/plane_07.jpg +0 -0
  324. package/public/img/concorde/plane_08.jpg +0 -0
  325. package/public/img/concorde/plane_09.jpg +0 -0
  326. package/public/img/concorde/plane_10.jpg +0 -0
  327. package/public/img/concorde/plane_11.jpg +0 -0
  328. package/public/img/concorde/plane_12.jpg +0 -0
  329. package/public/img/concorde/plane_13.jpg +0 -0
  330. package/public/robots.txt +11 -10
  331. package/scripts/docs-markdown-vite-plugin.ts +37 -0
  332. package/scripts/docs-public-url.mjs +50 -0
  333. package/scripts/docs.htaccess +75 -0
  334. package/scripts/generate-crawl-docs.mjs +207 -116
  335. package/scripts/generate-crawl-docs.test.mjs +124 -0
  336. package/scripts/post-build-docs.js +34 -50
  337. package/scripts/post-build.mjs +0 -0
  338. package/src/core/components/functional/date/date.md +91 -231
  339. package/src/core/components/functional/fetch/fetch.md +66 -83
  340. package/src/core/components/functional/if/if.md +28 -3
  341. package/src/core/components/functional/if/if.ts +0 -0
  342. package/src/core/components/functional/jsonata/jsonata.md +42 -37
  343. package/src/core/components/functional/list/list.demo.ts +0 -0
  344. package/src/core/components/functional/list/list.md +99 -43
  345. package/src/core/components/functional/mix/mix.md +31 -26
  346. package/src/core/components/functional/queue/queue.demo.ts +10 -7
  347. package/src/core/components/functional/queue/queue.md +40 -61
  348. package/src/core/components/functional/router/router.demo.ts +16 -16
  349. package/src/core/components/functional/router/router.md +64 -65
  350. package/src/core/components/functional/router/router.ts +0 -0
  351. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  352. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  353. package/src/core/components/functional/sdui/component-catalog.json +1 -1
  354. package/src/core/components/functional/sdui/example.json +19 -86
  355. package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  356. package/src/core/components/functional/sdui/sdui.md +187 -358
  357. package/src/core/components/functional/sdui/types.ts +0 -0
  358. package/src/core/components/functional/states/states.demo.ts +21 -22
  359. package/src/core/components/functional/states/states.md +86 -61
  360. package/src/core/components/functional/states/states.ts +1 -1
  361. package/src/core/components/functional/submit/submit.md +64 -72
  362. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  363. package/src/core/components/functional/translation/translation.md +38 -0
  364. package/src/core/components/functional/value/value.md +34 -22
  365. package/src/core/components/functional/value/value.ts +0 -0
  366. package/src/core/components/ui/_css/size.ts +0 -0
  367. package/src/core/components/ui/alert/alert.md +48 -58
  368. package/src/core/components/ui/badge/badge.md +27 -34
  369. package/src/core/components/ui/button/button.md +139 -106
  370. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  371. package/src/core/components/ui/captcha/captcha.md +17 -32
  372. package/src/core/components/ui/card/card.md +6 -6
  373. package/src/core/components/ui/divider/divider.md +8 -11
  374. package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  375. package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
  376. package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
  377. package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
  378. package/src/core/components/ui/form/input/input.md +95 -95
  379. package/src/core/components/ui/form/radio/radio.md +55 -34
  380. package/src/core/components/ui/form/select/select.md +60 -45
  381. package/src/core/components/ui/form/switch/switch.md +57 -34
  382. package/src/core/components/ui/form/textarea/textarea.md +55 -38
  383. package/src/core/components/ui/group/group.md +35 -33
  384. package/src/core/components/ui/icon/icon.md +4 -4
  385. package/src/core/components/ui/image/image.md +41 -107
  386. package/src/core/components/ui/link/link.md +6 -6
  387. package/src/core/components/ui/loader/loader.md +30 -55
  388. package/src/core/components/ui/menu/menu.md +27 -27
  389. package/src/core/components/ui/modal/modal.md +72 -96
  390. package/src/core/components/ui/modal/modal.ts +14 -11
  391. package/src/core/components/ui/pop/pop.md +80 -158
  392. package/src/core/components/ui/progress/progress.md +2 -2
  393. package/src/core/components/ui/table/table.md +91 -255
  394. package/src/core/components/ui/theme/theme.md +11 -36
  395. package/src/core/components/ui/toast/toast.md +48 -117
  396. package/src/core/components/ui/tooltip/tooltip.md +27 -62
  397. package/src/core/mixins/Subscriber.ts +0 -0
  398. package/src/core/utils/DataBindObserver.ts +0 -0
  399. package/src/core/utils/LocationHandler.spec.ts +80 -0
  400. package/src/core/utils/LocationHandler.ts +5 -9
  401. package/src/core/utils/Objects.ts +0 -0
  402. package/src/core/utils/route.ts +0 -0
  403. package/src/docs/code.ts +88 -75
  404. package/src/docs/components/docs-demo-sources.ts +70 -147
  405. package/src/docs/components/docs-lit-demo.ts +20 -40
  406. package/src/docs/components/docs-source-link.ts +0 -82
  407. package/src/docs/decorators/ancestor-attribute.md +59 -0
  408. package/src/docs/decorators/auto-subscribe.md +40 -0
  409. package/src/docs/decorators/bind.md +77 -0
  410. package/src/docs/decorators/get.md +160 -0
  411. package/src/docs/decorators/handle.md +119 -0
  412. package/src/docs/decorators/on-assign.md +63 -0
  413. package/src/docs/decorators/patch.md +44 -0
  414. package/src/docs/decorators/post.md +134 -0
  415. package/src/docs/decorators/publish.md +56 -0
  416. package/src/docs/decorators/put.md +51 -0
  417. package/src/docs/decorators/subscribe.md +87 -0
  418. package/src/docs/decorators/wait-for-ancestors.md +76 -0
  419. package/src/docs/directives/sub.md +75 -0
  420. package/src/docs/directives/t.md +73 -0
  421. package/src/docs/docs-location.spec.ts +46 -0
  422. package/src/docs/docs-location.ts +123 -32
  423. package/src/docs/docs.ts +6 -2
  424. package/src/docs/example/decorators-demo-bind-demos.ts +81 -116
  425. package/src/docs/example/decorators-demo-geo.ts +30 -19
  426. package/src/docs/example/decorators-demo-post.ts +88 -186
  427. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
  428. package/src/docs/example/decorators-demo.ts +85 -98
  429. package/src/docs/example/docs-api-config-demos.ts +19 -20
  430. package/src/docs/example/docs-boarding-pass-demo.ts +134 -0
  431. package/src/docs/example/docs-flight-demos.ts +147 -0
  432. package/src/docs/example/docs-jsonata-demos.ts +52 -52
  433. package/src/docs/example/docs-list-demos.ts +43 -123
  434. package/src/docs/example/docs-provider-keys.ts +33 -28
  435. package/src/docs/example/docs-queue-demos.ts +37 -77
  436. package/src/docs/example/docs-router-demos.ts +20 -25
  437. package/src/docs/example/docs-submit-demos.ts +48 -48
  438. package/src/docs/example/docs-toggle-demos.ts +4 -3
  439. package/src/docs/example/users.ts +0 -0
  440. package/src/docs/getting-started/ai-agents.md +76 -0
  441. package/src/docs/getting-started/components.md +5 -0
  442. package/src/docs/getting-started/create-a-component.md +136 -0
  443. package/src/docs/getting-started/dataFlow.md +87 -0
  444. package/src/docs/getting-started/installation.md +36 -0
  445. package/src/docs/getting-started/my-first-component.md +227 -0
  446. package/src/docs/getting-started/start.md +35 -0
  447. package/src/docs/getting-started/theming.md +253 -0
  448. package/src/docs/header/header.ts +240 -71
  449. package/src/docs/home/catalog.ts +44 -0
  450. package/src/docs/home/home.ts +520 -0
  451. package/src/docs/home/mach-stage.ts +389 -0
  452. package/src/docs/layout.ts +12 -11
  453. package/src/docs/misc/api-configuration.md +79 -0
  454. package/src/docs/misc/dataProviderKey.md +168 -0
  455. package/src/docs/misc/docs-mock-api.md +62 -0
  456. package/src/docs/misc/dynamic-path.md +71 -0
  457. package/src/docs/misc/endpoint.md +45 -0
  458. package/src/docs/misc/html-integration.md +14 -0
  459. package/src/docs/mock-api/api-config-mock.ts +5 -0
  460. package/src/docs/mock-api/fixtures.ts +0 -278
  461. package/src/docs/mock-api/flights.ts +89 -0
  462. package/src/docs/mock-api/router.ts +3 -4
  463. package/src/docs/mock-api/urls.ts +1 -2
  464. package/src/docs/navigation/components-index.ts +56 -0
  465. package/src/docs/navigation/navigation.ts +219 -232
  466. package/src/docs/navigation/pager.ts +67 -0
  467. package/src/docs/navigation/toc.ts +101 -0
  468. package/src/docs/search/docs-search.json +2419 -4374
  469. package/src/docs/search/markdown-renderer.ts +33 -7
  470. package/src/docs/search/page.ts +9 -6
  471. package/src/docs/search/search.ts +154 -122
  472. package/src/docs/shiki/index.ts +109 -0
  473. package/src/docs/tailwind/css/base/scrollbar.css +22 -0
  474. package/src/docs/tailwind/css/base/theme.css +96 -0
  475. package/src/docs/tailwind/css/base/typography.css +4 -0
  476. package/src/docs/tailwind/css/docs/boarding-pass.css +65 -0
  477. package/src/docs/tailwind/css/docs/content.css +32 -0
  478. package/src/docs/tailwind/css/docs/page.css +10 -0
  479. package/src/docs/tailwind/css/docs.css +9 -0
  480. package/src/docs/tailwind/css/home/hero.css +210 -0
  481. package/src/docs/tailwind/css/home/motion.css +84 -0
  482. package/src/docs/tailwind/css/home/sections.css +416 -0
  483. package/src/docs/tailwind/css/tailwind.css +7 -185
  484. package/src/tsconfig.json +23 -2
  485. package/src/tsconfig.tsbuildinfo +1 -1
  486. package/tailwind.config.js +8 -4
  487. package/vite.config.mts +11 -2
  488. package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
  489. package/.github/workflows/ci.yml +0 -21
  490. package/.github-export-ignore +0 -30
  491. package/CONTRIBUTING.md +0 -59
  492. package/DEV.md +0 -54
  493. package/LICENSE +0 -21
  494. package/OPEN_SOURCE_CHECKPOINT.md +0 -133
  495. package/concorde-3d.bundle.js +0 -3960
  496. package/concorde-3d.es.js +0 -33433
  497. package/concorde-hugging-face-infer.bundle.js +0 -32
  498. package/concorde-hugging-face-infer.es.js +0 -2952
  499. package/concorde-interactive.bundle.js +0 -1157
  500. package/concorde-interactive.es.js +0 -10734
  501. package/concorde-shader.bundle.js +0 -116
  502. package/concorde-shader.es.js +0 -8353
  503. package/concorde-webgpu.bundle.js +0 -307
  504. package/concorde-webgpu.es.js +0 -8627
  505. package/docs/assets/index-D8MVWqY6.js +0 -12251
  506. package/docs/assets/index-DiD0qYvE.css +0 -1
  507. package/docs/crawl/core/components/functional/date/date.html +0 -190
  508. package/docs/crawl/core/components/functional/fetch/fetch.html +0 -109
  509. package/docs/crawl/core/components/functional/if/if.html +0 -27
  510. package/docs/crawl/core/components/functional/jsonata/jsonata.html +0 -79
  511. package/docs/crawl/core/components/functional/list/list.html +0 -70
  512. package/docs/crawl/core/components/functional/mix/mix.html +0 -45
  513. package/docs/crawl/core/components/functional/queue/queue.html +0 -96
  514. package/docs/crawl/core/components/functional/router/router.html +0 -106
  515. package/docs/crawl/core/components/functional/sdui/sdui.html +0 -269
  516. package/docs/crawl/core/components/functional/states/states.html +0 -66
  517. package/docs/crawl/core/components/functional/submit/submit.html +0 -160
  518. package/docs/crawl/core/components/functional/value/value.html +0 -51
  519. package/docs/crawl/core/components/ui/alert/alert.html +0 -110
  520. package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +0 -23
  521. package/docs/crawl/core/components/ui/badge/badge.html +0 -119
  522. package/docs/crawl/core/components/ui/button/button.html +0 -149
  523. package/docs/crawl/core/components/ui/captcha/captcha.html +0 -30
  524. package/docs/crawl/core/components/ui/card/card.html +0 -99
  525. package/docs/crawl/core/components/ui/divider/divider.html +0 -58
  526. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +0 -73
  527. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +0 -135
  528. package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +0 -79
  529. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +0 -62
  530. package/docs/crawl/core/components/ui/form/input/input.html +0 -109
  531. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +0 -38
  532. package/docs/crawl/core/components/ui/form/radio/radio.html +0 -56
  533. package/docs/crawl/core/components/ui/form/select/select.html +0 -73
  534. package/docs/crawl/core/components/ui/form/switch/switch.html +0 -56
  535. package/docs/crawl/core/components/ui/form/textarea/textarea.html +0 -59
  536. package/docs/crawl/core/components/ui/group/group.html +0 -82
  537. package/docs/crawl/core/components/ui/icon/icon.html +0 -133
  538. package/docs/crawl/core/components/ui/image/image.html +0 -110
  539. package/docs/crawl/core/components/ui/link/link.html +0 -42
  540. package/docs/crawl/core/components/ui/loader/loader.html +0 -50
  541. package/docs/crawl/core/components/ui/modal/modal.html +0 -117
  542. package/docs/crawl/core/components/ui/pop/pop.html +0 -102
  543. package/docs/crawl/core/components/ui/progress/progress.html +0 -58
  544. package/docs/crawl/core/components/ui/table/table.html +0 -413
  545. package/docs/crawl/core/components/ui/toast/toast.html +0 -122
  546. package/docs/crawl/core/components/ui/tooltip/tooltip.html +0 -79
  547. package/docs/crawl/docs/_core-concept/overview.html +0 -66
  548. package/docs/crawl/docs/_core-concept/subscriber.html +0 -75
  549. package/docs/crawl/docs/_decorators/ancestor-attribute.html +0 -116
  550. package/docs/crawl/docs/_decorators/auto-subscribe.html +0 -202
  551. package/docs/crawl/docs/_decorators/bind.html +0 -141
  552. package/docs/crawl/docs/_decorators/get.html +0 -149
  553. package/docs/crawl/docs/_decorators/handle.html +0 -165
  554. package/docs/crawl/docs/_decorators/on-assign.html +0 -355
  555. package/docs/crawl/docs/_decorators/patch.html +0 -78
  556. package/docs/crawl/docs/_decorators/post.html +0 -139
  557. package/docs/crawl/docs/_decorators/publish.html +0 -61
  558. package/docs/crawl/docs/_decorators/put.html +0 -78
  559. package/docs/crawl/docs/_decorators/subscribe.html +0 -109
  560. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +0 -137
  561. package/docs/crawl/docs/_directives/sub.html +0 -93
  562. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +0 -100
  563. package/docs/crawl/docs/_getting-started/concorde-outside.html +0 -58
  564. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +0 -110
  565. package/docs/crawl/docs/_getting-started/pubsub.html +0 -62
  566. package/docs/crawl/docs/_getting-started/start.html +0 -76
  567. package/docs/crawl/docs/_getting-started/theming.html +0 -85
  568. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +0 -138
  569. package/docs/crawl/hubs/decorators.html +0 -547
  570. package/docs/crawl/hubs/form-components.html +0 -359
  571. package/docs/crawl/hubs/remote-data.html +0 -452
  572. package/docs/crawl/index.html +0 -101
  573. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  574. package/docs/src/docs/_core-concept/overview.md +0 -57
  575. package/docs/src/docs/_core-concept/subscriber.md +0 -75
  576. package/docs/src/docs/_decorators/ancestor-attribute.md +0 -127
  577. package/docs/src/docs/_decorators/auto-subscribe.md +0 -202
  578. package/docs/src/docs/_decorators/bind.md +0 -167
  579. package/docs/src/docs/_decorators/get.md +0 -162
  580. package/docs/src/docs/_decorators/handle.md +0 -175
  581. package/docs/src/docs/_decorators/on-assign.md +0 -390
  582. package/docs/src/docs/_decorators/patch.md +0 -70
  583. package/docs/src/docs/_decorators/post.md +0 -146
  584. package/docs/src/docs/_decorators/publish.md +0 -55
  585. package/docs/src/docs/_decorators/put.md +0 -70
  586. package/docs/src/docs/_decorators/subscribe.md +0 -100
  587. package/docs/src/docs/_decorators/wait-for-ancestors.md +0 -163
  588. package/docs/src/docs/_directives/sub.md +0 -91
  589. package/docs/src/docs/_getting-started/concorde-manual-install.md +0 -133
  590. package/docs/src/docs/_getting-started/concorde-outside.md +0 -33
  591. package/docs/src/docs/_getting-started/my-first-subscriber.md +0 -120
  592. package/docs/src/docs/_getting-started/pubsub.md +0 -37
  593. package/docs/src/docs/_getting-started/start.md +0 -47
  594. package/docs/src/docs/_getting-started/theming.md +0 -91
  595. package/docs/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  596. package/docs/src/tsconfig.declarations.json +0 -22
  597. package/docs/src/tsconfig.emit.json +0 -23
  598. package/gitlab/job_github_mirror.sh +0 -39
  599. package/scripts/github-export.mjs +0 -150
  600. package/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  601. package/src/css.d.ts +0 -19
  602. package/src/docs/_core-concept/overview.md +0 -57
  603. package/src/docs/_core-concept/subscriber.md +0 -75
  604. package/src/docs/_decorators/ancestor-attribute.md +0 -128
  605. package/src/docs/_decorators/auto-subscribe.md +0 -202
  606. package/src/docs/_decorators/bind.md +0 -167
  607. package/src/docs/_decorators/get.md +0 -162
  608. package/src/docs/_decorators/handle.md +0 -175
  609. package/src/docs/_decorators/on-assign.md +0 -390
  610. package/src/docs/_decorators/patch.md +0 -70
  611. package/src/docs/_decorators/post.md +0 -146
  612. package/src/docs/_decorators/publish.md +0 -55
  613. package/src/docs/_decorators/put.md +0 -70
  614. package/src/docs/_decorators/subscribe.md +0 -100
  615. package/src/docs/_decorators/wait-for-ancestors.md +0 -163
  616. package/src/docs/_directives/sub.md +0 -91
  617. package/src/docs/_getting-started/concorde-manual-install.md +0 -133
  618. package/src/docs/_getting-started/concorde-outside.md +0 -33
  619. package/src/docs/_getting-started/my-first-subscriber.md +0 -120
  620. package/src/docs/_getting-started/pubsub.md +0 -37
  621. package/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  622. package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
  623. package/src/docs/example/docs-joke-demos.ts +0 -297
  624. package/src/docs/prism/index.ts +0 -6
  625. package/src/docs/prism/prism.css +0 -158
  626. package/src/docs/prism/prism.js +0 -1022
  627. package/src/tsconfig.declarations.json +0 -22
  628. package/src/tsconfig.emit.json +0 -23
package/docs/core/components/functional/fetch/fetch.html ADDED
@@ -0,0 +1,180 @@
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>
package/docs/core/components/functional/fetch/fetch.md ADDED
@@ -0,0 +1,108 @@
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 |
package/docs/core/components/functional/if/if.html ADDED
@@ -0,0 +1,65 @@
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>
package/docs/core/components/functional/if/if.md ADDED
@@ -0,0 +1,34 @@
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 |
package/docs/core/components/functional/jsonata/jsonata.html ADDED
@@ -0,0 +1,110 @@
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>
package/docs/core/components/functional/jsonata/jsonata.md ADDED
@@ -0,0 +1,61 @@
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.