@ifc-lite/load-trace 0.0.0-stage → 0.1.0

package/dist/counters.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Structural perf counters (#6957): plain named sums (messages, bytes copied,
+ * GPU buffers, setState calls, ...) that any package bumps without knowing
+ * which load is running. A load trace reads the registry when the load starts
+ * and again when it ends, so each load reports the delta (`LoadTraceSnapshot.counters`).
+ *
+ * OFF until `enable()`: every bump is then one boolean test, so the call sites
+ * in hot paths (renderer, store, worker message wrapper) cost nothing
+ * measurable in production. The viewer enables it only under `?perfTrace=1`
+ * and in benchmark runs.
+ */
+export type CounterValues = Record<string, number>;
+export interface PerfCounterRegistry {
+    readonly enabled: boolean;
+    enable(): void;
+    add(name: string, n?: number): void;
+    /** Copy of every counter's running total. */
+    read(): CounterValues;
+    /** Increments since the previous `drain` (or since enable), or `null` when nothing moved. */
+    drain(): CounterValues | null;
+}
+export declare function createPerfCounters(): PerfCounterRegistry;
+export declare const perfCounters: PerfCounterRegistry;
+/** Bump `name` by `n` (default 1) when counters are on. */
+export declare function perfCount(name: string, n?: number): void;
+/** Bump `<name>.count` by one and `<name>.<unit>` by `amount` (e.g. a copy and its bytes). */
+export declare function perfTally(name: string, amount: number, unit?: string): void;
+/** Count a full copy of a buffer as `copy.<kind>` and hand the copy back unchanged. */
+export declare function countCopy<T extends ArrayBufferLike | ArrayBufferView>(kind: string, copy: T): T;
+/** `after - before` per name, dropping zeros (counters only grow). */
+export declare function diffCounters(after: CounterValues, before: CounterValues): CounterValues;
+/** Add `delta` into `into` in place. */
+export declare function addCounters(into: CounterValues, delta: Readonly<CounterValues>): void;
+//# sourceMappingURL=counters.d.ts.map

package/dist/counters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counters.d.ts","sourceRoot":"","sources":["../src/counters.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAEnD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,MAAM,IAAI,IAAI,CAAC;IACf,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,6CAA6C;IAC7C,IAAI,IAAI,aAAa,CAAC;IACtB,6FAA6F;IAC7F,KAAK,IAAI,aAAa,GAAG,IAAI,CAAC;CAC/B;AAED,wBAAgB,kBAAkB,IAAI,mBAAmB,CAoBxD;AAUD,eAAO,MAAM,YAAY,EAAE,mBAAkE,CAAC;AAE9F,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,SAAI,GAAG,IAAI,CAEnD;AAED,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,SAAU,GAAG,IAAI,CAI5E;AAED,uFAAuF;AACvF,wBAAgB,SAAS,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAG/F;AAED,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,GAAG,aAAa,CAOvF;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAErF"}

package/dist/counters.js

@@ -0,0 +1,69 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export function createPerfCounters() {
+    const totals = new Map();
+    let pending = new Map();
+    let enabled = false;
+    return {
+        get enabled() { return enabled; },
+        enable() { enabled = true; },
+        add(name, n = 1) {
+            if (!enabled)
+                return;
+            totals.set(name, (totals.get(name) ?? 0) + n);
+            pending.set(name, (pending.get(name) ?? 0) + n);
+        },
+        read: () => Object.fromEntries(totals),
+        drain() {
+            if (pending.size === 0)
+                return null;
+            const out = Object.fromEntries(pending);
+            pending = new Map();
+            return out;
+        },
+    };
+}
+/**
+ * One registry per JS realm, kept on `globalThis` so two bundled copies of
+ * this package (a published package's `dist` plus the app's source) still
+ * share it. Each worker has its own realm and therefore its own registry; it
+ * reaches the main thread through `createWorkerTraceHost`.
+ */
+const REGISTRY_KEY = Symbol.for('ifc-lite.perf-counters');
+const realm = globalThis;
+export const perfCounters = realm[REGISTRY_KEY] ??= createPerfCounters();
+/** Bump `name` by `n` (default 1) when counters are on. */
+export function perfCount(name, n = 1) {
+    if (perfCounters.enabled)
+        perfCounters.add(name, n);
+}
+/** Bump `<name>.count` by one and `<name>.<unit>` by `amount` (e.g. a copy and its bytes). */
+export function perfTally(name, amount, unit = 'bytes') {
+    if (!perfCounters.enabled)
+        return;
+    perfCounters.add(`${name}.count`);
+    perfCounters.add(`${name}.${unit}`, amount);
+}
+/** Count a full copy of a buffer as `copy.<kind>` and hand the copy back unchanged. */
+export function countCopy(kind, copy) {
+    if (perfCounters.enabled)
+        perfTally(`copy.${kind}`, copy.byteLength);
+    return copy;
+}
+/** `after - before` per name, dropping zeros (counters only grow). */
+export function diffCounters(after, before) {
+    const out = {};
+    for (const [name, value] of Object.entries(after)) {
+        const delta = value - (before[name] ?? 0);
+        if (delta !== 0)
+            out[name] = delta;
+    }
+    return out;
+}
+/** Add `delta` into `into` in place. */
+export function addCounters(into, delta) {
+    for (const [name, value] of Object.entries(delta))
+        into[name] = (into[name] ?? 0) + value;
+}
+//# sourceMappingURL=counters.js.map

package/dist/counters.js.map

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

package/dist/frames.d.ts

@@ -0,0 +1,69 @@
+import type { TraceSpan } from './types.js';
+/**
+ * Main-thread health (#6957): `long-animation-frame` (LoAF) and `longtask`
+ * entries, kept in a bounded log and summarised per load window. Both entry
+ * types are feature-detected; an engine without them reports `supported:
+ * false` and empty stats rather than zeros that look like a healthy load.
+ */
+export type FrameEntryType = 'loaf' | 'longtask';
+export interface FrameEntry {
+    type: FrameEntryType;
+    start: number;
+    duration: number;
+    /** LoAF `blockingDuration`; for a long task, the part over 50 ms. */
+    blocking: number;
+}
+export interface FrameMonitor {
+    readonly supported: Readonly<Record<FrameEntryType, boolean>>;
+    /** Every retained entry, after flushing the observers' undelivered records. */
+    entries(): readonly FrameEntry[];
+    stop(): void;
+}
+export interface FrameStats {
+    count: number;
+    /** Entries longer than 50 ms (every LoAF is, by definition). */
+    over50: number;
+    totalMs: number;
+    blockingMs: number;
+    longestMs: number;
+}
+export interface SpanFrameStats {
+    count: number;
+    blockingMs: number;
+    durationMs: number;
+}
+export interface FrameSummary {
+    supported: Record<FrameEntryType, boolean>;
+    loaf: FrameStats;
+    longtask: FrameStats;
+    /**
+     * LoAF blocking time by the innermost main-thread span open at the frame's
+     * start (`load` when none is). Long tasks fall back here when LoAF is absent.
+     */
+    bySpan: Record<string, SpanFrameStats>;
+}
+interface ObserverEntry {
+    startTime: number;
+    duration: number;
+    blockingDuration?: number;
+}
+interface ObserverLike {
+    observe(options: {
+        type: string;
+        buffered?: boolean;
+    }): void;
+    takeRecords(): Array<ObserverEntry>;
+    disconnect(): void;
+}
+export interface ObserverCtor {
+    new (cb: (list: {
+        getEntries(): ObserverEntry[];
+    }) => void): ObserverLike;
+    readonly supportedEntryTypes?: readonly string[];
+}
+/** Start observing both entry types; `max` bounds the log (oldest dropped). */
+export declare function startFrameMonitor(Observer?: ObserverCtor | undefined, max?: number): FrameMonitor;
+/** Summarise the entries that START inside `[start, end)`, attributing each to a span of `spans`. */
+export declare function summarizeFrames(entries: readonly FrameEntry[], supported: Readonly<Record<FrameEntryType, boolean>>, start: number, end: number, spans: readonly TraceSpan[]): FrameSummary;
+export {};
+//# sourceMappingURL=frames.d.ts.map

package/dist/frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../src/frames.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;GAKG;AAEH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,CAAC;AAEjD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9D,+EAA+E;IAC/E,OAAO,IAAI,SAAS,UAAU,EAAE,CAAC;IACjC,IAAI,IAAI,IAAI,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE;AAEzF,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAC3C,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,UAAU,CAAC;IACrB;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CACxC;AAID,UAAU,aAAa;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE;AAC1F,UAAU,YAAY;IACpB,OAAO,CAAC,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7D,WAAW,IAAI,KAAK,CAAC,aAAa,CAAC,CAAC;IACpC,UAAU,IAAI,IAAI,CAAC;CACpB;AACD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,EAAE,CAAC,IAAI,EAAE;QAAE,UAAU,IAAI,aAAa,EAAE,CAAA;KAAE,KAAK,IAAI,GAAG,YAAY,CAAC;IAC1E,QAAQ,CAAC,mBAAmB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD;AAID,+EAA+E;AAC/E,wBAAgB,iBAAiB,CAC/B,QAAQ,GAAE,YAAY,GAAG,SAAsF,EAC/G,GAAG,SAAS,GACX,YAAY,CA8Bd;AAKD,qGAAqG;AACrG,wBAAgB,eAAe,CAC7B,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,EACpD,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,SAAS,SAAS,EAAE,GAC1B,YAAY,CA6Bd"}

package/dist/frames.js

@@ -0,0 +1,85 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+const LONG_TASK_MS = 50;
+const ENTRY_TYPES = [['loaf', 'long-animation-frame'], ['longtask', 'longtask']];
+/** Start observing both entry types; `max` bounds the log (oldest dropped). */
+export function startFrameMonitor(Observer = globalThis.PerformanceObserver, max = 20_000) {
+    const log = [];
+    const observers = [];
+    const supported = { loaf: false, longtask: false };
+    const push = (type, list) => {
+        for (const e of list) {
+            const blocking = type === 'loaf' ? (e.blockingDuration ?? 0) : Math.max(0, e.duration - LONG_TASK_MS);
+            log.push({ type, start: e.startTime, duration: e.duration, blocking });
+        }
+        if (log.length > max)
+            log.splice(0, log.length - max);
+    };
+    for (const [type, entryType] of ENTRY_TYPES) {
+        if (!Observer?.supportedEntryTypes?.includes(entryType))
+            continue;
+        try {
+            const observer = new Observer((list) => push(type, list.getEntries()));
+            observer.observe({ type: entryType, buffered: true });
+            observers.push([type, observer]);
+            supported[type] = true;
+        }
+        catch (err) {
+            console.warn(`[load-trace] could not observe ${entryType}; it is reported as unsupported`, err);
+        }
+    }
+    return {
+        supported,
+        entries() {
+            for (const [type, o] of observers)
+                push(type, o.takeRecords());
+            return log;
+        },
+        stop() { for (const [, o] of observers)
+            o.disconnect(); },
+    };
+}
+const emptyStats = () => ({ count: 0, over50: 0, totalMs: 0, blockingMs: 0, longestMs: 0 });
+const round = (ms) => Math.round(ms * 10) / 10;
+/** Summarise the entries that START inside `[start, end)`, attributing each to a span of `spans`. */
+export function summarizeFrames(entries, supported, start, end, spans) {
+    const stats = { loaf: emptyStats(), longtask: emptyStats() };
+    const bySpan = {};
+    const attributeType = supported.loaf ? 'loaf' : 'longtask';
+    const owners = spans.filter((s) => s.thread === 'main' && !s.milestone);
+    for (const e of entries) {
+        if (e.start < start || e.start >= end)
+            continue;
+        const s = stats[e.type];
+        s.count++;
+        if (e.duration > LONG_TASK_MS)
+            s.over50++;
+        s.totalMs += e.duration;
+        s.blockingMs += e.blocking;
+        s.longestMs = Math.max(s.longestMs, e.duration);
+        if (e.type !== attributeType)
+            continue;
+        // Innermost = the latest-starting span still open at the frame's start.
+        let owner;
+        for (const span of owners) {
+            if (span.start <= e.start && (span.end === null || span.end > e.start) && (!owner || span.start >= owner.start))
+                owner = span;
+        }
+        const slot = (bySpan[owner?.name ?? 'load'] ??= { count: 0, blockingMs: 0, durationMs: 0 });
+        slot.count++;
+        slot.blockingMs += e.blocking;
+        slot.durationMs += e.duration;
+    }
+    for (const s of [stats.loaf, stats.longtask]) {
+        s.totalMs = round(s.totalMs);
+        s.blockingMs = round(s.blockingMs);
+        s.longestMs = round(s.longestMs);
+    }
+    for (const slot of Object.values(bySpan)) {
+        slot.blockingMs = round(slot.blockingMs);
+        slot.durationMs = round(slot.durationMs);
+    }
+    return { supported: { ...supported }, ...stats, bySpan };
+}
+//# sourceMappingURL=frames.js.map

package/dist/frames.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { createLoadTracer, NOOP_LOAD_TRACE, type LoadTrace, type LoadTracer, type LoadTracerOptions, } from './load-trace.js';
+export type { PerfSink } from './perf-sink.js';
+export { createWorkerTraceHost, enableWorkerTrace, isTraceSpansMessage, type TraceSpansMessage, type WorkerTraceHost, type WorkerTraceHostOptions, } from './worker.js';
+export { createWorkerPhaseTrace, type WorkerPhaseTrace } from './worker-phases.js';
+export { toChromeTrace, type ChromeTrace, type ChromeTraceEvent } from './chrome-trace.js';
+export { buildSpanTree, type SpanTreeNode } from './tree.js';
+export type { LoadTraceAttributes, LoadTraceSnapshot, TraceAttrs, TraceAttrValue, TraceSpan, WorkerSpan, WorkerTracePayload, } from './types.js';
+export { addCounters, countCopy, createPerfCounters, diffCounters, perfCount, perfCounters, perfTally, type CounterValues, type PerfCounterRegistry, } from './counters.js';
+export { startFrameMonitor, summarizeFrames, type FrameEntry, type FrameEntryType, type FrameMonitor, type FrameStats, type FrameSummary, type ObserverCtor, type SpanFrameStats, } from './frames.js';
+export { accountWorkerMessages, estimateCloneBytes, type CloneEstimate, type MessageEndpoint } from './messages.js';
+export { meterTypedArrayArgs } from './call-meter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,sBAAsB,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEnF,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAE7D,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,cAAc,EACd,SAAS,EACT,UAAU,EACV,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,SAAS,EACT,KAAK,aAAa,EAClB,KAAK,mBAAmB,GACzB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+export { createLoadTracer, NOOP_LOAD_TRACE, } from './load-trace.js';
+export { createWorkerTraceHost, enableWorkerTrace, isTraceSpansMessage, } from './worker.js';
+export { createWorkerPhaseTrace } from './worker-phases.js';
+export { toChromeTrace } from './chrome-trace.js';
+export { buildSpanTree } from './tree.js';
+export { addCounters, countCopy, createPerfCounters, diffCounters, perfCount, perfCounters, perfTally, } from './counters.js';
+export { startFrameMonitor, summarizeFrames, } from './frames.js';
+export { accountWorkerMessages, estimateCloneBytes } from './messages.js';
+export { meterTypedArrayArgs } from './call-meter.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;+DAE+D;AAE/D,OAAO,EACL,gBAAgB,EAChB,eAAe,GAIhB,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,GAIpB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,sBAAsB,EAAyB,MAAM,oBAAoB,CAAC;AAEnF,OAAO,EAAE,aAAa,EAA2C,MAAM,mBAAmB,CAAC;AAC3F,OAAO,EAAE,aAAa,EAAqB,MAAM,WAAW,CAAC;AAY7D,OAAO,EACL,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,SAAS,GAGV,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,EACjB,eAAe,GAQhB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAA4C,MAAM,eAAe,CAAC;AACpH,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/load-trace.d.ts

@@ -0,0 +1,62 @@
+import { type PerfCounterRegistry } from './counters.js';
+import { type FrameMonitor } from './frames.js';
+import { type PerfSink } from './perf-sink.js';
+import type { LoadTraceAttributes, LoadTraceSnapshot, TraceAttrs, WorkerTracePayload } from './types.js';
+/**
+ * One load's trace. Every method is safe to call when tracing is OFF: the
+ * disabled implementation keeps only the start time (so `milestone`/`finish`
+ * still return elapsed ms) and every other call is an empty function, so an
+ * instrumented call site costs one monomorphic no-op call and no allocation.
+ */
+export interface LoadTrace {
+    readonly enabled: boolean;
+    readonly loadId: string;
+    /** Load start on the main `performance.now()` clock. */
+    readonly start: number;
+    setAttrs(attrs: LoadTraceAttributes): void;
+    /** Open a span; returns a token for `end` (`-1` when disabled). */
+    begin(name: string, attrs?: TraceAttrs, parent?: number): number;
+    end(token: number, attrs?: TraceAttrs): void;
+    /** Time `fn`; a returned promise ends the span when it settles. Returns `fn`'s result unchanged. */
+    span<T>(name: string, fn: () => T, attrs?: TraceAttrs, parent?: number): T;
+    /** Record an interval the caller already measured. */
+    record(name: string, start: number, end: number, attrs?: TraceAttrs, parent?: number): void;
+    /**
+     * Mark a milestone `atMs` after the load start (default: now). The span runs
+     * from the load start, so its measure duration IS the time-to-milestone. The
+     * first call per name is recorded; every call returns the elapsed ms.
+     */
+    milestone(name: string, atMs?: number | null): number;
+    /** Fold a worker's spans onto this timeline (clock-aligned via `timeOrigin`). */
+    merge(payload: WorkerTracePayload, parent?: number): void;
+    /** End the load root (first call wins); returns elapsed ms since the start. */
+    finish(attrs?: LoadTraceAttributes): number;
+    snapshot(): LoadTraceSnapshot | null;
+}
+export interface LoadTracerOptions {
+    enabled: boolean;
+    now?: () => number;
+    timeOrigin?: number;
+    /** `null` disables the User Timing mirror (the span tree is still kept). */
+    sink?: PerfSink | null;
+    /** Most recent loads retained; older ones are dropped. Default 16. */
+    maxLoads?: number;
+    /**
+     * Structural counters attributed to each load (#6957). Defaults to the
+     * realm-wide `perfCounters`, which an enabled tracer switches on; `null`
+     * records none.
+     */
+    counters?: PerfCounterRegistry | null;
+    /** Long-frame log summarised per load (#6957); omitted = no `mainThread`. */
+    frames?: FrameMonitor | null;
+}
+export interface LoadTracer {
+    readonly enabled: boolean;
+    startLoad(loadId: string, attrs?: LoadTraceAttributes, start?: number): LoadTrace;
+    snapshots(): LoadTraceSnapshot[];
+    latest(): LoadTraceSnapshot | null;
+}
+export declare function createLoadTracer(options: LoadTracerOptions): LoadTracer;
+/** A disabled trace with no clock of its own, for callers given no trace at all. */
+export declare const NOOP_LOAD_TRACE: LoadTrace;
+//# sourceMappingURL=load-trace.d.ts.map

package/dist/load-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-trace.d.ts","sourceRoot":"","sources":["../src/load-trace.ts"],"names":[],"mappings":"AAIA,OAAO,EAA+D,KAAK,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACtH,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAkC,KAAK,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/E,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EAEV,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAC3C,mEAAmE;IACnE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACjE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7C,oGAAoG;IACpG,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC;IAC3E,sDAAsD;IACtD,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5F;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAAC;IACtD,iFAAiF;IACjF,KAAK,CAAC,OAAO,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1D,+EAA+E;IAC/E,MAAM,CAAC,KAAK,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAAC;IAC5C,QAAQ,IAAI,iBAAiB,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACvB,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACtC,6EAA6E;IAC7E,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,mBAAmB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClF,SAAS,IAAI,iBAAiB,EAAE,CAAC;IACjC,MAAM,IAAI,iBAAiB,GAAG,IAAI,CAAC;CACpC;AAqKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAuBvE;AAED,oFAAoF;AACpF,eAAO,MAAM,eAAe,EAAE,SAAqD,CAAC"}

package/dist/load-trace.js

@@ -0,0 +1,199 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/. */
+import { addCounters, diffCounters, perfCounters } from './counters.js';
+import { summarizeFrames } from './frames.js';
+import { createPerfSink, MEASURE_PREFIX } from './perf-sink.js';
+const defaultNow = () => globalThis.performance?.now() ?? Date.now();
+const defaultTimeOrigin = () => globalThis.performance?.timeOrigin ?? 0;
+class DisabledLoadTrace {
+    loadId;
+    start;
+    now;
+    enabled = false;
+    constructor(loadId, start, now) {
+        this.loadId = loadId;
+        this.start = start;
+        this.now = now;
+    }
+    setAttrs() { }
+    begin() { return -1; }
+    end() { }
+    span(_name, fn) { return fn(); }
+    record() { }
+    milestone(_name, atMs) { return atMs ?? this.now() - this.start; }
+    merge() { }
+    finish() { return this.now() - this.start; }
+    snapshot() { return null; }
+}
+class RecordingLoadTrace {
+    loadId;
+    start;
+    now;
+    timeOrigin;
+    sink;
+    counters;
+    frames;
+    enabled = true;
+    spans = [];
+    milestones = new Set();
+    attrs;
+    end_ = null;
+    counterBase;
+    counterEnd = null;
+    windowEnd = null;
+    workerCounters = {};
+    constructor(loadId, start, attrs, now, timeOrigin, sink, counters = null, frames = null) {
+        this.loadId = loadId;
+        this.start = start;
+        this.now = now;
+        this.timeOrigin = timeOrigin;
+        this.sink = sink;
+        this.counters = counters;
+        this.frames = frames;
+        this.attrs = { ...attrs };
+        this.counterBase = counters?.read() ?? null;
+    }
+    /** A newer load started: freeze this load's counter and frame window. */
+    closeWindow(at) {
+        if (this.windowEnd !== null)
+            return;
+        this.windowEnd = at;
+        this.counterEnd = this.counters?.read() ?? null;
+    }
+    setAttrs(attrs) {
+        Object.assign(this.attrs, attrs);
+    }
+    begin(name, attrs, parent) {
+        return this.push(name, 'main', this.now(), null, attrs, parent);
+    }
+    end(token, attrs) {
+        const span = this.spans[token];
+        if (!span || span.end !== null)
+            return;
+        span.end = this.now();
+        if (attrs)
+            span.attrs = { ...span.attrs, ...attrs };
+        this.emit(span);
+    }
+    span(name, fn, attrs, parent) {
+        const token = this.begin(name, attrs, parent);
+        let result;
+        try {
+            result = fn();
+        }
+        catch (err) {
+            this.end(token, { error: true });
+            throw err;
+        }
+        if (isThenable(result)) {
+            // The derived promise only observes settlement; the caller still owns
+            // (and handles) the original promise returned below.
+            result.then(() => this.end(token), () => this.end(token, { error: true }));
+        }
+        else {
+            this.end(token);
+        }
+        return result;
+    }
+    record(name, start, end, attrs, parent) {
+        this.emit(this.spans[this.push(name, 'main', start, end, attrs, parent)]);
+    }
+    milestone(name, atMs) {
+        const at = atMs ?? this.now() - this.start;
+        if (!this.milestones.has(name)) {
+            this.milestones.add(name);
+            const span = this.spans[this.push(name, 'main', this.start, this.start + at)];
+            span.milestone = true;
+            this.emit(span);
+        }
+        return at;
+    }
+    merge(payload, parent) {
+        if (payload.counters)
+            addCounters(this.workerCounters[payload.thread] ??= {}, payload.counters);
+        const shift = payload.timeOrigin - this.timeOrigin;
+        for (const s of payload.spans) {
+            this.emit(this.spans[this.push(s.name, payload.thread, s.start + shift, s.end + shift, s.attrs, parent)]);
+        }
+    }
+    finish(attrs) {
+        if (this.end_ === null) {
+            this.end_ = this.now();
+            if (attrs)
+                this.setAttrs(attrs);
+            this.sink?.measure(`${MEASURE_PREFIX}load`, this.start, this.end_, { loadId: this.loadId });
+        }
+        return this.end_ - this.start;
+    }
+    snapshot() {
+        return {
+            loadId: this.loadId,
+            attrs: { ...this.attrs },
+            timeOrigin: this.timeOrigin,
+            start: this.start,
+            end: this.end_,
+            spans: this.spans.map((s) => ({ ...s, ...(s.attrs ? { attrs: { ...s.attrs } } : {}) })),
+            ...this.counterSnapshot(),
+            ...(this.frames
+                ? { mainThread: summarizeFrames(this.frames.entries(), this.frames.supported, this.start, this.windowEnd ?? this.now(), this.spans) }
+                : {}),
+        };
+    }
+    counterSnapshot() {
+        if (!this.counters || !this.counterBase)
+            return {};
+        const counters = diffCounters(this.counterEnd ?? this.counters.read(), this.counterBase);
+        const workerCounters = {};
+        for (const [thread, values] of Object.entries(this.workerCounters)) {
+            workerCounters[thread] = { ...values };
+            addCounters(counters, values);
+        }
+        return { counters, workerCounters };
+    }
+    push(name, thread, start, end, attrs, parent) {
+        const id = this.spans.length;
+        const parentId = parent !== undefined && parent >= 0 && parent < id ? parent : null;
+        this.spans.push({ id, name, thread, start, end, parentId, ...(attrs ? { attrs: { ...attrs } } : {}) });
+        return id;
+    }
+    emit(span) {
+        if (span.end === null || !this.sink)
+            return;
+        this.sink.measure(`${MEASURE_PREFIX}${span.name}`, span.start, span.end, {
+            loadId: this.loadId, thread: span.thread, ...span.attrs,
+        });
+    }
+}
+function isThenable(value) {
+    return typeof value === 'object' && value !== null && typeof value.then === 'function';
+}
+export function createLoadTracer(options) {
+    const now = options.now ?? defaultNow;
+    const maxLoads = Math.max(1, options.maxLoads ?? 16);
+    const enabled = options.enabled;
+    const timeOrigin = options.timeOrigin ?? defaultTimeOrigin();
+    const sink = options.sink === undefined ? (enabled ? createPerfSink() : null) : options.sink;
+    const counters = enabled ? (options.counters === undefined ? perfCounters : options.counters) : null;
+    counters?.enable();
+    const frames = enabled ? options.frames ?? null : null;
+    const loads = [];
+    return {
+        enabled,
+        startLoad(loadId, attrs = {}, start = now()) {
+            if (!enabled)
+                return new DisabledLoadTrace(loadId, start, now);
+            loads[loads.length - 1]?.closeWindow(start);
+            const trace = new RecordingLoadTrace(loadId, start, attrs, now, timeOrigin, sink, counters, frames);
+            loads.push(trace);
+            if (loads.length > maxLoads)
+                loads.splice(0, loads.length - maxLoads);
+            return trace;
+        },
+        snapshots: () => loads.map((l) => l.snapshot()),
+        latest: () => loads[loads.length - 1]?.snapshot() ?? null,
+    };
+}
+/** A disabled trace with no clock of its own, for callers given no trace at all. */
+export const NOOP_LOAD_TRACE = new DisabledLoadTrace('noop', 0, () => 0);
+//# sourceMappingURL=load-trace.js.map

package/dist/load-trace.js.map

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

package/dist/messages.d.ts

@@ -0,0 +1,38 @@
+import { type PerfCounterRegistry } from './counters.js';
+/**
+ * Worker message accounting (#6957): the ONE wrapper every loader worker
+ * boundary goes through. It patches the worker's `postMessage` (main -> worker,
+ * `out`) and listens for its messages (worker -> main, `in`), adding per label:
+ *
+ *   msg.<label>.<dir>.count          messages
+ *   msg.<label>.<dir>.cloneBytes     estimated structured-clone payload
+ *   msg.<label>.out.transferBytes    ArrayBuffers in the transfer list (moved, not copied)
+ *   msg.<label>.in.bufferBytes       ArrayBuffers received: the receiver cannot
+ *                                    tell a transferred buffer from a cloned one
+ *   msg.<label>.<dir>.sharedBytes    SharedArrayBuffers (shared, never copied)
+ *
+ * With counters off at wrap time it returns the worker untouched, so the
+ * production path keeps the native `postMessage`. Load-trace control messages
+ * are not counted (they exist only while tracing).
+ */
+export interface MessageEndpoint {
+    postMessage(message: unknown, transfer?: unknown): void;
+    /** Absent on a bare port double: then only the outbound side is counted. */
+    addEventListener?(type: 'message', listener: (event: {
+        data: unknown;
+    }) => void): void;
+}
+export interface CloneEstimate {
+    cloneBytes: number;
+    transferBytes: number;
+    sharedBytes: number;
+}
+/**
+ * Estimate what structured clone serialises for `value`. Typed-array views
+ * count their WHOLE backing buffer once (clone copies the buffer, not the
+ * view's window); strings count one byte per code unit; numbers 8. Iterative,
+ * so a deep payload cannot overflow the stack.
+ */
+export declare function estimateCloneBytes(value: unknown, transferred?: (buffer: ArrayBuffer) => boolean): CloneEstimate;
+export declare function accountWorkerMessages<W extends MessageEndpoint>(worker: W, label: string | (() => string), registry?: PerfCounterRegistry): W;
+//# sourceMappingURL=messages.d.ts.map