@supersoniks/concorde 5.0.0 → 5.0.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/.gitlab-ci.yml +0 -13
- package/build-infos.json +1 -1
- package/concorde-core.bundle.js +257 -273
- package/concorde-core.es.js +4127 -4039
- package/dist/concorde-core.bundle.js +257 -273
- package/dist/concorde-core.es.js +4127 -4039
- package/gitlab/job_tests.sh +25 -12
- package/index.html +1 -1
- package/package.json +3 -1
- package/scripts/post-build-docs.js +0 -0
- package/scripts/post-build.mjs +0 -0
- package/src/core/components/functional/fetch/fetch.md +0 -0
- package/src/core/components/functional/if/if.md +0 -0
- package/src/core/components/functional/list/list.demo.ts +0 -0
- package/src/core/components/functional/list/list.md +0 -0
- package/src/core/components/functional/list/list.ts +0 -0
- package/src/core/components/functional/router/router.md +0 -0
- package/src/core/components/functional/router/router.ts +0 -0
- package/src/core/components/functional/sdui/sdui.md +0 -0
- package/src/core/components/functional/states/states.md +0 -0
- package/src/core/components/functional/submit/submit.md +0 -0
- package/src/core/components/ui/_css/size.ts +0 -0
- package/src/core/components/ui/alert/alert.ts +0 -0
- package/src/core/components/ui/button/button.md +0 -0
- package/src/core/components/ui/captcha/altchaStyles.ts +0 -0
- package/src/core/components/ui/captcha/captcha.md +0 -0
- package/src/core/components/ui/card/card.md +0 -0
- package/src/core/components/ui/divider/divider.ts +0 -0
- package/src/core/components/ui/form/input/input.md +0 -0
- package/src/core/components/ui/form/radio/radio.md +0 -0
- package/src/core/components/ui/form/select/select.md +0 -0
- package/src/core/components/ui/form/switch/switch.md +0 -0
- package/src/core/components/ui/loader/loader.md +0 -0
- package/src/core/components/ui/menu/menu.md +0 -0
- package/src/core/components/ui/modal/modal-close.ts +0 -0
- package/src/core/components/ui/modal/modal.md +0 -0
- package/src/core/components/ui/pop/pop.md +103 -1
- package/src/core/components/ui/pop/pop.ts +70 -115
- package/src/core/components/ui/table/table-caption.ts +0 -0
- package/src/core/components/ui/table/table.md +0 -0
- package/src/core/components/ui/theme/theme.ts +1 -1
- package/src/core/components/ui/tooltip/tooltip.ts +178 -154
- package/src/core/utils/positioning.spec.ts +180 -0
- package/src/core/utils/positioning.ts +164 -0
- package/src/core/utils/route.ts +0 -0
- package/src/directives.ts +2 -3
- package/src/docs/_core-concept/subscriber.md +0 -0
- package/src/docs/_getting-started/concorde-outside.md +0 -0
- package/src/docs/_getting-started/my-first-subscriber.md +0 -0
- package/src/docs/_getting-started/pubsub.md +0 -0
- package/src/docs/_getting-started/start.md +0 -0
- package/src/docs/example/users.ts +0 -0
- package/src/docs/search/docs-search.json +90 -0
- package/src/docs/search/page.ts +0 -0
- package/src/docs/tailwind/css/tailwind.css +7 -6
- package/src/tsconfig.json +387 -381
- package/src/tsconfig.tsbuildinfo +1 -1
- package/vitest.setup.ts +49 -13
- 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-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/altcha-widget.js +0 -2662
- package/docs/assets/index-BZiZXMU-.css +0 -1
- package/docs/assets/index-FmK4JaIM.js +0 -11992
- 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 -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 -106
- 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/menu/menu.html +0 -322
- 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/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 -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/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 -85
- 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 -357
- package/docs/crawl/hubs/remote-data.html +0 -452
- package/docs/crawl/index.html +0 -101
- package/docs/css/docs.css +0 -0
- package/docs/docs-mock-api-sw.js +0 -720
- package/docs/docs-mock-api-sw.js.map +0 -7
- package/docs/fonts/ClashGrotesk-Bold.eot +0 -0
- package/docs/fonts/ClashGrotesk-Bold.ttf +0 -0
- package/docs/fonts/ClashGrotesk-Bold.woff +0 -0
- package/docs/fonts/ClashGrotesk-Bold.woff2 +0 -0
- package/docs/fonts/ClashGrotesk-Extralight.eot +0 -0
- package/docs/fonts/ClashGrotesk-Extralight.ttf +0 -0
- package/docs/fonts/ClashGrotesk-Extralight.woff +0 -0
- package/docs/fonts/ClashGrotesk-Extralight.woff2 +0 -0
- package/docs/fonts/ClashGrotesk-Light.eot +0 -0
- package/docs/fonts/ClashGrotesk-Light.ttf +0 -0
- package/docs/fonts/ClashGrotesk-Light.woff +0 -0
- package/docs/fonts/ClashGrotesk-Light.woff2 +0 -0
- package/docs/fonts/ClashGrotesk-Medium.eot +0 -0
- package/docs/fonts/ClashGrotesk-Medium.ttf +0 -0
- package/docs/fonts/ClashGrotesk-Medium.woff +0 -0
- package/docs/fonts/ClashGrotesk-Medium.woff2 +0 -0
- package/docs/fonts/ClashGrotesk-Regular.eot +0 -0
- package/docs/fonts/ClashGrotesk-Regular.ttf +0 -0
- package/docs/fonts/ClashGrotesk-Regular.woff +0 -0
- package/docs/fonts/ClashGrotesk-Regular.woff2 +0 -0
- package/docs/fonts/ClashGrotesk-Semibold.eot +0 -0
- package/docs/fonts/ClashGrotesk-Semibold.ttf +0 -0
- package/docs/fonts/ClashGrotesk-Semibold.woff +0 -0
- package/docs/fonts/ClashGrotesk-Semibold.woff2 +0 -0
- package/docs/fonts/ClashGrotesk-Variable.eot +0 -0
- package/docs/fonts/ClashGrotesk-Variable.ttf +0 -0
- package/docs/fonts/ClashGrotesk-Variable.woff +0 -0
- package/docs/fonts/ClashGrotesk-Variable.woff2 +0 -0
- package/docs/img/concorde-icon.svg +0 -5
- package/docs/img/concorde-logo.svg +0 -1
- package/docs/img/concorde.png +0 -0
- package/docs/img/concorde_def.png +0 -0
- package/docs/img/concorde_seuil.png.webp +0 -0
- package/docs/img/concorde_seuil_invert.png +0 -0
- package/docs/img/paul_metrand.jpg +0 -0
- package/docs/img/paul_metrand_xs.jpg +0 -0
- package/docs/index.html +0 -93
- package/docs/llms-full.txt +0 -5787
- package/docs/llms.txt +0 -104
- package/docs/robots.txt +0 -16
- package/docs/sitemap.xml +0 -237
- 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 -121
- package/docs/src/core/components/ui/alert-messages/alert-messages.md +0 -0
- package/docs/src/core/components/ui/badge/badge.md +0 -127
- package/docs/src/core/components/ui/button/button.md +0 -182
- package/docs/src/core/components/ui/captcha/captcha.md +0 -12
- package/docs/src/core/components/ui/card/card.md +0 -97
- package/docs/src/core/components/ui/divider/divider.md +0 -35
- package/docs/src/core/components/ui/form/checkbox/checkbox.md +0 -77
- package/docs/src/core/components/ui/form/fieldset/fieldset.md +0 -129
- package/docs/src/core/components/ui/form/form-actions/form-actions.md +0 -77
- package/docs/src/core/components/ui/form/form-layout/form-layout.md +0 -44
- 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 -133
- 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 -125
- package/docs/src/core/components/ui/icon/icons.json +0 -1
- package/docs/src/core/components/ui/image/image.md +0 -107
- package/docs/src/core/components/ui/link/link.md +0 -43
- package/docs/src/core/components/ui/loader/loader.md +0 -55
- package/docs/src/core/components/ui/menu/menu.md +0 -329
- package/docs/src/core/components/ui/modal/modal.md +0 -119
- package/docs/src/core/components/ui/pop/pop.md +0 -96
- package/docs/src/core/components/ui/progress/progress.md +0 -63
- package/docs/src/core/components/ui/table/table.md +0 -455
- package/docs/src/core/components/ui/toast/toast.md +0 -166
- package/docs/src/core/components/ui/tooltip/tooltip.md +0 -82
- 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 -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/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 -91
- 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 -9512
- package/docs/src/tag-list.json +0 -1
- package/docs/src/tsconfig-model.json +0 -23
- package/docs/src/tsconfig.declarations.json +0 -22
- package/docs/src/tsconfig.emit.json +0 -23
- package/docs/src/tsconfig.json +0 -858
- package/docs/svg/regular/plane.svg +0 -1
- package/docs/svg/solid/plane.svg +0 -1
- package/gitlab/job_github_mirror.sh +0 -39
- package/scripts/github-export.mjs +0 -150
- package/src/css.d.ts +0 -19
- package/src/tsconfig.declarations.json +0 -22
- package/src/tsconfig.emit.json +0 -23
|
@@ -1,202 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html" data-doc-id="docs/_decorators/auto-subscribe">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>@autoSubscribe — Concorde</title>
|
|
7
|
-
<meta name="description" content="> Legacy: prefer @subscribe + DataProviderKey. Examples below may still show PublisherManager for existing codebases.">
|
|
8
|
-
<meta name="keywords" content="Concorde, supersoniks, docs/_decorators/auto-subscribe, auto-subscribe, @autoSubscribe, decorator, autoSubscribe, DataProviderKey, PublisherManager, ;
|
|
9
|
-
}
|
|
10
|
-
|
|
11
|
-
render() {
|
|
12
|
-
return html">
|
|
13
|
-
<meta name="concorde-doc-id" content="docs/_decorators/auto-subscribe">
|
|
14
|
-
<link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html">
|
|
15
|
-
</head>
|
|
16
|
-
<body>
|
|
17
|
-
<header>
|
|
18
|
-
<p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_decorators/auto-subscribe.md/auto-subscribe" rel="nofollow">interactive version</a></p>
|
|
19
|
-
</header>
|
|
20
|
-
<main>
|
|
21
|
-
<article>
|
|
22
|
-
<p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @autoSubscribe</strong>. > Legacy: prefer @subscribe + DataProviderKey. Examples below may still show PublisherManager for existing codebases. <span>Doc ID: <code>docs/_decorators/auto-subscribe</code>. Keywords: Concorde, supersoniks, docs/_decorators/auto-subscribe, auto-subscribe, @autoSubscribe, decorator, autoSubscribe, DataProviderKey, PublisherManager, ;
|
|
23
|
-
}
|
|
24
|
-
|
|
25
|
-
render() {
|
|
26
|
-
return html. URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html">https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html</a>.</span></p>
|
|
27
|
-
<h1 id="autosubscribe">@autoSubscribe</h1>
|
|
28
|
-
<blockquote>
|
|
29
|
-
<p><strong>Legacy:</strong> prefer <a href="./subscribe.html#subscribe">@subscribe</a> + <code>DataProviderKey</code>. Examples below may still show <code>PublisherManager</code> for existing codebases.</p>
|
|
30
|
-
</blockquote>
|
|
31
|
-
<p>The <code>@autoSubscribe</code> decorator automatically detects which publishers are accessed within a method and subscribes to them. When any of these publishers change, the method is automatically re-executed.</p>
|
|
32
|
-
<h2 id="principle">Principle</h2>
|
|
33
|
-
<p>This decorator wraps a method to track which publishers are accessed during its execution. It then subscribes to all accessed publishers, and when any of them change, the method is re-executed. This provides automatic reactivity without manually managing subscriptions.</p>
|
|
34
|
-
<h2 id="usage">Usage</h2>
|
|
35
|
-
<h3 id="import">Import</h3>
|
|
36
|
-
<pre><code class="language-typescript">import { autoSubscribe } from "@supersoniks/concorde/decorators";
|
|
37
|
-
</code></pre>
|
|
38
|
-
<h3 id="basic-example">Basic example</h3>
|
|
39
|
-
<pre><code class="language-typescript">@customElement("demo-auto-subscribe")
|
|
40
|
-
export class DemoAutoSubscribe extends LitElement {
|
|
41
|
-
static styles = [tailwind];
|
|
42
|
-
|
|
43
|
-
@state() displayText: string = "";
|
|
44
|
-
@state() computedValue: number = 0;
|
|
45
|
-
|
|
46
|
-
@autoSubscribe()
|
|
47
|
-
updateDisplay() {
|
|
48
|
-
const value1 = PublisherManager.get("autoValue1").get() || 0;
|
|
49
|
-
const value2 = PublisherManager.get("autoValue2").get() || 0;
|
|
50
|
-
this.computedValue = value1 + value2;
|
|
51
|
-
this.displayText = `${value1} + ${value2} = ${this.computedValue}`;
|
|
52
|
-
}
|
|
53
|
-
|
|
54
|
-
render() {
|
|
55
|
-
return html`
|
|
56
|
-
<p><strong>${this.displayText}</strong></p>
|
|
57
|
-
<div>
|
|
58
|
-
<sonic-button @click=${() => this.randomizeValue("autoValue1")}>
|
|
59
|
-
Randomize Value 1
|
|
60
|
-
</sonic-button>
|
|
61
|
-
<sonic-button @click=${() => this.randomizeValue("autoValue2")}>
|
|
62
|
-
Randomize Value 2
|
|
63
|
-
</sonic-button>
|
|
64
|
-
</div>
|
|
65
|
-
`;
|
|
66
|
-
}
|
|
67
|
-
|
|
68
|
-
randomizeValue(publisherId: string) {
|
|
69
|
-
const value = PublisherManager.get(publisherId);
|
|
70
|
-
value.set(Math.floor(Math.random() * 100));
|
|
71
|
-
}
|
|
72
|
-
}
|
|
73
|
-
</code></pre>
|
|
74
|
-
<pre><code><docs-demo-sources for="demo-auto-subscribe"></docs-demo-sources>
|
|
75
|
-
<demo-auto-subscribe></demo-auto-subscribe>
|
|
76
|
-
</code></pre>
|
|
77
|
-
<h3 id="example-with-render-method">Example with render method</h3>
|
|
78
|
-
<pre><code class="language-typescript">@customElement("reactive-view")
|
|
79
|
-
export class ReactiveView extends LitElement {
|
|
80
|
-
@autoSubscribe()
|
|
81
|
-
render() {
|
|
82
|
-
const data = PublisherManager.get("myData");
|
|
83
|
-
const config = PublisherManager.get("config");
|
|
84
|
-
|
|
85
|
-
// This render method will be automatically re-executed
|
|
86
|
-
// when myData or config change
|
|
87
|
-
const value = data.get()?.value || 0;
|
|
88
|
-
const multiplier = config.get()?.multiplier || 1;
|
|
89
|
-
|
|
90
|
-
return html`
|
|
91
|
-
<div>
|
|
92
|
-
<h1>Result: ${value * multiplier}</h1>
|
|
93
|
-
<p>Value: ${value}</p>
|
|
94
|
-
<p>Multiplier: ${multiplier}</p>
|
|
95
|
-
</div>
|
|
96
|
-
`;
|
|
97
|
-
}
|
|
98
|
-
}
|
|
99
|
-
</code></pre>
|
|
100
|
-
<h2 id="how-it-works">How it works</h2>
|
|
101
|
-
<ol>
|
|
102
|
-
<li><strong>First execution</strong>: When the method is called, <code>PublisherManager.collectModifiedPublisher()</code> is used to track which publishers are accessed</li>
|
|
103
|
-
<li><strong>Subscription</strong>: After execution, the decorator subscribes to all detected publishers</li>
|
|
104
|
-
<li><strong>Re-execution</strong>: When any subscribed publisher changes, the method is automatically called again</li>
|
|
105
|
-
<li><strong>Cleanup</strong>: On <code>disconnectedCallback</code>, all subscriptions are automatically removed</li>
|
|
106
|
-
</ol>
|
|
107
|
-
<h2 id="behavior">Behavior</h2>
|
|
108
|
-
<ul>
|
|
109
|
-
<li>The method is automatically called on <code>connectedCallback</code></li>
|
|
110
|
-
<li>The method is re-executed whenever any accessed publisher changes</li>
|
|
111
|
-
<li>Subscriptions are managed automatically (no manual cleanup needed)</li>
|
|
112
|
-
<li>Only publishers accessed during method execution are subscribed to</li>
|
|
113
|
-
<li>The decorator uses <code>queueMicrotask</code> to batch multiple updates and avoid unnecessary re-renders</li>
|
|
114
|
-
</ul>
|
|
115
|
-
<h2 id="use-cases">Use cases</h2>
|
|
116
|
-
<p>This decorator is particularly useful for:</p>
|
|
117
|
-
<ul>
|
|
118
|
-
<li><strong>Reactive rendering</strong> where the render method depends on multiple publishers</li>
|
|
119
|
-
<li><strong>Data transformation</strong> that needs to update when source data changes</li>
|
|
120
|
-
<li><strong>Computed properties</strong> that depend on multiple data sources</li>
|
|
121
|
-
<li><strong>Automatic synchronization</strong> between publishers and component state</li>
|
|
122
|
-
</ul>
|
|
123
|
-
<h2 id="complete-example">Complete example</h2>
|
|
124
|
-
<pre><code class="language-typescript">import { html, LitElement } from "lit";
|
|
125
|
-
import { customElement } from "lit/decorators.js";
|
|
126
|
-
import { autoSubscribe } from "@supersoniks/concorde/decorators";
|
|
127
|
-
import { PublisherManager } from "@supersoniks/concorde/core/utils/PublisherProxy";
|
|
128
|
-
|
|
129
|
-
@customElement("shopping-cart")
|
|
130
|
-
export class ShoppingCart extends LitElement {
|
|
131
|
-
items: any[] = [];
|
|
132
|
-
total: number = 0;
|
|
133
|
-
discount: number = 0;
|
|
134
|
-
|
|
135
|
-
@autoSubscribe()
|
|
136
|
-
calculateTotal() {
|
|
137
|
-
const cart = PublisherManager.get("cart");
|
|
138
|
-
const promo = PublisherManager.get("promo");
|
|
139
|
-
|
|
140
|
-
// Access cart items
|
|
141
|
-
this.items = cart.items.get() || [];
|
|
142
|
-
|
|
143
|
-
// Access promo code
|
|
144
|
-
const promoCode = promo.code.get() || "";
|
|
145
|
-
const discountPercent = promoCode === "SAVE10" ? 0.1 : 0;
|
|
146
|
-
|
|
147
|
-
// Calculate totals
|
|
148
|
-
const subtotal = this.items.reduce((sum, item) =>
|
|
149
|
-
sum + (item.price * item.quantity), 0
|
|
150
|
-
);
|
|
151
|
-
this.discount = subtotal * discountPercent;
|
|
152
|
-
this.total = subtotal - this.discount;
|
|
153
|
-
|
|
154
|
-
this.requestUpdate();
|
|
155
|
-
}
|
|
156
|
-
|
|
157
|
-
connectedCallback() {
|
|
158
|
-
super.connectedCallback();
|
|
159
|
-
this.calculateTotal();
|
|
160
|
-
}
|
|
161
|
-
|
|
162
|
-
render() {
|
|
163
|
-
return html`
|
|
164
|
-
<div class="cart">
|
|
165
|
-
<h2>Shopping Cart</h2>
|
|
166
|
-
${this.items.map(item => html`
|
|
167
|
-
<div>${item.name} x${item.quantity} - ${item.price}€</div>
|
|
168
|
-
`)}
|
|
169
|
-
<div class="total">
|
|
170
|
-
<p>Subtotal: ${this.total + this.discount}€</p>
|
|
171
|
-
<p>Discount: -${this.discount}€</p>
|
|
172
|
-
<p><strong>Total: ${this.total}€</strong></p>
|
|
173
|
-
</div>
|
|
174
|
-
</div>
|
|
175
|
-
`;
|
|
176
|
-
}
|
|
177
|
-
}
|
|
178
|
-
|
|
179
|
-
// When you update the publishers, calculateTotal is automatically called:
|
|
180
|
-
const cart = PublisherManager.get("cart");
|
|
181
|
-
cart.items.set([
|
|
182
|
-
{ name: "Product 1", price: 10, quantity: 2 },
|
|
183
|
-
{ name: "Product 2", price: 15, quantity: 1 }
|
|
184
|
-
]);
|
|
185
|
-
|
|
186
|
-
const promo = PublisherManager.get("promo");
|
|
187
|
-
promo.code.set("SAVE10");
|
|
188
|
-
// calculateTotal will be automatically called and the UI will update
|
|
189
|
-
</code></pre>
|
|
190
|
-
<h2 id="notes">Notes</h2>
|
|
191
|
-
<ul>
|
|
192
|
-
<li>This decorator works with any component that has <code>connectedCallback</code> and <code>disconnectedCallback</code> methods (such as <code>LitElement</code> or components extending <code>Subscriber</code>)</li>
|
|
193
|
-
<li>The method is called automatically on <code>connectedCallback</code></li>
|
|
194
|
-
<li>Remember to call <code>this.requestUpdate()</code> if you're updating component properties</li>
|
|
195
|
-
<li>The decorator uses debouncing via <code>queueMicrotask</code> to prevent excessive re-executions</li>
|
|
196
|
-
<li>For more information about publishers, see the documentation on <a href="../_getting-started/pubsub.html#pubsub">Sharing data</a></li>
|
|
197
|
-
</ul>
|
|
198
|
-
|
|
199
|
-
</article>
|
|
200
|
-
</main>
|
|
201
|
-
</body>
|
|
202
|
-
</html>
|
|
@@ -1,141 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html" data-doc-id="docs/_decorators/bind">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>@bind — Concorde</title>
|
|
7
|
-
<meta name="description" content="Binds a class property to a path in a publisher. The property updates when publisher data changes.">
|
|
8
|
-
<meta name="keywords" content="Concorde, supersoniks, docs/_decorators/bind, bind, @bind, decorator, @state(), DataProviderKey, . Use , reflect: true, publisher.set(...)">
|
|
9
|
-
<meta name="concorde-doc-id" content="docs/_decorators/bind">
|
|
10
|
-
<link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html">
|
|
11
|
-
</head>
|
|
12
|
-
<body>
|
|
13
|
-
<header>
|
|
14
|
-
<p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_decorators/bind.md/bind" rel="nofollow">interactive version</a></p>
|
|
15
|
-
</header>
|
|
16
|
-
<main>
|
|
17
|
-
<article>
|
|
18
|
-
<p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @bind</strong>. Binds a class property to a path in a publisher. The property updates when publisher data changes. <span>Doc ID: <code>docs/_decorators/bind</code>. Keywords: Concorde, supersoniks, docs/_decorators/bind, bind, @bind, decorator, @state(), DataProviderKey, . Use , reflect: true, publisher.set(...). URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html">https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html</a>.</span></p>
|
|
19
|
-
<h1 id="bind">@bind</h1>
|
|
20
|
-
<p>Binds a class property to a path in a publisher. The property updates when publisher data changes.</p>
|
|
21
|
-
<p>For Lit re-renders, also add <code>@state()</code> on the same property.</p>
|
|
22
|
-
<p><strong>See also:</strong> <a href="./subscribe.html#subscribe">@subscribe</a>, <a href="./handle.html#handle">@handle</a>, <a href="./publish.html#publish">@publish</a>, <a href="./get.html#get">@get</a>, <a href="./post.html#post">@post</a>, <a href="./put.html#put">@put</a>, <a href="./patch.html#patch">@patch</a>.</p>
|
|
23
|
-
<h2 id="principle">Principle</h2>
|
|
24
|
-
<p>The decorator subscribes to the DataProvider store using dot notation or a <code>DataProviderKey</code>. Updates flow into the decorated property (<a href="../_core-concept/dataFlow.html#dataFlow">Data flow</a>).</p>
|
|
25
|
-
<h2 id="import">Import</h2>
|
|
26
|
-
<pre><code class="language-typescript">import { bind } from "@supersoniks/concorde/decorators";
|
|
27
|
-
</code></pre>
|
|
28
|
-
<h2 id="example">Example</h2>
|
|
29
|
-
<pre><code class="language-typescript">@customElement("demo-bind")
|
|
30
|
-
export class DemoBind extends LitElement {
|
|
31
|
-
static styles = [tailwind];
|
|
32
|
-
|
|
33
|
-
@bind("demoData.firstName")
|
|
34
|
-
@state()
|
|
35
|
-
firstName = "";
|
|
36
|
-
|
|
37
|
-
@bind("demoData.lastName")
|
|
38
|
-
@state()
|
|
39
|
-
lastName: string = "";
|
|
40
|
-
|
|
41
|
-
@bind("demoData.count")
|
|
42
|
-
@state()
|
|
43
|
-
count: number = 0;
|
|
44
|
-
|
|
45
|
-
render() {
|
|
46
|
-
return //......
|
|
47
|
-
}
|
|
48
|
-
|
|
49
|
-
updateData() {
|
|
50
|
-
set(demoDataKey, { ...get(demoDataKey), count: get(demoDataKey).count + 1 });
|
|
51
|
-
// see demo-bind in src/docs/example/decorators-demo-bind-demos.ts
|
|
52
|
-
const randomIndex = Math.floor(Math.random() * demoUsers.get().length);
|
|
53
|
-
const randomUser = demoUsers.get()[randomIndex];
|
|
54
|
-
demoData.set({
|
|
55
|
-
firstName: randomUser.firstName,
|
|
56
|
-
lastName: randomUser.lastName,
|
|
57
|
-
count: (demoData.count.get() || 0) + 1,
|
|
58
|
-
});
|
|
59
|
-
}
|
|
60
|
-
}
|
|
61
|
-
</code></pre>
|
|
62
|
-
<pre><code><docs-demo-sources for="demo-bind"></docs-demo-sources>
|
|
63
|
-
<demo-bind></demo-bind>
|
|
64
|
-
</code></pre>
|
|
65
|
-
<h2 id="dataproviderkey-strict-typing"><code>DataProviderKey</code> (strict typing)</h2>
|
|
66
|
-
<p><code>@bind</code> accepts either a string path (legacy) or a <code>DataProviderKey<T></code>. The property type must match <code>T</code>. Use <code>reflect: true</code> to push local writes back to the publisher (see below). See <a href="../_misc/dataProviderKey.html#dataProviderKey">DataProviderKey</a>.</p>
|
|
67
|
-
<pre><code class="language-typescript">import { bind } from "@supersoniks/concorde/decorators";
|
|
68
|
-
import { DataProviderKey } from "@supersoniks/concorde/dataProviderKey";
|
|
69
|
-
|
|
70
|
-
type Data = { count: number };
|
|
71
|
-
const dataKey = new DataProviderKey<Data>("data");
|
|
72
|
-
|
|
73
|
-
@bind(dataKey.count, { reflect: true })
|
|
74
|
-
@state()
|
|
75
|
-
count: number = 0;
|
|
76
|
-
</code></pre>
|
|
77
|
-
<h2 id="reflect-reflect-true">Reflect (<code>reflect: true</code>)</h2>
|
|
78
|
-
<p>Two-way sync: reads from the publisher and local assignments call <code>publisher.set(...)</code>. An internal guard avoids infinite loops.</p>
|
|
79
|
-
<pre><code class="language-typescript">@bind("userData.profile.avatarUrl", { reflect: true })
|
|
80
|
-
@state()
|
|
81
|
-
avatar: string;
|
|
82
|
-
</code></pre>
|
|
83
|
-
<pre><code class="language-typescript">@customElement("demo-bind-reflect")
|
|
84
|
-
export class DemoBindReflect extends LitElement {
|
|
85
|
-
static styles = [tailwind];
|
|
86
|
-
|
|
87
|
-
@bind("bindReflectDemo.count", { reflect: true })
|
|
88
|
-
@state()
|
|
89
|
-
withReflect: number = 0;
|
|
90
|
-
|
|
91
|
-
@bind("bindReflectDemo.count")
|
|
92
|
-
@state()
|
|
93
|
-
withoutReflect: number = 0;
|
|
94
|
-
|
|
95
|
-
render() {
|
|
96
|
-
return html`
|
|
97
|
-
<div class="mb-3">
|
|
98
|
-
from publisher : ${sub("bindReflectDemo.count") || 0} <br />
|
|
99
|
-
from component with reflect : ${this.withReflect || 0} <br />
|
|
100
|
-
from component without reflect : ${this.withoutReflect || 0}
|
|
101
|
-
</div>
|
|
102
|
-
<sonic-button @click=${() => this.withReflect++}
|
|
103
|
-
>Increment with reflect</sonic-button
|
|
104
|
-
>
|
|
105
|
-
<sonic-button @click=${() => this.withoutReflect++}
|
|
106
|
-
>Increment without reflect</sonic-button
|
|
107
|
-
>
|
|
108
|
-
`;
|
|
109
|
-
}
|
|
110
|
-
}
|
|
111
|
-
</code></pre>
|
|
112
|
-
<pre><code><docs-demo-sources for="demo-bind-reflect"></docs-demo-sources>
|
|
113
|
-
<demo-bind-reflect></demo-bind-reflect>
|
|
114
|
-
</code></pre>
|
|
115
|
-
<h2 id="path-syntax">Path syntax</h2>
|
|
116
|
-
<ul>
|
|
117
|
-
<li>First segment: data provider id.</li>
|
|
118
|
-
<li>Nested properties: dot notation.</li>
|
|
119
|
-
<li>Arrays: numeric index (<code>items.0</code>).</li>
|
|
120
|
-
</ul>
|
|
121
|
-
<h3 id="dynamic-paths">Dynamic paths</h3>
|
|
122
|
-
<p>Use <code>${prop}</code> or <code>${this.prop}</code> inside a <strong>normal string literal</strong> (not a JS template literal with backticks). <code>@bind</code> re-subscribes when a reactive dependency changes. While a placeholder is <code>null</code>/<code>undefined</code>, the bind is inactive; optional <code>{ skipEmptyPlaceholder: true }</code> also waits on <code>""</code>. See <a href="../_misc/dynamic-path.html#dynamic-path">Dynamic path placeholders</a>.</p>
|
|
123
|
-
<blockquote>
|
|
124
|
-
<p>Properties referenced in the pattern must be reactive (<code>@property</code>, etc.) or you must call <code>requestUpdate</code> manually.</p>
|
|
125
|
-
</blockquote>
|
|
126
|
-
<pre><code><docs-demo-sources for="demo-bind-dynamic"></docs-demo-sources>
|
|
127
|
-
<demo-bind-dynamic></demo-bind-dynamic>
|
|
128
|
-
</code></pre>
|
|
129
|
-
<h2 id="behavior">Behavior</h2>
|
|
130
|
-
<ul>
|
|
131
|
-
<li>Subscribes at <code>connectedCallback</code>, unsubscribes at <code>disconnectedCallback</code>.</li>
|
|
132
|
-
<li>If the path does not exist yet, a publisher may be created with <code>null</code>.</li>
|
|
133
|
-
</ul>
|
|
134
|
-
<h2 id="notes">Notes</h2>
|
|
135
|
-
<p>Works with any component that has the usual DOM lifecycle (<code>LitElement</code>, <code>Subscriber</code> mixin, etc.).</p>
|
|
136
|
-
<p>Shared data: <a href="../_getting-started/pubsub.html#pubsub">Sharing data</a>.</p>
|
|
137
|
-
|
|
138
|
-
</article>
|
|
139
|
-
</main>
|
|
140
|
-
</body>
|
|
141
|
-
</html>
|
|
@@ -1,149 +0,0 @@
|
|
|
1
|
-
<!DOCTYPE html>
|
|
2
|
-
<html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/docs/_decorators/get.html" data-doc-id="docs/_decorators/get">
|
|
3
|
-
<head>
|
|
4
|
-
<meta charset="UTF-8">
|
|
5
|
-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
6
|
-
<title>@get — Concorde</title>
|
|
7
|
-
<meta name="description" content="@get loads data and stores the result in an optional ApiResult<T> property.">
|
|
8
|
-
<meta name="keywords" content="Concorde, supersoniks, docs/_decorators/get, get, @get, decorator, ApiResult, undefined, payload.result, payload.response, payload.request,
|
|
9
|
-
|
|
10
|
-
The first argument is always an
|
|
11
|
-
[, serviceURL, refetch(component)">
|
|
12
|
-
<meta name="concorde-doc-id" content="docs/_decorators/get">
|
|
13
|
-
<link rel="canonical" href="https://concorde.supersoniks.org/crawl/docs/_decorators/get.html">
|
|
14
|
-
</head>
|
|
15
|
-
<body>
|
|
16
|
-
<header>
|
|
17
|
-
<p><a href="../../index.html">Concorde documentation (crawl)</a> · <a href="https://concorde.supersoniks.org/#docs/_decorators/get.md/get" rel="nofollow">interactive version</a></p>
|
|
18
|
-
</header>
|
|
19
|
-
<main>
|
|
20
|
-
<article>
|
|
21
|
-
<p class="doc-lead" id="doc-summary"><strong>Concorde decorator — @get</strong>. @get loads data and stores the result in an optional ApiResult<T> property. <span>Doc ID: <code>docs/_decorators/get</code>. Keywords: Concorde, supersoniks, docs/_decorators/get, get, @get, decorator, ApiResult, undefined, payload.result, payload.response, payload.request,
|
|
22
|
-
|
|
23
|
-
The first argument is always an
|
|
24
|
-
[, serviceURL, refetch(component). URL: <a href="https://concorde.supersoniks.org/crawl/docs/_decorators/get.html">https://concorde.supersoniks.org/crawl/docs/_decorators/get.html</a>.</span></p>
|
|
25
|
-
<h1 id="get">@get</h1>
|
|
26
|
-
<p><code>@get</code> loads data and stores the result in an optional <code>ApiResult<T></code> property.
|
|
27
|
-
The property is <code>undefined</code> until a result is available.</p>
|
|
28
|
-
<ul>
|
|
29
|
-
<li><code>payload.result</code>: typed data;</li>
|
|
30
|
-
<li><code>payload.response</code>: the HTTP response;</li>
|
|
31
|
-
<li><code>payload.request</code>: the request that was sent.</li>
|
|
32
|
-
</ul>
|
|
33
|
-
<h2 id="minimal-usage">Minimal usage</h2>
|
|
34
|
-
<pre><code class="language-typescript">const usersEndpoint = new Endpoint<User[]>("users");
|
|
35
|
-
|
|
36
|
-
@get(usersEndpoint)
|
|
37
|
-
@state()
|
|
38
|
-
payload?: ApiResult<User[]>;
|
|
39
|
-
</code></pre>
|
|
40
|
-
<p>The same decorator adapts to a method. The method receives the complete
|
|
41
|
-
<code>ApiResult<T></code> payload after each GET:</p>
|
|
42
|
-
<pre><code class="language-typescript">@get(usersEndpoint)
|
|
43
|
-
handleUsers(payload?: ApiResult<User[]>) {
|
|
44
|
-
if (!payload) return;
|
|
45
|
-
|
|
46
|
-
console.log(payload.response?.status);
|
|
47
|
-
console.log(payload.result);
|
|
48
|
-
}
|
|
49
|
-
</code></pre>
|
|
50
|
-
<p>The first argument is always an
|
|
51
|
-
<a href="../_misc/endpoint.html#endpoint"><code>Endpoint<T></code></a>. API configuration is read
|
|
52
|
-
from the HTML scope (<code>serviceURL</code>, token, etc.), so the component is usually
|
|
53
|
-
placed below an element that provides this configuration.</p>
|
|
54
|
-
<h2 id="refetching-a-get">Refetching a GET</h2>
|
|
55
|
-
<h3 id="from-the-component">From the component</h3>
|
|
56
|
-
<p>Keep the decorator in a constant to access <code>refetch(component)</code>. Refetch only
|
|
57
|
-
targets the instance passed as the argument, even before it has received a
|
|
58
|
-
result.</p>
|
|
59
|
-
<pre><code class="language-typescript">const usersGet = get(new Endpoint<User[]>("users"));
|
|
60
|
-
|
|
61
|
-
@usersGet
|
|
62
|
-
@state()
|
|
63
|
-
payload?: ApiResult<User[]>;
|
|
64
|
-
|
|
65
|
-
async refresh() {
|
|
66
|
-
const payload = await usersGet.refetch(this);
|
|
67
|
-
console.log(payload?.result);
|
|
68
|
-
}
|
|
69
|
-
</code></pre>
|
|
70
|
-
<p><code>refetch(component)</code> returns a <code>Promise<ApiResult<T> | undefined></code> that resolves
|
|
71
|
-
after the GET has completed.</p>
|
|
72
|
-
<p>The named handle can also decorate a method and be reused for refetching:</p>
|
|
73
|
-
<pre><code class="language-typescript">const usersGet = get(new Endpoint<User[]>("users"));
|
|
74
|
-
|
|
75
|
-
@usersGet
|
|
76
|
-
handleUsers(payload?: ApiResult<User[]>) {
|
|
77
|
-
// ...
|
|
78
|
-
}
|
|
79
|
-
|
|
80
|
-
@refetch(usersGet)
|
|
81
|
-
reloadUsers() {
|
|
82
|
-
// The GET runs and handleUsers receives its payload.
|
|
83
|
-
}
|
|
84
|
-
</code></pre>
|
|
85
|
-
<h3 id="from-a-method-decorator">From a method decorator</h3>
|
|
86
|
-
<p>The refetch can decorate a local method. The default is <code>after</code>; if the
|
|
87
|
-
method returns a Promise, the GET waits for its resolution. The decorated method
|
|
88
|
-
call also waits for the refetch to complete.</p>
|
|
89
|
-
<pre><code class="language-typescript">import { refetch } from "@supersoniks/concorde/decorators";
|
|
90
|
-
|
|
91
|
-
@refetch(usersGet)
|
|
92
|
-
async reload() {
|
|
93
|
-
this.userId = "42";
|
|
94
|
-
}
|
|
95
|
-
</code></pre>
|
|
96
|
-
<p>Use <code>{ when: "before" }</code> when the GET must complete before the method runs:</p>
|
|
97
|
-
<pre><code class="language-typescript">@refetch(usersGet, { when: "before" })
|
|
98
|
-
reloadBefore() {
|
|
99
|
-
// The refetch has completed before this method runs.
|
|
100
|
-
}
|
|
101
|
-
</code></pre>
|
|
102
|
-
<p>The method decorator adds an explicit trigger; changes to dynamic endpoint
|
|
103
|
-
properties and configuration publishers keep their existing automatic behavior.</p>
|
|
104
|
-
<h2 id="options-getoptions">Options (<code>GetOptions</code>)</h2>
|
|
105
|
-
<p>Options are the second argument, or the third argument when an API
|
|
106
|
-
configuration key is provided.</p>
|
|
107
|
-
<ul>
|
|
108
|
-
<li><code>skipEmptyPlaceholder</code>: blocks the GET when <code>${prop}</code> is <code>""</code>.</li>
|
|
109
|
-
<li><code>refetchEveryMs</code>: automatically runs the GET again after this interval
|
|
110
|
-
(milliseconds). Omit the option, or use <code>0</code>, to disable polling.</li>
|
|
111
|
-
<li><code>triggerKey</code>: a publisher whose <code>invalidate()</code> runs the GET again.</li>
|
|
112
|
-
</ul>
|
|
113
|
-
<p>With a configuration key, use:</p>
|
|
114
|
-
<pre><code class="language-typescript">@get(usersEndpoint, apiConfigurationKey)
|
|
115
|
-
</code></pre>
|
|
116
|
-
<h2 id="when-the-get-runs-again">When the GET runs again</h2>
|
|
117
|
-
<ul>
|
|
118
|
-
<li>when the component connects and configuration is available;</li>
|
|
119
|
-
<li>when a property used in <code>${...}</code> changes;</li>
|
|
120
|
-
<li>when a configuration publisher changes;</li>
|
|
121
|
-
<li>when the <code>triggerKey</code> publisher is invalidated;</li>
|
|
122
|
-
<li>after each response when <code>refetchEveryMs</code> is set.</li>
|
|
123
|
-
</ul>
|
|
124
|
-
<p>See <a href="../_misc/dynamic-path.html#dynamic-path">Dynamic path placeholders</a> for
|
|
125
|
-
dynamic path details.</p>
|
|
126
|
-
<h2 id="import">Import</h2>
|
|
127
|
-
<pre><code class="language-typescript">import { get, type ApiResult } from "@supersoniks/concorde/decorators";
|
|
128
|
-
import { DataProviderKey } from "@supersoniks/concorde/dataProviderKey";
|
|
129
|
-
import { Endpoint } from "@supersoniks/concorde/utils/endpoint";
|
|
130
|
-
</code></pre>
|
|
131
|
-
<h2 id="demos">Demos</h2>
|
|
132
|
-
<pre><code><docs-demo-sources for="demo-api-get"></docs-demo-sources>
|
|
133
|
-
<demo-api-get></demo-api-get>
|
|
134
|
-
<docs-demo-sources for="demo-api-get-method"></docs-demo-sources>
|
|
135
|
-
<demo-api-get-method></demo-api-get-method>
|
|
136
|
-
<docs-demo-sources for="demo-api-get-configuration-key"></docs-demo-sources>
|
|
137
|
-
<demo-api-get-configuration-key></demo-api-get-configuration-key>
|
|
138
|
-
</code></pre>
|
|
139
|
-
<p>See <a href="./post.html#post">@post</a>,
|
|
140
|
-
<a href="./put.html#put">@put</a>, and
|
|
141
|
-
<a href="./patch.html#patch">@patch</a> for write operations.</p>
|
|
142
|
-
<h2 id="advanced">Advanced</h2>
|
|
143
|
-
<p>External invalidation is currently available through <code>triggerKey</code>; it is kept
|
|
144
|
-
out of the main usage examples.</p>
|
|
145
|
-
|
|
146
|
-
</article>
|
|
147
|
-
</main>
|
|
148
|
-
</body>
|
|
149
|
-
</html>
|