@supersoniks/concorde 5.1.1 → 5.1.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 (438) 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/.tmp-cem/custom-elements.json +503 -503
  6. package/PLAN-DOCS-AGENTS.md +80 -0
  7. package/README.md +3 -3
  8. package/ai/skills/concorde/SKILL.md +1 -1
  9. package/ai/skills/concorde-get-set-dp/SKILL.md +3 -3
  10. package/ai/skills/concorde-theme/SKILL.md +1 -1
  11. package/build-infos.json +1 -1
  12. package/concorde-core.bundle.js +1 -1
  13. package/concorde-core.es.js +1 -1
  14. package/dist/concorde-core.bundle.js +1 -1
  15. package/dist/concorde-core.es.js +1 -1
  16. package/docs/.htaccess +75 -0
  17. package/docs/404.html +15 -0
  18. package/docs/404.md +5 -0
  19. package/docs/assets/{index-Bb-_LRyY.js → index-BgG6FFPt.js} +2582 -3097
  20. package/docs/assets/index-x89XINSG.css +1 -0
  21. package/docs/core/components/functional/date/date.html +211 -0
  22. package/docs/core/components/functional/date/date.md +150 -0
  23. package/docs/core/components/functional/fetch/fetch.html +180 -0
  24. package/docs/core/components/functional/fetch/fetch.md +108 -0
  25. package/docs/core/components/functional/if/if.html +65 -0
  26. package/docs/core/components/functional/if/if.md +34 -0
  27. package/docs/core/components/functional/jsonata/jsonata.html +110 -0
  28. package/docs/core/components/functional/jsonata/jsonata.md +61 -0
  29. package/docs/core/components/functional/list/list.html +198 -0
  30. package/docs/core/components/functional/list/list.md +121 -0
  31. package/docs/core/components/functional/mix/mix.html +78 -0
  32. package/docs/core/components/functional/mix/mix.md +46 -0
  33. package/docs/core/components/functional/queue/queue.html +155 -0
  34. package/docs/core/components/functional/queue/queue.md +51 -0
  35. package/docs/core/components/functional/router/router.html +154 -0
  36. package/docs/core/components/functional/router/router.md +93 -0
  37. package/docs/core/components/functional/sdui/sdui-extension-points.html +127 -0
  38. package/docs/core/components/functional/sdui/sdui-extension-points.md +94 -0
  39. package/docs/core/components/functional/sdui/sdui.html +397 -0
  40. package/docs/core/components/functional/sdui/sdui.md +307 -0
  41. package/docs/core/components/functional/states/states.html +141 -0
  42. package/docs/core/components/functional/states/states.md +112 -0
  43. package/docs/core/components/functional/submit/submit.html +178 -0
  44. package/docs/core/components/functional/submit/submit.md +106 -0
  45. package/docs/core/components/functional/subscriber/subscriber.html +68 -0
  46. package/docs/core/components/functional/subscriber/subscriber.md +91 -0
  47. package/docs/core/components/functional/translation/translation.html +60 -0
  48. package/docs/core/components/functional/translation/translation.md +38 -0
  49. package/docs/core/components/functional/value/value.html +81 -0
  50. package/docs/core/components/functional/value/value.md +47 -0
  51. package/docs/core/components/ui/alert/alert.html +201 -0
  52. package/docs/core/components/ui/alert/alert.md +186 -0
  53. package/docs/core/components/ui/alert-messages/alert-messages.html +132 -0
  54. package/docs/core/components/ui/alert-messages/alert-messages.md +85 -0
  55. package/docs/core/components/ui/badge/badge.html +197 -0
  56. package/docs/core/components/ui/badge/badge.md +181 -0
  57. package/docs/core/components/ui/button/button.html +309 -0
  58. package/docs/core/components/ui/button/button.md +216 -0
  59. package/docs/core/components/ui/captcha/captcha.html +80 -0
  60. package/docs/core/components/ui/captcha/captcha.md +56 -0
  61. package/docs/core/components/ui/card/card.html +254 -0
  62. package/docs/core/components/ui/card/card.md +215 -0
  63. package/docs/core/components/ui/divider/divider.html +144 -0
  64. package/docs/core/components/ui/divider/divider.md +126 -0
  65. package/docs/core/components/ui/form/checkbox/checkbox.html +200 -0
  66. package/docs/core/components/ui/form/checkbox/checkbox.md +125 -0
  67. package/docs/core/components/ui/form/fieldset/fieldset.html +238 -0
  68. package/docs/core/components/ui/form/fieldset/fieldset.md +161 -0
  69. package/docs/core/components/ui/form/form-actions/form-actions.html +122 -0
  70. package/docs/core/components/ui/form/form-actions/form-actions.md +98 -0
  71. package/docs/core/components/ui/form/form-layout/form-layout.html +115 -0
  72. package/docs/core/components/ui/form/form-layout/form-layout.md +109 -0
  73. package/docs/core/components/ui/form/input/input.html +235 -0
  74. package/docs/core/components/ui/form/input/input.md +142 -0
  75. package/docs/core/components/ui/form/radio/radio.html +144 -0
  76. package/docs/core/components/ui/form/radio/radio.md +78 -0
  77. package/docs/core/components/ui/form/select/select.html +178 -0
  78. package/docs/core/components/ui/form/select/select.md +86 -0
  79. package/docs/core/components/ui/form/switch/switch.html +146 -0
  80. package/docs/core/components/ui/form/switch/switch.md +80 -0
  81. package/docs/core/components/ui/form/textarea/textarea.html +162 -0
  82. package/docs/core/components/ui/form/textarea/textarea.md +82 -0
  83. package/docs/core/components/ui/group/group.html +113 -0
  84. package/docs/core/components/ui/group/group.md +77 -0
  85. package/docs/core/components/ui/icon/icon.html +223 -0
  86. package/docs/core/components/ui/icon/icon.md +214 -0
  87. package/docs/core/components/ui/image/image.html +194 -0
  88. package/docs/core/components/ui/image/image.md +167 -0
  89. package/docs/core/components/ui/link/link.html +101 -0
  90. package/docs/core/components/ui/link/link.md +81 -0
  91. package/docs/core/components/ui/loader/loader.html +114 -0
  92. package/docs/core/components/ui/loader/loader.md +87 -0
  93. package/docs/core/components/ui/menu/menu.html +395 -0
  94. package/docs/core/components/ui/menu/menu.md +370 -0
  95. package/docs/core/components/ui/modal/modal.html +324 -0
  96. package/docs/core/components/ui/modal/modal.md +211 -0
  97. package/docs/core/components/ui/pop/pop.html +250 -0
  98. package/docs/core/components/ui/pop/pop.md +216 -0
  99. package/docs/core/components/ui/progress/progress.html +132 -0
  100. package/docs/core/components/ui/progress/progress.md +109 -0
  101. package/docs/core/components/ui/table/table.html +333 -0
  102. package/docs/core/components/ui/table/table.md +267 -0
  103. package/docs/core/components/ui/theme/theme.html +116 -0
  104. package/docs/core/components/ui/theme/theme.md +97 -0
  105. package/docs/core/components/ui/toast/toast.html +185 -0
  106. package/docs/core/components/ui/toast/toast.md +147 -0
  107. package/docs/core/components/ui/tooltip/tooltip.html +112 -0
  108. package/docs/core/components/ui/tooltip/tooltip.md +89 -0
  109. package/docs/docs/decorators/ancestor-attribute.html +71 -0
  110. package/docs/docs/decorators/ancestor-attribute.md +59 -0
  111. package/docs/docs/decorators/auto-subscribe.html +61 -0
  112. package/docs/docs/decorators/auto-subscribe.md +40 -0
  113. package/docs/docs/decorators/bind.html +86 -0
  114. package/docs/docs/decorators/bind.md +77 -0
  115. package/docs/docs/decorators/get.html +166 -0
  116. package/docs/docs/decorators/get.md +160 -0
  117. package/docs/docs/decorators/handle.html +139 -0
  118. package/docs/docs/decorators/handle.md +119 -0
  119. package/docs/docs/decorators/on-assign.html +72 -0
  120. package/docs/docs/decorators/on-assign.md +63 -0
  121. package/docs/docs/decorators/patch.html +76 -0
  122. package/docs/docs/decorators/patch.md +44 -0
  123. package/docs/docs/decorators/post.html +150 -0
  124. package/docs/docs/decorators/post.md +134 -0
  125. package/docs/docs/decorators/publish.html +74 -0
  126. package/docs/docs/decorators/publish.md +56 -0
  127. package/docs/docs/decorators/put.html +83 -0
  128. package/docs/docs/decorators/put.md +51 -0
  129. package/docs/docs/decorators/subscribe.html +91 -0
  130. package/docs/docs/decorators/subscribe.md +87 -0
  131. package/docs/docs/decorators/wait-for-ancestors.html +82 -0
  132. package/docs/docs/decorators/wait-for-ancestors.md +76 -0
  133. package/docs/docs/directives/sub.html +79 -0
  134. package/docs/docs/directives/sub.md +75 -0
  135. package/docs/docs/directives/t.html +91 -0
  136. package/docs/docs/directives/t.md +73 -0
  137. package/docs/docs/getting-started/ai-agents.html +174 -0
  138. package/{src/docs/_getting-started → docs/docs/getting-started}/ai-agents.md +3 -3
  139. package/docs/docs/getting-started/components.html +27 -0
  140. package/docs/docs/getting-started/create-a-component.html +108 -0
  141. package/{src/docs/_getting-started → docs/docs/getting-started}/create-a-component.md +3 -6
  142. package/docs/docs/getting-started/dataFlow.html +174 -0
  143. package/{src/docs/_core-concept → docs/docs/getting-started}/dataFlow.md +17 -18
  144. package/docs/docs/getting-started/installation.html +69 -0
  145. package/docs/docs/getting-started/installation.md +36 -0
  146. package/docs/docs/getting-started/my-first-component.html +180 -0
  147. package/{src/docs/_getting-started → docs/docs/getting-started}/my-first-component.md +5 -14
  148. package/docs/docs/getting-started/start.html +47 -0
  149. package/{src/docs/_getting-started → docs/docs/getting-started}/start.md +1 -13
  150. package/docs/docs/getting-started/theming.html +334 -0
  151. package/docs/docs/index.html +99 -0
  152. package/docs/docs/misc/api-configuration.html +149 -0
  153. package/{src/docs/_misc → docs/docs/misc}/api-configuration.md +10 -12
  154. package/docs/docs/misc/dataProviderKey.html +136 -0
  155. package/{src/docs/_misc → docs/docs/misc}/dataProviderKey.md +4 -4
  156. package/docs/docs/misc/docs-mock-api.html +155 -0
  157. package/{src/docs/_misc → docs/docs/misc}/docs-mock-api.md +12 -13
  158. package/docs/docs/misc/dynamic-path.html +181 -0
  159. package/{src/docs/_misc → docs/docs/misc}/dynamic-path.md +8 -8
  160. package/docs/docs/misc/endpoint.html +51 -0
  161. package/{src/docs/_misc → docs/docs/misc}/endpoint.md +8 -8
  162. package/docs/docs/misc/html-integration.html +45 -0
  163. package/{src/docs/_misc → docs/docs/misc}/html-integration.md +4 -5
  164. package/docs/docs-mock-api-sw.js +58 -223
  165. package/docs/docs-mock-api-sw.js.map +4 -4
  166. package/docs/hubs/decorators.html +443 -0
  167. package/docs/hubs/form-components.html +404 -0
  168. package/docs/hubs/remote-data.html +371 -0
  169. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  170. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  171. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  172. package/docs/img/archive/credits.json +28 -0
  173. package/docs/img/concorde/plane_01.jpg +0 -0
  174. package/docs/img/concorde/plane_02.jpg +0 -0
  175. package/docs/img/concorde/plane_03.jpg +0 -0
  176. package/docs/img/concorde/plane_04.jpg +0 -0
  177. package/docs/img/concorde/plane_05.jpg +0 -0
  178. package/docs/img/concorde/plane_06.jpg +0 -0
  179. package/docs/img/concorde/plane_07.jpg +0 -0
  180. package/docs/img/concorde/plane_08.jpg +0 -0
  181. package/docs/img/concorde/plane_09.jpg +0 -0
  182. package/docs/img/concorde/plane_10.jpg +0 -0
  183. package/docs/img/concorde/plane_11.jpg +0 -0
  184. package/docs/img/concorde/plane_12.jpg +0 -0
  185. package/docs/img/concorde/plane_13.jpg +0 -0
  186. package/docs/index.html +95 -68
  187. package/docs/index.md +22 -0
  188. package/docs/llms-full.txt +5795 -0
  189. package/docs/llms.txt +106 -0
  190. package/docs/robots.txt +11 -10
  191. package/docs/sitemap.xml +237 -0
  192. package/docs/src/core/components/functional/date/date.md +150 -0
  193. package/docs/src/core/components/functional/fetch/fetch.md +108 -0
  194. package/docs/src/core/components/functional/if/if.md +34 -0
  195. package/docs/src/core/components/functional/jsonata/jsonata.md +61 -0
  196. package/docs/src/core/components/functional/list/list.md +121 -0
  197. package/docs/src/core/components/functional/mix/mix.md +46 -0
  198. package/docs/src/core/components/functional/queue/queue.md +51 -0
  199. package/docs/src/core/components/functional/router/router.md +93 -0
  200. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  201. package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
  202. package/docs/src/core/components/functional/sdui/default-library.json +108 -0
  203. package/docs/src/core/components/functional/sdui/example.json +32 -0
  204. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  205. package/docs/src/core/components/functional/sdui/sdui.md +307 -0
  206. package/docs/src/core/components/functional/states/states.md +112 -0
  207. package/docs/src/core/components/functional/submit/submit.md +106 -0
  208. package/docs/src/core/components/functional/subscriber/subscriber.md +91 -0
  209. package/docs/src/core/components/functional/translation/translation.md +38 -0
  210. package/docs/src/core/components/functional/value/value.md +47 -0
  211. package/docs/src/core/components/ui/alert/alert.md +186 -0
  212. package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
  213. package/docs/src/core/components/ui/badge/badge.md +181 -0
  214. package/docs/src/core/components/ui/button/button.md +216 -0
  215. package/docs/src/core/components/ui/captcha/captcha.md +56 -0
  216. package/docs/src/core/components/ui/card/card.md +215 -0
  217. package/docs/src/core/components/ui/divider/divider.md +126 -0
  218. package/docs/src/core/components/ui/form/checkbox/checkbox.md +125 -0
  219. package/docs/src/core/components/ui/form/fieldset/fieldset.md +161 -0
  220. package/docs/src/core/components/ui/form/form-actions/form-actions.md +98 -0
  221. package/docs/src/core/components/ui/form/form-layout/form-layout.md +109 -0
  222. package/docs/src/core/components/ui/form/input/input.md +142 -0
  223. package/docs/src/core/components/ui/form/radio/radio.md +78 -0
  224. package/docs/src/core/components/ui/form/select/select.md +86 -0
  225. package/docs/src/core/components/ui/form/switch/switch.md +80 -0
  226. package/docs/src/core/components/ui/form/textarea/textarea.md +82 -0
  227. package/docs/src/core/components/ui/group/group.md +77 -0
  228. package/docs/src/core/components/ui/icon/icon.md +214 -0
  229. package/docs/src/core/components/ui/icon/icons.json +1 -0
  230. package/docs/src/core/components/ui/image/image.md +167 -0
  231. package/docs/src/core/components/ui/link/link.md +81 -0
  232. package/docs/src/core/components/ui/loader/loader.md +87 -0
  233. package/docs/src/core/components/ui/menu/menu.md +370 -0
  234. package/docs/src/core/components/ui/modal/modal.md +211 -0
  235. package/docs/src/core/components/ui/pop/pop.md +216 -0
  236. package/docs/src/core/components/ui/progress/progress.md +109 -0
  237. package/docs/src/core/components/ui/table/table.md +267 -0
  238. package/docs/src/core/components/ui/theme/theme.md +97 -0
  239. package/docs/src/core/components/ui/toast/toast.md +147 -0
  240. package/docs/src/core/components/ui/tooltip/tooltip.md +89 -0
  241. package/docs/src/docs/decorators/ancestor-attribute.md +59 -0
  242. package/docs/src/docs/decorators/auto-subscribe.md +40 -0
  243. package/docs/src/docs/decorators/bind.md +77 -0
  244. package/docs/src/docs/decorators/get.md +160 -0
  245. package/docs/src/docs/decorators/handle.md +119 -0
  246. package/docs/src/docs/decorators/on-assign.md +63 -0
  247. package/docs/src/docs/decorators/patch.md +44 -0
  248. package/docs/src/docs/decorators/post.md +134 -0
  249. package/docs/src/docs/decorators/publish.md +56 -0
  250. package/docs/src/docs/decorators/put.md +51 -0
  251. package/docs/src/docs/decorators/subscribe.md +87 -0
  252. package/docs/src/docs/decorators/wait-for-ancestors.md +76 -0
  253. package/docs/src/docs/directives/sub.md +75 -0
  254. package/docs/src/docs/directives/t.md +73 -0
  255. package/docs/src/docs/getting-started/ai-agents.md +76 -0
  256. package/docs/src/docs/getting-started/components.md +5 -0
  257. package/docs/src/docs/getting-started/create-a-component.md +136 -0
  258. package/docs/src/docs/getting-started/dataFlow.md +87 -0
  259. package/docs/src/docs/getting-started/installation.md +36 -0
  260. package/docs/src/docs/getting-started/my-first-component.md +227 -0
  261. package/docs/src/docs/getting-started/start.md +35 -0
  262. package/docs/src/docs/getting-started/theming.md +253 -0
  263. package/docs/src/docs/misc/api-configuration.md +79 -0
  264. package/docs/src/docs/misc/dataProviderKey.md +168 -0
  265. package/docs/src/docs/misc/docs-mock-api.md +62 -0
  266. package/docs/src/docs/misc/dynamic-path.md +71 -0
  267. package/docs/src/docs/misc/endpoint.md +45 -0
  268. package/docs/src/docs/misc/html-integration.md +14 -0
  269. package/docs/src/docs/search/docs-search.json +10287 -0
  270. package/docs/src/tag-list.json +1 -0
  271. package/docs/src/tsconfig-model.json +23 -0
  272. package/docs/src/tsconfig.json +1353 -0
  273. package/index.html +68 -5
  274. package/package.json +1 -1
  275. package/public/docs-mock-api-sw.js +58 -223
  276. package/public/docs-mock-api-sw.js.map +4 -4
  277. package/public/img/concorde/plane_01.jpg +0 -0
  278. package/public/img/concorde/plane_02.jpg +0 -0
  279. package/public/img/concorde/plane_03.jpg +0 -0
  280. package/public/img/concorde/plane_04.jpg +0 -0
  281. package/public/img/concorde/plane_05.jpg +0 -0
  282. package/public/img/concorde/plane_06.jpg +0 -0
  283. package/public/img/concorde/plane_07.jpg +0 -0
  284. package/public/img/concorde/plane_08.jpg +0 -0
  285. package/public/img/concorde/plane_09.jpg +0 -0
  286. package/public/img/concorde/plane_10.jpg +0 -0
  287. package/public/img/concorde/plane_11.jpg +0 -0
  288. package/public/img/concorde/plane_12.jpg +0 -0
  289. package/public/img/concorde/plane_13.jpg +0 -0
  290. package/public/robots.txt +11 -10
  291. package/scripts/docs-markdown-vite-plugin.ts +37 -0
  292. package/scripts/docs-public-url.mjs +50 -0
  293. package/scripts/docs.htaccess +75 -0
  294. package/scripts/generate-crawl-docs.mjs +207 -116
  295. package/scripts/generate-crawl-docs.test.mjs +124 -0
  296. package/scripts/post-build-docs.js +34 -50
  297. package/src/core/components/functional/date/date.md +91 -231
  298. package/src/core/components/functional/fetch/fetch.md +66 -83
  299. package/src/core/components/functional/if/if.md +28 -3
  300. package/src/core/components/functional/jsonata/jsonata.md +42 -37
  301. package/src/core/components/functional/list/list.md +99 -43
  302. package/src/core/components/functional/mix/mix.md +31 -26
  303. package/src/core/components/functional/queue/queue.demo.ts +10 -7
  304. package/src/core/components/functional/queue/queue.md +40 -61
  305. package/src/core/components/functional/router/router.demo.ts +16 -16
  306. package/src/core/components/functional/router/router.md +64 -65
  307. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  308. package/src/core/components/functional/sdui/component-catalog.json +1 -1
  309. package/src/core/components/functional/sdui/example.json +19 -86
  310. package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  311. package/src/core/components/functional/sdui/sdui.md +187 -358
  312. package/src/core/components/functional/states/states.demo.ts +21 -22
  313. package/src/core/components/functional/states/states.md +86 -61
  314. package/src/core/components/functional/states/states.ts +1 -1
  315. package/src/core/components/functional/submit/submit.md +64 -72
  316. package/src/core/components/functional/translation/translation.md +38 -0
  317. package/src/core/components/functional/value/value.md +34 -22
  318. package/src/core/components/ui/alert/alert.md +48 -58
  319. package/src/core/components/ui/badge/badge.md +27 -34
  320. package/src/core/components/ui/button/button.md +139 -106
  321. package/src/core/components/ui/captcha/captcha.md +17 -32
  322. package/src/core/components/ui/card/card.md +6 -6
  323. package/src/core/components/ui/divider/divider.md +8 -11
  324. package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  325. package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
  326. package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
  327. package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
  328. package/src/core/components/ui/form/input/input.md +95 -95
  329. package/src/core/components/ui/form/radio/radio.md +55 -34
  330. package/src/core/components/ui/form/select/select.md +60 -45
  331. package/src/core/components/ui/form/switch/switch.md +57 -34
  332. package/src/core/components/ui/form/textarea/textarea.md +55 -38
  333. package/src/core/components/ui/group/group.md +35 -33
  334. package/src/core/components/ui/icon/icon.md +4 -4
  335. package/src/core/components/ui/image/image.md +41 -107
  336. package/src/core/components/ui/link/link.md +6 -6
  337. package/src/core/components/ui/loader/loader.md +30 -55
  338. package/src/core/components/ui/menu/menu.md +27 -27
  339. package/src/core/components/ui/modal/modal.md +72 -96
  340. package/src/core/components/ui/pop/pop.md +80 -158
  341. package/src/core/components/ui/progress/progress.md +2 -2
  342. package/src/core/components/ui/table/table.md +91 -255
  343. package/src/core/components/ui/theme/theme.md +11 -36
  344. package/src/core/components/ui/toast/toast.md +48 -117
  345. package/src/core/components/ui/tooltip/tooltip.md +27 -62
  346. package/src/core/utils/LocationHandler.spec.ts +80 -0
  347. package/src/core/utils/LocationHandler.ts +5 -9
  348. package/src/docs/components/docs-demo-sources.ts +55 -140
  349. package/src/docs/components/docs-lit-demo.ts +1 -3
  350. package/src/docs/components/docs-source-link.ts +0 -82
  351. package/src/docs/decorators/ancestor-attribute.md +59 -0
  352. package/src/docs/decorators/auto-subscribe.md +40 -0
  353. package/src/docs/decorators/bind.md +77 -0
  354. package/src/docs/decorators/get.md +160 -0
  355. package/src/docs/decorators/handle.md +119 -0
  356. package/src/docs/decorators/on-assign.md +63 -0
  357. package/src/docs/decorators/patch.md +44 -0
  358. package/src/docs/decorators/post.md +134 -0
  359. package/src/docs/decorators/publish.md +56 -0
  360. package/src/docs/decorators/put.md +51 -0
  361. package/src/docs/decorators/subscribe.md +87 -0
  362. package/src/docs/decorators/wait-for-ancestors.md +76 -0
  363. package/src/docs/directives/sub.md +75 -0
  364. package/src/docs/directives/t.md +73 -0
  365. package/src/docs/docs-location.spec.ts +46 -0
  366. package/src/docs/docs-location.ts +123 -32
  367. package/src/docs/docs.ts +1 -2
  368. package/src/docs/example/decorators-demo-bind-demos.ts +81 -116
  369. package/src/docs/example/decorators-demo-geo.ts +30 -19
  370. package/src/docs/example/decorators-demo-post.ts +88 -186
  371. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
  372. package/src/docs/example/decorators-demo.ts +85 -98
  373. package/src/docs/example/docs-api-config-demos.ts +19 -20
  374. package/src/docs/example/docs-flight-demos.ts +147 -0
  375. package/src/docs/example/docs-jsonata-demos.ts +52 -52
  376. package/src/docs/example/docs-list-demos.ts +43 -123
  377. package/src/docs/example/docs-provider-keys.ts +21 -28
  378. package/src/docs/example/docs-queue-demos.ts +37 -77
  379. package/src/docs/example/docs-router-demos.ts +20 -25
  380. package/src/docs/example/docs-submit-demos.ts +48 -48
  381. package/src/docs/example/docs-toggle-demos.ts +4 -3
  382. package/src/docs/getting-started/ai-agents.md +76 -0
  383. package/src/docs/getting-started/components.md +5 -0
  384. package/src/docs/getting-started/create-a-component.md +136 -0
  385. package/src/docs/getting-started/dataFlow.md +87 -0
  386. package/src/docs/getting-started/installation.md +36 -0
  387. package/src/docs/getting-started/my-first-component.md +227 -0
  388. package/src/docs/getting-started/start.md +35 -0
  389. package/src/docs/getting-started/theming.md +253 -0
  390. package/src/docs/header/header.ts +11 -6
  391. package/src/docs/home/catalog.ts +1 -1
  392. package/src/docs/home/home.ts +17 -10
  393. package/src/docs/layout.ts +12 -13
  394. package/src/docs/misc/api-configuration.md +79 -0
  395. package/src/docs/misc/dataProviderKey.md +168 -0
  396. package/src/docs/misc/docs-mock-api.md +62 -0
  397. package/src/docs/misc/dynamic-path.md +71 -0
  398. package/src/docs/misc/endpoint.md +45 -0
  399. package/src/docs/misc/html-integration.md +14 -0
  400. package/src/docs/mock-api/api-config-mock.ts +5 -0
  401. package/src/docs/mock-api/fixtures.ts +0 -278
  402. package/src/docs/mock-api/flights.ts +89 -0
  403. package/src/docs/mock-api/router.ts +3 -4
  404. package/src/docs/mock-api/urls.ts +1 -2
  405. package/src/docs/navigation/navigation.ts +82 -103
  406. package/src/docs/navigation/toc.ts +7 -4
  407. package/src/docs/search/docs-search.json +2845 -5110
  408. package/src/docs/search/markdown-renderer.ts +25 -7
  409. package/src/docs/search/page.ts +9 -6
  410. package/src/docs/search/search.ts +154 -122
  411. package/vite.config.mts +11 -2
  412. package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
  413. package/docs/assets/index-CD4WyL6o.css +0 -1
  414. package/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  415. package/src/docs/_core-concept/overview.md +0 -57
  416. package/src/docs/_core-concept/subscriber.md +0 -75
  417. package/src/docs/_decorators/ancestor-attribute.md +0 -128
  418. package/src/docs/_decorators/auto-subscribe.md +0 -202
  419. package/src/docs/_decorators/bind.md +0 -167
  420. package/src/docs/_decorators/get.md +0 -162
  421. package/src/docs/_decorators/handle.md +0 -175
  422. package/src/docs/_decorators/on-assign.md +0 -390
  423. package/src/docs/_decorators/patch.md +0 -70
  424. package/src/docs/_decorators/post.md +0 -146
  425. package/src/docs/_decorators/publish.md +0 -55
  426. package/src/docs/_decorators/put.md +0 -70
  427. package/src/docs/_decorators/subscribe.md +0 -100
  428. package/src/docs/_decorators/wait-for-ancestors.md +0 -163
  429. package/src/docs/_directives/sub.md +0 -91
  430. package/src/docs/_getting-started/concorde-manual-install.md +0 -133
  431. package/src/docs/_getting-started/concorde-outside.md +0 -33
  432. package/src/docs/_getting-started/my-first-subscriber.md +0 -120
  433. package/src/docs/_getting-started/pubsub.md +0 -37
  434. package/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  435. package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
  436. package/src/docs/example/docs-joke-demos.ts +0 -297
  437. /package/{src/docs/_getting-started → docs/docs/getting-started}/components.md +0 -0
  438. /package/{src/docs/_getting-started → docs/docs/getting-started}/theming.md +0 -0
package/docs/hubs/remote-data.html ADDED
@@ -0,0 +1,371 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/hubs/remote-data.html" data-doc-id="hubs/remote-data">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Fetching remote data in Concorde — Concorde by Supersoniks</title>
7
+ <meta name="description" content="Hub for loading online data: @get decorator, Endpoint, API configuration, dynamic paths, sonic-list fetch, sonic-queue, legacy sonic-fetch.">
8
+ <meta name="keywords" content="@get, fetch, remote data, API, Endpoint, ApiResult, serviceURL, sonic-list, sonic-queue, HTTP GET">
9
+ <meta name="concorde-doc-id" content="hubs/remote-data">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/hubs/remote-data.html">
11
+ </head>
12
+ <body>
13
+ <header>
14
+ <p><a href="/docs/index.html">Concorde documentation</a></p>
15
+ </header>
16
+ <main>
17
+ <article>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde documentation — Fetching remote data in Concorde</strong>. Hub for loading online data: @get decorator, Endpoint, API configuration, dynamic paths, sonic-list fetch, sonic-queue, legacy sonic-fetch. <span>Doc ID: <code>hubs/remote-data</code>. Keywords: @get, fetch, remote data, API, Endpoint, ApiResult, serviceURL, sonic-list, sonic-queue, HTTP GET. URL: <a href="https://concorde.supersoniks.org/hubs/remote-data.html">https://concorde.supersoniks.org/hubs/remote-data.html</a>.</span></p>
19
+ <section id="core-components-functional-fetch-fetch" data-doc-id="core/components/functional/fetch/fetch">
20
+ <h2><a href="/core/components/functional/fetch">Fetch</a></h2>
21
+ <p><strong>Doc ID:</strong> <code>core/components/functional/fetch/fetch</code> · <a href="/core/components/functional/fetch">full page</a></p>
22
+ <p>sonic-fetch sends a GET request to serviceURL + endPoint and publishes the response under dataProvider, so its children and any subscriber of that provider can render it. In a Lit component, prefer th</p>
23
+ <pre class="doc-excerpt">Fetch
24
+
25
+ sonic-fetch sends a GET request to serviceURL + endPoint and publishes the response under dataProvider, so its children and any subscriber of that provider can render it. In a Lit component, prefer the @get decorator; for collections, use List or Queue.
26
+
27
+ Basic example
28
+
29
+ dataProvider is required; serviceURL and dataProvider can be set on an ancestor. Children are hidden while the request is pending. With no serviceURL, requests go to the page origin.
30
+
31
+ $code to $city, gate $gate&quot;&gt;
32
+
33
+ Data provider as endpoint
34
+
35
+ With no endPoint, the dataProvider value is used as the endpoint.
36
+
37
+ $code from $city at $time&quot;&gt;
38
+
39
+ Key
40
+
41
+ key keeps only part of the response, using a dot path: with { &quot;flights&quot;: [ … ] } and key=&quot;flights.1&quot;, the provider holds the second flight. Add preserveOtherKeys to merge the target into the parent object instead of dropping its siblings. With no key, the whole response is published.
42
+
43
+ Loader and skeleton
44
+
45
+ With no loader, nothing is shown during the request. Set loader (fixed overlay) or loader=&quot;inline&quot; to show a Loader, or add a child rendered in place of the content while loading.
46
+
47
+ Loading arrivals…
48
+
49
+ Text responses
50
+
51
+ When the response type starts w</pre>
52
+ </section>
53
+ <section id="core-components-functional-list-list" data-doc-id="core/components/functional/list/list">
54
+ <h2><a href="/core/components/functional/list">List</a></h2>
55
+ <p><strong>Doc ID:</strong> <code>core/components/functional/list/list</code> · <a href="/core/components/functional/list">full page</a></p>
56
+ <p>sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. From Lit, pass a row renderer on the items property; in plain HTML, declare &lt;template&gt; children. Each</p>
57
+ <pre class="doc-excerpt">List
58
+
59
+ sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. From Lit, pass a row renderer on the items property; in plain HTML, declare children. Each row gets its own data provider at /list-item/ .
60
+
61
+ Basic example
62
+
63
+ Add fetch to load props from serviceURL + endPoint (or dataProvider when endPoint is empty). key picks the array inside the response. Without fetch, the list only renders the props it receives.
64
+
65
+ $time $code from $city ($airport)&quot;&gt;
66
+
67
+ Fetch attributes (lazyload · refetchEveryMs · headers · authentication) are shared with Fetch.
68
+
69
+ Row renderer
70
+
71
+ From a Lit component, set .items to a function (item, metadata) =&gt; TemplateResult. Functions only pass as properties, so always use the . binding: the same applies to .separator · .noItems · .skeleton. metadata holds key · even · odd · firstChild · lastChild · onlyChild.
72
+
73
+ Row variants
74
+
75
+ In HTML, templateKey (default template) names the row field that selects a . Rows without a match cycle through the children that have no data-value. From Lit, branch inside the items callback instead.
76
+
77
+ Separator and empty list
78
+
79
+ .separator renders between rows (not after the last one). .noItems</pre>
80
+ </section>
81
+ <section id="core-components-functional-queue-queue" data-doc-id="core/components/functional/queue/queue">
82
+ <h2><a href="/core/components/functional/queue">Queue</a></h2>
83
+ <p><strong>Doc ID:</strong> <code>core/components/functional/queue/queue</code> · <a href="/core/components/functional/queue">full page</a></p>
84
+ <p>sonic-queue loads a paginated API in batches and renders each batch as an internal List. Choose it over sonic-list for long or endless lists; the key attributes are dataProviderExpression · limit · da</p>
85
+ <pre class="doc-excerpt">Queue
86
+
87
+ sonic-queue loads a paginated API in batches and renders each batch as an internal List. Choose it over sonic-list for long or endless lists; the key attributes are dataProviderExpression · limit · dataFilterProvider.
88
+
89
+ Lazy load
90
+
91
+ dataProviderExpression is the request path: $offset and $limit are replaced for each batch. The first batch starts at offset (default 0) with limit rows (default 5, at most 15). The next batch loads when the end of the list scrolls into view, and the queue stops at the first empty batch. Put the queue in a box with a fixed height and overflow-y-auto, then scroll inside it.
92
+
93
+ Rows come from the .items callback, as on List; .noItems and .skeleton work the same way. Without $offset in the expression, the queue sends one request and behaves like a list. Set noLazyload to load every batch in a row without waiting for the scroll.
94
+
95
+ Filters
96
+
97
+ dataFilterProvider names a form store (formDataProvider). Each non-empty field is added to the query string; when a field changes, the queue drops the loaded batches and reloads from the first offset, after a filterTimeoutMs debounce (default 400). Search a city, an airport or a flight number.
98
+
99
+ To keep some form fields o</pre>
100
+ </section>
101
+ <section id="docs-decorators-get" data-doc-id="docs/decorators/get">
102
+ <h2><a href="/docs/decorators/get">@get</a></h2>
103
+ <p><strong>Doc ID:</strong> <code>docs/decorators/get</code> · <a href="/docs/decorators/get">full page</a></p>
104
+ <p>@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,</p>
105
+ <pre class="doc-excerpt">@get
106
+
107
+ @get(endpoint) runs an HTTP GET on an Endpoint and stores the full ApiResult in a property, or passes it to a method. It runs again when the endpoint's placeholders or the API configuration change, and on demand through refetch. For writes, see @post, @put and @patch.
108
+
109
+ Import
110
+
111
+ import { get, Endpoint, type ApiResult } from &quot;@supersoniks/concorde/decorators&quot;;
112
+
113
+ type FlightBoard = { flights: Flight[] };
114
+ const departuresEndpoint = new Endpoint&amp;lt;FlightBoard&amp;gt;(&quot;flights?direction=departures&quot;);
115
+
116
+ @get(departuresEndpoint)
117
+ @state()
118
+ departures?: ApiResult&amp;lt;FlightBoard&amp;gt;;
119
+
120
+ Property
121
+
122
+ The property is undefined until the first response, then holds result (typed T), response (the HTTP response) and request. It is reset to undefined when the component disconnects.
123
+
124
+ Without a configuration key, serviceURL and the token are read from the HTML scope: place the component under an element that sets them (see API configuration). The GET waits until serviceURL is available.
125
+
126
+ Method
127
+
128
+ Decorate a method to receive the ApiResult after each GET instead of storing it.
129
+
130
+ @get(departuresEndpoint)
131
+ onDepartures(payload?: ApiResult&amp;lt;FlightBoard&amp;gt;) {
132
+ this.boarding = payload?.result?.flights.filter(</pre>
133
+ </section>
134
+ <section id="docs-decorators-patch" data-doc-id="docs/decorators/patch">
135
+ <h2><a href="/docs/decorators/patch">@patch</a></h2>
136
+ <p><strong>Doc ID:</strong> <code>docs/decorators/patch</code> · <a href="/docs/decorators/patch">full page</a></p>
137
+ <p>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</p>
138
+ <pre class="doc-excerpt">@patch
139
+
140
+ 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 property. It takes the same arguments, options and send(component) handle as @post; only the HTTP method differs.
141
+
142
+ Import
143
+
144
+ import { patch, type ApiResult } from &quot;@supersoniks/concorde/decorators&quot;;
145
+ import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
146
+ import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
147
+
148
+ Basic usage
149
+
150
+ The body holds only the fields to change, here a gate change for flight CN 001.
151
+
152
+ type Flight = { flight: string; route: string; gate: string };
153
+
154
+ const gateChangeKey = new DataProviderKey&amp;lt;Partial&amp;lt;Flight&amp;gt;&amp;gt;(&quot;gateChange&quot;);
155
+
156
+ @patch(new Endpoint&amp;lt;Flight&amp;gt;(&quot;flights/CN001&quot;), gateChangeKey)
157
+ @state()
158
+ payload?: ApiResult&amp;lt;Flight&amp;gt;;
159
+
160
+ moveToB12() {
161
+ set(gateChangeKey, { gate: &quot;B12&quot; }); // sends the PATCH
162
+ }
163
+
164
+ Triggers, the send method decorator and every option are described on @post.
165
+
166
+ API reference
167
+
168
+ | Argument | Type | Description |
169
+ |----------|------|-------------|
170
+ | endpoint | Endpoint | Resource path and response type |
171
+ | bodyKey | DataProviderKey | Publisher read as the partial body |
172
+ | </pre>
173
+ </section>
174
+ <section id="docs-decorators-post" data-doc-id="docs/decorators/post">
175
+ <h2><a href="/docs/decorators/post">@post</a></h2>
176
+ <p><strong>Doc ID:</strong> <code>docs/decorators/post</code> · <a href="/docs/decorators/post">full page</a></p>
177
+ <p>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</p>
178
+ <pre class="doc-excerpt">@post
179
+
180
+ Sends the value of a publisher as the body of a POST request and stores the response in an ApiResult property. Pass an Endpoint and a DataProviderKey for the body; the request runs on connect and again whenever the body changes. @put and @patch work the same way.
181
+
182
+ Import
183
+
184
+ import { post, type ApiResult } from &quot;@supersoniks/concorde/decorators&quot;;
185
+ import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
186
+ import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
187
+
188
+ type SignUp = { email: string; password: string };
189
+ type CrewMember = { id: number; email: string };
190
+
191
+ const signUpKey = new DataProviderKey&amp;lt;SignUp&amp;gt;(&quot;crewSignUp&quot;);
192
+
193
+ @post(new Endpoint&amp;lt;CrewMember&amp;gt;(&quot;api/register&quot;), signUpKey)
194
+ @state()
195
+ payload?: ApiResult&amp;lt;CrewMember&amp;gt;;
196
+
197
+ Basic usage
198
+
199
+ 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.
200
+
201
+ Method form
202
+
203
+ On a method, the decorator calls it with the full ApiResult after each request instead of assigning a property.
204
+
205
+ Sending again
206
+
207
+ Keep th</pre>
208
+ </section>
209
+ <section id="docs-decorators-put" data-doc-id="docs/decorators/put">
210
+ <h2><a href="/docs/decorators/put">@put</a></h2>
211
+ <p><strong>Doc ID:</strong> <code>docs/decorators/put</code> · <a href="/docs/decorators/put">full page</a></p>
212
+ <p>Sends the value of a publisher as the body of a PUT request, to replace a resource, and stores the response in an ApiResult&lt;T&gt; property. It takes the same arguments, options and send(component) handle</p>
213
+ <pre class="doc-excerpt">@put
214
+
215
+ Sends the value of a publisher as the body of a PUT request, to replace a resource, and stores the response in an ApiResult property. It takes the same arguments, options and send(component) handle as @post; only the HTTP method differs.
216
+
217
+ Import
218
+
219
+ import { put, type ApiResult } from &quot;@supersoniks/concorde/decorators&quot;;
220
+ import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
221
+ import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
222
+
223
+ Basic usage
224
+
225
+ The full passenger record is sent on connect and after each body mutation. Placeholders such as ${passengerId} are resolved on the host component.
226
+
227
+ type Passenger = { name: string; flight: string; seat: string };
228
+
229
+ const passengerKey = new DataProviderKey&amp;lt;Passenger&amp;gt;(&quot;passengerForm&quot;);
230
+ const savePassenger = put(
231
+ new Endpoint&amp;lt;Passenger, { passengerId: string }&amp;gt;(&quot;passengers/${passengerId}&quot;),
232
+ passengerKey,
233
+ { autoPostOnBodyMutation: false },
234
+ );
235
+
236
+ @property() passengerId = &quot;ada-lindqvist&quot;;
237
+
238
+ @savePassenger
239
+ @state()
240
+ payload?: ApiResult&amp;lt;Passenger&amp;gt;;
241
+
242
+ async save() {
243
+ await savePassenger.send(this);
244
+ }
245
+
246
+ Triggers, the send method decorator and every option are described on @post.
247
+
248
+ API reference
249
+
250
+ | Argumen</pre>
251
+ </section>
252
+ <section id="docs-getting-started-dataFlow" data-doc-id="docs/getting-started/dataFlow">
253
+ <h2><a href="/docs/getting-started/dataFlow">Data flow</a></h2>
254
+ <p><strong>Doc ID:</strong> <code>docs/getting-started/dataFlow</code> · <a href="/docs/getting-started/dataFlow">full page</a></p>
255
+ <p>Recommended patterns for new Concorde apps (Lit + TypeScript). Under the hood, data lives in a DataProvider store.</p>
256
+ <pre class="doc-excerpt">Data flow
257
+
258
+ Recommended patterns for new Concorde apps (Lit + TypeScript). Under the hood, data lives in a DataProvider store.
259
+
260
+ Quick map
261
+
262
+ | Need | Use |
263
+ |------|-----|
264
+ | Read/write in code | get / set / dp + DataProviderKey (static paths only) |
265
+ | Reactive Lit template | sub(key) or @subscribe |
266
+ | Read component state from store | @subscribe + DataProviderKey + @state |
267
+ | Inherit ancestor attributes | @ancestorAttribute |
268
+ | Write from component state | @publish |
269
+ | React to assignments | @handle |
270
+ | HTTP GET | @get + Endpoint, or sonic-list / sonic-queue with fetch |
271
+ | HTTP POST (body from store) | @post + Endpoint + body DataProviderKey |
272
+ | HTTP PUT / PATCH (body from store) | @put / @patch — same model as @post |
273
+ | Forms | formDataProvider + name on fields (no Subscriber on form elements) |
274
+ | Derived / aggregate (JSONata) | derive() or sonic-jsonata — Jsonata |
275
+ | Offline doc demos | serviceURL=&quot;/docs-mock-api&quot; — Local API demos |
276
+
277
+ Skill: concorde-get-set-dp in the package ai/ folder.
278
+
279
+ DataProviderKey
280
+
281
+ import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
282
+ import { dp, get, set } from &quot;@supersoniks/concorde/utils&quot;;
283
+
284
+ const cartKey = new DataProviderKey&amp;lt;{ items</pre>
285
+ </section>
286
+ <section id="docs-misc-api-configuration" data-doc-id="docs/misc/api-configuration">
287
+ <h2><a href="/docs/misc/api-configuration">API configuration</a></h2>
288
+ <p><strong>Doc ID:</strong> <code>docs/misc/api-configuration</code> · <a href="/docs/misc/api-configuration">full page</a></p>
289
+ <p>APIConfiguration is the object built by HTML.getApiConfiguration from ancestor attributes on the DOM (or from a typed publisher — see @get / @post configuration key). It is passed to API by fetchers, </p>
290
+ <pre class="doc-excerpt">API configuration
291
+
292
+ APIConfiguration is the object built by HTML.getApiConfiguration from ancestor attributes on the DOM (or from a typed publisher — see @get / @post configuration key). It is passed to API by fetchers, sonic-submit, the wording() directive, @get, @post, @put, and @patch.
293
+
294
+ &gt; Mock service: same Local API demos Service Worker / Vite middleware. Routes used on this page are listed in the API config routes section below.
295
+
296
+ Attribute map
297
+
298
+ | Attribute (ancestor) | APIConfiguration field | Role |
299
+ |---------------------|---------------------------|------|
300
+ | serviceURL | serviceURL | Base URL (e.g. /docs-mock-api) |
301
+ | token | token | Static Bearer sent on REST calls |
302
+ | userName / password | userName / password | Basic auth for tokenProvider fetch only |
303
+ | eventsApiToken | authToken | Bearer for tokenProvider when no Basic |
304
+ | tokenProvider | tokenProvider | Path to GET a new token ({ token } JSON) |
305
+ | wordingProvider | — (read by wording()) | Base path + query for label batch GET |
306
+ | wordingVersionProvider | — | Publisher id; bump version → reload wordings |
307
+ | credentials | credentials | fetch credentials mode |
308
+ | addHTTPResponse | addHTTPResponse | Attach sonichttpresponse </pre>
309
+ </section>
310
+ <section id="docs-misc-dynamic-path" data-doc-id="docs/misc/dynamic-path">
311
+ <h2><a href="/docs/misc/dynamic-path">Dynamic path placeholders</a></h2>
312
+ <p><strong>Doc ID:</strong> <code>docs/misc/dynamic-path</code> · <a href="/docs/misc/dynamic-path">full page</a></p>
313
+ <p>Decorators and DataProviderKey paths can include placeholders resolved on the host component at runtime:</p>
314
+ <pre class="doc-excerpt">Dynamic path placeholders
315
+
316
+ Decorators and DataProviderKey paths can include placeholders resolved on the host component at runtime:
317
+
318
+ - ${prop} or {$prop} — e.g. &quot;users/${userId}&quot;, &quot;api/sessions/${sessionId}/sync&quot;
319
+ - Nested expressions — e.g. &quot;teams.${teamId}.members&quot;
320
+
321
+ Resolution is done by resolveDynamicPath. The root property names (userId, sessionId, …) are watched via requestAnimationFrame (see dynamicPropertyWatch.ts).
322
+
323
+ Default behaviour (ready / not ready)
324
+
325
+ | Placeholder value | Path ready? | Inserted segment | Notes |
326
+ |-------------------|---------------|------------------|-------|
327
+ | undefined | no | — | Wait until defined |
328
+ | null | no | — | Same as undefined |
329
+ | &quot;&quot; | yes | empty string | e.g. sessions//sync — request may still run |
330
+ | 0 | yes | &quot;0&quot; | Not treated as “missing” |
331
+ | false | yes | &quot;false&quot; | |
332
+ | 42, &quot;alpha&quot; | yes | &quot;42&quot;, &quot;alpha&quot; | |
333
+
334
+ When ready: false, decorators do not call the network (for @get / @post / @put / @patch), unsubscribe (@bind / @subscribe), or skip publisher binding (@publish / @handle). The decorated property is often left unchanged or set to undefined (HTTP decorators).
335
+
336
+ When the placeholder later becomes valid, observers run again and behaviour r</pre>
337
+ </section>
338
+ <section id="docs-misc-endpoint" data-doc-id="docs/misc/endpoint">
339
+ <h2><a href="/docs/misc/endpoint">Endpoint</a></h2>
340
+ <p><strong>Doc ID:</strong> <code>docs/misc/endpoint</code> · <a href="/docs/misc/endpoint">full page</a></p>
341
+ <p>Endpoint&lt;T, U&gt; describes a single HTTP path (or a path accepted by API.get) and carries the expected response type T. Unlike DataProviderKey, there is no dot-navigation: the path is one string.</p>
342
+ <pre class="doc-excerpt">Endpoint
343
+
344
+ Endpoint describes a single HTTP path (or a path accepted by API.get) and carries the expected response type T. Unlike DataProviderKey, there is no dot-navigation: the path is one string.
345
+
346
+ The optional second generic U (default any) describes host properties used to resolve dynamic segments in the path (${…} / {$…}), for example with @get or @post. See Dynamic path placeholders for null / undefined / &quot;&quot; / 0 and skipEmptyPlaceholder.
347
+
348
+ Import
349
+
350
+ import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
351
+
352
+ Construction
353
+
354
+ const users = new Endpoint&amp;lt;User[]&amp;gt;(&quot;users?limit=10&quot;);
355
+ users.path; // &quot;users?limit=10&quot;
356
+
357
+ const one = new Endpoint&amp;lt;User, { userId: string }&amp;gt;(&quot;users/${userId}&quot;);
358
+ // userId on the host class is observed when used with @get
359
+
360
+ Normalization
361
+
362
+ Endpoint.normalizePath trims the string, rejects an empty path, strips leading slashes for paths relative to serviceURL, collapses duplicate slashes, and validates absolute http(s):// URLs.
363
+
364
+ Publisher key for payloads
365
+
366
+ getDataProviderKey() returns a typed publisher key whose path matches the endpoint path (payload typing follows ApiResult for this endpoint). Useful when pairing @get with @publish / @subscribe (see</pre>
367
+ </section>
368
+ </article>
369
+ </main>
370
+ </body>
371
+ </html>
package/docs/img/archive/credits.json ADDED
@@ -0,0 +1,28 @@
1
+ [
2
+ {
3
+ "file": "public/img/archive/concorde-red-arrows-2002.webm",
4
+ "media": "video",
5
+ "poster": "public/img/archive/concorde-red-arrows-2002-poster.jpg",
6
+ "ref": "commons:191164291",
7
+ "title": "Concorde & Red Arrows 2002",
8
+ "creator": "Steve Elliott from UK",
9
+ "creatorUrl": null,
10
+ "date": "2002",
11
+ "license": "CC BY-SA 2.0",
12
+ "licenseCode": "by-sa",
13
+ "licenseUrl": "https://creativecommons.org/licenses/by-sa/2.0",
14
+ "creditRequired": true,
15
+ "page": "https://commons.wikimedia.org/wiki/File:Concorde_%26_Red_Arrows_2002.webm",
16
+ "via": "Wikimedia Commons",
17
+ "video": "https://upload.wikimedia.org/wikipedia/commons/0/07/Concorde_%26_Red_Arrows_2002.webm",
18
+ "width": 640,
19
+ "height": 360,
20
+ "duration": 10.4,
21
+ "bytes": 402387,
22
+ "credit": "\"Concorde & Red Arrows 2002\" by Steve Elliott from UK, CC BY-SA 2.0, via Wikimedia Commons",
23
+ "notes": [
24
+ "Share-alike: an altered version (recoloured, combined with other pictures) must be shared under the same licence."
25
+ ],
26
+ "saved": "2026-10-25T16:21:03.878Z"
27
+ }
28
+ ]
package/docs/img/concorde/plane_01.jpg ADDED
Binary file
package/docs/img/concorde/plane_02.jpg ADDED
Binary file
package/docs/img/concorde/plane_03.jpg ADDED
Binary file
package/docs/img/concorde/plane_04.jpg ADDED
Binary file
package/docs/img/concorde/plane_05.jpg ADDED
Binary file
package/docs/img/concorde/plane_06.jpg ADDED
Binary file
package/docs/img/concorde/plane_07.jpg ADDED
Binary file
package/docs/img/concorde/plane_08.jpg ADDED
Binary file
package/docs/img/concorde/plane_09.jpg ADDED
Binary file
package/docs/img/concorde/plane_10.jpg ADDED
Binary file
package/docs/img/concorde/plane_11.jpg ADDED
Binary file
package/docs/img/concorde/plane_12.jpg ADDED
Binary file
package/docs/img/concorde/plane_13.jpg ADDED
Binary file
package/docs/index.html CHANGED
@@ -1,94 +1,121 @@
1
1
  <!doctype html>
2
- <html lang="fr">
2
+ <html lang="en">
3
3
  <head>
4
4
  <meta charset="UTF-8" />
5
5
  <link rel="icon" type="image/svg+xml" href="./svg/favicon.svg" />
6
6
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
7
- <title>Concorde - A supersonic design system</title>
8
- <link rel="stylesheet" href="https://use.typekit.net/eda3clw.css" />
7
+ <title>Concorde by Supersoniks — Web components for every stack</title>
8
+ <meta
9
+ name="description"
10
+ content="Concorde is the Supersoniks Lit web-components library: UI, data binding, forms and themes that work in React, Vue, PHP or plain HTML. Docs, npm package @supersoniks/concorde, and llms.txt for agents."
11
+ />
12
+ <meta
13
+ name="keywords"
14
+ content="Concorde, Supersoniks, web components, Lit, design system, @supersoniks/concorde, DataProvider, sonic-button"
15
+ />
16
+ <link rel="canonical" href="https://concorde.supersoniks.org/" />
17
+ <link rel="alternate" type="text/markdown" href="/index.md" title="Markdown" />
18
+ <link rel="alternate" type="text/plain" href="/llms.txt" title="llms.txt" />
19
+ <link rel="preconnect" href="https://fonts.googleapis.com" />
20
+ <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
21
+ <link
22
+ href="https://fonts.googleapis.com/css2?family=Schibsted+Grotesk:wght@400;600;800&display=swap"
23
+ rel="stylesheet"
24
+ />
9
25
  <script src="https://cdn.jsdelivr.net/npm/fuzzysort@2.0.1/fuzzysort.min.js"></script>
10
26
  <!-- <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
11
27
  -->
12
28
  <script src="https://cdn.jsdelivr.net/npm/marked@13.0.3"></script>
13
- <script type="module" crossorigin src="./assets/index-Bb-_LRyY.js"></script>
14
- <link rel="stylesheet" crossorigin href="./assets/index-CD4WyL6o.css">
29
+ <style>
30
+ /*
31
+ Crawler/agent fallback stays in the HTML source (Is Agentic raw-text check)
32
+ but must not take clicks or layout away from the interactive homepage.
33
+ */
34
+ #docs-agent-content {
35
+ display: none !important;
36
+ }
37
+ </style>
38
+ <script type="module" crossorigin src="/assets/index-BgG6FFPt.js"></script>
39
+ <link rel="stylesheet" crossorigin href="/assets/index-x89XINSG.css">
15
40
  </head>
16
- <body class="px-6 lg:px-20">
41
+ <body class="px-4 sm:px-6 lg:px-10 2xl:px-20">
42
+ <!--
43
+ Static homepage copy for agents and no-JS crawlers (Is Agentic / Ora).
44
+ Hidden after JS boot; must stay in raw HTML with a clear H1 and 500+ chars.
45
+ -->
46
+ <section id="docs-agent-content" aria-hidden="true">
47
+ <h1>Concorde by Supersoniks</h1>
48
+ <p>
49
+ Concorde is an open-source Lit web-components library from Supersoniks.
50
+ It provides UI primitives, data binding, forms, routing helpers and
51
+ theming that run the same way in React, Vue, PHP templates or a static
52
+ HTML page. Install the npm package <code>@supersoniks/concorde</code>
53
+ and load components as custom elements.
54
+ </p>
55
+ <h2>Developer resources</h2>
56
+ <p>
57
+ Interactive documentation lives on this site. Machine-readable entry
58
+ points: <a href="/llms.txt">llms.txt</a>,
59
+ <a href="/llms-full.txt">llms-full.txt</a>,
60
+ <a href="/sitemap.xml">sitemap.xml</a>, and the
61
+ <a href="/docs/index.html">documentation index</a>. Prefer
62
+ <code>Accept: text/markdown</code> on doc pathnames (and this homepage)
63
+ to receive Markdown, or open <a href="/index.md">index.md</a>.
64
+ </p>
65
+ <h2>Getting started</h2>
66
+ <p>
67
+ Scaffold a Vite project with Concorde, Tailwind and agent skills, or
68
+ import individual components from
69
+ <code>@supersoniks/concorde</code>. Start with
70
+ <a href="/docs/getting-started/start">/docs/getting-started/start</a>,
71
+ data flow, components index, and AI agents. Topic hubs under
72
+ <code>/hubs/</code> cover decorators, remote data and form components.
73
+ </p>
74
+ <h2>What you can build</h2>
75
+ <p>
76
+ Use sonic-* custom elements for buttons, forms, lists, queues, SDUI
77
+ trees and more. Decorators such as @get, @post, @subscribe and @bind
78
+ wire components to a shared DataProvider without framework lock-in.
79
+ Concorde is MIT-licensed and maintained by Supersoniks for production
80
+ stacks that need one component set across many hosts.
81
+ </p>
82
+ </section>
83
+
17
84
  <sonic-theme
18
85
  customIconLibraryPath="https://cdn.supersoniks.com/concorde/icons/fontawesome/v6/$prefix/$name.svg"
19
86
  customIconDefaultPrefix="regular"
20
- markdownsURL="src"
87
+ markdownsURL=""
21
88
  >
22
89
  <sonic-docs-header></sonic-docs-header>
23
90
  <sonic-router>
24
- <template data-route="^((?!.md).)*$">
25
- <div class="col-span-full">
26
- <div
27
- class="font-headings text-4xl leading-none md:text-5xl lg:text-7xl xl:text-8xl max-w-[29ch] lg:max-w-[19ch] mt-9 mb-10 text-neutral-900"
28
- >
29
- webcomponents for
30
- <div class="animated-text font-medium">
31
- &nbsp;
32
- <span> scoped </span>
33
- <span> consistent </span>
34
- <span> shareable </span>
35
- </div>
36
- user interfaces
37
- </div>
38
- <div class="text-base mt-6 relative z-2 mb-40">
39
- <div
40
- class="inline-flex gap-3 w-full text-lg leading-none flex-col lg:flex-row items-start lg:items-center"
41
- >
42
- <sonic-button
43
- size="2xl"
44
- variant="outline"
45
- type="primary"
46
- href="#docs/_getting-started/start.md/start"
47
- >
48
- <sonic-icon
49
- name="airplane"
50
- library="iconoir"
51
- class="rotate-90 inline-block mr-1"
52
- ></sonic-icon
53
- ><span class="font-bold">Get Started</span>
54
- </sonic-button>
55
- <sonic-code language="bash" inline noEdit class="max-w-full">
56
- <template>
57
- npx @supersoniks/create-concorde-ts-starter "MyProject"
58
- </template></sonic-code
59
- >
60
- </div>
61
- </div>
62
- <img
63
- src="./img/concorde_seuil.png.webp"
64
- alt=""
65
- loading="lazy"
66
- class="w-full block dark:hidden"
67
- />
68
- <img
69
- src="./img/concorde_seuil_invert.png"
70
- alt=""
71
- loading="lazy"
72
- class="w-full hidden dark:block dark:opacity-60"
73
- />
74
- </div>
91
+ <!-- Home only at `/` (doc pages use pathname `/docs/...` or `/core/...`). -->
92
+ <template data-route="^/?$">
93
+ <docs-home></docs-home>
75
94
  </template>
76
95
  </sonic-router>
77
96
 
78
97
  <div
79
- class="[[data-home]_&]:hidden grid grid-cols-[minmax(10rem,15rem)_minmax(0,1fr)] gap-8"
98
+ class="[[data-home]_&]:hidden grid grid-cols-1 lg:grid-cols-[14rem_minmax(0,1fr)] xl:grid-cols-[15rem_minmax(0,1fr)_13rem] gap-8 xl:gap-12"
80
99
  >
81
- <div>
100
+ <aside class="hidden lg:block">
82
101
  <docs-navigation
83
- class="sticky top-[4.2rem] max-h-[calc(100vh_-_4.2rem)] block overflow-auto py-4 custom-scroll"
102
+ class="sticky top-[4.2rem] max-h-[calc(100svh_-_4.2rem)] block overflow-auto py-4 custom-scroll"
84
103
  ></docs-navigation>
85
- </div>
86
- <div class="min-h-[100vh] pt-3">
87
- <docs-page
88
- noShadowDom
89
- class="prose max-w-prose block py-8 prose-li:my-[.2em] leading-[1.5] lg:leading-[1.5] prose-h1:font-normal prose-h1:text-[3.25em] prose-code:before:content-none prose-code:after:content-none prose-pre:font-mono"
90
- ></docs-page>
91
- </div>
104
+ </aside>
105
+ <main class="min-w-0 min-h-[100svh] pt-3">
106
+ <div class="max-w-prose mx-auto xl:mx-0">
107
+ <docs-page
108
+ noShadowDom
109
+ class="prose max-w-none block py-8 prose-li:my-[.2em] leading-[1.5] lg:leading-[1.5] prose-h1:text-[2.4em] sm:prose-h1:text-[3.25em] prose-code:before:content-none prose-code:after:content-none prose-pre:font-mono"
110
+ ></docs-page>
111
+ <docs-pager class="block mt-8 pb-16"></docs-pager>
112
+ </div>
113
+ </main>
114
+ <aside class="hidden xl:block">
115
+ <docs-toc
116
+ class="sticky top-[4.2rem] max-h-[calc(100svh_-_4.2rem)] block overflow-auto py-4 custom-scroll"
117
+ ></docs-toc>
118
+ </aside>
92
119
  </div>
93
120
  </sonic-theme>
94
121
  </body>