@sharpee/text-blocks 0.9.61-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-npm/guards.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Type Guards for TextBlock types
+ *
+ * Utilities for safely working with TextContent, IDecoration, and ITextBlock.
+ */
+import type { TextContent, IDecoration, ITextBlock } from './types';
+/**
+ * Check if content is a decoration (not a plain string).
+ *
+ * @example
+ * const content: TextContent = getContent();
+ * if (isDecoration(content)) {
+ *   console.log(content.type); // TypeScript knows this is IDecoration
+ * }
+ */
+export declare function isDecoration(content: TextContent): content is IDecoration;
+/**
+ * Check if a value is a valid TextBlock.
+ *
+ * @example
+ * if (isTextBlock(value)) {
+ *   console.log(value.key);
+ * }
+ */
+export declare function isTextBlock(value: unknown): value is ITextBlock;
+/**
+ * Check if a block key starts with a given prefix.
+ *
+ * @example
+ * if (hasKeyPrefix(block, 'status.')) {
+ *   // Render to status bar
+ * }
+ */
+export declare function hasKeyPrefix(block: ITextBlock, prefix: string): boolean;
+/**
+ * Check if a block is a status block.
+ */
+export declare function isStatusBlock(block: ITextBlock): boolean;
+/**
+ * Check if a block is a room-related block.
+ */
+export declare function isRoomBlock(block: ITextBlock): boolean;
+/**
+ * Check if a block is an action-related block.
+ */
+export declare function isActionBlock(block: ITextBlock): boolean;
+/**
+ * Extract plain text from TextContent, stripping all decorations.
+ *
+ * @example
+ * const text = extractPlainText([
+ *   'You take ',
+ *   { type: 'item', content: ['the sword'] },
+ *   '.'
+ * ]);
+ * // Returns: "You take the sword."
+ */
+export declare function extractPlainText(content: ReadonlyArray<TextContent>): string;
+//# sourceMappingURL=guards.d.ts.map

package/dist-npm/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,IAAI,WAAW,CAEzE;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAS/D;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAExD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAExD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,MAAM,CAS5E"}

package/dist-npm/guards.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Type Guards for TextBlock types
+ *
+ * Utilities for safely working with TextContent, IDecoration, and ITextBlock.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDecoration = isDecoration;
+exports.isTextBlock = isTextBlock;
+exports.hasKeyPrefix = hasKeyPrefix;
+exports.isStatusBlock = isStatusBlock;
+exports.isRoomBlock = isRoomBlock;
+exports.isActionBlock = isActionBlock;
+exports.extractPlainText = extractPlainText;
+/**
+ * Check if content is a decoration (not a plain string).
+ *
+ * @example
+ * const content: TextContent = getContent();
+ * if (isDecoration(content)) {
+ *   console.log(content.type); // TypeScript knows this is IDecoration
+ * }
+ */
+function isDecoration(content) {
+    return typeof content === 'object' && content !== null && 'type' in content && 'content' in content;
+}
+/**
+ * Check if a value is a valid TextBlock.
+ *
+ * @example
+ * if (isTextBlock(value)) {
+ *   console.log(value.key);
+ * }
+ */
+function isTextBlock(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'key' in value &&
+        'content' in value &&
+        typeof value.key === 'string' &&
+        Array.isArray(value.content));
+}
+/**
+ * Check if a block key starts with a given prefix.
+ *
+ * @example
+ * if (hasKeyPrefix(block, 'status.')) {
+ *   // Render to status bar
+ * }
+ */
+function hasKeyPrefix(block, prefix) {
+    return block.key.startsWith(prefix);
+}
+/**
+ * Check if a block is a status block.
+ */
+function isStatusBlock(block) {
+    return hasKeyPrefix(block, 'status.');
+}
+/**
+ * Check if a block is a room-related block.
+ */
+function isRoomBlock(block) {
+    return hasKeyPrefix(block, 'room.');
+}
+/**
+ * Check if a block is an action-related block.
+ */
+function isActionBlock(block) {
+    return hasKeyPrefix(block, 'action.');
+}
+/**
+ * Extract plain text from TextContent, stripping all decorations.
+ *
+ * @example
+ * const text = extractPlainText([
+ *   'You take ',
+ *   { type: 'item', content: ['the sword'] },
+ *   '.'
+ * ]);
+ * // Returns: "You take the sword."
+ */
+function extractPlainText(content) {
+    return content
+        .map((item) => {
+        if (typeof item === 'string') {
+            return item;
+        }
+        return extractPlainText(item.content);
+    })
+        .join('');
+}
+//# sourceMappingURL=guards.js.map

package/dist-npm/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../src/guards.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAaH,oCAEC;AAUD,kCASC;AAUD,oCAEC;AAKD,sCAEC;AAKD,kCAEC;AAKD,sCAEC;AAaD,4CASC;AArFD;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAAC,OAAoB;IAC/C,OAAO,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,MAAM,IAAI,OAAO,IAAI,SAAS,IAAI,OAAO,CAAC;AACtG,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,IAAI,KAAK;QACd,SAAS,IAAI,KAAK;QAClB,OAAQ,KAAoB,CAAC,GAAG,KAAK,QAAQ;QAC7C,KAAK,CAAC,OAAO,CAAE,KAAoB,CAAC,OAAO,CAAC,CAC7C,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,YAAY,CAAC,KAAiB,EAAE,MAAc;IAC5D,OAAO,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,KAAiB;IAC7C,OAAO,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAiB;IAC3C,OAAO,YAAY,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,KAAiB;IAC7C,OAAO,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAgB,gBAAgB,CAAC,OAAmC;IAClE,OAAO,OAAO;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxC,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC"}

package/dist-npm/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @sharpee/text-blocks
+ *
+ * Pure interfaces for structured text output in Sharpee IF platform.
+ *
+ * This package contains only TypeScript interfaces and type guards -
+ * no runtime dependencies. It defines the contract between TextService
+ * and clients (CLI, React, etc.).
+ *
+ * @packageDocumentation
+ * @see ADR-096: Text Service Architecture
+ * @see ADR-091: Text Decorations
+ */
+export type { TextContent, IDecoration, ITextBlock } from './types.js';
+export { CORE_DECORATION_TYPES, CORE_BLOCK_KEYS } from './types.js';
+export { CORE_BLOCK_KEYS as BLOCK_KEYS } from './types.js';
+export { isDecoration, isTextBlock, hasKeyPrefix, isStatusBlock, isRoomBlock, isActionBlock, extractPlainText, } from './guards.js';
+export declare const BLOCK_KEY_PREFIXES: {
+    readonly STATUS: "status.";
+    readonly ROOM: "room.";
+    readonly ACTION: "action.";
+};
+//# sourceMappingURL=index.d.ts.map

package/dist-npm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGvE,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGpE,OAAO,EAAE,eAAe,IAAI,UAAU,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,EACL,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC"}

package/dist-npm/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * @sharpee/text-blocks
+ *
+ * Pure interfaces for structured text output in Sharpee IF platform.
+ *
+ * This package contains only TypeScript interfaces and type guards -
+ * no runtime dependencies. It defines the contract between TextService
+ * and clients (CLI, React, etc.).
+ *
+ * @packageDocumentation
+ * @see ADR-096: Text Service Architecture
+ * @see ADR-091: Text Decorations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BLOCK_KEY_PREFIXES = exports.extractPlainText = exports.isActionBlock = exports.isRoomBlock = exports.isStatusBlock = exports.hasKeyPrefix = exports.isTextBlock = exports.isDecoration = exports.BLOCK_KEYS = exports.CORE_BLOCK_KEYS = exports.CORE_DECORATION_TYPES = void 0;
+// Constants
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "CORE_DECORATION_TYPES", { enumerable: true, get: function () { return types_js_1.CORE_DECORATION_TYPES; } });
+Object.defineProperty(exports, "CORE_BLOCK_KEYS", { enumerable: true, get: function () { return types_js_1.CORE_BLOCK_KEYS; } });
+// Alias for text-service compatibility
+var types_js_2 = require("./types.js");
+Object.defineProperty(exports, "BLOCK_KEYS", { enumerable: true, get: function () { return types_js_2.CORE_BLOCK_KEYS; } });
+// Type guards and utilities
+var guards_js_1 = require("./guards.js");
+Object.defineProperty(exports, "isDecoration", { enumerable: true, get: function () { return guards_js_1.isDecoration; } });
+Object.defineProperty(exports, "isTextBlock", { enumerable: true, get: function () { return guards_js_1.isTextBlock; } });
+Object.defineProperty(exports, "hasKeyPrefix", { enumerable: true, get: function () { return guards_js_1.hasKeyPrefix; } });
+Object.defineProperty(exports, "isStatusBlock", { enumerable: true, get: function () { return guards_js_1.isStatusBlock; } });
+Object.defineProperty(exports, "isRoomBlock", { enumerable: true, get: function () { return guards_js_1.isRoomBlock; } });
+Object.defineProperty(exports, "isActionBlock", { enumerable: true, get: function () { return guards_js_1.isActionBlock; } });
+Object.defineProperty(exports, "extractPlainText", { enumerable: true, get: function () { return guards_js_1.extractPlainText; } });
+// Block key prefixes for routing
+exports.BLOCK_KEY_PREFIXES = {
+    STATUS: 'status.',
+    ROOM: 'room.',
+    ACTION: 'action.',
+};
+//# sourceMappingURL=index.js.map

package/dist-npm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAKH,YAAY;AACZ,uCAAoE;AAA3D,iHAAA,qBAAqB,OAAA;AAAE,2GAAA,eAAe,OAAA;AAE/C,uCAAuC;AACvC,uCAA2D;AAAlD,sGAAA,eAAe,OAAc;AAEtC,4BAA4B;AAC5B,yCAQqB;AAPnB,yGAAA,YAAY,OAAA;AACZ,wGAAA,WAAW,OAAA;AACX,yGAAA,YAAY,OAAA;AACZ,0GAAA,aAAa,OAAA;AACb,wGAAA,WAAW,OAAA;AACX,0GAAA,aAAa,OAAA;AACb,6GAAA,gBAAgB,OAAA;AAGlB,iCAAiC;AACpB,QAAA,kBAAkB,GAAG;IAChC,MAAM,EAAE,SAAS;IACjB,IAAI,EAAE,OAAO;IACb,MAAM,EAAE,SAAS;CACT,CAAC"}

package/dist-npm/types.d.ts

@@ -0,0 +1,168 @@
+/**
+ * @sharpee/text-blocks
+ *
+ * Pure interfaces for structured text output.
+ * No runtime dependencies - types only.
+ *
+ * @see ADR-096: Text Service Architecture
+ * @see ADR-091: Text Decorations
+ */
+/**
+ * Content within a text block - either plain string or decorated content.
+ *
+ * @example
+ * // Plain text
+ * const plain: TextContent = "You take the sword.";
+ *
+ * // Decorated content
+ * const decorated: TextContent = {
+ *   type: 'item',
+ *   content: ['brass lantern']
+ * };
+ */
+export type TextContent = string | IDecoration;
+/**
+ * Decorated content with semantic type.
+ *
+ * The `type` field is an open string to support:
+ * - Core types: 'em', 'strong', 'item', 'room', 'npc', 'command', 'direction'
+ * - Presentational: 'underline', 'strikethrough', 'super', 'sub'
+ * - Story-defined: 'photopia.red', 'dungeo.thief', etc.
+ *
+ * @example
+ * // Emphasis
+ * { type: 'em', content: ['carefully'] }
+ *
+ * // Item name
+ * { type: 'item', content: ['brass lantern'] }
+ *
+ * // Nested decorations
+ * { type: 'item', content: [
+ *   { type: 'em', content: ['glowing'] },
+ *   ' lantern'
+ * ]}
+ *
+ * // Story-defined color (Photopia pattern)
+ * { type: 'photopia.red', content: ['The light was red, like always.'] }
+ */
+export interface IDecoration {
+    /**
+     * Semantic type of the decoration.
+     * Open string to allow story extensions.
+     */
+    readonly type: string;
+    /**
+     * Content within the decoration.
+     * Can contain nested decorations or plain strings.
+     */
+    readonly content: ReadonlyArray<TextContent>;
+}
+/**
+ * A block of text output with semantic key (channel).
+ *
+ * Keys act as channels (FyreVM pattern). Clients route blocks by key:
+ * - `room.name` - Room title
+ * - `room.description` - Room description
+ * - `room.contents` - Items in room
+ * - `action.result` - Action outcome
+ * - `action.blocked` - Why action failed
+ * - `status.room` - Current location (status bar)
+ * - `status.score` - Current score (status bar)
+ * - `status.turns` - Turn count (status bar)
+ * - `error` - System errors
+ * - `prompt` - Command prompt
+ * - Story-defined keys: 'dungeo.thief.taunt', etc.
+ *
+ * @example
+ * // Room name block
+ * {
+ *   key: 'room.name',
+ *   content: [{ type: 'room', content: ['West of House'] }]
+ * }
+ *
+ * // Action result with decorated item
+ * {
+ *   key: 'action.result',
+ *   content: [
+ *     'You take ',
+ *     { type: 'item', content: ['the brass lantern'] },
+ *     '.'
+ *   ]
+ * }
+ *
+ * // Status bar block
+ * {
+ *   key: 'status.score',
+ *   content: ['42']
+ * }
+ */
+export interface ITextBlock {
+    /**
+     * Semantic key identifying the block type/channel.
+     * Clients route blocks to UI regions based on key prefix.
+     */
+    readonly key: string;
+    /**
+     * Block content - array of plain strings and decorations.
+     */
+    readonly content: ReadonlyArray<TextContent>;
+}
+/**
+ * Core decoration types defined by the platform.
+ * Stories can extend with custom types.
+ */
+export declare const CORE_DECORATION_TYPES: {
+    /** Emphasis (typically italic) */
+    readonly EM: "em";
+    /** Strong emphasis (typically bold) */
+    readonly STRONG: "strong";
+    /** Item/object name */
+    readonly ITEM: "item";
+    /** Room/location name */
+    readonly ROOM: "room";
+    /** NPC/character name */
+    readonly NPC: "npc";
+    /** Suggested command */
+    readonly COMMAND: "command";
+    /** Exit direction */
+    readonly DIRECTION: "direction";
+    /** Underlined text */
+    readonly UNDERLINE: "underline";
+    /** Struck-through text */
+    readonly STRIKETHROUGH: "strikethrough";
+    /** Superscript */
+    readonly SUPER: "super";
+    /** Subscript */
+    readonly SUB: "sub";
+};
+/**
+ * Core block keys defined by the platform.
+ * Stories can emit custom keys.
+ */
+export declare const CORE_BLOCK_KEYS: {
+    /** Room title */
+    readonly ROOM_NAME: "room.name";
+    /** Room description */
+    readonly ROOM_DESCRIPTION: "room.description";
+    /** Items visible in room */
+    readonly ROOM_CONTENTS: "room.contents";
+    /** Action success result */
+    readonly ACTION_RESULT: "action.result";
+    /** Action blocked message */
+    readonly ACTION_BLOCKED: "action.blocked";
+    /** Current room (status bar) */
+    readonly STATUS_ROOM: "status.room";
+    /** Current score (status bar) */
+    readonly STATUS_SCORE: "status.score";
+    /** Turn count (status bar) */
+    readonly STATUS_TURNS: "status.turns";
+    /** System error */
+    readonly ERROR: "error";
+    /** Command prompt */
+    readonly PROMPT: "prompt";
+    /** Game/story message */
+    readonly GAME_MESSAGE: "game.message";
+    /** Game opening banner */
+    readonly GAME_BANNER: "game.banner";
+};
+//# sourceMappingURL=types.d.ts.map

package/dist-npm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;CAC9C;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB;IAChC,kCAAkC;;IAElC,uCAAuC;;IAEvC,uBAAuB;;IAEvB,yBAAyB;;IAEzB,yBAAyB;;IAEzB,wBAAwB;;IAExB,qBAAqB;;IAErB,sBAAsB;;IAEtB,0BAA0B;;IAE1B,kBAAkB;;IAElB,gBAAgB;;CAER,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,eAAe;IAC1B,iBAAiB;;IAEjB,uBAAuB;;IAEvB,4BAA4B;;IAE5B,4BAA4B;;IAE5B,6BAA6B;;IAE7B,gCAAgC;;IAEhC,iCAAiC;;IAEjC,8BAA8B;;IAE9B,mBAAmB;;IAEnB,qBAAqB;;IAErB,yBAAyB;;IAEzB,0BAA0B;;CAElB,CAAC"}

package/dist-npm/types.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * @sharpee/text-blocks
+ *
+ * Pure interfaces for structured text output.
+ * No runtime dependencies - types only.
+ *
+ * @see ADR-096: Text Service Architecture
+ * @see ADR-091: Text Decorations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CORE_BLOCK_KEYS = exports.CORE_DECORATION_TYPES = void 0;
+/**
+ * Core decoration types defined by the platform.
+ * Stories can extend with custom types.
+ */
+exports.CORE_DECORATION_TYPES = {
+    /** Emphasis (typically italic) */
+    EM: 'em',
+    /** Strong emphasis (typically bold) */
+    STRONG: 'strong',
+    /** Item/object name */
+    ITEM: 'item',
+    /** Room/location name */
+    ROOM: 'room',
+    /** NPC/character name */
+    NPC: 'npc',
+    /** Suggested command */
+    COMMAND: 'command',
+    /** Exit direction */
+    DIRECTION: 'direction',
+    /** Underlined text */
+    UNDERLINE: 'underline',
+    /** Struck-through text */
+    STRIKETHROUGH: 'strikethrough',
+    /** Superscript */
+    SUPER: 'super',
+    /** Subscript */
+    SUB: 'sub',
+};
+/**
+ * Core block keys defined by the platform.
+ * Stories can emit custom keys.
+ */
+exports.CORE_BLOCK_KEYS = {
+    /** Room title */
+    ROOM_NAME: 'room.name',
+    /** Room description */
+    ROOM_DESCRIPTION: 'room.description',
+    /** Items visible in room */
+    ROOM_CONTENTS: 'room.contents',
+    /** Action success result */
+    ACTION_RESULT: 'action.result',
+    /** Action blocked message */
+    ACTION_BLOCKED: 'action.blocked',
+    /** Current room (status bar) */
+    STATUS_ROOM: 'status.room',
+    /** Current score (status bar) */
+    STATUS_SCORE: 'status.score',
+    /** Turn count (status bar) */
+    STATUS_TURNS: 'status.turns',
+    /** System error */
+    ERROR: 'error',
+    /** Command prompt */
+    PROMPT: 'prompt',
+    /** Game/story message */
+    GAME_MESSAGE: 'game.message',
+    /** Game opening banner */
+    GAME_BANNER: 'game.banner',
+};
+//# sourceMappingURL=types.js.map

package/dist-npm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AA2GH;;;GAGG;AACU,QAAA,qBAAqB,GAAG;IACnC,kCAAkC;IAClC,EAAE,EAAE,IAAI;IACR,uCAAuC;IACvC,MAAM,EAAE,QAAQ;IAChB,uBAAuB;IACvB,IAAI,EAAE,MAAM;IACZ,yBAAyB;IACzB,IAAI,EAAE,MAAM;IACZ,yBAAyB;IACzB,GAAG,EAAE,KAAK;IACV,wBAAwB;IACxB,OAAO,EAAE,SAAS;IAClB,qBAAqB;IACrB,SAAS,EAAE,WAAW;IACtB,sBAAsB;IACtB,SAAS,EAAE,WAAW;IACtB,0BAA0B;IAC1B,aAAa,EAAE,eAAe;IAC9B,kBAAkB;IAClB,KAAK,EAAE,OAAO;IACd,gBAAgB;IAChB,GAAG,EAAE,KAAK;CACF,CAAC;AAEX;;;GAGG;AACU,QAAA,eAAe,GAAG;IAC7B,iBAAiB;IACjB,SAAS,EAAE,WAAW;IACtB,uBAAuB;IACvB,gBAAgB,EAAE,kBAAkB;IACpC,4BAA4B;IAC5B,aAAa,EAAE,eAAe;IAC9B,4BAA4B;IAC5B,aAAa,EAAE,eAAe;IAC9B,6BAA6B;IAC7B,cAAc,EAAE,gBAAgB;IAChC,gCAAgC;IAChC,WAAW,EAAE,aAAa;IAC1B,iCAAiC;IACjC,YAAY,EAAE,cAAc;IAC5B,8BAA8B;IAC9B,YAAY,EAAE,cAAc;IAC5B,mBAAmB;IACnB,KAAK,EAAE,OAAO;IACd,qBAAqB;IACrB,MAAM,EAAE,QAAQ;IAChB,yBAAyB;IACzB,YAAY,EAAE,cAAc;IAC5B,0BAA0B;IAC1B,WAAW,EAAE,aAAa;CAClB,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@sharpee/text-blocks",
+  "version": "0.9.61-beta",
+  "description": "Pure interfaces for structured text output (ITextBlock, IDecoration)",
+  "main": "dist-npm/index.js",
+  "types": "dist-npm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist-npm/index.d.ts",
+      "import": "./dist-npm/index.js",
+      "require": "./dist-npm/index.js"
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.8.0",
+    "@typescript-eslint/eslint-plugin": "^6.7.4",
+    "@typescript-eslint/parser": "^6.7.4",
+    "eslint": "^8.50.0",
+    "rimraf": "^5.0.5",
+    "typescript": "^5.2.2"
+  },
+  "files": [
+    "dist-npm"
+  ],
+  "keywords": [
+    "interactive-fiction",
+    "if",
+    "text-adventure",
+    "sharpee",
+    "text-blocks",
+    "structured-output"
+  ],
+  "author": "Sharpee Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ChicagoDave/sharpee.git",
+    "directory": "packages/text-blocks"
+  },
+  "homepage": "https://github.com/ChicagoDave/sharpee#readme",
+  "bugs": {
+    "url": "https://github.com/ChicagoDave/sharpee/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rimraf dist",
+    "lint": "eslint src --ext .ts",
+    "build:npm": "tsc --outDir dist-npm"
+  }
+}