@softure-ai/blog 0.0.0-stage → 0.1.6

package/dist/options.d.ts

@@ -0,0 +1,320 @@
+import { z } from "zod";
+import type { BlockPlugin } from "./render/render-article.js";
+/** Where the app keeps its article files unless a command names a path. */
+export declare const DEFAULT_CONTENT_DIR = "content/blog";
+/** The frontmatter keys of the module; the app's `fields` may not reuse them. */
+export declare const FRONTMATTER_KEYS: readonly ["id", "slug", "kind", "cluster", "pillar", "title", "description", "summary", "status", "current_as_of", "published_at", "sources", "faq", "forms"];
+/** What a schema's `safeParse` reports; zod 3 and 4 both fit. */
+export type BlogFieldsParseResult = {
+    readonly success: true;
+    readonly data: unknown;
+} | {
+    readonly success: false;
+    readonly error: {
+        readonly issues: readonly {
+            readonly path: readonly PropertyKey[];
+            readonly message: string;
+        }[];
+    };
+};
+/**
+ * The app's own frontmatter fields: an object schema from the app's `zod`, e.g.
+ * `z.object({ scenario: z.string().optional() })`. Its keys join the frontmatter; the parsed value
+ * is stored with the article and enters its content hash. It must parse to plain JSON values.
+ */
+export interface BlogFieldsSchema {
+    readonly shape: Readonly<Record<string, unknown>>;
+    readonly safeParse: (value: unknown) => BlogFieldsParseResult;
+}
+/** How long the pages cache their reads by default, in seconds; the app's `revalidate` should match. */
+export declare const DEFAULT_REVALIDATE_SECONDS = 300;
+/** Text the app writes per locale; `en` is the fallback for a locale it leaves out. */
+declare const localizedTextSchema: z.ZodObject<{
+    en: z.ZodString;
+    pl: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+export type LocalizedText = z.output<typeof localizedTextSchema>;
+/** The weights Satori (`next/og`) draws: static fonts only, in steps of 100. */
+export declare const OG_FONT_WEIGHTS: readonly [100, 200, 300, 400, 500, 600, 700, 800, 900];
+export type OgFontWeight = (typeof OG_FONT_WEIGHTS)[number];
+declare const ogFontSchema: z.ZodObject<{
+    name: z.ZodString;
+    weight: z.ZodDefault<z.ZodCustom<200 | 600 | 700 | 300 | 100 | 400 | 500 | 800 | 900, 200 | 600 | 700 | 300 | 100 | 400 | 500 | 800 | 900>>;
+    style: z.ZodDefault<z.ZodEnum<{
+        normal: "normal";
+        italic: "italic";
+    }>>;
+    src: z.ZodString;
+}, z.core.$strict>;
+export type OgFontSource = z.output<typeof ogFontSchema>;
+/** One section of the app's own in the writing skill: `## <title>` and the Markdown body, verbatim. */
+declare const skillSectionSchema: z.ZodObject<{
+    title: z.ZodString;
+    body: z.ZodString;
+}, z.core.$strict>;
+export type BlogSkillSection = z.output<typeof skillSectionSchema>;
+export declare const blogOptionsSchema: z.ZodObject<{
+    contentDir: z.ZodDefault<z.ZodString>;
+    reservedSlugs: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    fields: z.ZodOptional<z.ZodCustom<BlogFieldsSchema, BlogFieldsSchema>>;
+    brand: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        colors: z.ZodOptional<z.ZodObject<{
+            background: z.ZodOptional<z.ZodString>;
+            foreground: z.ZodOptional<z.ZodString>;
+            accent: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>>;
+        fonts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            weight: z.ZodDefault<z.ZodCustom<200 | 600 | 700 | 300 | 100 | 400 | 500 | 800 | 900, 200 | 600 | 700 | 300 | 100 | 400 | 500 | 800 | 900>>;
+            style: z.ZodDefault<z.ZodEnum<{
+                normal: "normal";
+                italic: "italic";
+            }>>;
+            src: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    methodPage: z.ZodDefault<z.ZodBoolean>;
+    disclaimer: z.ZodOptional<z.ZodObject<{
+        en: z.ZodString;
+        pl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    clusters: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        en: z.ZodString;
+        pl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    blocks: z.ZodDefault<z.ZodArray<z.ZodCustom<BlockPlugin<unknown>, BlockPlugin<unknown>>>>;
+    siteHosts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    images: z.ZodOptional<z.ZodObject<{
+        hosts: z.ZodDefault<z.ZodReadonly<z.ZodArray<z.ZodString>>>;
+        dimensions: z.ZodCustom<(src: string) => import("./render/images.js").ImageDimensions | null, (src: string) => import("./render/images.js").ImageDimensions | null>;
+    }, z.core.$strict>>;
+    revalidateSeconds: z.ZodDefault<z.ZodNumber>;
+    quality: z.ZodDefault<z.ZodType<false | {
+        language: "en" | "pl";
+        ymyl: {
+            ownCalculationMark: string | null;
+        } | null;
+        voice: {
+            forbidFirstPersonSingular: boolean;
+            phrases: {
+                id: string;
+                pattern: RegExp;
+                message: string;
+                severity: "error" | "warning";
+            }[];
+        };
+        limits: {
+            words: {
+                article: {
+                    min: number;
+                    max: number;
+                };
+                term: {
+                    min: number;
+                    max: number;
+                };
+            };
+            leadWords: {
+                article: number;
+                term: number;
+            };
+            answerWords: number;
+            internalLinks: {
+                article: number;
+                term: number;
+            };
+            staleAfterDays: number;
+            titleChars: number;
+            descriptionChars: {
+                min: number;
+                max: number;
+            };
+            wordsPerDash: number;
+            wordsPerBold: number;
+            sentenceWords: number;
+        };
+        severity: Record<string, "error" | "warning" | "off">;
+        paths: {
+            articles: string;
+            terms: string;
+        };
+        ownOrigins: string[];
+        privateRouteSegments: string[];
+        plugins: import("./quality/plugin.js").QualityPlugin[];
+        blocks: BlockPlugin<unknown>[];
+        appDir?: string | undefined;
+    }, false | {
+        language?: "en" | "pl" | undefined;
+        ymyl?: boolean | {
+            ownCalculationMark?: string | undefined;
+        } | undefined;
+        voice?: {
+            forbidFirstPersonSingular?: boolean | undefined;
+            phrases?: {
+                id: string;
+                pattern: RegExp;
+                message: string;
+                severity?: "error" | "warning" | undefined;
+            }[] | undefined;
+        } | undefined;
+        limits?: {
+            words?: {
+                article?: {
+                    min?: number | undefined;
+                    max?: number | undefined;
+                } | undefined;
+                term?: {
+                    min?: number | undefined;
+                    max?: number | undefined;
+                } | undefined;
+            } | undefined;
+            leadWords?: {
+                article?: number | undefined;
+                term?: number | undefined;
+            } | undefined;
+            answerWords?: number | undefined;
+            internalLinks?: {
+                article?: number | undefined;
+                term?: number | undefined;
+            } | undefined;
+            staleAfterDays?: number | undefined;
+            titleChars?: number | undefined;
+            descriptionChars?: {
+                min?: number | undefined;
+                max?: number | undefined;
+            } | undefined;
+            wordsPerDash?: number | undefined;
+            wordsPerBold?: number | undefined;
+            sentenceWords?: number | undefined;
+        } | undefined;
+        severity?: Record<string, "error" | "warning" | "off"> | undefined;
+        paths?: {
+            articles?: string | undefined;
+            terms?: string | undefined;
+        } | undefined;
+        ownOrigins?: string[] | undefined;
+        appDir?: string | undefined;
+        privateRouteSegments?: string[] | undefined;
+        plugins?: import("./quality/plugin.js").QualityPlugin[] | undefined;
+        blocks?: BlockPlugin<unknown>[] | undefined;
+    }, z.core.$ZodTypeInternals<false | {
+        language: "en" | "pl";
+        ymyl: {
+            ownCalculationMark: string | null;
+        } | null;
+        voice: {
+            forbidFirstPersonSingular: boolean;
+            phrases: {
+                id: string;
+                pattern: RegExp;
+                message: string;
+                severity: "error" | "warning";
+            }[];
+        };
+        limits: {
+            words: {
+                article: {
+                    min: number;
+                    max: number;
+                };
+                term: {
+                    min: number;
+                    max: number;
+                };
+            };
+            leadWords: {
+                article: number;
+                term: number;
+            };
+            answerWords: number;
+            internalLinks: {
+                article: number;
+                term: number;
+            };
+            staleAfterDays: number;
+            titleChars: number;
+            descriptionChars: {
+                min: number;
+                max: number;
+            };
+            wordsPerDash: number;
+            wordsPerBold: number;
+            sentenceWords: number;
+        };
+        severity: Record<string, "error" | "warning" | "off">;
+        paths: {
+            articles: string;
+            terms: string;
+        };
+        ownOrigins: string[];
+        privateRouteSegments: string[];
+        plugins: import("./quality/plugin.js").QualityPlugin[];
+        blocks: BlockPlugin<unknown>[];
+        appDir?: string | undefined;
+    }, false | {
+        language?: "en" | "pl" | undefined;
+        ymyl?: boolean | {
+            ownCalculationMark?: string | undefined;
+        } | undefined;
+        voice?: {
+            forbidFirstPersonSingular?: boolean | undefined;
+            phrases?: {
+                id: string;
+                pattern: RegExp;
+                message: string;
+                severity?: "error" | "warning" | undefined;
+            }[] | undefined;
+        } | undefined;
+        limits?: {
+            words?: {
+                article?: {
+                    min?: number | undefined;
+                    max?: number | undefined;
+                } | undefined;
+                term?: {
+                    min?: number | undefined;
+                    max?: number | undefined;
+                } | undefined;
+            } | undefined;
+            leadWords?: {
+                article?: number | undefined;
+                term?: number | undefined;
+            } | undefined;
+            answerWords?: number | undefined;
+            internalLinks?: {
+                article?: number | undefined;
+                term?: number | undefined;
+            } | undefined;
+            staleAfterDays?: number | undefined;
+            titleChars?: number | undefined;
+            descriptionChars?: {
+                min?: number | undefined;
+                max?: number | undefined;
+            } | undefined;
+            wordsPerDash?: number | undefined;
+            wordsPerBold?: number | undefined;
+            sentenceWords?: number | undefined;
+        } | undefined;
+        severity?: Record<string, "error" | "warning" | "off"> | undefined;
+        paths?: {
+            articles?: string | undefined;
+            terms?: string | undefined;
+        } | undefined;
+        ownOrigins?: string[] | undefined;
+        appDir?: string | undefined;
+        privateRouteSegments?: string[] | undefined;
+        plugins?: import("./quality/plugin.js").QualityPlugin[] | undefined;
+        blocks?: BlockPlugin<unknown>[] | undefined;
+    }>>>;
+    skill: z.ZodDefault<z.ZodObject<{
+        sections: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            body: z.ZodString;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type BlogOptionsInput = z.input<typeof blogOptionsSchema>;
+export type BlogOptions = z.output<typeof blogOptionsSchema>;
+export {};
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,iFAAiF;AACjF,eAAO,MAAM,gBAAgB,+JAenB,CAAC;AAEX,iEAAiE;AACjE,MAAM,MAAM,qBAAqB,GAC7B;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,SAAS;YAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,WAAW,EAAE,CAAC;YAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;SAAE,EAAE,CAAA;KAAE,CAAA;CAAE,CAAC;AAErJ;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,qBAAqB,CAAC;CAC/D;AAgBD,wGAAwG;AACxG,eAAO,MAAM,0BAA0B,MAAM,CAAC;AAE9C,uFAAuF;AACvF,QAAA,MAAM,mBAAmB;;;kBAGvB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAMjE,gFAAgF;AAChF,eAAO,MAAM,eAAe,wDAAyD,CAAC;AAEtF,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAc5D,QAAA,MAAM,YAAY;;;;;;;;kBAchB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,YAAY,CAAC,CAAC;AAyCzD,uGAAuG;AACvG,QAAA,MAAM,kBAAkB;;;kBAYtB,CAAC;AAaH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AASnE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAwC1B,CAAC;AAEL,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AACjE,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/options.js

@@ -0,0 +1,184 @@
+// The options an app passes to `blog({ ... })` in softure.config.ts, parsed at startup.
+import { z } from "zod";
+import { qualitySettingSchema } from "./quality/options.js";
+/** Where the app keeps its article files unless a command names a path. */
+export const DEFAULT_CONTENT_DIR = "content/blog";
+/** The frontmatter keys of the module; the app's `fields` may not reuse them. */
+export const FRONTMATTER_KEYS = [
+    "id",
+    "slug",
+    "kind",
+    "cluster",
+    "pillar",
+    "title",
+    "description",
+    "summary",
+    "status",
+    "current_as_of",
+    "published_at",
+    "sources",
+    "faq",
+    "forms",
+];
+const KEBAB = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+function isFieldsSchema(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate.shape === "object" && candidate.shape !== null && typeof candidate.safeParse === "function";
+}
+function isBlockPlugin(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate.type === "string" && KEBAB.test(candidate.type) && typeof candidate.render === "function";
+}
+/** How long the pages cache their reads by default, in seconds; the app's `revalidate` should match. */
+export const DEFAULT_REVALIDATE_SECONDS = 300;
+/** Text the app writes per locale; `en` is the fallback for a locale it leaves out. */
+const localizedTextSchema = z.strictObject({
+    en: z.string().trim().min(1),
+    pl: z.string().trim().min(1).optional(),
+});
+const HEX_COLOR = /^#[0-9a-fA-F]{6}$/;
+const colorSchema = z.string().regex(HEX_COLOR, "must be a six-digit hex colour, e.g. #0c0c0d");
+const HOSTNAME = /^(?=.{1,253}$)[a-z0-9]([a-z0-9-]*[a-z0-9])?(\.[a-z0-9]([a-z0-9-]*[a-z0-9])?)*$/;
+/** The weights Satori (`next/og`) draws: static fonts only, in steps of 100. */
+export const OG_FONT_WEIGHTS = [100, 200, 300, 400, 500, 600, 700, 800, 900];
+const WOFF2 = /\.woff2$/i;
+/** The part of a font source that names the file: a URL's path, or the path as written. */
+function getSourceFileName(src) {
+    return src.startsWith("https://") ? new URL(src).pathname : src;
+}
+function isFontSource(src) {
+    if (src.startsWith("https://"))
+        return URL.canParse(src);
+    return !/^[a-z][a-z0-9+.-]*:\/\//i.test(src);
+}
+const ogFontSchema = z.strictObject({
+    /** The family name the card writes in; a second file of one weight and style needs its own name. */
+    name: z.string().trim().min(1).max(80),
+    weight: z
+        .custom((value) => OG_FONT_WEIGHTS.some((weight) => weight === value), "must be a weight from 100 to 900 in steps of 100")
+        .default(400),
+    style: z.enum(["normal", "italic"]).default("normal"),
+    /** A .ttf, .otf or .woff file: an https URL, an absolute path, or a path from the app's root. */
+    src: z
+        .string()
+        .trim()
+        .min(1)
+        .refine(isFontSource, "must be an https URL or a file path, e.g. fonts/inter-700.woff")
+        .refine((src) => !isFontSource(src) || !WOFF2.test(getSourceFileName(src)), "must be a .ttf, .otf or .woff file; the card cannot read .woff2"),
+});
+const brandSchema = z.strictObject({
+    /** The site's name: in page titles, as the author and publisher in JSON-LD, on the OG card. */
+    name: z.string().trim().min(1).max(80),
+    /** The OG card's colours; each defaults to the dark scheme of @softure-ai/ui's default theme. */
+    colors: z
+        .strictObject({ background: colorSchema.optional(), foreground: colorSchema.optional(), accent: colorSchema.optional() })
+        .optional(),
+    /**
+     * The OG card's fonts, read by the card's route on its first render and kept for the life of the
+     * process; without them the card uses `next/og`'s default font.
+     */
+    fonts: z
+        .array(ogFontSchema)
+        .min(1, "must list at least one font")
+        .superRefine((fonts, ctx) => {
+        const seen = new Set();
+        for (const [index, font] of fonts.entries()) {
+            const key = `"${font.name}" ${font.weight} ${font.style}`;
+            if (seen.has(key)) {
+                ctx.addIssue({ code: "custom", path: [index], message: `${key} is listed twice; give a second file its own name, e.g. "${font.name} Ext"` });
+            }
+            seen.add(key);
+        }
+    })
+        .optional(),
+});
+/** Whether a Markdown body holds a `#` or `##` heading outside fenced code. */
+function hasTopHeading(body) {
+    let fence = null;
+    for (const line of body.split(/\r?\n/)) {
+        const trimmed = line.trimStart();
+        const marker = trimmed.startsWith("```") ? "```" : trimmed.startsWith("~~~") ? "~~~" : null;
+        if (marker !== null)
+            fence = fence === null ? marker : fence === marker ? null : fence;
+        else if (fence === null && /^ {0,3}#{1,2}(?:[ \t]|$)/.test(line))
+            return true;
+    }
+    return false;
+}
+/** One section of the app's own in the writing skill: `## <title>` and the Markdown body, verbatim. */
+const skillSectionSchema = z.strictObject({
+    title: z
+        .string()
+        .trim()
+        .min(1)
+        .max(80)
+        .refine((title) => !/[\r\n]/.test(title), "must be one line"),
+    body: z
+        .string()
+        .trim()
+        .min(1)
+        .refine((body) => !hasTopHeading(body), "must not hold a # or ## heading; use ### and deeper (the title is the section's ## heading)"),
+});
+const skillSchema = z.strictObject({
+    /** The app's own sections (its numbers, block plugins, fields), written to `references/app.md` of the skill. */
+    sections: z.array(skillSectionSchema).superRefine((sections, ctx) => {
+        const seen = new Set();
+        for (const [index, section] of sections.entries()) {
+            if (seen.has(section.title))
+                ctx.addIssue({ code: "custom", path: [index, "title"], message: `"${section.title}" is the title of another section` });
+            seen.add(section.title);
+        }
+    }).default([]),
+});
+const imagePolicySchema = z.strictObject({
+    /** Hosts whose https images are allowed besides the site's own paths (subdomains included). */
+    hosts: z.array(z.string().regex(HOSTNAME, "must be a host name, e.g. cdn.example.com")).readonly().default([]),
+    /** `(src) => ({ width, height })` in pixels, or `null` for an unknown image. */
+    dimensions: z.custom((value) => typeof value === "function", "must be a function: (src) => ({ width, height }) or null"),
+});
+export const blogOptionsSchema = z
+    .strictObject({
+    /** The folder with the article files, relative to the app's root. */
+    contentDir: z.string().trim().min(1).default(DEFAULT_CONTENT_DIR),
+    /**
+     * Slugs taken by static pages under the blog's path (a glossary index, a method page). A static
+     * route wins over the article route, so an article with such a slug would be unreachable.
+     */
+    reservedSlugs: z.array(z.string().max(100).regex(KEBAB, "must be kebab-case, e.g. how-we-write")).default([]),
+    fields: z.custom(isFieldsSchema, "must be an object schema, e.g. z.object({ scenario: z.string() })").optional(),
+    /** The site's brand for titles, JSON-LD and the OG card; without it pages carry no brand. */
+    brand: brandSchema.optional(),
+    /** Whether the app mounts the "how our texts are made" page (`BlogMethodPage` at `routes.method`). */
+    methodPage: z.boolean().default(false),
+    /** A note under every text (not advice, not a recommendation…); none by default. */
+    disclaimer: localizedTextSchema.optional(),
+    /** Display names of clusters by key; a cluster without one shows its key with spaces. */
+    clusters: z.record(z.string().regex(KEBAB, "must be kebab-case, e.g. investing-basics"), localizedTextSchema).default({}),
+    /** Block plugins for the app's fenced blocks (`renderArticle({ blocks })`), used by the pages. */
+    blocks: z.array(z.custom(isBlockPlugin, "must be a block plugin: { type: \"chart\", render(block) }")).default([]),
+    /** Hosts besides those of `appOrigin` and the canonical site origin (`getSiteUrls`) whose links are not marked external (subdomains included). */
+    siteHosts: z.array(z.string().regex(HOSTNAME, "must be a host name, e.g. example.com")).default([]),
+    /**
+     * Which images article bodies may show (`renderArticle({ images })`), used by the pages and the
+     * quality gate; without it every image renders as its alt text and the gate refuses it.
+     */
+    images: imagePolicySchema.optional(),
+    /** How long the listing and glossary cache their reads; keep it equal to the pages' `revalidate`. */
+    revalidateSeconds: z.number().int().min(1).default(DEFAULT_REVALIDATE_SECONDS),
+    /** The text quality gate (`softure-blog check`, and every publish); `false` turns it off. */
+    quality: qualitySettingSchema,
+    /** What `softure-blog skill install` adds to the generated writing skill. */
+    skill: skillSchema.default({ sections: [] }),
+})
+    .superRefine((options, ctx) => {
+    for (const key of Object.keys(options.fields?.shape ?? {})) {
+        if (FRONTMATTER_KEYS.includes(key)) {
+            ctx.addIssue({ code: "custom", path: ["fields", key], message: `"${key}" is a frontmatter key of the module` });
+        }
+    }
+});
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

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

package/dist/pages/body.d.ts

@@ -0,0 +1,18 @@
+import type { BlogArticle } from "../contract.js";
+import type { BlogMessages } from "../messages/index.js";
+import type { BlogOptions } from "../options.js";
+import type { GlossaryTerm } from "../render/glossary.js";
+import { type RenderedArticle } from "../render/render-article.js";
+import { type BlogRoutes } from "./paths.js";
+export interface RenderPageBodyOptions {
+    readonly glossary: readonly GlossaryTerm[];
+    readonly routes: BlogRoutes;
+    readonly options: Pick<BlogOptions, "blocks" | "images" | "siteHosts">;
+    /** The app's own origins (`appOrigin` and the canonical site origin); their hosts are the site's (links to them are not external). */
+    readonly origins: readonly string[];
+    readonly messages: BlogMessages;
+}
+export declare function renderPageBody<TNode = unknown>(text: BlogArticle, input: RenderPageBodyOptions): RenderedArticle<TNode>;
+/** Published articles whose body links the term, by hand or by its first mention: the same rule as the links. */
+export declare function findArticlesLinkingTerm(articles: readonly BlogArticle[], termSlug: string, input: RenderPageBodyOptions): BlogArticle[];
+//# sourceMappingURL=body.d.ts.map

package/dist/pages/body.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.d.ts","sourceRoot":"","sources":["../../src/pages/body.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAmC,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC,CAAC;IACvE,sIAAsI;IACtI,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;CACjC;AAED,wBAAgB,cAAc,CAAC,KAAK,GAAG,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,qBAAqB,GAAG,eAAe,CAAC,KAAK,CAAC,CAavH;AAED,iHAAiH;AACjH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,qBAAqB,GAAG,WAAW,EAAE,CAEvI"}

package/dist/pages/body.js

@@ -0,0 +1,21 @@
+import { renderArticle } from "../render/render-article.js";
+import { getTermPath } from "./paths.js";
+export function renderPageBody(text, input) {
+    return renderArticle(text.bodyMarkdown, {
+        glossary: input.glossary,
+        ...(text.kind === "term" ? { selfSlug: text.slug } : {}),
+        termHref: (slug) => getTermPath(input.routes, slug),
+        siteHosts: [...input.origins.map((origin) => new URL(origin).hostname), ...input.options.siteHosts],
+        ...(input.options.images === undefined ? {} : { images: input.options.images }),
+        // The options keep plugins untyped (`unknown` nodes); the pages render React nodes, the type the
+        // app's plugins return.
+        blocks: input.options.blocks,
+        article: { currentAsOf: text.currentAsOf, fields: text.fields },
+        messages: input.messages.render,
+    });
+}
+/** Published articles whose body links the term, by hand or by its first mention: the same rule as the links. */
+export function findArticlesLinkingTerm(articles, termSlug, input) {
+    return articles.filter((article) => renderPageBody(article, input).linkedTerms.includes(termSlug));
+}
+//# sourceMappingURL=body.js.map

package/dist/pages/body.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body.js","sourceRoot":"","sources":["../../src/pages/body.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,aAAa,EAA0C,MAAM,6BAA6B,CAAC;AACpG,OAAO,EAAE,WAAW,EAAmB,MAAM,YAAY,CAAC;AAW1D,MAAM,UAAU,cAAc,CAAkB,IAAiB,EAAE,KAA4B;IAC7F,OAAO,aAAa,CAAQ,IAAI,CAAC,YAAY,EAAE;QAC7C,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC;QACnD,SAAS,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QACnG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC/E,iGAAiG;QACjG,wBAAwB;QACxB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAuC;QAC7D,OAAO,EAAE,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;QAC/D,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM;KAChC,CAAC,CAAC;AACL,CAAC;AAED,iHAAiH;AACjH,MAAM,UAAU,uBAAuB,CAAC,QAAgC,EAAE,QAAgB,EAAE,KAA4B;IACtH,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AACrG,CAAC"}

package/dist/pages/dates.d.ts

@@ -0,0 +1,21 @@
+import type { Locale } from "@softure-ai/core";
+import type { BlogArticle } from "../contract.js";
+export interface ArticleDates {
+    /** The day of first publication, `YYYY-MM-DD`. */
+    readonly published: string;
+    /** The day of the last content change; `null` without one, or when it falls on the publication day. */
+    readonly updated: string | null;
+    /** The day the facts were checked, `YYYY-MM-DD`. */
+    readonly currentAsOf: string;
+}
+/** The calendar day of a moment in a time zone, `YYYY-MM-DD`. */
+export declare function getDayInZone(moment: Date, timezone: string): string;
+/**
+ * The visible dates of a published text. Two equal days one under the other read like a mistake, so
+ * "updated" disappears when it falls on the publication day. A text without a publication date has
+ * no page: calling this for one is a bug.
+ */
+export declare function getArticleDates(article: Pick<BlogArticle, "slug" | "publishedAt" | "updatedAt" | "currentAsOf">, timezone: string): ArticleDates;
+/** A `YYYY-MM-DD` day as the locale writes it in full (en: "October 4, 2026"). */
+export declare function formatDay(day: string, locale: Locale): string;
+//# sourceMappingURL=dates.d.ts.map

package/dist/pages/dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.d.ts","sourceRoot":"","sources":["../../src/pages/dates.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,kDAAkD;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uGAAuG;IACvG,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,oDAAoD;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAOhJ;AAED,kFAAkF;AAClF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAG7D"}

package/dist/pages/dates.js

@@ -0,0 +1,24 @@
+/** The calendar day of a moment in a time zone, `YYYY-MM-DD`. */
+export function getDayInZone(moment, timezone) {
+    // `en-CA` formats a date as YYYY-MM-DD.
+    return new Intl.DateTimeFormat("en-CA", { timeZone: timezone, year: "numeric", month: "2-digit", day: "2-digit" }).format(moment);
+}
+/**
+ * The visible dates of a published text. Two equal days one under the other read like a mistake, so
+ * "updated" disappears when it falls on the publication day. A text without a publication date has
+ * no page: calling this for one is a bug.
+ */
+export function getArticleDates(article, timezone) {
+    if (article.publishedAt === null) {
+        throw new Error(`getArticleDates: article ${article.slug} has no published_at; pages show only published texts`);
+    }
+    const published = getDayInZone(article.publishedAt, timezone);
+    const updated = article.updatedAt === null ? null : getDayInZone(article.updatedAt, timezone);
+    return { published, updated: updated === published ? null : updated, currentAsOf: article.currentAsOf };
+}
+/** A `YYYY-MM-DD` day as the locale writes it in full (en: "October 4, 2026"). */
+export function formatDay(day, locale) {
+    // The day is already a calendar day: format it at UTC midnight in UTC, so no zone shifts it.
+    return new Intl.DateTimeFormat(locale, { dateStyle: "long", timeZone: "UTC" }).format(new Date(`${day}T00:00:00Z`));
+}
+//# sourceMappingURL=dates.js.map

package/dist/pages/dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dates.js","sourceRoot":"","sources":["../../src/pages/dates.ts"],"names":[],"mappings":"AAcA,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,MAAY,EAAE,QAAgB;IACzD,wCAAwC;IACxC,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AACpI,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgF,EAAE,QAAgB;IAChI,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,4BAA4B,OAAO,CAAC,IAAI,uDAAuD,CAAC,CAAC;IACnH,CAAC;IACD,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9F,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;AAC1G,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,MAAc;IACnD,6FAA6F;IAC7F,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC;AACtH,CAAC"}

package/dist/pages/index.d.ts

@@ -0,0 +1,7 @@
+export { findArticlesLinkingTerm, renderPageBody, type RenderPageBodyOptions } from "./body.js";
+export { formatDay, getArticleDates, getDayInZone, type ArticleDates } from "./dates.js";
+export { getArticleImageUrl, getArticleJsonLd, getGlossaryJsonLd, getTermJsonLd, serializeJsonLd, type JsonLdContext } from "./json-ld.js";
+export { getArticleCrumbs, getClusterAnchor, getClusterLabel, getTermCrumbs, groupByCluster, sortTerms, splitClusterLead, type ClusterGroup, type Crumb, type CrumbLabels, } from "./listing.js";
+export { getArticlePath, getReservedSlugs, getTermPath, getTextPath, matchBlogPath, normalizeRoute, type BlogPathKind, type BlogPathMatch, type BlogRoutes, } from "./paths.js";
+export { buildGonePage, createCachedBlogPathDecider, decideBlogPath, type BlogPathDecision, type BlogPathLookup, type CachedDeciderOptions, type GonePageCopy, } from "./redirects.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/pages/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAChG,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AACzF,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3I,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,cAAc,EACd,SAAS,EACT,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,KAAK,EACV,KAAK,WAAW,GACjB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,UAAU,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,cAAc,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,YAAY,GAClB,MAAM,gBAAgB,CAAC"}