@viji-dev/core 0.13.0 → 0.14.0

package/dist/docs-api.js

@@ -1,7 +1,7 @@
 export const docsApi = {
   "version": "1.1.0",
-  "coreVersion": "0.13.0",
-  "generatedAt": "2026-08-12T18:47:23.752Z",
+  "coreVersion": "0.14.0",
+  "generatedAt": "2026-08-12T20:50:42.004Z",
   "navigation": [
     {
       "id": "getting-started",

package/dist/{essentia-wasm.web-DGWIGRe8.js → essentia-wasm.web-0tQ5KtU1.js}

@@ -1,4 +1,4 @@
-import { g as kn } from "./index-CkmT_70R.js";
+import { g as kn } from "./index-BYp7SdOD.js";
 function jn(Oe, ot) {
   for (var ve = 0; ve < ot.length; ve++) {
     const Z = ot[ve];

package/dist/{index-CkmT_70R.js → index-BYp7SdOD.js}

@@ -1,4 +1,4 @@
-import { S as eB } from "./scene-analysis-DNN8jTaH.js";
+import { S as eB } from "./scene-analysis-CEQRlNUL.js";
 const uI = [
   "audio",
   "video",
@@ -548,7 +548,7 @@ class nB {
       }
   }
 }
-const dB = "" + new URL("assets/viji.worker-Clz2HjaH.js", import.meta.url).href;
+const dB = "" + new URL("assets/viji.worker-ByIbGiBL.js", import.meta.url).href;
 class JB {
   constructor(A, B, I) {
     this.iframeManager = A, this.sceneCode = B, this.init = I;
@@ -1566,7 +1566,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-DGWIGRe8.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-0tQ5KtU1.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");
@@ -11601,7 +11601,7 @@ function WI(D) {
     expectedVersion: 1
   } : typeof A.senderTime != "number" ? { code: "invalid-field", details: "senderTime must be a number", field: "senderTime" } : null;
 }
-const qI = "0.13.0";
+const qI = "0.14.0";
 export {
   rI as C,
   uI as I,

package/dist/index.d.ts

@@ -1455,6 +1455,29 @@ export declare type Resolution = {
     height: number;
 };
 
+/**
+ * Payload of the worker's `scene-analysis` ack — the correlated response to
+ * `set-scene-code`. The worker runs static analysis (renderer, capabilities,
+ * p5 canvas mode, analysedFrame consumption) after receiving the scene code
+ * and **before** compiling it, and the host's `initialize()` awaits this ack
+ * to assign the four `SceneData` fields exactly once. Carries booleans/enums
+ * only — never scene source.
+ *
+ * Public since 0.14.0: this is also the return type of `analyzeScene`
+ * (`@viji-dev/core/scene-analysis`), which the worker itself calls to build
+ * the ack — one shape, one producer, two transports.
+ */
+export declare interface SceneAnalysisData {
+    /** Detected renderer the scene targets. */
+    renderer: RendererType;
+    /** P5 canvas mode; present only when `renderer` is `'p5'`. */
+    p5CanvasMode?: P5CanvasMode;
+    /** Capabilities the scene's code declares it uses (inclusive-biased). */
+    capabilities: SceneCapabilities;
+    /** Whether the scene consumes per-frame analysed-frame bitmaps (CV). */
+    consumesAnalysedFrame: boolean;
+}
+
 /**
  * The set of engine capabilities a scene's code declares it uses, derived by
  * static analysis of the scene source (no execution). Detection is
@@ -2285,7 +2308,7 @@ declare interface TouchPoint {
 /** Returned by `on*` listener registration calls; invoke to unsubscribe. */
 export declare type Unsubscribe = () => void;
 
-export declare const VERSION = "0.13.0";
+export declare const VERSION = "0.14.0";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side

package/dist/index.js

@@ -1,4 +1,4 @@
-import { C as E, I as o, V as s, a as C, b as I } from "./index-CkmT_70R.js";
+import { C as E, I as o, V as s, a as C, b as I } from "./index-BYp7SdOD.js";
 export {
   E as CV_FEATURE_KEYS,
   o as INPUT_CAPABILITY_KEYS,

package/dist/{scene-analysis-DNN8jTaH.js → scene-analysis-CEQRlNUL.js}

@@ -1,4 +1,4 @@
-class o {
+class a {
   /**
    * Detects the renderer type from scene code comments
    * 
@@ -44,7 +44,7 @@ class o {
    * @returns The set of capabilities the scene declares it uses
    */
   static detectCapabilities(e, t) {
-    const s = this.stripCommentsAndStrings(e), i = {
+    const i = this.stripCommentsAndStrings(e), s = {
       audio: !1,
       video: !1,
       mouse: !1,
@@ -63,7 +63,7 @@ class o {
         segmentation: !1
       }
     };
-    return t === "shader" ? this.detectShaderCapabilities(s, i) : this.detectScriptCapabilities(s, i), i;
+    return t === "shader" ? this.detectShaderCapabilities(i, s) : this.detectScriptCapabilities(i, s), s;
   }
   /**
    * Replaces comment spans and string/template literals with whitespace via a
@@ -74,37 +74,37 @@ class o {
    */
   static stripCommentsAndStrings(e) {
     let t = "";
-    const s = e.length;
-    let i = 0;
-    for (; i < s; ) {
-      const r = e[i], a = i + 1 < s ? e[i + 1] : "";
-      if (r === "/" && a === "/") {
-        for (i += 2; i < s && e[i] !== `
-`; ) i++;
+    const i = e.length;
+    let s = 0;
+    for (; s < i; ) {
+      const r = e[s], o = s + 1 < i ? e[s + 1] : "";
+      if (r === "/" && o === "/") {
+        for (s += 2; s < i && e[s] !== `
+`; ) s++;
         continue;
       }
-      if (r === "/" && a === "*") {
-        for (i += 2; i < s && !(e[i] === "*" && e[i + 1] === "/"); ) i++;
-        i += 2, t += " ";
+      if (r === "/" && o === "*") {
+        for (s += 2; s < i && !(e[s] === "*" && e[s + 1] === "/"); ) s++;
+        s += 2, t += " ";
         continue;
       }
       if (r === '"' || r === "'" || r === "`") {
         const u = r;
-        for (i++; i < s; ) {
-          if (e[i] === "\\") {
-            i += 2;
+        for (s++; s < i; ) {
+          if (e[s] === "\\") {
+            s += 2;
             continue;
           }
-          if (e[i] === u) {
-            i++;
+          if (e[s] === u) {
+            s++;
             break;
           }
-          i++;
+          s++;
         }
         t += " ";
         continue;
       }
-      t += r, i++;
+      t += r, s++;
     }
     return t;
   }
@@ -163,19 +163,24 @@ class o {
     return /\b(analysedFrame|getAnalysedFrameData)\b/.test(t) || /\bu_videoAnalysed\w*/.test(t);
   }
   static detectUsage(e, t) {
-    const s = this.stripCommentsAndStrings(e), i = {
+    const i = this.stripCommentsAndStrings(e), s = {
       mouse: { position: !1, left: !1, right: !1, middle: !1 },
       pointer: { position: !1, down: !1 },
       touch: !1
     };
-    return t === "shader" ? (i.mouse.position = /\bu_mouse(\b|InCanvas|Delta|Wheel)/.test(s), i.mouse.left = /\bu_mouse(Left|Pressed|WasPressed|WasReleased)\b/.test(s), i.mouse.right = /\bu_mouseRight\b/.test(s), i.mouse.middle = /\bu_mouseMiddle\b/.test(s), i.pointer.position = /\bu_pointer(\b|Delta|InCanvas)/.test(s), i.pointer.down = /\bu_pointer(Down|WasPressed|WasReleased)\b/.test(s), i.touch = /\bu_touch/.test(s)) : (i.mouse.position = /\bmouse\.(x|y|deltaX|deltaY|wheelDelta|wheelX|wheelY|wasMoved)\b/.test(s), i.mouse.left = /\bmouse\.(leftButton|isPressed|wasPressed|wasReleased)\b/.test(s), i.mouse.right = /\bmouse\.rightButton\b/.test(s), i.mouse.middle = /\bmouse\.middleButton\b/.test(s), i.pointer.position = /\bpointer\.(x|y|deltaX|deltaY)\b/.test(s), i.pointer.down = /\bpointer\.(isDown|wasPressed|wasReleased)\b/.test(s), i.touch = /\btouches\./.test(s)), i;
+    return t === "shader" ? (s.mouse.position = /\bu_mouse(\b|InCanvas|Delta|Wheel)/.test(i), s.mouse.left = /\bu_mouse(Left|Pressed|WasPressed|WasReleased)\b/.test(i), s.mouse.right = /\bu_mouseRight\b/.test(i), s.mouse.middle = /\bu_mouseMiddle\b/.test(i), s.pointer.position = /\bu_pointer(\b|Delta|InCanvas)/.test(i), s.pointer.down = /\bu_pointer(Down|WasPressed|WasReleased)\b/.test(i), s.touch = /\bu_touch/.test(i)) : (s.mouse.position = /\bmouse\.(x|y|deltaX|deltaY|wheelDelta|wheelX|wheelY|wasMoved)\b/.test(i), s.mouse.left = /\bmouse\.(leftButton|isPressed|wasPressed|wasReleased)\b/.test(i), s.mouse.right = /\bmouse\.rightButton\b/.test(i), s.mouse.middle = /\bmouse\.middleButton\b/.test(i), s.pointer.position = /\bpointer\.(x|y|deltaX|deltaY)\b/.test(i), s.pointer.down = /\bpointer\.(isDown|wasPressed|wasReleased)\b/.test(i), s.touch = /\btouches\./.test(i)), s;
   }
 }
 function b(n) {
-  const e = o.detectRendererType(n);
-  return o.detectCapabilities(n, e);
+  const e = a.detectRendererType(n), t = e === "p5" ? a.detectP5CanvasMode(n) : void 0;
+  return {
+    renderer: e,
+    ...t !== void 0 && { p5CanvasMode: t },
+    capabilities: a.detectCapabilities(n, e),
+    consumesAnalysedFrame: a.detectAnalysedFrameUse(n)
+  };
 }
 export {
-  o as S,
+  a as S,
   b as a
 };

package/dist/scene-analysis.d.ts

@@ -1,36 +1,80 @@
 /**
- * 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`.
+ * Full static scene analysis — everything the worker's `scene-analysis` ack
+ * carries, computed without constructing a core. Composes the same four
+ * statics the worker runs in phase 1 of scene load ({@link
+ * SceneAnalyzer.detectRendererType} → {@link SceneAnalyzer.detectP5CanvasMode}
+ * → {@link SceneAnalyzer.detectCapabilities} → {@link
+ * SceneAnalyzer.detectAnalysedFrameUse}), and the worker itself consumes this
+ * function to build the ack — so for a given core version the result is the
+ * exact payload a booted core's `initialize()` resolves its scene analysis
+ * with. Parity holds through shared code, not parallel composition.
  *
  * 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.
+ * per-scene capabilities; migration tooling that needs the renderer without
+ * booting a core). The following properties are an intentional, kept
+ * contract, covering all four fields:
+ * - **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.
+ * - **Raw-code input** — `renderer` and `p5CanvasMode` are comment-directive
+ *   scans over the artist's original source, before any transpilation (the
+ *   worker applies sucrase only after this analysis, and only to script
+ *   scenes). Pass stored scene code as-is.
+ * - **Inclusive-biased** (`capabilities`) — a capability the scene uses is
+ *   never hidden; a rare ambiguous case may report an extra one.
+ * - **Safe on untrusted input** — linear-time scans 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`.
+ * `p5CanvasMode` is present only when `renderer` is `'p5'`, mirroring the
+ * ack shape exactly.
  *
- * @param sceneCode - The artist's scene code (native, p5, or shader)
- * @returns The set of capabilities the scene declares it uses
+ * Note for consumers filtering on `capabilities.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), raw
+ * @returns The complete static analysis — the worker's ack payload
  * @example
  * ```ts
- * const caps = analyzeSceneCapabilities(scene.code);
- * if (caps.audio) tags.push('audio');
+ * const analysis = analyzeScene(scene.code);
+ * if (analysis.renderer === 'shader') return skip(scene);
+ * if (analysis.capabilities.audio) tags.push('audio');
  * ```
  */
-export declare function analyzeSceneCapabilities(sceneCode: string): SceneCapabilities;
+export declare function analyzeScene(sceneCode: string): SceneAnalysisData;
+
+/**
+ * P5 main-canvas mode. Only meaningful when {@link SceneData.renderer} is
+ * `'p5'`: `'2d'` for the default 2D canvas, `'webgl'` for a WEBGL canvas.
+ */
+declare type P5CanvasMode = '2d' | 'webgl';
+
+declare type RendererType = 'native' | 'p5' | 'shader';
+
+/**
+ * Payload of the worker's `scene-analysis` ack — the correlated response to
+ * `set-scene-code`. The worker runs static analysis (renderer, capabilities,
+ * p5 canvas mode, analysedFrame consumption) after receiving the scene code
+ * and **before** compiling it, and the host's `initialize()` awaits this ack
+ * to assign the four `SceneData` fields exactly once. Carries booleans/enums
+ * only — never scene source.
+ *
+ * Public since 0.14.0: this is also the return type of `analyzeScene`
+ * (`@viji-dev/core/scene-analysis`), which the worker itself calls to build
+ * the ack — one shape, one producer, two transports.
+ */
+declare interface SceneAnalysisData {
+    /** Detected renderer the scene targets. */
+    renderer: RendererType;
+    /** P5 canvas mode; present only when `renderer` is `'p5'`. */
+    p5CanvasMode?: P5CanvasMode;
+    /** Capabilities the scene's code declares it uses (inclusive-biased). */
+    capabilities: SceneCapabilities;
+    /** Whether the scene consumes per-frame analysed-frame bitmaps (CV). */
+    consumesAnalysedFrame: boolean;
+}
 
 /**
  * The set of engine capabilities a scene's code declares it uses, derived by

package/dist/scene-analysis.js

@@ -1,4 +1,4 @@
-import { a as i } from "./scene-analysis-DNN8jTaH.js";
+import { a as n } from "./scene-analysis-CEQRlNUL.js";
 export {
-  i as analyzeSceneCapabilities
+  n as analyzeScene
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viji-dev/core",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "description": "Universal execution engine for Viji Creative scenes",
   "type": "module",
   "sideEffects": false,