@viji-dev/core 0.3.25 → 0.3.26

package/dist/artist-dts-p5.js

@@ -1 +1 @@
-export const artistDtsP5 = "// Viji Artist API - Global Type Definitions\n// All types are placed inside declare global {} because this file uses export {}\n// for top-level await support, which makes it a module (where top-level declarations\n// would otherwise be module-scoped, not global).\n\ndeclare global {\n  interface AudioAPI {\r\n      isConnected: boolean;\r\n      volume: {\r\n          current: number;\r\n          peak: number;\r\n          smoothed: number;\r\n      };\r\n      bands: {\r\n          low: number;\r\n          lowMid: number;\r\n          mid: number;\r\n          highMid: number;\r\n          high: number;\r\n          lowSmoothed: number;\r\n          lowMidSmoothed: number;\r\n          midSmoothed: number;\r\n          highMidSmoothed: number;\r\n          highSmoothed: number;\r\n      };\r\n      beat: {\r\n          kick: number;\r\n          snare: number;\r\n          hat: number;\r\n          any: number;\r\n          kickSmoothed: number;\r\n          snareSmoothed: number;\r\n          hatSmoothed: number;\r\n          anySmoothed: number;\r\n          triggers: {\r\n              any: boolean;\r\n              kick: boolean;\r\n              snare: boolean;\r\n              hat: boolean;\r\n          };\r\n          events: Array<{\r\n              type: 'kick' | 'snare' | 'hat';\r\n              time: number;\r\n              strength: number;\r\n          }>;\r\n          bpm: number;\r\n          confidence: number;\r\n          isLocked: boolean;\r\n      };\r\n      spectral: {\r\n          brightness: number;\r\n          flatness: number;\r\n      };\r\n      getFrequencyData: () => Uint8Array;\r\n      getWaveform: () => Float32Array;\r\n  }\r\n\n  interface ButtonConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ButtonParameter {\r\n      value: boolean;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface CaptureFrameOptions {\r\n      /** Output format: 'blob' for encoded image, 'bitmap' for GPU-friendly ImageBitmap */\r\n      format?: 'blob' | 'bitmap';\r\n      /** MIME type for blob output (ignored for bitmap), e.g., 'image/png', 'image/jpeg', 'image/webp' */\r\n      type?: string;\r\n      /**\r\n       * Target resolution.\r\n       * - number: scale factor relative to current canvas size (e.g., 0.5 = 50%)\r\n       * - { width, height }: exact output size; if aspect ratio differs from canvas,\r\n       *   the source is center-cropped to match the target aspect ratio before scaling\r\n       */\r\n      resolution?: number | {\r\n          width: number;\r\n          height: number;\r\n      };\r\n  }\r\n\n  interface ColorConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ColorParameter {\r\n      value: string;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  type CVFeature = 'faceDetection' | 'faceMesh' | 'handTracking' | 'poseDetection' | 'bodySegmentation' | 'emotionDetection';\r\n\n  type CVFrameRateMode = 'full' | 'half' | 'quarter' | 'eighth';\r\n\n  interface DeviceMotionData {\r\n      /** Acceleration without gravity (m/s²) */\r\n      acceleration: {\r\n          x: number | null;\r\n          y: number | null;\r\n          z: number | null;\r\n      } | null;\r\n      /** Acceleration including gravity (m/s²) */\r\n      accelerationIncludingGravity: {\r\n          x: number | null;\r\n          y: number | null;\r\n          z: number | null;\r\n      } | null;\r\n      /** Rotation rate (degrees/second) */\r\n      rotationRate: {\r\n          alpha: number | null;\r\n          beta: number | null;\r\n          gamma: number | null;\r\n      } | null;\r\n      /** Interval between updates (milliseconds) */\r\n      interval: number;\r\n  }\r\n\n  interface DeviceOrientationData {\r\n      /** Rotation around Z-axis (0-360 degrees, compass heading) */\r\n      alpha: number | null;\r\n      /** Rotation around X-axis (-180 to 180 degrees, front-to-back tilt) */\r\n      beta: number | null;\r\n      /** Rotation around Y-axis (-90 to 90 degrees, left-to-right tilt) */\r\n      gamma: number | null;\r\n      /** True if using magnetometer (compass) for absolute orientation */\r\n      absolute: boolean;\r\n  }\r\n\n  interface DeviceSensorState {\r\n      motion: DeviceMotionData | null;\r\n      orientation: DeviceOrientationData | null;\r\n  }\r\n\n  interface DeviceState extends DeviceSensorState {\r\n      /** Unique device identifier */\r\n      id: string;\r\n      /** User-friendly device name */\r\n      name: string;\r\n      /** Device camera video (null if not available) */\r\n      video: VideoAPI | null;\r\n  }\r\n\n  interface FaceBlendshapes {\r\n      browDownLeft: number;\r\n      browDownRight: number;\r\n      browInnerUp: number;\r\n      browOuterUpLeft: number;\r\n      browOuterUpRight: number;\r\n      cheekPuff: number;\r\n      cheekSquintLeft: number;\r\n      cheekSquintRight: number;\r\n      eyeBlinkLeft: number;\r\n      eyeBlinkRight: number;\r\n      eyeLookDownLeft: number;\r\n      eyeLookDownRight: number;\r\n      eyeLookInLeft: number;\r\n      eyeLookInRight: number;\r\n      eyeLookOutLeft: number;\r\n      eyeLookOutRight: number;\r\n      eyeLookUpLeft: number;\r\n      eyeLookUpRight: number;\r\n      eyeSquintLeft: number;\r\n      eyeSquintRight: number;\r\n      eyeWideLeft: number;\r\n      eyeWideRight: number;\r\n      jawForward: number;\r\n      jawLeft: number;\r\n      jawOpen: number;\r\n      jawRight: number;\r\n      mouthClose: number;\r\n      mouthDimpleLeft: number;\r\n      mouthDimpleRight: number;\r\n      mouthFrownLeft: number;\r\n      mouthFrownRight: number;\r\n      mouthFunnel: number;\r\n      mouthLeft: number;\r\n      mouthLowerDownLeft: number;\r\n      mouthLowerDownRight: number;\r\n      mouthPressLeft: number;\r\n      mouthPressRight: number;\r\n      mouthPucker: number;\r\n      mouthRight: number;\r\n      mouthRollLower: number;\r\n      mouthRollUpper: number;\r\n      mouthShrugLower: number;\r\n      mouthShrugUpper: number;\r\n      mouthSmileLeft: number;\r\n      mouthSmileRight: number;\r\n      mouthStretchLeft: number;\r\n      mouthStretchRight: number;\r\n      mouthUpperUpLeft: number;\r\n      mouthUpperUpRight: number;\r\n      noseSneerLeft: number;\r\n      noseSneerRight: number;\r\n      tongueOut: number;\r\n  }\r\n\n  interface FaceData {\r\n      id: number;\r\n      bounds: {\r\n          x: number;\r\n          y: number;\r\n          width: number;\r\n          height: number;\r\n      };\r\n      center: {\r\n          x: number;\r\n          y: number;\r\n      };\r\n      confidence: number;\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z?: number;\r\n      }[];\r\n      expressions: {\r\n          neutral: number;\r\n          happy: number;\r\n          sad: number;\r\n          angry: number;\r\n          surprised: number;\r\n          disgusted: number;\r\n          fearful: number;\r\n      };\r\n      headPose: {\r\n          pitch: number;\r\n          yaw: number;\r\n          roll: number;\r\n      };\r\n      blendshapes: FaceBlendshapes;\r\n  }\r\n\n  type FrameRateMode = 'full' | 'half';\r\n\n  interface FrequencyBand {\r\n      name: string;\r\n      min: number;\r\n      max: number;\r\n  }\r\n\n  interface HandData {\r\n      id: number;\r\n      handedness: 'left' | 'right';\r\n      confidence: number;\r\n      bounds: {\r\n          x: number;\r\n          y: number;\r\n          width: number;\r\n          height: number;\r\n      };\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n      }[];\r\n      palm: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n      };\r\n      fingers: {\r\n          thumb: {\r\n              tip: {\r\n                  x: number;\r\n                  y: number;\r\n                  z: number;\r\n              };\r\n              extended: boolean;\r\n          };\r\n          index: {\r\n              tip: {\r\n                  x: number;\r\n                  y: number;\r\n                  z: number;\r\n              };\r\n              extended: boolean;\r\n          };\r\n          middle: {\r\n              tip: {\r\n                  x: number;\r\n                  y: number;\r\n                  z: number;\r\n              };\r\n              extended: boolean;\r\n          };\r\n          ring: {\r\n              tip: {\r\n                  x: number;\r\n                  y: number;\r\n                  z: number;\r\n              };\r\n              extended: boolean;\r\n          };\r\n          pinky: {\r\n              tip: {\r\n                  x: number;\r\n                  y: number;\r\n                  z: number;\r\n              };\r\n              extended: boolean;\r\n          };\r\n      };\r\n      gestures: {\r\n          fist: number;\r\n          openPalm: number;\r\n          peace: number;\r\n          thumbsUp: number;\r\n          pointing: number;\r\n      };\r\n  }\r\n\n  interface ImageConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ImageParameter {\r\n      value: ImageBitmap | null;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface KeyboardAPI {\r\n      isPressed(key: string): boolean;\r\n      wasPressed(key: string): boolean;\r\n      wasReleased(key: string): boolean;\r\n      activeKeys: Set<string>;\r\n      pressedThisFrame: Set<string>;\r\n      releasedThisFrame: Set<string>;\r\n      lastKeyPressed: string;\r\n      lastKeyReleased: string;\r\n      shift: boolean;\r\n      ctrl: boolean;\r\n      alt: boolean;\r\n      meta: boolean;\r\n      textureData: Uint8Array;\r\n  }\r\n\n  interface MouseAPI {\r\n      x: number;\r\n      y: number;\r\n      isInCanvas: boolean;\r\n      isPressed: boolean;\r\n      leftButton: boolean;\r\n      rightButton: boolean;\r\n      middleButton: boolean;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      wheelDelta: number;\r\n      wheelX: number;\r\n      wheelY: number;\r\n      wasPressed: boolean;\r\n      wasReleased: boolean;\r\n      wasMoved: boolean;\r\n  }\r\n\n  interface NumberConfig {\r\n      min?: number;\r\n      max?: number;\r\n      step?: number;\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface NumberParameter {\r\n      value: number;\r\n      min: number;\r\n      max: number;\r\n      step: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  type ParameterCategory = 'audio' | 'video' | 'interaction' | 'general';\r\n\n  interface PointerAPI {\r\n      x: number;\r\n      y: number;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      isDown: boolean;\r\n      wasPressed: boolean;\r\n      wasReleased: boolean;\r\n      isInCanvas: boolean;\r\n      type: 'mouse' | 'touch' | 'none';\r\n  }\r\n\n  interface PoseData {\r\n      confidence: number;\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n          visibility: number;\r\n          /**\n         * P5-compatible image object (lazy-loaded, auto-converted from .value)\n         * Only available in P5 renderer mode. Use with p5.image() function.\n         * Example: p5.image(myImage.p5, x, y)\n         */\n        p5?: {\n        canvas: OffscreenCanvas; // P5.js looks for img.canvas || img.elt\n        elt: OffscreenCanvas; // Fallback for compatibility\n        width: number; // Logical width\n        height: number; // Logical height\n      };\n        }[];\r\n      face: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      torso: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      leftArm: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      rightArm: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      leftLeg: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      rightLeg: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n  }\r\n\n  type Resolution = {\r\n      width: number;\r\n      height: number;\r\n  };\r\n\n  interface SegmentationData {\r\n      mask: Uint8Array;\r\n      width: number;\r\n      height: number;\r\n  }\r\n\n  interface SelectConfig {\r\n      options: string[] | number[];\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface SelectParameter {\r\n      value: string | number;\r\n      options: string[] | number[];\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface SliderConfig {\r\n      min?: number;\r\n      max?: number;\r\n      step?: number;\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface SliderParameter {\r\n      value: number;\r\n      min: number;\r\n      max: number;\r\n      step: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface TextConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n      maxLength?: number;\r\n  }\r\n\n  interface TextParameter {\r\n      value: string;\r\n      maxLength?: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface ToggleConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ToggleParameter {\r\n      value: boolean;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface TouchAPI {\r\n      points: TouchPoint[];\r\n      count: number;\r\n      started: TouchPoint[];\r\n      moved: TouchPoint[];\r\n      ended: TouchPoint[];\r\n      primary: TouchPoint | null;\r\n  }\r\n\n  interface TouchPoint {\r\n      id: number;\r\n      x: number;\r\n      y: number;\r\n      pressure: number;\r\n      radius: number;\r\n      radiusX: number;\r\n      radiusY: number;\r\n      rotationAngle: number;\r\n      force: number;\r\n      isInCanvas: boolean;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      velocity: {\r\n          x: number;\r\n          y: number;\r\n      };\r\n      isNew: boolean;\r\n      isActive: boolean;\r\n      isEnding: boolean;\r\n  }\r\n\n  const VERSION = \"0.2.20\";\r\n\n  interface VideoAPI {\r\n      isConnected: boolean;\r\n      currentFrame: OffscreenCanvas | ImageBitmap | null;\r\n      frameWidth: number;\r\n      frameHeight: number;\r\n      frameRate: number;\r\n      getFrameData: () => ImageData | null;\r\n      faces: FaceData[];\r\n      hands: HandData[];\r\n      pose: PoseData | null;\r\n      segmentation: SegmentationData | null;\r\n      cv: {\r\n          enableFaceDetection(enabled: boolean): Promise<void>;\r\n          enableFaceMesh(enabled: boolean): Promise<void>;\r\n          enableEmotionDetection(enabled: boolean): Promise<void>;\r\n          enableHandTracking(enabled: boolean): Promise<void>;\r\n          enablePoseDetection(enabled: boolean): Promise<void>;\r\n          enableBodySegmentation(enabled: boolean): Promise<void>;\r\n          getActiveFeatures(): CVFeature[];\r\n          isProcessing(): boolean;\r\n      };\r\n  }\r\n\n  interface VijiAPI {\r\n      canvas: OffscreenCanvas;\r\n      ctx?: OffscreenCanvasRenderingContext2D;\r\n      gl?: WebGLRenderingContext | WebGL2RenderingContext;\r\n      width: number;\r\n      height: number;\r\n      time: number;\r\n      deltaTime: number;\r\n      frameCount: number;\r\n      fps: number;\r\n      audio: AudioAPI;\r\n      video: VideoAPI;\r\n      streams: VideoAPI[];\r\n      mouse: MouseAPI;\r\n      keyboard: KeyboardAPI;\r\n      touches: TouchAPI;\r\n      pointer: PointerAPI;\r\n      device: DeviceSensorState;\r\n      devices: DeviceState[];\r\n      slider: (defaultValue: number, config: SliderConfig) => SliderParameter;\r\n      color: (defaultValue: string, config: ColorConfig) => ColorParameter;\r\n      toggle: (defaultValue: boolean, config: ToggleConfig) => ToggleParameter;\r\n      select: (defaultValue: string | number, config: SelectConfig) => SelectParameter;\r\n      text: (defaultValue: string, config: TextConfig) => TextParameter;\r\n      number: (defaultValue: number, config: NumberConfig) => NumberParameter;\r\n      image: (defaultValue: null, config: ImageConfig) => ImageParameter;\r\n      button: (config: ButtonConfig) => ButtonParameter;\r\n      useContext(type: '2d'): OffscreenCanvasRenderingContext2D;\r\n      useContext(type: 'webgl'): WebGLRenderingContext;\r\n      useContext(type: 'webgl2'): WebGL2RenderingContext;\r\n  }\r\n\n  // Runtime global - the main viji object\n  const viji: VijiAPI;\n  \n  // Function type aliases (artists define their own render/setup functions)\n  type Render = (viji: VijiAPI) => void;\n  type Setup = (viji: VijiAPI) => void;\n}\n\n// Module marker (enables top-level await in artist code)\nexport {};\n\n\n// ============================================================\n// VIJI + P5.JS HYBRID MODE\n// ============================================================\n// In Viji's P5 renderer, you don't use standard P5 patterns.\n// Instead, you define these Viji-specific functions:\n\n// P5-specific globals (augments the base declare global block)\ndeclare global {\n  // P5 instance type for annotations\n  type p5 = p5;\n  \n  // Type aliases for P5 function signatures (artists define their own functions)\n  /**\n   * P5 render function signature - called every frame\n   * @param viji - Viji API (canvas, audio, video, parameters, etc.)\n   * @param p5 - P5.js instance with all P5 methods\n   */\n  type P5Render = (viji: VijiAPI, p5: p5) => void;\n  \n  /**\n   * P5 setup function signature - called once at initialization\n   * @param viji - Viji API (canvas, audio, video, parameters, etc.)\n   * @param p5 - P5.js instance with all P5 methods\n   */\n  type P5Setup = (viji: VijiAPI, p5: p5) => void;\n}\n\n// ============================================================\n// IMPORTANT NOTES\n// ============================================================\n// - Don't use: new p5(), preload(), draw(), or P5's setup()\n// - Viji manages the P5 instance lifecycle\n// - Access P5 methods through the 'p5' parameter: p5.rect(), p5.fill(), etc.\n// - Access Viji features through the 'viji' parameter: viji.audio, viji.mouse, etc.\n// - Define parameters at the top level (before setup/render functions)\n\n// ============================================================\n// P5.JS TYPES (namespace and instance methods)\n// ============================================================\n// This file was auto-generated. Please do not edit it.\n/// <reference path=\"./src/accessibility/describe.d.ts\" />\n/// <reference path=\"./src/accessibility/outputs.d.ts\" />\n/// <reference path=\"./src/color/creating_reading.d.ts\" />\n/// <reference path=\"./src/color/setting.d.ts\" />\n/// <reference path=\"./src/core/shape/2d_primitives.d.ts\" />\n/// <reference path=\"./src/core/shape/attributes.d.ts\" />\n/// <reference path=\"./src/core/shape/curves.d.ts\" />\n/// <reference path=\"./src/core/shape/vertex.d.ts\" />\n/// <reference path=\"./src/core/constants.d.ts\" />\n/// <reference path=\"./src/core/environment.d.ts\" />\n/// <reference path=\"./src/core/rendering.d.ts\" />\n/// <reference path=\"./src/core/structure.d.ts\" />\n/// <reference path=\"./src/core/transform.d.ts\" />\n/// <reference path=\"./src/data/local_storage.d.ts\" />\n/// <reference path=\"./src/data/p5.TypedDict.d.ts\" />\n/// <reference path=\"./src/dom/dom.d.ts\" />\n/// <reference path=\"./src/events/acceleration.d.ts\" />\n/// <reference path=\"./src/events/keyboard.d.ts\" />\n/// <reference path=\"./src/events/mouse.d.ts\" />\n/// <reference path=\"./src/events/touch.d.ts\" />\n/// <reference path=\"./src/image/image.d.ts\" />\n/// <reference path=\"./src/image/loading_displaying.d.ts\" />\n/// <reference path=\"./src/image/pixels.d.ts\" />\n/// <reference path=\"./src/io/files.d.ts\" />\n/// <reference path=\"./src/math/calculation.d.ts\" />\n/// <reference path=\"./src/math/math.d.ts\" />\n/// <reference path=\"./src/math/noise.d.ts\" />\n/// <reference path=\"./src/math/random.d.ts\" />\n/// <reference path=\"./src/math/trigonometry.d.ts\" />\n/// <reference path=\"./src/typography/attributes.d.ts\" />\n/// <reference path=\"./src/typography/loading_displaying.d.ts\" />\n/// <reference path=\"./src/utilities/array_functions.d.ts\" />\n/// <reference path=\"./src/utilities/conversion.d.ts\" />\n/// <reference path=\"./src/utilities/string_functions.d.ts\" />\n/// <reference path=\"./src/utilities/time_date.d.ts\" />\n/// <reference path=\"./src/webgl/3d_primitives.d.ts\" />\n/// <reference path=\"./src/webgl/interaction.d.ts\" />\n/// <reference path=\"./src/webgl/light.d.ts\" />\n/// <reference path=\"./src/webgl/loading.d.ts\" />\n/// <reference path=\"./src/webgl/material.d.ts\" />\n/// <reference path=\"./src/webgl/p5.Camera.d.ts\" />\n/// <reference path=\"./src/webgl/p5.RendererGL.Immediate.d.ts\" />\n/// <reference path=\"./src/webgl/p5.RendererGL.d.ts\" />\n/// <reference path=\"./src/color/p5.Color.d.ts\" />\n/// <reference path=\"./src/core/p5.Element.d.ts\" />\n/// <reference path=\"./src/core/p5.Graphics.d.ts\" />\n/// <reference path=\"./src/image/p5.Image.d.ts\" />\n/// <reference path=\"./src/io/p5.Table.d.ts\" />\n/// <reference path=\"./src/io/p5.TableRow.d.ts\" />\n/// <reference path=\"./src/io/p5.XML.d.ts\" />\n/// <reference path=\"./src/math/p5.Vector.d.ts\" />\n/// <reference path=\"./src/typography/p5.Font.d.ts\" />\n/// <reference path=\"./src/webgl/p5.Framebuffer.d.ts\" />\n/// <reference path=\"./src/webgl/p5.Geometry.d.ts\" />\n/// <reference path=\"./src/webgl/p5.Shader.d.ts\" />\n/// <reference path=\"./src/core/p5.Renderer.d.ts\" />\n/// <reference path=\"./literals.d.ts\" />\n/// <reference path=\"./constants.d.ts\" />\n= p5;\n\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\ninterface p5 extends p5.p5InstanceExtensions {}\n\ndeclare namespace p5 {\n    type UNKNOWN_P5_CONSTANT = any;\n    // eslint-disable-next-line @typescript-eslint/no-empty-interface\n    interface p5InstanceExtensions {}\n}\n\n";
+export const artistDtsP5 = "// Viji Artist API - Global Type Definitions\n// All types are placed inside declare global {} because this file uses export {}\n// for top-level await support, which makes it a module (where top-level declarations\n// would otherwise be module-scoped, not global).\n\ndeclare global {\n  interface AudioAPI {\r\n      isConnected: boolean;\r\n      volume: {\r\n          current: number;\r\n          peak: number;\r\n          smoothed: number;\r\n      };\r\n      bands: {\r\n          low: number;\r\n          lowMid: number;\r\n          mid: number;\r\n          highMid: number;\r\n          high: number;\r\n          lowSmoothed: number;\r\n          lowMidSmoothed: number;\r\n          midSmoothed: number;\r\n          highMidSmoothed: number;\r\n          highSmoothed: number;\r\n      };\r\n      beat: {\r\n          kick: number;\r\n          snare: number;\r\n          hat: number;\r\n          any: number;\r\n          kickSmoothed: number;\r\n          snareSmoothed: number;\r\n          hatSmoothed: number;\r\n          anySmoothed: number;\r\n          triggers: {\r\n              any: boolean;\r\n              kick: boolean;\r\n              snare: boolean;\r\n              hat: boolean;\r\n          };\r\n          events: Array<{\r\n              type: 'kick' | 'snare' | 'hat';\r\n              time: number;\r\n              strength: number;\r\n          }>;\r\n          bpm: number;\r\n          confidence: number;\r\n          isLocked: boolean;\r\n      };\r\n      spectral: {\r\n          brightness: number;\r\n          flatness: number;\r\n      };\r\n      getFrequencyData: () => Uint8Array;\r\n      getWaveform: () => Float32Array;\r\n  }\r\n\n  interface ButtonConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ButtonParameter {\r\n      value: boolean;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface CaptureFrameOptions {\r\n      /** Output format: 'blob' for encoded image, 'bitmap' for GPU-friendly ImageBitmap */\r\n      format?: 'blob' | 'bitmap';\r\n      /** MIME type for blob output (ignored for bitmap), e.g., 'image/png', 'image/jpeg', 'image/webp' */\r\n      type?: string;\r\n      /**\r\n       * Target resolution.\r\n       * - number: scale factor relative to current canvas size (e.g., 0.5 = 50%)\r\n       * - { width, height }: exact output size; if aspect ratio differs from canvas,\r\n       *   the source is center-cropped to match the target aspect ratio before scaling\r\n       */\r\n      resolution?: number | {\r\n          width: number;\r\n          height: number;\r\n      };\r\n  }\r\n\n  interface ColorConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ColorParameter {\r\n      value: string;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  type CVFeature = 'faceDetection' | 'faceMesh' | 'handTracking' | 'poseDetection' | 'bodySegmentation' | 'emotionDetection';\r\n\n  type CVFrameRateMode = 'full' | 'half' | 'quarter' | 'eighth';\r\n\n  interface DeviceMotionData {\r\n      /** Acceleration without gravity (m/s²) */\r\n      acceleration: {\r\n          x: number | null;\r\n          y: number | null;\r\n          z: number | null;\r\n      } | null;\r\n      /** Acceleration including gravity (m/s²) */\r\n      accelerationIncludingGravity: {\r\n          x: number | null;\r\n          y: number | null;\r\n          z: number | null;\r\n      } | null;\r\n      /** Rotation rate (degrees/second) */\r\n      rotationRate: {\r\n          alpha: number | null;\r\n          beta: number | null;\r\n          gamma: number | null;\r\n      } | null;\r\n      /** Interval between updates (milliseconds) */\r\n      interval: number;\r\n  }\r\n\n  interface DeviceOrientationData {\r\n      /** Rotation around Z-axis (0-360 degrees, compass heading) */\r\n      alpha: number | null;\r\n      /** Rotation around X-axis (-180 to 180 degrees, front-to-back tilt) */\r\n      beta: number | null;\r\n      /** Rotation around Y-axis (-90 to 90 degrees, left-to-right tilt) */\r\n      gamma: number | null;\r\n      /** True if using magnetometer (compass) for absolute orientation */\r\n      absolute: boolean;\r\n  }\r\n\n  interface DeviceSensorState {\r\n      motion: DeviceMotionData | null;\r\n      orientation: DeviceOrientationData | null;\r\n  }\r\n\n  interface DeviceState extends DeviceSensorState {\r\n      /** Unique device identifier */\r\n      id: string;\r\n      /** User-friendly device name */\r\n      name: string;\r\n      /** Device camera video (null if not available) */\r\n      video: VideoAPI | null;\r\n  }\r\n\n  interface FaceBlendshapes {\r\n      browDownLeft: number;\r\n      browDownRight: number;\r\n      browInnerUp: number;\r\n      browOuterUpLeft: number;\r\n      browOuterUpRight: number;\r\n      cheekPuff: number;\r\n      cheekSquintLeft: number;\r\n      cheekSquintRight: number;\r\n      eyeBlinkLeft: number;\r\n      eyeBlinkRight: number;\r\n      eyeLookDownLeft: number;\r\n      eyeLookDownRight: number;\r\n      eyeLookInLeft: number;\r\n      eyeLookInRight: number;\r\n      eyeLookOutLeft: number;\r\n      eyeLookOutRight: number;\r\n      eyeLookUpLeft: number;\r\n      eyeLookUpRight: number;\r\n      eyeSquintLeft: number;\r\n      eyeSquintRight: number;\r\n      eyeWideLeft: number;\r\n      eyeWideRight: number;\r\n      jawForward: number;\r\n      jawLeft: number;\r\n      jawOpen: number;\r\n      jawRight: number;\r\n      mouthClose: number;\r\n      mouthDimpleLeft: number;\r\n      mouthDimpleRight: number;\r\n      mouthFrownLeft: number;\r\n      mouthFrownRight: number;\r\n      mouthFunnel: number;\r\n      mouthLeft: number;\r\n      mouthLowerDownLeft: number;\r\n      mouthLowerDownRight: number;\r\n      mouthPressLeft: number;\r\n      mouthPressRight: number;\r\n      mouthPucker: number;\r\n      mouthRight: number;\r\n      mouthRollLower: number;\r\n      mouthRollUpper: number;\r\n      mouthShrugLower: number;\r\n      mouthShrugUpper: number;\r\n      mouthSmileLeft: number;\r\n      mouthSmileRight: number;\r\n      mouthStretchLeft: number;\r\n      mouthStretchRight: number;\r\n      mouthUpperUpLeft: number;\r\n      mouthUpperUpRight: number;\r\n      noseSneerLeft: number;\r\n      noseSneerRight: number;\r\n      tongueOut: number;\r\n  }\r\n\n  interface FaceData {\r\n      id: number;\r\n      bounds: {\r\n          x: number;\r\n          y: number;\r\n          width: number;\r\n          height: number;\r\n      };\r\n      center: {\r\n          x: number;\r\n          y: number;\r\n      };\r\n      confidence: number;\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z?: number;\r\n      }[];\r\n      expressions: {\r\n          neutral: number;\r\n          happy: number;\r\n          sad: number;\r\n          angry: number;\r\n          surprised: number;\r\n          disgusted: number;\r\n          fearful: number;\r\n      };\r\n      headPose: {\r\n          pitch: number;\r\n          yaw: number;\r\n          roll: number;\r\n      };\r\n      blendshapes: FaceBlendshapes;\r\n  }\r\n\n  type FrameRateMode = 'full' | 'half';\r\n\n  interface FrequencyBand {\r\n      name: string;\r\n      min: number;\r\n      max: number;\r\n  }\r\n\n  interface HandData {\r\n      id: number;\r\n      handedness: 'left' | 'right';\r\n      confidence: number;\r\n      bounds: {\r\n          x: number;\r\n          y: number;\r\n          width: number;\r\n          height: number;\r\n      };\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n      }[];\r\n      palm: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n      };\r\n      gestures: {\r\n          fist: number;\r\n          openPalm: number;\r\n          peace: number;\r\n          thumbsUp: number;\r\n          thumbsDown: number;\r\n          pointing: number;\r\n          iLoveYou: number;\r\n      };\r\n  }\r\n\n  interface ImageConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ImageParameter {\r\n      value: ImageBitmap | null;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface KeyboardAPI {\r\n      isPressed(key: string): boolean;\r\n      wasPressed(key: string): boolean;\r\n      wasReleased(key: string): boolean;\r\n      activeKeys: Set<string>;\r\n      pressedThisFrame: Set<string>;\r\n      releasedThisFrame: Set<string>;\r\n      lastKeyPressed: string;\r\n      lastKeyReleased: string;\r\n      shift: boolean;\r\n      ctrl: boolean;\r\n      alt: boolean;\r\n      meta: boolean;\r\n      textureData: Uint8Array;\r\n  }\r\n\n  interface MouseAPI {\r\n      x: number;\r\n      y: number;\r\n      isInCanvas: boolean;\r\n      isPressed: boolean;\r\n      leftButton: boolean;\r\n      rightButton: boolean;\r\n      middleButton: boolean;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      wheelDelta: number;\r\n      wheelX: number;\r\n      wheelY: number;\r\n      wasPressed: boolean;\r\n      wasReleased: boolean;\r\n      wasMoved: boolean;\r\n  }\r\n\n  interface NumberConfig {\r\n      min?: number;\r\n      max?: number;\r\n      step?: number;\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface NumberParameter {\r\n      value: number;\r\n      min: number;\r\n      max: number;\r\n      step: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  type ParameterCategory = 'audio' | 'video' | 'interaction' | 'general';\r\n\n  interface PointerAPI {\r\n      x: number;\r\n      y: number;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      isDown: boolean;\r\n      wasPressed: boolean;\r\n      wasReleased: boolean;\r\n      isInCanvas: boolean;\r\n      type: 'mouse' | 'touch' | 'none';\r\n  }\r\n\n  interface PoseData {\r\n      confidence: number;\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n          visibility: number;\r\n          /**\n         * P5-compatible image object (lazy-loaded, auto-converted from .value)\n         * Only available in P5 renderer mode. Use with p5.image() function.\n         * Example: p5.image(myImage.p5, x, y)\n         */\n        p5?: {\n        canvas: OffscreenCanvas; // P5.js looks for img.canvas || img.elt\n        elt: OffscreenCanvas; // Fallback for compatibility\n        width: number; // Logical width\n        height: number; // Logical height\n      };\n        }[];\r\n      face: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      torso: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      leftArm: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      rightArm: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      leftLeg: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      rightLeg: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n  }\r\n\n  type Resolution = {\r\n      width: number;\r\n      height: number;\r\n  };\r\n\n  interface SegmentationData {\r\n      mask: Uint8Array;\r\n      width: number;\r\n      height: number;\r\n  }\r\n\n  interface SelectConfig {\r\n      options: string[] | number[];\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface SelectParameter {\r\n      value: string | number;\r\n      options: string[] | number[];\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface SliderConfig {\r\n      min?: number;\r\n      max?: number;\r\n      step?: number;\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface SliderParameter {\r\n      value: number;\r\n      min: number;\r\n      max: number;\r\n      step: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface TextConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n      maxLength?: number;\r\n  }\r\n\n  interface TextParameter {\r\n      value: string;\r\n      maxLength?: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface ToggleConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ToggleParameter {\r\n      value: boolean;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface TouchAPI {\r\n      points: TouchPoint[];\r\n      count: number;\r\n      started: TouchPoint[];\r\n      moved: TouchPoint[];\r\n      ended: TouchPoint[];\r\n      primary: TouchPoint | null;\r\n  }\r\n\n  interface TouchPoint {\r\n      id: number;\r\n      x: number;\r\n      y: number;\r\n      pressure: number;\r\n      radius: number;\r\n      radiusX: number;\r\n      radiusY: number;\r\n      rotationAngle: number;\r\n      force: number;\r\n      isInCanvas: boolean;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      velocity: {\r\n          x: number;\r\n          y: number;\r\n      };\r\n      isNew: boolean;\r\n      isActive: boolean;\r\n      isEnding: boolean;\r\n  }\r\n\n  const VERSION = \"0.2.20\";\r\n\n  interface VideoAPI {\r\n      isConnected: boolean;\r\n      currentFrame: OffscreenCanvas | ImageBitmap | null;\r\n      frameWidth: number;\r\n      frameHeight: number;\r\n      frameRate: number;\r\n      getFrameData: () => ImageData | null;\r\n      faces: FaceData[];\r\n      hands: HandData[];\r\n      pose: PoseData | null;\r\n      segmentation: SegmentationData | null;\r\n      cv: {\r\n          enableFaceDetection(enabled: boolean): Promise<void>;\r\n          enableFaceMesh(enabled: boolean): Promise<void>;\r\n          enableEmotionDetection(enabled: boolean): Promise<void>;\r\n          enableHandTracking(enabled: boolean): Promise<void>;\r\n          enablePoseDetection(enabled: boolean): Promise<void>;\r\n          enableBodySegmentation(enabled: boolean): Promise<void>;\r\n          getActiveFeatures(): CVFeature[];\r\n          isProcessing(): boolean;\r\n      };\r\n  }\r\n\n  interface VijiAPI {\r\n      canvas: OffscreenCanvas;\r\n      ctx?: OffscreenCanvasRenderingContext2D;\r\n      gl?: WebGLRenderingContext | WebGL2RenderingContext;\r\n      width: number;\r\n      height: number;\r\n      time: number;\r\n      deltaTime: number;\r\n      frameCount: number;\r\n      fps: number;\r\n      audio: AudioAPI;\r\n      video: VideoAPI;\r\n      streams: VideoAPI[];\r\n      mouse: MouseAPI;\r\n      keyboard: KeyboardAPI;\r\n      touches: TouchAPI;\r\n      pointer: PointerAPI;\r\n      device: DeviceSensorState;\r\n      devices: DeviceState[];\r\n      slider: (defaultValue: number, config: SliderConfig) => SliderParameter;\r\n      color: (defaultValue: string, config: ColorConfig) => ColorParameter;\r\n      toggle: (defaultValue: boolean, config: ToggleConfig) => ToggleParameter;\r\n      select: (defaultValue: string | number, config: SelectConfig) => SelectParameter;\r\n      text: (defaultValue: string, config: TextConfig) => TextParameter;\r\n      number: (defaultValue: number, config: NumberConfig) => NumberParameter;\r\n      image: (defaultValue: null, config: ImageConfig) => ImageParameter;\r\n      button: (config: ButtonConfig) => ButtonParameter;\r\n      useContext(type: '2d'): OffscreenCanvasRenderingContext2D;\r\n      useContext(type: 'webgl'): WebGLRenderingContext;\r\n      useContext(type: 'webgl2'): WebGL2RenderingContext;\r\n  }\r\n\n  // Runtime global - the main viji object\n  const viji: VijiAPI;\n  \n  // Function type aliases (artists define their own render/setup functions)\n  type Render = (viji: VijiAPI) => void;\n  type Setup = (viji: VijiAPI) => void;\n}\n\n// Module marker (enables top-level await in artist code)\nexport {};\n\n\n// ============================================================\n// VIJI + P5.JS HYBRID MODE\n// ============================================================\n// In Viji's P5 renderer, you don't use standard P5 patterns.\n// Instead, you define these Viji-specific functions:\n\n// P5-specific globals (augments the base declare global block)\ndeclare global {\n  // P5 instance type for annotations\n  type p5 = p5;\n  \n  // Type aliases for P5 function signatures (artists define their own functions)\n  /**\n   * P5 render function signature - called every frame\n   * @param viji - Viji API (canvas, audio, video, parameters, etc.)\n   * @param p5 - P5.js instance with all P5 methods\n   */\n  type P5Render = (viji: VijiAPI, p5: p5) => void;\n  \n  /**\n   * P5 setup function signature - called once at initialization\n   * @param viji - Viji API (canvas, audio, video, parameters, etc.)\n   * @param p5 - P5.js instance with all P5 methods\n   */\n  type P5Setup = (viji: VijiAPI, p5: p5) => void;\n}\n\n// ============================================================\n// IMPORTANT NOTES\n// ============================================================\n// - Don't use: new p5(), preload(), draw(), or P5's setup()\n// - Viji manages the P5 instance lifecycle\n// - Access P5 methods through the 'p5' parameter: p5.rect(), p5.fill(), etc.\n// - Access Viji features through the 'viji' parameter: viji.audio, viji.mouse, etc.\n// - Define parameters at the top level (before setup/render functions)\n\n// ============================================================\n// P5.JS TYPES (namespace and instance methods)\n// ============================================================\n// This file was auto-generated. Please do not edit it.\n/// <reference path=\"./src/accessibility/describe.d.ts\" />\n/// <reference path=\"./src/accessibility/outputs.d.ts\" />\n/// <reference path=\"./src/color/creating_reading.d.ts\" />\n/// <reference path=\"./src/color/setting.d.ts\" />\n/// <reference path=\"./src/core/shape/2d_primitives.d.ts\" />\n/// <reference path=\"./src/core/shape/attributes.d.ts\" />\n/// <reference path=\"./src/core/shape/curves.d.ts\" />\n/// <reference path=\"./src/core/shape/vertex.d.ts\" />\n/// <reference path=\"./src/core/constants.d.ts\" />\n/// <reference path=\"./src/core/environment.d.ts\" />\n/// <reference path=\"./src/core/rendering.d.ts\" />\n/// <reference path=\"./src/core/structure.d.ts\" />\n/// <reference path=\"./src/core/transform.d.ts\" />\n/// <reference path=\"./src/data/local_storage.d.ts\" />\n/// <reference path=\"./src/data/p5.TypedDict.d.ts\" />\n/// <reference path=\"./src/dom/dom.d.ts\" />\n/// <reference path=\"./src/events/acceleration.d.ts\" />\n/// <reference path=\"./src/events/keyboard.d.ts\" />\n/// <reference path=\"./src/events/mouse.d.ts\" />\n/// <reference path=\"./src/events/touch.d.ts\" />\n/// <reference path=\"./src/image/image.d.ts\" />\n/// <reference path=\"./src/image/loading_displaying.d.ts\" />\n/// <reference path=\"./src/image/pixels.d.ts\" />\n/// <reference path=\"./src/io/files.d.ts\" />\n/// <reference path=\"./src/math/calculation.d.ts\" />\n/// <reference path=\"./src/math/math.d.ts\" />\n/// <reference path=\"./src/math/noise.d.ts\" />\n/// <reference path=\"./src/math/random.d.ts\" />\n/// <reference path=\"./src/math/trigonometry.d.ts\" />\n/// <reference path=\"./src/typography/attributes.d.ts\" />\n/// <reference path=\"./src/typography/loading_displaying.d.ts\" />\n/// <reference path=\"./src/utilities/array_functions.d.ts\" />\n/// <reference path=\"./src/utilities/conversion.d.ts\" />\n/// <reference path=\"./src/utilities/string_functions.d.ts\" />\n/// <reference path=\"./src/utilities/time_date.d.ts\" />\n/// <reference path=\"./src/webgl/3d_primitives.d.ts\" />\n/// <reference path=\"./src/webgl/interaction.d.ts\" />\n/// <reference path=\"./src/webgl/light.d.ts\" />\n/// <reference path=\"./src/webgl/loading.d.ts\" />\n/// <reference path=\"./src/webgl/material.d.ts\" />\n/// <reference path=\"./src/webgl/p5.Camera.d.ts\" />\n/// <reference path=\"./src/webgl/p5.RendererGL.Immediate.d.ts\" />\n/// <reference path=\"./src/webgl/p5.RendererGL.d.ts\" />\n/// <reference path=\"./src/color/p5.Color.d.ts\" />\n/// <reference path=\"./src/core/p5.Element.d.ts\" />\n/// <reference path=\"./src/core/p5.Graphics.d.ts\" />\n/// <reference path=\"./src/image/p5.Image.d.ts\" />\n/// <reference path=\"./src/io/p5.Table.d.ts\" />\n/// <reference path=\"./src/io/p5.TableRow.d.ts\" />\n/// <reference path=\"./src/io/p5.XML.d.ts\" />\n/// <reference path=\"./src/math/p5.Vector.d.ts\" />\n/// <reference path=\"./src/typography/p5.Font.d.ts\" />\n/// <reference path=\"./src/webgl/p5.Framebuffer.d.ts\" />\n/// <reference path=\"./src/webgl/p5.Geometry.d.ts\" />\n/// <reference path=\"./src/webgl/p5.Shader.d.ts\" />\n/// <reference path=\"./src/core/p5.Renderer.d.ts\" />\n/// <reference path=\"./literals.d.ts\" />\n/// <reference path=\"./constants.d.ts\" />\n= p5;\n\n// eslint-disable-next-line @typescript-eslint/no-empty-interface\ninterface p5 extends p5.p5InstanceExtensions {}\n\ndeclare namespace p5 {\n    type UNKNOWN_P5_CONSTANT = any;\n    // eslint-disable-next-line @typescript-eslint/no-empty-interface\n    interface p5InstanceExtensions {}\n}\n\n";

package/dist/artist-dts.js

@@ -1 +1 @@
-export const artistDts = "// Viji Artist API - Global Type Definitions\n// All types are placed inside declare global {} because this file uses export {}\n// for top-level await support, which makes it a module (where top-level declarations\n// would otherwise be module-scoped, not global).\n\ndeclare global {\n  interface AudioAPI {\r\n      isConnected: boolean;\r\n      volume: {\r\n          current: number;\r\n          peak: number;\r\n          smoothed: number;\r\n      };\r\n      bands: {\r\n          low: number;\r\n          lowMid: number;\r\n          mid: number;\r\n          highMid: number;\r\n          high: number;\r\n          lowSmoothed: number;\r\n          lowMidSmoothed: number;\r\n          midSmoothed: number;\r\n          highMidSmoothed: number;\r\n          highSmoothed: number;\r\n      };\r\n      beat: {\r\n          kick: number;\r\n          snare: number;\r\n          hat: number;\r\n          any: number;\r\n          kickSmoothed: number;\r\n          snareSmoothed: number;\r\n          hatSmoothed: number;\r\n          anySmoothed: number;\r\n          triggers: {\r\n              any: boolean;\r\n              kick: boolean;\r\n              snare: boolean;\r\n              hat: boolean;\r\n          };\r\n          events: Array<{\r\n              type: 'kick' | 'snare' | 'hat';\r\n              time: number;\r\n              strength: number;\r\n          }>;\r\n          bpm: number;\r\n          confidence: number;\r\n          isLocked: boolean;\r\n      };\r\n      spectral: {\r\n          brightness: number;\r\n          flatness: number;\r\n      };\r\n      getFrequencyData: () => Uint8Array;\r\n      getWaveform: () => Float32Array;\r\n  }\r\n\n  interface ButtonConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ButtonParameter {\r\n      value: boolean;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface CaptureFrameOptions {\r\n      /** Output format: 'blob' for encoded image, 'bitmap' for GPU-friendly ImageBitmap */\r\n      format?: 'blob' | 'bitmap';\r\n      /** MIME type for blob output (ignored for bitmap), e.g., 'image/png', 'image/jpeg', 'image/webp' */\r\n      type?: string;\r\n      /**\r\n       * Target resolution.\r\n       * - number: scale factor relative to current canvas size (e.g., 0.5 = 50%)\r\n       * - { width, height }: exact output size; if aspect ratio differs from canvas,\r\n       *   the source is center-cropped to match the target aspect ratio before scaling\r\n       */\r\n      resolution?: number | {\r\n          width: number;\r\n          height: number;\r\n      };\r\n  }\r\n\n  interface ColorConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ColorParameter {\r\n      value: string;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  type CVFeature = 'faceDetection' | 'faceMesh' | 'handTracking' | 'poseDetection' | 'bodySegmentation' | 'emotionDetection';\r\n\n  type CVFrameRateMode = 'full' | 'half' | 'quarter' | 'eighth';\r\n\n  interface DeviceMotionData {\r\n      /** Acceleration without gravity (m/s²) */\r\n      acceleration: {\r\n          x: number | null;\r\n          y: number | null;\r\n          z: number | null;\r\n      } | null;\r\n      /** Acceleration including gravity (m/s²) */\r\n      accelerationIncludingGravity: {\r\n          x: number | null;\r\n          y: number | null;\r\n          z: number | null;\r\n      } | null;\r\n      /** Rotation rate (degrees/second) */\r\n      rotationRate: {\r\n          alpha: number | null;\r\n          beta: number | null;\r\n          gamma: number | null;\r\n      } | null;\r\n      /** Interval between updates (milliseconds) */\r\n      interval: number;\r\n  }\r\n\n  interface DeviceOrientationData {\r\n      /** Rotation around Z-axis (0-360 degrees, compass heading) */\r\n      alpha: number | null;\r\n      /** Rotation around X-axis (-180 to 180 degrees, front-to-back tilt) */\r\n      beta: number | null;\r\n      /** Rotation around Y-axis (-90 to 90 degrees, left-to-right tilt) */\r\n      gamma: number | null;\r\n      /** True if using magnetometer (compass) for absolute orientation */\r\n      absolute: boolean;\r\n  }\r\n\n  interface DeviceSensorState {\r\n      motion: DeviceMotionData | null;\r\n      orientation: DeviceOrientationData | null;\r\n  }\r\n\n  interface DeviceState extends DeviceSensorState {\r\n      /** Unique device identifier */\r\n      id: string;\r\n      /** User-friendly device name */\r\n      name: string;\r\n      /** Device camera video (null if not available) */\r\n      video: VideoAPI | null;\r\n  }\r\n\n  interface FaceBlendshapes {\r\n      browDownLeft: number;\r\n      browDownRight: number;\r\n      browInnerUp: number;\r\n      browOuterUpLeft: number;\r\n      browOuterUpRight: number;\r\n      cheekPuff: number;\r\n      cheekSquintLeft: number;\r\n      cheekSquintRight: number;\r\n      eyeBlinkLeft: number;\r\n      eyeBlinkRight: number;\r\n      eyeLookDownLeft: number;\r\n      eyeLookDownRight: number;\r\n      eyeLookInLeft: number;\r\n      eyeLookInRight: number;\r\n      eyeLookOutLeft: number;\r\n      eyeLookOutRight: number;\r\n      eyeLookUpLeft: number;\r\n      eyeLookUpRight: number;\r\n      eyeSquintLeft: number;\r\n      eyeSquintRight: number;\r\n      eyeWideLeft: number;\r\n      eyeWideRight: number;\r\n      jawForward: number;\r\n      jawLeft: number;\r\n      jawOpen: number;\r\n      jawRight: number;\r\n      mouthClose: number;\r\n      mouthDimpleLeft: number;\r\n      mouthDimpleRight: number;\r\n      mouthFrownLeft: number;\r\n      mouthFrownRight: number;\r\n      mouthFunnel: number;\r\n      mouthLeft: number;\r\n      mouthLowerDownLeft: number;\r\n      mouthLowerDownRight: number;\r\n      mouthPressLeft: number;\r\n      mouthPressRight: number;\r\n      mouthPucker: number;\r\n      mouthRight: number;\r\n      mouthRollLower: number;\r\n      mouthRollUpper: number;\r\n      mouthShrugLower: number;\r\n      mouthShrugUpper: number;\r\n      mouthSmileLeft: number;\r\n      mouthSmileRight: number;\r\n      mouthStretchLeft: number;\r\n      mouthStretchRight: number;\r\n      mouthUpperUpLeft: number;\r\n      mouthUpperUpRight: number;\r\n      noseSneerLeft: number;\r\n      noseSneerRight: number;\r\n      tongueOut: number;\r\n  }\r\n\n  interface FaceData {\r\n      id: number;\r\n      bounds: {\r\n          x: number;\r\n          y: number;\r\n          width: number;\r\n          height: number;\r\n      };\r\n      center: {\r\n          x: number;\r\n          y: number;\r\n      };\r\n      confidence: number;\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z?: number;\r\n      }[];\r\n      expressions: {\r\n          neutral: number;\r\n          happy: number;\r\n          sad: number;\r\n          angry: number;\r\n          surprised: number;\r\n          disgusted: number;\r\n          fearful: number;\r\n      };\r\n      headPose: {\r\n          pitch: number;\r\n          yaw: number;\r\n          roll: number;\r\n      };\r\n      blendshapes: FaceBlendshapes;\r\n  }\r\n\n  type FrameRateMode = 'full' | 'half';\r\n\n  interface FrequencyBand {\r\n      name: string;\r\n      min: number;\r\n      max: number;\r\n  }\r\n\n  interface HandData {\r\n      id: number;\r\n      handedness: 'left' | 'right';\r\n      confidence: number;\r\n      bounds: {\r\n          x: number;\r\n          y: number;\r\n          width: number;\r\n          height: number;\r\n      };\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n      }[];\r\n      palm: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n      };\r\n      fingers: {\r\n          thumb: {\r\n              tip: {\r\n                  x: number;\r\n                  y: number;\r\n                  z: number;\r\n              };\r\n              extended: boolean;\r\n          };\r\n          index: {\r\n              tip: {\r\n                  x: number;\r\n                  y: number;\r\n                  z: number;\r\n              };\r\n              extended: boolean;\r\n          };\r\n          middle: {\r\n              tip: {\r\n                  x: number;\r\n                  y: number;\r\n                  z: number;\r\n              };\r\n              extended: boolean;\r\n          };\r\n          ring: {\r\n              tip: {\r\n                  x: number;\r\n                  y: number;\r\n                  z: number;\r\n              };\r\n              extended: boolean;\r\n          };\r\n          pinky: {\r\n              tip: {\r\n                  x: number;\r\n                  y: number;\r\n                  z: number;\r\n              };\r\n              extended: boolean;\r\n          };\r\n      };\r\n      gestures: {\r\n          fist: number;\r\n          openPalm: number;\r\n          peace: number;\r\n          thumbsUp: number;\r\n          pointing: number;\r\n      };\r\n  }\r\n\n  interface ImageConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ImageParameter {\r\n      value: ImageBitmap | null;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface KeyboardAPI {\r\n      isPressed(key: string): boolean;\r\n      wasPressed(key: string): boolean;\r\n      wasReleased(key: string): boolean;\r\n      activeKeys: Set<string>;\r\n      pressedThisFrame: Set<string>;\r\n      releasedThisFrame: Set<string>;\r\n      lastKeyPressed: string;\r\n      lastKeyReleased: string;\r\n      shift: boolean;\r\n      ctrl: boolean;\r\n      alt: boolean;\r\n      meta: boolean;\r\n      textureData: Uint8Array;\r\n  }\r\n\n  interface MouseAPI {\r\n      x: number;\r\n      y: number;\r\n      isInCanvas: boolean;\r\n      isPressed: boolean;\r\n      leftButton: boolean;\r\n      rightButton: boolean;\r\n      middleButton: boolean;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      wheelDelta: number;\r\n      wheelX: number;\r\n      wheelY: number;\r\n      wasPressed: boolean;\r\n      wasReleased: boolean;\r\n      wasMoved: boolean;\r\n  }\r\n\n  interface NumberConfig {\r\n      min?: number;\r\n      max?: number;\r\n      step?: number;\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface NumberParameter {\r\n      value: number;\r\n      min: number;\r\n      max: number;\r\n      step: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  type ParameterCategory = 'audio' | 'video' | 'interaction' | 'general';\r\n\n  interface PointerAPI {\r\n      x: number;\r\n      y: number;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      isDown: boolean;\r\n      wasPressed: boolean;\r\n      wasReleased: boolean;\r\n      isInCanvas: boolean;\r\n      type: 'mouse' | 'touch' | 'none';\r\n  }\r\n\n  interface PoseData {\r\n      confidence: number;\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n          visibility: number;\r\n      }[];\r\n      face: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      torso: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      leftArm: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      rightArm: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      leftLeg: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      rightLeg: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n  }\r\n\n  type Resolution = {\r\n      width: number;\r\n      height: number;\r\n  };\r\n\n  interface SegmentationData {\r\n      mask: Uint8Array;\r\n      width: number;\r\n      height: number;\r\n  }\r\n\n  interface SelectConfig {\r\n      options: string[] | number[];\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface SelectParameter {\r\n      value: string | number;\r\n      options: string[] | number[];\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface SliderConfig {\r\n      min?: number;\r\n      max?: number;\r\n      step?: number;\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface SliderParameter {\r\n      value: number;\r\n      min: number;\r\n      max: number;\r\n      step: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface TextConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n      maxLength?: number;\r\n  }\r\n\n  interface TextParameter {\r\n      value: string;\r\n      maxLength?: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface ToggleConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ToggleParameter {\r\n      value: boolean;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface TouchAPI {\r\n      points: TouchPoint[];\r\n      count: number;\r\n      started: TouchPoint[];\r\n      moved: TouchPoint[];\r\n      ended: TouchPoint[];\r\n      primary: TouchPoint | null;\r\n  }\r\n\n  interface TouchPoint {\r\n      id: number;\r\n      x: number;\r\n      y: number;\r\n      pressure: number;\r\n      radius: number;\r\n      radiusX: number;\r\n      radiusY: number;\r\n      rotationAngle: number;\r\n      force: number;\r\n      isInCanvas: boolean;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      velocity: {\r\n          x: number;\r\n          y: number;\r\n      };\r\n      isNew: boolean;\r\n      isActive: boolean;\r\n      isEnding: boolean;\r\n  }\r\n\n  const VERSION = \"0.2.20\";\r\n\n  interface VideoAPI {\r\n      isConnected: boolean;\r\n      currentFrame: OffscreenCanvas | ImageBitmap | null;\r\n      frameWidth: number;\r\n      frameHeight: number;\r\n      frameRate: number;\r\n      getFrameData: () => ImageData | null;\r\n      faces: FaceData[];\r\n      hands: HandData[];\r\n      pose: PoseData | null;\r\n      segmentation: SegmentationData | null;\r\n      cv: {\r\n          enableFaceDetection(enabled: boolean): Promise<void>;\r\n          enableFaceMesh(enabled: boolean): Promise<void>;\r\n          enableEmotionDetection(enabled: boolean): Promise<void>;\r\n          enableHandTracking(enabled: boolean): Promise<void>;\r\n          enablePoseDetection(enabled: boolean): Promise<void>;\r\n          enableBodySegmentation(enabled: boolean): Promise<void>;\r\n          getActiveFeatures(): CVFeature[];\r\n          isProcessing(): boolean;\r\n      };\r\n  }\r\n\n  interface VijiAPI {\r\n      canvas: OffscreenCanvas;\r\n      ctx?: OffscreenCanvasRenderingContext2D;\r\n      gl?: WebGLRenderingContext | WebGL2RenderingContext;\r\n      width: number;\r\n      height: number;\r\n      time: number;\r\n      deltaTime: number;\r\n      frameCount: number;\r\n      fps: number;\r\n      audio: AudioAPI;\r\n      video: VideoAPI;\r\n      streams: VideoAPI[];\r\n      mouse: MouseAPI;\r\n      keyboard: KeyboardAPI;\r\n      touches: TouchAPI;\r\n      pointer: PointerAPI;\r\n      device: DeviceSensorState;\r\n      devices: DeviceState[];\r\n      slider: (defaultValue: number, config: SliderConfig) => SliderParameter;\r\n      color: (defaultValue: string, config: ColorConfig) => ColorParameter;\r\n      toggle: (defaultValue: boolean, config: ToggleConfig) => ToggleParameter;\r\n      select: (defaultValue: string | number, config: SelectConfig) => SelectParameter;\r\n      text: (defaultValue: string, config: TextConfig) => TextParameter;\r\n      number: (defaultValue: number, config: NumberConfig) => NumberParameter;\r\n      image: (defaultValue: null, config: ImageConfig) => ImageParameter;\r\n      button: (config: ButtonConfig) => ButtonParameter;\r\n      useContext(type: '2d'): OffscreenCanvasRenderingContext2D;\r\n      useContext(type: 'webgl'): WebGLRenderingContext;\r\n      useContext(type: 'webgl2'): WebGL2RenderingContext;\r\n  }\r\n\n  // Runtime global - the main viji object\n  const viji: VijiAPI;\n  \n  // Function type aliases (artists define their own render/setup functions)\n  type Render = (viji: VijiAPI) => void;\n  type Setup = (viji: VijiAPI) => void;\n}\n\n// Module marker (enables top-level await in artist code)\nexport {};\n";
+export const artistDts = "// Viji Artist API - Global Type Definitions\n// All types are placed inside declare global {} because this file uses export {}\n// for top-level await support, which makes it a module (where top-level declarations\n// would otherwise be module-scoped, not global).\n\ndeclare global {\n  interface AudioAPI {\r\n      isConnected: boolean;\r\n      volume: {\r\n          current: number;\r\n          peak: number;\r\n          smoothed: number;\r\n      };\r\n      bands: {\r\n          low: number;\r\n          lowMid: number;\r\n          mid: number;\r\n          highMid: number;\r\n          high: number;\r\n          lowSmoothed: number;\r\n          lowMidSmoothed: number;\r\n          midSmoothed: number;\r\n          highMidSmoothed: number;\r\n          highSmoothed: number;\r\n      };\r\n      beat: {\r\n          kick: number;\r\n          snare: number;\r\n          hat: number;\r\n          any: number;\r\n          kickSmoothed: number;\r\n          snareSmoothed: number;\r\n          hatSmoothed: number;\r\n          anySmoothed: number;\r\n          triggers: {\r\n              any: boolean;\r\n              kick: boolean;\r\n              snare: boolean;\r\n              hat: boolean;\r\n          };\r\n          events: Array<{\r\n              type: 'kick' | 'snare' | 'hat';\r\n              time: number;\r\n              strength: number;\r\n          }>;\r\n          bpm: number;\r\n          confidence: number;\r\n          isLocked: boolean;\r\n      };\r\n      spectral: {\r\n          brightness: number;\r\n          flatness: number;\r\n      };\r\n      getFrequencyData: () => Uint8Array;\r\n      getWaveform: () => Float32Array;\r\n  }\r\n\n  interface ButtonConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ButtonParameter {\r\n      value: boolean;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface CaptureFrameOptions {\r\n      /** Output format: 'blob' for encoded image, 'bitmap' for GPU-friendly ImageBitmap */\r\n      format?: 'blob' | 'bitmap';\r\n      /** MIME type for blob output (ignored for bitmap), e.g., 'image/png', 'image/jpeg', 'image/webp' */\r\n      type?: string;\r\n      /**\r\n       * Target resolution.\r\n       * - number: scale factor relative to current canvas size (e.g., 0.5 = 50%)\r\n       * - { width, height }: exact output size; if aspect ratio differs from canvas,\r\n       *   the source is center-cropped to match the target aspect ratio before scaling\r\n       */\r\n      resolution?: number | {\r\n          width: number;\r\n          height: number;\r\n      };\r\n  }\r\n\n  interface ColorConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ColorParameter {\r\n      value: string;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  type CVFeature = 'faceDetection' | 'faceMesh' | 'handTracking' | 'poseDetection' | 'bodySegmentation' | 'emotionDetection';\r\n\n  type CVFrameRateMode = 'full' | 'half' | 'quarter' | 'eighth';\r\n\n  interface DeviceMotionData {\r\n      /** Acceleration without gravity (m/s²) */\r\n      acceleration: {\r\n          x: number | null;\r\n          y: number | null;\r\n          z: number | null;\r\n      } | null;\r\n      /** Acceleration including gravity (m/s²) */\r\n      accelerationIncludingGravity: {\r\n          x: number | null;\r\n          y: number | null;\r\n          z: number | null;\r\n      } | null;\r\n      /** Rotation rate (degrees/second) */\r\n      rotationRate: {\r\n          alpha: number | null;\r\n          beta: number | null;\r\n          gamma: number | null;\r\n      } | null;\r\n      /** Interval between updates (milliseconds) */\r\n      interval: number;\r\n  }\r\n\n  interface DeviceOrientationData {\r\n      /** Rotation around Z-axis (0-360 degrees, compass heading) */\r\n      alpha: number | null;\r\n      /** Rotation around X-axis (-180 to 180 degrees, front-to-back tilt) */\r\n      beta: number | null;\r\n      /** Rotation around Y-axis (-90 to 90 degrees, left-to-right tilt) */\r\n      gamma: number | null;\r\n      /** True if using magnetometer (compass) for absolute orientation */\r\n      absolute: boolean;\r\n  }\r\n\n  interface DeviceSensorState {\r\n      motion: DeviceMotionData | null;\r\n      orientation: DeviceOrientationData | null;\r\n  }\r\n\n  interface DeviceState extends DeviceSensorState {\r\n      /** Unique device identifier */\r\n      id: string;\r\n      /** User-friendly device name */\r\n      name: string;\r\n      /** Device camera video (null if not available) */\r\n      video: VideoAPI | null;\r\n  }\r\n\n  interface FaceBlendshapes {\r\n      browDownLeft: number;\r\n      browDownRight: number;\r\n      browInnerUp: number;\r\n      browOuterUpLeft: number;\r\n      browOuterUpRight: number;\r\n      cheekPuff: number;\r\n      cheekSquintLeft: number;\r\n      cheekSquintRight: number;\r\n      eyeBlinkLeft: number;\r\n      eyeBlinkRight: number;\r\n      eyeLookDownLeft: number;\r\n      eyeLookDownRight: number;\r\n      eyeLookInLeft: number;\r\n      eyeLookInRight: number;\r\n      eyeLookOutLeft: number;\r\n      eyeLookOutRight: number;\r\n      eyeLookUpLeft: number;\r\n      eyeLookUpRight: number;\r\n      eyeSquintLeft: number;\r\n      eyeSquintRight: number;\r\n      eyeWideLeft: number;\r\n      eyeWideRight: number;\r\n      jawForward: number;\r\n      jawLeft: number;\r\n      jawOpen: number;\r\n      jawRight: number;\r\n      mouthClose: number;\r\n      mouthDimpleLeft: number;\r\n      mouthDimpleRight: number;\r\n      mouthFrownLeft: number;\r\n      mouthFrownRight: number;\r\n      mouthFunnel: number;\r\n      mouthLeft: number;\r\n      mouthLowerDownLeft: number;\r\n      mouthLowerDownRight: number;\r\n      mouthPressLeft: number;\r\n      mouthPressRight: number;\r\n      mouthPucker: number;\r\n      mouthRight: number;\r\n      mouthRollLower: number;\r\n      mouthRollUpper: number;\r\n      mouthShrugLower: number;\r\n      mouthShrugUpper: number;\r\n      mouthSmileLeft: number;\r\n      mouthSmileRight: number;\r\n      mouthStretchLeft: number;\r\n      mouthStretchRight: number;\r\n      mouthUpperUpLeft: number;\r\n      mouthUpperUpRight: number;\r\n      noseSneerLeft: number;\r\n      noseSneerRight: number;\r\n      tongueOut: number;\r\n  }\r\n\n  interface FaceData {\r\n      id: number;\r\n      bounds: {\r\n          x: number;\r\n          y: number;\r\n          width: number;\r\n          height: number;\r\n      };\r\n      center: {\r\n          x: number;\r\n          y: number;\r\n      };\r\n      confidence: number;\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z?: number;\r\n      }[];\r\n      expressions: {\r\n          neutral: number;\r\n          happy: number;\r\n          sad: number;\r\n          angry: number;\r\n          surprised: number;\r\n          disgusted: number;\r\n          fearful: number;\r\n      };\r\n      headPose: {\r\n          pitch: number;\r\n          yaw: number;\r\n          roll: number;\r\n      };\r\n      blendshapes: FaceBlendshapes;\r\n  }\r\n\n  type FrameRateMode = 'full' | 'half';\r\n\n  interface FrequencyBand {\r\n      name: string;\r\n      min: number;\r\n      max: number;\r\n  }\r\n\n  interface HandData {\r\n      id: number;\r\n      handedness: 'left' | 'right';\r\n      confidence: number;\r\n      bounds: {\r\n          x: number;\r\n          y: number;\r\n          width: number;\r\n          height: number;\r\n      };\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n      }[];\r\n      palm: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n      };\r\n      gestures: {\r\n          fist: number;\r\n          openPalm: number;\r\n          peace: number;\r\n          thumbsUp: number;\r\n          thumbsDown: number;\r\n          pointing: number;\r\n          iLoveYou: number;\r\n      };\r\n  }\r\n\n  interface ImageConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ImageParameter {\r\n      value: ImageBitmap | null;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface KeyboardAPI {\r\n      isPressed(key: string): boolean;\r\n      wasPressed(key: string): boolean;\r\n      wasReleased(key: string): boolean;\r\n      activeKeys: Set<string>;\r\n      pressedThisFrame: Set<string>;\r\n      releasedThisFrame: Set<string>;\r\n      lastKeyPressed: string;\r\n      lastKeyReleased: string;\r\n      shift: boolean;\r\n      ctrl: boolean;\r\n      alt: boolean;\r\n      meta: boolean;\r\n      textureData: Uint8Array;\r\n  }\r\n\n  interface MouseAPI {\r\n      x: number;\r\n      y: number;\r\n      isInCanvas: boolean;\r\n      isPressed: boolean;\r\n      leftButton: boolean;\r\n      rightButton: boolean;\r\n      middleButton: boolean;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      wheelDelta: number;\r\n      wheelX: number;\r\n      wheelY: number;\r\n      wasPressed: boolean;\r\n      wasReleased: boolean;\r\n      wasMoved: boolean;\r\n  }\r\n\n  interface NumberConfig {\r\n      min?: number;\r\n      max?: number;\r\n      step?: number;\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface NumberParameter {\r\n      value: number;\r\n      min: number;\r\n      max: number;\r\n      step: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  type ParameterCategory = 'audio' | 'video' | 'interaction' | 'general';\r\n\n  interface PointerAPI {\r\n      x: number;\r\n      y: number;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      isDown: boolean;\r\n      wasPressed: boolean;\r\n      wasReleased: boolean;\r\n      isInCanvas: boolean;\r\n      type: 'mouse' | 'touch' | 'none';\r\n  }\r\n\n  interface PoseData {\r\n      confidence: number;\r\n      landmarks: {\r\n          x: number;\r\n          y: number;\r\n          z: number;\r\n          visibility: number;\r\n      }[];\r\n      face: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      torso: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      leftArm: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      rightArm: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      leftLeg: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n      rightLeg: {\r\n          x: number;\r\n          y: number;\r\n      }[];\r\n  }\r\n\n  type Resolution = {\r\n      width: number;\r\n      height: number;\r\n  };\r\n\n  interface SegmentationData {\r\n      mask: Uint8Array;\r\n      width: number;\r\n      height: number;\r\n  }\r\n\n  interface SelectConfig {\r\n      options: string[] | number[];\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface SelectParameter {\r\n      value: string | number;\r\n      options: string[] | number[];\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface SliderConfig {\r\n      min?: number;\r\n      max?: number;\r\n      step?: number;\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface SliderParameter {\r\n      value: number;\r\n      min: number;\r\n      max: number;\r\n      step: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface TextConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n      maxLength?: number;\r\n  }\r\n\n  interface TextParameter {\r\n      value: string;\r\n      maxLength?: number;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface ToggleConfig {\r\n      label: string;\r\n      description?: string;\r\n      group?: string;\r\n      category?: ParameterCategory;\r\n  }\r\n\n  interface ToggleParameter {\r\n      value: boolean;\r\n      label: string;\r\n      description?: string;\r\n      group: string;\r\n      category: ParameterCategory;\r\n  }\r\n\n  interface TouchAPI {\r\n      points: TouchPoint[];\r\n      count: number;\r\n      started: TouchPoint[];\r\n      moved: TouchPoint[];\r\n      ended: TouchPoint[];\r\n      primary: TouchPoint | null;\r\n  }\r\n\n  interface TouchPoint {\r\n      id: number;\r\n      x: number;\r\n      y: number;\r\n      pressure: number;\r\n      radius: number;\r\n      radiusX: number;\r\n      radiusY: number;\r\n      rotationAngle: number;\r\n      force: number;\r\n      isInCanvas: boolean;\r\n      deltaX: number;\r\n      deltaY: number;\r\n      velocity: {\r\n          x: number;\r\n          y: number;\r\n      };\r\n      isNew: boolean;\r\n      isActive: boolean;\r\n      isEnding: boolean;\r\n  }\r\n\n  const VERSION = \"0.2.20\";\r\n\n  interface VideoAPI {\r\n      isConnected: boolean;\r\n      currentFrame: OffscreenCanvas | ImageBitmap | null;\r\n      frameWidth: number;\r\n      frameHeight: number;\r\n      frameRate: number;\r\n      getFrameData: () => ImageData | null;\r\n      faces: FaceData[];\r\n      hands: HandData[];\r\n      pose: PoseData | null;\r\n      segmentation: SegmentationData | null;\r\n      cv: {\r\n          enableFaceDetection(enabled: boolean): Promise<void>;\r\n          enableFaceMesh(enabled: boolean): Promise<void>;\r\n          enableEmotionDetection(enabled: boolean): Promise<void>;\r\n          enableHandTracking(enabled: boolean): Promise<void>;\r\n          enablePoseDetection(enabled: boolean): Promise<void>;\r\n          enableBodySegmentation(enabled: boolean): Promise<void>;\r\n          getActiveFeatures(): CVFeature[];\r\n          isProcessing(): boolean;\r\n      };\r\n  }\r\n\n  interface VijiAPI {\r\n      canvas: OffscreenCanvas;\r\n      ctx?: OffscreenCanvasRenderingContext2D;\r\n      gl?: WebGLRenderingContext | WebGL2RenderingContext;\r\n      width: number;\r\n      height: number;\r\n      time: number;\r\n      deltaTime: number;\r\n      frameCount: number;\r\n      fps: number;\r\n      audio: AudioAPI;\r\n      video: VideoAPI;\r\n      streams: VideoAPI[];\r\n      mouse: MouseAPI;\r\n      keyboard: KeyboardAPI;\r\n      touches: TouchAPI;\r\n      pointer: PointerAPI;\r\n      device: DeviceSensorState;\r\n      devices: DeviceState[];\r\n      slider: (defaultValue: number, config: SliderConfig) => SliderParameter;\r\n      color: (defaultValue: string, config: ColorConfig) => ColorParameter;\r\n      toggle: (defaultValue: boolean, config: ToggleConfig) => ToggleParameter;\r\n      select: (defaultValue: string | number, config: SelectConfig) => SelectParameter;\r\n      text: (defaultValue: string, config: TextConfig) => TextParameter;\r\n      number: (defaultValue: number, config: NumberConfig) => NumberParameter;\r\n      image: (defaultValue: null, config: ImageConfig) => ImageParameter;\r\n      button: (config: ButtonConfig) => ButtonParameter;\r\n      useContext(type: '2d'): OffscreenCanvasRenderingContext2D;\r\n      useContext(type: 'webgl'): WebGLRenderingContext;\r\n      useContext(type: 'webgl2'): WebGL2RenderingContext;\r\n  }\r\n\n  // Runtime global - the main viji object\n  const viji: VijiAPI;\n  \n  // Function type aliases (artists define their own render/setup functions)\n  type Render = (viji: VijiAPI) => void;\n  type Setup = (viji: VijiAPI) => void;\n}\n\n// Module marker (enables top-level await in artist code)\nexport {};\n";

package/dist/artist-global.d.ts

@@ -272,54 +272,14 @@ declare global {
           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;
+          thumbsDown: number;
           pointing: number;
+          iLoveYou: number;
       };
   }
 

package/dist/assets/cv-tasks.worker.js

@@ -29,7 +29,7 @@ try {
 // MediaPipe model instances
 let faceDetector = null;
 let faceLandmarker = null;
-let handLandmarker = null;
+let gestureRecognizer = null;
 let poseLandmarker = null;
 let imageSegmenter = null;
 
@@ -375,31 +375,31 @@ async function initializeFaceLandmarks() {
 }
 
 /**
- * Load and initialize Hand Tracking
+ * Load and initialize Hand Tracking via GestureRecognizer
+ * (provides landmarks + handedness + ML-based gesture classification in one call)
  */
 async function initializeHandTracking() {
-  if (handLandmarker) return;
+  if (gestureRecognizer) return;
   
-  // Ensure vision runtime is initialized first
   await initializeVision();
   
   try {
-    log('Loading Hand Landmarker...');
+    log('Loading Gesture Recognizer...');
     
     const options = {
       baseOptions: {
-        modelAssetPath: 'https://storage.googleapis.com/mediapipe-models/hand_landmarker/hand_landmarker/float16/1/hand_landmarker.task',
+        modelAssetPath: 'https://storage.googleapis.com/mediapipe-models/gesture_recognizer/gesture_recognizer/float16/1/gesture_recognizer.task',
         delegate: 'GPU'
       },
       runningMode: 'VIDEO',
       numHands: 2
     };
     
-    const HandLandmarker = self.HandLandmarker || self.module.exports.HandLandmarker || self.exports.HandLandmarker;
-    handLandmarker = await HandLandmarker.createFromOptions(vision, options);
-    log('✅ Hand Landmarker loaded');
+    const GestureRecognizer = self.GestureRecognizer || self.module.exports.GestureRecognizer || self.exports.GestureRecognizer;
+    gestureRecognizer = await GestureRecognizer.createFromOptions(vision, options);
+    log('✅ Gesture Recognizer loaded');
   } catch (error) {
-    log('❌ Failed to load Hand Landmarker:', error);
+    log('❌ Failed to load Gesture Recognizer:', error);
     throw error;
   }
 }
@@ -465,6 +465,59 @@ async function initializeBodySegmentation() {
   }
 }
 
+function computeHandBounds(landmarks) {
+  let minX = 1, minY = 1, maxX = 0, maxY = 0;
+  for (const p of landmarks) {
+    if (p.x < minX) minX = p.x;
+    if (p.y < minY) minY = p.y;
+    if (p.x > maxX) maxX = p.x;
+    if (p.y > maxY) maxY = p.y;
+  }
+  return { x: minX, y: minY, width: maxX - minX, height: maxY - minY };
+}
+
+// Map MediaPipe GestureRecognizer category names to our API field names
+const GESTURE_NAME_MAP = {
+  'Closed_Fist': 'fist',
+  'Open_Palm': 'openPalm',
+  'Victory': 'peace',
+  'Thumb_Up': 'thumbsUp',
+  'Pointing_Up': 'pointing',
+  'Thumb_Down': 'thumbsDown',
+  'ILoveYou': 'iLoveYou'
+};
+
+function mapGestures(gestureCategories) {
+  const result = { fist: 0, openPalm: 0, peace: 0, thumbsUp: 0, pointing: 0, thumbsDown: 0, iLoveYou: 0 };
+  if (!gestureCategories) return result;
+  for (const cat of gestureCategories) {
+    const key = GESTURE_NAME_MAP[cat.categoryName];
+    if (key) result[key] = cat.score;
+  }
+  return result;
+}
+
+// BlazePose landmark index groups for named body parts
+const POSE_FACE_INDICES = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
+const POSE_TORSO_INDICES = [11, 12, 23, 24];
+const POSE_LEFT_ARM_INDICES = [11, 13, 15];
+const POSE_RIGHT_ARM_INDICES = [12, 14, 16];
+const POSE_LEFT_LEG_INDICES = [23, 25, 27, 29, 31];
+const POSE_RIGHT_LEG_INDICES = [24, 26, 28, 30, 32];
+
+function extractPoseGroup(landmarks, indices) {
+  return indices.map(i => {
+    const lm = landmarks[i];
+    return lm ? { x: lm.x, y: lm.y } : { x: 0, y: 0 };
+  });
+}
+
+function computePoseConfidence(landmarks) {
+  let sum = 0;
+  for (const lm of landmarks) sum += (lm.visibility || 0);
+  return landmarks.length > 0 ? sum / landmarks.length : 0;
+}
+
 /**
  * Process video frame with active CV features
  * @param {ImageData|ImageBitmap} imageInput - Image input (ImageData or ImageBitmap)
@@ -478,7 +531,8 @@ async function processFrame(imageInput, timestamp, features) {
     // Process face detection
     if (features.includes('faceDetection') && faceDetector) {
       const detectionResult = faceDetector.detectForVideo(imageInput, timestamp);
-      results.faces = detectionResult.detections.map((detection) => ({
+      results.faces = detectionResult.detections.map((detection, index) => ({
+        id: index,
         bounds: {
           x: detection.boundingBox.originX / imageInput.width,
           y: detection.boundingBox.originY / imageInput.height,
@@ -505,6 +559,7 @@ async function processFrame(imageInput, timestamp, features) {
         
         if (!results.faces) {
           results.faces = [{
+            id: 0,
             bounds: null,
             center: null,
             landmarks: [],
@@ -525,7 +580,6 @@ async function processFrame(imageInput, timestamp, features) {
           results.faces[0].landmarks = mappedLandmarks;
           results.faces[0].headPose = computeHeadPoseFromLandmarks(landmarks);
 
-          // Populate emotion data when emotionDetection is active
           if (features.includes('emotionDetection') &&
               landmarkResult.faceBlendshapes &&
               landmarkResult.faceBlendshapes.length > 0) {
@@ -534,34 +588,55 @@ async function processFrame(imageInput, timestamp, features) {
             results.faces[0].expressions = mapBlendshapesToEmotions(bs);
           }
         }
+      } else if (!results.faces) {
+        results.faces = [];
       }
     }
     
-    // Process hand tracking
-    if (features.includes('handTracking') && handLandmarker) {
-      const handResult = handLandmarker.detectForVideo(imageInput, timestamp);
-      results.hands = handResult.landmarks.map((landmarks, index) => ({
-        landmarks: landmarks.map((landmark) => ({
+    // Process hand tracking (GestureRecognizer provides landmarks + gestures in one call)
+    if (features.includes('handTracking') && gestureRecognizer) {
+      const handResult = gestureRecognizer.recognizeForVideo(imageInput, timestamp);
+      results.hands = handResult.landmarks.map((landmarks, index) => {
+        const mapped = landmarks.map((landmark) => ({
           x: landmark.x,
           y: landmark.y,
           z: landmark.z || 0
-        })),
-        handedness: handResult.handednesses[index]?.[0]?.categoryName || 'Unknown',
-        confidence: handResult.handednesses[index]?.[0]?.score || 0
-      }));
+        }));
+
+        const rawHandedness = handResult.handednesses[index]?.[0]?.categoryName || 'unknown';
+
+        return {
+          id: index,
+          handedness: rawHandedness.toLowerCase(),
+          confidence: handResult.handednesses[index]?.[0]?.score || 0,
+          bounds: computeHandBounds(mapped),
+          landmarks: mapped,
+          palm: mapped[9],
+          gestures: mapGestures(handResult.gestures[index])
+        };
+      });
     }
     
     // Process pose detection
     if (features.includes('poseDetection') && poseLandmarker) {
       const poseResult = poseLandmarker.detectForVideo(imageInput, timestamp);
       if (poseResult.landmarks.length > 0) {
+        const poseLandmarks = poseResult.landmarks[0].map((landmark) => ({
+          x: landmark.x,
+          y: landmark.y,
+          z: landmark.z || 0,
+          visibility: landmark.visibility || 1
+        }));
+
         results.pose = {
-          landmarks: poseResult.landmarks[0].map((landmark) => ({
-            x: landmark.x,
-            y: landmark.y,
-            z: landmark.z || 0,
-            visibility: landmark.visibility || 1
-          })),
+          confidence: computePoseConfidence(poseLandmarks),
+          landmarks: poseLandmarks,
+          face: extractPoseGroup(poseLandmarks, POSE_FACE_INDICES),
+          torso: extractPoseGroup(poseLandmarks, POSE_TORSO_INDICES),
+          leftArm: extractPoseGroup(poseLandmarks, POSE_LEFT_ARM_INDICES),
+          rightArm: extractPoseGroup(poseLandmarks, POSE_RIGHT_ARM_INDICES),
+          leftLeg: extractPoseGroup(poseLandmarks, POSE_LEFT_LEG_INDICES),
+          rightLeg: extractPoseGroup(poseLandmarks, POSE_RIGHT_LEG_INDICES),
           worldLandmarks: poseResult.worldLandmarks?.[0]?.map((landmark) => ({
             x: landmark.x,
             y: landmark.y,
@@ -569,6 +644,8 @@ async function processFrame(imageInput, timestamp, features) {
             visibility: landmark.visibility || 1
           })) || []
         };
+      } else {
+        results.pose = null;
       }
     }
     
@@ -577,18 +654,17 @@ async function processFrame(imageInput, timestamp, features) {
       const segmentResult = imageSegmenter.segment(imageInput);
       if (segmentResult.categoryMask) {
         try {
-          // Extract data before closing the mask
           results.segmentation = {
             mask: segmentResult.categoryMask.getAsUint8Array(),
             width: segmentResult.categoryMask.width,
             height: segmentResult.categoryMask.height
           };
-          
           log('Segmentation mask:', results.segmentation.width, 'x', results.segmentation.height);
         } finally {
-          // CRITICAL: Close MPMask instance to prevent resource leaks
           segmentResult.categoryMask.close();
         }
+      } else {
+        results.segmentation = null;
       }
     }
     
@@ -697,8 +773,8 @@ async function handleConfigUpdateInternal(features) {
         }
         break;
       case 'handTracking':
-        cleanupPromises.push(cleanupWasmInstance(handLandmarker, 'HandLandmarker'));
-        handLandmarker = null;
+        cleanupPromises.push(cleanupWasmInstance(gestureRecognizer, 'GestureRecognizer'));
+        gestureRecognizer = null;
         break;
       case 'poseDetection':
         cleanupPromises.push(cleanupWasmInstance(poseLandmarker, 'PoseLandmarker'));