@mintlify/scraping 4.0.906 → 4.0.908

package/bin/sdk/converters/phpdoc.js

@@ -0,0 +1,351 @@
+import { XMLParser } from 'fast-xml-parser';
+import fse from 'fs-extra';
+import path from 'node:path';
+import { markdownToMdx } from '../convert.js';
+const ARRAY_TAGS = new Set([
+    'file',
+    'class',
+    'interface',
+    'trait',
+    'enum',
+    'method',
+    'property',
+    'constant',
+    'argument',
+    'tag',
+    'implements',
+]);
+const KINDS = [
+    { key: 'class', tag: 'CLASS' },
+    { key: 'interface', tag: 'INTERFACE' },
+    { key: 'trait', tag: 'TRAIT' },
+    { key: 'enum', tag: 'ENUM' },
+];
+export async function convertPhpdoc(sourcePath) {
+    const file = (await fse.stat(sourcePath)).isDirectory()
+        ? path.join(sourcePath, 'structure.xml')
+        : sourcePath;
+    const xml = await fse.readFile(file, 'utf8');
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: '@_',
+        parseTagValue: false,
+        parseAttributeValue: false,
+        htmlEntities: true,
+        isArray: (name) => ARRAY_TAGS.has(name),
+    });
+    const parsed = parser.parse(xml);
+    const entries = collectEntries(parsed.project?.file ?? []);
+    if (entries.length === 0) {
+        throw new Error(`No phpDocumentor elements found in ${file}`);
+    }
+    const slugByName = new Map(entries.map((entry) => [entry.fullName, entry.slug]));
+    const renderer = new PhpdocRenderer(slugByName);
+    const byGroup = new Map();
+    for (const entry of entries) {
+        const members = byGroup.get(entry.group) ?? [];
+        members.push(entry);
+        byGroup.set(entry.group, members);
+    }
+    const rootGroup = entries.find((entry) => entry.namespace.length === 0)?.group;
+    const groupNames = [...byGroup.keys()].sort((left, right) => {
+        if (left === rootGroup)
+            return -1;
+        if (right === rootGroup)
+            return 1;
+        return left.localeCompare(right);
+    });
+    const pages = [];
+    const groups = [];
+    for (const groupName of groupNames) {
+        const members = (byGroup.get(groupName) ?? []).sort((left, right) => left.name.localeCompare(right.name));
+        const groupPages = members.map((entry) => renderer.renderPage(entry));
+        pages.push(...groupPages);
+        groups.push({ group: groupName, pages: groupPages.map((page) => page.slug) });
+    }
+    return { pages, groups };
+}
+function collectEntries(files) {
+    const raw = [];
+    const namespaces = [];
+    for (const file of files) {
+        for (const kind of KINDS) {
+            for (const element of file[kind.key] ?? []) {
+                const name = element.name ?? '';
+                if (!name)
+                    continue;
+                const fullName = (element.full_name ?? name).replace(/^\\/, '');
+                raw.push({ element, keyword: kind.key, tag: kind.tag, name, fullName });
+                namespaces.push(namespaceSegments(element, name, fullName));
+            }
+        }
+    }
+    const prefix = commonPrefix(namespaces);
+    const taken = new Set();
+    return raw.map((entry, index) => {
+        const namespace = (namespaces[index] ?? []).slice(prefix.length);
+        const group = namespace.length ? namespace.join('\\') : prefix.join('\\') || 'Reference';
+        const base = [...namespace.map(slugify), slugify(entry.name)].join('/');
+        let slug = base;
+        let counter = 2;
+        while (taken.has(slug))
+            slug = `${base}-${counter++}`;
+        taken.add(slug);
+        return { ...entry, namespace, group, slug };
+    });
+}
+function namespaceSegments(element, name, fullName) {
+    const namespace = element['@_namespace']?.replace(/^\\/, '');
+    if (namespace)
+        return namespace.split('\\');
+    const segments = fullName.split('\\');
+    return segments.at(-1) === name ? segments.slice(0, -1) : segments;
+}
+function commonPrefix(lists) {
+    let prefix = lists[0] ?? [];
+    for (const list of lists.slice(1)) {
+        let index = 0;
+        while (index < prefix.length && prefix[index] === list[index])
+            index++;
+        prefix = prefix.slice(0, index);
+    }
+    return prefix;
+}
+function slugify(name) {
+    return (name
+        .toLowerCase()
+        .replace(/[^a-z0-9-_.]+/g, '-')
+        .replace(/^-+|-+$/g, '') || 'item');
+}
+function tagsOf(docblock, name) {
+    return docblock?.tag?.filter((tag) => tag['@_name'] === name) ?? [];
+}
+function publicOnly(members) {
+    return members?.filter((member) => (member['@_visibility'] ?? 'public') === 'public') ?? [];
+}
+function isNullable(type) {
+    return type.startsWith('?') || /(^|\|)null(\||$)/i.test(type);
+}
+class PhpdocRenderer {
+    constructor(slugByName) {
+        this.slugByName = slugByName;
+    }
+    renderPage(entry) {
+        const { element } = entry;
+        const lines = [];
+        const summary = this.docblock(element.docblock);
+        if (summary)
+            lines.push(summary);
+        lines.push(...this.renderHeritage(entry));
+        const constants = publicOnly(element.constant).sort((left, right) => (left.name ?? '').localeCompare(right.name ?? ''));
+        const properties = publicOnly(element.property).sort((left, right) => (left.name ?? '').localeCompare(right.name ?? ''));
+        const methods = publicOnly(element.method);
+        const constructors = methods.filter((method) => method.name === '__construct');
+        const others = methods
+            .filter((method) => method.name !== '__construct')
+            .sort((left, right) => (left.name ?? '').localeCompare(right.name ?? ''));
+        if (constants.length) {
+            lines.push('## Constants');
+            for (const constant of constants) {
+                const type = tagsOf(constant.docblock, 'var')[0]?.['@_type'] ?? '';
+                const body = [
+                    this.docblock(constant.docblock),
+                    constant.value ? `Value: \`${escapeInlineCode(constant.value)}\`` : '',
+                ]
+                    .filter(Boolean)
+                    .join('\n\n');
+                lines.push(this.responseField(constant.name ?? '', type, false, body));
+            }
+        }
+        for (const ctor of constructors) {
+            lines.push('## Constructor');
+            lines.push(...this.renderMethodBody(ctor, 3));
+        }
+        if (properties.length) {
+            lines.push('## Properties');
+            for (const property of properties) {
+                const varTag = tagsOf(property.docblock, 'var')[0];
+                const type = varTag?.['@_type'] ?? '';
+                const description = this.docblock(property.docblock) ||
+                    (varTag?.['@_description']
+                        ? markdownToMdx(this.resolveInline(varTag['@_description']))
+                        : '');
+                const body = [
+                    description,
+                    property.default ? `Default: \`${escapeInlineCode(property.default)}\`` : '',
+                ]
+                    .filter(Boolean)
+                    .join('\n\n');
+                lines.push(this.responseField(property.name ?? '', type, isNullable(type), body));
+            }
+        }
+        if (others.length) {
+            lines.push('## Methods');
+            for (const method of others) {
+                lines.push(`### ${method.name}()`);
+                lines.push(...this.renderMethodBody(method, 4));
+            }
+        }
+        return {
+            slug: entry.slug,
+            title: entry.name,
+            description: this.firstSentence(element.docblock),
+            tag: entry.tag,
+            content: lines.filter(Boolean).join('\n\n'),
+        };
+    }
+    renderHeritage(entry) {
+        const { element } = entry;
+        const heritage = [
+            element.extends ? `extends ${element.extends}` : '',
+            element.implements?.length ? `implements ${element.implements.join(', ')}` : '',
+        ].filter(Boolean);
+        if (!heritage.length)
+            return [];
+        const modifiers = [
+            element['@_abstract'] === 'true' ? 'abstract' : '',
+            element['@_final'] === 'true' ? 'final' : '',
+        ].filter(Boolean);
+        return [this.codeBlock([...modifiers, entry.keyword, entry.name, ...heritage].join(' '))];
+    }
+    renderMethodBody(method, depth) {
+        const lines = [this.codeBlock(this.signature(method))];
+        const comment = this.docblock(method.docblock);
+        if (comment)
+            lines.push(comment);
+        const args = method.argument ?? [];
+        const paramTags = tagsOf(method.docblock, 'param');
+        if (args.length) {
+            lines.push(`${'#'.repeat(depth)} Parameters`);
+            for (const arg of args) {
+                const paramTag = paramTags.find((tag) => tag['@_variable'] === arg.name);
+                const type = arg.type || paramTag?.['@_type'] || '';
+                const optional = Boolean(arg.default) || isNullable(type);
+                const body = paramTag?.['@_description']
+                    ? markdownToMdx(this.resolveInline(paramTag['@_description']))
+                    : '';
+                lines.push(this.responseField(arg.name ?? '', type, optional, body));
+            }
+        }
+        const returnTag = tagsOf(method.docblock, 'return')[0];
+        if (returnTag?.['@_type'] && returnTag['@_type'] !== 'void') {
+            lines.push(`${'#'.repeat(depth)} Returns`);
+            const description = returnTag['@_description']
+                ? `\n\n${markdownToMdx(this.resolveInline(returnTag['@_description']))}`
+                : '';
+            lines.push(`\`${escapeInlineCode(returnTag['@_type'])}\`${description}`);
+        }
+        const throwsTags = tagsOf(method.docblock, 'throws');
+        if (throwsTags.length) {
+            lines.push(`${'#'.repeat(depth)} Throws`);
+            lines.push(markdownToMdx(throwsTags
+                .map((tag) => {
+                const description = tag['@_description'] ? ` ${tag['@_description']}` : '';
+                return `- \`${escapeInlineCode(tag['@_type'] ?? 'Exception')}\`${description}`;
+            })
+                .join('\n')));
+        }
+        return lines;
+    }
+    signature(method) {
+        const params = (method.argument ?? [])
+            .map((arg) => {
+            const type = arg.type ? `${arg.type} ` : '';
+            const fallback = arg.default ? ` = ${arg.default}` : '';
+            return `${type}$${arg.name}${fallback}`;
+        })
+            .join(', ');
+        const modifiers = [
+            method['@_abstract'] === 'true' ? 'abstract' : '',
+            'public',
+            method['@_static'] === 'true' ? 'static' : '',
+        ].filter(Boolean);
+        const returnType = tagsOf(method.docblock, 'return')[0]?.['@_type'];
+        const returns = returnType && method.name !== '__construct' ? `: ${returnType}` : '';
+        return `${modifiers.join(' ')} function ${method.name}(${params})${returns}`;
+    }
+    docblock(docblock) {
+        if (!docblock)
+            return '';
+        const chunks = [];
+        const sees = [...tagsOf(docblock, 'see'), ...tagsOf(docblock, 'link')]
+            .map((tag) => this.seeLink(tag))
+            .filter(Boolean);
+        const markdown = [
+            docblock.description ?? '',
+            docblock['long-description'] ?? '',
+            sees.length ? `See ${sees.join(', ')}.` : '',
+        ]
+            .filter(Boolean)
+            .join('\n\n');
+        if (markdown)
+            chunks.push(markdownToMdx(this.resolveInline(markdown)));
+        const deprecated = tagsOf(docblock, 'deprecated')[0];
+        if (deprecated) {
+            const reason = deprecated['@_description']
+                ? `: ${markdownToMdx(this.resolveInline(deprecated['@_description']))}`
+                : '';
+            chunks.push(`<Warning>Deprecated${reason}</Warning>`);
+        }
+        return chunks.filter(Boolean).join('\n\n');
+    }
+    seeLink(tag) {
+        const target = tag['@_link'] || tag['@_description'] || '';
+        if (!target)
+            return '';
+        if (/^https?:/.test(target))
+            return `[${tag['@_description'] || target}](${target})`;
+        const slug = this.resolve(target);
+        if (slug)
+            return `[${target.replace(/^\\/, '')}](/${slug})`;
+        return `\`${target}\``;
+    }
+    resolveInline(text) {
+        return text.replace(/\{@(?:see|link)\s+([^\s}]+)\s*([^}]*)\}/g, (_match, target, label) => {
+            const name = label.trim() || target.replace(/^\\/, '');
+            if (/^https?:/.test(target))
+                return `[${name}](${target})`;
+            const slug = this.resolve(target);
+            return slug ? `[${name}](/${slug})` : `\`${target}\``;
+        });
+    }
+    resolve(target) {
+        const normalized = target.replace(/^\\/, '').split('::')[0] ?? '';
+        return this.slugByName.get(normalized);
+    }
+    firstSentence(docblock) {
+        const text = [docblock?.description ?? '', docblock?.['long-description'] ?? '']
+            .join(' ')
+            .replace(/\{@(?:see|link)\s+([^\s}]+)[^}]*\}/g, '$1')
+            .replace(/\s+/g, ' ')
+            .trim();
+        if (!text)
+            return undefined;
+        const sentence = text.split(/(?<=\.)\s/)[0] ?? text;
+        return truncate(sentence, 160);
+    }
+    responseField(name, type, optional, body) {
+        const typeAttr = type ? ` type=${this.jsxString(truncate(type, 80))}` : '';
+        const requiredAttr = optional ? '' : ' required';
+        return `<ResponseField name=${this.jsxString(name)}${typeAttr}${requiredAttr}>\n${indent(body || '')}\n</ResponseField>`;
+    }
+    jsxString(value) {
+        return `{${JSON.stringify(value)}}`;
+    }
+    codeBlock(code) {
+        return `\`\`\`php\n${code}\n\`\`\``;
+    }
+}
+function indent(text) {
+    return text
+        .split('\n')
+        .map((line) => (line ? `  ${line}` : line))
+        .join('\n');
+}
+function truncate(text, max) {
+    return text.length > max ? `${text.slice(0, max - 1)}…` : text;
+}
+function escapeInlineCode(text) {
+    return text.replace(/`/g, '');
+}
+//# sourceMappingURL=phpdoc.js.map

package/bin/sdk/converters/phpdoc.js.map

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

package/bin/sdk/converters/sphinx.d.ts

@@ -0,0 +1,2 @@
+import type { SdkReference } from '../types.js';
+export declare function convertSphinx(sourcePath: string): Promise<SdkReference>;

package/bin/sdk/converters/sphinx.js

@@ -0,0 +1,267 @@
+import fse from 'fs-extra';
+import path from 'node:path';
+import { visit, SKIP } from 'unist-util-visit';
+import { htmlToHast } from '../../pipeline/root.js';
+import { turnChildrenIntoMdx } from '../../utils/children.js';
+import { removeHastComments } from '../../utils/hastComments.js';
+import { hastToMdx } from '../convert.js';
+const SKIP_PAGES = new Set(['genindex', 'search', 'py-modindex']);
+const LANG_MARKER = '@@mintlang:';
+const FENCE_MARKER = /(`{3,})[^\S\n]*\n[> ]*@@mintlang:([\w+-]+)@@[^\S\n]*\n/g;
+const ADMONITION_TAGS = {
+    note: 'Note',
+    hint: 'Tip',
+    tip: 'Tip',
+    important: 'Info',
+    seealso: 'Info',
+    warning: 'Warning',
+    caution: 'Warning',
+    danger: 'Warning',
+    error: 'Warning',
+    attention: 'Warning',
+};
+export async function convertSphinx(sourcePath) {
+    const docs = await loadDocs(sourcePath);
+    const slugs = new Set(docs.map((doc) => doc.slug));
+    const guides = docs
+        .filter((doc) => !doc.tag)
+        .sort((left, right) => left.slug === 'index' ? -1 : right.slug === 'index' ? 1 : left.slug.localeCompare(right.slug));
+    const modules = docs
+        .filter((doc) => doc.tag)
+        .sort((left, right) => left.slug.localeCompare(right.slug));
+    const pages = [...guides, ...modules].map((doc) => renderPage(doc, slugs));
+    const groups = [];
+    if (guides.length)
+        groups.push({ group: 'Getting Started', pages: guides.map((d) => d.slug) });
+    if (modules.length)
+        groups.push({ group: 'API Reference', pages: modules.map((d) => d.slug) });
+    return { pages, groups };
+}
+async function loadDocs(sourcePath) {
+    const docs = [];
+    for (const file of await collectFjsonFiles(sourcePath)) {
+        const raw = (await fse.readJson(file));
+        const slug = raw.current_page_name ??
+            path
+                .relative(sourcePath, file)
+                .split(path.sep)
+                .join('/')
+                .replace(/\.fjson$/, '');
+        if (SKIP_PAGES.has(slug) || slug.startsWith('_modules'))
+            continue;
+        if (!raw.body?.trim())
+            continue;
+        docs.push({
+            slug,
+            title: cleanTitle(raw.title ?? slug),
+            body: raw.body,
+            tag: /<dl class="py[ "]/.test(raw.body) ? 'MODULE' : undefined,
+        });
+    }
+    return docs;
+}
+async function collectFjsonFiles(dir) {
+    const files = [];
+    for (const entry of await fse.readdir(dir, { withFileTypes: true })) {
+        if (entry.name.startsWith('_'))
+            continue;
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory())
+            files.push(...(await collectFjsonFiles(fullPath)));
+        else if (entry.name.endsWith('.fjson'))
+            files.push(fullPath);
+    }
+    return files.sort();
+}
+function renderPage(doc, slugs) {
+    const hast = htmlToHast(doc.body);
+    removeHastComments(hast);
+    removeSphinxChrome(hast);
+    const description = extractDescription(hast);
+    rewriteLinks(hast, doc.slug, slugs);
+    transformAdmonitions(hast);
+    markHighlightLanguages(hast);
+    transformPyDls(hast, 0);
+    const content = hastToMdx(hast)
+        .replace(FENCE_MARKER, '$1$2\n')
+        .replace(/^[> ]*@@mintlang:[\w+-]+@@\n?/gm, '');
+    return {
+        slug: doc.slug,
+        title: doc.title,
+        description,
+        tag: doc.tag,
+        content,
+    };
+}
+function removeSphinxChrome(hast) {
+    let removedH1 = false;
+    visit(hast, 'element', (node, index, parent) => {
+        if (!parent || typeof index !== 'number')
+            return;
+        const isHeaderlink = node.tagName === 'a' && classList(node).includes('headerlink');
+        const isViewcode = node.tagName === 'a' &&
+            node.children.some((child) => child.type === 'element' && classList(child).includes('viewcode-link'));
+        const isFirstH1 = node.tagName === 'h1' && !removedH1;
+        if (isFirstH1)
+            removedH1 = true;
+        if (isHeaderlink || isViewcode || isFirstH1) {
+            parent.children.splice(index, 1);
+            return index;
+        }
+    });
+}
+function rewriteLinks(hast, fromSlug, slugs) {
+    visit(hast, 'element', (node) => {
+        if (node.tagName !== 'a' || typeof node.properties.href !== 'string')
+            return;
+        const rewritten = rewriteHref(node.properties.href, fromSlug, slugs);
+        if (rewritten === undefined)
+            delete node.properties.href;
+        else
+            node.properties.href = rewritten;
+    });
+}
+function rewriteHref(href, fromSlug, slugs) {
+    if (/^(https?:|mailto:|#)/.test(href))
+        return href;
+    const [target = ''] = href.split('#');
+    let resolved = path.posix
+        .normalize(path.posix.join(path.posix.dirname(fromSlug), target))
+        .replace(/\/$/, '')
+        .replace(/\.html?$/, '');
+    if (resolved === '.' || resolved === '')
+        resolved = 'index';
+    return slugs.has(resolved) ? `/${resolved}` : undefined;
+}
+function transformAdmonitions(hast) {
+    visit(hast, 'element', (node) => {
+        if (node.tagName !== 'div' || !classList(node).includes('admonition'))
+            return;
+        const type = classList(node).find((name) => name in ADMONITION_TAGS);
+        const children = node.children.filter((child) => !(child.type === 'element' && classList(child).includes('admonition-title')));
+        node.tagName = ADMONITION_TAGS[type ?? ''] ?? 'Note';
+        node.properties = {};
+        node.children = turnChildrenIntoMdx(children);
+        return SKIP;
+    });
+}
+function markHighlightLanguages(hast) {
+    visit(hast, 'element', (node) => {
+        const lang = classList(node)
+            .find((name) => name.startsWith('highlight-'))
+            ?.slice('highlight-'.length);
+        if (!lang || lang === 'default' || lang === 'none')
+            return;
+        visit(node, 'element', (inner) => {
+            if (inner.tagName !== 'pre')
+                return;
+            inner.children.unshift({ type: 'text', value: `${LANG_MARKER}${lang}@@\n` });
+            return SKIP;
+        });
+        return SKIP;
+    });
+}
+function transformPyDls(node, depth) {
+    const children = [];
+    for (const child of node.children) {
+        if (child.type === 'element' && child.tagName === 'dl' && classList(child).includes('py')) {
+            children.push(...explodePyDl(child, depth));
+        }
+        else {
+            if (child.type === 'element')
+                transformPyDls(child, depth);
+            children.push(child);
+        }
+    }
+    node.children = children;
+}
+function explodePyDl(dl, depth) {
+    const callable = classList(dl).some((name) => ['method', 'function'].includes(name));
+    const out = [];
+    for (const child of dl.children) {
+        if (child.type !== 'element')
+            continue;
+        if (child.tagName === 'dt' && classList(child).includes('sig')) {
+            const name = findDescName(child);
+            if (name)
+                out.push(heading(Math.min(3 + depth, 6), callable ? `${name}()` : name));
+            out.push(pythonCodeBlock(textOf(child).replace(/\s+/g, ' ').trim()));
+        }
+        else if (child.tagName === 'dd') {
+            transformPyDls(child, depth + 1);
+            out.push(...child.children);
+        }
+    }
+    return out;
+}
+function findDescName(node) {
+    let name;
+    visit(node, 'element', (inner) => {
+        if (!classList(inner).includes('descname'))
+            return;
+        name = textOf(inner).trim();
+        return SKIP;
+    });
+    return name;
+}
+function heading(level, text) {
+    return {
+        type: 'element',
+        tagName: `h${level}`,
+        properties: {},
+        children: [{ type: 'text', value: text }],
+    };
+}
+function pythonCodeBlock(code) {
+    return {
+        type: 'element',
+        tagName: 'pre',
+        properties: {},
+        children: [{ type: 'text', value: `${LANG_MARKER}python@@\n${code}` }],
+    };
+}
+function extractDescription(hast) {
+    let description;
+    visit(hast, 'element', (node, _index, parent) => {
+        if (description || node.tagName !== 'p')
+            return;
+        if (parent && parent.type === 'element' && parent.tagName === 'li')
+            return SKIP;
+        const text = textOf(node).replace(/\s+/g, ' ').trim();
+        if (!text || text.startsWith('Bases:'))
+            return;
+        const sentence = text.split(/(?<=\.)\s/)[0] ?? text;
+        description = sentence.length > 160 ? `${sentence.slice(0, 159)}…` : sentence;
+    });
+    return description;
+}
+function textOf(node) {
+    if (node.type === 'text')
+        return node.value;
+    if ('children' in node)
+        return node.children.map(textOf).join('');
+    return '';
+}
+function classList(node) {
+    const value = node.properties.className;
+    return Array.isArray(value)
+        ? value.map(String)
+        : typeof value === 'string'
+            ? value.split(' ')
+            : [];
+}
+function cleanTitle(title) {
+    return title
+        .replace(/<[^>]+>/g, '')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#(\d+);/g, (_, code) => {
+        const codePoint = Number(code);
+        return codePoint <= 0x10ffff ? String.fromCodePoint(codePoint) : `&#${code};`;
+    })
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=sphinx.js.map