@supersoniks/concorde 4.9.0 → 4.9.2

package/docs/llms.txt

@@ -0,0 +1,102 @@
+# Concorde
+
+> Web components framework (Lit, DataProvider, decorators).
+
+Documentation for AI indexers lives under `/crawl/` as **HTML** (`.html`), not Markdown.
+Example: https://concorde.supersoniks.org/crawl/docs/_decorators/post.html
+Do not fetch `/crawl/**/*.md` (does not exist) nor `/src/docs/**/*.md` (SPA source only).
+
+Full text: https://concorde.supersoniks.org/llms-full.txt
+
+## Topic hubs (start here for RAG)
+
+- [Concorde decorators reference](https://concorde.supersoniks.org/crawl/hubs/decorators.html) (hubs/decorators, 12 pages)
+- [Fetching remote data in Concorde](https://concorde.supersoniks.org/crawl/hubs/remote-data.html) (hubs/remote-data, 11 pages)
+- [Concorde form components](https://concorde.supersoniks.org/crawl/hubs/form-components.html) (hubs/form-components, 10 pages)
+
+## Docs
+
+- [Date](https://concorde.supersoniks.org/crawl/core/components/functional/date/date.html) (core/components/functional/date/date): Nothing is displayed.
+- [Fetch](https://concorde.supersoniks.org/crawl/core/components/functional/fetch/fetch.html) (core/components/functional/fetch/fetch): > New apps: prefer @get for a typed GET on a component, or List / Queue with fetch for collections. Use Local API demos (serviceURL="/docs-mock-api") to try examples offline.
+- [if](https://concorde.supersoniks.org/crawl/core/components/functional/if/if.html) (core/components/functional/if/if): The sonic-if component shows its slot when .condition is true. In Lit, bind .condition from store-driven state (@subscribe on a formDataProvider field) — live preview and TypeScript source are the sam
+- [List](https://concorde.supersoniks.org/crawl/core/components/functional/list/list.html) (core/components/functional/list/list): > Try offline: serviceURL="/docs-mock-api" and dataProvider="api/users" with key="data" — see Local API demos. Recommended patterns: Data flow.
+- [Mix](https://concorde.supersoniks.org/crawl/core/components/functional/mix/mix.html) (core/components/functional/mix/mix): Mix allows you to mix several subsets of dataProvider in a new key/value structure which is itself associated with a new dataProvider. The data update is then bidirectional.
+- [Queue](https://concorde.supersoniks.org/crawl/core/components/functional/queue/queue.html) (core/components/functional/queue/queue): > Try offline: serviceURL="/docs-mock-api" — see Local API demos. Row rendering: Data flow (.items property binding).
+- [Router](https://concorde.supersoniks.org/crawl/core/components/functional/router/router.html) (core/components/functional/router/router): sonic-router watches document.location (pathname + hash) and renders the matching view.
+- [SDUI](https://concorde.supersoniks.org/crawl/core/components/functional/sdui/sdui.html) (core/components/functional/sdui/sdui): SDUI stands for Server Driven User Interfaces.
+- [States](https://concorde.supersoniks.org/crawl/core/components/functional/states/states.html) (core/components/functional/states/states): * It loops over its child templates and tests if the regexp contained in the *data-value* attribute matches the value of the property
+- [Submit](https://concorde.supersoniks.org/crawl/core/components/functional/submit/submit.html) (core/components/functional/submit/submit): > Live demos: <docs-lit-demo> + src/docs/example/docs-submit-demos.ts. Use Local API demos (serviceURL="/docs-mock-api").
+- [Subscriber](https://concorde.supersoniks.org/crawl/core/components/functional/subscriber/subscriber.html) (core/components/functional/subscriber/subscriber): La mixin Subscriber permet lier un composant à un publisher.
+- [Value](https://concorde.supersoniks.org/crawl/core/components/functional/value/value.html) (core/components/functional/value/value): Simply shows a value from a data provider.
+- [Concorde](https://concorde.supersoniks.org/crawl/core/components/ui/alert-messages/alert-messages.html) (core/components/ui/alert-messages/alert-messages): Concorde documentation: Concorde
+- [Alert](https://concorde.supersoniks.org/crawl/core/components/ui/alert/alert.html) (core/components/ui/alert/alert): This address is already in use. Lorem ipsum dolor sit amet.
+- [Badge](https://concorde.supersoniks.org/crawl/core/components/ui/badge/badge.html) (core/components/ui/badge/badge): Messages <sonic-badge slot="suffix" type="danger" size="xs">5</sonic-badge>
+- [Button](https://concorde.supersoniks.org/crawl/core/components/ui/button/button.html) (core/components/ui/button/button): The length of the button depends on the size of its content
+- [Captcha](https://concorde.supersoniks.org/crawl/core/components/ui/captcha/captcha.html) (core/components/ui/captcha/captcha): Captcha: Submit with captcha
+- [Card](https://concorde.supersoniks.org/crawl/core/components/ui/card/card.html) (core/components/ui/card/card): Suffix
+- [Divider](https://concorde.supersoniks.org/crawl/core/components/ui/divider/divider.html) (core/components/ui/divider/divider): Default
+
+Align
+
+Size
+
+Custom
+
+  Lorem ipsum dolor sit amet  +25
+- [Checkbox](https://concorde.supersoniks.org/crawl/core/components/ui/form/checkbox/checkbox.html) (core/components/ui/form/checkbox/checkbox): >Already checked checkbox
+- [Fieldset](https://concorde.supersoniks.org/crawl/core/components/ui/form/fieldset/fieldset.html) (core/components/ui/form/fieldset/fieldset): Default
+- [Form-actions](https://concorde.supersoniks.org/crawl/core/components/ui/form/form-actions/form-actions.html) (core/components/ui/form/form-actions/form-actions): Left seats
+- [Form-layout](https://concorde.supersoniks.org/crawl/core/components/ui/form/form-layout/form-layout.html) (core/components/ui/form/form-layout/form-layout): autocomplete="email"
+- [Input-autocomplete](https://concorde.supersoniks.org/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html) (core/components/ui/form/input-autocomplete/input-autocomplete): The input-autocomplete component brings input and queue together in order to create a suggest behavior. This is why this component is partially configured as a form input and as a queue.
+- [Input](https://concorde.supersoniks.org/crawl/core/components/ui/form/input/input.html) (core/components/ui/form/input/input): Native attibutes list
+- [Radio](https://concorde.supersoniks.org/crawl/core/components/ui/form/radio/radio.html) (core/components/ui/form/radio/radio): >Already checked radio
+- [Select](https://concorde.supersoniks.org/crawl/core/components/ui/form/select/select.html) (core/components/ui/form/select/select): {"value":"dark", "wording":"dark (set by \"attribute\")", "selected" : "true"}, {"value":"auto", "wording":"auto"}
+- [Switch](https://concorde.supersoniks.org/crawl/core/components/ui/form/switch/switch.html) (core/components/ui/form/switch/switch): >Already checked switch
+- [Textarea](https://concorde.supersoniks.org/crawl/core/components/ui/form/textarea/textarea.html) (core/components/ui/form/textarea/textarea): Native attibutes list
+- [Group](https://concorde.supersoniks.org/crawl/core/components/ui/group/group.html) (core/components/ui/group/group): Group: 😎 Standard ⭐ Premium 💎 Diamond
+- [Icon](https://concorde.supersoniks.org/crawl/core/components/ui/icon/icon.html) (core/components/ui/icon/icon): customIconDefaultPrefix="regular">
+- [Image](https://concorde.supersoniks.org/crawl/core/components/ui/image/image.html) (core/components/ui/image/image): src="https://thegoodlife.fr/wp-content/uploads/sites/2/2022/03/compagnies-aeriennes-nostalgie-coeur-insert-03-dr.jpg"
+- [Link](https://concorde.supersoniks.org/crawl/core/components/ui/link/link.html) (core/components/ui/link/link): Link: Basic link with href attibute
+- [Loader](https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html) (core/components/ui/loader/loader): import {Loader} from "@supersoniks/concorde/core/components/ui/loader/loader";
+- [Menu](https://concorde.supersoniks.org/crawl/core/components/ui/menu/menu.html) (core/components/ui/menu/menu): Row
+- [Concorde](https://concorde.supersoniks.org/crawl/core/components/ui/modal/modal.html) (core/components/ui/modal/modal): Concorde: Simple modal Lorem ipsum dolor sit amet +33 Donec sed vestibulum augue. Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed eget quam eu mi luctus faucibus. Click don't close Confir
+- [Pop](https://concorde.supersoniks.org/crawl/core/components/ui/pop/pop.html) (core/components/ui/pop/pop): Click to open pop
+- [Progress bar](https://concorde.supersoniks.org/crawl/core/components/ui/progress/progress.html) (core/components/ui/progress/progress): Displays an indicator showing the completion progress of a task.
+- [Table](https://concorde.supersoniks.org/crawl/core/components/ui/table/table.html) (core/components/ui/table/table): Values available : primary, info, success, warning, danger
+- [Toast](https://concorde.supersoniks.org/crawl/core/components/ui/toast/toast.html) (core/components/ui/toast/toast): Afficher un toast
+- [Tooltip](https://concorde.supersoniks.org/crawl/core/components/ui/tooltip/tooltip.html) (core/components/ui/tooltip/tooltip): By default, tooltip is centered next to its content
+- [Data flow](https://concorde.supersoniks.org/crawl/docs/_core-concept/dataFlow.html) (docs/_core-concept/dataFlow): Recommended patterns for new Concorde apps (Lit + TypeScript). Under the hood, data lives in a DataProvider store (legacy Publisher API: Legacy: Sharing data).
+- [lit + tailwind + vite](https://concorde.supersoniks.org/crawl/docs/_core-concept/overview.html) (docs/_core-concept/overview): Some notes for an overview of Concorde's functioning
+- [Legacy: Subscriber mixin](https://concorde.supersoniks.org/crawl/docs/_core-concept/subscriber.html) (docs/_core-concept/subscriber): > New app components: My first component and Data flow — extend LitElement with decorators (@subscribe, @ancestorAttribute, …). This mixin remains in core components (sonic-list, sonic-fetch, …) and l
+- [@ancestorAttribute](https://concorde.supersoniks.org/crawl/docs/_decorators/ancestor-attribute.html) (docs/_decorators/ancestor-attribute): The @ancestorAttribute decorator automatically injects the value of an ancestor's attribute into a class property at the time of connectedCallback.
+- [@autoSubscribe](https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html) (docs/_decorators/auto-subscribe): > Legacy: prefer @subscribe + DataProviderKey. Examples below may still show PublisherManager for existing codebases.
+- [@bind](https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html) (docs/_decorators/bind): Binds a class property to a path in a publisher. The property updates when publisher data changes.
+- [@get](https://concorde.supersoniks.org/crawl/docs/_decorators/get.html) (docs/_decorators/get): Loads data through API.getDetailed. The decorated property is ApiResult<T> | null: request, response (or null for dataProvider(...) resolution without HTTP), and typed result.
+- [@handle](https://concorde.supersoniks.org/crawl/docs/_decorators/handle.html) (docs/_decorators/handle): Typed callback on one or more DataProviderKey<T> paths: invokes the decorated method when a publisher assigns a value (calculations, side effects, updating other @state properties, etc.).
+- [@onAssign](https://concorde.supersoniks.org/crawl/docs/_decorators/on-assign.html) (docs/_decorators/on-assign): > New apps: use @handle with DataProviderKey (Data flow). @onAssign uses untyped string paths; it remains documented for existing codebases — see Migrating to @handle below.
+- [@patch](https://concorde.supersoniks.org/crawl/docs/_decorators/patch.html) (docs/_decorators/patch): Sends data through API.patchDetailed. Same model as @post: decorated property is ApiResult<T> | null (request, response, result).
+- [@post](https://concorde.supersoniks.org/crawl/docs/_decorators/post.html) (docs/_decorators/post): Sends data through API.postDetailed. The decorated property is ApiResult<T> | null: request, response, and typed result.
+- [@publish](https://concorde.supersoniks.org/crawl/docs/_decorators/publish.html) (docs/_decorators/publish): Write-only binding: assigning to the property publishes to the DataProviderKey path. No read subscription (inverse of @subscribe).
+- [@put](https://concorde.supersoniks.org/crawl/docs/_decorators/put.html) (docs/_decorators/put): Sends data through API.putDetailed. Same model as @post: decorated property is ApiResult<T> | null (request, response, result).
+- [@subscribe](https://concorde.supersoniks.org/crawl/docs/_decorators/subscribe.html) (docs/_decorators/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.
+- [@awaitConnectedAncestors and @dispatchConnectedEvent](https://concorde.supersoniks.org/crawl/docs/_decorators/wait-for-ancestors.html) (docs/_decorators/wait-for-ancestors): The @awaitConnectedAncestors and @dispatchConnectedEvent decorators delay a web component's initialization until its matching ancestors have executed their connectedCallback. This is when contextual e
+- [sub()](https://concorde.supersoniks.org/crawl/docs/_directives/sub.html) (docs/_directives/sub): Read-only Lit directive: displays the current DataProvider value and updates whenever it is assigned.
+- [AI agents (skills & AGENTS.md)](https://concorde.supersoniks.org/crawl/docs/_getting-started/ai-agents.html) (docs/_getting-started/ai-agents): Concorde ships skills, rules, and a root AGENTS.md so Cursor, JetBrains AI Assistant, and other coding agents follow framework patterns (DataProvider, decorators, short imports, scope, theme, migratio
+- [Manual installation (Vite)](https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-manual-install.html) (docs/_getting-started/concorde-manual-install): > Legacy — for brownfield apps or custom stacks. New projects should use the starter.
+- [Installation](https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-outside.html) (docs/_getting-started/concorde-outside): The following command creates a new Vite project in TypeScript mode with Tailwind and an example component to get started.
+- [Creating components](https://concorde.supersoniks.org/crawl/docs/_getting-started/create-a-component.html) (docs/_getting-started/create-a-component): > New app components: start with My first component and Data flow. The Subscriber mixin below is legacy.
+- [My first component](https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-component.html) (docs/_getting-started/my-first-component): Build a Lit user card with Tailwind and Concorde UI, then connect it to the DataProvider store: declare the data configuration (type, key, scope), and let @subscribe keep the card in sync.
+- [Legacy: My first subscriber component](https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-subscriber.html) (docs/_getting-started/my-first-subscriber): > New projects: use My first component (@ancestorAttribute, @subscribe + DataProviderKey, .items on lists) and Data flow. This page documents the Subscriber mixin used by older apps and core component
+- [Legacy: Sharing data](https://concorde.supersoniks.org/crawl/docs/_getting-started/pubsub.html) (docs/_getting-started/pubsub): > New apps: Data flow (get / set / DataProviderKey, decorators). This page documents the historical Publisher proxy API (PublisherManager, publisher.set, onAssign, …).
+- [Introduction](https://concorde.supersoniks.org/crawl/docs/_getting-started/start.html) (docs/_getting-started/start): Based on lit.dev, Concorde is a collection of web components for shared apps and websites.
+- [Adding styles](https://concorde.supersoniks.org/crawl/docs/_getting-started/theming.html) (docs/_getting-started/theming): No style crosses the shadow root of a component, except for inheritable properties (which have the "inherit" property possible) and CSS variables.
+- [API configuration](https://concorde.supersoniks.org/crawl/docs/_misc/api-configuration.html) (docs/_misc/api-configuration): APIConfiguration is the object built by HTML.getApiConfiguration from ancestor attributes on the DOM (or from a typed publisher — see @get / @post configuration key). It is passed to API by fetchers, 
+- [DataProviderKey](https://concorde.supersoniks.org/crawl/docs/_misc/dataProviderKey.html) (docs/_misc/dataProviderKey): The DataProviderKey<T> utility provides type-safe navigation through composite data structures. Each property or index access extends the path, and the final key can be retrieved via toString() or the
+- [Local API demos (offline)](https://concorde.supersoniks.org/crawl/docs/_misc/docs-mock-api.html) (docs/_misc/docs-mock-api): The Concorde doc site does not call fragile third-party APIs during yarn dev. A Service Worker and the Vite dev middleware serve /docs-mock-api/* on the same origin.
+- [Dynamic path placeholders](https://concorde.supersoniks.org/crawl/docs/_misc/dynamic-path.html) (docs/_misc/dynamic-path): Decorators and DataProviderKey paths can include placeholders resolved on the host component at runtime:
+- [Endpoint](https://concorde.supersoniks.org/crawl/docs/_misc/endpoint.html) (docs/_misc/endpoint): Endpoint<T, U> describes a single HTTP path (or a path accepted by API.get) and carries the expected response type T. Unlike DataProviderKey, there is no dot-navigation: the path is one string.
+- [HTML integration (no Lit)](https://concorde.supersoniks.org/crawl/docs/_misc/html-integration.html) (docs/_misc/html-integration): 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
+
+## Optional
+
+- [Full index](https://concorde.supersoniks.org/crawl/index.html)

package/docs/robots.txt

@@ -1,2 +1,16 @@
-User-agent: *
+# Block major search engines (SPA uses noindex as well).
+User-agent: Googlebot
+Disallow: /
+
+User-agent: Bingbot
 Disallow: /
+
+# Crawlers: index /crawl/*.html only; /src/docs/*.md is for the interactive SPA runtime.
+User-agent: *
+Allow: /crawl/
+Allow: /sitemap.xml
+Allow: /llms.txt
+Allow: /llms-full.txt
+Disallow: /src/docs/
+
+Sitemap: https://concorde.supersoniks.org/sitemap.xml

package/docs/sitemap.xml

@@ -0,0 +1,231 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/index.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/hubs/decorators.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/hubs/remote-data.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/hubs/form-components.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/date/date.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/fetch/fetch.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/if/if.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/list/list.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/mix/mix.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/queue/queue.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/router/router.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/sdui/sdui.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/states/states.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/submit/submit.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/subscriber/subscriber.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/functional/value/value.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/alert-messages/alert-messages.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/alert/alert.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/badge/badge.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/button/button.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/captcha/captcha.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/card/card.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/divider/divider.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/checkbox/checkbox.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/fieldset/fieldset.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/form-actions/form-actions.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/form-layout/form-layout.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/input-autocomplete/input-autocomplete.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/input/input.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/radio/radio.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/select/select.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/switch/switch.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/form/textarea/textarea.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/group/group.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/icon/icon.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/image/image.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/link/link.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/loader/loader.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/menu/menu.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/modal/modal.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/pop/pop.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/progress/progress.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/table/table.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/toast/toast.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/core/components/ui/tooltip/tooltip.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_core-concept/dataFlow.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_core-concept/overview.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_core-concept/subscriber.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/ancestor-attribute.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/auto-subscribe.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/bind.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/get.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/handle.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/on-assign.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/patch.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/post.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/publish.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/put.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/subscribe.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_decorators/wait-for-ancestors.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_directives/sub.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/ai-agents.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-manual-install.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/concorde-outside.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/create-a-component.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-component.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/my-first-subscriber.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/pubsub.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/start.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_getting-started/theming.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/api-configuration.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/dataProviderKey.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/docs-mock-api.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/dynamic-path.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/endpoint.html</loc>
+  </url>
+  <url>
+    <loc>https://concorde.supersoniks.org/crawl/docs/_misc/html-integration.html</loc>
+  </url>
+</urlset>

package/docs/src/docs/_decorators/ancestor-attribute.md

@@ -18,7 +18,7 @@ import { ancestorAttribute } from "@supersoniks/concorde/decorators";
 
 ### Basic example
 
-The component reads `dataProvider` and `testAttribute` from its ancestor wrapper.
+The component reads `dataProvider` and `testAttribute` from its ancestor wrapper. By default (`dynamic: false`), values are read once at connect.
 
 <sonic-code language="typescript">
   <template>
@@ -36,10 +36,8 @@ export class DemoAncestorAttribute extends LitElement {
 
   render() {
     return html`
-      <section>
-        <p>dataProvider: <strong>${this.dataProvider || "null"}</strong></p>
-        <p>testAttribute: <strong>${this.testAttribute || "null"}</strong></p>
-      </section>
+      <p>dataProvider: <strong>${this.dataProvider ?? "null"}</strong></p>
+      <p>testAttribute: <strong>${this.testAttribute ?? "null"}</strong></p>
     `;
   }
 }
@@ -55,7 +53,6 @@ export class DemoAncestorAttribute extends LitElement {
   </template>
 </sonic-code>
 
-
 ## Use cases
 
 This decorator is particularly useful for:
@@ -68,9 +65,60 @@ This decorator is particularly useful for:
 ## Behavior
 
 - The search starts from the current element and traverses up the DOM tree
-- If the attribute is not found, the property will be assigned `null`
 - The injection happens automatically at the time of `connectedCallback`
-- The value is not reactive: it is only updated once when the element is connected to the DOM
+- By default (`dynamic: false`), the value is read once at connect time and is not updated afterward
+- With `{ dynamic: true }`, the property stays in sync when:
+  - an ancestor **changes** the attribute value
+  - a **closer** ancestor **gains** the attribute (that value wins)
+  - the **nearest** ancestor **loses** the attribute (falls back to the next one up, or `null`)
+- When `dynamic` is enabled, updates also propagate to `@subscribe` / `@bind` paths that depend on the decorated property (e.g. `${dataProvider}`)
+
+### Dynamic mode
+
+Use `{ dynamic: true }` when the decorated property must follow the DOM. With Lit, add **`@state()`** on the same property so template updates are visible when the observer assigns a new value.
+
+The live demo below shows only the resolved attribute value — no store, no reparenting.
+
+<sonic-code language="typescript">
+  <template>
+@customElement("demo-ancestor-attribute-dynamic")
+export class DemoAncestorAttributeDynamic extends LitElement {
+  @ancestorAttribute("dataProvider", { dynamic: true })
+  @state()
+  dataProvider: string | null = null;
+
+  render() {
+    return html`
+      &lt;p&gt;Nearest ancestor: &lt;strong&gt;${this.dataProvider ?? "null"}&lt;/strong&gt;&lt;/p&gt;
+    `;
+  }
+}
+  </template>
+</sonic-code>
+
+Try in the demo:
+
+- **parent-a** / **parent-b** — change the value on the direct parent
+- **Remove parent attr** — falls back to **outer**
+- **Add closer** — a wrapper with `from-closer` becomes the nearest ancestor
+- **Remove closer** — back to parent or outer
+- **Remove outer attr** — if parent has no attribute either, the child shows `null`
+
+<sonic-code>
+  <template>
+    <docs-demo-sources for="demo-ancestor-attribute-dynamic-section"></docs-demo-sources>
+    <demo-ancestor-attribute-dynamic-section></demo-ancestor-attribute-dynamic-section>
+  </template>
+</sonic-code>
+
+Static mode (default) — read once at connect, no observer:
+
+<sonic-code language="typescript">
+  <template>
+@ancestorAttribute("dataProvider")
+dataProvider: string | null = null;
+  </template>
+</sonic-code>
 
 ## Notes
 

package/docs/src/docs/_decorators/get.md

@@ -13,10 +13,53 @@ Pass an [`Endpoint<T>`](#docs/_misc/endpoint.md/endpoint) as the first argument.
 
 `${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 `""` (empty string only). Details: [Dynamic path placeholders](#docs/_misc/dynamic-path.md/dynamic-path).
 
+## 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 `""` as not ready (see [Dynamic path](#docs/_misc/dynamic-path.md/dynamic-path)). |
+| `refetchEveryMs` | Automatic polling interval (ms). `0` or omitted = no polling. |
+| `triggerKey` | `DataProviderKey` — `PublisherManager.get(...).invalidate()` on that publisher re-runs the GET. |
+
+### Manual refetch (`triggerKey`)
+
+Same pattern as [@post](#docs/_decorators/post.md/post): a publisher acts as a **signal**, independent of the response payload.
+
+```typescript
+import { get, type ApiResult } from "@supersoniks/concorde/decorators";
+import { Endpoint } from "@supersoniks/concorde/utils/endpoint";
+import { DataProviderKey } from "@supersoniks/concorde/dataProviderKey";
+import { dp } from "@supersoniks/concorde/core/utils/PublisherProxy";
+
+const geoCommunesEndpoint = new Endpoint<GeoCommuneRow[]>(
+  "communes?limit=5&fields=nom,code",
+);
+const geoCommunesRefreshKey = new DataProviderKey<void>(
+  "docsDemoGeoCommunesRefresh",
+);
+
+@get(geoCommunesEndpoint, apiConfigurationKey, {
+  triggerKey: geoCommunesRefreshKey,
+})
+@state()
+payload: ApiResult<GeoCommuneRow[]> | null = null;
+
+// Same component or anywhere else:
+dp(geoCommunesRefreshKey).invalidate();
+```
+
+Prefer `triggerKey` over mutating the API configuration publisher when you only want to **reload the same URL** — no need to touch `serviceURL`, tokens, etc.
+
+The docs mock adds an **`X-Fetched-At`** response header on `/docs-mock-api/geo/communes` so live demos can show when the last fetch happened (`response.headers.get("X-Fetched-At")`).
+
 ## When the GET runs again
 
 - A referenced Lit property changes (endpoint path and/or config key contains `${...}`).
 - `set` on the active configuration publisher (`onInternalMutation`).
+- `triggerKey` publisher `invalidate()`.
+- `refetchEveryMs` polling (after each successful fetch).
 
 ## Import
 
@@ -42,6 +85,8 @@ payload: ApiResult<User> | null = null;
 
 ## Live demos
 
+`@get` with **`triggerKey`** — refresh button + `X-Fetched-At` timestamp in the UI:
+
 <sonic-code>
   <template>
     <docs-demo-sources for="demo-api-get"></docs-demo-sources>
@@ -49,12 +94,13 @@ payload: ApiResult<User> | null = null;
   </template>
 </sonic-code>
 
-Dynamic config and endpoint path (`demo-api-get-configuration-key` in doc sources):
+Dynamic config and endpoint path. Manual refetch is triggered **from a separate component** (same `triggerKey` publisher):
 
 <sonic-code>
   <template>
     <docs-demo-sources for="demo-api-get-configuration-key"></docs-demo-sources>
     <demo-api-get-configuration-key></demo-api-get-configuration-key>
+    <demo-api-get-refresh-remote></demo-api-get-refresh-remote>
   </template>
 </sonic-code>