@sharpee/if-domain 0.9.66-beta → 0.9.67-beta

package/changes.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Domain types for world state changes
+ */
+/**
+ * Types of changes that can occur in the world
+ */
+export type WorldChangeType = 'move' | 'create' | 'delete' | 'modify' | 'relate' | 'unrelate';
+//# sourceMappingURL=changes.d.ts.map

package/changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/if-domain/src/changes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC"}

package/changes.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Domain types for world state changes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=changes.js.map

package/changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/if-domain/src/changes.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/contracts.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Domain contracts for world state changes and event processing
+ */
+import { ISemanticEvent, IEntity } from "./src/index";
+/**
+ * Represents a change to the world state
+ */
+export interface WorldChange {
+    type: 'move' | 'create' | 'delete' | 'modify' | 'relate' | 'unrelate';
+    entityId: string;
+    field?: string;
+    oldValue?: unknown;
+    newValue?: unknown;
+    details?: Record<string, unknown>;
+}
+/**
+ * Configuration for world model behavior
+ */
+export interface WorldConfig {
+    enableSpatialIndex?: boolean;
+    maxDepth?: number;
+    strictMode?: boolean;
+}
+/**
+ * World state storage
+ */
+export interface WorldState {
+    [key: string]: any;
+}
+/**
+ * Options for finding entities
+ */
+export interface FindOptions {
+    includeScenery?: boolean;
+    includeInvisible?: boolean;
+    maxDepth?: number;
+}
+/**
+ * Options for getting contents
+ */
+export interface ContentsOptions {
+    recursive?: boolean;
+    includeWorn?: boolean;
+    visibleOnly?: boolean;
+}
+/**
+ * Result of processing events
+ */
+export interface ProcessedEvents {
+    /**
+     * Events that were successfully applied
+     */
+    applied: ISemanticEvent[];
+    /**
+     * Events that failed validation
+     */
+    failed: Array<{
+        event: ISemanticEvent;
+        reason: string;
+    }>;
+    /**
+     * World changes that occurred
+     */
+    changes: WorldChange[];
+    /**
+     * Events generated as reactions to the processed events
+     */
+    reactions: ISemanticEvent[];
+}
+/**
+ * Options for event processing
+ */
+export interface ProcessorOptions {
+    /**
+     * Whether to validate events before applying them
+     */
+    validate?: boolean;
+    /**
+     * Whether to preview changes before applying
+     */
+    preview?: boolean;
+    /**
+     * Maximum depth for reaction processing
+     */
+    maxReactionDepth?: number;
+}
+/**
+ * Simple command input for actions
+ *
+ * This is what actions receive - no parser internals, just the essentials.
+ * The rich parsing data stays in world-model where it belongs.
+ */
+export interface CommandInput {
+    /** The action being executed */
+    actionId: string;
+    /** Direct object if present */
+    directObject?: EntityReference;
+    /** Indirect object if present */
+    indirectObject?: EntityReference;
+    /** Preposition used (if any) - raw text for backward compatibility */
+    preposition?: string;
+    /** Semantic properties derived from grammar */
+    semantics?: CommandSemantics;
+    /** Original input text for reference */
+    inputText: string;
+}
+/**
+ * Semantic properties derived from grammar rules
+ *
+ * These replace the need for actions to inspect verb.text, preposition variations,
+ * or modify parsed commands. The grammar rules provide normalized semantic meaning.
+ */
+export interface CommandSemantics {
+    /** How the action should be performed */
+    manner?: 'normal' | 'careful' | 'careless' | 'forceful' | 'stealthy' | 'quick';
+    /** Spatial relationship (normalized from preposition variations) */
+    spatialRelation?: 'in' | 'on' | 'under' | 'behind' | 'beside' | 'above' | 'below';
+    /** Movement direction (normalized from direction variations) */
+    direction?: 'north' | 'south' | 'east' | 'west' | 'up' | 'down' | 'northeast' | 'northwest' | 'southeast' | 'southwest' | 'in' | 'out';
+    /** Whether a preposition was implicit in the grammar */
+    implicitPreposition?: boolean;
+    /** Whether a direction was implicit */
+    implicitDirection?: boolean;
+    /** Action-specific semantics */
+    custom?: Record<string, any>;
+}
+/**
+ * Reference to an entity in a command
+ */
+export interface EntityReference {
+    /** The resolved entity */
+    entity: IEntity;
+    /** The text that matched this entity */
+    matchedText: string;
+    /** How the entity was referenced */
+    referenceType?: 'name' | 'pronoun' | 'definite' | 'indefinite';
+}
+/**
+ * Validation result from an action
+ */
+export interface ValidationResult {
+    /** Whether the action can proceed */
+    valid: boolean;
+    /** Error code if validation failed */
+    error?: string;
+    /** Parameters for error message formatting */
+    params?: Record<string, any>;
+}
+/**
+ * Context provided to actions
+ *
+ * This is the contract for what actions can access.
+ * No world-model internals, no parser details.
+ */
+export interface IActionContext {
+    /** The player entity */
+    readonly player: IEntity;
+    /** The player's current location */
+    readonly currentLocation: IEntity;
+    /** The command being executed */
+    readonly command: CommandInput;
+    /** The action being executed */
+    readonly action: IAction;
+    /**
+     * Check if an entity is visible to the player
+     */
+    canSee(entity: IEntity): boolean;
+    /**
+     * Check if an entity is reachable by the player
+     */
+    canReach(entity: IEntity): boolean;
+    /**
+     * Check if an entity can be taken by the player
+     */
+    canTake(entity: IEntity): boolean;
+    /**
+     * Check if an entity is in scope for the player
+     */
+    isInScope(entity: IEntity): boolean;
+    /**
+     * Get all visible entities
+     */
+    getVisible(): IEntity[];
+    /**
+     * Get all entities in scope
+     */
+    getInScope(): IEntity[];
+    /**
+     * Get an entity by ID
+     */
+    getEntity(entityId: string): IEntity | undefined;
+    /**
+     * Get an entity's location
+     */
+    getEntityLocation(entityId: string): string | undefined;
+    /**
+     * Get entities contained within an entity
+     */
+    getEntityContents(entityId: string): IEntity[];
+    /**
+     * Get the room containing an entity
+     */
+    getContainingRoom(entityId: string): IEntity | undefined;
+    /**
+     * Get a world capability (scoring, etc.)
+     */
+    getWorldCapability(name: string): any;
+    /**
+     * Move an entity to a new location
+     */
+    moveEntity(entityId: string, newLocationId: string): boolean;
+    /**
+     * Create an event
+     */
+    event(type: string, data: any): ISemanticEvent;
+}
+/**
+ * Action contract
+ *
+ * Actions implement game verbs. They validate and execute commands.
+ */
+export interface IAction {
+    /** Unique identifier */
+    id: string;
+    /** Validate if the action can be executed */
+    validate(context: IActionContext): ValidationResult;
+    /** Execute the action and return events */
+    execute(context: IActionContext): ISemanticEvent[];
+    /** Required message IDs for this action */
+    requiredMessages?: string[];
+    /** Optional description for help/documentation */
+    descriptionMessageId?: string;
+    /** Optional examples for help/documentation */
+    examplesMessageId?: string;
+}
+/**
+ * Action registry contract
+ */
+export interface IActionRegistry {
+    /** Register an action */
+    register(action: IAction): void;
+    /** Get an action by ID */
+    get(actionId: string): IAction | undefined;
+    /** Get all registered actions */
+    getAll(): IAction[];
+    /** Check if an action exists */
+    has(actionId: string): boolean;
+}
+/**
+ * Scope levels for entity visibility and accessibility
+ */
+export type ScopeLevel = 'carried' | 'reachable' | 'visible' | 'audible' | 'detectable' | 'out_of_scope';
+/**
+ * Basic scope resolver interface for actions
+ */
+export interface IScopeResolver {
+    /**
+     * Get the highest level of scope for a target entity
+     */
+    getScope(actor: IEntity, target: IEntity): ScopeLevel;
+    /**
+     * Check if actor can see the target
+     */
+    canSee(actor: IEntity, target: IEntity): boolean;
+    /**
+     * Check if actor can physically reach the target
+     */
+    canReach(actor: IEntity, target: IEntity): boolean;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/if-domain/src/contracts.ts"],"names":[],"mappings":"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"}

package/contracts.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Domain contracts for world state changes and event processing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=contracts.js.map

package/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/if-domain/src/contracts.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/events.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Standard Interactive Fiction events.
+ *
+ * These are the core events that can occur in the IF world model.
+ * Extensions can add their own events using namespaced identifiers.
+ */
+export declare const IFEvents: {
+    readonly TAKEN: "taken";
+    readonly DROPPED: "dropped";
+    readonly MOVED: "moved";
+    readonly EXAMINED: "examined";
+    readonly PUT_IN: "put_in";
+    readonly PUT_ON: "put_on";
+    readonly REMOVED_FROM: "removed_from";
+    readonly ITEM_PUT_ON: "item_put_on";
+    readonly ITEM_REMOVED_FROM: "item_removed_from";
+    readonly CONTAINER_EMPTIED: "container_emptied";
+    readonly CONTAINER_NOT_OPEN: "container_not_open";
+    readonly NOT_A_CONTAINER: "not_a_container";
+    readonly NOT_A_SUPPORTER: "not_a_supporter";
+    readonly DOESNT_FIT: "doesnt_fit";
+    readonly OPENED: "opened";
+    readonly CLOSED: "closed";
+    readonly NOT_OPENABLE: "not_openable";
+    readonly LOCKED: "locked";
+    readonly UNLOCKED: "unlocked";
+    readonly CONTAINER_LOCKED: "container_locked";
+    readonly CONTAINER_UNLOCKED: "container_unlocked";
+    readonly ALREADY_LOCKED: "already_locked";
+    readonly ALREADY_UNLOCKED: "already_unlocked";
+    readonly UNLOCK_FAILED: "unlock_failed";
+    readonly NOT_LOCKABLE: "not_lockable";
+    readonly SWITCHED_ON: "switched_on";
+    readonly SWITCHED_OFF: "switched_off";
+    readonly DEVICE_SWITCHED_ON: "device_switched_on";
+    readonly DEVICE_SWITCHED_OFF: "device_switched_off";
+    readonly DEVICE_ACTIVATED: "device_activated";
+    readonly WORN: "worn";
+    readonly REMOVED: "removed";
+    readonly EATEN: "eaten";
+    readonly DRUNK: "drunk";
+    readonly ITEM_EATEN: "item_eaten";
+    readonly ITEM_DRUNK: "item_drunk";
+    readonly ITEM_DESTROYED: "item_destroyed";
+    readonly ACTOR_MOVED: "actor_moved";
+    readonly ACTOR_ENTERED: "actor_entered";
+    readonly ACTOR_EXITED: "actor_exited";
+    readonly MOVEMENT_BLOCKED: "movement_blocked";
+    readonly ENTERED: "entered";
+    readonly EXITED: "exited";
+    readonly EVACUATED: "evacuated";
+    readonly CLIMBED: "climbed";
+    readonly ROOM_ENTERED: "room_entered";
+    readonly ROOM_EXITED: "room_exited";
+    readonly ROOM_DESCRIBED: "room_described";
+    readonly ROOM_FIRST_ENTERED: "room_first_entered";
+    readonly ROOM_ILLUMINATED: "room_illuminated";
+    readonly ROOM_DARKENED: "room_darkened";
+    readonly NEW_EXIT_REVEALED: "new_exit_revealed";
+    readonly LIGHT_CHANGED: "light_changed";
+    readonly LOCATION_ILLUMINATED: "location_illuminated";
+    readonly LOCATION_DARKENED: "location_darkened";
+    readonly FUEL_DEPLETED: "fuel_depleted";
+    readonly FUEL_LOW: "fuel_low";
+    readonly REFUELED: "refueled";
+    readonly READ: "read";
+    readonly SEARCHED: "searched";
+    readonly LISTENED: "listened";
+    readonly SMELLED: "smelled";
+    readonly TOUCHED: "touched";
+    readonly GIVEN: "given";
+    readonly SHOWN: "shown";
+    readonly THROWN: "thrown";
+    readonly PUSHED: "pushed";
+    readonly PULLED: "pulled";
+    readonly TURNED: "turned";
+    readonly USED: "used";
+    readonly CUSTOM_MESSAGE: "custom_message";
+    readonly VISIBILITY_CHANGED: "visibility_changed";
+    readonly ACTION_PREVENTED: "action_prevented";
+    readonly ACTION_FAILED: "action_failed";
+    readonly ACTION_SUCCEEDED: "action_succeeded";
+    readonly WAITED: "waited";
+    readonly SCORE_DISPLAYED: "score_displayed";
+    readonly HELP_DISPLAYED: "help_displayed";
+    readonly ABOUT_DISPLAYED: "about_displayed";
+    readonly SCORE_GAINED: "if.event.score_gained";
+    readonly SCORE_LOST: "if.event.score_lost";
+};
+export type IFEventType = typeof IFEvents[keyof typeof IFEvents];
+/**
+ * Event categories for filtering and handling
+ */
+export declare const IFEventCategory: {
+    readonly MANIPULATION: "manipulation";
+    readonly MOVEMENT: "movement";
+    readonly STATE_CHANGE: "state_change";
+    readonly PERCEPTION: "perception";
+    readonly META: "meta";
+};
+export type IFEventCategoryType = typeof IFEventCategory[keyof typeof IFEventCategory];
+/**
+ * Event processor wiring types (ADR-086)
+ *
+ * These types allow WorldModel to wire its event handlers to the engine's
+ * EventProcessor without creating a circular dependency.
+ */
+import type { ISemanticEvent } from "./src/index";
+/**
+ * Callback for registering a handler with the event processor.
+ * The handler returns an array (Effect[] in practice, but typed loosely to avoid circular deps).
+ */
+export type EventProcessorRegisterFn = (eventType: string, handler: (event: ISemanticEvent) => unknown[]) => void;
+/**
+ * Interface for wiring WorldModel handlers to EventProcessor.
+ * WorldModel receives this during engine initialization.
+ */
+export interface IEventProcessorWiring {
+    /**
+     * Register a handler with the event processor
+     */
+    registerHandler: EventProcessorRegisterFn;
+}
+//# sourceMappingURL=events.d.ts.map

package/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../../mnt/c/repotemp/sharpee/packages/if-domain/src/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyHX,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEvF;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,EAAE,KAC1C,IAAI,CAAC;AAEV;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,eAAe,EAAE,wBAAwB,CAAC;CAC3C"}

package/events.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Standard Interactive Fiction events.
+ *
+ * These are the core events that can occur in the IF world model.
+ * Extensions can add their own events using namespaced identifiers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IFEventCategory = exports.IFEvents = void 0;
+exports.IFEvents = {
+    // Core object manipulation
+    TAKEN: 'taken',
+    DROPPED: 'dropped',
+    MOVED: 'moved',
+    EXAMINED: 'examined',
+    // Container/supporter events  
+    PUT_IN: 'put_in',
+    PUT_ON: 'put_on',
+    REMOVED_FROM: 'removed_from',
+    ITEM_PUT_ON: 'item_put_on',
+    ITEM_REMOVED_FROM: 'item_removed_from',
+    CONTAINER_EMPTIED: 'container_emptied',
+    CONTAINER_NOT_OPEN: 'container_not_open',
+    NOT_A_CONTAINER: 'not_a_container',
+    NOT_A_SUPPORTER: 'not_a_supporter',
+    DOESNT_FIT: 'doesnt_fit',
+    // Openable events
+    OPENED: 'opened',
+    CLOSED: 'closed',
+    NOT_OPENABLE: 'not_openable',
+    // Lockable events
+    LOCKED: 'locked',
+    UNLOCKED: 'unlocked',
+    CONTAINER_LOCKED: 'container_locked',
+    CONTAINER_UNLOCKED: 'container_unlocked',
+    ALREADY_LOCKED: 'already_locked',
+    ALREADY_UNLOCKED: 'already_unlocked',
+    UNLOCK_FAILED: 'unlock_failed',
+    NOT_LOCKABLE: 'not_lockable',
+    // Switchable events
+    SWITCHED_ON: 'switched_on',
+    SWITCHED_OFF: 'switched_off',
+    DEVICE_SWITCHED_ON: 'device_switched_on',
+    DEVICE_SWITCHED_OFF: 'device_switched_off',
+    DEVICE_ACTIVATED: 'device_activated',
+    // Wearable events
+    WORN: 'worn',
+    REMOVED: 'removed',
+    // Edible events
+    EATEN: 'eaten',
+    DRUNK: 'drunk',
+    ITEM_EATEN: 'item_eaten',
+    ITEM_DRUNK: 'item_drunk',
+    ITEM_DESTROYED: 'item_destroyed',
+    // Movement events
+    ACTOR_MOVED: 'actor_moved',
+    ACTOR_ENTERED: 'actor_entered',
+    ACTOR_EXITED: 'actor_exited',
+    MOVEMENT_BLOCKED: 'movement_blocked',
+    // Entry/exit events
+    ENTERED: 'entered',
+    EXITED: 'exited',
+    EVACUATED: 'evacuated',
+    CLIMBED: 'climbed',
+    // Room events
+    ROOM_ENTERED: 'room_entered',
+    ROOM_EXITED: 'room_exited',
+    ROOM_DESCRIBED: 'room_described',
+    ROOM_FIRST_ENTERED: 'room_first_entered',
+    ROOM_ILLUMINATED: 'room_illuminated',
+    ROOM_DARKENED: 'room_darkened',
+    NEW_EXIT_REVEALED: 'new_exit_revealed',
+    // Light events
+    LIGHT_CHANGED: 'light_changed',
+    LOCATION_ILLUMINATED: 'location_illuminated',
+    LOCATION_DARKENED: 'location_darkened',
+    FUEL_DEPLETED: 'fuel_depleted',
+    FUEL_LOW: 'fuel_low',
+    REFUELED: 'refueled',
+    // Reading events
+    READ: 'read',
+    // Observation events
+    SEARCHED: 'searched',
+    LISTENED: 'listened',
+    SMELLED: 'smelled',
+    TOUCHED: 'touched',
+    // Social/interaction events
+    GIVEN: 'given',
+    SHOWN: 'shown',
+    THROWN: 'thrown',
+    // Device manipulation events
+    PUSHED: 'pushed',
+    PULLED: 'pulled',
+    TURNED: 'turned',
+    USED: 'used',
+    // General message events
+    CUSTOM_MESSAGE: 'custom_message',
+    // Visibility events
+    VISIBILITY_CHANGED: 'visibility_changed',
+    // Action meta-events
+    ACTION_PREVENTED: 'action_prevented',
+    ACTION_FAILED: 'action_failed',
+    ACTION_SUCCEEDED: 'action_succeeded',
+    // Meta action events
+    WAITED: 'waited',
+    SCORE_DISPLAYED: 'score_displayed',
+    HELP_DISPLAYED: 'help_displayed',
+    ABOUT_DISPLAYED: 'about_displayed',
+    // Scoring events (ADR-085)
+    SCORE_GAINED: 'if.event.score_gained',
+    SCORE_LOST: 'if.event.score_lost',
+};
+/**
+ * Event categories for filtering and handling
+ */
+exports.IFEventCategory = {
+    MANIPULATION: 'manipulation',
+    MOVEMENT: 'movement',
+    STATE_CHANGE: 'state_change',
+    PERCEPTION: 'perception',
+    META: 'meta',
+};
+//# sourceMappingURL=events.js.map

package/events.js.map

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