@mintlify/cli 4.0.1812 → 4.1.1

package/bin/validate/mdx.js

@@ -1,238 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import { coreRemark, FRONTMATTER_RE, getCodeRanges, HEADING_ID_RE, JSXParser, pagePathToSlug, replaceSlashIndex, safeCleanHeadingId, toPosixPath, } from '@mintlify/common';
-import { decorateGraphNodeFromPageContent, Node, PathType } from '@mintlify/link-rot';
-const HEADING_ID = new RegExp(HEADING_ID_RE.source, 'gm');
-const ESM_START = /^(?:import|export)(?=[\s{*])/;
-const JSX_TAG = /<[A-Za-z][\w.:-]*(?:"[^"]*"|'[^']*'|\{[^{}]*\}|[^<>"'{}])*>/g;
-const ATTR_VALUE = /"[^"]*"|'[^']*'|\{[^{}]*\}/g;
-export const hasCustomHeadingId = (line) => /\{\s*#[^}]+?\s*\}\s*$/.test(line);
-export const parseContent = (content) => {
-    const padded = content.replace(HEADING_ID, (match, indent, hashes, text) => {
-        const end = match.indexOf(text, indent.length + hashes.length) + text.length;
-        return match.slice(0, end).padEnd(match.length, ' ');
-    });
-    return coreRemark().parse(padded);
-};
-const blankRanges = (content, ranges) => {
-    let result = '';
-    let cursor = 0;
-    for (const [from, to] of [...ranges].sort((a, b) => a[0] - b[0])) {
-        const start = Math.max(from, cursor);
-        if (to <= start)
-            continue;
-        result += content.slice(cursor, start) + content.slice(start, to).replace(/[^\n]/g, ' ');
-        cursor = to;
-    }
-    return result + content.slice(cursor);
-};
-const maskWith = (content, maskers) => maskers.reduce((text, ranges) => blankRanges(text, ranges(text)), content);
-const isCompleteEsm = (text) => {
-    try {
-        JSXParser.parse(text, { ecmaVersion: 'latest', sourceType: 'module' });
-        return true;
-    }
-    catch (error) {
-        const pos = error.pos;
-        return typeof pos !== 'number' || pos < text.trimEnd().length;
-    }
-};
-const frontmatterRanges = (content) => {
-    const match = FRONTMATTER_RE.exec(content);
-    return match ? [[match.index, match.index + match[0].length]] : [];
-};
-const esmRanges = (content, codeRanges) => {
-    let esm;
-    let previousBlank = true;
-    const ranges = [];
-    let offset = 0;
-    for (const line of content.split('\n')) {
-        const isBlank = line.trim() === '';
-        const wasBlank = previousBlank;
-        previousBlank = isBlank;
-        if (esm) {
-            if (isBlank && isCompleteEsm(esm.join('\n')))
-                esm = undefined;
-            else {
-                esm.push(line);
-                ranges.push([offset, offset + line.length]);
-            }
-        }
-        else if (wasBlank &&
-            ESM_START.test(line) &&
-            !codeRanges.some(([start, end]) => start <= offset && offset < end)) {
-            esm = [line];
-            ranges.push([offset, offset + line.length]);
-        }
-        offset += line.length + 1;
-    }
-    return ranges;
-};
-export const maskFrontmatter = (content) => blankRanges(content, frontmatterRanges(content));
-export const maskCode = (content, { keepEsm = false } = {}) => {
-    const codeRanges = getCodeRanges(content);
-    return blankRanges(content, [
-        ...frontmatterRanges(content),
-        ...codeRanges,
-        ...(keepEsm ? [] : esmRanges(content, codeRanges)),
-    ]);
-};
-const OPENS = new Set(['{', '${']);
-const maskExpression = (content, start) => {
-    const ranges = [];
-    let depth = 0;
-    try {
-        const tokens = JSXParser.tokenizer(content.slice(start), {
-            ecmaVersion: 'latest',
-            onComment: (block, _text, from, to) => ranges.push([start + from + 2, start + to - (block ? 2 : 0)]),
-        });
-        for (const token of tokens) {
-            const label = token.type.label;
-            if (label === 'template')
-                ranges.push([start + token.start, start + token.end]);
-            else if (label === 'string')
-                ranges.push([start + token.start + 1, start + token.end - 1]);
-            else if (label === 'regexp') {
-                const raw = content.slice(start + token.start, start + token.end);
-                ranges.push([start + token.start + 1, start + token.start + raw.lastIndexOf('/')]);
-            }
-            else if (OPENS.has(label))
-                depth++;
-            else if (label === '}' && depth-- === 0)
-                return { ranges, end: start + token.end };
-        }
-    }
-    catch (error) {
-        if (!(error instanceof SyntaxError && 'pos' in error && typeof error.pos === 'number')) {
-            return { ranges, end: content.length };
-        }
-        const pos = start + error.pos;
-        if (!error.message.startsWith('Unterminated string'))
-            return { ranges, end: pos };
-        const lineEnd = content.indexOf('\n', pos);
-        ranges.push([pos + 1, lineEnd === -1 ? content.length : lineEnd]);
-    }
-    return { ranges, end: content.length };
-};
-const expressionRanges = (content) => {
-    const ranges = [];
-    for (let index = 0; index < content.length; index++) {
-        const char = content[index];
-        if (char === '\\')
-            index++;
-        else if (char === '{') {
-            const expression = maskExpression(content, index + 1);
-            ranges.push(...expression.ranges);
-            index = expression.end - 1;
-        }
-    }
-    return ranges;
-};
-const attributeRanges = (content) => [...content.matchAll(JSX_TAG)].flatMap(({ index, 0: tag }) => [...tag.matchAll(ATTR_VALUE)].map(({ index: at, 0: value }) => [index + at + 1, index + at + value.length - 1]));
-const escapedTagRanges = (content) => [...content.matchAll(/\\[\s\S]/g)].flatMap(({ index, 0: escape }) => escape === '\\<' ? [[index + 1, index + 2]] : []);
-export const maskNonMarkup = (content) => maskWith(maskCode(content), [attributeRanges, escapedTagRanges, expressionRanges]);
-export const selectEdits = (edits) => {
-    const ordered = edits
-        .map((edit, index) => ({ edit, index }))
-        .sort((a, b) => b.edit.start - a.edit.start || b.edit.end - a.edit.end || b.index - a.index);
-    const selected = [];
-    let floor = Infinity;
-    for (const { edit } of ordered) {
-        if (edit.end > floor)
-            continue;
-        selected.push(edit);
-        floor = edit.start;
-    }
-    return selected;
-};
-export const applyEdits = (content, edits) => selectEdits(edits).reduce((result, edit) => result.slice(0, edit.start) + edit.text + result.slice(edit.end), content);
-export const toOffset = (content, line, column = 1) => {
-    let offset = 0;
-    for (let current = 1; current < line; current++) {
-        const next = content.indexOf('\n', offset);
-        if (next === -1)
-            break;
-        offset = next + 1;
-    }
-    return offset + column - 1;
-};
-export const toPosition = (content, offset) => {
-    var _a, _b;
-    const before = content.slice(0, offset).split('\n');
-    return { line: before.length, column: ((_b = (_a = before.pop()) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) + 1 };
-};
-const byStart = (a, b) => a.start - b.start;
-function toOriginal(edits, offset, inside) {
-    let delta = 0;
-    for (const edit of edits) {
-        const start = edit.start + delta;
-        if (inside === 'snap' ? offset < start : offset <= start)
-            break;
-        if (offset < start + edit.text.length)
-            return inside === 'snap' ? edit.start : undefined;
-        delta += edit.text.length - (edit.end - edit.start);
-    }
-    return offset - delta;
-}
-/** Maps an edit made against a later stage back to the original content, or undefined when it touches an earlier fix. */
-export const unmapEdit = (stages, index, edit) => {
-    let { start, end } = edit;
-    for (const { edits } of stages.slice(0, index).reverse()) {
-        const sorted = [...edits].sort(byStart);
-        const mappedStart = toOriginal(sorted, start, 'reject');
-        const mappedEnd = toOriginal(sorted, end, 'reject');
-        if (mappedStart === undefined || mappedEnd === undefined)
-            return undefined;
-        if (sorted.some((earlier) => earlier.start < mappedEnd && earlier.end > mappedStart)) {
-            return undefined;
-        }
-        start = mappedStart;
-        end = mappedEnd;
-    }
-    return { start, end, text: edit.text };
-};
-export const relocate = (stages, index, position) => {
-    const stage = stages[index];
-    const original = stages[0];
-    if (!stage || !original || position.line === undefined)
-        return {};
-    const offset = stages
-        .slice(0, index)
-        .reduceRight((current, { edits }) => toOriginal([...edits].sort(byStart), current, 'snap'), toOffset(stage.content, position.line, position.column));
-    const mapped = toPosition(original.content, offset);
-    return position.column === undefined ? { line: mapped.line } : mapped;
-};
-const pagePath = (file) => replaceSlashIndex(pagePathToSlug(file)).replace(/^\.$/, '');
-export const collectAnchorLinks = (file, content) => __awaiter(void 0, void 0, void 0, function* () {
-    const node = new Node(file);
-    try {
-        yield decorateGraphNodeFromPageContent(node, content);
-    }
-    catch (_a) {
-        return [];
-    }
-    return node.paths.flatMap((link) => link.pathType === PathType.INTERNAL && link.anchorLink
-        ? [
-            `${pagePath(toPosixPath(link.toString()))}#${safeCleanHeadingId(link.anchorLink.slice(1))}`,
-        ]
-        : []);
-});
-export const linkedAnchor = (links, file, slug) => {
-    const prefix = `${pagePath(file)}#`;
-    for (const link of links !== null && links !== void 0 ? links : []) {
-        if (!link.startsWith(prefix))
-            continue;
-        const anchor = link.slice(prefix.length);
-        const suffix = anchor.startsWith(`${slug}-`) && /^\d/.test(anchor.slice(slug.length + 1));
-        if (anchor === slug || suffix)
-            return anchor;
-    }
-    return undefined;
-};

package/bin/validate/output.js

@@ -1,44 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { addLog, ErrorLog, InfoLog, SuccessLog } from '@mintlify/previewing';
-import { Box, Text } from 'ink';
-const preview = (value) => {
-    const text = JSON.stringify(value);
-    return text.length > 60 ? `${text.slice(0, 57)}..."` : text;
-};
-const location = ({ line, column }) => line ? `${line}${column ? `:${column}` : ''}` : '';
-const DiagnosticLine = ({ diagnostic }) => {
-    const at = location(diagnostic);
-    return (_jsxs(Text, { children: ['  ', diagnostic.severity === 'error' ? (_jsx(Text, { color: "red", children: "\u2717" })) : (_jsx(Text, { color: "yellow", children: "!" })), ' ', at && _jsxs(Text, { dimColor: true, children: [at, " "] }), _jsx(Text, { dimColor: true, children: diagnostic.rule }), " ", diagnostic.message, diagnostic.fix && _jsx(Text, { dimColor: true, children: " (fixable)" })] }));
-};
-const plural = (count, word) => `${count} ${word}${count === 1 ? '' : 's'}`;
-export const logReport = (report) => {
-    var _a, _b, _c;
-    for (const change of (_a = report.fixed) !== null && _a !== void 0 ? _a : []) {
-        addLog(_jsx(SuccessLog, { message: `fixed ${change.file}${change.line ? `:${change.line}` : ''} ${change.rule}: ${preview(change.before)} → ${preview(change.after)}` }));
-    }
-    const byFile = new Map();
-    for (const diagnostic of report.diagnostics) {
-        (_c = (_b = byFile.get(diagnostic.file)) === null || _b === void 0 ? void 0 : _b.push(diagnostic)) !== null && _c !== void 0 ? _c : byFile.set(diagnostic.file, [diagnostic]);
-    }
-    for (const [file, diagnostics] of byFile) {
-        addLog(_jsxs(Box, { flexDirection: "column", children: [_jsx(Text, { bold: true, children: file }), diagnostics.map((diagnostic, index) => (_jsx(DiagnosticLine, { diagnostic: diagnostic }, index)))] }));
-    }
-    const fixable = report.diagnostics.filter(({ fix }) => fix).length;
-    if (fixable > 0 && !report.fixed) {
-        addLog(_jsx(InfoLog, { message: `\`--fix\` would fix ${plural(fixable, 'issue')}.` }));
-    }
-    const { build } = report;
-    if (build.ran && build.passed)
-        addLog(_jsx(SuccessLog, { message: "build passed" }));
-    else if (build.ran && report.passed)
-        addLog(_jsx(InfoLog, { message: "build failed only on disabled rules" }));
-    else if (build.ran)
-        addLog(_jsx(ErrorLog, { message: "build failed" }));
-    else if (build.reason === 'errors found')
-        addLog(_jsx(InfoLog, { message: "build skipped until the errors above are fixed" }));
-    const { errors, warnings } = report.summary;
-    const warned = plural(warnings, 'warning');
-    const passed = warnings > 0 ? `passed with ${warned}` : 'validation passed';
-    const failed = `${plural(errors, 'error')}${warnings > 0 ? `, ${warned}` : ''}`;
-    addLog(report.passed ? _jsx(SuccessLog, { message: passed }) : _jsx(ErrorLog, { message: failed }));
-};

package/bin/validate/report.js

@@ -1,11 +0,0 @@
-export const toReport = (diagnostics, build, fixed) => {
-    var _a;
-    const byRule = {};
-    for (const { rule } of diagnostics)
-        byRule[rule] = ((_a = byRule[rule]) !== null && _a !== void 0 ? _a : 0) + 1;
-    const errors = diagnostics.filter(({ severity }) => severity === 'error').length;
-    return Object.assign({ passed: errors === 0, summary: { errors, warnings: diagnostics.length - errors, byRule }, diagnostics: diagnostics.map(({ rule, group, severity, file, line, column, message, fix }) => (Object.assign(Object.assign(Object.assign(Object.assign({ rule,
-            group,
-            severity,
-            file }, (line !== undefined && { line })), (column !== undefined && { column })), { message }), (fix && { fix })))), build }, (fixed && { fixed }));
-};

package/bin/validate/rules/build.js

@@ -1,102 +0,0 @@
-import { normalizeRelativePath, toPosixPath } from '@mintlify/common';
-import { stripVTControlCharacters } from 'node:util';
-const FILE = String.raw `[\w@.\\/-]+\.(?:mdx?|jsx?|tsx?|json|ya?ml)\b`;
-const FILE_IN_MESSAGE = new RegExp(FILE);
-const IMPORTERS = [
-    new RegExp(String.raw `\(in (${FILE}),`),
-    new RegExp(String.raw `(?:\bin|imported from) (${FILE})`),
-];
-const IMPORT_TYPES = new Set([
-    'missing-file',
-    'invalid-import-path',
-    'import-resolution-error',
-    'default-import-no-default-export',
-    'export-collision',
-    'undeclared-package',
-    'package-import-conflict',
-]);
-const POSITION = /^:(\d+)(?::(\d+))?/;
-const QUOTED = /"([^"]+)"/;
-const toFinding = (site, warning) => {
-    var _a, _b;
-    const clean = stripVTControlCharacters(warning.message).trim();
-    const importer = warning.file == null && IMPORT_TYPES.has(warning.type)
-        ? IMPORTERS.map((pattern) => { var _a; return (_a = pattern.exec(clean)) === null || _a === void 0 ? void 0 : _a[1]; }).find(Boolean)
-        : undefined;
-    // Missing nav pages are always about the config, even when the page looks like a file
-    const match = warning.file != null || importer || warning.type === 'missing-nav-page'
-        ? null
-        : FILE_IN_MESSAGE.exec(clean);
-    const found = importer !== null && importer !== void 0 ? importer : match === null || match === void 0 ? void 0 : match[0];
-    const file = (_a = warning.file) !== null && _a !== void 0 ? _a : (found ? normalizeRelativePath(toPosixPath(found)) : site.configFile);
-    const position = match ? POSITION.exec(clean.slice(match.index + match[0].length)) : null;
-    // Config warnings quote the entry they're about, such as a navigation page
-    const quoted = warning.file == null && file === site.configFile ? (_b = QUOTED.exec(clean)) === null || _b === void 0 ? void 0 : _b[0] : undefined;
-    const located = warning.ref != null && warning.line == null
-        ? site.locate(file, JSON.stringify(warning.ref))
-        : quoted
-            ? site.locate(file, quoted)
-            : undefined;
-    return Object.assign(Object.assign(Object.assign({ file }, (warning.line != null
-        ? Object.assign({ line: warning.line }, (warning.column != null && { column: warning.column })) : position && Object.assign({ line: Number(position[1]) }, (position[2] && { column: Number(position[2]) })))), located), { message: clean });
-};
-/** Warning types some rule turns into diagnostics, so a strict-build failure is explained. */
-const COVERED_TYPES = new Set(['parse-error']);
-const buildRule = (id, group, types, description) => {
-    for (const type of types)
-        COVERED_TYPES.add(type);
-    return {
-        id,
-        group,
-        severity: 'error',
-        needsBuild: true,
-        scope: 'site',
-        description,
-        check: (site) => {
-            var _a, _b;
-            return ((_b = (_a = site.build) === null || _a === void 0 ? void 0 : _a.warnings) !== null && _b !== void 0 ? _b : [])
-                .filter(({ type }) => types.includes(type))
-                .map((warning) => toFinding(site, warning));
-        },
-    };
-};
-export const BUILD_RULES = [
-    buildRule('missing-nav-page', 'nav', ['missing-nav-page'], 'pages in the navigation that have no file'),
-    buildRule('missing-file', 'content', ['missing-file'], "imported files that don't exist"),
-    buildRule('import-error', 'content', [
-        'invalid-import-path',
-        'import-resolution-error',
-        'default-import-no-default-export',
-        'export-collision',
-    ], "imports in pages and snippets that don't resolve"),
-    buildRule('package-import', 'config', ['undeclared-package', 'package-import-conflict'], 'npm package imports that are undeclared or conflict'),
-    buildRule('openapi-build', 'openapi', ['openapi'], 'OpenAPI pages the build could not generate'),
-    {
-        id: 'build-failed',
-        group: 'config',
-        severity: 'error',
-        needsBuild: true,
-        scope: 'site',
-        description: 'the strict build failed for a reason no rule reports',
-        check: (site) => {
-            if (!site.build || site.build.passed)
-                return [];
-            const unreported = (warning) => warning.type === 'parse-error' &&
-                site.selected !== undefined &&
-                !site.selected.has(toFinding(site, warning).file);
-            const uncovered = site.build.warnings.filter((warning) => !COVERED_TYPES.has(warning.type) || unreported(warning));
-            const findings = uncovered.map((warning) => toFinding(site, warning));
-            // Covered warnings are the selected rules' to report; disabled ones are meant to pass
-            return site.build.strict
-                ? findings
-                : [...findings, { file: site.configFile, message: site.build.error }];
-        },
-    },
-];
-/** Build warnings of one type, which the engine merges into the static rule that covers them. */
-export const buildFindings = (site, type) => {
-    var _a, _b;
-    return ((_b = (_a = site.build) === null || _a === void 0 ? void 0 : _a.warnings) !== null && _b !== void 0 ? _b : [])
-        .filter((warning) => warning.type === type)
-        .map((warning) => toFinding(site, warning));
-};

package/bin/validate/rules/content/duplicateH1.js

@@ -1,57 +0,0 @@
-import { AVOIDED_PAGE_MODES, getTableOfContentsTitle, safeCleanHeadingId, slugify, } from '@mintlify/common';
-import remarkSmartypants from 'remark-smartypants';
-import { unified } from 'unified';
-import { hasCustomHeadingId, linkedAnchor } from '../../mdx.js';
-const normalize = (value) => value.trim().replace(/\s+/g, ' ');
-const smartypants = unified().use(remarkSmartypants);
-const firstHeading = (tree) => tree.children.find((node) => node.type === 'heading');
-const renderedText = (heading) => {
-    const clone = structuredClone(heading);
-    const root = { type: 'root', children: [clone] };
-    smartypants.runSync(root);
-    return getTableOfContentsTitle(clone);
-};
-export const duplicateH1 = {
-    id: 'duplicate-h1',
-    group: 'content',
-    severity: 'warning',
-    scope: 'file',
-    description: 'remove a first heading that repeats the frontmatter title',
-    pagesOnly: true,
-    needsAnchorLinks: true,
-    check: ({ tree, frontmatter, content, file, anchorLinks }) => {
-        var _a, _b, _c, _d, _e, _f, _g, _h;
-        const { title, mode } = frontmatter;
-        if (typeof title !== 'string' || AVOIDED_PAGE_MODES.includes(String(mode)))
-            return [];
-        const first = firstHeading(tree);
-        if (!first || first.depth !== 1)
-            return [];
-        if (normalize(getTableOfContentsTitle(first)) !== normalize(title))
-            return [];
-        const start = (_b = (_a = first.position) === null || _a === void 0 ? void 0 : _a.start.offset) !== null && _b !== void 0 ? _b : 0;
-        const end = (_d = (_c = first.position) === null || _c === void 0 ? void 0 : _c.end.offset) !== null && _d !== void 0 ? _d : start;
-        const location = {
-            line: (_e = first.position) === null || _e === void 0 ? void 0 : _e.start.line,
-            column: (_f = first.position) === null || _f === void 0 ? void 0 : _f.start.column,
-        };
-        const lineEnd = content.indexOf('\n', start);
-        if (hasCustomHeadingId(content.slice(start, lineEnd === -1 ? undefined : lineEnd))) {
-            return [
-                Object.assign(Object.assign({}, location), { message: 'first heading duplicates the frontmatter title; it has a custom {#id}, so remove it by hand and update links to it' }),
-            ];
-        }
-        const anchor = [renderedText(first), getTableOfContentsTitle(first)]
-            .map((text) => linkedAnchor(anchorLinks, file, safeCleanHeadingId(slugify(text))))
-            .find((linked) => linked !== undefined);
-        if (anchor !== undefined) {
-            return [
-                Object.assign(Object.assign({}, location), { message: `first heading duplicates the frontmatter title; links point to #${anchor}, so remove it by hand and update them` }),
-            ];
-        }
-        const trailing = (_h = (_g = /^\n*/.exec(content.slice(end))) === null || _g === void 0 ? void 0 : _g[0].length) !== null && _h !== void 0 ? _h : 0;
-        return [
-            Object.assign(Object.assign({}, location), { message: 'first heading duplicates the frontmatter title', edit: { start, end: end + trailing, text: '' } }),
-        ];
-    },
-};

package/bin/validate/rules/content/foreignSyntax.js

@@ -1,120 +0,0 @@
-import { maskCode, maskFrontmatter, maskNonMarkup, toPosition } from '../../mdx.js';
-const CALLOUTS = {
-    note: '<Note>',
-    info: '<Info>',
-    tip: '<Tip>',
-    hint: '<Tip>',
-    success: '<Check>',
-    important: '<Note>',
-    warning: '<Warning>',
-    caution: '<Warning>',
-    danger: '<Warning>',
-    error: '<Warning>',
-    details: '<Accordion>',
-};
-const callout = (name) => { var _a, _b; return (_b = CALLOUTS[(_a = name === null || name === void 0 ? void 0 : name.toLowerCase()) !== null && _a !== void 0 ? _a : '']) !== null && _b !== void 0 ? _b : 'a callout (<Note>, <Info>, <Tip> or <Warning>)'; };
-const LIQUID_TAGS = {
-    hint: 'a callout (<Note>, <Info>, <Tip> or <Warning>)',
-    tabs: '<Tabs>',
-    tab: '<Tab title="…">',
-    stepper: '<Steps>',
-    step: '<Step title="…">',
-    embed: 'a link or <Frame>',
-    'content-ref': '<Card>',
-    include: 'a snippet import',
-    code: 'a fenced code block',
-    file: 'a link to the file',
-    swagger: 'an OpenAPI page',
-    openapi: 'an OpenAPI page',
-};
-const PATTERNS = [
-    {
-        regex: /\{%-?\s*(?!end)([\w-]+)[^%\n]*?-?%\}/g,
-        message: ([tag, name]) => {
-            var _a, _b;
-            const style = name === 'hint' ? (_a = /style=["']?(\w+)/.exec(tag)) === null || _a === void 0 ? void 0 : _a[1] : undefined;
-            const target = style
-                ? callout(style)
-                : ((_b = LIQUID_TAGS[name !== null && name !== void 0 ? name : '']) !== null && _b !== void 0 ? _b : 'Markdown or a Mintlify component');
-            return `${tag} is a GitBook or Liquid tag, which Mintlify does not support; use ${target}`;
-        },
-    },
-    {
-        regex: /\{\{[<%]\s*([\w/-]+)[^}\n]*[>%]\}\}/g,
-        message: ([tag]) => `${tag} is a Hugo shortcode, which Mintlify does not support; use Markdown or a Mintlify component`,
-    },
-    {
-        regex: /\{\{-?\s*(?:(?:site|page|layout|include|jekyll|paginator)\.[^}\n]*|[^\s|{}]+\s*\|\s*\w+[^}\n]*)-?\}\}/g,
-        message: ([tag]) => `${tag} is a Liquid variable, which Mintlify does not support; write the value, or use a snippet or a variable`,
-    },
-    {
-        regex: /^ {0,3}:{3,}\s*([A-Za-z][\w-]*)/gm,
-        message: ([, name]) => `:::${name} is a Docusaurus or VitePress admonition, which Mintlify does not support; use ${callout(name)}`,
-    },
-    {
-        regex: /^ {0,3}::(?!:)([A-Za-z][\w-]*)/gm,
-        message: ([, name]) => `::${name} is an MDC (Nuxt Content, Docus) block, which Mintlify does not support; use the matching Mintlify component`,
-    },
-    {
-        regex: /^ {0,3}(!!!|\?\?\?\+?)[ \t]+([A-Za-z][\w-]*)/gm,
-        message: ([, marker, name]) => `${marker} ${name} is an MkDocs admonition, which Mintlify does not support; use ${marker === '!!!' ? callout(name) : '<Accordion>'}`,
-    },
-    {
-        regex: /^ {0,3}===\+?[ \t]+["']/gm,
-        message: () => `=== "…" is an MkDocs content tab, which Mintlify does not support; use <Tabs> with <Tab title="…">`,
-    },
-    {
-        regex: /^[ \t]*;?[ \t]*--8<--/gm,
-        scope: 'everything',
-        message: () => '--8<-- is an MkDocs snippet include, which Mintlify does not support; use a snippet import or paste the content',
-    },
-    {
-        regex: /\{:\s*[.#\w][^}\n]*\}/g,
-        message: ([list]) => `${list} is a Kramdown attribute list, which Mintlify does not support; remove it, use a component, or use {#id} for a heading anchor`,
-    },
-    {
-        regex: /(?<![[{\w])\[\[([^[\]\n]+)\]\](?![(:[])/g,
-        message: ([link]) => `${link} is a wiki link, which Mintlify does not support; use a Markdown link such as [text](/path)`,
-    },
-    {
-        regex: /(?:\]\(|href=["'])((?:doc|ref|blog|changelog|page):[^)\s"']+)/g,
-        scope: 'links',
-        message: ([, link]) => {
-            var _a;
-            return `${link} is a ReadMe link, which Mintlify does not support; link to the page path instead, such as /${(_a = link === null || link === void 0 ? void 0 : link.split(':')[1]) !== null && _a !== void 0 ? _a : ''}`;
-        },
-    },
-    {
-        regex: /["'(]@site\/[^"')\s]*/g,
-        scope: 'prose-and-esm',
-        message: ([path]) => `${path.slice(1)} uses the Docusaurus @site alias, which Mintlify does not resolve; use a root-relative path such as /images/… or /snippets/…`,
-    },
-];
-export const foreignSyntax = {
-    id: 'foreign-syntax',
-    group: 'content',
-    severity: 'warning',
-    scope: 'file',
-    description: "syntax from another docs framework that Mintlify doesn't render",
-    raw: true,
-    check: ({ content }) => {
-        const prose = maskCode(content);
-        const literal = maskNonMarkup(content);
-        const views = {
-            prose,
-            links: prose,
-            'prose-and-esm': maskCode(content, { keepEsm: true }),
-            everything: maskFrontmatter(content),
-        };
-        const issues = [];
-        for (const { regex, scope = 'prose', message } of PATTERNS) {
-            for (const match of views[scope].matchAll(regex)) {
-                const start = match.index + (match[0].length - match[0].trimStart().length);
-                if (scope === 'prose' && literal[start] !== prose[start])
-                    continue;
-                issues.push(Object.assign(Object.assign({}, toPosition(content, start)), { message: message(match) }));
-            }
-        }
-        return issues;
-    },
-};

package/bin/validate/rules/content/katex.js

@@ -1,34 +0,0 @@
-import { isCurrencyMath } from '@mintlify/common';
-import katex from 'katex';
-import { visit } from 'unist-util-visit';
-export const katexRule = {
-    id: 'katex',
-    group: 'content',
-    severity: 'warning',
-    scope: 'file',
-    description: "math that KaTeX can't render",
-    check: ({ tree, content }) => {
-        const issues = [];
-        visit(tree, (node) => {
-            var _a, _b;
-            if (node.type !== 'math' && node.type !== 'inlineMath')
-                return;
-            if (node.type === 'inlineMath' && isCurrencyMath(node, content))
-                return;
-            try {
-                katex.renderToString(node.value, {
-                    throwOnError: true,
-                    displayMode: node.type === 'math',
-                });
-            }
-            catch (error) {
-                issues.push({
-                    line: (_a = node.position) === null || _a === void 0 ? void 0 : _a.start.line,
-                    column: (_b = node.position) === null || _b === void 0 ? void 0 : _b.start.column,
-                    message: error instanceof Error ? error.message : 'invalid math',
-                });
-            }
-        });
-        return issues;
-    },
-};

package/bin/validate/rules/content/missingSnippet.js

@@ -1,34 +0,0 @@
-import { replaceVariables } from '@mintlify/common';
-import { visit } from 'unist-util-visit';
-const exists = (file, readFile) => !file.startsWith('/') &&
-    (readFile(`_snippets/${file}`) !== undefined ||
-        (file.startsWith('snippets/') && readFile(file) !== undefined));
-export const missingSnippet = {
-    id: 'missing-snippet',
-    group: 'content',
-    severity: 'error',
-    scope: 'file',
-    description: '<Snippet file> tags whose file the build cannot find',
-    check: ({ tree, readFile, variables }) => {
-        if (!readFile)
-            return [];
-        const issues = [];
-        visit(tree, 'mdxJsxFlowElement', (node) => {
-            var _a, _b, _c;
-            if (node.name !== 'Snippet')
-                return;
-            const value = (_a = node.attributes.find((attribute) => attribute.type === 'mdxJsxAttribute' && attribute.name === 'file')) === null || _a === void 0 ? void 0 : _a.value;
-            if (typeof value !== 'string')
-                return;
-            const file = replaceVariables(value, variables);
-            if (exists(file, readFile))
-                return;
-            issues.push({
-                line: (_b = node.position) === null || _b === void 0 ? void 0 : _b.start.line,
-                column: (_c = node.position) === null || _c === void 0 ? void 0 : _c.start.column,
-                message: `<Snippet file="${value}"> renders nothing: no snippet matches "${file}"`,
-            });
-        });
-        return issues;
-    },
-};

package/bin/validate/rules/content/undefinedVariable.js

@@ -1,13 +0,0 @@
-import { maskCode, toPosition } from '../../mdx.js';
-const VARIABLE = /(?<!=\s*)\{\{\s*([\w.\-]+)\s*\}\}/g;
-export const undefinedVariable = {
-    id: 'undefined-variable',
-    group: 'content',
-    severity: 'error',
-    scope: 'file',
-    description: '{{variables}} that docs.json does not define',
-    raw: true,
-    check: ({ content, variables = {} }) => [...maskCode(content).matchAll(VARIABLE)]
-        .filter(([, name]) => name !== undefined && variables[name] === undefined)
-        .map((match) => (Object.assign(Object.assign({}, toPosition(content, match.index)), { message: `{{${match[1]}}} is not defined in the variables of docs.json` }))),
-};