@treelocator/runtime 0.3.2 → 0.4.1

package/dist/dejitter/recorder.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Dejitter — Animation frame recorder & jank detector (vendored)
+ *
+ * Ported from dejitter/recorder.js as an ES module factory.
+ * Records every rAF at full speed, then downsamples intelligently on getData().
+ */
+export interface DejitterConfig {
+    selector: string;
+    props: string[];
+    sampleRate: number;
+    maxDuration: number;
+    minTextLength: number;
+    mutations: boolean;
+    idleTimeout: number;
+    thresholds: {
+        jitter: {
+            minDeviation: number;
+            maxDuration: number;
+            highSeverity: number;
+            medSeverity: number;
+        };
+        shiver: {
+            minReversals: number;
+            minDensity: number;
+            highDensity: number;
+            medDensity: number;
+            minDelta: number;
+        };
+        jump: {
+            medianMultiplier: number;
+            minAbsolute: number;
+            highMultiplier: number;
+            medMultiplier: number;
+        };
+        stutter: {
+            velocityRatio: number;
+            maxFrames: number;
+            minVelocity: number;
+        };
+        stuck: {
+            minStillFrames: number;
+            maxDelta: number;
+            minSurroundingVelocity: number;
+            highDuration: number;
+            medDuration: number;
+        };
+        outlier: {
+            ratioThreshold: number;
+        };
+    };
+}
+export interface DejitterFinding {
+    type: 'jitter' | 'flicker' | 'shiver' | 'jump' | 'stutter' | 'stuck' | 'outlier';
+    severity: 'high' | 'medium' | 'low' | 'info';
+    elem: string;
+    elemLabel: {
+        tag: string;
+        cls: string;
+        text: string;
+    };
+    prop: string;
+    description: string;
+    [key: string]: any;
+}
+export interface DejitterSummary {
+    duration: number;
+    rawFrameCount: number;
+    targetOutputFrames: number;
+    mutationEvents: number;
+    elementsTracked: number;
+    propBreakdown: {
+        anomaly: number;
+        sampled: number;
+        dropped: number;
+    };
+}
+export interface DejitterAPI {
+    configure(opts?: Partial<DejitterConfig>): DejitterConfig;
+    start(): string;
+    stop(): string;
+    onStop(callback: () => void): void;
+    getData(): any;
+    summary(json?: boolean): string | DejitterSummary;
+    findings(json?: boolean): string | DejitterFinding[];
+    getRaw(): {
+        rawFrames: any[];
+        mutations: any[];
+    };
+    toJSON(): string;
+}
+export declare function createDejitterRecorder(): DejitterAPI;