@sharpee/channel-service 1.0.0

package/render-to-string.js

@@ -0,0 +1,243 @@
+"use strict";
+/**
+ * `renderToString` and `renderStatusLine` — flatten an `ITextBlock[]`
+ * to a single display string.
+ *
+ * Owner context: `@sharpee/channel-service`. Block-flattening helpers
+ * consumed by transcript tooling, chat overlays, and dev scripts.
+ * Channel-service is downstream of engine and upstream of clients —
+ * the right dependency position for a helper that walks ITextBlock[]
+ * for display.
+ *
+ * Public interface:
+ *  - `renderToString(blocks, options?)` — flatten blocks to a joined
+ *    string with smart separators between same-key vs different-key
+ *    block transitions. Decorations translate to ANSI codes when
+ *    `options.ansi === true`, or to bracket-stripped plain text
+ *    otherwise.
+ *  - `renderStatusLine(blocks, options?)` — render `status.*` blocks
+ *    to a single pipe-separated line for status-bar display.
+ *  - `CLIRenderOptions` — option shape (ansi, blockSeparator,
+ *    colors, includeStatus). Name preserved from the prior
+ *    `@sharpee/text-service` home; not CLI-specific in practice
+ *    (zifmia uses `renderToString` for browser chat bubbles).
+ *
+ * Ported from `@sharpee/text-service/src/cli-renderer.ts` per ADR-174
+ * Phase 2 (OQ-1 resolution, 2026-05-10). The original file remains
+ * compilable in text-service through Phase 2 for zifmia's sake; Phase
+ * 3 deletes the package.
+ *
+ * @see ADR-174 — Decoration Architecture and Engine-Internal Prose Pipeline
+ * @see ADR-163 — Channel-Service Platform
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderToString = renderToString;
+exports.renderStatusLine = renderStatusLine;
+const text_blocks_1 = require("../text-blocks/index.js");
+/**
+ * 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 class names to ANSI codes. Keys are the final
+ * `IDecoration.className` strings emitted by the parser — the
+ * `sharpee-`-prefixed platform vocabulary names plus a couple of
+ * legacy bare names retained for transitional safety.
+ */
+const DECORATION_ANSI = {
+    'sharpee-em': ANSI.ITALIC,
+    'sharpee-strong': ANSI.BOLD,
+    'sharpee-item': ANSI.CYAN,
+    'sharpee-room': ANSI.YELLOW,
+    'sharpee-npc': ANSI.MAGENTA,
+    'sharpee-command': ANSI.GREEN,
+    'sharpee-direction': ANSI.WHITE,
+    'sharpee-u': ANSI.UNDERLINE,
+    'sharpee-st': ANSI.STRIKETHROUGH,
+    'sharpee-code': ANSI.WHITE,
+};
+/**
+ * Approximate hex colors to ANSI by extracting the dominant channel
+ * (or detecting a balanced mix) and mapping to the closest ANSI hue.
+ */
+function hexToAnsi(hex) {
+    const r = Number.parseInt(hex.slice(1, 3), 16);
+    const g = Number.parseInt(hex.slice(3, 5), 16);
+    const b = Number.parseInt(hex.slice(5, 7), 16);
+    return pickPrimaryAnsi(r, g, b) ?? pickMixedAnsi(r, g, b) ?? ANSI.WHITE;
+}
+/** One channel dominates the other two — return its hue, or null. */
+function pickPrimaryAnsi(r, g, b) {
+    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;
+    return null;
+}
+/** Two or three channels are roughly equal and bright — pick the mix. */
+function pickMixedAnsi(r, g, b) {
+    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 null;
+}
+/**
+ * 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.className === 'sharpee-em')
+            return `*${innerText}*`;
+        if (decoration.className === 'sharpee-strong')
+            return `**${innerText}**`;
+        return innerText;
+    }
+    // ANSI rendering
+    let ansiCode = DECORATION_ANSI[decoration.className];
+    // Check for story-defined color, keyed on the final class name.
+    if (!ansiCode && options.colors?.[decoration.className]) {
+        const hex = options.colors[decoration.className];
+        if (hex.startsWith('#')) {
+            ansiCode = hexToAnsi(hex);
+        }
+    }
+    if (ansiCode) {
+        return `${ansiCode}${innerText}${ANSI.RESET}`;
+    }
+    // Unknown decoration class name - 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 display.
+ *
+ * Uses smart joining: single newline between consecutive blocks of the
+ * same key, double newline (or `options.blockSeparator`) between blocks
+ * of different keys. 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 = new Set(['status.room', 'status.score', 'status.turns']);
+    const customBlocks = statusBlocks.filter((b) => !knownKeys.has(b.key));
+    for (const block of customBlocks) {
+        parts.push(renderContent(block.content, options));
+    }
+    return parts.join(' | ');
+}
+//# sourceMappingURL=render-to-string.js.map

package/render-to-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-to-string.js","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/channel-service/src/render-to-string.ts"],"names":[],"mappings":"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"}

package/renderer/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @sharpee/channel-service/renderer — public surface.
+ *
+ * Owner context: consumer-side dispatcher. Re-exports the `Renderer`
+ * host, the `ChannelRenderer` plug-in contract, and the small helpers
+ * needed by concrete renderer hosts (browser, CLI, multi-user web
+ * client) per ADR-165 §1, §2, §3, §5, §7.
+ */
+export type { ChannelRenderer, Renderer as IRenderer, ChannelStateStore, SlotHandle, } from './types';
+export { Renderer, createRenderer, type RendererOptions } from './renderer';
+export { createJsonTreeFallbackFactory, type FallbackOutputSink, type FallbackWarningSink, } from './json-tree-fallback';
+//# sourceMappingURL=index.d.ts.map

package/renderer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/channel-service/src/renderer/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,YAAY,EACV,eAAe,EACf,QAAQ,IAAI,SAAS,EACrB,iBAAiB,EACjB,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,EACL,6BAA6B,EAC7B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC"}

package/renderer/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * @sharpee/channel-service/renderer — public surface.
+ *
+ * Owner context: consumer-side dispatcher. Re-exports the `Renderer`
+ * host, the `ChannelRenderer` plug-in contract, and the small helpers
+ * needed by concrete renderer hosts (browser, CLI, multi-user web
+ * client) per ADR-165 §1, §2, §3, §5, §7.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJsonTreeFallbackFactory = exports.createRenderer = exports.Renderer = void 0;
+var renderer_1 = require("./renderer");
+Object.defineProperty(exports, "Renderer", { enumerable: true, get: function () { return renderer_1.Renderer; } });
+Object.defineProperty(exports, "createRenderer", { enumerable: true, get: function () { return renderer_1.createRenderer; } });
+var json_tree_fallback_1 = require("./json-tree-fallback");
+Object.defineProperty(exports, "createJsonTreeFallbackFactory", { enumerable: true, get: function () { return json_tree_fallback_1.createJsonTreeFallbackFactory; } });
+//# sourceMappingURL=index.js.map

package/renderer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/channel-service/src/renderer/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AASH,uCAA4E;AAAnE,oGAAA,QAAQ,OAAA;AAAE,0GAAA,cAAc,OAAA;AAEjC,2DAI8B;AAH5B,mIAAA,6BAA6B,OAAA"}

package/renderer/json-tree-fallback.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @sharpee/channel-service/renderer — generic JSON-tree fallback.
+ *
+ * Owner context: consumer-side dispatcher. Per ADR-165 §3, a channel
+ * id that appears in the CMGT manifest but has no registered
+ * `ChannelRenderer` falls back to a generic JSON-tree view. This
+ * keeps unknown story channels visible-and-debuggable rather than
+ * silently dropped.
+ *
+ * The fallback this module ships logs a one-time warning per channel
+ * id and writes a JSON-stringified line to the console. Concrete
+ * platform consumers (browser, CLI) override the warning sink and
+ * the rendering surface — for now the default is enough to satisfy
+ * AC-3.
+ *
+ * @see ADR-165 — Renderer Architecture — §3, AC-3
+ */
+import type { ChannelRenderer } from './types';
+/**
+ * Sink for warnings emitted by the fallback. Defaults to
+ * `console.warn`. Tests inject a recording sink; concrete platform
+ * consumers can route to a logger.
+ */
+export type FallbackWarningSink = (message: string) => void;
+/**
+ * Sink for the rendered JSON-tree output. Defaults to `console.log`.
+ * Concrete consumers redirect to a debug pane or stdout.
+ */
+export type FallbackOutputSink = (channelId: string, json: string) => void;
+/**
+ * Construct a JSON-tree fallback renderer factory.
+ *
+ * The returned function builds a `ChannelRenderer` for a specific
+ * channel id; the dispatcher caches one per unrendered id so the
+ * "one-time warning" behavior is preserved across emissions.
+ *
+ * @param warn — sink for the one-time warning. Default `console.warn`.
+ * @param output — sink for the rendered JSON line. Default
+ *   `console.log`.
+ */
+export declare function createJsonTreeFallbackFactory(opts?: {
+    warn?: FallbackWarningSink;
+    output?: FallbackOutputSink;
+}): (channelId: string) => ChannelRenderer;
+//# sourceMappingURL=json-tree-fallback.d.ts.map

package/renderer/json-tree-fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-tree-fallback.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/channel-service/src/renderer/json-tree-fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAE5D;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE3E;;;;;;;;;;GAUG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,CAAC,EAAE;IACnD,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,eAAe,CAkBzC"}

package/renderer/json-tree-fallback.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * @sharpee/channel-service/renderer — generic JSON-tree fallback.
+ *
+ * Owner context: consumer-side dispatcher. Per ADR-165 §3, a channel
+ * id that appears in the CMGT manifest but has no registered
+ * `ChannelRenderer` falls back to a generic JSON-tree view. This
+ * keeps unknown story channels visible-and-debuggable rather than
+ * silently dropped.
+ *
+ * The fallback this module ships logs a one-time warning per channel
+ * id and writes a JSON-stringified line to the console. Concrete
+ * platform consumers (browser, CLI) override the warning sink and
+ * the rendering surface — for now the default is enough to satisfy
+ * AC-3.
+ *
+ * @see ADR-165 — Renderer Architecture — §3, AC-3
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createJsonTreeFallbackFactory = createJsonTreeFallbackFactory;
+/**
+ * Construct a JSON-tree fallback renderer factory.
+ *
+ * The returned function builds a `ChannelRenderer` for a specific
+ * channel id; the dispatcher caches one per unrendered id so the
+ * "one-time warning" behavior is preserved across emissions.
+ *
+ * @param warn — sink for the one-time warning. Default `console.warn`.
+ * @param output — sink for the rendered JSON line. Default
+ *   `console.log`.
+ */
+function createJsonTreeFallbackFactory(opts) {
+    const warn = opts?.warn ?? defaultWarn;
+    const output = opts?.output ?? defaultOutput;
+    const warned = new Set();
+    return (channelId) => ({
+        onValue(value, channel) {
+            if (!warned.has(channelId)) {
+                warned.add(channelId);
+                warn(`[channel-service] No renderer registered for channel '${channelId}' ` +
+                    `(contentType=${channel.contentType}, mode=${channel.mode}). ` +
+                    `Falling back to JSON-tree view; values will be JSON-stringified.`);
+            }
+            output(channelId, safeStringify(value));
+        },
+    });
+}
+function defaultWarn(message) {
+    // Console only — no alerting, no throwing. The dispatcher routes
+    // the JSON-tree output separately.
+    // eslint-disable-next-line no-console
+    console.warn(message);
+}
+function defaultOutput(channelId, json) {
+    // eslint-disable-next-line no-console
+    console.log(`[${channelId}] ${json}`);
+}
+/**
+ * `JSON.stringify` with a circular-reference fallback. Renderer
+ * fallback should never throw — bad data is debuggable, but a
+ * thrown stringifier breaks dispatch.
+ */
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+//# sourceMappingURL=json-tree-fallback.js.map

package/renderer/json-tree-fallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-tree-fallback.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/channel-service/src/renderer/json-tree-fallback.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;AA6BH,sEAqBC;AAhCD;;;;;;;;;;GAUG;AACH,SAAgB,6BAA6B,CAAC,IAG7C;IACC,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,WAAW,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,aAAa,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IAEjC,OAAO,CAAC,SAAiB,EAAmB,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAc,EAAE,OAA0B;YAChD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBACtB,IAAI,CACF,yDAAyD,SAAS,IAAI;oBACpE,gBAAgB,OAAO,CAAC,WAAW,UAAU,OAAO,CAAC,IAAI,KAAK;oBAC9D,kEAAkE,CACrE,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1C,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,iEAAiE;IACjE,mCAAmC;IACnC,sCAAsC;IACtC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,aAAa,CAAC,SAAiB,EAAE,IAAY;IACpD,sCAAsC;IACtC,OAAO,CAAC,GAAG,CAAC,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,kBAAkB,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/renderer/renderer.d.ts

@@ -0,0 +1,139 @@
+/**
+ * @sharpee/channel-service/renderer — `Renderer` host implementation.
+ *
+ * Owner context: consumer-side dispatcher. Drives `CmgtPacket` and
+ * `TurnPacket` instances into registered `ChannelRenderer` plug-ins,
+ * holds the channel state store, and pumps commands back to the
+ * engine.
+ *
+ * Public interface (per ADR-165 §2, §3, §4, §5, §7):
+ *  - `Renderer` class implementing the same-named interface.
+ *  - `createRenderer(opts)` factory for ergonomic instantiation.
+ *
+ * @see ADR-165 — Renderer Architecture
+ */
+import type { CmgtPacket, CommandPacket, TurnPacket } from "../../if-domain/index";
+import type { ChannelRenderer, ChannelStateStore, Renderer as RendererInterface, SlotHandle } from './types';
+import { type FallbackOutputSink, type FallbackWarningSink } from './json-tree-fallback';
+/**
+ * Optional construction options for the `Renderer`.
+ */
+export interface RendererOptions {
+    /**
+     * Sink for warnings (unrendered channels, payload keys not in the
+     * manifest). Defaults to `console.warn`.
+     */
+    warn?: (message: string) => void;
+    /**
+     * Sink for unhandled-channel JSON-tree output. Defaults to
+     * `console.log` — concrete consumers redirect to their debug surface.
+     */
+    fallbackOutput?: FallbackOutputSink;
+    /**
+     * Override the warning sink the fallback uses. Defaults to
+     * `opts.warn ?? console.warn`. Exposed as a separate option so
+     * tests can record fallback warnings independently of dispatch
+     * warnings.
+     */
+    fallbackWarn?: FallbackWarningSink;
+}
+/**
+ * Concrete `Renderer` host (ADR-165 §2).
+ *
+ * One instance per session. Holds:
+ *  - the registered `ChannelRenderer`s (last-write-wins per channel id),
+ *  - the channel state store (replace-latest, append-accumulating,
+ *    event-no-entry — ADR-165 §5),
+ *  - the slot handles (`getSlot` / `registerSlot` per §7),
+ *  - the current `CmgtPacket` (so `onValue` can pass the matching
+ *    `ChannelDefinition` to the renderer),
+ *  - the command-handler subscriber list.
+ *
+ * No DOM, no transport, no engine. Concrete consumers compose this
+ * with their host platform.
+ */
+export declare class Renderer implements RendererInterface {
+    private renderers;
+    private fallbackRenderers;
+    private state;
+    private slots;
+    private commandHandlers;
+    private currentManifest?;
+    private readonly warn;
+    private readonly buildFallback;
+    constructor(opts?: RendererOptions);
+    /**
+     * Register a `ChannelRenderer` (ADR-165 §3). Last-write-wins —
+     * re-registering replaces the prior renderer for that id.
+     */
+    registerRenderer(channelId: string, renderer: ChannelRenderer): void;
+    /**
+     * Register a slot (ADR-165 §7). Stories that replace the
+     * platform-default layout call this for each region.
+     */
+    registerSlot(name: string, handle: SlotHandle): void;
+    /**
+     * Resolve a slot handle, or `null` if not registered.
+     */
+    getSlot(name: string): SlotHandle | null;
+    /**
+     * Subscribe to commands emitted by channel renderers.
+     */
+    onCommand(handler: (cmd: CommandPacket) => void): void;
+    /**
+     * Emit a command from a `ChannelRenderer` (UI-gesture origin).
+     * All registered handlers receive the packet synchronously.
+     */
+    emitCommand(text: string): void;
+    /**
+     * Apply a CMGT packet (ADR-165 §4 lifecycle).
+     *
+     *  1. If a prior manifest exists, run `onDestroy` for each of its
+     *     renderers (in registration order for determinism).
+     *  2. Reset the state store.
+     *  3. Update the current manifest.
+     *  4. Run `onCmgt` for each new-manifest renderer in registration
+     *     order.
+     */
+    applyCmgt(packet: CmgtPacket): void;
+    /**
+     * Dispatch a turn packet (ADR-165 §4 dispatch contract).
+     *
+     * Iterates the current manifest in registration order. For each
+     * manifest entry that has a payload value, updates the state
+     * store per mode and invokes `onValue`. Handles the `clear`
+     * channel specially — empties append-mode state stores and fires
+     * `onClear` hooks.
+     */
+    applyTurnPacket(packet: TurnPacket): void;
+    /**
+     * Snapshot of the channel state store (deep-cloned) — for tests
+     * and ADR-163 AC-12 round-trip.
+     */
+    getStateSnapshot(): ChannelStateStore;
+    /**
+     * Update the state store per mode and invoke the renderer's
+     * `onValue`.
+     */
+    private applyChannelValue;
+    /**
+     * Handle a `clear` channel emission (ADR-165 §4 step 2).
+     *
+     * `value.target` (when set) names a specific append-mode channel
+     * to clear; an empty / missing target clears every append-mode
+     * channel currently registered in the manifest.
+     */
+    private handleClear;
+    /**
+     * Resolve the renderer for a channel id. Returns the registered
+     * renderer when present; otherwise lazily creates and caches a
+     * JSON-tree fallback (so the one-time warning fires once per
+     * channel id, not once per emission).
+     */
+    private resolveRenderer;
+}
+/**
+ * Convenience factory for `new Renderer(opts)`.
+ */
+export declare function createRenderer(opts?: RendererOptions): Renderer;
+//# sourceMappingURL=renderer.d.ts.map

package/renderer/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/channel-service/src/renderer/renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAEV,UAAU,EACV,aAAa,EACb,UAAU,EACX,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,QAAQ,IAAI,iBAAiB,EAC7B,UAAU,EACX,MAAM,SAAS,CAAC;AACjB,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,kBAAkB,CAAC;IACpC;;;;;OAKG;IACH,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,QAAS,YAAW,iBAAiB;IAChD,OAAO,CAAC,SAAS,CAAsC;IACvD,OAAO,CAAC,iBAAiB,CAAsC;IAC/D,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,eAAe,CAAC,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyC;gBAE3D,IAAI,GAAE,eAAoB;IAetC;;;OAGG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,IAAI;IAIpE;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAIpD;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAQxC;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAItD;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAW/B;;;;;;;;;OASG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAoBnC;;;;;;;;OAQG;IACH,eAAe,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IA8BzC;;;OAGG;IACH,gBAAgB,IAAI,iBAAiB;IAQrC;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAoBnB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;CAUxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,eAAoB,GAAG,QAAQ,CAEnE"}