@sharpee/stdlib 0.9.60-beta

package/dist/events/helpers.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * Helper utilities for common event handler patterns
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createToggleHandler = createToggleHandler;
+exports.createOpenHandler = createOpenHandler;
+exports.createRevealHandler = createRevealHandler;
+exports.createMessageHandler = createMessageHandler;
+exports.composeHandlers = composeHandlers;
+exports.createOnceHandler = createOnceHandler;
+exports.createAfterHandler = createAfterHandler;
+exports.createConditionalHandler = createConditionalHandler;
+/**
+ * Create a handler that toggles a switchable entity
+ */
+function createToggleHandler(entity) {
+    return (event, _world) => {
+        // Toggle the switch state
+        const switchable = entity.get('SWITCHABLE');
+        if (switchable && 'isOn' in switchable) {
+            switchable.isOn = !switchable.isOn;
+            // Return event indicating the state change
+            return [{
+                    id: `${Date.now()}-toggled`,
+                    type: 'if.event.toggled',
+                    timestamp: Date.now(),
+                    data: {
+                        entity: entity.id,
+                        newState: switchable.isOn
+                    },
+                    entities: { [entity.id]: entity }
+                }];
+        }
+        return undefined;
+    };
+}
+/**
+ * Create a handler that opens something when triggered
+ */
+function createOpenHandler(entity, target) {
+    return (event, _world) => {
+        // Return event to open the target
+        return [{
+                id: `${Date.now()}-open-triggered`,
+                type: 'if.event.open_triggered',
+                timestamp: Date.now(),
+                data: {
+                    trigger: entity.id,
+                    target: target
+                },
+                entities: { [entity.id]: entity }
+            }];
+    };
+}
+/**
+ * Create a handler that reveals a hidden passage
+ */
+function createRevealHandler(entity, passage) {
+    return (event, _world) => {
+        // Return event to reveal the passage
+        return [{
+                id: `${Date.now()}-passage-revealed`,
+                type: 'if.event.passage_revealed',
+                timestamp: Date.now(),
+                data: {
+                    trigger: entity.id,
+                    passage: passage
+                },
+                entities: { [entity.id]: entity }
+            }];
+    };
+}
+/**
+ * Create a handler that displays a message
+ */
+function createMessageHandler(message, params) {
+    return (event, _world) => {
+        return [{
+                id: `${Date.now()}-custom-message`,
+                type: 'action.message',
+                timestamp: Date.now(),
+                data: {
+                    messageId: 'custom',
+                    message: message,
+                    params: params || {}
+                },
+                entities: {}
+            }];
+    };
+}
+/**
+ * Compose multiple handlers into one
+ */
+function composeHandlers(...handlers) {
+    return (event, world) => {
+        const results = [];
+        for (const handler of handlers) {
+            const result = handler(event, world);
+            if (result && Array.isArray(result)) {
+                results.push(...result);
+            }
+        }
+        return results.length > 0 ? results : undefined;
+    };
+}
+/**
+ * Create a handler that only fires once
+ */
+function createOnceHandler(handler) {
+    let fired = false;
+    return (event, world) => {
+        if (!fired) {
+            fired = true;
+            return handler(event, world);
+        }
+    };
+}
+/**
+ * Create a handler that only fires after N times
+ */
+function createAfterHandler(count, handler) {
+    let callCount = 0;
+    return (event, world) => {
+        callCount++;
+        if (callCount >= count) {
+            return handler(event, world);
+        }
+    };
+}
+/**
+ * Create a handler with a condition
+ */
+function createConditionalHandler(condition, handler) {
+    return (event, world) => {
+        if (condition(event)) {
+            return handler(event, world);
+        }
+    };
+}
+//# sourceMappingURL=helpers.js.map

package/dist/events/helpers.js.map

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

package/dist/events/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Event utilities and patterns for IF actions
+ *
+ * This module provides optional utilities and patterns that
+ * actions can use to create consistent event data structures.
+ * Actions are free to define their own event data types.
+ */
+export * from './action-events';
+export * from './common-patterns';
+export * from './event-utils';
+export * from './event-registry';
+/**
+ * Design principle: Each action defines its own event data types
+ * in its own folder. This keeps related code together and makes
+ * the system more modular.
+ *
+ * Example:
+ * ```
+ * /actions/standard/closing/
+ * ├── closing.ts                    // Action logic
+ * ├── closing-event-data.ts         // Success event data
+ * └── closing-error-*.ts            // Error event data
+ * ```
+ */
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AAEjC;;;;;;;;;;;;GAYG"}

package/dist/events/index.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Event utilities and patterns for IF actions
+ *
+ * This module provides optional utilities and patterns that
+ * actions can use to create consistent event data structures.
+ * Actions are free to define their own event data types.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./action-events"), exports);
+__exportStar(require("./common-patterns"), exports);
+__exportStar(require("./event-utils"), exports);
+__exportStar(require("./event-registry"), exports);
+/**
+ * Design principle: Each action defines its own event data types
+ * in its own folder. This keeps related code together and makes
+ * the system more modular.
+ *
+ * Example:
+ * ```
+ * /actions/standard/closing/
+ * ├── closing.ts                    // Action logic
+ * ├── closing-event-data.ts         // Success event data
+ * └── closing-error-*.ts            // Error event data
+ * ```
+ */
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;AAEH,kDAAgC;AAChC,oDAAkC;AAClC,gDAA8B;AAC9B,mDAAiC;AAEjC;;;;;;;;;;;;GAYG"}

package/dist/helpers/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Stdlib Helpers
+ */
+export * from './multi-object-handler';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,wBAAwB,CAAC"}

package/dist/helpers/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * Stdlib Helpers
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./multi-object-handler"), exports);
+//# sourceMappingURL=index.js.map

package/dist/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,yDAAuC"}

package/dist/helpers/multi-object-handler.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Multi-Object Handler
+ *
+ * Handles "take all", "take all but X", and "take X and Y" patterns.
+ * Actions use this helper to expand multi-object commands into entity lists.
+ */
+import { IFEntity, WorldModel } from '@sharpee/world-model';
+import { ActionContext } from '../actions/enhanced-types';
+import { INounPhrase } from '@sharpee/world-model';
+/**
+ * Result of processing a single entity in a multi-object command
+ */
+export interface MultiObjectItem {
+    entity: IFEntity;
+    nounPhrase?: INounPhrase;
+}
+/**
+ * Options for multi-object expansion
+ */
+export interface MultiObjectOptions {
+    /** Filter function to determine which entities are valid targets */
+    filter?: (entity: IFEntity, world: WorldModel) => boolean;
+    /** Required scope level (default: reachable) */
+    scope?: 'carried' | 'reachable' | 'visible';
+}
+/**
+ * Check if the current command is a multi-object command (isAll or isList)
+ */
+export declare function isMultiObjectCommand(context: ActionContext): boolean;
+/**
+ * Check if the current command uses "all" keyword
+ */
+export declare function isAllCommand(context: ActionContext): boolean;
+/**
+ * Check if the current command is a list (X and Y)
+ */
+export declare function isListCommand(context: ActionContext): boolean;
+/**
+ * Get excluded entity names from "all but X" pattern
+ */
+export declare function getExcludedNames(context: ActionContext): string[];
+/**
+ * Expand a multi-object command into a list of target entities.
+ *
+ * For "take all": Returns all entities matching scope/filter, minus excluded
+ * For "take X and Y": Returns resolved entities for each item
+ * For single object: Returns the single resolved entity
+ *
+ * @param context Action context
+ * @param options Filter and scope options
+ * @returns Array of entities to process
+ */
+export declare function expandMultiObject(context: ActionContext, options?: MultiObjectOptions): MultiObjectItem[];
+//# sourceMappingURL=multi-object-handler.d.ts.map

package/dist/helpers/multi-object-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-object-handler.d.ts","sourceRoot":"","sources":["../../src/helpers/multi-object-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAa,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;IAC1D,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;CAC7C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAGpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,EAAE,CAMjE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,kBAAuB,GAC/B,eAAe,EAAE,CAuBnB"}

package/dist/helpers/multi-object-handler.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Multi-Object Handler
+ *
+ * Handles "take all", "take all but X", and "take X and Y" patterns.
+ * Actions use this helper to expand multi-object commands into entity lists.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMultiObjectCommand = isMultiObjectCommand;
+exports.isAllCommand = isAllCommand;
+exports.isListCommand = isListCommand;
+exports.getExcludedNames = getExcludedNames;
+exports.expandMultiObject = expandMultiObject;
+const world_model_1 = require("@sharpee/world-model");
+const scope_resolver_1 = require("../scope/scope-resolver");
+/**
+ * Check if the current command is a multi-object command (isAll or isList)
+ */
+function isMultiObjectCommand(context) {
+    const directObject = context.command.parsed.structure.directObject;
+    return !!(directObject?.isAll || directObject?.isList);
+}
+/**
+ * Check if the current command uses "all" keyword
+ */
+function isAllCommand(context) {
+    return context.command.parsed.structure.directObject?.isAll === true;
+}
+/**
+ * Check if the current command is a list (X and Y)
+ */
+function isListCommand(context) {
+    return context.command.parsed.structure.directObject?.isList === true;
+}
+/**
+ * Get excluded entity names from "all but X" pattern
+ */
+function getExcludedNames(context) {
+    const excluded = context.command.parsed.excluded;
+    if (!excluded || excluded.length === 0) {
+        return [];
+    }
+    return excluded.map(np => np.head || np.text).map(s => s.toLowerCase());
+}
+/**
+ * Expand a multi-object command into a list of target entities.
+ *
+ * For "take all": Returns all entities matching scope/filter, minus excluded
+ * For "take X and Y": Returns resolved entities for each item
+ * For single object: Returns the single resolved entity
+ *
+ * @param context Action context
+ * @param options Filter and scope options
+ * @returns Array of entities to process
+ */
+function expandMultiObject(context, options = {}) {
+    const directObject = context.command.parsed.structure.directObject;
+    const world = context.world;
+    const player = context.player;
+    // Handle "all" keyword
+    if (directObject?.isAll) {
+        return expandAll(context, options);
+    }
+    // Handle list "X and Y"
+    if (directObject?.isList && directObject.items) {
+        return expandList(context, directObject.items, options);
+    }
+    // Single object - use the already-resolved entity
+    const entity = context.command.directObject?.entity;
+    if (entity) {
+        return [{ entity }];
+    }
+    // No target
+    return [];
+}
+/**
+ * Expand "all" into matching entities
+ */
+function expandAll(context, options) {
+    const world = context.world;
+    const player = context.player;
+    const scopeResolver = new scope_resolver_1.StandardScopeResolver(world);
+    // Get entities based on scope
+    let candidates;
+    switch (options.scope) {
+        case 'carried':
+            candidates = world.getContents(player.id);
+            break;
+        case 'visible':
+            candidates = scopeResolver.getVisible(player);
+            break;
+        case 'reachable':
+        default:
+            candidates = scopeResolver.getReachable(player);
+            break;
+    }
+    // Apply filter if provided
+    if (options.filter) {
+        candidates = candidates.filter(e => options.filter(e, world));
+    }
+    // Apply default portable filter (not room, not scenery, not actor)
+    candidates = candidates.filter(e => isPortable(e));
+    // Apply exclusions from "all but X"
+    const excludedNames = getExcludedNames(context);
+    if (excludedNames.length > 0) {
+        candidates = candidates.filter(e => {
+            const name = e.name.toLowerCase();
+            const aliases = getEntityAliases(e).map(a => a.toLowerCase());
+            // Exclude if name or any alias matches excluded list
+            return !excludedNames.includes(name) &&
+                !aliases.some(a => excludedNames.includes(a));
+        });
+    }
+    return candidates.map(entity => ({ entity }));
+}
+/**
+ * Expand list items "X and Y" into entities
+ */
+function expandList(context, items, options) {
+    const world = context.world;
+    const player = context.player;
+    const scopeResolver = new scope_resolver_1.StandardScopeResolver(world);
+    const results = [];
+    // Get scope candidates
+    let scopeCandidates;
+    switch (options.scope) {
+        case 'carried':
+            scopeCandidates = world.getContents(player.id);
+            break;
+        case 'visible':
+            scopeCandidates = scopeResolver.getVisible(player);
+            break;
+        case 'reachable':
+        default:
+            scopeCandidates = scopeResolver.getReachable(player);
+            break;
+    }
+    // Resolve each item in the list
+    for (const item of items) {
+        const searchTerm = (item.head || item.text).toLowerCase();
+        // Find matching entity in scope
+        const match = scopeCandidates.find(e => {
+            const name = e.name.toLowerCase();
+            const aliases = getEntityAliases(e).map(a => a.toLowerCase());
+            return name === searchTerm || aliases.includes(searchTerm);
+        });
+        if (match) {
+            // Apply filter if provided
+            if (!options.filter || options.filter(match, world)) {
+                results.push({ entity: match, nounPhrase: item });
+            }
+        }
+        // Note: If item doesn't resolve, we skip it (partial success)
+        // The action can check results.length vs items.length to detect this
+    }
+    return results;
+}
+/**
+ * Check if an entity is portable (can be taken)
+ */
+function isPortable(entity) {
+    // Can't take rooms
+    if (entity.has(world_model_1.TraitType.ROOM)) {
+        return false;
+    }
+    // Can't take scenery
+    if (entity.has(world_model_1.TraitType.SCENERY)) {
+        return false;
+    }
+    // Can't take actors
+    if (entity.has(world_model_1.TraitType.ACTOR)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Get entity aliases from identity trait
+ */
+function getEntityAliases(entity) {
+    const identity = entity.get(world_model_1.TraitType.IDENTITY);
+    if (identity && typeof identity === 'object' && 'aliases' in identity) {
+        const aliases = identity.aliases;
+        if (Array.isArray(aliases)) {
+            return aliases.map(String);
+        }
+    }
+    return [];
+}
+//# sourceMappingURL=multi-object-handler.js.map

package/dist/helpers/multi-object-handler.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @sharpee/stdlib - Standard library for Sharpee IF Platform
+ *
+ * This package provides:
+ * - Standard action implementations
+ * - Command pattern definitions for parsing
+ * - Command syntax definitions for help
+ * - Language provider interface for text generation
+ * - Parser and validation components
+ * - Standard capability schemas
+ *
+ * All state changes go through events - no direct mutations
+ */
+export * from './actions';
+export * from './events';
+export * from './parser';
+export * from './validation';
+export * from './vocabulary';
+export * from './capabilities';
+export * from './query-handlers';
+export * from './scope';
+export * from './services';
+export * from './npc';
+export * from './combat';
+export * from './chains';
+export * from './inference';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,cAAc,WAAW,CAAC;AAI1B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * @sharpee/stdlib - Standard library for Sharpee IF Platform
+ *
+ * This package provides:
+ * - Standard action implementations
+ * - Command pattern definitions for parsing
+ * - Command syntax definitions for help
+ * - Language provider interface for text generation
+ * - Parser and validation components
+ * - Standard capability schemas
+ *
+ * All state changes go through events - no direct mutations
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./actions"), exports);
+// Commands are now in language-specific packages like @sharpee/lang-en-us
+// Language providers are now in language-specific packages like @sharpee/lang-en-us
+// Messages are handled by language providers
+__exportStar(require("./events"), exports);
+__exportStar(require("./parser"), exports);
+__exportStar(require("./validation"), exports);
+__exportStar(require("./vocabulary"), exports);
+__exportStar(require("./capabilities"), exports);
+__exportStar(require("./query-handlers"), exports);
+__exportStar(require("./scope"), exports);
+__exportStar(require("./services"), exports);
+__exportStar(require("./npc"), exports);
+__exportStar(require("./combat"), exports);
+__exportStar(require("./chains"), exports);
+__exportStar(require("./inference"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;;;;;;;;;;;;;;AAEH,4CAA0B;AAC1B,0EAA0E;AAC1E,oFAAoF;AACpF,6CAA6C;AAC7C,2CAAyB;AACzB,2CAAyB;AACzB,+CAA6B;AAC7B,+CAA6B;AAC7B,iDAA+B;AAC/B,mDAAiC;AACjC,0CAAwB;AACxB,6CAA2B;AAC3B,wCAAsB;AACtB,2CAAyB;AACzB,2CAAyB;AACzB,8CAA4B"}