@sharpee/world-model 0.9.60-beta

package/dist/scope/scope-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-rule.d.ts","sourceRoot":"","sources":["../../src/scope/scope-rule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,KAAK,EAAE,GAAG,CAAC;IACX,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,kDAAkD;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sCAAsC;IACtC,EAAE,EAAE,MAAM,CAAC;IAEX,2DAA2D;IAC3D,aAAa,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAE9B,yDAAyD;IACzD,eAAe,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,EAAE,CAAC,CAAC;IAEnE,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IAE5B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,aAAa,KAAK,OAAO,CAAC;IAEhD,qEAAqE;IACrE,OAAO,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IAEpE,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mCAAmC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,IAAI,EAAE,UAAU,CAAC;IAEjB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAE3B,0CAA0C;IAC1C,YAAY,EAAE,OAAO,CAAC;IAEtB,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,2CAA2C;IAC3C,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,yBAAyB;IACzB,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEvB,sCAAsC;IACtC,YAAY,EAAE,gBAAgB,EAAE,CAAC;IAEjC,gDAAgD;IAChD,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC;IAE5B,0BAA0B;IAC1B,OAAO,CAAC,EAAE;QACR,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH"}

package/dist/scope/scope-rule.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @file Scope Rule Interface
+ * @description Defines rules for entity visibility and interaction scope
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=scope-rule.js.map

package/dist/scope/scope-rule.js.map

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

package/dist/services/ScopeService.d.ts

@@ -0,0 +1,8 @@
+import { IFEntity } from '../entities/if-entity';
+export declare class ScopeService {
+    private world;
+    constructor(world: any);
+    canSee(viewer: IFEntity, target: IFEntity): boolean;
+    canReach(actor: IFEntity, target: IFEntity): boolean;
+}
+//# sourceMappingURL=ScopeService.d.ts.map

package/dist/services/ScopeService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopeService.d.ts","sourceRoot":"","sources":["../../src/services/ScopeService.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,qBAAa,YAAY;IACX,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,GAAG;IAE9B,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO;IAKnD,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,OAAO;CAIrD"}

package/dist/services/ScopeService.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopeService = void 0;
+class ScopeService {
+    world;
+    constructor(world) {
+        this.world = world;
+    }
+    canSee(viewer, target) {
+        // TODO: Implement visibility logic
+        return true;
+    }
+    canReach(actor, target) {
+        // TODO: Implement reachability logic
+        return true;
+    }
+}
+exports.ScopeService = ScopeService;
+//# sourceMappingURL=ScopeService.js.map

package/dist/services/ScopeService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScopeService.js","sourceRoot":"","sources":["../../src/services/ScopeService.ts"],"names":[],"mappings":";;;AAGA,MAAa,YAAY;IACH;IAApB,YAAoB,KAAU;QAAV,UAAK,GAAL,KAAK,CAAK;IAAG,CAAC;IAElC,MAAM,CAAC,MAAgB,EAAE,MAAgB;QACvC,mCAAmC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ,CAAC,KAAe,EAAE,MAAgB;QACxC,qCAAqC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAZD,oCAYC"}

package/dist/services/index.d.ts

@@ -0,0 +1,2 @@
+export { ScopeService } from './ScopeService';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopeService = void 0;
+var ScopeService_1 = require("./ScopeService");
+Object.defineProperty(exports, "ScopeService", { enumerable: true, get: function () { return ScopeService_1.ScopeService; } });
+//# sourceMappingURL=index.js.map

package/dist/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":";;;AAAA,+CAA8C;AAArC,4GAAA,YAAY,OAAA"}

package/dist/test-structure.d.ts

@@ -0,0 +1,3 @@
+import { IFEntity } from './entities/if-entity';
+export declare function testWorldModel(): IFEntity;
+//# sourceMappingURL=test-structure.d.ts.map

package/dist/test-structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-structure.d.ts","sourceRoot":"","sources":["../src/test-structure.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAsBhD,wBAAgB,cAAc,aAG7B"}

package/dist/test-structure.js

@@ -0,0 +1,26 @@
+"use strict";
+// Test file to verify world-model package structure
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testWorldModel = testWorldModel;
+const if_entity_1 = require("./entities/if-entity");
+const trait_types_1 = require("./traits/trait-types");
+const containerTrait_1 = require("./traits/container/containerTrait");
+// Test creating an entity
+const box = new if_entity_1.IFEntity('box-1', 'container');
+// Test adding a trait
+const containerTrait = new containerTrait_1.ContainerTrait({
+    capacity: {
+        maxWeight: 10,
+        maxItems: 10
+    },
+    isTransparent: true
+});
+box.add(containerTrait);
+// Test checking for trait
+console.log('Has container trait:', box.has(trait_types_1.TraitType.CONTAINER));
+console.log('Container maxWeight:', box.get(trait_types_1.TraitType.CONTAINER)?.capacity?.maxWeight);
+function testWorldModel() {
+    console.log('World model package is working!');
+    return box;
+}
+//# sourceMappingURL=test-structure.js.map

package/dist/test-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-structure.js","sourceRoot":"","sources":["../src/test-structure.ts"],"names":[],"mappings":";AAAA,oDAAoD;;AAwBpD,wCAGC;AAzBD,oDAAgD;AAChD,sDAAiD;AACjD,sEAAmE;AAEnE,0BAA0B;AAC1B,MAAM,GAAG,GAAG,IAAI,oBAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;AAE/C,sBAAsB;AACtB,MAAM,cAAc,GAAG,IAAI,+BAAc,CAAC;IACxC,QAAQ,EAAE;QACR,SAAS,EAAE,EAAE;QACb,QAAQ,EAAE,EAAE;KACb;IACD,aAAa,EAAE,IAAI;CACpB,CAAC,CAAC;AAEH,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAExB,0BAA0B;AAC1B,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAE,GAAG,CAAC,GAAG,CAAC,uBAAS,CAAC,SAAS,CAAC,CAAC,CAAC;AAClE,OAAO,CAAC,GAAG,CAAC,sBAAsB,EAAG,GAAG,CAAC,GAAG,CAAC,uBAAS,CAAC,SAAS,CAAoB,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AAE3G,SAAgB,cAAc;IAC5B,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;IAC/C,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/traits/actor/actorBehavior.d.ts

@@ -0,0 +1,121 @@
+import { Behavior } from '../../behaviors/behavior';
+import { IFEntity } from '../../entities/if-entity';
+import { ActorTrait } from './actorTrait';
+import { IWorldQuery } from '../container/containerBehavior';
+import { EntityId } from '@sharpee/core';
+/**
+ * Result of a take item operation
+ */
+export interface ITakeItemResult {
+    success: boolean;
+    alreadyHeld?: boolean;
+    tooHeavy?: boolean;
+    inventoryFull?: boolean;
+    cantTake?: boolean;
+    needsRemoval?: boolean;
+    fromContainer?: string;
+    stateChanged?: boolean;
+}
+/**
+ * Result of a drop item operation
+ */
+export interface IDropItemResult {
+    success: boolean;
+    notHeld?: boolean;
+    stillWorn?: boolean;
+    containerFull?: boolean;
+    stateChanged?: boolean;
+}
+/**
+ * Behavior for actors in the world.
+ *
+ * Handles inventory management, movement validation, and actor-specific logic.
+ */
+export declare class ActorBehavior extends Behavior {
+    static requiredTraits: "actor"[];
+    /**
+     * Check if this is the player character
+     */
+    static isPlayer(entity: IFEntity): boolean;
+    /**
+     * Check if this actor can be controlled by the player
+     */
+    static isPlayable(entity: IFEntity): boolean;
+    /**
+     * Get actor's pronouns
+     */
+    static getPronouns(entity: IFEntity): ActorTrait['pronouns'];
+    /**
+     * Get a specific pronoun
+     */
+    static getPronoun(entity: IFEntity, type: keyof ActorTrait['pronouns']): string;
+    /**
+     * Check if actor can carry an item
+     */
+    static canCarry(actor: IFEntity, item: IFEntity, world: IWorldQuery): boolean;
+    /**
+     * Get total weight of carried items
+     */
+    static getCarriedWeight(actor: IFEntity, world: IWorldQuery): number;
+    /**
+     * Get total volume of carried items
+     */
+    static getCarriedVolume(actor: IFEntity, world: IWorldQuery): number;
+    /**
+     * Get remaining carrying capacity
+     */
+    static getRemainingCapacity(actor: IFEntity, world: IWorldQuery): {
+        items?: number;
+        weight?: number;
+        volume?: number;
+    };
+    /**
+     * Check if actor is holding a specific item
+     */
+    static isHolding(actor: IFEntity, itemId: EntityId, world: IWorldQuery): boolean;
+    /**
+     * Get actor's current state
+     */
+    static getState(entity: IFEntity): string | undefined;
+    /**
+     * Set actor's state
+     */
+    static setState(entity: IFEntity, state: string | undefined): void;
+    /**
+     * Get custom property value
+     */
+    static getCustomProperty(entity: IFEntity, key: string): any;
+    /**
+     * Set custom property value
+     */
+    static setCustomProperty(entity: IFEntity, key: string, value: any): void;
+    /**
+     * Find the player actor in a collection of entities
+     */
+    static findPlayer(entities: IFEntity[]): IFEntity | undefined;
+    /**
+     * Check if an actor can take an item (capacity validation)
+     * @param actor The actor trying to take the item
+     * @param item The item being taken
+     * @param world World query interface
+     * @returns True if the actor can take the item
+     */
+    static canTakeItem(actor: IFEntity, item: IFEntity, world: IWorldQuery): boolean;
+    /**
+     * Have an actor take an item
+     * @param actor The actor taking the item
+     * @param item The item being taken
+     * @param world World query interface
+     * @returns Result describing what happened
+     */
+    static takeItem(actor: IFEntity, item: IFEntity, world: IWorldQuery): ITakeItemResult;
+    /**
+     * Have an actor drop an item
+     * @param actor The actor dropping the item
+     * @param item The item being dropped
+     * @param world World query interface
+     * @returns Result describing what happened
+     */
+    static dropItem(actor: IFEntity, item: IFEntity, world: IWorldQuery): IDropItemResult;
+}
+//# sourceMappingURL=actorBehavior.d.ts.map

package/dist/traits/actor/actorBehavior.d.ts.map

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

package/dist/traits/actor/actorBehavior.js

@@ -0,0 +1,288 @@
+"use strict";
+// packages/world-model/src/traits/actor/actorBehavior.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActorBehavior = void 0;
+const behavior_1 = require("../../behaviors/behavior");
+const trait_types_1 = require("../trait-types");
+const containerBehavior_1 = require("../container/containerBehavior");
+const identityBehavior_1 = require("../identity/identityBehavior");
+const wearableBehavior_1 = require("../wearable/wearableBehavior");
+/**
+ * Behavior for actors in the world.
+ *
+ * Handles inventory management, movement validation, and actor-specific logic.
+ */
+class ActorBehavior extends behavior_1.Behavior {
+    static requiredTraits = [trait_types_1.TraitType.ACTOR];
+    /**
+     * Check if this is the player character
+     */
+    static isPlayer(entity) {
+        const actor = ActorBehavior.require(entity, trait_types_1.TraitType.ACTOR);
+        return actor.isPlayer || false;
+    }
+    /**
+     * Check if this actor can be controlled by the player
+     */
+    static isPlayable(entity) {
+        const actor = ActorBehavior.require(entity, trait_types_1.TraitType.ACTOR);
+        return actor.isPlayable || false;
+    }
+    /**
+     * Get actor's pronouns
+     */
+    static getPronouns(entity) {
+        const actor = ActorBehavior.require(entity, trait_types_1.TraitType.ACTOR);
+        return actor.pronouns;
+    }
+    /**
+     * Get a specific pronoun
+     */
+    static getPronoun(entity, type) {
+        const pronouns = ActorBehavior.getPronouns(entity);
+        return pronouns[type];
+    }
+    /**
+     * Check if actor can carry an item
+     */
+    static canCarry(actor, item, world) {
+        const actorTrait = ActorBehavior.require(actor, trait_types_1.TraitType.ACTOR);
+        // Check inventory limits
+        if (actorTrait.capacity) {
+            const limit = actorTrait.capacity;
+            // Check item count
+            if (limit.maxItems !== undefined) {
+                const currentCount = world.getContents(actor.id).length;
+                if (currentCount >= limit.maxItems) {
+                    return false;
+                }
+            }
+            // Check weight limit
+            if (limit.maxWeight !== undefined) {
+                const currentWeight = ActorBehavior.getCarriedWeight(actor, world);
+                const itemWeight = identityBehavior_1.IdentityBehavior.getWeight(item);
+                if (currentWeight + itemWeight > limit.maxWeight) {
+                    return false;
+                }
+            }
+            // Check volume limit
+            if (limit.maxVolume !== undefined) {
+                const currentVolume = ActorBehavior.getCarriedVolume(actor, world);
+                const itemVolume = identityBehavior_1.IdentityBehavior.getVolume(item);
+                if (currentVolume + itemVolume > limit.maxVolume) {
+                    return false;
+                }
+            }
+        }
+        return true;
+    }
+    /**
+     * Get total weight of carried items
+     */
+    static getCarriedWeight(actor, world) {
+        const items = world.getContents(actor.id);
+        return items.reduce((total, item) => {
+            return total + identityBehavior_1.IdentityBehavior.getWeight(item);
+        }, 0);
+    }
+    /**
+     * Get total volume of carried items
+     */
+    static getCarriedVolume(actor, world) {
+        const items = world.getContents(actor.id);
+        return items.reduce((total, item) => {
+            return total + identityBehavior_1.IdentityBehavior.getVolume(item);
+        }, 0);
+    }
+    /**
+     * Get remaining carrying capacity
+     */
+    static getRemainingCapacity(actor, world) {
+        const actorTrait = ActorBehavior.require(actor, trait_types_1.TraitType.ACTOR);
+        const result = {};
+        if (actorTrait.capacity) {
+            const limit = actorTrait.capacity;
+            if (limit.maxItems !== undefined) {
+                const current = world.getContents(actor.id).length;
+                result.items = limit.maxItems - current;
+            }
+            if (limit.maxWeight !== undefined) {
+                result.weight = limit.maxWeight - ActorBehavior.getCarriedWeight(actor, world);
+            }
+            if (limit.maxVolume !== undefined) {
+                result.volume = limit.maxVolume - ActorBehavior.getCarriedVolume(actor, world);
+            }
+        }
+        return result;
+    }
+    /**
+     * Check if actor is holding a specific item
+     */
+    static isHolding(actor, itemId, world) {
+        const itemLocation = world.getLocation(itemId);
+        return itemLocation === actor.id;
+    }
+    /**
+     * Get actor's current state
+     */
+    static getState(entity) {
+        const actor = ActorBehavior.require(entity, trait_types_1.TraitType.ACTOR);
+        return actor.state;
+    }
+    /**
+     * Set actor's state
+     */
+    static setState(entity, state) {
+        const actor = ActorBehavior.require(entity, trait_types_1.TraitType.ACTOR);
+        actor.state = state;
+    }
+    /**
+     * Get custom property value
+     */
+    static getCustomProperty(entity, key) {
+        const actor = ActorBehavior.require(entity, trait_types_1.TraitType.ACTOR);
+        return actor.customProperties?.[key];
+    }
+    /**
+     * Set custom property value
+     */
+    static setCustomProperty(entity, key, value) {
+        const actor = ActorBehavior.require(entity, trait_types_1.TraitType.ACTOR);
+        if (!actor.customProperties) {
+            actor.customProperties = {};
+        }
+        actor.customProperties[key] = value;
+    }
+    /**
+     * Find the player actor in a collection of entities
+     */
+    static findPlayer(entities) {
+        return entities.find(e => e.has(trait_types_1.TraitType.ACTOR) && ActorBehavior.isPlayer(e));
+    }
+    /**
+     * Check if an actor can take an item (capacity validation)
+     * @param actor The actor trying to take the item
+     * @param item The item being taken
+     * @param world World query interface
+     * @returns True if the actor can take the item
+     */
+    static canTakeItem(actor, item, world) {
+        const actorTrait = actor.get(trait_types_1.TraitType.ACTOR);
+        if (!actorTrait)
+            return false;
+        // If actor has CONTAINER trait, delegate to ContainerBehavior
+        if (actor.has(trait_types_1.TraitType.CONTAINER)) {
+            return containerBehavior_1.ContainerBehavior.canAccept(actor, item, world);
+        }
+        // Check weight capacity
+        if (actorTrait?.capacity?.maxWeight !== undefined) {
+            const maxWeight = actorTrait.capacity.maxWeight;
+            const currentWeight = ActorBehavior.getCarriedWeight(actor, world);
+            // Note: ItemWeight calculation would need world interface extension
+            // For now, assume weight checking is done at higher level
+            const itemWeight = 0; // TODO: Add weight support to IWorldQuery
+            if (currentWeight + itemWeight > maxWeight) {
+                return false;
+            }
+        }
+        // Check item count if defined on ACTOR trait (and not already checked via CONTAINER)
+        if (!actor.has(trait_types_1.TraitType.CONTAINER) && actorTrait?.capacity?.maxItems !== undefined) {
+            const currentCount = world.getContents(actor.id)
+                .filter(item => !wearableBehavior_1.WearableBehavior.isWorn(item)).length;
+            if (currentCount >= actorTrait.capacity.maxItems) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Have an actor take an item
+     * @param actor The actor taking the item
+     * @param item The item being taken
+     * @param world World query interface
+     * @returns Result describing what happened
+     */
+    static takeItem(actor, item, world) {
+        // Check if actor already has the item
+        const currentLocation = world.getLocation(item.id);
+        if (currentLocation === actor.id) {
+            return {
+                success: false,
+                alreadyHeld: true,
+                stateChanged: false
+            };
+        }
+        // Check capacity constraints
+        if (!ActorBehavior.canTakeItem(actor, item, world)) {
+            const actorTrait = actor.get(trait_types_1.TraitType.ACTOR);
+            // Determine specific failure reason
+            if (actorTrait?.capacity?.maxWeight !== undefined) {
+                const maxWeight = actorTrait.capacity.maxWeight;
+                const currentWeight = ActorBehavior.getCarriedWeight(actor, world);
+                // Note: ItemWeight calculation would need world interface extension
+                const itemWeight = 0; // TODO: Add weight support to IWorldQuery
+                if (currentWeight + itemWeight > maxWeight) {
+                    return {
+                        success: false,
+                        tooHeavy: true,
+                        stateChanged: false
+                    };
+                }
+            }
+            return {
+                success: false,
+                inventoryFull: true,
+                stateChanged: false
+            };
+        }
+        // Check if item needs removal from container/supporter
+        let needsRemoval = false;
+        let fromContainer;
+        if (currentLocation) {
+            // Note: getEntity would need to be added to IWorldQuery interface
+            // For now, assume container detection is done at higher level
+            needsRemoval = true; // TODO: Add entity lookup support to IWorldQuery
+            fromContainer = currentLocation;
+        }
+        // All checks passed - taking is valid
+        return {
+            success: true,
+            stateChanged: true,
+            needsRemoval,
+            fromContainer
+        };
+    }
+    /**
+     * Have an actor drop an item
+     * @param actor The actor dropping the item
+     * @param item The item being dropped
+     * @param world World query interface
+     * @returns Result describing what happened
+     */
+    static dropItem(actor, item, world) {
+        // Check if actor actually has the item
+        const currentLocation = world.getLocation(item.id);
+        if (currentLocation !== actor.id) {
+            return {
+                success: false,
+                notHeld: true,
+                stateChanged: false
+            };
+        }
+        // Check if item is still worn (can't drop worn items)
+        if (wearableBehavior_1.WearableBehavior.isWorn(item)) {
+            return {
+                success: false,
+                stillWorn: true,
+                stateChanged: false
+            };
+        }
+        // All checks passed - dropping is valid
+        return {
+            success: true,
+            stateChanged: true
+        };
+    }
+}
+exports.ActorBehavior = ActorBehavior;
+//# sourceMappingURL=actorBehavior.js.map

package/dist/traits/actor/actorBehavior.js.map

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