@sharpee/engine 0.9.113 → 1.0.8

package/prose-pipeline/decorations/parser.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Bracket parser — markup string → structured `TextContent[]` tree.
+ *
+ * Public interface: `parseDecorations(template) → TextContent[]`.
+ * Pure function; same input always yields same output.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Markup syntax
+ * @see ADR-174 §Internal interfaces
+ * @see ADR-174 acceptance criteria AC-1..AC-5, AC-10..AC-12
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDecorations = parseDecorations;
+const resolver_1 = require("./resolver");
+const platform_vocabulary_1 = require("./platform-vocabulary");
+/**
+ * Parse a template string into a `TextContent[]` tree.
+ *
+ * Bracket markup `[name:content]` becomes an `IDecoration` whose
+ * `className` is the result of `resolveClassName(name)`. Plain runs
+ * stay as strings. Nesting recurses. Escape sequences `\[`, `\]`,
+ * `\\` produce literal characters.
+ *
+ * Forgiving rules (ADR-174 AC-10..AC-12):
+ *  - An unclosed `[` is treated as a literal character; the tail of
+ *    the string remains unparsed text.
+ *  - A bracket without `:` (e.g., `[em world]`) is emitted as literal
+ *    `[em world]` — no decoration created.
+ *  - A bracket with empty class name (e.g., `[:world]`) yields the
+ *    parsed inner content directly, with no decoration wrapper.
+ *
+ * @param template Raw template string, post message-id resolution.
+ * @returns Flat array of strings and decorations.
+ */
+function parseDecorations(template) {
+    if (!template)
+        return [];
+    const result = [];
+    let current = '';
+    let i = 0;
+    const flush = () => {
+        if (current.length > 0) {
+            result.push(current);
+            current = '';
+        }
+    };
+    while (i < template.length) {
+        const char = template[i];
+        const escapeChar = consumeEscape(template, i);
+        if (escapeChar !== null) {
+            current += escapeChar;
+            i += 2;
+            continue;
+        }
+        if (char === '[') {
+            const bracket = parseBracketAt(template, i);
+            if (bracket.kind === 'literal') {
+                current += bracket.text;
+                i = bracket.nextIndex;
+                continue;
+            }
+            flush();
+            if (bracket.kind === 'children') {
+                result.push(...bracket.children);
+            }
+            else {
+                result.push(bracket.decoration);
+            }
+            i = bracket.nextIndex;
+            continue;
+        }
+        current += char;
+        i++;
+    }
+    flush();
+    return result;
+}
+/**
+ * Inspect `template[i..i+1]` for an escape sequence (`\[`, `\]`,
+ * `\\`). Returns the literal character to emit, or null if no escape
+ * applies.
+ */
+function consumeEscape(template, i) {
+    if (template[i] !== '\\' || i + 1 >= template.length)
+        return null;
+    const next = template[i + 1];
+    if (next !== '[' && next !== ']' && next !== '\\')
+        return null;
+    return next;
+}
+/**
+ * Parse the `[...]` segment starting at `openIndex`. Caller has
+ * already verified `template[openIndex] === '['`.
+ *
+ * Outcomes (per ADR-174 AC-10..AC-12):
+ *  - `literal` — unclosed bracket or bracket without `:` (the whole
+ *    segment is treated as plain text).
+ *  - `children` — empty class name (`[:content]`); inner content is
+ *    parsed and inlined without a wrapping decoration.
+ *  - `decoration` — well-formed `[name:content]`; produces a
+ *    structured `IDecoration`.
+ */
+function parseBracketAt(template, openIndex) {
+    const closeIndex = findMatchingBracket(template, openIndex);
+    if (closeIndex === -1) {
+        // AC-10: unclosed bracket → emit the `[` literal, advance one char.
+        return { kind: 'literal', text: template[openIndex], nextIndex: openIndex + 1 };
+    }
+    const inner = template.slice(openIndex + 1, closeIndex);
+    const colonIndex = indexOfUnescapedColon(inner);
+    const nextIndex = closeIndex + 1;
+    if (colonIndex === -1) {
+        // ADR-183: a colon-less `[name]` is a void macro (e.g. `[br]`, `[p]`) iff the
+        // name is registered; otherwise AC-11 applies and the whole segment is literal.
+        if (platform_vocabulary_1.VOID_MACROS.has(inner)) {
+            return {
+                kind: 'decoration',
+                decoration: { className: (0, resolver_1.resolveClassName)(inner), content: [] },
+                nextIndex,
+            };
+        }
+        return { kind: 'literal', text: template.slice(openIndex, nextIndex), nextIndex };
+    }
+    const namePart = inner.slice(0, colonIndex);
+    const innerContent = inner.slice(colonIndex + 1);
+    // ADR-183: an optional `=value` in the name segment carries a parameter
+    // (e.g. `[center=50:…]`). Split on the first `=`; the value may itself contain
+    // `=`. Content (after the colon) is unaffected.
+    let rawName = namePart;
+    let value;
+    const eqIndex = namePart.indexOf('=');
+    if (eqIndex !== -1) {
+        rawName = namePart.slice(0, eqIndex);
+        value = namePart.slice(eqIndex + 1);
+    }
+    if (rawName === '') {
+        // AC-12: empty class name → emit inner content as plain entries (value ignored).
+        return { kind: 'children', children: parseDecorations(innerContent), nextIndex };
+    }
+    const decoration = value !== undefined
+        ? { className: (0, resolver_1.resolveClassName)(rawName), content: parseDecorations(innerContent), value }
+        : { className: (0, resolver_1.resolveClassName)(rawName), content: parseDecorations(innerContent) };
+    return { kind: 'decoration', decoration, nextIndex };
+}
+/**
+ * Find the matching `]` for the `[` at `openIndex`, respecting
+ * nested brackets and `\\[` / `\\]` escapes. Returns -1 if no match
+ * exists (string ends mid-bracket).
+ */
+function findMatchingBracket(text, openIndex) {
+    let depth = 1;
+    let i = openIndex + 1;
+    while (i < text.length) {
+        const char = text[i];
+        if (char === '\\' && i + 1 < text.length) {
+            i += 2;
+            continue;
+        }
+        if (char === '[') {
+            depth++;
+        }
+        else if (char === ']') {
+            depth--;
+            if (depth === 0)
+                return i;
+        }
+        i++;
+    }
+    return -1;
+}
+/**
+ * Find the first unescaped `:` in `inner`. Returns -1 if none.
+ *
+ * Inside the `name:content` payload of a bracket, `\\:` is treated as
+ * a literal colon — although there's no current need to escape colons
+ * (they're not part of the platform vocabulary), the safer parse rule
+ * is to treat backslash as a one-character escape uniformly.
+ */
+function indexOfUnescapedColon(inner) {
+    let i = 0;
+    while (i < inner.length) {
+        const char = inner[i];
+        if (char === '\\' && i + 1 < inner.length) {
+            i += 2;
+            continue;
+        }
+        if (char === ':')
+            return i;
+        i++;
+    }
+    return -1;
+}
+//# sourceMappingURL=parser.js.map

package/prose-pipeline/decorations/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/decorations/parser.ts"],"names":[],"mappings":"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"}

package/prose-pipeline/decorations/platform-vocabulary.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Platform decoration vocabulary — closed enumeration of names the
+ * platform recognises and prefixes with `sharpee-` when emitting class
+ * names on the wire.
+ *
+ * Public interface: `PLATFORM_VOCABULARY` (frozen Set), consumed by
+ * the resolver in this directory. No external package imports this.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Closed platform vocabulary
+ */
+declare const VOCABULARY_NAMES: readonly ["em", "strong", "u", "st", "code", "super", "sub", "item", "npc", "room", "direction", "command", "quote", "color-red", "color-blue", "color-green", "color-yellow", "color-magenta", "color-cyan", "color-white", "color-grey", "color-black", "bgcolor-red", "bgcolor-blue", "bgcolor-green", "bgcolor-yellow", "bgcolor-magenta", "bgcolor-cyan", "bgcolor-white", "bgcolor-grey", "bgcolor-black", "size-small", "size-large", "font-mono", "br", "p", "indent", "center", "right"];
+/**
+ * Names that take **no content** — written `[br]` / `[p]` (no colon). The
+ * parser treats a colon-less `[name]` as a void decoration iff `name` is
+ * listed here; any other colon-less bracket stays literal (ADR-174 AC-11).
+ *
+ * @see ADR-183 §1 — Vocabulary, §2 — Syntax
+ */
+export declare const VOID_MACROS: ReadonlySet<string>;
+/**
+ * Frozen set of every name the platform reserves under the `sharpee-`
+ * namespace. Adding a new entry requires both updating this list and
+ * shipping a corresponding `.sharpee-{name}` rule in the platform CSS.
+ */
+export declare const PLATFORM_VOCABULARY: ReadonlySet<string>;
+/**
+ * Type-level export of every recognised name; useful for tests that
+ * iterate the closed enumeration.
+ */
+export type PlatformVocabularyName = (typeof VOCABULARY_NAMES)[number];
+export declare const PLATFORM_VOCABULARY_NAMES: ReadonlyArray<PlatformVocabularyName>;
+export {};
+//# sourceMappingURL=platform-vocabulary.d.ts.map

package/prose-pipeline/decorations/platform-vocabulary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-vocabulary.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/decorations/platform-vocabulary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,QAAA,MAAM,gBAAgB,meAuDZ,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,WAAW,CAAC,MAAM,CAE3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAEnD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,eAAO,MAAM,yBAAyB,EAAE,aAAa,CAAC,sBAAsB,CACtC,CAAC"}

package/prose-pipeline/decorations/platform-vocabulary.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Platform decoration vocabulary — closed enumeration of names the
+ * platform recognises and prefixes with `sharpee-` when emitting class
+ * names on the wire.
+ *
+ * Public interface: `PLATFORM_VOCABULARY` (frozen Set), consumed by
+ * the resolver in this directory. No external package imports this.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Closed platform vocabulary
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLATFORM_VOCABULARY_NAMES = exports.PLATFORM_VOCABULARY = exports.VOID_MACROS = void 0;
+const VOCABULARY_NAMES = [
+    // Switches — apply on/off, no parameter.
+    'em',
+    'strong',
+    'u',
+    'st',
+    'code',
+    'super',
+    'sub',
+    // IF-semantic — entity classifiers retained from ADR-091.
+    'item',
+    'npc',
+    'room',
+    'direction',
+    'command',
+    'quote',
+    // Class vocabulary — color-* starter palette.
+    'color-red',
+    'color-blue',
+    'color-green',
+    'color-yellow',
+    'color-magenta',
+    'color-cyan',
+    'color-white',
+    'color-grey',
+    'color-black',
+    // Class vocabulary — bgcolor-* matching set.
+    'bgcolor-red',
+    'bgcolor-blue',
+    'bgcolor-green',
+    'bgcolor-yellow',
+    'bgcolor-magenta',
+    'bgcolor-cyan',
+    'bgcolor-white',
+    'bgcolor-grey',
+    'bgcolor-black',
+    // Class vocabulary — size-*.
+    'size-small',
+    'size-large',
+    // Class vocabulary — font-*.
+    'font-mono',
+    // Layout macros (ADR-183). `br`/`p` are void (no content); `indent`/`center`
+    // accept an optional `=value` (level / width %); `right` is plain. All
+    // presentation lives in the platform stylesheet, author-overridable en masse.
+    'br',
+    'p',
+    'indent',
+    'center',
+    'right',
+];
+/**
+ * Names that take **no content** — written `[br]` / `[p]` (no colon). The
+ * parser treats a colon-less `[name]` as a void decoration iff `name` is
+ * listed here; any other colon-less bracket stays literal (ADR-174 AC-11).
+ *
+ * @see ADR-183 §1 — Vocabulary, §2 — Syntax
+ */
+exports.VOID_MACROS = Object.freeze(new Set(['br', 'p']));
+/**
+ * Frozen set of every name the platform reserves under the `sharpee-`
+ * namespace. Adding a new entry requires both updating this list and
+ * shipping a corresponding `.sharpee-{name}` rule in the platform CSS.
+ */
+exports.PLATFORM_VOCABULARY = Object.freeze(new Set(VOCABULARY_NAMES));
+exports.PLATFORM_VOCABULARY_NAMES = Object.freeze([...VOCABULARY_NAMES]);
+//# sourceMappingURL=platform-vocabulary.js.map

package/prose-pipeline/decorations/platform-vocabulary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-vocabulary.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/decorations/platform-vocabulary.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAEH,MAAM,gBAAgB,GAAG;IACvB,yCAAyC;IACzC,IAAI;IACJ,QAAQ;IACR,GAAG;IACH,IAAI;IACJ,MAAM;IACN,OAAO;IACP,KAAK;IAEL,0DAA0D;IAC1D,MAAM;IACN,KAAK;IACL,MAAM;IACN,WAAW;IACX,SAAS;IACT,OAAO;IAEP,8CAA8C;IAC9C,WAAW;IACX,YAAY;IACZ,aAAa;IACb,cAAc;IACd,eAAe;IACf,YAAY;IACZ,aAAa;IACb,YAAY;IACZ,aAAa;IAEb,6CAA6C;IAC7C,aAAa;IACb,cAAc;IACd,eAAe;IACf,gBAAgB;IAChB,iBAAiB;IACjB,cAAc;IACd,eAAe;IACf,cAAc;IACd,eAAe;IAEf,6BAA6B;IAC7B,YAAY;IACZ,YAAY;IAEZ,6BAA6B;IAC7B,WAAW;IAEX,6EAA6E;IAC7E,uEAAuE;IACvE,8EAA8E;IAC9E,IAAI;IACJ,GAAG;IACH,QAAQ;IACR,QAAQ;IACR,OAAO;CACC,CAAC;AAEX;;;;;;GAMG;AACU,QAAA,WAAW,GAAwB,MAAM,CAAC,MAAM,CAC3D,IAAI,GAAG,CAAS,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAC7B,CAAC;AAEF;;;;GAIG;AACU,QAAA,mBAAmB,GAAwB,MAAM,CAAC,MAAM,CACnE,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAClC,CAAC;AAQW,QAAA,yBAAyB,GACpC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC"}

package/prose-pipeline/decorations/resolver.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Class-name resolver — bare bracket name → final CSS class name.
+ *
+ * Public interface: `resolveClassName`. Used by the parser to settle
+ * the platform-vs-author distinction at parse time so the wire shape
+ * carries renderer-ready strings.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Platform vs author classes
+ * @see ADR-174 §Internal interfaces
+ */
+/**
+ * Resolve a bracketed name to its final CSS class name.
+ *
+ * Platform names (those listed in `PLATFORM_VOCABULARY`) receive the
+ * `sharpee-` prefix. Author names — anything else — pass through
+ * verbatim. Empty input returns the empty string; the caller is
+ * responsible for the AC-12 no-op-wrapper behavior, since the
+ * resolver is a pure mapping.
+ *
+ * @param rawName Bare name as written between `[` and `:` in the
+ *                template, e.g., `em`, `thief-taunt`.
+ * @returns Final class name to place on the wire as
+ *          `IDecoration.className`.
+ */
+export declare function resolveClassName(rawName: string): string;
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/decorations/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMxD"}

package/prose-pipeline/decorations/resolver.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Class-name resolver — bare bracket name → final CSS class name.
+ *
+ * Public interface: `resolveClassName`. Used by the parser to settle
+ * the platform-vs-author distinction at parse time so the wire shape
+ * carries renderer-ready strings.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Platform vs author classes
+ * @see ADR-174 §Internal interfaces
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveClassName = resolveClassName;
+const platform_vocabulary_1 = require("./platform-vocabulary");
+/**
+ * Resolve a bracketed name to its final CSS class name.
+ *
+ * Platform names (those listed in `PLATFORM_VOCABULARY`) receive the
+ * `sharpee-` prefix. Author names — anything else — pass through
+ * verbatim. Empty input returns the empty string; the caller is
+ * responsible for the AC-12 no-op-wrapper behavior, since the
+ * resolver is a pure mapping.
+ *
+ * @param rawName Bare name as written between `[` and `:` in the
+ *                template, e.g., `em`, `thief-taunt`.
+ * @returns Final class name to place on the wire as
+ *          `IDecoration.className`.
+ */
+function resolveClassName(rawName) {
+    if (rawName === '')
+        return '';
+    if (platform_vocabulary_1.PLATFORM_VOCABULARY.has(rawName)) {
+        return `sharpee-${rawName}`;
+    }
+    return rawName;
+}
+//# sourceMappingURL=resolver.js.map

package/prose-pipeline/decorations/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/decorations/resolver.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAkBH,4CAMC;AAtBD,+DAA4D;AAE5D;;;;;;;;;;;;;GAaG;AACH,SAAgB,gBAAgB,CAAC,OAAe;IAC9C,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC;IAC9B,IAAI,yCAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,OAAO,WAAW,OAAO,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * Type re-exports for the engine-internal prose pipeline's decoration
+ * primitives. Sub-phase 1.1 declared these locally; sub-phase 1.2
+ * lifted the shape change into `@sharpee/text-blocks`, so the
+ * engine-side module now re-exports the canonical types from there.
+ *
+ * Public interface: `IDecoration`, `TextContent`. Used internally by
+ * the parser, resolver, and (after sub-phase 1.5) by the pipeline
+ * class.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Wire shape
+ */
+export type { IDecoration, TextContent } from '@sharpee/text-blocks';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/decorations/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/prose-pipeline/decorations/types.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Type re-exports for the engine-internal prose pipeline's decoration
+ * primitives. Sub-phase 1.1 declared these locally; sub-phase 1.2
+ * lifted the shape change into `@sharpee/text-blocks`, so the
+ * engine-side module now re-exports the canonical types from there.
+ *
+ * Public interface: `IDecoration`, `TextContent`. Used internally by
+ * the parser, resolver, and (after sub-phase 1.5) by the pipeline
+ * class.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Wire shape
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

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

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

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

@@ -0,0 +1,31 @@
+/**
+ * About event handler — `if.event.about_displayed`.
+ *
+ * Produces the same structured banner as `handleGameStarted`, via the
+ * shared `buildBannerBlocks` helper. The ABOUT action gives us a
+ * flat `params: Record<string, string>` that mirrors `event.data.story`
+ * — we project it into the `BannerStoryInfo` shape and reuse the
+ * builder.
+ *
+ * Public interface: `handleAboutDisplayed`. 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.about_displayed` by showing the structured banner.
+ *
+ * Reads the about action's `params` payload (title, author, version,
+ * description, engineVersion, buildDate, portedBy). The ABOUT action
+ * does not currently pass `credits` directly; when present, the
+ * builder falls back to `By {author}` for a single author-list line.
+ * Stories that want richer ABOUT credit blocks should propagate
+ * `credits` through the about action's params.
+ */
+export declare function handleAboutDisplayed(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=about.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"about.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/about.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;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;AAG9C;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAoBd"}

package/prose-pipeline/handlers/about.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * About event handler — `if.event.about_displayed`.
+ *
+ * Produces the same structured banner as `handleGameStarted`, via the
+ * shared `buildBannerBlocks` helper. The ABOUT action gives us a
+ * flat `params: Record<string, string>` that mirrors `event.data.story`
+ * — we project it into the `BannerStoryInfo` shape and reuse the
+ * builder.
+ *
+ * Public interface: `handleAboutDisplayed`. 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.handleAboutDisplayed = handleAboutDisplayed;
+const banner_1 = require("./banner");
+/**
+ * Handle `if.event.about_displayed` by showing the structured banner.
+ *
+ * Reads the about action's `params` payload (title, author, version,
+ * description, engineVersion, buildDate, portedBy). The ABOUT action
+ * does not currently pass `credits` directly; when present, the
+ * builder falls back to `By {author}` for a single author-list line.
+ * Stories that want richer ABOUT credit blocks should propagate
+ * `credits` through the about action's params.
+ */
+function handleAboutDisplayed(event, context) {
+    const data = event.data;
+    const params = (data?.params ?? {});
+    const story = {
+        title: stringOrUndef(params.title),
+        version: stringOrUndef(params.version),
+        buildDate: stringOrUndef(params.buildDate),
+        description: stringOrUndef(params.description),
+        author: stringOrUndef(params.author),
+        credits: Array.isArray(params.credits)
+            ? params.credits.filter((s) => typeof s === 'string' && s.length > 0)
+            : undefined,
+    };
+    const engineVersion = stringOrUndef(params.engineVersion);
+    return (0, banner_1.buildBannerBlocks)('about.text', story, engineVersion, context);
+}
+function stringOrUndef(value) {
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+//# sourceMappingURL=about.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"about.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/about.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;AAiBH,oDAuBC;AAnCD,qCAAmE;AAEnE;;;;;;;;;GASG;AACH,SAAgB,oBAAoB,CAClC,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAwD,CAAC;IAC5E,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,EAAE,CAA4B,CAAC;IAE/D,MAAM,KAAK,GAAoB;QAC7B,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;QAClC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC;QACtC,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC;QAC1C,WAAW,EAAE,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC;QAC9C,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC;QACpC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;YACpC,CAAC,CAAE,MAAM,CAAC,OAAqB,CAAC,MAAM,CAClC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAC1D;YACH,CAAC,CAAC,SAAS;KACd,CAAC;IAEF,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAE1D,OAAO,IAAA,0BAAiB,EAAC,YAAY,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AAC3E,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * Audibility event handler — ADR-172 Phase 7a, ported to engine prose
+ * pipeline per ADR-174.
+ *
+ * Handles `sound.audibility.heard`. Converts each `IAudibilityEvent`
+ * (per-listener perception of a propagated sound, produced by the
+ * engine's sound dispatcher in Phase 6) into a single text block via
+ * the `sound.heard.<kind>.<tier>` template family registered in the
+ * active language pack (lang-en-us ships defaults; stories override
+ * per kind).
+ *
+ * Naming discipline:
+ *   - `audio`      — Web Audio playback (ADR-169 `AudioManager`).
+ *   - `sound`      — the media-cue channel id (`media.sound.play`,
+ *                    ADR-163).
+ *   - `audibility` — ADR-172 perception of propagated sound, this
+ *                    handler.
+ *
+ * Public interface: `handleAudibilityHeard`.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * Listener filtering: in single-user scope today the player is the
+ * only entity carrying `ListenerTrait` automatically, so every
+ * audibility event delivered here is for the player. The dispatcher
+ * already writes the listener id into `event.entities.target`; when
+ * L2's NPC-listener work lands, this handler will need to filter
+ * `event.entities.target === playerId` before rendering.
+ *
+ * @see ADR-172 — Spatial Sound Propagation §Channel routing
+ * @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 a `sound.audibility.heard` event.
+ *
+ * Resolves `sound.heard.<kind>.<tier>` from the language provider,
+ * falling back to `sound.heard.default.<tier>` when the kind-specific
+ * template is not registered. Returns one `ITextBlock` per event, or
+ * `[]` when the event is malformed, the tier is `silent`, or no
+ * template resolves.
+ */
+export declare function handleAudibilityHeard(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=audibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audibility.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/handlers/audibility.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK9C;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAiCd"}