@supersoniks/concorde 5.1.2 → 5.1.3-immutable.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (497) hide show
  1. package/.agents/skills/concorde-docs/SKILL.md +1 -1
  2. package/.claude/skills +1 -0
  3. package/.github/workflows/ci.yml +21 -0
  4. package/.github-export-ignore +30 -0
  5. package/CONTRIBUTING.md +59 -0
  6. package/DEV.md +54 -0
  7. package/LICENSE +21 -0
  8. package/OPEN_SOURCE_CHECKPOINT.md +133 -0
  9. package/README.md +1 -1
  10. package/ai/README.md +29 -41
  11. package/ai/skills/concorde/SKILL.md +54 -324
  12. package/ai/skills/concorde/rules/composition.md +32 -0
  13. package/ai/skills/concorde/rules/data.md +47 -0
  14. package/ai/skills/concorde/rules/http.md +25 -0
  15. package/ai/skills/concorde/rules/lists-forms.md +35 -0
  16. package/ai/skills/concorde/rules/styling.md +46 -0
  17. package/ai/skills/concorde/rules/troubleshooting.md +45 -0
  18. package/build-infos.json +1 -1
  19. package/concorde-core.bundle.js +177 -177
  20. package/concorde-core.es.js +4993 -4833
  21. package/custom-elements-manifest.public.config.mjs +8 -0
  22. package/{.tmp-cem/custom-elements.json → custom-elements.json} +11722 -8868
  23. package/dist/concorde-core.bundle.js +177 -177
  24. package/dist/concorde-core.es.js +4993 -4833
  25. package/dist/docs-mock-api-sw.js +58 -223
  26. package/dist/docs-mock-api-sw.js.map +4 -4
  27. package/dist/img/og-concorde.jpg +0 -0
  28. package/dist/robots.txt +11 -10
  29. package/docs/assets/index-CD4WyL6o.css +1 -0
  30. package/docs/assets/index-D_alEsng.js +12122 -0
  31. package/docs/crawl/core/components/functional/date/date.html +190 -0
  32. package/docs/crawl/core/components/functional/fetch/fetch.html +109 -0
  33. package/docs/crawl/core/components/functional/if/if.html +27 -0
  34. package/docs/crawl/core/components/functional/jsonata/jsonata.html +79 -0
  35. package/docs/crawl/core/components/functional/list/list.html +70 -0
  36. package/docs/crawl/core/components/functional/mix/mix.html +45 -0
  37. package/docs/crawl/core/components/functional/queue/queue.html +96 -0
  38. package/docs/crawl/core/components/functional/router/router.html +106 -0
  39. package/docs/{core → crawl/core}/components/functional/sdui/sdui-extension-points.html +8 -9
  40. package/docs/crawl/core/components/functional/sdui/sdui.html +368 -0
  41. package/docs/crawl/core/components/functional/states/states.html +66 -0
  42. package/docs/crawl/core/components/functional/submit/submit.html +160 -0
  43. package/docs/{core → crawl/core}/components/functional/subscriber/subscriber.html +5 -6
  44. package/docs/crawl/core/components/functional/value/value.html +51 -0
  45. package/docs/{core → crawl/core}/components/ui/alert/alert.html +63 -53
  46. package/docs/{core → crawl/core}/components/ui/alert-messages/alert-messages.html +5 -6
  47. package/docs/{core → crawl/core}/components/ui/badge/badge.html +33 -33
  48. package/docs/crawl/core/components/ui/button/button.html +150 -0
  49. package/docs/crawl/core/components/ui/captcha/captcha.html +112 -0
  50. package/docs/{core → crawl/core}/components/ui/card/card.html +11 -12
  51. package/docs/{core → crawl/core}/components/ui/divider/divider.html +14 -14
  52. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +73 -0
  53. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +266 -0
  54. package/docs/{core → crawl/core}/components/ui/form/form-actions/form-actions.html +23 -23
  55. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +121 -0
  56. package/docs/crawl/core/components/ui/form/input/input.html +109 -0
  57. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +38 -0
  58. package/docs/crawl/core/components/ui/form/radio/radio.html +56 -0
  59. package/docs/crawl/core/components/ui/form/select/select.html +73 -0
  60. package/docs/crawl/core/components/ui/form/switch/switch.html +56 -0
  61. package/docs/crawl/core/components/ui/form/textarea/textarea.html +59 -0
  62. package/docs/crawl/core/components/ui/group/group.html +104 -0
  63. package/docs/{core → crawl/core}/components/ui/icon/icon.html +9 -10
  64. package/docs/crawl/core/components/ui/image/image.html +298 -0
  65. package/docs/{core → crawl/core}/components/ui/link/link.html +11 -12
  66. package/docs/crawl/core/components/ui/loader/loader.html +124 -0
  67. package/docs/{core → crawl/core}/components/ui/menu/menu.html +33 -34
  68. package/docs/crawl/core/components/ui/modal/modal.html +342 -0
  69. package/docs/crawl/core/components/ui/pop/pop.html +296 -0
  70. package/docs/{core → crawl/core}/components/ui/progress/progress.html +7 -8
  71. package/docs/crawl/core/components/ui/table/table.html +545 -0
  72. package/docs/crawl/core/components/ui/theme/theme.html +131 -0
  73. package/docs/crawl/core/components/ui/toast/toast.html +233 -0
  74. package/docs/crawl/core/components/ui/tooltip/tooltip.html +140 -0
  75. package/docs/{docs/getting-started → crawl/docs/_core-concept}/dataFlow.html +29 -26
  76. package/docs/crawl/docs/_core-concept/overview.html +66 -0
  77. package/docs/crawl/docs/_core-concept/subscriber.html +75 -0
  78. package/docs/crawl/docs/_decorators/ancestor-attribute.html +117 -0
  79. package/docs/crawl/docs/_decorators/auto-subscribe.html +202 -0
  80. package/docs/crawl/docs/_decorators/bind.html +141 -0
  81. package/docs/crawl/docs/_decorators/get.html +149 -0
  82. package/docs/crawl/docs/_decorators/handle.html +165 -0
  83. package/docs/crawl/docs/_decorators/on-assign.html +355 -0
  84. package/docs/crawl/docs/_decorators/patch.html +78 -0
  85. package/docs/crawl/docs/_decorators/post.html +139 -0
  86. package/docs/crawl/docs/_decorators/publish.html +61 -0
  87. package/docs/crawl/docs/_decorators/put.html +78 -0
  88. package/docs/crawl/docs/_decorators/subscribe.html +109 -0
  89. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +137 -0
  90. package/docs/crawl/docs/_directives/sub.html +93 -0
  91. package/docs/{docs/getting-started → crawl/docs/_getting-started}/ai-agents.html +11 -12
  92. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +100 -0
  93. package/docs/crawl/docs/_getting-started/concorde-outside.html +58 -0
  94. package/docs/{docs/getting-started → crawl/docs/_getting-started}/create-a-component.html +14 -11
  95. package/docs/{docs/getting-started → crawl/docs/_getting-started}/my-first-component.html +22 -13
  96. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +110 -0
  97. package/docs/crawl/docs/_getting-started/pubsub.html +62 -0
  98. package/docs/crawl/docs/_getting-started/start.html +76 -0
  99. package/docs/{docs/getting-started → crawl/docs/_getting-started}/theming.html +9 -10
  100. package/docs/{docs/misc → crawl/docs/_misc}/api-configuration.html +18 -18
  101. package/docs/{docs/misc → crawl/docs/_misc}/dataProviderKey.html +11 -12
  102. package/docs/{docs/misc → crawl/docs/_misc}/docs-mock-api.html +28 -25
  103. package/docs/{docs/misc → crawl/docs/_misc}/dynamic-path.html +15 -16
  104. package/docs/{docs/misc → crawl/docs/_misc}/endpoint.html +15 -16
  105. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +138 -0
  106. package/docs/{docs/misc → crawl/docs/_misc}/html-integration.html +15 -12
  107. package/docs/crawl/hubs/decorators.html +547 -0
  108. package/docs/crawl/hubs/form-components.html +381 -0
  109. package/docs/crawl/hubs/remote-data.html +452 -0
  110. package/docs/crawl/index.html +103 -0
  111. package/docs/docs-mock-api-sw.js +223 -58
  112. package/docs/docs-mock-api-sw.js.map +4 -4
  113. package/docs/index.html +68 -95
  114. package/docs/llms-full.txt +3610 -2231
  115. package/docs/llms.txt +86 -94
  116. package/docs/robots.txt +10 -11
  117. package/docs/sitemap.xml +84 -78
  118. package/docs/src/core/components/functional/date/date.md +231 -91
  119. package/docs/src/core/components/functional/fetch/fetch.md +83 -66
  120. package/docs/src/core/components/functional/if/if.md +3 -28
  121. package/docs/src/core/components/functional/jsonata/jsonata.md +37 -42
  122. package/docs/src/core/components/functional/list/list.md +43 -99
  123. package/docs/src/core/components/functional/mix/mix.md +26 -31
  124. package/docs/src/core/components/functional/queue/queue.md +61 -40
  125. package/docs/src/core/components/functional/router/router.md +65 -64
  126. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  127. package/docs/src/core/components/functional/sdui/component-catalog.json +1 -1
  128. package/docs/src/core/components/functional/sdui/example.json +86 -19
  129. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  130. package/docs/src/core/components/functional/sdui/sdui.md +358 -187
  131. package/docs/src/core/components/functional/states/states.md +61 -86
  132. package/docs/src/core/components/functional/submit/submit.md +72 -64
  133. package/docs/src/core/components/functional/value/value.md +22 -34
  134. package/docs/src/core/components/ui/alert/alert.md +58 -48
  135. package/docs/src/core/components/ui/badge/badge.md +34 -27
  136. package/docs/src/core/components/ui/button/button.md +106 -139
  137. package/docs/src/core/components/ui/captcha/captcha.md +32 -17
  138. package/docs/src/core/components/ui/card/card.md +6 -6
  139. package/docs/src/core/components/ui/divider/divider.md +11 -8
  140. package/docs/src/core/components/ui/form/checkbox/checkbox.md +42 -90
  141. package/docs/src/core/components/ui/form/fieldset/fieldset.md +75 -31
  142. package/docs/src/core/components/ui/form/form-actions/form-actions.md +16 -14
  143. package/docs/src/core/components/ui/form/form-layout/form-layout.md +29 -19
  144. package/docs/src/core/components/ui/form/input/input.md +95 -95
  145. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +29 -0
  146. package/docs/src/core/components/ui/form/radio/radio.md +34 -55
  147. package/docs/src/core/components/ui/form/select/select.md +45 -60
  148. package/docs/src/core/components/ui/form/switch/switch.md +34 -57
  149. package/docs/src/core/components/ui/form/textarea/textarea.md +38 -55
  150. package/docs/src/core/components/ui/group/group.md +33 -35
  151. package/docs/src/core/components/ui/icon/icon.md +4 -4
  152. package/docs/src/core/components/ui/image/image.md +107 -41
  153. package/docs/src/core/components/ui/link/link.md +6 -6
  154. package/docs/src/core/components/ui/loader/loader.md +55 -30
  155. package/docs/src/core/components/ui/menu/menu.md +27 -27
  156. package/docs/src/core/components/ui/modal/modal.md +96 -72
  157. package/docs/src/core/components/ui/pop/pop.md +158 -80
  158. package/docs/src/core/components/ui/progress/progress.md +2 -2
  159. package/docs/src/core/components/ui/table/table.md +255 -91
  160. package/docs/src/core/components/ui/theme/theme.md +36 -11
  161. package/docs/src/core/components/ui/toast/toast.md +117 -48
  162. package/docs/src/core/components/ui/tooltip/tooltip.md +62 -27
  163. package/docs/{docs/getting-started → src/docs/_core-concept}/dataFlow.md +18 -17
  164. package/docs/src/docs/_core-concept/overview.md +57 -0
  165. package/docs/src/docs/_core-concept/subscriber.md +75 -0
  166. package/docs/src/docs/_decorators/ancestor-attribute.md +128 -0
  167. package/docs/src/docs/_decorators/auto-subscribe.md +202 -0
  168. package/docs/src/docs/_decorators/bind.md +167 -0
  169. package/docs/src/docs/_decorators/get.md +162 -0
  170. package/docs/src/docs/_decorators/handle.md +175 -0
  171. package/docs/src/docs/_decorators/on-assign.md +390 -0
  172. package/docs/src/docs/_decorators/patch.md +70 -0
  173. package/docs/src/docs/_decorators/post.md +146 -0
  174. package/docs/src/docs/_decorators/publish.md +55 -0
  175. package/docs/src/docs/_decorators/put.md +70 -0
  176. package/docs/src/docs/_decorators/subscribe.md +100 -0
  177. package/docs/src/docs/_decorators/wait-for-ancestors.md +163 -0
  178. package/docs/src/docs/_directives/sub.md +91 -0
  179. package/docs/src/docs/{getting-started → _getting-started}/ai-agents.md +3 -3
  180. package/docs/src/docs/_getting-started/concorde-manual-install.md +133 -0
  181. package/docs/src/docs/_getting-started/concorde-outside.md +33 -0
  182. package/docs/{docs/getting-started → src/docs/_getting-started}/create-a-component.md +6 -3
  183. package/docs/src/docs/{getting-started → _getting-started}/my-first-component.md +14 -5
  184. package/docs/src/docs/_getting-started/my-first-subscriber.md +120 -0
  185. package/docs/src/docs/_getting-started/pubsub.md +37 -0
  186. package/docs/src/docs/{getting-started → _getting-started}/start.md +13 -1
  187. package/docs/src/docs/{getting-started → _getting-started}/theming.md +2 -2
  188. package/docs/src/docs/{misc → _misc}/api-configuration.md +12 -10
  189. package/docs/src/docs/{misc → _misc}/dataProviderKey.md +4 -4
  190. package/docs/{docs/misc → src/docs/_misc}/docs-mock-api.md +13 -12
  191. package/docs/{docs/misc → src/docs/_misc}/dynamic-path.md +8 -8
  192. package/docs/{docs/misc → src/docs/_misc}/endpoint.md +8 -8
  193. package/docs/src/docs/_misc/formelement-subscriber-removal.md +115 -0
  194. package/docs/{docs/misc → src/docs/_misc}/html-integration.md +5 -4
  195. package/docs/src/docs/search/docs-search.json +4375 -2420
  196. package/docs/src/tsconfig.declarations.json +22 -0
  197. package/docs/src/tsconfig.emit.json +23 -0
  198. package/docs/src/tsconfig.json +2 -23
  199. package/gitlab/job_github_mirror.sh +39 -0
  200. package/index.html +89 -0
  201. package/package.json +22 -4
  202. package/public/img/og-concorde.jpg +0 -0
  203. package/scripts/ai-init.mjs +104 -379
  204. package/scripts/ai-init.test.mjs +81 -239
  205. package/scripts/docs-markdown-vite-plugin.ts +11 -5
  206. package/scripts/docs-public-url.mjs +6 -0
  207. package/scripts/docs.htaccess +7 -0
  208. package/scripts/generate-cem.mjs +244 -0
  209. package/scripts/generate-cem.test.mjs +122 -0
  210. package/scripts/generate-crawl-docs.mjs +29 -5
  211. package/scripts/generate-sdui-catalog.mjs +11 -10
  212. package/scripts/github-export.mjs +150 -0
  213. package/scripts/post-build-docs.js +3 -0
  214. package/scripts/post-build.mjs +0 -0
  215. package/scripts/pre-publish.mjs +2 -1
  216. package/scripts/site-pages.mjs +212 -0
  217. package/scripts/site-pages.test.mjs +116 -0
  218. package/site-pages/about.md +22 -0
  219. package/site-pages/privacy.md +32 -0
  220. package/src/core/components/functional/date/date.md +1 -1
  221. package/src/core/components/functional/example/example.ts +3 -1
  222. package/src/core/components/functional/if/if.ts +0 -0
  223. package/src/core/components/functional/list/list.demo.ts +0 -0
  224. package/src/core/components/functional/list/list.md +6 -2
  225. package/src/core/components/functional/list/list.ts +17 -4
  226. package/src/core/components/functional/mix/mix.md +0 -0
  227. package/src/core/components/functional/router/router.demo.ts +0 -0
  228. package/src/core/components/functional/router/router.ts +0 -0
  229. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  230. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  231. package/src/core/components/functional/sdui/component-catalog.json +2 -2
  232. package/src/core/components/functional/sdui/example.json +0 -0
  233. package/src/core/components/functional/sdui/sdui-immutable.spec.ts +74 -0
  234. package/src/core/components/functional/sdui/sdui.ts +33 -8
  235. package/src/core/components/functional/sdui/types.ts +0 -0
  236. package/src/core/components/functional/states/states.ts +0 -0
  237. package/src/core/components/functional/submit/submit.spec.ts +60 -0
  238. package/src/core/components/functional/submit/submit.ts +6 -3
  239. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  240. package/src/core/components/functional/value/value.md +0 -0
  241. package/src/core/components/functional/value/value.ts +0 -0
  242. package/src/core/components/ui/_css/size.ts +0 -0
  243. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  244. package/src/core/components/ui/card/card.md +1 -1
  245. package/src/core/components/ui/form/input/input.md +19 -1
  246. package/src/core/components/ui/form/input/input.ts +8 -2
  247. package/src/core/components/ui/form/radio/radio.md +14 -0
  248. package/src/core/components/ui/image/image.md +17 -17
  249. package/src/core/components/ui/modal/modal.md +2 -2
  250. package/src/core/decorators/subscriber/bind.ts +9 -14
  251. package/src/core/decorators/subscriber/subscribe.ts +15 -9
  252. package/src/core/decorators/subscriber/subscribe.type-test.ts +14 -5
  253. package/src/core/mixins/Subscriber.ts +0 -0
  254. package/src/core/utils/DataBindObserver.ts +0 -0
  255. package/src/core/utils/Objects.ts +0 -0
  256. package/src/core/utils/PublisherProxy.ts +166 -125
  257. package/src/core/utils/deepReadonly.spec.ts +66 -0
  258. package/src/core/utils/deepReadonly.ts +71 -0
  259. package/src/core/utils/immutableValue.spec.ts +54 -0
  260. package/src/core/utils/immutableValue.ts +102 -0
  261. package/src/core/utils/nestedDotForm.spec.ts +88 -0
  262. package/src/core/utils/publisherImmutable.spec.ts +76 -0
  263. package/src/core/utils/route.ts +0 -0
  264. package/src/core/utils/strictGet.spec.ts +61 -0
  265. package/src/core/utils/strictGet.ts +102 -0
  266. package/src/css.d.ts +19 -0
  267. package/src/docs/components/docs-demo-sources.ts +3 -3
  268. package/src/docs/decorators/bind.md +23 -24
  269. package/src/docs/docs-location.spec.ts +10 -0
  270. package/src/docs/docs-location.ts +10 -0
  271. package/src/docs/example/decorators-demo-bind-demos.ts +11 -28
  272. package/src/docs/example/docs-toggle-demos.ts +1 -1
  273. package/src/docs/example/users.ts +0 -0
  274. package/src/docs/getting-started/ai-agents.md +29 -55
  275. package/src/docs/getting-started/dataFlow.md +2 -2
  276. package/src/docs/home/home.ts +3 -1
  277. package/src/docs/misc/publisher-get-immutability-docs-crawl.json +902 -0
  278. package/src/docs/misc/publisher-get-immutability-docs-recheck.json +13 -0
  279. package/src/docs/misc/publisher-get-immutability-study.md +229 -0
  280. package/src/docs/navigation/navigation.ts +5 -1
  281. package/src/docs/search/docs-search.json +358 -58
  282. package/src/docs/search/markdown-renderer.ts +6 -1
  283. package/src/docs/tailwind/css/docs/content.css +4 -5
  284. package/src/tsconfig.declarations.json +22 -0
  285. package/src/tsconfig.emit.json +23 -0
  286. package/src/tsconfig.json +53 -5
  287. package/src/tsconfig.tsbuildinfo +1 -1
  288. package/.taste-skill/after/desktop-fold.jpg +0 -0
  289. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  290. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  291. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  292. package/.taste-skill/after/mobile-fold.jpg +0 -0
  293. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  294. package/.taste-skill/after/report.json +0 -4103
  295. package/.taste-skill/after/tablet-fold.jpg +0 -0
  296. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  297. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  298. package/.taste-skill/before/desktop-fold.jpg +0 -0
  299. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  300. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  301. package/.taste-skill/before/mobile-fold.jpg +0 -0
  302. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  303. package/.taste-skill/before/report.json +0 -2556
  304. package/.taste-skill/before/tablet-fold.jpg +0 -0
  305. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  306. package/.taste-skill/direction.json +0 -510
  307. package/.taste-skill/notes.md +0 -84
  308. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  309. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  310. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  311. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  312. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  313. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  314. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  315. package/.taste-skill/prod/report.json +0 -1973
  316. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  317. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  318. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  319. package/AUDIT.md +0 -228
  320. package/PLAN-AMELIORATION.md +0 -220
  321. package/PLAN-DOCS-AGENTS.md +0 -80
  322. package/ai/AGENTS.md +0 -56
  323. package/ai/cursor/rules/concorde-menu.mdc +0 -15
  324. package/ai/cursor/rules/concorde-scope.mdc +0 -14
  325. package/ai/cursor/rules/concorde-theme.mdc +0 -13
  326. package/ai/cursor/rules/concorde.mdc +0 -66
  327. package/ai/jetbrains/rules/concorde.md +0 -53
  328. package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
  329. package/ai/skills/concorde-imports/SKILL.md +0 -78
  330. package/ai/skills/concorde-menu/SKILL.md +0 -74
  331. package/ai/skills/concorde-scope/SKILL.md +0 -70
  332. package/ai/skills/concorde-theme/SKILL.md +0 -57
  333. package/docs/.htaccess +0 -75
  334. package/docs/404.html +0 -15
  335. package/docs/404.md +0 -5
  336. package/docs/assets/index-BgG6FFPt.js +0 -11765
  337. package/docs/assets/index-x89XINSG.css +0 -1
  338. package/docs/core/components/functional/date/date.html +0 -211
  339. package/docs/core/components/functional/date/date.md +0 -150
  340. package/docs/core/components/functional/fetch/fetch.html +0 -180
  341. package/docs/core/components/functional/fetch/fetch.md +0 -108
  342. package/docs/core/components/functional/if/if.html +0 -65
  343. package/docs/core/components/functional/if/if.md +0 -34
  344. package/docs/core/components/functional/jsonata/jsonata.html +0 -110
  345. package/docs/core/components/functional/jsonata/jsonata.md +0 -61
  346. package/docs/core/components/functional/list/list.html +0 -198
  347. package/docs/core/components/functional/list/list.md +0 -121
  348. package/docs/core/components/functional/mix/mix.html +0 -78
  349. package/docs/core/components/functional/mix/mix.md +0 -46
  350. package/docs/core/components/functional/queue/queue.html +0 -155
  351. package/docs/core/components/functional/queue/queue.md +0 -51
  352. package/docs/core/components/functional/router/router.html +0 -154
  353. package/docs/core/components/functional/router/router.md +0 -93
  354. package/docs/core/components/functional/sdui/sdui-extension-points.md +0 -94
  355. package/docs/core/components/functional/sdui/sdui.html +0 -397
  356. package/docs/core/components/functional/sdui/sdui.md +0 -307
  357. package/docs/core/components/functional/states/states.html +0 -141
  358. package/docs/core/components/functional/states/states.md +0 -112
  359. package/docs/core/components/functional/submit/submit.html +0 -178
  360. package/docs/core/components/functional/submit/submit.md +0 -106
  361. package/docs/core/components/functional/subscriber/subscriber.md +0 -91
  362. package/docs/core/components/functional/translation/translation.html +0 -60
  363. package/docs/core/components/functional/translation/translation.md +0 -38
  364. package/docs/core/components/functional/value/value.html +0 -81
  365. package/docs/core/components/functional/value/value.md +0 -47
  366. package/docs/core/components/ui/alert/alert.md +0 -186
  367. package/docs/core/components/ui/alert-messages/alert-messages.md +0 -85
  368. package/docs/core/components/ui/badge/badge.md +0 -181
  369. package/docs/core/components/ui/button/button.html +0 -309
  370. package/docs/core/components/ui/button/button.md +0 -216
  371. package/docs/core/components/ui/captcha/captcha.html +0 -80
  372. package/docs/core/components/ui/captcha/captcha.md +0 -56
  373. package/docs/core/components/ui/card/card.md +0 -215
  374. package/docs/core/components/ui/divider/divider.md +0 -126
  375. package/docs/core/components/ui/form/checkbox/checkbox.html +0 -200
  376. package/docs/core/components/ui/form/checkbox/checkbox.md +0 -125
  377. package/docs/core/components/ui/form/fieldset/fieldset.html +0 -238
  378. package/docs/core/components/ui/form/fieldset/fieldset.md +0 -161
  379. package/docs/core/components/ui/form/form-actions/form-actions.md +0 -98
  380. package/docs/core/components/ui/form/form-layout/form-layout.html +0 -115
  381. package/docs/core/components/ui/form/form-layout/form-layout.md +0 -109
  382. package/docs/core/components/ui/form/input/input.html +0 -235
  383. package/docs/core/components/ui/form/input/input.md +0 -142
  384. package/docs/core/components/ui/form/radio/radio.html +0 -144
  385. package/docs/core/components/ui/form/radio/radio.md +0 -78
  386. package/docs/core/components/ui/form/select/select.html +0 -178
  387. package/docs/core/components/ui/form/select/select.md +0 -86
  388. package/docs/core/components/ui/form/switch/switch.html +0 -146
  389. package/docs/core/components/ui/form/switch/switch.md +0 -80
  390. package/docs/core/components/ui/form/textarea/textarea.html +0 -162
  391. package/docs/core/components/ui/form/textarea/textarea.md +0 -82
  392. package/docs/core/components/ui/group/group.html +0 -113
  393. package/docs/core/components/ui/group/group.md +0 -77
  394. package/docs/core/components/ui/icon/icon.md +0 -214
  395. package/docs/core/components/ui/image/image.html +0 -194
  396. package/docs/core/components/ui/image/image.md +0 -167
  397. package/docs/core/components/ui/link/link.md +0 -81
  398. package/docs/core/components/ui/loader/loader.html +0 -114
  399. package/docs/core/components/ui/loader/loader.md +0 -87
  400. package/docs/core/components/ui/menu/menu.md +0 -370
  401. package/docs/core/components/ui/modal/modal.html +0 -324
  402. package/docs/core/components/ui/modal/modal.md +0 -211
  403. package/docs/core/components/ui/pop/pop.html +0 -250
  404. package/docs/core/components/ui/pop/pop.md +0 -216
  405. package/docs/core/components/ui/progress/progress.md +0 -109
  406. package/docs/core/components/ui/table/table.html +0 -333
  407. package/docs/core/components/ui/table/table.md +0 -267
  408. package/docs/core/components/ui/theme/theme.html +0 -116
  409. package/docs/core/components/ui/theme/theme.md +0 -97
  410. package/docs/core/components/ui/toast/toast.html +0 -185
  411. package/docs/core/components/ui/toast/toast.md +0 -147
  412. package/docs/core/components/ui/tooltip/tooltip.html +0 -112
  413. package/docs/core/components/ui/tooltip/tooltip.md +0 -89
  414. package/docs/docs/decorators/ancestor-attribute.html +0 -71
  415. package/docs/docs/decorators/ancestor-attribute.md +0 -59
  416. package/docs/docs/decorators/auto-subscribe.html +0 -61
  417. package/docs/docs/decorators/auto-subscribe.md +0 -40
  418. package/docs/docs/decorators/bind.html +0 -86
  419. package/docs/docs/decorators/bind.md +0 -77
  420. package/docs/docs/decorators/get.html +0 -166
  421. package/docs/docs/decorators/get.md +0 -160
  422. package/docs/docs/decorators/handle.html +0 -139
  423. package/docs/docs/decorators/handle.md +0 -119
  424. package/docs/docs/decorators/on-assign.html +0 -72
  425. package/docs/docs/decorators/on-assign.md +0 -63
  426. package/docs/docs/decorators/patch.html +0 -76
  427. package/docs/docs/decorators/patch.md +0 -44
  428. package/docs/docs/decorators/post.html +0 -150
  429. package/docs/docs/decorators/post.md +0 -134
  430. package/docs/docs/decorators/publish.html +0 -74
  431. package/docs/docs/decorators/publish.md +0 -56
  432. package/docs/docs/decorators/put.html +0 -83
  433. package/docs/docs/decorators/put.md +0 -51
  434. package/docs/docs/decorators/subscribe.html +0 -91
  435. package/docs/docs/decorators/subscribe.md +0 -87
  436. package/docs/docs/decorators/wait-for-ancestors.html +0 -82
  437. package/docs/docs/decorators/wait-for-ancestors.md +0 -76
  438. package/docs/docs/directives/sub.html +0 -79
  439. package/docs/docs/directives/sub.md +0 -75
  440. package/docs/docs/directives/t.html +0 -91
  441. package/docs/docs/directives/t.md +0 -73
  442. package/docs/docs/getting-started/ai-agents.md +0 -76
  443. package/docs/docs/getting-started/components.html +0 -27
  444. package/docs/docs/getting-started/components.md +0 -5
  445. package/docs/docs/getting-started/installation.html +0 -69
  446. package/docs/docs/getting-started/installation.md +0 -36
  447. package/docs/docs/getting-started/my-first-component.md +0 -227
  448. package/docs/docs/getting-started/start.html +0 -47
  449. package/docs/docs/getting-started/start.md +0 -35
  450. package/docs/docs/getting-started/theming.md +0 -253
  451. package/docs/docs/index.html +0 -99
  452. package/docs/docs/misc/api-configuration.md +0 -79
  453. package/docs/docs/misc/dataProviderKey.md +0 -168
  454. package/docs/hubs/decorators.html +0 -443
  455. package/docs/hubs/form-components.html +0 -404
  456. package/docs/hubs/remote-data.html +0 -371
  457. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  458. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  459. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  460. package/docs/img/archive/credits.json +0 -28
  461. package/docs/index.md +0 -22
  462. package/docs/src/core/components/functional/translation/translation.md +0 -38
  463. package/docs/src/docs/decorators/ancestor-attribute.md +0 -59
  464. package/docs/src/docs/decorators/auto-subscribe.md +0 -40
  465. package/docs/src/docs/decorators/bind.md +0 -77
  466. package/docs/src/docs/decorators/get.md +0 -160
  467. package/docs/src/docs/decorators/handle.md +0 -119
  468. package/docs/src/docs/decorators/on-assign.md +0 -63
  469. package/docs/src/docs/decorators/patch.md +0 -44
  470. package/docs/src/docs/decorators/post.md +0 -134
  471. package/docs/src/docs/decorators/publish.md +0 -56
  472. package/docs/src/docs/decorators/put.md +0 -51
  473. package/docs/src/docs/decorators/subscribe.md +0 -87
  474. package/docs/src/docs/decorators/wait-for-ancestors.md +0 -76
  475. package/docs/src/docs/directives/sub.md +0 -75
  476. package/docs/src/docs/directives/t.md +0 -73
  477. package/docs/src/docs/getting-started/components.md +0 -5
  478. package/docs/src/docs/getting-started/create-a-component.md +0 -136
  479. package/docs/src/docs/getting-started/dataFlow.md +0 -87
  480. package/docs/src/docs/getting-started/installation.md +0 -36
  481. package/docs/src/docs/misc/docs-mock-api.md +0 -62
  482. package/docs/src/docs/misc/dynamic-path.md +0 -71
  483. package/docs/src/docs/misc/endpoint.md +0 -45
  484. package/docs/src/docs/misc/html-integration.md +0 -14
  485. /package/{docs → dist}/img/concorde/plane_01.jpg +0 -0
  486. /package/{docs → dist}/img/concorde/plane_02.jpg +0 -0
  487. /package/{docs → dist}/img/concorde/plane_03.jpg +0 -0
  488. /package/{docs → dist}/img/concorde/plane_04.jpg +0 -0
  489. /package/{docs → dist}/img/concorde/plane_05.jpg +0 -0
  490. /package/{docs → dist}/img/concorde/plane_06.jpg +0 -0
  491. /package/{docs → dist}/img/concorde/plane_07.jpg +0 -0
  492. /package/{docs → dist}/img/concorde/plane_08.jpg +0 -0
  493. /package/{docs → dist}/img/concorde/plane_09.jpg +0 -0
  494. /package/{docs → dist}/img/concorde/plane_10.jpg +0 -0
  495. /package/{docs → dist}/img/concorde/plane_11.jpg +0 -0
  496. /package/{docs → dist}/img/concorde/plane_12.jpg +0 -0
  497. /package/{docs → dist}/img/concorde/plane_13.jpg +0 -0
package/docs/crawl/docs/_getting-started/concorde-outside.html ADDED
@@ -0,0 +1,58 @@
1
+ <!DOCTYPE html>
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-outside.html" data-doc-id="docs/_getting-started/concorde-outside">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Installation — Concorde</title>
7
+ <meta name="description" content="The following command creates a new Vite project in TypeScript mode with Tailwind and an example component to get started.">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/_getting-started/concorde-outside, concorde-outside, Installation, guide, yarn ai:sync">
9
+ <meta name="concorde-doc-id" content="docs/_getting-started/concorde-outside">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-outside.html">
11
+ </head>
12
+ <body>
13
+ <header>
14
+ <p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_getting-started/concorde-outside.md/concorde-outside" rel="nofollow">interactive version</a></p>
15
+ </header>
16
+ <main>
17
+ <article>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde guide — Installation</strong>. The following command creates a new Vite project in TypeScript mode with Tailwind and an example component to get started. <span>Doc ID: <code>docs/_getting-started/concorde-outside</code>. Keywords: Concorde, supersoniks, docs/_getting-started/concorde-outside, concorde-outside, Installation, guide, yarn ai:sync. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-outside.html">https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-outside.html</a>.</span></p>
19
+ <h1 id="installation">Installation</h1>
20
+ <sonic-alert status="info" label="Recommended — use the starter" background>
21
+ <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>
22
+ <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="./ai-agents.html#ai-agents">AI agent skills</a> (<code>AGENTS.md</code>, Cursor / JetBrains rules) without extra setup.</p>
23
+ </sonic-alert>
24
+
25
+ <h2 id="starter">Starter</h2>
26
+ <p>The following command creates a new Vite project in TypeScript mode with Tailwind and an example component to get started.</p>
27
+ <pre><code class="language-shell">npx @supersoniks/create-concorde-ts-starter &quot;project_name&quot;
28
+ </code></pre>
29
+ <p>Then, from the project folder:</p>
30
+ <pre><code class="language-shell">yarn install
31
+ yarn dev --host
32
+ </code></pre>
33
+ <h2 id="next-steps">Next steps</h2>
34
+ <table>
35
+ <thead>
36
+ <tr>
37
+ <th>Step</th>
38
+ <th>Page</th>
39
+ </tr>
40
+ </thead>
41
+ <tbody><tr>
42
+ <td>Learn patterns</td>
43
+ <td><a href="./my-first-component.html#my-first-component">My first component</a></td>
44
+ </tr>
45
+ <tr>
46
+ <td>Agent skills</td>
47
+ <td><a href="./ai-agents.html#ai-agents">AI agents (skills)</a> — <code>yarn ai:sync</code> on the starter</td>
48
+ </tr>
49
+ <tr>
50
+ <td>Brownfield / manual Vite</td>
51
+ <td><a href="./concorde-manual-install.html#concorde-manual-install">Legacy: Manual installation</a></td>
52
+ </tr>
53
+ </tbody></table>
54
+
55
+ </article>
56
+ </main>
57
+ </body>
58
+ </html>
package/docs/{docs/getting-started → crawl/docs/_getting-started}/create-a-component.html RENAMED
@@ -1,25 +1,24 @@
1
1
  <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/getting-started/create-a-component" data-doc-id="docs/getting-started/create-a-component">
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_getting-started/create-a-component.html" data-doc-id="docs/_getting-started/create-a-component">
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Creating components — Concorde by Supersoniks</title>
6
+ <title>Creating components — Concorde</title>
7
7
  <meta name="description" content="&gt; New app components: start with My first component and Data flow. The Subscriber mixin below is legacy.">
8
- <meta name="keywords" content="Concorde, supersoniks, docs/getting-started/create-a-component, create-a-component, Creating components, guide, Subscriber, core, /components/destination/, /components/atoms, example.ts, ${this.text}">
9
- <meta name="concorde-doc-id" content="docs/getting-started/create-a-component">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/docs/getting-started/create-a-component">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/getting-started/create-a-component.md">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/_getting-started/create-a-component, create-a-component, Creating components, guide, Subscriber, core, /components/destination/, /components/atoms, example.ts, ${this.text}">
9
+ <meta name="concorde-doc-id" content="docs/_getting-started/create-a-component">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_getting-started/create-a-component.html">
12
11
  </head>
13
12
  <body>
14
13
  <header>
15
- <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/getting-started/create-a-component">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
14
+ <p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_getting-started/create-a-component.md/create-a-component" rel="nofollow">interactive version</a></p>
16
15
  </header>
17
16
  <main>
18
17
  <article>
19
- <p class="doc-lead" id="doc-summary"><strong>Concorde guide — Creating components</strong>. &gt; New app components: start with My first component and Data flow. The Subscriber mixin below is legacy. <span>Doc ID: <code>docs/getting-started/create-a-component</code>. Keywords: Concorde, supersoniks, docs/getting-started/create-a-component, create-a-component, Creating components, guide, Subscriber, core, /components/destination/, /components/atoms, example.ts, ${this.text}. URL: <a href="https://concorde.supersoniks.org/docs/getting-started/create-a-component">https://concorde.supersoniks.org/docs/getting-started/create-a-component</a>.</span></p>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde guide — Creating components</strong>. &gt; New app components: start with My first component and Data flow. The Subscriber mixin below is legacy. <span>Doc ID: <code>docs/_getting-started/create-a-component</code>. Keywords: Concorde, supersoniks, docs/_getting-started/create-a-component, create-a-component, Creating components, guide, Subscriber, core, /components/destination/, /components/atoms, example.ts, ${this.text}. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_getting-started/create-a-component.html">https://concorde.supersoniks.org/crawl/docs/_getting-started/create-a-component.html</a>.</span></p>
20
19
  <h1 id="creating-components">Creating components</h1>
21
20
  <blockquote>
22
- <p><strong>New app components:</strong> start with <a href="/docs/getting-started/my-first-component">My first component</a> and <a href="/docs/getting-started/dataFlow">Data flow</a>. The <code>Subscriber</code> mixin below is legacy.</p>
21
+ <p><strong>New app components:</strong> start with <a href="./my-first-component.html#my-first-component">My first component</a> and <a href="../_core-concept/dataFlow.html#dataFlow">Data flow</a>. The <code>Subscriber</code> mixin below is <a href="../_core-concept/subscriber.html#subscriber">legacy</a>.</p>
23
22
  </blockquote>
24
23
  <h2 id="where-to-put-it">Where to put it?</h2>
25
24
  <p>In this document, we consider the src directory of the project as the root.<br>
@@ -64,7 +63,11 @@ export class SonicComponent extends LitElement {
64
63
  }
65
64
  }
66
65
  </code></pre>
67
- <p>Regarding data sharing, see <a href="/docs/getting-started/dataFlow">Data flow</a>.</p>
66
+ <p>Regarding <code>Subscriber</code>, see:</p>
67
+ <ul>
68
+ <li><a href="../_core-concept/subscriber.html#subscriber">🔔 Subscriber</a></li>
69
+ <li><a href="./pubsub.html#pubsub">🥨 Sharing Data</a></li>
70
+ </ul>
68
71
  <h3 id="naming-the-component">Naming the Component</h3>
69
72
  <p>The class name is not necessarily important. However, it is important to <strong>give it a component name prefixed with &quot;sonic&quot;</strong> (or a prefix of your own) using the dedicated metadata already present in the copied document. For example, a button component would be named as follows:</p>
70
73
  <pre><code class="language-typescript">@customElement(&quot;sonic-button&quot;)
@@ -75,7 +78,7 @@ For example, for a &quot;title&quot; component in the &quot;event&quot; destinat
75
78
  </code></pre>
76
79
  <h2 id="modifying-it">Modifying It</h2>
77
80
  <h4 id="creating-reactive-properties-and-modifying-the-render-function">Creating Reactive Properties and Modifying the Render Function</h4>
78
- <p>To do this, study the functioning of <a href="https://lit.dev">https://lit.dev</a> and also refer to <a href="/docs/getting-started/dataFlow">Data flow</a>.</p>
81
+ <p>To do this, study the functioning of <a href="https://lit.dev">https://lit.dev</a> and also refer to <a href="../_core-concept/subscriber.html#subscriber">Subscriber</a>.</p>
79
82
  <h4 id="html-structure-of-a-component">HTML Structure of a Component</h4>
80
83
  <p>The HTML structure of a component should remain as simple as possible.</p>
81
84
  <p>Ideally, there should be only one additional level of elements in addition to slots.</p>
package/docs/{docs/getting-started → crawl/docs/_getting-started}/my-first-component.html RENAMED
@@ -1,24 +1,26 @@
1
1
  <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/getting-started/my-first-component" data-doc-id="docs/getting-started/my-first-component">
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-component.html" data-doc-id="docs/_getting-started/my-first-component">
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>My first component — Concorde by Supersoniks</title>
6
+ <title>My first component — Concorde</title>
7
7
  <meta name="description" content="Build a Lit user card with Tailwind and Concorde UI, then connect it to the DataProvider store: declare the data configuration (type, key, scope), and let @subscribe keep the card in sync.">
8
- <meta name="keywords" content="Concorde, supersoniks, docs/getting-started/my-first-component, my-first-component, My first component, guide, @subscribe, src/docs/tailwind.ts, ${unsafeCSS(tailwindImport)}, DocsUserData, user, docsUserRowKey, &quot;${dataProvider}&quot;, { dataProvider: string | null }">
9
- <meta name="concorde-doc-id" content="docs/getting-started/my-first-component">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/docs/getting-started/my-first-component">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/getting-started/my-first-component.md">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/_getting-started/my-first-component, my-first-component, My first component, guide, @subscribe, src/docs/tailwind.ts, ${unsafeCSS(tailwindImport)}, DocsUserData, user, docsUserRowKey, &quot;${dataProvider}&quot;, { dataProvider: string | null }">
9
+ <meta name="concorde-doc-id" content="docs/_getting-started/my-first-component">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-component.html">
12
11
  </head>
13
12
  <body>
14
13
  <header>
15
- <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/getting-started/my-first-component">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
14
+ <p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_getting-started/my-first-component.md/my-first-component" rel="nofollow">interactive version</a></p>
16
15
  </header>
17
16
  <main>
18
17
  <article>
19
- <p class="doc-lead" id="doc-summary"><strong>Concorde guide — My first component</strong>. Build a Lit user card with Tailwind and Concorde UI, then connect it to the DataProvider store: declare the data configuration (type, key, scope), and let @subscribe keep the card in sync. <span>Doc ID: <code>docs/getting-started/my-first-component</code>. Keywords: Concorde, supersoniks, docs/getting-started/my-first-component, my-first-component, My first component, guide, @subscribe, src/docs/tailwind.ts, ${unsafeCSS(tailwindImport)}, DocsUserData, user, docsUserRowKey, &quot;${dataProvider}&quot;, { dataProvider: string | null }. URL: <a href="https://concorde.supersoniks.org/docs/getting-started/my-first-component">https://concorde.supersoniks.org/docs/getting-started/my-first-component</a>.</span></p>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde guide — My first component</strong>. Build a Lit user card with Tailwind and Concorde UI, then connect it to the DataProvider store: declare the data configuration (type, key, scope), and let @subscribe keep the card in sync. <span>Doc ID: <code>docs/_getting-started/my-first-component</code>. Keywords: Concorde, supersoniks, docs/_getting-started/my-first-component, my-first-component, My first component, guide, @subscribe, src/docs/tailwind.ts, ${unsafeCSS(tailwindImport)}, DocsUserData, user, docsUserRowKey, &quot;${dataProvider}&quot;, { dataProvider: string | null }. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-component.html">https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-component.html</a>.</span></p>
20
19
  <h1 id="my-first-component">My first component</h1>
21
20
  <p>Build a <strong>Lit</strong> user card with Tailwind and Concorde UI, then connect it to the <strong>DataProvider</strong> store: declare the <strong>data configuration</strong> (type, key, scope), and let <strong><code>@subscribe</code></strong> keep the card in sync.</p>
21
+ <blockquote>
22
+ <p>Legacy approach with the <strong>Subscriber mixin</strong>: <a href="./my-first-subscriber.html#my-first-subscriber">Legacy: My first subscriber</a>.</p>
23
+ </blockquote>
22
24
  <h2 id="1-lit-component--tailwind">1. Lit component + Tailwind</h2>
23
25
  <p>Export Tailwind once (e.g. <code>src/docs/tailwind.ts</code> in this repo):</p>
24
26
  <pre><code class="language-typescript">import { css, unsafeCSS } from &quot;lit&quot;;
@@ -71,14 +73,14 @@ export const docsUserRowKey = new DataProviderKey&amp;lt;
71
73
  { dataProvider: string | null }
72
74
  &amp;gt;(&quot;${dataProvider}&quot;);
73
75
  </code></pre>
74
- <p>The second generic (<code>{ dataProvider: string | null }</code>) lists what the host must expose so <code>&quot;${dataProvider}&quot;</code> can be resolved. See <a href="/docs/misc/dataProviderKey">DataProviderKey</a> and <a href="/docs/misc/dynamic-path">Dynamic path placeholders</a>.</p>
76
+ <p>The second generic (<code>{ dataProvider: string | null }</code>) lists what the host must expose so <code>&quot;${dataProvider}&quot;</code> can be resolved. See <a href="../_misc/dataProviderKey.html#dataProviderKey">DataProviderKey</a> and <a href="../_misc/dynamic-path.html#dynamic-path">Dynamic path placeholders</a>.</p>
75
77
  <h3 id="scope--which-store-segment-applies">Scope — which store segment applies</h3>
76
- <p>A parent sets <code>dataProvider=${docsUserScopeAKey.path}</code> (or a list row sets <code>…/list-item/0</code>). <a href="/docs/decorators/ancestor-attribute"><code>@ancestorAttribute</code></a> copies that attribute onto <code>this.dataProvider</code>, so the key resolves to the correct branch.</p>
78
+ <p>A parent sets <code>dataProvider=${docsUserScopeAKey.path}</code> (or a list row sets <code>…/list-item/0</code>). <a href="../_decorators/ancestor-attribute.html#ancestor-attribute"><code>@ancestorAttribute</code></a> copies that attribute onto <code>this.dataProvider</code>, so the key resolves to the correct branch.</p>
77
79
  <pre><code class="language-typescript">@ancestorAttribute(&quot;dataProvider&quot;)
78
80
  dataProvider: string | null = null;
79
81
  </code></pre>
80
82
  <h3 id="subscribe--keep-the-card-in-sync">Subscribe — keep the card in sync</h3>
81
- <p><a href="/docs/decorators/subscribe"><code>@subscribe</code></a> watches <code>docsUserRowKey</code> and updates <code>user</code> when the store changes. Use <code>@state()</code> so Lit re-renders. The template reads <code>this.user</code> like any other property.</p>
83
+ <p><a href="../_decorators/subscribe.html#subscribe"><code>@subscribe</code></a> watches <code>docsUserRowKey</code> and updates <code>user</code> when the store changes. Use <code>@state()</code> so Lit re-renders. The template reads <code>this.user</code> like any other property.</p>
82
84
  <pre><code class="language-typescript">import { html, LitElement, nothing } from &quot;lit&quot;;
83
85
  import { customElement, state } from &quot;lit/decorators.js&quot;;
84
86
  import {
@@ -156,7 +158,7 @@ export class DocsUsersList extends LitElement {
156
158
  }
157
159
  }
158
160
  </code></pre>
159
- <p>See <a href="/docs/misc/docs-mock-api">Local API demos</a> for <code>serviceURL=&quot;/docs-mock-api&quot;</code>.</p>
161
+ <p>See <a href="../_misc/docs-mock-api.html#docs-mock-api">Local API demos</a> for <code>serviceURL=&quot;/docs-mock-api&quot;</code>.</p>
160
162
  <h2 id="4-form-preview-with-formdataprovider">4. Form preview with <code>formDataProvider</code></h2>
161
163
  <p>Edit fields in a form; the card follows the same <code>docsUserRowKey</code> when the preview host sets <code>dataProvider=&quot;userPreview&quot;</code>.</p>
162
164
  <pre><code>&lt;div class=&quot;grid grid-cols-1 gap-4 max-w-xl&quot;&gt;
@@ -172,7 +174,14 @@ export class DocsUsersList extends LitElement {
172
174
  &lt;/div&gt;
173
175
  &lt;/div&gt;
174
176
  </code></pre>
175
- <p>Use <code>formDataProvider</code> + <code>name</code> on inputs — no manual <code>@input</code> handlers (<a href="/docs/getting-started/dataFlow">Data flow</a>).</p>
177
+ <p>Use <code>formDataProvider</code> + <code>name</code> on inputs — no manual <code>@input</code> handlers (<a href="../_core-concept/dataFlow.html#dataFlow">Data flow</a>).</p>
178
+ <h2 id="next-steps">Next steps</h2>
179
+ <ul>
180
+ <li><a href="../_core-concept/dataFlow.html#dataFlow">Data flow</a> — full map</li>
181
+ <li><a href="../_misc/dataProviderKey.html#dataProviderKey">DataProviderKey</a> — typed paths and host constraints</li>
182
+ <li><a href="../_decorators/subscribe.html#subscribe">@subscribe</a> / <a href="../_directives/sub.html#sub">sub()</a> — read-only in templates</li>
183
+ <li><a href="../../core/components/functional/list/list.html#list">List</a> — <code>.items</code>, <code>.noItems</code>, <code>.skeleton</code></li>
184
+ </ul>
176
185
 
177
186
  </article>
178
187
  </main>
package/docs/crawl/docs/_getting-started/my-first-subscriber.html ADDED
@@ -0,0 +1,110 @@
1
+ <!DOCTYPE html>
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-subscriber.html" data-doc-id="docs/_getting-started/my-first-subscriber">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Legacy: My first subscriber component — Concorde</title>
7
+ <meta name="description" content="&gt; New projects: use My first component (@ancestorAttribute, @subscribe + DataProviderKey, .items on lists) and Data flow. This page documents the Subscriber mixin used by older apps and core component">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/_getting-started/my-first-subscriber, my-first-subscriber, Legacy: My first subscriber component, guide, @ancestorAttribute, @subscribe, DataProviderKey, .items, ${unsafeCSS(tailwindImport)}">
9
+ <meta name="concorde-doc-id" content="docs/_getting-started/my-first-subscriber">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-subscriber.html">
11
+ </head>
12
+ <body>
13
+ <header>
14
+ <p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_getting-started/my-first-subscriber.md/my-first-subscriber" rel="nofollow">interactive version</a></p>
15
+ </header>
16
+ <main>
17
+ <article>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde guide — Legacy: My first subscriber component</strong>. &gt; New projects: use My first component (@ancestorAttribute, @subscribe + DataProviderKey, .items on lists) and Data flow. This page documents the Subscriber mixin used by older apps and core component <span>Doc ID: <code>docs/_getting-started/my-first-subscriber</code>. Keywords: Concorde, supersoniks, docs/_getting-started/my-first-subscriber, my-first-subscriber, Legacy: My first subscriber component, guide, @ancestorAttribute, @subscribe, DataProviderKey, .items, ${unsafeCSS(tailwindImport)}. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-subscriber.html">https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-subscriber.html</a>.</span></p>
19
+ <h1 id="legacy-my-first-subscriber-component">Legacy: My first subscriber component</h1>
20
+ <blockquote>
21
+ <p><strong>New projects:</strong> use <a href="./my-first-component.html#my-first-component">My first component</a> (<code>@ancestorAttribute</code>, <code>@subscribe</code> + <code>DataProviderKey</code>, <code>.items</code> on lists) and <a href="../_core-concept/dataFlow.html#dataFlow">Data flow</a>. This page documents the <strong>Subscriber mixin</strong> used by older apps and core components.</p>
22
+ </blockquote>
23
+ <p>Learn how to build a component with the <strong>Subscriber</strong> mixin, styled with Tailwind, filled from a DataProvider via automatic property mapping.</p>
24
+ <h2 id="create-a-classic-lit-component">Create a classic lit component</h2>
25
+ <pre><code class="language-javascript">import { html, LitElement, nothing } from &quot;lit&quot;;
26
+ import { customElement, property } from &quot;lit/decorators.js&quot;;
27
+ @customElement(&quot;docs-user&quot;)
28
+ export class user extends LitElement {
29
+ @property({ type: String }) first_name = &quot;&quot;;
30
+ @property({ type: String }) last_name = &quot;&quot;;
31
+ @property({ type: String }) avatar = &quot;&quot;;
32
+ @property({ type: String }) email = &quot;&quot;;
33
+ render() {
34
+ return html`
35
+ &amp;lt;img src=&quot;${this.avatar}&quot; /&amp;gt; &amp;lt;br&amp;gt;
36
+ ${this.first_name} ${this.last_name} &amp;lt;br&amp;gt;
37
+ ${this.email}`;
38
+ }
39
+ }
40
+ </code></pre>
41
+ <h3 id="style-with-tailwind-and-ui-components">Style with tailwind and ui components</h3>
42
+ <pre><code class="language-javascript">import { css, unsafeCSS } from &quot;lit&quot;;
43
+ import tailwindImport from &quot;./css/tailwind.css?inline&quot;;
44
+ export const tailwind = css`${unsafeCSS(tailwindImport)}`;
45
+ </code></pre>
46
+ <pre><code class="language-javascript">import { html, LitElement } from &quot;lit&quot;;
47
+ import { customElement, property } from &quot;lit/decorators.js&quot;;
48
+ import { tailwind } from &quot;../tailwind&quot;;
49
+ import &#39;@supersoniks/concode/ui/image&#39;
50
+ import &#39;@supersoniks/concode/ui/button&#39;
51
+ import &#39;@supersoniks/concode/ui/icon&#39;
52
+ @customElement(&quot;docs-user&quot;)
53
+ export class user extends LitElement {
54
+ static styles = [tailwind];
55
+ @property({ type: String }) first_name = &quot;&quot;;
56
+ @property({ type: String }) last_name = &quot;&quot;;
57
+ @property({ type: String }) avatar = &quot;&quot;;
58
+ @property({ type: String }) email = &quot;&quot;;
59
+ render() {
60
+ return html`&amp;lt;div class=&quot;flex items-center gap-3 p-2&quot;&amp;gt;
61
+ &amp;lt;sonic-image src=${this.avatar} rounded=&quot;md&quot; ratio=&quot;1/1&quot; class=&quot;w-16&quot;&amp;gt;&amp;lt;/sonic-image&amp;gt;
62
+ &amp;lt;div&amp;gt;${this.first_name} &amp;lt;span class=&quot;font-bold&quot;&amp;gt;${this.last_name}&amp;lt;/span&amp;gt;&amp;lt;/div&amp;gt;
63
+ &amp;lt;div class=&quot;text-sm text-neutral-400&quot;&amp;gt;${this.email}&amp;lt;/div&amp;gt;
64
+ &amp;lt;/div&amp;gt;`;
65
+ }
66
+ }
67
+ </code></pre>
68
+ <h2 id="add-subscriber-mixin">Add Subscriber mixin</h2>
69
+ <pre><code class="language-javascript">import Subscriber from &quot;@supersoniks/concorde/core/mixins/Subscriber&quot;;
70
+ @customElement(&quot;docs-user&quot;)
71
+ export class user extends Subscriber(LitElement) {
72
+ // properties auto-filled from DataProvider when names match
73
+ }
74
+ </code></pre>
75
+ <p>See <a href="../_core-concept/subscriber.html#subscriber">Legacy: Subscriber mixin</a>.</p>
76
+ <h2 id="autofill-from-a-dataprovider">Autofill from a dataProvider</h2>
77
+ <pre><code>&lt;docs-demo-sources for=&quot;list-users-fetch&quot;&gt;&lt;/docs-demo-sources&gt;
78
+ &lt;div serviceURL=&quot;/docs-mock-api&quot;&gt;
79
+ &lt;sonic-fetch
80
+ serviceURL=&quot;/docs-mock-api&quot;
81
+ dataProvider=&quot;api/users/3&quot;
82
+ key=&quot;data&quot;&gt;
83
+ &lt;docs-user&gt;&lt;/docs-user&gt;
84
+ &lt;/sonic-fetch&gt;
85
+ &lt;/div&gt;
86
+ </code></pre>
87
+ <pre><code>&lt;sonic-fetch
88
+ serviceURL=&quot;/docs-mock-api&quot;
89
+ dataProvider=&quot;api/users/2&quot;
90
+ key=&quot;data&quot;&gt;&lt;/sonic-fetch&gt;
91
+ &lt;docs-user dataProvider=&quot;api/users/2&quot; &gt;&lt;/docs-user&gt;
92
+ </code></pre>
93
+ <pre><code>&lt;div class=&quot;grid grid-cols-1 gap-4&quot;&gt;
94
+ &lt;form formDataProvider=&quot;userPreview&quot; class=&quot;grid grid-cols-4 gap-3&quot; &gt;
95
+ &lt;sonic-input label=&quot;First name&quot; type=&quot;text&quot; name=&quot;first_name&quot; value=&quot;Paul&quot; size=&quot;sm&quot;&gt;&lt;/sonic-input&gt;
96
+ &lt;sonic-input label=&quot;Last name&quot; type=&quot;text&quot; name=&quot;last_name&quot; value=&quot;Metrand&quot; size=&quot;sm&quot;&gt;&lt;/sonic-input&gt;
97
+ &lt;sonic-input class=&quot;col-span-2&quot; label=&quot;email&quot; type=&quot;text&quot; name=&quot;email&quot; value=&quot;paul@example.com&quot; size=&quot;sm&quot;&gt;&lt;/sonic-input&gt;
98
+ &lt;sonic-input label=&quot;Image url&quot; type=&quot;text&quot; name=&quot;avatar&quot; value=&quot;https://i.pravatar.cc/150?u=paul&quot; size=&quot;sm&quot;&gt;&lt;/sonic-input&gt;
99
+ &lt;/form&gt;
100
+ &lt;sonic-divider align=&quot;left&quot;&gt;Preview before submit&lt;/sonic-divider&gt;
101
+ &lt;div dataProvider=&quot;userPreview&quot;&gt;
102
+ &lt;docs-user&gt;&lt;/docs-user&gt;
103
+ &lt;/div&gt;
104
+ &lt;/div&gt;
105
+ </code></pre>
106
+
107
+ </article>
108
+ </main>
109
+ </body>
110
+ </html>
package/docs/crawl/docs/_getting-started/pubsub.html ADDED
@@ -0,0 +1,62 @@
1
+ <!DOCTYPE html>
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_getting-started/pubsub.html" data-doc-id="docs/_getting-started/pubsub">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Legacy: Sharing data — Concorde</title>
7
+ <meta name="description" content="&gt; New apps: Data flow (get / set / DataProviderKey, decorators). This page documents the historical Publisher proxy API (PublisherManager, publisher.set, onAssign, …).">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/_getting-started/pubsub, pubsub, Legacy: Sharing data, guide, get, set, DataProviderKey, PublisherManager, publisher.set, onAssign, {foo:{hello:[&quot;world&quot;]}, bar:&quot;baz&quot;}, myPublisher.foo.hello, null">
9
+ <meta name="concorde-doc-id" content="docs/_getting-started/pubsub">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_getting-started/pubsub.html">
11
+ </head>
12
+ <body>
13
+ <header>
14
+ <p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_getting-started/pubsub.md/pubsub" rel="nofollow">interactive version</a></p>
15
+ </header>
16
+ <main>
17
+ <article>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde guide — Legacy: Sharing data</strong>. &gt; New apps: Data flow (get / set / DataProviderKey, decorators). This page documents the historical Publisher proxy API (PublisherManager, publisher.set, onAssign, …). <span>Doc ID: <code>docs/_getting-started/pubsub</code>. Keywords: Concorde, supersoniks, docs/_getting-started/pubsub, pubsub, Legacy: Sharing data, guide, get, set, DataProviderKey, PublisherManager, publisher.set, onAssign, {foo:{hello:[&quot;world&quot;]}, bar:&quot;baz&quot;}, myPublisher.foo.hello, null. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_getting-started/pubsub.html">https://concorde.supersoniks.org/crawl/docs/_getting-started/pubsub.html</a>.</span></p>
19
+ <h1 id="legacy-sharing-data">Legacy: Sharing data</h1>
20
+ <blockquote>
21
+ <p><strong>New apps:</strong> <a href="../_core-concept/dataFlow.html#dataFlow">Data flow</a> (<code>get</code> / <code>set</code> / <code>DataProviderKey</code>, decorators). This page documents the historical <strong>Publisher</strong> proxy API (<code>PublisherManager</code>, <code>publisher.set</code>, <code>onAssign</code>, …).</p>
22
+ </blockquote>
23
+ <p>This section describes how data is shared between graphical and non-graphical components.</p>
24
+ <p>Graphical components should not reference each other directly — they stay decoupled via a <strong>publish/subscribe</strong> store.</p>
25
+ <h2 id="the-publisher">The Publisher</h2>
26
+ <h3 id="principle">Principle</h3>
27
+ <ul>
28
+ <li><p>The <strong>publisher</strong> is a <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy">JavaScript proxy</a> that holds data.<br>
29
+ Example: <code>{foo:{hello:[&quot;world&quot;]}, bar:&quot;baz&quot;}</code></p>
30
+ </li>
31
+ <li><p>Accessing a property (<code>myPublisher.foo.hello</code>) returns another <strong>publisher</strong> for that segment.</p>
32
+ </li>
33
+ <li><p>Missing properties create a publisher with internal data <code>null</code>, filled later.</p>
34
+ </li>
35
+ <li><p><strong>Subscribers</strong> listen via <code>onAssign</code>, <code>onInternalMutation</code>, template filling on the <strong>Subscriber mixin</strong>, etc.</p>
36
+ </li>
37
+ <li><p>Updates use <code>publisher.set(...)</code> or nested assignment; changes propagate to subscribers.</p>
38
+ </li>
39
+ </ul>
40
+ <p>❇️ Order of creation vs subscription theoretically does not matter.</p>
41
+ <h3 id="methods">Methods</h3>
42
+ <ul>
43
+ <li><strong>set</strong> — replace internal value</li>
44
+ </ul>
45
+ <pre><code class="language-javascript">publisher.set({foo:{hello:[&quot;world&quot;]}, bar:&quot;baz&quot;});
46
+ </code></pre>
47
+ <ul>
48
+ <li><strong>get</strong> — read internal value</li>
49
+ </ul>
50
+ <pre><code class="language-javascript">publisher.get()
51
+ </code></pre>
52
+ <ul>
53
+ <li><strong>onAssign / offAssign</strong> — react to <code>set</code></li>
54
+ </ul>
55
+ <pre><code class="language-javascript">publisher.a.b.onAssign(console.log);
56
+ </code></pre>
57
+ <p>Modern equivalent: <code>get</code> / <code>set</code> / <code>@handle</code> — see <a href="../_core-concept/dataFlow.html#dataFlow">Data flow</a>.</p>
58
+
59
+ </article>
60
+ </main>
61
+ </body>
62
+ </html>
package/docs/crawl/docs/_getting-started/start.html ADDED
@@ -0,0 +1,76 @@
1
+ <!DOCTYPE html>
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_getting-started/start.html" data-doc-id="docs/_getting-started/start">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Introduction — Concorde</title>
7
+ <meta name="description" content="Based on lit.dev, Concorde is a collection of web components for shared apps and websites.">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/_getting-started/start, start, Introduction, guide, get, set, formDataProvider, @ancestorAttribute, @bind, serviceURL, yarn ai:sync, AGENTS.md">
9
+ <meta name="concorde-doc-id" content="docs/_getting-started/start">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_getting-started/start.html">
11
+ </head>
12
+ <body>
13
+ <header>
14
+ <p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_getting-started/start.md/start" rel="nofollow">interactive version</a></p>
15
+ </header>
16
+ <main>
17
+ <article>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde guide — Introduction</strong>. Based on lit.dev, Concorde is a collection of web components for shared apps and websites. <span>Doc ID: <code>docs/_getting-started/start</code>. Keywords: Concorde, supersoniks, docs/_getting-started/start, start, Introduction, guide, get, set, formDataProvider, @ancestorAttribute, @bind, serviceURL, yarn ai:sync, AGENTS.md. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_getting-started/start.html">https://concorde.supersoniks.org/crawl/docs/_getting-started/start.html</a>.</span></p>
19
+ <h1 id="introduction">Introduction</h1>
20
+ <h2 id="what-is-concorde">What is Concorde?</h2>
21
+ <p>Based on <strong><a href="https://lit.dev">lit.dev</a></strong>, Concorde is a collection of web components for shared apps and websites.<br>Build UIs without tying components to a specific host stack, while keeping visual consistency through the smallest set of CSS variables needed to define a theme.</p>
22
+ <h2 id="why-and-use-case">Why and use case</h2>
23
+ <p>In 2022, Supersoniks needed a new ticketing stack for nearly 100 sites — mobile apps, modern sites, and legacy PHP without bundlers.<br>One composable web-component library replaced many one-off apps. Lit was chosen for broad runtime compatibility.</p>
24
+ <h3 id="stack">Stack</h3>
25
+ <ul>
26
+ <li>Lit</li>
27
+ <li>TypeScript</li>
28
+ <li>Vite</li>
29
+ <li>Tailwind (starter kit, not required in the core package)</li>
30
+ </ul>
31
+ <h3 id="functional-features">Functional features</h3>
32
+ <ul>
33
+ <li><strong>DataProvider</strong> store (decorators, <code>get</code> / <code>set</code>)</li>
34
+ <li>Forms (<code>formDataProvider</code>)</li>
35
+ <li>Lists, queues, lazy loading</li>
36
+ <li>Router, states, UI kit with status variants</li>
37
+ </ul>
38
+ <h2 id="learn-concorde">Learn Concorde</h2>
39
+ <table>
40
+ <thead>
41
+ <tr>
42
+ <th>Step</th>
43
+ <th>Page</th>
44
+ </tr>
45
+ </thead>
46
+ <tbody><tr>
47
+ <td>1</td>
48
+ <td><a href="./my-first-component.html#my-first-component">My first component</a> — Lit card, <code>@ancestorAttribute</code>, <code>@bind</code>, mock API</td>
49
+ </tr>
50
+ <tr>
51
+ <td>2</td>
52
+ <td><a href="../_core-concept/dataFlow.html#dataFlow">Data flow</a> — Core concepts: decorators and APIs</td>
53
+ </tr>
54
+ <tr>
55
+ <td>3</td>
56
+ <td><a href="../_misc/docs-mock-api.html#docs-mock-api">Local API demos</a> — offline <code>serviceURL</code> for this site (Misc)</td>
57
+ </tr>
58
+ <tr>
59
+ <td>4</td>
60
+ <td><a href="https://www.npmjs.com/package/@supersoniks/create-concorde-ts-starter">create-concorde-ts-starter</a> — <strong>recommended</strong> project kit (Vite, Tailwind, <code>yarn ai:sync</code>)</td>
61
+ </tr>
62
+ <tr>
63
+ <td>5</td>
64
+ <td><a href="./ai-agents.html#ai-agents">AI agents (skills)</a> — <code>AGENTS.md</code>, Cursor / JetBrains rules</td>
65
+ </tr>
66
+ </tbody></table>
67
+ <p>Legacy (Subscriber mixin, Publisher API): <strong>Legacy</strong> section at the bottom of the sidebar.</p>
68
+ <h2 id="start-a-new-project">Start a new project</h2>
69
+ <pre><code class="language-bash">npx @supersoniks/create-concorde-ts-starter &quot;project_name&quot;
70
+ </code></pre>
71
+ <p>The starter runs <strong><code>yarn ai:sync</code></strong> for you. Details: <a href="./ai-agents.html#ai-agents">AI agents (skills)</a>. Manual Vite setup: <a href="./concorde-manual-install.html#concorde-manual-install">Legacy: Manual installation</a>.</p>
72
+
73
+ </article>
74
+ </main>
75
+ </body>
76
+ </html>
package/docs/{docs/getting-started → crawl/docs/_getting-started}/theming.html RENAMED
@@ -1,27 +1,26 @@
1
1
  <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/getting-started/theming" data-doc-id="docs/getting-started/theming">
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_getting-started/theming.html" data-doc-id="docs/_getting-started/theming">
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Theming — Concorde by Supersoniks</title>
6
+ <title>Customization — Concorde</title>
7
7
  <meta name="description" content="Concorde components ship with default styles (fallback values in each component and in &lt;sonic-theme&gt;).">
8
- <meta name="keywords" content="Concorde, supersoniks, docs/getting-started/theming, theming, Theming, guide, , :root, theme=&quot;custom&quot;, --sc-*, theme=&quot;light&quot;, &quot;dark&quot;, &quot;auto&quot;, auto, prefers-color-scheme">
9
- <meta name="concorde-doc-id" content="docs/getting-started/theming">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/docs/getting-started/theming">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/getting-started/theming.md">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/_getting-started/theming, theming, Customization, guide, , :root, theme=&quot;custom&quot;, --sc-*, theme=&quot;light&quot;, &quot;dark&quot;, &quot;auto&quot;, auto, prefers-color-scheme">
9
+ <meta name="concorde-doc-id" content="docs/_getting-started/theming">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_getting-started/theming.html">
12
11
  </head>
13
12
  <body>
14
13
  <header>
15
- <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/getting-started/theming">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
14
+ <p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_getting-started/theming.md/theming" rel="nofollow">interactive version</a></p>
16
15
  </header>
17
16
  <main>
18
17
  <article>
19
- <p class="doc-lead" id="doc-summary"><strong>Concorde guide — Theming</strong>. Concorde components ship with default styles (fallback values in each component and in &lt;sonic-theme&gt;). <span>Doc ID: <code>docs/getting-started/theming</code>. Keywords: Concorde, supersoniks, docs/getting-started/theming, theming, Theming, guide, , :root, theme=&quot;custom&quot;, --sc-*, theme=&quot;light&quot;, &quot;dark&quot;, &quot;auto&quot;, auto, prefers-color-scheme. URL: <a href="https://concorde.supersoniks.org/docs/getting-started/theming">https://concorde.supersoniks.org/docs/getting-started/theming</a>.</span></p>
20
- <h1 id="theming">Theming</h1>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde guide — Customization</strong>. Concorde components ship with default styles (fallback values in each component and in &lt;sonic-theme&gt;). <span>Doc ID: <code>docs/_getting-started/theming</code>. Keywords: Concorde, supersoniks, docs/_getting-started/theming, theming, Customization, guide, , :root, theme=&quot;custom&quot;, --sc-*, theme=&quot;light&quot;, &quot;dark&quot;, &quot;auto&quot;, auto, prefers-color-scheme. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_getting-started/theming.html">https://concorde.supersoniks.org/crawl/docs/_getting-started/theming.html</a>.</span></p>
19
+ <h1 id="customization">Customization</h1>
21
20
  <h2 id="theme-first-customization">Theme-first customization</h2>
22
21
  <p>Concorde components ship with <strong>default styles</strong> (fallback values in each component and in <code>&lt;sonic-theme&gt;</code>).<br>You do not need to define any CSS variables to get a usable UI.</p>
23
22
  <p>To align the kit with your brand, override <strong>only the essential theme tokens</strong> on <code>&lt;sonic-theme&gt;</code>, on <code>:root</code>, or in a project stylesheet.<br>Concorde derives radius steps, button/input rounding, shadows, and most per-component layout from these primitives—<strong>do not copy long lists of derived variables</strong> unless you have a specific need.</p>
24
- <pre><code class="language-html">&lt;sonic-theme color font &gt;
23
+ <pre><code class="language-html">&lt;sonic-theme color font class=&quot;block bg-base min-h-screen&quot;&gt;
25
24
  &lt;!-- your app --&gt;
26
25
  &lt;/sonic-theme&gt;
27
26
  </code></pre>
package/docs/{docs/misc → crawl/docs/_misc}/api-configuration.html RENAMED
@@ -1,26 +1,25 @@
1
1
  <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/misc/api-configuration" data-doc-id="docs/misc/api-configuration">
2
+ <html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_misc/api-configuration.html" data-doc-id="docs/_misc/api-configuration">
3
3
  <head>
4
4
  <meta charset="UTF-8">
5
5
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>API configuration — Concorde by Supersoniks</title>
6
+ <title>API configuration — Concorde</title>
7
7
  <meta name="description" content="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, ">
8
- <meta name="keywords" content="Concorde, supersoniks, docs/misc/api-configuration, api-configuration, API configuration, reference, APIConfiguration, HTML.getApiConfiguration, API, wording(), @get, @post, @put, @patch, serviceURL">
9
- <meta name="concorde-doc-id" content="docs/misc/api-configuration">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/docs/misc/api-configuration">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/misc/api-configuration.md">
8
+ <meta name="keywords" content="Concorde, supersoniks, docs/_misc/api-configuration, api-configuration, API configuration, reference, APIConfiguration, HTML.getApiConfiguration, API, wording(), @get, @post, @put, @patch, serviceURL">
9
+ <meta name="concorde-doc-id" content="docs/_misc/api-configuration">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_misc/api-configuration.html">
12
11
  </head>
13
12
  <body>
14
13
  <header>
15
- <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/misc/api-configuration">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
14
+ <p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_misc/api-configuration.md/api-configuration" rel="nofollow">interactive version</a></p>
16
15
  </header>
17
16
  <main>
18
17
  <article>
19
- <p class="doc-lead" id="doc-summary"><strong>Concorde reference — API configuration</strong>. 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, <span>Doc ID: <code>docs/misc/api-configuration</code>. Keywords: Concorde, supersoniks, docs/misc/api-configuration, api-configuration, API configuration, reference, APIConfiguration, HTML.getApiConfiguration, API, wording(), @get, @post, @put, @patch, serviceURL. URL: <a href="https://concorde.supersoniks.org/docs/misc/api-configuration">https://concorde.supersoniks.org/docs/misc/api-configuration</a>.</span></p>
18
+ <p class="doc-lead" id="doc-summary"><strong>Concorde reference — API configuration</strong>. 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, <span>Doc ID: <code>docs/_misc/api-configuration</code>. Keywords: Concorde, supersoniks, docs/_misc/api-configuration, api-configuration, API configuration, reference, APIConfiguration, HTML.getApiConfiguration, API, wording(), @get, @post, @put, @patch, serviceURL. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_misc/api-configuration.html">https://concorde.supersoniks.org/crawl/docs/_misc/api-configuration.html</a>.</span></p>
20
19
  <h1 id="api-configuration">API configuration</h1>
21
- <p><code>APIConfiguration</code> is the object built by <a href="../../core/utils/HTML.ts"><code>HTML.getApiConfiguration</code></a> from <strong>ancestor attributes</strong> on the DOM (or from a typed publisher — see <a href="/docs/decorators/get">@get</a> / <a href="/docs/decorators/post">@post</a> configuration key). It is passed to <a href="../../core/utils/api.ts"><code>API</code></a> by fetchers, <strong>sonic-submit</strong>, the <strong><code>wording()</code></strong> directive, <strong><code>@get</code></strong>, <strong><code>@post</code></strong>, <strong><code>@put</code></strong>, and <strong><code>@patch</code></strong>.</p>
20
+ <p><code>APIConfiguration</code> is the object built by <a href="../../core/utils/HTML.ts"><code>HTML.getApiConfiguration</code></a> from <strong>ancestor attributes</strong> on the DOM (or from a typed publisher — see <a href="../_decorators/get.html#get">@get</a> / <a href="../_decorators/post.html#post">@post</a> configuration key). It is passed to <a href="../../core/utils/api.ts"><code>API</code></a> by fetchers, <strong>sonic-submit</strong>, the <strong><code>wording()</code></strong> directive, <strong><code>@get</code></strong>, <strong><code>@post</code></strong>, <strong><code>@put</code></strong>, and <strong><code>@patch</code></strong>.</p>
22
21
  <blockquote>
23
- <p><strong>Mock service:</strong> same <a href="/docs/misc/docs-mock-api">Local API demos</a> Service Worker / Vite middleware. Routes used on this page are listed in the <a href="#api-config-routes">API config routes</a> section below.</p>
22
+ <p><strong>Mock service:</strong> same <a href="./docs-mock-api.html#docs-mock-api">Local API demos</a> Service Worker / Vite middleware. Routes used on this page are listed in the <a href="#api-config-routes">API config routes</a> section below.</p>
24
23
  </blockquote>
25
24
  <h2 id="attribute-map">Attribute map</h2>
26
25
  <table>
@@ -92,7 +91,7 @@
92
91
  <td><code>fetch</code> keepalive</td>
93
92
  </tr>
94
93
  </tbody></table>
95
- <p><strong>Lit / TypeScript:</strong> store the same shape in a publisher and pass <code>DataProviderKey&lt;APIConfiguration&gt;</code> as the second argument of <code>@get</code> (see <a href="/docs/misc/dataProviderKey">DataProviderKey</a>).</p>
94
+ <p><strong>Lit / TypeScript:</strong> store the same shape in a publisher and pass <code>DataProviderKey&lt;APIConfiguration&gt;</code> as the second argument of <code>@get</code> (see <a href="./dataProviderKey.html#dataProviderKey">DataProviderKey</a>).</p>
96
95
  <h2 id="bearer-token-static">Bearer token (static)</h2>
97
96
  <p>Publisher <code>docsApiConfBearerKey</code> (<code>set(docsApiConfBearerKey, { token: &quot;docs-mock-valid-token&quot;, … })</code>) — mock returns the protected payload.</p>
98
97
  <p><docs-lit-demo for="docs-api-config-bearer-demo"></docs-lit-demo></p>
@@ -106,7 +105,8 @@
106
105
  <p>Attribute <strong><code>eventsApiToken</code></strong> on an ancestor maps to <strong><code>authToken</code></strong> in config (used as Bearer when calling <code>tokenProvider</code>, instead of Basic).</p>
107
106
  <p><docs-lit-demo for="docs-api-config-events-token-demo"></docs-lit-demo></p>
108
107
  <h2 id="wording-api">Wording API</h2>
109
- <p><code>wordingProvider</code> and <code>wordingVersionProvider</code> are read by the translation directive: see <a href="/docs/directives/t">t()</a>.</p>
108
+ <p><code>wordingProvider=&quot;wording/labels?lang=fr&quot;</code> + <code>wording(&#39;api-config.greeting&#39;)</code> in Lit. Mock returns label map from <code>labels[]</code> query params.</p>
109
+ <p><docs-lit-demo for="docs-api-config-wording-demo"></docs-lit-demo></p>
110
110
  <h2 id="scoped-attributes-html--sonic-scope">Scoped attributes (HTML / sonic-scope)</h2>
111
111
  <p>Attributes on <strong><code>sonic-scope</code></strong> (or any ancestor) are visible to descendants via <code>getAncestorAttributeValue</code>.</p>
112
112
  <p><docs-lit-demo for="docs-api-config-scoped-attrs-demo"></docs-lit-demo></p>
@@ -135,12 +135,12 @@
135
135
  <p>Implementation: <code>src/docs/mock-api/api-config-mock.ts</code> (bundled in the Service Worker with <code>router.ts</code>).</p>
136
136
  <h2 id="see-also">See also</h2>
137
137
  <ul>
138
- <li><a href="/docs/decorators/get">@get</a> — <code>APIConfiguration</code> + <code>Endpoint</code></li>
139
- <li><a href="/docs/decorators/post">@post</a> — same configuration model for POST</li>
140
- <li><a href="/docs/decorators/put">@put</a> · <a href="/docs/decorators/patch">@patch</a> — PUT / PATCH</li>
141
- <li><a href="/docs/misc/endpoint">Endpoint</a> — typed path</li>
142
- <li><a href="/docs/misc/docs-mock-api">Local API demos</a> — offline <code>serviceURL</code></li>
143
- <li><a href="/core/components/functional/fetch">Fetch</a> — attribute table (legacy sonic-fetch)</li>
138
+ <li><a href="../_decorators/get.html#get">@get</a> — <code>APIConfiguration</code> + <code>Endpoint</code></li>
139
+ <li><a href="../_decorators/post.html#post">@post</a> — same configuration model for POST</li>
140
+ <li><a href="../_decorators/put.html#put">@put</a> · <a href="../_decorators/patch.html#patch">@patch</a> — PUT / PATCH</li>
141
+ <li><a href="./endpoint.html#endpoint">Endpoint</a> — typed path</li>
142
+ <li><a href="./docs-mock-api.html#docs-mock-api">Local API demos</a> — offline <code>serviceURL</code></li>
143
+ <li><a href="../../core/components/functional/fetch/fetch.html#fetch">Fetch</a> — attribute table (legacy sonic-fetch)</li>
144
144
  </ul>
145
145
 
146
146
  </article>