@sharpee/world-model 0.9.60-beta

package/dist/world/SpatialIndex.d.ts

@@ -0,0 +1,16 @@
+export declare class SpatialIndex {
+    private parentToChildren;
+    private childToParent;
+    addChild(parentId: string, childId: string): void;
+    removeChild(parentId: string, childId: string): void;
+    remove(entityId: string): void;
+    getParent(childId: string): string | undefined;
+    getChildren(parentId: string): string[];
+    hasChildren(parentId: string): boolean;
+    getAllDescendants(parentId: string, maxDepth?: number): string[];
+    getAncestors(childId: string, maxDepth?: number): string[];
+    clear(): void;
+    toJSON(): any;
+    loadJSON(data: any): void;
+}
+//# sourceMappingURL=SpatialIndex.d.ts.map

package/dist/world/SpatialIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpatialIndex.d.ts","sourceRoot":"","sources":["../../src/world/SpatialIndex.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IAEvB,OAAO,CAAC,gBAAgB,CAAuC;IAE/D,OAAO,CAAC,aAAa,CAAkC;IAEvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAejD,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAWpD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAmB9B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE;IAKvC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKtC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,EAAE;IAkBpE,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,EAAE;IAiB9D,KAAK,IAAI,IAAI;IAKb,MAAM,IAAI,GAAG;IAUb,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;CAe1B"}

package/dist/world/SpatialIndex.js

@@ -0,0 +1,117 @@
+"use strict";
+// SpatialIndex.ts - Efficient spatial relationship tracking
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SpatialIndex = void 0;
+class SpatialIndex {
+    // Map from parent ID to set of child IDs
+    parentToChildren = new Map();
+    // Map from child ID to parent ID
+    childToParent = new Map();
+    addChild(parentId, childId) {
+        // Remove from any existing parent (but preserve this entity's children)
+        const currentParent = this.childToParent.get(childId);
+        if (currentParent) {
+            this.removeChild(currentParent, childId);
+        }
+        // Add to new parent
+        if (!this.parentToChildren.has(parentId)) {
+            this.parentToChildren.set(parentId, new Set());
+        }
+        this.parentToChildren.get(parentId).add(childId);
+        this.childToParent.set(childId, parentId);
+    }
+    removeChild(parentId, childId) {
+        const children = this.parentToChildren.get(parentId);
+        if (children) {
+            children.delete(childId);
+            if (children.size === 0) {
+                this.parentToChildren.delete(parentId);
+            }
+        }
+        this.childToParent.delete(childId);
+    }
+    remove(entityId) {
+        // Remove as child from its parent
+        const parent = this.childToParent.get(entityId);
+        if (parent) {
+            this.removeChild(parent, entityId);
+        }
+        // Remove all children relationships (this entity is being deleted)
+        const children = this.parentToChildren.get(entityId);
+        if (children) {
+            // Copy to avoid mutation during iteration
+            const childArray = Array.from(children);
+            childArray.forEach(childId => {
+                this.childToParent.delete(childId);
+            });
+            this.parentToChildren.delete(entityId);
+        }
+    }
+    getParent(childId) {
+        return this.childToParent.get(childId);
+    }
+    getChildren(parentId) {
+        const children = this.parentToChildren.get(parentId);
+        return children ? Array.from(children) : [];
+    }
+    hasChildren(parentId) {
+        const children = this.parentToChildren.get(parentId);
+        return children ? children.size > 0 : false;
+    }
+    getAllDescendants(parentId, maxDepth = 10) {
+        const result = [];
+        const visited = new Set();
+        const traverse = (id, depth) => {
+            if (depth > maxDepth || visited.has(id))
+                return;
+            visited.add(id);
+            const children = this.getChildren(id);
+            result.push(...children);
+            children.forEach(childId => traverse(childId, depth + 1));
+        };
+        traverse(parentId, 0);
+        return result;
+    }
+    getAncestors(childId, maxDepth = 10) {
+        const result = [];
+        let current = childId;
+        let depth = 0;
+        while (depth < maxDepth) {
+            const parent = this.getParent(current);
+            if (!parent)
+                break;
+            result.push(parent);
+            current = parent;
+            depth++;
+        }
+        return result;
+    }
+    clear() {
+        this.parentToChildren.clear();
+        this.childToParent.clear();
+    }
+    toJSON() {
+        return {
+            parentToChildren: Array.from(this.parentToChildren.entries()).map(([parent, children]) => ({
+                parent,
+                children: Array.from(children)
+            })),
+            childToParent: Array.from(this.childToParent.entries())
+        };
+    }
+    loadJSON(data) {
+        this.clear();
+        if (data.parentToChildren) {
+            for (const { parent, children } of data.parentToChildren) {
+                this.parentToChildren.set(parent, new Set(children));
+            }
+        }
+        if (data.childToParent) {
+            for (const [child, parent] of data.childToParent) {
+                this.childToParent.set(child, parent);
+            }
+        }
+    }
+}
+exports.SpatialIndex = SpatialIndex;
+//# sourceMappingURL=SpatialIndex.js.map

package/dist/world/SpatialIndex.js.map

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

package/dist/world/VisibilityBehavior.d.ts

@@ -0,0 +1,83 @@
+import { Behavior } from '../behaviors/behavior';
+import { IFEntity } from '../entities/if-entity';
+import { WorldModel } from './WorldModel';
+/**
+ * Standard capability ID for visibility control.
+ * Entities can claim this capability to control their own visibility.
+ */
+export declare const VISIBILITY_CAPABILITY = "if.scope.visible";
+export declare class VisibilityBehavior extends Behavior {
+    static requiredTraits: never[];
+    /**
+     * Determines if a room is effectively dark (no usable light sources).
+     * This is the single source of truth for darkness checking.
+     *
+     * A room is dark if:
+     * 1. It has RoomTrait with isDark = true
+     * 2. There are no accessible, active light sources
+     *
+     * @param room - The room entity to check
+     * @param world - The world model
+     * @returns true if the room is dark and has no accessible light sources
+     */
+    static isDark(room: IFEntity, world: WorldModel): boolean;
+    /**
+     * Determines if a light source entity is currently providing light.
+     * Checks isLit property first, falls back to switchable state, defaults to lit.
+     *
+     * Priority order:
+     * 1. Explicit isLit property (e.g., lit torch, extinguished candle)
+     * 2. Switchable trait state (e.g., flashlight isOn: true)
+     * 3. Default to lit (e.g., glowing gems, phosphorescent moss)
+     */
+    private static isLightActive;
+    /**
+     * Determines if an observer can see a target entity
+     */
+    static canSee(observer: IFEntity, target: IFEntity, world: WorldModel): boolean;
+    /**
+     * Gets all entities visible to an observer
+     */
+    static getVisible(observer: IFEntity, world: WorldModel): IFEntity[];
+    /**
+     * Recursively adds visible contents of a container/supporter/actor
+     */
+    private static addVisibleContents;
+    /**
+     * Checks if a room has any accessible, active light sources.
+     * Handles nested containers, worn items, and various light source types.
+     */
+    private static hasLightSource;
+    /**
+     * Checks if an entity is accessible from a room (not blocked by closed containers)
+     */
+    private static isAccessible;
+    /**
+     * Checks if there's a line of sight between observer and target
+     */
+    private static hasLineOfSight;
+    /**
+     * Gets the containment path from an entity to its room
+     */
+    private static getContainmentPath;
+    /**
+     * Checks if an entity is visible in its current context
+     * (used for filtering queries)
+     */
+    static isVisible(entity: IFEntity, world: WorldModel): boolean;
+    /**
+     * Gets the location that should be described when an observer looks around.
+     * Accounts for vehicle/container transparency:
+     * - In a transparent vehicle → describe the room
+     * - In an open container → describe the room
+     * - In a closed container → describe the container
+     * - In a room → describe the room
+     *
+     * @returns The entity to describe and optionally the immediate container
+     */
+    static getDescribableLocation(observer: IFEntity, world: WorldModel): {
+        location: IFEntity;
+        immediateContainer: IFEntity | null;
+    };
+}
+//# sourceMappingURL=VisibilityBehavior.d.ts.map

package/dist/world/VisibilityBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VisibilityBehavior.d.ts","sourceRoot":"","sources":["../../src/world/VisibilityBehavior.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAM1C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,MAAM,CAAC,cAAc,UAAM;IAE3B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IAQzD;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IAiB5B;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IAkE/E;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,QAAQ,EAAE;IAgGpE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IA2DjC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAmB7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAsC3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IA2C7B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAsBjC;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO;IA4D9D;;;;;;;;;OASG;IACH,MAAM,CAAC,sBAAsB,CAC3B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,UAAU,GAChB;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,kBAAkB,EAAE,QAAQ,GAAG,IAAI,CAAA;KAAE;CAmD/D"}