@viji-dev/core 0.8.14 → 0.8.15

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 {
@@ -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.14";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side

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-CI49eH6U.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.15",
   "description": "Universal execution engine for Viji Creative scenes",
   "type": "module",
   "main": "./dist/index.js",