@supersoniks/concorde 5.1.0 → 5.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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/.claude/launch.json +15 -0
- package/.claude/vite.http.config.mjs +7 -0
- package/.taste-skill/after/desktop-fold.jpg +0 -0
- package/.taste-skill/after/desktop-page-01.jpg +0 -0
- package/.taste-skill/after/desktop-page-02.jpg +0 -0
- package/.taste-skill/after/desktop-page-03.jpg +0 -0
- package/.taste-skill/after/mobile-fold.jpg +0 -0
- package/.taste-skill/after/mobile-page-01.jpg +0 -0
- package/.taste-skill/after/report.json +4103 -0
- package/.taste-skill/after/tablet-fold.jpg +0 -0
- package/.taste-skill/after/tablet-page-01.jpg +0 -0
- package/.taste-skill/after/tablet-page-02.jpg +0 -0
- package/.taste-skill/before/desktop-fold.jpg +0 -0
- package/.taste-skill/before/desktop-page-01.jpg +0 -0
- package/.taste-skill/before/desktop-page-02.jpg +0 -0
- package/.taste-skill/before/mobile-fold.jpg +0 -0
- package/.taste-skill/before/mobile-page-01.jpg +0 -0
- package/.taste-skill/before/report.json +2556 -0
- package/.taste-skill/before/tablet-fold.jpg +0 -0
- package/.taste-skill/before/tablet-page-01.jpg +0 -0
- package/.taste-skill/direction.json +510 -0
- package/.taste-skill/notes.md +84 -0
- package/.taste-skill/prod/desktop-fold.jpg +0 -0
- package/.taste-skill/prod/desktop-page-01.jpg +0 -0
- package/.taste-skill/prod/desktop-page-02.jpg +0 -0
- package/.taste-skill/prod/desktop-page-03.jpg +0 -0
- package/.taste-skill/prod/mobile-fold.jpg +0 -0
- package/.taste-skill/prod/mobile-page-01.jpg +0 -0
- package/.taste-skill/prod/mobile-page-02.jpg +0 -0
- package/.taste-skill/prod/report.json +1973 -0
- package/.taste-skill/prod/tablet-fold.jpg +0 -0
- package/.taste-skill/prod/tablet-page-01.jpg +0 -0
- package/.taste-skill/prod/tablet-page-02.jpg +0 -0
- package/.tmp-cem/custom-elements.json +2013 -2013
- package/AUDIT.md +228 -0
- package/PLAN-AMELIORATION.md +220 -0
- package/PLAN-DOCS-AGENTS.md +80 -0
- package/README.md +3 -3
- package/ai/skills/concorde/SKILL.md +1 -1
- package/ai/skills/concorde-get-set-dp/SKILL.md +3 -3
- package/ai/skills/concorde-theme/SKILL.md +1 -1
- package/build-infos.json +1 -1
- package/concorde-core.bundle.js +16 -16
- package/concorde-core.es.js +235 -233
- package/dist/concorde-core.bundle.js +16 -16
- package/dist/concorde-core.es.js +235 -233
- package/dist/img/archive/concorde-001-2cv.webp +0 -0
- package/dist/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
- package/dist/img/archive/concorde-red-arrows-2002.webm +0 -0
- package/dist/img/archive/credits.json +28 -0
- package/docs/.htaccess +75 -0
- package/docs/404.html +15 -0
- package/docs/404.md +5 -0
- package/docs/assets/index-BgG6FFPt.js +11765 -0
- package/docs/assets/index-x89XINSG.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 +198 -0
- package/docs/core/components/functional/list/list.md +121 -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/{crawl/core → core}/components/functional/subscriber/subscriber.html +6 -5
- 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/{crawl/core → core}/components/ui/menu/menu.html +189 -116
- 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/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 +86 -0
- package/docs/docs/decorators/bind.md +77 -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/{crawl/docs/_getting-started → docs/getting-started}/ai-agents.html +12 -11
- package/{src/docs/_getting-started → docs/docs/getting-started}/ai-agents.md +3 -3
- package/docs/docs/getting-started/components.html +27 -0
- package/docs/docs/getting-started/components.md +5 -0
- package/docs/{crawl/docs/_getting-started → docs/getting-started}/create-a-component.html +11 -14
- package/docs/{src/docs/_getting-started → docs/getting-started}/create-a-component.md +3 -6
- package/docs/{crawl/docs/_core-concept → docs/getting-started}/dataFlow.html +26 -29
- package/docs/{src/docs/_core-concept → docs/getting-started}/dataFlow.md +17 -18
- package/docs/docs/getting-started/installation.html +69 -0
- package/docs/docs/getting-started/installation.md +36 -0
- package/docs/{crawl/docs/_getting-started → docs/getting-started}/my-first-component.html +13 -22
- package/docs/{src/docs/_getting-started → 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/{src/docs/_getting-started → docs/docs/getting-started}/theming.md +2 -2
- package/docs/docs/index.html +99 -0
- package/docs/{crawl/docs/_misc → docs/misc}/api-configuration.html +18 -18
- package/docs/{src/docs/_misc → docs/misc}/api-configuration.md +10 -12
- package/docs/{crawl/docs/_misc → docs/misc}/dataProviderKey.html +12 -11
- package/{src/docs/_misc → docs/docs/misc}/dataProviderKey.md +4 -4
- package/docs/{crawl/docs/_misc → docs/misc}/docs-mock-api.html +25 -28
- package/docs/{src/docs/_misc → docs/misc}/docs-mock-api.md +12 -13
- package/docs/{crawl/docs/_misc → docs/misc}/dynamic-path.html +16 -15
- package/{src/docs/_misc → docs/docs/misc}/dynamic-path.md +8 -8
- package/docs/{crawl/docs/_misc → docs/misc}/endpoint.html +16 -15
- package/{src/docs/_misc → docs/docs/misc}/endpoint.md +8 -8
- package/docs/{crawl/docs/_misc → docs/misc}/html-integration.html +12 -15
- package/docs/{src/docs/_misc → docs/misc}/html-integration.md +4 -5
- package/docs/docs-mock-api-sw.js +60 -223
- package/docs/docs-mock-api-sw.js.map +4 -4
- package/docs/hubs/decorators.html +443 -0
- package/docs/hubs/form-components.html +404 -0
- package/docs/hubs/remote-data.html +371 -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/index.html +96 -67
- package/docs/index.md +22 -0
- package/docs/llms-full.txt +3329 -3295
- package/docs/llms.txt +94 -92
- package/docs/robots.txt +11 -10
- package/docs/sitemap.xml +78 -78
- package/docs/src/core/components/functional/date/date.md +91 -231
- package/docs/src/core/components/functional/fetch/fetch.md +66 -83
- package/docs/src/core/components/functional/if/if.md +28 -3
- package/docs/src/core/components/functional/jsonata/jsonata.md +42 -37
- package/docs/src/core/components/functional/list/list.md +99 -43
- package/docs/src/core/components/functional/mix/mix.md +31 -26
- package/docs/src/core/components/functional/queue/queue.md +40 -61
- package/docs/src/core/components/functional/router/router.md +64 -65
- 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/example.json +19 -86
- package/docs/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
- package/docs/src/core/components/functional/sdui/sdui.md +196 -245
- package/docs/src/core/components/functional/states/states.md +86 -61
- package/docs/src/core/components/functional/submit/submit.md +64 -72
- package/docs/src/core/components/functional/translation/translation.md +38 -0
- package/docs/src/core/components/functional/value/value.md +34 -22
- package/docs/src/core/components/ui/alert/alert.md +139 -74
- package/docs/src/core/components/ui/alert-messages/alert-messages.md +85 -0
- package/docs/src/core/components/ui/badge/badge.md +137 -83
- package/docs/src/core/components/ui/button/button.md +139 -105
- package/docs/src/core/components/ui/captcha/captcha.md +50 -6
- package/docs/src/core/components/ui/card/card.md +183 -65
- package/docs/src/core/components/ui/divider/divider.md +104 -13
- package/docs/src/core/components/ui/form/checkbox/checkbox.md +90 -42
- package/docs/src/core/components/ui/form/fieldset/fieldset.md +135 -103
- package/docs/src/core/components/ui/form/form-actions/form-actions.md +71 -50
- package/docs/src/core/components/ui/form/form-layout/form-layout.md +99 -34
- package/docs/src/core/components/ui/form/input/input.md +95 -95
- package/docs/src/core/components/ui/form/radio/radio.md +55 -34
- package/docs/src/core/components/ui/form/select/select.md +60 -45
- package/docs/src/core/components/ui/form/switch/switch.md +57 -34
- package/docs/src/core/components/ui/form/textarea/textarea.md +55 -38
- package/docs/src/core/components/ui/group/group.md +49 -47
- package/docs/src/core/components/ui/icon/icon.md +132 -43
- package/docs/src/core/components/ui/image/image.md +132 -72
- package/docs/src/core/components/ui/link/link.md +46 -8
- package/docs/src/core/components/ui/loader/loader.md +55 -23
- package/docs/src/core/components/ui/menu/menu.md +155 -114
- package/docs/src/core/components/ui/modal/modal.md +154 -62
- package/docs/src/core/components/ui/pop/pop.md +185 -65
- package/docs/src/core/components/ui/progress/progress.md +76 -30
- package/docs/src/core/components/ui/table/table.md +146 -334
- package/docs/src/core/components/ui/theme/theme.md +97 -0
- package/docs/src/core/components/ui/toast/toast.md +80 -99
- package/docs/src/core/components/ui/tooltip/tooltip.md +52 -45
- 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 +77 -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 → getting-started}/ai-agents.md +3 -3
- package/docs/src/docs/getting-started/components.md +5 -0
- package/{src/docs/_getting-started → docs/src/docs/getting-started}/create-a-component.md +3 -6
- package/{src/docs/_core-concept → docs/src/docs/getting-started}/dataFlow.md +17 -18
- package/docs/src/docs/getting-started/installation.md +36 -0
- package/{src/docs/_getting-started → docs/src/docs/getting-started}/my-first-component.md +5 -14
- package/docs/src/docs/getting-started/start.md +35 -0
- package/docs/src/docs/getting-started/theming.md +253 -0
- package/{src/docs/_misc → docs/src/docs/misc}/api-configuration.md +10 -12
- package/docs/src/docs/{_misc → misc}/dataProviderKey.md +4 -4
- package/{src/docs/_misc → docs/src/docs/misc}/docs-mock-api.md +12 -13
- package/docs/src/docs/{_misc → misc}/dynamic-path.md +8 -8
- package/docs/src/docs/{_misc → misc}/endpoint.md +8 -8
- package/{src/docs/_misc → docs/src/docs/misc}/html-integration.md +4 -5
- package/docs/src/docs/search/docs-search.json +3729 -2949
- package/docs/src/tsconfig.json +176 -5
- package/index.html +94 -67
- package/package.json +11 -4
- package/public/docs-mock-api-sw.js +58 -223
- package/public/docs-mock-api-sw.js.map +4 -4
- package/public/img/archive/concorde-001-2cv.webp +0 -0
- package/public/img/archive/concorde-red-arrows-2002-poster.jpg +0 -0
- package/public/img/archive/concorde-red-arrows-2002.webm +0 -0
- package/public/img/archive/credits.json +28 -0
- 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/robots.txt +11 -10
- package/scripts/docs-markdown-vite-plugin.ts +37 -0
- package/scripts/docs-public-url.mjs +50 -0
- package/scripts/docs.htaccess +75 -0
- package/scripts/generate-crawl-docs.mjs +207 -116
- package/scripts/generate-crawl-docs.test.mjs +124 -0
- package/scripts/post-build-docs.js +34 -50
- package/scripts/post-build.mjs +0 -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/if/if.ts +0 -0
- package/src/core/components/functional/jsonata/jsonata.md +42 -37
- package/src/core/components/functional/list/list.demo.ts +0 -0
- package/src/core/components/functional/list/list.md +99 -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/router/router.ts +0 -0
- package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +0 -0
- 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/sdui/types.ts +0 -0
- 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/subscriber/subscriber.ts +0 -0
- package/src/core/components/functional/translation/translation.md +38 -0
- package/src/core/components/functional/value/value.md +34 -22
- package/src/core/components/functional/value/value.ts +0 -0
- package/src/core/components/ui/_css/size.ts +0 -0
- 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/altchaStyles.ts +0 -0
- 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/modal/modal.ts +14 -11
- 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/mixins/Subscriber.ts +0 -0
- package/src/core/utils/DataBindObserver.ts +0 -0
- package/src/core/utils/LocationHandler.spec.ts +80 -0
- package/src/core/utils/LocationHandler.ts +5 -9
- package/src/core/utils/Objects.ts +0 -0
- package/src/core/utils/route.ts +0 -0
- package/src/docs/code.ts +88 -75
- package/src/docs/components/docs-demo-sources.ts +70 -147
- package/src/docs/components/docs-lit-demo.ts +20 -40
- 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 +77 -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 +46 -0
- package/src/docs/docs-location.ts +123 -32
- package/src/docs/docs.ts +6 -2
- package/src/docs/example/decorators-demo-bind-demos.ts +81 -116
- 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-boarding-pass-demo.ts +134 -0
- 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 +33 -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/example/users.ts +0 -0
- package/src/docs/getting-started/ai-agents.md +76 -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 +240 -71
- package/src/docs/home/catalog.ts +44 -0
- package/src/docs/home/home.ts +520 -0
- package/src/docs/home/mach-stage.ts +389 -0
- package/src/docs/layout.ts +12 -11
- 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/components-index.ts +56 -0
- package/src/docs/navigation/navigation.ts +219 -232
- package/src/docs/navigation/pager.ts +67 -0
- package/src/docs/navigation/toc.ts +101 -0
- package/src/docs/search/docs-search.json +2419 -4374
- package/src/docs/search/markdown-renderer.ts +33 -7
- package/src/docs/search/page.ts +9 -6
- package/src/docs/search/search.ts +154 -122
- package/src/docs/shiki/index.ts +109 -0
- package/src/docs/tailwind/css/base/scrollbar.css +22 -0
- package/src/docs/tailwind/css/base/theme.css +96 -0
- package/src/docs/tailwind/css/base/typography.css +4 -0
- package/src/docs/tailwind/css/docs/boarding-pass.css +65 -0
- package/src/docs/tailwind/css/docs/content.css +32 -0
- package/src/docs/tailwind/css/docs/page.css +10 -0
- package/src/docs/tailwind/css/docs.css +9 -0
- package/src/docs/tailwind/css/home/hero.css +210 -0
- package/src/docs/tailwind/css/home/motion.css +84 -0
- package/src/docs/tailwind/css/home/sections.css +416 -0
- package/src/docs/tailwind/css/tailwind.css +7 -185
- package/src/tsconfig.json +23 -2
- package/src/tsconfig.tsbuildinfo +1 -1
- package/tailwind.config.js +8 -4
- package/vite.config.mts +11 -2
- package/.agents/skills/concorde-component-docs/SKILL.md +0 -194
- package/.github/workflows/ci.yml +0 -21
- package/.github-export-ignore +0 -30
- package/CONTRIBUTING.md +0 -59
- package/DEV.md +0 -54
- package/LICENSE +0 -21
- package/OPEN_SOURCE_CHECKPOINT.md +0 -133
- package/concorde-3d.bundle.js +0 -3960
- package/concorde-3d.es.js +0 -33433
- package/concorde-hugging-face-infer.bundle.js +0 -32
- package/concorde-hugging-face-infer.es.js +0 -2952
- package/concorde-interactive.bundle.js +0 -1157
- package/concorde-interactive.es.js +0 -10734
- package/concorde-shader.bundle.js +0 -116
- package/concorde-shader.es.js +0 -8353
- package/concorde-webgpu.bundle.js +0 -307
- package/concorde-webgpu.es.js +0 -8627
- package/docs/assets/index-D8MVWqY6.js +0 -12251
- package/docs/assets/index-DiD0qYvE.css +0 -1
- package/docs/crawl/core/components/functional/date/date.html +0 -190
- package/docs/crawl/core/components/functional/fetch/fetch.html +0 -109
- package/docs/crawl/core/components/functional/if/if.html +0 -27
- package/docs/crawl/core/components/functional/jsonata/jsonata.html +0 -79
- package/docs/crawl/core/components/functional/list/list.html +0 -70
- package/docs/crawl/core/components/functional/mix/mix.html +0 -45
- package/docs/crawl/core/components/functional/queue/queue.html +0 -96
- package/docs/crawl/core/components/functional/router/router.html +0 -106
- package/docs/crawl/core/components/functional/sdui/sdui.html +0 -269
- package/docs/crawl/core/components/functional/states/states.html +0 -66
- package/docs/crawl/core/components/functional/submit/submit.html +0 -160
- package/docs/crawl/core/components/functional/value/value.html +0 -51
- package/docs/crawl/core/components/ui/alert/alert.html +0 -110
- package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +0 -23
- package/docs/crawl/core/components/ui/badge/badge.html +0 -119
- package/docs/crawl/core/components/ui/button/button.html +0 -149
- package/docs/crawl/core/components/ui/captcha/captcha.html +0 -30
- package/docs/crawl/core/components/ui/card/card.html +0 -99
- package/docs/crawl/core/components/ui/divider/divider.html +0 -58
- package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +0 -73
- package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +0 -135
- package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +0 -79
- package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +0 -62
- package/docs/crawl/core/components/ui/form/input/input.html +0 -109
- package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +0 -38
- package/docs/crawl/core/components/ui/form/radio/radio.html +0 -56
- package/docs/crawl/core/components/ui/form/select/select.html +0 -73
- package/docs/crawl/core/components/ui/form/switch/switch.html +0 -56
- package/docs/crawl/core/components/ui/form/textarea/textarea.html +0 -59
- package/docs/crawl/core/components/ui/group/group.html +0 -82
- package/docs/crawl/core/components/ui/icon/icon.html +0 -133
- package/docs/crawl/core/components/ui/image/image.html +0 -110
- package/docs/crawl/core/components/ui/link/link.html +0 -42
- package/docs/crawl/core/components/ui/loader/loader.html +0 -50
- package/docs/crawl/core/components/ui/modal/modal.html +0 -117
- package/docs/crawl/core/components/ui/pop/pop.html +0 -102
- package/docs/crawl/core/components/ui/progress/progress.html +0 -58
- package/docs/crawl/core/components/ui/table/table.html +0 -413
- package/docs/crawl/core/components/ui/toast/toast.html +0 -122
- package/docs/crawl/core/components/ui/tooltip/tooltip.html +0 -79
- package/docs/crawl/docs/_core-concept/overview.html +0 -66
- package/docs/crawl/docs/_core-concept/subscriber.html +0 -75
- package/docs/crawl/docs/_decorators/ancestor-attribute.html +0 -116
- package/docs/crawl/docs/_decorators/auto-subscribe.html +0 -202
- package/docs/crawl/docs/_decorators/bind.html +0 -141
- package/docs/crawl/docs/_decorators/get.html +0 -149
- package/docs/crawl/docs/_decorators/handle.html +0 -165
- package/docs/crawl/docs/_decorators/on-assign.html +0 -355
- package/docs/crawl/docs/_decorators/patch.html +0 -78
- package/docs/crawl/docs/_decorators/post.html +0 -139
- package/docs/crawl/docs/_decorators/publish.html +0 -61
- package/docs/crawl/docs/_decorators/put.html +0 -78
- package/docs/crawl/docs/_decorators/subscribe.html +0 -109
- package/docs/crawl/docs/_decorators/wait-for-ancestors.html +0 -137
- package/docs/crawl/docs/_directives/sub.html +0 -93
- package/docs/crawl/docs/_getting-started/concorde-manual-install.html +0 -100
- package/docs/crawl/docs/_getting-started/concorde-outside.html +0 -58
- package/docs/crawl/docs/_getting-started/my-first-subscriber.html +0 -110
- package/docs/crawl/docs/_getting-started/pubsub.html +0 -62
- package/docs/crawl/docs/_getting-started/start.html +0 -76
- package/docs/crawl/docs/_getting-started/theming.html +0 -85
- package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +0 -138
- package/docs/crawl/hubs/decorators.html +0 -547
- package/docs/crawl/hubs/form-components.html +0 -359
- package/docs/crawl/hubs/remote-data.html +0 -452
- package/docs/crawl/index.html +0 -101
- package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
- package/docs/src/docs/_core-concept/overview.md +0 -57
- package/docs/src/docs/_core-concept/subscriber.md +0 -75
- package/docs/src/docs/_decorators/ancestor-attribute.md +0 -127
- package/docs/src/docs/_decorators/auto-subscribe.md +0 -202
- package/docs/src/docs/_decorators/bind.md +0 -167
- package/docs/src/docs/_decorators/get.md +0 -162
- package/docs/src/docs/_decorators/handle.md +0 -175
- package/docs/src/docs/_decorators/on-assign.md +0 -390
- package/docs/src/docs/_decorators/patch.md +0 -70
- package/docs/src/docs/_decorators/post.md +0 -146
- package/docs/src/docs/_decorators/publish.md +0 -55
- package/docs/src/docs/_decorators/put.md +0 -70
- package/docs/src/docs/_decorators/subscribe.md +0 -100
- package/docs/src/docs/_decorators/wait-for-ancestors.md +0 -163
- package/docs/src/docs/_directives/sub.md +0 -91
- package/docs/src/docs/_getting-started/concorde-manual-install.md +0 -133
- package/docs/src/docs/_getting-started/concorde-outside.md +0 -33
- package/docs/src/docs/_getting-started/my-first-subscriber.md +0 -120
- package/docs/src/docs/_getting-started/pubsub.md +0 -37
- package/docs/src/docs/_getting-started/start.md +0 -47
- package/docs/src/docs/_getting-started/theming.md +0 -91
- package/docs/src/docs/_misc/formelement-subscriber-removal.md +0 -115
- package/docs/src/tsconfig.declarations.json +0 -22
- package/docs/src/tsconfig.emit.json +0 -23
- package/gitlab/job_github_mirror.sh +0 -39
- package/scripts/github-export.mjs +0 -150
- package/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
- package/src/css.d.ts +0 -19
- 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/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/prism/index.ts +0 -6
- package/src/docs/prism/prism.css +0 -158
- package/src/docs/prism/prism.js +0 -1022
- package/src/tsconfig.declarations.json +0 -22
- package/src/tsconfig.emit.json +0 -23
|
@@ -1,26 +1,24 @@
|
|
|
1
1
|
<!DOCTYPE html>
|
|
2
|
-
<html lang="
|
|
2
|
+
<html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/getting-started/my-first-component" data-doc-id="docs/getting-started/my-first-component">
|
|
3
3
|
<head>
|
|
4
4
|
<meta charset="UTF-8">
|
|
5
5
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>My first component — Concorde</title>
|
|
6
|
+
<title>My first component — Concorde by Supersoniks</title>
|
|
7
7
|
<meta name="description" content="Build a Lit user card with Tailwind and Concorde UI, then connect it to the DataProvider store: declare the data configuration (type, key, scope), and let @subscribe keep the card in sync.">
|
|
8
|
-
<meta name="keywords" content="Concorde, supersoniks, docs/
|
|
9
|
-
<meta name="concorde-doc-id" content="docs/
|
|
10
|
-
<link rel="canonical" href="https://concorde.supersoniks.org/
|
|
8
|
+
<meta name="keywords" content="Concorde, supersoniks, docs/getting-started/my-first-component, my-first-component, My first component, guide, @subscribe, src/docs/tailwind.ts, ${unsafeCSS(tailwindImport)}, DocsUserData, user, docsUserRowKey, "${dataProvider}", { dataProvider: string | null }">
|
|
9
|
+
<meta name="concorde-doc-id" content="docs/getting-started/my-first-component">
|
|
10
|
+
<link rel="canonical" href="https://concorde.supersoniks.org/docs/getting-started/my-first-component">
|
|
11
|
+
<link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/getting-started/my-first-component.md">
|
|
11
12
|
</head>
|
|
12
13
|
<body>
|
|
13
14
|
<header>
|
|
14
|
-
<p><a href="
|
|
15
|
+
<p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/getting-started/my-first-component">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
|
|
15
16
|
</header>
|
|
16
17
|
<main>
|
|
17
18
|
<article>
|
|
18
|
-
<p class="doc-lead" id="doc-summary"><strong>Concorde guide — My first component</strong>. Build a Lit user card with Tailwind and Concorde UI, then connect it to the DataProvider store: declare the data configuration (type, key, scope), and let @subscribe keep the card in sync. <span>Doc ID: <code>docs/
|
|
19
|
+
<p class="doc-lead" id="doc-summary"><strong>Concorde guide — My first component</strong>. Build a Lit user card with Tailwind and Concorde UI, then connect it to the DataProvider store: declare the data configuration (type, key, scope), and let @subscribe keep the card in sync. <span>Doc ID: <code>docs/getting-started/my-first-component</code>. Keywords: Concorde, supersoniks, docs/getting-started/my-first-component, my-first-component, My first component, guide, @subscribe, src/docs/tailwind.ts, ${unsafeCSS(tailwindImport)}, DocsUserData, user, docsUserRowKey, "${dataProvider}", { dataProvider: string | null }. URL: <a href="https://concorde.supersoniks.org/docs/getting-started/my-first-component">https://concorde.supersoniks.org/docs/getting-started/my-first-component</a>.</span></p>
|
|
19
20
|
<h1 id="my-first-component">My first component</h1>
|
|
20
21
|
<p>Build a <strong>Lit</strong> user card with Tailwind and Concorde UI, then connect it to the <strong>DataProvider</strong> store: declare the <strong>data configuration</strong> (type, key, scope), and let <strong><code>@subscribe</code></strong> keep the card in sync.</p>
|
|
21
|
-
<blockquote>
|
|
22
|
-
<p>Legacy approach with the <strong>Subscriber mixin</strong>: <a href="./my-first-subscriber.html#my-first-subscriber">Legacy: My first subscriber</a>.</p>
|
|
23
|
-
</blockquote>
|
|
24
22
|
<h2 id="1-lit-component--tailwind">1. Lit component + Tailwind</h2>
|
|
25
23
|
<p>Export Tailwind once (e.g. <code>src/docs/tailwind.ts</code> in this repo):</p>
|
|
26
24
|
<pre><code class="language-typescript">import { css, unsafeCSS } from "lit";
|
|
@@ -73,14 +71,14 @@ export const docsUserRowKey = new DataProviderKey&lt;
|
|
|
73
71
|
{ dataProvider: string | null }
|
|
74
72
|
&gt;("${dataProvider}");
|
|
75
73
|
</code></pre>
|
|
76
|
-
<p>The second generic (<code>{ dataProvider: string | null }</code>) lists what the host must expose so <code>"${dataProvider}"</code> can be resolved. See <a href="
|
|
74
|
+
<p>The second generic (<code>{ dataProvider: string | null }</code>) lists what the host must expose so <code>"${dataProvider}"</code> can be resolved. See <a href="/docs/misc/dataProviderKey">DataProviderKey</a> and <a href="/docs/misc/dynamic-path">Dynamic path placeholders</a>.</p>
|
|
77
75
|
<h3 id="scope--which-store-segment-applies">Scope — which store segment applies</h3>
|
|
78
|
-
<p>A parent sets <code>dataProvider=${docsUserScopeAKey.path}</code> (or a list row sets <code>…/list-item/0</code>). <a href="
|
|
76
|
+
<p>A parent sets <code>dataProvider=${docsUserScopeAKey.path}</code> (or a list row sets <code>…/list-item/0</code>). <a href="/docs/decorators/ancestor-attribute"><code>@ancestorAttribute</code></a> copies that attribute onto <code>this.dataProvider</code>, so the key resolves to the correct branch.</p>
|
|
79
77
|
<pre><code class="language-typescript">@ancestorAttribute("dataProvider")
|
|
80
78
|
dataProvider: string | null = null;
|
|
81
79
|
</code></pre>
|
|
82
80
|
<h3 id="subscribe--keep-the-card-in-sync">Subscribe — keep the card in sync</h3>
|
|
83
|
-
<p><a href="
|
|
81
|
+
<p><a href="/docs/decorators/subscribe"><code>@subscribe</code></a> watches <code>docsUserRowKey</code> and updates <code>user</code> when the store changes. Use <code>@state()</code> so Lit re-renders. The template reads <code>this.user</code> like any other property.</p>
|
|
84
82
|
<pre><code class="language-typescript">import { html, LitElement, nothing } from "lit";
|
|
85
83
|
import { customElement, state } from "lit/decorators.js";
|
|
86
84
|
import {
|
|
@@ -158,7 +156,7 @@ export class DocsUsersList extends LitElement {
|
|
|
158
156
|
}
|
|
159
157
|
}
|
|
160
158
|
</code></pre>
|
|
161
|
-
<p>See <a href="
|
|
159
|
+
<p>See <a href="/docs/misc/docs-mock-api">Local API demos</a> for <code>serviceURL="/docs-mock-api"</code>.</p>
|
|
162
160
|
<h2 id="4-form-preview-with-formdataprovider">4. Form preview with <code>formDataProvider</code></h2>
|
|
163
161
|
<p>Edit fields in a form; the card follows the same <code>docsUserRowKey</code> when the preview host sets <code>dataProvider="userPreview"</code>.</p>
|
|
164
162
|
<pre><code><div class="grid grid-cols-1 gap-4 max-w-xl">
|
|
@@ -174,14 +172,7 @@ export class DocsUsersList extends LitElement {
|
|
|
174
172
|
</div>
|
|
175
173
|
</div>
|
|
176
174
|
</code></pre>
|
|
177
|
-
<p>Use <code>formDataProvider</code> + <code>name</code> on inputs — no manual <code>@input</code> handlers (<a href="
|
|
178
|
-
<h2 id="next-steps">Next steps</h2>
|
|
179
|
-
<ul>
|
|
180
|
-
<li><a href="../_core-concept/dataFlow.html#dataFlow">Data flow</a> — full map</li>
|
|
181
|
-
<li><a href="../_misc/dataProviderKey.html#dataProviderKey">DataProviderKey</a> — typed paths and host constraints</li>
|
|
182
|
-
<li><a href="../_decorators/subscribe.html#subscribe">@subscribe</a> / <a href="../_directives/sub.html#sub">sub()</a> — read-only in templates</li>
|
|
183
|
-
<li><a href="../../core/components/functional/list/list.html#list">List</a> — <code>.items</code>, <code>.noItems</code>, <code>.skeleton</code></li>
|
|
184
|
-
</ul>
|
|
175
|
+
<p>Use <code>formDataProvider</code> + <code>name</code> on inputs — no manual <code>@input</code> handlers (<a href="/docs/getting-started/dataFlow">Data flow</a>).</p>
|
|
185
176
|
|
|
186
177
|
</article>
|
|
187
178
|
</main>
|
|
@@ -2,8 +2,6 @@
|
|
|
2
2
|
|
|
3
3
|
Build a **Lit** user card with Tailwind and Concorde UI, then connect it to the **DataProvider** store: declare the **data configuration** (type, key, scope), and let **`@subscribe`** keep the card in sync.
|
|
4
4
|
|
|
5
|
-
> Legacy approach with the **Subscriber mixin**: [Legacy: My first subscriber](#docs/_getting-started/my-first-subscriber.md/my-first-subscriber).
|
|
6
|
-
|
|
7
5
|
## 1. Lit component + Tailwind
|
|
8
6
|
|
|
9
7
|
Export Tailwind once (e.g. `src/docs/tailwind.ts` in this repo):
|
|
@@ -81,11 +79,11 @@ export const docsUserRowKey = new DataProviderKey<
|
|
|
81
79
|
</template>
|
|
82
80
|
</sonic-code>
|
|
83
81
|
|
|
84
|
-
The second generic (`{ dataProvider: string | null }`) lists what the host must expose so `"${dataProvider}"` can be resolved. See [DataProviderKey](
|
|
82
|
+
The second generic (`{ dataProvider: string | null }`) lists what the host must expose so `"${dataProvider}"` can be resolved. See [DataProviderKey](/docs/misc/dataProviderKey) and [Dynamic path placeholders](/docs/misc/dynamic-path).
|
|
85
83
|
|
|
86
84
|
### Scope — which store segment applies
|
|
87
85
|
|
|
88
|
-
A parent sets `dataProvider=${docsUserScopeAKey.path}` (or a list row sets `…/list-item/0`). [`@ancestorAttribute`](
|
|
86
|
+
A parent sets `dataProvider=${docsUserScopeAKey.path}` (or a list row sets `…/list-item/0`). [`@ancestorAttribute`](/docs/decorators/ancestor-attribute) copies that attribute onto `this.dataProvider`, so the key resolves to the correct branch.
|
|
89
87
|
|
|
90
88
|
<sonic-code language="typescript">
|
|
91
89
|
<template>
|
|
@@ -96,7 +94,7 @@ dataProvider: string | null = null;
|
|
|
96
94
|
|
|
97
95
|
### Subscribe — keep the card in sync
|
|
98
96
|
|
|
99
|
-
[`@subscribe`](
|
|
97
|
+
[`@subscribe`](/docs/decorators/subscribe) watches `docsUserRowKey` and updates `user` when the store changes. Use `@state()` so Lit re-renders. The template reads `this.user` like any other property.
|
|
100
98
|
|
|
101
99
|
<sonic-code language="typescript">
|
|
102
100
|
<template>
|
|
@@ -203,7 +201,7 @@ export class DocsUsersList extends LitElement {
|
|
|
203
201
|
</template>
|
|
204
202
|
</sonic-code>
|
|
205
203
|
|
|
206
|
-
See [Local API demos](
|
|
204
|
+
See [Local API demos](/docs/misc/docs-mock-api) for `serviceURL="/docs-mock-api"`.
|
|
207
205
|
|
|
208
206
|
## 4. Form preview with `formDataProvider`
|
|
209
207
|
|
|
@@ -226,11 +224,4 @@ Edit fields in a form; the card follows the same `docsUserRowKey` when the previ
|
|
|
226
224
|
</template>
|
|
227
225
|
</sonic-code>
|
|
228
226
|
|
|
229
|
-
Use `formDataProvider` + `name` on inputs — no manual `@input` handlers ([Data flow](
|
|
230
|
-
|
|
231
|
-
## Next steps
|
|
232
|
-
|
|
233
|
-
- [Data flow](#docs/_core-concept/dataFlow.md/dataFlow) — full map
|
|
234
|
-
- [DataProviderKey](#docs/_misc/dataProviderKey.md/dataProviderKey) — typed paths and host constraints
|
|
235
|
-
- [@subscribe](#docs/_decorators/subscribe.md/subscribe) / [sub()](#docs/_directives/sub.md/sub) — read-only in templates
|
|
236
|
-
- [List](#core/components/functional/list/list.md/list) — `.items`, `.noItems`, `.skeleton`
|
|
227
|
+
Use `formDataProvider` + `name` on inputs — no manual `@input` handlers ([Data flow](/docs/getting-started/dataFlow)).
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/getting-started/start" data-doc-id="docs/getting-started/start">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
+
<title>Introduction — Concorde by Supersoniks</title>
|
|
7
|
+
<meta name="description" content="Based on lit.dev, Concorde is a collection of web components for shared apps and websites.">
|
|
8
|
+
<meta name="keywords" content="Concorde, supersoniks, docs/getting-started/start, start, Introduction, guide, get, set, formDataProvider, yarn ai:sync">
|
|
9
|
+
<meta name="concorde-doc-id" content="docs/getting-started/start">
|
|
10
|
+
<link rel="canonical" href="https://concorde.supersoniks.org/docs/getting-started/start">
|
|
11
|
+
<link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/getting-started/start.md">
|
|
12
|
+
</head>
|
|
13
|
+
<body>
|
|
14
|
+
<header>
|
|
15
|
+
<p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/getting-started/start">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
|
|
16
|
+
</header>
|
|
17
|
+
<main>
|
|
18
|
+
<article>
|
|
19
|
+
<p class="doc-lead" id="doc-summary"><strong>Concorde guide — Introduction</strong>. Based on lit.dev, Concorde is a collection of web components for shared apps and websites. <span>Doc ID: <code>docs/getting-started/start</code>. Keywords: Concorde, supersoniks, docs/getting-started/start, start, Introduction, guide, get, set, formDataProvider, yarn ai:sync. URL: <a href="https://concorde.supersoniks.org/docs/getting-started/start">https://concorde.supersoniks.org/docs/getting-started/start</a>.</span></p>
|
|
20
|
+
<h1 id="introduction">Introduction</h1>
|
|
21
|
+
<h2 id="what-is-concorde">What is Concorde?</h2>
|
|
22
|
+
<p>Based on <strong><a href="https://lit.dev">lit.dev</a></strong>, Concorde is a collection of web components for shared apps and websites.<br>Build UIs without tying components to a specific host stack, while keeping visual consistency through the smallest set of CSS variables needed to define a theme.</p>
|
|
23
|
+
<h2 id="why-and-use-case">Why and use case</h2>
|
|
24
|
+
<p>In 2022, Supersoniks needed a new ticketing stack for nearly 100 sites — mobile apps, modern sites, and legacy PHP without bundlers.<br>One composable web-component library replaced many one-off apps. Lit was chosen for broad runtime compatibility.</p>
|
|
25
|
+
<h3 id="stack">Stack</h3>
|
|
26
|
+
<ul>
|
|
27
|
+
<li>Lit</li>
|
|
28
|
+
<li>TypeScript</li>
|
|
29
|
+
<li>Vite</li>
|
|
30
|
+
<li>Tailwind (starter kit, not required in the core package)</li>
|
|
31
|
+
</ul>
|
|
32
|
+
<h3 id="functional-features">Functional features</h3>
|
|
33
|
+
<ul>
|
|
34
|
+
<li><strong>DataProvider</strong> store (decorators, <code>get</code> / <code>set</code>)</li>
|
|
35
|
+
<li>Forms (<code>formDataProvider</code>)</li>
|
|
36
|
+
<li>Lists, queues, lazy loading</li>
|
|
37
|
+
<li>Router, states, UI kit with status variants</li>
|
|
38
|
+
</ul>
|
|
39
|
+
<h2 id="start-a-new-project">Start a new project</h2>
|
|
40
|
+
<pre><code class="language-bash">npx @supersoniks/create-concorde-ts-starter "project_name"
|
|
41
|
+
</code></pre>
|
|
42
|
+
<p>The starter runs <strong><code>yarn ai:sync</code></strong> for you. Details: <a href="/docs/getting-started/ai-agents">AI agents (skills)</a>.</p>
|
|
43
|
+
|
|
44
|
+
</article>
|
|
45
|
+
</main>
|
|
46
|
+
</body>
|
|
47
|
+
</html>
|
|
@@ -24,18 +24,6 @@ One composable web-component library replaced many one-off apps. Lit was chosen
|
|
|
24
24
|
* Lists, queues, lazy loading
|
|
25
25
|
* Router, states, UI kit with status variants
|
|
26
26
|
|
|
27
|
-
## Learn Concorde
|
|
28
|
-
|
|
29
|
-
| Step | Page |
|
|
30
|
-
|------|------|
|
|
31
|
-
| 1 | [My first component](#docs/_getting-started/my-first-component.md/my-first-component) — Lit card, `@ancestorAttribute`, `@bind`, mock API |
|
|
32
|
-
| 2 | [Data flow](#docs/_core-concept/dataFlow.md/dataFlow) — Core concepts: decorators and APIs |
|
|
33
|
-
| 3 | [Local API demos](#docs/_misc/docs-mock-api.md/docs-mock-api) — offline `serviceURL` for this site (Misc) |
|
|
34
|
-
| 4 | [create-concorde-ts-starter](https://www.npmjs.com/package/@supersoniks/create-concorde-ts-starter) — **recommended** project kit (Vite, Tailwind, `yarn ai:sync`) |
|
|
35
|
-
| 5 | [AI agents (skills)](#docs/_getting-started/ai-agents.md/ai-agents) — `AGENTS.md`, Cursor / JetBrains rules |
|
|
36
|
-
|
|
37
|
-
Legacy (Subscriber mixin, Publisher API): **Legacy** section at the bottom of the sidebar.
|
|
38
|
-
|
|
39
27
|
## Start a new project
|
|
40
28
|
|
|
41
29
|
<sonic-code language="bash">
|
|
@@ -44,4 +32,4 @@ npx @supersoniks/create-concorde-ts-starter "project_name"
|
|
|
44
32
|
</template>
|
|
45
33
|
</sonic-code>
|
|
46
34
|
|
|
47
|
-
The starter runs **`yarn ai:sync`** for you. Details: [AI agents (skills)](
|
|
35
|
+
The starter runs **`yarn ai:sync`** for you. Details: [AI agents (skills)](/docs/getting-started/ai-agents).
|
|
@@ -0,0 +1,334 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en" data-doc-url="https://concorde.supersoniks.org/docs/getting-started/theming" data-doc-id="docs/getting-started/theming">
|
|
3
|
+
<head>
|
|
4
|
+
<meta charset="UTF-8">
|
|
5
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
+
<title>Theming — Concorde by Supersoniks</title>
|
|
7
|
+
<meta name="description" content="Concorde components ship with default styles (fallback values in each component and in <sonic-theme>).">
|
|
8
|
+
<meta name="keywords" content="Concorde, supersoniks, docs/getting-started/theming, theming, Theming, guide, , :root, theme="custom", --sc-*, theme="light", "dark", "auto", auto, prefers-color-scheme">
|
|
9
|
+
<meta name="concorde-doc-id" content="docs/getting-started/theming">
|
|
10
|
+
<link rel="canonical" href="https://concorde.supersoniks.org/docs/getting-started/theming">
|
|
11
|
+
<link rel="alternate" type="text/markdown" href="https://concorde.supersoniks.org/docs/getting-started/theming.md">
|
|
12
|
+
</head>
|
|
13
|
+
<body>
|
|
14
|
+
<header>
|
|
15
|
+
<p><a href="/docs/index.html">Concorde documentation</a> · <a href="https://concorde.supersoniks.org/docs/getting-started/theming">same URL (interactive)</a> · <a href="/llms.txt">llms.txt</a></p>
|
|
16
|
+
</header>
|
|
17
|
+
<main>
|
|
18
|
+
<article>
|
|
19
|
+
<p class="doc-lead" id="doc-summary"><strong>Concorde guide — Theming</strong>. Concorde components ship with default styles (fallback values in each component and in <sonic-theme>). <span>Doc ID: <code>docs/getting-started/theming</code>. Keywords: Concorde, supersoniks, docs/getting-started/theming, theming, Theming, guide, , :root, theme="custom", --sc-*, theme="light", "dark", "auto", auto, prefers-color-scheme. URL: <a href="https://concorde.supersoniks.org/docs/getting-started/theming">https://concorde.supersoniks.org/docs/getting-started/theming</a>.</span></p>
|
|
20
|
+
<h1 id="theming">Theming</h1>
|
|
21
|
+
<h2 id="theme-first-customization">Theme-first customization</h2>
|
|
22
|
+
<p>Concorde components ship with <strong>default styles</strong> (fallback values in each component and in <code><sonic-theme></code>).<br>You do not need to define any CSS variables to get a usable UI.</p>
|
|
23
|
+
<p>To align the kit with your brand, override <strong>only the essential theme tokens</strong> on <code><sonic-theme></code>, on <code>:root</code>, or in a project stylesheet.<br>Concorde derives radius steps, button/input rounding, shadows, and most per-component layout from these primitives—<strong>do not copy long lists of derived variables</strong> unless you have a specific need.</p>
|
|
24
|
+
<pre><code class="language-html"><sonic-theme color font >
|
|
25
|
+
<!-- your app -->
|
|
26
|
+
</sonic-theme>
|
|
27
|
+
</code></pre>
|
|
28
|
+
<pre><code class="language-javascript">import "@supersoniks/concorde/theme";
|
|
29
|
+
</code></pre>
|
|
30
|
+
<table>
|
|
31
|
+
<thead>
|
|
32
|
+
<tr>
|
|
33
|
+
<th>Attribute</th>
|
|
34
|
+
<th>Effect</th>
|
|
35
|
+
</tr>
|
|
36
|
+
</thead>
|
|
37
|
+
<tbody><tr>
|
|
38
|
+
<td><em>(omit)</em> | <code>theme="custom"</code></td>
|
|
39
|
+
<td>Default: core tokens + your <code>--sc-*</code>; no built-in light/dark palette</td>
|
|
40
|
+
</tr>
|
|
41
|
+
<tr>
|
|
42
|
+
<td><code>theme="light"</code> | <code>"dark"</code> | <code>"auto"</code></td>
|
|
43
|
+
<td>Opt-in presets; <code>auto</code> follows <code>prefers-color-scheme</code></td>
|
|
44
|
+
</tr>
|
|
45
|
+
<tr>
|
|
46
|
+
<td><code>class="bg-base block"</code> (Tailwind)</td>
|
|
47
|
+
<td>Page/surface background (<code>--sc-base</code>)</td>
|
|
48
|
+
</tr>
|
|
49
|
+
<tr>
|
|
50
|
+
<td><code>color</code></td>
|
|
51
|
+
<td>Text color (<code>--sc-base-content</code>)</td>
|
|
52
|
+
</tr>
|
|
53
|
+
<tr>
|
|
54
|
+
<td><code>font</code></td>
|
|
55
|
+
<td>Base font family/weight (<code>--sc-font-family-base</code>, etc.)</td>
|
|
56
|
+
</tr>
|
|
57
|
+
</tbody></table>
|
|
58
|
+
<p>Popovers, modals, and toasts mount under the nearest <code><sonic-theme></code>.</p>
|
|
59
|
+
<h2 id="customization-example">Customization example</h2>
|
|
60
|
+
<p>Example (full brand override on <code><sonic-theme></code> or <code>:root</code>). Set every essential token below; derived radii and shadows still come from the theme engine—only <code>--sc-rounded</code> is listed here.</p>
|
|
61
|
+
<pre><code class="language-css">sonic-theme {
|
|
62
|
+
/* Semantic fills */
|
|
63
|
+
--sc-primary: #353429;
|
|
64
|
+
--sc-secondary: #f43f5e;
|
|
65
|
+
--sc-info: #7c3aed;
|
|
66
|
+
--sc-danger: #d71839;
|
|
67
|
+
--sc-warning: #f97316;
|
|
68
|
+
--sc-success: #10b981;
|
|
69
|
+
--sc-contrast: #111;
|
|
70
|
+
|
|
71
|
+
/* Text/icons on semantic fills */
|
|
72
|
+
--sc-primary-content: #fff;
|
|
73
|
+
--sc-secondary-content: #fff;
|
|
74
|
+
--sc-info-content: #fff;
|
|
75
|
+
--sc-danger-content: #fff;
|
|
76
|
+
--sc-warning-content: #fff;
|
|
77
|
+
--sc-success-content: #fff;
|
|
78
|
+
--sc-contrast-content: #fff;
|
|
79
|
+
|
|
80
|
+
/* Neutral fills */
|
|
81
|
+
--sc-base: #fff;
|
|
82
|
+
--sc-base-50: #f6f6f5;
|
|
83
|
+
--sc-base-100: #ededec;
|
|
84
|
+
--sc-base-200: #d7d7d4;
|
|
85
|
+
--sc-base-300: #c8c7c4;
|
|
86
|
+
--sc-base-400: #a8a7a2;
|
|
87
|
+
--sc-base-500: #94938c;
|
|
88
|
+
--sc-base-600: #76756c;
|
|
89
|
+
--sc-base-700: #59584e;
|
|
90
|
+
--sc-base-800: #47463b;
|
|
91
|
+
--sc-base-900: #353429;
|
|
92
|
+
|
|
93
|
+
/* Text/icons on neutral surfaces */
|
|
94
|
+
--sc-base-content: var(--sc-base-900);
|
|
95
|
+
|
|
96
|
+
/* Typography */
|
|
97
|
+
--sc-font-family-base: "Oswald", system-ui, -apple-system, "Segoe UI", Roboto,
|
|
98
|
+
"Helvetica Neue", Arial, sans-serif;
|
|
99
|
+
--sc-headings-font-family: "alternate-gothic-compressed", system-ui, sans-serif;
|
|
100
|
+
--sc-headings-line-height: 1.1;
|
|
101
|
+
--sc-headings-font-weight: bold;
|
|
102
|
+
--sc-headings-text-transform: none;
|
|
103
|
+
|
|
104
|
+
/* Shape (primitive only) */
|
|
105
|
+
--sc-rounded: 0;
|
|
106
|
+
|
|
107
|
+
/* Forms */
|
|
108
|
+
--sc-border-width: 0.2rem;
|
|
109
|
+
--sc-form-height: 2em;
|
|
110
|
+
--sc-input-bg: var(--sc-base);
|
|
111
|
+
--sc-input-color: var(--sc-base-content);
|
|
112
|
+
--sc-input-border-color: var(--sc-input-color);
|
|
113
|
+
--sc-input-active-bg: var(--sc-primary);
|
|
114
|
+
--sc-input-active-color: var(--sc-primary-content);
|
|
115
|
+
--sc-input-active-border-color: var(--sc-primary);
|
|
116
|
+
}
|
|
117
|
+
</code></pre>
|
|
118
|
+
<p><sonic-button href="https://delanfranchi.github.io/concordecolors/"> Palette generator: concordecolors</sonic-button></p>
|
|
119
|
+
<p><strong>Without these overrides</strong>, components keep Concorde’s per-component fallbacks. Built-in light/dark palettes apply only when you set <code>theme="light"</code>, <code>theme="dark"</code>, or <code>theme="auto"</code>.</p>
|
|
120
|
+
<p><strong>What we intentionally avoid:</strong> large public <code>--sc-alert-*</code> / <code>--sc-badge-*</code> APIs or <code>::part()</code> styling hooks on most components. Prefer attributes (<code>type</code>, <code>status</code>, <code>size</code>, …) and the theme tokens above.</p>
|
|
121
|
+
<h2 id="only-essential-css-variables-public-theme-api">Only essential CSS variables (public theme API)</h2>
|
|
122
|
+
<p>These are the <strong>smallest set</strong> we recommend customizing. Everything else should stay internal to the theme or to components (<code>--sc_*</code> private variables, attributes like <code>type</code>, <code>size</code>, <code>variant</code>).</p>
|
|
123
|
+
<h3 id="surfaces-and-foreground">Surfaces and foreground</h3>
|
|
124
|
+
<p>Tokens <strong>without</strong> a <code>-content</code> suffix are <strong>fill / background</strong> colors.<br>Tokens <strong>with</strong> <code>-content</code> are <strong>text and icons</strong> on top of the matching fill (solid buttons, badges, alerts, etc.).</p>
|
|
125
|
+
<h4 id="neutral-fills">Neutral fills</h4>
|
|
126
|
+
<table>
|
|
127
|
+
<thead>
|
|
128
|
+
<tr>
|
|
129
|
+
<th>Variable</th>
|
|
130
|
+
<th>Role</th>
|
|
131
|
+
</tr>
|
|
132
|
+
</thead>
|
|
133
|
+
<tbody><tr>
|
|
134
|
+
<td><code>--sc-base</code></td>
|
|
135
|
+
<td>Main surface / page background</td>
|
|
136
|
+
</tr>
|
|
137
|
+
<tr>
|
|
138
|
+
<td><code>--sc-base-50</code> … <code>--sc-base-900</code></td>
|
|
139
|
+
<td>Neutral scale (borders, subtle backgrounds, muted UI)</td>
|
|
140
|
+
</tr>
|
|
141
|
+
</tbody></table>
|
|
142
|
+
<h4 id="neutral-foreground">Neutral foreground</h4>
|
|
143
|
+
<table>
|
|
144
|
+
<thead>
|
|
145
|
+
<tr>
|
|
146
|
+
<th>Variable</th>
|
|
147
|
+
<th>Role</th>
|
|
148
|
+
</tr>
|
|
149
|
+
</thead>
|
|
150
|
+
<tbody><tr>
|
|
151
|
+
<td><code>--sc-base-content</code></td>
|
|
152
|
+
<td>Default body text and icons on neutral surfaces</td>
|
|
153
|
+
</tr>
|
|
154
|
+
</tbody></table>
|
|
155
|
+
<h4 id="semantic-fills">Semantic fills</h4>
|
|
156
|
+
<table>
|
|
157
|
+
<thead>
|
|
158
|
+
<tr>
|
|
159
|
+
<th>Variable</th>
|
|
160
|
+
<th>Role</th>
|
|
161
|
+
</tr>
|
|
162
|
+
</thead>
|
|
163
|
+
<tbody><tr>
|
|
164
|
+
<td><code>--sc-primary</code></td>
|
|
165
|
+
<td>Primary actions, links, emphasis</td>
|
|
166
|
+
</tr>
|
|
167
|
+
<tr>
|
|
168
|
+
<td><code>--sc-secondary</code></td>
|
|
169
|
+
<td>Secondary brand accent (when used)</td>
|
|
170
|
+
</tr>
|
|
171
|
+
<tr>
|
|
172
|
+
<td><code>--sc-info</code>, <code>--sc-success</code>, <code>--sc-warning</code>, <code>--sc-danger</code></td>
|
|
173
|
+
<td>Status and feedback</td>
|
|
174
|
+
</tr>
|
|
175
|
+
<tr>
|
|
176
|
+
<td><code>--sc-contrast</code></td>
|
|
177
|
+
<td>High-contrast fills (e.g. on media)</td>
|
|
178
|
+
</tr>
|
|
179
|
+
</tbody></table>
|
|
180
|
+
<h4 id="semantic-foreground">Semantic foreground</h4>
|
|
181
|
+
<table>
|
|
182
|
+
<thead>
|
|
183
|
+
<tr>
|
|
184
|
+
<th>Variable</th>
|
|
185
|
+
<th>Role</th>
|
|
186
|
+
</tr>
|
|
187
|
+
</thead>
|
|
188
|
+
<tbody><tr>
|
|
189
|
+
<td><code>--sc-primary-content</code>, <code>--sc-secondary-content</code>, …</td>
|
|
190
|
+
<td>Text/icons on the matching semantic <strong>fill</strong> (<code>--sc-primary</code>, etc.)</td>
|
|
191
|
+
</tr>
|
|
192
|
+
</tbody></table>
|
|
193
|
+
<h3 id="shape">Shape</h3>
|
|
194
|
+
<table>
|
|
195
|
+
<thead>
|
|
196
|
+
<tr>
|
|
197
|
+
<th>Variable</th>
|
|
198
|
+
<th>Role</th>
|
|
199
|
+
</tr>
|
|
200
|
+
</thead>
|
|
201
|
+
<tbody><tr>
|
|
202
|
+
<td><code>--sc-rounded</code></td>
|
|
203
|
+
<td><strong>Single primitive</strong> corner radius; the theme computes <code>--sc-rounded-sm</code>, <code>--sc-btn-rounded</code>, <code>--sc-input-rounded</code>, etc.</td>
|
|
204
|
+
</tr>
|
|
205
|
+
</tbody></table>
|
|
206
|
+
<h3 id="typography">Typography</h3>
|
|
207
|
+
<table>
|
|
208
|
+
<thead>
|
|
209
|
+
<tr>
|
|
210
|
+
<th>Variable</th>
|
|
211
|
+
<th>Role</th>
|
|
212
|
+
</tr>
|
|
213
|
+
</thead>
|
|
214
|
+
<tbody><tr>
|
|
215
|
+
<td><code>--sc-font-family-base</code></td>
|
|
216
|
+
<td>Body UI text</td>
|
|
217
|
+
</tr>
|
|
218
|
+
<tr>
|
|
219
|
+
<td><code>--sc-font-weight-base</code>, <code>--sc-font-style-base</code></td>
|
|
220
|
+
<td>Optional</td>
|
|
221
|
+
</tr>
|
|
222
|
+
<tr>
|
|
223
|
+
<td><code>--sc-headings-font-family</code>, <code>--sc-headings-line-height</code>, <code>--sc-headings-font-weight</code>, <code>--sc-headings-text-transform</code></td>
|
|
224
|
+
<td>Headings (modal titles, etc.)</td>
|
|
225
|
+
</tr>
|
|
226
|
+
</tbody></table>
|
|
227
|
+
<h3 id="forms-only-if-you-customize-inputs-globally">Forms (only if you customize inputs globally)</h3>
|
|
228
|
+
<p>Interactive controls expose a few extra <strong>theme-level</strong> tokens; prefer these over styling individual inputs from outside.</p>
|
|
229
|
+
<table>
|
|
230
|
+
<thead>
|
|
231
|
+
<tr>
|
|
232
|
+
<th>Variable</th>
|
|
233
|
+
<th>Role</th>
|
|
234
|
+
</tr>
|
|
235
|
+
</thead>
|
|
236
|
+
<tbody><tr>
|
|
237
|
+
<td><code>--sc-border-width</code></td>
|
|
238
|
+
<td>Default border thickness</td>
|
|
239
|
+
</tr>
|
|
240
|
+
<tr>
|
|
241
|
+
<td><code>--sc-form-height</code></td>
|
|
242
|
+
<td>Control height</td>
|
|
243
|
+
</tr>
|
|
244
|
+
<tr>
|
|
245
|
+
<td><code>--sc-input-bg</code>, <code>--sc-input-color</code>, <code>--sc-input-border-color</code></td>
|
|
246
|
+
<td>Default field chrome</td>
|
|
247
|
+
</tr>
|
|
248
|
+
<tr>
|
|
249
|
+
<td><code>--sc-input-active-bg</code>, <code>--sc-input-active-color</code>, <code>--sc-input-active-border-color</code></td>
|
|
250
|
+
<td>Focus/active state</td>
|
|
251
|
+
</tr>
|
|
252
|
+
</tbody></table>
|
|
253
|
+
<hr>
|
|
254
|
+
<h2 id="tailwind-in-new-components-">Tailwind in new components ?</h2>
|
|
255
|
+
<p>Set <code>tailwind.config.js</code> to match concorde style token in your custom component.</p>
|
|
256
|
+
<pre><code class="language-js">...
|
|
257
|
+
theme: {
|
|
258
|
+
borderRadius: {
|
|
259
|
+
DEFAULT: "var(--sc-rounded)",
|
|
260
|
+
none: "0",
|
|
261
|
+
sm: "var(--sc-rounded-sm)",
|
|
262
|
+
md: "var(--sc-rounded-md)",
|
|
263
|
+
lg: "var(--sc-rounded-lg)",
|
|
264
|
+
xl: "var(--sc-rounded-xl)",
|
|
265
|
+
full: "9999px",
|
|
266
|
+
},
|
|
267
|
+
boxShadow: {
|
|
268
|
+
DEFAULT: "var(--sc-shadow)",
|
|
269
|
+
none: "none",
|
|
270
|
+
sm: "var(--sc-shadow-sm)",
|
|
271
|
+
md: "var(--sc-shadow-md)",
|
|
272
|
+
lg: "var(--sc-shadow-lg)",
|
|
273
|
+
xl: "var(--sc-shadow-xl)",
|
|
274
|
+
},
|
|
275
|
+
colors: {
|
|
276
|
+
transparent: "transparent",
|
|
277
|
+
current: "currentColor",
|
|
278
|
+
content: "var(--sc-base-content)",
|
|
279
|
+
base: "var(--sc-base)",
|
|
280
|
+
neutral: {
|
|
281
|
+
0: "var(--sc-base)",
|
|
282
|
+
50: "var(--sc-base-50)",
|
|
283
|
+
100: "var(--sc-base-100)",
|
|
284
|
+
200: "var(--sc-base-200)",
|
|
285
|
+
300: "var(--sc-base-300)",
|
|
286
|
+
400: "var(--sc-base-400)",
|
|
287
|
+
500: "var(--sc-base-500)",
|
|
288
|
+
600: "var(--sc-base-600)",
|
|
289
|
+
700: "var(--sc-base-700)",
|
|
290
|
+
800: "var(--sc-base-800)",
|
|
291
|
+
900: "var(--sc-base-900)",
|
|
292
|
+
content: "var(--sc-base)",
|
|
293
|
+
},
|
|
294
|
+
primary: {
|
|
295
|
+
DEFAULT: "var(--sc-primary)",
|
|
296
|
+
content: "var(--sc-primary-content)",
|
|
297
|
+
},
|
|
298
|
+
success: {
|
|
299
|
+
DEFAULT: "var(--sc-success)",
|
|
300
|
+
content: "var(--sc-success-content)",
|
|
301
|
+
},
|
|
302
|
+
danger: {
|
|
303
|
+
DEFAULT: "var(--sc-danger)",
|
|
304
|
+
content: "var(--sc-danger-content)",
|
|
305
|
+
},
|
|
306
|
+
warning: {
|
|
307
|
+
DEFAULT: "var(--sc-warning)",
|
|
308
|
+
content: "var(--sc-warning-content)",
|
|
309
|
+
},
|
|
310
|
+
info: {
|
|
311
|
+
DEFAULT: "var(--sc-info)",
|
|
312
|
+
content: "var(--sc-info-content)",
|
|
313
|
+
},
|
|
314
|
+
contrast: {
|
|
315
|
+
DEFAULT: "var(--sc-contrast)",
|
|
316
|
+
content: "var(--sc-contrast-content)",
|
|
317
|
+
},
|
|
318
|
+
},
|
|
319
|
+
extend: {
|
|
320
|
+
borderWidth: {
|
|
321
|
+
DEFAULT: "var(--sc-border-width)",
|
|
322
|
+
},
|
|
323
|
+
fontFamily: {
|
|
324
|
+
headings: ["var(--sc-headings-font-family, var(--sc-font-family-base, sans-serif))"],
|
|
325
|
+
body: ["var(--sc-font-family-base)"],
|
|
326
|
+
monospace: ["var(--sc-font-family-monospace, monospace)"],
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
</code></pre>
|
|
330
|
+
|
|
331
|
+
</article>
|
|
332
|
+
</main>
|
|
333
|
+
</body>
|
|
334
|
+
</html>
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Theming
|
|
2
2
|
|
|
3
3
|
## Theme-first customization
|
|
4
4
|
|
|
@@ -10,7 +10,7 @@ Concorde derives radius steps, button/input rounding, shadows, and most per-comp
|
|
|
10
10
|
|
|
11
11
|
<sonic-code language="html">
|
|
12
12
|
<template>
|
|
13
|
-
<sonic-theme color font
|
|
13
|
+
<sonic-theme color font >
|
|
14
14
|
<!-- your app -->
|
|
15
15
|
</sonic-theme>
|
|
16
16
|
</template>
|