@storylet-studio/play-helpers 0.4.1 → 0.5.0

package/dist/index.cjs

@@ -138,10 +138,14 @@ var PropertyBag = class _PropertyBag {
   }
   /** 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. Returns the change. */
+   *  hook. Throws on a read-only property unless the caller says it is the
+   *  HOST (`host: true`), for whom `writable: false` was never a rule - it is
+   *  the story's promise, not the game's. `silent` and `host` are separate on
+   *  purpose: one is about who hears the write, the other about who may make
+   *  it. Returns the change. */
   set(name, value, opts) {
     const n = this.norm(name);
-    if (this.decls.get(n)?.writable === false) throw new Error(`'${name}' is read-only`);
+    if (!opts?.host && this.decls.get(n)?.writable === false) throw new Error(`'${name}' is read-only`);
     const change = {
       name: n,
       prev: this.values[n],
@@ -243,19 +247,13 @@ function defaultFor(d) {
 
 // src/logger.ts
 function snapshotState(engine, flow) {
-  const env = engine.saveGame();
-  const flowSave = env.flows[flow.id];
   const out = {};
-  const bag = (prefix, values) => {
-    for (const [name, value] of Object.entries(values ?? {})) out[`${prefix}.${name}`] = value;
-  };
-  bag("story", env.shared.props.story);
-  bag("story", flowSave?.props.story);
-  for (const kind of ["box", "deck", "hand", "value"]) {
-    for (const [id, values] of Object.entries(env.shared.props[kind])) bag(`${kind}.${id}`, values);
-    for (const [id, values] of Object.entries(flowSave?.props[kind] ?? {})) bag(`${kind}.${id}`, values);
+  for (const { bag } of [...engine.listBags(), ...flow.listBags()]) {
+    for (const row of bag.rows()) {
+      if (row.value !== void 0) out[row.path] = row.value;
+    }
   }
-  Object.assign(out, extraState(env.flows[flow.id]));
+  Object.assign(out, extraState(engine.saveGame().flows[flow.id]));
   return out;
 }
 function extraState(saved) {
@@ -709,7 +707,8 @@ var import_runtime = require("@storylet-studio/runtime");
 var showVal2 = (v) => v === void 0 ? "<unset>" : JSON.stringify(v);
 function formatPropertySummary(p) {
   const options = p.values !== void 0 && p.values.length > 0 ? ` [${p.values.join(", ")}]` : "";
-  return `${p.name}: ${p.type} = ${showVal2(p.default)}${options}`;
+  const durable = p.durable === true ? " (durable)" : "";
+  return `${p.name}: ${p.type} = ${showVal2(p.default)}${options}${durable}`;
 }
 function formatScopeLabel(scope) {
   if (scope.scope === "world" || scope.scope === "story") return scope.scope;
@@ -765,7 +764,8 @@ function createBundleInspector(bundle, opts = {}) {
   }
   for (const hand of description.hands) {
     const template = hand.template !== void 0 ? `, template ${hand.template}` : "";
-    line(handsBody, `${hand.gameId}: box ${hand.box}, slots ${hand.slots}${template}` + (hand.title !== void 0 ? ` - ${hand.title}` : ""));
+    const moves = hand.movable === void 0 ? "" : `, moves ${hand.movable.map((m) => `${m.group} from ${m.from}`).join(" and ")}`;
+    line(handsBody, `${hand.gameId}: box ${hand.box}, slots ${hand.slots}${template}${moves}` + (hand.title !== void 0 ? ` - ${hand.title}` : ""));
   }
   const tagsBody = fold(el, "Tags by box (peek criteria)", open);
   tagsBody.className = "sl-tags";
@@ -794,7 +794,7 @@ function createBundleInspector(bundle, opts = {}) {
     mapsBody.className = "sl-maps";
     line(mapsBody, "Geometry the build was asked to carry. The engine ignores it.", "sl-line sl-note");
     for (const map of description.maps) {
-      line(mapsBody, `${map.box} - ${map.group}: zones ${map.zones}, pictures ${map.backgrounds}`);
+      line(mapsBody, `${map.box} - ${map.group}: zones ${map.zones}, pictures ${map.backgrounds}, sites ${map.sites}`);
     }
   }
   const countsBody = fold(el, "Counts", open);
@@ -802,7 +802,7 @@ function createBundleInspector(bundle, opts = {}) {
   line(countsBody, `boxes ${totals.boxes} - decks ${totals.decks} - cards ${totals.cards}`);
   line(countsBody, `hands ${totals.hands} - templates ${totals.templates} - tag groups ${totals.tagGroups}`);
   for (const box of description.boxes) {
-    line(countsBody, `${box.gameId}: decks ${box.counts.decks}, cards ${box.counts.cards}, hands ${box.counts.hands}, templates ${box.counts.templates}, tag groups ${box.counts.tagGroups}, ranking.specificity ${box.ranking.specificity}`);
+    line(countsBody, `${box.gameId}: decks ${box.counts.decks}, cards ${box.counts.cards}, hands ${box.counts.hands}, templates ${box.counts.templates}, tag groups ${box.counts.tagGroups}, ranking.specificity ${box.ranking.specificity}` + (box.turn !== void 0 ? `, turn = ${box.turn.seconds}s` : "") + (box.durableCards !== void 0 ? `, durable cards ${box.durableCards}` : ""));
   }
   (opts.container ?? document.body).append(el);
   return {
@@ -1011,7 +1011,7 @@ function createWorldContainer(bundle) {
     resolver: {
       get: (n) => bag.get(n),
       set: (n, v) => {
-        bag.set(n, v);
+        bag.set(n, v, { host: true });
       }
     },
     bag,