story-theme-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,34 @@
+Licence d'utilisation — MCP Story Thème
+Copyright (c) 2026 SAS NS GROUP (New Story). Tous droits réservés.
+
+1. Objet
+   Ce logiciel (« le MCP ») accompagne le thème Shopify « Story Thème ». Il est réservé aux
+   titulaires d'une licence Story Thème en cours de validité, souscrite sur story-theme.com.
+
+2. Ce que vous pouvez faire
+   Installer et exécuter le MCP sur vos propres machines, pour construire et maintenir les
+   thèmes des boutiques Shopify que vous exploitez ou dont vous avez la charge, y compris pour
+   le compte de vos clients.
+
+3. Ce que vous ne pouvez pas faire
+   Revendre, redistribuer, publier ou sous-licencier le MCP ou ses sources ; en retirer les
+   vérifications de licence ; partager votre jeton d'accès avec un tiers ; utiliser le MCP,
+   les archives du thème qu'il télécharge ou les fichiers qu'il produit pour reconstituer,
+   dériver ou diffuser le Story Thème en dehors de vos propres boutiques.
+
+4. Jeton et données
+   Le jeton personnel identifie votre compte auprès de l'espace membre Story Thème. Il vérifie
+   que votre licence est active et donne accès à la dernière version publiée du thème. Le MCP
+   n'envoie rien d'autre : il ne transmet ni le contenu de vos boutiques, ni vos fichiers.
+
+5. Fin de licence
+   L'arrêt de votre abonnement met fin au droit d'utiliser le MCP et coupe l'accès aux versions
+   du thème. Les thèmes déjà installés sur vos boutiques restent régis par la licence du
+   Story Thème.
+
+6. Garantie et responsabilité
+   Le logiciel est fourni « en l'état », sans garantie d'aucune sorte. Les fichiers qu'il
+   produit sont à vérifier dans l'éditeur Shopify avant publication. SAS NS GROUP ne peut être
+   tenue responsable d'un dommage résultant de son utilisation.
+
+Contact : contact@story-theme.com

package/README.md

@@ -0,0 +1,113 @@
+# MCP Story Thème
+
+Votre assistant IA connaît le [Story Thème](https://story-theme.com) par cœur — chaque section, chaque bloc, chaque réglage — et construit des boutiques Shopify propres et professionnelles, sans jamais produire un fichier que Shopify refuserait.
+
+Réservé aux titulaires d'une licence Story Thème. Le jeton se génère dans l'espace membre : **Story Thème > MCP & Appli**.
+
+```
+Vous : « Crée la boutique Maison Lumen : bougies parfumées coulées à la main à Lyon. »
+IA   : couleurs, polices, accueil de 9 sections, fiche produit, collection, pages Notre
+       histoire / Comment utiliser / Contact / FAQ / Suivi, thème traduit, démos retirées,
+       zip prêt à importer — puis trois questions pour affiner.
+```
+
+## Installation
+
+Node 20 ou plus ([nodejs.org](https://nodejs.org)).
+
+**Claude (application)** — Réglages > Développeur > Modifier la configuration, puis dans `claude_desktop_config.json` :
+
+```json
+{
+  "mcpServers": {
+    "story-theme": {
+      "command": "npx",
+      "args": ["-y", "story-theme-mcp@latest"],
+      "env": { "STORY_MCP_TOKEN": "VOTRE_JETON" }
+    }
+  }
+}
+```
+
+**Claude Code** :
+
+```bash
+claude mcp add story-theme --scope user -e STORY_MCP_TOKEN=VOTRE_JETON -- npx -y story-theme-mcp@latest
+```
+
+Redémarrez, puis demandez : *« Sur quelle version du Story Thème travailles-tu ? »*
+
+Le mode d'emploi complet, avec les cas de dépannage : **https://story-theme.com/mcp**
+
+## Toujours la dernière version du thème
+
+Le MCP ne contient pas le thème : au démarrage, il demande à l'espace membre la **dernière version publiée**, la télécharge une fois et la garde en cache. Une version sort, il la prend au démarrage suivant — rien à réinstaller. Hors ligne, il travaille sur la version en cache. Les comptes testeurs reçoivent la version en test (`STORY_MCP_CANAL=test`).
+
+`theme_source` dit d'où vient le thème et vérifie les mises à jour à la demande.
+
+## Ce qu'il fait
+
+| Étape | Outils |
+|---|---|
+| Connaître le thème | `get_started`, `theme_source`, `search_theme`, `list_sections`, `get_section`, `list_blocks`, `get_block`, `get_theme_settings`, `get_theme_template`, `read_guide` |
+| Concevoir | `recipes` (15 compositions de pages), `generate_color_schemes`, `check_contrast`, `find_fonts` |
+| Construire vite | `build_store` : la V1 complète d'une boutique en un appel (direction artistique, pages de marque, moments signature, textes, traduction, zip) |
+| Composer librement | `compose_page` : n'importe quelle page avec toutes les sections du thème, en donnant seulement le contenu (titre, texte, boutons, étapes, cartes, questions, chiffres…) |
+| Construire | `create_project`, `update_brief`, `apply_recipe`, `localize_template`, `list_texts`, `edit_template`, `write_file`, `update_theme_settings`, `read_file`, `exclude_template` |
+| Contrôler | `validate_json`, `review_project`, `undo`, `revert_file` |
+| Livrer | `export_theme` (zip à importer + check-list), `import_theme` (auditer un thème téléchargé d'une boutique) |
+
+Prompts prêts à l'emploi : `creer-boutique`, `refaire-une-page`, `auditer-un-theme`. Les guides sont aussi exposés en ressources (`storytheme://guides/<sujet>`).
+
+## Garde-fous
+
+- **Aucun fichier invalide n'est enregistré.** Chaque modèle, groupe de sections et `settings_data.json` est validé contre les vrais schémas du thème : types de sections et de blocs, blocs privés, blocs statiques et leurs identifiants, réglages (identifiant, type, options, bornes et pas des curseurs), texte riche, liens, images, palettes, polices de la bibliothèque Shopify, limites Shopify (25 sections, 50 blocs, 8 niveaux). Les erreurs proposent la bonne orthographe (« vouliez-vous dire banner ? »).
+- **Plus strict que Shopify Theme Check** : sur un même fichier piégé, Theme Check ne voit que le bloc interdit ; le MCP refuse aussi le réglage inconnu et la valeur hors limites.
+- **Revue design** : textes d'exemple ou en anglais laissés sur une boutique française, faux avis et faux chiffres des presets, bouton sans lien, plusieurs `<h1>`, contrastes insuffisants (WCAG AA, boutons compris), polices dépréciées par Shopify (Futura → Jost…), compte à rebours qui redémarre et stock simulé (pratiques commerciales trompeuses), pop-ups multiples, rythme des palettes.
+- **Jamais le code du thème**, jamais une boutique en ligne : seuls `templates/*.json`, `sections/<groupe>.json` et `config/settings_data.json` sont modifiables, dans un dossier de projet.
+- **Historique** : chaque écriture est précédée d'un instantané ; `undo` revient en arrière autant de fois que nécessaire.
+- **Export bloqué** tant qu'une erreur bloquante reste ; signalé « pas prêt à publier » tant qu'un point 🔴 reste.
+
+## Variables
+
+| Variable | Défaut | Rôle |
+|---|---|---|
+| `STORY_MCP_TOKEN` | — | Jeton personnel (espace membre > MCP & Appli). Vérifie la licence et donne accès au thème publié. |
+| `STORY_MCP_HOME` | `~/Documents/Story Theme MCP` | Projets, historique, exports, cache du thème. |
+| `STORY_MCP_LANGUAGE` | `fr` | Langue par défaut des projets et des textes. |
+| `STORY_MCP_CANAL` | `stable` | `test` pour la version en test du thème (comptes testeurs). |
+| `STORY_THEME_DIR` | — | Dossier de thème local, **prioritaire** sur le thème publié. Pour développer le thème lui-même. |
+| `STORY_MCP_API` | `https://story-theme.com` | Espace membre interrogé. |
+
+## Déroulé type
+
+1. **Premier message** (« Crée la boutique X, qui vend Y ») : l'IA appelle `build_store` sans poser de question. En un appel : couleurs et polices selon le style, accueil de 8 à 10 sections, fiche produit, collection, pages à propos / contact / FAQ / suivi, reste du thème traduit, démos retirées, textes clés de la marque placés, zip exporté.
+   - **Photos** : avec un connecteur Shopify, l'IA copie d'abord 3 à 6 belles photos de la boutique dans Contenu > Fichiers (`fileCreate`) et les passe à `build_store` (`images`) : héro, histoire, ambiance. Seules les photos de 1600 px de large ou plus (`images.large`) vont en plein écran : une petite photo n'est jamais étirée. Sans photo : héro typographique sur la couleur de marque, et les sections qui exigent des photos sont remplacées. Jamais de carré « image manquante ».
+   - **Preuves** : avis, note et chiffres uniquement réels (`proofs`). Sans eux, les sections d'avis, de chiffres et de presse sont remplacées par des sections factuelles ou catalogue, pas supprimées.
+   - **Direction artistique** (`direction`) : editorial, minimal, organique, artisan, douceur, pop, energie, tech. Chacune règle arrondis, boutons, survols, transitions de page, formes de séparation animées et polices.
+   - **Moments signature** (selon la direction et `copy`) : manifeste qui s'illumine au défilement, mots qui tournent dans le titre, cartes empilées, étapes de fabrication.
+   - **Pages de marque** créées d'office : Notre histoire (`page.story`) et Comment utiliser (`page.utilisation`).
+2. Elle résume la V1, donne le zip, puis pose 3 à 5 questions (collection principale, avis réels, conditions de livraison, couleur et logo, photos).
+3. Chaque réponse s'applique au **projet en cours**, sans le re-préciser.
+4. `review_project`, puis `export_theme` pour un nouveau zip.
+5. Dans Shopify : Boutique en ligne > Thèmes > Ajouter un thème > Importer un fichier zip, vérifier dans l'éditeur, suivre la check-list, publier.
+
+## Limites
+
+Pas de connexion à une boutique : le MCP fabrique un thème à importer, il ne publie rien et ne crée ni produits, ni collections, ni menus, ni images, ni réductions (la check-list les liste). Il ne remplace pas une vérification visuelle dans l'éditeur Shopify.
+
+## Développement (New Story)
+
+```bash
+npm test          # validateur, presets, recettes, couleurs, polices, projets, export, source, serveur MCP
+npm run check     # après une mise à jour du thème : presets, recettes et descriptions toujours valides ?
+npm run fonts     # recharge la bibliothèque de polices Shopify (shopify.dev)
+```
+
+Avec `STORY_THEME_DIR` sur le dépôt du thème, le MCP lit le thème en cours d'écriture et n'appelle pas l'espace membre. Les connaissances rédigées à la main vivent dans `src/knowledge/` ; tout le reste vient du thème.
+
+Publication : `npm version <x.y.z>` (mettre à jour `src/version.js` à l'identique), `npm publish` — `prepublishOnly` vérifie l'ensemble.
+
+## Licence
+
+Propriétaire — voir [LICENSE](LICENSE). Réservé aux licences Story Thème actives.

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "story-theme-mcp",
+  "version": "1.0.0",
+  "description": "Serveur MCP du Story Thème : votre assistant IA connaît le thème Shopify Story par cœur et construit des boutiques propres et professionnelles.",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "story-theme-mcp": "src/index.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "test": "node --test test/*.test.js",
+    "check": "node scripts/check-theme.js",
+    "fonts": "node scripts/fetch-fonts.js",
+    "prepublishOnly": "npm test && node scripts/check-release.js"
+  },
+  "author": "New Story (SAS NS GROUP) <contact@story-theme.com>",
+  "license": "SEE LICENSE IN LICENSE",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "fflate": "^0.8.3",
+    "zod": "^4.6.5"
+  },
+  "keywords": [
+    "mcp",
+    "modelcontextprotocol",
+    "shopify",
+    "shopify-theme",
+    "story-theme",
+    "ia",
+    "claude"
+  ],
+  "homepage": "https://story-theme.com/mcp",
+  "bugs": {
+    "url": "https://story-theme.com/contact",
+    "email": "contact@story-theme.com"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/build/compose.js

@@ -0,0 +1,356 @@
+import { sectionFromPreset, blockFromPreset, createIdFactory, collectIds } from './scaffold.js';
+import { imageRef } from './quick-shared.js';
+import { closest } from '../theme/catalog.js';
+
+const clone = (value) => JSON.parse(JSON.stringify(value));
+const escapeHtml = (text) => String(text ?? '').replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+
+// Plain text in, theme rich text out: **word** becomes bold (the theme's heading styles colour
+// bold words), blank lines split paragraphs.
+export const inline = (text) => escapeHtml(text).replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>');
+// Plain text settings (labels, accordion titles, eyebrows) cannot hold bold: the stars go.
+export const plain = (text) => escapeHtml(String(text ?? '').replace(/\*\*(.+?)\*\*/g, '$1'));
+export const paragraphs = (text) =>
+  String(text ?? '')
+    .split(/\n\s*\n/)
+    .map((part) => part.trim())
+    .filter(Boolean)
+    .map((part) => `<p>${inline(part).replace(/\n/g, '<br>')}</p>`)
+    .join('');
+
+// Blocks that repeat inside a section and carry one item of content each.
+const ITEM_TYPES = ['_timeline-step', '_scroll-card', '_story-step', '_slide', 'accordion', 'testimonial', 'counter', 'progress-bar', '_spec-row', '_comparison-row', '_hotspot', '_gallery-item', '_story', '_logo', '_marquee-image', '_trust-badge', '_ugc-item'];
+const HERO_TYPES = new Set(['banner', 'slideshow', 'scroll-zoom', 'video']);
+
+function* walk(node, parent = null, id = null) {
+  if (id) yield { id, block: node, parent };
+  const ids = [...Object.keys(node.blocks || {}).filter((key) => node.blocks[key].static), ...(node.block_order || [])];
+  for (const key of ids) if (node.blocks?.[key]) yield* walk(node.blocks[key], node, key);
+}
+
+const within = (entries, roots) => entries.filter(({ block }) => !roots.some((root) => root !== block && [...walk(root)].some((entry) => entry.block === block)));
+
+function remove(parent, id) {
+  delete parent.blocks[id];
+  parent.block_order = (parent.block_order || []).filter((item) => item !== id);
+}
+
+// A 4.0 testimonial carries its content in child blocks: a `text` block for the review
+// (preceded, in some presets, by a second bold `text` used as a title) and a
+// `_testimonial-author` for the name, role and photo. The old `testimonial.settings.text`
+// no longer exists: writing it made the validator reject the WHOLE page (all or nothing),
+// which then stayed in sample copy — fake reviews signed "Thomas R." included.
+export function writeTestimonial(block, { text, title, name, role, image } = {}) {
+  const children = (block.block_order || [])
+    .map((id) => ({ id, child: block.blocks?.[id] }))
+    .filter((entry) => entry.child);
+  const texts = children.filter((entry) => entry.child.type === 'text');
+  const author = children.find((entry) => entry.child.type === '_testimonial-author');
+
+  // A theme older than the child-block testimonial: its settings are still on the block.
+  if (!texts.length && !author) {
+    block.settings = { ...(block.settings || {}) };
+    if (text) block.settings.text = paragraphs(text);
+    if (name) block.settings.name = plain(name);
+    if (role) block.settings.role = plain(role);
+    if (title && title !== name) block.settings.title = plain(title);
+    if (image) block.settings.image = imageRef(image);
+    return;
+  }
+
+  const body = texts[texts.length - 1];
+  const heading = texts.length > 1 ? texts[texts.length - 2] : null;
+  if (body && text) body.child.settings = { ...(body.child.settings || {}), description: paragraphs(text) };
+  if (heading) {
+    // A sample title ("Au-delà de mes attentes") must not crown a real review.
+    if (title && title !== name) heading.child.settings = { ...(heading.child.settings || {}), description: `<p><strong>${inline(title)}</strong></p>` };
+    else remove(block, heading.id);
+  }
+  if (author) {
+    const settings = { ...(author.child.settings || {}) };
+    if (name) settings.name = plain(name);
+    // The default role ("Acheteuse vérifiée") is a claim: kept only when the merchant gives one.
+    settings.role = role ? plain(role) : '';
+    if (image) settings.avatar = imageRef(image);
+    author.child.settings = settings;
+  }
+}
+
+const holds = (block, type) => [...walk(block)].some((entry) => entry.block.type === type);
+const leafGroup = (block) => block.type === 'group' && ![...walk(block)].some((entry) => entry.block.type === 'group');
+const signature = (block) => (block.block_order || []).map((id) => block.blocks?.[id]?.type).join('+');
+
+// The biggest set of sibling entries sharing the same key, when there are at least two.
+function largestSiblings(entries, keyOf) {
+  const sets = new Map();
+  for (const entry of entries) {
+    const key = `${keyOf(entry.block)}`;
+    const bucket = sets.get(entry.parent) || new Map();
+    bucket.set(key, [...(bucket.get(key) || []), entry]);
+    sets.set(entry.parent, bucket);
+  }
+  const best = [...sets.values()].flatMap((bucket) => [...bucket.values()]).sort((a, b) => b.length - a.length)[0] || [];
+  return best.length > 1 ? best : [];
+}
+
+// The repeated items of a section: its most frequent item block type, else groups holding a
+// heading (columns, benefits), else alike groups of an image and a caption (horizontal gallery).
+function findItems(section) {
+  const entries = [...walk(section)];
+  const counts = new Map();
+  for (const { block } of entries) if (ITEM_TYPES.includes(block.type)) counts.set(block.type, (counts.get(block.type) || 0) + 1);
+  const type = [...counts.entries()].sort((a, b) => b[1] - a[1])[0]?.[0];
+  if (type) return entries.filter(({ block }) => block.type === type);
+  const titled = largestSiblings(entries.filter(({ block }) => block.type === 'group' && holds(block, 'heading') && ![...walk(block)].slice(1).some((entry) => entry.block.type === 'group')), () => '');
+  if (titled.length) return titled;
+  return largestSiblings(entries.filter(({ block }) => leafGroup(block) && (holds(block, 'image') || holds(block, 'text'))), signature);
+}
+
+function refreshIds(block, nextId) {
+  if (!block.blocks) return block;
+  const mapping = {};
+  const blocks = {};
+  for (const [id, child] of Object.entries(block.blocks)) {
+    const fresh = child.static ? id : nextId(child.type);
+    mapping[id] = fresh;
+    blocks[fresh] = refreshIds(child, nextId);
+  }
+  block.blocks = blocks;
+  if (block.block_order) block.block_order = block.block_order.map((id) => mapping[id] || id);
+  return block;
+}
+
+function setOption(catalog, block, key, value, notes) {
+  const setting = (catalog.block(block.type)?.schema?.settings || []).find((item) => item.id === key);
+  if (!setting || value === undefined || value === null || value === '') return;
+  const options = (setting.options || []).map((option) => option.value);
+  if (!options.length || options.includes(value)) {
+    block.settings[key] = value;
+    return;
+  }
+  const hint = closest(String(value), options, 1)[0];
+  notes.push(`icône « ${value} » absente de la bibliothèque du thème${hint ? ` : « ${hint} » utilisée` : ' : ignorée'}`);
+  if (hint) block.settings[key] = hint;
+}
+
+const firstOf = (node, type) => [...walk(node)].find((entry) => entry.block.type === type);
+
+// One item of content into one item block, whatever its kind.
+function fillItem(catalog, entry, item, notes) {
+  const { block } = entry;
+  block.settings = block.settings || {};
+  const content = typeof item === 'string' ? { title: item } : item;
+  const title = content.title ?? content.question ?? content.name ?? content.label;
+  const text = content.text ?? content.answer;
+  switch (block.type) {
+    case '_timeline-step':
+      if (content.label !== undefined) block.settings.label = plain(content.label);
+      if (content.title) block.settings.title = inline(content.title);
+      if (text) block.settings.text = paragraphs(text);
+      if (content.image) block.settings.image = imageRef(content.image);
+      setOption(catalog, block, 'icon', content.icon, notes);
+      return;
+    case 'accordion':
+      if (title) block.settings.heading = plain(title);
+      if (text) block.settings.content = paragraphs(text);
+      setOption(catalog, block, 'icon', content.icon, notes);
+      return;
+    case 'testimonial':
+      writeTestimonial(block, { text, title: content.title, name: content.name, role: content.role, image: content.image });
+      return;
+    case 'counter':
+      if (content.value) block.settings.heading = plain(content.value);
+      if (content.label || content.title) block.settings.subheading = plain(content.label || content.title);
+      if (text) block.settings.description = inline(text);
+      setOption(catalog, block, 'icon', content.icon, notes);
+      return;
+    case 'progress-bar':
+      if (content.value !== undefined) block.settings.value = Math.max(0, Math.min(100, Math.round(Number(content.value))));
+      if (content.label || content.title) block.settings.label = inline(content.label || content.title);
+      if (text) block.settings.sublabel = inline(text);
+      return;
+    case '_spec-row':
+      if (content.label || content.title) block.settings.label = plain(content.label || content.title);
+      if (content.value || text) block.settings.value = inline(content.value || text);
+      setOption(catalog, block, 'icon', content.icon, notes);
+      return;
+    case '_comparison-row':
+      if (content.label || content.title) block.settings.label = inline(content.label || content.title);
+      (content.values || []).forEach((value, index) => {
+        const key = `value_${index + 1}`;
+        if (value === true || value === false) block.settings[`${key}_type`] = value ? 'check' : 'cross';
+        else {
+          block.settings[`${key}_type`] = 'text';
+          block.settings[key] = inline(value);
+        }
+      });
+      return;
+    case '_hotspot':
+      if (content.title) block.settings.title = inline(content.title);
+      if (text) block.settings.text = paragraphs(text);
+      if (content.product) block.settings.product = content.product;
+      setOption(catalog, block, 'marker_icon', content.icon, notes);
+      return;
+    case '_gallery-item':
+    case '_marquee-image':
+    case '_logo':
+    case '_ugc-item':
+      if (content.image) block.settings.image = imageRef(content.image);
+      if (content.title && block.type === '_gallery-item') block.settings.caption = inline(content.title);
+      if (content.title && block.type === '_logo') block.settings.name = plain(content.title);
+      if (content.link) block.settings.link = content.link;
+      return;
+    case '_story':
+      if (content.image) block.settings.image = imageRef(content.image);
+      if (content.title) block.settings.title = plain(content.title);
+      if (content.link) block.settings.link = content.link;
+      return;
+    default: {
+      // Containers (scroll cards, story steps, slides, columns): their heading, text, button,
+      // icon and image blocks.
+      const heading = firstOf(block, 'heading');
+      if (heading && title) heading.block.settings = { ...(heading.block.settings || {}), title: `<p>${inline(title)}</p>` };
+      const body = firstOf(block, 'text');
+      // No heading (a captioned photo): the title opens the text, in bold.
+      const caption = !heading && title ? `**${String(title).replace(/\*\*/g, '')}**${text ? `\n${text}` : ''}` : text;
+      if (body && caption) body.block.settings = { ...(body.block.settings || {}), description: paragraphs(caption) };
+      else if (body && !caption && content.title) remove(body.parent, body.id);
+      const button = firstOf(block, 'button');
+      if (button) {
+        if (content.button?.label) button.block.settings = { ...(button.block.settings || {}), button_text: inline(content.button.label), button_link: content.button.link || button.block.settings?.button_link || '' };
+        else remove(button.parent, button.id);
+      }
+      const icon = firstOf(block, 'icon');
+      if (icon && content.icon) setOption(catalog, icon.block, 'icon', content.icon, notes);
+      const image = firstOf(block, 'image');
+      if (image && content.image) image.block.settings = { ...(image.block.settings || {}), image: imageRef(content.image) };
+      else if (image && !block.settings.image) remove(image.parent, image.id);
+      if (content.image && ['_story-step', '_slide'].includes(block.type)) block.settings.image = imageRef(content.image);
+      if (content.palette && (catalog.block(block.type)?.schema?.settings || []).some((setting) => setting.id === 'color_scheme')) block.settings.color_scheme = content.palette;
+    }
+  }
+}
+
+function colorSettingOf(catalog, section) {
+  const settings = catalog.section(section.type)?.schema?.settings || [];
+  const ids = HERO_TYPES.has(section.type) ? ['frame_palette', 'color_palette', 'color_scheme'] : ['color_palette', 'color_scheme', 'frame_palette'];
+  return ids.find((id) => settings.some((setting) => setting.id === id && setting.type === 'color_scheme')) || null;
+}
+
+const hasSetting = (catalog, section, id) => (catalog.section(section.type)?.schema?.settings || []).some((setting) => setting.id === id);
+
+// Fills a section from a content spec. Returns notes about what could not be placed.
+export function fillSection(catalog, section, spec, { nextId, h1 = false } = {}) {
+  const notes = [];
+  const content = spec.content || {};
+  section.settings = section.settings || {};
+  for (const { block } of walk(section)) block.settings = block.settings || {};
+
+  // Manifesto: a statement that lights up word by word on scroll.
+  if (content.manifesto) {
+    for (const { id, parent } of [...walk(section)].filter(({ parent: owner }) => owner === section)) remove(parent, id);
+    const { id, block } = blockFromPreset(catalog, 'text-reveal', { taken: new Set(), id: nextId('text_reveal') });
+    block.settings = { ...block.settings, text: inline(content.manifesto), alignment: 'center' };
+    section.blocks = { ...(section.blocks || {}), [id]: block };
+    section.block_order = [...(section.block_order || []), id];
+  }
+
+  const photos = [...(spec.images || [])];
+  const items = content.items?.length ? findItems(section) : [];
+  if (content.items?.length && !items.length) notes.push(`${section.type} : pas d'éléments répétables, liste ignorée`);
+  if (items.length) {
+    const last = items[items.length - 1];
+    while (items.length < content.items.length) {
+      const copy = refreshIds(clone(last.block), nextId);
+      const id = nextId(copy.type);
+      last.parent.blocks[id] = copy;
+      const order = last.parent.block_order || [];
+      order.splice(order.indexOf(items[items.length - 1].id) + 1, 0, id);
+      last.parent.block_order = order;
+      items.push({ id, block: copy, parent: last.parent });
+    }
+    items.slice(content.items.length).forEach(({ id, parent }) => remove(parent, id));
+    items.slice(0, content.items.length).forEach((entry, index) => {
+      // Items holding an image take the section photos in order when they bring none.
+      const item = typeof content.items[index] === 'string' ? { title: content.items[index] } : content.items[index];
+      const withPhoto = !item.image && photos.length && firstOf(entry.block, 'image') ? { ...item, image: photos.shift() } : item;
+      fillItem(catalog, entry, withPhoto, notes);
+    });
+  }
+
+  // Texts of the section itself, outside its items.
+  const roots = items.map((entry) => entry.block);
+  const outside = within([...walk(section)], roots).filter(({ block }) => !roots.includes(block));
+  const heading = outside.find(({ block }) => block.type === 'heading');
+  if (heading) {
+    const tag = content.title_tag || (h1 ? 'h1' : 'p');
+    if (content.title) heading.block.settings.title = `<${tag}>${inline(content.title)}</${tag}>`;
+    if (content.eyebrow !== undefined) heading.block.settings.subheading = plain(content.eyebrow);
+    if (content.rotating_words?.length) heading.block.settings.rotating_words = content.rotating_words.map(plain).join('\n');
+  }
+  const text = outside.find(({ block }) => block.type === 'text');
+  if (text && content.text) text.block.settings.description = paragraphs(content.text);
+  else if (text && content.text === '') remove(text.parent, text.id);
+  if (content.buttons) {
+    const buttons = outside.filter(({ block }) => block.type === 'button');
+    buttons.forEach(({ id, block, parent }, index) => {
+      const button = content.buttons[index];
+      if (!button) return remove(parent, id);
+      block.settings.button_text = inline(button.label);
+      if (button.link) block.settings.button_link = button.link;
+      if (button.style) block.settings.button_style = String(button.style);
+    });
+  }
+  // Strings lists into scrolling text and check lists.
+  if (content.lines?.length) {
+    for (const { block } of outside) {
+      if (block.type === 'marquee-text') block.settings.text_items = content.lines.map(plain).join('\n');
+      if (block.type === 'checklist') block.settings.items_rich = content.lines.map((line) => `<p>${inline(line)}</p>`).join('');
+    }
+  }
+
+  // Media and look of the section.
+  if (spec.image && hasSetting(catalog, section, 'image')) {
+    section.settings.image = imageRef(spec.image);
+    if (hasSetting(catalog, section, 'media_type')) section.settings.media_type = 'image';
+  }
+  if (spec.image_mobile && hasSetting(catalog, section, 'image_mobile')) section.settings.image_mobile = imageRef(spec.image_mobile);
+  if (spec.images?.length) {
+    for (const { block, id, parent } of [...walk(section)].filter(({ block }) => block.type === 'image' && !block.settings?.image)) {
+      if (photos.length) block.settings = { ...(block.settings || {}), image: imageRef(photos.shift()) };
+      else remove(parent, id);
+    }
+  }
+  const colorKey = colorSettingOf(catalog, section);
+  if (spec.palette && colorKey) section.settings[colorKey] = spec.palette;
+  if (spec.separator) {
+    for (const edge of ['top', 'bottom']) if (spec.separator[edge] && hasSetting(catalog, section, `separator_${edge}`)) section.settings[`separator_${edge}`] = spec.separator[edge];
+    if (spec.separator.animation && hasSetting(catalog, section, 'separator_animation')) section.settings.separator_animation = spec.separator.animation;
+    if (spec.separator.flip && hasSetting(catalog, section, 'separator_bottom_flip')) section.settings.separator_bottom_flip = true;
+  }
+  if (spec.settings) Object.assign(section.settings, spec.settings);
+  return notes;
+}
+
+// Builds sections from specs: preset, content, media, palette, separators.
+export function composeSections(catalog, specs, { language = 'fr', data = { sections: {}, order: [] }, h1First = true } = {}) {
+  const result = clone(data);
+  result.sections = result.sections || {};
+  result.order = result.order || [];
+  const taken = collectIds(result);
+  const nextId = createIdFactory(taken);
+  const notes = [];
+  let h1Used = JSON.stringify(result).includes('<h1');
+  for (const spec of specs) {
+    const base = spec.type.replace(/[^A-Za-z0-9]+/g, '_');
+    let wanted = spec.id || base;
+    for (let index = 2; taken.has(wanted); index++) wanted = `${spec.id || base}_${index}`;
+    const { id, section } = sectionFromPreset(catalog, spec.type, { preset: spec.preset, language, taken, id: wanted });
+    const h1 = h1First && !h1Used && Boolean(spec.content?.title) && !spec.content?.title_tag;
+    notes.push(...fillSection(catalog, section, spec, { nextId, h1 }).map((note) => `${id} : ${note}`));
+    if (h1) h1Used = true;
+    result.sections[id] = section;
+    result.order.push(id);
+  }
+  return { data: result, notes };
+}