@redocly/recheck 0.14.0 → 2.58.0

package/lib/parser/index.js

@@ -0,0 +1,123 @@
+// Micromark wrapper that builds the token tree.
+// The event-to-tree code is adapted from markdownlint's lib/micromark-parse.mjs
+// (https://github.com/DavidAnson/markdownlint, MIT © David Anson).
+import { parse, postprocess, preprocess } from 'micromark';
+import { directive } from 'micromark-extension-directive';
+import { frontmatter } from 'micromark-extension-frontmatter';
+import { gfmAutolinkLiteral } from 'micromark-extension-gfm-autolink-literal';
+import { gfmFootnote } from 'micromark-extension-gfm-footnote';
+import { gfmTable } from 'micromark-extension-gfm-table';
+import { math } from 'micromark-extension-math';
+import { structureMarkdocTags } from './markdoc/structure.js';
+import { markdocSyntax } from './markdoc/syntax.js';
+const frontmatterExtension = frontmatter(['yaml']);
+const baseExtensions = [
+    directive(),
+    gfmAutolinkLiteral(),
+    gfmFootnote(),
+    gfmTable(),
+    math(),
+    frontmatterExtension,
+];
+// Used to parse block HTML again as inline content, which gives `htmlText` tokens
+// for the tags inside it. markdownlint does the same. See `reparseHtmlFlow`.
+const htmlFlowReparseExtension = { disable: { null: ['codeIndented', 'htmlFlow'] } };
+function getEvents(content, extensions) {
+    const parseContext = parse({ extensions });
+    const chunks = preprocess()(content, undefined, true);
+    return postprocess(parseContext.document().write(chunks));
+}
+/**
+ * Builds a token tree from micromark events. `lineOffset` and `firstLineColumnOffset`
+ * move positions in `content` to where it sits in the whole document.
+ */
+function buildTree(events, content, lineOffset = 0, firstLineColumnOffset = 0) {
+    const children = [];
+    const flat = [];
+    const stack = [];
+    const adjustLine = (line) => line + lineOffset;
+    const adjustColumn = (line, column) => line === 1 ? column + firstLineColumnOffset : column;
+    for (const event of events) {
+        const [kind, mmToken] = event;
+        if (kind === 'enter') {
+            const parent = stack[stack.length - 1] ?? null;
+            const token = {
+                type: mmToken.type,
+                startLine: adjustLine(mmToken.start.line),
+                startColumn: adjustColumn(mmToken.start.line, mmToken.start.column),
+                endLine: adjustLine(mmToken.end.line),
+                endColumn: adjustColumn(mmToken.end.line, mmToken.end.column),
+                text: '',
+                children: [],
+                parent,
+            };
+            (parent ? parent.children : children).push(token);
+            flat.push(token);
+            stack.push(token);
+        }
+        else {
+            const token = stack.pop();
+            if (token) {
+                // Slice `content` directly. `context.sliceSerialize` can crash on nested
+                // content such as lists inside list items.
+                token.text = content.slice(mmToken.start.offset, mmToken.end.offset);
+                token.endLine = adjustLine(mmToken.end.line);
+                token.endColumn = adjustColumn(mmToken.end.line, mmToken.end.column);
+            }
+        }
+    }
+    return { children, flat };
+}
+// Whether the token is a valid CommonMark HTML comment. Copied from rules/token/helpers.ts,
+// because the parser must not import from rules.
+function isHtmlFlowComment(token) {
+    const { text, type } = token;
+    if (type === 'htmlFlow' && text.startsWith('<!--') && text.endsWith('-->')) {
+        const comment = text.slice(4, -3);
+        return !comment.startsWith('>') && !comment.startsWith('->') && !comment.endsWith('-');
+    }
+    return false;
+}
+/**
+ * Parses the text of each block HTML (`htmlFlow`) token again as inline content, so
+ * rules that look for `htmlText` tokens also see tags inside HTML blocks. The new
+ * tokens become children of the original token and are added to `tree.flat`.
+ */
+function reparseHtmlFlow(tree) {
+    const htmlFlowTokens = tree.flat.filter((token) => token.type === 'htmlFlow' && !isHtmlFlowComment(token));
+    for (const token of htmlFlowTokens) {
+        const events = getEvents(token.text, [...baseExtensions, htmlFlowReparseExtension]);
+        const reparsed = buildTree(events, token.text, token.startLine - 1, token.startColumn - 1);
+        // Mark the new tokens `inHtmlFlow` so `filterByTypes` skips them by default.
+        for (const descendant of reparsed.flat)
+            descendant.inHtmlFlow = true;
+        for (const child of reparsed.children)
+            child.parent = token;
+        token.children = reparsed.children;
+        // Push one by one. Spreading a huge array into `push` overflows the call stack.
+        for (const descendant of reparsed.flat)
+            tree.flat.push(descendant);
+    }
+}
+export function parseMarkdown(content, options = {}) {
+    const blockExtensions = options.embedded
+        ? baseExtensions.filter((extension) => extension !== frontmatterExtension)
+        : baseExtensions;
+    const extensions = options.markdoc
+        ? [...blockExtensions, markdocSyntax(content)]
+        : blockExtensions;
+    const events = getEvents(content, extensions);
+    const tree = buildTree(events, content);
+    reparseHtmlFlow(tree);
+    if (options.markdoc)
+        structureMarkdocTags(tree);
+    return tree;
+}
+/**
+ * Returns the tokens of the given types. Tokens from inside block HTML (see
+ * `reparseHtmlFlow`) are left out unless `includeHtmlFlow` is true.
+ */
+export function filterByTypes(tree, types, includeHtmlFlow = false) {
+    return tree.flat.filter((token) => types.includes(token.type) && (includeHtmlFlow || !token.inHtmlFlow));
+}
+//# sourceMappingURL=index.js.map

package/lib/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,gFAAgF;AAChF,mEAAmE;AACnE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAC9E,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AACzD,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAGhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAKpD,MAAM,oBAAoB,GAAG,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;AACnD,MAAM,cAAc,GAAG;IACrB,SAAS,EAAE;IACX,kBAAkB,EAAE;IACpB,WAAW,EAAE;IACb,QAAQ,EAAE;IACV,IAAI,EAAE;IACN,oBAAoB;CACrB,CAAC;AAEF,kFAAkF;AAClF,6EAA6E;AAC7E,MAAM,wBAAwB,GAAc,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,cAAc,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC;AAEhG,SAAS,SAAS,CAAC,OAAe,EAAE,UAAuB;IACzD,MAAM,YAAY,GAAG,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACtD,OAAO,WAAW,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAChB,MAAe,EACf,OAAe,EACf,UAAU,GAAG,CAAC,EACd,qBAAqB,GAAG,CAAC;IAEzB,MAAM,QAAQ,GAAY,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAY,EAAE,CAAC;IACzB,MAAM,KAAK,GAAY,EAAE,CAAC;IAC1B,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,GAAG,UAAU,CAAC;IACvD,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,MAAc,EAAE,EAAE,CACpD,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,qBAAqB,CAAC,CAAC,CAAC,MAAM,CAAC;IACvD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;QAC9B,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC;YAC/C,MAAM,KAAK,GAAU;gBACnB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;gBACzC,WAAW,EAAE,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;gBACnE,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;gBACrC,SAAS,EAAE,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC;gBAC7D,IAAI,EAAE,EAAE;gBACR,QAAQ,EAAE,EAAE;gBACZ,MAAM;aACP,CAAC;YACF,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;YAC1B,IAAI,KAAK,EAAE,CAAC;gBACV,yEAAyE;gBACzE,2CAA2C;gBAC3C,KAAK,CAAC,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACrE,KAAK,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC7C,KAAK,CAAC,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,4FAA4F;AAC5F,iDAAiD;AACjD,SAAS,iBAAiB,CAAC,KAAY;IACrC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAC7B,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3E,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,IAAe;IACtC,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CACrC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAClE,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,cAAc,EAAE,wBAAwB,CAAC,CAAC,CAAC;QACpF,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,EAAE,KAAK,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;QAC3F,6EAA6E;QAC7E,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,IAAI;YAAE,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC;QACrE,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,QAAQ;YAAE,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;QAC5D,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC;QACnC,gFAAgF;QAChF,KAAK,MAAM,UAAU,IAAI,QAAQ,CAAC,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrE,CAAC;AACH,CAAC;AAUD,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,UAAwB,EAAE;IACvE,MAAM,eAAe,GAAG,OAAO,CAAC,QAAQ;QACtC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,KAAK,oBAAoB,CAAC;QAC1E,CAAC,CAAC,cAAc,CAAC;IACnB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO;QAChC,CAAC,CAAC,CAAC,GAAG,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC,CAAC,eAAe,CAAC;IACpB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,OAAO,CAAC,OAAO;QAAE,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAe,EACf,KAAwB,EACxB,eAAe,GAAG,KAAK;IAEvB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CACrB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAChF,CAAC;AACJ,CAAC"}

package/lib/parser/markdoc/extract-statics.d.ts

@@ -0,0 +1,28 @@
+import type { MarkdocAttributeSchema, MarkdocSchema } from './schema.js';
+/** Enough of a real Markdoc `Config['tags'][name]['attributes'][name]` entry to extract statics from. */
+export interface RawMarkdocAttribute {
+    type?: unknown;
+    required?: boolean;
+    default?: unknown;
+    matches?: unknown;
+}
+/** Enough of a real Markdoc `Config['tags'][name]` entry to extract statics from. */
+export interface RawMarkdocTag {
+    selfClosing?: boolean;
+    attributes?: Record<string, RawMarkdocAttribute>;
+    validate?: unknown;
+}
+export type RawMarkdocTagMap = Record<string, RawMarkdocTag>;
+/**
+ * Converts one raw Markdoc attribute into a `MarkdocAttributeSchema`.
+ *
+ * If the tag has a `validate()` function (`tagHasValidate`), every attribute is marked
+ * `dynamic`, because that function could reject any of them.
+ */
+export declare function extractAttribute(rawAttribute: RawMarkdocAttribute, tagHasValidate: boolean): MarkdocAttributeSchema;
+/**
+ * Merges three raw tag maps and converts them to a `MarkdocSchema`. Theme tags win
+ * over portal tags, which win over Markdoc's built-in tags.
+ */
+export declare function extractStatics(themeTagMap: RawMarkdocTagMap, markdocBuiltinTags: RawMarkdocTagMap, portalBuiltInTagMap: RawMarkdocTagMap): MarkdocSchema;
+//# sourceMappingURL=extract-statics.d.ts.map

package/lib/parser/markdoc/extract-statics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-statics.d.ts","sourceRoot":"","sources":["../../../src/parser/markdoc/extract-statics.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,sBAAsB,EAAoB,aAAa,EAAE,MAAM,aAAa,CAAC;AAE3F,yGAAyG;AACzG,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAU7D;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,mBAAmB,EACjC,cAAc,EAAE,OAAO,GACtB,sBAAsB,CA8BxB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,gBAAgB,EAC7B,kBAAkB,EAAE,gBAAgB,EACpC,mBAAmB,EAAE,gBAAgB,GACpC,aAAa,CA+Bf"}

package/lib/parser/markdoc/extract-statics.js

@@ -0,0 +1,80 @@
+// Turns a real Markdoc tag map into recheck's `MarkdocSchema`, keeping only what can
+// be checked statically. Used by the generator for the built-in `realm` schema (in the
+// Redocly monorepo) and by `src/actions/markdoc-schema.ts`.
+//
+// The raw types below are loose on purpose, so this file does not import
+// `@markdoc/markdoc`, which is only a dev dependency.
+// The attribute types recheck can represent. Any other type (`Object`, `Array`, a union,
+// a custom class, or no type) is marked `dynamic: true`.
+const PRIMITIVE_TYPE_NAMES = new Map([
+    [String, 'string'],
+    [Number, 'number'],
+    [Boolean, 'boolean'],
+]);
+/**
+ * Converts one raw Markdoc attribute into a `MarkdocAttributeSchema`.
+ *
+ * If the tag has a `validate()` function (`tagHasValidate`), every attribute is marked
+ * `dynamic`, because that function could reject any of them.
+ */
+export function extractAttribute(rawAttribute, tagHasValidate) {
+    const rawType = rawAttribute.type;
+    const primitiveName = typeof rawType === 'function' ? PRIMITIVE_TYPE_NAMES.get(rawType) : undefined;
+    // `type` is required, so use 'string' for anything that is not a primitive.
+    // That is fine because dynamic attributes are never checked by type.
+    const out = { type: primitiveName ?? 'string' };
+    if (rawAttribute.required === true)
+        out.required = true;
+    // `default` can only be a string, number or boolean, so other defaults (like an array)
+    // are dropped. Those attributes are already `dynamic`.
+    const defaultType = typeof rawAttribute.default;
+    if (defaultType === 'string' || defaultType === 'number' || defaultType === 'boolean') {
+        out.default = rawAttribute.default;
+    }
+    // `matches` can also be a RegExp or a function. Those become `dynamic`.
+    // Array entries that are not strings are converted with `String(...)`, since the
+    // enum check compares text.
+    if (rawAttribute.matches !== undefined) {
+        if (Array.isArray(rawAttribute.matches)) {
+            if (rawAttribute.matches.length > 0) {
+                out.enum = rawAttribute.matches.map((value) => String(value));
+            }
+        }
+        else {
+            out.dynamic = true;
+        }
+    }
+    if (primitiveName === undefined || tagHasValidate)
+        out.dynamic = true;
+    return out;
+}
+/**
+ * Merges three raw tag maps and converts them to a `MarkdocSchema`. Theme tags win
+ * over portal tags, which win over Markdoc's built-in tags.
+ */
+export function extractStatics(themeTagMap, markdocBuiltinTags, portalBuiltInTagMap) {
+    const composed = { ...markdocBuiltinTags, ...portalBuiltInTagMap, ...themeTagMap };
+    const tagNames = Object.keys(composed).sort();
+    const tags = {};
+    for (const tagName of tagNames) {
+        const rawSchema = composed[tagName];
+        const tagHasValidate = typeof rawSchema.validate === 'function';
+        const tagOut = {};
+        if (rawSchema.selfClosing === true)
+            tagOut.selfClosing = true;
+        const rawAttributes = rawSchema.attributes;
+        if (rawAttributes) {
+            const attributeNames = Object.keys(rawAttributes).sort();
+            if (attributeNames.length > 0) {
+                const attributesOut = {};
+                for (const attributeName of attributeNames) {
+                    attributesOut[attributeName] = extractAttribute(rawAttributes[attributeName], tagHasValidate);
+                }
+                tagOut.attributes = attributesOut;
+            }
+        }
+        tags[tagName] = tagOut;
+    }
+    return { tags };
+}
+//# sourceMappingURL=extract-statics.js.map

package/lib/parser/markdoc/extract-statics.js.map

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

package/lib/parser/markdoc/pairing.d.ts

@@ -0,0 +1,38 @@
+import type { Token, TokenTree } from '../types.js';
+export interface MarkdocPair {
+    open: Token;
+    close: Token;
+    /** How many tags were open around `open` when it appeared: 0 for a top-level tag. */
+    depth: number;
+}
+/** Each tag is in at most one of these lists. */
+export interface MarkdocPairing {
+    /** Matched pairs that do not cross another pair. */
+    pairs: MarkdocPair[];
+    /** Open tags with no close tag before the end of the file. */
+    unclosed: Token[];
+    /** Close tags with no matching open tag. */
+    orphaned: Token[];
+    /** Matched pairs that cross another pair, like `{% a %}{% b %}{% /a %}{% /b %}`. */
+    crossed: MarkdocPair[];
+    /** Self-closing tags (according to the schema) that were written without `/%}`. */
+    voidMissingSlash: Token[];
+}
+/**
+ * An empty result, for when no rule needs the pairing. A function so files don't share the arrays.
+ */
+export declare function emptyMarkdocPairing(): MarkdocPairing;
+export interface PairingOptions {
+    /** Names of tags that never have a close tag. */
+    selfClosingTags?: ReadonlySet<string>;
+}
+/**
+ * Pairs the `markdocTag` tokens of a document. Tags are sorted by position first,
+ * because `tree.flat` is not in document order.
+ *
+ * This differs from Markdoc, which only checks a close tag against the most recent
+ * open tag. For `{% a %}{% b %}{% /a %}{% /b %}` Markdoc reports a missing close and
+ * a missing open, while this reports two crossed pairs.
+ */
+export declare function computeMarkdocPairing(tree: TokenTree, options?: PairingOptions): MarkdocPairing;
+//# sourceMappingURL=pairing.d.ts.map

package/lib/parser/markdoc/pairing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pairing.d.ts","sourceRoot":"","sources":["../../../src/parser/markdoc/pairing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAGpD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,KAAK,CAAC;IACb,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,8DAA8D;IAC9D,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,4CAA4C;IAC5C,QAAQ,EAAE,KAAK,EAAE,CAAC;IAClB,oFAAoF;IACpF,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,mFAAmF;IACnF,gBAAgB,EAAE,KAAK,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,cAAc,CAEpD;AAED,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,eAAe,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACvC;AA0BD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,SAAS,EACf,OAAO,GAAE,cAAmB,GAC3B,cAAc,CAsDhB"}

package/lib/parser/markdoc/pairing.js

@@ -0,0 +1,77 @@
+/**
+ * An empty result, for when no rule needs the pairing. A function so files don't share the arrays.
+ */
+export function emptyMarkdocPairing() {
+    return { pairs: [], unclosed: [], orphaned: [], crossed: [], voidMissingSlash: [] };
+}
+// Kinds that are never paired: they have no tag name, are already complete, or are
+// malformed (reported elsewhere).
+const NEVER_PAIRED_KINDS = new Set([
+    'annotation',
+    'variable',
+    'function',
+    'tag-self-closing',
+    'malformed',
+]);
+/** The tag's name, or null if it has none. */
+function tagName(token) {
+    const nameChild = token.children.find((child) => child.type === 'markdocTagName');
+    return nameChild ? nameChild.text : null;
+}
+/**
+ * Pairs the `markdocTag` tokens of a document. Tags are sorted by position first,
+ * because `tree.flat` is not in document order.
+ *
+ * This differs from Markdoc, which only checks a close tag against the most recent
+ * open tag. For `{% a %}{% b %}{% /a %}{% /b %}` Markdoc reports a missing close and
+ * a missing open, while this reports two crossed pairs.
+ */
+export function computeMarkdocPairing(tree, options = {}) {
+    const selfClosingTags = options.selfClosingTags ?? new Set();
+    const tags = tree.flat
+        .filter((token) => token.type === 'markdocTag')
+        .sort((a, b) => a.startLine - b.startLine || a.startColumn - b.startColumn);
+    const stack = [];
+    const pairs = [];
+    const crossed = [];
+    const orphaned = [];
+    for (const token of tags) {
+        const kind = token.markdocKind;
+        if (kind === undefined || NEVER_PAIRED_KINDS.has(kind))
+            continue;
+        const name = tagName(token);
+        if (name === null)
+            continue;
+        if (kind === 'tag-open') {
+            stack.push({ token, name, depth: stack.length, crossed: false });
+            continue;
+        }
+        // A close tag: find the nearest open tag with the same name.
+        let matchIndex = -1;
+        for (let i = stack.length - 1; i >= 0; i--) {
+            if (stack[i].name === name) {
+                matchIndex = i;
+                break;
+            }
+        }
+        if (matchIndex === -1) {
+            orphaned.push(token);
+            continue;
+        }
+        const jumpedOver = matchIndex !== stack.length - 1;
+        if (jumpedOver) {
+            for (let i = matchIndex + 1; i < stack.length; i++)
+                stack[i].crossed = true;
+        }
+        const [matched] = stack.splice(matchIndex, 1);
+        const pair = { open: matched.token, close: token, depth: matched.depth };
+        (jumpedOver || matched.crossed ? crossed : pairs).push(pair);
+    }
+    const unclosed = [];
+    const voidMissingSlash = [];
+    for (const entry of stack) {
+        (selfClosingTags.has(entry.name) ? voidMissingSlash : unclosed).push(entry.token);
+    }
+    return { pairs, unclosed, orphaned, crossed, voidMissingSlash };
+}
+//# sourceMappingURL=pairing.js.map

package/lib/parser/markdoc/pairing.js.map

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

package/lib/parser/markdoc/schema.d.ts

@@ -0,0 +1,56 @@
+/** What recheck can check statically about one attribute. */
+export interface MarkdocAttributeSchema {
+    type: 'string' | 'number' | 'boolean';
+    required?: boolean;
+    default?: string | number | boolean;
+    /** Markdoc's `matches` array. */
+    enum?: readonly string[];
+    /**
+     * Set when the attribute's type is not a string, number or boolean, or when the
+     * tag has a `validate()` function. The type and enum checks skip these attributes.
+     * The `required` and unknown-attribute checks still apply.
+     */
+    dynamic?: boolean;
+}
+export interface MarkdocTagSchema {
+    selfClosing?: boolean;
+    attributes?: Record<string, MarkdocAttributeSchema>;
+}
+export interface MarkdocSchema {
+    tags: Record<string, MarkdocTagSchema>;
+}
+/**
+ * The object form of the `markdoc` config key. `schema` is required; `true` means `{ schema:
+ * 'realm' }`.
+ */
+export interface MarkdocUserConfig {
+    schema: 'realm' | false;
+    extend?: {
+        tags?: Record<string, MarkdocTagSchema>;
+        tagsFile?: string;
+    };
+}
+/**
+ * `extend` after `tagsFile` has been read: `fileTags` come from the file, `tags` are the inline
+ * ones.
+ */
+export interface ResolvedExtend {
+    fileTags?: Record<string, MarkdocTagSchema>;
+    tags?: Record<string, MarkdocTagSchema>;
+}
+/**
+ * Turns the raw `markdoc` config value into `{ enabled, schema }`. It does not
+ * throw on an invalid value; it returns disabled instead.
+ *
+ * `schema: false` still parses and pairs tags. Only the rules that need a schema
+ * (unknown tag and attribute checks) have nothing to check. `extend` is ignored then.
+ *
+ * `resolvedExtend`, when given, is used instead of `raw.extend`.
+ */
+export declare function resolveMarkdocConfig(raw: boolean | MarkdocUserConfig | undefined, resolvedExtend?: ResolvedExtend): {
+    enabled: boolean;
+    schema: MarkdocSchema | null;
+};
+/** Names of the tags that the schema marks as self-closing. */
+export declare function selfClosingTagNames(schema: MarkdocSchema): ReadonlySet<string>;
+//# sourceMappingURL=schema.d.ts.map

package/lib/parser/markdoc/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/parser/markdoc/schema.ts"],"names":[],"mappings":"AAOA,6DAA6D;AAC7D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,iCAAiC;IACjC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACxC;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,OAAO,GAAG,KAAK,CAAC;IAGxB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzE;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;CACzC;AAgBD;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,OAAO,GAAG,iBAAiB,GAAG,SAAS,EAC5C,cAAc,CAAC,EAAE,cAAc,GAC9B;IACD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CAC9B,CAmBA;AAED,+DAA+D;AAC/D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC,CAM9E"}

package/lib/parser/markdoc/schema.js

@@ -0,0 +1,60 @@
+// Recheck's own Markdoc schema format. It is plain data that can be written in
+// YAML, unlike Markdoc's `Config['tags']`, which can hold classes and functions.
+// This file has the types and the code that turns the `markdoc` config value into
+// `{ enabled, schema }`.
+import { MARKDOC_REALM_SCHEMA } from '../../data/markdoc-realm-schema.js';
+import { isPlainObject } from '../../utils/is-plain-object.js';
+/**
+ * Adds the user's tags to the base schema. Inline tags win over `tagsFile` tags,
+ * which win over built-in tags. A tag with the same name replaces the whole tag,
+ * like Markdoc's own `mergeConfig`.
+ */
+function mergeExtend(base, extend) {
+    if (!extend)
+        return base;
+    const { fileTags, tags } = extend;
+    const hasFileTags = fileTags && Object.keys(fileTags).length > 0;
+    const hasTags = tags && Object.keys(tags).length > 0;
+    if (!hasFileTags && !hasTags)
+        return base;
+    return { tags: { ...base.tags, ...fileTags, ...tags } };
+}
+/**
+ * Turns the raw `markdoc` config value into `{ enabled, schema }`. It does not
+ * throw on an invalid value; it returns disabled instead.
+ *
+ * `schema: false` still parses and pairs tags. Only the rules that need a schema
+ * (unknown tag and attribute checks) have nothing to check. `extend` is ignored then.
+ *
+ * `resolvedExtend`, when given, is used instead of `raw.extend`.
+ */
+export function resolveMarkdocConfig(raw, resolvedExtend) {
+    if (raw === true) {
+        return { enabled: true, schema: MARKDOC_REALM_SCHEMA };
+    }
+    if (isPlainObject(raw)) {
+        if (raw.schema === false) {
+            return { enabled: true, schema: null };
+        }
+        if (raw.schema === 'realm') {
+            return {
+                enabled: true,
+                schema: mergeExtend(MARKDOC_REALM_SCHEMA, resolvedExtend ?? raw.extend),
+            };
+        }
+        // Invalid object, such as `schema: 'bogus'`. Config validation reports it.
+        return { enabled: false, schema: null };
+    }
+    // `undefined`, `false` or any other invalid value.
+    return { enabled: false, schema: null };
+}
+/** Names of the tags that the schema marks as self-closing. */
+export function selfClosingTagNames(schema) {
+    const names = new Set();
+    for (const [name, tag] of Object.entries(schema.tags)) {
+        if (tag.selfClosing)
+            names.add(name);
+    }
+    return names;
+}
+//# sourceMappingURL=schema.js.map

package/lib/parser/markdoc/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/parser/markdoc/schema.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iFAAiF;AACjF,kFAAkF;AAClF,yBAAyB;AACzB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AA8C/D;;;;GAIG;AACH,SAAS,WAAW,CAAC,IAAmB,EAAE,MAAkC;IAC1E,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC;IAClC,MAAM,WAAW,GAAG,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACrD,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC;AAC1D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAClC,GAA4C,EAC5C,cAA+B;IAK/B,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,aAAa,CAAoB,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,GAAG,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YACzB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC3B,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,WAAW,CAAC,oBAAoB,EAAE,cAAc,IAAI,GAAG,CAAC,MAAM,CAAC;aACxE,CAAC;QACJ,CAAC;QACD,2EAA2E;QAC3E,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1C,CAAC;IACD,mDAAmD;IACnD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QACtD,IAAI,GAAG,CAAC,WAAW;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/lib/parser/markdoc/span.d.ts

@@ -0,0 +1,52 @@
+export type MarkdocTagKind = 'tag-open' | 'tag-close' | 'tag-self-closing' | 'annotation' | 'variable' | 'function';
+export type MarkdocValueKind = 'string' | 'number' | 'boolean' | 'null' | 'array' | 'object' | 'variable' | 'function' | 'bareword';
+export interface MarkdocAttribute {
+    name: string;
+    valueKind: MarkdocValueKind;
+    /** Literal value for string/number/boolean/null; raw source text otherwise. */
+    value: string | number | boolean | null;
+    /** 0-based offsets into the SPAN text, for child-token synthesis. */
+    nameStart: number;
+    nameEnd: number;
+    valueStart: number;
+    valueEnd: number;
+}
+/**
+ * A class (`.foo`) or id (`#bar`) shortcut in a named tag. Markdoc turns these into
+ * `class` and `id` attributes. Here they are kept separate because they have no
+ * `name=value` text.
+ */
+export interface MarkdocShortcut {
+    kind: 'class' | 'id';
+    name: string;
+    start: number;
+    end: number;
+}
+export interface ParsedMarkdocSpan {
+    kind: MarkdocTagKind | 'malformed';
+    name: string | null;
+    attributes: MarkdocAttribute[];
+    nameStart: number;
+    nameEnd: number;
+    /**
+     * The value right after the tag name, as in `{% if $flag %}`. Markdoc assigns it to the attribute
+     * named `primary`.
+     */
+    primary?: {
+        valueKind: MarkdocValueKind;
+        value: string | number | boolean | null;
+        valueStart: number;
+        valueEnd: number;
+    };
+    /** Class and id shortcuts of a named tag, in source order. Missing when there are none. */
+    shortcuts?: MarkdocShortcut[];
+    reason?: string;
+    /** For malformed spans: the offset of the character where parsing failed, if there is one. */
+    reasonOffset?: number;
+}
+/**
+ * Parses the text of one `{% ... %}` span. Offsets in the result are 0-based
+ * indexes into `spanText`. Never throws; invalid text gives `kind: 'malformed'`.
+ */
+export declare function parseMarkdocSpan(spanText: string): ParsedMarkdocSpan;
+//# sourceMappingURL=span.d.ts.map

package/lib/parser/markdoc/span.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"span.d.ts","sourceRoot":"","sources":["../../../src/parser/markdoc/span.ts"],"names":[],"mappings":"AAoCA,MAAM,MAAM,cAAc,GACtB,UAAU,GACV,WAAW,GACX,kBAAkB,GAClB,YAAY,GACZ,UAAU,GACV,UAAU,CAAC;AACf,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,MAAM,GACN,OAAO,GACP,QAAQ,GACR,UAAU,GACV,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,gBAAgB,CAAC;IAC5B,+EAA+E;IAC/E,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACxC,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,GAAG,WAAW,CAAC;IACnC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,UAAU,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE;QACR,SAAS,EAAE,gBAAgB,CAAC;QAC5B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;QACxC,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,2FAA2F;IAC3F,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8FAA8F;IAC9F,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAoZD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAkLpE"}