@sharpee/story-loader 3.0.0

package/errors.d.ts

@@ -0,0 +1,20 @@
+/**
+ * errors.ts — story-loader load failure type.
+ *
+ * Purpose: the single error every load-time failure throws. Loading is
+ * atomic (ADR-210): the first LoadError aborts the load; there is no
+ * partial registration to clean up because the engine discards the world.
+ *
+ * Public interface: LoadError.
+ * Owner context: @sharpee/story-loader.
+ */
+import type { Span } from '@sharpee/chord';
+/** A story failed to load. Carries the `.story` span when one is known. */
+export declare class LoadError extends Error {
+    /** Source span in the `.story` file, when attributable. */
+    readonly span?: Span | undefined;
+    constructor(message: string, 
+    /** Source span in the `.story` file, when attributable. */
+    span?: Span | undefined);
+}
+//# sourceMappingURL=errors.d.ts.map

package/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee_v2/packages/story-loader/src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,2EAA2E;AAC3E,qBAAa,SAAU,SAAQ,KAAK;IAGhC,2DAA2D;IAC3D,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI;gBAFpB,OAAO,EAAE,MAAM;IACf,2DAA2D;IAClD,IAAI,CAAC,EAAE,IAAI,YAAA;CAKvB"}

package/errors.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LoadError = void 0;
+/** A story failed to load. Carries the `.story` span when one is known. */
+class LoadError extends Error {
+    span;
+    constructor(message, 
+    /** Source span in the `.story` file, when attributable. */
+    span) {
+        super(span ? `${message} (line ${span.line})` : message);
+        this.span = span;
+        this.name = 'LoadError';
+    }
+}
+exports.LoadError = LoadError;
+//# sourceMappingURL=errors.js.map

package/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../../repos/sharpee_v2/packages/story-loader/src/errors.ts"],"names":[],"mappings":";;;AAYA,2EAA2E;AAC3E,MAAa,SAAU,SAAQ,KAAK;IAIvB;IAHX,YACE,OAAe;IACf,2DAA2D;IAClD,IAAW;QAEpB,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,UAAU,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAFhD,SAAI,GAAJ,IAAI,CAAO;QAGpB,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AATD,8BASC"}

package/evaluator.d.ts

@@ -0,0 +1,102 @@
+/**
+ * evaluator.ts — the Chord expression evaluator (design.md §5.5, Phase A).
+ *
+ * Purpose: evaluate IR conditions and values against a live WorldModel —
+ * an AST walk, no eval(), no runtime TS. Covers the closed selector
+ * subset cloak.story exercises: possessive access (`the player's
+ * location`, `its state`), `is <state/trait>`, `is a`, `is in`,
+ * `has`/`holds`/`wears`, named conditions, and/or/not, and
+ * `one chance in <n>` through the seeded RNG.
+ *
+ * Public interface: Evaluator, EvalContext.
+ * Owner context: @sharpee/story-loader.
+ *
+ * Invariants:
+ * - Pure reads except the RNG draw (whose cursor persists in world state
+ *   under `chord.rng`, so chance streams survive save/restore — AC-5/AC-6).
+ * - Unknown constructs throw LoadError: the compiler gates should make
+ *   these unreachable; reaching one is a loader bug, not author error.
+ */
+import type { IRCondition, IRValue, StoryIR } from '@sharpee/chord';
+import { WorldModel } from '@sharpee/world-model';
+export interface EvalContext {
+    world: WorldModel;
+    /** IR entity id bound to `it` (the on-clause owner), when in scope. */
+    it?: string;
+    /**
+     * Bound context values (Phase B dispatch): grammar-slot/role name →
+     * WORLD entity id (`animal` → the pet target, `actor` → the actor).
+     */
+    slots?: Record<string, string>;
+    /**
+     * IR entity id bound to `the match` — the innermost enclosing `each`
+     * block's current entity (ratchet E3). Nested blocks re-spread the
+     * context, so the innermost binding naturally wins; `it` is untouched.
+     */
+    match?: string;
+}
+/** Resolves IR ids to world ids (implemented by ChordStory). */
+export interface EntityIdResolver {
+    entityId(irId: string): string | undefined;
+    irIdOf(worldId: string): string | undefined;
+    /** The player's world id once created (before the engine calls setPlayer). */
+    playerWorldId(): string | undefined;
+}
+export declare class Evaluator {
+    private readonly ids;
+    private readonly conditions;
+    private readonly rng;
+    /** trait name → its `entity`-typed data-field names (IR→world translation). */
+    private readonly entityFields;
+    /**
+     * IR entities in declaration order — the quantifier enumeration domain
+     * and E3's pinned "creation order" (the loader instantiates in this
+     * order; save/restore cannot reorder it, so iteration and the RNG draws
+     * inside `each` bodies stay deterministic — AC-5).
+     */
+    private readonly irEntities;
+    private readonly irEntityById;
+    constructor(ir: StoryIR, ids: EntityIdResolver, seed?: number);
+    evalCondition(cond: IRCondition, ctx: EvalContext): boolean;
+    private evalPredicate;
+    /**
+     * `<subject> is <bare-word>`: a declared state, a state adjective read
+     * live from world trait state (ratchet D1 — never stored), or the `dark`
+     * trait.
+     */
+    private symbolHolds;
+    /**
+     * State adjectives (ratchet D1): `open`/`closed`, `locked`/`unlocked`,
+     * `on`/`off`, `worn`, `lit` — pure reads of world trait state. Null when
+     * `symbol` is not a state adjective (or the trait is absent, so the
+     * adjective cannot hold either way).
+     */
+    private stateAdjectiveHolds;
+    evalValue(value: IRValue, ctx: EvalContext): unknown;
+    /** The named condition's body, or a loader-bug throw. */
+    private namedCondition;
+    /** True when some domain entity satisfies the open condition (short-circuit). */
+    private someMatch;
+    /**
+     * The entities satisfying a named open condition, as IR ids in
+     * declaration order — E3's pinned creation-order enumeration. Used by
+     * the runtime's `each` execution and its pre-mutation snapshot.
+     */
+    matchesOf(name: string, ctx: EvalContext): string[];
+    /** Evaluate a value that must be an entity (world id). */
+    entityValue(value: IRValue, ctx: EvalContext): string;
+    private readField;
+    /** Read a `define trait` data field off the entity's chord trait instances. */
+    private readChordTraitField;
+    private playerId;
+    private requireWorldId;
+    /** True when `thing` is located inside `container` at any depth. */
+    private isWithin;
+    /**
+     * `one chance in <n>`: seeded draw whose cursor persists in world state,
+     * so a fixed seed yields a byte-identical stream (AC-5) and restores
+     * resume the stream (AC-6).
+     */
+    private drawChance;
+}
+//# sourceMappingURL=evaluator.d.ts.map

package/evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee_v2/packages/story-loader/src/evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAY,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAQL,UAAU,EACX,MAAM,sBAAsB,CAAC;AAI9B,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,UAAU,CAAC;IAClB,uEAAuE;IACvE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3C,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5C,8EAA8E;IAC9E,aAAa,IAAI,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,qBAAa,SAAS;IAkBlB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAjBtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC,+EAA+E;IAC/E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkC;IAE/D;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA+B;gBAG1D,EAAE,EAAE,OAAO,EACM,GAAG,EAAE,gBAAgB,EACtC,IAAI,CAAC,EAAE,MAAM;IAgBf,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO;IAyC3D,OAAO,CAAC,aAAa;IA2ErB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAsBnB;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAqC3B,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO;IA0CpD,yDAAyD;IACzD,OAAO,CAAC,cAAc;IAMtB,iFAAiF;IACjF,OAAO,CAAC,SAAS;IAOjB;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,EAAE;IAOnD,0DAA0D;IAC1D,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM;IAQrD,OAAO,CAAC,SAAS;IA4BjB,+EAA+E;IAC/E,OAAO,CAAC,mBAAmB;IAoB3B,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,cAAc;IAMtB,oEAAoE;IACpE,OAAO,CAAC,QAAQ;IAShB;;;;OAIG;IACH,OAAO,CAAC,UAAU;CAQnB"}

package/evaluator.js

@@ -0,0 +1,384 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Evaluator = void 0;
+const core_1 = require("@sharpee/core");
+const world_model_1 = require("@sharpee/world-model");
+const errors_1 = require("./errors");
+const state_keys_1 = require("./state-keys");
+class Evaluator {
+    ids;
+    conditions = new Map();
+    rng;
+    /** trait name → its `entity`-typed data-field names (IR→world translation). */
+    entityFields = new Map();
+    /**
+     * IR entities in declaration order — the quantifier enumeration domain
+     * and E3's pinned "creation order" (the loader instantiates in this
+     * order; save/restore cannot reorder it, so iteration and the RNG draws
+     * inside `each` bodies stay deterministic — AC-5).
+     */
+    irEntities;
+    irEntityById = new Map();
+    constructor(ir, ids, seed) {
+        this.ids = ids;
+        for (const c of ir.conditions)
+            this.conditions.set(c.name, c.condition);
+        this.irEntities = ir.entities;
+        for (const e of ir.entities)
+            this.irEntityById.set(e.id, e);
+        for (const trait of ir.traits) {
+            this.entityFields.set(trait.name, new Set(trait.data.filter((f) => f.type === 'entity').map((f) => f.name)));
+        }
+        this.rng = (0, core_1.createSeededRandom)(seed);
+    }
+    // ------------------------------------------------------------ conditions
+    evalCondition(cond, ctx) {
+        switch (cond.kind) {
+            case 'and':
+                return cond.operands.every((o) => this.evalCondition(o, ctx));
+            case 'or':
+                return cond.operands.some((o) => this.evalCondition(o, ctx));
+            case 'not':
+                return !this.evalCondition(cond.operand, ctx);
+            case 'chance':
+                return this.drawChance(cond.n, ctx.world);
+            case 'condition': {
+                const named = this.conditions.get(cond.name);
+                if (!named)
+                    throw new errors_1.LoadError(`Unknown condition \`${cond.name}\` at evaluation time.`);
+                return this.evalCondition(named, ctx);
+            }
+            case 'story-state':
+                // The story object's phase (`while after-hours`, ratchet D2).
+                return ctx.world.getStateValue(state_keys_1.CHORD_STORY_STATE_KEY) === cond.state;
+            case 'any-of':
+                // E1 (ratchet 2026-07-12): true iff some entity satisfies the
+                // named open condition; false over the empty set. Short-circuits.
+                return this.someMatch(cond.condition, ctx);
+            case 'none-of':
+                // E2: the negated existential — true over the empty set.
+                return !this.someMatch(cond.condition, ctx);
+            case 'satisfies': {
+                // `<subject> must be any <name>` membership (David, 2026-07-12):
+                // the subject satisfies the open condition — its `it` bound to
+                // the subject. A subject outside the quantification domain (no
+                // story identity) is not one of the matches: false, not a throw.
+                const named = this.namedCondition(cond.condition);
+                const subjectId = this.entityValue(cond.subject, ctx);
+                const irId = this.ids.irIdOf(subjectId);
+                if (irId === undefined)
+                    return false;
+                return this.evalCondition(named, { ...ctx, it: irId });
+            }
+            case 'predicate':
+                return this.evalPredicate(cond, ctx);
+        }
+    }
+    evalPredicate(cond, ctx) {
+        const raw = (result) => (cond.negated ? !result : result);
+        switch (cond.pred) {
+            case 'is': {
+                const subject = this.evalValue(cond.subject, ctx);
+                if (cond.object.kind === 'symbol') {
+                    return raw(this.symbolHolds(subject, cond.object.name, ctx));
+                }
+                return raw(String(subject) === String(this.evalValue(cond.object, ctx)));
+            }
+            case 'is-a': {
+                // Classification (landed with the each package, P4): the subject's
+                // IR kind-noun compositions (`a marble`, `a room`). An entity
+                // outside the story's IR classifies as nothing.
+                const subjectId = this.entityValue(cond.subject, ctx);
+                const irId = this.ids.irIdOf(subjectId);
+                const irEntity = irId !== undefined ? this.irEntityById.get(irId) : undefined;
+                if (!irEntity)
+                    return raw(false);
+                const classifier = cond.object.kind === 'symbol' ? cond.object.name : String(this.evalValue(cond.object, ctx));
+                return raw(irEntity.kinds.some((k) => k.name === classifier));
+            }
+            case 'is-in': {
+                const subjectId = this.entityValue(cond.subject, ctx);
+                const placeId = this.entityValue(cond.object, ctx);
+                return raw(this.isWithin(ctx.world, subjectId, placeId));
+            }
+            case 'is-here': {
+                // Z4 deictic — Decision 10 presence semantics, mirroring the
+                // runtime's playerPresentAt: a room subject means the player is IN
+                // it; anything else shares the player's containing room; a
+                // no-location subject is never here (false, not an error).
+                const subjectId = this.entityValue(cond.subject, ctx);
+                const playerId = ctx.world.getPlayer()?.id;
+                if (!playerId)
+                    return raw(false);
+                if (subjectId === playerId)
+                    return raw(true);
+                const playerRoom = ctx.world.getContainingRoom(playerId)?.id ?? ctx.world.getLocation(playerId);
+                if (ctx.world.getEntity(subjectId)?.has(world_model_1.TraitType.ROOM))
+                    return raw(playerRoom === subjectId);
+                const subjectRoom = ctx.world.getContainingRoom(subjectId)?.id ?? ctx.world.getLocation(subjectId);
+                return raw(subjectRoom !== undefined && subjectRoom === playerRoom);
+            }
+            case 'has': {
+                const owner = this.entityValue(cond.subject, ctx);
+                const thing = this.entityValue(cond.object, ctx);
+                return this.isWithin(ctx.world, thing, owner);
+            }
+            case 'holds': {
+                const owner = this.entityValue(cond.subject, ctx);
+                const thing = this.entityValue(cond.object, ctx);
+                return ctx.world.getLocation(thing) === owner;
+            }
+            case 'wears': {
+                const wearer = this.entityValue(cond.subject, ctx);
+                const thing = this.entityValue(cond.object, ctx);
+                const entity = ctx.world.getEntity(thing);
+                const wearable = entity?.get(world_model_1.TraitType.WEARABLE);
+                return wearable?.worn === true && wearable.wornBy === wearer;
+            }
+            case 'can-see':
+            case 'can-reach': {
+                // Phase B semantics: co-location — subject and object share a
+                // containing room. (Full perception/reach services are a later
+                // refinement; this matches the Zoo constructs' intent.)
+                const subjectId = this.entityValue(cond.subject, ctx);
+                const objectId = this.entityValue(cond.object, ctx);
+                const subjectRoom = ctx.world.getContainingRoom(subjectId)?.id ?? ctx.world.getLocation(subjectId);
+                const objectRoom = ctx.world.getContainingRoom(objectId)?.id ?? ctx.world.getLocation(objectId);
+                return raw(subjectRoom !== undefined && subjectRoom === objectRoom);
+            }
+        }
+    }
+    /**
+     * `<subject> is <bare-word>`: a declared state, a state adjective read
+     * live from world trait state (ratchet D1 — never stored), or the `dark`
+     * trait.
+     */
+    symbolHolds(subject, symbol, ctx) {
+        if (typeof subject === 'string') {
+            // A state string read from a `state` field compares directly.
+            if (subject === symbol)
+                return true;
+            const entity = ctx.world.getEntity(subject);
+            if (entity) {
+                if (symbol === 'dark') {
+                    const room = entity.get(world_model_1.TraitType.ROOM);
+                    return room?.isDark === true;
+                }
+                const irId = this.ids.irIdOf(subject);
+                if (irId !== undefined) {
+                    const state = ctx.world.getStateValue(state_keys_1.CHORD_STATE_PREFIX + irId);
+                    if (state !== undefined && state === symbol)
+                        return true;
+                }
+                const adjective = this.stateAdjectiveHolds(entity, symbol);
+                if (adjective !== null)
+                    return adjective;
+            }
+        }
+        return false;
+    }
+    /**
+     * State adjectives (ratchet D1): `open`/`closed`, `locked`/`unlocked`,
+     * `on`/`off`, `worn`, `lit` — pure reads of world trait state. Null when
+     * `symbol` is not a state adjective (or the trait is absent, so the
+     * adjective cannot hold either way).
+     */
+    stateAdjectiveHolds(entity, symbol) {
+        switch (symbol) {
+            case 'open':
+            case 'closed': {
+                const openable = entity.get(world_model_1.TraitType.OPENABLE);
+                if (!openable)
+                    return null;
+                return symbol === 'open' ? openable.isOpen === true : openable.isOpen !== true;
+            }
+            case 'locked':
+            case 'unlocked': {
+                const lockable = entity.get(world_model_1.TraitType.LOCKABLE);
+                if (!lockable)
+                    return null;
+                return symbol === 'locked' ? lockable.isLocked === true : lockable.isLocked !== true;
+            }
+            case 'on':
+            case 'off': {
+                const switchable = entity.get(world_model_1.TraitType.SWITCHABLE);
+                if (!switchable)
+                    return null;
+                return symbol === 'on' ? switchable.isOn === true : switchable.isOn !== true;
+            }
+            case 'worn': {
+                const wearable = entity.get(world_model_1.TraitType.WEARABLE);
+                if (!wearable)
+                    return null;
+                return wearable.worn === true;
+            }
+            case 'lit': {
+                const source = entity.get(world_model_1.TraitType.LIGHT_SOURCE);
+                if (!source)
+                    return null;
+                return source.isLit === true;
+            }
+            default:
+                return null;
+        }
+    }
+    // ---------------------------------------------------------------- values
+    evalValue(value, ctx) {
+        switch (value.kind) {
+            case 'literal':
+                return value.valueType === 'number' ? Number(value.value) : value.value;
+            case 'symbol':
+                return value.name;
+            case 'player':
+                return this.playerId(ctx.world);
+            case 'it': {
+                if (!ctx.it)
+                    throw new errors_1.LoadError('`it` used outside an entity-scoped clause.');
+                return this.requireWorldId(ctx.it);
+            }
+            case 'story':
+                // The story object is not an entity — only `change` targets it.
+                throw new errors_1.LoadError('The story object has no entity value — use `change the story to <state>`.');
+            case 'entity':
+                return this.requireWorldId(value.id);
+            case 'field': {
+                const base = this.evalValue(value.base, ctx);
+                if (typeof base !== 'string') {
+                    throw new errors_1.LoadError(`Cannot read \`${value.field}\` of a non-entity value.`);
+                }
+                return this.readField(base, value.field, ctx);
+            }
+            case 'slot': {
+                const bound = ctx.slots?.[value.name];
+                if (!bound) {
+                    throw new errors_1.LoadError(`Context value \`${value.name}\` is not bound here.`);
+                }
+                return bound;
+            }
+            case 'match': {
+                // The `each`-block binder (ratchet E3) — the analyzer's
+                // match-outside-each gate makes an unbound read a loader bug.
+                if (!ctx.match)
+                    throw new errors_1.LoadError('`the match` used outside an `each` block.');
+                return this.requireWorldId(ctx.match);
+            }
+        }
+    }
+    // ------------------------------------------------------------ quantifiers
+    /** The named condition's body, or a loader-bug throw. */
+    namedCondition(name) {
+        const named = this.conditions.get(name);
+        if (!named)
+            throw new errors_1.LoadError(`Unknown condition \`${name}\` at evaluation time.`);
+        return named;
+    }
+    /** True when some domain entity satisfies the open condition (short-circuit). */
+    someMatch(name, ctx) {
+        const named = this.namedCondition(name);
+        return this.irEntities.some((e) => this.ids.entityId(e.id) !== undefined && this.evalCondition(named, { ...ctx, it: e.id }));
+    }
+    /**
+     * The entities satisfying a named open condition, as IR ids in
+     * declaration order — E3's pinned creation-order enumeration. Used by
+     * the runtime's `each` execution and its pre-mutation snapshot.
+     */
+    matchesOf(name, ctx) {
+        const named = this.namedCondition(name);
+        return this.irEntities
+            .filter((e) => this.ids.entityId(e.id) !== undefined && this.evalCondition(named, { ...ctx, it: e.id }))
+            .map((e) => e.id);
+    }
+    /** Evaluate a value that must be an entity (world id). */
+    entityValue(value, ctx) {
+        const result = this.evalValue(value, ctx);
+        if (typeof result !== 'string' || !ctx.world.getEntity(result)) {
+            throw new errors_1.LoadError(`Expected an entity, got \`${String(result)}\`.`);
+        }
+        return result;
+    }
+    readField(worldId, field, ctx) {
+        switch (field) {
+            case 'location':
+                return ctx.world.getLocation(worldId);
+            case 'state': {
+                const irId = this.ids.irIdOf(worldId);
+                if (irId === undefined)
+                    throw new errors_1.LoadError('Cannot read `state` of a non-story entity.');
+                return ctx.world.getStateValue(state_keys_1.CHORD_STATE_PREFIX + irId);
+            }
+            default: {
+                // Chord trait data fields (Phase B): stored as own properties on
+                // the entity's `chord.trait.*` instances. ONLY fields the trait
+                // declares as `entity`-typed translate IR id → world id — a plain
+                // word value may coincide with an entity id (`kind: parrot` on the
+                // parrot itself) and must stay a symbol.
+                const value = this.readChordTraitField(worldId, field, ctx);
+                if (value !== undefined) {
+                    if (value.isEntityField && typeof value.value === 'string') {
+                        const asEntity = this.ids.entityId(value.value);
+                        if (asEntity)
+                            return asEntity;
+                    }
+                    return value.value;
+                }
+                throw new errors_1.LoadError(`Field \`${field}\` is not supported here.`);
+            }
+        }
+    }
+    /** Read a `define trait` data field off the entity's chord trait instances. */
+    readChordTraitField(worldId, field, ctx) {
+        const entity = ctx.world.getEntity(worldId);
+        if (!entity)
+            return undefined;
+        for (const trait of entity.traits.values()) {
+            if (!trait.type.startsWith(state_keys_1.CHORD_TRAIT_PREFIX))
+                continue;
+            const record = trait;
+            if (field in record) {
+                const traitName = trait.type.slice(state_keys_1.CHORD_TRAIT_PREFIX.length);
+                return { value: record[field], isEntityField: this.entityFields.get(traitName)?.has(field) ?? false };
+            }
+        }
+        return undefined;
+    }
+    // --------------------------------------------------------------- helpers
+    playerId(world) {
+        const id = world.getPlayer()?.id ?? this.ids.playerWorldId();
+        if (!id)
+            throw new errors_1.LoadError('No player entity exists yet.');
+        return id;
+    }
+    requireWorldId(irId) {
+        const id = this.ids.entityId(irId);
+        if (!id)
+            throw new errors_1.LoadError(`Entity \`${irId}\` has no world instance.`);
+        return id;
+    }
+    /** True when `thing` is located inside `container` at any depth. */
+    isWithin(world, thing, container) {
+        let current = world.getLocation(thing);
+        while (current) {
+            if (current === container)
+                return true;
+            current = world.getLocation(current);
+        }
+        return false;
+    }
+    /**
+     * `one chance in <n>`: seeded draw whose cursor persists in world state,
+     * so a fixed seed yields a byte-identical stream (AC-5) and restores
+     * resume the stream (AC-6).
+     */
+    drawChance(n, world) {
+        if (n <= 1)
+            return true;
+        const stored = world.getStateValue(state_keys_1.CHORD_RNG_KEY);
+        if (typeof stored === 'number')
+            this.rng.setSeed(stored);
+        const hit = this.rng.int(1, n) === 1;
+        world.setStateValue(state_keys_1.CHORD_RNG_KEY, this.rng.getSeed());
+        return hit;
+    }
+}
+exports.Evaluator = Evaluator;
+//# sourceMappingURL=evaluator.js.map

package/evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluator.js","sourceRoot":"","sources":["../../../../../../repos/sharpee_v2/packages/story-loader/src/evaluator.ts"],"names":[],"mappings":"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"}

package/event-contract.d.ts

@@ -0,0 +1,39 @@
+/**
+ * event-contract.ts — the event-selector map (AC-9, ADR-210 Interface
+ * Contract 2 slice): Chord event verbs → the stdlib event types/payload
+ * fields the runtime binds and filters on.
+ *
+ * SYNC ENFORCEMENT: the type-only stdlib import below makes this package's
+ * BUILD fail if stdlib renames the event payload fields the map depends on
+ * (`toRoom` on actor-moved). Renaming the event TYPE string is caught by
+ * tests/event-selector.test.ts and the golden transcript gates.
+ *
+ * Public interface: EVENT_TRIGGERS, EVENT_PAYLOAD_FIELDS,
+ * enteringDestination.
+ * Owner context: @sharpee/story-loader (type-only stdlib dep; erased at emit).
+ */
+import type { ActorMovedEventData } from '@sharpee/stdlib';
+/**
+ * Chord event verb → stdlib event type it binds to. Gerund register since
+ * the ownership package (ratchet D3): entity clauses read `after entering
+ * it`, so the map keys are gerunds.
+ */
+export declare const EVENT_TRIGGERS: Record<string, string>;
+/**
+ * Payload fields each trigger's filter reads. The mapped types are
+ * compile-time probes: if stdlib renames a field, this file stops
+ * compiling — the AC-9 CI failure.
+ */
+export declare const EVENT_PAYLOAD_FIELDS: {
+    entering: keyof ActorMovedEventData & 'toRoom';
+};
+/**
+ * Type-guarded read of an `entering` event's destination — the runtime's
+ * consumption-side half of the AC-9 contract (no blind payload casts). The
+ * return type is chained to the stdlib payload type so a field-type change
+ * fails this build too.
+ * @param data the raw event payload (unknown shape at the seam)
+ * @returns the destination room id, or undefined when absent/mis-shaped
+ */
+export declare function enteringDestination(data: unknown): ActorMovedEventData['toRoom'] | undefined;
+//# sourceMappingURL=event-contract.d.ts.map

package/event-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-contract.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee_v2/packages/story-loader/src/event-contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAEjD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE;IAAE,QAAQ,EAAE,MAAM,mBAAmB,GAAG,QAAQ,CAAA;CAElF,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,mBAAmB,CAAC,QAAQ,CAAC,GAAG,SAAS,CAI5F"}

package/event-contract.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVENT_PAYLOAD_FIELDS = exports.EVENT_TRIGGERS = void 0;
+exports.enteringDestination = enteringDestination;
+/**
+ * Chord event verb → stdlib event type it binds to. Gerund register since
+ * the ownership package (ratchet D3): entity clauses read `after entering
+ * it`, so the map keys are gerunds.
+ */
+exports.EVENT_TRIGGERS = {
+    entering: 'if.event.actor_moved',
+};
+/**
+ * Payload fields each trigger's filter reads. The mapped types are
+ * compile-time probes: if stdlib renames a field, this file stops
+ * compiling — the AC-9 CI failure.
+ */
+exports.EVENT_PAYLOAD_FIELDS = {
+    entering: 'toRoom',
+};
+/**
+ * Type-guarded read of an `entering` event's destination — the runtime's
+ * consumption-side half of the AC-9 contract (no blind payload casts). The
+ * return type is chained to the stdlib payload type so a field-type change
+ * fails this build too.
+ * @param data the raw event payload (unknown shape at the seam)
+ * @returns the destination room id, or undefined when absent/mis-shaped
+ */
+function enteringDestination(data) {
+    if (typeof data !== 'object' || data === null)
+        return undefined;
+    const value = data[exports.EVENT_PAYLOAD_FIELDS.entering];
+    return typeof value === 'string' ? value : undefined;
+}
+//# sourceMappingURL=event-contract.js.map

package/event-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-contract.js","sourceRoot":"","sources":["../../../../../../repos/sharpee_v2/packages/story-loader/src/event-contract.ts"],"names":[],"mappings":";;;AA0CA,kDAIC;AA9BD;;;;GAIG;AACU,QAAA,cAAc,GAA2B;IACpD,QAAQ,EAAE,sBAAsB;CACjC,CAAC;AAEF;;;;GAIG;AACU,QAAA,oBAAoB,GAAuD;IACtF,QAAQ,EAAE,QAAQ;CACnB,CAAC;AAEF;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CAAC,IAAa;IAC/C,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,KAAK,GAAI,IAAgC,CAAC,4BAAoB,CAAC,QAAQ,CAAC,CAAC;IAC/E,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC"}