@supersoniks/concorde 5.1.2 → 5.1.3-immutable.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (497) hide show
  1. package/.agents/skills/concorde-docs/SKILL.md +1 -1
  2. package/.claude/skills +1 -0
  3. package/.github/workflows/ci.yml +21 -0
  4. package/.github-export-ignore +30 -0
  5. package/CONTRIBUTING.md +59 -0
  6. package/DEV.md +54 -0
  7. package/LICENSE +21 -0
  8. package/OPEN_SOURCE_CHECKPOINT.md +133 -0
  9. package/README.md +1 -1
  10. package/ai/README.md +29 -41
  11. package/ai/skills/concorde/SKILL.md +54 -324
  12. package/ai/skills/concorde/rules/composition.md +32 -0
  13. package/ai/skills/concorde/rules/data.md +47 -0
  14. package/ai/skills/concorde/rules/http.md +25 -0
  15. package/ai/skills/concorde/rules/lists-forms.md +35 -0
  16. package/ai/skills/concorde/rules/styling.md +46 -0
  17. package/ai/skills/concorde/rules/troubleshooting.md +45 -0
  18. package/build-infos.json +1 -1
  19. package/concorde-core.bundle.js +177 -177
  20. package/concorde-core.es.js +4993 -4833
  21. package/custom-elements-manifest.public.config.mjs +8 -0
  22. package/{.tmp-cem/custom-elements.json → custom-elements.json} +11722 -8868
  23. package/dist/concorde-core.bundle.js +177 -177
  24. package/dist/concorde-core.es.js +4993 -4833
  25. package/dist/docs-mock-api-sw.js +58 -223
  26. package/dist/docs-mock-api-sw.js.map +4 -4
  27. package/dist/img/og-concorde.jpg +0 -0
  28. package/dist/robots.txt +11 -10
  29. package/docs/assets/index-CD4WyL6o.css +1 -0
  30. package/docs/assets/index-D_alEsng.js +12122 -0
  31. package/docs/crawl/core/components/functional/date/date.html +190 -0
  32. package/docs/crawl/core/components/functional/fetch/fetch.html +109 -0
  33. package/docs/crawl/core/components/functional/if/if.html +27 -0
  34. package/docs/crawl/core/components/functional/jsonata/jsonata.html +79 -0
  35. package/docs/crawl/core/components/functional/list/list.html +70 -0
  36. package/docs/crawl/core/components/functional/mix/mix.html +45 -0
  37. package/docs/crawl/core/components/functional/queue/queue.html +96 -0
  38. package/docs/crawl/core/components/functional/router/router.html +106 -0
  39. package/docs/{core → crawl/core}/components/functional/sdui/sdui-extension-points.html +8 -9
  40. package/docs/crawl/core/components/functional/sdui/sdui.html +368 -0
  41. package/docs/crawl/core/components/functional/states/states.html +66 -0
  42. package/docs/crawl/core/components/functional/submit/submit.html +160 -0
  43. package/docs/{core → crawl/core}/components/functional/subscriber/subscriber.html +5 -6
  44. package/docs/crawl/core/components/functional/value/value.html +51 -0
  45. package/docs/{core → crawl/core}/components/ui/alert/alert.html +63 -53
  46. package/docs/{core → crawl/core}/components/ui/alert-messages/alert-messages.html +5 -6
  47. package/docs/{core → crawl/core}/components/ui/badge/badge.html +33 -33
  48. package/docs/crawl/core/components/ui/button/button.html +150 -0
  49. package/docs/crawl/core/components/ui/captcha/captcha.html +112 -0
  50. package/docs/{core → crawl/core}/components/ui/card/card.html +11 -12
  51. package/docs/{core → crawl/core}/components/ui/divider/divider.html +14 -14
  52. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +73 -0
  53. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +266 -0
  54. package/docs/{core → crawl/core}/components/ui/form/form-actions/form-actions.html +23 -23
  55. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +121 -0
  56. package/docs/crawl/core/components/ui/form/input/input.html +109 -0
  57. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +38 -0
  58. package/docs/crawl/core/components/ui/form/radio/radio.html +56 -0
  59. package/docs/crawl/core/components/ui/form/select/select.html +73 -0
  60. package/docs/crawl/core/components/ui/form/switch/switch.html +56 -0
  61. package/docs/crawl/core/components/ui/form/textarea/textarea.html +59 -0
  62. package/docs/crawl/core/components/ui/group/group.html +104 -0
  63. package/docs/{core → crawl/core}/components/ui/icon/icon.html +9 -10
  64. package/docs/crawl/core/components/ui/image/image.html +298 -0
  65. package/docs/{core → crawl/core}/components/ui/link/link.html +11 -12
  66. package/docs/crawl/core/components/ui/loader/loader.html +124 -0
  67. package/docs/{core → crawl/core}/components/ui/menu/menu.html +33 -34
  68. package/docs/crawl/core/components/ui/modal/modal.html +342 -0
  69. package/docs/crawl/core/components/ui/pop/pop.html +296 -0
  70. package/docs/{core → crawl/core}/components/ui/progress/progress.html +7 -8
  71. package/docs/crawl/core/components/ui/table/table.html +545 -0
  72. package/docs/crawl/core/components/ui/theme/theme.html +131 -0
  73. package/docs/crawl/core/components/ui/toast/toast.html +233 -0
  74. package/docs/crawl/core/components/ui/tooltip/tooltip.html +140 -0
  75. package/docs/{docs/getting-started → crawl/docs/_core-concept}/dataFlow.html +29 -26
  76. package/docs/crawl/docs/_core-concept/overview.html +66 -0
  77. package/docs/crawl/docs/_core-concept/subscriber.html +75 -0
  78. package/docs/crawl/docs/_decorators/ancestor-attribute.html +117 -0
  79. package/docs/crawl/docs/_decorators/auto-subscribe.html +202 -0
  80. package/docs/crawl/docs/_decorators/bind.html +141 -0
  81. package/docs/crawl/docs/_decorators/get.html +149 -0
  82. package/docs/crawl/docs/_decorators/handle.html +165 -0
  83. package/docs/crawl/docs/_decorators/on-assign.html +355 -0
  84. package/docs/crawl/docs/_decorators/patch.html +78 -0
  85. package/docs/crawl/docs/_decorators/post.html +139 -0
  86. package/docs/crawl/docs/_decorators/publish.html +61 -0
  87. package/docs/crawl/docs/_decorators/put.html +78 -0
  88. package/docs/crawl/docs/_decorators/subscribe.html +109 -0
  89. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +137 -0
  90. package/docs/crawl/docs/_directives/sub.html +93 -0
  91. package/docs/{docs/getting-started → crawl/docs/_getting-started}/ai-agents.html +11 -12
  92. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +100 -0
  93. package/docs/crawl/docs/_getting-started/concorde-outside.html +58 -0
  94. package/docs/{docs/getting-started → crawl/docs/_getting-started}/create-a-component.html +14 -11
  95. package/docs/{docs/getting-started → crawl/docs/_getting-started}/my-first-component.html +22 -13
  96. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +110 -0
  97. package/docs/crawl/docs/_getting-started/pubsub.html +62 -0
  98. package/docs/crawl/docs/_getting-started/start.html +76 -0
  99. package/docs/{docs/getting-started → crawl/docs/_getting-started}/theming.html +9 -10
  100. package/docs/{docs/misc → crawl/docs/_misc}/api-configuration.html +18 -18
  101. package/docs/{docs/misc → crawl/docs/_misc}/dataProviderKey.html +11 -12
  102. package/docs/{docs/misc → crawl/docs/_misc}/docs-mock-api.html +28 -25
  103. package/docs/{docs/misc → crawl/docs/_misc}/dynamic-path.html +15 -16
  104. package/docs/{docs/misc → crawl/docs/_misc}/endpoint.html +15 -16
  105. package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +138 -0
  106. package/docs/{docs/misc → crawl/docs/_misc}/html-integration.html +15 -12
  107. package/docs/crawl/hubs/decorators.html +547 -0
  108. package/docs/crawl/hubs/form-components.html +381 -0
  109. package/docs/crawl/hubs/remote-data.html +452 -0
  110. package/docs/crawl/index.html +103 -0
  111. package/docs/docs-mock-api-sw.js +223 -58
  112. package/docs/docs-mock-api-sw.js.map +4 -4
  113. package/docs/index.html +68 -95
  114. package/docs/llms-full.txt +3610 -2231
  115. package/docs/llms.txt +86 -94
  116. package/docs/robots.txt +10 -11
  117. package/docs/sitemap.xml +84 -78
  118. package/docs/src/core/components/functional/date/date.md +231 -91
  119. package/docs/src/core/components/functional/fetch/fetch.md +83 -66
  120. package/docs/src/core/components/functional/if/if.md +3 -28
  121. package/docs/src/core/components/functional/jsonata/jsonata.md +37 -42
  122. package/docs/src/core/components/functional/list/list.md +43 -99
  123. package/docs/src/core/components/functional/mix/mix.md +26 -31
  124. package/docs/src/core/components/functional/queue/queue.md +61 -40
  125. package/docs/src/core/components/functional/router/router.md +65 -64
  126. package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  127. package/docs/src/core/components/functional/sdui/component-catalog.json +1 -1
  128. package/docs/src/core/components/functional/sdui/example.json +86 -19
  129. package/docs/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
  130. package/docs/src/core/components/functional/sdui/sdui.md +358 -187
  131. package/docs/src/core/components/functional/states/states.md +61 -86
  132. package/docs/src/core/components/functional/submit/submit.md +72 -64
  133. package/docs/src/core/components/functional/value/value.md +22 -34
  134. package/docs/src/core/components/ui/alert/alert.md +58 -48
  135. package/docs/src/core/components/ui/badge/badge.md +34 -27
  136. package/docs/src/core/components/ui/button/button.md +106 -139
  137. package/docs/src/core/components/ui/captcha/captcha.md +32 -17
  138. package/docs/src/core/components/ui/card/card.md +6 -6
  139. package/docs/src/core/components/ui/divider/divider.md +11 -8
  140. package/docs/src/core/components/ui/form/checkbox/checkbox.md +42 -90
  141. package/docs/src/core/components/ui/form/fieldset/fieldset.md +75 -31
  142. package/docs/src/core/components/ui/form/form-actions/form-actions.md +16 -14
  143. package/docs/src/core/components/ui/form/form-layout/form-layout.md +29 -19
  144. package/docs/src/core/components/ui/form/input/input.md +95 -95
  145. package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +29 -0
  146. package/docs/src/core/components/ui/form/radio/radio.md +34 -55
  147. package/docs/src/core/components/ui/form/select/select.md +45 -60
  148. package/docs/src/core/components/ui/form/switch/switch.md +34 -57
  149. package/docs/src/core/components/ui/form/textarea/textarea.md +38 -55
  150. package/docs/src/core/components/ui/group/group.md +33 -35
  151. package/docs/src/core/components/ui/icon/icon.md +4 -4
  152. package/docs/src/core/components/ui/image/image.md +107 -41
  153. package/docs/src/core/components/ui/link/link.md +6 -6
  154. package/docs/src/core/components/ui/loader/loader.md +55 -30
  155. package/docs/src/core/components/ui/menu/menu.md +27 -27
  156. package/docs/src/core/components/ui/modal/modal.md +96 -72
  157. package/docs/src/core/components/ui/pop/pop.md +158 -80
  158. package/docs/src/core/components/ui/progress/progress.md +2 -2
  159. package/docs/src/core/components/ui/table/table.md +255 -91
  160. package/docs/src/core/components/ui/theme/theme.md +36 -11
  161. package/docs/src/core/components/ui/toast/toast.md +117 -48
  162. package/docs/src/core/components/ui/tooltip/tooltip.md +62 -27
  163. package/docs/{docs/getting-started → src/docs/_core-concept}/dataFlow.md +18 -17
  164. package/docs/src/docs/_core-concept/overview.md +57 -0
  165. package/docs/src/docs/_core-concept/subscriber.md +75 -0
  166. package/docs/src/docs/_decorators/ancestor-attribute.md +128 -0
  167. package/docs/src/docs/_decorators/auto-subscribe.md +202 -0
  168. package/docs/src/docs/_decorators/bind.md +167 -0
  169. package/docs/src/docs/_decorators/get.md +162 -0
  170. package/docs/src/docs/_decorators/handle.md +175 -0
  171. package/docs/src/docs/_decorators/on-assign.md +390 -0
  172. package/docs/src/docs/_decorators/patch.md +70 -0
  173. package/docs/src/docs/_decorators/post.md +146 -0
  174. package/docs/src/docs/_decorators/publish.md +55 -0
  175. package/docs/src/docs/_decorators/put.md +70 -0
  176. package/docs/src/docs/_decorators/subscribe.md +100 -0
  177. package/docs/src/docs/_decorators/wait-for-ancestors.md +163 -0
  178. package/docs/src/docs/_directives/sub.md +91 -0
  179. package/docs/src/docs/{getting-started → _getting-started}/ai-agents.md +3 -3
  180. package/docs/src/docs/_getting-started/concorde-manual-install.md +133 -0
  181. package/docs/src/docs/_getting-started/concorde-outside.md +33 -0
  182. package/docs/{docs/getting-started → src/docs/_getting-started}/create-a-component.md +6 -3
  183. package/docs/src/docs/{getting-started → _getting-started}/my-first-component.md +14 -5
  184. package/docs/src/docs/_getting-started/my-first-subscriber.md +120 -0
  185. package/docs/src/docs/_getting-started/pubsub.md +37 -0
  186. package/docs/src/docs/{getting-started → _getting-started}/start.md +13 -1
  187. package/docs/src/docs/{getting-started → _getting-started}/theming.md +2 -2
  188. package/docs/src/docs/{misc → _misc}/api-configuration.md +12 -10
  189. package/docs/src/docs/{misc → _misc}/dataProviderKey.md +4 -4
  190. package/docs/{docs/misc → src/docs/_misc}/docs-mock-api.md +13 -12
  191. package/docs/{docs/misc → src/docs/_misc}/dynamic-path.md +8 -8
  192. package/docs/{docs/misc → src/docs/_misc}/endpoint.md +8 -8
  193. package/docs/src/docs/_misc/formelement-subscriber-removal.md +115 -0
  194. package/docs/{docs/misc → src/docs/_misc}/html-integration.md +5 -4
  195. package/docs/src/docs/search/docs-search.json +4375 -2420
  196. package/docs/src/tsconfig.declarations.json +22 -0
  197. package/docs/src/tsconfig.emit.json +23 -0
  198. package/docs/src/tsconfig.json +2 -23
  199. package/gitlab/job_github_mirror.sh +39 -0
  200. package/index.html +89 -0
  201. package/package.json +22 -4
  202. package/public/img/og-concorde.jpg +0 -0
  203. package/scripts/ai-init.mjs +104 -379
  204. package/scripts/ai-init.test.mjs +81 -239
  205. package/scripts/docs-markdown-vite-plugin.ts +11 -5
  206. package/scripts/docs-public-url.mjs +6 -0
  207. package/scripts/docs.htaccess +7 -0
  208. package/scripts/generate-cem.mjs +244 -0
  209. package/scripts/generate-cem.test.mjs +122 -0
  210. package/scripts/generate-crawl-docs.mjs +29 -5
  211. package/scripts/generate-sdui-catalog.mjs +11 -10
  212. package/scripts/github-export.mjs +150 -0
  213. package/scripts/post-build-docs.js +3 -0
  214. package/scripts/post-build.mjs +0 -0
  215. package/scripts/pre-publish.mjs +2 -1
  216. package/scripts/site-pages.mjs +212 -0
  217. package/scripts/site-pages.test.mjs +116 -0
  218. package/site-pages/about.md +22 -0
  219. package/site-pages/privacy.md +32 -0
  220. package/src/core/components/functional/date/date.md +1 -1
  221. package/src/core/components/functional/example/example.ts +3 -1
  222. package/src/core/components/functional/if/if.ts +0 -0
  223. package/src/core/components/functional/list/list.demo.ts +0 -0
  224. package/src/core/components/functional/list/list.md +6 -2
  225. package/src/core/components/functional/list/list.ts +17 -4
  226. package/src/core/components/functional/mix/mix.md +0 -0
  227. package/src/core/components/functional/router/router.demo.ts +0 -0
  228. package/src/core/components/functional/router/router.ts +0 -0
  229. package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
  230. package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
  231. package/src/core/components/functional/sdui/component-catalog.json +2 -2
  232. package/src/core/components/functional/sdui/example.json +0 -0
  233. package/src/core/components/functional/sdui/sdui-immutable.spec.ts +74 -0
  234. package/src/core/components/functional/sdui/sdui.ts +33 -8
  235. package/src/core/components/functional/sdui/types.ts +0 -0
  236. package/src/core/components/functional/states/states.ts +0 -0
  237. package/src/core/components/functional/submit/submit.spec.ts +60 -0
  238. package/src/core/components/functional/submit/submit.ts +6 -3
  239. package/src/core/components/functional/subscriber/subscriber.ts +0 -0
  240. package/src/core/components/functional/value/value.md +0 -0
  241. package/src/core/components/functional/value/value.ts +0 -0
  242. package/src/core/components/ui/_css/size.ts +0 -0
  243. package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
  244. package/src/core/components/ui/card/card.md +1 -1
  245. package/src/core/components/ui/form/input/input.md +19 -1
  246. package/src/core/components/ui/form/input/input.ts +8 -2
  247. package/src/core/components/ui/form/radio/radio.md +14 -0
  248. package/src/core/components/ui/image/image.md +17 -17
  249. package/src/core/components/ui/modal/modal.md +2 -2
  250. package/src/core/decorators/subscriber/bind.ts +9 -14
  251. package/src/core/decorators/subscriber/subscribe.ts +15 -9
  252. package/src/core/decorators/subscriber/subscribe.type-test.ts +14 -5
  253. package/src/core/mixins/Subscriber.ts +0 -0
  254. package/src/core/utils/DataBindObserver.ts +0 -0
  255. package/src/core/utils/Objects.ts +0 -0
  256. package/src/core/utils/PublisherProxy.ts +166 -125
  257. package/src/core/utils/deepReadonly.spec.ts +66 -0
  258. package/src/core/utils/deepReadonly.ts +71 -0
  259. package/src/core/utils/immutableValue.spec.ts +54 -0
  260. package/src/core/utils/immutableValue.ts +102 -0
  261. package/src/core/utils/nestedDotForm.spec.ts +88 -0
  262. package/src/core/utils/publisherImmutable.spec.ts +76 -0
  263. package/src/core/utils/route.ts +0 -0
  264. package/src/core/utils/strictGet.spec.ts +61 -0
  265. package/src/core/utils/strictGet.ts +102 -0
  266. package/src/css.d.ts +19 -0
  267. package/src/docs/components/docs-demo-sources.ts +3 -3
  268. package/src/docs/decorators/bind.md +23 -24
  269. package/src/docs/docs-location.spec.ts +10 -0
  270. package/src/docs/docs-location.ts +10 -0
  271. package/src/docs/example/decorators-demo-bind-demos.ts +11 -28
  272. package/src/docs/example/docs-toggle-demos.ts +1 -1
  273. package/src/docs/example/users.ts +0 -0
  274. package/src/docs/getting-started/ai-agents.md +29 -55
  275. package/src/docs/getting-started/dataFlow.md +2 -2
  276. package/src/docs/home/home.ts +3 -1
  277. package/src/docs/misc/publisher-get-immutability-docs-crawl.json +902 -0
  278. package/src/docs/misc/publisher-get-immutability-docs-recheck.json +13 -0
  279. package/src/docs/misc/publisher-get-immutability-study.md +229 -0
  280. package/src/docs/navigation/navigation.ts +5 -1
  281. package/src/docs/search/docs-search.json +358 -58
  282. package/src/docs/search/markdown-renderer.ts +6 -1
  283. package/src/docs/tailwind/css/docs/content.css +4 -5
  284. package/src/tsconfig.declarations.json +22 -0
  285. package/src/tsconfig.emit.json +23 -0
  286. package/src/tsconfig.json +53 -5
  287. package/src/tsconfig.tsbuildinfo +1 -1
  288. package/.taste-skill/after/desktop-fold.jpg +0 -0
  289. package/.taste-skill/after/desktop-page-01.jpg +0 -0
  290. package/.taste-skill/after/desktop-page-02.jpg +0 -0
  291. package/.taste-skill/after/desktop-page-03.jpg +0 -0
  292. package/.taste-skill/after/mobile-fold.jpg +0 -0
  293. package/.taste-skill/after/mobile-page-01.jpg +0 -0
  294. package/.taste-skill/after/report.json +0 -4103
  295. package/.taste-skill/after/tablet-fold.jpg +0 -0
  296. package/.taste-skill/after/tablet-page-01.jpg +0 -0
  297. package/.taste-skill/after/tablet-page-02.jpg +0 -0
  298. package/.taste-skill/before/desktop-fold.jpg +0 -0
  299. package/.taste-skill/before/desktop-page-01.jpg +0 -0
  300. package/.taste-skill/before/desktop-page-02.jpg +0 -0
  301. package/.taste-skill/before/mobile-fold.jpg +0 -0
  302. package/.taste-skill/before/mobile-page-01.jpg +0 -0
  303. package/.taste-skill/before/report.json +0 -2556
  304. package/.taste-skill/before/tablet-fold.jpg +0 -0
  305. package/.taste-skill/before/tablet-page-01.jpg +0 -0
  306. package/.taste-skill/direction.json +0 -510
  307. package/.taste-skill/notes.md +0 -84
  308. package/.taste-skill/prod/desktop-fold.jpg +0 -0
  309. package/.taste-skill/prod/desktop-page-01.jpg +0 -0
  310. package/.taste-skill/prod/desktop-page-02.jpg +0 -0
  311. package/.taste-skill/prod/desktop-page-03.jpg +0 -0
  312. package/.taste-skill/prod/mobile-fold.jpg +0 -0
  313. package/.taste-skill/prod/mobile-page-01.jpg +0 -0
  314. package/.taste-skill/prod/mobile-page-02.jpg +0 -0
  315. package/.taste-skill/prod/report.json +0 -1973
  316. package/.taste-skill/prod/tablet-fold.jpg +0 -0
  317. package/.taste-skill/prod/tablet-page-01.jpg +0 -0
  318. package/.taste-skill/prod/tablet-page-02.jpg +0 -0
  319. package/AUDIT.md +0 -228
  320. package/PLAN-AMELIORATION.md +0 -220
  321. package/PLAN-DOCS-AGENTS.md +0 -80
  322. package/ai/AGENTS.md +0 -56
  323. package/ai/cursor/rules/concorde-menu.mdc +0 -15
  324. package/ai/cursor/rules/concorde-scope.mdc +0 -14
  325. package/ai/cursor/rules/concorde-theme.mdc +0 -13
  326. package/ai/cursor/rules/concorde.mdc +0 -66
  327. package/ai/jetbrains/rules/concorde.md +0 -53
  328. package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
  329. package/ai/skills/concorde-imports/SKILL.md +0 -78
  330. package/ai/skills/concorde-menu/SKILL.md +0 -74
  331. package/ai/skills/concorde-scope/SKILL.md +0 -70
  332. package/ai/skills/concorde-theme/SKILL.md +0 -57
  333. package/docs/.htaccess +0 -75
  334. package/docs/404.html +0 -15
  335. package/docs/404.md +0 -5
  336. package/docs/assets/index-BgG6FFPt.js +0 -11765
  337. package/docs/assets/index-x89XINSG.css +0 -1
  338. package/docs/core/components/functional/date/date.html +0 -211
  339. package/docs/core/components/functional/date/date.md +0 -150
  340. package/docs/core/components/functional/fetch/fetch.html +0 -180
  341. package/docs/core/components/functional/fetch/fetch.md +0 -108
  342. package/docs/core/components/functional/if/if.html +0 -65
  343. package/docs/core/components/functional/if/if.md +0 -34
  344. package/docs/core/components/functional/jsonata/jsonata.html +0 -110
  345. package/docs/core/components/functional/jsonata/jsonata.md +0 -61
  346. package/docs/core/components/functional/list/list.html +0 -198
  347. package/docs/core/components/functional/list/list.md +0 -121
  348. package/docs/core/components/functional/mix/mix.html +0 -78
  349. package/docs/core/components/functional/mix/mix.md +0 -46
  350. package/docs/core/components/functional/queue/queue.html +0 -155
  351. package/docs/core/components/functional/queue/queue.md +0 -51
  352. package/docs/core/components/functional/router/router.html +0 -154
  353. package/docs/core/components/functional/router/router.md +0 -93
  354. package/docs/core/components/functional/sdui/sdui-extension-points.md +0 -94
  355. package/docs/core/components/functional/sdui/sdui.html +0 -397
  356. package/docs/core/components/functional/sdui/sdui.md +0 -307
  357. package/docs/core/components/functional/states/states.html +0 -141
  358. package/docs/core/components/functional/states/states.md +0 -112
  359. package/docs/core/components/functional/submit/submit.html +0 -178
  360. package/docs/core/components/functional/submit/submit.md +0 -106
  361. package/docs/core/components/functional/subscriber/subscriber.md +0 -91
  362. package/docs/core/components/functional/translation/translation.html +0 -60
  363. package/docs/core/components/functional/translation/translation.md +0 -38
  364. package/docs/core/components/functional/value/value.html +0 -81
  365. package/docs/core/components/functional/value/value.md +0 -47
  366. package/docs/core/components/ui/alert/alert.md +0 -186
  367. package/docs/core/components/ui/alert-messages/alert-messages.md +0 -85
  368. package/docs/core/components/ui/badge/badge.md +0 -181
  369. package/docs/core/components/ui/button/button.html +0 -309
  370. package/docs/core/components/ui/button/button.md +0 -216
  371. package/docs/core/components/ui/captcha/captcha.html +0 -80
  372. package/docs/core/components/ui/captcha/captcha.md +0 -56
  373. package/docs/core/components/ui/card/card.md +0 -215
  374. package/docs/core/components/ui/divider/divider.md +0 -126
  375. package/docs/core/components/ui/form/checkbox/checkbox.html +0 -200
  376. package/docs/core/components/ui/form/checkbox/checkbox.md +0 -125
  377. package/docs/core/components/ui/form/fieldset/fieldset.html +0 -238
  378. package/docs/core/components/ui/form/fieldset/fieldset.md +0 -161
  379. package/docs/core/components/ui/form/form-actions/form-actions.md +0 -98
  380. package/docs/core/components/ui/form/form-layout/form-layout.html +0 -115
  381. package/docs/core/components/ui/form/form-layout/form-layout.md +0 -109
  382. package/docs/core/components/ui/form/input/input.html +0 -235
  383. package/docs/core/components/ui/form/input/input.md +0 -142
  384. package/docs/core/components/ui/form/radio/radio.html +0 -144
  385. package/docs/core/components/ui/form/radio/radio.md +0 -78
  386. package/docs/core/components/ui/form/select/select.html +0 -178
  387. package/docs/core/components/ui/form/select/select.md +0 -86
  388. package/docs/core/components/ui/form/switch/switch.html +0 -146
  389. package/docs/core/components/ui/form/switch/switch.md +0 -80
  390. package/docs/core/components/ui/form/textarea/textarea.html +0 -162
  391. package/docs/core/components/ui/form/textarea/textarea.md +0 -82
  392. package/docs/core/components/ui/group/group.html +0 -113
  393. package/docs/core/components/ui/group/group.md +0 -77
  394. package/docs/core/components/ui/icon/icon.md +0 -214
  395. package/docs/core/components/ui/image/image.html +0 -194
  396. package/docs/core/components/ui/image/image.md +0 -167
  397. package/docs/core/components/ui/link/link.md +0 -81
  398. package/docs/core/components/ui/loader/loader.html +0 -114
  399. package/docs/core/components/ui/loader/loader.md +0 -87
  400. package/docs/core/components/ui/menu/menu.md +0 -370
  401. package/docs/core/components/ui/modal/modal.html +0 -324
  402. package/docs/core/components/ui/modal/modal.md +0 -211
  403. package/docs/core/components/ui/pop/pop.html +0 -250
  404. package/docs/core/components/ui/pop/pop.md +0 -216
  405. package/docs/core/components/ui/progress/progress.md +0 -109
  406. package/docs/core/components/ui/table/table.html +0 -333
  407. package/docs/core/components/ui/table/table.md +0 -267
  408. package/docs/core/components/ui/theme/theme.html +0 -116
  409. package/docs/core/components/ui/theme/theme.md +0 -97
  410. package/docs/core/components/ui/toast/toast.html +0 -185
  411. package/docs/core/components/ui/toast/toast.md +0 -147
  412. package/docs/core/components/ui/tooltip/tooltip.html +0 -112
  413. package/docs/core/components/ui/tooltip/tooltip.md +0 -89
  414. package/docs/docs/decorators/ancestor-attribute.html +0 -71
  415. package/docs/docs/decorators/ancestor-attribute.md +0 -59
  416. package/docs/docs/decorators/auto-subscribe.html +0 -61
  417. package/docs/docs/decorators/auto-subscribe.md +0 -40
  418. package/docs/docs/decorators/bind.html +0 -86
  419. package/docs/docs/decorators/bind.md +0 -77
  420. package/docs/docs/decorators/get.html +0 -166
  421. package/docs/docs/decorators/get.md +0 -160
  422. package/docs/docs/decorators/handle.html +0 -139
  423. package/docs/docs/decorators/handle.md +0 -119
  424. package/docs/docs/decorators/on-assign.html +0 -72
  425. package/docs/docs/decorators/on-assign.md +0 -63
  426. package/docs/docs/decorators/patch.html +0 -76
  427. package/docs/docs/decorators/patch.md +0 -44
  428. package/docs/docs/decorators/post.html +0 -150
  429. package/docs/docs/decorators/post.md +0 -134
  430. package/docs/docs/decorators/publish.html +0 -74
  431. package/docs/docs/decorators/publish.md +0 -56
  432. package/docs/docs/decorators/put.html +0 -83
  433. package/docs/docs/decorators/put.md +0 -51
  434. package/docs/docs/decorators/subscribe.html +0 -91
  435. package/docs/docs/decorators/subscribe.md +0 -87
  436. package/docs/docs/decorators/wait-for-ancestors.html +0 -82
  437. package/docs/docs/decorators/wait-for-ancestors.md +0 -76
  438. package/docs/docs/directives/sub.html +0 -79
  439. package/docs/docs/directives/sub.md +0 -75
  440. package/docs/docs/directives/t.html +0 -91
  441. package/docs/docs/directives/t.md +0 -73
  442. package/docs/docs/getting-started/ai-agents.md +0 -76
  443. package/docs/docs/getting-started/components.html +0 -27
  444. package/docs/docs/getting-started/components.md +0 -5
  445. package/docs/docs/getting-started/installation.html +0 -69
  446. package/docs/docs/getting-started/installation.md +0 -36
  447. package/docs/docs/getting-started/my-first-component.md +0 -227
  448. package/docs/docs/getting-started/start.html +0 -47
  449. package/docs/docs/getting-started/start.md +0 -35
  450. package/docs/docs/getting-started/theming.md +0 -253
  451. package/docs/docs/index.html +0 -99
  452. package/docs/docs/misc/api-configuration.md +0 -79
  453. package/docs/docs/misc/dataProviderKey.md +0 -168
  454. package/docs/hubs/decorators.html +0 -443
  455. package/docs/hubs/form-components.html +0 -404
  456. package/docs/hubs/remote-data.html +0 -371
  457. package/docs/img/archive/concorde-001-2cv.webp +0 -0
  458. package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
  459. package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
  460. package/docs/img/archive/credits.json +0 -28
  461. package/docs/index.md +0 -22
  462. package/docs/src/core/components/functional/translation/translation.md +0 -38
  463. package/docs/src/docs/decorators/ancestor-attribute.md +0 -59
  464. package/docs/src/docs/decorators/auto-subscribe.md +0 -40
  465. package/docs/src/docs/decorators/bind.md +0 -77
  466. package/docs/src/docs/decorators/get.md +0 -160
  467. package/docs/src/docs/decorators/handle.md +0 -119
  468. package/docs/src/docs/decorators/on-assign.md +0 -63
  469. package/docs/src/docs/decorators/patch.md +0 -44
  470. package/docs/src/docs/decorators/post.md +0 -134
  471. package/docs/src/docs/decorators/publish.md +0 -56
  472. package/docs/src/docs/decorators/put.md +0 -51
  473. package/docs/src/docs/decorators/subscribe.md +0 -87
  474. package/docs/src/docs/decorators/wait-for-ancestors.md +0 -76
  475. package/docs/src/docs/directives/sub.md +0 -75
  476. package/docs/src/docs/directives/t.md +0 -73
  477. package/docs/src/docs/getting-started/components.md +0 -5
  478. package/docs/src/docs/getting-started/create-a-component.md +0 -136
  479. package/docs/src/docs/getting-started/dataFlow.md +0 -87
  480. package/docs/src/docs/getting-started/installation.md +0 -36
  481. package/docs/src/docs/misc/docs-mock-api.md +0 -62
  482. package/docs/src/docs/misc/dynamic-path.md +0 -71
  483. package/docs/src/docs/misc/endpoint.md +0 -45
  484. package/docs/src/docs/misc/html-integration.md +0 -14
  485. /package/{docs → dist}/img/concorde/plane_01.jpg +0 -0
  486. /package/{docs → dist}/img/concorde/plane_02.jpg +0 -0
  487. /package/{docs → dist}/img/concorde/plane_03.jpg +0 -0
  488. /package/{docs → dist}/img/concorde/plane_04.jpg +0 -0
  489. /package/{docs → dist}/img/concorde/plane_05.jpg +0 -0
  490. /package/{docs → dist}/img/concorde/plane_06.jpg +0 -0
  491. /package/{docs → dist}/img/concorde/plane_07.jpg +0 -0
  492. /package/{docs → dist}/img/concorde/plane_08.jpg +0 -0
  493. /package/{docs → dist}/img/concorde/plane_09.jpg +0 -0
  494. /package/{docs → dist}/img/concorde/plane_10.jpg +0 -0
  495. /package/{docs → dist}/img/concorde/plane_11.jpg +0 -0
  496. /package/{docs → dist}/img/concorde/plane_12.jpg +0 -0
  497. /package/{docs → dist}/img/concorde/plane_13.jpg +0 -0
package/docs/core/components/ui/tooltip/tooltip.html DELETED
@@ -1,112 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/core/components/ui/tooltip" data-doc-id="core/components/ui/tooltip/tooltip">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>Tooltip — Concorde by Supersoniks</title>
7
- <meta name="description" content="sonic-tooltip shows a short label in a bubble when the trigger in the default slot is hovered or receives focus. With no placement, the bubble sits on top, centered. An empty label hides the bubble, l">
8
- <meta name="keywords" content="Concorde, supersoniks, core/components/ui/tooltip/tooltip, tooltip, Tooltip, UI component, sonic-tooltip, web component, label, placement, top, disabled, bottom, left, right">
9
- <meta name="concorde-doc-id" content="core/components/ui/tooltip/tooltip">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/core/components/ui/tooltip">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/core/components/ui/tooltip.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/ui/tooltip">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 UI component — Tooltip</strong>. sonic-tooltip shows a short label in a bubble when the trigger in the default slot is hovered or receives focus. With no placement, the bubble sits on top, centered. An empty label hides the bubble, l <span>Doc ID: <code>core/components/ui/tooltip/tooltip</code>. Keywords: Concorde, supersoniks, core/components/ui/tooltip/tooltip, tooltip, Tooltip, UI component, sonic-tooltip, web component, label, placement, top, disabled, bottom, left, right. URL: <a href="https://concorde.supersoniks.org/core/components/ui/tooltip">https://concorde.supersoniks.org/core/components/ui/tooltip</a>.</span></p>
20
- <h1 id="tooltip">Tooltip</h1>
21
- <p><strong><code>sonic-tooltip</code></strong> shows a short <code>label</code> in a bubble when the trigger in the default slot is hovered or receives focus. With no <code>placement</code>, the bubble sits on <code>top</code>, centered. An empty <code>label</code> hides the bubble, like <code>disabled</code>.</p>
22
- <h2 id="basic-example">Basic example</h2>
23
- <pre><code>&lt;sonic-tooltip label=&quot;Cruising at Mach 2.04&quot;&gt;
24
- &lt;sonic-button variant=&quot;outline&quot;&gt;Hover me&lt;/sonic-button&gt;
25
- &lt;/sonic-tooltip&gt;
26
- </code></pre>
27
- <h2 id="placement">Placement</h2>
28
- <p><code>top</code> · <code>bottom</code> · <code>left</code> · <code>right</code> set the side. Add <code>-start</code> or <code>-end</code> to align the bubble with an edge of the trigger instead of its center. The bubble is repositioned while open to stay in the viewport.</p>
29
- <pre><code>&lt;div class=&quot;flex flex-wrap gap-3&quot;&gt;
30
- &lt;sonic-tooltip placement=&quot;top&quot; label=&quot;top&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;top&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
31
- &lt;sonic-tooltip placement=&quot;top-start&quot; label=&quot;top-start&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;top-start&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
32
- &lt;sonic-tooltip placement=&quot;top-end&quot; label=&quot;top-end&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;top-end&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
33
- &lt;sonic-tooltip placement=&quot;bottom&quot; label=&quot;bottom&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;bottom&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
34
- &lt;sonic-tooltip placement=&quot;bottom-start&quot; label=&quot;bottom-start&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;bottom-start&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
35
- &lt;sonic-tooltip placement=&quot;bottom-end&quot; label=&quot;bottom-end&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;bottom-end&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
36
- &lt;sonic-tooltip placement=&quot;left&quot; label=&quot;left&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;left&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
37
- &lt;sonic-tooltip placement=&quot;left-start&quot; label=&quot;left-start&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;left-start&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
38
- &lt;sonic-tooltip placement=&quot;left-end&quot; label=&quot;left-end&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;left-end&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
39
- &lt;sonic-tooltip placement=&quot;right&quot; label=&quot;right&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;right&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
40
- &lt;sonic-tooltip placement=&quot;right-start&quot; label=&quot;right-start&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;right-start&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
41
- &lt;sonic-tooltip placement=&quot;right-end&quot; label=&quot;right-end&quot;&gt;&lt;sonic-button minWidth=&quot;9rem&quot;&gt;right-end&lt;/sonic-button&gt;&lt;/sonic-tooltip&gt;
42
- &lt;/div&gt;
43
- </code></pre>
44
- <h2 id="multiline-label">Multiline label</h2>
45
- <p>Line breaks in <code>label</code> (a real newline or <code>&amp;#10;</code>) are kept. Each line is trimmed and the bubble wraps at <code>18rem</code>.</p>
46
- <pre><code>&lt;sonic-tooltip label=&quot;Gate B12&amp;#10;Boarding at 08:15&quot;&gt;
47
- &lt;sonic-button variant=&quot;outline&quot;&gt;Multiline label&lt;/sonic-button&gt;
48
- &lt;/sonic-tooltip&gt;
49
- </code></pre>
50
- <h2 id="focusable">Focusable</h2>
51
- <p>Set <code>focusable</code> when the trigger is not focusable itself (text, icon): the host gets <code>tabindex=&quot;0&quot;</code> so keyboard users can open the tooltip. The bubble uses <code>popover=&quot;hint&quot;</code>; without Popover API support, the label falls back to a native <code>title</code> on one line.</p>
52
- <pre><code>&lt;sonic-tooltip
53
- focusable
54
- label=&quot;The Concorde made its first transatlantic crossing on September 26, 1973&quot;
55
- &gt;
56
- &lt;sonic-icon library=&quot;iconoir&quot; name=&quot;chat-bubble-question&quot;&gt;&lt;/sonic-icon&gt;
57
- Focus or hover this text
58
- &lt;/sonic-tooltip&gt;
59
- </code></pre>
60
- <h2 id="disabled">Disabled</h2>
61
- <p><code>disabled</code> never shows the bubble and sets <code>tabindex=&quot;-1&quot;</code> on the host.</p>
62
- <pre><code>&lt;sonic-tooltip disabled label=&quot;Not shown&quot;&gt;
63
- &lt;sonic-button&gt;Tooltip disabled&lt;/sonic-button&gt;
64
- &lt;/sonic-tooltip&gt;
65
- </code></pre>
66
- <h2 id="api-reference">API reference</h2>
67
- <table>
68
- <thead>
69
- <tr>
70
- <th>Attribute</th>
71
- <th>Values</th>
72
- <th>Description</th>
73
- </tr>
74
- </thead>
75
- <tbody><tr>
76
- <td><code>label</code></td>
77
- <td>string</td>
78
- <td>Tooltip text; empty or whitespace-only hides the bubble</td>
79
- </tr>
80
- <tr>
81
- <td><code>placement</code></td>
82
- <td><code>top</code> (default) · <code>bottom</code> · <code>left</code> · <code>right</code>, each with optional <code>-start</code> · <code>-end</code></td>
83
- <td>Side and alignment relative to the trigger</td>
84
- </tr>
85
- <tr>
86
- <td><code>disabled</code></td>
87
- <td>boolean</td>
88
- <td>Never show the bubble; sets <code>tabindex=&quot;-1&quot;</code> on the host</td>
89
- </tr>
90
- <tr>
91
- <td><code>focusable</code></td>
92
- <td>boolean</td>
93
- <td>Sets <code>tabindex=&quot;0&quot;</code> on the host so the tooltip opens on keyboard focus</td>
94
- </tr>
95
- </tbody></table>
96
- <table>
97
- <thead>
98
- <tr>
99
- <th>Slot</th>
100
- <th>Description</th>
101
- </tr>
102
- </thead>
103
- <tbody><tr>
104
- <td><em>(default)</em></td>
105
- <td>Trigger content</td>
106
- </tr>
107
- </tbody></table>
108
-
109
- </article>
110
- </main>
111
- </body>
112
- </html>
package/docs/core/components/ui/tooltip/tooltip.md DELETED
@@ -1,89 +0,0 @@
1
- # Tooltip
2
-
3
- **`sonic-tooltip`** shows a short `label` in a bubble when the trigger in the default slot is hovered or receives focus. With no `placement`, the bubble sits on `top`, centered. An empty `label` hides the bubble, like `disabled`.
4
-
5
- ## Basic example
6
-
7
- <sonic-code>
8
- <template>
9
- <sonic-tooltip label="Cruising at Mach 2.04">
10
- <sonic-button variant="outline">Hover me</sonic-button>
11
- </sonic-tooltip>
12
- </template>
13
- </sonic-code>
14
-
15
- ## Placement
16
-
17
- `top` · `bottom` · `left` · `right` set the side. Add `-start` or `-end` to align the bubble with an edge of the trigger instead of its center. The bubble is repositioned while open to stay in the viewport.
18
-
19
- <sonic-code>
20
- <template>
21
- <div class="flex flex-wrap gap-3">
22
- <sonic-tooltip placement="top" label="top"><sonic-button minWidth="9rem">top</sonic-button></sonic-tooltip>
23
- <sonic-tooltip placement="top-start" label="top-start"><sonic-button minWidth="9rem">top-start</sonic-button></sonic-tooltip>
24
- <sonic-tooltip placement="top-end" label="top-end"><sonic-button minWidth="9rem">top-end</sonic-button></sonic-tooltip>
25
- <sonic-tooltip placement="bottom" label="bottom"><sonic-button minWidth="9rem">bottom</sonic-button></sonic-tooltip>
26
- <sonic-tooltip placement="bottom-start" label="bottom-start"><sonic-button minWidth="9rem">bottom-start</sonic-button></sonic-tooltip>
27
- <sonic-tooltip placement="bottom-end" label="bottom-end"><sonic-button minWidth="9rem">bottom-end</sonic-button></sonic-tooltip>
28
- <sonic-tooltip placement="left" label="left"><sonic-button minWidth="9rem">left</sonic-button></sonic-tooltip>
29
- <sonic-tooltip placement="left-start" label="left-start"><sonic-button minWidth="9rem">left-start</sonic-button></sonic-tooltip>
30
- <sonic-tooltip placement="left-end" label="left-end"><sonic-button minWidth="9rem">left-end</sonic-button></sonic-tooltip>
31
- <sonic-tooltip placement="right" label="right"><sonic-button minWidth="9rem">right</sonic-button></sonic-tooltip>
32
- <sonic-tooltip placement="right-start" label="right-start"><sonic-button minWidth="9rem">right-start</sonic-button></sonic-tooltip>
33
- <sonic-tooltip placement="right-end" label="right-end"><sonic-button minWidth="9rem">right-end</sonic-button></sonic-tooltip>
34
- </div>
35
- </template>
36
- </sonic-code>
37
-
38
- ## Multiline label
39
-
40
- Line breaks in `label` (a real newline or `&#10;`) are kept. Each line is trimmed and the bubble wraps at `18rem`.
41
-
42
- <sonic-code>
43
- <template>
44
- <sonic-tooltip label="Gate B12&#10;Boarding at 08:15">
45
- <sonic-button variant="outline">Multiline label</sonic-button>
46
- </sonic-tooltip>
47
- </template>
48
- </sonic-code>
49
-
50
- ## Focusable
51
-
52
- Set `focusable` when the trigger is not focusable itself (text, icon): the host gets `tabindex="0"` so keyboard users can open the tooltip. The bubble uses `popover="hint"`; without Popover API support, the label falls back to a native `title` on one line.
53
-
54
- <sonic-code>
55
- <template>
56
- <sonic-tooltip
57
- focusable
58
- label="The Concorde made its first transatlantic crossing on September 26, 1973"
59
- >
60
- <sonic-icon library="iconoir" name="chat-bubble-question"></sonic-icon>
61
- Focus or hover this text
62
- </sonic-tooltip>
63
- </template>
64
- </sonic-code>
65
-
66
- ## Disabled
67
-
68
- `disabled` never shows the bubble and sets `tabindex="-1"` on the host.
69
-
70
- <sonic-code>
71
- <template>
72
- <sonic-tooltip disabled label="Not shown">
73
- <sonic-button>Tooltip disabled</sonic-button>
74
- </sonic-tooltip>
75
- </template>
76
- </sonic-code>
77
-
78
- ## API reference
79
-
80
- | Attribute | Values | Description |
81
- |----------|---------|-------------|
82
- | `label` | string | Tooltip text; empty or whitespace-only hides the bubble |
83
- | `placement` | `top` (default) · `bottom` · `left` · `right`, each with optional `-start` · `-end` | Side and alignment relative to the trigger |
84
- | `disabled` | boolean | Never show the bubble; sets `tabindex="-1"` on the host |
85
- | `focusable` | boolean | Sets `tabindex="0"` on the host so the tooltip opens on keyboard focus |
86
-
87
- | Slot | Description |
88
- |------|-------------|
89
- | *(default)* | Trigger content |
package/docs/docs/decorators/ancestor-attribute.html DELETED
@@ -1,71 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute" data-doc-id="docs/decorators/ancestor-attribute">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>@ancestorAttribute — Concorde by Supersoniks</title>
7
- <meta name="description" content="Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as dataProvid">
8
- <meta name="keywords" content="Concorde, supersoniks, docs/decorators/ancestor-attribute, ancestor-attribute, @ancestorAttribute, decorator, ancestorAttribute, dataProvider, connectedCallback, , &quot;&quot;, dataprovider, { dynamic: true }, null, @state(), &quot;${dataProvider}&quot;">
9
- <meta name="concorde-doc-id" content="docs/decorators/ancestor-attribute">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute.md">
12
- </head>
13
- <body>
14
- <header>
15
- <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute">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 decorator — @ancestorAttribute</strong>. Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as dataProvid <span>Doc ID: <code>docs/decorators/ancestor-attribute</code>. Keywords: Concorde, supersoniks, docs/decorators/ancestor-attribute, ancestor-attribute, @ancestorAttribute, decorator, ancestorAttribute, dataProvider, connectedCallback, , &quot;&quot;, dataprovider, { dynamic: true }, null, @state(), &quot;${dataProvider}&quot;. URL: <a href="https://concorde.supersoniks.org/docs/decorators/ancestor-attribute">https://concorde.supersoniks.org/docs/decorators/ancestor-attribute</a>.</span></p>
20
- <h1 id="ancestorattribute">@ancestorAttribute</h1>
21
- <p>Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as <code>dataProvider</code> without passing it down by hand, typically to feed a dynamic key of <a href="/docs/decorators/subscribe">@subscribe</a>.</p>
22
- <h2 id="import">Import</h2>
23
- <pre><code class="language-typescript">import { ancestorAttribute } from &quot;@supersoniks/concorde/decorators&quot;;
24
-
25
- @ancestorAttribute(&quot;dataProvider&quot;)
26
- dataProvider: string | null = null;
27
- </code></pre>
28
- <h2 id="read-once-at-connect">Read once at connect</h2>
29
- <p>By default the value is read once, just before the component&#39;s <code>connectedCallback</code>, and never updated. The closest element with the attribute wins. If no ancestor has it, the property keeps its initial value.</p>
30
- <pre><code>&lt;div dataProvider=&quot;flights.CN001&quot; gate=&quot;B12&quot;&gt;
31
- &lt;docs-demo-sources for=&quot;demo-ancestor-attribute&quot;&gt;&lt;/docs-demo-sources&gt;
32
- &lt;demo-ancestor-attribute&gt;&lt;/demo-ancestor-attribute&gt;
33
- &lt;/div&gt;
34
- </code></pre>
35
- <p>An attribute present without a value (<code>&lt;div gate&gt;</code>) resolves to <code>&quot;&quot;</code>. A camelCase name also matches its lowercase form (<code>dataProvider</code> and <code>dataprovider</code>).</p>
36
- <h2 id="follow-dom-changes">Follow DOM changes</h2>
37
- <p>With <code>{ dynamic: true }</code>, the property stays in sync while the component is connected: when an ancestor changes the attribute, when a closer ancestor gains or loses it, and when the component is moved. When no ancestor has the attribute, the property becomes <code>null</code>. Add <code>@state()</code> so Lit re-renders on each assignment.</p>
38
- <pre><code class="language-typescript">@ancestorAttribute(&quot;dataProvider&quot;, { dynamic: true })
39
- @state()
40
- dataProvider: string | null = null;
41
- </code></pre>
42
- <p>Change the parent or outer value, insert a closer wrapper, or remove an attribute: the child always shows the nearest one.</p>
43
- <pre><code>&lt;docs-demo-sources for=&quot;demo-ancestor-attribute-dynamic-section&quot;&gt;&lt;/docs-demo-sources&gt;
44
- &lt;demo-ancestor-attribute-dynamic-section&gt;&lt;/demo-ancestor-attribute-dynamic-section&gt;
45
- </code></pre>
46
- <p>Keys of <a href="/docs/decorators/subscribe">@subscribe</a> and <a href="/docs/decorators/bind">@bind</a> that use the property as a placeholder (<code>&quot;${dataProvider}&quot;</code>) are re-resolved on each change.</p>
47
- <h2 id="api-reference">API reference</h2>
48
- <table>
49
- <thead>
50
- <tr>
51
- <th>Argument</th>
52
- <th>Type</th>
53
- <th>Description</th>
54
- </tr>
55
- </thead>
56
- <tbody><tr>
57
- <td><code>attributeName</code></td>
58
- <td><code>string</code></td>
59
- <td>Attribute to look up on the host, then on its ancestors</td>
60
- </tr>
61
- <tr>
62
- <td><code>options.dynamic</code></td>
63
- <td><code>boolean</code> (default <code>false</code>)</td>
64
- <td>Keep the property in sync with attribute changes and reparenting until disconnect; assigns <code>null</code> when no ancestor has the attribute</td>
65
- </tr>
66
- </tbody></table>
67
-
68
- </article>
69
- </main>
70
- </body>
71
- </html>
package/docs/docs/decorators/ancestor-attribute.md DELETED
@@ -1,59 +0,0 @@
1
- # @ancestorAttribute
2
-
3
- Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as `dataProvider` without passing it down by hand, typically to feed a dynamic key of [@subscribe](/docs/decorators/subscribe).
4
-
5
- ## Import
6
-
7
- <sonic-code language="typescript">
8
- <template>
9
- import { ancestorAttribute } from "@supersoniks/concorde/decorators";
10
-
11
- @ancestorAttribute("dataProvider")
12
- dataProvider: string | null = null;
13
- </template>
14
- </sonic-code>
15
-
16
- ## Read once at connect
17
-
18
- By default the value is read once, just before the component's `connectedCallback`, and never updated. The closest element with the attribute wins. If no ancestor has it, the property keeps its initial value.
19
-
20
- <sonic-code>
21
- <template>
22
- <div dataProvider="flights.CN001" gate="B12">
23
- <docs-demo-sources for="demo-ancestor-attribute"></docs-demo-sources>
24
- <demo-ancestor-attribute></demo-ancestor-attribute>
25
- </div>
26
- </template>
27
- </sonic-code>
28
-
29
- An attribute present without a value (`<div gate>`) resolves to `""`. A camelCase name also matches its lowercase form (`dataProvider` and `dataprovider`).
30
-
31
- ## Follow DOM changes
32
-
33
- With `{ dynamic: true }`, the property stays in sync while the component is connected: when an ancestor changes the attribute, when a closer ancestor gains or loses it, and when the component is moved. When no ancestor has the attribute, the property becomes `null`. Add `@state()` so Lit re-renders on each assignment.
34
-
35
- <sonic-code language="typescript">
36
- <template>
37
- @ancestorAttribute("dataProvider", { dynamic: true })
38
- @state()
39
- dataProvider: string | null = null;
40
- </template>
41
- </sonic-code>
42
-
43
- Change the parent or outer value, insert a closer wrapper, or remove an attribute: the child always shows the nearest one.
44
-
45
- <sonic-code>
46
- <template>
47
- <docs-demo-sources for="demo-ancestor-attribute-dynamic-section"></docs-demo-sources>
48
- <demo-ancestor-attribute-dynamic-section></demo-ancestor-attribute-dynamic-section>
49
- </template>
50
- </sonic-code>
51
-
52
- Keys of [@subscribe](/docs/decorators/subscribe) and [@bind](/docs/decorators/bind) that use the property as a placeholder (`"${dataProvider}"`) are re-resolved on each change.
53
-
54
- ## API reference
55
-
56
- | Argument | Type | Description |
57
- |----------|------|-------------|
58
- | `attributeName` | `string` | Attribute to look up on the host, then on its ancestors |
59
- | `options.dynamic` | `boolean` (default `false`) | Keep the property in sync with attribute changes and reparenting until disconnect; assigns `null` when no ancestor has the attribute |
package/docs/docs/decorators/auto-subscribe.html DELETED
@@ -1,61 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/auto-subscribe" data-doc-id="docs/decorators/auto-subscribe">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>@autoSubscribe — Concorde by Supersoniks</title>
7
- <meta name="description" content="Legacy decorator that re-runs a method whenever one of the store values it reads is assigned. For new code, prefer @subscribe with a DataProviderKey: dependencies are explicit and typed.">
8
- <meta name="keywords" content="Concorde, supersoniks, docs/decorators/auto-subscribe, auto-subscribe, @autoSubscribe, decorator, autoSubscribe, DataProviderKey, connectedCallback, @state(), requestUpdate(), queueMicrotask, disconnectedCallback, @autoSubscribe()">
9
- <meta name="concorde-doc-id" content="docs/decorators/auto-subscribe">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/auto-subscribe">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/auto-subscribe.md">
12
- </head>
13
- <body>
14
- <header>
15
- <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/decorators/auto-subscribe">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 decorator — @autoSubscribe</strong>. Legacy decorator that re-runs a method whenever one of the store values it reads is assigned. For new code, prefer @subscribe with a DataProviderKey: dependencies are explicit and typed. <span>Doc ID: <code>docs/decorators/auto-subscribe</code>. Keywords: Concorde, supersoniks, docs/decorators/auto-subscribe, auto-subscribe, @autoSubscribe, decorator, autoSubscribe, DataProviderKey, connectedCallback, @state(), requestUpdate(), queueMicrotask, disconnectedCallback, @autoSubscribe(). URL: <a href="https://concorde.supersoniks.org/docs/decorators/auto-subscribe">https://concorde.supersoniks.org/docs/decorators/auto-subscribe</a>.</span></p>
20
- <h1 id="autosubscribe">@autoSubscribe</h1>
21
- <p>Legacy decorator that re-runs a method whenever one of the store values it reads is assigned. For new code, prefer <a href="/docs/decorators/subscribe">@subscribe</a> with a <a href="/docs/misc/dataProviderKey"><code>DataProviderKey</code></a>: dependencies are explicit and typed.</p>
22
- <h2 id="import">Import</h2>
23
- <pre><code class="language-typescript">import { autoSubscribe } from &quot;@supersoniks/concorde/decorators&quot;;
24
- import { get } from &quot;@supersoniks/concorde/utils&quot;;
25
-
26
- @autoSubscribe()
27
- updateDisplay() {
28
- this.total = get(passengersKey) + get(crewKey);
29
- }
30
- </code></pre>
31
- <h2 id="tracked-reads">Tracked reads</h2>
32
- <p>The method runs once after <code>connectedCallback</code>. Every store value read during that run becomes a dependency; assigning any of them runs the method again. Write the result to a <code>@state()</code> property (or call <code>requestUpdate()</code>) so the component re-renders.</p>
33
- <pre><code>&lt;docs-demo-sources for=&quot;demo-auto-subscribe&quot;&gt;&lt;/docs-demo-sources&gt;
34
- &lt;demo-auto-subscribe&gt;&lt;/demo-auto-subscribe&gt;
35
- </code></pre>
36
- <h2 id="notes">Notes</h2>
37
- <ul>
38
- <li>Several assignments in the same task trigger a single re-run (batched with <code>queueMicrotask</code>).</li>
39
- <li>Keep reads unconditional: a value read only behind a condition becomes a dependency the first time that branch runs.</li>
40
- <li>Subscriptions are removed in <code>disconnectedCallback</code>.</li>
41
- </ul>
42
- <h2 id="api-reference">API reference</h2>
43
- <table>
44
- <thead>
45
- <tr>
46
- <th>Argument</th>
47
- <th>Type</th>
48
- <th>Description</th>
49
- </tr>
50
- </thead>
51
- <tbody><tr>
52
- <td>none</td>
53
- <td></td>
54
- <td><code>@autoSubscribe()</code> takes no argument; apply it to a method of a custom element</td>
55
- </tr>
56
- </tbody></table>
57
-
58
- </article>
59
- </main>
60
- </body>
61
- </html>
package/docs/docs/decorators/auto-subscribe.md DELETED
@@ -1,40 +0,0 @@
1
- # @autoSubscribe
2
-
3
- Legacy decorator that re-runs a method whenever one of the store values it reads is assigned. For new code, prefer [@subscribe](/docs/decorators/subscribe) with a [`DataProviderKey`](/docs/misc/dataProviderKey): dependencies are explicit and typed.
4
-
5
- ## Import
6
-
7
- <sonic-code language="typescript">
8
- <template>
9
- import { autoSubscribe } from "@supersoniks/concorde/decorators";
10
- import { get } from "@supersoniks/concorde/utils";
11
-
12
- @autoSubscribe()
13
- updateDisplay() {
14
- this.total = get(passengersKey) + get(crewKey);
15
- }
16
- </template>
17
- </sonic-code>
18
-
19
- ## Tracked reads
20
-
21
- The method runs once after `connectedCallback`. Every store value read during that run becomes a dependency; assigning any of them runs the method again. Write the result to a `@state()` property (or call `requestUpdate()`) so the component re-renders.
22
-
23
- <sonic-code>
24
- <template>
25
- <docs-demo-sources for="demo-auto-subscribe"></docs-demo-sources>
26
- <demo-auto-subscribe></demo-auto-subscribe>
27
- </template>
28
- </sonic-code>
29
-
30
- ## Notes
31
-
32
- - Several assignments in the same task trigger a single re-run (batched with `queueMicrotask`).
33
- - Keep reads unconditional: a value read only behind a condition becomes a dependency the first time that branch runs.
34
- - Subscriptions are removed in `disconnectedCallback`.
35
-
36
- ## API reference
37
-
38
- | Argument | Type | Description |
39
- |----------|------|-------------|
40
- | none | | `@autoSubscribe()` takes no argument; apply it to a method of a custom element |
package/docs/docs/decorators/bind.html DELETED
@@ -1,86 +0,0 @@
1
- <!DOCTYPE html>
2
- <html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/decorators/bind" data-doc-id="docs/decorators/bind">
3
- <head>
4
- <meta charset="UTF-8">
5
- <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
- <title>@bind — Concorde by Supersoniks</title>
7
- <meta name="description" content="Keeps a class property in sync with a path of the DataProvider store, in both directions when needed. Pass a dot-notation string or a DataProviderKey; add { reflect: true } to push local writes back t">
8
- <meta name="keywords" content="Concorde, supersoniks, docs/decorators/bind, bind, @bind, decorator, { reflect: true }, passengers.0, @state(), DataProviderKey, reflect: false, reflect: true, set(), ${index}, null">
9
- <meta name="concorde-doc-id" content="docs/decorators/bind">
10
- <link rel="canonical" href="https://concorde.supersoniks.org/docs/decorators/bind">
11
- <link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/decorators/bind.md">
12
- </head>
13
- <body>
14
- <header>
15
- <p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/decorators/bind">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 decorator — @bind</strong>. Keeps a class property in sync with a path of the DataProvider store, in both directions when needed. Pass a dot-notation string or a DataProviderKey; add { reflect: true } to push local writes back t <span>Doc ID: <code>docs/decorators/bind</code>. Keywords: Concorde, supersoniks, docs/decorators/bind, bind, @bind, decorator, { reflect: true }, passengers.0, @state(), DataProviderKey, reflect: false, reflect: true, set(), ${index}, null. URL: <a href="https://concorde.supersoniks.org/docs/decorators/bind">https://concorde.supersoniks.org/docs/decorators/bind</a>.</span></p>
20
- <h1 id="bind">@bind</h1>
21
- <p>Keeps a class property in sync with a path of the DataProvider store, in both directions when needed. Pass a dot-notation string or a <a href="/docs/misc/dataProviderKey">DataProviderKey</a>; add <code>{ reflect: true }</code> to push local writes back to the store. For read-only sync prefer <a href="/docs/decorators/subscribe">@subscribe</a>, and see <a href="/docs/getting-started/dataFlow">Data flow</a> for the overall model.</p>
22
- <h2 id="import">Import</h2>
23
- <pre><code class="language-typescript">import { bind } from &quot;@supersoniks/concorde/decorators&quot;;
24
-
25
- @bind(&quot;flight.gate&quot;)
26
- @state()
27
- gate = &quot;&quot;;
28
- </code></pre>
29
- <h2 id="basic-usage">Basic usage</h2>
30
- <p>The first path segment is the data provider id, the rest is dot notation (array items use a numeric index: <code>passengers.0</code>). The property updates each time the store value changes. Add <code>@state()</code> so Lit re-renders.</p>
31
- <pre><code>&lt;docs-demo-sources for=&quot;demo-bind&quot;&gt;&lt;/docs-demo-sources&gt;
32
- &lt;demo-bind&gt;&lt;/demo-bind&gt;
33
- </code></pre>
34
- <h2 id="typed-key">Typed key</h2>
35
- <p>With a <code>DataProviderKey&lt;T&gt;</code>, TypeScript checks that the property type matches <code>T</code> at that path.</p>
36
- <pre><code class="language-typescript">import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
37
-
38
- type Flight = { flight: string; gate: string; boarded: number };
39
- const flightKey = new DataProviderKey&amp;lt;Flight&amp;gt;(&quot;flight&quot;);
40
-
41
- @bind(flightKey.boarded, { reflect: true })
42
- @state()
43
- boarded = 0;
44
- </code></pre>
45
- <h2 id="reflect">Reflect</h2>
46
- <p>By default (<code>reflect: false</code>) the binding is one-way: assigning the property does not touch the store. With <code>reflect: true</code>, each assignment calls <code>set()</code> on the publisher, so every other subscriber sees the new value. An internal guard prevents update loops.</p>
47
- <pre><code>&lt;docs-demo-sources for=&quot;demo-bind-reflect&quot;&gt;&lt;/docs-demo-sources&gt;
48
- &lt;demo-bind-reflect&gt;&lt;/demo-bind-reflect&gt;
49
- </code></pre>
50
- <h2 id="dynamic-path">Dynamic path</h2>
51
- <p>Placeholders such as <code>${index}</code> are resolved from properties of the same component, and <code>@bind</code> re-subscribes when they change. Write them in a plain string, not a backtick template literal. While a placeholder is <code>null</code> or <code>undefined</code> the binding is inactive; <code>{ skipEmptyPlaceholder: true }</code> also waits on <code>&quot;&quot;</code>. Full rules: <a href="/docs/misc/dynamic-path">Dynamic paths</a>.</p>
52
- <pre><code>&lt;docs-demo-sources for=&quot;demo-bind-dynamic&quot;&gt;&lt;/docs-demo-sources&gt;
53
- &lt;demo-bind-dynamic&gt;&lt;/demo-bind-dynamic&gt;
54
- </code></pre>
55
- <h2 id="lifecycle">Lifecycle</h2>
56
- <p>The decorator subscribes in <code>connectedCallback</code> and unsubscribes in <code>disconnectedCallback</code>. It works on any element with that lifecycle (<code>LitElement</code>, the <code>Subscriber</code> mixin).</p>
57
- <h2 id="api-reference">API reference</h2>
58
- <table>
59
- <thead>
60
- <tr>
61
- <th>Argument</th>
62
- <th>Type</th>
63
- <th>Description</th>
64
- </tr>
65
- </thead>
66
- <tbody><tr>
67
- <td><code>path</code></td>
68
- <td><code>string</code> or <code>DataProviderKey&lt;T&gt;</code></td>
69
- <td>Store path to bind. Supports <code>${prop}</code> placeholders</td>
70
- </tr>
71
- <tr>
72
- <td><code>options.reflect</code></td>
73
- <td><code>boolean</code> (default <code>false</code>)</td>
74
- <td>Write local assignments back to the store</td>
75
- </tr>
76
- <tr>
77
- <td><code>options.skipEmptyPlaceholder</code></td>
78
- <td><code>boolean</code> (default <code>false</code>)</td>
79
- <td>Treat a placeholder resolved to <code>&quot;&quot;</code> as not ready</td>
80
- </tr>
81
- </tbody></table>
82
-
83
- </article>
84
- </main>
85
- </body>
86
- </html>
package/docs/docs/decorators/bind.md DELETED
@@ -1,77 +0,0 @@
1
- # @bind
2
-
3
- Keeps a class property in sync with a path of the DataProvider store, in both directions when needed. Pass a dot-notation string or a [DataProviderKey](/docs/misc/dataProviderKey); add `{ reflect: true }` to push local writes back to the store. For read-only sync prefer [@subscribe](/docs/decorators/subscribe), and see [Data flow](/docs/getting-started/dataFlow) for the overall model.
4
-
5
- ## Import
6
-
7
- <sonic-code language="typescript">
8
- <template>
9
- import { bind } from "@supersoniks/concorde/decorators";
10
-
11
- @bind("flight.gate")
12
- @state()
13
- gate = "";
14
- </template>
15
- </sonic-code>
16
-
17
- ## Basic usage
18
-
19
- The first path segment is the data provider id, the rest is dot notation (array items use a numeric index: `passengers.0`). The property updates each time the store value changes. Add `@state()` so Lit re-renders.
20
-
21
- <sonic-code>
22
- <template>
23
- <docs-demo-sources for="demo-bind"></docs-demo-sources>
24
- <demo-bind></demo-bind>
25
- </template>
26
- </sonic-code>
27
-
28
- ## Typed key
29
-
30
- With a `DataProviderKey<T>`, TypeScript checks that the property type matches `T` at that path.
31
-
32
- <sonic-code language="typescript">
33
- <template>
34
- import { DataProviderKey } from "@supersoniks/concorde/dataProviderKey";
35
-
36
- type Flight = { flight: string; gate: string; boarded: number };
37
- const flightKey = new DataProviderKey&lt;Flight&gt;("flight");
38
-
39
- @bind(flightKey.boarded, { reflect: true })
40
- @state()
41
- boarded = 0;
42
- </template>
43
- </sonic-code>
44
-
45
- ## Reflect
46
-
47
- By default (`reflect: false`) the binding is one-way: assigning the property does not touch the store. With `reflect: true`, each assignment calls `set()` on the publisher, so every other subscriber sees the new value. An internal guard prevents update loops.
48
-
49
- <sonic-code>
50
- <template>
51
- <docs-demo-sources for="demo-bind-reflect"></docs-demo-sources>
52
- <demo-bind-reflect></demo-bind-reflect>
53
- </template>
54
- </sonic-code>
55
-
56
- ## Dynamic path
57
-
58
- Placeholders such as `${index}` are resolved from properties of the same component, and `@bind` re-subscribes when they change. Write them in a plain string, not a backtick template literal. While a placeholder is `null` or `undefined` the binding is inactive; `{ skipEmptyPlaceholder: true }` also waits on `""`. Full rules: [Dynamic paths](/docs/misc/dynamic-path).
59
-
60
- <sonic-code>
61
- <template>
62
- <docs-demo-sources for="demo-bind-dynamic"></docs-demo-sources>
63
- <demo-bind-dynamic></demo-bind-dynamic>
64
- </template>
65
- </sonic-code>
66
-
67
- ## Lifecycle
68
-
69
- The decorator subscribes in `connectedCallback` and unsubscribes in `disconnectedCallback`. It works on any element with that lifecycle (`LitElement`, the `Subscriber` mixin).
70
-
71
- ## API reference
72
-
73
- | Argument | Type | Description |
74
- |----------|------|-------------|
75
- | `path` | `string` or `DataProviderKey<T>` | Store path to bind. Supports `${prop}` placeholders |
76
- | `options.reflect` | `boolean` (default `false`) | Write local assignments back to the store |
77
- | `options.skipEmptyPlaceholder` | `boolean` (default `false`) | Treat a placeholder resolved to `""` as not ready |