npm - @viji-dev/core - Versions diffs - 0.3.12 → 0.3.14 - Mend

@viji-dev/core 0.3.12 → 0.3.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/artist-dts-p5.js +1 -1
package/dist/artist-dts.js +1 -1
package/dist/artist-global.d.ts +53 -41
package/dist/artist-js-ambient.d.ts +12 -318
package/dist/artist-jsdoc.d.ts +12 -318
package/package.json +1 -1

package/dist/artist-dts-p5.js CHANGED Viewed

	@@ -1 +1 @@
1	- export const artistDtsP5 = "declare namespace VijiCore {\n declare 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 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 phase: number;\r\n bar: number;\r\n confidence: number;\r\n isLocked: boolean;\r\n };\r\n spectral: {\r\n brightness: number;\r\n flatness: number;\r\n flux: number;\r\n };\r\n getFrequencyData: () => Uint8Array;\r\n getWaveform?: (samples?: number) => Float32Array;\r\n getFFT?: (bins?: number, scale?: 'linear' \| 'log') => Float32Array;\r\n }\r\n\n declare 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 declare interface ColorConfig {\r\n label: string;\r\n description?: string;\r\n group?: string;\r\n category?: ParameterCategory;\r\n }\r\n\n declare 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 declare type CVFeature = 'faceDetection' \| 'faceMesh' \| 'handTracking' \| 'poseDetection' \| 'bodySegmentation';\r\n\n declare type CVFrameRateMode = 'full' \| 'half' \| 'quarter' \| 'eighth';\r\n\n declare 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 declare 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 declare interface DeviceSensorState {\r\n motion: DeviceMotionData \| null;\r\n orientation: DeviceOrientationData \| null;\r\n }\r\n\n declare 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 declare 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 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 }\r\n\n declare type FrameRateMode = 'full' \| 'half';\r\n\n declare interface FrequencyBand {\r\n name: string;\r\n min: number;\r\n max: number;\r\n }\r\n\n declare 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 declare interface ImageConfig {\r\n label: string;\r\n description?: string;\r\n group?: string;\r\n category?: ParameterCategory;\r\n }\r\n\n declare interface ImageParameter {\r\n value: ImageBitmap \| OffscreenCanvas \| null;\r\n label: string;\r\n description?: string;\r\n group: string;\r\n category: ParameterCategory;\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\n declare 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 }\r\n\n declare 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 velocity: {\r\n x: number;\r\n y: number;\r\n };\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 declare 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 declare 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 declare type ParameterCategory = 'audio' \| 'video' \| 'interaction' \| 'general';\r\n\n declare 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 declare type Resolution = {\r\n width: number;\r\n height: number;\r\n };\r\n\n declare interface SegmentationData {\r\n mask: Uint8Array;\r\n width: number;\r\n height: number;\r\n }\r\n\n declare 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 declare 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 declare 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 declare 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 declare 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 declare 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 declare interface ToggleConfig {\r\n label: string;\r\n description?: string;\r\n group?: string;\r\n category?: ParameterCategory;\r\n }\r\n\n declare 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 declare 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 gestures: TouchGestureAPI;\r\n }\r\n\n declare interface TouchGestureAPI {\r\n isPinching: boolean;\r\n isRotating: boolean;\r\n isPanning: boolean;\r\n isTapping: boolean;\r\n pinchScale: number;\r\n pinchDelta: number;\r\n rotationAngle: number;\r\n rotationDelta: number;\r\n panDelta: {\r\n x: number;\r\n y: number;\r\n };\r\n tapCount: number;\r\n lastTapTime: number;\r\n tapPosition: {\r\n x: number;\r\n y: number;\r\n } \| null;\r\n }\r\n\n declare 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 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 declare const VERSION = \"0.2.20\";\r\n\n declare 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 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 declare interface VijiAPI {\r\n canvas: OffscreenCanvas;\r\n ctx?: OffscreenCanvasRenderingContext2D;\r\n gl?: WebGL2RenderingContext;\r\n width: number;\r\n height: number;\r\n pixelRatio: 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 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 useContext(type: '2d'): OffscreenCanvasRenderingContext2D;\n useContext(type: 'webgl'): WebGLRenderingContext \| WebGL2RenderingContext;\r\n }\r\n}\n\ndeclare const viji: VijiCore.VijiAPI;\ndeclare function render(viji: VijiCore.VijiAPI): void;\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/\n Optional setup function - 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 /\ndeclare function setup(viji: VijiCore.VijiAPI, p5: p5): void;\n\n/\n Required render function - called every frame\n * @param viji - Viji API (canvas, audio, video, parameters, etc.)\n * @param p5 - P5.js instance with all P5 methods\n */\ndeclare function render(viji: VijiCore.VijiAPI, p5: p5): void;\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";
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 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 phase: number;\r\n bar: number;\r\n confidence: number;\r\n isLocked: boolean;\r\n };\r\n spectral: {\r\n brightness: number;\r\n flatness: number;\r\n flux: number;\r\n };\r\n getFrequencyData: () => Uint8Array;\r\n getWaveform?: (samples?: number) => Float32Array;\r\n getFFT?: (bins?: number, scale?: 'linear' \| 'log') => Float32Array;\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';\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 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 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 }\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 \| OffscreenCanvas \| 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 }\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 velocity: {\r\n x: number;\r\n y: 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 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 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 gestures: TouchGestureAPI;\r\n }\r\n\n interface TouchGestureAPI {\r\n isPinching: boolean;\r\n isRotating: boolean;\r\n isPanning: boolean;\r\n isTapping: boolean;\r\n pinchScale: number;\r\n pinchDelta: number;\r\n rotationAngle: number;\r\n rotationDelta: number;\r\n panDelta: {\r\n x: number;\r\n y: number;\r\n };\r\n tapCount: number;\r\n lastTapTime: number;\r\n tapPosition: {\r\n x: number;\r\n y: number;\r\n } \| 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 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 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?: WebGL2RenderingContext;\r\n width: number;\r\n height: number;\r\n pixelRatio: 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 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 useContext(type: '2d'): OffscreenCanvasRenderingContext2D;\n useContext(type: 'webgl'): WebGLRenderingContext \| 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 CHANGED Viewed

	@@ -1 +1 @@
1	- export const artistDts = "declare namespace VijiCore {\n declare 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 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 phase: number;\r\n bar: number;\r\n confidence: number;\r\n isLocked: boolean;\r\n };\r\n spectral: {\r\n brightness: number;\r\n flatness: number;\r\n flux: number;\r\n };\r\n getFrequencyData: () => Uint8Array;\r\n getWaveform?: (samples?: number) => Float32Array;\r\n getFFT?: (bins?: number, scale?: 'linear' \| 'log') => Float32Array;\r\n }\r\n\n declare 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 declare interface ColorConfig {\r\n label: string;\r\n description?: string;\r\n group?: string;\r\n category?: ParameterCategory;\r\n }\r\n\n declare 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 declare type CVFeature = 'faceDetection' \| 'faceMesh' \| 'handTracking' \| 'poseDetection' \| 'bodySegmentation';\r\n\n declare type CVFrameRateMode = 'full' \| 'half' \| 'quarter' \| 'eighth';\r\n\n declare 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 declare 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 declare interface DeviceSensorState {\r\n motion: DeviceMotionData \| null;\r\n orientation: DeviceOrientationData \| null;\r\n }\r\n\n declare 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 declare 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 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 }\r\n\n declare type FrameRateMode = 'full' \| 'half';\r\n\n declare interface FrequencyBand {\r\n name: string;\r\n min: number;\r\n max: number;\r\n }\r\n\n declare 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 declare interface ImageConfig {\r\n label: string;\r\n description?: string;\r\n group?: string;\r\n category?: ParameterCategory;\r\n }\r\n\n declare interface ImageParameter {\r\n value: ImageBitmap \| OffscreenCanvas \| null;\r\n label: string;\r\n description?: string;\r\n group: string;\r\n category: ParameterCategory;\r\n }\r\n\n declare 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 }\r\n\n declare 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 velocity: {\r\n x: number;\r\n y: number;\r\n };\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 declare 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 declare 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 declare type ParameterCategory = 'audio' \| 'video' \| 'interaction' \| 'general';\r\n\n declare 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 declare type Resolution = {\r\n width: number;\r\n height: number;\r\n };\r\n\n declare interface SegmentationData {\r\n mask: Uint8Array;\r\n width: number;\r\n height: number;\r\n }\r\n\n declare 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 declare 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 declare 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 declare 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 declare 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 declare 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 declare interface ToggleConfig {\r\n label: string;\r\n description?: string;\r\n group?: string;\r\n category?: ParameterCategory;\r\n }\r\n\n declare 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 declare 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 gestures: TouchGestureAPI;\r\n }\r\n\n declare interface TouchGestureAPI {\r\n isPinching: boolean;\r\n isRotating: boolean;\r\n isPanning: boolean;\r\n isTapping: boolean;\r\n pinchScale: number;\r\n pinchDelta: number;\r\n rotationAngle: number;\r\n rotationDelta: number;\r\n panDelta: {\r\n x: number;\r\n y: number;\r\n };\r\n tapCount: number;\r\n lastTapTime: number;\r\n tapPosition: {\r\n x: number;\r\n y: number;\r\n } \| null;\r\n }\r\n\n declare 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 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 declare const VERSION = \"0.2.20\";\r\n\n declare 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 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 declare interface VijiAPI {\r\n canvas: OffscreenCanvas;\r\n ctx?: OffscreenCanvasRenderingContext2D;\r\n gl?: WebGL2RenderingContext;\r\n width: number;\r\n height: number;\r\n pixelRatio: 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 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 useContext(type: '2d'): OffscreenCanvasRenderingContext2D;\n useContext(type: 'webgl'): WebGLRenderingContext \| WebGL2RenderingContext;\r\n }\r\n}\n\ndeclare const viji: VijiCore.VijiAPI;\ndeclare function render(viji: VijiCore.VijiAPI): void;\n";
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 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 phase: number;\r\n bar: number;\r\n confidence: number;\r\n isLocked: boolean;\r\n };\r\n spectral: {\r\n brightness: number;\r\n flatness: number;\r\n flux: number;\r\n };\r\n getFrequencyData: () => Uint8Array;\r\n getWaveform?: (samples?: number) => Float32Array;\r\n getFFT?: (bins?: number, scale?: 'linear' \| 'log') => Float32Array;\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';\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 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 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 }\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 \| OffscreenCanvas \| 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 }\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 velocity: {\r\n x: number;\r\n y: number;\r\n };\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 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 gestures: TouchGestureAPI;\r\n }\r\n\n interface TouchGestureAPI {\r\n isPinching: boolean;\r\n isRotating: boolean;\r\n isPanning: boolean;\r\n isTapping: boolean;\r\n pinchScale: number;\r\n pinchDelta: number;\r\n rotationAngle: number;\r\n rotationDelta: number;\r\n panDelta: {\r\n x: number;\r\n y: number;\r\n };\r\n tapCount: number;\r\n lastTapTime: number;\r\n tapPosition: {\r\n x: number;\r\n y: number;\r\n } \| 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 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 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?: WebGL2RenderingContext;\r\n width: number;\r\n height: number;\r\n pixelRatio: 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 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 useContext(type: '2d'): OffscreenCanvasRenderingContext2D;\n useContext(type: 'webgl'): WebGLRenderingContext \| 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 CHANGED Viewed

@@ -1,5 +1,10 @@
-declare namespace VijiCore {
-  declare interface AudioAPI {
+// Viji Artist API - Global Type Definitions
+// All types are placed inside declare global {} because this file uses export {}
+// for top-level await support, which makes it a module (where top-level declarations
+// would otherwise be module-scoped, not global).
+declare global {
+  interface AudioAPI {
       isConnected: boolean;
       volume: {
           current: number;
@@ -53,7 +58,7 @@ declare namespace VijiCore {
       getFFT?: (bins?: number, scale?: 'linear' | 'log') => Float32Array;
   }
-  declare interface CaptureFrameOptions {
+  interface CaptureFrameOptions {
       /** Output format: 'blob' for encoded image, 'bitmap' for GPU-friendly ImageBitmap */
       format?: 'blob' | 'bitmap';
       /** MIME type for blob output (ignored for bitmap), e.g., 'image/png', 'image/jpeg', 'image/webp' */
@@ -70,14 +75,14 @@ declare namespace VijiCore {
       };
   }
-  declare interface ColorConfig {
+  interface ColorConfig {
       label: string;
       description?: string;
       group?: string;
       category?: ParameterCategory;
   }
-  declare interface ColorParameter {
+  interface ColorParameter {
       value: string;
       label: string;
       description?: string;
@@ -85,11 +90,11 @@ declare namespace VijiCore {
       category: ParameterCategory;
   }
-  declare type CVFeature = 'faceDetection' | 'faceMesh' | 'handTracking' | 'poseDetection' | 'bodySegmentation';
+  type CVFeature = 'faceDetection' | 'faceMesh' | 'handTracking' | 'poseDetection' | 'bodySegmentation';
-  declare type CVFrameRateMode = 'full' | 'half' | 'quarter' | 'eighth';
+  type CVFrameRateMode = 'full' | 'half' | 'quarter' | 'eighth';
-  declare interface DeviceMotionData {
+  interface DeviceMotionData {
       /** Acceleration without gravity (m/s²) */
       acceleration: {
           x: number | null;
@@ -112,7 +117,7 @@ declare namespace VijiCore {
       interval: number;
   }
-  declare interface DeviceOrientationData {
+  interface DeviceOrientationData {
       /** Rotation around Z-axis (0-360 degrees, compass heading) */
       alpha: number | null;
       /** Rotation around X-axis (-180 to 180 degrees, front-to-back tilt) */
@@ -123,12 +128,12 @@ declare namespace VijiCore {
       absolute: boolean;
   }
-  declare interface DeviceSensorState {
+  interface DeviceSensorState {
       motion: DeviceMotionData | null;
       orientation: DeviceOrientationData | null;
   }
-  declare interface DeviceState extends DeviceSensorState {
+  interface DeviceState extends DeviceSensorState {
       /** Unique device identifier */
       id: string;
       /** User-friendly device name */
@@ -137,7 +142,7 @@ declare namespace VijiCore {
       video: VideoAPI | null;
   }
-  declare interface FaceData {
+  interface FaceData {
       id: number;
       bounds: {
           x: number;
@@ -167,15 +172,15 @@ declare namespace VijiCore {
       };
   }
-  declare type FrameRateMode = 'full' | 'half';
+  type FrameRateMode = 'full' | 'half';
-  declare interface FrequencyBand {
+  interface FrequencyBand {
       name: string;
       min: number;
       max: number;
   }
-  declare interface HandData {
+  interface HandData {
       id: number;
       handedness: 'left' | 'right';
       confidence: number;
@@ -246,14 +251,14 @@ declare namespace VijiCore {
       };
   }
-  declare interface ImageConfig {
+  interface ImageConfig {
       label: string;
       description?: string;
       group?: string;
       category?: ParameterCategory;
   }
-  declare interface ImageParameter {
+  interface ImageParameter {
       value: ImageBitmap | OffscreenCanvas | null;
       label: string;
       description?: string;
@@ -261,7 +266,7 @@ declare namespace VijiCore {
       category: ParameterCategory;
   }
-  declare interface KeyboardAPI {
+  interface KeyboardAPI {
       isPressed(key: string): boolean;
       wasPressed(key: string): boolean;
       wasReleased(key: string): boolean;
@@ -276,7 +281,7 @@ declare namespace VijiCore {
       meta: boolean;
   }
-  declare interface MouseAPI {
+  interface MouseAPI {
       x: number;
       y: number;
       isInCanvas: boolean;
@@ -298,7 +303,7 @@ declare namespace VijiCore {
       wasMoved: boolean;
   }
-  declare interface NumberConfig {
+  interface NumberConfig {
       min?: number;
       max?: number;
       step?: number;
@@ -308,7 +313,7 @@ declare namespace VijiCore {
       category?: ParameterCategory;
   }
-  declare interface NumberParameter {
+  interface NumberParameter {
       value: number;
       min: number;
       max: number;
@@ -319,9 +324,9 @@ declare namespace VijiCore {
       category: ParameterCategory;
   }
-  declare type ParameterCategory = 'audio' | 'video' | 'interaction' | 'general';
+  type ParameterCategory = 'audio' | 'video' | 'interaction' | 'general';
-  declare interface PoseData {
+  interface PoseData {
       confidence: number;
       landmarks: {
           x: number;
@@ -355,18 +360,18 @@ declare namespace VijiCore {
       }[];
   }
-  declare type Resolution = {
+  type Resolution = {
       width: number;
       height: number;
   };
-  declare interface SegmentationData {
+  interface SegmentationData {
       mask: Uint8Array;
       width: number;
       height: number;
   }
-  declare interface SelectConfig {
+  interface SelectConfig {
       options: string[] | number[];
       label: string;
       description?: string;
@@ -374,7 +379,7 @@ declare namespace VijiCore {
       category?: ParameterCategory;
   }
-  declare interface SelectParameter {
+  interface SelectParameter {
       value: string | number;
       options: string[] | number[];
       label: string;
@@ -383,7 +388,7 @@ declare namespace VijiCore {
       category: ParameterCategory;
   }
-  declare interface SliderConfig {
+  interface SliderConfig {
       min?: number;
       max?: number;
       step?: number;
@@ -393,7 +398,7 @@ declare namespace VijiCore {
       category?: ParameterCategory;
   }
-  declare interface SliderParameter {
+  interface SliderParameter {
       value: number;
       min: number;
       max: number;
@@ -404,7 +409,7 @@ declare namespace VijiCore {
       category: ParameterCategory;
   }
-  declare interface TextConfig {
+  interface TextConfig {
       label: string;
       description?: string;
       group?: string;
@@ -412,7 +417,7 @@ declare namespace VijiCore {
       maxLength?: number;
   }
-  declare interface TextParameter {
+  interface TextParameter {
       value: string;
       maxLength?: number;
       label: string;
@@ -421,14 +426,14 @@ declare namespace VijiCore {
       category: ParameterCategory;
   }
-  declare interface ToggleConfig {
+  interface ToggleConfig {
       label: string;
       description?: string;
       group?: string;
       category?: ParameterCategory;
   }
-  declare interface ToggleParameter {
+  interface ToggleParameter {
       value: boolean;
       label: string;
       description?: string;
@@ -436,7 +441,7 @@ declare namespace VijiCore {
       category: ParameterCategory;
   }
-  declare interface TouchAPI {
+  interface TouchAPI {
       points: TouchPoint[];
       count: number;
       started: TouchPoint[];
@@ -446,7 +451,7 @@ declare namespace VijiCore {
       gestures: TouchGestureAPI;
   }
-  declare interface TouchGestureAPI {
+  interface TouchGestureAPI {
       isPinching: boolean;
       isRotating: boolean;
       isPanning: boolean;
@@ -467,7 +472,7 @@ declare namespace VijiCore {
       } | null;
   }
-  declare interface TouchPoint {
+  interface TouchPoint {
       id: number;
       x: number;
       y: number;
@@ -488,9 +493,9 @@ declare namespace VijiCore {
       isEnding: boolean;
   }
-  declare const VERSION = "0.2.20";
+  const VERSION = "0.2.20";
-  declare interface VideoAPI {
+  interface VideoAPI {
       isConnected: boolean;
       currentFrame: OffscreenCanvas | ImageBitmap | null;
       frameWidth: number;
@@ -512,7 +517,7 @@ declare namespace VijiCore {
       };
   }
-  declare interface VijiAPI {
+  interface VijiAPI {
       canvas: OffscreenCanvas;
       ctx?: OffscreenCanvasRenderingContext2D;
       gl?: WebGL2RenderingContext;
@@ -541,7 +546,14 @@ declare namespace VijiCore {
       useContext(type: '2d'): OffscreenCanvasRenderingContext2D;
       useContext(type: 'webgl'): WebGLRenderingContext | WebGL2RenderingContext;
   }
+  // Runtime global - the main viji object
+  const viji: VijiAPI;
+  // Function type aliases (artists define their own render/setup functions)
+  type Render = (viji: VijiAPI) => void;
+  type Setup = (viji: VijiAPI) => void;
 }
-declare const viji: VijiCore.VijiAPI;
-declare function render(viji: VijiCore.VijiAPI): void;
+// Module marker (enables top-level await in artist code)
+export {};

package/dist/artist-js-ambient.d.ts CHANGED Viewed

@@ -8,336 +8,30 @@
  */
 /**
- * Configuration for slider parameters
- * @typedef {Object} SliderConfig
- * @property {number} [min] - min property
- * @property {number} [max] - max 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
- */
-/**
- * Configuration for color parameters
- * @typedef {Object} ColorConfig
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} [group] - group property
- * @property {ParameterCategory} [category] - category property
- */
-/**
- * Configuration for toggle parameters
- * @typedef {Object} ToggleConfig
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} [group] - group property
- * @property {ParameterCategory} [category] - category property
- */
-/**
- * Configuration for select parameters
- * @typedef {Object} SelectConfig
- * @property {string[] | number[]} options - options property
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} [group] - group property
- * @property {ParameterCategory} [category] - category property
- */
-/**
- * Configuration for text parameters
- * @typedef {Object} TextConfig
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} [group] - group property
- * @property {ParameterCategory} [category] - category property
- * @property {number} [maxLength] - maxLength property
- */
-/**
- * Configuration for number parameters
- * @typedef {Object} NumberConfig
- * @property {number} [min] - min property
- * @property {number} [max] - max 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
- */
-/**
- * Configuration for image parameters
- * @typedef {Object} ImageConfig
- * @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
- * @property {number} value - value property
- * @property {number} min - min property
- * @property {number} max - max 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
- */
-/**
- * Parameter object for color parameters
- * @typedef {Object} ColorParameter
- * @property {string} value - value property
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} group - group property
- * @property {ParameterCategory} category - category property
- */
-/**
- * Parameter object for toggle parameters
- * @typedef {Object} ToggleParameter
- * @property {boolean} value - value property
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} group - group property
- * @property {ParameterCategory} category - category property
- */
-/**
- * Parameter object for select parameters
- * @typedef {Object} SelectParameter
- * @property {string | number} value - value property
- * @property {string[] | number[]} options - options property
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} group - group property
- * @property {ParameterCategory} category - category property
- */
-/**
- * Parameter object for text parameters
- * @typedef {Object} TextParameter
- * @property {string} value - value property
- * @property {number} [maxLength] - maxLength property
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} group - group property
- * @property {ParameterCategory} category - category property
- */
-/**
- * Parameter object for number parameters
- * @typedef {Object} NumberParameter
- * @property {number} value - value property
- * @property {number} min - min property
- * @property {number} max - max 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
- */
-/**
- * Parameter object for image parameters
- * @typedef {Object} ImageParameter
- * @property {ImageBitmap | OffscreenCanvas |null} value - value 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
- * @property {boolean} isConnected - isConnected property
- * @property {Object} volume - volume property
- * @property {number} volume.current - current property
- * @property {number} volume.peak - peak property
- * @property {number} volume.smoothed - smoothed property
- */
-/**
- * Video frame API - provides access to video stream and computer vision data
- * @typedef {Object} VideoAPI
- * @property {boolean} isConnected - isConnected property
- * @property {OffscreenCanvas | ImageBitmap |null} currentFrame - currentFrame property
- * @property {number} frameWidth - frameWidth property
- * @property {number} frameHeight - frameHeight property
- * @property {number} frameRate - frameRate property
- * @property {() => ImageData |null} getFrameData - getFrameData property
- * @property {FaceData[]} faces - faces property
- * @property {HandData[]} hands - hands property
- * @property {PoseData |null} pose - pose property
- * @property {SegmentationData |null} segmentation - segmentation property
- * @property {Object} cv - cv property
- */
-/**
- * Mouse interaction API
- * @typedef {Object} MouseAPI
- * @property {number} x - x property
- * @property {number} y - y property
- * @property {boolean} isInCanvas - isInCanvas property
- * @property {boolean} isPressed - isPressed property
- * @property {boolean} leftButton - leftButton property
- * @property {boolean} rightButton - rightButton property
- * @property {boolean} middleButton - middleButton property
- * @property {Object} velocity - velocity property
- * @property {number} velocity.x - x property
- * @property {number} velocity.y - y property
- */
-/**
- * Keyboard interaction API
- * @typedef {Object} KeyboardAPI
- * @property {Set<string>} activeKeys - activeKeys property
- * @property {Set<string>} pressedThisFrame - pressedThisFrame property
- * @property {Set<string>} releasedThisFrame - releasedThisFrame property
- * @property {string} lastKeyPressed - lastKeyPressed property
- * @property {string} lastKeyReleased - lastKeyReleased property
- * @property {boolean} shift - shift property
- * @property {boolean} ctrl - ctrl property
- * @property {boolean} alt - alt property
- * @property {boolean} meta - meta property
- */
-/**
- * Touch interaction API
- * @typedef {Object} TouchAPI
- * @property {TouchPoint[]} points - points property
- * @property {number} count - count property
- * @property {TouchPoint[]} started - started property
- * @property {TouchPoint[]} moved - moved property
- * @property {TouchPoint[]} ended - ended property
- * @property {TouchPoint |null} primary - primary property
- * @property {TouchGestureAPI} gestures - gestures property
- */
-/**
- * Main Viji Artist API - provides access to canvas, timing, audio, video, and interactions
- * @typedef {Object} VijiAPI
- * @property {OffscreenCanvas} canvas - canvas property
- * @property {OffscreenCanvasRenderingContext2D} [ctx] - ctx property
- * @property {WebGL2RenderingContext} [gl] - gl property
- * @property {number} width - width property
- * @property {number} height - height property
- * @property {number} pixelRatio - pixelRatio property
- * @property {number} time - time property
- * @property {number} deltaTime - deltaTime property
- * @property {number} frameCount - frameCount property
- * @property {number} fps - fps property
- * @property {AudioAPI} audio - audio property
- * @property {VideoAPI} video - video property
- * @property {VideoAPI[]} streams - streams property
- * @property {MouseAPI} mouse - mouse property
- * @property {KeyboardAPI} keyboard - keyboard property
- * @property {TouchAPI} touches - touches property
- * @property {DeviceSensorState} device - device property
- * @property {DeviceState[]} devices - devices property
- * @property {(defaultValue: number, config: SliderConfig) => SliderParameter} slider - slider property
- * @property {(defaultValue: string, config: ColorConfig) => ColorParameter} color - color property
- * @property {(defaultValue: boolean, config: ToggleConfig) => ToggleParameter} toggle - toggle property
- * @property {(defaultValue: string | number, config: SelectConfig) => SelectParameter} select - select property
- * @property {(defaultValue: string, config: TextConfig) => TextParameter} text - text property
- * @property {(defaultValue: number, config: NumberConfig) => NumberParameter} number - number property
- * @property {(defaultValue: null, config: ImageConfig) => ImageParameter} image - image property
- */
-/**
- * FaceData interface
- * @typedef {Object} FaceData
- * @property {number} id - id property
- * @property {Object} bounds - bounds property
- * @property {number} bounds.x - x property
- * @property {number} bounds.y - y property
- * @property {number} bounds.width - width property
- * @property {number} bounds.height - height property
- */
-/**
- * HandData interface
- * @typedef {Object} HandData
- * @property {number} id - id property
- * @property {'left' | 'right'} handedness - handedness property
- * @property {number} confidence - confidence property
- * @property {Object} bounds - bounds property
- * @property {number} bounds.x - x property
- * @property {number} bounds.y - y property
- * @property {number} bounds.width - width property
- * @property {number} bounds.height - height property
- */
-/**
- * PoseData interface
- * @typedef {Object} PoseData
- * @property {number} confidence - confidence property
- * @property {Object} landmarks - landmarks property
- * @property {number} landmarks.x - x property
- * @property {number} landmarks.y - y property
- * @property {number} landmarks.z - z property
- * @property {number} landmarks.visibility - visibility property
- */
-/**
- * SegmentationData interface
- * @typedef {Object} SegmentationData
- * @property {Uint8Array} mask - mask property
- * @property {number} width - width property
- * @property {number} height - height property
- */
-/**
- * DeviceMotionData interface
- * @typedef {Object} DeviceMotionData
- * @property {Object} acceleration - Acceleration without gravity (m/s²)
- * @property {number |null} acceleration.x - x property
- * @property {number |null} acceleration.y - y property
- * @property {number |null} acceleration.z - z property
- */
-/**
- * DeviceOrientationData interface
- * @typedef {Object} DeviceOrientationData
- * @property {number |null} alpha - Rotation around Z-axis (0-360 degrees, compass heading)
- * @property {number |null} beta - Rotation around X-axis (-180 to 180 degrees, front-to-back tilt)
- * @property {number |null} gamma - Rotation around Y-axis (-90 to 90 degrees, left-to-right tilt)
- * @property {boolean} absolute - True if using magnetometer (compass) for absolute orientation
+ * Global viji object available in artist code
+ * @type {VijiAPI}
  */
+declare const viji;
 /**
- * DeviceSensorState interface
- * @typedef {Object} DeviceSensorState
- * @property {DeviceMotionData |null} motion - motion property
- * @property {DeviceOrientationData |null} orientation - orientation property
+ * Type alias for render function
+ * @typedef {function(VijiAPI): void} Render
  */
 /**
- * DeviceState interface
- * @typedef {Object} DeviceState
- * @property {string} id - Unique device identifier
- * @property {string} name - User-friendly device name
- * @property {VideoAPI |null} video - Device camera video (null if not available)
+ * Type alias for setup function
+ * @typedef {function(VijiAPI): void} Setup
  */
 /**
- * Global viji object available in artist code
- * @type {VijiAPI}
+ * Artist render function - called every frame
+ * @param {VijiAPI} viji - The viji API object with all capabilities
  */
-declare const viji;
+declare function render(viji): void;
 /**
- * Artist render function - called every frame
+ * Artist setup function - called once at initialization
  * @param {VijiAPI} viji - The viji API object with all capabilities
  */
-declare function render(viji): void;
+declare function setup(viji): void;

package/dist/artist-jsdoc.d.ts CHANGED Viewed

@@ -4,335 +4,29 @@
  */
 /**
- * Configuration for slider parameters
- * @typedef {Object} SliderConfig
- * @property {number} [min] - min property
- * @property {number} [max] - max 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
- */
-/**
- * Configuration for color parameters
- * @typedef {Object} ColorConfig
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} [group] - group property
- * @property {ParameterCategory} [category] - category property
- */
-/**
- * Configuration for toggle parameters
- * @typedef {Object} ToggleConfig
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} [group] - group property
- * @property {ParameterCategory} [category] - category property
- */
-/**
- * Configuration for select parameters
- * @typedef {Object} SelectConfig
- * @property {string[] | number[]} options - options property
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} [group] - group property
- * @property {ParameterCategory} [category] - category property
- */
-/**
- * Configuration for text parameters
- * @typedef {Object} TextConfig
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} [group] - group property
- * @property {ParameterCategory} [category] - category property
- * @property {number} [maxLength] - maxLength property
- */
-/**
- * Configuration for number parameters
- * @typedef {Object} NumberConfig
- * @property {number} [min] - min property
- * @property {number} [max] - max 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
- */
-/**
- * Configuration for image parameters
- * @typedef {Object} ImageConfig
- * @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
- * @property {number} value - value property
- * @property {number} min - min property
- * @property {number} max - max 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
- */
-/**
- * Parameter object for color parameters
- * @typedef {Object} ColorParameter
- * @property {string} value - value property
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} group - group property
- * @property {ParameterCategory} category - category property
- */
-/**
- * Parameter object for toggle parameters
- * @typedef {Object} ToggleParameter
- * @property {boolean} value - value property
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} group - group property
- * @property {ParameterCategory} category - category property
- */
-/**
- * Parameter object for select parameters
- * @typedef {Object} SelectParameter
- * @property {string | number} value - value property
- * @property {string[] | number[]} options - options property
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} group - group property
- * @property {ParameterCategory} category - category property
- */
-/**
- * Parameter object for text parameters
- * @typedef {Object} TextParameter
- * @property {string} value - value property
- * @property {number} [maxLength] - maxLength property
- * @property {string} label - label property
- * @property {string} [description] - description property
- * @property {string} group - group property
- * @property {ParameterCategory} category - category property
- */
-/**
- * Parameter object for number parameters
- * @typedef {Object} NumberParameter
- * @property {number} value - value property
- * @property {number} min - min property
- * @property {number} max - max 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
- */
-/**
- * Parameter object for image parameters
- * @typedef {Object} ImageParameter
- * @property {ImageBitmap | OffscreenCanvas |null} value - value 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
- * @property {boolean} isConnected - isConnected property
- * @property {Object} volume - volume property
- * @property {number} volume.current - current property
- * @property {number} volume.peak - peak property
- * @property {number} volume.smoothed - smoothed property
- */
-/**
- * Video frame API - provides access to video stream and computer vision data
- * @typedef {Object} VideoAPI
- * @property {boolean} isConnected - isConnected property
- * @property {OffscreenCanvas | ImageBitmap |null} currentFrame - currentFrame property
- * @property {number} frameWidth - frameWidth property
- * @property {number} frameHeight - frameHeight property
- * @property {number} frameRate - frameRate property
- * @property {() => ImageData |null} getFrameData - getFrameData property
- * @property {FaceData[]} faces - faces property
- * @property {HandData[]} hands - hands property
- * @property {PoseData |null} pose - pose property
- * @property {SegmentationData |null} segmentation - segmentation property
- * @property {Object} cv - cv property
- */
-/**
- * Mouse interaction API
- * @typedef {Object} MouseAPI
- * @property {number} x - x property
- * @property {number} y - y property
- * @property {boolean} isInCanvas - isInCanvas property
- * @property {boolean} isPressed - isPressed property
- * @property {boolean} leftButton - leftButton property
- * @property {boolean} rightButton - rightButton property
- * @property {boolean} middleButton - middleButton property
- * @property {Object} velocity - velocity property
- * @property {number} velocity.x - x property
- * @property {number} velocity.y - y property
- */
-/**
- * Keyboard interaction API
- * @typedef {Object} KeyboardAPI
- * @property {Set<string>} activeKeys - activeKeys property
- * @property {Set<string>} pressedThisFrame - pressedThisFrame property
- * @property {Set<string>} releasedThisFrame - releasedThisFrame property
- * @property {string} lastKeyPressed - lastKeyPressed property
- * @property {string} lastKeyReleased - lastKeyReleased property
- * @property {boolean} shift - shift property
- * @property {boolean} ctrl - ctrl property
- * @property {boolean} alt - alt property
- * @property {boolean} meta - meta property
- */
-/**
- * Touch interaction API
- * @typedef {Object} TouchAPI
- * @property {TouchPoint[]} points - points property
- * @property {number} count - count property
- * @property {TouchPoint[]} started - started property
- * @property {TouchPoint[]} moved - moved property
- * @property {TouchPoint[]} ended - ended property
- * @property {TouchPoint |null} primary - primary property
- * @property {TouchGestureAPI} gestures - gestures property
- */
-/**
- * Main Viji Artist API - provides access to canvas, timing, audio, video, and interactions
- * @typedef {Object} VijiAPI
- * @property {OffscreenCanvas} canvas - canvas property
- * @property {OffscreenCanvasRenderingContext2D} [ctx] - ctx property
- * @property {WebGL2RenderingContext} [gl] - gl property
- * @property {number} width - width property
- * @property {number} height - height property
- * @property {number} pixelRatio - pixelRatio property
- * @property {number} time - time property
- * @property {number} deltaTime - deltaTime property
- * @property {number} frameCount - frameCount property
- * @property {number} fps - fps property
- * @property {AudioAPI} audio - audio property
- * @property {VideoAPI} video - video property
- * @property {VideoAPI[]} streams - streams property
- * @property {MouseAPI} mouse - mouse property
- * @property {KeyboardAPI} keyboard - keyboard property
- * @property {TouchAPI} touches - touches property
- * @property {DeviceSensorState} device - device property
- * @property {DeviceState[]} devices - devices property
- * @property {(defaultValue: number, config: SliderConfig) => SliderParameter} slider - slider property
- * @property {(defaultValue: string, config: ColorConfig) => ColorParameter} color - color property
- * @property {(defaultValue: boolean, config: ToggleConfig) => ToggleParameter} toggle - toggle property
- * @property {(defaultValue: string | number, config: SelectConfig) => SelectParameter} select - select property
- * @property {(defaultValue: string, config: TextConfig) => TextParameter} text - text property
- * @property {(defaultValue: number, config: NumberConfig) => NumberParameter} number - number property
- * @property {(defaultValue: null, config: ImageConfig) => ImageParameter} image - image property
- */
-/**
- * FaceData interface
- * @typedef {Object} FaceData
- * @property {number} id - id property
- * @property {Object} bounds - bounds property
- * @property {number} bounds.x - x property
- * @property {number} bounds.y - y property
- * @property {number} bounds.width - width property
- * @property {number} bounds.height - height property
- */
-/**
- * HandData interface
- * @typedef {Object} HandData
- * @property {number} id - id property
- * @property {'left' | 'right'} handedness - handedness property
- * @property {number} confidence - confidence property
- * @property {Object} bounds - bounds property
- * @property {number} bounds.x - x property
- * @property {number} bounds.y - y property
- * @property {number} bounds.width - width property
- * @property {number} bounds.height - height property
- */
-/**
- * PoseData interface
- * @typedef {Object} PoseData
- * @property {number} confidence - confidence property
- * @property {Object} landmarks - landmarks property
- * @property {number} landmarks.x - x property
- * @property {number} landmarks.y - y property
- * @property {number} landmarks.z - z property
- * @property {number} landmarks.visibility - visibility property
- */
-/**
- * SegmentationData interface
- * @typedef {Object} SegmentationData
- * @property {Uint8Array} mask - mask property
- * @property {number} width - width property
- * @property {number} height - height property
- */
-/**
- * DeviceMotionData interface
- * @typedef {Object} DeviceMotionData
- * @property {Object} acceleration - Acceleration without gravity (m/s²)
- * @property {number |null} acceleration.x - x property
- * @property {number |null} acceleration.y - y property
- * @property {number |null} acceleration.z - z property
- */
-/**
- * DeviceOrientationData interface
- * @typedef {Object} DeviceOrientationData
- * @property {number |null} alpha - Rotation around Z-axis (0-360 degrees, compass heading)
- * @property {number |null} beta - Rotation around X-axis (-180 to 180 degrees, front-to-back tilt)
- * @property {number |null} gamma - Rotation around Y-axis (-90 to 90 degrees, left-to-right tilt)
- * @property {boolean} absolute - True if using magnetometer (compass) for absolute orientation
+ * Global viji object available in artist code
+ * @type {VijiAPI}
  */
+declare const viji;
 /**
- * DeviceSensorState interface
- * @typedef {Object} DeviceSensorState
- * @property {DeviceMotionData |null} motion - motion property
- * @property {DeviceOrientationData |null} orientation - orientation property
+ * Type alias for render function
+ * @typedef {function(VijiAPI): void} Render
  */
 /**
- * DeviceState interface
- * @typedef {Object} DeviceState
- * @property {string} id - Unique device identifier
- * @property {string} name - User-friendly device name
- * @property {VideoAPI |null} video - Device camera video (null if not available)
+ * Type alias for setup function
+ * @typedef {function(VijiAPI): void} Setup
  */
 /**
- * Global viji object available in artist code
- * @type {VijiAPI}
+ * Artist render function - called every frame
+ * @param {VijiAPI} viji - The viji API object with all capabilities
  */
-declare const viji;
+declare function render(viji): void;
 /**
- * Artist render function - called every frame
+ * Artist setup function - called once at initialization
  * @param {VijiAPI} viji - The viji API object with all capabilities
  */
-declare function render(viji): void;
+declare function setup(viji): void;

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@viji-dev/core",
-  "version": "0.3.12",
+  "version": "0.3.14",
   "description": "Universal execution engine for Viji Creative scenes",
   "type": "module",
   "main": "./dist/index.js",