narraleaf-react 0.24.0 → 0.24.1

package/dist/game/nlcore/action/actions/characterAction.d.ts

@@ -15,6 +15,23 @@ export declare class CharacterAction<T extends typeof CharacterActionTypes[keyof
     };
     static getVoice(state: GameState, sentence: Sentence): Sound | null;
     private static endVoiceWithPreference;
+    /**
+     * The line voice still running past the end of its own sentence, per game.
+     *
+     * Only `voiceEndMode: "none"` ever leaves one - the other two modes stop the clip at line end.
+     * A WeakMap rather than a field on `GameState` because this is bookkeeping between two
+     * consecutive `say`s, not state a host or a save has any business seeing.
+     */
+    private static readonly trailingVoice;
+    /**
+     * Cut whatever is still playing from an earlier line before this one's voice starts.
+     *
+     * "Let it play on" means the clip outlives its own sentence - it does not mean two actors talk
+     * at once. Without this, advancing through voiced lines under that mode layered every clip over
+     * the last one, and a player clicking quickly could stack three or four. Unvoiced lines pass by
+     * without cutting anything, which is the whole point of the mode.
+     */
+    static cutTrailingVoice(gameState: GameState, next: Sound | null): void;
     executeAction(gameState: GameState, injection: ActionExecutionInjection): ExecutedActionResult;
     stringify(_story: Story, _seen: Set<LogicAction.Actions>, _strict: boolean): string;
 }

package/dist/game/nlcore/elements/scene.d.ts

@@ -41,6 +41,8 @@ export type SceneDataRaw = {
     state: Record<string, any>;
 };
 export declare class Scene extends Constructable<LogicAction.Actions, Scene> {
+    /** Resolved voice src -> the one `Sound` that plays it. See {@link Scene.getVoice}. */
+    private readonly voiceCache;
     get local(): Persistent<any>;
     get background(): Image;
     get backgroundLayer(): Layer;