@flemo/devtools 0.4.0 → 0.5.0

package/dist/noop.mjs

@@ -1,14 +1,17 @@
 //#region src/anomalies.ts
 var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
-	let n = [], { t0Ms: r, driver: i, frameSamples: a, playerGaps: o, longTasks: s, holdLongTasks: c, landing: l } = e, u = r + (e.releasedAtMs ?? 0);
-	if (o && o.over30Count > 0 && n.push(`player frame gap up to ${o.maxMs}ms ×${o.over30Count} during flight (the rAF player missed frames — convergence jank on this navigation)`), a.released.over30Count > 0) {
+	let n = [], { t0Ms: r, driver: i, frameSamples: a, longTasks: o, holdLongTasks: s, landing: c } = e, l = r + (e.releasedAtMs ?? 0);
+	if (a.released.over30Count > 0) {
 		let e = i === "compiled" ? " (compiled/compositor flights can still present cleanly through main-thread gaps)" : "";
 		n.push(`main-thread rAF gap up to ${a.released.maxGapMs}ms ×${a.released.over30Count} during visible motion${e}`);
 	}
-	for (let e of s) e.startMs <= u + 120 && e.startMs + e.durationMs >= u - 50 ? n.push(`long task ${Math.round(e.durationMs)}ms overlapped the visible-motion start (opening-swallow risk: the first presented frames of the transition may have been lost)`) : e.durationMs >= 100 && n.push(`long task ${Math.round(e.durationMs)}ms mid-flight`);
-	for (let e of c) e.durationMs >= 100 && n.push(`long task ${Math.round(e.durationMs)}ms absorbed by the hold (screen posed, not yet moving — the hold doing its job, not user-visible jank)`);
-	let { motion: d, images: f } = e;
-	return d.holdReassertedAtMs !== null && n.push(`hold re-asserted ${d.holdReassertedAtMs}ms into the flight, after it had already released (an interleaved commit wrote the stale paused hold attribute over a running flight — the flemo 2026-08-18 release-race signature; the motion pauses while every timing metric stays clean)`), d.pausedAfterRelease && n.push("compiled animation reported playState=paused after its release (the flight was posed and then stopped mid-motion, not merely starved of frames)"), d.longestStallMs >= 48 && n.push(`motion stalled ${d.longestStallMs}ms mid-flight (${d.stalledFrames}/${d.sampledFrames} released frames advanced neither the animation clock nor the pose — freeze, or freeze-then-leap if the flight still landed on time)`), d.sampledFrames === 0 && e.releasedAtMs !== null && n.push("no released frames were sampled (the flight ended at or before its own hold release — the visible motion, if any, was never observed)"), f.completedUnheld > 0 && n.push(`${f.completedUnheld} image(s) finished loading mid-flight without a hold (${f.completedDuringFlight} completed, ${f.heldDuringFlight} held; ${f.loadingAtStart} were loading at t0, ${f.addedDuringFlight} arrived mid-flight) — each decode rasters on the moving layer and costs a present; this is the warm-side image-hold regression`), l.orphanedHolds.length > 0 && n.push(`hold markers left on the page at rest: ${l.orphanedHolds.join("; ")} (whatever they hide has no owner left to reveal it — the permanently-blank-avatar class)`), l.residualInlineTransforms.length > 0 && n.push(`residual inline style after COMPLETED: ${l.residualInlineTransforms.join("; ")} (landing cleanup failure — the landed scope belongs to the compiled rest rules)`), l.offViewportAtRest && n.push("screen resting at from-pose while COMPLETED+active (blank-viewport signature — the flemo PR #259 class: a residual pose left the landed screen parked off-viewport)"), l.stuckStatuses.length > 0 && n.push(`transitional status stuck >${t / 1e3}s: ${l.stuckStatuses.join(", ")} (navigation queue lock or missed animationend — later navigations will be swallowed)`), i === "unknown" && n.push("driver could not be classified (no running flemo-* CSSAnimation and no player inline-style signature observed — zero-duration flight, or the sampler attached after motion ended)"), n;
+	for (let e of o) e.startMs <= l + 120 && e.startMs + e.durationMs >= l - 50 ? n.push(`long task ${Math.round(e.durationMs)}ms overlapped the visible-motion start (opening-swallow risk: the first presented frames of the transition may have been lost)`) : e.durationMs >= 100 && n.push(`long task ${Math.round(e.durationMs)}ms mid-flight`);
+	for (let e of s) e.durationMs >= 100 && n.push(`long task ${Math.round(e.durationMs)}ms absorbed by the hold (screen posed, not yet moving — the hold doing its job, not user-visible jank)`);
+	let { motion: u, images: d } = e;
+	u.holdReassertedAtMs !== null && n.push(`hold re-asserted ${u.holdReassertedAtMs}ms into the flight, after it had already released (an interleaved commit wrote the stale paused hold attribute over a running flight — the flemo 2026-08-18 release-race signature; the motion pauses while every timing metric stays clean)`), u.pausedAfterRelease && n.push("compiled animation reported playState=paused after its release (the flight was posed and then stopped mid-motion, not merely starved of frames)"), u.longestStallMs >= 48 && n.push(`motion stalled ${u.longestStallMs}ms mid-flight (${u.stalledFrames}/${u.sampledFrames} released frames advanced neither the animation clock nor the pose — freeze, or freeze-then-leap if the flight still landed on time)`), u.sampledFrames === 0 && e.releasedAtMs !== null && n.push("no released frames were sampled (the flight ended at or before its own hold release — the visible motion, if any, was never observed)"), d.completedUnheld > 0 && n.push(`${d.completedUnheld} image(s) finished loading mid-flight without a hold (${d.completedDuringFlight} completed, ${d.heldDuringFlight} held; ${d.loadingAtStart} were loading at t0, ${d.addedDuringFlight} arrived mid-flight) — each decode rasters on the moving layer and costs a present; this is the warm-side image-hold regression`), c.orphanedHolds.length > 0 && n.push(`hold markers left on the page at rest: ${c.orphanedHolds.join("; ")} (whatever they hide has no owner left to reveal it — the permanently-blank-avatar class)`), c.residualInlineTransforms.length > 0 && n.push(`residual inline style after COMPLETED: ${c.residualInlineTransforms.join("; ")} (landing cleanup failure — the landed scope belongs to the compiled rest rules)`), c.offViewportAtRest && n.push("screen resting at from-pose while COMPLETED+active (blank-viewport signature — the flemo PR #259 class: a residual pose left the landed screen parked off-viewport)"), c.stuckStatuses.length > 0 && n.push(`transitional status stuck >${t / 1e3}s: ${c.stuckStatuses.join(", ")} (navigation queue lock or missed animationend — later navigations will be swallowed)`);
+	let { morphs: f, tripwires: p } = e;
+	for (let e of p) n.push(`tripwire ${e.kind} at +${e.atMs}ms: ${e.detail}`);
+	return f.skipped.length > 0 && n.push(`shared element(s) did not fly: ${f.skipped.join(", ")} (${f.pairable.length} pairable key(s), ${f.flew.length} flew) — both ends were registered on two different screens and neither was stamped with a flight role, so the pair was never made`), f.duplicatedKeys.length > 0 && n.push(`pairing key(s) used twice inside one screen: ${f.duplicatedKeys.join(", ")} (two ends under one screen are not a pair, so one of them can never fly — this is in the consuming app)`), f.strandedRoles > 0 && n.push(`${f.strandedRoles} morph element(s) still carry a flight role at rest (the stranded participant class: a role that outlives its flight stays in the layer and poisons the NEXT pairing, which is how one interrupted gesture turned into every later pop losing its camera)`), (f.strandedStandIns > 0 || f.strandedGhosts > 0 || f.layerResidue > 0) && n.push(`morph residue at rest: ${f.strandedStandIns} stand-in(s), ${f.strandedGhosts} ghost(s), ${f.layerResidue} element(s) left in a flight layer (a stand-in is a hole in the layout and a layer element is a corpse the next flight will pair against)`), f.leakedSheetRules > 0 && n.push(`${f.leakedSheetRules} morph keyframe rule(s) were left in the per-flight sheet (a flight that never landed keeps its keyframes; they accumulate for the life of the page)`), i === "unknown" && n.push("driver could not be classified (no running flemo-* CSSAnimation and no player inline-style signature observed — zero-duration flight, or the sampler attached after motion ended)"), n;
 }, s = (e) => {
 	let n = [];
 	if (e.emulationSuspected) {
@@ -21,24 +24,48 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 	"Display-hardware effects: local dimming, backlight modulation, and panel overdrive alter perceived motion and are invisible to every web API.",
 	"Compositor-internal present skips: a frame can be produced on time (clean rAF, clean player gaps) yet dropped or delayed inside the compositor's present queue; only platform tools (about:tracing, Instruments) see that layer.",
 	"DevTools device emulation composites the page to a rescaled surface: every in-page instrument reads the pre-scale surface and reports clean while the eye watches the post-scale one, so emulated sessions grow shimmer/flash artifacts that do not exist in a plain window or on a real device."
-], l = () => {
+], l = (e) => {
+	/* v8 ignore next -- unreachable: a group exists only because a flight was
+	put in it, so nothing ever asks for the median of nothing. */
+	if (e.length === 0) return 0;
+	let t = [...e].sort((e, t) => e - t);
+	return Math.round(t[Math.floor(t.length / 2)] * 10) / 10;
+}, u = (e) => {
+	let t = e.filter((e) => typeof e.bucket == "string");
+	if (t.length === 0) return [];
+	let n = /* @__PURE__ */ new Map();
+	for (let e of t) {
+		let t = e.bucket, r = n.get(t);
+		r ? r.push(e) : n.set(t, [e]);
+	}
+	return [...n.entries()].map(([e, t]) => ({
+		bucket: e,
+		flights: t.length,
+		medianDurationMs: l(t.map((e) => e.durationMs)),
+		medianReleasedGapMs: l(t.map((e) => e.frameSamples.released.medianGapMs)),
+		worstReleasedGapMs: t.reduce((e, t) => Math.max(e, t.frameSamples.released.maxGapMs), 0),
+		longGapCount: t.reduce((e, t) => e + t.frameSamples.released.over30Count, 0),
+		anomalyCount: t.reduce((e, t) => e + t.anomalies.length, 0),
+		stalledFlights: t.filter((e) => e.motion.stalledFrames > 0).length
+	})).sort((e, t) => e.bucket.localeCompare(t.bucket));
+}, d = () => {
 	if (typeof navigator > "u") return null;
 	let e = navigator.userAgentData;
 	return !e || !Array.isArray(e.brands) ? null : e.brands.map((e) => ({
 		brand: String(e.brand ?? ""),
 		version: String(e.version ?? "")
 	}));
-}, u = () => {
+}, f = () => {
 	if (typeof navigator > "u") return "unknown";
-	let e = l();
+	let e = d();
 	if (e?.some((e) => /Chromium/i.test(e.brand))) return "blink";
 	let t = navigator.userAgent ?? "";
 	return /Firefox|FxiOS/i.test(t) ? "gecko" : e || /AppleWebKit/i.test(t) && !/Chrome|Chromium|Android/i.test(t) ? "webkit" : /Android/i.test(t) ? "blink" : "unknown";
-}, d = () => {
-	if (typeof navigator > "u" || u() !== "blink") return !1;
+}, p = () => {
+	if (typeof navigator > "u" || f() !== "blink") return !1;
 	let e = navigator.platform ?? "";
 	return /Mac|Win|Linux/i.test(e) ? /Android/i.test(navigator.userAgent ?? "") && !/Mac|Win/i.test(e) ? /Linux (x86_64|i686)/i.test(e) : (navigator.maxTouchPoints ?? 0) > 0 : !1;
-}, f = (e = 20) => new Promise((t) => {
+}, m = (e = 20) => new Promise((t) => {
 	let n = Number.isFinite(e) ? Math.max(1, Math.floor(e)) : 20;
 	if (typeof requestAnimationFrame != "function" || typeof performance > "u") {
 		t({
@@ -60,45 +87,68 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 		requestAnimationFrame(a);
 	};
 	requestAnimationFrame(a);
-}), p = () => {
+}), h = [
+	"__vite_plugin_react_preamble_installed__",
+	"__vite__",
+	"__NEXT_HMR_CB",
+	"__NEXT_HMR_LATENCY_CB",
+	"__webpack_hot_middleware_reporter__",
+	"webpackHotUpdate",
+	"__REACT_REFRESH_RUNTIME__",
+	"$RefreshReg$"
+], g = () => {
+	if (typeof window > "u") return [];
+	let e = [];
+	for (let t of h) try {
+		window[t] !== void 0 && e.push(t);
+	} catch {}
+	return e;
+}, _ = () => {
 	try {
 		return typeof PerformanceObserver < "u" && Array.isArray(PerformanceObserver.supportedEntryTypes) && PerformanceObserver.supportedEntryTypes.includes("longtask");
 	} catch {
 		return !1;
 	}
-}, m = (e) => {
-	let t = typeof navigator < "u" ? navigator : null, n = typeof window < "u" ? window : null, r = !1;
+}, v = (e, t = !1) => {
+	let n = typeof navigator < "u" ? navigator : null, r = typeof window < "u" ? window : null, i = !1;
 	try {
-		r = n?.matchMedia?.("(prefers-reduced-motion: reduce)").matches ?? !1;
+		i = r?.matchMedia?.("(prefers-reduced-motion: reduce)").matches ?? !1;
 	} catch {
-		r = !1;
+		i = !1;
 	}
 	return {
-		userAgent: t?.userAgent ?? "",
-		uaBrands: l(),
-		engine: u(),
-		platform: t?.platform ?? "",
-		maxTouchPoints: t?.maxTouchPoints ?? 0,
-		devicePixelRatio: n?.devicePixelRatio ?? 1,
+		userAgent: n?.userAgent ?? "",
+		uaBrands: d(),
+		engine: f(),
+		platform: n?.platform ?? "",
+		maxTouchPoints: n?.maxTouchPoints ?? 0,
+		devicePixelRatio: r?.devicePixelRatio ?? 1,
+		hardwareConcurrency: n?.hardwareConcurrency ?? 0,
 		screen: {
-			width: n?.screen?.width ?? 0,
-			height: n?.screen?.height ?? 0
+			width: r?.screen?.width ?? 0,
+			height: r?.screen?.height ?? 0
 		},
 		viewport: {
-			width: n?.innerWidth ?? 0,
-			height: n?.innerHeight ?? 0
+			width: r?.innerWidth ?? 0,
+			height: r?.innerHeight ?? 0
 		},
-		visualViewportScale: n?.visualViewport?.scale ?? null,
+		visualViewportScale: r?.visualViewport?.scale ?? null,
 		rafCadence: e,
-		reducedMotion: r,
-		emulationSuspected: d(),
+		reducedMotion: i,
+		developmentHints: g(),
+		emulationSuspected: p(),
 		observation: {
-			longTasks: p(),
+			longTasks: _(),
 			elementAnimations: typeof Element < "u" && typeof Element.prototype.getAnimations == "function",
-			playerGapMirror: Array.isArray(n?.__flemoPlayerGaps)
+			animationEvents: t
 		}
 	};
-}, h = "flemo:devtools-panel-height", g = [{
+}, y = [
+	"DevTools must be CLOSED while judging motion. An open inspector serializes requests and repaints its own panels on the same machine; the 2026-08 campaign's entire residual 'stutter' was this, and it is invisible to every in-page metric.",
+	"No screen recording or display capture while judging. A capture client forces WindowServer to composite every vsync, which SUPPRESSES the symptom — a capture that looks smooth proves nothing about the uncaptured session.",
+	"Judge with real input (a finger, a mouse). Synthetic dispatch — evaluate().click() and friends — never fires pointerdown, so it bypasses the swipe/gesture machinery that a real navigation goes through.",
+	"Establish the viewing configuration before believing any verdict: device emulation off, which physical display, its refresh rate and HiDPI scaling, Low Power Mode. Ask for a photo of the setup if it is not certain."
+], b = "flemo:devtools-panel-height", x = [{
 	key: "flemo:devtools",
 	storage: "session",
 	kind: "opt-in-diagnostic",
@@ -106,13 +156,13 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 	fallback: "off",
 	effect: "arms this flight recorder in the playground (?devtools=on)"
 }, {
-	key: h,
+	key: b,
 	storage: "session",
 	kind: "production-state",
 	values: "a pixel height",
 	fallback: "(the panel's default height)",
 	effect: "the drawer height this panel was last dragged to"
-}], _ = [], v = [..._, ...g], y = [
+}], S = [], C = [...S, ...x], w = [
 	{
 		key: "flemo:sixty",
 		storage: "session",
@@ -233,45 +283,237 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 		storage: "session",
 		retiredWith: "the Low Power Mode release-latency probe (2026-08-22)"
 	}
-], b = "(retired — the library no longer reads this)", x = (e) => {
+], T = "(retired — the library no longer reads this)", E = (e) => {
 	try {
 		let t = e === "session" ? sessionStorage : localStorage;
 		return t.length, t;
 	} catch {
 		return null;
 	}
-}, S = (e, t) => {
+}, D = (e, t) => {
 	try {
 		return e ? e.getItem(t) : null;
 	} catch {
 		return null;
 	}
-}, C = new Set(v.map((e) => e.key)), w = new Set(y.map((e) => e.key)), T = () => {
-	let e = {}, t = x("session"), n = x("local");
-	for (let r of v) {
-		let i = S(r.storage === "session" ? t : n, r.key);
+}, ee = new Set(C.map((e) => e.key)), te = new Set(w.map((e) => e.key)), ne = () => {
+	let e = {}, t = E("session"), n = E("local");
+	for (let r of C) {
+		let i = D(r.storage === "session" ? t : n, r.key);
 		i !== null && (e[r.key] = i);
 	}
-	for (let r of y) for (let [i, a] of [[t, "sessionStorage"], [n, "localStorage"]]) {
-		let t = S(i, r.key);
-		t !== null && (e[`${r.key} (${a}) ${b}`] = t);
+	for (let r of w) for (let [i, a] of [[t, "sessionStorage"], [n, "localStorage"]]) {
+		let t = D(i, r.key);
+		t !== null && (e[`${r.key} (${a}) ${T}`] = t);
 	}
 	for (let [r, i] of [[t, "sessionStorage"], [n, "localStorage"]]) if (r) try {
 		for (let t = 0; t < r.length; t += 1) {
 			let n = r.key(t);
-			!n || !n.startsWith("flemo:") || C.has(n) || w.has(n) || (e[`${n} (${i}, unknown key)`] = r.getItem(n) ?? "");
+			!n || !n.startsWith("flemo:") || ee.has(n) || te.has(n) || (e[`${n} (${i}, unknown key)`] = r.getItem(n) ?? "");
 		}
 	} catch {}
 	return e;
-}, E = (e) => {
+}, O = (e) => {
 	let t = [];
 	for (let [n, r] of Object.entries(e)) if (n.includes("(retired — the library no longer reads this)")) {
-		let e = n.slice(0, n.indexOf(" (")), i = y.find((t) => t.key === e);
+		let e = n.slice(0, n.indexOf(" (")), i = w.find((t) => t.key === e);
 		t.push(`${n}=${r} — RETIRED residue: this key went with ${i?.retiredWith ?? "a removed feature"}. The library never reads it, so it cannot explain anything you are seeing. Safe to delete; it is listed only so it does not read as an unexplained lead.`);
 		continue;
 	}
 	return t;
-}, D = (e) => Math.round(e * 10) / 10, O = (e) => {
+}, k = "flemo:devtools-trace", A = 10, j = 64e3, M = () => {
+	try {
+		let e = sessionStorage;
+		return e.length, e;
+	} catch {
+		return null;
+	}
+}, N = (e, t) => {
+	let n = M();
+	if (!n) return;
+	let r = e.slice(-10);
+	for (; r.length > 0;) {
+		let e = JSON.stringify({
+			version: t,
+			savedAt: (/* @__PURE__ */ new Date()).toISOString(),
+			flights: r
+		});
+		if (e.length <= 64e3) {
+			try {
+				n.setItem(k, e);
+			} catch {}
+			return;
+		}
+		r = r.slice(1);
+	}
+	P();
+}, P = () => {
+	try {
+		M()?.removeItem(k);
+	} catch {}
+}, F = (e) => {
+	let t = M();
+	if (!t) return null;
+	let n = null;
+	try {
+		n = t.getItem(k);
+	} catch {
+		return null;
+	}
+	if (n === null) return null;
+	let r = null;
+	try {
+		r = JSON.parse(n);
+	} catch {
+		return P(), null;
+	}
+	return !r || r.version !== e || !Array.isArray(r.flights) ? (P(), null) : {
+		savedAt: typeof r.savedAt == "string" ? r.savedAt : "",
+		flights: r.flights,
+		note: "These flights were recorded by the page instance BEFORE the last full load. They are kept apart from the live ones because they may have come from a different build."
+	};
+}, I = 12, L = 20, R = 40, z = 500, B = 200, V = (e) => {
+	let t = e.rafCadence.medianGapMs;
+	if (t === null) return {
+		id: "display-cadence",
+		status: "unknown",
+		detail: "the idle frame cadence could not be sampled, so the display's rate is unknown"
+	};
+	let n = { medianIdleFrameMs: t };
+	return t < I ? {
+		id: "display-cadence",
+		status: "ok",
+		detail: `idle frames arrive every ${t}ms — a display above 60Hz. Frame budgets in this report are still quoted against 60Hz (a gap of 30ms or more)`,
+		metrics: n
+	} : t <= L ? {
+		id: "display-cadence",
+		status: "ok",
+		detail: `idle frames arrive every ${t}ms — a 60Hz clock`,
+		metrics: n
+	} : t <= R ? {
+		id: "display-cadence",
+		status: "violated",
+		detail: `idle frames arrive every ${t}ms — the page is being served roughly HALF rate. On iOS this is Low Power Mode, whose main-thread ceiling is ~30Hz while the compositor keeps 60: motion judged here is judged against a clock no transition can beat, and the ceiling is not a library defect. Turn it off, or judge elsewhere`,
+		metrics: n
+	} : {
+		id: "display-cadence",
+		status: "violated",
+		detail: `idle frames arrive every ${t}ms — the page is barely being served frames at all while idle. Something outside the transition owns this machine; no motion verdict taken here means anything`,
+		metrics: n
+	};
+}, H = (e) => {
+	if (!e.environment.observation.longTasks) return {
+		id: "machine-idle",
+		status: "unknown",
+		detail: "this browser does not report long tasks, so the recorder cannot tell whether anything else was competing for the main thread"
+	};
+	let t = e.idleLongTasks.length, n = Math.round(e.idleLongTasks.reduce((e, t) => e + t.durationMs, 0)), r = Math.round(e.idleLongTasks.reduce((e, t) => Math.max(e, t.durationMs), 0)), i = {
+		idleLongTasks: t,
+		idleLongTaskMs: n,
+		worstIdleTaskMs: r
+	};
+	return n >= z || r >= B ? {
+		id: "machine-idle",
+		status: "violated",
+		detail: `${t} long task(s) totalling ${n}ms ran while NO navigation was in flight (worst ${r}ms). Something else on this page or this machine was busy, and a motion verdict taken under someone else's load measures the load. A whole tremble campaign was invalidated by exactly this, with a build running in another window`,
+		metrics: i
+	} : {
+		id: "machine-idle",
+		status: "ok",
+		detail: `${t} idle long task(s), ${n}ms total — the page was quiet between navigations`,
+		metrics: i
+	};
+}, U = (e) => {
+	let { trusted: t, synthetic: n, pointerTypes: r } = e.input;
+	return n > 0 ? {
+		id: "real-input",
+		status: "violated",
+		detail: `${n} script-dispatched (untrusted) input event(s) drove this session. Synthetic dispatch never fires the gesture machinery a real navigation goes through, so a clean run proves nothing about a finger`,
+		metrics: {
+			trusted: t,
+			synthetic: n
+		}
+	} : t === 0 ? {
+		id: "real-input",
+		status: "unknown",
+		detail: "no input event preceded any recorded flight. These navigations were driven programmatically or by the browser's own back/forward, which is a different path from the one a user takes",
+		metrics: {
+			trusted: t,
+			synthetic: n
+		}
+	} : {
+		id: "real-input",
+		status: "ok",
+		detail: `${t} trusted input event(s) drove this session (${r.join(", ") || "type unreported"})`,
+		metrics: {
+			trusted: t,
+			synthetic: n
+		}
+	};
+}, re = (e) => e.input.pointerTypes.includes("touch") ? {
+	id: "touch-path",
+	status: "ok",
+	detail: "at least one navigation was driven by touch"
+} : e.environment.maxTouchPoints === 0 ? {
+	id: "touch-path",
+	status: "unknown",
+	detail: "this device reports no touch points, so there is no touch path to exercise here"
+} : {
+	id: "touch-path",
+	status: "unknown",
+	detail: "no touch-driven navigation was recorded on a touch-capable device. The swipe and pointer-capture paths are only reached by a finger; a build that had broken them outright once passed every automated layer green because every probe used a mouse"
+}, W = [
+	{
+		id: "devtools-closed",
+		status: "unknown",
+		detail: "whether an inspector is open cannot be seen from inside the page. An open one serializes requests and repaints its own panels on the same machine; a whole campaign's residual stutter was this and nothing else. Confirm it with the user"
+	},
+	{
+		id: "no-screen-capture",
+		status: "unknown",
+		detail: "whether the screen is being captured cannot be seen from inside the page. A capture client forces the compositor to present every vsync, which SUPPRESSES the symptom — a recording that looks smooth proves nothing about the uncaptured session"
+	},
+	{
+		id: "viewing-configuration",
+		status: "unknown",
+		detail: "which physical display this window is on, its refresh rate and scaling, cannot be read from the page. Establish it with the user before believing any verdict"
+	}
+], G = (e) => {
+	let { environment: t } = e, n = [];
+	return n.push(t.emulationSuspected ? {
+		id: "device-emulation",
+		status: "violated",
+		detail: "DevTools device emulation is suspected (Blink on a desktop platform reporting touch points). Emulation composites the page to a rescaled surface: every in-page instrument reads the pre-scale surface and reports clean while the eye watches the post-scale one" + (/Win/i.test(t.platform) ? ". Windows touch hardware makes this signal ambiguous — confirm the device toolbar state" : "")
+	} : {
+		id: "device-emulation",
+		status: "ok",
+		detail: "no device-emulation signature on this session"
+	}), n.push(V(t)), n.push(e.documentHidden || e.wentHidden ? {
+		id: "page-foreground",
+		status: "violated",
+		detail: e.documentHidden ? "this document is HIDDEN right now — a backgrounded page is throttled to a fraction of its frames" : "this document was hidden at least once while recording; any flight that ran then was throttled"
+	} : {
+		id: "page-foreground",
+		status: "ok",
+		detail: "the document stayed visible throughout"
+	}), n.push(H(e)), n.push(t.developmentHints.length > 0 ? {
+		id: "build-mode",
+		status: "violated",
+		detail: `development-server globals are present (${t.developmentHints.join(", ")}). A development build is a different program: unminified, double-invoking, and hot-reload instrumented. A day of ladder measurements once turned out to be measuring the build itself`
+	} : {
+		id: "build-mode",
+		status: "unknown",
+		detail: "no development-server global was found. That is consistent with a production build but does not prove one — confirm how this page was built"
+	}), n.push(U(e)), n.push(re(e)), n.push(t.reducedMotion ? {
+		id: "reduced-motion",
+		status: "violated",
+		detail: "this session prefers reduced motion, so the transitions under test are being suppressed or shortened. Whatever is on screen is not the motion being judged"
+	} : {
+		id: "reduced-motion",
+		status: "ok",
+		detail: "reduced motion is not requested"
+	}), [...n, ...W];
+}, K = (e) => Math.round(e * 10) / 10, q = (e) => {
 	if (e.length === 0) return {
 		count: 0,
 		medianGapMs: 0,
@@ -281,11 +523,11 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 	let t = [...e].sort((e, t) => e - t);
 	return {
 		count: e.length,
-		medianGapMs: D(t[Math.floor(t.length / 2)]),
-		maxGapMs: D(t[t.length - 1]),
+		medianGapMs: K(t[Math.floor(t.length / 2)]),
+		maxGapMs: K(t[t.length - 1]),
 		over30Count: e.filter((e) => e >= 30).length
 	};
-}, k = (e, t = []) => {
+}, J = (e, t = []) => {
 	let n = [...e, ...t];
 	return {
 		...n.length === 0 ? {
@@ -296,21 +538,18 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 			let e = [...n].sort((e, t) => e - t);
 			return {
 				count: n.length,
-				medianGapMs: D(e[Math.floor(e.length / 2)]),
-				maxGapMs: D(e[e.length - 1])
+				medianGapMs: K(e[Math.floor(e.length / 2)]),
+				maxGapMs: K(e[e.length - 1])
 			};
 		})(),
-		longGaps: n.filter((e) => e >= 30).map(D),
-		held: O(e),
-		released: O(t)
+		longGaps: n.filter((e) => e >= 30).map(K),
+		held: q(e),
+		released: q(t)
 	};
-}, A = (e) => e.length === 0 ? null : {
-	maxMs: D(Math.max(...e)),
-	over30Count: e.filter((e) => e >= 30).length
-}, j = (e) => {
-	let t = e.playerSuppression || e.playerAdvance;
-	return t && e.compiledAnimation ? "mixed" : t ? "player" : e.compiledAnimation ? "compiled" : "unknown";
-}, M = (e) => e === "PUSHING" ? "PUSH" : e === "POPPING" ? "POP" : e === "REPLACING" ? "REPLACE" : null, N = (e) => {
+}, Y = (e) => {
+	let t = e.inlineSuppression || e.inlineAdvance;
+	return t && e.compiledAnimation ? "mixed" : t ? "inline" : e.compiledAnimation ? "compiled" : "unknown";
+}, X = (e) => e === "PUSHING" ? "PUSH" : e === "POPPING" ? "POP" : e === "REPLACING" ? "REPLACE" : null, ie = (e) => {
 	let t = /^matrix3d\(([^)]+)\)$/.exec(e.trim());
 	if (t) {
 		let e = t[1].split(",").map((e) => Number(e.trim()));
@@ -322,9 +561,37 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 		return e.length === 6 && Number.isFinite(e[4]) ? e[4] : null;
 	}
 	return null;
-}, P = "2", F = "@flemo/devtools resolved to its production entry: nothing was recorded. Run a development build to collect a real report.", I = () => {}, L = () => ({
+}, ae = (e) => {
+	/* v8 ignore next -- unreachable: deriveVerdict returns before this on an
+	empty flight list, so nothing ever asks for the median of nothing. */
+	if (e.length === 0) return 0;
+	let t = [...e].sort((e, t) => e - t);
+	return t[Math.floor(t.length / 2)];
+}, oe = (e) => {
+	let t = [], n = e.preconditions.filter((e) => e.status === "violated");
+	if (n.length > 0 && t.push(`NOT EVIDENCE: ${n.length} judging precondition(s) failed — ${n.map((e) => e.id).join(", ")}. Everything below was measured under those conditions; fix them and measure again before drawing a conclusion from it.`), e.flights.length === 0) return t.push("No flights were recorded. Either no navigation happened while the recorder was attached, or it attached after the one you meant to measure — the recorder only sees flights that start after it does."), t;
+	e.observation.animationEvents || t.push("The animation channel observed NOTHING across this whole session: not one flemo keyframe reported a start, an end or a cancel, though flights were recorded. Treat every animation-derived field here as unmeasured rather than as clean — a probe that never fires reads exactly like a page with nothing to report.");
+	let r = e.flights, i = r.reduce((e, t) => Math.max(e, t.frameSamples.released.maxGapMs), 0), a = r.filter((e) => e.anomalies.length > 0).length;
+	t.push(`${r.length} flight(s) recorded. Median duration ${ae(r.map((e) => e.durationMs))}ms, worst frame gap during visible motion ${i}ms, ${a} flight(s) carrying at least one anomaly.`);
+	let o = r.filter((e) => e.motion.longestStallMs >= 48);
+	o.length > 0 && t.push(`${o.length} flight(s) STOPPED MOVING mid-flight (longest ${Math.max(...o.map((e) => e.motion.longestStallMs))}ms). Frames kept arriving; the picture did not change. Look at the hold and the animation's play state, not at the frame budget.`);
+	let s = r.filter((e) => e.morphs.skipped.length > 0);
+	if (s.length > 0) {
+		let e = [...new Set(s.flatMap((e) => e.morphs.skipped))];
+		t.push(`Shared elements did NOT fly on ${s.length} flight(s): ${e.join(", ")}. Both ends were registered on two different screens and neither was ever stamped with a flight role, so the pair was never made. This is silent by nature — nothing else on the page says it happened.`);
+	}
+	let c = [...new Set(r.flatMap((e) => e.morphs.duplicatedKeys))];
+	c.length > 0 && t.push(`Pairing key(s) used twice inside one screen: ${c.join(", ")}. Two ends under one screen are not a pair, so one of them can never fly. This is in the consuming app, not in the library.`);
+	let l = r.flatMap((e) => e.tripwires);
+	if (l.length > 0) {
+		let e = [...new Set(l.map((e) => e.kind))];
+		t.push(`${l.length} tripwire hit(s) across the session (${e.join(", ")}). These are one-frame events reported by the browser itself, not sampled — read the flights' \`tripwires\` arrays for the exact animations.`);
+	}
+	return r.filter((e) => e.frameSamples.released.over30Count > 0).length === 0 && a === 0 && n.length === 0 && t.push("No flight dropped a frame during visible motion (nothing at or over 30ms) and no anomaly fired. Under the preconditions above, this session is clean — what remains is in `blindSpots`, and none of it is reachable from page code."), t;
+}, se = "3", Z = "@flemo/devtools resolved to its production entry: nothing was recorded. Run a development build to collect a real report.", Q = () => {}, ce = () => ({
 	generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
 	version: "inert",
+	verdict: [Z],
 	environment: {
 		userAgent: "",
 		uaBrands: null,
@@ -345,25 +612,31 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 			medianGapMs: null,
 			sampleCount: 0
 		},
+		hardwareConcurrency: 0,
 		reducedMotion: !1,
+		developmentHints: [],
 		emulationSuspected: !1,
 		observation: {
 			longTasks: !1,
 			elementAnimations: !1,
-			playerGapMirror: !1
+			animationEvents: !1
 		}
 	},
+	preconditions: [],
 	overrides: {
 		active: {},
-		warnings: [F]
+		warnings: [Z]
 	},
 	flights: [],
-	anomalies: [F],
+	comparison: [],
+	previousSession: null,
+	anomalies: [Z],
 	blindSpots: [],
-	judgingProtocol: [F]
-}), R = (e) => ({
-	detach: I,
-	report: L
-}), z = (e) => ({ detach: I });
+	judgingProtocol: [Z]
+}), le = (e) => ({
+	detach: Q,
+	report: ce,
+	mark: () => null
+}), $ = (e) => ({ detach: Q }), ue = (e) => ({ detach: Q });
 //#endregion
-export { c as BLIND_SPOTS, _ as CORE_FLAGS, g as DEVTOOLS_OWNED_FLAGS, v as FLAG_REGISTRY, e as LONG_GAP_MS, i as MID_FLIGHT_TASK_MS, n as OPENING_WINDOW_LEAD_MS, r as OPENING_WINDOW_TAIL_MS, h as PANEL_HEIGHT_KEY, P as REPORT_SCHEMA_VERSION, y as RETIRED_FLAGS, b as RETIRED_MARKER, a as STALL_MS, t as STUCK_STATUS_MS, z as attachDevtoolsPanel, R as attachFlightRecorder, m as captureEnvironment, j as classifyDriver, k as computeFrameStats, O as computePhaseStats, A as computePlayerGapStats, o as deriveFlightAnomalies, E as deriveOverrideWarnings, s as deriveReportAnomalies, u as detectEngine, d as isEmulationSuspected, M as kindFromStatus, N as parseTranslateX, f as sampleRafCadence, T as snapshotOverrides };
+export { c as BLIND_SPOTS, S as CORE_FLAGS, x as DEVTOOLS_OWNED_FLAGS, C as FLAG_REGISTRY, y as JUDGING_PROTOCOL, e as LONG_GAP_MS, j as MAX_PERSISTED_BYTES, A as MAX_PERSISTED_FLIGHTS, i as MID_FLIGHT_TASK_MS, n as OPENING_WINDOW_LEAD_MS, r as OPENING_WINDOW_TAIL_MS, b as PANEL_HEIGHT_KEY, se as REPORT_SCHEMA_VERSION, w as RETIRED_FLAGS, T as RETIRED_MARKER, a as STALL_MS, t as STUCK_STATUS_MS, k as TRACE_KEY, ue as attachDevtoolsHud, $ as attachDevtoolsPanel, le as attachFlightRecorder, v as captureEnvironment, Y as classifyDriver, P as clearTrace, J as computeFrameStats, q as computePhaseStats, o as deriveFlightAnomalies, O as deriveOverrideWarnings, G as derivePreconditions, s as deriveReportAnomalies, oe as deriveVerdict, f as detectEngine, g as developmentHints, p as isEmulationSuspected, X as kindFromStatus, F as loadTrace, ie as parseTranslateX, m as sampleRafCadence, N as saveTrace, ne as snapshotOverrides, u as summariseBuckets };

package/dist/panel/index.d.ts

@@ -10,6 +10,8 @@ export interface DevtoolsPanelOptions {
     initialOpen?: boolean;
     /** Corner for the toggle button. Default "bottom-right". */
     position?: "bottom-right" | "bottom-left";
+    /** Labels the A/B button cycles through. Default ["A", "B"]. */
+    buckets?: string[];
 }
 export interface DevtoolsPanelHandle {
     detach: () => void;

package/dist/panel/styles.d.ts

@@ -1 +1 @@
-export declare const PANEL_CSS = "\n:host {\n  all: initial;\n  color-scheme: dark;\n}\n* { box-sizing: border-box; }\n.root {\n  --bg: #14161a;\n  --bg-soft: #1b1e24;\n  --line: #2b3038;\n  --fg: #e6e9ef;\n  --fg-dim: #99a1b0;\n  --accent: #7cc4ff;\n  --warn: #ffb454;\n  --bad: #ff6b6b;\n  font: 12px/1.45 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n  color: var(--fg);\n}\n@media (prefers-color-scheme: light) {\n  .root {\n    --bg: #ffffff;\n    --bg-soft: #f4f6f9;\n    --line: #dde1e8;\n    --fg: #1a1d22;\n    --fg-dim: #5c6472;\n    --accent: #0b6bcb;\n    --warn: #a35a00;\n    --bad: #c2261f;\n  }\n}\n.toggle {\n  position: fixed;\n  bottom: 12px;\n  z-index: 2147483000;\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  margin: 0;\n  padding: 6px 10px;\n  border: 1px solid var(--line);\n  border-radius: 999px;\n  background: var(--bg);\n  color: var(--fg);\n  font: inherit;\n  cursor: pointer;\n}\n.toggle:hover { background: var(--bg-soft); }\n.toggle[data-corner=\"bottom-right\"] { right: 12px; }\n.toggle[data-corner=\"bottom-left\"] { left: 12px; }\n.mark { font-weight: 700; letter-spacing: 0.04em; }\n.count {\n  padding: 0 6px;\n  border-radius: 999px;\n  background: var(--bg-soft);\n  color: var(--fg-dim);\n}\n.dot {\n  width: 7px;\n  height: 7px;\n  border-radius: 50%;\n  background: var(--bad);\n}\n.dot[hidden] { display: none; }\n.panel {\n  position: fixed;\n  left: 0;\n  right: 0;\n  bottom: 0;\n  z-index: 2147482999;\n  display: flex;\n  flex-direction: column;\n  max-width: 100%;\n  border-top: 1px solid var(--line);\n  background: var(--bg);\n  overflow: hidden;\n}\n.panel[hidden] { display: none; }\n.grip {\n  flex: 0 0 6px;\n  height: 6px;\n  background: var(--line);\n  cursor: ns-resize;\n  touch-action: none;\n}\n.head {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 8px;\n  padding: 8px 10px;\n  border-bottom: 1px solid var(--line);\n}\n.env { color: var(--fg-dim); }\n.spacer { flex: 1 1 auto; }\n.act {\n  padding: 4px 8px;\n  border: 1px solid var(--line);\n  border-radius: 4px;\n  background: var(--bg-soft);\n  color: var(--fg);\n  font: inherit;\n  cursor: pointer;\n}\n.chips {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 6px;\n  flex: 1 1 100%;\n}\n.chips:empty { display: none; }\n.chip {\n  padding: 2px 8px;\n  border: 1px solid var(--line);\n  border-radius: 999px;\n  background: var(--bg-soft);\n  color: var(--fg-dim);\n  max-width: 100%;\n  overflow-wrap: anywhere;\n}\n.chip.warn { border-color: var(--warn); color: var(--warn); }\n.chip.bad { border-color: var(--bad); color: var(--bad); }\n.body {\n  display: flex;\n  flex: 1 1 auto;\n  min-height: 0;\n}\n.list {\n  flex: 0 0 40%;\n  max-width: 340px;\n  min-width: 180px;\n  overflow: auto;\n  border-right: 1px solid var(--line);\n}\n.row {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  width: 100%;\n  padding: 6px 10px;\n  border: 0;\n  border-bottom: 1px solid var(--line);\n  background: none;\n  color: var(--fg);\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n}\n.row[aria-selected=\"true\"] { background: var(--bg-soft); }\n.row .kind { font-weight: 700; }\n.row .driver { color: var(--accent); }\n.row .dur, .row .screens { color: var(--fg-dim); }\n.row .n {\n  margin-left: auto;\n  padding: 0 6px;\n  border-radius: 999px;\n  background: var(--bg-soft);\n  color: var(--fg-dim);\n}\n.row .n.bad { background: var(--bad); color: #fff; }\n.detail { flex: 1 1 auto; overflow: auto; padding: 8px 10px; }\n.section { margin: 0 0 10px; }\n.section > h2 {\n  margin: 0 0 4px;\n  font: inherit;\n  font-weight: 700;\n  color: var(--fg-dim);\n  text-transform: uppercase;\n  letter-spacing: 0.06em;\n}\n.kv { display: flex; gap: 8px; }\n.kv > .k { flex: 0 0 34%; max-width: 180px; color: var(--fg-dim); }\n.kv > .v { flex: 1 1 auto; overflow-wrap: anywhere; }\n/* A value that IS the finding \u2014 a stall, a re-asserted hold, an orphan. */\n.kv > .v.bad { color: var(--bad); }\n.li { overflow-wrap: anywhere; }\n.li.bad { color: var(--bad); }\n.dim { color: var(--fg-dim); }\n.spark { display: block; width: 100%; height: 28px; }\n.foot { border-top: 1px solid var(--line); padding: 6px 10px; color: var(--fg-dim); }\n.foot summary { cursor: pointer; }\n.foot .li { margin-top: 4px; }\n";
+export declare const PANEL_CSS = "\n:host {\n  all: initial;\n  color-scheme: dark;\n}\n* { box-sizing: border-box; }\n.root {\n  --bg: #14161a;\n  --bg-soft: #1b1e24;\n  --line: #2b3038;\n  --fg: #e6e9ef;\n  --fg-dim: #99a1b0;\n  --accent: #7cc4ff;\n  --warn: #ffb454;\n  --bad: #ff6b6b;\n  font: 12px/1.45 ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;\n  color: var(--fg);\n}\n@media (prefers-color-scheme: light) {\n  .root {\n    --bg: #ffffff;\n    --bg-soft: #f4f6f9;\n    --line: #dde1e8;\n    --fg: #1a1d22;\n    --fg-dim: #5c6472;\n    --accent: #0b6bcb;\n    --warn: #a35a00;\n    --bad: #c2261f;\n  }\n}\n.toggle {\n  position: fixed;\n  bottom: 12px;\n  z-index: 2147483000;\n  display: flex;\n  align-items: center;\n  gap: 6px;\n  margin: 0;\n  padding: 6px 10px;\n  border: 1px solid var(--line);\n  border-radius: 999px;\n  background: var(--bg);\n  color: var(--fg);\n  font: inherit;\n  cursor: pointer;\n}\n.toggle:hover { background: var(--bg-soft); }\n.toggle[data-corner=\"bottom-right\"] { right: 12px; }\n.toggle[data-corner=\"bottom-left\"] { left: 12px; }\n.mark { font-weight: 700; letter-spacing: 0.04em; }\n.count {\n  padding: 0 6px;\n  border-radius: 999px;\n  background: var(--bg-soft);\n  color: var(--fg-dim);\n}\n.dot {\n  width: 7px;\n  height: 7px;\n  border-radius: 50%;\n  background: var(--bad);\n}\n.dot[hidden] { display: none; }\n.panel {\n  position: fixed;\n  left: 0;\n  right: 0;\n  bottom: 0;\n  z-index: 2147482999;\n  display: flex;\n  flex-direction: column;\n  max-width: 100%;\n  border-top: 1px solid var(--line);\n  background: var(--bg);\n  overflow: hidden;\n}\n.panel[hidden] { display: none; }\n.grip {\n  flex: 0 0 6px;\n  height: 6px;\n  background: var(--line);\n  cursor: ns-resize;\n  touch-action: none;\n}\n.head {\n  display: flex;\n  flex-wrap: wrap;\n  align-items: center;\n  gap: 8px;\n  padding: 8px 10px;\n  border-bottom: 1px solid var(--line);\n}\n.env { color: var(--fg-dim); }\n.spacer { flex: 1 1 auto; }\n.act {\n  padding: 4px 8px;\n  border: 1px solid var(--line);\n  border-radius: 4px;\n  background: var(--bg-soft);\n  color: var(--fg);\n  font: inherit;\n  cursor: pointer;\n}\n.chips {\n  display: flex;\n  flex-wrap: wrap;\n  gap: 6px;\n  flex: 1 1 100%;\n}\n.chips:empty { display: none; }\n.chip {\n  padding: 2px 8px;\n  border: 1px solid var(--line);\n  border-radius: 999px;\n  background: var(--bg-soft);\n  color: var(--fg-dim);\n  max-width: 100%;\n  overflow-wrap: anywhere;\n}\n/* The verdict reads as prose, not as a tag: it is a sentence about the whole\n   session and it is the first thing anybody should read. */\n.chip.lead {\n  border-color: var(--fg);\n  color: var(--fg);\n  white-space: normal;\n  max-width: 100%;\n  line-height: 1.5;\n}\n.chip.warn { border-color: var(--warn); color: var(--warn); }\n.chip.bad { border-color: var(--bad); color: var(--bad); }\n.body {\n  display: flex;\n  flex: 1 1 auto;\n  min-height: 0;\n}\n.list {\n  flex: 0 0 40%;\n  max-width: 340px;\n  min-width: 180px;\n  overflow: auto;\n  border-right: 1px solid var(--line);\n}\n.row {\n  display: flex;\n  align-items: center;\n  gap: 8px;\n  width: 100%;\n  padding: 6px 10px;\n  border: 0;\n  border-bottom: 1px solid var(--line);\n  background: none;\n  color: var(--fg);\n  font: inherit;\n  text-align: left;\n  cursor: pointer;\n}\n.row[aria-selected=\"true\"] { background: var(--bg-soft); }\n.row .kind { font-weight: 700; }\n.row .driver { color: var(--accent); }\n.row .dur, .row .screens { color: var(--fg-dim); }\n.row .n {\n  margin-left: auto;\n  padding: 0 6px;\n  border-radius: 999px;\n  background: var(--bg-soft);\n  color: var(--fg-dim);\n}\n.row .n.bad { background: var(--bad); color: #fff; }\n.detail { flex: 1 1 auto; overflow: auto; padding: 8px 10px; }\n.section { margin: 0 0 10px; }\n.section > h2 {\n  margin: 0 0 4px;\n  font: inherit;\n  font-weight: 700;\n  color: var(--fg-dim);\n  text-transform: uppercase;\n  letter-spacing: 0.06em;\n}\n.kv { display: flex; gap: 8px; }\n.kv > .k { flex: 0 0 34%; max-width: 180px; color: var(--fg-dim); }\n.kv > .v { flex: 1 1 auto; overflow-wrap: anywhere; }\n/* A value that IS the finding \u2014 a stall, a re-asserted hold, an orphan. */\n.kv > .v.bad { color: var(--bad); }\n.li { overflow-wrap: anywhere; }\n.li.bad { color: var(--bad); }\n.dim { color: var(--fg-dim); }\n.spark { display: block; width: 100%; height: 28px; }\n.foot { border-top: 1px solid var(--line); padding: 6px 10px; color: var(--fg-dim); }\n.foot summary { cursor: pointer; }\n.foot .li { margin-top: 4px; }\n";

package/dist/persistence.d.ts

@@ -0,0 +1,20 @@
+import { FlightRecord, PreviousSession } from './types';
+export declare const TRACE_KEY = "flemo:devtools-trace";
+/** Flights carried across a load. The recent ones are the ones anybody reads. */
+export declare const MAX_PERSISTED_FLIGHTS = 10;
+/** Payload ceiling. sessionStorage quotas are small and shared with the app. */
+export declare const MAX_PERSISTED_BYTES = 64000;
+/**
+ * Write the tail of the buffer. Trims by count first and then by size, because
+ * one flight with a hundred long gaps can be larger than nine ordinary ones.
+ */
+export declare const saveTrace: (flights: readonly FlightRecord[], version: string) => void;
+export declare const clearTrace: () => void;
+/**
+ * Read the previous page instance's tail, once, at attach.
+ *
+ * A trace whose schema version does not match this build is DROPPED rather
+ * than coerced: a report that mixes two schemas is worse than one that says
+ * the older flights are gone.
+ */
+export declare const loadTrace: (version: string) => PreviousSession | null;

package/dist/preconditions.d.ts

@@ -0,0 +1,14 @@
+import { EnvironmentFingerprint, InputEvidence, LongTaskSpan, Precondition } from './types';
+export interface PreconditionInput {
+    environment: EnvironmentFingerprint;
+    /** Long tasks observed while NO flight was open. */
+    idleLongTasks: LongTaskSpan[];
+    /** How long the recorder has been attached. */
+    observedMs: number;
+    /** The document was hidden at least once while recording. */
+    wentHidden: boolean;
+    documentHidden: boolean;
+    /** Input observed across every recorded flight. */
+    input: InputEvidence;
+}
+export declare const derivePreconditions: (input: PreconditionInput) => Precondition[];