@supersoniks/concorde 5.1.0 → 5.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (628) 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/.claude/launch.json +15 -0
  6. package/.claude/vite.http.config.mjs +7 -0
  7. package/.taste-skill/after/desktop-fold.jpg +0 -0
  8. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  9. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  10. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  11. package/.taste-skill/after/mobile-fold.jpg +0 -0
  12. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  13. package/.taste-skill/after/report.json +4103 -0
  14. package/.taste-skill/after/tablet-fold.jpg +0 -0
  15. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  16. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  17. package/.taste-skill/before/desktop-fold.jpg +0 -0
  18. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  19. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  20. package/.taste-skill/before/mobile-fold.jpg +0 -0
  21. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  22. package/.taste-skill/before/report.json +2556 -0
  23. package/.taste-skill/before/tablet-fold.jpg +0 -0
  24. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  25. package/.taste-skill/direction.json +510 -0
  26. package/.taste-skill/notes.md +84 -0
  27. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  28. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  29. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  30. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  31. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  32. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  33. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  34. package/.taste-skill/prod/report.json +1973 -0
  35. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  36. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  37. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  38. package/.tmp-cem/custom-elements.json +2013 -2013
  39. package/AUDIT.md +228 -0
  40. package/PLAN-AMELIORATION.md +220 -0
  41. package/PLAN-DOCS-AGENTS.md +80 -0
  42. package/README.md +3 -3
  43. package/ai/skills/concorde/SKILL.md +1 -1
  44. package/ai/skills/concorde-get-set-dp/SKILL.md +3 -3
  45. package/ai/skills/concorde-theme/SKILL.md +1 -1
  46. package/build-infos.json +1 -1
  47. package/concorde-core.bundle.js +16 -16
  48. package/concorde-core.es.js +235 -233
  49. package/dist/concorde-core.bundle.js +16 -16
  50. package/dist/concorde-core.es.js +235 -233
  51. package/dist/img/archive/concorde-001-2cv.webp +0 -0
  52. package/dist/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  53. package/dist/img/archive/concorde-red-arrows-2002.webm +0 -0
  54. package/dist/img/archive/credits.json +28 -0
  55. package/docs/.htaccess +75 -0
  56. package/docs/404.html +15 -0
  57. package/docs/404.md +5 -0
  58. package/docs/assets/index-BgG6FFPt.js +11765 -0
  59. package/docs/assets/index-x89XINSG.css +1 -0
  60. package/docs/core/components/functional/date/date.html +211 -0
  61. package/docs/core/components/functional/date/date.md +150 -0
  62. package/docs/core/components/functional/fetch/fetch.html +180 -0
  63. package/docs/core/components/functional/fetch/fetch.md +108 -0
  64. package/docs/core/components/functional/if/if.html +65 -0
  65. package/docs/core/components/functional/if/if.md +34 -0
  66. package/docs/core/components/functional/jsonata/jsonata.html +110 -0
  67. package/docs/core/components/functional/jsonata/jsonata.md +61 -0
  68. package/docs/core/components/functional/list/list.html +198 -0
  69. package/docs/core/components/functional/list/list.md +121 -0
  70. package/docs/core/components/functional/mix/mix.html +78 -0
  71. package/docs/core/components/functional/mix/mix.md +46 -0
  72. package/docs/core/components/functional/queue/queue.html +155 -0
  73. package/docs/core/components/functional/queue/queue.md +51 -0
  74. package/docs/core/components/functional/router/router.html +154 -0
  75. package/docs/core/components/functional/router/router.md +93 -0
  76. package/docs/core/components/functional/sdui/sdui-extension-points.html +127 -0
  77. package/docs/core/components/functional/sdui/sdui-extension-points.md +94 -0
  78. package/docs/core/components/functional/sdui/sdui.html +397 -0
  79. package/docs/core/components/functional/sdui/sdui.md +307 -0
  80. package/docs/core/components/functional/states/states.html +141 -0
  81. package/docs/core/components/functional/states/states.md +112 -0
  82. package/docs/core/components/functional/submit/submit.html +178 -0
  83. package/docs/core/components/functional/submit/submit.md +106 -0
  84. package/docs/{crawl/core → core}/components/functional/subscriber/subscriber.html +6 -5
  85. package/docs/core/components/functional/subscriber/subscriber.md +91 -0
  86. package/docs/core/components/functional/translation/translation.html +60 -0
  87. package/docs/core/components/functional/translation/translation.md +38 -0
  88. package/docs/core/components/functional/value/value.html +81 -0
  89. package/docs/core/components/functional/value/value.md +47 -0
  90. package/docs/core/components/ui/alert/alert.html +201 -0
  91. package/docs/core/components/ui/alert/alert.md +186 -0
  92. package/docs/core/components/ui/alert-messages/alert-messages.html +132 -0
  93. package/docs/core/components/ui/alert-messages/alert-messages.md +85 -0
  94. package/docs/core/components/ui/badge/badge.html +197 -0
  95. package/docs/core/components/ui/badge/badge.md +181 -0
  96. package/docs/core/components/ui/button/button.html +309 -0
  97. package/docs/core/components/ui/button/button.md +216 -0
  98. package/docs/core/components/ui/captcha/captcha.html +80 -0
  99. package/docs/core/components/ui/captcha/captcha.md +56 -0
  100. package/docs/core/components/ui/card/card.html +254 -0
  101. package/docs/core/components/ui/card/card.md +215 -0
  102. package/docs/core/components/ui/divider/divider.html +144 -0
  103. package/docs/core/components/ui/divider/divider.md +126 -0
  104. package/docs/core/components/ui/form/checkbox/checkbox.html +200 -0
  105. package/docs/core/components/ui/form/checkbox/checkbox.md +125 -0
  106. package/docs/core/components/ui/form/fieldset/fieldset.html +238 -0
  107. package/docs/core/components/ui/form/fieldset/fieldset.md +161 -0
  108. package/docs/core/components/ui/form/form-actions/form-actions.html +122 -0
  109. package/docs/core/components/ui/form/form-actions/form-actions.md +98 -0
  110. package/docs/core/components/ui/form/form-layout/form-layout.html +115 -0
  111. package/docs/core/components/ui/form/form-layout/form-layout.md +109 -0
  112. package/docs/core/components/ui/form/input/input.html +235 -0
  113. package/docs/core/components/ui/form/input/input.md +142 -0
  114. package/docs/core/components/ui/form/radio/radio.html +144 -0
  115. package/docs/core/components/ui/form/radio/radio.md +78 -0
  116. package/docs/core/components/ui/form/select/select.html +178 -0
  117. package/docs/core/components/ui/form/select/select.md +86 -0
  118. package/docs/core/components/ui/form/switch/switch.html +146 -0
  119. package/docs/core/components/ui/form/switch/switch.md +80 -0
  120. package/docs/core/components/ui/form/textarea/textarea.html +162 -0
  121. package/docs/core/components/ui/form/textarea/textarea.md +82 -0
  122. package/docs/core/components/ui/group/group.html +113 -0
  123. package/docs/core/components/ui/group/group.md +77 -0
  124. package/docs/core/components/ui/icon/icon.html +223 -0
  125. package/docs/core/components/ui/icon/icon.md +214 -0
  126. package/docs/core/components/ui/image/image.html +194 -0
  127. package/docs/core/components/ui/image/image.md +167 -0
  128. package/docs/core/components/ui/link/link.html +101 -0
  129. package/docs/core/components/ui/link/link.md +81 -0
  130. package/docs/core/components/ui/loader/loader.html +114 -0
  131. package/docs/core/components/ui/loader/loader.md +87 -0
  132. package/docs/{crawl/core → core}/components/ui/menu/menu.html +189 -116
  133. package/docs/core/components/ui/menu/menu.md +370 -0
  134. package/docs/core/components/ui/modal/modal.html +324 -0
  135. package/docs/core/components/ui/modal/modal.md +211 -0
  136. package/docs/core/components/ui/pop/pop.html +250 -0
  137. package/docs/core/components/ui/pop/pop.md +216 -0
  138. package/docs/core/components/ui/progress/progress.html +132 -0
  139. package/docs/core/components/ui/progress/progress.md +109 -0
  140. package/docs/core/components/ui/table/table.html +333 -0
  141. package/docs/core/components/ui/table/table.md +267 -0
  142. package/docs/core/components/ui/theme/theme.html +116 -0
  143. package/docs/core/components/ui/theme/theme.md +97 -0
  144. package/docs/core/components/ui/toast/toast.html +185 -0
  145. package/docs/core/components/ui/toast/toast.md +147 -0
  146. package/docs/core/components/ui/tooltip/tooltip.html +112 -0
  147. package/docs/core/components/ui/tooltip/tooltip.md +89 -0
  148. package/docs/docs/decorators/ancestor-attribute.html +71 -0
  149. package/docs/docs/decorators/ancestor-attribute.md +59 -0
  150. package/docs/docs/decorators/auto-subscribe.html +61 -0
  151. package/docs/docs/decorators/auto-subscribe.md +40 -0
  152. package/docs/docs/decorators/bind.html +86 -0
  153. package/docs/docs/decorators/bind.md +77 -0
  154. package/docs/docs/decorators/get.html +166 -0
  155. package/docs/docs/decorators/get.md +160 -0
  156. package/docs/docs/decorators/handle.html +139 -0
  157. package/docs/docs/decorators/handle.md +119 -0
  158. package/docs/docs/decorators/on-assign.html +72 -0
  159. package/docs/docs/decorators/on-assign.md +63 -0
  160. package/docs/docs/decorators/patch.html +76 -0
  161. package/docs/docs/decorators/patch.md +44 -0
  162. package/docs/docs/decorators/post.html +150 -0
  163. package/docs/docs/decorators/post.md +134 -0
  164. package/docs/docs/decorators/publish.html +74 -0
  165. package/docs/docs/decorators/publish.md +56 -0
  166. package/docs/docs/decorators/put.html +83 -0
  167. package/docs/docs/decorators/put.md +51 -0
  168. package/docs/docs/decorators/subscribe.html +91 -0
  169. package/docs/docs/decorators/subscribe.md +87 -0
  170. package/docs/docs/decorators/wait-for-ancestors.html +82 -0
  171. package/docs/docs/decorators/wait-for-ancestors.md +76 -0
  172. package/docs/docs/directives/sub.html +79 -0
  173. package/docs/docs/directives/sub.md +75 -0
  174. package/docs/docs/directives/t.html +91 -0
  175. package/docs/docs/directives/t.md +73 -0
  176. package/docs/{crawl/docs/_getting-started → docs/getting-started}/ai-agents.html +12 -11
  177. package/{src/docs/_getting-started → docs/docs/getting-started}/ai-agents.md +3 -3
  178. package/docs/docs/getting-started/components.html +27 -0
  179. package/docs/docs/getting-started/components.md +5 -0
  180. package/docs/{crawl/docs/_getting-started → docs/getting-started}/create-a-component.html +11 -14
  181. package/docs/{src/docs/_getting-started → docs/getting-started}/create-a-component.md +3 -6
  182. package/docs/{crawl/docs/_core-concept → docs/getting-started}/dataFlow.html +26 -29
  183. package/docs/{src/docs/_core-concept → docs/getting-started}/dataFlow.md +17 -18
  184. package/docs/docs/getting-started/installation.html +69 -0
  185. package/docs/docs/getting-started/installation.md +36 -0
  186. package/docs/{crawl/docs/_getting-started → docs/getting-started}/my-first-component.html +13 -22
  187. package/docs/{src/docs/_getting-started → docs/getting-started}/my-first-component.md +5 -14
  188. package/docs/docs/getting-started/start.html +47 -0
  189. package/{src/docs/_getting-started → docs/docs/getting-started}/start.md +1 -13
  190. package/docs/docs/getting-started/theming.html +334 -0
  191. package/{src/docs/_getting-started → docs/docs/getting-started}/theming.md +2 -2
  192. package/docs/docs/index.html +99 -0
  193. package/docs/{crawl/docs/_misc → docs/misc}/api-configuration.html +18 -18
  194. package/docs/{src/docs/_misc → docs/misc}/api-configuration.md +10 -12
  195. package/docs/{crawl/docs/_misc → docs/misc}/dataProviderKey.html +12 -11
  196. package/{src/docs/_misc → docs/docs/misc}/dataProviderKey.md +4 -4
  197. package/docs/{crawl/docs/_misc → docs/misc}/docs-mock-api.html +25 -28
  198. package/docs/{src/docs/_misc → docs/misc}/docs-mock-api.md +12 -13
  199. package/docs/{crawl/docs/_misc → docs/misc}/dynamic-path.html +16 -15
  200. package/{src/docs/_misc → docs/docs/misc}/dynamic-path.md +8 -8
  201. package/docs/{crawl/docs/_misc → docs/misc}/endpoint.html +16 -15
  202. package/{src/docs/_misc → docs/docs/misc}/endpoint.md +8 -8
  203. package/docs/{crawl/docs/_misc → docs/misc}/html-integration.html +12 -15
  204. package/docs/{src/docs/_misc → docs/misc}/html-integration.md +4 -5
  205. package/docs/docs-mock-api-sw.js +60 -223
  206. package/docs/docs-mock-api-sw.js.map +4 -4
  207. package/docs/hubs/decorators.html +443 -0
  208. package/docs/hubs/form-components.html +404 -0
  209. package/docs/hubs/remote-data.html +371 -0
  210. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  211. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  212. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  213. package/docs/img/archive/credits.json +28 -0
  214. package/docs/img/concorde/plane_01.jpg +0 -0
  215. package/docs/img/concorde/plane_02.jpg +0 -0
  216. package/docs/img/concorde/plane_03.jpg +0 -0
  217. package/docs/img/concorde/plane_04.jpg +0 -0
  218. package/docs/img/concorde/plane_05.jpg +0 -0
  219. package/docs/img/concorde/plane_06.jpg +0 -0
  220. package/docs/img/concorde/plane_07.jpg +0 -0
  221. package/docs/img/concorde/plane_08.jpg +0 -0
  222. package/docs/img/concorde/plane_09.jpg +0 -0
  223. package/docs/img/concorde/plane_10.jpg +0 -0
  224. package/docs/img/concorde/plane_11.jpg +0 -0
  225. package/docs/img/concorde/plane_12.jpg +0 -0
  226. package/docs/img/concorde/plane_13.jpg +0 -0
  227. package/docs/index.html +96 -67
  228. package/docs/index.md +22 -0
  229. package/docs/llms-full.txt +3329 -3295
  230. package/docs/llms.txt +94 -92
  231. package/docs/robots.txt +11 -10
  232. package/docs/sitemap.xml +78 -78
  233. package/docs/src/core/components/functional/date/date.md +91 -231
  234. package/docs/src/core/components/functional/fetch/fetch.md +66 -83
  235. package/docs/src/core/components/functional/if/if.md +28 -3
  236. package/docs/src/core/components/functional/jsonata/jsonata.md +42 -37
  237. package/docs/src/core/components/functional/list/list.md +99 -43
  238. package/docs/src/core/components/functional/mix/mix.md +31 -26
  239. package/docs/src/core/components/functional/queue/queue.md +40 -61
  240. package/docs/src/core/components/functional/router/router.md +64 -65
  241. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
  242. package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
  243. package/docs/src/core/components/functional/sdui/example.json +19 -86
  244. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
  245. package/docs/src/core/components/functional/sdui/sdui.md +196 -245
  246. package/docs/src/core/components/functional/states/states.md +86 -61
  247. package/docs/src/core/components/functional/submit/submit.md +64 -72
  248. package/docs/src/core/components/functional/translation/translation.md +38 -0
  249. package/docs/src/core/components/functional/value/value.md +34 -22
  250. package/docs/src/core/components/ui/alert/alert.md +139 -74
  251. package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
  252. package/docs/src/core/components/ui/badge/badge.md +137 -83
  253. package/docs/src/core/components/ui/button/button.md +139 -105
  254. package/docs/src/core/components/ui/captcha/captcha.md +50 -6
  255. package/docs/src/core/components/ui/card/card.md +183 -65
  256. package/docs/src/core/components/ui/divider/divider.md +104 -13
  257. package/docs/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  258. package/docs/src/core/components/ui/form/fieldset/fieldset.md +135 -103
  259. package/docs/src/core/components/ui/form/form-actions/form-actions.md +71 -50
  260. package/docs/src/core/components/ui/form/form-layout/form-layout.md +99 -34
  261. package/docs/src/core/components/ui/form/input/input.md +95 -95
  262. package/docs/src/core/components/ui/form/radio/radio.md +55 -34
  263. package/docs/src/core/components/ui/form/select/select.md +60 -45
  264. package/docs/src/core/components/ui/form/switch/switch.md +57 -34
  265. package/docs/src/core/components/ui/form/textarea/textarea.md +55 -38
  266. package/docs/src/core/components/ui/group/group.md +49 -47
  267. package/docs/src/core/components/ui/icon/icon.md +132 -43
  268. package/docs/src/core/components/ui/image/image.md +132 -72
  269. package/docs/src/core/components/ui/link/link.md +46 -8
  270. package/docs/src/core/components/ui/loader/loader.md +55 -23
  271. package/docs/src/core/components/ui/menu/menu.md +155 -114
  272. package/docs/src/core/components/ui/modal/modal.md +154 -62
  273. package/docs/src/core/components/ui/pop/pop.md +185 -65
  274. package/docs/src/core/components/ui/progress/progress.md +76 -30
  275. package/docs/src/core/components/ui/table/table.md +146 -334
  276. package/docs/src/core/components/ui/theme/theme.md +97 -0
  277. package/docs/src/core/components/ui/toast/toast.md +80 -99
  278. package/docs/src/core/components/ui/tooltip/tooltip.md +52 -45
  279. package/docs/src/docs/decorators/ancestor-attribute.md +59 -0
  280. package/docs/src/docs/decorators/auto-subscribe.md +40 -0
  281. package/docs/src/docs/decorators/bind.md +77 -0
  282. package/docs/src/docs/decorators/get.md +160 -0
  283. package/docs/src/docs/decorators/handle.md +119 -0
  284. package/docs/src/docs/decorators/on-assign.md +63 -0
  285. package/docs/src/docs/decorators/patch.md +44 -0
  286. package/docs/src/docs/decorators/post.md +134 -0
  287. package/docs/src/docs/decorators/publish.md +56 -0
  288. package/docs/src/docs/decorators/put.md +51 -0
  289. package/docs/src/docs/decorators/subscribe.md +87 -0
  290. package/docs/src/docs/decorators/wait-for-ancestors.md +76 -0
  291. package/docs/src/docs/directives/sub.md +75 -0
  292. package/docs/src/docs/directives/t.md +73 -0
  293. package/docs/src/docs/{_getting-started → getting-started}/ai-agents.md +3 -3
  294. package/docs/src/docs/getting-started/components.md +5 -0
  295. package/{src/docs/_getting-started → docs/src/docs/getting-started}/create-a-component.md +3 -6
  296. package/{src/docs/_core-concept → docs/src/docs/getting-started}/dataFlow.md +17 -18
  297. package/docs/src/docs/getting-started/installation.md +36 -0
  298. package/{src/docs/_getting-started → docs/src/docs/getting-started}/my-first-component.md +5 -14
  299. package/docs/src/docs/getting-started/start.md +35 -0
  300. package/docs/src/docs/getting-started/theming.md +253 -0
  301. package/{src/docs/_misc → docs/src/docs/misc}/api-configuration.md +10 -12
  302. package/docs/src/docs/{_misc → misc}/dataProviderKey.md +4 -4
  303. package/{src/docs/_misc → docs/src/docs/misc}/docs-mock-api.md +12 -13
  304. package/docs/src/docs/{_misc → misc}/dynamic-path.md +8 -8
  305. package/docs/src/docs/{_misc → misc}/endpoint.md +8 -8
  306. package/{src/docs/_misc → docs/src/docs/misc}/html-integration.md +4 -5
  307. package/docs/src/docs/search/docs-search.json +3729 -2949
  308. package/docs/src/tsconfig.json +176 -5
  309. package/index.html +94 -67
  310. package/package.json +11 -4
  311. package/public/docs-mock-api-sw.js +58 -223
  312. package/public/docs-mock-api-sw.js.map +4 -4
  313. package/public/img/archive/concorde-001-2cv.webp +0 -0
  314. package/public/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  315. package/public/img/archive/concorde-red-arrows-2002.webm +0 -0
  316. package/public/img/archive/credits.json +28 -0
  317. package/public/img/concorde/plane_01.jpg +0 -0
  318. package/public/img/concorde/plane_02.jpg +0 -0
  319. package/public/img/concorde/plane_03.jpg +0 -0
  320. package/public/img/concorde/plane_04.jpg +0 -0
  321. package/public/img/concorde/plane_05.jpg +0 -0
  322. package/public/img/concorde/plane_06.jpg +0 -0
  323. package/public/img/concorde/plane_07.jpg +0 -0
  324. package/public/img/concorde/plane_08.jpg +0 -0
  325. package/public/img/concorde/plane_09.jpg +0 -0
  326. package/public/img/concorde/plane_10.jpg +0 -0
  327. package/public/img/concorde/plane_11.jpg +0 -0
  328. package/public/img/concorde/plane_12.jpg +0 -0
  329. package/public/img/concorde/plane_13.jpg +0 -0
  330. package/public/robots.txt +11 -10
  331. package/scripts/docs-markdown-vite-plugin.ts +37 -0
  332. package/scripts/docs-public-url.mjs +50 -0
  333. package/scripts/docs.htaccess +75 -0
  334. package/scripts/generate-crawl-docs.mjs +207 -116
  335. package/scripts/generate-crawl-docs.test.mjs +124 -0
  336. package/scripts/post-build-docs.js +34 -50
  337. package/scripts/post-build.mjs +0 -0
  338. package/src/core/components/functional/date/date.md +91 -231
  339. package/src/core/components/functional/fetch/fetch.md +66 -83
  340. package/src/core/components/functional/if/if.md +28 -3
  341. package/src/core/components/functional/if/if.ts +0 -0
  342. package/src/core/components/functional/jsonata/jsonata.md +42 -37
  343. package/src/core/components/functional/list/list.demo.ts +0 -0
  344. package/src/core/components/functional/list/list.md +99 -43
  345. package/src/core/components/functional/mix/mix.md +31 -26
  346. package/src/core/components/functional/queue/queue.demo.ts +10 -7
  347. package/src/core/components/functional/queue/queue.md +40 -61
  348. package/src/core/components/functional/router/router.demo.ts +16 -16
  349. package/src/core/components/functional/router/router.md +64 -65
  350. package/src/core/components/functional/router/router.ts +0 -0
  351. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  352. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  353. package/src/core/components/functional/sdui/component-catalog.json +1 -1
  354. package/src/core/components/functional/sdui/example.json +19 -86
  355. package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  356. package/src/core/components/functional/sdui/sdui.md +187 -358
  357. package/src/core/components/functional/sdui/types.ts +0 -0
  358. package/src/core/components/functional/states/states.demo.ts +21 -22
  359. package/src/core/components/functional/states/states.md +86 -61
  360. package/src/core/components/functional/states/states.ts +1 -1
  361. package/src/core/components/functional/submit/submit.md +64 -72
  362. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  363. package/src/core/components/functional/translation/translation.md +38 -0
  364. package/src/core/components/functional/value/value.md +34 -22
  365. package/src/core/components/functional/value/value.ts +0 -0
  366. package/src/core/components/ui/_css/size.ts +0 -0
  367. package/src/core/components/ui/alert/alert.md +48 -58
  368. package/src/core/components/ui/badge/badge.md +27 -34
  369. package/src/core/components/ui/button/button.md +139 -106
  370. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  371. package/src/core/components/ui/captcha/captcha.md +17 -32
  372. package/src/core/components/ui/card/card.md +6 -6
  373. package/src/core/components/ui/divider/divider.md +8 -11
  374. package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
  375. package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
  376. package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
  377. package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
  378. package/src/core/components/ui/form/input/input.md +95 -95
  379. package/src/core/components/ui/form/radio/radio.md +55 -34
  380. package/src/core/components/ui/form/select/select.md +60 -45
  381. package/src/core/components/ui/form/switch/switch.md +57 -34
  382. package/src/core/components/ui/form/textarea/textarea.md +55 -38
  383. package/src/core/components/ui/group/group.md +35 -33
  384. package/src/core/components/ui/icon/icon.md +4 -4
  385. package/src/core/components/ui/image/image.md +41 -107
  386. package/src/core/components/ui/link/link.md +6 -6
  387. package/src/core/components/ui/loader/loader.md +30 -55
  388. package/src/core/components/ui/menu/menu.md +27 -27
  389. package/src/core/components/ui/modal/modal.md +72 -96
  390. package/src/core/components/ui/modal/modal.ts +14 -11
  391. package/src/core/components/ui/pop/pop.md +80 -158
  392. package/src/core/components/ui/progress/progress.md +2 -2
  393. package/src/core/components/ui/table/table.md +91 -255
  394. package/src/core/components/ui/theme/theme.md +11 -36
  395. package/src/core/components/ui/toast/toast.md +48 -117
  396. package/src/core/components/ui/tooltip/tooltip.md +27 -62
  397. package/src/core/mixins/Subscriber.ts +0 -0
  398. package/src/core/utils/DataBindObserver.ts +0 -0
  399. package/src/core/utils/LocationHandler.spec.ts +80 -0
  400. package/src/core/utils/LocationHandler.ts +5 -9
  401. package/src/core/utils/Objects.ts +0 -0
  402. package/src/core/utils/route.ts +0 -0
  403. package/src/docs/code.ts +88 -75
  404. package/src/docs/components/docs-demo-sources.ts +70 -147
  405. package/src/docs/components/docs-lit-demo.ts +20 -40
  406. package/src/docs/components/docs-source-link.ts +0 -82
  407. package/src/docs/decorators/ancestor-attribute.md +59 -0
  408. package/src/docs/decorators/auto-subscribe.md +40 -0
  409. package/src/docs/decorators/bind.md +77 -0
  410. package/src/docs/decorators/get.md +160 -0
  411. package/src/docs/decorators/handle.md +119 -0
  412. package/src/docs/decorators/on-assign.md +63 -0
  413. package/src/docs/decorators/patch.md +44 -0
  414. package/src/docs/decorators/post.md +134 -0
  415. package/src/docs/decorators/publish.md +56 -0
  416. package/src/docs/decorators/put.md +51 -0
  417. package/src/docs/decorators/subscribe.md +87 -0
  418. package/src/docs/decorators/wait-for-ancestors.md +76 -0
  419. package/src/docs/directives/sub.md +75 -0
  420. package/src/docs/directives/t.md +73 -0
  421. package/src/docs/docs-location.spec.ts +46 -0
  422. package/src/docs/docs-location.ts +123 -32
  423. package/src/docs/docs.ts +6 -2
  424. package/src/docs/example/decorators-demo-bind-demos.ts +81 -116
  425. package/src/docs/example/decorators-demo-geo.ts +30 -19
  426. package/src/docs/example/decorators-demo-post.ts +88 -186
  427. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
  428. package/src/docs/example/decorators-demo.ts +85 -98
  429. package/src/docs/example/docs-api-config-demos.ts +19 -20
  430. package/src/docs/example/docs-boarding-pass-demo.ts +134 -0
  431. package/src/docs/example/docs-flight-demos.ts +147 -0
  432. package/src/docs/example/docs-jsonata-demos.ts +52 -52
  433. package/src/docs/example/docs-list-demos.ts +43 -123
  434. package/src/docs/example/docs-provider-keys.ts +33 -28
  435. package/src/docs/example/docs-queue-demos.ts +37 -77
  436. package/src/docs/example/docs-router-demos.ts +20 -25
  437. package/src/docs/example/docs-submit-demos.ts +48 -48
  438. package/src/docs/example/docs-toggle-demos.ts +4 -3
  439. package/src/docs/example/users.ts +0 -0
  440. package/src/docs/getting-started/ai-agents.md +76 -0
  441. package/src/docs/getting-started/components.md +5 -0
  442. package/src/docs/getting-started/create-a-component.md +136 -0
  443. package/src/docs/getting-started/dataFlow.md +87 -0
  444. package/src/docs/getting-started/installation.md +36 -0
  445. package/src/docs/getting-started/my-first-component.md +227 -0
  446. package/src/docs/getting-started/start.md +35 -0
  447. package/src/docs/getting-started/theming.md +253 -0
  448. package/src/docs/header/header.ts +240 -71
  449. package/src/docs/home/catalog.ts +44 -0
  450. package/src/docs/home/home.ts +520 -0
  451. package/src/docs/home/mach-stage.ts +389 -0
  452. package/src/docs/layout.ts +12 -11
  453. package/src/docs/misc/api-configuration.md +79 -0
  454. package/src/docs/misc/dataProviderKey.md +168 -0
  455. package/src/docs/misc/docs-mock-api.md +62 -0
  456. package/src/docs/misc/dynamic-path.md +71 -0
  457. package/src/docs/misc/endpoint.md +45 -0
  458. package/src/docs/misc/html-integration.md +14 -0
  459. package/src/docs/mock-api/api-config-mock.ts +5 -0
  460. package/src/docs/mock-api/fixtures.ts +0 -278
  461. package/src/docs/mock-api/flights.ts +89 -0
  462. package/src/docs/mock-api/router.ts +3 -4
  463. package/src/docs/mock-api/urls.ts +1 -2
  464. package/src/docs/navigation/components-index.ts +56 -0
  465. package/src/docs/navigation/navigation.ts +219 -232
  466. package/src/docs/navigation/pager.ts +67 -0
  467. package/src/docs/navigation/toc.ts +101 -0
  468. package/src/docs/search/docs-search.json +2419 -4374
  469. package/src/docs/search/markdown-renderer.ts +33 -7
  470. package/src/docs/search/page.ts +9 -6
  471. package/src/docs/search/search.ts +154 -122
  472. package/src/docs/shiki/index.ts +109 -0
  473. package/src/docs/tailwind/css/base/scrollbar.css +22 -0
  474. package/src/docs/tailwind/css/base/theme.css +96 -0
  475. package/src/docs/tailwind/css/base/typography.css +4 -0
  476. package/src/docs/tailwind/css/docs/boarding-pass.css +65 -0
  477. package/src/docs/tailwind/css/docs/content.css +32 -0
  478. package/src/docs/tailwind/css/docs/page.css +10 -0
  479. package/src/docs/tailwind/css/docs.css +9 -0
  480. package/src/docs/tailwind/css/home/hero.css +210 -0
  481. package/src/docs/tailwind/css/home/motion.css +84 -0
  482. package/src/docs/tailwind/css/home/sections.css +416 -0
  483. package/src/docs/tailwind/css/tailwind.css +7 -185
  484. package/src/tsconfig.json +23 -2
  485. package/src/tsconfig.tsbuildinfo +1 -1
  486. package/tailwind.config.js +8 -4
  487. package/vite.config.mts +11 -2
  488. package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
  489. package/.github/workflows/ci.yml +0 -21
  490. package/.github-export-ignore +0 -30
  491. package/CONTRIBUTING.md +0 -59
  492. package/DEV.md +0 -54
  493. package/LICENSE +0 -21
  494. package/OPEN_SOURCE_CHECKPOINT.md +0 -133
  495. package/concorde-3d.bundle.js +0 -3960
  496. package/concorde-3d.es.js +0 -33433
  497. package/concorde-hugging-face-infer.bundle.js +0 -32
  498. package/concorde-hugging-face-infer.es.js +0 -2952
  499. package/concorde-interactive.bundle.js +0 -1157
  500. package/concorde-interactive.es.js +0 -10734
  501. package/concorde-shader.bundle.js +0 -116
  502. package/concorde-shader.es.js +0 -8353
  503. package/concorde-webgpu.bundle.js +0 -307
  504. package/concorde-webgpu.es.js +0 -8627
  505. package/docs/assets/index-D8MVWqY6.js +0 -12251
  506. package/docs/assets/index-DiD0qYvE.css +0 -1
  507. package/docs/crawl/core/components/functional/date/date.html +0 -190
  508. package/docs/crawl/core/components/functional/fetch/fetch.html +0 -109
  509. package/docs/crawl/core/components/functional/if/if.html +0 -27
  510. package/docs/crawl/core/components/functional/jsonata/jsonata.html +0 -79
  511. package/docs/crawl/core/components/functional/list/list.html +0 -70
  512. package/docs/crawl/core/components/functional/mix/mix.html +0 -45
  513. package/docs/crawl/core/components/functional/queue/queue.html +0 -96
  514. package/docs/crawl/core/components/functional/router/router.html +0 -106
  515. package/docs/crawl/core/components/functional/sdui/sdui.html +0 -269
  516. package/docs/crawl/core/components/functional/states/states.html +0 -66
  517. package/docs/crawl/core/components/functional/submit/submit.html +0 -160
  518. package/docs/crawl/core/components/functional/value/value.html +0 -51
  519. package/docs/crawl/core/components/ui/alert/alert.html +0 -110
  520. package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +0 -23
  521. package/docs/crawl/core/components/ui/badge/badge.html +0 -119
  522. package/docs/crawl/core/components/ui/button/button.html +0 -149
  523. package/docs/crawl/core/components/ui/captcha/captcha.html +0 -30
  524. package/docs/crawl/core/components/ui/card/card.html +0 -99
  525. package/docs/crawl/core/components/ui/divider/divider.html +0 -58
  526. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +0 -73
  527. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +0 -135
  528. package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +0 -79
  529. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +0 -62
  530. package/docs/crawl/core/components/ui/form/input/input.html +0 -109
  531. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +0 -38
  532. package/docs/crawl/core/components/ui/form/radio/radio.html +0 -56
  533. package/docs/crawl/core/components/ui/form/select/select.html +0 -73
  534. package/docs/crawl/core/components/ui/form/switch/switch.html +0 -56
  535. package/docs/crawl/core/components/ui/form/textarea/textarea.html +0 -59
  536. package/docs/crawl/core/components/ui/group/group.html +0 -82
  537. package/docs/crawl/core/components/ui/icon/icon.html +0 -133
  538. package/docs/crawl/core/components/ui/image/image.html +0 -110
  539. package/docs/crawl/core/components/ui/link/link.html +0 -42
  540. package/docs/crawl/core/components/ui/loader/loader.html +0 -50
  541. package/docs/crawl/core/components/ui/modal/modal.html +0 -117
  542. package/docs/crawl/core/components/ui/pop/pop.html +0 -102
  543. package/docs/crawl/core/components/ui/progress/progress.html +0 -58
  544. package/docs/crawl/core/components/ui/table/table.html +0 -413
  545. package/docs/crawl/core/components/ui/toast/toast.html +0 -122
  546. package/docs/crawl/core/components/ui/tooltip/tooltip.html +0 -79
  547. package/docs/crawl/docs/_core-concept/overview.html +0 -66
  548. package/docs/crawl/docs/_core-concept/subscriber.html +0 -75
  549. package/docs/crawl/docs/_decorators/ancestor-attribute.html +0 -116
  550. package/docs/crawl/docs/_decorators/auto-subscribe.html +0 -202
  551. package/docs/crawl/docs/_decorators/bind.html +0 -141
  552. package/docs/crawl/docs/_decorators/get.html +0 -149
  553. package/docs/crawl/docs/_decorators/handle.html +0 -165
  554. package/docs/crawl/docs/_decorators/on-assign.html +0 -355
  555. package/docs/crawl/docs/_decorators/patch.html +0 -78
  556. package/docs/crawl/docs/_decorators/post.html +0 -139
  557. package/docs/crawl/docs/_decorators/publish.html +0 -61
  558. package/docs/crawl/docs/_decorators/put.html +0 -78
  559. package/docs/crawl/docs/_decorators/subscribe.html +0 -109
  560. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +0 -137
  561. package/docs/crawl/docs/_directives/sub.html +0 -93
  562. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +0 -100
  563. package/docs/crawl/docs/_getting-started/concorde-outside.html +0 -58
  564. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +0 -110
  565. package/docs/crawl/docs/_getting-started/pubsub.html +0 -62
  566. package/docs/crawl/docs/_getting-started/start.html +0 -76
  567. package/docs/crawl/docs/_getting-started/theming.html +0 -85
  568. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +0 -138
  569. package/docs/crawl/hubs/decorators.html +0 -547
  570. package/docs/crawl/hubs/form-components.html +0 -359
  571. package/docs/crawl/hubs/remote-data.html +0 -452
  572. package/docs/crawl/index.html +0 -101
  573. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  574. package/docs/src/docs/_core-concept/overview.md +0 -57
  575. package/docs/src/docs/_core-concept/subscriber.md +0 -75
  576. package/docs/src/docs/_decorators/ancestor-attribute.md +0 -127
  577. package/docs/src/docs/_decorators/auto-subscribe.md +0 -202
  578. package/docs/src/docs/_decorators/bind.md +0 -167
  579. package/docs/src/docs/_decorators/get.md +0 -162
  580. package/docs/src/docs/_decorators/handle.md +0 -175
  581. package/docs/src/docs/_decorators/on-assign.md +0 -390
  582. package/docs/src/docs/_decorators/patch.md +0 -70
  583. package/docs/src/docs/_decorators/post.md +0 -146
  584. package/docs/src/docs/_decorators/publish.md +0 -55
  585. package/docs/src/docs/_decorators/put.md +0 -70
  586. package/docs/src/docs/_decorators/subscribe.md +0 -100
  587. package/docs/src/docs/_decorators/wait-for-ancestors.md +0 -163
  588. package/docs/src/docs/_directives/sub.md +0 -91
  589. package/docs/src/docs/_getting-started/concorde-manual-install.md +0 -133
  590. package/docs/src/docs/_getting-started/concorde-outside.md +0 -33
  591. package/docs/src/docs/_getting-started/my-first-subscriber.md +0 -120
  592. package/docs/src/docs/_getting-started/pubsub.md +0 -37
  593. package/docs/src/docs/_getting-started/start.md +0 -47
  594. package/docs/src/docs/_getting-started/theming.md +0 -91
  595. package/docs/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  596. package/docs/src/tsconfig.declarations.json +0 -22
  597. package/docs/src/tsconfig.emit.json +0 -23
  598. package/gitlab/job_github_mirror.sh +0 -39
  599. package/scripts/github-export.mjs +0 -150
  600. package/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
  601. package/src/css.d.ts +0 -19
  602. package/src/docs/_core-concept/overview.md +0 -57
  603. package/src/docs/_core-concept/subscriber.md +0 -75
  604. package/src/docs/_decorators/ancestor-attribute.md +0 -128
  605. package/src/docs/_decorators/auto-subscribe.md +0 -202
  606. package/src/docs/_decorators/bind.md +0 -167
  607. package/src/docs/_decorators/get.md +0 -162
  608. package/src/docs/_decorators/handle.md +0 -175
  609. package/src/docs/_decorators/on-assign.md +0 -390
  610. package/src/docs/_decorators/patch.md +0 -70
  611. package/src/docs/_decorators/post.md +0 -146
  612. package/src/docs/_decorators/publish.md +0 -55
  613. package/src/docs/_decorators/put.md +0 -70
  614. package/src/docs/_decorators/subscribe.md +0 -100
  615. package/src/docs/_decorators/wait-for-ancestors.md +0 -163
  616. package/src/docs/_directives/sub.md +0 -91
  617. package/src/docs/_getting-started/concorde-manual-install.md +0 -133
  618. package/src/docs/_getting-started/concorde-outside.md +0 -33
  619. package/src/docs/_getting-started/my-first-subscriber.md +0 -120
  620. package/src/docs/_getting-started/pubsub.md +0 -37
  621. package/src/docs/_misc/formelement-subscriber-removal.md +0 -115
  622. package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
  623. package/src/docs/example/docs-joke-demos.ts +0 -297
  624. package/src/docs/prism/index.ts +0 -6
  625. package/src/docs/prism/prism.css +0 -158
  626. package/src/docs/prism/prism.js +0 -1022
  627. package/src/tsconfig.declarations.json +0 -22
  628. package/src/tsconfig.emit.json +0 -23
package/docs/core/components/functional/sdui/sdui.html ADDED
@@ -0,0 +1,397 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/functional/sdui" data-doc-id="core/components/functional/sdui/sdui">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>SDUI — Concorde by Supersoniks</title>
7
+ <meta name="description" content="sonic-sdui builds an interface from a JSON descriptor (server-driven UI). Pass the descriptor through props, or add fetch and an endpoint to load it like Fetch. It renders in the light DOM with displa">
8
+ <meta name="keywords" content="Concorde, supersoniks, core/components/functional/sdui/sdui, sdui, SDUI, functional component, sonic-sdui, web component, props, fetch, display: contents, nodes, tagName, div, attributes, textContent">
9
+ <meta name="concorde-doc-id" content="core/components/functional/sdui/sdui">
10
+ <link rel="canonical" href="https://concorde.supersoniks.org/core/components/functional/sdui">
11
+ <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/functional/sdui.md">
12
+ </head>
13
+ <body>
14
+ <header>
15
+ <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/core/components/functional/sdui">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 functional component — SDUI</strong>. sonic-sdui builds an interface from a JSON descriptor (server-driven UI). Pass the descriptor through props, or add fetch and an endpoint to load it like Fetch. It renders in the light DOM with displa <span>Doc ID: <code>core/components/functional/sdui/sdui</code>. Keywords: Concorde, supersoniks, core/components/functional/sdui/sdui, sdui, SDUI, functional component, sonic-sdui, web component, props, fetch, display: contents, nodes, tagName, div, attributes, textContent. URL: <a href="https://concorde.supersoniks.org/core/components/functional/sdui">https://concorde.supersoniks.org/core/components/functional/sdui</a>.</span></p>
20
+ <h1 id="sdui">SDUI</h1>
21
+ <p><strong><code>sonic-sdui</code></strong> builds an interface from a JSON descriptor (server-driven UI). Pass the descriptor through <code>props</code>, or add <code>fetch</code> and an endpoint to load it like <a href="/core/components/functional/fetch">Fetch</a>. It renders in the light DOM with <code>display: contents</code>, so an empty instance does not affect layout.</p>
22
+ <h2 id="basic-example">Basic example</h2>
23
+ <p>Each entry of <code>nodes</code> becomes an element: <code>tagName</code> (default <code>div</code>) · <code>attributes</code> · <code>textContent</code> · nested <code>nodes</code>.</p>
24
+ <pre><code>&lt;sonic-sdui
25
+ dataProvider=&quot;sdui-basic-example&quot;
26
+ props=&#39;{
27
+ &quot;nodes&quot;:[{
28
+ &quot;tagName&quot;:&quot;div&quot;,
29
+ &quot;attributes&quot;:{ &quot;class&quot;:&quot;flex items-center gap-2&quot; },
30
+ &quot;nodes&quot;:[
31
+ { &quot;tagName&quot;:&quot;strong&quot;, &quot;textContent&quot;:&quot;CN 001 · CDG → JFK&quot; },
32
+ { &quot;tagName&quot;:&quot;sonic-badge&quot;, &quot;attributes&quot;:{ &quot;type&quot;:&quot;warning&quot; }, &quot;textContent&quot;:&quot;Delayed&quot; }
33
+ ]
34
+ }]
35
+ }&#39;
36
+ &gt;&lt;/sonic-sdui&gt;
37
+ </code></pre>
38
+ <h2 id="fetching-a-descriptor">Fetching a descriptor</h2>
39
+ <p>Fetching is off by default: add the boolean <code>fetch</code> attribute, then configure <code>serviceURL</code> / <code>endPoint</code> / <code>dataProvider</code> as on <a href="/core/components/functional/fetch">Fetch</a>. Invalidating the publisher or changing the endpoint reloads the interface.</p>
40
+ <pre><code>&lt;sonic-sdui fetch dataProvider=&quot;sdui-fetch-example&quot; endPoint=&quot;/src/core/components/functional/sdui/example.json&quot;&gt;&lt;/sonic-sdui&gt;
41
+ </code></pre>
42
+ <h2 id="html-content">HTML content</h2>
43
+ <p><code>markup</code> builds the node from an HTML string, <code>innerHTML</code> appends HTML inside the element, and <code>prefix</code> / <code>suffix</code> wrap it. Prefer <code>textContent</code> for anything coming from user data.</p>
44
+ <pre><code>&lt;sonic-sdui
45
+ dataProvider=&quot;sdui-html-example&quot;
46
+ props=&#39;{
47
+ &quot;nodes&quot;:[
48
+ { &quot;markup&quot;:&quot;Cruising at &amp;lt;sonic-badge&amp;gt;Mach 2.04&amp;lt;/sonic-badge&amp;gt;&quot; },
49
+ { &quot;tagName&quot;:&quot;p&quot;, &quot;prefix&quot;:&quot;&amp;lt;hr&amp;gt;&quot;, &quot;innerHTML&quot;:&quot;Altitude: &amp;lt;b&amp;gt;60,000 ft&amp;lt;/b&amp;gt;&quot; }
50
+ ]
51
+ }&#39;
52
+ &gt;&lt;/sonic-sdui&gt;
53
+ </code></pre>
54
+ <h2 id="library">Library</h2>
55
+ <p>A node with <code>libraryKey</code> uses a library entry as its model, then adds its own attributes and children. In the model, <code>contentElementSelector</code> sets where those children go. The descriptor <code>library</code> is merged over a default library of form fields (<code>textfield</code> · <code>email</code> · <code>password</code> · <code>date</code> · <code>select</code> · <code>checkbox</code> · <code>radio</code> · <code>textarea</code> · <code>button</code> · <code>submit</code> · <code>fieldset</code>…, see <code>default-library.json</code>). The <code>library</code> attribute replaces it with a JSON file loaded from a URL.</p>
56
+ <pre><code>&lt;sonic-sdui
57
+ dataProvider=&quot;sdui-library-example&quot;
58
+ props=&#39;{
59
+ &quot;library&quot;:{
60
+ &quot;flightCard&quot;:{
61
+ &quot;tagName&quot;:&quot;sonic-card&quot;,
62
+ &quot;attributes&quot;:{ &quot;class&quot;:&quot;block max-w-sm&quot; },
63
+ &quot;nodes&quot;:[{ &quot;tagName&quot;:&quot;div&quot;, &quot;attributes&quot;:{ &quot;class&quot;:&quot;text-sm&quot; } }],
64
+ &quot;contentElementSelector&quot;:&quot;div&quot;
65
+ }
66
+ },
67
+ &quot;nodes&quot;:[
68
+ { &quot;libraryKey&quot;:&quot;flightCard&quot;, &quot;nodes&quot;:[{ &quot;tagName&quot;:&quot;span&quot;, &quot;textContent&quot;:&quot;CN 001 · Gate C4&quot; }] },
69
+ { &quot;libraryKey&quot;:&quot;email&quot;, &quot;attributes&quot;:{ &quot;label&quot;:&quot;Passenger email&quot;, &quot;name&quot;:&quot;email&quot;, &quot;class&quot;:&quot;block mt-4 max-w-sm&quot; } }
70
+ ]
71
+ }&#39;
72
+ &gt;&lt;/sonic-sdui&gt;
73
+ </code></pre>
74
+ <h2 id="child-placement">Child placement</h2>
75
+ <p>A child with <code>parentElementSelector</code> is appended to the first element matching that selector inside its parent, instead of the parent itself. It has no effect on top-level nodes.</p>
76
+ <pre><code>&lt;sonic-sdui
77
+ dataProvider=&quot;sdui-parent-selector-example&quot;
78
+ props=&#39;{
79
+ &quot;nodes&quot;:[{
80
+ &quot;nodes&quot;:[
81
+ { &quot;tagName&quot;:&quot;strong&quot;, &quot;textContent&quot;:&quot;Departures&quot; },
82
+ { &quot;tagName&quot;:&quot;ul&quot; },
83
+ { &quot;tagName&quot;:&quot;li&quot;, &quot;parentElementSelector&quot;:&quot;ul&quot;, &quot;textContent&quot;:&quot;CN 001 · CDG → JFK&quot; },
84
+ { &quot;tagName&quot;:&quot;li&quot;, &quot;parentElementSelector&quot;:&quot;ul&quot;, &quot;textContent&quot;:&quot;CN 003 · LHR → JFK&quot; }
85
+ ]
86
+ }]
87
+ }&#39;
88
+ &gt;&lt;/sonic-sdui&gt;
89
+ </code></pre>
90
+ <h2 id="actions">Actions</h2>
91
+ <p>A node with <code>action: { name, context? }</code> makes a click on its element dispatch an <code>sdui-action</code> event from <code>sonic-sdui</code>. <code>detail</code> is <code>{ name, context, sourceNodeId? }</code>, where <code>sourceNodeId</code> is the node <code>nodeId</code>. The event bubbles and is composed, so a page shell can listen once for every node. Form posting stays with <a href="/core/components/functional/submit">Submit</a>.</p>
92
+ <pre><code>&lt;sonic-sdui
93
+ id=&quot;sdui-action-example&quot;
94
+ dataProvider=&quot;sdui-action-example&quot;
95
+ props=&#39;{
96
+ &quot;nodes&quot;:[{
97
+ &quot;tagName&quot;:&quot;sonic-button&quot;,
98
+ &quot;nodeId&quot;:&quot;check-in&quot;,
99
+ &quot;textContent&quot;:&quot;Check in&quot;,
100
+ &quot;action&quot;:{ &quot;name&quot;:&quot;check-in&quot;, &quot;context&quot;:{ &quot;flight&quot;:&quot;CN 001&quot; } }
101
+ }]
102
+ }&#39;
103
+ &gt;&lt;/sonic-sdui&gt;
104
+ </code></pre>
105
+ <pre><code class="language-typescript">document.querySelector(&quot;#sdui-action-example&quot;)?.addEventListener(&quot;sdui-action&quot;, (e) =&gt; {
106
+ const { name, context, sourceNodeId } = (e as CustomEvent).detail;
107
+ });
108
+ </code></pre>
109
+ <h2 id="safe-profile">Safe profile</h2>
110
+ <p>With <code>profile=&quot;safe&quot;</code>, the descriptor cannot inject HTML or scripts: <code>js</code> URLs are not loaded, and nodes using <code>markup</code> / <code>innerHTML</code> / <code>prefix</code> / <code>suffix</code> (directly or through their library model) are skipped with a <code>console.warn</code>. <code>textContent</code>, attributes and actions still work. Without the attribute, everything is rendered.</p>
111
+ <pre><code>&lt;sonic-sdui
112
+ profile=&quot;safe&quot;
113
+ dataProvider=&quot;sdui-safe-example&quot;
114
+ props=&#39;{
115
+ &quot;nodes&quot;:[
116
+ { &quot;tagName&quot;:&quot;p&quot;, &quot;textContent&quot;:&quot;Gate C4 · Boarding at 10:40&quot; },
117
+ { &quot;innerHTML&quot;:&quot;&amp;lt;b&amp;gt;Skipped: HTML is refused&amp;lt;/b&amp;gt;&quot; }
118
+ ]
119
+ }&#39;
120
+ &gt;&lt;/sonic-sdui&gt;
121
+ </code></pre>
122
+ <p>To check a descriptor before rendering it, <code>validateSafeDescriptor(descriptor)</code> from <code>@supersoniks/concorde/sdui-safe</code> returns the violations as <code>{ path, field, message }[]</code> without side effects.</p>
123
+ <h2 id="partial-rendering">Partial rendering</h2>
124
+ <p>Declare nodes once in <code>nodeById</code> and reference them with <code>childNodeIds</code>. With the boolean <code>partial</code>, a missing id renders an empty placeholder (<code>data-sdui-placeholder</code> · <code>aria-hidden</code> · <code>display: contents</code>) so the node can arrive later. Without it, the missing child is skipped with a <code>console.warn</code>.</p>
125
+ <pre><code>&lt;sonic-sdui
126
+ partial
127
+ dataProvider=&quot;sdui-partial-example&quot;
128
+ props=&#39;{
129
+ &quot;nodes&quot;:[{ &quot;tagName&quot;:&quot;div&quot;, &quot;childNodeIds&quot;:[&quot;flight&quot;, &quot;gate&quot;] }],
130
+ &quot;nodeById&quot;:{
131
+ &quot;flight&quot;:{ &quot;tagName&quot;:&quot;strong&quot;, &quot;textContent&quot;:&quot;CN 001 · CDG → JFK&quot; }
132
+ }
133
+ }&#39;
134
+ &gt;&lt;/sonic-sdui&gt;
135
+ </code></pre>
136
+ <h2 id="incremental-updates">Incremental updates</h2>
137
+ <p><code>upsertNode</code> · <code>removeNode</code> · <code>setData</code> patch the rendered interface without a full rebuild, so sibling nodes keep their state (focus, input values). A node needs a <code>nodeId</code> to be updated. The first operation switches the component to incremental mode, where <code>props</code> changes are ignored until <code>endIncremental()</code>. To drive it from data, set <code>opsDataProvider</code>: each value assigned to that publisher (<code>SDUIOp</code> or <code>SDUIOp[]</code>) goes through <code>applyOp</code>.</p>
138
+ <pre><code>&lt;sonic-sdui
139
+ id=&quot;sdui-ops-example&quot;
140
+ dataProvider=&quot;sdui-ops-example&quot;
141
+ props=&#39;{
142
+ &quot;nodes&quot;:[
143
+ { &quot;nodeId&quot;:&quot;cn001&quot;, &quot;tagName&quot;:&quot;p&quot;, &quot;textContent&quot;:&quot;CN 001 · CDG → JFK · On time&quot; },
144
+ { &quot;nodeId&quot;:&quot;cn003&quot;, &quot;tagName&quot;:&quot;p&quot;, &quot;textContent&quot;:&quot;CN 003 · LHR → JFK · Boarding&quot; }
145
+ ]
146
+ }&#39;
147
+ &gt;&lt;/sonic-sdui&gt;
148
+ &lt;sonic-button size=&quot;sm&quot; onclick=&quot;document.getElementById(&#39;sdui-ops-example&#39;).upsertNode({ nodeId: &#39;cn001&#39;, tagName: &#39;p&#39;, textContent: &#39;CN 001 · CDG → JFK · Delayed 20 min&#39; })&quot;&gt;Delay CN 001&lt;/sonic-button&gt;
149
+ &lt;sonic-button size=&quot;sm&quot; variant=&quot;outline&quot; onclick=&quot;document.getElementById(&#39;sdui-ops-example&#39;).removeNode(&#39;cn003&#39;)&quot;&gt;Remove CN 003&lt;/sonic-button&gt;
150
+ </code></pre>
151
+ <h2 id="transformations">Transformations</h2>
152
+ <p>The <code>transformation</code> attribute points to a JSON file applied to the descriptor before rendering. Its <code>library</code> is merged into the descriptor library; each entry of <code>transforms</code> runs an action on the nodes matching <code>patterns</code>.</p>
153
+ <pre><code class="language-typescript">{
154
+ &quot;transforms&quot;: [
155
+ { &quot;action&quot;: &quot;remap&quot;, &quot;patterns&quot;: [{ &quot;libraryKey&quot;: &quot;textfield&quot; }], &quot;ui&quot;: { &quot;tagName&quot;: &quot;sonic-input&quot;, &quot;attributes&quot;: { &quot;size&quot;: &quot;lg&quot; } } },
156
+ { &quot;action&quot;: &quot;insert&quot;, &quot;after&quot;: { &quot;libraryKey&quot;: &quot;email&quot; }, &quot;ui&quot;: { &quot;tagName&quot;: &quot;p&quot;, &quot;textContent&quot;: &quot;Boarding pass sent by email&quot; } }
157
+ ]
158
+ }
159
+ </code></pre>
160
+ <table>
161
+ <thead>
162
+ <tr>
163
+ <th>Action</th>
164
+ <th>Effect</th>
165
+ </tr>
166
+ </thead>
167
+ <tbody><tr>
168
+ <td><code>remap</code></td>
169
+ <td>Replaces each matched node with <code>ui</code>, keeping its attributes, content and children unless <code>ui</code> redefines them</td>
170
+ </tr>
171
+ <tr>
172
+ <td><code>unwrap</code></td>
173
+ <td>Replaces each matched node with its children</td>
174
+ </tr>
175
+ <tr>
176
+ <td><code>wrap</code></td>
177
+ <td>Groups the matched nodes into the <code>ui</code> node</td>
178
+ </tr>
179
+ <tr>
180
+ <td><code>delete</code></td>
181
+ <td>Removes the matched nodes</td>
182
+ </tr>
183
+ <tr>
184
+ <td><code>insert</code></td>
185
+ <td>Inserts <code>ui</code> relative to the node matched by <code>before</code> · <code>after</code> · <code>in</code></td>
186
+ </tr>
187
+ <tr>
188
+ <td><code>move</code></td>
189
+ <td>Moves the matched nodes next to the node matched by <code>before</code> or <code>after</code></td>
190
+ </tr>
191
+ </tbody></table>
192
+ <h2 id="wrapped-descriptor">Wrapped descriptor</h2>
193
+ <p>When the descriptor is one key of a larger payload, set <code>sduiKey</code> to that key. Set <code>messagesKey</code> to render the toast messages found at that key with <code>sonic-toast-message-subscriber</code> (<code>{ content, status, type }</code> items).</p>
194
+ <pre><code>&lt;sonic-sdui
195
+ sduiKey=&quot;ui&quot;
196
+ dataProvider=&quot;sdui-key-example&quot;
197
+ props=&#39;{
198
+ &quot;flight&quot;:&quot;CN 001&quot;,
199
+ &quot;ui&quot;:{ &quot;nodes&quot;:[{ &quot;tagName&quot;:&quot;p&quot;, &quot;textContent&quot;:&quot;Weather warning: turbulence expected over the Atlantic&quot; }] }
200
+ }&#39;
201
+ &gt;&lt;/sonic-sdui&gt;
202
+ </code></pre>
203
+ <h2 id="component-catalog">Component catalog</h2>
204
+ <p>The package ships a JSON catalog of every custom element (<code>tag</code>; <code>props</code> with attribute / type / allowed values / default; slots and events), generated at build time for descriptor authors and tools. It has no runtime cost. Elements with thin annotations are listed in <code>component-catalog.gaps.json</code>.</p>
205
+ <pre><code class="language-typescript">import catalog from &quot;@supersoniks/concorde/sdui/component-catalog.json&quot;;
206
+ </code></pre>
207
+ <h2 id="playground">Playground</h2>
208
+ <p>Edit the descriptor and leave the field to render it.</p>
209
+ <pre><code>&lt;sonic-textarea
210
+ rows=&quot;8&quot;
211
+ onChange=&quot;SonicPublisherManager.get(&#39;sdui-playground&#39;).set(JSON.parse(this.value))&quot;
212
+ value=&#39;{&quot;nodes&quot;:[{&quot;tagName&quot;:&quot;sonic-badge&quot;, &quot;attributes&quot;:{&quot;type&quot;:&quot;success&quot;}, &quot;textContent&quot;:&quot;CN 001 landed&quot;}]}&#39;
213
+ &gt;&lt;/sonic-textarea&gt;
214
+ &lt;sonic-sdui dataProvider=&quot;sdui-playground&quot; props=&#39;{&quot;nodes&quot;:[{&quot;tagName&quot;:&quot;sonic-badge&quot;, &quot;attributes&quot;:{&quot;type&quot;:&quot;success&quot;}, &quot;textContent&quot;:&quot;CN 001 landed&quot;}]}&#39;&gt;&lt;/sonic-sdui&gt;
215
+ </code></pre>
216
+ <h2 id="api-reference">API reference</h2>
217
+ <table>
218
+ <thead>
219
+ <tr>
220
+ <th>Attribute</th>
221
+ <th>Values</th>
222
+ <th>Description</th>
223
+ </tr>
224
+ </thead>
225
+ <tbody><tr>
226
+ <td><code>dataProvider</code></td>
227
+ <td>string</td>
228
+ <td>Publisher holding the descriptor. Required</td>
229
+ </tr>
230
+ <tr>
231
+ <td><code>props</code></td>
232
+ <td><code>SDUIDescriptor</code> (JSON)</td>
233
+ <td>Descriptor to render</td>
234
+ </tr>
235
+ <tr>
236
+ <td><code>fetch</code></td>
237
+ <td>boolean</td>
238
+ <td>Loads the descriptor from <code>serviceURL</code> + <code>endPoint</code> (or <code>dataProvider</code>). Other request attributes as on <a href="/core/components/functional/fetch">Fetch</a></td>
239
+ </tr>
240
+ <tr>
241
+ <td><code>sduiKey</code></td>
242
+ <td>string</td>
243
+ <td>Reads the descriptor from <code>props[sduiKey]</code></td>
244
+ </tr>
245
+ <tr>
246
+ <td><code>messagesKey</code></td>
247
+ <td>string</td>
248
+ <td>Path in <code>props</code> of the toast messages to display</td>
249
+ </tr>
250
+ <tr>
251
+ <td><code>profile</code></td>
252
+ <td><code>safe</code></td>
253
+ <td>Refuses <code>js</code> / <code>markup</code> / <code>innerHTML</code> / <code>prefix</code> / <code>suffix</code>. Unset by default</td>
254
+ </tr>
255
+ <tr>
256
+ <td><code>partial</code></td>
257
+ <td>boolean</td>
258
+ <td>Renders a placeholder for missing <code>childNodeIds</code></td>
259
+ </tr>
260
+ <tr>
261
+ <td><code>library</code></td>
262
+ <td>URL</td>
263
+ <td>JSON library that replaces the descriptor library</td>
264
+ </tr>
265
+ <tr>
266
+ <td><code>transformation</code></td>
267
+ <td>URL</td>
268
+ <td>JSON transform description applied before rendering</td>
269
+ </tr>
270
+ <tr>
271
+ <td><code>opsDataProvider</code></td>
272
+ <td>string</td>
273
+ <td>Publisher whose assigned values are passed to <code>applyOp</code></td>
274
+ </tr>
275
+ </tbody></table>
276
+ <table>
277
+ <thead>
278
+ <tr>
279
+ <th>Descriptor key</th>
280
+ <th>Description</th>
281
+ </tr>
282
+ </thead>
283
+ <tbody><tr>
284
+ <td><code>nodes</code></td>
285
+ <td>Root nodes</td>
286
+ </tr>
287
+ <tr>
288
+ <td><code>nodeById</code></td>
289
+ <td>Flat registry of nodes for <code>childNodeIds</code></td>
290
+ </tr>
291
+ <tr>
292
+ <td><code>library</code></td>
293
+ <td>Node models by key, merged over the default library</td>
294
+ </tr>
295
+ <tr>
296
+ <td><code>js</code> / <code>css</code></td>
297
+ <td>Script and stylesheet URLs to load (<code>js</code> refused in safe profile)</td>
298
+ </tr>
299
+ </tbody></table>
300
+ <table>
301
+ <thead>
302
+ <tr>
303
+ <th>Node field</th>
304
+ <th>Description</th>
305
+ </tr>
306
+ </thead>
307
+ <tbody><tr>
308
+ <td><code>tagName</code></td>
309
+ <td>Element tag (default <code>div</code>)</td>
310
+ </tr>
311
+ <tr>
312
+ <td><code>attributes</code></td>
313
+ <td>Attribute name → value (objects are serialized to JSON)</td>
314
+ </tr>
315
+ <tr>
316
+ <td><code>nodes</code></td>
317
+ <td>Child nodes</td>
318
+ </tr>
319
+ <tr>
320
+ <td><code>childNodeIds</code></td>
321
+ <td>Child <code>nodeId</code>s resolved from <code>nodeById</code> or the tree</td>
322
+ </tr>
323
+ <tr>
324
+ <td><code>textContent</code></td>
325
+ <td>Plain text. Ignored when the node has children</td>
326
+ </tr>
327
+ <tr>
328
+ <td><code>markup</code> · <code>innerHTML</code> · <code>prefix</code> · <code>suffix</code></td>
329
+ <td>HTML strings (refused in safe profile)</td>
330
+ </tr>
331
+ <tr>
332
+ <td><code>libraryKey</code></td>
333
+ <td>Library entry used as the model</td>
334
+ </tr>
335
+ <tr>
336
+ <td><code>contentElementSelector</code></td>
337
+ <td>In a library model: where children are appended</td>
338
+ </tr>
339
+ <tr>
340
+ <td><code>parentElementSelector</code></td>
341
+ <td>Appends the node to a matching element of its parent</td>
342
+ </tr>
343
+ <tr>
344
+ <td><code>nodeId</code></td>
345
+ <td>Logical id for actions, <code>childNodeIds</code> and incremental updates (rendered as <code>data-sdui-node-id</code>)</td>
346
+ </tr>
347
+ <tr>
348
+ <td><code>action</code></td>
349
+ <td><code>{ name, context? }</code> dispatched as <code>sdui-action</code> on click</td>
350
+ </tr>
351
+ </tbody></table>
352
+ <table>
353
+ <thead>
354
+ <tr>
355
+ <th>Method</th>
356
+ <th>Description</th>
357
+ </tr>
358
+ </thead>
359
+ <tbody><tr>
360
+ <td><code>upsertNode(node, parentId?, index?)</code></td>
361
+ <td>Adds or replaces a node by <code>nodeId</code></td>
362
+ </tr>
363
+ <tr>
364
+ <td><code>removeNode(nodeId)</code></td>
365
+ <td>Removes a node</td>
366
+ </tr>
367
+ <tr>
368
+ <td><code>setData(path, value)</code></td>
369
+ <td>Sets a publisher path (<code>form.email</code>), absolute or relative to <code>dataProvider</code></td>
370
+ </tr>
371
+ <tr>
372
+ <td><code>applyOp(op)</code></td>
373
+ <td>Runs an <code>SDUIOp</code>: <code>upsertNode</code> · <code>removeNode</code> · <code>setData</code></td>
374
+ </tr>
375
+ <tr>
376
+ <td><code>endIncremental()</code></td>
377
+ <td>Leaves incremental mode; the next <code>props</code> change rebuilds everything</td>
378
+ </tr>
379
+ </tbody></table>
380
+ <table>
381
+ <thead>
382
+ <tr>
383
+ <th>Event</th>
384
+ <th>Detail</th>
385
+ </tr>
386
+ </thead>
387
+ <tbody><tr>
388
+ <td><code>sdui-action</code></td>
389
+ <td><code>{ name, context, sourceNodeId? }</code></td>
390
+ </tr>
391
+ </tbody></table>
392
+ <p>No slots.</p>
393
+
394
+ </article>
395
+ </main>
396
+ </body>
397
+ </html>