@highjumpdigitalsoftware/blog-kit 0.6.0

package/dist/core/manifest/templates.json

@@ -0,0 +1,77 @@
+{
+  "$comment": "Content-type templates surfaced by the MCP's list_templates. Templates are suggestions — any components can be mixed freely. Phase 1 reconciles this against the MCP's current TEMPLATE_SUMMARIES; seeded here as the single source of truth.",
+  "templates": [
+    {
+      "name": "informational",
+      "description": "Explainer / thought-leadership piece that teaches a concept.",
+      "structure": "Intro → TableOfContents → sections → CalloutBox/TipBox asides → FAQList → conclusion CTA",
+      "suggestedComponents": [
+        "TableOfContents",
+        "CalloutBox",
+        "TipBox",
+        "Definition",
+        "Infographic",
+        "FAQList",
+        "CTABanner"
+      ]
+    },
+    {
+      "name": "comparison",
+      "description": "Head-to-head of two or more options.",
+      "structure": "Intro → ComparisonTable → ProConBlock per option → verdict → FAQList",
+      "suggestedComponents": [
+        "ComparisonTable",
+        "ProConBlock",
+        "QuoteBlock",
+        "CalloutBox",
+        "FAQList",
+        "CTABanner"
+      ]
+    },
+    {
+      "name": "how-to",
+      "description": "Step-by-step guide to accomplish a task.",
+      "structure": "Intro → what you'll need → StepBlock sequence → TipBox → FAQList",
+      "suggestedComponents": [
+        "StepBlock",
+        "TipBox",
+        "CalloutBox",
+        "CodeSnippet",
+        "Checklist",
+        "FAQList"
+      ]
+    },
+    {
+      "name": "listicle",
+      "description": "Numbered/curated list of items, tools, or tactics.",
+      "structure": "Intro → numbered items → per-item detail → summary → FAQList",
+      "suggestedComponents": [
+        "NumberedCard",
+        "List",
+        "CalloutBox",
+        "ImageFeature",
+        "FAQList",
+        "CTABanner"
+      ]
+    },
+    {
+      "name": "case-study",
+      "description": "Client/result story with metrics.",
+      "structure": "Hero → results strip → narrative → metrics → quote → CTA",
+      "suggestedComponents": [
+        "MetricHighlight",
+        "StatCard",
+        "BeforeAfter",
+        "QuoteBlock",
+        "ProConBlock",
+        "CTABanner"
+      ]
+    },
+    {
+      "name": "freestyle",
+      "description": "No fixed structure — mix any components as the topic demands.",
+      "structure": "Author's choice.",
+      "suggestedComponents": []
+    }
+  ]
+}

package/dist/package/adapters/hjd-api.d.ts

@@ -0,0 +1,14 @@
+import type { HjdApiSourceConfig } from "../config/types";
+import type { ContentSource, PostMeta, PostWithBody } from "./source";
+export declare class HjdApiSource implements ContentSource {
+    readonly mode: "hjd-api";
+    private readonly base;
+    private readonly token;
+    private readonly revalidate;
+    constructor(cfg: HjdApiSourceConfig);
+    private req;
+    listPosts(): Promise<PostMeta[]>;
+    listSlugs(): Promise<string[]>;
+    getPost(slug: string): Promise<PostWithBody | null>;
+}
+//# sourceMappingURL=hjd-api.d.ts.map

package/dist/package/adapters/hjd-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hjd-api.d.ts","sourceRoot":"","sources":["../../../package/adapters/hjd-api.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAStE,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,CAAC,IAAI,EAAG,SAAS,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,GAAG,EAAE,kBAAkB;YAcrB,GAAG;IA2BX,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAQhC,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK9B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAM1D"}

package/dist/package/adapters/hjd-api.js

@@ -0,0 +1,57 @@
+export class HjdApiSource {
+    constructor(cfg) {
+        this.mode = "hjd-api";
+        this.base = (cfg.contentUrl ?? "").replace(/\/+$/, "");
+        this.token = cfg.siteToken ?? "";
+        this.revalidate = cfg.fetchRevalidate ?? 60;
+        if (!this.base) {
+            // Fail loud at construction in dev; in prod the route renders an
+            // empty list rather than crashing the whole site.
+            console.error("[blog-kit] hjd-api source has no contentUrl. " +
+                "Set BLOGKIT_CONTENT_URL (and BLOGKIT_SITE_TOKEN) in the host env.");
+        }
+    }
+    async req(pathname) {
+        if (!this.base)
+            return null;
+        const url = `${this.base}${pathname}`;
+        try {
+            const res = await fetch(url, {
+                headers: {
+                    Authorization: `Bearer ${this.token}`,
+                    Accept: "application/json",
+                },
+                // Next.js ISR: cache + background-revalidate. This is what makes
+                // the render static HTML refreshed on a timer (no redeploy).
+                // `next` is a Next.js extension to RequestInit (typed there, not
+                // in the lib's standalone build) — cast to keep it.
+                next: { revalidate: this.revalidate, tags: ["blogkit"] },
+            });
+            if (res.status === 404)
+                return null;
+            if (!res.ok) {
+                console.error(`[blog-kit] hjd-api ${res.status} for ${pathname}`);
+                return null;
+            }
+            return (await res.json());
+        }
+        catch (err) {
+            console.error(`[blog-kit] hjd-api fetch failed for ${pathname}:`, err);
+            return null;
+        }
+    }
+    async listPosts() {
+        const data = await this.req("/posts");
+        const posts = data?.posts ?? [];
+        return [...posts].sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime());
+    }
+    async listSlugs() {
+        const posts = await this.listPosts();
+        return posts.map((p) => p.slug);
+    }
+    async getPost(slug) {
+        const data = await this.req(`/posts/${encodeURIComponent(slug)}`);
+        return data?.post ?? null;
+    }
+}
+//# sourceMappingURL=hjd-api.js.map

package/dist/package/adapters/hjd-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hjd-api.js","sourceRoot":"","sources":["../../../package/adapters/hjd-api.ts"],"names":[],"mappings":"AA2BA,MAAM,OAAO,YAAY;IAMvB,YAAY,GAAuB;QAL1B,SAAI,GAAG,SAAkB,CAAC;QAMjC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC,eAAe,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACf,iEAAiE;YACjE,kDAAkD;YAClD,OAAO,CAAC,KAAK,CACX,+CAA+C;gBAC7C,mEAAmE,CACtE,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,GAAG,CAAI,QAAgB;QACnC,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAC5B,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAC3B,OAAO,EAAE;oBACP,aAAa,EAAE,UAAU,IAAI,CAAC,KAAK,EAAE;oBACrC,MAAM,EAAE,kBAAkB;iBAC3B;gBACD,iEAAiE;gBACjE,6DAA6D;gBAC7D,iEAAiE;gBACjE,oDAAoD;gBACpD,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE;aACS,CAAC,CAAC;YACrE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO,CAAC,KAAK,CAAC,sBAAsB,GAAG,CAAC,MAAM,QAAQ,QAAQ,EAAE,CAAC,CAAC;gBAClE,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;QACjC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,uCAAuC,QAAQ,GAAG,EAAE,GAAG,CAAC,CAAC;YACvE,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CAAkB,QAAQ,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CACpB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAClE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,GAAG,CACzB,UAAU,kBAAkB,CAAC,IAAI,CAAC,EAAE,CACrC,CAAC;QACF,OAAO,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC;IAC5B,CAAC;CACF"}

package/dist/package/adapters/index.d.ts

@@ -0,0 +1,13 @@
+import type { ResolvedConfig } from "../config/types";
+import type { ContentSource } from "./source";
+export type { ContentSource, PostMeta, PostWithBody, PostFrontmatter } from "./source";
+export { LocalSource } from "./local";
+export { HjdApiSource } from "./hjd-api";
+/**
+ * Build the configured content source. THE swap point: the whole
+ * difference between "pull from our API" and "ejected, local files"
+ * is which branch this returns. Eject flips `source.mode` and dumps
+ * the MDX to disk; nothing else in the kit changes.
+ */
+export declare function createSource(cfg: ResolvedConfig): ContentSource;
+//# sourceMappingURL=index.d.ts.map

package/dist/package/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../package/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAI9C,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,aAAa,CAG/D"}

package/dist/package/adapters/index.js

@@ -0,0 +1,16 @@
+import { LocalSource } from "./local.js";
+import { HjdApiSource } from "./hjd-api.js";
+export { LocalSource } from "./local.js";
+export { HjdApiSource } from "./hjd-api.js";
+/**
+ * Build the configured content source. THE swap point: the whole
+ * difference between "pull from our API" and "ejected, local files"
+ * is which branch this returns. Eject flips `source.mode` and dumps
+ * the MDX to disk; nothing else in the kit changes.
+ */
+export function createSource(cfg) {
+    if (cfg.source.mode === "local")
+        return new LocalSource(cfg.source);
+    return new HjdApiSource(cfg.source);
+}
+//# sourceMappingURL=index.js.map

package/dist/package/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../package/adapters/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,GAAmB;IAC9C,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpE,OAAO,IAAI,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/package/adapters/local.d.ts

@@ -0,0 +1,13 @@
+import type { LocalSourceConfig } from "../config/types";
+import type { ContentSource, PostMeta, PostWithBody } from "./source";
+export declare class LocalSource implements ContentSource {
+    readonly mode: "local";
+    private readonly dir;
+    constructor(cfg: LocalSourceConfig);
+    private slugs;
+    private read;
+    listSlugs(): Promise<string[]>;
+    listPosts(): Promise<PostMeta[]>;
+    getPost(slug: string): Promise<PostWithBody | null>;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/package/adapters/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../package/adapters/local.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEtE,qBAAa,WAAY,YAAW,aAAa;IAC/C,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,iBAAiB;IAIlC,OAAO,CAAC,KAAK;IAQb,OAAO,CAAC,IAAI;IAoBN,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI9B,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAiBhC,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAM1D"}

package/dist/package/adapters/local.js

@@ -0,0 +1,72 @@
+/* ============================================================
+   LocalSource — reads MDX-with-components from local files.
+   Mirrors hjd-website's src/lib/blog.js exactly (the proven
+   path), generalised over a configurable posts directory.
+   This is also the EJECTED state's source.
+   ============================================================ */
+import fs from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+import readingTime from "reading-time";
+export class LocalSource {
+    constructor(cfg) {
+        this.mode = "local";
+        this.dir = path.resolve(process.cwd(), cfg.postsDir ?? "content/posts");
+    }
+    slugs() {
+        if (!fs.existsSync(this.dir))
+            return [];
+        return fs
+            .readdirSync(this.dir)
+            .filter((f) => f.endsWith(".mdx"))
+            .map((f) => f.replace(/\.mdx$/, ""));
+    }
+    read(slug) {
+        const file = path.resolve(this.dir, `${slug}.mdx`);
+        // Containment: a route slug is request-derived, so refuse anything that
+        // resolves outside the posts dir (path traversal via `../` / encoded
+        // segments). Without this, a crafted slug could read other `*.mdx` files
+        // on the host in the ejected/local mode.
+        const root = this.dir.endsWith(path.sep) ? this.dir : this.dir + path.sep;
+        if (file !== this.dir && !file.startsWith(root))
+            return null;
+        if (!fs.existsSync(file))
+            return null;
+        const raw = fs.readFileSync(file, "utf-8");
+        const { data, content } = matter(raw);
+        const rt = readingTime(content);
+        return {
+            ...data,
+            slug,
+            readingTime: Math.ceil(rt.minutes),
+            body: content,
+        };
+    }
+    async listSlugs() {
+        return this.slugs();
+    }
+    async listPosts() {
+        const isProd = process.env.NODE_ENV === "production";
+        return this.slugs()
+            .map((slug) => {
+            const post = this.read(slug);
+            if (!post)
+                return null;
+            // strip the heavy body for the listing shape
+            const { body: _body, ...meta } = post;
+            return meta;
+        })
+            .filter((p) => !!p)
+            .filter((p) => !(isProd && p.draft))
+            .sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime());
+    }
+    async getPost(slug) {
+        const post = this.read(slug);
+        if (!post)
+            return null;
+        if (process.env.NODE_ENV === "production" && post.draft)
+            return null;
+        return post;
+    }
+}
+//# sourceMappingURL=local.js.map

package/dist/package/adapters/local.js.map

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

package/dist/package/adapters/source.d.ts

@@ -0,0 +1,39 @@
+/** The frontmatter we read off a post (superset across both consumer sites). */
+export interface PostFrontmatter {
+    title: string;
+    description: string;
+    date: string;
+    author: string;
+    category: string;
+    tags?: string[];
+    featuredImage?: string;
+    featuredImageAlt?: string;
+    draft?: boolean;
+    [key: string]: unknown;
+}
+/** Listing-shape metadata (no body) — what the index needs. */
+export interface PostMeta extends PostFrontmatter {
+    slug: string;
+    readingTime: number;
+}
+/** A full post: metadata + the raw MDX body to render. */
+export interface PostWithBody extends PostMeta {
+    /** Raw MDX-with-components source (frontmatter already stripped). */
+    body: string;
+}
+/**
+ * The adapter contract. Both modes implement exactly this.
+ *
+ * All methods are async so the remote source is natural; the local
+ * source just resolves immediately. Routes always `await`.
+ */
+export interface ContentSource {
+    readonly mode: "local" | "hjd-api";
+    /** All published posts as listing metadata, newest-first, drafts excluded in prod. */
+    listPosts(): Promise<PostMeta[]>;
+    /** One post (meta + body) by slug, or null if absent/unpublished. */
+    getPost(slug: string): Promise<PostWithBody | null>;
+    /** All slugs (for generateStaticParams). */
+    listSlugs(): Promise<string[]>;
+}
+//# sourceMappingURL=source.d.ts.map

package/dist/package/adapters/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../../package/adapters/source.ts"],"names":[],"mappings":"AAkBA,gFAAgF;AAChF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAGhB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,+DAA+D;AAC/D,MAAM,WAAW,QAAS,SAAQ,eAAe;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,0DAA0D;AAC1D,MAAM,WAAW,YAAa,SAAQ,QAAQ;IAC5C,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;IACnC,sFAAsF;IACtF,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjC,qEAAqE;IACrE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACpD,4CAA4C;IAC5C,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAChC"}

package/dist/package/adapters/source.js

@@ -0,0 +1,19 @@
+/* ============================================================
+   @highjumpdigitalsoftware/blog-kit — content source adapter (the swap point)
+   ------------------------------------------------------------
+   A ContentSource yields portable MDX-with-components + rich
+   frontmatter. Two implementations ship:
+
+     - LocalSource   reads .mdx from the repo filesystem
+     - HjdApiSource  fetches MDX from our per-tenant content API
+
+   They satisfy the SAME interface, so flipping
+   `source.mode` between them changes nothing else — that is
+   the entire eject story (hjd-api -> local + a content dump).
+
+   CONTRACT: a source returns raw MDX text + parsed frontmatter.
+   It never renders. The routes render. This keeps the source
+   testable and the render path identical across modes.
+   ============================================================ */
+export {};
+//# sourceMappingURL=source.js.map

package/dist/package/adapters/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../package/adapters/source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;kEAgBkE"}

package/dist/package/article.d.ts

@@ -0,0 +1,17 @@
+import type { ReactNode } from "react";
+import type { ResolvedConfig } from "./config/types";
+import type { PostWithBody } from "./adapters";
+export interface ArticleProps {
+    config: ResolvedConfig;
+    slug: string;
+    /** Extra/override MDX components merged over the kit map. */
+    components?: Record<string, unknown>;
+    /** Optional custom hero rendered above the body (per-site frame). */
+    hero?: (post: PostWithBody) => ReactNode;
+    /** Set false to omit the AuthorCard/Newsletter/Related tail. Default true. */
+    showTail?: boolean;
+}
+/** Load a post for the route. Returns null when absent (route calls notFound()). */
+export declare function getArticle(config: ResolvedConfig, slug: string): Promise<PostWithBody | null>;
+export declare function Article({ config, slug, components, hero, showTail, }: ArticleProps): Promise<import("react").JSX.Element | null>;
+//# sourceMappingURL=article.d.ts.map

package/dist/package/article.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"article.d.ts","sourceRoot":"","sources":["../../package/article.tsx"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO/C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,cAAc,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,qEAAqE;IACrE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,SAAS,CAAC;IACzC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,oFAAoF;AACpF,wBAAsB,UAAU,CAC9B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAG9B;AAoBD,wBAAsB,OAAO,CAAC,EAC5B,MAAM,EACN,IAAI,EACJ,UAAU,EACV,IAAI,EACJ,QAAe,GAChB,EAAE,YAAY,+CA+Bd"}

package/dist/package/article.js

@@ -0,0 +1,37 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { createSource } from "./adapters/index.js";
+import { RenderArticleBody } from "./mdx/render.js";
+import { BlogBehaviors } from "../react/index.js";
+import { AuthorCard } from "../react/AuthorCard.js";
+import { NewsletterCTA } from "../react/NewsletterCTA.js";
+import { RelatedPosts } from "../react/RelatedPosts.js";
+/** Load a post for the route. Returns null when absent (route calls notFound()). */
+export async function getArticle(config, slug) {
+    const source = createSource(config);
+    return source.getPost(slug);
+}
+/** Build the related-posts strip (same category, newest 3). */
+async function relatedFor(config, post) {
+    const source = createSource(config);
+    const all = await source.listPosts();
+    return all
+        .filter((p) => p.slug !== post.slug && p.category === post.category)
+        .slice(0, 3)
+        .map((p) => ({
+        slug: p.slug,
+        title: p.title,
+        excerpt: p.description,
+        date: p.date,
+        category: p.category,
+        featuredImage: p.featuredImage,
+        featuredImageAlt: p.featuredImageAlt,
+    }));
+}
+export async function Article({ config, slug, components, hero, showTail = true, }) {
+    const post = await getArticle(config, slug);
+    if (!post)
+        return null;
+    const related = showTail ? await relatedFor(config, post) : [];
+    return (_jsxs("div", { className: "blog-root", children: [hero ? hero(post) : null, _jsx(BlogBehaviors, {}), _jsx("div", { className: "bk-prose", children: _jsx(RenderArticleBody, { source: post.body, components: components }) }), showTail && (_jsxs("div", { style: { marginTop: 48 }, children: [_jsx(AuthorCard, { name: String(post.author ?? config.brand.name), role: String(post.authorRole ?? config.brand.name), bio: post.authorBio }), _jsx(NewsletterCTA, {}), related.length > 0 && (_jsx(RelatedPosts, { posts: related, hrefBase: `/${config.listing.articleBasePath.replace(/^\/+|\/+$/g, "")}/`.replace("//", "/") }))] }))] }));
+}
+//# sourceMappingURL=article.js.map

package/dist/package/article.js.map

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

package/dist/package/astro/data.d.ts

@@ -0,0 +1,45 @@
+import type { ResolvedConfig } from "../config/types";
+import type { PostMeta, PostWithBody } from "../adapters";
+import { type CategoryRef } from "../index-core";
+/** All published posts (listing shape), cached per the freshness window. */
+export declare function loadPosts(config: ResolvedConfig): Promise<PostMeta[]>;
+/** Every slug (for getStaticPaths in hybrid mode, or sitemaps). */
+export declare function loadSlugs(config: ResolvedConfig): Promise<string[]>;
+/** One post (meta + raw body), cached by slug. null when absent/unpublished. */
+export declare function loadPost(config: ResolvedConfig, slug: string): Promise<PostWithBody | null>;
+export interface ArticleData {
+    post: PostWithBody;
+    /** Ready-to-inject HTML for the `.bk-prose` region (set:html). */
+    bodyHtml: string;
+    /** Same-category, newest 3, excluding self — for the RelatedPosts strip. */
+    related: Array<{
+        slug: string;
+        title: string;
+        excerpt?: string;
+        date?: string;
+        category?: string;
+        featuredImage?: string;
+        featuredImageAlt?: string;
+    }>;
+}
+/**
+ * Load + render an article for the Astro route. Returns null when the post
+ * is absent (the route then renders a 404). The MDX body is compiled to HTML
+ * here (runtime), with optional per-site custom components.
+ */
+export declare function loadArticle(config: ResolvedConfig, slug: string, components?: Record<string, unknown>): Promise<ArticleData | null>;
+export interface IndexData {
+    featured: PostMeta | null;
+    items: PostMeta[];
+    categories: CategoryRef[];
+    page: number;
+    totalPages: number;
+    categorySlug?: string;
+}
+/**
+ * Compute the listing-page data (featured hero + paged grid + category nav)
+ * for the Astro index route. Mirrors the Next <BlogIndex> selection logic
+ * exactly, but returns plain data the .astro template iterates.
+ */
+export declare function loadIndex(config: ResolvedConfig, page?: number, categorySlug?: string): Promise<IndexData>;
+//# sourceMappingURL=data.d.ts.map

package/dist/package/astro/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../package/astro/data.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG1D,OAAO,EAKL,KAAK,WAAW,EAEjB,MAAM,eAAe,CAAC;AAWvB,4EAA4E;AAC5E,wBAAsB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAK3E;AAED,mEAAmE;AACnE,wBAAsB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGzE;AAED,gFAAgF;AAChF,wBAAsB,QAAQ,CAC5B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAK9B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC,CAAC;CACJ;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACnC,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAqB7B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,EAAE,WAAW,EAAE,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EACtB,IAAI,SAAI,EACR,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,SAAS,CAAC,CAyBpB"}

package/dist/package/astro/data.js

@@ -0,0 +1,81 @@
+import { createSource } from "../adapters/index.js";
+import { renderMdxToHtml } from "../mdx/render-astro.js";
+import { cached } from "./freshness.js";
+import { getCategories, getFeatured, paginate, postsInCategory, } from "../index-core.js";
+function ttl(config) {
+    // hjd-api source carries fetchRevalidate; fall back to freshness.revalidate.
+    const src = config.source;
+    if (src.mode === "hjd-api" && typeof src.fetchRevalidate === "number") {
+        return src.fetchRevalidate;
+    }
+    return config.freshness.revalidate;
+}
+/** All published posts (listing shape), cached per the freshness window. */
+export async function loadPosts(config) {
+    return cached("posts", ttl(config), async () => {
+        const source = createSource(config);
+        return source.listPosts();
+    });
+}
+/** Every slug (for getStaticPaths in hybrid mode, or sitemaps). */
+export async function loadSlugs(config) {
+    const posts = await loadPosts(config);
+    return posts.map((p) => p.slug);
+}
+/** One post (meta + raw body), cached by slug. null when absent/unpublished. */
+export async function loadPost(config, slug) {
+    return cached(`post:${slug}`, ttl(config), async () => {
+        const source = createSource(config);
+        return source.getPost(slug);
+    });
+}
+/**
+ * Load + render an article for the Astro route. Returns null when the post
+ * is absent (the route then renders a 404). The MDX body is compiled to HTML
+ * here (runtime), with optional per-site custom components.
+ */
+export async function loadArticle(config, slug, components) {
+    const post = await loadPost(config, slug);
+    if (!post)
+        return null;
+    const bodyHtml = await renderMdxToHtml(post.body, { components });
+    const all = await loadPosts(config);
+    const related = all
+        .filter((p) => p.slug !== post.slug && p.category === post.category)
+        .slice(0, 3)
+        .map((p) => ({
+        slug: p.slug,
+        title: p.title,
+        excerpt: p.description,
+        date: p.date,
+        category: p.category,
+        featuredImage: p.featuredImage,
+        featuredImageAlt: p.featuredImageAlt,
+    }));
+    return { post, bodyHtml, related };
+}
+/**
+ * Compute the listing-page data (featured hero + paged grid + category nav)
+ * for the Astro index route. Mirrors the Next <BlogIndex> selection logic
+ * exactly, but returns plain data the .astro template iterates.
+ */
+export async function loadIndex(config, page = 1, categorySlug) {
+    const { listing } = config;
+    const all = await loadPosts(config);
+    const scoped = categorySlug ? postsInCategory(all, categorySlug) : all;
+    const featured = !categorySlug && listing.showFeaturedHero && page <= 1
+        ? getFeatured(scoped, listing.pinnedSlug)
+        : null;
+    const pool = featured ? scoped.filter((p) => p.slug !== featured.slug) : scoped;
+    const paged = paginate(pool, page, listing.pageSize);
+    const categories = getCategories(all, listing.categoryLabels, listing.categoryOrder);
+    return {
+        featured,
+        items: paged.items,
+        categories,
+        page: paged.page,
+        totalPages: paged.totalPages,
+        categorySlug,
+    };
+}
+//# sourceMappingURL=data.js.map

package/dist/package/astro/data.js.map

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

package/dist/package/astro/freshness.d.ts

@@ -0,0 +1,11 @@
+/** Drop every cached read. Called by /api/blogkit/revalidate on publish. */
+export declare function clearBlogkitCache(): void;
+/** Drop a single keyed read (e.g. one slug). */
+export declare function clearBlogkitCacheKey(key: string): void;
+/**
+ * Memoise an async read for `ttlSeconds`. `ttlSeconds <= 0` disables
+ * caching (pure SSR, always fresh). A rejected promise is never cached,
+ * so a transient API error doesn't pin an empty result.
+ */
+export declare function cached<T>(key: string, ttlSeconds: number, loader: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=freshness.d.ts.map

package/dist/package/astro/freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../../../package/astro/freshness.ts"],"names":[],"mappings":"AA+BA,4EAA4E;AAC5E,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED,gDAAgD;AAChD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAC5B,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACvB,OAAO,CAAC,CAAC,CAAC,CAQZ"}

package/dist/package/astro/freshness.js

@@ -0,0 +1,48 @@
+/* ============================================================
+   Astro freshness — the ISR-equivalent for Astro.
+   ------------------------------------------------------------
+   Astro has NO ISR. The managed promise ("new posts appear with
+   no redeploy") is met on Astro by running the site in SSR mode
+   (`output: 'server'`/hybrid): every request can re-fetch from our
+   content API, so the blog is ALWAYS fresh with zero host
+   cooperation — works on Replit out of the box.
+
+   Hitting our API on literally every request is wasteful, so this
+   module adds a tiny in-process TTL cache around the source reads.
+   That is the Astro analogue of Next's `revalidate = N`: serve
+   cached for N seconds, refresh in the background of the next
+   request after the window. Plus a `clearBlogkitCache()` the
+   on-demand revalidate endpoint calls so a publish is reflected
+   INSTANTLY (the analogue of Next's revalidatePath).
+
+   The cache is per server process and best-effort: a cold/scaled
+   instance simply fetches fresh. Never a correctness risk — at
+   worst a post appears up to `ttlSeconds` later than publish on a
+   warm instance that hasn't been revalidate-pinged.
+   ============================================================ */
+const store = new Map();
+/** Drop every cached read. Called by /api/blogkit/revalidate on publish. */
+export function clearBlogkitCache() {
+    store.clear();
+}
+/** Drop a single keyed read (e.g. one slug). */
+export function clearBlogkitCacheKey(key) {
+    store.delete(key);
+}
+/**
+ * Memoise an async read for `ttlSeconds`. `ttlSeconds <= 0` disables
+ * caching (pure SSR, always fresh). A rejected promise is never cached,
+ * so a transient API error doesn't pin an empty result.
+ */
+export async function cached(key, ttlSeconds, loader) {
+    if (ttlSeconds <= 0)
+        return loader();
+    const now = Date.now();
+    const hit = store.get(key);
+    if (hit && hit.expires > now)
+        return hit.value;
+    const value = await loader();
+    store.set(key, { value, expires: now + ttlSeconds * 1000 });
+    return value;
+}
+//# sourceMappingURL=freshness.js.map