@patterkit/runtime 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -33,6 +33,22 @@ version number always means the same runtime behaviour. This package is versione
 
 ## [Unreleased]
 
+## [0.21.0] - 2026-10-07
+
+### Changed
+
+- **A new `Engine` on a bundle another engine already uses no longer rebuilds the tag index.** It is built once
+  per bundle and shared, so a tool that starts a fresh engine for every run (coverage does) starts each in about
+  a third of the time: 0.5 ms rather than 1.6 ms on a 100-scene project.
+- **The conformance corpus covers more, and every runtime is held to it**: the outline and beat sequence, the
+  audio resolver's joins, `listProperties`, what a checkpoint refuses while it is open, a save taken inside one,
+  and a block named under another scene.
+
+### Fixed
+
+- **Tags handed out are the caller's own.** `tagsForBeat`, `tagsForScene`, `tagsForBlock`, and a delivered
+  line's `tags` are copies, so a game that edits one changes nothing the engine says afterwards.
+
 ## [0.20.0] - 2026-10-06
 
 ### Added

package/dist/index.cjs

@@ -76,6 +76,18 @@ function buildTagIndex(bundle) {
 // src/engine.ts
 var import_model2 = require("@patterkit/model");
 var astCache = /* @__PURE__ */ new WeakMap();
+var tagIndexCache = /* @__PURE__ */ new WeakMap();
+function tagIndexFor(bundle) {
+  let index = tagIndexCache.get(bundle);
+  if (!index) {
+    index = buildTagIndex(bundle);
+    tagIndexCache.set(bundle, index);
+  }
+  return index;
+}
+function tagsOf(host, id) {
+  return host.tagIndex.get(id)?.slice();
+}
 var OWNER = "Patter";
 var esc = (id) => id.replace(/%/g, "%25").replace(/\//g, "%2F");
 var OWNS_REGISTRY = /* @__PURE__ */ Symbol("ownsRegistry");
@@ -204,7 +216,7 @@ var Engine = class _Engine {
       sceneGameIdToId: this.sceneGameIdToId,
       blockGameIdToId: this.blockGameIdToId,
       // same instances the engine resolves with
-      tagIndex: buildTagIndex(bundle),
+      tagIndex: tagIndexFor(bundle),
       registry,
       ownsRegistry,
       patterBag,
@@ -463,18 +475,18 @@ var Engine = class _Engine {
    * delivered step carries. Empty array for an unknown id or a beat with no tags anywhere up the chain.
    */
   tagsForBeat(beatId) {
-    return this.host.tagIndex.get(beatId) ?? [];
+    return tagsOf(this.host, beatId) ?? [];
   }
   /** A scene's own tags (by internal id or gameId address). Empty when none / unknown. */
   tagsForScene(sceneRef) {
     const id = this.resolveSceneRef(sceneRef);
-    return (id != null ? this.host.tagIndex.get(id) : void 0) ?? [];
+    return (id != null ? tagsOf(this.host, id) : void 0) ?? [];
   }
   /** A block's accumulated tags (scene + block), by scene + block ref (id or gameId). Empty when none / unknown. */
   tagsForBlock(sceneRef, blockRef) {
     const sceneId = this.resolveSceneRef(sceneRef);
     const id = this.resolveBlockRef(sceneId, blockRef);
-    return (id != null ? this.host.tagIndex.get(id) : void 0) ?? [];
+    return (id != null ? tagsOf(this.host, id) : void 0) ?? [];
   }
   /**
    * A scene's own author gameData (by internal id or gameId address): the RAW sparse overrides, exactly
@@ -593,7 +605,7 @@ var Engine = class _Engine {
   }
   /** One beat's static data (source locale), the same shape a delivered step carries. */
   beatInfo(beat) {
-    const tags = this.host.tagIndex.get(beat.id);
+    const tags = tagsOf(this.host, beat.id);
     const info = { id: beat.id, kind: beat.kind };
     if (beat.kind === "line") {
       if (beat.character !== void 0) {
@@ -613,7 +625,7 @@ var Engine = class _Engine {
   }
   /** A `{ tags }` fragment for an id, present only when the id has accumulated tags (keeps output tidy). */
   tagsField(id) {
-    const tags = this.host.tagIndex.get(id);
+    const tags = tagsOf(this.host, id);
     return tags && tags.length ? { tags } : {};
   }
   /** Retrieve an open flow by id (undefined if none / closed). */
@@ -750,8 +762,6 @@ var Engine = class _Engine {
     this.host.registry.set(scope, name, value, { host: true });
     if (this.host.journal && prev !== void 0) this.host.journal.undo.push(() => this.host.registry.set(scope, name, prev, { host: true }));
   }
-  /** The shared `@patter` properties, for a live state inspector: each with its ref, type, current
-   *  value, declared default (for reset), and enum options. Mirrors the Unity / Godot ports. */
   /** The run's decisions, in order, each naming the flow it happened in. Empty unless the
    *  run was opened with `log: true`. A flow's own log stays flow-local; this is the only
    *  place a story spanning several flows reads as one sequence. */
@@ -783,6 +793,8 @@ var Engine = class _Engine {
   getVisitCounts() {
     return Object.fromEntries(this.host.sharedVisits);
   }
+  /** The shared `@patter` properties, for a live state inspector: each with its ref, type, current
+   *  value, declared default (for reset), and enum options. Every runtime has the same call. */
   listProperties() {
     return this.host.patterSharedDecls.map((d) => ({
       name: d.name,
@@ -1770,7 +1782,7 @@ var Flow = class {
   };
   // -- Strings / beats ------------------------------------------------------
   beatResult(beat) {
-    const tags = this.host.tagIndex.get(beat.id);
+    const tags = tagsOf(this.host, beat.id);
     const withTags = tags && tags.length ? { tags } : {};
     switch (beat.kind) {
       case "gameEvent":
@@ -1837,7 +1849,7 @@ var Flow = class {
   /** A replayed prompt as a step: the beat's id, gameData, and tags, and the text and speaker fields the
    *  choice showed. */
   promptResult(beat, shown) {
-    const tags = this.host.tagIndex.get(beat.id);
+    const tags = tagsOf(this.host, beat.id);
     const withTags = tags && tags.length ? { tags } : {};
     if (shown.kind === "text") return { type: "text", id: beat.id, text: shown.text, gameData: beat.gameData, ...withTags };
     return {