@dogsbay/format-mkdocs 0.2.0-beta.0

package/dist/autodoc/python-docstring.js

@@ -0,0 +1,324 @@
+/**
+ * Parse a Python docstring into structured sections.
+ * Supports Google, NumPy, and Sphinx styles.
+ */
+export function parseDocstring(raw) {
+    const trimmed = dedent(raw);
+    const lines = trimmed.split("\n");
+    // Detect style and parse
+    if (isGoogleStyle(lines))
+        return parseGoogleDocstring(lines);
+    if (isNumpyStyle(lines))
+        return parseNumpyDocstring(lines);
+    if (isSphinxStyle(lines))
+        return parseSphinxDocstring(lines);
+    // No recognized section style — treat as plain description
+    return {
+        summary: extractSummary(lines),
+        description: lines.join("\n").trim(),
+        params: [],
+        returns: null,
+        raises: [],
+        examples: [],
+        notes: [],
+        deprecated: null,
+    };
+}
+function dedent(text) {
+    const lines = text.split("\n");
+    // Find minimum indentation (excluding empty lines)
+    let minIndent = Infinity;
+    for (const line of lines) {
+        if (line.trim() === "")
+            continue;
+        const indent = line.match(/^(\s*)/)?.[1].length ?? 0;
+        if (indent < minIndent)
+            minIndent = indent;
+    }
+    if (minIndent === Infinity || minIndent === 0)
+        return text;
+    return lines.map((l) => l.slice(minIndent)).join("\n");
+}
+function extractSummary(lines) {
+    const parts = [];
+    for (const line of lines) {
+        if (line.trim() === "" && parts.length > 0)
+            break;
+        if (line.trim() !== "")
+            parts.push(line.trim());
+    }
+    return parts.join(" ");
+}
+// ── Google Style ─────────────────────────────────────
+const GOOGLE_SECTIONS = /^(Args|Arguments|Parameters|Returns?|Raises?|Yields?|Examples?|Notes?|Attributes?|Todo|Deprecated|References?|Warns?|See Also)\s*:/i;
+function isGoogleStyle(lines) {
+    return lines.some((l) => GOOGLE_SECTIONS.test(l.trim()));
+}
+function parseGoogleDocstring(lines) {
+    const result = {
+        summary: "",
+        description: "",
+        params: [],
+        returns: null,
+        raises: [],
+        examples: [],
+        notes: [],
+        deprecated: null,
+    };
+    let currentSection = null;
+    const descLines = [];
+    const sectionLines = [];
+    let inSummary = true;
+    function flushSection() {
+        if (!currentSection)
+            return;
+        const content = sectionLines.join("\n");
+        switch (currentSection.toLowerCase()) {
+            case "args":
+            case "arguments":
+            case "parameters":
+            case "attributes":
+                result.params = parseGoogleParams(sectionLines);
+                break;
+            case "returns":
+            case "return":
+                result.returns = parseGoogleReturn(sectionLines);
+                break;
+            case "raises":
+            case "raise":
+                result.raises = parseGoogleRaises(sectionLines);
+                break;
+            case "examples":
+            case "example":
+                result.examples.push(content);
+                break;
+            case "notes":
+            case "note":
+                result.notes.push(content);
+                break;
+            case "deprecated":
+                result.deprecated = content.trim();
+                break;
+        }
+        sectionLines.length = 0;
+    }
+    for (const line of lines) {
+        const trimmed = line.trim();
+        const sectionMatch = GOOGLE_SECTIONS.exec(trimmed);
+        if (sectionMatch) {
+            if (inSummary) {
+                result.summary = extractSummary(descLines);
+                result.description = descLines.join("\n").trim();
+                inSummary = false;
+            }
+            flushSection();
+            currentSection = sectionMatch[1];
+            continue;
+        }
+        if (currentSection) {
+            sectionLines.push(line);
+        }
+        else {
+            if (trimmed === "" && inSummary && descLines.length > 0) {
+                result.summary = extractSummary(descLines);
+                inSummary = false;
+            }
+            descLines.push(line);
+        }
+    }
+    if (inSummary && descLines.length > 0) {
+        result.summary = extractSummary(descLines);
+        result.description = descLines.join("\n").trim();
+    }
+    flushSection();
+    return result;
+}
+function parseGoogleParams(lines) {
+    const params = [];
+    let current = null;
+    for (const line of lines) {
+        // "name (type): description" or "name: description"
+        const match = line.match(/^\s{2,4}(\w+)\s*(?:\(([^)]+)\))?\s*:\s*(.*)/);
+        if (match) {
+            if (current)
+                params.push(current);
+            current = {
+                name: match[1],
+                type: match[2] || null,
+                description: match[3].trim(),
+            };
+        }
+        else if (current && line.trim() !== "") {
+            current.description += " " + line.trim();
+        }
+    }
+    if (current)
+        params.push(current);
+    return params;
+}
+function parseGoogleReturn(lines) {
+    const text = lines.map((l) => l.trim()).filter(Boolean).join(" ");
+    if (!text)
+        return null;
+    // "type: description" or just "description"
+    const match = text.match(/^(\w[\w\[\], |]*?):\s*(.*)/);
+    if (match)
+        return { type: match[1], description: match[2] };
+    return { type: null, description: text };
+}
+function parseGoogleRaises(lines) {
+    const raises = [];
+    let current = null;
+    for (const line of lines) {
+        const match = line.match(/^\s{2,4}(\w+)\s*:\s*(.*)/);
+        if (match) {
+            if (current)
+                raises.push(current);
+            current = { type: match[1], description: match[2].trim() };
+        }
+        else if (current && line.trim() !== "") {
+            current.description += " " + line.trim();
+        }
+    }
+    if (current)
+        raises.push(current);
+    return raises;
+}
+// ── NumPy Style ──────────────────────────────────────
+const NUMPY_SECTION_UNDERLINE = /^-{3,}\s*$/;
+function isNumpyStyle(lines) {
+    return lines.some((l) => NUMPY_SECTION_UNDERLINE.test(l.trim()));
+}
+function parseNumpyDocstring(lines) {
+    const result = {
+        summary: extractSummary(lines),
+        description: "",
+        params: [],
+        returns: null,
+        raises: [],
+        examples: [],
+        notes: [],
+        deprecated: null,
+    };
+    let i = 0;
+    const descLines = [];
+    // Collect description until first section
+    while (i < lines.length) {
+        if (i + 1 < lines.length && NUMPY_SECTION_UNDERLINE.test(lines[i + 1].trim()))
+            break;
+        descLines.push(lines[i]);
+        i++;
+    }
+    result.description = descLines.join("\n").trim();
+    // Parse sections
+    while (i < lines.length) {
+        const sectionName = lines[i].trim();
+        i++; // skip section name
+        if (i < lines.length && NUMPY_SECTION_UNDERLINE.test(lines[i].trim())) {
+            i++; // skip underline
+        }
+        const sectionLines = [];
+        while (i < lines.length) {
+            if (i + 1 < lines.length && NUMPY_SECTION_UNDERLINE.test(lines[i + 1].trim()))
+                break;
+            sectionLines.push(lines[i]);
+            i++;
+        }
+        const lower = sectionName.toLowerCase();
+        if (lower === "parameters" || lower === "params") {
+            result.params = parseNumpyParams(sectionLines);
+        }
+        else if (lower === "returns") {
+            const retText = sectionLines.map((l) => l.trim()).filter(Boolean).join(" ");
+            if (retText)
+                result.returns = { type: null, description: retText };
+        }
+        else if (lower === "raises") {
+            result.raises = parseGoogleRaises(sectionLines); // Similar format
+        }
+        else if (lower === "examples" || lower === "example") {
+            result.examples.push(sectionLines.join("\n"));
+        }
+        else if (lower === "notes") {
+            result.notes.push(sectionLines.join("\n").trim());
+        }
+    }
+    return result;
+}
+function parseNumpyParams(lines) {
+    const params = [];
+    let current = null;
+    for (const line of lines) {
+        // "name : type" or just "name"
+        const match = line.match(/^(\w+)\s*:\s*(.*)/);
+        if (match && !line.startsWith("    ")) {
+            if (current)
+                params.push(current);
+            current = { name: match[1], type: match[2] || null, description: "" };
+        }
+        else if (current && line.trim() !== "") {
+            current.description += (current.description ? " " : "") + line.trim();
+        }
+    }
+    if (current)
+        params.push(current);
+    return params;
+}
+// ── Sphinx Style ─────────────────────────────────────
+function isSphinxStyle(lines) {
+    return lines.some((l) => /^\s*:(param|type|returns?|rtype|raises?)\s/.test(l));
+}
+function parseSphinxDocstring(lines) {
+    const result = {
+        summary: extractSummary(lines),
+        description: "",
+        params: [],
+        returns: null,
+        raises: [],
+        examples: [],
+        notes: [],
+        deprecated: null,
+    };
+    const descLines = [];
+    const paramDocs = {};
+    const paramTypes = {};
+    for (const line of lines) {
+        const paramMatch = line.match(/^\s*:param\s+(\w+)\s*:\s*(.*)/);
+        const typeMatch = line.match(/^\s*:type\s+(\w+)\s*:\s*(.*)/);
+        const returnMatch = line.match(/^\s*:returns?\s*:\s*(.*)/);
+        const rtypeMatch = line.match(/^\s*:rtype\s*:\s*(.*)/);
+        const raisesMatch = line.match(/^\s*:raises?\s+(\w+)\s*:\s*(.*)/);
+        if (paramMatch) {
+            paramDocs[paramMatch[1]] = paramMatch[2].trim();
+        }
+        else if (typeMatch) {
+            paramTypes[typeMatch[1]] = typeMatch[2].trim();
+        }
+        else if (returnMatch) {
+            if (!result.returns)
+                result.returns = { type: null, description: "" };
+            result.returns.description = returnMatch[1].trim();
+        }
+        else if (rtypeMatch) {
+            if (!result.returns)
+                result.returns = { type: null, description: "" };
+            result.returns.type = rtypeMatch[1].trim();
+        }
+        else if (raisesMatch) {
+            result.raises.push({ type: raisesMatch[1], description: raisesMatch[2].trim() });
+        }
+        else {
+            descLines.push(line);
+        }
+    }
+    result.description = descLines.join("\n").trim();
+    for (const [name, desc] of Object.entries(paramDocs)) {
+        result.params.push({
+            name,
+            type: paramTypes[name] || null,
+            description: desc,
+        });
+    }
+    return result;
+}
+//# sourceMappingURL=python-docstring.js.map

package/dist/autodoc/python-docstring.js.map

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

package/dist/autodoc/python-parser.d.ts

@@ -0,0 +1,10 @@
+import type { SymbolInfo } from "./types.js";
+/**
+ * Parse Python source code and extract all top-level symbols.
+ */
+export declare function parsePythonSource(source: string, filePath: string): Promise<SymbolInfo[]>;
+/**
+ * Find a specific symbol by name in parsed source.
+ */
+export declare function findSymbolInSource(source: string, symbolName: string, filePath: string): Promise<SymbolInfo | null>;
+//# sourceMappingURL=python-parser.d.ts.map

package/dist/autodoc/python-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"python-parser.d.ts","sourceRoot":"","sources":["../../src/autodoc/python-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAa,MAAM,YAAY,CAAC;AA0FxD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,EAAE,CAAC,CAKvB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAgB5B"}