@capillaryjs/capillary-devtools 1.0.0

package/dist/model/TraceRecorder.js

@@ -0,0 +1,269 @@
+import { Diagnostics, Emitter } from '@capillaryjs/capillary';
+import { devtoolsDiagnosticScope } from './scope.js';
+/** A bounded, caller-owned sink. Payload references never enter default recordings. */
+export class TraceRecorder {
+    revision = new Emitter(0, { diagnosticScope: devtoolsDiagnosticScope });
+    options;
+    events = [];
+    nodes = new Map();
+    edges = [];
+    sequence = 0;
+    unsubscribe = null;
+    startedAt = null;
+    stoppedAt = null;
+    lateStart = true;
+    gaps = 0;
+    evictedEvents = 0;
+    droppedTopology = 0;
+    bytes = 0;
+    notifying = false;
+    disposed = false;
+    cached = null;
+    recordBytes = new WeakMap();
+    constructor(options = {}) {
+        this.options = { maxEvents: 2000, maxBytes: 2_000_000, maxNodes: 2000, maxEdges: 8000,
+            maxPreviewLength: 180, capture: 'scalar', clock: Date.now,
+            topology: true, verbose: false, ui: true, ...options };
+        for (const key of ['maxEvents', 'maxBytes', 'maxNodes', 'maxEdges', 'maxPreviewLength']) {
+            if (!Number.isSafeInteger(this.options[key]) || this.options[key] < 1) {
+                throw new TypeError(`${key} must be a positive safe integer`);
+            }
+        }
+        if (!['none', 'scalar', 'preview', 'raw', 'formatter'].includes(this.options.capture)) {
+            throw new TypeError('Unknown trace capture mode');
+        }
+        if (this.options.capture === 'formatter' && typeof options.formatter !== 'function') {
+            throw new TypeError('Formatter capture requires a formatter');
+        }
+    }
+    start(options = {}) {
+        if (this.disposed)
+            throw new Error('Cannot start a disposed recorder');
+        if (this.unsubscribe)
+            return this;
+        if (this.startedAt !== null)
+            this.gaps += 1;
+        else {
+            this.startedAt = this.options.clock();
+            this.lateStart = !options.fromStart;
+        }
+        this.stoppedAt = null;
+        this.unsubscribe = Diagnostics.subscribe((fact) => this.accept(fact), this.options);
+        for (const root of options.roots ?? [])
+            Diagnostics.inspect(root);
+        this.changed();
+        return this;
+    }
+    stop() {
+        if (!this.unsubscribe)
+            return this;
+        this.unsubscribe();
+        this.unsubscribe = null;
+        this.stoppedAt = this.options.clock();
+        this.changed();
+        return this;
+    }
+    reset() {
+        const active = this.unsubscribe !== null;
+        this.stop();
+        this.events = [];
+        this.nodes.clear();
+        this.edges = [];
+        this.sequence = 0;
+        this.startedAt = null;
+        this.stoppedAt = null;
+        this.lateStart = true;
+        this.gaps = 0;
+        this.evictedEvents = 0;
+        this.droppedTopology = 0;
+        this.bytes = 0;
+        if (active)
+            this.start();
+        this.changed();
+        return this;
+    }
+    snapshot() {
+        this.cached ??= Object.freeze({ schemaVersion: 1, events: Object.freeze([...this.events]),
+            nodes: Object.freeze([...this.nodes.values()]), edges: Object.freeze([...this.edges]),
+            capture: Object.freeze({ active: this.unsubscribe !== null, startedAt: this.startedAt,
+                stoppedAt: this.stoppedAt, lateStart: this.lateStart, gaps: this.gaps,
+                evictedEvents: this.evictedEvents, droppedTopology: this.droppedTopology, bytes: this.bytes,
+                maxBytes: this.options.maxBytes, maxEvents: this.options.maxEvents,
+                rawReferences: this.options.capture === 'raw', topology: this.options.topology,
+                ui: this.options.ui, verbose: this.options.verbose }) });
+        return this.cached;
+    }
+    /** Safe JSON export strips raw references before serialization (including toJSON hooks). */
+    export() { return JSON.stringify(exportable(this.snapshot()), null, 2); }
+    dispose() { this.stop(); this.disposed = true; this.revision.dispose(); }
+    accept(fact) {
+        if (fact.type === 'node')
+            this.addNode(fact.node);
+        else if (fact.type === 'disposed') {
+            const node = this.nodes.get(fact.nodeId);
+            if (node)
+                this.nodes.set(node.id, Object.freeze({ ...node, disposedSequence: this.sequence }));
+            this.edges = this.edges.map((edge) => edge.toSequence === null
+                && (edge.from === fact.nodeId || edge.to === fact.nodeId)
+                ? Object.freeze({ ...edge, toSequence: this.sequence }) : edge);
+        }
+        else if (fact.type === 'edge') {
+            const index = this.edges.findIndex((edge) => edge.from === fact.from && edge.to === fact.to && edge.toSequence === null);
+            if (fact.connected && index < 0)
+                this.edges.push(Object.freeze({ from: fact.from, to: fact.to,
+                    fromSequence: this.sequence, toSequence: null }));
+            else if (!fact.connected && index >= 0)
+                this.edges[index] = Object.freeze({ ...this.edges[index], toSequence: this.sequence });
+        }
+        else {
+            const event = fact.event;
+            if (event.diagnosticScope?.capture === false)
+                return;
+            const details = event.diagnostic;
+            const owner = event.owner;
+            const identity = details?.node ?? Diagnostics.node(owner !== null && (typeof owner === 'object' || typeof owner === 'function') ? owner : event);
+            if (!identity)
+                return;
+            const node = details?.node ?? { ...identity, label: event.purpose };
+            this.addNode(node);
+            const preview = (value, field) => this.preview(value, { nodeId: node.id, field });
+            this.events.push(Object.freeze({ id: event.id, sequence: this.sequence++, timestamp: this.options.clock(),
+                parentId: event.parent?.id ?? null, nodeId: node.id, kind: details?.kind ?? 'operation',
+                outcome: details?.outcome ?? null, cause: (typeof event.cause === 'string' ? event.cause : scalarText(event.cause)).slice(0, 512),
+                value: preview(event.value, 'value'), before: details && Object.hasOwn(details, 'before')
+                    ? preview(details.before, 'before') : null,
+                error: details?.error == null ? null : preview(details.error, 'error'),
+                fetchState: details?.fetchState ?? null, attemptId: details?.attemptId ?? null,
+                delayMs: details?.delayMs ?? null,
+                inputs: Object.freeze((details?.inputs ?? []).map((input) => Object.freeze({ nodeId: input.nodeId,
+                    value: preview(input.value, 'input') }))) }));
+        }
+        this.enforceBounds();
+        this.changed();
+    }
+    addNode(node) {
+        if (this.nodes.has(node.id))
+            return;
+        this.nodes.set(node.id, Object.freeze({ ...node, label: node.label.slice(0, 240),
+            firstSequence: this.sequence, disposedSequence: null }));
+    }
+    preview(value, context) {
+        const mode = this.options.capture;
+        const type = value === null ? 'null' : typeof value;
+        let text;
+        let captureError;
+        try {
+            text = mode === 'none' ? 'not captured'
+                : mode === 'formatter' ? this.options.formatter(value, context)
+                    : mode === 'preview' ? boundedPreview(value, this.options.maxPreviewLength)
+                        : scalarText(value);
+            if (typeof text !== 'string')
+                throw new TypeError('Formatter must return a string');
+        }
+        catch {
+            text = '[capture failed]';
+            captureError = 'Preview capture failed';
+        }
+        const truncated = text.length > this.options.maxPreviewLength;
+        return Object.freeze({ text: text.slice(0, this.options.maxPreviewLength), type, truncated,
+            historical: mode !== 'raw', ...(captureError ? { captureError } : {}),
+            ...(mode === 'raw' ? { raw: value } : {}) });
+    }
+    enforceBounds() {
+        while (this.events.length > this.options.maxEvents) {
+            this.events.shift();
+            this.evictedEvents += 1;
+        }
+        while (this.nodes.size > this.options.maxNodes)
+            this.evictNode();
+        while (this.edges.length > this.options.maxEdges) {
+            this.edges.shift();
+            this.droppedTopology += 1;
+        }
+        this.bytes = this.byteSize();
+        while (this.bytes > this.options.maxBytes) {
+            if (this.events.length) {
+                this.events.shift();
+                this.evictedEvents += 1;
+            }
+            else if (this.edges.length) {
+                this.edges.shift();
+                this.droppedTopology += 1;
+            }
+            else if (this.nodes.size)
+                this.evictNode();
+            else
+                break;
+            this.bytes = this.byteSize();
+        }
+    }
+    evictNode() {
+        const id = this.nodes.keys().next().value;
+        this.nodes.delete(id);
+        const removed = this.edges.filter((edge) => edge.from === id || edge.to === id).length;
+        this.edges = this.edges.filter((edge) => edge.from !== id && edge.to !== id);
+        this.droppedTopology += 1 + removed;
+    }
+    byteSize() {
+        // UTF-16 upper bound for JSON metadata; excludes deliberately retained raw object heaps.
+        const size = (record, serialize) => {
+            let bytes = this.recordBytes.get(record);
+            if (bytes === undefined) {
+                bytes = JSON.stringify(serialize()).length * 2;
+                this.recordBytes.set(record, bytes);
+            }
+            return bytes;
+        };
+        return this.events.reduce((bytes, record) => bytes + size(record, () => exportEvent(record)), 0)
+            + [...this.nodes.values(), ...this.edges].reduce((bytes, record) => bytes + size(record, () => record), 0);
+    }
+    changed() {
+        this.cached = null;
+        if (this.notifying || this.disposed)
+            return;
+        this.notifying = true;
+        queueMicrotask(() => {
+            this.notifying = false;
+            if (!this.disposed)
+                this.revision.set(this.revision.get() + 1);
+        });
+    }
+}
+function scalarText(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return JSON.stringify(value);
+    if (typeof value === 'object')
+        return '[object; contents not captured]';
+    if (typeof value === 'function')
+        return '[function]';
+    return String(value);
+}
+function boundedPreview(value, budget) {
+    if (value === null || typeof value !== 'object')
+        return scalarText(value);
+    const parts = [];
+    // This explicitly selected mode reads only descriptors; never invoke a getter.
+    for (const key of Reflect.ownKeys(value).slice(0, 8)) {
+        const descriptor = Object.getOwnPropertyDescriptor(value, key);
+        parts.push(`${String(key)}: ${descriptor && 'value' in descriptor ? scalarText(descriptor.value).slice(0, budget) : '[accessor]'}`);
+        if (parts.join(', ').length >= budget)
+            break;
+    }
+    return `{${parts.join(', ')}}`;
+}
+function exportPreview(value) {
+    if (!value)
+        return null;
+    const { raw: _raw, ...safe } = value;
+    return safe;
+}
+function exportEvent(event) {
+    return { ...event, value: exportPreview(event.value), before: exportPreview(event.before),
+        error: exportPreview(event.error), inputs: event.inputs.map((input) => ({ ...input, value: exportPreview(input.value) })) };
+}
+function exportable(recording) {
+    return { ...recording, events: recording.events.map(exportEvent) };
+}
+//# sourceMappingURL=TraceRecorder.js.map

package/dist/model/TraceRecorder.js.map

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

package/dist/model/TraceSelection.d.ts

@@ -0,0 +1,18 @@
+import { Emitter } from '@capillaryjs/capillary';
+export interface TraceSelectionState {
+    readonly rootId: string | null;
+    readonly eventId: string | null;
+    readonly nodeId: string | null;
+    readonly sourceId: string | null;
+    readonly targetId: string | null;
+}
+export declare class TraceSelection {
+    readonly state: Emitter<TraceSelectionState, unknown>;
+    selectRoot(rootId: string | null): void;
+    selectEvent(eventId: string, nodeId: string): void;
+    selectNode(nodeId: string): void;
+    filter(sourceId: string | null, targetId: string | null): void;
+    dispose(): void;
+    private patch;
+}
+//# sourceMappingURL=TraceSelection.d.ts.map

package/dist/model/TraceSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceSelection.d.ts","sourceRoot":"","sources":["../../src/model/TraceSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,wBAAwB,CAAA;AAG9C,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;CACnC;AAED,qBAAa,cAAc;IACvB,QAAQ,CAAC,KAAK,wCACkE;IAChF,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAGvC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAClD,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAChC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAG9D,OAAO,IAAI,IAAI;IACf,OAAO,CAAC,KAAK;CAChB"}

package/dist/model/TraceSelection.js

@@ -0,0 +1,17 @@
+import { Emitter } from '@capillaryjs/capillary';
+import { devtoolsDiagnosticScope } from './scope.js';
+export class TraceSelection {
+    state = new Emitter({ rootId: null, eventId: null, nodeId: null,
+        sourceId: null, targetId: null }, { diagnosticScope: devtoolsDiagnosticScope });
+    selectRoot(rootId) {
+        this.state.set({ rootId, eventId: rootId, nodeId: null, sourceId: null, targetId: null });
+    }
+    selectEvent(eventId, nodeId) { this.patch({ eventId, nodeId }); }
+    selectNode(nodeId) { this.patch({ nodeId, eventId: null }); }
+    filter(sourceId, targetId) {
+        this.patch({ sourceId, targetId, nodeId: targetId ?? sourceId, eventId: null });
+    }
+    dispose() { this.state.dispose(); }
+    patch(next) { this.state.set({ ...this.state.get(), ...next }); }
+}
+//# sourceMappingURL=TraceSelection.js.map

package/dist/model/TraceSelection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TraceSelection.js","sourceRoot":"","sources":["../../src/model/TraceSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,wBAAwB,CAAA;AAC9C,OAAO,EAAC,uBAAuB,EAAC,MAAM,YAAY,CAAA;AAUlD,MAAM,OAAO,cAAc;IACd,KAAK,GAAG,IAAI,OAAO,CAAsB,EAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI;QACxF,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAC,EAAE,EAAC,eAAe,EAAE,uBAAuB,EAAC,CAAC,CAAA;IAChF,UAAU,CAAC,MAAqB;QAC5B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAC,CAAC,CAAA;IAC3F,CAAC;IACD,WAAW,CAAC,OAAe,EAAE,MAAc,IAAU,IAAI,CAAC,KAAK,CAAC,EAAC,OAAO,EAAE,MAAM,EAAC,CAAC,CAAA,CAAC,CAAC;IACpF,UAAU,CAAC,MAAc,IAAU,IAAI,CAAC,KAAK,CAAC,EAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC,CAAA,CAAC,CAAC;IACxE,MAAM,CAAC,QAAuB,EAAE,QAAuB;QACnD,IAAI,CAAC,KAAK,CAAC,EAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAC,CAAC,CAAA;IACjF,CAAC;IACD,OAAO,KAAW,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC;IAChC,KAAK,CAAC,IAAkC,IAAU,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAC,CAAC,CAAA,CAAC,CAAC;CAC7G"}

package/dist/model/index.d.ts

@@ -0,0 +1,11 @@
+export { TraceRecorder } from './TraceRecorder.js';
+export type { TraceRecorderOptions, TraceCaptureMode, TraceCaptureContext } from './TraceRecorder.js';
+export { TraceSelection } from './TraceSelection.js';
+export type { TraceSelectionState } from './TraceSelection.js';
+export { TracePlayback } from './TracePlayback.js';
+export type { TracePlaybackScheduler, TracePlaybackState } from './TracePlayback.js';
+export { devtoolsDiagnosticScope } from './scope.js';
+export { filterTrace, traceRoots, causalOutline, traceAttempts, projectFlow, nodeValueEvent, captureLimitations } from './projection.js';
+export type { CausalRow, FlowNode, FlowEdge, TraceFlow } from './projection.js';
+export type { TraceEvent, TraceNode, TraceEdge, TraceRecording, TraceFilter, TraceAttempt, ValuePreview } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAC,oBAAoB,EAAE,gBAAgB,EAAE,mBAAmB,EAAC,MAAM,oBAAoB,CAAA;AACnG,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAA;AAClD,YAAY,EAAC,mBAAmB,EAAC,MAAM,qBAAqB,CAAA;AAC5D,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAA;AAChD,YAAY,EAAC,sBAAsB,EAAE,kBAAkB,EAAC,MAAM,oBAAoB,CAAA;AAClF,OAAO,EAAC,uBAAuB,EAAC,MAAM,YAAY,CAAA;AAClD,OAAO,EAAC,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAC,MAAM,iBAAiB,CAAA;AACtI,YAAY,EAAC,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAC,MAAM,iBAAiB,CAAA;AAC7E,YAAY,EAAC,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAC,MAAM,YAAY,CAAA"}

package/dist/model/index.js

@@ -0,0 +1,6 @@
+export { TraceRecorder } from './TraceRecorder.js';
+export { TraceSelection } from './TraceSelection.js';
+export { TracePlayback } from './TracePlayback.js';
+export { devtoolsDiagnosticScope } from './scope.js';
+export { filterTrace, traceRoots, causalOutline, traceAttempts, projectFlow, nodeValueEvent, captureLimitations } from './projection.js';
+//# sourceMappingURL=index.js.map

package/dist/model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/model/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAC,cAAc,EAAC,MAAM,qBAAqB,CAAA;AAElD,OAAO,EAAC,aAAa,EAAC,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAC,uBAAuB,EAAC,MAAM,YAAY,CAAA;AAClD,OAAO,EAAC,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAC,MAAM,iBAAiB,CAAA"}

package/dist/model/projection.d.ts

@@ -0,0 +1,37 @@
+import type { TraceAttempt, TraceEvent, TraceFilter, TraceNode, TraceRecording } from './types.js';
+export declare function traceRoots(recording: TraceRecording): readonly TraceEvent[];
+/** Intersect occurrence ancestry/descendancy; every converging occurrence is retained. */
+export declare function filterTrace(recording: TraceRecording, filter?: TraceFilter): readonly TraceEvent[];
+export interface CausalRow {
+    readonly event: TraceEvent;
+    readonly depth: number;
+    readonly missingParent: boolean;
+}
+/** Last observed state, not a later lifecycle marker's absent payload. */
+export declare function nodeValueEvent(events: readonly TraceEvent[]): TraceEvent | undefined;
+export declare function causalOutline(events: readonly TraceEvent[]): readonly CausalRow[];
+export declare function traceAttempts(events: readonly TraceEvent[]): readonly TraceAttempt[];
+export interface FlowNode {
+    readonly node: TraceNode;
+    readonly events: readonly TraceEvent[];
+    readonly x: number;
+    readonly y: number;
+    readonly leaf: string | null;
+}
+export interface FlowEdge {
+    readonly from: string;
+    readonly to: string;
+    readonly observed: boolean;
+}
+export interface TraceFlow {
+    readonly nodes: readonly FlowNode[];
+    readonly edges: readonly FlowEdge[];
+    readonly width: number;
+    readonly height: number;
+}
+/** Stable geometry depends on the complete selected trace, never the replay cursor. */
+export declare function projectFlow(recording: TraceRecording, events: readonly TraceEvent[], options?: {
+    includeConnected?: boolean;
+}): TraceFlow;
+export declare function captureLimitations(recording: TraceRecording): readonly string[];
+//# sourceMappingURL=projection.d.ts.map

package/dist/model/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../src/model/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAC,MAAM,YAAY,CAAA;AAEhG,wBAAgB,UAAU,CAAC,SAAS,EAAE,cAAc,GAAG,SAAS,UAAU,EAAE,CAG3E;AAED,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,GAAE,WAAgB,GAAG,SAAS,UAAU,EAAE,CAuBtG;AAED,MAAM,WAAW,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAAC;AAEhH,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,UAAU,GAAG,SAAS,CAGpF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,SAAS,EAAE,CAkBjF;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,YAAY,EAAE,CAcpF;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;IACtC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AACD,MAAM,WAAW,QAAQ;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAC;AAClG,MAAM,WAAW,SAAS;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAC;AAEtJ,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,EAAE,OAAO,GAAE;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAM,GAAG,SAAS,CAiE3I;AAiCD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,cAAc,GAAG,SAAS,MAAM,EAAE,CAgB/E"}

package/dist/model/projection.js

@@ -0,0 +1,207 @@
+export function traceRoots(recording) {
+    const ids = new Set(recording.events.map((event) => event.id));
+    return recording.events.filter((event) => event.parentId === null || !ids.has(event.parentId));
+}
+/** Intersect occurrence ancestry/descendancy; every converging occurrence is retained. */
+export function filterTrace(recording, filter = {}) {
+    const all = recording.events;
+    const byId = new Map(all.map((event) => [event.id, event]));
+    const descendants = (seeds) => {
+        const included = new Set(seeds);
+        for (const event of all)
+            if (event.parentId && included.has(event.parentId))
+                included.add(event.id);
+        return included;
+    };
+    const root = filter.rootId ? descendants(new Set([filter.rootId])) : new Set(all.map((event) => event.id));
+    const within = all.filter((event) => root.has(event.id));
+    const downstream = filter.sourceId
+        ? descendants(new Set(within.filter((event) => event.nodeId === filter.sourceId).map((event) => event.id))) : root;
+    const upstream = filter.targetId ? new Set() : root;
+    if (filter.targetId) {
+        for (const target of within.filter((event) => event.nodeId === filter.targetId)) {
+            let event = target;
+            while (event && !upstream.has(event.id)) {
+                upstream.add(event.id);
+                event = event.parentId ? byId.get(event.parentId) : undefined;
+            }
+        }
+    }
+    return within.filter((event) => downstream.has(event.id) && upstream.has(event.id));
+}
+/** Last observed state, not a later lifecycle marker's absent payload. */
+export function nodeValueEvent(events) {
+    return events.findLast((event) => ['value', 'state', 'derived', 'recomputed-unchanged', 'subscribed'].includes(event.kind))
+        ?? events.findLast((event) => event.value.type !== 'undefined') ?? events.at(-1);
+}
+export function causalOutline(events) {
+    const children = new Map();
+    const ids = new Set(events.map((event) => event.id));
+    for (const event of events) {
+        const key = event.parentId && ids.has(event.parentId) ? event.parentId : '';
+        const list = children.get(key) ?? [];
+        list.push(event);
+        children.set(key, list);
+    }
+    const result = [];
+    const stack = [...(children.get('') ?? [])].reverse().map((event) => ({ event, depth: 0 }));
+    while (stack.length) {
+        const current = stack.pop();
+        result.push({ ...current, missingParent: current.event.parentId !== null && !ids.has(current.event.parentId) });
+        for (const child of [...(children.get(current.event.id) ?? [])].reverse()) {
+            stack.push({ event: child, depth: current.depth + 1 });
+        }
+    }
+    return result;
+}
+export function traceAttempts(events) {
+    const groups = new Map();
+    for (const event of events) {
+        if (!event.attemptId)
+            continue;
+        const group = groups.get(event.attemptId) ?? [];
+        group.push(event);
+        groups.set(event.attemptId, group);
+    }
+    return [...groups].map(([id, group]) => {
+        const start = group.find((event) => event.outcome === 'started') ?? null;
+        const end = group.findLast((event) => event.outcome !== 'started') ?? null;
+        return { id, nodeId: group[0].nodeId, start, end,
+            status: end?.outcome ?? 'unfinished in capture',
+            durationMs: start && end ? Math.max(0, end.timestamp - start.timestamp) : null };
+    });
+}
+/** Stable geometry depends on the complete selected trace, never the replay cursor. */
+export function projectFlow(recording, events, options = {}) {
+    const nodes = new Map(recording.nodes.map((node) => [node.id, node]));
+    const included = new Set(events.map((event) => event.nodeId));
+    const byEventId = new Map(recording.events.map((event) => [event.id, event]));
+    const edges = new Map();
+    for (const event of events) {
+        const parent = event.parentId ? byEventId.get(event.parentId) : null;
+        if (parent && included.has(parent.nodeId) && parent.nodeId !== event.nodeId) {
+            edges.set(`${parent.nodeId}:${event.nodeId}`, { from: parent.nodeId, to: event.nodeId, observed: true });
+        }
+    }
+    const first = events[0]?.sequence ?? 0;
+    const last = events.at(-1)?.sequence ?? first;
+    const possible = recording.edges.filter((edge) => edge.fromSequence <= last
+        && (edge.toSequence === null || edge.toSequence > first));
+    // Downstream discovery includes subscribers and emitters that produced no event.
+    const queue = options.includeConnected === false ? [] : [...included];
+    while (queue.length) {
+        const id = queue.shift();
+        for (const edge of possible.filter((candidate) => candidate.from === id)) {
+            if (!included.has(edge.to)) {
+                included.add(edge.to);
+                queue.push(edge.to);
+            }
+            const key = `${edge.from}:${edge.to}`;
+            if (!edges.has(key))
+                edges.set(key, { ...edge, observed: false });
+        }
+    }
+    // Full-input provenance is context, not evidence of propagation.
+    for (const event of events)
+        for (const input of event.inputs) {
+            included.add(input.nodeId);
+            const key = `${input.nodeId}:${event.nodeId}`;
+            if (!edges.has(key) && input.nodeId !== event.nodeId) {
+                edges.set(key, { from: input.nodeId, to: event.nodeId, observed: false });
+            }
+        }
+    const ids = [...included];
+    const links = [...edges.values()];
+    // Strongly connected components keep feedback finite, then rank the condensed DAG.
+    const components = stronglyConnected(ids, links);
+    const groupOf = new Map(components.flatMap((group, index) => group.map((id) => [id, index])));
+    const rank = components.map(() => 0);
+    for (let pass = 0; pass < components.length; pass++) {
+        let changed = false;
+        for (const edge of links) {
+            const from = groupOf.get(edge.from), to = groupOf.get(edge.to);
+            if (from !== to && rank[to] < rank[from] + 1) {
+                rank[to] = rank[from] + 1;
+                changed = true;
+            }
+        }
+        if (!changed)
+            break;
+    }
+    const rows = new Map();
+    const positioned = ids.map((id) => {
+        const column = rank[groupOf.get(id)] ?? 0;
+        const row = rows.get(column) ?? 0;
+        rows.set(column, row + 1);
+        const occurrences = events.filter((event) => event.nodeId === id);
+        const node = nodes.get(id) ?? { id, label: 'Node metadata evicted', kind: 'external', scopeId: 'unknown', firstSequence: first, disposedSequence: null };
+        const outgoing = links.some((edge) => edge.from === id);
+        const leaf = outgoing ? null
+            : node.kind === 'component' || node.kind === 'binding' ? 'UI endpoint'
+                : node.kind === 'subscriber' ? 'subscription leaf'
+                    : node.kind === 'emitter' || node.kind === 'derived' ? 'emitter without known subscribers'
+                        : 'downstream leaf';
+        return { node, events: occurrences, x: 20 + column * 260, y: 20 + row * 132, leaf };
+    });
+    return { nodes: positioned, edges: links,
+        width: Math.max(300, ...positioned.map((node) => node.x + 240)),
+        height: Math.max(150, ...positioned.map((node) => node.y + 120)) };
+}
+function stronglyConnected(ids, edges) {
+    const visited = new Set(), order = [];
+    // Iterative DFS avoids call-stack limits for large retained traces.
+    const forward = new Map(ids.map((id) => [id, edges.filter((edge) => edge.from === id).map((edge) => edge.to)]));
+    const reverse = new Map(ids.map((id) => [id, edges.filter((edge) => edge.to === id).map((edge) => edge.from)]));
+    for (const seed of ids) {
+        const stack = [[seed, false]];
+        while (stack.length) {
+            const [id, finish] = stack.pop();
+            if (finish) {
+                order.push(id);
+                continue;
+            }
+            if (visited.has(id))
+                continue;
+            visited.add(id);
+            stack.push([id, true]);
+            for (const next of forward.get(id) ?? [])
+                if (!visited.has(next))
+                    stack.push([next, false]);
+        }
+    }
+    visited.clear();
+    const groups = [];
+    for (const seed of order.reverse()) {
+        if (visited.has(seed))
+            continue;
+        const group = [], stack = [seed];
+        while (stack.length) {
+            const id = stack.pop();
+            if (visited.has(id))
+                continue;
+            visited.add(id);
+            group.push(id);
+            stack.push(...(reverse.get(id) ?? []));
+        }
+        groups.push(group);
+    }
+    return groups;
+}
+export function captureLimitations(recording) {
+    const { capture } = recording;
+    return [
+        ...(!capture.topology ? ['Topology capture was disabled; unobserved downstream connections and leaves are unknown.'] : []),
+        ...(!capture.ui ? ['UI occurrence capture was disabled; component and interaction execution is unknown.'] : []),
+        ...(!capture.verbose ? ['Unchanged recomputations and full input snapshots were not captured.'] : []),
+        ...(capture.lateStart ? ['Capture began after the graph may have been created; earlier activity is unknown.'] : []),
+        ...(capture.gaps ? [`Recording was paused ${capture.gaps} time(s); activity during those gaps is unknown.`] : []),
+        ...(capture.evictedEvents ? [`${capture.evictedEvents} events evicted by the recording budget.`] : []),
+        ...(capture.droppedTopology ? [`${capture.droppedTopology} topology records evicted; connected leaves may be missing.`] : []),
+        ...(recording.events.some((event) => event.parentId && !recording.events.some((parent) => parent.id === event.parentId))
+            ? ['Some causal parents are outside this capture.'] : []),
+        ...(traceAttempts(recording.events).some((attempt) => !attempt.end)
+            ? ['Some attempts are unfinished in this capture; they are not necessarily still running.'] : []),
+        ...(capture.rawReferences ? ['Raw references are mutable, are omitted from JSON export, and their object heaps are outside the byte budget.'] : []),
+    ];
+}
+//# sourceMappingURL=projection.js.map