@flemo/devtools 0.4.0 → 0.5.0

package/dist/landingProbe.d.ts

@@ -0,0 +1,17 @@
+import { LandingAudit } from './types';
+/** How many rAF frames past flight end the landing audit waits. */
+export declare const LANDING_AUDIT_FRAMES = 2;
+/**
+ * Hold markers still on the page at rest. Both of these are supposed to be
+ * gone by the landing: whatever they hide has no owner left to reveal it.
+ * Scanned document-wide on purpose — an orphan's screen is often exactly the
+ * one that was swapped out from under the hold.
+ *
+ * `busy` is the caller's "another flight is already running" test. The audit
+ * lands two frames after the previous flight ended, and by then a fast
+ * back-to-back navigation legitimately owns hold markers of its own. A missed
+ * detection is recoverable; blaming a flight for its successor's working holds
+ * would train the reader to ignore the signal.
+ */
+export declare const orphanedHolds: (busy: boolean) => string[];
+export declare const auditLanding: (elements: readonly Element[], busy: boolean) => Omit<LandingAudit, "stuckStatuses">;

package/dist/morphProbe.d.ts

@@ -0,0 +1,57 @@
+import { MorphActivity, TripwireHit } from './types';
+/** A ghost cut this soon after it appeared was never seen. */
+export declare const GHOST_BLADE_MS = 34;
+export interface MorphProbeState {
+    /** Registered ends seen when the flight opened. */
+    registered: number;
+    /** Keys with ends this flight could have paired. */
+    pairable: Set<string>;
+    /** Keys carried by more than one end inside a single screen. */
+    duplicated: Set<string>;
+    /** Keys seen carrying a flight role at any point during the flight. */
+    flew: Set<string>;
+    camera: boolean;
+    /** Ghosts seen, and when each appeared, so a cut one can be timed. */
+    ghosts: number;
+    ghostBornAt: Map<Element, number>;
+    shortestGhostLifeMs: number | null;
+    /** Morph keyframe rules in the sheet when the flight opened. */
+    sheetRulesAtStart: number;
+}
+/**
+ * Morph keyframe rules currently in the per-flight sheet.
+ *
+ * One `<style>` element holds them all and outlives every flight, so counting
+ * the element proves nothing; the rules are what a flight inserts and drops.
+ * A landing that leaves more than it started with leaked a flight's keyframes.
+ */
+export declare const morphSheetRuleCount: () => number;
+/**
+ * Read the pairing picture as the flight opens.
+ *
+ * By this point the runtime has already staged whatever it paired: the
+ * observer that opens a flight runs after the commit that stamped the roles.
+ * So a role is read as fact, and only the ends still sitting in their screens
+ * are grouped to decide what COULD have paired.
+ *
+ * Ends are grouped by owning screen because two ends under one screen are not
+ * a pair — they are the same key used twice, which is a consumer mistake worth
+ * naming rather than a runtime failure. Ends outside any screen (shared chrome:
+ * a bar rendered beside the screen scope, not inside it) count as their own
+ * owner, which is the runtime's own rule for them.
+ */
+export declare const createMorphProbeState: (participants: readonly Element[]) => MorphProbeState;
+/** A role stamped (or cleared) during the flight: proof the pair flew. */
+export declare const trackMorphAttribute: (state: MorphProbeState, target: Element) => void;
+/** Ghosts arriving and leaving, so one cut inside a frame can be timed. */
+export declare const trackMorphNodes: (state: MorphProbeState, mutation: MutationRecord, atMs: number) => void;
+/**
+ * Tripwire hits the morph probe raises, at the moment they can be judged.
+ *
+ * A ghost is a copy of the element being replaced and its whole job is to be
+ * seen fading; one removed within a frame of appearing was never on screen at
+ * all, which is the first-frame blade this project spent a campaign on.
+ */
+export declare const morphTripwires: (state: MorphProbeState) => TripwireHit[];
+/** The flight's morph picture, plus what it left behind at rest. */
+export declare const morphActivity: (state: MorphProbeState, busy: boolean) => MorphActivity;

package/dist/noop.d.ts

@@ -1,13 +1,22 @@
+import { DevtoolsHudHandle, DevtoolsHudOptions } from './hud';
 import { DevtoolsPanelHandle, DevtoolsPanelOptions } from './panel';
 import { FlightRecorderHandle, FlightRecorderOptions } from './types';
 export * from './anomalies';
 export * from './blindSpots';
+export * from './buckets';
 export * from './environment';
+export * from './judging';
 export * from './overrides';
+export * from './persistence';
+export * from './preconditions';
 export * from './sampling';
-export declare const REPORT_SCHEMA_VERSION = "2";
+export * from './verdict';
+export declare const REPORT_SCHEMA_VERSION = "3";
 export declare const attachFlightRecorder: (_options?: FlightRecorderOptions) => FlightRecorderHandle;
 export declare const attachDevtoolsPanel: (_options?: DevtoolsPanelOptions) => DevtoolsPanelHandle;
+export declare const attachDevtoolsHud: (_options?: DevtoolsHudOptions) => DevtoolsHudHandle;
 export type { FlemoGlobal } from './recorder';
+export type { DevtoolsHudHandle, DevtoolsHudOptions } from './hud';
 export type { DevtoolsPanelHandle, DevtoolsPanelOptions } from './panel';
-export type { EnvironmentFingerprint, FlemoReport, FlightDriver, FlightHolds, FlightKind, FlightParticipants, FlightRecord, FlightRecorderHandle, FlightRecorderOptions, FlightTimestamp, FramePhaseStats, FrameSampleStats, LandingAudit, LongTaskSpan, ObservationCapabilities, OverridesSection, PlayerGapStats, UaBrand } from './types';
+export type { DriverEvidence } from './frameProbe';
+export type { BucketSummary, EnvironmentFingerprint, FlemoReport, FlightDriver, FlightHolds, FlightKind, FlightParticipants, FlightRecord, FlightRecorderHandle, FlightRecorderOptions, FlightTimestamp, FramePhaseStats, FrameSampleStats, ImageActivity, InputEvidence, LandingAudit, LongTaskSpan, MorphActivity, MotionProgress, ObservationCapabilities, OverridesSection, Precondition, PreconditionStatus, PreviousSession, TripwireHit, UaBrand } from './types';