@sharpee/world-model 0.9.111 → 1.0.0

package/capabilities/action-interceptor.d.ts

@@ -10,6 +10,7 @@
  * - CapabilityBehavior: Full delegation, trait owns ALL logic (LOWER, RAISE)
  * - ActionInterceptor: Hooks into phases, action owns core logic (ENTER, PUT)
  */
+import { ISemanticEvent } from "../../core/index";
 import { IFEntity } from '../entities';
 import { WorldModel } from '../world';
 import { CapabilityEffect } from './types';
@@ -34,6 +35,98 @@ export interface InterceptorResult {
     /** Additional context for error messages */
     params?: Record<string, unknown>;
 }
+/**
+ * Result returned by `ActionInterceptor.postReport` (ISSUE-074).
+ *
+ * Distinguishes two semantically different intents that the old
+ * entity-`on` system collapsed onto a single `Effect[]` shape:
+ *
+ * 1. `override` — replace the primary domain event's `messageId`
+ *    (and optional params). Use when the interceptor's narration
+ *    *substitutes* for the action's standard message. Example: rug push
+ *    reveals the trap door — the rug-reveal text replaces the generic
+ *    "you give the rug a push" line.
+ *
+ * 2. `emit` — additional events to render alongside the action's
+ *    standard ones. Use for side-channel narration (multi-line
+ *    consequences) or events that are not message overrides.
+ *
+ * Both fields are optional and independent. Return `{}` (or simply
+ * an empty object literal) when the interceptor has nothing to do.
+ *
+ * Mirrors the override semantic that `event-processor.invokeEntityHandlers()`
+ * applies to single `game.message` reactions from story-level handlers
+ * (ADR-106), making the same intent explicit at the interceptor contract.
+ *
+ * @see applyInterceptorReportResult
+ */
+export interface InterceptorReportResult {
+    /** Override the primary domain event's messageId (and optional params/text).
+     *
+     *  - `messageId`: replaces the primary event's `data.messageId`.
+     *  - `params` (optional): replaces the primary event's `data.params`.
+     *  - `text` (optional): replaces the primary event's `data.text`. Used
+     *    when the interceptor has a pre-rendered string and wants the
+     *    text-service to fall back to it if `messageId` doesn't resolve
+     *    to a language template (mirrors the inline-text fallback in
+     *    `event-processor.ts`'s entity-handler override path).
+     *
+     *  Multiple interceptors returning `override` for the same action is a
+     *  hard error mirroring ADR-106's "multiple game.message reactions" rule. */
+    override?: {
+        messageId: string;
+        params?: Record<string, unknown>;
+        text?: string;
+    };
+    /** Emit additional events alongside the action's standard events. */
+    emit?: CapabilityEffect[];
+}
+/**
+ * Minimal context shape required by `applyInterceptorReportResult`.
+ *
+ * Real action contexts (both the engine's closure-based factory and the
+ * stdlib's class-based `EnhancedActionContext`) satisfy this structurally
+ * by exposing `event(type, data)`. Passing the *context object* — rather
+ * than an unbound `context.event` callback — preserves `this` for the
+ * class-based implementation, which would otherwise crash inside
+ * `createEventInternal`. Callers cannot forget to bind because there is
+ * nothing to bind.
+ */
+export interface InterceptorEventContext {
+    event(type: string, data: Record<string, any>): ISemanticEvent;
+}
+/**
+ * Apply an interceptor's `postReport` result to an action's emitted events.
+ *
+ * - If `result.override` is set, copies `messageId` (and optional `params`/`text`)
+ *   onto the data of the event whose type matches `primaryEventType`.
+ * - If `result.emit` is set, converts each effect to an `ISemanticEvent`
+ *   via `context.event(...)` and appends to `events`.
+ *
+ * The action's `report()` phase is responsible for calling this helper
+ * with the events array it has built so far, the event type that
+ * carries the standard message (e.g. `'if.event.pushed'`), and the
+ * action context whose `event(...)` method produces events with proper
+ * entity bindings.
+ *
+ * @param events - The action's events array; mutated in place.
+ * @param primaryEventType - The event type whose `messageId` an `override`
+ *                           should replace (e.g. `'if.event.pushed'`).
+ * @param result - The value returned from `interceptor.postReport`.
+ * @param context - The action context (any object exposing
+ *                  `event(type, data)`).
+ *
+ * @example
+ * ```typescript
+ * // In the pushing action's report() phase, after pushing the standard
+ * // if.event.pushed onto events:
+ * if (interceptor?.postReport) {
+ *   const result = interceptor.postReport(target, world, actorId, interceptorData);
+ *   applyInterceptorReportResult(events, 'if.event.pushed', result, context);
+ * }
+ * ```
+ */
+export declare function applyInterceptorReportResult(events: ISemanticEvent[], primaryEventType: string, result: InterceptorReportResult, context: InterceptorEventContext): void;
 /**
  * Action interceptor interface.
  *
@@ -138,17 +231,40 @@ export interface ActionInterceptor {
     /**
      * Called AFTER standard report.
      *
-     * Return additional effects to emit after the standard effects.
-     * Return empty array if no additional effects needed.
+     * Return an `InterceptorReportResult` that declares either:
+     * - `override`: replace the primary domain event's `messageId` (so the
+     *   interceptor's narration *substitutes* for the standard message), or
+     * - `emit`: additional events to render alongside the standard ones, or
+     * - both, or neither (return `{}` for no-op).
+     *
+     * Use `override` when the interceptor's message should *replace* the
+     * action's default text. Use `emit` for side-channel narration or
+     * non-message events.
+     *
+     * The action's `report()` phase applies the result via
+     * `applyInterceptorReportResult` (see helper below).
+     *
+     * @example
+     * // Override: rug push reveals trap door — the rug-reveal text
+     * // replaces the generic "you give the rug a push" message.
+     * postReport(entity, world, actorId, sharedData) {
+     *   if (!sharedData.rugRevealed) return {};
+     *   return { override: { messageId: 'dungeo.rug.moved.reveal_trapdoor' } };
+     * }
      *
      * @example
-     * // Add glacier melting message
+     * // Emit: ghost ritual narrates two consecutive lines.
      * postReport(entity, world, actorId, sharedData) {
-     *   if (!sharedData.melted) return [];
-     *   return [createEffect('dungeo.glacier.melted', { messageId: 'dungeo.glacier.melts' })];
+     *   if (!sharedData.ritualCompleted) return {};
+     *   return {
+     *     emit: [
+     *       createEffect('game.message', { messageId: 'dungeo.ghost.appears' }),
+     *       createEffect('game.message', { messageId: 'dungeo.ghost.canvas_spawns' })
+     *     ]
+     *   };
      * }
      */
-    postReport?(entity: IFEntity, world: WorldModel, actorId: string, sharedData: InterceptorSharedData): CapabilityEffect[];
+    postReport?(entity: IFEntity, world: WorldModel, actorId: string, sharedData: InterceptorSharedData): InterceptorReportResult;
     /**
      * Called when action is blocked (validation failed).
      *

package/capabilities/action-interceptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action-interceptor.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/capabilities/action-interceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,CACV,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,iBAAiB,GAAG,IAAI,CAAC;IAE5B;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CAAC,CACX,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,iBAAiB,GAAG,IAAI,CAAC;IAE5B;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,CACV,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,IAAI,CAAC;IAER;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,CACT,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,gBAAgB,EAAE,CAAC;IAEtB;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,CACR,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,qBAAqB,GAChC,gBAAgB,EAAE,GAAG,IAAI,CAAC;CAC9B"}
+{"version":3,"file":"action-interceptor.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/capabilities/action-interceptor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,qCAAqC;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,2DAA2D;IAC3D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;;;;;;;;;iFAW6E;IAC7E,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IAEF,qEAAqE;IACrE,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,cAAc,CAAC;CAChE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,cAAc,EAAE,EACxB,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CA4BN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,CACV,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,iBAAiB,GAAG,IAAI,CAAC;IAE5B;;;;;;;;;;;;;;;;;;OAkBG;IACH,YAAY,CAAC,CACX,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,iBAAiB,GAAG,IAAI,CAAC;IAE5B;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,CACV,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,IAAI,CAAC;IAER;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACH,UAAU,CAAC,CACT,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,qBAAqB,GAChC,uBAAuB,CAAC;IAE3B;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,CACR,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,qBAAqB,GAChC,gBAAgB,EAAE,GAAG,IAAI,CAAC;CAC9B"}

package/capabilities/action-interceptor.js

@@ -12,4 +12,63 @@
  * - ActionInterceptor: Hooks into phases, action owns core logic (ENTER, PUT)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.applyInterceptorReportResult = applyInterceptorReportResult;
+/**
+ * Apply an interceptor's `postReport` result to an action's emitted events.
+ *
+ * - If `result.override` is set, copies `messageId` (and optional `params`/`text`)
+ *   onto the data of the event whose type matches `primaryEventType`.
+ * - If `result.emit` is set, converts each effect to an `ISemanticEvent`
+ *   via `context.event(...)` and appends to `events`.
+ *
+ * The action's `report()` phase is responsible for calling this helper
+ * with the events array it has built so far, the event type that
+ * carries the standard message (e.g. `'if.event.pushed'`), and the
+ * action context whose `event(...)` method produces events with proper
+ * entity bindings.
+ *
+ * @param events - The action's events array; mutated in place.
+ * @param primaryEventType - The event type whose `messageId` an `override`
+ *                           should replace (e.g. `'if.event.pushed'`).
+ * @param result - The value returned from `interceptor.postReport`.
+ * @param context - The action context (any object exposing
+ *                  `event(type, data)`).
+ *
+ * @example
+ * ```typescript
+ * // In the pushing action's report() phase, after pushing the standard
+ * // if.event.pushed onto events:
+ * if (interceptor?.postReport) {
+ *   const result = interceptor.postReport(target, world, actorId, interceptorData);
+ *   applyInterceptorReportResult(events, 'if.event.pushed', result, context);
+ * }
+ * ```
+ */
+function applyInterceptorReportResult(events, primaryEventType, result, context) {
+    if (result.override) {
+        const primary = events.find((e) => e.type === primaryEventType);
+        if (primary) {
+            const data = primary.data;
+            data.messageId = result.override.messageId;
+            if (result.override.params) {
+                data.params = result.override.params;
+            }
+            if (result.override.text) {
+                data.text = result.override.text;
+            }
+        }
+        else {
+            // Defensive: an interceptor asked for an override but the action
+            // didn't emit a primary event of that type. Either the action's
+            // contract changed or the interceptor is misconfigured.
+            console.warn(`applyInterceptorReportResult: override requested for primary event type ` +
+                `"${primaryEventType}" but no event of that type was found in the events array.`);
+        }
+    }
+    if (result.emit) {
+        for (const effect of result.emit) {
+            events.push(context.event(effect.type, effect.payload));
+        }
+    }
+}
 //# sourceMappingURL=action-interceptor.js.map

package/capabilities/action-interceptor.js.map

@@ -1 +1 @@
-{"version":3,"file":"action-interceptor.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/capabilities/action-interceptor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}
+{"version":3,"file":"action-interceptor.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/capabilities/action-interceptor.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AA4HH,oEAiCC;AAhED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,SAAgB,4BAA4B,CAC1C,MAAwB,EACxB,gBAAwB,EACxB,MAA+B,EAC/B,OAAgC;IAEhC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;QAChE,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,OAAO,CAAC,IAA+B,CAAC;YACrD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;YAC3C,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YACvC,CAAC;YACD,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACzB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;YACnC,CAAC;QACH,CAAC;aAAM,CAAC;YACN,iEAAiE;YACjE,gEAAgE;YAChE,wDAAwD;YACxD,OAAO,CAAC,IAAI,CACV,0EAA0E;gBAC1E,IAAI,gBAAgB,4DAA4D,CACjF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YACjC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;AACH,CAAC"}

package/capabilities/index.d.ts

@@ -10,7 +10,7 @@ export { TraitBehaviorBinding, BehaviorRegistrationOptions, registerCapabilityBe
 export { CapabilityResolution, CapabilityMode, CapabilityConfig, defineCapabilityDefaults, getCapabilityConfig, hasCapabilityDefaults, clearCapabilityDefaults, getAllCapabilityDefaults } from './capability-defaults';
 export { findTraitWithCapability, hasCapability, getEntityCapabilities, traitHasCapability, getCapableTraits } from './capability-helpers';
 export { EntityBuilder, buildEntity } from './entity-builder';
-export { ActionInterceptor, InterceptorSharedData, InterceptorResult } from './action-interceptor';
+export { ActionInterceptor, InterceptorSharedData, InterceptorResult, InterceptorReportResult, InterceptorEventContext, applyInterceptorReportResult } from './action-interceptor';
 export { TraitInterceptorBinding, InterceptorRegistrationOptions, InterceptorLookupResult, registerActionInterceptor, getInterceptorForAction, getInterceptorBinding, hasActionInterceptor, unregisterActionInterceptor, clearInterceptorRegistry, getAllInterceptorBindings } from './interceptor-registry';
 export { findTraitWithInterceptor, hasInterceptor, getEntityInterceptors, traitHasInterceptor, getInterceptorTraits } from './interceptor-helpers';
 //# sourceMappingURL=index.d.ts.map

package/capabilities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGjF,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,aAAa,EACb,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAW1B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,0BAA0B,EAC1B,gBAAgB,EAChB,YAAY,EACb,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAGjF,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,0BAA0B,EAC1B,wBAAwB,EACxB,kBAAkB,EAClB,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,aAAa,EACb,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAW1B,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC7B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,wBAAwB,EACxB,cAAc,EACd,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,uBAAuB,CAAC"}

package/capabilities/index.js

@@ -6,7 +6,7 @@
  * (action IDs they respond to) and behaviors implement the logic.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getInterceptorTraits = exports.traitHasInterceptor = exports.getEntityInterceptors = exports.hasInterceptor = exports.findTraitWithInterceptor = exports.getAllInterceptorBindings = exports.clearInterceptorRegistry = exports.unregisterActionInterceptor = exports.hasActionInterceptor = exports.getInterceptorBinding = exports.getInterceptorForAction = exports.registerActionInterceptor = exports.buildEntity = exports.EntityBuilder = exports.getCapableTraits = exports.traitHasCapability = exports.getEntityCapabilities = exports.hasCapability = exports.findTraitWithCapability = exports.getAllCapabilityDefaults = exports.clearCapabilityDefaults = exports.hasCapabilityDefaults = exports.getCapabilityConfig = exports.defineCapabilityDefaults = exports.getAllCapabilityBindings = exports.clearCapabilityRegistry = exports.unregisterCapabilityBehavior = exports.hasCapabilityBehavior = exports.getBehaviorBinding = exports.getBehaviorForCapability = exports.registerCapabilityBehavior = exports.createEffect = void 0;
+exports.getInterceptorTraits = exports.traitHasInterceptor = exports.getEntityInterceptors = exports.hasInterceptor = exports.findTraitWithInterceptor = exports.getAllInterceptorBindings = exports.clearInterceptorRegistry = exports.unregisterActionInterceptor = exports.hasActionInterceptor = exports.getInterceptorBinding = exports.getInterceptorForAction = exports.registerActionInterceptor = exports.applyInterceptorReportResult = exports.buildEntity = exports.EntityBuilder = exports.getCapableTraits = exports.traitHasCapability = exports.getEntityCapabilities = exports.hasCapability = exports.findTraitWithCapability = exports.getAllCapabilityDefaults = exports.clearCapabilityDefaults = exports.hasCapabilityDefaults = exports.getCapabilityConfig = exports.defineCapabilityDefaults = exports.getAllCapabilityBindings = exports.clearCapabilityRegistry = exports.unregisterCapabilityBehavior = exports.hasCapabilityBehavior = exports.getBehaviorBinding = exports.getBehaviorForCapability = exports.registerCapabilityBehavior = exports.createEffect = void 0;
 // Types
 var types_1 = require("./types");
 Object.defineProperty(exports, "createEffect", { enumerable: true, get: function () { return types_1.createEffect; } });
@@ -37,6 +37,16 @@ Object.defineProperty(exports, "getCapableTraits", { enumerable: true, get: func
 var entity_builder_1 = require("./entity-builder");
 Object.defineProperty(exports, "EntityBuilder", { enumerable: true, get: function () { return entity_builder_1.EntityBuilder; } });
 Object.defineProperty(exports, "buildEntity", { enumerable: true, get: function () { return entity_builder_1.buildEntity; } });
+// ============================================================================
+// Action Interceptors (ADR-118)
+//
+// Interceptors allow traits to hook into stdlib action phases without
+// replacing standard logic. This complements capability behaviors which
+// provide full delegation.
+// ============================================================================
+// Interceptor interface
+var action_interceptor_1 = require("./action-interceptor");
+Object.defineProperty(exports, "applyInterceptorReportResult", { enumerable: true, get: function () { return action_interceptor_1.applyInterceptorReportResult; } });
 // Interceptor registry
 var interceptor_registry_1 = require("./interceptor-registry");
 Object.defineProperty(exports, "registerActionInterceptor", { enumerable: true, get: function () { return interceptor_registry_1.registerActionInterceptor; } });

package/capabilities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/capabilities/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,QAAQ;AACR,iCAIiB;AADf,qGAAA,YAAY,OAAA;AAMd,WAAW;AACX,6DAU+B;AAP7B,iIAAA,0BAA0B,OAAA;AAC1B,+HAAA,wBAAwB,OAAA;AACxB,yHAAA,kBAAkB,OAAA;AAClB,4HAAA,qBAAqB,OAAA;AACrB,mIAAA,4BAA4B,OAAA;AAC5B,8HAAA,uBAAuB,OAAA;AACvB,+HAAA,wBAAwB,OAAA;AAG1B,6BAA6B;AAC7B,6DAS+B;AAL7B,+HAAA,wBAAwB,OAAA;AACxB,0HAAA,mBAAmB,OAAA;AACnB,4HAAA,qBAAqB,OAAA;AACrB,8HAAA,uBAAuB,OAAA;AACvB,+HAAA,wBAAwB,OAAA;AAG1B,UAAU;AACV,2DAM8B;AAL5B,6HAAA,uBAAuB,OAAA;AACvB,mHAAA,aAAa,OAAA;AACb,2HAAA,qBAAqB,OAAA;AACrB,wHAAA,kBAAkB,OAAA;AAClB,sHAAA,gBAAgB,OAAA;AAGlB,iBAAiB;AACjB,mDAG0B;AAFxB,+GAAA,aAAa,OAAA;AACb,6GAAA,WAAW,OAAA;AAkBb,uBAAuB;AACvB,+DAWgC;AAP9B,iIAAA,yBAAyB,OAAA;AACzB,+HAAA,uBAAuB,OAAA;AACvB,6HAAA,qBAAqB,OAAA;AACrB,4HAAA,oBAAoB,OAAA;AACpB,mIAAA,2BAA2B,OAAA;AAC3B,gIAAA,wBAAwB,OAAA;AACxB,iIAAA,yBAAyB,OAAA;AAG3B,sBAAsB;AACtB,6DAM+B;AAL7B,+HAAA,wBAAwB,OAAA;AACxB,qHAAA,cAAc,OAAA;AACd,4HAAA,qBAAqB,OAAA;AACrB,0HAAA,mBAAmB,OAAA;AACnB,2HAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/capabilities/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,QAAQ;AACR,iCAIiB;AADf,qGAAA,YAAY,OAAA;AAMd,WAAW;AACX,6DAU+B;AAP7B,iIAAA,0BAA0B,OAAA;AAC1B,+HAAA,wBAAwB,OAAA;AACxB,yHAAA,kBAAkB,OAAA;AAClB,4HAAA,qBAAqB,OAAA;AACrB,mIAAA,4BAA4B,OAAA;AAC5B,8HAAA,uBAAuB,OAAA;AACvB,+HAAA,wBAAwB,OAAA;AAG1B,6BAA6B;AAC7B,6DAS+B;AAL7B,+HAAA,wBAAwB,OAAA;AACxB,0HAAA,mBAAmB,OAAA;AACnB,4HAAA,qBAAqB,OAAA;AACrB,8HAAA,uBAAuB,OAAA;AACvB,+HAAA,wBAAwB,OAAA;AAG1B,UAAU;AACV,2DAM8B;AAL5B,6HAAA,uBAAuB,OAAA;AACvB,mHAAA,aAAa,OAAA;AACb,2HAAA,qBAAqB,OAAA;AACrB,wHAAA,kBAAkB,OAAA;AAClB,sHAAA,gBAAgB,OAAA;AAGlB,iBAAiB;AACjB,mDAG0B;AAFxB,+GAAA,aAAa,OAAA;AACb,6GAAA,WAAW,OAAA;AAGb,+EAA+E;AAC/E,gCAAgC;AAChC,EAAE;AACF,sEAAsE;AACtE,wEAAwE;AACxE,2BAA2B;AAC3B,+EAA+E;AAE/E,wBAAwB;AACxB,2DAO8B;AAD5B,kIAAA,4BAA4B,OAAA;AAG9B,uBAAuB;AACvB,+DAWgC;AAP9B,iIAAA,yBAAyB,OAAA;AACzB,+HAAA,uBAAuB,OAAA;AACvB,6HAAA,qBAAqB,OAAA;AACrB,4HAAA,oBAAoB,OAAA;AACpB,mIAAA,2BAA2B,OAAA;AAC3B,gIAAA,wBAAwB,OAAA;AACxB,iIAAA,yBAAyB,OAAA;AAG3B,sBAAsB;AACtB,6DAM+B;AAL7B,+HAAA,wBAAwB,OAAA;AACxB,qHAAA,cAAc,OAAA;AACd,4HAAA,qBAAqB,OAAA;AACrB,0HAAA,mBAAmB,OAAA;AACnB,2HAAA,oBAAoB,OAAA"}

package/entities/entity-types.d.ts

@@ -21,6 +21,8 @@ export declare const EntityType: {
     readonly SCENERY: "scenery";
     /** A directional exit (rarely used as entity) */
     readonly EXIT: "exit";
+    /** A physical adjacency between two rooms (ADR-173) */
+    readonly WALL: "wall";
     /** A geographic grouping of rooms (ADR-149) */
     readonly REGION: "region";
     /** A temporal phase of the story (ADR-149) */

package/entities/entity-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-types.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/entities/entity-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,UAAU;IACrB,mCAAmC;;IAGnC,wCAAwC;;IAGxC,gCAAgC;;IAGhC,kCAAkC;;IAGlC,+CAA+C;;IAG/C,sDAAsD;;IAGtD,mDAAmD;;IAGnD,iDAAiD;;IAGjD,+CAA+C;;IAG/C,8CAA8C;;IAG9C,oCAAoC;;CAE5B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEpE;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,UAAU,CAE7D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAgB5D"}
+{"version":3,"file":"entity-types.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/entities/entity-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,UAAU;IACrB,mCAAmC;;IAGnC,wCAAwC;;IAGxC,gCAAgC;;IAGhC,kCAAkC;;IAGlC,+CAA+C;;IAG/C,sDAAsD;;IAGtD,mDAAmD;;IAGnD,iDAAiD;;IAGjD,uDAAuD;;IAGvD,+CAA+C;;IAG/C,8CAA8C;;IAG9C,oCAAoC;;CAE5B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEpE;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,IAAI,UAAU,CAE7D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAiB5D"}

package/entities/entity-types.js

@@ -26,6 +26,8 @@ exports.EntityType = {
     SCENERY: 'scenery',
     /** A directional exit (rarely used as entity) */
     EXIT: 'exit',
+    /** A physical adjacency between two rooms (ADR-173) */
+    WALL: 'wall',
     /** A geographic grouping of rooms (ADR-149) */
     REGION: 'region',
     /** A temporal phase of the story (ADR-149) */
@@ -53,6 +55,7 @@ function getEntityTypePrefix(type) {
         [exports.EntityType.SUPPORTER]: 's',
         [exports.EntityType.SCENERY]: 'y',
         [exports.EntityType.EXIT]: 'e',
+        [exports.EntityType.WALL]: 'w',
         [exports.EntityType.REGION]: 'rg',
         [exports.EntityType.SCENE]: 'sc',
         [exports.EntityType.OBJECT]: 'o'

package/entities/entity-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-types.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/entities/entity-types.ts"],"names":[],"mappings":";;;AAiDA,oCAEC;AAMD,kDAgBC;AAzED;;;;;GAKG;AACU,QAAA,UAAU,GAAG;IACxB,mCAAmC;IACnC,IAAI,EAAE,MAAM;IAEZ,wCAAwC;IACxC,IAAI,EAAE,MAAM;IAEZ,gCAAgC;IAChC,IAAI,EAAE,MAAM;IAEZ,kCAAkC;IAClC,KAAK,EAAE,OAAO;IAEd,+CAA+C;IAC/C,SAAS,EAAE,WAAW;IAEtB,sDAAsD;IACtD,SAAS,EAAE,WAAW;IAEtB,mDAAmD;IACnD,OAAO,EAAE,SAAS;IAElB,iDAAiD;IACjD,IAAI,EAAE,MAAM;IAEZ,+CAA+C;IAC/C,MAAM,EAAE,QAAQ;IAEhB,8CAA8C;IAC9C,KAAK,EAAE,OAAO;IAEd,oCAAoC;IACpC,MAAM,EAAE,QAAQ;CACR,CAAC;AAOX;;GAEG;AACH,SAAgB,YAAY,CAAC,IAAY;IACvC,OAAO,MAAM,CAAC,MAAM,CAAC,kBAAU,CAAC,CAAC,QAAQ,CAAC,IAAkB,CAAC,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,IAAgB;IAClD,MAAM,SAAS,GAA+B;QAC5C,CAAC,kBAAU,CAAC,IAAI,CAAC,EAAE,GAAG;QACtB,CAAC,kBAAU,CAAC,IAAI,CAAC,EAAE,GAAG;QACtB,CAAC,kBAAU,CAAC,IAAI,CAAC,EAAE,GAAG;QACtB,CAAC,kBAAU,CAAC,KAAK,CAAC,EAAE,GAAG;QACvB,CAAC,kBAAU,CAAC,SAAS,CAAC,EAAE,GAAG;QAC3B,CAAC,kBAAU,CAAC,SAAS,CAAC,EAAE,GAAG;QAC3B,CAAC,kBAAU,CAAC,OAAO,CAAC,EAAE,GAAG;QACzB,CAAC,kBAAU,CAAC,IAAI,CAAC,EAAE,GAAG;QACtB,CAAC,kBAAU,CAAC,MAAM,CAAC,EAAE,IAAI;QACzB,CAAC,kBAAU,CAAC,KAAK,CAAC,EAAE,IAAI;QACxB,CAAC,kBAAU,CAAC,MAAM,CAAC,EAAE,GAAG;KACzB,CAAC;IAEF,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;AAChC,CAAC"}
+{"version":3,"file":"entity-types.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/entities/entity-types.ts"],"names":[],"mappings":";;;AAoDA,oCAEC;AAMD,kDAiBC;AA7ED;;;;;GAKG;AACU,QAAA,UAAU,GAAG;IACxB,mCAAmC;IACnC,IAAI,EAAE,MAAM;IAEZ,wCAAwC;IACxC,IAAI,EAAE,MAAM;IAEZ,gCAAgC;IAChC,IAAI,EAAE,MAAM;IAEZ,kCAAkC;IAClC,KAAK,EAAE,OAAO;IAEd,+CAA+C;IAC/C,SAAS,EAAE,WAAW;IAEtB,sDAAsD;IACtD,SAAS,EAAE,WAAW;IAEtB,mDAAmD;IACnD,OAAO,EAAE,SAAS;IAElB,iDAAiD;IACjD,IAAI,EAAE,MAAM;IAEZ,uDAAuD;IACvD,IAAI,EAAE,MAAM;IAEZ,+CAA+C;IAC/C,MAAM,EAAE,QAAQ;IAEhB,8CAA8C;IAC9C,KAAK,EAAE,OAAO;IAEd,oCAAoC;IACpC,MAAM,EAAE,QAAQ;CACR,CAAC;AAOX;;GAEG;AACH,SAAgB,YAAY,CAAC,IAAY;IACvC,OAAO,MAAM,CAAC,MAAM,CAAC,kBAAU,CAAC,CAAC,QAAQ,CAAC,IAAkB,CAAC,CAAC;AAChE,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,IAAgB;IAClD,MAAM,SAAS,GAA+B;QAC5C,CAAC,kBAAU,CAAC,IAAI,CAAC,EAAE,GAAG;QACtB,CAAC,kBAAU,CAAC,IAAI,CAAC,EAAE,GAAG;QACtB,CAAC,kBAAU,CAAC,IAAI,CAAC,EAAE,GAAG;QACtB,CAAC,kBAAU,CAAC,KAAK,CAAC,EAAE,GAAG;QACvB,CAAC,kBAAU,CAAC,SAAS,CAAC,EAAE,GAAG;QAC3B,CAAC,kBAAU,CAAC,SAAS,CAAC,EAAE,GAAG;QAC3B,CAAC,kBAAU,CAAC,OAAO,CAAC,EAAE,GAAG;QACzB,CAAC,kBAAU,CAAC,IAAI,CAAC,EAAE,GAAG;QACtB,CAAC,kBAAU,CAAC,IAAI,CAAC,EAAE,GAAG;QACtB,CAAC,kBAAU,CAAC,MAAM,CAAC,EAAE,IAAI;QACzB,CAAC,kBAAU,CAAC,KAAK,CAAC,EAAE,IAAI;QACxB,CAAC,kBAAU,CAAC,MAAM,CAAC,EAAE,GAAG;KACzB,CAAC;IAEF,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;AAChC,CAAC"}

package/entities/index.d.ts

@@ -2,4 +2,6 @@ export { IFEntity } from './if-entity';
 export { EntityStore } from './entity-store';
 export { EntityType, isEntityType, getEntityTypePrefix } from './entity-types';
 export type { EntityType as EntityTypeValue } from './entity-types';
+export { WallEntity } from './wall-entity';
+export type { IWallEntity, IWallSideData, IWallSpec, IWallsSpec } from './wall-entity';
 //# sourceMappingURL=index.d.ts.map

package/entities/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/entities/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,YAAY,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/entities/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,YAAY,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/entities/index.js

@@ -1,7 +1,7 @@
 "use strict";
 // packages/world-model/src/entities/index.ts
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getEntityTypePrefix = exports.isEntityType = exports.EntityType = exports.EntityStore = exports.IFEntity = void 0;
+exports.WallEntity = exports.getEntityTypePrefix = exports.isEntityType = exports.EntityType = exports.EntityStore = exports.IFEntity = void 0;
 var if_entity_1 = require("./if-entity");
 Object.defineProperty(exports, "IFEntity", { enumerable: true, get: function () { return if_entity_1.IFEntity; } });
 var entity_store_1 = require("./entity-store");
@@ -10,4 +10,6 @@ var entity_types_1 = require("./entity-types");
 Object.defineProperty(exports, "EntityType", { enumerable: true, get: function () { return entity_types_1.EntityType; } });
 Object.defineProperty(exports, "isEntityType", { enumerable: true, get: function () { return entity_types_1.isEntityType; } });
 Object.defineProperty(exports, "getEntityTypePrefix", { enumerable: true, get: function () { return entity_types_1.getEntityTypePrefix; } });
+var wall_entity_1 = require("./wall-entity");
+Object.defineProperty(exports, "WallEntity", { enumerable: true, get: function () { return wall_entity_1.WallEntity; } });
 //# sourceMappingURL=index.js.map

package/entities/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/entities/index.ts"],"names":[],"mappings":";AAAA,6CAA6C;;;AAE7C,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AACjB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,+CAA+E;AAAtE,0GAAA,UAAU,OAAA;AAAE,4GAAA,YAAY,OAAA;AAAE,mHAAA,mBAAmB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/entities/index.ts"],"names":[],"mappings":";AAAA,6CAA6C;;;AAE7C,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AACjB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,+CAA+E;AAAtE,0GAAA,UAAU,OAAA;AAAE,4GAAA,YAAY,OAAA;AAAE,mHAAA,mBAAmB,OAAA;AAEtD,6CAA2C;AAAlC,yGAAA,UAAU,OAAA"}

package/entities/wall-entity.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Wall entity primitive (ADR-173).
+ *
+ * A wall is an IFEntity-derived entity expressing a physical adjacency
+ * between exactly two distinct rooms. It carries whole-wall traits (the
+ * entity's regular trait map — symmetric properties of the wall as a
+ * physical object) and per-side data (asymmetric interface properties
+ * keyed by the room id you encounter the wall from).
+ *
+ * Public interface: `IWallSideData`, `IWallSpec`, `WallEntity`. Authors
+ * do not instantiate `WallEntity` directly — they use `WorldModel.createWall`,
+ * which constructs the entity, runs validation, and maintains reciprocal
+ * references on both rooms.
+ *
+ * Owner context: `@sharpee/world-model` — entities / spatial primitives.
+ */
+import { EntityId, IEntityCreationParams } from "../../core/index";
+import { IFEntity } from './if-entity';
+import { ITrait } from '../traits/trait';
+/**
+ * Per-side data for a wall (ADR-173).
+ *
+ * Keyed by the room id the player is in when looking at the wall.
+ */
+export interface IWallSideData {
+    /**
+     * The adjective the parser uses to disambiguate this wall from other
+     * walls visible from the same room (e.g. 'oak', 'brick'). Required.
+     * Must be unique within any single room across all walls visible
+     * from that room.
+     */
+    adjective: string;
+    /**
+     * Optional per-side description, rendered when the player examines
+     * the wall from this side.
+     */
+    description?: string;
+    /**
+     * Optional reference to an entity that obstructs capability access
+     * to this side of the wall (e.g. a bookcase against the parlor side).
+     * Per ADR-173, the obstructor's own traits declare which capabilities
+     * it modifies (the "generalized obstructor protocol"). Must reference
+     * an entity that exists and is located in the appropriate room at
+     * world-load time; runtime evaluation re-checks the obstructor's
+     * current location.
+     */
+    obstructedBy?: EntityId;
+}
+/**
+ * Author-supplied specification for `WorldModel.createWall` (ADR-173).
+ *
+ * `between` is two distinct rooms (passed as either entities or ids).
+ * `whole` carries traits applied to the wall as a single object —
+ * symmetric properties (acoustic cost, structural material). `sides`
+ * carries the per-side data, keyed by each room's id.
+ */
+export interface IWallSpec {
+    between: [IFEntity | EntityId, IFEntity | EntityId];
+    whole?: ITrait[];
+    sides: Record<EntityId, IWallSideData>;
+}
+/**
+ * Author-supplied specification for `WorldModel.createWalls` (ADR-173).
+ *
+ * Fans out into one wall entity per element of `to`. `sides` is a
+ * function called once per pair to produce that side's data; the
+ * caller is given the room id and may produce per-room-distinct
+ * adjectives or descriptions.
+ */
+export interface IWallsSpec {
+    from: IFEntity | EntityId;
+    to: ReadonlyArray<IFEntity | EntityId>;
+    whole?: ITrait[];
+    sides: (roomId: EntityId) => IWallSideData;
+}
+/**
+ * IFEntity subclass for walls. Adds the `between` relation and the
+ * per-side data map. Whole-wall traits live on the entity's existing
+ * trait map (`entity.add(trait)`); per-side state is held here because
+ * it is keyed by room id rather than trait type.
+ */
+export declare class WallEntity extends IFEntity {
+    /**
+     * The two rooms this wall borders. Exactly two distinct room ids.
+     * Invariant established by `WorldModel.createWall` and held for the
+     * wall's lifetime — there is no API to mutate `between`.
+     */
+    readonly between: [EntityId, EntityId];
+    /**
+     * Per-side data keyed by room id. Always has exactly the two keys in
+     * `between`; populated by `WorldModel.createWall`.
+     */
+    readonly sides: Map<EntityId, IWallSideData>;
+    constructor(id: string, between: [EntityId, EntityId], params?: Partial<IEntityCreationParams>);
+    /**
+     * Returns the per-side data for the side facing `roomId`, or undefined
+     * if `roomId` is not one of the wall's two rooms.
+     */
+    getSide(roomId: EntityId): IWallSideData | undefined;
+    /**
+     * Returns the id of the room on the other side of the wall from
+     * `roomId`, or undefined if `roomId` is not one of the wall's two
+     * rooms.
+     */
+    otherRoom(roomId: EntityId): EntityId | undefined;
+}
+/**
+ * `IWallEntity` is the structural shape consumers code against.
+ * `WallEntity` is the concrete class produced by `WorldModel.createWall`.
+ */
+export type IWallEntity = WallEntity;
+//# sourceMappingURL=wall-entity.d.ts.map

package/entities/wall-entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wall-entity.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/entities/wall-entity.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;;;;OAQG;IACH,YAAY,CAAC,EAAE,QAAQ,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,CAAC,QAAQ,GAAG,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACpD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;CACxC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,EAAE,EAAE,aAAa,CAAC,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,KAAK,aAAa,CAAC;CAC5C;AAED;;;;;GAKG;AACH,qBAAa,UAAW,SAAQ,QAAQ;IACtC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAEvC;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;gBAG3C,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,qBAAqB,CAAC;IAOzC;;;OAGG;IACH,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS;IAIpD;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS;CAKlD;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC"}

package/entities/wall-entity.js

@@ -0,0 +1,50 @@
+"use strict";
+// packages/world-model/src/entities/wall-entity.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WallEntity = void 0;
+const if_entity_1 = require("./if-entity");
+/**
+ * IFEntity subclass for walls. Adds the `between` relation and the
+ * per-side data map. Whole-wall traits live on the entity's existing
+ * trait map (`entity.add(trait)`); per-side state is held here because
+ * it is keyed by room id rather than trait type.
+ */
+class WallEntity extends if_entity_1.IFEntity {
+    /**
+     * The two rooms this wall borders. Exactly two distinct room ids.
+     * Invariant established by `WorldModel.createWall` and held for the
+     * wall's lifetime — there is no API to mutate `between`.
+     */
+    between;
+    /**
+     * Per-side data keyed by room id. Always has exactly the two keys in
+     * `between`; populated by `WorldModel.createWall`.
+     */
+    sides;
+    constructor(id, between, params) {
+        super(id, 'wall', params);
+        this.between = between;
+        this.sides = new Map();
+    }
+    /**
+     * Returns the per-side data for the side facing `roomId`, or undefined
+     * if `roomId` is not one of the wall's two rooms.
+     */
+    getSide(roomId) {
+        return this.sides.get(roomId);
+    }
+    /**
+     * Returns the id of the room on the other side of the wall from
+     * `roomId`, or undefined if `roomId` is not one of the wall's two
+     * rooms.
+     */
+    otherRoom(roomId) {
+        if (roomId === this.between[0])
+            return this.between[1];
+        if (roomId === this.between[1])
+            return this.between[0];
+        return undefined;
+    }
+}
+exports.WallEntity = WallEntity;
+//# sourceMappingURL=wall-entity.js.map

package/entities/wall-entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wall-entity.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/entities/wall-entity.ts"],"names":[],"mappings":";AAAA,mDAAmD;;;AAoBnD,2CAAuC;AAgEvC;;;;;GAKG;AACH,MAAa,UAAW,SAAQ,oBAAQ;IACtC;;;;OAIG;IACM,OAAO,CAAuB;IAEvC;;;OAGG;IACM,KAAK,CAA+B;IAE7C,YACE,EAAU,EACV,OAA6B,EAC7B,MAAuC;QAEvC,KAAK,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,EAAE,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,MAAgB;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACH,SAAS,CAAC,MAAgB;QACxB,IAAI,MAAM,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,MAAM,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;CACF;AA1CD,gCA0CC"}

package/index.d.ts

@@ -33,6 +33,9 @@ export * from './traits/vehicle';
 export * from './traits/story-info';
 export * from './traits/character-model';
 export * from './traits/concealment';
+export * from './traits/acoustic';
+export * from './traits/listener';
+export * from './traits/obstructor-protocol';
 export * from './extensions';
 export * from './world';
 export * from './scope';

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/world-model/src/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAG3B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/world-model/src/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAG3B,cAAc,aAAa,CAAC;AAG5B,cAAc,aAAa,CAAC;AAG5B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AAGzC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,cAAc,CAAC;AAG7B,cAAc,SAAS,CAAC;AAGxB,cAAc,SAAS,CAAC;AAGxB,cAAc,gBAAgB,CAAC;AAG/B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,eAAe,CAAC"}

package/index.js

@@ -56,6 +56,9 @@ __exportStar(require("./traits/vehicle"), exports);
 __exportStar(require("./traits/story-info"), exports);
 __exportStar(require("./traits/character-model"), exports);
 __exportStar(require("./traits/concealment"), exports);
+__exportStar(require("./traits/acoustic"), exports);
+__exportStar(require("./traits/listener"), exports);
+__exportStar(require("./traits/obstructor-protocol"), exports);
 // Extension system
 __exportStar(require("./extensions"), exports);
 // World model

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;AAEpC,gBAAgB;AAChB,6CAA2B;AAE3B,iBAAiB;AACjB,8CAA4B;AAE5B,YAAY;AACZ,8CAA4B;AAE5B,8CAA8C;AAC9C,6CAA2B;AAC3B,+CAA6B;AAE7B,SAAS;AACT,iDAA+B;AAC/B,uDAAqC;AACrC,2DAAyC;AAEzC,2BAA2B;AAC3B,oDAAkC;AAClC,qDAAmC;AACnC,gDAA8B;AAC9B,oDAAkC;AAClC,oDAAkC;AAClC,oDAAkC;AAClC,wDAAsC;AACtC,gDAA8B;AAC9B,qDAAmC;AACnC,mDAAiC;AACjC,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,kDAAgC;AAChC,gDAA8B;AAC9B,iDAA+B;AAC/B,oDAAkC;AAClC,kDAAgC;AAChC,oDAAkC;AAClC,4DAA0C;AAC1C,oDAAkC;AAClC,oDAAkC;AAClC,+CAA6B;AAC7B,mDAAiC;AACjC,sDAAoC;AACpC,2DAAyC;AACzC,uDAAqC;AAErC,mBAAmB;AACnB,+CAA6B;AAE7B,cAAc;AACd,0CAAwB;AAExB,eAAe;AACf,0CAAwB;AAExB,mFAAmF;AACnF,iDAA+B;AAE/B,uCAAuC;AACvC,iDAA+B;AAE/B,wBAAwB;AACxB,gDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/index.ts"],"names":[],"mappings":";AAAA,oCAAoC;;;;;;;;;;;;;;;;AAEpC,gBAAgB;AAChB,6CAA2B;AAE3B,iBAAiB;AACjB,8CAA4B;AAE5B,YAAY;AACZ,8CAA4B;AAE5B,8CAA8C;AAC9C,6CAA2B;AAC3B,+CAA6B;AAE7B,SAAS;AACT,iDAA+B;AAC/B,uDAAqC;AACrC,2DAAyC;AAEzC,2BAA2B;AAC3B,oDAAkC;AAClC,qDAAmC;AACnC,gDAA8B;AAC9B,oDAAkC;AAClC,oDAAkC;AAClC,oDAAkC;AAClC,wDAAsC;AACtC,gDAA8B;AAC9B,qDAAmC;AACnC,mDAAiC;AACjC,qDAAmC;AACnC,sDAAoC;AACpC,oDAAkC;AAClC,kDAAgC;AAChC,gDAA8B;AAC9B,iDAA+B;AAC/B,oDAAkC;AAClC,kDAAgC;AAChC,oDAAkC;AAClC,4DAA0C;AAC1C,oDAAkC;AAClC,oDAAkC;AAClC,+CAA6B;AAC7B,mDAAiC;AACjC,sDAAoC;AACpC,2DAAyC;AACzC,uDAAqC;AACrC,oDAAkC;AAClC,oDAAkC;AAClC,+DAA6C;AAE7C,mBAAmB;AACnB,+CAA6B;AAE7B,cAAc;AACd,0CAAwB;AAExB,eAAe;AACf,0CAAwB;AAExB,mFAAmF;AACnF,iDAA+B;AAE/B,uCAAuC;AACvC,iDAA+B;AAE/B,wBAAwB;AACxB,gDAA8B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sharpee/world-model",
-  "version": "0.9.111",
+  "version": "1.0.0",
   "description": "World model for Sharpee IF platform - entities, traits, and behaviors",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -12,8 +12,8 @@
     }
   },
   "dependencies": {
-    "@sharpee/core": "^0.9.111",
-    "@sharpee/if-domain": "^0.9.111"
+    "@sharpee/core": "^1.0.0",
+    "@sharpee/if-domain": "^1.0.0"
   },
   "keywords": [
     "interactive-fiction",