@supersoniks/concorde 5.0.0 → 5.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (314) hide show
  1. package/.gitlab-ci.yml +0 -13
  2. package/build-infos.json +1 -1
  3. package/concorde-core.bundle.js +606 -689
  4. package/concorde-core.es.js +4511 -4329
  5. package/dist/concorde-core.bundle.js +606 -689
  6. package/dist/concorde-core.es.js +4511 -4329
  7. package/gitlab/job_tests.sh +25 -12
  8. package/index.html +3 -3
  9. package/package.json +16 -1
  10. package/scripts/post-build-docs.js +0 -0
  11. package/scripts/post-build.mjs +0 -0
  12. package/src/core/components/functional/fetch/fetch.md +0 -0
  13. package/src/core/components/functional/if/if.md +0 -0
  14. package/src/core/components/functional/list/list.demo.ts +0 -0
  15. package/src/core/components/functional/list/list.md +0 -0
  16. package/src/core/components/functional/list/list.ts +0 -0
  17. package/src/core/components/functional/router/router.md +0 -0
  18. package/src/core/components/functional/router/router.ts +0 -0
  19. package/src/core/components/functional/sdui/sdui.md +0 -0
  20. package/src/core/components/functional/states/states.md +0 -0
  21. package/src/core/components/functional/submit/submit.md +0 -0
  22. package/src/core/components/ui/_css/rounded.ts +36 -0
  23. package/src/core/components/ui/_css/size.ts +0 -0
  24. package/src/core/components/ui/_css/type.ts +49 -0
  25. package/src/core/components/ui/_i18n/ui-aria-labels.ts +104 -0
  26. package/src/core/components/ui/alert/alert.md +128 -72
  27. package/src/core/components/ui/alert/alert.spec.ts +145 -0
  28. package/src/core/components/ui/alert/alert.ts +86 -91
  29. package/src/core/components/ui/alert-messages/alert-messages.ts +1 -1
  30. package/src/core/components/ui/badge/badge.md +126 -78
  31. package/src/core/components/ui/badge/badge.ts +29 -81
  32. package/src/core/components/ui/button/button.md +1 -0
  33. package/src/core/components/ui/button/button.ts +11 -8
  34. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  35. package/src/core/components/ui/captcha/captcha.md +0 -0
  36. package/src/core/components/ui/card/card-header.ts +7 -2
  37. package/src/core/components/ui/card/card.md +120 -65
  38. package/src/core/components/ui/divider/divider.ts +4 -9
  39. package/src/core/components/ui/form/fieldset/legend-description.ts +1 -1
  40. package/src/core/components/ui/form/fieldset/legend.ts +1 -1
  41. package/src/core/components/ui/form/input/input.md +1 -1
  42. package/src/core/components/ui/form/input/input.ts +19 -15
  43. package/src/core/components/ui/form/radio/radio.md +0 -0
  44. package/src/core/components/ui/form/select/select.md +0 -0
  45. package/src/core/components/ui/form/switch/switch.md +0 -0
  46. package/src/core/components/ui/form/textarea/textarea.md +1 -1
  47. package/src/core/components/ui/image/image.md +147 -53
  48. package/src/core/components/ui/image/image.ts +10 -44
  49. package/src/core/components/ui/link/link.md +2 -2
  50. package/src/core/components/ui/link/link.ts +42 -37
  51. package/src/core/components/ui/loader/loader.md +0 -0
  52. package/src/core/components/ui/menu/menu.md +0 -0
  53. package/src/core/components/ui/modal/modal-close.ts +8 -12
  54. package/src/core/components/ui/modal/modal.md +0 -0
  55. package/src/core/components/ui/modal/modal.ts +18 -18
  56. package/src/core/components/ui/pop/pop.md +105 -1
  57. package/src/core/components/ui/pop/pop.ts +143 -148
  58. package/src/core/components/ui/table/table-caption.ts +0 -0
  59. package/src/core/components/ui/table/table.md +0 -0
  60. package/src/core/components/ui/table/table.ts +2 -8
  61. package/src/core/components/ui/theme/theme.ts +1 -1
  62. package/src/core/components/ui/toast/dismissed.ts +14 -0
  63. package/src/core/components/ui/toast/toast-item.ts +139 -91
  64. package/src/core/components/ui/toast/toast.ts +4 -7
  65. package/src/core/components/ui/tooltip/tooltip.ts +176 -154
  66. package/src/core/utils/LocationHandler.ts +12 -5
  67. package/src/core/utils/dismissed.ts +22 -0
  68. package/src/core/utils/positioning.spec.ts +208 -0
  69. package/src/core/utils/positioning.ts +183 -0
  70. package/src/core/utils/route.ts +0 -0
  71. package/src/directives.ts +2 -3
  72. package/src/docs/_core-concept/subscriber.md +0 -0
  73. package/src/docs/_getting-started/concorde-outside.md +3 -3
  74. package/src/docs/_getting-started/my-first-subscriber.md +0 -0
  75. package/src/docs/_getting-started/pubsub.md +0 -0
  76. package/src/docs/_getting-started/start.md +0 -0
  77. package/src/docs/code.ts +3 -1
  78. package/src/docs/example/users.ts +0 -0
  79. package/src/docs/search/docs-search.json +651 -21
  80. package/src/docs/search/page.ts +0 -0
  81. package/src/docs/tailwind/css/tailwind.css +13 -6
  82. package/src/tsconfig.json +45 -0
  83. package/src/tsconfig.tsbuildinfo +1 -1
  84. package/tailwind.config.js +50 -3
  85. package/vitest.setup.ts +49 -13
  86. package/.github/workflows/ci.yml +0 -21
  87. package/.github-export-ignore +0 -30
  88. package/CONTRIBUTING.md +0 -59
  89. package/DEV.md +0 -54
  90. package/LICENSE +0 -21
  91. package/OPEN_SOURCE_CHECKPOINT.md +0 -133
  92. package/concorde-3d.bundle.js +0 -3960
  93. package/concorde-3d.es.js +0 -33433
  94. package/concorde-hugging-face-infer.bundle.js +0 -32
  95. package/concorde-hugging-face-infer.es.js +0 -2952
  96. package/concorde-shader.bundle.js +0 -116
  97. package/concorde-shader.es.js +0 -8353
  98. package/concorde-webgpu.bundle.js +0 -307
  99. package/concorde-webgpu.es.js +0 -8627
  100. package/docs/altcha-widget.js +0 -2662
  101. package/docs/assets/index-BZiZXMU-.css +0 -1
  102. package/docs/assets/index-FmK4JaIM.js +0 -11992
  103. package/docs/crawl/core/components/functional/date/date.html +0 -190
  104. package/docs/crawl/core/components/functional/fetch/fetch.html +0 -109
  105. package/docs/crawl/core/components/functional/if/if.html +0 -27
  106. package/docs/crawl/core/components/functional/jsonata/jsonata.html +0 -79
  107. package/docs/crawl/core/components/functional/list/list.html +0 -70
  108. package/docs/crawl/core/components/functional/mix/mix.html +0 -45
  109. package/docs/crawl/core/components/functional/queue/queue.html +0 -96
  110. package/docs/crawl/core/components/functional/router/router.html +0 -106
  111. package/docs/crawl/core/components/functional/sdui/sdui.html +0 -269
  112. package/docs/crawl/core/components/functional/states/states.html +0 -66
  113. package/docs/crawl/core/components/functional/submit/submit.html +0 -160
  114. package/docs/crawl/core/components/functional/subscriber/subscriber.html +0 -67
  115. package/docs/crawl/core/components/functional/value/value.html +0 -51
  116. package/docs/crawl/core/components/ui/alert/alert.html +0 -110
  117. package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +0 -23
  118. package/docs/crawl/core/components/ui/badge/badge.html +0 -119
  119. package/docs/crawl/core/components/ui/button/button.html +0 -149
  120. package/docs/crawl/core/components/ui/captcha/captcha.html +0 -30
  121. package/docs/crawl/core/components/ui/card/card.html +0 -99
  122. package/docs/crawl/core/components/ui/divider/divider.html +0 -58
  123. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +0 -73
  124. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +0 -135
  125. package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +0 -79
  126. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +0 -62
  127. package/docs/crawl/core/components/ui/form/input/input.html +0 -109
  128. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +0 -106
  129. package/docs/crawl/core/components/ui/form/radio/radio.html +0 -56
  130. package/docs/crawl/core/components/ui/form/select/select.html +0 -73
  131. package/docs/crawl/core/components/ui/form/switch/switch.html +0 -56
  132. package/docs/crawl/core/components/ui/form/textarea/textarea.html +0 -59
  133. package/docs/crawl/core/components/ui/group/group.html +0 -82
  134. package/docs/crawl/core/components/ui/icon/icon.html +0 -133
  135. package/docs/crawl/core/components/ui/image/image.html +0 -110
  136. package/docs/crawl/core/components/ui/link/link.html +0 -42
  137. package/docs/crawl/core/components/ui/loader/loader.html +0 -50
  138. package/docs/crawl/core/components/ui/menu/menu.html +0 -322
  139. package/docs/crawl/core/components/ui/modal/modal.html +0 -117
  140. package/docs/crawl/core/components/ui/pop/pop.html +0 -102
  141. package/docs/crawl/core/components/ui/progress/progress.html +0 -58
  142. package/docs/crawl/core/components/ui/table/table.html +0 -413
  143. package/docs/crawl/core/components/ui/toast/toast.html +0 -122
  144. package/docs/crawl/core/components/ui/tooltip/tooltip.html +0 -79
  145. package/docs/crawl/docs/_core-concept/dataFlow.html +0 -177
  146. package/docs/crawl/docs/_core-concept/overview.html +0 -66
  147. package/docs/crawl/docs/_core-concept/subscriber.html +0 -75
  148. package/docs/crawl/docs/_decorators/ancestor-attribute.html +0 -116
  149. package/docs/crawl/docs/_decorators/auto-subscribe.html +0 -202
  150. package/docs/crawl/docs/_decorators/bind.html +0 -141
  151. package/docs/crawl/docs/_decorators/get.html +0 -149
  152. package/docs/crawl/docs/_decorators/handle.html +0 -165
  153. package/docs/crawl/docs/_decorators/on-assign.html +0 -355
  154. package/docs/crawl/docs/_decorators/patch.html +0 -78
  155. package/docs/crawl/docs/_decorators/post.html +0 -139
  156. package/docs/crawl/docs/_decorators/publish.html +0 -61
  157. package/docs/crawl/docs/_decorators/put.html +0 -78
  158. package/docs/crawl/docs/_decorators/subscribe.html +0 -109
  159. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +0 -137
  160. package/docs/crawl/docs/_directives/sub.html +0 -93
  161. package/docs/crawl/docs/_getting-started/ai-agents.html +0 -173
  162. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +0 -100
  163. package/docs/crawl/docs/_getting-started/concorde-outside.html +0 -58
  164. package/docs/crawl/docs/_getting-started/create-a-component.html +0 -111
  165. package/docs/crawl/docs/_getting-started/my-first-component.html +0 -189
  166. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +0 -110
  167. package/docs/crawl/docs/_getting-started/pubsub.html +0 -62
  168. package/docs/crawl/docs/_getting-started/start.html +0 -76
  169. package/docs/crawl/docs/_getting-started/theming.html +0 -85
  170. package/docs/crawl/docs/_misc/api-configuration.html +0 -149
  171. package/docs/crawl/docs/_misc/dataProviderKey.html +0 -135
  172. package/docs/crawl/docs/_misc/docs-mock-api.html +0 -158
  173. package/docs/crawl/docs/_misc/dynamic-path.html +0 -180
  174. package/docs/crawl/docs/_misc/endpoint.html +0 -50
  175. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +0 -138
  176. package/docs/crawl/docs/_misc/html-integration.html +0 -48
  177. package/docs/crawl/hubs/decorators.html +0 -547
  178. package/docs/crawl/hubs/form-components.html +0 -357
  179. package/docs/crawl/hubs/remote-data.html +0 -452
  180. package/docs/crawl/index.html +0 -101
  181. package/docs/css/docs.css +0 -0
  182. package/docs/docs-mock-api-sw.js +0 -720
  183. package/docs/docs-mock-api-sw.js.map +0 -7
  184. package/docs/fonts/ClashGrotesk-Bold.eot +0 -0
  185. package/docs/fonts/ClashGrotesk-Bold.ttf +0 -0
  186. package/docs/fonts/ClashGrotesk-Bold.woff +0 -0
  187. package/docs/fonts/ClashGrotesk-Bold.woff2 +0 -0
  188. package/docs/fonts/ClashGrotesk-Extralight.eot +0 -0
  189. package/docs/fonts/ClashGrotesk-Extralight.ttf +0 -0
  190. package/docs/fonts/ClashGrotesk-Extralight.woff +0 -0
  191. package/docs/fonts/ClashGrotesk-Extralight.woff2 +0 -0
  192. package/docs/fonts/ClashGrotesk-Light.eot +0 -0
  193. package/docs/fonts/ClashGrotesk-Light.ttf +0 -0
  194. package/docs/fonts/ClashGrotesk-Light.woff +0 -0
  195. package/docs/fonts/ClashGrotesk-Light.woff2 +0 -0
  196. package/docs/fonts/ClashGrotesk-Medium.eot +0 -0
  197. package/docs/fonts/ClashGrotesk-Medium.ttf +0 -0
  198. package/docs/fonts/ClashGrotesk-Medium.woff +0 -0
  199. package/docs/fonts/ClashGrotesk-Medium.woff2 +0 -0
  200. package/docs/fonts/ClashGrotesk-Regular.eot +0 -0
  201. package/docs/fonts/ClashGrotesk-Regular.ttf +0 -0
  202. package/docs/fonts/ClashGrotesk-Regular.woff +0 -0
  203. package/docs/fonts/ClashGrotesk-Regular.woff2 +0 -0
  204. package/docs/fonts/ClashGrotesk-Semibold.eot +0 -0
  205. package/docs/fonts/ClashGrotesk-Semibold.ttf +0 -0
  206. package/docs/fonts/ClashGrotesk-Semibold.woff +0 -0
  207. package/docs/fonts/ClashGrotesk-Semibold.woff2 +0 -0
  208. package/docs/fonts/ClashGrotesk-Variable.eot +0 -0
  209. package/docs/fonts/ClashGrotesk-Variable.ttf +0 -0
  210. package/docs/fonts/ClashGrotesk-Variable.woff +0 -0
  211. package/docs/fonts/ClashGrotesk-Variable.woff2 +0 -0
  212. package/docs/img/concorde-icon.svg +0 -5
  213. package/docs/img/concorde-logo.svg +0 -1
  214. package/docs/img/concorde.png +0 -0
  215. package/docs/img/concorde_def.png +0 -0
  216. package/docs/img/concorde_seuil.png.webp +0 -0
  217. package/docs/img/concorde_seuil_invert.png +0 -0
  218. package/docs/img/paul_metrand.jpg +0 -0
  219. package/docs/img/paul_metrand_xs.jpg +0 -0
  220. package/docs/index.html +0 -93
  221. package/docs/llms-full.txt +0 -5787
  222. package/docs/llms.txt +0 -104
  223. package/docs/robots.txt +0 -16
  224. package/docs/sitemap.xml +0 -237
  225. package/docs/src/core/components/functional/date/date.md +0 -290
  226. package/docs/src/core/components/functional/fetch/fetch.md +0 -125
  227. package/docs/src/core/components/functional/if/if.md +0 -9
  228. package/docs/src/core/components/functional/jsonata/jsonata.md +0 -56
  229. package/docs/src/core/components/functional/list/list.md +0 -65
  230. package/docs/src/core/components/functional/mix/mix.md +0 -41
  231. package/docs/src/core/components/functional/queue/queue.md +0 -72
  232. package/docs/src/core/components/functional/router/router.md +0 -94
  233. package/docs/src/core/components/functional/sdui/default-library.json +0 -108
  234. package/docs/src/core/components/functional/sdui/example.json +0 -99
  235. package/docs/src/core/components/functional/sdui/sdui.md +0 -356
  236. package/docs/src/core/components/functional/states/states.md +0 -87
  237. package/docs/src/core/components/functional/submit/submit.md +0 -114
  238. package/docs/src/core/components/functional/subscriber/subscriber.md +0 -91
  239. package/docs/src/core/components/functional/value/value.md +0 -35
  240. package/docs/src/core/components/ui/alert/alert.md +0 -121
  241. package/docs/src/core/components/ui/alert-messages/alert-messages.md +0 -0
  242. package/docs/src/core/components/ui/badge/badge.md +0 -127
  243. package/docs/src/core/components/ui/button/button.md +0 -182
  244. package/docs/src/core/components/ui/captcha/captcha.md +0 -12
  245. package/docs/src/core/components/ui/card/card.md +0 -97
  246. package/docs/src/core/components/ui/divider/divider.md +0 -35
  247. package/docs/src/core/components/ui/form/checkbox/checkbox.md +0 -77
  248. package/docs/src/core/components/ui/form/fieldset/fieldset.md +0 -129
  249. package/docs/src/core/components/ui/form/form-actions/form-actions.md +0 -77
  250. package/docs/src/core/components/ui/form/form-layout/form-layout.md +0 -44
  251. package/docs/src/core/components/ui/form/input/input.md +0 -142
  252. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -133
  253. package/docs/src/core/components/ui/form/radio/radio.md +0 -57
  254. package/docs/src/core/components/ui/form/select/select.md +0 -71
  255. package/docs/src/core/components/ui/form/switch/switch.md +0 -57
  256. package/docs/src/core/components/ui/form/textarea/textarea.md +0 -65
  257. package/docs/src/core/components/ui/group/group.md +0 -75
  258. package/docs/src/core/components/ui/icon/icon.md +0 -125
  259. package/docs/src/core/components/ui/icon/icons.json +0 -1
  260. package/docs/src/core/components/ui/image/image.md +0 -107
  261. package/docs/src/core/components/ui/link/link.md +0 -43
  262. package/docs/src/core/components/ui/loader/loader.md +0 -55
  263. package/docs/src/core/components/ui/menu/menu.md +0 -329
  264. package/docs/src/core/components/ui/modal/modal.md +0 -119
  265. package/docs/src/core/components/ui/pop/pop.md +0 -96
  266. package/docs/src/core/components/ui/progress/progress.md +0 -63
  267. package/docs/src/core/components/ui/table/table.md +0 -455
  268. package/docs/src/core/components/ui/toast/toast.md +0 -166
  269. package/docs/src/core/components/ui/tooltip/tooltip.md +0 -82
  270. package/docs/src/docs/_core-concept/dataFlow.md +0 -88
  271. package/docs/src/docs/_core-concept/overview.md +0 -57
  272. package/docs/src/docs/_core-concept/subscriber.md +0 -75
  273. package/docs/src/docs/_decorators/ancestor-attribute.md +0 -127
  274. package/docs/src/docs/_decorators/auto-subscribe.md +0 -202
  275. package/docs/src/docs/_decorators/bind.md +0 -167
  276. package/docs/src/docs/_decorators/get.md +0 -162
  277. package/docs/src/docs/_decorators/handle.md +0 -175
  278. package/docs/src/docs/_decorators/on-assign.md +0 -390
  279. package/docs/src/docs/_decorators/patch.md +0 -70
  280. package/docs/src/docs/_decorators/post.md +0 -146
  281. package/docs/src/docs/_decorators/publish.md +0 -55
  282. package/docs/src/docs/_decorators/put.md +0 -70
  283. package/docs/src/docs/_decorators/subscribe.md +0 -100
  284. package/docs/src/docs/_decorators/wait-for-ancestors.md +0 -163
  285. package/docs/src/docs/_directives/sub.md +0 -91
  286. package/docs/src/docs/_getting-started/ai-agents.md +0 -76
  287. package/docs/src/docs/_getting-started/concorde-manual-install.md +0 -133
  288. package/docs/src/docs/_getting-started/concorde-outside.md +0 -33
  289. package/docs/src/docs/_getting-started/create-a-component.md +0 -139
  290. package/docs/src/docs/_getting-started/my-first-component.md +0 -236
  291. package/docs/src/docs/_getting-started/my-first-subscriber.md +0 -120
  292. package/docs/src/docs/_getting-started/pubsub.md +0 -37
  293. package/docs/src/docs/_getting-started/start.md +0 -47
  294. package/docs/src/docs/_getting-started/theming.md +0 -91
  295. package/docs/src/docs/_misc/api-configuration.md +0 -81
  296. package/docs/src/docs/_misc/dataProviderKey.md +0 -168
  297. package/docs/src/docs/_misc/docs-mock-api.md +0 -63
  298. package/docs/src/docs/_misc/dynamic-path.md +0 -71
  299. package/docs/src/docs/_misc/endpoint.md +0 -45
  300. package/docs/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  301. package/docs/src/docs/_misc/html-integration.md +0 -15
  302. package/docs/src/docs/search/docs-search.json +0 -9512
  303. package/docs/src/tag-list.json +0 -1
  304. package/docs/src/tsconfig-model.json +0 -23
  305. package/docs/src/tsconfig.declarations.json +0 -22
  306. package/docs/src/tsconfig.emit.json +0 -23
  307. package/docs/src/tsconfig.json +0 -858
  308. package/docs/svg/regular/plane.svg +0 -1
  309. package/docs/svg/solid/plane.svg +0 -1
  310. package/gitlab/job_github_mirror.sh +0 -39
  311. package/scripts/github-export.mjs +0 -150
  312. package/src/css.d.ts +0 -19
  313. package/src/tsconfig.declarations.json +0 -22
  314. package/src/tsconfig.emit.json +0 -23
package/docs/crawl/docs/_decorators/auto-subscribe.html DELETED
@@ -1,202 +0,0 @@
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 DELETED
@@ -1,141 +0,0 @@
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 DELETED
@@ -1,149 +0,0 @@
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>