@softure-ai/blog 0.0.0-stage → 0.1.6

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

@@ -0,0 +1 @@
+{"version":3,"file":"links.d.ts","sourceRoot":"","sources":["../../../src/quality/rules/links.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnF,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC/E;AAED,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC;AAEjE,wBAAgB,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,UAAU,CAAC,GAAG,WAAW,CAkBtG;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,GAAG,cAAc,EAAE,CAoB5H"}

package/dist/quality/rules/links.js

@@ -0,0 +1,46 @@
+import { findBareUrls, findLinks } from "../text.js";
+export function collectLinks({ blocks, settings }) {
+    const internal = [];
+    const external = [];
+    for (const block of blocks) {
+        if (block.kind === "directive")
+            continue;
+        const urls = findLinks(block.text).map((link) => link.url);
+        if (block.kind === "footnote")
+            urls.push(...findBareUrls(block.text));
+        for (const url of new Set(urls)) {
+            const own = settings.ownOrigins.find((origin) => url === origin || url.startsWith(`${origin}/`) || url.startsWith(`${origin}?`) || url.startsWith(`${origin}#`));
+            if (url.startsWith("/") || own !== undefined) {
+                const rest = own === undefined ? url : url.slice(own.length);
+                internal.push({ pathname: rest.split(/[?#]/)[0] || "/", line: block.line });
+            }
+            else if (/^https?:\/\//.test(url)) {
+                external.push({ url, line: block.line });
+            }
+        }
+    }
+    return { internal, external };
+}
+export function checkLinks(input, links, resolveInternalLink) {
+    const findings = [];
+    const { kind } = input.article;
+    const minimum = input.settings.options.limits.internalLinks[kind];
+    if (links.internal.length < minimum) {
+        findings.push({
+            rule: "internal-links",
+            severity: kind === "article" ? "error" : "warning",
+            message: `${String(links.internal.length)} internal links; at least ${String(minimum)} needed (other texts, the glossary, the app's tools)`,
+        });
+    }
+    for (const link of links.internal) {
+        if (!resolveInternalLink(link.pathname)) {
+            findings.push({ rule: "internal-link-target", severity: "error", message: `an internal link leads nowhere: ${link.pathname}`, line: link.line });
+        }
+    }
+    for (const link of links.external) {
+        if (link.url.startsWith("http://"))
+            findings.push({ rule: "external-link-https", severity: "warning", message: `a link without https: ${link.url}`, line: link.line });
+    }
+    return findings;
+}
+//# sourceMappingURL=links.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../../src/quality/rules/links.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAWrD,MAAM,UAAU,YAAY,CAAC,EAAE,MAAM,EAAE,QAAQ,EAA0C;IACvF,MAAM,QAAQ,GAAyC,EAAE,CAAC;IAC1D,MAAM,QAAQ,GAAoC,EAAE,CAAC;IACrD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YAAE,SAAS;QACzC,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3D,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,KAAK,MAAM,GAAG,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,KAAK,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC;YACjK,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBAC7C,MAAM,IAAI,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9E,CAAC;iBAAM,IAAI,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAgB,EAAE,KAAkB,EAAE,mBAAyC;IACxG,MAAM,QAAQ,GAAqB,EAAE,CAAC;IACtC,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC;IAC/B,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,OAAO,EAAE,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,gBAAgB;YACtB,QAAQ,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YAClD,OAAO,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,6BAA6B,MAAM,CAAC,OAAO,CAAC,sDAAsD;SAC5I,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,mCAAmC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACnJ,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAClC,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,yBAAyB,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACzK,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,13 @@
+import { type Block } from "../blocks.js";
+import type { QualityFinding } from "../finding.js";
+import type { RuleInput } from "./input.js";
+export declare function checkMetadata({ article, settings, today }: RuleInput): QualityFinding[];
+/** The text opens with a paragraph that answers; an article puts a concrete number in its first two paragraphs. */
+export declare function checkLead({ article, blocks, settings }: RuleInput): QualityFinding[];
+/** No H1 (the page title is `title`), no skipped heading level; an article has question sections with short answers. */
+export declare function checkSections({ article, blocks, settings }: RuleInput): QualityFinding[];
+export declare function checkLength({ article, blocks, settings }: RuleInput): QualityFinding[];
+/** Every footnote reference has a definition, and every definition is used. */
+export declare function checkFootnotes({ blocks }: RuleInput): QualityFinding[];
+export declare function getFootnoteDefinitions(blocks: readonly Block[]): Map<string, Block>;
+//# sourceMappingURL=structure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/quality/rules/structure.ts"],"names":[],"mappings":"AAGA,OAAO,EAAkB,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,SAAS,GAAG,cAAc,EAAE,CAmBvF;AAED,mHAAmH;AACnH,wBAAgB,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,SAAS,GAAG,cAAc,EAAE,CAyBpF;AAED,wHAAwH;AACxH,wBAAgB,aAAa,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,SAAS,GAAG,cAAc,EAAE,CAwCxF;AAED,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,SAAS,GAAG,cAAc,EAAE,CAMtF;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,GAAG,cAAc,EAAE,CAetE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAMnF"}

package/dist/quality/rules/structure.js

@@ -0,0 +1,139 @@
+// Structure rules (FIRE_TRACKER `src/lib/blog/quality/rules-structure.ts`): metadata lengths and
+// freshness, a summary, the answer first, heading order, question sections, length and footnotes.
+// Required keys, kinds, slug shape and slug = file name are BL-2's parser's, not repeated here.
+import { getProseBlocks } from "../blocks.js";
+import { countWords, findFootnoteRefs, findSignificantNumbers, toProse } from "../text.js";
+export function checkMetadata({ article, settings, today }) {
+    const findings = [];
+    const { limits } = settings.options;
+    if (article.title.length > limits.titleChars) {
+        findings.push({ rule: "title-length", severity: "warning", message: `the title has ${String(article.title.length)} characters; search engines cut it after about ${String(limits.titleChars)}` });
+    }
+    const { min, max } = limits.descriptionChars;
+    if (article.description.length < min || article.description.length > max) {
+        findings.push({ rule: "description-length", severity: "warning", message: `the description has ${String(article.description.length)} characters; aim for ${String(min)}–${String(max)}` });
+    }
+    if (article.currentAsOf > today) {
+        findings.push({ rule: "as-of-future", severity: "error", message: `current_as_of ${article.currentAsOf} is in the future (today is ${today})` });
+    }
+    else if (daysBetween(article.currentAsOf, today) > limits.staleAfterDays) {
+        findings.push({ rule: "stale", severity: "warning", message: `current_as_of ${article.currentAsOf} is older than ${String(limits.staleAfterDays)} days; the text waits for fresh numbers` });
+    }
+    if (article.kind === "article" && article.summary === null) {
+        findings.push({ rule: "summary-missing", severity: "error", message: "the article has no summary: a few sentences with the answer for the \"in short\" box" });
+    }
+    return findings;
+}
+/** The text opens with a paragraph that answers; an article puts a concrete number in its first two paragraphs. */
+export function checkLead({ article, blocks, settings }) {
+    const first = blocks[0];
+    if (first === undefined)
+        return [{ rule: "lead", severity: "error", message: "the text is empty" }];
+    if (first.kind !== "paragraph") {
+        return [{ rule: "lead", severity: "error", message: "the text starts with a heading or a list; the first block is a paragraph with the answer", line: first.line }];
+    }
+    const findings = [];
+    const limit = settings.options.limits.leadWords[article.kind];
+    const words = countWords(toProse(first.text));
+    if (words > limit) {
+        findings.push({ rule: "lead-length", severity: "warning", message: `the first paragraph has ${String(words)} words; the answer fits in ${String(limit)}`, line: first.line });
+    }
+    if (article.kind === "article") {
+        const opening = blocks.slice(0, 4).filter((block) => block.kind === "paragraph").slice(0, 2);
+        const hasNumber = opening.some((block) => findSignificantNumbers(toProse(block.text), settings.ruleset.notation).length > 0);
+        if (!hasNumber) {
+            findings.push({
+                rule: "lead-number",
+                severity: "error",
+                message: "the first two paragraphs hold no concrete number (an amount or a percentage); the claim with its number goes first",
+                line: first.line,
+            });
+        }
+    }
+    return findings;
+}
+/** No H1 (the page title is `title`), no skipped heading level; an article has question sections with short answers. */
+export function checkSections({ article, blocks, settings }) {
+    const findings = [];
+    let previousLevel = 1;
+    for (const block of blocks) {
+        if (block.kind !== "heading" || block.level === undefined)
+            continue;
+        if (block.level === 1) {
+            findings.push({ rule: "heading-h1", severity: "error", message: "a # heading in the body; the page title comes from title, sections start at ##", line: block.line });
+        }
+        else if (block.level > previousLevel + 1) {
+            findings.push({ rule: "heading-order", severity: "error", message: `heading level ${String(block.level)} follows level ${String(previousLevel)}; do not skip a level`, line: block.line });
+        }
+        previousLevel = block.level;
+    }
+    if (article.kind !== "article")
+        return findings;
+    const sections = blocks.filter((block) => block.kind === "heading" && block.level === 2);
+    if (sections.length < 2) {
+        findings.push({ rule: "sections", severity: "error", message: `the article has ${String(sections.length)} ## sections; it needs at least 2` });
+    }
+    const questions = sections.filter((block) => block.text.trim().endsWith("?"));
+    if (questions.length === 0) {
+        findings.push({ rule: "section-question", severity: "error", message: "no ## heading is a question; answer sections are what AI assistants quote" });
+    }
+    const limit = settings.options.limits.answerWords;
+    for (const question of questions) {
+        const answer = blocks[blocks.indexOf(question) + 1];
+        if (answer?.kind !== "paragraph") {
+            findings.push({ rule: "section-answer", severity: "error", message: `no paragraph with the answer under "${question.text}"`, line: question.line });
+            continue;
+        }
+        const words = countWords(toProse(answer.text));
+        if (words > limit) {
+            findings.push({
+                rule: "section-answer-length",
+                severity: "warning",
+                message: `the answer under "${question.text}" has ${String(words)} words; the first sentences answer directly (at most ${String(limit)})`,
+                line: answer.line,
+            });
+        }
+    }
+    return findings;
+}
+export function checkLength({ article, blocks, settings }) {
+    const words = getProseBlocks(blocks).reduce((sum, block) => sum + countWords(toProse(block.text)), 0);
+    const { min, max } = settings.options.limits.words[article.kind];
+    if (words < min)
+        return [{ rule: "length", severity: "error", message: `the text has ${String(words)} words; ${article.kind === "article" ? "an article" : "a term"} needs at least ${String(min)}` }];
+    if (words > max)
+        return [{ rule: "length", severity: "warning", message: `the text has ${String(words)} words; above ${String(max)} readers and assistants lose the answer` }];
+    return [];
+}
+/** Every footnote reference has a definition, and every definition is used. */
+export function checkFootnotes({ blocks }) {
+    const findings = [];
+    const definitions = getFootnoteDefinitions(blocks);
+    const used = new Set();
+    for (const block of blocks) {
+        if (block.kind === "footnote" || block.kind === "directive")
+            continue;
+        for (const ref of findFootnoteRefs(block.text)) {
+            used.add(ref);
+            if (!definitions.has(ref))
+                findings.push({ rule: "footnote-undefined", severity: "error", message: `footnote [^${ref}] has no definition`, line: block.line });
+        }
+    }
+    for (const [id, block] of definitions) {
+        if (!used.has(id))
+            findings.push({ rule: "footnote-unused", severity: "warning", message: `footnote [^${id}] is not used in the text`, line: block.line });
+    }
+    return findings;
+}
+export function getFootnoteDefinitions(blocks) {
+    const definitions = new Map();
+    for (const block of blocks) {
+        if (block.kind === "footnote" && block.footnoteId !== undefined)
+            definitions.set(block.footnoteId, block);
+    }
+    return definitions;
+}
+function daysBetween(fromIso, toIso) {
+    return Math.round((Date.parse(`${toIso}T00:00:00Z`) - Date.parse(`${fromIso}T00:00:00Z`)) / 86_400_000);
+}
+//# sourceMappingURL=structure.js.map

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

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

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

@@ -0,0 +1,11 @@
+import type { QualityFinding } from "../finding.js";
+import type { StylePattern } from "../rulesets/types.js";
+import type { RuleInput } from "./input.js";
+/** The patterns the prose is matched against: ruleset style, app voice, and profit promises when YMYL is on. */
+export declare function getActivePatterns({ settings }: Pick<RuleInput, "settings">): StylePattern[];
+/** Title, description and summary show in search results and above the text: the error patterns apply to them too. */
+export declare function checkMetadataStyle(input: RuleInput): QualityFinding[];
+export declare function checkStyle(input: RuleInput): QualityFinding[];
+/** Rhythm and formatting: dashes (an error over the limit), bold, bold labels, triads, sentence length and variety, openings, headings. */
+export declare function checkRhythm({ blocks, settings }: RuleInput): QualityFinding[];
+//# sourceMappingURL=style.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../../src/quality/rules/style.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,gHAAgH;AAChH,wBAAgB,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,YAAY,EAAE,CAM3F;AAED,sHAAsH;AACtH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,EAAE,CAQrE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,EAAE,CAE7D;AAgCD,2IAA2I;AAC3I,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,SAAS,GAAG,cAAc,EAAE,CAuE7E"}

package/dist/quality/rules/style.js

@@ -0,0 +1,129 @@
+// Style rules (FIRE_TRACKER `src/lib/blog/quality/rules-style.ts`): the ruleset's patterns, the app's
+// voice and the YMYL profit promises over prose, then rhythm and formatting measures.
+import { getProseBlocks } from "../blocks.js";
+import { countWords, splitSentences, toProse } from "../text.js";
+const PROFIT_PROMISE_MESSAGE = "a promise of profit or an order to buy; not acceptable in a your-money-or-your-life text";
+/** The patterns the prose is matched against: ruleset style, app voice, and profit promises when YMYL is on. */
+export function getActivePatterns({ settings }) {
+    const patterns = [...settings.ruleset.patterns, ...settings.voicePatterns];
+    if (settings.options.ymyl !== null) {
+        patterns.push({ id: "profit-promise", severity: "error", pattern: settings.ruleset.profitPromises, message: PROFIT_PROMISE_MESSAGE });
+    }
+    return patterns;
+}
+/** Title, description and summary show in search results and above the text: the error patterns apply to them too. */
+export function checkMetadataStyle(input) {
+    const { title, description, summary } = input.article;
+    const blocks = [title, description, ...(summary === null ? [] : [summary])].map((text) => ({ kind: "paragraph", text, line: 1 }));
+    return matchPatterns(blocks, getActivePatterns(input).filter((pattern) => pattern.severity === "error")).map((finding) => ({
+        rule: finding.rule,
+        severity: finding.severity,
+        message: `title, description or summary: ${finding.message}`,
+    }));
+}
+export function checkStyle(input) {
+    return matchPatterns(getProseBlocks(input.blocks), getActivePatterns(input));
+}
+/** One error per pattern and block; warnings aggregated to one finding per pattern with a count. */
+function matchPatterns(blocks, patterns) {
+    const findings = [];
+    const warningHits = new Map();
+    for (const block of blocks) {
+        const prose = toProse(block.text);
+        for (const style of patterns) {
+            const matches = [...prose.matchAll(style.pattern)];
+            const first = matches[0]?.[0];
+            if (first === undefined)
+                continue;
+            if (style.severity === "error") {
+                findings.push({ rule: style.id, severity: "error", message: `"${first}": ${style.message}`, line: block.line });
+            }
+            else {
+                const hit = warningHits.get(style.id) ?? { count: 0, line: block.line, sample: first };
+                hit.count += matches.length;
+                warningHits.set(style.id, hit);
+            }
+        }
+    }
+    for (const style of patterns) {
+        const hit = warningHits.get(style.id);
+        if (hit !== undefined) {
+            findings.push({ rule: style.id, severity: "warning", message: `${String(hit.count)}x (e.g. "${hit.sample}"): ${style.message}`, line: hit.line });
+        }
+    }
+    return findings;
+}
+const DASH = /\s[—–-]\s|—/g;
+/** Rhythm and formatting: dashes (an error over the limit), bold, bold labels, triads, sentence length and variety, openings, headings. */
+export function checkRhythm({ blocks, settings }) {
+    const findings = [];
+    const { limits } = settings.options;
+    const prose = getProseBlocks(blocks).filter((block) => block.kind !== "heading" && block.kind !== "table");
+    const proseText = prose.map((block) => toProse(block.text));
+    const totalWords = proseText.reduce((sum, text) => sum + countWords(text), 0);
+    const dashes = proseText.reduce((sum, text) => sum + (text.match(DASH)?.length ?? 0), 0);
+    if (dashes >= 3 && dashes > totalWords / limits.wordsPerDash) {
+        findings.push({
+            rule: "dashes",
+            severity: "error",
+            message: `${String(dashes)} dashes in ${String(totalWords)} words; at most one per ${String(limits.wordsPerDash)}: use a full stop, a comma or a colon`,
+        });
+    }
+    for (const [index, block] of prose.entries()) {
+        if ((proseText[index]?.match(DASH)?.length ?? 0) >= 2)
+            findings.push({ rule: "dashes-paragraph", severity: "warning", message: "two dashes in one paragraph", line: block.line });
+    }
+    const bold = blocks.reduce((sum, block) => sum + (block.text.match(/\*\*[^*]+\*\*/g)?.length ?? 0), 0);
+    if (bold > 0 && bold > totalWords / limits.wordsPerBold) {
+        findings.push({ rule: "bold-density", severity: "warning", message: `${String(bold)} bold phrases in ${String(totalWords)} words; bold stops standing out` });
+    }
+    const boldLabels = blocks.filter((block) => block.kind === "listItem" && /^\*\*[^*]+:\*\*|^\*\*[^*]+\*\*:/.test(block.text));
+    const firstLabel = boldLabels[0];
+    if (firstLabel !== undefined && boldLabels.length >= 3) {
+        findings.push({
+            rule: "bold-labels",
+            severity: "warning",
+            message: `${String(boldLabels.length)} list items start with a bold label; the "**Label:** text" template`,
+            line: firstLabel.line,
+        });
+    }
+    const triads = proseText.reduce((sum, text) => sum + (text.match(settings.ruleset.triad)?.length ?? 0), 0);
+    if (triads > 3)
+        findings.push({ rule: "triads", severity: "warning", message: `${String(triads)} lists of three; two items sound less like a template than three` });
+    const sentences = proseText.flatMap((text) => splitSentences(text));
+    const lengths = sentences.map((sentence) => countWords(sentence));
+    const long = lengths.filter((length) => length > limits.sentenceWords).length;
+    if (long > 0)
+        findings.push({ rule: "long-sentences", severity: "warning", message: `${String(long)} sentences longer than ${String(limits.sentenceWords)} words` });
+    if (lengths.length >= 12) {
+        const mean = lengths.reduce((sum, length) => sum + length, 0) / lengths.length;
+        const deviation = Math.sqrt(lengths.reduce((sum, length) => sum + (length - mean) ** 2, 0) / lengths.length);
+        if (deviation < 4) {
+            findings.push({
+                rule: "monotone-rhythm",
+                severity: "warning",
+                message: `the sentences have similar lengths (mean ${mean.toFixed(0)} words, deviation ${deviation.toFixed(1)}); mix short ones with long ones`,
+            });
+        }
+    }
+    for (let index = 2; index < sentences.length; index += 1) {
+        const openings = sentences.slice(index - 2, index + 1).map((sentence) => sentence.split(" ")[0]?.toLowerCase());
+        const opening = openings[0];
+        if (opening !== undefined && openings.every((other) => other === opening)) {
+            findings.push({ rule: "repeated-openings", severity: "warning", message: `three sentences in a row start with "${opening}"` });
+            break;
+        }
+    }
+    if (settings.ruleset.flagsTitleCaseHeadings) {
+        for (const block of blocks) {
+            if (block.kind !== "heading")
+                continue;
+            const words = block.text.split(/\s+/).filter((word) => /^\p{L}/u.test(word));
+            if (words.length >= 3 && words.every((word) => /^\p{Lu}/u.test(word))) {
+                findings.push({ rule: "title-case-heading", severity: "warning", message: `heading "${block.text}": only the first word starts with a capital letter`, line: block.line });
+            }
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=style.js.map

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

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

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

@@ -0,0 +1,5 @@
+import type { QualityFinding } from "../finding.js";
+import type { RuleInput } from "./input.js";
+export declare function checkSources({ article }: RuleInput): QualityFinding[];
+export declare function checkNumberSources({ article, blocks, settings }: RuleInput): QualityFinding[];
+//# sourceMappingURL=ymyl.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ymyl.d.ts","sourceRoot":"","sources":["../../../src/quality/rules/ymyl.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,wBAAgB,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,GAAG,cAAc,EAAE,CAWrE;AAED,wBAAgB,kBAAkB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,SAAS,GAAG,cAAc,EAAE,CA2B7F"}

package/dist/quality/rules/ymyl.js

@@ -0,0 +1,51 @@
+import { findBareUrls, findFootnoteRefs, findSignificantNumbers, toProse } from "../text.js";
+import { getFootnoteDefinitions } from "./structure.js";
+export function checkSources({ article }) {
+    const findings = [];
+    if (article.kind === "article" && article.sources.length === 0) {
+        findings.push({ rule: "sources-missing", severity: "error", message: "the article lists no sources (name and address of each)" });
+    }
+    for (const source of article.sources) {
+        if (!source.url.startsWith("https://")) {
+            findings.push({ rule: "source-https", severity: "error", message: `source "${source.name}" has an address without https: ${source.url}` });
+        }
+    }
+    return findings;
+}
+export function checkNumberSources({ article, blocks, settings }) {
+    const findings = [];
+    const { notation } = settings.ruleset;
+    const mark = settings.options.ymyl?.ownCalculationMark ?? null;
+    for (const block of blocks) {
+        if (block.kind === "footnote" || block.kind === "directive" || block.kind === "heading")
+            continue;
+        const numbers = findSignificantNumbers(toProse(block.text), notation);
+        if (numbers.length > 0 && findFootnoteRefs(block.text).length === 0 && !isTableSourcedNearby(blocks, block)) {
+            const remedy = mark === null ? "add a footnote with the source's address" : `add a footnote with the source's address or "${mark}"`;
+            findings.push({ rule: "number-source", severity: "error", message: `a number without a source: ${numbers.slice(0, 3).join(", ")}; ${remedy}`, line: block.line });
+        }
+    }
+    const sourceUrls = new Set(article.sources.map((source) => source.url));
+    for (const [id, block] of getFootnoteDefinitions(blocks)) {
+        const urls = findBareUrls(block.text);
+        const isOwnCalculation = mark !== null && block.text.toLowerCase().includes(mark.toLowerCase());
+        if (urls.length === 0 && !isOwnCalculation) {
+            const message = mark === null ? `footnote [^${id}] has no source address` : `footnote [^${id}] has neither a source address nor "${mark}"`;
+            findings.push({ rule: "footnote-source", severity: "error", message, line: block.line });
+        }
+        for (const url of urls) {
+            if (!sourceUrls.has(url)) {
+                findings.push({ rule: "footnote-not-in-sources", severity: "error", message: `the address in footnote [^${id}] is not in sources: ${url}`, line: block.line });
+            }
+        }
+    }
+    return findings;
+}
+/** A table has no room for a footnote per cell, so the paragraph right above or below may carry it. */
+function isTableSourcedNearby(blocks, table) {
+    if (table.kind !== "table")
+        return false;
+    const index = blocks.indexOf(table);
+    return [blocks[index - 1], blocks[index + 1]].some((neighbour) => neighbour?.kind === "paragraph" && findFootnoteRefs(neighbour.text).length > 0);
+}
+//# sourceMappingURL=ymyl.js.map

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

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

package/dist/quality/rulesets/en/ruleset.d.ts

@@ -0,0 +1,3 @@
+import type { LanguageRuleset } from "../types.js";
+export declare const enRuleset: LanguageRuleset;
+//# sourceMappingURL=ruleset.d.ts.map

package/dist/quality/rulesets/en/ruleset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ruleset.d.ts","sourceRoot":"","sources":["../../../../src/quality/rulesets/en/ruleset.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,SAAS,EAAE,eA8GvB,CAAC"}

package/dist/quality/rulesets/en/ruleset.js

@@ -0,0 +1,106 @@
+// The English ruleset: the same habits as the Polish one, in English, after `blader/humanizer` and
+// `hardikpandya/stop-slop`. Errors are habits a careful author uses rarely and on purpose; warnings
+// are words that say nothing alone but betray a template in a cluster.
+import { wordPattern } from "../../text.js";
+export const enRuleset = {
+    language: "en",
+    patterns: [
+        {
+            id: "announcement",
+            severity: "error",
+            pattern: wordPattern("it(?:'s| is) (?:worth|important to) (?:noting|note|mentioning|mention|pointing out|highlighting|emphasizing)|it should be noted|needless to say"),
+            message: "an announcement instead of a fact; write the fact",
+        },
+        {
+            id: "these-days",
+            severity: "error",
+            pattern: wordPattern("in today's (?:fast-paced |ever-changing |digital |modern )?(?:world|age|era|landscape)|in this day and age|in the modern era|now more than ever"),
+            message: "an empty opener about \"these times\"; start with a number or the answer",
+        },
+        {
+            id: "not-only-but-also",
+            severity: "error",
+            pattern: wordPattern("not only[^.!?]{1,120}? but also"),
+            message: "\"not only…, but also\"; name both things plainly",
+        },
+        {
+            id: "not-x-but-y",
+            severity: "error",
+            pattern: wordPattern("it(?:'s| is) not (?:just |only |about )?[^.!?,;]{1,60}[,;] it(?:'s| is)|this isn't (?:just )?[^.!?,;]{1,60}[,;] it's"),
+            message: "the \"it is not X, it is Y\" contrast; say Y right away",
+        },
+        {
+            id: "meta-commentary",
+            severity: "error",
+            pattern: wordPattern("in this (?:article|post|guide|piece|blog post)|let's (?:dive|delve|take a (?:closer )?look|explore|break (?:it|this) down)|without further ado|as (?:we )?(?:mentioned|discussed) (?:earlier|above|before)|as you'll see|you'll learn|read on to"),
+            message: "the text talks about itself instead of the topic; remove the announcement",
+        },
+        {
+            id: "throat-clearing",
+            severity: "error",
+            pattern: wordPattern("the truth is|here's (?:why|how|what|the thing)|here's where|interestingly|importantly|undoubtedly|without a doubt|it goes without saying|make no mistake|the reality is"),
+            message: "a run-up before the point; cut it and start with the point",
+        },
+        {
+            id: "empty-conclusion",
+            severity: "error",
+            pattern: wordPattern("in conclusion|to sum up|to summarize|in summary|all in all|at the end of the day|the bottom line is"),
+            message: "an empty conclusion; end with the last concrete fact",
+        },
+        {
+            id: "crucial",
+            severity: "error",
+            pattern: wordPattern("crucial|pivotal|delve|delves|delving|tapestry|testament to"),
+            message: "a favourite word of language models; name what depends on the thing",
+        },
+        {
+            id: "plays-a-role",
+            severity: "error",
+            pattern: wordPattern("plays? an? (?:\\p{L}+ )?role|playing an? (?:\\p{L}+ )?role"),
+            message: "\"plays a role\"; write what the thing does",
+        },
+        {
+            id: "puffery",
+            severity: "error",
+            pattern: wordPattern("game[- ]changer|groundbreaking|revolutionary|cutting-edge|unparalleled|invaluable|holistic|comprehensive guide|ultimate guide|a wide (?:range|array|variety) of|navigat(?:e|ing) the (?:complex |ever-changing )?(?:world|landscape|maze) of|ever-evolving|ever-changing landscape|seamless(?:ly)?|there(?:'s| is) no one-size-fits-all|depends on many factors"),
+            message: "an inflated or empty phrase; replace it with a fact",
+        },
+        {
+            id: "chatbot-phrases",
+            severity: "error",
+            pattern: wordPattern("I hope this helps|let me know if|feel free to|great question|as an AI(?: language model)?|as of my (?:last|knowledge) (?:update|cutoff)|happy to help|I'd be happy to"),
+            message: "a leftover of a chat with an assistant; remove it",
+        },
+        {
+            id: "emoji",
+            severity: "error",
+            pattern: /\p{Extended_Pictographic}/gu,
+            message: "an emoji in the text; remove it",
+        },
+        {
+            id: "filler-words",
+            severity: "warning",
+            pattern: wordPattern("moreover|furthermore|additionally|in addition|in other words|simply put|very|really|truly|absolutely|definitely|literally|basically|essentially|actually|just|optimal|leverage|robust|remember that"),
+            message: "a filler word; check whether the sentence says the same without it",
+        },
+        {
+            id: "exclamation",
+            severity: "warning",
+            pattern: /!/g,
+            message: "an exclamation mark; a guide speaks calmly",
+        },
+    ],
+    firstPersonSingular: wordPattern("I|I'm|I've|I'd|I'll|me|my|mine|myself|in my (?:opinion|view|experience)|personally"),
+    profitPromises: wordPattern("guaranteed (?:returns?|profits?|income|gains?)|(?:a )?sure (?:profit|bet|thing)|(?<!not |never |isn't |aren't )risk[- ]free|zero risk|no risk|(?:you )?can(?:'t|not) lose|you will (?:definitely |surely )?(?:profit|earn|get rich)|buy (?:now|today)|you (?:must|need to|have to) (?:buy|invest)|get rich quick|quick (?:profits?|riches)|easy money|effortless (?:income|returns?|wealth)"),
+    notation: {
+        number: /\d{1,3}(?:,\d{3})+(?:\.\d+)?|\d+(?:\.\d+)?/g,
+        unitAfter: /^\s?(?:%|percent\b|per cent\b|USD\b|EUR\b|GBP\b|dollars?\b|euros?\b|pounds?\b|k\b|thousand\b|million\b|billion\b|bn\b)/iu,
+        unitBefore: /(?:[$€£]|USD ?|EUR ?|GBP ?)$/u,
+        referenceBefore: /(?:§|section|sec\.|art\.|article|no\.|chapter|clause|rule|part)\s*$/iu,
+        thousandsSeparator: /,/,
+        decimalSeparator: ".",
+    },
+    triad: /(?<![\p{L}])\p{L}+, \p{L}+,? (?:and|or) \p{L}+(?![\p{L}])/gu,
+    flagsTitleCaseHeadings: false,
+};
+//# sourceMappingURL=ruleset.js.map

package/dist/quality/rulesets/en/ruleset.js.map

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

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

@@ -0,0 +1,7 @@
+import { enRuleset } from "./en/ruleset.js";
+import { plRuleset } from "./pl/ruleset.js";
+import type { LanguageRuleset, QualityLanguage } from "./types.js";
+export declare const QUALITY_RULESETS: Readonly<Record<QualityLanguage, LanguageRuleset>>;
+export { enRuleset, plRuleset };
+export { QUALITY_LANGUAGES, type LanguageRuleset, type QualityLanguage, type StylePattern } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/quality/rulesets/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEnE,eAAO,MAAM,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,CAAoC,CAAC;AAErH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/quality/rulesets/index.js

@@ -0,0 +1,7 @@
+// The language rulesets an app chooses from with `blog({ quality: { language } })`.
+import { enRuleset } from "./en/ruleset.js";
+import { plRuleset } from "./pl/ruleset.js";
+export const QUALITY_RULESETS = { en: enRuleset, pl: plRuleset };
+export { enRuleset, plRuleset };
+export { QUALITY_LANGUAGES } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/quality/rulesets/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/quality/rulesets/index.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAG5C,MAAM,CAAC,MAAM,gBAAgB,GAAuD,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC;AAErH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAChC,OAAO,EAAE,iBAAiB,EAAiE,MAAM,YAAY,CAAC"}