@sharpee/engine 0.9.111 → 1.0.0

package/index.d.ts

@@ -20,6 +20,7 @@ export * from './vocabulary-manager';
 export * from './save-restore-service';
 export * from './turn-event-processor';
 export * from './platform-operations';
+export * from './sound';
 export { GameEngine } from './game-engine';
 export { CommandExecutor, createCommandExecutor } from './command-executor';
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/engine/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAG5B,cAAc,SAAS,CAAC;AAGxB,cAAc,oBAAoB,CAAC;AAGnC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EACL,UAAU,EACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,qBAAqB,EACtB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/engine/src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,SAAS,CAAC;AAGxB,cAAc,aAAa,CAAC;AAG5B,cAAc,SAAS,CAAC;AAGxB,cAAc,oBAAoB,CAAC;AAGnC,cAAc,8BAA8B,CAAC;AAG7C,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,eAAe,CAAC;AAG9B,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAGlE,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,UAAU,EACX,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,eAAe,EACf,qBAAqB,EACtB,MAAM,oBAAoB,CAAC"}

package/index.js

@@ -50,6 +50,8 @@ __exportStar(require("./vocabulary-manager"), exports);
 __exportStar(require("./save-restore-service"), exports);
 __exportStar(require("./turn-event-processor"), exports);
 __exportStar(require("./platform-operations"), exports);
+// Spatial sound propagation (ADR-172)
+__exportStar(require("./sound"), exports);
 // Re-export commonly used items
 var game_engine_1 = require("./game-engine");
 Object.defineProperty(exports, "GameEngine", { enumerable: true, get: function () { return game_engine_1.GameEngine; } });

package/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/engine/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;AAEH,QAAQ;AACR,0CAAwB;AAExB,+BAA+B;AAC/B,8CAA4B;AAE5B,kBAAkB;AAClB,0CAAwB;AAExB,oBAAoB;AACpB,qDAAmC;AAEnC,oDAAoD;AACpD,+DAA6C;AAE7C,0CAA0C;AAC1C,qDAAmC;AAEnC,kDAAkD;AAClD,qDAAmC;AAEnC,cAAc;AACd,gDAA8B;AAE9B,0BAA0B;AAC1B,4CAAiF;AAAxE,yGAAA,cAAc,OAAA;AAEvB,6BAA6B;AAC7B,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAE9B,qBAAqB;AACrB,uDAAqC;AACrC,yDAAuC;AACvC,yDAAuC;AACvC,wDAAsC;AAEtC,gCAAgC;AAChC,6CAEuB;AADrB,yGAAA,UAAU,OAAA;AAGZ,uDAG4B;AAF1B,mHAAA,eAAe,OAAA;AACf,yHAAA,qBAAqB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/engine/src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;AAEH,QAAQ;AACR,0CAAwB;AAExB,+BAA+B;AAC/B,8CAA4B;AAE5B,kBAAkB;AAClB,0CAAwB;AAExB,oBAAoB;AACpB,qDAAmC;AAEnC,oDAAoD;AACpD,+DAA6C;AAE7C,0CAA0C;AAC1C,qDAAmC;AAEnC,kDAAkD;AAClD,qDAAmC;AAEnC,cAAc;AACd,gDAA8B;AAE9B,0BAA0B;AAC1B,4CAAiF;AAAxE,yGAAA,cAAc,OAAA;AAEvB,6BAA6B;AAC7B,qEAAkE;AAAzD,gIAAA,qBAAqB,OAAA;AAE9B,qBAAqB;AACrB,uDAAqC;AACrC,yDAAuC;AACvC,yDAAuC;AACvC,wDAAsC;AAEtC,sCAAsC;AACtC,0CAAwB;AAExB,gCAAgC;AAChC,6CAEuB;AADrB,yGAAA,UAAU,OAAA;AAGZ,uDAG4B;AAF1B,mHAAA,eAAe,OAAA;AACf,yHAAA,qBAAqB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sharpee/engine",
-  "version": "0.9.111",
+  "version": "1.0.0",
   "description": "Runtime engine for Sharpee IF Platform - game loop, command execution, and turn management",
   "main": "./index.js",
   "types": "./index.d.ts",
@@ -12,17 +12,18 @@
     }
   },
   "dependencies": {
-    "@sharpee/core": "^0.9.111",
-    "@sharpee/event-processor": "^0.9.111",
-    "@sharpee/plugins": "^0.9.111",
-    "@sharpee/if-domain": "^0.9.111",
-    "@sharpee/if-services": "^0.9.111",
-    "@sharpee/lang-en-us": "^0.9.111",
-    "@sharpee/parser-en-us": "^0.9.111",
-    "@sharpee/stdlib": "^0.9.111",
-    "@sharpee/text-blocks": "^0.9.111",
-    "@sharpee/text-service": "^0.9.111",
-    "@sharpee/world-model": "^0.9.111"
+    "@sharpee/channel-service": "^1.0.0",
+    "@sharpee/core": "^1.0.0",
+    "@sharpee/event-processor": "^1.0.0",
+    "@sharpee/plugins": "^1.0.0",
+    "@sharpee/if-domain": "^1.0.0",
+    "@sharpee/if-services": "^1.0.0",
+    "@sharpee/lang-en-us": "^1.0.0",
+    "@sharpee/parser-en-us": "^1.0.0",
+    "@sharpee/stdlib": "^1.0.0",
+    "@sharpee/text-blocks": "^1.0.0",
+    "@sharpee/world-model": "^1.0.0",
+    "fflate": "^0.8.2"
   },
   "keywords": [
     "interactive-fiction",

package/prose-pipeline/assemble.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Block assembly stage — wraps a resolved template string into an
+ * `ITextBlock`, parsing decorations along the way.
+ *
+ * Public interface: `createBlock`, `extractValue`. Used internally
+ * by handler families and the pipeline orchestration.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline. Lives
+ * at `prose-pipeline/assemble.ts` (not under `stages/`) per ADR-174
+ * §Engine-internal prose pipeline layout.
+ *
+ * @see ADR-174 §Markup syntax (decoration parsing)
+ * @see ADR-133 (preserved): blocks have keys and structured content.
+ */
+import type { ITextBlock } from "../../text-blocks/index";
+/**
+ * Options for `createBlock`.
+ */
+export interface CreateBlockOptions {
+    /**
+     * Mark the block as a visual continuation of its predecessor — the
+     * renderer collapses the paragraph margin so the two lines stack
+     * flush. Used by handlers that split former multi-line content into
+     * multiple single-line blocks. See `ITextBlock.tight` for the
+     * invariant that a tight block must not appear first in a packet.
+     */
+    tight?: boolean;
+    /**
+     * Optional semantic CSS class the browser renderer applies to the
+     * rendered element in addition to `main-entry`. See
+     * `ITextBlock.className`.
+     */
+    className?: string;
+}
+/**
+ * Create an `ITextBlock` from a key and a resolved template string.
+ *
+ * The template is fed through the bracket-decoration parser; templates
+ * with no markers produce a single-string `content` array, matching
+ * the existing no-op-decoration shape.
+ *
+ * Pass `{ tight: true }` to mark this block as a continuation of the
+ * preceding block (renderer collapses inter-block margin).
+ *
+ * Callers that may receive text containing `\n` should use
+ * `createBlocks` instead, which lifts newlines to block boundaries.
+ */
+export declare function createBlock(key: string, text: string, opts?: CreateBlockOptions): ITextBlock;
+/**
+ * Create one or more `ITextBlock`s from a key and a (possibly
+ * multi-line) resolved template string.
+ *
+ * Newlines in the text are *lifted* to block boundaries — no block's
+ * `content` ever carries `\n` (the precondition for removing
+ * `white-space: pre-line` from the prose pane). Splitting policy:
+ *
+ *  - `\n\n+` (one or more blank lines) → next block is a fresh
+ *    paragraph (no `tight` flag); the renderer applies the prose
+ *    pane's paragraph margin.
+ *  - `\n` (single newline) → next block carries `tight: true`; the
+ *    renderer collapses the inter-block margin so the lines stack
+ *    flush, matching the legacy `pre-line` line-break behavior.
+ *
+ * Edge cases: leading/trailing whitespace is trimmed; empty
+ * paragraphs (between `\n\n\n` etc.) are dropped; empty input
+ * returns a single empty block.
+ */
+export declare function createBlocks(key: string, text: string): ITextBlock[];
+/**
+ * Extract a string value from a direct primitive or a function wrapper.
+ *
+ * Returns null for falsy values, function returns, or thrown errors.
+ * Used by handlers that pull data out of event payloads with mixed
+ * shapes (string, number, () => string, etc.).
+ */
+export declare function extractValue(value: unknown): string | null;
+//# sourceMappingURL=assemble.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/assemble.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,sBAAsB,CAAC;AAGpE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,kBAAkB,GACxB,UAAU,CASZ;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAcpE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAW1D"}

package/prose-pipeline/assemble.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Block assembly stage — wraps a resolved template string into an
+ * `ITextBlock`, parsing decorations along the way.
+ *
+ * Public interface: `createBlock`, `extractValue`. Used internally
+ * by handler families and the pipeline orchestration.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline. Lives
+ * at `prose-pipeline/assemble.ts` (not under `stages/`) per ADR-174
+ * §Engine-internal prose pipeline layout.
+ *
+ * @see ADR-174 §Markup syntax (decoration parsing)
+ * @see ADR-133 (preserved): blocks have keys and structured content.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBlock = createBlock;
+exports.createBlocks = createBlocks;
+exports.extractValue = extractValue;
+const parser_1 = require("./decorations/parser");
+/**
+ * Create an `ITextBlock` from a key and a resolved template string.
+ *
+ * The template is fed through the bracket-decoration parser; templates
+ * with no markers produce a single-string `content` array, matching
+ * the existing no-op-decoration shape.
+ *
+ * Pass `{ tight: true }` to mark this block as a continuation of the
+ * preceding block (renderer collapses inter-block margin).
+ *
+ * Callers that may receive text containing `\n` should use
+ * `createBlocks` instead, which lifts newlines to block boundaries.
+ */
+function createBlock(key, text, opts) {
+    const content = (0, parser_1.parseDecorations)(text);
+    const block = {
+        key,
+        content: content.length === 0 ? [''] : content,
+        ...(opts?.tight ? { tight: true } : {}),
+        ...(opts?.className ? { className: opts.className } : {}),
+    };
+    return block;
+}
+/**
+ * Create one or more `ITextBlock`s from a key and a (possibly
+ * multi-line) resolved template string.
+ *
+ * Newlines in the text are *lifted* to block boundaries — no block's
+ * `content` ever carries `\n` (the precondition for removing
+ * `white-space: pre-line` from the prose pane). Splitting policy:
+ *
+ *  - `\n\n+` (one or more blank lines) → next block is a fresh
+ *    paragraph (no `tight` flag); the renderer applies the prose
+ *    pane's paragraph margin.
+ *  - `\n` (single newline) → next block carries `tight: true`; the
+ *    renderer collapses the inter-block margin so the lines stack
+ *    flush, matching the legacy `pre-line` line-break behavior.
+ *
+ * Edge cases: leading/trailing whitespace is trimmed; empty
+ * paragraphs (between `\n\n\n` etc.) are dropped; empty input
+ * returns a single empty block.
+ */
+function createBlocks(key, text) {
+    const trimmed = text.trim();
+    if (!trimmed)
+        return [createBlock(key, '')];
+    const paragraphs = trimmed.split(/\n\n+/).filter((p) => p.length > 0);
+    const blocks = [];
+    for (const para of paragraphs) {
+        const lines = para.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            blocks.push(createBlock(key, lines[i], i > 0 ? { tight: true } : undefined));
+        }
+    }
+    return blocks;
+}
+/**
+ * Extract a string value from a direct primitive or a function wrapper.
+ *
+ * Returns null for falsy values, function returns, or thrown errors.
+ * Used by handlers that pull data out of event payloads with mixed
+ * shapes (string, number, () => string, etc.).
+ */
+function extractValue(value) {
+    if (typeof value === 'function') {
+        try {
+            const result = value();
+            return result ? String(result) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return value ? String(value) : null;
+}
+//# sourceMappingURL=assemble.js.map

package/prose-pipeline/assemble.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assemble.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/assemble.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;AAuCH,kCAaC;AAqBD,oCAcC;AASD,oCAWC;AAxGD,iDAAwD;AAuBxD;;;;;;;;;;;;GAYG;AACH,SAAgB,WAAW,CACzB,GAAW,EACX,IAAY,EACZ,IAAyB;IAEzB,MAAM,OAAO,GAAkB,IAAA,yBAAgB,EAAC,IAAI,CAAC,CAAC;IACtD,MAAM,KAAK,GAAe;QACxB,GAAG;QACH,OAAO,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;QAC9C,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1D,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,YAAY,CAAC,GAAW,EAAE,IAAY;IACpD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO;QAAE,OAAO,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACtE,MAAM,MAAM,GAAiB,EAAE,CAAC;IAChC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,CAAC,IAAI,CACT,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAChE,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,YAAY,CAAC,KAAc;IACzC,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtC,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Decorations — internal barrel for the prose pipeline's bracket
+ * markup primitives.
+ *
+ * Public interface: re-exports from `parser`, `resolver`,
+ * `platform-vocabulary`, `types`. No external package imports this;
+ * the prose pipeline assembles its own consumers under
+ * `packages/engine/src/prose-pipeline/`.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ */
+export { parseDecorations } from './parser';
+export { resolveClassName } from './resolver';
+export { PLATFORM_VOCABULARY, PLATFORM_VOCABULARY_NAMES, type PlatformVocabularyName, } from './platform-vocabulary';
+export type { IDecoration, TextContent } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/decorations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC"}

package/prose-pipeline/decorations/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Decorations — internal barrel for the prose pipeline's bracket
+ * markup primitives.
+ *
+ * Public interface: re-exports from `parser`, `resolver`,
+ * `platform-vocabulary`, `types`. No external package imports this;
+ * the prose pipeline assembles its own consumers under
+ * `packages/engine/src/prose-pipeline/`.
+ *
+ * Owner context: `@sharpee/engine` — internal prose pipeline.
+ *
+ * @see ADR-174 §Engine-internal prose pipeline
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PLATFORM_VOCABULARY_NAMES = exports.PLATFORM_VOCABULARY = exports.resolveClassName = exports.parseDecorations = void 0;
+var parser_1 = require("./parser");
+Object.defineProperty(exports, "parseDecorations", { enumerable: true, get: function () { return parser_1.parseDecorations; } });
+var resolver_1 = require("./resolver");
+Object.defineProperty(exports, "resolveClassName", { enumerable: true, get: function () { return resolver_1.resolveClassName; } });
+var platform_vocabulary_1 = require("./platform-vocabulary");
+Object.defineProperty(exports, "PLATFORM_VOCABULARY", { enumerable: true, get: function () { return platform_vocabulary_1.PLATFORM_VOCABULARY; } });
+Object.defineProperty(exports, "PLATFORM_VOCABULARY_NAMES", { enumerable: true, get: function () { return platform_vocabulary_1.PLATFORM_VOCABULARY_NAMES; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/decorations/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,mCAA4C;AAAnC,0GAAA,gBAAgB,OAAA;AACzB,uCAA8C;AAArC,4GAAA,gBAAgB,OAAA;AACzB,6DAI+B;AAH7B,0HAAA,mBAAmB,OAAA;AACnB,gIAAA,yBAAyB,OAAA"}

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

@@ -0,0 +1,34 @@
+/**
+ * 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
+ */
+import type { TextContent } from './types';
+/**
+ * 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.
+ */
+export declare function parseDecorations(template: string): TextContent[];
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/engine/src/prose-pipeline/decorations/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAe,WAAW,EAAE,MAAM,SAAS,CAAC;AAExD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAgDhE"}

package/prose-pipeline/decorations/parser.js

@@ -0,0 +1,177 @@
+"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");
+/**
+ * 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) {
+        // AC-11: no colon → whole `[...]` segment is literal text.
+        return { kind: 'literal', text: template.slice(openIndex, nextIndex), nextIndex };
+    }
+    const rawName = inner.slice(0, colonIndex);
+    const innerContent = inner.slice(colonIndex + 1);
+    if (rawName === '') {
+        // AC-12: empty class name → emit inner content as plain entries.
+        return { kind: 'children', children: parseDecorations(innerContent), nextIndex };
+    }
+    return {
+        kind: 'decoration',
+        decoration: { className: (0, resolver_1.resolveClassName)(rawName), content: parseDecorations(innerContent) },
+        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,27 @@
+/**
+ * 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"];
+/**
+ * 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,2bA8CZ,CAAC;AAEX;;;;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,65 @@
+"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 = 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',
+];
+/**
+ * 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;CACH,CAAC;AAEX;;;;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"}