@supersoniks/concorde 5.1.1 → 5.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.agents/skills/concorde-docs/SKILL.md +153 -0
- package/.agents/skills/{concorde-component-docs/template.md → concorde-docs/templates/component.md} +6 -2
- package/.agents/skills/concorde-docs/templates/decorator.md +43 -0
- package/.agents/skills/concorde-docs/templates/guide.md +25 -0
- package/PLAN-DOCS-AGENTS.md +80 -0
- package/README.md +4 -4
- package/ai/README.md +29 -41
- package/ai/skills/concorde/SKILL.md +54 -324
- package/ai/skills/concorde/rules/composition.md +32 -0
- package/ai/skills/concorde/rules/data.md +47 -0
- package/ai/skills/concorde/rules/http.md +25 -0
- package/ai/skills/concorde/rules/lists-forms.md +35 -0
- package/ai/skills/concorde/rules/styling.md +46 -0
- package/ai/skills/concorde/rules/troubleshooting.md +45 -0
- package/build-infos.json +1 -1
- package/concorde-core.bundle.js +21 -21
- package/concorde-core.es.js +977 -980
- package/custom-elements-manifest.public.config.mjs +8 -0
- package/{.tmp-cem/custom-elements.json → custom-elements.json} +11758 -8904
- package/dist/concorde-core.bundle.js +21 -21
- package/dist/concorde-core.es.js +977 -980
- package/dist/docs-mock-api-sw.js +58 -223
- package/dist/docs-mock-api-sw.js.map +4 -4
- package/dist/img/concorde/plane_01.jpg +0 -0
- package/dist/img/concorde/plane_02.jpg +0 -0
- package/dist/img/concorde/plane_03.jpg +0 -0
- package/dist/img/concorde/plane_04.jpg +0 -0
- package/dist/img/concorde/plane_05.jpg +0 -0
- package/dist/img/concorde/plane_06.jpg +0 -0
- package/dist/img/concorde/plane_07.jpg +0 -0
- package/dist/img/concorde/plane_08.jpg +0 -0
- package/dist/img/concorde/plane_09.jpg +0 -0
- package/dist/img/concorde/plane_10.jpg +0 -0
- package/dist/img/concorde/plane_11.jpg +0 -0
- package/dist/img/concorde/plane_12.jpg +0 -0
- package/dist/img/concorde/plane_13.jpg +0 -0
- package/dist/img/og-concorde.jpg +0 -0
- package/dist/robots.txt +11 -10
- package/docs/.htaccess +82 -0
- package/docs/404.html +15 -0
- package/docs/404.md +5 -0
- package/docs/about.html +111 -0
- package/docs/about.md +22 -0
- package/docs/assets/{index-Bb-_LRyY.js → index-6sS76xWj.js} +2625 -3158
- package/docs/assets/index-DkdPbH0F.css +1 -0
- package/docs/core/components/functional/date/date.html +211 -0
- package/docs/core/components/functional/date/date.md +150 -0
- package/docs/core/components/functional/fetch/fetch.html +180 -0
- package/docs/core/components/functional/fetch/fetch.md +108 -0
- package/docs/core/components/functional/if/if.html +65 -0
- package/docs/core/components/functional/if/if.md +34 -0
- package/docs/core/components/functional/jsonata/jsonata.html +110 -0
- package/docs/core/components/functional/jsonata/jsonata.md +61 -0
- package/docs/core/components/functional/list/list.html +200 -0
- package/docs/core/components/functional/list/list.md +125 -0
- package/docs/core/components/functional/mix/mix.html +78 -0
- package/docs/core/components/functional/mix/mix.md +46 -0
- package/docs/core/components/functional/queue/queue.html +155 -0
- package/docs/core/components/functional/queue/queue.md +51 -0
- package/docs/core/components/functional/router/router.html +154 -0
- package/docs/core/components/functional/router/router.md +93 -0
- package/docs/core/components/functional/sdui/sdui-extension-points.html +127 -0
- package/docs/core/components/functional/sdui/sdui-extension-points.md +94 -0
- package/docs/core/components/functional/sdui/sdui.html +397 -0
- package/docs/core/components/functional/sdui/sdui.md +307 -0
- package/docs/core/components/functional/states/states.html +141 -0
- package/docs/core/components/functional/states/states.md +112 -0
- package/docs/core/components/functional/submit/submit.html +178 -0
- package/docs/core/components/functional/submit/submit.md +106 -0
- package/docs/core/components/functional/subscriber/subscriber.html +68 -0
- package/docs/core/components/functional/subscriber/subscriber.md +91 -0
- package/docs/core/components/functional/translation/translation.html +60 -0
- package/docs/core/components/functional/translation/translation.md +38 -0
- package/docs/core/components/functional/value/value.html +81 -0
- package/docs/core/components/functional/value/value.md +47 -0
- package/docs/core/components/ui/alert/alert.html +201 -0
- package/docs/core/components/ui/alert/alert.md +186 -0
- package/docs/core/components/ui/alert-messages/alert-messages.html +132 -0
- package/docs/core/components/ui/alert-messages/alert-messages.md +85 -0
- package/docs/core/components/ui/badge/badge.html +197 -0
- package/docs/core/components/ui/badge/badge.md +181 -0
- package/docs/core/components/ui/button/button.html +309 -0
- package/docs/core/components/ui/button/button.md +216 -0
- package/docs/core/components/ui/captcha/captcha.html +80 -0
- package/docs/core/components/ui/captcha/captcha.md +56 -0
- package/docs/core/components/ui/card/card.html +254 -0
- package/docs/core/components/ui/card/card.md +215 -0
- package/docs/core/components/ui/divider/divider.html +144 -0
- package/docs/core/components/ui/divider/divider.md +126 -0
- package/docs/core/components/ui/form/checkbox/checkbox.html +200 -0
- package/docs/core/components/ui/form/checkbox/checkbox.md +125 -0
- package/docs/core/components/ui/form/fieldset/fieldset.html +238 -0
- package/docs/core/components/ui/form/fieldset/fieldset.md +161 -0
- package/docs/core/components/ui/form/form-actions/form-actions.html +122 -0
- package/docs/core/components/ui/form/form-actions/form-actions.md +98 -0
- package/docs/core/components/ui/form/form-layout/form-layout.html +115 -0
- package/docs/core/components/ui/form/form-layout/form-layout.md +109 -0
- package/docs/core/components/ui/form/input/input.html +235 -0
- package/docs/core/components/ui/form/input/input.md +142 -0
- package/docs/core/components/ui/form/radio/radio.html +144 -0
- package/docs/core/components/ui/form/radio/radio.md +78 -0
- package/docs/core/components/ui/form/select/select.html +178 -0
- package/docs/core/components/ui/form/select/select.md +86 -0
- package/docs/core/components/ui/form/switch/switch.html +146 -0
- package/docs/core/components/ui/form/switch/switch.md +80 -0
- package/docs/core/components/ui/form/textarea/textarea.html +162 -0
- package/docs/core/components/ui/form/textarea/textarea.md +82 -0
- package/docs/core/components/ui/group/group.html +113 -0
- package/docs/core/components/ui/group/group.md +77 -0
- package/docs/core/components/ui/icon/icon.html +223 -0
- package/docs/core/components/ui/icon/icon.md +214 -0
- package/docs/core/components/ui/image/image.html +194 -0
- package/docs/core/components/ui/image/image.md +167 -0
- package/docs/core/components/ui/link/link.html +101 -0
- package/docs/core/components/ui/link/link.md +81 -0
- package/docs/core/components/ui/loader/loader.html +114 -0
- package/docs/core/components/ui/loader/loader.md +87 -0
- package/docs/core/components/ui/menu/menu.html +395 -0
- package/docs/core/components/ui/menu/menu.md +370 -0
- package/docs/core/components/ui/modal/modal.html +324 -0
- package/docs/core/components/ui/modal/modal.md +211 -0
- package/docs/core/components/ui/pop/pop.html +250 -0
- package/docs/core/components/ui/pop/pop.md +216 -0
- package/docs/core/components/ui/progress/progress.html +132 -0
- package/docs/core/components/ui/progress/progress.md +109 -0
- package/docs/core/components/ui/table/table.html +333 -0
- package/docs/core/components/ui/table/table.md +267 -0
- package/docs/core/components/ui/theme/theme.html +116 -0
- package/docs/core/components/ui/theme/theme.md +97 -0
- package/docs/core/components/ui/toast/toast.html +185 -0
- package/docs/core/components/ui/toast/toast.md +147 -0
- package/docs/core/components/ui/tooltip/tooltip.html +112 -0
- package/docs/core/components/ui/tooltip/tooltip.md +89 -0
- package/docs/custom-elements.json +16559 -0
- package/docs/docs/decorators/ancestor-attribute.html +71 -0
- package/docs/docs/decorators/ancestor-attribute.md +59 -0
- package/docs/docs/decorators/auto-subscribe.html +61 -0
- package/docs/docs/decorators/auto-subscribe.md +40 -0
- package/docs/docs/decorators/bind.html +87 -0
- package/docs/docs/decorators/bind.md +76 -0
- package/docs/docs/decorators/get.html +166 -0
- package/docs/docs/decorators/get.md +160 -0
- package/docs/docs/decorators/handle.html +139 -0
- package/docs/docs/decorators/handle.md +119 -0
- package/docs/docs/decorators/on-assign.html +72 -0
- package/docs/docs/decorators/on-assign.md +63 -0
- package/docs/docs/decorators/patch.html +76 -0
- package/docs/docs/decorators/patch.md +44 -0
- package/docs/docs/decorators/post.html +150 -0
- package/docs/docs/decorators/post.md +134 -0
- package/docs/docs/decorators/publish.html +74 -0
- package/docs/docs/decorators/publish.md +56 -0
- package/docs/docs/decorators/put.html +83 -0
- package/docs/docs/decorators/put.md +51 -0
- package/docs/docs/decorators/subscribe.html +91 -0
- package/docs/docs/decorators/subscribe.md +87 -0
- package/docs/docs/decorators/wait-for-ancestors.html +82 -0
- package/docs/docs/decorators/wait-for-ancestors.md +76 -0
- package/docs/docs/directives/sub.html +79 -0
- package/docs/docs/directives/sub.md +75 -0
- package/docs/docs/directives/t.html +91 -0
- package/docs/docs/directives/t.md +73 -0
- package/docs/docs/getting-started/ai-agents.html +130 -0
- package/docs/docs/getting-started/ai-agents.md +50 -0
- package/docs/docs/getting-started/components.html +27 -0
- package/docs/docs/getting-started/create-a-component.html +108 -0
- package/{src/docs/_getting-started → docs/docs/getting-started}/create-a-component.md +3 -6
- package/docs/docs/getting-started/dataFlow.html +174 -0
- package/{src/docs/_core-concept → docs/docs/getting-started}/dataFlow.md +18 -19
- package/docs/docs/getting-started/installation.html +69 -0
- package/docs/docs/getting-started/installation.md +36 -0
- package/docs/docs/getting-started/my-first-component.html +180 -0
- package/{src/docs/_getting-started → docs/docs/getting-started}/my-first-component.md +5 -14
- package/docs/docs/getting-started/start.html +47 -0
- package/{src/docs/_getting-started → docs/docs/getting-started}/start.md +1 -13
- package/docs/docs/getting-started/theming.html +334 -0
- package/docs/docs/index.html +99 -0
- package/docs/docs/misc/api-configuration.html +149 -0
- package/{src/docs/_misc → docs/docs/misc}/api-configuration.md +10 -12
- package/docs/docs/misc/dataProviderKey.html +136 -0
- package/{src/docs/_misc → docs/docs/misc}/dataProviderKey.md +4 -4
- package/docs/docs/misc/docs-mock-api.html +155 -0
- package/{src/docs/_misc → docs/docs/misc}/docs-mock-api.md +12 -13
- package/docs/docs/misc/dynamic-path.html +181 -0
- package/{src/docs/_misc → docs/docs/misc}/dynamic-path.md +8 -8
- package/docs/docs/misc/endpoint.html +51 -0
- package/{src/docs/_misc → docs/docs/misc}/endpoint.md +8 -8
- package/docs/docs/misc/html-integration.html +45 -0
- package/{src/docs/_misc → docs/docs/misc}/html-integration.md +4 -5
- package/docs/docs-mock-api-sw.js +58 -223
- package/docs/docs-mock-api-sw.js.map +4 -4
- package/docs/hubs/decorators.html +438 -0
- package/docs/hubs/form-components.html +404 -0
- package/docs/hubs/remote-data.html +367 -0
- package/docs/img/archive/concorde-001-2cv.webp +0 -0
- package/docs/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
- package/docs/img/archive/concorde-red-arrows-2002.webm +0 -0
- package/docs/img/archive/credits.json +28 -0
- package/docs/img/concorde/plane_01.jpg +0 -0
- package/docs/img/concorde/plane_02.jpg +0 -0
- package/docs/img/concorde/plane_03.jpg +0 -0
- package/docs/img/concorde/plane_04.jpg +0 -0
- package/docs/img/concorde/plane_05.jpg +0 -0
- package/docs/img/concorde/plane_06.jpg +0 -0
- package/docs/img/concorde/plane_07.jpg +0 -0
- package/docs/img/concorde/plane_08.jpg +0 -0
- package/docs/img/concorde/plane_09.jpg +0 -0
- package/docs/img/concorde/plane_10.jpg +0 -0
- package/docs/img/concorde/plane_11.jpg +0 -0
- package/docs/img/concorde/plane_12.jpg +0 -0
- package/docs/img/concorde/plane_13.jpg +0 -0
- package/docs/img/og-concorde.jpg +0 -0
- package/docs/index.html +184 -68
- package/docs/index.md +22 -0
- package/docs/llms-full.txt +5779 -0
- package/docs/llms.txt +108 -0
- package/docs/privacy.html +122 -0
- package/docs/privacy.md +32 -0
- package/docs/robots.txt +11 -10
- package/docs/sitemap.xml +243 -0
- package/docs/src/core/components/functional/date/date.md +150 -0
- package/docs/src/core/components/functional/fetch/fetch.md +108 -0
- package/docs/src/core/components/functional/if/if.md +34 -0
- package/docs/src/core/components/functional/jsonata/jsonata.md +61 -0
- package/docs/src/core/components/functional/list/list.md +125 -0
- package/docs/src/core/components/functional/mix/mix.md +46 -0
- package/docs/src/core/components/functional/queue/queue.md +51 -0
- package/docs/src/core/components/functional/router/router.md +93 -0
- package/docs/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
- package/docs/src/core/components/functional/sdui/component-catalog.json +3103 -0
- package/docs/src/core/components/functional/sdui/default-library.json +108 -0
- package/docs/src/core/components/functional/sdui/example.json +32 -0
- package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
- package/docs/src/core/components/functional/sdui/sdui.md +307 -0
- package/docs/src/core/components/functional/states/states.md +112 -0
- package/docs/src/core/components/functional/submit/submit.md +106 -0
- package/docs/src/core/components/functional/subscriber/subscriber.md +91 -0
- package/docs/src/core/components/functional/translation/translation.md +38 -0
- package/docs/src/core/components/functional/value/value.md +47 -0
- package/docs/src/core/components/ui/alert/alert.md +186 -0
- package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
- package/docs/src/core/components/ui/badge/badge.md +181 -0
- package/docs/src/core/components/ui/button/button.md +216 -0
- package/docs/src/core/components/ui/captcha/captcha.md +56 -0
- package/docs/src/core/components/ui/card/card.md +215 -0
- package/docs/src/core/components/ui/divider/divider.md +126 -0
- package/docs/src/core/components/ui/form/checkbox/checkbox.md +125 -0
- package/docs/src/core/components/ui/form/fieldset/fieldset.md +161 -0
- package/docs/src/core/components/ui/form/form-actions/form-actions.md +98 -0
- package/docs/src/core/components/ui/form/form-layout/form-layout.md +109 -0
- package/docs/src/core/components/ui/form/input/input.md +142 -0
- package/docs/src/core/components/ui/form/radio/radio.md +78 -0
- package/docs/src/core/components/ui/form/select/select.md +86 -0
- package/docs/src/core/components/ui/form/switch/switch.md +80 -0
- package/docs/src/core/components/ui/form/textarea/textarea.md +82 -0
- package/docs/src/core/components/ui/group/group.md +77 -0
- package/docs/src/core/components/ui/icon/icon.md +214 -0
- package/docs/src/core/components/ui/icon/icons.json +1 -0
- package/docs/src/core/components/ui/image/image.md +167 -0
- package/docs/src/core/components/ui/link/link.md +81 -0
- package/docs/src/core/components/ui/loader/loader.md +87 -0
- package/docs/src/core/components/ui/menu/menu.md +370 -0
- package/docs/src/core/components/ui/modal/modal.md +211 -0
- package/docs/src/core/components/ui/pop/pop.md +216 -0
- package/docs/src/core/components/ui/progress/progress.md +109 -0
- package/docs/src/core/components/ui/table/table.md +267 -0
- package/docs/src/core/components/ui/theme/theme.md +97 -0
- package/docs/src/core/components/ui/toast/toast.md +147 -0
- package/docs/src/core/components/ui/tooltip/tooltip.md +89 -0
- package/docs/src/docs/decorators/ancestor-attribute.md +59 -0
- package/docs/src/docs/decorators/auto-subscribe.md +40 -0
- package/docs/src/docs/decorators/bind.md +76 -0
- package/docs/src/docs/decorators/get.md +160 -0
- package/docs/src/docs/decorators/handle.md +119 -0
- package/docs/src/docs/decorators/on-assign.md +63 -0
- package/docs/src/docs/decorators/patch.md +44 -0
- package/docs/src/docs/decorators/post.md +134 -0
- package/docs/src/docs/decorators/publish.md +56 -0
- package/docs/src/docs/decorators/put.md +51 -0
- package/docs/src/docs/decorators/subscribe.md +87 -0
- package/docs/src/docs/decorators/wait-for-ancestors.md +76 -0
- package/docs/src/docs/directives/sub.md +75 -0
- package/docs/src/docs/directives/t.md +73 -0
- package/docs/src/docs/getting-started/ai-agents.md +50 -0
- package/docs/src/docs/getting-started/components.md +5 -0
- package/docs/src/docs/getting-started/create-a-component.md +136 -0
- package/docs/src/docs/getting-started/dataFlow.md +87 -0
- package/docs/src/docs/getting-started/installation.md +36 -0
- package/docs/src/docs/getting-started/my-first-component.md +227 -0
- package/docs/src/docs/getting-started/start.md +35 -0
- package/docs/src/docs/getting-started/theming.md +253 -0
- package/docs/src/docs/misc/api-configuration.md +79 -0
- package/docs/src/docs/misc/dataProviderKey.md +168 -0
- package/docs/src/docs/misc/docs-mock-api.md +62 -0
- package/docs/src/docs/misc/dynamic-path.md +71 -0
- package/docs/src/docs/misc/endpoint.md +45 -0
- package/docs/src/docs/misc/html-integration.md +14 -0
- package/docs/src/docs/search/docs-search.json +10332 -0
- package/docs/src/tag-list.json +1 -0
- package/docs/src/tsconfig-model.json +23 -0
- package/docs/src/tsconfig.json +1359 -0
- package/index.html +157 -5
- package/package.json +8 -4
- package/public/docs-mock-api-sw.js +58 -223
- package/public/docs-mock-api-sw.js.map +4 -4
- package/public/img/concorde/plane_01.jpg +0 -0
- package/public/img/concorde/plane_02.jpg +0 -0
- package/public/img/concorde/plane_03.jpg +0 -0
- package/public/img/concorde/plane_04.jpg +0 -0
- package/public/img/concorde/plane_05.jpg +0 -0
- package/public/img/concorde/plane_06.jpg +0 -0
- package/public/img/concorde/plane_07.jpg +0 -0
- package/public/img/concorde/plane_08.jpg +0 -0
- package/public/img/concorde/plane_09.jpg +0 -0
- package/public/img/concorde/plane_10.jpg +0 -0
- package/public/img/concorde/plane_11.jpg +0 -0
- package/public/img/concorde/plane_12.jpg +0 -0
- package/public/img/concorde/plane_13.jpg +0 -0
- package/public/img/og-concorde.jpg +0 -0
- package/public/robots.txt +11 -10
- package/scripts/ai-init.mjs +104 -379
- package/scripts/ai-init.test.mjs +81 -239
- package/scripts/docs-markdown-vite-plugin.ts +43 -0
- package/scripts/docs-public-url.mjs +56 -0
- package/scripts/docs.htaccess +82 -0
- package/scripts/generate-cem.mjs +244 -0
- package/scripts/generate-cem.test.mjs +122 -0
- package/scripts/generate-crawl-docs.mjs +233 -118
- package/scripts/generate-crawl-docs.test.mjs +124 -0
- package/scripts/generate-sdui-catalog.mjs +11 -10
- package/scripts/post-build-docs.js +37 -50
- package/scripts/pre-publish.mjs +2 -1
- package/scripts/site-pages.mjs +212 -0
- package/scripts/site-pages.test.mjs +116 -0
- package/site-pages/about.md +22 -0
- package/site-pages/privacy.md +32 -0
- package/src/core/components/functional/date/date.md +91 -231
- package/src/core/components/functional/fetch/fetch.md +66 -83
- package/src/core/components/functional/if/if.md +28 -3
- package/src/core/components/functional/jsonata/jsonata.md +42 -37
- package/src/core/components/functional/list/list.md +103 -43
- package/src/core/components/functional/mix/mix.md +31 -26
- package/src/core/components/functional/queue/queue.demo.ts +10 -7
- package/src/core/components/functional/queue/queue.md +40 -61
- package/src/core/components/functional/router/router.demo.ts +16 -16
- package/src/core/components/functional/router/router.md +64 -65
- package/src/core/components/functional/sdui/component-catalog.gaps.json +1 -1
- package/src/core/components/functional/sdui/component-catalog.json +1 -1
- package/src/core/components/functional/sdui/example.json +19 -86
- package/src/core/components/functional/sdui/sdui-extension-points.md +1 -1
- package/src/core/components/functional/sdui/sdui.md +187 -358
- package/src/core/components/functional/states/states.demo.ts +21 -22
- package/src/core/components/functional/states/states.md +86 -61
- package/src/core/components/functional/states/states.ts +1 -1
- package/src/core/components/functional/submit/submit.md +64 -72
- package/src/core/components/functional/translation/translation.md +38 -0
- package/src/core/components/functional/value/value.md +34 -22
- package/src/core/components/ui/alert/alert.md +48 -58
- package/src/core/components/ui/badge/badge.md +27 -34
- package/src/core/components/ui/button/button.md +139 -106
- package/src/core/components/ui/captcha/captcha.md +17 -32
- package/src/core/components/ui/card/card.md +6 -6
- package/src/core/components/ui/divider/divider.md +8 -11
- package/src/core/components/ui/form/checkbox/checkbox.md +90 -42
- package/src/core/components/ui/form/fieldset/fieldset.md +31 -75
- package/src/core/components/ui/form/form-actions/form-actions.md +14 -16
- package/src/core/components/ui/form/form-layout/form-layout.md +19 -29
- package/src/core/components/ui/form/input/input.md +95 -95
- package/src/core/components/ui/form/radio/radio.md +55 -34
- package/src/core/components/ui/form/select/select.md +60 -45
- package/src/core/components/ui/form/switch/switch.md +57 -34
- package/src/core/components/ui/form/textarea/textarea.md +55 -38
- package/src/core/components/ui/group/group.md +35 -33
- package/src/core/components/ui/icon/icon.md +4 -4
- package/src/core/components/ui/image/image.md +41 -107
- package/src/core/components/ui/link/link.md +6 -6
- package/src/core/components/ui/loader/loader.md +30 -55
- package/src/core/components/ui/menu/menu.md +27 -27
- package/src/core/components/ui/modal/modal.md +72 -96
- package/src/core/components/ui/pop/pop.md +80 -158
- package/src/core/components/ui/progress/progress.md +2 -2
- package/src/core/components/ui/table/table.md +91 -255
- package/src/core/components/ui/theme/theme.md +11 -36
- package/src/core/components/ui/toast/toast.md +48 -117
- package/src/core/components/ui/tooltip/tooltip.md +27 -62
- package/src/core/decorators/subscriber/bind.ts +9 -14
- package/src/core/utils/LocationHandler.spec.ts +80 -0
- package/src/core/utils/LocationHandler.ts +5 -9
- package/src/docs/components/docs-demo-sources.ts +55 -140
- package/src/docs/components/docs-lit-demo.ts +1 -3
- package/src/docs/components/docs-source-link.ts +0 -82
- package/src/docs/decorators/ancestor-attribute.md +59 -0
- package/src/docs/decorators/auto-subscribe.md +40 -0
- package/src/docs/decorators/bind.md +76 -0
- package/src/docs/decorators/get.md +160 -0
- package/src/docs/decorators/handle.md +119 -0
- package/src/docs/decorators/on-assign.md +63 -0
- package/src/docs/decorators/patch.md +44 -0
- package/src/docs/decorators/post.md +134 -0
- package/src/docs/decorators/publish.md +56 -0
- package/src/docs/decorators/put.md +51 -0
- package/src/docs/decorators/subscribe.md +87 -0
- package/src/docs/decorators/wait-for-ancestors.md +76 -0
- package/src/docs/directives/sub.md +75 -0
- package/src/docs/directives/t.md +73 -0
- package/src/docs/docs-location.spec.ts +56 -0
- package/src/docs/docs-location.ts +133 -32
- package/src/docs/docs.ts +1 -2
- package/src/docs/example/decorators-demo-bind-demos.ts +83 -135
- package/src/docs/example/decorators-demo-geo.ts +30 -19
- package/src/docs/example/decorators-demo-post.ts +88 -186
- package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +165 -268
- package/src/docs/example/decorators-demo.ts +85 -98
- package/src/docs/example/docs-api-config-demos.ts +19 -20
- package/src/docs/example/docs-flight-demos.ts +147 -0
- package/src/docs/example/docs-jsonata-demos.ts +52 -52
- package/src/docs/example/docs-list-demos.ts +43 -123
- package/src/docs/example/docs-provider-keys.ts +21 -28
- package/src/docs/example/docs-queue-demos.ts +37 -77
- package/src/docs/example/docs-router-demos.ts +20 -25
- package/src/docs/example/docs-submit-demos.ts +48 -48
- package/src/docs/example/docs-toggle-demos.ts +4 -3
- package/src/docs/getting-started/ai-agents.md +50 -0
- package/src/docs/getting-started/components.md +5 -0
- package/src/docs/getting-started/create-a-component.md +136 -0
- package/src/docs/getting-started/dataFlow.md +87 -0
- package/src/docs/getting-started/installation.md +36 -0
- package/src/docs/getting-started/my-first-component.md +227 -0
- package/src/docs/getting-started/start.md +35 -0
- package/src/docs/getting-started/theming.md +253 -0
- package/src/docs/header/header.ts +11 -6
- package/src/docs/home/catalog.ts +1 -1
- package/src/docs/home/home.ts +20 -11
- package/src/docs/layout.ts +12 -13
- package/src/docs/misc/api-configuration.md +79 -0
- package/src/docs/misc/dataProviderKey.md +168 -0
- package/src/docs/misc/docs-mock-api.md +62 -0
- package/src/docs/misc/dynamic-path.md +71 -0
- package/src/docs/misc/endpoint.md +45 -0
- package/src/docs/misc/html-integration.md +14 -0
- package/src/docs/mock-api/api-config-mock.ts +5 -0
- package/src/docs/mock-api/fixtures.ts +0 -278
- package/src/docs/mock-api/flights.ts +89 -0
- package/src/docs/mock-api/router.ts +3 -4
- package/src/docs/mock-api/urls.ts +1 -2
- package/src/docs/navigation/navigation.ts +82 -103
- package/src/docs/navigation/toc.ts +7 -4
- package/src/docs/search/docs-search.json +2804 -5024
- package/src/docs/search/markdown-renderer.ts +31 -8
- package/src/docs/search/page.ts +9 -6
- package/src/docs/search/search.ts +154 -122
- package/src/docs/tailwind/css/docs/content.css +4 -5
- package/src/tsconfig.json +11 -5
- package/src/tsconfig.tsbuildinfo +1 -1
- package/vite.config.mts +11 -2
- package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
- package/ai/AGENTS.md +0 -56
- package/ai/cursor/rules/concorde-menu.mdc +0 -15
- package/ai/cursor/rules/concorde-scope.mdc +0 -14
- package/ai/cursor/rules/concorde-theme.mdc +0 -13
- package/ai/cursor/rules/concorde.mdc +0 -66
- package/ai/jetbrains/rules/concorde.md +0 -53
- package/ai/skills/concorde-get-set-dp/SKILL.md +0 -194
- package/ai/skills/concorde-imports/SKILL.md +0 -78
- package/ai/skills/concorde-menu/SKILL.md +0 -74
- package/ai/skills/concorde-scope/SKILL.md +0 -70
- package/ai/skills/concorde-theme/SKILL.md +0 -57
- package/docs/assets/index-CD4WyL6o.css +0 -1
- package/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
- package/src/docs/_core-concept/overview.md +0 -57
- package/src/docs/_core-concept/subscriber.md +0 -75
- package/src/docs/_decorators/ancestor-attribute.md +0 -128
- package/src/docs/_decorators/auto-subscribe.md +0 -202
- package/src/docs/_decorators/bind.md +0 -167
- package/src/docs/_decorators/get.md +0 -162
- package/src/docs/_decorators/handle.md +0 -175
- package/src/docs/_decorators/on-assign.md +0 -390
- package/src/docs/_decorators/patch.md +0 -70
- package/src/docs/_decorators/post.md +0 -146
- package/src/docs/_decorators/publish.md +0 -55
- package/src/docs/_decorators/put.md +0 -70
- package/src/docs/_decorators/subscribe.md +0 -100
- package/src/docs/_decorators/wait-for-ancestors.md +0 -163
- package/src/docs/_directives/sub.md +0 -91
- package/src/docs/_getting-started/ai-agents.md +0 -76
- package/src/docs/_getting-started/concorde-manual-install.md +0 -133
- package/src/docs/_getting-started/concorde-outside.md +0 -33
- package/src/docs/_getting-started/my-first-subscriber.md +0 -120
- package/src/docs/_getting-started/pubsub.md +0 -37
- package/src/docs/_misc/formelement-subscriber-removal.md +0 -115
- package/src/docs/example/docs-input-autocomplete-demos.ts +0 -110
- package/src/docs/example/docs-joke-demos.ts +0 -297
- /package/{src/docs/_getting-started → docs/docs/getting-started}/components.md +0 -0
- /package/{src/docs/_getting-started → docs/docs/getting-started}/theming.md +0 -0
|
@@ -1,76 +0,0 @@
|
|
|
1
|
-
# AI agents (skills & AGENTS.md)
|
|
2
|
-
|
|
3
|
-
Concorde ships **skills**, **rules**, and a root **`AGENTS.md`** so Cursor, JetBrains AI Assistant, and other coding agents follow framework patterns (DataProvider, decorators, short imports, scope, theme, migrations).
|
|
4
|
-
|
|
5
|
-
On a [starter](#docs/_getting-started/concorde-outside.md/concorde-outside) project, run `yarn ai:sync` after install. On a [manual / brownfield](#docs/_getting-started/concorde-manual-install.md/concorde-manual-install) project, install Concorde first, then use `ai-init` below.
|
|
6
|
-
|
|
7
|
-
## Dedicated commands
|
|
8
|
-
|
|
9
|
-
| Context | Command |
|
|
10
|
-
|---------|---------|
|
|
11
|
-
| [create-concorde-ts-starter](https://www.npmjs.com/package/@supersoniks/create-concorde-ts-starter) project | `yarn ai:sync` |
|
|
12
|
-
| Any consumer app (after `yarn add @supersoniks/concorde`) | `node node_modules/@supersoniks/concorde/scripts/ai-init.mjs` |
|
|
13
|
-
| Concorde repo (contributors) | `yarn ai-init` |
|
|
14
|
-
|
|
15
|
-
<sonic-code language="shell">
|
|
16
|
-
<template>
|
|
17
|
-
# Starter (from project root)
|
|
18
|
-
yarn ai:sync
|
|
19
|
-
|
|
20
|
-
# Manual / existing project
|
|
21
|
-
node node_modules/@supersoniks/concorde/scripts/ai-init.mjs
|
|
22
|
-
</template>
|
|
23
|
-
</sonic-code>
|
|
24
|
-
|
|
25
|
-
## Useful flags
|
|
26
|
-
|
|
27
|
-
| Flag | Effect |
|
|
28
|
-
|------|--------|
|
|
29
|
-
| `--skip-agents` | Never write `AGENTS.md` (skills / rules only) |
|
|
30
|
-
| `--merge-agents` | Opt-in: keep the project preamble and append / refresh the Concorde block |
|
|
31
|
-
| `--force-agents` | Opt-in: **replace** the whole `AGENTS.md` (destructive) |
|
|
32
|
-
| `--overlay <dir>` | Extra rules/skills + optional `AGENTS.concorde.md` for project-only Concorde agent notes |
|
|
33
|
-
| `--cursor-only` | Install only `.cursor/skills` and `.cursor/rules` |
|
|
34
|
-
| `--jetbrains-only` | Install only `.aiassistant/rules/` |
|
|
35
|
-
|
|
36
|
-
## `AGENTS.md` policy (non-invasive)
|
|
37
|
-
|
|
38
|
-
| Situation | Default |
|
|
39
|
-
|-----------|---------|
|
|
40
|
-
| No `AGENTS.md` | Create the Concorde guide |
|
|
41
|
-
| File with `<!-- concorde-ai -->` | Refresh the managed zone only |
|
|
42
|
-
| File **without** marker (project notes) | **Left untouched** — skills / rules are enough |
|
|
43
|
-
| `--merge-agents` / `--force-agents` / `--skip-agents` | See flags above |
|
|
44
|
-
|
|
45
|
-
```text
|
|
46
|
-
[optional project preamble — short, project-only]
|
|
47
|
-
<!-- concorde-ai -->
|
|
48
|
-
<package ai/AGENTS.md>
|
|
49
|
-
[--- + overlay AGENTS.concorde.md]
|
|
50
|
-
```
|
|
51
|
-
|
|
52
|
-
Everything **after** `<!-- concorde-ai -->` is replaced on each `ai-init` run (idempotent). Do not paste a full copy of the Concorde guide above the marker — put project-specific notes in `AGENTS.concorde.md` (overlay). If the preamble duplicates package `AGENTS.md`, `ai-init` slims or drops it and prints a warning. Legacy filenames `AGENTS.overlay.md` / `AGENTS.starter.md` are still accepted with a deprecation warning.
|
|
53
|
-
|
|
54
|
-
## What gets installed
|
|
55
|
-
|
|
56
|
-
| Path | Role |
|
|
57
|
-
|------|------|
|
|
58
|
-
| `AGENTS.md` | Created only if missing; existing project-owned files are left alone unless `--merge-agents` / `--force-agents` |
|
|
59
|
-
| `.cursor/skills/concorde/` | Core Lit + DataProvider patterns |
|
|
60
|
-
| `.cursor/skills/concorde-imports/` | Short `@supersoniks/concorde/…` import paths |
|
|
61
|
-
| `.cursor/skills/concorde-scope/` | `serviceURL`, `formDataProvider`, API configuration |
|
|
62
|
-
| `.cursor/skills/concorde-theme/` | `sonic-theme` and `--sc-*` tokens |
|
|
63
|
-
| `.cursor/skills/concorde-menu/` | `sonic-menu` navigation |
|
|
64
|
-
| `.cursor/skills/concorde-get-set-dp/` | `get` / `set` / `dp` and `DataProviderKey` migration |
|
|
65
|
-
| `.cursor/rules/concorde.mdc` | Cursor rules (always-on patterns) |
|
|
66
|
-
| `.aiassistant/rules/concorde.md` | JetBrains AI Assistant rules |
|
|
67
|
-
|
|
68
|
-
## Workflow
|
|
69
|
-
|
|
70
|
-
1. **Starter project:** [Installation](#docs/_getting-started/concorde-outside.md/concorde-outside) — `yarn ai:sync` is wired in the kit.
|
|
71
|
-
2. **Existing / manual Vite project:** [Manual installation](#docs/_getting-started/concorde-manual-install.md/concorde-manual-install), then **`ai-init`** after `yarn add @supersoniks/concorde`.
|
|
72
|
-
3. Commit `.cursor/` and `.aiassistant/` (and `AGENTS.md` only if you opted in / it was created) if your team shares agent settings.
|
|
73
|
-
4. Re-run the same command when you bump `@supersoniks/concorde` to refresh skills from `node_modules/@supersoniks/concorde/ai/`.
|
|
74
|
-
5. In Cursor, skills under `.cursor/skills/` are picked up automatically; mention a skill in chat for focused tasks (e.g. migration → `concorde-get-set-dp`).
|
|
75
|
-
|
|
76
|
-
Source files in the npm package: `node_modules/@supersoniks/concorde/ai/` (see also `ai/README.md` in the [Concorde repository](https://github.com/supersoniks/concorde)).
|
|
@@ -1,133 +0,0 @@
|
|
|
1
|
-
# Manual installation (Vite)
|
|
2
|
-
|
|
3
|
-
> **Legacy** — for brownfield apps or custom stacks. New projects should use the [starter](#docs/_getting-started/concorde-outside.md/concorde-outside).
|
|
4
|
-
|
|
5
|
-
## Brand New Vite Project
|
|
6
|
-
|
|
7
|
-
Tailwind configuration is not covered here yet.
|
|
8
|
-
|
|
9
|
-
### Creating the Project
|
|
10
|
-
|
|
11
|
-
<sonic-code language="shell">
|
|
12
|
-
<template>
|
|
13
|
-
# Pure JavaScript project
|
|
14
|
-
yarn create vite --template vanilla-js
|
|
15
|
-
# TypeScript project
|
|
16
|
-
# (it is recommended to use this approach, which installs Lit separately if needed, via "yarn add lit")
|
|
17
|
-
yarn create vite --template vanilla-ts
|
|
18
|
-
# TypeScript + Lit project
|
|
19
|
-
# (creating new web components, for example, to extend the fetch or subscriber mixins)
|
|
20
|
-
yarn create vite --template lit-ts
|
|
21
|
-
</template>
|
|
22
|
-
</sonic-code>
|
|
23
|
-
|
|
24
|
-
Using Lit with TypeScript requires the following configuration in the "compilerOptions" section of the `tsconfig.json` file:
|
|
25
|
-
|
|
26
|
-
<sonic-code language="json">
|
|
27
|
-
<template>
|
|
28
|
-
"experimentalDecorators": true,
|
|
29
|
-
"useDefineForClassFields": false
|
|
30
|
-
</template>
|
|
31
|
-
</sonic-code>
|
|
32
|
-
|
|
33
|
-
### Installing Concorde
|
|
34
|
-
|
|
35
|
-
Navigate to the project folder created and perform the installation:
|
|
36
|
-
|
|
37
|
-
<sonic-code language="shell">
|
|
38
|
-
<template>
|
|
39
|
-
yarn add @supersoniks/concorde
|
|
40
|
-
</template>
|
|
41
|
-
</sonic-code>
|
|
42
|
-
|
|
43
|
-
Agent skills (`AGENTS.md`, Cursor / JetBrains): see [AI agents](#docs/_getting-started/ai-agents.md/ai-agents) — run `node node_modules/@supersoniks/concorde/scripts/ai-init.mjs` after install.
|
|
44
|
-
|
|
45
|
-
### Development / Build
|
|
46
|
-
|
|
47
|
-
<sonic-code language="shell">
|
|
48
|
-
<template>
|
|
49
|
-
# Development (you can add `--host` after the command chain in package.json's dev script instead of typing it each time as shown below)
|
|
50
|
-
yarn dev --host
|
|
51
|
-
# Build
|
|
52
|
-
yarn build
|
|
53
|
-
</template>
|
|
54
|
-
</sonic-code>
|
|
55
|
-
|
|
56
|
-
## Shortcut Imports
|
|
57
|
-
|
|
58
|
-
Shortcut imports work by default in JavaScript, but in TypeScript, they are activated by choice as they inject data into *tsconfig.json*. Here is the command:
|
|
59
|
-
|
|
60
|
-
<sonic-code language="shell">
|
|
61
|
-
<template>
|
|
62
|
-
npx concorde enable-short-paths
|
|
63
|
-
</template>
|
|
64
|
-
</sonic-code>
|
|
65
|
-
|
|
66
|
-
Shortcut imports replace the actual paths with aliases as follows:
|
|
67
|
-
|
|
68
|
-
* `@supersoniks/concorde/core/components/functional_or_ui/component/component` becomes `@supersoniks/concorde/functional_or_ui/component`
|
|
69
|
-
* `@supersoniks/concorde/core/mixins_or_utils/class_name` becomes `@supersoniks/concorde/mixins_or_utils/class_name`
|
|
70
|
-
|
|
71
|
-
The original paths remain accessible. Shortcut imports are used for the examples later in this documentation.
|
|
72
|
-
|
|
73
|
-
## Usage
|
|
74
|
-
|
|
75
|
-
### Simple Integration in HTML
|
|
76
|
-
|
|
77
|
-
Import needed component in `main.ts` or wherever you want to use it:
|
|
78
|
-
|
|
79
|
-
<sonic-code language="typescript">
|
|
80
|
-
<template>
|
|
81
|
-
import "@supersoniks/concorde/ui/button";
|
|
82
|
-
</template>
|
|
83
|
-
</sonic-code>
|
|
84
|
-
|
|
85
|
-
Then in the render function ofyour component or in the HTML of the web page that includes the compiled JS, use the component as follows:
|
|
86
|
-
|
|
87
|
-
<sonic-code>
|
|
88
|
-
<template>
|
|
89
|
-
<sonic-button variant="outline">My button</sonic-button>
|
|
90
|
-
</template>
|
|
91
|
-
</sonic-code>
|
|
92
|
-
|
|
93
|
-
### Using a Mixin to Create a New Lit Component
|
|
94
|
-
|
|
95
|
-
For example, create a file `my-element.ts` at the root:
|
|
96
|
-
|
|
97
|
-
<sonic-code language="typescript">
|
|
98
|
-
<template>
|
|
99
|
-
import { html, LitElement } from "lit";
|
|
100
|
-
import { customElement, property } from "lit/decorators.js";
|
|
101
|
-
import Fetcher from "@supersoniks/concorde/mixins/Fetcher";
|
|
102
|
-
import Subscriber from "@supersoniks/concorde/mixins/Subscriber";
|
|
103
|
-
|
|
104
|
-
@customElement("my-element")
|
|
105
|
-
export class SonicComponent extends Fetcher(Subscriber(LitElement)) {
|
|
106
|
-
@property() email = "";
|
|
107
|
-
@property() first_name = "";
|
|
108
|
-
@property() last_name = "";
|
|
109
|
-
|
|
110
|
-
render() {
|
|
111
|
-
return html`<div>
|
|
112
|
-
${this.first_name} ${this.last_name} : ${this.email}
|
|
113
|
-
</div>`;
|
|
114
|
-
}
|
|
115
|
-
}
|
|
116
|
-
</template>
|
|
117
|
-
</sonic-code>
|
|
118
|
-
|
|
119
|
-
Import component `main.ts` or `main.js` or any other component that uses it to be compiled
|
|
120
|
-
|
|
121
|
-
<sonic-code language="typescript">
|
|
122
|
-
<template>
|
|
123
|
-
import "./my-element";
|
|
124
|
-
</template>
|
|
125
|
-
</sonic-code>
|
|
126
|
-
|
|
127
|
-
In the HTML of a JS or TS component or in the HTML of the web page containing the compiled JS:
|
|
128
|
-
|
|
129
|
-
<sonic-code language="html">
|
|
130
|
-
<template>
|
|
131
|
-
<my-element serviceURL="/docs-mock-api" dataProvider="api/users/2" key="data"></my-element>
|
|
132
|
-
</template>
|
|
133
|
-
</sonic-code>
|
|
@@ -1,33 +0,0 @@
|
|
|
1
|
-
# Installation
|
|
2
|
-
|
|
3
|
-
<sonic-alert status="info" label="Recommended — use the starter" background>
|
|
4
|
-
<p>For almost all new projects, use <a href="https://www.npmjs.com/package/@supersoniks/create-concorde-ts-starter">create-concorde-ts-starter</a></p>
|
|
5
|
-
<p>You get Vite + TypeScript + Lit + Tailwind, an example component, <code>npx concorde enable-short-paths</code> ready to run, and <code>yarn ai:sync</code> for <a href="#docs/_getting-started/ai-agents.md/ai-agents">AI agent skills</a> (<code>AGENTS.md</code>, Cursor / JetBrains rules) without extra setup.</p>
|
|
6
|
-
</sonic-alert>
|
|
7
|
-
|
|
8
|
-
## Starter
|
|
9
|
-
|
|
10
|
-
The following command creates a new Vite project in TypeScript mode with Tailwind and an example component to get started.
|
|
11
|
-
|
|
12
|
-
<sonic-code language="shell">
|
|
13
|
-
<template>
|
|
14
|
-
npx @supersoniks/create-concorde-ts-starter "project_name"
|
|
15
|
-
</template>
|
|
16
|
-
</sonic-code>
|
|
17
|
-
|
|
18
|
-
Then, from the project folder:
|
|
19
|
-
|
|
20
|
-
<sonic-code language="shell">
|
|
21
|
-
<template>
|
|
22
|
-
yarn install
|
|
23
|
-
yarn dev --host
|
|
24
|
-
</template>
|
|
25
|
-
</sonic-code>
|
|
26
|
-
|
|
27
|
-
## Next steps
|
|
28
|
-
|
|
29
|
-
| Step | Page |
|
|
30
|
-
|------|------|
|
|
31
|
-
| Learn patterns | [My first component](#docs/_getting-started/my-first-component.md/my-first-component) |
|
|
32
|
-
| Agent skills | [AI agents (skills)](#docs/_getting-started/ai-agents.md/ai-agents) — `yarn ai:sync` on the starter |
|
|
33
|
-
| Brownfield / manual Vite | [Legacy: Manual installation](#docs/_getting-started/concorde-manual-install.md/concorde-manual-install) |
|
|
@@ -1,120 +0,0 @@
|
|
|
1
|
-
# Legacy: My first subscriber component
|
|
2
|
-
|
|
3
|
-
> **New projects:** use [My first component](#docs/_getting-started/my-first-component.md/my-first-component) (`@ancestorAttribute`, `@subscribe` + `DataProviderKey`, `.items` on lists) and [Data flow](#docs/_core-concept/dataFlow.md/dataFlow). This page documents the **Subscriber mixin** used by older apps and core components.
|
|
4
|
-
|
|
5
|
-
Learn how to build a component with the **Subscriber** mixin, styled with Tailwind, filled from a DataProvider via automatic property mapping.
|
|
6
|
-
|
|
7
|
-
## Create a classic lit component
|
|
8
|
-
|
|
9
|
-
<sonic-code language="javascript" >
|
|
10
|
-
<template>
|
|
11
|
-
import { html, LitElement, nothing } from "lit";
|
|
12
|
-
import { customElement, property } from "lit/decorators.js";
|
|
13
|
-
@customElement("docs-user")
|
|
14
|
-
export class user extends LitElement {
|
|
15
|
-
@property({ type: String }) first_name = "";
|
|
16
|
-
@property({ type: String }) last_name = "";
|
|
17
|
-
@property({ type: String }) avatar = "";
|
|
18
|
-
@property({ type: String }) email = "";
|
|
19
|
-
render() {
|
|
20
|
-
return html`
|
|
21
|
-
<img src="${this.avatar}" /> <br>
|
|
22
|
-
${this.first_name} ${this.last_name} <br>
|
|
23
|
-
${this.email}`;
|
|
24
|
-
}
|
|
25
|
-
}
|
|
26
|
-
</template>
|
|
27
|
-
</sonic-code>
|
|
28
|
-
|
|
29
|
-
### Style with tailwind and ui components
|
|
30
|
-
|
|
31
|
-
<sonic-code language="javascript">
|
|
32
|
-
<template>
|
|
33
|
-
import { css, unsafeCSS } from "lit";
|
|
34
|
-
import tailwindImport from "./css/tailwind.css?inline";
|
|
35
|
-
export const tailwind = css`${unsafeCSS(tailwindImport)}`;
|
|
36
|
-
</template>
|
|
37
|
-
</sonic-code>
|
|
38
|
-
|
|
39
|
-
<sonic-code language="javascript">
|
|
40
|
-
<template>
|
|
41
|
-
import { html, LitElement } from "lit";
|
|
42
|
-
import { customElement, property } from "lit/decorators.js";
|
|
43
|
-
import { tailwind } from "../tailwind";
|
|
44
|
-
import '@supersoniks/concode/ui/image'
|
|
45
|
-
import '@supersoniks/concode/ui/button'
|
|
46
|
-
import '@supersoniks/concode/ui/icon'
|
|
47
|
-
@customElement("docs-user")
|
|
48
|
-
export class user extends LitElement {
|
|
49
|
-
static styles = [tailwind];
|
|
50
|
-
@property({ type: String }) first_name = "";
|
|
51
|
-
@property({ type: String }) last_name = "";
|
|
52
|
-
@property({ type: String }) avatar = "";
|
|
53
|
-
@property({ type: String }) email = "";
|
|
54
|
-
render() {
|
|
55
|
-
return html`<div class="flex items-center gap-3 p-2">
|
|
56
|
-
<sonic-image src=${this.avatar} rounded="md" ratio="1/1" class="w-16"></sonic-image>
|
|
57
|
-
<div>${this.first_name} <span class="font-bold">${this.last_name}</span></div>
|
|
58
|
-
<div class="text-sm text-neutral-400">${this.email}</div>
|
|
59
|
-
</div>`;
|
|
60
|
-
}
|
|
61
|
-
}
|
|
62
|
-
</template>
|
|
63
|
-
</sonic-code>
|
|
64
|
-
|
|
65
|
-
## Add Subscriber mixin
|
|
66
|
-
|
|
67
|
-
<sonic-code language="javascript">
|
|
68
|
-
<template>
|
|
69
|
-
import Subscriber from "@supersoniks/concorde/core/mixins/Subscriber";
|
|
70
|
-
@customElement("docs-user")
|
|
71
|
-
export class user extends Subscriber(LitElement) {
|
|
72
|
-
// properties auto-filled from DataProvider when names match
|
|
73
|
-
}
|
|
74
|
-
</template>
|
|
75
|
-
</sonic-code>
|
|
76
|
-
|
|
77
|
-
See [Legacy: Subscriber mixin](#docs/_core-concept/subscriber.md/subscriber).
|
|
78
|
-
|
|
79
|
-
## Autofill from a dataProvider
|
|
80
|
-
|
|
81
|
-
<sonic-code >
|
|
82
|
-
<template>
|
|
83
|
-
<docs-demo-sources for="list-users-fetch"></docs-demo-sources>
|
|
84
|
-
<div serviceURL="/docs-mock-api">
|
|
85
|
-
<sonic-fetch
|
|
86
|
-
serviceURL="/docs-mock-api"
|
|
87
|
-
dataProvider="api/users/3"
|
|
88
|
-
key="data">
|
|
89
|
-
<docs-user></docs-user>
|
|
90
|
-
</sonic-fetch>
|
|
91
|
-
</div>
|
|
92
|
-
</template>
|
|
93
|
-
</sonic-code>
|
|
94
|
-
|
|
95
|
-
<sonic-code >
|
|
96
|
-
<template>
|
|
97
|
-
<sonic-fetch
|
|
98
|
-
serviceURL="/docs-mock-api"
|
|
99
|
-
dataProvider="api/users/2"
|
|
100
|
-
key="data"></sonic-fetch>
|
|
101
|
-
<docs-user dataProvider="api/users/2" ></docs-user>
|
|
102
|
-
</template>
|
|
103
|
-
</sonic-code>
|
|
104
|
-
|
|
105
|
-
<sonic-code >
|
|
106
|
-
<template>
|
|
107
|
-
<div class="grid grid-cols-1 gap-4">
|
|
108
|
-
<form formDataProvider="userPreview" class="grid grid-cols-4 gap-3" >
|
|
109
|
-
<sonic-input label="First name" type="text" name="first_name" value="Paul" size="sm"></sonic-input>
|
|
110
|
-
<sonic-input label="Last name" type="text" name="last_name" value="Metrand" size="sm"></sonic-input>
|
|
111
|
-
<sonic-input class="col-span-2" label="email" type="text" name="email" value="paul@example.com" size="sm"></sonic-input>
|
|
112
|
-
<sonic-input label="Image url" type="text" name="avatar" value="https://i.pravatar.cc/150?u=paul" size="sm"></sonic-input>
|
|
113
|
-
</form>
|
|
114
|
-
<sonic-divider align="left">Preview before submit</sonic-divider>
|
|
115
|
-
<div dataProvider="userPreview">
|
|
116
|
-
<docs-user></docs-user>
|
|
117
|
-
</div>
|
|
118
|
-
</div>
|
|
119
|
-
</template>
|
|
120
|
-
</sonic-code>
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
# Legacy: Sharing data
|
|
2
|
-
|
|
3
|
-
> **New apps:** [Data flow](#docs/_core-concept/dataFlow.md/dataFlow) (`get` / `set` / `DataProviderKey`, decorators). This page documents the historical **Publisher** proxy API (`PublisherManager`, `publisher.set`, `onAssign`, …).
|
|
4
|
-
|
|
5
|
-
This section describes how data is shared between graphical and non-graphical components.
|
|
6
|
-
|
|
7
|
-
Graphical components should not reference each other directly — they stay decoupled via a **publish/subscribe** store.
|
|
8
|
-
|
|
9
|
-
## The Publisher
|
|
10
|
-
|
|
11
|
-
### Principle
|
|
12
|
-
|
|
13
|
-
* The **publisher** is a [JavaScript proxy](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Proxy) that holds data.<br>
|
|
14
|
-
Example: `{foo:{hello:["world"]}, bar:"baz"}`
|
|
15
|
-
|
|
16
|
-
* Accessing a property (`myPublisher.foo.hello`) returns another **publisher** for that segment.
|
|
17
|
-
|
|
18
|
-
* Missing properties create a publisher with internal data `null`, filled later.
|
|
19
|
-
|
|
20
|
-
* **Subscribers** listen via `onAssign`, `onInternalMutation`, template filling on the **Subscriber mixin**, etc.
|
|
21
|
-
|
|
22
|
-
* Updates use `publisher.set(...)` or nested assignment; changes propagate to subscribers.
|
|
23
|
-
|
|
24
|
-
❇️ Order of creation vs subscription theoretically does not matter.
|
|
25
|
-
|
|
26
|
-
### Methods
|
|
27
|
-
|
|
28
|
-
* **set** — replace internal value
|
|
29
|
-
<sonic-code language="javascript"><template>publisher.set({foo:{hello:["world"]}, bar:"baz"});</template></sonic-code>
|
|
30
|
-
|
|
31
|
-
* **get** — read internal value
|
|
32
|
-
<sonic-code language="javascript"><template>publisher.get()</template></sonic-code>
|
|
33
|
-
|
|
34
|
-
* **onAssign / offAssign** — react to `set`
|
|
35
|
-
<sonic-code language="javascript"><template>publisher.a.b.onAssign(console.log);</template></sonic-code>
|
|
36
|
-
|
|
37
|
-
Modern equivalent: `get` / `set` / `@handle` — see [Data flow](#docs/_core-concept/dataFlow.md/dataFlow).
|
|
@@ -1,115 +0,0 @@
|
|
|
1
|
-
# FormElement without Subscriber (REDMINE-79569)
|
|
2
|
-
|
|
3
|
-
Form fields (`sonic-input`, `textarea`, `select`, `checkbox`, `radio`, `switch`, `button`, `input-autocomplete`) no longer inherit the **Subscriber** mixin.
|
|
4
|
-
|
|
5
|
-
## Behaviour now
|
|
6
|
-
|
|
7
|
-
| Before | After |
|
|
8
|
-
|--------|--------|
|
|
9
|
-
| Dual channel `dataProvider` (autofill) + `formDataProvider` | **`formDataProvider` + `name` only** |
|
|
10
|
-
| Ancestor `dataProvider` auto-filled field props | Ignored by form fields |
|
|
11
|
-
| `noAutoFill` on fields/buttons inside a `dataProvider` tree | Dead on form fields (attribute harmless; can be cleaned in apps) |
|
|
12
|
-
|
|
13
|
-
Preview pattern still valid: form writes via `formDataProvider`, display card reads via `dataProvider` on a **Subscriber** (or `@subscribe`) sibling — not on the fields themselves.
|
|
14
|
-
|
|
15
|
-
## Migration checklist (apps)
|
|
16
|
-
|
|
17
|
-
1. Prefer `formDataProvider` alone on forms / fieldsets.
|
|
18
|
-
2. Drop redundant `dataProvider={sameKey}` on form containers when it only existed for field autofill.
|
|
19
|
-
3. Prefill edit forms with `set(formKey, row)` / `dp(formKey.field).set(...)` before mount — not field `dataProvider`.
|
|
20
|
-
4. Remove `noAutoFill` on `sonic-button` / fields when it only blocked Subscriber autofill.
|
|
21
|
-
5. `initFromPublisher` still works (form publisher only).
|
|
22
|
-
|
|
23
|
-
## Billetterie collect — dual-channel risk
|
|
24
|
-
|
|
25
|
-
Files under `la-billetterie/concorde` that mention both `formDataProvider` and `dataProvider=` (review; many are filter+queue, not field autofill):
|
|
26
|
-
|
|
27
|
-
### High priority (same key on form container)
|
|
28
|
-
|
|
29
|
-
- `la-billetterie/components/reservation-request/atoms/request-event-form.ts` — `form` / `fieldset` with both attrs equal
|
|
30
|
-
- `la-billetterie/components/reservation/atoms/new-quote-form.ts`
|
|
31
|
-
- `la-billetterie/components/stats/sales-summary/sales-summary.ts`
|
|
32
|
-
- `la-billetterie/components/product/price-selection-form/price-selection-form.ts` — `formDataProvider` + `dataProvider="cart/editForm"`
|
|
33
|
-
- `la-billetterie/components/user/account/link-ticket/link-ticket.ts` — distinct keys (API vs form) — keep `dataProvider` only if used by fetch/submit siblings
|
|
34
|
-
|
|
35
|
-
### Filters + queue (usually OK)
|
|
36
|
-
|
|
37
|
-
`formDataProvider` on filter bar, `dataProvider` on `sonic-queue` / list — no field autofill dependency:
|
|
38
|
-
|
|
39
|
-
- `access-control/components/event/list/index.ts`
|
|
40
|
-
- `access-control/components/control/search/views/list.ts`
|
|
41
|
-
- `la-billetterie/components/event/form-event-filter/form-event-filter.ts`
|
|
42
|
-
- `la-billetterie/components/counter/*` (agenda, store, reservation-request-treatment, …)
|
|
43
|
-
- `widgets/agenda/agenda.ts`
|
|
44
|
-
- … see full dual list in ticket notes / grep below
|
|
45
|
-
|
|
46
|
-
### Full dual-channel file list (55)
|
|
47
|
-
|
|
48
|
-
```
|
|
49
|
-
concorde/src/access-control/components/control/search/views/list.ts
|
|
50
|
-
concorde/src/access-control/components/event/list/index.ts
|
|
51
|
-
concorde/src/la-billetterie/components/access-control-mobile/access-controller-picker.ts
|
|
52
|
-
concorde/src/la-billetterie/components/accreditations-directory/accreditations-directory.ts
|
|
53
|
-
concorde/src/la-billetterie/components/address/address-suggestion.ts
|
|
54
|
-
concorde/src/la-billetterie/components/bulk/bulk.ts
|
|
55
|
-
concorde/src/la-billetterie/components/campaign/campaign-content.ts
|
|
56
|
-
concorde/src/la-billetterie/components/counter/agenda/agenda.ts
|
|
57
|
-
concorde/src/la-billetterie/components/counter/event-selector/event-selector.ts
|
|
58
|
-
concorde/src/la-billetterie/components/counter/order-validation/order-validation-settings.ts
|
|
59
|
-
concorde/src/la-billetterie/components/counter/print/format-menu.ts
|
|
60
|
-
concorde/src/la-billetterie/components/counter/reservation-request-treatment/reservation-request-treatment.ts
|
|
61
|
-
concorde/src/la-billetterie/components/counter/store/counter-store.ts
|
|
62
|
-
concorde/src/la-billetterie/components/counter/widgets-settings/widgets-settings-page.ts
|
|
63
|
-
concorde/src/la-billetterie/components/custom-list/custom-list.ts
|
|
64
|
-
concorde/src/la-billetterie/components/event/agenda/agenda.ts
|
|
65
|
-
concorde/src/la-billetterie/components/event/atoms/buy-event-block/buy-event-block.ts
|
|
66
|
-
concorde/src/la-billetterie/components/event/atoms/categorizedPrices/categorizedPrices.ts
|
|
67
|
-
concorde/src/la-billetterie/components/event/event-store/event-store-content.ts
|
|
68
|
-
concorde/src/la-billetterie/components/event/form-event-filter/form-event-filter.ts
|
|
69
|
-
concorde/src/la-billetterie/components/form/event-selection/event-selection-filters.ts
|
|
70
|
-
concorde/src/la-billetterie/components/form/event-selection/event-selection.ts
|
|
71
|
-
concorde/src/la-billetterie/components/giftcards/giftcard-link.ts
|
|
72
|
-
concorde/src/la-billetterie/components/layout/header.ts
|
|
73
|
-
concorde/src/la-billetterie/components/orders/recover/recover.ts
|
|
74
|
-
concorde/src/la-billetterie/components/placing/atoms/placement-choice/placement-choice.ts
|
|
75
|
-
concorde/src/la-billetterie/components/placing/seatmap-view/seatmap-view.ts
|
|
76
|
-
concorde/src/la-billetterie/components/product/price-selection-form/price-selection-form.ts
|
|
77
|
-
concorde/src/la-billetterie/components/product/prices-form/price-button/price-button.ts
|
|
78
|
-
concorde/src/la-billetterie/components/purchase/purchase-summary/complementary-info/complementary-info.ts
|
|
79
|
-
concorde/src/la-billetterie/components/reservation-request/atoms/request-event-form.ts
|
|
80
|
-
concorde/src/la-billetterie/components/reservation/atoms/new-quote-form.ts
|
|
81
|
-
concorde/src/la-billetterie/components/reservation/reservation-content.ts
|
|
82
|
-
concorde/src/la-billetterie/components/seatmap/seatmap.ts
|
|
83
|
-
concorde/src/la-billetterie/components/shop/shop.ts
|
|
84
|
-
concorde/src/la-billetterie/components/stats/dashboard/dashboard.ts
|
|
85
|
-
concorde/src/la-billetterie/components/stats/event/event-stats-check.ts
|
|
86
|
-
concorde/src/la-billetterie/components/stats/sales-summary/sales-summary.ts
|
|
87
|
-
concorde/src/la-billetterie/components/subscription/atoms/quick-select-display-toggle/quick-select-display-toggle.ts
|
|
88
|
-
concorde/src/la-billetterie/components/subscription/cart-quick-select.ts
|
|
89
|
-
concorde/src/la-billetterie/components/subscription/edit/subscription-renew-form.ts
|
|
90
|
-
concorde/src/la-billetterie/components/ticket/ticket-freeup.ts
|
|
91
|
-
concorde/src/la-billetterie/components/tickets-app/default-router.ts
|
|
92
|
-
concorde/src/la-billetterie/components/user/account/account-purchases.ts
|
|
93
|
-
concorde/src/la-billetterie/components/user/account/account-tickets.ts
|
|
94
|
-
concorde/src/la-billetterie/components/user/account/link-ticket/link-ticket.ts
|
|
95
|
-
concorde/src/la-billetterie/components/user/form/login.ts
|
|
96
|
-
concorde/src/la-billetterie/components/user/user-attach/buyer-attach-form.ts
|
|
97
|
-
concorde/src/la-billetterie/components/user/user-attach/buyer-attach.ts
|
|
98
|
-
concorde/src/la-billetterie/components/user/user-attach/owner-attach-form.ts
|
|
99
|
-
concorde/src/la-billetterie/components/user/user-attach/subscription-attach-form.ts
|
|
100
|
-
concorde/src/la-billetterie/components/user/user-attach/subscription-selector.ts
|
|
101
|
-
concorde/src/la-billetterie/components/user/user-selector/user-selector.ts
|
|
102
|
-
concorde/src/la-billetterie/components/user/user-suggest/user-suggest.ts
|
|
103
|
-
concorde/src/widgets/agenda/agenda.ts
|
|
104
|
-
```
|
|
105
|
-
|
|
106
|
-
Re-run audit:
|
|
107
|
-
|
|
108
|
-
```bash
|
|
109
|
-
# from la-billetterie
|
|
110
|
-
rg -l 'formDataProvider' concorde/src | while read f; do rg -q 'dataProvider\s*=' "$f" && echo "$f"; done
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
## Non-regression (Concorde docs)
|
|
114
|
-
|
|
115
|
-
Smoke form demos: input, textarea, select, checkbox (incl. check-all), radio, switch, button form modes, queue + `dataFilterProvider`, submit, validation / sameValueAs, input-autocomplete.
|
|
@@ -1,110 +0,0 @@
|
|
|
1
|
-
import { html, LitElement } from "lit";
|
|
2
|
-
import { customElement } from "lit/decorators.js";
|
|
3
|
-
import { DOCS_MOCK_GEO_SERVICE } from "../mock-api/urls";
|
|
4
|
-
|
|
5
|
-
import "../../core/components/ui/form/input-autocomplete/input-autocomplete";
|
|
6
|
-
import "../../core/components/ui/menu/menu-item";
|
|
7
|
-
|
|
8
|
-
type CommuneRow = { nom: string; code: string };
|
|
9
|
-
|
|
10
|
-
/** Ligne suggestion : pas de radio/name (évite d'écrire dans le form au render). */
|
|
11
|
-
const communeItem =
|
|
12
|
-
(valueKey: "nom" | "code") => (item: CommuneRow) =>
|
|
13
|
-
html`<sonic-menu-item
|
|
14
|
-
data-autocomplete-value=${item[valueKey]}
|
|
15
|
-
data-autocomplete-label=${item.nom}
|
|
16
|
-
>${item.nom}</sonic-menu-item
|
|
17
|
-
>`;
|
|
18
|
-
|
|
19
|
-
@customElement("docs-input-autocomplete-basic-demo")
|
|
20
|
-
export class DocsInputAutocompleteBasicDemo extends LitElement {
|
|
21
|
-
private items = communeItem("nom");
|
|
22
|
-
|
|
23
|
-
render() {
|
|
24
|
-
return html`
|
|
25
|
-
<sonic-input-autocomplete
|
|
26
|
-
class="w-64"
|
|
27
|
-
label="Ville"
|
|
28
|
-
formDataProvider="autoComplete-example-base"
|
|
29
|
-
name="nom"
|
|
30
|
-
placeholder="Paris, Lyon, Tours, ..."
|
|
31
|
-
serviceURL=${DOCS_MOCK_GEO_SERVICE}
|
|
32
|
-
dataProviderExpression="communes?limit=5"
|
|
33
|
-
.items=${this.items}
|
|
34
|
-
></sonic-input-autocomplete>
|
|
35
|
-
`;
|
|
36
|
-
}
|
|
37
|
-
}
|
|
38
|
-
|
|
39
|
-
@customElement("docs-input-autocomplete-code-demo")
|
|
40
|
-
export class DocsInputAutocompleteCodeDemo extends LitElement {
|
|
41
|
-
private items = communeItem("code");
|
|
42
|
-
|
|
43
|
-
render() {
|
|
44
|
-
return html`
|
|
45
|
-
<sonic-input-autocomplete
|
|
46
|
-
class="w-64"
|
|
47
|
-
label="Ville (code INSEE)"
|
|
48
|
-
formDataProvider="autoComplete-example"
|
|
49
|
-
name="code"
|
|
50
|
-
value="13055"
|
|
51
|
-
placeholder="Paris, Lyon, Tours, ..."
|
|
52
|
-
serviceURL=${DOCS_MOCK_GEO_SERVICE}
|
|
53
|
-
dataProviderExpression="communes?limit=5"
|
|
54
|
-
searchParameter="nom"
|
|
55
|
-
.items=${this.items}
|
|
56
|
-
></sonic-input-autocomplete>
|
|
57
|
-
`;
|
|
58
|
-
}
|
|
59
|
-
}
|
|
60
|
-
|
|
61
|
-
@customElement("docs-input-autocomplete-select-demo")
|
|
62
|
-
export class DocsInputAutocompleteSelectDemo extends LitElement {
|
|
63
|
-
private items = communeItem("code");
|
|
64
|
-
|
|
65
|
-
render() {
|
|
66
|
-
return html`
|
|
67
|
-
<sonic-input-autocomplete
|
|
68
|
-
select
|
|
69
|
-
class="w-64"
|
|
70
|
-
label="Ville (select)"
|
|
71
|
-
formDataProvider="autoComplete-example2"
|
|
72
|
-
name="code"
|
|
73
|
-
value="69123"
|
|
74
|
-
placeholder="Paris, Lyon, Tours, ..."
|
|
75
|
-
serviceURL=${DOCS_MOCK_GEO_SERVICE}
|
|
76
|
-
dataProviderExpression="communes?limit=5"
|
|
77
|
-
searchParameter="nom"
|
|
78
|
-
.items=${this.items}
|
|
79
|
-
></sonic-input-autocomplete>
|
|
80
|
-
`;
|
|
81
|
-
}
|
|
82
|
-
}
|
|
83
|
-
|
|
84
|
-
@customElement("docs-input-autocomplete-keyboard-demo")
|
|
85
|
-
export class DocsInputAutocompleteKeyboardDemo extends LitElement {
|
|
86
|
-
private items = (item: CommuneRow) =>
|
|
87
|
-
html`<sonic-menu-item
|
|
88
|
-
data-keyboard-nav="nav-autocomplete"
|
|
89
|
-
data-autocomplete-value=${item.nom}
|
|
90
|
-
data-autocomplete-label=${item.nom}
|
|
91
|
-
>${item.nom}</sonic-menu-item
|
|
92
|
-
>`;
|
|
93
|
-
|
|
94
|
-
render() {
|
|
95
|
-
return html`
|
|
96
|
-
<sonic-input-autocomplete
|
|
97
|
-
class="w-64"
|
|
98
|
-
label="Ville"
|
|
99
|
-
formDataProvider="autoComplete-example-keyboard"
|
|
100
|
-
name="nom"
|
|
101
|
-
data-keyboard-nav="nav-autocomplete"
|
|
102
|
-
placeholder="Paris, Lyon, Tours, ..."
|
|
103
|
-
serviceURL=${DOCS_MOCK_GEO_SERVICE}
|
|
104
|
-
dataProviderExpression="communes?limit=60"
|
|
105
|
-
minSearchLength="1"
|
|
106
|
-
.items=${this.items}
|
|
107
|
-
></sonic-input-autocomplete>
|
|
108
|
-
`;
|
|
109
|
-
}
|
|
110
|
-
}
|