@sharpee/if-services 1.1.1 → 1.1.2

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@sharpee/if-services",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Runtime service interfaces for Sharpee Interactive Fiction Platform",
   "main": "./index.js",
   "types": "./index.d.ts",
   "dependencies": {
     "@sharpee/core": "^1.1.1",
     "@sharpee/if-domain": "^1.1.1",
-    "@sharpee/world-model": "^1.1.1"
+    "@sharpee/world-model": "^1.1.2"
   },
   "keywords": [
     "sharpee",

package/perception-service.d.ts

@@ -14,6 +14,29 @@ import type { IFEntity, IWorldModel } from '@sharpee/world-model';
  * Sense types for perception checks
  */
 export type Sense = 'sight' | 'hearing' | 'smell' | 'touch';
+/**
+ * A single per-sense rendering of a witnessable fact: the message ID to render
+ * and the parameters that fill its template.
+ *
+ * @see ADR-069 amendment — Per-sense rendering selection
+ */
+export interface Rendering {
+    messageId: string;
+    params: Record<string, unknown>;
+}
+/**
+ * The per-sense renderings carried by a witnessable event's `data.renderings`.
+ *
+ * The emitter (e.g. NpcService) populates the senses it produces; PerceptionService
+ * selects one by the perceiver's available sense. Absent ⇒ not a witnessable fact
+ * (pass through). Present-but-empty `{}` ⇒ perceptible by nothing (blocked).
+ */
+export type PerSenseRenderings = Partial<Record<Sense, Rendering>>;
+/**
+ * Fixed selection precedence for renderings — independent of map key order.
+ * A new `Sense` must declare its rank here.
+ */
+export declare const SENSE_PRECEDENCE: readonly Sense[];
 /**
  * Reasons why perception might be blocked
  */

package/perception-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"perception-service.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/if-services/src/perception-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,WAAW,GACX,aAAa,GACb,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,8BAA8B;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,YAAY,CACV,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,WAAW,GACjB,cAAc,EAAE,CAAC;IAEpB;;;;;;;;OAQG;IACH,WAAW,CACT,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC;CACZ"}
+{"version":3,"file":"perception-service.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/if-services/src/perception-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC;AAEnE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,KAAK,EAA2C,CAAC;AAEzF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,WAAW,GACX,aAAa,GACb,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,iCAAiC;IACjC,MAAM,EAAE,qBAAqB,CAAC;IAC9B,8BAA8B;IAC9B,KAAK,EAAE,KAAK,CAAC;IACb,kDAAkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,YAAY,CACV,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,WAAW,GACjB,cAAc,EAAE,CAAC;IAEpB;;;;;;;;OAQG;IACH,WAAW,CACT,KAAK,EAAE,QAAQ,EACf,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,KAAK,GACX,OAAO,CAAC;CACZ"}

package/perception-service.js

@@ -10,4 +10,10 @@
  * @see ADR-069 Perception-Based Event Filtering
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SENSE_PRECEDENCE = void 0;
+/**
+ * Fixed selection precedence for renderings — independent of map key order.
+ * A new `Sense` must declare its rank here.
+ */
+exports.SENSE_PRECEDENCE = ['sight', 'hearing', 'smell', 'touch'];
 //# sourceMappingURL=perception-service.js.map

package/perception-service.js.map

@@ -1 +1 @@
-{"version":3,"file":"perception-service.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/if-services/src/perception-service.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG"}
+{"version":3,"file":"perception-service.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/if-services/src/perception-service.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AA8BH;;;GAGG;AACU,QAAA,gBAAgB,GAAqB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC"}