@supersoniks/concorde 4.9.0 → 4.9.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (123) hide show
  1. package/build-infos.json +1 -1
  2. package/concorde-core.bundle.js +195 -195
  3. package/concorde-core.es.js +3390 -3370
  4. package/dist/concorde-core.bundle.js +195 -195
  5. package/dist/concorde-core.es.js +3390 -3370
  6. package/dist/docs-mock-api-sw.js +3 -1
  7. package/dist/docs-mock-api-sw.js.map +2 -2
  8. package/dist/js/core/decorators/api.js +64 -12
  9. package/dist/js/core/decorators/api.js.map +1 -1
  10. package/dist/js/core/utils/HTML.js +4 -5
  11. package/dist/js/core/utils/HTML.js.map +1 -1
  12. package/dist/robots.txt +15 -1
  13. package/dist/types/core/decorators/api.d.ts +14 -1
  14. package/dist/types/core/decorators/api.d.ts.map +1 -1
  15. package/dist/types/core/utils/HTML.d.ts.map +1 -1
  16. package/docs/assets/{index-t0-i22oI.css → index-Bnp7gVaA.css} +1 -1
  17. package/docs/assets/{index-BEgZEIbv.js → index-hElUgV9_.js} +894 -552
  18. package/docs/crawl/core/components/functional/date/date.html +190 -0
  19. package/docs/crawl/core/components/functional/fetch/fetch.html +109 -0
  20. package/docs/crawl/core/components/functional/if/if.html +27 -0
  21. package/docs/crawl/core/components/functional/list/list.html +70 -0
  22. package/docs/crawl/core/components/functional/mix/mix.html +45 -0
  23. package/docs/crawl/core/components/functional/queue/queue.html +96 -0
  24. package/docs/crawl/core/components/functional/router/router.html +106 -0
  25. package/docs/crawl/core/components/functional/sdui/sdui.html +269 -0
  26. package/docs/crawl/core/components/functional/states/states.html +66 -0
  27. package/docs/crawl/core/components/functional/submit/submit.html +160 -0
  28. package/docs/crawl/core/components/functional/subscriber/subscriber.html +67 -0
  29. package/docs/crawl/core/components/functional/value/value.html +51 -0
  30. package/docs/crawl/core/components/ui/alert/alert.html +110 -0
  31. package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +23 -0
  32. package/docs/crawl/core/components/ui/badge/badge.html +119 -0
  33. package/docs/crawl/core/components/ui/button/button.html +149 -0
  34. package/docs/crawl/core/components/ui/captcha/captcha.html +30 -0
  35. package/docs/crawl/core/components/ui/card/card.html +99 -0
  36. package/docs/crawl/core/components/ui/divider/divider.html +58 -0
  37. package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +73 -0
  38. package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +135 -0
  39. package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +79 -0
  40. package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +62 -0
  41. package/docs/crawl/core/components/ui/form/input/input.html +109 -0
  42. package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +106 -0
  43. package/docs/crawl/core/components/ui/form/radio/radio.html +56 -0
  44. package/docs/crawl/core/components/ui/form/select/select.html +73 -0
  45. package/docs/crawl/core/components/ui/form/switch/switch.html +56 -0
  46. package/docs/crawl/core/components/ui/form/textarea/textarea.html +59 -0
  47. package/docs/crawl/core/components/ui/group/group.html +82 -0
  48. package/docs/crawl/core/components/ui/icon/icon.html +133 -0
  49. package/docs/crawl/core/components/ui/image/image.html +110 -0
  50. package/docs/crawl/core/components/ui/link/link.html +42 -0
  51. package/docs/crawl/core/components/ui/loader/loader.html +50 -0
  52. package/docs/crawl/core/components/ui/menu/menu.html +322 -0
  53. package/docs/crawl/core/components/ui/modal/modal.html +117 -0
  54. package/docs/crawl/core/components/ui/pop/pop.html +102 -0
  55. package/docs/crawl/core/components/ui/progress/progress.html +58 -0
  56. package/docs/crawl/core/components/ui/table/table.html +413 -0
  57. package/docs/crawl/core/components/ui/toast/toast.html +122 -0
  58. package/docs/crawl/core/components/ui/tooltip/tooltip.html +79 -0
  59. package/docs/crawl/docs/_core-concept/dataFlow.html +166 -0
  60. package/docs/crawl/docs/_core-concept/overview.html +66 -0
  61. package/docs/crawl/docs/_core-concept/subscriber.html +75 -0
  62. package/docs/crawl/docs/_decorators/ancestor-attribute.html +116 -0
  63. package/docs/crawl/docs/_decorators/auto-subscribe.html +202 -0
  64. package/docs/crawl/docs/_decorators/bind.html +141 -0
  65. package/docs/crawl/docs/_decorators/get.html +120 -0
  66. package/docs/crawl/docs/_decorators/handle.html +165 -0
  67. package/docs/crawl/docs/_decorators/on-assign.html +355 -0
  68. package/docs/crawl/docs/_decorators/patch.html +52 -0
  69. package/docs/crawl/docs/_decorators/post.html +102 -0
  70. package/docs/crawl/docs/_decorators/publish.html +61 -0
  71. package/docs/crawl/docs/_decorators/put.html +49 -0
  72. package/docs/crawl/docs/_decorators/subscribe.html +109 -0
  73. package/docs/crawl/docs/_decorators/wait-for-ancestors.html +137 -0
  74. package/docs/crawl/docs/_directives/sub.html +93 -0
  75. package/docs/crawl/docs/_getting-started/ai-agents.html +134 -0
  76. package/docs/crawl/docs/_getting-started/concorde-manual-install.html +100 -0
  77. package/docs/crawl/docs/_getting-started/concorde-outside.html +58 -0
  78. package/docs/crawl/docs/_getting-started/create-a-component.html +111 -0
  79. package/docs/crawl/docs/_getting-started/my-first-component.html +189 -0
  80. package/docs/crawl/docs/_getting-started/my-first-subscriber.html +110 -0
  81. package/docs/crawl/docs/_getting-started/pubsub.html +62 -0
  82. package/docs/crawl/docs/_getting-started/start.html +76 -0
  83. package/docs/crawl/docs/_getting-started/theming.html +85 -0
  84. package/docs/crawl/docs/_misc/api-configuration.html +149 -0
  85. package/docs/crawl/docs/_misc/dataProviderKey.html +135 -0
  86. package/docs/crawl/docs/_misc/docs-mock-api.html +146 -0
  87. package/docs/crawl/docs/_misc/dynamic-path.html +180 -0
  88. package/docs/crawl/docs/_misc/endpoint.html +50 -0
  89. package/docs/crawl/docs/_misc/html-integration.html +47 -0
  90. package/docs/crawl/hubs/decorators.html +467 -0
  91. package/docs/crawl/hubs/form-components.html +357 -0
  92. package/docs/crawl/hubs/remote-data.html +374 -0
  93. package/docs/crawl/index.html +99 -0
  94. package/docs/docs-mock-api-sw.js +3 -1
  95. package/docs/docs-mock-api-sw.js.map +2 -2
  96. package/docs/index.html +3 -3
  97. package/docs/llms-full.txt +5423 -0
  98. package/docs/llms.txt +102 -0
  99. package/docs/robots.txt +15 -1
  100. package/docs/sitemap.xml +231 -0
  101. package/docs/src/docs/_decorators/ancestor-attribute.md +56 -8
  102. package/docs/src/docs/_decorators/get.md +47 -1
  103. package/docs/src/docs/search/docs-search.json +92 -2
  104. package/docs/src/tsconfig.declarations.json +22 -0
  105. package/docs/src/tsconfig.emit.json +23 -0
  106. package/docs/src/tsconfig.json +3 -285
  107. package/index.html +1 -0
  108. package/package.json +1 -1
  109. package/public/docs-mock-api-sw.js +3 -1
  110. package/public/docs-mock-api-sw.js.map +2 -2
  111. package/public/robots.txt +15 -1
  112. package/scripts/generate-crawl-docs.mjs +569 -0
  113. package/scripts/post-build-docs.js +18 -14
  114. package/src/core/decorators/api.spec.ts +74 -4
  115. package/src/core/decorators/api.ts +103 -20
  116. package/src/core/decorators/subscriber/ancestorAttribute.spec.ts +42 -0
  117. package/src/core/utils/HTML.ts +4 -5
  118. package/src/docs/_decorators/get.md +47 -1
  119. package/src/docs/components/docs-demo-sources.ts +7 -2
  120. package/src/docs/example/decorators-demo-geo.ts +5 -0
  121. package/src/docs/example/decorators-demo-subscribe-publish-get-demos.ts +72 -31
  122. package/src/docs/mock-api/router.ts +3 -1
  123. package/src/docs/search/docs-search.json +92 -2
package/docs/crawl/docs/_misc/dynamic-path.html ADDED
@@ -0,0 +1,180 @@
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}, &quot;users/${userId}&quot;, &quot;api/sessions/${sessionId}/sync&quot;, &quot;teams.${teamId}.members&quot;, 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}, &quot;users/${userId}&quot;, &quot;api/sessions/${sessionId}/sync&quot;, &quot;teams.${teamId}.members&quot;, 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>&quot;users/${userId}&quot;</code>, <code>&quot;api/sessions/${sessionId}/sync&quot;</code></li>
23
+ <li>Nested expressions — e.g. <code>&quot;teams.${teamId}.members&quot;</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>&quot;&quot;</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>&quot;0&quot;</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>&quot;false&quot;</code></td>
64
+ <td></td>
65
+ </tr>
66
+ <tr>
67
+ <td><code>42</code>, <code>&quot;alpha&quot;</code></td>
68
+ <td><strong>yes</strong></td>
69
+ <td><code>&quot;42&quot;</code>, <code>&quot;alpha&quot;</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>&quot;&quot;</code>. Opt in per decorator:</p>
77
+ <pre><code class="language-typescript">@get(new Endpoint&lt;User, { userId: string }&gt;(&quot;users/${userId}&quot;), {
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>&#39;&#39;</code> on a placeholder</td>
91
+ </tr>
92
+ <tr>
93
+ <td>Default <code>false</code></td>
94
+ <td><code>&quot;&quot;</code> is inserted into the path (legacy behaviour)</td>
95
+ </tr>
96
+ <tr>
97
+ <td><code>true</code></td>
98
+ <td><code>&quot;&quot;</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>&quot;${dataProvider}&quot;</code> scope pattern</li>
175
+ </ul>
176
+
177
+ </article>
178
+ </main>
179
+ </body>
180
+ </html>
package/docs/crawl/docs/_misc/endpoint.html ADDED
@@ -0,0 +1,50 @@
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&lt;T, U&gt; 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, &quot;&quot;, 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&lt;T, U&gt; 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, &quot;&quot;, 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&lt;T, U&gt;</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>&quot;&quot;</code> / <code>0</code> and <code>skipEmptyPlaceholder</code>.</p>
22
+ <h2 id="import">Import</h2>
23
+ <pre><code class="language-typescript">import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
24
+ </code></pre>
25
+ <h2 id="construction">Construction</h2>
26
+ <pre><code class="language-typescript">const users = new Endpoint&amp;lt;User[]&amp;gt;(&quot;users?limit=10&quot;);
27
+ users.path; // &quot;users?limit=10&quot;
28
+
29
+ const one = new Endpoint&amp;lt;User, { userId: string }&amp;gt;(&quot;users/${userId}&quot;);
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>
package/docs/crawl/docs/_misc/html-integration.html ADDED
@@ -0,0 +1,47 @@
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, src/docs/example/, , src/docs/example/*.ts, @subscribe">
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, src/docs/example/, , src/docs/example/*.ts, @subscribe. 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>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>&lt;docs-joke-search-demo&gt;</code>.</p>
22
+ <table>
23
+ <thead>
24
+ <tr>
25
+ <th>Goal</th>
26
+ <th>Use</th>
27
+ </tr>
28
+ </thead>
29
+ <tbody><tr>
30
+ <td>Learn modern patterns</td>
31
+ <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>
32
+ </tr>
33
+ <tr>
34
+ <td>Author doc examples</td>
35
+ <td><code>&lt;docs-lit-demo&gt;</code> + <code>src/docs/example/*.ts</code> — see <a href="../_getting-started/my-first-component.html#my-first-component">My first component</a></td>
36
+ </tr>
37
+ <tr>
38
+ <td>Embed in plain HTML only</td>
39
+ <td><code>data-bind</code> / Subscriber docs in <strong>Legacy</strong> — <a href="../_core-concept/subscriber.html#subscriber">Subscriber mixin</a></td>
40
+ </tr>
41
+ </tbody></table>
42
+ <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>
43
+
44
+ </article>
45
+ </main>
46
+ </body>
47
+ </html>