@redocly/recheck 0.15.0 → 2.58.1

package/lib/rules/token/descriptive-link-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptive-link-text.d.ts","sourceRoot":"","sources":["../../../src/rules/token/descriptive-link-text.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAe7C,eAAO,MAAM,mBAAmB,EAAE,SAqCjC,CAAC"}

package/lib/rules/token/descriptive-link-text.js

@@ -0,0 +1,46 @@
+import { filterByTypes } from '../../parser/index.js';
+import { getDescendantsByType } from './helpers.js';
+const allowedChildrenTypes = new Set(['codeText', 'htmlText']);
+const defaultProhibitedTexts = ['click here', 'here', 'link', 'more'];
+/** Normalizes a string by removing extra whitespace and punctuation. */
+function normalize(str) {
+    return str
+        .replace(/[\W_]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .toLowerCase()
+        .trim();
+}
+export const descriptiveLinkText = {
+    name: 'descriptive-link-text',
+    tags: ['accessibility', 'links'],
+    fixable: false,
+    defaults: {
+        message: 'Link text should be descriptive',
+        prohibitedTexts: defaultProhibitedTexts,
+    },
+    check(ctx) {
+        const configuredProhibited = ctx.config.prohibitedTexts;
+        // An empty array is used as is and turns the rule off; only a missing value uses the defaults.
+        const prohibitedTexts = new Set((Array.isArray(configuredProhibited)
+            ? configuredProhibited.map(String)
+            : defaultProhibitedTexts).map(normalize));
+        if (prohibitedTexts.size === 0)
+            return;
+        for (const link of filterByTypes(ctx.tree, ['link'])) {
+            const labelTexts = getDescendantsByType(link, ['label', 'labelText']);
+            for (const labelText of labelTexts) {
+                const { children, endLine, parent, startColumn, startLine, text } = labelText;
+                if (!children.some((child) => allowedChildrenTypes.has(child.type)) &&
+                    prohibitedTexts.has(normalize(text))) {
+                    const hasRange = startLine === endLine;
+                    ctx.onError({
+                        line: startLine,
+                        column: hasRange ? startColumn : undefined,
+                        context: hasRange ? (parent?.text ?? text) : undefined,
+                    });
+                }
+            }
+        }
+    },
+};
+//# sourceMappingURL=descriptive-link-text.js.map

package/lib/rules/token/descriptive-link-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptive-link-text.js","sourceRoot":"","sources":["../../../src/rules/token/descriptive-link-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAItD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAC/D,MAAM,sBAAsB,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEtE,wEAAwE;AACxE,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG;SACP,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,WAAW,EAAE;SACb,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAc;IAC5C,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,CAAC,eAAe,EAAE,OAAO,CAAC;IAChC,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE;QACR,OAAO,EAAE,iCAAiC;QAC1C,eAAe,EAAE,sBAAsB;KACxC;IACD,KAAK,CAAC,GAAG;QACP,MAAM,oBAAoB,GAAG,GAAG,CAAC,MAAM,CAAC,eAAe,CAAC;QACxD,+FAA+F;QAC/F,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,CAAC;YAClC,CAAC,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC;YAClC,CAAC,CAAC,sBAAsB,CACzB,CAAC,GAAG,CAAC,SAAS,CAAC,CACjB,CAAC;QACF,IAAI,eAAe,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QAEvC,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACrD,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;YACtE,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;gBACnC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;gBAC9E,IACE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC/D,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EACpC,CAAC;oBACD,MAAM,QAAQ,GAAG,SAAS,KAAK,OAAO,CAAC;oBACvC,GAAG,CAAC,OAAO,CAAC;wBACV,IAAI,EAAE,SAAS;wBACf,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;wBAC1C,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;qBACvD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC"}

package/lib/rules/token/fenced-code-language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fenced-code-language.d.ts","sourceRoot":"","sources":["../../../src/rules/token/fenced-code-language.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,eAAO,MAAM,kBAAkB,EAAE,SA8BhC,CAAC"}

package/lib/rules/token/fenced-code-language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fenced-code-language.js","sourceRoot":"","sources":["../../../src/rules/token/fenced-code-language.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAItD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,MAAM,CAAC,MAAM,kBAAkB,GAAc;IAC3C,IAAI,EAAE,sBAAsB;IAC5B,IAAI,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC;IAC1B,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE;QACR,OAAO,EAAE,qDAAqD;QAC9D,gBAAgB,EAAE,EAAE;QACpB,YAAY,EAAE,KAAK;KACpB;IACD,KAAK,CAAC,GAAG;QACP,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC;QAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAE,UAAwB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,MAAM,YAAY,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC;QAC/C,KAAK,MAAM,UAAU,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;YACjE,MAAM,YAAY,GAAG,oBAAoB,CAAC,UAAU,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC9E,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC;YACzC,MAAM,IAAI,GAAG,oBAAoB,CAAC,YAAY,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC;YAClF,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,CAAC;iBAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,IAAI,kBAAkB,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,IAAI,YAAY,IAAI,oBAAoB,CAAC,YAAY,EAAE,CAAC,qBAAqB,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC3F,GAAG,CAAC,OAAO,CAAC;oBACV,IAAI,EAAE,SAAS;oBACf,MAAM,EAAE,6CAA6C,IAAI,GAAG;iBAC7D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC"}

package/lib/rules/token/first-line-h1.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"first-line-h1.d.ts","sourceRoot":"","sources":["../../../src/rules/token/first-line-h1.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAoC7C,eAAO,MAAM,WAAW,EAAE,SAqDzB,CAAC"}

package/lib/rules/token/first-line-h1.js

@@ -0,0 +1,83 @@
+import { frontMatterHasTitle, getFrontmatterEndLine, getHeadingLevel, getHtmlTagInfo, isHtmlFlowComment, nonContentTokens, } from './helpers.js';
+const headingTagNameRe = /^h[1-6]$/;
+/**
+ * Finds the first descendant of `token` with the given type, at any depth.
+ * Uses a loop instead of recursion so deeply nested input cannot overflow the stack.
+ */
+function findDescendantByType(token, type) {
+    const stack = [];
+    for (let i = token.children.length - 1; i >= 0; i--)
+        stack.push(token.children[i]);
+    while (stack.length > 0) {
+        const current = stack.pop();
+        if (current === undefined)
+            break;
+        if (current.type === type)
+            return current;
+        for (let i = current.children.length - 1; i >= 0; i--)
+            stack.push(current.children[i]);
+    }
+    return null;
+}
+/** Returns the name of the first HTML tag in an htmlFlow token. */
+function getHtmlFlowTagName(token) {
+    if (token.type !== 'htmlFlow')
+        return null;
+    const firstHtmlText = findDescendantByType(token, 'htmlText');
+    const tagInfo = firstHtmlText && getHtmlTagInfo(firstHtmlText);
+    return tagInfo ? tagInfo.name.toLowerCase() : null;
+}
+export const firstLineH1 = {
+    name: 'first-line-h1',
+    aliases: ['first-line-heading'],
+    tags: ['headings'],
+    fixable: false,
+    defaults: {
+        message: 'First line in a file should be a top-level heading',
+        allowPreamble: false,
+        frontMatterTitle: '^"?title"?\\s*[:=]',
+        level: 1,
+    },
+    check(ctx) {
+        const allowPreamble = !!ctx.config.allowPreamble;
+        const level = Number(ctx.config.level ?? 1);
+        // A front matter title counts as the top-level heading.
+        if (frontMatterHasTitle(ctx.tree, ctx.config.frontMatterTitle))
+            return;
+        // Front matter is part of the tree, so skip its tokens. Otherwise front matter
+        // without a title would count as content before the heading.
+        const frontmatterEndLine = getFrontmatterEndLine(ctx.tree);
+        // Only top-level tokens: `ctx.tree.flat` would also visit the inside of an
+        // HTML comment, which isHtmlFlowComment does not recognize.
+        let errorLineNumber = 0;
+        for (const token of ctx.tree.children) {
+            const { startLine, type } = token;
+            if (startLine <= frontmatterEndLine || nonContentTokens.has(type) || isHtmlFlowComment(token))
+                continue;
+            const tagName = getHtmlFlowTagName(token);
+            if (type === 'atxHeading' || type === 'setextHeading') {
+                if (getHeadingLevel(token) !== level) {
+                    errorLineNumber = startLine;
+                }
+                break;
+            }
+            else if (tagName && headingTagNameRe.test(tagName)) {
+                if (tagName !== `h${level}`) {
+                    errorLineNumber = startLine;
+                }
+                break;
+            }
+            else if (!allowPreamble) {
+                errorLineNumber = startLine;
+                break;
+            }
+        }
+        if (errorLineNumber > 0) {
+            ctx.onError({
+                line: errorLineNumber,
+                context: ctx.lines[errorLineNumber - 1],
+            });
+        }
+    },
+};
+//# sourceMappingURL=first-line-h1.js.map

package/lib/rules/token/first-line-h1.js.map

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

package/lib/rules/token/front-matter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"front-matter.d.ts","sourceRoot":"","sources":["../../../src/rules/token/front-matter.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA0H7C,eAAO,MAAM,WAAW,EAAE,SAoEzB,CAAC"}

package/lib/rules/token/front-matter.js

@@ -0,0 +1,169 @@
+import Ajv2020 from '@redocly/ajv/dist/2020.js';
+import addFormats from 'ajv-formats';
+import * as yaml from 'js-yaml';
+import { readFileSync } from 'node:fs';
+import { REALM_FRONT_MATTER_SCHEMA } from '../../data/realm-front-matter-schema.js';
+import { filterByTypes } from '../../parser/index.js';
+import { isPlainObject } from '../../utils/is-plain-object.js';
+import { fileMatchesAnyPattern } from '../utils.js';
+// Built-in schemas that can be selected by name.
+const BUILT_IN_SCHEMAS = {
+    realm: REALM_FRONT_MATTER_SCHEMA,
+};
+// CJS/ESM interop: the ajv build exports the constructor as `default`.
+const AjvConstructor = Ajv2020.default ?? Ajv2020;
+const validatorCache = new WeakMap();
+// A schema that cannot load or compile is reported at the rule's severity.
+// A thrown error would only be a warning and would not fail the run.
+function validatorFor(mapping) {
+    const cached = validatorCache.get(mapping);
+    if (cached)
+        return cached;
+    const entry = buildValidator(mapping);
+    validatorCache.set(mapping, entry);
+    return entry;
+}
+function buildValidator(mapping) {
+    let schema = mapping.schema;
+    if (typeof schema === 'string') {
+        const builtIn = BUILT_IN_SCHEMAS[schema];
+        if (!builtIn) {
+            return {
+                failure: `unknown built-in schema "${schema}" (available: ${Object.keys(BUILT_IN_SCHEMAS).join(', ')})`,
+            };
+        }
+        schema = builtIn;
+    }
+    if (schema === undefined && typeof mapping.schemaFile === 'string') {
+        let raw;
+        try {
+            raw = readFileSync(mapping.schemaFile, 'utf8');
+        }
+        catch (error) {
+            return {
+                failure: `cannot read schemaFile "${mapping.schemaFile}" (${error instanceof Error ? error.message : String(error)})`,
+            };
+        }
+        try {
+            schema = yaml.load(raw, { schema: yaml.CORE_SCHEMA });
+        }
+        catch (error) {
+            return {
+                failure: `schemaFile "${mapping.schemaFile}" is not valid YAML (${error instanceof Error ? error.message.split('\n')[0] : String(error)})`,
+            };
+        }
+    }
+    if (!isPlainObject(schema)) {
+        return {
+            failure: 'each schemas entry needs a `schema` object, a built-in schema name, or a `schemaFile` path',
+        };
+    }
+    // `strict` rejects unknown keys, unless the schema sets `additionalProperties` itself.
+    const compiled = mapping.strict === true && !('additionalProperties' in schema)
+        ? { ...schema, additionalProperties: false }
+        : schema;
+    const ajv = new AjvConstructor({ allErrors: true, strict: false });
+    addFormats(ajv); // mismatching AJV typing due to fork
+    try {
+        return { validate: ajv.compile(compiled) };
+    }
+    catch (error) {
+        return {
+            failure: `schema does not compile (${error instanceof Error ? error.message : String(error)})`,
+        };
+    }
+}
+// A value that fails `anyOf`/`oneOf` gives one error per branch plus a summary.
+// Keep the summary and drop the branch errors at the same path.
+function collapseBranchErrors(errors) {
+    const branchPaths = new Set(errors
+        .filter((error) => error.keyword === 'anyOf' || error.keyword === 'oneOf')
+        .map((error) => error.instancePath));
+    if (branchPaths.size === 0)
+        return errors;
+    return errors.filter((error) => error.keyword === 'anyOf' || error.keyword === 'oneOf' || !branchPaths.has(error.instancePath));
+}
+// JSON pointer unescape: `~1` is `/` and `~0` is `~`.
+function pointerSegments(instancePath) {
+    if (instancePath === '')
+        return [];
+    return instancePath
+        .slice(1)
+        .split('/')
+        .map((segment) => segment.replace(/~1/g, '/').replace(/~0/g, '~'));
+}
+// Finds the line of a top-level key, so a nested error still points at a line.
+// The key may be quoted.
+function lineForKey(key, valueLines, blockStartLine) {
+    const candidates = [`${key}:`, `'${key}':`, `"${key}":`];
+    for (const line of valueLines) {
+        const text = line.text;
+        if (candidates.some((candidate) => text.startsWith(candidate)))
+            return line.startLine;
+    }
+    return blockStartLine;
+}
+export const frontMatter = {
+    name: 'front-matter',
+    tags: ['structure'],
+    fixable: false,
+    defaults: {
+        message: 'Front matter: %s',
+        schemas: [],
+    },
+    check(ctx) {
+        const schemas = (ctx.config.schemas ?? []);
+        if (!Array.isArray(schemas) || schemas.length === 0)
+            return;
+        const mapping = schemas.find((entry) => Array.isArray(entry.files) && fileMatchesAnyPattern(ctx.filePath, entry.files));
+        if (!mapping)
+            return;
+        const entry = validatorFor(mapping);
+        if ('failure' in entry) {
+            ctx.onError({ line: 1, context: entry.failure });
+            return;
+        }
+        const validate = entry.validate;
+        const block = filterByTypes(ctx.tree, ['yaml'])[0];
+        const blockStartLine = block?.startLine ?? 1;
+        const valueLines = block?.children.filter((child) => child.type === 'yamlValue') ?? [];
+        let data = {};
+        if (block) {
+            const source = valueLines.map((line) => line.text).join('\n');
+            try {
+                // CORE_SCHEMA keeps timestamps as strings, which is what JSON Schema sees.
+                data = yaml.load(source, { schema: yaml.CORE_SCHEMA }) ?? {};
+            }
+            catch (error) {
+                ctx.onError({
+                    line: blockStartLine,
+                    context: `not valid YAML (${error instanceof Error ? error.message.split('\n')[0] : String(error)})`,
+                });
+                return;
+            }
+        }
+        if (validate(data))
+            return;
+        for (const error of collapseBranchErrors(validate.errors ?? [])) {
+            const segments = pointerSegments(error.instancePath);
+            // For additionalProperties the error is on the object; the extra key is in params.
+            const extraKey = error.keyword === 'additionalProperties'
+                ? error.params.additionalProperty
+                : undefined;
+            const keyForLine = extraKey ?? segments[0];
+            const line = keyForLine === undefined
+                ? blockStartLine
+                : lineForKey(keyForLine, valueLines, blockStartLine);
+            const at = segments.length === 0
+                ? extraKey === undefined
+                    ? 'front matter'
+                    : `'${extraKey}'`
+                : `'${segments.join('.')}'`;
+            const message = extraKey === undefined
+                ? (error.message ?? 'does not match the schema')
+                : 'is not an allowed property';
+            ctx.onError({ line, context: `${at} ${message}` });
+        }
+    },
+};
+//# sourceMappingURL=front-matter.js.map

package/lib/rules/token/front-matter.js.map

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

package/lib/rules/token/heading-increment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-increment.d.ts","sourceRoot":"","sources":["../../../src/rules/token/heading-increment.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,eAAO,MAAM,gBAAgB,EAAE,SAsB9B,CAAC"}

package/lib/rules/token/heading-increment.js

@@ -0,0 +1,26 @@
+import { filterByTypes } from '../../parser/index.js';
+import { frontMatterHasTitle, getHeadingLevel } from './helpers.js';
+export const headingIncrement = {
+    name: 'heading-increment',
+    tags: ['headings'],
+    fixable: false,
+    defaults: {
+        message: 'Heading levels should only increment by one level at a time.',
+        frontMatterTitle: '^"?title"?\\s*[:=]',
+    },
+    check(ctx) {
+        // A front matter title counts as an h1.
+        let previous = frontMatterHasTitle(ctx.tree, ctx.config.frontMatterTitle) ? 1 : 0;
+        for (const heading of filterByTypes(ctx.tree, ['atxHeading', 'setextHeading'])) {
+            const level = getHeadingLevel(heading);
+            if (previous && level > previous + 1) {
+                ctx.onError({
+                    line: heading.startLine,
+                    detail: `Expected: h${previous + 1}; Actual: h${level}`,
+                });
+            }
+            previous = level;
+        }
+    },
+};
+//# sourceMappingURL=heading-increment.js.map

package/lib/rules/token/heading-increment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-increment.js","sourceRoot":"","sources":["../../../src/rules/token/heading-increment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAItD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpE,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE;QACR,OAAO,EAAE,8DAA8D;QACvE,gBAAgB,EAAE,oBAAoB;KACvC;IACD,KAAK,CAAC,GAAG;QACP,wCAAwC;QACxC,IAAI,QAAQ,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,KAAK,MAAM,OAAO,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;YAC/E,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,QAAQ,IAAI,KAAK,GAAG,QAAQ,GAAG,CAAC,EAAE,CAAC;gBACrC,GAAG,CAAC,OAAO,CAAC;oBACV,IAAI,EAAE,OAAO,CAAC,SAAS;oBACvB,MAAM,EAAE,cAAc,QAAQ,GAAG,CAAC,cAAc,KAAK,EAAE;iBACxD,CAAC,CAAC;YACL,CAAC;YACD,QAAQ,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;CACF,CAAC"}

package/lib/rules/token/heading-start-left.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-start-left.d.ts","sourceRoot":"","sources":["../../../src/rules/token/heading-start-left.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,gBAAgB,EAAE,SA8B9B,CAAC"}

package/lib/rules/token/heading-start-left.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-start-left.js","sourceRoot":"","sources":["../../../src/rules/token/heading-start-left.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAKtD,MAAM,CAAC,MAAM,gBAAgB,GAAc;IACzC,IAAI,EAAE,oBAAoB;IAC1B,IAAI,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC;IAC5B,OAAO,EAAE,IAAI;IACb,QAAQ,EAAE;QACR,OAAO,EAAE,kDAAkD;KAC5D;IACD,KAAK,CAAC,GAAG;QACP,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC;QACxF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,IACE,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY;gBACjC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY;gBACrC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EACnD,CAAC;gBACD,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAC1D,MAAM,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;gBACvC,GAAG,CAAC,OAAO,CAAC;oBACV,IAAI,EAAE,SAAS;oBACf,MAAM,EAAE,WAAW;oBACnB,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;oBACjC,OAAO,EAAE;wBACP,UAAU,EAAE,SAAS;wBACrB,UAAU,EAAE,WAAW;wBACvB,WAAW,EAAE,MAAM;qBACpB;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC"}

package/lib/rules/token/heading-style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-style.d.ts","sourceRoot":"","sources":["../../../src/rules/token/heading-style.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,eAAO,MAAM,YAAY,EAAE,SAsC1B,CAAC"}

package/lib/rules/token/heading-style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-style.js","sourceRoot":"","sources":["../../../src/rules/token/heading-style.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAItD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,CAAC,MAAM,YAAY,GAAc;IACrC,IAAI,EAAE,eAAe;IACrB,IAAI,EAAE,CAAC,UAAU,CAAC;IAClB,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE;QACR,OAAO,EAAE,eAAe;QACxB,KAAK,EAAE,YAAY;KACpB;IACD,KAAK,CAAC,GAAG;QACP,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC;QACrD,KAAK,MAAM,OAAO,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;YAC/E,MAAM,aAAa,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;YAC/C,IAAI,KAAK,KAAK,YAAY,EAAE,CAAC;gBAC3B,KAAK,GAAG,aAAa,CAAC;YACxB,CAAC;YACD,IAAI,aAAa,KAAK,KAAK,EAAE,CAAC;gBAC5B,MAAM,GAAG,GAAG,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC1C,MAAM,aAAa,GACjB,KAAK,KAAK,iBAAiB;oBAC3B,CAAC,CAAC,GAAG,IAAI,aAAa,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,aAAa,KAAK,KAAK,CAAC,CAAC,CAAC;gBAC7E,MAAM,mBAAmB,GACvB,KAAK,KAAK,wBAAwB;oBAClC,CAAC,CAAC,GAAG,IAAI,aAAa,KAAK,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,aAAa,KAAK,YAAY,CAAC,CAAC,CAAC;gBACpF,IAAI,CAAC,aAAa,IAAI,CAAC,mBAAmB,EAAE,CAAC;oBAC3C,IAAI,QAAQ,GAAW,KAAK,CAAC;oBAC7B,IAAI,KAAK,KAAK,iBAAiB,EAAE,CAAC;wBAChC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;oBACpC,CAAC;yBAAM,IAAI,KAAK,KAAK,wBAAwB,EAAE,CAAC;wBAC9C,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;oBAC3C,CAAC;oBACD,GAAG,CAAC,OAAO,CAAC;wBACV,IAAI,EAAE,OAAO,CAAC,SAAS;wBACvB,MAAM,EAAE,aAAa,QAAQ,aAAa,aAAa,EAAE;qBAC1D,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAC"}

package/lib/rules/token/helpers.d.ts

@@ -0,0 +1,115 @@
+import type { Token, TokenTree } from '../../parser/types.js';
+/** Adds the numbers from `start` to `end` (both included) to a set. */
+export declare function addRangeToSet(set: Set<number>, start: number, end: number): void;
+/** A line/column range in a file (1-based, both ends included). A `Token` can be used as one. */
+export interface FileRange {
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+}
+/** Returns whether two ranges (or tokens) overlap. */
+export declare function hasOverlap(rangeA: FileRange, rangeB: FileRange): boolean;
+/**
+ * Returns the tokens that match `predicate`, searching depth first. It accepts a
+ * token tree or an array of tokens. `transformChildren` can change which children
+ * are searched for a token, for example to skip nested lists.
+ */
+export declare function filterByPredicate(tree: TokenTree | Token[], predicate: (token: Token) => boolean, transformChildren?: (token: Token) => Token[]): Token[];
+/**
+ * Gets nested descendants by type path. Each path item matches one level and can
+ * be one type or an array of alternative types.
+ */
+export declare function getDescendantsByType(token: Token, typePath: readonly (string | readonly string[])[]): Token[];
+/** Gets the nearest parent with one of the given types. */
+export declare function getParentOfType(token: Token, types: readonly string[]): Token | null;
+/** Gets the level (1-6) of an atx or setext heading. */
+export declare function getHeadingLevel(heading: Token): number;
+/** Returns 'setext', 'atx', or 'atx_closed' (an atx heading with closing `#` marks). */
+export declare function getHeadingStyle(heading: Token): 'setext' | 'atx' | 'atx_closed';
+/** Gets the heading text, with newlines (setext headings can span lines) turned into spaces. */
+export declare function getHeadingText(heading: Token): string;
+/** Gets the blockquote prefix of a line, e.g. `"> "`, repeated `count` times on separate lines. */
+export declare function getBlockQuotePrefixText(tree: TokenTree, lineNumber: number, count?: number): string;
+/** True if the line is empty or only has whitespace, `>` marks or HTML comments. */
+export declare function isBlankLine(line: string): boolean;
+/** Token types that are not document content (indentation, blank lines, container prefixes). */
+export declare const nonContentTokens: Set<string>;
+/**
+ * Returns the last line (1-based) of the YAML front matter, or 0 if there is none.
+ * The parser keeps front matter in the tree, so rules that scan from the top must skip it.
+ */
+export declare function getFrontmatterEndLine(tree: TokenTree): number;
+/**
+ * True if one line of the front matter matches `pattern` (the `frontMatterTitle` option).
+ * A front matter title counts as the h1 for `heading-increment`, `single-h1` and
+ * `first-line-h1`. An empty or missing pattern turns this off. The pattern is
+ * tested on each line separately, so it cannot match across lines.
+ */
+export declare function frontMatterHasTitle(tree: TokenTree, pattern: unknown): boolean;
+/** True for a valid CommonMark HTML comment token (`<!-- ... -->`). */
+export declare function isHtmlFlowComment(token: Token): boolean;
+/**
+ * Replaces the text inside HTML comments with `.`, keeping all positions. Rules
+ * that scan lines then ignore comment content. The token tree is not cleared.
+ */
+export declare function clearHtmlCommentText(text: string): string;
+export declare const endOfLineHtmlEntityRe: RegExp;
+export declare const endOfLineGemojiCodeRe: RegExp;
+export declare const allPunctuation = ".,;:!?\u3002\uFF0C\uFF1B\uFF1A\uFF01\uFF1F";
+export declare const allPunctuationNoQuestion: string;
+/** Escapes a string for use in a RegExp. */
+export declare function escapeForRegExp(str: string): string;
+/**
+ * Replaces unpaired surrogates with U+FFFD, like `String.prototype.toWellFormed()`,
+ * which the package's ES2021 target does not have.
+ */
+export declare function toWellFormedString(str: string): string;
+/** Whether an HTML tag is a closing tag, and its name. */
+export interface HtmlTagInfo {
+    close: boolean;
+    name: string;
+}
+/** Gets the tag info of an `htmlText` token, or `null` if it has no tag (e.g. a comment). */
+export declare function getHtmlTagInfo(token: Token): HtmlTagInfo | null;
+/** Builds a RegExp that captures the value of an HTML attribute such as `alt=`. */
+export declare function getHtmlAttributeRe(name: string): RegExp;
+/** Shortens long text for error context, keeping the start, the end, or both. */
+export declare function ellipsify(text: string, start?: boolean, end?: boolean): string;
+/** True for a DocFX tab heading: an atx heading that is only a link to `#tab/...`. */
+export declare function isDocfxTab(heading: Token | null | undefined): boolean;
+export declare function normalizeReference(s: string): string;
+/** One use of a reference label: `[lineIndex, columnIndex, length]`, all 0-based. */
+export type ReferenceDatum = [lineIndex: number, columnIndex: number, length: number];
+export interface GetReferenceLinkImageDataResult {
+    /** Uses of full and collapsed references (`[text][label]`, `[label][]`), by normalized label. */
+    references: Map<string, ReferenceDatum[]>;
+    /** Uses of shortcut references (`[label]`) and footnote calls (`[^label]`), by normalized label. */
+    shortcuts: Map<string, ReferenceDatum[]>;
+    /** `[lineIndex, destination]` of each definition, by normalized label. */
+    definitions: Map<string, [number, string]>;
+    /** `[label, lineIndex]` for each definition after the first one with that label. */
+    duplicateDefinitions: [string, number][];
+}
+/**
+ * Finds reference-style links and images and their definitions in the whole file:
+ * which labels are defined, which are used, and which definitions are duplicates.
+ *
+ * Unlike markdownlint, undefined references are not tokens in our tree, so
+ * `scanUndefinedReferences` finds them with a plain text scan. It can miss some
+ * multi-line cases. Only `reference-links-images` needs undefined references.
+ */
+export declare function getReferenceLinkImageData(tree: TokenTree): GetReferenceLinkImageDataResult;
+export interface ImageDestination {
+    /** The image token, for reporting its position. */
+    token: Token;
+    /** The destination as written: the inline `(path "title")` one, or the one from the matching definition. */
+    destination: string;
+}
+/**
+ * Finds the destination path or URL of every image, for both inline `![alt](path)`
+ * and reference `![alt][ref]` syntax. Used by `max-image-size` and when loading
+ * image files, so both use the same destination strings.
+ */
+export declare function getImageDestinations(tree: TokenTree): ImageDestination[];
+//# sourceMappingURL=helpers.d.ts.map

package/lib/rules/token/helpers.d.ts.map

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