@patterkit/runtime 0.14.2 → 0.15.0

package/dist/index.d.cts

@@ -69,6 +69,8 @@ interface OutlineBlock {
     id: string;
     gameId?: string;
     name: string;
+    /** The block's own author gameData overrides (raw, not merged with defaults). Omitted when empty. */
+    gameData?: GameData;
     tags?: string[];
     children: OutlineNode[];
 }
@@ -77,6 +79,8 @@ interface OutlineScene {
     id: string;
     gameId?: string;
     name: string;
+    /** The scene's own author gameData overrides (raw, not merged with defaults). Omitted when empty. */
+    gameData?: GameData;
     tags?: string[];
     blocks: OutlineBlock[];
 }
@@ -483,6 +487,16 @@ declare class Engine {
     tagsForScene(sceneRef: string): string[];
     /** A block's accumulated tags (scene + block), by scene + block ref (id or gameId). Empty when none / unknown. */
     tagsForBlock(sceneRef: string, blockRef: string): string[];
+    /**
+     * A scene's own author gameData (by internal id or gameId address): the RAW sparse overrides, exactly
+     * as a beat's step carries its own, not merged with the project's declared field defaults (resolve
+     * those with `effectiveGameData(gameDataFields(bundle, "scene"), ...)`). Not inherited by its blocks.
+     * A fresh object each call; empty when the scene sets none or the ref is unknown.
+     */
+    gameDataForScene(sceneRef: string): GameData;
+    /** A block's own author gameData, by scene + block ref (id or gameId). Raw overrides, like
+     *  {@link gameDataForScene}; the scene's gameData is not folded in. Empty when none / unknown. */
+    gameDataForBlock(sceneRef: string, blockRef: string): GameData;
     /**
      * Every cast member the PROJECT declares, in authored order - the same list `describeBundle` counts.
      * A superset of any scene's cast: the validator holds a beat's `character` to a declared member, so

package/dist/index.d.ts

@@ -69,6 +69,8 @@ interface OutlineBlock {
     id: string;
     gameId?: string;
     name: string;
+    /** The block's own author gameData overrides (raw, not merged with defaults). Omitted when empty. */
+    gameData?: GameData;
     tags?: string[];
     children: OutlineNode[];
 }
@@ -77,6 +79,8 @@ interface OutlineScene {
     id: string;
     gameId?: string;
     name: string;
+    /** The scene's own author gameData overrides (raw, not merged with defaults). Omitted when empty. */
+    gameData?: GameData;
     tags?: string[];
     blocks: OutlineBlock[];
 }
@@ -483,6 +487,16 @@ declare class Engine {
     tagsForScene(sceneRef: string): string[];
     /** A block's accumulated tags (scene + block), by scene + block ref (id or gameId). Empty when none / unknown. */
     tagsForBlock(sceneRef: string, blockRef: string): string[];
+    /**
+     * A scene's own author gameData (by internal id or gameId address): the RAW sparse overrides, exactly
+     * as a beat's step carries its own, not merged with the project's declared field defaults (resolve
+     * those with `effectiveGameData(gameDataFields(bundle, "scene"), ...)`). Not inherited by its blocks.
+     * A fresh object each call; empty when the scene sets none or the ref is unknown.
+     */
+    gameDataForScene(sceneRef: string): GameData;
+    /** A block's own author gameData, by scene + block ref (id or gameId). Raw overrides, like
+     *  {@link gameDataForScene}; the scene's gameData is not folded in. Empty when none / unknown. */
+    gameDataForBlock(sceneRef: string, blockRef: string): GameData;
     /**
      * Every cast member the PROJECT declares, in authored order - the same list `describeBundle` counts.
      * A superset of any scene's cast: the validator holds a beat's `character` to a declared member, so

package/dist/index.js

@@ -388,6 +388,24 @@ var Engine = class _Engine {
     const id = this.resolveBlockRef(sceneId, blockRef);
     return (id != null ? this.host.tagIndex.get(id) : void 0) ?? [];
   }
+  /**
+   * A scene's own author gameData (by internal id or gameId address): the RAW sparse overrides, exactly
+   * as a beat's step carries its own, not merged with the project's declared field defaults (resolve
+   * those with `effectiveGameData(gameDataFields(bundle, "scene"), ...)`). Not inherited by its blocks.
+   * A fresh object each call; empty when the scene sets none or the ref is unknown.
+   */
+  gameDataForScene(sceneRef) {
+    const id = this.resolveSceneRef(sceneRef);
+    const scene = id != null ? this.host.bundle.scenes[id] : void 0;
+    return { ...scene?.gameData };
+  }
+  /** A block's own author gameData, by scene + block ref (id or gameId). Raw overrides, like
+   *  {@link gameDataForScene}; the scene's gameData is not folded in. Empty when none / unknown. */
+  gameDataForBlock(sceneRef, blockRef) {
+    const id = this.resolveBlockRef(this.resolveSceneRef(sceneRef), blockRef);
+    const block = id != null ? this.host.blockById.get(id) : void 0;
+    return { ...block?.gameData };
+  }
   /**
    * Every cast member the PROJECT declares, in authored order - the same list `describeBundle` counts.
    * A superset of any scene's cast: the validator holds a beat's `character` to a declared member, so
@@ -434,11 +452,13 @@ var Engine = class _Engine {
       id: scene.id,
       ...effectiveGameId(scene) ? { gameId: effectiveGameId(scene) } : {},
       name: scene.name,
+      ...gameDataField(scene.gameData),
       ...this.tagsField(scene.id),
       blocks: scene.blocks.map((block) => ({
         id: block.id,
         ...effectiveGameId(block) ? { gameId: effectiveGameId(block) } : {},
         name: block.name,
+        ...gameDataField(block.gameData),
         ...this.tagsField(block.id),
         children: block.children.map((n) => this.outlineNode(n))
       }))
@@ -1641,6 +1661,9 @@ function collectCast(nodes, out) {
     for (const beat of n.beats ?? []) if (beat.kind === "line" && beat.character) out.add(beat.character);
   });
 }
+function gameDataField(gameData) {
+  return gameData && Object.keys(gameData).length ? { gameData } : {};
+}
 function serialiseSelectors(map) {
   const out = {};
   for (const [id, st] of map) {