@softure-ai/blog 0.0.0-stage → 0.1.6

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

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

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

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

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

@@ -0,0 +1,114 @@
+// The Polish ruleset (FIRE_TRACKER `src/lib/blog/quality/rules-style.ts`, `text.ts`). A translation and
+// extension of `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.
+// FIRE's voice (no first person singular) and finance phrases are app config, not Polish.
+import { wordPattern } from "../../text.js";
+const L = "\\p{L}*";
+export const plRuleset = {
+    language: "pl",
+    patterns: [
+        {
+            id: "announcement",
+            severity: "error",
+            pattern: wordPattern("(?:warto|należy) (?:zauważyć|podkreślić|wspomnieć|nadmienić|dodać|zaznaczyć)"),
+            message: "an announcement instead of a fact; write the fact",
+        },
+        {
+            id: "these-days",
+            severity: "error",
+            pattern: wordPattern(`w dzisiejszych czasach|w dzisiejszym (?:świecie|dynamicznym${L})|w dobie|w obecnych czasach`),
+            message: "an empty opener about \"these times\"; start with a number or the answer",
+        },
+        {
+            id: "not-only-but-also",
+            severity: "error",
+            pattern: wordPattern("nie tylko[^.!?]{1,120}?,? (?:ale|lecz) (?:także|również|też|i)"),
+            message: "\"not only…, but also\"; name both things plainly",
+        },
+        {
+            id: "not-x-but-y",
+            severity: "error",
+            pattern: wordPattern("(?:to nie (?:jest )?[^.!?,]{1,60}, (?:to|tylko|lecz)|nie chodzi o [^.!?]{1,80}[.,] (?:chodzi o|tylko o|lecz o))"),
+            message: "the \"it is not X, it is Y\" contrast; say Y right away",
+        },
+        {
+            id: "meta-commentary",
+            severity: "error",
+            pattern: wordPattern("w (?:tym|niniejszym) (?:artykule|tekście|wpisie|poradniku)|przyjrzyjmy się|zanurzmy się|przejdźmy (?:teraz )?do|jak (?:już )?wspomniano|jak zaraz zobaczysz|jak zobaczymy|dowiesz się (?:z tego|w tym)"),
+            message: "the text talks about itself instead of the topic; remove the announcement",
+        },
+        {
+            id: "throat-clearing",
+            severity: "error",
+            pattern: wordPattern("prawda jest taka|oto (?:dlaczego|jak|co|czemu)|i tu pojawia się|co ciekawe|co ważne|co istotne|nie da się ukryć|nie ulega wątpliwości|bez wątpienia|niewątpliwie|bezsprzecznie"),
+            message: "a run-up before the point; cut it and start with the point",
+        },
+        {
+            id: "empty-conclusion",
+            severity: "error",
+            pattern: wordPattern("podsumowując|reasumując|w podsumowaniu|na zakończenie|konkludując|krótko podsumowując"),
+            message: "an empty conclusion; end with the last concrete fact",
+        },
+        {
+            id: "crucial",
+            severity: "error",
+            pattern: wordPattern(`kluczow${L}`),
+            message: "\"crucial\", the most common Polish tic of language models; name what depends on the thing",
+        },
+        {
+            id: "plays-a-role",
+            severity: "error",
+            pattern: wordPattern(`odgryw${L} (?:\\p{L}+ )?rolę`),
+            message: "\"plays a role\"; write what the thing does",
+        },
+        {
+            id: "puffery",
+            severity: "error",
+            pattern: wordPattern(`kamień milowy|przełomow${L}|rewolucyjn${L}|game[- ]changer${L}|klucz do sukcesu|nieocenion${L}|holistyczn${L}|kompleksow${L}|szerok${L} (?:wachlarz${L}|gam${L}|spektrum)|w gąszczu|dynamicznie zmieniając${L}|nie ma jednej (?:dobrej |właściwej |uniwersalnej |prostej )?odpowiedzi|zależy od wielu czynników`),
+            message: "an inflated or empty phrase; replace it with a fact",
+        },
+        {
+            id: "chatbot-phrases",
+            severity: "error",
+            pattern: wordPattern("mam nadzieję, że|daj (?:mi )?znać|chętnie pomogę|świetne pytanie|jako model językowy|według mojej wiedzy|na dzień mojej wiedzy|w razie pytań"),
+            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(`ponadto|dodatkowo|co więcej|istotn${L}|fundamentaln${L}|innymi słowy|krótko mówiąc|w rezultacie|niezwykle|niezmiernie|naprawdę|absolutnie|zdecydowanie|dosłownie|po prostu|optymaln${L}|efektywn${L}|pamiętaj, że|warto`),
+            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",
+        },
+        {
+            id: "straight-quotes",
+            severity: "warning",
+            pattern: /[“"]/g,
+            message: "an English quotation mark; Polish uses „…”",
+        },
+    ],
+    firstPersonSingular: wordPattern("ja|mnie|mój|moja|moje|mojego|mojej|moim|moich|moją|mi|uważam|sądzę|myślę|moim zdaniem|osobiście"),
+    profitPromises: wordPattern(`gwarantowan${L} (?:zysk${L}|zwrot${L}|dochód${L}|zarobek${L})|pewn${L} zysk${L}|(?<!nie (?:jest|są|ma|będzie) )bez (?:żadnego )?ryzyka|zero ryzyka|nie (?:możesz|można) (?:nic )?stracić|na pewno zarobisz|zarobisz na pewno|kup(?:uj)? (?:teraz|już dziś)|musisz (?:kupić|zainwestować)|szybk${L} (?:zysk${L}|wzbogacen${L})|łatw${L} pieniądz${L}|bez wysiłku`),
+    notation: {
+        number: /\d{1,3}(?:[ \u00a0\u202f]\d{3})+(?:,\d+)?|\d+(?:,\d+)?/g,
+        unitAfter: /^\s?(?:%|proc|zł|złotych|zl\b|PLN|tys|mln|mld|groszy|gr\b)/iu,
+        unitBefore: null,
+        referenceBefore: /(?:art\.|ust\.|poz\.|pkt|§|nr|Dz\.\s?U\.?|M\.P\.)\s*$/iu,
+        thousandsSeparator: /[ \u00a0\u202f]/,
+        decimalSeparator: ",",
+    },
+    triad: /(?<![\p{L}])\p{L}+, \p{L}+,? (?:i|oraz) \p{L}+(?![\p{L}])/gu,
+    flagsTitleCaseHeadings: true,
+};
+//# sourceMappingURL=ruleset.js.map

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

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

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

@@ -0,0 +1,28 @@
+import type { QualitySeverity } from "../finding.js";
+import type { NumberNotation } from "../text.js";
+export declare const QUALITY_LANGUAGES: readonly ["en", "pl"];
+export type QualityLanguage = (typeof QUALITY_LANGUAGES)[number];
+export interface StylePattern {
+    /** The rule id; the same id in two rulesets names the same habit. */
+    readonly id: string;
+    readonly severity: QualitySeverity;
+    /** Global, so every hit counts. */
+    readonly pattern: RegExp;
+    /** What is wrong and what to write instead. */
+    readonly message: string;
+}
+export interface LanguageRuleset {
+    readonly language: QualityLanguage;
+    /** AI-writing and generic style patterns. Errors: one hit is enough. Warnings: reported once per rule with a count. */
+    readonly patterns: readonly StylePattern[];
+    /** First person singular, for apps whose texts are signed by an editorial team (`voice.forbidFirstPersonSingular`). */
+    readonly firstPersonSingular: RegExp;
+    /** Promises of profit and orders to buy (YMYL). */
+    readonly profitPromises: RegExp;
+    readonly notation: NumberNotation;
+    /** An enumeration of three ("a, b and c"); more than three in a text reads as a template. */
+    readonly triad: RegExp;
+    /** Whether Title Case Headings are a mistake in this language. */
+    readonly flagsTitleCaseHeadings: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/quality/rulesets/types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,iBAAiB,uBAAwB,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,MAAM,WAAW,YAAY;IAC3B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,mCAAmC;IACnC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,uHAAuH;IACvH,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;IAC3C,uHAAuH;IACvH,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kEAAkE;IAClE,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;CAC1C"}

package/dist/quality/rulesets/types.js

@@ -0,0 +1,2 @@
+export const QUALITY_LANGUAGES = ["en", "pl"];
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/quality/rulesets/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,IAAI,CAAU,CAAC"}

package/dist/quality/settings.d.ts

@@ -0,0 +1,26 @@
+import type { SoftureConfig } from "@softure-ai/core";
+import type { ArticleImagePolicy } from "../render/images.js";
+import type { QualitySeverity } from "./finding.js";
+import type { QualityOptions } from "./options.js";
+import type { LanguageRuleset, StylePattern } from "./rulesets/types.js";
+export interface QualitySettings {
+    readonly options: QualityOptions;
+    readonly ruleset: LanguageRuleset;
+    /** The app's voice phrases plus, when switched on, the ruleset's first person singular. */
+    readonly voicePatterns: readonly StylePattern[];
+    /** Origins whose absolute links are internal: the app's `appOrigin`, the site origin and `ownOrigins`. */
+    readonly ownOrigins: readonly string[];
+    /** IANA time zone of "today". */
+    readonly timeZone: string;
+    /** The app's image policy (`blog({ images })`); `null` when bodies may show no image. */
+    readonly images: ArticleImagePolicy | null;
+}
+export declare function resolveQualitySettings(options: QualityOptions, config: Pick<SoftureConfig, "appOrigin" | "timezone"> & {
+    /** The canonical site origin (core's `getSiteUrls(config).origin`) when it is not `appOrigin`. */
+    readonly siteOrigin?: string;
+}, images?: ArticleImagePolicy | null): QualitySettings;
+/** `YYYY-MM-DD` of a moment in a time zone. */
+export declare function getLocalDate(moment: Date, timeZone: string): string;
+/** The severity a finding of `rule` gets: the override, else its own; `null` for "off". */
+export declare function getEffectiveSeverity(settings: QualitySettings, rule: string, severity: QualitySeverity): QualitySeverity | null;
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/quality/settings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,2FAA2F;IAC3F,QAAQ,CAAC,aAAa,EAAE,SAAS,YAAY,EAAE,CAAC;IAChD,0GAA0G;IAC1G,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;CAC5C;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,IAAI,CAAC,aAAa,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG;IACtD,kGAAkG;IAClG,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,EACD,MAAM,GAAE,kBAAkB,GAAG,IAAW,GACvC,eAAe,CAkBjB;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,eAAe,GAAG,IAAI,CAI/H"}

package/dist/quality/settings.js

@@ -0,0 +1,32 @@
+import { QUALITY_RULESETS } from "./rulesets/index.js";
+export function resolveQualitySettings(options, config, images = null) {
+    const ruleset = QUALITY_RULESETS[options.language];
+    const voicePatterns = options.voice.phrases.map((phrase) => ({
+        id: phrase.id,
+        severity: phrase.severity,
+        pattern: phrase.pattern,
+        message: phrase.message,
+    }));
+    if (options.voice.forbidFirstPersonSingular) {
+        voicePatterns.push({
+            id: "first-person-singular",
+            severity: "error",
+            pattern: ruleset.firstPersonSingular,
+            message: "first person singular; the texts are signed by the editors (\"we\", \"you\"), never \"I\"",
+        });
+    }
+    const origins = [config.appOrigin, ...(config.siteOrigin === undefined ? [] : [config.siteOrigin]), ...options.ownOrigins].map((origin) => new URL(origin).origin);
+    return { options, ruleset, voicePatterns, ownOrigins: [...new Set(origins)], timeZone: config.timezone, images };
+}
+/** `YYYY-MM-DD` of a moment in a time zone. */
+export function getLocalDate(moment, timeZone) {
+    return new Intl.DateTimeFormat("en-CA", { timeZone, year: "numeric", month: "2-digit", day: "2-digit" }).format(moment);
+}
+/** The severity a finding of `rule` gets: the override, else its own; `null` for "off". */
+export function getEffectiveSeverity(settings, rule, severity) {
+    const override = settings.options.severity[rule];
+    if (override === undefined)
+        return severity;
+    return override === "off" ? null : override;
+}
+//# sourceMappingURL=settings.js.map

package/dist/quality/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/quality/settings.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAgBvD,MAAM,UAAU,sBAAsB,CACpC,OAAuB,EACvB,MAGC,EACD,SAAoC,IAAI;IAExC,MAAM,OAAO,GAAG,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,MAAM,aAAa,GAAmB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAC3E,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAC,CAAC;IACJ,IAAI,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,CAAC;QAC5C,aAAa,CAAC,IAAI,CAAC;YACjB,EAAE,EAAE,uBAAuB;YAC3B,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,OAAO,CAAC,mBAAmB;YACpC,OAAO,EAAE,2FAA2F;SACrG,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC;IACnK,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;AACnH,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,YAAY,CAAC,MAAY,EAAE,QAAgB;IACzD,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC1H,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,oBAAoB,CAAC,QAAyB,EAAE,IAAY,EAAE,QAAyB;IACrG,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IAC5C,OAAO,QAAQ,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC9C,CAAC"}

package/dist/quality/text.d.ts

@@ -0,0 +1,43 @@
+export interface MarkdownLink {
+    readonly text: string;
+    readonly url: string;
+}
+/** How a language writes numbers, and which numbers count as facts that need a source. */
+export interface NumberNotation {
+    /** A number token; global. */
+    readonly number: RegExp;
+    /** A unit right after the number (`%`, a currency, "million"); tested on the text that follows. */
+    readonly unitAfter: RegExp;
+    /** A unit right before the number (`$`); tested on the text before. `null`: none. */
+    readonly unitBefore: RegExp | null;
+    /** A legal or list reference before the number ("art.", "§", "no."), which needs no source. */
+    readonly referenceBefore: RegExp;
+    /** The digits to remove before reading the number (thousands separators). */
+    readonly thousandsSeparator: RegExp;
+    readonly decimalSeparator: "," | ".";
+}
+export declare function findLinks(text: string): MarkdownLink[];
+export declare function findFootnoteRefs(text: string): string[];
+/** Bare URLs in a text (a footnote definition), without trailing punctuation. */
+export declare function findBareUrls(text: string): string[];
+/** The prose a reader sees: no code, images, link targets, footnote refs, URLs or emphasis markers. */
+export declare function toProse(text: string): string;
+export declare function countWords(prose: string): number;
+/**
+ * Sentences of prose. A boundary is `.`, `!`, `?` or `…` before an upper-case letter, a quote or a
+ * bracket, never before a digit, so "art. 27" and "approx. 300" do not cut a sentence.
+ */
+export declare function splitSentences(prose: string): string[];
+/**
+ * The numbers that need a source: amounts, percentages and numbers from 1000 up. Ages, years
+ * (1900–2100), small counts and legal references ("art. 27") need none, or every text about law
+ * would fail.
+ */
+export declare function findSignificantNumbers(prose: string, notation: NumberNotation): string[];
+/** "28 260,50" (pl) or "28,260.50" (en) → 28260.5. */
+export declare function parseNumber(raw: string, notation: NumberNotation): number;
+/** A number without thousands separators, to compare a text with a table. */
+export declare function normalizeNumber(raw: string, notation: NumberNotation): string;
+/** A case-insensitive pattern with word edges that know non-ASCII letters (`\b` knows only ASCII). */
+export declare function wordPattern(source: string): RegExp;
+//# sourceMappingURL=text.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/quality/text.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,0FAA0F;AAC1F,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mGAAmG;IACnG,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,+FAA+F;IAC/F,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,6EAA6E;IAC7E,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,GAAG,GAAG,GAAG,CAAC;CACtC;AAUD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEvD;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAEnD;AAED,uGAAuG;AACvG,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY5C;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAKtD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE,CAgBxF;AAED,sDAAsD;AACtD,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAGzE;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,CAE7E;AAED,sGAAsG;AACtG,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAElD"}

package/dist/quality/text.js

@@ -0,0 +1,85 @@
+// Text helpers of the gate (FIRE_TRACKER `src/lib/blog/quality/text.ts`): prose without markup, words,
+// sentences, links, footnote references and the numbers that need a source. Number notation comes
+// from the language ruleset, so "28 260,50" and "28,260.50" both read as one number.
+// No `[` inside link text, link target or footnote id: each match attempt ends at the next `[`, so a
+// long run of unclosed brackets stays linear instead of rescanning the rest of the text per bracket.
+// An image (`![alt](src)`) is not a link: the lookbehind skips it, and `IMAGE` removes it from prose.
+const LINK = /(?<!!)\[([^[\]]*)\]\(([^)\s[]+)(?:\s+"[^"]*")?\)/g;
+const IMAGE = /!\[[^[\]]*\]\([^)\s[]+(?:\s+"[^"]*")?\)/g;
+const FOOTNOTE_REF = /\[\^([^[\]]+)\]/g;
+const URL_IN_TEXT = /https?:\/\/[^\s)>\]]+/g;
+export function findLinks(text) {
+    return [...text.matchAll(LINK)].map((match) => ({ text: match[1] ?? "", url: match[2] ?? "" }));
+}
+export function findFootnoteRefs(text) {
+    return [...text.matchAll(FOOTNOTE_REF)].map((match) => match[1] ?? "");
+}
+/** Bare URLs in a text (a footnote definition), without trailing punctuation. */
+export function findBareUrls(text) {
+    return [...text.matchAll(URL_IN_TEXT)].map((match) => match[0].replace(/[.,;]$/, ""));
+}
+/** The prose a reader sees: no code, images, link targets, footnote refs, URLs or emphasis markers. */
+export function toProse(text) {
+    return text
+        .replace(/`[^`]*`/g, " ")
+        .replace(IMAGE, " ")
+        .replace(LINK, "$1")
+        .replace(FOOTNOTE_REF, "")
+        .replace(/<https?:\/\/[^>]+>/g, " ")
+        .replace(/https?:\/\/\S+/g, " ")
+        .replace(/\*\*|__/g, "")
+        .replace(/(?<![\p{L}\d])[*_](?=\S)|(?<=\S)[*_](?![\p{L}\d])/gu, "")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+export function countWords(prose) {
+    return prose.match(/[\p{L}\d][\p{L}\d'’-]*/gu)?.length ?? 0;
+}
+/**
+ * Sentences of prose. A boundary is `.`, `!`, `?` or `…` before an upper-case letter, a quote or a
+ * bracket, never before a digit, so "art. 27" and "approx. 300" do not cut a sentence.
+ */
+export function splitSentences(prose) {
+    return prose
+        .split(/(?<=[.!?…])\s+(?=[\p{Lu}„“"(])/u)
+        .map((sentence) => sentence.trim())
+        .filter((sentence) => sentence.length > 0);
+}
+/**
+ * The numbers that need a source: amounts, percentages and numbers from 1000 up. Ages, years
+ * (1900–2100), small counts and legal references ("art. 27") need none, or every text about law
+ * would fail.
+ */
+export function findSignificantNumbers(prose, notation) {
+    const found = [];
+    for (const match of prose.matchAll(new RegExp(notation.number.source, "g"))) {
+        const raw = match[0];
+        const before = prose.slice(Math.max(0, match.index - 12), match.index);
+        const after = prose.slice(match.index + raw.length, match.index + raw.length + 12);
+        if (/[\p{L}\d]$/u.test(before) || notation.referenceBefore.test(before))
+            continue;
+        if (notation.unitAfter.test(after) || (notation.unitBefore?.test(before) ?? false)) {
+            found.push(raw);
+            continue;
+        }
+        const value = parseNumber(raw, notation);
+        const looksLikeYear = /^\d{4}$/.test(raw) && value >= 1900 && value <= 2100;
+        if (value >= 1000 && !looksLikeYear)
+            found.push(raw);
+    }
+    return found;
+}
+/** "28 260,50" (pl) or "28,260.50" (en) → 28260.5. */
+export function parseNumber(raw, notation) {
+    const digits = raw.replace(new RegExp(notation.thousandsSeparator.source, "g"), "");
+    return Number(notation.decimalSeparator === "," ? digits.replace(",", ".") : digits);
+}
+/** A number without thousands separators, to compare a text with a table. */
+export function normalizeNumber(raw, notation) {
+    return raw.replace(new RegExp(notation.thousandsSeparator.source, "g"), "");
+}
+/** A case-insensitive pattern with word edges that know non-ASCII letters (`\b` knows only ASCII). */
+export function wordPattern(source) {
+    return new RegExp(`(?<![\\p{L}\\d])(?:${source})(?![\\p{L}\\d])`, "giu");
+}
+//# sourceMappingURL=text.js.map

package/dist/quality/text.js.map

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

package/dist/render/glossary.d.ts

@@ -0,0 +1,27 @@
+import type { BlogArticle } from "../contract.js";
+export interface GlossaryTerm {
+    readonly slug: string;
+    readonly forms: readonly string[];
+}
+export interface TermMatch {
+    readonly index: number;
+    readonly text: string;
+    readonly slug: string;
+}
+/** Every occurrence of a form in the text, left to right, without overlaps. */
+export type TermMatcher = (text: string) => TermMatch[];
+export declare function createTermMatcher(terms: readonly GlossaryTerm[]): TermMatcher;
+/** A form that two or more terms claim; `slugs` sorted, the form as the first of them writes it. */
+export interface TermFormConflict {
+    readonly form: string;
+    readonly slugs: readonly string[];
+}
+/**
+ * Forms claimed by more than one term. Two forms collide for the matcher exactly when they are equal
+ * after a capital first letter ("ike" and "Ike" do; "IKE" and "Ike" do not), so that is the key. A term
+ * that lists one form twice is no conflict. Sorted by form, for stable messages.
+ */
+export declare function findTermFormConflicts(terms: readonly GlossaryTerm[]): TermFormConflict[];
+/** The glossary of a site from its stored rows: every `kind = "term"` row with its forms. */
+export declare function toGlossary(articles: readonly Pick<BlogArticle, "kind" | "slug" | "termForms">[]): GlossaryTerm[];
+//# sourceMappingURL=glossary.d.ts.map

package/dist/render/glossary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.d.ts","sourceRoot":"","sources":["../../src/render/glossary.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,+EAA+E;AAC/E,MAAM,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;AAUxD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,WAAW,CA4B7E;AAED,oGAAoG;AACpG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,GAAG,gBAAgB,EAAE,CAoBxF;AAED,6FAA6F;AAC7F,wBAAgB,UAAU,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,EAAE,GAAG,YAAY,EAAE,CAIhH"}

package/dist/render/glossary.js

@@ -0,0 +1,71 @@
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function capitalize(text) {
+    return text.charAt(0).toUpperCase() + text.slice(1);
+}
+export function createTermMatcher(terms) {
+    const slugByForm = new Map();
+    for (const term of terms) {
+        for (const form of term.forms) {
+            const trimmed = form.trim();
+            if (trimmed === "")
+                continue;
+            // The first term with a given form wins: two terms with the same phrase are an editorial
+            // mistake (`findTermFormConflicts`: the publish run refuses it and `check` reports it), and the
+            // link has to be deterministic for rows stored before that check.
+            for (const variant of [trimmed, capitalize(trimmed)]) {
+                if (!slugByForm.has(variant))
+                    slugByForm.set(variant, term.slug);
+            }
+        }
+    }
+    if (slugByForm.size === 0)
+        return () => [];
+    const alternatives = [...slugByForm.keys()]
+        .sort((a, b) => b.length - a.length || a.localeCompare(b))
+        .map(escapeRegExp)
+        .join("|");
+    const pattern = new RegExp(`(?<![\\p{L}\\p{N}])(?:${alternatives})(?![\\p{L}\\p{N}])`, "gu");
+    return (text) => [...text.matchAll(pattern)].map((match) => ({
+        index: match.index,
+        text: match[0],
+        // Every alternative of the pattern is a key of the map.
+        slug: slugByForm.get(match[0]) ?? "",
+    }));
+}
+/**
+ * Forms claimed by more than one term. Two forms collide for the matcher exactly when they are equal
+ * after a capital first letter ("ike" and "Ike" do; "IKE" and "Ike" do not), so that is the key. A term
+ * that lists one form twice is no conflict. Sorted by form, for stable messages.
+ */
+export function findTermFormConflicts(terms) {
+    const claims = new Map();
+    for (const term of terms) {
+        for (const form of term.forms) {
+            const trimmed = form.trim();
+            if (trimmed === "")
+                continue;
+            const key = capitalize(trimmed);
+            const bySlug = claims.get(key) ?? new Map();
+            if (!bySlug.has(term.slug))
+                bySlug.set(term.slug, trimmed);
+            claims.set(key, bySlug);
+        }
+    }
+    return [...claims.values()]
+        .filter((bySlug) => bySlug.size > 1)
+        .map((bySlug) => {
+        const slugs = [...bySlug.keys()].sort();
+        // `slugs` holds the keys of the map, so the first one is there.
+        return { form: bySlug.get(slugs[0] ?? "") ?? "", slugs };
+    })
+        .sort((a, b) => a.form.localeCompare(b.form));
+}
+/** The glossary of a site from its stored rows: every `kind = "term"` row with its forms. */
+export function toGlossary(articles) {
+    return articles
+        .filter((article) => article.kind === "term" && article.termForms.length > 0)
+        .map((article) => ({ slug: article.slug, forms: article.termForms }));
+}
+//# sourceMappingURL=glossary.js.map

package/dist/render/glossary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glossary.js","sourceRoot":"","sources":["../../src/render/glossary.ts"],"names":[],"mappings":"AA0BA,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAA8B;IAC9D,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,OAAO,KAAK,EAAE;gBAAE,SAAS;YAC7B,yFAAyF;YACzF,gGAAgG;YAChG,kEAAkE;YAClE,KAAK,MAAM,OAAO,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;gBACrD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC;oBAAE,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC;IAC3C,MAAM,YAAY,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;SACxC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACzD,GAAG,CAAC,YAAY,CAAC;SACjB,IAAI,CAAC,GAAG,CAAC,CAAC;IACb,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,yBAAyB,YAAY,qBAAqB,EAAE,IAAI,CAAC,CAAC;IAE7F,OAAO,CAAC,IAAI,EAAE,EAAE,CACd,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1C,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACd,wDAAwD;QACxD,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;KACrC,CAAC,CAAC,CAAC;AACR,CAAC;AAQD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAA8B;IAClE,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,OAAO,KAAK,EAAE;gBAAE,SAAS;YAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YAChC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,EAAkB,CAAC;YAC5D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC3D,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;SACxB,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;SACnC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QACd,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,gEAAgE;QAChE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC;IAC3D,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,UAAU,CAAC,QAAqE;IAC9F,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;SAC5E,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC"}

package/dist/render/images.d.ts

@@ -0,0 +1,42 @@
+export interface ImageDimensions {
+    readonly width: number;
+    readonly height: number;
+}
+export interface ArticleImagePolicy {
+    /** Hosts whose https images are allowed besides the site's own paths (`cdn.example.com` covers its subdomains). */
+    readonly hosts?: readonly string[];
+    /**
+     * Width and height in pixels of an allowed source, or `null` when the app does not know them. The
+     * source is the normalised URL the page requests (percent-encoded: a space is `%20`).
+     */
+    readonly dimensions: (src: string) => ImageDimensions | null;
+}
+export type ImageProblem = "source" | "alt" | "dimensions";
+export type ImageVerdict = {
+    readonly ok: true;
+    readonly width: number;
+    readonly height: number;
+} | {
+    readonly ok: false;
+    readonly problems: readonly ImageProblem[];
+};
+export interface ArticleImage {
+    readonly src: string;
+    readonly alt: string;
+}
+export interface FoundImage extends ArticleImage {
+    /** 1-based line of the block that holds the image. */
+    readonly line: number;
+}
+/**
+ * Whether an image follows the policy, and why not. Without a policy no image does. `dimensions` is
+ * asked only for an allowed source; a throw there is the app's bug and propagates.
+ */
+export declare function checkArticleImage(image: ArticleImage, policy: ArticleImagePolicy | undefined): ImageVerdict;
+/**
+ * The images of a text with their lines, for the quality gate. It parses like the renderer, but lets
+ * every link scheme through, so an image the renderer would drop as text (`javascript:`) is listed and
+ * reported too.
+ */
+export declare function findArticleImages(markdown: string): FoundImage[];
+//# sourceMappingURL=images.d.ts.map

package/dist/render/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../../src/render/images.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,mHAAmH;IACnH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,eAAe,GAAG,IAAI,CAAC;CAC9D;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,KAAK,GAAG,YAAY,CAAC;AAE3D,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAsCD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,kBAAkB,GAAG,SAAS,GAAG,YAAY,CAU3G;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,EAAE,CAchE"}

package/dist/render/images.js

@@ -0,0 +1,84 @@
+// Images in article bodies under the app's image policy: one check for the renderer (emit or not) and
+// the quality gate (report why not). An image follows the policy when its source stays on the site (a
+// root-relative path) or comes over https from a host the app allows, its alt text is not empty and the
+// app knows its width and height, so the page reserves its box before it loads.
+import MarkdownIt from "markdown-it";
+import footnote from "markdown-it-footnote";
+// A placeholder origin: a root-relative source must resolve to it, or it leaves the site.
+const SITE_BASE = "https://site.invalid";
+function isOnSite(src) {
+    if (!src.startsWith("/"))
+        return false;
+    try {
+        return new URL(src, SITE_BASE).origin === SITE_BASE;
+    }
+    catch {
+        return false;
+    }
+}
+function isOnAllowedHost(src, hosts) {
+    let url;
+    try {
+        url = new URL(src);
+    }
+    catch {
+        return false;
+    }
+    if (url.protocol !== "https:" || url.username !== "" || url.password !== "")
+        return false;
+    const host = url.hostname.toLowerCase();
+    return hosts.some((allowed) => {
+        const own = allowed.toLowerCase();
+        return host === own || host.endsWith(`.${own}`);
+    });
+}
+function isAllowedSource(src, policy) {
+    if (policy === undefined)
+        return false;
+    return isOnSite(src) || isOnAllowedHost(src, policy.hosts ?? []);
+}
+function isPixelCount(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0;
+}
+/**
+ * Whether an image follows the policy, and why not. Without a policy no image does. `dimensions` is
+ * asked only for an allowed source; a throw there is the app's bug and propagates.
+ */
+export function checkArticleImage(image, policy) {
+    const problems = [];
+    const isAllowed = isAllowedSource(image.src, policy);
+    if (!isAllowed)
+        problems.push("source");
+    if (image.alt.trim() === "")
+        problems.push("alt");
+    const size = isAllowed && policy !== undefined ? policy.dimensions(image.src) : null;
+    const hasSize = size !== null && isPixelCount(size.width) && isPixelCount(size.height);
+    if (isAllowed && !hasSize)
+        problems.push("dimensions");
+    if (problems.length > 0 || size === null)
+        return { ok: false, problems };
+    return { ok: true, width: size.width, height: size.height };
+}
+/**
+ * The images of a text with their lines, for the quality gate. It parses like the renderer, but lets
+ * every link scheme through, so an image the renderer would drop as text (`javascript:`) is listed and
+ * reported too.
+ */
+export function findArticleImages(markdown) {
+    const md = new MarkdownIt({ html: false, linkify: false, typographer: false });
+    md.use(footnote);
+    md.validateLink = () => true;
+    const images = [];
+    for (const token of md.parse(markdown, {})) {
+        if (token.type !== "inline" || token.children === null)
+            continue;
+        const line = (token.map?.[0] ?? 0) + 1;
+        for (const child of token.children) {
+            if (child.type !== "image")
+                continue;
+            images.push({ src: String(child.attrGet("src") ?? ""), alt: md.renderer.renderInlineAsText(child.children ?? [], md.options, {}), line });
+        }
+    }
+    return images;
+}
+//# sourceMappingURL=images.js.map