@stackbox/cms 0.0.4 → 0.1.0

package/dist/plugins/sitemap/index.js

@@ -0,0 +1,119 @@
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createPlugin, } from "../../plugin.js";
+import { normalizePathname } from "../../routing.js";
+function resolveBaseUrl(site, options) {
+    const raw = options.baseUrl ?? site.siteConfig.config.url;
+    if (typeof raw !== "string" || raw.trim().length === 0) {
+        throw new Error("sb-sitemap: baseUrl or siteConfig.url is required");
+    }
+    const url = raw.trim().replace(/\/+$/, "");
+    try {
+        new URL(url);
+    }
+    catch {
+        throw new Error(`sb-sitemap: invalid base URL "${raw}"`);
+    }
+    return url;
+}
+function isExcluded(path, options) {
+    const normalized = normalizePathname(path);
+    if (!options.exclude) {
+        return false;
+    }
+    if (typeof options.exclude === "function") {
+        return options.exclude(normalized);
+    }
+    return options.exclude.some((entry) => normalizePathname(entry) === normalized);
+}
+function isNoindexPage(page) {
+    const robots = page.meta?.robots?.toLowerCase() ?? "";
+    return robots.includes("noindex");
+}
+export function collectSitemapUrls(site, options = {}) {
+    const base = resolveBaseUrl(site, options);
+    const locs = new Set();
+    for (const page of site.pages) {
+        if (isNoindexPage(page)) {
+            continue;
+        }
+        if (isExcluded(page.path, options)) {
+            continue;
+        }
+        locs.add(`${base}${normalizePathname(page.path)}`);
+    }
+    for (const extra of options.extraUrls ?? []) {
+        if (extra.startsWith("http://") || extra.startsWith("https://")) {
+            if (!isExcluded(extra, options)) {
+                locs.add(extra);
+            }
+            continue;
+        }
+        const path = normalizePathname(extra);
+        if (!isExcluded(path, options)) {
+            locs.add(`${base}${path}`);
+        }
+    }
+    return [...locs].sort();
+}
+function escapeXml(text) {
+    return text
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+export function renderSitemapXml(site, options = {}) {
+    const urls = collectSitemapUrls(site, options);
+    const body = urls
+        .map((loc) => `  <url>\n    <loc>${escapeXml(loc)}</loc>\n  </url>`)
+        .join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${body}\n</urlset>\n`;
+}
+function sitemapResponse(request, xml) {
+    const headers = { "content-type": "application/xml; charset=utf-8" };
+    if (request.method === "HEAD") {
+        const bytes = new TextEncoder().encode(xml);
+        return new globalThis.Response(null, {
+            status: 200,
+            headers: { ...headers, "content-length": String(bytes.byteLength) },
+        });
+    }
+    return new globalThis.Response(xml, { status: 200, headers });
+}
+function createSitemapRoutes(ctx, options) {
+    return [
+        {
+            path: "/sitemap.xml",
+            fetch(request) {
+                const xml = renderSitemapXml(ctx.site, options);
+                return sitemapResponse(request, xml);
+            },
+        },
+    ];
+}
+export function createSitemap(options = {}) {
+    return createPlugin({
+        name: "sb-sitemap",
+        description: "Generate sitemap.xml from site pages for search engines and static deploys.",
+        version: "1.0.0",
+        keywords: [
+            "sitemap",
+            "sitemap.xml",
+            "seo",
+            "search engines",
+            "xml sitemap",
+        ],
+        root: import.meta.dirname,
+        routes(ctx) {
+            return createSitemapRoutes(ctx, options);
+        },
+        build(ctx) {
+            const xml = renderSitemapXml(ctx.site, options);
+            writeFileSync(join(ctx.publicDir, "sitemap.xml"), xml, "utf8");
+        },
+    });
+}
+export default createSitemap();
+//# sourceMappingURL=index.js.map

package/dist/plugins/sitemap/index.js.map

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

package/dist/render-head.d.ts

@@ -0,0 +1,7 @@
+import { type HSHtml } from "@hyperspan/html";
+import type { Stackbox as SB } from "./types.js";
+export declare function renderStandardHead(input: {
+    title: string;
+    meta?: SB.PageMeta;
+}): HSHtml;
+//# sourceMappingURL=render-head.d.ts.map

package/dist/render-head.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-head.d.ts","sourceRoot":"","sources":["../src/render-head.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,YAAY,CAAC;AAEjD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC;CACpB,GAAG,MAAM,CAyBT"}

package/dist/render-head.js

@@ -0,0 +1,27 @@
+import { html } from "@hyperspan/html";
+export function renderStandardHead(input) {
+    const { title, meta = {} } = input;
+    const ogTitle = meta.ogTitle ?? title;
+    const ogDescription = meta.ogDescription ?? meta.description;
+    return html `<meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${title}</title>
+  ${meta.description
+        ? html `<meta name="description" content="${meta.description}">`
+        : ""}
+  ${meta.robots ? html `<meta name="robots" content="${meta.robots}">` : ""}
+  ${meta.canonical
+        ? html `<link rel="canonical" href="${meta.canonical}">`
+        : ""}
+  <meta property="og:title" content="${ogTitle}">
+  ${ogDescription
+        ? html `<meta property="og:description" content="${ogDescription}">`
+        : ""}
+  ${meta.ogImage
+        ? html `<meta property="og:image" content="${meta.ogImage}">`
+        : ""}
+  ${meta.twitterCard
+        ? html `<meta name="twitter:card" content="${meta.twitterCard}">`
+        : ""}`;
+}
+//# sourceMappingURL=render-head.js.map

package/dist/render-head.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-head.js","sourceRoot":"","sources":["../src/render-head.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAe,MAAM,iBAAiB,CAAC;AAGpD,MAAM,UAAU,kBAAkB,CAAC,KAGlC;IACC,MAAM,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,KAAK,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;IACtC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,WAAW,CAAC;IAE7D,OAAO,IAAI,CAAA;;WAEF,KAAK;IACZ,IAAI,CAAC,WAAW;QAChB,CAAC,CAAC,IAAI,CAAA,qCAAqC,IAAI,CAAC,WAAW,IAAI;QAC/D,CAAC,CAAC,EAAE;IACJ,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAA,gCAAgC,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE;IACtE,IAAI,CAAC,SAAS;QACd,CAAC,CAAC,IAAI,CAAA,+BAA+B,IAAI,CAAC,SAAS,IAAI;QACvD,CAAC,CAAC,EAAE;uCAC+B,OAAO;IAC1C,aAAa;QACb,CAAC,CAAC,IAAI,CAAA,4CAA4C,aAAa,IAAI;QACnE,CAAC,CAAC,EAAE;IACJ,IAAI,CAAC,OAAO;QACZ,CAAC,CAAC,IAAI,CAAA,sCAAsC,IAAI,CAAC,OAAO,IAAI;QAC5D,CAAC,CAAC,EAAE;IACJ,IAAI,CAAC,WAAW;QAChB,CAAC,CAAC,IAAI,CAAA,sCAAsC,IAAI,CAAC,WAAW,IAAI;QAChE,CAAC,CAAC,EAAE,EAAE,CAAC;AACX,CAAC"}

package/dist/render-page.d.ts

@@ -0,0 +1,4 @@
+import type { Stackbox as SB } from "./types.js";
+export { RenderError } from "./slot-handle.js";
+export declare function renderPage(page: SB.SitePage, siteConfig: SB.SiteConfig, ctx?: SB.Context, hooks?: SB.SiteHooks): Promise<string>;
+//# sourceMappingURL=render-page.d.ts.map

package/dist/render-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-page.d.ts","sourceRoot":"","sources":["../src/render-page.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,YAAY,CAAC;AAEjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAa/C,wBAAsB,UAAU,CAC9B,IAAI,EAAE,EAAE,CAAC,QAAQ,EACjB,UAAU,EAAE,EAAE,CAAC,UAAU,EACzB,GAAG,CAAC,EAAE,EAAE,CAAC,OAAO,EAChB,KAAK,CAAC,EAAE,EAAE,CAAC,SAAS,GACnB,OAAO,CAAC,MAAM,CAAC,CA0BjB"}

package/dist/render-page.js

@@ -0,0 +1,34 @@
+import { renderAsync } from "@hyperspan/html";
+import { toPageRenderView, PageValidationError, } from "./pages.js";
+import { slotHasContent } from "./slot-content.js";
+import { buildPageSlots } from "./slot-handle.js";
+import { renderStandardHead } from "./render-head.js";
+export { RenderError } from "./slot-handle.js";
+function validateRequiredSlots(page) {
+    for (const required of page.template.requiredSlots) {
+        const items = page.slots[required];
+        if (!items || items.length === 0 || !slotHasContent(items)) {
+            throw new PageValidationError(`required slot "${required}" must have at least one block or non-empty HTML string`);
+        }
+    }
+}
+export async function renderPage(page, siteConfig, ctx, hooks) {
+    validateRequiredSlots(page);
+    const renderCtx = { siteConfig, ctx, page, hooks };
+    const slots = buildPageSlots(page, renderCtx);
+    const head = renderStandardHead({
+        title: page.template.formatPageTitle(page.title),
+        meta: page.meta,
+    });
+    let html = await renderAsync(page.template.render({
+        head,
+        siteConfig,
+        page: toPageRenderView(page),
+        slots,
+    }));
+    if (hooks?.afterRender) {
+        html = await hooks.afterRender(html, { page, ctx });
+    }
+    return html;
+}
+//# sourceMappingURL=render-page.js.map

package/dist/render-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-page.js","sourceRoot":"","sources":["../src/render-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EACL,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAe,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAGtD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,SAAS,qBAAqB,CAAC,IAAiB;IAC9C,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAmC,CAAC,CAAC;QAC9D,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,mBAAmB,CAC3B,kBAAkB,QAAQ,yDAAyD,CACpF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAiB,EACjB,UAAyB,EACzB,GAAgB,EAChB,KAAoB;IAEpB,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAE5B,MAAM,SAAS,GAAqB,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAErE,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAE9C,MAAM,IAAI,GAAG,kBAAkB,CAAC;QAC9B,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAChD,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC,CAAC;IAEH,IAAI,IAAI,GAAG,MAAM,WAAW,CAC1B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnB,IAAI;QACJ,UAAU;QACV,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC;QAC5B,KAAK;KACN,CAAC,CACH,CAAC;IAEF,IAAI,KAAK,EAAE,WAAW,EAAE,CAAC;QACvB,IAAI,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/routing.d.ts

@@ -0,0 +1,3 @@
+export declare function normalizePathname(pathname: string): string;
+export declare function matchPagePath(pathname: string, pagePath: string): boolean;
+//# sourceMappingURL=routing.d.ts.map

package/dist/routing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAET"}

package/dist/routing.js

@@ -0,0 +1,11 @@
+export function normalizePathname(pathname) {
+    if (pathname === "" || pathname === "/") {
+        return "/";
+    }
+    const trimmed = pathname.replace(/\/+$/, "");
+    return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+}
+export function matchPagePath(pathname, pagePath) {
+    return normalizePathname(pathname) === normalizePathname(pagePath);
+}
+//# sourceMappingURL=routing.js.map

package/dist/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../src/routing.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QACxC,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7C,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,QAAgB;IAEhB,OAAO,iBAAiB,CAAC,QAAQ,CAAC,KAAK,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrE,CAAC"}

package/dist/site.d.ts

@@ -0,0 +1,14 @@
+import type { Stackbox as SB } from "./types.js";
+export declare class SiteError extends Error {
+    constructor(message: string);
+}
+export declare function createSiteConfig<T extends Record<string, unknown>>(config: T): SB.SiteConfig<T>;
+export declare function isSiteConfig(value: unknown): value is SB.SiteConfig;
+export declare function createSite<T extends Record<string, unknown>>(siteConfig: SB.SiteConfig<T>, options: {
+    pages: [SB.SitePage, ...SB.SitePage[]];
+    plugins?: readonly SB.Plugin[];
+    cacheAdapter?: SB.CacheAdapter;
+    hooks?: SB.SiteHooks;
+}): SB.Site<T>;
+export declare function isSite(value: unknown): value is SB.Site;
+//# sourceMappingURL=site.d.ts.map

package/dist/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,YAAY,CAAC;AAEjD,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAI5B;AAWD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,MAAM,EAAE,CAAC,GACR,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAMlB;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,EAAE,CAAC,UAAU,CASnE;AA0ED,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC1D,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,EAC5B,OAAO,EAAE;IACP,KAAK,EAAE,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC;IAC/B,YAAY,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC;IAC/B,KAAK,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC;CACtB,GACA,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CA6MZ;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,EAAE,CAAC,IAAI,CAUvD"}

package/dist/site.js

@@ -0,0 +1,233 @@
+import { buildPageCacheKey, cacheControlFresh, cacheControlStale, collectPageCacheConfigs, createMemoryCache, isCacheEntryFresh, isPageCacheDisabled, isSuccessfulRender, resolvePageCacheTtlMs, } from "./cache.js";
+import { isPage } from "./pages.js";
+import { renderPage } from "./render-page.js";
+import { servePluginAsset } from "./link.js";
+import { assertPlugin, } from "./plugin.js";
+import { normalizePathname } from "./routing.js";
+import { createContext } from "./stackbox/context.js";
+export class SiteError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "SiteError";
+    }
+}
+function validateConfigObject(config, label) {
+    if (!config || typeof config !== "object" || Array.isArray(config)) {
+        throw new SiteError(`${label}: config must be a non-null object`);
+    }
+    if (Object.keys(config).length === 0) {
+        throw new SiteError(`${label}: config must not be empty`);
+    }
+}
+export function createSiteConfig(config) {
+    validateConfigObject(config, "createSiteConfig(config)");
+    return {
+        __kind: "siteConfig",
+        config,
+    };
+}
+export function isSiteConfig(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value.__kind === "siteConfig" &&
+        typeof value.config === "object" &&
+        value.config !== null &&
+        !Array.isArray(value.config));
+}
+function assertUniquePaths(pages) {
+    const seen = new Map();
+    for (const page of pages) {
+        const existing = seen.get(page.path);
+        if (existing) {
+            throw new SiteError(`duplicate page path "${page.path}" (${existing} and ${page.title})`);
+        }
+        seen.set(page.path, page.title);
+    }
+}
+function buildPageMap(pages) {
+    const map = new Map();
+    for (const page of pages) {
+        map.set(normalizePathname(page.path), page);
+    }
+    return map;
+}
+function assertUniquePluginNames(plugins) {
+    const seen = new Set();
+    for (const plugin of plugins) {
+        if (seen.has(plugin.name)) {
+            throw new SiteError(`createSite(siteConfig, options): duplicate plugin name "${plugin.name}"`);
+        }
+        seen.add(plugin.name);
+    }
+}
+function collectPluginRoutes(plugins, site, pagePaths) {
+    const routes = new Map();
+    for (const plugin of plugins) {
+        if (!plugin.routes) {
+            continue;
+        }
+        const declared = plugin.routes({ site });
+        if (declared instanceof Promise) {
+            throw new SiteError(`createSite(siteConfig, options): plugin "${plugin.name}" routes must return synchronously`);
+        }
+        for (const route of declared) {
+            const path = normalizePathname(route.path);
+            if (pagePaths.has(path)) {
+                throw new SiteError(`createSite(siteConfig, options): plugin route "${path}" conflicts with a page path`);
+            }
+            if (routes.has(path)) {
+                throw new SiteError(`createSite(siteConfig, options): duplicate plugin route "${path}"`);
+            }
+            routes.set(path, route.fetch);
+        }
+    }
+    return routes;
+}
+export function createSite(siteConfig, options) {
+    if (!isSiteConfig(siteConfig)) {
+        throw new SiteError("createSite(siteConfig, options): siteConfig must be from createSiteConfig()");
+    }
+    const { pages } = options;
+    if (!Array.isArray(pages) || pages.length === 0) {
+        throw new SiteError("createSite(siteConfig, options): pages must be a non-empty array");
+    }
+    for (const page of pages) {
+        if (!isPage(page)) {
+            throw new SiteError("createSite(siteConfig, options): every page must be from createPage()");
+        }
+    }
+    const plugins = options.plugins ?? [];
+    if (!Array.isArray(plugins)) {
+        throw new SiteError("createSite(siteConfig, options): plugins must be an array of createPlugin() results");
+    }
+    for (const plugin of plugins) {
+        try {
+            assertPlugin(plugin, "createSite(siteConfig, options)");
+        }
+        catch (error) {
+            throw new SiteError(error instanceof Error ? error.message : String(error));
+        }
+    }
+    assertUniquePluginNames(plugins);
+    assertUniquePaths(pages);
+    const pageMap = buildPageMap(pages);
+    const pagePaths = new Set(pageMap.keys());
+    const siteShell = {
+        __kind: "site",
+        siteConfig,
+        pages,
+        plugins,
+        async fetch() {
+            return new globalThis.Response("Site not ready", { status: 500 });
+        },
+    };
+    const pluginRoutes = collectPluginRoutes(plugins, siteShell, pagePaths);
+    const cacheAdapter = options.cacheAdapter ?? createMemoryCache();
+    const hooks = options.hooks;
+    const inFlightRenders = new Map();
+    async function applyBeforeResponse(response, request, ctx, page) {
+        if (!hooks?.beforeResponse) {
+            return response;
+        }
+        return hooks.beforeResponse(response, { request, page, ctx });
+    }
+    async function renderAndStore(key, page, ctx, ttlMs) {
+        const existing = inFlightRenders.get(key);
+        if (existing) {
+            return existing;
+        }
+        const promise = (async () => {
+            const html = await renderPage(page, siteConfig, ctx, hooks);
+            if (isSuccessfulRender(html)) {
+                await cacheAdapter.set(key, {
+                    html,
+                    expiresAt: Date.now() + ttlMs,
+                });
+            }
+            return html;
+        })();
+        inFlightRenders.set(key, promise);
+        try {
+            return await promise;
+        }
+        finally {
+            if (inFlightRenders.get(key) === promise) {
+                inFlightRenders.delete(key);
+            }
+        }
+    }
+    function startBackgroundRefresh(key, page, ctx, ttlMs) {
+        if (inFlightRenders.has(key)) {
+            return;
+        }
+        void renderAndStore(key, page, ctx, ttlMs).catch(() => {
+            // Keep serving the last good HTML on refresh failure.
+        });
+    }
+    async function respondWithHtml(html, method, cacheControl, ctx) {
+        const headers = { "Cache-Control": cacheControl };
+        if (method === "HEAD") {
+            return ctx.res.html("", { status: 200, headers });
+        }
+        return ctx.res.html(html, { status: 200, headers });
+    }
+    return {
+        __kind: "site",
+        siteConfig,
+        pages,
+        plugins,
+        async fetch(request, env = {}) {
+            const ctx = createContext(request, env);
+            const method = ctx.req.method;
+            const pathname = normalizePathname(ctx.req.url.pathname);
+            const pluginRoute = pluginRoutes.get(pathname);
+            if (pluginRoute) {
+                return pluginRoute(request, ctx);
+            }
+            if (method !== "GET" && method !== "HEAD") {
+                return ctx.res.text("Method Not Allowed", { status: 405 });
+            }
+            const pluginAsset = servePluginAsset(pathname, method, plugins);
+            if (pluginAsset) {
+                return pluginAsset;
+            }
+            const page = pageMap.get(pathname);
+            if (!page) {
+                return applyBeforeResponse(await ctx.res.notFound(), request, ctx);
+            }
+            const cacheKey = buildPageCacheKey(pathname, ctx.req.url.search);
+            const cacheConfigs = collectPageCacheConfigs(page, siteConfig);
+            const hookAllowsCache = hooks?.shouldCache
+                ? hooks.shouldCache(request)
+                : true;
+            async function respondForPage(html, cacheControl) {
+                return applyBeforeResponse(await respondWithHtml(html, method, cacheControl, ctx), request, ctx, page);
+            }
+            if (isPageCacheDisabled(cacheConfigs) || !hookAllowsCache) {
+                const html = await renderPage(page, siteConfig, ctx, hooks);
+                return respondForPage(html, "no-store");
+            }
+            const ttlMs = resolvePageCacheTtlMs(cacheConfigs);
+            const cached = await cacheAdapter.get(cacheKey);
+            if (cached && isCacheEntryFresh(cached)) {
+                return respondForPage(cached.html, cacheControlFresh(ttlMs));
+            }
+            if (cached) {
+                startBackgroundRefresh(cacheKey, page, ctx, ttlMs);
+                return respondForPage(cached.html, cacheControlStale(ttlMs));
+            }
+            const html = await renderAndStore(cacheKey, page, ctx, ttlMs);
+            return respondForPage(html, cacheControlFresh(ttlMs));
+        },
+    };
+}
+export function isSite(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value.__kind === "site" &&
+        isSiteConfig(value.siteConfig) &&
+        Array.isArray(value.pages) &&
+        Array.isArray(value.plugins) &&
+        typeof value.fetch === "function");
+}
+//# sourceMappingURL=site.js.map

package/dist/site.js.map

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

package/dist/slot-content.d.ts

@@ -0,0 +1,14 @@
+import type { z } from "zod";
+import type { Stackbox as SB } from "./types.js";
+/** Accepts any block or HTML string (default slot content). */
+export declare const anySlotContentSchema: z.ZodType<SB.DefaultSlotContent>;
+/** Accepts only HTML strings. */
+export declare const stringSlotContentSchema: z.ZodString;
+/** Accepts only CMS blocks. */
+export declare const blockSlotContentSchema: z.ZodType<SB.Block>;
+export declare function validateSlotContentItem(slotName: string, item: unknown, schema: z.ZodTypeAny | undefined): void;
+export declare class SlotContentValidationError extends Error {
+    constructor(slotName: string, message: string);
+}
+export declare function slotHasContent(items: unknown[]): boolean;
+//# sourceMappingURL=slot-content.d.ts.map

package/dist/slot-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-content.d.ts","sourceRoot":"","sources":["../src/slot-content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,OAAO,KAAK,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,YAAY,CAAC;AAEjD,+DAA+D;AAC/D,eAAO,MAAM,oBAAoB,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,kBAAkB,CAGhE,CAAC;AAEH,iCAAiC;AACjC,eAAO,MAAM,uBAAuB,aAAe,CAAC;AAEpD,+BAA+B;AAC/B,eAAO,MAAM,sBAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAEtD,CAAC;AAEF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,GAC/B,IAAI,CAkBN;AAED,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI9C;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAMxD"}

package/dist/slot-content.js

@@ -0,0 +1,34 @@
+import { z as zod } from "zod";
+import { isBlock } from "./blocks.js";
+/** Accepts any block or HTML string (default slot content). */
+export const anySlotContentSchema = zod.union([
+    zod.string(),
+    zod.custom((value) => isBlock(value)),
+]);
+/** Accepts only HTML strings. */
+export const stringSlotContentSchema = zod.string();
+/** Accepts only CMS blocks. */
+export const blockSlotContentSchema = zod.custom((value) => isBlock(value));
+export function validateSlotContentItem(slotName, item, schema) {
+    if (schema) {
+        const result = schema.safeParse(item);
+        if (!result.success) {
+            throw new SlotContentValidationError(slotName, result.error.message);
+        }
+        return;
+    }
+    if (typeof item !== "string" && !isBlock(item)) {
+        throw new SlotContentValidationError(slotName, "expected block or HTML string");
+    }
+}
+export class SlotContentValidationError extends Error {
+    constructor(slotName, message) {
+        super(`slot "${slotName}" content failed validation: ${message}`);
+        this.name = "SlotContentValidationError";
+    }
+}
+export function slotHasContent(items) {
+    return items.some((item) => isBlock(item) ||
+        (typeof item === "string" && item.trim().length > 0));
+}
+//# sourceMappingURL=slot-content.js.map

package/dist/slot-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-content.js","sourceRoot":"","sources":["../src/slot-content.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,IAAI,GAAG,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAGtC,+DAA+D;AAC/D,MAAM,CAAC,MAAM,oBAAoB,GAAqC,GAAG,CAAC,KAAK,CAAC;IAC9E,GAAG,CAAC,MAAM,EAAE;IACZ,GAAG,CAAC,MAAM,CAAW,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;CAChD,CAAC,CAAC;AAEH,iCAAiC;AACjC,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;AAEpD,+BAA+B;AAC/B,MAAM,CAAC,MAAM,sBAAsB,GAAwB,GAAG,CAAC,MAAM,CACnE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAC1B,CAAC;AAEF,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,IAAa,EACb,MAAgC;IAEhC,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,0BAA0B,CAClC,QAAQ,EACR,MAAM,CAAC,KAAK,CAAC,OAAO,CACrB,CAAC;QACJ,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,0BAA0B,CAClC,QAAQ,EACR,+BAA+B,CAChC,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACnD,YAAY,QAAgB,EAAE,OAAe;QAC3C,KAAK,CAAC,SAAS,QAAQ,gCAAgC,OAAO,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,KAAgB;IAC7C,OAAO,KAAK,CAAC,IAAI,CACf,CAAC,IAAI,EAAE,EAAE,CACP,OAAO,CAAC,IAAI,CAAC;QACb,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CACvD,CAAC;AACJ,CAAC"}

package/dist/slot-handle.d.ts

@@ -0,0 +1,14 @@
+import { type HSHtml } from "@hyperspan/html";
+import type { z } from "zod";
+import type { Stackbox as SB } from "./types.js";
+export declare class RenderError extends Error {
+    constructor(message: string);
+}
+export declare const SLOT_SENTINEL_PREFIX = "<!--__STACKBOX_SLOT__:";
+export declare function slotSentinel(name: string): string;
+export declare function renderSlotContent(slotName: string, items: readonly unknown[], ctx: SB.RenderContext, schema: z.ZodTypeAny | undefined): Promise<HSHtml>;
+export declare function createStubSlot<D extends SB.SlotDefinition>(definition: D): SB.Slot<SB.DefaultSlotContent, D>;
+export declare function createPageSlot<D extends SB.SlotDefinition>(definition: D, content: readonly SB.SlotContentFromDefinition<D>[], ctx: SB.RenderContext): SB.Slot<SB.SlotContentFromDefinition<D>, D>;
+export declare function buildStubSlots<S extends readonly SB.SlotDefinition[]>(definitions: S): SB.TemplateSlotsFrom<S>;
+export declare function buildPageSlots(page: SB.SitePage, ctx: SB.RenderContext): Record<string, SB.Slot>;
+//# sourceMappingURL=slot-handle.d.ts.map

package/dist/slot-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slot-handle.d.ts","sourceRoot":"","sources":["../src/slot-handle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,KAAK,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,YAAY,CAAC;AAKjD,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAE7D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AA0BD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,SAAS,OAAO,EAAE,EACzB,GAAG,EAAE,EAAE,CAAC,aAAa,EACrB,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,SAAS,GAC/B,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED,wBAAgB,cAAc,CAC5B,CAAC,SAAS,EAAE,CAAC,cAAc,EAC3B,UAAU,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,CAAC,CASlD;AAED,wBAAgB,cAAc,CAC5B,CAAC,SAAS,EAAE,CAAC,cAAc,EAE3B,UAAU,EAAE,CAAC,EACb,OAAO,EAAE,SAAS,EAAE,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,EACnD,GAAG,EAAE,EAAE,CAAC,aAAa,GACpB,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAU7C;AAED,wBAAgB,cAAc,CAAC,CAAC,SAAS,SAAS,EAAE,CAAC,cAAc,EAAE,EACnE,WAAW,EAAE,CAAC,GACb,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAQzB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,EAAE,CAAC,QAAQ,EACjB,GAAG,EAAE,EAAE,CAAC,aAAa,GACpB,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAUzB"}