@supersoniks/concorde 5.1.2 → 5.1.3-immutable.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 (497) hide show
  1. package/.agents/skills/concorde-docs/SKILL.md +1 -1
  2. package/.claude/skills +1 -0
  3. package/.github/workflows/ci.yml +21 -0
  4. package/.github-export-ignore +30 -0
  5. package/CONTRIBUTING.md +59 -0
  6. package/DEV.md +54 -0
  7. package/LICENSE +21 -0
  8. package/OPEN_SOURCE_CHECKPOINT.md +133 -0
  9. package/README.md +1 -1
  10. package/ai/README.md +29 -41
  11. package/ai/skills/concorde/SKILL.md +54 -324
  12. package/ai/skills/concorde/rules/composition.md +32 -0
  13. package/ai/skills/concorde/rules/data.md +47 -0
  14. package/ai/skills/concorde/rules/http.md +25 -0
  15. package/ai/skills/concorde/rules/lists-forms.md +35 -0
  16. package/ai/skills/concorde/rules/styling.md +46 -0
  17. package/ai/skills/concorde/rules/troubleshooting.md +45 -0
  18. package/build-infos.json +1 -1
  19. package/concorde-core.bundle.js +177 -177
  20. package/concorde-core.es.js +5183 -5018
  21. package/custom-elements-manifest.public.config.mjs +8 -0
  22. package/{.tmp-cem/custom-elements.json → custom-elements.json} +11722 -8868
  23. package/dist/concorde-core.bundle.js +177 -177
  24. package/dist/concorde-core.es.js +5183 -5018
  25. package/dist/docs-mock-api-sw.js +58 -223
  26. package/dist/docs-mock-api-sw.js.map +4 -4
  27. package/dist/img/og-concorde.jpg +0 -0
  28. package/dist/robots.txt +11 -10
  29. package/docs/assets/index-CD4WyL6o.css +1 -0
  30. package/docs/assets/index-D_alEsng.js +12122 -0
  31. package/docs/crawl/core/components/functional/date/date.html +190 -0
  32. package/docs/crawl/core/components/functional/fetch/fetch.html +109 -0
  33. package/docs/crawl/core/components/functional/if/if.html +27 -0
  34. package/docs/crawl/core/components/functional/jsonata/jsonata.html +79 -0
  35. package/docs/crawl/core/components/functional/list/list.html +70 -0
  36. package/docs/crawl/core/components/functional/mix/mix.html +45 -0
  37. package/docs/crawl/core/components/functional/queue/queue.html +96 -0
  38. package/docs/crawl/core/components/functional/router/router.html +106 -0
  39. package/docs/{core → crawl/core}/components/functional/sdui/sdui-extension-points.html +8 -9
  40. package/docs/crawl/core/components/functional/sdui/sdui.html +368 -0
  41. package/docs/crawl/core/components/functional/states/states.html +66 -0
  42. package/docs/crawl/core/components/functional/submit/submit.html +160 -0
  43. package/docs/{core → crawl/core}/components/functional/subscriber/subscriber.html +5 -6
  44. package/docs/crawl/core/components/functional/value/value.html +51 -0
  45. package/docs/{core → crawl/core}/components/ui/alert/alert.html +63 -53
  46. package/docs/{core → crawl/core}/components/ui/alert-messages/alert-messages.html +5 -6
  47. package/docs/{core → crawl/core}/components/ui/badge/badge.html +33 -33
  48. package/docs/crawl/core/components/ui/button/button.html +150 -0
  49. package/docs/crawl/core/components/ui/captcha/captcha.html +112 -0
  50. package/docs/{core → crawl/core}/components/ui/card/card.html +11 -12
  51. package/docs/{core → crawl/core}/components/ui/divider/divider.html +14 -14
  52. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +73 -0
  53. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +266 -0
  54. package/docs/{core → crawl/core}/components/ui/form/form-actions/form-actions.html +23 -23
  55. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +121 -0
  56. package/docs/crawl/core/components/ui/form/input/input.html +109 -0
  57. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +38 -0
  58. package/docs/crawl/core/components/ui/form/radio/radio.html +56 -0
  59. package/docs/crawl/core/components/ui/form/select/select.html +73 -0
  60. package/docs/crawl/core/components/ui/form/switch/switch.html +56 -0
  61. package/docs/crawl/core/components/ui/form/textarea/textarea.html +59 -0
  62. package/docs/crawl/core/components/ui/group/group.html +104 -0
  63. package/docs/{core → crawl/core}/components/ui/icon/icon.html +9 -10
  64. package/docs/crawl/core/components/ui/image/image.html +298 -0
  65. package/docs/{core → crawl/core}/components/ui/link/link.html +11 -12
  66. package/docs/crawl/core/components/ui/loader/loader.html +124 -0
  67. package/docs/{core → crawl/core}/components/ui/menu/menu.html +33 -34
  68. package/docs/crawl/core/components/ui/modal/modal.html +342 -0
  69. package/docs/crawl/core/components/ui/pop/pop.html +296 -0
  70. package/docs/{core → crawl/core}/components/ui/progress/progress.html +7 -8
  71. package/docs/crawl/core/components/ui/table/table.html +545 -0
  72. package/docs/crawl/core/components/ui/theme/theme.html +131 -0
  73. package/docs/crawl/core/components/ui/toast/toast.html +233 -0
  74. package/docs/crawl/core/components/ui/tooltip/tooltip.html +140 -0
  75. package/docs/{docs/getting-started → crawl/docs/_core-concept}/dataFlow.html +29 -26
  76. package/docs/crawl/docs/_core-concept/overview.html +66 -0
  77. package/docs/crawl/docs/_core-concept/subscriber.html +75 -0
  78. package/docs/crawl/docs/_decorators/ancestor-attribute.html +117 -0
  79. package/docs/crawl/docs/_decorators/auto-subscribe.html +202 -0
  80. package/docs/crawl/docs/_decorators/bind.html +141 -0
  81. package/docs/crawl/docs/_decorators/get.html +149 -0
  82. package/docs/crawl/docs/_decorators/handle.html +165 -0
  83. package/docs/crawl/docs/_decorators/on-assign.html +355 -0
  84. package/docs/crawl/docs/_decorators/patch.html +78 -0
  85. package/docs/crawl/docs/_decorators/post.html +139 -0
  86. package/docs/crawl/docs/_decorators/publish.html +61 -0
  87. package/docs/crawl/docs/_decorators/put.html +78 -0
  88. package/docs/crawl/docs/_decorators/subscribe.html +109 -0
  89. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +137 -0
  90. package/docs/crawl/docs/_directives/sub.html +93 -0
  91. package/docs/{docs/getting-started → crawl/docs/_getting-started}/ai-agents.html +11 -12
  92. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +100 -0
  93. package/docs/crawl/docs/_getting-started/concorde-outside.html +58 -0
  94. package/docs/{docs/getting-started → crawl/docs/_getting-started}/create-a-component.html +14 -11
  95. package/docs/{docs/getting-started → crawl/docs/_getting-started}/my-first-component.html +22 -13
  96. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +110 -0
  97. package/docs/crawl/docs/_getting-started/pubsub.html +62 -0
  98. package/docs/crawl/docs/_getting-started/start.html +76 -0
  99. package/docs/{docs/getting-started → crawl/docs/_getting-started}/theming.html +9 -10
  100. package/docs/{docs/misc → crawl/docs/_misc}/api-configuration.html +18 -18
  101. package/docs/{docs/misc → crawl/docs/_misc}/dataProviderKey.html +11 -12
  102. package/docs/{docs/misc → crawl/docs/_misc}/docs-mock-api.html +28 -25
  103. package/docs/{docs/misc → crawl/docs/_misc}/dynamic-path.html +15 -16
  104. package/docs/{docs/misc → crawl/docs/_misc}/endpoint.html +15 -16
  105. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +138 -0
  106. package/docs/{docs/misc → crawl/docs/_misc}/html-integration.html +15 -12
  107. package/docs/crawl/hubs/decorators.html +547 -0
  108. package/docs/crawl/hubs/form-components.html +381 -0
  109. package/docs/crawl/hubs/remote-data.html +452 -0
  110. package/docs/crawl/index.html +103 -0
  111. package/docs/docs-mock-api-sw.js +223 -58
  112. package/docs/docs-mock-api-sw.js.map +4 -4
  113. package/docs/index.html +68 -95
  114. package/docs/llms-full.txt +3610 -2231
  115. package/docs/llms.txt +86 -94
  116. package/docs/robots.txt +10 -11
  117. package/docs/sitemap.xml +84 -78
  118. package/docs/src/core/components/functional/date/date.md +231 -91
  119. package/docs/src/core/components/functional/fetch/fetch.md +83 -66
  120. package/docs/src/core/components/functional/if/if.md +3 -28
  121. package/docs/src/core/components/functional/jsonata/jsonata.md +37 -42
  122. package/docs/src/core/components/functional/list/list.md +43 -99
  123. package/docs/src/core/components/functional/mix/mix.md +26 -31
  124. package/docs/src/core/components/functional/queue/queue.md +61 -40
  125. package/docs/src/core/components/functional/router/router.md +65 -64
  126. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  127. package/docs/src/core/components/functional/sdui/component-catalog.json +1 -1
  128. package/docs/src/core/components/functional/sdui/example.json +86 -19
  129. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  130. package/docs/src/core/components/functional/sdui/sdui.md +358 -187
  131. package/docs/src/core/components/functional/states/states.md +61 -86
  132. package/docs/src/core/components/functional/submit/submit.md +72 -64
  133. package/docs/src/core/components/functional/value/value.md +22 -34
  134. package/docs/src/core/components/ui/alert/alert.md +58 -48
  135. package/docs/src/core/components/ui/badge/badge.md +34 -27
  136. package/docs/src/core/components/ui/button/button.md +106 -139
  137. package/docs/src/core/components/ui/captcha/captcha.md +32 -17
  138. package/docs/src/core/components/ui/card/card.md +6 -6
  139. package/docs/src/core/components/ui/divider/divider.md +11 -8
  140. package/docs/src/core/components/ui/form/checkbox/checkbox.md +42 -90
  141. package/docs/src/core/components/ui/form/fieldset/fieldset.md +75 -31
  142. package/docs/src/core/components/ui/form/form-actions/form-actions.md +16 -14
  143. package/docs/src/core/components/ui/form/form-layout/form-layout.md +29 -19
  144. package/docs/src/core/components/ui/form/input/input.md +95 -95
  145. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +29 -0
  146. package/docs/src/core/components/ui/form/radio/radio.md +34 -55
  147. package/docs/src/core/components/ui/form/select/select.md +45 -60
  148. package/docs/src/core/components/ui/form/switch/switch.md +34 -57
  149. package/docs/src/core/components/ui/form/textarea/textarea.md +38 -55
  150. package/docs/src/core/components/ui/group/group.md +33 -35
  151. package/docs/src/core/components/ui/icon/icon.md +4 -4
  152. package/docs/src/core/components/ui/image/image.md +107 -41
  153. package/docs/src/core/components/ui/link/link.md +6 -6
  154. package/docs/src/core/components/ui/loader/loader.md +55 -30
  155. package/docs/src/core/components/ui/menu/menu.md +27 -27
  156. package/docs/src/core/components/ui/modal/modal.md +96 -72
  157. package/docs/src/core/components/ui/pop/pop.md +158 -80
  158. package/docs/src/core/components/ui/progress/progress.md +2 -2
  159. package/docs/src/core/components/ui/table/table.md +255 -91
  160. package/docs/src/core/components/ui/theme/theme.md +36 -11
  161. package/docs/src/core/components/ui/toast/toast.md +117 -48
  162. package/docs/src/core/components/ui/tooltip/tooltip.md +62 -27
  163. package/docs/{docs/getting-started → src/docs/_core-concept}/dataFlow.md +18 -17
  164. package/docs/src/docs/_core-concept/overview.md +57 -0
  165. package/docs/src/docs/_core-concept/subscriber.md +75 -0
  166. package/docs/src/docs/_decorators/ancestor-attribute.md +128 -0
  167. package/docs/src/docs/_decorators/auto-subscribe.md +202 -0
  168. package/docs/src/docs/_decorators/bind.md +167 -0
  169. package/docs/src/docs/_decorators/get.md +162 -0
  170. package/docs/src/docs/_decorators/handle.md +175 -0
  171. package/docs/src/docs/_decorators/on-assign.md +390 -0
  172. package/docs/src/docs/_decorators/patch.md +70 -0
  173. package/docs/src/docs/_decorators/post.md +146 -0
  174. package/docs/src/docs/_decorators/publish.md +55 -0
  175. package/docs/src/docs/_decorators/put.md +70 -0
  176. package/docs/src/docs/_decorators/subscribe.md +100 -0
  177. package/docs/src/docs/_decorators/wait-for-ancestors.md +163 -0
  178. package/docs/src/docs/_directives/sub.md +91 -0
  179. package/docs/src/docs/{getting-started → _getting-started}/ai-agents.md +3 -3
  180. package/docs/src/docs/_getting-started/concorde-manual-install.md +133 -0
  181. package/docs/src/docs/_getting-started/concorde-outside.md +33 -0
  182. package/docs/{docs/getting-started → src/docs/_getting-started}/create-a-component.md +6 -3
  183. package/docs/src/docs/{getting-started → _getting-started}/my-first-component.md +14 -5
  184. package/docs/src/docs/_getting-started/my-first-subscriber.md +120 -0
  185. package/docs/src/docs/_getting-started/pubsub.md +37 -0
  186. package/docs/src/docs/{getting-started → _getting-started}/start.md +13 -1
  187. package/docs/src/docs/{getting-started → _getting-started}/theming.md +2 -2
  188. package/docs/src/docs/{misc → _misc}/api-configuration.md +12 -10
  189. package/docs/src/docs/{misc → _misc}/dataProviderKey.md +4 -4
  190. package/docs/{docs/misc → src/docs/_misc}/docs-mock-api.md +13 -12
  191. package/docs/{docs/misc → src/docs/_misc}/dynamic-path.md +8 -8
  192. package/docs/{docs/misc → src/docs/_misc}/endpoint.md +8 -8
  193. package/docs/src/docs/_misc/formelement-subscriber-removal.md +115 -0
  194. package/docs/{docs/misc → src/docs/_misc}/html-integration.md +5 -4
  195. package/docs/src/docs/search/docs-search.json +4375 -2420
  196. package/docs/src/tsconfig.declarations.json +22 -0
  197. package/docs/src/tsconfig.emit.json +23 -0
  198. package/docs/src/tsconfig.json +2 -23
  199. package/gitlab/job_github_mirror.sh +39 -0
  200. package/index.html +89 -0
  201. package/package.json +22 -4
  202. package/public/img/og-concorde.jpg +0 -0
  203. package/scripts/ai-init.mjs +104 -379
  204. package/scripts/ai-init.test.mjs +81 -239
  205. package/scripts/docs-markdown-vite-plugin.ts +11 -5
  206. package/scripts/docs-public-url.mjs +6 -0
  207. package/scripts/docs.htaccess +7 -0
  208. package/scripts/generate-cem.mjs +244 -0
  209. package/scripts/generate-cem.test.mjs +122 -0
  210. package/scripts/generate-crawl-docs.mjs +29 -5
  211. package/scripts/generate-sdui-catalog.mjs +11 -10
  212. package/scripts/github-export.mjs +150 -0
  213. package/scripts/post-build-docs.js +3 -0
  214. package/scripts/post-build.mjs +0 -0
  215. package/scripts/pre-publish.mjs +2 -1
  216. package/scripts/site-pages.mjs +212 -0
  217. package/scripts/site-pages.test.mjs +116 -0
  218. package/site-pages/about.md +22 -0
  219. package/site-pages/privacy.md +32 -0
  220. package/src/core/components/functional/date/date.md +1 -1
  221. package/src/core/components/functional/example/example.ts +3 -1
  222. package/src/core/components/functional/if/if.ts +0 -0
  223. package/src/core/components/functional/list/list.demo.ts +0 -0
  224. package/src/core/components/functional/list/list.md +6 -2
  225. package/src/core/components/functional/list/list.ts +17 -4
  226. package/src/core/components/functional/mix/mix.md +0 -0
  227. package/src/core/components/functional/router/router.demo.ts +0 -0
  228. package/src/core/components/functional/router/router.ts +0 -0
  229. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  230. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  231. package/src/core/components/functional/sdui/component-catalog.json +2 -2
  232. package/src/core/components/functional/sdui/example.json +0 -0
  233. package/src/core/components/functional/sdui/sdui-immutable.spec.ts +74 -0
  234. package/src/core/components/functional/sdui/sdui.ts +33 -8
  235. package/src/core/components/functional/sdui/types.ts +0 -0
  236. package/src/core/components/functional/states/states.ts +0 -0
  237. package/src/core/components/functional/submit/submit.spec.ts +60 -0
  238. package/src/core/components/functional/submit/submit.ts +6 -3
  239. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  240. package/src/core/components/functional/value/value.md +0 -0
  241. package/src/core/components/functional/value/value.ts +0 -0
  242. package/src/core/components/ui/_css/size.ts +0 -0
  243. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  244. package/src/core/components/ui/card/card.md +1 -1
  245. package/src/core/components/ui/form/input/input.md +19 -1
  246. package/src/core/components/ui/form/input/input.ts +8 -2
  247. package/src/core/components/ui/form/radio/radio.md +14 -0
  248. package/src/core/components/ui/image/image.md +17 -17
  249. package/src/core/components/ui/modal/modal.md +2 -2
  250. package/src/core/decorators/subscriber/bind.ts +9 -14
  251. package/src/core/decorators/subscriber/subscribe.ts +15 -9
  252. package/src/core/decorators/subscriber/subscribe.type-test.ts +14 -5
  253. package/src/core/mixins/Subscriber.ts +0 -0
  254. package/src/core/utils/DataBindObserver.ts +0 -0
  255. package/src/core/utils/Objects.ts +0 -0
  256. package/src/core/utils/PublisherProxy.ts +166 -125
  257. package/src/core/utils/deepReadonly.spec.ts +66 -0
  258. package/src/core/utils/deepReadonly.ts +71 -0
  259. package/src/core/utils/immutableValue.spec.ts +58 -0
  260. package/src/core/utils/immutableValue.ts +116 -0
  261. package/src/core/utils/nestedDotForm.spec.ts +88 -0
  262. package/src/core/utils/publisherImmutable.spec.ts +127 -0
  263. package/src/core/utils/route.ts +0 -0
  264. package/src/core/utils/strictGet.spec.ts +61 -0
  265. package/src/core/utils/strictGet.ts +102 -0
  266. package/src/css.d.ts +19 -0
  267. package/src/docs/components/docs-demo-sources.ts +3 -3
  268. package/src/docs/decorators/bind.md +23 -24
  269. package/src/docs/docs-location.spec.ts +10 -0
  270. package/src/docs/docs-location.ts +10 -0
  271. package/src/docs/example/decorators-demo-bind-demos.ts +11 -28
  272. package/src/docs/example/docs-toggle-demos.ts +1 -1
  273. package/src/docs/example/users.ts +0 -0
  274. package/src/docs/getting-started/ai-agents.md +51 -51
  275. package/src/docs/getting-started/dataFlow.md +2 -2
  276. package/src/docs/home/home.ts +3 -1
  277. package/src/docs/misc/publisher-get-immutability-docs-crawl.json +902 -0
  278. package/src/docs/misc/publisher-get-immutability-docs-recheck.json +13 -0
  279. package/src/docs/misc/publisher-get-immutability-study.md +229 -0
  280. package/src/docs/navigation/navigation.ts +5 -1
  281. package/src/docs/search/docs-search.json +358 -58
  282. package/src/docs/search/markdown-renderer.ts +6 -1
  283. package/src/docs/tailwind/css/docs/content.css +4 -5
  284. package/src/tsconfig.declarations.json +22 -0
  285. package/src/tsconfig.emit.json +23 -0
  286. package/src/tsconfig.json +53 -5
  287. package/src/tsconfig.tsbuildinfo +1 -1
  288. package/.taste-skill/after/desktop-fold.jpg +0 -0
  289. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  290. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  291. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  292. package/.taste-skill/after/mobile-fold.jpg +0 -0
  293. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  294. package/.taste-skill/after/report.json +0 -4103
  295. package/.taste-skill/after/tablet-fold.jpg +0 -0
  296. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  297. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  298. package/.taste-skill/before/desktop-fold.jpg +0 -0
  299. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  300. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  301. package/.taste-skill/before/mobile-fold.jpg +0 -0
  302. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  303. package/.taste-skill/before/report.json +0 -2556
  304. package/.taste-skill/before/tablet-fold.jpg +0 -0
  305. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  306. package/.taste-skill/direction.json +0 -510
  307. package/.taste-skill/notes.md +0 -84
  308. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  309. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  310. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  311. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  312. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  313. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  314. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  315. package/.taste-skill/prod/report.json +0 -1973
  316. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  317. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  318. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  319. package/AUDIT.md +0 -228
  320. package/PLAN-AMELIORATION.md +0 -220
  321. package/PLAN-DOCS-AGENTS.md +0 -80
  322. package/ai/AGENTS.md +0 -56
  323. package/ai/cursor/rules/concorde-menu.mdc +0 -15
  324. package/ai/cursor/rules/concorde-scope.mdc +0 -14
  325. package/ai/cursor/rules/concorde-theme.mdc +0 -13
  326. package/ai/cursor/rules/concorde.mdc +0 -66
  327. package/ai/jetbrains/rules/concorde.md +0 -53
  328. package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
  329. package/ai/skills/concorde-imports/SKILL.md +0 -78
  330. package/ai/skills/concorde-menu/SKILL.md +0 -74
  331. package/ai/skills/concorde-scope/SKILL.md +0 -70
  332. package/ai/skills/concorde-theme/SKILL.md +0 -57
  333. package/docs/.htaccess +0 -75
  334. package/docs/404.html +0 -15
  335. package/docs/404.md +0 -5
  336. package/docs/assets/index-BgG6FFPt.js +0 -11765
  337. package/docs/assets/index-x89XINSG.css +0 -1
  338. package/docs/core/components/functional/date/date.html +0 -211
  339. package/docs/core/components/functional/date/date.md +0 -150
  340. package/docs/core/components/functional/fetch/fetch.html +0 -180
  341. package/docs/core/components/functional/fetch/fetch.md +0 -108
  342. package/docs/core/components/functional/if/if.html +0 -65
  343. package/docs/core/components/functional/if/if.md +0 -34
  344. package/docs/core/components/functional/jsonata/jsonata.html +0 -110
  345. package/docs/core/components/functional/jsonata/jsonata.md +0 -61
  346. package/docs/core/components/functional/list/list.html +0 -198
  347. package/docs/core/components/functional/list/list.md +0 -121
  348. package/docs/core/components/functional/mix/mix.html +0 -78
  349. package/docs/core/components/functional/mix/mix.md +0 -46
  350. package/docs/core/components/functional/queue/queue.html +0 -155
  351. package/docs/core/components/functional/queue/queue.md +0 -51
  352. package/docs/core/components/functional/router/router.html +0 -154
  353. package/docs/core/components/functional/router/router.md +0 -93
  354. package/docs/core/components/functional/sdui/sdui-extension-points.md +0 -94
  355. package/docs/core/components/functional/sdui/sdui.html +0 -397
  356. package/docs/core/components/functional/sdui/sdui.md +0 -307
  357. package/docs/core/components/functional/states/states.html +0 -141
  358. package/docs/core/components/functional/states/states.md +0 -112
  359. package/docs/core/components/functional/submit/submit.html +0 -178
  360. package/docs/core/components/functional/submit/submit.md +0 -106
  361. package/docs/core/components/functional/subscriber/subscriber.md +0 -91
  362. package/docs/core/components/functional/translation/translation.html +0 -60
  363. package/docs/core/components/functional/translation/translation.md +0 -38
  364. package/docs/core/components/functional/value/value.html +0 -81
  365. package/docs/core/components/functional/value/value.md +0 -47
  366. package/docs/core/components/ui/alert/alert.md +0 -186
  367. package/docs/core/components/ui/alert-messages/alert-messages.md +0 -85
  368. package/docs/core/components/ui/badge/badge.md +0 -181
  369. package/docs/core/components/ui/button/button.html +0 -309
  370. package/docs/core/components/ui/button/button.md +0 -216
  371. package/docs/core/components/ui/captcha/captcha.html +0 -80
  372. package/docs/core/components/ui/captcha/captcha.md +0 -56
  373. package/docs/core/components/ui/card/card.md +0 -215
  374. package/docs/core/components/ui/divider/divider.md +0 -126
  375. package/docs/core/components/ui/form/checkbox/checkbox.html +0 -200
  376. package/docs/core/components/ui/form/checkbox/checkbox.md +0 -125
  377. package/docs/core/components/ui/form/fieldset/fieldset.html +0 -238
  378. package/docs/core/components/ui/form/fieldset/fieldset.md +0 -161
  379. package/docs/core/components/ui/form/form-actions/form-actions.md +0 -98
  380. package/docs/core/components/ui/form/form-layout/form-layout.html +0 -115
  381. package/docs/core/components/ui/form/form-layout/form-layout.md +0 -109
  382. package/docs/core/components/ui/form/input/input.html +0 -235
  383. package/docs/core/components/ui/form/input/input.md +0 -142
  384. package/docs/core/components/ui/form/radio/radio.html +0 -144
  385. package/docs/core/components/ui/form/radio/radio.md +0 -78
  386. package/docs/core/components/ui/form/select/select.html +0 -178
  387. package/docs/core/components/ui/form/select/select.md +0 -86
  388. package/docs/core/components/ui/form/switch/switch.html +0 -146
  389. package/docs/core/components/ui/form/switch/switch.md +0 -80
  390. package/docs/core/components/ui/form/textarea/textarea.html +0 -162
  391. package/docs/core/components/ui/form/textarea/textarea.md +0 -82
  392. package/docs/core/components/ui/group/group.html +0 -113
  393. package/docs/core/components/ui/group/group.md +0 -77
  394. package/docs/core/components/ui/icon/icon.md +0 -214
  395. package/docs/core/components/ui/image/image.html +0 -194
  396. package/docs/core/components/ui/image/image.md +0 -167
  397. package/docs/core/components/ui/link/link.md +0 -81
  398. package/docs/core/components/ui/loader/loader.html +0 -114
  399. package/docs/core/components/ui/loader/loader.md +0 -87
  400. package/docs/core/components/ui/menu/menu.md +0 -370
  401. package/docs/core/components/ui/modal/modal.html +0 -324
  402. package/docs/core/components/ui/modal/modal.md +0 -211
  403. package/docs/core/components/ui/pop/pop.html +0 -250
  404. package/docs/core/components/ui/pop/pop.md +0 -216
  405. package/docs/core/components/ui/progress/progress.md +0 -109
  406. package/docs/core/components/ui/table/table.html +0 -333
  407. package/docs/core/components/ui/table/table.md +0 -267
  408. package/docs/core/components/ui/theme/theme.html +0 -116
  409. package/docs/core/components/ui/theme/theme.md +0 -97
  410. package/docs/core/components/ui/toast/toast.html +0 -185
  411. package/docs/core/components/ui/toast/toast.md +0 -147
  412. package/docs/core/components/ui/tooltip/tooltip.html +0 -112
  413. package/docs/core/components/ui/tooltip/tooltip.md +0 -89
  414. package/docs/docs/decorators/ancestor-attribute.html +0 -71
  415. package/docs/docs/decorators/ancestor-attribute.md +0 -59
  416. package/docs/docs/decorators/auto-subscribe.html +0 -61
  417. package/docs/docs/decorators/auto-subscribe.md +0 -40
  418. package/docs/docs/decorators/bind.html +0 -86
  419. package/docs/docs/decorators/bind.md +0 -77
  420. package/docs/docs/decorators/get.html +0 -166
  421. package/docs/docs/decorators/get.md +0 -160
  422. package/docs/docs/decorators/handle.html +0 -139
  423. package/docs/docs/decorators/handle.md +0 -119
  424. package/docs/docs/decorators/on-assign.html +0 -72
  425. package/docs/docs/decorators/on-assign.md +0 -63
  426. package/docs/docs/decorators/patch.html +0 -76
  427. package/docs/docs/decorators/patch.md +0 -44
  428. package/docs/docs/decorators/post.html +0 -150
  429. package/docs/docs/decorators/post.md +0 -134
  430. package/docs/docs/decorators/publish.html +0 -74
  431. package/docs/docs/decorators/publish.md +0 -56
  432. package/docs/docs/decorators/put.html +0 -83
  433. package/docs/docs/decorators/put.md +0 -51
  434. package/docs/docs/decorators/subscribe.html +0 -91
  435. package/docs/docs/decorators/subscribe.md +0 -87
  436. package/docs/docs/decorators/wait-for-ancestors.html +0 -82
  437. package/docs/docs/decorators/wait-for-ancestors.md +0 -76
  438. package/docs/docs/directives/sub.html +0 -79
  439. package/docs/docs/directives/sub.md +0 -75
  440. package/docs/docs/directives/t.html +0 -91
  441. package/docs/docs/directives/t.md +0 -73
  442. package/docs/docs/getting-started/ai-agents.md +0 -76
  443. package/docs/docs/getting-started/components.html +0 -27
  444. package/docs/docs/getting-started/components.md +0 -5
  445. package/docs/docs/getting-started/installation.html +0 -69
  446. package/docs/docs/getting-started/installation.md +0 -36
  447. package/docs/docs/getting-started/my-first-component.md +0 -227
  448. package/docs/docs/getting-started/start.html +0 -47
  449. package/docs/docs/getting-started/start.md +0 -35
  450. package/docs/docs/getting-started/theming.md +0 -253
  451. package/docs/docs/index.html +0 -99
  452. package/docs/docs/misc/api-configuration.md +0 -79
  453. package/docs/docs/misc/dataProviderKey.md +0 -168
  454. package/docs/hubs/decorators.html +0 -443
  455. package/docs/hubs/form-components.html +0 -404
  456. package/docs/hubs/remote-data.html +0 -371
  457. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  458. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  459. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  460. package/docs/img/archive/credits.json +0 -28
  461. package/docs/index.md +0 -22
  462. package/docs/src/core/components/functional/translation/translation.md +0 -38
  463. package/docs/src/docs/decorators/ancestor-attribute.md +0 -59
  464. package/docs/src/docs/decorators/auto-subscribe.md +0 -40
  465. package/docs/src/docs/decorators/bind.md +0 -77
  466. package/docs/src/docs/decorators/get.md +0 -160
  467. package/docs/src/docs/decorators/handle.md +0 -119
  468. package/docs/src/docs/decorators/on-assign.md +0 -63
  469. package/docs/src/docs/decorators/patch.md +0 -44
  470. package/docs/src/docs/decorators/post.md +0 -134
  471. package/docs/src/docs/decorators/publish.md +0 -56
  472. package/docs/src/docs/decorators/put.md +0 -51
  473. package/docs/src/docs/decorators/subscribe.md +0 -87
  474. package/docs/src/docs/decorators/wait-for-ancestors.md +0 -76
  475. package/docs/src/docs/directives/sub.md +0 -75
  476. package/docs/src/docs/directives/t.md +0 -73
  477. package/docs/src/docs/getting-started/components.md +0 -5
  478. package/docs/src/docs/getting-started/create-a-component.md +0 -136
  479. package/docs/src/docs/getting-started/dataFlow.md +0 -87
  480. package/docs/src/docs/getting-started/installation.md +0 -36
  481. package/docs/src/docs/misc/docs-mock-api.md +0 -62
  482. package/docs/src/docs/misc/dynamic-path.md +0 -71
  483. package/docs/src/docs/misc/endpoint.md +0 -45
  484. package/docs/src/docs/misc/html-integration.md +0 -14
  485. /package/{docs → dist}/img/concorde/plane_01.jpg +0 -0
  486. /package/{docs → dist}/img/concorde/plane_02.jpg +0 -0
  487. /package/{docs → dist}/img/concorde/plane_03.jpg +0 -0
  488. /package/{docs → dist}/img/concorde/plane_04.jpg +0 -0
  489. /package/{docs → dist}/img/concorde/plane_05.jpg +0 -0
  490. /package/{docs → dist}/img/concorde/plane_06.jpg +0 -0
  491. /package/{docs → dist}/img/concorde/plane_07.jpg +0 -0
  492. /package/{docs → dist}/img/concorde/plane_08.jpg +0 -0
  493. /package/{docs → dist}/img/concorde/plane_09.jpg +0 -0
  494. /package/{docs → dist}/img/concorde/plane_10.jpg +0 -0
  495. /package/{docs → dist}/img/concorde/plane_11.jpg +0 -0
  496. /package/{docs → dist}/img/concorde/plane_12.jpg +0 -0
  497. /package/{docs → dist}/img/concorde/plane_13.jpg +0 -0
package/docs/docs/decorators/on-assign.html DELETED
@@ -1,72 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/on-assign" data-doc-id="docs/decorators/on-assign">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>@onAssign — Concorde by Supersoniks</title>
7
- <meta name="description" content="Legacy decorator that calls a method with the values at one or more string paths of the store, once all of them are defined. For new code, use @handle with { waitForAllDefined: true }: same behaviour,">
8
- <meta name="keywords" content="Concorde, supersoniks, docs/decorators/on-assign, on-assign, @onAssign, decorator, onAssign, { waitForAllDefined: true }, DataProviderKey, null, undefined, connectedCallback, disconnectedCallback, ${prop}, @handle">
9
- <meta name="concorde-doc-id" content="docs/decorators/on-assign">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/on-assign">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/on-assign.md">
12
- </head>
13
- <body>
14
- <header>
15
- <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/decorators/on-assign">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
16
- </header>
17
- <main>
18
- <article>
19
- <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @onAssign</strong>. Legacy decorator that calls a method with the values at one or more string paths of the store, once all of them are defined. For new code, use @handle with { waitForAllDefined: true }: same behaviour, <span>Doc ID: <code>docs/decorators/on-assign</code>. Keywords: Concorde, supersoniks, docs/decorators/on-assign, on-assign, @onAssign, decorator, onAssign, { waitForAllDefined: true }, DataProviderKey, null, undefined, connectedCallback, disconnectedCallback, ${prop}, @handle. URL: <a href="https://concorde.supersoniks.org/docs/decorators/on-assign">https://concorde.supersoniks.org/docs/decorators/on-assign</a>.</span></p>
20
- <h1 id="onassign">@onAssign</h1>
21
- <p>Legacy decorator that calls a method with the values at one or more string paths of the store, once all of them are defined. For new code, use <a href="/docs/decorators/handle">@handle</a> with <code>{ waitForAllDefined: true }</code>: same behaviour, with typed <code>DataProviderKey</code> paths.</p>
22
- <h2 id="import">Import</h2>
23
- <pre><code class="language-typescript">import { onAssign } from &quot;@supersoniks/concorde/decorators&quot;;
24
-
25
- @onAssign(&quot;passenger&quot;, &quot;passengerSettings&quot;)
26
- onReady(passenger: Passenger, settings: Settings) {}
27
- </code></pre>
28
- <h2 id="wait-for-every-path">Wait for every path</h2>
29
- <p>The method is called only when every path holds a value other than <code>null</code> or <code>undefined</code>, with the values in the order of the paths. After that, each assignment calls it again with the latest values. Subscriptions start after <code>connectedCallback</code> and stop in <code>disconnectedCallback</code>.</p>
30
- <pre><code>&lt;docs-demo-sources for=&quot;demo-on-assign&quot;&gt;&lt;/docs-demo-sources&gt;
31
- &lt;demo-on-assign&gt;&lt;/demo-on-assign&gt;
32
- </code></pre>
33
- <h2 id="dynamic-path">Dynamic path</h2>
34
- <p>Paths accept <code>${prop}</code> placeholders resolved on the host. While a placeholder is <code>null</code> or <code>undefined</code>, that path is unsubscribed. Write the paths as plain strings, not template literals. Rules: <a href="/docs/misc/dynamic-path">Dynamic path placeholders</a>.</p>
35
- <pre><code class="language-typescript">@property({ type: Number }) seat = 0;
36
-
37
- @onAssign(&quot;passengers.${seat}&quot;, &quot;passengerSettings.${seat}&quot;)
38
- onSeat(passenger: Passenger, settings: Settings) {}
39
- </code></pre>
40
- <h2 id="migrate-to-handle">Migrate to @handle</h2>
41
- <pre><code class="language-typescript">// Before
42
- @onAssign(&quot;passenger&quot;, &quot;passengerSettings&quot;)
43
- onReady(passenger: any, settings: any) {}
44
-
45
- // After
46
- const passengerKey = new DataProviderKey&amp;lt;Passenger&amp;gt;(&quot;passenger&quot;);
47
- const settingsKey = new DataProviderKey&amp;lt;Settings&amp;gt;(&quot;passengerSettings&quot;);
48
-
49
- @handle(passengerKey, settingsKey, { waitForAllDefined: true })
50
- onReady(passenger: Passenger, settings: Settings) {}
51
- </code></pre>
52
- <p><code>@handle</code> accepts up to three keys. For more paths, keep <code>@onAssign</code> or split the logic into several <code>@handle</code> methods.</p>
53
- <h2 id="api-reference">API reference</h2>
54
- <table>
55
- <thead>
56
- <tr>
57
- <th>Argument</th>
58
- <th>Type</th>
59
- <th>Description</th>
60
- </tr>
61
- </thead>
62
- <tbody><tr>
63
- <td><code>...paths</code></td>
64
- <td><code>string[]</code></td>
65
- <td>Dot paths in the store (<code>&quot;flights.0.status&quot;</code>), optionally with <code>${prop}</code> placeholders; the method receives one argument per path, in order</td>
66
- </tr>
67
- </tbody></table>
68
-
69
- </article>
70
- </main>
71
- </body>
72
- </html>
package/docs/docs/decorators/on-assign.md DELETED
@@ -1,63 +0,0 @@
1
- # @onAssign
2
-
3
- Legacy decorator that calls a method with the values at one or more string paths of the store, once all of them are defined. For new code, use [@handle](/docs/decorators/handle) with `{ waitForAllDefined: true }`: same behaviour, with typed `DataProviderKey` paths.
4
-
5
- ## Import
6
-
7
- <sonic-code language="typescript">
8
- <template>
9
- import { onAssign } from "@supersoniks/concorde/decorators";
10
-
11
- @onAssign("passenger", "passengerSettings")
12
- onReady(passenger: Passenger, settings: Settings) {}
13
- </template>
14
- </sonic-code>
15
-
16
- ## Wait for every path
17
-
18
- The method is called only when every path holds a value other than `null` or `undefined`, with the values in the order of the paths. After that, each assignment calls it again with the latest values. Subscriptions start after `connectedCallback` and stop in `disconnectedCallback`.
19
-
20
- <sonic-code>
21
- <template>
22
- <docs-demo-sources for="demo-on-assign"></docs-demo-sources>
23
- <demo-on-assign></demo-on-assign>
24
- </template>
25
- </sonic-code>
26
-
27
- ## Dynamic path
28
-
29
- Paths accept `${prop}` placeholders resolved on the host. While a placeholder is `null` or `undefined`, that path is unsubscribed. Write the paths as plain strings, not template literals. Rules: [Dynamic path placeholders](/docs/misc/dynamic-path).
30
-
31
- <sonic-code language="typescript">
32
- <template>
33
- @property({ type: Number }) seat = 0;
34
-
35
- @onAssign("passengers.${seat}", "passengerSettings.${seat}")
36
- onSeat(passenger: Passenger, settings: Settings) {}
37
- </template>
38
- </sonic-code>
39
-
40
- ## Migrate to @handle
41
-
42
- <sonic-code language="typescript">
43
- <template>
44
- // Before
45
- @onAssign("passenger", "passengerSettings")
46
- onReady(passenger: any, settings: any) {}
47
-
48
- // After
49
- const passengerKey = new DataProviderKey&lt;Passenger&gt;("passenger");
50
- const settingsKey = new DataProviderKey&lt;Settings&gt;("passengerSettings");
51
-
52
- @handle(passengerKey, settingsKey, { waitForAllDefined: true })
53
- onReady(passenger: Passenger, settings: Settings) {}
54
- </template>
55
- </sonic-code>
56
-
57
- `@handle` accepts up to three keys. For more paths, keep `@onAssign` or split the logic into several `@handle` methods.
58
-
59
- ## API reference
60
-
61
- | Argument | Type | Description |
62
- |----------|------|-------------|
63
- | `...paths` | `string[]` | Dot paths in the store (`"flights.0.status"`), optionally with `${prop}` placeholders; the method receives one argument per path, in order |
package/docs/docs/decorators/patch.html DELETED
@@ -1,76 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/patch" data-doc-id="docs/decorators/patch">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>@patch — Concorde by Supersoniks</title>
7
- <meta name="description" content="Sends the value of a publisher as the body of a PATCH request, to update part of a resource, and stores the response in an ApiResult&lt;T&gt; property. It takes the same arguments, options and send(componen">
8
- <meta name="keywords" content="Concorde, supersoniks, docs/decorators/patch, patch, @patch, decorator, PATCH, ApiResult, send(component), send, endpoint, Endpoint, bodyKey, DataProviderKey, configurationKey">
9
- <meta name="concorde-doc-id" content="docs/decorators/patch">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/patch">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/patch.md">
12
- </head>
13
- <body>
14
- <header>
15
- <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/decorators/patch">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
16
- </header>
17
- <main>
18
- <article>
19
- <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @patch</strong>. Sends the value of a publisher as the body of a PATCH request, to update part of a resource, and stores the response in an ApiResult&lt;T&gt; property. It takes the same arguments, options and send(componen <span>Doc ID: <code>docs/decorators/patch</code>. Keywords: Concorde, supersoniks, docs/decorators/patch, patch, @patch, decorator, PATCH, ApiResult, send(component), send, endpoint, Endpoint, bodyKey, DataProviderKey, configurationKey. URL: <a href="https://concorde.supersoniks.org/docs/decorators/patch">https://concorde.supersoniks.org/docs/decorators/patch</a>.</span></p>
20
- <h1 id="patch">@patch</h1>
21
- <p>Sends the value of a publisher as the body of a <code>PATCH</code> request, to update part of a resource, and stores the response in an <code>ApiResult&lt;T&gt;</code> property. It takes the same arguments, options and <code>send(component)</code> handle as <a href="/docs/decorators/post">@post</a>; only the HTTP method differs.</p>
22
- <h2 id="import">Import</h2>
23
- <pre><code class="language-typescript">import { patch, type ApiResult } from &quot;@supersoniks/concorde/decorators&quot;;
24
- import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
25
- import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
26
- </code></pre>
27
- <h2 id="basic-usage">Basic usage</h2>
28
- <p>The body holds only the fields to change, here a gate change for flight CN 001.</p>
29
- <pre><code class="language-typescript">type Flight = { flight: string; route: string; gate: string };
30
-
31
- const gateChangeKey = new DataProviderKey&amp;lt;Partial&amp;lt;Flight&amp;gt;&amp;gt;(&quot;gateChange&quot;);
32
-
33
- @patch(new Endpoint&amp;lt;Flight&amp;gt;(&quot;flights/CN001&quot;), gateChangeKey)
34
- @state()
35
- payload?: ApiResult&amp;lt;Flight&amp;gt;;
36
-
37
- moveToB12() {
38
- set(gateChangeKey, { gate: &quot;B12&quot; }); // sends the PATCH
39
- }
40
- </code></pre>
41
- <p>Triggers, the <code>send</code> method decorator and every option are described on <a href="/docs/decorators/post">@post</a>.</p>
42
- <h2 id="api-reference">API reference</h2>
43
- <table>
44
- <thead>
45
- <tr>
46
- <th>Argument</th>
47
- <th>Type</th>
48
- <th>Description</th>
49
- </tr>
50
- </thead>
51
- <tbody><tr>
52
- <td><code>endpoint</code></td>
53
- <td><code>Endpoint&lt;T&gt;</code></td>
54
- <td>Resource path and response type</td>
55
- </tr>
56
- <tr>
57
- <td><code>bodyKey</code></td>
58
- <td><code>DataProviderKey&lt;B&gt;</code></td>
59
- <td>Publisher read as the partial body</td>
60
- </tr>
61
- <tr>
62
- <td><code>configurationKey</code></td>
63
- <td><code>DataProviderKey&lt;APIConfiguration&gt;</code> (optional)</td>
64
- <td>API configuration publisher. Default: HTML scope</td>
65
- </tr>
66
- <tr>
67
- <td><code>options</code></td>
68
- <td><code>PatchOptions</code></td>
69
- <td>Same as <a href="/docs/decorators/post">@post options</a></td>
70
- </tr>
71
- </tbody></table>
72
-
73
- </article>
74
- </main>
75
- </body>
76
- </html>
package/docs/docs/decorators/patch.md DELETED
@@ -1,44 +0,0 @@
1
- # @patch
2
-
3
- Sends the value of a publisher as the body of a `PATCH` request, to update part of a resource, and stores the response in an `ApiResult<T>` property. It takes the same arguments, options and `send(component)` handle as [@post](/docs/decorators/post); only the HTTP method differs.
4
-
5
- ## Import
6
-
7
- <sonic-code language="typescript">
8
- <template>
9
- import { patch, type ApiResult } from "@supersoniks/concorde/decorators";
10
- import { DataProviderKey } from "@supersoniks/concorde/dataProviderKey";
11
- import { Endpoint } from "@supersoniks/concorde/utils/endpoint";
12
- </template>
13
- </sonic-code>
14
-
15
- ## Basic usage
16
-
17
- The body holds only the fields to change, here a gate change for flight CN 001.
18
-
19
- <sonic-code language="typescript">
20
- <template>
21
- type Flight = { flight: string; route: string; gate: string };
22
-
23
- const gateChangeKey = new DataProviderKey&lt;Partial&lt;Flight&gt;&gt;("gateChange");
24
-
25
- @patch(new Endpoint&lt;Flight&gt;("flights/CN001"), gateChangeKey)
26
- @state()
27
- payload?: ApiResult&lt;Flight&gt;;
28
-
29
- moveToB12() {
30
- set(gateChangeKey, { gate: "B12" }); // sends the PATCH
31
- }
32
- </template>
33
- </sonic-code>
34
-
35
- Triggers, the `send` method decorator and every option are described on [@post](/docs/decorators/post).
36
-
37
- ## API reference
38
-
39
- | Argument | Type | Description |
40
- |----------|------|-------------|
41
- | `endpoint` | `Endpoint<T>` | Resource path and response type |
42
- | `bodyKey` | `DataProviderKey<B>` | Publisher read as the partial body |
43
- | `configurationKey` | `DataProviderKey<APIConfiguration>` (optional) | API configuration publisher. Default: HTML scope |
44
- | `options` | `PatchOptions` | Same as [@post options](/docs/decorators/post) |
package/docs/docs/decorators/post.html DELETED
@@ -1,150 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/post" data-doc-id="docs/decorators/post">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>@post — Concorde by Supersoniks</title>
7
- <meta name="description" content="Sends the value of a publisher as the body of a POST request and stores the response in an ApiResult&lt;T&gt; property. Pass an Endpoint and a DataProviderKey for the body; the request runs on connect and a">
8
- <meta name="keywords" content="Concorde, supersoniks, docs/decorators/post, post, @post, decorator, POST, ApiResult, undefined, request, response, result, POST /docs-mock-api/api/register, send(component), Promise | undefined&gt;">
9
- <meta name="concorde-doc-id" content="docs/decorators/post">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/post">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/post.md">
12
- </head>
13
- <body>
14
- <header>
15
- <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/decorators/post">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
16
- </header>
17
- <main>
18
- <article>
19
- <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @post</strong>. Sends the value of a publisher as the body of a POST request and stores the response in an ApiResult&lt;T&gt; property. Pass an Endpoint and a DataProviderKey for the body; the request runs on connect and a <span>Doc ID: <code>docs/decorators/post</code>. Keywords: Concorde, supersoniks, docs/decorators/post, post, @post, decorator, POST, ApiResult, undefined, request, response, result, POST /docs-mock-api/api/register, send(component), Promise | undefined&gt;. URL: <a href="https://concorde.supersoniks.org/docs/decorators/post">https://concorde.supersoniks.org/docs/decorators/post</a>.</span></p>
20
- <h1 id="post">@post</h1>
21
- <p>Sends the value of a publisher as the body of a <code>POST</code> request and stores the response in an <code>ApiResult&lt;T&gt;</code> property. Pass an <a href="/docs/misc/endpoint">Endpoint</a> and a <a href="/docs/misc/dataProviderKey">DataProviderKey</a> for the body; the request runs on connect and again whenever the body changes. <a href="/docs/decorators/put">@put</a> and <a href="/docs/decorators/patch">@patch</a> work the same way.</p>
22
- <h2 id="import">Import</h2>
23
- <pre><code class="language-typescript">import { post, type ApiResult } from &quot;@supersoniks/concorde/decorators&quot;;
24
- import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
25
- import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
26
-
27
- type SignUp = { email: string; password: string };
28
- type CrewMember = { id: number; email: string };
29
-
30
- const signUpKey = new DataProviderKey&amp;lt;SignUp&amp;gt;(&quot;crewSignUp&quot;);
31
-
32
- @post(new Endpoint&amp;lt;CrewMember&amp;gt;(&quot;api/register&quot;), signUpKey)
33
- @state()
34
- payload?: ApiResult&amp;lt;CrewMember&amp;gt;;
35
- </code></pre>
36
- <h2 id="basic-usage">Basic usage</h2>
37
- <p>The property is <code>undefined</code> until a response arrives, then holds <code>request</code> · <code>response</code> · the typed <code>result</code>. Each body mutation sends a new request; mutations in the same frame are coalesced into one. The demo posts to the local mock <code>POST /docs-mock-api/api/register</code>.</p>
38
- <pre><code>&lt;docs-demo-sources for=&quot;demo-api-post&quot;&gt;&lt;/docs-demo-sources&gt;
39
- &lt;demo-api-post&gt;&lt;/demo-api-post&gt;
40
- </code></pre>
41
- <h2 id="method-form">Method form</h2>
42
- <p>On a method, the decorator calls it with the full <code>ApiResult&lt;T&gt;</code> after each request instead of assigning a property.</p>
43
- <pre><code>&lt;docs-demo-sources for=&quot;demo-api-post-method&quot;&gt;&lt;/docs-demo-sources&gt;
44
- &lt;demo-api-post-method&gt;&lt;/demo-api-post-method&gt;
45
- </code></pre>
46
- <h2 id="sending-again">Sending again</h2>
47
- <p>Keep the decorator in a constant to call <code>send(component)</code>. It reads the current body and returns a <code>Promise&lt;ApiResult&lt;T&gt; | undefined&gt;</code> resolved once the request completes. Use it for &quot;Save&quot; or &quot;Retry&quot; buttons.</p>
48
- <pre><code class="language-typescript">const signUp = post(new Endpoint&amp;lt;CrewMember&amp;gt;(&quot;api/register&quot;), signUpKey);
49
-
50
- @signUp
51
- @state()
52
- payload?: ApiResult&amp;lt;CrewMember&amp;gt;;
53
-
54
- async retry() {
55
- const payload = await signUp.send(this);
56
- console.log(payload?.result?.id);
57
- }
58
- </code></pre>
59
- <p>The <code>send</code> method decorator does the same around a method. It runs after the method by default (waiting for a returned Promise); <code>{ when: &quot;before&quot; }</code> sends first.</p>
60
- <pre><code class="language-typescript">import { send } from &quot;@supersoniks/concorde/decorators&quot;;
61
-
62
- @send(signUp)
63
- async confirmCheckIn() {
64
- // Validate the check-in form, then the POST is sent.
65
- }
66
- </code></pre>
67
- <h2 id="manual-trigger">Manual trigger</h2>
68
- <p>Set <code>autoPostOnBodyMutation: false</code> when the body is edited field by field (a check-in form) and the request must only go out on <code>send()</code> or <code>triggerKey</code>. A <code>triggerKey</code> publisher lets another component resend: calling <code>invalidate()</code> on it sends the current body.</p>
69
- <pre><code class="language-typescript">const submitKey = new DataProviderKey&amp;lt;number&amp;gt;(&quot;checkInSubmit&quot;);
70
-
71
- @post(checkInEndpoint, checkInKey, {
72
- autoPostOnBodyMutation: false,
73
- triggerKey: submitKey,
74
- })
75
- @state()
76
- payload?: ApiResult&amp;lt;CheckIn&amp;gt;;
77
-
78
- // Anywhere: dp(submitKey).invalidate();
79
- </code></pre>
80
- <p>By default (<code>skipIfBodyMissing: true</code>) nothing is sent while the body is <code>null</code> or <code>undefined</code>. <code>refetchEveryMs</code> repeats the request at a fixed interval after each response; use it only when repeating the operation is safe.</p>
81
- <h2 id="api-configuration">API configuration</h2>
82
- <p>Without a configuration key, <code>serviceURL</code> and credentials come from the HTML scope, as with <a href="/docs/decorators/get">@get</a>. Pass a <code>DataProviderKey&lt;APIConfiguration&gt;</code> as third argument to read them from a publisher; options then move to the fourth argument. See <a href="/docs/misc/api-configuration">API configuration</a>.</p>
83
- <pre><code class="language-typescript">@post(signUpEndpoint, signUpKey, apiConfigurationKey, { skipIfBodyMissing: false })
84
- </code></pre>
85
- <h2 id="dynamic-path">Dynamic path</h2>
86
- <p>Placeholders in the endpoint (<code>${flight}</code>) are read from the host component; changing the property sends the same body to the new URL. See <a href="/docs/misc/dynamic-path">Dynamic paths</a>.</p>
87
- <pre><code>&lt;docs-demo-sources for=&quot;demo-api-post-dynamic&quot;&gt;&lt;/docs-demo-sources&gt;
88
- &lt;demo-api-post-dynamic&gt;&lt;/demo-api-post-dynamic&gt;
89
- </code></pre>
90
- <h2 id="api-reference">API reference</h2>
91
- <p><code>post(endpoint, bodyKey, configurationKey?, options?)</code> returns a decorator for a property or a method, with a <code>send(component)</code> method.</p>
92
- <table>
93
- <thead>
94
- <tr>
95
- <th>Argument</th>
96
- <th>Type</th>
97
- <th>Description</th>
98
- </tr>
99
- </thead>
100
- <tbody><tr>
101
- <td><code>endpoint</code></td>
102
- <td><code>Endpoint&lt;T&gt;</code></td>
103
- <td>Path and response type. Supports <code>${prop}</code> placeholders</td>
104
- </tr>
105
- <tr>
106
- <td><code>bodyKey</code></td>
107
- <td><code>DataProviderKey&lt;B&gt;</code></td>
108
- <td>Publisher read as request body</td>
109
- </tr>
110
- <tr>
111
- <td><code>configurationKey</code></td>
112
- <td><code>DataProviderKey&lt;APIConfiguration&gt;</code> (optional)</td>
113
- <td>API configuration publisher. Default: HTML scope</td>
114
- </tr>
115
- <tr>
116
- <td><code>options.autoPostOnBodyMutation</code></td>
117
- <td><code>boolean</code> (default <code>true</code>)</td>
118
- <td>Send on connect and after each body mutation</td>
119
- </tr>
120
- <tr>
121
- <td><code>options.skipIfBodyMissing</code></td>
122
- <td><code>boolean</code> (default <code>true</code>)</td>
123
- <td>Skip while the body is <code>null</code> or <code>undefined</code></td>
124
- </tr>
125
- <tr>
126
- <td><code>options.triggerKey</code></td>
127
- <td><code>DataProviderKey&lt;unknown&gt;</code></td>
128
- <td>Publisher whose <code>invalidate()</code> resends</td>
129
- </tr>
130
- <tr>
131
- <td><code>options.refetchEveryMs</code></td>
132
- <td><code>number</code> (default <code>0</code>, off)</td>
133
- <td>Resend interval in ms after each response</td>
134
- </tr>
135
- <tr>
136
- <td><code>options.skipEmptyPlaceholder</code></td>
137
- <td><code>boolean</code> (default <code>false</code>)</td>
138
- <td>Treat a placeholder resolved to <code>&quot;&quot;</code> as not ready</td>
139
- </tr>
140
- <tr>
141
- <td><code>send(handle, { when })</code></td>
142
- <td><code>&quot;after&quot;</code> (default) or <code>&quot;before&quot;</code></td>
143
- <td>Method decorator sending after or before the method</td>
144
- </tr>
145
- </tbody></table>
146
-
147
- </article>
148
- </main>
149
- </body>
150
- </html>
package/docs/docs/decorators/post.md DELETED
@@ -1,134 +0,0 @@
1
- # @post
2
-
3
- Sends the value of a publisher as the body of a `POST` request and stores the response in an `ApiResult<T>` property. Pass an [Endpoint](/docs/misc/endpoint) and a [DataProviderKey](/docs/misc/dataProviderKey) for the body; the request runs on connect and again whenever the body changes. [@put](/docs/decorators/put) and [@patch](/docs/decorators/patch) work the same way.
4
-
5
- ## Import
6
-
7
- <sonic-code language="typescript">
8
- <template>
9
- import { post, type ApiResult } from "@supersoniks/concorde/decorators";
10
- import { DataProviderKey } from "@supersoniks/concorde/dataProviderKey";
11
- import { Endpoint } from "@supersoniks/concorde/utils/endpoint";
12
-
13
- type SignUp = { email: string; password: string };
14
- type CrewMember = { id: number; email: string };
15
-
16
- const signUpKey = new DataProviderKey&lt;SignUp&gt;("crewSignUp");
17
-
18
- @post(new Endpoint&lt;CrewMember&gt;("api/register"), signUpKey)
19
- @state()
20
- payload?: ApiResult&lt;CrewMember&gt;;
21
- </template>
22
- </sonic-code>
23
-
24
- ## Basic usage
25
-
26
- The property is `undefined` until a response arrives, then holds `request` · `response` · the typed `result`. Each body mutation sends a new request; mutations in the same frame are coalesced into one. The demo posts to the local mock `POST /docs-mock-api/api/register`.
27
-
28
- <sonic-code>
29
- <template>
30
- <docs-demo-sources for="demo-api-post"></docs-demo-sources>
31
- <demo-api-post></demo-api-post>
32
- </template>
33
- </sonic-code>
34
-
35
- ## Method form
36
-
37
- On a method, the decorator calls it with the full `ApiResult<T>` after each request instead of assigning a property.
38
-
39
- <sonic-code>
40
- <template>
41
- <docs-demo-sources for="demo-api-post-method"></docs-demo-sources>
42
- <demo-api-post-method></demo-api-post-method>
43
- </template>
44
- </sonic-code>
45
-
46
- ## Sending again
47
-
48
- Keep the decorator in a constant to call `send(component)`. It reads the current body and returns a `Promise<ApiResult<T> | undefined>` resolved once the request completes. Use it for "Save" or "Retry" buttons.
49
-
50
- <sonic-code language="typescript">
51
- <template>
52
- const signUp = post(new Endpoint&lt;CrewMember&gt;("api/register"), signUpKey);
53
-
54
- @signUp
55
- @state()
56
- payload?: ApiResult&lt;CrewMember&gt;;
57
-
58
- async retry() {
59
- const payload = await signUp.send(this);
60
- console.log(payload?.result?.id);
61
- }
62
- </template>
63
- </sonic-code>
64
-
65
- The `send` method decorator does the same around a method. It runs after the method by default (waiting for a returned Promise); `{ when: "before" }` sends first.
66
-
67
- <sonic-code language="typescript">
68
- <template>
69
- import { send } from "@supersoniks/concorde/decorators";
70
-
71
- @send(signUp)
72
- async confirmCheckIn() {
73
- // Validate the check-in form, then the POST is sent.
74
- }
75
- </template>
76
- </sonic-code>
77
-
78
- ## Manual trigger
79
-
80
- Set `autoPostOnBodyMutation: false` when the body is edited field by field (a check-in form) and the request must only go out on `send()` or `triggerKey`. A `triggerKey` publisher lets another component resend: calling `invalidate()` on it sends the current body.
81
-
82
- <sonic-code language="typescript">
83
- <template>
84
- const submitKey = new DataProviderKey&lt;number&gt;("checkInSubmit");
85
-
86
- @post(checkInEndpoint, checkInKey, {
87
- autoPostOnBodyMutation: false,
88
- triggerKey: submitKey,
89
- })
90
- @state()
91
- payload?: ApiResult&lt;CheckIn&gt;;
92
-
93
- // Anywhere: dp(submitKey).invalidate();
94
- </template>
95
- </sonic-code>
96
-
97
- By default (`skipIfBodyMissing: true`) nothing is sent while the body is `null` or `undefined`. `refetchEveryMs` repeats the request at a fixed interval after each response; use it only when repeating the operation is safe.
98
-
99
- ## API configuration
100
-
101
- Without a configuration key, `serviceURL` and credentials come from the HTML scope, as with [@get](/docs/decorators/get). Pass a `DataProviderKey<APIConfiguration>` as third argument to read them from a publisher; options then move to the fourth argument. See [API configuration](/docs/misc/api-configuration).
102
-
103
- <sonic-code language="typescript">
104
- <template>
105
- @post(signUpEndpoint, signUpKey, apiConfigurationKey, { skipIfBodyMissing: false })
106
- </template>
107
- </sonic-code>
108
-
109
- ## Dynamic path
110
-
111
- Placeholders in the endpoint (`${flight}`) are read from the host component; changing the property sends the same body to the new URL. See [Dynamic paths](/docs/misc/dynamic-path).
112
-
113
- <sonic-code>
114
- <template>
115
- <docs-demo-sources for="demo-api-post-dynamic"></docs-demo-sources>
116
- <demo-api-post-dynamic></demo-api-post-dynamic>
117
- </template>
118
- </sonic-code>
119
-
120
- ## API reference
121
-
122
- `post(endpoint, bodyKey, configurationKey?, options?)` returns a decorator for a property or a method, with a `send(component)` method.
123
-
124
- | Argument | Type | Description |
125
- |----------|------|-------------|
126
- | `endpoint` | `Endpoint<T>` | Path and response type. Supports `${prop}` placeholders |
127
- | `bodyKey` | `DataProviderKey<B>` | Publisher read as request body |
128
- | `configurationKey` | `DataProviderKey<APIConfiguration>` (optional) | API configuration publisher. Default: HTML scope |
129
- | `options.autoPostOnBodyMutation` | `boolean` (default `true`) | Send on connect and after each body mutation |
130
- | `options.skipIfBodyMissing` | `boolean` (default `true`) | Skip while the body is `null` or `undefined` |
131
- | `options.triggerKey` | `DataProviderKey<unknown>` | Publisher whose `invalidate()` resends |
132
- | `options.refetchEveryMs` | `number` (default `0`, off) | Resend interval in ms after each response |
133
- | `options.skipEmptyPlaceholder` | `boolean` (default `false`) | Treat a placeholder resolved to `""` as not ready |
134
- | `send(handle, { when })` | `"after"` (default) or `"before"` | Method decorator sending after or before the method |
package/docs/docs/decorators/publish.html DELETED
@@ -1,74 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/publish" data-doc-id="docs/decorators/publish">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>@publish — Concorde by Supersoniks</title>
7
- <meta name="description" content="@publish(key) writes a component property to one path of the store: every assignment to the property is published there. It never reads back from the store; it is the inverse of @subscribe. See Data f">
8
- <meta name="keywords" content="Concorde, supersoniks, docs/decorators/publish, publish, @publish, decorator, @publish(key), set(), undefined, reflect: true, passenger, seat, ${prop}, null, skipEmptyPlaceholder">
9
- <meta name="concorde-doc-id" content="docs/decorators/publish">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/publish">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/publish.md">
12
- </head>
13
- <body>
14
- <header>
15
- <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/decorators/publish">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
16
- </header>
17
- <main>
18
- <article>
19
- <p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @publish</strong>. @publish(key) writes a component property to one path of the store: every assignment to the property is published there. It never reads back from the store; it is the inverse of @subscribe. See Data f <span>Doc ID: <code>docs/decorators/publish</code>. Keywords: Concorde, supersoniks, docs/decorators/publish, publish, @publish, decorator, @publish(key), set(), undefined, reflect: true, passenger, seat, ${prop}, null, skipEmptyPlaceholder. URL: <a href="https://concorde.supersoniks.org/docs/decorators/publish">https://concorde.supersoniks.org/docs/decorators/publish</a>.</span></p>
20
- <h1 id="publish">@publish</h1>
21
- <p><code>@publish(key)</code> writes a component property to one path of the store: every assignment to the property is published there. It never reads back from the store; it is the inverse of <a href="/docs/decorators/subscribe">@subscribe</a>. See <a href="/docs/getting-started/dataFlow">Data flow</a> for the overall model.</p>
22
- <h2 id="import">Import</h2>
23
- <pre><code class="language-typescript">import { publish } from &quot;@supersoniks/concorde/decorators&quot;;
24
- import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
25
-
26
- type CheckIn = { passenger: string; seat: string };
27
- const checkInKey = new DataProviderKey&amp;lt;CheckIn&amp;gt;(&quot;checkIn&quot;);
28
-
29
- @publish(checkInKey.passenger)
30
- @state()
31
- passenger = &quot;Ada Lindqvist&quot;;
32
- </code></pre>
33
- <h2 id="basic-usage">Basic usage</h2>
34
- <p>Each assignment calls <code>set()</code> on the publisher at the <a href="/docs/misc/dataProviderKey">DataProviderKey</a> path. <strong>On connect, a defined property value is published immediately</strong>, so the initializer overwrites what the store held. Leave the property <code>undefined</code> to keep the store value. To read and write the same path, use <a href="/docs/decorators/bind">@bind</a> with <code>reflect: true</code>.</p>
35
- <p>The check-in form below publishes <code>passenger</code> and <code>seat</code>; the boarding pass reads them back with <a href="/docs/directives/sub">sub()</a>.</p>
36
- <pre><code>&lt;docs-demo-sources for=&quot;demo-publish&quot;&gt;&lt;/docs-demo-sources&gt;
37
- &lt;demo-publish&gt;&lt;/demo-publish&gt;
38
- </code></pre>
39
- <h2 id="dynamic-path">Dynamic path</h2>
40
- <p><code>${prop}</code> placeholders resolve from properties of the same component. When a placeholder changes, the property is published to the new path. While it is <code>null</code> or <code>undefined</code>, nothing is published. Rules and <code>skipEmptyPlaceholder</code>: <a href="/docs/misc/dynamic-path">Dynamic paths</a>.</p>
41
- <pre><code class="language-typescript">@property({ type: Number }) seatIndex = 0;
42
-
43
- @publish(
44
- new DataProviderKey&amp;lt;string, { seatIndex: number }&amp;gt;(&quot;onBoard.${seatIndex}.seat&quot;),
45
- { skipEmptyPlaceholder: true },
46
- )
47
- @state()
48
- seat = &quot;1A&quot;;
49
- </code></pre>
50
- <h2 id="api-reference">API reference</h2>
51
- <table>
52
- <thead>
53
- <tr>
54
- <th>Argument</th>
55
- <th>Type</th>
56
- <th>Description</th>
57
- </tr>
58
- </thead>
59
- <tbody><tr>
60
- <td><code>key</code></td>
61
- <td><code>DataProviderKey&lt;T, U&gt;</code></td>
62
- <td>Path to write. <code>U</code> lists the host properties used by <code>${…}</code> placeholders</td>
63
- </tr>
64
- <tr>
65
- <td><code>options.skipEmptyPlaceholder</code></td>
66
- <td><code>boolean</code> (default <code>false</code>)</td>
67
- <td>Treat a placeholder resolved to <code>&quot;&quot;</code> as not ready</td>
68
- </tr>
69
- </tbody></table>
70
-
71
- </article>
72
- </main>
73
- </body>
74
- </html>