npm - @supersoniks/concorde - Versions diffs - 4.9.1 → 4.9.2 - Mend

@supersoniks/concorde 4.9.1 → 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 (106) hide show

package/build-infos.json +1 -1
package/concorde-core.bundle.js +106 -106
package/concorde-core.es.js +4 -7
package/dist/concorde-core.bundle.js +106 -106
package/dist/concorde-core.es.js +4 -7
package/dist/docs-mock-api-sw.js +1 -0
package/dist/js/core/utils/HTML.js +4 -5
package/dist/js/core/utils/HTML.js.map +1 -1
package/dist/robots.txt +15 -1
package/dist/types/core/utils/HTML.d.ts.map +1 -1
package/docs/assets/{index-CZLTFws2.css → index-Bnp7gVaA.css} +1 -1
package/docs/assets/{index-nkkwC13U.js → index-hElUgV9_.js} +505 -438
package/docs/crawl/core/components/functional/date/date.html +190 -0
package/docs/crawl/core/components/functional/fetch/fetch.html +109 -0
package/docs/crawl/core/components/functional/if/if.html +27 -0
package/docs/crawl/core/components/functional/list/list.html +70 -0
package/docs/crawl/core/components/functional/mix/mix.html +45 -0
package/docs/crawl/core/components/functional/queue/queue.html +96 -0
package/docs/crawl/core/components/functional/router/router.html +106 -0
package/docs/crawl/core/components/functional/sdui/sdui.html +269 -0
package/docs/crawl/core/components/functional/states/states.html +66 -0
package/docs/crawl/core/components/functional/submit/submit.html +160 -0
package/docs/crawl/core/components/functional/subscriber/subscriber.html +67 -0
package/docs/crawl/core/components/functional/value/value.html +51 -0
package/docs/crawl/core/components/ui/alert/alert.html +110 -0
package/docs/crawl/core/components/ui/alert-messages/alert-messages.html +23 -0
package/docs/crawl/core/components/ui/badge/badge.html +119 -0
package/docs/crawl/core/components/ui/button/button.html +149 -0
package/docs/crawl/core/components/ui/captcha/captcha.html +30 -0
package/docs/crawl/core/components/ui/card/card.html +99 -0
package/docs/crawl/core/components/ui/divider/divider.html +58 -0
package/docs/crawl/core/components/ui/form/checkbox/checkbox.html +73 -0
package/docs/crawl/core/components/ui/form/fieldset/fieldset.html +135 -0
package/docs/crawl/core/components/ui/form/form-actions/form-actions.html +79 -0
package/docs/crawl/core/components/ui/form/form-layout/form-layout.html +62 -0
package/docs/crawl/core/components/ui/form/input/input.html +109 -0
package/docs/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html +106 -0
package/docs/crawl/core/components/ui/form/radio/radio.html +56 -0
package/docs/crawl/core/components/ui/form/select/select.html +73 -0
package/docs/crawl/core/components/ui/form/switch/switch.html +56 -0
package/docs/crawl/core/components/ui/form/textarea/textarea.html +59 -0
package/docs/crawl/core/components/ui/group/group.html +82 -0
package/docs/crawl/core/components/ui/icon/icon.html +133 -0
package/docs/crawl/core/components/ui/image/image.html +110 -0
package/docs/crawl/core/components/ui/link/link.html +42 -0
package/docs/crawl/core/components/ui/loader/loader.html +50 -0
package/docs/crawl/core/components/ui/menu/menu.html +322 -0
package/docs/crawl/core/components/ui/modal/modal.html +117 -0
package/docs/crawl/core/components/ui/pop/pop.html +102 -0
package/docs/crawl/core/components/ui/progress/progress.html +58 -0
package/docs/crawl/core/components/ui/table/table.html +413 -0
package/docs/crawl/core/components/ui/toast/toast.html +122 -0
package/docs/crawl/core/components/ui/tooltip/tooltip.html +79 -0
package/docs/crawl/docs/_core-concept/dataFlow.html +166 -0
package/docs/crawl/docs/_core-concept/overview.html +66 -0
package/docs/crawl/docs/_core-concept/subscriber.html +75 -0
package/docs/crawl/docs/_decorators/ancestor-attribute.html +116 -0
package/docs/crawl/docs/_decorators/auto-subscribe.html +202 -0
package/docs/crawl/docs/_decorators/bind.html +141 -0
package/docs/crawl/docs/_decorators/get.html +120 -0
package/docs/crawl/docs/_decorators/handle.html +165 -0
package/docs/crawl/docs/_decorators/on-assign.html +355 -0
package/docs/crawl/docs/_decorators/patch.html +52 -0
package/docs/crawl/docs/_decorators/post.html +102 -0
package/docs/crawl/docs/_decorators/publish.html +61 -0
package/docs/crawl/docs/_decorators/put.html +49 -0
package/docs/crawl/docs/_decorators/subscribe.html +109 -0
package/docs/crawl/docs/_decorators/wait-for-ancestors.html +137 -0
package/docs/crawl/docs/_directives/sub.html +93 -0
package/docs/crawl/docs/_getting-started/ai-agents.html +134 -0
package/docs/crawl/docs/_getting-started/concorde-manual-install.html +100 -0
package/docs/crawl/docs/_getting-started/concorde-outside.html +58 -0
package/docs/crawl/docs/_getting-started/create-a-component.html +111 -0
package/docs/crawl/docs/_getting-started/my-first-component.html +189 -0
package/docs/crawl/docs/_getting-started/my-first-subscriber.html +110 -0
package/docs/crawl/docs/_getting-started/pubsub.html +62 -0
package/docs/crawl/docs/_getting-started/start.html +76 -0
package/docs/crawl/docs/_getting-started/theming.html +85 -0
package/docs/crawl/docs/_misc/api-configuration.html +149 -0
package/docs/crawl/docs/_misc/dataProviderKey.html +135 -0
package/docs/crawl/docs/_misc/docs-mock-api.html +146 -0
package/docs/crawl/docs/_misc/dynamic-path.html +180 -0
package/docs/crawl/docs/_misc/endpoint.html +50 -0
package/docs/crawl/docs/_misc/html-integration.html +47 -0
package/docs/crawl/hubs/decorators.html +467 -0
package/docs/crawl/hubs/form-components.html +357 -0
package/docs/crawl/hubs/remote-data.html +374 -0
package/docs/crawl/index.html +99 -0
package/docs/docs-mock-api-sw.js +3 -1
package/docs/docs-mock-api-sw.js.map +2 -2
package/docs/index.html +3 -2
package/docs/llms-full.txt +5423 -0
package/docs/llms.txt +102 -0
package/docs/robots.txt +15 -1
package/docs/sitemap.xml +231 -0
package/docs/src/docs/_decorators/get.md +47 -1
package/docs/src/docs/search/docs-search.json +31 -1
package/index.html +1 -0
package/package.json +1 -1
package/public/docs-mock-api-sw.js +1 -0
package/public/robots.txt +15 -1
package/scripts/generate-crawl-docs.mjs +569 -0
package/scripts/post-build-docs.js +18 -14
package/src/core/decorators/subscriber/ancestorAttribute.spec.ts +42 -0
package/src/core/utils/HTML.ts +4 -5
package/src/docs/search/docs-search.json +61 -1

package/docs/crawl/hubs/decorators.html ADDED Viewed

@@ -0,0 +1,467 @@
+<!DOCTYPE html>
+<html lang="fr" data-crawl-url="https://concorde.supersoniks.org/crawl/hubs/decorators.html" data-doc-id="hubs/decorators">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Concorde decorators reference — Concorde</title>
+  <meta name="description" content="Hub for all Concorde Lit decorators: @get @post @put @patch @subscribe @publish @bind @handle and related. Use this page when asking about any decorator.">
+  <meta name="keywords" content="decorator, @get, @post, @put, @patch, @subscribe, @publish, @bind, @handle, ApiResult, Endpoint, DataProviderKey">
+  <meta name="concorde-doc-id" content="hubs/decorators">
+  <link rel="canonical" href="https://concorde.supersoniks.org/crawl/hubs/decorators.html">
+</head>
+<body>
+  <header>
+    <p><a href="../index.html">Concorde documentation (crawl)</a></p>
+  </header>
+  <main>
+    <article>
+      <p class="doc-lead" id="doc-summary"><strong>Concorde documentation — Concorde decorators reference</strong>. Hub for all Concorde Lit decorators: @get @post @put @patch @subscribe @publish @bind @handle and related. Use this page when asking about any decorator. <span>Doc ID: <code>hubs/decorators</code>. Keywords: decorator, @get, @post, @put, @patch, @subscribe, @publish, @bind, @handle, ApiResult, Endpoint, DataProviderKey. URL: <a href="https://concorde.supersoniks.org/crawl/hubs/decorators.html">https://concorde.supersoniks.org/crawl/hubs/decorators.html</a>.</span></p>
+      <section id="docs-_decorators-ancestor-attribute" data-doc-id="docs/_decorators/ancestor-attribute">
+  <h2><a href="../docs/_decorators/ancestor-attribute.html">@ancestorAttribute</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/ancestor-attribute</code> · <a href="../docs/_decorators/ancestor-attribute.html">full page</a></p>
+  <p>The @ancestorAttribute decorator automatically injects the value of an ancestor's attribute into a class property at the time of connectedCallback.</p>
+  <pre class="doc-excerpt">@ancestorAttribute
+The @ancestorAttribute decorator automatically injects the value of an ancestor's attribute into a class property at the time of connectedCallback.
+Principle
+This decorator uses HTML.getAncestorAttributeValue to traverse up the DOM tree from the current element and find the first ancestor that has the specified attribute. The value of this attribute is then assigned to the decorated property.
+Usage
+Import
+import { ancestorAttribute } from &quot;@supersoniks/concorde/decorators&quot;;
+Basic example
+The component reads dataProvider and testAttribute from its ancestor wrapper. By default (dynamic: false), values are read once at connect.
+import { html, LitElement } from &quot;lit&quot;;
+import { customElement } from &quot;lit/decorators.js&quot;;
+import { ancestorAttribute } from &quot;@supersoniks/concorde/decorators&quot;;
+@customElement(&quot;demo-ancestor-attribute&quot;)
+export class DemoAncestorAttribute extends LitElement {
+  @ancestorAttribute(&quot;dataProvider&quot;)
+  dataProvider: string | null = null;
+  @ancestorAttribute(&quot;testAttribute&quot;)
+  testAttribute: string | null = null;
+  render() {
+    return html
+       dataProvider:  ${this.dataProvider ?? &quot;null&quot;}
+       testAttribute:  ${this.testAttribute</pre>
+</section>
+<section id="docs-_decorators-auto-subscribe" data-doc-id="docs/_decorators/auto-subscribe">
+  <h2><a href="../docs/_decorators/auto-subscribe.html">@autoSubscribe</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/auto-subscribe</code> · <a href="../docs/_decorators/auto-subscribe.html">full page</a></p>
+  <p>&gt; Legacy: prefer @subscribe + DataProviderKey. Examples below may still show PublisherManager for existing codebases.</p>
+  <pre class="doc-excerpt">@autoSubscribe
+&gt; Legacy: prefer @subscribe + DataProviderKey. Examples below may still show PublisherManager for existing codebases.
+The @autoSubscribe 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.
+Principle
+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.
+Usage
+Import
+import { autoSubscribe } from &quot;@supersoniks/concorde/decorators&quot;;
+Basic example
+@customElement(&quot;demo-auto-subscribe&quot;)
+export class DemoAutoSubscribe extends LitElement {
+  static styles = [tailwind];
+  @state() displayText: string = &quot;&quot;;
+  @state() computedValue: number = 0;
+  @autoSubscribe()
+  updateDisplay() {
+    const value1 = PublisherManager.get(&quot;autoValue1&quot;).get() || 0;
+    const value2 = PublisherManager.get(&quot;autoValue2&quot;).get() || 0;
+    this.computedValue = value1 + value2;
+    this.displayText = ${value1} + ${value2} = ${this.computedValue};
+  }
+ </pre>
+</section>
+<section id="docs-_decorators-bind" data-doc-id="docs/_decorators/bind">
+  <h2><a href="../docs/_decorators/bind.html">@bind</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/bind</code> · <a href="../docs/_decorators/bind.html">full page</a></p>
+  <p>Binds a class property to a path in a publisher. The property updates when publisher data changes.</p>
+  <pre class="doc-excerpt">@bind
+Binds a class property to a path in a publisher. The property updates when publisher data changes.
+For Lit re-renders, also add @state() on the same property.
+See also: @subscribe, @handle, @publish, @get, @post, @put, @patch.
+Principle
+The decorator subscribes to the DataProvider store using dot notation or a DataProviderKey. Updates flow into the decorated property (Data flow).
+Import
+import { bind } from &quot;@supersoniks/concorde/decorators&quot;;
+Example
+@customElement(&quot;demo-bind&quot;)
+export class DemoBind extends LitElement {
+  static styles = [tailwind];
+  @bind(&quot;demoData.firstName&quot;)
+  @state()
+  firstName = &quot;&quot;;
+  @bind(&quot;demoData.lastName&quot;)
+  @state()
+  lastName: string = &quot;&quot;;
+  @bind(&quot;demoData.count&quot;)
+  @state()
+  count: number = 0;
+  render() {
+    return //......
+  }
+  updateData() {
+    set(demoDataKey, { ...get(demoDataKey), count: get(demoDataKey).count + 1 });
+    // see demo-bind in src/docs/example/decorators-demo-bind-demos.ts
+    const randomIndex = Math.floor(Math.random()  demoUsers.get().length);
+    const randomUser = demoUsers.get()[randomIndex];
+    demoData.set({
+      firstName: randomUser.firstName,
+      lastName: randomUser.lastName,
+      count:</pre>
+</section>
+<section id="docs-_decorators-get" data-doc-id="docs/_decorators/get">
+  <h2><a href="../docs/_decorators/get.html">@get</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/get</code> · <a href="../docs/_decorators/get.html">full page</a></p>
+  <p>Loads data through API.getDetailed. The decorated property is ApiResult&lt;T&gt; | null: request, response (or null for dataProvider(...) resolution without HTTP), and typed result.</p>
+  <pre class="doc-excerpt">@get
+Loads data through API.getDetailed. The decorated property is ApiResult  | null: request, response (or null for dataProvider(...) resolution without HTTP), and typed result.
+Pass an Endpoint  as the first argument. Import get and ApiResult from @supersoniks/concorde/decorators, and Endpoint from @supersoniks/concorde/utils/endpoint.
+Configuration
+- Default: HTML.getApiConfiguration(host) (ancestor serviceURL, etc.).
+- Second argument: DataProviderKey  — config is read from the publisher at the resolved path; internal mutations trigger another GET. See API configuration for mock demos.
+Dynamic path
+${prop} on the endpoint or config key is resolved on the host. While a placeholder is null or undefined, no GET runs. Optional skipEmptyPlaceholder: true also blocks &quot;&quot; (empty string only). Details: Dynamic path placeholders.
+Options (GetOptions)
+Pass as the second argument (scoped config) or third (with a configuration key). Same shape as send decorators where applicable:
+| Option | Description |
+|--------|-------------|
+| skipEmptyPlaceholder | Treat &quot;&quot; as not ready (see Dynamic path). |
+| refetchEveryMs | Automatic polling interval (ms). 0 or omitted = no polling. |
+| tri</pre>
+</section>
+<section id="docs-_decorators-handle" data-doc-id="docs/_decorators/handle">
+  <h2><a href="../docs/_decorators/handle.html">@handle</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/handle</code> · <a href="../docs/_decorators/handle.html">full page</a></p>
+  <p>Typed callback on one or more DataProviderKey&lt;T&gt; paths: invokes the decorated method when a publisher assigns a value (calculations, side effects, updating other @state properties, etc.).</p>
+  <pre class="doc-excerpt">@handle
+Typed callback on one or more DataProviderKey  paths: invokes the decorated method when a publisher assigns a value (calculations, side effects, updating other @state properties, etc.).
+Unlike @subscribe, nothing is bound to the decorated member — only your method runs. @handle is typed and accepts up to 3 keys plus an optional trailing HandleOptions object. It supersedes the string-based @onAssign.
+By default the method is called on every assignment, even when the value is null / undefined. Use the options below to restrict that.
+Import
+import { handle, Skip } from &quot;@supersoniks/concorde/decorators&quot;;
+import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
+import { get, set } from &quot;@supersoniks/concorde/utils&quot;;
+Basic example
+type DemoCounterData = { count: number };
+const demoDataKey = new DataProviderKey&amp;lt;DemoCounterData&amp;gt;(&quot;demoData&quot;);
+@customElement(&quot;demo-handle&quot;)
+export class DemoHandle extends LitElement {
+  @state() doubled = 0;
+  @state() lastUpdate = &quot;&quot;;
+  @handle(demoDataKey.count)
+  onCountChange(count: number) {
+    this.doubled = count  2;
+    this.lastUpdate = new Date().toLocaleTimeString();
+  }
+  incrementCount() {
+    const data</pre>
+</section>
+<section id="docs-_decorators-on-assign" data-doc-id="docs/_decorators/on-assign">
+  <h2><a href="../docs/_decorators/on-assign.html">@onAssign</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/on-assign</code> · <a href="../docs/_decorators/on-assign.html">full page</a></p>
+  <p>&gt; New apps: use @handle with DataProviderKey (Data flow). @onAssign uses untyped string paths; it remains documented for existing codebases — see Migrating to @handle below.</p>
+  <pre class="doc-excerpt">@onAssign
+&gt; New apps: use @handle with DataProviderKey (Data flow). @onAssign uses untyped string paths; it remains documented for existing codebases — see Migrating to @handle below.
+The @onAssign decorator allows you to execute a method when one or more publishers are updated. The method is called only when all specified publishers have been assigned values.
+For a typed equivalent (recommended), use @handle.
+Principle
+This decorator subscribes to one or more publishers by string path (legacy). When all specified publishers have been assigned values (via set), the decorated method is called with all the values as arguments. Prefer @handle + DataProviderKey and get / set from Data flow.
+This is particularly useful when you need to wait for multiple data sources to be ready before executing logic.
+Usage
+Import
+import { onAssign } from &quot;@supersoniks/concorde/decorators&quot;;
+Basic example
+//...
+@customElement(&quot;demo-on-assign&quot;)
+export class DemoOnAssign extends LitElement {
+  static styles = [tailwind];
+  @state() userWithSettings: any = null;
+  @state() isReady: boolean = false;
+  @state() lastUpdate: string = &quot;&quot;;
+  @onAssign(&quot;demoUser&quot;, &quot;demoUserSettings&quot;)
+  handleDataReady</pre>
+</section>
+<section id="docs-_decorators-patch" data-doc-id="docs/_decorators/patch">
+  <h2><a href="../docs/_decorators/patch.html">@patch</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/patch</code> · <a href="../docs/_decorators/patch.html">full page</a></p>
+  <p>Sends data through API.patchDetailed. Same model as @post: decorated property is ApiResult&lt;T&gt; | null (request, response, result).</p>
+  <pre class="doc-excerpt">@patch
+Sends data through API.patchDetailed. Same model as @post: decorated property is ApiResult  | null (request, response, result).
+Pass an Endpoint  and a DataProviderKey for the request body. Import patch and ApiResult from @supersoniks/concorde/decorators.
+Configuration
+Same as @post / @get: scoped HTML.getApiConfiguration(host) or DataProviderKey  as third argument.
+Options (PatchOptions)
+Same shape as PostOptions on @post (ApiSendOptions): refetchEveryMs, skipIfBodyMissing, autoPostOnBodyMutation, triggerKey, skipEmptyPlaceholder. See Dynamic path placeholders for ${sessionId} and empty-string behaviour.
+Import
+import { patch, type ApiResult } from &quot;@supersoniks/concorde/decorators&quot;;
+import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
+import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
+Example
+const patchBodyKey = new DataProviderKey&amp;lt;Partial&amp;lt;Resource&amp;gt;&amp;gt;(&quot;resourcePatch&quot;);
+@patch(
+  new Endpoint&amp;lt;Resource, { resourceId: string }&amp;gt;(&quot;resources/${resourceId}&quot;),
+  patchBodyKey,
+  { skipEmptyPlaceholder: true },
+)
+@state()
+payload?: ApiResult&amp;lt;Resource&amp;gt; | null;
+See also
+- @post — POST (live demos)
+- @put — full rep</pre>
+</section>
+<section id="docs-_decorators-post" data-doc-id="docs/_decorators/post">
+  <h2><a href="../docs/_decorators/post.html">@post</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/post</code> · <a href="../docs/_decorators/post.html">full page</a></p>
+  <p>Sends data through API.postDetailed. The decorated property is ApiResult&lt;T&gt; | null: request, response, and typed result.</p>
+  <pre class="doc-excerpt">@post
+Sends data through API.postDetailed. The decorated property is ApiResult  | null: request, response, and typed result.
+Pass an Endpoint  as the first argument and a DataProviderKey for the request body as the second. Import post and ApiResult from @supersoniks/concorde/decorators, and Endpoint from @supersoniks/concorde/utils/endpoint.
+Configuration
+Same as @get: scoped HTML.getApiConfiguration(host) by default, or DataProviderKey  as third argument. See API configuration for mock demos.
+Optional PostOptions (third or fourth argument)
+| Option | Description |
+|--------|-------------|
+| refetchEveryMs | Re-post on an interval (ms). |
+| skipIfBodyMissing | Skip when body publisher is null/undefined (default: true). |
+| autoPostOnBodyMutation | Re-post when the body publisher mutates (default: true). false = manual via triggerKey.invalidate(). |
+| skipEmptyPlaceholder | If true, a placeholder resolved to '' blocks the request (empty string only — not 0 or false). See Dynamic paths. |
+| triggerKey | DataProviderKey — invalidate() re-runs the POST with the current body. |
+When the POST runs again
+- Body publisher onInternalMutation when autoPostOnBodyMutation is true (defa</pre>
+</section>
+<section id="docs-_decorators-publish" data-doc-id="docs/_decorators/publish">
+  <h2><a href="../docs/_decorators/publish.html">@publish</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/publish</code> · <a href="../docs/_decorators/publish.html">full page</a></p>
+  <p>Write-only binding: assigning to the property publishes to the DataProviderKey path. No read subscription (inverse of @subscribe).</p>
+  <pre class="doc-excerpt">@publish
+Write-only binding: assigning to the property publishes to the DataProviderKey path. No read subscription (inverse of @subscribe).
+Similar to the “reflect” half of @bind without listening to the publisher.
+Import
+import { publish } from &quot;@supersoniks/concorde/decorators&quot;;
+import { sub } from &quot;@supersoniks/concorde/directives&quot;;
+import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
+Example
+type PublishDemoData = { email: string; message: string };
+const publishDemoKey = new DataProviderKey (&quot;publishDemo&quot;);
+//
+@customElement(&quot;demo-publish&quot;)
+export class DemoPublish extends LitElement {
+  @publish(publishDemoKey.email)
+  @state()
+  email = &quot;&quot;;
+  //
+  @publish(publishDemoKey.message)
+  @state()
+  message = &quot;&quot;;
+  //
+  render() {
+    return html
+        (this.email = (e.target as HTMLInputElement).value)}
+        label=&quot;Email&quot;
+      &gt;
+       ${sub(publishDemoKey.email)}
+    ;
+  }
+}
+Dynamic paths use the same placeholder rules as @bind / @subscribe. Resolution and skipEmptyPlaceholder: Dynamic path placeholders.</pre>
+</section>
+<section id="docs-_decorators-put" data-doc-id="docs/_decorators/put">
+  <h2><a href="../docs/_decorators/put.html">@put</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/put</code> · <a href="../docs/_decorators/put.html">full page</a></p>
+  <p>Sends data through API.putDetailed. Same model as @post: decorated property is ApiResult&lt;T&gt; | null (request, response, result).</p>
+  <pre class="doc-excerpt">@put
+Sends data through API.putDetailed. Same model as @post: decorated property is ApiResult  | null (request, response, result).
+Pass an Endpoint  and a DataProviderKey for the request body. Import put and ApiResult from @supersoniks/concorde/decorators.
+Configuration
+Same as @post / @get: scoped HTML.getApiConfiguration(host) or DataProviderKey  as third argument.
+Options (PutOptions)
+Same shape as PostOptions on @post (ApiSendOptions): refetchEveryMs, skipIfBodyMissing, autoPostOnBodyMutation, triggerKey, skipEmptyPlaceholder. See Dynamic path placeholders for ${sessionId} and empty-string behaviour.
+Import
+import { put, type ApiResult } from &quot;@supersoniks/concorde/decorators&quot;;
+import { Endpoint } from &quot;@supersoniks/concorde/utils/endpoint&quot;;
+import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
+Example
+const bodyKey = new DataProviderKey&amp;lt;UpdatePayload&amp;gt;(&quot;resourceBody&quot;);
+@put(new Endpoint&amp;lt;Resource, { resourceId: string }&amp;gt;(&quot;resources/${resourceId}&quot;), bodyKey)
+@state()
+payload?: ApiResult&amp;lt;Resource&amp;gt; | null;
+Changing resourceId on the host re-runs the PUT when the path becomes ready — see Dynamic path placeholders.
+See also
+- @post —</pre>
+</section>
+<section id="docs-_decorators-subscribe" data-doc-id="docs/_decorators/subscribe">
+  <h2><a href="../docs/_decorators/subscribe.html">@subscribe</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/subscribe</code> · <a href="../docs/_decorators/subscribe.html">full page</a></p>
+  <p>Keeps a Lit property in sync with a read-only slice of the DataProvider store. You pass a DataProviderKey; when that path changes, the property updates and the component re-renders.</p>
+  <pre class="doc-excerpt">@subscribe
+Keeps a Lit property in sync with a read-only slice of the DataProvider store. You pass a DataProviderKey; when that path changes, the property updates and the component re-renders.
+Typical setup (same idea as My first component):
+| Piece | Role |
+|-------|------|
+| Type T | Shape of the object at that path (DocsUserData, { count: number }, …) |
+| Key | DataProviderKey  — static path (&quot;cart&quot;) or dynamic (&quot;users.${userIndex}&quot;, &quot;${dataProvider}&quot;) |
+| Scope on the host | Properties listed in U (e.g. dataProvider, userIndex) — often filled via @ancestorAttribute |
+| @subscribe(key) | Mirrors the store into @state() (or another property); read-only from the component side |
+For writing back to the store from component state, use @publish. In templates, the same paths work with sub().
+Import
+import { subscribe } from &quot;@supersoniks/concorde/decorators&quot;;
+import { DataProviderKey } from &quot;@supersoniks/concorde/dataProviderKey&quot;;
+type Data = { count: number };
+const dataKey = new DataProviderKey&amp;lt;Data&amp;gt;(&quot;data&quot;);
+@subscribe(dataKey.count)
+@state()
+count = 0;
+Static path
+The key path is fixed. The property type must match T at that segment.
+const cartKey = new DataProvi</pre>
+</section>
+<section id="docs-_decorators-wait-for-ancestors" data-doc-id="docs/_decorators/wait-for-ancestors">
+  <h2><a href="../docs/_decorators/wait-for-ancestors.html">@awaitConnectedAncestors and @dispatchConnectedEvent</a></h2>
+  <p><strong>Doc ID:</strong> <code>docs/_decorators/wait-for-ancestors</code> · <a href="../docs/_decorators/wait-for-ancestors.html">full page</a></p>
+  <p>The @awaitConnectedAncestors and @dispatchConnectedEvent decorators delay a web component's initialization until its matching ancestors have executed their connectedCallback. This is when contextual e</p>
+  <pre class="doc-excerpt">@awaitConnectedAncestors and @dispatchConnectedEvent
+The @awaitConnectedAncestors and @dispatchConnectedEvent decorators delay a web component's initialization until its matching ancestors have executed their connectedCallback. This is when contextual elements (publisher, dataProvider, etc.) are configured.
+Principle
+When a child component attaches to the DOM, its ancestors may not yet be initialized (especially if custom element definitions are loaded asynchronously). The @awaitConnectedAncestors decorator delays the component's connectedCallback until all ancestors matching the provided CSS selectors have executed their connectedCallback.
+The @dispatchConnectedEvent decorator allows ancestors to signal they are ready by dispatching the sonic-connected event at the end of their connectedCallback. The event bubbles, so it can be listened to from anywhere (e.g. document.addEventListener(CONNECTED, handler)).
+Ancestors that are not web components (no hyphen in tag name) are considered connected by default and do not need to emit the event.
+Usage
+Import
+import { awaitConnectedAncestors, dispatchConnectedEvent, ancestorAttribute } from &quot;@supersoniks/concorde/decorators&quot;;
+Basic</pre>
+</section>
+    </article>
+  </main>
+</body>
+</html>