@cedros/data-react 0.1.0

package/dist/react/sitemap.js

@@ -0,0 +1,91 @@
+import { fetchJson, resolveServerUrl } from "./fetch.js";
+/** Map of content types to their collection names in cedros-data. */
+const CONTENT_TYPE_COLLECTIONS = {
+    page: "pages",
+    blog: "blog",
+    docs: "docs",
+    learn: "learn",
+    project: "projects",
+    airdrop: "airdrops",
+};
+/** Default change frequency and priority for each content type. */
+const CONTENT_TYPE_DEFAULTS = {
+    page: { changeFrequency: "monthly", priority: 0.8 },
+    blog: { changeFrequency: "weekly", priority: 0.7 },
+    docs: { changeFrequency: "weekly", priority: 0.6 },
+    learn: { changeFrequency: "monthly", priority: 0.5 },
+    project: { changeFrequency: "monthly", priority: 0.5 },
+    airdrop: { changeFrequency: "daily", priority: 0.4 },
+};
+const ALL_CONTENT_TYPES = [
+    "page",
+    "blog",
+    "docs",
+    "learn",
+    "project",
+    "airdrop",
+];
+/**
+ * Loads all routable content slugs from cedros-data for sitemap generation.
+ *
+ * Queries each content type collection and returns a flat list of sitemap
+ * entries with slug, lastModified, changeFrequency, and priority.
+ *
+ * @example
+ * ```ts
+ * // app/sitemap.ts
+ * import { loadSitemapEntries } from '@cedros/data-react/server';
+ *
+ * export default async function sitemap() {
+ *   const entries = await loadSitemapEntries({
+ *     serverUrl: process.env.NEXT_PUBLIC_BACKEND_API_URL,
+ *   });
+ *   return entries.map((e) => ({
+ *     url: `${process.env.NEXT_PUBLIC_ORIGIN}/${e.slug}`,
+ *     lastModified: e.lastModified,
+ *     changeFrequency: e.changeFrequency,
+ *     priority: e.priority,
+ *   }));
+ * }
+ * ```
+ */
+export async function loadSitemapEntries(options) {
+    const serverUrl = resolveServerUrl(options);
+    const contentTypes = options?.contentTypes ?? ALL_CONTENT_TYPES;
+    const results = await Promise.allSettled(contentTypes.map((ct) => fetchCollectionSlugs(serverUrl, ct)));
+    const entries = [];
+    for (let i = 0; i < results.length; i++) {
+        const result = results[i];
+        if (result.status === "fulfilled") {
+            entries.push(...result.value);
+        }
+        else {
+            console.warn(`@cedros/data-react: skipping sitemap content type "${contentTypes[i]}" — ${result.reason}`);
+        }
+    }
+    return entries;
+}
+async function fetchCollectionSlugs(serverUrl, contentType) {
+    const collectionName = CONTENT_TYPE_COLLECTIONS[contentType];
+    const defaults = CONTENT_TYPE_DEFAULTS[contentType];
+    const records = await fetchJson(serverUrl, "/entries/query", {
+        method: "POST",
+        body: {
+            collection_name: collectionName,
+            limit: 1000,
+            offset: 0,
+        },
+    });
+    return records.map((record) => {
+        const slug = record.payload.slug ??
+            record.payload.route?.replace(/^\//, "") ??
+            record.entry_key;
+        return {
+            slug,
+            contentType,
+            lastModified: record.updated_at,
+            changeFrequency: defaults.changeFrequency,
+            priority: defaults.priority,
+        };
+    });
+}

package/dist/react/slugs.d.ts

@@ -0,0 +1,27 @@
+import type { ContentType, ServerFetchOptions } from "./types.js";
+/**
+ * Returns all slugs for a given content type, for use with
+ * Next.js `generateStaticParams`.
+ *
+ * @example
+ * ```ts
+ * // app/blog/[slug]/page.tsx
+ * import { listContentSlugs } from '@cedros/data-react/server';
+ *
+ * export async function generateStaticParams() {
+ *   const slugs = await listContentSlugs('blog');
+ *   return slugs.map((slug) => ({ slug }));
+ * }
+ * ```
+ */
+export declare function listContentSlugs(contentType: ContentType, options?: ServerFetchOptions): Promise<string[]>;
+/**
+ * Returns all blog post slugs for `generateStaticParams`.
+ * Convenience wrapper around `listContentSlugs('blog')`.
+ */
+export declare function listBlogSlugs(options?: ServerFetchOptions): Promise<string[]>;
+/**
+ * Returns all learn path IDs for `generateStaticParams`.
+ * Convenience wrapper around `listContentSlugs('learn')`.
+ */
+export declare function listLearnPathIds(options?: ServerFetchOptions): Promise<string[]>;

package/dist/react/slugs.js

@@ -0,0 +1,52 @@
+import { fetchJson, resolveServerUrl } from "./fetch.js";
+/** Map of content types to their collection names in cedros-data. */
+const CONTENT_TYPE_COLLECTIONS = {
+    page: "pages",
+    blog: "blog",
+    docs: "docs",
+    learn: "learn",
+    project: "projects",
+    airdrop: "airdrops",
+};
+/**
+ * Returns all slugs for a given content type, for use with
+ * Next.js `generateStaticParams`.
+ *
+ * @example
+ * ```ts
+ * // app/blog/[slug]/page.tsx
+ * import { listContentSlugs } from '@cedros/data-react/server';
+ *
+ * export async function generateStaticParams() {
+ *   const slugs = await listContentSlugs('blog');
+ *   return slugs.map((slug) => ({ slug }));
+ * }
+ * ```
+ */
+export async function listContentSlugs(contentType, options) {
+    const serverUrl = resolveServerUrl(options);
+    const collectionName = CONTENT_TYPE_COLLECTIONS[contentType];
+    const records = await fetchJson(serverUrl, "/entries/query", {
+        method: "POST",
+        body: {
+            collection_name: collectionName,
+            limit: 1000,
+            offset: 0,
+        },
+    });
+    return records.map((record) => record.payload.slug ?? record.entry_key);
+}
+/**
+ * Returns all blog post slugs for `generateStaticParams`.
+ * Convenience wrapper around `listContentSlugs('blog')`.
+ */
+export async function listBlogSlugs(options) {
+    return listContentSlugs("blog", options);
+}
+/**
+ * Returns all learn path IDs for `generateStaticParams`.
+ * Convenience wrapper around `listContentSlugs('learn')`.
+ */
+export async function listLearnPathIds(options) {
+    return listContentSlugs("learn", options);
+}

package/dist/react/types.d.ts

@@ -0,0 +1,85 @@
+/** Content type identifiers used across cedros-data. */
+export type ContentType = "page" | "blog" | "docs" | "learn" | "project" | "airdrop";
+/**
+ * A CMS page record as returned by the cedros-data entries API.
+ * The payload shape follows the default page schema seeded by bootstrap.
+ */
+export interface CmsPageRecord {
+    entry_key: string;
+    payload: {
+        key?: string;
+        title?: string;
+        description?: string;
+        route?: string;
+        section?: string;
+        status?: string;
+        body?: string;
+        bodyHtml?: string;
+        ogTitle?: string;
+        ogDescription?: string;
+        ogImage?: string;
+        twitterTitle?: string;
+        twitterDescription?: string;
+        author?: string;
+        publishedAt?: string;
+        updatedAt?: string;
+        category?: string;
+        tags?: string[];
+        slug?: string;
+        readingMinutes?: number;
+        wordCount?: number;
+        _metering?: MeteredReadsInfo;
+        [key: string]: unknown;
+    };
+    updated_at: string;
+}
+/** Site-level settings record from the site_settings collection. */
+export interface SiteDataRecord {
+    siteTitle?: string;
+    siteName?: string;
+    siteDescription?: string;
+    defaultDescription?: string;
+    defaultOgImage?: string;
+    locale?: string;
+    timezone?: string;
+    [key: string]: unknown;
+}
+/** A routable content entry for sitemap generation. */
+export interface SitemapEntry {
+    slug: string;
+    contentType: ContentType;
+    lastModified?: string;
+    changeFrequency?: "daily" | "weekly" | "monthly";
+    priority?: number;
+}
+/** Options for the HTML sanitizer. */
+export interface SanitizeOptions {
+    /** Tags to allow. Defaults to a safe prose subset. */
+    allowedTags?: string[];
+    /** Attributes to allow per tag. Defaults to a safe set. */
+    allowedAttributes?: Record<string, string[]>;
+    /** Default target for links. */
+    linkTarget?: string;
+    /** Allowed URL protocols for href/src attributes. */
+    allowedProtocols?: string[];
+}
+/** Options for building page metadata. */
+export interface BuildPageMetadataOptions {
+    siteData?: SiteDataRecord;
+    origin?: string;
+    path?: string;
+    mode?: "blog" | "docs" | "page";
+}
+/** Metering status injected into entry payloads when visitor_id is provided. */
+export interface MeteredReadsInfo {
+    remainingFreeReads: number;
+    freeReadsPerMonth: number;
+    readsUsed: number;
+}
+/** Options for server-side data fetching helpers. */
+export interface ServerFetchOptions {
+    /** Base URL of the cedros-data server. Falls back to CEDROS_DATA_URL env var. */
+    serverUrl?: string;
+    /** Visitor ID for metered-reads tracking. Use `getOrCreateVisitorId()` on the client. */
+    visitorId?: string;
+}

package/dist/react/types.js

@@ -0,0 +1 @@
+export {};

package/dist/react/visitor.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Client-side visitor identification via cookie.
+ *
+ * Returns a stable UUID stored in `cedros_vid` cookie (1-year expiry, SameSite=Lax).
+ * Returns `""` during SSR when `document` is unavailable.
+ */
+export declare function getOrCreateVisitorId(): string;

package/dist/react/visitor.js

@@ -0,0 +1,18 @@
+/**
+ * Client-side visitor identification via cookie.
+ *
+ * Returns a stable UUID stored in `cedros_vid` cookie (1-year expiry, SameSite=Lax).
+ * Returns `""` during SSR when `document` is unavailable.
+ */
+export function getOrCreateVisitorId() {
+    if (typeof document === "undefined")
+        return "";
+    const name = "cedros_vid";
+    const match = document.cookie.match(new RegExp(`(?:^|; )${name}=([^;]*)`));
+    if (match)
+        return decodeURIComponent(match[1]);
+    const id = crypto.randomUUID();
+    const maxAge = 365 * 24 * 60 * 60; // 1 year in seconds
+    document.cookie = `${name}=${encodeURIComponent(id)}; path=/; max-age=${maxAge}; SameSite=Lax`;
+    return id;
+}

package/dist/site-templates/BlogTemplates.d.ts

@@ -0,0 +1,95 @@
+import type { SiteNavigationItem } from "./SiteLayout.js";
+import { type BlogIndexEntry, type FilterDimension, type FilterDimensionValues } from "./contentIndex.js";
+import { type TipCurrency, type TipPayClient } from "./tipControls.js";
+import { type PaywallPrice, type PaywallPayClient } from "./paywallControls.js";
+export interface BlogPostSummary extends BlogIndexEntry {
+    author?: string;
+    readingMinutes?: number;
+}
+export interface BlogIndexTemplateProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    posts: BlogPostSummary[];
+    title?: string;
+    description?: string;
+    basePath?: string;
+    query?: string;
+    category?: string;
+    tag?: string;
+    sort?: "newest" | "oldest" | "title-asc" | "title-desc";
+    page?: number;
+    pageSize?: number;
+    categories?: string[];
+    tags?: string[];
+    /** Generic filter dimensions (replaces category/tag dropdowns when provided) */
+    filterDimensions?: FilterDimension[];
+    /** Current active filter values per dimension */
+    activeFilters?: FilterDimensionValues;
+    /** Called when a dimension filter chip is toggled */
+    onFilterChange?: (key: string, value: string) => void;
+    /** Called on debounced search input (enables client-side search with CMD+K) */
+    onSearch?: (query: string) => void;
+    /** Set of bookmarked post slugs */
+    bookmarkedSlugs?: Set<string>;
+    /** Called when bookmark button is toggled */
+    onBookmarkToggle?: (slug: string) => void;
+}
+export declare function BlogIndexTemplate({ siteTitle, navigation, posts, title, description, basePath, query, category, tag, sort, page, pageSize, categories, tags, filterDimensions, activeFilters, onFilterChange, onSearch, bookmarkedSlugs, onBookmarkToggle }: BlogIndexTemplateProps): React.JSX.Element;
+export interface BlogTippingConfig {
+    enabled: boolean;
+    label?: string;
+    description?: string;
+    recipient: string;
+    currencies: TipCurrency[];
+    presets?: Record<string, number[]>;
+    payClient: TipPayClient;
+    /** When true, `recipientOverride` takes precedence over `recipient`. */
+    allowPerPostRecipient?: boolean;
+    /** Per-post tip recipient (used when `allowPerPostRecipient` is true). */
+    recipientOverride?: string;
+}
+export interface BlogPaywallConfig {
+    mode: "free" | "preview" | "locked";
+    previewParagraphs?: number;
+    price?: PaywallPrice;
+    unlocked: boolean;
+    payClient: PaywallPayClient;
+    subscriptionLabel?: string;
+    purchaseLabel?: string;
+    /** Remaining metered free reads this month (undefined = metering disabled). */
+    remainingFreeReads?: number;
+}
+export interface BlogPostTemplateProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    title: string;
+    bodyMarkdown?: string;
+    bodyHtml?: string;
+    allowUnsafeHtmlFallback?: boolean;
+    publishedAt?: string;
+    updatedAt?: string;
+    author?: string;
+    category?: string;
+    tags?: string[];
+    readingMinutes?: number;
+    canonicalUrl?: string;
+    breadcrumbs?: Array<{
+        label: string;
+        href: string;
+    }>;
+    relatedPosts?: Array<{
+        slug: string;
+        title: string;
+        excerpt?: string;
+    }>;
+    basePath?: string;
+    /** Whether this post is bookmarked */
+    isBookmarked?: boolean;
+    /** Called when bookmark button is toggled */
+    onBookmarkToggle?: (slug: string) => void;
+    /** Post slug (required when using bookmark) */
+    slug?: string;
+    tipping?: BlogTippingConfig;
+    paywall?: BlogPaywallConfig;
+}
+export declare function BlogPostTemplate({ siteTitle, navigation, title, bodyMarkdown, bodyHtml, allowUnsafeHtmlFallback, publishedAt, updatedAt, author, category, tags, readingMinutes, canonicalUrl, breadcrumbs, relatedPosts, basePath, isBookmarked, onBookmarkToggle, slug, tipping, paywall }: BlogPostTemplateProps): React.JSX.Element;

package/dist/site-templates/BlogTemplates.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { SiteLayout } from "./SiteLayout.js";
+import { buildContentListHref, collectFilterValues, prepareBlogIndex } from "./contentIndex.js";
+import { Breadcrumbs, ContentPagination } from "./contentUi.js";
+import { MarkdownContent } from "./MarkdownContent.js";
+import { BlogSearchInput, BookmarkButton, FilterDimensionChips } from "./blogControls.js";
+import { TipWidget } from "./tipControls.js";
+import { ContentPaywall } from "./paywallControls.js";
+export function BlogIndexTemplate({ siteTitle, navigation, posts, title = "Blog", description = "", basePath = "/blog", query = "", category = "", tag = "", sort = "newest", page = 1, pageSize = 8, categories, tags, filterDimensions, activeFilters, onFilterChange, onSearch, bookmarkedSlugs, onBookmarkToggle }) {
+    const normalizedFilters = collectFilterValues(posts);
+    const resolvedCategories = categories ?? normalizedFilters.categories;
+    const resolvedTags = tags ?? normalizedFilters.tags;
+    const result = prepareBlogIndex(posts, {
+        query,
+        category,
+        tag,
+        sort,
+        page,
+        pageSize,
+        dimensions: activeFilters
+    });
+    const useClientControls = !!(filterDimensions || onSearch);
+    return (_jsxs(SiteLayout, { siteTitle: siteTitle, navigation: navigation, children: [_jsxs("section", { className: "cedros-site__card", children: [_jsx("h1", { className: "cedros-site__title", children: title }), description && _jsx("p", { className: "cedros-site__subtitle", children: description })] }), useClientControls ? (_jsxs("section", { className: "cedros-site__card", style: { display: "grid", gap: "0.7rem" }, children: [onSearch && _jsx(BlogSearchInput, { defaultValue: query, onSearch: onSearch }), filterDimensions && onFilterChange && (_jsx(FilterDimensionChips, { dimensions: filterDimensions, active: activeFilters ?? {}, onChange: onFilterChange }))] })) : (_jsx(BlogIndexControls, { basePath: basePath, query: query, category: category, tag: tag, sort: sort, categories: resolvedCategories, tags: resolvedTags })), result.totalItems === 0 && (_jsxs("section", { className: "cedros-site__card cedros-site__empty-state", children: [_jsx("h2", { className: "cedros-site__title", style: { fontSize: "1.25rem" }, children: "No posts found" }), _jsx("p", { className: "cedros-site__subtitle", style: { marginTop: "0.6rem" }, children: "Adjust filters or search terms to find matching articles." })] })), result.totalItems > 0 && (_jsxs(_Fragment, { children: [_jsx("section", { className: "cedros-site__content-grid", children: result.items.map((post) => (_jsxs("article", { className: "cedros-site__card cedros-site__entry-card", children: [_jsxs("div", { className: "cedros-site__entry-header", children: [_jsx("h2", { className: "cedros-site__entry-title", children: _jsx("a", { href: `${basePath}/${post.slug}`, children: post.title }) }), bookmarkedSlugs && onBookmarkToggle ? (_jsxs("div", { style: { display: "inline-flex", gap: "0.35rem", alignItems: "center" }, children: [post.publishedAt && _jsx("span", { className: "cedros-site__pill", children: post.publishedAt }), _jsx(BookmarkButton, { slug: post.slug, isBookmarked: bookmarkedSlugs.has(post.slug), onToggle: onBookmarkToggle })] })) : (post.publishedAt && _jsx("span", { className: "cedros-site__pill", children: post.publishedAt }))] }), (post.author || post.readingMinutes) && (_jsx("p", { className: "cedros-site__entry-meta", children: [post.author, readingTime(post.readingMinutes)].filter(Boolean).join(" • ") })), post.excerpt && _jsx("p", { className: "cedros-site__subtitle", children: post.excerpt }), post.tags && post.tags.length > 0 && (_jsx("div", { className: "cedros-site__tag-list", children: post.tags.map((entryTag) => (_jsx("a", { href: buildContentListHref(basePath, { q: query, category, tag: entryTag, sort }), className: "cedros-site__pill", children: entryTag }, entryTag))) }))] }, post.slug))) }), _jsx(ContentPagination, { basePath: basePath, page: result.page, totalPages: result.totalPages, query: { q: query, category, tag, sort } })] }))] }));
+}
+export function BlogPostTemplate({ siteTitle, navigation, title, bodyMarkdown, bodyHtml, allowUnsafeHtmlFallback = false, publishedAt, updatedAt, author, category, tags = [], readingMinutes, canonicalUrl, breadcrumbs = [], relatedPosts = [], basePath = "/blog", isBookmarked, onBookmarkToggle, slug, tipping, paywall }) {
+    const metadata = [publishedAt, updatedAt ? `Updated ${updatedAt}` : "", author, readingTime(readingMinutes)].filter(Boolean);
+    const showBookmark = isBookmarked !== undefined && onBookmarkToggle && slug;
+    return (_jsxs(SiteLayout, { siteTitle: siteTitle, navigation: navigation, children: [_jsx(Breadcrumbs, { trail: breadcrumbs }), _jsxs("article", { className: "cedros-site__card cedros-site__article", children: [_jsxs("div", { className: "cedros-site__article-header", children: [showBookmark ? (_jsxs("div", { style: { display: "inline-flex", gap: "0.35rem", alignItems: "center" }, children: [_jsx("span", { className: "cedros-site__pill", children: "blog" }), _jsx(BookmarkButton, { slug: slug, isBookmarked: isBookmarked, onToggle: onBookmarkToggle })] })) : (_jsx("span", { className: "cedros-site__pill", children: "blog" })), _jsx("h1", { className: "cedros-site__title", children: title }), metadata.length > 0 && _jsx("p", { className: "cedros-site__entry-meta", children: metadata.join(" • ") }), (category || tags.length > 0) && (_jsxs("div", { className: "cedros-site__tag-list", children: [category && (_jsx("a", { href: buildContentListHref(basePath, { category }), className: "cedros-site__pill", children: category })), tags.map((tag) => (_jsx("a", { href: buildContentListHref(basePath, { tag }), className: "cedros-site__pill", children: tag }, tag)))] })), canonicalUrl && (_jsx("a", { href: canonicalUrl, className: "cedros-site__subtitle", style: { marginTop: "0.5rem" }, children: "Canonical URL" }))] }), renderPaywallOrContent({
+                        paywall,
+                        bodyMarkdown,
+                        bodyHtml,
+                        allowUnsafeHtmlFallback
+                    })] }), tipping?.enabled && (_jsx("section", { className: "cedros-site__card", children: _jsx(TipWidget, { recipient: tipping.allowPerPostRecipient && tipping.recipientOverride
+                        ? tipping.recipientOverride
+                        : tipping.recipient, currencies: tipping.currencies, presets: tipping.presets, payClient: tipping.payClient, label: tipping.label, description: tipping.description }) })), relatedPosts.length > 0 && (_jsxs("section", { className: "cedros-site__card", children: [_jsx("h2", { style: { margin: 0, fontSize: "1.02rem" }, children: "Related posts" }), _jsx("div", { className: "cedros-site__content-grid", style: { marginTop: "0.75rem" }, children: relatedPosts.map((post) => (_jsxs("article", { className: "cedros-site__entry-card", children: [_jsx("h3", { className: "cedros-site__entry-title", style: { marginTop: 0 }, children: _jsx("a", { href: `${basePath}/${post.slug}`, children: post.title }) }), post.excerpt && _jsx("p", { className: "cedros-site__subtitle", children: post.excerpt })] }, post.slug))) })] }))] }));
+}
+function BlogIndexControls({ basePath, query, category, tag, sort, categories, tags }) {
+    return (_jsxs("form", { method: "get", action: basePath, className: "cedros-site__controls cedros-site__card", children: [_jsxs("label", { className: "cedros-site__control", children: [_jsx("span", { children: "Search" }), _jsx("input", { type: "search", name: "q", defaultValue: query, placeholder: "Search blog posts" })] }), _jsxs("label", { className: "cedros-site__control", children: [_jsx("span", { children: "Category" }), _jsxs("select", { name: "category", defaultValue: category, children: [_jsx("option", { value: "", children: "All" }), categories.map((entry) => (_jsx("option", { value: entry, children: entry }, entry)))] })] }), _jsxs("label", { className: "cedros-site__control", children: [_jsx("span", { children: "Tag" }), _jsxs("select", { name: "tag", defaultValue: tag, children: [_jsx("option", { value: "", children: "All" }), tags.map((entry) => (_jsx("option", { value: entry, children: entry }, entry)))] })] }), _jsxs("label", { className: "cedros-site__control", children: [_jsx("span", { children: "Sort" }), _jsxs("select", { name: "sort", defaultValue: sort, children: [_jsx("option", { value: "newest", children: "Newest" }), _jsx("option", { value: "oldest", children: "Oldest" }), _jsx("option", { value: "title-asc", children: "Title A-Z" }), _jsx("option", { value: "title-desc", children: "Title Z-A" })] })] }), _jsxs("div", { className: "cedros-site__control-actions", children: [_jsx("button", { className: "cedros-site__nav-link", type: "submit", children: "Apply" }), _jsx("a", { className: "cedros-site__nav-link", href: basePath, children: "Clear" })] })] }));
+}
+function readingTime(minutes) {
+    if (!minutes) {
+        return "";
+    }
+    return `${minutes} min read`;
+}
+function renderPaywallOrContent({ paywall, bodyMarkdown, bodyHtml, allowUnsafeHtmlFallback }) {
+    const meteredUnlock = paywall?.remainingFreeReads !== undefined && paywall.remainingFreeReads > 0;
+    if (paywall && paywall.mode !== "free" && !paywall.unlocked && !meteredUnlock) {
+        const previewContent = paywall.mode === "preview" && bodyMarkdown
+            ? truncateToNParagraphs(bodyMarkdown, paywall.previewParagraphs ?? 3)
+            : undefined;
+        return (_jsx(ContentPaywall, { mode: paywall.mode, previewContent: previewContent, price: paywall.price, payClient: paywall.payClient, purchaseLabel: paywall.purchaseLabel, subscriptionLabel: paywall.subscriptionLabel }));
+    }
+    const content = (_jsx(MarkdownContent, { bodyMarkdown: bodyMarkdown, bodyHtml: bodyHtml, allowUnsafeHtmlFallback: allowUnsafeHtmlFallback }));
+    if (meteredUnlock && !paywall?.unlocked) {
+        const remaining = paywall.remainingFreeReads;
+        const label = remaining === 1 ? "1 free read remaining this month" : `${remaining} free reads remaining this month`;
+        return (_jsxs(_Fragment, { children: [content, _jsx("div", { className: "cedros-site__metered-banner", role: "status", children: label })] }));
+    }
+    return content;
+}
+function truncateToNParagraphs(markdown, n) {
+    return markdown.split(/\n\n+/).slice(0, n).join("\n\n");
+}

package/dist/site-templates/ContactPageTemplate.d.ts

@@ -0,0 +1,14 @@
+import type { SiteNavigationItem } from "./SiteLayout.js";
+export interface ContactDetail {
+    label: string;
+    value: string;
+    href?: string;
+}
+export interface ContactPageTemplateProps {
+    siteTitle: string;
+    navigation: SiteNavigationItem[];
+    title?: string;
+    description?: string;
+    details: ContactDetail[];
+}
+export declare function ContactPageTemplate({ siteTitle, navigation, title, description, details }: ContactPageTemplateProps): React.JSX.Element;

package/dist/site-templates/ContactPageTemplate.js

@@ -0,0 +1,5 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { SiteLayout } from "./SiteLayout.js";
+export function ContactPageTemplate({ siteTitle, navigation, title = "Contact", description = "", details }) {
+    return (_jsxs(SiteLayout, { siteTitle: siteTitle, navigation: navigation, children: [_jsxs("section", { className: "cedros-site__card", children: [_jsx("h1", { className: "cedros-site__title", children: title }), description && _jsx("p", { className: "cedros-site__subtitle", children: description })] }), _jsx("section", { style: { marginTop: "1rem", display: "grid", gap: "0.85rem" }, children: details.map((detail) => (_jsxs("article", { className: "cedros-site__card", children: [_jsx("h2", { style: { margin: 0, fontSize: "0.95rem" }, children: detail.label }), detail.href ? (_jsx("p", { className: "cedros-site__subtitle", style: { marginTop: "0.45rem" }, children: _jsx("a", { href: detail.href, children: detail.value }) })) : (_jsx("p", { className: "cedros-site__subtitle", style: { marginTop: "0.45rem" }, children: detail.value }))] }, detail.label))) })] }));
+}

package/dist/site-templates/DashboardOverviewTemplate.d.ts

@@ -0,0 +1,29 @@
+import { type DashboardNavItem } from "./DashboardShell.js";
+import type { SiteFooterLink } from "./SiteFooter.js";
+import type { SiteNavigationItem } from "./SiteLayout.js";
+export interface DashboardStat {
+    key: string;
+    label: string;
+    value: string;
+    trend?: string;
+}
+export interface DashboardPanel {
+    key: string;
+    title: string;
+    description: string;
+    href?: string;
+}
+export interface DashboardOverviewTemplateProps {
+    siteTitle: string;
+    topNavigation?: SiteNavigationItem[];
+    sideNavigation: DashboardNavItem[];
+    currentPath?: string;
+    pageTitle?: string;
+    pageSubtitle?: string;
+    userName?: string;
+    userEmail?: string;
+    stats?: DashboardStat[];
+    panels?: DashboardPanel[];
+    footerLinks?: SiteFooterLink[];
+}
+export declare function DashboardOverviewTemplate({ siteTitle, topNavigation, sideNavigation, currentPath, pageTitle, pageSubtitle, userName, userEmail, stats, panels, footerLinks }: DashboardOverviewTemplateProps): React.JSX.Element;

package/dist/site-templates/DashboardOverviewTemplate.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { DashboardShell } from "./DashboardShell.js";
+import { withActiveRouteState } from "./routing.js";
+export function DashboardOverviewTemplate({ siteTitle, topNavigation = [], sideNavigation, currentPath, pageTitle = "Dashboard", pageSubtitle = "Manage content, schemas, and site settings from one place.", userName, userEmail, stats = [], panels = [], footerLinks = [] }) {
+    const activeSideNavigation = currentPath
+        ? withActiveRouteState(sideNavigation, currentPath)
+        : sideNavigation;
+    return (_jsxs(DashboardShell, { siteTitle: siteTitle, topNavigation: topNavigation, sideNavigation: activeSideNavigation, pageTitle: pageTitle, pageSubtitle: pageSubtitle, currentPath: currentPath, userName: userName, userEmail: userEmail, footerLinks: footerLinks, children: [stats.length > 0 && (_jsx("section", { style: {
+                    display: "grid",
+                    gridTemplateColumns: "repeat(auto-fit, minmax(160px, 1fr))",
+                    gap: "0.75rem"
+                }, children: stats.map((stat) => (_jsxs("article", { className: "cedros-site__card", children: [_jsx("p", { style: { margin: 0, fontSize: "0.78rem", color: "var(--cds-muted)" }, children: stat.label }), _jsx("p", { style: { margin: "0.3rem 0 0", fontSize: "1.2rem", fontWeight: 600 }, children: stat.value }), stat.trend && (_jsx("p", { style: { margin: "0.3rem 0 0", fontSize: "0.75rem", color: "var(--cds-muted)" }, children: stat.trend }))] }, stat.key))) })), panels.length > 0 && (_jsx("section", { style: {
+                    display: "grid",
+                    gridTemplateColumns: "repeat(auto-fit, minmax(220px, 1fr))",
+                    gap: "0.75rem"
+                }, children: panels.map((panel) => (_jsxs("article", { className: "cedros-site__card", style: { display: "grid", gap: "0.45rem" }, children: [_jsx("h2", { style: { margin: 0, fontSize: "0.95rem" }, children: panel.title }), _jsx("p", { className: "cedros-site__subtitle", style: { margin: 0, fontSize: "0.8rem" }, children: panel.description }), panel.href && (_jsx("div", { children: _jsx("a", { className: "cedros-site__nav-link", href: panel.href, children: "Open" }) }))] }, panel.key))) }))] }));
+}

package/dist/site-templates/DashboardShell.d.ts

@@ -0,0 +1,28 @@
+import type { ReactNode } from "react";
+import { type SiteFooterLink } from "./SiteFooter.js";
+import type { SiteNavigationItem } from "./SiteLayout.js";
+export interface DashboardNavItem {
+    key: string;
+    label: string;
+    route: string;
+    description?: string;
+    isActive?: boolean;
+    badge?: string;
+}
+export interface DashboardShellProps {
+    siteTitle: string;
+    topNavigation?: SiteNavigationItem[];
+    sideNavigation: DashboardNavItem[];
+    pageTitle: string;
+    pageSubtitle?: string;
+    children: ReactNode;
+    brandHref?: string;
+    topRightSlot?: ReactNode;
+    pageActions?: ReactNode;
+    currentPath?: string;
+    userName?: string;
+    userEmail?: string;
+    footerNote?: string;
+    footerLinks?: SiteFooterLink[];
+}
+export declare function DashboardShell({ siteTitle, topNavigation, sideNavigation, pageTitle, pageSubtitle, children, brandHref, topRightSlot, pageActions, currentPath, userName, userEmail, footerNote, footerLinks }: DashboardShellProps): React.JSX.Element;

package/dist/site-templates/DashboardShell.js

@@ -0,0 +1,10 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { SiteFooter } from "./SiteFooter.js";
+import { TopNav } from "./TopNav.js";
+import { withActiveRouteState } from "./routing.js";
+export function DashboardShell({ siteTitle, topNavigation = [], sideNavigation, pageTitle, pageSubtitle, children, brandHref = "/", topRightSlot, pageActions, currentPath, userName, userEmail, footerNote = "Powered by cedros-data", footerLinks = [] }) {
+    const activeSideNavigation = currentPath
+        ? withActiveRouteState(sideNavigation, currentPath)
+        : sideNavigation;
+    return (_jsxs("div", { className: "cedros-site cedros-site-dashboard", children: [_jsx(TopNav, { siteTitle: siteTitle, navigation: topNavigation, brandHref: brandHref, rightSlot: topRightSlot, currentPath: currentPath }), _jsx("main", { className: "cedros-site__main", children: _jsxs("div", { className: "cedros-site__container cedros-site-dashboard__layout", children: [_jsxs("aside", { className: "cedros-site-dashboard__sidebar", "aria-label": "Dashboard sections", children: [(userName || userEmail) && (_jsxs("section", { className: "cedros-site__card cedros-site-dashboard__profile", children: [userName && _jsx("h2", { className: "cedros-site-dashboard__profile-name", children: userName }), userEmail && _jsx("p", { className: "cedros-site-dashboard__profile-email", children: userEmail })] })), _jsx("nav", { className: "cedros-site-dashboard__side-nav", "aria-label": "Dashboard navigation", children: activeSideNavigation.map((item) => (_jsxs("a", { href: item.route, className: `cedros-site-dashboard__side-link${item.isActive ? " cedros-site-dashboard__side-link--active" : ""}`, "aria-current": item.isActive ? "page" : undefined, children: [_jsx("span", { children: item.label }), item.badge && _jsx("span", { className: "cedros-site-dashboard__badge", children: item.badge }), item.description && (_jsx("small", { className: "cedros-site-dashboard__side-description", children: item.description }))] }, item.key))) })] }), _jsxs("section", { className: "cedros-site-dashboard__content", children: [_jsxs("header", { className: "cedros-site-dashboard__content-header", children: [_jsxs("div", { children: [_jsx("h1", { className: "cedros-site__title cedros-site-dashboard__title", children: pageTitle }), pageSubtitle && _jsx("p", { className: "cedros-site__subtitle", children: pageSubtitle })] }), pageActions && _jsx("div", { className: "cedros-site-dashboard__actions", children: pageActions })] }), _jsx("div", { className: "cedros-site-dashboard__panel", children: children })] })] }) }), _jsx(SiteFooter, { siteTitle: siteTitle, note: footerNote, links: footerLinks })] }));
+}

package/dist/site-templates/DocsSidebar.d.ts

@@ -0,0 +1,14 @@
+import type { DocsSidebarSection } from "./docsNavigation.js";
+export interface DocsSidebarProps {
+    title: string;
+    basePath: string;
+    searchQuery: string;
+    sections: DocsSidebarSection[];
+}
+/**
+ * Docs sidebar with collapsible sections and mobile drawer toggle.
+ *
+ * Desktop: always visible, sticky.
+ * Mobile: hidden behind a hamburger button; overlay closes on link click.
+ */
+export declare function DocsSidebar({ title, basePath, searchQuery, sections, }: DocsSidebarProps): React.JSX.Element;

package/dist/site-templates/DocsSidebar.js

@@ -0,0 +1,13 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useState } from "react";
+/**
+ * Docs sidebar with collapsible sections and mobile drawer toggle.
+ *
+ * Desktop: always visible, sticky.
+ * Mobile: hidden behind a hamburger button; overlay closes on link click.
+ */
+export function DocsSidebar({ title, basePath, searchQuery, sections, }) {
+    const [open, setOpen] = useState(false);
+    return (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", className: "cedros-site__sidebar-toggle", "aria-label": "Toggle sidebar", "aria-expanded": open, onClick: () => setOpen((prev) => !prev), children: title }), open && (_jsx("div", { className: "cedros-site__sidebar-overlay", onClick: () => setOpen(false), role: "presentation" })), _jsxs("aside", { className: `cedros-site__card cedros-site__docs-sidebar${open ? " cedros-site__docs-sidebar--open" : ""}`, children: [_jsx("h2", { className: "cedros-site__docs-sidebar-title", children: title }), _jsx("form", { method: "get", action: basePath, className: "cedros-site__docs-search", children: _jsxs("label", { className: "cedros-site__control", children: [_jsx("span", { children: "Search docs" }), _jsx("input", { type: "search", name: "q", defaultValue: searchQuery, placeholder: "Search docs..." })] }) }), _jsx("a", { href: basePath, className: "cedros-site__docs-root-link", children: "Browse all docs" }), sections.length === 0 && (_jsx("p", { className: "cedros-site__entry-meta", children: "No sections available yet." })), sections.map((section) => (_jsxs("details", { className: "cedros-site__docs-section", open: section.collapsed !== true, children: [_jsx("summary", { className: "cedros-site__docs-section-title", children: section.label }), _jsx("nav", { className: "cedros-site__docs-section-links", "aria-label": section.label, children: section.items.map((item) => (_jsxs("a", { href: item.href, className: `cedros-site__docs-item cedros-site__docs-item--depth-${item.depth ?? 0}${item.isActive ? " cedros-site__docs-item--active" : ""}`, "aria-current": item.isActive ? "page" : undefined, onClick: () => setOpen(false), children: [_jsx("span", { children: item.label }), item.badge && (_jsx("span", { className: "cedros-site__docs-item-badge", children: item.badge }))] }, item.key))) })] }, section.key)))] })] }));
+}