perfgraph 0.1.0

package/dist/normalize/types.js

@@ -0,0 +1,242 @@
+/**
+ * IR (Intermediate Representation) Zod schemas and inferred TypeScript types.
+ *
+ * All IR types use relative timestamps (ms since navigationStart) for
+ * consistent downstream analysis regardless of the original clock domain.
+ *
+ * Every schema has a corresponding inferred type exported for use in
+ * function signatures and property access without manual type annotations.
+ */
+import { z } from 'zod';
+// ---------------------------------------------------------------------------
+// Performance IR
+// ---------------------------------------------------------------------------
+export const PerformanceNavigationSchema = z.object({
+    url: z.string(),
+    navigationStart: z.number(),
+    domContentLoaded: z.number(),
+    domContentLoadedEventEnd: z.number(),
+    loadEventStart: z.number(),
+    loadEventEnd: z.number(),
+    domInteractive: z.number(),
+    title: z.string().optional(),
+});
+export const CoreWebVitalsSchema = z.object({
+    fcp: z.number().optional(),
+    lcp: z.number().optional(),
+    cls: z.number().optional(),
+    tbt: z.number().optional(),
+    inp: z.number().optional(),
+});
+export const ThreadActivitySchema = z.object({
+    totalMs: z.number(),
+    byCategory: z.record(z.string(), z.number()),
+});
+export const TraceSummarySchema = z.object({
+    totalDuration: z.number(),
+    eventCount: z.number(),
+    categories: z.record(z.string(), z.number()),
+    threadActivity: ThreadActivitySchema,
+});
+export const PerformanceIRSchema = z.object({
+    navigation: PerformanceNavigationSchema,
+    coreWebVitals: CoreWebVitalsSchema,
+    traceSummary: TraceSummarySchema,
+    mainThreadBusyness: z.number().min(0).max(1),
+});
+// ---------------------------------------------------------------------------
+// Network IR
+// ---------------------------------------------------------------------------
+export const NormalizedRequestTimingSchema = z.object({
+    dns: z.number().optional(),
+    connect: z.number().optional(),
+    ssl: z.number().optional(),
+    wait: z.number().optional(),
+    receive: z.number().optional(),
+});
+export const NormalizedRequestSchema = z.object({
+    url: z.string(),
+    method: z.string(),
+    resourceType: z.string(),
+    statusCode: z.number().int(),
+    startTime: z.number(),
+    endTime: z.number(),
+    duration: z.number(),
+    bytes: z.number(),
+    priority: z.string(),
+    initiator: z.string(),
+    initiatorUrl: z.string().optional(),
+    failed: z.boolean(),
+    timing: NormalizedRequestTimingSchema,
+});
+export const NormalizedRequestChainSchema = z.object({
+    url: z.string(),
+    length: z.number(),
+});
+export const CriticalPathTreeNodeSchema = z.lazy(() => z.object({
+    url: z.string(),
+    durationMs: z.number().optional(),
+    children: z.array(CriticalPathTreeNodeSchema).optional(),
+}));
+export const CriticalPathInfoSchema = z.object({
+    tree: CriticalPathTreeNodeSchema,
+    depth: z.number().int().nonnegative(),
+    urlsOnLongestPath: z.array(z.string()),
+});
+export const NetworkIRSummarySchema = z.object({
+    totalRequests: z.number(),
+    totalBytes: z.number(),
+    byType: z.record(z.string(), z.number()),
+    byPriority: z.record(z.string(), z.number()),
+    criticalPath: CriticalPathInfoSchema,
+    longestChain: NormalizedRequestChainSchema,
+});
+export const NetworkIRSchema = z.object({
+    requests: z.array(NormalizedRequestSchema),
+    summary: NetworkIRSummarySchema,
+});
+// ---------------------------------------------------------------------------
+// Runtime IR
+// ---------------------------------------------------------------------------
+export const RuntimeIRStatsSchema = z.object({
+    totalJSHeapSize: z.number().optional(),
+    usedJSHeapSize: z.number().optional(),
+    jsHeapSizeLimit: z.number().optional(),
+});
+export const ExecutionContextSchema = z.object({
+    id: z.number(),
+    origin: z.string(),
+    name: z.string().optional(),
+});
+export const EventLoopStatsSchema = z.object({
+    totalBlockingDuration: z.number(),
+    longTasks: z.number(),
+    maxBlockingDuration: z.number(),
+});
+export const HydrationCostSchema = z.object({
+    bootupTime: z.number(),
+    evaluatedScripts: z.number(),
+});
+export const RuntimeIRSchema = z.object({
+    jsHeapStats: RuntimeIRStatsSchema.optional(),
+    executionContexts: z.array(ExecutionContextSchema),
+    eventLoopStats: EventLoopStatsSchema.optional(),
+    hydrationCost: HydrationCostSchema.optional(),
+});
+// ---------------------------------------------------------------------------
+// DOM IR
+// ---------------------------------------------------------------------------
+export const DOMStatsSchema = z.object({
+    totalNodes: z.number(),
+    elementCount: z.number(),
+    maxDepth: z.number(),
+    maxChildren: z.number(),
+});
+export const TagCountSchema = z.object({
+    tag: z.string(),
+    count: z.number(),
+});
+export const LayoutShiftCandidatesSchema = z.object({
+    highComplexitySubtrees: z.number(),
+    deepNesting: z.number(),
+});
+export const DOMIRSchema = z.object({
+    stats: DOMStatsSchema,
+    tagDistribution: z.array(TagCountSchema),
+    layoutShiftCandidates: LayoutShiftCandidatesSchema,
+});
+// ---------------------------------------------------------------------------
+// Lighthouse IR
+// ---------------------------------------------------------------------------
+export const LighthouseCategorySchema = z.object({
+    title: z.string(),
+    score: z.number().min(0).max(1),
+});
+export const LighthouseFailedAuditSchema = z.object({
+    id: z.string(),
+    title: z.string(),
+    description: z.string(),
+    score: z.number(),
+    numericValue: z.number().optional(),
+});
+export const LighthouseScoresSchema = z.object({
+    performance: z.number().min(0).max(1).optional(),
+    accessibility: z.number().min(0).max(1).optional(),
+    bestPractices: z.number().min(0).max(1).optional(),
+    seo: z.number().min(0).max(1).optional(),
+});
+export const RenderBlockingResourceSchema = z.object({
+    url: z.string(),
+    totalBytes: z.number().optional(),
+    wastedMs: z.number().optional(),
+    resourceType: z.string().optional(),
+});
+export const RenderBlockingInsightSchema = z.object({
+    fcpSavingsMs: z.number().optional(),
+    lcpSavingsMs: z.number().optional(),
+    resources: z.array(RenderBlockingResourceSchema),
+});
+export const LighthouseIRSchema = z.object({
+    categories: z.record(z.string(), LighthouseCategorySchema),
+    failedAudits: z.array(LighthouseFailedAuditSchema),
+    scores: LighthouseScoresSchema,
+    /** Lighthouse LCP numeric value in ms (fallback when trace lacks LCP) */
+    lcpNumericValue: z.number().optional(),
+    /** LCP element selector from lcp-breakdown-insight */
+    lcpElementSelector: z.string().optional(),
+    /** LCP element snippet from lcp-breakdown-insight */
+    lcpElementSnippet: z.string().optional(),
+    /** LCP element node label from lcp-breakdown-insight */
+    lcpElementNodeLabel: z.string().optional(),
+    /** Render-blocking resources with URL, bytes, and wasted ms */
+    renderBlockingResources: z.array(RenderBlockingResourceSchema).optional(),
+});
+// ---------------------------------------------------------------------------
+// Lighthouse Insights (v13+ insight audits)
+// ---------------------------------------------------------------------------
+export const LCPBreakdownInsightSchema = z.object({
+    timeToFirstByte: z.number(),
+    resourceLoadDelay: z.number().optional(),
+    resourceLoadTime: z.number().optional(),
+    elementRenderDelay: z.number(),
+    lcpElementSelector: z.string().optional(),
+    lcpElementSnippet: z.string().optional(),
+    lcpElementNodeLabel: z.string().optional(),
+    source: z.enum(['trace', 'lighthouse', 'mixed']),
+});
+export const NetworkChainNodeSchema = z.lazy(() => z.object({
+    url: z.string(),
+    navStartToEndTime: z.number(),
+    transferSize: z.number().optional(),
+    isLongest: z.boolean().optional(),
+    children: z.record(z.string(), NetworkChainNodeSchema).optional(),
+}));
+export const NetworkDependencyTreeInsightSchema = z.object({
+    chains: z.record(z.string(), NetworkChainNodeSchema).optional(),
+    longestChainDuration: z.number().optional(),
+    longestChainUrls: z.array(z.string()).optional(),
+    preconnectCandidates: z.array(z.string()).optional(),
+});
+export const LighthouseInsightsSchema = z.object({
+    lcpBreakdown: LCPBreakdownInsightSchema.optional(),
+    renderBlocking: RenderBlockingInsightSchema.optional(),
+    networkDependencyTree: NetworkDependencyTreeInsightSchema.optional(),
+});
+// ---------------------------------------------------------------------------
+// IR Bundle
+// ---------------------------------------------------------------------------
+export const IRMetaSchema = z.object({
+    url: z.string(),
+    fetchedAt: z.string(),
+    navigationStart: z.number(),
+    irVersion: z.literal('1.0.0'),
+});
+export const IRBundleSchema = z.strictObject({
+    meta: IRMetaSchema,
+    performance: PerformanceIRSchema,
+    network: NetworkIRSchema,
+    runtime: RuntimeIRSchema,
+    dom: DOMIRSchema,
+    lighthouse: LighthouseIRSchema,
+});
+//# sourceMappingURL=types.js.map

package/dist/normalize/types.js.map

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

package/dist/output/manifest.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Manifest generator — scans a run directory and produces a manifest.toon
+ * listing all known artifacts with descriptions, sizes, and recommended read order.
+ *
+ * @packageDocumentation
+ */
+/** A single artifact entry in the manifest. */
+export interface ManifestEntry {
+    /** File name (e.g. "report.toon") */
+    filename: string;
+    /** Human-readable description of what this artifact contains */
+    description: string;
+    /** Recommended read order — lower values should be read first */
+    readOrder?: number;
+    /** File size in bytes, if available */
+    sizeBytes?: number;
+}
+/** The full manifest document written as manifest.toon. */
+export interface Manifest {
+    /** Absolute path to the run directory */
+    runDir: string;
+    /** ISO timestamp when the manifest was generated */
+    generatedAt: string;
+    /** All discovered artifacts */
+    artifacts: ManifestEntry[];
+    /** Filenames in recommended reading order (subset of artifacts) */
+    recommendedReadOrder: string[];
+}
+/**
+ * Scan a PerfGraph run directory and write a manifest.toon describing all
+ * discovered artifacts.
+ *
+ * Only files listed in the known-artifacts table are included with
+ * descriptions and read-order hints; any other JSON / TOON files present in the
+ * directory are listed with their filename and size only.
+ *
+ * The manifest includes itself after writing, so the `manifest.toon` entry
+ * always carries the correct size.
+ *
+ * @param dir - Absolute or relative path to the run directory
+ * @returns Absolute path to the written manifest.toon
+ */
+export declare function writeManifest(dir: string): Promise<string>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/output/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/output/manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,QAAQ;IACvB,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,mEAAmE;IACnE,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AA8HD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+HhE"}

package/dist/output/manifest.js

@@ -0,0 +1,232 @@
+/**
+ * Manifest generator — scans a run directory and produces a manifest.toon
+ * listing all known artifacts with descriptions, sizes, and recommended read order.
+ *
+ * @packageDocumentation
+ */
+import { readdir, stat, writeFile } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { convertToon } from './toon.js';
+// ---------------------------------------------------------------------------
+// Known artifacts
+// ---------------------------------------------------------------------------
+/** Canonical list of known artifacts with descriptions and suggested read order. */
+const KNOWN_ARTIFACTS = [
+    {
+        filename: 'insights.toon',
+        description: 'Agent-optimized performance summary with Lighthouse scores, LCP breakdown, render-blocking URLs, and top recommendations',
+        readOrder: 1,
+    },
+    {
+        filename: 'report.md',
+        description: 'Human-readable performance report in Markdown with score summary, issues, causal chains, and recommendations',
+        readOrder: 2,
+    },
+    {
+        filename: 'report.toon',
+        description: 'Full diagnostic report with issues sorted by severity, causal chains, and remediation text',
+        readOrder: 3,
+    },
+    {
+        filename: 'manifest.toon',
+        description: 'This file — artifact index with descriptions and sizes',
+        readOrder: 3,
+    },
+    {
+        filename: 'features.toon',
+        description: 'Raw diagnostic features: LCP breakdown, critical path, TBT, CLS, render-blocking score',
+        readOrder: 4,
+    },
+    {
+        filename: 'graph.toon',
+        description: 'Causal degradation graph — DAG of performance issues and their relationships',
+        readOrder: 5,
+    },
+    {
+        filename: 'ir.json',
+        description: 'Normalized Intermediate Representation (IRBundle) — all collected data in a validated schema',
+        readOrder: 6,
+    },
+    {
+        filename: 'lighthouse.json',
+        description: 'Full Lighthouse v13+ audit results (large — read only for deep dives)',
+        readOrder: 7,
+    },
+    {
+        filename: 'network.json',
+        description: 'Raw network request data (large — read only for deep dives)',
+        readOrder: 8,
+    },
+    {
+        filename: 'network-summary.toon',
+        description: 'Top 20 requests by duration, blocking list, initiator chain summary',
+        readOrder: 9,
+    },
+    {
+        filename: 'lighthouse-summary.toon',
+        description: 'Lighthouse categories and failed insight audits only',
+        readOrder: 10,
+    },
+    {
+        filename: 'coverage-summary.toon',
+        description: 'Unused bytes by URL, top 10 files',
+        readOrder: 11,
+    },
+    {
+        filename: 'trace.json',
+        description: 'Raw Chrome trace events (very large — read only for deep dives)',
+        readOrder: 12,
+    },
+    {
+        filename: 'performance.json',
+        description: 'Performance API metrics from the page',
+        readOrder: 13,
+    },
+    {
+        filename: 'runtime.json',
+        description: 'JS heap stats, execution contexts, event loop',
+        readOrder: 14,
+    },
+    {
+        filename: 'console.json',
+        description: 'Captured console log entries',
+        readOrder: 15,
+    },
+    {
+        filename: 'dom.json',
+        description: 'DOM snapshot and statistics',
+        readOrder: 16,
+    },
+    {
+        filename: 'warnings.json',
+        description: 'Collection warnings (missing data, incomplete traces)',
+        readOrder: 17,
+    },
+    {
+        filename: 'runs-summary.json',
+        description: 'Summary across multiple collection runs (only when --runs > 1)',
+        readOrder: 18,
+    },
+];
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Scan a PerfGraph run directory and write a manifest.toon describing all
+ * discovered artifacts.
+ *
+ * Only files listed in the known-artifacts table are included with
+ * descriptions and read-order hints; any other JSON / TOON files present in the
+ * directory are listed with their filename and size only.
+ *
+ * The manifest includes itself after writing, so the `manifest.toon` entry
+ * always carries the correct size.
+ *
+ * @param dir - Absolute or relative path to the run directory
+ * @returns Absolute path to the written manifest.toon
+ */
+export async function writeManifest(dir) {
+    const resolvedDir = resolve(dir);
+    // -----------------------------------------------------------------------
+    // 1. Scan the directory (exclude manifest.toon since we're about to write it)
+    // -----------------------------------------------------------------------
+    const dirEntries = await readdir(resolvedDir, { withFileTypes: true });
+    const existingFiles = new Set(dirEntries
+        .filter((e) => e.isFile() && e.name !== 'manifest.toon')
+        .map((e) => e.name));
+    // -----------------------------------------------------------------------
+    // 2. Build artifact entries
+    // -----------------------------------------------------------------------
+    const artifacts = [];
+    // 2a. Known artifacts that actually exist
+    for (const known of KNOWN_ARTIFACTS) {
+        if (known.filename === 'manifest.toon')
+            continue; // handled after writing
+        if (!existingFiles.has(known.filename))
+            continue;
+        let sizeBytes;
+        try {
+            const s = await stat(join(resolvedDir, known.filename));
+            sizeBytes = s.size;
+        }
+        catch {
+            // stat failed — skip size
+        }
+        artifacts.push({
+            filename: known.filename,
+            description: known.description,
+            readOrder: known.readOrder,
+            sizeBytes,
+        });
+    }
+    // 2b. Any other JSON / TOON files not in the known list
+    for (const filename of existingFiles) {
+        if ((!filename.endsWith('.json') && !filename.endsWith('.toon')) ||
+            KNOWN_ARTIFACTS.some((a) => a.filename === filename)) {
+            continue;
+        }
+        let sizeBytes;
+        try {
+            const s = await stat(join(resolvedDir, filename));
+            sizeBytes = s.size;
+        }
+        catch {
+            // ignore
+        }
+        artifacts.push({ filename, description: '', sizeBytes });
+    }
+    // -----------------------------------------------------------------------
+    // 3. Sort — known artifacts by readOrder, unknown artifacts after
+    // -----------------------------------------------------------------------
+    artifacts.sort((a, b) => {
+        const aOrder = a.readOrder ?? 999;
+        const bOrder = b.readOrder ?? 999;
+        if (aOrder !== bOrder)
+            return aOrder - bOrder;
+        return a.filename.localeCompare(b.filename);
+    });
+    const recommendedReadOrder = artifacts
+        .filter((a) => a.readOrder !== undefined)
+        .sort((a, b) => (a.readOrder ?? 0) - (b.readOrder ?? 0))
+        .map((a) => a.filename);
+    // -----------------------------------------------------------------------
+    // 4. First write (without self-referential manifest.toon entry)
+    // -----------------------------------------------------------------------
+    const manifestPath = join(resolvedDir, 'manifest.toon');
+    await writeFile(manifestPath, await convertToon({
+        runDir: resolvedDir,
+        generatedAt: new Date().toISOString(),
+        artifacts,
+        recommendedReadOrder,
+    }), 'utf-8');
+    // -----------------------------------------------------------------------
+    // 5. Add self-referential entry and re-write with correct size
+    // -----------------------------------------------------------------------
+    const manifestStat = await stat(manifestPath);
+    artifacts.push({
+        filename: 'manifest.toon',
+        description: 'This file — artifact index with descriptions and sizes',
+        readOrder: 3,
+        sizeBytes: manifestStat.size,
+    });
+    // Re-sort with the new entry
+    artifacts.sort((a, b) => {
+        const aOrder = a.readOrder ?? 999;
+        const bOrder = b.readOrder ?? 999;
+        if (aOrder !== bOrder)
+            return aOrder - bOrder;
+        return a.filename.localeCompare(b.filename);
+    });
+    const updatedReadOrder = artifacts
+        .filter((a) => a.readOrder !== undefined)
+        .sort((a, b) => (a.readOrder ?? 0) - (b.readOrder ?? 0))
+        .map((a) => a.filename);
+    await writeFile(manifestPath, await convertToon({
+        runDir: resolvedDir,
+        generatedAt: new Date().toISOString(),
+        artifacts,
+        recommendedReadOrder: updatedReadOrder,
+    }), 'utf-8');
+    return manifestPath;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/output/manifest.js.map

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

package/dist/output/toon.d.ts

@@ -0,0 +1,19 @@
+/**
+ * TOON format converter — encodes JSON-serializable data to TOON format
+ * using @toon-format/toon for token-efficient LLM consumption.
+ *
+ * @packageDocumentation
+ */
+/**
+ * Encode any JSON-serializable value into TOON format string.
+ *
+ * TOON (Token-Oriented Object Notation) is a compact, human-readable,
+ * schema-aware encoding of JSON designed to minimise token usage in
+ * LLM prompts. It declares array lengths and field headers once, then
+ * streams row values.
+ *
+ * @param data - Any JSON-serializable value (object, array, primitive)
+ * @returns A TOON-formatted string
+ */
+export declare function convertToon(data: unknown): Promise<string>;
+//# sourceMappingURL=toon.d.ts.map

package/dist/output/toon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toon.d.ts","sourceRoot":"","sources":["../../src/output/toon.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAEhE"}

package/dist/output/toon.js

@@ -0,0 +1,22 @@
+/**
+ * TOON format converter — encodes JSON-serializable data to TOON format
+ * using @toon-format/toon for token-efficient LLM consumption.
+ *
+ * @packageDocumentation
+ */
+import { encode } from '@toon-format/toon';
+/**
+ * Encode any JSON-serializable value into TOON format string.
+ *
+ * TOON (Token-Oriented Object Notation) is a compact, human-readable,
+ * schema-aware encoding of JSON designed to minimise token usage in
+ * LLM prompts. It declares array lengths and field headers once, then
+ * streams row values.
+ *
+ * @param data - Any JSON-serializable value (object, array, primitive)
+ * @returns A TOON-formatted string
+ */
+export async function convertToon(data) {
+    return encode(data);
+}
+//# sourceMappingURL=toon.js.map

package/dist/output/toon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toon.js","sourceRoot":"","sources":["../../src/output/toon.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAa;IAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;AACtB,CAAC"}

package/dist/output/writer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Output writer — creates timestamped directories and writes JSON data.
+ */
+/**
+ * Create a timestamped output directory under the given base path.
+ *
+ * Directory format: `perfgraph_<hostname>_<YYYYMMDD_HHmmss>`
+ *
+ * @param basePath - Base directory for output
+ * @param url - Source URL (used to extract hostname for directory naming)
+ * @returns Absolute path to the created directory
+ */
+export declare function createOutputDir(basePath: string, url: string): Promise<string>;
+/**
+ * Write a JSON-serializable value to a file inside the given directory.
+ *
+ * @param dir - Target directory
+ * @param filename - File name (e.g. "trace.json")
+ * @param data - Data to serialize as JSON
+ * @returns Full path to the written file
+ */
+export declare function writeJsonFile(dir: string, filename: string, data: unknown): Promise<string>;
+/**
+ * Write a warnings file to the given directory.
+ *
+ * @param dir - Target directory
+ * @param warnings - Array of warning strings
+ * @returns Full path to the written file
+ */
+export declare function writeWarnings(dir: string, warnings: string[]): Promise<string>;
+//# sourceMappingURL=writer.d.ts.map

package/dist/output/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../src/output/writer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASpF;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAIjG;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAKpF"}