@sharpee/stdlib 0.9.109 → 0.9.111

package/dist/scope/types.d.ts

@@ -1,242 +0,0 @@
-/**
- * Core types for the scope system
- */
-import { IFEntity } from '@sharpee/world-model';
-/**
- * Levels of scope indicating how an entity can be perceived.
- *
- * Ordered from least accessible (UNAWARE=0) to most accessible (CARRIED=4).
- * Higher values imply all lower levels are also satisfied.
- * Use numeric comparisons: if (entityScope >= requiredScope) { ... }
- *
- * For actions that check scope, use ActionContext.requireScope() which
- * returns appropriate error messages for scope failures.
- */
-export declare enum ScopeLevel {
-    /** Entity not known to player at all */
-    UNAWARE = 0,
-    /** Player knows entity exists (can think about, ask about, remember) */
-    AWARE = 1,
-    /** Can see with eyes (examine, look at, read) */
-    VISIBLE = 2,
-    /** Can physically touch/manipulate (take, push, open, touch) */
-    REACHABLE = 3,
-    /** In actor's inventory - always accessible (drop, eat, wear, insert) */
-    CARRIED = 4
-}
-/**
- * @deprecated Use ScopeLevel instead. These string values are for backwards compatibility.
- */
-export declare const ScopeLevelStrings: {
-    readonly CARRIED: "carried";
-    readonly REACHABLE: "reachable";
-    readonly VISIBLE: "visible";
-    readonly AUDIBLE: "audible";
-    readonly DETECTABLE: "detectable";
-    readonly OUT_OF_SCOPE: "out_of_scope";
-};
-/**
- * Types of sensory perception
- */
-export declare enum SenseType {
-    /** Visual perception - blocked by opaque barriers, needs light */
-    SIGHT = "sight",
-    /** Auditory perception - travels through some barriers */
-    HEARING = "hearing",
-    /** Olfactory perception - needs air path */
-    SMELL = "smell",
-    /** Tactile perception - requires physical contact */
-    TOUCH = "touch",
-    /** Supernatural/psychic perception - game-specific */
-    VIBE = "vibe"
-}
-/**
- * Determines what entities are in scope for an actor
- */
-export interface ScopeResolver {
-    /**
-     * Get the highest level of scope for a target entity
-     */
-    getScope(actor: IFEntity, target: IFEntity): ScopeLevel;
-    /**
-     * Check if actor can see the target
-     */
-    canSee(actor: IFEntity, target: IFEntity): boolean;
-    /**
-     * Check if actor can physically reach the target
-     */
-    canReach(actor: IFEntity, target: IFEntity): boolean;
-    /**
-     * Check if actor can hear the target or sounds from it
-     */
-    canHear(actor: IFEntity, target: IFEntity): boolean;
-    /**
-     * Check if actor can smell the target
-     */
-    canSmell(actor: IFEntity, target: IFEntity): boolean;
-    /**
-     * Get all entities visible to the actor
-     */
-    getVisible(actor: IFEntity): IFEntity[];
-    /**
-     * Get all entities reachable by the actor
-     */
-    getReachable(actor: IFEntity): IFEntity[];
-    /**
-     * Get all entities the actor can hear
-     */
-    getAudible(actor: IFEntity): IFEntity[];
-}
-/**
- * Tracks what actors know about based on what they've witnessed
- */
-export interface WitnessSystem {
-    /**
-     * Record who can witness a state change
-     */
-    recordWitnesses(change: StateChange): WitnessRecord;
-    /**
-     * Update actor knowledge based on what was witnessed
-     */
-    updateKnowledge(record: WitnessRecord): void;
-    /**
-     * Get what an actor knows about
-     */
-    getKnownEntities(actorId: string): EntityKnowledge[];
-    /**
-     * Check if an actor has discovered an entity
-     */
-    hasDiscovered(actorId: string, entityId: string): boolean;
-    /**
-     * Get what an actor knows about a specific entity
-     */
-    getKnowledge(actorId: string, entityId: string): EntityKnowledge | undefined;
-}
-/**
- * Represents a change in world state that can be witnessed
- */
-export interface StateChange {
-    type: 'move' | 'create' | 'destroy' | 'modify' | 'action';
-    entityId: string;
-    actorId?: string;
-    timestamp: number;
-    from?: string;
-    to?: string;
-    property?: string;
-    oldValue?: any;
-    newValue?: any;
-    action?: string;
-    target?: string;
-}
-/**
- * Record of who witnessed what and how
- */
-export interface WitnessRecord {
-    change: StateChange;
-    witnesses: Map<string, WitnessDetail>;
-}
-/**
- * Details about how an actor witnessed something
- */
-export interface WitnessDetail {
-    actorId: string;
-    sense: SenseType;
-    level: WitnessLevel;
-    confidence: 'certain' | 'likely' | 'unsure';
-}
-/**
- * Level of detail in witnessing
- */
-export declare enum WitnessLevel {
-    /** Saw/heard/sensed everything clearly */
-    FULL = "full",
-    /** Saw/heard/sensed some but not all details */
-    PARTIAL = "partial",
-    /** Caught a glimpse or hint */
-    PERIPHERAL = "peripheral",
-    /** Deduced from evidence rather than direct perception */
-    INFERRED = "inferred"
-}
-/**
- * What an actor knows about an entity
- */
-export interface EntityKnowledge {
-    entityId: string;
-    exists: boolean;
-    lastSeen?: number;
-    lastKnownLocation?: string;
-    visualProperties?: Map<string, any>;
-    lastHeard?: number;
-    heardFrom?: string;
-    lastSmelled?: number;
-    scentStrength?: 'faint' | 'moderate' | 'strong';
-    discoveredAt: number;
-    discoveredBy: SenseType;
-    movementHistory?: MovementRecord[];
-}
-/**
- * Record of witnessed movement
- */
-export interface MovementRecord {
-    from: string;
-    to: string;
-    witnessedAt: number;
-    witnessedBy: SenseType;
-    confidence: 'certain' | 'likely' | 'unsure';
-}
-/**
- * Witness event types - all data, no narrative text
- */
-export interface WitnessActionEvent {
-    type: 'if.witness.action';
-    data: {
-        witnessId: string;
-        sense: SenseType;
-        level: WitnessLevel;
-        action: string;
-        actorId: string;
-        targetId?: string;
-        fromLocation?: string;
-        toLocation?: string;
-        timestamp: number;
-    };
-}
-export interface WitnessMovementEvent {
-    type: 'if.witness.movement';
-    data: {
-        witnessId: string;
-        sense: SenseType;
-        level: WitnessLevel;
-        entityId: string | 'unknown';
-        fromLocation: string;
-        toLocation: string;
-        direction?: string;
-        timestamp: number;
-    };
-}
-export interface WitnessSoundEvent {
-    type: 'if.witness.sound';
-    data: {
-        witnessId: string;
-        sense: SenseType;
-        soundType: string;
-        intensity: 'faint' | 'moderate' | 'loud';
-        fromDirection?: string;
-        estimatedLocation?: string;
-        timestamp: number;
-    };
-}
-export interface WitnessScentEvent {
-    type: 'if.witness.scent';
-    data: {
-        witnessId: string;
-        sense: SenseType;
-        scentType: string;
-        intensity: 'faint' | 'moderate' | 'strong';
-        fromDirection?: string;
-        characteristics?: string[];
-        timestamp: number;
-    };
-}
-export type WitnessEvent = WitnessActionEvent | WitnessMovementEvent | WitnessSoundEvent | WitnessScentEvent;
-//# sourceMappingURL=types.d.ts.map

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

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

package/dist/scope/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/scope/types.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAIH;;;;;;;;;GASG;AACH,IAAY,UAeX;AAfD,WAAY,UAAU;IACpB,wCAAwC;IACxC,iDAAW,CAAA;IAEX,wEAAwE;IACxE,6CAAS,CAAA;IAET,iDAAiD;IACjD,iDAAW,CAAA;IAEX,gEAAgE;IAChE,qDAAa,CAAA;IAEb,yEAAyE;IACzE,iDAAW,CAAA;AACb,CAAC,EAfW,UAAU,0BAAV,UAAU,QAerB;AAED;;GAEG;AACU,QAAA,iBAAiB,GAAG;IAC/B,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;IACtB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;CACpB,CAAC;AAEX;;GAEG;AACH,IAAY,SAeX;AAfD,WAAY,SAAS;IACnB,kEAAkE;IAClE,4BAAe,CAAA;IAEf,0DAA0D;IAC1D,gCAAmB,CAAA;IAEnB,4CAA4C;IAC5C,4BAAe,CAAA;IAEf,qDAAqD;IACrD,4BAAe,CAAA;IAEf,sDAAsD;IACtD,0BAAa,CAAA;AACf,CAAC,EAfW,SAAS,yBAAT,SAAS,QAepB;AAsHD;;GAEG;AACH,IAAY,YAYX;AAZD,WAAY,YAAY;IACtB,0CAA0C;IAC1C,6BAAa,CAAA;IAEb,gDAAgD;IAChD,mCAAmB,CAAA;IAEnB,+BAA+B;IAC/B,yCAAyB,CAAA;IAEzB,0DAA0D;IAC1D,qCAAqB,CAAA;AACvB,CAAC,EAZW,YAAY,4BAAZ,YAAY,QAYvB"}

package/dist/scope/witness-system.d.ts

@@ -1,83 +0,0 @@
-/**
- * Witness system implementation
- *
- * Tracks what actors know about based on what they've witnessed.
- * Works with the scope system to determine who can perceive changes
- * and updates their knowledge accordingly.
- */
-import { WorldModel } from '@sharpee/world-model';
-import { WitnessSystem, StateChange, WitnessRecord, EntityKnowledge, ScopeResolver } from './types';
-/**
- * Standard implementation of the witness system
- */
-export declare class StandardWitnessSystem implements WitnessSystem {
-    private world;
-    private scopeResolver;
-    private knowledge;
-    constructor(world: WorldModel, scopeResolver: ScopeResolver);
-    /**
-     * Record who can witness a state change
-     */
-    recordWitnesses(change: StateChange): WitnessRecord;
-    /**
-     * Update actor knowledge based on what was witnessed
-     */
-    updateKnowledge(record: WitnessRecord): void;
-    /**
-     * Get what an actor knows about
-     */
-    getKnownEntities(actorId: string): EntityKnowledge[];
-    /**
-     * Check if an actor has discovered an entity
-     */
-    hasDiscovered(actorId: string, entityId: string): boolean;
-    /**
-     * Get what an actor knows about a specific entity
-     */
-    getKnowledge(actorId: string, entityId: string): EntityKnowledge | undefined;
-    /**
-     * Determine if and how an actor can witness a change
-     */
-    private canWitnessChange;
-    /**
-     * Determine the level of detail in witnessing
-     */
-    private determineWitnessLevel;
-    /**
-     * Update knowledge from witnessed movement
-     */
-    private updateMovementKnowledge;
-    /**
-     * Update knowledge from witnessed creation/discovery
-     */
-    private updateDiscoveryKnowledge;
-    /**
-     * Update knowledge from witnessed destruction
-     */
-    private updateDestructionKnowledge;
-    /**
-     * Update knowledge from witnessed modification
-     */
-    private updateModificationKnowledge;
-    /**
-     * Update knowledge from witnessed action
-     */
-    private updateActionKnowledge;
-    /**
-     * Create initial knowledge entry for an entity
-     */
-    private createInitialKnowledge;
-    /**
-     * Update sense-specific timestamps
-     */
-    private updateSenseTimestamps;
-    /**
-     * Emit appropriate witness event based on change type
-     */
-    private emitWitnessEvent;
-    /**
-     * Calculate direction of movement
-     */
-    private getDirection;
-}
-//# sourceMappingURL=witness-system.d.ts.map

package/dist/scope/witness-system.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"witness-system.d.ts","sourceRoot":"","sources":["../../src/scope/witness-system.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAY,UAAU,EAAa,MAAM,sBAAsB,CAAC;AAEvE,OAAO,EACL,aAAa,EACb,WAAW,EACX,aAAa,EAGb,eAAe,EAIf,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IAIvD,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,aAAa;IAJvB,OAAO,CAAC,SAAS,CAAwD;gBAG/D,KAAK,EAAE,UAAU,EACjB,aAAa,EAAE,aAAa;IAGtC;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa;IAwBnD;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAgC5C;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE;IAOpD;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO;IAQzD;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAO5E;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmCxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAuC/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAYhC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAoBnC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAS9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAqDxB;;OAEG;IACH,OAAO,CAAC,YAAY;CAKrB"}

package/dist/scope/witness-system.js

@@ -1,346 +0,0 @@
-"use strict";
-/**
- * Witness system implementation
- *
- * Tracks what actors know about based on what they've witnessed.
- * Works with the scope system to determine who can perceive changes
- * and updates their knowledge accordingly.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StandardWitnessSystem = void 0;
-const world_model_1 = require("@sharpee/world-model");
-const core_1 = require("@sharpee/core");
-const types_1 = require("./types");
-/**
- * Standard implementation of the witness system
- */
-class StandardWitnessSystem {
-    world;
-    scopeResolver;
-    knowledge = new Map();
-    constructor(world, scopeResolver) {
-        this.world = world;
-        this.scopeResolver = scopeResolver;
-    }
-    /**
-     * Record who can witness a state change
-     */
-    recordWitnesses(change) {
-        const witnesses = new Map();
-        // Get all potential witnesses (actors)
-        const actors = this.world.getAllEntities().filter(e => e.has(world_model_1.TraitType.ACTOR) && e.id !== change.actorId);
-        // Determine who can perceive this change
-        for (const actor of actors) {
-            const detail = this.canWitnessChange(actor, change);
-            if (detail) {
-                witnesses.set(actor.id, detail);
-            }
-        }
-        const record = { change, witnesses };
-        // Update knowledge based on what was witnessed
-        this.updateKnowledge(record);
-        return record;
-    }
-    /**
-     * Update actor knowledge based on what was witnessed
-     */
-    updateKnowledge(record) {
-        for (const [actorId, detail] of record.witnesses) {
-            // Get or create actor's knowledge map
-            if (!this.knowledge.has(actorId)) {
-                this.knowledge.set(actorId, new Map());
-            }
-            const actorKnowledge = this.knowledge.get(actorId);
-            // Update knowledge based on change type
-            switch (record.change.type) {
-                case 'move':
-                    this.updateMovementKnowledge(actorId, record.change, detail);
-                    break;
-                case 'create':
-                    this.updateDiscoveryKnowledge(actorId, record.change, detail);
-                    break;
-                case 'destroy':
-                    this.updateDestructionKnowledge(actorId, record.change, detail);
-                    break;
-                case 'modify':
-                    this.updateModificationKnowledge(actorId, record.change, detail);
-                    break;
-                case 'action':
-                    this.updateActionKnowledge(actorId, record.change, detail);
-                    break;
-            }
-            // Emit witness events
-            this.emitWitnessEvent(actorId, record.change, detail);
-        }
-    }
-    /**
-     * Get what an actor knows about
-     */
-    getKnownEntities(actorId) {
-        const actorKnowledge = this.knowledge.get(actorId);
-        if (!actorKnowledge)
-            return [];
-        return Array.from(actorKnowledge.values());
-    }
-    /**
-     * Check if an actor has discovered an entity
-     */
-    hasDiscovered(actorId, entityId) {
-        const actorKnowledge = this.knowledge.get(actorId);
-        if (!actorKnowledge)
-            return false;
-        const knowledge = actorKnowledge.get(entityId);
-        return knowledge?.exists === true;
-    }
-    /**
-     * Get what an actor knows about a specific entity
-     */
-    getKnowledge(actorId, entityId) {
-        const actorKnowledge = this.knowledge.get(actorId);
-        if (!actorKnowledge)
-            return undefined;
-        return actorKnowledge.get(entityId);
-    }
-    /**
-     * Determine if and how an actor can witness a change
-     */
-    canWitnessChange(actor, change) {
-        const entity = this.world.getEntity(change.entityId);
-        if (!entity)
-            return null;
-        // Check each sense type
-        if (this.scopeResolver.canSee(actor, entity)) {
-            return {
-                actorId: actor.id,
-                sense: types_1.SenseType.SIGHT,
-                level: this.determineWitnessLevel(actor, entity, types_1.SenseType.SIGHT),
-                confidence: 'certain'
-            };
-        }
-        if (this.scopeResolver.canHear(actor, entity)) {
-            return {
-                actorId: actor.id,
-                sense: types_1.SenseType.HEARING,
-                level: this.determineWitnessLevel(actor, entity, types_1.SenseType.HEARING),
-                confidence: 'likely'
-            };
-        }
-        if (this.scopeResolver.canSmell(actor, entity)) {
-            return {
-                actorId: actor.id,
-                sense: types_1.SenseType.SMELL,
-                level: this.determineWitnessLevel(actor, entity, types_1.SenseType.SMELL),
-                confidence: 'unsure'
-            };
-        }
-        return null;
-    }
-    /**
-     * Determine the level of detail in witnessing
-     */
-    determineWitnessLevel(actor, target, sense) {
-        // For sight, check if we can reach (close) or just see (far)
-        if (sense === types_1.SenseType.SIGHT) {
-            if (this.scopeResolver.canReach(actor, target)) {
-                return types_1.WitnessLevel.FULL;
-            }
-            return types_1.WitnessLevel.PARTIAL;
-        }
-        // For other senses, default to partial
-        // TODO: Implement distance-based witness levels
-        return types_1.WitnessLevel.PARTIAL;
-    }
-    /**
-     * Update knowledge from witnessed movement
-     */
-    updateMovementKnowledge(actorId, change, detail) {
-        const actorKnowledge = this.knowledge.get(actorId);
-        // Get or create entity knowledge
-        let knowledge = actorKnowledge.get(change.entityId);
-        if (!knowledge) {
-            knowledge = this.createInitialKnowledge(change.entityId, detail);
-            actorKnowledge.set(change.entityId, knowledge);
-        }
-        // Update location and movement history
-        if (change.to) {
-            knowledge.lastKnownLocation = change.to;
-        }
-        // Add to movement history
-        if (change.from && change.to) {
-            if (!knowledge.movementHistory) {
-                knowledge.movementHistory = [];
-            }
-            knowledge.movementHistory.push({
-                from: change.from,
-                to: change.to,
-                witnessedAt: change.timestamp,
-                witnessedBy: detail.sense,
-                confidence: detail.confidence
-            });
-            // Limit history size
-            if (knowledge.movementHistory.length > 10) {
-                knowledge.movementHistory.shift();
-            }
-        }
-        // Update sense-specific timestamps
-        this.updateSenseTimestamps(knowledge, detail, change.timestamp);
-    }
-    /**
-     * Update knowledge from witnessed creation/discovery
-     */
-    updateDiscoveryKnowledge(actorId, change, detail) {
-        const actorKnowledge = this.knowledge.get(actorId);
-        // Create new knowledge entry
-        const knowledge = this.createInitialKnowledge(change.entityId, detail);
-        knowledge.exists = true;
-        knowledge.discoveredAt = change.timestamp;
-        knowledge.discoveredBy = detail.sense;
-        actorKnowledge.set(change.entityId, knowledge);
-    }
-    /**
-     * Update knowledge from witnessed destruction
-     */
-    updateDestructionKnowledge(actorId, change, detail) {
-        const actorKnowledge = this.knowledge.get(actorId);
-        const knowledge = actorKnowledge.get(change.entityId);
-        if (knowledge) {
-            knowledge.exists = false;
-            this.updateSenseTimestamps(knowledge, detail, change.timestamp);
-        }
-    }
-    /**
-     * Update knowledge from witnessed modification
-     */
-    updateModificationKnowledge(actorId, change, detail) {
-        const actorKnowledge = this.knowledge.get(actorId);
-        let knowledge = actorKnowledge.get(change.entityId);
-        if (!knowledge) {
-            knowledge = this.createInitialKnowledge(change.entityId, detail);
-            actorKnowledge.set(change.entityId, knowledge);
-        }
-        // Update visual properties if witnessed by sight
-        if (detail.sense === types_1.SenseType.SIGHT && change.property) {
-            if (!knowledge.visualProperties) {
-                knowledge.visualProperties = new Map();
-            }
-            knowledge.visualProperties.set(change.property, change.newValue);
-        }
-        this.updateSenseTimestamps(knowledge, detail, change.timestamp);
-    }
-    /**
-     * Update knowledge from witnessed action
-     */
-    updateActionKnowledge(actorId, change, detail) {
-        // Actions mainly update knowledge about the entities involved
-        // The actual action witnessing is handled by event emission
-        const actorKnowledge = this.knowledge.get(actorId);
-        // Ensure we know about the actor performing the action
-        if (change.actorId && change.actorId !== actorId) {
-            let actorEntityKnowledge = actorKnowledge.get(change.actorId);
-            if (!actorEntityKnowledge) {
-                actorEntityKnowledge = this.createInitialKnowledge(change.actorId, detail);
-                actorKnowledge.set(change.actorId, actorEntityKnowledge);
-            }
-            this.updateSenseTimestamps(actorEntityKnowledge, detail, change.timestamp);
-        }
-        // Ensure we know about the target
-        if (change.target) {
-            let targetKnowledge = actorKnowledge.get(change.target);
-            if (!targetKnowledge) {
-                targetKnowledge = this.createInitialKnowledge(change.target, detail);
-                actorKnowledge.set(change.target, targetKnowledge);
-            }
-            this.updateSenseTimestamps(targetKnowledge, detail, change.timestamp);
-        }
-    }
-    /**
-     * Create initial knowledge entry for an entity
-     */
-    createInitialKnowledge(entityId, detail) {
-        return {
-            entityId,
-            exists: true,
-            discoveredAt: Date.now(),
-            discoveredBy: detail.sense
-        };
-    }
-    /**
-     * Update sense-specific timestamps
-     */
-    updateSenseTimestamps(knowledge, detail, timestamp) {
-        switch (detail.sense) {
-            case types_1.SenseType.SIGHT:
-                knowledge.lastSeen = timestamp;
-                break;
-            case types_1.SenseType.HEARING:
-                knowledge.lastHeard = timestamp;
-                break;
-            case types_1.SenseType.SMELL:
-                knowledge.lastSmelled = timestamp;
-                knowledge.scentStrength = 'moderate'; // TODO: Calculate based on distance
-                break;
-        }
-    }
-    /**
-     * Emit appropriate witness event based on change type
-     */
-    emitWitnessEvent(actorId, change, detail) {
-        const actor = this.world.getEntity(actorId);
-        if (!actor)
-            return;
-        let event = null;
-        switch (change.type) {
-            case 'action':
-                event = {
-                    type: 'if.witness.action',
-                    data: {
-                        witnessId: actorId,
-                        sense: detail.sense,
-                        level: detail.level,
-                        action: change.action || '',
-                        actorId: change.actorId || '',
-                        targetId: change.target,
-                        fromLocation: change.from,
-                        toLocation: change.to,
-                        timestamp: change.timestamp
-                    }
-                };
-                break;
-            case 'move':
-                event = {
-                    type: 'if.witness.movement',
-                    data: {
-                        witnessId: actorId,
-                        sense: detail.sense,
-                        level: detail.level,
-                        entityId: detail.level === types_1.WitnessLevel.FULL ? change.entityId : 'unknown',
-                        fromLocation: change.from || '',
-                        toLocation: change.to || '',
-                        direction: this.getDirection(change.from, change.to),
-                        timestamp: change.timestamp
-                    }
-                };
-                break;
-            // TODO: Add sound and scent events for appropriate changes
-        }
-        if (event) {
-            // Get entities involved in the event
-            const entityObj = { actor: actor.id };
-            if (change.entityId)
-                entityObj.target = change.entityId;
-            if (change.target)
-                entityObj.target = change.target;
-            (0, core_1.createEvent)(event.type, event.data, entityObj);
-        }
-    }
-    /**
-     * Calculate direction of movement
-     */
-    getDirection(from, to) {
-        // TODO: Implement proper direction calculation based on room connections
-        // For now, return undefined
-        return undefined;
-    }
-}
-exports.StandardWitnessSystem = StandardWitnessSystem;
-//# sourceMappingURL=witness-system.js.map