@viji-dev/core 0.3.13 → 0.3.14

package/dist/artist-global.d.ts

@@ -1,563 +1,559 @@
-declare interface AudioAPI {
-    isConnected: boolean;
-    volume: {
-        current: number;
-        peak: number;
-        smoothed: number;
-    };
-    bands: {
-        low: number;
-        lowMid: number;
-        mid: number;
-        highMid: number;
-        high: number;
-        lowSmoothed: number;
-        lowMidSmoothed: number;
-        midSmoothed: number;
-        highMidSmoothed: number;
-        highSmoothed: number;
-    };
-    beat: {
-        kick: number;
-        snare: number;
-        hat: number;
-        any: number;
-        kickSmoothed: number;
-        snareSmoothed: number;
-        anySmoothed: number;
-        triggers: {
-            any: boolean;
-            kick: boolean;
-            snare: boolean;
-            hat: boolean;
-        };
-        events: Array<{
-            type: 'kick' | 'snare' | 'hat';
-            time: number;
-            strength: number;
-        }>;
-        bpm: number;
-        phase: number;
-        bar: number;
-        confidence: number;
-        isLocked: boolean;
-    };
-    spectral: {
-        brightness: number;
-        flatness: number;
-        flux: number;
-    };
-    getFrequencyData: () => Uint8Array;
-    getWaveform?: (samples?: number) => Float32Array;
-    getFFT?: (bins?: number, scale?: 'linear' | 'log') => Float32Array;
-}
-
-declare interface CaptureFrameOptions {
-    /** Output format: 'blob' for encoded image, 'bitmap' for GPU-friendly ImageBitmap */
-    format?: 'blob' | 'bitmap';
-    /** MIME type for blob output (ignored for bitmap), e.g., 'image/png', 'image/jpeg', 'image/webp' */
-    type?: string;
-    /**
-     * Target resolution.
-     * - number: scale factor relative to current canvas size (e.g., 0.5 = 50%)
-     * - { width, height }: exact output size; if aspect ratio differs from canvas,
-     *   the source is center-cropped to match the target aspect ratio before scaling
-     */
-    resolution?: number | {
-        width: number;
-        height: number;
-    };
-}
-
-declare interface ColorConfig {
-    label: string;
-    description?: string;
-    group?: string;
-    category?: ParameterCategory;
-}
-
-declare interface ColorParameter {
-    value: string;
-    label: string;
-    description?: string;
-    group: string;
-    category: ParameterCategory;
-}
-
-declare type CVFeature = 'faceDetection' | 'faceMesh' | 'handTracking' | 'poseDetection' | 'bodySegmentation';
-
-declare type CVFrameRateMode = 'full' | 'half' | 'quarter' | 'eighth';
-
-declare interface DeviceMotionData {
-    /** Acceleration without gravity (m/s²) */
-    acceleration: {
-        x: number | null;
-        y: number | null;
-        z: number | null;
-    } | null;
-    /** Acceleration including gravity (m/s²) */
-    accelerationIncludingGravity: {
-        x: number | null;
-        y: number | null;
-        z: number | null;
-    } | null;
-    /** Rotation rate (degrees/second) */
-    rotationRate: {
-        alpha: number | null;
-        beta: number | null;
-        gamma: number | null;
-    } | null;
-    /** Interval between updates (milliseconds) */
-    interval: number;
-}
-
-declare interface DeviceOrientationData {
-    /** Rotation around Z-axis (0-360 degrees, compass heading) */
-    alpha: number | null;
-    /** Rotation around X-axis (-180 to 180 degrees, front-to-back tilt) */
-    beta: number | null;
-    /** Rotation around Y-axis (-90 to 90 degrees, left-to-right tilt) */
-    gamma: number | null;
-    /** True if using magnetometer (compass) for absolute orientation */
-    absolute: boolean;
-}
-
-declare interface DeviceSensorState {
-    motion: DeviceMotionData | null;
-    orientation: DeviceOrientationData | null;
-}
-
-declare interface DeviceState extends DeviceSensorState {
-    /** Unique device identifier */
-    id: string;
-    /** User-friendly device name */
-    name: string;
-    /** Device camera video (null if not available) */
-    video: VideoAPI | null;
-}
-
-declare interface FaceData {
-    id: number;
-    bounds: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    confidence: number;
-    landmarks?: {
-        x: number;
-        y: number;
-        z?: number;
-    }[];
-    expressions: {
-        neutral: number;
-        happy: number;
-        sad: number;
-        angry: number;
-        surprised: number;
-        disgusted: number;
-        fearful: number;
-    };
-    headPose: {
-        pitch: number;
-        yaw: number;
-        roll: number;
-    };
-}
-
-declare type FrameRateMode = 'full' | 'half';
-
-declare interface FrequencyBand {
-    name: string;
-    min: number;
-    max: number;
-}
-
-declare interface HandData {
-    id: number;
-    handedness: 'left' | 'right';
-    confidence: number;
-    bounds: {
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    };
-    landmarks: {
-        x: number;
-        y: number;
-        z: number;
-    }[];
-    palm: {
-        x: number;
-        y: number;
-        z: number;
-    };
-    fingers: {
-        thumb: {
-            tip: {
-                x: number;
-                y: number;
-                z: number;
-            };
-            extended: boolean;
-        };
-        index: {
-            tip: {
-                x: number;
-                y: number;
-                z: number;
-            };
-            extended: boolean;
-        };
-        middle: {
-            tip: {
-                x: number;
-                y: number;
-                z: number;
-            };
-            extended: boolean;
-        };
-        ring: {
-            tip: {
-                x: number;
-                y: number;
-                z: number;
-            };
-            extended: boolean;
-        };
-        pinky: {
-            tip: {
-                x: number;
-                y: number;
-                z: number;
-            };
-            extended: boolean;
-        };
-    };
-    gestures: {
-        fist: number;
-        openPalm: number;
-        peace: number;
-        thumbsUp: number;
-        pointing: number;
-    };
-}
-
-declare interface ImageConfig {
-    label: string;
-    description?: string;
-    group?: string;
-    category?: ParameterCategory;
-}
-
-declare interface ImageParameter {
-    value: ImageBitmap | OffscreenCanvas | null;
-    label: string;
-    description?: string;
-    group: string;
-    category: ParameterCategory;
-}
-
-declare interface KeyboardAPI {
-    isPressed(key: string): boolean;
-    wasPressed(key: string): boolean;
-    wasReleased(key: string): boolean;
-    activeKeys: Set<string>;
-    pressedThisFrame: Set<string>;
-    releasedThisFrame: Set<string>;
-    lastKeyPressed: string;
-    lastKeyReleased: string;
-    shift: boolean;
-    ctrl: boolean;
-    alt: boolean;
-    meta: boolean;
-}
-
-declare interface MouseAPI {
-    x: number;
-    y: number;
-    isInCanvas: boolean;
-    isPressed: boolean;
-    leftButton: boolean;
-    rightButton: boolean;
-    middleButton: boolean;
-    velocity: {
-        x: number;
-        y: number;
-    };
-    deltaX: number;
-    deltaY: number;
-    wheelDelta: number;
-    wheelX: number;
-    wheelY: number;
-    wasPressed: boolean;
-    wasReleased: boolean;
-    wasMoved: boolean;
-}
-
-declare interface NumberConfig {
-    min?: number;
-    max?: number;
-    step?: number;
-    label: string;
-    description?: string;
-    group?: string;
-    category?: ParameterCategory;
-}
-
-declare interface NumberParameter {
-    value: number;
-    min: number;
-    max: number;
-    step: number;
-    label: string;
-    description?: string;
-    group: string;
-    category: ParameterCategory;
-}
-
-declare type ParameterCategory = 'audio' | 'video' | 'interaction' | 'general';
-
-declare interface PoseData {
-    confidence: number;
-    landmarks: {
-        x: number;
-        y: number;
-        z: number;
-        visibility: number;
-    }[];
-    face: {
-        x: number;
-        y: number;
-    }[];
-    torso: {
-        x: number;
-        y: number;
-    }[];
-    leftArm: {
-        x: number;
-        y: number;
-    }[];
-    rightArm: {
-        x: number;
-        y: number;
-    }[];
-    leftLeg: {
-        x: number;
-        y: number;
-    }[];
-    rightLeg: {
-        x: number;
-        y: number;
-    }[];
-}
-
-declare type Resolution = {
-    width: number;
-    height: number;
-};
-
-declare interface SegmentationData {
-    mask: Uint8Array;
-    width: number;
-    height: number;
-}
-
-declare interface SelectConfig {
-    options: string[] | number[];
-    label: string;
-    description?: string;
-    group?: string;
-    category?: ParameterCategory;
-}
-
-declare interface SelectParameter {
-    value: string | number;
-    options: string[] | number[];
-    label: string;
-    description?: string;
-    group: string;
-    category: ParameterCategory;
-}
-
-declare interface SliderConfig {
-    min?: number;
-    max?: number;
-    step?: number;
-    label: string;
-    description?: string;
-    group?: string;
-    category?: ParameterCategory;
-}
-
-declare interface SliderParameter {
-    value: number;
-    min: number;
-    max: number;
-    step: number;
-    label: string;
-    description?: string;
-    group: string;
-    category: ParameterCategory;
-}
-
-declare interface TextConfig {
-    label: string;
-    description?: string;
-    group?: string;
-    category?: ParameterCategory;
-    maxLength?: number;
-}
-
-declare interface TextParameter {
-    value: string;
-    maxLength?: number;
-    label: string;
-    description?: string;
-    group: string;
-    category: ParameterCategory;
-}
-
-declare interface ToggleConfig {
-    label: string;
-    description?: string;
-    group?: string;
-    category?: ParameterCategory;
-}
-
-declare interface ToggleParameter {
-    value: boolean;
-    label: string;
-    description?: string;
-    group: string;
-    category: ParameterCategory;
-}
-
-declare interface TouchAPI {
-    points: TouchPoint[];
-    count: number;
-    started: TouchPoint[];
-    moved: TouchPoint[];
-    ended: TouchPoint[];
-    primary: TouchPoint | null;
-    gestures: TouchGestureAPI;
-}
-
-declare interface TouchGestureAPI {
-    isPinching: boolean;
-    isRotating: boolean;
-    isPanning: boolean;
-    isTapping: boolean;
-    pinchScale: number;
-    pinchDelta: number;
-    rotationAngle: number;
-    rotationDelta: number;
-    panDelta: {
-        x: number;
-        y: number;
-    };
-    tapCount: number;
-    lastTapTime: number;
-    tapPosition: {
-        x: number;
-        y: number;
-    } | null;
-}
-
-declare interface TouchPoint {
-    id: number;
-    x: number;
-    y: number;
-    pressure: number;
-    radius: number;
-    radiusX: number;
-    radiusY: number;
-    rotationAngle: number;
-    force: number;
-    deltaX: number;
-    deltaY: number;
-    velocity: {
-        x: number;
-        y: number;
-    };
-    isNew: boolean;
-    isActive: boolean;
-    isEnding: boolean;
-}
-
-declare const VERSION = "0.2.20";
-
-declare interface VideoAPI {
-    isConnected: boolean;
-    currentFrame: OffscreenCanvas | ImageBitmap | null;
-    frameWidth: number;
-    frameHeight: number;
-    frameRate: number;
-    getFrameData: () => ImageData | null;
-    faces: FaceData[];
-    hands: HandData[];
-    pose: PoseData | null;
-    segmentation: SegmentationData | null;
-    cv: {
-        enableFaceDetection(enabled: boolean): Promise<void>;
-        enableFaceMesh(enabled: boolean): Promise<void>;
-        enableHandTracking(enabled: boolean): Promise<void>;
-        enablePoseDetection(enabled: boolean): Promise<void>;
-        enableBodySegmentation(enabled: boolean): Promise<void>;
-        getActiveFeatures(): CVFeature[];
-        isProcessing(): boolean;
-    };
-}
-
-declare interface VijiAPI {
-    canvas: OffscreenCanvas;
-    ctx?: OffscreenCanvasRenderingContext2D;
-    gl?: WebGL2RenderingContext;
-    width: number;
-    height: number;
-    pixelRatio: number;
-    time: number;
-    deltaTime: number;
-    frameCount: number;
-    fps: number;
-    audio: AudioAPI;
-    video: VideoAPI;
-    streams: VideoAPI[];
-    mouse: MouseAPI;
-    keyboard: KeyboardAPI;
-    touches: TouchAPI;
-    device: DeviceSensorState;
-    devices: DeviceState[];
-    slider: (defaultValue: number, config: SliderConfig) => SliderParameter;
-    color: (defaultValue: string, config: ColorConfig) => ColorParameter;
-    toggle: (defaultValue: boolean, config: ToggleConfig) => ToggleParameter;
-    select: (defaultValue: string | number, config: SelectConfig) => SelectParameter;
-    text: (defaultValue: string, config: TextConfig) => TextParameter;
-    number: (defaultValue: number, config: NumberConfig) => NumberParameter;
-    image: (defaultValue: null, config: ImageConfig) => ImageParameter;
-    useContext(type: '2d'): OffscreenCanvasRenderingContext2D;
-    useContext(type: 'webgl'): WebGLRenderingContext | WebGL2RenderingContext;
-}
-
-// Global viji instance
-declare const viji: VijiAPI;
-
-// Type aliases for typed function declarations
-declare type Render = (viji: VijiAPI) => void;
-declare type Setup = (viji: VijiAPI) => void;
-
-// Function declarations
-declare function render(viji: VijiAPI): void;
-declare function setup(viji: VijiAPI): void;
-
-// Module marker (enables top-level await)
-export {};
-
-// Support CDN module imports (esm.sh, unpkg, skypack, jsdelivr, etc.)
-declare module 'https://*' {
-  const mod: any;
-  export default mod;
-  export = mod;
+// Viji Artist API - Global Type Definitions
+// All types are placed inside declare global {} because this file uses export {}
+// for top-level await support, which makes it a module (where top-level declarations
+// would otherwise be module-scoped, not global).
+
+declare global {
+  interface AudioAPI {
+      isConnected: boolean;
+      volume: {
+          current: number;
+          peak: number;
+          smoothed: number;
+      };
+      bands: {
+          low: number;
+          lowMid: number;
+          mid: number;
+          highMid: number;
+          high: number;
+          lowSmoothed: number;
+          lowMidSmoothed: number;
+          midSmoothed: number;
+          highMidSmoothed: number;
+          highSmoothed: number;
+      };
+      beat: {
+          kick: number;
+          snare: number;
+          hat: number;
+          any: number;
+          kickSmoothed: number;
+          snareSmoothed: number;
+          anySmoothed: number;
+          triggers: {
+              any: boolean;
+              kick: boolean;
+              snare: boolean;
+              hat: boolean;
+          };
+          events: Array<{
+              type: 'kick' | 'snare' | 'hat';
+              time: number;
+              strength: number;
+          }>;
+          bpm: number;
+          phase: number;
+          bar: number;
+          confidence: number;
+          isLocked: boolean;
+      };
+      spectral: {
+          brightness: number;
+          flatness: number;
+          flux: number;
+      };
+      getFrequencyData: () => Uint8Array;
+      getWaveform?: (samples?: number) => Float32Array;
+      getFFT?: (bins?: number, scale?: 'linear' | 'log') => Float32Array;
+  }
+
+  interface CaptureFrameOptions {
+      /** Output format: 'blob' for encoded image, 'bitmap' for GPU-friendly ImageBitmap */
+      format?: 'blob' | 'bitmap';
+      /** MIME type for blob output (ignored for bitmap), e.g., 'image/png', 'image/jpeg', 'image/webp' */
+      type?: string;
+      /**
+       * Target resolution.
+       * - number: scale factor relative to current canvas size (e.g., 0.5 = 50%)
+       * - { width, height }: exact output size; if aspect ratio differs from canvas,
+       *   the source is center-cropped to match the target aspect ratio before scaling
+       */
+      resolution?: number | {
+          width: number;
+          height: number;
+      };
+  }
+
+  interface ColorConfig {
+      label: string;
+      description?: string;
+      group?: string;
+      category?: ParameterCategory;
+  }
+
+  interface ColorParameter {
+      value: string;
+      label: string;
+      description?: string;
+      group: string;
+      category: ParameterCategory;
+  }
+
+  type CVFeature = 'faceDetection' | 'faceMesh' | 'handTracking' | 'poseDetection' | 'bodySegmentation';
+
+  type CVFrameRateMode = 'full' | 'half' | 'quarter' | 'eighth';
+
+  interface DeviceMotionData {
+      /** Acceleration without gravity (m/s²) */
+      acceleration: {
+          x: number | null;
+          y: number | null;
+          z: number | null;
+      } | null;
+      /** Acceleration including gravity (m/s²) */
+      accelerationIncludingGravity: {
+          x: number | null;
+          y: number | null;
+          z: number | null;
+      } | null;
+      /** Rotation rate (degrees/second) */
+      rotationRate: {
+          alpha: number | null;
+          beta: number | null;
+          gamma: number | null;
+      } | null;
+      /** Interval between updates (milliseconds) */
+      interval: number;
+  }
+
+  interface DeviceOrientationData {
+      /** Rotation around Z-axis (0-360 degrees, compass heading) */
+      alpha: number | null;
+      /** Rotation around X-axis (-180 to 180 degrees, front-to-back tilt) */
+      beta: number | null;
+      /** Rotation around Y-axis (-90 to 90 degrees, left-to-right tilt) */
+      gamma: number | null;
+      /** True if using magnetometer (compass) for absolute orientation */
+      absolute: boolean;
+  }
+
+  interface DeviceSensorState {
+      motion: DeviceMotionData | null;
+      orientation: DeviceOrientationData | null;
+  }
+
+  interface DeviceState extends DeviceSensorState {
+      /** Unique device identifier */
+      id: string;
+      /** User-friendly device name */
+      name: string;
+      /** Device camera video (null if not available) */
+      video: VideoAPI | null;
+  }
+
+  interface FaceData {
+      id: number;
+      bounds: {
+          x: number;
+          y: number;
+          width: number;
+          height: number;
+      };
+      confidence: number;
+      landmarks?: {
+          x: number;
+          y: number;
+          z?: number;
+      }[];
+      expressions: {
+          neutral: number;
+          happy: number;
+          sad: number;
+          angry: number;
+          surprised: number;
+          disgusted: number;
+          fearful: number;
+      };
+      headPose: {
+          pitch: number;
+          yaw: number;
+          roll: number;
+      };
+  }
+
+  type FrameRateMode = 'full' | 'half';
+
+  interface FrequencyBand {
+      name: string;
+      min: number;
+      max: number;
+  }
+
+  interface HandData {
+      id: number;
+      handedness: 'left' | 'right';
+      confidence: number;
+      bounds: {
+          x: number;
+          y: number;
+          width: number;
+          height: number;
+      };
+      landmarks: {
+          x: number;
+          y: number;
+          z: number;
+      }[];
+      palm: {
+          x: number;
+          y: number;
+          z: number;
+      };
+      fingers: {
+          thumb: {
+              tip: {
+                  x: number;
+                  y: number;
+                  z: number;
+              };
+              extended: boolean;
+          };
+          index: {
+              tip: {
+                  x: number;
+                  y: number;
+                  z: number;
+              };
+              extended: boolean;
+          };
+          middle: {
+              tip: {
+                  x: number;
+                  y: number;
+                  z: number;
+              };
+              extended: boolean;
+          };
+          ring: {
+              tip: {
+                  x: number;
+                  y: number;
+                  z: number;
+              };
+              extended: boolean;
+          };
+          pinky: {
+              tip: {
+                  x: number;
+                  y: number;
+                  z: number;
+              };
+              extended: boolean;
+          };
+      };
+      gestures: {
+          fist: number;
+          openPalm: number;
+          peace: number;
+          thumbsUp: number;
+          pointing: number;
+      };
+  }
+
+  interface ImageConfig {
+      label: string;
+      description?: string;
+      group?: string;
+      category?: ParameterCategory;
+  }
+
+  interface ImageParameter {
+      value: ImageBitmap | OffscreenCanvas | null;
+      label: string;
+      description?: string;
+      group: string;
+      category: ParameterCategory;
+  }
+
+  interface KeyboardAPI {
+      isPressed(key: string): boolean;
+      wasPressed(key: string): boolean;
+      wasReleased(key: string): boolean;
+      activeKeys: Set<string>;
+      pressedThisFrame: Set<string>;
+      releasedThisFrame: Set<string>;
+      lastKeyPressed: string;
+      lastKeyReleased: string;
+      shift: boolean;
+      ctrl: boolean;
+      alt: boolean;
+      meta: boolean;
+  }
+
+  interface MouseAPI {
+      x: number;
+      y: number;
+      isInCanvas: boolean;
+      isPressed: boolean;
+      leftButton: boolean;
+      rightButton: boolean;
+      middleButton: boolean;
+      velocity: {
+          x: number;
+          y: number;
+      };
+      deltaX: number;
+      deltaY: number;
+      wheelDelta: number;
+      wheelX: number;
+      wheelY: number;
+      wasPressed: boolean;
+      wasReleased: boolean;
+      wasMoved: boolean;
+  }
+
+  interface NumberConfig {
+      min?: number;
+      max?: number;
+      step?: number;
+      label: string;
+      description?: string;
+      group?: string;
+      category?: ParameterCategory;
+  }
+
+  interface NumberParameter {
+      value: number;
+      min: number;
+      max: number;
+      step: number;
+      label: string;
+      description?: string;
+      group: string;
+      category: ParameterCategory;
+  }
+
+  type ParameterCategory = 'audio' | 'video' | 'interaction' | 'general';
+
+  interface PoseData {
+      confidence: number;
+      landmarks: {
+          x: number;
+          y: number;
+          z: number;
+          visibility: number;
+      }[];
+      face: {
+          x: number;
+          y: number;
+      }[];
+      torso: {
+          x: number;
+          y: number;
+      }[];
+      leftArm: {
+          x: number;
+          y: number;
+      }[];
+      rightArm: {
+          x: number;
+          y: number;
+      }[];
+      leftLeg: {
+          x: number;
+          y: number;
+      }[];
+      rightLeg: {
+          x: number;
+          y: number;
+      }[];
+  }
+
+  type Resolution = {
+      width: number;
+      height: number;
+  };
+
+  interface SegmentationData {
+      mask: Uint8Array;
+      width: number;
+      height: number;
+  }
+
+  interface SelectConfig {
+      options: string[] | number[];
+      label: string;
+      description?: string;
+      group?: string;
+      category?: ParameterCategory;
+  }
+
+  interface SelectParameter {
+      value: string | number;
+      options: string[] | number[];
+      label: string;
+      description?: string;
+      group: string;
+      category: ParameterCategory;
+  }
+
+  interface SliderConfig {
+      min?: number;
+      max?: number;
+      step?: number;
+      label: string;
+      description?: string;
+      group?: string;
+      category?: ParameterCategory;
+  }
+
+  interface SliderParameter {
+      value: number;
+      min: number;
+      max: number;
+      step: number;
+      label: string;
+      description?: string;
+      group: string;
+      category: ParameterCategory;
+  }
+
+  interface TextConfig {
+      label: string;
+      description?: string;
+      group?: string;
+      category?: ParameterCategory;
+      maxLength?: number;
+  }
+
+  interface TextParameter {
+      value: string;
+      maxLength?: number;
+      label: string;
+      description?: string;
+      group: string;
+      category: ParameterCategory;
+  }
+
+  interface ToggleConfig {
+      label: string;
+      description?: string;
+      group?: string;
+      category?: ParameterCategory;
+  }
+
+  interface ToggleParameter {
+      value: boolean;
+      label: string;
+      description?: string;
+      group: string;
+      category: ParameterCategory;
+  }
+
+  interface TouchAPI {
+      points: TouchPoint[];
+      count: number;
+      started: TouchPoint[];
+      moved: TouchPoint[];
+      ended: TouchPoint[];
+      primary: TouchPoint | null;
+      gestures: TouchGestureAPI;
+  }
+
+  interface TouchGestureAPI {
+      isPinching: boolean;
+      isRotating: boolean;
+      isPanning: boolean;
+      isTapping: boolean;
+      pinchScale: number;
+      pinchDelta: number;
+      rotationAngle: number;
+      rotationDelta: number;
+      panDelta: {
+          x: number;
+          y: number;
+      };
+      tapCount: number;
+      lastTapTime: number;
+      tapPosition: {
+          x: number;
+          y: number;
+      } | null;
+  }
+
+  interface TouchPoint {
+      id: number;
+      x: number;
+      y: number;
+      pressure: number;
+      radius: number;
+      radiusX: number;
+      radiusY: number;
+      rotationAngle: number;
+      force: number;
+      deltaX: number;
+      deltaY: number;
+      velocity: {
+          x: number;
+          y: number;
+      };
+      isNew: boolean;
+      isActive: boolean;
+      isEnding: boolean;
+  }
+
+  const VERSION = "0.2.20";
+
+  interface VideoAPI {
+      isConnected: boolean;
+      currentFrame: OffscreenCanvas | ImageBitmap | null;
+      frameWidth: number;
+      frameHeight: number;
+      frameRate: number;
+      getFrameData: () => ImageData | null;
+      faces: FaceData[];
+      hands: HandData[];
+      pose: PoseData | null;
+      segmentation: SegmentationData | null;
+      cv: {
+          enableFaceDetection(enabled: boolean): Promise<void>;
+          enableFaceMesh(enabled: boolean): Promise<void>;
+          enableHandTracking(enabled: boolean): Promise<void>;
+          enablePoseDetection(enabled: boolean): Promise<void>;
+          enableBodySegmentation(enabled: boolean): Promise<void>;
+          getActiveFeatures(): CVFeature[];
+          isProcessing(): boolean;
+      };
+  }
+
+  interface VijiAPI {
+      canvas: OffscreenCanvas;
+      ctx?: OffscreenCanvasRenderingContext2D;
+      gl?: WebGL2RenderingContext;
+      width: number;
+      height: number;
+      pixelRatio: number;
+      time: number;
+      deltaTime: number;
+      frameCount: number;
+      fps: number;
+      audio: AudioAPI;
+      video: VideoAPI;
+      streams: VideoAPI[];
+      mouse: MouseAPI;
+      keyboard: KeyboardAPI;
+      touches: TouchAPI;
+      device: DeviceSensorState;
+      devices: DeviceState[];
+      slider: (defaultValue: number, config: SliderConfig) => SliderParameter;
+      color: (defaultValue: string, config: ColorConfig) => ColorParameter;
+      toggle: (defaultValue: boolean, config: ToggleConfig) => ToggleParameter;
+      select: (defaultValue: string | number, config: SelectConfig) => SelectParameter;
+      text: (defaultValue: string, config: TextConfig) => TextParameter;
+      number: (defaultValue: number, config: NumberConfig) => NumberParameter;
+      image: (defaultValue: null, config: ImageConfig) => ImageParameter;
+      useContext(type: '2d'): OffscreenCanvasRenderingContext2D;
+      useContext(type: 'webgl'): WebGLRenderingContext | WebGL2RenderingContext;
+  }
+
+  // Runtime global - the main viji object
+  const viji: VijiAPI;
+  
+  // Function type aliases (artists define their own render/setup functions)
+  type Render = (viji: VijiAPI) => void;
+  type Setup = (viji: VijiAPI) => void;
 }
+
+// Module marker (enables top-level await in artist code)
+export {};