@supersoniks/concorde 5.1.1 → 5.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (494) hide show
  1. package/.agents/skills/concorde-docs/SKILL.md +153 -0
  2. package/.agents/skills/{concorde-component-docs/template.md → concorde-docs/templates/component.md} +6 -2
  3. package/.agents/skills/concorde-docs/templates/decorator.md +43 -0
  4. package/.agents/skills/concorde-docs/templates/guide.md +25 -0
  5. package/PLAN-DOCS-AGENTS.md +80 -0
  6. package/README.md +4 -4
  7. package/ai/README.md +29 -41
  8. package/ai/skills/concorde/SKILL.md +54 -324
  9. package/ai/skills/concorde/rules/composition.md +32 -0
  10. package/ai/skills/concorde/rules/data.md +47 -0
  11. package/ai/skills/concorde/rules/http.md +25 -0
  12. package/ai/skills/concorde/rules/lists-forms.md +35 -0
  13. package/ai/skills/concorde/rules/styling.md +46 -0
  14. package/ai/skills/concorde/rules/troubleshooting.md +45 -0
  15. package/build-infos.json +1 -1
  16. package/concorde-core.bundle.js +21 -21
  17. package/concorde-core.es.js +977 -980
  18. package/custom-elements-manifest.public.config.mjs +8 -0
  19. package/{.tmp-cem/custom-elements.json → custom-elements.json} +11758 -8904
  20. package/dist/concorde-core.bundle.js +21 -21
  21. package/dist/concorde-core.es.js +977 -980
  22. package/dist/docs-mock-api-sw.js +58 -223
  23. package/dist/docs-mock-api-sw.js.map +4 -4
  24. package/dist/img/concorde/plane_01.jpg +0 -0
  25. package/dist/img/concorde/plane_02.jpg +0 -0
  26. package/dist/img/concorde/plane_03.jpg +0 -0
  27. package/dist/img/concorde/plane_04.jpg +0 -0
  28. package/dist/img/concorde/plane_05.jpg +0 -0
  29. package/dist/img/concorde/plane_06.jpg +0 -0
  30. package/dist/img/concorde/plane_07.jpg +0 -0
  31. package/dist/img/concorde/plane_08.jpg +0 -0
  32. package/dist/img/concorde/plane_09.jpg +0 -0
  33. package/dist/img/concorde/plane_10.jpg +0 -0
  34. package/dist/img/concorde/plane_11.jpg +0 -0
  35. package/dist/img/concorde/plane_12.jpg +0 -0
  36. package/dist/img/concorde/plane_13.jpg +0 -0
  37. package/dist/img/og-concorde.jpg +0 -0
  38. package/dist/robots.txt +11 -10
  39. package/docs/.htaccess +82 -0
  40. package/docs/404.html +15 -0
  41. package/docs/404.md +5 -0
  42. package/docs/about.html +111 -0
  43. package/docs/about.md +22 -0
  44. package/docs/assets/{index-Bb-_LRyY.js → index-6sS76xWj.js} +2625 -3158
  45. package/docs/assets/index-DkdPbH0F.css +1 -0
  46. package/docs/core/components/functional/date/date.html +211 -0
  47. package/docs/core/components/functional/date/date.md +150 -0
  48. package/docs/core/components/functional/fetch/fetch.html +180 -0
  49. package/docs/core/components/functional/fetch/fetch.md +108 -0
  50. package/docs/core/components/functional/if/if.html +65 -0
  51. package/docs/core/components/functional/if/if.md +34 -0
  52. package/docs/core/components/functional/jsonata/jsonata.html +110 -0
  53. package/docs/core/components/functional/jsonata/jsonata.md +61 -0
  54. package/docs/core/components/functional/list/list.html +200 -0
  55. package/docs/core/components/functional/list/list.md +125 -0
  56. package/docs/core/components/functional/mix/mix.html +78 -0
  57. package/docs/core/components/functional/mix/mix.md +46 -0
  58. package/docs/core/components/functional/queue/queue.html +155 -0
  59. package/docs/core/components/functional/queue/queue.md +51 -0
  60. package/docs/core/components/functional/router/router.html +154 -0
  61. package/docs/core/components/functional/router/router.md +93 -0
  62. package/docs/core/components/functional/sdui/sdui-extension-points.html +127 -0
  63. package/docs/core/components/functional/sdui/sdui-extension-points.md +94 -0
  64. package/docs/core/components/functional/sdui/sdui.html +397 -0
  65. package/docs/core/components/functional/sdui/sdui.md +307 -0
  66. package/docs/core/components/functional/states/states.html +141 -0
  67. package/docs/core/components/functional/states/states.md +112 -0
  68. package/docs/core/components/functional/submit/submit.html +178 -0
  69. package/docs/core/components/functional/submit/submit.md +106 -0
  70. package/docs/core/components/functional/subscriber/subscriber.html +68 -0
  71. package/docs/core/components/functional/subscriber/subscriber.md +91 -0
  72. package/docs/core/components/functional/translation/translation.html +60 -0
  73. package/docs/core/components/functional/translation/translation.md +38 -0
  74. package/docs/core/components/functional/value/value.html +81 -0
  75. package/docs/core/components/functional/value/value.md +47 -0
  76. package/docs/core/components/ui/alert/alert.html +201 -0
  77. package/docs/core/components/ui/alert/alert.md +186 -0
  78. package/docs/core/components/ui/alert-messages/alert-messages.html +132 -0
  79. package/docs/core/components/ui/alert-messages/alert-messages.md +85 -0
  80. package/docs/core/components/ui/badge/badge.html +197 -0
  81. package/docs/core/components/ui/badge/badge.md +181 -0
  82. package/docs/core/components/ui/button/button.html +309 -0
  83. package/docs/core/components/ui/button/button.md +216 -0
  84. package/docs/core/components/ui/captcha/captcha.html +80 -0
  85. package/docs/core/components/ui/captcha/captcha.md +56 -0
  86. package/docs/core/components/ui/card/card.html +254 -0
  87. package/docs/core/components/ui/card/card.md +215 -0
  88. package/docs/core/components/ui/divider/divider.html +144 -0
  89. package/docs/core/components/ui/divider/divider.md +126 -0
  90. package/docs/core/components/ui/form/checkbox/checkbox.html +200 -0
  91. package/docs/core/components/ui/form/checkbox/checkbox.md +125 -0
  92. package/docs/core/components/ui/form/fieldset/fieldset.html +238 -0
  93. package/docs/core/components/ui/form/fieldset/fieldset.md +161 -0
  94. package/docs/core/components/ui/form/form-actions/form-actions.html +122 -0
  95. package/docs/core/components/ui/form/form-actions/form-actions.md +98 -0
  96. package/docs/core/components/ui/form/form-layout/form-layout.html +115 -0
  97. package/docs/core/components/ui/form/form-layout/form-layout.md +109 -0
  98. package/docs/core/components/ui/form/input/input.html +235 -0
  99. package/docs/core/components/ui/form/input/input.md +142 -0
  100. package/docs/core/components/ui/form/radio/radio.html +144 -0
  101. package/docs/core/components/ui/form/radio/radio.md +78 -0
  102. package/docs/core/components/ui/form/select/select.html +178 -0
  103. package/docs/core/components/ui/form/select/select.md +86 -0
  104. package/docs/core/components/ui/form/switch/switch.html +146 -0
  105. package/docs/core/components/ui/form/switch/switch.md +80 -0
  106. package/docs/core/components/ui/form/textarea/textarea.html +162 -0
  107. package/docs/core/components/ui/form/textarea/textarea.md +82 -0
  108. package/docs/core/components/ui/group/group.html +113 -0
  109. package/docs/core/components/ui/group/group.md +77 -0
  110. package/docs/core/components/ui/icon/icon.html +223 -0
  111. package/docs/core/components/ui/icon/icon.md +214 -0
  112. package/docs/core/components/ui/image/image.html +194 -0
  113. package/docs/core/components/ui/image/image.md +167 -0
  114. package/docs/core/components/ui/link/link.html +101 -0
  115. package/docs/core/components/ui/link/link.md +81 -0
  116. package/docs/core/components/ui/loader/loader.html +114 -0
  117. package/docs/core/components/ui/loader/loader.md +87 -0
  118. package/docs/core/components/ui/menu/menu.html +395 -0
  119. package/docs/core/components/ui/menu/menu.md +370 -0
  120. package/docs/core/components/ui/modal/modal.html +324 -0
  121. package/docs/core/components/ui/modal/modal.md +211 -0
  122. package/docs/core/components/ui/pop/pop.html +250 -0
  123. package/docs/core/components/ui/pop/pop.md +216 -0
  124. package/docs/core/components/ui/progress/progress.html +132 -0
  125. package/docs/core/components/ui/progress/progress.md +109 -0
  126. package/docs/core/components/ui/table/table.html +333 -0
  127. package/docs/core/components/ui/table/table.md +267 -0
  128. package/docs/core/components/ui/theme/theme.html +116 -0
  129. package/docs/core/components/ui/theme/theme.md +97 -0
  130. package/docs/core/components/ui/toast/toast.html +185 -0
  131. package/docs/core/components/ui/toast/toast.md +147 -0
  132. package/docs/core/components/ui/tooltip/tooltip.html +112 -0
  133. package/docs/core/components/ui/tooltip/tooltip.md +89 -0
  134. package/docs/custom-elements.json +16559 -0
  135. package/docs/docs/decorators/ancestor-attribute.html +71 -0
  136. package/docs/docs/decorators/ancestor-attribute.md +59 -0
  137. package/docs/docs/decorators/auto-subscribe.html +61 -0
  138. package/docs/docs/decorators/auto-subscribe.md +40 -0
  139. package/docs/docs/decorators/bind.html +87 -0
  140. package/docs/docs/decorators/bind.md +76 -0
  141. package/docs/docs/decorators/get.html +166 -0
  142. package/docs/docs/decorators/get.md +160 -0
  143. package/docs/docs/decorators/handle.html +139 -0
  144. package/docs/docs/decorators/handle.md +119 -0
  145. package/docs/docs/decorators/on-assign.html +72 -0
  146. package/docs/docs/decorators/on-assign.md +63 -0
  147. package/docs/docs/decorators/patch.html +76 -0
  148. package/docs/docs/decorators/patch.md +44 -0
  149. package/docs/docs/decorators/post.html +150 -0
  150. package/docs/docs/decorators/post.md +134 -0
  151. package/docs/docs/decorators/publish.html +74 -0
  152. package/docs/docs/decorators/publish.md +56 -0
  153. package/docs/docs/decorators/put.html +83 -0
  154. package/docs/docs/decorators/put.md +51 -0
  155. package/docs/docs/decorators/subscribe.html +91 -0
  156. package/docs/docs/decorators/subscribe.md +87 -0
  157. package/docs/docs/decorators/wait-for-ancestors.html +82 -0
  158. package/docs/docs/decorators/wait-for-ancestors.md +76 -0
  159. package/docs/docs/directives/sub.html +79 -0
  160. package/docs/docs/directives/sub.md +75 -0
  161. package/docs/docs/directives/t.html +91 -0
  162. package/docs/docs/directives/t.md +73 -0
  163. package/docs/docs/getting-started/ai-agents.html +130 -0
  164. package/docs/docs/getting-started/ai-agents.md +50 -0
  165. package/docs/docs/getting-started/components.html +27 -0
  166. package/docs/docs/getting-started/create-a-component.html +108 -0
  167. package/{src/docs/_getting-started → docs/docs/getting-started}/create-a-component.md +3 -6
  168. package/docs/docs/getting-started/dataFlow.html +174 -0
  169. package/{src/docs/_core-concept → docs/docs/getting-started}/dataFlow.md +18 -19
  170. package/docs/docs/getting-started/installation.html +69 -0
  171. package/docs/docs/getting-started/installation.md +36 -0
  172. package/docs/docs/getting-started/my-first-component.html +180 -0
  173. package/{src/docs/_getting-started → docs/docs/getting-started}/my-first-component.md +5 -14
  174. package/docs/docs/getting-started/start.html +47 -0
  175. package/{src/docs/_getting-started → docs/docs/getting-started}/start.md +1 -13
  176. package/docs/docs/getting-started/theming.html +334 -0
  177. package/docs/docs/index.html +99 -0
  178. package/docs/docs/misc/api-configuration.html +149 -0
  179. package/{src/docs/_misc → docs/docs/misc}/api-configuration.md +10 -12
  180. package/docs/docs/misc/dataProviderKey.html +136 -0
  181. package/{src/docs/_misc → docs/docs/misc}/dataProviderKey.md +4 -4
  182. package/docs/docs/misc/docs-mock-api.html +155 -0
  183. package/{src/docs/_misc → docs/docs/misc}/docs-mock-api.md +12 -13
  184. package/docs/docs/misc/dynamic-path.html +181 -0
  185. package/{src/docs/_misc → docs/docs/misc}/dynamic-path.md +8 -8
  186. package/docs/docs/misc/endpoint.html +51 -0
  187. package/{src/docs/_misc → docs/docs/misc}/endpoint.md +8 -8
  188. package/docs/docs/misc/html-integration.html +45 -0
  189. package/{src/docs/_misc → docs/docs/misc}/html-integration.md +4 -5
  190. package/docs/docs-mock-api-sw.js +58 -223
  191. package/docs/docs-mock-api-sw.js.map +4 -4
  192. package/docs/hubs/decorators.html +438 -0
  193. package/docs/hubs/form-components.html +404 -0
  194. package/docs/hubs/remote-data.html +367 -0
  195. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  196. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  197. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  198. package/docs/img/archive/credits.json +28 -0
  199. package/docs/img/concorde/plane_01.jpg +0 -0
  200. package/docs/img/concorde/plane_02.jpg +0 -0
  201. package/docs/img/concorde/plane_03.jpg +0 -0
  202. package/docs/img/concorde/plane_04.jpg +0 -0
  203. package/docs/img/concorde/plane_05.jpg +0 -0
  204. package/docs/img/concorde/plane_06.jpg +0 -0
  205. package/docs/img/concorde/plane_07.jpg +0 -0
  206. package/docs/img/concorde/plane_08.jpg +0 -0
  207. package/docs/img/concorde/plane_09.jpg +0 -0
  208. package/docs/img/concorde/plane_10.jpg +0 -0
  209. package/docs/img/concorde/plane_11.jpg +0 -0
  210. package/docs/img/concorde/plane_12.jpg +0 -0
  211. package/docs/img/concorde/plane_13.jpg +0 -0
  212. package/docs/img/og-concorde.jpg +0 -0
  213. package/docs/index.html +184 -68
  214. package/docs/index.md +22 -0
  215. package/docs/llms-full.txt +5779 -0
  216. package/docs/llms.txt +108 -0
  217. package/docs/privacy.html +122 -0
  218. package/docs/privacy.md +32 -0
  219. package/docs/robots.txt +11 -10
  220. package/docs/sitemap.xml +243 -0
  221. package/docs/src/core/components/functional/date/date.md +150 -0
  222. package/docs/src/core/components/functional/fetch/fetch.md +108 -0
  223. package/docs/src/core/components/functional/if/if.md +34 -0
  224. package/docs/src/core/components/functional/jsonata/jsonata.md +61 -0
  225. package/docs/src/core/components/functional/list/list.md +125 -0
  226. package/docs/src/core/components/functional/mix/mix.md +46 -0
  227. package/docs/src/core/components/functional/queue/queue.md +51 -0
  228. package/docs/src/core/components/functional/router/router.md +93 -0
  229. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  230. package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
  231. package/docs/src/core/components/functional/sdui/default-library.json +108 -0
  232. package/docs/src/core/components/functional/sdui/example.json +32 -0
  233. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  234. package/docs/src/core/components/functional/sdui/sdui.md +307 -0
  235. package/docs/src/core/components/functional/states/states.md +112 -0
  236. package/docs/src/core/components/functional/submit/submit.md +106 -0
  237. package/docs/src/core/components/functional/subscriber/subscriber.md +91 -0
  238. package/docs/src/core/components/functional/translation/translation.md +38 -0
  239. package/docs/src/core/components/functional/value/value.md +47 -0
  240. package/docs/src/core/components/ui/alert/alert.md +186 -0
  241. package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
  242. package/docs/src/core/components/ui/badge/badge.md +181 -0
  243. package/docs/src/core/components/ui/button/button.md +216 -0
  244. package/docs/src/core/components/ui/captcha/captcha.md +56 -0
  245. package/docs/src/core/components/ui/card/card.md +215 -0
  246. package/docs/src/core/components/ui/divider/divider.md +126 -0
  247. package/docs/src/core/components/ui/form/checkbox/checkbox.md +125 -0
  248. package/docs/src/core/components/ui/form/fieldset/fieldset.md +161 -0
  249. package/docs/src/core/components/ui/form/form-actions/form-actions.md +98 -0
  250. package/docs/src/core/components/ui/form/form-layout/form-layout.md +109 -0
  251. package/docs/src/core/components/ui/form/input/input.md +142 -0
  252. package/docs/src/core/components/ui/form/radio/radio.md +78 -0
  253. package/docs/src/core/components/ui/form/select/select.md +86 -0
  254. package/docs/src/core/components/ui/form/switch/switch.md +80 -0
  255. package/docs/src/core/components/ui/form/textarea/textarea.md +82 -0
  256. package/docs/src/core/components/ui/group/group.md +77 -0
  257. package/docs/src/core/components/ui/icon/icon.md +214 -0
  258. package/docs/src/core/components/ui/icon/icons.json +1 -0
  259. package/docs/src/core/components/ui/image/image.md +167 -0
  260. package/docs/src/core/components/ui/link/link.md +81 -0
  261. package/docs/src/core/components/ui/loader/loader.md +87 -0
  262. package/docs/src/core/components/ui/menu/menu.md +370 -0
  263. package/docs/src/core/components/ui/modal/modal.md +211 -0
  264. package/docs/src/core/components/ui/pop/pop.md +216 -0
  265. package/docs/src/core/components/ui/progress/progress.md +109 -0
  266. package/docs/src/core/components/ui/table/table.md +267 -0
  267. package/docs/src/core/components/ui/theme/theme.md +97 -0
  268. package/docs/src/core/components/ui/toast/toast.md +147 -0
  269. package/docs/src/core/components/ui/tooltip/tooltip.md +89 -0
  270. package/docs/src/docs/decorators/ancestor-attribute.md +59 -0
  271. package/docs/src/docs/decorators/auto-subscribe.md +40 -0
  272. package/docs/src/docs/decorators/bind.md +76 -0
  273. package/docs/src/docs/decorators/get.md +160 -0
  274. package/docs/src/docs/decorators/handle.md +119 -0
  275. package/docs/src/docs/decorators/on-assign.md +63 -0
  276. package/docs/src/docs/decorators/patch.md +44 -0
  277. package/docs/src/docs/decorators/post.md +134 -0
  278. package/docs/src/docs/decorators/publish.md +56 -0
  279. package/docs/src/docs/decorators/put.md +51 -0
  280. package/docs/src/docs/decorators/subscribe.md +87 -0
  281. package/docs/src/docs/decorators/wait-for-ancestors.md +76 -0
  282. package/docs/src/docs/directives/sub.md +75 -0
  283. package/docs/src/docs/directives/t.md +73 -0
  284. package/docs/src/docs/getting-started/ai-agents.md +50 -0
  285. package/docs/src/docs/getting-started/components.md +5 -0
  286. package/docs/src/docs/getting-started/create-a-component.md +136 -0
  287. package/docs/src/docs/getting-started/dataFlow.md +87 -0
  288. package/docs/src/docs/getting-started/installation.md +36 -0
  289. package/docs/src/docs/getting-started/my-first-component.md +227 -0
  290. package/docs/src/docs/getting-started/start.md +35 -0
  291. package/docs/src/docs/getting-started/theming.md +253 -0
  292. package/docs/src/docs/misc/api-configuration.md +79 -0
  293. package/docs/src/docs/misc/dataProviderKey.md +168 -0
  294. package/docs/src/docs/misc/docs-mock-api.md +62 -0
  295. package/docs/src/docs/misc/dynamic-path.md +71 -0
  296. package/docs/src/docs/misc/endpoint.md +45 -0
  297. package/docs/src/docs/misc/html-integration.md +14 -0
  298. package/docs/src/docs/search/docs-search.json +10332 -0
  299. package/docs/src/tag-list.json +1 -0
  300. package/docs/src/tsconfig-model.json +23 -0
  301. package/docs/src/tsconfig.json +1359 -0
  302. package/index.html +157 -5
  303. package/package.json +8 -4
  304. package/public/docs-mock-api-sw.js +58 -223
  305. package/public/docs-mock-api-sw.js.map +4 -4
  306. package/public/img/concorde/plane_01.jpg +0 -0
  307. package/public/img/concorde/plane_02.jpg +0 -0
  308. package/public/img/concorde/plane_03.jpg +0 -0
  309. package/public/img/concorde/plane_04.jpg +0 -0
  310. package/public/img/concorde/plane_05.jpg +0 -0
  311. package/public/img/concorde/plane_06.jpg +0 -0
  312. package/public/img/concorde/plane_07.jpg +0 -0
  313. package/public/img/concorde/plane_08.jpg +0 -0
  314. package/public/img/concorde/plane_09.jpg +0 -0
  315. package/public/img/concorde/plane_10.jpg +0 -0
  316. package/public/img/concorde/plane_11.jpg +0 -0
  317. package/public/img/concorde/plane_12.jpg +0 -0
  318. package/public/img/concorde/plane_13.jpg +0 -0
  319. package/public/img/og-concorde.jpg +0 -0
  320. package/public/robots.txt +11 -10
  321. package/scripts/ai-init.mjs +104 -379
  322. package/scripts/ai-init.test.mjs +81 -239
  323. package/scripts/docs-markdown-vite-plugin.ts +43 -0
  324. package/scripts/docs-public-url.mjs +56 -0
  325. package/scripts/docs.htaccess +82 -0
  326. package/scripts/generate-cem.mjs +244 -0
  327. package/scripts/generate-cem.test.mjs +122 -0
  328. package/scripts/generate-crawl-docs.mjs +233 -118
  329. package/scripts/generate-crawl-docs.test.mjs +124 -0
  330. package/scripts/generate-sdui-catalog.mjs +11 -10
  331. package/scripts/post-build-docs.js +37 -50
  332. package/scripts/pre-publish.mjs +2 -1
  333. package/scripts/site-pages.mjs +212 -0
  334. package/scripts/site-pages.test.mjs +116 -0
  335. package/site-pages/about.md +22 -0
  336. package/site-pages/privacy.md +32 -0
  337. package/src/core/components/functional/date/date.md +91 -231
  338. package/src/core/components/functional/fetch/fetch.md +66 -83
  339. package/src/core/components/functional/if/if.md +28 -3
  340. package/src/core/components/functional/jsonata/jsonata.md +42 -37
  341. package/src/core/components/functional/list/list.md +103 -43
  342. package/src/core/components/functional/mix/mix.md +31 -26
  343. package/src/core/components/functional/queue/queue.demo.ts +10 -7
  344. package/src/core/components/functional/queue/queue.md +40 -61
  345. package/src/core/components/functional/router/router.demo.ts +16 -16
  346. package/src/core/components/functional/router/router.md +64 -65
  347. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  348. package/src/core/components/functional/sdui/component-catalog.json +1 -1
  349. package/src/core/components/functional/sdui/example.json +19 -86
  350. package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  351. package/src/core/components/functional/sdui/sdui.md +187 -358
  352. package/src/core/components/functional/states/states.demo.ts +21 -22
  353. package/src/core/components/functional/states/states.md +86 -61
  354. package/src/core/components/functional/states/states.ts +1 -1
  355. package/src/core/components/functional/submit/submit.md +64 -72
  356. package/src/core/components/functional/translation/translation.md +38 -0
  357. package/src/core/components/functional/value/value.md +34 -22
  358. package/src/core/components/ui/alert/alert.md +48 -58
  359. package/src/core/components/ui/badge/badge.md +27 -34
  360. package/src/core/components/ui/button/button.md +139 -106
  361. package/src/core/components/ui/captcha/captcha.md +17 -32
  362. package/src/core/components/ui/card/card.md +6 -6
  363. package/src/core/components/ui/divider/divider.md +8 -11
  364. package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  365. package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
  366. package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
  367. package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
  368. package/src/core/components/ui/form/input/input.md +95 -95
  369. package/src/core/components/ui/form/radio/radio.md +55 -34
  370. package/src/core/components/ui/form/select/select.md +60 -45
  371. package/src/core/components/ui/form/switch/switch.md +57 -34
  372. package/src/core/components/ui/form/textarea/textarea.md +55 -38
  373. package/src/core/components/ui/group/group.md +35 -33
  374. package/src/core/components/ui/icon/icon.md +4 -4
  375. package/src/core/components/ui/image/image.md +41 -107
  376. package/src/core/components/ui/link/link.md +6 -6
  377. package/src/core/components/ui/loader/loader.md +30 -55
  378. package/src/core/components/ui/menu/menu.md +27 -27
  379. package/src/core/components/ui/modal/modal.md +72 -96
  380. package/src/core/components/ui/pop/pop.md +80 -158
  381. package/src/core/components/ui/progress/progress.md +2 -2
  382. package/src/core/components/ui/table/table.md +91 -255
  383. package/src/core/components/ui/theme/theme.md +11 -36
  384. package/src/core/components/ui/toast/toast.md +48 -117
  385. package/src/core/components/ui/tooltip/tooltip.md +27 -62
  386. package/src/core/decorators/subscriber/bind.ts +9 -14
  387. package/src/core/utils/LocationHandler.spec.ts +80 -0
  388. package/src/core/utils/LocationHandler.ts +5 -9
  389. package/src/docs/components/docs-demo-sources.ts +55 -140
  390. package/src/docs/components/docs-lit-demo.ts +1 -3
  391. package/src/docs/components/docs-source-link.ts +0 -82
  392. package/src/docs/decorators/ancestor-attribute.md +59 -0
  393. package/src/docs/decorators/auto-subscribe.md +40 -0
  394. package/src/docs/decorators/bind.md +76 -0
  395. package/src/docs/decorators/get.md +160 -0
  396. package/src/docs/decorators/handle.md +119 -0
  397. package/src/docs/decorators/on-assign.md +63 -0
  398. package/src/docs/decorators/patch.md +44 -0
  399. package/src/docs/decorators/post.md +134 -0
  400. package/src/docs/decorators/publish.md +56 -0
  401. package/src/docs/decorators/put.md +51 -0
  402. package/src/docs/decorators/subscribe.md +87 -0
  403. package/src/docs/decorators/wait-for-ancestors.md +76 -0
  404. package/src/docs/directives/sub.md +75 -0
  405. package/src/docs/directives/t.md +73 -0
  406. package/src/docs/docs-location.spec.ts +56 -0
  407. package/src/docs/docs-location.ts +133 -32
  408. package/src/docs/docs.ts +1 -2
  409. package/src/docs/example/decorators-demo-bind-demos.ts +83 -135
  410. package/src/docs/example/decorators-demo-geo.ts +30 -19
  411. package/src/docs/example/decorators-demo-post.ts +88 -186
  412. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
  413. package/src/docs/example/decorators-demo.ts +85 -98
  414. package/src/docs/example/docs-api-config-demos.ts +19 -20
  415. package/src/docs/example/docs-flight-demos.ts +147 -0
  416. package/src/docs/example/docs-jsonata-demos.ts +52 -52
  417. package/src/docs/example/docs-list-demos.ts +43 -123
  418. package/src/docs/example/docs-provider-keys.ts +21 -28
  419. package/src/docs/example/docs-queue-demos.ts +37 -77
  420. package/src/docs/example/docs-router-demos.ts +20 -25
  421. package/src/docs/example/docs-submit-demos.ts +48 -48
  422. package/src/docs/example/docs-toggle-demos.ts +4 -3
  423. package/src/docs/getting-started/ai-agents.md +50 -0
  424. package/src/docs/getting-started/components.md +5 -0
  425. package/src/docs/getting-started/create-a-component.md +136 -0
  426. package/src/docs/getting-started/dataFlow.md +87 -0
  427. package/src/docs/getting-started/installation.md +36 -0
  428. package/src/docs/getting-started/my-first-component.md +227 -0
  429. package/src/docs/getting-started/start.md +35 -0
  430. package/src/docs/getting-started/theming.md +253 -0
  431. package/src/docs/header/header.ts +11 -6
  432. package/src/docs/home/catalog.ts +1 -1
  433. package/src/docs/home/home.ts +20 -11
  434. package/src/docs/layout.ts +12 -13
  435. package/src/docs/misc/api-configuration.md +79 -0
  436. package/src/docs/misc/dataProviderKey.md +168 -0
  437. package/src/docs/misc/docs-mock-api.md +62 -0
  438. package/src/docs/misc/dynamic-path.md +71 -0
  439. package/src/docs/misc/endpoint.md +45 -0
  440. package/src/docs/misc/html-integration.md +14 -0
  441. package/src/docs/mock-api/api-config-mock.ts +5 -0
  442. package/src/docs/mock-api/fixtures.ts +0 -278
  443. package/src/docs/mock-api/flights.ts +89 -0
  444. package/src/docs/mock-api/router.ts +3 -4
  445. package/src/docs/mock-api/urls.ts +1 -2
  446. package/src/docs/navigation/navigation.ts +82 -103
  447. package/src/docs/navigation/toc.ts +7 -4
  448. package/src/docs/search/docs-search.json +2804 -5024
  449. package/src/docs/search/markdown-renderer.ts +31 -8
  450. package/src/docs/search/page.ts +9 -6
  451. package/src/docs/search/search.ts +154 -122
  452. package/src/docs/tailwind/css/docs/content.css +4 -5
  453. package/src/tsconfig.json +11 -5
  454. package/src/tsconfig.tsbuildinfo +1 -1
  455. package/vite.config.mts +11 -2
  456. package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
  457. package/ai/AGENTS.md +0 -56
  458. package/ai/cursor/rules/concorde-menu.mdc +0 -15
  459. package/ai/cursor/rules/concorde-scope.mdc +0 -14
  460. package/ai/cursor/rules/concorde-theme.mdc +0 -13
  461. package/ai/cursor/rules/concorde.mdc +0 -66
  462. package/ai/jetbrains/rules/concorde.md +0 -53
  463. package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
  464. package/ai/skills/concorde-imports/SKILL.md +0 -78
  465. package/ai/skills/concorde-menu/SKILL.md +0 -74
  466. package/ai/skills/concorde-scope/SKILL.md +0 -70
  467. package/ai/skills/concorde-theme/SKILL.md +0 -57
  468. package/docs/assets/index-CD4WyL6o.css +0 -1
  469. package/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  470. package/src/docs/_core-concept/overview.md +0 -57
  471. package/src/docs/_core-concept/subscriber.md +0 -75
  472. package/src/docs/_decorators/ancestor-attribute.md +0 -128
  473. package/src/docs/_decorators/auto-subscribe.md +0 -202
  474. package/src/docs/_decorators/bind.md +0 -167
  475. package/src/docs/_decorators/get.md +0 -162
  476. package/src/docs/_decorators/handle.md +0 -175
  477. package/src/docs/_decorators/on-assign.md +0 -390
  478. package/src/docs/_decorators/patch.md +0 -70
  479. package/src/docs/_decorators/post.md +0 -146
  480. package/src/docs/_decorators/publish.md +0 -55
  481. package/src/docs/_decorators/put.md +0 -70
  482. package/src/docs/_decorators/subscribe.md +0 -100
  483. package/src/docs/_decorators/wait-for-ancestors.md +0 -163
  484. package/src/docs/_directives/sub.md +0 -91
  485. package/src/docs/_getting-started/ai-agents.md +0 -76
  486. package/src/docs/_getting-started/concorde-manual-install.md +0 -133
  487. package/src/docs/_getting-started/concorde-outside.md +0 -33
  488. package/src/docs/_getting-started/my-first-subscriber.md +0 -120
  489. package/src/docs/_getting-started/pubsub.md +0 -37
  490. package/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  491. package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
  492. package/src/docs/example/docs-joke-demos.ts +0 -297
  493. /package/{src/docs/_getting-started → docs/docs/getting-started}/components.md +0 -0
  494. /package/{src/docs/_getting-started → docs/docs/getting-started}/theming.md +0 -0
package/docs/docs/getting-started/theming.html ADDED
@@ -0,0 +1,334 @@
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">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Theming — Concorde by Supersoniks</title>
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">
12
+ </head>
13
+ <body>
14
+ <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>
16
+ </header>
17
+ <main>
18
+ <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>
21
+ <h2 id="theme-first-customization">Theme-first customization</h2>
22
+ <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
+ <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;
25
+ &lt;!-- your app --&gt;
26
+ &lt;/sonic-theme&gt;
27
+ </code></pre>
28
+ <pre><code class="language-javascript">import &quot;@supersoniks/concorde/theme&quot;;
29
+ </code></pre>
30
+ <table>
31
+ <thead>
32
+ <tr>
33
+ <th>Attribute</th>
34
+ <th>Effect</th>
35
+ </tr>
36
+ </thead>
37
+ <tbody><tr>
38
+ <td><em>(omit)</em> | <code>theme=&quot;custom&quot;</code></td>
39
+ <td>Default: core tokens + your <code>--sc-*</code>; no built-in light/dark palette</td>
40
+ </tr>
41
+ <tr>
42
+ <td><code>theme=&quot;light&quot;</code> | <code>&quot;dark&quot;</code> | <code>&quot;auto&quot;</code></td>
43
+ <td>Opt-in presets; <code>auto</code> follows <code>prefers-color-scheme</code></td>
44
+ </tr>
45
+ <tr>
46
+ <td><code>class=&quot;bg-base block&quot;</code> (Tailwind)</td>
47
+ <td>Page/surface background (<code>--sc-base</code>)</td>
48
+ </tr>
49
+ <tr>
50
+ <td><code>color</code></td>
51
+ <td>Text color (<code>--sc-base-content</code>)</td>
52
+ </tr>
53
+ <tr>
54
+ <td><code>font</code></td>
55
+ <td>Base font family/weight (<code>--sc-font-family-base</code>, etc.)</td>
56
+ </tr>
57
+ </tbody></table>
58
+ <p>Popovers, modals, and toasts mount under the nearest <code>&lt;sonic-theme&gt;</code>.</p>
59
+ <h2 id="customization-example">Customization example</h2>
60
+ <p>Example (full brand override on <code>&lt;sonic-theme&gt;</code> or <code>:root</code>). Set every essential token below; derived radii and shadows still come from the theme engine—only <code>--sc-rounded</code> is listed here.</p>
61
+ <pre><code class="language-css">sonic-theme {
62
+ /* Semantic fills */
63
+ --sc-primary: #353429;
64
+ --sc-secondary: #f43f5e;
65
+ --sc-info: #7c3aed;
66
+ --sc-danger: #d71839;
67
+ --sc-warning: #f97316;
68
+ --sc-success: #10b981;
69
+ --sc-contrast: #111;
70
+
71
+ /* Text/icons on semantic fills */
72
+ --sc-primary-content: #fff;
73
+ --sc-secondary-content: #fff;
74
+ --sc-info-content: #fff;
75
+ --sc-danger-content: #fff;
76
+ --sc-warning-content: #fff;
77
+ --sc-success-content: #fff;
78
+ --sc-contrast-content: #fff;
79
+
80
+ /* Neutral fills */
81
+ --sc-base: #fff;
82
+ --sc-base-50: #f6f6f5;
83
+ --sc-base-100: #ededec;
84
+ --sc-base-200: #d7d7d4;
85
+ --sc-base-300: #c8c7c4;
86
+ --sc-base-400: #a8a7a2;
87
+ --sc-base-500: #94938c;
88
+ --sc-base-600: #76756c;
89
+ --sc-base-700: #59584e;
90
+ --sc-base-800: #47463b;
91
+ --sc-base-900: #353429;
92
+
93
+ /* Text/icons on neutral surfaces */
94
+ --sc-base-content: var(--sc-base-900);
95
+
96
+ /* Typography */
97
+ --sc-font-family-base: &quot;Oswald&quot;, system-ui, -apple-system, &quot;Segoe UI&quot;, Roboto,
98
+ &quot;Helvetica Neue&quot;, Arial, sans-serif;
99
+ --sc-headings-font-family: &quot;alternate-gothic-compressed&quot;, system-ui, sans-serif;
100
+ --sc-headings-line-height: 1.1;
101
+ --sc-headings-font-weight: bold;
102
+ --sc-headings-text-transform: none;
103
+
104
+ /* Shape (primitive only) */
105
+ --sc-rounded: 0;
106
+
107
+ /* Forms */
108
+ --sc-border-width: 0.2rem;
109
+ --sc-form-height: 2em;
110
+ --sc-input-bg: var(--sc-base);
111
+ --sc-input-color: var(--sc-base-content);
112
+ --sc-input-border-color: var(--sc-input-color);
113
+ --sc-input-active-bg: var(--sc-primary);
114
+ --sc-input-active-color: var(--sc-primary-content);
115
+ --sc-input-active-border-color: var(--sc-primary);
116
+ }
117
+ </code></pre>
118
+ <p><sonic-button href="https://delanfranchi.github.io/concordecolors/"> Palette generator: concordecolors</sonic-button></p>
119
+ <p><strong>Without these overrides</strong>, components keep Concorde’s per-component fallbacks. Built-in light/dark palettes apply only when you set <code>theme=&quot;light&quot;</code>, <code>theme=&quot;dark&quot;</code>, or <code>theme=&quot;auto&quot;</code>.</p>
120
+ <p><strong>What we intentionally avoid:</strong> large public <code>--sc-alert-*</code> / <code>--sc-badge-*</code> APIs or <code>::part()</code> styling hooks on most components. Prefer attributes (<code>type</code>, <code>status</code>, <code>size</code>, …) and the theme tokens above.</p>
121
+ <h2 id="only-essential-css-variables-public-theme-api">Only essential CSS variables (public theme API)</h2>
122
+ <p>These are the <strong>smallest set</strong> we recommend customizing. Everything else should stay internal to the theme or to components (<code>--sc_*</code> private variables, attributes like <code>type</code>, <code>size</code>, <code>variant</code>).</p>
123
+ <h3 id="surfaces-and-foreground">Surfaces and foreground</h3>
124
+ <p>Tokens <strong>without</strong> a <code>-content</code> suffix are <strong>fill / background</strong> colors.<br>Tokens <strong>with</strong> <code>-content</code> are <strong>text and icons</strong> on top of the matching fill (solid buttons, badges, alerts, etc.).</p>
125
+ <h4 id="neutral-fills">Neutral fills</h4>
126
+ <table>
127
+ <thead>
128
+ <tr>
129
+ <th>Variable</th>
130
+ <th>Role</th>
131
+ </tr>
132
+ </thead>
133
+ <tbody><tr>
134
+ <td><code>--sc-base</code></td>
135
+ <td>Main surface / page background</td>
136
+ </tr>
137
+ <tr>
138
+ <td><code>--sc-base-50</code> … <code>--sc-base-900</code></td>
139
+ <td>Neutral scale (borders, subtle backgrounds, muted UI)</td>
140
+ </tr>
141
+ </tbody></table>
142
+ <h4 id="neutral-foreground">Neutral foreground</h4>
143
+ <table>
144
+ <thead>
145
+ <tr>
146
+ <th>Variable</th>
147
+ <th>Role</th>
148
+ </tr>
149
+ </thead>
150
+ <tbody><tr>
151
+ <td><code>--sc-base-content</code></td>
152
+ <td>Default body text and icons on neutral surfaces</td>
153
+ </tr>
154
+ </tbody></table>
155
+ <h4 id="semantic-fills">Semantic fills</h4>
156
+ <table>
157
+ <thead>
158
+ <tr>
159
+ <th>Variable</th>
160
+ <th>Role</th>
161
+ </tr>
162
+ </thead>
163
+ <tbody><tr>
164
+ <td><code>--sc-primary</code></td>
165
+ <td>Primary actions, links, emphasis</td>
166
+ </tr>
167
+ <tr>
168
+ <td><code>--sc-secondary</code></td>
169
+ <td>Secondary brand accent (when used)</td>
170
+ </tr>
171
+ <tr>
172
+ <td><code>--sc-info</code>, <code>--sc-success</code>, <code>--sc-warning</code>, <code>--sc-danger</code></td>
173
+ <td>Status and feedback</td>
174
+ </tr>
175
+ <tr>
176
+ <td><code>--sc-contrast</code></td>
177
+ <td>High-contrast fills (e.g. on media)</td>
178
+ </tr>
179
+ </tbody></table>
180
+ <h4 id="semantic-foreground">Semantic foreground</h4>
181
+ <table>
182
+ <thead>
183
+ <tr>
184
+ <th>Variable</th>
185
+ <th>Role</th>
186
+ </tr>
187
+ </thead>
188
+ <tbody><tr>
189
+ <td><code>--sc-primary-content</code>, <code>--sc-secondary-content</code>, …</td>
190
+ <td>Text/icons on the matching semantic <strong>fill</strong> (<code>--sc-primary</code>, etc.)</td>
191
+ </tr>
192
+ </tbody></table>
193
+ <h3 id="shape">Shape</h3>
194
+ <table>
195
+ <thead>
196
+ <tr>
197
+ <th>Variable</th>
198
+ <th>Role</th>
199
+ </tr>
200
+ </thead>
201
+ <tbody><tr>
202
+ <td><code>--sc-rounded</code></td>
203
+ <td><strong>Single primitive</strong> corner radius; the theme computes <code>--sc-rounded-sm</code>, <code>--sc-btn-rounded</code>, <code>--sc-input-rounded</code>, etc.</td>
204
+ </tr>
205
+ </tbody></table>
206
+ <h3 id="typography">Typography</h3>
207
+ <table>
208
+ <thead>
209
+ <tr>
210
+ <th>Variable</th>
211
+ <th>Role</th>
212
+ </tr>
213
+ </thead>
214
+ <tbody><tr>
215
+ <td><code>--sc-font-family-base</code></td>
216
+ <td>Body UI text</td>
217
+ </tr>
218
+ <tr>
219
+ <td><code>--sc-font-weight-base</code>, <code>--sc-font-style-base</code></td>
220
+ <td>Optional</td>
221
+ </tr>
222
+ <tr>
223
+ <td><code>--sc-headings-font-family</code>, <code>--sc-headings-line-height</code>, <code>--sc-headings-font-weight</code>, <code>--sc-headings-text-transform</code></td>
224
+ <td>Headings (modal titles, etc.)</td>
225
+ </tr>
226
+ </tbody></table>
227
+ <h3 id="forms-only-if-you-customize-inputs-globally">Forms (only if you customize inputs globally)</h3>
228
+ <p>Interactive controls expose a few extra <strong>theme-level</strong> tokens; prefer these over styling individual inputs from outside.</p>
229
+ <table>
230
+ <thead>
231
+ <tr>
232
+ <th>Variable</th>
233
+ <th>Role</th>
234
+ </tr>
235
+ </thead>
236
+ <tbody><tr>
237
+ <td><code>--sc-border-width</code></td>
238
+ <td>Default border thickness</td>
239
+ </tr>
240
+ <tr>
241
+ <td><code>--sc-form-height</code></td>
242
+ <td>Control height</td>
243
+ </tr>
244
+ <tr>
245
+ <td><code>--sc-input-bg</code>, <code>--sc-input-color</code>, <code>--sc-input-border-color</code></td>
246
+ <td>Default field chrome</td>
247
+ </tr>
248
+ <tr>
249
+ <td><code>--sc-input-active-bg</code>, <code>--sc-input-active-color</code>, <code>--sc-input-active-border-color</code></td>
250
+ <td>Focus/active state</td>
251
+ </tr>
252
+ </tbody></table>
253
+ <hr>
254
+ <h2 id="tailwind-in-new-components-">Tailwind in new components ?</h2>
255
+ <p>Set <code>tailwind.config.js</code> to match concorde style token in your custom component.</p>
256
+ <pre><code class="language-js">...
257
+ theme: {
258
+ borderRadius: {
259
+ DEFAULT: &quot;var(--sc-rounded)&quot;,
260
+ none: &quot;0&quot;,
261
+ sm: &quot;var(--sc-rounded-sm)&quot;,
262
+ md: &quot;var(--sc-rounded-md)&quot;,
263
+ lg: &quot;var(--sc-rounded-lg)&quot;,
264
+ xl: &quot;var(--sc-rounded-xl)&quot;,
265
+ full: &quot;9999px&quot;,
266
+ },
267
+ boxShadow: {
268
+ DEFAULT: &quot;var(--sc-shadow)&quot;,
269
+ none: &quot;none&quot;,
270
+ sm: &quot;var(--sc-shadow-sm)&quot;,
271
+ md: &quot;var(--sc-shadow-md)&quot;,
272
+ lg: &quot;var(--sc-shadow-lg)&quot;,
273
+ xl: &quot;var(--sc-shadow-xl)&quot;,
274
+ },
275
+ colors: {
276
+ transparent: &quot;transparent&quot;,
277
+ current: &quot;currentColor&quot;,
278
+ content: &quot;var(--sc-base-content)&quot;,
279
+ base: &quot;var(--sc-base)&quot;,
280
+ neutral: {
281
+ 0: &quot;var(--sc-base)&quot;,
282
+ 50: &quot;var(--sc-base-50)&quot;,
283
+ 100: &quot;var(--sc-base-100)&quot;,
284
+ 200: &quot;var(--sc-base-200)&quot;,
285
+ 300: &quot;var(--sc-base-300)&quot;,
286
+ 400: &quot;var(--sc-base-400)&quot;,
287
+ 500: &quot;var(--sc-base-500)&quot;,
288
+ 600: &quot;var(--sc-base-600)&quot;,
289
+ 700: &quot;var(--sc-base-700)&quot;,
290
+ 800: &quot;var(--sc-base-800)&quot;,
291
+ 900: &quot;var(--sc-base-900)&quot;,
292
+ content: &quot;var(--sc-base)&quot;,
293
+ },
294
+ primary: {
295
+ DEFAULT: &quot;var(--sc-primary)&quot;,
296
+ content: &quot;var(--sc-primary-content)&quot;,
297
+ },
298
+ success: {
299
+ DEFAULT: &quot;var(--sc-success)&quot;,
300
+ content: &quot;var(--sc-success-content)&quot;,
301
+ },
302
+ danger: {
303
+ DEFAULT: &quot;var(--sc-danger)&quot;,
304
+ content: &quot;var(--sc-danger-content)&quot;,
305
+ },
306
+ warning: {
307
+ DEFAULT: &quot;var(--sc-warning)&quot;,
308
+ content: &quot;var(--sc-warning-content)&quot;,
309
+ },
310
+ info: {
311
+ DEFAULT: &quot;var(--sc-info)&quot;,
312
+ content: &quot;var(--sc-info-content)&quot;,
313
+ },
314
+ contrast: {
315
+ DEFAULT: &quot;var(--sc-contrast)&quot;,
316
+ content: &quot;var(--sc-contrast-content)&quot;,
317
+ },
318
+ },
319
+ extend: {
320
+ borderWidth: {
321
+ DEFAULT: &quot;var(--sc-border-width)&quot;,
322
+ },
323
+ fontFamily: {
324
+ headings: [&quot;var(--sc-headings-font-family, var(--sc-font-family-base, sans-serif))&quot;],
325
+ body: [&quot;var(--sc-font-family-base)&quot;],
326
+ monospace: [&quot;var(--sc-font-family-monospace, monospace)&quot;],
327
+ }
328
+ }
329
+ </code></pre>
330
+
331
+ </article>
332
+ </main>
333
+ </body>
334
+ </html>
package/docs/docs/index.html ADDED
@@ -0,0 +1,99 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-id="docs-index">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>Concorde documentation index — Supersoniks</title>
7
+ <meta name="description" content="Documentation index for Concorde by Supersoniks. Same pathnames as the interactive docs; static HTML for crawlers, Markdown via Accept: text/markdown.">
8
+ <meta name="keywords" content="Concorde, Supersoniks, documentation index, web components, Lit, DataProvider">
9
+ <link rel="canonical" href="https://concorde.supersoniks.org/docs/index.html">
10
+ </head>
11
+ <body>
12
+ <header>
13
+ <h1>Concorde documentation</h1>
14
+ <p>Canonical URLs match the interactive docs (<code>/docs/…</code>, <code>/core/…</code>). Crawlers receive static HTML; agents can request <code>Accept: text/markdown</code>.</p>
15
+ <p>Interactive site: <a href="https://concorde.supersoniks.org/">https://concorde.supersoniks.org/</a> · Full text: <a href="https://concorde.supersoniks.org/llms-full.txt">llms-full.txt</a></p>
16
+ <ul>
17
+ <li><a href="/hubs/decorators.html">Decorators hub (@get, @post, …)</a></li>
18
+ <li><a href="/hubs/remote-data.html">Remote data hub (@get, List, Queue)</a></li>
19
+ <li><a href="/hubs/form-components.html">Form components hub</a></li>
20
+ </ul>
21
+ </header>
22
+ <main>
23
+ <ul>
24
+ <li><a href="/core/components/functional/date">Date</a> <small>(core/components/functional/date/date)</small></li>
25
+ <li><a href="/core/components/functional/fetch">Fetch</a> <small>(core/components/functional/fetch/fetch)</small></li>
26
+ <li><a href="/core/components/functional/if">If</a> <small>(core/components/functional/if/if)</small></li>
27
+ <li><a href="/core/components/functional/jsonata">Jsonata</a> <small>(core/components/functional/jsonata/jsonata)</small></li>
28
+ <li><a href="/core/components/functional/list">List</a> <small>(core/components/functional/list/list)</small></li>
29
+ <li><a href="/core/components/functional/mix">Mix</a> <small>(core/components/functional/mix/mix)</small></li>
30
+ <li><a href="/core/components/functional/queue">Queue</a> <small>(core/components/functional/queue/queue)</small></li>
31
+ <li><a href="/core/components/functional/router">Router</a> <small>(core/components/functional/router/router)</small></li>
32
+ <li><a href="/core/components/functional/sdui/sdui-extension-points">SDUI — points d’extension publics</a> <small>(core/components/functional/sdui/sdui-extension-points)</small></li>
33
+ <li><a href="/core/components/functional/sdui">SDUI</a> <small>(core/components/functional/sdui/sdui)</small></li>
34
+ <li><a href="/core/components/functional/states">States</a> <small>(core/components/functional/states/states)</small></li>
35
+ <li><a href="/core/components/functional/submit">Submit</a> <small>(core/components/functional/submit/submit)</small></li>
36
+ <li><a href="/core/components/functional/subscriber">Subscriber</a> <small>(core/components/functional/subscriber/subscriber)</small></li>
37
+ <li><a href="/core/components/functional/translation">Translation</a> <small>(core/components/functional/translation/translation)</small></li>
38
+ <li><a href="/core/components/functional/value">Value</a> <small>(core/components/functional/value/value)</small></li>
39
+ <li><a href="/core/components/ui/alert-messages">Alert messages</a> <small>(core/components/ui/alert-messages/alert-messages)</small></li>
40
+ <li><a href="/core/components/ui/alert">Alert</a> <small>(core/components/ui/alert/alert)</small></li>
41
+ <li><a href="/core/components/ui/badge">Badge</a> <small>(core/components/ui/badge/badge)</small></li>
42
+ <li><a href="/core/components/ui/button">Button</a> <small>(core/components/ui/button/button)</small></li>
43
+ <li><a href="/core/components/ui/captcha">Captcha</a> <small>(core/components/ui/captcha/captcha)</small></li>
44
+ <li><a href="/core/components/ui/card">Card</a> <small>(core/components/ui/card/card)</small></li>
45
+ <li><a href="/core/components/ui/divider">Divider</a> <small>(core/components/ui/divider/divider)</small></li>
46
+ <li><a href="/core/components/ui/form/checkbox">Checkbox</a> <small>(core/components/ui/form/checkbox/checkbox)</small></li>
47
+ <li><a href="/core/components/ui/form/fieldset">Fieldset</a> <small>(core/components/ui/form/fieldset/fieldset)</small></li>
48
+ <li><a href="/core/components/ui/form/form-actions">Form actions</a> <small>(core/components/ui/form/form-actions/form-actions)</small></li>
49
+ <li><a href="/core/components/ui/form/form-layout">Form layout</a> <small>(core/components/ui/form/form-layout/form-layout)</small></li>
50
+ <li><a href="/core/components/ui/form/input">Input</a> <small>(core/components/ui/form/input/input)</small></li>
51
+ <li><a href="/core/components/ui/form/radio">Radio</a> <small>(core/components/ui/form/radio/radio)</small></li>
52
+ <li><a href="/core/components/ui/form/select">Select</a> <small>(core/components/ui/form/select/select)</small></li>
53
+ <li><a href="/core/components/ui/form/switch">Switch</a> <small>(core/components/ui/form/switch/switch)</small></li>
54
+ <li><a href="/core/components/ui/form/textarea">Textarea</a> <small>(core/components/ui/form/textarea/textarea)</small></li>
55
+ <li><a href="/core/components/ui/group">Group</a> <small>(core/components/ui/group/group)</small></li>
56
+ <li><a href="/core/components/ui/icon">Icon</a> <small>(core/components/ui/icon/icon)</small></li>
57
+ <li><a href="/core/components/ui/image">Image</a> <small>(core/components/ui/image/image)</small></li>
58
+ <li><a href="/core/components/ui/link">Link</a> <small>(core/components/ui/link/link)</small></li>
59
+ <li><a href="/core/components/ui/loader">Loader</a> <small>(core/components/ui/loader/loader)</small></li>
60
+ <li><a href="/core/components/ui/menu">Menu</a> <small>(core/components/ui/menu/menu)</small></li>
61
+ <li><a href="/core/components/ui/modal">Modal</a> <small>(core/components/ui/modal/modal)</small></li>
62
+ <li><a href="/core/components/ui/pop">Pop</a> <small>(core/components/ui/pop/pop)</small></li>
63
+ <li><a href="/core/components/ui/progress">Progress</a> <small>(core/components/ui/progress/progress)</small></li>
64
+ <li><a href="/core/components/ui/table">Table</a> <small>(core/components/ui/table/table)</small></li>
65
+ <li><a href="/core/components/ui/theme">Theme</a> <small>(core/components/ui/theme/theme)</small></li>
66
+ <li><a href="/core/components/ui/toast">Toast</a> <small>(core/components/ui/toast/toast)</small></li>
67
+ <li><a href="/core/components/ui/tooltip">Tooltip</a> <small>(core/components/ui/tooltip/tooltip)</small></li>
68
+ <li><a href="/docs/decorators/ancestor-attribute">@ancestorAttribute</a> <small>(docs/decorators/ancestor-attribute)</small></li>
69
+ <li><a href="/docs/decorators/auto-subscribe">@autoSubscribe</a> <small>(docs/decorators/auto-subscribe)</small></li>
70
+ <li><a href="/docs/decorators/bind">@bind</a> <small>(docs/decorators/bind)</small></li>
71
+ <li><a href="/docs/decorators/get">@get</a> <small>(docs/decorators/get)</small></li>
72
+ <li><a href="/docs/decorators/handle">@handle</a> <small>(docs/decorators/handle)</small></li>
73
+ <li><a href="/docs/decorators/on-assign">@onAssign</a> <small>(docs/decorators/on-assign)</small></li>
74
+ <li><a href="/docs/decorators/patch">@patch</a> <small>(docs/decorators/patch)</small></li>
75
+ <li><a href="/docs/decorators/post">@post</a> <small>(docs/decorators/post)</small></li>
76
+ <li><a href="/docs/decorators/publish">@publish</a> <small>(docs/decorators/publish)</small></li>
77
+ <li><a href="/docs/decorators/put">@put</a> <small>(docs/decorators/put)</small></li>
78
+ <li><a href="/docs/decorators/subscribe">@subscribe</a> <small>(docs/decorators/subscribe)</small></li>
79
+ <li><a href="/docs/decorators/wait-for-ancestors">@awaitConnectedAncestors</a> <small>(docs/decorators/wait-for-ancestors)</small></li>
80
+ <li><a href="/docs/directives/sub">sub()</a> <small>(docs/directives/sub)</small></li>
81
+ <li><a href="/docs/directives/t">t()</a> <small>(docs/directives/t)</small></li>
82
+ <li><a href="/docs/getting-started/ai-agents">AI agents (skill)</a> <small>(docs/getting-started/ai-agents)</small></li>
83
+ <li><a href="/docs/getting-started/components">Components</a> <small>(docs/getting-started/components)</small></li>
84
+ <li><a href="/docs/getting-started/create-a-component">Creating components</a> <small>(docs/getting-started/create-a-component)</small></li>
85
+ <li><a href="/docs/getting-started/dataFlow">Data flow</a> <small>(docs/getting-started/dataFlow)</small></li>
86
+ <li><a href="/docs/getting-started/installation">Installation</a> <small>(docs/getting-started/installation)</small></li>
87
+ <li><a href="/docs/getting-started/my-first-component">My first component</a> <small>(docs/getting-started/my-first-component)</small></li>
88
+ <li><a href="/docs/getting-started/start">Introduction</a> <small>(docs/getting-started/start)</small></li>
89
+ <li><a href="/docs/getting-started/theming">Theming</a> <small>(docs/getting-started/theming)</small></li>
90
+ <li><a href="/docs/misc/api-configuration">API configuration</a> <small>(docs/misc/api-configuration)</small></li>
91
+ <li><a href="/docs/misc/dataProviderKey">DataProviderKey</a> <small>(docs/misc/dataProviderKey)</small></li>
92
+ <li><a href="/docs/misc/docs-mock-api">Local API demos (offline)</a> <small>(docs/misc/docs-mock-api)</small></li>
93
+ <li><a href="/docs/misc/dynamic-path">Dynamic path placeholders</a> <small>(docs/misc/dynamic-path)</small></li>
94
+ <li><a href="/docs/misc/endpoint">Endpoint</a> <small>(docs/misc/endpoint)</small></li>
95
+ <li><a href="/docs/misc/html-integration">HTML integration (no Lit)</a> <small>(docs/misc/html-integration)</small></li>
96
+ </ul>
97
+ </main>
98
+ </body>
99
+ </html>
package/docs/docs/misc/api-configuration.html ADDED
@@ -0,0 +1,149 @@
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">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>API configuration — Concorde by Supersoniks</title>
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">
12
+ </head>
13
+ <body>
14
+ <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>
16
+ </header>
17
+ <main>
18
+ <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>
20
+ <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>
22
+ <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>
24
+ </blockquote>
25
+ <h2 id="attribute-map">Attribute map</h2>
26
+ <table>
27
+ <thead>
28
+ <tr>
29
+ <th>Attribute (ancestor)</th>
30
+ <th><code>APIConfiguration</code> field</th>
31
+ <th>Role</th>
32
+ </tr>
33
+ </thead>
34
+ <tbody><tr>
35
+ <td><code>serviceURL</code></td>
36
+ <td><code>serviceURL</code></td>
37
+ <td>Base URL (e.g. <code>/docs-mock-api</code>)</td>
38
+ </tr>
39
+ <tr>
40
+ <td><code>token</code></td>
41
+ <td><code>token</code></td>
42
+ <td>Static Bearer sent on REST calls</td>
43
+ </tr>
44
+ <tr>
45
+ <td><code>userName</code> / <code>password</code></td>
46
+ <td><code>userName</code> / <code>password</code></td>
47
+ <td>Basic auth for <strong>tokenProvider</strong> fetch only</td>
48
+ </tr>
49
+ <tr>
50
+ <td><code>eventsApiToken</code></td>
51
+ <td><code>authToken</code></td>
52
+ <td>Bearer for <strong>tokenProvider</strong> when no Basic</td>
53
+ </tr>
54
+ <tr>
55
+ <td><code>tokenProvider</code></td>
56
+ <td><code>tokenProvider</code></td>
57
+ <td>Path to GET a new token (<code>{ token }</code> JSON)</td>
58
+ </tr>
59
+ <tr>
60
+ <td><code>wordingProvider</code></td>
61
+ <td>— (read by <code>wording()</code>)</td>
62
+ <td>Base path + query for label batch GET</td>
63
+ </tr>
64
+ <tr>
65
+ <td><code>wordingVersionProvider</code></td>
66
+ <td>—</td>
67
+ <td>Publisher id; bump version → reload wordings</td>
68
+ </tr>
69
+ <tr>
70
+ <td><code>credentials</code></td>
71
+ <td><code>credentials</code></td>
72
+ <td><code>fetch</code> credentials mode</td>
73
+ </tr>
74
+ <tr>
75
+ <td><code>addHTTPResponse</code></td>
76
+ <td><code>addHTTPResponse</code></td>
77
+ <td>Attach <code>_sonic_http_response_</code> on result</td>
78
+ </tr>
79
+ <tr>
80
+ <td><code>cache</code></td>
81
+ <td><code>cache</code></td>
82
+ <td><code>fetch</code> cache mode</td>
83
+ </tr>
84
+ <tr>
85
+ <td><code>blockUntilDone</code></td>
86
+ <td><code>blockUntilDone</code></td>
87
+ <td>Serialize calls per <code>serviceURL</code></td>
88
+ </tr>
89
+ <tr>
90
+ <td><code>keepAlive</code></td>
91
+ <td><code>keepAlive</code></td>
92
+ <td><code>fetch</code> keepalive</td>
93
+ </tr>
94
+ </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>
96
+ <h2 id="bearer-token-static">Bearer token (static)</h2>
97
+ <p>Publisher <code>docsApiConfBearerKey</code> (<code>set(docsApiConfBearerKey, { token: &quot;docs-mock-valid-token&quot;, … })</code>) — mock returns the protected payload.</p>
98
+ <p><docs-lit-demo for="docs-api-config-bearer-demo"></docs-lit-demo></p>
99
+ <h2 id="tokenprovider--basic-auth">tokenProvider + Basic auth</h2>
100
+ <p>No static <code>token</code>: <code>API.auth()</code> calls <code>GET /docs-mock-api/auth/token</code> with Basic <strong>demo</strong> / <strong>secret</strong>, stores <code>token</code>, then calls the protected route.</p>
101
+ <p><docs-lit-demo for="docs-api-config-token-provider-demo"></docs-lit-demo></p>
102
+ <h2 id="http-498--stale-token-refresh">HTTP 498 — stale token refresh</h2>
103
+ <p>Initial <code>token=&quot;docs-mock-stale-token&quot;</code> → mock responds <strong>498</strong> → Concorde invalidates the token, runs <code>auth()</code> again (same <code>tokenProvider</code> + Basic), retries with <code>docs-mock-fresh-token</code>.</p>
104
+ <p><docs-lit-demo for="docs-api-config-stale-token-demo"></docs-lit-demo></p>
105
+ <h2 id="eventsapitoken">eventsApiToken</h2>
106
+ <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
+ <p><docs-lit-demo for="docs-api-config-events-token-demo"></docs-lit-demo></p>
108
+ <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>
110
+ <h2 id="scoped-attributes-html--sonic-scope">Scoped attributes (HTML / sonic-scope)</h2>
111
+ <p>Attributes on <strong><code>sonic-scope</code></strong> (or any ancestor) are visible to descendants via <code>getAncestorAttributeValue</code>.</p>
112
+ <p><docs-lit-demo for="docs-api-config-scoped-attrs-demo"></docs-lit-demo></p>
113
+ <h2 id="api-config-routes">API config routes</h2>
114
+ <table>
115
+ <thead>
116
+ <tr>
117
+ <th>Route</th>
118
+ <th>Demo</th>
119
+ </tr>
120
+ </thead>
121
+ <tbody><tr>
122
+ <td><code>GET /docs-mock-api/auth/token</code></td>
123
+ <td>tokenProvider, eventsApiToken</td>
124
+ </tr>
125
+ <tr>
126
+ <td><code>GET /docs-mock-api/api/config/protected</code></td>
127
+ <td>Bearer / Basic / 498</td>
128
+ </tr>
129
+ <tr>
130
+ <td><code>GET /docs-mock-api/wording/labels?labels[]=…&amp;lang=fr</code></td>
131
+ <td><code>wording()</code></td>
132
+ </tr>
133
+ </tbody></table>
134
+ <p>Mock tokens (doc only): <code>docs-mock-valid-token</code>, <code>docs-mock-stale-token</code> (498), <code>docs-mock-fresh-token</code> (after refresh). Basic: <strong>demo</strong> / <strong>secret</strong>. Events token: <code>docs-mock-events-token</code>.</p>
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
+ <h2 id="see-also">See also</h2>
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>
144
+ </ul>
145
+
146
+ </article>
147
+ </main>
148
+ </body>
149
+ </html>