@viji-dev/core 0.8.7 → 0.8.9

package/dist/docs-api.js

@@ -1,7 +1,7 @@
 export const docsApi = {
   "version": "1.1.0",
-  "coreVersion": "0.8.6",
-  "generatedAt": "2026-06-03T10:47:45.690Z",
+  "coreVersion": "0.8.8",
+  "generatedAt": "2026-06-03T12:32:04.533Z",
   "navigation": [
     {
       "id": "getting-started",

package/dist/{essentia-wasm.web-CB3NZc0t.js → essentia-wasm.web-BlVlDr0f.js}

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

package/dist/{index-I8omPYZ-.js → index-DsETtail.js}

@@ -536,7 +536,7 @@ class DB {
       }
   }
 }
-const hB = "" + new URL("assets/viji.worker-CydIeq-k.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-BXmR3RGQ.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;
@@ -652,7 +652,10 @@ class kB {
           R(G.data);
         }, this.controlPort.onmessage = this.onControlPortMessageBound;
       }
-      this.postMessage("set-scene-code", { sceneCode: this.sceneCode }), this.isInitialized = !0;
+      this.postMessage("set-scene-code", {
+        sceneCode: this.sceneCode,
+        ...this.init.initialParameters && { initialParameters: this.init.initialParameters }
+      }), this.isInitialized = !0;
     } catch (A) {
       throw A instanceof S && A.code === "INITIALIZATION_CANCELLED" ? A : this.isDestroyed ? new S(
         "Initialization cancelled",
@@ -1520,7 +1523,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-CB3NZc0t.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-BlVlDr0f.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");
@@ -7180,6 +7183,7 @@ class K {
           allowSensors: !!this.deviceSensorManager,
           sc: this.config._sc,
           rh: this.config._rh,
+          ...this.config.initialParameters && { initialParameters: this.config.initialParameters },
           reporterConfig: oI(this.config)
         }
       ), this.setupCommunication(), await this.workerManager.createWorker(), this.isDestroyed)
@@ -7758,7 +7762,11 @@ class K {
     }), this.debugLog(`Synced ${A.length} parameter values to worker`);
   }
   /**
-   * Add listener for when parameters are defined
+   * Add listener for when the scene's parameters are defined. Fires exactly once
+   * per scene load, after the scene registers its parameters — including scenes
+   * that define none, in which case `groups` is `[]`. This makes it a reliable
+   * "parameters resolved" signal for every scene (no need to time out a
+   * param-less scene).
    */
   onParametersDefined(A) {
     this.parameterDefinedListeners.add(A);
@@ -8763,7 +8771,7 @@ function DI(h) {
     expectedVersion: 1
   } : typeof A.senderTime != "number" ? { code: "invalid-field", details: "senderTime must be a number", field: "senderTime" } : null;
 }
-const hI = "0.8.6";
+const hI = "0.8.8";
 export {
   yA as A,
   hI as V,
@@ -8771,4 +8779,4 @@ export {
   S as b,
   PB as g
 };
-//# sourceMappingURL=index-I8omPYZ-.js.map
+//# sourceMappingURL=index-DsETtail.js.map

package/dist/index.d.ts

@@ -2659,7 +2659,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.8.6";
+export declare const VERSION = "0.8.8";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side
@@ -3314,7 +3314,11 @@ export declare class VijiCore {
      */
     private syncAllParametersToWorker;
     /**
-     * Add listener for when parameters are defined
+     * Add listener for when the scene's parameters are defined. Fires exactly once
+     * per scene load, after the scene registers its parameters — including scenes
+     * that define none, in which case `groups` is `[]`. This makes it a reliable
+     * "parameters resolved" signal for every scene (no need to time out a
+     * param-less scene).
      */
     onParametersDefined(listener: (groups: ParameterGroup[]) => void): void;
     /**
@@ -3962,6 +3966,16 @@ export declare interface VijiCoreConfig {
     hostContainer?: HTMLElement;
     /** Artist scene code to execute */
     sceneCode: string;
+    /**
+     * Parameter values to seed before the first frame, keyed by parameter name.
+     * Applied in the worker right after the scene defines each parameter (at its
+     * default) and before the first render, so the scene paints frame 1 with these
+     * values instead of popping from defaults a round-trip later. Names the scene
+     * does not define are silently ignored; values are validated against each
+     * parameter's definition exactly like {@link VijiCore.setParameter}. File /
+     * Blob / image-bitmap parameters are not seedable (serializable values only).
+     */
+    initialParameters?: Record<string, ParameterValue>;
     /** Frame rate mode - render every frame (`'full'`), every 2nd (`'half'`), every 4th (`'quarter'`), or every 8th (`'eighth'`). */
     frameRateMode?: FrameRateMode;
     /** Resolution: scale (number) or explicit dimensions (object). Required for headless, must be object form */

package/dist/index.js

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

package/package.json

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