@cogenta/starters 0.1.5 → 0.2.0

package/dist/blueprints/vitrine.js

@@ -1,804 +1,549 @@
 import { CogentaError } from '@cogenta/core';
 import { createContentStore, createTaxonomyStore, defineCollection, defineTaxonomy, f, validateCollectionSet, validateTaxonomySet, } from '@cogenta/schema';
-import { avatarArt, coverArt, heroArt, logoArt } from '../demo-art/compositions.js';
-import { definePageCollection, richTextParagraph, SEO_FIELDS, toBlockZoneEntry, } from './content-pack.js';
+import { ICON_NAMES } from '@cogenta/theme-kit';
+import { coverArt, heroArt, logoArt } from '../demo-art/compositions.js';
+import { definePageCollection, SEO_FIELDS, toBlockZoneEntry, } from './content-pack.js';
 import { STARTING_SKINS } from './starting-skins.js';
+import { VITRINE_COPY_EN } from './vitrine-copy-en.js';
+import { VITRINE_COPY_FR } from './vitrine-copy-fr.js';
+import { VITRINE_PHOTO_CREDITS } from './vitrine-credits.js';
 /**
- * The `vitrine` blueprint: the website of a management consultancy (L9 task
- * 8; raised to a pro template by L25; rewritten to studio level by L27).
+ * The `vitrine` blueprint: the website of an engineering company that designs
+ * sensors, software and field services for critical infrastructure (L36;
+ * previously a management consultancy, L9 to L27).
  *
- * Three real, editable collections behind the pages: the firm's practices
- * (`service`), its published case studies (`case_study`, filed by `sector`)
- * and the client testimonials the pages quote. Demo copy names the firm the
- * person scaffolding the site actually named (`SeedContext.siteName`), and
- * falls back to a fictional firm only outside a real scaffold.
+ * Written in French and in English, not translated at render time: the
+ * installer picks the copy for the site's default locale, and with it the
+ * addresses (`/references/…` in French, `/case-studies/…` in English), the
+ * collection names the administration shows and every word of demo content.
+ *
+ * Five editable collections sit behind the pages: solutions, case studies
+ * (filed by sector), testimonials, job openings and news articles. Every
+ * photograph is a real one under an open licence, credited on its own page;
+ * the client logos and the product screenshots were drawn for this blueprint.
  */
-export const DEFAULT_FIRM_NAME = 'Northfield Partners';
-export const sector = defineTaxonomy({
-    name: 'sector',
-    labels: {
-        singular: { en: 'Sector', fr: 'Secteur' },
-        plural: { en: 'Sectors', fr: 'Secteurs' },
-    },
-    hierarchical: false,
-    permissions: {
-        read: ['public'],
-        create: ['editor', 'admin'],
-        update: ['editor', 'admin'],
-        delete: ['admin'],
-    },
-});
-export const service = defineCollection({
-    name: 'service',
-    labels: { singular: 'Practice', plural: 'Practices' },
-    // Routed: `featureGrid` links each practice to its own page, and a
-    // `collectionList` of this collection builds a link for every entry.
-    routing: { pattern: '/services/:slug' },
-    fields: {
-        name: f.text({ required: true, max: 120 }),
-        slug: f.slug({ from: 'name', unique: true }),
-        description: f.text({ max: 400, multiline: true }),
-        body: f.richText(),
-        icon: f.text({
-            max: 64,
-            admin: {
-                label: 'Icon',
-                help: 'One of the symbol names @cogenta/theme-kit recognises (e.g. "chart", "shield", "briefcase"). Themes that set practices as a numbered list may not draw it.',
-            },
-        }),
-        coverImage: f.media({ accept: ['image'] }),
-        ...SEO_FIELDS,
-    },
-    indexes: [['slug']],
-    permissions: {
-        read: ['public'],
-        create: ['editor', 'admin'],
-        update: ['editor', 'admin'],
-        delete: ['admin'],
-    },
-});
-export const caseStudy = defineCollection({
-    name: 'case_study',
-    labels: { singular: 'Case study', plural: 'Case studies' },
-    routing: { pattern: '/case-studies/:slug' },
-    fields: {
-        title: f.text({ required: true, max: 200 }),
-        slug: f.slug({ from: 'title', unique: true }),
-        client: f.text({ max: 120 }),
-        summary: f.text({ max: 400, multiline: true }),
-        body: f.richText(),
-        coverImage: f.media({ accept: ['image'] }),
-        sector: f.taxonomy({ of: 'sector', many: false }),
-        ...SEO_FIELDS,
-    },
-    indexes: [['slug']],
-    permissions: {
-        read: ['public'],
-        create: ['editor', 'admin'],
-        update: ['editor', 'admin'],
-        delete: ['admin'],
-    },
-});
-export const testimonial = defineCollection({
-    name: 'testimonial',
-    labels: { singular: 'Testimonial', plural: 'Testimonials' },
-    fields: {
-        authorName: f.text({ required: true, max: 120 }),
-        authorRole: f.text({ max: 120 }),
-        quote: f.text({ required: true, max: 500, multiline: true }),
-        avatar: f.media({ accept: ['image'] }),
-    },
-    permissions: {
-        read: ['public'],
-        create: ['editor', 'admin'],
-        update: ['editor', 'admin'],
-        delete: ['admin'],
-    },
-});
-export const page = definePageCollection('/:slug');
-export const VITRINE_COLLECTIONS = [
-    service,
-    caseStudy,
-    testimonial,
-    page,
-];
-export const VITRINE_TAXONOMIES = [sector];
-validateCollectionSet(VITRINE_COLLECTIONS);
-validateTaxonomySet(VITRINE_TAXONOMIES, VITRINE_COLLECTIONS);
-function span(key, text) {
-    return { _key: `${key}-s`, _type: 'span', text, marks: [] };
+export const DEFAULT_FIRM_NAME = 'Norvane';
+/** The copy for a site's default locale: French for any `fr*` locale, English otherwise. */
+export function vitrineCopyFor(locale) {
+    return locale.toLowerCase().startsWith('fr') ? VITRINE_COPY_FR : VITRINE_COPY_EN;
+}
+// ---------------------------------------------------------------------------
+// Content model
+// ---------------------------------------------------------------------------
+const EDITORIAL = {
+    read: ['public'],
+    create: ['editor', 'admin'],
+    update: ['editor', 'admin'],
+    delete: ['admin'],
+};
+/** The content model, named and routed in the copy's language. */
+export function vitrineSchema(copy) {
+    const { schema } = copy;
+    const sector = defineTaxonomy({
+        name: schema.taxonomy.name,
+        labels: {
+            singular: { en: 'Sector', fr: 'Secteur' },
+            plural: { en: 'Sectors', fr: 'Secteurs' },
+        },
+        hierarchical: false,
+        permissions: EDITORIAL,
+    });
+    const solution = defineCollection({
+        name: 'solution',
+        labels: schema.labels.solution,
+        routing: { pattern: schema.routes.solution },
+        fields: {
+            name: f.text({ required: true, max: 120 }),
+            slug: f.slug({ from: 'name', unique: true }),
+            description: f.text({ max: 400, multiline: true }),
+            body: f.richText(),
+            // A choice among the symbols every theme draws, not a name to remember (L36 audit).
+            icon: f.select({ options: [...ICON_NAMES], admin: { label: schema.fields.icon } }),
+            coverImage: f.media({ accept: ['image'] }),
+            ...SEO_FIELDS,
+        },
+        indexes: [['slug']],
+        permissions: EDITORIAL,
+    });
+    const caseStudy = defineCollection({
+        name: 'case_study',
+        labels: schema.labels.caseStudy,
+        routing: { pattern: schema.routes.caseStudy },
+        fields: {
+            title: f.text({ required: true, max: 200 }),
+            slug: f.slug({ from: 'title', unique: true }),
+            client: f.text({ max: 120, admin: { label: schema.fields.client } }),
+            location: f.text({ max: 120, admin: { label: schema.fields.location } }),
+            keyFigure: f.text({ max: 40, admin: { label: schema.fields.keyFigure } }),
+            keyFigureLabel: f.text({ max: 120, admin: { label: schema.fields.keyFigureLabel } }),
+            summary: f.text({ max: 400, multiline: true }),
+            body: f.richText(),
+            coverImage: f.media({ accept: ['image'] }),
+            sector: f.taxonomy({ of: schema.taxonomy.name, many: false }),
+            ...SEO_FIELDS,
+        },
+        indexes: [['slug']],
+        permissions: EDITORIAL,
+    });
+    const testimonial = defineCollection({
+        name: 'testimonial',
+        labels: schema.labels.testimonial,
+        fields: {
+            authorName: f.text({ required: true, max: 120 }),
+            authorRole: f.text({ max: 160 }),
+            quote: f.text({ required: true, max: 600, multiline: true }),
+            avatar: f.media({ accept: ['image'] }),
+        },
+        permissions: EDITORIAL,
+    });
+    const job = defineCollection({
+        name: 'job',
+        labels: schema.labels.job,
+        routing: { pattern: schema.routes.job },
+        fields: {
+            title: f.text({ required: true, max: 160 }),
+            slug: f.slug({ from: 'title', unique: true }),
+            team: f.text({ max: 80, admin: { label: schema.fields.team } }),
+            location: f.text({ max: 80, admin: { label: schema.fields.location } }),
+            contract: f.text({ max: 80, admin: { label: schema.fields.contract } }),
+            summary: f.text({ max: 400, multiline: true }),
+            body: f.richText(),
+            ...SEO_FIELDS,
+        },
+        indexes: [['slug']],
+        permissions: EDITORIAL,
+    });
+    const post = defineCollection({
+        name: 'post',
+        labels: schema.labels.post,
+        routing: { pattern: schema.routes.post },
+        fields: {
+            title: f.text({ required: true, max: 200 }),
+            slug: f.slug({ from: 'title', unique: true }),
+            summary: f.text({ max: 400, multiline: true }),
+            author: f.text({ max: 120, admin: { label: schema.fields.author } }),
+            // Declared so an article can be scheduled, and appears in the
+            // editorial calendar (L35).
+            publishedAt: f.datetime(),
+            coverImage: f.media({ accept: ['image'] }),
+            body: f.richText(),
+            sector: f.taxonomy({ of: schema.taxonomy.name, many: false }),
+            ...SEO_FIELDS,
+        },
+        indexes: [['slug']],
+        permissions: EDITORIAL,
+    });
+    const page = definePageCollection('/:slug');
+    const collections = [solution, caseStudy, testimonial, job, post, page];
+    const taxonomies = [sector];
+    validateCollectionSet(collections);
+    validateTaxonomySet(taxonomies, collections);
+    return { sector, solution, caseStudy, testimonial, job, post, page, collections, taxonomies };
+}
+// ---------------------------------------------------------------------------
+// Rich text, written as data
+// ---------------------------------------------------------------------------
+function spans(key, inline) {
+    const parts = typeof inline === 'string' ? [inline] : inline;
+    const markDefs = [];
+    const children = parts.map((part, index) => {
+        const spanKey = `${key}-s${index}`;
+        if (typeof part === 'string')
+            return { _key: spanKey, _type: 'span', text: part, marks: [] };
+        const markKey = `${key}-l${index}`;
+        markDefs.push({ _key: markKey, _type: 'link', href: part.href });
+        return { _key: spanKey, _type: 'span', text: part.text, marks: [markKey] };
+    });
+    return { children, markDefs };
 }
 /** Builds a contract-A rich-text document from plain parts (never HTML, R3). */
-function richText(key, parts) {
+export function richText(key, parts) {
     return parts.flatMap((part, index) => {
         const partKey = `${key}-${index}`;
-        if ('p' in part) {
-            return [
-                {
-                    _key: partKey,
-                    _type: 'block',
-                    style: 'normal',
-                    children: [span(partKey, part.p)],
-                    markDefs: [],
-                },
-            ];
-        }
         if ('h2' in part) {
-            return [
-                {
-                    _key: partKey,
-                    _type: 'block',
-                    style: 'h2',
-                    children: [span(partKey, part.h2)],
-                    markDefs: [],
-                },
-            ];
+            return [{ _key: partKey, _type: 'block', style: 'h2', ...spans(partKey, part.h2) }];
+        }
+        if ('p' in part) {
+            return [{ _key: partKey, _type: 'block', style: 'normal', ...spans(partKey, part.p) }];
         }
-        return part.bullets.map((text, bulletIndex) => ({
+        return part.bullets.map((item, bulletIndex) => ({
             _key: `${partKey}-${bulletIndex}`,
             _type: 'block',
             style: 'normal',
             listItem: 'bullet',
             level: 1,
-            children: [span(`${partKey}-${bulletIndex}`, text)],
-            markDefs: [],
+            ...spans(`${partKey}-${bulletIndex}`, item),
         }));
     });
 }
-export const VITRINE_DEMO_SERVICES = [
-    {
-        name: 'Strategy',
-        slug: 'strategy',
-        icon: 'globe',
-        description: 'Where to compete, what to stop doing and what the plan is worth. We build the three-year plan with the executive team and test every assumption against the figures the board will see.',
-        body: (firm) => [
-            {
-                p: `Strategy work at ${firm} starts from the operating results. Before anyone discusses ambition, we rebuild the last three years of profit by customer, product and channel, so the executive team and the board argue from one set of facts.`,
-            },
-            { h2: 'Questions clients bring' },
-            {
-                bullets: [
-                    'Which of our markets can we lead within five years, and which should we leave?',
-                    'Should we grow by acquisition, and what can we afford to pay?',
-                    'What does the business need to look like before a sale in three years?',
-                ],
-            },
-            { h2: 'What the work produces' },
-            {
-                p: 'A three-year plan with targets by business unit, the investment case behind each major decision, and a quarterly scorecard the board can run without us. Strategy engagements usually take ten to fourteen weeks.',
-            },
-        ],
-    },
-    {
-        name: 'Operations',
-        slug: 'operations',
-        icon: 'settings',
-        description: 'Cost, service and working capital across plants, supply chains and shared services. Our programmes typically release 2 to 4% of revenue within eighteen months.',
-        body: (firm) => [
-            {
-                p: `${firm} consultants start on the floor: in the depot, the warehouse, the contact centre. The diagnostic takes six weeks and ends with a costed list of changes ranked by cash released and by risk to service.`,
-            },
-            { h2: 'Where the value usually is' },
-            {
-                bullets: [
-                    'Inventory held against forecasts nobody uses',
-                    'Maintenance and rostering plans built for last year’s demand',
-                    'Procurement spread across too many suppliers on short contracts',
-                ],
-            },
-            { h2: 'How results are measured' },
-            {
-                p: 'Every target is agreed with your finance director before implementation starts and tracked in your own management accounts. On most operations programmes part of our fee depends on those numbers.',
-            },
-        ],
-    },
-    {
-        name: 'Finance and transactions',
-        slug: 'finance-transactions',
-        icon: 'chart',
-        description: 'Commercial due diligence, value-creation plans and post-merger integration for owners, lenders and management teams, from the first model to the hundredth day.',
-        body: () => [
-            {
-                p: 'We work for buyers, sellers and the management teams in between. A diligence report tells an investment committee what it needs to know in forty pages; the value-creation plan that follows is written to be executed by the company, with owners for every line.',
-            },
-            { h2: 'Typical mandates' },
-            {
-                bullets: [
-                    'Buy-side commercial diligence in four to six weeks',
-                    'Vendor preparation twelve months before a sale process',
-                    'Integration planning and the first hundred days after completion',
-                ],
-            },
-            { h2: 'Independence' },
-            {
-                p: 'We do not take success fees on transactions, and we will not advise both sides of the same deal.',
-            },
-        ],
-    },
-    {
-        name: 'Organisation',
-        slug: 'organisation',
-        icon: 'users',
-        description: 'Operating models, spans and layers, and succession for the top hundred roles. We design structures a company can run without its advisers in the room.',
-        body: () => [
-            {
-                p: 'Most reorganisations fail in the second year, once the new chart meets the old habits. We design the structure together with the decision rights, the committee calendar and the performance measures, and we test it on real decisions before it is announced.',
-            },
-            { h2: 'What we look at' },
-            {
-                bullets: [
-                    'How many layers sit between the chief executive and the customer',
-                    'Which decisions need three signatures, and why',
-                    'Who is ready to take the twenty most critical roles in the next two years',
-                ],
-            },
-        ],
-    },
-    {
-        name: 'Technology and data',
-        slug: 'technology-data',
-        icon: 'layers',
-        description: 'Architecture reviews, vendor selection and delivery assurance for ERP, pricing and planning systems, judged against the business case they were bought for.',
-        body: () => [
-            {
-                p: 'We are independent of software vendors and integrators, and we are paid by the client alone. That lets us tell a board whether a stalled programme should be rescued, reduced or stopped.',
-            },
-            { h2: 'Typical work' },
-            {
-                bullets: [
-                    'Independent reviews of programmes that are late or over budget',
-                    'Selection of ERP, pricing and planning software',
-                    'Quarterly assurance reports for audit committees',
-                ],
-            },
-        ],
-    },
-    {
-        name: 'Risk and resilience',
-        slug: 'risk-resilience',
-        icon: 'shield',
-        description: 'Operational resilience, regulatory remediation and continuity planning, written to the standard a supervisor or an insurer will actually test.',
-        body: () => [
-            {
-                p: 'Resilience plans are usually written for the audit and discovered to be unworkable on the day they are needed. We run the scenarios with the people who would have to act on them, at night and without the usual systems.',
-            },
-            { h2: 'Typical work' },
-            {
-                bullets: [
-                    'Important business services and impact tolerances for regulated firms',
-                    'Remediation programmes after a supervisory review',
-                    'Crisis exercises for executive teams and boards',
-                ],
-            },
-        ],
-    },
-];
-export const VITRINE_DEMO_SECTORS = [
-    { slug: 'transport', name: 'Transport' },
-    { slug: 'hospitality', name: 'Hospitality' },
-    { slug: 'public-sector', name: 'Public sector' },
-];
-export const VITRINE_DEMO_CASE_STUDIES = [
-    {
-        title: 'Meridian Rail raises punctuality from 88% to 94% in fourteen months',
-        slug: 'meridian-rail-punctuality',
-        client: 'Meridian Rail',
-        sectorSlug: 'transport',
-        summary: 'A commuter operator carrying 190,000 passengers a day rebuilt its crew rosters and depot maintenance plan. Cancellations caused by missing crew fell by two thirds.',
-        body: (firm) => [
-            { h2: 'The situation' },
-            {
-                p: 'Meridian Rail runs 1,140 services a day on four lines into the city. Punctuality had fallen for three consecutive years, and the regulator had opened a formal review. Internal analysis blamed ageing trains; the operator’s own data showed that most delays began before a train left the depot.',
-            },
-            { h2: 'What we did' },
-            {
-                p: `A team of five from ${firm} spent the first three weeks on night shifts in the two main depots and in the control room. Rosters were being built for a timetable that had changed twice since they were drawn up, and heavy maintenance was scheduled in the hours when spare trains were most needed.`,
-            },
-            {
-                bullets: [
-                    'Rebuilt crew rosters around the current timetable, with a reserve pool at each depot',
-                    'Moved heavy maintenance to a rolling overnight plan agreed with the unions',
-                    'Set up a daily performance meeting using one shared delay log',
-                ],
-            },
-            { h2: 'Results' },
-            {
-                p: 'Trains arriving within five minutes of schedule rose from 88% to 94% over fourteen months. Cancellations caused by missing crew fell by 67%, and the regulator closed its review without penalty. The operator’s planning team now maintains the rosters itself.',
-            },
-        ],
-    },
-    {
-        title: 'Castell & Vane Hotels adds £11.2 million of revenue with one pricing desk',
-        slug: 'castell-vane-pricing',
-        client: 'Castell & Vane Hotels',
-        sectorSlug: 'hospitality',
-        summary: 'Room rates at fourteen properties had been set by each general manager from a spreadsheet. A central pricing desk and a weekly forecast changed that within a season.',
-        body: (firm) => [
-            { h2: 'The situation' },
-            {
-                p: 'Castell & Vane owns fourteen hotels in six cities, most of them historic buildings with restaurants that account for a third of revenue. Each general manager set room rates independently, and weekend prices were often lower than weekday prices in the same city.',
-            },
-            { h2: 'What we did' },
-            {
-                p: `${firm} built a demand forecast from four years of bookings, local events and competitor rates, then designed a central pricing desk of three analysts who publish rates every Monday. General managers kept the right to override a price, with a reason recorded against it.`,
-            },
-            {
-                bullets: [
-                    'Weekly forecast by property, room type and channel',
-                    'Rate rules for group bookings, long stays and restaurant packages',
-                    'Training for fourteen general managers and their revenue leads',
-                ],
-            },
-            { h2: 'Results' },
-            {
-                p: 'Revenue per available room rose by 9% in the first full year, worth £11.2 million, with occupancy unchanged. The pricing desk paid for the engagement within eleven weeks.',
-            },
-        ],
-    },
-    {
-        title: 'Kellmoor City Council closes a £38 million budget gap and keeps every library open',
-        slug: 'kellmoor-council-budget',
-        client: 'Kellmoor City Council',
-        sectorSlug: 'public-sector',
-        summary: 'Facing a statutory deficit, the council merged six back-office functions into one shared service and renegotiated 41 contracts. Front-line spending was protected in full.',
-        body: (firm) => [
-            { h2: 'The situation' },
-            {
-                p: 'Kellmoor City Council serves 310,000 residents. Rising care costs had opened a £38 million gap in a £420 million budget, and the council had eighteen months to close it before the government could intervene.',
-            },
-            { h2: 'What we did' },
-            {
-                p: `${firm} began with the council’s statutory duties, then its cost base. Each proposed saving was checked against those duties by the council’s own legal team before it went to elected members.`,
-            },
-            {
-                bullets: [
-                    'Merged finance, payroll, procurement, IT, legal and property support into one shared service',
-                    'Renegotiated 41 contracts worth £96 million a year',
-                    'Sold or let eleven under-used buildings',
-                ],
-            },
-            { h2: 'Results' },
-            {
-                p: 'The gap was closed four months ahead of the deadline. Libraries, children’s centres and road maintenance kept their budgets in full, and none of the savings has had to be reversed.',
-            },
-        ],
-    },
-];
-export const VITRINE_DEMO_TESTIMONIALS = [
-    {
-        authorName: 'Helen Achterberg',
-        authorRole: 'Chief Operating Officer, Meridian Rail',
-        quote: () => 'They spent three weeks in our depots and on night shifts before they showed us a single slide. The rosters we run today are theirs, and so are the eleven people on my team who now maintain them.',
-    },
-    {
-        authorName: 'Tomás Aguirre',
-        authorRole: 'Group Finance Director, Castell & Vane Hotels',
-        quote: () => 'The pricing desk paid for the whole engagement in its first eleven weeks. What I value more is that my general managers now argue about the forecast using the same numbers.',
-    },
-    {
-        authorName: 'Daniel Whitcombe',
-        authorRole: 'Chief Executive, Kellmoor City Council',
-        quote: (firm) => `${firm} was the only adviser that asked to see our statutory duties before our cost base. Every saving in the plan was checked against them, and none has had to be reversed.`,
-    },
-];
 // ---------------------------------------------------------------------------
 // Pages
 // ---------------------------------------------------------------------------
 const BLOCK_VERSION = '1.0.0';
+function block(key, type, data) {
+    return { _key: key, _type: type, _version: BLOCK_VERSION, ...data };
+}
 function prose(key, parts) {
-    return {
-        _key: key,
-        _type: 'prose',
-        _version: BLOCK_VERSION,
-        body: richText(`${key}-body`, parts),
-    };
+    return block(key, 'prose', { body: richText(`${key}-body`, parts) });
+}
+function questions(key, items) {
+    return items.map(([question, answer], index) => ({
+        _key: `${key}-${index}`,
+        question,
+        answer: richText(`${key}-${index}-a`, [{ p: answer }]),
+    }));
 }
-const LOGO_KEYS = [
-    'logo-meridian-rail',
-    'logo-castell-vane',
-    'logo-aldermoor',
-    'logo-brightwater',
-    'logo-nordvik',
-    'logo-oakfield-health',
-];
-const LOGO_NAMES = {
-    'logo-meridian-rail': 'Meridian Rail',
-    'logo-castell-vane': 'Castell & Vane Hotels',
-    'logo-aldermoor': 'Aldermoor Bank',
-    'logo-brightwater': 'Brightwater Foods',
-    'logo-nordvik': 'Nordvik Industries',
-    'logo-oakfield-health': 'Oakfield Health',
-};
 /**
- * `home` (ten blocks: hero, selected clients, practices, the firm in figures,
- * selected work, a client's words, research and its exhibit, questions, and
- * the call to action), `practices`, `case-studies`, `about` and `contact`.
- *
- * A function of `media` (`SeedContext.media`), of the real practice ids
- * `seedVitrineDemoContent` assigns (`serviceIdBySlug`) and of the firm's name.
- * All three default, so `buildVitrineDemoPages({})` still returns complete,
- * contract-valid pages: a block whose required media is absent is omitted
- * rather than emitted invalid.
+ * Every page of the site, in the copy's language: home, solutions, case
+ * studies, company, careers, news, contact, legal notice, privacy and photo
+ * credits. A block whose media is absent is omitted rather than emitted
+ * invalid, so `buildVitrineDemoPages(copy)` alone returns contract-valid pages.
  */
-export function buildVitrineDemoPages(media = {}, serviceIdBySlug = new Map(), firm = DEFAULT_FIRM_NAME) {
-    const serviceLink = (slug) => {
-        const id = serviceIdBySlug.get(slug);
-        return id === undefined ? undefined : { collection: 'service', id };
-    };
-    const practices = (key, title) => ({
-        _key: key,
-        _type: 'featureGrid',
-        _version: BLOCK_VERSION,
+export function buildVitrineDemoPages(copy, context = {}) {
+    const media = context.media ?? {};
+    const firm = context.firm ?? DEFAULT_FIRM_NAME;
+    const words = copy.pages(firm);
+    const slug = copy.pageSlugs;
+    const path = (key) => `/${slug[key]}`;
+    const taxonomy = copy.schema.taxonomy.name;
+    const [ops, water, offshore] = copy.testimonials;
+    const figure = (key, name, caption, align = 'wide') => media[name] === undefined
+        ? []
+        : [block(key, 'mediaFigure', { media: media[name], caption, ratio: 'original', align })];
+    const testimonialBlock = (key, entry) => block(key, 'testimonial', {
+        quote: richText(`${key}-quote`, [{ p: entry.quote(firm) }]),
+        attribution: { name: entry.authorName, role: entry.authorRole },
+    });
+    const list = (key, collection, layout, limit, title, sort = 'asc') => block(key, 'collectionList', {
+        ...(title === undefined ? {} : { title }),
+        collection,
+        sort: { field: 'createdAt', direction: sort },
+        limit,
+        layout,
+    });
+    const logos = copy.clients.filter((client) => media[client.key] !== undefined);
+    const heroBlock = (key, eyebrow, title, subtitle, mediaName, actions) => block(key, 'hero', {
+        eyebrow,
         title,
-        items: VITRINE_DEMO_SERVICES.map((demo, index) => {
-            const link = serviceLink(demo.slug);
-            return {
-                _key: `${key}-${index}`,
-                icon: demo.icon,
-                title: demo.name,
-                text: demo.description,
-                ...(link === undefined ? {} : { link }),
-            };
-        }),
+        subtitle,
+        ...(media[mediaName] === undefined ? {} : { media: media[mediaName] }),
+        actions: actions.map((action) => ({
+            label: action.label,
+            target: { href: action.href },
+            ...(action.primary === true ? { emphasis: 'primary' } : {}),
+        })),
     });
-    const logoIds = LOGO_KEYS.map((key) => ({ key, id: media[key] })).filter((entry) => entry.id !== undefined);
-    const callToAction = (key) => ({
-        _key: key,
-        _type: 'cta',
-        _version: BLOCK_VERSION,
-        title: 'Tell us about the decision in front of you',
-        text: 'A partner will reply within two working days to arrange a first conversation. There is no charge for it and no obligation.',
-        actions: [{ label: 'Contact an office', target: { href: '/contact' }, emphasis: 'primary' }],
+    const cta = (key, title, text, actions) => block(key, 'cta', {
+        title,
+        text,
+        actions: actions.map((action) => ({
+            label: action.label,
+            target: { href: action.href },
+            ...(action.primary === true ? { emphasis: 'primary' } : {}),
+        })),
     });
-    const [rail, hotels, council] = VITRINE_DEMO_TESTIMONIALS;
-    const avatar = (index) => {
-        const id = media[`avatar-${index}`];
-        return id === undefined ? {} : { avatar: id };
-    };
-    const home = {
-        title: 'Home',
-        slug: 'home',
-        blocks: [
-            {
-                _key: 'demo-home-hero',
-                _type: 'hero',
-                _version: BLOCK_VERSION,
-                eyebrow: 'Management consultancy · London, New York, Singapore',
-                title: 'Decisions that still hold a year later',
-                subtitle: 'We advise the boards and executive teams of companies with £50 million to £2 billion in revenue on strategy, operations and transactions, and we stay until the results show in the accounts.',
-                ...(media.hero === undefined ? {} : { media: media.hero }),
-                actions: [
-                    { label: 'Discuss a mandate', target: { href: '/contact' }, emphasis: 'primary' },
-                    { label: 'Selected work', target: { href: '/case-studies' } },
-                ],
-            },
-            ...(logoIds.length === 0
-                ? []
-                : [
-                    {
-                        _key: 'demo-home-clients',
-                        _type: 'logoStrip',
-                        _version: BLOCK_VERSION,
-                        logos: logoIds.map((logo, index) => ({
-                            _key: `demo-home-client-${index}`,
-                            media: logo.id,
-                        })),
-                        caption: 'Selected clients',
-                    },
-                ]),
-            practices('demo-home-practices', 'Practices'),
-            {
-                _key: 'demo-home-figures',
-                _type: 'stats',
-                _version: BLOCK_VERSION,
-                title: 'The firm in figures',
-                items: [
-                    { _key: 'demo-home-figure-1', value: '340', label: 'engagements completed since 2011' },
-                    {
-                        _key: 'demo-home-figure-2',
-                        value: '72',
-                        unit: '%',
-                        label: 'of fees from clients who have worked with us before',
-                    },
-                    {
-                        _key: 'demo-home-figure-3',
-                        value: '58',
-                        label: 'consultants, a third of them former operating executives',
-                    },
-                    {
-                        _key: 'demo-home-figure-4',
-                        value: '3',
-                        label: 'offices, in London, New York and Singapore',
-                    },
-                ],
-            },
-            {
-                _key: 'demo-home-work',
-                _type: 'collectionList',
-                _version: BLOCK_VERSION,
-                title: 'Selected work',
-                collection: 'case_study',
-                sort: { field: 'createdAt', direction: 'asc' },
-                limit: 3,
-                layout: 'list',
-            },
-            {
-                _key: 'demo-home-testimonial',
-                _type: 'testimonial',
-                _version: BLOCK_VERSION,
-                quote: richTextParagraph('demo-home-testimonial-quote', rail.quote(firm)),
-                attribution: { name: rail.authorName, role: rail.authorRole, ...avatar(0) },
-            },
-            prose('demo-home-research', [
-                { h2: 'Research' },
-                {
-                    p: 'Each year we survey the finance and operations leaders of mid-sized companies. The 2026 edition covers 412 companies in four countries, and its central finding is simple: the number of separate planning cycles a company runs predicts how much cash is tied up in the business better than its sector or its size.',
-                },
-                {
-                    p: 'Companies that had merged three or more of those cycles released a median 3.8% of revenue in working capital within a year. The full report, with the method and the questionnaire, is available from any of our offices.',
-                },
+    const page = (key, pageSlug, blocks) => ({
+        title: words.titles[key],
+        slug: pageSlug,
+        blocks,
+    });
+    const home = page('home', 'home', [
+        heroBlock('home-hero', words.home.heroEyebrow, words.home.heroTitle, words.home.heroSubtitle, 'hero', [
+            { label: words.home.heroPrimary, href: path('contact'), primary: true },
+            { label: words.home.heroSecondary, href: path('caseStudies') },
+        ]),
+        ...(logos.length === 0
+            ? []
+            : [
+                block('home-clients', 'logoStrip', {
+                    logos: logos.map((client, index) => ({
+                        _key: `home-client-${index}`,
+                        media: media[client.key],
+                    })),
+                    caption: words.home.clientsCaption,
+                }),
             ]),
-            ...(media.exhibit === undefined
-                ? []
-                : [
-                    {
-                        _key: 'demo-home-exhibit',
-                        _type: 'mediaFigure',
-                        _version: BLOCK_VERSION,
-                        media: media.exhibit,
-                        caption: 'Exhibit 3, 2026 Mid-Market Operations Survey. Companies grouped by how many of their budget, sales and operations, workforce and capital planning cycles they had merged.',
-                        credit: `Source: ${firm} analysis`,
-                        ratio: 'original',
-                        align: 'wide',
-                    },
-                ]),
-            homeFaq(),
-            callToAction('demo-home-cta'),
-        ],
-    };
-    const practicesPage = {
-        title: 'Practices',
-        slug: 'practices',
-        blocks: [
-            prose('demo-practices-intro', [
-                {
-                    p: `${firm} is organised in six practices. Each is led by partners who have held operating roles in the field they advise on, and most engagements draw on two or three of them.`,
-                },
+        list('home-solutions', 'solution', 'grid', 6, words.home.solutionsTitle),
+        block('home-figures', 'stats', {
+            title: words.home.figuresTitle,
+            items: words.home.figures.map((item, index) => ({ _key: `home-figure-${index}`, ...item })),
+        }),
+        prose('home-platform', words.home.platformIntro),
+        ...figure('home-platform-figure', 'platform-overview', words.home.platformCaption, 'wide'),
+        block('home-sectors', 'featureGrid', {
+            title: words.home.sectorsTitle,
+            items: copy.sectors.map((sector, index) => ({
+                _key: `home-sector-${index}`,
+                icon: sector.icon,
+                title: sector.name,
+                text: sector.text,
+                link: { href: `/${taxonomy}/${sector.slug}` },
+            })),
+        }),
+        list('home-work', 'case_study', 'list', 3, words.home.workTitle),
+        testimonialBlock('home-testimonial', ops),
+        list('home-news', 'post', 'grid', 3, words.home.newsTitle, 'desc'),
+        block('home-faq', 'faq', {
+            title: words.home.faqTitle,
+            items: questions('home-faq', words.home.faq),
+        }),
+        cta('home-cta', words.home.ctaTitle, words.home.ctaText, [
+            { label: words.home.ctaPrimary, href: path('contact'), primary: true },
+            { label: words.home.ctaSecondary, href: path('solutions') },
+        ]),
+    ]);
+    const solutions = page('solutions', slug.solutions, [
+        prose('solutions-intro', words.solutions.intro),
+        list('solutions-list', 'solution', 'grid', 12, words.solutions.listTitle),
+        ...figure('solutions-detail', 'platform-detail', words.solutions.detailCaption, 'wide'),
+        block('solutions-method', 'accordion', {
+            title: words.solutions.methodTitle,
+            items: questions('solutions-method', words.solutions.method),
+        }),
+        cta('solutions-cta', words.home.ctaTitle, words.home.ctaText, [
+            { label: words.home.ctaPrimary, href: path('contact'), primary: true },
+        ]),
+    ]);
+    const caseStudies = page('caseStudies', slug.caseStudies, [
+        prose('work-intro', words.caseStudies.intro),
+        list('work-all', 'case_study', 'grid', 12),
+        block('work-figures', 'stats', {
+            title: words.caseStudies.figuresTitle,
+            items: words.caseStudies.figures.map((item, index) => ({
+                _key: `work-figure-${index}`,
+                ...item,
+            })),
+        }),
+        ...(logos.length === 0
+            ? []
+            : [
+                block('work-clients', 'logos', {
+                    title: words.caseStudies.logosTitle,
+                    items: logos.map((client, index) => ({
+                        _key: `work-client-${index}`,
+                        media: media[client.key],
+                        name: client.name,
+                    })),
+                }),
             ]),
-            practices('demo-practices-list', 'Six practices'),
-            {
-                _key: 'demo-practices-method',
-                _type: 'accordion',
-                _version: BLOCK_VERSION,
-                title: 'How an engagement runs',
-                items: [
-                    [
-                        'Diagnostic',
-                        'Six to ten weeks. We rebuild the facts from your own systems, interview the people who run the work and agree the size of the opportunity with your finance team.',
-                    ],
-                    [
-                        'Design',
-                        'Four to eight weeks. Each change is costed, given an owner and ranked by value and risk. The executive team decides what goes ahead.',
-                    ],
-                    [
-                        'Implementation',
-                        'Six to eighteen months. Our consultants work inside your teams, and the steering group meets every fortnight with a partner present.',
-                    ],
-                    [
-                        'Review',
-                        'Twelve months after we leave, we return for a day at our own cost to check the results against the plan with you.',
-                    ],
-                ].map(([question, answer], index) => ({
-                    _key: `demo-practices-method-${index}`,
-                    question: question,
-                    answer: richTextParagraph(`demo-practices-method-${index}-a`, answer),
-                })),
-            },
-            callToAction('demo-practices-cta'),
-        ],
-    };
-    const caseStudiesPage = {
-        title: 'Case studies',
-        slug: 'case-studies',
-        blocks: [
-            prose('demo-work-intro', [
-                {
-                    p: 'A selection of engagements our clients have agreed to describe in public. Figures are taken from their published accounts or regulatory filings, and each account was reviewed by the client before publication.',
-                },
+        testimonialBlock('work-testimonial', water),
+        cta('work-cta', words.home.ctaTitle, words.home.ctaText, [
+            { label: words.home.ctaPrimary, href: path('contact'), primary: true },
+        ]),
+    ]);
+    const fieldPhotos = ['field-rail', 'field-water', 'field-energy', 'solution-predictive']
+        .map((name) => media[name])
+        .filter((id) => id !== undefined);
+    const company = page('company', slug.company, [
+        heroBlock('company-hero', words.company.heroEyebrow, words.company.heroTitle, words.company.heroSubtitle, 'company-studio', []),
+        prose('company-story', words.company.story),
+        block('company-figures', 'statCounter', {
+            title: words.company.figuresTitle,
+            stats: words.company.figures.map((item, index) => ({
+                _key: `company-figure-${index}`,
+                ...item,
+            })),
+        }),
+        block('company-principles', 'featureGrid', {
+            title: words.company.principlesTitle,
+            items: words.company.principles.map((item, index) => ({
+                _key: `company-principle-${index}`,
+                ...item,
+            })),
+        }),
+        ...figure('company-lab', 'company-lab', words.company.labCaption, 'wide'),
+        block('company-team', 'featureGrid', {
+            title: words.company.teamTitle,
+            items: copy.team.map((member, index) => ({
+                _key: `company-team-${index}`,
+                icon: 'user',
+                title: member.name,
+                text: `${member.role}. ${member.description}`,
+            })),
+        }),
+        ...(fieldPhotos.length === 0
+            ? []
+            : [
+                prose('company-field-title', [{ h2: words.company.fieldTitle }]),
+                block('company-field', 'gallery', {
+                    items: fieldPhotos.map((id, index) => ({ _key: `company-field-${index}`, media: id })),
+                    layout: 'grid',
+                }),
             ]),
-            {
-                _key: 'demo-work-all',
-                _type: 'collectionList',
-                _version: BLOCK_VERSION,
-                collection: 'case_study',
-                sort: { field: 'createdAt', direction: 'asc' },
-                limit: 12,
-                layout: 'grid',
-            },
-            ...(logoIds.length === 0
-                ? []
-                : [
-                    {
-                        _key: 'demo-work-clients',
-                        _type: 'logos',
-                        _version: BLOCK_VERSION,
-                        title: 'Clients we have advised',
-                        items: logoIds.map((logo, index) => ({
-                            _key: `demo-work-client-${index}`,
-                            media: logo.id,
-                            name: LOGO_NAMES[logo.key],
-                        })),
-                    },
+        testimonialBlock('company-testimonial', offshore),
+        cta('company-cta', words.careers.heroTitle, words.careers.heroSubtitle, [
+            { label: words.careers.heroAction, href: path('careers'), primary: true },
+        ]),
+    ]);
+    const careers = page('careers', slug.careers, [
+        heroBlock('careers-hero', words.careers.heroEyebrow, words.careers.heroTitle, words.careers.heroSubtitle, 'careers-hero', [{ label: words.careers.ctaAction, href: 'mailto:jobs@example.com', primary: true }]),
+        prose('careers-intro', words.careers.intro),
+        list('careers-roles', 'job', 'list', 20, words.careers.rolesTitle),
+        block('careers-benefits', 'featureGrid', {
+            title: words.careers.benefitsTitle,
+            items: words.careers.benefits.map((item, index) => ({
+                _key: `careers-benefit-${index}`,
+                ...item,
+            })),
+        }),
+        block('careers-process', 'accordion', {
+            title: words.careers.processTitle,
+            items: questions('careers-process', words.careers.process),
+        }),
+        cta('careers-cta', words.careers.ctaTitle, words.careers.ctaText, [
+            { label: words.careers.ctaAction, href: 'mailto:jobs@example.com', primary: true },
+        ]),
+    ]);
+    const news = page('news', slug.news, [
+        prose('news-intro', words.news.intro),
+        list('news-all', 'post', 'grid', 24, undefined, 'desc'),
+    ]);
+    const contact = page('contact', slug.contact, [
+        prose('contact-offices', words.contact.intro),
+        ...figure('contact-office', 'contact-office', words.contact.officeCaption, 'wide'),
+        cta('contact-cta', words.contact.ctaTitle, words.contact.ctaText, [
+            { label: words.contact.ctaAction, href: 'mailto:contact@example.com', primary: true },
+        ]),
+    ]);
+    const legal = page('legal', slug.legal, [prose('legal-body', words.legal)]);
+    const privacy = page('privacy', slug.privacy, [prose('privacy-body', words.privacy)]);
+    const credits = page('credits', slug.credits, [
+        prose('credits-body', [
+            ...words.credits.intro,
+            {
+                bullets: VITRINE_PHOTO_CREDITS.map((credit) => [
+                    `${credit.title} · ${credit.author} · `,
+                    credit.licenceUrl === undefined
+                        ? credit.licence
+                        : { text: credit.licence, href: credit.licenceUrl },
+                    ' · ',
+                    { text: words.credits.sourceWord, href: credit.source },
                 ]),
-            callToAction('demo-work-cta'),
-        ],
-    };
-    const about = {
-        title: 'About',
-        slug: 'about',
-        blocks: [
-            prose('demo-about-story', [
-                {
-                    p: `${firm} was founded in London in 2011 by four partners who had spent their careers running operations inside mid-sized companies before advising them.`,
-                },
-                { h2: 'Why we started' },
-                {
-                    p: 'Large consultancies were built for the largest companies, and their methods assume a head office with hundreds of analysts. Companies with a few thousand employees need the same quality of thinking from a team that fits in their building and understands a business where the chief executive signs the larger purchase orders.',
-                },
-                { h2: 'How we work' },
-                {
-                    p: 'A partner leads every engagement from the first meeting to the final review. Teams are small and stay with a client from diagnosis to implementation, and we publish our research so clients can judge our thinking before they hire us.',
-                },
-                {
-                    p: 'We opened in New York in 2016 and in Singapore in 2021, each time to follow clients who were expanding there.',
-                },
-                { h2: 'Ownership' },
-                {
-                    p: 'The firm is a limited liability partnership owned by its 14 partners. We have no outside shareholders and no commercial relationships with software vendors.',
-                },
-            ]),
-            {
-                _key: 'demo-about-figures',
-                _type: 'statCounter',
-                _version: BLOCK_VERSION,
-                title: 'Since 2011',
-                stats: [
-                    { _key: 'demo-about-figure-1', value: '340', label: 'engagements completed' },
-                    {
-                        _key: 'demo-about-figure-2',
-                        value: '14',
-                        label: 'partners, each with operating experience',
-                    },
-                    {
-                        _key: 'demo-about-figure-3',
-                        value: '21',
-                        label: 'countries where clients have operations',
-                    },
-                    {
-                        _key: 'demo-about-figure-4',
-                        value: '£1.9bn',
-                        label: 'of cash and profit our clients have reported',
-                    },
-                ],
-            },
-            {
-                _key: 'demo-about-quote-hotels',
-                _type: 'quote',
-                _version: BLOCK_VERSION,
-                text: hotels.quote(firm),
-                author: hotels.authorName,
-                role: hotels.authorRole,
-                ...avatar(1),
-            },
-            {
-                _key: 'demo-about-quote-council',
-                _type: 'quote',
-                _version: BLOCK_VERSION,
-                text: council.quote(firm),
-                author: council.authorName,
-                role: council.authorRole,
-                ...avatar(2),
-            },
-            callToAction('demo-about-cta'),
-        ],
-    };
-    const contact = {
-        title: 'Contact',
-        slug: 'contact',
-        blocks: [
-            prose('demo-contact-offices', [
-                {
-                    p: 'Write to the office nearest to you, or to any partner you already know. We reply within two working days.',
-                },
-                { h2: 'London' },
-                {
-                    p: '12 Hanover Square, London W1S 1JB, United Kingdom. Telephone +44 20 7946 0321. london@example.com',
-                },
-                { h2: 'New York' },
-                {
-                    p: '230 Park Avenue, Floor 10, New York, NY 10169, United States. Telephone +1 212 555 0148. newyork@example.com',
-                },
-                { h2: 'Singapore' },
-                {
-                    p: '8 Marina View, #32-01, Singapore 018960. Telephone +65 6555 0172. singapore@example.com',
-                },
-                { h2: 'Careers' },
-                {
-                    p: 'We recruit experienced hires throughout the year and graduates each autumn. Send a CV and a short note on the kind of work you want to do to careers@example.com.',
-                },
-            ]),
-            {
-                _key: 'demo-contact-cta',
-                _type: 'cta',
-                _version: BLOCK_VERSION,
-                title: 'Discuss a mandate',
-                text: 'Describe the decision, its timing and who is involved. A partner will reply within two working days.',
-                actions: [
-                    {
-                        label: 'Write to us',
-                        target: { href: 'mailto:hello@example.com' },
-                        emphasis: 'primary',
-                    },
-                ],
             },
-        ],
+        ]),
+    ]);
+    return [home, solutions, caseStudies, company, careers, news, contact, legal, privacy, credits];
+}
+// ---------------------------------------------------------------------------
+// Menus, settings, widgets
+// ---------------------------------------------------------------------------
+export function vitrineMenus(copy) {
+    const url = (page) => `/${copy.pageSlugs[page]}`;
+    return {
+        header: copy.menus.header.map((item) => ({ label: item.label, url: url(item.page) })),
+        footer: copy.menus.footer.map((item) => ({ label: item.label, url: url(item.page) })),
+        headerAction: { label: copy.menus.action, url: url('contact') },
     };
-    return [home, practicesPage, caseStudiesPage, about, contact];
 }
-function homeFaq() {
-    const items = [
-        [
-            'What size of company do you work with?',
-            'Most of our clients have annual revenue between £50 million and £2 billion and are owned by founders, families or private equity. We also advise public bodies and a small number of listed companies.',
-        ],
-        [
-            'How is an engagement priced?',
-            'We agree a fixed fee for a defined scope before work starts. On operations programmes, up to a third of the fee can depend on results measured by your own finance team.',
-        ],
-        [
-            'Who will we work with day to day?',
-            'A partner leads every engagement and attends each steering meeting. Teams are small, usually three to six consultants, and the people who scope the work are the people who do it.',
-        ],
-        [
-            'How long does a typical engagement last?',
-            'Diagnostic work takes six to ten weeks. Implementation runs from six to eighteen months, with a formal review at each stage, so you can stop or change course.',
-        ],
-        [
-            'Do you work alongside other advisers?',
-            'Often. We work with auditors, lawyers and systems integrators under a shared plan, and we will say early if another firm is better placed for part of the work.',
-        ],
-    ];
+export function vitrineSiteSettings(copy, firm = DEFAULT_FIRM_NAME) {
+    const settings = copy.settings(firm);
     return {
-        _key: 'demo-home-faq',
-        _type: 'faq',
-        _version: BLOCK_VERSION,
-        title: 'Working with us',
-        items: items.map(([question, answer], index) => ({
-            _key: `demo-home-faq-${index}`,
-            question,
-            answer: richTextParagraph(`demo-home-faq-${index}-a`, answer),
-        })),
+        'general.tagline': settings.tagline,
+        'general.socialLinks': [
+            { label: 'LinkedIn', url: 'https://linkedin.com/company/example' },
+            { label: 'GitHub', url: 'https://github.com/example' },
+            { label: 'YouTube', url: 'https://youtube.com/@example' },
+        ],
+        'general.footerNote': settings.footerNote,
     };
 }
-/** `VITRINE_DEMO_PAGES`: the fixed-shape alias older callers use. Equivalent to `buildVitrineDemoPages({})`. */
-export const VITRINE_DEMO_PAGES = buildVitrineDemoPages({});
-export const VITRINE_RECOMMENDED_AGENTS = [
-    {
-        name: 'seoAgent',
-        package: '@cogenta/agents-builtin',
-        reason: 'Audits practice and case-study pages for on-page SEO issues before they go live.',
-    },
-    {
-        name: 'performanceAgent',
-        package: '@cogenta/agents-builtin',
-        reason: 'Catches oversized images and third-party scripts that would slow the site down.',
-    },
-];
+function onlyOn(...targets) {
+    return { pages: { mode: 'only', targets } };
+}
 /**
- * `vitrine`'s own starting skin, asserted present with a real check rather
- * than a `!`: `STARTING_SKINS` is keyed by blueprint id and TypeScript cannot
- * see that this key is always populated.
+ * The side column beside an entry: on a case study, the sectors, other case
+ * studies and one call to action; on a solution, the other solutions and an
+ * engineer to call, with related case studies under the text; on an article,
+ * recent articles; on a job, the other open roles. Never on a page, which
+ * already carries its own lists and calls to action.
  */
+export function vitrineWidgets(copy) {
+    const w = copy.widgets;
+    const caseStudy = { kind: 'collection', collection: 'case_study' };
+    const solution = { kind: 'collection', collection: 'solution' };
+    const post = { kind: 'collection', collection: 'post' };
+    const job = { kind: 'collection', collection: 'job' };
+    const sector = { kind: 'taxonomy', taxonomy: copy.schema.taxonomy.name };
+    const search = { kind: 'search' };
+    const contactHref = `/${copy.pageSlugs.contact}`;
+    return [
+        {
+            area: 'sidebar',
+            type: 'search',
+            title: w.searchTitle,
+            settings: { placeholder: w.searchPlaceholder },
+            visibility: onlyOn(sector),
+        },
+        {
+            area: 'sidebar',
+            type: 'terms',
+            title: w.sectors,
+            settings: {
+                taxonomy: copy.schema.taxonomy.name,
+                showCounts: true,
+                hierarchical: false,
+                hideEmpty: true,
+            },
+            visibility: onlyOn(caseStudy, sector, search),
+        },
+        {
+            area: 'sidebar',
+            type: 'recentEntries',
+            title: w.moreCaseStudies,
+            settings: { collection: 'case_study', count: 3, showDate: false },
+            visibility: onlyOn(caseStudy),
+        },
+        {
+            area: 'sidebar',
+            type: 'recentEntries',
+            title: w.otherSolutions,
+            settings: { collection: 'solution', count: 6, showDate: false },
+            visibility: onlyOn(solution),
+        },
+        {
+            area: 'sidebar',
+            type: 'contact',
+            title: w.contactTitle,
+            settings: {
+                address: '18 rue des Ateliers, 75011 Paris',
+                phone: '+33 1 99 00 42 17',
+                email: 'contact@example.com',
+                hours: [{ label: w.contactHours, value: w.contactHoursValue }],
+            },
+            visibility: onlyOn(solution),
+        },
+        {
+            area: 'sidebar',
+            type: 'recentEntries',
+            title: w.recentPosts,
+            settings: { collection: 'post', count: 4, showDate: true },
+            visibility: onlyOn(post),
+        },
+        {
+            area: 'sidebar',
+            type: 'recentEntries',
+            title: w.openRoles,
+            settings: { collection: 'job', count: 6, showDate: false },
+            visibility: onlyOn(job),
+        },
+        {
+            area: 'sidebar',
+            type: 'cta',
+            settings: { heading: w.ctaHeading, body: w.ctaBody, label: w.ctaLabel, href: contactHref },
+            visibility: onlyOn(caseStudy, sector, search, post),
+        },
+        {
+            area: 'content-after',
+            type: 'recentEntries',
+            title: w.relatedWork,
+            settings: { collection: 'case_study', count: 3, showDate: false, showImage: true },
+            visibility: onlyOn(solution),
+        },
+    ];
+}
+// ---------------------------------------------------------------------------
+// Media
+// ---------------------------------------------------------------------------
 function vitrinePalette() {
     const skin = STARTING_SKINS.vitrine;
     if (skin === undefined) {
@@ -811,246 +556,169 @@ function vitrinePalette() {
     return skin.color;
 }
 /**
- * The media this blueprint seeds. Every slot names a bundled file under
- * `assets/photos/vitrine/`: a cropped photograph for the hero, the three case
- * studies and the three portraits, a rendered research exhibit, and six client
- * wordmarks drawn once with OFL typefaces. The procedural `spec` is only the
- * fallback `seedDemoMedia` uses if a file is ever missing.
+ * Every slot names a bundled file under `assets/photos/vitrine/`. The
+ * procedural `spec` is only the fallback `seedDemoMedia` uses if a file is
+ * ever missing.
  */
-export const VITRINE_MEDIA_SPECS = [
-    {
-        name: 'hero',
-        spec: heroArt(vitrinePalette(), 'sun', 61),
-        alt: 'Two consultants reviewing a report at a meeting table',
-        photo: 'vitrine/hero-review.jpg',
-    },
-    {
-        name: 'exhibit',
-        spec: coverArt(vitrinePalette(), 62),
-        alt: 'Bar chart: companies that merged three or more planning cycles released a median 3.8% of revenue in working capital, against 0.4% for companies that merged none.',
-        photo: 'vitrine/exhibit-working-capital.png',
-    },
-    ...LOGO_KEYS.map((key, index) => ({
-        name: key,
-        spec: logoArt(70 + index),
-        alt: LOGO_NAMES[key],
-        photo: `vitrine/${key}.png`,
-    })),
-    ...VITRINE_DEMO_TESTIMONIALS.map((demo, index) => ({
-        name: `avatar-${index}`,
-        spec: avatarArt(vitrinePalette(), 80 + index),
-        alt: `Portrait of ${demo.authorName}`,
-        photo: `vitrine/avatar-${index + 1}.jpg`,
-    })),
-    {
-        name: 'case-meridian-rail-punctuality',
-        spec: coverArt(vitrinePalette(), 90),
-        alt: 'Passengers walking along a platform beside a commuter train',
-        photo: 'vitrine/case-rail.jpg',
-    },
-    {
-        name: 'case-castell-vane-pricing',
-        spec: coverArt(vitrinePalette(), 91),
-        alt: 'The dining room of a hotel at dusk, tables laid under a skylight',
-        photo: 'vitrine/case-hotels.jpg',
-    },
-    {
-        name: 'case-kellmoor-council-budget',
-        spec: coverArt(vitrinePalette(), 92),
-        alt: 'The colonnaded front of a city hall in afternoon sun',
-        photo: 'vitrine/case-council.jpg',
-    },
-];
-/** Header/footer navigation and the header call to action (L25, D4). */
-export const VITRINE_MENUS = {
-    header: [
-        { label: 'Practices', url: '/practices' },
-        { label: 'Case studies', url: '/case-studies' },
-        { label: 'About', url: '/about' },
-        { label: 'Contact', url: '/contact' },
-    ],
-    footer: [
-        { label: 'Practices', url: '/practices' },
-        { label: 'Case studies', url: '/case-studies' },
-        { label: 'About', url: '/about' },
-        { label: 'Contact', url: '/contact' },
-    ],
-    headerAction: { label: 'Discuss a mandate', url: '/contact' },
-};
-export const VITRINE_SITE_SETTINGS = {
-    'general.tagline': 'Management consultancy for mid-sized companies, their owners and their boards.',
-    'general.socialLinks': [
-        { label: 'LinkedIn', url: 'https://linkedin.com/company/example' },
-        { label: 'X', url: 'https://x.com/example' },
-        { label: 'YouTube', url: 'https://youtube.com/@example' },
-    ],
-    'general.footerNote': [
-        'London\n12 Hanover Square\nLondon W1S 1JB',
-        'New York\n230 Park Avenue, Floor 10\nNew York, NY 10169',
-        'Singapore\n8 Marina View, #32-01\nSingapore 018960',
-    ].join('\n\n'),
-};
-/**
- * The side column a consultancy's reader expects beside the work: on a case
- * study, the sectors with their counts, the other published engagements and
- * the one call to discuss a mandate; on a practice, the other practices and
- * the partners' switchboard, with selected work under the text; on a sector
- * archive and on search results, the sectors and the same call, plus a
- * search box on the archive (a results page already opens on its own). Never
- * on the home page or on the Practices, Case studies, About and Contact
- * pages, which already carry their own lists and calls to action.
- */
-const VITRINE_CASE_STUDY = { kind: 'collection', collection: 'case_study' };
-const VITRINE_SERVICE = { kind: 'collection', collection: 'service' };
-const VITRINE_SECTOR = { kind: 'taxonomy', taxonomy: 'sector' };
-const VITRINE_SEARCH = { kind: 'search' };
-function onlyOn(...targets) {
-    return { pages: { mode: 'only', targets } };
+export function vitrineMediaSpecs(copy) {
+    const palette = vitrinePalette();
+    return [
+        ...copy.media.map((item, index) => ({
+            name: item.name,
+            spec: item.name === 'hero' ? heroArt(palette, 'sun', 61) : coverArt(palette, 90 + index),
+            alt: item.alt,
+            photo: `vitrine/${item.file}`,
+        })),
+        ...copy.clients.map((client, index) => ({
+            name: client.key,
+            spec: logoArt(70 + index),
+            alt: client.name,
+            photo: `vitrine/${client.key}.png`,
+        })),
+    ];
 }
-export const VITRINE_WIDGETS = [
-    {
-        area: 'sidebar',
-        type: 'search',
-        title: 'Search the site',
-        settings: { placeholder: 'A client or a sector' },
-        visibility: onlyOn(VITRINE_SECTOR),
-    },
-    {
-        area: 'sidebar',
-        type: 'terms',
-        title: 'Sectors',
-        settings: { taxonomy: 'sector', showCounts: true, hierarchical: false, hideEmpty: true },
-        visibility: onlyOn(VITRINE_CASE_STUDY, VITRINE_SECTOR, VITRINE_SEARCH),
-    },
-    {
-        area: 'sidebar',
-        type: 'recentEntries',
-        title: 'More case studies',
-        settings: { collection: 'case_study', count: 3, showDate: false },
-        visibility: onlyOn(VITRINE_CASE_STUDY),
-    },
-    {
-        area: 'sidebar',
-        type: 'recentEntries',
-        title: 'Other practices',
-        settings: { collection: 'service', count: 6, showDate: false },
-        visibility: onlyOn(VITRINE_SERVICE),
-    },
-    {
-        area: 'sidebar',
-        type: 'contact',
-        title: 'Speak to a partner',
-        settings: {
-            address: '12 Hanover Square, London W1S 1JB',
-            phone: '+44 20 7946 0321',
-            email: 'hello@example.com',
-            hours: [{ label: 'Monday to Friday', value: '8:30 to 18:30' }],
-        },
-        visibility: onlyOn(VITRINE_SERVICE),
-    },
+export const VITRINE_RECOMMENDED_AGENTS = [
     {
-        area: 'sidebar',
-        type: 'cta',
-        settings: {
-            heading: 'Facing a similar decision?',
-            body: 'Describe it in a few lines. A partner will reply within two working days, at no charge.',
-            label: 'Discuss a mandate',
-            href: '/contact',
-        },
-        visibility: onlyOn(VITRINE_CASE_STUDY, VITRINE_SECTOR, VITRINE_SEARCH),
+        name: 'seoAgent',
+        package: '@cogenta/agents-builtin',
+        reason: 'Audits solution, case study and article pages for on-page SEO issues before they go live.',
     },
     {
-        area: 'content-after',
-        type: 'recentEntries',
-        title: 'Selected work',
-        settings: { collection: 'case_study', count: 3, showDate: false, showImage: true },
-        visibility: onlyOn(VITRINE_SERVICE),
+        name: 'performanceAgent',
+        package: '@cogenta/agents-builtin',
+        reason: 'Catches oversized images and third-party scripts that would slow the site down.',
     },
 ];
+// ---------------------------------------------------------------------------
+// Seeding
+// ---------------------------------------------------------------------------
 /**
  * Inserts the demo content through the real `ContentStore` and taxonomy store
- * (never mocked, house rule). Sectors first, then practices and case studies,
- * whose ids the home page's links and lists need; everything is published,
- * since a theme lists only published entries.
+ * (never mocked, house rule): sectors first, then every collection, then the
+ * pages. Everything is published, since a theme lists only published entries.
  */
-async function seedVitrineDemoContent(ctx) {
-    const { db, defaultLocale, adminId, media } = ctx;
-    const firm = ctx.siteName?.trim() || DEFAULT_FIRM_NAME;
-    const sectorStore = createTaxonomyStore({ db, taxonomy: sector });
-    const serviceStore = createContentStore({ db, collection: service, defaultLocale });
-    const caseStudyStore = createContentStore({ db, collection: caseStudy, defaultLocale });
-    const testimonialStore = createContentStore({ db, collection: testimonial, defaultLocale });
-    const pageStore = createContentStore({ db, collection: page, defaultLocale });
-    const sectorIdBySlug = new Map();
-    for (const demo of VITRINE_DEMO_SECTORS) {
-        const term = await sectorStore.create({
-            slug: demo.slug,
-            labels: { [defaultLocale]: demo.name },
-        });
-        sectorIdBySlug.set(demo.slug, term.id);
-    }
-    const serviceIdBySlug = new Map();
-    for (const demo of VITRINE_DEMO_SERVICES) {
-        const created = await serviceStore.create({
-            status: 'published',
-            createdBy: adminId,
-            values: {
-                name: demo.name,
-                slug: demo.slug,
-                description: demo.description,
-                body: richText(`service-${demo.slug}`, demo.body(firm)),
-                icon: demo.icon,
-            },
-        });
-        serviceIdBySlug.set(demo.slug, created.id);
-    }
-    for (const demo of VITRINE_DEMO_CASE_STUDIES) {
-        const cover = media[`case-${demo.slug}`];
-        await caseStudyStore.create({
-            status: 'published',
-            createdBy: adminId,
-            values: {
-                title: demo.title,
-                slug: demo.slug,
-                client: demo.client,
-                summary: demo.summary,
-                body: richText(`case-${demo.slug}`, demo.body(firm)),
-                sector: sectorIdBySlug.get(demo.sectorSlug) ?? null,
-                ...(cover === undefined ? {} : { coverImage: cover }),
-            },
-        });
-    }
-    for (const [index, demo] of VITRINE_DEMO_TESTIMONIALS.entries()) {
-        const portrait = media[`avatar-${index}`];
-        await testimonialStore.create({
-            status: 'published',
-            createdBy: adminId,
-            values: {
-                authorName: demo.authorName,
-                authorRole: demo.authorRole,
-                quote: demo.quote(firm),
-                ...(portrait === undefined ? {} : { avatar: portrait }),
-            },
-        });
-    }
-    for (const demo of buildVitrineDemoPages(media, serviceIdBySlug, firm)) {
-        await pageStore.create({
-            status: 'published',
-            createdBy: adminId,
-            values: { title: demo.title, slug: demo.slug },
-            blocks: { blocks: demo.blocks.map(toBlockZoneEntry) },
-        });
-    }
+function seedVitrineDemoContent(copy) {
+    return async (ctx) => {
+        const { db, defaultLocale, adminId, media } = ctx;
+        const firm = ctx.siteName?.trim() || DEFAULT_FIRM_NAME;
+        const model = vitrineSchema(copy);
+        const store = (collection) => createContentStore({ db, collection, defaultLocale });
+        const sectorStore = createTaxonomyStore({ db, taxonomy: model.sector });
+        const sectorIdBySlug = new Map();
+        for (const sector of copy.sectors) {
+            const term = await sectorStore.create({
+                slug: sector.slug,
+                labels: { [defaultLocale]: sector.name },
+            });
+            sectorIdBySlug.set(sector.slug, term.id);
+        }
+        const cover = (name) => (media[name] === undefined ? {} : { coverImage: media[name] });
+        const published = { status: 'published', createdBy: adminId };
+        const solutions = store(model.solution);
+        for (const item of copy.solutions) {
+            await solutions.create({
+                ...published,
+                values: {
+                    name: item.name,
+                    slug: item.slug,
+                    description: item.description,
+                    body: richText(`solution-${item.slug}`, item.body(firm)),
+                    icon: item.icon,
+                    ...cover(item.media),
+                },
+            });
+        }
+        const caseStudies = store(model.caseStudy);
+        for (const item of copy.caseStudies) {
+            await caseStudies.create({
+                ...published,
+                values: {
+                    title: item.title,
+                    slug: item.slug,
+                    client: item.client,
+                    location: item.location,
+                    keyFigure: item.keyFigure,
+                    keyFigureLabel: item.keyFigureLabel,
+                    summary: item.summary,
+                    body: richText(`case-${item.slug}`, item.body(firm)),
+                    sector: sectorIdBySlug.get(item.sector) ?? null,
+                    ...cover(item.media),
+                },
+            });
+        }
+        const testimonials = store(model.testimonial);
+        for (const item of copy.testimonials) {
+            await testimonials.create({
+                ...published,
+                values: {
+                    authorName: item.authorName,
+                    authorRole: item.authorRole,
+                    quote: item.quote(firm),
+                },
+            });
+        }
+        const jobs = store(model.job);
+        for (const item of copy.jobs) {
+            await jobs.create({
+                ...published,
+                values: {
+                    title: item.title,
+                    slug: item.slug,
+                    team: item.team,
+                    location: item.location,
+                    contract: item.contract,
+                    summary: item.summary,
+                    body: richText(`job-${item.slug}`, item.body(firm)),
+                },
+            });
+        }
+        // Oldest first, so a list sorted by creation date newest first reads in
+        // publication order.
+        const posts = store(model.post);
+        for (const item of [...copy.posts].sort((a, b) => a.publishedAt.localeCompare(b.publishedAt))) {
+            await posts.create({
+                ...published,
+                values: {
+                    title: item.title,
+                    slug: item.slug,
+                    summary: item.summary,
+                    author: item.author,
+                    publishedAt: item.publishedAt,
+                    body: richText(`post-${item.slug}`, item.body(firm)),
+                    sector: sectorIdBySlug.get(item.sector) ?? null,
+                    ...cover(item.media),
+                },
+            });
+        }
+        const pages = store(model.page);
+        for (const demo of buildVitrineDemoPages(copy, { media, firm })) {
+            await pages.create({
+                ...published,
+                values: { title: demo.title, slug: demo.slug },
+                blocks: { blocks: demo.blocks.map(toBlockZoneEntry) },
+            });
+        }
+    };
 }
-export const vitrineContentPack = {
-    collections: VITRINE_COLLECTIONS,
-    taxonomies: VITRINE_TAXONOMIES,
-    recommendedAgents: VITRINE_RECOMMENDED_AGENTS,
-    seedDemoContent: seedVitrineDemoContent,
-    defaultTheme: '@cogenta/theme-entreprise',
-    menus: VITRINE_MENUS,
-    widgets: VITRINE_WIDGETS,
-    siteSettings: VITRINE_SITE_SETTINGS,
-    mediaSpecs: VITRINE_MEDIA_SPECS,
-};
+/** The whole blueprint, in one language. */
+export function createVitrineContentPack(locale) {
+    const copy = vitrineCopyFor(locale);
+    const model = vitrineSchema(copy);
+    return {
+        collections: model.collections,
+        taxonomies: model.taxonomies,
+        recommendedAgents: VITRINE_RECOMMENDED_AGENTS,
+        seedDemoContent: seedVitrineDemoContent(copy),
+        defaultTheme: '@cogenta/theme-entreprise',
+        menus: vitrineMenus(copy),
+        widgets: vitrineWidgets(copy),
+        siteSettings: vitrineSiteSettings(copy),
+        mediaSpecs: vitrineMediaSpecs(copy),
+        // A company site: no comment thread under a solution, a case study, a
+        // job opening or a press article.
+        commentsDisabledOn: ['solution', 'case_study', 'job', 'post'],
+    };
+}
+/** The English pack, which `BLUEPRINT_CONTENT_PACKS` lists; `contentPackFor` picks by locale. */
+export const vitrineContentPack = createVitrineContentPack('en');
 //# sourceMappingURL=vitrine.js.map