@sharpee/engine 0.9.64-beta → 0.9.66-beta

package/dist-npm/game-engine.d.ts

@@ -1,292 +0,0 @@
-/**
- * Game Engine - Main runtime for Sharpee IF games
- *
- * Manages game state, turn execution, and coordinates all subsystems
- */
-import { WorldModel, IFEntity } from "../../world-model/dist-npm/src/index";
-import { EventProcessor } from "../../event-processor/dist-npm/src/index";
-import { Parser, IPerceptionService } from "../../stdlib/dist-npm/src/index";
-import { LanguageProvider } from "../../if-domain/dist-npm/src/index";
-import { ITextService } from "../../text-service/dist-npm/src/index";
-import { ISemanticEvent, ISaveRestoreHooks, ISemanticEventSource } from "../../core/dist-npm/src/index";
-import { PluginRegistry } from "../../plugins/dist-npm/src/index";
-import { GameContext, TurnResult, EngineConfig, SequencedEvent } from './types';
-import { Story } from './story';
-import { NarrativeSettings } from './narrative';
-import { ParsedCommandTransformer } from './command-executor';
-/**
- * Game engine events
- */
-export interface GameEngineEvents {
-    'turn:start': (turn: number, input: string) => void;
-    'turn:complete': (result: TurnResult) => void;
-    'turn:failed': (error: Error, turn: number) => void;
-    'event': (event: SequencedEvent) => void;
-    'state:changed': (context: GameContext) => void;
-    'game:over': (context: GameContext) => void;
-    'text:output': (text: string, turn: number) => void;
-    'text:channel': (channel: string, text: string, turn: number) => void;
-}
-type GameEngineEventName = keyof GameEngineEvents;
-type GameEngineEventListener<K extends GameEngineEventName> = GameEngineEvents[K];
-/**
- * Main game engine
- */
-export declare class GameEngine {
-    private world;
-    private sessionStartTime?;
-    private sessionTurns;
-    private sessionMoves;
-    private context;
-    private config;
-    private commandExecutor;
-    private eventProcessor;
-    private platformEvents;
-    private actionRegistry;
-    private textService?;
-    private turnEvents;
-    private running;
-    private story?;
-    private languageProvider?;
-    private parser?;
-    private eventListeners;
-    private saveRestoreHooks?;
-    private eventSource;
-    private systemEventSource;
-    private pendingPlatformOps;
-    private perceptionService?;
-    private pluginRegistry;
-    private random;
-    private narrativeSettings;
-    private vocabularyManager;
-    private saveRestoreService;
-    private turnEventProcessor;
-    private platformOpHandler?;
-    private hasEmittedInitialized;
-    constructor(options: {
-        world: WorldModel;
-        player: IFEntity;
-        parser: Parser;
-        language: LanguageProvider;
-        perceptionService?: IPerceptionService;
-        config?: EngineConfig;
-    });
-    /**
-     * Set the story for this engine
-     */
-    setStory(story: Story): void;
-    /**
-     * Get the current parser
-     */
-    getParser(): Parser | undefined;
-    /**
-     * Get the current language provider
-     */
-    getLanguageProvider(): LanguageProvider | undefined;
-    /**
-     * Start the game engine
-     */
-    start(): void;
-    /**
-     * Stop the game engine
-     */
-    stop(reason?: 'quit' | 'victory' | 'defeat' | 'abort', details?: any): void;
-    /**
-     * Execute a turn
-     */
-    executeTurn(input: string): Promise<TurnResult>;
-    /**
-     * Execute a meta-command (VERSION, SCORE, HELP, etc.)
-     *
-     * Meta-commands operate outside the turn cycle:
-     * - They don't increment turns
-     * - They don't trigger NPC ticks or scheduler
-     * - They don't create undo snapshots
-     * - They don't get stored in command history
-     * - Events are processed immediately through text service (not stored in turnEvents)
-     *
-     * @param input - Raw command string
-     * @param parsedCommand - Parsed command from parser
-     * @returns MetaCommandResult with events and success status
-     */
-    private executeMetaCommand;
-    /**
-     * Process meta-command events: text service → emit to clients
-     *
-     * - Does NOT store in turnEvents
-     * - Passes currentTurn for display context (turn/score shown to player)
-     * - Turn counter is NOT incremented
-     */
-    private processMetaEvents;
-    /**
-     * Process a single platform operation for meta-commands.
-     *
-     * This is similar to processPlatformOperations but handles one operation
-     * at a time and returns completion events for inclusion in the result.
-     */
-    private processMetaPlatformOperation;
-    /**
-     * Get current game context
-     */
-    getContext(): GameContext;
-    /**
-     * Get world model
-     */
-    getWorld(): WorldModel;
-    /**
-     * Get the current story
-     */
-    getStory(): Story | undefined;
-    /**
-     * Get the event source for save/restore
-     */
-    getEventSource(): ISemanticEventSource;
-    /**
-     * Get narrative settings (ADR-089)
-     *
-     * Returns the story's narrative perspective and related settings.
-     * Use this for text rendering that needs to know 1st/2nd/3rd person.
-     */
-    getNarrativeSettings(): NarrativeSettings;
-    /**
-     * Configure language provider with narrative settings (ADR-089)
-     *
-     * Sets up the language provider for perspective-aware message resolution.
-     * For 3rd person narratives, extracts player pronouns from ActorTrait.
-     */
-    private configureLanguageProviderNarrative;
-    /**
-     * Get plugin registry for registering turn-cycle plugins (ADR-120)
-     */
-    getPluginRegistry(): PluginRegistry;
-    /**
-     * Get event processor for handler registration (ADR-075)
-     */
-    getEventProcessor(): EventProcessor;
-    /**
-     * Get the text service
-     */
-    getTextService(): ITextService | undefined;
-    /**
-     * Set a custom text service
-     */
-    setTextService(service: ITextService): void;
-    /**
-     * Register save/restore hooks
-     */
-    registerSaveRestoreHooks(hooks: ISaveRestoreHooks): void;
-    /**
-     * Register a transformer for parsed commands.
-     * Transformers are called after parsing but before validation,
-     * allowing stories to modify commands (e.g., for debug tools).
-     *
-     * @param transformer - Function to transform parsed commands
-     */
-    registerParsedCommandTransformer(transformer: ParsedCommandTransformer): void;
-    /**
-     * Unregister a parsed command transformer.
-     *
-     * @param transformer - The transformer to remove
-     * @returns true if the transformer was found and removed
-     */
-    unregisterParsedCommandTransformer(transformer: ParsedCommandTransformer): boolean;
-    /**
-     * Save game state using registered hooks
-     */
-    save(): Promise<boolean>;
-    /**
-     * Restore game state using registered hooks
-     */
-    restore(): Promise<boolean>;
-    /**
-     * Create an undo snapshot of the current world state
-     */
-    private createUndoSnapshot;
-    /**
-     * Undo to previous turn
-     * @returns true if undo succeeded, false if nothing to undo
-     */
-    undo(): boolean;
-    /**
-     * Check if undo is available
-     */
-    canUndo(): boolean;
-    /**
-     * Get number of undo levels available
-     */
-    getUndoLevels(): number;
-    /**
-     * Process events from a plugin through the shared pipeline (ADR-120)
-     * Enriches, filters, stores, and emits events.
-     */
-    private processPluginEvents;
-    /**
-     * Create save data from current engine state
-     */
-    private createSaveData;
-    /**
-     * Load save data into engine
-     */
-    private loadSaveData;
-    /**
-     * Get turn history
-     */
-    getHistory(): TurnResult[];
-    /**
-     * Get recent events
-     */
-    getRecentEvents(count?: number): SequencedEvent[];
-    /**
-     * Update vocabulary for an entity
-     */
-    updateEntityVocabulary(entity: IFEntity, inScope: boolean): void;
-    /**
-     * Update vocabulary for all entities in scope
-     */
-    updateScopeVocabulary(): void;
-    /**
-     * Emit a platform event with turn metadata
-     */
-    emitPlatformEvent(event: Omit<ISemanticEvent, 'id' | 'timestamp'>): void;
-    /**
-     * Update context after a turn
-     */
-    private updateContext;
-    /**
-     * Update command history capability
-     */
-    private updateCommandHistory;
-    /**
-     * Process pending platform operations
-     */
-    private processPlatformOperations;
-    /**
-     * Emit a game lifecycle event.
-     * All game events now use ISemanticEvent with data in the `data` field.
-     * (IGameEvent with `payload` is deprecated - see ADR-097)
-     */
-    private emitGameEvent;
-    /**
-     * Emit an event to listeners
-     */
-    private emit;
-    /**
-     * Dispatch an event to entity handlers (entity.on)
-     * Entities can define handlers for specific event types
-     */
-    private dispatchEntityHandlers;
-    /**
-     * Check if game is over
-     */
-    private isGameOver;
-    /**
-     * Add event listener
-     */
-    on<K extends GameEngineEventName>(event: K, listener: GameEngineEventListener<K>): this;
-    /**
-     * Remove event listener
-     */
-    off<K extends GameEngineEventName>(event: K, listener: GameEngineEventListener<K>): this;
-}
-export {};
-//# sourceMappingURL=game-engine.d.ts.map

package/dist-npm/game-engine.d.ts.map

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