@storylet-studio/runtime 0.3.0 → 0.4.1

package/dist/index.cjs

@@ -633,6 +633,7 @@ var loadPartition = (p, values) => {
 var Engine = class {
   internals;
   seed;
+  onReplacedFlow;
   flowsById = /* @__PURE__ */ new Map();
   engineTraceHandlers = /* @__PURE__ */ new Set();
   /** The host's @world binding, if the engine was built with one: it
@@ -641,6 +642,7 @@ var Engine = class {
   hostWorld;
   constructor(bundle, opts = {}) {
     this.seed = opts.seed ?? 0;
+    this.onReplacedFlow = opts.onReplacedFlow;
     if (opts.world !== void 0) this.hostWorld = opts.world;
     const internals = {
       bundle,
@@ -661,6 +663,7 @@ var Engine = class {
       flowDecls: { story: [], box: /* @__PURE__ */ new Map(), deck: /* @__PURE__ */ new Map(), hand: /* @__PURE__ */ new Map(), value: /* @__PURE__ */ new Map() },
       shared: void 0,
       worldResolver: void 0,
+      worldReadOnly: /* @__PURE__ */ new Set(),
       emitEngine: (flow, event, turn) => {
         if (this.internals.logCap !== void 0) {
           this.engineLog.push({ ...event, flow, seq: this.engineSeq++, ...turn !== void 0 ? { turn } : {} });
@@ -718,6 +721,7 @@ var Engine = class {
   initShared(hostWorld) {
     const internals = this.internals;
     internals.shared = buildPartition(internals, sharedHalf);
+    internals.worldReadOnly = new Set(internals.bundle.world.properties.filter((d) => d.writable === false).map((d) => d.name));
     if (hostWorld !== void 0) {
       internals.worldResolver = hostWorld;
     } else {
@@ -761,7 +765,12 @@ var Engine = class {
    *  state; shared state is untouched. There is no default flow: "main" is
    *  a caller convention, not an engine rule. */
   openFlow(id, opts = {}) {
-    this.flowsById.get(id)?.markClosed();
+    const existing = this.flowsById.get(id);
+    if (existing) {
+      const dealt = existing.heldCardIds().length;
+      if (dealt > 0) this.onReplacedFlow?.(id, dealt);
+      existing.markClosed();
+    }
     const flow = new Flow(this, this.internals, id, opts.seed ?? this.seed);
     this.flowsById.set(id, flow);
     return flow;
@@ -1727,6 +1736,7 @@ var Flow = class {
       case "world": {
         const resolver = this.internals.worldResolver;
         if (!resolver.set) throw new Error(`@world.${name} cannot be written: the host bound @world read-only`);
+        if (this.internals.worldReadOnly.has(name)) throw new Error(`'@world.${name}' is read-only (writable: false)`);
         const prev = resolver.get(name);
         resolver.set(name, value);
         return { path: `world.${name}`, ...prev !== void 0 ? { prev } : {} };