@patterkit/runtime 0.14.2 → 0.15.0

package/CHANGELOG.md

@@ -33,6 +33,30 @@ 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
+
+- **The JS zip's module builds work without npm.** The zip carried the npm package's module build,
+  which imports five other packages the zip never included, so copying it into a project and
+  importing it failed until you installed them from npm. The zip now carries builds of the runtime
+  and of `@patterkit/play-helpers` with their dependencies inside them, under
+  `@patterkit/runtime/dist/` and `@patterkit/play-helpers/dist/`. They carry their own registry as a
+  result; to share one registry between engines, install from npm. The npm package is unchanged.
+
 ## [0.14.2] - 2026-09-27
 
 ### Changed

package/README.md

@@ -16,9 +16,11 @@ Three equivalent channels - pick whichever fits how you work; **no npm is requir
   [`play-js-v*` GitHub Release](https://github.com/patterkit/patter/releases) - this
   runtime as a plain download, symmetric with the Unity / Unreal / Godot plugin zips.
   It carries `patterplay.min.js` (the `<script>` drop-in: this runtime plus
-  `@patterkit/play-helpers` under one global), the module builds under `dist/` (ESM + CJS +
-  types, for vendoring into your own build), this README, the CHANGELOG, and two `demos/`
-  (the zero-build drop-in page and the interactive tour).
+  `@patterkit/play-helpers` under one global), the module builds of both packages under
+  `@patterkit/runtime/dist/` and `@patterkit/play-helpers/dist/` (ESM + CJS + types, with their
+  dependencies inside them, so they need nothing installed), this README, the CHANGELOG, and two
+  `demos/` (the zero-build drop-in page and the interactive tour). The zip's builds carry their own
+  registry; to share one registry between engines, install from npm.
 - **npm**: `npm install @patterkit/runtime` (same version as the zip). `@wildwinter/scoperegistry`
   is a peer dependency, so a game holds one registry that every engine shares; npm installs it for
   you, and a package manager that doesn't install peers needs `npm install @wildwinter/scoperegistry`.

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) {