@msb235/blits 0.3.0 → 0.4.0

package/dist/mixer.d.ts

@@ -1,4 +1,5 @@
 import { type Curve } from './easing.js';
+import { type Motions } from './motion.js';
 import { type Built, intosOf, type Scratch } from './patch.js';
 import { Store } from './store.js';
 import type { Channel, Engine, FadeSpec, Kit, Mix, MixOptions, Patch, Setting, VoiceSpec } from './types.js';
@@ -8,8 +9,10 @@ export interface Subject<S> {
     reaches: boolean;
     /** The voice's `stagger` answer in voice ms, fixed on first sight. */
     delay: number;
-    /** The mix timestamp this subject's delay ran out at, which its fade in counts from. */
+    /** The mix timestamp this subject's delay ran out at, which its step grid counts from. */
     since: number;
+    /** The mix timestamp its fade in counts from: `since`, or earlier for a voice holding before. */
+    shown: number;
     /** The weight this voice gave this subject the last frame it was probed, 0 where it gave none. */
     weight: number;
     /** Left at rest during a handover, so it stops contributing. */
@@ -102,7 +105,7 @@ export declare class Voice<I, O> {
     readonly patch: Patch<I, O, unknown>;
     readonly fade: FadeSpec;
     start: number;
-    state: 'pending' | 'live' | 'fading' | 'done';
+    state: 'pending' | 'live' | 'held' | 'fading' | 'done';
     rate: number;
     weight: number;
     /**
@@ -144,9 +147,31 @@ export declare class Voice<I, O> {
     keeping: boolean;
     /** For a motion patch, the hook it was given to ask the mix for its subjects' voice time. */
     frame: ((subject: I) => number) | null;
+    /** For a motion patch, the hook it was given to bring a subject faded out of this voice back. */
+    revive: ((subject: I) => void) | null;
+    /** Subjects fading out of this voice alone, by the ramp each started; null while none are. */
+    parts: Map<I, {
+        at: number;
+        over: number;
+    }> | null;
+    /** Subjects faded out of this voice, by the mix time each left at; null while none have. */
+    parted: Map<I, number> | null;
     readonly ease: Curve | undefined;
     /** How many passes its `loop` plays, worked out once. */
     readonly passes: number;
+    /** Voice ms its passes last, Infinity for an aperiodic patch or a loop for good. */
+    readonly span: number;
+    /** The state behind a motion patch, undefined for any other. */
+    readonly motion: Motions<I> | undefined;
+    /** Its `hold`, for a patch it applies to: motion holds its target already. */
+    readonly holdsBefore: boolean;
+    readonly holdsAfter: boolean;
+    /** The mix time it first showed: when it was cued, or the first sync after. */
+    opened: number;
+    /** Which of its entries in the mix's due queue is current; older ones are skipped when popped. */
+    dueToken: number;
+    /** Records made while it was pending, whose `since` its start may since have moved. */
+    early: Subject<unknown>[] | null;
     /** Reused for every call this voice makes, so it is valid only during the call. */
     readonly setting: Setting<unknown>;
     /** Every subject this voice has been asked about, so a handover knows when it is finished. */
@@ -166,6 +191,8 @@ export declare class Voice<I, O> {
     placing: boolean;
     resolve: () => void;
     readonly done: Promise<void>;
+    play: (played: boolean) => void;
+    readonly played: Promise<boolean>;
     constructor(id: number, spec: VoiceSpec<I, O>, patch: Patch<I, O, unknown>, fade: FadeSpec, now: number, start: number, slotOf: Map<string, number>, channels: readonly Channel<unknown>[], host: unknown, send: (event: unknown) => void);
     elapsedAt(now: number): number;
     /** The mix time its clock reads `elapsed`, inverting `elapsedAt`; Infinity where it never will. */