@sharpee/world-model 0.9.60-beta

package/dist/traits/index.js

@@ -0,0 +1,62 @@
+"use strict";
+// packages/world-model/src/traits/index.ts
+// Central export point for all traits
+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 });
+// Base trait types
+__exportStar(require("./trait"), exports);
+__exportStar(require("./trait-types"), exports);
+__exportStar(require("./implementations"), exports);
+// Individual trait modules (each exports both Trait and Behavior)
+__exportStar(require("./identity"), exports);
+__exportStar(require("./container"), exports);
+__exportStar(require("./room"), exports);
+__exportStar(require("./openable"), exports);
+__exportStar(require("./lockable"), exports);
+__exportStar(require("./readable"), exports);
+__exportStar(require("./light-source"), exports);
+__exportStar(require("./exit"), exports);
+__exportStar(require("./climbable"), exports);
+__exportStar(require("./scenery"), exports);
+__exportStar(require("./supporter"), exports);
+__exportStar(require("./switchable"), exports);
+__exportStar(require("./wearable"), exports);
+__exportStar(require("./clothing"), exports);
+__exportStar(require("./edible"), exports);
+__exportStar(require("./door"), exports);
+__exportStar(require("./actor"), exports);
+// Manipulation traits
+__exportStar(require("./pullable"), exports);
+__exportStar(require("./attached"), exports);
+__exportStar(require("./pushable"), exports);
+__exportStar(require("./button"), exports);
+__exportStar(require("./moveable-scenery"), exports);
+// Combat traits
+__exportStar(require("./weapon"), exports);
+__exportStar(require("./breakable"), exports);
+__exportStar(require("./destructible"), exports);
+__exportStar(require("./combatant"), exports);
+__exportStar(require("./equipped"), exports);
+// Transport traits
+__exportStar(require("./vehicle"), exports);
+__exportStar(require("./enterable"), exports);
+// NPC traits
+__exportStar(require("./npc"), exports);
+// Register function
+__exportStar(require("./register-all"), exports);
+// All traits in one import
+__exportStar(require("./all-traits"), exports);
+//# sourceMappingURL=index.js.map

package/dist/traits/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/traits/index.ts"],"names":[],"mappings":";AAAA,2CAA2C;AAC3C,sCAAsC;;;;;;;;;;;;;;;;AAEtC,mBAAmB;AACnB,0CAAwB;AACxB,gDAA8B;AAC9B,oDAAkC;AAElC,kEAAkE;AAClE,6CAA2B;AAC3B,8CAA4B;AAC5B,yCAAuB;AACvB,6CAA2B;AAC3B,6CAA2B;AAC3B,6CAA2B;AAC3B,iDAA+B;AAC/B,yCAAuB;AACvB,8CAA4B;AAC5B,4CAA0B;AAC1B,8CAA4B;AAC5B,+CAA6B;AAC7B,6CAA2B;AAC3B,6CAA2B;AAC3B,2CAAyB;AACzB,yCAAuB;AACvB,0CAAwB;AAExB,sBAAsB;AACtB,6CAA2B;AAC3B,6CAA2B;AAC3B,6CAA2B;AAC3B,2CAAyB;AACzB,qDAAmC;AAEnC,gBAAgB;AAChB,2CAAyB;AACzB,8CAA4B;AAC5B,iDAA+B;AAC/B,8CAA4B;AAC5B,6CAA2B;AAE3B,mBAAmB;AACnB,4CAA0B;AAC1B,8CAA4B;AAE5B,aAAa;AACb,wCAAsB;AAEtB,oBAAoB;AACpB,iDAA+B;AAE/B,2BAA2B;AAC3B,+CAA6B"}

package/dist/traits/light-source/index.d.ts

@@ -0,0 +1,3 @@
+export { LightSourceTrait } from './lightSourceTrait';
+export { LightSourceBehavior } from './lightSourceBehavior';
+//# sourceMappingURL=index.d.ts.map

package/dist/traits/light-source/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/traits/light-source/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/traits/light-source/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// packages/world-model/src/traits/light-source/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LightSourceBehavior = exports.LightSourceTrait = void 0;
+var lightSourceTrait_1 = require("./lightSourceTrait");
+Object.defineProperty(exports, "LightSourceTrait", { enumerable: true, get: function () { return lightSourceTrait_1.LightSourceTrait; } });
+var lightSourceBehavior_1 = require("./lightSourceBehavior");
+Object.defineProperty(exports, "LightSourceBehavior", { enumerable: true, get: function () { return lightSourceBehavior_1.LightSourceBehavior; } });
+//# sourceMappingURL=index.js.map

package/dist/traits/light-source/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/traits/light-source/index.ts"],"names":[],"mappings":";AAAA,wDAAwD;;;AAExD,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA;AACzB,6DAA4D;AAAnD,0HAAA,mBAAmB,OAAA"}

package/dist/traits/light-source/lightSourceBehavior.d.ts

@@ -0,0 +1,57 @@
+import { Behavior } from '../../behaviors/behavior';
+import { IFEntity } from '../../entities/if-entity';
+/**
+ * Behavior for light source entities.
+ *
+ * Handles the logic for entities that can provide illumination.
+ */
+export declare class LightSourceBehavior extends Behavior {
+    static requiredTraits: "lightSource"[];
+    /**
+     * Turn on the light source
+     * @returns true if successfully lit, false if out of fuel
+     */
+    static light(source: IFEntity): boolean;
+    /**
+     * Turn off the light source
+     */
+    static extinguish(source: IFEntity): void;
+    /**
+     * Check if the light source is currently lit.
+     *
+     * Priority:
+     * 1. Explicit isLit property (true/false)
+     * 2. Switchable trait state (isOn)
+     * 3. Default to lit (for inherently glowing items)
+     */
+    static isLit(source: IFEntity): boolean;
+    /**
+     * Get the brightness level
+     */
+    static getBrightness(source: IFEntity): number;
+    /**
+     * Get remaining fuel
+     * @returns Fuel amount or undefined if unlimited
+     */
+    static getFuelRemaining(source: IFEntity): number | undefined;
+    /**
+     * Check if the light source has fuel
+     */
+    static hasFuel(source: IFEntity): boolean;
+    /**
+     * Consume fuel (typically called each turn the light is on)
+     * @returns true if fuel was consumed, false if out of fuel
+     */
+    static consumeFuel(source: IFEntity, amount?: number): boolean;
+    /**
+     * Refuel the light source
+     * @param amount Amount to add, or fill to max if not specified
+     */
+    static refuel(source: IFEntity, amount?: number): void;
+    /**
+     * Get fuel percentage remaining
+     * @returns 0-100, or undefined if unlimited fuel
+     */
+    static getFuelPercentage(source: IFEntity): number | undefined;
+}
+//# sourceMappingURL=lightSourceBehavior.d.ts.map

package/dist/traits/light-source/lightSourceBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightSourceBehavior.d.ts","sourceRoot":"","sources":["../../../src/traits/light-source/lightSourceBehavior.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAKpD;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,MAAM,CAAC,cAAc,kBAA4B;IAEjD;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAYvC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAKzC;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAiBvC;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM;IAK9C;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS;IAK7D;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAKzC;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO;IAsB9D;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAsBtD;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS;CAS/D"}

package/dist/traits/light-source/lightSourceBehavior.js

@@ -0,0 +1,135 @@
+"use strict";
+// packages/world-model/src/traits/light-source/lightSourceBehavior.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LightSourceBehavior = void 0;
+const behavior_1 = require("../../behaviors/behavior");
+const trait_types_1 = require("../trait-types");
+const switchableBehavior_1 = require("../switchable/switchableBehavior");
+/**
+ * Behavior for light source entities.
+ *
+ * Handles the logic for entities that can provide illumination.
+ */
+class LightSourceBehavior extends behavior_1.Behavior {
+    static requiredTraits = [trait_types_1.TraitType.LIGHT_SOURCE];
+    /**
+     * Turn on the light source
+     * @returns true if successfully lit, false if out of fuel
+     */
+    static light(source) {
+        const trait = LightSourceBehavior.require(source, trait_types_1.TraitType.LIGHT_SOURCE);
+        // Check if there's fuel
+        if (trait.fuelRemaining !== undefined && trait.fuelRemaining <= 0) {
+            return false;
+        }
+        trait.isLit = true;
+        return true;
+    }
+    /**
+     * Turn off the light source
+     */
+    static extinguish(source) {
+        const trait = LightSourceBehavior.require(source, trait_types_1.TraitType.LIGHT_SOURCE);
+        trait.isLit = false;
+    }
+    /**
+     * Check if the light source is currently lit.
+     *
+     * Priority:
+     * 1. Explicit isLit property (true/false)
+     * 2. Switchable trait state (isOn)
+     * 3. Default to lit (for inherently glowing items)
+     */
+    static isLit(source) {
+        const trait = LightSourceBehavior.require(source, trait_types_1.TraitType.LIGHT_SOURCE);
+        // Explicit isLit takes precedence
+        if (trait.isLit !== undefined) {
+            return trait.isLit;
+        }
+        // Fall back to switchable state
+        if (source.hasTrait(trait_types_1.TraitType.SWITCHABLE)) {
+            return switchableBehavior_1.SwitchableBehavior.isOn(source);
+        }
+        // Default: light sources without explicit state are lit
+        return true;
+    }
+    /**
+     * Get the brightness level
+     */
+    static getBrightness(source) {
+        const trait = LightSourceBehavior.require(source, trait_types_1.TraitType.LIGHT_SOURCE);
+        return trait.brightness;
+    }
+    /**
+     * Get remaining fuel
+     * @returns Fuel amount or undefined if unlimited
+     */
+    static getFuelRemaining(source) {
+        const trait = LightSourceBehavior.require(source, trait_types_1.TraitType.LIGHT_SOURCE);
+        return trait.fuelRemaining;
+    }
+    /**
+     * Check if the light source has fuel
+     */
+    static hasFuel(source) {
+        const trait = LightSourceBehavior.require(source, trait_types_1.TraitType.LIGHT_SOURCE);
+        return trait.fuelRemaining === undefined || trait.fuelRemaining > 0;
+    }
+    /**
+     * Consume fuel (typically called each turn the light is on)
+     * @returns true if fuel was consumed, false if out of fuel
+     */
+    static consumeFuel(source, amount) {
+        const trait = LightSourceBehavior.require(source, trait_types_1.TraitType.LIGHT_SOURCE);
+        // No fuel tracking
+        if (trait.fuelRemaining === undefined) {
+            return true;
+        }
+        // Determine consumption amount
+        const consumeAmount = amount ?? trait.fuelConsumptionRate ?? 1;
+        // Check if enough fuel
+        if (trait.fuelRemaining < consumeAmount) {
+            trait.fuelRemaining = 0;
+            trait.isLit = false; // Auto-extinguish when out of fuel
+            return false;
+        }
+        trait.fuelRemaining -= consumeAmount;
+        return true;
+    }
+    /**
+     * Refuel the light source
+     * @param amount Amount to add, or fill to max if not specified
+     */
+    static refuel(source, amount) {
+        const trait = LightSourceBehavior.require(source, trait_types_1.TraitType.LIGHT_SOURCE);
+        // Can't refuel unlimited lights
+        if (trait.fuelRemaining === undefined) {
+            return;
+        }
+        if (amount === undefined && trait.maxFuel !== undefined) {
+            // Fill to max
+            trait.fuelRemaining = trait.maxFuel;
+        }
+        else if (amount !== undefined) {
+            // Add specific amount
+            trait.fuelRemaining = trait.fuelRemaining + amount;
+            // Cap at max if defined
+            if (trait.maxFuel !== undefined && trait.fuelRemaining > trait.maxFuel) {
+                trait.fuelRemaining = trait.maxFuel;
+            }
+        }
+    }
+    /**
+     * Get fuel percentage remaining
+     * @returns 0-100, or undefined if unlimited fuel
+     */
+    static getFuelPercentage(source) {
+        const trait = LightSourceBehavior.require(source, trait_types_1.TraitType.LIGHT_SOURCE);
+        if (trait.fuelRemaining === undefined || trait.maxFuel === undefined) {
+            return undefined;
+        }
+        return Math.round((trait.fuelRemaining / trait.maxFuel) * 100);
+    }
+}
+exports.LightSourceBehavior = LightSourceBehavior;
+//# sourceMappingURL=lightSourceBehavior.js.map

package/dist/traits/light-source/lightSourceBehavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightSourceBehavior.js","sourceRoot":"","sources":["../../../src/traits/light-source/lightSourceBehavior.ts"],"names":[],"mappings":";AAAA,sEAAsE;;;AAEtE,uDAAoD;AAEpD,gDAA2C;AAE3C,yEAAsE;AAEtE;;;;GAIG;AACH,MAAa,mBAAoB,SAAQ,mBAAQ;IAC/C,MAAM,CAAC,cAAc,GAAG,CAAC,uBAAS,CAAC,YAAY,CAAC,CAAC;IAEjD;;;OAGG;IACH,MAAM,CAAC,KAAK,CAAC,MAAgB;QAC3B,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAmB,MAAM,EAAE,uBAAS,CAAC,YAAY,CAAC,CAAC;QAE5F,wBAAwB;QACxB,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,EAAE,CAAC;YAClE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAgB;QAChC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAmB,MAAM,EAAE,uBAAS,CAAC,YAAY,CAAC,CAAC;QAC5F,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IACtB,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,MAAgB;QAC3B,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAmB,MAAM,EAAE,uBAAS,CAAC,YAAY,CAAC,CAAC;QAE5F,kCAAkC;QAClC,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;QAED,gCAAgC;QAChC,IAAI,MAAM,CAAC,QAAQ,CAAC,uBAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1C,OAAO,uCAAkB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACzC,CAAC;QAED,wDAAwD;QACxD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAgB;QACnC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAmB,MAAM,EAAE,uBAAS,CAAC,YAAY,CAAC,CAAC;QAC5F,OAAO,KAAK,CAAC,UAAU,CAAC;IAC1B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAgB;QACtC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAmB,MAAM,EAAE,uBAAS,CAAC,YAAY,CAAC,CAAC;QAC5F,OAAO,KAAK,CAAC,aAAa,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAgB;QAC7B,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAmB,MAAM,EAAE,uBAAS,CAAC,YAAY,CAAC,CAAC;QAC5F,OAAO,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC;IACtE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,MAAgB,EAAE,MAAe;QAClD,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAmB,MAAM,EAAE,uBAAS,CAAC,YAAY,CAAC,CAAC;QAE5F,mBAAmB;QACnB,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,+BAA+B;QAC/B,MAAM,aAAa,GAAG,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC;QAE/D,uBAAuB;QACvB,IAAI,KAAK,CAAC,aAAa,GAAG,aAAa,EAAE,CAAC;YACxC,KAAK,CAAC,aAAa,GAAG,CAAC,CAAC;YACxB,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,mCAAmC;YACxD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,KAAK,CAAC,aAAa,IAAI,aAAa,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,MAAgB,EAAE,MAAe;QAC7C,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAmB,MAAM,EAAE,uBAAS,CAAC,YAAY,CAAC,CAAC;QAE5F,gCAAgC;QAChC,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO;QACT,CAAC;QAED,IAAI,MAAM,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACxD,cAAc;YACd,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC;QACtC,CAAC;aAAM,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,sBAAsB;YACtB,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,GAAG,MAAM,CAAC;YAEnD,wBAAwB;YACxB,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;gBACvE,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC;YACtC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,iBAAiB,CAAC,MAAgB;QACvC,MAAM,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAmB,MAAM,EAAE,uBAAS,CAAC,YAAY,CAAC,CAAC;QAE5F,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACrE,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;IACjE,CAAC;;AA7IH,kDA8IC"}

package/dist/traits/light-source/lightSourceTrait.d.ts

@@ -0,0 +1,28 @@
+import { ITrait } from '../trait';
+/**
+ * LightSource trait allows entities to provide illumination.
+ *
+ * This is a pure data structure - all validation and logic
+ * should be handled by LightSourceBehavior.
+ */
+export declare class LightSourceTrait implements ITrait {
+    static readonly type: "lightSource";
+    readonly type: "lightSource";
+    /** Light output level (1-10) */
+    brightness: number;
+    /**
+     * Whether the light is currently providing illumination.
+     * - true: explicitly lit
+     * - false: explicitly not lit
+     * - undefined: use switchable state or default to lit
+     */
+    isLit?: boolean;
+    /** Optional fuel/battery remaining (undefined = infinite) */
+    fuelRemaining?: number;
+    /** Maximum fuel capacity (for refillable lights) */
+    maxFuel?: number;
+    /** Fuel consumption rate per turn (when lit) */
+    fuelConsumptionRate?: number;
+    constructor(data?: Partial<LightSourceTrait>);
+}
+//# sourceMappingURL=lightSourceTrait.d.ts.map

package/dist/traits/light-source/lightSourceTrait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightSourceTrait.d.ts","sourceRoot":"","sources":["../../../src/traits/light-source/lightSourceTrait.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAA0B;IAC9C,QAAQ,CAAC,IAAI,gBAA0B;IAEvC,gCAAgC;IAChC,UAAU,EAAE,MAAM,CAAK;IAEvB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,gDAAgD;IAChD,mBAAmB,CAAC,EAAE,MAAM,CAAC;gBAEjB,IAAI,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC;CAK7C"}

package/dist/traits/light-source/lightSourceTrait.js

@@ -0,0 +1,37 @@
+"use strict";
+// packages/world-model/src/traits/light-source/lightSourceTrait.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LightSourceTrait = void 0;
+const trait_types_1 = require("../trait-types");
+/**
+ * LightSource trait allows entities to provide illumination.
+ *
+ * This is a pure data structure - all validation and logic
+ * should be handled by LightSourceBehavior.
+ */
+class LightSourceTrait {
+    static type = trait_types_1.TraitType.LIGHT_SOURCE;
+    type = trait_types_1.TraitType.LIGHT_SOURCE;
+    /** Light output level (1-10) */
+    brightness = 5;
+    /**
+     * Whether the light is currently providing illumination.
+     * - true: explicitly lit
+     * - false: explicitly not lit
+     * - undefined: use switchable state or default to lit
+     */
+    isLit;
+    /** Optional fuel/battery remaining (undefined = infinite) */
+    fuelRemaining;
+    /** Maximum fuel capacity (for refillable lights) */
+    maxFuel;
+    /** Fuel consumption rate per turn (when lit) */
+    fuelConsumptionRate;
+    constructor(data) {
+        if (data) {
+            Object.assign(this, data);
+        }
+    }
+}
+exports.LightSourceTrait = LightSourceTrait;
+//# sourceMappingURL=lightSourceTrait.js.map

package/dist/traits/light-source/lightSourceTrait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lightSourceTrait.js","sourceRoot":"","sources":["../../../src/traits/light-source/lightSourceTrait.ts"],"names":[],"mappings":";AAAA,mEAAmE;;;AAGnE,gDAA2C;AAE3C;;;;;GAKG;AACH,MAAa,gBAAgB;IAC3B,MAAM,CAAU,IAAI,GAAG,uBAAS,CAAC,YAAY,CAAC;IACrC,IAAI,GAAG,uBAAS,CAAC,YAAY,CAAC;IAEvC,gCAAgC;IAChC,UAAU,GAAW,CAAC,CAAC;IAEvB;;;;;OAKG;IACH,KAAK,CAAW;IAEhB,6DAA6D;IAC7D,aAAa,CAAU;IAEvB,oDAAoD;IACpD,OAAO,CAAU;IAEjB,gDAAgD;IAChD,mBAAmB,CAAU;IAE7B,YAAY,IAAgC;QAC1C,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;;AA5BH,4CA6BC"}

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

@@ -0,0 +1,3 @@
+export * from './lockableTrait';
+export * from './lockableBehavior';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/traits/lockable/index.ts"],"names":[],"mappings":"AAEA,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC"}

package/dist/traits/lockable/index.js

@@ -0,0 +1,20 @@
+"use strict";
+// packages/world-model/src/traits/lockable/index.ts
+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("./lockableTrait"), exports);
+__exportStar(require("./lockableBehavior"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/traits/lockable/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;;;;;;;;;;;;;;AAEpD,kDAAgC;AAChC,qDAAmC"}

package/dist/traits/lockable/lockableBehavior.d.ts

@@ -0,0 +1,88 @@
+import { Behavior } from '../../behaviors/behavior';
+import { IFEntity } from '../../entities/if-entity';
+import { EntityId } from '@sharpee/core';
+/**
+ * Result of a lock operation
+ */
+export interface ILockResult {
+    success: boolean;
+    alreadyLocked?: boolean;
+    notClosed?: boolean;
+    noKey?: boolean;
+    wrongKey?: boolean;
+    stateChanged?: boolean;
+    lockMessage?: string;
+    lockSound?: string;
+}
+/**
+ * Result of an unlock operation
+ */
+export interface IUnlockResult {
+    success: boolean;
+    alreadyUnlocked?: boolean;
+    noKey?: boolean;
+    wrongKey?: boolean;
+    stateChanged?: boolean;
+    unlockMessage?: string;
+    unlockSound?: string;
+}
+/**
+ * Behavior for lockable entities.
+ *
+ * Handles the logic for locking and unlocking entities.
+ * Requires LOCKABLE trait, OPENABLE is optional.
+ */
+export declare class LockableBehavior extends Behavior {
+    static requiredTraits: "lockable"[];
+    /**
+     * Check if a key can unlock this entity
+     */
+    static canUnlockWith(entity: IFEntity, keyId: EntityId): boolean;
+    /**
+     * Check if a key can lock this entity (usually same as unlock)
+     */
+    static canLockWith(entity: IFEntity, keyId: EntityId): boolean;
+    /**
+     * Check if this entity requires a key to unlock
+     */
+    static requiresKey(entity: IFEntity): boolean;
+    /**
+     * Check if an entity can be locked
+     */
+    static canLock(entity: IFEntity): boolean;
+    /**
+     * Check if an entity can be unlocked
+     */
+    static canUnlock(entity: IFEntity): boolean;
+    /**
+     * Lock the entity
+     * @returns Result describing what happened
+     */
+    static lock(entity: IFEntity, keyEntity?: IFEntity): ILockResult;
+    /**
+     * Unlock the entity with a key
+     * @returns Result describing what happened
+     */
+    static unlock(entity: IFEntity, keyEntity?: IFEntity): IUnlockResult;
+    /**
+     * Force unlock without a key (for admin/debug)
+     */
+    static forceUnlock(entity: IFEntity): void;
+    /**
+     * Check if entity is currently locked
+     */
+    static isLocked(entity: IFEntity): boolean;
+    /**
+     * Handle auto-lock when closing
+     */
+    static handleClose(entity: IFEntity): ILockResult | null;
+    /**
+     * Check if we can open this entity (not locked)
+     */
+    static canOpen(entity: IFEntity): boolean;
+    /**
+     * Get the locked message
+     */
+    static getLockedMessage(entity: IFEntity): string | undefined;
+}
+//# sourceMappingURL=lockableBehavior.d.ts.map

package/dist/traits/lockable/lockableBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lockableBehavior.d.ts","sourceRoot":"","sources":["../../../src/traits/lockable/lockableBehavior.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAIpD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,MAAM,CAAC,cAAc,eAAwB;IAE7C;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO;IAgBhE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO;IAK9D;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAK7C;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAczC;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAK3C;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,QAAQ,GAAG,WAAW;IAsDhE;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,QAAQ,GAAG,aAAa;IA0CpE;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI;IAK1C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAK1C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI;IAUxD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAKzC;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS;CAI9D"}