@cogenta/theme-canonical 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"rich-text.d.ts","sourceRoot":"","sources":["../../../src/render/rich-text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,gBAAgB,EAAsB,MAAM,iBAAiB,CAAA;AAC3F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,KAAK,QAAQ,EAAW,MAAM,WAAW,CAAA;AA+GlD,wBAAgB,cAAc,CAC5B,GAAG,EAAE,aAAa,EAClB,QAAQ,EAAE,gBAAgB,GACzB,SAAS,QAAQ,EAAE,CAiCrB"}

package/dist/src/render/rich-text.js

@@ -0,0 +1,105 @@
+import { h, text } from './html.js';
+import { image } from './media.js';
+const KNOWN_MARKS = new Map([
+    ['strong', 'strong'],
+    ['em', 'em'],
+    ['code', 'code'],
+]);
+function applyMark(ctx, mark, markDefs, child) {
+    const tag = KNOWN_MARKS.get(mark);
+    if (tag !== undefined)
+        return h(tag, {}, child);
+    const definition = markDefs.find((candidate) => candidate._key === mark);
+    if (definition === undefined) {
+        // An annotation this theme does not know stays text. Guessing markup for it
+        // is how a mark becomes an injection vector.
+        return child;
+    }
+    if (definition._type === 'link') {
+        return h('a', { href: ctx.link(definition.href), rel: definition.rel }, child);
+    }
+    return h('a', { href: ctx.link({ collection: definition.collection, id: definition.id }) }, child);
+}
+function renderSpan(ctx, span, markDefs) {
+    let node = text(span.text);
+    // Applied in reverse so the first mark ends up outermost, which keeps
+    // `['link', 'strong']` rendering as a link containing bold text.
+    for (const mark of [...span.marks].reverse()) {
+        node = applyMark(ctx, mark, markDefs, node);
+    }
+    return node;
+}
+function renderChildren(ctx, block) {
+    return block.children.map((span) => renderSpan(ctx, span, block.markDefs));
+}
+function isListItem(node) {
+    return node !== undefined && node._type === 'block' && node.listItem !== undefined;
+}
+function levelOf(node) {
+    return node.level ?? 1;
+}
+/**
+ * Builds one list, and every list nested inside it, from a run of consecutive
+ * list items. A nested list lives *inside* the preceding `<li>` — putting it
+ * beside one produces a list whose items do not match what is announced.
+ */
+function buildList(ctx, nodes, start, level) {
+    const first = nodes[start];
+    if (!isListItem(first))
+        return { node: text(''), next: start + 1 };
+    const kind = first.listItem;
+    const items = [];
+    let index = start;
+    while (index < nodes.length) {
+        const node = nodes[index];
+        if (!isListItem(node))
+            break;
+        const nodeLevel = levelOf(node);
+        if (nodeLevel < level || node.listItem !== kind)
+            break;
+        if (nodeLevel > level) {
+            const nested = buildList(ctx, nodes, index, nodeLevel);
+            const last = items.pop();
+            items.push(last === undefined || last.kind !== 'element'
+                ? h('li', {}, nested.node)
+                : h('li', last.attrs, ...last.children, nested.node));
+            index = nested.next;
+            continue;
+        }
+        items.push(h('li', {}, ...renderChildren(ctx, node)));
+        index += 1;
+    }
+    return { node: h(kind === 'number' ? 'ol' : 'ul', {}, items), next: index };
+}
+function renderTextBlock(ctx, block) {
+    const children = renderChildren(ctx, block);
+    if (block.style === 'blockquote')
+        return h('blockquote', {}, h('p', {}, ...children));
+    if (block.style === 'normal')
+        return h('p', {}, ...children);
+    return h(block.style, {}, ...children);
+}
+export function renderRichText(ctx, document) {
+    const out = [];
+    let index = 0;
+    while (index < document.length) {
+        const node = document[index];
+        if (node === undefined)
+            break;
+        if (isListItem(node)) {
+            const list = buildList(ctx, document, index, levelOf(node));
+            out.push(list.node);
+            index = list.next;
+            continue;
+        }
+        if (node._type === 'media') {
+            out.push(h('figure', { class: 'cg-prose__figure' }, image(ctx, node.id, { sizes: '(min-width: 45rem) 40rem, 100vw' }), node.caption === undefined ? null : h('figcaption', {}, node.caption)));
+            index += 1;
+            continue;
+        }
+        out.push(renderTextBlock(ctx, node));
+        index += 1;
+    }
+    return out;
+}
+//# sourceMappingURL=rich-text.js.map

package/dist/src/render/rich-text.js.map

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

package/dist/src/theme-contract.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Contract D — Thème, frozen at `theme@1.0` on 2026-08-13.
+ *
+ * TEMPORARY HOME. These types and `defineTheme` belong to `@cogenta/render`,
+ * which is being written in parallel (tasks 1–3 of L3). They live here so the
+ * canonical theme can be written, typechecked and tested today, and must be
+ * replaced by an import from `@cogenta/render` at merge time — not duplicated.
+ *
+ * Nothing below adds to `ctx`. Two shapes the contract names but does not spell
+ * out — `MediaReference` and `ContentEntry` — are given the narrowest reading
+ * that matches what is already frozen elsewhere; both are flagged in the code.
+ */
+/**
+ * Contract B stores a media field as the media library's identifier, never as
+ * an URL and never as a rendition (`f.media` in `@cogenta/blocks`). So a
+ * reference the theme can hold is that identifier.
+ */
+export type MediaReference = string;
+export interface ImageOptions {
+    readonly width?: number;
+    readonly height?: number;
+    readonly format?: 'avif' | 'webp' | 'jpeg' | 'png';
+    readonly fit?: 'cover' | 'contain';
+}
+export interface ImageSource {
+    readonly src: string;
+    readonly srcset: string;
+    readonly width: number;
+    readonly height: number;
+    /** Alt text and focal point come from the media entity, never invented here. */
+    readonly alt: string;
+    readonly focal: {
+        readonly x: number;
+        readonly y: number;
+    } | null;
+}
+/**
+ * Contract A, "Champs système". A theme only ever sees published entries — the
+ * read token carries the `public` role — so `status` is narrow in practice but
+ * kept whole here rather than guessed at.
+ *
+ * The schema-defined fields are open: which of them exist depends on the
+ * collection, and a theme must not assume one is present. `entryTitle` in
+ * `src/render/entry.ts` is the only place that reaches for one.
+ */
+export interface ContentEntry {
+    readonly id: string;
+    readonly collection: string;
+    readonly locale: string;
+    readonly status: 'draft' | 'scheduled' | 'published' | 'archived';
+    readonly [field: string]: unknown;
+}
+export interface QueryRequest {
+    readonly collection: string;
+    readonly filter?: Readonly<Record<string, unknown>>;
+    readonly sort?: {
+        readonly field: string;
+        readonly direction: 'asc' | 'desc';
+    };
+    readonly limit?: number;
+    readonly cursor?: string;
+}
+export interface Page<T> {
+    readonly items: readonly T[];
+    readonly nextCursor: string | null;
+}
+export interface ContentClient {
+    entry(collection: string, id: string): Promise<ContentEntry | null>;
+    byPath(path: string): Promise<ContentEntry | null>;
+    list(request: QueryRequest): Promise<Page<ContentEntry>>;
+}
+export type LinkTargetInput = {
+    collection: string;
+    id: string;
+} | {
+    path: string;
+} | string;
+export interface RenderContext {
+    readonly site: {
+        readonly name: string;
+        readonly url: string;
+        readonly locales: readonly string[];
+        readonly defaultLocale: string;
+    };
+    /** The locale being rendered. */
+    readonly locale: string;
+    /** The URL being rendered, already resolved. */
+    readonly url: URL;
+    /** Translation. An unknown key returns the key, never an empty string. */
+    t(key: string, values?: Readonly<Record<string, string | number>>): string;
+    /** Image variants. Returns what a responsive `<img>` needs, nothing more. */
+    image(media: MediaReference, options?: ImageOptions): ImageSource;
+    /** URL of an entry, of a path, or of an external target. Locale-aware. */
+    link(target: LinkTargetInput): string;
+    /** Read-only content access. The only door to data a theme has. */
+    readonly content: ContentClient;
+}
+/** Contract D, "Besoins runtime". */
+export type ThemeRuntime = 'static' | 'server' | 'edge';
+export interface ThemeManifest {
+    readonly name: string;
+    readonly version: string;
+    /** Version of the theme contract. */
+    readonly engine: string;
+    /** Version of the block vocabulary supported. */
+    readonly blocks: string;
+    /** Every vocabulary block the theme renders. A gap fails installation. */
+    readonly implements: readonly string[];
+    /** Content types expected, or `'*'`. */
+    readonly collections: readonly string[] | '*';
+    readonly runtime: ThemeRuntime;
+    /** Path to the default skin, relative to the manifest. */
+    readonly tokens: string;
+    readonly a11y: {
+        readonly verified: 'WCAG-2.2-AA' | 'WCAG-2.2-AAA' | 'none';
+    };
+}
+/**
+ * Identity function. It exists for the inference and for the single place a
+ * manifest is recognised, not to validate: validation happens at installation,
+ * on the theme's sources, where a lie can actually be caught.
+ */
+export declare function defineTheme<const M extends ThemeManifest>(manifest: M): M;
+/**
+ * Contract D, "Tokens de skin". The set is **closed and complete**: a skin that
+ * omits a token is refused. Rendered as `--cogenta-<group>-<name>` into a single
+ * stylesheet, so changing skin rewrites one file and needs no build.
+ */
+export interface SkinTokens {
+    readonly color: {
+        readonly bg: string;
+        readonly fg: string;
+        readonly accent: string;
+        readonly accentFg: string;
+        readonly muted: string;
+        readonly mutedFg: string;
+        readonly border: string;
+    };
+    readonly font: {
+        readonly sans: string;
+        readonly serif: string;
+        readonly mono: string;
+        readonly scale: number;
+        readonly baseSize: string;
+    };
+    readonly space: {
+        readonly unit: string;
+        readonly density: 'compact' | 'comfortable' | 'spacious';
+    };
+    readonly radius: {
+        readonly sm: string;
+        readonly md: string;
+        readonly lg: string;
+    };
+    readonly motion: {
+        readonly duration: string;
+        readonly easing: string;
+        readonly reduced: boolean;
+    };
+    readonly shadow: {
+        readonly sm: string;
+        readonly md: string;
+    };
+}
+//# sourceMappingURL=theme-contract.d.ts.map

package/dist/src/theme-contract.d.ts.map

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

package/dist/src/theme-contract.js

@@ -0,0 +1,21 @@
+/**
+ * Contract D — Thème, frozen at `theme@1.0` on 2026-08-13.
+ *
+ * TEMPORARY HOME. These types and `defineTheme` belong to `@cogenta/render`,
+ * which is being written in parallel (tasks 1–3 of L3). They live here so the
+ * canonical theme can be written, typechecked and tested today, and must be
+ * replaced by an import from `@cogenta/render` at merge time — not duplicated.
+ *
+ * Nothing below adds to `ctx`. Two shapes the contract names but does not spell
+ * out — `MediaReference` and `ContentEntry` — are given the narrowest reading
+ * that matches what is already frozen elsewhere; both are flagged in the code.
+ */
+/**
+ * Identity function. It exists for the inference and for the single place a
+ * manifest is recognised, not to validate: validation happens at installation,
+ * on the theme's sources, where a lie can actually be caught.
+ */
+export function defineTheme(manifest) {
+    return manifest;
+}
+//# sourceMappingURL=theme-contract.js.map

package/dist/src/theme-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-contract.js","sourceRoot":"","sources":["../../src/theme-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA6GH;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAgC,QAAW;IACpE,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/dist/theme.config.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Contract D — Thème, `theme@1.0`.
+ *
+ * `implements` lists the twelve blocks of contract B in the order the contract
+ * lists them. A theme that omits one fails installation, which is what
+ * guarantees that switching theme never erases content.
+ *
+ * `runtime: 'static'` describes what *this theme* needs, not what every block
+ * on a page needs: `collectionList` is `runtime: 'server'` in the vocabulary
+ * and it is the block, not the theme, that makes a static build refuse. Saying
+ * `'server'` here would force every site using the canonical theme onto a
+ * server even when no page lists anything.
+ *
+ * `a11y.verified` is a claim this package has to keep true: the tests assert
+ * the heading outline, the mandatory `alt`, and the closed token set.
+ */
+declare const _default: {
+    readonly name: "canonical";
+    readonly version: "1.0.0";
+    readonly engine: "^1.0.0";
+    readonly blocks: "^1.0.0";
+    readonly implements: readonly ["hero", "prose", "mediaFigure", "featureGrid", "cta", "gallery", "quote", "faq", "stats", "logos", "collectionList", "embed"];
+    readonly collections: readonly ["article", "page"];
+    readonly runtime: "static";
+    readonly tokens: "./tokens.json";
+    readonly a11y: {
+        readonly verified: "WCAG-2.2-AA";
+    };
+};
+export default _default;
+//# sourceMappingURL=theme.config.d.ts.map

package/dist/theme.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.config.d.ts","sourceRoot":"","sources":["../theme.config.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG"}

package/dist/theme.config.js

@@ -0,0 +1,42 @@
+import { defineTheme } from './src/theme-contract.js';
+/**
+ * Contract D — Thème, `theme@1.0`.
+ *
+ * `implements` lists the twelve blocks of contract B in the order the contract
+ * lists them. A theme that omits one fails installation, which is what
+ * guarantees that switching theme never erases content.
+ *
+ * `runtime: 'static'` describes what *this theme* needs, not what every block
+ * on a page needs: `collectionList` is `runtime: 'server'` in the vocabulary
+ * and it is the block, not the theme, that makes a static build refuse. Saying
+ * `'server'` here would force every site using the canonical theme onto a
+ * server even when no page lists anything.
+ *
+ * `a11y.verified` is a claim this package has to keep true: the tests assert
+ * the heading outline, the mandatory `alt`, and the closed token set.
+ */
+export default defineTheme({
+    name: 'canonical',
+    version: '1.0.0',
+    engine: '^1.0.0',
+    blocks: '^1.0.0',
+    implements: [
+        'hero',
+        'prose',
+        'mediaFigure',
+        'featureGrid',
+        'cta',
+        'gallery',
+        'quote',
+        'faq',
+        'stats',
+        'logos',
+        'collectionList',
+        'embed',
+    ],
+    collections: ['article', 'page'],
+    runtime: 'static',
+    tokens: './tokens.json',
+    a11y: { verified: 'WCAG-2.2-AA' },
+});
+//# sourceMappingURL=theme.config.js.map

package/dist/theme.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.config.js","sourceRoot":"","sources":["../theme.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAErD;;;;;;;;;;;;;;;GAeG;AACH,eAAe,WAAW,CAAC;IACzB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE;QACV,MAAM;QACN,OAAO;QACP,aAAa;QACb,aAAa;QACb,KAAK;QACL,SAAS;QACT,OAAO;QACP,KAAK;QACL,OAAO;QACP,OAAO;QACP,gBAAgB;QAChB,OAAO;KACR;IACD,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;IAChC,OAAO,EAAE,QAAQ;IACjB,MAAM,EAAE,eAAe;IACvB,IAAI,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE;CAClC,CAAC,CAAA"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@cogenta/theme-canonical",
+  "version": "0.1.0",
+  "description": "The reference Cogenta theme: the twelve vocabulary blocks, rendered accessibly, with zero client JavaScript.",
+  "license": "MPL-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./theme.config": {
+      "types": "./dist/theme.config.d.ts",
+      "default": "./dist/theme.config.js"
+    },
+    "./tokens.json": "./tokens.json",
+    "./blocks/*.astro": "./src/blocks/*.astro",
+    "./layouts/*.astro": "./src/layouts/*.astro",
+    "./components/*.astro": "./src/components/*.astro",
+    "./styles/theme.css": "./src/styles/theme.css"
+  },
+  "files": [
+    "dist",
+    "src",
+    "tokens.json"
+  ],
+  "engines": {
+    "node": ">=22.11.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cogenta-cms/cogenta.git",
+    "directory": "packages/theme-canonical"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.typecheck.json",
+    "test": "vitest run --passWithNoTests",
+    "test:integration": "vitest run --config vitest.integration.config.ts --passWithNoTests"
+  },
+  "dependencies": {
+    "@cogenta/blocks": "workspace:*"
+  },
+  "peerDependencies": {
+    "astro": "catalog:"
+  },
+  "devDependencies": {
+    "astro": "catalog:",
+    "typescript": "catalog:",
+    "vitest": "catalog:"
+  }
+}

package/src/blocks/CollectionList.astro

@@ -0,0 +1,20 @@
+---
+import type { CollectionListBlock } from '@cogenta/blocks'
+import { query, renderCollectionList } from '../render/blocks/collection-list.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/**
+ * See `Hero.astro` for why the markup lives in `src/render/`.
+ *
+ * The only block of the twelve that reads data at render time — contract B
+ * marks it `runtime: 'server'`. The read goes through `ctx.content`, the
+ * read-only HTTP client the theme is handed (ADR-0016); the theme has no
+ * database connection and no secrets, and this is its single door to data.
+ */
+const { block, ctx } = Astro.props as { block: CollectionListBlock; ctx: RenderContext }
+
+const page = await ctx.content.list(query(block))
+---
+
+<Fragment set:html={serialize(renderCollectionList(block, ctx, page.items))} />

package/src/blocks/Cta.astro

@@ -0,0 +1,11 @@
+---
+import type { CtaBlock } from '@cogenta/blocks'
+import { renderCta } from '../render/blocks/cta.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/** See `Hero.astro` for why the markup lives in `src/render/`. */
+const { block, ctx } = Astro.props as { block: CtaBlock; ctx: RenderContext }
+---
+
+<Fragment set:html={serialize(renderCta(block, ctx))} />

package/src/blocks/Embed.astro

@@ -0,0 +1,18 @@
+---
+import type { EmbedBlock } from '@cogenta/blocks'
+import { renderEmbed } from '../render/blocks/embed.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/**
+ * See `Hero.astro` for why the markup lives in `src/render/`.
+ *
+ * When `consentRequired` is true nothing third-party is requested: no iframe,
+ * no script, no preconnect, no poster image. A thumbnail fetched from the
+ * provider has already handed over the visitor's IP address, which is exactly
+ * the transfer the consent flag exists to gate.
+ */
+const { block, ctx } = Astro.props as { block: EmbedBlock; ctx: RenderContext }
+---
+
+<Fragment set:html={serialize(renderEmbed(block, ctx))} />

package/src/blocks/Faq.astro

@@ -0,0 +1,16 @@
+---
+import type { FaqBlock } from '@cogenta/blocks'
+import { renderFaq } from '../render/blocks/faq.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/**
+ * See `Hero.astro` for why the markup lives in `src/render/`.
+ *
+ * The accordion is `<details>`/`<summary>`: expanding, keyboard operation, the
+ * announced state and in-page search all come from the browser, at zero bytes.
+ */
+const { block, ctx } = Astro.props as { block: FaqBlock; ctx: RenderContext }
+---
+
+<Fragment set:html={serialize(renderFaq(block, ctx))} />

package/src/blocks/FeatureGrid.astro

@@ -0,0 +1,11 @@
+---
+import type { FeatureGridBlock } from '@cogenta/blocks'
+import { renderFeatureGrid } from '../render/blocks/feature-grid.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/** See `Hero.astro` for why the markup lives in `src/render/`. */
+const { block, ctx } = Astro.props as { block: FeatureGridBlock; ctx: RenderContext }
+---
+
+<Fragment set:html={serialize(renderFeatureGrid(block, ctx))} />

package/src/blocks/Gallery.astro

@@ -0,0 +1,17 @@
+---
+import type { GalleryBlock } from '@cogenta/blocks'
+import { renderGallery } from '../render/blocks/gallery.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/**
+ * See `Hero.astro` for why the markup lives in `src/render/`.
+ *
+ * This is the one block the brief allows to ask for client JavaScript, in
+ * carousel mode. It does not: the carousel is a scroll-snapping list. No
+ * `client:*` directive appears anywhere in this theme.
+ */
+const { block, ctx } = Astro.props as { block: GalleryBlock; ctx: RenderContext }
+---
+
+<Fragment set:html={serialize(renderGallery(block, ctx))} />

package/src/blocks/Hero.astro

@@ -0,0 +1,25 @@
+---
+import type { HeroBlock } from '@cogenta/blocks'
+import { renderHero } from '../render/blocks/hero.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/**
+ * Contract D, "Interface d'un composant de bloc": `{ block, ctx }`, nothing else.
+ *
+ * The markup itself lives in `src/render/blocks/*.ts`. Two reasons, and they
+ * apply to all twelve of these files:
+ *
+ * - it is testable without an Astro toolchain, so the twelve blocks have real
+ *   snapshot tests and the heading outline and `alt` rules are asserted on the
+ *   output rather than on a reading of the source;
+ * - that module has no way to emit raw HTML at all, so a string arriving in a
+ *   block field cannot become markup — which is rule R3 enforced by
+ *   construction rather than by review.
+ *
+ * These components stay one call long so the two can never drift.
+ */
+const { block, ctx } = Astro.props as { block: HeroBlock; ctx: RenderContext }
+---
+
+<Fragment set:html={serialize(renderHero(block, ctx))} />

package/src/blocks/Logos.astro

@@ -0,0 +1,11 @@
+---
+import type { LogosBlock } from '@cogenta/blocks'
+import { renderLogos } from '../render/blocks/logos.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/** See `Hero.astro` for why the markup lives in `src/render/`. */
+const { block, ctx } = Astro.props as { block: LogosBlock; ctx: RenderContext }
+---
+
+<Fragment set:html={serialize(renderLogos(block, ctx))} />

package/src/blocks/MediaFigure.astro

@@ -0,0 +1,11 @@
+---
+import type { MediaFigureBlock } from '@cogenta/blocks'
+import { renderMediaFigure } from '../render/blocks/media-figure.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/** See `Hero.astro` for why the markup lives in `src/render/`. */
+const { block, ctx } = Astro.props as { block: MediaFigureBlock; ctx: RenderContext }
+---
+
+<Fragment set:html={serialize(renderMediaFigure(block, ctx))} />

package/src/blocks/Prose.astro

@@ -0,0 +1,11 @@
+---
+import type { ProseBlock } from '@cogenta/blocks'
+import { renderProse } from '../render/blocks/prose.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/** See `Hero.astro` for why the markup lives in `src/render/`. */
+const { block, ctx } = Astro.props as { block: ProseBlock; ctx: RenderContext }
+---
+
+<Fragment set:html={serialize(renderProse(block, ctx))} />

package/src/blocks/Quote.astro

@@ -0,0 +1,11 @@
+---
+import type { QuoteBlock } from '@cogenta/blocks'
+import { renderQuote } from '../render/blocks/quote.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/** See `Hero.astro` for why the markup lives in `src/render/`. */
+const { block, ctx } = Astro.props as { block: QuoteBlock; ctx: RenderContext }
+---
+
+<Fragment set:html={serialize(renderQuote(block, ctx))} />

package/src/blocks/Stats.astro

@@ -0,0 +1,11 @@
+---
+import type { StatsBlock } from '@cogenta/blocks'
+import { renderStats } from '../render/blocks/stats.js'
+import { serialize } from '../render/html.js'
+import type { RenderContext } from '../theme-contract.js'
+
+/** See `Hero.astro` for why the markup lives in `src/render/`. */
+const { block, ctx } = Astro.props as { block: StatsBlock; ctx: RenderContext }
+---
+
+<Fragment set:html={serialize(renderStats(block, ctx))} />