@viji-dev/core 0.3.37 → 0.3.38

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 AudioStreamAPI {\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      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      /** Device audio stream (null if not available) */\r\n      audio: AudioStreamAPI | 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      /** P5-compatible image wrapper. Only available in the P5 renderer — added at runtime by the P5 adapter. */\r\n      readonly p5?: any;\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.3.36\";\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      videoStreams: VideoAPI[];\r\n      audioStreams: AudioStreamAPI[];\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 AudioStreamAPI {\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      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  interface CoordinateConfig {\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 CoordinateParameter {\r\n      value: CoordinateValue;\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 CoordinateValue = {\r\n      x: number;\r\n      y: number;\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      /** Device audio stream (null if not available) */\r\n      audio: AudioStreamAPI | 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      /** P5-compatible image wrapper. Only available in the P5 renderer — added at runtime by the P5 adapter. */\r\n      readonly p5?: any;\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.3.37\";\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      videoStreams: VideoAPI[];\r\n      audioStreams: AudioStreamAPI[];\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      coordinate: (defaultValue: CoordinateValue, config: CoordinateConfig) => CoordinateParameter;\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-p5.d.ts

@@ -129,6 +129,28 @@ declare global {
       category: ParameterCategory;
   }
 
+  interface CoordinateConfig {
+      step?: number;
+      label: string;
+      description?: string;
+      group?: string;
+      category?: ParameterCategory;
+  }
+
+  interface CoordinateParameter {
+      value: CoordinateValue;
+      step: number;
+      label: string;
+      description?: string;
+      group: string;
+      category: ParameterCategory;
+  }
+
+  type CoordinateValue = {
+      x: number;
+      y: number;
+  };
+
   type CVFeature = 'faceDetection' | 'faceMesh' | 'handTracking' | 'poseDetection' | 'bodySegmentation' | 'emotionDetection';
 
   type CVFrameRateMode = 'full' | 'half' | 'quarter' | 'eighth';
@@ -555,7 +577,7 @@ declare global {
       isEnding: boolean;
   }
 
-  const VERSION = "0.3.36";
+  const VERSION = "0.3.37";
 
   interface VideoAPI {
       isConnected: boolean;
@@ -608,6 +630,7 @@ declare global {
       number: (defaultValue: number, config: NumberConfig) => NumberParameter;
       image: (defaultValue: null, config: ImageConfig) => ImageParameter;
       button: (config: ButtonConfig) => ButtonParameter;
+      coordinate: (defaultValue: CoordinateValue, config: CoordinateConfig) => CoordinateParameter;
       useContext(type: '2d'): OffscreenCanvasRenderingContext2D;
       useContext(type: 'webgl'): WebGLRenderingContext;
       useContext(type: 'webgl2'): WebGL2RenderingContext;

package/dist/artist-global.d.ts

@@ -129,6 +129,28 @@ declare global {
       category: ParameterCategory;
   }
 
+  interface CoordinateConfig {
+      step?: number;
+      label: string;
+      description?: string;
+      group?: string;
+      category?: ParameterCategory;
+  }
+
+  interface CoordinateParameter {
+      value: CoordinateValue;
+      step: number;
+      label: string;
+      description?: string;
+      group: string;
+      category: ParameterCategory;
+  }
+
+  type CoordinateValue = {
+      x: number;
+      y: number;
+  };
+
   type CVFeature = 'faceDetection' | 'faceMesh' | 'handTracking' | 'poseDetection' | 'bodySegmentation' | 'emotionDetection';
 
   type CVFrameRateMode = 'full' | 'half' | 'quarter' | 'eighth';
@@ -544,7 +566,7 @@ declare global {
       isEnding: boolean;
   }
 
-  const VERSION = "0.3.36";
+  const VERSION = "0.3.37";
 
   interface VideoAPI {
       isConnected: boolean;
@@ -597,6 +619,7 @@ declare global {
       number: (defaultValue: number, config: NumberConfig) => NumberParameter;
       image: (defaultValue: null, config: ImageConfig) => ImageParameter;
       button: (config: ButtonConfig) => ButtonParameter;
+      coordinate: (defaultValue: CoordinateValue, config: CoordinateConfig) => CoordinateParameter;
       useContext(type: '2d'): OffscreenCanvasRenderingContext2D;
       useContext(type: 'webgl'): WebGLRenderingContext;
       useContext(type: 'webgl2'): WebGL2RenderingContext;

package/dist/artist-jsdoc.d.ts

@@ -83,6 +83,16 @@
  * @property {ParameterCategory} [category] - category property
  */
 
+/**
+ * Configuration for coordinate parameters
+ * @typedef {Object} CoordinateConfig
+ * @property {number} [step] - step property
+ * @property {string} label - label property
+ * @property {string} [description] - description property
+ * @property {string} [group] - group property
+ * @property {ParameterCategory} [category] - category property
+ */
+
 /**
  * Parameter object for slider parameters
  * @typedef {Object} SliderParameter
@@ -171,6 +181,17 @@
  * @property {ParameterCategory} category - category property
  */
 
+/**
+ * Parameter object for coordinate parameters
+ * @typedef {Object} CoordinateParameter
+ * @property {CoordinateValue} value - value property
+ * @property {number} step - step property
+ * @property {string} label - label property
+ * @property {string} [description] - description property
+ * @property {string} group - group property
+ * @property {ParameterCategory} category - category property
+ */
+
 /**
  * Audio analysis API - provides real-time audio data and frequency analysis
  * @typedef {Object} AudioAPI
@@ -330,6 +351,7 @@
  * @property {(defaultValue: number, config: NumberConfig) => NumberParameter} number - number property
  * @property {(defaultValue: null, config: ImageConfig) => ImageParameter} image - image property
  * @property {(config: ButtonConfig) => ButtonParameter} button - button property
+ * @property {(defaultValue: CoordinateValue, config: CoordinateConfig) => CoordinateParameter} coordinate - coordinate property
  * @property {(type: '2d') => OffscreenCanvasRenderingContext2D} useContext - useContext property
  * @property {(type: 'webgl') => WebGLRenderingContext} useContext - useContext property
  * @property {(type: 'webgl2') => WebGL2RenderingContext} useContext - useContext property

package/dist/assets/{viji.worker-DR0jmwBv.js → viji.worker-BoI8e3NI.js}

@@ -222,6 +222,33 @@ class ParameterSystem {
     this.parameterObjects.set(paramName, buttonObject);
     return buttonObject;
   }
+  createCoordinateParameter(defaultValue, config) {
+    const paramName = config.label;
+    const coordinateObject = {
+      value: { x: defaultValue.x, y: defaultValue.y },
+      step: config.step ?? 0.01,
+      label: config.label,
+      description: config.description ?? "",
+      group: config.group ?? "general",
+      category: config.category ?? "general"
+    };
+    const definition = {
+      type: "coordinate",
+      defaultValue: { x: defaultValue.x, y: defaultValue.y },
+      label: coordinateObject.label,
+      description: coordinateObject.description,
+      group: coordinateObject.group,
+      category: coordinateObject.category,
+      config: {
+        min: -1,
+        max: 1,
+        step: coordinateObject.step
+      }
+    };
+    this.storeParameterDefinition(paramName, definition);
+    this.parameterObjects.set(paramName, coordinateObject);
+    return coordinateObject;
+  }
   storeParameterDefinition(name, definition) {
     this.parameterDefinitions.set(name, definition);
     this.parameterValues.set(name, definition.defaultValue);
@@ -238,7 +265,8 @@ class ParameterSystem {
     }
     const currentValue = this.parameterValues.get(name);
     const isInitialSync = !this.initialValuesSynced;
-    if (currentValue === value && !isInitialSync) {
+    const isEqual = definition.type === "coordinate" ? currentValue && value && typeof currentValue === "object" && typeof value === "object" && "x" in currentValue && "x" in value && currentValue.x === value.x && currentValue.y === value.y : currentValue === value;
+    if (isEqual && !isInitialSync) {
       return false;
     }
     this.parameterValues.set(name, value);
@@ -309,6 +337,21 @@ class ParameterSystem {
           return false;
         }
         break;
+      case "coordinate":
+        if (!value || typeof value !== "object" || !("x" in value) || !("y" in value)) {
+          console.error(`Parameter '${name}' must be an object with x and y properties, got: ${value}`);
+          return false;
+        }
+        const coord = value;
+        if (typeof coord.x !== "number" || isNaN(coord.x) || typeof coord.y !== "number" || isNaN(coord.y)) {
+          console.error(`Parameter '${name}' x and y must be numbers, got: x=${coord.x}, y=${coord.y}`);
+          return false;
+        }
+        if (coord.x < -1 || coord.x > 1 || coord.y < -1 || coord.y > 1) {
+          console.error(`Parameter '${name}' x and y must be between -1 and 1, got: x=${coord.x}, y=${coord.y}`);
+          return false;
+        }
+        break;
     }
     return true;
   }
@@ -2344,6 +2387,14 @@ class ShaderParameterParser {
           console.warn(`Parameter ${param.uniformName} of type 'button' ignores 'default' — buttons always start as false`);
         }
         break;
+      case "coordinate":
+        if (param.config.default === void 0) {
+          throw new Error(`Parameter ${param.uniformName} of type 'coordinate' missing required 'default' key (e.g., default:[0,0])`);
+        }
+        if (!Array.isArray(param.config.default) || param.config.default.length !== 2 || typeof param.config.default[0] !== "number" || typeof param.config.default[1] !== "number") {
+          throw new Error(`Parameter ${param.uniformName} of type 'coordinate' default must be an array of 2 numbers (e.g., [0,0])`);
+        }
+        break;
       case "accumulator":
         if (param.config.rate === void 0) {
           throw new Error(`Accumulator '${param.uniformName}' requires a 'rate' config key (parameter name or numeric constant)`);
@@ -2377,6 +2428,8 @@ class ShaderParameterParser {
         return `uniform sampler2D ${param.uniformName};`;
       case "button":
         return `uniform bool ${param.uniformName};`;
+      case "coordinate":
+        return `uniform vec2 ${param.uniformName};`;
       case "accumulator":
         return `uniform float ${param.uniformName}; // accumulator (rate: ${param.config.rate})`;
       default:
@@ -3712,6 +3765,11 @@ ${error}`);
         case "button":
           this.setUniform(param.uniformName, "bool", value);
           break;
+        case "coordinate":
+          if (value && typeof value === "object" && "x" in value && "y" in value) {
+            this.setUniform(param.uniformName, "vec2", [value.x, value.y]);
+          }
+          break;
       }
     }
   }
@@ -4722,6 +4780,9 @@ class VijiWorkerRuntime {
     button: (config) => {
       return this.parameterSystem.createButtonParameter(config);
     },
+    coordinate: (defaultValue, config) => {
+      return this.parameterSystem.createCoordinateParameter(defaultValue, config);
+    },
     // Context selection
     useContext: (type) => {
       if (type === "2d") {
@@ -4848,6 +4909,11 @@ class VijiWorkerRuntime {
       case "button":
         this.viji.button(paramConfig);
         break;
+      case "coordinate": {
+        const def = Array.isArray(config.default) ? config.default : [0, 0];
+        this.viji.coordinate({ x: def[0], y: def[1] }, paramConfig);
+        break;
+      }
     }
   }
   // Reset parameter state (called when loading new scene)
@@ -27062,4 +27128,4 @@ async function setSceneCode(sceneCode) {
   }
 }
 self.setSceneCode = setSceneCode;
-//# sourceMappingURL=viji.worker-DR0jmwBv.js.map
+//# sourceMappingURL=viji.worker-BoI8e3NI.js.map