@patterkit/runtime 0.14.3 → 0.15.0

package/CHANGELOG.md

@@ -33,6 +33,19 @@ version number always means the same runtime behaviour. This package is versione
 
 ## [Unreleased]
 
+## [0.15.0] - 2026-10-03
+
+### Added
+
+- **Scene and block gameData you can read at runtime.** The bundle always carried a scene's and a
+  block's gameData, but nothing handed it to the host. Two static reads now do, by internal id or
+  gameId address. They return the node's own overrides, raw, the same rule as a beat's
+  `step.gameData`: the project's field defaults are not merged in (resolve them with
+  `effectiveGameData`), and a block does not inherit its scene's. A node that sets none, or a ref
+  that does not resolve, gives an empty object. `getOutline()` carries the same overrides as
+  `gameData` on each scene and block, left out when empty. Held across all four runtimes by the
+  conformance corpus. `engine.gameDataForScene(sceneRef)`, `engine.gameDataForBlock(sceneRef, blockRef)`.
+
 ## [0.14.3] - 2026-09-27
 
 ### Fixed

package/dist/index.cjs

@@ -420,6 +420,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
@@ -466,11 +484,13 @@ var Engine = class _Engine {
       id: scene.id,
       ...(0, import_model.effectiveGameId)(scene) ? { gameId: (0, import_model.effectiveGameId)(scene) } : {},
       name: scene.name,
+      ...gameDataField(scene.gameData),
       ...this.tagsField(scene.id),
       blocks: scene.blocks.map((block) => ({
         id: block.id,
         ...(0, import_model.effectiveGameId)(block) ? { gameId: (0, import_model.effectiveGameId)(block) } : {},
         name: block.name,
+        ...gameDataField(block.gameData),
         ...this.tagsField(block.id),
         children: block.children.map((n) => this.outlineNode(n))
       }))
@@ -1673,6 +1693,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) {