@supersoniks/concorde 5.1.2 → 5.1.3-immutable.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (497) hide show
  1. package/.agents/skills/concorde-docs/SKILL.md +1 -1
  2. package/.claude/skills +1 -0
  3. package/.github/workflows/ci.yml +21 -0
  4. package/.github-export-ignore +30 -0
  5. package/CONTRIBUTING.md +59 -0
  6. package/DEV.md +54 -0
  7. package/LICENSE +21 -0
  8. package/OPEN_SOURCE_CHECKPOINT.md +133 -0
  9. package/README.md +1 -1
  10. package/ai/README.md +29 -41
  11. package/ai/skills/concorde/SKILL.md +54 -324
  12. package/ai/skills/concorde/rules/composition.md +32 -0
  13. package/ai/skills/concorde/rules/data.md +47 -0
  14. package/ai/skills/concorde/rules/http.md +25 -0
  15. package/ai/skills/concorde/rules/lists-forms.md +35 -0
  16. package/ai/skills/concorde/rules/styling.md +46 -0
  17. package/ai/skills/concorde/rules/troubleshooting.md +45 -0
  18. package/build-infos.json +1 -1
  19. package/concorde-core.bundle.js +177 -177
  20. package/concorde-core.es.js +4993 -4833
  21. package/custom-elements-manifest.public.config.mjs +8 -0
  22. package/{.tmp-cem/custom-elements.json → custom-elements.json} +11722 -8868
  23. package/dist/concorde-core.bundle.js +177 -177
  24. package/dist/concorde-core.es.js +4993 -4833
  25. package/dist/docs-mock-api-sw.js +58 -223
  26. package/dist/docs-mock-api-sw.js.map +4 -4
  27. package/dist/img/og-concorde.jpg +0 -0
  28. package/dist/robots.txt +11 -10
  29. package/docs/assets/index-CD4WyL6o.css +1 -0
  30. package/docs/assets/index-D_alEsng.js +12122 -0
  31. package/docs/crawl/core/components/functional/date/date.html +190 -0
  32. package/docs/crawl/core/components/functional/fetch/fetch.html +109 -0
  33. package/docs/crawl/core/components/functional/if/if.html +27 -0
  34. package/docs/crawl/core/components/functional/jsonata/jsonata.html +79 -0
  35. package/docs/crawl/core/components/functional/list/list.html +70 -0
  36. package/docs/crawl/core/components/functional/mix/mix.html +45 -0
  37. package/docs/crawl/core/components/functional/queue/queue.html +96 -0
  38. package/docs/crawl/core/components/functional/router/router.html +106 -0
  39. package/docs/{core → crawl/core}/components/functional/sdui/sdui-extension-points.html +8 -9
  40. package/docs/crawl/core/components/functional/sdui/sdui.html +368 -0
  41. package/docs/crawl/core/components/functional/states/states.html +66 -0
  42. package/docs/crawl/core/components/functional/submit/submit.html +160 -0
  43. package/docs/{core → crawl/core}/components/functional/subscriber/subscriber.html +5 -6
  44. package/docs/crawl/core/components/functional/value/value.html +51 -0
  45. package/docs/{core → crawl/core}/components/ui/alert/alert.html +63 -53
  46. package/docs/{core → crawl/core}/components/ui/alert-messages/alert-messages.html +5 -6
  47. package/docs/{core → crawl/core}/components/ui/badge/badge.html +33 -33
  48. package/docs/crawl/core/components/ui/button/button.html +150 -0
  49. package/docs/crawl/core/components/ui/captcha/captcha.html +112 -0
  50. package/docs/{core → crawl/core}/components/ui/card/card.html +11 -12
  51. package/docs/{core → crawl/core}/components/ui/divider/divider.html +14 -14
  52. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +73 -0
  53. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +266 -0
  54. package/docs/{core → crawl/core}/components/ui/form/form-actions/form-actions.html +23 -23
  55. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +121 -0
  56. package/docs/crawl/core/components/ui/form/input/input.html +109 -0
  57. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +38 -0
  58. package/docs/crawl/core/components/ui/form/radio/radio.html +56 -0
  59. package/docs/crawl/core/components/ui/form/select/select.html +73 -0
  60. package/docs/crawl/core/components/ui/form/switch/switch.html +56 -0
  61. package/docs/crawl/core/components/ui/form/textarea/textarea.html +59 -0
  62. package/docs/crawl/core/components/ui/group/group.html +104 -0
  63. package/docs/{core → crawl/core}/components/ui/icon/icon.html +9 -10
  64. package/docs/crawl/core/components/ui/image/image.html +298 -0
  65. package/docs/{core → crawl/core}/components/ui/link/link.html +11 -12
  66. package/docs/crawl/core/components/ui/loader/loader.html +124 -0
  67. package/docs/{core → crawl/core}/components/ui/menu/menu.html +33 -34
  68. package/docs/crawl/core/components/ui/modal/modal.html +342 -0
  69. package/docs/crawl/core/components/ui/pop/pop.html +296 -0
  70. package/docs/{core → crawl/core}/components/ui/progress/progress.html +7 -8
  71. package/docs/crawl/core/components/ui/table/table.html +545 -0
  72. package/docs/crawl/core/components/ui/theme/theme.html +131 -0
  73. package/docs/crawl/core/components/ui/toast/toast.html +233 -0
  74. package/docs/crawl/core/components/ui/tooltip/tooltip.html +140 -0
  75. package/docs/{docs/getting-started → crawl/docs/_core-concept}/dataFlow.html +29 -26
  76. package/docs/crawl/docs/_core-concept/overview.html +66 -0
  77. package/docs/crawl/docs/_core-concept/subscriber.html +75 -0
  78. package/docs/crawl/docs/_decorators/ancestor-attribute.html +117 -0
  79. package/docs/crawl/docs/_decorators/auto-subscribe.html +202 -0
  80. package/docs/crawl/docs/_decorators/bind.html +141 -0
  81. package/docs/crawl/docs/_decorators/get.html +149 -0
  82. package/docs/crawl/docs/_decorators/handle.html +165 -0
  83. package/docs/crawl/docs/_decorators/on-assign.html +355 -0
  84. package/docs/crawl/docs/_decorators/patch.html +78 -0
  85. package/docs/crawl/docs/_decorators/post.html +139 -0
  86. package/docs/crawl/docs/_decorators/publish.html +61 -0
  87. package/docs/crawl/docs/_decorators/put.html +78 -0
  88. package/docs/crawl/docs/_decorators/subscribe.html +109 -0
  89. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +137 -0
  90. package/docs/crawl/docs/_directives/sub.html +93 -0
  91. package/docs/{docs/getting-started → crawl/docs/_getting-started}/ai-agents.html +11 -12
  92. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +100 -0
  93. package/docs/crawl/docs/_getting-started/concorde-outside.html +58 -0
  94. package/docs/{docs/getting-started → crawl/docs/_getting-started}/create-a-component.html +14 -11
  95. package/docs/{docs/getting-started → crawl/docs/_getting-started}/my-first-component.html +22 -13
  96. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +110 -0
  97. package/docs/crawl/docs/_getting-started/pubsub.html +62 -0
  98. package/docs/crawl/docs/_getting-started/start.html +76 -0
  99. package/docs/{docs/getting-started → crawl/docs/_getting-started}/theming.html +9 -10
  100. package/docs/{docs/misc → crawl/docs/_misc}/api-configuration.html +18 -18
  101. package/docs/{docs/misc → crawl/docs/_misc}/dataProviderKey.html +11 -12
  102. package/docs/{docs/misc → crawl/docs/_misc}/docs-mock-api.html +28 -25
  103. package/docs/{docs/misc → crawl/docs/_misc}/dynamic-path.html +15 -16
  104. package/docs/{docs/misc → crawl/docs/_misc}/endpoint.html +15 -16
  105. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +138 -0
  106. package/docs/{docs/misc → crawl/docs/_misc}/html-integration.html +15 -12
  107. package/docs/crawl/hubs/decorators.html +547 -0
  108. package/docs/crawl/hubs/form-components.html +381 -0
  109. package/docs/crawl/hubs/remote-data.html +452 -0
  110. package/docs/crawl/index.html +103 -0
  111. package/docs/docs-mock-api-sw.js +223 -58
  112. package/docs/docs-mock-api-sw.js.map +4 -4
  113. package/docs/index.html +68 -95
  114. package/docs/llms-full.txt +3610 -2231
  115. package/docs/llms.txt +86 -94
  116. package/docs/robots.txt +10 -11
  117. package/docs/sitemap.xml +84 -78
  118. package/docs/src/core/components/functional/date/date.md +231 -91
  119. package/docs/src/core/components/functional/fetch/fetch.md +83 -66
  120. package/docs/src/core/components/functional/if/if.md +3 -28
  121. package/docs/src/core/components/functional/jsonata/jsonata.md +37 -42
  122. package/docs/src/core/components/functional/list/list.md +43 -99
  123. package/docs/src/core/components/functional/mix/mix.md +26 -31
  124. package/docs/src/core/components/functional/queue/queue.md +61 -40
  125. package/docs/src/core/components/functional/router/router.md +65 -64
  126. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  127. package/docs/src/core/components/functional/sdui/component-catalog.json +1 -1
  128. package/docs/src/core/components/functional/sdui/example.json +86 -19
  129. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  130. package/docs/src/core/components/functional/sdui/sdui.md +358 -187
  131. package/docs/src/core/components/functional/states/states.md +61 -86
  132. package/docs/src/core/components/functional/submit/submit.md +72 -64
  133. package/docs/src/core/components/functional/value/value.md +22 -34
  134. package/docs/src/core/components/ui/alert/alert.md +58 -48
  135. package/docs/src/core/components/ui/badge/badge.md +34 -27
  136. package/docs/src/core/components/ui/button/button.md +106 -139
  137. package/docs/src/core/components/ui/captcha/captcha.md +32 -17
  138. package/docs/src/core/components/ui/card/card.md +6 -6
  139. package/docs/src/core/components/ui/divider/divider.md +11 -8
  140. package/docs/src/core/components/ui/form/checkbox/checkbox.md +42 -90
  141. package/docs/src/core/components/ui/form/fieldset/fieldset.md +75 -31
  142. package/docs/src/core/components/ui/form/form-actions/form-actions.md +16 -14
  143. package/docs/src/core/components/ui/form/form-layout/form-layout.md +29 -19
  144. package/docs/src/core/components/ui/form/input/input.md +95 -95
  145. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +29 -0
  146. package/docs/src/core/components/ui/form/radio/radio.md +34 -55
  147. package/docs/src/core/components/ui/form/select/select.md +45 -60
  148. package/docs/src/core/components/ui/form/switch/switch.md +34 -57
  149. package/docs/src/core/components/ui/form/textarea/textarea.md +38 -55
  150. package/docs/src/core/components/ui/group/group.md +33 -35
  151. package/docs/src/core/components/ui/icon/icon.md +4 -4
  152. package/docs/src/core/components/ui/image/image.md +107 -41
  153. package/docs/src/core/components/ui/link/link.md +6 -6
  154. package/docs/src/core/components/ui/loader/loader.md +55 -30
  155. package/docs/src/core/components/ui/menu/menu.md +27 -27
  156. package/docs/src/core/components/ui/modal/modal.md +96 -72
  157. package/docs/src/core/components/ui/pop/pop.md +158 -80
  158. package/docs/src/core/components/ui/progress/progress.md +2 -2
  159. package/docs/src/core/components/ui/table/table.md +255 -91
  160. package/docs/src/core/components/ui/theme/theme.md +36 -11
  161. package/docs/src/core/components/ui/toast/toast.md +117 -48
  162. package/docs/src/core/components/ui/tooltip/tooltip.md +62 -27
  163. package/docs/{docs/getting-started → src/docs/_core-concept}/dataFlow.md +18 -17
  164. package/docs/src/docs/_core-concept/overview.md +57 -0
  165. package/docs/src/docs/_core-concept/subscriber.md +75 -0
  166. package/docs/src/docs/_decorators/ancestor-attribute.md +128 -0
  167. package/docs/src/docs/_decorators/auto-subscribe.md +202 -0
  168. package/docs/src/docs/_decorators/bind.md +167 -0
  169. package/docs/src/docs/_decorators/get.md +162 -0
  170. package/docs/src/docs/_decorators/handle.md +175 -0
  171. package/docs/src/docs/_decorators/on-assign.md +390 -0
  172. package/docs/src/docs/_decorators/patch.md +70 -0
  173. package/docs/src/docs/_decorators/post.md +146 -0
  174. package/docs/src/docs/_decorators/publish.md +55 -0
  175. package/docs/src/docs/_decorators/put.md +70 -0
  176. package/docs/src/docs/_decorators/subscribe.md +100 -0
  177. package/docs/src/docs/_decorators/wait-for-ancestors.md +163 -0
  178. package/docs/src/docs/_directives/sub.md +91 -0
  179. package/docs/src/docs/{getting-started → _getting-started}/ai-agents.md +3 -3
  180. package/docs/src/docs/_getting-started/concorde-manual-install.md +133 -0
  181. package/docs/src/docs/_getting-started/concorde-outside.md +33 -0
  182. package/docs/{docs/getting-started → src/docs/_getting-started}/create-a-component.md +6 -3
  183. package/docs/src/docs/{getting-started → _getting-started}/my-first-component.md +14 -5
  184. package/docs/src/docs/_getting-started/my-first-subscriber.md +120 -0
  185. package/docs/src/docs/_getting-started/pubsub.md +37 -0
  186. package/docs/src/docs/{getting-started → _getting-started}/start.md +13 -1
  187. package/docs/src/docs/{getting-started → _getting-started}/theming.md +2 -2
  188. package/docs/src/docs/{misc → _misc}/api-configuration.md +12 -10
  189. package/docs/src/docs/{misc → _misc}/dataProviderKey.md +4 -4
  190. package/docs/{docs/misc → src/docs/_misc}/docs-mock-api.md +13 -12
  191. package/docs/{docs/misc → src/docs/_misc}/dynamic-path.md +8 -8
  192. package/docs/{docs/misc → src/docs/_misc}/endpoint.md +8 -8
  193. package/docs/src/docs/_misc/formelement-subscriber-removal.md +115 -0
  194. package/docs/{docs/misc → src/docs/_misc}/html-integration.md +5 -4
  195. package/docs/src/docs/search/docs-search.json +4375 -2420
  196. package/docs/src/tsconfig.declarations.json +22 -0
  197. package/docs/src/tsconfig.emit.json +23 -0
  198. package/docs/src/tsconfig.json +2 -23
  199. package/gitlab/job_github_mirror.sh +39 -0
  200. package/index.html +89 -0
  201. package/package.json +22 -4
  202. package/public/img/og-concorde.jpg +0 -0
  203. package/scripts/ai-init.mjs +104 -379
  204. package/scripts/ai-init.test.mjs +81 -239
  205. package/scripts/docs-markdown-vite-plugin.ts +11 -5
  206. package/scripts/docs-public-url.mjs +6 -0
  207. package/scripts/docs.htaccess +7 -0
  208. package/scripts/generate-cem.mjs +244 -0
  209. package/scripts/generate-cem.test.mjs +122 -0
  210. package/scripts/generate-crawl-docs.mjs +29 -5
  211. package/scripts/generate-sdui-catalog.mjs +11 -10
  212. package/scripts/github-export.mjs +150 -0
  213. package/scripts/post-build-docs.js +3 -0
  214. package/scripts/post-build.mjs +0 -0
  215. package/scripts/pre-publish.mjs +2 -1
  216. package/scripts/site-pages.mjs +212 -0
  217. package/scripts/site-pages.test.mjs +116 -0
  218. package/site-pages/about.md +22 -0
  219. package/site-pages/privacy.md +32 -0
  220. package/src/core/components/functional/date/date.md +1 -1
  221. package/src/core/components/functional/example/example.ts +3 -1
  222. package/src/core/components/functional/if/if.ts +0 -0
  223. package/src/core/components/functional/list/list.demo.ts +0 -0
  224. package/src/core/components/functional/list/list.md +6 -2
  225. package/src/core/components/functional/list/list.ts +17 -4
  226. package/src/core/components/functional/mix/mix.md +0 -0
  227. package/src/core/components/functional/router/router.demo.ts +0 -0
  228. package/src/core/components/functional/router/router.ts +0 -0
  229. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  230. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  231. package/src/core/components/functional/sdui/component-catalog.json +2 -2
  232. package/src/core/components/functional/sdui/example.json +0 -0
  233. package/src/core/components/functional/sdui/sdui-immutable.spec.ts +74 -0
  234. package/src/core/components/functional/sdui/sdui.ts +33 -8
  235. package/src/core/components/functional/sdui/types.ts +0 -0
  236. package/src/core/components/functional/states/states.ts +0 -0
  237. package/src/core/components/functional/submit/submit.spec.ts +60 -0
  238. package/src/core/components/functional/submit/submit.ts +6 -3
  239. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  240. package/src/core/components/functional/value/value.md +0 -0
  241. package/src/core/components/functional/value/value.ts +0 -0
  242. package/src/core/components/ui/_css/size.ts +0 -0
  243. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  244. package/src/core/components/ui/card/card.md +1 -1
  245. package/src/core/components/ui/form/input/input.md +19 -1
  246. package/src/core/components/ui/form/input/input.ts +8 -2
  247. package/src/core/components/ui/form/radio/radio.md +14 -0
  248. package/src/core/components/ui/image/image.md +17 -17
  249. package/src/core/components/ui/modal/modal.md +2 -2
  250. package/src/core/decorators/subscriber/bind.ts +9 -14
  251. package/src/core/decorators/subscriber/subscribe.ts +15 -9
  252. package/src/core/decorators/subscriber/subscribe.type-test.ts +14 -5
  253. package/src/core/mixins/Subscriber.ts +0 -0
  254. package/src/core/utils/DataBindObserver.ts +0 -0
  255. package/src/core/utils/Objects.ts +0 -0
  256. package/src/core/utils/PublisherProxy.ts +166 -125
  257. package/src/core/utils/deepReadonly.spec.ts +66 -0
  258. package/src/core/utils/deepReadonly.ts +71 -0
  259. package/src/core/utils/immutableValue.spec.ts +54 -0
  260. package/src/core/utils/immutableValue.ts +102 -0
  261. package/src/core/utils/nestedDotForm.spec.ts +88 -0
  262. package/src/core/utils/publisherImmutable.spec.ts +76 -0
  263. package/src/core/utils/route.ts +0 -0
  264. package/src/core/utils/strictGet.spec.ts +61 -0
  265. package/src/core/utils/strictGet.ts +102 -0
  266. package/src/css.d.ts +19 -0
  267. package/src/docs/components/docs-demo-sources.ts +3 -3
  268. package/src/docs/decorators/bind.md +23 -24
  269. package/src/docs/docs-location.spec.ts +10 -0
  270. package/src/docs/docs-location.ts +10 -0
  271. package/src/docs/example/decorators-demo-bind-demos.ts +11 -28
  272. package/src/docs/example/docs-toggle-demos.ts +1 -1
  273. package/src/docs/example/users.ts +0 -0
  274. package/src/docs/getting-started/ai-agents.md +29 -55
  275. package/src/docs/getting-started/dataFlow.md +2 -2
  276. package/src/docs/home/home.ts +3 -1
  277. package/src/docs/misc/publisher-get-immutability-docs-crawl.json +902 -0
  278. package/src/docs/misc/publisher-get-immutability-docs-recheck.json +13 -0
  279. package/src/docs/misc/publisher-get-immutability-study.md +229 -0
  280. package/src/docs/navigation/navigation.ts +5 -1
  281. package/src/docs/search/docs-search.json +358 -58
  282. package/src/docs/search/markdown-renderer.ts +6 -1
  283. package/src/docs/tailwind/css/docs/content.css +4 -5
  284. package/src/tsconfig.declarations.json +22 -0
  285. package/src/tsconfig.emit.json +23 -0
  286. package/src/tsconfig.json +53 -5
  287. package/src/tsconfig.tsbuildinfo +1 -1
  288. package/.taste-skill/after/desktop-fold.jpg +0 -0
  289. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  290. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  291. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  292. package/.taste-skill/after/mobile-fold.jpg +0 -0
  293. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  294. package/.taste-skill/after/report.json +0 -4103
  295. package/.taste-skill/after/tablet-fold.jpg +0 -0
  296. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  297. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  298. package/.taste-skill/before/desktop-fold.jpg +0 -0
  299. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  300. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  301. package/.taste-skill/before/mobile-fold.jpg +0 -0
  302. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  303. package/.taste-skill/before/report.json +0 -2556
  304. package/.taste-skill/before/tablet-fold.jpg +0 -0
  305. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  306. package/.taste-skill/direction.json +0 -510
  307. package/.taste-skill/notes.md +0 -84
  308. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  309. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  310. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  311. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  312. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  313. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  314. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  315. package/.taste-skill/prod/report.json +0 -1973
  316. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  317. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  318. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  319. package/AUDIT.md +0 -228
  320. package/PLAN-AMELIORATION.md +0 -220
  321. package/PLAN-DOCS-AGENTS.md +0 -80
  322. package/ai/AGENTS.md +0 -56
  323. package/ai/cursor/rules/concorde-menu.mdc +0 -15
  324. package/ai/cursor/rules/concorde-scope.mdc +0 -14
  325. package/ai/cursor/rules/concorde-theme.mdc +0 -13
  326. package/ai/cursor/rules/concorde.mdc +0 -66
  327. package/ai/jetbrains/rules/concorde.md +0 -53
  328. package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
  329. package/ai/skills/concorde-imports/SKILL.md +0 -78
  330. package/ai/skills/concorde-menu/SKILL.md +0 -74
  331. package/ai/skills/concorde-scope/SKILL.md +0 -70
  332. package/ai/skills/concorde-theme/SKILL.md +0 -57
  333. package/docs/.htaccess +0 -75
  334. package/docs/404.html +0 -15
  335. package/docs/404.md +0 -5
  336. package/docs/assets/index-BgG6FFPt.js +0 -11765
  337. package/docs/assets/index-x89XINSG.css +0 -1
  338. package/docs/core/components/functional/date/date.html +0 -211
  339. package/docs/core/components/functional/date/date.md +0 -150
  340. package/docs/core/components/functional/fetch/fetch.html +0 -180
  341. package/docs/core/components/functional/fetch/fetch.md +0 -108
  342. package/docs/core/components/functional/if/if.html +0 -65
  343. package/docs/core/components/functional/if/if.md +0 -34
  344. package/docs/core/components/functional/jsonata/jsonata.html +0 -110
  345. package/docs/core/components/functional/jsonata/jsonata.md +0 -61
  346. package/docs/core/components/functional/list/list.html +0 -198
  347. package/docs/core/components/functional/list/list.md +0 -121
  348. package/docs/core/components/functional/mix/mix.html +0 -78
  349. package/docs/core/components/functional/mix/mix.md +0 -46
  350. package/docs/core/components/functional/queue/queue.html +0 -155
  351. package/docs/core/components/functional/queue/queue.md +0 -51
  352. package/docs/core/components/functional/router/router.html +0 -154
  353. package/docs/core/components/functional/router/router.md +0 -93
  354. package/docs/core/components/functional/sdui/sdui-extension-points.md +0 -94
  355. package/docs/core/components/functional/sdui/sdui.html +0 -397
  356. package/docs/core/components/functional/sdui/sdui.md +0 -307
  357. package/docs/core/components/functional/states/states.html +0 -141
  358. package/docs/core/components/functional/states/states.md +0 -112
  359. package/docs/core/components/functional/submit/submit.html +0 -178
  360. package/docs/core/components/functional/submit/submit.md +0 -106
  361. package/docs/core/components/functional/subscriber/subscriber.md +0 -91
  362. package/docs/core/components/functional/translation/translation.html +0 -60
  363. package/docs/core/components/functional/translation/translation.md +0 -38
  364. package/docs/core/components/functional/value/value.html +0 -81
  365. package/docs/core/components/functional/value/value.md +0 -47
  366. package/docs/core/components/ui/alert/alert.md +0 -186
  367. package/docs/core/components/ui/alert-messages/alert-messages.md +0 -85
  368. package/docs/core/components/ui/badge/badge.md +0 -181
  369. package/docs/core/components/ui/button/button.html +0 -309
  370. package/docs/core/components/ui/button/button.md +0 -216
  371. package/docs/core/components/ui/captcha/captcha.html +0 -80
  372. package/docs/core/components/ui/captcha/captcha.md +0 -56
  373. package/docs/core/components/ui/card/card.md +0 -215
  374. package/docs/core/components/ui/divider/divider.md +0 -126
  375. package/docs/core/components/ui/form/checkbox/checkbox.html +0 -200
  376. package/docs/core/components/ui/form/checkbox/checkbox.md +0 -125
  377. package/docs/core/components/ui/form/fieldset/fieldset.html +0 -238
  378. package/docs/core/components/ui/form/fieldset/fieldset.md +0 -161
  379. package/docs/core/components/ui/form/form-actions/form-actions.md +0 -98
  380. package/docs/core/components/ui/form/form-layout/form-layout.html +0 -115
  381. package/docs/core/components/ui/form/form-layout/form-layout.md +0 -109
  382. package/docs/core/components/ui/form/input/input.html +0 -235
  383. package/docs/core/components/ui/form/input/input.md +0 -142
  384. package/docs/core/components/ui/form/radio/radio.html +0 -144
  385. package/docs/core/components/ui/form/radio/radio.md +0 -78
  386. package/docs/core/components/ui/form/select/select.html +0 -178
  387. package/docs/core/components/ui/form/select/select.md +0 -86
  388. package/docs/core/components/ui/form/switch/switch.html +0 -146
  389. package/docs/core/components/ui/form/switch/switch.md +0 -80
  390. package/docs/core/components/ui/form/textarea/textarea.html +0 -162
  391. package/docs/core/components/ui/form/textarea/textarea.md +0 -82
  392. package/docs/core/components/ui/group/group.html +0 -113
  393. package/docs/core/components/ui/group/group.md +0 -77
  394. package/docs/core/components/ui/icon/icon.md +0 -214
  395. package/docs/core/components/ui/image/image.html +0 -194
  396. package/docs/core/components/ui/image/image.md +0 -167
  397. package/docs/core/components/ui/link/link.md +0 -81
  398. package/docs/core/components/ui/loader/loader.html +0 -114
  399. package/docs/core/components/ui/loader/loader.md +0 -87
  400. package/docs/core/components/ui/menu/menu.md +0 -370
  401. package/docs/core/components/ui/modal/modal.html +0 -324
  402. package/docs/core/components/ui/modal/modal.md +0 -211
  403. package/docs/core/components/ui/pop/pop.html +0 -250
  404. package/docs/core/components/ui/pop/pop.md +0 -216
  405. package/docs/core/components/ui/progress/progress.md +0 -109
  406. package/docs/core/components/ui/table/table.html +0 -333
  407. package/docs/core/components/ui/table/table.md +0 -267
  408. package/docs/core/components/ui/theme/theme.html +0 -116
  409. package/docs/core/components/ui/theme/theme.md +0 -97
  410. package/docs/core/components/ui/toast/toast.html +0 -185
  411. package/docs/core/components/ui/toast/toast.md +0 -147
  412. package/docs/core/components/ui/tooltip/tooltip.html +0 -112
  413. package/docs/core/components/ui/tooltip/tooltip.md +0 -89
  414. package/docs/docs/decorators/ancestor-attribute.html +0 -71
  415. package/docs/docs/decorators/ancestor-attribute.md +0 -59
  416. package/docs/docs/decorators/auto-subscribe.html +0 -61
  417. package/docs/docs/decorators/auto-subscribe.md +0 -40
  418. package/docs/docs/decorators/bind.html +0 -86
  419. package/docs/docs/decorators/bind.md +0 -77
  420. package/docs/docs/decorators/get.html +0 -166
  421. package/docs/docs/decorators/get.md +0 -160
  422. package/docs/docs/decorators/handle.html +0 -139
  423. package/docs/docs/decorators/handle.md +0 -119
  424. package/docs/docs/decorators/on-assign.html +0 -72
  425. package/docs/docs/decorators/on-assign.md +0 -63
  426. package/docs/docs/decorators/patch.html +0 -76
  427. package/docs/docs/decorators/patch.md +0 -44
  428. package/docs/docs/decorators/post.html +0 -150
  429. package/docs/docs/decorators/post.md +0 -134
  430. package/docs/docs/decorators/publish.html +0 -74
  431. package/docs/docs/decorators/publish.md +0 -56
  432. package/docs/docs/decorators/put.html +0 -83
  433. package/docs/docs/decorators/put.md +0 -51
  434. package/docs/docs/decorators/subscribe.html +0 -91
  435. package/docs/docs/decorators/subscribe.md +0 -87
  436. package/docs/docs/decorators/wait-for-ancestors.html +0 -82
  437. package/docs/docs/decorators/wait-for-ancestors.md +0 -76
  438. package/docs/docs/directives/sub.html +0 -79
  439. package/docs/docs/directives/sub.md +0 -75
  440. package/docs/docs/directives/t.html +0 -91
  441. package/docs/docs/directives/t.md +0 -73
  442. package/docs/docs/getting-started/ai-agents.md +0 -76
  443. package/docs/docs/getting-started/components.html +0 -27
  444. package/docs/docs/getting-started/components.md +0 -5
  445. package/docs/docs/getting-started/installation.html +0 -69
  446. package/docs/docs/getting-started/installation.md +0 -36
  447. package/docs/docs/getting-started/my-first-component.md +0 -227
  448. package/docs/docs/getting-started/start.html +0 -47
  449. package/docs/docs/getting-started/start.md +0 -35
  450. package/docs/docs/getting-started/theming.md +0 -253
  451. package/docs/docs/index.html +0 -99
  452. package/docs/docs/misc/api-configuration.md +0 -79
  453. package/docs/docs/misc/dataProviderKey.md +0 -168
  454. package/docs/hubs/decorators.html +0 -443
  455. package/docs/hubs/form-components.html +0 -404
  456. package/docs/hubs/remote-data.html +0 -371
  457. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  458. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  459. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  460. package/docs/img/archive/credits.json +0 -28
  461. package/docs/index.md +0 -22
  462. package/docs/src/core/components/functional/translation/translation.md +0 -38
  463. package/docs/src/docs/decorators/ancestor-attribute.md +0 -59
  464. package/docs/src/docs/decorators/auto-subscribe.md +0 -40
  465. package/docs/src/docs/decorators/bind.md +0 -77
  466. package/docs/src/docs/decorators/get.md +0 -160
  467. package/docs/src/docs/decorators/handle.md +0 -119
  468. package/docs/src/docs/decorators/on-assign.md +0 -63
  469. package/docs/src/docs/decorators/patch.md +0 -44
  470. package/docs/src/docs/decorators/post.md +0 -134
  471. package/docs/src/docs/decorators/publish.md +0 -56
  472. package/docs/src/docs/decorators/put.md +0 -51
  473. package/docs/src/docs/decorators/subscribe.md +0 -87
  474. package/docs/src/docs/decorators/wait-for-ancestors.md +0 -76
  475. package/docs/src/docs/directives/sub.md +0 -75
  476. package/docs/src/docs/directives/t.md +0 -73
  477. package/docs/src/docs/getting-started/components.md +0 -5
  478. package/docs/src/docs/getting-started/create-a-component.md +0 -136
  479. package/docs/src/docs/getting-started/dataFlow.md +0 -87
  480. package/docs/src/docs/getting-started/installation.md +0 -36
  481. package/docs/src/docs/misc/docs-mock-api.md +0 -62
  482. package/docs/src/docs/misc/dynamic-path.md +0 -71
  483. package/docs/src/docs/misc/endpoint.md +0 -45
  484. package/docs/src/docs/misc/html-integration.md +0 -14
  485. /package/{docs → dist}/img/concorde/plane_01.jpg +0 -0
  486. /package/{docs → dist}/img/concorde/plane_02.jpg +0 -0
  487. /package/{docs → dist}/img/concorde/plane_03.jpg +0 -0
  488. /package/{docs → dist}/img/concorde/plane_04.jpg +0 -0
  489. /package/{docs → dist}/img/concorde/plane_05.jpg +0 -0
  490. /package/{docs → dist}/img/concorde/plane_06.jpg +0 -0
  491. /package/{docs → dist}/img/concorde/plane_07.jpg +0 -0
  492. /package/{docs → dist}/img/concorde/plane_08.jpg +0 -0
  493. /package/{docs → dist}/img/concorde/plane_09.jpg +0 -0
  494. /package/{docs → dist}/img/concorde/plane_10.jpg +0 -0
  495. /package/{docs → dist}/img/concorde/plane_11.jpg +0 -0
  496. /package/{docs → dist}/img/concorde/plane_12.jpg +0 -0
  497. /package/{docs → dist}/img/concorde/plane_13.jpg +0 -0
package/docs/crawl/hubs/remote-data.html ADDED
@@ -0,0 +1,452 @@
1
+ <!DOCTYPE html>
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/hubs/remote-data.html" data-doc-id="hubs/remote-data">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Fetching remote data in Concorde — Concorde</title>
7
+ <meta name="description" content="Hub for loading online data: @get decorator, Endpoint, API configuration, dynamic paths, sonic-list fetch, sonic-queue, legacy sonic-fetch.">
8
+ <meta name="keywords" content="@get, fetch, remote data, API, Endpoint, ApiResult, serviceURL, sonic-list, sonic-queue, HTTP GET">
9
+ <meta name="concorde-doc-id" content="hubs/remote-data">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/hubs/remote-data.html">
11
+ </head>
12
+ <body>
13
+ <header>
14
+ <p><a href="../index.html">Concorde documentation (crawl)</a></p>
15
+ </header>
16
+ <main>
17
+ <article>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde documentation — Fetching remote data in Concorde</strong>. Hub for loading online data: @get decorator, Endpoint, API configuration, dynamic paths, sonic-list fetch, sonic-queue, legacy sonic-fetch. <span>Doc ID: <code>hubs/remote-data</code>. Keywords: @get, fetch, remote data, API, Endpoint, ApiResult, serviceURL, sonic-list, sonic-queue, HTTP GET. URL: <a href="https://concorde.supersoniks.org/crawl/hubs/remote-data.html">https://concorde.supersoniks.org/crawl/hubs/remote-data.html</a>.</span></p>
19
+ <section id="core-components-functional-fetch-fetch" data-doc-id="core/components/functional/fetch/fetch">
20
+ <h2><a href="../core/components/functional/fetch/fetch.html">Fetch</a></h2>
21
+ <p><strong>Doc ID:</strong> <code>core/components/functional/fetch/fetch</code> · <a href="../core/components/functional/fetch/fetch.html">full page</a></p>
22
+ <p>&gt; New apps: prefer @get for a typed GET on a component, or List / Queue with fetch for collections. Use Local API demos (serviceURL=&quot;/docs-mock-api&quot;) to try examples offline.</p>
23
+ <pre class="doc-excerpt">Fetch
24
+
25
+ &gt; New apps: prefer @get for a typed GET on a component, or List / Queue with fetch for collections. Use Local API demos (serviceURL=&quot;/docs-mock-api&quot;) to try examples offline.
26
+
27
+ The sonic-fetch component requests and stores API data. It extends the Fetcher and Subscriber mixins.
28
+
29
+ Basic usage
30
+ In order to work properly the sonic-fetch component needs at least the following attributes.
31
+ - serviceURL : A base service url. This attribute can be inherited from an ancestor.
32
+ ex : /docs-mock-api
33
+ - endPoint : the specific location where requests for information are sent (see the api docs).
34
+ ex : api/users | api/users?page=2 | api/users/2
35
+ - dataProvider (Required) : An ID that is used as a reference to the object storing the data returned by the API.
36
+ This attribute can be inherited from an ancestor.
37
+
38
+ Hover to see the data
39
+
40
+ DataProvider as an endPoint
41
+ If no endPoint is specified it will be filled by the dataProvider ID instead
42
+
43
+ Hover to see the data
44
+
45
+ HeadersDataProvider
46
+
47
+ Deprecated
48
+
49
+ Key
50
+ When the key attribute is present, only a sub-part of the data received is injected into the dataProvider.
51
+ We can use the dot syntax to target what we want to keep.
52
+
53
+ For example if the data </pre>
54
+ </section>
55
+ <section id="core-components-functional-list-list" data-doc-id="core/components/functional/list/list">
56
+ <h2><a href="../core/components/functional/list/list.html">List</a></h2>
57
+ <p><strong>Doc ID:</strong> <code>core/components/functional/list/list</code> · <a href="../core/components/functional/list/list.html">full page</a></p>
58
+ <p>&gt; Try offline: serviceURL=&quot;/docs-mock-api&quot; and dataProvider=&quot;api/users&quot; with key=&quot;data&quot; — see Local API demos. Recommended patterns: Data flow.</p>
59
+ <pre class="doc-excerpt">List
60
+
61
+ &gt; Try offline: serviceURL=&quot;/docs-mock-api&quot; and dataProvider=&quot;api/users&quot; with key=&quot;data&quot; — see Local API demos. Recommended patterns: Data flow.
62
+
63
+ The sonic-list component renders one row per entry in props (array from fetch or set on the element).
64
+
65
+ List extends Subscriber and Fetcher:
66
+ Subscriber — props + dataProvider
67
+ Fetcher — optional fetch + serviceURL / key (see Fetch)
68
+
69
+ Row renderer (items) — recommended
70
+
71
+ From a Lit parent, pass a function on the items property (ListItems). Each row is wrapped in a sonic-subscriber with dataProvider=&quot;…/list-item/n&quot; (hover rows with debug).
72
+
73
+ private items = ({ firstname, lastname, email, avatar }) =&gt; html
74
+
75
+ ${firstname} ${lastname}
76
+ ${email}
77
+ ;
78
+
79
+ html ;
80
+
81
+ Use .items=${fn} (property binding): Lit passes functions only as properties, not as HTML attributes — @property({ type: Function }) does not change that. Same for .noItems, .separator, .skeleton. The callback receives each row object (replacing data-bind / in a ).
82
+
83
+ Live demo + TypeScript source (one file, no Markdown copy):
84
+
85
+ Implementation: src/docs/example/docs-users-list.ts — row markup in the items callback (item.firstname, …), same idea as replacing data-bind / in a .
86
+
87
+ Alte</pre>
88
+ </section>
89
+ <section id="core-components-functional-queue-queue" data-doc-id="core/components/functional/queue/queue">
90
+ <h2><a href="../core/components/functional/queue/queue.html">Queue</a></h2>
91
+ <p><strong>Doc ID:</strong> <code>core/components/functional/queue/queue</code> · <a href="../core/components/functional/queue/queue.html">full page</a></p>
92
+ <p>&gt; Try offline: serviceURL=&quot;/docs-mock-api&quot; — see Local API demos. Row rendering: Data flow (.items property binding).</p>
93
+ <pre class="doc-excerpt">Queue
94
+
95
+ &gt; Try offline: serviceURL=&quot;/docs-mock-api&quot; — see Local API demos. Row rendering: Data flow (.items property binding).
96
+
97
+ sonic-queue loads data in batches. Each batch is an internal List with its own dataProvider (…/list-item/0, …/1, …).
98
+
99
+ | Mechanism | Role |
100
+ |-----------|------|
101
+ | dataProviderExpression | API path template; $offset and $limit are replaced per batch |
102
+ | lazyload | Load the next batch when the user scrolls near the end |
103
+ | dataFilterProvider | Publisher id of a form (formDataProvider); field values are merged into the request query string |
104
+ | filteredFields | Optional list of form field names to exclude from the query (space-separated) — omit when every field should be sent |
105
+ | .items, .noItems, .separator, .skeleton | Lit callbacks forwarded to each batch list (use the dot — functions are properties, not attributes) |
106
+
107
+ Lazy load — $offset and $limit
108
+
109
+ When the expression contains $offset and $limit, the queue:
110
+
111
+ 1. Fetches the first batch with offset=0 (or the initial offset attribute) and perpage=$limit.
112
+ 2. On scroll, appends a batch with offset increased by the previous batch size.
113
+ 3. Stops when a batch returns fewer rows than limit (or none).
114
+
115
+ The doc mock im</pre>
116
+ </section>
117
+ <section id="docs-_core-concept-dataFlow" data-doc-id="docs/_core-concept/dataFlow">
118
+ <h2><a href="../docs/_core-concept/dataFlow.html">Data flow</a></h2>
119
+ <p><strong>Doc ID:</strong> <code>docs/_core-concept/dataFlow</code> · <a href="../docs/_core-concept/dataFlow.html">full page</a></p>
120
+ <p>Recommended patterns for new Concorde apps (Lit + TypeScript). Under the hood, data lives in a DataProvider store (legacy Publisher API: Legacy: Sharing data).</p>
121
+ <pre class="doc-excerpt">Data flow
122
+
123
+ Recommended patterns for new Concorde apps (Lit + TypeScript). Under the hood, data lives in a DataProvider store (legacy Publisher API: Legacy: Sharing data).
124
+
125
+ Quick map
126
+
127
+ | Need | Use |
128
+ |------|-----|
129
+ | Read/write in code | get / set / dp + DataProviderKey (static paths only) |
130
+ | Reactive Lit template | sub(key) or @subscribe |
131
+ | Read component state from store | @subscribe + DataProviderKey + @state |
132
+ | Inherit ancestor attributes | @ancestorAttribute |
133
+ | Write from component state | @publish |
134
+ | React to assignments | @handle |
135
+ | HTTP GET | @get + Endpoint, or sonic-list / sonic-queue with fetch |
136
+ | HTTP POST (body from store) | @post + Endpoint + body DataProviderKey |
137
+ | HTTP PUT / PATCH (body from store) | @put / @patch — same model as @post |
138
+ | Forms | formDataProvider + name on fields (no Subscriber on form elements) |
139
+ | Derived / aggregate (JSONata) | derive() or sonic-jsonata — Jsonata |
140
+ | Offline doc demos | serviceURL=&quot;/docs-mock-api&quot; — Local API demos |
141
+
142
+ Skill: concorde-get-set-dp in the package ai/ folder.
143
+
144
+ DataProviderKey
145
+
146
+ import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
147
+ import { dp, get, set } from &quot;@supersoniks/concorde/utils&quot;;
148
+
149
+ c</pre>
150
+ </section>
151
+ <section id="docs-_decorators-get" data-doc-id="docs/_decorators/get">
152
+ <h2><a href="../docs/_decorators/get.html">@get</a></h2>
153
+ <p><strong>Doc ID:</strong> <code>docs/_decorators/get</code> · <a href="../docs/_decorators/get.html">full page</a></p>
154
+ <p>@get loads data and stores the result in an optional ApiResult&lt;T&gt; property.</p>
155
+ <pre class="doc-excerpt">@get
156
+
157
+ @get loads data and stores the result in an optional ApiResult property.
158
+ The property is undefined until a result is available.
159
+
160
+ - payload.result: typed data;
161
+ - payload.response: the HTTP response;
162
+ - payload.request: the request that was sent.
163
+
164
+ Minimal usage
165
+
166
+ const usersEndpoint = new Endpoint (&quot;users&quot;);
167
+
168
+ @get(usersEndpoint)
169
+ @state()
170
+ payload?: ApiResult ;
171
+
172
+ The same decorator adapts to a method. The method receives the complete
173
+ ApiResult payload after each GET:
174
+
175
+ @get(usersEndpoint)
176
+ handleUsers(payload?: ApiResult ) {
177
+ if (!payload) return;
178
+
179
+ console.log(payload.response?.status);
180
+ console.log(payload.result);
181
+ }
182
+
183
+ The first argument is always an
184
+ Endpoint . API configuration is read
185
+ from the HTML scope (serviceURL, token, etc.), so the component is usually
186
+ placed below an element that provides this configuration.
187
+
188
+ Refetching a GET
189
+
190
+ From the component
191
+
192
+ Keep the decorator in a constant to access refetch(component). Refetch only
193
+ targets the instance passed as the argument, even before it has received a
194
+ result.
195
+
196
+ const usersGet = get(new Endpoint (&quot;users&quot;));
197
+
198
+ @usersGet
199
+ @state()
200
+ payload?: ApiResult ;
201
+
202
+ async refresh() {
203
+ const payload = await usersGet.refetch(this);
204
+ console.log(</pre>
205
+ </section>
206
+ <section id="docs-_decorators-patch" data-doc-id="docs/_decorators/patch">
207
+ <h2><a href="../docs/_decorators/patch.html">@patch</a></h2>
208
+ <p><strong>Doc ID:</strong> <code>docs/_decorators/patch</code> · <a href="../docs/_decorators/patch.html">full page</a></p>
209
+ <p>@patch applies a partial update with the body from a publisher. It uses the</p>
210
+ <pre class="doc-excerpt">@patch
211
+
212
+ @patch applies a partial update with the body from a publisher. It uses the
213
+ same model as @post:
214
+ Endpoint , DataProviderKey , ApiResult , options, and the
215
+ send(component) handle.
216
+
217
+ Minimal usage
218
+
219
+ const bodyKey = new DataProviderKey &gt;(&quot;users.patch&quot;);
220
+ const patchUser = patch(new Endpoint (&quot;users/42&quot;), bodyKey);
221
+
222
+ @patchUser
223
+ @state()
224
+ payload?: ApiResult ;
225
+
226
+ The same decorator adapts to a method:
227
+
228
+ @patch(new Endpoint (&quot;users/42&quot;), bodyKey)
229
+ handlePatch(payload?: ApiResult ) {
230
+ if (payload?.response?.ok) console.log(payload.result);
231
+ }
232
+
233
+ To run the operation again from the component:
234
+
235
+ async savePatch() {
236
+ await patchUser.send(this);
237
+ }
238
+
239
+ send(component) returns a Promise resolved after the PATCH completes. See
240
+ @post for the method-decorator form and the
241
+ when: &quot;before&quot; option.
242
+
243
+ The PATCH is also sent automatically when the body mutates, unless
244
+ autoPostOnBodyMutation: false is set. The available options are described in
245
+ @post:
246
+
247
+ - autoPostOnBodyMutation
248
+ - skipIfBodyMissing
249
+ - refetchEveryMs
250
+ - skipEmptyPlaceholder
251
+ - triggerKey
252
+
253
+ Pass explicit API configuration as the third argument:
254
+
255
+ @patch(endpoint, bodyKey, apiConfigurationKey)
256
+
257
+ Import
258
+
259
+ import { patch, type ApiResult } from &quot;@supersoniks/</pre>
260
+ </section>
261
+ <section id="docs-_decorators-post" data-doc-id="docs/_decorators/post">
262
+ <h2><a href="../docs/_decorators/post.html">@post</a></h2>
263
+ <p><strong>Doc ID:</strong> <code>docs/_decorators/post</code> · <a href="../docs/_decorators/post.html">full page</a></p>
264
+ <p>@post sends the contents of a publisher and stores the response in an</p>
265
+ <pre class="doc-excerpt">@post
266
+
267
+ @post sends the contents of a publisher and stores the response in an
268
+ optional ApiResult property. The property is undefined until a result
269
+ is available.
270
+
271
+ Minimal usage
272
+
273
+ Pass an Endpoint and a DataProviderKey for the request body.
274
+
275
+ const userBodyKey = new DataProviderKey (&quot;users.form&quot;);
276
+ const createUser = post(new Endpoint (&quot;users&quot;), userBodyKey);
277
+
278
+ @createUser
279
+ @state()
280
+ payload?: ApiResult ;
281
+
282
+ The same decorator adapts to a method and receives the complete payload:
283
+
284
+ @post(new Endpoint (&quot;users&quot;), userBodyKey)
285
+ handleCreate(payload?: ApiResult ) {
286
+ if (payload?.response?.ok) console.log(payload.result);
287
+ }
288
+
289
+ The current body is read from userBodyKey. By default, the POST is sent when
290
+ the component connects and after each body mutation. Mutations in the same
291
+ frame are coalesced into one request.
292
+
293
+ API configuration is read from the HTML scope, as with
294
+ @get.
295
+
296
+ Sending the POST again
297
+
298
+ From the component
299
+
300
+ Keep the decorator to access send(component). The body is read again when the
301
+ operation runs.
302
+
303
+ async saveAgain() {
304
+ const payload = await createUser.send(this);
305
+ console.log(payload?.result);
306
+ }
307
+
308
+ send() returns a Promise | undefined&gt; that resolves after the
309
+ operation completes. It</pre>
310
+ </section>
311
+ <section id="docs-_decorators-put" data-doc-id="docs/_decorators/put">
312
+ <h2><a href="../docs/_decorators/put.html">@put</a></h2>
313
+ <p><strong>Doc ID:</strong> <code>docs/_decorators/put</code> · <a href="../docs/_decorators/put.html">full page</a></p>
314
+ <p>@put replaces a resource with the body from a publisher. It uses exactly the</p>
315
+ <pre class="doc-excerpt">@put
316
+
317
+ @put replaces a resource with the body from a publisher. It uses exactly the
318
+ same model as @post:
319
+ Endpoint , DataProviderKey , ApiResult , options, and the
320
+ send(component) handle.
321
+
322
+ Minimal usage
323
+
324
+ const bodyKey = new DataProviderKey (&quot;users.form&quot;);
325
+ const updateUser = put(new Endpoint (&quot;users/42&quot;), bodyKey);
326
+
327
+ @updateUser
328
+ @state()
329
+ payload?: ApiResult ;
330
+
331
+ The same decorator adapts to a method:
332
+
333
+ @put(new Endpoint (&quot;users/42&quot;), bodyKey)
334
+ handleUpdate(payload?: ApiResult ) {
335
+ if (payload?.response?.ok) console.log(payload.result);
336
+ }
337
+
338
+ To run the operation again from the component:
339
+
340
+ async update() {
341
+ await updateUser.send(this);
342
+ }
343
+
344
+ send(component) returns a Promise resolved after the PUT completes. See
345
+ @post for the method-decorator form and the
346
+ when: &quot;before&quot; option.
347
+
348
+ The PUT is also sent automatically when the body mutates, unless
349
+ autoPostOnBodyMutation: false is set. See
350
+ @post for the option details:
351
+
352
+ - autoPostOnBodyMutation
353
+ - skipIfBodyMissing
354
+ - refetchEveryMs
355
+ - skipEmptyPlaceholder
356
+ - triggerKey
357
+
358
+ Pass explicit API configuration as the third argument:
359
+
360
+ @put(endpoint, bodyKey, apiConfigurationKey)
361
+
362
+ Import
363
+
364
+ import { put, type ApiResult } from &quot;@supersoniks/concorde/decorators&quot;;
365
+ impo</pre>
366
+ </section>
367
+ <section id="docs-_misc-api-configuration" data-doc-id="docs/_misc/api-configuration">
368
+ <h2><a href="../docs/_misc/api-configuration.html">API configuration</a></h2>
369
+ <p><strong>Doc ID:</strong> <code>docs/_misc/api-configuration</code> · <a href="../docs/_misc/api-configuration.html">full page</a></p>
370
+ <p>APIConfiguration is the object built by HTML.getApiConfiguration from ancestor attributes on the DOM (or from a typed publisher — see @get / @post configuration key). It is passed to API by fetchers, </p>
371
+ <pre class="doc-excerpt">API configuration
372
+
373
+ APIConfiguration is the object built by HTML.getApiConfiguration from ancestor attributes on the DOM (or from a typed publisher — see @get / @post configuration key). It is passed to API by fetchers, sonic-submit, the wording() directive, @get, @post, @put, and @patch.
374
+
375
+ &gt; Mock service: same Local API demos Service Worker / Vite middleware. Routes used on this page are listed in the API config routes section below.
376
+
377
+ Attribute map
378
+
379
+ | Attribute (ancestor) | APIConfiguration field | Role |
380
+ |---------------------|---------------------------|------|
381
+ | serviceURL | serviceURL | Base URL (e.g. /docs-mock-api) |
382
+ | token | token | Static Bearer sent on REST calls |
383
+ | userName / password | userName / password | Basic auth for tokenProvider fetch only |
384
+ | eventsApiToken | authToken | Bearer for tokenProvider when no Basic |
385
+ | tokenProvider | tokenProvider | Path to GET a new token ({ token } JSON) |
386
+ | wordingProvider | — (read by wording()) | Base path + query for label batch GET |
387
+ | wordingVersionProvider | — | Publisher id; bump version → reload wordings |
388
+ | credentials | credentials | fetch credentials mode |
389
+ | addHTTPResponse | addHTTPResponse | Attach sonichttpresponse </pre>
390
+ </section>
391
+ <section id="docs-_misc-dynamic-path" data-doc-id="docs/_misc/dynamic-path">
392
+ <h2><a href="../docs/_misc/dynamic-path.html">Dynamic path placeholders</a></h2>
393
+ <p><strong>Doc ID:</strong> <code>docs/_misc/dynamic-path</code> · <a href="../docs/_misc/dynamic-path.html">full page</a></p>
394
+ <p>Decorators and DataProviderKey paths can include placeholders resolved on the host component at runtime:</p>
395
+ <pre class="doc-excerpt">Dynamic path placeholders
396
+
397
+ Decorators and DataProviderKey paths can include placeholders resolved on the host component at runtime:
398
+
399
+ - ${prop} or {$prop} — e.g. &quot;users/${userId}&quot;, &quot;api/sessions/${sessionId}/sync&quot;
400
+ - Nested expressions — e.g. &quot;teams.${teamId}.members&quot;
401
+
402
+ Resolution is done by resolveDynamicPath. The root property names (userId, sessionId, …) are watched via requestAnimationFrame (see dynamicPropertyWatch.ts).
403
+
404
+ Default behaviour (ready / not ready)
405
+
406
+ | Placeholder value | Path ready? | Inserted segment | Notes |
407
+ |-------------------|---------------|------------------|-------|
408
+ | undefined | no | — | Wait until defined |
409
+ | null | no | — | Same as undefined |
410
+ | &quot;&quot; | yes | empty string | e.g. sessions//sync — request may still run |
411
+ | 0 | yes | &quot;0&quot; | Not treated as “missing” |
412
+ | false | yes | &quot;false&quot; | |
413
+ | 42, &quot;alpha&quot; | yes | &quot;42&quot;, &quot;alpha&quot; | |
414
+
415
+ When ready: false, decorators do not call the network (for @get / @post / @put / @patch), unsubscribe (@bind / @subscribe), or skip publisher binding (@publish / @handle). The decorated property is often left unchanged or set to undefined (HTTP decorators).
416
+
417
+ When the placeholder later becomes valid, observers run again and behaviour r</pre>
418
+ </section>
419
+ <section id="docs-_misc-endpoint" data-doc-id="docs/_misc/endpoint">
420
+ <h2><a href="../docs/_misc/endpoint.html">Endpoint</a></h2>
421
+ <p><strong>Doc ID:</strong> <code>docs/_misc/endpoint</code> · <a href="../docs/_misc/endpoint.html">full page</a></p>
422
+ <p>Endpoint&lt;T, U&gt; describes a single HTTP path (or a path accepted by API.get) and carries the expected response type T. Unlike DataProviderKey, there is no dot-navigation: the path is one string.</p>
423
+ <pre class="doc-excerpt">Endpoint
424
+
425
+ Endpoint describes a single HTTP path (or a path accepted by API.get) and carries the expected response type T. Unlike DataProviderKey, there is no dot-navigation: the path is one string.
426
+
427
+ The optional second generic U (default any) describes host properties used to resolve dynamic segments in the path (${…} / {$…}), for example with @get or @post. See Dynamic path placeholders for null / undefined / &quot;&quot; / 0 and skipEmptyPlaceholder.
428
+
429
+ Import
430
+
431
+ import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
432
+
433
+ Construction
434
+
435
+ const users = new Endpoint&amp;lt;User[]&amp;gt;(&quot;users?limit=10&quot;);
436
+ users.path; // &quot;users?limit=10&quot;
437
+
438
+ const one = new Endpoint&amp;lt;User, { userId: string }&amp;gt;(&quot;users/${userId}&quot;);
439
+ // userId on the host class is observed when used with @get
440
+
441
+ Normalization
442
+
443
+ Endpoint.normalizePath trims the string, rejects an empty path, strips leading slashes for paths relative to serviceURL, collapses duplicate slashes, and validates absolute http(s):// URLs.
444
+
445
+ Publisher key for payloads
446
+
447
+ getDataProviderKey() returns a typed publisher key whose path matches the endpoint path (payload typing follows ApiResult for this endpoint). Useful when pairing @get with @publish / @subscribe (see</pre>
448
+ </section>
449
+ </article>
450
+ </main>
451
+ </body>
452
+ </html>
package/docs/crawl/index.html ADDED
@@ -0,0 +1,103 @@
1
+ <!DOCTYPE html>
2
+ <html lang="fr" data-doc-id="crawl-index">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Concorde documentation index</title>
7
+ <meta name="description" content="Static crawl index for Concorde framework documentation. All pages use .html under /crawl/.">
8
+ <meta name="keywords" content="Concorde, documentation index, web components, Lit, DataProvider">
9
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/index.html">
10
+ </head>
11
+ <body>
12
+ <header>
13
+ <h1>Concorde documentation</h1>
14
+ <p>Static pages for crawlers and AI indexing. Interactive docs: <a href="https://concorde.supersoniks.org/">https://concorde.supersoniks.org/</a></p>
15
+ <p>Full text mirror: <a href="https://concorde.supersoniks.org/llms-full.txt">llms-full.txt</a></p>
16
+ <ul>
17
+ <li><a href="hubs/decorators.html">Decorators hub (@get, @post, …)</a></li>
18
+ <li><a href="hubs/remote-data.html">Remote data hub (@get, List, Queue)</a></li>
19
+ <li><a href="hubs/form-components.html">Form components hub</a></li>
20
+ </ul>
21
+ </header>
22
+ <main>
23
+ <ul>
24
+ <li><a href="core/components/functional/date/date.html">Date</a> <small>(core/components/functional/date/date)</small></li>
25
+ <li><a href="core/components/functional/fetch/fetch.html">Fetch</a> <small>(core/components/functional/fetch/fetch)</small></li>
26
+ <li><a href="core/components/functional/if/if.html">if</a> <small>(core/components/functional/if/if)</small></li>
27
+ <li><a href="core/components/functional/jsonata/jsonata.html">Jsonata</a> <small>(core/components/functional/jsonata/jsonata)</small></li>
28
+ <li><a href="core/components/functional/list/list.html">List</a> <small>(core/components/functional/list/list)</small></li>
29
+ <li><a href="core/components/functional/mix/mix.html">Mix</a> <small>(core/components/functional/mix/mix)</small></li>
30
+ <li><a href="core/components/functional/queue/queue.html">Queue</a> <small>(core/components/functional/queue/queue)</small></li>
31
+ <li><a href="core/components/functional/router/router.html">Router</a> <small>(core/components/functional/router/router)</small></li>
32
+ <li><a href="core/components/functional/sdui/sdui-extension-points.html">SDUI — points d’extension publics</a> <small>(core/components/functional/sdui/sdui-extension-points)</small></li>
33
+ <li><a href="core/components/functional/sdui/sdui.html">SDUI</a> <small>(core/components/functional/sdui/sdui)</small></li>
34
+ <li><a href="core/components/functional/states/states.html">States</a> <small>(core/components/functional/states/states)</small></li>
35
+ <li><a href="core/components/functional/submit/submit.html">Submit</a> <small>(core/components/functional/submit/submit)</small></li>
36
+ <li><a href="core/components/functional/subscriber/subscriber.html">Subscriber</a> <small>(core/components/functional/subscriber/subscriber)</small></li>
37
+ <li><a href="core/components/functional/value/value.html">Value</a> <small>(core/components/functional/value/value)</small></li>
38
+ <li><a href="core/components/ui/alert-messages/alert-messages.html">Alert messages</a> <small>(core/components/ui/alert-messages/alert-messages)</small></li>
39
+ <li><a href="core/components/ui/alert/alert.html">Alert</a> <small>(core/components/ui/alert/alert)</small></li>
40
+ <li><a href="core/components/ui/badge/badge.html">Badge</a> <small>(core/components/ui/badge/badge)</small></li>
41
+ <li><a href="core/components/ui/button/button.html">Button</a> <small>(core/components/ui/button/button)</small></li>
42
+ <li><a href="core/components/ui/captcha/captcha.html">Captcha</a> <small>(core/components/ui/captcha/captcha)</small></li>
43
+ <li><a href="core/components/ui/card/card.html">Card</a> <small>(core/components/ui/card/card)</small></li>
44
+ <li><a href="core/components/ui/divider/divider.html">Divider</a> <small>(core/components/ui/divider/divider)</small></li>
45
+ <li><a href="core/components/ui/form/checkbox/checkbox.html">Checkbox</a> <small>(core/components/ui/form/checkbox/checkbox)</small></li>
46
+ <li><a href="core/components/ui/form/fieldset/fieldset.html">Fieldset</a> <small>(core/components/ui/form/fieldset/fieldset)</small></li>
47
+ <li><a href="core/components/ui/form/form-actions/form-actions.html">Form actions</a> <small>(core/components/ui/form/form-actions/form-actions)</small></li>
48
+ <li><a href="core/components/ui/form/form-layout/form-layout.html">Form layout</a> <small>(core/components/ui/form/form-layout/form-layout)</small></li>
49
+ <li><a href="core/components/ui/form/input-autocomplete/input-autocomplete.html">Input-autocomplete</a> <small>(core/components/ui/form/input-autocomplete/input-autocomplete)</small></li>
50
+ <li><a href="core/components/ui/form/input/input.html">Input</a> <small>(core/components/ui/form/input/input)</small></li>
51
+ <li><a href="core/components/ui/form/radio/radio.html">Radio</a> <small>(core/components/ui/form/radio/radio)</small></li>
52
+ <li><a href="core/components/ui/form/select/select.html">Select</a> <small>(core/components/ui/form/select/select)</small></li>
53
+ <li><a href="core/components/ui/form/switch/switch.html">Switch</a> <small>(core/components/ui/form/switch/switch)</small></li>
54
+ <li><a href="core/components/ui/form/textarea/textarea.html">Textarea</a> <small>(core/components/ui/form/textarea/textarea)</small></li>
55
+ <li><a href="core/components/ui/group/group.html">Group</a> <small>(core/components/ui/group/group)</small></li>
56
+ <li><a href="core/components/ui/icon/icon.html">Icon</a> <small>(core/components/ui/icon/icon)</small></li>
57
+ <li><a href="core/components/ui/image/image.html">Image</a> <small>(core/components/ui/image/image)</small></li>
58
+ <li><a href="core/components/ui/link/link.html">Link</a> <small>(core/components/ui/link/link)</small></li>
59
+ <li><a href="core/components/ui/loader/loader.html">Loader</a> <small>(core/components/ui/loader/loader)</small></li>
60
+ <li><a href="core/components/ui/menu/menu.html">Menu</a> <small>(core/components/ui/menu/menu)</small></li>
61
+ <li><a href="core/components/ui/modal/modal.html">Modal</a> <small>(core/components/ui/modal/modal)</small></li>
62
+ <li><a href="core/components/ui/pop/pop.html">Pop</a> <small>(core/components/ui/pop/pop)</small></li>
63
+ <li><a href="core/components/ui/progress/progress.html">Progress</a> <small>(core/components/ui/progress/progress)</small></li>
64
+ <li><a href="core/components/ui/table/table.html">Table</a> <small>(core/components/ui/table/table)</small></li>
65
+ <li><a href="core/components/ui/theme/theme.html">Theme</a> <small>(core/components/ui/theme/theme)</small></li>
66
+ <li><a href="core/components/ui/toast/toast.html">Toast</a> <small>(core/components/ui/toast/toast)</small></li>
67
+ <li><a href="core/components/ui/tooltip/tooltip.html">Tooltip</a> <small>(core/components/ui/tooltip/tooltip)</small></li>
68
+ <li><a href="docs/_core-concept/dataFlow.html">Data flow</a> <small>(docs/_core-concept/dataFlow)</small></li>
69
+ <li><a href="docs/_core-concept/overview.html">lit + tailwind + vite</a> <small>(docs/_core-concept/overview)</small></li>
70
+ <li><a href="docs/_core-concept/subscriber.html">Legacy: Subscriber mixin</a> <small>(docs/_core-concept/subscriber)</small></li>
71
+ <li><a href="docs/_decorators/ancestor-attribute.html">@ancestorAttribute</a> <small>(docs/_decorators/ancestor-attribute)</small></li>
72
+ <li><a href="docs/_decorators/auto-subscribe.html">@autoSubscribe</a> <small>(docs/_decorators/auto-subscribe)</small></li>
73
+ <li><a href="docs/_decorators/bind.html">@bind</a> <small>(docs/_decorators/bind)</small></li>
74
+ <li><a href="docs/_decorators/get.html">@get</a> <small>(docs/_decorators/get)</small></li>
75
+ <li><a href="docs/_decorators/handle.html">@handle</a> <small>(docs/_decorators/handle)</small></li>
76
+ <li><a href="docs/_decorators/on-assign.html">@onAssign</a> <small>(docs/_decorators/on-assign)</small></li>
77
+ <li><a href="docs/_decorators/patch.html">@patch</a> <small>(docs/_decorators/patch)</small></li>
78
+ <li><a href="docs/_decorators/post.html">@post</a> <small>(docs/_decorators/post)</small></li>
79
+ <li><a href="docs/_decorators/publish.html">@publish</a> <small>(docs/_decorators/publish)</small></li>
80
+ <li><a href="docs/_decorators/put.html">@put</a> <small>(docs/_decorators/put)</small></li>
81
+ <li><a href="docs/_decorators/subscribe.html">@subscribe</a> <small>(docs/_decorators/subscribe)</small></li>
82
+ <li><a href="docs/_decorators/wait-for-ancestors.html">@awaitConnectedAncestors and @dispatchConnectedEvent</a> <small>(docs/_decorators/wait-for-ancestors)</small></li>
83
+ <li><a href="docs/_directives/sub.html">sub()</a> <small>(docs/_directives/sub)</small></li>
84
+ <li><a href="docs/_getting-started/ai-agents.html">AI agents (skills &amp; AGENTS.md)</a> <small>(docs/_getting-started/ai-agents)</small></li>
85
+ <li><a href="docs/_getting-started/concorde-manual-install.html">Manual installation (Vite)</a> <small>(docs/_getting-started/concorde-manual-install)</small></li>
86
+ <li><a href="docs/_getting-started/concorde-outside.html">Installation</a> <small>(docs/_getting-started/concorde-outside)</small></li>
87
+ <li><a href="docs/_getting-started/create-a-component.html">Creating components</a> <small>(docs/_getting-started/create-a-component)</small></li>
88
+ <li><a href="docs/_getting-started/my-first-component.html">My first component</a> <small>(docs/_getting-started/my-first-component)</small></li>
89
+ <li><a href="docs/_getting-started/my-first-subscriber.html">Legacy: My first subscriber component</a> <small>(docs/_getting-started/my-first-subscriber)</small></li>
90
+ <li><a href="docs/_getting-started/pubsub.html">Legacy: Sharing data</a> <small>(docs/_getting-started/pubsub)</small></li>
91
+ <li><a href="docs/_getting-started/start.html">Introduction</a> <small>(docs/_getting-started/start)</small></li>
92
+ <li><a href="docs/_getting-started/theming.html">Customization</a> <small>(docs/_getting-started/theming)</small></li>
93
+ <li><a href="docs/_misc/api-configuration.html">API configuration</a> <small>(docs/_misc/api-configuration)</small></li>
94
+ <li><a href="docs/_misc/dataProviderKey.html">DataProviderKey</a> <small>(docs/_misc/dataProviderKey)</small></li>
95
+ <li><a href="docs/_misc/docs-mock-api.html">Local API demos (offline)</a> <small>(docs/_misc/docs-mock-api)</small></li>
96
+ <li><a href="docs/_misc/dynamic-path.html">Dynamic path placeholders</a> <small>(docs/_misc/dynamic-path)</small></li>
97
+ <li><a href="docs/_misc/endpoint.html">Endpoint</a> <small>(docs/_misc/endpoint)</small></li>
98
+ <li><a href="docs/_misc/formelement-subscriber-removal.html">FormElement without Subscriber (REDMINE-79569)</a> <small>(docs/_misc/formelement-subscriber-removal)</small></li>
99
+ <li><a href="docs/_misc/html-integration.html">HTML integration (no Lit)</a> <small>(docs/_misc/html-integration)</small></li>
100
+ </ul>
101
+ </main>
102
+ </body>
103
+ </html>