@supersoniks/concorde 5.1.1 → 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 (459) 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/skills +1 -0
  6. package/.github/workflows/ci.yml +21 -0
  7. package/.github-export-ignore +30 -0
  8. package/CONTRIBUTING.md +59 -0
  9. package/DEV.md +54 -0
  10. package/LICENSE +21 -0
  11. package/OPEN_SOURCE_CHECKPOINT.md +133 -0
  12. package/README.md +4 -4
  13. package/ai/README.md +29 -41
  14. package/ai/skills/concorde/SKILL.md +54 -324
  15. package/ai/skills/concorde/rules/composition.md +32 -0
  16. package/ai/skills/concorde/rules/data.md +47 -0
  17. package/ai/skills/concorde/rules/http.md +25 -0
  18. package/ai/skills/concorde/rules/lists-forms.md +35 -0
  19. package/ai/skills/concorde/rules/styling.md +46 -0
  20. package/ai/skills/concorde/rules/troubleshooting.md +45 -0
  21. package/build-infos.json +1 -1
  22. package/concorde-core.bundle.js +177 -177
  23. package/concorde-core.es.js +4993 -4833
  24. package/custom-elements-manifest.public.config.mjs +8 -0
  25. package/{.tmp-cem/custom-elements.json → custom-elements.json} +11758 -8904
  26. package/dist/concorde-core.bundle.js +177 -177
  27. package/dist/concorde-core.es.js +4993 -4833
  28. package/dist/docs-mock-api-sw.js +58 -223
  29. package/dist/docs-mock-api-sw.js.map +4 -4
  30. package/dist/img/concorde/plane_01.jpg +0 -0
  31. package/dist/img/concorde/plane_02.jpg +0 -0
  32. package/dist/img/concorde/plane_03.jpg +0 -0
  33. package/dist/img/concorde/plane_04.jpg +0 -0
  34. package/dist/img/concorde/plane_05.jpg +0 -0
  35. package/dist/img/concorde/plane_06.jpg +0 -0
  36. package/dist/img/concorde/plane_07.jpg +0 -0
  37. package/dist/img/concorde/plane_08.jpg +0 -0
  38. package/dist/img/concorde/plane_09.jpg +0 -0
  39. package/dist/img/concorde/plane_10.jpg +0 -0
  40. package/dist/img/concorde/plane_11.jpg +0 -0
  41. package/dist/img/concorde/plane_12.jpg +0 -0
  42. package/dist/img/concorde/plane_13.jpg +0 -0
  43. package/dist/img/og-concorde.jpg +0 -0
  44. package/dist/robots.txt +11 -10
  45. package/docs/assets/index-D_alEsng.js +12122 -0
  46. package/docs/crawl/core/components/functional/date/date.html +190 -0
  47. package/docs/crawl/core/components/functional/fetch/fetch.html +109 -0
  48. package/docs/crawl/core/components/functional/if/if.html +27 -0
  49. package/docs/crawl/core/components/functional/jsonata/jsonata.html +79 -0
  50. package/docs/crawl/core/components/functional/list/list.html +70 -0
  51. package/docs/crawl/core/components/functional/mix/mix.html +45 -0
  52. package/docs/crawl/core/components/functional/queue/queue.html +96 -0
  53. package/docs/crawl/core/components/functional/router/router.html +106 -0
  54. package/docs/crawl/core/components/functional/sdui/sdui-extension-points.html +126 -0
  55. package/docs/crawl/core/components/functional/sdui/sdui.html +368 -0
  56. package/docs/crawl/core/components/functional/states/states.html +66 -0
  57. package/docs/crawl/core/components/functional/submit/submit.html +160 -0
  58. package/docs/crawl/core/components/functional/subscriber/subscriber.html +67 -0
  59. package/docs/crawl/core/components/functional/value/value.html +51 -0
  60. package/docs/crawl/core/components/ui/alert/alert.html +211 -0
  61. package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +131 -0
  62. package/docs/crawl/core/components/ui/badge/badge.html +197 -0
  63. package/docs/crawl/core/components/ui/button/button.html +150 -0
  64. package/docs/crawl/core/components/ui/captcha/captcha.html +112 -0
  65. package/docs/crawl/core/components/ui/card/card.html +253 -0
  66. package/docs/crawl/core/components/ui/divider/divider.html +144 -0
  67. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +73 -0
  68. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +266 -0
  69. package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +122 -0
  70. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +121 -0
  71. package/docs/crawl/core/components/ui/form/input/input.html +109 -0
  72. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +38 -0
  73. package/docs/crawl/core/components/ui/form/radio/radio.html +56 -0
  74. package/docs/crawl/core/components/ui/form/select/select.html +73 -0
  75. package/docs/crawl/core/components/ui/form/switch/switch.html +56 -0
  76. package/docs/crawl/core/components/ui/form/textarea/textarea.html +59 -0
  77. package/docs/crawl/core/components/ui/group/group.html +104 -0
  78. package/docs/crawl/core/components/ui/icon/icon.html +222 -0
  79. package/docs/crawl/core/components/ui/image/image.html +298 -0
  80. package/docs/crawl/core/components/ui/link/link.html +100 -0
  81. package/docs/crawl/core/components/ui/loader/loader.html +124 -0
  82. package/docs/crawl/core/components/ui/menu/menu.html +394 -0
  83. package/docs/crawl/core/components/ui/modal/modal.html +342 -0
  84. package/docs/crawl/core/components/ui/pop/pop.html +296 -0
  85. package/docs/crawl/core/components/ui/progress/progress.html +131 -0
  86. package/docs/crawl/core/components/ui/table/table.html +545 -0
  87. package/docs/crawl/core/components/ui/theme/theme.html +131 -0
  88. package/docs/crawl/core/components/ui/toast/toast.html +233 -0
  89. package/docs/crawl/core/components/ui/tooltip/tooltip.html +140 -0
  90. package/docs/crawl/docs/_core-concept/dataFlow.html +177 -0
  91. package/docs/crawl/docs/_core-concept/overview.html +66 -0
  92. package/docs/crawl/docs/_core-concept/subscriber.html +75 -0
  93. package/docs/crawl/docs/_decorators/ancestor-attribute.html +117 -0
  94. package/docs/crawl/docs/_decorators/auto-subscribe.html +202 -0
  95. package/docs/crawl/docs/_decorators/bind.html +141 -0
  96. package/docs/crawl/docs/_decorators/get.html +149 -0
  97. package/docs/crawl/docs/_decorators/handle.html +165 -0
  98. package/docs/crawl/docs/_decorators/on-assign.html +355 -0
  99. package/docs/crawl/docs/_decorators/patch.html +78 -0
  100. package/docs/crawl/docs/_decorators/post.html +139 -0
  101. package/docs/crawl/docs/_decorators/publish.html +61 -0
  102. package/docs/crawl/docs/_decorators/put.html +78 -0
  103. package/docs/crawl/docs/_decorators/subscribe.html +109 -0
  104. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +137 -0
  105. package/docs/crawl/docs/_directives/sub.html +93 -0
  106. package/docs/crawl/docs/_getting-started/ai-agents.html +173 -0
  107. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +100 -0
  108. package/docs/crawl/docs/_getting-started/concorde-outside.html +58 -0
  109. package/docs/crawl/docs/_getting-started/create-a-component.html +111 -0
  110. package/docs/crawl/docs/_getting-started/my-first-component.html +189 -0
  111. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +110 -0
  112. package/docs/crawl/docs/_getting-started/pubsub.html +62 -0
  113. package/docs/crawl/docs/_getting-started/start.html +76 -0
  114. package/docs/crawl/docs/_getting-started/theming.html +333 -0
  115. package/docs/crawl/docs/_misc/api-configuration.html +149 -0
  116. package/docs/crawl/docs/_misc/dataProviderKey.html +135 -0
  117. package/docs/crawl/docs/_misc/docs-mock-api.html +158 -0
  118. package/docs/crawl/docs/_misc/dynamic-path.html +180 -0
  119. package/docs/crawl/docs/_misc/endpoint.html +50 -0
  120. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +138 -0
  121. package/docs/crawl/docs/_misc/html-integration.html +48 -0
  122. package/docs/crawl/hubs/decorators.html +547 -0
  123. package/docs/crawl/hubs/form-components.html +381 -0
  124. package/docs/crawl/hubs/remote-data.html +452 -0
  125. package/docs/crawl/index.html +103 -0
  126. package/docs/index.html +1 -1
  127. package/docs/llms-full.txt +7174 -0
  128. package/docs/llms.txt +98 -0
  129. package/docs/sitemap.xml +243 -0
  130. package/docs/src/core/components/functional/date/date.md +290 -0
  131. package/docs/src/core/components/functional/fetch/fetch.md +125 -0
  132. package/docs/src/core/components/functional/if/if.md +9 -0
  133. package/docs/src/core/components/functional/jsonata/jsonata.md +56 -0
  134. package/docs/src/core/components/functional/list/list.md +65 -0
  135. package/docs/src/core/components/functional/mix/mix.md +41 -0
  136. package/docs/src/core/components/functional/queue/queue.md +72 -0
  137. package/docs/src/core/components/functional/router/router.md +94 -0
  138. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  139. package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
  140. package/docs/src/core/components/functional/sdui/default-library.json +108 -0
  141. package/docs/src/core/components/functional/sdui/example.json +99 -0
  142. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  143. package/docs/src/core/components/functional/sdui/sdui.md +478 -0
  144. package/docs/src/core/components/functional/states/states.md +87 -0
  145. package/docs/src/core/components/functional/submit/submit.md +114 -0
  146. package/docs/src/core/components/functional/subscriber/subscriber.md +91 -0
  147. package/docs/src/core/components/functional/value/value.md +35 -0
  148. package/docs/src/core/components/ui/alert/alert.md +196 -0
  149. package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
  150. package/docs/src/core/components/ui/badge/badge.md +188 -0
  151. package/docs/src/core/components/ui/button/button.md +183 -0
  152. package/docs/src/core/components/ui/captcha/captcha.md +71 -0
  153. package/docs/src/core/components/ui/card/card.md +215 -0
  154. package/docs/src/core/components/ui/divider/divider.md +129 -0
  155. package/docs/src/core/components/ui/form/checkbox/checkbox.md +77 -0
  156. package/docs/src/core/components/ui/form/fieldset/fieldset.md +205 -0
  157. package/docs/src/core/components/ui/form/form-actions/form-actions.md +100 -0
  158. package/docs/src/core/components/ui/form/form-layout/form-layout.md +119 -0
  159. package/docs/src/core/components/ui/form/input/input.md +142 -0
  160. package/docs/src/core/components/ui/form/radio/radio.md +57 -0
  161. package/docs/src/core/components/ui/form/select/select.md +71 -0
  162. package/docs/src/core/components/ui/form/switch/switch.md +57 -0
  163. package/docs/src/core/components/ui/form/textarea/textarea.md +65 -0
  164. package/docs/src/core/components/ui/group/group.md +75 -0
  165. package/docs/src/core/components/ui/icon/icon.md +214 -0
  166. package/docs/src/core/components/ui/icon/icons.json +1 -0
  167. package/docs/src/core/components/ui/image/image.md +233 -0
  168. package/docs/src/core/components/ui/link/link.md +81 -0
  169. package/docs/src/core/components/ui/loader/loader.md +112 -0
  170. package/docs/src/core/components/ui/menu/menu.md +370 -0
  171. package/docs/src/core/components/ui/modal/modal.md +235 -0
  172. package/docs/src/core/components/ui/pop/pop.md +294 -0
  173. package/docs/src/core/components/ui/progress/progress.md +109 -0
  174. package/docs/src/core/components/ui/table/table.md +431 -0
  175. package/docs/src/core/components/ui/theme/theme.md +122 -0
  176. package/docs/src/core/components/ui/toast/toast.md +216 -0
  177. package/docs/src/core/components/ui/tooltip/tooltip.md +124 -0
  178. package/{src → docs/src}/docs/_core-concept/subscriber.md +0 -0
  179. package/{src → docs/src}/docs/_getting-started/my-first-subscriber.md +0 -0
  180. package/{src → docs/src}/docs/_getting-started/pubsub.md +0 -0
  181. package/docs/src/docs/_getting-started/theming.md +253 -0
  182. package/docs/src/docs/search/docs-search.json +12242 -0
  183. package/docs/src/tag-list.json +1 -0
  184. package/docs/src/tsconfig-model.json +23 -0
  185. package/docs/src/tsconfig.declarations.json +22 -0
  186. package/docs/src/tsconfig.emit.json +23 -0
  187. package/docs/src/tsconfig.json +1332 -0
  188. package/gitlab/job_github_mirror.sh +39 -0
  189. package/index.html +157 -5
  190. package/package.json +22 -4
  191. package/public/docs-mock-api-sw.js +58 -223
  192. package/public/docs-mock-api-sw.js.map +4 -4
  193. package/public/img/concorde/plane_01.jpg +0 -0
  194. package/public/img/concorde/plane_02.jpg +0 -0
  195. package/public/img/concorde/plane_03.jpg +0 -0
  196. package/public/img/concorde/plane_04.jpg +0 -0
  197. package/public/img/concorde/plane_05.jpg +0 -0
  198. package/public/img/concorde/plane_06.jpg +0 -0
  199. package/public/img/concorde/plane_07.jpg +0 -0
  200. package/public/img/concorde/plane_08.jpg +0 -0
  201. package/public/img/concorde/plane_09.jpg +0 -0
  202. package/public/img/concorde/plane_10.jpg +0 -0
  203. package/public/img/concorde/plane_11.jpg +0 -0
  204. package/public/img/concorde/plane_12.jpg +0 -0
  205. package/public/img/concorde/plane_13.jpg +0 -0
  206. package/public/img/og-concorde.jpg +0 -0
  207. package/public/robots.txt +11 -10
  208. package/scripts/ai-init.mjs +104 -379
  209. package/scripts/ai-init.test.mjs +81 -239
  210. package/scripts/docs-markdown-vite-plugin.ts +43 -0
  211. package/scripts/docs-public-url.mjs +56 -0
  212. package/scripts/docs.htaccess +82 -0
  213. package/scripts/generate-cem.mjs +244 -0
  214. package/scripts/generate-cem.test.mjs +122 -0
  215. package/scripts/generate-crawl-docs.mjs +233 -118
  216. package/scripts/generate-crawl-docs.test.mjs +124 -0
  217. package/scripts/generate-sdui-catalog.mjs +11 -10
  218. package/scripts/github-export.mjs +150 -0
  219. package/scripts/post-build-docs.js +37 -50
  220. package/scripts/post-build.mjs +0 -0
  221. package/scripts/pre-publish.mjs +2 -1
  222. package/scripts/site-pages.mjs +212 -0
  223. package/scripts/site-pages.test.mjs +116 -0
  224. package/site-pages/about.md +22 -0
  225. package/site-pages/privacy.md +32 -0
  226. package/src/core/components/functional/date/date.md +91 -231
  227. package/src/core/components/functional/example/example.ts +3 -1
  228. package/src/core/components/functional/fetch/fetch.md +66 -83
  229. package/src/core/components/functional/if/if.md +28 -3
  230. package/src/core/components/functional/if/if.ts +0 -0
  231. package/src/core/components/functional/jsonata/jsonata.md +42 -37
  232. package/src/core/components/functional/list/list.demo.ts +0 -0
  233. package/src/core/components/functional/list/list.md +103 -43
  234. package/src/core/components/functional/list/list.ts +17 -4
  235. package/src/core/components/functional/mix/mix.md +31 -26
  236. package/src/core/components/functional/queue/queue.demo.ts +10 -7
  237. package/src/core/components/functional/queue/queue.md +40 -61
  238. package/src/core/components/functional/router/router.demo.ts +16 -16
  239. package/src/core/components/functional/router/router.md +64 -65
  240. package/src/core/components/functional/router/router.ts +0 -0
  241. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  242. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  243. package/src/core/components/functional/sdui/component-catalog.json +2 -2
  244. package/src/core/components/functional/sdui/example.json +19 -86
  245. package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  246. package/src/core/components/functional/sdui/sdui-immutable.spec.ts +74 -0
  247. package/src/core/components/functional/sdui/sdui.md +187 -358
  248. package/src/core/components/functional/sdui/sdui.ts +33 -8
  249. package/src/core/components/functional/sdui/types.ts +0 -0
  250. package/src/core/components/functional/states/states.demo.ts +21 -22
  251. package/src/core/components/functional/states/states.md +86 -61
  252. package/src/core/components/functional/states/states.ts +1 -1
  253. package/src/core/components/functional/submit/submit.md +64 -72
  254. package/src/core/components/functional/submit/submit.spec.ts +60 -0
  255. package/src/core/components/functional/submit/submit.ts +6 -3
  256. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  257. package/src/core/components/functional/translation/translation.md +38 -0
  258. package/src/core/components/functional/value/value.md +34 -22
  259. package/src/core/components/functional/value/value.ts +0 -0
  260. package/src/core/components/ui/_css/size.ts +0 -0
  261. package/src/core/components/ui/alert/alert.md +48 -58
  262. package/src/core/components/ui/badge/badge.md +27 -34
  263. package/src/core/components/ui/button/button.md +139 -106
  264. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  265. package/src/core/components/ui/captcha/captcha.md +17 -32
  266. package/src/core/components/ui/card/card.md +6 -6
  267. package/src/core/components/ui/divider/divider.md +8 -11
  268. package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  269. package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
  270. package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
  271. package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
  272. package/src/core/components/ui/form/input/input.md +108 -90
  273. package/src/core/components/ui/form/input/input.ts +8 -2
  274. package/src/core/components/ui/form/radio/radio.md +65 -30
  275. package/src/core/components/ui/form/select/select.md +60 -45
  276. package/src/core/components/ui/form/switch/switch.md +57 -34
  277. package/src/core/components/ui/form/textarea/textarea.md +55 -38
  278. package/src/core/components/ui/group/group.md +35 -33
  279. package/src/core/components/ui/icon/icon.md +4 -4
  280. package/src/core/components/ui/image/image.md +41 -107
  281. package/src/core/components/ui/link/link.md +6 -6
  282. package/src/core/components/ui/loader/loader.md +30 -55
  283. package/src/core/components/ui/menu/menu.md +27 -27
  284. package/src/core/components/ui/modal/modal.md +72 -96
  285. package/src/core/components/ui/pop/pop.md +80 -158
  286. package/src/core/components/ui/progress/progress.md +2 -2
  287. package/src/core/components/ui/table/table.md +91 -255
  288. package/src/core/components/ui/theme/theme.md +11 -36
  289. package/src/core/components/ui/toast/toast.md +48 -117
  290. package/src/core/components/ui/tooltip/tooltip.md +27 -62
  291. package/src/core/decorators/subscriber/bind.ts +9 -14
  292. package/src/core/decorators/subscriber/subscribe.ts +15 -9
  293. package/src/core/decorators/subscriber/subscribe.type-test.ts +14 -5
  294. package/src/core/mixins/Subscriber.ts +0 -0
  295. package/src/core/utils/DataBindObserver.ts +0 -0
  296. package/src/core/utils/LocationHandler.spec.ts +80 -0
  297. package/src/core/utils/LocationHandler.ts +5 -9
  298. package/src/core/utils/Objects.ts +0 -0
  299. package/src/core/utils/PublisherProxy.ts +166 -125
  300. package/src/core/utils/deepReadonly.spec.ts +66 -0
  301. package/src/core/utils/deepReadonly.ts +71 -0
  302. package/src/core/utils/immutableValue.spec.ts +54 -0
  303. package/src/core/utils/immutableValue.ts +102 -0
  304. package/src/core/utils/nestedDotForm.spec.ts +88 -0
  305. package/src/core/utils/publisherImmutable.spec.ts +76 -0
  306. package/src/core/utils/route.ts +0 -0
  307. package/src/core/utils/strictGet.spec.ts +61 -0
  308. package/src/core/utils/strictGet.ts +102 -0
  309. package/src/css.d.ts +19 -0
  310. package/src/docs/components/docs-demo-sources.ts +55 -140
  311. package/src/docs/components/docs-lit-demo.ts +1 -3
  312. package/src/docs/components/docs-source-link.ts +0 -82
  313. package/src/docs/decorators/ancestor-attribute.md +59 -0
  314. package/src/docs/decorators/auto-subscribe.md +40 -0
  315. package/src/docs/decorators/bind.md +76 -0
  316. package/src/docs/decorators/get.md +160 -0
  317. package/src/docs/decorators/handle.md +119 -0
  318. package/src/docs/decorators/on-assign.md +63 -0
  319. package/src/docs/decorators/patch.md +44 -0
  320. package/src/docs/decorators/post.md +134 -0
  321. package/src/docs/decorators/publish.md +56 -0
  322. package/src/docs/decorators/put.md +51 -0
  323. package/src/docs/decorators/subscribe.md +87 -0
  324. package/src/docs/decorators/wait-for-ancestors.md +76 -0
  325. package/src/docs/directives/sub.md +75 -0
  326. package/src/docs/directives/t.md +73 -0
  327. package/src/docs/docs-location.spec.ts +56 -0
  328. package/src/docs/docs-location.ts +133 -32
  329. package/src/docs/docs.ts +1 -2
  330. package/src/docs/example/decorators-demo-bind-demos.ts +83 -135
  331. package/src/docs/example/decorators-demo-geo.ts +30 -19
  332. package/src/docs/example/decorators-demo-post.ts +88 -186
  333. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
  334. package/src/docs/example/decorators-demo.ts +85 -98
  335. package/src/docs/example/docs-api-config-demos.ts +19 -20
  336. package/src/docs/example/docs-flight-demos.ts +147 -0
  337. package/src/docs/example/docs-jsonata-demos.ts +52 -52
  338. package/src/docs/example/docs-list-demos.ts +43 -123
  339. package/src/docs/example/docs-provider-keys.ts +21 -28
  340. package/src/docs/example/docs-queue-demos.ts +37 -77
  341. package/src/docs/example/docs-router-demos.ts +20 -25
  342. package/src/docs/example/docs-submit-demos.ts +48 -48
  343. package/src/docs/example/docs-toggle-demos.ts +4 -3
  344. package/src/docs/example/users.ts +0 -0
  345. package/src/docs/getting-started/ai-agents.md +50 -0
  346. package/src/docs/getting-started/create-a-component.md +136 -0
  347. package/src/docs/getting-started/dataFlow.md +87 -0
  348. package/src/docs/getting-started/installation.md +36 -0
  349. package/src/docs/getting-started/my-first-component.md +227 -0
  350. package/src/docs/getting-started/start.md +35 -0
  351. package/src/docs/header/header.ts +11 -6
  352. package/src/docs/home/catalog.ts +1 -1
  353. package/src/docs/home/home.ts +20 -11
  354. package/src/docs/layout.ts +12 -13
  355. package/src/docs/misc/api-configuration.md +79 -0
  356. package/src/docs/misc/dataProviderKey.md +168 -0
  357. package/src/docs/misc/docs-mock-api.md +62 -0
  358. package/src/docs/misc/dynamic-path.md +71 -0
  359. package/src/docs/misc/endpoint.md +45 -0
  360. package/src/docs/misc/html-integration.md +14 -0
  361. package/src/docs/misc/publisher-get-immutability-docs-crawl.json +902 -0
  362. package/src/docs/misc/publisher-get-immutability-docs-recheck.json +13 -0
  363. package/src/docs/misc/publisher-get-immutability-study.md +229 -0
  364. package/src/docs/mock-api/api-config-mock.ts +5 -0
  365. package/src/docs/mock-api/fixtures.ts +0 -278
  366. package/src/docs/mock-api/flights.ts +89 -0
  367. package/src/docs/mock-api/router.ts +3 -4
  368. package/src/docs/mock-api/urls.ts +1 -2
  369. package/src/docs/navigation/navigation.ts +84 -101
  370. package/src/docs/navigation/toc.ts +7 -4
  371. package/src/docs/search/docs-search.json +3188 -5153
  372. package/src/docs/search/markdown-renderer.ts +31 -8
  373. package/src/docs/search/page.ts +9 -6
  374. package/src/docs/search/search.ts +154 -122
  375. package/src/docs/tailwind/css/docs/content.css +4 -5
  376. package/src/tsconfig.declarations.json +22 -0
  377. package/src/tsconfig.emit.json +23 -0
  378. package/src/tsconfig.json +53 -5
  379. package/src/tsconfig.tsbuildinfo +1 -1
  380. package/vite.config.mts +11 -2
  381. package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
  382. package/.taste-skill/after/desktop-fold.jpg +0 -0
  383. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  384. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  385. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  386. package/.taste-skill/after/mobile-fold.jpg +0 -0
  387. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  388. package/.taste-skill/after/report.json +0 -4103
  389. package/.taste-skill/after/tablet-fold.jpg +0 -0
  390. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  391. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  392. package/.taste-skill/before/desktop-fold.jpg +0 -0
  393. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  394. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  395. package/.taste-skill/before/mobile-fold.jpg +0 -0
  396. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  397. package/.taste-skill/before/report.json +0 -2556
  398. package/.taste-skill/before/tablet-fold.jpg +0 -0
  399. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  400. package/.taste-skill/direction.json +0 -510
  401. package/.taste-skill/notes.md +0 -84
  402. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  403. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  404. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  405. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  406. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  407. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  408. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  409. package/.taste-skill/prod/report.json +0 -1973
  410. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  411. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  412. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  413. package/AUDIT.md +0 -228
  414. package/PLAN-AMELIORATION.md +0 -220
  415. package/ai/AGENTS.md +0 -56
  416. package/ai/cursor/rules/concorde-menu.mdc +0 -15
  417. package/ai/cursor/rules/concorde-scope.mdc +0 -14
  418. package/ai/cursor/rules/concorde-theme.mdc +0 -13
  419. package/ai/cursor/rules/concorde.mdc +0 -66
  420. package/ai/jetbrains/rules/concorde.md +0 -53
  421. package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
  422. package/ai/skills/concorde-imports/SKILL.md +0 -78
  423. package/ai/skills/concorde-menu/SKILL.md +0 -74
  424. package/ai/skills/concorde-scope/SKILL.md +0 -70
  425. package/ai/skills/concorde-theme/SKILL.md +0 -57
  426. package/docs/assets/index-Bb-_LRyY.js +0 -12280
  427. package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
  428. package/src/docs/example/docs-joke-demos.ts +0 -297
  429. /package/{src → docs/src}/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -0
  430. /package/{src → docs/src}/docs/_core-concept/dataFlow.md +0 -0
  431. /package/{src → docs/src}/docs/_core-concept/overview.md +0 -0
  432. /package/{src → docs/src}/docs/_decorators/ancestor-attribute.md +0 -0
  433. /package/{src → docs/src}/docs/_decorators/auto-subscribe.md +0 -0
  434. /package/{src → docs/src}/docs/_decorators/bind.md +0 -0
  435. /package/{src → docs/src}/docs/_decorators/get.md +0 -0
  436. /package/{src → docs/src}/docs/_decorators/handle.md +0 -0
  437. /package/{src → docs/src}/docs/_decorators/on-assign.md +0 -0
  438. /package/{src → docs/src}/docs/_decorators/patch.md +0 -0
  439. /package/{src → docs/src}/docs/_decorators/post.md +0 -0
  440. /package/{src → docs/src}/docs/_decorators/publish.md +0 -0
  441. /package/{src → docs/src}/docs/_decorators/put.md +0 -0
  442. /package/{src → docs/src}/docs/_decorators/subscribe.md +0 -0
  443. /package/{src → docs/src}/docs/_decorators/wait-for-ancestors.md +0 -0
  444. /package/{src → docs/src}/docs/_directives/sub.md +0 -0
  445. /package/{src → docs/src}/docs/_getting-started/ai-agents.md +0 -0
  446. /package/{src → docs/src}/docs/_getting-started/concorde-manual-install.md +0 -0
  447. /package/{src → docs/src}/docs/_getting-started/concorde-outside.md +0 -0
  448. /package/{src → docs/src}/docs/_getting-started/create-a-component.md +0 -0
  449. /package/{src → docs/src}/docs/_getting-started/my-first-component.md +0 -0
  450. /package/{src → docs/src}/docs/_getting-started/start.md +0 -0
  451. /package/{src → docs/src}/docs/_misc/api-configuration.md +0 -0
  452. /package/{src → docs/src}/docs/_misc/dataProviderKey.md +0 -0
  453. /package/{src → docs/src}/docs/_misc/docs-mock-api.md +0 -0
  454. /package/{src → docs/src}/docs/_misc/dynamic-path.md +0 -0
  455. /package/{src → docs/src}/docs/_misc/endpoint.md +0 -0
  456. /package/{src → docs/src}/docs/_misc/formelement-subscriber-removal.md +0 -0
  457. /package/{src → docs/src}/docs/_misc/html-integration.md +0 -0
  458. /package/src/docs/{_getting-started → getting-started}/components.md +0 -0
  459. /package/src/docs/{_getting-started → getting-started}/theming.md +0 -0
package/docs/crawl/docs/_decorators/auto-subscribe.html ADDED
@@ -0,0 +1,202 @@
1
+ <!DOCTYPE html>
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html" data-doc-id="docs/_decorators/auto-subscribe">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>@autoSubscribe — Concorde</title>
7
+ <meta name="description" content="&gt; Legacy: prefer @subscribe + DataProviderKey. Examples below may still show PublisherManager for existing codebases.">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/_decorators/auto-subscribe, auto-subscribe, @autoSubscribe, decorator, autoSubscribe, DataProviderKey, PublisherManager, ;
9
+ }
10
+
11
+ render() {
12
+ return html">
13
+ <meta name="concorde-doc-id" content="docs/_decorators/auto-subscribe">
14
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html">
15
+ </head>
16
+ <body>
17
+ <header>
18
+ <p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_decorators/auto-subscribe.md/auto-subscribe" rel="nofollow">interactive version</a></p>
19
+ </header>
20
+ <main>
21
+ <article>
22
+ <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @autoSubscribe</strong>. &gt; Legacy: prefer @subscribe + DataProviderKey. Examples below may still show PublisherManager for existing codebases. <span>Doc ID: <code>docs/_decorators/auto-subscribe</code>. Keywords: Concorde, supersoniks, docs/_decorators/auto-subscribe, auto-subscribe, @autoSubscribe, decorator, autoSubscribe, DataProviderKey, PublisherManager, ;
23
+ }
24
+
25
+ render() {
26
+ return html. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html">https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html</a>.</span></p>
27
+ <h1 id="autosubscribe">@autoSubscribe</h1>
28
+ <blockquote>
29
+ <p><strong>Legacy:</strong> prefer <a href="./subscribe.html#subscribe">@subscribe</a> + <code>DataProviderKey</code>. Examples below may still show <code>PublisherManager</code> for existing codebases.</p>
30
+ </blockquote>
31
+ <p>The <code>@autoSubscribe</code> decorator automatically detects which publishers are accessed within a method and subscribes to them. When any of these publishers change, the method is automatically re-executed.</p>
32
+ <h2 id="principle">Principle</h2>
33
+ <p>This decorator wraps a method to track which publishers are accessed during its execution. It then subscribes to all accessed publishers, and when any of them change, the method is re-executed. This provides automatic reactivity without manually managing subscriptions.</p>
34
+ <h2 id="usage">Usage</h2>
35
+ <h3 id="import">Import</h3>
36
+ <pre><code class="language-typescript">import { autoSubscribe } from &quot;@supersoniks/concorde/decorators&quot;;
37
+ </code></pre>
38
+ <h3 id="basic-example">Basic example</h3>
39
+ <pre><code class="language-typescript">@customElement(&quot;demo-auto-subscribe&quot;)
40
+ export class DemoAutoSubscribe extends LitElement {
41
+ static styles = [tailwind];
42
+
43
+ @state() displayText: string = &quot;&quot;;
44
+ @state() computedValue: number = 0;
45
+
46
+ @autoSubscribe()
47
+ updateDisplay() {
48
+ const value1 = PublisherManager.get(&quot;autoValue1&quot;).get() || 0;
49
+ const value2 = PublisherManager.get(&quot;autoValue2&quot;).get() || 0;
50
+ this.computedValue = value1 + value2;
51
+ this.displayText = `${value1} + ${value2} = ${this.computedValue}`;
52
+ }
53
+
54
+ render() {
55
+ return html`
56
+ &lt;p&gt;&lt;strong&gt;${this.displayText}&lt;/strong&gt;&lt;/p&gt;
57
+ &lt;div&gt;
58
+ &lt;sonic-button @click=${() =&gt; this.randomizeValue(&quot;autoValue1&quot;)}&gt;
59
+ Randomize Value 1
60
+ &lt;/sonic-button&gt;
61
+ &lt;sonic-button @click=${() =&gt; this.randomizeValue(&quot;autoValue2&quot;)}&gt;
62
+ Randomize Value 2
63
+ &lt;/sonic-button&gt;
64
+ &lt;/div&gt;
65
+ `;
66
+ }
67
+
68
+ randomizeValue(publisherId: string) {
69
+ const value = PublisherManager.get(publisherId);
70
+ value.set(Math.floor(Math.random() * 100));
71
+ }
72
+ }
73
+ </code></pre>
74
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-auto-subscribe&quot;&gt;&lt;/docs-demo-sources&gt;
75
+ &lt;demo-auto-subscribe&gt;&lt;/demo-auto-subscribe&gt;
76
+ </code></pre>
77
+ <h3 id="example-with-render-method">Example with render method</h3>
78
+ <pre><code class="language-typescript">@customElement(&quot;reactive-view&quot;)
79
+ export class ReactiveView extends LitElement {
80
+ @autoSubscribe()
81
+ render() {
82
+ const data = PublisherManager.get(&quot;myData&quot;);
83
+ const config = PublisherManager.get(&quot;config&quot;);
84
+
85
+ // This render method will be automatically re-executed
86
+ // when myData or config change
87
+ const value = data.get()?.value || 0;
88
+ const multiplier = config.get()?.multiplier || 1;
89
+
90
+ return html`
91
+ &lt;div&gt;
92
+ &lt;h1&gt;Result: ${value * multiplier}&lt;/h1&gt;
93
+ &lt;p&gt;Value: ${value}&lt;/p&gt;
94
+ &lt;p&gt;Multiplier: ${multiplier}&lt;/p&gt;
95
+ &lt;/div&gt;
96
+ `;
97
+ }
98
+ }
99
+ </code></pre>
100
+ <h2 id="how-it-works">How it works</h2>
101
+ <ol>
102
+ <li><strong>First execution</strong>: When the method is called, <code>PublisherManager.collectModifiedPublisher()</code> is used to track which publishers are accessed</li>
103
+ <li><strong>Subscription</strong>: After execution, the decorator subscribes to all detected publishers</li>
104
+ <li><strong>Re-execution</strong>: When any subscribed publisher changes, the method is automatically called again</li>
105
+ <li><strong>Cleanup</strong>: On <code>disconnectedCallback</code>, all subscriptions are automatically removed</li>
106
+ </ol>
107
+ <h2 id="behavior">Behavior</h2>
108
+ <ul>
109
+ <li>The method is automatically called on <code>connectedCallback</code></li>
110
+ <li>The method is re-executed whenever any accessed publisher changes</li>
111
+ <li>Subscriptions are managed automatically (no manual cleanup needed)</li>
112
+ <li>Only publishers accessed during method execution are subscribed to</li>
113
+ <li>The decorator uses <code>queueMicrotask</code> to batch multiple updates and avoid unnecessary re-renders</li>
114
+ </ul>
115
+ <h2 id="use-cases">Use cases</h2>
116
+ <p>This decorator is particularly useful for:</p>
117
+ <ul>
118
+ <li><strong>Reactive rendering</strong> where the render method depends on multiple publishers</li>
119
+ <li><strong>Data transformation</strong> that needs to update when source data changes</li>
120
+ <li><strong>Computed properties</strong> that depend on multiple data sources</li>
121
+ <li><strong>Automatic synchronization</strong> between publishers and component state</li>
122
+ </ul>
123
+ <h2 id="complete-example">Complete example</h2>
124
+ <pre><code class="language-typescript">import { html, LitElement } from &quot;lit&quot;;
125
+ import { customElement } from &quot;lit/decorators.js&quot;;
126
+ import { autoSubscribe } from &quot;@supersoniks/concorde/decorators&quot;;
127
+ import { PublisherManager } from &quot;@supersoniks/concorde/core/utils/PublisherProxy&quot;;
128
+
129
+ @customElement(&quot;shopping-cart&quot;)
130
+ export class ShoppingCart extends LitElement {
131
+ items: any[] = [];
132
+ total: number = 0;
133
+ discount: number = 0;
134
+
135
+ @autoSubscribe()
136
+ calculateTotal() {
137
+ const cart = PublisherManager.get(&quot;cart&quot;);
138
+ const promo = PublisherManager.get(&quot;promo&quot;);
139
+
140
+ // Access cart items
141
+ this.items = cart.items.get() || [];
142
+
143
+ // Access promo code
144
+ const promoCode = promo.code.get() || &quot;&quot;;
145
+ const discountPercent = promoCode === &quot;SAVE10&quot; ? 0.1 : 0;
146
+
147
+ // Calculate totals
148
+ const subtotal = this.items.reduce((sum, item) =&gt;
149
+ sum + (item.price * item.quantity), 0
150
+ );
151
+ this.discount = subtotal * discountPercent;
152
+ this.total = subtotal - this.discount;
153
+
154
+ this.requestUpdate();
155
+ }
156
+
157
+ connectedCallback() {
158
+ super.connectedCallback();
159
+ this.calculateTotal();
160
+ }
161
+
162
+ render() {
163
+ return html`
164
+ &lt;div class=&quot;cart&quot;&gt;
165
+ &lt;h2&gt;Shopping Cart&lt;/h2&gt;
166
+ ${this.items.map(item =&gt; html`
167
+ &lt;div&gt;${item.name} x${item.quantity} - ${item.price}€&lt;/div&gt;
168
+ `)}
169
+ &lt;div class=&quot;total&quot;&gt;
170
+ &lt;p&gt;Subtotal: ${this.total + this.discount}€&lt;/p&gt;
171
+ &lt;p&gt;Discount: -${this.discount}€&lt;/p&gt;
172
+ &lt;p&gt;&lt;strong&gt;Total: ${this.total}€&lt;/strong&gt;&lt;/p&gt;
173
+ &lt;/div&gt;
174
+ &lt;/div&gt;
175
+ `;
176
+ }
177
+ }
178
+
179
+ // When you update the publishers, calculateTotal is automatically called:
180
+ const cart = PublisherManager.get(&quot;cart&quot;);
181
+ cart.items.set([
182
+ { name: &quot;Product 1&quot;, price: 10, quantity: 2 },
183
+ { name: &quot;Product 2&quot;, price: 15, quantity: 1 }
184
+ ]);
185
+
186
+ const promo = PublisherManager.get(&quot;promo&quot;);
187
+ promo.code.set(&quot;SAVE10&quot;);
188
+ // calculateTotal will be automatically called and the UI will update
189
+ </code></pre>
190
+ <h2 id="notes">Notes</h2>
191
+ <ul>
192
+ <li>This decorator works with any component that has <code>connectedCallback</code> and <code>disconnectedCallback</code> methods (such as <code>LitElement</code> or components extending <code>Subscriber</code>)</li>
193
+ <li>The method is called automatically on <code>connectedCallback</code></li>
194
+ <li>Remember to call <code>this.requestUpdate()</code> if you&#39;re updating component properties</li>
195
+ <li>The decorator uses debouncing via <code>queueMicrotask</code> to prevent excessive re-executions</li>
196
+ <li>For more information about publishers, see the documentation on <a href="../_getting-started/pubsub.html#pubsub">Sharing data</a></li>
197
+ </ul>
198
+
199
+ </article>
200
+ </main>
201
+ </body>
202
+ </html>
package/docs/crawl/docs/_decorators/bind.html ADDED
@@ -0,0 +1,141 @@
1
+ <!DOCTYPE html>
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html" data-doc-id="docs/_decorators/bind">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>@bind — Concorde</title>
7
+ <meta name="description" content="Binds a class property to a path in a publisher. The property updates when publisher data changes.">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/_decorators/bind, bind, @bind, decorator, @state(), DataProviderKey, . Use , reflect: true, publisher.set(...)">
9
+ <meta name="concorde-doc-id" content="docs/_decorators/bind">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html">
11
+ </head>
12
+ <body>
13
+ <header>
14
+ <p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_decorators/bind.md/bind" rel="nofollow">interactive version</a></p>
15
+ </header>
16
+ <main>
17
+ <article>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @bind</strong>. Binds a class property to a path in a publisher. The property updates when publisher data changes. <span>Doc ID: <code>docs/_decorators/bind</code>. Keywords: Concorde, supersoniks, docs/_decorators/bind, bind, @bind, decorator, @state(), DataProviderKey, . Use , reflect: true, publisher.set(...). URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html">https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html</a>.</span></p>
19
+ <h1 id="bind">@bind</h1>
20
+ <p>Binds a class property to a path in a publisher. The property updates when publisher data changes.</p>
21
+ <p>For Lit re-renders, also add <code>@state()</code> on the same property.</p>
22
+ <p><strong>See also:</strong> <a href="./subscribe.html#subscribe">@subscribe</a>, <a href="./handle.html#handle">@handle</a>, <a href="./publish.html#publish">@publish</a>, <a href="./get.html#get">@get</a>, <a href="./post.html#post">@post</a>, <a href="./put.html#put">@put</a>, <a href="./patch.html#patch">@patch</a>.</p>
23
+ <h2 id="principle">Principle</h2>
24
+ <p>The decorator subscribes to the DataProvider store using dot notation or a <code>DataProviderKey</code>. Updates flow into the decorated property (<a href="../_core-concept/dataFlow.html#dataFlow">Data flow</a>).</p>
25
+ <h2 id="import">Import</h2>
26
+ <pre><code class="language-typescript">import { bind } from &quot;@supersoniks/concorde/decorators&quot;;
27
+ </code></pre>
28
+ <h2 id="example">Example</h2>
29
+ <pre><code class="language-typescript">@customElement(&quot;demo-bind&quot;)
30
+ export class DemoBind extends LitElement {
31
+ static styles = [tailwind];
32
+
33
+ @bind(&quot;demoData.firstName&quot;)
34
+ @state()
35
+ firstName = &quot;&quot;;
36
+
37
+ @bind(&quot;demoData.lastName&quot;)
38
+ @state()
39
+ lastName: string = &quot;&quot;;
40
+
41
+ @bind(&quot;demoData.count&quot;)
42
+ @state()
43
+ count: number = 0;
44
+
45
+ render() {
46
+ return //......
47
+ }
48
+
49
+ updateData() {
50
+ set(demoDataKey, { ...get(demoDataKey), count: get(demoDataKey).count + 1 });
51
+ // see demo-bind in src/docs/example/decorators-demo-bind-demos.ts
52
+ const randomIndex = Math.floor(Math.random() * demoUsers.get().length);
53
+ const randomUser = demoUsers.get()[randomIndex];
54
+ demoData.set({
55
+ firstName: randomUser.firstName,
56
+ lastName: randomUser.lastName,
57
+ count: (demoData.count.get() || 0) + 1,
58
+ });
59
+ }
60
+ }
61
+ </code></pre>
62
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-bind&quot;&gt;&lt;/docs-demo-sources&gt;
63
+ &lt;demo-bind&gt;&lt;/demo-bind&gt;
64
+ </code></pre>
65
+ <h2 id="dataproviderkey-strict-typing"><code>DataProviderKey</code> (strict typing)</h2>
66
+ <p><code>@bind</code> accepts either a string path (legacy) or a <code>DataProviderKey&lt;T&gt;</code>. The property type must match <code>T</code>. Use <code>reflect: true</code> to push local writes back to the publisher (see below). See <a href="../_misc/dataProviderKey.html#dataProviderKey">DataProviderKey</a>.</p>
67
+ <pre><code class="language-typescript">import { bind } from &quot;@supersoniks/concorde/decorators&quot;;
68
+ import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
69
+
70
+ type Data = { count: number };
71
+ const dataKey = new DataProviderKey&lt;Data&gt;(&quot;data&quot;);
72
+
73
+ @bind(dataKey.count, { reflect: true })
74
+ @state()
75
+ count: number = 0;
76
+ </code></pre>
77
+ <h2 id="reflect-reflect-true">Reflect (<code>reflect: true</code>)</h2>
78
+ <p>Two-way sync: reads from the publisher and local assignments call <code>publisher.set(...)</code>. An internal guard avoids infinite loops.</p>
79
+ <pre><code class="language-typescript">@bind(&quot;userData.profile.avatarUrl&quot;, { reflect: true })
80
+ @state()
81
+ avatar: string;
82
+ </code></pre>
83
+ <pre><code class="language-typescript">@customElement(&quot;demo-bind-reflect&quot;)
84
+ export class DemoBindReflect extends LitElement {
85
+ static styles = [tailwind];
86
+
87
+ @bind(&quot;bindReflectDemo.count&quot;, { reflect: true })
88
+ @state()
89
+ withReflect: number = 0;
90
+
91
+ @bind(&quot;bindReflectDemo.count&quot;)
92
+ @state()
93
+ withoutReflect: number = 0;
94
+
95
+ render() {
96
+ return html`
97
+ &lt;div class=&quot;mb-3&quot;&gt;
98
+ from publisher : ${sub(&quot;bindReflectDemo.count&quot;) || 0} &lt;br /&gt;
99
+ from component with reflect : ${this.withReflect || 0} &lt;br /&gt;
100
+ from component without reflect : ${this.withoutReflect || 0}
101
+ &lt;/div&gt;
102
+ &lt;sonic-button @click=${() =&gt; this.withReflect++}
103
+ &gt;Increment with reflect&lt;/sonic-button
104
+ &gt;
105
+ &lt;sonic-button @click=${() =&gt; this.withoutReflect++}
106
+ &gt;Increment without reflect&lt;/sonic-button
107
+ &gt;
108
+ `;
109
+ }
110
+ }
111
+ </code></pre>
112
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-bind-reflect&quot;&gt;&lt;/docs-demo-sources&gt;
113
+ &lt;demo-bind-reflect&gt;&lt;/demo-bind-reflect&gt;
114
+ </code></pre>
115
+ <h2 id="path-syntax">Path syntax</h2>
116
+ <ul>
117
+ <li>First segment: data provider id.</li>
118
+ <li>Nested properties: dot notation.</li>
119
+ <li>Arrays: numeric index (<code>items.0</code>).</li>
120
+ </ul>
121
+ <h3 id="dynamic-paths">Dynamic paths</h3>
122
+ <p>Use <code>${prop}</code> or <code>${this.prop}</code> inside a <strong>normal string literal</strong> (not a JS template literal with backticks). <code>@bind</code> re-subscribes when a reactive dependency changes. While a placeholder is <code>null</code>/<code>undefined</code>, the bind is inactive; optional <code>{ skipEmptyPlaceholder: true }</code> also waits on <code>&quot;&quot;</code>. See <a href="../_misc/dynamic-path.html#dynamic-path">Dynamic path placeholders</a>.</p>
123
+ <blockquote>
124
+ <p>Properties referenced in the pattern must be reactive (<code>@property</code>, etc.) or you must call <code>requestUpdate</code> manually.</p>
125
+ </blockquote>
126
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-bind-dynamic&quot;&gt;&lt;/docs-demo-sources&gt;
127
+ &lt;demo-bind-dynamic&gt;&lt;/demo-bind-dynamic&gt;
128
+ </code></pre>
129
+ <h2 id="behavior">Behavior</h2>
130
+ <ul>
131
+ <li>Subscribes at <code>connectedCallback</code>, unsubscribes at <code>disconnectedCallback</code>.</li>
132
+ <li>If the path does not exist yet, a publisher may be created with <code>null</code>.</li>
133
+ </ul>
134
+ <h2 id="notes">Notes</h2>
135
+ <p>Works with any component that has the usual DOM lifecycle (<code>LitElement</code>, <code>Subscriber</code> mixin, etc.).</p>
136
+ <p>Shared data: <a href="../_getting-started/pubsub.html#pubsub">Sharing data</a>.</p>
137
+
138
+ </article>
139
+ </main>
140
+ </body>
141
+ </html>
package/docs/crawl/docs/_decorators/get.html ADDED
@@ -0,0 +1,149 @@
1
+ <!DOCTYPE html>
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_decorators/get.html" data-doc-id="docs/_decorators/get">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>@get — Concorde</title>
7
+ <meta name="description" content="@get loads data and stores the result in an optional ApiResult&lt;T&gt; property.">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/_decorators/get, get, @get, decorator, ApiResult, undefined, payload.result, payload.response, payload.request,
9
+
10
+ The first argument is always an
11
+ [, serviceURL, refetch(component)">
12
+ <meta name="concorde-doc-id" content="docs/_decorators/get">
13
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_decorators/get.html">
14
+ </head>
15
+ <body>
16
+ <header>
17
+ <p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_decorators/get.md/get" rel="nofollow">interactive version</a></p>
18
+ </header>
19
+ <main>
20
+ <article>
21
+ <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @get</strong>. @get loads data and stores the result in an optional ApiResult&lt;T&gt; property. <span>Doc ID: <code>docs/_decorators/get</code>. Keywords: Concorde, supersoniks, docs/_decorators/get, get, @get, decorator, ApiResult, undefined, payload.result, payload.response, payload.request,
22
+
23
+ The first argument is always an
24
+ [, serviceURL, refetch(component). URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/get.html">https://concorde.supersoniks.org/crawl/docs/_decorators/get.html</a>.</span></p>
25
+ <h1 id="get">@get</h1>
26
+ <p><code>@get</code> loads data and stores the result in an optional <code>ApiResult&lt;T&gt;</code> property.
27
+ The property is <code>undefined</code> until a result is available.</p>
28
+ <ul>
29
+ <li><code>payload.result</code>: typed data;</li>
30
+ <li><code>payload.response</code>: the HTTP response;</li>
31
+ <li><code>payload.request</code>: the request that was sent.</li>
32
+ </ul>
33
+ <h2 id="minimal-usage">Minimal usage</h2>
34
+ <pre><code class="language-typescript">const usersEndpoint = new Endpoint&lt;User[]&gt;(&quot;users&quot;);
35
+
36
+ @get(usersEndpoint)
37
+ @state()
38
+ payload?: ApiResult&lt;User[]&gt;;
39
+ </code></pre>
40
+ <p>The same decorator adapts to a method. The method receives the complete
41
+ <code>ApiResult&lt;T&gt;</code> payload after each GET:</p>
42
+ <pre><code class="language-typescript">@get(usersEndpoint)
43
+ handleUsers(payload?: ApiResult&lt;User[]&gt;) {
44
+ if (!payload) return;
45
+
46
+ console.log(payload.response?.status);
47
+ console.log(payload.result);
48
+ }
49
+ </code></pre>
50
+ <p>The first argument is always an
51
+ <a href="../_misc/endpoint.html#endpoint"><code>Endpoint&lt;T&gt;</code></a>. API configuration is read
52
+ from the HTML scope (<code>serviceURL</code>, token, etc.), so the component is usually
53
+ placed below an element that provides this configuration.</p>
54
+ <h2 id="refetching-a-get">Refetching a GET</h2>
55
+ <h3 id="from-the-component">From the component</h3>
56
+ <p>Keep the decorator in a constant to access <code>refetch(component)</code>. Refetch only
57
+ targets the instance passed as the argument, even before it has received a
58
+ result.</p>
59
+ <pre><code class="language-typescript">const usersGet = get(new Endpoint&lt;User[]&gt;(&quot;users&quot;));
60
+
61
+ @usersGet
62
+ @state()
63
+ payload?: ApiResult&lt;User[]&gt;;
64
+
65
+ async refresh() {
66
+ const payload = await usersGet.refetch(this);
67
+ console.log(payload?.result);
68
+ }
69
+ </code></pre>
70
+ <p><code>refetch(component)</code> returns a <code>Promise&lt;ApiResult&lt;T&gt; | undefined&gt;</code> that resolves
71
+ after the GET has completed.</p>
72
+ <p>The named handle can also decorate a method and be reused for refetching:</p>
73
+ <pre><code class="language-typescript">const usersGet = get(new Endpoint&lt;User[]&gt;(&quot;users&quot;));
74
+
75
+ @usersGet
76
+ handleUsers(payload?: ApiResult&lt;User[]&gt;) {
77
+ // ...
78
+ }
79
+
80
+ @refetch(usersGet)
81
+ reloadUsers() {
82
+ // The GET runs and handleUsers receives its payload.
83
+ }
84
+ </code></pre>
85
+ <h3 id="from-a-method-decorator">From a method decorator</h3>
86
+ <p>The refetch can decorate a local method. The default is <code>after</code>; if the
87
+ method returns a Promise, the GET waits for its resolution. The decorated method
88
+ call also waits for the refetch to complete.</p>
89
+ <pre><code class="language-typescript">import { refetch } from &quot;@supersoniks/concorde/decorators&quot;;
90
+
91
+ @refetch(usersGet)
92
+ async reload() {
93
+ this.userId = &quot;42&quot;;
94
+ }
95
+ </code></pre>
96
+ <p>Use <code>{ when: &quot;before&quot; }</code> when the GET must complete before the method runs:</p>
97
+ <pre><code class="language-typescript">@refetch(usersGet, { when: &quot;before&quot; })
98
+ reloadBefore() {
99
+ // The refetch has completed before this method runs.
100
+ }
101
+ </code></pre>
102
+ <p>The method decorator adds an explicit trigger; changes to dynamic endpoint
103
+ properties and configuration publishers keep their existing automatic behavior.</p>
104
+ <h2 id="options-getoptions">Options (<code>GetOptions</code>)</h2>
105
+ <p>Options are the second argument, or the third argument when an API
106
+ configuration key is provided.</p>
107
+ <ul>
108
+ <li><code>skipEmptyPlaceholder</code>: blocks the GET when <code>${prop}</code> is <code>&quot;&quot;</code>.</li>
109
+ <li><code>refetchEveryMs</code>: automatically runs the GET again after this interval
110
+ (milliseconds). Omit the option, or use <code>0</code>, to disable polling.</li>
111
+ <li><code>triggerKey</code>: a publisher whose <code>invalidate()</code> runs the GET again.</li>
112
+ </ul>
113
+ <p>With a configuration key, use:</p>
114
+ <pre><code class="language-typescript">@get(usersEndpoint, apiConfigurationKey)
115
+ </code></pre>
116
+ <h2 id="when-the-get-runs-again">When the GET runs again</h2>
117
+ <ul>
118
+ <li>when the component connects and configuration is available;</li>
119
+ <li>when a property used in <code>${...}</code> changes;</li>
120
+ <li>when a configuration publisher changes;</li>
121
+ <li>when the <code>triggerKey</code> publisher is invalidated;</li>
122
+ <li>after each response when <code>refetchEveryMs</code> is set.</li>
123
+ </ul>
124
+ <p>See <a href="../_misc/dynamic-path.html#dynamic-path">Dynamic path placeholders</a> for
125
+ dynamic path details.</p>
126
+ <h2 id="import">Import</h2>
127
+ <pre><code class="language-typescript">import { get, type ApiResult } from &quot;@supersoniks/concorde/decorators&quot;;
128
+ import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
129
+ import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
130
+ </code></pre>
131
+ <h2 id="demos">Demos</h2>
132
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-api-get&quot;&gt;&lt;/docs-demo-sources&gt;
133
+ &lt;demo-api-get&gt;&lt;/demo-api-get&gt;
134
+ &lt;docs-demo-sources for=&quot;demo-api-get-method&quot;&gt;&lt;/docs-demo-sources&gt;
135
+ &lt;demo-api-get-method&gt;&lt;/demo-api-get-method&gt;
136
+ &lt;docs-demo-sources for=&quot;demo-api-get-configuration-key&quot;&gt;&lt;/docs-demo-sources&gt;
137
+ &lt;demo-api-get-configuration-key&gt;&lt;/demo-api-get-configuration-key&gt;
138
+ </code></pre>
139
+ <p>See <a href="./post.html#post">@post</a>,
140
+ <a href="./put.html#put">@put</a>, and
141
+ <a href="./patch.html#patch">@patch</a> for write operations.</p>
142
+ <h2 id="advanced">Advanced</h2>
143
+ <p>External invalidation is currently available through <code>triggerKey</code>; it is kept
144
+ out of the main usage examples.</p>
145
+
146
+ </article>
147
+ </main>
148
+ </body>
149
+ </html>