@sharpee/text-service 0.9.60-beta

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 David Cornelson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/cli-renderer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * CLI Renderer
+ *
+ * Renders ITextBlock[] to string output for CLI clients.
+ * Supports optional ANSI color codes.
+ *
+ * @see ADR-096 Text Service Architecture
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+/**
+ * CLI render options
+ */
+export interface CLIRenderOptions {
+    /** Enable ANSI color codes (default: false) */
+    ansi?: boolean;
+    /** Separator between blocks (default: '\n\n') */
+    blockSeparator?: string;
+    /** Story-defined color mappings */
+    colors?: Record<string, string>;
+    /** Include status blocks in output (default: false) */
+    includeStatus?: boolean;
+}
+/**
+ * Render ITextBlock[] to string for CLI output.
+ *
+ * Uses smart joining: single newline between consecutive blocks of the same type,
+ * double newline between different block types. This keeps related output together
+ * (e.g., multiple "Taken" messages) while separating distinct sections.
+ *
+ * @example
+ * const output = renderToString(blocks, { ansi: true });
+ * console.log(output);
+ */
+export declare function renderToString(blocks: ITextBlock[], options?: CLIRenderOptions): string;
+/**
+ * Render status blocks to a single line (for status bar display).
+ *
+ * @example
+ * const status = renderStatusLine(blocks);
+ * // "West of House | Score: 0 | Turns: 1"
+ */
+export declare function renderStatusLine(blocks: ITextBlock[], options?: CLIRenderOptions): string;
+//# sourceMappingURL=cli-renderer.d.ts.map

package/dist/cli-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-renderer.d.ts","sourceRoot":"","sources":["../src/cli-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAA4B,MAAM,sBAAsB,CAAC;AAGjF;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,mCAAmC;IACnC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEhC,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AA0ID;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CA+BR;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,gBAAqB,GAC7B,MAAM,CA6BR"}

package/dist/cli-renderer.js

@@ -0,0 +1,208 @@
+"use strict";
+/**
+ * CLI Renderer
+ *
+ * Renders ITextBlock[] to string output for CLI clients.
+ * Supports optional ANSI color codes.
+ *
+ * @see ADR-096 Text Service Architecture
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderToString = renderToString;
+exports.renderStatusLine = renderStatusLine;
+const text_blocks_1 = require("@sharpee/text-blocks");
+/**
+ * ANSI escape codes
+ */
+const ANSI = {
+    RESET: '\x1b[0m',
+    BOLD: '\x1b[1m',
+    ITALIC: '\x1b[3m',
+    UNDERLINE: '\x1b[4m',
+    STRIKETHROUGH: '\x1b[9m',
+    // Colors
+    BLACK: '\x1b[30m',
+    RED: '\x1b[31m',
+    GREEN: '\x1b[32m',
+    YELLOW: '\x1b[33m',
+    BLUE: '\x1b[34m',
+    MAGENTA: '\x1b[35m',
+    CYAN: '\x1b[36m',
+    WHITE: '\x1b[37m',
+    // Bright colors
+    BRIGHT_RED: '\x1b[91m',
+    BRIGHT_GREEN: '\x1b[92m',
+    BRIGHT_YELLOW: '\x1b[93m',
+    BRIGHT_BLUE: '\x1b[94m',
+    BRIGHT_MAGENTA: '\x1b[95m',
+    BRIGHT_CYAN: '\x1b[96m',
+    BRIGHT_WHITE: '\x1b[97m',
+};
+/**
+ * Map decoration types to ANSI codes
+ */
+const DECORATION_ANSI = {
+    em: ANSI.ITALIC,
+    strong: ANSI.BOLD,
+    item: ANSI.CYAN,
+    room: ANSI.YELLOW,
+    npc: ANSI.MAGENTA,
+    command: ANSI.GREEN,
+    direction: ANSI.WHITE,
+    underline: ANSI.UNDERLINE,
+    strikethrough: ANSI.STRIKETHROUGH,
+};
+/**
+ * Approximate hex colors to ANSI
+ */
+function hexToAnsi(hex) {
+    // Simple approximation - extract dominant color
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    // Find closest ANSI color
+    if (r > g && r > b)
+        return r > 180 ? ANSI.BRIGHT_RED : ANSI.RED;
+    if (g > r && g > b)
+        return g > 180 ? ANSI.BRIGHT_GREEN : ANSI.GREEN;
+    if (b > r && b > g)
+        return b > 180 ? ANSI.BRIGHT_BLUE : ANSI.BLUE;
+    if (r > 200 && g > 200)
+        return ANSI.BRIGHT_YELLOW;
+    if (r > 200 && b > 200)
+        return ANSI.BRIGHT_MAGENTA;
+    if (g > 200 && b > 200)
+        return ANSI.BRIGHT_CYAN;
+    if (r > 180 && g > 180 && b > 180)
+        return ANSI.BRIGHT_WHITE;
+    return ANSI.WHITE;
+}
+/**
+ * Render TextContent to string
+ */
+function renderContent(content, options) {
+    return content
+        .map((item) => {
+        if (typeof item === 'string') {
+            return item;
+        }
+        // IDecoration
+        return renderDecoration(item, options);
+    })
+        .join('');
+}
+/**
+ * Render a decoration to string
+ */
+function renderDecoration(decoration, options) {
+    const innerText = renderContent(decoration.content, options);
+    if (!options.ansi) {
+        // Plain text fallback
+        if (decoration.type === 'em')
+            return `*${innerText}*`;
+        if (decoration.type === 'strong')
+            return `**${innerText}**`;
+        return innerText;
+    }
+    // ANSI rendering
+    let ansiCode = DECORATION_ANSI[decoration.type];
+    // Check for story-defined color
+    if (!ansiCode && options.colors?.[decoration.type]) {
+        const hex = options.colors[decoration.type];
+        if (hex.startsWith('#')) {
+            ansiCode = hexToAnsi(hex);
+        }
+    }
+    if (ansiCode) {
+        return `${ansiCode}${innerText}${ANSI.RESET}`;
+    }
+    // Unknown decoration type - render without styling
+    return innerText;
+}
+/**
+ * Render a single block to string
+ */
+function renderBlock(block, options) {
+    const text = renderContent(block.content, options);
+    // Apply block-level styling
+    if (options.ansi) {
+        if (block.key === 'room.name') {
+            return `${ANSI.BOLD}${ANSI.YELLOW}${text}${ANSI.RESET}`;
+        }
+        if (block.key === 'action.blocked' || block.key === 'error') {
+            return `${ANSI.RED}${text}${ANSI.RESET}`;
+        }
+    }
+    return text;
+}
+/**
+ * Render ITextBlock[] to string for CLI output.
+ *
+ * Uses smart joining: single newline between consecutive blocks of the same type,
+ * double newline between different block types. This keeps related output together
+ * (e.g., multiple "Taken" messages) while separating distinct sections.
+ *
+ * @example
+ * const output = renderToString(blocks, { ansi: true });
+ * console.log(output);
+ */
+function renderToString(blocks, options = {}) {
+    const opts = {
+        ansi: false,
+        blockSeparator: '\n\n',
+        includeStatus: false,
+        ...options,
+    };
+    // Filter out status blocks unless explicitly included
+    const filteredBlocks = opts.includeStatus
+        ? blocks
+        : blocks.filter((b) => !(0, text_blocks_1.isStatusBlock)(b));
+    // Render each block and pair with its key for smart joining
+    const rendered = filteredBlocks
+        .map((block) => ({ key: block.key, text: renderBlock(block, opts) }))
+        .filter((item) => item.text.trim());
+    if (rendered.length === 0)
+        return '';
+    // Smart join: \n between same block types, \n\n between different types
+    const parts = [rendered[0].text];
+    for (let i = 1; i < rendered.length; i++) {
+        const prev = rendered[i - 1];
+        const curr = rendered[i];
+        // Use single newline for consecutive same-type blocks, double for different
+        const separator = prev.key === curr.key ? '\n' : opts.blockSeparator;
+        parts.push(separator + curr.text);
+    }
+    return parts.join('');
+}
+/**
+ * Render status blocks to a single line (for status bar display).
+ *
+ * @example
+ * const status = renderStatusLine(blocks);
+ * // "West of House | Score: 0 | Turns: 1"
+ */
+function renderStatusLine(blocks, options = {}) {
+    const statusBlocks = blocks.filter(text_blocks_1.isStatusBlock);
+    const parts = [];
+    // Render in specific order
+    const roomBlock = statusBlocks.find((b) => b.key === 'status.room');
+    if (roomBlock) {
+        parts.push(renderContent(roomBlock.content, options));
+    }
+    const scoreBlock = statusBlocks.find((b) => b.key === 'status.score');
+    if (scoreBlock) {
+        parts.push(`Score: ${renderContent(scoreBlock.content, options)}`);
+    }
+    const turnsBlock = statusBlocks.find((b) => b.key === 'status.turns');
+    if (turnsBlock) {
+        parts.push(`Turns: ${renderContent(turnsBlock.content, options)}`);
+    }
+    // Add any custom status blocks
+    const knownKeys = ['status.room', 'status.score', 'status.turns'];
+    const customBlocks = statusBlocks.filter((b) => !knownKeys.includes(b.key));
+    for (const block of customBlocks) {
+        parts.push(renderContent(block.content, options));
+    }
+    return parts.join(' | ');
+}
+//# sourceMappingURL=cli-renderer.js.map

package/dist/cli-renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-renderer.js","sourceRoot":"","sources":["../src/cli-renderer.ts"],"names":[],"mappings":"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"}

package/dist/decoration-parser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Decoration Parser
+ *
+ * Parses decoration syntax from resolved templates into IDecoration structures.
+ *
+ * Supports:
+ * - [type:content] - semantic decorations
+ * - *emphasis* - emphasis
+ * - **strong** - strong emphasis
+ * - Nested decorations
+ * - Escaped characters: \*, \[, \]
+ *
+ * @see ADR-091 Text Decorations
+ */
+import type { TextContent } from '@sharpee/text-blocks';
+/**
+ * Parse decorated text into TextContent array.
+ *
+ * @example
+ * parseDecorations('You take [item:the sword].')
+ * // Returns: ['You take ', { type: 'item', content: ['the sword'] }, '.']
+ *
+ * parseDecorations('The lantern glows *brightly*.')
+ * // Returns: ['The lantern glows ', { type: 'em', content: ['brightly'] }, '.']
+ */
+export declare function parseDecorations(text: string): TextContent[];
+/**
+ * Check if text contains any decoration markers.
+ */
+export declare function hasDecorations(text: string): boolean;
+//# sourceMappingURL=decoration-parser.d.ts.map

package/dist/decoration-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoration-parser.d.ts","sourceRoot":"","sources":["../src/decoration-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,sBAAsB,CAAC;AAErE;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,EAAE,CA4G5D;AA4DD;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD"}

package/dist/decoration-parser.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Decoration Parser
+ *
+ * Parses decoration syntax from resolved templates into IDecoration structures.
+ *
+ * Supports:
+ * - [type:content] - semantic decorations
+ * - *emphasis* - emphasis
+ * - **strong** - strong emphasis
+ * - Nested decorations
+ * - Escaped characters: \*, \[, \]
+ *
+ * @see ADR-091 Text Decorations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDecorations = parseDecorations;
+exports.hasDecorations = hasDecorations;
+/**
+ * Parse decorated text into TextContent array.
+ *
+ * @example
+ * parseDecorations('You take [item:the sword].')
+ * // Returns: ['You take ', { type: 'item', content: ['the sword'] }, '.']
+ *
+ * parseDecorations('The lantern glows *brightly*.')
+ * // Returns: ['The lantern glows ', { type: 'em', content: ['brightly'] }, '.']
+ */
+function parseDecorations(text) {
+    if (!text)
+        return [];
+    const result = [];
+    let current = '';
+    let i = 0;
+    while (i < text.length) {
+        const char = text[i];
+        // Handle escape sequences
+        if (char === '\\' && i + 1 < text.length) {
+            const nextChar = text[i + 1];
+            if (nextChar === '*' || nextChar === '[' || nextChar === ']' || nextChar === '\\') {
+                current += nextChar;
+                i += 2;
+                continue;
+            }
+        }
+        // Handle [type:content] decorations
+        if (char === '[') {
+            const closeIndex = findMatchingBracket(text, i);
+            if (closeIndex !== -1) {
+                // Flush current text
+                if (current) {
+                    result.push(current);
+                    current = '';
+                }
+                const inner = text.slice(i + 1, closeIndex);
+                const colonIndex = inner.indexOf(':');
+                if (colonIndex !== -1) {
+                    const type = inner.slice(0, colonIndex);
+                    const content = inner.slice(colonIndex + 1);
+                    // Recursively parse content for nested decorations
+                    const decoration = {
+                        type,
+                        content: parseDecorations(content),
+                    };
+                    result.push(decoration);
+                }
+                else {
+                    // No colon - treat as literal text
+                    current += text.slice(i, closeIndex + 1);
+                }
+                i = closeIndex + 1;
+                continue;
+            }
+        }
+        // Handle **strong** (check before single *)
+        if (char === '*' && text[i + 1] === '*') {
+            const closeIndex = text.indexOf('**', i + 2);
+            if (closeIndex !== -1) {
+                // Flush current text
+                if (current) {
+                    result.push(current);
+                    current = '';
+                }
+                const content = text.slice(i + 2, closeIndex);
+                const decoration = {
+                    type: 'strong',
+                    content: parseDecorations(content),
+                };
+                result.push(decoration);
+                i = closeIndex + 2;
+                continue;
+            }
+        }
+        // Handle *emphasis*
+        if (char === '*') {
+            const closeIndex = findSingleAsterisk(text, i + 1);
+            if (closeIndex !== -1) {
+                // Flush current text
+                if (current) {
+                    result.push(current);
+                    current = '';
+                }
+                const content = text.slice(i + 1, closeIndex);
+                const decoration = {
+                    type: 'em',
+                    content: parseDecorations(content),
+                };
+                result.push(decoration);
+                i = closeIndex + 1;
+                continue;
+            }
+        }
+        // Regular character
+        current += char;
+        i++;
+    }
+    // Flush remaining text
+    if (current) {
+        result.push(current);
+    }
+    return result;
+}
+/**
+ * Find matching closing bracket, handling nesting.
+ */
+function findMatchingBracket(text, openIndex) {
+    let depth = 1;
+    let i = openIndex + 1;
+    while (i < text.length && depth > 0) {
+        const char = text[i];
+        // Handle escapes
+        if (char === '\\' && i + 1 < text.length) {
+            i += 2;
+            continue;
+        }
+        if (char === '[') {
+            depth++;
+        }
+        else if (char === ']') {
+            depth--;
+        }
+        if (depth === 0) {
+            return i;
+        }
+        i++;
+    }
+    return -1; // No matching bracket
+}
+/**
+ * Find closing single asterisk (not part of **).
+ */
+function findSingleAsterisk(text, startIndex) {
+    let i = startIndex;
+    while (i < text.length) {
+        const char = text[i];
+        // Handle escapes
+        if (char === '\\' && i + 1 < text.length) {
+            i += 2;
+            continue;
+        }
+        // Found single asterisk (not part of **)
+        if (char === '*' && text[i + 1] !== '*' && (i === startIndex || text[i - 1] !== '*')) {
+            return i;
+        }
+        i++;
+    }
+    return -1;
+}
+/**
+ * Check if text contains any decoration markers.
+ */
+function hasDecorations(text) {
+    // Quick check for decoration markers
+    return /[*\[]/.test(text);
+}
+//# sourceMappingURL=decoration-parser.js.map

package/dist/decoration-parser.js.map

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

package/dist/handlers/action.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Action event handlers
+ *
+ * Handles: action.success, action.failure, action.blocked
+ *
+ * @see ADR-096 Text Service Architecture
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+import type { HandlerContext } from './types.js';
+/**
+ * Handle action.success events
+ */
+export declare function handleActionSuccess(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+/**
+ * Handle action.failure and action.blocked events
+ */
+export declare function handleActionFailure(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=action.d.ts.map

package/dist/handlers/action.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../src/handlers/action.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;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,YAAY,CAAC;AAyBjD;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CA4Bd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CA8Bd"}

package/dist/handlers/action.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * Action event handlers
+ *
+ * Handles: action.success, action.failure, action.blocked
+ *
+ * @see ADR-096 Text Service Architecture
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleActionSuccess = handleActionSuccess;
+exports.handleActionFailure = handleActionFailure;
+const text_blocks_1 = require("@sharpee/text-blocks");
+const assemble_js_1 = require("../stages/assemble.js");
+/**
+ * Handle action.success events
+ */
+function handleActionSuccess(event, context) {
+    const data = event.data;
+    // Try to get message from language provider
+    if (data.messageId && context.languageProvider) {
+        const fullMessageId = data.actionId
+            ? `${data.actionId}.${data.messageId}`
+            : data.messageId;
+        let message = context.languageProvider.getMessage(fullMessageId, data.params);
+        // Fallback to just messageId
+        if (message === fullMessageId && data.messageId) {
+            message = context.languageProvider.getMessage(data.messageId, data.params);
+        }
+        if (message !== data.messageId && message !== fullMessageId) {
+            return [(0, assemble_js_1.createBlock)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, message)];
+        }
+    }
+    // Fallback to data in event
+    const text = data.message ?? data.text;
+    if (text) {
+        return [(0, assemble_js_1.createBlock)(text_blocks_1.BLOCK_KEYS.ACTION_RESULT, text)];
+    }
+    return [];
+}
+/**
+ * Handle action.failure and action.blocked events
+ */
+function handleActionFailure(event, context) {
+    const data = event.data;
+    // Try language provider
+    if (data.messageId && context.languageProvider) {
+        const fullMessageId = data.actionId
+            ? `${data.actionId}.${data.messageId}`
+            : data.messageId;
+        let message = context.languageProvider.getMessage(fullMessageId, data.params);
+        // Fallback to just messageId (matches handleActionSuccess behavior)
+        // This allows capability behaviors to use story-specific messageIds like
+        // 'dungeo.troll.spits_at_player' without needing the action prefix
+        if (message === fullMessageId && data.messageId) {
+            message = context.languageProvider.getMessage(data.messageId, data.params);
+        }
+        if (message !== data.messageId && message !== fullMessageId) {
+            return [(0, assemble_js_1.createBlock)(text_blocks_1.BLOCK_KEYS.ACTION_BLOCKED, message)];
+        }
+    }
+    // Fallback
+    const text = data.params?.reason ??
+        data.reason ??
+        data.message ??
+        "You can't do that.";
+    return [(0, assemble_js_1.createBlock)(text_blocks_1.BLOCK_KEYS.ACTION_BLOCKED, text)];
+}
+//# sourceMappingURL=action.js.map

package/dist/handlers/action.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../src/handlers/action.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAiCH,kDA+BC;AAKD,kDAiCC;AAnGD,sDAAkD;AAGlD,uDAAoD;AAwBpD;;GAEG;AACH,SAAgB,mBAAmB,CACjC,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAyB,CAAC;IAE7C,4CAA4C;IAC5C,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ;YACjC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE;YACtC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QAEnB,IAAI,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAE9E,6BAA6B;QAC7B,IAAI,OAAO,KAAK,aAAa,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChD,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;YAC5D,OAAO,CAAC,IAAA,yBAAW,EAAC,wBAAU,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC;IACvC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,IAAA,yBAAW,EAAC,wBAAU,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CACjC,KAAqB,EACrB,OAAuB;IAEvB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAyB,CAAC;IAE7C,wBAAwB;IACxB,IAAI,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC/C,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ;YACjC,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE;YACtC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;QAEnB,IAAI,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAE9E,oEAAoE;QACpE,yEAAyE;QACzE,mEAAmE;QACnE,IAAI,OAAO,KAAK,aAAa,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAChD,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7E,CAAC;QAED,IAAI,OAAO,KAAK,IAAI,CAAC,SAAS,IAAI,OAAO,KAAK,aAAa,EAAE,CAAC;YAC5D,OAAO,CAAC,IAAA,yBAAW,EAAC,wBAAU,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,WAAW;IACX,MAAM,IAAI,GACP,IAAI,CAAC,MAA8B,EAAE,MAAM;QAC5C,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,OAAO;QACZ,oBAAoB,CAAC;IACvB,OAAO,CAAC,IAAA,yBAAW,EAAC,wBAAU,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/handlers/game.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Game Event Handler
+ *
+ * Handles game lifecycle events like game.started to produce
+ * text output (e.g., opening banner).
+ *
+ * @see ADR-096 Text Service Architecture
+ * @see ADR-097 IGameEvent Deprecation (now uses ISemanticEvent with typed data)
+ * @see ISSUE-028 Opening banner hardcoded in browser-entry.ts
+ */
+import type { ITextBlock } from '@sharpee/text-blocks';
+import type { ISemanticEvent } from '@sharpee/core';
+import type { HandlerContext } from './types.js';
+/**
+ * Handle game.started event to produce the opening banner.
+ *
+ * The event data (GameStartedData) contains:
+ * - story.title: Game title
+ * - story.author: Author name(s)
+ * - story.version: Game version
+ * - story.id: Story identifier
+ * - gameState: 'running'
+ * - session: { startTime, turns, moves }
+ *
+ * The language provider supplies the banner template via 'game.started.banner'.
+ * Stories can customize by overriding this message in extendLanguage().
+ */
+export declare function handleGameStarted(event: ISemanticEvent, context: HandlerContext): ITextBlock[];
+//# sourceMappingURL=game.d.ts.map

package/dist/handlers/game.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"game.d.ts","sourceRoot":"","sources":["../../src/handlers/game.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAA4B,MAAM,eAAe,CAAC;AAE9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,OAAO,EAAE,cAAc,GACtB,UAAU,EAAE,CAgCd"}