@viji-dev/core 0.17.0 → 0.19.0

package/dist/index.d.ts

@@ -1117,7 +1117,12 @@ declare interface ImageConfig {
  * the image works directly with `image()`, `texture()`, etc.
  */
 declare interface ImageParameter {
-    /** Uploaded image as an `ImageBitmap`, or `null` until the user provides one. */
+    /**
+     * Uploaded image as an `ImageBitmap`, or `null` until the user provides one.
+     * Read it where you use it (inside `render()`): when the host replaces or
+     * clears the image, the previous bitmap is closed, so a reference kept from
+     * an earlier frame becomes unusable.
+     */
     value: ImageBitmap | null;
     /** P5-compatible image wrapper. Only available in the P5 renderer; added at runtime by the P5 adapter. */
     readonly p5?: any;
@@ -2453,7 +2458,7 @@ declare interface TouchPoint {
 /** Returned by `on*` listener registration calls; invoke to unsubscribe. */
 export declare type Unsubscribe = () => void;
 
-export declare const VERSION = "0.17.0";
+export declare const VERSION = "0.19.0";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side
@@ -2867,6 +2872,13 @@ export declare class VijiCore {
      */
     private debugLog;
     private config;
+    /**
+     * `config.initialParameters` after `sanitizeInitialParameters` (set in
+     * `initialize()`, cleared in `destroy()`). Overlaid onto `parameterValues`
+     * when the worker reports its definitions, so the host table matches what
+     * the worker seeded before frame 1. `null` when no seed was supplied.
+     */
+    private initialSeed;
     private isHeadless;
     private static readonly DIRECT_FRAME_BASE;
     private engineGroup;
@@ -3203,10 +3215,6 @@ export declare class VijiCore {
      * Check if parameters have been initialized
      */
     get parametersReady(): boolean;
-    /**
-     * Send all current parameter values to worker (used for initial sync)
-     */
-    private syncAllParametersToWorker;
     /**
      * Add listener for when the scene's parameters are defined. Fires exactly once
      * per scene load, after the scene registers its parameters — including scenes
@@ -4045,8 +4053,19 @@ export declare interface VijiCoreConfig {
      * 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).
+     * parameter's definition exactly like {@link VijiCore.setParameter}. The host
+     * table mirrors the seed once the scene reports its parameters, so
+     * {@link VijiCore.getParameterValues} inside `onParametersDefined` returns the
+     * seeded values. Seeds are the initial state, not a change: no
+     * `onParameterChange` notification is emitted for them.
+     *
+     * Image parameters accept an `ImageBitmap` (or `null`). The bitmap is
+     * structured-cloned to the scene and the object you pass becomes core's host
+     * copy (returned by `getParameter` / `getParameterValues`, handed to
+     * listeners): do not close it while the core lives. A bitmap that is already
+     * closed is dropped from the seed with a console warning. URL strings are
+     * not resolved and `File` / `Blob` values are not seedable; use
+     * {@link VijiCore.setParameter} after `onParametersDefined` for those.
      */
     initialParameters?: Record<string, ParameterValue>;
     /** Frame rate mode - render every frame (`'full'`), every 2nd (`'half'`), every 4th (`'quarter'`), or every 8th (`'eighth'`). */

package/dist/index.js

@@ -1,8 +1,8 @@
-import { C as E, I as o, V as s, a as C, b as I } from "./index-BxSadexI.js";
-export {
-  E as CV_FEATURE_KEYS,
-  o as INPUT_CAPABILITY_KEYS,
-  s as VERSION,
-  C as VijiCore,
-  I as VijiCoreError
-};
+import { C as E, I as o, V as s, a as C, b as I } from "./index-PgPvRJ2p.js";
+export {
+  E as CV_FEATURE_KEYS,
+  o as INPUT_CAPABILITY_KEYS,
+  s as VERSION,
+  C as VijiCore,
+  I as VijiCoreError
+};

package/package.json

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