@viji-dev/core 0.17.0 → 0.18.0

package/dist/artist-global-p5.d.ts

@@ -917,7 +917,12 @@ declare global {
    * the image works directly with `image()`, `texture()`, etc.
    */
   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;
@@ -1465,7 +1470,7 @@ declare global {
       isEnding: boolean;
   }
 
-  const VERSION = "0.17.0";
+  const VERSION = "0.18.0";
 
   /**
    * Real-time video API: drawable frame, dimensions, and the source-side

package/dist/artist-global.d.ts

@@ -917,7 +917,12 @@ declare global {
    * the image works directly with `image()`, `texture()`, etc.
    */
   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;
@@ -1454,7 +1459,7 @@ declare global {
       isEnding: boolean;
   }
 
-  const VERSION = "0.17.0";
+  const VERSION = "0.18.0";
 
   /**
    * Real-time video API: drawable frame, dimensions, and the source-side

package/dist/artist-jsdoc.d.ts

@@ -196,7 +196,7 @@
 /**
  * Reactive object returned by `viji.image()`. `value` is `null` until the user uploads an image; in P5 scenes a `.p5` accessor is also added at runtime so the image works directly with `image()`, `texture()`, etc.
  * @typedef {Object} ImageParameter
- * @property {ImageBitmap |null} value - Uploaded image as an `ImageBitmap`, or `null` until the user provides one.
+ * @property {ImageBitmap |null} value - 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.
  * @property {string} [label] - P5-compatible image wrapper. Only available in the P5 renderer; added at runtime by the P5 adapter. Display name shown next to the upload field in the parameter UI.
  * @property {string} [description] - Tooltip / help text for the control (empty string when not configured).
  * @property {string} group - Group name under which the control appears in the UI.