@softure-ai/blog 0.0.0-stage → 0.1.6

package/dist/quality/index.d.ts

@@ -0,0 +1,15 @@
+export { listQualityRules, QUALITY_RULE_GROUPS, type QualityCatalogRule, type QualityRuleGroup } from "./catalog.js";
+export { checkArticle, checkArticleText, type CheckArticleInput, type CheckArticleTextInput, type QualityCheckResult } from "./check-article.js";
+export { checkArticleFiles, type CheckArticleFilesOptions, type FileCheckResult } from "./check-files.js";
+export { getProseBlocks, splitArticleBody, splitBlocks, type Block, type BlockKind } from "./blocks.js";
+export { checkExternalLinks, checkExternalUrl, type FetchLike } from "./external-links.js";
+export { formatFinding, hasQualityErrors, QUALITY_SEVERITIES, sortFindings, type QualityFinding, type QualitySeverity } from "./finding.js";
+export { createQualityGate } from "./gate.js";
+export { collectAppRoutes, createInternalLinkResolver, findAppDir, readContentFolder, readPublishedContent, type AppRoute, type InternalLinkResolverOptions } from "./link-targets.js";
+export { qualityOptionsSchema, type QualityLimits, type QualityOptions, type QualityOptionsInput } from "./options.js";
+export { isQualityPlugin, type QualityPlugin, type QualityPluginContext, type QualityRuleInfo } from "./plugin.js";
+export { collectLinks, type InternalLinkResolver, type LinkSummary } from "./rules/links.js";
+export { enRuleset, plRuleset, QUALITY_LANGUAGES, QUALITY_RULESETS, type LanguageRuleset, type QualityLanguage, type StylePattern } from "./rulesets/index.js";
+export { getLocalDate, resolveQualitySettings, type QualitySettings } from "./settings.js";
+export { countWords, findBareUrls, findFootnoteRefs, findLinks, findSignificantNumbers, normalizeNumber, parseNumber, splitSentences, toProse, wordPattern, type MarkdownLink, type NumberNotation, } from "./text.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/quality/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACjJ,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAC5I,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,UAAU,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,KAAK,QAAQ,EAAE,KAAK,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AACvL,OAAO,EAAE,oBAAoB,EAAE,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACvH,OAAO,EAAE,eAAe,EAAE,KAAK,aAAa,EAAE,KAAK,oBAAoB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAC;AACnH,OAAO,EAAE,YAAY,EAAE,KAAK,oBAAoB,EAAE,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC/J,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAC3F,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,cAAc,EACd,OAAO,EACP,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,WAAW,CAAC"}

package/dist/quality/index.js

@@ -0,0 +1,16 @@
+// The quality gate's public surface, re-exported from `@softure-ai/blog/server`.
+export { listQualityRules, QUALITY_RULE_GROUPS } from "./catalog.js";
+export { checkArticle, checkArticleText } from "./check-article.js";
+export { checkArticleFiles } from "./check-files.js";
+export { getProseBlocks, splitArticleBody, splitBlocks } from "./blocks.js";
+export { checkExternalLinks, checkExternalUrl } from "./external-links.js";
+export { formatFinding, hasQualityErrors, QUALITY_SEVERITIES, sortFindings } from "./finding.js";
+export { createQualityGate } from "./gate.js";
+export { collectAppRoutes, createInternalLinkResolver, findAppDir, readContentFolder, readPublishedContent } from "./link-targets.js";
+export { qualityOptionsSchema } from "./options.js";
+export { isQualityPlugin } from "./plugin.js";
+export { collectLinks } from "./rules/links.js";
+export { enRuleset, plRuleset, QUALITY_LANGUAGES, QUALITY_RULESETS } from "./rulesets/index.js";
+export { getLocalDate, resolveQualitySettings } from "./settings.js";
+export { countWords, findBareUrls, findFootnoteRefs, findLinks, findSignificantNumbers, normalizeNumber, parseNumber, splitSentences, toProse, wordPattern, } from "./text.js";
+//# sourceMappingURL=index.js.map

package/dist/quality/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/quality/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAkD,MAAM,cAAc,CAAC;AACrH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAA+E,MAAM,oBAAoB,CAAC;AACjJ,OAAO,EAAE,iBAAiB,EAAuD,MAAM,kBAAkB,CAAC;AAC1G,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,WAAW,EAA8B,MAAM,aAAa,CAAC;AACxG,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAkB,MAAM,qBAAqB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAA6C,MAAM,cAAc,CAAC;AAC5I,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,UAAU,EAAE,iBAAiB,EAAE,oBAAoB,EAAmD,MAAM,mBAAmB,CAAC;AACvL,OAAO,EAAE,oBAAoB,EAAqE,MAAM,cAAc,CAAC;AACvH,OAAO,EAAE,eAAe,EAAuE,MAAM,aAAa,CAAC;AACnH,OAAO,EAAE,YAAY,EAA+C,MAAM,kBAAkB,CAAC;AAC7F,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAiE,MAAM,qBAAqB,CAAC;AAC/J,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAwB,MAAM,eAAe,CAAC;AAC3F,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACT,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,cAAc,EACd,OAAO,EACP,WAAW,GAGZ,MAAM,WAAW,CAAC"}

package/dist/quality/link-targets.d.ts

@@ -0,0 +1,44 @@
+import { type ParseArticleFileOptions } from "../content/article-file.js";
+import type { BlogArticleKind } from "../contract.js";
+import type { GlossaryTerm } from "../render/glossary.js";
+import type { InternalLinkResolver } from "./rules/links.js";
+export interface AppRoute {
+    readonly pattern: RegExp;
+    /** Has a `[param]` segment. */
+    readonly isDynamic: boolean;
+}
+export interface InternalLinkResolverOptions {
+    /** The Next.js app folder, or `null` when the app has none (only content links resolve). */
+    readonly appDir: string | null;
+    readonly privateRouteSegments: readonly string[];
+    readonly paths: {
+        readonly articles: string;
+        readonly terms: string;
+    };
+    /** Published texts by slug. */
+    readonly content: ReadonlyMap<string, BlogArticleKind>;
+}
+/** The app folder to read: the given one, else `src/app`, else `app`, else none. */
+export declare function findAppDir(cwd: string, appDir: string | undefined): string | null;
+export declare function collectAppRoutes(appDir: string, privateSegments: readonly string[]): AppRoute[];
+/** Published texts in the content folders by slug: the file name is the slug (BL-2), the kind and status come from the frontmatter. */
+export declare function readPublishedContent(files: readonly {
+    readonly name: string;
+    readonly text: string;
+}[]): Map<string, BlogArticleKind>;
+/**
+ * The published glossary terms of the content folders, for the form conflict check: a later file
+ * with the same slug replaces an earlier one (a checked file over its copy in the folder). A file that
+ * does not parse is skipped; its own check reports it.
+ */
+export declare function readGlossaryTerms(files: readonly {
+    readonly name: string;
+    readonly text: string;
+}[], parse?: ParseArticleFileOptions): GlossaryTerm[];
+export declare function createInternalLinkResolver(options: InternalLinkResolverOptions): InternalLinkResolver;
+/** Reads `*.md` files of a folder except README.md. */
+export declare function readContentFolder(dir: string): {
+    name: string;
+    text: string;
+}[];
+//# sourceMappingURL=link-targets.d.ts.map

package/dist/quality/link-targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-targets.d.ts","sourceRoot":"","sources":["../../src/quality/link-targets.ts"],"names":[],"mappings":"AAOA,OAAO,EAAoB,KAAK,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAC5F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAI7D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,4FAA4F;IAC5F,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,oBAAoB,EAAE,SAAS,MAAM,EAAE,CAAC;IACjD,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,+BAA+B;IAC/B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACxD;AAED,oFAAoF;AACpF,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAGjF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,MAAM,EAAE,GAAG,QAAQ,EAAE,CAe/F;AAED,uIAAuI;AACvI,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAQrI;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,EAAE,KAAK,GAAE,uBAA4B,GAAG,YAAY,EAAE,CAUzJ;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,oBAAoB,CAarG;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAM/E"}

package/dist/quality/link-targets.js

@@ -0,0 +1,91 @@
+// Internal link targets from the file system (FIRE_TRACKER `src/lib/blog/quality/link-targets.ts`),
+// for `softure-blog check`. A route exists when the Next.js app folder has a `page.*` or `route.*` for
+// it (route groups vanish from the path; private segments and `_folders` are skipped). An article or
+// a glossary term exists when the content folder has its published file of that kind, under
+// `quality.paths`; a static page under the same path wins over the dynamic article route.
+import { existsSync, readdirSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { parseArticleFile } from "../content/article-file.js";
+const ROUTE_FILES = /^(?:page|route)\.(?:tsx?|jsx?|mdx?)$/;
+/** The app folder to read: the given one, else `src/app`, else `app`, else none. */
+export function findAppDir(cwd, appDir) {
+    if (appDir !== undefined)
+        return join(cwd, appDir);
+    return [join(cwd, "src/app"), join(cwd, "app")].find((dir) => existsSync(dir)) ?? null;
+}
+export function collectAppRoutes(appDir, privateSegments) {
+    const routes = [];
+    const walk = (dir, segments) => {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        if (entries.some((entry) => entry.isFile() && ROUTE_FILES.test(entry.name))) {
+            const visible = segments.filter((segment) => !/^\(.*\)$/.test(segment));
+            const pattern = visible.map((segment) => (/^\[.*\]$/.test(segment) ? "[^/]+" : escapeRegExp(segment))).join("/");
+            routes.push({ pattern: new RegExp(`^/${pattern}$`), isDynamic: visible.some((segment) => /^\[.*\]$/.test(segment)) });
+        }
+        for (const entry of entries) {
+            if (entry.isDirectory() && !privateSegments.includes(entry.name) && !entry.name.startsWith("_"))
+                walk(join(dir, entry.name), [...segments, entry.name]);
+        }
+    };
+    walk(appDir, []);
+    return routes;
+}
+/** Published texts in the content folders by slug: the file name is the slug (BL-2), the kind and status come from the frontmatter. */
+export function readPublishedContent(files) {
+    const content = new Map();
+    for (const file of files) {
+        const frontmatter = /^---\r?\n([\s\S]*?)\r?\n---/.exec(file.text)?.[1] ?? "";
+        if (!/^status:\s*(["']?)published\1\s*(?:#.*)?$/m.test(frontmatter))
+            continue;
+        content.set(file.name.replace(/\.md$/, ""), /^kind:\s*(["']?)term\1\s*(?:#.*)?$/m.test(frontmatter) ? "term" : "article");
+    }
+    return content;
+}
+/**
+ * The published glossary terms of the content folders, for the form conflict check: a later file
+ * with the same slug replaces an earlier one (a checked file over its copy in the folder). A file that
+ * does not parse is skipped; its own check reports it.
+ */
+export function readGlossaryTerms(files, parse = {}) {
+    const terms = new Map();
+    for (const file of files) {
+        const parsed = parseArticleFile(file.text, file.name, parse);
+        if (!parsed.ok)
+            continue;
+        const { slug, kind, status, termForms } = parsed.article;
+        if (kind === "term" && status === "published")
+            terms.set(slug, { slug, forms: termForms });
+        else
+            terms.delete(slug);
+    }
+    return [...terms.values()];
+}
+export function createInternalLinkResolver(options) {
+    const routes = options.appDir === null || !existsSync(options.appDir) ? [] : collectAppRoutes(options.appDir, options.privateRouteSegments);
+    const term = new RegExp(`^${escapeRegExp(options.paths.terms)}/([^/]+)$`);
+    const article = new RegExp(`^${escapeRegExp(options.paths.articles === "/" ? "" : options.paths.articles)}/([^/]+)$`);
+    const isStaticRoute = (pathname) => routes.some((route) => !route.isDynamic && route.pattern.test(pathname));
+    return (rawPathname) => {
+        const pathname = rawPathname.length > 1 ? rawPathname.replace(/\/$/, "") : rawPathname;
+        const termSlug = term.exec(pathname)?.[1];
+        if (termSlug !== undefined)
+            return options.content.get(termSlug) === "term" || isStaticRoute(pathname);
+        const articleSlug = article.exec(pathname)?.[1];
+        if (articleSlug !== undefined)
+            return options.content.get(articleSlug) === "article" || isStaticRoute(pathname);
+        return routes.some((route) => route.pattern.test(pathname));
+    };
+}
+/** Reads `*.md` files of a folder except README.md. */
+export function readContentFolder(dir) {
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir)
+        .filter((name) => name.endsWith(".md") && name !== "README.md")
+        .sort()
+        .map((name) => ({ name, text: readFileSync(join(dir, name), "utf8") }));
+}
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=link-targets.js.map

package/dist/quality/link-targets.js.map

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

package/dist/quality/options.d.ts

@@ -0,0 +1,113 @@
+import { z } from "zod";
+import type { BlockPlugin } from "../render/render-article.js";
+import { type QualityPlugin } from "./plugin.js";
+/** Thresholds; the defaults are FIRE's, chosen for answer-first texts that AI assistants quote. */
+export declare const qualityLimitsSchema: z.ZodPrefault<z.ZodObject<{
+    words: z.ZodPrefault<z.ZodObject<{
+        article: z.ZodPrefault<z.ZodObject<{
+            min: z.ZodDefault<z.ZodNumber>;
+            max: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+        term: z.ZodPrefault<z.ZodObject<{
+            min: z.ZodDefault<z.ZodNumber>;
+            max: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    leadWords: z.ZodPrefault<z.ZodObject<{
+        article: z.ZodDefault<z.ZodNumber>;
+        term: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    answerWords: z.ZodDefault<z.ZodNumber>;
+    internalLinks: z.ZodPrefault<z.ZodObject<{
+        article: z.ZodDefault<z.ZodNumber>;
+        term: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    staleAfterDays: z.ZodDefault<z.ZodNumber>;
+    titleChars: z.ZodDefault<z.ZodNumber>;
+    descriptionChars: z.ZodPrefault<z.ZodObject<{
+        min: z.ZodDefault<z.ZodNumber>;
+        max: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    wordsPerDash: z.ZodDefault<z.ZodNumber>;
+    wordsPerBold: z.ZodDefault<z.ZodNumber>;
+    sentenceWords: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strict>>;
+export declare const qualityOptionsSchema: z.ZodObject<{
+    language: z.ZodDefault<z.ZodEnum<{
+        en: "en";
+        pl: "pl";
+    }>>;
+    ymyl: z.ZodPipe<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        ownCalculationMark: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>]>>, z.ZodTransform<{
+        ownCalculationMark: string | null;
+    } | null, boolean | {
+        ownCalculationMark?: string | undefined;
+    }>>;
+    voice: z.ZodPrefault<z.ZodObject<{
+        forbidFirstPersonSingular: z.ZodDefault<z.ZodBoolean>;
+        phrases: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            pattern: z.ZodInstanceOf<RegExp>;
+            message: z.ZodString;
+            severity: z.ZodDefault<z.ZodEnum<{
+                error: "error";
+                warning: "warning";
+            }>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    limits: z.ZodPrefault<z.ZodObject<{
+        words: z.ZodPrefault<z.ZodObject<{
+            article: z.ZodPrefault<z.ZodObject<{
+                min: z.ZodDefault<z.ZodNumber>;
+                max: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>>;
+            term: z.ZodPrefault<z.ZodObject<{
+                min: z.ZodDefault<z.ZodNumber>;
+                max: z.ZodDefault<z.ZodNumber>;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        leadWords: z.ZodPrefault<z.ZodObject<{
+            article: z.ZodDefault<z.ZodNumber>;
+            term: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+        answerWords: z.ZodDefault<z.ZodNumber>;
+        internalLinks: z.ZodPrefault<z.ZodObject<{
+            article: z.ZodDefault<z.ZodNumber>;
+            term: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+        staleAfterDays: z.ZodDefault<z.ZodNumber>;
+        titleChars: z.ZodDefault<z.ZodNumber>;
+        descriptionChars: z.ZodPrefault<z.ZodObject<{
+            min: z.ZodDefault<z.ZodNumber>;
+            max: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+        wordsPerDash: z.ZodDefault<z.ZodNumber>;
+        wordsPerBold: z.ZodDefault<z.ZodNumber>;
+        sentenceWords: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strict>>;
+    severity: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        error: "error";
+        warning: "warning";
+        off: "off";
+    }>>>;
+    paths: z.ZodPrefault<z.ZodObject<{
+        articles: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        terms: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    }, z.core.$strict>>;
+    ownOrigins: z.ZodDefault<z.ZodArray<z.ZodURL>>;
+    appDir: z.ZodOptional<z.ZodString>;
+    privateRouteSegments: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    plugins: z.ZodDefault<z.ZodArray<z.ZodCustom<QualityPlugin, QualityPlugin>>>;
+    blocks: z.ZodDefault<z.ZodArray<z.ZodCustom<BlockPlugin<unknown>, BlockPlugin<unknown>>>>;
+}, z.core.$strict>;
+export type QualityOptionsInput = z.input<typeof qualityOptionsSchema>;
+export type QualityOptions = z.output<typeof qualityOptionsSchema>;
+export type QualityLimits = QualityOptions["limits"];
+/**
+ * `blog({ quality })`: the options, or `false` to turn the gate off. Not a zod union, whose error
+ * would read "Invalid input" and hide which option is wrong: the options' own issues are reported.
+ * The cast gives it the types of a defaulted option: optional in, never undefined out.
+ */
+export declare const qualitySettingSchema: z.ZodDefault<z.ZodType<QualityOptions | false, QualityOptionsInput | false>>;
+//# sourceMappingURL=options.d.ts.map

package/dist/quality/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/quality/options.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAoBlE,mGAAmG;AACnG,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAajB,CAAC;AAIhB,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0C/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACvE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACnE,MAAM,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EASd,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,GAAG,KAAK,EAAE,mBAAmB,GAAG,KAAK,CAAC,CAAC,CAAC"}

package/dist/quality/options.js

@@ -0,0 +1,93 @@
+// `blog({ quality })`: the gate's options, parsed at startup with the rest of the blog's options.
+import { z } from "zod";
+import { QUALITY_SEVERITIES } from "./finding.js";
+import { isQualityPlugin } from "./plugin.js";
+import { QUALITY_LANGUAGES } from "./rulesets/types.js";
+const KEBAB = /^[a-z0-9]+(-[a-z0-9]+)*$/;
+function isBlockPlugin(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate.type === "string" && typeof candidate.render === "function";
+}
+const range = (min, max) => z
+    .strictObject({ min: z.number().int().min(0).default(min), max: z.number().int().positive().default(max) })
+    .prefault({})
+    .refine((value) => value.min <= value.max, "min must not exceed max");
+const byKind = (article, term) => z.strictObject({ article: z.number().int().min(0).default(article), term: z.number().int().min(0).default(term) }).prefault({});
+/** Thresholds; the defaults are FIRE's, chosen for answer-first texts that AI assistants quote. */
+export const qualityLimitsSchema = z
+    .strictObject({
+    words: z.strictObject({ article: range(600, 4000), term: range(60, 700) }).prefault({}),
+    leadWords: byKind(90, 60),
+    answerWords: z.number().int().positive().default(70),
+    internalLinks: byKind(2, 1),
+    staleAfterDays: z.number().int().positive().default(365),
+    titleChars: z.number().int().positive().default(70),
+    descriptionChars: range(50, 160),
+    wordsPerDash: z.number().int().positive().default(150),
+    wordsPerBold: z.number().int().positive().default(200),
+    sentenceWords: z.number().int().positive().default(35),
+})
+    .prefault({});
+const sitePath = z.string().regex(/^\/[a-z0-9/_-]*$/, "must be a path from the site root, e.g. /blog").transform((path) => (path.length > 1 ? path.replace(/\/$/, "") : path));
+export const qualityOptionsSchema = z.strictObject({
+    /** The ruleset of the blog's language. */
+    language: z.enum(QUALITY_LANGUAGES).default("en"),
+    /** Your money or your life: sources required, every significant number footnoted, no profit promises. */
+    ymyl: z
+        .union([z.boolean(), z.strictObject({ ownCalculationMark: z.string().trim().min(1).optional() })])
+        .default(false)
+        .transform((value) => (value === false ? null : { ownCalculationMark: value === true ? null : (value.ownCalculationMark ?? null) })),
+    voice: z
+        .strictObject({
+        /** Texts signed by an editorial team: no "I", "my", "in my opinion". */
+        forbidFirstPersonSingular: z.boolean().default(false),
+        /**
+         * The brand's banned phrases: a global regular expression, matched as given. `wordPattern("...")`
+         * builds one that is case-insensitive and knows word edges in any alphabet.
+         */
+        phrases: z
+            .array(z.strictObject({
+            id: z.string().max(60).regex(KEBAB, "kebab-case, e.g. finance-cliche"),
+            pattern: z.instanceof(RegExp, { error: "must be a regular expression" }).refine((pattern) => pattern.global, "must be global (flag g), so every hit counts"),
+            message: z.string().trim().min(1),
+            severity: z.enum(QUALITY_SEVERITIES).default("error"),
+        }))
+            .default([]),
+    })
+        .prefault({}),
+    limits: qualityLimitsSchema,
+    /** Per rule: another severity, or "off". */
+    severity: z.record(z.string().regex(KEBAB), z.enum(["error", "warning", "off"])).default({}),
+    /** Where the pages live; BL-4 serves them there. */
+    paths: z.strictObject({ articles: sitePath.default("/blog"), terms: sitePath.default("/blog/glossary") }).prefault({}),
+    /** Absolute origins whose links count as internal, besides the config's `appOrigin` and the canonical site origin (`getSiteUrls`). */
+    ownOrigins: z.array(z.url({ protocol: /^https?$/ })).default([]),
+    /** The Next.js app folder `softure-blog check` reads routes from. Default: `src/app`, else `app`. */
+    appDir: z.string().trim().min(1).optional(),
+    /** Route folders that are no link target (API, pages behind a login). Route groups count too, e.g. "(app)". */
+    privateRouteSegments: z.array(z.string().min(1)).default(["api"]),
+    plugins: z.array(z.custom(isQualityPlugin, "must be a plugin: { name, rules, check }")).default([]),
+    /** The block plugins the app renders with (`renderArticle({ blocks })`): their `requires` keys must be in the frontmatter. */
+    blocks: z.array(z.custom(isBlockPlugin, "must be a block plugin: { type, render }")).default([]),
+});
+/**
+ * `blog({ quality })`: the options, or `false` to turn the gate off. Not a zod union, whose error
+ * would read "Invalid input" and hide which option is wrong: the options' own issues are reported.
+ * The cast gives it the types of a defaulted option: optional in, never undefined out.
+ */
+export const qualitySettingSchema = z
+    .unknown()
+    .optional()
+    .transform((value, ctx) => {
+    if (value === false)
+        return false;
+    const parsed = qualityOptionsSchema.safeParse(value ?? {});
+    if (parsed.success)
+        return parsed.data;
+    for (const issue of parsed.error.issues)
+        ctx.addIssue({ code: "custom", message: issue.message, path: issue.path });
+    return z.NEVER;
+});
+//# sourceMappingURL=options.js.map

package/dist/quality/options.js.map

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

package/dist/quality/plugin.d.ts

@@ -0,0 +1,34 @@
+import type { BlogArticleInput } from "../contract.js";
+import type { FoundBlock } from "../render/render-article.js";
+import type { Block } from "./blocks.js";
+import type { QualityFinding, QualitySeverity } from "./finding.js";
+import type { LanguageRuleset } from "./rulesets/types.js";
+/** A rule as the catalog lists it: what the writing skill names and the gate enforces. */
+export interface QualityRuleInfo {
+    readonly id: string;
+    /** The default severity; `quality.severity` overrides it. */
+    readonly severity: QualitySeverity;
+    readonly description: string;
+}
+export interface QualityPluginContext {
+    /** The parsed file: frontmatter values, the app's `fields` and the Markdown body. */
+    readonly article: BlogArticleInput;
+    /** The body cut into blocks with file lines; fenced code is skipped, `::name{…}` directives are blocks of their own. */
+    readonly blocks: readonly Block[];
+    /** The fenced blocks of the app's block plugins (`quality.blocks`), with the file line of the opening fence. */
+    readonly pluginBlocks: readonly FoundBlock[];
+    /** `YYYY-MM-DD` in the app's time zone. */
+    readonly today: string;
+    /** The app's language ruleset, for its number notation. */
+    readonly ruleset: LanguageRuleset;
+}
+export interface QualityPlugin {
+    /** Names the plugin in a failure message. */
+    readonly name: string;
+    /** Every rule id the plugin may report. A finding with another id is refused as `plugin-rule-undeclared`. */
+    readonly rules: readonly QualityRuleInfo[];
+    /** Pure: no network, no file system. A throw becomes a `plugin-failed` error. */
+    readonly check: (context: QualityPluginContext) => readonly QualityFinding[];
+}
+export declare function isQualityPlugin(value: unknown): value is QualityPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/quality/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/quality/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,0FAA0F;AAC1F,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,wHAAwH;IACxH,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,gHAAgH;IAChH,QAAQ,CAAC,YAAY,EAAE,SAAS,UAAU,EAAE,CAAC;IAC7C,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6GAA6G;IAC7G,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;IAC3C,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,SAAS,cAAc,EAAE,CAAC;CAC9E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAItE"}

package/dist/quality/plugin.js

@@ -0,0 +1,7 @@
+export function isQualityPlugin(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    return typeof candidate.name === "string" && Array.isArray(candidate.rules) && typeof candidate.check === "function";
+}
+//# sourceMappingURL=plugin.js.map

package/dist/quality/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/quality/plugin.ts"],"names":[],"mappings":"AAsCA,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,SAAS,GAAG,KAA6D,CAAC;IAChF,OAAO,OAAO,SAAS,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,CAAC;AACvH,CAAC"}

package/dist/quality/rules/blocks.d.ts

@@ -0,0 +1,5 @@
+import type { BlogArticleInput } from "../../contract.js";
+import type { FoundBlock } from "../../render/render-article.js";
+import type { QualityFinding } from "../finding.js";
+export declare function checkBlockRequires(article: BlogArticleInput, pluginBlocks: readonly FoundBlock[]): QualityFinding[];
+//# sourceMappingURL=blocks.d.ts.map

package/dist/quality/rules/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../../src/quality/rules/blocks.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,SAAS,UAAU,EAAE,GAAG,cAAc,EAAE,CAMnH"}

package/dist/quality/rules/blocks.js

@@ -0,0 +1,35 @@
+export function checkBlockRequires(article, pluginBlocks) {
+    return pluginBlocks.flatMap((block) => block.requires
+        .filter((key) => !hasFrontmatterKey(article, key))
+        .map((key) => ({ rule: "block-requires", severity: "error", message: `the ${block.type} block needs ${key} in the frontmatter`, line: block.line })));
+}
+/** Whether the file set a frontmatter key: a module key with a value, or a key of the app's fields. */
+function hasFrontmatterKey(article, key) {
+    switch (key) {
+        case "id":
+        case "slug":
+        case "kind":
+        case "title":
+        case "description":
+        case "status":
+        case "current_as_of":
+            return true;
+        case "cluster":
+            return article.cluster !== null;
+        case "pillar":
+            return article.isPillar;
+        case "summary":
+            return article.summary !== null;
+        case "published_at":
+            return article.publishedAt !== null;
+        case "sources":
+            return article.sources.length > 0;
+        case "faq":
+            return article.faq.length > 0;
+        case "forms":
+            return article.termForms.length > 0;
+        default:
+            return article.fields[key] !== undefined;
+    }
+}
+//# sourceMappingURL=blocks.js.map

package/dist/quality/rules/blocks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.js","sourceRoot":"","sources":["../../../src/quality/rules/blocks.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,kBAAkB,CAAC,OAAyB,EAAE,YAAmC;IAC/F,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACpC,KAAK,CAAC,QAAQ;SACX,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;SACjD,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAgB,EAAE,OAAO,EAAE,OAAO,KAAK,CAAC,IAAI,gBAAgB,GAAG,qBAAqB,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAChK,CAAC;AACJ,CAAC;AAED,uGAAuG;AACvG,SAAS,iBAAiB,CAAC,OAAyB,EAAE,GAAW;IAC/D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,IAAI,CAAC;QACV,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM,CAAC;QACZ,KAAK,OAAO,CAAC;QACb,KAAK,aAAa,CAAC;QACnB,KAAK,QAAQ,CAAC;QACd,KAAK,eAAe;YAClB,OAAO,IAAI,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC;QAClC,KAAK,QAAQ;YACX,OAAO,OAAO,CAAC,QAAQ,CAAC;QAC1B,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC;QAClC,KAAK,cAAc;YACjB,OAAO,OAAO,CAAC,WAAW,KAAK,IAAI,CAAC;QACtC,KAAK,SAAS;YACZ,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QACpC,KAAK,KAAK;YACR,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QAChC,KAAK,OAAO;YACV,OAAO,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QACtC;YACE,OAAO,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC;IAC7C,CAAC;AACH,CAAC"}

package/dist/quality/rules/images.d.ts

@@ -0,0 +1,4 @@
+import { type ArticleImagePolicy, type FoundImage } from "../../render/images.js";
+import type { QualityFinding } from "../finding.js";
+export declare function checkImages(images: readonly FoundImage[], policy: ArticleImagePolicy | null): QualityFinding[];
+//# sourceMappingURL=images.d.ts.map

package/dist/quality/rules/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../../src/quality/rules/images.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAwC,MAAM,wBAAwB,CAAC;AAC3I,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAiBpD,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,cAAc,EAAE,CAa9G"}

package/dist/quality/rules/images.js

@@ -0,0 +1,33 @@
+// Image rules (BF-3): every image in a body follows the app's image policy (`blog({ images })`), the
+// same check the renderer applies, so a text whose image the page would drop never goes public.
+import { checkArticleImage } from "../../render/images.js";
+const RULE_BY_PROBLEM = { source: "image-source", alt: "image-alt", dimensions: "image-dimensions" };
+function describeProblem(problem, src, policy) {
+    switch (problem) {
+        case "source":
+            return policy === null
+                ? `images are off until the app sets blog({ images }): ${src}`
+                : `an image from outside the site and the allowed hosts (blog({ images: { hosts } })): ${src}`;
+        case "alt":
+            return `an image without alt text; describe what it shows: ${src}`;
+        case "dimensions":
+            return `the app does not know the width and height of an image (blog({ images: { dimensions } })): ${src}`;
+    }
+}
+export function checkImages(images, policy) {
+    return images.flatMap((image) => {
+        let verdict;
+        try {
+            verdict = checkArticleImage(image, policy ?? undefined);
+        }
+        catch (error) {
+            // The resolver is the app's code; its bug refuses the file instead of crashing a publish.
+            const detail = error instanceof Error ? error.message : String(error);
+            return [{ rule: "image-dimensions", severity: "error", message: `the image dimensions resolver failed (${detail}): ${image.src}`, line: image.line }];
+        }
+        if (verdict.ok)
+            return [];
+        return verdict.problems.map((problem) => ({ rule: RULE_BY_PROBLEM[problem], severity: "error", message: describeProblem(problem, image.src, policy), line: image.line }));
+    });
+}
+//# sourceMappingURL=images.js.map

package/dist/quality/rules/images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.js","sourceRoot":"","sources":["../../../src/quality/rules/images.ts"],"names":[],"mappings":"AAAA,qGAAqG;AACrG,gGAAgG;AAChG,OAAO,EAAE,iBAAiB,EAAkF,MAAM,wBAAwB,CAAC;AAG3I,MAAM,eAAe,GAAiC,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;AAEnI,SAAS,eAAe,CAAC,OAAqB,EAAE,GAAW,EAAE,MAAiC;IAC5F,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,MAAM,KAAK,IAAI;gBACpB,CAAC,CAAC,uDAAuD,GAAG,EAAE;gBAC9D,CAAC,CAAC,uFAAuF,GAAG,EAAE,CAAC;QACnG,KAAK,KAAK;YACR,OAAO,sDAAsD,GAAG,EAAE,CAAC;QACrE,KAAK,YAAY;YACf,OAAO,8FAA8F,GAAG,EAAE,CAAC;IAC/G,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAA6B,EAAE,MAAiC;IAC1F,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,IAAI,OAAqB,CAAC;QAC1B,IAAI,CAAC;YACH,OAAO,GAAG,iBAAiB,CAAC,KAAK,EAAE,MAAM,IAAI,SAAS,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0FAA0F;YAC1F,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,OAAO,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,OAAgB,EAAE,OAAO,EAAE,yCAAyC,MAAM,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACjK,CAAC;QACD,IAAI,OAAO,CAAC,EAAE;YAAE,OAAO,EAAE,CAAC;QAC1B,OAAO,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,OAAgB,EAAE,OAAO,EAAE,eAAe,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACrL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/quality/rules/input.d.ts

@@ -0,0 +1,11 @@
+import type { BlogArticleInput } from "../../contract.js";
+import type { Block } from "../blocks.js";
+import type { QualitySettings } from "../settings.js";
+export interface RuleInput {
+    readonly article: BlogArticleInput;
+    readonly blocks: readonly Block[];
+    readonly settings: QualitySettings;
+    /** `YYYY-MM-DD` in the app's time zone. */
+    readonly today: string;
+}
+//# sourceMappingURL=input.d.ts.map

package/dist/quality/rules/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../../src/quality/rules/input.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB"}

package/dist/quality/rules/input.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=input.js.map

package/dist/quality/rules/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../../../src/quality/rules/input.ts"],"names":[],"mappings":""}

package/dist/quality/rules/links.d.ts

@@ -0,0 +1,17 @@
+import type { QualityFinding } from "../finding.js";
+import type { RuleInput } from "./input.js";
+export interface LinkSummary {
+    readonly internal: readonly {
+        readonly pathname: string;
+        readonly line: number;
+    }[];
+    readonly external: readonly {
+        readonly url: string;
+        readonly line: number;
+    }[];
+}
+/** Whether a site path (`/blog/x`, `/calculator`) leads to a page. */
+export type InternalLinkResolver = (pathname: string) => boolean;
+export declare function collectLinks({ blocks, settings }: Pick<RuleInput, "blocks" | "settings">): LinkSummary;
+export declare function checkLinks(input: RuleInput, links: LinkSummary, resolveInternalLink: InternalLinkResolver): QualityFinding[];
+//# sourceMappingURL=links.d.ts.map