@supersoniks/concorde 5.1.2 → 5.1.3

package/docs/hubs/remote-data.html

@@ -53,10 +53,10 @@ When the response type starts w</pre>
 <section id="core-components-functional-list-list" data-doc-id="core/components/functional/list/list">
   <h2><a href="/core/components/functional/list">List</a></h2>
   <p><strong>Doc ID:</strong> <code>core/components/functional/list/list</code> · <a href="/core/components/functional/list">full page</a></p>
-  <p>sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. From Lit, pass a row renderer on the items property; in plain HTML, declare &lt;template&gt; children. Each</p>
+  <p>sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. In TypeScript, prefer the .items row renderer (with .separator · .noItems · .skeleton); &lt;template&gt; ch</p>
   <pre class="doc-excerpt">List
 
-sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. From Lit, pass a row renderer on the items property; in plain HTML, declare   children. Each row gets its own data provider at  /list-item/ .
+sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. In TypeScript, prefer the .items row renderer (with .separator · .noItems · .skeleton);   children are for plain HTML hosts without Lit. Each row gets its own data provider at  /list-item/ .
 
 Basic example
 
@@ -64,7 +64,7 @@ Add fetch to load props from serviceURL + endPoint (or dataProvider when endPoin
 
          $time  $code from $city ($airport)&quot;&gt;
 
-Fetch attributes (lazyload · refetchEveryMs · headers · authentication) are shared with Fetch.
+This example uses HTML templates; from Lit, use the row renderer instead. Fetch attributes (lazyload · refetchEveryMs · headers · authentication) are shared with Fetch.
 
 Row renderer
 
@@ -72,11 +72,7 @@ From a Lit component, set .items to a function (item, metadata) =&gt; TemplateRe
 
 Row variants
 
-In HTML, templateKey (default template) names the row field that selects a  . Rows without a match cycle through the   children that have no data-value. From Lit, branch inside the items callback instead.
-
-Separator and empty list
-
-.separator renders between rows (not after the last one). .noItems</pre>
+In HTML, templateKey (default template) names the row field that selects a  . Rows without a match cycle through the   children that have no data-value. From Lit, branch insid</pre>
 </section>
 <section id="core-components-functional-queue-queue" data-doc-id="core/components/functional/queue/queue">
   <h2><a href="/core/components/functional/queue">Queue</a></h2>
@@ -274,7 +270,7 @@ Quick map
 | Derived / aggregate (JSONata) | derive() or sonic-jsonata — Jsonata |
 | Offline doc demos | serviceURL=&quot;/docs-mock-api&quot; — Local API demos |
 
-Skill: concorde-get-set-dp in the package ai/ folder.
+Agent skill: concorde (rules/data.md), see AI agents.
 
 DataProviderKey
 

package/docs/index.html

@@ -16,6 +16,94 @@
     <link rel="canonical" href="https://concorde.supersoniks.org/" />
     <link rel="alternate" type="text/markdown" href="/index.md" title="Markdown" />
     <link rel="alternate" type="text/plain" href="/llms.txt" title="llms.txt" />
+    <meta property="og:type" content="website" />
+    <meta property="og:site_name" content="Concorde by Supersoniks" />
+    <meta property="og:title" content="Concorde by Supersoniks — Web components for every stack" />
+    <meta property="og:description" content="Open-source Lit web components framework: UI, data binding, forms and themes for React, Vue, PHP or plain HTML." />
+    <meta property="og:url" content="https://concorde.supersoniks.org/" />
+    <meta property="og:image" content="https://concorde.supersoniks.org/img/og-concorde.jpg" />
+    <meta property="og:image:width" content="1200" />
+    <meta property="og:image:height" content="630" />
+    <meta property="og:image:alt" content="Five Concorde aircraft parked nose to nose, black and white photo" />
+    <meta name="twitter:card" content="summary_large_image" />
+    <script type="application/ld+json">
+      {
+        "@context": "https://schema.org",
+        "@graph": [
+          {
+            "@type": "WebSite",
+            "@id": "https://concorde.supersoniks.org/#website",
+            "name": "Concorde",
+            "alternateName": "Concorde by Supersoniks",
+            "url": "https://concorde.supersoniks.org/",
+            "inLanguage": "en",
+            "publisher": {
+              "@id": "https://supersoniks.com/#organization"
+            }
+          },
+          {
+            "@type": "SoftwareApplication",
+            "@id": "https://concorde.supersoniks.org/#software",
+            "name": "Concorde",
+            "alternateName": "@supersoniks/concorde",
+            "description": "Concorde is an open-source web components framework built on Lit: UI components, data binding, forms, routing helpers and theming that work in React, Vue, PHP or plain HTML.",
+            "url": "https://concorde.supersoniks.org/",
+            "applicationCategory": "DeveloperApplication",
+            "applicationSubCategory": "Web components framework",
+            "operatingSystem": "Any (web browser)",
+            "programmingLanguage": "TypeScript",
+            "license": "https://opensource.org/licenses/MIT",
+            "downloadUrl": "https://www.npmjs.com/package/@supersoniks/concorde",
+            "softwareHelp": "https://concorde.supersoniks.org/docs/getting-started/start",
+            "image": "https://concorde.supersoniks.org/img/og-concorde.jpg",
+            "offers": {
+              "@type": "Offer",
+              "price": "0",
+              "priceCurrency": "EUR"
+            },
+            "author": {
+              "@id": "https://supersoniks.com/#organization"
+            },
+            "publisher": {
+              "@id": "https://supersoniks.com/#organization"
+            },
+            "sameAs": [
+              "https://www.npmjs.com/package/@supersoniks/concorde"
+            ]
+          },
+          {
+            "@type": "Organization",
+            "@id": "https://supersoniks.com/#organization",
+            "name": "Supersoniks",
+            "legalName": "SUPERSONIKS",
+            "url": "https://supersoniks.com/",
+            "telephone": "+33 2 47 68 93 25",
+            "address": {
+              "@type": "PostalAddress",
+              "streetAddress": "22 rue du Docteur Bretonneau",
+              "postalCode": "37000",
+              "addressLocality": "Tours",
+              "addressCountry": "FR"
+            },
+            "contactPoint": {
+              "@type": "ContactPoint",
+              "contactType": "customer service",
+              "telephone": "+33 2 47 68 93 25",
+              "url": "https://supersoniks.com/un-projet",
+              "availableLanguage": [
+                "fr",
+                "en"
+              ]
+            },
+            "sameAs": [
+              "https://www.linkedin.com/company/supersoniks/",
+              "https://www.facebook.com/supersoniks",
+              "https://www.instagram.com/agencesupersoniks/"
+            ]
+          }
+        ]
+      }
+    </script>
     <link rel="preconnect" href="https://fonts.googleapis.com" />
     <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
     <link
@@ -35,8 +123,8 @@
         display: none !important;
       }
     </style>
-    <script type="module" crossorigin src="/assets/index-BgG6FFPt.js"></script>
-    <link rel="stylesheet" crossorigin href="/assets/index-x89XINSG.css">
+    <script type="module" crossorigin src="/assets/index-6sS76xWj.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DkdPbH0F.css">
   </head>
   <body class="px-4 sm:px-6 lg:px-10 2xl:px-20">
     <!--
@@ -78,6 +166,7 @@
         wire components to a shared DataProvider without framework lock-in.
         Concorde is MIT-licensed and maintained by Supersoniks for production
         stacks that need one component set across many hosts.
+        <a href="/about">About</a> · <a href="/privacy">Privacy</a>
       </p>
     </section>
 

package/docs/index.md

@@ -12,11 +12,11 @@ Install the npm package [`@supersoniks/concorde`](https://www.npmjs.com/package/
 - Docs index: https://concorde.supersoniks.org/docs/index.html
 - Sitemap: https://concorde.supersoniks.org/sitemap.xml
 - Getting started: https://concorde.supersoniks.org/docs/getting-started/start
-- AI agents (skills): https://concorde.supersoniks.org/docs/getting-started/ai-agents
+- AI agents (skill): https://concorde.supersoniks.org/docs/getting-started/ai-agents
 - Components: https://concorde.supersoniks.org/docs/getting-started/components
 
 Doc pages share pathnames with the interactive site (`/docs/…`, `/core/…`). Markdown is at the same path with a `.md` suffix (e.g. `/docs/getting-started/start.md`), or via `Accept: text/markdown` on the pathname (`Content-Type: text/markdown`, `Vary: Accept`).
 
 ## What Concorde includes
 
-Custom elements (`sonic-*`) for buttons, forms, lists, queues, SDUI trees and more. Decorators such as `@get`, `@post`, `@subscribe` and `@bind` wire components to a shared DataProvider without framework lock-in. Concorde is MIT-licensed and maintained by Supersoniks.
+Custom elements (`sonic-*`) for buttons, forms, lists, queues, SDUI trees and more. Decorators such as `@get`, `@post`, `@subscribe` and `@bind` wire components to a shared DataProvider without framework lock-in. Concorde is MIT-licensed and maintained by Supersoniks ([about](https://concorde.supersoniks.org/about), [privacy](https://concorde.supersoniks.org/privacy)).

package/docs/llms-full.txt

@@ -273,11 +273,11 @@ No slots.
 
 - URL: https://concorde.supersoniks.org/core/components/functional/list
 - Doc ID: core/components/functional/list/list
-- Keywords: Concorde, supersoniks, core/components/functional/list/list, list, List, functional component, sonic-list, web component, props, fetch, items, , /list-item/, serviceURL, endPoint
+- Keywords: Concorde, supersoniks, core/components/functional/list/list, list, List, functional component, sonic-list, web component, props, fetch, .items, .separator, .noItems, .skeleton, , /list-item/
 
 List
 
-sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. From Lit, pass a row renderer on the items property; in plain HTML, declare   children. Each row gets its own data provider at  /list-item/ .
+sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. In TypeScript, prefer the .items row renderer (with .separator · .noItems · .skeleton);   children are for plain HTML hosts without Lit. Each row gets its own data provider at  /list-item/ .
 
 Basic example
 
@@ -285,7 +285,7 @@ Add fetch to load props from serviceURL + endPoint (or dataProvider when endPoin
 
          $time  $code from $city ($airport)">
 
-Fetch attributes (lazyload · refetchEveryMs · headers · authentication) are shared with Fetch.
+This example uses HTML templates; from Lit, use the row renderer instead. Fetch attributes (lazyload · refetchEveryMs · headers · authentication) are shared with Fetch.
 
 Row renderer
 
@@ -327,6 +327,8 @@ API reference
 | loader | fixed (when empty) · inline | Loader shown while fetching. None by default |
 | debug | boolean | Shows each row's data on hover |
 
+Properties (TypeScript / Lit, preferred):
+
 | Property | Type | Description |
 |----------|------|-------------|
 | props | array · object | Rows to render |
@@ -336,6 +338,8 @@ API reference
 | skeleton | () => TemplateResult | Rendered while fetching |
 | itemPropertyMap | object | propertyMap passed to each row subscriber |
 
+Templates (plain HTML hosts):
+
 | Template | Description |
 |----------|-------------|
 |   | Row markup; several are used in turn |
@@ -3743,28 +3747,15 @@ API reference
 
 - URL: https://concorde.supersoniks.org/docs/decorators/bind
 - Doc ID: docs/decorators/bind
-- Keywords: Concorde, supersoniks, docs/decorators/bind, bind, @bind, decorator, { reflect: true }, passengers.0, @state(), DataProviderKey, reflect: false, reflect: true, set(), ${index}, null
+- Keywords: Concorde, supersoniks, docs/decorators/bind, bind, @bind, decorator, @bind(key), { reflect: true }, @state(), reflect: true, set(), reflect, @subscribe, ${index}
 
 @bind
 
-Keeps a class property in sync with a path of the DataProvider store, in both directions when needed. Pass a dot-notation string or a DataProviderKey; add { reflect: true } to push local writes back to the store. For read-only sync prefer @subscribe, and see Data flow for the overall model.
+@bind(key) keeps a class property and one path of the DataProvider store in sync. With { reflect: true } the sync goes both ways: the property follows the store, and each assignment is written back to it. For one direction only, use the complementary decorators: @subscribe to read, @publish to write. See Data flow for the overall model.
 
 Import
 
 import { bind } from "@supersoniks/concorde/decorators";
-
-@bind("flight.gate")
-@state()
-gate = "";
-
-Basic usage
-
-The first path segment is the data provider id, the rest is dot notation (array items use a numeric index: passengers.0). The property updates each time the store value changes. Add @state() so Lit re-renders.
-
-Typed key
-
-With a DataProviderKey , TypeScript checks that the property type matches T at that path.
-
 import { DataProviderKey } from "@supersoniks/concorde/dataProviderKey";
 
 type Flight = { flight: string; gate: string; boarded: number };
@@ -3774,13 +3765,25 @@ const flightKey = new DataProviderKey<Flight>("flight");
 @state()
 boarded = 0;
 
+Basic usage
+
+The key is a DataProviderKey: TypeScript checks that the property type matches T at that path. The property updates each time the store value changes. Add @state() so Lit re-renders.
+
 Reflect
 
-By default (reflect: false) the binding is one-way: assigning the property does not touch the store. With reflect: true, each assignment calls set() on the publisher, so every other subscriber sees the new value. An internal guard prevents update loops.
+With reflect: true, each assignment to the property calls set() at the key path, so every other subscriber sees the new value. An internal guard prevents update loops. Without reflect (the default), assigning the property does not touch the store, and @bind behaves like @subscribe.
 
 Dynamic path
 
-Placeholders such as ${index} are resolved from properties of the same component, and @bind re-subscribes when they change. Write them in a plain string, not a backtick template literal. While a placeholder is null or undefined the binding is inactive; { skipEmptyPlaceholder: true } also waits on "". Full rules: Dynamic paths.
+Placeholders such as ${index} are resolved from properties of the same component, and @bind re-subscribes when they change. Declare them in the key's second generic and write them in a plain string, not a backtick template literal. While a placeholder is null or undefined the binding is inactive; { skipEmptyPlaceholder: true } also waits on "". Full rules: Dynamic paths.
+
+const personKey = new DataProviderKey<Person, { dataProvider: string; index: number }>(
+  "${dataProvider}.${index}",
+);
+
+@bind(personKey)
+@state()
+person: Person | null = null;
 
 Lifecycle
 
@@ -3790,7 +3793,7 @@ API reference
 
 | Argument | Type | Description |
 |----------|------|-------------|
-| path | string or DataProviderKey  | Store path to bind. Supports ${prop} placeholders |
+| key | DataProviderKey  | Store path to bind. Supports ${prop} placeholders |
 | options.reflect | boolean (default false) | Write local assignments back to the store |
 | options.skipEmptyPlaceholder | boolean (default false) | Treat a placeholder resolved to "" as not ready |
 
@@ -4566,20 +4569,20 @@ Other ancestor attributes (serviceURL, token, …) apply as for any request: see
 
 ---
 
-## AI agents (skills & AGENTS.md)
+## AI agents (skill)
 
 - URL: https://concorde.supersoniks.org/docs/getting-started/ai-agents
 - Doc ID: docs/getting-started/ai-agents
-- Keywords: Concorde, supersoniks, docs/getting-started/ai-agents, ai-agents, AI agents (skills & AGENTS.md), guide, AGENTS.md, yarn ai:sync, ai-init, yarn add @supersoniks/concorde,  |
-| Concorde repo (contributors) | , --skip-agents, --merge-agents, --force-agents
+- Keywords: Concorde, supersoniks, docs/getting-started/ai-agents, ai-agents, AI agents (skill), guide, concorde, AGENTS.md, yarn ai:sync, ai-init, yarn add @supersoniks/concorde,  |
+| Concorde repo (contributors) | , SKILL.md, custom-elements.json, rules/
 
-AI agents (skills & AGENTS.md)
+AI agents (skill)
 
-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, migrations).
+Concorde ships one Agent Skill, concorde, so coding agents follow the framework patterns. Cursor, Claude Code, JetBrains Junie and other agents load it on their own when they work on Concorde code; there is nothing to add to your AGENTS.md.
 
-On a starter project, run yarn ai:sync after install. On an existing project, install Concorde first, then use ai-init below.
+On a starter project, run yarn ai:sync after install. On an existing project, install Concorde first, then run ai-init.
 
-Dedicated commands
+Commands
 
 | Context | Command |
 |---------|---------|
@@ -4587,61 +4590,42 @@ Dedicated commands
 | Any consumer app (after yarn add @supersoniks/concorde) | node nodemodules/@supersoniks/concorde/scripts/ai-init.mjs |
 | Concorde repo (contributors) | yarn ai-init |
 
-Starter (from project root)
-yarn ai:sync
+Re-run the same command after each Concorde upgrade to refresh the skill.
 
-Manual / existing project
-node nodemodules/@supersoniks/concorde/scripts/ai-init.mjs
+The skill
 
-Useful flags
+SKILL.md is the entry point: where to find the truth (the project, these docs, custom-elements.json), the critical rules and the imports. Details live in rules/ files that the agent reads only for the topic at hand.
 
-| Flag | Effect |
-|------|--------|
-| --skip-agents | Never write AGENTS.md (skills / rules only) |
-| --merge-agents | Opt-in: keep the project preamble and append / refresh the Concorde block |
-| --force-agents | Opt-in: replace the whole AGENTS.md (destructive) |
-| --overlay   | Extra rules/skills + optional AGENTS.concorde.md for project-only Concorde agent notes |
-| --cursor-only | Install only .cursor/skills and .cursor/rules |
-| --jetbrains-only | Install only .aiassistant/rules/ |
+| File | Topic |
+|------|-------|
+| SKILL.md | Sources, critical rules, component shape, imports |
+| rules/data.md | Store, DataProviderKey, @subscribe / @publish / @bind / @handle, sub(), get / set / dp |
+| rules/http.md | Endpoint, @get / @post, API configuration |
+| rules/lists-forms.md | sonic-list / sonic-queue, form fields |
+| rules/styling.md | Theme, tokens, classes, styling rules |
+| rules/composition.md | Parts of compound components, built-in states |
+| rules/troubleshooting.md | Symptom → cause → fix: values not updating, requests not sent, empty lists |
 
-AGENTS.md policy (non-invasive)
+What gets installed
 
-| Situation | Default |
-|-----------|---------|
-| No AGENTS.md | Create the Concorde guide |
-| File with   | Refresh the managed zone only |
-| File without marker (project notes) | Left untouched — skills / rules are enough |
-| --merge-agents / --force-agents / --skip-agents | See flags above |
+| Path | Role |
+|------|------|
+| .agents/skills/concorde/ | The skill (read directly by Cursor) |
+| .claude/skills/concorde | Symlink for Claude Code |
+| .junie/skills/concorde | Symlink for JetBrains Junie |
 
-[optional project preamble — short, project-only]
+Where symlinks are not allowed (some Windows setups), the skill is copied instead. Your own skills in these folders are never touched. Commit .agents/ and the links if your team shares agent settings.
 
-[--- + overlay AGENTS.concorde.md]
+AGENTS.md stays yours: ai-init never reads or writes it.
 
-Everything after   is replaced on each ai-init run (idempotent). Do not paste a full copy of the Concorde guide above the marker — put project-specific notes in AGENTS.concorde.md (overlay). If the preamble duplicates package AGENTS.md, ai-init slims or drops it and prints a warning. Legacy filenames AGENTS.overlay.md / AGENTS.starter.md are still accepted with a deprecation warning.
+Flags
 
-What gets installed
+| Flag | Effect |
+|------|--------|
+| --no-links | Install .agents/skills only, without the .claude / .junie links |
+| --overlay   | Also install the skills found in  /skills/ (project kit) |
 
-| Path | Role |
-|------|------|
-| AGENTS.md | Created only if missing; existing project-owned files are left alone unless --merge-agents / --force-agents |
-| .cursor/skills/concorde/ | Core Lit + DataProvider patterns |
-| .cursor/skills/concorde-imports/ | Short @supersoniks/concorde/… import paths |
-| .cursor/skills/concorde-scope/ | serviceURL, formDataProvider, API configuration |
-| .cursor/skills/concorde-theme/ | sonic-theme and --sc- tokens |
-| .cursor/skills/concorde-menu/ | sonic-menu navigation |
-| .cursor/skills/concorde-get-set-dp/ | get / set / dp and DataProviderKey migration |
-| .cursor/rules/concorde.mdc | Cursor rules (always-on patterns) |
-| .aiassistant/rules/concorde.md | JetBrains AI Assistant rules |
-
-Workflow
-
-1. Starter project: Installation — yarn ai:sync is wired in the kit.
-2. Existing project: run ai-init after yarn add @supersoniks/concorde.
-3. Commit .cursor/ and .aiassistant/ (and AGENTS.md only if you opted in / it was created) if your team shares agent settings.
-4. Re-run the same command when you bump @supersoniks/concorde to refresh skills from nodemodules/@supersoniks/concorde/ai/.
-5. In Cursor, skills under .cursor/skills/ are picked up automatically; mention a skill in chat for focused tasks (e.g. migration → concorde-get-set-dp).
-
-Source files in the npm package: nodemodules/@supersoniks/concorde/ai/ (see also ai/README.md in the Concorde repository).
+Source files in the npm package: nodemodules/@supersoniks/concorde/ai/skills/concorde/.
 
 ---
 
@@ -4802,7 +4786,7 @@ Quick map
 | Derived / aggregate (JSONata) | derive() or sonic-jsonata — Jsonata |
 | Offline doc demos | serviceURL="/docs-mock-api" — Local API demos |
 
-Skill: concorde-get-set-dp in the package ai/ folder.
+Agent skill: concorde (rules/data.md), see AI agents.
 
 DataProviderKey
 

package/docs/llms.txt

@@ -13,8 +13,10 @@
 - [Sitemap](https://concorde.supersoniks.org/sitemap.xml)
 - [npm package @supersoniks/concorde](https://www.npmjs.com/package/@supersoniks/concorde)
 - [Getting started](https://concorde.supersoniks.org/docs/getting-started/start)
-- [AI agents (skills)](https://concorde.supersoniks.org/docs/getting-started/ai-agents)
+- [AI agents (skill)](https://concorde.supersoniks.org/docs/getting-started/ai-agents)
 - [Components index](https://concorde.supersoniks.org/docs/getting-started/components)
+- [custom-elements.json](https://concorde.supersoniks.org/custom-elements.json) — Custom Elements Manifest: attributes, properties, events and slots of every `sonic-*` element
+- [About](https://concorde.supersoniks.org/about) · [Privacy](https://concorde.supersoniks.org/privacy)
 
 Doc pages use the same pathnames as the interactive site (`/docs/…`, `/core/…`).
 Markdown: same URL with `.md` (e.g. `/docs/getting-started/start.md`), or `Accept: text/markdown` on the pathname.
@@ -32,7 +34,7 @@ HTML crawlers receive a static HTML variant of the same URL.
 - [Fetch](https://concorde.supersoniks.org/core/components/functional/fetch) (core/components/functional/fetch/fetch): sonic-fetch sends a GET request to serviceURL + endPoint and publishes the response under dataProvider, so its children and any subscriber of that provider can render it. In a Lit component, prefer th
 - [If](https://concorde.supersoniks.org/core/components/functional/if) (core/components/functional/if/if): sonic-if renders its default slot only while condition is true. Use it to show or hide a block from reactive state; with no condition, the content is not rendered. The host uses display: contents, so 
 - [Jsonata](https://concorde.supersoniks.org/core/components/functional/jsonata) (core/components/functional/jsonata/jsonata): sonic-jsonata reads one data provider, evaluates a JSONata expression on it and writes the result to another data provider. Use it for read-only aggregates such as groups, rankings and totals; use Mix
-- [List](https://concorde.supersoniks.org/core/components/functional/list) (core/components/functional/list/list): sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. From Lit, pass a row renderer on the items property; in plain HTML, declare <template> children. Each
+- [List](https://concorde.supersoniks.org/core/components/functional/list) (core/components/functional/list/list): sonic-list renders one row per entry of its props array, either set directly or loaded with fetch. In TypeScript, prefer the .items row renderer (with .separator · .noItems · .skeleton); <template> ch
 - [Mix](https://concorde.supersoniks.org/core/components/functional/mix) (core/components/functional/mix/mix): sonic-mix builds a new data provider from parts of other ones. Each key of composition maps to a source data provider id, with an optional dot path to a sub-value. The mixed provider is named by the d
 - [Queue](https://concorde.supersoniks.org/core/components/functional/queue) (core/components/functional/queue/queue): sonic-queue loads a paginated API in batches and renders each batch as an internal List. Choose it over sonic-list for long or endless lists; the key attributes are dataProviderExpression · limit · da
 - [Router](https://concorde.supersoniks.org/core/components/functional/router) (core/components/functional/router/router): sonic-router watches the location (pathname + hash) and renders the views whose route matches. From Lit, pass a .routes map of path patterns to render functions; use sonic-redirect to navigate when a 
@@ -74,7 +76,7 @@ HTML crawlers receive a static HTML variant of the same URL.
 - [Tooltip](https://concorde.supersoniks.org/core/components/ui/tooltip) (core/components/ui/tooltip/tooltip): sonic-tooltip shows a short label in a bubble when the trigger in the default slot is hovered or receives focus. With no placement, the bubble sits on top, centered. An empty label hides the bubble, l
 - [@ancestorAttribute](https://concorde.supersoniks.org/docs/decorators/ancestor-attribute) (docs/decorators/ancestor-attribute): Copies the value of an attribute from the nearest element that carries it (the host itself, then its ancestors, across shadow roots) into a class property. Use it to pick up a scope such as dataProvid
 - [@autoSubscribe](https://concorde.supersoniks.org/docs/decorators/auto-subscribe) (docs/decorators/auto-subscribe): Legacy decorator that re-runs a method whenever one of the store values it reads is assigned. For new code, prefer @subscribe with a DataProviderKey: dependencies are explicit and typed.
-- [@bind](https://concorde.supersoniks.org/docs/decorators/bind) (docs/decorators/bind): Keeps a class property in sync with a path of the DataProvider store, in both directions when needed. Pass a dot-notation string or a DataProviderKey; add { reflect: true } to push local writes back t
+- [@bind](https://concorde.supersoniks.org/docs/decorators/bind) (docs/decorators/bind): @bind(key) keeps a class property and one path of the DataProvider store in sync. With { reflect: true } the sync goes both ways: the property follows the store, and each assignment is written back to
 - [@get](https://concorde.supersoniks.org/docs/decorators/get) (docs/decorators/get): @get(endpoint) runs an HTTP GET on an Endpoint and stores the full ApiResult<T> in a property, or passes it to a method. It runs again when the endpoint's placeholders or the API configuration change,
 - [@handle](https://concorde.supersoniks.org/docs/decorators/handle) (docs/decorators/handle): @handle(...keys) calls the decorated method each time a publisher assigns one of up to three store paths, with one typed argument per key. Nothing is stored on the component: use it for derived values
 - [@onAssign](https://concorde.supersoniks.org/docs/decorators/on-assign) (docs/decorators/on-assign): Legacy decorator that calls a method with the values at one or more string paths of the store, once all of them are defined. For new code, use @handle with { waitForAllDefined: true }: same behaviour,
@@ -86,7 +88,7 @@ HTML crawlers receive a static HTML variant of the same URL.
 - [@awaitConnectedAncestors](https://concorde.supersoniks.org/docs/decorators/wait-for-ancestors) (docs/decorators/wait-for-ancestors): Delays a component's connectedCallback until its matching ancestors are defined and connected, so context they set up (a dataProvider, a publisher, a fetched payload) is ready when the child starts. P
 - [sub()](https://concorde.supersoniks.org/docs/directives/sub) (docs/directives/sub): sub(path) is a Lit directive that renders the current value of a store path and updates in place on every assignment. Use it inside html templates for read-only display; in a decorator, the same path 
 - [t()](https://concorde.supersoniks.org/docs/directives/t) (docs/directives/t): Lit directive that renders a translated label by key. Keys are batched into one GET to the endpoint set by the nearest wordingProvider ancestor attribute, and results are cached in localStorage.
-- [AI agents (skills & AGENTS.md)](https://concorde.supersoniks.org/docs/getting-started/ai-agents) (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
+- [AI agents (skill)](https://concorde.supersoniks.org/docs/getting-started/ai-agents) (docs/getting-started/ai-agents): Concorde ships one Agent Skill, concorde, so coding agents follow the framework patterns. Cursor, Claude Code, JetBrains Junie and other agents load it on their own when they work on Concorde code; th
 - [Components](https://concorde.supersoniks.org/docs/getting-started/components) (docs/getting-started/components): Every Concorde web component, grouped like the sidebar. Pick one to see its live demos, attributes and import path.
 - [Creating components](https://concorde.supersoniks.org/docs/getting-started/create-a-component) (docs/getting-started/create-a-component): > New app components: start with My first component and Data flow. The Subscriber mixin below is legacy.
 - [Data flow](https://concorde.supersoniks.org/docs/getting-started/dataFlow) (docs/getting-started/dataFlow): Recommended patterns for new Concorde apps (Lit + TypeScript). Under the hood, data lives in a DataProvider store.

package/docs/privacy.html

@@ -0,0 +1,122 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/svg+xml" href="./svg/favicon.svg" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Privacy notice — Concorde by Supersoniks</title>
+    <meta name="description" content="Privacy notice of the Concorde documentation site: no cookies, no analytics, third-party hosts and your GDPR rights." />
+    <meta
+      name="keywords"
+      content="Concorde, Supersoniks, web components, Lit, design system, @supersoniks/concorde, DataProvider, sonic-button"
+    />
+    <link rel="canonical" href="https://concorde.supersoniks.org/privacy" />
+    <link rel="alternate" type="text/markdown" href="/privacy.md" title="Markdown" />
+    <link rel="alternate" type="text/plain" href="/llms.txt" title="llms.txt" />
+    <meta property="og:type" content="website" />
+    <meta property="og:site_name" content="Concorde by Supersoniks" />
+    <meta property="og:title" content="Privacy notice — Concorde by Supersoniks" />
+    <meta property="og:description" content="Privacy notice of the Concorde documentation site: no cookies, no analytics, third-party hosts and your GDPR rights." />
+    <meta property="og:url" content="https://concorde.supersoniks.org/privacy" />
+    <meta property="og:image" content="https://concorde.supersoniks.org/img/og-concorde.jpg" />
+    <meta property="og:image:width" content="1200" />
+    <meta property="og:image:height" content="630" />
+    <meta property="og:image:alt" content="Five Concorde aircraft parked nose to nose, black and white photo" />
+    <meta name="twitter:card" content="summary_large_image" />
+    <script type="application/ld+json">{"@context":"https://schema.org","@type":"WebPage","name":"Privacy notice — Concorde by Supersoniks","description":"Privacy notice of the Concorde documentation site: no cookies, no analytics, third-party hosts and your GDPR rights.","url":"https://concorde.supersoniks.org/privacy","isPartOf":{"@type":"WebSite","name":"Concorde","url":"https://concorde.supersoniks.org/"},"publisher":{"@type":"Organization","@id":"https://supersoniks.com/#organization","name":"Supersoniks","legalName":"SUPERSONIKS","url":"https://supersoniks.com/","telephone":"+33 2 47 68 93 25","address":{"@type":"PostalAddress","streetAddress":"22 rue du Docteur Bretonneau","postalCode":"37000","addressLocality":"Tours","addressCountry":"FR"},"contactPoint":{"@type":"ContactPoint","contactType":"customer service","telephone":"+33 2 47 68 93 25","url":"https://supersoniks.com/un-projet","availableLanguage":["fr","en"]},"sameAs":["https://www.linkedin.com/company/supersoniks/","https://www.facebook.com/supersoniks","https://www.instagram.com/agencesupersoniks/"]}}</script>
+    <link rel="preconnect" href="https://fonts.googleapis.com" />
+    <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
+    <link
+      href="https://fonts.googleapis.com/css2?family=Schibsted+Grotesk:wght@400;600;800&display=swap"
+      rel="stylesheet"
+    />
+    <script src="https://cdn.jsdelivr.net/npm/fuzzysort@2.0.1/fuzzysort.min.js"></script>
+    <!-- <script src="https://cdn.jsdelivr.net/npm/marked/marked.min.js"></script>
+     -->
+    <script src="https://cdn.jsdelivr.net/npm/marked@13.0.3"></script>
+    <style>
+      /*
+        Crawler/agent fallback stays in the HTML source (Is Agentic raw-text check)
+        but must not take clicks or layout away from the interactive homepage.
+      */
+      #docs-agent-content {
+        display: none !important;
+      }
+    </style>
+    <script type="module" crossorigin src="/assets/index-6sS76xWj.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-DkdPbH0F.css">
+  </head>
+  <body class="px-4 sm:px-6 lg:px-10 2xl:px-20">
+    <!--
+      Static homepage copy for agents and no-JS crawlers (Is Agentic / Ora).
+      Hidden after JS boot; must stay in raw HTML with a clear H1 and 500+ chars.
+    -->
+    <section id="docs-agent-content" aria-hidden="true">
+<h1 id="privacy-notice">Privacy notice</h1>
+<p>This notice covers the Concorde documentation site, <a href="https://concorde.supersoniks.org">https://concorde.supersoniks.org</a>, published by <a href="https://supersoniks.com/">Supersoniks</a>, 22 rue du Docteur Bretonneau, 37000 Tours, France.</p>
+<h2 id="what-this-site-does-not-do">What this site does not do</h2>
+<ul>
+<li>It has no user accounts, sign-up or login.</li>
+<li>It sets no cookies and runs no analytics, advertising or tracking scripts.</li>
+<li>It has no forms that send personal data to Supersoniks.</li>
+</ul>
+<h2 id="what-is-stored-in-your-browser">What is stored in your browser</h2>
+<ul>
+<li><code>sonicTheme</code> in localStorage remembers your light or dark theme choice. It never leaves your browser.</li>
+<li>A service worker serves the mock API used by live examples (<code>/docs-mock-api/…</code>). It runs locally in your browser.</li>
+<li>Some examples demonstrate features that store values in localStorage (for example dismissed alerts or cached labels). They only run when you open those pages.</li>
+</ul>
+<h2 id="third-party-services">Third-party services</h2>
+<p>To display pages, your browser loads files from these providers, which receive your IP address and browser details as part of any web request:</p>
+<ul>
+<li>Google Fonts (fonts.googleapis.com, fonts.gstatic.com) for the Schibsted Grotesk font.</li>
+<li>jsDelivr (cdn.jsdelivr.net) for the search and Markdown libraries.</li>
+<li>cdn.supersoniks.com for icons.</li>
+<li>A few live examples call public demo APIs (geo.api.gouv.fr, reqres.in, i.pravatar.cc) when you open them.</li>
+</ul>
+<h2 id="server-logs">Server logs</h2>
+<p>Like any web server, the host records technical request data (IP address, URL, date, user agent) to operate and secure the site.</p>
+<h2 id="your-rights">Your rights</h2>
+<p>Under the GDPR you can ask for access to, correction or deletion of data about you. Contact Supersoniks through <a href="https://supersoniks.com/un-projet">supersoniks.com/un-projet</a>, by phone at +33 2 47 68 93 25, or by mail at 22 rue du Docteur Bretonneau, 37000 Tours, France. See also the <a href="https://supersoniks.com/politique-de-confidentialite">Supersoniks privacy policy</a> and <a href="https://supersoniks.com/mentions-legales">legal notice</a>.</p>
+
+    </section>
+
+    <sonic-theme
+      customIconLibraryPath="https://cdn.supersoniks.com/concorde/icons/fontawesome/v6/$prefix/$name.svg"
+      customIconDefaultPrefix="regular"
+      markdownsURL=""
+    >
+      <sonic-docs-header></sonic-docs-header>
+      <sonic-router>
+        <!-- Home only at `/` (doc pages use pathname `/docs/...` or `/core/...`). -->
+        <template data-route="^/?$">
+          <docs-home></docs-home>
+        </template>
+      </sonic-router>
+
+      <div
+        class="[[data-home]_&]:hidden grid grid-cols-1 lg:grid-cols-[14rem_minmax(0,1fr)] xl:grid-cols-[15rem_minmax(0,1fr)_13rem] gap-8 xl:gap-12"
+      >
+        <aside class="hidden lg:block">
+          <docs-navigation
+            class="sticky top-[4.2rem] max-h-[calc(100svh_-_4.2rem)] block overflow-auto py-4 custom-scroll"
+          ></docs-navigation>
+        </aside>
+        <main class="min-w-0 min-h-[100svh] pt-3">
+          <div class="max-w-prose mx-auto xl:mx-0">
+            <docs-page
+              noShadowDom
+              class="prose max-w-none block py-8 prose-li:my-[.2em] leading-[1.5] lg:leading-[1.5] prose-h1:text-[2.4em] sm:prose-h1:text-[3.25em] prose-code:before:content-none prose-code:after:content-none prose-pre:font-mono"
+            ></docs-page>
+            <docs-pager class="block mt-8 pb-16"></docs-pager>
+          </div>
+        </main>
+        <aside class="hidden xl:block">
+          <docs-toc
+            class="sticky top-[4.2rem] max-h-[calc(100svh_-_4.2rem)] block overflow-auto py-4 custom-scroll"
+          ></docs-toc>
+        </aside>
+      </div>
+    </sonic-theme>
+  </body>
+</html>

package/docs/privacy.md

@@ -0,0 +1,32 @@
+# Privacy notice
+
+This notice covers the Concorde documentation site, https://concorde.supersoniks.org, published by [Supersoniks](https://supersoniks.com/), 22 rue du Docteur Bretonneau, 37000 Tours, France.
+
+## What this site does not do
+
+- It has no user accounts, sign-up or login.
+- It sets no cookies and runs no analytics, advertising or tracking scripts.
+- It has no forms that send personal data to Supersoniks.
+
+## What is stored in your browser
+
+- `sonicTheme` in localStorage remembers your light or dark theme choice. It never leaves your browser.
+- A service worker serves the mock API used by live examples (`/docs-mock-api/…`). It runs locally in your browser.
+- Some examples demonstrate features that store values in localStorage (for example dismissed alerts or cached labels). They only run when you open those pages.
+
+## Third-party services
+
+To display pages, your browser loads files from these providers, which receive your IP address and browser details as part of any web request:
+
+- Google Fonts (fonts.googleapis.com, fonts.gstatic.com) for the Schibsted Grotesk font.
+- jsDelivr (cdn.jsdelivr.net) for the search and Markdown libraries.
+- cdn.supersoniks.com for icons.
+- A few live examples call public demo APIs (geo.api.gouv.fr, reqres.in, i.pravatar.cc) when you open them.
+
+## Server logs
+
+Like any web server, the host records technical request data (IP address, URL, date, user agent) to operate and secure the site.
+
+## Your rights
+
+Under the GDPR you can ask for access to, correction or deletion of data about you. Contact Supersoniks through [supersoniks.com/un-projet](https://supersoniks.com/un-projet), by phone at +33 2 47 68 93 25, or by mail at 22 rue du Docteur Bretonneau, 37000 Tours, France. See also the [Supersoniks privacy policy](https://supersoniks.com/politique-de-confidentialite) and [legal notice](https://supersoniks.com/mentions-legales).