narraleaf-react 0.24.0 → 0.25.0

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/built-in/DevTools.d.ts

@@ -54,6 +54,17 @@ export declare class DevTools {
      * (use a distinct prefix so they never collide with generated ids).
      */
     static setElementId(element: LogicAction.GameElement, id: string): void;
+    /**
+     * Name an element from the host's own documents, so story construction keeps that name instead
+     * of the position it happened to occupy.
+     *
+     * Unlike {@link setElementId}, this survives construction: generated ids are assigned after a
+     * host has finished building, and an id set with `setElementId` is overwritten there for
+     * anything the action tree reaches. Hosts that restore saved state should use this - a
+     * generated id moves to a different element the moment a line is written ahead of it, and the
+     * state a save carries then lands on the wrong element with nothing reporting it.
+     */
+    static setElementStaticId(element: LogicAction.GameElement, id: string | null): void;
     /**
      * Read a displayable's current transform-state props (position/opacity/zoom/rotation/scale/
      * effects...). Returns a shallow copy. Intended for editor hosts capturing a live pose

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;