@supersoniks/concorde 5.0.5 → 5.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +13705 -0
- package/AUDIT.md +228 -0
- package/PLAN-AMELIORATION.md +220 -0
- package/build-infos.json +1 -1
- package/concorde-core.bundle.js +196 -196
- package/concorde-core.es.js +3854 -3572
- package/custom-elements-manifest.config.mjs +14 -0
- package/dist/concorde-core.bundle.js +196 -196
- package/dist/concorde-core.es.js +3854 -3572
- 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/assets/index-Bb-_LRyY.js +12280 -0
- package/docs/index.html +1 -1
- package/index.html +27 -63
- package/package.json +44 -3
- 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/scripts/generate-sdui-catalog.mjs +250 -0
- package/scripts/generate-sdui-catalog.spec.ts +91 -0
- package/scripts/pre-build.mjs +15 -0
- package/src/core/components/functional/fetch/fetch.md +2 -2
- package/src/core/components/functional/sdui/SDUIDescriptorTransformer.ts +5 -5
- package/src/core/components/functional/sdui/__fixtures__/descriptors.ts +251 -0
- package/src/core/components/functional/sdui/__snapshots__/sdui-action.spec.ts.snap +73 -0
- package/src/core/components/functional/sdui/__snapshots__/sdui-incremental.spec.ts.snap +50 -0
- package/src/core/components/functional/sdui/__snapshots__/sdui-partial.spec.ts.snap +50 -0
- package/src/core/components/functional/sdui/__snapshots__/sdui.regression.spec.ts.snap +461 -0
- package/src/core/components/functional/sdui/component-catalog.gaps.json +511 -0
- package/src/core/components/functional/sdui/component-catalog.json +3103 -0
- package/src/core/components/functional/sdui/component-catalog.spec.ts +23 -0
- package/src/core/components/functional/sdui/sdui-action.spec.ts +99 -0
- package/src/core/components/functional/sdui/sdui-dom-snapshot.ts +61 -0
- package/src/core/components/functional/sdui/sdui-extension-points.md +94 -0
- package/src/core/components/functional/sdui/sdui-incremental.spec.ts +137 -0
- package/src/core/components/functional/sdui/sdui-partial.spec.ts +83 -0
- package/src/core/components/functional/sdui/sdui-partial.ts +19 -0
- package/src/core/components/functional/sdui/sdui-safe.spec.ts +188 -0
- package/src/core/components/functional/sdui/sdui-safe.ts +100 -0
- package/src/core/components/functional/sdui/sdui.md +122 -0
- package/src/core/components/functional/sdui/sdui.regression.spec.ts +64 -0
- package/src/core/components/functional/sdui/sdui.ts +442 -34
- package/src/core/components/functional/sdui/types.ts +49 -0
- package/src/core/components/ui/modal/modal.ts +14 -11
- package/src/docs/_getting-started/components.md +5 -0
- package/src/docs/_getting-started/theming.md +2 -2
- package/src/docs/code.ts +88 -75
- package/src/docs/components/docs-demo-sources.ts +16 -8
- package/src/docs/components/docs-lit-demo.ts +19 -37
- package/src/docs/docs.ts +5 -0
- package/src/docs/example/docs-boarding-pass-demo.ts +134 -0
- package/src/docs/example/docs-provider-keys.ts +12 -0
- package/src/docs/header/header.ts +233 -69
- package/src/docs/home/catalog.ts +44 -0
- package/src/docs/home/home.ts +513 -0
- package/src/docs/home/mach-stage.ts +389 -0
- package/src/docs/layout.ts +3 -1
- package/src/docs/navigation/components-index.ts +56 -0
- package/src/docs/navigation/navigation.ts +240 -232
- package/src/docs/navigation/pager.ts +67 -0
- package/src/docs/navigation/toc.ts +98 -0
- package/src/docs/search/docs-search.json +330 -20
- package/src/docs/search/markdown-renderer.ts +11 -3
- 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 +113 -2
- package/src/tsconfig.tsbuildinfo +1 -1
- package/tailwind.config.js +8 -4
- package/docs/assets/index-wVZpLVYW.js +0 -12122
- 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/subscriber/subscriber.html +0 -67
- package/docs/crawl/core/components/functional/value/value.html +0 -51
- package/docs/crawl/core/components/ui/alert/alert.html +0 -211
- package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +0 -131
- package/docs/crawl/core/components/ui/badge/badge.html +0 -197
- package/docs/crawl/core/components/ui/button/button.html +0 -150
- package/docs/crawl/core/components/ui/captcha/captcha.html +0 -112
- package/docs/crawl/core/components/ui/card/card.html +0 -253
- package/docs/crawl/core/components/ui/divider/divider.html +0 -144
- package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +0 -73
- package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +0 -266
- package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +0 -122
- package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +0 -121
- 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 -104
- package/docs/crawl/core/components/ui/icon/icon.html +0 -222
- package/docs/crawl/core/components/ui/image/image.html +0 -298
- package/docs/crawl/core/components/ui/link/link.html +0 -100
- package/docs/crawl/core/components/ui/loader/loader.html +0 -124
- package/docs/crawl/core/components/ui/menu/menu.html +0 -394
- package/docs/crawl/core/components/ui/modal/modal.html +0 -342
- package/docs/crawl/core/components/ui/pop/pop.html +0 -296
- package/docs/crawl/core/components/ui/progress/progress.html +0 -131
- package/docs/crawl/core/components/ui/table/table.html +0 -545
- package/docs/crawl/core/components/ui/theme/theme.html +0 -131
- package/docs/crawl/core/components/ui/toast/toast.html +0 -233
- package/docs/crawl/core/components/ui/tooltip/tooltip.html +0 -140
- package/docs/crawl/docs/_core-concept/dataFlow.html +0 -177
- 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 -117
- 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/ai-agents.html +0 -173
- 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/create-a-component.html +0 -111
- package/docs/crawl/docs/_getting-started/my-first-component.html +0 -189
- 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 -333
- package/docs/crawl/docs/_misc/api-configuration.html +0 -149
- package/docs/crawl/docs/_misc/dataProviderKey.html +0 -135
- package/docs/crawl/docs/_misc/docs-mock-api.html +0 -158
- package/docs/crawl/docs/_misc/dynamic-path.html +0 -180
- package/docs/crawl/docs/_misc/endpoint.html +0 -50
- package/docs/crawl/docs/_misc/formelement-subscriber-removal.html +0 -138
- package/docs/crawl/docs/_misc/html-integration.html +0 -48
- package/docs/crawl/hubs/decorators.html +0 -547
- package/docs/crawl/hubs/form-components.html +0 -381
- package/docs/crawl/hubs/remote-data.html +0 -452
- package/docs/crawl/index.html +0 -102
- package/docs/llms-full.txt +0 -7008
- package/docs/llms.txt +0 -97
- package/docs/sitemap.xml +0 -240
- package/docs/src/core/components/functional/date/date.md +0 -290
- package/docs/src/core/components/functional/fetch/fetch.md +0 -125
- package/docs/src/core/components/functional/if/if.md +0 -9
- package/docs/src/core/components/functional/jsonata/jsonata.md +0 -56
- package/docs/src/core/components/functional/list/list.md +0 -65
- package/docs/src/core/components/functional/mix/mix.md +0 -41
- package/docs/src/core/components/functional/queue/queue.md +0 -72
- package/docs/src/core/components/functional/router/router.md +0 -94
- package/docs/src/core/components/functional/sdui/default-library.json +0 -108
- package/docs/src/core/components/functional/sdui/example.json +0 -99
- package/docs/src/core/components/functional/sdui/sdui.md +0 -356
- package/docs/src/core/components/functional/states/states.md +0 -87
- package/docs/src/core/components/functional/submit/submit.md +0 -114
- package/docs/src/core/components/functional/subscriber/subscriber.md +0 -91
- package/docs/src/core/components/functional/value/value.md +0 -35
- package/docs/src/core/components/ui/alert/alert.md +0 -196
- package/docs/src/core/components/ui/alert-messages/alert-messages.md +0 -85
- package/docs/src/core/components/ui/badge/badge.md +0 -188
- package/docs/src/core/components/ui/button/button.md +0 -183
- package/docs/src/core/components/ui/captcha/captcha.md +0 -71
- package/docs/src/core/components/ui/card/card.md +0 -215
- package/docs/src/core/components/ui/divider/divider.md +0 -129
- package/docs/src/core/components/ui/form/checkbox/checkbox.md +0 -77
- package/docs/src/core/components/ui/form/fieldset/fieldset.md +0 -205
- package/docs/src/core/components/ui/form/form-actions/form-actions.md +0 -100
- package/docs/src/core/components/ui/form/form-layout/form-layout.md +0 -119
- package/docs/src/core/components/ui/form/input/input.md +0 -142
- package/docs/src/core/components/ui/form/input-autocomplete/input-autocomplete.md +0 -29
- package/docs/src/core/components/ui/form/radio/radio.md +0 -57
- package/docs/src/core/components/ui/form/select/select.md +0 -71
- package/docs/src/core/components/ui/form/switch/switch.md +0 -57
- package/docs/src/core/components/ui/form/textarea/textarea.md +0 -65
- package/docs/src/core/components/ui/group/group.md +0 -75
- package/docs/src/core/components/ui/icon/icon.md +0 -214
- package/docs/src/core/components/ui/icon/icons.json +0 -1
- package/docs/src/core/components/ui/image/image.md +0 -233
- package/docs/src/core/components/ui/link/link.md +0 -81
- package/docs/src/core/components/ui/loader/loader.md +0 -112
- package/docs/src/core/components/ui/menu/menu.md +0 -370
- package/docs/src/core/components/ui/modal/modal.md +0 -235
- package/docs/src/core/components/ui/pop/pop.md +0 -294
- package/docs/src/core/components/ui/progress/progress.md +0 -109
- package/docs/src/core/components/ui/table/table.md +0 -431
- package/docs/src/core/components/ui/theme/theme.md +0 -122
- package/docs/src/core/components/ui/toast/toast.md +0 -216
- package/docs/src/core/components/ui/tooltip/tooltip.md +0 -124
- package/docs/src/docs/_core-concept/dataFlow.md +0 -88
- 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 -128
- 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/ai-agents.md +0 -76
- 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/create-a-component.md +0 -139
- package/docs/src/docs/_getting-started/my-first-component.md +0 -236
- 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 -253
- package/docs/src/docs/_misc/api-configuration.md +0 -81
- package/docs/src/docs/_misc/dataProviderKey.md +0 -168
- package/docs/src/docs/_misc/docs-mock-api.md +0 -63
- package/docs/src/docs/_misc/dynamic-path.md +0 -71
- package/docs/src/docs/_misc/endpoint.md +0 -45
- package/docs/src/docs/_misc/formelement-subscriber-removal.md +0 -115
- package/docs/src/docs/_misc/html-integration.md +0 -15
- package/docs/src/docs/search/docs-search.json +0 -12242
- package/docs/src/tag-list.json +0 -1
- package/docs/src/tsconfig-model.json +0 -23
- package/docs/src/tsconfig.json +0 -1242
- package/src/docs/prism/index.ts +0 -6
- package/src/docs/prism/prism.css +0 -158
- package/src/docs/prism/prism.js +0 -1022
|
@@ -1,158 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_misc/docs-mock-api.html" data-doc-id="docs/_misc/docs-mock-api">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>Local API demos (offline) — Concorde</title>
|
|
7
|
-
<meta name="description" content="The Concorde doc site does not call fragile third-party APIs during yarn dev. A Service Worker and the Vite dev middleware serve /docs-mock-api/* on the same origin.">
|
|
8
|
-
<meta name="keywords" content="Concorde, supersoniks, docs/_misc/docs-mock-api, docs-mock-api, Local API demos (offline), reference, yarn dev, /docs-mock-api/*, registerDocsMockApiServiceWorker(), /docs-mock-api-sw.js, /docs-mock-api/..., serviceURL="/docs-mock-api", src/docs/mock-api/urls.ts, DOCS_MOCK_REQRES_SERVICE, DOCS_MOCK_GEO_SERVICE, /docs-mock-api/api/users">
|
|
9
|
-
<meta name="concorde-doc-id" content="docs/_misc/docs-mock-api">
|
|
10
|
-
<link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_misc/docs-mock-api.html">
|
|
11
|
-
</head>
|
|
12
|
-
<body>
|
|
13
|
-
<header>
|
|
14
|
-
<p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_misc/docs-mock-api.md/docs-mock-api" rel="nofollow">interactive version</a></p>
|
|
15
|
-
</header>
|
|
16
|
-
<main>
|
|
17
|
-
<article>
|
|
18
|
-
<p class="doc-lead" id="doc-summary"><strong>Concorde reference — Local API demos (offline)</strong>. The Concorde doc site does not call fragile third-party APIs during yarn dev. A Service Worker and the Vite dev middleware serve /docs-mock-api/* on the same origin. <span>Doc ID: <code>docs/_misc/docs-mock-api</code>. Keywords: Concorde, supersoniks, docs/_misc/docs-mock-api, docs-mock-api, Local API demos (offline), reference, yarn dev, /docs-mock-api/*, registerDocsMockApiServiceWorker(), /docs-mock-api-sw.js, /docs-mock-api/..., serviceURL="/docs-mock-api", src/docs/mock-api/urls.ts, DOCS_MOCK_REQRES_SERVICE, DOCS_MOCK_GEO_SERVICE, /docs-mock-api/api/users. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_misc/docs-mock-api.html">https://concorde.supersoniks.org/crawl/docs/_misc/docs-mock-api.html</a>.</span></p>
|
|
19
|
-
<h1 id="local-api-demos-offline">Local API demos (offline)</h1>
|
|
20
|
-
<p>The Concorde doc site does not call fragile third-party APIs during <code>yarn dev</code>. A <strong>Service Worker</strong> and the Vite dev middleware serve <strong><code>/docs-mock-api/*</code></strong> on the same origin.</p>
|
|
21
|
-
<h2 id="how-it-works">How it works</h2>
|
|
22
|
-
<ol>
|
|
23
|
-
<li>On load, <code>registerDocsMockApiServiceWorker()</code> registers <code>/docs-mock-api-sw.js</code>.</li>
|
|
24
|
-
<li>Requests to <code>/docs-mock-api/...</code> are handled by the SW (production build) or Vite middleware (dev).</li>
|
|
25
|
-
<li>Live examples use <code>serviceURL="/docs-mock-api"</code> and relative paths.</li>
|
|
26
|
-
</ol>
|
|
27
|
-
<p>TypeScript constants: <code>src/docs/mock-api/urls.ts</code> (<code>DOCS_MOCK_REQRES_SERVICE</code>, <code>DOCS_MOCK_GEO_SERVICE</code>, …).</p>
|
|
28
|
-
<h2 id="routes">Routes</h2>
|
|
29
|
-
<table>
|
|
30
|
-
<thead>
|
|
31
|
-
<tr>
|
|
32
|
-
<th>Path</th>
|
|
33
|
-
<th>Used in</th>
|
|
34
|
-
</tr>
|
|
35
|
-
</thead>
|
|
36
|
-
<tbody><tr>
|
|
37
|
-
<td><code>/docs-mock-api/api/users</code></td>
|
|
38
|
-
<td><code>sonic-list</code>, <code>sonic-fetch</code>, <code>sonic-queue</code> (users)</td>
|
|
39
|
-
</tr>
|
|
40
|
-
<tr>
|
|
41
|
-
<td><code>/docs-mock-api/api/users/:id</code></td>
|
|
42
|
-
<td>Single user, <code>docs-user</code></td>
|
|
43
|
-
</tr>
|
|
44
|
-
<tr>
|
|
45
|
-
<td><code>/docs-mock-api/api/space-cats</code></td>
|
|
46
|
-
<td><code>sonic-jsonata</code> top-N demo</td>
|
|
47
|
-
</tr>
|
|
48
|
-
<tr>
|
|
49
|
-
<td><code>/docs-mock-api/api/coffee-bags</code></td>
|
|
50
|
-
<td>fixtures / tests jsonata (<code>?roast=</code>)</td>
|
|
51
|
-
</tr>
|
|
52
|
-
<tr>
|
|
53
|
-
<td><code>/docs-mock-api/api/market-order</code></td>
|
|
54
|
-
<td><code>sonic-jsonata</code> totals demo</td>
|
|
55
|
-
</tr>
|
|
56
|
-
<tr>
|
|
57
|
-
<td><code>POST /docs-mock-api/api/register</code></td>
|
|
58
|
-
<td><strong>sonic-submit</strong> — JSON, <code>multipart/form-data</code> (<code>sendAsFormData</code>), or <code>application/x-www-form-urlencoded</code> (native <code><form></code>); response includes parsed <code>email</code> + <code>token</code></td>
|
|
59
|
-
</tr>
|
|
60
|
-
<tr>
|
|
61
|
-
<td><code>POST /docs-mock-api/api/register/nested</code></td>
|
|
62
|
-
<td>Wrapped body <code>{ data: { id, token } }</code> for <code>submit-result-key</code> demo</td>
|
|
63
|
-
</tr>
|
|
64
|
-
<tr>
|
|
65
|
-
<td><code>GET /docs-mock-api/api/register/echo</code></td>
|
|
66
|
-
<td>Echoes query string (<code>method="get"</code> on submit)</td>
|
|
67
|
-
</tr>
|
|
68
|
-
<tr>
|
|
69
|
-
<td><code>GET /docs-mock-api/auth/token</code></td>
|
|
70
|
-
<td><a href="./api-configuration.html#api-configuration">API configuration</a> — tokenProvider (Basic or <code>eventsApiToken</code>)</td>
|
|
71
|
-
</tr>
|
|
72
|
-
<tr>
|
|
73
|
-
<td><code>GET /docs-mock-api/api/config/protected</code></td>
|
|
74
|
-
<td>Bearer / Basic; <code>docs-mock-stale-token</code> → <strong>498</strong></td>
|
|
75
|
-
</tr>
|
|
76
|
-
<tr>
|
|
77
|
-
<td><code>GET /docs-mock-api/wording/labels</code></td>
|
|
78
|
-
<td>Wording batch (<code>labels[]</code>, <code>lang</code>)</td>
|
|
79
|
-
</tr>
|
|
80
|
-
<tr>
|
|
81
|
-
<td><code>/docs-mock-api/geo/communes</code></td>
|
|
82
|
-
<td>Geo list, <code>@get</code> demos</td>
|
|
83
|
-
</tr>
|
|
84
|
-
<tr>
|
|
85
|
-
<td><code>/docs-mock-api/jokes/joke/:category</code></td>
|
|
86
|
-
<td>JokeAPI-shaped list (<code>key="jokes"</code> on queue/list)</td>
|
|
87
|
-
</tr>
|
|
88
|
-
</tbody></table>
|
|
89
|
-
<h3 id="filtres-get-jokesjoke">Filtres <code>GET /jokes/joke/…</code></h3>
|
|
90
|
-
<table>
|
|
91
|
-
<thead>
|
|
92
|
-
<tr>
|
|
93
|
-
<th>Query</th>
|
|
94
|
-
<th>Meaning</th>
|
|
95
|
-
</tr>
|
|
96
|
-
</thead>
|
|
97
|
-
<tbody><tr>
|
|
98
|
-
<td><code>amount</code></td>
|
|
99
|
-
<td>Max jokes per request when not using <code>offset</code></td>
|
|
100
|
-
</tr>
|
|
101
|
-
<tr>
|
|
102
|
-
<td><code>offset</code> + <code>limit</code> / <code>per_page</code></td>
|
|
103
|
-
<td>Pagination for <strong>sonic-queue</strong> lazy load</td>
|
|
104
|
-
</tr>
|
|
105
|
-
<tr>
|
|
106
|
-
<td><code>contains</code></td>
|
|
107
|
-
<td>Substring on joke text, setup/delivery, categories (<strong>input</strong> demo, <code>name="contains"</code>)</td>
|
|
108
|
-
</tr>
|
|
109
|
-
<tr>
|
|
110
|
-
<td><code>lang</code></td>
|
|
111
|
-
<td><code>fr</code> or <code>en</code> — filters the local dataset (<strong>select</strong> demo, <code>name="lang"</code>)</td>
|
|
112
|
-
</tr>
|
|
113
|
-
<tr>
|
|
114
|
-
<td><code>blacklistFlags</code></td>
|
|
115
|
-
<td>Comma-separated flags to <strong>exclude</strong> (<code>nsfw</code>, <code>religious</code>, <code>political</code>, <code>racist</code>, <code>sexist</code>, <code>explicit</code>) — checkbox/radio/switch « Remove following jokes » demos; each joke has matching <code>flags</code> in fixtures</td>
|
|
116
|
-
</tr>
|
|
117
|
-
</tbody></table>
|
|
118
|
-
<h3 id="pagination-get-apiusers">Pagination <code>GET /api/users</code></h3>
|
|
119
|
-
<table>
|
|
120
|
-
<thead>
|
|
121
|
-
<tr>
|
|
122
|
-
<th>Query</th>
|
|
123
|
-
<th>Meaning</th>
|
|
124
|
-
</tr>
|
|
125
|
-
</thead>
|
|
126
|
-
<tbody><tr>
|
|
127
|
-
<td><code>offset</code> + <code>per_page</code></td>
|
|
128
|
-
<td>Index-based slice on the filtered set — <strong>sonic-queue</strong> (<code>offset=$offset&per_page=$limit</code>)</td>
|
|
129
|
-
</tr>
|
|
130
|
-
<tr>
|
|
131
|
-
<td><code>page</code> + <code>per_page</code></td>
|
|
132
|
-
<td>1-based page — static fetch examples (<code>?page=2</code>)</td>
|
|
133
|
-
</tr>
|
|
134
|
-
<tr>
|
|
135
|
-
<td><code>limit</code></td>
|
|
136
|
-
<td>Alias of <code>per_page</code></td>
|
|
137
|
-
</tr>
|
|
138
|
-
<tr>
|
|
139
|
-
<td><code>q</code></td>
|
|
140
|
-
<td>Search on first name, last name, email (optional; <strong>sonic-queue</strong> + <code>dataFilterProvider</code>, field <code>name="q"</code>)</td>
|
|
141
|
-
</tr>
|
|
142
|
-
</tbody></table>
|
|
143
|
-
<p><strong>ALTCHA</strong> (<code>sonic-captcha</code>) is <strong>not</strong> mocked — it still uses the Supersoniks service.</p>
|
|
144
|
-
<p>In TypeScript demos, import from <code>src/docs/mock-api/urls.ts</code> (e.g. <code>DOCS_MOCK_REQRES_SERVICE</code> on <code>serviceURL</code>).</p>
|
|
145
|
-
<h2 id="source-files">Source files</h2>
|
|
146
|
-
<ul>
|
|
147
|
-
<li><code>src/docs/mock-api/</code> — router, fixtures, service worker, <code>urls.ts</code></li>
|
|
148
|
-
<li><code>scripts/docs-mock-api-vite-plugin.ts</code> — SW build + middleware</li>
|
|
149
|
-
<li><code>public/docs-mock-api-sw.js</code> — generated on <code>yarn dev</code> / <code>yarn build-docs</code></li>
|
|
150
|
-
</ul>
|
|
151
|
-
<pre><code class="language-bash">yarn dev # mock API on by default
|
|
152
|
-
yarn build-docs # includes SW bundle
|
|
153
|
-
</code></pre>
|
|
154
|
-
|
|
155
|
-
</article>
|
|
156
|
-
</main>
|
|
157
|
-
</body>
|
|
158
|
-
</html>
|
|
@@ -1,180 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_misc/dynamic-path.html" data-doc-id="docs/_misc/dynamic-path">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>Dynamic path placeholders — Concorde</title>
|
|
7
|
-
<meta name="description" content="Decorators and DataProviderKey paths can include placeholders resolved on the host component at runtime:">
|
|
8
|
-
<meta name="keywords" content="Concorde, supersoniks, docs/_misc/dynamic-path, dynamic-path, Dynamic path placeholders, reference, DataProviderKey, ${prop}, {$prop}, "users/${userId}", "api/sessions/${sessionId}/sync", "teams.${teamId}.members", resolveDynamicPath, userId, sessionId, requestAnimationFrame">
|
|
9
|
-
<meta name="concorde-doc-id" content="docs/_misc/dynamic-path">
|
|
10
|
-
<link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_misc/dynamic-path.html">
|
|
11
|
-
</head>
|
|
12
|
-
<body>
|
|
13
|
-
<header>
|
|
14
|
-
<p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_misc/dynamic-path.md/dynamic-path" rel="nofollow">interactive version</a></p>
|
|
15
|
-
</header>
|
|
16
|
-
<main>
|
|
17
|
-
<article>
|
|
18
|
-
<p class="doc-lead" id="doc-summary"><strong>Concorde reference — Dynamic path placeholders</strong>. Decorators and DataProviderKey paths can include placeholders resolved on the host component at runtime: <span>Doc ID: <code>docs/_misc/dynamic-path</code>. Keywords: Concorde, supersoniks, docs/_misc/dynamic-path, dynamic-path, Dynamic path placeholders, reference, DataProviderKey, ${prop}, {$prop}, "users/${userId}", "api/sessions/${sessionId}/sync", "teams.${teamId}.members", resolveDynamicPath, userId, sessionId, requestAnimationFrame. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_misc/dynamic-path.html">https://concorde.supersoniks.org/crawl/docs/_misc/dynamic-path.html</a>.</span></p>
|
|
19
|
-
<h1 id="dynamic-path-placeholders">Dynamic path placeholders</h1>
|
|
20
|
-
<p>Decorators and <code>DataProviderKey</code> paths can include <strong>placeholders</strong> resolved on the host component at runtime:</p>
|
|
21
|
-
<ul>
|
|
22
|
-
<li><code>${prop}</code> or <code>{$prop}</code> — e.g. <code>"users/${userId}"</code>, <code>"api/sessions/${sessionId}/sync"</code></li>
|
|
23
|
-
<li>Nested expressions — e.g. <code>"teams.${teamId}.members"</code></li>
|
|
24
|
-
</ul>
|
|
25
|
-
<p>Resolution is done by <a href="../../core/decorators/subscriber/dynamicPath.ts"><code>resolveDynamicPath</code></a>. The root property names (<code>userId</code>, <code>sessionId</code>, …) are watched via <code>requestAnimationFrame</code> (see <code>dynamicPropertyWatch.ts</code>).</p>
|
|
26
|
-
<h2 id="default-behaviour-ready--not-ready">Default behaviour (<code>ready</code> / <code>not ready</code>)</h2>
|
|
27
|
-
<table>
|
|
28
|
-
<thead>
|
|
29
|
-
<tr>
|
|
30
|
-
<th>Placeholder value</th>
|
|
31
|
-
<th>Path <code>ready</code>?</th>
|
|
32
|
-
<th>Inserted segment</th>
|
|
33
|
-
<th>Notes</th>
|
|
34
|
-
</tr>
|
|
35
|
-
</thead>
|
|
36
|
-
<tbody><tr>
|
|
37
|
-
<td><code>undefined</code></td>
|
|
38
|
-
<td><strong>no</strong></td>
|
|
39
|
-
<td>—</td>
|
|
40
|
-
<td>Wait until defined</td>
|
|
41
|
-
</tr>
|
|
42
|
-
<tr>
|
|
43
|
-
<td><code>null</code></td>
|
|
44
|
-
<td><strong>no</strong></td>
|
|
45
|
-
<td>—</td>
|
|
46
|
-
<td>Same as undefined</td>
|
|
47
|
-
</tr>
|
|
48
|
-
<tr>
|
|
49
|
-
<td><code>""</code></td>
|
|
50
|
-
<td><strong>yes</strong></td>
|
|
51
|
-
<td>empty string</td>
|
|
52
|
-
<td>e.g. <code>sessions//sync</code> — request may still run</td>
|
|
53
|
-
</tr>
|
|
54
|
-
<tr>
|
|
55
|
-
<td><code>0</code></td>
|
|
56
|
-
<td><strong>yes</strong></td>
|
|
57
|
-
<td><code>"0"</code></td>
|
|
58
|
-
<td>Not treated as “missing”</td>
|
|
59
|
-
</tr>
|
|
60
|
-
<tr>
|
|
61
|
-
<td><code>false</code></td>
|
|
62
|
-
<td><strong>yes</strong></td>
|
|
63
|
-
<td><code>"false"</code></td>
|
|
64
|
-
<td></td>
|
|
65
|
-
</tr>
|
|
66
|
-
<tr>
|
|
67
|
-
<td><code>42</code>, <code>"alpha"</code></td>
|
|
68
|
-
<td><strong>yes</strong></td>
|
|
69
|
-
<td><code>"42"</code>, <code>"alpha"</code></td>
|
|
70
|
-
<td></td>
|
|
71
|
-
</tr>
|
|
72
|
-
</tbody></table>
|
|
73
|
-
<p>When <code>ready: false</code>, decorators <strong>do not</strong> call the network (for <code>@get</code> / <code>@post</code> / <code>@put</code> / <code>@patch</code>), <strong>unsubscribe</strong> (<code>@bind</code> / <code>@subscribe</code>), or skip publisher binding (<code>@publish</code> / <code>@handle</code>). The decorated property is often left unchanged or set to <code>undefined</code> (HTTP decorators).</p>
|
|
74
|
-
<p>When the placeholder later becomes valid, observers run again and behaviour resumes.</p>
|
|
75
|
-
<h2 id="skipemptyplaceholder-option"><code>skipEmptyPlaceholder</code> option</h2>
|
|
76
|
-
<p>Some APIs should not run while an id is still <code>""</code>. Opt in per decorator:</p>
|
|
77
|
-
<pre><code class="language-typescript">@get(new Endpoint<User, { userId: string }>("users/${userId}"), {
|
|
78
|
-
skipEmptyPlaceholder: true,
|
|
79
|
-
})
|
|
80
|
-
</code></pre>
|
|
81
|
-
<table>
|
|
82
|
-
<thead>
|
|
83
|
-
<tr>
|
|
84
|
-
<th>Option</th>
|
|
85
|
-
<th>Scope</th>
|
|
86
|
-
</tr>
|
|
87
|
-
</thead>
|
|
88
|
-
<tbody><tr>
|
|
89
|
-
<td><code>skipEmptyPlaceholder?: boolean</code></td>
|
|
90
|
-
<td><strong>Only</strong> empty string <code>''</code> on a placeholder</td>
|
|
91
|
-
</tr>
|
|
92
|
-
<tr>
|
|
93
|
-
<td>Default <code>false</code></td>
|
|
94
|
-
<td><code>""</code> is inserted into the path (legacy behaviour)</td>
|
|
95
|
-
</tr>
|
|
96
|
-
<tr>
|
|
97
|
-
<td><code>true</code></td>
|
|
98
|
-
<td><code>""</code> → <code>ready: false</code>, same as <code>null</code> / <code>undefined</code> for that segment</td>
|
|
99
|
-
</tr>
|
|
100
|
-
</tbody></table>
|
|
101
|
-
<p>Does <strong>not</strong> affect <code>0</code>, <code>false</code>, <code>null</code>, or <code>undefined</code> (nullish stays “not ready” regardless).</p>
|
|
102
|
-
<p>Available on:</p>
|
|
103
|
-
<table>
|
|
104
|
-
<thead>
|
|
105
|
-
<tr>
|
|
106
|
-
<th>API</th>
|
|
107
|
-
<th>Where</th>
|
|
108
|
-
</tr>
|
|
109
|
-
</thead>
|
|
110
|
-
<tbody><tr>
|
|
111
|
-
<td><code>@get</code></td>
|
|
112
|
-
<td>2nd or 3rd argument (<code>GetOptions</code>)</td>
|
|
113
|
-
</tr>
|
|
114
|
-
<tr>
|
|
115
|
-
<td><code>@post</code> / <code>@put</code> / <code>@patch</code></td>
|
|
116
|
-
<td><code>PostOptions</code> / <code>ApiSendOptions</code></td>
|
|
117
|
-
</tr>
|
|
118
|
-
<tr>
|
|
119
|
-
<td><code>@bind</code> / <code>@subscribe</code></td>
|
|
120
|
-
<td><code>BindOptions</code></td>
|
|
121
|
-
</tr>
|
|
122
|
-
<tr>
|
|
123
|
-
<td><code>@publish</code></td>
|
|
124
|
-
<td>2nd argument <code>PublishOptions</code></td>
|
|
125
|
-
</tr>
|
|
126
|
-
<tr>
|
|
127
|
-
<td><code>@handle</code></td>
|
|
128
|
-
<td><code>HandleOptions</code></td>
|
|
129
|
-
</tr>
|
|
130
|
-
</tbody></table>
|
|
131
|
-
<h2 id="per-decorator-summary">Per-decorator summary</h2>
|
|
132
|
-
<table>
|
|
133
|
-
<thead>
|
|
134
|
-
<tr>
|
|
135
|
-
<th>Decorator</th>
|
|
136
|
-
<th><code>ready: false</code></th>
|
|
137
|
-
<th><code>ready: true</code></th>
|
|
138
|
-
</tr>
|
|
139
|
-
</thead>
|
|
140
|
-
<tbody><tr>
|
|
141
|
-
<td><code>@get</code></td>
|
|
142
|
-
<td>No HTTP; <code>payload</code> → <code>undefined</code></td>
|
|
143
|
-
<td><code>ApiResult</code> assigned</td>
|
|
144
|
-
</tr>
|
|
145
|
-
<tr>
|
|
146
|
-
<td><code>@post</code> / <code>@put</code> / <code>@patch</code></td>
|
|
147
|
-
<td>No HTTP; <code>payload</code> → <code>undefined</code></td>
|
|
148
|
-
<td><code>ApiResult</code> assigned</td>
|
|
149
|
-
</tr>
|
|
150
|
-
<tr>
|
|
151
|
-
<td><code>@subscribe</code> / <code>@bind</code></td>
|
|
152
|
-
<td>Unsubscribe; prop keeps last value</td>
|
|
153
|
-
<td>Subscribe <code>onAssign</code></td>
|
|
154
|
-
</tr>
|
|
155
|
-
<tr>
|
|
156
|
-
<td><code>@publish</code></td>
|
|
157
|
-
<td>Internal publisher <code>null</code>; writes ignored</td>
|
|
158
|
-
<td><code>publisher.set</code> on assign</td>
|
|
159
|
-
</tr>
|
|
160
|
-
<tr>
|
|
161
|
-
<td><code>@handle</code></td>
|
|
162
|
-
<td>No subscription; with <code>waitForAllDefined</code>, method not called</td>
|
|
163
|
-
<td>Callback on assign</td>
|
|
164
|
-
</tr>
|
|
165
|
-
</tbody></table>
|
|
166
|
-
<h2 id="see-also">See also</h2>
|
|
167
|
-
<ul>
|
|
168
|
-
<li><a href="./dataProviderKey.html#dataProviderKey">DataProviderKey</a> — path syntax</li>
|
|
169
|
-
<li><a href="./endpoint.html#endpoint">Endpoint</a> — HTTP paths + host generic <code>U</code></li>
|
|
170
|
-
<li>HTTP: <a href="../_decorators/get.html#get">@get</a> · <a href="../_decorators/post.html#post">@post</a> · <a href="../_decorators/put.html#put">@put</a> · <a href="../_decorators/patch.html#patch">@patch</a></li>
|
|
171
|
-
<li>Store: <a href="../_decorators/subscribe.html#subscribe">@subscribe</a> · <a href="../_decorators/bind.html#bind">@bind</a> · <a href="../_decorators/publish.html#publish">@publish</a> · <a href="../_decorators/handle.html#handle">@handle</a></li>
|
|
172
|
-
<li>Legacy strings: <a href="../_decorators/on-assign.html#on-assign">@onAssign</a> (dynamic paths section)</li>
|
|
173
|
-
<li>Templates: <a href="../_directives/sub.html#sub">sub()</a> — dynamic paths in Lit (no <code>skipEmptyPlaceholder</code> yet)</li>
|
|
174
|
-
<li>Tutorial: <a href="../_getting-started/my-first-component.html#my-first-component">My first component</a> — <code>"${dataProvider}"</code> scope pattern</li>
|
|
175
|
-
</ul>
|
|
176
|
-
|
|
177
|
-
</article>
|
|
178
|
-
</main>
|
|
179
|
-
</body>
|
|
180
|
-
</html>
|
|
@@ -1,50 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_misc/endpoint.html" data-doc-id="docs/_misc/endpoint">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>Endpoint — Concorde</title>
|
|
7
|
-
<meta name="description" content="Endpoint<T, U> describes a single HTTP path (or a path accepted by API.get) and carries the expected response type T. Unlike DataProviderKey, there is no dot-navigation: the path is one string.">
|
|
8
|
-
<meta name="keywords" content="Concorde, supersoniks, docs/_misc/endpoint, endpoint, Endpoint, reference, API.get, (default , ${…}, {$…}, null, undefined, "", and , userId">
|
|
9
|
-
<meta name="concorde-doc-id" content="docs/_misc/endpoint">
|
|
10
|
-
<link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_misc/endpoint.html">
|
|
11
|
-
</head>
|
|
12
|
-
<body>
|
|
13
|
-
<header>
|
|
14
|
-
<p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_misc/endpoint.md/endpoint" rel="nofollow">interactive version</a></p>
|
|
15
|
-
</header>
|
|
16
|
-
<main>
|
|
17
|
-
<article>
|
|
18
|
-
<p class="doc-lead" id="doc-summary"><strong>Concorde reference — Endpoint</strong>. Endpoint<T, U> describes a single HTTP path (or a path accepted by API.get) and carries the expected response type T. Unlike DataProviderKey, there is no dot-navigation: the path is one string. <span>Doc ID: <code>docs/_misc/endpoint</code>. Keywords: Concorde, supersoniks, docs/_misc/endpoint, endpoint, Endpoint, reference, API.get, (default , ${…}, {$…}, null, undefined, "", and , userId. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_misc/endpoint.html">https://concorde.supersoniks.org/crawl/docs/_misc/endpoint.html</a>.</span></p>
|
|
19
|
-
<h1 id="endpoint">Endpoint</h1>
|
|
20
|
-
<p><code>Endpoint<T, U></code> describes a single HTTP path (or a path accepted by <code>API.get</code>) and carries the expected response type <code>T</code>. Unlike <a href="./dataProviderKey.html#dataProviderKey">DataProviderKey</a>, there is no dot-navigation: the path is one string.</p>
|
|
21
|
-
<p>The optional second generic <code>U</code> (default <code>any</code>) describes host properties used to resolve dynamic segments in the path (<code>${…}</code> / <code>{$…}</code>), for example with <a href="../_decorators/get.html#get">@get</a> or <a href="../_decorators/post.html#post">@post</a>. See <a href="./dynamic-path.html#dynamic-path">Dynamic path placeholders</a> for <code>null</code> / <code>undefined</code> / <code>""</code> / <code>0</code> and <code>skipEmptyPlaceholder</code>.</p>
|
|
22
|
-
<h2 id="import">Import</h2>
|
|
23
|
-
<pre><code class="language-typescript">import { Endpoint } from "@supersoniks/concorde/utils/endpoint";
|
|
24
|
-
</code></pre>
|
|
25
|
-
<h2 id="construction">Construction</h2>
|
|
26
|
-
<pre><code class="language-typescript">const users = new Endpoint&lt;User[]&gt;("users?limit=10");
|
|
27
|
-
users.path; // "users?limit=10"
|
|
28
|
-
|
|
29
|
-
const one = new Endpoint&lt;User, { userId: string }&gt;("users/${userId}");
|
|
30
|
-
// `userId` on the host class is observed when used with @get
|
|
31
|
-
</code></pre>
|
|
32
|
-
<h2 id="normalization">Normalization</h2>
|
|
33
|
-
<p><code>Endpoint.normalizePath</code> trims the string, rejects an empty path, strips leading slashes for paths relative to <code>serviceURL</code>, collapses duplicate slashes, and validates absolute <code>http(s)://</code> URLs.</p>
|
|
34
|
-
<h2 id="publisher-key-for-payloads">Publisher key for payloads</h2>
|
|
35
|
-
<p><code>getDataProviderKey()</code> returns a typed publisher key whose <code>path</code> matches the endpoint path (payload typing follows <code>ApiResult</code> for this endpoint). Useful when pairing <code>@get</code> with <code>@publish</code> / <code>@subscribe</code> (see <a href="../_decorators/get.html#get">@get</a>).</p>
|
|
36
|
-
<h2 id="data-provider-paths">Data-provider paths</h2>
|
|
37
|
-
<p><code>Endpoint.looksLikeDataProviderPath(path)</code> returns true for strings shaped like <code>dataProvider(id)…</code>, which <code>API.get</code> can resolve without HTTP.</p>
|
|
38
|
-
<h2 id="see-also">See also</h2>
|
|
39
|
-
<ul>
|
|
40
|
-
<li><a href="./api-configuration.html#api-configuration">API configuration</a> — <code>serviceURL</code>, token, wording (mock demos)</li>
|
|
41
|
-
<li><a href="../_decorators/get.html#get">@get</a> — GET decorator</li>
|
|
42
|
-
<li><a href="../_decorators/post.html#post">@post</a> — POST decorator (body from a <code>DataProviderKey</code>)</li>
|
|
43
|
-
<li><a href="../_decorators/put.html#put">@put</a> · <a href="../_decorators/patch.html#patch">@patch</a> — PUT / PATCH decorators</li>
|
|
44
|
-
<li><a href="./dataProviderKey.html#dataProviderKey">DataProviderKey</a> — typed publisher paths (dot notation)</li>
|
|
45
|
-
</ul>
|
|
46
|
-
|
|
47
|
-
</article>
|
|
48
|
-
</main>
|
|
49
|
-
</body>
|
|
50
|
-
</html>
|
|
@@ -1,138 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_misc/formelement-subscriber-removal.html" data-doc-id="docs/_misc/formelement-subscriber-removal">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>FormElement without Subscriber (REDMINE-79569) — Concorde</title>
|
|
7
|
-
<meta name="description" content="Form fields (sonic-input, textarea, select, checkbox, radio, switch, button, input-autocomplete) no longer inherit the Subscriber mixin.">
|
|
8
|
-
<meta name="keywords" content="Concorde, supersoniks, docs/_misc/formelement-subscriber-removal, formelement-subscriber-removal, FormElement without Subscriber (REDMINE-79569), reference, sonic-input, textarea, select, checkbox, radio, switch, button, input-autocomplete, dataProvider, formDataProvider">
|
|
9
|
-
<meta name="concorde-doc-id" content="docs/_misc/formelement-subscriber-removal">
|
|
10
|
-
<link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_misc/formelement-subscriber-removal.html">
|
|
11
|
-
</head>
|
|
12
|
-
<body>
|
|
13
|
-
<header>
|
|
14
|
-
<p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_misc/formelement-subscriber-removal.md/formelement-subscriber-removal" rel="nofollow">interactive version</a></p>
|
|
15
|
-
</header>
|
|
16
|
-
<main>
|
|
17
|
-
<article>
|
|
18
|
-
<p class="doc-lead" id="doc-summary"><strong>Concorde reference — FormElement without Subscriber (REDMINE-79569)</strong>. Form fields (sonic-input, textarea, select, checkbox, radio, switch, button, input-autocomplete) no longer inherit the Subscriber mixin. <span>Doc ID: <code>docs/_misc/formelement-subscriber-removal</code>. Keywords: Concorde, supersoniks, docs/_misc/formelement-subscriber-removal, formelement-subscriber-removal, FormElement without Subscriber (REDMINE-79569), reference, sonic-input, textarea, select, checkbox, radio, switch, button, input-autocomplete, dataProvider, formDataProvider. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_misc/formelement-subscriber-removal.html">https://concorde.supersoniks.org/crawl/docs/_misc/formelement-subscriber-removal.html</a>.</span></p>
|
|
19
|
-
<h1 id="formelement-without-subscriber-redmine-79569">FormElement without Subscriber (REDMINE-79569)</h1>
|
|
20
|
-
<p>Form fields (<code>sonic-input</code>, <code>textarea</code>, <code>select</code>, <code>checkbox</code>, <code>radio</code>, <code>switch</code>, <code>button</code>, <code>input-autocomplete</code>) no longer inherit the <strong>Subscriber</strong> mixin.</p>
|
|
21
|
-
<h2 id="behaviour-now">Behaviour now</h2>
|
|
22
|
-
<table>
|
|
23
|
-
<thead>
|
|
24
|
-
<tr>
|
|
25
|
-
<th>Before</th>
|
|
26
|
-
<th>After</th>
|
|
27
|
-
</tr>
|
|
28
|
-
</thead>
|
|
29
|
-
<tbody><tr>
|
|
30
|
-
<td>Dual channel <code>dataProvider</code> (autofill) + <code>formDataProvider</code></td>
|
|
31
|
-
<td><strong><code>formDataProvider</code> + <code>name</code> only</strong></td>
|
|
32
|
-
</tr>
|
|
33
|
-
<tr>
|
|
34
|
-
<td>Ancestor <code>dataProvider</code> auto-filled field props</td>
|
|
35
|
-
<td>Ignored by form fields</td>
|
|
36
|
-
</tr>
|
|
37
|
-
<tr>
|
|
38
|
-
<td><code>noAutoFill</code> on fields/buttons inside a <code>dataProvider</code> tree</td>
|
|
39
|
-
<td>Dead on form fields (attribute harmless; can be cleaned in apps)</td>
|
|
40
|
-
</tr>
|
|
41
|
-
</tbody></table>
|
|
42
|
-
<p>Preview pattern still valid: form writes via <code>formDataProvider</code>, display card reads via <code>dataProvider</code> on a <strong>Subscriber</strong> (or <code>@subscribe</code>) sibling — not on the fields themselves.</p>
|
|
43
|
-
<h2 id="migration-checklist-apps">Migration checklist (apps)</h2>
|
|
44
|
-
<ol>
|
|
45
|
-
<li>Prefer <code>formDataProvider</code> alone on forms / fieldsets.</li>
|
|
46
|
-
<li>Drop redundant <code>dataProvider={sameKey}</code> on form containers when it only existed for field autofill.</li>
|
|
47
|
-
<li>Prefill edit forms with <code>set(formKey, row)</code> / <code>dp(formKey.field).set(...)</code> before mount — not field <code>dataProvider</code>.</li>
|
|
48
|
-
<li>Remove <code>noAutoFill</code> on <code>sonic-button</code> / fields when it only blocked Subscriber autofill.</li>
|
|
49
|
-
<li><code>initFromPublisher</code> still works (form publisher only).</li>
|
|
50
|
-
</ol>
|
|
51
|
-
<h2 id="billetterie-collect--dual-channel-risk">Billetterie collect — dual-channel risk</h2>
|
|
52
|
-
<p>Files under <code>la-billetterie/concorde</code> that mention both <code>formDataProvider</code> and <code>dataProvider=</code> (review; many are filter+queue, not field autofill):</p>
|
|
53
|
-
<h3 id="high-priority-same-key-on-form-container">High priority (same key on form container)</h3>
|
|
54
|
-
<ul>
|
|
55
|
-
<li><code>la-billetterie/components/reservation-request/atoms/request-event-form.ts</code> — <code>form</code> / <code>fieldset</code> with both attrs equal</li>
|
|
56
|
-
<li><code>la-billetterie/components/reservation/atoms/new-quote-form.ts</code></li>
|
|
57
|
-
<li><code>la-billetterie/components/stats/sales-summary/sales-summary.ts</code></li>
|
|
58
|
-
<li><code>la-billetterie/components/product/price-selection-form/price-selection-form.ts</code> — <code>formDataProvider</code> + <code>dataProvider="cart/editForm"</code></li>
|
|
59
|
-
<li><code>la-billetterie/components/user/account/link-ticket/link-ticket.ts</code> — distinct keys (API vs form) — keep <code>dataProvider</code> only if used by fetch/submit siblings</li>
|
|
60
|
-
</ul>
|
|
61
|
-
<h3 id="filters--queue-usually-ok">Filters + queue (usually OK)</h3>
|
|
62
|
-
<p><code>formDataProvider</code> on filter bar, <code>dataProvider</code> on <code>sonic-queue</code> / list — no field autofill dependency:</p>
|
|
63
|
-
<ul>
|
|
64
|
-
<li><code>access-control/components/event/list/index.ts</code></li>
|
|
65
|
-
<li><code>access-control/components/control/search/views/list.ts</code></li>
|
|
66
|
-
<li><code>la-billetterie/components/event/form-event-filter/form-event-filter.ts</code></li>
|
|
67
|
-
<li><code>la-billetterie/components/counter/*</code> (agenda, store, reservation-request-treatment, …)</li>
|
|
68
|
-
<li><code>widgets/agenda/agenda.ts</code></li>
|
|
69
|
-
<li>… see full dual list in ticket notes / grep below</li>
|
|
70
|
-
</ul>
|
|
71
|
-
<h3 id="full-dual-channel-file-list-55">Full dual-channel file list (55)</h3>
|
|
72
|
-
<pre><code>concorde/src/access-control/components/control/search/views/list.ts
|
|
73
|
-
concorde/src/access-control/components/event/list/index.ts
|
|
74
|
-
concorde/src/la-billetterie/components/access-control-mobile/access-controller-picker.ts
|
|
75
|
-
concorde/src/la-billetterie/components/accreditations-directory/accreditations-directory.ts
|
|
76
|
-
concorde/src/la-billetterie/components/address/address-suggestion.ts
|
|
77
|
-
concorde/src/la-billetterie/components/bulk/bulk.ts
|
|
78
|
-
concorde/src/la-billetterie/components/campaign/campaign-content.ts
|
|
79
|
-
concorde/src/la-billetterie/components/counter/agenda/agenda.ts
|
|
80
|
-
concorde/src/la-billetterie/components/counter/event-selector/event-selector.ts
|
|
81
|
-
concorde/src/la-billetterie/components/counter/order-validation/order-validation-settings.ts
|
|
82
|
-
concorde/src/la-billetterie/components/counter/print/format-menu.ts
|
|
83
|
-
concorde/src/la-billetterie/components/counter/reservation-request-treatment/reservation-request-treatment.ts
|
|
84
|
-
concorde/src/la-billetterie/components/counter/store/counter-store.ts
|
|
85
|
-
concorde/src/la-billetterie/components/counter/widgets-settings/widgets-settings-page.ts
|
|
86
|
-
concorde/src/la-billetterie/components/custom-list/custom-list.ts
|
|
87
|
-
concorde/src/la-billetterie/components/event/agenda/agenda.ts
|
|
88
|
-
concorde/src/la-billetterie/components/event/atoms/buy-event-block/buy-event-block.ts
|
|
89
|
-
concorde/src/la-billetterie/components/event/atoms/categorizedPrices/categorizedPrices.ts
|
|
90
|
-
concorde/src/la-billetterie/components/event/event-store/event-store-content.ts
|
|
91
|
-
concorde/src/la-billetterie/components/event/form-event-filter/form-event-filter.ts
|
|
92
|
-
concorde/src/la-billetterie/components/form/event-selection/event-selection-filters.ts
|
|
93
|
-
concorde/src/la-billetterie/components/form/event-selection/event-selection.ts
|
|
94
|
-
concorde/src/la-billetterie/components/giftcards/giftcard-link.ts
|
|
95
|
-
concorde/src/la-billetterie/components/layout/header.ts
|
|
96
|
-
concorde/src/la-billetterie/components/orders/recover/recover.ts
|
|
97
|
-
concorde/src/la-billetterie/components/placing/atoms/placement-choice/placement-choice.ts
|
|
98
|
-
concorde/src/la-billetterie/components/placing/seatmap-view/seatmap-view.ts
|
|
99
|
-
concorde/src/la-billetterie/components/product/price-selection-form/price-selection-form.ts
|
|
100
|
-
concorde/src/la-billetterie/components/product/prices-form/price-button/price-button.ts
|
|
101
|
-
concorde/src/la-billetterie/components/purchase/purchase-summary/complementary-info/complementary-info.ts
|
|
102
|
-
concorde/src/la-billetterie/components/reservation-request/atoms/request-event-form.ts
|
|
103
|
-
concorde/src/la-billetterie/components/reservation/atoms/new-quote-form.ts
|
|
104
|
-
concorde/src/la-billetterie/components/reservation/reservation-content.ts
|
|
105
|
-
concorde/src/la-billetterie/components/seatmap/seatmap.ts
|
|
106
|
-
concorde/src/la-billetterie/components/shop/shop.ts
|
|
107
|
-
concorde/src/la-billetterie/components/stats/dashboard/dashboard.ts
|
|
108
|
-
concorde/src/la-billetterie/components/stats/event/event-stats-check.ts
|
|
109
|
-
concorde/src/la-billetterie/components/stats/sales-summary/sales-summary.ts
|
|
110
|
-
concorde/src/la-billetterie/components/subscription/atoms/quick-select-display-toggle/quick-select-display-toggle.ts
|
|
111
|
-
concorde/src/la-billetterie/components/subscription/cart-quick-select.ts
|
|
112
|
-
concorde/src/la-billetterie/components/subscription/edit/subscription-renew-form.ts
|
|
113
|
-
concorde/src/la-billetterie/components/ticket/ticket-freeup.ts
|
|
114
|
-
concorde/src/la-billetterie/components/tickets-app/default-router.ts
|
|
115
|
-
concorde/src/la-billetterie/components/user/account/account-purchases.ts
|
|
116
|
-
concorde/src/la-billetterie/components/user/account/account-tickets.ts
|
|
117
|
-
concorde/src/la-billetterie/components/user/account/link-ticket/link-ticket.ts
|
|
118
|
-
concorde/src/la-billetterie/components/user/form/login.ts
|
|
119
|
-
concorde/src/la-billetterie/components/user/user-attach/buyer-attach-form.ts
|
|
120
|
-
concorde/src/la-billetterie/components/user/user-attach/buyer-attach.ts
|
|
121
|
-
concorde/src/la-billetterie/components/user/user-attach/owner-attach-form.ts
|
|
122
|
-
concorde/src/la-billetterie/components/user/user-attach/subscription-attach-form.ts
|
|
123
|
-
concorde/src/la-billetterie/components/user/user-attach/subscription-selector.ts
|
|
124
|
-
concorde/src/la-billetterie/components/user/user-selector/user-selector.ts
|
|
125
|
-
concorde/src/la-billetterie/components/user/user-suggest/user-suggest.ts
|
|
126
|
-
concorde/src/widgets/agenda/agenda.ts
|
|
127
|
-
</code></pre>
|
|
128
|
-
<p>Re-run audit:</p>
|
|
129
|
-
<pre><code class="language-bash"># from la-billetterie
|
|
130
|
-
rg -l 'formDataProvider' concorde/src | while read f; do rg -q 'dataProvider\s*=' "$f" && echo "$f"; done
|
|
131
|
-
</code></pre>
|
|
132
|
-
<h2 id="non-regression-concorde-docs">Non-regression (Concorde docs)</h2>
|
|
133
|
-
<p>Smoke form demos: input, textarea, select, checkbox (incl. check-all), radio, switch, button form modes, queue + <code>dataFilterProvider</code>, submit, validation / sameValueAs, input-autocomplete.</p>
|
|
134
|
-
|
|
135
|
-
</article>
|
|
136
|
-
</main>
|
|
137
|
-
</body>
|
|
138
|
-
</html>
|
|
@@ -1,48 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_misc/html-integration.html" data-doc-id="docs/_misc/html-integration">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>HTML integration (no Lit) — Concorde</title>
|
|
7
|
-
<meta name="description" content="Some hosts (legacy PHP pages, static HTML) embed Concorde components without a Lit build step. They can use HTML attributes such as data-bind, dataProvider, and formDataProvider on tags directly in th">
|
|
8
|
-
<meta name="keywords" content="Concorde, supersoniks, docs/_misc/html-integration, html-integration, HTML integration (no Lit), reference, data-bind, dataProvider, formDataProvider, sonic-input, name, src/docs/example/, ">
|
|
9
|
-
<meta name="concorde-doc-id" content="docs/_misc/html-integration">
|
|
10
|
-
<link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_misc/html-integration.html">
|
|
11
|
-
</head>
|
|
12
|
-
<body>
|
|
13
|
-
<header>
|
|
14
|
-
<p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_misc/html-integration.md/html-integration" rel="nofollow">interactive version</a></p>
|
|
15
|
-
</header>
|
|
16
|
-
<main>
|
|
17
|
-
<article>
|
|
18
|
-
<p class="doc-lead" id="doc-summary"><strong>Concorde reference — HTML integration (no Lit)</strong>. Some hosts (legacy PHP pages, static HTML) embed Concorde components without a Lit build step. They can use HTML attributes such as data-bind, dataProvider, and formDataProvider on tags directly in th <span>Doc ID: <code>docs/_misc/html-integration</code>. Keywords: Concorde, supersoniks, docs/_misc/html-integration, html-integration, HTML integration (no Lit), reference, data-bind, dataProvider, formDataProvider, sonic-input, name, src/docs/example/, . URL: <a href="https://concorde.supersoniks.org/crawl/docs/_misc/html-integration.html">https://concorde.supersoniks.org/crawl/docs/_misc/html-integration.html</a>.</span></p>
|
|
19
|
-
<h1 id="html-integration-no-lit">HTML integration (no Lit)</h1>
|
|
20
|
-
<p>Some hosts (legacy PHP pages, static HTML) embed Concorde components <strong>without</strong> a Lit build step. They can use HTML attributes such as <strong><code>data-bind</code></strong>, <strong><code>dataProvider</code></strong>, and <strong><code>formDataProvider</code></strong> on tags directly in the page.</p>
|
|
21
|
-
<p><strong>Form fields</strong> (<code>sonic-input</code>, checkbox, select, …) bind only via <strong><code>formDataProvider</code> + <code>name</code></strong>. They do not autofill from ancestor <code>dataProvider</code> (Subscriber was removed from FormElement — see <a href="./formelement-subscriber-removal.html#formelement-subscriber-removal">FormElement without Subscriber</a>).</p>
|
|
22
|
-
<p>That style is <strong>not</strong> what we demonstrate in this doc site: live examples are <strong>Lit components</strong> under <code>src/docs/example/</code>, registered once and reused from Markdown via tags like <code><docs-joke-search-demo></code>.</p>
|
|
23
|
-
<table>
|
|
24
|
-
<thead>
|
|
25
|
-
<tr>
|
|
26
|
-
<th>Goal</th>
|
|
27
|
-
<th>Use</th>
|
|
28
|
-
</tr>
|
|
29
|
-
</thead>
|
|
30
|
-
<tbody><tr>
|
|
31
|
-
<td>Learn modern patterns</td>
|
|
32
|
-
<td><a href="../_getting-started/my-first-component.html#my-first-component">My first component</a>, <a href="../_core-concept/dataFlow.html#dataFlow">Data flow</a></td>
|
|
33
|
-
</tr>
|
|
34
|
-
<tr>
|
|
35
|
-
<td>Author doc examples</td>
|
|
36
|
-
<td><code><docs-lit-demo></code> + <code>src/docs/example/*.ts</code> — see <a href="../_getting-started/my-first-component.html#my-first-component">My first component</a></td>
|
|
37
|
-
</tr>
|
|
38
|
-
<tr>
|
|
39
|
-
<td>Embed in plain HTML only</td>
|
|
40
|
-
<td><code>data-bind</code> / Subscriber docs in <strong>Legacy</strong> — <a href="../_core-concept/subscriber.html#subscriber">Subscriber mixin</a></td>
|
|
41
|
-
</tr>
|
|
42
|
-
</tbody></table>
|
|
43
|
-
<p>New application code in TypeScript should use <strong><code>@subscribe</code></strong>, <strong><code>formDataProvider</code> + <code>name</code></strong>, and Lit templates — not HTML <code>data-bind</code>.</p>
|
|
44
|
-
|
|
45
|
-
</article>
|
|
46
|
-
</main>
|
|
47
|
-
</body>
|
|
48
|
-
</html>
|