@dogsbay/format-mkdocs 0.2.0-beta.0

package/dist/autodoc/markdown-generator.d.ts

@@ -0,0 +1,6 @@
+import type { SymbolInfo, AutodocDirectiveOptions } from "./types.js";
+/**
+ * Generate markdown documentation for a symbol.
+ */
+export declare function generateMarkdown(symbol: SymbolInfo, options?: AutodocDirectiveOptions): string;
+//# sourceMappingURL=markdown-generator.d.ts.map

package/dist/autodoc/markdown-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-generator.d.ts","sourceRoot":"","sources":["../../src/autodoc/markdown-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAa,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEjF;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,uBAA4B,GACpC,MAAM,CAaR"}

package/dist/autodoc/markdown-generator.js

@@ -0,0 +1,242 @@
+/**
+ * Generate markdown documentation for a symbol.
+ */
+export function generateMarkdown(symbol, options = {}) {
+    const level = options.headingLevel ?? 2;
+    const lines = [];
+    if (symbol.kind === "module") {
+        lines.push(...generateModule(symbol, level, options));
+    }
+    else if (symbol.kind === "class") {
+        lines.push(...generateClass(symbol, level, options));
+    }
+    else {
+        lines.push(...generateFunction(symbol, level, options));
+    }
+    return lines.join("\n");
+}
+function generateModule(symbol, level, options) {
+    const lines = [];
+    const heading = "#".repeat(level);
+    if (options.showRootHeading !== false) {
+        lines.push(`${heading} <span class="api-badge api-badge-module">module</span> \`${symbol.name}\``);
+        lines.push("");
+    }
+    if (symbol.docstring) {
+        lines.push(symbol.docstring);
+        lines.push("");
+    }
+    const members = filterMembers(symbol.members, options);
+    for (const member of members) {
+        lines.push(...generateSymbol(member, level + 1, options));
+        lines.push("");
+    }
+    return lines;
+}
+function generateClass(symbol, level, options) {
+    const lines = [];
+    const heading = "#".repeat(level);
+    if (options.showRootHeading !== false) {
+        lines.push(`${heading} <span class="api-badge api-badge-class">class</span> \`${symbol.name}\``);
+        lines.push("");
+    }
+    // Class signature — include __init__ params when mergeInitIntoClass
+    if (options.separateSignature !== false) {
+        lines.push("```python");
+        if (options.mergeInitIntoClass !== false && symbol.params.length > 0) {
+            // Full signature with all constructor parameters
+            const paramLines = symbol.params.map((p) => {
+                let s = `    ${p.name}`;
+                if (p.bareType || p.type)
+                    s += `: ${p.bareType || p.type}`;
+                if (p.default)
+                    s += ` = ${p.default}`;
+                return s + ",";
+            });
+            lines.push(`${symbol.name}(`);
+            lines.push("    *,");
+            lines.push(...paramLines);
+            lines.push(")");
+        }
+        else {
+            lines.push(symbol.signature);
+        }
+        lines.push("```");
+        lines.push("");
+    }
+    // Bases
+    if (symbol.bases.length > 0) {
+        lines.push(`Bases: ${symbol.bases.map((b) => `\`${b}\``).join(", ")}`);
+        lines.push("");
+    }
+    // Docstring — render as markdown directly
+    if (symbol.docstring) {
+        lines.push(dedentDoc(symbol.docstring));
+        lines.push("");
+    }
+    // Constructor parameters (merged into class if option set)
+    if (options.mergeInitIntoClass !== false && symbol.params.length > 0) {
+        lines.push(...generateParamTable(symbol.params));
+        lines.push("");
+    }
+    // Members
+    const members = filterMembers(symbol.members, options);
+    for (const member of members) {
+        if (member.name === "__init__" && options.mergeInitIntoClass !== false)
+            continue;
+        lines.push(...generateSymbol(member, level + 1, options));
+        lines.push("");
+    }
+    return lines;
+}
+function generateFunction(symbol, level, options) {
+    const lines = [];
+    const heading = "#".repeat(level);
+    if (options.showRootHeading !== false) {
+        const badge = symbol.kind === "method" ? "meth" : symbol.kind === "property" ? "attr" : "func";
+        lines.push(`${heading} <span class="api-badge api-badge-${badge}">${badge}</span> \`${symbol.name}\``);
+        lines.push("");
+    }
+    // Signature — show call-style for methods (no def, no self)
+    if (options.separateSignature !== false) {
+        lines.push("```python");
+        if (symbol.kind === "method" && symbol.params.length > 0) {
+            const paramLines = symbol.params.map((p) => {
+                let s = `    ${p.name}`;
+                if (p.bareType || p.type)
+                    s += `: ${p.bareType || p.type}`;
+                if (p.default)
+                    s += ` = ${p.default}`;
+                return s + ",";
+            });
+            lines.push(`${symbol.name}(`);
+            lines.push(...paramLines);
+            lines.push(")");
+        }
+        else if (symbol.kind === "method") {
+            lines.push(`${symbol.name}()`);
+        }
+        else {
+            lines.push(symbol.signature);
+        }
+        lines.push("```");
+        lines.push("");
+    }
+    // Decorators
+    if (symbol.decorators.length > 0) {
+        for (const dec of symbol.decorators) {
+            lines.push(`\`${dec}\``);
+        }
+        lines.push("");
+    }
+    // Docstring — render as markdown directly
+    if (symbol.docstring) {
+        lines.push(dedentDoc(symbol.docstring));
+        lines.push("");
+    }
+    // Parameters
+    if (symbol.params.length > 0) {
+        lines.push(...generateParamTable(symbol.params));
+        lines.push("");
+    }
+    // Return type
+    if (symbol.returnType) {
+        lines.push(`**Returns:** \`${symbol.returnType}\``);
+        lines.push("");
+    }
+    return lines;
+}
+function generateSymbol(symbol, level, options) {
+    if (symbol.kind === "class")
+        return generateClass(symbol, level, options);
+    return generateFunction(symbol, level, options);
+}
+/**
+ * Generate a JSON-encoded api-params directive that the loader
+ * will convert to a TreeNode. This avoids markdown table limitations
+ * (no multi-line cells) and lets a dedicated component render rich
+ * parameter documentation.
+ *
+ * Format: <!-- api-params:JSON -->
+ */
+function generateParamTable(params) {
+    const paramData = params.map((p) => ({
+        name: p.name,
+        type: p.bareType || p.type || null,
+        default: p.default || null,
+        required: p.required,
+        doc: p.doc ? dedentDoc(p.doc) : null,
+    }));
+    return [
+        "**Parameters:**",
+        "",
+        `<!-- api-params:${JSON.stringify(paramData)} -->`,
+        "",
+    ];
+}
+function dedentDoc(text) {
+    const lines = text.split("\n");
+    // Find minimum indentation, skipping the first line (often unindented)
+    // and empty lines
+    let minIndent = Infinity;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].trim() === "")
+            continue;
+        const indent = lines[i].match(/^(\s*)/)?.[1].length ?? 0;
+        // Skip first line for min calculation if it has no indent
+        // (common pattern: first line right after quotes, rest indented)
+        if (i === 0 && indent === 0)
+            continue;
+        if (indent < minIndent)
+            minIndent = indent;
+    }
+    if (minIndent === Infinity || minIndent === 0)
+        return text.trim();
+    return lines.map((l) => {
+        if (l.trim() === "")
+            return "";
+        return l.startsWith(" ".repeat(minIndent)) ? l.slice(minIndent) : l;
+    }).join("\n").trim();
+}
+function filterMembers(members, options) {
+    let filtered = [...members];
+    // Apply member whitelist
+    if (options.members && options.members.length > 0) {
+        const allowed = new Set(options.members);
+        filtered = filtered.filter((m) => allowed.has(m.name));
+        // Preserve requested order
+        filtered.sort((a, b) => {
+            const aIdx = options.members.indexOf(a.name);
+            const bIdx = options.members.indexOf(b.name);
+            return aIdx - bIdx;
+        });
+    }
+    // Apply filters (e.g. "!^_" to exclude private members)
+    if (options.filters) {
+        for (const filter of options.filters) {
+            if (filter.startsWith("!")) {
+                const re = new RegExp(filter.slice(1));
+                filtered = filtered.filter((m) => !re.test(m.name));
+            }
+            else {
+                const re = new RegExp(filter);
+                filtered = filtered.filter((m) => re.test(m.name));
+            }
+        }
+    }
+    // Skip no-docstring members unless showIfNoDocstring
+    if (!options.showIfNoDocstring) {
+        // Keep all by default (FastAPI uses show_if_no_docstring: true globally)
+    }
+    // Sort
+    if (options.membersOrder === "alphabetical") {
+        filtered.sort((a, b) => a.name.localeCompare(b.name));
+    }
+    return filtered;
+}
+function truncate(s, maxLen) {
+    if (s.length <= maxLen)
+        return s;
+    return s.substring(0, maxLen - 3) + "...";
+}
+//# sourceMappingURL=markdown-generator.js.map

package/dist/autodoc/markdown-generator.js.map

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

package/dist/autodoc/module-resolver.d.ts

@@ -0,0 +1,8 @@
+import type { SymbolInfo } from "./types.js";
+/**
+ * Build list of source paths to search.
+ * Includes the sourceRoot itself plus any .venv site-packages.
+ */
+export declare function buildSourcePaths(sourceRoot: string): string[];
+export declare function resolveIdentifier(identifier: string, sourceRoot: string): Promise<SymbolInfo | null>;
+//# sourceMappingURL=module-resolver.d.ts.map

package/dist/autodoc/module-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module-resolver.d.ts","sourceRoot":"","sources":["../../src/autodoc/module-resolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAmB7D;AAkBD,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAmB5B"}

package/dist/autodoc/module-resolver.js

@@ -0,0 +1,218 @@
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { findSymbolInSource } from "./python-parser.js";
+/**
+ * Build list of source paths to search.
+ * Includes the sourceRoot itself plus any .venv site-packages.
+ */
+export function buildSourcePaths(sourceRoot) {
+    const paths = [sourceRoot];
+    // Search for .venv/lib/python*/site-packages/
+    const venvDirs = [".venv", "venv", ".env"];
+    for (const venv of venvDirs) {
+        const venvPath = join(sourceRoot, venv, "lib");
+        if (!existsSync(venvPath))
+            continue;
+        try {
+            for (const pyDir of readdirSync(venvPath)) {
+                const sitePackages = join(venvPath, pyDir, "site-packages");
+                if (existsSync(sitePackages) && statSync(sitePackages).isDirectory()) {
+                    paths.push(sitePackages);
+                }
+            }
+        }
+        catch { /* continue */ }
+    }
+    return paths;
+}
+/**
+ * Resolve a dotted Python identifier to a source file and symbol.
+ *
+ * Examples:
+ *   "fastapi.FastAPI" → fastapi/__init__.py or fastapi/applications.py
+ *   "fastapi.security.OAuth2" → fastapi/security/__init__.py
+ *   "fastapi.responses.JSONResponse" → fastapi/responses.py
+ *   "fastapi.status" → fastapi/status.py (module-level)
+ */
+// Cache source paths to avoid rebuilding for every resolve call
+let cachedSourceRoot = null;
+let cachedSourcePaths = [];
+// Track identifiers being resolved to prevent infinite recursion
+const resolving = new Set();
+export async function resolveIdentifier(identifier, sourceRoot) {
+    if (resolving.has(identifier))
+        return null;
+    resolving.add(identifier);
+    try {
+        if (cachedSourceRoot !== sourceRoot) {
+            cachedSourcePaths = buildSourcePaths(sourceRoot);
+            cachedSourceRoot = sourceRoot;
+        }
+        for (const root of cachedSourcePaths) {
+            const result = await resolveInRoot(identifier, root, cachedSourcePaths, 0);
+            if (result)
+                return result;
+        }
+        return null;
+    }
+    finally {
+        resolving.delete(identifier);
+    }
+}
+async function resolveInRoot(identifier, sourceRoot, allPaths, depth = 0) {
+    // Prevent infinite recursion from circular re-exports
+    if (depth > 2)
+        return null;
+    const parts = identifier.split(".");
+    // Try progressively splitting: module.path vs symbol.name
+    for (let split = parts.length - 1; split >= 1; split--) {
+        const moduleParts = parts.slice(0, split);
+        const symbolName = parts.slice(split).join(".");
+        const filePath = resolveModulePath(moduleParts, sourceRoot);
+        if (!filePath)
+            continue;
+        try {
+            const source = readFileSync(filePath, "utf-8");
+            const symbol = await findSymbolInSource(source, symbolName, filePath);
+            if (symbol)
+                return symbol;
+            // Follow chained re-export in this file
+            const chainMatch = source.match(new RegExp(`from\\s+(\\S+)\\s+import\\s+${symbolName}(?:\\s+as\\s+${symbolName})?`));
+            if (chainMatch) {
+                const chainModule = chainMatch[1];
+                const searchPaths = allPaths || [sourceRoot];
+                for (const root of searchPaths) {
+                    const result = await resolveInRoot(`${chainModule}.${symbolName}`, root, allPaths, depth + 1);
+                    if (result)
+                        return result;
+                }
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Follow re-exports from __init__.py
+    const lastPart = parts[parts.length - 1];
+    const packageParts = parts.slice(0, -1);
+    const packageDir = join(sourceRoot, ...packageParts);
+    if (existsSync(packageDir) && statSync(packageDir).isDirectory()) {
+        const initPath = join(packageDir, "__init__.py");
+        if (existsSync(initPath)) {
+            const initSource = readFileSync(initPath, "utf-8");
+            // Follow relative imports: from .submodule import Symbol
+            const relImportMatch = initSource.match(new RegExp(`from\\s+\\.(\\w+)\\s+import\\s+(?:.*\\b${lastPart}\\b)`));
+            if (relImportMatch) {
+                const submodule = relImportMatch[1];
+                const subPath = join(packageDir, submodule + ".py");
+                if (existsSync(subPath)) {
+                    try {
+                        const subSource = readFileSync(subPath, "utf-8");
+                        // Try as a definition first
+                        const symbol = await findSymbolInSource(subSource, lastPart, subPath);
+                        if (symbol)
+                            return symbol;
+                        // Follow chained re-export: from other.module import Symbol
+                        const chainMatch = subSource.match(new RegExp(`from\\s+(\\S+)\\s+import\\s+${lastPart}(?:\\s+as\\s+${lastPart})?`));
+                        if (chainMatch) {
+                            const chainModule = chainMatch[1];
+                            const searchPaths = allPaths || [sourceRoot];
+                            for (const root of searchPaths) {
+                                const result = await resolveInRoot(`${chainModule}.${lastPart}`, root, allPaths, depth + 1);
+                                if (result)
+                                    return result;
+                            }
+                        }
+                    }
+                    catch { /* continue */ }
+                }
+            }
+            // Follow absolute imports: from some.module import Symbol as Symbol
+            const absImportMatch = initSource.match(new RegExp(`from\\s+(\\S+)\\s+import\\s+${lastPart}(?:\\s+as\\s+${lastPart})?`));
+            if (absImportMatch) {
+                const absModule = absImportMatch[1];
+                // Resolve this as a new identifier from all source paths
+                const searchPaths = allPaths || [sourceRoot];
+                for (const root of searchPaths) {
+                    const absResult = await resolveInRoot(`${absModule}.${lastPart}`, root, allPaths, depth + 1);
+                    if (absResult)
+                        return absResult;
+                }
+            }
+        }
+        // Scan .py files for definitions (skip at depth > 0 to avoid slow scans)
+        if (depth === 0) {
+            try {
+                for (const entry of readdirSync(packageDir)) {
+                    if (!entry.endsWith(".py") || entry === "__init__.py")
+                        continue;
+                    const filePath = join(packageDir, entry);
+                    try {
+                        const source = readFileSync(filePath, "utf-8");
+                        const symbol = await findSymbolInSource(source, lastPart, filePath);
+                        if (symbol)
+                            return symbol;
+                    }
+                    catch {
+                        continue;
+                    }
+                }
+            }
+            catch { /* continue */ }
+        }
+    }
+    // Try as a module itself
+    const modulePath = resolveModulePath(parts, sourceRoot);
+    if (modulePath) {
+        try {
+            const source = readFileSync(modulePath, "utf-8");
+            const { parsePythonSource } = await import("./python-parser.js");
+            const symbols = await parsePythonSource(source, modulePath);
+            return {
+                name: parts[parts.length - 1],
+                kind: "module",
+                signature: `module ${identifier}`,
+                docstring: extractModuleDocstring(source),
+                decorators: [],
+                bases: [],
+                params: [],
+                returnType: null,
+                members: symbols,
+                source: { file: modulePath, line: 1 },
+            };
+        }
+        catch {
+            // Fall through
+        }
+    }
+    return null;
+}
+/**
+ * Resolve module path parts to a file path.
+ * Tries: package/__init__.py, then module.py
+ */
+function resolveModulePath(parts, sourceRoot) {
+    // Try as package: parts/__init__.py
+    const packageInit = join(sourceRoot, ...parts, "__init__.py");
+    if (existsSync(packageInit))
+        return packageInit;
+    // Try as module: parts[:-1]/parts[-1].py
+    if (parts.length > 1) {
+        const modulePath = join(sourceRoot, ...parts.slice(0, -1), parts[parts.length - 1] + ".py");
+        if (existsSync(modulePath))
+            return modulePath;
+    }
+    // Try as single file: parts.py
+    const singleFile = join(sourceRoot, parts.join("/") + ".py");
+    if (existsSync(singleFile))
+        return singleFile;
+    return null;
+}
+function extractModuleDocstring(source) {
+    // First string literal in the file
+    const match = source.match(/^(?:#[^\n]*\n)*\s*(?:"""([\s\S]*?)"""|'''([\s\S]*?)''')/);
+    if (match)
+        return (match[1] ?? match[2] ?? "").trim();
+    return null;
+}
+//# sourceMappingURL=module-resolver.js.map

package/dist/autodoc/module-resolver.js.map

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

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

@@ -0,0 +1,7 @@
+import type { ParsedDocstring } from "./types.js";
+/**
+ * Parse a Python docstring into structured sections.
+ * Supports Google, NumPy, and Sphinx styles.
+ */
+export declare function parseDocstring(raw: string): ParsedDocstring;
+//# sourceMappingURL=python-docstring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"python-docstring.d.ts","sourceRoot":"","sources":["../../src/autodoc/python-docstring.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAmD,MAAM,YAAY,CAAC;AAEnG;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAoB3D"}