@stevenvo780/st-lang 4.11.0 → 4.12.0

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

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

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

@@ -0,0 +1,51 @@
+export type ApiKind = 'function' | 'class' | 'interface' | 'type' | 'const' | 'enum' | 'namespace';
+export interface ApiParameter {
+    name: string;
+    type: string;
+    description: string;
+    optional: boolean;
+}
+export interface ApiReturns {
+    type: string;
+    description: string;
+}
+export interface ApiDoc {
+    name: string;
+    kind: ApiKind;
+    description: string;
+    signature: string;
+    parameters?: ApiParameter[];
+    returns?: ApiReturns;
+    examples?: string[];
+    remarks?: string;
+    see?: string[];
+    deprecated?: boolean;
+    module: string;
+    filePath: string;
+    lineNumber: number;
+    exported: boolean;
+}
+export interface DocModule {
+    path: string;
+    description?: string;
+    exports: ApiDoc[];
+}
+export interface DocOptions {
+    rootDir: string;
+    outputDir: string;
+    includeInternal?: boolean;
+    template?: 'markdown' | 'json' | 'html-minimal';
+}
+export interface JSDocTag {
+    tag: string;
+    content: string;
+}
+export interface ParsedJSDoc {
+    description: string;
+    tags: JSDocTag[];
+}
+export interface GenerateResult {
+    filesWritten: string[];
+    warnings: string[];
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tooling/doc-gen/types.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;AAEnG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,cAAc,CAAC;CACjD;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,QAAQ,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

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

@@ -0,0 +1,10 @@
+"use strict";
+// ============================================================
+// ST doc-gen — tipos públicos.
+//
+// Modelo de documentación derivado de TSDoc/JSDoc + TS Compiler
+// API: un ApiDoc por símbolo exportado (function/class/interface
+// /type/const/enum/namespace), agrupado por módulo (archivo).
+// ============================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tooling/doc-gen/types.ts"],"names":[],"mappings":";AAAA,+DAA+D;AAC/D,+BAA+B;AAC/B,EAAE;AACF,gEAAgE;AAChE,iEAAiE;AACjE,8DAA8D;AAC9D,+DAA+D"}

package/dist/tooling/test-harness/combinators.d.ts

@@ -0,0 +1,14 @@
+import type { CrossProductOptions, TestCase, TestSuite } from './types';
+export declare function crossProduct<T1, T2>(s1: TestSuite<T1>, s2: TestSuite<T2>, opts?: CrossProductOptions): TestSuite<{
+    a: T1;
+    b: T2;
+}>;
+export declare function parameterize<T, P>(suite: TestSuite<T>, params: P[]): TestSuite<{
+    input: T;
+    param: P;
+}>;
+export declare function filter<T>(suite: TestSuite<T>, pred: (c: TestCase<T>) => boolean): TestSuite<T>;
+export declare function filterByTags<T>(suite: TestSuite<T>, tags: string[]): TestSuite<T>;
+export declare function tag<T>(suite: TestSuite<T>, tagFn: (c: TestCase<T>) => string[]): TestSuite<T>;
+export declare function makeSuite<T>(name: string, cases: TestCase<T>[]): TestSuite<T>;
+//# sourceMappingURL=combinators.d.ts.map

package/dist/tooling/test-harness/combinators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinators.d.ts","sourceRoot":"","sources":["../../../src/tooling/test-harness/combinators.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,mBAAmB,EACnB,QAAQ,EACR,SAAS,EACV,MAAM,SAAS,CAAC;AAgCjB,wBAAgB,YAAY,CAAC,EAAE,EAAE,EAAE,EACjC,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,EACjB,EAAE,EAAE,SAAS,CAAC,EAAE,CAAC,EACjB,IAAI,CAAC,EAAE,mBAAmB,GACzB,SAAS,CAAC;IAAE,CAAC,EAAE,EAAE,CAAC;IAAC,CAAC,EAAE,EAAE,CAAA;CAAE,CAAC,CA4B7B;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,CAAC,EAC/B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,MAAM,EAAE,CAAC,EAAE,GACV,SAAS,CAAC;IAAE,KAAK,EAAE,CAAC,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,CAenC;AAcD,wBAAgB,MAAM,CAAC,CAAC,EACtB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO,GAChC,SAAS,CAAC,CAAC,CAAC,CAKd;AAED,wBAAgB,YAAY,CAAC,CAAC,EAC5B,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,MAAM,EAAE,GACb,SAAS,CAAC,CAAC,CAAC,CAEd;AAED,wBAAgB,GAAG,CAAC,CAAC,EACnB,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,KAAK,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,MAAM,EAAE,GAClC,SAAS,CAAC,CAAC,CAAC,CASd;AAED,wBAAgB,SAAS,CAAC,CAAC,EACzB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,GACnB,SAAS,CAAC,CAAC,CAAC,CAEd"}

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

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.crossProduct = crossProduct;
+exports.parameterize = parameterize;
+exports.filter = filter;
+exports.filterByTags = filterByTags;
+exports.tag = tag;
+exports.makeSuite = makeSuite;
+function caseTags(c) {
+    return c.tags ?? [];
+}
+function hasAnyTag(c, wanted) {
+    if (wanted.length === 0)
+        return true;
+    const tags = caseTags(c);
+    for (const t of wanted) {
+        if (tags.includes(t))
+            return true;
+    }
+    return false;
+}
+function tagsMatchMode(a, b, mode) {
+    if (mode === 'cartesian')
+        return true;
+    if (mode === 'union') {
+        if (a.length === 0 && b.length === 0)
+            return true;
+        return true;
+    }
+    if (a.length === 0 || b.length === 0)
+        return false;
+    for (const t of a) {
+        if (b.includes(t))
+            return true;
+    }
+    return false;
+}
+function crossProduct(s1, s2, opts) {
+    const mode = opts?.combine ?? 'cartesian';
+    const filterTags = opts?.filterTags ?? [];
+    const cases = [];
+    for (const ca of s1.cases) {
+        for (const cb of s2.cases) {
+            if (!tagsMatchMode(caseTags(ca), caseTags(cb), mode))
+                continue;
+            const mergedTags = Array.from(new Set([...caseTags(ca), ...caseTags(cb)]));
+            if (filterTags.length > 0) {
+                let hit = false;
+                for (const t of filterTags) {
+                    if (mergedTags.includes(t)) {
+                        hit = true;
+                        break;
+                    }
+                }
+                if (!hit)
+                    continue;
+            }
+            cases.push({
+                name: `${ca.name} × ${cb.name}`,
+                input: { a: ca.input, b: cb.input },
+                tags: mergedTags.length > 0 ? mergedTags : undefined
+            });
+        }
+    }
+    return { name: `${s1.name} × ${s2.name}`, cases };
+}
+function parameterize(suite, params) {
+    const cases = [];
+    for (let i = 0; i < suite.cases.length; i += 1) {
+        const c = suite.cases[i];
+        if (!c)
+            continue;
+        for (let j = 0; j < params.length; j += 1) {
+            const p = params[j];
+            cases.push({
+                name: `${c.name} [param=${formatParam(p)}]`,
+                input: { input: c.input, param: p },
+                tags: c.tags
+            });
+        }
+    }
+    return { name: `${suite.name} ⊗ params`, cases };
+}
+function formatParam(p) {
+    if (p === null)
+        return 'null';
+    if (p === undefined)
+        return 'undefined';
+    if (typeof p === 'string')
+        return p;
+    if (typeof p === 'number' || typeof p === 'boolean')
+        return String(p);
+    try {
+        return JSON.stringify(p);
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+function filter(suite, pred) {
+    return {
+        name: suite.name,
+        cases: suite.cases.filter(pred)
+    };
+}
+function filterByTags(suite, tags) {
+    return filter(suite, (c) => hasAnyTag(c, tags));
+}
+function tag(suite, tagFn) {
+    return {
+        name: suite.name,
+        cases: suite.cases.map((c) => {
+            const extra = tagFn(c);
+            const merged = Array.from(new Set([...(c.tags ?? []), ...extra]));
+            return { ...c, tags: merged.length > 0 ? merged : undefined };
+        })
+    };
+}
+function makeSuite(name, cases) {
+    return { name, cases };
+}
+//# sourceMappingURL=combinators.js.map

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

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

package/dist/tooling/test-harness/coverage.d.ts

@@ -0,0 +1,3 @@
+import type { CoverageReport, TestCase, TestSuite } from './types';
+export declare function runWithCoverage<T>(suite: TestSuite<T>, runner: (c: TestCase<T>) => Promise<boolean>): Promise<CoverageReport>;
+//# sourceMappingURL=coverage.d.ts.map

package/dist/tooling/test-harness/coverage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage.d.ts","sourceRoot":"","sources":["../../../src/tooling/test-harness/coverage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEnE,wBAAsB,eAAe,CAAC,CAAC,EACrC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,MAAM,EAAE,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAC3C,OAAO,CAAC,cAAc,CAAC,CA0BzB"}