@stevenvo780/st-lang 4.11.0 → 4.12.0

package/dist/tooling/doc-gen/extract.js

@@ -0,0 +1,379 @@
+"use strict";
+// ============================================================
+// Extractor — recorre los `.ts` de un rootDir con el TS Compiler
+// API y construye un DocModule[] con todos los símbolos exportados
+// (top-level) más su JSDoc/TSDoc asociado.
+//
+// Skip:
+//  - archivos de tests (`*.test.ts`, `src/tests/**`)
+//  - `index.ts` SIN re-export con doc propio (igual lo escaneamos,
+//    pero los re-exports sin doc no entran como ApiDoc — typescript
+//    los exporta sin nodo de declaración local).
+//  - símbolos no exportados, salvo `includeInternal: true`.
+// ============================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractDocs = extractDocs;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const typescript_1 = __importDefault(require("typescript"));
+const jsdoc_1 = require("./jsdoc");
+/**
+ * Entrada principal. Recorre `rootDir` recursivamente, parsea cada
+ * archivo `.ts` y devuelve un `DocModule` por archivo con contenido.
+ *
+ * Archivos sin exports documentados se omiten (no aparecen en el
+ * resultado) para mantener el output compacto.
+ */
+function extractDocs(rootDir, opts = {}) {
+    const includeInternal = opts.includeInternal === true;
+    const absRoot = path.resolve(rootDir);
+    const files = collectTsFiles(absRoot);
+    const modules = [];
+    for (const file of files) {
+        const source = fs.readFileSync(file, 'utf8');
+        const sf = typescript_1.default.createSourceFile(file, source, typescript_1.default.ScriptTarget.ES2022, true, typescript_1.default.ScriptKind.TS);
+        const moduleRelPath = path.relative(absRoot, file).replace(/\\/g, '/');
+        const description = extractFileLevelDescription(sf, source);
+        const exports = extractFromSourceFile(sf, source, moduleRelPath, file, includeInternal);
+        if (exports.length === 0 && !description)
+            continue;
+        modules.push({
+            path: moduleRelPath,
+            description,
+            exports,
+        });
+    }
+    modules.sort((a, b) => a.path.localeCompare(b.path));
+    return modules;
+}
+function collectTsFiles(root) {
+    const out = [];
+    const stack = [root];
+    while (stack.length) {
+        const dir = stack.pop();
+        if (!dir)
+            continue;
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const ent of entries) {
+            const full = path.join(dir, ent.name);
+            if (ent.isDirectory()) {
+                if (ent.name === 'node_modules' || ent.name === 'dist' || ent.name.startsWith('.')) {
+                    continue;
+                }
+                if (ent.name === 'tests' || ent.name === '__tests__')
+                    continue;
+                stack.push(full);
+            }
+            else if (ent.isFile()) {
+                if (!ent.name.endsWith('.ts'))
+                    continue;
+                if (ent.name.endsWith('.d.ts'))
+                    continue;
+                if (ent.name.endsWith('.test.ts') || ent.name.endsWith('.spec.ts'))
+                    continue;
+                out.push(full);
+            }
+        }
+    }
+    out.sort();
+    return out;
+}
+function extractFileLevelDescription(sf, source) {
+    // Busca un bloque `/** ... */` que aparezca antes de la primera declaración.
+    const firstStatement = sf.statements[0];
+    const upTo = firstStatement ? firstStatement.getStart(sf) : source.length;
+    const head = source.slice(0, upTo);
+    const m = /\/\*\*([\s\S]*?)\*\//.exec(head);
+    if (!m) {
+        // También aceptamos comentarios `//` consecutivos al inicio.
+        const lines = head.split('\n');
+        const desc = [];
+        for (const line of lines) {
+            const t = line.trim();
+            if (t.startsWith('//')) {
+                const body = t.replace(/^\/+\s?/, '');
+                if (body)
+                    desc.push(body);
+            }
+            else if (t === '') {
+                if (desc.length > 0)
+                    continue;
+            }
+            else {
+                break;
+            }
+        }
+        if (desc.length === 0)
+            return undefined;
+        return desc.join(' ').trim() || undefined;
+    }
+    const cleaned = (0, jsdoc_1.stripCommentMarkers)(m[0]);
+    const parsed = (0, jsdoc_1.parseJSDoc)(cleaned);
+    // Si hay tag @fileoverview úsalo, si no, la description del bloque.
+    const fov = parsed.tags.find((t) => t.tag === 'fileoverview' || t.tag === 'file');
+    const desc = fov ? fov.content : parsed.description;
+    return desc.trim() || undefined;
+}
+function extractFromSourceFile(sf, source, modulePath, filePath, includeInternal) {
+    const ctx = {
+        source,
+        sf,
+        modulePath,
+        filePath,
+        includeInternal,
+        out: [],
+    };
+    for (const stmt of sf.statements) {
+        visitTopLevel(stmt, ctx);
+    }
+    return ctx.out;
+}
+function visitTopLevel(node, ctx) {
+    const exported = hasExportModifier(node);
+    if (!exported && !ctx.includeInternal)
+        return;
+    if (typescript_1.default.isFunctionDeclaration(node) && node.name) {
+        pushDoc(ctx, node, node.name.text, 'function');
+        return;
+    }
+    if (typescript_1.default.isClassDeclaration(node) && node.name) {
+        pushDoc(ctx, node, node.name.text, 'class');
+        return;
+    }
+    if (typescript_1.default.isInterfaceDeclaration(node)) {
+        pushDoc(ctx, node, node.name.text, 'interface');
+        return;
+    }
+    if (typescript_1.default.isTypeAliasDeclaration(node)) {
+        pushDoc(ctx, node, node.name.text, 'type');
+        return;
+    }
+    if (typescript_1.default.isEnumDeclaration(node)) {
+        pushDoc(ctx, node, node.name.text, 'enum');
+        return;
+    }
+    if (typescript_1.default.isModuleDeclaration(node) && node.name) {
+        const name = typescript_1.default.isIdentifier(node.name) ? node.name.text : node.name.text;
+        pushDoc(ctx, node, name, 'namespace');
+        return;
+    }
+    if (typescript_1.default.isVariableStatement(node)) {
+        for (const decl of node.declarationList.declarations) {
+            if (decl.name && typescript_1.default.isIdentifier(decl.name)) {
+                pushDoc(ctx, node, decl.name.text, 'const', decl);
+            }
+        }
+        return;
+    }
+}
+function hasExportModifier(node) {
+    const mods = node.modifiers;
+    if (!mods)
+        return false;
+    return mods.some((m) => m.kind === typescript_1.default.SyntaxKind.ExportKeyword);
+}
+function pushDoc(ctx, node, name, kind, detailNode) {
+    const exported = hasExportModifier(node);
+    const jsdoc = getJSDocFor(node, ctx.source);
+    const parsed = jsdoc ? (0, jsdoc_1.parseJSDoc)(jsdoc) : { description: '', tags: [] };
+    // @internal filter (cuando no se solicitó includeInternal)
+    if (!ctx.includeInternal && parsed.tags.some((t) => t.tag === 'internal'))
+        return;
+    const target = detailNode ?? node;
+    const signature = buildSignature(target, ctx.source);
+    const { line } = ctx.sf.getLineAndCharacterOfPosition(node.getStart(ctx.sf));
+    const doc = {
+        name,
+        kind,
+        description: parsed.description,
+        signature,
+        module: ctx.modulePath,
+        filePath: ctx.filePath,
+        lineNumber: line + 1,
+        exported,
+    };
+    const params = collectParameters(node, parsed);
+    if (params && params.length > 0)
+        doc.parameters = params;
+    const returns = collectReturns(node, parsed);
+    if (returns)
+        doc.returns = returns;
+    const examples = parsed.tags.filter((t) => t.tag === 'example').map((t) => t.content);
+    if (examples.length > 0)
+        doc.examples = examples;
+    const remarks = parsed.tags.find((t) => t.tag === 'remarks');
+    if (remarks)
+        doc.remarks = remarks.content;
+    const see = parsed.tags.filter((t) => t.tag === 'see').map((t) => t.content);
+    if (see.length > 0)
+        doc.see = see;
+    const deprecated = parsed.tags.find((t) => t.tag === 'deprecated');
+    if (deprecated)
+        doc.deprecated = true;
+    ctx.out.push(doc);
+}
+function getJSDocFor(node, source) {
+    // ts ofrece getJSDocCommentRanges sólo en internal API, usamos
+    // getLeadingCommentRanges + filtramos los que sean `/** ... */`.
+    const fullStart = node.getFullStart();
+    const ranges = typescript_1.default.getLeadingCommentRanges(source, fullStart);
+    if (!ranges || ranges.length === 0)
+        return undefined;
+    // El último range pegado al nodo es el "su" JSDoc.
+    const last = ranges[ranges.length - 1];
+    if (!last)
+        return undefined;
+    const raw = source.slice(last.pos, last.end);
+    if (!raw.startsWith('/**'))
+        return undefined;
+    return raw;
+}
+function buildSignature(node, source) {
+    // Para functions: hasta el final del header (signo `{` o `;`).
+    if (typescript_1.default.isFunctionDeclaration(node) || typescript_1.default.isMethodDeclaration(node)) {
+        return signatureFromFunctionLike(node, source);
+    }
+    if (typescript_1.default.isClassDeclaration(node)) {
+        // Solo el header `export class X<T> extends Y implements Z`.
+        const start = node.getStart();
+        const body = node.members.length > 0 ? node.members[0]?.getFullStart() : node.getEnd();
+        const headEnd = source.indexOf('{', start);
+        const end = headEnd > 0 ? headEnd : (body ?? node.getEnd());
+        return collapseWhitespace(source.slice(start, end));
+    }
+    if (typescript_1.default.isInterfaceDeclaration(node)) {
+        const start = node.getStart();
+        const headEnd = source.indexOf('{', start);
+        const end = headEnd > 0 ? headEnd : node.getEnd();
+        return collapseWhitespace(source.slice(start, end));
+    }
+    if (typescript_1.default.isTypeAliasDeclaration(node)) {
+        return collapseWhitespace(source.slice(node.getStart(), node.getEnd()));
+    }
+    if (typescript_1.default.isEnumDeclaration(node)) {
+        const start = node.getStart();
+        const headEnd = source.indexOf('{', start);
+        const end = headEnd > 0 ? headEnd : node.getEnd();
+        return collapseWhitespace(source.slice(start, end));
+    }
+    if (typescript_1.default.isVariableDeclaration(node)) {
+        // Reconstruye `const name: Type = ...` recortando inicializadores largos.
+        const name = node.name.getText();
+        const typeText = node.type ? `: ${node.type.getText()}` : '';
+        return `const ${name}${typeText}`;
+    }
+    if (typescript_1.default.isModuleDeclaration(node)) {
+        const start = node.getStart();
+        const headEnd = source.indexOf('{', start);
+        const end = headEnd > 0 ? headEnd : node.getEnd();
+        return collapseWhitespace(source.slice(start, end));
+    }
+    return collapseWhitespace(source.slice(node.getStart(), node.getEnd()));
+}
+function signatureFromFunctionLike(node, source) {
+    const start = node.getStart();
+    const bodyStart = node.body ? node.body.getFullStart() : node.getEnd();
+    let end = bodyStart;
+    // Recorta el `{` que abre el body.
+    const semi = source.lastIndexOf(';', end);
+    const brace = source.lastIndexOf('{', end);
+    if (brace > start)
+        end = brace;
+    else if (semi > start)
+        end = semi + 1;
+    return collapseWhitespace(source.slice(start, end));
+}
+function collapseWhitespace(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+function collectParameters(node, parsed) {
+    let parameters;
+    if (typescript_1.default.isFunctionDeclaration(node) || typescript_1.default.isMethodDeclaration(node)) {
+        parameters = node.parameters;
+    }
+    else {
+        return undefined;
+    }
+    const paramTags = new Map();
+    for (const t of parsed.tags) {
+        if (t.tag !== 'param')
+            continue;
+        const parsedParam = (0, jsdoc_1.parseParamTag)(t.content);
+        if (parsedParam) {
+            paramTags.set(parsedParam.name, {
+                description: parsedParam.description,
+                optional: parsedParam.optional,
+            });
+        }
+    }
+    const out = [];
+    for (const p of parameters) {
+        const name = p.name.getText();
+        const type = p.type ? p.type.getText() : 'any';
+        const tag = paramTags.get(name);
+        out.push({
+            name,
+            type,
+            description: tag?.description ?? '',
+            optional: Boolean(p.questionToken) || tag?.optional === true || p.initializer != null,
+        });
+    }
+    return out;
+}
+function collectReturns(node, parsed) {
+    let typeText;
+    if ((typescript_1.default.isFunctionDeclaration(node) || typescript_1.default.isMethodDeclaration(node)) &&
+        node.type) {
+        typeText = node.type.getText();
+    }
+    const tag = parsed.tags.find((t) => t.tag === 'returns' || t.tag === 'return');
+    if (!typeText && !tag)
+        return undefined;
+    return {
+        type: typeText ?? 'unknown',
+        description: tag ? (0, jsdoc_1.parseReturnsTag)(tag.content) : '',
+    };
+}
+//# sourceMappingURL=extract.js.map

package/dist/tooling/doc-gen/extract.js.map

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

package/dist/tooling/doc-gen/generate.d.ts

@@ -0,0 +1,9 @@
+import type { DocOptions, GenerateResult } from './types';
+/**
+ * Genera documentación a disco según `opts.template`. Crea
+ * `outputDir` y subdirectorios necesarios.
+ *
+ * El default cuando `template` no se especifica es `'markdown'`.
+ */
+export declare function generateDocs(opts: DocOptions): Promise<GenerateResult>;
+//# sourceMappingURL=generate.d.ts.map

package/dist/tooling/doc-gen/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/tooling/doc-gen/generate.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAa,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAErE;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CA8B5E"}

package/dist/tooling/doc-gen/generate.js

@@ -0,0 +1,116 @@
+"use strict";
+// ============================================================
+// generateDocs — glue.
+//
+// extractDocs → render(markdown|json|html-minimal) → escribe a
+// outputDir, devolviendo lista de archivos y warnings detectados
+// durante el proceso (símbolos sin descripción, etc.).
+// ============================================================
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateDocs = generateDocs;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const extract_1 = require("./extract");
+const render_1 = require("./render");
+/**
+ * Genera documentación a disco según `opts.template`. Crea
+ * `outputDir` y subdirectorios necesarios.
+ *
+ * El default cuando `template` no se especifica es `'markdown'`.
+ */
+async function generateDocs(opts) {
+    const includeInternal = opts.includeInternal === true;
+    const modules = (0, extract_1.extractDocs)(opts.rootDir, { includeInternal });
+    const template = opts.template ?? 'markdown';
+    const warnings = collectWarnings(modules);
+    const filesWritten = [];
+    await fs.mkdir(opts.outputDir, { recursive: true });
+    if (template === 'markdown') {
+        const files = (0, render_1.renderMarkdown)(modules);
+        for (const [relPath, content] of files) {
+            const abs = path.join(opts.outputDir, relPath);
+            await fs.mkdir(path.dirname(abs), { recursive: true });
+            await fs.writeFile(abs, content, 'utf8');
+            filesWritten.push(abs);
+        }
+    }
+    else if (template === 'json') {
+        const abs = path.join(opts.outputDir, 'api.json');
+        await fs.writeFile(abs, (0, render_1.renderJSON)(modules), 'utf8');
+        filesWritten.push(abs);
+    }
+    else if (template === 'html-minimal') {
+        const indexHtml = renderHtmlMinimal(modules);
+        const abs = path.join(opts.outputDir, 'index.html');
+        await fs.writeFile(abs, indexHtml, 'utf8');
+        filesWritten.push(abs);
+    }
+    return { filesWritten, warnings };
+}
+function collectWarnings(modules) {
+    const out = [];
+    for (const mod of modules) {
+        for (const sym of mod.exports) {
+            if (!sym.description) {
+                out.push(`${mod.path}:${sym.lineNumber}: ${sym.kind} \`${sym.name}\` sin descripción`);
+            }
+        }
+    }
+    return out;
+}
+function renderHtmlMinimal(modules) {
+    const md = (0, render_1.renderIndex)(modules);
+    // Minimal HTML que embebe el index como <pre>. Útil para preview
+    // rápida sin pipeline de Markdown.
+    const escaped = md.replace(/[&<>]/g, (c) => {
+        if (c === '&')
+            return '&amp;';
+        if (c === '<')
+            return '&lt;';
+        return '&gt;';
+    });
+    return [
+        '<!doctype html>',
+        '<html lang="en">',
+        '<head><meta charset="utf-8"><title>API Reference</title></head>',
+        '<body><pre style="font:14px/1.4 monospace">',
+        escaped,
+        '</pre></body>',
+        '</html>',
+        '',
+    ].join('\n');
+}
+//# sourceMappingURL=generate.js.map

package/dist/tooling/doc-gen/generate.js.map

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

package/dist/tooling/doc-gen/index.d.ts

@@ -0,0 +1,7 @@
+export type { ApiDoc, ApiKind, ApiParameter, ApiReturns, DocModule, DocOptions, GenerateResult, JSDocTag, ParsedJSDoc, } from './types';
+export { parseJSDoc, parseParamTag, parseReturnsTag, stripCommentMarkers } from './jsdoc';
+export { extractDocs } from './extract';
+export type { ExtractOptions } from './extract';
+export { renderMarkdown, renderJSON, renderIndex, toMarkdownPath } from './render';
+export { generateDocs } from './generate';
+//# sourceMappingURL=index.d.ts.map

package/dist/tooling/doc-gen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tooling/doc-gen/index.ts"],"names":[],"mappings":"AAsBA,YAAY,EACV,MAAM,EACN,OAAO,EACP,YAAY,EACZ,UAAU,EACV,SAAS,EACT,UAAU,EACV,cAAc,EACd,QAAQ,EACR,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC1F,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/tooling/doc-gen/index.js

@@ -0,0 +1,39 @@
+"use strict";
+// ============================================================
+// ST doc-gen — generador de documentación de API.
+//
+// Toma JSDoc/TSDoc de fuentes TypeScript usando el TS Compiler
+// API y produce Markdown (o JSON, o HTML minimal) por módulo.
+//
+// Uso típico:
+//
+// ```ts
+// import { generateDocs } from '@stevenvo780/st-lang/tooling/doc-gen';
+// await generateDocs({
+//   rootDir: 'src',
+//   outputDir: 'docs/api',
+//   template: 'markdown',
+// });
+// ```
+//
+// La librería NO empaqueta a `dist/` un binario CLI; la idea es
+// invocarla desde scripts (`scripts/build-docs.mjs`) o desde un
+// task externo.
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateDocs = exports.toMarkdownPath = exports.renderIndex = exports.renderJSON = exports.renderMarkdown = exports.extractDocs = exports.stripCommentMarkers = exports.parseReturnsTag = exports.parseParamTag = exports.parseJSDoc = void 0;
+var jsdoc_1 = require("./jsdoc");
+Object.defineProperty(exports, "parseJSDoc", { enumerable: true, get: function () { return jsdoc_1.parseJSDoc; } });
+Object.defineProperty(exports, "parseParamTag", { enumerable: true, get: function () { return jsdoc_1.parseParamTag; } });
+Object.defineProperty(exports, "parseReturnsTag", { enumerable: true, get: function () { return jsdoc_1.parseReturnsTag; } });
+Object.defineProperty(exports, "stripCommentMarkers", { enumerable: true, get: function () { return jsdoc_1.stripCommentMarkers; } });
+var extract_1 = require("./extract");
+Object.defineProperty(exports, "extractDocs", { enumerable: true, get: function () { return extract_1.extractDocs; } });
+var render_1 = require("./render");
+Object.defineProperty(exports, "renderMarkdown", { enumerable: true, get: function () { return render_1.renderMarkdown; } });
+Object.defineProperty(exports, "renderJSON", { enumerable: true, get: function () { return render_1.renderJSON; } });
+Object.defineProperty(exports, "renderIndex", { enumerable: true, get: function () { return render_1.renderIndex; } });
+Object.defineProperty(exports, "toMarkdownPath", { enumerable: true, get: function () { return render_1.toMarkdownPath; } });
+var generate_1 = require("./generate");
+Object.defineProperty(exports, "generateDocs", { enumerable: true, get: function () { return generate_1.generateDocs; } });
+//# sourceMappingURL=index.js.map

package/dist/tooling/doc-gen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tooling/doc-gen/index.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,kDAAkD;AAClD,EAAE;AACF,+DAA+D;AAC/D,8DAA8D;AAC9D,EAAE;AACF,cAAc;AACd,EAAE;AACF,QAAQ;AACR,uEAAuE;AACvE,uBAAuB;AACvB,oBAAoB;AACpB,2BAA2B;AAC3B,0BAA0B;AAC1B,MAAM;AACN,MAAM;AACN,EAAE;AACF,gEAAgE;AAChE,gEAAgE;AAChE,gBAAgB;AAChB,+DAA+D;;;AAc/D,iCAA0F;AAAjF,mGAAA,UAAU,OAAA;AAAE,sGAAA,aAAa,OAAA;AAAE,wGAAA,eAAe,OAAA;AAAE,4GAAA,mBAAmB,OAAA;AACxE,qCAAwC;AAA/B,sGAAA,WAAW,OAAA;AAEpB,mCAAmF;AAA1E,wGAAA,cAAc,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,wGAAA,cAAc,OAAA;AAChE,uCAA0C;AAAjC,wGAAA,YAAY,OAAA"}

package/dist/tooling/doc-gen/jsdoc.d.ts

@@ -0,0 +1,31 @@
+import type { ParsedJSDoc } from './types';
+/**
+ * Quita los marcadores `/**`, `*\/` y el `*` líder de cada línea
+ * para dejar el contenido textual del comentario.
+ */
+export declare function stripCommentMarkers(raw: string): string;
+/**
+ * Parsea un comentario JSDoc/TSDoc en `description` + `tags`.
+ * Acepta tanto el raw con `/** ... *\/` como el contenido ya limpio.
+ *
+ * Cada tag se reconoce con la heurística clásica de TypeDoc/TSDoc:
+ * una línea que empieza con `@<word>` abre un nuevo tag y consume
+ * todas las líneas siguientes hasta el próximo `@<word>` o EOF.
+ */
+export declare function parseJSDoc(comment: string): ParsedJSDoc;
+/**
+ * `@param name description` → { name, description, optional }.
+ *
+ * También soporta el formato con tipo `@param {Type} name desc` aunque
+ * los tipos reales los tomamos del compilador, no del JSDoc.
+ */
+export declare function parseParamTag(content: string): {
+    name: string;
+    description: string;
+    optional: boolean;
+} | null;
+/**
+ * `@returns description` → description string.
+ */
+export declare function parseReturnsTag(content: string): string;
+//# sourceMappingURL=jsdoc.d.ts.map

package/dist/tooling/doc-gen/jsdoc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsdoc.d.ts","sourceRoot":"","sources":["../../../src/tooling/doc-gen/jsdoc.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAY,WAAW,EAAE,MAAM,SAAS,CAAC;AAErD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAevD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,CA6BvD;AASD;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,GACd;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAgCjE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQvD"}