create-cogenta 0.2.1 → 0.5.0

package/dist/blueprints/portfolio.js

@@ -1,9 +1,23 @@
+import { CogentaError } from '@cogenta/core';
 import { createContentStore, defineCollection, f, validateCollectionSet, } from '@cogenta/schema';
-import { definePageCollection, toBlockZoneEntry, } from './content-pack.js';
+import { avatarArt, coverArt, heroArt, logoArt } from '../demo-art/compositions.js';
+import { definePageCollection, richTextParagraph, SEO_FIELDS, toBlockZoneEntry, } from './content-pack.js';
+import { STARTING_SKINS } from './starting-skins.js';
 /**
- * The `portfolio` blueprint's content model (L9 task 8, batch A): a
- * freelance/creative portfolio — a `project` collection with its own
- * routed page, and two demo pages.
+ * The `portfolio` blueprint (L25 Annexe brief, `theme-portfolio` pro pass):
+ * a `project` collection — cover image, `role`/`year` as plain structured
+ * fields (a `collectionList` grid card and a project's own page both read
+ * them straight off the entry, `@cogenta/theme-portfolio`'s own doing, not
+ * this blueprint's) — plus a genuinely rich single-page home the theme
+ * renders as full-bleed project cards, a services grid with real icons, a
+ * client logo strip and a two-part client voice (`quote` then
+ * `testimonial`).
+ *
+ * Rewritten in full for the L25 pro pass (its L9/L23 predecessor seeded
+ * three home blocks, three projects, no visuals and no menus at all):
+ * eight projects with distinct cover compositions, a nine-block home, an
+ * about page, a contact page, a legal page, real header/footer/header-
+ * action navigation, and `@cogenta/theme-portfolio` as the default theme.
  */
 export const project = defineCollection({
     name: 'project',
@@ -15,6 +29,17 @@ export const project = defineCollection({
         summary: f.text({ max: 300, multiline: true }),
         role: f.text({ max: 120 }),
         year: f.text({ max: 4 }),
+        coverImage: f.media({ accept: ['image'] }),
+        // Optional body a project page renders after its own header — the
+        // seed below places one auto-built "Role / Year" panel here (a flat,
+        // muted-background `prose` block, `blocks@2.0`'s `variant`), the
+        // in-scope way this theme shows those two raw fields on the project's
+        // own page (`renderEntryHeader` draws only title/cover/excerpt from
+        // contract D `theme@1.4`'s fixed `PageEntryMeta` shape, which has no
+        // room for a collection's own custom fields) — never required, so a
+        // project an editor creates by hand without one still renders fine.
+        blocks: f.blocks(),
+        ...SEO_FIELDS,
     },
     indexes: [['slug']],
     permissions: {
@@ -32,122 +57,481 @@ export const PORTFOLIO_DEMO_PROJECTS = [
     {
         title: 'Northwind rebrand',
         slug: 'northwind-rebrand',
-        summary: 'A full visual identity refresh for a regional grocery chain, from logotype to packaging.',
+        summary: 'A full identity refresh for a 41-store regional grocery chain built by acquisition — one logotype and one packaging system across 340 private-label SKUs, rolled out without closing a single store.',
         role: 'Art direction',
         year: '2025',
+        coverSeed: 12,
+        narrative: [
+            'Northwind runs forty-one stores across the Pacific Northwest, most of them acquired rather than built — which meant four legacy logotypes, three shades of the same green, and a private-label range that looked like six different companies. The brief was blunt: make it read as one grocer without asking anyone to repaint a storefront this year.',
+            'We shipped a logotype family with two registers (a plain wordmark for the storefront, a warmer hand for seasonal signage), a 68-page brand guideline, and new packaging for 340 private-label SKUs, phased across three print runs so nothing hit the shelf half-rebranded. Every store kept trading through every stage — no reprint weekend, no relaunch, no closure.',
+        ],
     },
     {
         title: 'Contoso mobile app',
         slug: 'contoso-mobile-app',
-        summary: 'Interaction design and a component library for a fintech app used by two million people.',
+        summary: 'A ground-up component library and interaction redesign for a fintech app used by two million people, rebuilt around one confirmation pattern for every place money moves.',
         role: 'Product design',
-        year: '2024',
+        year: '2025',
+        coverSeed: 27,
+        narrative: [
+            "Contoso's banking app had grown a screen at a time for six years, and it showed: four different date pickers, three ways to confirm a transfer, and a design team that had never run a full component audit. Two million people used it anyway, mostly out of habit.",
+            'We rebuilt the library from the transaction list outward — forty-two components, one motion language, one confirmation pattern used everywhere money changes hands — and shipped it behind a flag to five percent of accounts before the full rollout. Support tickets about "where did my transfer go" dropped by a third in the first month.',
+        ],
     },
     {
         title: 'Fabrikam annual report',
         slug: 'fabrikam-annual-report',
-        summary: 'Editorial design for a 60-page annual report, printed and interactive.',
+        summary: 'Editorial design and typesetting for a 60-page annual report — print and an interactive web edition from the same grid, at a 4,000-copy print run.',
         role: 'Editorial design',
+        year: '2024',
+        coverSeed: 41,
+        narrative: [
+            "A 60-page annual report is read closely by maybe a hundred people and skimmed by ten thousand more, so it has to work as a spreadsheet and as a piece of writing at the same time. Fabrikam's finance team wrote the copy; we built the grid that lets a dense results table share a page with a proper photo essay without either one losing.",
+            "Print run of 4,000, plus an interactive web edition built from the same InDesign grid so the numbers stay legible on a phone. The typesetting keeps a single serif for every numeral in the book — auditors notice when a table changes font mid-report, and we'd rather they didn't have the chance to.",
+        ],
+    },
+    {
+        title: 'Litware signage system',
+        slug: 'litware-signage-system',
+        summary: 'Wayfinding and environmental graphics for a 12-storey, four-wing campus — 214 signs and a lobby directory that updates from a spreadsheet, not a repaint.',
+        role: 'Signage & environmental',
+        year: '2024',
+        coverSeed: 58,
+        narrative: [
+            "Twelve storeys, four wings, one loading dock nobody could find without asking twice. Litware's campus had been designed by three different architecture firms over eight years, and the wayfinding showed it — or rather, the near-total absence of it.",
+            'We proofed every sign on the actual material before a single one went into production: brushed aluminium in daylight reads nothing like the same file on a monitor. 214 signs, one pictogram set, and a lobby directory that updates from a single spreadsheet rather than a repaint every time a department changes floors.',
+        ],
+    },
+    {
+        title: 'Tailspin streaming identity',
+        slug: 'tailspin-streaming-identity',
+        summary: 'A motion-first brand system for a live-sports streaming launch across five markets — one grid, five market variants, built to survive a jumbotron and a phone screen alike.',
+        role: 'Brand & motion',
         year: '2023',
+        coverSeed: 63,
+        narrative: [
+            "Tailspin launched live sports streaming in five markets on the same night, which meant the identity had to survive a stadium jumbotron, a phone held sideways and a broadcast truck's colour grading — often all three during the same match.",
+            'The system is built motion-first: the mark only fully resolves once it moves, so every static application — kit, ticket, merchandise — is a single frame pulled from the same animation rather than a logo redrawn to match. Five market-specific colour variants share one grid, and the sixth market that signed on two months after launch needed zero redraws to join it.',
+        ],
     },
-];
-const BLOCK_VERSION = '1.0.0';
-/**
- * `home` (hero + a live grid of projects) and `about` (a short prose bio
- * plus a static `stats` summary — years of experience and projects
- * delivered are page-authored numbers, not something to model as a
- * separate queryable collection).
- */
-export const PORTFOLIO_DEMO_PAGES = [
     {
-        title: 'Home',
-        slug: 'home',
-        blocks: [
-            {
-                _key: 'demo-home-hero',
-                _type: 'hero',
-                _version: BLOCK_VERSION,
-                eyebrow: 'Portfolio',
-                title: 'Selected work',
-                subtitle: 'Scaffolded by create-cogenta from the "portfolio" blueprint, with real demo projects already in place.',
-            },
-            {
-                _key: 'demo-home-projects',
-                _type: 'collectionList',
-                _version: BLOCK_VERSION,
-                title: 'Projects',
-                collection: 'project',
-                sort: { field: 'createdAt', direction: 'desc' },
-                limit: 10,
-                layout: 'grid',
-            },
-            {
-                _key: 'demo-home-services',
-                _type: 'featureGrid',
-                _version: BLOCK_VERSION,
-                title: 'What I take on',
-                items: [
-                    {
-                        _key: 'demo-service-1',
-                        icon: 'identity',
-                        title: 'Identity',
-                        text: 'Naming, marks and the small rules that keep a brand recognisable once other people apply it.',
-                    },
-                    {
-                        _key: 'demo-service-2',
-                        icon: 'editorial',
-                        title: 'Editorial design',
-                        text: 'Books, reports and long-form sites. Typography first, because that is where the reading happens.',
-                    },
-                    {
-                        _key: 'demo-service-3',
-                        icon: 'signage',
-                        title: 'Signage and print',
-                        text: 'Things that get made once and have to be right. Proofed on the material, not on a screen.',
-                    },
-                ],
-            },
+        title: 'Adatum publishing house',
+        slug: 'adatum-publishing-house',
+        summary: 'Cover systems and typesetting for a twelve-title fiction imprint, with one fixed typographic rule and imagery that shifts by genre.',
+        role: 'Editorial design',
+        year: '2023',
+        coverSeed: 79,
+        narrative: [
+            'Twelve titles under one imprint, and a house style that had to hold across a literary novel, a thriller and a story collection without any of the three looking like they belonged on the wrong shelf.',
+            'We built a cover system with one fixed typographic rule — the title always sets in the same face, always in the same position on the spine — and let the imagery vary completely by genre: commissioned illustration for the literary list, photography for the thrillers. Booksellers could tell the imprint from three metres away by the second season.',
         ],
     },
     {
-        title: 'About',
-        slug: 'about',
-        blocks: [
-            {
-                _key: 'demo-about-prose',
-                _type: 'prose',
-                _version: BLOCK_VERSION,
-                body: [
-                    {
-                        _key: 'demo-about-p1',
-                        _type: 'block',
-                        style: 'normal',
-                        children: [
-                            {
-                                _key: 'demo-about-p1-span',
-                                _type: 'span',
-                                text: 'This is a demo portfolio, scaffolded by create-cogenta from the "portfolio" blueprint. Its projects and this page were seeded by the installer so there is real content to look at from the first run.',
-                                marks: [],
-                            },
-                        ],
-                        markDefs: [],
-                    },
-                ],
-            },
-            {
-                _key: 'demo-about-stats',
-                _type: 'stats',
-                _version: BLOCK_VERSION,
-                title: 'At a glance',
-                items: [
-                    { _key: 'demo-stat-1', value: '8', unit: 'years', label: 'in practice' },
-                    { _key: 'demo-stat-2', value: '40+', label: 'projects delivered' },
-                    { _key: 'demo-stat-3', value: '12', label: 'ongoing clients' },
-                ],
-            },
+        title: 'Wingtip terminal wayfinding',
+        slug: 'wingtip-terminal-wayfinding',
+        summary: 'Signage, pictograms and a colour-coded wayfinding system for a regional airport terminal, tested against real foot traffic before fabrication.',
+        role: 'Signage & environmental',
+        year: '2022',
+        coverSeed: 88,
+        narrative: [
+            "A regional airport's wayfinding has about four seconds to work before a traveller who is already late stops trusting it and starts asking a stranger. Wingtip's terminal had grown three extensions since 1994, and its signage had grown with it — six typefaces, and two colour codes that meant different things on different concourses.",
+            'The new system reduces the terminal to three colour-coded zones and one pictogram family, tested against real foot traffic during an actual boarding rush before a single panel was fabricated. Gate-finding complaints at the information desk fell by half in the first reporting quarter.',
+        ],
+    },
+    {
+        title: 'Proseware product launch',
+        slug: 'proseware-product-launch',
+        summary: 'Packaging, retail displays and a launch film for a home-audio product line, shot and shipped in eleven weeks to hit 900 stores on schedule.',
+        role: 'Art direction',
+        year: '2022',
+        coverSeed: 96,
+        narrative: [
+            "Proseware's new speaker line needed to launch retail-ready in eleven weeks — packaging, in-store display and a two-minute film, all built around a product that was still changing in engineering the week we started shooting.",
+            'We designed the packaging to double as its own retail display, so no separate cardboard unit had to be fabricated and shipped, then shot the film against the same modular set the display uses. Assets were delivered in time for the line to hit 900 stores on the date the client had already announced. Nothing slipped.',
         ],
     },
 ];
+const BLOCK_VERSION = '1.0.0';
+/**
+ * A short, structural rich-text list — no HTML in a block (R3), a bullet
+ * list is the honest equivalent of a two-row "spec sheet".
+ */
+function labelValueRow(key, label, value) {
+    return [
+        {
+            _key: `${key}-p`,
+            _type: 'block',
+            style: 'normal',
+            children: [
+                { _key: `${key}-label`, _type: 'span', text: `${label} `, marks: ['strong'] },
+                { _key: `${key}-value`, _type: 'span', text: value, marks: [] },
+            ],
+            markDefs: [],
+        },
+    ];
+}
+/**
+ * The auto-built "Role / Year" panel a project's own page shows beneath
+ * `renderEntryHeader` — a flat, muted-background `prose` block
+ * (`blocks@2.0`'s `variant.background`, an existing envelope field every
+ * block already carries, not a new one) built from the same `role`/`year`
+ * text the project's own fields hold. `@cogenta/theme-portfolio`'s
+ * `[data-block][data-variant-background="muted"]` rule is what turns this
+ * into a flat panel — no block-specific CSS needed for it.
+ */
+function roleYearPanelBlock(project) {
+    const body = [
+        ...labelValueRow(`${project.slug}-role`, 'Role', project.role),
+        ...labelValueRow(`${project.slug}-year`, 'Year', project.year),
+    ];
+    return {
+        _key: `${project.slug}-meta`,
+        _type: 'prose',
+        _version: BLOCK_VERSION,
+        body,
+        variant: { background: 'muted' },
+    };
+}
+/**
+ * The project's own narrative (L26 D1) — two real paragraphs of process and
+ * outcome, not the one-line `summary` repeated. Placed after
+ * {@link roleYearPanelBlock} on the project's own page.
+ */
+function projectNarrativeBlock(project) {
+    const body = project.narrative.flatMap((paragraph, index) => richTextParagraph(`${project.slug}-narrative-${index}`, paragraph));
+    return {
+        _key: `${project.slug}-narrative`,
+        _type: 'prose',
+        _version: BLOCK_VERSION,
+        body,
+    };
+}
+/**
+ * The home page's nine blocks (L25 Annexe brief): hero, "Selected work" (a
+ * full-bleed project grid), the numbers, services, clients, a quote, the
+ * full project index, a testimonial and the closing call to action. Every
+ * block's `_key` doubles as a real in-page anchor
+ * (`@cogenta/theme-portfolio`'s `renderPage`, which stamps a real `id` from
+ * it) — the header/footer menus below link straight into "Selected work"
+ * and "Services" rather than a dead `#fragment`.
+ *
+ * A function of `media` (`SeedContext.media`), not a static const: the
+ * hero/logo media fields need ids `seedDemoMedia` only knows at scaffold
+ * time. `buildPortfolioHomeBlocks({})` (no media) still returns a complete,
+ * valid block list — `hero`/`logoStrip` simply drop their media-bearing
+ * fields rather than emit an invalid block.
+ */
+export function buildPortfolioHomeBlocks(media) {
+    const logoItems = [1, 2, 3, 4, 5]
+        .map((n) => media[`logo-${n}`])
+        .filter((id) => id !== undefined)
+        .map((id, index) => ({ _key: `home-clients-${index}`, media: id }));
+    return [
+        {
+            _key: 'home-hero',
+            _type: 'hero',
+            _version: BLOCK_VERSION,
+            eyebrow: 'Independent studio, est. 2017',
+            title: 'A studio that ships in the open',
+            subtitle: 'Brand systems, product design and editorial work for teams who want to see it made, not just delivered.',
+            ...(media.hero === undefined ? {} : { media: media.hero }),
+            actions: [
+                { label: 'Selected work', target: { href: '/#home-work' }, emphasis: 'primary' },
+                { label: "Let's talk", target: { href: '/contact' } },
+            ],
+        },
+        {
+            _key: 'home-work',
+            _type: 'collectionList',
+            _version: BLOCK_VERSION,
+            title: 'Selected work',
+            collection: 'project',
+            sort: { field: 'createdAt', direction: 'desc' },
+            limit: 6,
+            layout: 'grid',
+        },
+        {
+            _key: 'home-stats',
+            _type: 'stats',
+            _version: BLOCK_VERSION,
+            title: 'At a glance',
+            items: [
+                { _key: 'home-stats-1', value: '8', unit: 'years', label: 'in practice' },
+                { _key: 'home-stats-2', value: '40+', label: 'projects delivered' },
+                { _key: 'home-stats-3', value: '12', label: 'awards & mentions' },
+            ],
+        },
+        {
+            _key: 'home-services',
+            _type: 'featureGrid',
+            _version: BLOCK_VERSION,
+            title: 'Services',
+            items: [
+                {
+                    _key: 'home-service-1',
+                    icon: 'pen',
+                    title: 'Identity',
+                    text: 'Naming, marks and the small rules that keep a brand recognisable once other people apply it.',
+                },
+                {
+                    _key: 'home-service-2',
+                    icon: 'book',
+                    title: 'Editorial design',
+                    text: 'Books, reports and long-form sites. Typography first, because that is where the reading happens.',
+                },
+                {
+                    _key: 'home-service-3',
+                    icon: 'layers',
+                    title: 'Signage & environmental',
+                    text: 'Things that get made once and have to be right. Proofed on the material, not on a screen.',
+                },
+            ],
+        },
+        ...(logoItems.length === 0
+            ? []
+            : [
+                {
+                    _key: 'home-clients',
+                    _type: 'logoStrip',
+                    _version: BLOCK_VERSION,
+                    logos: logoItems,
+                    caption: 'Selected clients',
+                },
+            ]),
+        {
+            _key: 'home-quote',
+            _type: 'quote',
+            _version: BLOCK_VERSION,
+            text: 'They shipped a design system and a working site in the same sprint — and explained every decision along the way.',
+            author: 'A. Reviewer',
+            role: 'Head of brand, Northwind',
+            ...(media['quote-avatar'] === undefined ? {} : { avatar: media['quote-avatar'] }),
+        },
+        {
+            _key: 'home-index',
+            _type: 'collectionList',
+            _version: BLOCK_VERSION,
+            title: 'The full index',
+            collection: 'project',
+            sort: { field: 'createdAt', direction: 'asc' },
+            limit: 8,
+            layout: 'list',
+        },
+        {
+            _key: 'home-testimonial',
+            _type: 'testimonial',
+            _version: BLOCK_VERSION,
+            quote: richTextParagraph('home-testimonial-quote', 'A quietly confident studio — the kind of considered work we keep coming back for.'),
+            attribution: {
+                name: 'M. Bernard',
+                role: 'Founder, Adatum',
+                ...(media['testimonial-avatar'] === undefined
+                    ? {}
+                    : { avatar: media['testimonial-avatar'] }),
+            },
+        },
+        {
+            _key: 'home-cta',
+            _type: 'cta',
+            _version: BLOCK_VERSION,
+            title: "Let's talk about your project",
+            text: 'One call, no obligation.',
+            actions: [{ label: 'Get in touch', target: { href: '/contact' }, emphasis: 'primary' }],
+        },
+    ];
+}
+export function buildPortfolioDemoPages(media) {
+    return [
+        { title: 'Home', slug: 'home', blocks: buildPortfolioHomeBlocks(media) },
+        {
+            title: 'About',
+            slug: 'about',
+            blocks: [
+                {
+                    _key: 'about-prose',
+                    _type: 'prose',
+                    _version: BLOCK_VERSION,
+                    body: [
+                        {
+                            _key: 'about-p1',
+                            _type: 'block',
+                            style: 'normal',
+                            children: [
+                                {
+                                    _key: 'about-p1-span',
+                                    _type: 'span',
+                                    text: 'We are a small studio working across identity, product and editorial design — usually all three on the same project, since a brand rarely stays inside one discipline for long. Founded in 2017, the team has stayed under ten people on purpose: the person who takes the brief is the person who ships the work, on every project, every time.',
+                                    marks: [],
+                                },
+                            ],
+                            markDefs: [],
+                        },
+                        {
+                            _key: 'about-p2',
+                            _type: 'block',
+                            style: 'normal',
+                            children: [
+                                {
+                                    _key: 'about-p2-span',
+                                    _type: 'span',
+                                    text: "Most of what we do starts with an audit, not a mood board — cataloguing what a client already has, good and bad, before proposing anything new. It is slower at the start and faster everywhere after, because nobody discovers six months in that the new identity does not fit the loading dock, the packaging line, or an app's existing component library.",
+                                    marks: [],
+                                },
+                            ],
+                            markDefs: [],
+                        },
+                        {
+                            _key: 'about-p3',
+                            _type: 'block',
+                            style: 'normal',
+                            children: [
+                                {
+                                    _key: 'about-p3-span',
+                                    _type: 'span',
+                                    text: 'We work from a studio in Lisbon with clients across Europe and North America, in the open where the brief allows it — process notes, working files and the odd dead end, published as we go rather than saved for a polished case study months later.',
+                                    marks: [],
+                                },
+                            ],
+                            markDefs: [],
+                        },
+                    ],
+                },
+                ...(media['about-figure'] === undefined
+                    ? []
+                    : [
+                        {
+                            _key: 'about-figure',
+                            _type: 'mediaFigure',
+                            _version: BLOCK_VERSION,
+                            media: media['about-figure'],
+                            caption: 'The studio floor, mid-review.',
+                            ratio: '16:9',
+                            align: 'center',
+                        },
+                    ]),
+                {
+                    _key: 'about-stats',
+                    _type: 'stats',
+                    _version: BLOCK_VERSION,
+                    title: 'At a glance',
+                    items: [
+                        { _key: 'about-stat-1', value: '8', unit: 'years', label: 'in practice' },
+                        { _key: 'about-stat-2', value: '40+', label: 'projects delivered' },
+                        { _key: 'about-stat-3', value: '12', label: 'ongoing clients' },
+                    ],
+                },
+            ],
+        },
+        {
+            title: 'Contact',
+            slug: 'contact',
+            blocks: [
+                {
+                    _key: 'contact-prose',
+                    _type: 'prose',
+                    _version: BLOCK_VERSION,
+                    body: [
+                        {
+                            _key: 'contact-p1',
+                            _type: 'block',
+                            style: 'normal',
+                            children: [
+                                {
+                                    _key: 'contact-p1-span',
+                                    _type: 'span',
+                                    text: 'Tell us about the project — timeline, budget range and what "done" looks like. We reply within two working days, always with a real person, never a form response.',
+                                    marks: [],
+                                },
+                            ],
+                            markDefs: [],
+                        },
+                        {
+                            _key: 'contact-p2',
+                            _type: 'block',
+                            style: 'normal',
+                            children: [
+                                {
+                                    _key: 'contact-p2-span',
+                                    _type: 'span',
+                                    text: 'If it looks like a fit, the next step is a short call — thirty minutes, no deck — followed by a written scope within a week. We start most projects with the audit described on the About page, so the first invoice is usually smaller than people expect.',
+                                    marks: [],
+                                },
+                            ],
+                            markDefs: [],
+                        },
+                    ],
+                },
+                {
+                    _key: 'contact-features',
+                    _type: 'featureGrid',
+                    _version: BLOCK_VERSION,
+                    title: 'What to expect',
+                    items: [
+                        {
+                            _key: 'contact-feature-1',
+                            icon: 'pen',
+                            title: 'A real reply',
+                            text: 'Two working days, from someone who will actually work on the project — not a scheduling bot.',
+                        },
+                        {
+                            _key: 'contact-feature-2',
+                            icon: 'layers',
+                            title: 'A written scope',
+                            text: 'Timeline, deliverables and price in writing before anything is billed.',
+                        },
+                        {
+                            _key: 'contact-feature-3',
+                            icon: 'book',
+                            title: 'One point of contact',
+                            text: 'The person who takes the brief stays on the project through delivery.',
+                        },
+                    ],
+                },
+                {
+                    _key: 'contact-cta',
+                    _type: 'cta',
+                    _version: BLOCK_VERSION,
+                    title: "Let's talk",
+                    text: 'One call, no obligation.',
+                    actions: [
+                        {
+                            label: 'Email the studio',
+                            target: { href: 'mailto:hello@studio.example' },
+                            emphasis: 'primary',
+                        },
+                    ],
+                },
+            ],
+        },
+        {
+            title: 'Legal',
+            slug: 'legal',
+            blocks: [
+                {
+                    _key: 'legal-prose',
+                    _type: 'prose',
+                    _version: BLOCK_VERSION,
+                    body: [
+                        {
+                            _key: 'legal-p1',
+                            _type: 'block',
+                            style: 'normal',
+                            children: [
+                                {
+                                    _key: 'legal-p1-span',
+                                    _type: 'span',
+                                    text: 'This is a demo site, scaffolded by create-cogenta from the "portfolio" blueprint. No data collected here is real.',
+                                    marks: [],
+                                },
+                            ],
+                            markDefs: [],
+                        },
+                    ],
+                },
+            ],
+        },
+    ];
+}
 export const PORTFOLIO_RECOMMENDED_AGENTS = [
     {
         name: 'performanceAgent',
@@ -160,14 +544,125 @@ export const PORTFOLIO_RECOMMENDED_AGENTS = [
         reason: 'Audits project pages so each one is findable on its own, not only from the grid.',
     },
 ];
+/**
+ * `portfolio`'s own starting skin (`starting-skins.js`) — asserted present
+ * with a real check, not a `!`, since `STARTING_SKINS` is keyed by
+ * blueprint id and TypeScript cannot see that this particular key is
+ * always populated.
+ */
+function portfolioPalette() {
+    const skin = STARTING_SKINS.portfolio;
+    if (skin === undefined) {
+        throw new CogentaError({
+            code: 'BLUEPRINT_REGISTRY_CORRUPT',
+            message: 'STARTING_SKINS.portfolio is missing.',
+            hint: 'The "portfolio" entry must stay declared in starting-skins.ts for this blueprint to render its demo art.',
+        });
+    }
+    return skin.color;
+}
+/**
+ * Procedural demo visuals (L25 D1/D5): an "editorial mark on dark" hero
+ * backdrop (the strongest of the flat families against this theme's own
+ * dark-mode identity), one distinct cover per project (`coverSeed`, so the
+ * eight read as genuinely different compositions rather than a palette
+ * repeated eight times), five client marks, and two avatars — one for the
+ * home `quote`, one for the `testimonial` — kept as two separate specs
+ * rather than one shared avatar, since a real site would rarely show the
+ * same face twice on the same page.
+ */
+/** Bundled photography (`assets/photos/portfolio/`), keyed by the same slug `PORTFOLIO_DEMO_PROJECTS` uses. */
+const PORTFOLIO_PROJECT_PHOTOS = {
+    'northwind-rebrand': 'portfolio/northwind-rebrand.jpg',
+    'contoso-mobile-app': 'portfolio/contoso-mobile-app.jpg',
+    'fabrikam-annual-report': 'portfolio/fabrikam-annual-report.jpg',
+    'litware-signage-system': 'portfolio/litware-signage.jpg',
+    'tailspin-streaming-identity': 'portfolio/tailspin-streaming.jpg',
+    'adatum-publishing-house': 'portfolio/adatum-publishing.jpg',
+    'wingtip-terminal-wayfinding': 'portfolio/wingtip-wayfinding.jpg',
+    'proseware-product-launch': 'portfolio/proseware-launch.jpg',
+};
+export const PORTFOLIO_MEDIA_SPECS = [
+    {
+        name: 'hero',
+        spec: heroArt(portfolioPalette(), 'ink', 4),
+        alt: 'A design studio workspace',
+        photo: 'portfolio/hero.jpg',
+    },
+    // The About page's own `mediaFigure` (L26 D2) — the same bundled workspace
+    // photograph as the home hero, a second real photo of the studio floor
+    // rather than a literal reuse of the hero's own media id, since a real
+    // studio site frequently shows its own workspace more than once.
+    {
+        name: 'about-figure',
+        spec: heroArt(portfolioPalette(), 'ink', 17),
+        alt: 'The studio floor, mid-review',
+        photo: 'portfolio/hero.jpg',
+    },
+    ...PORTFOLIO_DEMO_PROJECTS.map((demo) => {
+        const photo = PORTFOLIO_PROJECT_PHOTOS[demo.slug];
+        return {
+            name: `project-${demo.slug}`,
+            spec: coverArt(portfolioPalette(), demo.coverSeed),
+            alt: `${demo.title}, cover composition`,
+            ...(photo === undefined ? {} : { photo }),
+        };
+    }),
+    ...[1, 2, 3, 4, 5].map((n) => ({
+        name: `logo-${n}`,
+        spec: logoArt(n * 13),
+        alt: 'An abstract client mark',
+    })),
+    {
+        name: 'quote-avatar',
+        spec: avatarArt(portfolioPalette(), 201),
+        alt: 'An abstract avatar composition, standing in for a client photo',
+    },
+    {
+        name: 'testimonial-avatar',
+        spec: avatarArt(portfolioPalette(), 202),
+        alt: 'An abstract avatar composition, standing in for a client photo',
+    },
+];
+/** Header/footer navigation and the header "Let's talk" button (L25 D4) — "Work"/"Services" are real, working in-page anchors into the home page's own blocks; "About"/"Contact"/"Legal" are real pages. */
+export const PORTFOLIO_MENUS = {
+    header: [
+        { label: 'Work', url: '/#home-work' },
+        { label: 'Services', url: '/#home-services' },
+        { label: 'About', url: '/about' },
+        { label: 'Contact', url: '/contact' },
+    ],
+    footer: [
+        { label: 'Work', url: '/#home-work' },
+        { label: 'About', url: '/about' },
+        { label: 'Contact', url: '/contact' },
+        { label: 'Legal', url: '/legal' },
+    ],
+    headerAction: { label: "Let's talk", url: '/contact' },
+};
+export const PORTFOLIO_SITE_SETTINGS = {
+    'general.tagline': 'Brand, product and editorial design, made in the open.',
+    'general.socialLinks': [
+        { label: 'Instagram', url: 'https://instagram.com/example' },
+        { label: 'Dribbble', url: 'https://dribbble.com/example' },
+        { label: 'LinkedIn', url: 'https://linkedin.com/company/example' },
+    ],
+    'general.footerNote': 'Studio, est. 2017 · Replies within two working days.',
+};
 /**
  * Inserts the `portfolio` blueprint's demo content through the real
- * `ContentStore` — never mocked (house rule).
+ * `ContentStore` — never mocked (house rule). Each project's `coverImage`
+ * and the home page's hero/logos/quote/testimonial media come from
+ * `ctx.media` (`seedDemoMedia`/`PORTFOLIO_MEDIA_SPECS`) — absent (a caller
+ * that never ran `seedDemoMedia`) simply leaves those fields unset, since
+ * none of them is `required` on its collection/block.
  */
-async function seedPortfolioDemoContent(db, defaultLocale, adminId) {
+async function seedPortfolioDemoContent(ctx) {
+    const { db, defaultLocale, adminId, media } = ctx;
     const projectStore = createContentStore({ db, collection: project, defaultLocale });
     const pageStore = createContentStore({ db, collection: page, defaultLocale });
     for (const demo of PORTFOLIO_DEMO_PROJECTS) {
+        const coverImage = media[`project-${demo.slug}`];
         await projectStore.create({
             status: 'published',
             createdBy: adminId,
@@ -177,10 +672,14 @@ async function seedPortfolioDemoContent(db, defaultLocale, adminId) {
                 summary: demo.summary,
                 role: demo.role,
                 year: demo.year,
+                ...(coverImage === undefined ? {} : { coverImage }),
+            },
+            blocks: {
+                blocks: [roleYearPanelBlock(demo), projectNarrativeBlock(demo)].map(toBlockZoneEntry),
             },
         });
     }
-    for (const demo of PORTFOLIO_DEMO_PAGES) {
+    for (const demo of buildPortfolioDemoPages(media)) {
         await pageStore.create({
             status: 'published',
             createdBy: adminId,
@@ -193,5 +692,9 @@ export const portfolioContentPack = {
     collections: PORTFOLIO_COLLECTIONS,
     recommendedAgents: PORTFOLIO_RECOMMENDED_AGENTS,
     seedDemoContent: seedPortfolioDemoContent,
+    defaultTheme: '@cogenta/theme-portfolio',
+    menus: PORTFOLIO_MENUS,
+    siteSettings: PORTFOLIO_SITE_SETTINGS,
+    mediaSpecs: PORTFOLIO_MEDIA_SPECS,
 };
 //# sourceMappingURL=portfolio.js.map