@supersoniks/concorde 5.1.2 → 5.1.3

package/docs/src/docs/search/docs-search.json

@@ -780,7 +780,7 @@
     }
   },
   {
-    "search": "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 row gets its own data provider at <dataProvider>/list-item/<index>.\n",
+    "search": "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> children are for plain HTML hosts without Lit. Each row gets its own data provider at <dataProvider>/list-item/<index>.\n",
     "files": {
       "core/components/functional/list/list.md": {
         "title": "List",
@@ -810,7 +810,7 @@
     }
   },
   {
-    "search": "Fetch attributes (lazyload · refetchEveryMs · headers · authentication) are shared with Fetch.\n",
+    "search": "This example uses HTML templates; from Lit, use the row renderer instead. Fetch attributes (lazyload · refetchEveryMs · headers · authentication) are shared with Fetch.\n",
     "files": {
       "core/components/functional/list/list.md": {
         "title": "List",
@@ -914,6 +914,36 @@
       }
     }
   },
+  {
+    "search": "Properties (TypeScript / Lit, preferred):\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Templates (plain HTML hosts):\n",
+    "files": {
+      "core/components/functional/list/list.md": {
+        "title": "List",
+        "hashes": {
+          "api-reference": {
+            "count": 1,
+            "title": "API reference",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "Mix",
     "files": {
@@ -1290,7 +1320,7 @@
     }
   },
   {
-    "search": "Aide-mémoire pour les dépôts externes (adaptateurs, shells).Pas une page de la doc site — à lire dans le package npm(node_modules/@supersoniks/concorde/src/core/components/functional/sdui/sdui-extension-points.md).La doc utilisateur / crawl reste sdui.md (auto-suffisante).\n",
+    "search": "Aide-mémoire pour les dépôts externes (adaptateurs, shells).Pas une page de la doc site — à lire dans le package npm(node_modules/@supersoniks/concorde/src/core/components/functional/sdui/sdui-extension-points.md).La doc utilisateur reste sdui.md (auto-suffisante).\n",
     "files": {
       "core/components/functional/sdui/sdui-extension-points.md": {
         "title": "SDUI — points d’extension publics",
@@ -6020,7 +6050,7 @@
     }
   },
   {
-    "search": "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.\n",
+    "search": "@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.\n",
     "files": {
       "docs/decorators/bind.md": {
         "title": "@bind",
@@ -6035,7 +6065,7 @@
     }
   },
   {
-    "search": "@bind("flight.gate")\n@state()\ngate = "";\n  \n\n",
+    "search": "type Flight = { flight: string; gate: string; boarded: number };\nconst flightKey = new DataProviderKey<Flight>("flight");\n",
     "files": {
       "docs/decorators/bind.md": {
         "title": "@bind",
@@ -6050,29 +6080,14 @@
     }
   },
   {
-    "search": "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.\n",
-    "files": {
-      "docs/decorators/bind.md": {
-        "title": "@bind",
-        "hashes": {
-          "basic-usage": {
-            "count": 1,
-            "title": "Basic usage",
-            "type": "paragraph"
-          }
-        }
-      }
-    }
-  },
-  {
-    "search": "With a DataProviderKey<T>, TypeScript checks that the property type matches T at that path.\n",
+    "search": "@bind(flightKey.boarded, { reflect: true })\n@state()\nboarded = 0;\n  \n\n",
     "files": {
       "docs/decorators/bind.md": {
         "title": "@bind",
         "hashes": {
-          "typed-key": {
+          "import": {
             "count": 1,
-            "title": "Typed key",
+            "title": "Import",
             "type": "paragraph"
           }
         }
@@ -6080,14 +6095,14 @@
     }
   },
   {
-    "search": "type Flight = { flight: string; gate: string; boarded: number };\nconst flightKey = new DataProviderKey<Flight>("flight");\n",
+    "search": "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.\n",
     "files": {
       "docs/decorators/bind.md": {
         "title": "@bind",
         "hashes": {
-          "typed-key": {
+          "basic-usage": {
             "count": 1,
-            "title": "Typed key",
+            "title": "Basic usage",
             "type": "paragraph"
           }
         }
@@ -6095,14 +6110,14 @@
     }
   },
   {
-    "search": "@bind(flightKey.boarded, { reflect: true })\n@state()\nboarded = 0;\n  \n\n",
+    "search": "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.\n",
     "files": {
       "docs/decorators/bind.md": {
         "title": "@bind",
         "hashes": {
-          "typed-key": {
+          "reflect": {
             "count": 1,
-            "title": "Typed key",
+            "title": "Reflect",
             "type": "paragraph"
           }
         }
@@ -6110,14 +6125,14 @@
     }
   },
   {
-    "search": "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.\n",
+    "search": "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.\n",
     "files": {
       "docs/decorators/bind.md": {
         "title": "@bind",
         "hashes": {
-          "reflect": {
+          "dynamic-path": {
             "count": 1,
-            "title": "Reflect",
+            "title": "Dynamic path",
             "type": "paragraph"
           }
         }
@@ -6125,7 +6140,7 @@
     }
   },
   {
-    "search": "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.\n",
+    "search": "@bind(personKey)\n@state()\nperson: Person | null = null;\n  \n\n",
     "files": {
       "docs/decorators/bind.md": {
         "title": "@bind",
@@ -8135,12 +8150,12 @@
     }
   },
   {
-    "search": "AI agents (skills & AGENTS.md)",
+    "search": "AI agents (skill)",
     "files": {
       "docs/getting-started/ai-agents.md": {
-        "title": "AI agents (skills & AGENTS.md)",
+        "title": "AI agents (skill)",
         "hashes": {
-          "ai-agents-skills--agentsmd": {
+          "ai-agents-skill": {
             "count": 1,
             "title": "",
             "type": "page"
@@ -8150,12 +8165,12 @@
     }
   },
   {
-    "search": "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).\n",
+    "search": "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.\n",
     "files": {
       "docs/getting-started/ai-agents.md": {
-        "title": "AI agents (skills & AGENTS.md)",
+        "title": "AI agents (skill)",
         "hashes": {
-          "ai-agents-skills--agentsmd": {
+          "ai-agents-skill": {
             "count": 1,
             "title": "",
             "type": "paragraph"
@@ -8165,12 +8180,12 @@
     }
   },
   {
-    "search": "On a starter project, run yarn ai:sync after install. On an existing project, install Concorde first, then use ai-init below.\n",
+    "search": "On a starter project, run yarn ai:sync after install. On an existing project, install Concorde first, then run ai-init.\n",
     "files": {
       "docs/getting-started/ai-agents.md": {
-        "title": "AI agents (skills & AGENTS.md)",
+        "title": "AI agents (skill)",
         "hashes": {
-          "ai-agents-skills--agentsmd": {
+          "ai-agents-skill": {
             "count": 1,
             "title": "",
             "type": "paragraph"
@@ -8180,14 +8195,44 @@
     }
   },
   {
-    "search": "node node_modules/@supersoniks/concorde/scripts/ai-init.mjs\n  \n\n",
+    "search": "Re-run the same command after each Concorde upgrade to refresh the skill.\n",
+    "files": {
+      "docs/getting-started/ai-agents.md": {
+        "title": "AI agents (skill)",
+        "hashes": {
+          "commands": {
+            "count": 1,
+            "title": "Commands",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
+    "files": {
+      "docs/getting-started/ai-agents.md": {
+        "title": "AI agents (skill)",
+        "hashes": {
+          "the-skill": {
+            "count": 1,
+            "title": "The skill",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "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.\n",
     "files": {
       "docs/getting-started/ai-agents.md": {
-        "title": "AI agents (skills & AGENTS.md)",
+        "title": "AI agents (skill)",
         "hashes": {
-          "manual--existing-project": {
+          "what-gets-installed": {
             "count": 1,
-            "title": "Manual / existing project",
+            "title": "What gets installed",
             "type": "paragraph"
           }
         }
@@ -8195,14 +8240,14 @@
     }
   },
   {
-    "search": "Everything after <!-- concorde-ai --> 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.\n",
+    "search": "AGENTS.md stays yours: ai-init never reads or writes it.\n",
     "files": {
       "docs/getting-started/ai-agents.md": {
-        "title": "AI agents (skills & AGENTS.md)",
+        "title": "AI agents (skill)",
         "hashes": {
-          "agentsmd-policy-non-invasive": {
+          "what-gets-installed": {
             "count": 1,
-            "title": "`AGENTS.md` policy (non-invasive)",
+            "title": "What gets installed",
             "type": "paragraph"
           }
         }
@@ -8210,14 +8255,14 @@
     }
   },
   {
-    "search": "Source files in the npm package: node_modules/@supersoniks/concorde/ai/ (see also ai/README.md in the Concorde repository).\n",
+    "search": "Source files in the npm package: node_modules/@supersoniks/concorde/ai/skills/concorde/.\n",
     "files": {
       "docs/getting-started/ai-agents.md": {
-        "title": "AI agents (skills & AGENTS.md)",
+        "title": "AI agents (skill)",
         "hashes": {
-          "workflow": {
+          "flags": {
             "count": 1,
-            "title": "Workflow",
+            "title": "Flags",
             "type": "paragraph"
           }
         }
@@ -8570,7 +8615,7 @@
     }
   },
   {
-    "search": "Skill: concorde-get-set-dp in the package ai/ folder.\n",
+    "search": "Agent skill: concorde (rules/data.md), see AI agents.\n",
     "files": {
       "docs/getting-started/dataFlow.md": {
         "title": "Data flow",

package/docs/src/tsconfig.json

@@ -1074,6 +1074,9 @@
       "./utils/HTML": [
         "/sites/concorde/src/core/utils/HTML.ts"
       ],
+      "./utils/LocationHandler.spec": [
+        "/sites/concorde/src/core/utils/LocationHandler.spec.ts"
+      ],
       "./utils/LocationHandler": [
         "/sites/concorde/src/core/utils/LocationHandler.ts"
       ],
@@ -1185,6 +1188,9 @@
       "./undefined/docs-source-raw": [
         "/sites/concorde/src/docs/components/docs-source-raw.ts"
       ],
+      "./docs-location.spec": [
+        "/sites/concorde/src/docs/docs-location.spec.ts"
+      ],
       "./docs-location": [
         "/sites/concorde/src/docs/docs-location.ts"
       ],
@@ -1215,11 +1221,8 @@
       "./example/docs-boarding-pass-demo": [
         "/sites/concorde/src/docs/example/docs-boarding-pass-demo.ts"
       ],
-      "./example/docs-input-autocomplete-demos": [
-        "/sites/concorde/src/docs/example/docs-input-autocomplete-demos.ts"
-      ],
-      "./example/docs-joke-demos": [
-        "/sites/concorde/src/docs/example/docs-joke-demos.ts"
+      "./example/docs-flight-demos": [
+        "/sites/concorde/src/docs/example/docs-flight-demos.ts"
       ],
       "./example/docs-jsonata-demos": [
         "/sites/concorde/src/docs/example/docs-jsonata-demos.ts"
@@ -1275,6 +1278,9 @@
       "./mock-api/fixtures": [
         "/sites/concorde/src/docs/mock-api/fixtures.ts"
       ],
+      "./mock-api/flights": [
+        "/sites/concorde/src/docs/mock-api/flights.ts"
+      ],
       "./mock-api/register": [
         "/sites/concorde/src/docs/mock-api/register.ts"
       ],

package/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
@@ -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/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@supersoniks/concorde",
-  "version": "5.1.2",
+  "version": "5.1.3",
   "license": "MIT",
   "type": "module",
   "main": "",
+  "customElements": "custom-elements.json",
   "scripts": {
     "dev": "node scripts/create-search.js && LIB_NAME=docs vite --host 0.0.0.0 --port 3000",
     "prebuild": "node scripts/pre-build.mjs",
@@ -11,8 +12,9 @@
     "build": "tsc --build src/tsconfig.json  && vite build",
     "build-docs": "LIB_NAME=docs vite build",
     "postbuild-docs": "node scripts/post-build-docs.js",
-    "prepublishOnly": "node scripts/pre-publish.mjs",
+    "prepublishOnly": "node scripts/generate-cem.mjs && node scripts/pre-publish.mjs",
     "generate:sdui-catalog": "node scripts/generate-sdui-catalog.mjs",
+    "generate:cem": "node scripts/generate-cem.mjs",
     "test": "vitest --reporter verbose --watch",
     "test:ci": "vitest run --reporter verbose",
     "ai-init": "node scripts/ai-init.mjs"
@@ -379,6 +381,7 @@
     "./utils/Electron": "./src/core/utils/Electron.ts",
     "./utils/Format": "./src/core/utils/Format.ts",
     "./utils/HTML": "./src/core/utils/HTML.ts",
+    "./utils/LocationHandler.spec": "./src/core/utils/LocationHandler.spec.ts",
     "./utils/LocationHandler": "./src/core/utils/LocationHandler.ts",
     "./utils/Objects": "./src/core/utils/Objects.ts",
     "./utils/PublisherProxy": "./src/core/utils/PublisherProxy.ts",
@@ -416,6 +419,7 @@
     "./undefined/docs-source-link": "./src/docs/components/docs-source-link.ts",
     "./docs-source-raw": "./src/docs/components/docs-source-raw.ts",
     "./undefined/docs-source-raw": "./src/docs/components/docs-source-raw.ts",
+    "./docs-location.spec": "./src/docs/docs-location.spec.ts",
     "./docs-location": "./src/docs/docs-location.ts",
     "./docs": "./src/docs/docs.ts",
     "./example/decorators-demo-bind-demos": "./src/docs/example/decorators-demo-bind-demos.ts",
@@ -426,8 +430,7 @@
     "./example/decorators-demo": "./src/docs/example/decorators-demo.ts",
     "./example/docs-api-config-demos": "./src/docs/example/docs-api-config-demos.ts",
     "./example/docs-boarding-pass-demo": "./src/docs/example/docs-boarding-pass-demo.ts",
-    "./example/docs-input-autocomplete-demos": "./src/docs/example/docs-input-autocomplete-demos.ts",
-    "./example/docs-joke-demos": "./src/docs/example/docs-joke-demos.ts",
+    "./example/docs-flight-demos": "./src/docs/example/docs-flight-demos.ts",
     "./example/docs-jsonata-demos": "./src/docs/example/docs-jsonata-demos.ts",
     "./example/docs-list-demos": "./src/docs/example/docs-list-demos.ts",
     "./example/docs-provider-keys": "./src/docs/example/docs-provider-keys.ts",
@@ -446,6 +449,7 @@
     "./mock-api/api-config-mock": "./src/docs/mock-api/api-config-mock.ts",
     "./mock-api/fixtures-jsonata": "./src/docs/mock-api/fixtures-jsonata.ts",
     "./mock-api/fixtures": "./src/docs/mock-api/fixtures.ts",
+    "./mock-api/flights": "./src/docs/mock-api/flights.ts",
     "./mock-api/register": "./src/docs/mock-api/register.ts",
     "./mock-api/router": "./src/docs/mock-api/router.ts",
     "./mock-api/service-worker": "./src/docs/mock-api/service-worker.ts",