@cogenta/theme-docs 0.3.2

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

@@ -0,0 +1,20 @@
+import { h, image, renderRichText } from '@cogenta/theme-kit';
+/**
+ * `blocks@2.0` (RFC 0001). The same `<figure><blockquote>…</blockquote>
+ * <figcaption>` pattern `quote` uses, kept consistent so the two read as
+ * siblings — the quote itself is rich text here, and the attribution is
+ * the block's single grouped `attribution` field rather than three loose
+ * ones.
+ */
+export function renderTestimonial(block, ctx) {
+    const { attribution } = block;
+    return h('figure', { class: 'cg-block cg-testimonial', 'data-block': 'testimonial' }, h('blockquote', { class: 'cg-testimonial__quote' }, renderRichText(ctx, block.quote)), h('figcaption', { class: 'cg-testimonial__attribution' }, attribution.avatar === undefined
+        ? null
+        : image(ctx, attribution.avatar, {
+            className: 'cg-testimonial__avatar',
+            variant: { width: 96, height: 96, fit: 'cover' },
+        }), h('span', { class: 'cg-testimonial__who' }, h('span', { class: 'cg-testimonial__name' }, attribution.name), attribution.role === undefined
+        ? null
+        : h('span', { class: 'cg-testimonial__role' }, attribution.role))));
+}
+//# sourceMappingURL=testimonial.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testimonial.js","sourceRoot":"","sources":["../../../../src/render/blocks/testimonial.ts"],"names":[],"mappings":"AACA,OAAO,EAAoB,CAAC,EAAE,KAAK,EAAsB,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnG;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAuB,EAAE,GAAkB;IAC3E,MAAM,EAAE,WAAW,EAAE,GAAG,KAAK,CAAA;IAC7B,OAAO,CAAC,CACN,QAAQ,EACR,EAAE,KAAK,EAAE,yBAAyB,EAAE,YAAY,EAAE,aAAa,EAAE,EACjE,CAAC,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,uBAAuB,EAAE,EAAE,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EACrF,CAAC,CACC,YAAY,EACZ,EAAE,KAAK,EAAE,6BAA6B,EAAE,EACxC,WAAW,CAAC,MAAM,KAAK,SAAS;QAC9B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,EAAE;YAC7B,SAAS,EAAE,wBAAwB;YACnC,OAAO,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE;SACjD,CAAC,EACN,CAAC,CACC,MAAM,EACN,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAChC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,EAC9D,WAAW,CAAC,IAAI,KAAK,SAAS;QAC5B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE,EAAE,WAAW,CAAC,IAAI,CAAC,CACnE,CACF,CACF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,3 @@
+import { type ChromeInput, type ChromeResult } from '@cogenta/theme-kit';
+export declare function renderChrome(input: ChromeInput): ChromeResult;
+//# sourceMappingURL=chrome.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chrome.d.ts","sourceRoot":"","sources":["../../../src/render/chrome.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,WAAW,EAEhB,KAAK,YAAY,EAOlB,MAAM,oBAAoB,CAAA;AA0D3B,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,GAAG,YAAY,CAuD7D"}

package/dist/src/render/chrome.js

@@ -0,0 +1,94 @@
+import { escapeAttribute, escapeText, renderBrandMark, renderSocialLinks, renderThemeToggle, serialize, } from '@cogenta/theme-kit';
+/**
+ * This theme's own header and footer — structurally distinct from the
+ * canonical theme's, not a recolour of it: a docs site's header carries a
+ * genuine CSS-only mobile menu (a `<details>` disclosure, never a script),
+ * because "Docs / Guides / Reference / Blog" plus a header action does not
+ * fit a narrow viewport the way three links do.
+ *
+ * The mobile panel is a **second, hidden-by-default copy** of the same nav
+ * markup, not a repositioned single copy: two static layouts (`display:none`
+ * either way at a given viewport width) is the only zero-JS way to put the
+ * links inline on a wide screen and inside a disclosure on a narrow one.
+ * `display:none` removes the inactive copy from the accessibility tree, so a
+ * screen reader is never offered two "Primary" navigations at once — only
+ * the sighted, CSS-driven layout differs.
+ *
+ * Footer: brand column (name + tagline), a footer nav column, social links,
+ * a short "about" note, and Cogenta's own credit (or its white-label
+ * replacement) — `brandingHtml` placed exactly once, unaltered.
+ */
+function navItems(links) {
+    return links
+        .filter((link) => link.href !== null || link.kind === 'submenu-placeholder')
+        .map((link) => {
+        const label = escapeText(link.label);
+        const titleAttr = link.title === null ? '' : ` title="${escapeAttribute(link.title)}"`;
+        if (link.href === null)
+            return `<li><span${titleAttr}>${label}</span></li>`;
+        const href = escapeAttribute(link.href);
+        const target = link.openInNewTab ? ' target="_blank" rel="noopener"' : '';
+        return `<li><a href="${href}"${target}${titleAttr}>${label}</a></li>`;
+    })
+        .join('');
+}
+function renderNav(links, className, label) {
+    const items = navItems(links);
+    return items === ''
+        ? ''
+        : `<nav class="${className}" aria-label="${label}"><ul class="cg-menu">${items}</ul></nav>`;
+}
+/** The header's own call-to-action link (`theme@1.4`), reusing `.cg-action`'s own look. */
+function renderHeaderAction(action, className) {
+    if (action === undefined)
+        return '';
+    return (`<a class="cg-action ${className}" data-emphasis="primary" ` +
+        `href="${escapeAttribute(action.href)}">${escapeText(action.label)}</a>`);
+}
+/** Three bars, drawn once for this file — not part of `renderIcon`'s closed vocabulary, since a "menu" glyph names no contract B field. */
+const HAMBURGER_SVG = '<svg class="cg-nav-toggle__icon" viewBox="0 0 24 24" width="22" height="22" fill="none" ' +
+    'stroke="currentColor" stroke-width="2" stroke-linecap="round" aria-hidden="true" focusable="false">' +
+    '<path d="M4 6h16M4 12h16M4 18h16"/></svg>';
+export function renderChrome(input) {
+    const siteName = escapeAttribute(input.site.name);
+    const siteNameText = escapeText(input.site.name);
+    const mark = renderBrandMark(input.brand, { className: 'cg-site-header__logo' }) ?? siteNameText;
+    const desktopNav = renderNav(input.headerNav, 'cg-site-header__nav', 'Primary');
+    const themeToggle = serialize(renderThemeToggle(input.locale, { className: 'cg-theme-toggle' }));
+    const desktopAction = renderHeaderAction(input.headerAction, 'cg-site-header__action');
+    const mobileNavItems = navItems(input.headerNav);
+    const mobileAction = renderHeaderAction(input.headerAction, 'cg-nav-toggle__action');
+    const mobilePanel = mobileNavItems === '' && mobileAction === ''
+        ? ''
+        : `<nav class="cg-nav-toggle__panel" aria-label="Primary">` +
+            `${mobileNavItems === '' ? '' : `<ul class="cg-menu">${mobileNavItems}</ul>`}` +
+            `${mobileAction}</nav>`;
+    const toggle = mobilePanel === ''
+        ? ''
+        : `<details class="cg-nav-toggle"><summary class="cg-nav-toggle__button" aria-label="Menu">${HAMBURGER_SVG}</summary>${mobilePanel}</details>`;
+    const header = `<header class="cg-site-header"><div class="cg-site-header__inner">` +
+        `<a class="cg-site-header__home" href="${escapeAttribute(input.homeHref)}">${mark}</a>` +
+        `${desktopNav}${themeToggle}${desktopAction}${toggle}` +
+        `</div></header>`;
+    const footerNav = renderNav(input.footerNav, 'cg-site-footer__nav', 'Footer');
+    const tagline = input.tagline === undefined
+        ? ''
+        : `<p class="cg-site-footer__tagline">${escapeText(input.tagline)}</p>`;
+    const socialElement = input.social === undefined
+        ? null
+        : renderSocialLinks(input.social, {
+            className: 'cg-site-footer__social',
+            itemClassName: 'cg-site-footer__social-item',
+        });
+    const social = socialElement === null ? '' : serialize(socialElement);
+    const footerNote = input.footerNote === undefined
+        ? ''
+        : `<p class="cg-site-footer__note">${escapeText(input.footerNote)}</p>`;
+    const footer = `<footer class="cg-site-footer"><div class="cg-site-footer__grid">` +
+        `<div class="cg-site-footer__brand"><a href="${escapeAttribute(input.homeHref)}">${siteName}</a>${tagline}${social}</div>` +
+        `<div class="cg-site-footer__nav-col">${footerNav}</div>` +
+        `<div class="cg-site-footer__about-col">${footerNote}<div class="cg-site-footer__branding">${input.brandingHtml}</div></div>` +
+        `</div><div class="cg-site-footer__bottom"><span>${siteName}</span></div></footer>`;
+    return { header, footer };
+}
+//# sourceMappingURL=chrome.js.map

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

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

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

@@ -0,0 +1,15 @@
+import { type BlockRegistry, type VocabularyBlock } from '@cogenta/blocks';
+import { type FetchedEntries, type HtmlElement, type PageContent, type RenderContext } from '@cogenta/theme-kit';
+export type { FetchedEntries, PageContent };
+export declare function renderBlock(block: VocabularyBlock, ctx: RenderContext, entries?: FetchedEntries, registry?: BlockRegistry): HtmlElement | null;
+/**
+ * `<main id="cg-main">` is mandatory: it is the skip-link's target, written
+ * once by `@cogenta/cli`'s own render path.
+ *
+ * `withBlockKey` stamps every rendered block with its contract-B `_key`, on
+ * every page including a doc page's content column — the visual page
+ * builder maps a clicked element back to the block that produced it, for
+ * this theme exactly as for every other one.
+ */
+export declare function renderPage(page: PageContent, ctx: RenderContext, entries?: FetchedEntries, registry?: BlockRegistry): 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,EAAE,KAAK,aAAa,EAAoB,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAA;AAC5F,OAAO,EAIL,KAAK,cAAc,EACnB,KAAK,WAAW,EAEhB,KAAK,WAAW,EAEhB,KAAK,aAAa,EAKnB,MAAM,oBAAoB,CAAA;AAmB3B,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,CAAA;AAE3C,wBAAgB,WAAW,CACzB,KAAK,EAAE,eAAe,EACtB,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,cAAmB,EAC5B,QAAQ,CAAC,EAAE,aAAa,GACvB,WAAW,GAAG,IAAI,CAKpB;AAsOD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,WAAW,EACjB,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,cAAmB,EAC5B,QAAQ,CAAC,EAAE,aAAa,GACvB,WAAW,CAcb"}

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

@@ -0,0 +1,176 @@
+import { VOCABULARY_NAMES } from '@cogenta/blocks';
+import { entryHref, entryTitle, h, pageHasOwnHeading, renderEntryHeader, resolveBlockForRender, withBlockKey, withBlockVariant, } from '@cogenta/theme-kit';
+import { renderAccordion } from './blocks/accordion.js';
+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 { renderLogoStrip } from './blocks/logo-strip.js';
+import { renderLogos } from './blocks/logos.js';
+import { renderMediaFigure } from './blocks/media-figure.js';
+import { renderPricingTable } from './blocks/pricing-table.js';
+import { renderProse } from './blocks/prose.js';
+import { renderQuote } from './blocks/quote.js';
+import { renderStatCounter } from './blocks/stat-counter.js';
+import { renderStats } from './blocks/stats.js';
+import { renderTestimonial } from './blocks/testimonial.js';
+export function renderBlock(block, ctx, entries = {}, registry) {
+    const resolved = resolveBlockForRender(block, VOCABULARY_NAMES, registry);
+    if (resolved === null)
+        return null;
+    const known = resolved;
+    return withBlockVariant(renderKnownBlock(known, ctx, entries), known.variant);
+}
+function renderKnownBlock(known, ctx, entries) {
+    switch (known._type) {
+        case 'hero':
+            return renderHero(known, ctx);
+        case 'prose':
+            return renderProse(known, ctx);
+        case 'mediaFigure':
+            return renderMediaFigure(known, ctx);
+        case 'featureGrid':
+            return renderFeatureGrid(known, ctx);
+        case 'cta':
+            return renderCta(known, ctx);
+        case 'gallery':
+            return renderGallery(known, ctx);
+        case 'quote':
+            return renderQuote(known, ctx);
+        case 'faq':
+            return renderFaq(known, ctx);
+        case 'stats':
+            return renderStats(known, ctx);
+        case 'logos':
+            return renderLogos(known, ctx);
+        case 'collectionList':
+            return renderCollectionList(known, ctx, entries[known._key] ?? []);
+        case 'embed':
+            return renderEmbed(known, ctx);
+        case 'testimonial':
+            return renderTestimonial(known, ctx);
+        case 'pricingTable':
+            return renderPricingTable(known, ctx);
+        case 'accordion':
+            return renderAccordion(known, ctx);
+        case 'statCounter':
+            return renderStatCounter(known, ctx);
+        case 'logoStrip':
+            return renderLogoStrip(known, ctx);
+        default: {
+            const unreachable = known;
+            void unreachable;
+            return null;
+        }
+    }
+}
+/**
+ * The name every doc page's own blueprint-seeded sidebar `collectionList`
+ * targets — checked structurally (first block, this collection) rather than
+ * by any flag on the block, because contract B carries no "this is chrome,
+ * not content" bit and inventing one would be a contract change for a
+ * single theme's layout choice.
+ */
+const DOC_PAGE_COLLECTION = 'doc_page';
+function isDocSidebarBlock(block) {
+    return block._type === 'collectionList' && block.collection === DOC_PAGE_COLLECTION;
+}
+/** The sidebar entry whose own link resolves to the page being rendered — the "current page" the brief asks the sidebar to highlight and the breadcrumb to name. */
+function findCurrentEntry(entries, ctx) {
+    return entries.find((entry) => entryHref(entry, ctx) === ctx.url.pathname);
+}
+/**
+ * The doc-page sidebar — grouped by each entry's own `section` field, in the
+ * order the entries were fetched (the blueprint seeds them in `order`
+ * within a section already; `collectionList.sort` cannot name `section`/
+ * `order`, so an editor who reorders sections relies on the fetch order,
+ * exactly like the "All guides" index on the home page does).
+ */
+function renderSidebarPanel(entries, ctx, currentHref) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const section = typeof entry.section === 'string' && entry.section !== ''
+            ? entry.section
+            : ctx.t('entry.untitled');
+        const list = groups.get(section) ?? [];
+        list.push(entry);
+        groups.set(section, list);
+    }
+    return h('nav', { class: 'cg-docs__nav-panel', 'aria-label': 'Documentation' }, [...groups.entries()].map(([section, sectionEntries]) => h('div', { class: 'cg-docs__nav-group' }, h('p', { class: 'cg-docs__nav-heading' }, section), h('ul', { class: 'cg-docs__nav-items' }, sectionEntries.map((entry) => {
+        const href = entryHref(entry, ctx);
+        const isCurrent = href === currentHref;
+        return h('li', {}, h('a', {
+            class: 'cg-docs__nav-link',
+            href,
+            'aria-current': isCurrent ? 'page' : undefined,
+        }, entryTitle(entry, ctx)));
+    })))));
+}
+/**
+ * The sidebar, in two copies — the same zero-JS technique `chrome.ts` already
+ * uses for the header's own mobile menu, and for the same reason: Chrome (and
+ * every other engine implementing the current HTML rendering rules) hides a
+ * closed `<details>`'s non-summary content through its own internal
+ * `::details-content` box, not through the plain CSS `display: none` the spec
+ * text describes — so a stylesheet rule that sets `display: block` on that
+ * content, however specific, does not reliably bring it back while the
+ * element itself stays closed. Verified live: a build with a single
+ * `<details>` forced open only above the two-column breakpoint rendered an
+ * empty sidebar column at 1280px in a real Chrome tab, despite every
+ * computed style reporting `display: block`.
+ *
+ * The fix is the same one already proven for the header: a plain, always-
+ * live `<nav>` for the desktop column (nothing to collapse, so nothing for
+ * the browser to hide), and a **separate** `<details>` disclosure — a full
+ * second copy of the same panel — for narrow viewports. Exactly one of the
+ * two is ever `display: block` at a given viewport width (`base.css`), so a
+ * screen reader is never offered two "Documentation" navigations at once,
+ * matching the header's own accessibility guarantee.
+ */
+function renderSidebar(entries, ctx, currentHref) {
+    return h('div', { class: 'cg-docs__nav-desktop' }, renderSidebarPanel(entries, ctx, currentHref));
+}
+function renderSidebarMobile(entries, ctx, currentHref) {
+    return h('details', { class: 'cg-docs__nav-mobile' }, h('summary', { class: 'cg-docs__nav-toggle' }, 'On this site'), renderSidebarPanel(entries, ctx, currentHref));
+}
+function renderBreadcrumb(section, title) {
+    return h('nav', { class: 'cg-docs__breadcrumb', 'aria-label': 'Breadcrumb' }, h('ol', {}, section === undefined ? null : h('li', {}, section), h('li', { 'aria-current': 'page' }, title)));
+}
+/**
+ * A doc page: two columns, CSS-only. The sidebar comes from the page's own
+ * *first* block — a `collectionList` on `doc_page` the blueprint seeds on
+ * every doc page for exactly this purpose — rendered as navigation rather
+ * than as a card list, and dropped from the ordinary block stream so it
+ * never also appears as content. The remaining blocks render in the content
+ * column, unchanged.
+ */
+function renderDocPage(page, ctx, sidebarBlock, entries, registry) {
+    const sidebarEntries = entries[sidebarBlock._key] ?? [];
+    const currentHref = ctx.url.pathname;
+    const current = findCurrentEntry(sidebarEntries, ctx);
+    const section = typeof current?.section === 'string' ? current.section : undefined;
+    const contentBlocks = page.blocks.slice(1);
+    const hasOwnHeading = pageHasOwnHeading(contentBlocks);
+    const entryHeader = renderEntryHeader(page, ctx);
+    return h('main', { class: 'cg-main cg-docs', id: 'cg-main' }, withBlockKey(h('div', { class: 'cg-docs__nav' }, renderSidebar(sidebarEntries, ctx, currentHref), renderSidebarMobile(sidebarEntries, ctx, currentHref)), sidebarBlock._key), h('div', { class: 'cg-docs__content' }, renderBreadcrumb(section, page.title), entryHeader ?? (hasOwnHeading ? null : h('h1', { class: 'cg-docs__title' }, page.title)), contentBlocks.map((block) => withBlockKey(renderBlock(block, ctx, entries, registry), block._key))));
+}
+/**
+ * `<main id="cg-main">` is mandatory: it is the skip-link's target, written
+ * once by `@cogenta/cli`'s own render path.
+ *
+ * `withBlockKey` stamps every rendered block with its contract-B `_key`, on
+ * every page including a doc page's content column — the visual page
+ * builder maps a clicked element back to the block that produced it, for
+ * this theme exactly as for every other one.
+ */
+export function renderPage(page, ctx, entries = {}, registry) {
+    const first = page.blocks[0];
+    if (first !== undefined && isDocSidebarBlock(first)) {
+        return renderDocPage(page, ctx, first, entries, registry);
+    }
+    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) => withBlockKey(renderBlock(block, ctx, entries, registry), block._key)));
+}
+//# 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/term-archive.d.ts

@@ -0,0 +1,10 @@
+import { type HtmlElement, type TermArchiveInput } from '@cogenta/theme-kit';
+/**
+ * The taxonomy-term archive (contract D `theme@1.3`) — a simple titled list,
+ * deliberately: a documentation site's own information architecture is the
+ * sidebar (`section`/`order`, plain fields), not a taxonomy, so this page is
+ * the plain fallback for a term an editor still chooses to classify content
+ * under, not a second navigation surface competing with the sidebar.
+ */
+export declare function renderTermArchive(input: TermArchiveInput): HtmlElement;
+//# sourceMappingURL=term-archive.d.ts.map

package/dist/src/render/term-archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"term-archive.d.ts","sourceRoot":"","sources":["../../../src/render/term-archive.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAK,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAE/E;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAsDtE"}

package/dist/src/render/term-archive.js

@@ -0,0 +1,32 @@
+import { h } from '@cogenta/theme-kit';
+/**
+ * The taxonomy-term archive (contract D `theme@1.3`) — a simple titled list,
+ * deliberately: a documentation site's own information architecture is the
+ * sidebar (`section`/`order`, plain fields), not a taxonomy, so this page is
+ * the plain fallback for a term an editor still chooses to classify content
+ * under, not a second navigation surface competing with the sidebar.
+ */
+export function renderTermArchive(input) {
+    const rows = input.entries.map((entry) => h('li', { class: 'cg-list__row' }, h('div', { class: 'cg-list__body' }, h('h2', { class: 'cg-list__title' }, entry.href === null
+        ? entry.title
+        : h('a', { class: 'cg-list__link', href: entry.href }, entry.title)), entry.summary === null ? null : h('p', { class: 'cg-list__excerpt' }, entry.summary)), entry.publishedAt === null
+        ? null
+        : h('time', { class: 'cg-list__date', datetime: entry.publishedAt }, entry.publishedAt.slice(0, 10))));
+    return h('main', { class: 'cg-main cg-archive', id: 'cg-main' }, input.ancestors.length === 0
+        ? null
+        : h('nav', { class: 'cg-archive__breadcrumb', 'aria-label': input.labels.breadcrumb }, h('ol', {}, ...input.ancestors.map((l) => h('li', {}, h('a', { href: l.href }, l.label))))), h('h1', { class: 'cg-page__title' }, input.term.label), input.children.length === 0
+        ? null
+        : h('ul', { class: 'cg-archive__children', 'aria-label': input.labels.subterms }, ...input.children.map((c) => h('li', {}, h('a', { href: c.href }, c.label)))), rows.length === 0
+        ? h('p', { class: 'cg-list__empty' }, input.labels.empty)
+        : h('ul', { class: 'cg-list__items' }, ...rows), pager(input));
+}
+function pager(input) {
+    if (input.page.previousHref === null && input.page.nextHref === null)
+        return null;
+    return h('nav', { class: 'cg-archive__pager', 'aria-label': input.labels.pagination }, input.page.previousHref === null
+        ? null
+        : h('a', { rel: 'prev', href: input.page.previousHref }, input.labels.previous), input.page.nextHref === null
+        ? null
+        : h('a', { rel: 'next', href: input.page.nextHref }, input.labels.next));
+}
+//# sourceMappingURL=term-archive.js.map

package/dist/src/render/term-archive.js.map

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

package/dist/theme.config.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Contract D — Theme, `theme@1.4`.
+ *
+ * `implements` lists the seventeen blocks of contract B (`blocks@2.0`, RFC
+ * 0001) in the order the contract lists them — see
+ * `@cogenta/theme-canonical/theme.config.ts` for why that order matters
+ * (installation refuses an incomplete theme).
+ *
+ * `runtime: 'static'` describes what this theme package itself needs; the
+ * one block in the vocabulary that reads at request time (`collectionList`)
+ * still declares `runtime: 'server'` on its own, in the vocabulary — that is
+ * a property of the block, not of the theme rendering it.
+ */
+declare const _default: import("@cogenta/render").ThemeManifest;
+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;;;;;;;;;;;;GAYG"}

package/dist/theme.config.js

@@ -0,0 +1,46 @@
+import { defineTheme } from '@cogenta/render';
+/**
+ * Contract D — Theme, `theme@1.4`.
+ *
+ * `implements` lists the seventeen blocks of contract B (`blocks@2.0`, RFC
+ * 0001) in the order the contract lists them — see
+ * `@cogenta/theme-canonical/theme.config.ts` for why that order matters
+ * (installation refuses an incomplete theme).
+ *
+ * `runtime: 'static'` describes what this theme package itself needs; the
+ * one block in the vocabulary that reads at request time (`collectionList`)
+ * still declares `runtime: 'server'` on its own, in the vocabulary — that is
+ * a property of the block, not of the theme rendering it.
+ */
+export default defineTheme({
+    name: 'docs',
+    version: '1.0.0',
+    description: 'A dense, reference-first documentation theme: a sticky sidebar-navigated doc layout, real code blocks, a genuine dark mode.',
+    author: 'Cogenta',
+    engine: '^1.0.0',
+    blocks: '^2.0.0',
+    implements: [
+        'hero',
+        'prose',
+        'mediaFigure',
+        'featureGrid',
+        'cta',
+        'gallery',
+        'quote',
+        'faq',
+        'stats',
+        'logos',
+        'collectionList',
+        'embed',
+        'testimonial',
+        'pricingTable',
+        'accordion',
+        'statCounter',
+        'logoStrip',
+    ],
+    collections: ['doc_page', '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,iBAAiB,CAAA;AAE7C;;;;;;;;;;;;GAYG;AACH,eAAe,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,OAAO;IAChB,WAAW,EACT,6HAA6H;IAC/H,MAAM,EAAE,SAAS;IACjB,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;QACP,aAAa;QACb,cAAc;QACd,WAAW;QACX,aAAa;QACb,WAAW;KACZ;IACD,WAAW,EAAE,CAAC,UAAU,EAAE,MAAM,CAAC;IACjC,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-docs",
+  "version": "0.3.2",
+  "description": "A dense, reference-first documentation theme for Cogenta: a sticky sidebar-navigated doc layout, real code blocks, and a genuine dark mode — 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",
+    "./styles/theme.css": "./src/styles/theme.css",
+    "./styles/*.css": "./src/styles/*.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-docs"
+  },
+  "dependencies": {
+    "@cogenta/theme-kit": "0.3.2",
+    "@cogenta/blocks": "1.0.3",
+    "@cogenta/render": "0.2.3"
+  },
+  "peerDependencies": {
+    "astro": "^7.2.1"
+  },
+  "devDependencies": {
+    "astro": "^7.2.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
+  },
+  "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"
+  }
+}

package/src/index.ts

@@ -0,0 +1,20 @@
+export * from './render/blocks/accordion.js'
+export * from './render/blocks/collection-list.js'
+export * from './render/blocks/cta.js'
+export * from './render/blocks/embed.js'
+export * from './render/blocks/faq.js'
+export * from './render/blocks/feature-grid.js'
+export * from './render/blocks/gallery.js'
+export * from './render/blocks/hero.js'
+export * from './render/blocks/logo-strip.js'
+export * from './render/blocks/logos.js'
+export * from './render/blocks/media-figure.js'
+export * from './render/blocks/pricing-table.js'
+export * from './render/blocks/prose.js'
+export * from './render/blocks/quote.js'
+export * from './render/blocks/stat-counter.js'
+export * from './render/blocks/stats.js'
+export * from './render/blocks/testimonial.js'
+export * from './render/chrome.js'
+export * from './render/render-block.js'
+export * from './render/term-archive.js'

package/src/render/blocks/accordion.ts

@@ -0,0 +1,51 @@
+import type { AccordionBlock, AccordionItem } from '@cogenta/blocks'
+import {
+  blockHeadingTag,
+  type HtmlElement,
+  h,
+  heading,
+  type RenderContext,
+  renderRichText,
+} from '@cogenta/theme-kit'
+
+/**
+ * `blocks@2.0` (RFC 0001). Reuses `faq`'s zero-JS `<details>`/`<summary>`
+ * mechanics with a markup vocabulary of its own (`cg-panels`, not
+ * `cg-faq`), a rotating chevron mark rather than a numbered row.
+ */
+function renderItem(item: AccordionItem, ctx: RenderContext): HtmlElement {
+  return h(
+    'li',
+    { class: 'cg-panels__item' },
+    h(
+      'details',
+      { class: 'cg-panels__details' },
+      h(
+        'summary',
+        { class: 'cg-panels__question' },
+        h('span', { class: 'cg-panels__question-text' }, item.question),
+        h('span', { class: 'cg-panels__chevron', 'aria-hidden': 'true' }),
+      ),
+      h('div', { class: 'cg-panels__answer' }, renderRichText(ctx, item.answer)),
+    ),
+  )
+}
+
+export function renderAccordion(block: AccordionBlock, ctx: RenderContext): HtmlElement {
+  return h(
+    'section',
+    { class: 'cg-block cg-panels', 'data-block': 'accordion' },
+    block.title === undefined
+      ? null
+      : heading(
+          blockHeadingTag('accordion') ?? 'h2',
+          { class: 'cg-panels__title', 'data-field': 'title' },
+          block.title,
+        ),
+    h(
+      'ul',
+      { class: 'cg-panels__items' },
+      block.items.map((item) => renderItem(item, ctx)),
+    ),
+  )
+}