@refrakt-md/docs 0.9.0 → 0.9.1

package/dist/cli-plugin.d.ts

@@ -0,0 +1,12 @@
+interface CliPluginCommand {
+    name: string;
+    description: string;
+    handler: (args: string[]) => void | Promise<void>;
+}
+interface CliPlugin {
+    namespace: string;
+    commands: CliPluginCommand[];
+}
+declare const plugin: CliPlugin;
+export default plugin;
+//# sourceMappingURL=cli-plugin.d.ts.map

package/dist/cli-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-plugin.d.ts","sourceRoot":"","sources":["../src/cli-plugin.ts"],"names":[],"mappings":"AAAA,UAAU,gBAAgB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClD;AAED,UAAU,SAAS;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAsGD,QAAA,MAAM,MAAM,EAAE,SASb,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/cli-plugin.js

@@ -0,0 +1,113 @@
+async function handleExtract(args) {
+    let input;
+    let output;
+    let lang;
+    let validate = false;
+    let sourceUrl;
+    let title;
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === '--output' || arg === '-o') {
+            output = args[++i];
+            if (!output) {
+                console.error('Error: --output requires a path');
+                process.exit(1);
+            }
+        }
+        else if (arg === '--lang') {
+            lang = args[++i];
+            if (!lang) {
+                console.error('Error: --lang requires a value');
+                process.exit(1);
+            }
+            if (lang !== 'typescript' && lang !== 'python') {
+                console.error(`Error: Unsupported language "${lang}". Supported: typescript, python`);
+                process.exit(1);
+            }
+        }
+        else if (arg === '--validate') {
+            validate = true;
+        }
+        else if (arg === '--source-url') {
+            sourceUrl = args[++i];
+            if (!sourceUrl) {
+                console.error('Error: --source-url requires a URL');
+                process.exit(1);
+            }
+        }
+        else if (arg === '--title') {
+            title = args[++i];
+            if (!title) {
+                console.error('Error: --title requires a value');
+                process.exit(1);
+            }
+        }
+        else if (arg === '--help' || arg === '-h') {
+            printExtractHelp();
+            process.exit(0);
+        }
+        else if (arg.startsWith('-')) {
+            console.error(`Error: Unknown flag "${arg}"\n`);
+            printExtractHelp();
+            process.exit(1);
+        }
+        else if (!input) {
+            input = arg;
+        }
+        else {
+            console.error(`Error: Unexpected argument "${arg}"\n`);
+            printExtractHelp();
+            process.exit(1);
+        }
+    }
+    if (!input) {
+        console.error('Error: Missing input path\n');
+        printExtractHelp();
+        process.exit(1);
+    }
+    if (!output && !validate) {
+        console.error('Error: --output is required (or use --validate)\n');
+        process.exit(1);
+    }
+    const { extractCommand } = await import('./extract/command.js');
+    await extractCommand({
+        input: input,
+        output: output ?? './content/api',
+        lang: lang,
+        validate,
+        sourceUrl,
+        title,
+    });
+}
+function printExtractHelp() {
+    console.log(`
+Usage: refrakt docs extract <path> [options]
+
+Extract symbols from source code into {% symbol %} Markdown files.
+
+Options:
+  --output, -o <path>      Output directory for generated files (required)
+  --lang <language>         Language: typescript, python (default: auto-detect)
+  --validate                Check if generated files are up to date (exit 1 if stale)
+  --source-url <url>        Base URL for source code links
+  --title <name>            Navigation section title (default: "API Reference")
+  --help, -h                Show this help message
+
+Examples:
+  refrakt docs extract ./src -o ./content/api
+  refrakt docs extract ./src -o ./content/api --source-url https://github.com/my/repo/blob/main/src
+  refrakt docs extract ./src -o ./content/api --validate
+`);
+}
+const plugin = {
+    namespace: 'docs',
+    commands: [
+        {
+            name: 'extract',
+            description: 'Extract symbols from source code into {% symbol %} Markdown',
+            handler: handleExtract,
+        },
+    ],
+};
+export default plugin;
+//# sourceMappingURL=cli-plugin.js.map

package/dist/cli-plugin.js.map

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

package/dist/extract/command.d.ts

@@ -0,0 +1,10 @@
+export interface ExtractOptions {
+    input: string;
+    output: string;
+    lang?: 'typescript' | 'python';
+    validate?: boolean;
+    sourceUrl?: string;
+    title?: string;
+}
+export declare function extractCommand(opts: ExtractOptions): Promise<void>;
+//# sourceMappingURL=command.d.ts.map

package/dist/extract/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/extract/command.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AA8DD,wBAAsB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2GxE"}

package/dist/extract/command.js

@@ -0,0 +1,161 @@
+import { resolve, join, relative, dirname } from 'node:path';
+import { writeFileSync, readFileSync, existsSync, mkdirSync, readdirSync, statSync } from 'node:fs';
+import { loadExtractor } from './extractors.js';
+import { generateSymbolMarkdown, toSlug } from './symbol-generator.js';
+import { generateLayoutMarkdown } from './layout-generator.js';
+function detectLanguage(inputPath) {
+    const abs = resolve(inputPath);
+    // Check if input is a single file
+    if (existsSync(abs) && statSync(abs).isFile()) {
+        if (abs.endsWith('.ts') || abs.endsWith('.tsx'))
+            return 'typescript';
+        if (abs.endsWith('.py'))
+            return 'python';
+    }
+    // Check for tsconfig.json
+    if (existsSync(join(abs, 'tsconfig.json')) ||
+        existsSync(join(dirname(abs), 'tsconfig.json'))) {
+        return 'typescript';
+    }
+    // Check directory contents
+    if (existsSync(abs) && statSync(abs).isDirectory()) {
+        try {
+            const files = readdirSync(abs);
+            if (files.some(f => f.endsWith('.ts') || f.endsWith('.tsx')))
+                return 'typescript';
+            if (files.some(f => f.endsWith('.py')))
+                return 'python';
+        }
+        catch {
+            // fall through
+        }
+    }
+    return 'typescript';
+}
+function findSourceFiles(inputPath, lang) {
+    const abs = resolve(inputPath);
+    if (!existsSync(abs))
+        return [];
+    const stat = statSync(abs);
+    if (stat.isFile())
+        return [abs];
+    const ext = lang === 'typescript' ? /\.tsx?$/ : /\.py$/;
+    return walkFiles(abs, ext);
+}
+function walkFiles(dir, ext) {
+    const files = [];
+    const entries = readdirSync(dir);
+    for (const entry of entries) {
+        if (entry === 'node_modules' || entry === '__pycache__' || entry.startsWith('.'))
+            continue;
+        const fullPath = resolve(dir, entry);
+        const stat = statSync(fullPath);
+        if (stat.isDirectory()) {
+            files.push(...walkFiles(fullPath, ext));
+        }
+        else if (ext.test(entry)
+            && !entry.endsWith('.d.ts') && !entry.endsWith('.test.ts') && !entry.endsWith('.spec.ts')
+            && !entry.startsWith('test_') && !entry.endsWith('_test.py')
+            && entry !== 'conftest.py' && entry !== 'setup.py') {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+export async function extractCommand(opts) {
+    const inputPath = resolve(opts.input);
+    const outputPath = resolve(opts.output);
+    const lang = opts.lang ?? detectLanguage(inputPath);
+    if (!existsSync(inputPath)) {
+        console.error(`Error: Input path does not exist: ${inputPath}`);
+        process.exit(1);
+    }
+    // Use the directory as rootDir for the extractor (even if input is a single file)
+    const extractorRoot = statSync(inputPath).isDirectory() ? inputPath : dirname(inputPath);
+    // Load the appropriate extractor
+    const extractor = await loadExtractor(lang, extractorRoot, opts.sourceUrl);
+    // Find all source files
+    const sourceFiles = findSourceFiles(inputPath, lang);
+    if (sourceFiles.length === 0) {
+        console.error(`No ${lang} source files found in ${inputPath}`);
+        process.exit(1);
+    }
+    // Extract symbols from all files
+    const allSymbols = [];
+    for (const file of sourceFiles) {
+        const result = extractor.extractFile(file);
+        allSymbols.push(...result.symbols);
+    }
+    if (allSymbols.length === 0) {
+        console.log('No exported symbols found.');
+        return;
+    }
+    console.log(`Found ${allSymbols.length} symbols in ${sourceFiles.length} files`);
+    // Detect slug collisions and resolve them
+    const slugMap = new Map();
+    for (const doc of allSymbols) {
+        const slug = toSlug(doc.name);
+        const existing = slugMap.get(slug) ?? [];
+        existing.push(doc);
+        slugMap.set(slug, existing);
+    }
+    // Generate Markdown for each symbol
+    const generated = new Map();
+    for (const [slug, docs] of slugMap) {
+        if (docs.length === 1) {
+            const filePath = join(outputPath, `${slug}.md`);
+            generated.set(filePath, generateSymbolMarkdown(docs[0], { lang }));
+        }
+        else {
+            // Resolve collisions by appending kind
+            for (const doc of docs) {
+                const uniqueSlug = `${slug}-${doc.kind}`;
+                const filePath = join(outputPath, `${uniqueSlug}.md`);
+                generated.set(filePath, generateSymbolMarkdown(doc, { lang }));
+            }
+        }
+    }
+    // Generate _layout.md
+    const layoutPath = join(outputPath, '_layout.md');
+    const layoutContent = generateLayoutMarkdown(allSymbols, { title: opts.title });
+    generated.set(layoutPath, layoutContent);
+    // Validate mode: compare generated to existing
+    if (opts.validate) {
+        let stale = false;
+        for (const [filePath, content] of generated) {
+            if (!existsSync(filePath)) {
+                console.error(`MISSING: ${relative(process.cwd(), filePath)}`);
+                stale = true;
+            }
+            else {
+                const existing = readFileSync(filePath, 'utf-8');
+                if (existing !== content) {
+                    console.error(`STALE: ${relative(process.cwd(), filePath)}`);
+                    stale = true;
+                }
+            }
+        }
+        if (stale) {
+            console.error('\nAPI reference is out of date. Run `refrakt docs extract` to regenerate.');
+            process.exit(1);
+        }
+        else {
+            console.log(`OK: ${generated.size} files up to date (${allSymbols.length} symbols)`);
+        }
+        return;
+    }
+    // Write mode
+    if (!existsSync(outputPath)) {
+        mkdirSync(outputPath, { recursive: true });
+    }
+    let written = 0;
+    for (const [filePath, content] of generated) {
+        const dir = dirname(filePath);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        writeFileSync(filePath, content);
+        written++;
+    }
+    console.log(`Written ${written} files to ${relative(process.cwd(), outputPath)}`);
+}
+//# sourceMappingURL=command.js.map

package/dist/extract/command.js.map

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

package/dist/extract/extractors.d.ts

@@ -0,0 +1,3 @@
+export type { SymbolDoc, SymbolExtractor, ExtractorResult, SymbolKind, SymbolParameter, SymbolReturn, SymbolThrows, SymbolMemberDoc, SymbolGroupDoc, } from './types.js';
+export declare function loadExtractor(lang: 'typescript' | 'python', rootDir: string, sourceUrl?: string): Promise<import('./types.js').SymbolExtractor>;
+//# sourceMappingURL=extractors.d.ts.map

package/dist/extract/extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractors.d.ts","sourceRoot":"","sources":["../../src/extract/extractors.ts"],"names":[],"mappings":"AAAA,YAAY,EACX,SAAS,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EACvD,eAAe,EAAE,YAAY,EAAE,YAAY,EAC3C,eAAe,EAAE,cAAc,GAC/B,MAAM,YAAY,CAAC;AAEpB,wBAAsB,aAAa,CAClC,IAAI,EAAE,YAAY,GAAG,QAAQ,EAC7B,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,YAAY,EAAE,eAAe,CAAC,CAe/C"}

package/dist/extract/extractors.js

@@ -0,0 +1,17 @@
+export async function loadExtractor(lang, rootDir, sourceUrl) {
+    switch (lang) {
+        case 'typescript': {
+            const { TypeScriptExtractor } = await import('./typescript.js');
+            return new TypeScriptExtractor(rootDir, sourceUrl);
+        }
+        case 'python': {
+            const { PythonExtractor } = await import('./python.js');
+            const extractor = new PythonExtractor(rootDir, sourceUrl);
+            await extractor.init();
+            return extractor;
+        }
+        default:
+            throw new Error(`Unsupported language: ${lang}`);
+    }
+}
+//# sourceMappingURL=extractors.js.map

package/dist/extract/extractors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractors.js","sourceRoot":"","sources":["../../src/extract/extractors.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,IAA6B,EAC7B,OAAe,EACf,SAAkB;IAElB,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,YAAY,CAAC,CAAC,CAAC;YACnB,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;YAChE,OAAO,IAAI,mBAAmB,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACf,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;YACxD,MAAM,SAAS,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC1D,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;YACvB,OAAO,SAAS,CAAC;QAClB,CAAC;QACD;YACC,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;AACF,CAAC"}

package/dist/extract/layout-generator.d.ts

@@ -0,0 +1,8 @@
+import type { SymbolDoc } from './types.js';
+export interface LayoutOptions {
+    /** Title for the nav section (default: "API Reference") */
+    title?: string;
+}
+/** Generate a _layout.md with {% nav %} for API reference navigation */
+export declare function generateLayoutMarkdown(symbols: SymbolDoc[], options?: LayoutOptions): string;
+//# sourceMappingURL=layout-generator.d.ts.map

package/dist/extract/layout-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-generator.d.ts","sourceRoot":"","sources":["../../src/extract/layout-generator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,WAAW,aAAa;IAC7B,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wEAAwE;AACxE,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,SAAS,EAAE,EACpB,OAAO,CAAC,EAAE,aAAa,GACrB,MAAM,CAsBR"}

package/dist/extract/layout-generator.js

@@ -0,0 +1,22 @@
+import { toSlug } from './symbol-generator.js';
+/** Generate a _layout.md with {% nav %} for API reference navigation */
+export function generateLayoutMarkdown(symbols, options) {
+    const title = options?.title ?? 'API Reference';
+    const lines = [];
+    lines.push('{% layout %}');
+    lines.push('{% region name="nav" %}');
+    lines.push('{% nav %}');
+    lines.push('');
+    lines.push(`## ${title}`);
+    lines.push('');
+    for (const doc of symbols) {
+        lines.push(`- ${toSlug(doc.name)}`);
+    }
+    lines.push('');
+    lines.push('{% /nav %}');
+    lines.push('{% /region %}');
+    lines.push('{% /layout %}');
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=layout-generator.js.map

package/dist/extract/layout-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-generator.js","sourceRoot":"","sources":["../../src/extract/layout-generator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAO/C,wEAAwE;AACxE,MAAM,UAAU,sBAAsB,CACrC,OAAoB,EACpB,OAAuB;IAEvB,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,eAAe,CAAC;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACtC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,26 @@
+/**
+ * Python docstring parser — supports Google, NumPy, and Sphinx (reST) conventions.
+ * Auto-detects the format and extracts parameters, returns, raises, since, and deprecated.
+ */
+export interface DocstringParam {
+    type: string;
+    description: string;
+}
+export interface DocstringInfo {
+    description: string;
+    params: Map<string, DocstringParam>;
+    returns?: {
+        type: string;
+        description: string;
+    };
+    raises: Array<{
+        type: string;
+        description: string;
+    }>;
+    since?: string;
+    deprecated?: string;
+}
+export type DocstringStyle = 'google' | 'numpy' | 'sphinx' | 'plain';
+export declare function detectStyle(raw: string): DocstringStyle;
+export declare function parseDocstring(raw: string): DocstringInfo;
+//# sourceMappingURL=python-docstring.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"python-docstring.d.ts","sourceRoot":"","sources":["../../src/extract/python-docstring.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACpC,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;AAQrE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAMvD;AAID,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAazD"}