@stevenvo780/st-lang 4.10.0 → 4.12.0

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"}

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

@@ -0,0 +1,140 @@
+"use strict";
+// ============================================================
+// JSDoc/TSDoc parser ligero.
+//
+// Tomamos el rawText de un JSDoc (incluyendo `/** ... */`) o el
+// cuerpo limpio que ya entrega ts.getJSDocCommentRanges, y lo
+// partimos en `description` + lista de `tags`.
+//
+// Soporta tags comunes: @param, @returns/@return, @example,
+// @remarks, @see, @deprecated, @internal, @public, @beta,
+// @experimental.
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripCommentMarkers = stripCommentMarkers;
+exports.parseJSDoc = parseJSDoc;
+exports.parseParamTag = parseParamTag;
+exports.parseReturnsTag = parseReturnsTag;
+/**
+ * Quita los marcadores `/**`, `*\/` y el `*` líder de cada línea
+ * para dejar el contenido textual del comentario.
+ */
+function stripCommentMarkers(raw) {
+    let s = raw.trim();
+    if (s.startsWith('/**'))
+        s = s.slice(3);
+    else if (s.startsWith('/*'))
+        s = s.slice(2);
+    if (s.endsWith('*/'))
+        s = s.slice(0, -2);
+    // Quita el `*` líder por línea (con el espacio opcional).
+    const lines = s.split('\n').map((line) => {
+        const m = /^\s*\*\s?(.*)$/.exec(line);
+        return m ? (m[1] ?? '') : line;
+    });
+    // Trim final pero preservando saltos internos.
+    return lines
+        .join('\n')
+        .replace(/^\s*\n/, '')
+        .replace(/\s+$/, '');
+}
+/**
+ * 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.
+ */
+function parseJSDoc(comment) {
+    const cleaned = comment.includes('/*') ? stripCommentMarkers(comment) : comment;
+    const lines = cleaned.split('\n');
+    const descLines = [];
+    const tags = [];
+    let current = null;
+    const tagOpen = /^@([A-Za-z][A-Za-z0-9_-]*)\s*(.*)$/;
+    for (const raw of lines) {
+        const line = raw.replace(/\r$/, '');
+        const trimmed = line.trimStart();
+        const m = tagOpen.exec(trimmed);
+        if (m) {
+            if (current)
+                tags.push(finalizeTag(current));
+            current = { tag: m[1] ?? '', content: m[2] ?? '' };
+        }
+        else if (current) {
+            current.content += (current.content.length > 0 ? '\n' : '') + line;
+        }
+        else {
+            descLines.push(line);
+        }
+    }
+    if (current)
+        tags.push(finalizeTag(current));
+    return {
+        description: descLines.join('\n').trim(),
+        tags,
+    };
+}
+function finalizeTag(tag) {
+    return {
+        tag: tag.tag,
+        content: tag.content.replace(/\s+$/, '').trim(),
+    };
+}
+/**
+ * `@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.
+ */
+function parseParamTag(content) {
+    // Formato: [{Type}] name[?] - description    (el `-` es opcional)
+    let s = content.trim();
+    // Drop opcional `{Type}` líder.
+    if (s.startsWith('{')) {
+        const end = s.indexOf('}');
+        if (end > 0)
+            s = s.slice(end + 1).trim();
+    }
+    const m = /^(\[?[A-Za-z_$][A-Za-z0-9_$.[\]?=]*\]?)\s*[-:]?\s*([\s\S]*)$/.exec(s);
+    if (!m)
+        return null;
+    const rawName = m[1] ?? '';
+    let name = rawName;
+    let optional = false;
+    if (name.startsWith('[') && name.endsWith(']')) {
+        name = name.slice(1, -1);
+        optional = true;
+    }
+    if (name.endsWith('?')) {
+        name = name.slice(0, -1);
+        optional = true;
+    }
+    // `name=default` → name only
+    const eq = name.indexOf('=');
+    if (eq >= 0) {
+        name = name.slice(0, eq);
+        optional = true;
+    }
+    return {
+        name: name.trim(),
+        description: (m[2] ?? '').trim(),
+        optional,
+    };
+}
+/**
+ * `@returns description` → description string.
+ */
+function parseReturnsTag(content) {
+    let s = content.trim();
+    if (s.startsWith('{')) {
+        const end = s.indexOf('}');
+        if (end > 0)
+            s = s.slice(end + 1).trim();
+    }
+    if (s.startsWith('-'))
+        s = s.slice(1).trim();
+    return s;
+}
+//# sourceMappingURL=jsdoc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jsdoc.js","sourceRoot":"","sources":["../../../src/tooling/doc-gen/jsdoc.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,6BAA6B;AAC7B,EAAE;AACF,gEAAgE;AAChE,8DAA8D;AAC9D,+CAA+C;AAC/C,EAAE;AACF,4DAA4D;AAC5D,0DAA0D;AAC1D,iBAAiB;AACjB,+DAA+D;;AAQ/D,kDAeC;AAUD,gCA6BC;AAeD,sCAkCC;AAKD,0CAQC;AAxHD;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,GAAW;IAC7C,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACnC,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzC,0DAA0D;IAC1D,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACvC,MAAM,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjC,CAAC,CAAC,CAAC;IACH,+CAA+C;IAC/C,OAAO,KAAK;SACT,IAAI,CAAC,IAAI,CAAC;SACV,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,UAAU,CAAC,OAAe;IACxC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IAChF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAElC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAe,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAoB,IAAI,CAAC;IAEpC,MAAM,OAAO,GAAG,oCAAoC,CAAC;IAErD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,CAAC;YACN,IAAI,OAAO;gBAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7C,OAAO,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACrD,CAAC;aAAM,IAAI,OAAO,EAAE,CAAC;YACnB,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,OAAO;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAE7C,OAAO;QACL,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QACxC,IAAI;KACL,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,GAAa;IAChC,OAAO;QACL,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;KAChD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,aAAa,CAC3B,OAAe;IAEf,kEAAkE;IAClE,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,gCAAgC;IAChC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,GAAG,GAAG,CAAC;YAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IACD,MAAM,CAAC,GAAG,8DAA8D,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjF,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,OAAO,CAAC;IACnB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACzB,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACzB,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IACD,6BAA6B;IAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QACZ,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IACD,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAChC,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,OAAe;IAC7C,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IACvB,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,GAAG,GAAG,CAAC;YAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;IACD,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO,CAAC,CAAC;AACX,CAAC"}

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

@@ -0,0 +1,29 @@
+import type { DocModule } from './types';
+/**
+ * Renderiza la documentación a Markdown. La salida es un Map en
+ * el que la clave es la ruta del archivo `.md` correspondiente
+ * (relativa) y el valor es su contenido textual.
+ *
+ * Además del archivo por módulo, se incluye `index.md` con el
+ * overview generado por `renderIndex`.
+ */
+export declare function renderMarkdown(modules: DocModule[]): Map<string, string>;
+/**
+ * Serializa la estructura completa a JSON pretty-printed.
+ *
+ * Útil cuando el consumidor (otro generador, un buscador, un
+ * sitio estático) prefiere consumir la data cruda.
+ */
+export declare function renderJSON(modules: DocModule[]): string;
+/**
+ * Construye un `index.md` resumen con:
+ *  - conteo total de módulos y símbolos
+ *  - tabla por módulo con # de exports y descripción opcional
+ *  - sub-tablas por kind (functions, classes, etc.)
+ */
+export declare function renderIndex(modules: DocModule[]): string;
+/**
+ * `tooling/doc-gen/extract.ts` → `tooling/doc-gen/extract.md`.
+ */
+export declare function toMarkdownPath(modulePath: string): string;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/tooling/doc-gen/render.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAmB,SAAS,EAAE,MAAM,SAAS,CAAC;AAY1D;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAQxE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAEvD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,MAAM,CAoCxD;AAiID;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD"}

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

@@ -0,0 +1,206 @@
+"use strict";
+// ============================================================
+// Renderers — Markdown / JSON / index.
+//
+// renderMarkdown devuelve Map<filePath, contenido>. La clave es
+// relativa (`tooling/doc-gen.md`, `index.md`...) y se compone a
+// partir del modulePath original (sin extensión `.ts`).
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderMarkdown = renderMarkdown;
+exports.renderJSON = renderJSON;
+exports.renderIndex = renderIndex;
+exports.toMarkdownPath = toMarkdownPath;
+const KIND_LABEL = {
+    function: 'Function',
+    class: 'Class',
+    interface: 'Interface',
+    type: 'Type',
+    const: 'Const',
+    enum: 'Enum',
+    namespace: 'Namespace',
+};
+/**
+ * Renderiza la documentación a Markdown. La salida es un Map en
+ * el que la clave es la ruta del archivo `.md` correspondiente
+ * (relativa) y el valor es su contenido textual.
+ *
+ * Además del archivo por módulo, se incluye `index.md` con el
+ * overview generado por `renderIndex`.
+ */
+function renderMarkdown(modules) {
+    const files = new Map();
+    for (const mod of modules) {
+        const outPath = toMarkdownPath(mod.path);
+        files.set(outPath, renderModuleMarkdown(mod));
+    }
+    files.set('index.md', renderIndex(modules));
+    return files;
+}
+/**
+ * Serializa la estructura completa a JSON pretty-printed.
+ *
+ * Útil cuando el consumidor (otro generador, un buscador, un
+ * sitio estático) prefiere consumir la data cruda.
+ */
+function renderJSON(modules) {
+    return JSON.stringify({ modules }, null, 2) + '\n';
+}
+/**
+ * Construye un `index.md` resumen con:
+ *  - conteo total de módulos y símbolos
+ *  - tabla por módulo con # de exports y descripción opcional
+ *  - sub-tablas por kind (functions, classes, etc.)
+ */
+function renderIndex(modules) {
+    const lines = [];
+    const totalSymbols = modules.reduce((acc, m) => acc + m.exports.length, 0);
+    lines.push('# API Reference');
+    lines.push('');
+    lines.push(`> Auto-generado por \`tooling/doc-gen\`.`);
+    lines.push('');
+    lines.push(`- **Modules**: ${modules.length}`);
+    lines.push(`- **Symbols**: ${totalSymbols}`);
+    lines.push('');
+    // Conteo por kind
+    const byKind = countByKind(modules);
+    if (byKind.size > 0) {
+        lines.push('## Symbols by kind');
+        lines.push('');
+        lines.push('| Kind | Count |');
+        lines.push('| ---- | ----- |');
+        for (const [kind, count] of byKind) {
+            lines.push(`| ${KIND_LABEL[kind]} | ${count} |`);
+        }
+        lines.push('');
+    }
+    lines.push('## Modules');
+    lines.push('');
+    lines.push('| Module | Exports | Description |');
+    lines.push('| ------ | ------- | ----------- |');
+    for (const mod of modules) {
+        const link = `[\`${mod.path}\`](./${toMarkdownPath(mod.path)})`;
+        const desc = (mod.description ?? '').replace(/\|/g, '\\|').replace(/\n+/g, ' ');
+        lines.push(`| ${link} | ${mod.exports.length} | ${desc} |`);
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function renderModuleMarkdown(mod) {
+    const lines = [];
+    lines.push(`# \`${mod.path}\``);
+    lines.push('');
+    if (mod.description) {
+        lines.push(mod.description);
+        lines.push('');
+    }
+    // Index intra-módulo
+    if (mod.exports.length > 1) {
+        lines.push('## Contents');
+        lines.push('');
+        for (const sym of mod.exports) {
+            const anchor = slugify(sym.name);
+            const decoration = sym.deprecated ? ' _(deprecated)_' : '';
+            lines.push(`- [\`${sym.name}\`](#${anchor}) — ${KIND_LABEL[sym.kind]}${decoration}`);
+        }
+        lines.push('');
+    }
+    for (const sym of mod.exports) {
+        lines.push(renderSymbol(sym));
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function renderSymbol(sym) {
+    const lines = [];
+    const deprecated = sym.deprecated ? ' ⚠️ DEPRECATED' : '';
+    lines.push(`## \`${sym.name}\`${deprecated}`);
+    lines.push('');
+    lines.push(`> ${KIND_LABEL[sym.kind]} · \`${sym.module}:${sym.lineNumber}\``);
+    lines.push('');
+    if (sym.deprecated) {
+        lines.push('> **Deprecated.** No usar en código nuevo.');
+        lines.push('');
+    }
+    if (sym.description) {
+        lines.push(sym.description);
+        lines.push('');
+    }
+    if (sym.signature) {
+        lines.push('```ts');
+        lines.push(sym.signature);
+        lines.push('```');
+        lines.push('');
+    }
+    if (sym.parameters && sym.parameters.length > 0) {
+        lines.push('### Parameters');
+        lines.push('');
+        lines.push('| Name | Type | Optional | Description |');
+        lines.push('| ---- | ---- | -------- | ----------- |');
+        for (const p of sym.parameters) {
+            const desc = p.description.replace(/\|/g, '\\|').replace(/\n+/g, ' ');
+            lines.push(`| \`${p.name}\` | \`${escapeMd(p.type)}\` | ${p.optional ? 'yes' : 'no'} | ${desc} |`);
+        }
+        lines.push('');
+    }
+    if (sym.returns) {
+        lines.push('### Returns');
+        lines.push('');
+        lines.push(`\`${escapeMd(sym.returns.type)}\` — ${sym.returns.description}`);
+        lines.push('');
+    }
+    if (sym.examples && sym.examples.length > 0) {
+        lines.push('### Examples');
+        lines.push('');
+        for (const ex of sym.examples) {
+            lines.push(renderExample(ex));
+        }
+    }
+    if (sym.remarks) {
+        lines.push('### Remarks');
+        lines.push('');
+        lines.push(sym.remarks);
+        lines.push('');
+    }
+    if (sym.see && sym.see.length > 0) {
+        lines.push('### See also');
+        lines.push('');
+        for (const s of sym.see) {
+            lines.push(`- ${s}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+function renderExample(ex) {
+    // Si el example ya viene con su propio fence, respétalo.
+    if (/```/.test(ex)) {
+        return ex.trim() + '\n';
+    }
+    return ['```ts', ex.trim(), '```', ''].join('\n');
+}
+function countByKind(modules) {
+    const out = new Map();
+    for (const m of modules) {
+        for (const sym of m.exports) {
+            out.set(sym.kind, (out.get(sym.kind) ?? 0) + 1);
+        }
+    }
+    return out;
+}
+function escapeMd(s) {
+    return s.replace(/\|/g, '\\|').replace(/\n+/g, ' ');
+}
+function slugify(s) {
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+/**
+ * `tooling/doc-gen/extract.ts` → `tooling/doc-gen/extract.md`.
+ */
+function toMarkdownPath(modulePath) {
+    return modulePath.replace(/\.ts$/, '.md');
+}
+//# sourceMappingURL=render.js.map

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

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