@redocly/recheck 0.1.0 → 0.3.0

package/dist/rules/scope/occurrence.js

@@ -0,0 +1,48 @@
+import { formatTemplate } from '../token/messages.js';
+import { newLineRe } from '../../core/line-endings.js';
+// Vale-parity `occurrence` check: counts regex matches within each segment
+// (not per-line, unlike `pattern`) and flags the whole segment when the
+// count falls outside `[min, max]`. Detection-only — the violation is the
+// segment's total count, so there's no single match position to anchor a fix.
+const execute = async (rule, file, ctx) => {
+    const problems = [];
+    const o = rule.assertions['occurrence'];
+    let regex;
+    try {
+        regex = new RegExp(o.pattern, o.ignoreCase ? 'gi' : 'g');
+    }
+    catch {
+        return problems; // ignore invalid regex
+    }
+    for (const segment of ctx.segments) {
+        // Exclude zero-width matches (e.g. a pattern like `a*` over text with
+        // no 'a'): matchAll's iterator advances past each one automatically
+        // (unlike a raw exec() loop, there's no hang to guard against), but an
+        // empty-text match is still a match at every position in the segment
+        // -- counting it would inflate the total so `max` bounds always
+        // violate and `min` is trivially satisfied.
+        const count = [...segment.content.matchAll(regex)].filter((m) => m[0].length > 0).length;
+        const tooFew = o.min !== undefined && count < o.min;
+        const tooMany = o.max !== undefined && count > o.max;
+        if (!tooFew && !tooMany)
+            continue;
+        const bound = tooFew ? o.min : o.max;
+        problems.push({
+            file,
+            line: segment.startLine,
+            column: segment.startColumn,
+            // newLineRe, not '\n': a bare split leaves a trailing '\r' on CRLF content.
+            text: segment.content.split(newLineRe)[0] ?? '',
+            match: o.pattern,
+            ruleName: rule.name,
+            severity: rule.severity,
+            message: formatTemplate(rule.message ??
+                (tooFew
+                    ? 'Found %s matches; expected at least %s.'
+                    : 'Found %s matches; expected at most %s.'), String(count), String(bound)),
+        });
+    }
+    return problems;
+};
+export const occurrence = { id: 'occurrence', fixable: false, execute };
+//# sourceMappingURL=occurrence.js.map

package/dist/rules/scope/occurrence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"occurrence.js","sourceRoot":"","sources":["../../../src/rules/scope/occurrence.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAEvD,2EAA2E;AAC3E,wEAAwE;AACxE,0EAA0E;AAC1E,8EAA8E;AAC9E,MAAM,OAAO,GAAG,KAAK,EACnB,IAAoB,EACpB,IAAY,EACZ,GAAqB,EACD,EAAE;IACtB,MAAM,QAAQ,GAAc,EAAE,CAAC;IAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,YAAY,CAAwB,CAAC;IAE/D,IAAI,KAAa,CAAC;IAClB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC3D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ,CAAC,CAAC,uBAAuB;IAC1C,CAAC;IAED,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;QACnC,sEAAsE;QACtE,oEAAoE;QACpE,uEAAuE;QACvE,qEAAqE;QACrE,gEAAgE;QAChE,4CAA4C;QAC5C,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;QACzF,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC;QACpD,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC;QACrD,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO;YAAE,SAAS;QAElC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACrC,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI;YACJ,IAAI,EAAE,OAAO,CAAC,SAAS;YACvB,MAAM,EAAE,OAAO,CAAC,WAAW;YAC3B,4EAA4E;YAC5E,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YAC/C,KAAK,EAAE,CAAC,CAAC,OAAO;YAChB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,OAAO,EAAE,cAAc,CACrB,IAAI,CAAC,OAAO;gBACV,CAAC,MAAM;oBACL,CAAC,CAAC,yCAAyC;oBAC3C,CAAC,CAAC,wCAAwC,CAAC,EAC/C,MAAM,CAAC,KAAK,CAAC,EACb,MAAM,CAAC,KAAK,CAAC,CACd;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAc,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC"}

package/dist/rules/scope/pattern.d.ts

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

package/dist/rules/scope/pattern.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern.d.ts","sourceRoot":"","sources":["../../../src/rules/scope/pattern.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAkF/D,eAAO,MAAM,OAAO,EAAE,SAAsD,CAAC"}

package/dist/rules/scope/pattern.js

@@ -0,0 +1,75 @@
+import { formatTemplate } from '../token/messages.js';
+import { newLineRe, offsetToLineColumn } from '../../core/line-endings.js';
+import { overlapsAnyRange } from '../../core/inline-code.js';
+import { nonProseRanges } from '../utils.js';
+// A match's raw `column` (from offsetToLineColumn) is relative to its own
+// line within segment.content. On the segment's first line,
+// segment.content starts mid-source-line (e.g. a heading segment's
+// content excludes the '## ' marker), so segment.startColumn must be added
+// to get the true source column. Matches on later lines start at source
+// column 1, so they're unaffected.
+function toSourceColumn(segment, lineNumber, column) {
+    return lineNumber === 1 ? segment.startColumn + (column - 1) : column;
+}
+const execute = async (rule, file, ctx) => {
+    const problems = [];
+    const options = rule.assertions['pattern'];
+    for (const segment of ctx.segments) {
+        const content = segment.content;
+        // newLineRe (never a bare '\n'): a '\n' split of CRLF content leaves a
+        // trailing '\r' on every reported `text`, and a '\n'-based line count
+        // keeps CR-only matches on line 1 (see offsetToLineColumn below).
+        const contentLines = content.split(newLineRe);
+        // Prose rules must not lint code: a token like 'master' would fire
+        // inside `git checkout master`, the usage Google's guide explicitly
+        // sanctions in code font. A markdoc tag's span is excluded on the same
+        // terms: it is markup, not the prose this rule was pointed at. The regex
+        // runs against the original `content`, never a masked stand-in, because an
+        // arbitrary user regex such as the negated class `[^\s,]+` can match
+        // straight through a masked run. A match whose span overlaps one of the
+        // excluded ranges is skipped below rather than reported; `includeCode`
+        // drops the code-span half.
+        const excluded = nonProseRanges(segment, options.includeCode);
+        const tokens = options.tokens || [];
+        for (const token of tokens) {
+            try {
+                const regex = new RegExp(token, options.ignoreCase ? 'gi' : 'g');
+                let match;
+                while ((match = regex.exec(content)) !== null) {
+                    // A zero-width match (e.g. a `tokens` pattern like `a*`) never
+                    // advances lastIndex on its own -- bump it or the loop hangs. It's
+                    // also semantically meaningless for pattern (there's no real text
+                    // to report), so skip recording it too -- otherwise a token that
+                    // can match empty string would report a phantom problem at every
+                    // character offset it passed through.
+                    if (match[0].length === 0) {
+                        regex.lastIndex++;
+                        continue;
+                    }
+                    const matchEnd = match.index + match[0].length;
+                    if (overlapsAnyRange(match.index, matchEnd, excluded)) {
+                        continue;
+                    }
+                    const { line: lineNumber, column } = offsetToLineColumn(content, match.index);
+                    const matchedText = content.slice(match.index, match.index + match[0].length);
+                    problems.push({
+                        file,
+                        line: segment.startLine + lineNumber - 1,
+                        column: toSourceColumn(segment, lineNumber, column),
+                        text: contentLines[lineNumber - 1] || '',
+                        match: matchedText,
+                        ruleName: rule.name,
+                        severity: rule.severity,
+                        message: formatTemplate(rule.message ?? '', matchedText),
+                    });
+                }
+            }
+            catch {
+                // ignore invalid regex
+            }
+        }
+    }
+    return problems;
+};
+export const pattern = { id: 'pattern', fixable: false, execute };
+//# sourceMappingURL=pattern.js.map

package/dist/rules/scope/pattern.js.map

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

package/dist/rules/scope/repetition.d.ts

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

package/dist/rules/scope/repetition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repetition.d.ts","sourceRoot":"","sources":["../../../src/rules/scope/repetition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAwK/D,eAAO,MAAM,UAAU,EAAE,SAA6D,CAAC"}

package/dist/rules/scope/repetition.js

@@ -0,0 +1,139 @@
+import { formatTemplate } from '../token/messages.js';
+import { newLineRe, offsetToLineColumn } from '../../core/line-endings.js';
+// Tokenizes `segment.content` with `options.pattern` (default `\w+`) and
+// pairs adjacent tokens whose only separator is whitespace with at most one
+// line break (a blank line never pairs across paragraphs), matched
+// case-insensitively unless `ignoreCase: false`. Shared by execute() and fix().
+function findRepeatedPairs(segment, options) {
+    let tokenRe;
+    try {
+        tokenRe = new RegExp(options.pattern ?? '\\w+', 'g');
+    }
+    catch {
+        return []; // ignore invalid regex
+    }
+    const tokens = [];
+    let match;
+    while ((match = tokenRe.exec(segment.content)) !== null) {
+        // A pattern that can match empty (e.g. `\w*`) must advance lastIndex or
+        // the loop hangs; the empty token itself is skipped -- an empty "word"
+        // can't meaningfully repeat.
+        if (match[0].length === 0) {
+            tokenRe.lastIndex++;
+            continue;
+        }
+        tokens.push({ text: match[0], index: match.index });
+    }
+    // Defaults TRUE (unlike every other assertion): 'The the' is the common
+    // typo this check exists to catch.
+    const ignoreCase = options.ignoreCase !== false;
+    const pairs = [];
+    for (let i = 1; i < tokens.length; i++) {
+        const first = tokens[i - 1];
+        const second = tokens[i];
+        const gap = segment.content.slice(first.index + first.text.length, second.index);
+        if (!/^\s+$/.test(gap))
+            continue;
+        const lineBreaksInGap = gap.match(newLineRe)?.length ?? 0;
+        if (lineBreaksInGap > 1)
+            continue;
+        const same = ignoreCase
+            ? first.text.toLowerCase() === second.text.toLowerCase()
+            : first.text === second.text;
+        if (same)
+            pairs.push({ first, second });
+    }
+    return pairs;
+}
+// On the segment's first line, segment.content starts mid-source-line (e.g.
+// a heading's content excludes the '## ' marker), so segment.startColumn
+// must be added -- see pattern.ts's toSourceColumn.
+function toSourceColumn(segment, localLine, localColumn) {
+    return localLine === 1 ? segment.startColumn + (localColumn - 1) : localColumn;
+}
+const execute = async (rule, file, ctx) => {
+    const options = rule.assertions['repetition'];
+    const problems = [];
+    for (const segment of ctx.segments) {
+        const contentLines = segment.content.split(newLineRe);
+        for (const { second } of findRepeatedPairs(segment, options)) {
+            // Reported at the SECOND token's position -- exactly what fix() removes.
+            const { line: localLine, column: localColumn } = offsetToLineColumn(segment.content, second.index);
+            problems.push({
+                file,
+                line: segment.startLine + localLine - 1,
+                column: toSourceColumn(segment, localLine, localColumn),
+                text: contentLines[localLine - 1] ?? '',
+                match: second.text,
+                ruleName: rule.name,
+                severity: rule.severity,
+                message: formatTemplate(rule.message ?? 'Repeated word "%s".', second.text),
+            });
+        }
+    }
+    return problems;
+};
+const fix = async (rule, file, ctx) => {
+    const options = rule.assertions['repetition'];
+    const fixes = [];
+    // Full source lines, for the lone-token whole-line-deletion check below.
+    const fileLines = ctx.content.split(newLineRe);
+    for (const segment of ctx.segments) {
+        for (const { first, second } of findRepeatedPairs(segment, options)) {
+            const firstPos = offsetToLineColumn(segment.content, first.index);
+            const secondPos = offsetToLineColumn(segment.content, second.index);
+            if (firstPos.line === secondPos.line) {
+                // Same-line pair: delete the gap plus the second token, so the
+                // first token survives verbatim, casing included ('The the' -> 'The').
+                const gapLength = second.index - (first.index + first.text.length);
+                fixes.push({
+                    file,
+                    ruleName: rule.name,
+                    lineNumber: segment.startLine + secondPos.line - 1,
+                    editColumn: toSourceColumn(segment, firstPos.line, firstPos.column) + first.text.length,
+                    deleteCount: gapLength + second.text.length,
+                });
+            }
+            else {
+                // Cross-line (hard-wrapped) pair: a single Fix can only edit one
+                // source line (see core/auto-fix.ts), so only the second token's
+                // line is rewritten -- deleting the token plus the whitespace run
+                // following it on that line.
+                const lineNumber = segment.startLine + secondPos.line - 1;
+                const editColumn = toSourceColumn(segment, secondPos.line, secondPos.column);
+                // Checked against the full SOURCE line, not the segment-content
+                // slice: a segment can end mid-line (e.g. a sentence segment), and
+                // whole-line deletion must never eat source text outside it.
+                const sourceLine = fileLines[lineNumber - 1] ?? '';
+                const beforeToken = sourceLine.slice(0, editColumn - 1);
+                const afterOnSourceLine = sourceLine.slice(editColumn - 1 + second.text.length);
+                if (/^\s*$/.test(beforeToken) && /^\s*$/.test(afterOnSourceLine)) {
+                    // The duplicate token is alone on its line -- deleting just the
+                    // token would leave an empty line behind, so delete the whole
+                    // line instead (deleteCount: -1, see core/auto-fix.ts).
+                    fixes.push({
+                        file,
+                        ruleName: rule.name,
+                        lineNumber,
+                        deleteCount: -1,
+                    });
+                    continue;
+                }
+                const lines = segment.content.split(newLineRe);
+                const lineText = lines[secondPos.line - 1] ?? '';
+                const afterToken = lineText.slice(secondPos.column - 1 + second.text.length);
+                const trailingWhitespace = /^\s*/.exec(afterToken)?.[0] ?? '';
+                fixes.push({
+                    file,
+                    ruleName: rule.name,
+                    lineNumber,
+                    editColumn,
+                    deleteCount: second.text.length + trailingWhitespace.length,
+                });
+            }
+        }
+    }
+    return fixes;
+};
+export const repetition = { id: 'repetition', fixable: true, execute, fix };
+//# sourceMappingURL=repetition.js.map

package/dist/rules/scope/repetition.js.map

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

package/dist/rules/scope/semantic-line-breaks.d.ts

@@ -0,0 +1,3 @@
+import type { ScopeRule } from '../types.js';
+export declare const semanticLineBreaks: ScopeRule;
+//# sourceMappingURL=semantic-line-breaks.d.ts.map

package/dist/rules/scope/semantic-line-breaks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-line-breaks.d.ts","sourceRoot":"","sources":["../../../src/rules/scope/semantic-line-breaks.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAkP/D,eAAO,MAAM,kBAAkB,EAAE,SAKhC,CAAC"}

package/dist/rules/scope/semantic-line-breaks.js

@@ -0,0 +1,213 @@
+import { filterByTypes } from '../../parser/index.js';
+import { addRangeToSet } from '../token/helpers.js';
+import { newLineRe } from '../../core/line-endings.js';
+import { splitSentences } from '../../scopes/sentences.js';
+// Recheck-specific list-marker/heading skips. These aren't touched by the
+// AST consolidation below: an ATX heading's own line prefix is trivial to
+// detect without the tree, and the lettered-list heuristic (`a. Text`) has
+// no CommonMark/AST representation at all -- micromark never parses it as
+// a list, so there is no token to derive it from. See the module's
+// LEGITIMATE-REGEX AUDIT note in the project report for why these stay as
+// they are.
+//
+// The bullet check requires CommonMark marker SPACING -- optional indent,
+// one of the bullet markers `-`/`*`/`+`, then a space or tab. A bare
+// leading `-`/`*` is not enough: multi-sentence prose that merely starts
+// with emphasis (`*text* ...`), strong (`**text** ...`), or a non-list
+// dash (`-3 degrees ...`) is ordinary prose and must stay flaggable and
+// fixable. The marker-spaced check also subsumes the former
+// bullet+lettered (`- a. Text`) and bullet+numbered (`- 1. Text`)
+// nested-sub-list heuristics: both start with `marker + space`, which is
+// exactly what the bullet check now skips -- without the skip,
+// splitSentences reads their `a.`/`1.` as a sentence boundary and --fix
+// severs the marker from its own text.
+function isSkippableLine(lineText) {
+    return (lineText.trim() === '' ||
+        lineText.startsWith('#') ||
+        /^\s*[-*+][ \t]/.test(lineText) ||
+        /^\s*\d+\.\s/.test(lineText) ||
+        /^\s*[a-zA-Z]\.\s/.test(lineText));
+}
+function calculateContinuationIndent(line) {
+    // Peel off the blockquote prefix first: leading whitespace plus one or
+    // more '>' markers (each optionally followed by whitespace). It is kept
+    // VERBATIM on continuation lines -- unlike list markers below, a
+    // blockquote marker replaced by spaces would demote the split-off
+    // sentences to lazy continuation lines, which still render inside the
+    // blockquote but no longer read as part of it in the source (the whole
+    // point of semantic line breaks). Lines without any '>' marker leave
+    // `blockquotePrefix` empty and take the exact pre-existing code path
+    // below, so non-blockquote continuation output is unchanged byte-for-byte.
+    const blockquotePrefix = line.match(/^(\s*(?:>\s*)+)/)?.[1] ?? '';
+    const remainder = line.slice(blockquotePrefix.length);
+    const leadingWhitespace = remainder.match(/^(\s*)/)?.[1] || '';
+    // Check for list markers and return appropriate indentation: the marker
+    // must NOT repeat on continuation lines (that would create new list
+    // items), so it is replaced by spaces of equal width to align the
+    // continuation under the list content.
+    const listMarkers = [
+        /^(\s*[-*+]\s)/, // Bullet points (all three CommonMark markers, matching isSkippableLine)
+        /^(\s*\d+\.\s)/, // Numbered lists
+        /^(\s*[a-zA-Z]\.\s)/, // Letter lists
+    ];
+    for (const pattern of listMarkers) {
+        const match = remainder.match(pattern);
+        if (match) {
+            return blockquotePrefix + ' '.repeat(match[1].length);
+        }
+    }
+    return blockquotePrefix + leadingWhitespace;
+}
+// Shared by execute() and fix() so both apply the exact same gate: with
+// mode !== 'sentence' (e.g. 'phrase'), this rule doesn't detect anything
+// today, so fix() must not rewrite lines either -- previously fix() split
+// every multi-sentence line unconditionally regardless of `mode`, letting
+// --fix rewrite lines lint never flagged under a non-'sentence' mode.
+function isSentenceMode(options) {
+    return options.mode === 'sentence';
+}
+function formatMessage(template, ...args) {
+    let result = template;
+    for (let i = 0; i < args.length; i++) {
+        result = result.replace('%s', args[i]);
+    }
+    return result;
+}
+/**
+ * Line numbers (1-based) that fall inside a real fenced/indented code block
+ * or a real GFM table, derived once from the whole document's token tree --
+ * the same whole-file self-derivation pattern `line-length.ts` (MD013) uses
+ * for its own `codeBlocks`/`tables` options. Replaces the old per-line
+ * ``` ` ``` -toggle and `line.includes('|')` heuristics: those only caught
+ * backtick-fenced blocks (never tilde fences or indented code) and treated
+ * ANY line containing a literal `|` as a table (a false positive for, e.g.,
+ * prose mentioning `true|false` or a shell `foo | bar` pipeline outside any
+ * table). Computed over `ctx.tree` regardless of the rule's own scope
+ * selector, since a code/table token's true extent doesn't depend on which
+ * segments this invocation happens to be scoped to.
+ */
+function deriveIgnoredLineNumbers(ctx) {
+    const codeBlockLines = new Set();
+    for (const codeBlock of filterByTypes(ctx.tree, ['codeFenced', 'codeIndented'])) {
+        addRangeToSet(codeBlockLines, codeBlock.startLine, codeBlock.endLine);
+    }
+    const tableLines = new Set();
+    for (const table of filterByTypes(ctx.tree, ['table'])) {
+        addRangeToSet(tableLines, table.startLine, table.endLine);
+    }
+    return { codeBlockLines, tableLines };
+}
+/**
+ * The single skip-decision used by both `execute` and `fix`. `fix()` must
+ * never rewrite a line that `execute()` wouldn't have flagged in the first
+ * place -- previously `fix()` only checked for blank lines and '#'
+ * headings, missing the tree-derived codeBlockLines/tableLines gating (and
+ * `isSkippableLine` entirely), so --fix could rewrite lines lint never
+ * reported as problems (e.g. an indented code-block line, or a table row).
+ */
+function isIgnoredLine(lineText, lineNumber, options, ignoredLines) {
+    if (options.ignoreCodeBlocks && ignoredLines.codeBlockLines.has(lineNumber))
+        return true;
+    if (options.ignoreTables && ignoredLines.tableLines.has(lineNumber))
+        return true;
+    return isSkippableLine(lineText);
+}
+const execute = async (rule, file, ctx) => {
+    const problems = [];
+    const options = rule.assertions['semantic-line-breaks'];
+    const ignoredLines = deriveIgnoredLineNumbers(ctx);
+    for (const segment of ctx.segments) {
+        const lines = segment.content.split(newLineRe);
+        for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+            const lineText = lines[lineIndex];
+            const lineNumber = segment.startLine + lineIndex;
+            if (isIgnoredLine(lineText, lineNumber, options, ignoredLines))
+                continue;
+            if (isSentenceMode(options)) {
+                const sentenceCount = splitSentences(lineText).length;
+                if (sentenceCount > 1) {
+                    problems.push({
+                        file,
+                        line: lineNumber,
+                        column: 1,
+                        text: lineText,
+                        match: lineText,
+                        ruleName: rule.name,
+                        severity: rule.severity,
+                        message: formatMessage(rule.message ?? '', options.mode),
+                    });
+                }
+            }
+        }
+    }
+    return problems;
+};
+const fix = async (rule, file, ctx) => {
+    const fixes = [];
+    const options = rule.assertions['semantic-line-breaks'];
+    if (!isSentenceMode(options))
+        return fixes;
+    const ignoredLines = deriveIgnoredLineNumbers(ctx);
+    const rawLines = ctx.content.split(newLineRe);
+    for (const segment of ctx.segments) {
+        const lines = segment.content.split(newLineRe);
+        for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
+            const lineText = lines[lineIndex];
+            const lineNumber = segment.startLine + lineIndex;
+            if (isIgnoredLine(lineText, lineNumber, options, ignoredLines))
+                continue;
+            const sentences = splitSentences(lineText);
+            if (sentences.length <= 1)
+                continue;
+            // The replacement is applied with deleteCount: -1 (whole-line
+            // replace), so it must be rebuilt from the RAW source line, never
+            // from segment.content: under a scoped run (scope: summary /
+            // list-item / default) a list item's segment content is the SEMANTIC
+            // text with the list marker stripped by the token boundaries (the
+            // item's `content` token starts after the `- ` prefix), and
+            // rebuilding from it would replace `- First. Second.` with
+            // marker-less `First.\nSecond.`, corrupting the list. Sentence
+            // DETECTION stays on lineText -- the exact text execute() flags -- so
+            // execute()/fix() symmetry is untouched; only the replacement text
+            // derives from the raw line. On the segment's first line the token's
+            // startColumn locates the segment text within the raw line; later
+            // segment lines are verbatim source slices already (token text is
+            // content.slice(start.offset, end.offset)), and the whole-file
+            // segment has startColumn 1 -- both leave prefixOffset at 0, keeping
+            // whole-file (scope: all / unscoped) output byte-identical to before.
+            const rawLine = rawLines[lineNumber - 1] ?? lineText;
+            const prefixOffset = lineIndex === 0 ? segment.startColumn - 1 : 0;
+            const indentation = calculateContinuationIndent(rawLine);
+            const [firstSentence, ...continuationSentences] = sentences;
+            // Reconstruct the first sentence line from the TRUE original prefix
+            // (everything in the raw line before the trimmed sentence content
+            // starts -- indentation, blockquote markers, a list marker), not from
+            // `firstSentence.text` alone: splitSentences trims each span, so pure
+            // leading whitespace on the line is gone from `.text` with nowhere to
+            // go back to. Continuation lines are unaffected -- they were never
+            // built from the original line's own prefix in the first place.
+            const firstLinePrefix = rawLine.slice(0, prefixOffset + firstSentence.start);
+            const newLinesForThisLine = [
+                firstLinePrefix + firstSentence.text,
+                ...continuationSentences.map((sentence) => indentation + sentence.text),
+            ];
+            const newText = newLinesForThisLine.join('\n');
+            fixes.push({
+                file,
+                ruleName: rule.name,
+                lineNumber,
+                editColumn: 1,
+                deleteCount: -1,
+                insertText: newText,
+            });
+        }
+    }
+    return fixes;
+};
+export const semanticLineBreaks = {
+    id: 'semantic-line-breaks',
+    fixable: true,
+    execute,
+    fix,
+};
+//# sourceMappingURL=semantic-line-breaks.js.map

package/dist/rules/scope/semantic-line-breaks.js.map

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

package/dist/rules/scope/spelling.d.ts

@@ -0,0 +1,27 @@
+import type { ScopeRule } from '../types.js';
+/**
+ * Resolves a `dictionary` option value (the shared base path WITHOUT the
+ * `.aff`/`.dic` extension) to its two file paths. Resolved relative to
+ * `process.cwd()`, not the config file's directory — consistent with every
+ * other file-shaped config value in this package; an absolute path is used
+ * as-is.
+ *
+ * Exported so `../../config/validate.ts`'s dictionary-file-existence check
+ * (see `checkSpellingPeerDependencies` there) shares this EXACT resolution
+ * rule instead of re-implementing it — a config that validates cleanly must
+ * always name the same files `readCustomDictionary` below actually reads at
+ * lint time, or validate() and the runtime could silently disagree about
+ * which files a `dictionary` path names.
+ */
+export declare function resolveDictionaryPaths(dictionaryPath: string): {
+    aff: string;
+    dic: string;
+};
+/**
+ * Formats the fallback message's second `%s` slot: `''` for zero
+ * suggestions, or `' — did you mean: a, b, c?'` for one to three.
+ * Exported for direct unit testing.
+ */
+export declare function formatSuggestionSuffix(suggestions: string[]): string;
+export declare const spelling: ScopeRule;
+//# sourceMappingURL=spelling.d.ts.map

package/dist/rules/scope/spelling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spelling.d.ts","sourceRoot":"","sources":["../../../src/rules/scope/spelling.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAuC/D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAK3F;AAuGD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAGpE;AAwGD,eAAO,MAAM,QAAQ,EAAE,SAAuD,CAAC"}