@sharpee/world-model 3.1.0 → 3.5.0

package/world/ScoreLedger.d.ts

@@ -2,10 +2,11 @@
  * ScoreLedger — score tracking subsystem for WorldModel.
  *
  * Public interface: award, revoke, has, getTotal, getEntries, setMax, getMax,
+ * setRanks, getRanks, getRank, setScoringEnabled, isScoringEnabled,
  * toJSON, fromJSON, clear.
  *
- * Owner context: packages/world-model (ADR-129). Extracted from WorldModel
- * to isolate scoring concerns and simplify serialization.
+ * Owner context: packages/world-model (ADR-129, ADR-260). Extracted from
+ * WorldModel to isolate scoring concerns and simplify serialization.
  */
 /**
  * A single score entry in the ledger.
@@ -15,8 +16,26 @@ export interface ScoreEntry {
     points: number;
     description: string;
 }
+/**
+ * A rung on the rank ladder (ADR-260 D2).
+ *
+ * `threshold` is **absolute points, never a percentage of max**: a change to
+ * maxScore must never move a rank boundary. Dungeo raises its ceiling from 616
+ * to 650 mid-game when the thief dies; under percentage thresholds that call
+ * would silently demote a player who earned nothing and lost nothing.
+ */
+export interface RankDefinition {
+    id: string;
+    name: string;
+    threshold: number;
+}
 /**
  * Serialized shape of the score ledger for persistence.
+ *
+ * Ranks are deliberately absent: they are configuration installed by the
+ * story's scoring registration at load, not gameplay state (ADR-260 D2).
+ * Keeping this shape fixed also means saves written before ADR-260 load
+ * unchanged.
  */
 export interface ScoreLedgerData {
     scoreLedger: ScoreEntry[];
@@ -29,6 +48,8 @@ export interface ScoreLedgerData {
 export declare class ScoreLedger {
     private ledger;
     private maxScore;
+    private ranks;
+    private scoringEnabled;
     /**
      * Award points for an achievement. Returns false if already awarded.
      *
@@ -76,6 +97,53 @@ export declare class ScoreLedger {
      * @returns Maximum score value
      */
     getMax(): number;
+    /**
+     * Install the rank ladder (ADR-260 D2).
+     *
+     * Sorted ascending on receipt so callers need not sort. An empty array is
+     * legal and means "scoring on, no ladder". Two rungs sharing a threshold is
+     * a caller error: silently keeping one would make the resolved rank depend
+     * on array order.
+     *
+     * @param ranks - The ladder, in any order
+     * @throws if two rungs share a threshold
+     */
+    setRanks(ranks: RankDefinition[]): void;
+    /**
+     * Get the installed rank ladder, ascending by threshold.
+     *
+     * @returns The ladder (defensive copy)
+     */
+    getRanks(): RankDefinition[];
+    /**
+     * Get the current rank — the highest rung whose threshold the total score
+     * has reached.
+     *
+     * **Derived on every call, never stored** (ADR-260 D2): a stored rank can
+     * drift from the stored score across a revoke, a maxScore change, or a
+     * save/restore. The ladder is a banded scalar over the score, so the lookup
+     * is `bandOf` (ADR-262 D1) — the same primitive every continuous meter uses.
+     *
+     * @returns The current rank, or undefined when no ladder is installed or
+     *          the score is below every rung
+     */
+    getRank(): RankDefinition | undefined;
+    /**
+     * Mark scoring as installed. Called by a scoring registration
+     * (`registerScoring`, ADR-260 D5), not by gameplay.
+     *
+     * @param enabled - Whether scoring is installed
+     */
+    setScoringEnabled(enabled: boolean): void;
+    /**
+     * Whether a scoring registration has installed itself.
+     *
+     * Default false. Enablement is the registration, not the ladder — an empty
+     * ladder still counts as enabled.
+     *
+     * @returns true once a scoring registration has run
+     */
+    isScoringEnabled(): boolean;
     /**
      * Serialize the ledger for persistence.
      *
@@ -89,7 +157,11 @@ export declare class ScoreLedger {
      */
     fromJSON(data: Partial<ScoreLedgerData>): void;
     /**
-     * Reset the ledger to empty state.
+     * Reset gameplay state to empty.
+     *
+     * The rank ladder and the enabled flag survive (ADR-260 D2): both are story
+     * configuration installed at load, and clearing gameplay state must not
+     * uninstall them.
      */
     clear(): void;
 }

package/world/ScoreLedger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ScoreLedger.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/world/ScoreLedger.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAAa;IAE7B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAQ/D;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO3B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAQlB;;;;OAIG;IACH,UAAU,IAAI,UAAU,EAAE;IAI1B;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAIhB;;;;OAIG;IACH,MAAM,IAAI,eAAe;IAOzB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAS9C;;OAEG;IACH,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"ScoreLedger.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/world/ScoreLedger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,cAAc,CAAkB;IAExC;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAQ/D;;;;;OAKG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAO3B;;;;;OAKG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIxB;;;;OAIG;IACH,QAAQ,IAAI,MAAM;IAQlB;;;;OAIG;IACH,UAAU,IAAI,UAAU,EAAE;IAI1B;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;;;OAIG;IACH,MAAM,IAAI,MAAM;IAIhB;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,IAAI;IAcvC;;;;OAIG;IACH,QAAQ,IAAI,cAAc,EAAE;IAI5B;;;;;;;;;;;OAWG;IACH,OAAO,IAAI,cAAc,GAAG,SAAS;IAKrC;;;;;OAKG;IACH,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIzC;;;;;;;OAOG;IACH,gBAAgB,IAAI,OAAO;IAI3B;;;;OAIG;IACH,MAAM,IAAI,eAAe;IAOzB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAS9C;;;;;;OAMG;IACH,KAAK,IAAI,IAAI;CAId"}

package/world/ScoreLedger.js

@@ -3,13 +3,15 @@
  * ScoreLedger — score tracking subsystem for WorldModel.
  *
  * Public interface: award, revoke, has, getTotal, getEntries, setMax, getMax,
+ * setRanks, getRanks, getRank, setScoringEnabled, isScoringEnabled,
  * toJSON, fromJSON, clear.
  *
- * Owner context: packages/world-model (ADR-129). Extracted from WorldModel
- * to isolate scoring concerns and simplify serialization.
+ * Owner context: packages/world-model (ADR-129, ADR-260). Extracted from
+ * WorldModel to isolate scoring concerns and simplify serialization.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ScoreLedger = void 0;
+const band_js_1 = require("./band.js");
 /**
  * Tracks score entries awarded during gameplay.
  * Each entry has a unique ID to prevent double-awards and support revocation.
@@ -17,6 +19,8 @@ exports.ScoreLedger = void 0;
 class ScoreLedger {
     ledger = [];
     maxScore = 0;
+    ranks = [];
+    scoringEnabled = false;
     /**
      * Award points for an achievement. Returns false if already awarded.
      *
@@ -90,6 +94,72 @@ class ScoreLedger {
     getMax() {
         return this.maxScore;
     }
+    /**
+     * Install the rank ladder (ADR-260 D2).
+     *
+     * Sorted ascending on receipt so callers need not sort. An empty array is
+     * legal and means "scoring on, no ladder". Two rungs sharing a threshold is
+     * a caller error: silently keeping one would make the resolved rank depend
+     * on array order.
+     *
+     * @param ranks - The ladder, in any order
+     * @throws if two rungs share a threshold
+     */
+    setRanks(ranks) {
+        const seen = new Set();
+        for (const rank of ranks) {
+            if (seen.has(rank.threshold)) {
+                throw new Error(`Duplicate rank threshold ${rank.threshold} (rank "${rank.id}"): ` +
+                    `two rungs sharing a threshold make the resolved rank depend on array order`);
+            }
+            seen.add(rank.threshold);
+        }
+        this.ranks = [...ranks].sort((a, b) => a.threshold - b.threshold);
+    }
+    /**
+     * Get the installed rank ladder, ascending by threshold.
+     *
+     * @returns The ladder (defensive copy)
+     */
+    getRanks() {
+        return [...this.ranks];
+    }
+    /**
+     * Get the current rank — the highest rung whose threshold the total score
+     * has reached.
+     *
+     * **Derived on every call, never stored** (ADR-260 D2): a stored rank can
+     * drift from the stored score across a revoke, a maxScore change, or a
+     * save/restore. The ladder is a banded scalar over the score, so the lookup
+     * is `bandOf` (ADR-262 D1) — the same primitive every continuous meter uses.
+     *
+     * @returns The current rank, or undefined when no ladder is installed or
+     *          the score is below every rung
+     */
+    getRank() {
+        const index = (0, band_js_1.bandOf)(this.getTotal(), this.ranks.map(r => r.threshold));
+        return index < 0 ? undefined : this.ranks[index];
+    }
+    /**
+     * Mark scoring as installed. Called by a scoring registration
+     * (`registerScoring`, ADR-260 D5), not by gameplay.
+     *
+     * @param enabled - Whether scoring is installed
+     */
+    setScoringEnabled(enabled) {
+        this.scoringEnabled = enabled;
+    }
+    /**
+     * Whether a scoring registration has installed itself.
+     *
+     * Default false. Enablement is the registration, not the ladder — an empty
+     * ladder still counts as enabled.
+     *
+     * @returns true once a scoring registration has run
+     */
+    isScoringEnabled() {
+        return this.scoringEnabled;
+    }
     /**
      * Serialize the ledger for persistence.
      *
@@ -115,7 +185,11 @@ class ScoreLedger {
         }
     }
     /**
-     * Reset the ledger to empty state.
+     * Reset gameplay state to empty.
+     *
+     * The rank ladder and the enabled flag survive (ADR-260 D2): both are story
+     * configuration installed at load, and clearing gameplay state must not
+     * uninstall them.
      */
     clear() {
         this.ledger = [];

package/world/ScoreLedger.js.map

@@ -1 +1 @@
-{"version":3,"file":"ScoreLedger.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/world/ScoreLedger.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAmBH;;;GAGG;AACH,MAAa,WAAW;IACd,MAAM,GAAiB,EAAE,CAAC;IAC1B,QAAQ,GAAW,CAAC,CAAC;IAE7B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAU,EAAE,MAAc,EAAE,WAAmB;QACnD,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACvC,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,EAAU;QACf,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,QAAQ;QACN,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;QACxB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;OAIG;IACH,UAAU;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,GAAW;QAChB,IAAI,CAAC,QAAQ,GAAG,GAAG,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,MAAM;QACJ,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,MAAM;YACxB,aAAa,EAAE,IAAI,CAAC,QAAQ;SAC7B,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,QAAQ,CAAC,IAA8B;QACrC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;QACjC,CAAC;QACD,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC;QACrC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;IACpB,CAAC;CACF;AApHD,kCAoHC"}
+{"version":3,"file":"ScoreLedger.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/world/ScoreLedger.ts"],"names":[],"mappings":"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"}

package/world/SharedDataStore.d.ts

@@ -1,5 +1,5 @@
-import { IFEntity } from '../entities/if-entity';
-import { SpatialIndex } from './SpatialIndex';
+import { IFEntity } from '../entities/if-entity.js';
+import { SpatialIndex } from './SpatialIndex.js';
 /**
  * Wrapper class that holds references to shared state between WorldModel and AuthorModel.
  * This ensures that changes made by one model are visible to the other.

package/world/SharedDataStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SharedDataStore.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/world/SharedDataStore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,qBAAa,eAAe;IAC1B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;IAa9B,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAErC;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAUd"}
+{"version":3,"file":"SharedDataStore.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/world/SharedDataStore.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;;GAGG;AACH,qBAAa,eAAe;IAC1B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,YAAY,EAAE,YAAY,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrD,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;IAa9B,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IAED,IAAI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAErC;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAUd"}

package/world/SharedDataStore.js

@@ -2,7 +2,7 @@
 // SharedDataStore.ts - Shared state wrapper for WorldModel and AuthorModel
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SharedDataStore = void 0;
-const SpatialIndex_1 = require("./SpatialIndex");
+const SpatialIndex_js_1 = require("./SpatialIndex.js");
 /**
  * Wrapper class that holds references to shared state between WorldModel and AuthorModel.
  * This ensures that changes made by one model are visible to the other.
@@ -18,7 +18,7 @@ class SharedDataStore {
     idToName;
     constructor() {
         this.entities = new Map();
-        this.spatialIndex = new SpatialIndex_1.SpatialIndex();
+        this.spatialIndex = new SpatialIndex_js_1.SpatialIndex();
         this.state = {};
         this._playerId = undefined;
         this.relationships = new Map();

package/world/SharedDataStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"SharedDataStore.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/world/SharedDataStore.ts"],"names":[],"mappings":";AAAA,2EAA2E;;;AAG3E,iDAA8C;AAE9C;;;GAGG;AACH,MAAa,eAAe;IAC1B,QAAQ,CAAwB;IAChC,YAAY,CAAe;IAC3B,KAAK,CAAsB;IACnB,SAAS,CAAU;IAC3B,aAAa,CAAwC;IACrD,UAAU,CAAsB;IAChC,QAAQ,CAAsB;IAC9B,QAAQ,CAAsB;IAE9B;QACE,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,IAAI,2BAAY,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ,CAAC,KAAyB;QACpC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF;AA1CD,0CA0CC"}
+{"version":3,"file":"SharedDataStore.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/world/SharedDataStore.ts"],"names":[],"mappings":";AAAA,2EAA2E;;;AAG3E,uDAAiD;AAEjD;;;GAGG;AACH,MAAa,eAAe;IAC1B,QAAQ,CAAwB;IAChC,YAAY,CAAe;IAC3B,KAAK,CAAsB;IACnB,SAAS,CAAU;IAC3B,aAAa,CAAwC;IACrD,UAAU,CAAsB;IAChC,QAAQ,CAAsB;IAC9B,QAAQ,CAAsB;IAE9B;QACE,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,YAAY,GAAG,IAAI,8BAAY,EAAE,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,IAAI,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,IAAI,GAAG,EAAE,CAAC;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,EAAE,CAAC;IAC5B,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,IAAI,QAAQ,CAAC,KAAyB;QACpC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;CACF;AA1CD,0CA0CC"}

package/world/VisibilityBehavior.d.ts

@@ -1,13 +1,27 @@
-import { Behavior } from '../behaviors/behavior';
-import { IFEntity } from '../entities/if-entity';
-import { WorldModel } from './WorldModel';
+import { Behavior } from '../behaviors/behavior.js';
+import { IFEntity } from '../entities/if-entity.js';
+import { WorldModel } from './WorldModel.js';
 /**
  * Standard capability ID for visibility control.
  * Entities can claim this capability to control their own visibility.
  */
 export declare const VISIBILITY_CAPABILITY = "if.scope.visible";
+/**
+ * ADR-240 evaluator key for a room's derived darkness (`dark.<roomId>`).
+ * Owned by this read point; registrars (e.g. the story-loader's
+ * `dark while` conditions) build the key with this function, never by
+ * hand — the string is constructed in exactly two places, both pinned.
+ */
+export declare function darkKey(roomId: string): string;
 export declare class VisibilityBehavior extends Behavior {
     static requiredTraits: never[];
+    /**
+     * The live answer to "does this room require light?" (ADR-240): a
+     * registered `dark.<roomId>` evaluator is authoritative (point-of-use
+     * truth, never stale); with nothing registered, the stamped trait
+     * fact applies unchanged (static `dark`, hand-written TS stories).
+     */
+    private static roomRequiresLight;
     /**
      * Determines if a room is effectively dark (no usable light sources).
      * This is the single source of truth for darkness checking.
@@ -31,6 +45,29 @@ export declare class VisibilityBehavior extends Behavior {
      * 3. Default to lit (e.g., glowing gems, phosphorescent moss)
      */
     private static isLightActive;
+    /**
+     * Whether an entity is still concealed (hidden until SEARCH or a game event
+     * reveals it). This is the SINGLE shared definition of item concealment for
+     * visibility: scope resolution, LOOK, and EXAMINE must all consult it (here
+     * or via canSee/getVisible/getVisibleContents), never re-derive it.
+     *
+     * @param entity - The entity to check (safe on entities without IdentityTrait)
+     * @returns true if the entity carries IdentityTrait with concealed === true
+     */
+    static isConcealed(entity: IFEntity): boolean;
+    /**
+     * The single per-entity listing filter shared by every visibility path
+     * (room contents, container/supporter contents): excludes still-concealed
+     * entities, scenery marked invisible, and entities whose visibility
+     * capability vetoes being seen.
+     *
+     * @param entity - The candidate entity
+     * @param world - The world model
+     * @param observerId - The observer (or container proxy) id passed to a
+     *                     visibility-capability behavior's validate
+     * @returns true if the entity may appear in a visible-entity listing
+     */
+    private static isListable;
     /**
      * Determines if an observer can see a target entity
      */
@@ -39,6 +76,25 @@ export declare class VisibilityBehavior extends Behavior {
      * Gets all entities visible to an observer
      */
     static getVisible(observer: IFEntity, world: WorldModel): IFEntity[];
+    /**
+     * The direct contents of a container/supporter/actor that could appear in a
+     * visible listing: applies the same per-entity filter as getVisible
+     * (concealed, invisible scenery, visibility-capability veto) to
+     * `getContents(id)` (worn items included by default, ADR-247).
+     *
+     * Does NOT check whether the container's inside is exposed (closed opaque
+     * container) — callers listing contents have already established that, and
+     * addVisibleContents keeps that gate itself.
+     *
+     * This is the shared read for LOOK's and EXAMINE's contents listings — a
+     * still-concealed item stays out of both until SEARCH reveals it, by the
+     * same definition scope resolution uses.
+     *
+     * @param container - The container/supporter/actor whose contents to list
+     * @param world - The world model
+     * @returns the listable direct contents
+     */
+    static getVisibleContents(container: IFEntity, world: WorldModel): IFEntity[];
     /**
      * Recursively adds visible contents of a container/supporter/actor
      */

package/world/VisibilityBehavior.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VisibilityBehavior.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/world/VisibilityBehavior.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAY1C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,MAAM,CAAC,cAAc,UAAM;IAE3B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IAQzD;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAiB5B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IAkE/E;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,QAAQ,EAAE;IAsGpE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA2DjC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAmB7B;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA0CrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAI3B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IAwB9D;;;;;;;;;OASG;IACH,MAAM,CAAC,sBAAsB,CAC3B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,UAAU,GAChB;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,kBAAkB,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAE;CAmD/D"}
+{"version":3,"file":"VisibilityBehavior.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/world-model/src/world/VisibilityBehavior.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAa7C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9C;AAED,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,MAAM,CAAC,cAAc,UAAM;IAE3B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAOhC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IAOzD;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAiB5B;;;;;;;;OAQG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAI7C;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IA2BzB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IAoF/E;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,QAAQ,EAAE;IA8FpE;;;;;;;;;;;;;;;;;OAiBG;IACH,MAAM,CAAC,kBAAkB,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,QAAQ,EAAE;IAQ7E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAuCjC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAmB7B;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IA0CrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAI3B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IA6B9D;;;;;;;;;OASG;IACH,MAAM,CAAC,sBAAsB,CAC3B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,UAAU,GAChB;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,kBAAkB,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAE;CAmD/D"}