@patterkit/runtime 0.20.0 → 0.21.0

package/dist/index.d.cts

@@ -680,8 +680,6 @@ declare class Engine {
      *  across the family 2026-09-05, after a Storylets venue clock and this project's coverage driver
      *  were each refused the one property they existed to move.) */
     setProperty(ref: string, value: ScalarValue): void;
-    /** 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. */
@@ -696,6 +694,8 @@ declare class Engine {
     /** How many times each node has been entered across every flow, by node id: the shared count. With a
      *  flow's own {@link Flow.getVisitCounts}, every visit count the run keeps, read without a save. */
     getVisitCounts(): Record<string, number>;
+    /** 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(): PropertyRow[];
     private splitShared;
     /** The shared `@patter` values alone, as `{ patter: {...} }`.

package/dist/index.d.ts

@@ -680,8 +680,6 @@ declare class Engine {
      *  across the family 2026-09-05, after a Storylets venue clock and this project's coverage driver
      *  were each refused the one property they existed to move.) */
     setProperty(ref: string, value: ScalarValue): void;
-    /** 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. */
@@ -696,6 +694,8 @@ declare class Engine {
     /** How many times each node has been entered across every flow, by node id: the shared count. With a
      *  flow's own {@link Flow.getVisitCounts}, every visit count the run keeps, read without a save. */
     getVisitCounts(): Record<string, number>;
+    /** 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(): PropertyRow[];
     private splitShared;
     /** The shared `@patter` values alone, as `{ patter: {...} }`.

package/dist/index.js

@@ -43,6 +43,18 @@ function buildTagIndex(bundle) {
 // src/engine.ts
 import { SAVE_VERSION } from "@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");
@@ -171,7 +183,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,
@@ -430,18 +442,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
@@ -560,7 +572,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) {
@@ -580,7 +592,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). */
@@ -717,8 +729,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. */
@@ -750,6 +760,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,
@@ -1737,7 +1749,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":
@@ -1804,7 +1816,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 {