@redocly/recheck 0.1.0 → 0.2.0

package/dist/rules/scope/title-case.js

@@ -0,0 +1,264 @@
+// Pure AP/Chicago title-case algorithms backing the Vale-parity
+// `capitalization` assertion's `$title` match (see ./capitalization.ts).
+// Deliberately no markdown/Vale awareness here -- these functions operate
+// on plain text only. Scope/segment handling, backtick-span freezing, and
+// the problem/fix wiring all live in capitalization.ts.
+//
+// Shared casing rules (both styles):
+// - The FIRST and LAST word are ALWAYS capitalized, regardless of any
+//   stopword list below.
+// - A word listed in `exceptions` (matched case-insensitively) is
+//   rewritten to its EXACT as-written form from that list, everywhere in
+//   the title -- including first/last position -- overriding every rule
+//   below (e.g. 'GitHub', 'iPhone').
+// - A word already in ALL-CAPS (2+ letters, e.g. an acronym like 'API') is
+//   left exactly as written, also overriding the stopword/position rules.
+// - A hyphenated compound (e.g. 'editor-in-chief' -> 'Editor-in-Chief')
+//   runs each hyphen part through the same rules a standalone word gets --
+//   see capitalizeHyphenated.
+// - Every other (non-edge, non-hyphenated, non-exception, non-ALL-CAPS)
+//   word is either forced lowercase (a stopword for the active style) or
+//   capitalized (initial letter upper, rest lower).
+//
+// Style difference (the stopword list lowercased mid-title):
+// - AP: articles, coordinating conjunctions, and prepositions of THREE
+//   letters or fewer.
+// - Chicago: articles, coordinating conjunctions, and EVERY preposition
+//   regardless of length -- via the fixed list below (JS has no built-in
+//   dictionary of "all English prepositions" to draw on).
+const ARTICLES = ['a', 'an', 'the'];
+const COORDINATING_CONJUNCTIONS = ['and', 'but', 'or', 'nor', 'for', 'so', 'yet'];
+// Every entry here is <= 3 letters -- both AP and Chicago lowercase these.
+const SHORT_PREPOSITIONS = ['at', 'by', 'in', 'of', 'off', 'on', 'out', 'to', 'up', 'via'];
+// Chicago-only: prepositions of 4+ letters. AP capitalizes these mid-title
+// (they're not in AP_STOPWORDS); Chicago lowercases them like any other
+// preposition.
+const LONG_PREPOSITIONS = [
+    'about',
+    'above',
+    'across',
+    'after',
+    'against',
+    'along',
+    'among',
+    'around',
+    'before',
+    'behind',
+    'below',
+    'between',
+    'during',
+    'through',
+    'toward',
+    'under',
+    'until',
+    'with',
+    'within',
+    'without',
+];
+const AP_STOPWORDS = new Set([...ARTICLES, ...COORDINATING_CONJUNCTIONS, ...SHORT_PREPOSITIONS]);
+const CHICAGO_STOPWORDS = new Set([
+    ...ARTICLES,
+    ...COORDINATING_CONJUNCTIONS,
+    ...SHORT_PREPOSITIONS,
+    ...LONG_PREPOSITIONS,
+]);
+// One "word" is a run of letters/digits, optionally joined by internal
+// hyphens ('well-known') or apostrophes ("don't"). Anything else --
+// including capitalization.ts's \0 inline-code mask character -- is a
+// separator copied through verbatim, so a masked inline-code span is
+// invisible to this tokenizer: never capitalized, never counted toward
+// first/last-word position.
+//
+// A PHRASE exception is deliberately never reached by this regex: phrase
+// spans are carved out of the text before it runs, so a phrase is one token
+// instead of the several this regex would split it into (it splits on exactly
+// the whitespace and dots those entries contain). See tokenizeCasingWords.
+const WORD_RE = /[A-Za-z0-9]+(?:['’-][A-Za-z0-9]+)*/g;
+/**
+ * True for a word that's already an ALL-CAPS acronym (2+ letters, e.g.
+ * 'API', 'HTML5') -- both styles leave these exactly as written rather
+ * than lowercasing or capitalizing them. Non-letter characters (digits)
+ * don't count toward the length or case check.
+ */
+export function isAllCapsWord(word) {
+    const letters = word.replace(/[^A-Za-z]/g, '');
+    return letters.length >= 2 && letters === letters.toUpperCase();
+}
+function capitalizeWord(word) {
+    return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+}
+export function buildExceptionPlan(exceptions) {
+    const phrases = exceptions.filter((e) => /[\s.]/.test(e)).sort((a, b) => b.length - a.length);
+    const phraseSet = new Set(phrases);
+    const wordMap = new Map();
+    for (const exception of exceptions) {
+        if (phraseSet.has(exception))
+            continue; // phrases are matched separately, below
+        wordMap.set(exception.toLowerCase(), exception);
+    }
+    return { wordMap, phrases };
+}
+function escapeRegExp(text) {
+    return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+// Finds every non-overlapping occurrence of a phrase exception in `text`,
+// case-insensitively but otherwise LITERALLY -- no whitespace normalization,
+// no word-boundary requirement, and no regex sourced from config (every
+// candidate is a fixed exception string, run through escapeRegExp). Literal
+// matching is what guarantees a match is always exactly `phrase.length`
+// characters long, which is in turn what lets a matched span be replaced by
+// the as-written exception without shifting any later offset (see
+// CasingToken.exception).
+// `phrases` is already longest-first (buildExceptionPlan), so a match
+// recorded for an earlier (longer) phrase claims its range and a later
+// (shorter) phrase cannot also match any part of it.
+function findPhraseMatches(text, phrases) {
+    const matches = [];
+    for (const phrase of phrases) {
+        const pattern = new RegExp(escapeRegExp(phrase), 'gi');
+        let match;
+        while ((match = pattern.exec(text)) !== null) {
+            const start = match.index;
+            const end = start + match[0].length;
+            if (!matches.some((claimed) => start < claimed.end && claimed.start < end)) {
+                matches.push({ start, end, exception: phrase });
+            }
+        }
+    }
+    return matches.sort((a, b) => a.start - b.start);
+}
+function pushWordTokens(text, from, to, tokens) {
+    if (from >= to)
+        return;
+    for (const match of text.slice(from, to).matchAll(WORD_RE)) {
+        const start = from + (match.index ?? 0);
+        tokens.push({ text: match[0], start, end: start + match[0].length });
+    }
+}
+/**
+ * Tokenizes `text` into the word sequence the `$`-styles case, with every
+ * non-overlapping phrase-exception match collapsed into a single token.
+ *
+ * Ordinary words are tokenized only in the GAPS between phrase matches, which
+ * makes a phrase span a hard token boundary: a word can never straddle one
+ * (e.g. with the phrase 'VS Code', the text 'xVS Codey' yields 'x', the
+ * phrase, then 'y'). That is exactly the boundary the previous placeholder run
+ * produced, since the placeholder sat outside WORD_RE's character class.
+ */
+function tokenizeCasingWords(text, phrases) {
+    const tokens = [];
+    let cursor = 0;
+    for (const { start, end, exception } of findPhraseMatches(text, phrases)) {
+        pushWordTokens(text, cursor, start, tokens);
+        tokens.push({ text: text.slice(start, end), start, end, exception });
+        cursor = end;
+    }
+    pushWordTokens(text, cursor, text.length, tokens);
+    return tokens;
+}
+/**
+ * Rebuilds `text` with every word re-cased by `caseWord`, which receives the
+ * word plus its `index` in the token sequence and that sequence's `total`
+ * length -- so `index === 0` is the real first word and `index === total - 1`
+ * the real last one. Separators between tokens are copied through verbatim.
+ *
+ * A phrase-exception token is emitted as-written and never passed to
+ * `caseWord`, but it DOES occupy an index. That is the whole point: a leading
+ * or trailing phrase no longer hands its first/last position to a neighbour
+ * (#25610).
+ *
+ * Shared by this module's apTitleCase/chicagoTitleCase and by
+ * capitalization.ts's sentenceCase, so all three `$`-styles agree on
+ * tokenization and phrase protection, not merely on the exception plan.
+ * Length-preserving whenever `caseWord` is.
+ */
+export function recaseWords(text, phrases, caseWord) {
+    const tokens = tokenizeCasingWords(text, phrases);
+    if (tokens.length === 0)
+        return text;
+    let result = '';
+    let cursor = 0;
+    tokens.forEach((token, index) => {
+        result += text.slice(cursor, token.start);
+        result += token.exception ?? caseWord(token.text, index, tokens.length);
+        cursor = token.end;
+    });
+    return result + text.slice(cursor);
+}
+// Each hyphen part gets its own exceptions/ALL-CAPS decision first, then
+// the same stopword test a standalone word gets. The first/last part also
+// inherits the compound's own first/last-word treatment, so a stopword
+// part still capitalizes when the compound opens/closes the title.
+function capitalizeHyphenated(word, isFirstWord, isLastWord, stopwords, exceptionMap) {
+    const parts = word.split('-');
+    const lastPartIndex = parts.length - 1;
+    return parts
+        .map((part, partIndex) => {
+        if (part.length === 0)
+            return part; // leading/trailing/doubled hyphen -- nothing to capitalize
+        const exceptionHit = exceptionMap.get(part.toLowerCase());
+        if (exceptionHit !== undefined)
+            return exceptionHit;
+        if (isAllCapsWord(part))
+            return part;
+        if (partIndex === 0 && isFirstWord)
+            return capitalizeWord(part);
+        if (partIndex === lastPartIndex && isLastWord)
+            return capitalizeWord(part);
+        if (stopwords.has(part.toLowerCase()))
+            return part.toLowerCase();
+        return capitalizeWord(part);
+    })
+        .join('-');
+}
+function transformWord(word, isFirstWord, isLastWord, stopwords, exceptionMap) {
+    // Whole-compound exception check FIRST, before any hyphen splitting: an
+    // exceptions entry may itself be an entire hyphenated compound (e.g.
+    // 'e-commerce'), which must be preserved as-written rather than falling
+    // through to per-part handling below -- $sentence (capitalization.ts's
+    // sentenceCase) already treats a hyphenated compound as one token and
+    // honors this, so $title must agree on the same documented behavior.
+    const exceptionHit = exceptionMap.get(word.toLowerCase());
+    if (exceptionHit !== undefined)
+        return exceptionHit;
+    // Hyphenation check: with no whole-compound exception match, a hyphenated
+    // compound is stopword-tested part by part instead (the stopword lists
+    // only contain single words, so a whole-string lookup against them would
+    // never hit anyway). Per-part exceptions (e.g. 'GitHub' inside
+    // 'github-hosted') are still handled inside capitalizeHyphenated.
+    if (word.includes('-')) {
+        return capitalizeHyphenated(word, isFirstWord, isLastWord, stopwords, exceptionMap);
+    }
+    if (isAllCapsWord(word))
+        return word;
+    if (isFirstWord || isLastWord)
+        return capitalizeWord(word);
+    if (stopwords.has(word.toLowerCase()))
+        return word.toLowerCase();
+    return capitalizeWord(word);
+}
+function titleCase(text, stopwords, exceptions) {
+    // Phrase entries become atomic tokens in the sequence recaseWords walks
+    // (each emitted as-written, each counting toward first/last position);
+    // `wordMap` holds the single-token entries transformWord looks up per word
+    // and per hyphen part. Both come from the one shared exception plan.
+    const { wordMap, phrases } = buildExceptionPlan(exceptions);
+    return recaseWords(text, phrases, (word, index, total) => transformWord(word, index === 0, index === total - 1, stopwords, wordMap));
+}
+/**
+ * AP style: lowercases articles, coordinating conjunctions, and
+ * prepositions of 3 letters or fewer -- everything else is capitalized,
+ * except `exceptions` (kept as-written) and ALL-CAPS words (left alone).
+ * The first and last word are always capitalized.
+ */
+export function apTitleCase(text, exceptions = []) {
+    return titleCase(text, AP_STOPWORDS, exceptions);
+}
+/**
+ * Chicago style: like AP, but lowercases EVERY preposition regardless of
+ * length (not just the 3-letters-or-fewer ones AP lowercases).
+ */
+export function chicagoTitleCase(text, exceptions = []) {
+    return titleCase(text, CHICAGO_STOPWORDS, exceptions);
+}
+//# sourceMappingURL=title-case.js.map

package/dist/rules/scope/title-case.js.map

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

package/dist/rules/token/blanks-around-fences.d.ts

@@ -0,0 +1,3 @@
+import type { TokenRule } from '../types.js';
+export declare const blanksAroundFences: TokenRule;
+//# sourceMappingURL=blanks-around-fences.d.ts.map

package/dist/rules/token/blanks-around-fences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blanks-around-fences.d.ts","sourceRoot":"","sources":["../../../src/rules/token/blanks-around-fences.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AA6B/D,eAAO,MAAM,kBAAkB,EAAE,SAuBhC,CAAC"}

package/dist/rules/token/blanks-around-fences.js

@@ -0,0 +1,44 @@
+import { filterByTypes } from '../../parser/index.js';
+import { getParentOfType, isBlankLine } from './helpers.js';
+const codeFencePrefixRe = /^(.*?)[`~]/;
+function addFenceError(ctx, lines, lineNumber, top) {
+    const line = lines[lineNumber - 1] ?? '';
+    const prefixMatch = codeFencePrefixRe.exec(line);
+    const prefix = prefixMatch?.[1];
+    ctx.onError({
+        line: lineNumber,
+        context: line.trim(),
+        fixInfo: prefix === undefined
+            ? undefined
+            : {
+                lineNumber: lineNumber + (top ? 0 : 1),
+                editColumn: 1,
+                insertText: `${prefix.replace(/[^>]/g, ' ').trim()}\n`,
+            },
+    });
+}
+export const blanksAroundFences = {
+    name: 'blanks-around-fences',
+    tags: ['code', 'blank_lines'],
+    fixable: true,
+    defaults: {
+        message: 'Fenced code blocks should be surrounded by blank lines',
+        listItems: true,
+    },
+    check(ctx) {
+        const listItems = ctx.config.listItems;
+        const includeListItems = listItems === undefined ? true : !!listItems;
+        const { lines } = ctx;
+        for (const codeBlock of filterByTypes(ctx.tree, ['codeFenced'])) {
+            if (includeListItems || !getParentOfType(codeBlock, ['listOrdered', 'listUnordered'])) {
+                if (!isBlankLine(lines[codeBlock.startLine - 2])) {
+                    addFenceError(ctx, lines, codeBlock.startLine, true);
+                }
+                if (!isBlankLine(lines[codeBlock.endLine]) && !isBlankLine(lines[codeBlock.endLine - 1])) {
+                    addFenceError(ctx, lines, codeBlock.endLine, false);
+                }
+            }
+        }
+    },
+};
+//# sourceMappingURL=blanks-around-fences.js.map

package/dist/rules/token/blanks-around-fences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blanks-around-fences.js","sourceRoot":"","sources":["../../../src/rules/token/blanks-around-fences.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE5D,MAAM,iBAAiB,GAAG,YAAY,CAAC;AAEvC,SAAS,aAAa,CACpB,GAAqB,EACrB,KAAwB,EACxB,UAAkB,EAClB,GAAY;IAEZ,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,MAAM,WAAW,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IAChC,GAAG,CAAC,OAAO,CAAC;QACV,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE;QACpB,OAAO,EACL,MAAM,KAAK,SAAS;YAClB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC;gBACE,UAAU,EAAE,UAAU,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtC,UAAU,EAAE,CAAC;gBACb,UAAU,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI;aACvD;KACR,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,IAAI,EAAE,sBAAsB;IAC5B,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;IAC7B,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE;QACR,OAAO,EAAE,wDAAwD;QACjE,SAAS,EAAE,IAAI;KAChB;IACD,KAAK,CAAC,GAAG;QACP,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC;QACvC,MAAM,gBAAgB,GAAG,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACtE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;QACtB,KAAK,MAAM,SAAS,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;YAChE,IAAI,gBAAgB,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,CAAC,aAAa,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;gBACtF,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACjD,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBACvD,CAAC;gBACD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBACzF,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/rules/token/blanks-around-headings.d.ts

@@ -0,0 +1,3 @@
+import type { TokenRule } from '../types.js';
+export declare const blanksAroundHeadings: TokenRule;
+//# sourceMappingURL=blanks-around-headings.d.ts.map

package/dist/rules/token/blanks-around-headings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blanks-around-headings.d.ts","sourceRoot":"","sources":["../../../src/rules/token/blanks-around-headings.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAwD7C,eAAO,MAAM,oBAAoB,EAAE,SA0ElC,CAAC"}

package/dist/rules/token/blanks-around-headings.js

@@ -0,0 +1,108 @@
+import { filterByTypes } from '../../parser/index.js';
+import { getBlockQuotePrefixText, getHeadingLevel, isBlankLine } from './helpers.js';
+const defaultLines = 1;
+/**
+ * Upstream's `getLinesFunction`: `linesAbove`/`linesBelow` config can be a
+ * single number applied to every heading level, or a `number[6]` (one
+ * entry per heading level 1-6, missing/short entries fall back to the
+ * default of 1).
+ */
+function getLinesFunction(linesParam) {
+    if (Array.isArray(linesParam)) {
+        const linesArray = new Array(6).fill(defaultLines);
+        for (const [index, value] of linesParam.slice(0, 6).entries()) {
+            linesArray[index] = Number(value);
+        }
+        return (heading) => linesArray[getHeadingLevel(heading) - 1];
+    }
+    const lines = linesParam === undefined ? defaultLines : Number(linesParam);
+    return () => lines;
+}
+/**
+ * Gets a 0-based line's text for the "lines above" scan. Upstream strips
+ * front matter out of `params.lines` entirely and only reconstructs it via
+ * a separate `frontMatterLines` array for negative indices; Recheck keeps
+ * front matter in-band as a real `yaml` token occupying real line numbers
+ * in `ctx.lines`. To preserve upstream's documented default ("front matter
+ * is ignored" — i.e. no blank line is required between it and the first
+ * heading), a line that falls inside the yaml token's span is treated as
+ * blank (returns `''`) unless `includeFrontMatter` is set, in which case
+ * its real text is returned like any other line.
+ */
+function getLineAbove(lines, index, frontMatterRange, includeFrontMatter) {
+    if (index < 0 || index >= lines.length)
+        return '';
+    const lineNumber = index + 1;
+    if (!includeFrontMatter &&
+        frontMatterRange &&
+        lineNumber >= frontMatterRange.start &&
+        lineNumber <= frontMatterRange.end) {
+        return '';
+    }
+    return lines[index];
+}
+export const blanksAroundHeadings = {
+    name: 'blanks-around-headings',
+    tags: ['headings', 'blank_lines'],
+    fixable: true,
+    defaults: {
+        message: 'Headings should be surrounded by blank lines',
+        includeFrontMatter: false,
+        linesAbove: 1,
+        linesBelow: 1,
+    },
+    check(ctx) {
+        const getLinesAbove = getLinesFunction(ctx.config.linesAbove);
+        const getLinesBelow = getLinesFunction(ctx.config.linesBelow);
+        const includeFrontMatter = !!ctx.config.includeFrontMatter;
+        const { lines } = ctx;
+        const frontmatter = ctx.tree.flat.find((token) => token.type === 'yaml');
+        const frontMatterRange = frontmatter
+            ? { start: frontmatter.startLine, end: frontmatter.endLine }
+            : undefined;
+        for (const heading of filterByTypes(ctx.tree, ['atxHeading', 'setextHeading'])) {
+            const { startLine, endLine } = heading;
+            const lineText = (lines[startLine - 1] ?? '').trim();
+            const linesAbove = getLinesAbove(heading);
+            if (linesAbove >= 0) {
+                let actualAbove = 0;
+                for (let i = 0; i < linesAbove &&
+                    isBlankLine(getLineAbove(lines, startLine - 2 - i, frontMatterRange, includeFrontMatter)); i++) {
+                    actualAbove++;
+                }
+                if (linesAbove !== actualAbove) {
+                    ctx.onError({
+                        line: startLine,
+                        detail: `Expected: ${linesAbove}; Actual: ${actualAbove}; Above`,
+                        context: lineText,
+                        fixInfo: {
+                            lineNumber: startLine,
+                            editColumn: 1,
+                            insertText: getBlockQuotePrefixText(ctx.tree, startLine - 1, linesAbove - actualAbove),
+                        },
+                    });
+                }
+            }
+            const linesBelow = getLinesBelow(heading);
+            if (linesBelow >= 0) {
+                let actualBelow = 0;
+                for (let i = 0; i < linesBelow && isBlankLine(lines[endLine + i] ?? ''); i++) {
+                    actualBelow++;
+                }
+                if (linesBelow !== actualBelow) {
+                    ctx.onError({
+                        line: startLine,
+                        detail: `Expected: ${linesBelow}; Actual: ${actualBelow}; Below`,
+                        context: lineText,
+                        fixInfo: {
+                            lineNumber: endLine + 1,
+                            editColumn: 1,
+                            insertText: getBlockQuotePrefixText(ctx.tree, endLine + 1, linesBelow - actualBelow),
+                        },
+                    });
+                }
+            }
+        }
+    },
+};
+//# sourceMappingURL=blanks-around-headings.js.map

package/dist/rules/token/blanks-around-headings.js.map

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

package/dist/rules/token/blanks-around-lists.d.ts

@@ -0,0 +1,3 @@
+import type { TokenRule } from '../types.js';
+export declare const blanksAroundLists: TokenRule;
+//# sourceMappingURL=blanks-around-lists.d.ts.map

package/dist/rules/token/blanks-around-lists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blanks-around-lists.d.ts","sourceRoot":"","sources":["../../../src/rules/token/blanks-around-lists.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAW7C,eAAO,MAAM,iBAAiB,EAAE,SA+D/B,CAAC"}

package/dist/rules/token/blanks-around-lists.js

@@ -0,0 +1,56 @@
+import { filterByPredicate, getBlockQuotePrefixText, isBlankLine, nonContentTokens, } from './helpers.js';
+const isList = (token) => token.type === 'listOrdered' || token.type === 'listUnordered';
+export const blanksAroundLists = {
+    name: 'blanks-around-lists',
+    tags: ['bullet', 'ul', 'ol', 'blank_lines'],
+    fixable: true,
+    defaults: {
+        message: 'Lists should be surrounded by blank lines',
+    },
+    check(ctx) {
+        const { lines } = ctx;
+        // Only *top-level* lists: stop descending into a token's children once
+        // it is itself a list (or an htmlFlow block, matching upstream) so a
+        // nested sublist isn't independently reported as needing its own
+        // surrounding blank lines -- that's the parent list's job.
+        const topLevelLists = filterByPredicate(ctx.tree, isList, (token) => isList(token) || token.type === 'htmlFlow' ? [] : token.children);
+        for (const list of topLevelLists) {
+            // Look for a blank line above the list.
+            const firstLineNumber = list.startLine;
+            if (!isBlankLine(lines[firstLineNumber - 2])) {
+                ctx.onError({
+                    line: firstLineNumber,
+                    context: (lines[firstLineNumber - 1] ?? '').trim(),
+                    fixInfo: {
+                        lineNumber: firstLineNumber,
+                        editColumn: 1,
+                        insertText: getBlockQuotePrefixText(ctx.tree, firstLineNumber),
+                    },
+                });
+            }
+            // Find the "visual" end of the list: its last non-"structural"
+            // (indentation/blank-line/container-prefix) descendant's end line,
+            // walked via the tree rather than list.endLine so a trailing
+            // listItemIndent on an otherwise-empty final line doesn't push the
+            // expected "below" blank-line check past the list's real content.
+            const flattenedChildren = filterByPredicate(list.children, (token) => !nonContentTokens.has(token.type), (token) => (nonContentTokens.has(token.type) ? [] : token.children));
+            const endLine = flattenedChildren.length > 0
+                ? flattenedChildren[flattenedChildren.length - 1].endLine
+                : list.endLine;
+            // Look for a blank line below the list.
+            const lastLineNumber = endLine;
+            if (!isBlankLine(lines[lastLineNumber])) {
+                ctx.onError({
+                    line: lastLineNumber,
+                    context: (lines[lastLineNumber - 1] ?? '').trim(),
+                    fixInfo: {
+                        lineNumber: lastLineNumber + 1,
+                        editColumn: 1,
+                        insertText: getBlockQuotePrefixText(ctx.tree, lastLineNumber),
+                    },
+                });
+            }
+        }
+    },
+};
+//# sourceMappingURL=blanks-around-lists.js.map

package/dist/rules/token/blanks-around-lists.js.map

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

package/dist/rules/token/blanks-around-tables.d.ts

@@ -0,0 +1,3 @@
+import type { TokenRule } from '../types.js';
+export declare const blanksAroundTables: TokenRule;
+//# sourceMappingURL=blanks-around-tables.d.ts.map

package/dist/rules/token/blanks-around-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blanks-around-tables.d.ts","sourceRoot":"","sources":["../../../src/rules/token/blanks-around-tables.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C,eAAO,MAAM,kBAAkB,EAAE,SAwChC,CAAC"}

package/dist/rules/token/blanks-around-tables.js

@@ -0,0 +1,42 @@
+import { filterByTypes } from '../../parser/index.js';
+import { getBlockQuotePrefixText, isBlankLine } from './helpers.js';
+export const blanksAroundTables = {
+    name: 'blanks-around-tables',
+    tags: ['table'],
+    fixable: true,
+    defaults: {
+        message: 'Tables should be surrounded by blank lines',
+    },
+    check(ctx) {
+        const { lines } = ctx;
+        for (const table of filterByTypes(ctx.tree, ['table'])) {
+            // Look for a blank line above the table.
+            const firstLineNumber = table.startLine;
+            if (!isBlankLine(lines[firstLineNumber - 2])) {
+                ctx.onError({
+                    line: firstLineNumber,
+                    context: (lines[firstLineNumber - 1] ?? '').trim(),
+                    fixInfo: {
+                        lineNumber: firstLineNumber,
+                        editColumn: 1,
+                        insertText: getBlockQuotePrefixText(ctx.tree, firstLineNumber),
+                    },
+                });
+            }
+            // Look for a blank line below the table.
+            const lastLineNumber = table.endLine;
+            if (!isBlankLine(lines[lastLineNumber])) {
+                ctx.onError({
+                    line: lastLineNumber,
+                    context: (lines[lastLineNumber - 1] ?? '').trim(),
+                    fixInfo: {
+                        lineNumber: lastLineNumber + 1,
+                        editColumn: 1,
+                        insertText: getBlockQuotePrefixText(ctx.tree, lastLineNumber),
+                    },
+                });
+            }
+        }
+    },
+};
+//# sourceMappingURL=blanks-around-tables.js.map

package/dist/rules/token/blanks-around-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blanks-around-tables.js","sourceRoot":"","sources":["../../../src/rules/token/blanks-around-tables.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,IAAI,EAAE,sBAAsB;IAC5B,IAAI,EAAE,CAAC,OAAO,CAAC;IACf,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE;QACR,OAAO,EAAE,4CAA4C;KACtD;IACD,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;QAEtB,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACvD,yCAAyC;YACzC,MAAM,eAAe,GAAG,KAAK,CAAC,SAAS,CAAC;YACxC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7C,GAAG,CAAC,OAAO,CAAC;oBACV,IAAI,EAAE,eAAe;oBACrB,OAAO,EAAE,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;oBAClD,OAAO,EAAE;wBACP,UAAU,EAAE,eAAe;wBAC3B,UAAU,EAAE,CAAC;wBACb,UAAU,EAAE,uBAAuB,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC;qBAC/D;iBACF,CAAC,CAAC;YACL,CAAC;YAED,yCAAyC;YACzC,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC;YACrC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;gBACxC,GAAG,CAAC,OAAO,CAAC;oBACV,IAAI,EAAE,cAAc;oBACpB,OAAO,EAAE,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;oBACjD,OAAO,EAAE;wBACP,UAAU,EAAE,cAAc,GAAG,CAAC;wBAC9B,UAAU,EAAE,CAAC;wBACb,UAAU,EAAE,uBAAuB,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC;qBAC9D;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/rules/token/code-block-style.d.ts

@@ -0,0 +1,3 @@
+import type { TokenRule } from '../types.js';
+export declare const codeBlockStyle: TokenRule;
+//# sourceMappingURL=code-block-style.d.ts.map

package/dist/rules/token/code-block-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-block-style.d.ts","sourceRoot":"","sources":["../../../src/rules/token/code-block-style.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,eAAO,MAAM,cAAc,EAAE,SAwB5B,CAAC"}

package/dist/rules/token/code-block-style.js

@@ -0,0 +1,30 @@
+import { filterByTypes } from '../../parser/index.js';
+function tokenTypeToStyle(tokenType) {
+    return tokenType === 'codeFenced' ? 'fenced' : 'indented';
+}
+export const codeBlockStyle = {
+    name: 'code-block-style',
+    tags: ['code'],
+    fixable: false,
+    defaults: {
+        message: 'Code block style',
+        style: 'consistent',
+    },
+    check(ctx) {
+        let expectedStyle = String(ctx.config.style || 'consistent');
+        for (const token of filterByTypes(ctx.tree, ['codeFenced', 'codeIndented'])) {
+            const { startLine, type } = token;
+            if (expectedStyle === 'consistent') {
+                expectedStyle = tokenTypeToStyle(type);
+            }
+            const actualStyle = tokenTypeToStyle(type);
+            if (expectedStyle !== actualStyle) {
+                ctx.onError({
+                    line: startLine,
+                    detail: `Expected: ${expectedStyle}; Actual: ${actualStyle}`,
+                });
+            }
+        }
+    },
+};
+//# sourceMappingURL=code-block-style.js.map

package/dist/rules/token/code-block-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-block-style.js","sourceRoot":"","sources":["../../../src/rules/token/code-block-style.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,SAAS,gBAAgB,CAAC,SAAiB;IACzC,OAAO,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAc;IACvC,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,CAAC,MAAM,CAAC;IACd,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE;QACR,OAAO,EAAE,kBAAkB;QAC3B,KAAK,EAAE,YAAY;KACpB;IACD,KAAK,CAAC,GAAG;QACP,IAAI,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC;QAC7D,KAAK,MAAM,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAC5E,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;YAClC,IAAI,aAAa,KAAK,YAAY,EAAE,CAAC;gBACnC,aAAa,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACzC,CAAC;YACD,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,aAAa,KAAK,WAAW,EAAE,CAAC;gBAClC,GAAG,CAAC,OAAO,CAAC;oBACV,IAAI,EAAE,SAAS;oBACf,MAAM,EAAE,aAAa,aAAa,aAAa,WAAW,EAAE;iBAC7D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/rules/token/code-fence-style.d.ts

@@ -0,0 +1,3 @@
+import type { TokenRule } from '../types.js';
+export declare const codeFenceStyle: TokenRule;
+//# sourceMappingURL=code-fence-style.d.ts.map