@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
@@ -1,76 +0,0 @@
1
- # AI agents (skills & AGENTS.md)
2
-
3
- Concorde ships **skills**, **rules**, and a root **`AGENTS.md`** so Cursor, JetBrains AI Assistant, and other coding agents follow framework patterns (DataProvider, decorators, short imports, scope, theme, migrations).
4
-
5
- On a [starter](#docs/_getting-started/concorde-outside.md/concorde-outside) project, run `yarn ai:sync` after install. On a [manual / brownfield](#docs/_getting-started/concorde-manual-install.md/concorde-manual-install) project, install Concorde first, then use `ai-init` below.
6
-
7
- ## Dedicated commands
8
-
9
- | Context | Command |
10
- |---------|---------|
11
- | [create-concorde-ts-starter](https://www.npmjs.com/package/@supersoniks/create-concorde-ts-starter) project | `yarn ai:sync` |
12
- | Any consumer app (after `yarn add @supersoniks/concorde`) | `node node_modules/@supersoniks/concorde/scripts/ai-init.mjs` |
13
- | Concorde repo (contributors) | `yarn ai-init` |
14
-
15
- <sonic-code language="shell">
16
- <template>
17
- # Starter (from project root)
18
- yarn ai:sync
19
-
20
- # Manual / existing project
21
- node node_modules/@supersoniks/concorde/scripts/ai-init.mjs
22
- </template>
23
- </sonic-code>
24
-
25
- ## Useful flags
26
-
27
- | Flag | Effect |
28
- |------|--------|
29
- | `--skip-agents` | Never write `AGENTS.md` (skills / rules only) |
30
- | `--merge-agents` | Opt-in: keep the project preamble and append / refresh the Concorde block |
31
- | `--force-agents` | Opt-in: **replace** the whole `AGENTS.md` (destructive) |
32
- | `--overlay <dir>` | Extra rules/skills + optional `AGENTS.concorde.md` for project-only Concorde agent notes |
33
- | `--cursor-only` | Install only `.cursor/skills` and `.cursor/rules` |
34
- | `--jetbrains-only` | Install only `.aiassistant/rules/` |
35
-
36
- ## `AGENTS.md` policy (non-invasive)
37
-
38
- | Situation | Default |
39
- |-----------|---------|
40
- | No `AGENTS.md` | Create the Concorde guide |
41
- | File with `<!-- concorde-ai -->` | Refresh the managed zone only |
42
- | File **without** marker (project notes) | **Left untouched** — skills / rules are enough |
43
- | `--merge-agents` / `--force-agents` / `--skip-agents` | See flags above |
44
-
45
- ```text
46
- [optional project preamble — short, project-only]
47
- <!-- concorde-ai -->
48
- <package ai/AGENTS.md>
49
- [--- + overlay AGENTS.concorde.md]
50
- ```
51
-
52
- Everything **after** `<!-- concorde-ai -->` is replaced on each `ai-init` run (idempotent). Do not paste a full copy of the Concorde guide above the marker — put project-specific notes in `AGENTS.concorde.md` (overlay). If the preamble duplicates package `AGENTS.md`, `ai-init` slims or drops it and prints a warning. Legacy filenames `AGENTS.overlay.md` / `AGENTS.starter.md` are still accepted with a deprecation warning.
53
-
54
- ## What gets installed
55
-
56
- | Path | Role |
57
- |------|------|
58
- | `AGENTS.md` | Created only if missing; existing project-owned files are left alone unless `--merge-agents` / `--force-agents` |
59
- | `.cursor/skills/concorde/` | Core Lit + DataProvider patterns |
60
- | `.cursor/skills/concorde-imports/` | Short `@supersoniks/concorde/…` import paths |
61
- | `.cursor/skills/concorde-scope/` | `serviceURL`, `formDataProvider`, API configuration |
62
- | `.cursor/skills/concorde-theme/` | `sonic-theme` and `--sc-*` tokens |
63
- | `.cursor/skills/concorde-menu/` | `sonic-menu` navigation |
64
- | `.cursor/skills/concorde-get-set-dp/` | `get` / `set` / `dp` and `DataProviderKey` migration |
65
- | `.cursor/rules/concorde.mdc` | Cursor rules (always-on patterns) |
66
- | `.aiassistant/rules/concorde.md` | JetBrains AI Assistant rules |
67
-
68
- ## Workflow
69
-
70
- 1. **Starter project:** [Installation](#docs/_getting-started/concorde-outside.md/concorde-outside) — `yarn ai:sync` is wired in the kit.
71
- 2. **Existing / manual Vite project:** [Manual installation](#docs/_getting-started/concorde-manual-install.md/concorde-manual-install), then **`ai-init`** after `yarn add @supersoniks/concorde`.
72
- 3. Commit `.cursor/` and `.aiassistant/` (and `AGENTS.md` only if you opted in / it was created) if your team shares agent settings.
73
- 4. Re-run the same command when you bump `@supersoniks/concorde` to refresh skills from `node_modules/@supersoniks/concorde/ai/`.
74
- 5. In Cursor, skills under `.cursor/skills/` are picked up automatically; mention a skill in chat for focused tasks (e.g. migration → `concorde-get-set-dp`).
75
-
76
- Source files in the npm package: `node_modules/@supersoniks/concorde/ai/` (see also `ai/README.md` in the [Concorde repository](https://github.com/supersoniks/concorde)).
@@ -1,133 +0,0 @@
1
- # Manual installation (Vite)
2
-
3
- > **Legacy** — for brownfield apps or custom stacks. New projects should use the [starter](#docs/_getting-started/concorde-outside.md/concorde-outside).
4
-
5
- ## Brand New Vite Project
6
-
7
- Tailwind configuration is not covered here yet.
8
-
9
- ### Creating the Project
10
-
11
- <sonic-code language="shell">
12
- <template>
13
- # Pure JavaScript project
14
- yarn create vite --template vanilla-js
15
- # TypeScript project
16
- # (it is recommended to use this approach, which installs Lit separately if needed, via "yarn add lit")
17
- yarn create vite --template vanilla-ts
18
- # TypeScript + Lit project
19
- # (creating new web components, for example, to extend the fetch or subscriber mixins)
20
- yarn create vite --template lit-ts
21
- </template>
22
- </sonic-code>
23
-
24
- Using Lit with TypeScript requires the following configuration in the "compilerOptions" section of the `tsconfig.json` file:
25
-
26
- <sonic-code language="json">
27
- <template>
28
- "experimentalDecorators": true,
29
- "useDefineForClassFields": false
30
- </template>
31
- </sonic-code>
32
-
33
- ### Installing Concorde
34
-
35
- Navigate to the project folder created and perform the installation:
36
-
37
- <sonic-code language="shell">
38
- <template>
39
- yarn add @supersoniks/concorde
40
- </template>
41
- </sonic-code>
42
-
43
- Agent skills (`AGENTS.md`, Cursor / JetBrains): see [AI agents](#docs/_getting-started/ai-agents.md/ai-agents) — run `node node_modules/@supersoniks/concorde/scripts/ai-init.mjs` after install.
44
-
45
- ### Development / Build
46
-
47
- <sonic-code language="shell">
48
- <template>
49
- # Development (you can add `--host` after the command chain in package.json's dev script instead of typing it each time as shown below)
50
- yarn dev --host
51
- # Build
52
- yarn build
53
- </template>
54
- </sonic-code>
55
-
56
- ## Shortcut Imports
57
-
58
- Shortcut imports work by default in JavaScript, but in TypeScript, they are activated by choice as they inject data into *tsconfig.json*. Here is the command:
59
-
60
- <sonic-code language="shell">
61
- <template>
62
- npx concorde enable-short-paths
63
- </template>
64
- </sonic-code>
65
-
66
- Shortcut imports replace the actual paths with aliases as follows:
67
-
68
- * `@supersoniks/concorde/core/components/functional_or_ui/component/component` becomes `@supersoniks/concorde/functional_or_ui/component`
69
- * `@supersoniks/concorde/core/mixins_or_utils/class_name` becomes `@supersoniks/concorde/mixins_or_utils/class_name`
70
-
71
- The original paths remain accessible. Shortcut imports are used for the examples later in this documentation.
72
-
73
- ## Usage
74
-
75
- ### Simple Integration in HTML
76
-
77
- Import needed component in `main.ts` or wherever you want to use it:
78
-
79
- <sonic-code language="typescript">
80
- <template>
81
- import "@supersoniks/concorde/ui/button";
82
- </template>
83
- </sonic-code>
84
-
85
- Then in the render function ofyour component or in the HTML of the web page that includes the compiled JS, use the component as follows:
86
-
87
- <sonic-code>
88
- <template>
89
- <sonic-button variant="outline">My button</sonic-button>
90
- </template>
91
- </sonic-code>
92
-
93
- ### Using a Mixin to Create a New Lit Component
94
-
95
- For example, create a file `my-element.ts` at the root:
96
-
97
- <sonic-code language="typescript">
98
- <template>
99
- import { html, LitElement } from "lit";
100
- import { customElement, property } from "lit/decorators.js";
101
- import Fetcher from "@supersoniks/concorde/mixins/Fetcher";
102
- import Subscriber from "@supersoniks/concorde/mixins/Subscriber";
103
-
104
- @customElement("my-element")
105
- export class SonicComponent extends Fetcher(Subscriber(LitElement)) {
106
- @property() email = "";
107
- @property() first_name = "";
108
- @property() last_name = "";
109
-
110
- render() {
111
- return html`<div>
112
- ${this.first_name} ${this.last_name} : ${this.email}
113
- </div>`;
114
- }
115
- }
116
- </template>
117
- </sonic-code>
118
-
119
- Import component `main.ts` or `main.js` or any other component that uses it to be compiled
120
-
121
- <sonic-code language="typescript">
122
- <template>
123
- import "./my-element";
124
- </template>
125
- </sonic-code>
126
-
127
- In the HTML of a JS or TS component or in the HTML of the web page containing the compiled JS:
128
-
129
- <sonic-code language="html">
130
- <template>
131
- <my-element serviceURL="/docs-mock-api" dataProvider="api/users/2" key="data"></my-element>
132
- </template>
133
- </sonic-code>
@@ -1,33 +0,0 @@
1
- # Installation
2
-
3
- <sonic-alert status="info" label="Recommended — use the starter" background>
4
- <p>For almost all new projects, use <a href="https://www.npmjs.com/package/@supersoniks/create-concorde-ts-starter">create-concorde-ts-starter</a></p>
5
- <p>You get Vite + TypeScript + Lit + Tailwind, an example component, <code>npx concorde enable-short-paths</code> ready to run, and <code>yarn ai:sync</code> for <a href="#docs/_getting-started/ai-agents.md/ai-agents">AI agent skills</a> (<code>AGENTS.md</code>, Cursor / JetBrains rules) without extra setup.</p>
6
- </sonic-alert>
7
-
8
- ## Starter
9
-
10
- The following command creates a new Vite project in TypeScript mode with Tailwind and an example component to get started.
11
-
12
- <sonic-code language="shell">
13
- <template>
14
- npx @supersoniks/create-concorde-ts-starter "project_name"
15
- </template>
16
- </sonic-code>
17
-
18
- Then, from the project folder:
19
-
20
- <sonic-code language="shell">
21
- <template>
22
- yarn install
23
- yarn dev --host
24
- </template>
25
- </sonic-code>
26
-
27
- ## Next steps
28
-
29
- | Step | Page |
30
- |------|------|
31
- | Learn patterns | [My first component](#docs/_getting-started/my-first-component.md/my-first-component) |
32
- | Agent skills | [AI agents (skills)](#docs/_getting-started/ai-agents.md/ai-agents) — `yarn ai:sync` on the starter |
33
- | Brownfield / manual Vite | [Legacy: Manual installation](#docs/_getting-started/concorde-manual-install.md/concorde-manual-install) |
@@ -1,120 +0,0 @@
1
- # Legacy: My first subscriber component
2
-
3
- > **New projects:** use [My first component](#docs/_getting-started/my-first-component.md/my-first-component) (`@ancestorAttribute`, `@subscribe` + `DataProviderKey`, `.items` on lists) and [Data flow](#docs/_core-concept/dataFlow.md/dataFlow). This page documents the **Subscriber mixin** used by older apps and core components.
4
-
5
- Learn how to build a component with the **Subscriber** mixin, styled with Tailwind, filled from a DataProvider via automatic property mapping.
6
-
7
- ## Create a classic lit component
8
-
9
- <sonic-code language="javascript" >
10
- <template>
11
- import { html, LitElement, nothing } from "lit";
12
- import { customElement, property } from "lit/decorators.js";
13
- @customElement("docs-user")
14
- export class user extends LitElement {
15
- @property({ type: String }) first_name = "";
16
- @property({ type: String }) last_name = "";
17
- @property({ type: String }) avatar = "";
18
- @property({ type: String }) email = "";
19
- render() {
20
- return html`
21
- &lt;img src="${this.avatar}" /&gt; &lt;br&gt;
22
- ${this.first_name} ${this.last_name} &lt;br&gt;
23
- ${this.email}`;
24
- }
25
- }
26
- </template>
27
- </sonic-code>
28
-
29
- ### Style with tailwind and ui components
30
-
31
- <sonic-code language="javascript">
32
- <template>
33
- import { css, unsafeCSS } from "lit";
34
- import tailwindImport from "./css/tailwind.css?inline";
35
- export const tailwind = css`${unsafeCSS(tailwindImport)}`;
36
- </template>
37
- </sonic-code>
38
-
39
- <sonic-code language="javascript">
40
- <template>
41
- import { html, LitElement } from "lit";
42
- import { customElement, property } from "lit/decorators.js";
43
- import { tailwind } from "../tailwind";
44
- import '@supersoniks/concode/ui/image'
45
- import '@supersoniks/concode/ui/button'
46
- import '@supersoniks/concode/ui/icon'
47
- @customElement("docs-user")
48
- export class user extends LitElement {
49
- static styles = [tailwind];
50
- @property({ type: String }) first_name = "";
51
- @property({ type: String }) last_name = "";
52
- @property({ type: String }) avatar = "";
53
- @property({ type: String }) email = "";
54
- render() {
55
- return html`&lt;div class="flex items-center gap-3 p-2"&gt;
56
- &lt;sonic-image src=${this.avatar} rounded="md" ratio="1/1" class="w-16"&gt;&lt;/sonic-image&gt;
57
- &lt;div&gt;${this.first_name} &lt;span class="font-bold"&gt;${this.last_name}&lt;/span&gt;&lt;/div&gt;
58
- &lt;div class="text-sm text-neutral-400"&gt;${this.email}&lt;/div&gt;
59
- &lt;/div&gt;`;
60
- }
61
- }
62
- </template>
63
- </sonic-code>
64
-
65
- ## Add Subscriber mixin
66
-
67
- <sonic-code language="javascript">
68
- <template>
69
- import Subscriber from "@supersoniks/concorde/core/mixins/Subscriber";
70
- @customElement("docs-user")
71
- export class user extends Subscriber(LitElement) {
72
- // properties auto-filled from DataProvider when names match
73
- }
74
- </template>
75
- </sonic-code>
76
-
77
- See [Legacy: Subscriber mixin](#docs/_core-concept/subscriber.md/subscriber).
78
-
79
- ## Autofill from a dataProvider
80
-
81
- <sonic-code >
82
- <template>
83
- <docs-demo-sources for="list-users-fetch"></docs-demo-sources>
84
- <div serviceURL="/docs-mock-api">
85
- <sonic-fetch
86
- serviceURL="/docs-mock-api"
87
- dataProvider="api/users/3"
88
- key="data">
89
- <docs-user></docs-user>
90
- </sonic-fetch>
91
- </div>
92
- </template>
93
- </sonic-code>
94
-
95
- <sonic-code >
96
- <template>
97
- <sonic-fetch
98
- serviceURL="/docs-mock-api"
99
- dataProvider="api/users/2"
100
- key="data"></sonic-fetch>
101
- <docs-user dataProvider="api/users/2" ></docs-user>
102
- </template>
103
- </sonic-code>
104
-
105
- <sonic-code >
106
- <template>
107
- <div class="grid grid-cols-1 gap-4">
108
- <form formDataProvider="userPreview" class="grid grid-cols-4 gap-3" >
109
- <sonic-input label="First name" type="text" name="first_name" value="Paul" size="sm"></sonic-input>
110
- <sonic-input label="Last name" type="text" name="last_name" value="Metrand" size="sm"></sonic-input>
111
- <sonic-input class="col-span-2" label="email" type="text" name="email" value="paul@example.com" size="sm"></sonic-input>
112
- <sonic-input label="Image url" type="text" name="avatar" value="https://i.pravatar.cc/150?u=paul" size="sm"></sonic-input>
113
- </form>
114
- <sonic-divider align="left">Preview before submit</sonic-divider>
115
- <div dataProvider="userPreview">
116
- <docs-user></docs-user>
117
- </div>
118
- </div>
119
- </template>
120
- </sonic-code>
@@ -1,37 +0,0 @@
1
- # Legacy: Sharing data
2
-
3
- > **New apps:** [Data flow](#docs/_core-concept/dataFlow.md/dataFlow) (`get` / `set` / `DataProviderKey`, decorators). This page documents the historical **Publisher** proxy API (`PublisherManager`, `publisher.set`, `onAssign`, …).
4
-
5
- This section describes how data is shared between graphical and non-graphical components.
6
-
7
- Graphical components should not reference each other directly — they stay decoupled via a **publish/subscribe** store.
8
-
9
- ## The Publisher
10
-
11
- ### Principle
12
-
13
- * The **publisher** is a [JavaScript proxy](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy) that holds data.<br>
14
- Example: `{foo:{hello:["world"]}, bar:"baz"}`
15
-
16
- * Accessing a property (`myPublisher.foo.hello`) returns another **publisher** for that segment.
17
-
18
- * Missing properties create a publisher with internal data `null`, filled later.
19
-
20
- * **Subscribers** listen via `onAssign`, `onInternalMutation`, template filling on the **Subscriber mixin**, etc.
21
-
22
- * Updates use `publisher.set(...)` or nested assignment; changes propagate to subscribers.
23
-
24
- ❇️ Order of creation vs subscription theoretically does not matter.
25
-
26
- ### Methods
27
-
28
- * **set** — replace internal value
29
- <sonic-code language="javascript"><template>publisher.set({foo:{hello:["world"]}, bar:"baz"});</template></sonic-code>
30
-
31
- * **get** — read internal value
32
- <sonic-code language="javascript"><template>publisher.get()</template></sonic-code>
33
-
34
- * **onAssign / offAssign** — react to `set`
35
- <sonic-code language="javascript"><template>publisher.a.b.onAssign(console.log);</template></sonic-code>
36
-
37
- Modern equivalent: `get` / `set` / `@handle` — see [Data flow](#docs/_core-concept/dataFlow.md/dataFlow).
@@ -1,115 +0,0 @@
1
- # FormElement without Subscriber (REDMINE-79569)
2
-
3
- Form fields (`sonic-input`, `textarea`, `select`, `checkbox`, `radio`, `switch`, `button`, `input-autocomplete`) no longer inherit the **Subscriber** mixin.
4
-
5
- ## Behaviour now
6
-
7
- | Before | After |
8
- |--------|--------|
9
- | Dual channel `dataProvider` (autofill) + `formDataProvider` | **`formDataProvider` + `name` only** |
10
- | Ancestor `dataProvider` auto-filled field props | Ignored by form fields |
11
- | `noAutoFill` on fields/buttons inside a `dataProvider` tree | Dead on form fields (attribute harmless; can be cleaned in apps) |
12
-
13
- Preview pattern still valid: form writes via `formDataProvider`, display card reads via `dataProvider` on a **Subscriber** (or `@subscribe`) sibling — not on the fields themselves.
14
-
15
- ## Migration checklist (apps)
16
-
17
- 1. Prefer `formDataProvider` alone on forms / fieldsets.
18
- 2. Drop redundant `dataProvider={sameKey}` on form containers when it only existed for field autofill.
19
- 3. Prefill edit forms with `set(formKey, row)` / `dp(formKey.field).set(...)` before mount — not field `dataProvider`.
20
- 4. Remove `noAutoFill` on `sonic-button` / fields when it only blocked Subscriber autofill.
21
- 5. `initFromPublisher` still works (form publisher only).
22
-
23
- ## Billetterie collect — dual-channel risk
24
-
25
- Files under `la-billetterie/concorde` that mention both `formDataProvider` and `dataProvider=` (review; many are filter+queue, not field autofill):
26
-
27
- ### High priority (same key on form container)
28
-
29
- - `la-billetterie/components/reservation-request/atoms/request-event-form.ts` — `form` / `fieldset` with both attrs equal
30
- - `la-billetterie/components/reservation/atoms/new-quote-form.ts`
31
- - `la-billetterie/components/stats/sales-summary/sales-summary.ts`
32
- - `la-billetterie/components/product/price-selection-form/price-selection-form.ts` — `formDataProvider` + `dataProvider="cart/editForm"`
33
- - `la-billetterie/components/user/account/link-ticket/link-ticket.ts` — distinct keys (API vs form) — keep `dataProvider` only if used by fetch/submit siblings
34
-
35
- ### Filters + queue (usually OK)
36
-
37
- `formDataProvider` on filter bar, `dataProvider` on `sonic-queue` / list — no field autofill dependency:
38
-
39
- - `access-control/components/event/list/index.ts`
40
- - `access-control/components/control/search/views/list.ts`
41
- - `la-billetterie/components/event/form-event-filter/form-event-filter.ts`
42
- - `la-billetterie/components/counter/*` (agenda, store, reservation-request-treatment, …)
43
- - `widgets/agenda/agenda.ts`
44
- - … see full dual list in ticket notes / grep below
45
-
46
- ### Full dual-channel file list (55)
47
-
48
- ```
49
- concorde/src/access-control/components/control/search/views/list.ts
50
- concorde/src/access-control/components/event/list/index.ts
51
- concorde/src/la-billetterie/components/access-control-mobile/access-controller-picker.ts
52
- concorde/src/la-billetterie/components/accreditations-directory/accreditations-directory.ts
53
- concorde/src/la-billetterie/components/address/address-suggestion.ts
54
- concorde/src/la-billetterie/components/bulk/bulk.ts
55
- concorde/src/la-billetterie/components/campaign/campaign-content.ts
56
- concorde/src/la-billetterie/components/counter/agenda/agenda.ts
57
- concorde/src/la-billetterie/components/counter/event-selector/event-selector.ts
58
- concorde/src/la-billetterie/components/counter/order-validation/order-validation-settings.ts
59
- concorde/src/la-billetterie/components/counter/print/format-menu.ts
60
- concorde/src/la-billetterie/components/counter/reservation-request-treatment/reservation-request-treatment.ts
61
- concorde/src/la-billetterie/components/counter/store/counter-store.ts
62
- concorde/src/la-billetterie/components/counter/widgets-settings/widgets-settings-page.ts
63
- concorde/src/la-billetterie/components/custom-list/custom-list.ts
64
- concorde/src/la-billetterie/components/event/agenda/agenda.ts
65
- concorde/src/la-billetterie/components/event/atoms/buy-event-block/buy-event-block.ts
66
- concorde/src/la-billetterie/components/event/atoms/categorizedPrices/categorizedPrices.ts
67
- concorde/src/la-billetterie/components/event/event-store/event-store-content.ts
68
- concorde/src/la-billetterie/components/event/form-event-filter/form-event-filter.ts
69
- concorde/src/la-billetterie/components/form/event-selection/event-selection-filters.ts
70
- concorde/src/la-billetterie/components/form/event-selection/event-selection.ts
71
- concorde/src/la-billetterie/components/giftcards/giftcard-link.ts
72
- concorde/src/la-billetterie/components/layout/header.ts
73
- concorde/src/la-billetterie/components/orders/recover/recover.ts
74
- concorde/src/la-billetterie/components/placing/atoms/placement-choice/placement-choice.ts
75
- concorde/src/la-billetterie/components/placing/seatmap-view/seatmap-view.ts
76
- concorde/src/la-billetterie/components/product/price-selection-form/price-selection-form.ts
77
- concorde/src/la-billetterie/components/product/prices-form/price-button/price-button.ts
78
- concorde/src/la-billetterie/components/purchase/purchase-summary/complementary-info/complementary-info.ts
79
- concorde/src/la-billetterie/components/reservation-request/atoms/request-event-form.ts
80
- concorde/src/la-billetterie/components/reservation/atoms/new-quote-form.ts
81
- concorde/src/la-billetterie/components/reservation/reservation-content.ts
82
- concorde/src/la-billetterie/components/seatmap/seatmap.ts
83
- concorde/src/la-billetterie/components/shop/shop.ts
84
- concorde/src/la-billetterie/components/stats/dashboard/dashboard.ts
85
- concorde/src/la-billetterie/components/stats/event/event-stats-check.ts
86
- concorde/src/la-billetterie/components/stats/sales-summary/sales-summary.ts
87
- concorde/src/la-billetterie/components/subscription/atoms/quick-select-display-toggle/quick-select-display-toggle.ts
88
- concorde/src/la-billetterie/components/subscription/cart-quick-select.ts
89
- concorde/src/la-billetterie/components/subscription/edit/subscription-renew-form.ts
90
- concorde/src/la-billetterie/components/ticket/ticket-freeup.ts
91
- concorde/src/la-billetterie/components/tickets-app/default-router.ts
92
- concorde/src/la-billetterie/components/user/account/account-purchases.ts
93
- concorde/src/la-billetterie/components/user/account/account-tickets.ts
94
- concorde/src/la-billetterie/components/user/account/link-ticket/link-ticket.ts
95
- concorde/src/la-billetterie/components/user/form/login.ts
96
- concorde/src/la-billetterie/components/user/user-attach/buyer-attach-form.ts
97
- concorde/src/la-billetterie/components/user/user-attach/buyer-attach.ts
98
- concorde/src/la-billetterie/components/user/user-attach/owner-attach-form.ts
99
- concorde/src/la-billetterie/components/user/user-attach/subscription-attach-form.ts
100
- concorde/src/la-billetterie/components/user/user-attach/subscription-selector.ts
101
- concorde/src/la-billetterie/components/user/user-selector/user-selector.ts
102
- concorde/src/la-billetterie/components/user/user-suggest/user-suggest.ts
103
- concorde/src/widgets/agenda/agenda.ts
104
- ```
105
-
106
- Re-run audit:
107
-
108
- ```bash
109
- # from la-billetterie
110
- rg -l 'formDataProvider' concorde/src | while read f; do rg -q 'dataProvider\s*=' "$f" && echo "$f"; done
111
- ```
112
-
113
- ## Non-regression (Concorde docs)
114
-
115
- Smoke form demos: input, textarea, select, checkbox (incl. check-all), radio, switch, button form modes, queue + `dataFilterProvider`, submit, validation / sameValueAs, input-autocomplete.
@@ -1,110 +0,0 @@
1
- import { html, LitElement } from "lit";
2
- import { customElement } from "lit/decorators.js";
3
- import { DOCS_MOCK_GEO_SERVICE } from "../mock-api/urls";
4
-
5
- import "../../core/components/ui/form/input-autocomplete/input-autocomplete";
6
- import "../../core/components/ui/menu/menu-item";
7
-
8
- type CommuneRow = { nom: string; code: string };
9
-
10
- /** Ligne suggestion : pas de radio/name (évite d'écrire dans le form au render). */
11
- const communeItem =
12
- (valueKey: "nom" | "code") => (item: CommuneRow) =>
13
- html`<sonic-menu-item
14
- data-autocomplete-value=${item[valueKey]}
15
- data-autocomplete-label=${item.nom}
16
- >${item.nom}</sonic-menu-item
17
- >`;
18
-
19
- @customElement("docs-input-autocomplete-basic-demo")
20
- export class DocsInputAutocompleteBasicDemo extends LitElement {
21
- private items = communeItem("nom");
22
-
23
- render() {
24
- return html`
25
- <sonic-input-autocomplete
26
- class="w-64"
27
- label="Ville"
28
- formDataProvider="autoComplete-example-base"
29
- name="nom"
30
- placeholder="Paris, Lyon, Tours, ..."
31
- serviceURL=${DOCS_MOCK_GEO_SERVICE}
32
- dataProviderExpression="communes?limit=5"
33
- .items=${this.items}
34
- ></sonic-input-autocomplete>
35
- `;
36
- }
37
- }
38
-
39
- @customElement("docs-input-autocomplete-code-demo")
40
- export class DocsInputAutocompleteCodeDemo extends LitElement {
41
- private items = communeItem("code");
42
-
43
- render() {
44
- return html`
45
- <sonic-input-autocomplete
46
- class="w-64"
47
- label="Ville (code INSEE)"
48
- formDataProvider="autoComplete-example"
49
- name="code"
50
- value="13055"
51
- placeholder="Paris, Lyon, Tours, ..."
52
- serviceURL=${DOCS_MOCK_GEO_SERVICE}
53
- dataProviderExpression="communes?limit=5"
54
- searchParameter="nom"
55
- .items=${this.items}
56
- ></sonic-input-autocomplete>
57
- `;
58
- }
59
- }
60
-
61
- @customElement("docs-input-autocomplete-select-demo")
62
- export class DocsInputAutocompleteSelectDemo extends LitElement {
63
- private items = communeItem("code");
64
-
65
- render() {
66
- return html`
67
- <sonic-input-autocomplete
68
- select
69
- class="w-64"
70
- label="Ville (select)"
71
- formDataProvider="autoComplete-example2"
72
- name="code"
73
- value="69123"
74
- placeholder="Paris, Lyon, Tours, ..."
75
- serviceURL=${DOCS_MOCK_GEO_SERVICE}
76
- dataProviderExpression="communes?limit=5"
77
- searchParameter="nom"
78
- .items=${this.items}
79
- ></sonic-input-autocomplete>
80
- `;
81
- }
82
- }
83
-
84
- @customElement("docs-input-autocomplete-keyboard-demo")
85
- export class DocsInputAutocompleteKeyboardDemo extends LitElement {
86
- private items = (item: CommuneRow) =>
87
- html`<sonic-menu-item
88
- data-keyboard-nav="nav-autocomplete"
89
- data-autocomplete-value=${item.nom}
90
- data-autocomplete-label=${item.nom}
91
- >${item.nom}</sonic-menu-item
92
- >`;
93
-
94
- render() {
95
- return html`
96
- <sonic-input-autocomplete
97
- class="w-64"
98
- label="Ville"
99
- formDataProvider="autoComplete-example-keyboard"
100
- name="nom"
101
- data-keyboard-nav="nav-autocomplete"
102
- placeholder="Paris, Lyon, Tours, ..."
103
- serviceURL=${DOCS_MOCK_GEO_SERVICE}
104
- dataProviderExpression="communes?limit=60"
105
- minSearchLength="1"
106
- .items=${this.items}
107
- ></sonic-input-autocomplete>
108
- `;
109
- }
110
- }