@viji-dev/core 0.4.1 → 0.4.2

package/dist/artist-jsdoc.d.ts

@@ -12,7 +12,7 @@
  * @property {string} label - Display name shown next to the control in the parameter UI. Required.
  * @property {string} [description] - Optional tooltip / help text shown next to the control.
  * @property {string} [group] - Group name for organizing related parameters under a shared heading. Default: `'general'`.
- * @property {ParameterCategory} [category] - Visibility category — the control hides when its capability is unavailable. Default: `'general'`.
+ * @property {ParameterCategory} [category] - Visibility category. The control hides when its capability is unavailable. Default: `'general'`.
  */
 
 /**
@@ -21,7 +21,7 @@
  * @property {string} label - Display name shown next to the color swatch in the parameter UI. Required.
  * @property {string} [description] - Optional tooltip / help text shown next to the control.
  * @property {string} [group] - Group name for organizing related parameters under a shared heading. Default: `'general'`.
- * @property {ParameterCategory} [category] - Visibility category — the control hides when its capability is unavailable. Default: `'general'`.
+ * @property {ParameterCategory} [category] - Visibility category. The control hides when its capability is unavailable. Default: `'general'`.
  */
 
 /**
@@ -30,7 +30,7 @@
  * @property {string} label - Display name shown next to the switch in the parameter UI. Required.
  * @property {string} [description] - Optional tooltip / help text shown next to the control.
  * @property {string} [group] - Group name for organizing related parameters under a shared heading. Default: `'general'`.
- * @property {ParameterCategory} [category] - Visibility category — the control hides when its capability is unavailable. Default: `'general'`.
+ * @property {ParameterCategory} [category] - Visibility category. The control hides when its capability is unavailable. Default: `'general'`.
  */
 
 /**
@@ -40,7 +40,7 @@
  * @property {string} label - Display name shown next to the dropdown in the parameter UI. Required.
  * @property {string} [description] - Optional tooltip / help text shown next to the control.
  * @property {string} [group] - Group name for organizing related parameters under a shared heading. Default: `'general'`.
- * @property {ParameterCategory} [category] - Visibility category — the control hides when its capability is unavailable. Default: `'general'`.
+ * @property {ParameterCategory} [category] - Visibility category. The control hides when its capability is unavailable. Default: `'general'`.
  */
 
 /**
@@ -49,7 +49,7 @@
  * @property {string} label - Display name shown next to the text field in the parameter UI. Required.
  * @property {string} [description] - Optional tooltip / help text shown next to the control.
  * @property {string} [group] - Group name for organizing related parameters under a shared heading. Default: `'general'`.
- * @property {ParameterCategory} [category] - Visibility category — the control hides when its capability is unavailable. Default: `'general'`.
+ * @property {ParameterCategory} [category] - Visibility category. The control hides when its capability is unavailable. Default: `'general'`.
  * @property {number} [maxLength] - Maximum character count enforced by the host UI. Default: `1000`.
  */
 
@@ -62,7 +62,7 @@
  * @property {string} label - Display name shown next to the input in the parameter UI. Required.
  * @property {string} [description] - Optional tooltip / help text shown next to the control.
  * @property {string} [group] - Group name for organizing related parameters under a shared heading. Default: `'general'`.
- * @property {ParameterCategory} [category] - Visibility category — the control hides when its capability is unavailable. Default: `'general'`.
+ * @property {ParameterCategory} [category] - Visibility category. The control hides when its capability is unavailable. Default: `'general'`.
  */
 
 /**
@@ -71,16 +71,16 @@
  * @property {string} label - Display name shown next to the upload field in the parameter UI. Required.
  * @property {string} [description] - Optional tooltip / help text shown next to the control.
  * @property {string} [group] - Group name for organizing related parameters under a shared heading. Default: `'general'`.
- * @property {ParameterCategory} [category] - Visibility category — the control hides when its capability is unavailable. Default: `'general'`.
+ * @property {ParameterCategory} [category] - Visibility category. The control hides when its capability is unavailable. Default: `'general'`.
  */
 
 /**
- * Configuration object passed to `viji.button()`. The host renders a clickable momentary button — the resulting `value` is `true` for one frame after press, then auto-resets to `false`.
+ * Configuration object passed to `viji.button()`. The host renders a clickable momentary button. The resulting `value` is `true` for one frame after press, then auto-resets to `false`.
  * @typedef {Object} ButtonConfig
  * @property {string} label - Display name shown on the button in the parameter UI. Required.
  * @property {string} [description] - Optional tooltip / help text shown next to the control.
  * @property {string} [group] - Group name for organizing related parameters under a shared heading. Default: `'general'`.
- * @property {ParameterCategory} [category] - Visibility category — the control hides when its capability is unavailable. Default: `'general'`.
+ * @property {ParameterCategory} [category] - Visibility category. The control hides when its capability is unavailable. Default: `'general'`.
  */
 
 /**
@@ -90,7 +90,7 @@
  * @property {string} label - Display name shown next to the pad in the parameter UI. Required.
  * @property {string} [description] - Optional tooltip / help text shown next to the control.
  * @property {string} [group] - Group name for organizing related parameters under a shared heading. Default: `'general'`.
- * @property {ParameterCategory} [category] - Visibility category — the control hides when its capability is unavailable. Default: `'general'`.
+ * @property {ParameterCategory} [category] - Visibility category. The control hides when its capability is unavailable. Default: `'general'`.
  */
 
 /**
@@ -103,7 +103,7 @@
  * @property {string} label - Display name shown next to the control in the parameter UI.
  * @property {string} [description] - Tooltip / help text for the control (empty string when not configured).
  * @property {string} group - Group name under which the control appears in the UI.
- * @property {ParameterCategory} category - Visibility category — controls when the parameter is shown.
+ * @property {ParameterCategory} category - Visibility category that controls when the parameter is shown.
  */
 
 /**
@@ -121,7 +121,7 @@
  * @property {string} label - Display name shown next to the swatch in the parameter UI.
  * @property {string} [description] - Tooltip / help text for the control (empty string when not configured).
  * @property {string} group - Group name under which the control appears in the UI.
- * @property {ParameterCategory} category - Visibility category — controls when the parameter is shown.
+ * @property {ParameterCategory} category - Visibility category that controls when the parameter is shown.
  */
 
 /**
@@ -131,7 +131,7 @@
  * @property {string} label - Display name shown next to the switch in the parameter UI.
  * @property {string} [description] - Tooltip / help text for the control (empty string when not configured).
  * @property {string} group - Group name under which the control appears in the UI.
- * @property {ParameterCategory} category - Visibility category — controls when the parameter is shown.
+ * @property {ParameterCategory} category - Visibility category that controls when the parameter is shown.
  */
 
 /**
@@ -142,7 +142,7 @@
  * @property {string} label - Display name shown next to the dropdown in the parameter UI.
  * @property {string} [description] - Tooltip / help text for the control (empty string when not configured).
  * @property {string} group - Group name under which the control appears in the UI.
- * @property {ParameterCategory} category - Visibility category — controls when the parameter is shown.
+ * @property {ParameterCategory} category - Visibility category that controls when the parameter is shown.
  */
 
 /**
@@ -153,7 +153,7 @@
  * @property {string} label - Display name shown next to the input in the parameter UI.
  * @property {string} [description] - Tooltip / help text for the control (empty string when not configured).
  * @property {string} group - Group name under which the control appears in the UI.
- * @property {ParameterCategory} category - Visibility category — controls when the parameter is shown.
+ * @property {ParameterCategory} category - Visibility category that controls when the parameter is shown.
  */
 
 /**
@@ -166,27 +166,27 @@
  * @property {string} label - Display name shown next to the input in the parameter UI.
  * @property {string} [description] - Tooltip / help text for the control (empty string when not configured).
  * @property {string} group - Group name under which the control appears in the UI.
- * @property {ParameterCategory} category - Visibility category — controls when the parameter is shown.
+ * @property {ParameterCategory} category - Visibility category that controls when the parameter is shown.
  */
 
 /**
  * Reactive object returned by `viji.image()`. `value` is `null` until the user uploads an image; in P5 scenes a `.p5` accessor is also added at runtime so the image works directly with `image()`, `texture()`, etc.
  * @typedef {Object} ImageParameter
  * @property {ImageBitmap |null} value - Uploaded image as an `ImageBitmap`, or `null` until the user provides one.
- * @property {string} label - P5-compatible image wrapper. Only available in the P5 renderer — added at runtime by the P5 adapter. Display name shown next to the upload field in the parameter UI.
+ * @property {string} label - P5-compatible image wrapper. Only available in the P5 renderer; added at runtime by the P5 adapter. Display name shown next to the upload field in the parameter UI.
  * @property {string} [description] - Tooltip / help text for the control (empty string when not configured).
  * @property {string} group - Group name under which the control appears in the UI.
- * @property {ParameterCategory} category - Visibility category — controls when the parameter is shown.
+ * @property {ParameterCategory} category - Visibility category that controls when the parameter is shown.
  */
 
 /**
- * Reactive object returned by `viji.button()`. `value` is a momentary flag — `true` for exactly one frame after the user clicks, then auto-resets to `false`. Use it to trigger discrete events from `render()`.
+ * Reactive object returned by `viji.button()`. `value` is a momentary flag: `true` for exactly one frame after the user clicks, then auto-resets to `false`. Use it to trigger discrete events from `render()`.
  * @typedef {Object} ButtonParameter
  * @property {boolean} value - `true` for the single frame after the user clicks the button, `false` otherwise.
  * @property {string} label - Display name shown on the button in the parameter UI.
  * @property {string} [description] - Tooltip / help text for the control (empty string when not configured).
  * @property {string} group - Group name under which the control appears in the UI.
- * @property {ParameterCategory} category - Visibility category — controls when the parameter is shown.
+ * @property {ParameterCategory} category - Visibility category that controls when the parameter is shown.
  */
 
 /**
@@ -197,7 +197,7 @@
  * @property {string} label - Display name shown next to the pad in the parameter UI.
  * @property {string} [description] - Tooltip / help text for the control (empty string when not configured).
  * @property {string} group - Group name under which the control appears in the UI.
- * @property {ParameterCategory} category - Visibility category — controls when the parameter is shown.
+ * @property {ParameterCategory} category - Visibility category that controls when the parameter is shown.
  */
 
 /**
@@ -209,11 +209,11 @@
  * @property {number} volume.peak - Instantaneous peak amplitude in 0..1.
  * @property {number} volume.smoothed - Volume with a 200ms decay envelope; rises fast, falls smoothly. Use for flicker-free animations.
  * @property {Object} bands - Energy in five fixed frequency bands, plus a smoothed companion (~150ms decay) for each. All in 0..1.
- * @property {number} bands.low - Instant low-band energy (20–120 Hz, bass/kick range). 0..1.
- * @property {number} bands.lowMid - Instant low-mid energy (120–400 Hz). 0..1.
- * @property {number} bands.mid - Instant mid energy (400–1600 Hz, vocals/instruments). 0..1.
- * @property {number} bands.highMid - Instant high-mid energy (1600–6000 Hz, cymbals/hi-hats). 0..1.
- * @property {number} bands.high - Instant high-band energy (6000–16000 Hz, air/brilliance). 0..1.
+ * @property {number} bands.low - Instant low-band energy (20-120 Hz, bass/kick range). 0..1.
+ * @property {number} bands.lowMid - Instant low-mid energy (120-400 Hz). 0..1.
+ * @property {number} bands.mid - Instant mid energy (400-1600 Hz, vocals/instruments). 0..1.
+ * @property {number} bands.highMid - Instant high-mid energy (1600-6000 Hz, cymbals/hi-hats). 0..1.
+ * @property {number} bands.high - Instant high-band energy (6000-16000 Hz, air/brilliance). 0..1.
  * @property {number} bands.lowSmoothed - Smoothed `low` (~150ms decay). 0..1.
  * @property {number} bands.lowMidSmoothed - Smoothed `lowMid` (~150ms decay). 0..1.
  * @property {number} bands.midSmoothed - Smoothed `mid` (~150ms decay). 0..1.
@@ -232,14 +232,14 @@
  * @property {number} beat.confidence - Confidence of the BPM tracker in 0..1.
  * @property {boolean} beat.isLocked - `true` when the BPM tracker has a stable lock on the current tempo.
  * @property {Object} spectral - High-level spectral features derived from the FFT.
- * @property {number} spectral.brightness - Normalized spectral centroid in 0..1 — higher values mean brighter, more treble-heavy sound.
- * @property {number} spectral.flatness - Normalized spectral flatness in 0..1 — higher values mean noisier (white-noise-like) sound; lower values mean tonal.
- * @property {() => Uint8Array} getFrequencyData - Returns the raw FFT magnitude spectrum as a `Uint8Array` (1024 bins, each 0..255). Bin `i` covers frequency `i × (sampleRate / fftSize)`. The returned array is a snapshot from the latest analysis tick — repeated calls in the same frame return the same data. @example const fft = viji.audio.getFrequencyData(); for (let i = 0; i < fft.length; i++) drawBar(i, fft[i] / 255);
- * @property {() => Float32Array} getWaveform - Returns the raw time-domain waveform as a `Float32Array` (2048 PCM samples in -1..1). The returned array is a snapshot — repeated calls in the same frame return the same data. @example const wave = viji.audio.getWaveform(); for (let i = 0; i < wave.length; i++) drawSample(i, wave[i]);
+ * @property {number} spectral.brightness - Normalized spectral centroid in 0..1. Higher values mean brighter, more treble-heavy sound.
+ * @property {number} spectral.flatness - Normalized spectral flatness in 0..1. Higher values mean noisier (white-noise-like) sound; lower values mean tonal.
+ * @property {() => Uint8Array} getFrequencyData - Returns the raw FFT magnitude spectrum as a `Uint8Array` (1024 bins, each 0..255). Bin `i` covers frequency `i × (sampleRate / fftSize)`. The returned array is a snapshot from the latest analysis tick; repeated calls in the same frame return the same data. @example const fft = viji.audio.getFrequencyData(); for (let i = 0; i < fft.length; i++) drawBar(i, fft[i] / 255);
+ * @property {() => Float32Array} getWaveform - Returns the raw time-domain waveform as a `Float32Array` (2048 PCM samples in -1..1). The returned array is a snapshot; repeated calls in the same frame return the same data. @example const wave = viji.audio.getWaveform(); for (let i = 0; i < wave.length; i++) drawSample(i, wave[i]);
  */
 
 /**
- * Lightweight audio analysis for additional or device audio streams. A strict subset of `AudioAPI` — exposes volume, frequency bands, spectral features, and raw FFT/waveform access, but **no beat detection** (no `beat`, no BPM, no triggers, no events).
+ * Lightweight audio analysis for additional or device audio streams. A strict subset of `AudioAPI` that exposes volume, frequency bands, spectral features, and raw FFT/waveform access, but **no beat detection** (no `beat`, no BPM, no triggers, no events).
  * @typedef {Object} AudioStreamAPI
  * @property {boolean} isConnected - `true` when this audio stream is connected; otherwise all numeric fields read as `0`.
  * @property {Object} volume - Overall loudness across the stream.
@@ -247,11 +247,11 @@
  * @property {number} volume.peak - Instantaneous peak amplitude in 0..1.
  * @property {number} volume.smoothed - Volume with a 200ms decay envelope.
  * @property {Object} bands - Energy in five fixed frequency bands, plus a smoothed companion (~150ms decay) for each. All in 0..1.
- * @property {number} bands.low - Instant low-band energy (20–120 Hz). 0..1.
- * @property {number} bands.lowMid - Instant low-mid energy (120–400 Hz). 0..1.
- * @property {number} bands.mid - Instant mid energy (400–1600 Hz). 0..1.
- * @property {number} bands.highMid - Instant high-mid energy (1600–6000 Hz). 0..1.
- * @property {number} bands.high - Instant high-band energy (6000–16000 Hz). 0..1.
+ * @property {number} bands.low - Instant low-band energy (20-120 Hz). 0..1.
+ * @property {number} bands.lowMid - Instant low-mid energy (120-400 Hz). 0..1.
+ * @property {number} bands.mid - Instant mid energy (400-1600 Hz). 0..1.
+ * @property {number} bands.highMid - Instant high-mid energy (1600-6000 Hz). 0..1.
+ * @property {number} bands.high - Instant high-band energy (6000-16000 Hz). 0..1.
  * @property {number} bands.lowSmoothed - Smoothed `low` (~150ms decay). 0..1.
  * @property {number} bands.lowMidSmoothed - Smoothed `lowMid` (~150ms decay). 0..1.
  * @property {number} bands.midSmoothed - Smoothed `mid` (~150ms decay). 0..1.
@@ -260,8 +260,8 @@
  * @property {Object} spectral - High-level spectral features derived from the FFT.
  * @property {number} spectral.brightness - Normalized spectral centroid in 0..1.
  * @property {number} spectral.flatness - Normalized spectral flatness in 0..1.
- * @property {() => Uint8Array} getFrequencyData - Returns the raw FFT magnitude spectrum for this stream as a `Uint8Array` (1024 bins, each 0..255). Snapshot semantics — see `AudioAPI.getFrequencyData`.
- * @property {() => Float32Array} getWaveform - Returns the raw time-domain waveform for this stream as a `Float32Array` (2048 samples, each -1..1). Snapshot semantics — see `AudioAPI.getWaveform`.
+ * @property {() => Uint8Array} getFrequencyData - Returns the raw FFT magnitude spectrum for this stream as a `Uint8Array` (1024 bins, each 0..255). Snapshot semantics; see `AudioAPI.getFrequencyData`.
+ * @property {() => Float32Array} getWaveform - Returns the raw time-domain waveform for this stream as a `Float32Array` (2048 samples, each -1..1). Snapshot semantics; see `AudioAPI.getWaveform`.
  */
 
 /**
@@ -272,7 +272,7 @@
  * @property {number} frameWidth - Source video frame width in pixels. `0` when disconnected.
  * @property {number} frameHeight - Source video frame height in pixels. `0` when disconnected.
  * @property {number} frameRate - Source video frame rate in Hz (frames per second). `0` when disconnected.
- * @property {() => ImageData |null} getFrameData - Returns the latest frame as raw RGBA `ImageData` for per-pixel CPU analysis, or `null` when disconnected. Slow compared to drawing `currentFrame` directly — use only when you need to read individual pixel values.
+ * @property {() => ImageData |null} getFrameData - Returns the latest frame as raw RGBA `ImageData` for per-pixel CPU analysis, or `null` when disconnected. Slow compared to drawing `currentFrame` directly; use only when you need to read individual pixel values.
  * @property {FaceData[]} faces - Detected faces (empty array when face detection is off or no faces are visible).
  * @property {HandData[]} hands - Detected hands (up to 2; empty array when hand tracking is off or no hands are visible).
  * @property {PoseData |null} pose - Detected body pose, or `null` when pose detection is off or no pose is visible.
@@ -319,7 +319,7 @@
  */
 
 /**
- * Multi-touch input state. Lists all active touches, plus per-frame `started` / `moved` / `ended` arrays for frame-based gesture handling. For single-point interactions that should also work with a mouse, prefer `viji.pointer` — it switches automatically between mouse and primary touch.
+ * Multi-touch input state. Lists all active touches, plus per-frame `started` / `moved` / `ended` arrays for frame-based gesture handling. For single-point interactions that should also work with a mouse, prefer `viji.pointer`. It switches automatically between mouse and primary touch.
  * @typedef {Object} TouchAPI
  * @property {TouchPoint[]} points - All currently active touch points. Order is stable but not ordered by id.
  * @property {number} count - Number of currently active touches (equivalent to `points.length`).
@@ -335,34 +335,34 @@
  * @property {OffscreenCanvas} canvas - The `OffscreenCanvas` driving the scene. The host owns its lifecycle and dimensions; prefer `useContext()` over touching this directly.
  * @property {OffscreenCanvasRenderingContext2D} [ctx] - 2D rendering context. `undefined` until `viji.useContext('2d')` is called; afterwards equals the cached context.
  * @property {WebGLRenderingContext | WebGL2RenderingContext} [gl] - WebGL rendering context. `undefined` until `viji.useContext('webgl')` or `'webgl2'` is called; afterwards equals the cached context.
- * @property {number} width - Current canvas width in pixels. Updates automatically when the host resizes the canvas — read every frame.
- * @property {number} height - Current canvas height in pixels. Updates automatically when the host resizes the canvas — read every frame.
+ * @property {number} width - Current canvas width in pixels. Updates automatically when the host resizes the canvas; read every frame.
+ * @property {number} height - Current canvas height in pixels. Updates automatically when the host resizes the canvas; read every frame.
  * @property {number} time - Seconds elapsed since the scene started (monotonically increasing float). Use for oscillations and absolute-time effects.
- * @property {number} deltaTime - Seconds since the previous frame. Use for accumulation: movement, physics, fades — anything that should progress per second regardless of FPS.
+ * @property {number} deltaTime - Seconds since the previous frame. Use for accumulation: movement, physics, fades, anything that should progress per second regardless of FPS.
  * @property {number} frameCount - Integer frame counter starting at `0` and incrementing by `1` each frame.
  * @property {number} fps - Target frames-per-second for the host's current frame-rate mode (`60` for `'full'`, `30` for `'half'`).
  * @property {AudioAPI} audio - Real-time analysis of the main audio stream: volume, frequency bands, beat detection, spectral features. Fields are zeroed when no audio source is connected.
  * @property {VideoAPI} video - Main video stream API: pixel access, frame metadata, and computer-vision results (face, hands, pose, segmentation).
- * @property {VideoAPI[]} videoStreams - Additional video streams provided by the host. These do not run CV processing — use them for raw pixel access only.
- * @property {AudioStreamAPI[]} audioStreams - Additional audio streams (lightweight analysis: volume, bands, spectral). No beat detection — use the main `audio` for that.
+ * @property {VideoAPI[]} videoStreams - Additional video streams provided by the host. These do not run CV processing; use them for raw pixel access only.
+ * @property {AudioStreamAPI[]} audioStreams - Additional audio streams (lightweight analysis: volume, bands, spectral). No beat detection; use the main `audio` for that.
  * @property {MouseAPI} mouse - Mouse position, buttons, wheel, and per-frame movement state. Coordinates are in canvas pixels.
  * @property {KeyboardAPI} keyboard - Keyboard state: per-frame press/release queries, currently held keys, and modifier flags.
  * @property {TouchAPI} touches - Multi-touch state: count, primary touch shortcut, and the per-frame `started` / `moved` / `ended` arrays.
- * @property {PointerAPI} pointer - Unified pointer (mouse + primary touch) — convenient single-point input that works on both desktop and mobile.
+ * @property {PointerAPI} pointer - Unified pointer (mouse + primary touch). Convenient single-point input that works on both desktop and mobile.
  * @property {DeviceSensorState} device - Internal device sensors (motion + orientation) reported by the device running the scene.
  * @property {DeviceState[]} devices - External connected devices reporting sensor / camera / audio. Each entry has its own `id`, `name`, and per-device API surface.
- * @property {(defaultValue: number, config: SliderConfig) => SliderParameter} slider - Declares a numeric slider parameter. The host UI renders a draggable slider. Must be called at the top level of the scene — never inside `render()`. @example const radius = viji.slider(50, { min: 10, max: 200, step: 1, label: 'Radius' }); // ... function render(viji) { drawCircle(radius.value); }
- * @property {(defaultValue: ColorInput, config: ColorConfig) => ColorParameter} color - Declares a color parameter. Accepts hex strings, CSS color functions, or RGB / HSB objects; the value is always normalized to a canonical lowercase hex string and exposes derived `.rgb` / `.hsb` accessors. Must be called at the top level of the scene — never inside `render()`. @example const tint = viji.color('#ff6600', { label: 'Tint' }); // tint.value -> '#ff6600', tint.rgb -> { r: 255, g: 102, b: 0 }, tint.hsb -> { h: 24, s: 100, b: 100 }
- * @property {(defaultValue: boolean, config: ToggleConfig) => ToggleParameter} toggle - Declares a boolean toggle parameter. The host UI renders an on/off switch. Must be called at the top level of the scene — never inside `render()`. @example const showTrail = viji.toggle(true, { label: 'Show Trail' });
- * @property {(defaultValue: string | number, config: SelectConfig) => SelectParameter} select - Declares a dropdown selection parameter. The element type of `options` (`string` or `number`) determines the parameter's value type. Must be called at the top level of the scene — never inside `render()`. @example const shape = viji.select('circle', { options: ['circle', 'square', 'triangle'], label: 'Shape' });
- * @property {(defaultValue: string, config: TextConfig) => TextParameter} text - Declares a text input parameter. The host UI renders a single-line text field. Must be called at the top level of the scene — never inside `render()`. @example const caption = viji.text('Hello', { label: 'Caption', maxLength: 64 });
- * @property {(defaultValue: number, config: NumberConfig) => NumberParameter} number - Declares a precise numeric input parameter. Like `slider()` but the host UI shows a number field instead of a draggable handle. Must be called at the top level of the scene — never inside `render()`. @example const count = viji.number(12, { min: 1, max: 64, step: 1, label: 'Count' });
- * @property {(defaultValue: null, config: ImageConfig) => ImageParameter} image - Declares an image upload parameter. The user-supplied image becomes available as `value` (an `ImageBitmap`); in P5 scenes a `.p5` accessor is also added at runtime. Must be called at the top level of the scene — never inside `render()`. @example const tex = viji.image(null, { label: 'Texture' }); if (tex.value) ctx.drawImage(tex.value, 0, 0, viji.width, viji.height);
- * @property {(config: ButtonConfig) => ButtonParameter} button - Declares a momentary button parameter. `value` is `true` for one frame after the user clicks, then auto-resets — perfect for triggering discrete events. Must be called at the top level of the scene — never inside `render()`. @example const reset = viji.button({ label: 'Reset' }); function render(viji) { if (reset.value) state = initialState; }
- * @property {(defaultValue: CoordinateValue, config: CoordinateConfig) => CoordinateParameter} coordinate - Declares a 2D coordinate parameter. Both `value.x` and `value.y` are in `-1..1`. Must be called at the top level of the scene — never inside `render()`. @example const origin = viji.coordinate({ x: 0, y: 0 }, { label: 'Origin' }); const cx = viji.width / 2 + origin.value.x * viji.width * 0.4;
- * @property {(type: '2d') => OffscreenCanvasRenderingContext2D} useContext - Selects the 2D canvas rendering context. Returns the same instance on subsequent calls and also stores it on `viji.ctx`. A canvas only supports one context type — if a different context type was already requested, the call returns `null`. Choose ONE type and use it for the entire scene. @example const ctx = viji.useContext('2d'); ctx.fillRect(0, 0, viji.width, viji.height);
- * @property {(type: 'webgl') => WebGLRenderingContext} useContext - Selects a WebGL 1 rendering context. Returns the same instance on subsequent calls and also stores it on `viji.gl`. A canvas only supports one context type — if a different context type was already requested, the call returns `null`. Choose ONE type and use it for the entire scene.
- * @property {(type: 'webgl2') => WebGL2RenderingContext} useContext - Selects a WebGL 2 rendering context. Returns the same instance on subsequent calls and also stores it on `viji.gl`. A canvas only supports one context type — if a different context type was already requested, the call returns `null`. Choose ONE type and use it for the entire scene.
+ * @property {(defaultValue: number, config: SliderConfig) => SliderParameter} slider - Declares a numeric slider parameter. The host UI renders a draggable slider. Must be called at the top level of the scene, never inside `render()`. @example const radius = viji.slider(50, { min: 10, max: 200, step: 1, label: 'Radius' }); // ... function render(viji) { drawCircle(radius.value); }
+ * @property {(defaultValue: ColorInput, config: ColorConfig) => ColorParameter} color - Declares a color parameter. Accepts hex strings, CSS color functions, or RGB / HSB objects; the value is always normalized to a canonical lowercase hex string and exposes derived `.rgb` / `.hsb` accessors. Must be called at the top level of the scene, never inside `render()`. @example const tint = viji.color('#ff6600', { label: 'Tint' }); // tint.value -> '#ff6600', tint.rgb -> { r: 255, g: 102, b: 0 }, tint.hsb -> { h: 24, s: 100, b: 100 }
+ * @property {(defaultValue: boolean, config: ToggleConfig) => ToggleParameter} toggle - Declares a boolean toggle parameter. The host UI renders an on/off switch. Must be called at the top level of the scene, never inside `render()`. @example const showTrail = viji.toggle(true, { label: 'Show Trail' });
+ * @property {(defaultValue: string | number, config: SelectConfig) => SelectParameter} select - Declares a dropdown selection parameter. The element type of `options` (`string` or `number`) determines the parameter's value type. Must be called at the top level of the scene, never inside `render()`. @example const shape = viji.select('circle', { options: ['circle', 'square', 'triangle'], label: 'Shape' });
+ * @property {(defaultValue: string, config: TextConfig) => TextParameter} text - Declares a text input parameter. The host UI renders a single-line text field. Must be called at the top level of the scene, never inside `render()`. @example const caption = viji.text('Hello', { label: 'Caption', maxLength: 64 });
+ * @property {(defaultValue: number, config: NumberConfig) => NumberParameter} number - Declares a precise numeric input parameter. Like `slider()` but the host UI shows a number field instead of a draggable handle. Must be called at the top level of the scene, never inside `render()`. @example const count = viji.number(12, { min: 1, max: 64, step: 1, label: 'Count' });
+ * @property {(defaultValue: null, config: ImageConfig) => ImageParameter} image - Declares an image upload parameter. The user-supplied image becomes available as `value` (an `ImageBitmap`); in P5 scenes a `.p5` accessor is also added at runtime. Must be called at the top level of the scene, never inside `render()`. @example const tex = viji.image(null, { label: 'Texture' }); if (tex.value) ctx.drawImage(tex.value, 0, 0, viji.width, viji.height);
+ * @property {(config: ButtonConfig) => ButtonParameter} button - Declares a momentary button parameter. `value` is `true` for one frame after the user clicks, then auto-resets. Perfect for triggering discrete events. Must be called at the top level of the scene, never inside `render()`. @example const reset = viji.button({ label: 'Reset' }); function render(viji) { if (reset.value) state = initialState; }
+ * @property {(defaultValue: CoordinateValue, config: CoordinateConfig) => CoordinateParameter} coordinate - Declares a 2D coordinate parameter. Both `value.x` and `value.y` are in `-1..1`. Must be called at the top level of the scene, never inside `render()`. @example const origin = viji.coordinate({ x: 0, y: 0 }, { label: 'Origin' }); const cx = viji.width / 2 + origin.value.x * viji.width * 0.4;
+ * @property {(type: '2d') => OffscreenCanvasRenderingContext2D} useContext - Selects the 2D canvas rendering context. Returns the same instance on subsequent calls and also stores it on `viji.ctx`. A canvas only supports one context type. If a different context type was already requested, the call returns `null`. Choose ONE type and use it for the entire scene. @example const ctx = viji.useContext('2d'); ctx.fillRect(0, 0, viji.width, viji.height);
+ * @property {(type: 'webgl') => WebGLRenderingContext} useContext - Selects a WebGL 1 rendering context. Returns the same instance on subsequent calls and also stores it on `viji.gl`. A canvas only supports one context type. If a different context type was already requested, the call returns `null`. Choose ONE type and use it for the entire scene.
+ * @property {(type: 'webgl2') => WebGL2RenderingContext} useContext - Selects a WebGL 2 rendering context. Returns the same instance on subsequent calls and also stores it on `viji.gl`. A canvas only supports one context type. If a different context type was already requested, the call returns `null`. Choose ONE type and use it for the entire scene.
  */
 
 /**
@@ -469,7 +469,7 @@
  * @property {number} landmarks.x - Horizontal landmark coordinate, normalized 0..1.
  * @property {number} landmarks.y - Vertical landmark coordinate, normalized 0..1.
  * @property {number} landmarks.z - Depth (relative).
- * @property {Object} palm - Palm center — equivalent to `landmarks[9]` (middle-finger MCP).
+ * @property {Object} palm - Palm center, equivalent to `landmarks[9]` (middle-finger MCP).
  * @property {number} palm.x - Palm horizontal coordinate, normalized 0..1.
  * @property {number} palm.y - Palm vertical coordinate, normalized 0..1.
  * @property {number} palm.z - Palm depth (relative).