@storylet-studio/play-helpers 0.6.0 → 0.8.0

package/dist/index.cjs

@@ -136,6 +136,13 @@ var PropertyBag = class _PropertyBag {
   get(name) {
     return this.values[this.norm(name)];
   }
+  /** A name as this bag keys it: its normalisation policy applied. The registry
+   *  uses it to key quality ladders and the validation schema the bag's own way,
+   *  so a case-significant (identity) bag is not quietly folded to lower case
+   *  one layer up. */
+  normalise(name) {
+    return this.norm(name);
+  }
   /** Write a property. Engine writes (the default) notify subscribers;
    *  pass `silent: true` for a host write, which reaches only the audit
    *  hook. Throws on a read-only property unless the caller says it is the
@@ -277,7 +284,8 @@ function createStateLogger2(engine, flow, opts = {}) {
 }
 
 // ../model/src/index.ts
-var SAVE_SCHEMA = "storylets/save@1";
+var SAVE_SCHEMA = "storylets/save@2";
+var SAVE_SCHEMA_V1 = "storylets/save@1";
 var SAVEFILE_SCHEMA = "storylets/savefile@1";
 
 // src/save.ts
@@ -292,7 +300,7 @@ function saveState(engine, world) {
   };
 }
 function loadState(engine, file) {
-  if (!file || typeof file !== "object" || file.schema !== SAVEFILE_SCHEMA || file.engine?.schema !== SAVE_SCHEMA) {
+  if (!file || typeof file !== "object" || file.schema !== SAVEFILE_SCHEMA || file.engine?.schema !== SAVE_SCHEMA && file.engine?.schema !== SAVE_SCHEMA_V1) {
     throw new Error(`not a storylets save (expected schema "${SAVEFILE_SCHEMA}")`);
   }
   engine.loadGame(file.engine);
@@ -376,8 +384,9 @@ function formatLogBody(e, flow) {
     }
     case "evict":
       return `${stamp}evict ${e.card} from ${e.hand} (${e.reason})`;
+    // A card played with none ("") has no outcome to name.
     case "play":
-      return `${stamp}play ${e.card} -> ${e.outcome}`;
+      return `${stamp}play ${e.card}${e.outcome === "" ? "" : ` -> ${e.outcome}`}`;
     case "write":
       return `${stamp}write ${e.path}: ${showVal(e.prev)} -> ${showVal(e.value)}`;
     case "turns":
@@ -996,8 +1005,7 @@ function applyLiveBundle(engine, bundleJson, opts = {}) {
     return { ok: false, error: "pushed bundle is not valid JSON" };
   }
   try {
-    const next = new import_runtime2.Engine(bundle, opts);
-    next.loadGame(engine.saveGame());
+    const { engine: next } = engine.hotSwap(bundle, opts);
     return { ok: true, engine: next, bundle };
   } catch (e) {
     return { ok: false, error: e instanceof Error ? e.message : String(e) };