@imolko/create-ultra-reporter 2.1.23-beta

package/bin/reporters/data-loading.js

@@ -0,0 +1,398 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Data-loading layer — I/O functions that read files from disk.
+// All functions are independently testable.
+// ---------------------------------------------------------------------------
+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.loadArtifacts = loadArtifacts;
+exports.loadTemplates = loadTemplates;
+exports.loadYamlDefinition = loadYamlDefinition;
+exports.loadAttachments = loadAttachments;
+exports.loadJsdocReport = loadJsdocReport;
+exports.loadTestResults = loadTestResults;
+exports.cleanJsdocOutput = cleanJsdocOutput;
+exports.loadUseCaseFolders = loadUseCaseFolders;
+exports.loadUseCaseDefinition = loadUseCaseDefinition;
+exports.loadUseCaseAttachments = loadUseCaseAttachments;
+exports.parseMarkdownFrontmatter = parseMarkdownFrontmatter;
+exports.loadMarkdownFilesFromFolder = loadMarkdownFilesFromFolder;
+exports.loadArtifactMetadataAndContent = loadArtifactMetadataAndContent;
+exports.loadUseCaseMetadataAndContent = loadUseCaseMetadataAndContent;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const get_file_1 = require("../scripts/get-file");
+// ---------------------------------------------------------------------------
+// loadArtifacts — reads artifacts.json
+// ---------------------------------------------------------------------------
+/**
+ * Reads and parses an artifacts.json file.
+ */
+async function loadArtifacts(pathStr) {
+    const fileData = await (0, get_file_1.getFile)(pathStr);
+    if (!fileData) {
+        throw new Error(`File ${pathStr} not found`);
+    }
+    try {
+        const data = JSON.parse(fileData);
+        return data;
+    }
+    catch (err) {
+        throw new Error(`Can not parse file ${pathStr}, error: ${err}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// loadTemplates — reads template files from a directory
+// ---------------------------------------------------------------------------
+const TEMPLATE_FILES = {
+    artifactTemplate: 'artifact.template.jsx',
+    testTemplate: 'test.template.jsx',
+    propertiesTemplate: 'properties.template.jsx',
+    methodDefinitionTemplate: 'method-definition.template.jsx',
+    exampleTemplate: 'example.template.jsx',
+};
+/**
+ * Reads all required template files from the given directory.
+ * Returns a Templates object with each template as a string.
+ */
+async function loadTemplates(templateDir) {
+    const templates = {};
+    for (const [key, filename] of Object.entries(TEMPLATE_FILES)) {
+        const filePath = path.resolve(templateDir, filename);
+        const content = await (0, get_file_1.getFile)(filePath);
+        if (content === '') {
+            throw new Error(`Template file ${filename} not found or empty, path: ${filePath}`);
+        }
+        templates[key] = content;
+    }
+    return templates;
+}
+// ---------------------------------------------------------------------------
+// loadYamlDefinition — reads an artifact's definition.yaml
+// ---------------------------------------------------------------------------
+/**
+ * Reads and parses an artifact's definition.yaml file.
+ * Returns {} if the file doesn't exist, is empty, or contains invalid YAML.
+ */
+async function loadYamlDefinition(name, basePath, cwd) {
+    const filePath = path.resolve(cwd, basePath, name, 'definition.yaml');
+    // definition.yaml is optional (backward compat), don't warn when missing
+    const fileData = await (0, get_file_1.getFile)(filePath, { warnOnMissing: false });
+    if (!fileData) {
+        return {};
+    }
+    try {
+        const doc = yaml.load(fileData);
+        if (!doc) {
+            return {};
+        }
+        return doc;
+    }
+    catch {
+        return {};
+    }
+}
+// ---------------------------------------------------------------------------
+// loadAttachments — reads an artifact's attachments.md
+// ---------------------------------------------------------------------------
+/**
+ * Reads an artifact's attachments.md file.
+ * Returns empty string if the file doesn't exist or is empty.
+ */
+async function loadAttachments(name, basePath, cwd) {
+    const filePath = path.resolve(cwd, basePath, name, 'attachments.md');
+    // attachments.md is optional, don't warn when missing
+    const fileData = await (0, get_file_1.getFile)(filePath, { warnOnMissing: false });
+    return fileData || '';
+}
+// ---------------------------------------------------------------------------
+// loadJsdocReport — reads and cleans JSDoc output
+// ---------------------------------------------------------------------------
+/**
+ * Reads a jsdoc-to-json output file, strips progress lines, and parses the JSON.
+ */
+async function loadJsdocReport(pathStr) {
+    const fileData = await (0, get_file_1.getFile)(pathStr);
+    if (!fileData) {
+        throw new Error(`File ${pathStr} not found`);
+    }
+    let jsonTxt;
+    try {
+        jsonTxt = cleanJsdocOutput(fileData);
+    }
+    catch (err) {
+        throw new Error(`Cleaning file ${pathStr}, error: ${err}`);
+    }
+    try {
+        const data = JSON.parse(jsonTxt.trim());
+        return data;
+    }
+    catch (err) {
+        throw new Error(`Parsing data from file ${pathStr}, error: ${err}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// loadTestResults — reads test-results.json
+// ---------------------------------------------------------------------------
+/**
+ * Reads a jest test-results.json file and extracts the testResults array.
+ */
+async function loadTestResults(pathStr) {
+    const fileData = await (0, get_file_1.getFile)(pathStr);
+    if (!fileData) {
+        throw new Error(`File ${pathStr} not found`);
+    }
+    try {
+        const resultParsed = JSON.parse(fileData);
+        const testResultsCurrent = resultParsed.testResults || [];
+        return testResultsCurrent;
+    }
+    catch (err) {
+        throw new Error(`Error reading file ${pathStr}, error: ${err}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// cleanJsdocOutput — strips JSDoc CLI progress noise
+// ---------------------------------------------------------------------------
+/**
+ * Removes "Parsing ..." and "Finished running in..." progress lines from
+ * jsdoc-to-json raw output, leaving only valid JSON.
+ */
+function cleanJsdocOutput(raw) {
+    const lines = raw.split('\n');
+    const cleaned = lines
+        .filter((line) => !/^Parsing /.test(line) && !/^Finished running in/.test(line))
+        .join('\n');
+    return cleaned;
+}
+// ---------------------------------------------------------------------------
+// Use-cases data-loading functions
+// ---------------------------------------------------------------------------
+/**
+ * Lists folder names inside a use-cases directory.
+ * Returns an empty array if the directory does not exist or is empty.
+ */
+async function loadUseCaseFolders(basePath) {
+    try {
+        const entries = await fs.promises.readdir(basePath, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => entry.name);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Reads and parses a use-case's definition.yaml file.
+ * Returns {} if the file doesn't exist, is empty, or contains invalid YAML.
+ */
+async function loadUseCaseDefinition(useCaseDirPath) {
+    const filePath = path.resolve(useCaseDirPath, 'definition.yaml');
+    // definition.yaml is optional (backward compat), don't warn when missing
+    const fileData = await (0, get_file_1.getFile)(filePath, { warnOnMissing: false });
+    if (!fileData) {
+        return {};
+    }
+    try {
+        const doc = yaml.load(fileData);
+        if (!doc) {
+            return {};
+        }
+        return doc;
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Reads a use-case's attachments.md file.
+ * Returns empty string if the file doesn't exist or is empty.
+ */
+async function loadUseCaseAttachments(useCaseDirPath) {
+    const filePath = path.resolve(useCaseDirPath, 'attachments.md');
+    // attachments.md is optional, don't warn when missing
+    const fileData = await (0, get_file_1.getFile)(filePath, { warnOnMissing: false });
+    return fileData || '';
+}
+/**
+ * Parses YAML frontmatter from a markdown string.
+ *
+ * Frontmatter is a YAML block delimited by `---` at the very start of the
+ * file. Only the first `---...---` block is treated as frontmatter;
+ * subsequent `---` lines in the body are left as literal content.
+ *
+ * If there is no opening `---` on line 1, or the YAML is invalid, the
+ * entire content is returned as `body` with an empty `frontmatter`.
+ *
+ * @param rawContent - The raw markdown file content as a string.
+ * @returns Parsed frontmatter and body.
+ */
+function parseMarkdownFrontmatter(rawContent) {
+    if (rawContent === '') {
+        return { frontmatter: {}, body: '' };
+    }
+    // Frontmatter must start on line 1
+    if (!rawContent.startsWith('---')) {
+        return { frontmatter: {}, body: rawContent };
+    }
+    // Find closing --- (must be on its own line after the opening ---)
+    const afterOpening = rawContent.slice(3); // strip leading '---'
+    const closingMatch = afterOpening.match(/\n---/);
+    if (!closingMatch || closingMatch.index === undefined) {
+        // No closing delimiter found — treat entire content as body
+        return { frontmatter: {}, body: rawContent };
+    }
+    const yamlBlock = afterOpening.slice(0, closingMatch.index);
+    const bodyStart = closingMatch.index + closingMatch[0].length;
+    // Skip the newline after closing --- if present
+    const body = afterOpening.slice(bodyStart).replace(/^\n/, '');
+    let frontmatter = {};
+    if (yamlBlock.trim() !== '') {
+        try {
+            const parsed = yaml.load(yamlBlock);
+            if (parsed && typeof parsed === 'object') {
+                frontmatter = parsed;
+            }
+        }
+        catch {
+            // Invalid YAML — return empty frontmatter and raw content as body
+            return { frontmatter: {}, body: rawContent };
+        }
+    }
+    return { frontmatter, body };
+}
+/**
+ * Scans a folder for all `.md` files, extracts frontmatter from each, and
+ * merges the results into a single frontmatter object (first file
+ * alphabetically wins on key conflicts) and a concatenated body string.
+ *
+ * Files with an empty body (after stripping frontmatter) are excluded from
+ * the concatenated body but their frontmatter is still merged.
+ *
+ * @param folderPath - Absolute path to the folder to scan.
+ * @returns Merged frontmatter and concatenated bodies.
+ */
+async function loadMarkdownFilesFromFolder(folderPath) {
+    let entries;
+    try {
+        entries = await fs.promises.readdir(folderPath, { withFileTypes: true });
+    }
+    catch {
+        return { mergedFrontmatter: {}, concatenatedBodies: '' };
+    }
+    // Filter to .md files (case-insensitive), sort alphabetically
+    const mdFiles = entries
+        .filter((entry) => entry.isFile() && entry.name.toLowerCase().endsWith('.md'))
+        .map((entry) => entry.name)
+        .sort((a, b) => a.localeCompare(b));
+    if (mdFiles.length === 0) {
+        return { mergedFrontmatter: {}, concatenatedBodies: '' };
+    }
+    const mergedFrontmatter = {};
+    const bodies = [];
+    for (const fileName of mdFiles) {
+        const filePath = path.resolve(folderPath, fileName);
+        const rawContent = await (0, get_file_1.getFile)(filePath);
+        if (!rawContent) {
+            continue;
+        }
+        const { frontmatter, body } = parseMarkdownFrontmatter(rawContent);
+        // Merge frontmatter: first-file-wins per key
+        for (const key of Object.keys(frontmatter)) {
+            if (!(key in mergedFrontmatter)) {
+                mergedFrontmatter[key] = frontmatter[key];
+            }
+        }
+        // Only include non-empty bodies
+        if (body.trim() !== '') {
+            bodies.push(body);
+        }
+    }
+    return {
+        mergedFrontmatter,
+        concatenatedBodies: bodies.join(''),
+    };
+}
+/**
+ * Loads metadata and markdown content for a domain artifact by composing
+ * legacy `definition.yaml` loading with `.md` frontmatter scanning.
+ *
+ * 1. Loads `definition.yaml` as the base metadata.
+ * 2. Scans all `.md` files in the artifact folder for frontmatter.
+ * 3. Merges: `.md` frontmatter overrides `definition.yaml` on key conflicts.
+ * 4. Concatenates all `.md` file bodies (alphabetical, empty bodies excluded).
+ *
+ * @param name - Artifact folder name (e.g., "MyEntity").
+ * @param basePath - Base path relative to cwd (e.g., "domain/src").
+ * @param cwd - Working directory.
+ * @returns Merged definition and concatenated markdown bodies.
+ */
+async function loadArtifactMetadataAndContent(name, basePath, cwd) {
+    // Load legacy definition.yaml
+    const definitionYaml = await loadYamlDefinition(name, basePath, cwd);
+    // Scan .md files
+    const folderPath = path.resolve(cwd, basePath, name);
+    const { mergedFrontmatter, concatenatedBodies } = await loadMarkdownFilesFromFolder(folderPath);
+    // Merge: definition.yaml is base, .md frontmatter overrides
+    const definition = { ...definitionYaml, ...mergedFrontmatter };
+    return { definition, attachmentsMd: concatenatedBodies };
+}
+// ---------------------------------------------------------------------------
+// loadUseCaseMetadataAndContent — use-cases composed loader
+// ---------------------------------------------------------------------------
+/**
+ * Loads metadata and markdown content for a use-case by composing legacy
+ * `definition.yaml` loading with `.md` frontmatter scanning.
+ *
+ * 1. Loads `definition.yaml` as the base metadata.
+ * 2. Scans all `.md` files in the use-case folder for frontmatter.
+ * 3. Merges: `.md` frontmatter overrides `definition.yaml` on key conflicts.
+ * 4. Concatenates all `.md` file bodies (alphabetical, empty bodies excluded).
+ *
+ * @param useCaseDirPath - Absolute path to the use-case folder.
+ * @returns Merged definition and concatenated markdown bodies.
+ */
+async function loadUseCaseMetadataAndContent(useCaseDirPath) {
+    // Load legacy definition.yaml
+    const definitionYaml = await loadUseCaseDefinition(useCaseDirPath);
+    // Scan .md files
+    const { mergedFrontmatter, concatenatedBodies } = await loadMarkdownFilesFromFolder(useCaseDirPath);
+    // Merge: definition.yaml is base, .md frontmatter overrides
+    const definition = { ...definitionYaml, ...mergedFrontmatter };
+    return { definition, attachmentsMd: concatenatedBodies };
+}
+//# sourceMappingURL=data-loading.js.map

package/bin/reporters/data-loading.js.map

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

package/bin/reporters/data-transformation.d.ts

@@ -0,0 +1,101 @@
+import type { ArtifactManifestEntry, ArtifactRaw, ClassProperty, EnrichedArtifact, EnrichedUseCase, JsdocElem, MethodDefinition, Property, TestFile, UseCaseRaw } from './types';
+/**
+ * Extracts property definitions from JSDoc elements whose meta.filename is 'props.ts'.
+ * Iterates over each matching element's `.properties` array and maps them
+ * to typed Property objects.
+ */
+export declare function extractProperties(jsdocElems: JsdocElem[]): Property[];
+/**
+ * Extracts ClassProperty definitions from JSDoc elements whose
+ * meta.filename is 'definition.ts' and meta.code.type is 'ClassProperty'.
+ */
+export declare function extractClassProperties(jsdocElems: JsdocElem[]): ClassProperty[];
+/**
+ * Extracts MethodDefinition from JSDoc elements whose meta.filename is
+ * 'definition.ts' and meta.code.type is 'MethodDefinition'.
+ */
+export declare function extractMethodDefinitions(jsdocElems: JsdocElem[]): MethodDefinition[];
+/**
+ * Matches JSDoc elements to artifacts using directory-based path matching.
+ *
+ * For each artifact with jsondocMustMatchPath (e.g. "/MyEntity"), the function
+ * checks if the JSDoc element's meta.path contains that directory as a path
+ * segment (e.g. ".../MyEntity/definition.ts" matches "/MyEntity").
+ *
+ * This replaces the broken exact-suffix regex approach in the original code.
+ */
+export declare function matchJsdocToArtifacts(jsdocData: JsdocElem[], artifacts: ArtifactRaw[]): Map<string, JsdocElem[]>;
+/**
+ * Returns test files whose testFilePath includes the given artifactPath.
+ * The original code uses `artifactPath + '/'` to prevent matching similar names.
+ */
+export declare function matchTests(artifactPath: string, testResults: TestFile[]): TestFile[];
+/** Return type for aggregateTestCounts. */
+export interface TestCounts {
+    numPassingTests: number;
+    numFailingTests: number;
+    numPendingTests: number;
+    numTodoTests: number;
+}
+/**
+ * Sums pass/fail/pending/todo test counts across a list of test files.
+ */
+export declare function aggregateTestCounts(tests: TestFile[]): TestCounts;
+/** Return type for buildArtifactId. */
+export interface ArtifactId {
+    id: string;
+    idMarkdown: string;
+}
+/**
+ * Generates an anchor-safe id and a filename-safe idMarkdown from the
+ * artifact name and context name.
+ *
+ * - `id`: "contextName-artifactName" lowered, spaces→hyphens, stripped of special chars
+ * - `idMarkdown`: "artifactName" lowered, spaces→hyphens, stripped of special chars
+ */
+export declare function buildArtifactId(name: string, contextName: string): ArtifactId;
+/**
+ * Enriches a raw artifact with JSDoc data, YAML definition, attachments,
+ * matched test results, and computed IDs.
+ *
+ * Calls data-loading functions (loadArtifactMetadataAndContent) for I/O
+ * and pure transformation functions for data processing.
+ */
+export declare function enrichArtifact(artifact: ArtifactRaw, jsdocElems: JsdocElem[], allTestResults: TestFile[], cwd: string, basePath: string, contextName: string): Promise<EnrichedArtifact>;
+/**
+ * Enriches a raw use-case with matched test results, aggregated test counts,
+ * and computed IDs.
+ *
+ * Uses the same matchTests and aggregateTestCounts as the domain pipeline.
+ * The ID-building differs from buildArtifactId: use-case IDs include the
+ * index (for uniqueness within a context) and idMarkdown uses the title
+ * instead of an artifact name.
+ */
+export declare function enrichUseCase(raw: UseCaseRaw, allTestResults: TestFile[], index: number, contextName: string): EnrichedUseCase;
+/**
+ * Matches JSDoc elements from .spec.ts files to individual test results.
+ *
+ * For each test result in each test file, finds the first JSDoc element
+ * whose `name` (from @name tag) is contained in the test's `fullName`
+ * AND whose `meta.path` shares at least one path segment with the test
+ * file's directory path.
+ *
+ * Matching annotations are attached as `result.annotation`.
+ *
+ * @param testFiles - Array of test files with their test results
+ * @param jsdocElems - JSDoc elements (may include spec.ts entries with annotations)
+ * @returns The test files with annotations attached (mutated in place)
+ */
+export declare function matchTestAnnotations(testFiles: TestFile[], jsdocElems: JsdocElem[]): TestFile[];
+/**
+ * Converts a list of enriched artifacts to manifest entries for the
+ * searchable artifact table.
+ *
+ * Aggregate artifacts get `categories: ["domain-artifacts", "aggregates"]`;
+ * all other types get `categories: ["domain-artifacts"]`.
+ *
+ * @param artifacts - The fully enriched artifacts
+ * @param contextName - The bounded context name for this package root
+ * @returns Manifest entries ready for serialization to JSON
+ */
+export declare function buildManifestEntries(artifacts: EnrichedArtifact[], contextName: string): ArtifactManifestEntry[];