narraleaf-react 0.19.0 → 0.19.2

package/dist/game/nlcore/action/stackModel.d.ts

@@ -64,7 +64,13 @@ export type StackModelRawData = {
 /**
  * One frame of a read-only {@link StackModel.snapshot} — an action currently on the execution
  * stack. A frame that is a concurrent group ({@link Control.all}/{@link Control.any}) also lists
- * its branches (each a top-to-bottom frame list).
+ * its branches, each a whole {@link StackSnapshot}.
+ *
+ * `branches` used to be `StackFrameSnapshot[][]` — only each branch's `frames`. That silently threw
+ * away everything a nested stack knows about ITSELF: a `Control.repeat` runs as a nested StackModel,
+ * so its `loop` counter lived on a snapshot whose frames were kept and whose `loop` and `tag` were
+ * dropped on the way out. The counter was therefore unreachable from `getStackSnapshot()` no matter
+ * how a caller asked, which is exactly what a debug view most wants to show.
  *
  * **Experimental / read-only.** For tooling (Studio's call-stack view). The exact shape is not a
  * stable contract and may change; do not serialize it or drive game logic from it.
@@ -73,7 +79,7 @@ export type StackFrameSnapshot = {
     actionId: string | null;
     actionType: string | null;
     branchWaitType?: StackModelWaiting["type"];
-    branches?: StackFrameSnapshot[][];
+    branches?: StackSnapshot[];
 };
 /**
  * Read-only view of a StackModel's execution stack. `frames` are ordered top-first (the frame

package/dist/game/nlcore/elements/character/avatar.d.ts

@@ -33,3 +33,15 @@ export declare function resolveDialogAvatar(ctx: DialogAvatarResolverContext & {
     portraitAvatar?: DialogAvatar;
     characterAvatar?: DialogAvatar | false;
 }): DialogAvatarResolution;
+/**
+ * Every avatar source a character can show that is knowable ahead of time.
+ *
+ * Only *static* sources are enumerable. A {@link DialogAvatarResolver} derives its answer from the
+ * portrait's live state, so what it can return is invisible from here — the same limitation, and
+ * for the same reason, as a layer {@link LayerResolver}. Callers that preload from this should say
+ * so, and a project whose avatars are resolver-driven has to register them itself.
+ *
+ * `false` is not an absence of a source, it is an instruction to show none; either way there is
+ * nothing to preload.
+ */
+export declare function collectStaticAvatarSources(character: Character, sentence?: Sentence | null): ImageSrc[];