@ingram-tech/nk-blog 0.1.0

package/dist/limited-mdx.js

@@ -0,0 +1,151 @@
+import matter from "gray-matter";
+import { visit } from "unist-util-visit";
+import { toErrorMessage } from "./http.js";
+// Lowercase JSX that isn't one of these is almost certainly a miscased
+// vocabulary reference (<callout>), which MDX would render as an inert,
+// invisible HTML element — the one silent failure mode, so reject it.
+const HTML_TAGS = new Set([
+    "a",
+    "abbr",
+    "aside",
+    "b",
+    "blockquote",
+    "br",
+    "caption",
+    "cite",
+    "code",
+    "dd",
+    "del",
+    "details",
+    "div",
+    "dl",
+    "dt",
+    "em",
+    "figcaption",
+    "figure",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "hr",
+    "i",
+    "img",
+    "ins",
+    "kbd",
+    "li",
+    "main",
+    "mark",
+    "nav",
+    "ol",
+    "p",
+    "pre",
+    "q",
+    "s",
+    "samp",
+    "section",
+    "small",
+    "span",
+    "strong",
+    "sub",
+    "summary",
+    "sup",
+    "table",
+    "tbody",
+    "td",
+    "tfoot",
+    "th",
+    "thead",
+    "tr",
+    "u",
+    "ul",
+    "var",
+    "video",
+    "wbr",
+]);
+function checkElement(node, allow, file) {
+    const name = node.name;
+    // Nameless = fragment (<>…</>), which is inert prose grouping.
+    if (name === null)
+        return;
+    if (/^[a-z]/.test(name)) {
+        if (!HTML_TAGS.has(name)) {
+            file.fail(`Unknown HTML tag <${name}> — a miscased component? Vocabulary names are capitalized.`, node);
+        }
+    }
+    else if (!allow.includes(name)) {
+        file.fail(`<${name}> is not in this blog's component vocabulary (${allow.join(", ")}).`, node);
+    }
+    for (const attribute of node.attributes) {
+        if (attribute.type !== "mdxJsxAttribute") {
+            file.fail(`<${name}> uses a spread attribute; only literal props are allowed.`, node);
+            continue;
+        }
+        const value = attribute.value;
+        // null/undefined = bare boolean prop; string = literal. Anything else is
+        // an attribute-value expression — executable, so allow only simple
+        // literals.
+        if (value === null || value === undefined || typeof value === "string") {
+            continue;
+        }
+        const statement = value.data?.estree?.body[0];
+        const expression = statement?.type === "ExpressionStatement"
+            ? statement.expression
+            : undefined;
+        if (expression?.type !== "Literal") {
+            file.fail(`<${name} ${attribute.name}={…}> — attribute expressions are not allowed in limited MDX; use a literal.`, node);
+        }
+    }
+}
+/** Remark plugin implementing the boundary. Throws (via `file.fail`) on violation. */
+export function remarkLimitedMdx(options) {
+    return (tree, file) => {
+        visit(tree, (node) => {
+            switch (node.type) {
+                case "mdxjsEsm":
+                    file.fail("import/export statements are not allowed in limited MDX.", node);
+                    break;
+                case "mdxFlowExpression":
+                case "mdxTextExpression":
+                    file.fail("{…} expressions are not allowed in limited MDX.", node);
+                    break;
+                case "mdxJsxFlowElement":
+                case "mdxJsxTextElement":
+                    checkElement(node, options.allow, file);
+                    break;
+                default:
+                    break;
+            }
+        });
+    };
+}
+/**
+ * Admin's pre-publish lint: compile (without evaluating) a post source —
+ * frontmatter included — against a vocabulary. Also surfaces MDX syntax
+ * errors, so an LLM-authored post can never break a target site's build.
+ */
+export async function validateLimitedMdx(source, options) {
+    const { compile } = await import("@mdx-js/mdx");
+    const { default: remarkGfm } = await import("remark-gfm");
+    const { content } = matter(source);
+    try {
+        await compile(content, {
+            remarkPlugins: [remarkGfm, [remarkLimitedMdx, options]],
+        });
+        return { ok: true, errors: [] };
+    }
+    catch (error) {
+        const place = error !== null &&
+            typeof error === "object" &&
+            "line" in error &&
+            "column" in error
+            ? {
+                line: typeof error.line === "number" ? error.line : undefined,
+                column: typeof error.column === "number" ? error.column : undefined,
+            }
+            : {};
+        return { ok: false, errors: [{ message: toErrorMessage(error), ...place }] };
+    }
+}
+//# sourceMappingURL=limited-mdx.js.map

package/dist/limited-mdx.js.map

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

package/dist/reading-time.d.ts

@@ -0,0 +1,10 @@
+export declare const DEFAULT_WORDS_PER_MINUTE = 220;
+export interface ReadingTime {
+    words: number;
+    minutes: number;
+    /** e.g. "5 min read". */
+    text: string;
+}
+/** Real reading time from the body — replaces the fleet's faked "5 min read". */
+export declare function readingTime(content: string, wordsPerMinute?: number): ReadingTime;
+//# sourceMappingURL=reading-time.d.ts.map

package/dist/reading-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reading-time.d.ts","sourceRoot":"","sources":["../src/reading-time.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;CACb;AAED,iFAAiF;AACjF,wBAAgB,WAAW,CAC1B,OAAO,EAAE,MAAM,EACf,cAAc,GAAE,MAAiC,GAC/C,WAAW,CAOb"}

package/dist/reading-time.js

@@ -0,0 +1,11 @@
+export const DEFAULT_WORDS_PER_MINUTE = 220;
+/** Real reading time from the body — replaces the fleet's faked "5 min read". */
+export function readingTime(content, wordsPerMinute = DEFAULT_WORDS_PER_MINUTE) {
+    const words = content
+        .trim()
+        .split(/\s+/)
+        .filter((token) => token.length > 0).length;
+    const minutes = Math.max(1, Math.ceil(words / wordsPerMinute));
+    return { words, minutes, text: `${minutes} min read` };
+}
+//# sourceMappingURL=reading-time.js.map

package/dist/reading-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reading-time.js","sourceRoot":"","sources":["../src/reading-time.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAS5C,iFAAiF;AACjF,MAAM,UAAU,WAAW,CAC1B,OAAe,EACf,iBAAyB,wBAAwB;IAEjD,MAAM,KAAK,GAAG,OAAO;SACnB,IAAI,EAAE;SACN,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC;IAC/D,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,WAAW,EAAE,CAAC;AACxD,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,38 @@
+import type { ComponentType, ReactElement } from "react";
+import { type Components } from "react-markdown";
+import type { BlogComponents } from "./contract.js";
+import type { BlogPost } from "./types.js";
+export { remarkLimitedMdx, validateLimitedMdx } from "./limited-mdx.js";
+export type { LimitedMdxOptions, LimitedMdxResult, LimitedMdxViolation, } from "./limited-mdx.js";
+/**
+ * The element map a site passes to style prose (h1–h4, p, code, tables, …).
+ * One key set shared by both pipelines — react-markdown's `Components` is the
+ * canonical shape. The map itself never ships from nk-blog: it is the brand.
+ */
+export type BlogElements = Components;
+export type BespokeComponents = Record<string, ComponentType<never>>;
+/** Renders a `.md` body. Pure data — the automated publisher's format. */
+export declare const MarkdownBody: React.FC<{
+    content: string;
+    elements?: BlogElements;
+}>;
+/**
+ * Renders an `.mdx` body (async server component). `limited` (default true)
+ * enforces the vocabulary-only trust boundary; Tier-2 posts pass `bespoke`
+ * components, which turns enforcement off — those are human-reviewed code.
+ */
+export declare function MdxBody(props: {
+    content: string;
+    components: BlogComponents;
+    elements?: BlogElements;
+    bespoke?: BespokeComponents;
+    limited?: boolean;
+}): Promise<ReactElement>;
+/** Format-dispatching renderer: the one component a post page needs. */
+export declare function PostBody(props: {
+    post: BlogPost;
+    components: BlogComponents;
+    elements?: BlogElements;
+    bespoke?: BespokeComponents;
+}): Promise<ReactElement>;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAEzD,OAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACxE,YAAY,EACX,iBAAiB,EACjB,gBAAgB,EAChB,mBAAmB,GACnB,MAAM,kBAAkB,CAAC;AAE1B;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC;AAGtC,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;AAErE,0EAA0E;AAC1E,eAAO,MAAM,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB,CAIA,CAAC;AAEF;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,OAAO,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,YAAY,CAAC,CAWxB;AAED,wEAAwE;AACxE,wBAAsB,QAAQ,CAAC,KAAK,EAAE;IACrC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,OAAO,CAAC,EAAE,iBAAiB,CAAC;CAC5B,GAAG,OAAO,CAAC,YAAY,CAAC,CAUxB"}

package/dist/render.js

@@ -0,0 +1,39 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { evaluate } from "@mdx-js/mdx";
+import * as runtime from "react/jsx-runtime";
+import Markdown from "react-markdown";
+import remarkGfm from "remark-gfm";
+import { remarkLimitedMdx } from "./limited-mdx.js";
+export { remarkLimitedMdx, validateLimitedMdx } from "./limited-mdx.js";
+/** Renders a `.md` body. Pure data — the automated publisher's format. */
+export const MarkdownBody = ({ content, elements }) => (_jsx(Markdown, { remarkPlugins: [remarkGfm], components: elements, children: content }));
+/**
+ * Renders an `.mdx` body (async server component). `limited` (default true)
+ * enforces the vocabulary-only trust boundary; Tier-2 posts pass `bespoke`
+ * components, which turns enforcement off — those are human-reviewed code.
+ */
+export async function MdxBody(props) {
+    const limited = props.limited ?? props.bespoke === undefined;
+    const scope = { ...props.components, ...props.bespoke };
+    const remarkPlugins = limited
+        ? [remarkGfm, [remarkLimitedMdx, { allow: Object.keys(scope) }]]
+        : [remarkGfm];
+    const { default: MDXContent } = await evaluate(props.content, {
+        ...runtime,
+        remarkPlugins,
+    });
+    return _jsx(MDXContent, { components: { ...props.elements, ...scope } });
+}
+/** Format-dispatching renderer: the one component a post page needs. */
+export async function PostBody(props) {
+    if (props.post.format === "md") {
+        return _jsx(MarkdownBody, { content: props.post.content, elements: props.elements });
+    }
+    return MdxBody({
+        content: props.post.content,
+        components: props.components,
+        elements: props.elements,
+        bespoke: props.bespoke,
+    });
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAO,KAAK,OAAO,MAAM,mBAAmB,CAAC;AAC7C,OAAO,QAA6B,MAAM,gBAAgB,CAAC;AAC3D,OAAO,SAAS,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGpD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAiBxE,0EAA0E;AAC1E,MAAM,CAAC,MAAM,YAAY,GAGpB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAC/B,KAAC,QAAQ,IAAC,aAAa,EAAE,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,QAAQ,YACxD,OAAO,GACE,CACX,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,KAM7B;IACA,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC;IAC7D,MAAM,KAAK,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;IACxD,MAAM,aAAa,GAAkB,OAAO;QAC3C,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACf,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE;QAC7D,GAAG,OAAO;QACV,aAAa;KACb,CAAC,CAAC;IACH,OAAO,KAAC,UAAU,IAAC,UAAU,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,KAAK,EAAE,GAAI,CAAC;AACpE,CAAC;AAED,wEAAwE;AACxE,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAK9B;IACA,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,KAAC,YAAY,IAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,GAAI,CAAC;IAChF,CAAC;IACD,OAAO,OAAO,CAAC;QACd,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;QAC3B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;KACtB,CAAC,CAAC;AACJ,CAAC"}

package/dist/rss.d.ts

@@ -0,0 +1,18 @@
+import type { BlogPostPreview } from "./types.js";
+export interface RssConfig {
+    title: string;
+    description?: string;
+    /** Absolute site origin, e.g. "https://example.com". */
+    siteUrl: string;
+    /** Path prefix of the blog, e.g. "/posts". */
+    basePath: string;
+    /** Absolute URL the feed is served from, e.g. `${siteUrl}/rss.xml`. */
+    feedUrl: string;
+    language?: string;
+}
+/**
+ * RSS 2.0 feed for a post list. Serve from a route handler (`rss.xml/route.ts`
+ * with `export const dynamic = "force-static"`) so it renders at build.
+ */
+export declare function generateRss(config: RssConfig, posts: BlogPostPreview[]): string;
+//# sourceMappingURL=rss.d.ts.map

package/dist/rss.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rss.d.ts","sourceRoot":"","sources":["../src/rss.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AASD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,MAAM,CAyC/E"}

package/dist/rss.js

@@ -0,0 +1,49 @@
+const escapeXml = (value) => value
+    .replaceAll("&", "&")
+    .replaceAll("<", "&lt;")
+    .replaceAll(">", "&gt;")
+    .replaceAll('"', "&quot;");
+/**
+ * RSS 2.0 feed for a post list. Serve from a route handler (`rss.xml/route.ts`
+ * with `export const dynamic = "force-static"`) so it renders at build.
+ */
+export function generateRss(config, posts) {
+    const items = posts
+        .map((post) => {
+        const url = `${config.siteUrl}${config.basePath}/${post.slug}`;
+        return [
+            "\t\t<item>",
+            `\t\t\t<title>${escapeXml(post.title)}</title>`,
+            `\t\t\t<link>${escapeXml(url)}</link>`,
+            `\t\t\t<guid isPermaLink="true">${escapeXml(url)}</guid>`,
+            `\t\t\t<pubDate>${new Date(post.date).toUTCString()}</pubDate>`,
+            `\t\t\t<description>${escapeXml(post.description)}</description>`,
+            ...post.authors.map((author) => `\t\t\t<dc:creator>${escapeXml(author)}</dc:creator>`),
+            ...(post.category
+                ? [`\t\t\t<category>${escapeXml(post.category)}</category>`]
+                : []),
+            "\t\t</item>",
+        ].join("\n");
+    })
+        .join("\n");
+    return [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">',
+        "\t<channel>",
+        `\t\t<title>${escapeXml(config.title)}</title>`,
+        `\t\t<link>${escapeXml(config.siteUrl + config.basePath)}</link>`,
+        `\t\t<description>${escapeXml(config.description ?? config.title)}</description>`,
+        `\t\t<language>${escapeXml(config.language ?? "en")}</language>`,
+        `\t\t<atom:link href="${escapeXml(config.feedUrl)}" rel="self" type="application/rss+xml"/>`,
+        ...(posts[0]
+            ? [
+                `\t\t<lastBuildDate>${new Date(posts[0].date).toUTCString()}</lastBuildDate>`,
+            ]
+            : []),
+        items,
+        "\t</channel>",
+        "</rss>",
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=rss.js.map

package/dist/rss.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rss.js","sourceRoot":"","sources":["../src/rss.ts"],"names":[],"mappings":"AAcA,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE,CAC3C,KAAK;KACH,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;KACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;KACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;KACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAiB,EAAE,KAAwB;IACtE,MAAM,KAAK,GAAG,KAAK;SACjB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/D,OAAO;YACN,YAAY;YACZ,gBAAgB,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU;YAC/C,eAAe,SAAS,CAAC,GAAG,CAAC,SAAS;YACtC,kCAAkC,SAAS,CAAC,GAAG,CAAC,SAAS;YACzD,kBAAkB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,YAAY;YAC/D,sBAAsB,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,gBAAgB;YACjE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAClB,CAAC,MAAM,EAAE,EAAE,CAAC,qBAAqB,SAAS,CAAC,MAAM,CAAC,eAAe,CACjE;YACD,GAAG,CAAC,IAAI,CAAC,QAAQ;gBAChB,CAAC,CAAC,CAAC,mBAAmB,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;gBAC5D,CAAC,CAAC,EAAE,CAAC;YACN,aAAa;SACb,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACd,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACN,wCAAwC;QACxC,0GAA0G;QAC1G,aAAa;QACb,cAAc,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU;QAC/C,aAAa,SAAS,CAAC,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS;QACjE,oBAAoB,SAAS,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC,gBAAgB;QACjF,iBAAiB,SAAS,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,aAAa;QAChE,wBAAwB,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,2CAA2C;QAC5F,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;YACX,CAAC,CAAC;gBACA,sBAAsB,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,kBAAkB;aAC7E;YACF,CAAC,CAAC,EAAE,CAAC;QACN,KAAK;QACL,cAAc;QACd,QAAQ;QACR,EAAE;KACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/schema.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+/**
+ * The shared frontmatter contract. Every post on every site validates against
+ * this; unknown keys are preserved-ignored (sites may carry extras locally).
+ *
+ * Normalizations: `coverImage` is accepted as an alias of `image`; `author`
+ * (string or list) and `authors` collapse into a single `authors: string[]`.
+ */
+export declare const blogFrontmatterSchema: z.ZodPipe<z.ZodObject<{
+    title: z.ZodString;
+    seoTitle: z.ZodOptional<z.ZodString>;
+    description: z.ZodString;
+    date: z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodDate]>, z.ZodTransform<string, string | Date>>;
+    updated: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodDate]>, z.ZodTransform<string, string | Date>>>;
+    author: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    authors: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    category: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    image: z.ZodOptional<z.ZodString>;
+    coverImage: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    draft: z.ZodDefault<z.ZodBoolean>;
+    featured: z.ZodDefault<z.ZodBoolean>;
+    lang: z.ZodOptional<z.ZodString>;
+    canonical: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodTransform<{
+    image: string | undefined;
+    authors: string[];
+    title: string;
+    description: string;
+    date: string;
+    tags: string[];
+    draft: boolean;
+    featured: boolean;
+    seoTitle?: string | undefined;
+    updated?: string | undefined;
+    category?: string | undefined;
+    slug?: string | undefined;
+    lang?: string | undefined;
+    canonical?: string | undefined;
+}, {
+    title: string;
+    description: string;
+    date: string;
+    tags: string[];
+    draft: boolean;
+    featured: boolean;
+    seoTitle?: string | undefined;
+    updated?: string | undefined;
+    author?: string | string[] | undefined;
+    authors?: string[] | undefined;
+    category?: string | undefined;
+    image?: string | undefined;
+    coverImage?: string | undefined;
+    slug?: string | undefined;
+    lang?: string | undefined;
+    canonical?: string | undefined;
+}>>;
+export type BlogFrontmatter = z.infer<typeof blogFrontmatterSchema>;
+export type BlogFrontmatterInput = z.input<typeof blogFrontmatterSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkBxB;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwB9B,CAAC;AAEL,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/schema.js

@@ -0,0 +1,48 @@
+import { z } from "zod";
+// YAML (via gray-matter) parses bare dates like `2026-04-30` into Date objects
+// and quoted ones into strings — accept both, emit ISO 8601.
+const isoDate = z.union([z.string(), z.date()]).transform((value, ctx) => {
+    const parsed = value instanceof Date ? value : new Date(value);
+    if (Number.isNaN(parsed.getTime())) {
+        ctx.addIssue({
+            code: "custom",
+            message: `Invalid date "${String(value)}". Use ISO format (YYYY-MM-DD).`,
+        });
+        return z.NEVER;
+    }
+    return parsed.toISOString();
+});
+const nonEmpty = z.string().trim().min(1);
+/**
+ * The shared frontmatter contract. Every post on every site validates against
+ * this; unknown keys are preserved-ignored (sites may carry extras locally).
+ *
+ * Normalizations: `coverImage` is accepted as an alias of `image`; `author`
+ * (string or list) and `authors` collapse into a single `authors: string[]`.
+ */
+export const blogFrontmatterSchema = z
+    .object({
+    title: nonEmpty,
+    seoTitle: nonEmpty.optional(),
+    description: nonEmpty,
+    date: isoDate,
+    updated: isoDate.optional(),
+    author: z.union([nonEmpty, z.array(nonEmpty)]).optional(),
+    authors: z.array(nonEmpty).optional(),
+    category: nonEmpty.optional(),
+    tags: z.array(nonEmpty).default([]),
+    image: nonEmpty.optional(),
+    coverImage: nonEmpty.optional(),
+    slug: nonEmpty.optional(),
+    draft: z.boolean().default(false),
+    featured: z.boolean().default(false),
+    // Reserved fields — validated now so adding behavior later isn't breaking.
+    lang: nonEmpty.optional(),
+    canonical: nonEmpty.optional(),
+})
+    .transform(({ author, authors, coverImage, image, ...rest }) => ({
+    ...rest,
+    image: image ?? coverImage,
+    authors: authors ?? (Array.isArray(author) ? author : author ? [author] : []),
+}));
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,+EAA+E;AAC/E,6DAA6D;AAC7D,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IACxE,MAAM,MAAM,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/D,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACpC,GAAG,CAAC,QAAQ,CAAC;YACZ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,iBAAiB,MAAM,CAAC,KAAK,CAAC,iCAAiC;SACxE,CAAC,CAAC;QACH,OAAO,CAAC,CAAC,KAAK,CAAC;IAChB,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEH,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE1C;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACpC,MAAM,CAAC;IACP,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,QAAQ;IACrB,IAAI,EAAE,OAAO;IACb,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE;IACrC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,KAAK,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC1B,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC/B,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE;IACzB,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACjC,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACpC,2EAA2E;IAC3E,IAAI,EAAE,QAAQ,CAAC,QAAQ,EAAE;IACzB,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE;CAC9B,CAAC;KACD,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAChE,GAAG,IAAI;IACP,KAAK,EAAE,KAAK,IAAI,UAAU;IAC1B,OAAO,EAAE,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;CAC7E,CAAC,CAAC,CAAC"}

package/dist/seo.d.ts

@@ -0,0 +1,18 @@
+import { type ArticleInput, type ArticleNode, type BreadcrumbListNode, type OrganizationInput, type WithContext } from "@ingram-tech/nk-seo";
+import type { BlogPostPreview } from "./types.js";
+export interface BlogSeoConfig {
+    /** Absolute site origin, e.g. "https://example.com". */
+    baseUrl: string;
+    /** Path prefix of the blog, e.g. "/posts" or "/blog". */
+    basePath: string;
+    /** Injected as the article publisher when provided. */
+    publisher?: OrganizationInput;
+    /** Crumb label for the blog index; defaults to "Blog". */
+    blogName?: string;
+}
+export declare function postUrl(post: BlogPostPreview, config: BlogSeoConfig): string;
+/** BlogPosting JSON-LD for a post — the nk-seo bridge. */
+export declare function blogPostArticle(post: BlogPostPreview, config: BlogSeoConfig, overrides?: Partial<ArticleInput>): WithContext<ArticleNode>;
+/** Home → Blog → Post breadcrumb JSON-LD. */
+export declare function blogPostBreadcrumbs(post: BlogPostPreview, config: BlogSeoConfig): WithContext<BreadcrumbListNode>;
+//# sourceMappingURL=seo.d.ts.map

package/dist/seo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.d.ts","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,WAAW,EAEhB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,aAAa;IAC7B,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,uDAAuD;IACvD,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,CAE5E;AAKD,0DAA0D;AAC1D,wBAAgB,eAAe,CAC9B,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,aAAa,EACrB,SAAS,GAAE,OAAO,CAAC,YAAY,CAAM,GACnC,WAAW,CAAC,WAAW,CAAC,CAc1B;AAED,6CAA6C;AAC7C,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,aAAa,GACnB,WAAW,CAAC,kBAAkB,CAAC,CAMjC"}

package/dist/seo.js

@@ -0,0 +1,30 @@
+import { article, breadcrumbList, } from "@ingram-tech/nk-seo";
+export function postUrl(post, config) {
+    return `${config.baseUrl}${config.basePath}/${post.slug}`;
+}
+const absoluteImage = (image, baseUrl) => image.startsWith("/") ? `${baseUrl}${image}` : image;
+/** BlogPosting JSON-LD for a post — the nk-seo bridge. */
+export function blogPostArticle(post, config, overrides = {}) {
+    return article({
+        type: "BlogPosting",
+        headline: post.title,
+        description: post.description,
+        url: post.canonical ?? postUrl(post, config),
+        datePublished: post.date,
+        dateModified: post.updated,
+        authors: post.authors.map((name) => ({ name })),
+        image: post.image ? absoluteImage(post.image, config.baseUrl) : undefined,
+        keywords: post.tags.length ? post.tags : undefined,
+        publisher: config.publisher,
+        ...overrides,
+    });
+}
+/** Home → Blog → Post breadcrumb JSON-LD. */
+export function blogPostBreadcrumbs(post, config) {
+    return breadcrumbList([
+        { name: "Home", url: config.baseUrl },
+        { name: config.blogName ?? "Blog", url: `${config.baseUrl}${config.basePath}` },
+        { name: post.title, url: postUrl(post, config) },
+    ]);
+}
+//# sourceMappingURL=seo.js.map

package/dist/seo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo.js","sourceRoot":"","sources":["../src/seo.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,OAAO,EAGP,cAAc,GAId,MAAM,qBAAqB,CAAC;AAc7B,MAAM,UAAU,OAAO,CAAC,IAAqB,EAAE,MAAqB;IACnE,OAAO,GAAG,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,aAAa,GAAG,CAAC,KAAa,EAAE,OAAe,EAAU,EAAE,CAChE,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AAEtD,0DAA0D;AAC1D,MAAM,UAAU,eAAe,CAC9B,IAAqB,EACrB,MAAqB,EACrB,YAAmC,EAAE;IAErC,OAAO,OAAO,CAAC;QACd,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,IAAI,CAAC,KAAK;QACpB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,GAAG,EAAE,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;QAC5C,aAAa,EAAE,IAAI,CAAC,IAAI;QACxB,YAAY,EAAE,IAAI,CAAC,OAAO;QAC1B,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;QACzE,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAClD,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,GAAG,SAAS;KACZ,CAAC,CAAC;AACJ,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,mBAAmB,CAClC,IAAqB,EACrB,MAAqB;IAErB,OAAO,cAAc,CAAC;QACrB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,EAAE;QACrC,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,QAAQ,EAAE,EAAE;QAC/E,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE;KAChD,CAAC,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+export { createBlog, parsePost, parsePostFileName, type Blog, type BlogConfig, type BlogSource, type RawPostFile, } from "./blog.js";
+export { fsSource } from "./sources/fs.js";
+export { githubSource, type GitHubRepoConfig } from "./sources/github.js";
+export { publishPost, serializePost, type PublishedPost, type PublishPostInput, } from "./sources/publish.js";
+export { generateRss, type RssConfig } from "./rss.js";
+export { keys } from "./keys.js";
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,EACjB,KAAK,IAAI,EACT,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,GAChB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACN,WAAW,EACX,aAAa,EACb,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/server.js

@@ -0,0 +1,10 @@
+// Server entry: everything that touches the filesystem, the GitHub API, or
+// env. Import from pages/route handlers/scripts only — never from client
+// components (the root "." export carries the types you need there).
+export { createBlog, parsePost, parsePostFileName, } from "./blog.js";
+export { fsSource } from "./sources/fs.js";
+export { githubSource } from "./sources/github.js";
+export { publishPost, serializePost, } from "./sources/publish.js";
+export { generateRss } from "./rss.js";
+export { keys } from "./keys.js";
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,yEAAyE;AACzE,qEAAqE;AACrE,OAAO,EACN,UAAU,EACV,SAAS,EACT,iBAAiB,GAKjB,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAyB,MAAM,qBAAqB,CAAC;AAC1E,OAAO,EACN,WAAW,EACX,aAAa,GAGb,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAkB,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC"}

package/dist/sources/fs.d.ts

@@ -0,0 +1,12 @@
+import type { BlogSource } from "../blog.js";
+/**
+ * Build-time filesystem source. The blog contract is full SSG: call this from
+ * `generateStaticParams`-driven pages (with `dynamicParams = false`), sitemap
+ * and RSS route handlers — all of which run at build. It must NOT be relied on
+ * at request time on serverless hosts: output file tracing does not follow
+ * `fs` reads made inside a published package, so the content directory may be
+ * absent from the deployed function (`outputFileTracingIncludes` is the escape
+ * hatch if you truly need runtime reads).
+ */
+export declare function fsSource(dir: string): BlogSource;
+//# sourceMappingURL=fs.d.ts.map

package/dist/sources/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/sources/fs.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,YAAY,CAAC;AAE1D;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CA6ChD"}

package/dist/sources/fs.js

@@ -0,0 +1,54 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+/**
+ * Build-time filesystem source. The blog contract is full SSG: call this from
+ * `generateStaticParams`-driven pages (with `dynamicParams = false`), sitemap
+ * and RSS route handlers — all of which run at build. It must NOT be relied on
+ * at request time on serverless hosts: output file tracing does not follow
+ * `fs` reads made inside a published package, so the content directory may be
+ * absent from the deployed function (`outputFileTracingIncludes` is the escape
+ * hatch if you truly need runtime reads).
+ */
+export function fsSource(dir) {
+    const root = path.isAbsolute(dir) ? dir : path.join(process.cwd(), dir);
+    return {
+        async load() {
+            let entries;
+            try {
+                entries = await fs.readdir(root, { withFileTypes: true });
+            }
+            catch (error) {
+                if (error instanceof Error &&
+                    "code" in error &&
+                    error.code === "ENOENT") {
+                    return [];
+                }
+                throw error;
+            }
+            const names = [];
+            for (const entry of entries) {
+                if (entry.isFile() && /\.mdx?$/.test(entry.name)) {
+                    names.push(entry.name);
+                }
+                else if (entry.isDirectory()) {
+                    // Folder post: <slug>/index.md(x) with colocated assets/code.
+                    for (const index of ["index.mdx", "index.md"]) {
+                        try {
+                            await fs.access(path.join(root, entry.name, index));
+                            names.push(`${entry.name}/${index}`);
+                            break;
+                        }
+                        catch {
+                            // keep looking
+                        }
+                    }
+                }
+            }
+            return Promise.all(names.map(async (name) => ({
+                name,
+                content: await fs.readFile(path.join(root, name), "utf8"),
+            })));
+        },
+    };
+}
+//# sourceMappingURL=fs.js.map