@sharpee/world-model 0.9.60-beta

package/dist/entities/if-entity.js

@@ -0,0 +1,498 @@
+"use strict";
+// packages/world-model/src/entities/if-entity.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IFEntity = void 0;
+const trait_1 = require("../traits/trait");
+const trait_types_1 = require("../traits/trait-types");
+/**
+ * Interactive Fiction Entity with trait-based composition.
+ * Implements the core Entity interface and adds trait management capabilities.
+ */
+class IFEntity {
+    id;
+    type;
+    attributes;
+    relationships;
+    traits;
+    /**
+     * Author-controlled disambiguation priorities per action
+     * Higher priority = more likely to be selected when ambiguous
+     * Key is action ID (e.g., 'if.action.eating')
+     * Value is priority (default 100, higher = preferred)
+     */
+    scopePriorities = new Map();
+    /**
+     * Author-controlled minimum scope levels
+     * Allows entities to be "in scope" regardless of spatial location.
+     * Key is room ID (or '*' for all rooms)
+     * Value is minimum scope level (0=UNAWARE, 1=AWARE, 2=VISIBLE, 3=REACHABLE, 4=CARRIED)
+     *
+     * Example uses:
+     * - sky.setMinimumScope(2) - always visible everywhere
+     * - mountain.setMinimumScope(2, ['overlook']) - visible from specific room
+     * - butterfly.setMinimumScope(3, ['garden']) - reachable in garden
+     */
+    minimumScopes = new Map();
+    /**
+     * Event handlers for this entity
+     * Key is the event type (e.g., 'if.event.pushed')
+     * Value is the handler function
+     */
+    on;
+    constructor(id, type, params) {
+        this.id = id;
+        this.type = type;
+        this.attributes = params?.attributes ? { ...params.attributes } : {};
+        this.relationships = params?.relationships || {};
+        this.traits = new Map();
+        // Store entityType in attributes when created by WorldModel
+        // (params?.attributes will contain it when set by WorldModel.createEntity)
+    }
+    /**
+     * Check if entity has a specific trait
+     */
+    has(type) {
+        return this.traits.has(type);
+    }
+    /**
+     * Get a typed trait from the entity
+     */
+    get(type) {
+        const traitType = typeof type === 'string' ? type :
+            typeof type === 'function' ? type.type : type;
+        return this.traits.get(traitType);
+    }
+    /**
+     * Alias for get() method - for backwards compatibility
+     */
+    getTrait(type) {
+        return this.get(type);
+    }
+    /**
+     * Add a trait to the entity
+     */
+    add(trait) {
+        if (!(0, trait_1.isTrait)(trait)) {
+            throw new Error('Invalid trait: must have a type property');
+        }
+        // Warn and ignore if trait already exists
+        if (this.traits.has(trait.type)) {
+            console.warn(`Entity "${this.id}" already has trait: ${trait.type} - ignoring duplicate add`);
+            return this;
+        }
+        this.traits.set(trait.type, trait);
+        return this;
+    }
+    /**
+     * Remove a trait from the entity
+     */
+    remove(type) {
+        return this.traits.delete(type);
+    }
+    /**
+     * Check if entity has all specified traits
+     */
+    hasAll(...types) {
+        return types.every(type => this.traits.has(type));
+    }
+    /**
+     * Check if entity has any of the specified traits
+     */
+    hasAny(...types) {
+        return types.some(type => this.traits.has(type));
+    }
+    /**
+     * Get all traits on this entity
+     */
+    getTraits() {
+        return Array.from(this.traits.values());
+    }
+    /**
+     * Get all trait types on this entity
+     */
+    getTraitTypes() {
+        return Array.from(this.traits.keys());
+    }
+    /**
+     * Clear all traits from the entity
+     */
+    clearTraits() {
+        this.traits.clear();
+    }
+    // ========== Disambiguation Scoring ==========
+    /**
+     * Get or set author-controlled disambiguation priority for an action.
+     *
+     * When multiple entities match a command, higher priority entities are
+     * preferred for automatic disambiguation.
+     *
+     * @param actionId - The action ID (e.g., 'if.action.eating')
+     * @param priority - Optional priority to set (100 = default, higher = preferred)
+     * @returns The current priority for this action (default 100)
+     *
+     * @example
+     * // Make real apple preferred for eating over wax apple
+     * realApple.scope('if.action.eating', 150);
+     * waxApple.scope('if.action.eating', 50);
+     *
+     * @example
+     * // Get current priority
+     * const priority = apple.scope('if.action.eating');  // Returns 150
+     */
+    scope(actionId, priority) {
+        if (priority !== undefined) {
+            this.scopePriorities.set(actionId, priority);
+        }
+        return this.scopePriorities.get(actionId) ?? 100; // Default priority is 100
+    }
+    /**
+     * Clear disambiguation priority for an action (resets to default)
+     */
+    clearScope(actionId) {
+        this.scopePriorities.delete(actionId);
+    }
+    /**
+     * Clear all disambiguation priorities
+     */
+    clearAllScopes() {
+        this.scopePriorities.clear();
+    }
+    /**
+     * Get all scope priorities for serialization
+     */
+    getScopePriorities() {
+        return Object.fromEntries(this.scopePriorities);
+    }
+    // ========== Minimum Scope (Author-Controlled Scope Additions) ==========
+    /**
+     * Set minimum scope level for this entity.
+     *
+     * Makes an entity "in scope" regardless of its spatial location.
+     * The scope resolver will return the maximum of the physical scope
+     * and the minimum scope (additive only - can raise scope, not lower it).
+     *
+     * Scope levels (numeric values match ScopeLevel enum in stdlib):
+     * - 0: UNAWARE - not in scope
+     * - 1: AWARE - can hear/smell but not see
+     * - 2: VISIBLE - can see but not reach
+     * - 3: REACHABLE - can physically interact
+     * - 4: CARRIED - in inventory (rarely used for minimum)
+     *
+     * @param level The minimum scope level (0-4)
+     * @param rooms Optional array of room IDs where this applies. If omitted, applies everywhere.
+     *
+     * @example
+     * // Sky is always visible everywhere
+     * sky.setMinimumScope(2);
+     *
+     * // Mountain visible only from overlook and trail
+     * mountain.setMinimumScope(2, ['overlook', 'mountain_trail']);
+     *
+     * // Butterfly reachable (but may escape) in garden areas
+     * butterfly.setMinimumScope(3, ['garden', 'meadow', 'pond']);
+     *
+     * // Ticking clock audible from adjacent rooms
+     * clock.setMinimumScope(1, ['hallway', 'study']);
+     */
+    setMinimumScope(level, rooms) {
+        if (rooms && rooms.length > 0) {
+            // Set for specific rooms
+            for (const roomId of rooms) {
+                this.minimumScopes.set(roomId, level);
+            }
+        }
+        else {
+            // Set for all rooms (use '*' as wildcard)
+            this.minimumScopes.set('*', level);
+        }
+        return this;
+    }
+    /**
+     * Get the minimum scope level for this entity in a specific room.
+     *
+     * @param roomId The room to check (or null to get global minimum)
+     * @returns The minimum scope level, or 0 (UNAWARE) if not set
+     */
+    getMinimumScope(roomId) {
+        // Check specific room first
+        if (roomId && this.minimumScopes.has(roomId)) {
+            return this.minimumScopes.get(roomId);
+        }
+        // Fall back to global wildcard
+        if (this.minimumScopes.has('*')) {
+            return this.minimumScopes.get('*');
+        }
+        // No minimum set
+        return 0;
+    }
+    /**
+     * Clear minimum scope for specific rooms or all rooms.
+     *
+     * @param rooms Optional array of room IDs to clear. If omitted, clears all.
+     */
+    clearMinimumScope(rooms) {
+        if (rooms && rooms.length > 0) {
+            for (const roomId of rooms) {
+                this.minimumScopes.delete(roomId);
+            }
+        }
+        else {
+            this.minimumScopes.clear();
+        }
+    }
+    /**
+     * Get all minimum scopes for serialization
+     */
+    getMinimumScopes() {
+        return Object.fromEntries(this.minimumScopes);
+    }
+    /**
+     * Clone this entity with all its traits
+     */
+    clone(newId) {
+        const cloned = new IFEntity(newId, this.type, {
+            attributes: JSON.parse(JSON.stringify(this.attributes)),
+            relationships: JSON.parse(JSON.stringify(this.relationships)) // Deep copy
+        });
+        // Clone traits (deep copy)
+        for (const [type, trait] of this.traits) {
+            cloned.traits.set(type, JSON.parse(JSON.stringify(trait)));
+        }
+        // Clone scope priorities
+        for (const [actionId, priority] of this.scopePriorities) {
+            cloned.scopePriorities.set(actionId, priority);
+        }
+        // Clone minimum scopes
+        for (const [roomId, level] of this.minimumScopes) {
+            cloned.minimumScopes.set(roomId, level);
+        }
+        return cloned;
+    }
+    /**
+     * Serialize entity and traits to JSON
+     */
+    toJSON() {
+        const json = {
+            id: this.id,
+            type: this.type,
+            attributes: this.attributes,
+            relationships: this.relationships,
+            traits: Array.from(this.traits.entries()).map(([_, trait]) => ({
+                ...trait
+            })),
+            // Include version for future compatibility
+            version: 3
+        };
+        // Include scope priorities if any
+        if (this.scopePriorities.size > 0) {
+            json.scopePriorities = Object.fromEntries(this.scopePriorities);
+        }
+        // Include minimum scopes if any
+        if (this.minimumScopes.size > 0) {
+            json.minimumScopes = Object.fromEntries(this.minimumScopes);
+        }
+        return json;
+    }
+    /**
+     * Create entity from JSON data
+     */
+    static fromJSON(json) {
+        // Determine type - use stored type or try to infer from ID
+        let type = json.type || 'object';
+        // If loading old format without explicit type, try to infer from attributes
+        if (!json.version && json.attributes) {
+            if (json.attributes.entityType) {
+                type = json.attributes.entityType;
+            }
+            else if (json.id && json.id.match(/^[a-z][0-9a-z]{2}$/)) {
+                // Try to infer type from ID prefix for new format IDs
+                const prefix = json.id[0];
+                const typeMap = {
+                    'r': 'room',
+                    'd': 'door',
+                    'i': 'item',
+                    'a': 'actor',
+                    'c': 'container',
+                    's': 'supporter',
+                    'y': 'scenery',
+                    'e': 'exit',
+                    'o': 'object'
+                };
+                type = typeMap[prefix] || 'object';
+            }
+        }
+        const entity = new IFEntity(json.id, type, {
+            attributes: json.attributes,
+            relationships: json.relationships
+        });
+        if (json.traits && Array.isArray(json.traits)) {
+            for (const traitData of json.traits) {
+                entity.traits.set(traitData.type, traitData);
+            }
+        }
+        // Restore scope priorities (version 3+)
+        if (json.scopePriorities && typeof json.scopePriorities === 'object') {
+            for (const [actionId, priority] of Object.entries(json.scopePriorities)) {
+                entity.scopePriorities.set(actionId, priority);
+            }
+        }
+        // Restore minimum scopes (version 3+)
+        if (json.minimumScopes && typeof json.minimumScopes === 'object') {
+            for (const [roomId, level] of Object.entries(json.minimumScopes)) {
+                entity.minimumScopes.set(roomId, level);
+            }
+        }
+        return entity;
+    }
+    // ========== Convenience Properties ==========
+    /**
+     * Check if this is a room
+     */
+    get isRoom() {
+        return this.has(trait_types_1.TraitType.ROOM);
+    }
+    /**
+     * Check if this can contain other entities
+     */
+    get canContain() {
+        return this.has(trait_types_1.TraitType.CONTAINER) || this.has(trait_types_1.TraitType.SUPPORTER) ||
+            this.has(trait_types_1.TraitType.ROOM) || this.has(trait_types_1.TraitType.ACTOR);
+    }
+    /**
+     * Check if this is takeable (default behavior unless has scenery trait)
+     */
+    get isTakeable() {
+        return !this.has(trait_types_1.TraitType.SCENERY) && !this.has(trait_types_1.TraitType.ROOM) && !this.has(trait_types_1.TraitType.DOOR);
+    }
+    /**
+     * Check if this is fixed in place (has scenery trait)
+     */
+    get isScenery() {
+        return this.has(trait_types_1.TraitType.SCENERY);
+    }
+    /**
+     * Check if this can be opened
+     */
+    get isOpenable() {
+        return this.has(trait_types_1.TraitType.OPENABLE);
+    }
+    /**
+     * Check if this is currently open
+     */
+    get isOpen() {
+        const openable = this.get(trait_types_1.TraitType.OPENABLE);
+        return openable ? openable.isOpen : false;
+    }
+    /**
+     * Check if this can be locked
+     */
+    get isLockable() {
+        return this.has(trait_types_1.TraitType.LOCKABLE);
+    }
+    /**
+     * Check if this is currently locked
+     */
+    get isLocked() {
+        const lockable = this.get(trait_types_1.TraitType.LOCKABLE);
+        return lockable ? lockable.isLocked : false;
+    }
+    /**
+     * Check if this is a container
+     */
+    get isContainer() {
+        return this.has(trait_types_1.TraitType.CONTAINER);
+    }
+    /**
+     * Check if this is a supporter
+     */
+    get isSupporter() {
+        return this.has(trait_types_1.TraitType.SUPPORTER);
+    }
+    /**
+     * Check if this is a door
+     */
+    get isDoor() {
+        return this.has(trait_types_1.TraitType.DOOR);
+    }
+    /**
+     * Check if this is an actor
+     */
+    get isActor() {
+        return this.has(trait_types_1.TraitType.ACTOR);
+    }
+    /**
+     * Check if this is the player
+     */
+    get isPlayer() {
+        const actor = this.get(trait_types_1.TraitType.ACTOR);
+        return actor ? actor.isPlayer : false;
+    }
+    /**
+     * Check if this provides light
+     */
+    get providesLight() {
+        const lightSource = this.get(trait_types_1.TraitType.LIGHT_SOURCE);
+        return lightSource ? lightSource.isLit : false;
+    }
+    /**
+     * Check if this is switchable
+     */
+    get isSwitchable() {
+        return this.has(trait_types_1.TraitType.SWITCHABLE);
+    }
+    /**
+     * Check if this can be entered by actors
+     * Vehicles are inherently enterable (boats, baskets, etc.)
+     */
+    get enterable() {
+        return this.has(trait_types_1.TraitType.ENTERABLE) || this.has(trait_types_1.TraitType.VEHICLE);
+    }
+    /**
+     * Check if this is switched on
+     */
+    get isOn() {
+        const switchable = this.get(trait_types_1.TraitType.SWITCHABLE);
+        return switchable ? switchable.isOn : false;
+    }
+    /**
+     * Get the name of this entity
+     */
+    get name() {
+        // First check for displayName (new system)
+        if (this.attributes.displayName) {
+            return this.attributes.displayName;
+        }
+        // Then check identity trait
+        const identity = this.get(trait_types_1.TraitType.IDENTITY);
+        if (identity && identity.name) {
+            return identity.name;
+        }
+        // Fall back to name attribute
+        if (this.attributes.name) {
+            return this.attributes.name;
+        }
+        // Last resort: use ID
+        return this.id;
+    }
+    /**
+     * Get the description of this entity
+     */
+    get description() {
+        const identity = this.get(trait_types_1.TraitType.IDENTITY);
+        return identity ? identity.description : undefined;
+    }
+    /**
+     * Get the weight of this entity
+     */
+    get weight() {
+        return this.attributes.weight || 0;
+    }
+    /**
+     * Alias for has() method - for backwards compatibility
+     */
+    hasTrait(type) {
+        return this.has(type);
+    }
+}
+exports.IFEntity = IFEntity;
+//# sourceMappingURL=if-entity.js.map

package/dist/entities/if-entity.js.map

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

package/dist/entities/index.d.ts

@@ -0,0 +1,5 @@
+export { IFEntity } from './if-entity';
+export { EntityStore } from './entity-store';
+export { EntityType, isEntityType, getEntityTypePrefix } from './entity-types';
+export type { EntityType as EntityTypeValue } from './entity-types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC/E,YAAY,EAAE,UAAU,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/entities/index.js

@@ -0,0 +1,13 @@
+"use strict";
+// packages/world-model/src/entities/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEntityTypePrefix = exports.isEntityType = exports.EntityType = exports.EntityStore = exports.IFEntity = void 0;
+var if_entity_1 = require("./if-entity");
+Object.defineProperty(exports, "IFEntity", { enumerable: true, get: function () { return if_entity_1.IFEntity; } });
+var entity_store_1 = require("./entity-store");
+Object.defineProperty(exports, "EntityStore", { enumerable: true, get: function () { return entity_store_1.EntityStore; } });
+var entity_types_1 = require("./entity-types");
+Object.defineProperty(exports, "EntityType", { enumerable: true, get: function () { return entity_types_1.EntityType; } });
+Object.defineProperty(exports, "isEntityType", { enumerable: true, get: function () { return entity_types_1.isEntityType; } });
+Object.defineProperty(exports, "getEntityTypePrefix", { enumerable: true, get: function () { return entity_types_1.getEntityTypePrefix; } });
+//# sourceMappingURL=index.js.map

package/dist/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/entities/index.ts"],"names":[],"mappings":";AAAA,6CAA6C;;;AAE7C,yCAAuC;AAA9B,qGAAA,QAAQ,OAAA;AACjB,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,+CAA+E;AAAtE,0GAAA,UAAU,OAAA;AAAE,4GAAA,YAAY,OAAA;AAAE,mHAAA,mBAAmB,OAAA"}

package/dist/events/types.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Event handler types for the event system
+ *
+ * Note: ADR-075 effect-returning handlers are defined in @sharpee/event-processor.
+ * This file contains basic event types used by world-model.
+ */
+import type { ISemanticEvent } from '@sharpee/core';
+/**
+ * Game event that can be handled by entities or the story
+ */
+export interface IGameEvent extends ISemanticEvent {
+    type: string;
+    data: Record<string, any>;
+}
+/**
+ * Legacy handler signature for entity event handlers
+ * These handlers directly mutate world state and return events.
+ *
+ * Note: For ADR-075 effect-returning handlers, use StoryEventHandler
+ * from @sharpee/event-processor
+ */
+export type LegacyEntityEventHandler = (event: IGameEvent, world?: any) => void | ISemanticEvent[];
+/**
+ * Simple event handler that only receives the event (no world access)
+ * Used for story-level daemons and event listeners
+ */
+export type SimpleEventHandler = (event: IGameEvent) => void | ISemanticEvent[];
+/**
+ * Collection of event handlers keyed by event type
+ */
+export interface IEventHandlers {
+    [eventType: string]: LegacyEntityEventHandler | LegacyEntityEventHandler[];
+}
+/**
+ * Entity with event handling capability
+ */
+export interface IEventCapableEntity {
+    /**
+     * Event handlers for this entity
+     * Key is the event type (e.g., 'if.event.pushed')
+     * Value is a handler function or array of handlers
+     */
+    on?: IEventHandlers;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,cAAc,EAAE,CAAC;AAEnG;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,cAAc,EAAE,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,SAAS,EAAE,MAAM,GAAG,wBAAwB,GAAG,wBAAwB,EAAE,CAAC;CAC5E;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,EAAE,CAAC,EAAE,cAAc,CAAC;CACrB"}

package/dist/events/types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Event handler types for the event system
+ *
+ * Note: ADR-075 effect-returning handlers are defined in @sharpee/event-processor.
+ * This file contains basic event types used by world-model.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/events/types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/examples/event-handler-registration.d.ts

@@ -0,0 +1,14 @@
+import { WorldModel } from '../world';
+/**
+ * Register standard IF event handlers with the world model
+ */
+export declare function registerStandardEventHandlers(world: WorldModel): void;
+/**
+ * Register event validators
+ */
+export declare function registerStandardEventValidators(world: WorldModel): void;
+/**
+ * Register event previewers
+ */
+export declare function registerStandardEventPreviewers(world: WorldModel): void;
+//# sourceMappingURL=event-handler-registration.d.ts.map

package/dist/examples/event-handler-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler-registration.d.ts","sourceRoot":"","sources":["../../src/examples/event-handler-registration.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAgB,MAAM,UAAU,CAAC;AAKpD;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAsFrE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAmCvE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CA6BvE"}