@cogenta/theme-canonical 0.1.0

package/dist/src/render/blocks/media-figure.js

@@ -0,0 +1,30 @@
+import { h } from '../html.js';
+import { aspectRatio, image } from '../media.js';
+/**
+ * `<figure>`/`<figcaption>` rather than a div and a paragraph: the association
+ * between the picture and its caption is then in the markup, and a screen
+ * reader announces the caption as belonging to the image instead of as loose
+ * text after it.
+ *
+ * `align` is written as a data attribute, never as a class: contract B's values
+ * are `start`/`end`, an intent that mirrors in right-to-left locales, and the
+ * skin decides what it means.
+ */
+export function renderMediaFigure(block, ctx) {
+    const ratio = aspectRatio(block.ratio);
+    const hasCaption = block.caption !== undefined || block.credit !== undefined;
+    return h('figure', {
+        class: 'cg-block cg-figure',
+        'data-block': 'mediaFigure',
+        'data-align': block.align ?? 'center',
+        style: ratio === undefined ? undefined : `--cg-ratio:${ratio}`,
+    }, image(ctx, block.media, {
+        className: 'cg-figure__media',
+        sizes: '(min-width: 45rem) 40rem, 100vw',
+    }), hasCaption
+        ? h('figcaption', { class: 'cg-figure__caption' }, block.caption, block.credit === undefined
+            ? null
+            : h('span', { class: 'cg-figure__credit' }, block.credit))
+        : null);
+}
+//# sourceMappingURL=media-figure.js.map

package/dist/src/render/blocks/media-figure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-figure.js","sourceRoot":"","sources":["../../../../src/render/blocks/media-figure.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,CAAC,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEhD;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAuB,EAAE,GAAkB;IAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACtC,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAA;IAC5E,OAAO,CAAC,CACN,QAAQ,EACR;QACE,KAAK,EAAE,oBAAoB;QAC3B,YAAY,EAAE,aAAa;QAC3B,YAAY,EAAE,KAAK,CAAC,KAAK,IAAI,QAAQ;QACrC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,KAAK,EAAE;KAC/D,EACD,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE;QACtB,SAAS,EAAE,kBAAkB;QAC7B,KAAK,EAAE,iCAAiC;KACzC,CAAC,EACF,UAAU;QACR,CAAC,CAAC,CAAC,CACC,YAAY,EACZ,EAAE,KAAK,EAAE,oBAAoB,EAAE,EAC/B,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,MAAM,KAAK,SAAS;YACxB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,CAC5D;QACH,CAAC,CAAC,IAAI,CACT,CAAA;AACH,CAAC"}

package/dist/src/render/blocks/prose.d.ts

@@ -0,0 +1,10 @@
+import type { ProseBlock } from '@cogenta/blocks';
+import type { RenderContext } from '../../theme-contract.js';
+import { type HtmlElement } from '../html.js';
+/**
+ * `prose` declares `headingLevel: 'none'`: it contributes no heading of its
+ * own. Whatever headings appear come from the rich text document, whose
+ * vocabulary starts at `h2`.
+ */
+export declare function renderProse(block: ProseBlock, ctx: RenderContext): HtmlElement;
+//# sourceMappingURL=prose.d.ts.map

package/dist/src/render/blocks/prose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prose.d.ts","sourceRoot":"","sources":["../../../../src/render/blocks/prose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,KAAK,WAAW,EAAK,MAAM,YAAY,CAAA;AAGhD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,GAAG,WAAW,CAM9E"}

package/dist/src/render/blocks/prose.js

@@ -0,0 +1,11 @@
+import { h } from '../html.js';
+import { renderRichText } from '../rich-text.js';
+/**
+ * `prose` declares `headingLevel: 'none'`: it contributes no heading of its
+ * own. Whatever headings appear come from the rich text document, whose
+ * vocabulary starts at `h2`.
+ */
+export function renderProse(block, ctx) {
+    return h('div', { class: 'cg-block cg-prose', 'data-block': 'prose' }, renderRichText(ctx, block.body));
+}
+//# sourceMappingURL=prose.js.map

package/dist/src/render/blocks/prose.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prose.js","sourceRoot":"","sources":["../../../../src/render/blocks/prose.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,CAAC,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEhD;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,GAAkB;IAC/D,OAAO,CAAC,CACN,KAAK,EACL,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,OAAO,EAAE,EACrD,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAChC,CAAA;AACH,CAAC"}

package/dist/src/render/blocks/quote.d.ts

@@ -0,0 +1,14 @@
+import type { QuoteBlock } from '@cogenta/blocks';
+import type { RenderContext } from '../../theme-contract.js';
+import { type HtmlElement } from '../html.js';
+/**
+ * `<figure><blockquote>…</blockquote><figcaption>` is the attribution pattern
+ * the HTML spec prescribes: putting the author inside the `<blockquote>` would
+ * claim the author's name is part of what was said.
+ *
+ * The avatar is decorative here — the name is right beside it in text — so its
+ * media entity's alt text is expected to be empty. `image` still writes the
+ * attribute either way.
+ */
+export declare function renderQuote(block: QuoteBlock, ctx: RenderContext): HtmlElement;
+//# sourceMappingURL=quote.d.ts.map

package/dist/src/render/blocks/quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.d.ts","sourceRoot":"","sources":["../../../../src/render/blocks/quote.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,KAAK,WAAW,EAAK,MAAM,YAAY,CAAA;AAGhD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,GAAG,WAAW,CAwB9E"}

package/dist/src/render/blocks/quote.js

@@ -0,0 +1,25 @@
+import { h } from '../html.js';
+import { image } from '../media.js';
+/**
+ * `<figure><blockquote>…</blockquote><figcaption>` is the attribution pattern
+ * the HTML spec prescribes: putting the author inside the `<blockquote>` would
+ * claim the author's name is part of what was said.
+ *
+ * The avatar is decorative here — the name is right beside it in text — so its
+ * media entity's alt text is expected to be empty. `image` still writes the
+ * attribute either way.
+ */
+export function renderQuote(block, ctx) {
+    const hasAttribution = block.author !== undefined || block.role !== undefined || block.avatar !== undefined;
+    return h('figure', { class: 'cg-block cg-quote', 'data-block': 'quote' }, h('blockquote', { class: 'cg-quote__text' }, h('p', {}, block.text)), hasAttribution
+        ? h('figcaption', { class: 'cg-quote__attribution' }, block.avatar === undefined
+            ? null
+            : image(ctx, block.avatar, {
+                className: 'cg-quote__avatar',
+                variant: { width: 96, height: 96, fit: 'cover' },
+            }), block.author === undefined
+            ? null
+            : h('span', { class: 'cg-quote__author' }, block.author), block.role === undefined ? null : h('span', { class: 'cg-quote__role' }, block.role))
+        : null);
+}
+//# sourceMappingURL=quote.js.map

package/dist/src/render/blocks/quote.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.js","sourceRoot":"","sources":["../../../../src/render/blocks/quote.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,CAAC,EAAE,MAAM,YAAY,CAAA;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEnC;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,GAAkB;IAC/D,MAAM,cAAc,GAClB,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,CAAA;IACtF,OAAO,CAAC,CACN,QAAQ,EACR,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,OAAO,EAAE,EACrD,CAAC,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EACpE,cAAc;QACZ,CAAC,CAAC,CAAC,CACC,YAAY,EACZ,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAClC,KAAK,CAAC,MAAM,KAAK,SAAS;YACxB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE;gBACvB,SAAS,EAAE,kBAAkB;gBAC7B,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE;aACjD,CAAC,EACN,KAAK,CAAC,MAAM,KAAK,SAAS;YACxB,CAAC,CAAC,IAAI;YACN,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,EAAE,KAAK,CAAC,MAAM,CAAC,EAC1D,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CACrF;QACH,CAAC,CAAC,IAAI,CACT,CAAA;AACH,CAAC"}

package/dist/src/render/blocks/stats.d.ts

@@ -0,0 +1,5 @@
+import type { StatsBlock } from '@cogenta/blocks';
+import type { RenderContext } from '../../theme-contract.js';
+import { type HtmlElement } from '../html.js';
+export declare function renderStats(block: StatsBlock, _ctx: RenderContext): HtmlElement;
+//# sourceMappingURL=stats.d.ts.map

package/dist/src/render/blocks/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../../src/render/blocks/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAE5D,OAAO,EAAE,KAAK,WAAW,EAAK,MAAM,YAAY,CAAA;AA4BhD,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,aAAa,GAAG,WAAW,CAS/E"}

package/dist/src/render/blocks/stats.js

@@ -0,0 +1,23 @@
+import { blockHeadingTag, heading } from '../heading.js';
+import { h } from '../html.js';
+/**
+ * A description list: each figure is the description of its label, which is
+ * exactly what `<dt>`/`<dd>` mean, and it survives being read linearly.
+ *
+ * The label comes first in the markup and the skin puts the figure above it —
+ * reading order and visual order stay independent, which is what WCAG 1.3.2
+ * asks for. A `<div>` wrapper around each pair is valid inside `<dl>` and is
+ * what makes that reordering possible without breaking the association.
+ *
+ * The unit is a separate span so the skin can size it apart, and the pair is
+ * announced as one string either way.
+ */
+function renderItem(item) {
+    return h('div', { class: 'cg-stat' }, h('dt', { class: 'cg-stat__label' }, item.label), h('dd', { class: 'cg-stat__value' }, item.value, item.unit === undefined ? null : h('span', { class: 'cg-stat__unit' }, item.unit)));
+}
+export function renderStats(block, _ctx) {
+    return h('section', { class: 'cg-block cg-stats', 'data-block': 'stats' }, block.title === undefined
+        ? null
+        : heading(blockHeadingTag('stats') ?? 'h2', { class: 'cg-stats__title' }, block.title), h('dl', { class: 'cg-stats__items' }, block.items.map(renderItem)));
+}
+//# sourceMappingURL=stats.js.map

package/dist/src/render/blocks/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../../../../src/render/blocks/stats.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACxD,OAAO,EAAoB,CAAC,EAAE,MAAM,YAAY,CAAA;AAEhD;;;;;;;;;;;GAWG;AACH,SAAS,UAAU,CAAC,IAAc;IAChC,OAAO,CAAC,CACN,KAAK,EACL,EAAE,KAAK,EAAE,SAAS,EAAE,EACpB,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,EAChD,CAAC,CACC,IAAI,EACJ,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAC3B,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAClF,CACF,CAAA;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAiB,EAAE,IAAmB;IAChE,OAAO,CAAC,CACN,SAAS,EACT,EAAE,KAAK,EAAE,mBAAmB,EAAE,YAAY,EAAE,OAAO,EAAE,EACrD,KAAK,CAAC,KAAK,KAAK,SAAS;QACvB,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,EACxF,CAAC,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CACnE,CAAA;AACH,CAAC"}

package/dist/src/render/entry.d.ts

@@ -0,0 +1,7 @@
+import type { ContentEntry, RenderContext } from '../theme-contract.js';
+export declare function entryTitle(entry: ContentEntry, ctx: RenderContext): string;
+export declare function entryExcerpt(entry: ContentEntry): string | undefined;
+/** ISO 8601, for `<time datetime>`. Anything else is not a date this can use. */
+export declare function entryDate(entry: ContentEntry): string | undefined;
+export declare function entryHref(entry: ContentEntry, ctx: RenderContext): string;
+//# sourceMappingURL=entry.d.ts.map

package/dist/src/render/entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../../src/render/entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAavE,wBAAgB,UAAU,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAM1E;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAMpE;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,SAAS,CAGjE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,GAAG,MAAM,CAEzE"}

package/dist/src/render/entry.js

@@ -0,0 +1,35 @@
+/**
+ * Contract A fixes the system fields but not the schema-defined ones: which
+ * fields an entry has depends on its collection, and a theme that assumes
+ * `title` exists breaks on the first collection that calls it `name`.
+ *
+ * So every read of an unknown field goes through here, returns a fallback the
+ * visitor can live with, and never renders `undefined`.
+ */
+const TITLE_FIELDS = ['title', 'name', 'label'];
+export function entryTitle(entry, ctx) {
+    for (const field of TITLE_FIELDS) {
+        const value = entry[field];
+        if (typeof value === 'string' && value.trim() !== '')
+            return value;
+    }
+    return ctx.t('entry.untitled');
+}
+const EXCERPT_FIELDS = ['excerpt', 'summary', 'description'];
+export function entryExcerpt(entry) {
+    for (const field of EXCERPT_FIELDS) {
+        const value = entry[field];
+        if (typeof value === 'string' && value.trim() !== '')
+            return value;
+    }
+    return undefined;
+}
+/** ISO 8601, for `<time datetime>`. Anything else is not a date this can use. */
+export function entryDate(entry) {
+    const value = entry.publishedAt ?? entry.createdAt;
+    return typeof value === 'string' && !Number.isNaN(Date.parse(value)) ? value : undefined;
+}
+export function entryHref(entry, ctx) {
+    return ctx.link({ collection: entry.collection, id: entry.id });
+}
+//# sourceMappingURL=entry.js.map

package/dist/src/render/entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../../../src/render/entry.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,MAAM,YAAY,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAU,CAAA;AAExD,MAAM,UAAU,UAAU,CAAC,KAAmB,EAAE,GAAkB;IAChE,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,KAAK,CAAA;IACpE,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAA;AAChC,CAAC;AAED,MAAM,cAAc,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,CAAU,CAAA;AAErE,MAAM,UAAU,YAAY,CAAC,KAAmB;IAC9C,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAA;QAC1B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,KAAK,CAAA;IACpE,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,SAAS,CAAC,KAAmB;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,SAAS,CAAA;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAA;AAC1F,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,KAAmB,EAAE,GAAkB;IAC/D,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAA;AACjE,CAAC"}

package/dist/src/render/heading.d.ts

@@ -0,0 +1,14 @@
+import { type Child, type HtmlElement } from './html.js';
+export type HeadingTag = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+/** The level a block's own title is rendered at, or `null` if it carries none. */
+export declare function blockHeadingTag(blockName: string): HeadingTag | null;
+/**
+ * The level for a title *inside* a block — a feature's name, a listed entry.
+ *
+ * One below the block's own heading when the block renders one, and at the
+ * block's declared level when it does not: a `featureGrid` without a title must
+ * not start its items at `h3`, which would skip a level.
+ */
+export declare function nestedHeadingTag(blockName: string, blockRendersHeading: boolean): HeadingTag;
+export declare function heading(tag: HeadingTag, attrs: Readonly<Record<string, string | number | boolean | undefined>>, ...children: readonly Child[]): HtmlElement;
+//# sourceMappingURL=heading.d.ts.map

package/dist/src/render/heading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading.d.ts","sourceRoot":"","sources":["../../../src/render/heading.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,WAAW,EAAK,MAAM,WAAW,CAAA;AAY3D,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;AAEhE,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAIpE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,GAAG,UAAU,CAK5F;AAED,wBAAgB,OAAO,CACrB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,EACtE,GAAG,QAAQ,EAAE,SAAS,KAAK,EAAE,GAC5B,WAAW,CAEb"}

package/dist/src/render/heading.js

@@ -0,0 +1,34 @@
+import { VOCABULARY } from '@cogenta/blocks';
+import { h } from './html.js';
+/**
+ * The heading level of a block is **not** a theme decision: contract B fixes it
+ * in each block's `a11y.headingLevel`, and the theme reads it from there rather
+ * than restating it. Restating it is how an outline drifts — one block gets
+ * promoted in the theme, the page grows a second `h1`, and nothing fails.
+ */
+const DECLARED_LEVELS = new Map(VOCABULARY.map((block) => [block.name, block.a11y.headingLevel]));
+/** The level a block's own title is rendered at, or `null` if it carries none. */
+export function blockHeadingTag(blockName) {
+    const level = DECLARED_LEVELS.get(blockName);
+    if (level === undefined || level === 'none')
+        return null;
+    return level;
+}
+/**
+ * The level for a title *inside* a block — a feature's name, a listed entry.
+ *
+ * One below the block's own heading when the block renders one, and at the
+ * block's declared level when it does not: a `featureGrid` without a title must
+ * not start its items at `h3`, which would skip a level.
+ */
+export function nestedHeadingTag(blockName, blockRendersHeading) {
+    const own = blockHeadingTag(blockName) ?? 'h2';
+    if (!blockRendersHeading)
+        return own;
+    const next = Number(own.slice(1)) + 1;
+    return `h${Math.min(next, 6)}`;
+}
+export function heading(tag, attrs, ...children) {
+    return h(tag, attrs, ...children);
+}
+//# sourceMappingURL=heading.js.map

package/dist/src/render/heading.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading.js","sourceRoot":"","sources":["../../../src/render/heading.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAgC,CAAC,EAAE,MAAM,WAAW,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,eAAe,GAAsC,IAAI,GAAG,CAChE,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CACjE,CAAA;AAID,kFAAkF;AAClF,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,IAAI,CAAA;IACxD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB,EAAE,mBAA4B;IAC9E,MAAM,GAAG,GAAG,eAAe,CAAC,SAAS,CAAC,IAAI,IAAI,CAAA;IAC9C,IAAI,CAAC,mBAAmB;QAAE,OAAO,GAAG,CAAA;IACpC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACrC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,EAAgB,CAAA;AAC9C,CAAC;AAED,MAAM,UAAU,OAAO,CACrB,GAAe,EACf,KAAsE,EACtE,GAAG,QAA0B;IAE7B,OAAO,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,QAAQ,CAAC,CAAA;AACnC,CAAC"}

package/dist/src/render/html.d.ts

@@ -0,0 +1,44 @@
+/**
+ * A minimal, dependency-free HTML tree and serialiser.
+ *
+ * Why the theme's markup is built here rather than written inline in the
+ * `.astro` files:
+ *
+ * 1. It is testable without an Astro toolchain — the twelve blocks get real
+ *    snapshot tests, and the heading outline and the `alt` rule get asserted on
+ *    the actual output rather than on a reading of the source.
+ * 2. There is **no way to emit raw HTML**. A block stores semantic data only
+ *    (rule R3); with no `raw()` escape hatch, a string that arrives in a block
+ *    field cannot become markup, whatever it contains.
+ *
+ * The `.astro` components in `src/blocks/` are the contract-D entry points and
+ * stay thin on purpose: one call each, so the two never drift.
+ */
+export type AttributeValue = string | number | boolean | undefined;
+export type Attributes = Readonly<Record<string, AttributeValue>>;
+export interface HtmlElement {
+    readonly kind: 'element';
+    readonly tag: string;
+    readonly attrs: Attributes;
+    readonly children: readonly HtmlNode[];
+}
+export interface HtmlText {
+    readonly kind: 'text';
+    readonly value: string;
+}
+export type HtmlNode = HtmlElement | HtmlText;
+/** Anything a caller may pass as a child. `null`/`false` drop out, so a
+ * conditional child reads as `condition && node` without a wrapper. */
+export type Child = HtmlNode | string | null | false | undefined | readonly Child[];
+export declare function text(value: string): HtmlText;
+export declare function h(tag: string, attrs?: Attributes, ...children: readonly Child[]): HtmlElement;
+/**
+ * `&` first, or every following replacement would be escaped twice.
+ * `<` and `>` cover text; the quotes are escaped in attributes only, where they
+ * are the ones that can break out.
+ */
+export declare function escapeText(value: string): string;
+export declare function escapeAttribute(value: string): string;
+export declare function serialize(node: HtmlNode): string;
+export declare function serializeAll(nodes: readonly HtmlNode[]): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/src/render/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../../src/render/html.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;AAElE,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAA;AAEjE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,QAAQ,EAAE,CAAA;CACvC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,QAAQ,CAAA;AAE7C;uEACuE;AACvE,MAAM,MAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,KAAK,EAAE,CAAA;AAsBnF,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAE5C;AAiBD,wBAAgB,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,UAAe,EAAE,GAAG,QAAQ,EAAE,SAAS,KAAK,EAAE,GAAG,WAAW,CAIjG;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAiBD,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAKhD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,MAAM,CAE/D"}

package/dist/src/render/html.js

@@ -0,0 +1,96 @@
+/**
+ * A minimal, dependency-free HTML tree and serialiser.
+ *
+ * Why the theme's markup is built here rather than written inline in the
+ * `.astro` files:
+ *
+ * 1. It is testable without an Astro toolchain — the twelve blocks get real
+ *    snapshot tests, and the heading outline and the `alt` rule get asserted on
+ *    the actual output rather than on a reading of the source.
+ * 2. There is **no way to emit raw HTML**. A block stores semantic data only
+ *    (rule R3); with no `raw()` escape hatch, a string that arrives in a block
+ *    field cannot become markup, whatever it contains.
+ *
+ * The `.astro` components in `src/blocks/` are the contract-D entry points and
+ * stay thin on purpose: one call each, so the two never drift.
+ */
+/**
+ * Elements that carry no children and no closing tag. Serialising `<img>` with
+ * one would produce markup no parser agrees on.
+ */
+const VOID_ELEMENTS = new Set([
+    'area',
+    'base',
+    'br',
+    'col',
+    'embed',
+    'hr',
+    'img',
+    'input',
+    'link',
+    'meta',
+    'source',
+    'track',
+    'wbr',
+]);
+export function text(value) {
+    return { kind: 'text', value };
+}
+function flatten(children, into) {
+    for (const child of children) {
+        if (child === null || child === false || child === undefined)
+            continue;
+        if (typeof child === 'string') {
+            into.push(text(child));
+            continue;
+        }
+        if (Array.isArray(child)) {
+            flatten(child, into);
+            continue;
+        }
+        into.push(child);
+    }
+}
+export function h(tag, attrs = {}, ...children) {
+    const collected = [];
+    flatten(children, collected);
+    return { kind: 'element', tag, attrs, children: collected };
+}
+/**
+ * `&` first, or every following replacement would be escaped twice.
+ * `<` and `>` cover text; the quotes are escaped in attributes only, where they
+ * are the ones that can break out.
+ */
+export function escapeText(value) {
+    return value.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+export function escapeAttribute(value) {
+    return escapeText(value).replace(/"/g, '&quot;').replace(/'/g, '&#39;');
+}
+function serializeAttributes(attrs) {
+    let out = '';
+    // Insertion order, not sorted: it is deterministic already, and an author
+    // reading a snapshot expects the order they wrote.
+    for (const [name, value] of Object.entries(attrs)) {
+        if (value === undefined || value === false)
+            continue;
+        if (value === true) {
+            out += ` ${name}`;
+            continue;
+        }
+        out += ` ${name}="${escapeAttribute(String(value))}"`;
+    }
+    return out;
+}
+export function serialize(node) {
+    if (node.kind === 'text')
+        return escapeText(node.value);
+    const open = `<${node.tag}${serializeAttributes(node.attrs)}>`;
+    if (VOID_ELEMENTS.has(node.tag))
+        return open;
+    return `${open}${node.children.map(serialize).join('')}</${node.tag}>`;
+}
+export function serializeAll(nodes) {
+    return nodes.map(serialize).join('');
+}
+//# sourceMappingURL=html.js.map

package/dist/src/render/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../../src/render/html.ts"],"names":[],"mappings":"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"}

package/dist/src/render/media.d.ts

@@ -0,0 +1,32 @@
+import type { ImageOptions, MediaReference, RenderContext } from '../theme-contract.js';
+import { type HtmlElement } from './html.js';
+export interface ImageRenderOptions {
+    /** The `sizes` hint. Layout knowledge, so it belongs to the theme, not the block. */
+    readonly sizes?: string;
+    /** `eager` only for what is above the fold — the hero, and nothing else. */
+    readonly loading?: 'lazy' | 'eager';
+    readonly className?: string;
+    /**
+     * An accessible name the *block* provides — a logo's organisation name, for
+     * instance. It never invents alt text: it is used only where contract B says
+     * the block already carries the name.
+     */
+    readonly altFrom?: string;
+    readonly variant?: ImageOptions;
+}
+/**
+ * The only place the theme emits an `<img>`.
+ *
+ * `alt` is always written, never omitted: an image with no `alt` attribute is
+ * announced by its file name, while `alt=""` is announced as decorative. The
+ * difference is the whole of WCAG 1.1.1 here, and it cannot be left to whether
+ * a caller remembered.
+ *
+ * The alt text itself comes from the media entity through `ctx.image` — the
+ * theme has no business inventing one, and correcting it in the media library
+ * must fix every page at once.
+ */
+export declare function image(ctx: RenderContext, media: MediaReference, options?: ImageRenderOptions): HtmlElement;
+/** Contract B's framing values, as a CSS `aspect-ratio`. `original` means none. */
+export declare function aspectRatio(ratio: string | undefined): string | undefined;
+//# sourceMappingURL=media.d.ts.map

package/dist/src/render/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../../src/render/media.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACvF,OAAO,EAAE,KAAK,WAAW,EAAK,MAAM,WAAW,CAAA;AAE/C,MAAM,WAAW,kBAAkB;IACjC,qFAAqF;IACrF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAA;CAChC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CACnB,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,cAAc,EACrB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAmBb;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKzE"}

package/dist/src/render/media.js

@@ -0,0 +1,42 @@
+import { h } from './html.js';
+/**
+ * The only place the theme emits an `<img>`.
+ *
+ * `alt` is always written, never omitted: an image with no `alt` attribute is
+ * announced by its file name, while `alt=""` is announced as decorative. The
+ * difference is the whole of WCAG 1.1.1 here, and it cannot be left to whether
+ * a caller remembered.
+ *
+ * The alt text itself comes from the media entity through `ctx.image` — the
+ * theme has no business inventing one, and correcting it in the media library
+ * must fix every page at once.
+ */
+export function image(ctx, media, options = {}) {
+    const source = ctx.image(media, options.variant);
+    return h('img', {
+        class: options.className,
+        src: source.src,
+        srcset: source.srcset === '' ? undefined : source.srcset,
+        sizes: options.sizes,
+        width: source.width,
+        height: source.height,
+        alt: source.alt !== '' ? source.alt : (options.altFrom ?? ''),
+        loading: options.loading ?? 'lazy',
+        decoding: 'async',
+        // The focal point is content data, not a style value: it says which part of
+        // the picture must survive a crop. Nothing else can carry it per-image.
+        style: source.focal === null
+            ? undefined
+            : `object-position:${source.focal.x * 100}% ${source.focal.y * 100}%`,
+    });
+}
+/** Contract B's framing values, as a CSS `aspect-ratio`. `original` means none. */
+export function aspectRatio(ratio) {
+    if (ratio === undefined || ratio === 'original')
+        return undefined;
+    const [width, height] = ratio.split(':');
+    if (width === undefined || height === undefined)
+        return undefined;
+    return `${width} / ${height}`;
+}
+//# sourceMappingURL=media.js.map

package/dist/src/render/media.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.js","sourceRoot":"","sources":["../../../src/render/media.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,CAAC,EAAE,MAAM,WAAW,CAAA;AAiB/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,KAAK,CACnB,GAAkB,EAClB,KAAqB,EACrB,OAAO,GAAuB,EAAE;IAEhC,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;IAChD,OAAO,CAAC,CAAC,KAAK,EAAE;QACd,KAAK,EAAE,OAAO,CAAC,SAAS;QACxB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM;QACxD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;QAC7D,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,MAAM;QAClC,QAAQ,EAAE,OAAO;QACjB,4EAA4E;QAC5E,wEAAwE;QACxE,KAAK,EACH,MAAM,CAAC,KAAK,KAAK,IAAI;YACnB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,mBAAmB,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,GAAG;KAC1E,CAAC,CAAA;AACJ,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,KAAyB;IACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU;QAAE,OAAO,SAAS,CAAA;IACjE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACxC,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAA;IACjE,OAAO,GAAG,KAAK,MAAM,MAAM,EAAE,CAAA;AAC/B,CAAC"}

package/dist/src/render/render-block.d.ts

@@ -0,0 +1,26 @@
+import type { VocabularyBlock } from '@cogenta/blocks';
+import type { ContentEntry, RenderContext } from '../theme-contract.js';
+import { type HtmlElement } from './html.js';
+/**
+ * Entries already fetched for the `collectionList` blocks on the page, by the
+ * block's `_key`. Fetching happens in the Astro frontmatter, once per block,
+ * before any markup is built — a renderer that could await would make the
+ * number of round trips depend on the markup.
+ */
+export type FetchedEntries = Readonly<Record<string, readonly ContentEntry[]>>;
+export declare function renderBlock(block: VocabularyBlock, ctx: RenderContext, entries?: FetchedEntries): HtmlElement | null;
+export interface PageContent {
+    /** The entry's title. Rendered as the `h1` unless a hero already carries one. */
+    readonly title: string;
+    readonly blocks: readonly VocabularyBlock[];
+}
+/**
+ * A page has exactly one `h1`.
+ *
+ * A `hero` declares `headingLevel: 'h1'` and renders the title itself, so the
+ * layout must not render a second one; without a hero, nothing else on the page
+ * would — `prose` starts at `h2` — and the page would have no `h1` at all.
+ */
+export declare function pageHasOwnHeading(blocks: readonly VocabularyBlock[]): boolean;
+export declare function renderPage(page: PageContent, ctx: RenderContext, entries?: FetchedEntries): HtmlElement;
+//# sourceMappingURL=render-block.d.ts.map

package/dist/src/render/render-block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-block.d.ts","sourceRoot":"","sources":["../../../src/render/render-block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAavE,OAAO,EAAE,KAAK,WAAW,EAAK,MAAM,WAAW,CAAA;AAE/C;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC,CAAC,CAAA;AAE9E,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,cAAmB,GAC3B,WAAW,GAAG,IAAI,CAsCpB;AAED,MAAM,WAAW,WAAW;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,CAAA;CAC5C;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAE7E;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,cAAmB,GAC3B,WAAW,CAOb"}

package/dist/src/render/render-block.js

@@ -0,0 +1,66 @@
+import { renderCollectionList } from './blocks/collection-list.js';
+import { renderCta } from './blocks/cta.js';
+import { renderEmbed } from './blocks/embed.js';
+import { renderFaq } from './blocks/faq.js';
+import { renderFeatureGrid } from './blocks/feature-grid.js';
+import { renderGallery } from './blocks/gallery.js';
+import { renderHero } from './blocks/hero.js';
+import { renderLogos } from './blocks/logos.js';
+import { renderMediaFigure } from './blocks/media-figure.js';
+import { renderProse } from './blocks/prose.js';
+import { renderQuote } from './blocks/quote.js';
+import { renderStats } from './blocks/stats.js';
+import { h } from './html.js';
+export function renderBlock(block, ctx, entries = {}) {
+    switch (block._type) {
+        case 'hero':
+            return renderHero(block, ctx);
+        case 'prose':
+            return renderProse(block, ctx);
+        case 'mediaFigure':
+            return renderMediaFigure(block, ctx);
+        case 'featureGrid':
+            return renderFeatureGrid(block, ctx);
+        case 'cta':
+            return renderCta(block, ctx);
+        case 'gallery':
+            return renderGallery(block, ctx);
+        case 'quote':
+            return renderQuote(block, ctx);
+        case 'faq':
+            return renderFaq(block, ctx);
+        case 'stats':
+            return renderStats(block, ctx);
+        case 'logos':
+            return renderLogos(block, ctx);
+        case 'collectionList':
+            return renderCollectionList(block, ctx, entries[block._key] ?? []);
+        case 'embed':
+            return renderEmbed(block, ctx);
+        default: {
+            // Exhaustive over contract B's twelve: `block` is `never` here, so a
+            // thirteenth block stops this package compiling until it is implemented.
+            // Returning null rather than throwing is deliberate — a theme has no
+            // access to `@cogenta/core`'s error types (contract D refuses the import),
+            // and choosing a fallback block is the render layer's job, not the
+            // theme's.
+            const unreachable = block;
+            void unreachable;
+            return null;
+        }
+    }
+}
+/**
+ * A page has exactly one `h1`.
+ *
+ * A `hero` declares `headingLevel: 'h1'` and renders the title itself, so the
+ * layout must not render a second one; without a hero, nothing else on the page
+ * would — `prose` starts at `h2` — and the page would have no `h1` at all.
+ */
+export function pageHasOwnHeading(blocks) {
+    return blocks.some((block) => block._type === 'hero');
+}
+export function renderPage(page, ctx, entries = {}) {
+    return h('main', { class: 'cg-main', id: 'cg-main' }, pageHasOwnHeading(page.blocks) ? null : h('h1', { class: 'cg-page__title' }, page.title), page.blocks.map((block) => renderBlock(block, ctx, entries)));
+}
+//# sourceMappingURL=render-block.js.map

package/dist/src/render/render-block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-block.js","sourceRoot":"","sources":["../../../src/render/render-block.ts"],"names":[],"mappings":"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"}

package/dist/src/render/rich-text.d.ts

@@ -0,0 +1,5 @@
+import type { RichTextDocument } from '@cogenta/blocks';
+import type { RenderContext } from '../theme-contract.js';
+import { type HtmlNode } from './html.js';
+export declare function renderRichText(ctx: RenderContext, document: RichTextDocument): readonly HtmlNode[];
+//# sourceMappingURL=rich-text.d.ts.map