@viji-dev/core 0.8.14 → 0.8.16

package/dist/docs-api.js

@@ -1,7 +1,7 @@
 export const docsApi = {
   "version": "1.1.0",
-  "coreVersion": "0.8.12",
-  "generatedAt": "2026-06-07T17:54:21.004Z",
+  "coreVersion": "0.8.15",
+  "generatedAt": "2026-06-08T17:32:29.349Z",
   "navigation": [
     {
       "id": "getting-started",

package/dist/{essentia-wasm.web-CN4UhEyR.js → essentia-wasm.web-Bt54HQaY.js}

@@ -1,4 +1,4 @@
-import { g as kn } from "./index-BvlTOvkN.js";
+import { g as kn } from "./index-f5EKzN3f.js";
 function jn(Oe, ot) {
   for (var ve = 0; ve < ot.length; ve++) {
     const Z = ot[ve];
@@ -3374,4 +3374,4 @@ const xn = /* @__PURE__ */ kn(yi), Ln = /* @__PURE__ */ jn({
 export {
   Ln as e
 };
-//# sourceMappingURL=essentia-wasm.web-CN4UhEyR.js.map
+//# sourceMappingURL=essentia-wasm.web-Bt54HQaY.js.map

package/dist/{index-BvlTOvkN.js → index-f5EKzN3f.js}

@@ -1,3 +1,20 @@
+const hI = [
+  "audio",
+  "video",
+  "mouse",
+  "keyboard",
+  "pointer",
+  "touch",
+  "sensors",
+  "devices"
+], RI = [
+  "faceDetection",
+  "faceMesh",
+  "emotion",
+  "handTracking",
+  "poseDetection",
+  "segmentation"
+];
 class S extends Error {
   constructor(A, B, I) {
     super(A), this.code = B, this.context = I, this.name = "VijiCoreError";
@@ -537,7 +554,7 @@ class DB {
       }
   }
 }
-const hB = "" + new URL("assets/viji.worker-DS4koMQX.js", import.meta.url).href, RB = new URL("assets/wasm/vision_wasm_internal.js", import.meta.url).href, wB = new URL("assets/wasm/vision_wasm_internal.wasm", import.meta.url).href, sB = new URL("assets/wasm/vision_wasm_nosimd_internal.js", import.meta.url).href, FB = new URL("assets/wasm/vision_wasm_nosimd_internal.wasm", import.meta.url).href;
+const hB = "" + new URL("assets/viji.worker-BEba5y4h.js", import.meta.url).href, RB = new URL("assets/wasm/vision_wasm_internal.js", import.meta.url).href, wB = new URL("assets/wasm/vision_wasm_internal.wasm", import.meta.url).href, sB = new URL("assets/wasm/vision_wasm_nosimd_internal.js", import.meta.url).href, FB = new URL("assets/wasm/vision_wasm_nosimd_internal.wasm", import.meta.url).href;
 class kB {
   constructor(A, B, I) {
     this.iframeManager = A, this.sceneCode = B, this.init = I;
@@ -1524,7 +1541,7 @@ class lB {
     if (!this.isInitialized)
       return this.initPromise ? this.initPromise : (this.initPromise = (async () => {
         try {
-          const A = await import("./essentia.js-core.es-CC_3Ap1i.js"), B = await import("./essentia-wasm.web-CN4UhEyR.js").then((g) => g.e), I = A.Essentia || A.default?.Essentia || A.default;
+          const A = await import("./essentia.js-core.es-CC_3Ap1i.js"), B = await import("./essentia-wasm.web-Bt54HQaY.js").then((g) => g.e), I = A.Essentia || A.default?.Essentia || A.default;
           let Q = B.default || B.EssentiaWASM || B.default?.EssentiaWASM;
           if (!Q)
             throw new Error("WASM module not found - check essentia-wasm.web.js export");
@@ -8602,9 +8619,9 @@ class K {
    *
    * WebKit (Safari/iOS) caveat: the 2D `getImageData` fence forces a full-canvas
    * readback that is pathologically slow there, so 2D `gpuMs` is unreliable on
-   * WebKit and self-disables to `null` if it blows a per-frame budget (so the
-   * run can't hang). Prefer steady-state `frameIntervalMs` for 2D raster cost on
-   * WebKit. The WebGL fence is unaffected.
+   * WebKit — prefer steady-state `frameIntervalMs` for 2D raster cost on WebKit.
+   * A pathological readback is bounded by this call's RPC timeout (it rejects),
+   * not by per-frame logic. The WebGL fence is unaffected.
    *
    * Use only on a scene NOT serving as a live compositor source/mixer —
    * the per-frame fence would stutter the mixer output (enforced below).
@@ -8781,12 +8798,14 @@ function DI(h) {
     expectedVersion: 1
   } : typeof A.senderTime != "number" ? { code: "invalid-field", details: "senderTime must be a number", field: "senderTime" } : null;
 }
-const hI = "0.8.12";
+const wI = "0.8.15";
 export {
   yA as A,
-  hI as V,
+  RI as C,
+  hI as I,
+  wI as V,
   K as a,
   S as b,
   PB as g
 };
-//# sourceMappingURL=index-BvlTOvkN.js.map
+//# sourceMappingURL=index-f5EKzN3f.js.map

package/dist/index.d.ts

@@ -766,9 +766,9 @@ export declare type CanvasContextType = '2d' | 'webgl' | 'webgl2';
  * of the ~1s performance snapshot.
  */
 export declare interface CapabilityTransition {
-    capability: 'audio' | 'video' | 'mouse' | 'keyboard' | 'pointer' | 'touch' | 'sensors' | 'devices' | 'cv';
+    capability: InputCapabilityKey | 'cv';
     /** Present when `capability` is `'cv'`. */
-    cvType?: 'faceDetection' | 'faceMesh' | 'emotion' | 'handTracking' | 'poseDetection' | 'segmentation';
+    cvType?: CVFeatureKey;
     /** Present when `capability` is `'cv'` — which CV level transitioned. */
     level?: 'active' | 'meaningful';
     /** The new state. */
@@ -937,6 +937,13 @@ export declare interface CountPair {
     falseCount: number;
 }
 
+/**
+ * Runtime-enumerable identifiers for the computer-vision features. These are the
+ * keys under the `cv` member of {@link SceneCapabilities}, {@link FrameCapabilities},
+ * and {@link PeriodCapabilityCounts}.
+ */
+export declare const CV_FEATURE_KEYS: readonly ["faceDetection", "faceMesh", "emotion", "handTracking", "poseDetection", "segmentation"];
+
 /** Per-CV-feature live activity: `active` = model loaded + first inference completed (cost is being paid); `meaningful` = last result was non-empty. */
 export declare interface CVActivity {
     /** Feature is running/inferring (model loaded, first inference completed). */
@@ -951,6 +958,9 @@ export declare interface CVActivity {
  */
 declare type CVFeature = 'faceDetection' | 'faceMesh' | 'handTracking' | 'poseDetection' | 'bodySegmentation' | 'emotionDetection';
 
+/** A single CV feature identifier. @see {@link CV_FEATURE_KEYS} */
+export declare type CVFeatureKey = typeof CV_FEATURE_KEYS[number];
+
 /**
  * Computer-vision processing rate relative to the input video stream rate.
  * `'full'` runs CV on every delivered video frame, `'half'` every other frame,
@@ -1234,25 +1244,13 @@ export declare interface FaceData {
  * capabilities (audio/video/sensors/devices) reflect `isConnected`;
  * interaction-class (mouse/keyboard/pointer/touch) reflect active use of the
  * specific inputs the scene reads; CV reports `{active, meaningful}` per type.
+ *
+ * A flag per {@link INPUT_CAPABILITY_KEYS} entry, plus per-{@link CV_FEATURE_KEYS}
+ * activity — derived from those arrays so it cannot drift from them.
  */
-export declare interface FrameCapabilities {
-    audio: boolean;
-    video: boolean;
-    mouse: boolean;
-    keyboard: boolean;
-    pointer: boolean;
-    touch: boolean;
-    sensors: boolean;
-    devices: boolean;
-    cv: {
-        faceDetection: CVActivity;
-        faceMesh: CVActivity;
-        emotion: CVActivity;
-        handTracking: CVActivity;
-        poseDetection: CVActivity;
-        segmentation: CVActivity;
-    };
-}
+export declare type FrameCapabilities = Record<InputCapabilityKey, boolean> & {
+    cv: Record<CVFeatureKey, CVActivity>;
+};
 
 /** One per-frame performance + capability record. */
 export declare interface FramePerfSample {
@@ -1268,7 +1266,7 @@ export declare interface FramePerfSample {
      * WebGL scenes via `gl.finish()` (GPU drain), 2D-canvas scenes via
      * `getImageData()` (raster flush). `null` when there is no drawable context or
      * readback fails. Note: 2D `gpuMs` is unreliable on WebKit (the `getImageData`
-     * readback is pathologically slow there and self-disables to `null`) — use
+     * readback is pathologically slow there and inflates the value) — use
      * `frameIntervalMs` for 2D raster cost on WebKit.
      */
     gpuMs: number | null;
@@ -1417,6 +1415,21 @@ declare interface ImageParameter {
     category: ParameterCategory;
 }
 
+/**
+ * Runtime-enumerable identifiers for the **input / interaction** capabilities
+ * tracked live per rendered frame. This is the live capability vocabulary — the
+ * keys of {@link FrameCapabilities} and {@link PeriodCapabilityCounts}, and the
+ * single source of truth those types derive from.
+ *
+ * Note: `parameters` is intentionally absent. It is a *declared-only* tag on
+ * {@link SceneCapabilities} (the scene defines tunable parameters), not a live
+ * consumed signal, so it is not part of the per-frame capability set.
+ */
+export declare const INPUT_CAPABILITY_KEYS: readonly ["audio", "video", "mouse", "keyboard", "pointer", "touch", "sensors", "devices"];
+
+/** A single input/interaction capability identifier. @see {@link INPUT_CAPABILITY_KEYS} */
+export declare type InputCapabilityKey = typeof INPUT_CAPABILITY_KEYS[number];
+
 export declare interface InstrumentSerialized {
     mode: OnsetMode;
     muted: boolean;
@@ -1720,43 +1733,17 @@ export declare interface PerformanceStats {
 /**
  * Per-capability frame counts over the report period. CV types report
  * separate `active` and `meaningful` pairs.
- */
-export declare interface PeriodCapabilityCounts {
-    audio: CountPair;
-    video: CountPair;
-    mouse: CountPair;
-    keyboard: CountPair;
-    pointer: CountPair;
-    touch: CountPair;
-    sensors: CountPair;
-    devices: CountPair;
-    cv: {
-        faceDetection: {
-            active: CountPair;
-            meaningful: CountPair;
-        };
-        faceMesh: {
-            active: CountPair;
-            meaningful: CountPair;
-        };
-        emotion: {
-            active: CountPair;
-            meaningful: CountPair;
-        };
-        handTracking: {
-            active: CountPair;
-            meaningful: CountPair;
-        };
-        poseDetection: {
-            active: CountPair;
-            meaningful: CountPair;
-        };
-        segmentation: {
-            active: CountPair;
-            meaningful: CountPair;
-        };
-    };
-}
+ *
+ * A {@link CountPair} per {@link INPUT_CAPABILITY_KEYS} entry, plus active +
+ * meaningful pairs per {@link CV_FEATURE_KEYS} — derived from those arrays so it
+ * cannot drift from them.
+ */
+export declare type PeriodCapabilityCounts = Record<InputCapabilityKey, CountPair> & {
+    cv: Record<CVFeatureKey, {
+        active: CountPair;
+        meaningful: CountPair;
+    }>;
+};
 
 /**
  * Phase-Locked Loop for stable beat phase tracking
@@ -1898,6 +1885,10 @@ export declare type Resolution = {
  * but a rarely-ambiguous case may show an extra one. Shader scenes are
  * detected from built-in uniform usage (exact); native/p5 scenes from
  * `viji.*` usage tokens.
+ *
+ * The input keys here are pinned to {@link INPUT_CAPABILITY_KEYS} and the `cv`
+ * keys to {@link CV_FEATURE_KEYS} by a compile-time guard (below), so this shape
+ * cannot drift from the runtime vocabulary.
  */
 export declare interface SceneCapabilities {
     /** Scene reads audio analysis (volume, bands, beat, FFT/waveform, or audio streams). */
@@ -2674,7 +2665,7 @@ declare type TrackingState = 'TRACKING' | 'LOCKED' | 'BREAKDOWN' | 'LOST';
 /** Returned by `on*` listener registration calls; invoke to unsubscribe. */
 export declare type Unsubscribe = () => void;
 
-export declare const VERSION = "0.8.12";
+export declare const VERSION = "0.8.15";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side
@@ -3896,9 +3887,9 @@ export declare class VijiCore {
      *
      * WebKit (Safari/iOS) caveat: the 2D `getImageData` fence forces a full-canvas
      * readback that is pathologically slow there, so 2D `gpuMs` is unreliable on
-     * WebKit and self-disables to `null` if it blows a per-frame budget (so the
-     * run can't hang). Prefer steady-state `frameIntervalMs` for 2D raster cost on
-     * WebKit. The WebGL fence is unaffected.
+     * WebKit — prefer steady-state `frameIntervalMs` for 2D raster cost on WebKit.
+     * A pathological readback is bounded by this call's RPC timeout (it rejects),
+     * not by per-frame logic. The WebGL fence is unaffected.
      *
      * Use only on a scene NOT serving as a live compositor source/mixer —
      * the per-frame fence would stutter the mixer output (enforced below).

package/dist/index.js

@@ -1,8 +1,10 @@
-import { A as a, V as i, a as s, b as e } from "./index-BvlTOvkN.js";
+import { A as s, C as o, I as E, V as i, a as A, b as C } from "./index-f5EKzN3f.js";
 export {
-  a as AudioSystem,
+  s as AudioSystem,
+  o as CV_FEATURE_KEYS,
+  E as INPUT_CAPABILITY_KEYS,
   i as VERSION,
-  s as VijiCore,
-  e as VijiCoreError
+  A as VijiCore,
+  C as VijiCoreError
 };
 //# sourceMappingURL=index.js.map

package/package.json

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