@sharpee/engine 1.5.0 → 2.1.0

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v1/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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/engine/src/prose-pipeline/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAGhE,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG/D,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,cAAc,GACpB,MAAM,kBAAkB,CAAC;AAK1B,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,qBAAqB,EACrB,4BAA4B,EAC5B,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/prose-pipeline/index.js

@@ -3,7 +3,7 @@
  * Prose pipeline — internal barrel for the engine package.
  *
  * Public interface: `ProsePipeline`, `createProsePipeline`,
- * `ITextService`. Plus the decoration primitives and stage utilities
+ * `IProsePipeline`. Plus the decoration primitives and stage utilities
  * the pipeline class composes.
  *
  * Owner context: `@sharpee/engine` — internal prose pipeline.
@@ -11,11 +11,15 @@
  * @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 = exports.extractValue = exports.createBlocks = exports.createBlock = exports.getChainMetadata = exports.sortEventsForProse = exports.filterEvents = exports.PLATFORM_VOCABULARY_NAMES = exports.PLATFORM_VOCABULARY = exports.resolveClassName = exports.parseDecorations = exports.createProsePipeline = exports.ProsePipeline = void 0;
+exports.handleClientQuery = exports.handleCommandFailed = exports.handleImplicitTake = exports.tryProcessDomainEventMessage = exports.handleAudibilityHeard = exports.handleGameStarted = exports.handleGenericEvent = exports.handleGameMessage = exports.handleRevealed = exports.handleRoomDescription = exports.extractValue = exports.createBlocks = exports.createBlock = exports.getChainMetadata = exports.sortEventsForProse = exports.filterEvents = exports.PLATFORM_VOCABULARY_NAMES = exports.PLATFORM_VOCABULARY = exports.resolveClassName = exports.parseDecorations = exports.createRenderContextFactory = exports.createRenderWorld = exports.createProsePipeline = exports.ProsePipeline = void 0;
 // Pipeline class and factory.
 var pipeline_1 = require("./pipeline");
 Object.defineProperty(exports, "ProsePipeline", { enumerable: true, get: function () { return pipeline_1.ProsePipeline; } });
 Object.defineProperty(exports, "createProsePipeline", { enumerable: true, get: function () { return pipeline_1.createProsePipeline; } });
+// Render-context runtime for the phrase pipeline (ADR-192, W2).
+var render_context_1 = require("./render-context");
+Object.defineProperty(exports, "createRenderWorld", { enumerable: true, get: function () { return render_context_1.createRenderWorld; } });
+Object.defineProperty(exports, "createRenderContextFactory", { enumerable: true, get: function () { return render_context_1.createRenderContextFactory; } });
 // Decoration primitives (re-exported for convenience to engine code
 // outside the prose-pipeline subdirectory; the canonical types live
 // in `@sharpee/text-blocks`).
@@ -40,8 +44,6 @@ Object.defineProperty(exports, "handleRevealed", { enumerable: true, get: functi
 Object.defineProperty(exports, "handleGameMessage", { enumerable: true, get: function () { return handlers_1.handleGameMessage; } });
 Object.defineProperty(exports, "handleGenericEvent", { enumerable: true, get: function () { return handlers_1.handleGenericEvent; } });
 Object.defineProperty(exports, "handleGameStarted", { enumerable: true, get: function () { return handlers_1.handleGameStarted; } });
-Object.defineProperty(exports, "handleHelpDisplayed", { enumerable: true, get: function () { return handlers_1.handleHelpDisplayed; } });
-Object.defineProperty(exports, "handleAboutDisplayed", { enumerable: true, get: function () { return handlers_1.handleAboutDisplayed; } });
 Object.defineProperty(exports, "handleAudibilityHeard", { enumerable: true, get: function () { return handlers_1.handleAudibilityHeard; } });
 Object.defineProperty(exports, "tryProcessDomainEventMessage", { enumerable: true, get: function () { return handlers_1.tryProcessDomainEventMessage; } });
 Object.defineProperty(exports, "handleImplicitTake", { enumerable: true, get: function () { return handlers_1.handleImplicitTake; } });

package/prose-pipeline/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v1/packages/engine/src/prose-pipeline/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,8BAA8B;AAC9B,uCAAgE;AAAvD,yGAAA,aAAa,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAK3C,oEAAoE;AACpE,oEAAoE;AACpE,8BAA8B;AAC9B,6CAQuB;AAPrB,+GAAA,gBAAgB,OAAA;AAChB,+GAAA,gBAAgB,OAAA;AAChB,kHAAA,mBAAmB,OAAA;AACnB,wHAAA,yBAAyB,OAAA;AAM3B,oCAAoC;AACpC,0CAA+C;AAAtC,sGAAA,YAAY,OAAA;AACrB,sCAGuB;AAFrB,0GAAA,kBAAkB,OAAA;AAClB,wGAAA,gBAAgB,OAAA;AAElB,uCAAqE;AAA5D,uGAAA,WAAW,OAAA;AAAE,wGAAA,YAAY,OAAA;AAAE,wGAAA,YAAY,OAAA;AAShD,uCAaoB;AAZlB,iHAAA,qBAAqB,OAAA;AACrB,0GAAA,cAAc,OAAA;AACd,6GAAA,iBAAiB,OAAA;AACjB,8GAAA,kBAAkB,OAAA;AAClB,6GAAA,iBAAiB,OAAA;AACjB,+GAAA,mBAAmB,OAAA;AACnB,gHAAA,oBAAoB,OAAA;AACpB,iHAAA,qBAAqB,OAAA;AACrB,wHAAA,4BAA4B,OAAA;AAC5B,8GAAA,kBAAkB,OAAA;AAClB,+GAAA,mBAAmB,OAAA;AACnB,6GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/engine/src/prose-pipeline/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,8BAA8B;AAC9B,uCAAgE;AAAvD,yGAAA,aAAa,OAAA;AAAE,+GAAA,mBAAmB,OAAA;AAK3C,gEAAgE;AAChE,mDAK0B;AAJxB,mHAAA,iBAAiB,OAAA;AACjB,4HAAA,0BAA0B,OAAA;AAK5B,oEAAoE;AACpE,oEAAoE;AACpE,8BAA8B;AAC9B,6CAQuB;AAPrB,+GAAA,gBAAgB,OAAA;AAChB,+GAAA,gBAAgB,OAAA;AAChB,kHAAA,mBAAmB,OAAA;AACnB,wHAAA,yBAAyB,OAAA;AAM3B,oCAAoC;AACpC,0CAA+C;AAAtC,sGAAA,YAAY,OAAA;AACrB,sCAGuB;AAFrB,0GAAA,kBAAkB,OAAA;AAClB,wGAAA,gBAAgB,OAAA;AAElB,uCAAqE;AAA5D,uGAAA,WAAW,OAAA;AAAE,wGAAA,YAAY,OAAA;AAAE,wGAAA,YAAY,OAAA;AAShD,uCAWoB;AAVlB,iHAAA,qBAAqB,OAAA;AACrB,0GAAA,cAAc,OAAA;AACd,6GAAA,iBAAiB,OAAA;AACjB,8GAAA,kBAAkB,OAAA;AAClB,6GAAA,iBAAiB,OAAA;AACjB,iHAAA,qBAAqB,OAAA;AACrB,wHAAA,4BAA4B,OAAA;AAC5B,8GAAA,kBAAkB,OAAA;AAClB,+GAAA,mBAAmB,OAAA;AACnB,6GAAA,iBAAiB,OAAA"}

package/prose-pipeline/phrase-render.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Phrase-path rendering helper for the prose pipeline (ADR-192 §6, the cutover).
+ *
+ * Bridges a handler's `(messageId, params, blockKey)` to the language provider's
+ * `renderMessage` phrase pipeline, building the per-message `RenderContext` from
+ * the per-turn factory and re-keying the realized blocks to the handler's
+ * channel. The legacy `getMessage` string path remains in the handlers only as a
+ * fallback for world-less construction (some unit tests); it is removed in W7
+ * once nothing constructs the pipeline without a world.
+ *
+ * Public interface: `phraseAvailable`, `renderViaPhrase`.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-192 §6
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { HandlerContext } from './handlers/types';
+/**
+ * Whether the phrase path is wired for this turn: a render-context factory (the
+ * pipeline had a world) and a provider that implements the phrase API.
+ *
+ * @param context the handler context
+ * @returns true when `renderViaPhrase` can be used
+ */
+export declare function phraseAvailable(context: HandlerContext): boolean;
+/**
+ * Render a message through the phrase pipeline and re-key its blocks.
+ *
+ * Precondition: {@link phraseAvailable} is true.
+ *
+ * @param context the handler context (carries the render-context factory)
+ * @param messageId the message id to render
+ * @param params the message params (entity NounPhrases, scalars, …). The reserved
+ *   key `__slots__` (a `{ [slotKey]: Phrase[] }` map) is not a placeholder binding:
+ *   its phrases are staged into this message's turn slot store before realization,
+ *   so an action that knows its target (e.g. examine staging detail clauses) can
+ *   fill a `{slot:key}` in its own template without holding a render context at
+ *   report time (ADR-195 S2). Plain phrase data — save/replay-safe.
+ * @param blockKey the channel key to stamp on the realized blocks
+ * @returns the realized blocks re-keyed to `blockKey`, or `null` when the message
+ *   id is not registered (the caller applies its inline-text fallback)
+ */
+export declare function renderViaPhrase(context: HandlerContext, messageId: string, params: Record<string, unknown>, blockKey: string): ITextBlock[] | null;
+/**
+ * Flatten realized blocks to a single plain string (newlines between blocks).
+ * Used when a rendered message must be embedded into another message as a
+ * `{verbatim:…}` scalar param.
+ *
+ * @param blocks realized text blocks
+ * @returns the concatenated plain text
+ */
+export declare function flattenBlocks(blocks: ITextBlock[]): string;
+//# sourceMappingURL=phrase-render.d.ts.map

package/prose-pipeline/phrase-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phrase-render.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/engine/src/prose-pipeline/phrase-render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAOhE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,GACf,UAAU,EAAE,GAAG,IAAI,CAiCrB;AAQD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,CAE1D"}

package/prose-pipeline/phrase-render.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Phrase-path rendering helper for the prose pipeline (ADR-192 §6, the cutover).
+ *
+ * Bridges a handler's `(messageId, params, blockKey)` to the language provider's
+ * `renderMessage` phrase pipeline, building the per-message `RenderContext` from
+ * the per-turn factory and re-keying the realized blocks to the handler's
+ * channel. The legacy `getMessage` string path remains in the handlers only as a
+ * fallback for world-less construction (some unit tests); it is removed in W7
+ * once nothing constructs the pipeline without a world.
+ *
+ * Public interface: `phraseAvailable`, `renderViaPhrase`.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-192 §6
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.phraseAvailable = phraseAvailable;
+exports.renderViaPhrase = renderViaPhrase;
+exports.flattenBlocks = flattenBlocks;
+/**
+ * Whether the phrase path is wired for this turn: a render-context factory (the
+ * pipeline had a world) and a provider that implements the phrase API.
+ *
+ * @param context the handler context
+ * @returns true when `renderViaPhrase` can be used
+ */
+function phraseAvailable(context) {
+    const lp = context.languageProvider;
+    return (typeof context.makeRenderContext === 'function' &&
+        typeof lp?.renderMessage === 'function' &&
+        typeof lp?.getTemplate === 'function');
+}
+/**
+ * Render a message through the phrase pipeline and re-key its blocks.
+ *
+ * Precondition: {@link phraseAvailable} is true.
+ *
+ * @param context the handler context (carries the render-context factory)
+ * @param messageId the message id to render
+ * @param params the message params (entity NounPhrases, scalars, …). The reserved
+ *   key `__slots__` (a `{ [slotKey]: Phrase[] }` map) is not a placeholder binding:
+ *   its phrases are staged into this message's turn slot store before realization,
+ *   so an action that knows its target (e.g. examine staging detail clauses) can
+ *   fill a `{slot:key}` in its own template without holding a render context at
+ *   report time (ADR-195 S2). Plain phrase data — save/replay-safe.
+ * @param blockKey the channel key to stamp on the realized blocks
+ * @returns the realized blocks re-keyed to `blockKey`, or `null` when the message
+ *   id is not registered (the caller applies its inline-text fallback)
+ */
+function renderViaPhrase(context, messageId, params, blockKey) {
+    const lp = context.languageProvider;
+    // Unregistered id: events carry a messageId for semantic association even when
+    // no template exists; let the caller fall back to inline data.message/text.
+    if (lp.getTemplate(messageId) === undefined) {
+        return null;
+    }
+    const ctx = context.makeRenderContext(params);
+    // ADR-195 S2: stage any pre-built slot contributions the emitter attached to
+    // `params.__slots__` into this turn's slot store, before the template realizes,
+    // so a `{slot:key}` in this message picks them up. Bare content; the slot owns
+    // the connective grammar.
+    const preStaged = params.__slots__;
+    if (preStaged && ctx.contribute) {
+        for (const [slotKey, phrases] of Object.entries(preStaged)) {
+            for (const phrase of phrases) {
+                ctx.contribute(slotKey, phrase);
+            }
+        }
+    }
+    let blocks;
+    try {
+        blocks = lp.renderMessage(messageId, params, ctx);
+    }
+    catch (e) {
+        // A template that fails to parse at render time (unbound param, bad syntax)
+        // is an authoring error — warn and degrade to the caller's inline fallback
+        // rather than letting it abort the whole turn's prose.
+        // eslint-disable-next-line no-console
+        console.warn(`[phrase] renderMessage("${messageId}") failed: ${e.message}`);
+        return null;
+    }
+    return blocks.map((b) => (b.key === blockKey ? b : { ...b, key: blockKey }));
+}
+/** Flatten one content node to its plain text (recursing through decorations). */
+function textOf(node) {
+    if (typeof node === 'string')
+        return node;
+    return (node.content ?? []).map(textOf).join('');
+}
+/**
+ * Flatten realized blocks to a single plain string (newlines between blocks).
+ * Used when a rendered message must be embedded into another message as a
+ * `{verbatim:…}` scalar param.
+ *
+ * @param blocks realized text blocks
+ * @returns the concatenated plain text
+ */
+function flattenBlocks(blocks) {
+    return blocks.map((b) => b.content.map(textOf).join('')).join('\n');
+}
+//# sourceMappingURL=phrase-render.js.map

package/prose-pipeline/phrase-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phrase-render.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/engine/src/prose-pipeline/phrase-render.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AAYH,0CAOC;AAmBD,0CAsCC;AAgBD,sCAEC;AAzFD;;;;;;GAMG;AACH,SAAgB,eAAe,CAAC,OAAuB;IACrD,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IACpC,OAAO,CACL,OAAO,OAAO,CAAC,iBAAiB,KAAK,UAAU;QAC/C,OAAO,EAAE,EAAE,aAAa,KAAK,UAAU;QACvC,OAAO,EAAE,EAAE,WAAW,KAAK,UAAU,CACtC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,SAAgB,eAAe,CAC7B,OAAuB,EACvB,SAAiB,EACjB,MAA+B,EAC/B,QAAgB;IAEhB,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAiB,CAAC;IACrC,+EAA+E;IAC/E,4EAA4E;IAC5E,IAAI,EAAE,CAAC,WAAY,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAkB,CAAC,MAAM,CAAC,CAAC;IAE/C,6EAA6E;IAC7E,gFAAgF;IAChF,+EAA+E;IAC/E,0BAA0B;IAC1B,MAAM,SAAS,GAAG,MAAM,CAAC,SAAkD,CAAC;IAC5E,IAAI,SAAS,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;QAChC,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3D,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;gBAC7B,GAAG,CAAC,UAAU,CAAC,OAAO,EAAE,MAA8C,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,EAAE,CAAC,aAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,4EAA4E;QAC5E,2EAA2E;QAC3E,uDAAuD;QACvD,sCAAsC;QACtC,OAAO,CAAC,IAAI,CAAC,2BAA2B,SAAS,cAAe,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QACvF,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,kFAAkF;AAClF,SAAS,MAAM,CAAC,IAAiB;IAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,aAAa,CAAC,MAAoB;IAChD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACtE,CAAC"}

package/prose-pipeline/pipeline.d.ts

@@ -10,7 +10,7 @@
  *                time blocks return here they already carry parsed
  *                bracket decorations and final `className`s.
  *
- * Public interface: `class ProsePipeline implements ITextService`.
+ * Public interface: `class ProsePipeline implements IProsePipeline`.
  * Engine constructs one instance during `setStory()` and calls
  * `processTurn` per turn (same three call sites as the retiring
  * `TextService`).
@@ -24,7 +24,8 @@
 import type { ITextBlock } from '@sharpee/text-blocks';
 import type { LanguageProvider } from '@sharpee/if-domain';
 import type { ISemanticEvent } from '@sharpee/core';
-import type { ITextService } from './types';
+import { type WorldModelLike } from './render-context';
+import type { IProsePipeline, SlotContributor } from './types';
 /**
  * Engine-internal prose pipeline.
  *
@@ -34,9 +35,26 @@ import type { ITextService } from './types';
  * the meta-command path (same three sites the retired
  * `TextService.processTurn` had).
  */
-export declare class ProsePipeline implements ITextService {
+export declare class ProsePipeline implements IProsePipeline {
     private readonly languageProvider;
-    constructor(languageProvider: LanguageProvider);
+    private readonly world?;
+    /** Realize-time slot contributors, run in registration order each turn (ADR-195 §3). */
+    private readonly slotContributors;
+    /**
+     * @param languageProvider the active language provider (template → text)
+     * @param world the read-only world model; when supplied, each turn builds a
+     *   phrase-pipeline render-context factory (ADR-192, W2). Optional so legacy
+     *   and test construction (string path only) keeps working without a world.
+     */
+    constructor(languageProvider: LanguageProvider, world?: WorldModelLike);
+    /**
+     * Register a realize-time slot contributor (ADR-195 §3). Contributors run once
+     * per turn at the top of `processTurn`, in registration order; that order feeds
+     * the `(order, insertion)` tie-break of the slot store.
+     *
+     * @param contributor the slot contributor to run each turn.
+     */
+    registerSlotContributor(contributor: SlotContributor): void;
     processTurn(events: ISemanticEvent[]): ITextBlock[];
     /**
      * Route an event to its handler family.
@@ -54,5 +72,5 @@ export declare class ProsePipeline implements ITextService {
  * package exposed; callers can swap one for the other without
  * changing call shapes.
  */
-export declare function createProsePipeline(languageProvider: LanguageProvider): ITextService;
+export declare function createProsePipeline(languageProvider: LanguageProvider, world?: WorldModelLike): IProsePipeline;
 //# sourceMappingURL=pipeline.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v1/packages/engine/src/prose-pipeline/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;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;AAqBpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,YAAY;IAChD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;gBAExC,gBAAgB,EAAE,gBAAgB;IAS9C,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE;IAgBnD;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;CA6CvB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,gBAAgB,GACjC,YAAY,CAEd"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/engine/src/prose-pipeline/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;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;AAIpD,OAAO,EAIL,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAiB1B,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/D;;;;;;;;GAQG;AACH,qBAAa,aAAc,YAAW,cAAc;IAClD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAiB;IACxC,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAE1D;;;;;OAKG;gBACS,gBAAgB,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,cAAc;IAUtE;;;;;;OAMG;IACH,uBAAuB,CAAC,WAAW,EAAE,eAAe,GAAG,IAAI;IAI3D,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,UAAU,EAAE;IA2CnD;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;CAkDvB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,gBAAgB,EAAE,gBAAgB,EAClC,KAAK,CAAC,EAAE,cAAc,GACrB,cAAc,CAEhB"}

package/prose-pipeline/pipeline.js

@@ -11,7 +11,7 @@
  *                time blocks return here they already carry parsed
  *                bracket decorations and final `className`s.
  *
- * Public interface: `class ProsePipeline implements ITextService`.
+ * Public interface: `class ProsePipeline implements IProsePipeline`.
  * Engine constructs one instance during `setStory()` and calls
  * `processTurn` per turn (same three call sites as the retiring
  * `TextService`).
@@ -27,12 +27,12 @@ exports.ProsePipeline = void 0;
 exports.createProsePipeline = createProsePipeline;
 const filter_1 = require("./stages/filter");
 const sort_1 = require("./stages/sort");
+const render_context_1 = require("./render-context");
 const room_1 = require("./handlers/room");
 const revealed_1 = require("./handlers/revealed");
 const generic_1 = require("./handlers/generic");
 const game_1 = require("./handlers/game");
-const help_1 = require("./handlers/help");
-const about_1 = require("./handlers/about");
+const platform_1 = require("./handlers/platform");
 const audibility_1 = require("./handlers/audibility");
 const domain_message_1 = require("./handlers/domain-message");
 const implicit_take_1 = require("./handlers/implicit-take");
@@ -49,18 +49,59 @@ const client_query_1 = require("./handlers/client-query");
  */
 class ProsePipeline {
     languageProvider;
-    constructor(languageProvider) {
+    world;
+    /** Realize-time slot contributors, run in registration order each turn (ADR-195 §3). */
+    slotContributors = [];
+    /**
+     * @param languageProvider the active language provider (template → text)
+     * @param world the read-only world model; when supplied, each turn builds a
+     *   phrase-pipeline render-context factory (ADR-192, W2). Optional so legacy
+     *   and test construction (string path only) keeps working without a world.
+     */
+    constructor(languageProvider, world) {
         if (!languageProvider) {
             throw new Error('ProsePipeline requires a LanguageProvider; got null/undefined.');
         }
         this.languageProvider = languageProvider;
+        this.world = world;
+    }
+    /**
+     * Register a realize-time slot contributor (ADR-195 §3). Contributors run once
+     * per turn at the top of `processTurn`, in registration order; that order feeds
+     * the `(order, insertion)` tie-break of the slot store.
+     *
+     * @param contributor the slot contributor to run each turn.
+     */
+    registerSlotContributor(contributor) {
+        this.slotContributors.push(contributor);
     }
     processTurn(events) {
         const filtered = (0, filter_1.filterEvents)(events);
         const sorted = (0, sort_1.sortEventsForProse)(filtered);
+        const makeRenderContext = this.world
+            ? (0, render_context_1.createRenderContextFactory)((0, render_context_1.createRenderWorld)(this.world), this.languageProvider.getLocaleSettings?.() ?? {}, {
+                person: this.languageProvider.getNarrativePerson?.() ?? 'third',
+                playerId: this.world.getPlayer()?.id,
+            }, 
+            // ADR-196: persistent text-state store backed by the world's `textState`
+            // capability — survives save/restore, unlike the turn-scoped seams.
+            new render_context_1.WorldTextStateStore(this.world))
+            : undefined;
         const context = {
             languageProvider: this.languageProvider,
+            makeRenderContext,
         };
+        // ADR-195 §3: stage realize-time slot contributions BEFORE any message
+        // realizes. Each contributor runs once, in registration order, against a turn
+        // RenderContext whose `contribute` writes the per-turn store every later
+        // message context peeks via `slotContributions`. World-less pipelines have no
+        // factory, so there is nothing to stage into — contributors do not run.
+        if (makeRenderContext && this.slotContributors.length > 0) {
+            const staging = makeRenderContext({});
+            for (const contributor of this.slotContributors) {
+                contributor(staging);
+            }
+        }
         const blocks = [];
         for (const event of sorted) {
             blocks.push(...this.routeToHandler(event, context));
@@ -89,10 +130,11 @@ class ProsePipeline {
                 return (0, generic_1.handleGameMessage)(event, context);
             case 'if.event.revealed':
                 return (0, revealed_1.handleRevealed)(event, context);
-            case 'if.event.help_displayed':
-                return (0, help_1.handleHelpDisplayed)(event, context);
-            case 'if.event.about_displayed':
-                return (0, about_1.handleAboutDisplayed)(event, context);
+            // if.event.help_displayed / if.event.about_displayed carry messageIds
+            // with lang-en-us templates (if.action.help.*, if.action.about.success)
+            // and render via tryProcessDomainEventMessage above; their dedicated
+            // handlers (help.text/about.text blocks MAIN_KEYS never routed) were
+            // removed 2026-07-02 (dungeo regression findings P3).
             case 'sound.audibility.heard':
                 return (0, audibility_1.handleAudibilityHeard)(event, context);
             case 'if.event.implicit_take':
@@ -102,6 +144,11 @@ class ProsePipeline {
             case 'client.query':
                 return (0, client_query_1.handleClientQuery)(event, context);
             default:
+                // Platform lifecycle events carry `payload` (not `data`) and render
+                // via the message registered under the event type itself.
+                if (event.type.startsWith('platform.')) {
+                    return (0, platform_1.handlePlatformEvent)(event, context);
+                }
                 return (0, generic_1.handleGenericEvent)(event, context);
         }
     }
@@ -114,7 +161,7 @@ exports.ProsePipeline = ProsePipeline;
  * package exposed; callers can swap one for the other without
  * changing call shapes.
  */
-function createProsePipeline(languageProvider) {
-    return new ProsePipeline(languageProvider);
+function createProsePipeline(languageProvider, world) {
+    return new ProsePipeline(languageProvider, world);
 }
 //# sourceMappingURL=pipeline.js.map

package/prose-pipeline/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v1/packages/engine/src/prose-pipeline/pipeline.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AA6HH,kDAIC;AA3HD,4CAA+C;AAC/C,wCAAmD;AAGnD,0CAAwD;AACxD,kDAAqD;AACrD,gDAG4B;AAC5B,0CAAoD;AACpD,0CAAsD;AACtD,4CAAwD;AACxD,sDAA8D;AAC9D,8DAAyE;AACzE,4DAA8D;AAC9D,8DAAgE;AAChE,0DAA4D;AAI5D;;;;;;;;GAQG;AACH,MAAa,aAAa;IACP,gBAAgB,CAAmB;IAEpD,YAAY,gBAAkC;QAC5C,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CACb,gEAAgE,CACjE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC3C,CAAC;IAED,WAAW,CAAC,MAAwB;QAClC,MAAM,QAAQ,GAAG,IAAA,qBAAY,EAAC,MAAM,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,IAAA,yBAAkB,EAAC,QAAQ,CAAC,CAAC;QAE5C,MAAM,OAAO,GAAmB;YAC9B,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC;QAEF,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QACtD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;OAMG;IACK,cAAc,CACpB,KAAqB,EACrB,OAAuB;QAEvB,MAAM,eAAe,GAAG,IAAA,6CAA4B,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACrE,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO,eAAe,CAAC;QACzB,CAAC;QAED,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,cAAc;gBACjB,OAAO,IAAA,wBAAiB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE3C,KAAK,2BAA2B,CAAC;YACjC,KAAK,2BAA2B;gBAC9B,OAAO,IAAA,4BAAqB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE/C,KAAK,cAAc;gBACjB,OAAO,IAAA,2BAAiB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE3C,KAAK,mBAAmB;gBACtB,OAAO,IAAA,yBAAc,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAExC,KAAK,yBAAyB;gBAC5B,OAAO,IAAA,0BAAmB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE7C,KAAK,0BAA0B;gBAC7B,OAAO,IAAA,4BAAoB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE9C,KAAK,wBAAwB;gBAC3B,OAAO,IAAA,kCAAqB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE/C,KAAK,wBAAwB;gBAC3B,OAAO,IAAA,kCAAkB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE5C,KAAK,gBAAgB;gBACnB,OAAO,IAAA,oCAAmB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE7C,KAAK,cAAc;gBACjB,OAAO,IAAA,gCAAiB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAE3C;gBACE,OAAO,IAAA,4BAAkB,EAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;CACF;AAhFD,sCAgFC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,gBAAkC;IAElC,OAAO,IAAI,aAAa,CAAC,gBAAgB,CAAC,CAAC;AAC7C,CAAC"}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/engine/src/prose-pipeline/pipeline.ts"],"names":[],"mappings":"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"}

package/prose-pipeline/render-context.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Per-turn RenderContext runtime for the phrase pipeline (ADR-192 §6, W2).
+ *
+ * The Assembler realizes a phrase tree against a `RenderContext`: a read-only
+ * world, the bound params, locale settings, and the declared seams
+ * (`reference` / `textState` / `contribute` + `slotContributions`). This module
+ * supplies the engine's runtime for that contract — a thin adapter over the world
+ * model, the live turn-scoped slot store (ADR-195), and the live persistent
+ * `textState` store (ADR-196). The engine owns this per turn. The ONE sanctioned
+ * mutation is the `textState` capability write (ADR-196 §4 — the declared exception
+ * ADR-192 §7 reserved for deterministic `Choice` variation); entity and spatial
+ * state are never touched here.
+ *
+ * Public interface: `createRenderWorld`, `createRenderContextFactory`,
+ * `WorldTextStateStore`, `WorldModelLike`. The factory binds the per-turn
+ * invariants (world, settings, seams) once and yields a per-message
+ * `RenderContext` by adding that message's params.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-192 §6 (report pipeline / render context)
+ * @see ADR-195 (contribute seam) / ADR-196 (textState seam) / ADR-197 (reference seam)
+ */
+import type { EntityId, IEntity } from '@sharpee/core';
+import type { LocaleSettings, NarrativeAgreement, RenderContext, RenderWorld, TextStateStore } from '@sharpee/if-domain';
+/**
+ * The minimal world surface the render world adapter needs. The engine's
+ * `WorldModel` satisfies this structurally; declaring only the methods the
+ * pipeline reads keeps it honest. The pipeline never mutates entity/spatial
+ * state — the one sanctioned write is the `textState` capability (ADR-196 §4),
+ * exposed through the OPTIONAL capability accessors below. They are optional
+ * (the ADR-195 optional-seam precedent) so test mocks that wire only the read
+ * methods keep compiling; a world without them degrades to an empty text-state
+ * store (no persistence, `Choice` starts at counter 0 — AC-9).
+ */
+export interface WorldModelLike {
+    getEntity(id: EntityId): IEntity | undefined;
+    getContents(containerId: EntityId): IEntity[];
+    getContainingRoom(entityId: EntityId): IEntity | undefined;
+    /** The player entity, for narrative verb-person agreement (ADR-199 §4 B). */
+    getPlayer(): IEntity | undefined;
+    /** Read a capability's data map (ADR-196 text-state read). */
+    getCapability?(name: string): Record<string, unknown> | undefined;
+    /** Merge into a capability's data map (ADR-196 text-state write — the one sanctioned mutation). */
+    updateCapability?(name: string, updates: Record<string, unknown>): void;
+    /** Whether a capability is registered (guards the defensive self-register). */
+    hasCapability?(name: string): boolean;
+    /** Register a capability if absent (defensive — the engine normally registers `textState` at setup). */
+    registerCapability?(name: string, registration?: {
+        initialData?: Record<string, unknown>;
+    }): void;
+}
+/**
+ * Wrap a world model as the read-only `RenderWorld` the Assembler consumes.
+ *
+ * Supplies the entity→`NounPhrase` bridge (`nounPhraseFor`, ADR-194) by delegating
+ * to stdlib's producer — the engine may depend on stdlib, lang-en-us may not, so the
+ * bridge crosses here rather than in the Assembler.
+ *
+ * @param world the live world model (read-only access only)
+ * @returns a `RenderWorld` delegating to the model's lookup methods
+ */
+export declare function createRenderWorld(world: WorldModelLike): RenderWorld;
+/**
+ * The persistent per-`(entityId, messageKey)` text-state store (ADR-196 §4).
+ *
+ * Backed by the `textState` world capability, which serializes with the world —
+ * so a `Choice`'s cycle index / trigger count / sticky pick survives turns and
+ * save/restore (S13–S14). The engine registers the capability at setup
+ * (`game-engine.ts`); this store also self-registers defensively so it works in
+ * tests and standalone render contexts.
+ *
+ * A world that does not expose the optional capability accessors degrades to the
+ * empty-store behavior (no persistence) — AC-9.
+ */
+export declare class WorldTextStateStore implements TextStateStore {
+    private readonly world;
+    constructor(world: WorldModelLike);
+    get(entityId: EntityId, messageKey: string): number | undefined;
+    set(entityId: EntityId, messageKey: string, value: number): void;
+}
+/**
+ * A per-message render-context builder bound to a turn's invariants.
+ *
+ * @param params the message's parameter/producer bindings
+ * @returns a `RenderContext` carrying those params plus the bound world,
+ *   settings, and per-turn seams
+ */
+export type RenderContextFactory = (params: Record<string, unknown>) => RenderContext;
+/**
+ * Build the per-turn render-context factory.
+ *
+ * World, locale settings, and the seams are the turn's invariants and are
+ * captured once; only `params` vary per message, so the returned factory is
+ * called once per rendered message. The `contribute` / `slotContributions` pair
+ * shares one turn-scoped {@link TurnSlotStore} across every message context, so a
+ * slot contribution staged while building one message is visible when another
+ * message's `{slot:key}` realizes (ADR-195 §2).
+ *
+ * @param world the read-only render world (see {@link createRenderWorld})
+ * @param settings the locale realization settings for this turn
+ * @param narrative the player id + narrative person for verb agreement (ADR-199 §4 B)
+ * @param textState the persistent text-state store backing `Choice` (ADR-196 §4);
+ *   defaults to the empty store for world-less / string-path callers
+ * @returns a factory that yields a `RenderContext` for a message's params
+ */
+export declare function createRenderContextFactory(world: RenderWorld, settings: LocaleSettings, narrative: NarrativeAgreement, textState?: TextStateStore): RenderContextFactory;
+//# sourceMappingURL=render-context.d.ts.map

package/prose-pipeline/render-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-context.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee_v2/packages/engine/src/prose-pipeline/render-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EACV,cAAc,EAEd,kBAAkB,EAElB,aAAa,EACb,WAAW,EAEX,cAAc,EAEf,MAAM,oBAAoB,CAAC;AAQ5B;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAC7C,WAAW,CAAC,WAAW,EAAE,QAAQ,GAAG,OAAO,EAAE,CAAC;IAC9C,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IAC3D,6EAA6E;IAC7E,SAAS,IAAI,OAAO,GAAG,SAAS,CAAC;IACjC,8DAA8D;IAC9D,aAAa,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAClE,mGAAmG;IACnG,gBAAgB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxE,+EAA+E;IAC/E,aAAa,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACtC,wGAAwG;IACxG,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;CACnG;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,cAAc,GAAG,WAAW,CAUpE;AAmCD;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAoB,YAAW,cAAc;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,cAAc;IAElD,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK/D,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;CAcjE;AAmDD;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,GAAG,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,aAAa,CAAC;AAEnB;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,kBAAkB,EAC7B,SAAS,GAAE,cAA0C,GACpD,oBAAoB,CAuBtB"}