@gaulatti/giorgia 0.1.57

package/dist/outlet-config.d.ts

@@ -0,0 +1,29 @@
+export declare const outletConfig: {
+    readonly siteName: "fifthbell";
+    readonly publicSiteUrl: "https://fifthbell.com";
+    readonly cdnUrl: "https://cdn.fifthbell.com";
+    readonly contentPath: "/content";
+    readonly inventoryFilename: "cronkite-inventory.json";
+    readonly defaultLanguage: "en";
+    readonly supportedLanguages: readonly ["en", "es", "it"];
+    readonly prefixDefaultLocale: false;
+    readonly defaultAuthor: {
+        readonly name: "Fifthbell Newsroom";
+        readonly slug: "fifthbell-newsroom";
+    };
+    readonly defaultCategory: {
+        readonly name: "Top Stories";
+        readonly slug: "top-stories";
+    };
+    readonly linkInBioRoute: "/instagram";
+    readonly searchTitle: "Search";
+    readonly searchDescriptions: {
+        readonly en: "Search stories from Fifthbell.";
+        readonly es: "Busca noticias de Fifthbell.";
+        readonly it: "Cerca notizie Fifthbell.";
+    };
+    readonly socialLanguages: readonly ["en"];
+    readonly socialUserAgent: "Cronkite/1.0";
+    readonly socialImageExport: "buildInstagramImageHtml";
+    readonly hashtagServiceBaseUrl: "http://192.168.0.99:8000";
+};

package/dist/outlet-config.js

@@ -0,0 +1,29 @@
+export const outletConfig = {
+    siteName: 'fifthbell',
+    publicSiteUrl: 'https://fifthbell.com',
+    cdnUrl: 'https://cdn.fifthbell.com',
+    contentPath: '/content',
+    inventoryFilename: 'cronkite-inventory.json',
+    defaultLanguage: 'en',
+    supportedLanguages: ['en', 'es', 'it'],
+    prefixDefaultLocale: false,
+    defaultAuthor: {
+        name: 'Fifthbell Newsroom',
+        slug: 'fifthbell-newsroom'
+    },
+    defaultCategory: {
+        name: 'Top Stories',
+        slug: 'top-stories'
+    },
+    linkInBioRoute: '/instagram',
+    searchTitle: 'Search',
+    searchDescriptions: {
+        en: 'Search stories from Fifthbell.',
+        es: 'Busca noticias de Fifthbell.',
+        it: 'Cerca notizie Fifthbell.'
+    },
+    socialLanguages: ['en'],
+    socialUserAgent: 'Cronkite/1.0',
+    socialImageExport: 'buildInstagramImageHtml',
+    hashtagServiceBaseUrl: 'http://192.168.0.99:8000'
+};

package/dist/renderer.browser.d.ts

@@ -0,0 +1,2 @@
+import type { CanonicalDocument } from './types/canonical-article.js';
+export declare function render(document: CanonicalDocument): string;

package/dist/renderer.browser.js

@@ -0,0 +1,132 @@
+import articleLayoutHbs from './templates/layouts/article-page.hbs?raw';
+import homepageLayoutHbs from './templates/layouts/homepage.hbs?raw';
+import categoryLayoutHbs from './templates/layouts/category-page.hbs?raw';
+import searchLayoutHbs from './templates/layouts/search-page.hbs?raw';
+import notFoundLayoutHbs from './templates/layouts/404.hbs?raw';
+import liveStoryLayoutHbs from './templates/layouts/live-story.hbs?raw';
+import linkInBioLayoutHbs from './templates/layouts/link-in-bio.hbs?raw';
+import mediaPageLayoutHbs from './templates/layouts/media-page.hbs?raw';
+import headerMainHbs from './templates/partials/headers/header-main.hbs?raw';
+import headerMinimalHbs from './templates/partials/headers/header-minimal.hbs?raw';
+import footerFullHbs from './templates/partials/footers/footer-full.hbs?raw';
+import footerMinimalHbs from './templates/partials/footers/footer-minimal.hbs?raw';
+import navCategoriesHbs from './templates/partials/nav/nav-categories.hbs?raw';
+import shellDocStartStandardHbs from './templates/partials/shell/doc-start-standard.hbs?raw';
+import shellDocStart404Hbs from './templates/partials/shell/doc-start-404.hbs?raw';
+import shellDocEndHbs from './templates/partials/shell/doc-end.hbs?raw';
+import blockRichTextHbs from './templates/partials/blocks/rich-text.hbs?raw';
+import blockHeadingHbs from './templates/partials/blocks/heading.hbs?raw';
+import blockImageHbs from './templates/partials/blocks/image.hbs?raw';
+import blockListHbs from './templates/partials/blocks/list.hbs?raw';
+import blockDividerHbs from './templates/partials/blocks/divider.hbs?raw';
+import blockInfoBoxHbs from './templates/partials/blocks/info-box.hbs?raw';
+import blockKeyPointsHbs from './templates/partials/blocks/key-points.hbs?raw';
+import blockDataTableHbs from './templates/partials/blocks/data-table.hbs?raw';
+import blockLiveUpdateHbs from './templates/partials/blocks/live-update.hbs?raw';
+import blockAudioHbs from './templates/partials/blocks/audio.hbs?raw';
+import blockYoutubeHbs from './templates/partials/blocks/youtube.hbs?raw';
+import blockXHbs from './templates/partials/blocks/x.hbs?raw';
+import blockInstagramHbs from './templates/partials/blocks/instagram.hbs?raw';
+import blockTikTokHbs from './templates/partials/blocks/tiktok.hbs?raw';
+import blockPullQuoteHbs from './templates/partials/blocks/pull-quote.hbs?raw';
+import componentArticleMainHbs from './templates/partials/components/article-main.hbs?raw';
+import componentBreakingNewsHbs from './templates/partials/components/breaking-news.hbs?raw';
+import componentBreakingNewsLiveUpdatesColumnHbs from './templates/partials/components/breaking-news/live-updates-column.hbs?raw';
+import componentSnackHbs from './templates/partials/components/snack.hbs?raw';
+import componentHeadlineHbs from './templates/partials/components/headline.hbs?raw';
+import componentHeroHbs from './templates/partials/components/hero.hbs?raw';
+import componentHeroEditorialHbs from './templates/partials/components/hero-editorial.hbs?raw';
+import componentSpotlightHeroHbs from './templates/partials/components/spotlight-hero.hbs?raw';
+import componentEditorialHeroHbs from './templates/partials/components/editorial-hero.hbs?raw';
+import componentTrendingHbs from './templates/partials/components/trending.hbs?raw';
+import componentHomeMainHbs from './templates/partials/components/home/main.hbs?raw';
+import componentHomeLandingHbs from './templates/partials/components/home/landing.hbs?raw';
+import componentHomeMustReadHbs from './templates/partials/components/home/must-read.hbs?raw';
+import componentHomeMoreStoriesHbs from './templates/partials/components/home/more-stories.hbs?raw';
+import componentCategoryMainHbs from './templates/partials/components/category/main.hbs?raw';
+import componentCategoryHeaderHbs from './templates/partials/components/category/header.hbs?raw';
+import componentCategoryMainGridHbs from './templates/partials/components/category/main-grid.hbs?raw';
+import componentCategoryMoreGridHbs from './templates/partials/components/category/more-grid.hbs?raw';
+import componentSearchMainHbs from './templates/partials/components/search/main.hbs?raw';
+import componentNotFoundMainHbs from './templates/partials/components/not-found/main.hbs?raw';
+import componentLiveStoryMainHbs from './templates/partials/components/live-story/main.hbs?raw';
+import componentMediaMainHbs from './templates/partials/components/media/main.hbs?raw';
+import componentUiAccordionHbs from './templates/partials/components/ui/accordion.hbs?raw';
+import componentUiBreadcrumbHbs from './templates/partials/components/ui/breadcrumb.hbs?raw';
+import componentUiIconButtonHbs from './templates/partials/components/ui/icon-button.hbs?raw';
+import componentUiLoadingSpinnerHbs from './templates/partials/components/ui/loading-spinner.hbs?raw';
+import componentUiPaginationHbs from './templates/partials/components/ui/pagination.hbs?raw';
+import componentUiScrollAreaHbs from './templates/partials/components/ui/scroll-area.hbs?raw';
+import componentUiStatusBadgeHbs from './templates/partials/components/ui/status-badge.hbs?raw';
+import styles from './styles/compiled.css?raw';
+import { renderWithAssets } from './renderer.core.js';
+const assets = {
+    layouts: {
+        'article-page': articleLayoutHbs,
+        homepage: homepageLayoutHbs,
+        'category-page': categoryLayoutHbs,
+        'search-page': searchLayoutHbs,
+        '404': notFoundLayoutHbs,
+        'live-story': liveStoryLayoutHbs,
+        'link-in-bio': linkInBioLayoutHbs,
+        'media-page': mediaPageLayoutHbs
+    },
+    partials: {
+        'headers/header-main': headerMainHbs,
+        'headers/header-minimal': headerMinimalHbs,
+        'footers/footer-full': footerFullHbs,
+        'footers/footer-minimal': footerMinimalHbs,
+        'nav/nav-categories': navCategoriesHbs,
+        'shell/doc-start-standard': shellDocStartStandardHbs,
+        'shell/doc-start-404': shellDocStart404Hbs,
+        'shell/doc-end': shellDocEndHbs,
+        'blocks/rich-text': blockRichTextHbs,
+        'blocks/heading': blockHeadingHbs,
+        'blocks/image': blockImageHbs,
+        'blocks/list': blockListHbs,
+        'blocks/divider': blockDividerHbs,
+        'blocks/info-box': blockInfoBoxHbs,
+        'blocks/key-points': blockKeyPointsHbs,
+        'blocks/data-table': blockDataTableHbs,
+        'blocks/live-update': blockLiveUpdateHbs,
+        'blocks/audio': blockAudioHbs,
+        'blocks/youtube': blockYoutubeHbs,
+        'blocks/x': blockXHbs,
+        'blocks/instagram': blockInstagramHbs,
+        'blocks/tiktok': blockTikTokHbs,
+        'blocks/pull-quote': blockPullQuoteHbs,
+        'components/article-main': componentArticleMainHbs,
+        'components/breaking-news': componentBreakingNewsHbs,
+        'components/breaking-news/live-updates-column': componentBreakingNewsLiveUpdatesColumnHbs,
+        'components/snack': componentSnackHbs,
+        'components/headline': componentHeadlineHbs,
+        'components/spotlight-hero': componentSpotlightHeroHbs,
+        'components/editorial-hero': componentEditorialHeroHbs,
+        'components/hero': componentHeroHbs,
+        'components/hero-editorial': componentHeroEditorialHbs,
+        'components/trending': componentTrendingHbs,
+        'components/home/main': componentHomeMainHbs,
+        'components/home/landing': componentHomeLandingHbs,
+        'components/home/must-read': componentHomeMustReadHbs,
+        'components/home/more-stories': componentHomeMoreStoriesHbs,
+        'components/category/main': componentCategoryMainHbs,
+        'components/category/header': componentCategoryHeaderHbs,
+        'components/category/main-grid': componentCategoryMainGridHbs,
+        'components/category/more-grid': componentCategoryMoreGridHbs,
+        'components/search/main': componentSearchMainHbs,
+        'components/not-found/main': componentNotFoundMainHbs,
+        'components/live-story/main': componentLiveStoryMainHbs,
+        'components/media/main': componentMediaMainHbs,
+        'components/ui/accordion': componentUiAccordionHbs,
+        'components/ui/breadcrumb': componentUiBreadcrumbHbs,
+        'components/ui/icon-button': componentUiIconButtonHbs,
+        'components/ui/loading-spinner': componentUiLoadingSpinnerHbs,
+        'components/ui/pagination': componentUiPaginationHbs,
+        'components/ui/scroll-area': componentUiScrollAreaHbs,
+        'components/ui/status-badge': componentUiStatusBadgeHbs
+    },
+    styles
+};
+export function render(document) {
+    return renderWithAssets(document, assets);
+}

package/dist/renderer.core.d.ts

@@ -0,0 +1,9 @@
+import { type CanonicalDocument } from './types/canonical-article.js';
+export type LayoutName = CanonicalDocument['layout'];
+export type RendererAssets = {
+    layouts: Record<LayoutName, string>;
+    partials: Record<string, string>;
+    styles: string;
+};
+export declare function initializeHandlebars(assets: RendererAssets): void;
+export declare function renderWithAssets(doc: CanonicalDocument, assets: RendererAssets): string;

package/dist/renderer.core.js

@@ -0,0 +1,354 @@
+import Handlebars from 'handlebars';
+import { canonicalArticleSchema } from './types/canonical-article.js';
+import { distributeHomepageArticles } from './homepage-distributor.js';
+import { buildSofascoreAttackMomentumUrl, buildSofascoreMatchUrl } from './utils/sofascore.js';
+let initialized = false;
+const layoutCache = new Map();
+let runtimeStyles = '';
+const removedBlockTypes = new Set(['truthSocial', 'truthsocial', 'truth-social', 'truth_social']);
+const siteTitlesByLanguage = {
+    en: 'fifthbell - Breaking News & Current Events',
+    es: 'fifthbell - Noticias de última hora y actualidad',
+    it: 'fifthbell - Ultime notizie e attualità'
+};
+function normalizePathInput(value) {
+    if (typeof value !== 'string')
+        return '';
+    const trimmed = value.trim();
+    if (!trimmed)
+        return '';
+    try {
+        if (/^https?:\/\//i.test(trimmed)) {
+            const parsed = new URL(trimmed);
+            const normalizedAbsolute = `/${(parsed.pathname || '').replace(/^\/+/, '')}`.replace(/\/{2,}/g, '/');
+            if (normalizedAbsolute !== '/' && normalizedAbsolute.endsWith('/')) {
+                return normalizedAbsolute.slice(0, -1);
+            }
+            return normalizedAbsolute || '/';
+        }
+    }
+    catch {
+        // Fall back to raw string normalization below.
+    }
+    const withoutQueryOrHash = trimmed.split('#')[0].split('?')[0];
+    const normalized = `/${withoutQueryOrHash.replace(/^\/+/, '')}`.replace(/\/{2,}/g, '/');
+    if (normalized !== '/' && normalized.endsWith('/')) {
+        return normalized.slice(0, -1);
+    }
+    return normalized;
+}
+function cleanPathSegment(value) {
+    if (typeof value !== 'string')
+        return '';
+    return value.trim().replace(/^\/+|\/+$/g, '');
+}
+function buildLocalePath(path, language) {
+    const normalizedLanguage = language === 'es' || language === 'it' ? language : 'en';
+    if (!path)
+        return normalizedLanguage === 'en' ? '/' : `/${normalizedLanguage}`;
+    const normalized = String(path).startsWith('/') ? String(path) : `/${path}`;
+    if (normalized.startsWith('/es/') || normalized.startsWith('/it/')) {
+        return normalized;
+    }
+    if (normalizedLanguage === 'en') {
+        return normalized;
+    }
+    return `/${normalizedLanguage}${normalized}`;
+}
+function resolveArticleUrl(input) {
+    const explicitUrl = normalizePathInput(input.url);
+    if (explicitUrl && explicitUrl !== '/') {
+        return buildLocalePath(explicitUrl, input.language);
+    }
+    const canonicalUrl = normalizePathInput(input.canonicalUrl);
+    if (canonicalUrl && canonicalUrl !== '/') {
+        return buildLocalePath(canonicalUrl, input.language);
+    }
+    const slugRaw = typeof input.slug === 'string' ? input.slug : '';
+    const normalizedSlugPath = normalizePathInput(slugRaw);
+    const slugSegments = normalizedSlugPath.split('/').filter(Boolean);
+    if (slugSegments.length > 1) {
+        return buildLocalePath(normalizedSlugPath, input.language);
+    }
+    const slugSegment = cleanPathSegment(slugRaw);
+    const categories = Array.isArray(input.categories) ? input.categories : [];
+    const primaryCategorySlug = cleanPathSegment(categories[0]?.slug) || cleanPathSegment(input.category?.slug);
+    if (slugSegment && primaryCategorySlug) {
+        return buildLocalePath(`/${primaryCategorySlug}/${slugSegment}`, input.language);
+    }
+    if (slugSegment) {
+        return buildLocalePath(`/${slugSegment}`, input.language);
+    }
+    return buildLocalePath('/', input.language);
+}
+function normalizeDocument(doc) {
+    const rawBody = doc.body;
+    if (!Array.isArray(rawBody))
+        return doc;
+    return {
+        ...doc,
+        body: rawBody.filter((block) => {
+            if (!block || typeof block !== 'object')
+                return true;
+            const type = block.type;
+            return typeof type !== 'string' || !removedBlockTypes.has(type);
+        })
+    };
+}
+function registerHelpers() {
+    Handlebars.registerHelper('eq', (a, b) => a === b);
+    Handlebars.registerHelper('add', (a, b) => Number(a) + Number(b));
+    Handlebars.registerHelper('slice', (items, start, end) => {
+        if (!Array.isArray(items))
+            return [];
+        return items.slice(start, end);
+    });
+    Handlebars.registerHelper('uppercase', (value) => String(value ?? '').toUpperCase());
+    Handlebars.registerHelper('coalesce', (...args) => {
+        const values = args.slice(0, -1);
+        for (const value of values) {
+            if (value === null || value === undefined)
+                continue;
+            if (typeof value === 'string' && value.trim().length === 0)
+                continue;
+            if (Array.isArray(value) && value.length === 0)
+                continue;
+            return value;
+        }
+        return '';
+    });
+    Handlebars.registerHelper('articleUrl', (...args) => {
+        const options = args[args.length - 1];
+        const hash = options?.hash;
+        const root = options?.data?.root;
+        return resolveArticleUrl({
+            url: hash?.url,
+            canonicalUrl: hash?.canonicalUrl,
+            slug: hash?.slug,
+            categories: hash?.categories,
+            category: hash?.category,
+            language: hash?.language ?? root?.language
+        });
+    });
+    Handlebars.registerHelper('formatDate', (isoString) => {
+        if (!isoString)
+            return '';
+        try {
+            const date = new Date(isoString);
+            const now = new Date();
+            const isWithin24h = now.getTime() - date.getTime() < 24 * 60 * 60 * 1000;
+            if (isWithin24h) {
+                return date.toLocaleTimeString('en-US', {
+                    hour: 'numeric',
+                    minute: '2-digit',
+                    hour12: true,
+                    timeZone: 'America/New_York'
+                });
+            }
+            else {
+                return date.toLocaleDateString('en-US', {
+                    year: 'numeric',
+                    month: 'long',
+                    day: 'numeric',
+                    timeZone: 'America/New_York'
+                });
+            }
+        }
+        catch {
+            return isoString;
+        }
+    });
+    Handlebars.registerHelper('xStatusUrl', (url) => {
+        if (!url)
+            return '';
+        try {
+            const parsed = new URL(url);
+            if (parsed.hostname === 'x.com' || parsed.hostname === 'www.x.com') {
+                return `https://twitter.com${parsed.pathname}`;
+            }
+            return url;
+        }
+        catch {
+            return url;
+        }
+    });
+    Handlebars.registerHelper('xEmbedUrl', (url) => {
+        if (!url)
+            return '';
+        const buildEmbedUrl = (tweetId) => `https://platform.twitter.com/embed/Tweet.html?id=${tweetId}&dnt=true`;
+        const idFromRaw = url.match(/status\/(\d+)/)?.[1];
+        try {
+            const parsed = new URL(url);
+            const host = parsed.hostname.replace(/^www\./, '');
+            if (host === 'x.com' || host === 'twitter.com') {
+                const tweetId = parsed.pathname.match(/\/[^/]+\/status\/(\d+)/)?.[1];
+                if (tweetId)
+                    return buildEmbedUrl(tweetId);
+            }
+            return idFromRaw ? buildEmbedUrl(idFromRaw) : '';
+        }
+        catch {
+            return idFromRaw ? buildEmbedUrl(idFromRaw) : '';
+        }
+    });
+    Handlebars.registerHelper('xTweetId', (url) => {
+        if (!url)
+            return '';
+        const idFromRaw = url.match(/status\/(\d+)/)?.[1];
+        if (idFromRaw)
+            return idFromRaw;
+        try {
+            const parsed = new URL(url);
+            const host = parsed.hostname.replace(/^www\./, '');
+            if (host === 'x.com' || host === 'twitter.com') {
+                return parsed.pathname.match(/\/[^/]+\/status\/(\d+)/)?.[1] ?? '';
+            }
+            return '';
+        }
+        catch {
+            return '';
+        }
+    });
+    Handlebars.registerHelper('instagramEmbedUrl', (url) => {
+        if (!url)
+            return '';
+        const normalized = url.endsWith('/') ? url : `${url}/`;
+        return `${normalized}embed/`;
+    });
+    Handlebars.registerHelper('tiktokEmbedUrl', (url) => {
+        if (!url)
+            return '';
+        const match = url.match(/\/video\/(\d+)/);
+        if (!match)
+            return url;
+        return `https://www.tiktok.com/embed/v2/${match[1]}`;
+    });
+    Handlebars.registerHelper('sofascoreWidgetUrl', (id) => buildSofascoreAttackMomentumUrl(id));
+    Handlebars.registerHelper('sofascoreMatchUrl', (id) => buildSofascoreMatchUrl(id));
+    Handlebars.registerHelper('jsonString', (value) => {
+        if (value === undefined)
+            return 'null';
+        return JSON.stringify(value);
+    });
+    Handlebars.registerHelper('resolveHeadTitle', (doc) => {
+        if (!doc || typeof doc !== 'object')
+            return 'fifthbell';
+        const page = doc;
+        if (page.layout === 'homepage') {
+            const language = page.language === 'es' || page.language === 'it' ? page.language : 'en';
+            return siteTitlesByLanguage[language];
+        }
+        if (page.layout === 'category-page') {
+            const categoryName = page.categories?.[0]?.name?.trim();
+            const baseTitle = categoryName || page.title?.trim() || 'Category';
+            return `${baseTitle} | fifthbell`;
+        }
+        if (page.layout === 'search-page') {
+            return 'Search | fifthbell';
+        }
+        if (page.layout === 'article-page') {
+            const baseTitle = page.title?.trim() || 'Article';
+            return `${baseTitle} | fifthbell`;
+        }
+        if (page.layout === '404') {
+            return '404 - Page Not Found | fifthbell';
+        }
+        if (page.layout === 'live-story') {
+            const baseTitle = page.title?.trim() || 'Live Story';
+            return `${baseTitle} | fifthbell`;
+        }
+        if (page.layout === 'link-in-bio') {
+            const baseTitle = page.title?.trim() || 'Top Stories';
+            return `${baseTitle} | fifthbell`;
+        }
+        const seoTitle = page.seo?.metaTitle?.trim();
+        if (seoTitle)
+            return seoTitle;
+        const baseTitle = page.title?.trim() || 'fifthbell';
+        return `${baseTitle} | fifthbell`;
+    });
+    Handlebars.registerHelper('socialImageUrl', (value) => {
+        if (typeof value !== 'string')
+            return '';
+        const raw = value.trim();
+        if (!raw)
+            return '';
+        const normalizePath = (pathname) => pathname.replace(/\.avif$/i, '.jpg');
+        try {
+            const parsed = new URL(raw);
+            parsed.pathname = normalizePath(parsed.pathname);
+            return parsed.toString();
+        }
+        catch {
+            // Support relative URLs in template data.
+            return normalizePath(raw);
+        }
+    });
+}
+function registerPartials(partials) {
+    for (const [name, template] of Object.entries(partials)) {
+        Handlebars.registerPartial(name, template);
+    }
+    const bodyAliases = {
+        richText: 'blocks/rich-text',
+        heading: 'blocks/heading',
+        image: 'blocks/image',
+        list: 'blocks/list',
+        divider: 'blocks/divider',
+        infoBox: 'blocks/info-box',
+        keyPoints: 'blocks/key-points',
+        dataTable: 'blocks/data-table',
+        liveUpdate: 'blocks/live-update',
+        audio: 'blocks/audio',
+        youtube: 'blocks/youtube',
+        x: 'blocks/x',
+        instagram: 'blocks/instagram',
+        tiktok: 'blocks/tiktok',
+        pullQuote: 'blocks/pull-quote'
+    };
+    for (const [alias, partialName] of Object.entries(bodyAliases)) {
+        const source = partials[partialName];
+        if (source) {
+            Handlebars.registerPartial(alias, source);
+        }
+    }
+}
+function compileLayouts(layouts) {
+    for (const [name, source] of Object.entries(layouts)) {
+        layoutCache.set(name, Handlebars.compile(source));
+    }
+}
+export function initializeHandlebars(assets) {
+    if (initialized)
+        return;
+    registerHelpers();
+    registerPartials(assets.partials);
+    compileLayouts(assets.layouts);
+    runtimeStyles = assets.styles;
+    initialized = true;
+}
+export function renderWithAssets(doc, assets) {
+    if (!initialized) {
+        initializeHandlebars(assets);
+    }
+    const requestedLayout = doc.layout;
+    if (!requestedLayout || !layoutCache.has(requestedLayout)) {
+        throw new Error(`Unknown layout "${requestedLayout ?? 'undefined'}". Expected one of: article-page, homepage, category-page, search-page, 404, live-story, link-in-bio, media-page`);
+    }
+    const parsed = canonicalArticleSchema.parse(normalizeDocument(doc));
+    const template = layoutCache.get(parsed.layout);
+    if (!template) {
+        throw new Error(`Layout template missing for \"${parsed.layout}\"`);
+    }
+    // Build the template context, enriching homepage renders with pre-distributed
+    // article slots so templates do not need to perform index arithmetic.
+    const docExtra = doc;
+    const showBreakingNews = parsed.layout === 'homepage' && Boolean(parsed.breakingNews) && docExtra['showBreakingNews'] !== false;
+    const homepageSlots = parsed.layout === 'homepage' ? distributeHomepageArticles(parsed.articles ?? [], new Date(), showBreakingNews) : undefined;
+    return template({
+        ...parsed,
+        ...(homepageSlots !== undefined ? { homepageSlots } : {}),
+        styles: runtimeStyles,
+        logoLink: parsed.language === 'en' ? '/' : `/${parsed.language}`
+    });
+}

package/dist/renderer.d.ts

@@ -0,0 +1,6 @@
+export { render, liveProgramPageHtml, liveProgramPageAsset, liveProgramPageFiles, fontFiles } from './renderer.node.js';
+export type { LiveProgramFileEntry, FontFileEntry } from './renderer.node.js';
+export { buildInstagramImageHtml, registerInstagramImageHelpers, type InstagramImageTemplateParams } from './instagram-image-template.js';
+export { outletConfig } from './outlet-config.js';
+export { version } from './version.js';
+export type { CanonicalDocument } from './types/canonical-article.js';

package/dist/renderer.js

@@ -0,0 +1,4 @@
+export { render, liveProgramPageHtml, liveProgramPageAsset, liveProgramPageFiles, fontFiles } from './renderer.node.js';
+export { buildInstagramImageHtml, registerInstagramImageHelpers } from './instagram-image-template.js';
+export { outletConfig } from './outlet-config.js';
+export { version } from './version.js';

package/dist/renderer.node.d.ts

@@ -0,0 +1,16 @@
+import type { CanonicalDocument } from './types/canonical-article.js';
+export declare function render(document: CanonicalDocument): string;
+export declare function liveProgramPageHtml(): string;
+export type FontFileEntry = {
+    key: string;
+    body: Buffer;
+    contentType: string;
+};
+export declare function fontFiles(): FontFileEntry[];
+export declare function liveProgramPageAsset(filename: string): string;
+export type LiveProgramFileEntry = {
+    key: string;
+    body: Buffer;
+    contentType: string;
+};
+export declare function liveProgramPageFiles(): LiveProgramFileEntry[];