@imolko/create-ultra-reporter 2.1.23-beta

package/bin/scaffold/assembler.js

@@ -0,0 +1,371 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Docusaurus scaffold assembler
+//
+// Assembles the Docusaurus working site into .ultra-reporter/docusaurus/.
+//   - Copies template files from the library's templates/documentation/
+//   - Generates docusaurus.config.ts from ultra-reporter.config.json
+//   - Generates sidebars.ts with dynamic sections
+//   - Merges .ultra-reporter-overrides/ if present
+//   - Version-stamps the scaffold to detect library updates
+// ---------------------------------------------------------------------------
+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.assembleScaffold = assembleScaffold;
+exports.isScaffoldCurrent = isScaffoldCurrent;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const reader_1 = require("../config/reader");
+const SCAFFOLD_VERSION_FILE = '.scaffold-version';
+const CURRENT_SCAFFOLD_VERSION = '1.0.0';
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Assembles (or re-assembles if needed) the Docusaurus scaffold into the
+ * .ultra-reporter/docusaurus/ directory.
+ *
+ * @param configDir - Directory containing ultra-reporter.config.json
+ * @param libraryTemplateDir - Path to the library's templates/documentation/ directory
+ * @param force - If true, re-assemble even if version matches
+ */
+function assembleScaffold(configDir, libraryTemplateDir, force = false) {
+    const config = (0, reader_1.readConfig)(configDir);
+    const docusaurusDir = path.resolve(configDir, '.ultra-reporter', 'docusaurus');
+    // Check if re-assembly is needed
+    if (!force && isScaffoldCurrent(docusaurusDir)) {
+        return;
+    }
+    // Ensure the docusaurus directory exists
+    fs.mkdirSync(docusaurusDir, { recursive: true });
+    // Copy static template files (NOT docusaurus.config.ts or sidebars.ts — we generate those)
+    copyTemplateFiles(libraryTemplateDir, docusaurusDir);
+    // Generate dynamic config files
+    generateDocusaurusConfig(config, docusaurusDir);
+    generateSidebars(config, docusaurusDir);
+    // Generate docs directory with .gitkeep
+    const docsDir = path.join(docusaurusDir, 'docs');
+    fs.mkdirSync(docsDir, { recursive: true });
+    fs.writeFileSync(path.join(docsDir, '.gitkeep'), '');
+    // Merge overrides if present
+    mergeOverrides(configDir, docusaurusDir);
+    // Write version stamp
+    fs.writeFileSync(path.join(docusaurusDir, SCAFFOLD_VERSION_FILE), CURRENT_SCAFFOLD_VERSION);
+}
+/**
+ * Checks if an existing scaffold is up-to-date.
+ */
+function isScaffoldCurrent(docusaurusDir) {
+    const versionPath = path.join(docusaurusDir, SCAFFOLD_VERSION_FILE);
+    if (!fs.existsSync(versionPath)) {
+        return false;
+    }
+    try {
+        const version = fs.readFileSync(versionPath, 'utf-8').trim();
+        return version === CURRENT_SCAFFOLD_VERSION;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Template copying
+// ---------------------------------------------------------------------------
+/**
+ * Copies template files from the library to the Docusaurus directory.
+ * Skips files we generate dynamically (docusaurus.config.ts, sidebars.ts).
+ */
+function copyTemplateFiles(srcDir, destDir) {
+    const skipFiles = new Set([
+        'docusaurus.config.ts',
+        'sidebars.ts',
+        'ultra-reporter.config.json',
+        '.gitignore',
+        'docs/.gitkeep',
+        SCAFFOLD_VERSION_FILE,
+    ]);
+    copyDirRecursive(srcDir, destDir, skipFiles);
+}
+function copyDirRecursive(src, dest, skipFiles) {
+    fs.mkdirSync(dest, { recursive: true });
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        // Compute relative path for skip check
+        const relPath = path.relative(src, srcPath);
+        if (skipFiles.has(entry.name) || skipFiles.has(relPath)) {
+            continue;
+        }
+        if (entry.isDirectory()) {
+            copyDirRecursive(srcPath, destPath, skipFiles);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Config generation
+// ---------------------------------------------------------------------------
+/**
+ * Generates docusaurus.config.ts from the ultra-reporter config.
+ */
+function generateDocusaurusConfig(config, docusaurusDir) {
+    const domainName = config.domain.name;
+    const title = `${domainName.charAt(0).toUpperCase() + domainName.slice(1)} Docs`;
+    const content = `import { themes as prismThemes } from "prism-react-renderer";
+import type { Config } from "@docusaurus/types";
+import type * as Preset from "@docusaurus/preset-classic";
+
+const config: Config = {
+  title: "${title}",
+  tagline: "${domainName} Documentation",
+  favicon: "img/favicon.ico",
+
+  url: "https://your-docusaurus-site.example.com",
+  baseUrl: "/",
+
+  organizationName: "imolko",
+  projectName: "${domainName}",
+
+  onBrokenLinks: "throw",
+  onBrokenMarkdownLinks: "warn",
+
+  i18n: {
+    defaultLocale: "en",
+    locales: ["en"],
+  },
+
+  presets: [
+    [
+      "classic",
+      {
+        docs: {
+          sidebarPath: "./sidebars.ts",
+        },
+        theme: {
+          customCss: "./src/css/custom.css",
+        },
+      } satisfies Preset.Options,
+    ],
+  ],
+
+  themeConfig: {
+    image: "img/docusaurus-social-card.jpg",
+    navbar: {
+      title: "${title}",
+      logo: {
+        alt: "${domainName} Logo",
+        src: "img/logo_imolko_azul.png",
+      },
+      items: [
+        {
+          type: "docSidebar",
+          sidebarId: "tutorialSidebar",
+          position: "left",
+          label: "Documentation",
+        },
+      ],
+    },
+    footer: {
+      style: "dark",
+      links: [
+        {
+          title: "Docs",
+          items: [
+            {
+              label: "Aggregates",
+              to: "/docs/category/aggregates",
+            },
+            {
+              label: "Domain Artifacts",
+              to: "/docs/category/domain-artifacts",
+            },
+            {
+              label: "Intro",
+              to: "/docs/intro",
+            },
+          ],
+        },
+      ],
+      copyright: \`Copyright © \${new Date().getFullYear()} Imolko, Inc. Built with Docusaurus.\`,
+    },
+    prism: {
+      theme: prismThemes.github,
+      darkTheme: prismThemes.dracula,
+    },
+  } satisfies Preset.ThemeConfig,
+
+  markdown: {
+    mermaid: true,
+  },
+  themes: ['@docusaurus/theme-mermaid'],
+};
+
+export default config;
+`;
+    fs.writeFileSync(path.join(docusaurusDir, 'docusaurus.config.ts'), content);
+}
+// ---------------------------------------------------------------------------
+// Sidebars generation
+// ---------------------------------------------------------------------------
+/**
+ * Generates sidebars.ts with dynamic sections based on config.
+ */
+function generateSidebars(config, docusaurusDir) {
+    const domainName = config.domain.name;
+    const hasUseCases = !!config.useCases;
+    const hasUserDocs = !!config.docs;
+    const sections = [];
+    // Aggregates section
+    sections.push(`    {
+      type: 'category' as const,
+      label: '${domainName} Aggregates',
+      link: {
+        type: 'generated-index',
+        description: 'Aggregates del dominio',
+      },
+      items: [
+        {
+          type: 'autogenerated',
+          dirName: 'aggregates',
+        },
+      ],
+    }`);
+    // Domain artifacts section
+    sections.push(`    {
+      type: 'category' as const,
+      label: '${domainName} Domain Artifacts',
+      link: {
+        type: 'generated-index',
+        description: 'Todos los artefactos del dominio',
+      },
+      items: [
+        {
+          type: 'autogenerated',
+          dirName: 'domain',
+        },
+      ],
+    }`);
+    // Use-cases section
+    if (hasUseCases) {
+        sections.push(`    {
+      type: 'category' as const,
+      label: '${config.useCases.title}',
+      link: {
+        type: 'generated-index',
+        description: 'Todos los casos de uso',
+      },
+      items: [
+        {
+          type: 'autogenerated',
+          dirName: 'use-cases',
+        },
+      ],
+    }`);
+    }
+    // User docs section
+    if (hasUserDocs) {
+        sections.push(`    {
+      type: 'category' as const,
+      label: 'Documentation',
+      link: {
+        type: 'generated-index',
+        description: 'Manual documentation',
+      },
+      items: [
+        {
+          type: 'autogenerated',
+          dirName: 'user',
+        },
+      ],
+    }`);
+    }
+    const content = `import type { SidebarsConfig } from "@docusaurus/plugin-content-docs";
+
+const sidebars: SidebarsConfig = {
+  tutorialSidebar: [
+${sections.join(',\n')},
+  ],
+};
+
+export default sidebars;
+`;
+    fs.writeFileSync(path.join(docusaurusDir, 'sidebars.ts'), content);
+}
+// ---------------------------------------------------------------------------
+// Override merging
+// ---------------------------------------------------------------------------
+/**
+ * Merges .ultra-reporter-overrides/ into the Docusaurus scaffold.
+ * Handles: docusaurus.config.override.ts, custom.css, components/, static/
+ */
+function mergeOverrides(configDir, docusaurusDir) {
+    const overridesDir = path.resolve(configDir, '.ultra-reporter-overrides');
+    if (!fs.existsSync(overridesDir)) {
+        return;
+    }
+    // Merge docusaurus.config.override.ts
+    const configOverride = path.join(overridesDir, 'docusaurus.config.override.ts');
+    if (fs.existsSync(configOverride)) {
+        const overrideContent = fs.readFileSync(configOverride, 'utf-8');
+        // Append the override to the generated config
+        const configPath = path.join(docusaurusDir, 'docusaurus.config.ts');
+        const existingConfig = fs.readFileSync(configPath, 'utf-8');
+        // Deep merge: insert override content before export default
+        const merged = existingConfig.replace('export default config;', `// User overrides from .ultra-reporter-overrides/\n${overrideContent}\n\nexport default config;`);
+        fs.writeFileSync(configPath, merged);
+    }
+    // Copy custom.css
+    const customCss = path.join(overridesDir, 'custom.css');
+    if (fs.existsSync(customCss)) {
+        const destCss = path.join(docusaurusDir, 'src', 'css', 'custom.css');
+        const existing = fs.readFileSync(destCss, 'utf-8');
+        const overrideCss = fs.readFileSync(customCss, 'utf-8');
+        fs.writeFileSync(destCss, existing + '\n\n/* User overrides */\n' + overrideCss);
+    }
+    // Copy components/
+    const overrideComponents = path.join(overridesDir, 'components');
+    if (fs.existsSync(overrideComponents)) {
+        copyDirRecursive(overrideComponents, path.join(docusaurusDir, 'src', 'components'), new Set());
+    }
+    // Copy static/
+    const overrideStatic = path.join(overridesDir, 'static');
+    if (fs.existsSync(overrideStatic)) {
+        copyDirRecursive(overrideStatic, path.join(docusaurusDir, 'static'), new Set());
+    }
+}
+//# sourceMappingURL=assembler.js.map

package/bin/scaffold/assembler.js.map

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

package/bin/scaffold/doc-assembler.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Assembles all documentation sources into the Docusaurus docs directory.
+ *
+ * 1. Cleans .ultra-reporter/docusaurus/docs/
+ * 2. Copies generated docs (domain, aggregates, use-cases)
+ * 3. Copies user manual docs (if configured)
+ *
+ * @param configDir - Directory containing ultra-reporter.config.json
+ */
+export declare function assembleDocs(configDir: string): void;

package/bin/scaffold/doc-assembler.js

@@ -0,0 +1,113 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Document assembler
+//
+// Combines generated docs (.ultra-reporter/generated-docs/) and user manual
+// docs (docs/) into the Docusaurus docs directory (.ultra-reporter/docusaurus/docs/).
+// ---------------------------------------------------------------------------
+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.assembleDocs = assembleDocs;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const reader_1 = require("../config/reader");
+/**
+ * Assembles all documentation sources into the Docusaurus docs directory.
+ *
+ * 1. Cleans .ultra-reporter/docusaurus/docs/
+ * 2. Copies generated docs (domain, aggregates, use-cases)
+ * 3. Copies user manual docs (if configured)
+ *
+ * @param configDir - Directory containing ultra-reporter.config.json
+ */
+function assembleDocs(configDir) {
+    const config = (0, reader_1.readConfig)(configDir);
+    const docusaurusDocsDir = path.resolve(configDir, '.ultra-reporter', 'docusaurus', 'docs');
+    const generatedDocsDir = path.resolve(configDir, '.ultra-reporter', 'generated-docs');
+    // Clean the Docusaurus docs directory (keep .gitkeep)
+    if (fs.existsSync(docusaurusDocsDir)) {
+        cleanDir(docusaurusDocsDir);
+    }
+    fs.mkdirSync(docusaurusDocsDir, { recursive: true });
+    // Copy generated docs
+    copyDirIfExists(path.join(generatedDocsDir, 'domain'), path.join(docusaurusDocsDir, 'domain'));
+    copyDirIfExists(path.join(generatedDocsDir, 'aggregates'), path.join(docusaurusDocsDir, 'aggregates'));
+    copyDirIfExists(path.join(generatedDocsDir, 'use-cases'), path.join(docusaurusDocsDir, 'use-cases'));
+    // Copy user manual docs
+    if (config.docs) {
+        const userDocsDir = path.resolve(configDir, config.docs.path);
+        if (fs.existsSync(userDocsDir)) {
+            copyDirRecursive(userDocsDir, path.join(docusaurusDocsDir, 'user'));
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/** Removes all files and subdirectories from a directory. */
+function cleanDir(dir) {
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const entryPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            fs.rmSync(entryPath, { recursive: true, force: true });
+        }
+        else {
+            fs.unlinkSync(entryPath);
+        }
+    }
+}
+/** Copies a directory tree if the source exists. */
+function copyDirIfExists(src, dest) {
+    if (fs.existsSync(src)) {
+        copyDirRecursive(src, dest);
+    }
+}
+/** Recursively copies a directory tree. */
+function copyDirRecursive(src, dest) {
+    fs.mkdirSync(dest, { recursive: true });
+    const entries = fs.readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(src, entry.name);
+        const destPath = path.join(dest, entry.name);
+        if (entry.isDirectory()) {
+            copyDirRecursive(srcPath, destPath);
+        }
+        else {
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+//# sourceMappingURL=doc-assembler.js.map

package/bin/scaffold/doc-assembler.js.map

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

package/bin/scripts/add-import.d.ts

@@ -0,0 +1 @@
+export declare function addImports(content: string, elems: string[], source: string): string;

package/bin/scripts/add-import.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addImports = addImports;
+function addImports(content, elems, source) {
+    const sourceSatanized = source.replace(/\./g, "\\.").replace(/\//g, "\\/");
+    let newContent = content;
+    for (const elem of elems) {
+        let regExpStr = `(import[\\s\n]+\\{)([\\s\n]*[a-zA-Z0-9,\\s\n]*)(${elem})([a-zA-Z0-9,\\s\n]*[\\s\n]+)(\\}[\\s\n]+from[\\s\n]+['"]{1}${sourceSatanized}['"]{1})`;
+        let regExp = new RegExp(regExpStr);
+        if (regExp.test(newContent)) {
+            // La importacion ya hiciste
+            continue;
+        }
+        regExpStr = `(import[\\s\n]+\\{)([\\s\n]+[a-zA-Z0-9,\\s\n]+[\\s\n]+)(\\}[\\s\n]+from[\\s\n]+['"]{1}${sourceSatanized}['"]{1})`;
+        regExp = new RegExp(regExpStr);
+        const match = newContent.match(regExp);
+        if (match) {
+            newContent = newContent.replace(match[0], `${match[1]} ${elem}, ${match[2]}${match[3]}`);
+        }
+        else {
+            newContent = `import { ${elem} } from '${source}';\n${newContent}`;
+        }
+    }
+    return newContent;
+}
+//# sourceMappingURL=add-import.js.map

package/bin/scripts/add-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-import.js","sourceRoot":"","sources":["../../src/scripts/add-import.ts"],"names":[],"mappings":";;AAAA,gCA0BC;AA1BD,SAAgB,UAAU,CAAC,OAAe,EAAE,KAAe,EAAE,MAAc;IACzE,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3E,IAAI,UAAU,GAAG,OAAO,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,SAAS,GAAG,mDAAmD,IAAI,+DAA+D,eAAe,UAAU,CAAC;QAChK,IAAI,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;QAEnC,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,4BAA4B;YAC5B,SAAS;QACX,CAAC;QAED,SAAS,GAAG,yFAAyF,eAAe,UAAU,CAAC;QAC/H,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEvC,IAAI,KAAK,EAAE,CAAC;YACV,UAAU,GAAG,UAAU,CAAC,OAAO,CAC7B,KAAK,CAAC,CAAC,CAAC,EACR,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,CAC9C,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,YAAY,IAAI,YAAY,MAAM,OAAO,UAAU,EAAE,CAAC;QACrE,CAAC;IACH,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/bin/scripts/converter.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Convierte un formato JSON de pruebas antiguo a un nuevo formato
+ * @param inputFilePath Ruta del archivo JSON de entrada
+ * @param outputFilePath Ruta del archivo JSON de salida
+ */
+export declare function convertTestJsonFormat(inputFilePath: string, outputFilePath: string): void;

package/bin/scripts/converter.js

@@ -0,0 +1,120 @@
+"use strict";
+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.convertTestJsonFormat = convertTestJsonFormat;
+const fs = __importStar(require("fs"));
+/**
+ * Convierte un formato JSON de pruebas antiguo a un nuevo formato
+ * @param inputFilePath Ruta del archivo JSON de entrada
+ * @param outputFilePath Ruta del archivo JSON de salida
+ */
+function convertTestJsonFormat(inputFilePath, outputFilePath) {
+    try {
+        // Leer el archivo de entrada
+        const inputData = fs.readFileSync(inputFilePath, 'utf8');
+        const oldJson = JSON.parse(inputData);
+        // Obtener los resultados de las pruebas y organizarlos por archivo
+        const testFileMap = new Map();
+        oldJson.results.tests.forEach(test => {
+            if (!testFileMap.has(test.filePath)) {
+                testFileMap.set(test.filePath, []);
+            }
+            testFileMap.get(test.filePath)?.push(test);
+        });
+        // Crear la estructura del nuevo JSON
+        const newJson = {
+            numFailedTestSuites: 0,
+            numFailedTests: oldJson.results.summary.failed,
+            numPassedTestSuites: testFileMap.size, // Asumimos que todos los archivos pasaron
+            numPassedTests: oldJson.results.summary.passed,
+            numPendingTestSuites: 0,
+            numPendingTests: oldJson.results.summary.pending,
+            numRuntimeErrorTestSuites: 0,
+            numTodoTests: oldJson.results.summary.other, // Asumimos que 'other' son pruebas TODO
+            numTotalTestSuites: testFileMap.size,
+            numTotalTests: oldJson.results.summary.tests,
+            startTime: oldJson.results.summary.start,
+            success: oldJson.results.summary.failed === 0,
+            testResults: []
+        };
+        // Convertir cada archivo de pruebas al nuevo formato
+        testFileMap.forEach((tests, filePath) => {
+            const passingTests = tests.filter(test => test.status === 'passed').length;
+            const failingTests = tests.filter(test => test.status === 'failed').length;
+            const pendingTests = tests.filter(test => test.status === 'pending').length;
+            const todoTests = tests.length - passingTests - failingTests - pendingTests;
+            // Calculamos un tiempo de ejecución estimado para las pruebas
+            const totalDuration = tests.reduce((sum, test) => sum + test.duration, 0);
+            const startTime = oldJson.results.summary.start;
+            const endTime = startTime + totalDuration;
+            const testFile = {
+                numFailingTests: failingTests,
+                numPassingTests: passingTests,
+                numPendingTests: pendingTests,
+                numTodoTests: todoTests,
+                perfStats: {
+                    end: endTime,
+                    runtime: totalDuration,
+                    slow: false,
+                    start: startTime
+                },
+                testFilePath: filePath,
+                failureMessage: null,
+                testResults: tests.map(test => {
+                    // Extraer el título del ancestro y el título de la prueba desde la suite
+                    const suiteParts = test.suite.split(' > ');
+                    const ancestorTitles = suiteParts.length > 1 ? [suiteParts[1]] : [];
+                    const title = test.name.split(' ').slice(ancestorTitles.length > 0 ? 1 : 0).join(' ');
+                    return {
+                        ancestorTitles,
+                        duration: test.duration,
+                        failureMessages: [],
+                        fullName: test.name,
+                        status: test.status,
+                        title
+                    };
+                })
+            };
+            newJson.testResults.push(testFile);
+        });
+        // Escribir el archivo de salida
+        fs.writeFileSync(outputFilePath, JSON.stringify(newJson, null, 2), 'utf8');
+        console.log(`Conversión exitosa. Archivo guardado en: ${outputFilePath}`);
+    }
+    catch (error) {
+        console.error('Error durante la conversión:', error);
+    }
+}
+//# sourceMappingURL=converter.js.map