perfgraph 0.1.0

package/dist/collect/orchestrator.js

@@ -0,0 +1,350 @@
+/**
+ * Collector orchestrator.
+ *
+ * Coordinates the full collection lifecycle for a single run:
+ * 1. Validate URL
+ * 2. Launch browser + create CDP session
+ * 3. Run each active collector in the correct order
+ * 4. Write results to the output directory
+ * 5. Clean up browser
+ * 6. Run Lighthouse audit (separate browser, after CDP session closes)
+ *
+ * Designed for multi-run support: `run()` wraps `runOnce()`.
+ */
+import ow from 'ow';
+import { DEFAULT_RUN_OPTIONS } from '../shared/types.js';
+import { launchBrowserServer, closeBrowser } from './session.js';
+import { TraceCollector } from './trace.js';
+import { NetworkCollector } from './network.js';
+import { PerformanceCollector } from './performance.js';
+import { RuntimeCollector } from './runtime.js';
+import { CoverageCollector } from './coverage.js';
+import { ConsoleCollector } from './console.js';
+import { DOMCollector } from './dom.js';
+import { LighthouseCollector } from './lighthouse.js';
+import { createOutputDir, writeJsonFile, writeWarnings } from '../output/writer.js';
+/** Collectors that participate in the CDP session lifecycle */
+const CDP_COLLECTORS = [
+    {
+        label: 'network',
+        create: () => new NetworkCollector(),
+        bundleKey: 'network',
+        filename: 'network.json',
+        disableFlag: 'noNetwork',
+    },
+    {
+        label: 'performance',
+        create: () => new PerformanceCollector(),
+        bundleKey: 'performance',
+        filename: 'performance.json',
+        disableFlag: 'noPerformance',
+    },
+    {
+        label: 'trace',
+        create: () => new TraceCollector(),
+        bundleKey: 'trace',
+        filename: 'trace.json',
+        disableFlag: undefined, // always enabled
+    },
+    {
+        label: 'runtime',
+        create: () => new RuntimeCollector(),
+        bundleKey: 'runtime',
+        filename: 'runtime.json',
+        disableFlag: 'noRuntime',
+    },
+    {
+        label: 'coverage',
+        create: () => new CoverageCollector(),
+        bundleKey: 'coverage',
+        filename: 'coverage.json',
+        disableFlag: 'noCoverage',
+    },
+    {
+        label: 'console',
+        create: () => new ConsoleCollector(),
+        bundleKey: 'consoleEntries',
+        filename: 'console.json',
+        disableFlag: 'noConsole',
+    },
+    {
+        label: 'dom',
+        create: ({ page }) => new DOMCollector(page),
+        bundleKey: 'dom',
+        filename: 'dom.json',
+        disableFlag: 'noDom',
+    },
+];
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Check whether a collector is enabled according to run options.
+ * Unless the --no-* flag is explicitly set, the collector is active.
+ */
+function isEnabled(def, options) {
+    return def.disableFlag === undefined || !options[def.disableFlag];
+}
+/**
+ * Filter enabled collectors from the definition list.
+ */
+function enabledCollectors(defs, options) {
+    return defs.filter((d) => isEnabled(d, options));
+}
+// ---------------------------------------------------------------------------
+// LCP wait
+// ---------------------------------------------------------------------------
+/**
+ * Maximum time to wait for LargestContentfulPaint before stopping trace collection.
+ * If LCP doesn't fire within this window, a warning is recorded but collection
+ * proceeds with whatever data was captured.
+ */
+const LCP_TIMEOUT_MS = 5_000;
+/**
+ * Wait for LargestContentfulPaint to fire on the page.
+ *
+ * Uses a PerformanceObserver for 'largest-contentful-paint' with `buffered: true`
+ * so that entries which already fired before the observer was created are still
+ * captured. If the observer API is unavailable or the timeout expires, returns
+ * false so the caller can record a warning but still proceed.
+ *
+ * @param page - Playwright Page to evaluate the observer in
+ * @param timeoutMs - Maximum time to wait in milliseconds
+ * @returns true if LCP was detected, false otherwise
+ */
+async function waitForLCP(page, timeoutMs) {
+    try {
+        return await page.evaluate((timeout) => {
+            return new Promise((resolve) => {
+                let resolved = false;
+                try {
+                    const observer = new PerformanceObserver((list) => {
+                        const entries = list.getEntries();
+                        if (entries.length > 0) {
+                            observer.disconnect();
+                            resolved = true;
+                            resolve(true);
+                        }
+                    });
+                    observer.observe({ type: 'largest-contentful-paint', buffered: true });
+                    setTimeout(() => {
+                        if (!resolved) {
+                            resolve(false);
+                        }
+                    }, timeout);
+                }
+                catch {
+                    // PerformanceObserver or LCP type not supported by this browser
+                    resolve(false);
+                }
+            });
+        }, timeoutMs);
+    }
+    catch {
+        // page.evaluate failed (CSP restrictions, page crash, etc.)
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// runOnce
+// ---------------------------------------------------------------------------
+/**
+ * Execute a single collection run against the given URL.
+ *
+ * @param url - Target URL to collect data from
+ * @param options - Collection options
+ * @param runIndex - 1-based run index (for multi-run scenarios)
+ * @returns RunResult with output path and status
+ */
+async function runOnce(url, options, runIndex) {
+    ow(url, 'url', ow.string.nonEmpty);
+    ow(options, 'options', ow.object);
+    ow(runIndex, 'runIndex', ow.number.integer.positive);
+    const bundle = {};
+    const warnings = [];
+    const files = [];
+    // --- Phase 1: Create output directory ---
+    const baseDir = options.output;
+    const outputDir = await createOutputDir(baseDir, url);
+    // --- Phase 2: Launch browser + CDP session ---
+    console.error(`[${runIndex}] Launching browser...`);
+    const { browser, page, cdp, cdpPort } = await launchBrowserServer(30_000, options.mobile);
+    try {
+        // --- Phase 3: Determine which CDP collectors to run ---
+        const activeDefs = enabledCollectors(CDP_COLLECTORS, options);
+        if (activeDefs.length === 0) {
+            console.error(`[${runIndex}] No CDP collectors enabled — skipping navigation`);
+        }
+        else {
+            // Start all active collectors (pre-navigation)
+            const running = [];
+            for (const def of activeDefs) {
+                console.error(`[${runIndex}] Starting ${def.label} collection...`);
+                const collector = def.create({ page });
+                await collector.start(cdp, options);
+                running.push({ def, collector });
+            }
+            // --- Phase 4: Navigate to target URL ---
+            console.error(`[${runIndex}] Navigating to ${url}...`);
+            await page.goto(url, { waitUntil: 'networkidle', timeout: 60_000 });
+            // --- Phase 4b: Wait for LCP before stopping collectors ---
+            // This ensures the trace (and other collectors) capture the LargestContentfulPaint
+            // event, which may fire after networkidle (e.g. large hero images, late fonts).
+            console.error(`[${runIndex}] Waiting for LargestContentfulPaint...`);
+            const lcpReady = await waitForLCP(page, LCP_TIMEOUT_MS);
+            if (lcpReady) {
+                console.error(`[${runIndex}] LargestContentfulPaint captured`);
+            }
+            else {
+                const lcpWarning = 'LCP event not detected within timeout — trace may lack LargestContentfulPaint event data';
+                warnings.push(lcpWarning);
+                console.error(`[${runIndex}] ${lcpWarning}`);
+            }
+            // --- Phase 5: Stop all collectors (post-navigation) and write results ---
+            for (const { def, collector } of running) {
+                console.error(`[${runIndex}] Stopping ${def.label} collection...`);
+                const result = await collector.stop();
+                if (result.ok) {
+                    // Assign collector data to bundle (all data fields are `unknown`)
+                    bundle[def.bundleKey] = result.data;
+                    // Extract warnings if the data has a warnings field
+                    const data = result.data;
+                    if (data &&
+                        typeof data === 'object' &&
+                        'warnings' in data &&
+                        Array.isArray(data.warnings)) {
+                        warnings.push(...data.warnings);
+                    }
+                    const filePath = await writeJsonFile(outputDir, def.filename, result.data);
+                    files.push(filePath);
+                    console.error(`[${runIndex}] ${def.label}: OK — ${filePath}`);
+                }
+                else {
+                    warnings.push(`${def.label} collector failed: ${result.error}`);
+                    console.error(`[${runIndex}] ${def.label}: FAILED — ${result.error}`);
+                }
+            }
+        }
+        // --- Phase 6: Write warnings ---
+        bundle.warnings = warnings;
+        if (warnings.length > 0) {
+            const warningsPath = await writeWarnings(outputDir, warnings);
+            files.push(warningsPath);
+        }
+        // --- Phase 7: Run Lighthouse in the SAME browser (Option C) ---
+        // Browser stays alive from Phase 2. Lighthouse opens its own tab via CDP port,
+        // does a fresh navigation, runs audits, and closes the tab — all in one Chrome.
+        // This eliminates metric drift between CDP trace and Lighthouse.
+        if (!options.noLighthouse) {
+            console.error(`[${runIndex}] Starting Lighthouse audit (same browser, port ${cdpPort})...`);
+            const lighthouseCollector = new LighthouseCollector();
+            const lhResult = await lighthouseCollector.runCollection(url, cdpPort);
+            if (lhResult.ok) {
+                bundle.lighthouse = lhResult.data;
+                const lhPath = await writeJsonFile(outputDir, 'lighthouse.json', lhResult.data);
+                files.push(lhPath);
+                const lhData = lhResult.data;
+                if (lhData &&
+                    typeof lhData === 'object' &&
+                    'warnings' in lhData &&
+                    Array.isArray(lhData.warnings)) {
+                    warnings.push(...lhData.warnings);
+                }
+                console.error(`[${runIndex}] Lighthouse: OK — ${lhPath}`);
+            }
+            else {
+                warnings.push(`Lighthouse collector failed: ${lhResult.error}`);
+                console.error(`[${runIndex}] Lighthouse: FAILED — ${lhResult.error}`);
+            }
+        }
+    }
+    finally {
+        // --- Phase 8: Always clean up the browser ---
+        await closeBrowser(browser);
+    }
+    return {
+        index: runIndex,
+        outputDir,
+        warningCount: warnings.length,
+        files,
+        success: true,
+    };
+}
+/**
+ * Run one or more collection runs against the given URL.
+ *
+ * @param url - Target URL to collect data from
+ * @param partialOptions - Partial options (merged with defaults)
+ * @returns Array of RunResult — one per run
+ */
+export async function run(url, partialOptions) {
+    ow(url, 'url', ow.string.nonEmpty);
+    // Validate URL format early (T-01-01 mitigation)
+    try {
+        new URL(url);
+    }
+    catch {
+        throw new Error(`Invalid URL: "${url}". Provide a valid URL including protocol (e.g. https://example.com).`);
+    }
+    const options = { ...DEFAULT_RUN_OPTIONS, ...partialOptions, url };
+    const results = [];
+    console.error(`PerfGraph collection starting — ${options.runs} run(s) for ${url}`);
+    console.error(`Output directory: ${options.output}`);
+    console.error('');
+    for (let i = 1; i <= options.runs; i++) {
+        const runLabel = options.runs > 1 ? `Run ${i}/${options.runs}` : 'Run';
+        console.error(`--- ${runLabel} ---`);
+        try {
+            const result = await runOnce(url, options, i);
+            results.push(result);
+            console.error(`[${i}] Completed — ${result.success ? 'OK' : 'FAILED'}`);
+            console.error(`[${i}] Output: ${result.outputDir}`);
+            if (result.warningCount > 0) {
+                console.error(`[${i}] Warnings: ${result.warningCount}`);
+            }
+        }
+        catch (error) {
+            console.error(`[${i}] Fatal error: ${error}`);
+            results.push({
+                index: i,
+                outputDir: '',
+                warningCount: 0,
+                files: [],
+                success: false,
+                error: String(error),
+            });
+        }
+        console.error('');
+    }
+    // Write multi-run summary if needed
+    if (options.runs > 1) {
+        const summaryDir = results.find((r) => r.outputDir)?.outputDir;
+        if (summaryDir) {
+            const parentDir = summaryDir.substring(0, summaryDir.lastIndexOf('\\'));
+            const summary = {
+                url,
+                runs: options.runs,
+                completedAt: new Date().toISOString(),
+                results: results.map((r) => ({
+                    run: r.index,
+                    outputDir: r.outputDir,
+                    success: r.success,
+                    warningCount: r.warningCount,
+                    error: r.error ?? null,
+                    files: r.files,
+                })),
+                summary: {
+                    successCount: results.filter((r) => r.success).length,
+                    failureCount: results.filter((r) => !r.success).length,
+                    totalWarnings: results.reduce((sum, r) => sum + r.warningCount, 0),
+                },
+            };
+            const summaryPath = await writeJsonFile(options.output, 'runs-summary.json', summary);
+            console.error(`Summary: ${summaryPath}`);
+        }
+    }
+    const successCount = results.filter((r) => r.success).length;
+    console.error(`Collection complete — ${successCount}/${options.runs} runs successful`);
+    return results;
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/collect/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../src/collect/orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAoBpF,+DAA+D;AAC/D,MAAM,cAAc,GAAmB;IACrC;QACE,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,gBAAgB,EAAE;QACpC,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,cAAc;QACxB,WAAW,EAAE,WAAW;KACzB;IACD;QACE,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,oBAAoB,EAAE;QACxC,SAAS,EAAE,aAAa;QACxB,QAAQ,EAAE,kBAAkB;QAC5B,WAAW,EAAE,eAAe;KAC7B;IACD;QACE,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,cAAc,EAAE;QAClC,SAAS,EAAE,OAAO;QAClB,QAAQ,EAAE,YAAY;QACtB,WAAW,EAAE,SAAS,EAAE,iBAAiB;KAC1C;IACD;QACE,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,gBAAgB,EAAE;QACpC,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,cAAc;QACxB,WAAW,EAAE,WAAW;KACzB;IACD;QACE,KAAK,EAAE,UAAU;QACjB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,iBAAiB,EAAE;QACrC,SAAS,EAAE,UAAU;QACrB,QAAQ,EAAE,eAAe;QACzB,WAAW,EAAE,YAAY;KAC1B;IACD;QACE,KAAK,EAAE,SAAS;QAChB,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,gBAAgB,EAAE;QACpC,SAAS,EAAE,gBAAgB;QAC3B,QAAQ,EAAE,cAAc;QACxB,WAAW,EAAE,WAAW;KACzB;IACD;QACE,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC,IAAI,CAAC;QAC5C,SAAS,EAAE,KAAK;QAChB,QAAQ,EAAE,UAAU;QACpB,WAAW,EAAE,OAAO;KACrB;CACF,CAAC;AAEF,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,SAAS,CAAC,GAAiB,EAAE,OAA4B;IAChE,OAAO,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,IAAoB,EAAE,OAA4B;IAC3E,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,8EAA8E;AAC9E,WAAW;AACX,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,cAAc,GAAG,KAAK,CAAC;AAE7B;;;;;;;;;;;GAWG;AACH,KAAK,UAAU,UAAU,CAAC,IAAU,EAAE,SAAiB;IACrD,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,EAAE;YACrC,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;gBACtC,IAAI,QAAQ,GAAG,KAAK,CAAC;gBAErB,IAAI,CAAC;oBACH,MAAM,QAAQ,GAAG,IAAI,mBAAmB,CAAC,CAAC,IAAI,EAAE,EAAE;wBAChD,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;wBAClC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BACvB,QAAQ,CAAC,UAAU,EAAE,CAAC;4BACtB,QAAQ,GAAG,IAAI,CAAC;4BAChB,OAAO,CAAC,IAAI,CAAC,CAAC;wBAChB,CAAC;oBACH,CAAC,CAAC,CAAC;oBAEH,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;oBAEvE,UAAU,CAAC,GAAG,EAAE;wBACd,IAAI,CAAC,QAAQ,EAAE,CAAC;4BACd,OAAO,CAAC,KAAK,CAAC,CAAC;wBACjB,CAAC;oBACH,CAAC,EAAE,OAAO,CAAC,CAAC;gBACd,CAAC;gBAAC,MAAM,CAAC;oBACP,gEAAgE;oBAChE,OAAO,CAAC,KAAK,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,SAAS,CAAC,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,4DAA4D;QAC5D,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;GAOG;AACH,KAAK,UAAU,OAAO,CACpB,GAAW,EACX,OAA4B,EAC5B,QAAgB;IAEhB,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnC,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;IAClC,EAAE,CAAC,QAAQ,EAAE,UAAU,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErD,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,2CAA2C;IAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAC/B,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAEtD,gDAAgD;IAChD,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,wBAAwB,CAAC,CAAC;IACpD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,MAAM,mBAAmB,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE1F,IAAI,CAAC;QACH,yDAAyD;QACzD,MAAM,UAAU,GAAG,iBAAiB,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAE9D,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,mDAAmD,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,+CAA+C;YAC/C,MAAM,OAAO,GAAuD,EAAE,CAAC;YACvE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;gBAC7B,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,cAAc,GAAG,CAAC,KAAK,gBAAgB,CAAC,CAAC;gBACnE,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvC,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBACpC,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;YACnC,CAAC;YAED,0CAA0C;YAC1C,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,mBAAmB,GAAG,KAAK,CAAC,CAAC;YACvD,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAEpE,4DAA4D;YAC5D,mFAAmF;YACnF,gFAAgF;YAChF,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,yCAAyC,CAAC,CAAC;YACrE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACxD,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,mCAAmC,CAAC,CAAC;YACjE,CAAC;iBAAM,CAAC;gBACN,MAAM,UAAU,GACd,0FAA0F,CAAC;gBAC7F,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC1B,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC,CAAC;YAC/C,CAAC;YAED,2EAA2E;YAC3E,KAAK,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,OAAO,EAAE,CAAC;gBACzC,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,cAAc,GAAG,CAAC,KAAK,gBAAgB,CAAC,CAAC;gBACnE,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;gBAEtC,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;oBACd,kEAAkE;oBACjE,MAAkC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;oBAEjE,oDAAoD;oBACpD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;oBACzB,IACE,IAAI;wBACJ,OAAO,IAAI,KAAK,QAAQ;wBACxB,UAAU,IAAI,IAAI;wBAClB,KAAK,CAAC,OAAO,CAAE,IAAgC,CAAC,QAAQ,CAAC,EACzD,CAAC;wBACD,QAAQ,CAAC,IAAI,CAAC,GAAK,IAAgC,CAAC,QAAqB,CAAC,CAAC;oBAC7E,CAAC;oBAED,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;oBAC3E,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;oBACrB,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,KAAK,GAAG,CAAC,KAAK,UAAU,QAAQ,EAAE,CAAC,CAAC;gBAChE,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,sBAAsB,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;oBAChE,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,KAAK,GAAG,CAAC,KAAK,cAAc,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;gBACxE,CAAC;YACH,CAAC;QACH,CAAC;QAED,kCAAkC;QACjC,MAAkC,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACxD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,YAAY,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAC9D,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;QAED,iEAAiE;QACjE,+EAA+E;QAC/E,gFAAgF;QAChF,iEAAiE;QACjE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,mDAAmD,OAAO,MAAM,CAAC,CAAC;YAC5F,MAAM,mBAAmB,GAAG,IAAI,mBAAmB,EAAE,CAAC;YACtD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,aAAa,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAEvE,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACf,MAAkC,CAAC,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC;gBAC/D,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,SAAS,EAAE,iBAAiB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAChF,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBAEnB,MAAM,MAAM,GAAY,QAAQ,CAAC,IAAI,CAAC;gBACtC,IACE,MAAM;oBACN,OAAO,MAAM,KAAK,QAAQ;oBAC1B,UAAU,IAAK,MAAkC;oBACjD,KAAK,CAAC,OAAO,CAAE,MAAkC,CAAC,QAAQ,CAAC,EAC3D,CAAC;oBACD,QAAQ,CAAC,IAAI,CAAC,GAAK,MAAkC,CAAC,QAAqB,CAAC,CAAC;gBAC/E,CAAC;gBAED,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,sBAAsB,MAAM,EAAE,CAAC,CAAC;YAC5D,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CAAC,gCAAgC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;gBAChE,OAAO,CAAC,KAAK,CAAC,IAAI,QAAQ,0BAA0B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;YACxE,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,+CAA+C;QAC/C,MAAM,YAAY,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,KAAK,EAAE,QAAQ;QACf,SAAS;QACT,YAAY,EAAE,QAAQ,CAAC,MAAM;QAC7B,KAAK;QACL,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,GAAW,EACX,cAA6C;IAE7C,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAEnC,iDAAiD;IACjD,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,iBAAiB,GAAG,uEAAuE,CAC5F,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAwB,EAAE,GAAG,mBAAmB,EAAE,GAAG,cAAc,EAAE,GAAG,EAAE,CAAC;IACxF,MAAM,OAAO,GAAgB,EAAE,CAAC;IAEhC,OAAO,CAAC,KAAK,CAAC,mCAAmC,OAAO,CAAC,IAAI,eAAe,GAAG,EAAE,CAAC,CAAC;IACnF,OAAO,CAAC,KAAK,CAAC,qBAAqB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,OAAO,QAAQ,MAAM,CAAC,CAAC;QAErC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;YACxE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;YACpD,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;gBAC5B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,EAAE,CAAC,CAAC;YAC9C,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,EAAE;gBACb,YAAY,EAAE,CAAC;gBACf,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;aACrB,CAAC,CAAC;QACL,CAAC;QAED,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IAED,oCAAoC;IACpC,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;QAC/D,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YACxE,MAAM,OAAO,GAAG;gBACd,GAAG;gBACH,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACrC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC3B,GAAG,EAAE,CAAC,CAAC,KAAK;oBACZ,SAAS,EAAE,CAAC,CAAC,SAAS;oBACtB,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,YAAY,EAAE,CAAC,CAAC,YAAY;oBAC5B,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI;oBACtB,KAAK,EAAE,CAAC,CAAC,KAAK;iBACf,CAAC,CAAC;gBACH,OAAO,EAAE;oBACP,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;oBACrD,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM;oBACtD,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;iBACnE;aACF,CAAC;YACF,MAAM,WAAW,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,CAAC;YACtF,OAAO,CAAC,KAAK,CAAC,YAAY,WAAW,EAAE,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC;IAC7D,OAAO,CAAC,KAAK,CAAC,yBAAyB,YAAY,IAAI,OAAO,CAAC,IAAI,kBAAkB,CAAC,CAAC;IAEvF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/collect/performance.d.ts

@@ -0,0 +1,28 @@
+/**
+ * PerformanceCollector — captures browser performance metrics via the CDP Performance domain.
+ *
+ * Uses:
+ *   - Performance.enable to receive periodic Performance.metrics events.
+ *   - Performance.getMetrics after page load to capture the final metrics snapshot.
+ *
+ * Standard metrics include Timestamp, Documents, Frames, JSEventListeners, Nodes,
+ * LayoutCount, RecalcStyleCount, LayoutDuration, RecalcStyleDuration,
+ * ScriptDuration, TaskDuration, JSHeapUsedSize, JSHeapTotalSize,
+ * FirstMeaningfulPaint, DomContentLoaded, and NavigationStart.
+ */
+import { type CDPSession } from 'playwright';
+import type { Collector, CollectorResult } from './types.js';
+import type { PerformanceRawData, PerformanceMetric } from './types.js';
+import type { CollectorRunOptions } from '../shared/types.js';
+export declare class PerformanceCollector implements Collector {
+    readonly name = "performance";
+    private session;
+    /** Accumulated timeline metric snapshots */
+    private timelineSnapshots;
+    private collected;
+    start(session: CDPSession, _options?: CollectorRunOptions): Promise<void>;
+    stop(): Promise<CollectorResult<PerformanceRawData>>;
+    /** Return timeline metric snapshots collected during the session (useful for tests) */
+    getTimelineSnapshots(): PerformanceMetric[][];
+}
+//# sourceMappingURL=performance.d.ts.map

package/dist/collect/performance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.d.ts","sourceRoot":"","sources":["../../src/collect/performance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAuC9D,qBAAa,oBAAqB,YAAW,SAAS;IACpD,QAAQ,CAAC,IAAI,iBAAiB;IAE9B,OAAO,CAAC,OAAO,CAA2B;IAC1C,4CAA4C;IAC5C,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,SAAS,CAAS;IAEpB,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBzE,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;IAiD1D,uFAAuF;IACvF,oBAAoB,IAAI,iBAAiB,EAAE,EAAE;CAG9C"}

package/dist/collect/performance.js

@@ -0,0 +1,108 @@
+/**
+ * PerformanceCollector — captures browser performance metrics via the CDP Performance domain.
+ *
+ * Uses:
+ *   - Performance.enable to receive periodic Performance.metrics events.
+ *   - Performance.getMetrics after page load to capture the final metrics snapshot.
+ *
+ * Standard metrics include Timestamp, Documents, Frames, JSEventListeners, Nodes,
+ * LayoutCount, RecalcStyleCount, LayoutDuration, RecalcStyleDuration,
+ * ScriptDuration, TaskDuration, JSHeapUsedSize, JSHeapTotalSize,
+ * FirstMeaningfulPaint, DomContentLoaded, and NavigationStart.
+ */
+import {} from 'playwright';
+/**
+ * Validate the collected performance metrics are reasonable.
+ *
+ * @param metrics - Array of collected performance metrics
+ * @returns Array of warning strings
+ */
+function validatePerformanceMetrics(metrics) {
+    const warnings = [];
+    if (metrics.length === 0) {
+        warnings.push('No performance metrics were collected.');
+        return warnings;
+    }
+    // Check for expected standard metrics
+    const expectedMetrics = [
+        'Timestamp',
+        'Documents',
+        'Frames',
+        'JSEventListeners',
+        'Nodes',
+        'JSHeapUsedSize',
+        'JSHeapTotalSize',
+    ];
+    const metricNames = new Set(metrics.map((m) => m.name));
+    const missing = expectedMetrics.filter((name) => !metricNames.has(name));
+    if (missing.length > 0) {
+        warnings.push(`Performance metrics may be incomplete — missing expected metrics: ${missing.join(', ')}`);
+    }
+    return warnings;
+}
+export class PerformanceCollector {
+    name = 'performance';
+    session = null;
+    /** Accumulated timeline metric snapshots */
+    timelineSnapshots = [];
+    collected = false;
+    async start(session, _options) {
+        this.session = session;
+        this.timelineSnapshots = [];
+        this.collected = false;
+        // Listen for periodic Performance.metrics events
+        session.on('Performance.metrics', ((event) => {
+            if (Array.isArray(event.metrics) && event.metrics.length > 0) {
+                this.timelineSnapshots.push(event.metrics);
+            }
+        }));
+        // Enable the Performance domain to receive metrics events
+        await session.send('Performance.enable');
+    }
+    async stop() {
+        this.collected = true;
+        if (!this.session) {
+            return { ok: false, error: 'PerformanceCollector: session not initialized' };
+        }
+        const warnings = [];
+        try {
+            // Query final metrics snapshot
+            const result = await this.session.send('Performance.getMetrics');
+            const metrics = result.metrics;
+            const timestamp = Date.now();
+            // Disable the Performance domain
+            try {
+                await this.session.send('Performance.disable');
+            }
+            catch {
+                // Non-critical — domain may already be disabled
+            }
+            // Run completeness validation
+            const validationWarnings = validatePerformanceMetrics(metrics);
+            warnings.push(...validationWarnings);
+            // Check for timeline data availability
+            if (this.timelineSnapshots.length > 0) {
+                warnings.push(`${this.timelineSnapshots.length} timeline metric snapshot(s) were collected during the session (data available for delta analysis).`);
+            }
+            return {
+                ok: true,
+                data: {
+                    metrics,
+                    timestamp,
+                    warnings,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                ok: false,
+                error: `PerformanceCollector: failed to get metrics — ${String(error)}`,
+            };
+        }
+    }
+    /** Return timeline metric snapshots collected during the session (useful for tests) */
+    getTimelineSnapshots() {
+        return [...this.timelineSnapshots];
+    }
+}
+//# sourceMappingURL=performance.js.map

package/dist/collect/performance.js.map

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

package/dist/collect/runtime.d.ts

@@ -0,0 +1,26 @@
+/**
+ * RuntimeCollector — captures JavaScript runtime context and stats via CDP.
+ *
+ * Enables the Runtime domain to track execution context creation (frames,
+ * workers, extensions) and evaluates runtime metrics (JS heap, DOM node
+ * count) on stop().
+ */
+import { type CDPSession } from 'playwright';
+import type { Collector, CollectorResult, RuntimeRawData } from './types.js';
+import type { CollectorRunOptions } from '../shared/types.js';
+export declare class RuntimeCollector implements Collector {
+    readonly name = "runtime";
+    private session;
+    private contexts;
+    /**
+     * Start collecting runtime data.
+     * Enables the Runtime CDP domain and subscribes to executionContextCreated.
+     */
+    start(session: CDPSession, _options?: CollectorRunOptions): Promise<void>;
+    /**
+     * Stop collecting and return runtime data.
+     * Evaluates inline JavaScript to capture runtime stats.
+     */
+    stop(): Promise<CollectorResult<RuntimeRawData>>;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/collect/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/collect/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,qBAAa,gBAAiB,YAAW,SAAS;IAChD,QAAQ,CAAC,IAAI,aAAa;IAE1B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,QAAQ,CAAkC;IAElD;;;OAGG;IACG,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB/E;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC;CAiDvD"}

package/dist/collect/runtime.js

@@ -0,0 +1,81 @@
+/**
+ * RuntimeCollector — captures JavaScript runtime context and stats via CDP.
+ *
+ * Enables the Runtime domain to track execution context creation (frames,
+ * workers, extensions) and evaluates runtime metrics (JS heap, DOM node
+ * count) on stop().
+ */
+import {} from 'playwright';
+export class RuntimeCollector {
+    name = 'runtime';
+    session = null;
+    contexts = [];
+    /**
+     * Start collecting runtime data.
+     * Enables the Runtime CDP domain and subscribes to executionContextCreated.
+     */
+    async start(session, _options) {
+        this.session = session;
+        this.contexts = [];
+        // Enable Runtime domain so we receive execution context events
+        await session.send('Runtime.enable');
+        // Track all execution contexts created during the session
+        session.on('Runtime.executionContextCreated', (event) => {
+            if (event.context) {
+                this.contexts.push({
+                    id: event.context.id,
+                    origin: event.context.origin,
+                    name: event.context.name,
+                });
+            }
+        });
+    }
+    /**
+     * Stop collecting and return runtime data.
+     * Evaluates inline JavaScript to capture runtime stats.
+     */
+    async stop() {
+        if (!this.session) {
+            return { ok: false, error: 'RuntimeCollector: session not initialised' };
+        }
+        let stats = undefined;
+        try {
+            // Evaluate runtime stats within the page context
+            const result = await this.session.send('Runtime.evaluate', {
+                expression: `({
+          jsHeapSize: performance?.memory?.usedJSHeapSize ?? null,
+          domNodeCount: document?.querySelectorAll('*')?.length ?? null,
+          documentUrl: document?.URL ?? ''
+        })`,
+                returnByValue: true,
+            });
+            const value = result?.result?.value;
+            if (value) {
+                stats = {
+                    jsHeapSize: value.jsHeapSize ?? 0,
+                    domNodeCount: value.domNodeCount ?? 0,
+                    documentUrl: value.documentUrl ?? '',
+                };
+            }
+        }
+        catch (error) {
+            // Stats are non-critical — return contexts even if evaluation fails
+            return {
+                ok: true,
+                data: {
+                    contexts: this.contexts,
+                    warnings: [`Failed to evaluate runtime stats: ${String(error)}`],
+                },
+            };
+        }
+        return {
+            ok: true,
+            data: {
+                contexts: this.contexts,
+                stats,
+                warnings: [],
+            },
+        };
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/collect/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/collect/runtime.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAmB,MAAM,YAAY,CAAC;AAI7C,MAAM,OAAO,gBAAgB;IAClB,IAAI,GAAG,SAAS,CAAC;IAElB,OAAO,GAAsB,IAAI,CAAC;IAClC,QAAQ,GAA+B,EAAE,CAAC;IAElD;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,OAAmB,EAAE,QAA8B;QAC7D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QAEnB,+DAA+D;QAC/D,MAAM,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAErC,0DAA0D;QAC1D,OAAO,CAAC,EAAE,CAAC,iCAAiC,EAAE,CAAC,KAAgE,EAAE,EAAE;YACjH,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;gBAClB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;oBACjB,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE;oBACpB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;oBAC5B,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI;iBACzB,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;QAC3E,CAAC;QAED,IAAI,KAAK,GAA4B,SAAS,CAAC;QAE/C,IAAI,CAAC;YACH,iDAAiD;YACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE;gBACzD,UAAU,EAAE;;;;WAIT;gBACH,aAAa,EAAE,IAAI;aACpB,CAAC,CAAC;YAEH,MAAM,KAAK,GAAG,MAAM,EAAE,MAAM,EAAE,KAEjB,CAAC;YAEd,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,GAAG;oBACN,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,CAAC;oBACjC,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;oBACrC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,EAAE;iBACrC,CAAC;YACJ,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oEAAoE;YACpE,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE;oBACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,QAAQ,EAAE,CAAC,qCAAqC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;iBACjE;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,EAAE,EAAE,IAAI;YACR,IAAI,EAAE;gBACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,KAAK;gBACL,QAAQ,EAAE,EAAE;aACb;SACF,CAAC;IACJ,CAAC;CACF"}