@viji-dev/core 0.11.3 → 0.11.5

package/dist/index.d.ts

@@ -1,3 +1,37 @@
+/**
+ * Analyzes a scene's source code and returns the capabilities it declares,
+ * without constructing a core. Composes {@link SceneAnalyzer.detectRendererType}
+ * and {@link SceneAnalyzer.detectCapabilities} — the same two steps `VijiCore`
+ * performs at construction — so for a given core version the result is
+ * identical to a booted core's `getSceneData().capabilities`.
+ *
+ * Intended for out-of-engine consumers (e.g. server-side persistence of
+ * per-scene capabilities). The following properties are an intentional, kept
+ * contract:
+ * - **Pure and Node-safe** — static analysis only; the scene is never executed
+ *   and no DOM, canvas, or worker API is touched. Callable in a bare Node
+ *   process.
+ * - **Deterministic** — same code string, same result, within a core version.
+ * - **Inclusive-biased** — a capability the scene uses is never hidden; a
+ *   rare ambiguous case may report an extra one.
+ * - **Safe on untrusted input** — linear-time scan and regexes with no throw
+ *   paths on any string input.
+ *
+ * Note for consumers filtering on `video`: the flag means the scene reads the
+ * video *image* (pixels/texture). Shader scenes that consume only CV result
+ * uniforms report `cv.*` without `video`, so a "reacts to the camera" filter
+ * should test `video || any cv key`.
+ *
+ * @param sceneCode - The artist's scene code (native, p5, or shader)
+ * @returns The set of capabilities the scene declares it uses
+ * @example
+ * ```ts
+ * const caps = analyzeSceneCapabilities(scene.code);
+ * if (caps.audio) tags.push('audio');
+ * ```
+ */
+export declare function analyzeSceneCapabilities(sceneCode: string): SceneCapabilities;
+
 declare interface AudioAnalysisState {
     isConnected: boolean;
     currentBPM: number;
@@ -2798,7 +2832,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.11.3";
+export declare const VERSION = "0.11.5";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side
@@ -2985,13 +3019,13 @@ export declare interface VideoCVAPI {
 }
 
 /**
- * Video stream categorization type
- * - main: Primary video with CV processing (viji.video)
- * - additional: Host-provided MediaStreams without CV (viji.videoStreams[])
- * - directFrame: Injected frames from compositor pipeline (viji.videoStreams[], after additional)
- * - device: Device-provided camera streams (device.video)
+ * Video stream role, derived from position in the index contract.
+ * - main:        primary video with CV (`viji.video`)
+ * - additional:  host-provided MediaStreams, no CV (`viji.videoStreams[]`)
+ * - device:      device camera streams (`viji.devices[].video`)
+ * - directFrame: injected compositor frames (`viji.videoStreams[]`, after additional)
  */
-export declare type VideoStreamType = 'main' | 'additional' | 'directFrame' | 'device';
+export declare type VideoStreamType = 'main' | 'additional' | 'device' | 'directFrame';
 
 /**
  * The Viji API surface available to artist code as the global `viji` object.

package/dist/index.js

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

package/package.json

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