@supersoniks/concorde 5.1.2 → 5.1.3-immutable.1

package/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",
@@ -3845,14 +3875,29 @@
     }
   },
   {
-    "search": "sameValueAs sets pattern to the value of another field in the same store, for confirmation fields.\n",
+    "search": "A dot in name stores a nested object in the form publisher.\n",
     "files": {
       "core/components/ui/form/input/input.md": {
         "title": "Input",
         "hashes": {
-          "form-data": {
+          "nested-keys": {
             "count": 1,
-            "title": "Form data",
+            "title": "Nested keys",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "sameValueAs sets pattern to the value of another field in the same store, for confirmation fields. Dot paths are supported.\n",
+    "files": {
+      "core/components/ui/form/input/input.md": {
+        "title": "Input",
+        "hashes": {
+          "nested-keys": {
+            "count": 1,
+            "title": "Nested keys",
             "type": "paragraph"
           }
         }
@@ -3919,6 +3964,21 @@
       }
     }
   },
+  {
+    "search": "A dot in name writes a nested object in the form store (same as Submit nested fields).\n",
+    "files": {
+      "core/components/ui/form/radio/radio.md": {
+        "title": "Radio",
+        "hashes": {
+          "nested-keys": {
+            "count": 1,
+            "title": "Nested keys",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
   {
     "search": "The radio group writes one status value to the store used as dataFilterProvider by a sonic-queue. See Checkbox for the multi-value version.\n",
     "files": {
@@ -6020,7 +6080,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 +6095,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 +6110,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 +6125,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 +6140,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 +6155,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 +6170,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 +8180,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 +8195,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 +8210,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 +8225,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 +8270,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 +8285,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 +8645,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",
@@ -10283,5 +10358,230 @@
         }
       }
     }
+  },
+  {
+    "search": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "étude--immutabilité-dataprovider--get-redmine-79567": {
+            "count": 1,
+            "title": "",
+            "type": "page"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Nature : étude d’opportunité + ADR de direction.Branche : 79567_publisher_get_immutability_study.Recadrage (oct. 2026) : la cible n’est plus un empilement de gardes opt-in, mais un store immutable clair.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "étude--immutabilité-dataprovider--get-redmine-79567": {
+            "count": 1,
+            "title": "",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Le publisher possède les données. On ne mute jamais. On remplace.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "contrat-cible": {
+            "count": 1,
+            "title": "Contrat cible",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Empiler DeepReadonly + strictGet warn/throw + clone parfois = pansements autour d’un moteur encore mutable. Utile en radar de migration, pas comme architecture cible.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "ce-quon-ne-garde-pas-comme-design-produit": {
+            "count": 1,
+            "title": "Ce qu’on ne garde pas comme design produit",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Refonte du moteur PublisherProxy : plus de _value_[k] = … / delete _value_[k] / sync parent par mutation. Updates immutables (Immer ou setIn maison) sur tout chemin d’écriture (y compris traps Proxy / sous-proxies).\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "conséquence-technique": {
+            "count": 1,
+            "title": "Conséquence technique",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Aujourd’hui get() renvoie la référence live de _value_. Une mutation locale (cart.items.push…) contourne set et les listeners → état partagé / UI désynchronisés.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "1-problème-rappel": {
+            "count": 1,
+            "title": "1. Problème (rappel)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Écritures « officielles » (set, sous-proxies, publisher.clé = …) notifient ; le trou est get + mutation et réutilisation de la ref passée à set.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "1-problème-rappel": {
+            "count": 1,
+            "title": "1. Problème (rappel)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Fichier central : src/core/utils/PublisherProxy.ts.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "1-problème-rappel": {
+            "count": 1,
+            "title": "1. Problème (rappel)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Le modèle F met le coût là où il est acceptable (écritures), avec une sémantique nette.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "perf-ordre-de-grandeur": {
+            "count": 1,
+            "title": "Perf (ordre de grandeur)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Déjà présent (ne pas confondre avec la cible) :\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "33-rôle-du-spike-actuel-sur-cette-branche": {
+            "count": 1,
+            "title": "3.3 Rôle du spike actuel sur cette branche",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "→ Radar pour lister les mutations pendant la migration vers F. Destiné à disparaître ou à se réduire une fois le moteur immutable en place.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "33-rôle-du-spike-actuel-sur-cette-branche": {
+            "count": 1,
+            "title": "3.3 Rôle du spike actuel sur cette branche",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Oui : publier le chantier sur un dist-tag npm dédié, pas sur latest, le temps d’un usage approfondi.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "4-canal-de-livraison--dist-tag-npm-reco": {
+            "count": 1,
+            "title": "4. Canal de livraison — dist-tag npm (reco)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Versions du type 6.0.0-immutable.1, .2, … (prerelease) : claires dans le lockfile, republish fréquentes OK.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "proposition-de-tags": {
+            "count": 1,
+            "title": "Proposition de tags",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Go dist-tag immutable. C’est le bon niveau de netteté : chantier puissant isolé, adoption volontaire, mesure avant major. Le spike strictGet peut vivre sur la même branche/tag comme aide à la migration, documenté comme temporaire.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "avis": {
+            "count": 1,
+            "title": "Avis",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
+  },
+  {
+    "search": "Zones Billetterie chaudes : access-control/**, utils/cart.ts + components/cart/**, placing/**, subscription / tarifs, forms, ~300 onAssign, legacy lb_placement JS.\n",
+    "files": {
+      "docs/misc/publisher-get-immutability-study.md": {
+        "title": "Étude — immutabilité DataProvider / `get()` (REDMINE-79567)",
+        "hashes": {
+          "5-impact-consommateurs-rappel-audit": {
+            "count": 1,
+            "title": "5. Impact consommateurs (rappel audit)",
+            "type": "paragraph"
+          }
+        }
+      }
+    }
   }
 ]

package/src/docs/search/markdown-renderer.ts

@@ -38,7 +38,12 @@ export class DocsMakdownRenderer extends Subscriber(LitElement) {
   private _text = "";
   set text(value: string) {
     this._text = parseMarkdownWithSonicCode(
-      (markdown) => marked.parse(markdown) as string,
+      // Tables scroll in a wrapper, so they keep their full width on phones
+      (markdown) =>
+        (marked.parse(markdown) as string).replace(
+          /<table>[\s\S]*?<\/table>/g,
+          (table) => `<div class="docs-table-scroll">${table}</div>`,
+        ),
       value,
     );
     this.requestUpdate();

package/src/docs/tailwind/css/docs/content.css

@@ -19,14 +19,13 @@ docs-markdown-renderer :is(h1, h2, h3, h4)[id] {
 docs-page.prose :where(img) {
   max-width: 100%;
 }
+/* Markdown tables keep 100% width; the wrapper scrolls when columns overflow */
+docs-page .docs-table-scroll {
+  overflow-x: auto;
+}
 /* Wide demos (fixed min-width groups…) scroll instead of widening the page on phones */
 @media (max-width: 639px) {
   docs-page sonic-code > div {
     overflow-x: auto;
   }
-  /* tables stay 100% wide on larger screens; on phones they scroll */
-  docs-page.prose :where(table) {
-    display: block;
-    overflow-x: auto;
-  }
 }

package/src/tsconfig.declarations.json

@@ -0,0 +1,22 @@
+{
+  "extends": "./tsconfig-model.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "emitDeclarationOnly": true,
+    "declaration": true,
+    "declarationMap": true,
+    "outDir": "../dist/types",
+    "rootDir": "."
+  },
+  "include": ["**/*.ts"],
+  "exclude": [
+    "node_modules/**/*",
+    "**/*.spec.ts",
+    "**/*.test.ts",
+    "**/*.demo.ts",
+    "**/*.stories.ts",
+    "**/*.type-test.ts",
+    "docs.ts",
+    "docs/**/*"
+  ]
+}