@ingram-tech/nk-blog 0.1.0

package/README.md

@@ -0,0 +1,78 @@
+# @ingram-tech/nk-blog
+
+File-based blogs for Next.js sites: one frontmatter contract, a build-time
+reader, `.md`/limited-`.mdx` rendering, a typed component vocabulary with
+unstyled defaults, GitHub read/publish for automated publishers, and RSS.
+
+**The files are the index.** Posts are `content/blog/<slug>.md` (or `.mdx`,
+or `<slug>/index.mdx` folders) with YAML frontmatter. There is no generated
+`posts.json`, no metadata-extraction script, and nothing to drift.
+
+## Entry points
+
+| Import | Contents | Where |
+|---|---|---|
+| `@ingram-tech/nk-blog` | frontmatter schema, types, vocabulary manifest, reading time, dates, JSON-LD bridge | anywhere |
+| `@ingram-tech/nk-blog/server` | `createBlog`, `fsSource`, `githubSource`, `publishPost`, `serializePost`, `generateRss`, `keys` | server only |
+| `@ingram-tech/nk-blog/render` | `PostBody`, `MarkdownBody`, `MdxBody`, `remarkLimitedMdx`, `validateLimitedMdx` | server components |
+| `@ingram-tech/nk-blog/unstyled` | behavior-correct, zero-styling vocabulary defaults | server components |
+
+## Site setup
+
+```ts
+// src/lib/blog.ts
+import { createBlog, fsSource } from "@ingram-tech/nk-blog/server";
+
+export const blog = createBlog({
+	source: fsSource("content/blog"),
+	defaultAuthor: "Example Team",
+	drafts: process.env.NODE_ENV !== "production",
+});
+```
+
+```tsx
+// src/lib/blog-components.tsx — the site's entire vocabulary obligation
+import { defineBlogComponents } from "@ingram-tech/nk-blog";
+import { unstyled } from "@ingram-tech/nk-blog/unstyled";
+
+export const blogComponents = defineBlogComponents({
+	...unstyled,
+	// Callout: BrandCallout, — replace wholesale where the brand cares
+});
+```
+
+```tsx
+// src/app/blog/[slug]/page.tsx — full SSG, no runtime fs
+import { PostBody } from "@ingram-tech/nk-blog/render";
+import { blog } from "@/lib/blog";
+import { blogComponents } from "@/lib/blog-components";
+import { mdxElements } from "@/mdx-components"; // the site's own element map
+
+export const dynamicParams = false;
+export async function generateStaticParams() {
+	return (await blog.slugs()).map((slug) => ({ slug }));
+}
+
+export default async function Post({ params }: PageProps<"/blog/[slug]">) {
+	const { slug } = await params;
+	const post = await blog.post(slug);
+	if (!post) notFound();
+	return <PostBody post={post} components={blogComponents} elements={mdxElements} />;
+}
+```
+
+## The rules that keep this portable
+
+- **Vocabulary, not imports.** A Tier-1 post references `<Callout>`, `<Figure>`,
+  `<YouTube>`, `<Tweet>`, `<NewsletterSubscribe>` by bare name and nothing
+  else. `render` enforces this in the AST (`remarkLimitedMdx`): no ESM, no
+  `{…}` expressions, literal props only. Automated publishers emit `.md` (pure
+  data) and validate `.mdx` with `validateLimitedMdx` before committing.
+- **Tier-2 (bespoke) posts** are folders with human-reviewed `components.tsx`,
+  passed via `bespoke` — which relaxes enforcement, because a human merged it.
+- **No pixels in this package.** The unstyled defaults carry semantics and
+  behavior only and accept no visual props beyond `className`. Want variation?
+  Replace the component in your registry — never add props here.
+- **Build-time only.** `fsSource` runs under `generateStaticParams` /
+  `dynamicParams = false`; serverless functions must not read post files at
+  request time (output tracing won't include them).

package/dist/blog.d.ts

@@ -0,0 +1,54 @@
+import type { BlogPost, BlogPostPreview, PostFormat } from "./types.js";
+/** A content file, named relative to the content dir ("slug.md", "slug/index.mdx"). */
+export interface RawPostFile {
+    name: string;
+    content: string;
+}
+export interface BlogSource {
+    load(): Promise<RawPostFile[]>;
+}
+export interface BlogConfig {
+    source: BlogSource;
+    /** Byline when a post declares none (each site sets its own). */
+    defaultAuthor?: string;
+    defaultCategory?: string;
+    wordsPerMinute?: number;
+    /** Include drafts (listing pages typically pass `NODE_ENV !== "production"`). */
+    drafts?: boolean;
+    /**
+     * Site-specific image fallback (e.g. "look in /public/images/posts/<slug>").
+     * This is config precisely so per-site divergence never forks the reader.
+     */
+    resolveImage?: (post: {
+        slug: string;
+        image?: string;
+    }) => string | undefined;
+    /**
+     * "throw" (default) fails the build on malformed frontmatter — a real post
+     * silently missing from a site is worse than a red build. Remote sources
+     * (admin listing over GitHub) prefer "skip" to keep one bad file from
+     * hiding a whole target.
+     */
+    onInvalid?: "throw" | "skip";
+}
+export interface Blog {
+    /** All non-draft posts, newest first, with bodies. */
+    posts(): Promise<BlogPost[]>;
+    /** All non-draft posts, newest first, without bodies. */
+    previews(): Promise<BlogPostPreview[]>;
+    post(slug: string): Promise<BlogPost | null>;
+    slugs(): Promise<string[]>;
+    /** The pinned (`featured: true`) post, else the newest. */
+    featured(): Promise<BlogPost | null>;
+}
+interface ParsedName {
+    slug: string;
+    format: PostFormat;
+    draftByName: boolean;
+}
+/** "slug.md", "slug.mdx", "slug/index.md(x)" → slug + format; else null. */
+export declare function parsePostFileName(name: string): ParsedName | null;
+export declare function parsePost(file: RawPostFile, config: BlogConfig): BlogPost | null;
+export declare function createBlog(config: BlogConfig): Blog;
+export {};
+//# sourceMappingURL=blog.d.ts.map

package/dist/blog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog.d.ts","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExE,uFAAuF;AACvF,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;;OAGG;IACH,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,GAAG,SAAS,CAAC;IAC9E;;;;;OAKG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,IAAI;IACpB,sDAAsD;IACtD,KAAK,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC7B,yDAAyD;IACzD,QAAQ,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC7C,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,IAAI,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;CACrC;AAID,UAAU,UAAU;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAYjE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,IAAI,CAuDhF;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAmCnD"}

package/dist/blog.js

@@ -0,0 +1,99 @@
+import matter from "gray-matter";
+import { blogFrontmatterSchema } from "./schema.js";
+import { DEFAULT_WORDS_PER_MINUTE, readingTime } from "./reading-time.js";
+const POST_FILE = /^(?:(?<flat>[^/]+)|(?<dir>[^/]+)\/index)\.(?<ext>mdx?)$/;
+/** "slug.md", "slug.mdx", "slug/index.md(x)" → slug + format; else null. */
+export function parsePostFileName(name) {
+    const match = POST_FILE.exec(name);
+    const groups = match?.groups;
+    if (!groups)
+        return null;
+    const base = groups.flat ?? groups.dir;
+    if (!base)
+        return null;
+    return {
+        slug: base.replace(/^_/, ""),
+        format: groups.ext === "mdx" ? "mdx" : "md",
+        // Legacy `_draft.md` convention, honored as an alias of `draft: true`.
+        draftByName: base.startsWith("_"),
+    };
+}
+export function parsePost(file, config) {
+    const named = parsePostFileName(file.name);
+    if (!named)
+        return null;
+    const { data, content } = matter(file.content);
+    const result = blogFrontmatterSchema.safeParse(data);
+    if (!result.success) {
+        if ((config.onInvalid ?? "throw") === "skip") {
+            console.warn(`nk-blog: skipping ${file.name}: ${result.error.issues
+                .map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+                .join("; ")}`);
+            return null;
+        }
+        throw new Error(`nk-blog: invalid frontmatter in ${file.name}: ${result.error.issues
+            .map((issue) => `${issue.path.join(".")}: ${issue.message}`)
+            .join("; ")}`);
+    }
+    const frontmatter = result.data;
+    const slug = frontmatter.slug ?? named.slug;
+    const body = content.trim();
+    const authors = frontmatter.authors.length
+        ? frontmatter.authors
+        : config.defaultAuthor
+            ? [config.defaultAuthor]
+            : [];
+    const time = readingTime(body, config.wordsPerMinute ?? DEFAULT_WORDS_PER_MINUTE);
+    const image = config.resolveImage?.({ slug, image: frontmatter.image }) ?? frontmatter.image;
+    return {
+        slug,
+        title: frontmatter.title,
+        seoTitle: frontmatter.seoTitle,
+        description: frontmatter.description,
+        date: frontmatter.date,
+        updated: frontmatter.updated,
+        authors,
+        author: authors[0] ?? "",
+        category: frontmatter.category ?? config.defaultCategory,
+        tags: frontmatter.tags,
+        image,
+        draft: frontmatter.draft || named.draftByName,
+        featured: frontmatter.featured,
+        lang: frontmatter.lang,
+        canonical: frontmatter.canonical,
+        format: named.format,
+        readingTimeMinutes: time.minutes,
+        readTime: time.text,
+        content: body,
+    };
+}
+export function createBlog(config) {
+    const posts = async () => {
+        const files = await config.source.load();
+        const parsed = files
+            .map((file) => parsePost(file, config))
+            .filter((post) => post !== null)
+            .filter((post) => config.drafts === true || !post.draft);
+        const seen = new Map();
+        for (const post of parsed) {
+            if (seen.has(post.slug)) {
+                // Two files resolving to one slug is a routing conflict — always
+                // a loud build failure, never a quiet last-one-wins.
+                throw new Error(`nk-blog: duplicate slug "${post.slug}"`);
+            }
+            seen.set(post.slug, post);
+        }
+        return [...seen.values()].sort((a, b) => new Date(b.date).getTime() - new Date(a.date).getTime());
+    };
+    return {
+        posts,
+        previews: async () => (await posts()).map(({ content: _content, ...preview }) => preview),
+        post: async (slug) => (await posts()).find((candidate) => candidate.slug === slug) ?? null,
+        slugs: async () => (await posts()).map((post) => post.slug),
+        featured: async () => {
+            const all = await posts();
+            return all.find((post) => post.featured) ?? all[0] ?? null;
+        },
+    };
+}
+//# sourceMappingURL=blog.js.map

package/dist/blog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog.js","sourceRoot":"","sources":["../src/blog.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AA8C1E,MAAM,SAAS,GAAG,yDAAyD,CAAC;AAQ5E,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC7C,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,KAAK,EAAE,MAAM,CAAC;IAC7B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,GAAG,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO;QACN,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI;QAC3C,uEAAuE;QACvE,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;KACjC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAiB,EAAE,MAAkB;IAC9D,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,qBAAqB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CACX,qBAAqB,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM;iBACpD,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;iBAC3D,IAAI,CAAC,IAAI,CAAC,EAAE,CACd,CAAC;YACF,OAAO,IAAI,CAAC;QACb,CAAC;QACD,MAAM,IAAI,KAAK,CACd,mCAAmC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM;aAClE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aAC3D,IAAI,CAAC,IAAI,CAAC,EAAE,CACd,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;IAChC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAC5B,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,MAAM;QACzC,CAAC,CAAC,WAAW,CAAC,OAAO;QACrB,CAAC,CAAC,MAAM,CAAC,aAAa;YACrB,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;YACxB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,cAAc,IAAI,wBAAwB,CAAC,CAAC;IAClF,MAAM,KAAK,GACV,MAAM,CAAC,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC;IAEhF,OAAO;QACN,IAAI;QACJ,KAAK,EAAE,WAAW,CAAC,KAAK;QACxB,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,WAAW,EAAE,WAAW,CAAC,WAAW;QACpC,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,OAAO,EAAE,WAAW,CAAC,OAAO;QAC5B,OAAO;QACP,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE;QACxB,QAAQ,EAAE,WAAW,CAAC,QAAQ,IAAI,MAAM,CAAC,eAAe;QACxD,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,KAAK;QACL,KAAK,EAAE,WAAW,CAAC,KAAK,IAAI,KAAK,CAAC,WAAW;QAC7C,QAAQ,EAAE,WAAW,CAAC,QAAQ;QAC9B,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,SAAS,EAAE,WAAW,CAAC,SAAS;QAChC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,kBAAkB,EAAE,IAAI,CAAC,OAAO;QAChC,QAAQ,EAAE,IAAI,CAAC,IAAI;QACnB,OAAO,EAAE,IAAI;KACb,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC5C,MAAM,KAAK,GAAG,KAAK,IAAyB,EAAE;QAC7C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACzC,MAAM,MAAM,GAAG,KAAK;aAClB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;aACtC,MAAM,CAAC,CAAC,IAAI,EAAoB,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC;aACjD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE1D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzB,iEAAiE;gBACjE,qDAAqD;gBACrD,MAAM,IAAI,KAAK,CAAC,4BAA4B,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;YAC3D,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAC7B,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,CACjE,CAAC;IACH,CAAC,CAAC;IAEF,OAAO;QACN,KAAK;QACL,QAAQ,EAAE,KAAK,IAAI,EAAE,CACpB,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC;QACpE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACpB,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI;QACrE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;QAC3D,QAAQ,EAAE,KAAK,IAAI,EAAE;YACpB,MAAM,GAAG,GAAG,MAAM,KAAK,EAAE,CAAC;YAC1B,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC5D,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/contract.d.ts

@@ -0,0 +1,102 @@
+import type { ComponentType, ReactNode } from "react";
+import { z } from "zod";
+/**
+ * The vocabulary manifest — the cross-site component contract.
+ *
+ * A Tier-1 post may reference exactly these components by bare name. The
+ * package owns the names and prop schemas; each site owns the pixels (see
+ * `@ingram-tech/nk-blog/unstyled` for the behavior-correct defaults). The
+ * admin publisher validates a post against this manifest (at the version the
+ * target site pins) before committing it.
+ */
+export declare const VOCABULARY: readonly ["Callout", "Figure", "YouTube", "Tweet", "NewsletterSubscribe"];
+export type VocabularyName = (typeof VOCABULARY)[number];
+export declare const calloutProps: z.ZodObject<{
+    variant: z.ZodDefault<z.ZodEnum<{
+        note: "note";
+        tip: "tip";
+        warning: "warning";
+        important: "important";
+    }>>;
+    title: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const figureProps: z.ZodObject<{
+    src: z.ZodString;
+    alt: z.ZodString;
+    caption: z.ZodOptional<z.ZodString>;
+    width: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    height: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+}, z.core.$strip>;
+export declare const youTubeProps: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    start: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+}, z.core.$strip>;
+export declare const tweetProps: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+export declare const newsletterSubscribeProps: z.ZodObject<{
+    action: z.ZodString;
+    placeholder: z.ZodOptional<z.ZodString>;
+    buttonLabel: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Machine-checkable side of the contract, keyed by component name. */
+export declare const vocabularyProps: {
+    Callout: z.ZodObject<{
+        variant: z.ZodDefault<z.ZodEnum<{
+            note: "note";
+            tip: "tip";
+            warning: "warning";
+            important: "important";
+        }>>;
+        title: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    Figure: z.ZodObject<{
+        src: z.ZodString;
+        alt: z.ZodString;
+        caption: z.ZodOptional<z.ZodString>;
+        width: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+        height: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    }, z.core.$strip>;
+    YouTube: z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        start: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
+    }, z.core.$strip>;
+    Tweet: z.ZodObject<{
+        id: z.ZodString;
+    }, z.core.$strip>;
+    NewsletterSubscribe: z.ZodObject<{
+        action: z.ZodString;
+        placeholder: z.ZodOptional<z.ZodString>;
+        buttonLabel: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+};
+type WithReactExtras<T> = T & {
+    children?: ReactNode;
+    className?: string;
+};
+export type CalloutProps = WithReactExtras<z.input<typeof calloutProps>>;
+export type FigureProps = WithReactExtras<z.input<typeof figureProps>>;
+export type YouTubeProps = WithReactExtras<z.input<typeof youTubeProps>>;
+export type TweetProps = WithReactExtras<z.input<typeof tweetProps>>;
+export type NewsletterSubscribeProps = WithReactExtras<z.input<typeof newsletterSubscribeProps>>;
+export interface VocabularyPropsMap {
+    Callout: CalloutProps;
+    Figure: FigureProps;
+    YouTube: YouTubeProps;
+    Tweet: TweetProps;
+    NewsletterSubscribe: NewsletterSubscribeProps;
+}
+/**
+ * The exhaustive registry a site must provide. Exhaustiveness is the point:
+ * a site missing a vocabulary component fails `tsc`, so an admin-published
+ * post can never reference something a site cannot render.
+ */
+export type BlogComponents = {
+    [K in VocabularyName]: ComponentType<VocabularyPropsMap[K]>;
+};
+/** Identity helper — exists purely for inference and error locality. */
+export declare function defineBlogComponents(components: BlogComponents): BlogComponents;
+export {};
+//# sourceMappingURL=contract.d.ts.map

package/dist/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,2EAMb,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAMzD,eAAO,MAAM,YAAY;;;;;;;;iBAGvB,CAAC;AAEH,eAAO,MAAM,WAAW;;;;;;iBAMtB,CAAC;AAEH,eAAO,MAAM,YAAY;;;;iBAIvB,CAAC;AAEH,eAAO,MAAM,UAAU;;iBAErB,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;iBAInC,CAAC;AAEH,uEAAuE;AACvE,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAMiB,CAAC;AAI9C,KAAK,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,MAAM,MAAM,YAAY,GAAG,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AACzE,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC;AACvE,MAAM,MAAM,YAAY,GAAG,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC;AACzE,MAAM,MAAM,UAAU,GAAG,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC;AACrE,MAAM,MAAM,wBAAwB,GAAG,eAAe,CACrD,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CACxC,CAAC;AAEF,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;IAClB,mBAAmB,EAAE,wBAAwB,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;KAC3B,CAAC,IAAI,cAAc,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAC3D,CAAC;AAEF,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,cAAc,GAAG,cAAc,CAE/E"}

package/dist/contract.js

@@ -0,0 +1,57 @@
+import { z } from "zod";
+/**
+ * The vocabulary manifest — the cross-site component contract.
+ *
+ * A Tier-1 post may reference exactly these components by bare name. The
+ * package owns the names and prop schemas; each site owns the pixels (see
+ * `@ingram-tech/nk-blog/unstyled` for the behavior-correct defaults). The
+ * admin publisher validates a post against this manifest (at the version the
+ * target site pins) before committing it.
+ */
+export const VOCABULARY = [
+    "Callout",
+    "Figure",
+    "YouTube",
+    "Tweet",
+    "NewsletterSubscribe",
+];
+// MDX literal attributes arrive as strings (`width="1200"`), so dimension-ish
+// props coerce rather than demand numbers.
+const dimension = z.union([z.number(), z.string().regex(/^\d+$/)]);
+export const calloutProps = z.object({
+    variant: z.enum(["note", "tip", "warning", "important"]).default("note"),
+    title: z.string().optional(),
+});
+export const figureProps = z.object({
+    src: z.string().min(1),
+    alt: z.string(),
+    caption: z.string().optional(),
+    width: dimension.optional(),
+    height: dimension.optional(),
+});
+export const youTubeProps = z.object({
+    id: z.string().min(1),
+    title: z.string().optional(),
+    start: dimension.optional(),
+});
+export const tweetProps = z.object({
+    id: z.string().min(1),
+});
+export const newsletterSubscribeProps = z.object({
+    action: z.string().min(1),
+    placeholder: z.string().optional(),
+    buttonLabel: z.string().optional(),
+});
+/** Machine-checkable side of the contract, keyed by component name. */
+export const vocabularyProps = {
+    Callout: calloutProps,
+    Figure: figureProps,
+    YouTube: youTubeProps,
+    Tweet: tweetProps,
+    NewsletterSubscribe: newsletterSubscribeProps,
+};
+/** Identity helper — exists purely for inference and error locality. */
+export function defineBlogComponents(components) {
+    return components;
+}
+//# sourceMappingURL=contract.js.map

package/dist/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACzB,SAAS;IACT,QAAQ;IACR,SAAS;IACT,OAAO;IACP,qBAAqB;CACZ,CAAC;AAIX,8EAA8E;AAC9E,2CAA2C;AAC3C,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAEnE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACxE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IACf,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC3B,MAAM,EAAE,SAAS,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE;CAC3B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACrB,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,uEAAuE;AACvE,MAAM,CAAC,MAAM,eAAe,GAAG;IAC9B,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,KAAK,EAAE,UAAU;IACjB,mBAAmB,EAAE,wBAAwB;CACD,CAAC;AA+B9C,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,UAA0B;IAC9D,OAAO,UAAU,CAAC;AACnB,CAAC"}

package/dist/date.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The one post-date formatter (one site shipped two of these). Defaults to the
+ * long-form English style every site currently renders: "April 30, 2026".
+ */
+export declare function formatPostDate(isoDate: string, locale?: string, options?: Intl.DateTimeFormatOptions): string;
+//# sourceMappingURL=date.d.ts.map

package/dist/date.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.d.ts","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,cAAc,CAC7B,OAAO,EAAE,MAAM,EACf,MAAM,SAAO,EACb,OAAO,GAAE,IAAI,CAAC,qBAIb,GACC,MAAM,CAER"}

package/dist/date.js

@@ -0,0 +1,12 @@
+/**
+ * The one post-date formatter (one site shipped two of these). Defaults to the
+ * long-form English style every site currently renders: "April 30, 2026".
+ */
+export function formatPostDate(isoDate, locale = "en", options = {
+    year: "numeric",
+    month: "long",
+    day: "numeric",
+}) {
+    return new Intl.DateTimeFormat(locale, options).format(new Date(isoDate));
+}
+//# sourceMappingURL=date.js.map

package/dist/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../src/date.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC7B,OAAe,EACf,MAAM,GAAG,IAAI,EACb,UAAsC;IACrC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,SAAS;CACd;IAED,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3E,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,3 @@
+export declare function toErrorMessage(error: unknown): string;
+export declare function assertResponseOk(response: Response, message: string): Promise<void>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAErD;AAED,wBAAsB,gBAAgB,CACrC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/http.js

@@ -0,0 +1,10 @@
+export function toErrorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+export async function assertResponseOk(response, message) {
+    if (response.ok)
+        return;
+    const body = await response.text().catch(() => "");
+    throw new Error(`${message}: ${response.status} ${response.statusText}${body ? ` — ${body.slice(0, 300)}` : ""}`);
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,QAAkB,EAClB,OAAe;IAEf,IAAI,QAAQ,CAAC,EAAE;QAAE,OAAO;IACxB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACnD,MAAM,IAAI,KAAK,CACd,GAAG,OAAO,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,GACpD,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EACrC,EAAE,CACF,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { blogFrontmatterSchema, type BlogFrontmatter, type BlogFrontmatterInput, } from "./schema.js";
+export type { BlogPost, BlogPostPreview, PostFormat } from "./types.js";
+export { VOCABULARY, vocabularyProps, defineBlogComponents, calloutProps, figureProps, youTubeProps, tweetProps, newsletterSubscribeProps, type BlogComponents, type VocabularyName, type VocabularyPropsMap, type CalloutProps, type FigureProps, type YouTubeProps, type TweetProps, type NewsletterSubscribeProps, } from "./contract.js";
+export { readingTime, DEFAULT_WORDS_PER_MINUTE, type ReadingTime, } from "./reading-time.js";
+export { formatPostDate } from "./date.js";
+export { blogPostArticle, blogPostBreadcrumbs, postUrl, type BlogSeoConfig, } from "./seo.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACN,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,oBAAoB,GACzB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EACN,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,wBAAwB,GAC7B,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,wBAAwB,EACxB,KAAK,WAAW,GAChB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,OAAO,EACP,KAAK,aAAa,GAClB,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// Root entry: the contract — schema, types, vocabulary manifest — plus pure
+// helpers. Importable anywhere (client, admin, route handlers); no fs, no
+// components, no MDX compiler. The reader/sources live at "./server", the
+// renderers at "./render", the default components at "./unstyled".
+export { blogFrontmatterSchema, } from "./schema.js";
+export { VOCABULARY, vocabularyProps, defineBlogComponents, calloutProps, figureProps, youTubeProps, tweetProps, newsletterSubscribeProps, } from "./contract.js";
+export { readingTime, DEFAULT_WORDS_PER_MINUTE, } from "./reading-time.js";
+export { formatPostDate } from "./date.js";
+export { blogPostArticle, blogPostBreadcrumbs, postUrl, } from "./seo.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,0EAA0E;AAC1E,mEAAmE;AACnE,OAAO,EACN,qBAAqB,GAGrB,MAAM,aAAa,CAAC;AAErB,OAAO,EACN,UAAU,EACV,eAAe,EACf,oBAAoB,EACpB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,wBAAwB,GASxB,MAAM,eAAe,CAAC;AACvB,OAAO,EACN,WAAW,EACX,wBAAwB,GAExB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EACN,eAAe,EACf,mBAAmB,EACnB,OAAO,GAEP,MAAM,UAAU,CAAC"}

package/dist/keys.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Env contract. Only the GitHub source/publisher needs anything, and callers
+ * may inject the token directly instead — so everything here is optional.
+ */
+export declare const keys: () => {
+    GITHUB_TOKEN?: string | undefined;
+};
+//# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,IAAI;;CAKI,CAAC"}

package/dist/keys.js

@@ -0,0 +1,11 @@
+import { z } from "zod";
+/**
+ * Env contract. Only the GitHub source/publisher needs anything, and callers
+ * may inject the token directly instead — so everything here is optional.
+ */
+export const keys = () => z
+    .object({
+    GITHUB_TOKEN: z.string().min(1).optional(),
+})
+    .parse(process.env);
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,CACxB,CAAC;KACC,MAAM,CAAC;IACP,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC1C,CAAC;KACD,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC"}

package/dist/limited-mdx.d.ts

@@ -0,0 +1,33 @@
+import type { Root } from "mdast";
+import type { VFile } from "vfile";
+/**
+ * The "limited MDX" trust boundary, enforced in the AST — not a convention.
+ *
+ * MDX is a programming language: `{process.env.X}`, `export const x = …`, and
+ * ESM imports all execute server-side with zero components involved. A Tier-1
+ * post (the only thing the automated publisher may emit as .mdx) is therefore
+ * restricted to prose + whitelisted JSX elements with literal attributes;
+ * every expression/ESM construct is rejected at compile time.
+ */
+export interface LimitedMdxOptions {
+    /** Component names the post may reference (the site's vocabulary). */
+    allow: readonly string[];
+}
+/** Remark plugin implementing the boundary. Throws (via `file.fail`) on violation. */
+export declare function remarkLimitedMdx(options: LimitedMdxOptions): (tree: Root, file: VFile) => void;
+export interface LimitedMdxViolation {
+    message: string;
+    line?: number;
+    column?: number;
+}
+export interface LimitedMdxResult {
+    ok: boolean;
+    errors: LimitedMdxViolation[];
+}
+/**
+ * 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 declare function validateLimitedMdx(source: string, options: LimitedMdxOptions): Promise<LimitedMdxResult>;
+//# sourceMappingURL=limited-mdx.d.ts.map

package/dist/limited-mdx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limited-mdx.d.ts","sourceRoot":"","sources":["../src/limited-mdx.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;AAGlC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAGnC;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IACjC,sEAAsE;IACtE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACzB;AAoHD,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,IAClD,MAAM,IAAI,EAAE,MAAM,KAAK,KAAG,IAAI,CAsBtC;AAED,MAAM,WAAW,mBAAmB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAuB3B"}