@supersoniks/concorde 5.1.1 → 5.1.3

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 (494) hide show
  1. package/.agents/skills/concorde-docs/SKILL.md +153 -0
  2. package/.agents/skills/{concorde-component-docs/template.md → concorde-docs/templates/component.md} +6 -2
  3. package/.agents/skills/concorde-docs/templates/decorator.md +43 -0
  4. package/.agents/skills/concorde-docs/templates/guide.md +25 -0
  5. package/PLAN-DOCS-AGENTS.md +80 -0
  6. package/README.md +4 -4
  7. package/ai/README.md +29 -41
  8. package/ai/skills/concorde/SKILL.md +54 -324
  9. package/ai/skills/concorde/rules/composition.md +32 -0
  10. package/ai/skills/concorde/rules/data.md +47 -0
  11. package/ai/skills/concorde/rules/http.md +25 -0
  12. package/ai/skills/concorde/rules/lists-forms.md +35 -0
  13. package/ai/skills/concorde/rules/styling.md +46 -0
  14. package/ai/skills/concorde/rules/troubleshooting.md +45 -0
  15. package/build-infos.json +1 -1
  16. package/concorde-core.bundle.js +21 -21
  17. package/concorde-core.es.js +977 -980
  18. package/custom-elements-manifest.public.config.mjs +8 -0
  19. package/{.tmp-cem/custom-elements.json → custom-elements.json} +11758 -8904
  20. package/dist/concorde-core.bundle.js +21 -21
  21. package/dist/concorde-core.es.js +977 -980
  22. package/dist/docs-mock-api-sw.js +58 -223
  23. package/dist/docs-mock-api-sw.js.map +4 -4
  24. package/dist/img/concorde/plane_01.jpg +0 -0
  25. package/dist/img/concorde/plane_02.jpg +0 -0
  26. package/dist/img/concorde/plane_03.jpg +0 -0
  27. package/dist/img/concorde/plane_04.jpg +0 -0
  28. package/dist/img/concorde/plane_05.jpg +0 -0
  29. package/dist/img/concorde/plane_06.jpg +0 -0
  30. package/dist/img/concorde/plane_07.jpg +0 -0
  31. package/dist/img/concorde/plane_08.jpg +0 -0
  32. package/dist/img/concorde/plane_09.jpg +0 -0
  33. package/dist/img/concorde/plane_10.jpg +0 -0
  34. package/dist/img/concorde/plane_11.jpg +0 -0
  35. package/dist/img/concorde/plane_12.jpg +0 -0
  36. package/dist/img/concorde/plane_13.jpg +0 -0
  37. package/dist/img/og-concorde.jpg +0 -0
  38. package/dist/robots.txt +11 -10
  39. package/docs/.htaccess +82 -0
  40. package/docs/404.html +15 -0
  41. package/docs/404.md +5 -0
  42. package/docs/about.html +111 -0
  43. package/docs/about.md +22 -0
  44. package/docs/assets/{index-Bb-_LRyY.js → index-6sS76xWj.js} +2625 -3158
  45. package/docs/assets/index-DkdPbH0F.css +1 -0
  46. package/docs/core/components/functional/date/date.html +211 -0
  47. package/docs/core/components/functional/date/date.md +150 -0
  48. package/docs/core/components/functional/fetch/fetch.html +180 -0
  49. package/docs/core/components/functional/fetch/fetch.md +108 -0
  50. package/docs/core/components/functional/if/if.html +65 -0
  51. package/docs/core/components/functional/if/if.md +34 -0
  52. package/docs/core/components/functional/jsonata/jsonata.html +110 -0
  53. package/docs/core/components/functional/jsonata/jsonata.md +61 -0
  54. package/docs/core/components/functional/list/list.html +200 -0
  55. package/docs/core/components/functional/list/list.md +125 -0
  56. package/docs/core/components/functional/mix/mix.html +78 -0
  57. package/docs/core/components/functional/mix/mix.md +46 -0
  58. package/docs/core/components/functional/queue/queue.html +155 -0
  59. package/docs/core/components/functional/queue/queue.md +51 -0
  60. package/docs/core/components/functional/router/router.html +154 -0
  61. package/docs/core/components/functional/router/router.md +93 -0
  62. package/docs/core/components/functional/sdui/sdui-extension-points.html +127 -0
  63. package/docs/core/components/functional/sdui/sdui-extension-points.md +94 -0
  64. package/docs/core/components/functional/sdui/sdui.html +397 -0
  65. package/docs/core/components/functional/sdui/sdui.md +307 -0
  66. package/docs/core/components/functional/states/states.html +141 -0
  67. package/docs/core/components/functional/states/states.md +112 -0
  68. package/docs/core/components/functional/submit/submit.html +178 -0
  69. package/docs/core/components/functional/submit/submit.md +106 -0
  70. package/docs/core/components/functional/subscriber/subscriber.html +68 -0
  71. package/docs/core/components/functional/subscriber/subscriber.md +91 -0
  72. package/docs/core/components/functional/translation/translation.html +60 -0
  73. package/docs/core/components/functional/translation/translation.md +38 -0
  74. package/docs/core/components/functional/value/value.html +81 -0
  75. package/docs/core/components/functional/value/value.md +47 -0
  76. package/docs/core/components/ui/alert/alert.html +201 -0
  77. package/docs/core/components/ui/alert/alert.md +186 -0
  78. package/docs/core/components/ui/alert-messages/alert-messages.html +132 -0
  79. package/docs/core/components/ui/alert-messages/alert-messages.md +85 -0
  80. package/docs/core/components/ui/badge/badge.html +197 -0
  81. package/docs/core/components/ui/badge/badge.md +181 -0
  82. package/docs/core/components/ui/button/button.html +309 -0
  83. package/docs/core/components/ui/button/button.md +216 -0
  84. package/docs/core/components/ui/captcha/captcha.html +80 -0
  85. package/docs/core/components/ui/captcha/captcha.md +56 -0
  86. package/docs/core/components/ui/card/card.html +254 -0
  87. package/docs/core/components/ui/card/card.md +215 -0
  88. package/docs/core/components/ui/divider/divider.html +144 -0
  89. package/docs/core/components/ui/divider/divider.md +126 -0
  90. package/docs/core/components/ui/form/checkbox/checkbox.html +200 -0
  91. package/docs/core/components/ui/form/checkbox/checkbox.md +125 -0
  92. package/docs/core/components/ui/form/fieldset/fieldset.html +238 -0
  93. package/docs/core/components/ui/form/fieldset/fieldset.md +161 -0
  94. package/docs/core/components/ui/form/form-actions/form-actions.html +122 -0
  95. package/docs/core/components/ui/form/form-actions/form-actions.md +98 -0
  96. package/docs/core/components/ui/form/form-layout/form-layout.html +115 -0
  97. package/docs/core/components/ui/form/form-layout/form-layout.md +109 -0
  98. package/docs/core/components/ui/form/input/input.html +235 -0
  99. package/docs/core/components/ui/form/input/input.md +142 -0
  100. package/docs/core/components/ui/form/radio/radio.html +144 -0
  101. package/docs/core/components/ui/form/radio/radio.md +78 -0
  102. package/docs/core/components/ui/form/select/select.html +178 -0
  103. package/docs/core/components/ui/form/select/select.md +86 -0
  104. package/docs/core/components/ui/form/switch/switch.html +146 -0
  105. package/docs/core/components/ui/form/switch/switch.md +80 -0
  106. package/docs/core/components/ui/form/textarea/textarea.html +162 -0
  107. package/docs/core/components/ui/form/textarea/textarea.md +82 -0
  108. package/docs/core/components/ui/group/group.html +113 -0
  109. package/docs/core/components/ui/group/group.md +77 -0
  110. package/docs/core/components/ui/icon/icon.html +223 -0
  111. package/docs/core/components/ui/icon/icon.md +214 -0
  112. package/docs/core/components/ui/image/image.html +194 -0
  113. package/docs/core/components/ui/image/image.md +167 -0
  114. package/docs/core/components/ui/link/link.html +101 -0
  115. package/docs/core/components/ui/link/link.md +81 -0
  116. package/docs/core/components/ui/loader/loader.html +114 -0
  117. package/docs/core/components/ui/loader/loader.md +87 -0
  118. package/docs/core/components/ui/menu/menu.html +395 -0
  119. package/docs/core/components/ui/menu/menu.md +370 -0
  120. package/docs/core/components/ui/modal/modal.html +324 -0
  121. package/docs/core/components/ui/modal/modal.md +211 -0
  122. package/docs/core/components/ui/pop/pop.html +250 -0
  123. package/docs/core/components/ui/pop/pop.md +216 -0
  124. package/docs/core/components/ui/progress/progress.html +132 -0
  125. package/docs/core/components/ui/progress/progress.md +109 -0
  126. package/docs/core/components/ui/table/table.html +333 -0
  127. package/docs/core/components/ui/table/table.md +267 -0
  128. package/docs/core/components/ui/theme/theme.html +116 -0
  129. package/docs/core/components/ui/theme/theme.md +97 -0
  130. package/docs/core/components/ui/toast/toast.html +185 -0
  131. package/docs/core/components/ui/toast/toast.md +147 -0
  132. package/docs/core/components/ui/tooltip/tooltip.html +112 -0
  133. package/docs/core/components/ui/tooltip/tooltip.md +89 -0
  134. package/docs/custom-elements.json +16559 -0
  135. package/docs/docs/decorators/ancestor-attribute.html +71 -0
  136. package/docs/docs/decorators/ancestor-attribute.md +59 -0
  137. package/docs/docs/decorators/auto-subscribe.html +61 -0
  138. package/docs/docs/decorators/auto-subscribe.md +40 -0
  139. package/docs/docs/decorators/bind.html +87 -0
  140. package/docs/docs/decorators/bind.md +76 -0
  141. package/docs/docs/decorators/get.html +166 -0
  142. package/docs/docs/decorators/get.md +160 -0
  143. package/docs/docs/decorators/handle.html +139 -0
  144. package/docs/docs/decorators/handle.md +119 -0
  145. package/docs/docs/decorators/on-assign.html +72 -0
  146. package/docs/docs/decorators/on-assign.md +63 -0
  147. package/docs/docs/decorators/patch.html +76 -0
  148. package/docs/docs/decorators/patch.md +44 -0
  149. package/docs/docs/decorators/post.html +150 -0
  150. package/docs/docs/decorators/post.md +134 -0
  151. package/docs/docs/decorators/publish.html +74 -0
  152. package/docs/docs/decorators/publish.md +56 -0
  153. package/docs/docs/decorators/put.html +83 -0
  154. package/docs/docs/decorators/put.md +51 -0
  155. package/docs/docs/decorators/subscribe.html +91 -0
  156. package/docs/docs/decorators/subscribe.md +87 -0
  157. package/docs/docs/decorators/wait-for-ancestors.html +82 -0
  158. package/docs/docs/decorators/wait-for-ancestors.md +76 -0
  159. package/docs/docs/directives/sub.html +79 -0
  160. package/docs/docs/directives/sub.md +75 -0
  161. package/docs/docs/directives/t.html +91 -0
  162. package/docs/docs/directives/t.md +73 -0
  163. package/docs/docs/getting-started/ai-agents.html +130 -0
  164. package/docs/docs/getting-started/ai-agents.md +50 -0
  165. package/docs/docs/getting-started/components.html +27 -0
  166. package/docs/docs/getting-started/create-a-component.html +108 -0
  167. package/{src/docs/_getting-started → docs/docs/getting-started}/create-a-component.md +3 -6
  168. package/docs/docs/getting-started/dataFlow.html +174 -0
  169. package/{src/docs/_core-concept → docs/docs/getting-started}/dataFlow.md +18 -19
  170. package/docs/docs/getting-started/installation.html +69 -0
  171. package/docs/docs/getting-started/installation.md +36 -0
  172. package/docs/docs/getting-started/my-first-component.html +180 -0
  173. package/{src/docs/_getting-started → docs/docs/getting-started}/my-first-component.md +5 -14
  174. package/docs/docs/getting-started/start.html +47 -0
  175. package/{src/docs/_getting-started → docs/docs/getting-started}/start.md +1 -13
  176. package/docs/docs/getting-started/theming.html +334 -0
  177. package/docs/docs/index.html +99 -0
  178. package/docs/docs/misc/api-configuration.html +149 -0
  179. package/{src/docs/_misc → docs/docs/misc}/api-configuration.md +10 -12
  180. package/docs/docs/misc/dataProviderKey.html +136 -0
  181. package/{src/docs/_misc → docs/docs/misc}/dataProviderKey.md +4 -4
  182. package/docs/docs/misc/docs-mock-api.html +155 -0
  183. package/{src/docs/_misc → docs/docs/misc}/docs-mock-api.md +12 -13
  184. package/docs/docs/misc/dynamic-path.html +181 -0
  185. package/{src/docs/_misc → docs/docs/misc}/dynamic-path.md +8 -8
  186. package/docs/docs/misc/endpoint.html +51 -0
  187. package/{src/docs/_misc → docs/docs/misc}/endpoint.md +8 -8
  188. package/docs/docs/misc/html-integration.html +45 -0
  189. package/{src/docs/_misc → docs/docs/misc}/html-integration.md +4 -5
  190. package/docs/docs-mock-api-sw.js +58 -223
  191. package/docs/docs-mock-api-sw.js.map +4 -4
  192. package/docs/hubs/decorators.html +438 -0
  193. package/docs/hubs/form-components.html +404 -0
  194. package/docs/hubs/remote-data.html +367 -0
  195. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  196. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  197. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  198. package/docs/img/archive/credits.json +28 -0
  199. package/docs/img/concorde/plane_01.jpg +0 -0
  200. package/docs/img/concorde/plane_02.jpg +0 -0
  201. package/docs/img/concorde/plane_03.jpg +0 -0
  202. package/docs/img/concorde/plane_04.jpg +0 -0
  203. package/docs/img/concorde/plane_05.jpg +0 -0
  204. package/docs/img/concorde/plane_06.jpg +0 -0
  205. package/docs/img/concorde/plane_07.jpg +0 -0
  206. package/docs/img/concorde/plane_08.jpg +0 -0
  207. package/docs/img/concorde/plane_09.jpg +0 -0
  208. package/docs/img/concorde/plane_10.jpg +0 -0
  209. package/docs/img/concorde/plane_11.jpg +0 -0
  210. package/docs/img/concorde/plane_12.jpg +0 -0
  211. package/docs/img/concorde/plane_13.jpg +0 -0
  212. package/docs/img/og-concorde.jpg +0 -0
  213. package/docs/index.html +184 -68
  214. package/docs/index.md +22 -0
  215. package/docs/llms-full.txt +5779 -0
  216. package/docs/llms.txt +108 -0
  217. package/docs/privacy.html +122 -0
  218. package/docs/privacy.md +32 -0
  219. package/docs/robots.txt +11 -10
  220. package/docs/sitemap.xml +243 -0
  221. package/docs/src/core/components/functional/date/date.md +150 -0
  222. package/docs/src/core/components/functional/fetch/fetch.md +108 -0
  223. package/docs/src/core/components/functional/if/if.md +34 -0
  224. package/docs/src/core/components/functional/jsonata/jsonata.md +61 -0
  225. package/docs/src/core/components/functional/list/list.md +125 -0
  226. package/docs/src/core/components/functional/mix/mix.md +46 -0
  227. package/docs/src/core/components/functional/queue/queue.md +51 -0
  228. package/docs/src/core/components/functional/router/router.md +93 -0
  229. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  230. package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
  231. package/docs/src/core/components/functional/sdui/default-library.json +108 -0
  232. package/docs/src/core/components/functional/sdui/example.json +32 -0
  233. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  234. package/docs/src/core/components/functional/sdui/sdui.md +307 -0
  235. package/docs/src/core/components/functional/states/states.md +112 -0
  236. package/docs/src/core/components/functional/submit/submit.md +106 -0
  237. package/docs/src/core/components/functional/subscriber/subscriber.md +91 -0
  238. package/docs/src/core/components/functional/translation/translation.md +38 -0
  239. package/docs/src/core/components/functional/value/value.md +47 -0
  240. package/docs/src/core/components/ui/alert/alert.md +186 -0
  241. package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
  242. package/docs/src/core/components/ui/badge/badge.md +181 -0
  243. package/docs/src/core/components/ui/button/button.md +216 -0
  244. package/docs/src/core/components/ui/captcha/captcha.md +56 -0
  245. package/docs/src/core/components/ui/card/card.md +215 -0
  246. package/docs/src/core/components/ui/divider/divider.md +126 -0
  247. package/docs/src/core/components/ui/form/checkbox/checkbox.md +125 -0
  248. package/docs/src/core/components/ui/form/fieldset/fieldset.md +161 -0
  249. package/docs/src/core/components/ui/form/form-actions/form-actions.md +98 -0
  250. package/docs/src/core/components/ui/form/form-layout/form-layout.md +109 -0
  251. package/docs/src/core/components/ui/form/input/input.md +142 -0
  252. package/docs/src/core/components/ui/form/radio/radio.md +78 -0
  253. package/docs/src/core/components/ui/form/select/select.md +86 -0
  254. package/docs/src/core/components/ui/form/switch/switch.md +80 -0
  255. package/docs/src/core/components/ui/form/textarea/textarea.md +82 -0
  256. package/docs/src/core/components/ui/group/group.md +77 -0
  257. package/docs/src/core/components/ui/icon/icon.md +214 -0
  258. package/docs/src/core/components/ui/icon/icons.json +1 -0
  259. package/docs/src/core/components/ui/image/image.md +167 -0
  260. package/docs/src/core/components/ui/link/link.md +81 -0
  261. package/docs/src/core/components/ui/loader/loader.md +87 -0
  262. package/docs/src/core/components/ui/menu/menu.md +370 -0
  263. package/docs/src/core/components/ui/modal/modal.md +211 -0
  264. package/docs/src/core/components/ui/pop/pop.md +216 -0
  265. package/docs/src/core/components/ui/progress/progress.md +109 -0
  266. package/docs/src/core/components/ui/table/table.md +267 -0
  267. package/docs/src/core/components/ui/theme/theme.md +97 -0
  268. package/docs/src/core/components/ui/toast/toast.md +147 -0
  269. package/docs/src/core/components/ui/tooltip/tooltip.md +89 -0
  270. package/docs/src/docs/decorators/ancestor-attribute.md +59 -0
  271. package/docs/src/docs/decorators/auto-subscribe.md +40 -0
  272. package/docs/src/docs/decorators/bind.md +76 -0
  273. package/docs/src/docs/decorators/get.md +160 -0
  274. package/docs/src/docs/decorators/handle.md +119 -0
  275. package/docs/src/docs/decorators/on-assign.md +63 -0
  276. package/docs/src/docs/decorators/patch.md +44 -0
  277. package/docs/src/docs/decorators/post.md +134 -0
  278. package/docs/src/docs/decorators/publish.md +56 -0
  279. package/docs/src/docs/decorators/put.md +51 -0
  280. package/docs/src/docs/decorators/subscribe.md +87 -0
  281. package/docs/src/docs/decorators/wait-for-ancestors.md +76 -0
  282. package/docs/src/docs/directives/sub.md +75 -0
  283. package/docs/src/docs/directives/t.md +73 -0
  284. package/docs/src/docs/getting-started/ai-agents.md +50 -0
  285. package/docs/src/docs/getting-started/components.md +5 -0
  286. package/docs/src/docs/getting-started/create-a-component.md +136 -0
  287. package/docs/src/docs/getting-started/dataFlow.md +87 -0
  288. package/docs/src/docs/getting-started/installation.md +36 -0
  289. package/docs/src/docs/getting-started/my-first-component.md +227 -0
  290. package/docs/src/docs/getting-started/start.md +35 -0
  291. package/docs/src/docs/getting-started/theming.md +253 -0
  292. package/docs/src/docs/misc/api-configuration.md +79 -0
  293. package/docs/src/docs/misc/dataProviderKey.md +168 -0
  294. package/docs/src/docs/misc/docs-mock-api.md +62 -0
  295. package/docs/src/docs/misc/dynamic-path.md +71 -0
  296. package/docs/src/docs/misc/endpoint.md +45 -0
  297. package/docs/src/docs/misc/html-integration.md +14 -0
  298. package/docs/src/docs/search/docs-search.json +10332 -0
  299. package/docs/src/tag-list.json +1 -0
  300. package/docs/src/tsconfig-model.json +23 -0
  301. package/docs/src/tsconfig.json +1359 -0
  302. package/index.html +157 -5
  303. package/package.json +8 -4
  304. package/public/docs-mock-api-sw.js +58 -223
  305. package/public/docs-mock-api-sw.js.map +4 -4
  306. package/public/img/concorde/plane_01.jpg +0 -0
  307. package/public/img/concorde/plane_02.jpg +0 -0
  308. package/public/img/concorde/plane_03.jpg +0 -0
  309. package/public/img/concorde/plane_04.jpg +0 -0
  310. package/public/img/concorde/plane_05.jpg +0 -0
  311. package/public/img/concorde/plane_06.jpg +0 -0
  312. package/public/img/concorde/plane_07.jpg +0 -0
  313. package/public/img/concorde/plane_08.jpg +0 -0
  314. package/public/img/concorde/plane_09.jpg +0 -0
  315. package/public/img/concorde/plane_10.jpg +0 -0
  316. package/public/img/concorde/plane_11.jpg +0 -0
  317. package/public/img/concorde/plane_12.jpg +0 -0
  318. package/public/img/concorde/plane_13.jpg +0 -0
  319. package/public/img/og-concorde.jpg +0 -0
  320. package/public/robots.txt +11 -10
  321. package/scripts/ai-init.mjs +104 -379
  322. package/scripts/ai-init.test.mjs +81 -239
  323. package/scripts/docs-markdown-vite-plugin.ts +43 -0
  324. package/scripts/docs-public-url.mjs +56 -0
  325. package/scripts/docs.htaccess +82 -0
  326. package/scripts/generate-cem.mjs +244 -0
  327. package/scripts/generate-cem.test.mjs +122 -0
  328. package/scripts/generate-crawl-docs.mjs +233 -118
  329. package/scripts/generate-crawl-docs.test.mjs +124 -0
  330. package/scripts/generate-sdui-catalog.mjs +11 -10
  331. package/scripts/post-build-docs.js +37 -50
  332. package/scripts/pre-publish.mjs +2 -1
  333. package/scripts/site-pages.mjs +212 -0
  334. package/scripts/site-pages.test.mjs +116 -0
  335. package/site-pages/about.md +22 -0
  336. package/site-pages/privacy.md +32 -0
  337. package/src/core/components/functional/date/date.md +91 -231
  338. package/src/core/components/functional/fetch/fetch.md +66 -83
  339. package/src/core/components/functional/if/if.md +28 -3
  340. package/src/core/components/functional/jsonata/jsonata.md +42 -37
  341. package/src/core/components/functional/list/list.md +103 -43
  342. package/src/core/components/functional/mix/mix.md +31 -26
  343. package/src/core/components/functional/queue/queue.demo.ts +10 -7
  344. package/src/core/components/functional/queue/queue.md +40 -61
  345. package/src/core/components/functional/router/router.demo.ts +16 -16
  346. package/src/core/components/functional/router/router.md +64 -65
  347. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  348. package/src/core/components/functional/sdui/component-catalog.json +1 -1
  349. package/src/core/components/functional/sdui/example.json +19 -86
  350. package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  351. package/src/core/components/functional/sdui/sdui.md +187 -358
  352. package/src/core/components/functional/states/states.demo.ts +21 -22
  353. package/src/core/components/functional/states/states.md +86 -61
  354. package/src/core/components/functional/states/states.ts +1 -1
  355. package/src/core/components/functional/submit/submit.md +64 -72
  356. package/src/core/components/functional/translation/translation.md +38 -0
  357. package/src/core/components/functional/value/value.md +34 -22
  358. package/src/core/components/ui/alert/alert.md +48 -58
  359. package/src/core/components/ui/badge/badge.md +27 -34
  360. package/src/core/components/ui/button/button.md +139 -106
  361. package/src/core/components/ui/captcha/captcha.md +17 -32
  362. package/src/core/components/ui/card/card.md +6 -6
  363. package/src/core/components/ui/divider/divider.md +8 -11
  364. package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  365. package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
  366. package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
  367. package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
  368. package/src/core/components/ui/form/input/input.md +95 -95
  369. package/src/core/components/ui/form/radio/radio.md +55 -34
  370. package/src/core/components/ui/form/select/select.md +60 -45
  371. package/src/core/components/ui/form/switch/switch.md +57 -34
  372. package/src/core/components/ui/form/textarea/textarea.md +55 -38
  373. package/src/core/components/ui/group/group.md +35 -33
  374. package/src/core/components/ui/icon/icon.md +4 -4
  375. package/src/core/components/ui/image/image.md +41 -107
  376. package/src/core/components/ui/link/link.md +6 -6
  377. package/src/core/components/ui/loader/loader.md +30 -55
  378. package/src/core/components/ui/menu/menu.md +27 -27
  379. package/src/core/components/ui/modal/modal.md +72 -96
  380. package/src/core/components/ui/pop/pop.md +80 -158
  381. package/src/core/components/ui/progress/progress.md +2 -2
  382. package/src/core/components/ui/table/table.md +91 -255
  383. package/src/core/components/ui/theme/theme.md +11 -36
  384. package/src/core/components/ui/toast/toast.md +48 -117
  385. package/src/core/components/ui/tooltip/tooltip.md +27 -62
  386. package/src/core/decorators/subscriber/bind.ts +9 -14
  387. package/src/core/utils/LocationHandler.spec.ts +80 -0
  388. package/src/core/utils/LocationHandler.ts +5 -9
  389. package/src/docs/components/docs-demo-sources.ts +55 -140
  390. package/src/docs/components/docs-lit-demo.ts +1 -3
  391. package/src/docs/components/docs-source-link.ts +0 -82
  392. package/src/docs/decorators/ancestor-attribute.md +59 -0
  393. package/src/docs/decorators/auto-subscribe.md +40 -0
  394. package/src/docs/decorators/bind.md +76 -0
  395. package/src/docs/decorators/get.md +160 -0
  396. package/src/docs/decorators/handle.md +119 -0
  397. package/src/docs/decorators/on-assign.md +63 -0
  398. package/src/docs/decorators/patch.md +44 -0
  399. package/src/docs/decorators/post.md +134 -0
  400. package/src/docs/decorators/publish.md +56 -0
  401. package/src/docs/decorators/put.md +51 -0
  402. package/src/docs/decorators/subscribe.md +87 -0
  403. package/src/docs/decorators/wait-for-ancestors.md +76 -0
  404. package/src/docs/directives/sub.md +75 -0
  405. package/src/docs/directives/t.md +73 -0
  406. package/src/docs/docs-location.spec.ts +56 -0
  407. package/src/docs/docs-location.ts +133 -32
  408. package/src/docs/docs.ts +1 -2
  409. package/src/docs/example/decorators-demo-bind-demos.ts +83 -135
  410. package/src/docs/example/decorators-demo-geo.ts +30 -19
  411. package/src/docs/example/decorators-demo-post.ts +88 -186
  412. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
  413. package/src/docs/example/decorators-demo.ts +85 -98
  414. package/src/docs/example/docs-api-config-demos.ts +19 -20
  415. package/src/docs/example/docs-flight-demos.ts +147 -0
  416. package/src/docs/example/docs-jsonata-demos.ts +52 -52
  417. package/src/docs/example/docs-list-demos.ts +43 -123
  418. package/src/docs/example/docs-provider-keys.ts +21 -28
  419. package/src/docs/example/docs-queue-demos.ts +37 -77
  420. package/src/docs/example/docs-router-demos.ts +20 -25
  421. package/src/docs/example/docs-submit-demos.ts +48 -48
  422. package/src/docs/example/docs-toggle-demos.ts +4 -3
  423. package/src/docs/getting-started/ai-agents.md +50 -0
  424. package/src/docs/getting-started/components.md +5 -0
  425. package/src/docs/getting-started/create-a-component.md +136 -0
  426. package/src/docs/getting-started/dataFlow.md +87 -0
  427. package/src/docs/getting-started/installation.md +36 -0
  428. package/src/docs/getting-started/my-first-component.md +227 -0
  429. package/src/docs/getting-started/start.md +35 -0
  430. package/src/docs/getting-started/theming.md +253 -0
  431. package/src/docs/header/header.ts +11 -6
  432. package/src/docs/home/catalog.ts +1 -1
  433. package/src/docs/home/home.ts +20 -11
  434. package/src/docs/layout.ts +12 -13
  435. package/src/docs/misc/api-configuration.md +79 -0
  436. package/src/docs/misc/dataProviderKey.md +168 -0
  437. package/src/docs/misc/docs-mock-api.md +62 -0
  438. package/src/docs/misc/dynamic-path.md +71 -0
  439. package/src/docs/misc/endpoint.md +45 -0
  440. package/src/docs/misc/html-integration.md +14 -0
  441. package/src/docs/mock-api/api-config-mock.ts +5 -0
  442. package/src/docs/mock-api/fixtures.ts +0 -278
  443. package/src/docs/mock-api/flights.ts +89 -0
  444. package/src/docs/mock-api/router.ts +3 -4
  445. package/src/docs/mock-api/urls.ts +1 -2
  446. package/src/docs/navigation/navigation.ts +82 -103
  447. package/src/docs/navigation/toc.ts +7 -4
  448. package/src/docs/search/docs-search.json +2804 -5024
  449. package/src/docs/search/markdown-renderer.ts +31 -8
  450. package/src/docs/search/page.ts +9 -6
  451. package/src/docs/search/search.ts +154 -122
  452. package/src/docs/tailwind/css/docs/content.css +4 -5
  453. package/src/tsconfig.json +11 -5
  454. package/src/tsconfig.tsbuildinfo +1 -1
  455. package/vite.config.mts +11 -2
  456. package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
  457. package/ai/AGENTS.md +0 -56
  458. package/ai/cursor/rules/concorde-menu.mdc +0 -15
  459. package/ai/cursor/rules/concorde-scope.mdc +0 -14
  460. package/ai/cursor/rules/concorde-theme.mdc +0 -13
  461. package/ai/cursor/rules/concorde.mdc +0 -66
  462. package/ai/jetbrains/rules/concorde.md +0 -53
  463. package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
  464. package/ai/skills/concorde-imports/SKILL.md +0 -78
  465. package/ai/skills/concorde-menu/SKILL.md +0 -74
  466. package/ai/skills/concorde-scope/SKILL.md +0 -70
  467. package/ai/skills/concorde-theme/SKILL.md +0 -57
  468. package/docs/assets/index-CD4WyL6o.css +0 -1
  469. package/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  470. package/src/docs/_core-concept/overview.md +0 -57
  471. package/src/docs/_core-concept/subscriber.md +0 -75
  472. package/src/docs/_decorators/ancestor-attribute.md +0 -128
  473. package/src/docs/_decorators/auto-subscribe.md +0 -202
  474. package/src/docs/_decorators/bind.md +0 -167
  475. package/src/docs/_decorators/get.md +0 -162
  476. package/src/docs/_decorators/handle.md +0 -175
  477. package/src/docs/_decorators/on-assign.md +0 -390
  478. package/src/docs/_decorators/patch.md +0 -70
  479. package/src/docs/_decorators/post.md +0 -146
  480. package/src/docs/_decorators/publish.md +0 -55
  481. package/src/docs/_decorators/put.md +0 -70
  482. package/src/docs/_decorators/subscribe.md +0 -100
  483. package/src/docs/_decorators/wait-for-ancestors.md +0 -163
  484. package/src/docs/_directives/sub.md +0 -91
  485. package/src/docs/_getting-started/ai-agents.md +0 -76
  486. package/src/docs/_getting-started/concorde-manual-install.md +0 -133
  487. package/src/docs/_getting-started/concorde-outside.md +0 -33
  488. package/src/docs/_getting-started/my-first-subscriber.md +0 -120
  489. package/src/docs/_getting-started/pubsub.md +0 -37
  490. package/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  491. package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
  492. package/src/docs/example/docs-joke-demos.ts +0 -297
  493. /package/{src/docs/_getting-started → docs/docs/getting-started}/components.md +0 -0
  494. /package/{src/docs/_getting-started → docs/docs/getting-started}/theming.md +0 -0
package/docs/docs/decorators/ancestor-attribute.html ADDED
@@ -0,0 +1,71 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute" data-doc-id="docs/decorators/ancestor-attribute">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>@ancestorAttribute — Concorde by Supersoniks</title>
7
+ <meta name="description" content="Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as dataProvid">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/decorators/ancestor-attribute, ancestor-attribute, @ancestorAttribute, decorator, ancestorAttribute, dataProvider, connectedCallback, , &quot;&quot;, dataprovider, { dynamic: true }, null, @state(), &quot;${dataProvider}&quot;">
9
+ <meta name="concorde-doc-id" content="docs/decorators/ancestor-attribute">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute.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/ancestor-attribute">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 — @ancestorAttribute</strong>. Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as dataProvid <span>Doc ID: <code>docs/decorators/ancestor-attribute</code>. Keywords: Concorde, supersoniks, docs/decorators/ancestor-attribute, ancestor-attribute, @ancestorAttribute, decorator, ancestorAttribute, dataProvider, connectedCallback, , &quot;&quot;, dataprovider, { dynamic: true }, null, @state(), &quot;${dataProvider}&quot;. URL: <a href="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute">https://concorde.supersoniks.org/docs/decorators/ancestor-attribute</a>.</span></p>
20
+ <h1 id="ancestorattribute">@ancestorAttribute</h1>
21
+ <p>Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as <code>dataProvider</code> without passing it down by hand, typically to feed a dynamic key of <a href="/docs/decorators/subscribe">@subscribe</a>.</p>
22
+ <h2 id="import">Import</h2>
23
+ <pre><code class="language-typescript">import { ancestorAttribute } from &quot;@supersoniks/concorde/decorators&quot;;
24
+
25
+ @ancestorAttribute(&quot;dataProvider&quot;)
26
+ dataProvider: string | null = null;
27
+ </code></pre>
28
+ <h2 id="read-once-at-connect">Read once at connect</h2>
29
+ <p>By default the value is read once, just before the component&#39;s <code>connectedCallback</code>, and never updated. The closest element with the attribute wins. If no ancestor has it, the property keeps its initial value.</p>
30
+ <pre><code>&lt;div dataProvider=&quot;flights.CN001&quot; gate=&quot;B12&quot;&gt;
31
+ &lt;docs-demo-sources for=&quot;demo-ancestor-attribute&quot;&gt;&lt;/docs-demo-sources&gt;
32
+ &lt;demo-ancestor-attribute&gt;&lt;/demo-ancestor-attribute&gt;
33
+ &lt;/div&gt;
34
+ </code></pre>
35
+ <p>An attribute present without a value (<code>&lt;div gate&gt;</code>) resolves to <code>&quot;&quot;</code>. A camelCase name also matches its lowercase form (<code>dataProvider</code> and <code>dataprovider</code>).</p>
36
+ <h2 id="follow-dom-changes">Follow DOM changes</h2>
37
+ <p>With <code>{ dynamic: true }</code>, the property stays in sync while the component is connected: when an ancestor changes the attribute, when a closer ancestor gains or loses it, and when the component is moved. When no ancestor has the attribute, the property becomes <code>null</code>. Add <code>@state()</code> so Lit re-renders on each assignment.</p>
38
+ <pre><code class="language-typescript">@ancestorAttribute(&quot;dataProvider&quot;, { dynamic: true })
39
+ @state()
40
+ dataProvider: string | null = null;
41
+ </code></pre>
42
+ <p>Change the parent or outer value, insert a closer wrapper, or remove an attribute: the child always shows the nearest one.</p>
43
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-ancestor-attribute-dynamic-section&quot;&gt;&lt;/docs-demo-sources&gt;
44
+ &lt;demo-ancestor-attribute-dynamic-section&gt;&lt;/demo-ancestor-attribute-dynamic-section&gt;
45
+ </code></pre>
46
+ <p>Keys of <a href="/docs/decorators/subscribe">@subscribe</a> and <a href="/docs/decorators/bind">@bind</a> that use the property as a placeholder (<code>&quot;${dataProvider}&quot;</code>) are re-resolved on each change.</p>
47
+ <h2 id="api-reference">API reference</h2>
48
+ <table>
49
+ <thead>
50
+ <tr>
51
+ <th>Argument</th>
52
+ <th>Type</th>
53
+ <th>Description</th>
54
+ </tr>
55
+ </thead>
56
+ <tbody><tr>
57
+ <td><code>attributeName</code></td>
58
+ <td><code>string</code></td>
59
+ <td>Attribute to look up on the host, then on its ancestors</td>
60
+ </tr>
61
+ <tr>
62
+ <td><code>options.dynamic</code></td>
63
+ <td><code>boolean</code> (default <code>false</code>)</td>
64
+ <td>Keep the property in sync with attribute changes and reparenting until disconnect; assigns <code>null</code> when no ancestor has the attribute</td>
65
+ </tr>
66
+ </tbody></table>
67
+
68
+ </article>
69
+ </main>
70
+ </body>
71
+ </html>
package/docs/docs/decorators/ancestor-attribute.md ADDED
@@ -0,0 +1,59 @@
1
+ # @ancestorAttribute
2
+
3
+ Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as `dataProvider` without passing it down by hand, typically to feed a dynamic key of [@subscribe](/docs/decorators/subscribe).
4
+
5
+ ## Import
6
+
7
+ <sonic-code language="typescript">
8
+ <template>
9
+ import { ancestorAttribute } from "@supersoniks/concorde/decorators";
10
+
11
+ @ancestorAttribute("dataProvider")
12
+ dataProvider: string | null = null;
13
+ </template>
14
+ </sonic-code>
15
+
16
+ ## Read once at connect
17
+
18
+ By default the value is read once, just before the component's `connectedCallback`, and never updated. The closest element with the attribute wins. If no ancestor has it, the property keeps its initial value.
19
+
20
+ <sonic-code>
21
+ <template>
22
+ <div dataProvider="flights.CN001" gate="B12">
23
+ <docs-demo-sources for="demo-ancestor-attribute"></docs-demo-sources>
24
+ <demo-ancestor-attribute></demo-ancestor-attribute>
25
+ </div>
26
+ </template>
27
+ </sonic-code>
28
+
29
+ An attribute present without a value (`<div gate>`) resolves to `""`. A camelCase name also matches its lowercase form (`dataProvider` and `dataprovider`).
30
+
31
+ ## Follow DOM changes
32
+
33
+ With `{ dynamic: true }`, the property stays in sync while the component is connected: when an ancestor changes the attribute, when a closer ancestor gains or loses it, and when the component is moved. When no ancestor has the attribute, the property becomes `null`. Add `@state()` so Lit re-renders on each assignment.
34
+
35
+ <sonic-code language="typescript">
36
+ <template>
37
+ @ancestorAttribute("dataProvider", { dynamic: true })
38
+ @state()
39
+ dataProvider: string | null = null;
40
+ </template>
41
+ </sonic-code>
42
+
43
+ Change the parent or outer value, insert a closer wrapper, or remove an attribute: the child always shows the nearest one.
44
+
45
+ <sonic-code>
46
+ <template>
47
+ <docs-demo-sources for="demo-ancestor-attribute-dynamic-section"></docs-demo-sources>
48
+ <demo-ancestor-attribute-dynamic-section></demo-ancestor-attribute-dynamic-section>
49
+ </template>
50
+ </sonic-code>
51
+
52
+ Keys of [@subscribe](/docs/decorators/subscribe) and [@bind](/docs/decorators/bind) that use the property as a placeholder (`"${dataProvider}"`) are re-resolved on each change.
53
+
54
+ ## API reference
55
+
56
+ | Argument | Type | Description |
57
+ |----------|------|-------------|
58
+ | `attributeName` | `string` | Attribute to look up on the host, then on its ancestors |
59
+ | `options.dynamic` | `boolean` (default `false`) | Keep the property in sync with attribute changes and reparenting until disconnect; assigns `null` when no ancestor has the attribute |
package/docs/docs/decorators/auto-subscribe.html ADDED
@@ -0,0 +1,61 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/auto-subscribe" 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 by Supersoniks</title>
7
+ <meta name="description" content="Legacy decorator that re-runs a method whenever one of the store values it reads is assigned. For new code, prefer @subscribe with a DataProviderKey: dependencies are explicit and typed.">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/decorators/auto-subscribe, auto-subscribe, @autoSubscribe, decorator, autoSubscribe, DataProviderKey, connectedCallback, @state(), requestUpdate(), queueMicrotask, disconnectedCallback, @autoSubscribe()">
9
+ <meta name="concorde-doc-id" content="docs/decorators/auto-subscribe">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/auto-subscribe">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/auto-subscribe.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/auto-subscribe">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 — @autoSubscribe</strong>. Legacy decorator that re-runs a method whenever one of the store values it reads is assigned. For new code, prefer @subscribe with a DataProviderKey: dependencies are explicit and typed. <span>Doc ID: <code>docs/decorators/auto-subscribe</code>. Keywords: Concorde, supersoniks, docs/decorators/auto-subscribe, auto-subscribe, @autoSubscribe, decorator, autoSubscribe, DataProviderKey, connectedCallback, @state(), requestUpdate(), queueMicrotask, disconnectedCallback, @autoSubscribe(). URL: <a href="https://concorde.supersoniks.org/docs/decorators/auto-subscribe">https://concorde.supersoniks.org/docs/decorators/auto-subscribe</a>.</span></p>
20
+ <h1 id="autosubscribe">@autoSubscribe</h1>
21
+ <p>Legacy decorator that re-runs a method whenever one of the store values it reads is assigned. For new code, prefer <a href="/docs/decorators/subscribe">@subscribe</a> with a <a href="/docs/misc/dataProviderKey"><code>DataProviderKey</code></a>: dependencies are explicit and typed.</p>
22
+ <h2 id="import">Import</h2>
23
+ <pre><code class="language-typescript">import { autoSubscribe } from &quot;@supersoniks/concorde/decorators&quot;;
24
+ import { get } from &quot;@supersoniks/concorde/utils&quot;;
25
+
26
+ @autoSubscribe()
27
+ updateDisplay() {
28
+ this.total = get(passengersKey) + get(crewKey);
29
+ }
30
+ </code></pre>
31
+ <h2 id="tracked-reads">Tracked reads</h2>
32
+ <p>The method runs once after <code>connectedCallback</code>. Every store value read during that run becomes a dependency; assigning any of them runs the method again. Write the result to a <code>@state()</code> property (or call <code>requestUpdate()</code>) so the component re-renders.</p>
33
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-auto-subscribe&quot;&gt;&lt;/docs-demo-sources&gt;
34
+ &lt;demo-auto-subscribe&gt;&lt;/demo-auto-subscribe&gt;
35
+ </code></pre>
36
+ <h2 id="notes">Notes</h2>
37
+ <ul>
38
+ <li>Several assignments in the same task trigger a single re-run (batched with <code>queueMicrotask</code>).</li>
39
+ <li>Keep reads unconditional: a value read only behind a condition becomes a dependency the first time that branch runs.</li>
40
+ <li>Subscriptions are removed in <code>disconnectedCallback</code>.</li>
41
+ </ul>
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>none</td>
53
+ <td></td>
54
+ <td><code>@autoSubscribe()</code> takes no argument; apply it to a method of a custom element</td>
55
+ </tr>
56
+ </tbody></table>
57
+
58
+ </article>
59
+ </main>
60
+ </body>
61
+ </html>
package/docs/docs/decorators/auto-subscribe.md ADDED
@@ -0,0 +1,40 @@
1
+ # @autoSubscribe
2
+
3
+ Legacy decorator that re-runs a method whenever one of the store values it reads is assigned. For new code, prefer [@subscribe](/docs/decorators/subscribe) with a [`DataProviderKey`](/docs/misc/dataProviderKey): dependencies are explicit and typed.
4
+
5
+ ## Import
6
+
7
+ <sonic-code language="typescript">
8
+ <template>
9
+ import { autoSubscribe } from "@supersoniks/concorde/decorators";
10
+ import { get } from "@supersoniks/concorde/utils";
11
+
12
+ @autoSubscribe()
13
+ updateDisplay() {
14
+ this.total = get(passengersKey) + get(crewKey);
15
+ }
16
+ </template>
17
+ </sonic-code>
18
+
19
+ ## Tracked reads
20
+
21
+ The method runs once after `connectedCallback`. Every store value read during that run becomes a dependency; assigning any of them runs the method again. Write the result to a `@state()` property (or call `requestUpdate()`) so the component re-renders.
22
+
23
+ <sonic-code>
24
+ <template>
25
+ <docs-demo-sources for="demo-auto-subscribe"></docs-demo-sources>
26
+ <demo-auto-subscribe></demo-auto-subscribe>
27
+ </template>
28
+ </sonic-code>
29
+
30
+ ## Notes
31
+
32
+ - Several assignments in the same task trigger a single re-run (batched with `queueMicrotask`).
33
+ - Keep reads unconditional: a value read only behind a condition becomes a dependency the first time that branch runs.
34
+ - Subscriptions are removed in `disconnectedCallback`.
35
+
36
+ ## API reference
37
+
38
+ | Argument | Type | Description |
39
+ |----------|------|-------------|
40
+ | none | | `@autoSubscribe()` takes no argument; apply it to a method of a custom element |
package/docs/docs/decorators/bind.html ADDED
@@ -0,0 +1,87 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/bind" 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 by Supersoniks</title>
7
+ <meta name="description" content="@bind(key) keeps a class property and one path of the DataProvider store in sync. With { reflect: true } the sync goes both ways: the property follows the store, and each assignment is written back to">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/decorators/bind, bind, @bind, decorator, @bind(key), { reflect: true }, @state(), reflect: true, set(), reflect, @subscribe, ${index}">
9
+ <meta name="concorde-doc-id" content="docs/decorators/bind">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/bind">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/bind.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/bind">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 — @bind</strong>. @bind(key) keeps a class property and one path of the DataProvider store in sync. With { reflect: true } the sync goes both ways: the property follows the store, and each assignment is written back to <span>Doc ID: <code>docs/decorators/bind</code>. Keywords: Concorde, supersoniks, docs/decorators/bind, bind, @bind, decorator, @bind(key), { reflect: true }, @state(), reflect: true, set(), reflect, @subscribe, ${index}. URL: <a href="https://concorde.supersoniks.org/docs/decorators/bind">https://concorde.supersoniks.org/docs/decorators/bind</a>.</span></p>
20
+ <h1 id="bind">@bind</h1>
21
+ <p><code>@bind(key)</code> keeps a class property and one path of the DataProvider store in sync. With <code>{ reflect: true }</code> the sync goes both ways: the property follows the store, and each assignment is written back to it. For one direction only, use the complementary decorators: <a href="/docs/decorators/subscribe">@subscribe</a> to read, <a href="/docs/decorators/publish">@publish</a> to write. 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 { bind } from &quot;@supersoniks/concorde/decorators&quot;;
24
+ import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
25
+
26
+ type Flight = { flight: string; gate: string; boarded: number };
27
+ const flightKey = new DataProviderKey&amp;lt;Flight&amp;gt;(&quot;flight&quot;);
28
+
29
+ @bind(flightKey.boarded, { reflect: true })
30
+ @state()
31
+ boarded = 0;
32
+ </code></pre>
33
+ <h2 id="basic-usage">Basic usage</h2>
34
+ <p>The key is a <a href="/docs/misc/dataProviderKey">DataProviderKey</a>: TypeScript checks that the property type matches <code>T</code> at that path. The property updates each time the store value changes. Add <code>@state()</code> so Lit re-renders.</p>
35
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-bind&quot;&gt;&lt;/docs-demo-sources&gt;
36
+ &lt;demo-bind&gt;&lt;/demo-bind&gt;
37
+ </code></pre>
38
+ <h2 id="reflect">Reflect</h2>
39
+ <p>With <code>reflect: true</code>, each assignment to the property calls <code>set()</code> at the key path, so every other subscriber sees the new value. An internal guard prevents update loops. Without <code>reflect</code> (the default), assigning the property does not touch the store, and <code>@bind</code> behaves like <code>@subscribe</code>.</p>
40
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-bind-reflect&quot;&gt;&lt;/docs-demo-sources&gt;
41
+ &lt;demo-bind-reflect&gt;&lt;/demo-bind-reflect&gt;
42
+ </code></pre>
43
+ <h2 id="dynamic-path">Dynamic path</h2>
44
+ <p>Placeholders such as <code>${index}</code> are resolved from properties of the same component, and <code>@bind</code> re-subscribes when they change. Declare them in the key&#39;s second generic and write them in a plain string, not a backtick template literal. While a placeholder is <code>null</code> or <code>undefined</code> the binding is inactive; <code>{ skipEmptyPlaceholder: true }</code> also waits on <code>&quot;&quot;</code>. Full rules: <a href="/docs/misc/dynamic-path">Dynamic paths</a>.</p>
45
+ <pre><code class="language-typescript">const personKey = new DataProviderKey&amp;lt;Person, { dataProvider: string; index: number }&amp;gt;(
46
+ &quot;${dataProvider}.${index}&quot;,
47
+ );
48
+
49
+ @bind(personKey)
50
+ @state()
51
+ person: Person | null = null;
52
+ </code></pre>
53
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-bind-dynamic&quot;&gt;&lt;/docs-demo-sources&gt;
54
+ &lt;demo-bind-dynamic&gt;&lt;/demo-bind-dynamic&gt;
55
+ </code></pre>
56
+ <h2 id="lifecycle">Lifecycle</h2>
57
+ <p>The decorator subscribes in <code>connectedCallback</code> and unsubscribes in <code>disconnectedCallback</code>. It works on any element with that lifecycle (<code>LitElement</code>, the <code>Subscriber</code> mixin).</p>
58
+ <h2 id="api-reference">API reference</h2>
59
+ <table>
60
+ <thead>
61
+ <tr>
62
+ <th>Argument</th>
63
+ <th>Type</th>
64
+ <th>Description</th>
65
+ </tr>
66
+ </thead>
67
+ <tbody><tr>
68
+ <td><code>key</code></td>
69
+ <td><code>DataProviderKey&lt;T&gt;</code></td>
70
+ <td>Store path to bind. Supports <code>${prop}</code> placeholders</td>
71
+ </tr>
72
+ <tr>
73
+ <td><code>options.reflect</code></td>
74
+ <td><code>boolean</code> (default <code>false</code>)</td>
75
+ <td>Write local assignments back to the store</td>
76
+ </tr>
77
+ <tr>
78
+ <td><code>options.skipEmptyPlaceholder</code></td>
79
+ <td><code>boolean</code> (default <code>false</code>)</td>
80
+ <td>Treat a placeholder resolved to <code>&quot;&quot;</code> as not ready</td>
81
+ </tr>
82
+ </tbody></table>
83
+
84
+ </article>
85
+ </main>
86
+ </body>
87
+ </html>
package/docs/docs/decorators/bind.md ADDED
@@ -0,0 +1,76 @@
1
+ # @bind
2
+
3
+ `@bind(key)` keeps a class property and one path of the DataProvider store in sync. With `{ reflect: true }` the sync goes both ways: the property follows the store, and each assignment is written back to it. For one direction only, use the complementary decorators: [@subscribe](/docs/decorators/subscribe) to read, [@publish](/docs/decorators/publish) to write. See [Data flow](/docs/getting-started/dataFlow) for the overall model.
4
+
5
+ ## Import
6
+
7
+ <sonic-code language="typescript">
8
+ <template>
9
+ import { bind } from "@supersoniks/concorde/decorators";
10
+ import { DataProviderKey } from "@supersoniks/concorde/dataProviderKey";
11
+
12
+ type Flight = { flight: string; gate: string; boarded: number };
13
+ const flightKey = new DataProviderKey&lt;Flight&gt;("flight");
14
+
15
+ @bind(flightKey.boarded, { reflect: true })
16
+ @state()
17
+ boarded = 0;
18
+ </template>
19
+ </sonic-code>
20
+
21
+ ## Basic usage
22
+
23
+ The key is a [DataProviderKey](/docs/misc/dataProviderKey): TypeScript checks that the property type matches `T` at that path. The property updates each time the store value changes. Add `@state()` so Lit re-renders.
24
+
25
+ <sonic-code>
26
+ <template>
27
+ <docs-demo-sources for="demo-bind"></docs-demo-sources>
28
+ <demo-bind></demo-bind>
29
+ </template>
30
+ </sonic-code>
31
+
32
+ ## Reflect
33
+
34
+ With `reflect: true`, each assignment to the property calls `set()` at the key path, so every other subscriber sees the new value. An internal guard prevents update loops. Without `reflect` (the default), assigning the property does not touch the store, and `@bind` behaves like `@subscribe`.
35
+
36
+ <sonic-code>
37
+ <template>
38
+ <docs-demo-sources for="demo-bind-reflect"></docs-demo-sources>
39
+ <demo-bind-reflect></demo-bind-reflect>
40
+ </template>
41
+ </sonic-code>
42
+
43
+ ## Dynamic path
44
+
45
+ Placeholders such as `${index}` are resolved from properties of the same component, and `@bind` re-subscribes when they change. Declare them in the key's second generic and write them in a plain string, not a backtick template literal. While a placeholder is `null` or `undefined` the binding is inactive; `{ skipEmptyPlaceholder: true }` also waits on `""`. Full rules: [Dynamic paths](/docs/misc/dynamic-path).
46
+
47
+ <sonic-code language="typescript">
48
+ <template>
49
+ const personKey = new DataProviderKey&lt;Person, { dataProvider: string; index: number }&gt;(
50
+ "${dataProvider}.${index}",
51
+ );
52
+
53
+ @bind(personKey)
54
+ @state()
55
+ person: Person | null = null;
56
+ </template>
57
+ </sonic-code>
58
+
59
+ <sonic-code>
60
+ <template>
61
+ <docs-demo-sources for="demo-bind-dynamic"></docs-demo-sources>
62
+ <demo-bind-dynamic></demo-bind-dynamic>
63
+ </template>
64
+ </sonic-code>
65
+
66
+ ## Lifecycle
67
+
68
+ The decorator subscribes in `connectedCallback` and unsubscribes in `disconnectedCallback`. It works on any element with that lifecycle (`LitElement`, the `Subscriber` mixin).
69
+
70
+ ## API reference
71
+
72
+ | Argument | Type | Description |
73
+ |----------|------|-------------|
74
+ | `key` | `DataProviderKey<T>` | Store path to bind. Supports `${prop}` placeholders |
75
+ | `options.reflect` | `boolean` (default `false`) | Write local assignments back to the store |
76
+ | `options.skipEmptyPlaceholder` | `boolean` (default `false`) | Treat a placeholder resolved to `""` as not ready |
package/docs/docs/decorators/get.html ADDED
@@ -0,0 +1,166 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/get" 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 by Supersoniks</title>
7
+ <meta name="description" content="@get(endpoint) runs an HTTP GET on an Endpoint and stores the full ApiResult&lt;T&gt; in a property, or passes it to a method. It runs again when the endpoint's placeholders or the API configuration change,">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/decorators/get, get, @get, decorator, @get(endpoint), ApiResult, refetch, undefined, result, ), , (the HTTP response) and , . It is reset to , serviceURL">
9
+ <meta name="concorde-doc-id" content="docs/decorators/get">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/get">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/get.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/get">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 — @get</strong>. @get(endpoint) runs an HTTP GET on an Endpoint and stores the full ApiResult&lt;T&gt; in a property, or passes it to a method. It runs again when the endpoint's placeholders or the API configuration change, <span>Doc ID: <code>docs/decorators/get</code>. Keywords: Concorde, supersoniks, docs/decorators/get, get, @get, decorator, @get(endpoint), ApiResult, refetch, undefined, result, ), , (the HTTP response) and , . It is reset to , serviceURL. URL: <a href="https://concorde.supersoniks.org/docs/decorators/get">https://concorde.supersoniks.org/docs/decorators/get</a>.</span></p>
20
+ <h1 id="get">@get</h1>
21
+ <p><code>@get(endpoint)</code> runs an HTTP GET on an <a href="/docs/misc/endpoint">Endpoint</a> and stores the full <code>ApiResult&lt;T&gt;</code> in a property, or passes it to a method. It runs again when the endpoint&#39;s placeholders or the API configuration change, and on demand through <code>refetch</code>. For writes, see <a href="/docs/decorators/post">@post</a>, <a href="/docs/decorators/put">@put</a> and <a href="/docs/decorators/patch">@patch</a>.</p>
22
+ <h2 id="import">Import</h2>
23
+ <pre><code class="language-typescript">import { get, Endpoint, type ApiResult } from &quot;@supersoniks/concorde/decorators&quot;;
24
+
25
+ type FlightBoard = { flights: Flight[] };
26
+ const departuresEndpoint = new Endpoint&amp;lt;FlightBoard&amp;gt;(&quot;flights?direction=departures&quot;);
27
+
28
+ @get(departuresEndpoint)
29
+ @state()
30
+ departures?: ApiResult&amp;lt;FlightBoard&amp;gt;;
31
+ </code></pre>
32
+ <h2 id="property">Property</h2>
33
+ <p>The property is <code>undefined</code> until the first response, then holds <code>result</code> (typed <code>T</code>), <code>response</code> (the HTTP response) and <code>request</code>. It is reset to <code>undefined</code> when the component disconnects.</p>
34
+ <p>Without a configuration key, <code>serviceURL</code> and the token are read from the HTML scope: place the component under an element that sets them (see <a href="/docs/misc/api-configuration">API configuration</a>). The GET waits until <code>serviceURL</code> is available.</p>
35
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-api-get&quot;&gt;&lt;/docs-demo-sources&gt;
36
+ &lt;demo-api-get&gt;&lt;/demo-api-get&gt;
37
+ </code></pre>
38
+ <h2 id="method">Method</h2>
39
+ <p>Decorate a method to receive the <code>ApiResult&lt;T&gt;</code> after each GET instead of storing it.</p>
40
+ <pre><code class="language-typescript">@get(departuresEndpoint)
41
+ onDepartures(payload?: ApiResult&amp;lt;FlightBoard&amp;gt;) {
42
+ this.boarding = payload?.result?.flights.filter((f) =&amp;gt; f.status === &quot;boarding&quot;) ?? [];
43
+ }
44
+ </code></pre>
45
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-api-get-method&quot;&gt;&lt;/docs-demo-sources&gt;
46
+ &lt;demo-api-get-method&gt;&lt;/demo-api-get-method&gt;
47
+ </code></pre>
48
+ <h2 id="configuration-key">Configuration key</h2>
49
+ <p>Pass a <code>DataProviderKey&lt;APIConfiguration&gt;</code> as the second argument to read the configuration from the store instead of the HTML scope. Any change to that publisher runs the GET again.</p>
50
+ <pre><code class="language-typescript">import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
51
+ import type { APIConfiguration } from &quot;@supersoniks/concorde/utils/api&quot;;
52
+
53
+ const flightsApi = new DataProviderKey&amp;lt;APIConfiguration&amp;gt;(&quot;flightsApi&quot;);
54
+
55
+ @get(departuresEndpoint, flightsApi)
56
+ @state()
57
+ departures?: ApiResult&amp;lt;FlightBoard&amp;gt;;
58
+ </code></pre>
59
+ <h2 id="dynamic-endpoint">Dynamic endpoint</h2>
60
+ <p><code>${prop}</code> placeholders in the endpoint resolve from properties of the same component; each change runs a new GET. While a placeholder is <code>null</code> or <code>undefined</code>, no request is sent and the property is <code>undefined</code>. Rules: <a href="/docs/misc/dynamic-path">Dynamic paths</a>.</p>
61
+ <pre><code class="language-typescript">const boardEndpoint = new Endpoint&amp;lt;FlightBoard, { direction: string }&amp;gt;(
62
+ &quot;flights?direction=${direction}&quot;,
63
+ );
64
+
65
+ @property() direction = &quot;departures&quot;;
66
+
67
+ @get(boardEndpoint, flightsApi)
68
+ @state()
69
+ board?: ApiResult&amp;lt;FlightBoard&amp;gt;;
70
+ </code></pre>
71
+ <pre><code>&lt;docs-demo-sources for=&quot;demo-api-get-configuration-key&quot;&gt;&lt;/docs-demo-sources&gt;
72
+ &lt;demo-api-get-configuration-key&gt;&lt;/demo-api-get-configuration-key&gt;
73
+ </code></pre>
74
+ <h2 id="refetch">Refetch</h2>
75
+ <p>Keep the decorator in a constant to reuse it. <code>refetch(component)</code> runs the GET for that instance only and resolves with the new <code>ApiResult&lt;T&gt;</code> (or <code>undefined</code>).</p>
76
+ <pre><code class="language-typescript">const departuresGet = get(departuresEndpoint);
77
+
78
+ @departuresGet
79
+ @state()
80
+ departures?: ApiResult&amp;lt;FlightBoard&amp;gt;;
81
+
82
+ async refresh() {
83
+ await departuresGet.refetch(this);
84
+ }
85
+ </code></pre>
86
+ <p><code>@refetch(handle)</code> does the same around a method. By default the GET runs <strong>after</strong> the method (and after its Promise, if it returns one); use <code>{ when: &quot;before&quot; }</code> to run it first. The method call resolves once the GET is done.</p>
87
+ <pre><code class="language-typescript">import { refetch } from &quot;@supersoniks/concorde/decorators&quot;;
88
+
89
+ @refetch(departuresGet)
90
+ async showArrivals() {
91
+ this.direction = &quot;arrivals&quot;;
92
+ }
93
+ </code></pre>
94
+ <h2 id="polling-and-triggers">Polling and triggers</h2>
95
+ <p><code>refetchEveryMs</code> runs the GET again that many milliseconds after each response (default <code>0</code>: off). <code>triggerKey</code> runs it whenever another component calls <code>invalidate()</code> on that publisher.</p>
96
+ <pre><code class="language-typescript">import { dp } from &quot;@supersoniks/concorde/utils&quot;;
97
+
98
+ const boardRefresh = new DataProviderKey&amp;lt;number&amp;gt;(&quot;boardRefresh&quot;);
99
+
100
+ @get(departuresEndpoint, { refetchEveryMs: 30000, triggerKey: boardRefresh })
101
+ @state()
102
+ departures?: ApiResult&amp;lt;FlightBoard&amp;gt;;
103
+
104
+ // anywhere else
105
+ dp(boardRefresh).invalidate();
106
+ </code></pre>
107
+ <h2 id="api-reference">API reference</h2>
108
+ <table>
109
+ <thead>
110
+ <tr>
111
+ <th>Argument</th>
112
+ <th>Type</th>
113
+ <th>Description</th>
114
+ </tr>
115
+ </thead>
116
+ <tbody><tr>
117
+ <td><code>endpoint</code></td>
118
+ <td><code>Endpoint&lt;T, U&gt;</code></td>
119
+ <td>Path relative to <code>serviceURL</code>. <code>U</code> lists the host properties used by <code>${…}</code> placeholders</td>
120
+ </tr>
121
+ <tr>
122
+ <td><code>configurationKey</code></td>
123
+ <td><code>DataProviderKey&lt;APIConfiguration&gt;</code> (optional)</td>
124
+ <td>Read the configuration from the store instead of the HTML scope</td>
125
+ </tr>
126
+ <tr>
127
+ <td><code>options.refetchEveryMs</code></td>
128
+ <td><code>number</code> (default <code>0</code>)</td>
129
+ <td>Polling interval after each response; <code>0</code> disables it</td>
130
+ </tr>
131
+ <tr>
132
+ <td><code>options.triggerKey</code></td>
133
+ <td><code>DataProviderKey&lt;unknown&gt;</code></td>
134
+ <td>Publisher whose <code>invalidate()</code> runs the GET again</td>
135
+ </tr>
136
+ <tr>
137
+ <td><code>options.skipEmptyPlaceholder</code></td>
138
+ <td><code>boolean</code> (default <code>false</code>)</td>
139
+ <td>Treat a placeholder resolved to <code>&quot;&quot;</code> as not ready</td>
140
+ </tr>
141
+ </tbody></table>
142
+ <p><code>options</code> is the second argument, or the third when a <code>configurationKey</code> is passed. The returned decorator exposes <code>refetch(component): Promise&lt;ApiResult&lt;T&gt; | undefined&gt;</code>.</p>
143
+ <table>
144
+ <thead>
145
+ <tr>
146
+ <th><code>@refetch</code> argument</th>
147
+ <th>Type</th>
148
+ <th>Description</th>
149
+ </tr>
150
+ </thead>
151
+ <tbody><tr>
152
+ <td><code>handle</code></td>
153
+ <td>value returned by <code>get(…)</code></td>
154
+ <td>GET to run</td>
155
+ </tr>
156
+ <tr>
157
+ <td><code>options.when</code></td>
158
+ <td><code>&quot;before&quot;</code> or <code>&quot;after&quot;</code> (default <code>&quot;after&quot;</code>)</td>
159
+ <td>Run the GET before or after the method</td>
160
+ </tr>
161
+ </tbody></table>
162
+
163
+ </article>
164
+ </main>
165
+ </body>
166
+ </html>