@mf-toolkit/shared-inspector 0.1.0

package/dist/collector/traverse-local-modules.js

@@ -0,0 +1,119 @@
+import { readFile } from 'node:fs/promises';
+import { resolve, dirname, join } from 'node:path';
+import { scanFiles } from './collect-imports.js';
+import { parseDeclarations, isRelativeSpecifier, isNodeBuiltin, normalizePackageName, } from './parse-declarations.js';
+import { loadTsConfigPaths, resolveAliasedSpecifier, } from './resolve-tsconfig-paths.js';
+const DEFAULT_EXTENSIONS = ['.ts', '.tsx', '.js', '.jsx'];
+/**
+ * Local-graph mode collector.
+ *
+ * Scans all files in sourceDirs and follows relative import/export chains
+ * recursively within those directories. Finds external packages reachable
+ * through barrel re-exports and local module wrappers.
+ *
+ * When tsconfigPath is provided, TypeScript path aliases (e.g. '@app/*') are
+ * resolved to local files and followed in the same DFS — packages behind
+ * aliases become visible.
+ *
+ * Uses two-phase approach:
+ *   Phase 1 — parallel async reads of all source files into contentMap
+ *   Phase 2 — synchronous DFS over in-memory content (zero disk I/O)
+ */
+export async function traverseLocalModules(options) {
+    const extensions = options.extensions ?? DEFAULT_EXTENSIONS;
+    const files = await scanFiles(options.sourceDirs, extensions);
+    // Phase 1: pre-read all files in parallel — turns F sequential disk reads
+    // into a single concurrent batch, giving 3-8× speedup on large projects.
+    const contentMap = new Map();
+    await Promise.all(files.map(async (filePath) => {
+        try {
+            contentMap.set(filePath, await readFile(filePath, 'utf-8'));
+        }
+        catch {
+            // Unreadable files are skipped silently during DFS
+        }
+    }));
+    // Load tsconfig path aliases once, before DFS
+    const tsConfigPaths = options.tsconfigPath
+        ? loadTsConfigPaths(options.tsconfigPath)
+        : null;
+    const visited = new Set();
+    /** package → { files observed in, via: direct | reexport } */
+    const pkgMap = new Map();
+    // Phase 2: DFS over in-memory content — no disk I/O during traversal.
+    function visit(filePath) {
+        if (visited.has(filePath))
+            return;
+        visited.add(filePath);
+        const content = contentMap.get(filePath);
+        if (content === undefined)
+            return;
+        for (const decl of parseDeclarations(content)) {
+            // ── Relative import → follow locally ──────────────────────────────────
+            if (isRelativeSpecifier(decl.specifier)) {
+                const resolved = resolveLocalFile(decl.specifier, filePath, contentMap);
+                if (resolved)
+                    visit(resolved);
+                continue;
+            }
+            if (isNodeBuiltin(decl.specifier))
+                continue;
+            // ── TypeScript path alias → resolve and follow locally ────────────────
+            if (tsConfigPaths) {
+                const aliased = resolveAliasedSpecifier(decl.specifier, tsConfigPaths, contentMap);
+                if (aliased) {
+                    visit(aliased);
+                    continue;
+                }
+            }
+            // ── External package ──────────────────────────────────────────────────
+            const pkg = normalizePackageName(decl.specifier);
+            if (options.ignore?.some((p) => matchesIgnorePattern(pkg, p)))
+                continue;
+            if (options.workspacePackages?.some((p) => matchesIgnorePattern(pkg, p)))
+                continue;
+            const via = decl.kind === 'reexport' ? 'reexport' : 'direct';
+            const existing = pkgMap.get(pkg);
+            if (!existing) {
+                pkgMap.set(pkg, { files: new Set([filePath]), via });
+            }
+            else {
+                existing.files.add(filePath);
+                // Direct import takes precedence: once seen as direct, stays direct
+                if (via === 'direct')
+                    existing.via = 'direct';
+            }
+        }
+    }
+    for (const file of files) {
+        visit(file);
+    }
+    // One PackageOccurrence per (package, file) pair — consistent with collectImports
+    return Array.from(pkgMap.entries()).flatMap(([pkg, { files: fileSet, via }]) => [...fileSet].map((file) => ({ package: pkg, file, via })));
+}
+// ─── Local file resolver ──────────────────────────────────────────────────────
+/**
+ * Resolves a relative specifier to an absolute file path.
+ * Uses the pre-built contentMap (Map lookup) instead of existsSync —
+ * zero disk I/O during DFS traversal.
+ */
+function resolveLocalFile(specifier, fromFile, contentMap) {
+    const base = resolve(dirname(fromFile), specifier);
+    for (const ext of ['.ts', '.tsx', '.js', '.jsx']) {
+        const candidate = base + ext;
+        if (contentMap.has(candidate))
+            return candidate;
+    }
+    for (const ext of ['.ts', '.tsx', '.js', '.jsx']) {
+        const candidate = join(base, 'index' + ext);
+        if (contentMap.has(candidate))
+            return candidate;
+    }
+    return null;
+}
+function matchesIgnorePattern(pkg, pattern) {
+    if (pattern.endsWith('/*'))
+        return pkg.startsWith(pattern.slice(0, -2) + '/');
+    return pkg === pattern;
+}
+//# sourceMappingURL=traverse-local-modules.js.map

package/dist/collector/traverse-local-modules.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { buildProjectManifest } from './collector/build-project-manifest.js';
+export { analyzeProject } from './analyzer/analyze-project.js';
+export { inspect } from './inspect.js';
+export { formatReport } from './reporter/format-report.js';
+export { writeReport, writeManifest } from './reporter/write-report.js';
+export type { ProjectManifest, ProjectReport, CollectorOptions, AnalysisOptions, SharedDepConfig, PackageOccurrence, UnusedEntry, CandidateEntry, MismatchedEntry, SingletonRiskEntry, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGxE,YAAY,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// ─── Two-phase API ────────────────────────────────────────────────────────────
+export { buildProjectManifest } from './collector/build-project-manifest.js';
+export { analyzeProject } from './analyzer/analyze-project.js';
+// ─── Shortcut API ─────────────────────────────────────────────────────────────
+export { inspect } from './inspect.js';
+// ─── Reporter ─────────────────────────────────────────────────────────────────
+export { formatReport } from './reporter/format-report.js';
+export { writeReport, writeManifest } from './reporter/write-report.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,iFAAiF;AACjF,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/inspect.d.ts

@@ -0,0 +1,12 @@
+import type { CollectorOptions, AnalysisOptions, ProjectReport } from './types.js';
+/**
+ * Shortcut API — combines buildProjectManifest() + analyzeProject() in one call.
+ *
+ * Use this when you only need the report and don't need the intermediate manifest.
+ * For CI pipelines or multi-project federation analysis, use the two-phase API
+ * directly so you can persist and share the manifest.
+ */
+export declare function inspect(options: CollectorOptions & {
+    analysis?: AnalysisOptions;
+}): Promise<ProjectReport>;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAInF;;;;;;GAMG;AACH,wBAAsB,OAAO,CAC3B,OAAO,EAAE,gBAAgB,GAAG;IAAE,QAAQ,CAAC,EAAE,eAAe,CAAA;CAAE,GACzD,OAAO,CAAC,aAAa,CAAC,CAIxB"}

package/dist/inspect.js

@@ -0,0 +1,15 @@
+import { buildProjectManifest } from './collector/build-project-manifest.js';
+import { analyzeProject } from './analyzer/analyze-project.js';
+/**
+ * Shortcut API — combines buildProjectManifest() + analyzeProject() in one call.
+ *
+ * Use this when you only need the report and don't need the intermediate manifest.
+ * For CI pipelines or multi-project federation analysis, use the two-phase API
+ * directly so you can persist and share the manifest.
+ */
+export async function inspect(options) {
+    const { analysis, ...collectorOptions } = options;
+    const manifest = await buildProjectManifest(collectorOptions);
+    return analyzeProject(manifest, analysis);
+}
+//# sourceMappingURL=inspect.js.map

package/dist/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../src/inspect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,OAA0D;IAE1D,MAAM,EAAE,QAAQ,EAAE,GAAG,gBAAgB,EAAE,GAAG,OAAO,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;IAC9D,OAAO,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC5C,CAAC"}

package/dist/plugins/webpack.d.ts

@@ -0,0 +1,40 @@
+import type { WebpackPluginOptions } from '../types.js';
+interface WebpackCompilation {
+    errors: Error[];
+    warnings: Error[];
+}
+interface WebpackCompiler {
+    context: string;
+    options: {
+        name?: string;
+    };
+    hooks: {
+        afterCompile: {
+            tapPromise(name: string, fn: (compilation: WebpackCompilation) => Promise<void>): void;
+        };
+    };
+}
+/**
+ * Webpack plugin that analyses Module Federation shared dependencies after
+ * each compilation and reports issues to the console and/or build output.
+ *
+ * In v0.1, `sharedConfig` must be provided explicitly. Auto-extraction from
+ * ModuleFederationPlugin is planned for v0.1.1.
+ *
+ * @example
+ * ```js
+ * new MfSharedInspectorPlugin({
+ *   sourceDirs: ['./src'],
+ *   sharedConfig: { react: { singleton: true }, mobx: { singleton: true } },
+ *   warn: true,
+ *   writeManifest: true,
+ * })
+ * ```
+ */
+export declare class MfSharedInspectorPlugin {
+    private options;
+    constructor(options: WebpackPluginOptions);
+    apply(compiler: WebpackCompiler): void;
+}
+export {};
+//# sourceMappingURL=webpack.d.ts.map

package/dist/plugins/webpack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webpack.d.ts","sourceRoot":"","sources":["../../src/plugins/webpack.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AASxD,UAAU,kBAAkB;IAC1B,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,QAAQ,EAAE,KAAK,EAAE,CAAC;CACnB;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,EAAE;QACL,YAAY,EAAE;YACZ,UAAU,CACR,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,CAAC,WAAW,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GACrD,IAAI,CAAC;SACT,CAAC;KACH,CAAC;CACH;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAAuB;gBAE1B,OAAO,EAAE,oBAAoB;IAIzC,KAAK,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;CAyFvC"}

package/dist/plugins/webpack.js

@@ -0,0 +1,95 @@
+import { isAbsolute, join, basename } from 'node:path';
+import { buildProjectManifest } from '../collector/build-project-manifest.js';
+import { analyzeProject } from '../analyzer/analyze-project.js';
+import { formatReport } from '../reporter/format-report.js';
+import { writeManifest } from '../reporter/write-report.js';
+// ─────────────────────────────────────────────────────────────────────────────
+const PLUGIN_NAME = 'MfSharedInspectorPlugin';
+/**
+ * Webpack plugin that analyses Module Federation shared dependencies after
+ * each compilation and reports issues to the console and/or build output.
+ *
+ * In v0.1, `sharedConfig` must be provided explicitly. Auto-extraction from
+ * ModuleFederationPlugin is planned for v0.1.1.
+ *
+ * @example
+ * ```js
+ * new MfSharedInspectorPlugin({
+ *   sourceDirs: ['./src'],
+ *   sharedConfig: { react: { singleton: true }, mobx: { singleton: true } },
+ *   warn: true,
+ *   writeManifest: true,
+ * })
+ * ```
+ */
+export class MfSharedInspectorPlugin {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    apply(compiler) {
+        compiler.hooks.afterCompile.tapPromise(PLUGIN_NAME, async (compilation) => {
+            const { sourceDirs, depth = 'local-graph', sharedConfig, kind, packageJsonPath, extensions, ignore, parser, analysis, warn = true, failOn, writeManifest: shouldWriteManifest = false, outputDir = '.', } = this.options;
+            // Resolve name from webpack compiler, fallback to context dir name
+            const name = compiler.options.name ?? basename(compiler.context);
+            // Resolve paths relative to compiler.context when not absolute
+            const resolvedPkgJson = packageJsonPath
+                ? (isAbsolute(packageJsonPath) ? packageJsonPath : join(compiler.context, packageJsonPath))
+                : join(compiler.context, 'package.json');
+            const resolvedSourceDirs = sourceDirs.map((dir) => isAbsolute(dir) ? dir : join(compiler.context, dir));
+            const resolvedOutputDir = isAbsolute(outputDir)
+                ? outputDir
+                : join(compiler.context, outputDir);
+            try {
+                const manifest = await buildProjectManifest({
+                    name,
+                    sourceDirs: resolvedSourceDirs,
+                    depth,
+                    sharedConfig,
+                    kind,
+                    packageJsonPath: resolvedPkgJson,
+                    extensions,
+                    ignore,
+                    parser,
+                });
+                const report = analyzeProject(manifest, analysis);
+                const hasFindings = report.mismatched.length > 0 ||
+                    report.unused.length > 0 ||
+                    report.candidates.length > 0 ||
+                    report.singletonRisks.length > 0;
+                if (warn && hasFindings) {
+                    console.warn(formatReport(report, {
+                        name: manifest.project.name,
+                        depth: manifest.source.depth,
+                        filesScanned: manifest.source.filesScanned,
+                    }));
+                }
+                if (shouldWriteManifest) {
+                    await writeManifest(manifest, join(resolvedOutputDir, 'project-manifest.json'));
+                }
+                if (failOn && shouldFailBuild(failOn, report)) {
+                    const msg = `[${PLUGIN_NAME}] Build failed (failOn: "${failOn}"): ` +
+                        `${report.mismatched.length} mismatch, ${report.unused.length} unused, ` +
+                        `${report.candidates.length} candidates, ${report.singletonRisks.length} singleton risks.`;
+                    compilation.errors.push(new Error(msg));
+                }
+            }
+            catch (err) {
+                // Analysis errors are non-fatal — warn but don't break the build
+                compilation.warnings.push(new Error(`[${PLUGIN_NAME}] Analysis failed: ${err instanceof Error ? err.message : String(err)}`));
+            }
+        });
+    }
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function shouldFailBuild(failOn, report) {
+    switch (failOn) {
+        case 'mismatch': return report.mismatched.length > 0;
+        case 'unused': return report.unused.length > 0;
+        case 'any': return (report.mismatched.length > 0 ||
+            report.unused.length > 0 ||
+            report.candidates.length > 0 ||
+            report.singletonRisks.length > 0);
+    }
+}
+//# sourceMappingURL=webpack.js.map

package/dist/plugins/webpack.js.map

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

package/dist/reporter/format-report.d.ts

@@ -0,0 +1,18 @@
+import type { ProjectReport } from '../types.js';
+export interface FormatReportContext {
+    name?: string;
+    depth?: 'direct' | 'local-graph';
+    filesScanned?: number;
+}
+/**
+ * Formats a ProjectReport as a human-readable terminal string.
+ *
+ * Section order (by severity / determinism):
+ *   1. Version mismatch  — deterministic, most dangerous
+ *   2. Unused shared     — deterministic, easy wins
+ *   3. Candidates        — heuristic, actionable suggestions
+ *   4. Singleton risks   — heuristic, potential runtime issues
+ *   5. Summary line
+ */
+export declare function formatReport(report: ProjectReport, ctx?: FormatReportContext): string;
+//# sourceMappingURL=format-report.d.ts.map

package/dist/reporter/format-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-report.d.ts","sourceRoot":"","sources":["../../src/reporter/format-report.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,GAAG,aAAa,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,EAAE,mBAAmB,GAAG,MAAM,CA6ErF"}

package/dist/reporter/format-report.js

@@ -0,0 +1,87 @@
+/**
+ * Formats a ProjectReport as a human-readable terminal string.
+ *
+ * Section order (by severity / determinism):
+ *   1. Version mismatch  — deterministic, most dangerous
+ *   2. Unused shared     — deterministic, easy wins
+ *   3. Candidates        — heuristic, actionable suggestions
+ *   4. Singleton risks   — heuristic, potential runtime issues
+ *   5. Summary line
+ */
+export function formatReport(report, ctx) {
+    const lines = [];
+    const { unused, candidates, mismatched, singletonRisks, eagerRisks, summary } = report;
+    // Header
+    const header = buildHeader(ctx);
+    lines.push('', header, '');
+    const hasFindings = mismatched.length > 0 ||
+        unused.length > 0 ||
+        candidates.length > 0 ||
+        singletonRisks.length > 0 ||
+        eagerRisks.length > 0;
+    if (!hasFindings) {
+        lines.push('  No issues found. Shared config looks good.');
+    }
+    // ── 1. Version mismatch ────────────────────────────────────────────────────
+    if (mismatched.length > 0) {
+        lines.push('  Version mismatch (sharing silently broken):');
+        for (const m of mismatched) {
+            lines.push(`    ⚠ ${m.package} — requires ${m.configured}, installed ${m.installed}`);
+        }
+        lines.push('');
+    }
+    // ── 2. Unused shared ──────────────────────────────────────────────────────
+    if (unused.length > 0) {
+        lines.push('  Unused shared (safe to remove):');
+        for (const u of unused) {
+            const note = u.singleton ? 'shared as singleton' : 'shared without singleton';
+            lines.push(`    ✗ ${u.package} — 0 imports, ${note}`);
+        }
+        lines.push('');
+    }
+    // ── 3. Candidates ─────────────────────────────────────────────────────────
+    if (candidates.length > 0) {
+        lines.push('  Candidates (consider adding to shared):');
+        for (const c of candidates) {
+            const fileCount = c.files.length;
+            const filesLabel = fileCount === 1 ? '1 file' : `${fileCount} files`;
+            const viaLabel = c.via === 'reexport' ? `, via re-export in ${c.files[0]}` : '';
+            lines.push(`    → ${c.package} (${c.importCount} imports in ${filesLabel}${viaLabel})`);
+        }
+        lines.push('');
+    }
+    // ── 4. Singleton risks ────────────────────────────────────────────────────
+    if (singletonRisks.length > 0) {
+        lines.push('  Singleton risks (add singleton: true):');
+        for (const r of singletonRisks) {
+            lines.push(`    ⚠ ${r.package} — manages global state, singleton: true recommended`);
+        }
+        lines.push('');
+    }
+    // ── 5. Eager risks ────────────────────────────────────────────────────────
+    if (eagerRisks.length > 0) {
+        lines.push('  Eager risks (add singleton: true or remove eager: true):');
+        for (const r of eagerRisks) {
+            lines.push(`    ⚠ ${r.package} — eager: true without singleton: true, risk of duplicate instances`);
+        }
+        lines.push('');
+    }
+    // ── 6. Summary ────────────────────────────────────────────────────────────
+    lines.push(`  Total: ${summary.totalShared} shared, ${summary.usedShared} used, ` +
+        `${summary.unusedCount} unused, ${summary.candidatesCount} candidates, ` +
+        `${summary.mismatchedCount} mismatch, ${summary.eagerRisksCount} eager risks`);
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function buildHeader(ctx) {
+    const parts = [];
+    if (ctx?.depth)
+        parts.push(`depth: ${ctx.depth}`);
+    if (ctx?.filesScanned !== undefined)
+        parts.push(`${ctx.filesScanned} files scanned`);
+    const meta = parts.length > 0 ? ` (${parts.join(', ')})` : '';
+    const name = ctx?.name ? ` ${ctx.name}` : '';
+    return `[MfSharedInspector]${name}${meta}`;
+}
+//# sourceMappingURL=format-report.js.map

package/dist/reporter/format-report.js.map

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

package/dist/reporter/write-report.d.ts

@@ -0,0 +1,12 @@
+import type { ProjectReport, ProjectManifest } from '../types.js';
+/**
+ * Serialises a ProjectReport to a JSON file.
+ * Creates parent directories if they don't exist.
+ */
+export declare function writeReport(report: ProjectReport, outputPath: string): Promise<void>;
+/**
+ * Serialises a ProjectManifest to a JSON file.
+ * Creates parent directories if they don't exist.
+ */
+export declare function writeManifest(manifest: ProjectManifest, outputPath: string): Promise<void>;
+//# sourceMappingURL=write-report.d.ts.map

package/dist/reporter/write-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-report.d.ts","sourceRoot":"","sources":["../../src/reporter/write-report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAElE;;;GAGG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1F;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhG"}

package/dist/reporter/write-report.js

@@ -0,0 +1,19 @@
+import { writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+/**
+ * Serialises a ProjectReport to a JSON file.
+ * Creates parent directories if they don't exist.
+ */
+export async function writeReport(report, outputPath) {
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, JSON.stringify(report, null, 2), 'utf-8');
+}
+/**
+ * Serialises a ProjectManifest to a JSON file.
+ * Creates parent directories if they don't exist.
+ */
+export async function writeManifest(manifest, outputPath) {
+    await mkdir(dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, JSON.stringify(manifest, null, 2), 'utf-8');
+}
+//# sourceMappingURL=write-report.js.map

package/dist/reporter/write-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-report.js","sourceRoot":"","sources":["../../src/reporter/write-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAqB,EAAE,UAAkB;IACzE,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAyB,EAAE,UAAkB;IAC/E,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAC1E,CAAC"}