@viji-dev/core 0.8.11 → 0.8.12

package/dist/docs-api.js

@@ -1,7 +1,7 @@
 export const docsApi = {
   "version": "1.1.0",
   "coreVersion": "0.8.11",
-  "generatedAt": "2026-06-04T09:28:42.834Z",
+  "generatedAt": "2026-06-06T12:20:36.994Z",
   "navigation": [
     {
       "id": "getting-started",

package/dist/{essentia-wasm.web-BGfjWBMO.js → essentia-wasm.web-BAkt7bza.js}

@@ -1,4 +1,4 @@
-import { g as kn } from "./index-BH2kB2OG.js";
+import { g as kn } from "./index-DYUAz0BO.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-BGfjWBMO.js.map
+//# sourceMappingURL=essentia-wasm.web-BAkt7bza.js.map

package/dist/{index-BH2kB2OG.js → index-DYUAz0BO.js}

@@ -537,7 +537,7 @@ class DB {
       }
   }
 }
-const hB = "" + new URL("assets/viji.worker-CtPXL0fz.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-dW7fkaOy.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 +1524,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-BGfjWBMO.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-BAkt7bza.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");
@@ -7018,6 +7018,8 @@ class K {
   sceneRenderer = "native";
   sceneCapabilities;
   sceneP5CanvasMode;
+  // The runtime-locked canvas context, reported by the worker once it locks.
+  sceneContextType;
   parametersInitialized = !1;
   // Event listeners for parameter system
   parameterListeners = /* @__PURE__ */ new Map();
@@ -7301,7 +7303,7 @@ class K {
     }), this.workerManager.onMessage("performance-warning", (A) => {
       console.warn("Performance warning:", A);
     }), this.workerManager.onMessage("performance-update", (A) => {
-      A.effectiveRefreshRate !== void 0 && (this.stats.frameRate.effectiveRefreshRate = A.effectiveRefreshRate, this.stats.frameRate.mode = A.frameRateMode, this.stats.frameRate.screenRefreshRate = A.screenRefreshRate), A.cv !== void 0 && (this.stats.cv = A.cv), A.frames !== void 0 && (this.stats.frames = A.frames, this.stats.timing = A.timing, this.stats.capabilities = A.capabilities, this.firePerformanceSnapshot());
+      A.effectiveRefreshRate !== void 0 && (this.stats.frameRate.effectiveRefreshRate = A.effectiveRefreshRate, this.stats.frameRate.mode = A.frameRateMode, this.stats.frameRate.screenRefreshRate = A.screenRefreshRate), A.cv !== void 0 && (this.stats.cv = A.cv), A.contextType !== void 0 && (this.sceneContextType = A.contextType), A.frames !== void 0 && (this.stats.frames = A.frames, this.stats.timing = A.timing, this.stats.capabilities = A.capabilities, this.firePerformanceSnapshot());
     }), this.workerManager.onMessage("capability-transition", (A) => {
       this.fireCapabilityTransition(A);
     }), this.workerManager.onMessage("parameters-defined", (A) => {
@@ -7541,6 +7543,7 @@ class K {
     return {
       renderer: this.sceneRenderer,
       ...this.sceneP5CanvasMode !== void 0 && { p5CanvasMode: this.sceneP5CanvasMode },
+      ...this.sceneContextType !== void 0 && { contextType: this.sceneContextType },
       capabilities: this.sceneCapabilities,
       parameterCount: this.parameterValues.size,
       parameterCounts: A,
@@ -8597,6 +8600,12 @@ class K {
    * `getImageData()` (raster flush) for 2D-canvas scenes, so `gpuMs` is
    * populated for both (`null` only with no drawable context).
    *
+   * 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.
+   *
    * Use only on a scene NOT serving as a live compositor source/mixer —
    * the per-frame fence would stutter the mixer output (enforced below).
    * In-session `frameIntervalMs` includes the fence stall (session-relative);
@@ -8780,4 +8789,4 @@ export {
   S as b,
   PB as g
 };
-//# sourceMappingURL=index-BH2kB2OG.js.map
+//# sourceMappingURL=index-DYUAz0BO.js.map

package/dist/index.d.ts

@@ -754,6 +754,12 @@ declare interface ButtonParameter {
     category: ParameterCategory;
 }
 
+/**
+ * The canvas rendering context a scene actually locked. Detected at runtime
+ * (authoritative) once the context is acquired. See {@link SceneData.contextType}.
+ */
+export declare type CanvasContextType = '2d' | 'webgl' | 'webgl2';
+
 /**
  * An immediate edge in a capability's consumed-meaningfully state, delivered
  * via `onCapabilityTransition`. Fires the instant the bit flips, independent
@@ -1260,8 +1266,10 @@ export declare interface FramePerfSample {
      * Fence-accurate downstream frame time in ms, or `null` when unavailable.
      * Always `null` in steady state. Populated only by `runFencedBenchmark()`:
      * WebGL scenes via `gl.finish()` (GPU drain), 2D-canvas scenes via
-     * `getImageData()` (raster flush). `null` only when there is no drawable
-     * context or readback fails.
+     * `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
+     * `frameIntervalMs` for 2D raster cost on WebKit.
      */
     gpuMs: number | null;
     /** Interval since the previous rendered frame (ms). Session-relative under benchmark. */
@@ -1989,6 +1997,13 @@ export declare interface SceneData {
     renderer: RendererType;
     /** P5 canvas mode; present only when `renderer` is `'p5'`. */
     p5CanvasMode?: P5CanvasMode;
+    /**
+     * The canvas context the scene actually locked (`'2d'` / `'webgl'` /
+     * `'webgl2'`), detected at runtime. Present once the context locks (first
+     * render); `undefined` before that. Authoritative — Core locks the context,
+     * so this is exact even for native scenes with dynamic `useContext`.
+     */
+    contextType?: CanvasContextType;
     /** Capabilities the scene's code declares it uses (inclusive-biased). */
     capabilities: SceneCapabilities;
     /** Total number of parameters the scene defines. */
@@ -3060,6 +3075,7 @@ export declare class VijiCore {
     private sceneRenderer;
     private sceneCapabilities;
     private sceneP5CanvasMode?;
+    private sceneContextType?;
     private parametersInitialized;
     private parameterListeners;
     private parameterDefinedListeners;
@@ -3878,6 +3894,12 @@ export declare class VijiCore {
      * `getImageData()` (raster flush) for 2D-canvas scenes, so `gpuMs` is
      * populated for both (`null` only with no drawable context).
      *
+     * 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.
+     *
      * Use only on a scene NOT serving as a live compositor source/mixer —
      * the per-frame fence would stutter the mixer output (enforced below).
      * In-session `frameIntervalMs` includes the fence stall (session-relative);

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as a, V as i, a as s, b as e } from "./index-BH2kB2OG.js";
+import { A as a, V as i, a as s, b as e } from "./index-DYUAz0BO.js";
 export {
   a as AudioSystem,
   i as VERSION,

package/package.json

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