@rezi-ui/core 0.1.0-alpha.1

package/dist/debug/constants.js.map

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

package/dist/debug/debug.d.ts

@@ -0,0 +1,14 @@
+/**
+ * packages/core/src/debug/debug.ts — UI-level debug helpers.
+ *
+ * Why: Lightweight helpers for instrumenting widget trees during development.
+ * These are pure factories and do not perform I/O.
+ */
+import type { VNode } from "../widgets/types.js";
+export declare function debug(node: VNode, options?: {
+    showId?: boolean;
+}): VNode;
+export declare function inspect(value: unknown, options?: {
+    depth?: number;
+}): VNode;
+//# sourceMappingURL=debug.d.ts.map

package/dist/debug/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/debug/debug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAGjD,wBAAgB,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,KAAK,CAWxE;AAED,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAG3E"}

package/dist/debug/debug.js

@@ -0,0 +1,54 @@
+/**
+ * packages/core/src/debug/debug.ts — UI-level debug helpers.
+ *
+ * Why: Lightweight helpers for instrumenting widget trees during development.
+ * These are pure factories and do not perform I/O.
+ */
+import { ui } from "../widgets/ui.js";
+export function debug(node, options) {
+    const id = getNodeId(node);
+    const label = options?.showId !== false && id ? ` ${id} ` : "";
+    return ui.box({
+        border: "single",
+        title: label,
+    }, [node]);
+}
+export function inspect(value, options) {
+    const text = formatValue(value, options?.depth ?? 3, 0);
+    return ui.text(text, { style: { dim: true } });
+}
+function formatValue(value, maxDepth, depth) {
+    if (depth > maxDepth)
+        return "...";
+    if (value === null)
+        return "null";
+    if (value === undefined)
+        return "undefined";
+    if (typeof value === "string")
+        return `"${value}"`;
+    if (typeof value === "number" || typeof value === "boolean")
+        return String(value);
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return "[]";
+        const items = value.map((v) => formatValue(v, maxDepth, depth + 1));
+        return `[${items.join(", ")}]`;
+    }
+    if (typeof value === "object") {
+        const entries = Object.entries(value);
+        if (entries.length === 0)
+            return "{}";
+        const pairs = entries.map(([k, v]) => `${k}: ${formatValue(v, maxDepth, depth + 1)}`);
+        return `{ ${pairs.join(", ")} }`;
+    }
+    return String(value);
+}
+function getNodeId(node) {
+    if ("props" in node) {
+        const id = node.props?.id;
+        if (typeof id === "string")
+            return id;
+    }
+    return null;
+}
+//# sourceMappingURL=debug.js.map

package/dist/debug/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../src/debug/debug.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AAEtC,MAAM,UAAU,KAAK,CAAC,IAAW,EAAE,OAA8B;IAC/D,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC3B,MAAM,KAAK,GAAG,OAAO,EAAE,MAAM,KAAK,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/D,OAAO,EAAE,CAAC,GAAG,CACX;QACE,MAAM,EAAE,QAAQ;QAChB,KAAK,EAAE,KAAK;KACb,EACD,CAAC,IAAI,CAAC,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc,EAAE,OAA4B;IAClE,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,WAAW,CAAC,KAAc,EAAE,QAAgB,EAAE,KAAa;IAClE,IAAI,KAAK,GAAG,QAAQ;QAAE,OAAO,KAAK,CAAC;IAEnC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,KAAK,GAAG,CAAC;IACnD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAElF,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC;QACpE,OAAO,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IACjC,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,CAAC;QACjE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACtC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QACtF,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,SAAS,CAAC,IAAW;IAC5B,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;QACpB,MAAM,EAAE,GAAI,IAAoC,CAAC,KAAK,EAAE,EAAE,CAAC;QAC3D,IAAI,OAAO,EAAE,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;IACxC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/debug/debugController.d.ts

@@ -0,0 +1,151 @@
+/**
+ * packages/core/src/debug/debugController.ts — Main debug trace controller.
+ *
+ * Why: Provides a unified interface for all debug tracing capabilities. Wraps
+ * the low-level engine debug API and coordinates the high-level analysis tools
+ * (FrameInspector, EventTrace, ErrorAggregator, StateTimeline).
+ *
+ * Architecture:
+ *   - Low-level: Proxies to the engine debug API via RuntimeBackend
+ *   - High-level: Manages analysis components that process debug records
+ *   - Subscriptions: Enables reactive updates when new records arrive
+ *
+ * Usage:
+ *   const debug = app.debug;
+ *   debug.enable({ minSeverity: 'info' });
+ *   const errors = debug.errors.all();
+ *   const frames = debug.frameInspector.getSnapshots(10);
+ */
+import { type AggregatedError, type ErrorAggregator } from "./errorAggregator.js";
+import { type EventTrace } from "./eventTrace.js";
+import { type FrameInspector } from "./frameInspector.js";
+import { type StateTimeline } from "./stateTimeline.js";
+import type { DebugConfig, DebugPayload, DebugQuery, DebugQueryResult, DebugRecord, DebugStats } from "./types.js";
+/**
+ * Debug record handler callback type.
+ */
+export type DebugRecordHandler = (record: DebugRecord) => void;
+/**
+ * Debug error handler callback type.
+ */
+export type DebugErrorHandler = (error: AggregatedError) => void;
+/**
+ * Debug event types for subscriptions.
+ */
+export type DebugEventType = "record" | "error";
+/**
+ * Debug backend interface for engine communication.
+ * This is a subset of RuntimeBackend focused on debug operations.
+ */
+export interface DebugBackend {
+    /** Enable debug tracing with the given configuration. */
+    debugEnable(config: DebugConfig): Promise<void>;
+    /** Disable debug tracing. */
+    debugDisable(): Promise<void>;
+    /** Query debug records. Returns headers and query result. */
+    debugQuery(query: DebugQuery): Promise<{
+        headers: Uint8Array;
+        result: DebugQueryResult;
+    }>;
+    /** Get payload for a specific record. */
+    debugGetPayload(recordId: bigint): Promise<Uint8Array | null>;
+    /** Get debug statistics. */
+    debugGetStats(): Promise<DebugStats>;
+    /** Export all debug records to a buffer. */
+    debugExport(): Promise<Uint8Array>;
+    /** Reset (clear) debug records. */
+    debugReset(): Promise<void>;
+}
+/**
+ * Debug controller interface.
+ */
+export interface DebugController {
+    /**
+     * Enable debug tracing.
+     * @param config - Optional configuration overrides
+     */
+    enable(config?: Partial<DebugConfig>): Promise<void>;
+    /**
+     * Disable debug tracing.
+     */
+    disable(): Promise<void>;
+    /**
+     * Reset (clear) all debug records while keeping tracing enabled.
+     */
+    reset(): Promise<void>;
+    /**
+     * Query debug records from the engine.
+     * @param filter - Optional query filter
+     */
+    query(filter?: DebugQuery): Promise<readonly DebugRecord[]>;
+    /**
+     * Get the payload for a specific record.
+     * @param recordId - The record ID
+     */
+    getPayload<T extends DebugPayload>(recordId: bigint): Promise<T | null>;
+    /**
+     * Get debug statistics.
+     */
+    getStats(): Promise<DebugStats>;
+    /**
+     * Export all debug records to a buffer for offline analysis.
+     */
+    export(): Promise<Uint8Array>;
+    /**
+     * Frame inspector for analyzing frame history.
+     */
+    readonly frameInspector: FrameInspector;
+    /**
+     * Event trace for tracking event flow.
+     */
+    readonly eventTrace: EventTrace;
+    /**
+     * Error aggregator for collecting errors.
+     */
+    readonly errors: ErrorAggregator;
+    /**
+     * State timeline for tracking state changes.
+     */
+    readonly stateTimeline: StateTimeline;
+    /**
+     * Subscribe to debug events.
+     * @param event - Event type: 'record' or 'error'
+     * @param handler - Event handler
+     * @returns Unsubscribe function
+     */
+    on(event: "record", handler: DebugRecordHandler): () => void;
+    on(event: "error", handler: DebugErrorHandler): () => void;
+    /**
+     * Whether debug tracing is currently enabled.
+     */
+    readonly enabled: boolean;
+    /**
+     * Current configuration (null if not enabled).
+     */
+    readonly config: DebugConfig | null;
+    /**
+     * Process a batch of debug record headers and payloads.
+     * Called internally by the app runtime.
+     */
+    processRecords(headers: Uint8Array, payloads: Map<bigint, Uint8Array>): void;
+}
+/**
+ * Options for creating a debug controller.
+ */
+export type CreateDebugControllerOptions = Readonly<{
+    /** Backend for engine communication (optional, enables backend features if provided) */
+    backend?: DebugBackend;
+    /** Initial configuration to apply on creation */
+    initialConfig?: DebugConfig;
+    /** Maximum frames to retain in frame inspector */
+    maxFrames?: number;
+    /** Maximum events to retain in event trace */
+    maxEvents?: number;
+    /** Maximum state changes to retain */
+    maxStateChanges?: number;
+}>;
+/**
+ * Create a debug controller instance.
+ */
+export declare function createDebugController(options?: CreateDebugControllerOptions): DebugController;
+//# sourceMappingURL=debugController.d.ts.map

package/dist/debug/debugController.d.ts.map

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

package/dist/debug/debugController.js

@@ -0,0 +1,232 @@
+/**
+ * packages/core/src/debug/debugController.ts — Main debug trace controller.
+ *
+ * Why: Provides a unified interface for all debug tracing capabilities. Wraps
+ * the low-level engine debug API and coordinates the high-level analysis tools
+ * (FrameInspector, EventTrace, ErrorAggregator, StateTimeline).
+ *
+ * Architecture:
+ *   - Low-level: Proxies to the engine debug API via RuntimeBackend
+ *   - High-level: Manages analysis components that process debug records
+ *   - Subscriptions: Enables reactive updates when new records arrive
+ *
+ * Usage:
+ *   const debug = app.debug;
+ *   debug.enable({ minSeverity: 'info' });
+ *   const errors = debug.errors.all();
+ *   const frames = debug.frameInspector.getSnapshots(10);
+ */
+import { createErrorAggregator, } from "./errorAggregator.js";
+import { createEventTrace } from "./eventTrace.js";
+import { createFrameInspector } from "./frameInspector.js";
+import { parseErrorRecord, parseEventRecord, parseFrameRecord, parsePayload, parseRecordHeader, } from "./parsers.js";
+import { createStateTimeline } from "./stateTimeline.js";
+/**
+ * Null debug backend for when no backend is available.
+ */
+const NULL_BACKEND = {
+    debugEnable: async () => { },
+    debugDisable: async () => { },
+    debugQuery: async () => ({
+        headers: new Uint8Array(0),
+        result: {
+            recordsReturned: 0,
+            recordsAvailable: 0,
+            oldestRecordId: 0n,
+            newestRecordId: 0n,
+            recordsDropped: 0,
+        },
+    }),
+    debugGetPayload: async () => null,
+    debugGetStats: async () => ({
+        totalRecords: 0n,
+        totalDropped: 0n,
+        errorCount: 0,
+        warnCount: 0,
+        currentRingUsage: 0,
+        ringCapacity: 0,
+    }),
+    debugExport: async () => new Uint8Array(0),
+    debugReset: async () => { },
+};
+/**
+ * Create a debug controller instance.
+ */
+export function createDebugController(options = {}) {
+    const backend = options.backend ?? NULL_BACKEND;
+    const frameInspector = createFrameInspector(options.maxFrames);
+    const eventTrace = createEventTrace(options.maxEvents);
+    const errorAggregator = createErrorAggregator();
+    const stateTimeline = createStateTimeline(options.maxStateChanges);
+    let isEnabled = false;
+    let currentConfig = null;
+    const recordHandlers = new Set();
+    function notifyRecordHandlers(record) {
+        for (const handler of recordHandlers) {
+            try {
+                handler(record);
+            }
+            catch {
+                // Ignore handler errors
+            }
+        }
+    }
+    async function enable(config) {
+        const fullConfig = {
+            enabled: true,
+            ...(config?.ringCapacity !== undefined && { ringCapacity: config.ringCapacity }),
+            ...(config?.minSeverity !== undefined && { minSeverity: config.minSeverity }),
+            ...(config?.categoryMask !== undefined && { categoryMask: config.categoryMask }),
+            ...(config?.captureRawEvents !== undefined && { captureRawEvents: config.captureRawEvents }),
+            ...(config?.captureDrawlistBytes !== undefined && {
+                captureDrawlistBytes: config.captureDrawlistBytes,
+            }),
+        };
+        await backend.debugEnable(fullConfig);
+        isEnabled = true;
+        currentConfig = fullConfig;
+    }
+    async function disable() {
+        await backend.debugDisable();
+        isEnabled = false;
+        currentConfig = null;
+    }
+    async function reset() {
+        await backend.debugReset();
+        frameInspector.clear();
+        eventTrace.clear();
+        errorAggregator.clear();
+        stateTimeline.clear();
+    }
+    async function query(filter) {
+        const { headers, result } = await backend.debugQuery(filter ?? {});
+        if (result.recordsReturned === 0) {
+            return [];
+        }
+        const records = [];
+        const HEADER_SIZE = 40;
+        for (let i = 0; i < result.recordsReturned; i++) {
+            const offset = i * HEADER_SIZE;
+            const headerResult = parseRecordHeader(headers, offset);
+            if (!headerResult.ok) {
+                continue;
+            }
+            const header = headerResult.value;
+            let payload = null;
+            if (header.payloadSize > 0) {
+                const payloadBytes = await backend.debugGetPayload(header.recordId);
+                if (payloadBytes) {
+                    const payloadResult = parsePayload(header.category, payloadBytes);
+                    if (payloadResult.ok) {
+                        payload = payloadResult.value;
+                    }
+                }
+            }
+            records.push({ header, payload });
+        }
+        return records;
+    }
+    async function getPayload(recordId) {
+        const bytes = await backend.debugGetPayload(recordId);
+        if (!bytes) {
+            return null;
+        }
+        // We don't know the category here, so try to parse based on size
+        // This is a best-effort attempt
+        const result = parseFrameRecord(bytes);
+        if (result.ok) {
+            return result.value;
+        }
+        return null;
+    }
+    async function getStats() {
+        return backend.debugGetStats();
+    }
+    async function exportRecords() {
+        return backend.debugExport();
+    }
+    function processRecords(headers, payloads) {
+        const HEADER_SIZE = 40;
+        const count = Math.floor(headers.byteLength / HEADER_SIZE);
+        for (let i = 0; i < count; i++) {
+            const offset = i * HEADER_SIZE;
+            const headerResult = parseRecordHeader(headers, offset);
+            if (!headerResult.ok) {
+                continue;
+            }
+            const header = headerResult.value;
+            let payload = null;
+            const payloadBytes = payloads.get(header.recordId);
+            if (payloadBytes) {
+                const payloadResult = parsePayload(header.category, payloadBytes);
+                if (payloadResult.ok) {
+                    payload = payloadResult.value;
+                }
+            }
+            const record = { header, payload };
+            // Route to appropriate component based on category
+            switch (header.category) {
+                case "frame":
+                    if (payload && payloadBytes) {
+                        const frameResult = parseFrameRecord(payloadBytes);
+                        if (frameResult.ok) {
+                            frameInspector.addFrame(frameResult.value, header.timestampUs);
+                        }
+                    }
+                    break;
+                case "event":
+                    if (payload && payloadBytes) {
+                        const eventResult = parseEventRecord(payloadBytes);
+                        if (eventResult.ok) {
+                            eventTrace.addEvent(eventResult.value, header.recordId, header.timestampUs);
+                        }
+                    }
+                    break;
+                case "error":
+                    if (payload && payloadBytes) {
+                        const errorResult = parseErrorRecord(payloadBytes);
+                        if (errorResult.ok) {
+                            errorAggregator.addError(errorResult.value, header.category, header.severity, header.timestampUs);
+                        }
+                    }
+                    break;
+            }
+            notifyRecordHandlers(record);
+        }
+    }
+    function on(event, handler) {
+        if (event === "record") {
+            const h = handler;
+            recordHandlers.add(h);
+            return () => {
+                recordHandlers.delete(h);
+            };
+        }
+        if (event === "error") {
+            return errorAggregator.on("error", handler);
+        }
+        return () => { };
+    }
+    return {
+        enable,
+        disable,
+        reset,
+        query,
+        getPayload,
+        getStats,
+        export: exportRecords,
+        frameInspector,
+        eventTrace,
+        errors: errorAggregator,
+        stateTimeline,
+        on: on,
+        processRecords,
+        get enabled() {
+            return isEnabled;
+        },
+        get config() {
+            return currentConfig;
+        },
+    };
+}
+//# sourceMappingURL=debugController.js.map

package/dist/debug/debugController.js.map

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

package/dist/debug/errorAggregator.d.ts

@@ -0,0 +1,89 @@
+/**
+ * packages/core/src/debug/errorAggregator.ts — Error collection and deduplication.
+ *
+ * Why: Aggregates errors from the debug trace by a unique key to avoid flooding
+ * the user with duplicate errors. Tracks occurrence counts and frame ranges for
+ * each unique error, enabling efficient error diagnosis.
+ *
+ * Usage:
+ *   - all(): Get all aggregated errors
+ *   - byCategory(cat): Filter by category
+ *   - bySeverity(sev): Filter by minimum severity
+ *   - on('error', handler): Subscribe to new errors
+ */
+import type { DebugCategory, DebugSeverity, ErrorRecord } from "./types.js";
+/**
+ * Aggregated error with deduplication and tracking.
+ */
+export type AggregatedError = Readonly<{
+    /** Unique ID (hash of code + message + sourceFile) */
+    id: string;
+    /** Error category */
+    category: DebugCategory;
+    /** Error severity */
+    severity: DebugSeverity;
+    /** Error code from the engine */
+    code: number;
+    /** Error message */
+    message: string;
+    /** Source file (if available) */
+    sourceFile: string | undefined;
+    /** Source line (if available) */
+    sourceLine: number | undefined;
+    /** First occurrence timestamp (ms) */
+    firstOccurrence: number;
+    /** Last occurrence timestamp (ms) */
+    lastOccurrence: number;
+    /** Total occurrence count */
+    count: number;
+    /** Frame IDs where this error occurred (limited) */
+    frameIds: readonly bigint[];
+}>;
+/**
+ * Error handler callback type.
+ */
+export type ErrorHandler = (error: AggregatedError) => void;
+/**
+ * Error aggregator interface for collecting and querying errors.
+ */
+export interface ErrorAggregator {
+    /**
+     * Add an error record to the aggregator.
+     * Called internally when processing debug records.
+     */
+    addError(record: ErrorRecord, category: DebugCategory, severity: DebugSeverity, timestampUs: bigint): void;
+    /**
+     * Get all aggregated errors.
+     */
+    all(): readonly AggregatedError[];
+    /**
+     * Get errors filtered by category.
+     */
+    byCategory(category: DebugCategory): readonly AggregatedError[];
+    /**
+     * Get errors at or above the specified severity.
+     */
+    bySeverity(minSeverity: DebugSeverity): readonly AggregatedError[];
+    /**
+     * Clear all aggregated errors.
+     */
+    clear(): void;
+    /**
+     * Subscribe to new errors.
+     * Returns an unsubscribe function.
+     */
+    on(event: "error", handler: ErrorHandler): () => void;
+    /**
+     * Get the number of unique errors.
+     */
+    readonly count: number;
+    /**
+     * Get the total number of error occurrences.
+     */
+    readonly totalOccurrences: number;
+}
+/**
+ * Create an error aggregator instance.
+ */
+export declare function createErrorAggregator(): ErrorAggregator;
+//# sourceMappingURL=errorAggregator.d.ts.map

package/dist/debug/errorAggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errorAggregator.d.ts","sourceRoot":"","sources":["../../src/debug/errorAggregator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,qBAAqB;IACrB,QAAQ,EAAE,aAAa,CAAC;IACxB,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,iCAAiC;IACjC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,qCAAqC;IACrC,cAAc,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7B,CAAC,CAAC;AAiBH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CACN,MAAM,EAAE,WAAW,EACnB,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,aAAa,EACvB,WAAW,EAAE,MAAM,GAClB,IAAI,CAAC;IAER;;OAEG;IACH,GAAG,IAAI,SAAS,eAAe,EAAE,CAAC;IAElC;;OAEG;IACH,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,SAAS,eAAe,EAAE,CAAC;IAEhE;;OAEG;IACH,UAAU,CAAC,WAAW,EAAE,aAAa,GAAG,SAAS,eAAe,EAAE,CAAC;IAEnE;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;OAGG;IACH,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI,CAAC;IAEtD;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAmBD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAoIvD"}