story-theme-mcp 1.0.0

package/src/build/quick.js

@@ -0,0 +1,741 @@
+import { generateColorSchemes } from './palette.js';
+import { buildFromRecipe } from './recipe.js';
+import { localizeData } from './localize.js';
+import { createIdFactory, collectIds } from './scaffold.js';
+import { findRecipe } from '../knowledge/recipes.js';
+import { FONT_PAIRINGS } from '../knowledge/fonts.js';
+import { validateFile } from '../validate/template.js';
+import { normalizeText } from '../theme/catalog.js';
+import { imageRef } from './quick-shared.js';
+import { composeSections, fillSection, inline, plain, writeTestimonial } from './compose.js';
+import { DIRECTIONS, STYLE_DIRECTION } from '../knowledge/directions.js';
+import { checkValue } from '../validate/values.js';
+
+const clone = (value) => JSON.parse(JSON.stringify(value));
+
+// A style picks sensible defaults when the merchant has not said more: brand colour, neutrals,
+// font pairing and home page recipe.
+export const STYLES = {
+  essentiel: { label: 'polyvalent', color: '#2F4B3A', neutral: 'tinted', fonts: 'clean-sans', home: 'accueil-essentiel' },
+  premium: { label: 'premium, luxe', color: '#2B2622', neutral: 'warm', fonts: 'editorial', home: 'accueil-marque-premium' },
+  mode: { label: 'mode, prêt-à-porter', color: '#1A1A1A', neutral: 'pure', fonts: 'fashion-sans', home: 'accueil-marque-premium' },
+  beaute: { label: 'beauté, soin, bien-être', color: '#A45C68', neutral: 'warm', fonts: 'soft-modern', home: 'accueil-beaute' },
+  nature: { label: 'naturel, artisanal, épicerie', color: '#3F5A3C', neutral: 'warm', fonts: 'natural', home: 'accueil-artisan' },
+  maison: { label: 'maison, déco, grand catalogue', color: '#7A5C44', neutral: 'warm', fonts: 'minimal', home: 'accueil-catalogue' },
+  tech: { label: 'tech, accessoires', color: '#2F5BEA', neutral: 'cool', fonts: 'tech', home: 'accueil-produit-phare' },
+  sport: { label: 'sport, énergie', color: '#D8432B', neutral: 'pure', fonts: 'bold-sport', home: 'accueil-essentiel' },
+  enfant: { label: 'enfants, animaux, ludique', color: '#E08A2E', neutral: 'warm', fonts: 'friendly', home: 'accueil-essentiel' },
+  'produit-unique': { label: 'marque d’un produit phare (DTC)', color: '#1F3A5F', neutral: 'cool', fonts: 'contemporary', home: 'accueil-produit-phare' },
+};
+
+const KEYWORDS = {
+  beaute: ['cosmet', 'beaute', 'soin', 'skincare', 'maquillage', 'parfum', 'cheveu', 'capillaire', 'bien etre', 'spa', 'serum', 'creme', 'visage', 'ongle'],
+  nature: ['bougie', 'artisan', 'fait main', 'a la main', 'epicerie', 'miel', 'the', 'cafe', 'vin', 'biere', 'chocolat', 'bio', 'terroir', 'ceramique', 'poterie', 'local', 'producteur', 'savon'],
+  maison: ['deco', 'maison', 'meuble', 'mobilier', 'linge', 'cuisine', 'jardin', 'luminaire', 'concept store', 'vaisselle'],
+  mode: ['vetement', 'mode', 'pret a porter', 'streetwear', 't shirt', 'sweat', 'robe', 'chaussure', 'sneaker', 'lingerie', 'chouchou', 'foulard', 'accessoire', 'sac'],
+  premium: ['bijou', 'joaill', 'montre', 'maroquin', 'luxe', 'haut de gamme', 'cachemire', 'soie'],
+  tech: ['tech', 'electroni', 'gadget', 'telephone', 'iphone', 'audio', 'casque', 'informatique', 'gaming'],
+  sport: ['sport', 'fitness', 'musculation', 'running', 'yoga', 'velo', 'outdoor', 'proteine', 'nutrition sportive'],
+  enfant: ['enfant', 'bebe', 'jouet', 'puericulture', 'animal', 'animaux', 'chien', 'chat', 'kids'],
+};
+
+// The style whose keywords appear most in the activity (ties go to the first listed).
+export function inferStyle(activity) {
+  const text = ` ${normalizeText(activity)} `;
+  let best = 'essentiel';
+  let bestScore = 0;
+  for (const [style, words] of Object.entries(KEYWORDS)) {
+    const score = words.filter((word) => text.includes(` ${word}`)).length;
+    if (score > bestScore) [best, bestScore] = [style, score];
+  }
+  return best;
+}
+
+const PAGE_RECIPES = { contact: 'page-contact', faq: 'page-faq', suivi: 'page-suivi-commande' };
+export const BRAND_PAGES = { 'a-propos': 'templates/page.story.json', utilisation: 'templates/page.utilisation.json' };
+const DEFAULT_PAGES = ['a-propos', 'utilisation', 'contact', 'faq', 'suivi'];
+const DEMO_TEMPLATES = ['templates/product.offers-bogo.json', 'templates/product.offers-bundle.json', 'templates/product.offers-minimal.json', 'templates/product.offers-packs.json', 'templates/product.offers-quantity.json', 'templates/product.offers-subscription.json', 'templates/page.help.json', 'templates/page.landing.json'];
+const HERO_TYPES = ['banner', 'slideshow', 'video'];
+
+// ---- brand copy placed into the built pages
+
+function* inOrder(node) {
+  const ids = [...Object.keys(node.blocks || {}).filter((id) => node.blocks[id].static), ...(node.block_order || [])];
+  for (const id of ids) {
+    const block = node.blocks?.[id];
+    if (!block) continue;
+    yield { id, block, parent: node };
+    yield* inOrder(block);
+  }
+}
+
+const first = (node, type) => [...inOrder(node)].find((entry) => entry.block.type === type)?.block || null;
+const set = (block, key, value, counter) => {
+  if (!block || value === undefined || value === null || value === '') return;
+  block.settings = block.settings || {};
+  block.settings[key] = value;
+  counter.count += 1;
+};
+
+function removeBlock(parent, id) {
+  delete parent.blocks[id];
+  parent.block_order = (parent.block_order || []).filter((item) => item !== id);
+}
+
+// ---- the theme's demo showcase, which a merchant store must not inherit
+
+// Templates of the demo store's section catalogue (collection.sections-banners…): useful to
+// browse the theme, meaningless in a merchant's store where they show up in the admin.
+const SHOWCASE_TEMPLATE = /^templates\/[^/]+\.sections-[^/]+\.json$/;
+// Links into that catalogue (/collections/all?view=sections-…).
+const SHOWCASE_LINK = /[?&]view=sections-/;
+
+const linksShowcase = (node) => [...inOrder(node)].some(({ block }) =>
+  Object.values(block.settings || {}).some((value) => typeof value === 'string' && SHOWCASE_LINK.test(value)));
+
+// Removes what the theme ships for its own demo store: the catalogue templates, the footer
+// navigation into them, and product lists naming the demo store's products (casquette-3,
+// pull-2…), which do not exist in the merchant's catalogue. Every merchant build inherited
+// them: a "Browse all sections" footer, and a cart upsell with nothing to show.
+// Product handles named by the theme's own files: the demo store's catalogue. A merchant
+// never has them, so a list made only of them is a demo leftover, whatever file it is in
+// (after translation, cart.json is a project file but still names casquette-3).
+function demoProductHandles(catalog) {
+  const handles = new Set();
+  for (const [, data] of [...catalog.theme.templates, ...catalog.theme.groups]) {
+    for (const section of Object.values(data?.sections || {})) {
+      for (const { block } of inOrder(section)) {
+        if (Array.isArray(block.settings?.products)) block.settings.products.forEach((handle) => handles.add(handle));
+      }
+    }
+  }
+  return handles;
+}
+
+export function stripShowcase(catalog, store, slug, { collections = [] } = {}) {
+  const removed = [];
+  const demoProducts = demoProductHandles(catalog);
+  for (const [rel, entry] of store.effectiveFiles(slug)) {
+    if (SHOWCASE_TEMPLATE.test(rel)) {
+      if (!store.excluded(slug).includes(rel)) { store.setExcluded(slug, rel, true); removed.push(rel); }
+      continue;
+    }
+    if (!entry.data?.sections) continue;
+    const data = clone(entry.data);
+    let changed = false;
+
+    for (const id of [...(data.order || [])]) {
+      const section = data.sections[id];
+      if (!section) continue;
+      if (linksShowcase(section)) {
+        delete data.sections[id];
+        data.order = data.order.filter((item) => item !== id);
+        removed.push(`${rel} › ${id}`);
+        changed = true;
+        continue;
+      }
+      // A list naming only the demo store's products: let Shopify recommend from the cart
+      // instead, with the main collection as a fallback.
+      for (const { block } of inOrder(section)) {
+        const list = block.settings?.products;
+        if (block.settings?.source !== 'products' || !Array.isArray(list) || !list.length) continue;
+        if (!list.every((handle) => demoProducts.has(handle))) continue;
+        const choices = (catalog.block(block.type)?.schema?.settings || []).find((setting) => setting.id === 'source')?.options?.map((option) => option.value) || [];
+        const settings = { ...block.settings, products: [] };
+        if (choices.includes('recommendations')) settings.source = 'recommendations';
+        else if (choices.includes('collection') && collections[0]) settings.source = 'collection';
+        else continue;
+        if (collections[0]) settings.collection = collections[0];
+        block.settings = settings;
+        removed.push(`${rel} › ${block.type} (produits de démo)`);
+        changed = true;
+      }
+    }
+
+    if (changed && validateFile(catalog, rel, data).ok) store.write(slug, rel, data, 'V1 : vitrine de démo retirée');
+  }
+  return removed;
+}
+
+// Fills the key texts of a page from the brand copy. Returns how many settings were written.
+export function fillCopy(data, copy, { collection = null, templateType = 'index' } = {}) {
+  const counter = { count: 0 };
+  const sections = (data.order || []).map((id) => data.sections[id]).filter(Boolean);
+  const link = collection ? `shopify://collections/${collection}` : null;
+
+  if (templateType === 'index') {
+    let hero = sections.find((section) => HERO_TYPES.includes(section.type));
+    if (hero?.type === 'slideshow') hero = first(hero, '_slide') || hero;
+    if (hero) {
+      set(first(hero, 'heading'), 'title', copy.tagline && `<h1>${inline(copy.tagline)}</h1>`, counter);
+      set(first(hero, 'text'), 'description', copy.hero_text && `<p>${inline(copy.hero_text)}</p>`, counter);
+      const button = first(hero, 'button');
+      set(button, 'button_text', copy.hero_button && inline(copy.hero_button), counter);
+      if (link) set(button, 'button_link', link, counter);
+    }
+    const newsletter = sections.find((section) => section.type === 'newsletter');
+    if (newsletter) {
+      set(first(newsletter, 'heading'), 'title', copy.newsletter_title && `<p>${inline(copy.newsletter_title)}</p>`, counter);
+      set(first(newsletter, 'text'), 'description', copy.newsletter_text && `<p>${inline(copy.newsletter_text)}</p>`, counter);
+    }
+    if (collection) {
+      for (const section of sections) {
+        for (const { block } of inOrder(section)) {
+          if (block.type === 'product-list' && (block.settings?.source ?? 'collection') === 'collection') set(block, 'collection', collection, counter);
+        }
+      }
+    }
+  }
+
+  const story = sections.find((section) => section.type === 'image-with-text') || sections.find((section) => section.type === 'rich-text' && first(section, 'text'));
+  if (story) {
+    set(first(story, 'heading'), 'title', copy.brand_story_title && `<p>${inline(copy.brand_story_title)}</p>`, counter);
+    set(first(story, 'text'), 'description', copy.brand_story_text && `<p>${inline(copy.brand_story_text)}</p>`, counter);
+  }
+  const benefits = sections.find((section) => section.type === 'multicolumn');
+  if (benefits && copy.benefits?.length) {
+    const groups = [...inOrder(benefits)].filter(({ block }) => block.type === 'group' && [...inOrder(block)].some((entry) => entry.block.type === 'heading') && ![...inOrder(block)].some((entry) => entry.block.type === 'group'));
+    groups.forEach(({ id, block, parent }, index) => {
+      const item = copy.benefits[index];
+      if (!item) return removeBlock(parent, id);
+      set(first(block, 'heading'), 'title', item.title && `<p>${inline(item.title)}</p>`, counter);
+      set(first(block, 'text'), 'description', item.text && `<p>${inline(item.text)}</p>`, counter);
+    });
+  }
+
+  if (copy.reassurance?.length) {
+    for (const section of sections) {
+      for (const { block } of inOrder(section)) {
+        if (block.type === 'marquee-text') set(block, 'text_items', copy.reassurance.map(plain).join('\n'), counter);
+        if (block.type === 'checklist') {
+          set(block, 'items_rich', copy.reassurance.map((item) => `<p>${inline(item)}</p>`).join(''), counter);
+          if (block.settings.items !== undefined) block.settings.items = copy.reassurance.map(plain).join('\n');
+        }
+      }
+    }
+  }
+
+  // The big image moment (zoom on scroll): its own line, or its sample instruction goes.
+  for (const section of sections.filter((item) => item.type === 'scroll-zoom')) {
+    set(first(section, 'heading'), 'title', copy.showcase_title && `<p>${inline(copy.showcase_title)}</p>`, counter);
+    const text = [...inOrder(section)].find((entry) => entry.block.type === 'text');
+    if (text && copy.showcase_text) set(text.block, 'description', `<p>${inline(copy.showcase_text)}</p>`, counter);
+    else if (text) removeBlock(text.parent, text.id);
+  }
+
+  // Detail accordions outside the FAQ (materials, use, care): real details, or none.
+  const details = sections.filter((item) => item.type !== 'faq' && item.type !== 'main-product-composed').flatMap((section) => [...inOrder(section)].filter(({ block }) => block.type === 'accordion'));
+  details.forEach(({ id, block, parent }, index) => {
+    const item = copy.details?.[index];
+    if (!item) return removeBlock(parent, id);
+    set(block, 'heading', plain(item.title), counter);
+    set(block, 'content', `<p>${inline(item.text)}</p>`, counter);
+  });
+
+  // Sample questions state policies that may be false: replaced when real ones are given.
+  if (copy.faq?.length) {
+    for (const section of sections.filter((item) => item.type === 'faq')) {
+      const intro = [...inOrder(section)].find((entry) => entry.block.type === 'text');
+      if (intro && copy.faq_intro) set(intro.block, 'description', `<p>${inline(copy.faq_intro)}</p>`, counter);
+      else if (intro) removeBlock(intro.parent, intro.id);
+      const accordions = [...inOrder(section)].filter(({ block }) => block.type === 'accordion');
+      accordions.forEach(({ id, block, parent }, index) => {
+        const item = copy.faq[index];
+        if (!item) return removeBlock(parent, id);
+        set(block, 'heading', plain(item.question), counter);
+        set(block, 'content', `<p>${inline(item.answer)}</p>`, counter);
+      });
+    }
+  }
+  return counter.count;
+}
+
+// What an announcement talks about decides its icon and link, never the block it lands in (a
+// "shipping" block can carry a price message).
+const ANNOUNCEMENT_TOPICS = [
+  { words: ['retour', 'rembours', 'echange', 'return', 'refund', 'exchange'], icon: 'return', link: '/policies/refund-policy' },
+  { words: ['livraison', 'livre', 'expedi', 'colis', 'shipping', 'delivery'], icon: 'truck', link: '/policies/shipping-policy' },
+  { words: ['paiement', 'securise', 'payment', 'secure'], icon: 'lock', link: null },
+];
+
+export function announcementTopic(message) {
+  const text = ` ${normalizeText(message)} `;
+  return ANNOUNCEMENT_TOPICS.find((topic) => topic.words.some((word) => text.includes(` ${word}`))) || null;
+}
+
+// Announcement messages of the header group, added or removed to match the brand's list.
+export function fillAnnouncements(data, messages, { collection = null } = {}) {
+  if (!messages?.length) return 0;
+  const bar = Object.values(data.sections || {}).find((section) => section.type === 'announcement-bar');
+  const container = bar ? first(bar, '_header-announcements') : null;
+  if (!container) return 0;
+  const existing = (container.block_order || []).filter((id) => container.blocks?.[id]?.type === '_announcement');
+  const nextId = createIdFactory(collectIds(data));
+  messages.slice(0, 4).forEach((message, index) => {
+    const id = existing[index] || nextId('announcement');
+    if (!existing[index]) {
+      container.blocks[id] = { type: '_announcement', settings: {} };
+      container.block_order.push(id);
+    }
+    const settings = container.blocks[id].settings || (container.blocks[id].settings = {});
+    const topic = announcementTopic(message);
+    const link = topic ? topic.link : collection && `shopify://collections/${collection}`;
+    settings.text = inline(message);
+    settings.icon = topic?.icon || 'none';
+    if (link) settings.link = link;
+    else delete settings.link;
+  });
+  for (const id of existing.slice(messages.length)) removeBlock(container, id);
+  return Math.min(messages.length, 4);
+}
+
+// ---- assets: images the merchant already has, proofs that are real
+
+export { imageRef };
+
+// Sections a pool of brand photos can fill, and sections that need specific media (a before and
+// an after, a shoppable scene, customer photos, a film, logos) which a V1 never guesses.
+const NEEDS_IMAGE = new Set(['image-with-text', 'scroll-zoom', 'gallery']);
+// Sections that stretch one photo over the whole screen: only a photo known to be wide (images.large).
+const NEEDS_LARGE_IMAGE = new Set(['scroll-zoom']);
+const NEEDS_SPECIFIC_MEDIA = new Set(['before-after', 'hotspots', 'ugc', 'stories', 'video', 'logo-list', 'scroll-horizontal', 'scroll-story']);
+const PROOF_SECTIONS = new Set(['testimonials', 'reviews', 'stats', 'ugc', 'logo-list']);
+
+function hasProof(type, proofs) {
+  if (type === 'testimonials') return Boolean(proofs.testimonials?.length);
+  if (type === 'reviews') return Boolean(proofs.rating || proofs.testimonials?.length);
+  if (type === 'stats') return Boolean(proofs.figures?.length);
+  return false;
+}
+
+// Rewrites a recipe for what the store really has: no grey placeholder when there is no photo,
+// no invented review, press or figure, and a home page that stays full (8 to 10 sections).
+export function adaptSteps(steps, { templateType, hasImages, hasLarge = hasImages, proofs, collections }) {
+  const out = [];
+  const planned = steps.map((step) => `${step.type}|${step.preset}`);
+  const has = (type, preset) => out.some((step) => step.type === type && (!preset || step.preset === preset)) || (preset && planned.includes(`${type}|${preset}`));
+  const filler = () =>
+    [
+      { type: 'multicolumn', preset: 'Icons with text', role: 'Bénéfices concrets du produit' },
+      { type: 'faq', preset: 'FAQ', role: 'Questions qui freinent l’achat' },
+      templateType === 'index' && collections.length > 1 ? { type: 'product-list', preset: 'Product carousel', role: `Sélection : ${collections[1]}`, collectionIndex: 1 } : null,
+      templateType === 'index' ? { type: 'product-list', preset: 'Product carousel', role: 'Nouveautés', source: 'all' } : null,
+      templateType === 'index' ? { type: 'collection-list', preset: 'Collection grid', role: 'Toutes les collections' } : null,
+    ]
+      .filter(Boolean)
+      .find((candidate) => !has(candidate.type, candidate.preset));
+
+  for (const original of steps) {
+    let step = { ...original };
+    if (step.type === 'banner') {
+      step.hero = true;
+      if (step.preset === 'Video banner') step.preset = 'Image banner';
+    } else if (PROOF_SECTIONS.has(step.type) && !hasProof(step.type, proofs)) {
+      step = filler();
+    } else if (NEEDS_SPECIFIC_MEDIA.has(step.type) || (NEEDS_IMAGE.has(step.type) && !hasImages) || (NEEDS_LARGE_IMAGE.has(step.type) && !hasLarge)) {
+      if (step.type === 'image-with-text') {
+        step = templateType === 'product' ? (has('multicolumn') ? filler() : { type: 'multicolumn', preset: 'Icons with text', role: step.role }) : has('rich-text', 'Rich text') ? filler() : { type: 'rich-text', preset: 'Rich text', role: step.role, story: true };
+      } else {
+        step = !has('marquee') ? { type: 'marquee', preset: 'Scrolling text', role: 'Arguments qui défilent', settings: { color_palette: 'inverse' } } : filler();
+      }
+    } else if (!hasImages && /with image|avec image/i.test(step.preset || '')) {
+      step = { ...step, preset: step.type === 'testimonials' ? 'Testimonials carousel' : 'Newsletter' };
+    }
+    if (step) out.push(step);
+  }
+
+  if (templateType === 'index') {
+    const heroIndex = out.findIndex((step) => step.hero || step.type === 'slideshow');
+    const marqueeIndex = out.findIndex((step) => step.type === 'marquee');
+    const marquee = marqueeIndex === -1 ? { type: 'marquee', preset: 'Scrolling text', role: 'Arguments qui défilent', settings: { color_palette: 'inverse' } } : out.splice(marqueeIndex, 1)[0];
+    out.splice(heroIndex + 1, 0, marquee);
+    const beforeLast = () => (out.at(-1)?.type === 'newsletter' ? out.length - 1 : out.length);
+    while (out.length < 8) {
+      const next = filler();
+      if (!next) break;
+      out.splice(beforeLast(), 0, next);
+    }
+  }
+  return out;
+}
+
+// Two neighbours on the same coloured background read as one block: the second goes back to
+// the main background. Hero sections are covered by their media and left alone.
+function fixPaletteRhythm(catalog, data) {
+  let previous = null;
+  for (const id of data.order || []) {
+    const section = data.sections[id];
+    if (!section || HERO_TYPES.includes(section.type)) {
+      previous = null;
+      continue;
+    }
+    const setting = ['frame_palette', 'color_palette'].find((key) => (catalog.section(section.type)?.schema?.settings || []).some((item) => item.id === key));
+    if (!setting) continue;
+    const value = section.settings?.[setting] ?? (catalog.section(section.type).schema.settings.find((item) => item.id === setting).default);
+    if (previous && value === previous && value !== 'background-1') section.settings[setting] = 'background-1';
+    previous = section.settings?.[setting] ?? value;
+  }
+}
+
+// Photos into the pages: the hero, then every empty image of the other sections from the pool.
+export function fillImages(data, { hero, heroMobile, pool, large = [] }) {
+  let count = 0;
+  let next = 0;
+  let zoomed = 0;
+  const take = () => (pool.length ? imageRef(pool[next++ % pool.length]) : null);
+  const pruneEmpty = (node) => {
+    for (const [id, block] of Object.entries(node.blocks || {})) {
+      pruneEmpty(block);
+      if (block.type === 'group' && !block.static && !Object.keys(block.blocks || {}).length) removeBlock(node, id);
+    }
+  };
+  for (const id of data.order || []) {
+    const section = data.sections[id];
+    if (!section) continue;
+    if (section.type === 'banner' && hero && !section.settings?.image) {
+      section.settings.media_type = 'image';
+      section.settings.image = imageRef(hero);
+      if (heroMobile) section.settings.image_mobile = imageRef(heroMobile);
+      count += 1;
+      continue;
+    }
+    if (section.type === 'scroll-zoom' && !section.settings?.image && large.length) {
+      section.settings.image = imageRef(large[zoomed++ % large.length]);
+      count += 1;
+    }
+    const used = new Set();
+    for (const { id: blockId, block, parent } of [...inOrder(section)]) {
+      if (block.type !== 'image' || block.settings?.image) continue;
+      const image = take();
+      if (!image) continue;
+      if (used.has(image)) {
+        removeBlock(parent, blockId);
+        continue;
+      }
+      used.add(image);
+      block.settings = { ...(block.settings || {}), image };
+      count += 1;
+    }
+    pruneEmpty(section);
+  }
+  return count;
+}
+
+// A hero without a photo becomes a typographic one on the brand colour, text and background
+// from the same scheme (an image hero keeps white text for the overlay, unreadable without it).
+function typographicHero(data) {
+  const hero = (data.order || []).map((id) => data.sections[id]).find((section) => section?.type === 'banner');
+  if (!hero || hero.settings?.image) return false;
+  Object.assign(hero.settings, { media_type: 'none', frame_palette: 'scheme', color_palette: 'scheme', overlay: 'none', height: 'medium', height_mobile: 'medium', media_effect: 'none' });
+  return true;
+}
+
+// Real proofs in, sample ones out: testimonials, stars typed by hand, figures.
+export function fillProofs(data, proofs) {
+  let count = 0;
+  for (const id of data.order || []) {
+    const section = data.sections[id];
+    if (!section) continue;
+    const entries = [...inOrder(section)];
+    const testimonials = entries.filter(({ block }) => block.type === 'testimonial');
+    testimonials.forEach(({ id: blockId, block, parent }, index) => {
+      const item = proofs.testimonials?.[index];
+      if (!item) return removeBlock(parent, blockId);
+      writeTestimonial(block, { text: item.text, name: item.name, role: item.role });
+      count += 1;
+    });
+    for (const { id: blockId, block, parent } of entries.filter(({ block }) => block.type === 'rating')) {
+      if (proofs.rating) block.settings = { ...(block.settings || {}), rating: Math.round(Math.min(5, Math.max(0, proofs.rating)) * 10) / 10 };
+      else removeBlock(parent, blockId);
+    }
+    entries.filter(({ block }) => block.type === 'counter').forEach(({ id: blockId, block, parent }, index) => {
+      const figure = proofs.figures?.[index];
+      if (!figure) return removeBlock(parent, blockId);
+      block.settings = { ...(block.settings || {}), heading: plain(figure.value), subheading: plain(figure.label) };
+      count += 1;
+    });
+  }
+  return count;
+}
+
+// Lists show the store's real catalogue: chosen collections, else every collection.
+function wireCatalog(data, collections, steps) {
+  const sections = (data.order || []).map((id) => data.sections[id]);
+  sections.forEach((section, index) => {
+    const step = steps[index] || {};
+    for (const { block } of inOrder(section || {})) {
+      if (block.type === 'collection-list' && (block.settings?.source ?? 'collections') === 'collections') {
+        if (collections.length) block.settings.collections = collections.slice(0, block.settings.limit || 8);
+        else block.settings.source = 'all';
+      }
+      if (block.type === 'product-list' && (block.settings?.source ?? 'collection') === 'collection') {
+        const handle = step.source === 'all' ? null : collections[step.collectionIndex ?? 0];
+        if (handle) block.settings.collection = handle;
+      }
+    }
+  });
+}
+
+// ---- art direction
+
+// The direction's global look, keeping only values the theme accepts.
+export function applyDirectionSettings(catalog, current, direction, notes) {
+  const index = catalog.globalSettingIndex();
+  for (const [key, value] of Object.entries(direction.settings)) {
+    const setting = index.get(key);
+    if (!setting || checkValue(setting, value).some((problem) => problem.level === 'error')) {
+      notes.push(`direction : réglage ${key} ignoré (absent ou refusé par cette version du thème)`);
+      continue;
+    }
+    current[key] = value;
+  }
+}
+
+// Coloured bands get the direction's shape at their edges; the hero gets it at the bottom.
+export function decorate(catalog, data, direction) {
+  if (!direction.separator) return 0;
+  let count = 0;
+  const has = (section, id) => (catalog.section(section.type)?.schema?.settings || []).some((setting) => setting.id === id);
+  (data.order || []).forEach((id, position) => {
+    const section = data.sections[id];
+    if (!section || !has(section, 'separator_bottom')) return;
+    const palette = section.settings?.frame_palette ?? section.settings?.color_palette ?? 'background-1';
+    const hero = position === 0 && ['banner', 'slideshow'].includes(section.type);
+    if (!hero && palette === 'background-1') return;
+    if (!hero) section.settings.separator_top = direction.separator.shape;
+    section.settings.separator_bottom = direction.separator.shape;
+    if (direction.separator.animation && has(section, 'separator_animation')) section.settings.separator_animation = direction.separator.animation;
+    count += 1;
+  });
+  return count;
+}
+
+const PALETTE_CYCLE = ['scheme', 'background-2', 'inverse', 'background-2'];
+
+// Signature moments of the home page, from the brand copy the model wrote.
+function addSignatures(catalog, data, { direction, copy, lang }) {
+  const added = [];
+  const position = (type) => data.order.findIndex((id) => data.sections[id]?.type === type);
+  const insertAt = (index, specs) => {
+    const before = new Set(data.order);
+    const { data: next } = composeSections(catalog, specs, { language: lang, data, h1First: false });
+    const fresh = next.order.filter((id) => !before.has(id));
+    next.order = next.order.filter((id) => before.has(id));
+    next.order.splice(Math.max(0, Math.min(index, next.order.length)), 0, ...fresh);
+    Object.assign(data, next);
+    return fresh;
+  };
+  if (copy.rotating_words?.length) {
+    const hero = data.sections[data.order[0]];
+    if (hero) fillSection(catalog, hero, { content: { rotating_words: copy.rotating_words } }, { nextId: createIdFactory(collectIds(data)) });
+    added.push('mots qui tournent dans le titre');
+  }
+  for (const signature of direction.signatures) {
+    if (signature === 'manifesto' && copy.manifesto) {
+      // Between the catalogue sections, so text and pictures alternate.
+      const after = (position('collection-list') !== -1 ? position('collection-list') : Math.max(position('product-list'), 1)) + 1;
+      insertAt(after, [{ type: 'rich-text', preset: 'Big statement', content: { manifesto: copy.manifesto } }]);
+      added.push('manifeste révélé au défilement');
+    }
+    if (signature === 'cards' && copy.benefits?.length >= 3) {
+      const columns = position('multicolumn');
+      if (columns !== -1) {
+        delete data.sections[data.order[columns]];
+        data.order.splice(columns, 1);
+      }
+      const items = copy.benefits.map((item, index) => ({ ...item, palette: PALETTE_CYCLE[index % PALETTE_CYCLE.length] }));
+      insertAt(columns === -1 ? data.order.length - 1 : columns, [{ type: 'scroll-cards', preset: 'Stacking cards', content: { eyebrow: copy.benefits_eyebrow ?? '', title: copy.benefits_title || (lang === 'fr' ? 'Pourquoi nous choisir' : null), items } }]);
+      added.push('cartes empilées au défilement');
+    }
+    if (signature === 'process' && copy.process?.length) {
+      insertAt(position('newsletter') === -1 ? data.order.length : position('newsletter') - 1, [{ type: 'timeline', preset: 'How it works', palette: 'background-2', content: { title: copy.process_title || (lang === 'fr' ? 'De l’atelier à chez vous' : null), items: copy.process } }]);
+      added.push('étapes de fabrication');
+    }
+  }
+  return added;
+}
+
+// ---- brand pages: our story, how to use
+
+// A wide photo for a brand page hero, the page's own photos first; none means a typographic hero
+// (a small photo stretched over the screen is blurry, the home hero again is repetitive).
+function wideCover(images, preferred = []) {
+  const large = images.large || [];
+  return [...(preferred || []), ...large].find((photo) => large.includes(photo) && photo !== images.hero) || null;
+}
+
+function storySpecs({ copy, images, collections, proofs, lang, name }) {
+  const fr = lang === 'fr';
+  const link = collections[0] ? `shopify://collections/${collections[0]}` : 'shopify://collections/all';
+  const photos = [...(images.story || []), ...(images.lifestyle || [])];
+  const cover = wideCover(images, images.story);
+  return [
+    { type: 'banner', preset: 'Image banner', ...(cover ? { image: cover } : {}), content: { eyebrow: name, title: copy.story_title || (fr ? 'Notre histoire' : null), text: copy.story_intro || copy.brand_story_text || '', buttons: [{ label: copy.hero_button || (fr ? 'Découvrir la collection' : 'Shop now'), link }] } },
+    copy.manifesto ? { type: 'rich-text', preset: 'Big statement', palette: 'background-2', content: { manifesto: copy.manifesto } } : null,
+    copy.story_steps?.length ? { type: 'timeline', preset: 'Our story', content: { eyebrow: fr ? 'Les grandes étapes' : '', title: copy.story_steps_title || (fr ? 'Comment tout a commencé' : null), items: copy.story_steps } } : null,
+    photos.length ? { type: 'image-with-text', preset: 'Brand story', images: photos.slice(0, 2), content: { title: copy.brand_story_title, text: copy.brand_story_text, buttons: [] } } : { type: 'rich-text', preset: 'Rich text', content: { title: copy.brand_story_title, text: copy.brand_story_text, buttons: [] } },
+    copy.values?.length ? { type: 'multicolumn', preset: 'Icons with text', palette: 'background-2', content: { title: copy.values_title || (fr ? 'Ce qui compte pour nous' : null), items: copy.values } } : null,
+    proofs.figures?.length ? { type: 'stats', preset: 'Key figures', content: { title: fr ? 'En quelques chiffres' : null, items: proofs.figures } } : null,
+    { type: 'product-list', preset: 'Featured collection', content: { title: fr ? 'Nos incontournables' : null } },
+  ].filter(Boolean);
+}
+
+function usageSpecs({ copy, images, lang, name }) {
+  const fr = lang === 'fr';
+  const cover = wideCover(images, images.lifestyle);
+  const tips = (copy.tips || []).map((tip, index) => ({ ...tip, palette: PALETTE_CYCLE[index % PALETTE_CYCLE.length] }));
+  return [
+    { type: 'banner', preset: 'Image banner', ...(cover ? { image: cover } : {}), content: { eyebrow: fr ? 'Mode d’emploi' : 'How to use', title: copy.usage_title || (fr ? `Bien utiliser ${name}` : null), text: copy.usage_intro || '', buttons: [] } },
+    { type: 'timeline', preset: 'How it works', content: { title: copy.usage_steps_title || (fr ? 'En quelques étapes' : null), items: copy.usage_steps, buttons: [] } },
+    tips.length ? { type: 'scroll-cards', preset: 'Stacking cards', content: { title: fr ? 'Nos astuces' : null, items: tips } } : null,
+    copy.usage_faq?.length ? { type: 'faq', preset: 'FAQ', palette: 'background-2', content: { title: fr ? 'Vos questions' : null, text: '', items: copy.usage_faq.map((item) => ({ question: item.question, answer: item.answer })) } } : null,
+    { type: 'product-list', preset: 'Product carousel', content: { title: fr ? 'À vous de jouer' : null } },
+  ].filter(Boolean);
+}
+
+// ---- the whole first version, in one call
+
+export function buildStore({ catalog, store }, input) {
+  const language = input.language || 'fr';
+  const style = STYLES[input.style] ? input.style : inferStyle(`${input.activity || ''} ${input.name}`);
+  const preset = STYLES[style];
+  const directionId = DIRECTIONS[input.direction] ? input.direction : STYLE_DIRECTION[style];
+  const direction = DIRECTIONS[directionId];
+  const choices = [];
+  const notes = [];
+  const collections = [...new Set([...(input.collections || []), ...(input.collection ? [input.collection] : [])])];
+  const images = { ...(input.images || {}) };
+  const pool = [...(images.story || []), ...(images.lifestyle || [])];
+  for (const photo of images.large || []) if (!pool.includes(photo)) pool.push(photo);
+  if (!images.hero && pool.length) images.hero = (images.large || [])[0] || pool[0];
+  if (!pool.length && images.hero) pool.push(images.hero);
+  const hasImages = pool.length > 0;
+  // Photos known to be wide enough for full-screen spots, the hero apart (already on screen).
+  images.large = (images.large || []).filter((photo) => photo !== images.hero);
+  const hasLarge = images.large.length > 0;
+  const proofs = input.proofs || {};
+
+  // Project: reused when it exists, so "refais la V1" rebuilds the same store.
+  const slug = store.slugFor(input.name);
+  const existed = store.exists(slug);
+  const brief = {
+    brand: input.name,
+    ...(input.activity ? { activity: input.activity } : {}),
+    style,
+    ...(input.primary_color ? { brand_colors: [input.primary_color, input.secondary_color].filter(Boolean) } : {}),
+    ...(input.shop_domain ? { shop_domain: input.shop_domain } : {}),
+    ...(collections.length ? { collections } : {}),
+  };
+  if (existed) store.updateBrief(slug, brief);
+  else store.create({ name: input.name, language, brief });
+  store.setCurrent(slug);
+  const meta = store.meta(slug);
+  const lang = meta.language || language;
+
+  // Identity
+  const primary = input.primary_color || preset.color;
+  choices.push(input.primary_color ? `couleurs à partir de ${input.primary_color}` : `couleur par défaut du style « ${preset.label} » (${preset.color}) : aucune couleur de marque donnée`);
+  const palette = generateColorSchemes({ primary, secondary: input.secondary_color || null, background: input.background_color || null, neutral: preset.neutral, mood: input.dark ? 'dark' : 'light' });
+  notes.push(...palette.adjustments);
+  const pairing = FONT_PAIRINGS.find((pair) => pair.id === input.fonts) || FONT_PAIRINGS.find((pair) => pair.id === direction.fonts) || FONT_PAIRINGS.find((pair) => pair.id === preset.fonts);
+  choices.push(`polices ${pairing.heading} / ${pairing.body} (${pairing.style})`);
+  const settings = clone(store.read(slug, 'config/settings_data.json').data);
+  if (typeof settings.current === 'string') settings.current = clone(settings.presets?.[settings.current] || {});
+  Object.assign(settings.current, palette.button_palettes, { headings_font: pairing.heading, body_font: pairing.body });
+  settings.current.color_schemes = { ...(settings.current.color_schemes || {}), ...palette.color_schemes };
+  settings.current.palette = { ...(settings.current.palette || {}), ...palette.palette };
+  applyDirectionSettings(catalog, settings.current, direction, notes);
+  choices.push(`direction artistique « ${direction.label} »`);
+  const settingsCheck = validateFile(catalog, 'config/settings_data.json', settings);
+  if (!settingsCheck.ok) throw new Error(`réglages invalides : ${settingsCheck.errors[0].message}`);
+  store.write(slug, 'config/settings_data.json', settings, 'V1 : identité');
+
+  // Pages
+  const recipes = [];
+  const home = findRecipe(input.home) ? input.home : preset.home;
+  recipes.push([home, 'templates/index.json']);
+  recipes.push([input.offers ? 'produit-offres' : 'produit-complet', 'templates/product.json']);
+  recipes.push(['collection-complete', 'templates/collection.json']);
+  const pages = input.pages || DEFAULT_PAGES;
+  for (const page of pages) if (PAGE_RECIPES[page]) recipes.push([PAGE_RECIPES[page], findRecipe(PAGE_RECIPES[page]).template]);
+  choices.push(`accueil : recette ${home} ; fiche produit : ${input.offers ? 'avec offres' : 'complète'} ; pages : ${pages.join(', ')}`);
+  choices.push(hasImages ? `photos placées : ${[images.hero, ...pool].filter(Boolean).length}` : 'aucune photo fournie : héro typographique sur la couleur de marque, sections à photos remplacées (rien de vide)');
+  if (hasImages && !hasLarge) notes.push('aucune photo large en dehors du héro (images.large, 1600 px de large ou plus) : pas de zoom au défilement, héro typographique sur les pages de marque');
+
+  const copy = { ...(input.copy || {}) };
+  if (!copy.reassurance?.length && copy.announcements?.length) copy.reassurance = copy.announcements;
+  const written = {};
+  const sectionsPerFile = {};
+  let signatures = [];
+  for (const [recipeId, file] of recipes) {
+    const recipe = findRecipe(recipeId);
+    const templateType = file === 'templates/index.json' ? 'index' : file.startsWith('templates/product') ? 'product' : 'other';
+    const steps = adaptSteps(recipe.steps, { templateType, hasImages, hasLarge, proofs, collections });
+    const { data } = buildFromRecipe(catalog, { ...recipe, steps }, { language: lang, base: recipe.base ? catalog.theme.templates.get(recipe.base) : null });
+    const baseCount = recipe.base ? catalog.theme.templates.get(recipe.base).order.length : 0;
+    const filled = clone(data);
+    wireCatalog(filled, collections, [...Array(baseCount).fill({}), ...steps]);
+    let count = fillCopy(filled, copy, { collection: collections[0], templateType: templateType === 'index' ? 'index' : 'other' });
+    count += fillImages(filled, { hero: images.hero, heroMobile: images.hero_mobile, pool, large: images.large });
+    count += fillProofs(filled, proofs);
+    if (templateType === 'index') signatures = addSignatures(catalog, filled, { direction, copy, lang });
+    typographicHero(filled);
+    fixPaletteRhythm(catalog, filled);
+    decorate(catalog, filled, direction);
+    const check = validateFile(catalog, file, filled);
+    const final = check.ok ? filled : data;
+    if (!check.ok) notes.push(`${file} : personnalisation non appliquée (${check.errors[0].path} : ${check.errors[0].message})`);
+    else if (count) written[file] = count;
+    const ok = validateFile(catalog, file, final);
+    if (!ok.ok) throw new Error(`${file} : ${ok.errors[0].message}`);
+    store.write(slug, file, final, `V1 : recette ${recipeId}`);
+    sectionsPerFile[file] = final.order.length;
+  }
+
+  // Brand pages composed from the copy: our story, how to use.
+  const brandPages = [];
+  for (const page of pages.filter((item) => BRAND_PAGES[item])) {
+    const file = BRAND_PAGES[page];
+    const specs = page === 'a-propos' ? storySpecs({ copy, images, collections, proofs, lang, name: input.name }) : usageSpecs({ copy, images, lang, name: input.name });
+    const { data, notes: composeNotes } = composeSections(catalog, specs, { language: lang });
+    notes.push(...composeNotes.map((note) => `${file} ${note}`));
+    wireCatalog(data, collections, specs);
+    typographicHero(data);
+    fixPaletteRhythm(catalog, data);
+    decorate(catalog, data, direction);
+    const check = validateFile(catalog, file, data);
+    if (!check.ok) {
+      notes.push(`${file} : non créée (${check.errors[0].path} : ${check.errors[0].message})`);
+      continue;
+    }
+    store.write(slug, file, data, `V1 : page ${page}`);
+    sectionsPerFile[file] = data.order.length;
+    brandPages.push(file);
+  }
+
+  // The rest of the theme in the store's language, without the demo templates.
+  for (const rel of DEMO_TEMPLATES) if (!input.offers || !rel.includes('offers')) if (!store.excluded(slug).includes(rel)) store.setExcluded(slug, rel, true);
+  let translated = 0;
+  if (lang !== catalog.defaultLanguage) {
+    for (const [rel, entry] of store.effectiveFiles(slug)) {
+      if (entry.origin !== 'theme' || rel === 'config/settings_data.json' || !entry.data?.sections) continue;
+      const { data, translated: count } = localizeData(catalog, entry.data, lang);
+      if (!count || !validateFile(catalog, rel, data).ok) continue;
+      store.write(slug, rel, data, `V1 : traduction (${count} textes)`);
+      translated += count;
+    }
+  }
+  const showcase = stripShowcase(catalog, store, slug, { collections });
+  if (showcase.length) notes.push(`vitrine de démo retirée : ${showcase.length} élément(s)`);
+
+  const header = store.read(slug, 'sections/header-group.json');
+  if (header.data && copy.announcements?.length) {
+    const data = clone(header.data);
+    const count = fillAnnouncements(data, copy.announcements, { collection: collections[0] });
+    if (count && validateFile(catalog, 'sections/header-group.json', data).ok) {
+      store.write(slug, 'sections/header-group.json', data, 'V1 : annonces');
+      written['sections/header-group.json'] = count;
+    }
+  }
+  return { slug, existed, style, direction: directionId, signatures, brandPages, choices, notes, written, translated, sectionsPerFile, hasImages, meta: store.meta(slug) };
+}