@viji-dev/core 0.11.3 → 0.11.4

package/dist/{index-BzkVQgrq.js → index-LgAeJ6JG.js}

@@ -1518,7 +1518,7 @@ class YB {
     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-D54RUgg3.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-BqvCeDjy.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");
@@ -1913,7 +1913,7 @@ class YB {
     }
   }
 }
-const IA = 60, O = 200, UB = 85, SB = 180, NB = 200, pA = 4, DA = 10, bB = ["low", "lowMid", "mid", "highMid", "high"];
+const IA = 60, O = 200, UB = 85, SB = 180, NB = 200, pA = 4, hA = 10, bB = ["low", "lowMid", "mid", "highMid", "high"];
 class HB {
   // Autocorrelation state
   onsetEnvelope = [];
@@ -2238,18 +2238,18 @@ class HB {
       return { dominantInterval: 500, consistency: 0, sampleCount: 0 };
     const Q = /* @__PURE__ */ new Map();
     for (const s of I) {
-      const G = Math.round(s / DA) * DA;
+      const G = Math.round(s / hA) * hA;
       Q.set(G, (Q.get(G) || 0) + 1);
     }
     let g = 500, E = 0;
     for (const [s, G] of Q) {
       let o = G;
-      const h = Math.round(s / 2 / DA) * DA;
+      const h = Math.round(s / 2 / hA) * hA;
       o += (Q.get(h) || 0) * 0.5;
       const R = s * 2;
       o += (Q.get(R) || 0) * 0.5, o > E && (E = o, g = s);
     }
-    const C = DA * 3;
+    const C = hA * 3;
     let i = 0;
     for (const s of I)
       Math.abs(s - g) < C && i++, Math.abs(s - g / 2) < C && (i += 0.5), Math.abs(s - g * 2) < C && (i += 0.5);
@@ -4383,7 +4383,7 @@ Rejection rate: ${(I / A * 60).toFixed(1)} per minute
     return this.events.length;
   }
 }
-const cA = ["kick", "snare", "hat"], KA = 60, OA = 5e3, OB = 500, fB = 8, FA = 0.18, hA = 3, vB = 3e3, jB = 100, PB = 64, TB = 0.05, _B = 0.15, sA = 1;
+const FA = ["kick", "snare", "hat"], KA = 60, OA = 5e3, OB = 500, fB = 8, tA = 0.18, sA = 3, vB = 3e3, jB = 100, PB = 64, TB = 0.05, _B = 0.15, RA = 1;
 function HA() {
   return {
     mode: "auto",
@@ -4524,11 +4524,11 @@ class BB {
    * inadvertently overwritten.
    */
   exportSessionState(A) {
-    const B = A?.instruments ?? cA, I = {};
+    const B = A?.instruments ?? FA, I = {};
     for (const Q of B)
       I[Q] = this.serializeInstrument(Q);
     return {
-      version: sA,
+      version: RA,
       senderTime: performance.now(),
       instruments: I
     };
@@ -4554,9 +4554,9 @@ class BB {
    * via the `version` field.
    */
   importSessionState(A, B) {
-    if (A.version !== sA) return;
+    if (A.version !== RA) return;
     const I = performance.now();
-    for (const Q of cA) {
+    for (const Q of FA) {
       const g = A.instruments[Q];
       g && this.applyInstrumentPayload(Q, g, B, I);
     }
@@ -4569,11 +4569,11 @@ class BB {
     if (A === null || typeof A != "object")
       return { code: "malformed", details: "payload is not an object" };
     const B = A;
-    return B.version !== sA ? {
+    return B.version !== RA ? {
       code: "version-mismatch",
-      details: `expected version ${sA}, got ${String(B.version)}`,
+      details: `expected version ${RA}, got ${String(B.version)}`,
       ...typeof B.version == "number" ? { payloadVersion: B.version } : {},
-      expectedVersion: sA
+      expectedVersion: RA
     } : typeof B.senderTime != "number" ? { code: "invalid-field", details: "senderTime must be a number", field: "senderTime" } : !B.instruments || typeof B.instruments != "object" ? { code: "invalid-field", details: "instruments must be an object", field: "instruments" } : null;
   }
   /**
@@ -4589,7 +4589,7 @@ class BB {
    */
   processFrame(A, B, I) {
     const Q = { ...A, events: [...A.events] }, g = [];
-    for (const i of cA) {
+    for (const i of FA) {
       const a = this.state[i];
       if (a.muted) {
         if (Q.events = Q.events.filter((R) => R.type !== i), a.pendingTapEvents = [], a.mode === "pattern" && a.pattern && a.replayLastEventTime > 0)
@@ -4774,13 +4774,13 @@ class BB {
   findMatchingPosition(A, B) {
     if (!A.pattern) return -1;
     const I = A.refinementIndex % A.pattern.length, Q = A.pattern[I];
-    if (Math.abs(B - Q) / Q <= FA)
+    if (Math.abs(B - Q) / Q <= tA)
       return I;
     let g = -1, E = 1 / 0;
     for (let C = 0; C < A.pattern.length; C++) {
       if (C === I) continue;
       const i = Math.abs(B - A.pattern[C]) / A.pattern[C];
-      i <= FA && i < E && (E = i, g = C);
+      i <= tA && i < E && (E = i, g = C);
     }
     return g;
   }
@@ -4802,13 +4802,13 @@ class BB {
    */
   tryRecognizePattern(A) {
     const I = this.state[A].tapIOIs;
-    if (I.length < hA) return null;
-    const Q = Math.min(fB, Math.floor(I.length / hA));
+    if (I.length < sA) return null;
+    const Q = Math.min(fB, Math.floor(I.length / sA));
     for (let g = 1; g <= Q; g++) {
-      const E = hA * g;
+      const E = sA * g;
       if (I.length < E) continue;
-      const C = g <= 2 ? FA : FA * (2 / g), i = I.slice(-E), a = [];
-      for (let o = 0; o < hA; o++)
+      const C = g <= 2 ? tA : tA * (2 / g), i = I.slice(-E), a = [];
+      for (let o = 0; o < sA; o++)
         a.push(i.slice(o * g, (o + 1) * g));
       const s = a[0].map((o, h) => {
         let R = 0;
@@ -4835,7 +4835,7 @@ class BB {
    */
   applyPattern(A, B) {
     const I = this.state[A];
-    I.pattern = B, this.setMode(A, "pattern"), I.refinementIndex = 0, I.refinementCounts = new Array(B.length).fill(hA), (I.replayLastEventTime === 0 || I.replayLastEventTime < I.lastTapTime) && (I.replayLastEventTime = I.lastTapTime, I.replayIndex = 0);
+    I.pattern = B, this.setMode(A, "pattern"), I.refinementIndex = 0, I.refinementCounts = new Array(B.length).fill(sA), (I.replayLastEventTime === 0 || I.replayLastEventTime < I.lastTapTime) && (I.replayLastEventTime = I.lastTapTime, I.replayIndex = 0);
   }
   createTapEvent(A, B, I) {
     return {
@@ -4865,7 +4865,7 @@ class BB {
     return g;
   }
   reset() {
-    for (const A of cA)
+    for (const A of FA)
       this.clear(A);
   }
 }
@@ -5010,8 +5010,8 @@ j.prototype._transform4 = function() {
     var G = g >>> 2;
     for (E = 0; E < B; E += g)
       for (var o = E + G, h = E, R = 0; h < o; h += 2, R += Q) {
-        const w = h, t = w + G, c = t + G, F = c + G, e = A[w], y = A[w + 1], M = A[t], n = A[t + 1], k = A[c], d = A[c + 1], l = A[F], Y = A[F + 1], U = e, Z = y, b = s[R], m = a * s[R + 1], q = M * b - n * m, r = M * m + n * b, p = s[2 * R], P = a * s[2 * R + 1], X = k * p - d * P, x = k * P + d * p, T = s[3 * R], u = a * s[3 * R + 1], _ = l * T - Y * u, K = l * u + Y * T, z = U + X, f = Z + x, N = U - X, L = Z - x, V = q + _, S = r + K, W = a * (q - _), v = a * (r - K), $ = z + V, wA = f + S, MA = z - V, lA = f - S, nA = N + v, dA = L - W, JA = N - v, YA = L + W;
-        A[w] = $, A[w + 1] = wA, A[t] = nA, A[t + 1] = dA, A[c] = MA, A[c + 1] = lA, A[F] = JA, A[F + 1] = YA;
+        const w = h, t = w + G, c = t + G, F = c + G, e = A[w], y = A[w + 1], M = A[t], n = A[t + 1], k = A[c], d = A[c + 1], l = A[F], Y = A[F + 1], U = e, Z = y, b = s[R], m = a * s[R + 1], q = M * b - n * m, r = M * m + n * b, p = s[2 * R], P = a * s[2 * R + 1], X = k * p - d * P, x = k * P + d * p, T = s[3 * R], u = a * s[3 * R + 1], _ = l * T - Y * u, K = l * u + Y * T, z = U + X, f = Z + x, N = U - X, L = Z - x, V = q + _, S = r + K, W = a * (q - _), v = a * (r - K), $ = z + V, cA = f + S, MA = z - V, lA = f - S, nA = N + v, dA = L - W, JA = N - v, YA = L + W;
+        A[w] = $, A[w + 1] = cA, A[t] = nA, A[t + 1] = dA, A[c] = MA, A[c + 1] = lA, A[F] = JA, A[F + 1] = YA;
       }
   }
 };
@@ -5041,8 +5041,8 @@ j.prototype._realTransform4 = function() {
     var G = g >>> 1, o = G >>> 1, h = o >>> 1;
     for (E = 0; E < B; E += g)
       for (var R = 0, w = 0; R <= h; R += 2, w += Q) {
-        var t = E + R, c = t + o, F = c + o, e = F + o, y = A[t], M = A[t + 1], n = A[c], k = A[c + 1], d = A[F], l = A[F + 1], Y = A[e], U = A[e + 1], Z = y, b = M, m = s[w], q = a * s[w + 1], r = n * m - k * q, p = n * q + k * m, P = s[2 * w], X = a * s[2 * w + 1], x = d * P - l * X, T = d * X + l * P, u = s[3 * w], _ = a * s[3 * w + 1], K = Y * u - U * _, z = Y * _ + U * u, f = Z + x, N = b + T, L = Z - x, V = b - T, S = r + K, W = p + z, v = a * (r - K), $ = a * (p - z), wA = f + S, MA = N + W, lA = L + $, nA = V - v;
-        if (A[t] = wA, A[t + 1] = MA, A[c] = lA, A[c + 1] = nA, R === 0) {
+        var t = E + R, c = t + o, F = c + o, e = F + o, y = A[t], M = A[t + 1], n = A[c], k = A[c + 1], d = A[F], l = A[F + 1], Y = A[e], U = A[e + 1], Z = y, b = M, m = s[w], q = a * s[w + 1], r = n * m - k * q, p = n * q + k * m, P = s[2 * w], X = a * s[2 * w + 1], x = d * P - l * X, T = d * X + l * P, u = s[3 * w], _ = a * s[3 * w + 1], K = Y * u - U * _, z = Y * _ + U * u, f = Z + x, N = b + T, L = Z - x, V = b - T, S = r + K, W = p + z, v = a * (r - K), $ = a * (p - z), cA = f + S, MA = N + W, lA = L + $, nA = V - v;
+        if (A[t] = cA, A[t + 1] = MA, A[c] = lA, A[c + 1] = nA, R === 0) {
           var dA = f - S, JA = N - W;
           A[F] = dA, A[F + 1] = JA;
           continue;
@@ -9302,7 +9302,7 @@ class sI {
     this.internalDevice = { motion: null, orientation: null };
   }
 }
-class tA {
+class oA {
   /**
    * Detects the renderer type from scene code comments
    * 
@@ -9475,6 +9475,10 @@ class tA {
     return B === "shader" ? (Q.mouse.position = /\bu_mouse(\b|InCanvas|Delta|Wheel)/.test(I), Q.mouse.left = /\bu_mouse(Left|Pressed|WasPressed|WasReleased)\b/.test(I), Q.mouse.right = /\bu_mouseRight\b/.test(I), Q.mouse.middle = /\bu_mouseMiddle\b/.test(I), Q.pointer.position = /\bu_pointer(\b|Delta|InCanvas)/.test(I), Q.pointer.down = /\bu_pointer(Down|WasPressed|WasReleased)\b/.test(I), Q.touch = /\bu_touch/.test(I)) : (Q.mouse.position = /\bmouse\.(x|y|deltaX|deltaY|wheelDelta|wheelX|wheelY|wasMoved)\b/.test(I), Q.mouse.left = /\bmouse\.(leftButton|isPressed|wasPressed|wasReleased)\b/.test(I), Q.mouse.right = /\bmouse\.rightButton\b/.test(I), Q.mouse.middle = /\bmouse\.middleButton\b/.test(I), Q.pointer.position = /\bpointer\.(x|y|deltaX|deltaY)\b/.test(I), Q.pointer.down = /\bpointer\.(isDown|wasPressed|wasReleased)\b/.test(I), Q.touch = /\btouches\./.test(I)), Q;
   }
 }
+function SI(D) {
+  const A = oA.detectRendererType(D);
+  return oA.detectCapabilities(D, A);
+}
 function RI(D) {
   if (typeof D == "string")
     return wI(D);
@@ -9490,7 +9494,7 @@ function RI(D) {
   }
   throw new Error(`Invalid color input: expected string or object, got ${typeof D}`);
 }
-function RA(D, A, B) {
+function wA(D, A, B) {
   const I = ZA(D, "r"), Q = ZA(A, "g"), g = ZA(B, "b");
   return "#" + LA(I) + LA(Q) + LA(g);
 }
@@ -9505,7 +9509,7 @@ function IB(D, A, B) {
   let a = 0, s = 0, G = 0;
   C < 1 ? (a = E, s = i, G = 0) : C < 2 ? (a = i, s = E, G = 0) : C < 3 ? (a = 0, s = E, G = i) : C < 4 ? (a = 0, s = i, G = E) : C < 5 ? (a = i, s = 0, G = E) : (a = E, s = 0, G = i);
   const o = g - E;
-  return RA(
+  return wA(
     Math.round((a + o) * 255),
     Math.round((s + o) * 255),
     Math.round((G + o) * 255)
@@ -9547,7 +9551,7 @@ function FI(D) {
   if (A.length !== 3)
     throw new Error(`rgb() requires 3 arguments, got ${A.length}: rgb(${D})`);
   const B = BA(A[0], "r"), I = BA(A[1], "g"), Q = BA(A[2], "b");
-  return RA(B, I, Q);
+  return wA(B, I, Q);
 }
 function tI(D) {
   const A = kA(D);
@@ -9570,18 +9574,18 @@ function yI(D) {
   const B = BA(A[0], "r"), I = BA(A[1], "g"), Q = BA(A[2], "b");
   if (B < 0 || B > 1 || I < 0 || I > 1 || Q < 0 || Q > 1)
     throw new Error(`vec3() components must be in 0..1, got: vec3(${B}, ${I}, ${Q})`);
-  return RA(
+  return wA(
     Math.round(B * 255),
     Math.round(I * 255),
     Math.round(Q * 255)
   );
 }
 function kI(D) {
-  const A = oA(D.r, "r"), B = oA(D.g, "g"), I = oA(D.b, "b");
-  return RA(A, B, I);
+  const A = DA(D.r, "r"), B = DA(D.g, "g"), I = DA(D.b, "b");
+  return wA(A, B, I);
 }
 function MI(D) {
-  const A = oA(D.h, "h"), B = oA(D.s, "s"), I = oA(D.b, "b");
+  const A = DA(D.h, "h"), B = DA(D.s, "s"), I = DA(D.b, "b");
   return IB(A, B, I);
 }
 function lI(D, A, B) {
@@ -9593,7 +9597,7 @@ function lI(D, A, B) {
   let a = 0, s = 0, G = 0;
   C < 1 ? (a = E, s = i, G = 0) : C < 2 ? (a = i, s = E, G = 0) : C < 3 ? (a = 0, s = E, G = i) : C < 4 ? (a = 0, s = i, G = E) : C < 5 ? (a = i, s = 0, G = E) : (a = E, s = 0, G = i);
   const o = g - E / 2;
-  return RA(
+  return wA(
     Math.round((a + o) * 255),
     Math.round((s + o) * 255),
     Math.round((G + o) * 255)
@@ -9613,7 +9617,7 @@ function _A(D, A) {
     throw new Error(`Field '${A}' must use percent notation (e.g., 50%), got: '${D}'`);
   return BA(D.slice(0, -1), A);
 }
-function oA(D, A) {
+function DA(D, A) {
   if (typeof D != "number" || !isFinite(D))
     throw new Error(`Invalid color field '${A}': expected finite number, got ${D}`);
   return D;
@@ -9789,7 +9793,7 @@ class mA {
       // Canvas DOM interaction disabled in headless by default
       // InteractionManager (viji.mouse/etc) always exists regardless
       allowUserInteraction: A.allowUserInteraction ?? !this.isHeadless
-    }, this.sceneRenderer = tA.detectRendererType(A.sceneCode), this.sceneCapabilities = tA.detectCapabilities(A.sceneCode, this.sceneRenderer), this.sceneRenderer === "p5" && (this.sceneP5CanvasMode = tA.detectP5CanvasMode(A.sceneCode)), this.sceneConsumesAnalysedFrame = tA.detectAnalysedFrameUse(A.sceneCode), A.videoStream && this.engineGroup.setMainVideoStream(A.videoStream);
+    }, this.sceneRenderer = oA.detectRendererType(A.sceneCode), this.sceneCapabilities = oA.detectCapabilities(A.sceneCode, this.sceneRenderer), this.sceneRenderer === "p5" && (this.sceneP5CanvasMode = oA.detectP5CanvasMode(A.sceneCode)), this.sceneConsumesAnalysedFrame = oA.detectAnalysedFrameUse(A.sceneCode), A.videoStream && this.engineGroup.setMainVideoStream(A.videoStream);
     for (const Q of A.videoStreams ?? [])
       this.engineGroup.addAdditionalVideoStream(Q);
     this.currentInteractionEnabled = this.config.allowUserInteraction, A.allowDeviceInteraction && (this.deviceSensorManager = new sI()), this.debugLog(`VijiCore created: ${this.instanceId} (headless: ${this.isHeadless}, sharedEngines: ${!!A.mediaSource})`);
@@ -11558,14 +11562,15 @@ function JI(D) {
     expectedVersion: 1
   } : typeof A.senderTime != "number" ? { code: "invalid-field", details: "senderTime must be a number", field: "senderTime" } : null;
 }
-const SI = "0.11.3";
+const NI = "0.11.4";
 export {
   yA as A,
   UI as C,
   YI as I,
-  SI as V,
+  NI as V,
   mA as a,
-  J as b,
+  SI as b,
+  J as c,
   $B as g
 };
-//# sourceMappingURL=index-BzkVQgrq.js.map
+//# sourceMappingURL=index-LgAeJ6JG.js.map

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

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