@sharpee/engine 0.9.113 → 1.0.8

package/prose-pipeline/handlers/generic.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Generic event handlers — game.message and the catch-all generic
+ * fallback for unknown event types.
+ *
+ * Public interface: `handleGameMessage`, `handleGenericEvent`. Used
+ * by the pipeline's event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleGameMessage = handleGameMessage;
+exports.handleGenericEvent = handleGenericEvent;
+const text_blocks_1 = require("@sharpee/text-blocks");
+const assemble_1 = require("../assemble");
+/**
+ * Handle `game.message` events.
+ */
+function handleGameMessage(event, context) {
+    const data = event.data;
+    if (data.messageId && context.languageProvider) {
+        const message = context.languageProvider.getMessage(data.messageId, data.params);
+        if (message && message !== data.messageId) {
+            return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.GAME_MESSAGE, message);
+        }
+    }
+    const text = data.text ?? data.message;
+    if (text) {
+        return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.GAME_MESSAGE, text);
+    }
+    return [];
+}
+/**
+ * Handle generic / unknown events using `event.type` as the template key.
+ *
+ * Story-defined events follow the simple pattern:
+ *   - event.type is the template key
+ *   - event.data is the template params
+ */
+function handleGenericEvent(event, context) {
+    const data = event.data;
+    if (!data) {
+        return [];
+    }
+    if (data.message || data.text) {
+        const text = data.message ?? data.text ?? '';
+        if (text) {
+            return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, text);
+        }
+    }
+    if (context.languageProvider) {
+        const message = context.languageProvider.getMessage(event.type, data);
+        if (message && message !== event.type) {
+            return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, message);
+        }
+        if (data.messageId) {
+            const msgFromId = context.languageProvider.getMessage(data.messageId, data);
+            if (msgFromId && msgFromId !== data.messageId) {
+                return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, msgFromId);
+            }
+        }
+    }
+    return [];
+}
+//# sourceMappingURL=generic.js.map

package/prose-pipeline/handlers/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/generic.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAkBH,8CAsBC;AASD,gDAoCC;AAlFD,sDAAkD;AAGlD,0CAA2C;AAS3C;;GAEG;AACH,SAAgB,iBAAiB,CAC/B,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAuB,CAAC;IAE3C,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CACjD,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,MAAM,CACZ,CAAC;QACF,IAAI,OAAO,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;YAC1C,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC;IACvC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAwB,CAAC;IAE5C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC7C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAEtE,IAAI,OAAO,IAAI,OAAO,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;YACtC,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CACnD,IAAI,CAAC,SAAS,EACd,IAAI,CACL,CAAC;YACF,IAAI,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC,SAAS,EAAE,CAAC;gBAC9C,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/prose-pipeline/handlers/help.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Help event handler — `if.event.help_displayed`.
+ *
+ * Produces the canonical "HOW TO PLAY INTERACTIVE FICTION" block.
+ * Content based on the PR-IF "How to Play" reference card.
+ *
+ * Public interface: `handleHelpDisplayed`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+import type { HandlerContext } from './types';
+/**
+ * Handle `if.event.help_displayed` to produce the help text block.
+ */
+export declare function handleHelpDisplayed(_event: ISemanticEvent, _context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=help.d.ts.map

package/prose-pipeline/handlers/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/help.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAgD9C;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc,GACvB,UAAU,EAAE,CAEd"}

package/prose-pipeline/handlers/help.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Help event handler — `if.event.help_displayed`.
+ *
+ * Produces the canonical "HOW TO PLAY INTERACTIVE FICTION" block.
+ * Content based on the PR-IF "How to Play" reference card.
+ *
+ * Public interface: `handleHelpDisplayed`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleHelpDisplayed = handleHelpDisplayed;
+const assemble_1 = require("../assemble");
+const HELP_TEXT = `HOW TO PLAY INTERACTIVE FICTION
+
+Interactive fiction is a conversation between you and the game. You type commands; the game describes what happens.
+
+MOVING AROUND
+  Type a direction to move: NORTH (N), SOUTH (S), EAST (E), WEST (W),
+  NORTHEAST (NE), NORTHWEST (NW), SOUTHEAST (SE), SOUTHWEST (SW),
+  UP (U), DOWN (D), IN, OUT, ENTER, EXIT.
+
+LOOKING AND EXAMINING
+  LOOK (L) - Describe your surroundings.
+  EXAMINE (X) something - Look closely at an object.
+
+INTERACTING WITH OBJECTS
+  TAKE (GET) something - Pick it up.
+  DROP something - Put it down.
+  OPEN / CLOSE something - Open or close a door, container, etc.
+  PUT something IN / ON something - Place an object in a container or on a surface.
+  LOCK / UNLOCK something WITH something - Lock or unlock with a key.
+  TURN ON / TURN OFF something - Operate a switch or device.
+  WEAR / TAKE OFF something - Put on or remove clothing.
+  EAT / DRINK something - Consume food or drink.
+  READ something - Read text on an object.
+  SEARCH something - Search a container or area.
+  LOOK UNDER / LOOK BEHIND something - Check hidden spots.
+
+TALKING TO CHARACTERS
+  TALK TO someone - Start a conversation.
+  ASK someone ABOUT something - Ask about a topic.
+  TELL someone ABOUT something - Tell them something.
+  GIVE something TO someone - Hand over an item.
+  SHOW something TO someone - Display an item.
+
+OTHER COMMANDS
+  INVENTORY (I) - List what you're carrying.
+  WAIT (Z) - Let time pass.
+  AGAIN (G) - Repeat your last command.
+  SCORE - Check your progress.
+  SAVE / RESTORE - Save or load your game.
+  UNDO - Take back your last move.
+  QUIT - End the game.
+  ABOUT - Information about this game.
+
+When in doubt, EXAMINE everything.`;
+/**
+ * Handle `if.event.help_displayed` to produce the help text block.
+ */
+function handleHelpDisplayed(_event, _context) {
+    return (0, assemble_1.createBlocks)('help.text', HELP_TEXT);
+}
+//# sourceMappingURL=help.js.map

package/prose-pipeline/handlers/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/help.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;AAuDH,kDAKC;AAvDD,0CAA2C;AAE3C,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mCA2CiB,CAAC;AAEpC;;GAEG;AACH,SAAgB,mBAAmB,CACjC,MAAsB,EACtB,QAAwB;IAExB,OAAO,IAAA,uBAAY,EAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC"}

package/prose-pipeline/handlers/implicit-take.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Implicit-take handler — `if.event.implicit_take`.
+ *
+ * Produces the "(first taking the X)" line that prefaces an action
+ * the parser auto-promoted (e.g. "READ BOOK" when the player isn't
+ * holding the book yet).
+ *
+ * Public interface: `handleImplicitTake`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline (extracted from
+ *   text-service.ts inline)
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+import type { HandlerContext } from './types';
+export declare function handleImplicitTake(event: ISemanticEvent, _context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=implicit-take.d.ts.map

package/prose-pipeline/handlers/implicit-take.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"implicit-take.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/implicit-take.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAO9C,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,cAAc,GACvB,UAAU,EAAE,CAId"}

package/prose-pipeline/handlers/implicit-take.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * Implicit-take handler — `if.event.implicit_take`.
+ *
+ * Produces the "(first taking the X)" line that prefaces an action
+ * the parser auto-promoted (e.g. "READ BOOK" when the player isn't
+ * holding the book yet).
+ *
+ * Public interface: `handleImplicitTake`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline (extracted from
+ *   text-service.ts inline)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleImplicitTake = handleImplicitTake;
+const text_blocks_1 = require("@sharpee/text-blocks");
+const assemble_1 = require("../assemble");
+function handleImplicitTake(event, _context) {
+    const data = event.data;
+    const itemName = data?.itemName || 'something';
+    return [(0, assemble_1.createBlock)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, `(first taking the ${itemName})`)];
+}
+//# sourceMappingURL=implicit-take.js.map

package/prose-pipeline/handlers/implicit-take.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"implicit-take.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/implicit-take.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;AAYH,gDAOC;AAhBD,sDAAkD;AAGlD,0CAA0C;AAM1C,SAAgB,kBAAkB,CAChC,KAAqB,EACrB,QAAwB;IAExB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAwB,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,WAAW,CAAC;IAC/C,OAAO,CAAC,IAAA,sBAAW,EAAC,wBAAU,CAAC,aAAa,EAAE,qBAAqB,QAAQ,GAAG,CAAC,CAAC,CAAC;AACnF,CAAC"}

package/prose-pipeline/handlers/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Prose pipeline handlers — internal barrel.
+ *
+ * Public interface: re-exports every handler family the pipeline
+ * dispatches to, plus the shared `HandlerContext` / `EventHandler`
+ * types. Used by the pipeline class (sub-phase 1.5).
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ */
+export type { EventHandler, HandlerContext, ChainableEventData, GenericEventData, } from './types';
+export { handleRoomDescription } from './room';
+export { handleRevealed } from './revealed';
+export { handleGameMessage, handleGenericEvent } from './generic';
+export { handleGameStarted } from './game';
+export { handleHelpDisplayed } from './help';
+export { handleAboutDisplayed } from './about';
+export { handleAudibilityHeard } from './audibility';
+export { tryProcessDomainEventMessage } from './domain-message';
+export { handleImplicitTake } from './implicit-take';
+export { handleCommandFailed } from './command-failed';
+export { handleClientQuery } from './client-query';
+//# sourceMappingURL=index.d.ts.map

package/prose-pipeline/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAGrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/prose-pipeline/handlers/index.js

@@ -0,0 +1,40 @@
+"use strict";
+/**
+ * Prose pipeline handlers — internal barrel.
+ *
+ * Public interface: re-exports every handler family the pipeline
+ * dispatches to, plus the shared `HandlerContext` / `EventHandler`
+ * types. Used by the pipeline class (sub-phase 1.5).
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleClientQuery = exports.handleCommandFailed = exports.handleImplicitTake = exports.tryProcessDomainEventMessage = exports.handleAudibilityHeard = exports.handleAboutDisplayed = exports.handleHelpDisplayed = exports.handleGameStarted = exports.handleGenericEvent = exports.handleGameMessage = exports.handleRevealed = exports.handleRoomDescription = void 0;
+// Type-keyed handlers (former text-service handlers/*.ts).
+var room_1 = require("./room");
+Object.defineProperty(exports, "handleRoomDescription", { enumerable: true, get: function () { return room_1.handleRoomDescription; } });
+var revealed_1 = require("./revealed");
+Object.defineProperty(exports, "handleRevealed", { enumerable: true, get: function () { return revealed_1.handleRevealed; } });
+var generic_1 = require("./generic");
+Object.defineProperty(exports, "handleGameMessage", { enumerable: true, get: function () { return generic_1.handleGameMessage; } });
+Object.defineProperty(exports, "handleGenericEvent", { enumerable: true, get: function () { return generic_1.handleGenericEvent; } });
+var game_1 = require("./game");
+Object.defineProperty(exports, "handleGameStarted", { enumerable: true, get: function () { return game_1.handleGameStarted; } });
+var help_1 = require("./help");
+Object.defineProperty(exports, "handleHelpDisplayed", { enumerable: true, get: function () { return help_1.handleHelpDisplayed; } });
+var about_1 = require("./about");
+Object.defineProperty(exports, "handleAboutDisplayed", { enumerable: true, get: function () { return about_1.handleAboutDisplayed; } });
+var audibility_1 = require("./audibility");
+Object.defineProperty(exports, "handleAudibilityHeard", { enumerable: true, get: function () { return audibility_1.handleAudibilityHeard; } });
+// Inline handlers extracted from text-service.ts in this sub-phase.
+var domain_message_1 = require("./domain-message");
+Object.defineProperty(exports, "tryProcessDomainEventMessage", { enumerable: true, get: function () { return domain_message_1.tryProcessDomainEventMessage; } });
+var implicit_take_1 = require("./implicit-take");
+Object.defineProperty(exports, "handleImplicitTake", { enumerable: true, get: function () { return implicit_take_1.handleImplicitTake; } });
+var command_failed_1 = require("./command-failed");
+Object.defineProperty(exports, "handleCommandFailed", { enumerable: true, get: function () { return command_failed_1.handleCommandFailed; } });
+var client_query_1 = require("./client-query");
+Object.defineProperty(exports, "handleClientQuery", { enumerable: true, get: function () { return client_query_1.handleClientQuery; } });
+//# sourceMappingURL=index.js.map

package/prose-pipeline/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AASH,2DAA2D;AAC3D,+BAA+C;AAAtC,6GAAA,qBAAqB,OAAA;AAC9B,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AACvB,qCAAkE;AAAzD,4GAAA,iBAAiB,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAC9C,+BAA2C;AAAlC,yGAAA,iBAAiB,OAAA;AAC1B,+BAA6C;AAApC,2GAAA,mBAAmB,OAAA;AAC5B,iCAA+C;AAAtC,6GAAA,oBAAoB,OAAA;AAC7B,2CAAqD;AAA5C,mHAAA,qBAAqB,OAAA;AAE9B,oEAAoE;AACpE,mDAAgE;AAAvD,8HAAA,4BAA4B,OAAA;AACrC,iDAAqD;AAA5C,mHAAA,kBAAkB,OAAA;AAC3B,mDAAuD;AAA9C,qHAAA,mBAAmB,OAAA;AAC5B,+CAAmD;AAA1C,iHAAA,iBAAiB,OAAA"}

package/prose-pipeline/handlers/revealed.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Revealed event handler.
+ *
+ * Handles `if.event.revealed` — fired when items become visible inside
+ * a container. Pulls a direct message/text payload first, then tries
+ * the language provider keyed on event type, then falls back to a
+ * built-in "Inside the {container} you see {items}." formatter.
+ *
+ * Public interface: `handleRevealed`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-094 Event Chaining
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+import type { HandlerContext } from './types';
+/**
+ * Handle `if.event.revealed` events.
+ */
+export declare function handleRevealed(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=revealed.d.ts.map

package/prose-pipeline/handlers/revealed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revealed.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/revealed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,SAAS,CAAC;AAelE;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAkCd"}

package/prose-pipeline/handlers/revealed.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Revealed event handler.
+ *
+ * Handles `if.event.revealed` — fired when items become visible inside
+ * a container. Pulls a direct message/text payload first, then tries
+ * the language provider keyed on event type, then falls back to a
+ * built-in "Inside the {container} you see {items}." formatter.
+ *
+ * Public interface: `handleRevealed`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-094 Event Chaining
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRevealed = handleRevealed;
+const text_blocks_1 = require("@sharpee/text-blocks");
+const assemble_1 = require("../assemble");
+/**
+ * Handle `if.event.revealed` events.
+ */
+function handleRevealed(event, context) {
+    const data = event.data;
+    if (data.message || data.text) {
+        const text = data.message ?? data.text ?? '';
+        if (text) {
+            return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, text);
+        }
+    }
+    if (context.languageProvider) {
+        const message = context.languageProvider.getMessage(event.type, {
+            containerId: data.containerId,
+            containerName: data.containerName,
+            container: data.containerName,
+            items: data.items,
+        });
+        if (message && message !== event.type) {
+            return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, message);
+        }
+    }
+    if (data.items && data.items.length > 0) {
+        const itemNames = data.items
+            .map((item) => item.name ?? item.messageId ?? item.entityId)
+            .join(', ');
+        const container = data.containerName ?? 'it';
+        const text = `Inside the ${container} you see ${itemNames}.`;
+        return (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, text);
+    }
+    return [];
+}
+//# sourceMappingURL=revealed.js.map

package/prose-pipeline/handlers/revealed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"revealed.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/revealed.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AAuBH,wCAqCC;AAzDD,sDAAkD;AAGlD,0CAA2C;AAc3C;;GAEG;AACH,SAAgB,cAAc,CAC5B,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAyB,CAAC;IAE7C,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;QAC7C,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE;YAC9D,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,SAAS,EAAE,IAAI,CAAC,aAAa;YAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAC;QAEH,IAAI,OAAO,IAAI,OAAO,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;YACtC,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK;aACzB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC;aAC3D,IAAI,CAAC,IAAI,CAAC,CAAC;QAEd,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC;QAC7C,MAAM,IAAI,GAAG,cAAc,SAAS,YAAY,SAAS,GAAG,CAAC;QAC7D,OAAO,IAAA,uBAAY,EAAC,wBAAU,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/prose-pipeline/handlers/room.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Room description event handler.
+ *
+ * Handles `if.event.room.description` (canonical form) and
+ * `if.event.room_description` (legacy alternate). Resolves the
+ * room name and description through the language provider when a
+ * message id is present (ADR-107 dual-mode), falling back to literal
+ * text otherwise.
+ *
+ * Public interface: `handleRoomDescription`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-107 — Dual-mode literal/messageId handling
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+import type { HandlerContext } from './types';
+/**
+ * Handle room description events.
+ */
+export declare function handleRoomDescription(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=room.d.ts.map

package/prose-pipeline/handlers/room.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/room.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AA0B9C;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CA8Dd"}

package/prose-pipeline/handlers/room.js

@@ -0,0 +1,78 @@
+"use strict";
+/**
+ * Room description event handler.
+ *
+ * Handles `if.event.room.description` (canonical form) and
+ * `if.event.room_description` (legacy alternate). Resolves the
+ * room name and description through the language provider when a
+ * message id is present (ADR-107 dual-mode), falling back to literal
+ * text otherwise.
+ *
+ * Public interface: `handleRoomDescription`. Used by the pipeline's
+ * event-type dispatch.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-107 — Dual-mode literal/messageId handling
+ * @see ADR-174 §Engine-internal prose pipeline (port from text-service)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRoomDescription = handleRoomDescription;
+const text_blocks_1 = require("@sharpee/text-blocks");
+const assemble_1 = require("../assemble");
+/**
+ * Handle room description events.
+ */
+function handleRoomDescription(event, context) {
+    const data = event.data;
+    const blocks = [];
+    // Room name (if verbose).
+    if (data.verbose) {
+        let name;
+        // ADR-107: message ID takes precedence.
+        const nameId = data.roomNameId ?? data.room?.nameId;
+        if (nameId && context.languageProvider) {
+            const resolved = context.languageProvider.getMessage(nameId, {});
+            if (resolved && resolved !== nameId) {
+                name = resolved;
+            }
+        }
+        if (!name) {
+            name = data.room?.name ?? data.roomName;
+        }
+        if (name) {
+            const resolvedName = (0, assemble_1.extractValue)(name);
+            if (resolvedName) {
+                blocks.push((0, assemble_1.createBlock)(text_blocks_1.BLOCK_KEYS.ROOM_NAME, `[room:${resolvedName}]`));
+            }
+        }
+    }
+    // Room description.
+    let description;
+    const descriptionId = data.roomDescriptionId ?? data.room?.descriptionId;
+    if (descriptionId && context.languageProvider) {
+        const resolved = context.languageProvider.getMessage(descriptionId, {});
+        if (resolved && resolved !== descriptionId) {
+            description = resolved;
+        }
+    }
+    if (!description) {
+        description = data.room?.description ?? data.roomDescription;
+    }
+    if (description) {
+        const resolvedDesc = (0, assemble_1.extractValue)(description);
+        if (resolvedDesc) {
+            const descBlocks = (0, assemble_1.createBlocks)(text_blocks_1.BLOCK_KEYS.ROOM_DESCRIPTION, resolvedDesc);
+            // When the room name was emitted in this packet, the description's
+            // first block continues the room "heading" visually — mark it tight
+            // so the renderer collapses the inter-paragraph margin and the
+            // description sits flush under the bold room name.
+            if (descBlocks.length > 0 && blocks.length > 0) {
+                descBlocks[0] = { ...descBlocks[0], tight: true };
+            }
+            blocks.push(...descBlocks);
+        }
+    }
+    return blocks;
+}
+//# sourceMappingURL=room.js.map

package/prose-pipeline/handlers/room.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/room.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AAkCH,sDAiEC;AAhGD,sDAAkD;AAGlD,0CAAsE;AAyBtE;;GAEG;AACH,SAAgB,qBAAqB,CACnC,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAA2B,CAAC;IAC/C,MAAM,MAAM,GAAiB,EAAE,CAAC;IAEhC,0BAA0B;IAC1B,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,IAAI,IAAwB,CAAC;QAE7B,wCAAwC;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC;QACpD,IAAI,MAAM,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACjE,IAAI,QAAQ,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACpC,IAAI,GAAG,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC;QAC1C,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,YAAY,GAAG,IAAA,uBAAY,EAAC,IAAI,CAAC,CAAC;YACxC,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CACT,IAAA,sBAAW,EAAC,wBAAU,CAAC,SAAS,EAAE,SAAS,YAAY,GAAG,CAAC,CAC5D,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,IAAI,WAA+B,CAAC;IAEpC,MAAM,aAAa,GAAG,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC;IACzE,IAAI,aAAa,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;QACxE,IAAI,QAAQ,IAAI,QAAQ,KAAK,aAAa,EAAE,CAAC;YAC3C,WAAW,GAAG,QAAQ,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC,eAAe,CAAC;IAC/D,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,YAAY,GAAG,IAAA,uBAAY,EAAC,WAAW,CAAC,CAAC;QAC/C,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,UAAU,GAAG,IAAA,uBAAY,EAAC,wBAAU,CAAC,gBAAgB,EAAE,YAAY,CAAC,CAAC;YAC3E,mEAAmE;YACnE,oEAAoE;YACpE,+DAA+D;YAC/D,mDAAmD;YACnD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC/C,UAAU,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;YACpD,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/prose-pipeline/handlers/types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Handler types for the engine prose pipeline.
+ *
+ * Public interface: `HandlerContext`, `EventHandler`,
+ * `ChainableEventData`, `GenericEventData`. Used by handler families
+ * and the pipeline class.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ * @see ADR-094 (chain metadata semantics, preserved)
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { LanguageProvider } from '@sharpee/if-domain';
+import type { ISemanticEvent } from '@sharpee/core';
+/**
+ * Context passed to event handlers.
+ */
+export interface HandlerContext {
+    /** Language provider for template resolution. */
+    languageProvider?: LanguageProvider;
+}
+/**
+ * Event handler function signature.
+ *
+ * Handlers receive an event and context, return zero or more TextBlocks.
+ */
+export type EventHandler = (event: ISemanticEvent, context: HandlerContext) => ITextBlock[];
+/**
+ * Common event data with chain metadata (ADR-094).
+ */
+export interface ChainableEventData {
+    _transactionId?: string;
+    _chainDepth?: number;
+    _chainedFrom?: string;
+    _chainSourceId?: string;
+}
+/**
+ * Generic event data with message fields.
+ */
+export interface GenericEventData extends ChainableEventData {
+    message?: string;
+    messageId?: string;
+    text?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/prose-pipeline/handlers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,KACpB,UAAU,EAAE,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/prose-pipeline/handlers/types.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * Handler types for the engine prose pipeline.
+ *
+ * Public interface: `HandlerContext`, `EventHandler`,
+ * `ChainableEventData`, `GenericEventData`. Used by handler families
+ * and the pipeline class.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ * @see ADR-094 (chain metadata semantics, preserved)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/prose-pipeline/handlers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG"}

package/prose-pipeline/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Prose pipeline — internal barrel for the engine package.
+ *
+ * Public interface: `ProsePipeline`, `createProsePipeline`,
+ * `ITextService`. Plus the decoration primitives and stage utilities
+ * the pipeline class composes.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ */
+export { ProsePipeline, createProsePipeline } from './pipeline';
+export type { ITextService } from './types';
+export { parseDecorations, resolveClassName, PLATFORM_VOCABULARY, PLATFORM_VOCABULARY_NAMES, type PlatformVocabularyName, type IDecoration, type TextContent, } from './decorations';
+export { filterEvents } from './stages/filter';
+export { sortEventsForProse, getChainMetadata, } from './stages/sort';
+export { createBlock, createBlocks, extractValue } from './assemble';
+export type { EventHandler, HandlerContext, ChainableEventData, GenericEventData, } from './handlers/types';
+export { handleRoomDescription, handleRevealed, handleGameMessage, handleGenericEvent, handleGameStarted, handleHelpDisplayed, handleAboutDisplayed, handleAudibilityHeard, tryProcessDomainEventMessage, handleImplicitTake, handleCommandFailed, handleClientQuery, } from './handlers';
+//# sourceMappingURL=index.d.ts.map

package/prose-pipeline/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGhE,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAK5C,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGrE,YAAY,EACV,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}