@flemo/devtools 0.6.0 → 0.7.0

package/dist/noop.d.ts

@@ -1,5 +1,6 @@
 import { DevtoolsHudHandle, DevtoolsHudOptions } from './hud';
 import { DevtoolsPanelHandle, DevtoolsPanelOptions } from './panel';
+import { SwipeProbeHandle, SwipeProbeOptions } from './swipeProbe';
 import { FlightRecorderHandle, FlightRecorderOptions } from './types';
 export * from './anomalies';
 export * from './blindSpots';
@@ -15,8 +16,11 @@ 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 declare const SWIPE_PROBE_MS = 1200;
+export declare const attachSwipeProbe: (_options?: SwipeProbeOptions) => SwipeProbeHandle;
 export type { FlemoGlobal } from './recorder';
 export type { DevtoolsHudHandle, DevtoolsHudOptions } from './hud';
 export type { DevtoolsPanelHandle, DevtoolsPanelOptions } from './panel';
+export type { SwipeProbeHandle, SwipeProbeOptions, SwipeReleaseAudit, SwipeSample } from './swipeProbe';
 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';

package/dist/noop.mjs

@@ -637,6 +637,6 @@ var e = 30, t = 1e4, n = 50, r = 120, i = 100, a = 48, o = (e) => {
 	detach: Q,
 	report: ce,
 	mark: () => null
-}), $ = (e) => ({ detach: Q }), ue = (e) => ({ detach: Q });
+}), $ = (e) => ({ detach: Q }), ue = (e) => ({ detach: Q }), de = 1200, fe = (e) => ({ detach: Q });
 //#endregion
-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 };
+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, de as SWIPE_PROBE_MS, k as TRACE_KEY, ue as attachDevtoolsHud, $ as attachDevtoolsPanel, le as attachFlightRecorder, fe as attachSwipeProbe, 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/swipeProbe.d.ts

@@ -0,0 +1,52 @@
+/** How long after a release the probe keeps watching. Longer than any settle. */
+export declare const SWIPE_PROBE_MS = 1200;
+/** One screen's pose on one frame after a release. */
+export interface SwipeSample {
+    /** Milliseconds since the release. */
+    readonly t: number;
+    /** Each screen's horizontal translate, in document order. */
+    readonly x: readonly number[];
+    /**
+     * The animations found on those screens, as `name|state|ct|rate`. An empty
+     * list is the finding, not a gap: nothing was driving the screens that frame.
+     */
+    readonly animations: readonly string[];
+}
+export interface SwipeReleaseAudit {
+    /** Frames captured from the release onward. */
+    readonly samples: readonly SwipeSample[];
+    /** How far the furthest screen still had to travel when the finger left. */
+    readonly travelAtReleasePx: number;
+    /** The largest distance any screen covered between two frames. */
+    readonly biggestStepPx: number;
+    /** The mean of the first three steps, and of the last three. */
+    readonly openingStepPx: number;
+    readonly closingStepPx: number;
+    /**
+     * A landing decelerates: its closing frames are a fraction of its opening
+     * ones. A release handed back as a constant rate makes these equal, which is
+     * the defect this probe was built for and reads as no transition at all.
+     */
+    readonly eased: boolean;
+    /** A release that put a screen home in one frame. */
+    readonly teleported: boolean;
+}
+export interface SwipeProbeOptions {
+    /** Called once the watch window closes, with what the release did. */
+    readonly onRelease: (audit: SwipeReleaseAudit) => void;
+    /** Test seam for the clock. */
+    readonly now?: () => number;
+    /** Test seam for the frame source. */
+    readonly schedule?: (run: () => void) => void;
+}
+export interface SwipeProbeHandle {
+    readonly detach: () => void;
+}
+/**
+ * Watch every pointer release and report what the screens did next.
+ *
+ * Passive and capture-phase, like the tripwires: it observes the gesture
+ * without taking part in it, and its loop starts at the release rather than
+ * running all the time.
+ */
+export declare const attachSwipeProbe: (options: SwipeProbeOptions) => SwipeProbeHandle;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flemo/devtools",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Zero-config flight recorder, on-device readout and visual panel for flemo screen transitions: captures per-flight driver routing, frame pacing, long tasks, shared-element pairing, landing residues and judging preconditions into one JSON report readable by humans and coding agents.",
   "main": "./dist/index.mjs",
   "module": "./dist/index.mjs",
@@ -34,21 +34,21 @@
   "homepage": "https://flemo.dev",
   "license": "MIT",
   "devDependencies": {
-    "@flemo/core": "2.3.1",
+    "@flemo/core": "2.5.0",
     "@flemo/eslint-config": "0.0.0",
     "@flemo/tsconfig": "0.0.0",
     "@testing-library/react": "^16.3.3",
     "@types/node": "^24.13.1",
     "@types/react": "^19.2.18",
-    "@vitest/coverage-v8": "^4.1.11",
+    "@vitest/coverage-v8": "^5.0.0",
     "eslint": "^9.39.5",
-    "jsdom": "^29.1.1",
+    "jsdom": "^30.0.1",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "typescript": "^6.0.3",
     "vite": "^8.2.2",
-    "vite-plugin-dts": "^5.0.3",
-    "vitest": "^4.1.11"
+    "vite-plugin-dts": "^5.1.0",
+    "vitest": "^5.0.0"
   },
   "publishConfig": {
     "access": "public"