@stevenvo780/st-lang 4.10.0 → 4.12.0

package/dist/tests/tooling/test-harness/test-harness.test.js

@@ -0,0 +1,208 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const test_harness_1 = require("../../../tooling/test-harness");
+function suiteA() {
+    return (0, test_harness_1.makeSuite)('A', [
+        { name: 'a1', input: 1, tags: ['fast'] },
+        { name: 'a2', input: 2, tags: ['slow'] },
+        { name: 'a3', input: 3, tags: ['fast', 'edge'] }
+    ]);
+}
+function suiteB() {
+    return (0, test_harness_1.makeSuite)('B', [
+        { name: 'b1', input: 'x', tags: ['fast'] },
+        { name: 'b2', input: 'y', tags: ['slow'] }
+    ]);
+}
+(0, vitest_1.describe)('test-harness combinators', () => {
+    (0, vitest_1.it)('crossProduct cartesian 3x2 produces 6 cases', () => {
+        const result = (0, test_harness_1.crossProduct)(suiteA(), suiteB(), { combine: 'cartesian' });
+        (0, vitest_1.expect)(result.cases).toHaveLength(6);
+        (0, vitest_1.expect)(result.name).toBe('A × B');
+        const names = result.cases.map((c) => c.name);
+        (0, vitest_1.expect)(names).toContain('a1 × b1');
+        (0, vitest_1.expect)(names).toContain('a3 × b2');
+    });
+    (0, vitest_1.it)('crossProduct intersect keeps only shared-tag pairs', () => {
+        const result = (0, test_harness_1.crossProduct)(suiteA(), suiteB(), { combine: 'intersect' });
+        // shared tag pairs: a1(fast)×b1(fast), a2(slow)×b2(slow), a3(fast,edge)×b1(fast)
+        (0, vitest_1.expect)(result.cases).toHaveLength(3);
+        const names = result.cases.map((c) => c.name).sort();
+        (0, vitest_1.expect)(names).toEqual(['a1 × b1', 'a2 × b2', 'a3 × b1']);
+    });
+    (0, vitest_1.it)('crossProduct respects filterTags', () => {
+        const result = (0, test_harness_1.crossProduct)(suiteA(), suiteB(), {
+            combine: 'cartesian',
+            filterTags: ['edge']
+        });
+        // only a3 has 'edge', combined with b1 and b2 → 2 cases
+        (0, vitest_1.expect)(result.cases).toHaveLength(2);
+        for (const c of result.cases) {
+            (0, vitest_1.expect)(c.tags ?? []).toContain('edge');
+        }
+    });
+    (0, vitest_1.it)('parameterize multiplies cases by params length', () => {
+        const params = ['p1', 'p2', 'p3'];
+        const result = (0, test_harness_1.parameterize)(suiteA(), [...params]);
+        (0, vitest_1.expect)(result.cases).toHaveLength(suiteA().cases.length * params.length);
+        const first = result.cases[0];
+        (0, vitest_1.expect)(first).toBeDefined();
+        if (first) {
+            (0, vitest_1.expect)(first.input.param).toBe('p1');
+            (0, vitest_1.expect)(first.input.input).toBe(1);
+        }
+    });
+    (0, vitest_1.it)('filter by predicate keeps matching cases', () => {
+        const filtered = (0, test_harness_1.filter)(suiteA(), (c) => c.input >= 2);
+        (0, vitest_1.expect)(filtered.cases.map((c) => c.input)).toEqual([2, 3]);
+    });
+    (0, vitest_1.it)('filterByTags returns only cases with at least one matching tag', () => {
+        const filtered = (0, test_harness_1.filterByTags)(suiteA(), ['edge']);
+        (0, vitest_1.expect)(filtered.cases).toHaveLength(1);
+        (0, vitest_1.expect)(filtered.cases[0]?.name).toBe('a3');
+    });
+    (0, vitest_1.it)('tag merges new tags onto cases without duplicates', () => {
+        const tagged = (0, test_harness_1.tag)(suiteA(), (c) => (c.input % 2 === 0 ? ['even'] : ['odd']));
+        const a1 = tagged.cases.find((c) => c.name === 'a1');
+        const a2 = tagged.cases.find((c) => c.name === 'a2');
+        const a3 = tagged.cases.find((c) => c.name === 'a3');
+        (0, vitest_1.expect)(a1?.tags).toContain('odd');
+        (0, vitest_1.expect)(a1?.tags).toContain('fast');
+        (0, vitest_1.expect)(a2?.tags).toContain('even');
+        (0, vitest_1.expect)(a3?.tags).toEqual(vitest_1.expect.arrayContaining(['fast', 'edge', 'odd']));
+    });
+});
+(0, vitest_1.describe)('test-harness generators', () => {
+    (0, vitest_1.it)('nats yields 0..max inclusive', () => {
+        (0, vitest_1.expect)((0, test_harness_1.toArray)((0, test_harness_1.nats)(4))).toEqual([0, 1, 2, 3, 4]);
+        (0, vitest_1.expect)((0, test_harness_1.toArray)((0, test_harness_1.nats)(0))).toEqual([0]);
+        (0, vitest_1.expect)((0, test_harness_1.toArray)((0, test_harness_1.nats)(-1))).toEqual([]);
+    });
+    (0, vitest_1.it)('range supports positive and negative steps', () => {
+        (0, vitest_1.expect)((0, test_harness_1.toArray)((0, test_harness_1.range)(0, 5))).toEqual([0, 1, 2, 3, 4]);
+        (0, vitest_1.expect)((0, test_harness_1.toArray)((0, test_harness_1.range)(0, 10, 3))).toEqual([0, 3, 6, 9]);
+        (0, vitest_1.expect)((0, test_harness_1.toArray)((0, test_harness_1.range)(5, 0, -1))).toEqual([5, 4, 3, 2, 1]);
+        (0, vitest_1.expect)((0, test_harness_1.toArray)((0, test_harness_1.range)(0, 5, 0))).toEqual([]);
+    });
+    (0, vitest_1.it)('randomInts is deterministic with the same seed', () => {
+        const a = (0, test_harness_1.toArray)((0, test_harness_1.randomInts)(42, 10, 1000));
+        const b = (0, test_harness_1.toArray)((0, test_harness_1.randomInts)(42, 10, 1000));
+        const c = (0, test_harness_1.toArray)((0, test_harness_1.randomInts)(43, 10, 1000));
+        (0, vitest_1.expect)(a).toEqual(b);
+        (0, vitest_1.expect)(a).not.toEqual(c);
+        (0, vitest_1.expect)(a).toHaveLength(10);
+        for (const v of a) {
+            (0, vitest_1.expect)(v).toBeGreaterThanOrEqual(0);
+            (0, vitest_1.expect)(v).toBeLessThan(1000);
+            (0, vitest_1.expect)(Number.isInteger(v)).toBe(true);
+        }
+    });
+    (0, vitest_1.it)('take limits an iterable to n elements', () => {
+        (0, vitest_1.expect)((0, test_harness_1.take)((0, test_harness_1.nats)(100), 3)).toEqual([0, 1, 2]);
+        (0, vitest_1.expect)((0, test_harness_1.take)((0, test_harness_1.nats)(100), 0)).toEqual([]);
+    });
+});
+(0, vitest_1.describe)('test-harness coverage', () => {
+    (0, vitest_1.it)('runWithCoverage counts passing/failing/errored and tag distribution', async () => {
+        const suite = (0, test_harness_1.makeSuite)('mix', [
+            { name: 'ok1', input: 1, tags: ['pos'] },
+            { name: 'ok2', input: 2, tags: ['pos', 'even'] },
+            { name: 'bad', input: -1, tags: ['neg'] },
+            { name: 'boom', input: 0, tags: ['zero'] }
+        ]);
+        const report = await (0, test_harness_1.runWithCoverage)(suite, async (c) => {
+            if (c.name === 'boom')
+                throw new Error('explode');
+            return c.input > 0;
+        });
+        (0, vitest_1.expect)(report.totalCases).toBe(4);
+        (0, vitest_1.expect)(report.passing).toBe(2);
+        (0, vitest_1.expect)(report.failing).toBe(1);
+        (0, vitest_1.expect)(report.errored).toBe(1);
+        (0, vitest_1.expect)(report.tagDistribution.get('pos')).toBe(2);
+        (0, vitest_1.expect)(report.tagDistribution.get('even')).toBe(1);
+        (0, vitest_1.expect)(report.tagDistribution.get('neg')).toBe(1);
+        (0, vitest_1.expect)(report.tagDistribution.get('zero')).toBe(1);
+    });
+    (0, vitest_1.it)('runWithCoverage on empty suite returns zeros', async () => {
+        const empty = (0, test_harness_1.makeSuite)('empty', []);
+        const report = await (0, test_harness_1.runWithCoverage)(empty, async () => true);
+        (0, vitest_1.expect)(report.totalCases).toBe(0);
+        (0, vitest_1.expect)(report.passing).toBe(0);
+        (0, vitest_1.expect)(report.failing).toBe(0);
+        (0, vitest_1.expect)(report.errored).toBe(0);
+        (0, vitest_1.expect)(report.tagDistribution.size).toBe(0);
+    });
+});
+(0, vitest_1.describe)('test-harness snapshot', () => {
+    (0, vitest_1.it)('snapshotHash is deterministic across key order', () => {
+        const h1 = (0, test_harness_1.snapshotHash)({ a: 1, b: 2 }, { x: [1, 2, 3] });
+        const h2 = (0, test_harness_1.snapshotHash)({ b: 2, a: 1 }, { x: [1, 2, 3] });
+        (0, vitest_1.expect)(h1).toBe(h2);
+        (0, vitest_1.expect)(h1).toMatch(/^[0-9a-f]{8}$/);
+    });
+    (0, vitest_1.it)('takeSnapshot returns a stable hash and stores input/output', () => {
+        const snap = (0, test_harness_1.takeSnapshot)({ q: 'hola' }, { ok: true, n: 7 });
+        (0, vitest_1.expect)(snap.hash).toMatch(/^[0-9a-f]{8}$/);
+        (0, vitest_1.expect)(snap.input).toEqual({ q: 'hola' });
+        (0, vitest_1.expect)(snap.output).toEqual({ ok: true, n: 7 });
+        const again = (0, test_harness_1.takeSnapshot)({ q: 'hola' }, { ok: true, n: 7 });
+        (0, vitest_1.expect)(again.hash).toBe(snap.hash);
+    });
+    (0, vitest_1.it)('compareSnapshot detects matches and diffs', () => {
+        const snap = (0, test_harness_1.takeSnapshot)({ name: 'p' }, { score: 10 });
+        (0, vitest_1.expect)((0, test_harness_1.compareSnapshot)(snap, { score: 10 })).toEqual({ match: true });
+        const cmp = (0, test_harness_1.compareSnapshot)(snap, { score: 11 });
+        (0, vitest_1.expect)(cmp.match).toBe(false);
+        (0, vitest_1.expect)(cmp.diff).toBeDefined();
+        (0, vitest_1.expect)(cmp.diff).toContain('10');
+        (0, vitest_1.expect)(cmp.diff).toContain('11');
+    });
+});
+(0, vitest_1.describe)('test-harness mutation', () => {
+    (0, vitest_1.it)('mutateNumber produces 5 mutations', () => {
+        (0, vitest_1.expect)((0, test_harness_1.mutateNumber)(3)).toEqual([4, 2, 0, -3, 6]);
+        (0, vitest_1.expect)((0, test_harness_1.mutateNumber)(0)).toEqual([1, -1, 0, -0, 0]);
+    });
+    (0, vitest_1.it)('mutateBoolean flips the value', () => {
+        (0, vitest_1.expect)((0, test_harness_1.mutateBoolean)(true)).toEqual([false]);
+        (0, vitest_1.expect)((0, test_harness_1.mutateBoolean)(false)).toEqual([true]);
+    });
+    (0, vitest_1.it)('mutateString produces multiple distinct variants', () => {
+        const variants = (0, test_harness_1.mutateString)('Hello');
+        (0, vitest_1.expect)(variants.length).toBeGreaterThanOrEqual(4);
+        (0, vitest_1.expect)(variants).toContain('');
+        (0, vitest_1.expect)(variants).toContain('Hello ');
+        // empty input also yields variants
+        const empties = (0, test_harness_1.mutateString)('');
+        (0, vitest_1.expect)(empties.length).toBeGreaterThanOrEqual(4);
+        (0, vitest_1.expect)(empties).toContain('');
+    });
+});
+(0, vitest_1.describe)('test-harness end-to-end', () => {
+    (0, vitest_1.it)('crossProduct + runWithCoverage works on a logical-profile-style scenario', async () => {
+        const profiles = (0, test_harness_1.makeSuite)('profiles', [
+            { name: 'classical', input: 'classical', tags: ['profile'] },
+            { name: 'intuitionistic', input: 'intuitionistic', tags: ['profile'] },
+            { name: 'paraconsistent', input: 'paraconsistent', tags: ['profile'] }
+        ]);
+        const formulas = (0, test_harness_1.makeSuite)('formulas', [
+            { name: 'p∧¬p', input: 'contradiction', tags: ['formula'] },
+            { name: 'p∨¬p', input: 'tautology', tags: ['formula'] }
+        ]);
+        const matrix = (0, test_harness_1.crossProduct)(profiles, formulas, { combine: 'cartesian' });
+        (0, vitest_1.expect)(matrix.cases).toHaveLength(6);
+        const report = await (0, test_harness_1.runWithCoverage)(matrix, async (c) => {
+            // simulate invariant: every profile evaluates p∨¬p as truthy except paraconsistent contradictions
+            return c.input.b === 'tautology';
+        });
+        (0, vitest_1.expect)(report.totalCases).toBe(6);
+        (0, vitest_1.expect)(report.passing).toBe(3);
+        (0, vitest_1.expect)(report.failing).toBe(3);
+        (0, vitest_1.expect)(report.errored).toBe(0);
+        (0, vitest_1.expect)(report.tagDistribution.get('profile')).toBe(6);
+        (0, vitest_1.expect)(report.tagDistribution.get('formula')).toBe(6);
+    });
+});
+//# sourceMappingURL=test-harness.test.js.map

package/dist/tests/tooling/test-harness/test-harness.test.js.map

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

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

@@ -0,0 +1,13 @@
+import type { DocModule } from './types';
+export interface ExtractOptions {
+    includeInternal?: boolean;
+}
+/**
+ * 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.
+ */
+export declare function extractDocs(rootDir: string, opts?: ExtractOptions): DocModule[];
+//# sourceMappingURL=extract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../../src/tooling/doc-gen/extract.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAA6C,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpF,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,SAAS,EAAE,CAsBnF"}

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":";AAAA,+DAA+D;AAC/D,iEAAiE;AACjE,mEAAmE;AACnE,2CAA2C;AAC3C,EAAE;AACF,QAAQ;AACR,qDAAqD;AACrD,mEAAmE;AACnE,oEAAoE;AACpE,iDAAiD;AACjD,4DAA4D;AAC5D,+DAA+D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoB/D,kCAsBC;AAxCD,uCAAyB;AACzB,2CAA6B;AAC7B,4DAA4B;AAG5B,mCAA0F;AAM1F;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,OAAe,EAAE,OAAuB,EAAE;IACpE,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,OAAO,GAAgB,EAAE,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,EAAE,GAAG,oBAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,oBAAE,CAAC,YAAY,CAAC,MAAM,EAAE,IAAI,EAAE,oBAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC7F,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACvE,MAAM,WAAW,GAAG,2BAA2B,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,CAAC,CAAC;QACxF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,WAAW;YAAE,SAAS;QACnD,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,aAAa;YACnB,WAAW;YACX,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG;YAAE,SAAS;QACnB,IAAI,OAAoB,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;gBACtB,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnF,SAAS;gBACX,CAAC;gBACD,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW;oBAAE,SAAS;gBAC/D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;gBACxB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACxC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;oBAAE,SAAS;gBACzC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;oBAAE,SAAS;gBAC7E,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IACD,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,2BAA2B,CAAC,EAAiB,EAAE,MAAc;IACpE,6EAA6E;IAC7E,MAAM,cAAc,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;IAC1E,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,6DAA6D;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAa,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACtC,IAAI,IAAI;oBAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;iBAAM,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;gBACpB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;oBAAE,SAAS;YAChC,CAAC;iBAAM,CAAC;gBACN,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;IAC5C,CAAC;IACD,MAAM,OAAO,GAAG,IAAA,2BAAmB,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAA,kBAAU,EAAC,OAAO,CAAC,CAAC;IACnC,oEAAoE;IACpE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,cAAc,IAAI,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;IACpD,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;AAClC,CAAC;AAWD,SAAS,qBAAqB,CAC5B,EAAiB,EACjB,MAAc,EACd,UAAkB,EAClB,QAAgB,EAChB,eAAwB;IAExB,MAAM,GAAG,GAAiB;QACxB,MAAM;QACN,EAAE;QACF,UAAU;QACV,QAAQ;QACR,eAAe;QACf,GAAG,EAAE,EAAE;KACR,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,EAAE,CAAC,UAAU,EAAE,CAAC;QACjC,aAAa,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,GAAG,CAAC,GAAG,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,IAAa,EAAE,GAAiB;IACrD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,eAAe;QAAE,OAAO;IAE9C,IAAI,oBAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAChD,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QAC/C,OAAO;IACT,CAAC;IACD,IAAI,oBAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC7C,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO;IACT,CAAC;IACD,IAAI,oBAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IACD,IAAI,oBAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,IAAI,oBAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,IAAI,oBAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,oBAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;QAC1E,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QACtC,OAAO;IACT,CAAC;IACD,IAAI,oBAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,eAAe,CAAC,YAAY,EAAE,CAAC;YACrD,IAAI,IAAI,CAAC,IAAI,IAAI,oBAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC5C,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;QACD,OAAO;IACT,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAa;IACtC,MAAM,IAAI,GAAI,IAAwB,CAAC,SAAS,CAAC;IACjD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAE,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,OAAO,CACd,GAAiB,EACjB,IAAa,EACb,IAAY,EACZ,IAAa,EACb,UAAoB;IAEpB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAA,kBAAU,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAEzE,2DAA2D;IAC3D,IAAI,CAAC,GAAG,CAAC,eAAe,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,UAAU,CAAC;QAAE,OAAO;IAElF,MAAM,MAAM,GAAG,UAAU,IAAI,IAAI,CAAC;IAClC,MAAM,SAAS,GAAG,cAAc,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrD,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC,6BAA6B,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAE7E,MAAM,GAAG,GAAW;QAClB,IAAI;QACJ,IAAI;QACJ,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,SAAS;QACT,MAAM,EAAE,GAAG,CAAC,UAAU;QACtB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,UAAU,EAAE,IAAI,GAAG,CAAC;QACpB,QAAQ;KACT,CAAC;IAEF,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,UAAU,GAAG,MAAM,CAAC;IAEzD,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,OAAO;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC;IAEnC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtF,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAEjD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;IAC7D,IAAI,OAAO;QAAE,GAAG,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAE3C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC7E,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC;IAElC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,YAAY,CAAC,CAAC;IACnE,IAAI,UAAU;QAAE,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC;IAEtC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpB,CAAC;AAED,SAAS,WAAW,CAAC,IAAa,EAAE,MAAc;IAChD,+DAA+D;IAC/D,iEAAiE;IACjE,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,oBAAE,CAAC,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAC7D,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACrD,mDAAmD;IACnD,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CAAC,IAAa,EAAE,MAAc;IACnD,+DAA+D;IAC/D,IAAI,oBAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,oBAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,OAAO,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,oBAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,6DAA6D;QAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QACvF,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5D,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,oBAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAClD,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,oBAAE,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,IAAI,oBAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAClD,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,oBAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,0EAA0E;QAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO,SAAS,IAAI,GAAG,QAAQ,EAAE,CAAC;IACpC,CAAC;IACD,IAAI,oBAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAClD,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,yBAAyB,CAAC,IAAgC,EAAE,MAAc;IACjF,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACvE,IAAI,GAAG,GAAG,SAAS,CAAC;IACpB,mCAAmC;IACnC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3C,IAAI,KAAK,GAAG,KAAK;QAAE,GAAG,GAAG,KAAK,CAAC;SAC1B,IAAI,IAAI,GAAG,KAAK;QAAE,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC;IACtC,OAAO,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,kBAAkB,CAAC,CAAS;IACnC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACvC,CAAC;AAED,SAAS,iBAAiB,CACxB,IAAa,EACb,MAAoD;IAEpD,IAAI,UAA6D,CAAC;IAClE,IAAI,oBAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,oBAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IAC/B,CAAC;SAAM,CAAC;QACN,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAsD,CAAC;IAChF,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO;YAAE,SAAS;QAChC,MAAM,WAAW,GAAG,IAAA,qBAAa,EAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC7C,IAAI,WAAW,EAAE,CAAC;YAChB,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE;gBAC9B,WAAW,EAAE,WAAW,CAAC,WAAW;gBACpC,QAAQ,EAAE,WAAW,CAAC,QAAQ;aAC/B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QAC/C,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,GAAG,CAAC,IAAI,CAAC;YACP,IAAI;YACJ,IAAI;YACJ,WAAW,EAAE,GAAG,EAAE,WAAW,IAAI,EAAE;YACnC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,GAAG,EAAE,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,WAAW,IAAI,IAAI;SACtF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,cAAc,CACrB,IAAa,EACb,MAAoD;IAEpD,IAAI,QAA4B,CAAC;IACjC,IACE,CAAC,oBAAE,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,oBAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC/D,IAAmC,CAAC,IAAI,EACzC,CAAC;QACD,QAAQ,GAAK,IAAmC,CAAC,IAAoB,CAAC,OAAO,EAAE,CAAC;IAClF,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC;IAC/E,IAAI,CAAC,QAAQ,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IACxC,OAAO;QACL,IAAI,EAAE,QAAQ,IAAI,SAAS;QAC3B,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,IAAA,uBAAe,EAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;KACrD,CAAC;AACJ,CAAC"}