@patterkit/runtime 0.12.0 → 0.13.0

package/dist/index.d.cts

@@ -525,7 +525,13 @@ declare class Engine {
     reset(): void;
     /** Read a shared (`@patter` / foreign) property by ref. `@scene` refs are rejected (flow-level). */
     getProperty(ref: string): ScalarValue | undefined;
-    /** Write a shared (`@patter` / foreign) property by ref. `@scene` refs are rejected (flow-level). */
+    /** Write a shared (`@patter` / foreign) property by ref. `@scene` refs are rejected (flow-level).
+     *
+     *  This is the GAME's surface, so it writes with host authority: a host-scope declaration's
+     *  `writable: false` is the story's promise not to write the value, never a lock on the game that
+     *  owns it. The story's own writes come through `Flow.runEffects`, which never claims it. (Ruled
+     *  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. */
@@ -668,8 +674,13 @@ declare class Flow {
     isEnded(): boolean;
     /** Read a property by ref - `@patter` / `@scene` (each routed by its `shared` flag) or foreign. */
     getProperty(ref: string): ScalarValue | undefined;
-    /** Write a property by ref (routed by scope, then by the property's `shared` flag). */
+    /** Write a property by ref (routed by scope, then by the property's `shared` flag). The GAME's
+     *  surface: it writes with host authority, so a `writable: false` host declaration does not refuse
+     *  it (see `Engine.setProperty`). The story's writes go through `writeProperty` instead. */
     setProperty(ref: string, value: ScalarValue): void;
+    /** The write itself. `host` says WHO is writing, which is the only thing `writable: false` cares
+     *  about: the story is refused, the game is not. */
+    private writeProperty;
     /** @internal Snapshot this flow's cursor + per-flow scopes (not-shared `@patter`/`@scene`) + PRNG. */
     snapshot(): FlowSnapshot;
     /** @internal Restore this flow from a snapshot. */

package/dist/index.d.ts

@@ -525,7 +525,13 @@ declare class Engine {
     reset(): void;
     /** Read a shared (`@patter` / foreign) property by ref. `@scene` refs are rejected (flow-level). */
     getProperty(ref: string): ScalarValue | undefined;
-    /** Write a shared (`@patter` / foreign) property by ref. `@scene` refs are rejected (flow-level). */
+    /** Write a shared (`@patter` / foreign) property by ref. `@scene` refs are rejected (flow-level).
+     *
+     *  This is the GAME's surface, so it writes with host authority: a host-scope declaration's
+     *  `writable: false` is the story's promise not to write the value, never a lock on the game that
+     *  owns it. The story's own writes come through `Flow.runEffects`, which never claims it. (Ruled
+     *  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. */
@@ -668,8 +674,13 @@ declare class Flow {
     isEnded(): boolean;
     /** Read a property by ref - `@patter` / `@scene` (each routed by its `shared` flag) or foreign. */
     getProperty(ref: string): ScalarValue | undefined;
-    /** Write a property by ref (routed by scope, then by the property's `shared` flag). */
+    /** Write a property by ref (routed by scope, then by the property's `shared` flag). The GAME's
+     *  surface: it writes with host authority, so a `writable: false` host declaration does not refuse
+     *  it (see `Engine.setProperty`). The story's writes go through `writeProperty` instead. */
     setProperty(ref: string, value: ScalarValue): void;
+    /** The write itself. `host` says WHO is writing, which is the only thing `writable: false` cares
+     *  about: the story is refused, the game is not. */
+    private writeProperty;
     /** @internal Snapshot this flow's cursor + per-flow scopes (not-shared `@patter`/`@scene`) + PRNG. */
     snapshot(): FlowSnapshot;
     /** @internal Restore this flow from a snapshot. */

package/dist/index.js

@@ -504,10 +504,16 @@ var Engine = class _Engine {
     const { scope, name } = this.splitShared(ref);
     return this.host.shared.get(scope, name);
   }
-  /** Write a shared (`@patter` / foreign) property by ref. `@scene` refs are rejected (flow-level). */
+  /** Write a shared (`@patter` / foreign) property by ref. `@scene` refs are rejected (flow-level).
+   *
+   *  This is the GAME's surface, so it writes with host authority: a host-scope declaration's
+   *  `writable: false` is the story's promise not to write the value, never a lock on the game that
+   *  owns it. The story's own writes come through `Flow.runEffects`, which never claims it. (Ruled
+   *  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, value) {
     const { scope, name } = this.splitShared(ref);
-    this.host.shared.set(scope, name, value);
+    this.host.shared.set(scope, name, value, { 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. */
@@ -974,8 +980,15 @@ var Flow = class {
     if (scope === "scene") return this.sceneResolver.get(name);
     return this.host.shared.get(scope, name);
   }
-  /** Write a property by ref (routed by scope, then by the property's `shared` flag). */
+  /** Write a property by ref (routed by scope, then by the property's `shared` flag). The GAME's
+   *  surface: it writes with host authority, so a `writable: false` host declaration does not refuse
+   *  it (see `Engine.setProperty`). The story's writes go through `writeProperty` instead. */
   setProperty(ref, value) {
+    this.writeProperty(ref, value, true);
+  }
+  /** The write itself. `host` says WHO is writing, which is the only thing `writable: false` cares
+   *  about: the story is refused, the game is not. */
+  writeProperty(ref, value, host) {
     const { scope, name } = this.splitRef(ref);
     if (scope === "patter") {
       this.patterResolver.set(name, value);
@@ -983,7 +996,7 @@ var Flow = class {
       if (this.currentSceneId === null) throw new Error(`'${ref}': the flow has not entered a scene yet`);
       this.sceneResolver.set(name, value);
     } else {
-      this.host.shared.set(scope, name, value);
+      this.host.shared.set(scope, name, value, host ? { host: true } : void 0);
     }
   }
   // -- Save / restore (engine-driven) --------------------------------------
@@ -1327,7 +1340,7 @@ var Flow = class {
     for (const e of effects ?? []) {
       const value = this.evalExpr(e.value);
       const prev = this.host.logEnabled ? this.getProperty(e.target) : void 0;
-      this.setProperty(e.target, value);
+      this.writeProperty(e.target, value, false);
       this.emit({ type: "write", target: e.target, value, ...prev !== void 0 ? { prev } : {} });
     }
   }