@flemo/devtools 0.2.2 → 0.3.0

package/README.md

@@ -184,15 +184,13 @@ Do not turn it into a live-updating dashboard.
   "overrides": {
     // Every flemo:* storage key currently set (both storages), including
     // unknown keys and keys present at attach but cleared since (marked).
-    "active": { "flemo:apply": "scrub" },
+    // Retired keys still persisted on the device are listed too, marked
+    // "(retired — the library no longer reads this)", so residue is ruled out
+    // rather than chased.
+    "active": { "flemo:layers": "resident" },
     // Read these FIRST. A non-empty warnings list means the session does not
-    // run stock behavior — especially the driver force pin, which pins EVERY
-    // transition and once burned a multi-day investigation as residue.
-    "warnings": ["flemo:apply=scrub — opt-in diagnostic active (…)"]
-  },
-  "driverPolicy": {
-    "demotion": null, // localStorage flemo:motion-driver ("css" = player demoted)
-    "forcePin": null // sessionStorage flemo:motion-driver-force — non-null = PIN ACTIVE
+    // run stock behavior.
+    "warnings": ["flemo:layers=resident — opt-in diagnostic active (…)"]
   },
   "flights": [
     {
@@ -202,7 +200,7 @@ Do not turn it into a live-updating dashboard.
       "t0": { "ms": 1234.5, "iso": "…" }, // performance.now + wall clock
       "t1": { "ms": 1834.5, "iso": "…" },
       "durationMs": 600,
-      // player | compiled | mixed | unknown — detected per flight from the
+      // compiled | player | mixed | unknown — detected per flight from the
       // DOM signature (inline animation suppression + advancing inline pose
       // = player; a running flemo-* CSSAnimation = compiled). Never assume a
       // platform always routes one tier; routing policies evolve.

package/dist/__tests__/domProtocol.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/overridesRegistry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/anomalies.d.ts

@@ -32,10 +32,6 @@ export interface FlightAnomalyInput {
 }
 export declare const deriveFlightAnomalies: (input: FlightAnomalyInput) => string[];
 export interface ReportAnomalyInput {
-    forcePin: string | null;
-    legacyLocalForcePin: string | null;
-    /** Force-pin value seen at attach but cleared by report time, if any. */
-    clearedForcePin: string | null;
     emulationSuspected: boolean;
     platform: string;
     /** True when a flight is still transitional past STUCK_STATUS_MS. */

package/dist/domProtocol.d.ts

@@ -0,0 +1,22 @@
+export declare const SCREEN_ATTR = "data-flemo-screen";
+export declare const STATUS_ATTR = "data-flemo-status";
+export declare const ACTIVE_ATTR = "data-flemo-active";
+export declare const ROUTER_ATTR = "data-flemo-router";
+export declare const ANIM_HOLD_ATTR = "data-flemo-anim-hold";
+export declare const IMAGE_HOLD_ATTR = "data-flemo-img-hold";
+export declare const HELD_ARRIVAL_ATTR = "data-flemo-held-arrival";
+export declare const PART_NAME_ATTR = "data-flemo-part-name";
+export declare const DECORATOR_ATTR = "data-flemo-decorator";
+export declare const BAR_ATTR = "data-flemo-bar";
+export declare const BAR_STATUS_ATTR = "data-flemo-bar-status";
+export declare const BAR_RIDING_ATTR = "data-flemo-bar-riding";
+/** This package's own marker — core reserves the name but never writes it. */
+export declare const DEVTOOLS_PANEL_ATTR = "data-flemo-devtools-panel";
+/** The statuses during which a flight is moving. */
+export declare const TRANSITIONAL_STATUSES: readonly ["PUSHING", "POPPING", "REPLACING"];
+/** The ANIM_HOLD_ATTR values that mean "held" (any form of park included). */
+export declare const HOLD_VALUES: readonly ["true", "park", "park-under", "park-over"];
+/** `[data-flemo-screen]` */
+export declare const attrSelector: (attribute: string) => string;
+/** `[data-flemo-status="PUSHING"]` */
+export declare const attrValueSelector: (attribute: string, value: string) => string;

package/dist/index.d.ts

@@ -6,8 +6,8 @@ export { BLIND_SPOTS } from './blindSpots';
 export { attachDevtoolsPanel } from './panel';
 export type { DevtoolsPanelHandle, DevtoolsPanelOptions } from './panel';
 export { captureEnvironment, detectEngine, isEmulationSuspected, sampleRafCadence } from './environment';
-export { deriveOverrideWarnings, FLAG_REGISTRY, LEGACY_LOCAL_PIN_KEY, snapshotOverrides } from './overrides';
-export type { FlagClass, FlagDescriptor } from './overrides';
+export { CORE_FLAGS, deriveOverrideWarnings, DEVTOOLS_OWNED_FLAGS, FLAG_REGISTRY, PANEL_HEIGHT_KEY, RETIRED_FLAGS, RETIRED_MARKER, snapshotOverrides } from './overrides';
+export type { FlagClass, FlagDescriptor, RetiredFlag } from './overrides';
 export { classifyDriver, computeFrameStats, computePhaseStats, computePlayerGapStats, kindFromStatus, parseTranslateX } from './sampling';
 export type { DriverEvidence } from './sampling';
-export type { DriverPolicySection, EnvironmentFingerprint, FlemoReport, FlightDriver, FlightHolds, FlightKind, FlightParticipants, FlightRecord, FlightRecorderHandle, FlightRecorderOptions, FlightTimestamp, FramePhaseStats, FrameSampleStats, LandingAudit, LongTaskSpan, ObservationCapabilities, OverridesSection, PlayerGapStats, UaBrand } from './types';
+export type { EnvironmentFingerprint, FlemoReport, FlightDriver, FlightHolds, FlightKind, FlightParticipants, FlightRecord, FlightRecorderHandle, FlightRecorderOptions, FlightTimestamp, FramePhaseStats, FrameSampleStats, LandingAudit, LongTaskSpan, ObservationCapabilities, OverridesSection, PlayerGapStats, UaBrand } from './types';