@sharpee/world-model 0.9.60-beta

package/dist/traits/vehicle/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Vehicle trait module
+ */
+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("./vehicleTrait"), exports);
+__exportStar(require("./vehicleBehavior"), exports);
+//# sourceMappingURL=index.js.map

package/dist/traits/vehicle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/traits/vehicle/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,iDAA+B;AAC/B,oDAAkC"}

package/dist/traits/vehicle/vehicleBehavior.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Vehicle Behavior - Handles vehicle movement and actor transport
+ *
+ * Provides utilities for:
+ * - Moving a vehicle (and its contents) between rooms
+ * - Checking if an actor is in a vehicle
+ * - Getting the vehicle an actor is in
+ */
+import { WorldModel } from '../../world/WorldModel';
+import { IFEntity } from '../../entities/if-entity';
+/**
+ * Check if an entity is a vehicle
+ */
+export declare function isVehicle(entity: IFEntity): boolean;
+/**
+ * Check if an actor is currently inside a vehicle
+ */
+export declare function isActorInVehicle(world: WorldModel, actorId: string): boolean;
+/**
+ * Get the vehicle an actor is in, or undefined if not in a vehicle
+ */
+export declare function getActorVehicle(world: WorldModel, actorId: string): IFEntity | undefined;
+/**
+ * Get all actors currently inside a vehicle
+ */
+export declare function getVehicleOccupants(world: WorldModel, vehicleId: string): IFEntity[];
+/**
+ * Move a vehicle to a new room, transporting all contents with it.
+ * Returns true if movement succeeded.
+ *
+ * This is the core vehicle transport function - when a vehicle moves,
+ * everything inside it (including actors) moves with it.
+ */
+export declare function moveVehicle(world: WorldModel, vehicleId: string, destinationRoomId: string): boolean;
+/**
+ * Check if a vehicle can move (is operational)
+ */
+export declare function canVehicleMove(vehicle: IFEntity): {
+    canMove: boolean;
+    reason?: string;
+};
+/**
+ * Check if an actor can exit their current location.
+ * If in a vehicle that requires exit, they cannot simply walk out.
+ */
+export declare function canActorLeaveLocation(world: WorldModel, actorId: string): {
+    canLeave: boolean;
+    mustExitVehicle?: IFEntity;
+};
+/**
+ * Check if an actor in a vehicle can use GO/walk commands.
+ * Some vehicles block walking movement entirely.
+ *
+ * Returns:
+ * - canWalk: true if actor can use GO commands (not in vehicle, or in walkable vehicle)
+ * - vehicle: the vehicle entity if actor is in one (undefined if not in a vehicle)
+ */
+export declare function canActorWalkInVehicle(world: WorldModel, actorId: string): {
+    canWalk: boolean;
+    vehicle?: IFEntity;
+};
+//# sourceMappingURL=vehicleBehavior.d.ts.map

package/dist/traits/vehicle/vehicleBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vehicleBehavior.d.ts","sourceRoot":"","sources":["../../../src/traits/vehicle/vehicleBehavior.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIpD;;GAEG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAQ5E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAYxF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,QAAQ,EAAE,CAGpF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,iBAAiB,EAAE,MAAM,GACxB,OAAO,CAsBT;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,QAAQ,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAcvF;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,GACd;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,eAAe,CAAC,EAAE,QAAQ,CAAA;CAAE,CAiBnD;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,GACd;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,QAAQ,CAAA;CAAE,CAmB1C"}

package/dist/traits/vehicle/vehicleBehavior.js

@@ -0,0 +1,145 @@
+"use strict";
+/**
+ * Vehicle Behavior - Handles vehicle movement and actor transport
+ *
+ * Provides utilities for:
+ * - Moving a vehicle (and its contents) between rooms
+ * - Checking if an actor is in a vehicle
+ * - Getting the vehicle an actor is in
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isVehicle = isVehicle;
+exports.isActorInVehicle = isActorInVehicle;
+exports.getActorVehicle = getActorVehicle;
+exports.getVehicleOccupants = getVehicleOccupants;
+exports.moveVehicle = moveVehicle;
+exports.canVehicleMove = canVehicleMove;
+exports.canActorLeaveLocation = canActorLeaveLocation;
+exports.canActorWalkInVehicle = canActorWalkInVehicle;
+const trait_types_1 = require("../trait-types");
+/**
+ * Check if an entity is a vehicle
+ */
+function isVehicle(entity) {
+    return entity.has(trait_types_1.TraitType.VEHICLE);
+}
+/**
+ * Check if an actor is currently inside a vehicle
+ */
+function isActorInVehicle(world, actorId) {
+    const location = world.getLocation(actorId);
+    if (!location)
+        return false;
+    const locationEntity = world.getEntity(location);
+    if (!locationEntity)
+        return false;
+    return isVehicle(locationEntity);
+}
+/**
+ * Get the vehicle an actor is in, or undefined if not in a vehicle
+ */
+function getActorVehicle(world, actorId) {
+    const location = world.getLocation(actorId);
+    if (!location)
+        return undefined;
+    const locationEntity = world.getEntity(location);
+    if (!locationEntity)
+        return undefined;
+    if (isVehicle(locationEntity)) {
+        return locationEntity;
+    }
+    return undefined;
+}
+/**
+ * Get all actors currently inside a vehicle
+ */
+function getVehicleOccupants(world, vehicleId) {
+    const contents = world.getContents(vehicleId);
+    return contents.filter((entity) => entity.has(trait_types_1.TraitType.ACTOR));
+}
+/**
+ * Move a vehicle to a new room, transporting all contents with it.
+ * Returns true if movement succeeded.
+ *
+ * This is the core vehicle transport function - when a vehicle moves,
+ * everything inside it (including actors) moves with it.
+ */
+function moveVehicle(world, vehicleId, destinationRoomId) {
+    const vehicle = world.getEntity(vehicleId);
+    if (!vehicle)
+        return false;
+    const vehicleTrait = vehicle.get(trait_types_1.TraitType.VEHICLE);
+    if (!vehicleTrait)
+        return false;
+    // Move the vehicle to the new room
+    world.moveEntity(vehicleId, destinationRoomId);
+    // Update vehicle position if using position tracking
+    if (vehicleTrait.positionRooms) {
+        // Find position name for this room
+        const positionEntry = Object.entries(vehicleTrait.positionRooms)
+            .find(([_, roomId]) => roomId === destinationRoomId);
+        if (positionEntry) {
+            vehicleTrait.currentPosition = positionEntry[0];
+        }
+    }
+    return true;
+}
+/**
+ * Check if a vehicle can move (is operational)
+ */
+function canVehicleMove(vehicle) {
+    const vehicleTrait = vehicle.get(trait_types_1.TraitType.VEHICLE);
+    if (!vehicleTrait) {
+        return { canMove: false, reason: 'Not a vehicle' };
+    }
+    if (!vehicleTrait.isOperational) {
+        return {
+            canMove: false,
+            reason: vehicleTrait.notOperationalReason ?? 'The vehicle is not operational'
+        };
+    }
+    return { canMove: true };
+}
+/**
+ * Check if an actor can exit their current location.
+ * If in a vehicle that requires exit, they cannot simply walk out.
+ */
+function canActorLeaveLocation(world, actorId) {
+    const vehicle = getActorVehicle(world, actorId);
+    if (!vehicle) {
+        return { canLeave: true };
+    }
+    const vehicleTrait = vehicle.get(trait_types_1.TraitType.VEHICLE);
+    if (!vehicleTrait) {
+        return { canLeave: true };
+    }
+    if (vehicleTrait.requiresExitBeforeLeaving) {
+        return { canLeave: false, mustExitVehicle: vehicle };
+    }
+    return { canLeave: true };
+}
+/**
+ * Check if an actor in a vehicle can use GO/walk commands.
+ * Some vehicles block walking movement entirely.
+ *
+ * Returns:
+ * - canWalk: true if actor can use GO commands (not in vehicle, or in walkable vehicle)
+ * - vehicle: the vehicle entity if actor is in one (undefined if not in a vehicle)
+ */
+function canActorWalkInVehicle(world, actorId) {
+    const vehicle = getActorVehicle(world, actorId);
+    if (!vehicle) {
+        return { canWalk: true };
+    }
+    const vehicleTrait = vehicle.get(trait_types_1.TraitType.VEHICLE);
+    if (!vehicleTrait) {
+        // In something with no VehicleTrait - treat as blocking container
+        return { canWalk: false, vehicle };
+    }
+    if (vehicleTrait.blocksWalkingMovement) {
+        return { canWalk: false, vehicle };
+    }
+    // In a walkable vehicle - return the vehicle so caller knows player is in one
+    return { canWalk: true, vehicle };
+}
+//# sourceMappingURL=vehicleBehavior.js.map

package/dist/traits/vehicle/vehicleBehavior.js.map

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

package/dist/traits/vehicle/vehicleTrait.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Vehicle Trait - For enterable containers that transport actors
+ *
+ * Vehicles are enterable containers (bucket, boat, basket, balloon) where:
+ * - Actor enters the vehicle (ENTER BUCKET)
+ * - Vehicle moves, taking its contents with it
+ * - Actor exits the vehicle (EXIT BUCKET)
+ *
+ * Based on Infocom's vehicle concept from Zork.
+ */
+import { ITrait } from '../trait';
+/**
+ * Vehicle type determines movement behavior
+ */
+export type VehicleType = 'counterweight' | 'watercraft' | 'aircraft' | 'cable' | 'generic';
+/**
+ * Trait for vehicles - enterable containers that transport actors
+ */
+export declare class VehicleTrait implements ITrait {
+    static readonly type: "vehicle";
+    readonly type: "vehicle";
+    /** Type of vehicle determines default behavior */
+    vehicleType: VehicleType;
+    /**
+     * When vehicle moves, all contents (including actors) move with it.
+     * This is always true for vehicles.
+     */
+    readonly movesWithContents: boolean;
+    /**
+     * If true, actor cannot use GO/walk commands while in vehicle.
+     * Movement must be through vehicle-specific actions.
+     * - Bucket: POUR/FILL moves it
+     * - Boat: row, current moves it
+     * - Balloon: burn/release moves it
+     */
+    blocksWalkingMovement: boolean;
+    /**
+     * If true, actor must EXIT vehicle before leaving the room on foot.
+     * Prevents "GO EAST" while sitting in a bucket.
+     */
+    requiresExitBeforeLeaving: boolean;
+    /**
+     * Current location/state of the vehicle (e.g., 'top', 'bottom', 'river-1')
+     * Used by vehicle-specific logic to track position.
+     */
+    currentPosition?: string;
+    /**
+     * Map of position names to room IDs.
+     * e.g., { 'top': 'top-of-well', 'bottom': 'well-bottom' }
+     */
+    positionRooms?: Record<string, string>;
+    /**
+     * Whether the vehicle is currently operational/usable.
+     * Boat might need to be inflated, balloon might need fuel.
+     */
+    isOperational: boolean;
+    /**
+     * Reason the vehicle is not operational (for error messages).
+     */
+    notOperationalReason?: string;
+    /**
+     * If true, visibility passes through to the containing room.
+     * - Bucket, raft, boat: transparent (can see the room you're in)
+     * - Airplane, submarine: not transparent (see vehicle interior only)
+     */
+    transparent: boolean;
+    constructor(options?: Partial<Omit<VehicleTrait, 'type' | 'movesWithContents'>>);
+}
+/**
+ * Type guard for VehicleTrait
+ */
+export declare function isVehicleTrait(trait: ITrait): trait is VehicleTrait;
+/**
+ * Factory function for creating VehicleTrait
+ */
+export declare function createVehicleTrait(options?: Partial<Omit<VehicleTrait, 'type' | 'movesWithContents'>>): VehicleTrait;
+//# sourceMappingURL=vehicleTrait.d.ts.map

package/dist/traits/vehicle/vehicleTrait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vehicleTrait.d.ts","sourceRoot":"","sources":["../../../src/traits/vehicle/vehicleTrait.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,YAAY,GACZ,UAAU,GACV,OAAO,GACP,SAAS,CAAC;AAEd;;GAEG;AACH,qBAAa,YAAa,YAAW,MAAM;IACzC,MAAM,CAAC,QAAQ,CAAC,IAAI,YAAqB;IACzC,QAAQ,CAAC,IAAI,YAAqB;IAElC,kDAAkD;IAClD,WAAW,EAAE,WAAW,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAQ;IAE3C;;;;;;OAMG;IACH,qBAAqB,EAAE,OAAO,CAAC;IAE/B;;;OAGG;IACH,yBAAyB,EAAE,OAAO,CAAC;IAEnC;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC;;;OAGG;IACH,aAAa,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC;gBAET,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAM;CAUpF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,YAAY,CAEnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,GAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAM,GACtE,YAAY,CAEd"}

package/dist/traits/vehicle/vehicleTrait.js

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * Vehicle Trait - For enterable containers that transport actors
+ *
+ * Vehicles are enterable containers (bucket, boat, basket, balloon) where:
+ * - Actor enters the vehicle (ENTER BUCKET)
+ * - Vehicle moves, taking its contents with it
+ * - Actor exits the vehicle (EXIT BUCKET)
+ *
+ * Based on Infocom's vehicle concept from Zork.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VehicleTrait = void 0;
+exports.isVehicleTrait = isVehicleTrait;
+exports.createVehicleTrait = createVehicleTrait;
+const trait_types_1 = require("../trait-types");
+/**
+ * Trait for vehicles - enterable containers that transport actors
+ */
+class VehicleTrait {
+    static type = trait_types_1.TraitType.VEHICLE;
+    type = trait_types_1.TraitType.VEHICLE;
+    /** Type of vehicle determines default behavior */
+    vehicleType;
+    /**
+     * When vehicle moves, all contents (including actors) move with it.
+     * This is always true for vehicles.
+     */
+    movesWithContents = true;
+    /**
+     * If true, actor cannot use GO/walk commands while in vehicle.
+     * Movement must be through vehicle-specific actions.
+     * - Bucket: POUR/FILL moves it
+     * - Boat: row, current moves it
+     * - Balloon: burn/release moves it
+     */
+    blocksWalkingMovement;
+    /**
+     * If true, actor must EXIT vehicle before leaving the room on foot.
+     * Prevents "GO EAST" while sitting in a bucket.
+     */
+    requiresExitBeforeLeaving;
+    /**
+     * Current location/state of the vehicle (e.g., 'top', 'bottom', 'river-1')
+     * Used by vehicle-specific logic to track position.
+     */
+    currentPosition;
+    /**
+     * Map of position names to room IDs.
+     * e.g., { 'top': 'top-of-well', 'bottom': 'well-bottom' }
+     */
+    positionRooms;
+    /**
+     * Whether the vehicle is currently operational/usable.
+     * Boat might need to be inflated, balloon might need fuel.
+     */
+    isOperational;
+    /**
+     * Reason the vehicle is not operational (for error messages).
+     */
+    notOperationalReason;
+    /**
+     * If true, visibility passes through to the containing room.
+     * - Bucket, raft, boat: transparent (can see the room you're in)
+     * - Airplane, submarine: not transparent (see vehicle interior only)
+     */
+    transparent;
+    constructor(options = {}) {
+        this.vehicleType = options.vehicleType ?? 'generic';
+        this.blocksWalkingMovement = options.blocksWalkingMovement ?? true;
+        this.requiresExitBeforeLeaving = options.requiresExitBeforeLeaving ?? true;
+        this.currentPosition = options.currentPosition;
+        this.positionRooms = options.positionRooms;
+        this.isOperational = options.isOperational ?? true;
+        this.notOperationalReason = options.notOperationalReason;
+        this.transparent = options.transparent ?? true; // Default to transparent for most IF vehicles
+    }
+}
+exports.VehicleTrait = VehicleTrait;
+/**
+ * Type guard for VehicleTrait
+ */
+function isVehicleTrait(trait) {
+    return trait.type === trait_types_1.TraitType.VEHICLE;
+}
+/**
+ * Factory function for creating VehicleTrait
+ */
+function createVehicleTrait(options = {}) {
+    return new VehicleTrait(options);
+}
+//# sourceMappingURL=vehicleTrait.js.map

package/dist/traits/vehicle/vehicleTrait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vehicleTrait.js","sourceRoot":"","sources":["../../../src/traits/vehicle/vehicleTrait.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AA2FH,wCAEC;AAKD,gDAIC;AApGD,gDAA2C;AAa3C;;GAEG;AACH,MAAa,YAAY;IACvB,MAAM,CAAU,IAAI,GAAG,uBAAS,CAAC,OAAO,CAAC;IAChC,IAAI,GAAG,uBAAS,CAAC,OAAO,CAAC;IAElC,kDAAkD;IAClD,WAAW,CAAc;IAEzB;;;OAGG;IACM,iBAAiB,GAAY,IAAI,CAAC;IAE3C;;;;;;OAMG;IACH,qBAAqB,CAAU;IAE/B;;;OAGG;IACH,yBAAyB,CAAU;IAEnC;;;OAGG;IACH,eAAe,CAAU;IAEzB;;;OAGG;IACH,aAAa,CAA0B;IAEvC;;;OAGG;IACH,aAAa,CAAU;IAEvB;;OAEG;IACH,oBAAoB,CAAU;IAE9B;;;;OAIG;IACH,WAAW,CAAU;IAErB,YAAY,UAAqE,EAAE;QACjF,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,SAAS,CAAC;QACpD,IAAI,CAAC,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,IAAI,IAAI,CAAC;QACnE,IAAI,CAAC,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,IAAI,IAAI,CAAC;QAC3E,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;QAC3C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;QACnD,IAAI,CAAC,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC;QACzD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,8CAA8C;IAChG,CAAC;;AAnEH,oCAoEC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,IAAI,KAAK,uBAAS,CAAC,OAAO,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAChC,UAAqE,EAAE;IAEvE,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;AACnC,CAAC"}

package/dist/traits/weapon/index.d.ts

@@ -0,0 +1,3 @@
+export { WeaponTrait, IWeaponData } from './weaponTrait';
+export { WeaponBehavior, IWeaponDamageResult } from './weaponBehavior';
+//# sourceMappingURL=index.d.ts.map

package/dist/traits/weapon/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/traits/weapon/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/traits/weapon/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WeaponBehavior = exports.WeaponTrait = void 0;
+var weaponTrait_1 = require("./weaponTrait");
+Object.defineProperty(exports, "WeaponTrait", { enumerable: true, get: function () { return weaponTrait_1.WeaponTrait; } });
+var weaponBehavior_1 = require("./weaponBehavior");
+Object.defineProperty(exports, "WeaponBehavior", { enumerable: true, get: function () { return weaponBehavior_1.WeaponBehavior; } });
+//# sourceMappingURL=index.js.map

package/dist/traits/weapon/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/traits/weapon/index.ts"],"names":[],"mappings":";;;AAAA,6CAAyD;AAAhD,0GAAA,WAAW,OAAA;AACpB,mDAAuE;AAA9D,gHAAA,cAAc,OAAA"}

package/dist/traits/weapon/weaponBehavior.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Behavior for weapon entities
+ */
+import { Behavior } from '../../behaviors/behavior';
+import { IFEntity } from '../../entities/if-entity';
+/**
+ * Result of a weapon damage calculation
+ */
+export interface IWeaponDamageResult {
+    damage: number;
+    weaponType: string;
+    criticalHit?: boolean;
+    weaponBroke?: boolean;
+}
+/**
+ * Behavior for weapon entities.
+ *
+ * Handles damage calculation and weapon durability.
+ */
+export declare class WeaponBehavior extends Behavior {
+    static requiredTraits: "weapon"[];
+    /**
+     * Calculate damage for a weapon
+     */
+    static calculateDamage(weapon: IFEntity): IWeaponDamageResult;
+    /**
+     * Check if a weapon can damage a specific target type
+     */
+    static canDamage(weapon: IFEntity, targetType?: string): boolean;
+    /**
+     * Get weapon type
+     */
+    static getWeaponType(weapon: IFEntity): string;
+    /**
+     * Check if weapon requires two hands
+     */
+    static isTwoHanded(weapon: IFEntity): boolean;
+    /**
+     * Repair weapon (restore durability)
+     */
+    static repair(weapon: IFEntity): boolean;
+    /**
+     * Check if weapon is broken
+     */
+    static isBroken(weapon: IFEntity): boolean;
+}
+//# sourceMappingURL=weaponBehavior.d.ts.map

package/dist/traits/weapon/weaponBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"weaponBehavior.d.ts","sourceRoot":"","sources":["../../../src/traits/weapon/weaponBehavior.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIpD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,MAAM,CAAC,cAAc,aAAsB;IAE3C;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,QAAQ,GAAG,mBAAmB;IA+B7D;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO;IAsBhE;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM;IAK9C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAK7C;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IASxC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;CAS3C"}

package/dist/traits/weapon/weaponBehavior.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Behavior for weapon entities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WeaponBehavior = void 0;
+const behavior_1 = require("../../behaviors/behavior");
+const trait_types_1 = require("../trait-types");
+/**
+ * Behavior for weapon entities.
+ *
+ * Handles damage calculation and weapon durability.
+ */
+class WeaponBehavior extends behavior_1.Behavior {
+    static requiredTraits = [trait_types_1.TraitType.WEAPON];
+    /**
+     * Calculate damage for a weapon
+     */
+    static calculateDamage(weapon) {
+        if (!weapon.has(trait_types_1.TraitType.WEAPON)) {
+            throw new Error(`Entity "${weapon.id}" is not a weapon`);
+        }
+        const weaponTrait = weapon.get(trait_types_1.TraitType.WEAPON);
+        // Calculate base damage (random between min and max)
+        const range = weaponTrait.maxDamage - weaponTrait.minDamage;
+        const damage = weaponTrait.minDamage + Math.floor(Math.random() * (range + 1));
+        // Check for critical hit (10% chance)
+        const criticalHit = Math.random() < 0.1;
+        const finalDamage = criticalHit ? damage * 2 : damage;
+        // Handle durability if weapon is breakable
+        let weaponBroke = false;
+        if (weaponTrait.breakable && weaponTrait.durability !== undefined) {
+            weaponTrait.durability--;
+            if (weaponTrait.durability <= 0) {
+                weaponBroke = true;
+            }
+        }
+        return {
+            damage: finalDamage,
+            weaponType: weaponTrait.weaponType,
+            criticalHit,
+            weaponBroke
+        };
+    }
+    /**
+     * Check if a weapon can damage a specific target type
+     */
+    static canDamage(weapon, targetType) {
+        if (!weapon.has(trait_types_1.TraitType.WEAPON)) {
+            return false;
+        }
+        if (!targetType)
+            return true;
+        const weaponTrait = weapon.get(trait_types_1.TraitType.WEAPON);
+        // Special logic for weapon types vs target types
+        // This can be expanded based on game needs
+        switch (targetType) {
+            case 'ghost':
+            case 'spirit':
+                return weaponTrait.weaponType === 'magic' || weaponTrait.weaponType === 'blessed';
+            case 'armor':
+            case 'metal':
+                return weaponTrait.weaponType === 'piercing' || weaponTrait.weaponType === 'magic';
+            default:
+                return true;
+        }
+    }
+    /**
+     * Get weapon type
+     */
+    static getWeaponType(weapon) {
+        const weaponTrait = WeaponBehavior.require(weapon, trait_types_1.TraitType.WEAPON);
+        return weaponTrait.weaponType;
+    }
+    /**
+     * Check if weapon requires two hands
+     */
+    static isTwoHanded(weapon) {
+        const weaponTrait = WeaponBehavior.require(weapon, trait_types_1.TraitType.WEAPON);
+        return weaponTrait.twoHanded;
+    }
+    /**
+     * Repair weapon (restore durability)
+     */
+    static repair(weapon) {
+        const weaponTrait = WeaponBehavior.require(weapon, trait_types_1.TraitType.WEAPON);
+        if (!weaponTrait.breakable)
+            return false;
+        weaponTrait.durability = weaponTrait.maxDurability;
+        return true;
+    }
+    /**
+     * Check if weapon is broken
+     */
+    static isBroken(weapon) {
+        if (!weapon.has(trait_types_1.TraitType.WEAPON)) {
+            return false;
+        }
+        const weaponTrait = weapon.get(trait_types_1.TraitType.WEAPON);
+        if (!weaponTrait.breakable)
+            return false;
+        return weaponTrait.durability !== undefined && weaponTrait.durability <= 0;
+    }
+}
+exports.WeaponBehavior = WeaponBehavior;
+//# sourceMappingURL=weaponBehavior.js.map

package/dist/traits/weapon/weaponBehavior.js.map

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