@viji-dev/core 0.11.4 → 0.11.6

package/dist/index.d.ts

@@ -239,6 +239,16 @@ declare interface AudioStreamAPI {
 export declare class AudioSystem {
     private audioContext;
     private workletRegistered;
+    /**
+     * Persistent export capture tap (main channel only). Created lazily by
+     * `getAudioCaptureStream()`, lives for the AudioSystem lifetime, and is
+     * torn down only in `resetAudioState()`. Deliberately NOT severed by
+     * `disconnectMainStream()`: on mid-recording disconnect the tap stream
+     * goes silent while its tracks stay live, and `connectChannel()` re-wires
+     * each new main source node into it, so the exposed MediaStream stays
+     * stable across `setAudioStream()` swaps (a recorder never renegotiates).
+     */
+    private captureDestination;
     private mainChannel;
     private additionalChannels;
     private analysisInterval;
@@ -372,6 +382,18 @@ export declare class AudioSystem {
             flatness: number;
         };
     };
+    /**
+     * Get a recordable MediaStream carrying the main channel's audio, for
+     * host-side export recording. Main channel only — additional channels and
+     * source-fed device channels (analysis values, no PCM) are not included.
+     *
+     * The underlying destination node is created lazily on first call and then
+     * persists for the AudioSystem lifetime: on a source swap the stream keeps
+     * flowing with the new audio, and on disconnect it goes silent with tracks
+     * still live. Returns `null` when the main channel is not connected at
+     * call time (or after teardown).
+     */
+    getAudioCaptureStream(): MediaStream | null;
     /**
      * Initialize Essentia.js (async WASM loading)
      */
@@ -894,6 +916,13 @@ export declare interface CaptureFrameOptions {
     format?: 'blob' | 'bitmap';
     /** MIME type for `'blob'` output (ignored for `'bitmap'`). Examples: `'image/png'`, `'image/jpeg'`, `'image/webp'`. */
     type?: string;
+    /**
+     * Encoding quality for lossy `'blob'` formats (`'image/jpeg'`, `'image/webp'`),
+     * from `0` (smallest) to `1` (best). Values outside the range are clamped.
+     * Ignored for `'image/png'` and for `format: 'bitmap'`. When omitted, the
+     * browser's default quality is used.
+     */
+    quality?: number;
     /**
      * Target resolution.
      * - `number`: scale factor relative to the current canvas size (e.g., `0.5` = 50%).
@@ -2832,7 +2861,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.4";
+export declare const VERSION = "0.11.6";
 
 /**
  * Real-time video API: drawable frame, dimensions, and the source-side
@@ -3019,13 +3048,13 @@ export declare interface VideoCVAPI {
 }
 
 /**
- * Video stream categorization type
- * - main: Primary video with CV processing (viji.video)
- * - additional: Host-provided MediaStreams without CV (viji.videoStreams[])
- * - directFrame: Injected frames from compositor pipeline (viji.videoStreams[], after additional)
- * - device: Device-provided camera streams (device.video)
+ * Video stream role, derived from position in the index contract.
+ * - main:        primary video with CV (`viji.video`)
+ * - additional:  host-provided MediaStreams, no CV (`viji.videoStreams[]`)
+ * - device:      device camera streams (`viji.devices[].video`)
+ * - directFrame: injected compositor frames (`viji.videoStreams[]`, after additional)
  */
-export declare type VideoStreamType = 'main' | 'additional' | 'directFrame' | 'device';
+export declare type VideoStreamType = 'main' | 'additional' | 'device' | 'directFrame';
 
 /**
  * The Viji API surface available to artist code as the global `viji` object.
@@ -3735,6 +3764,36 @@ export declare class VijiCore {
      * sharing this core's media engines)
      */
     getAudioStream(): MediaStream | null;
+    /**
+     * Gets a recordable MediaStream carrying the main audio channel's signal,
+     * for client-side export recording (e.g. feeding a WebCodecs
+     * `AudioEncoder` or `MediaRecorder` while capturing scene video).
+     *
+     * The returned stream is stable across `setAudioStream()` swaps: obtain it
+     * once at record start and keep recording — a source change flows into the
+     * same stream with no renegotiation. If audio is disconnected
+     * mid-recording the stream goes **silent** (tracks stay live, the A/V
+     * timeline stays continuous); its tracks end only when the media engines
+     * are disposed (last core sharing them destroyed).
+     *
+     * Scope: main channel only. Additional audio channels and remote-device
+     * audio (analysis values only, no PCM host-side) are not included.
+     * Engine-scoped — identical for all cores sharing this core's media
+     * engines, like {@link getAudioStream}.
+     *
+     * @returns The capture stream, or `null` when no main audio is connected
+     * at call time.
+     *
+     * @example
+     * ```ts
+     * const audioTap = core.getAudioCaptureStream();
+     * if (audioTap) {
+     *   const [track] = audioTap.getAudioTracks();
+     *   // feed track into MediaStreamTrackProcessor → AudioEncoder
+     * }
+     * ```
+     */
+    getAudioCaptureStream(): MediaStream | null;
     /**
      * Enables or disables user interactions (mouse, keyboard, touch) at runtime
      */

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-LgAeJ6JG.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-BKvsDqj0.js";
 export {
   e as AudioSystem,
   i as CV_FEATURE_KEYS,

package/package.json

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