@viji-dev/core 0.11.7 → 0.11.8

package/dist/docs-api.js

@@ -1,7 +1,7 @@
 export const docsApi = {
   "version": "1.1.0",
-  "coreVersion": "0.11.7",
-  "generatedAt": "2026-07-24T15:25:39.379Z",
+  "coreVersion": "0.11.8",
+  "generatedAt": "2026-08-06T16:39:30.974Z",
   "navigation": [
     {
       "id": "getting-started",

package/dist/{essentia-wasm.web-QxZd-8n4.js → essentia-wasm.web-B48G7Mzk.js}

@@ -1,4 +1,4 @@
-import { g as kn } from "./index-zKfpXJhf.js";
+import { g as kn } from "./index-fdus0y3o.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-QxZd-8n4.js.map
+//# sourceMappingURL=essentia-wasm.web-B48G7Mzk.js.map

package/dist/{index-zKfpXJhf.js → index-fdus0y3o.js}

@@ -547,7 +547,7 @@ class lB {
       }
   }
 }
-const nB = "" + new URL("assets/viji.worker-BKg5vsqf.js", import.meta.url).href;
+const nB = "" + new URL("assets/viji.worker-B1ltcEP7.js", import.meta.url).href;
 class dB {
   constructor(A, B, I) {
     this.iframeManager = A, this.sceneCode = B, this.init = I;
@@ -792,6 +792,7 @@ class dB {
             Q
           );
         }
+      else B.data?.bitmap instanceof ImageBitmap && B.data.bitmap.close();
     }, this.iframeManager.onWorkerMessage(this.onWorkerMessageBound);
   }
 }
@@ -1518,7 +1519,7 @@ class HB {
     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-QxZd-8n4.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-B48G7Mzk.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");
@@ -11631,7 +11632,7 @@ function HI(D) {
     expectedVersion: 1
   } : typeof A.senderTime != "number" ? { code: "invalid-field", details: "senderTime must be a number", field: "senderTime" } : null;
 }
-const mI = "0.11.7";
+const mI = "0.11.8";
 export {
   eA as A,
   LI as C,
@@ -11642,4 +11643,4 @@ export {
   J as c,
   gI as g
 };
-//# sourceMappingURL=index-zKfpXJhf.js.map
+//# sourceMappingURL=index-fdus0y3o.js.map

package/dist/index.d.ts

@@ -2871,7 +2871,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.7";
+export declare const VERSION = "0.11.8";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side
@@ -3279,6 +3279,21 @@ export declare class VijiCore {
     /**
      * Capture current scene frame
      * @param options.format 'blob' = encoded image, 'bitmap' = GPU-friendly ImageBitmap
+     *
+     * Readiness: the request queues in the worker and drains in the
+     * post-render slot of the first tick where artist drawing code dispatched
+     * cleanly against a canvas with a rendering context. Ticks where the scene
+     * is still in async setup, a shader is compiling, p5 is initializing, or
+     * the render threw are skipped — so `captureFrame` right after
+     * `initialize()` waits for the scene's first real frame instead of
+     * snapshotting a pre-first-paint canvas. The gate is per-tick, not
+     * latched: on a live scene whose render is transiently throwing, the
+     * capture holds until the next clean tick. This is an engine-readiness
+     * gate, not a content guarantee — pixel output is never inspected, so a
+     * scene whose render runs but draws nothing (or draws black) captures
+     * exactly that. A scene that never reaches a clean painted tick (broken
+     * code, render throwing persistently) rejects with `MESSAGE_TIMEOUT`
+     * after 10s.
      */
     captureFrame(options: {
         format: 'bitmap';

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as e, C as i, I as r, V as o, a as C, c as E, b as A } from "./index-zKfpXJhf.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-fdus0y3o.js";
 export {
   e as AudioSystem,
   i as CV_FEATURE_KEYS,

package/package.json

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