@maxr0ssi/glide-web-ui 0.1.1

package/README.md

@@ -0,0 +1,75 @@
+# Glide Web UI
+
+Browser-based demo of Glide's hand gesture detection algorithms. Runs the full TouchProof detection pipeline in-browser using MediaPipe's WebAssembly hand landmarker.
+
+## Standalone (Dev Server)
+
+```bash
+make web-setup   # npm install
+make web-dev     # starts Vite at localhost:5173
+```
+
+Open in browser, grant camera access. You'll see a split-view with the algorithm visualizer (webcam + landmarks + signal scores) and a scrollable demo area that responds to gestures.
+
+## As a Library (Embeddable Component)
+
+```bash
+make web-build   # produces dist/glide-demo.es.js + types
+```
+
+```tsx
+import { GlideDemo } from '@glide/web-ui';
+import '@glide/web-ui/dist/style.css';
+
+function App() {
+  return <GlideDemo showVisualizer={true} />;
+}
+```
+
+### `<GlideDemo />` Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `modelPath` | `string` | Google CDN | Override MediaPipe model URL |
+| `config` | `Partial<AppConfig>` | `defaults.yaml` values | Override detection config |
+| `showVisualizer` | `boolean` | `true` | Show webcam + signal dashboard |
+| `scrollContent` | `ReactNode` | Demo paragraphs | Custom scroll area content |
+| `className` | `string` | `''` | Additional CSS class |
+| `style` | `CSSProperties` | — | Inline styles |
+
+### `useGlide` Hook
+
+For full control, use the hook directly:
+
+```tsx
+import { useGlide } from '@glide/web-ui';
+
+function Custom() {
+  const { videoRef, signals, gestureState, landmarks, fps } = useGlide();
+  // Build your own UI with the pipeline outputs
+}
+```
+
+## Testing
+
+```bash
+make web-test    # vitest run
+```
+
+## Architecture
+
+The TypeScript code mirrors the Python module structure:
+
+| Python | TypeScript | Purpose |
+|--------|-----------|---------|
+| `glide/core/types.py` | `src/core/types.ts` | GateState, Landmark, HandDet, PoseFlags |
+| `glide/core/config_models.py` | `src/core/config.ts` | AppConfig + factory |
+| `glide/features/alignment.py` | `src/features/alignment.ts` | HandAligner |
+| `glide/features/kinematics.py` | `src/features/kinematics.ts` | KinematicsTracker |
+| `glide/features/poses.py` | `src/features/poses.ts` | checkHandPose |
+| `glide/gestures/touchproof_scoring.py` | `src/gestures/touchproof-scoring.ts` | Pure scoring functions |
+| `glide/gestures/touchproof_detector.py` | `src/gestures/touchproof-detector.ts` | TouchProofDetector |
+| `glide/gestures/velocity_tracker.py` | `src/gestures/velocity-tracker.ts` | VelocityTracker |
+| `glide/gestures/velocity_controller.py` | `src/gestures/velocity-controller.ts` | VelocityController |
+
+MFC (optical flow) is excluded from the web port — `mfcScore` is hardcoded to 0.5 (neutral).

package/dist/components/GlideDemo.d.ts

@@ -0,0 +1,16 @@
+/**
+ * GlideDemo — top-level exportable component.
+ * Split-view: algorithm visualizer + scrollable demo content.
+ */
+import React from 'react';
+import type { AppConfig } from '../core/config';
+export interface GlideDemoProps {
+    modelPath?: string;
+    config?: Partial<AppConfig>;
+    showVisualizer?: boolean;
+    scrollContent?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+export declare const GlideDemo: React.FC<GlideDemoProps>;
+//# sourceMappingURL=GlideDemo.d.ts.map

package/dist/components/GlideDemo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlideDemo.d.ts","sourceRoot":"","sources":["../../src/components/GlideDemo.tsx"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAKhD,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAED,eAAO,MAAM,SAAS,EAAE,KAAK,CAAC,EAAE,CAAC,cAAc,CAqC9C,CAAC"}

package/dist/components/ScrollArea.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ScrollArea — scrollable demo content that responds to Glide gestures.
+ */
+import React from 'react';
+import { GestureState } from '../gestures/velocity-controller';
+import type { Vec2D } from '../gestures/velocity-tracker';
+interface ScrollAreaProps {
+    velocity: Vec2D | null;
+    gestureState: GestureState;
+    isActive: boolean;
+    children?: React.ReactNode;
+}
+export declare const ScrollArea: React.FC<ScrollAreaProps>;
+export {};
+//# sourceMappingURL=ScrollArea.d.ts.map

package/dist/components/ScrollArea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollArea.d.ts","sourceRoot":"","sources":["../../src/components/ScrollArea.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAA4B,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAC;AAE1D,UAAU,eAAe;IACvB,QAAQ,EAAE,KAAK,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC5B;AA6BD,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CA0BhD,CAAC"}

package/dist/components/Visualizer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Visualizer — webcam canvas with hand landmarks, signal dashboard, and FPS counter.
+ */
+import React from 'react';
+import type { Landmark } from '../core/types';
+import type { TouchProofSignals } from '../gestures/touchproof-signals';
+import { GestureState } from '../gestures/velocity-controller';
+interface VisualizerProps {
+    videoRef: React.RefObject<HTMLVideoElement | null>;
+    canvasRef: React.RefObject<HTMLCanvasElement | null>;
+    landmarks: Landmark[] | null;
+    signals: TouchProofSignals;
+    gestureState: GestureState;
+    fps: number;
+    isLoading: boolean;
+    error: string | null;
+}
+export declare const Visualizer: React.FC<VisualizerProps>;
+export {};
+//# sourceMappingURL=Visualizer.d.ts.map

package/dist/components/Visualizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Visualizer.d.ts","sourceRoot":"","sources":["../../src/components/Visualizer.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAoB,MAAM,OAAO,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAY/D,UAAU,eAAe;IACvB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACnD,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACrD,SAAS,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAC7B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,YAAY,EAAE,YAAY,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAgJhD,CAAC"}

package/dist/core/collections.d.ts

@@ -0,0 +1,22 @@
+/**
+ * BoundedDeque — fixed-capacity ring buffer replacing Python's deque(maxlen=N).
+ */
+export declare class BoundedDeque<T> {
+    private _buf;
+    private _head;
+    private _size;
+    private _capacity;
+    constructor(capacity: number);
+    get length(): number;
+    get capacity(): number;
+    push(item: T): void;
+    at(index: number): T;
+    /** Access from end: -1 = last, -2 = second to last, etc. */
+    fromEnd(offset: number): T;
+    first(): T | undefined;
+    last(): T | undefined;
+    clear(): void;
+    toArray(): T[];
+    [Symbol.iterator](): Iterator<T>;
+}
+//# sourceMappingURL=collections.d.ts.map

package/dist/core/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/core/collections.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,YAAY,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,EAAE,MAAM;IAQ5B,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAUnB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC;IAOpB,4DAA4D;IAC5D,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC;IAO1B,KAAK,IAAI,CAAC,GAAG,SAAS;IAItB,IAAI,IAAI,CAAC,GAAG,SAAS;IAIrB,KAAK,IAAI,IAAI;IAKb,OAAO,IAAI,CAAC,EAAE;IAQb,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;CAKlC"}

package/dist/core/config.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Configuration models for Glide web UI.
+ * Ported from glide/core/config_models.py + configs/defaults.yaml
+ *
+ * Uses plain TS interfaces + factory function (no runtime validation library).
+ * Default values come from configs/defaults.yaml where they differ from Pydantic defaults.
+ */
+export interface GatesConfig {
+    presenceConf: number;
+    poses: string[];
+    preStillMs: number;
+    maxIdleRmsSpeed: number;
+}
+export interface KinematicsConfig {
+    emaAlpha: number;
+    bufferFrames: number;
+    frameLookback: number;
+}
+export interface ScrollConfig {
+    enabled: boolean;
+    pixelsPerDegree: number;
+    maxVelocity: number;
+    accelerationCurve: number;
+}
+export interface TouchProofConfig {
+    proximityEnter: number;
+    proximityExit: number;
+    proximityHardCap: number;
+    angleEnterDeg: number;
+    angleExitDeg: number;
+    angleHardCapDeg: number;
+    correlationFrames: number;
+    correlationMin: number;
+    visibilityAsymmetryMin: number;
+    framesToEnter: number;
+    framesToExit: number;
+    fusedEnterThreshold: number;
+    fusedExitThreshold: number;
+    emaAlpha: number;
+    smoothProximity: boolean;
+    proximityMode: 'fixed' | 'adaptive' | 'logarithmic';
+    baselineLearningRate: number;
+    relativeTouchThreshold: number;
+    distanceNearPx: number;
+    distanceFarPx: number;
+    kD: number;
+    kTheta: number;
+    mfcWindowFrames: number;
+    mfcPatchSize: number;
+    mfcCorrMin: number;
+    mfcMagRatioMin: number;
+    mfcMagRatioMax: number;
+}
+export interface AppConfig {
+    cameraIndex: number;
+    frameWidth: number;
+    mirror: boolean;
+    touchThresholdPixels: number;
+    gates: GatesConfig;
+    kinematics: KinematicsConfig;
+    touchproof: TouchProofConfig;
+    scroll: ScrollConfig;
+}
+/** Create default config matching configs/defaults.yaml tuned values. */
+export declare function createDefaultConfig(): AppConfig;
+/** Deep-merge a partial config over defaults. */
+export declare function mergeConfig(overrides: Partial<AppConfig>): AppConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/core/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAE/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IAGzB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IAGxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IAGvB,sBAAsB,EAAE,MAAM,CAAC;IAG/B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IAGrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAG3B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IAGzB,aAAa,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;IACpD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,EAAE,MAAM,CAAC;IAG/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IAGf,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAE7B,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,gBAAgB,CAAC;IAC7B,UAAU,EAAE,gBAAgB,CAAC;IAC7B,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,IAAI,SAAS,CAkE/C;AAED,iDAAiD;AACjD,wBAAgB,WAAW,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAUpE"}

package/dist/core/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Core data types for Glide web UI.
+ * Ported from glide/core/types.py
+ */
+export declare enum GateState {
+    UNARMED = "UNARMED",
+    READY = "READY",
+    ARMED = "ARMED",
+    COOLDOWN = "COOLDOWN"
+}
+export interface Landmark {
+    x: number;
+    y: number;
+    visibility?: number;
+    presence?: number;
+}
+export interface BBox {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+export interface HandDet {
+    landmarks: Landmark[];
+    handedness: string;
+    confidence: number;
+    bbox?: BBox;
+}
+export interface PoseFlags {
+    openPalm: boolean;
+    pointingIndex: boolean;
+    twoUp: boolean;
+}
+export declare function createPoseFlags(): PoseFlags;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,oBAAY,SAAS;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,IAAI;IACnB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,eAAe,IAAI,SAAS,CAE3C"}

package/dist/features/alignment.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Hand-aligned coordinate system.
+ * Ported from glide/features/alignment.py
+ */
+import type { Landmark } from '../core/types';
+export declare class HandAligner {
+    palmCenter: [number, number] | null;
+    thetaRad: number | null;
+    scale: number | null;
+    imageWidth: number | null;
+    imageHeight: number | null;
+    /**
+     * Update alignment parameters from hand landmarks.
+     * Returns true if successful.
+     */
+    update(landmarks: Landmark[], imageWidth: number, imageHeight: number): boolean;
+    normalizedToPixel(xNorm: number, yNorm: number): [number, number];
+    pixelToNormalized(xPx: number, yPx: number): [number, number];
+    /** Transform normalized coordinates to hand-aligned coordinates. */
+    toHandAligned(xNorm: number, yNorm: number): [number, number];
+    /** Inverse: hand-aligned → normalized coordinates. */
+    fromHandAligned(xAligned: number, yAligned: number): [number, number];
+    /** Get fingertip pixel positions: [[indexX, indexY], [middleX, middleY]]. */
+    getFingertipPixels(landmarks: Landmark[]): [[number, number], [number, number]];
+    /** Normalized distance between index and middle fingertips (0 = touching). */
+    getNormalizedDistance(landmarks: Landmark[]): number;
+    /** Log-normalized distance (more stable across camera distances). */
+    getNormalizedDistanceLog(landmarks: Landmark[]): number;
+    /** Angle between index and middle fingers from palm center (degrees). */
+    getFingertipAngle(landmarks: Landmark[]): number;
+    /** Distance factor: 0.0 = very close, 1.0 = far away. */
+    getHandDistanceFactor(): number;
+    /** Finger length in pixels. */
+    getFingerLengthPixels(): number;
+}
+//# sourceMappingURL=alignment.d.ts.map

package/dist/features/alignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alignment.d.ts","sourceRoot":"","sources":["../../src/features/alignment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,qBAAa,WAAW;IACtB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAQ;IAC3C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAQ;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAQ;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAElC;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAgC/E,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAKjE,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAK7D,oEAAoE;IACpE,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAgB7D,sDAAsD;IACtD,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAgBrE,6EAA6E;IAC7E,kBAAkB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAY/E,8EAA8E;IAC9E,qBAAqB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM;IAYpD,qEAAqE;IACrE,wBAAwB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM;IAevD,yEAAyE;IACzE,iBAAiB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM;IAoBhD,yDAAyD;IACzD,qBAAqB,IAAI,MAAM;IAS/B,+BAA+B;IAC/B,qBAAqB,IAAI,MAAM;CAMhC"}

package/dist/features/kinematics.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Kinematics tracking — EMA-smoothed fingertip positions.
+ * Ported from glide/features/kinematics.py
+ */
+import { BoundedDeque } from '../core/collections';
+import type { Landmark } from '../core/types';
+export interface HandKinematics {
+    palmX: number;
+    palmY: number;
+    thetaRad: number;
+    indexTipRel: [number, number];
+    middleTipRel: [number, number] | null;
+    fingerLengthIdx: number;
+    fingerLengthMid: number | null;
+}
+export declare class KinematicsTracker {
+    private emaAlpha;
+    private _idxTipEma;
+    private _midTipEma;
+    trail: BoundedDeque<[number, number]>;
+    trailMid: BoundedDeque<[number, number]>;
+    trailMean: BoundedDeque<[number, number]>;
+    constructor(emaAlpha?: number, bufferFrames?: number);
+    private static mean;
+    private static rot;
+    private static ema;
+    compute(landmarks: Landmark[]): HandKinematics | null;
+    getMeanFingertip(): [number, number] | null;
+    getFingerSpeeds(lookback?: number): [number | null, number | null];
+}
+//# sourceMappingURL=kinematics.d.ts.map

package/dist/features/kinematics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kinematics.d.ts","sourceRoot":"","sources":["../../src/features/kinematics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,UAAU,CAAiC;IAEnD,KAAK,EAAE,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACtC,QAAQ,EAAE,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACzC,SAAS,EAAE,YAAY,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;gBAE9B,QAAQ,SAAO,EAAE,YAAY,SAAK;IAO9C,OAAO,CAAC,MAAM,CAAC,IAAI;IAOnB,OAAO,CAAC,MAAM,CAAC,GAAG;IAMlB,OAAO,CAAC,MAAM,CAAC,GAAG;IASlB,OAAO,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,cAAc,GAAG,IAAI;IAmDrD,gBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAQ3C,eAAe,CAAC,QAAQ,SAAI,GAAG,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAkB9D"}

package/dist/features/poses.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Hand pose detection.
+ * Ported from glide/features/poses.py
+ */
+import type { Landmark, PoseFlags } from '../core/types';
+/**
+ * Check hand pose for common gestures.
+ *
+ * - openPalm: spread between index MCP and pinky MCP is large
+ * - pointingIndex: index tip beyond middle tip in pointing direction
+ * - twoUp: index and middle tips above ring tip (y smaller in image coords)
+ */
+export declare function checkHandPose(landmarks: Landmark[]): PoseFlags;
+//# sourceMappingURL=poses.d.ts.map

package/dist/features/poses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poses.d.ts","sourceRoot":"","sources":["../../src/features/poses.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAGzD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,SAAS,CAkB9D"}

package/dist/gestures/touchproof-detector.d.ts

@@ -0,0 +1,37 @@
+/**
+ * TouchProof detector — multi-signal fusion for fingertip contact detection.
+ * Ported from glide/gestures/touchproof_detector.py
+ *
+ * MFC (optical flow) is excluded: mfcScore hardcoded to 0.5 (neutral).
+ */
+import type { TouchProofConfig } from '../core/config';
+import { GateState } from '../core/types';
+import type { Landmark } from '../core/types';
+import { HandAligner } from '../features/alignment';
+import type { TouchProofSignals } from './touchproof-signals';
+export declare class TouchProofDetector {
+    config: TouchProofConfig;
+    aligner: HandAligner;
+    state: GateState;
+    private _enterCounter;
+    private _exitCounter;
+    private _idxPositions;
+    private _midPositions;
+    private _proximityEma;
+    private _angleEma;
+    private _baselineClose;
+    private _baselineFar;
+    private _baselineAlpha;
+    /** Hardcoded MFC score (no optical flow in browser). */
+    private _lastMfcScore;
+    constructor(config: TouchProofConfig);
+    /**
+     * Update touch detection with new landmarks.
+     * Note: no frame_bgr param (MFC excluded).
+     */
+    update(landmarks: Landmark[], imageWidth: number, imageHeight: number): TouchProofSignals;
+    private _updateState;
+    private _updateBaseline;
+    private _getBaselineDistance;
+}
+//# sourceMappingURL=touchproof-detector.d.ts.map

package/dist/gestures/touchproof-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touchproof-detector.d.ts","sourceRoot":"","sources":["../../src/gestures/touchproof-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAUpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,qBAAa,kBAAkB;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,EAAE,SAAS,CAAqB;IAErC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,YAAY,CAAK;IAEzB,OAAO,CAAC,aAAa,CAAiC;IACtD,OAAO,CAAC,aAAa,CAAiC;IAEtD,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,SAAS,CAAuB;IAExC,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,cAAc,CAAS;IAE/B,wDAAwD;IACxD,OAAO,CAAC,aAAa,CAAO;gBAEhB,MAAM,EAAE,gBAAgB;IAQpC;;;OAGG;IACH,MAAM,CACJ,SAAS,EAAE,QAAQ,EAAE,EACrB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,iBAAiB;IAgJpB,OAAO,CAAC,YAAY;IAgCpB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,oBAAoB;CAS7B"}

package/dist/gestures/touchproof-scoring.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Pure scoring functions for TouchProof detection.
+ * Ported from glide/gestures/touchproof_scoring.py
+ *
+ * All functions are stateless and side-effect free.
+ */
+import type { Landmark } from '../core/types';
+import type { TouchProofConfig } from '../core/config';
+/** Convert normalized distance to proximity score (0-1). */
+export declare function scoreProximity(distanceNorm: number, enterThreshold: number, exitThreshold: number): number;
+/** Convert angle to score (0-1). More parallel = higher. */
+export declare function scoreAngle(angleDeg: number, enterDeg: number, exitDeg: number): number;
+/** Score based on visibility asymmetry (occlusion indicator). */
+export declare function scoreVisibility(indexTip: Landmark, middleTip: Landmark, asymmetryMin: number): number;
+/** Compute velocity correlation between fingers. */
+export declare function computeCorrelation(idxPositions: [number, number][], midPositions: [number, number][], correlationFrames: number, correlationMin: number): number;
+/** Pearson correlation coefficient. Returns null if cannot compute. */
+export declare function pearsonCorrelation(a: number[], b: number[]): number | null;
+/** Score proximity with distance-aware thresholds and relative baseline. */
+export declare function scoreProximityAdjusted(distanceNorm: number, distanceFactor: number, config: TouchProofConfig, baseline: number | null): number;
+/** Score angle with distance-aware thresholds. */
+export declare function scoreAngleAdjusted(angleDeg: number, distanceFactor: number, config: TouchProofConfig): number;
+/** Get fusion weights based on hand distance. */
+export declare function getAdaptiveWeights(distanceFactor: number): {
+    proximity: number;
+    angle: number;
+    mfc: number;
+    occlusion: number;
+};
+//# sourceMappingURL=touchproof-scoring.d.ts.map

package/dist/gestures/touchproof-scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touchproof-scoring.d.ts","sourceRoot":"","sources":["../../src/gestures/touchproof-scoring.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,4DAA4D;AAC5D,wBAAgB,cAAc,CAC5B,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GACpB,MAAM,CAIR;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAItF;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,QAAQ,EACnB,YAAY,EAAE,MAAM,GACnB,MAAM,CAMR;AAED,oDAAoD;AACpD,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAChC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAChC,iBAAiB,EAAE,MAAM,EACzB,cAAc,EAAE,MAAM,GACrB,MAAM,CA+BR;AAED,uEAAuE;AACvE,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAwB1E;AAED,4EAA4E;AAC5E,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,gBAAgB,EACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB,MAAM,CAgBR;AAED,kDAAkD;AAClD,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,gBAAgB,GACvB,MAAM,CAQR;AAED,iDAAiD;AACjD,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,GACrB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAkBtE"}

package/dist/gestures/touchproof-signals.d.ts

@@ -0,0 +1,16 @@
+/**
+ * TouchProof signals data structure.
+ * Ported from glide/gestures/touchproof_signals.py (dataclass only; MicroFlowTracker excluded).
+ */
+export interface TouchProofSignals {
+    proximityScore: number;
+    angleScore: number;
+    correlationScore: number;
+    visibilityScore: number;
+    mfcScore: number;
+    distanceFactor: number;
+    fusedScore: number;
+    isTouching: boolean;
+}
+export declare function emptySignals(): TouchProofSignals;
+//# sourceMappingURL=touchproof-signals.d.ts.map

package/dist/gestures/touchproof-signals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"touchproof-signals.d.ts","sourceRoot":"","sources":["../../src/gestures/touchproof-signals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,YAAY,IAAI,iBAAiB,CAWhD"}

package/dist/gestures/velocity-controller.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Velocity-based scroll controller.
+ * Ported from glide/gestures/velocity_controller.py
+ */
+import type { Vec2D } from './velocity-tracker';
+export declare enum GestureState {
+    IDLE = "idle",
+    SCROLLING = "scrolling"
+}
+export interface VelocityUpdate {
+    velocity: Vec2D;
+    state: GestureState;
+    isActive: boolean;
+}
+export declare class VelocityController {
+    private minVelocity;
+    private scrollDelayMs;
+    state: GestureState;
+    private wasTouching;
+    private touchStartMs;
+    constructor(minVelocity?: number, scrollDelayMs?: number);
+    update(velocity: Vec2D | null, isTouching: boolean, isHighFive: boolean, timestampMs: number): VelocityUpdate;
+}
+//# sourceMappingURL=velocity-controller.d.ts.map

package/dist/gestures/velocity-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"velocity-controller.d.ts","sourceRoot":"","sources":["../../src/gestures/velocity-controller.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAGhD,oBAAY,YAAY;IACtB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,KAAK,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAS;IAC9B,KAAK,EAAE,YAAY,CAAqB;IACxC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,YAAY,CAAuB;gBAE/B,WAAW,SAAQ,EAAE,aAAa,SAAM;IAKpD,MAAM,CACJ,QAAQ,EAAE,KAAK,GAAG,IAAI,EACtB,UAAU,EAAE,OAAO,EACnB,UAAU,EAAE,OAAO,EACnB,WAAW,EAAE,MAAM,GAClB,cAAc;CAiClB"}

package/dist/gestures/velocity-tracker.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Velocity tracking for smooth scrolling gestures.
+ * Ported from glide/gestures/velocity_tracker.py
+ */
+export interface Vec2D {
+    x: number;
+    y: number;
+}
+export declare function vec2dMagnitude(v: Vec2D): number;
+export declare function vec2dZero(): Vec2D;
+export declare class VelocityTracker {
+    private windowMs;
+    private smoothingFactor;
+    private samples;
+    private lastVelocity;
+    private minSamples;
+    private noiseThreshold;
+    constructor(windowMs?: number, smoothingFactor?: number);
+    update(indexTip: [number, number], middleTip: [number, number], isTouching: boolean, timestampMs: number): Vec2D | null;
+    private _calculateVelocity;
+    reset(): void;
+}
+//# sourceMappingURL=velocity-tracker.d.ts.map

package/dist/gestures/velocity-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"velocity-tracker.d.ts","sourceRoot":"","sources":["../../src/gestures/velocity-tracker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAE/C;AAED,wBAAgB,SAAS,IAAI,KAAK,CAEjC;AAQD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,cAAc,CAAO;gBAEjB,QAAQ,SAAM,EAAE,eAAe,SAAM;IAKjD,MAAM,CACJ,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAC3B,UAAU,EAAE,OAAO,EACnB,WAAW,EAAE,MAAM,GAClB,KAAK,GAAG,IAAI;IAiCf,OAAO,CAAC,kBAAkB;IAkB1B,KAAK,IAAI,IAAI;CAId"}