@sharpee/event-processor 0.9.60-beta

package/dist/effects/world-query.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * WorldQuery: Read-only view of WorldModel for event handlers
+ *
+ * Per ADR-075, handlers receive a read-only query interface instead of
+ * full world access. This preserves stdlib as the gatekeeper for mutations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorldQuery = createWorldQuery;
+/**
+ * Create a WorldQuery wrapper around a WorldModel
+ *
+ * This provides read-only access to the world model for event handlers.
+ */
+function createWorldQuery(world) {
+    return {
+        getEntity: (id) => world.getEntity(id),
+        hasEntity: (id) => world.hasEntity(id),
+        getPlayer: () => world.getPlayer(),
+        getCurrentRoom: () => {
+            const player = world.getPlayer();
+            return player ? world.getContainingRoom(player.id) : undefined;
+        },
+        getContainingRoom: (entityId) => world.getContainingRoom(entityId),
+        getLocation: (entityId) => world.getLocation(entityId),
+        getContents: (containerId) => world.getContents(containerId),
+        findByTrait: (traitType) => world.findByTrait(traitType),
+        findWhere: (predicate) => world.findWhere(predicate),
+        getStateValue: (key) => world.getStateValue(key),
+        getCapability: (name) => world.getCapability(name),
+        hasCapability: (name) => world.hasCapability(name),
+    };
+}
+//# sourceMappingURL=world-query.js.map

package/dist/effects/world-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-query.js","sourceRoot":"","sources":["../../src/effects/world-query.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AA6EH,4CAkBC;AAvBD;;;;GAIG;AACH,SAAgB,gBAAgB,CAAC,KAAkB;IACjD,OAAO;QACL,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9C,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9C,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE;QAClC,cAAc,EAAE,GAAG,EAAE;YACnB,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,OAAO,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,CAAC;QACD,iBAAiB,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,QAAQ,CAAC;QAC1E,WAAW,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,QAAQ,CAAC;QAC9D,WAAW,EAAE,CAAC,WAAmB,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,WAAW,CAAC;QACpE,WAAW,EAAE,CAAC,SAAoB,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,SAAS,CAAC;QACnE,SAAS,EAAE,CAAC,SAAwC,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC;QACnF,aAAa,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC;QACxD,aAAa,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC;QAC1D,aAAa,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/handler-types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Event handler types for the event system
+ *
+ * ADR-075: Entity handlers receive read-only WorldQuery and return Effect[]
+ */
+import type { ISemanticEvent } from '@sharpee/core';
+import type { WorldQuery } from './effects/world-query';
+import type { Effect } from './effects/types';
+/**
+ * Game event that can be handled by entities or the story
+ */
+export interface IGameEvent extends ISemanticEvent {
+    type: string;
+    data: Record<string, any>;
+}
+/**
+ * Entity event handler function signature (ADR-075)
+ *
+ * Handlers receive:
+ * - event: The game event to handle
+ * - query: Read-only access to world state
+ *
+ * Handlers return Effect[] - intents that EffectProcessor validates and applies
+ */
+export type EntityEventHandler = (event: IGameEvent, query: WorldQuery) => Effect[];
+/**
+ * Legacy handler signature for backward compatibility during migration
+ * These handlers directly mutate world state (old pattern) and return events.
+ * @deprecated Use EntityEventHandler with Effect[] return type
+ */
+export type LegacyEntityEventHandler = (event: IGameEvent, world?: any) => void | ISemanticEvent[];
+/**
+ * Simple event handler that only receives the event (no world access)
+ * Used for story-level daemons and event listeners
+ * @deprecated Use StoryEventHandler instead
+ */
+export type SimpleEventHandler = (event: IGameEvent) => void | ISemanticEvent[];
+/**
+ * Story-level event handler (ADR-075)
+ * Receives read-only WorldQuery and returns Effect[]
+ */
+export type StoryEventHandler = (event: IGameEvent, query: WorldQuery) => Effect[];
+/**
+ * Any event handler type (for migration period)
+ * Supports both ADR-075 Effect-returning handlers and legacy handlers
+ */
+export type AnyEventHandler = EntityEventHandler | LegacyEntityEventHandler;
+/**
+ * Collection of event handlers keyed by event type
+ * ADR-075: Supports multiple handlers per event type
+ * During migration, supports both Effect-returning and legacy handlers
+ */
+export interface IEventHandlers {
+    [eventType: string]: AnyEventHandler | AnyEventHandler[];
+}
+/**
+ * Entity with event handling capability
+ */
+export interface IEventCapableEntity {
+    /**
+     * Event handlers for this entity
+     * Key is the event type (e.g., 'if.event.pushed')
+     * Value is a handler function or array of handlers
+     */
+    on?: IEventHandlers;
+}
+//# sourceMappingURL=handler-types.d.ts.map

package/dist/handler-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler-types.d.ts","sourceRoot":"","sources":["../src/handler-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,cAAc;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,KAAK,MAAM,EAAE,CAAC;AAEpF;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,GAAG,cAAc,EAAE,CAAC;AAEnG;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,cAAc,EAAE,CAAC;AAEhF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,KAAK,MAAM,EAAE,CAAC;AAEnF;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG,wBAAwB,CAAC;AAE5E;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,eAAe,EAAE,CAAC;CAC1D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,EAAE,CAAC,EAAE,cAAc,CAAC;CACrB"}

package/dist/handler-types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Event handler types for the event system
+ *
+ * ADR-075: Entity handlers receive read-only WorldQuery and return Effect[]
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=handler-types.js.map

package/dist/handler-types.js.map

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

package/dist/handlers/complex-manipulation.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Complex manipulation event handlers
+ *
+ * These handlers process events for complex object interactions
+ * like giving, showing, and throwing.
+ */
+import { WorldModel, EventHandler } from '@sharpee/world-model';
+/**
+ * Handle GIVEN event - transfer item to recipient or refuse
+ */
+export declare const handleGiven: EventHandler;
+/**
+ * Handle SHOWN event - make NPC aware of item
+ *
+ * This event doesn't change item ownership but could trigger
+ * NPC reactions or update their knowledge/memory.
+ */
+export declare const handleShown: EventHandler;
+/**
+ * Handle THROWN event - move item and possibly destroy it
+ */
+export declare const handleThrown: EventHandler;
+/**
+ * Handle ITEM_DESTROYED event - remove item from world
+ */
+export declare const handleItemDestroyed: EventHandler;
+/**
+ * Register all complex manipulation handlers
+ */
+export declare function registerComplexManipulationHandlers(world: WorldModel): void;
+//# sourceMappingURL=complex-manipulation.d.ts.map

package/dist/handlers/complex-manipulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complex-manipulation.d.ts","sourceRoot":"","sources":["../../src/handlers/complex-manipulation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAa,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAG3E;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,YAUzB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,EAAE,YAazB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YAgB1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAQjC,CAAC;AAEF;;GAEG;AACH,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAK3E"}

package/dist/handlers/complex-manipulation.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Complex manipulation event handlers
+ *
+ * These handlers process events for complex object interactions
+ * like giving, showing, and throwing.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleItemDestroyed = exports.handleThrown = exports.handleShown = exports.handleGiven = void 0;
+exports.registerComplexManipulationHandlers = registerComplexManipulationHandlers;
+const core_1 = require("@sharpee/core");
+const if_domain_1 = require("@sharpee/if-domain");
+/**
+ * Handle GIVEN event - transfer item to recipient or refuse
+ */
+const handleGiven = (event, world) => {
+    const { actor, target, instrument, location } = event.entities;
+    const data = (0, core_1.getUntypedEventData)(event);
+    const accepted = Boolean(data?.accepted);
+    if (target && location && accepted) {
+        // Transfer the item to the recipient
+        world.moveEntity(target, location);
+    }
+    // If not accepted, item stays with the giver (no action needed)
+};
+exports.handleGiven = handleGiven;
+/**
+ * Handle SHOWN event - make NPC aware of item
+ *
+ * This event doesn't change item ownership but could trigger
+ * NPC reactions or update their knowledge/memory.
+ */
+const handleShown = (event, world) => {
+    const { actor, target, instrument } = event.entities;
+    // target is the item being shown, instrument is the viewer
+    // In a more complex system, this would update the NPC's knowledge
+    // or trigger a reaction. For now, we just record the event happened.
+    // Future implementations could:
+    // - Update an NPC memory/knowledge trait
+    // - Set flags for conversation topics
+    // - Trigger immediate reactions
+    // No world model changes for basic implementation
+};
+exports.handleShown = handleShown;
+/**
+ * Handle THROWN event - move item and possibly destroy it
+ */
+const handleThrown = (event, world) => {
+    const { target, location } = event.entities;
+    const data = (0, core_1.getUntypedEventData)(event);
+    const willBreak = Boolean(data?.willBreak);
+    const finalLocation = typeof data?.finalLocation === 'string' ? data.finalLocation : undefined;
+    if (target) {
+        if (willBreak) {
+            // Item will be destroyed (handled by ITEM_DESTROYED event)
+            // For now, just move it to null location
+            world.removeEntity(target);
+        }
+        else if (finalLocation) {
+            // Move item to its final location
+            world.moveEntity(target, finalLocation);
+        }
+    }
+};
+exports.handleThrown = handleThrown;
+/**
+ * Handle ITEM_DESTROYED event - remove item from world
+ */
+const handleItemDestroyed = (event, world) => {
+    const data = (0, core_1.getUntypedEventData)(event);
+    const itemId = typeof data?.item === 'string' ? data.item : undefined;
+    if (itemId) {
+        // Remove the item from the world
+        world.removeEntity(itemId);
+    }
+};
+exports.handleItemDestroyed = handleItemDestroyed;
+/**
+ * Register all complex manipulation handlers
+ */
+function registerComplexManipulationHandlers(world) {
+    world.registerEventHandler(if_domain_1.IFEvents.GIVEN, exports.handleGiven);
+    world.registerEventHandler(if_domain_1.IFEvents.SHOWN, exports.handleShown);
+    world.registerEventHandler(if_domain_1.IFEvents.THROWN, exports.handleThrown);
+    world.registerEventHandler(if_domain_1.IFEvents.ITEM_DESTROYED, exports.handleItemDestroyed);
+}
+//# sourceMappingURL=complex-manipulation.js.map

package/dist/handlers/complex-manipulation.js.map

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

package/dist/handlers/device/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Device manipulation event handlers
+ *
+ * These handlers process events for device interactions like
+ * pushing, pulling, turning, and using objects.
+ */
+import { WorldModel, EventHandler } from '@sharpee/world-model';
+/**
+ * Handle PUSHED event - process pushing objects/buttons
+ */
+export declare const handlePushed: EventHandler;
+/**
+ * Handle PULLED event - process pulling objects
+ */
+export declare const handlePulled: EventHandler;
+/**
+ * Handle TURNED event - process turning dials/knobs
+ */
+export declare const handleTurned: EventHandler;
+/**
+ * Handle USED event - generic device usage
+ */
+export declare const handleUsed: EventHandler;
+/**
+ * Register all device manipulation handlers
+ */
+export declare function registerDeviceHandlers(world: WorldModel): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/handlers/device/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/handlers/device/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,UAAU,EAAa,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAG3E;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YA0C1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YAmC1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,YA+B1B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,YAmCxB,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAK9D"}

package/dist/handlers/device/index.js

@@ -0,0 +1,172 @@
+"use strict";
+/**
+ * Device manipulation event handlers
+ *
+ * These handlers process events for device interactions like
+ * pushing, pulling, turning, and using objects.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleUsed = exports.handleTurned = exports.handlePulled = exports.handlePushed = void 0;
+exports.registerDeviceHandlers = registerDeviceHandlers;
+const core_1 = require("@sharpee/core");
+const world_model_1 = require("@sharpee/world-model");
+const if_domain_1 = require("@sharpee/if-domain");
+/**
+ * Handle PUSHED event - process pushing objects/buttons
+ */
+const handlePushed = (event, world) => {
+    const { target, location } = event.entities;
+    const data = (0, core_1.getUntypedEventData)(event);
+    const pushType = String(data?.pushType || '');
+    if (!target)
+        return;
+    // Get the actual entity from the world model
+    const targetEntity = world.getEntity(target);
+    if (!targetEntity)
+        return;
+    switch (pushType) {
+        case 'button':
+            // If it's a switchable button, toggle its state
+            if (targetEntity.has(world_model_1.TraitType.SWITCHABLE) && data?.willToggle) {
+                const switchable = targetEntity.get(world_model_1.TraitType.SWITCHABLE);
+                switchable.isOn = data?.newState;
+                // This might trigger other device activations
+                // Future: Add support for linked devices
+            }
+            break;
+        case 'moveable':
+        case 'heavy':
+            // If the object moved in a direction
+            if (data?.moved && data?.moveDirection && location) {
+                // Future: Actually move the object to adjacent location
+                // For now, we just record that it moved
+                // If it reveals a passage
+                if (data?.revealsPassage) {
+                    // Future: Add new exit to room or reveal hidden object
+                    // This would require modifying room exits or revealing concealed items
+                }
+            }
+            break;
+        case 'fixed':
+            // No state changes for fixed objects
+            break;
+    }
+};
+exports.handlePushed = handlePushed;
+/**
+ * Handle PULLED event - process pulling objects
+ */
+const handlePulled = (event, world) => {
+    const { target } = event.entities;
+    const data = (0, core_1.getUntypedEventData)(event);
+    const pullType = String(data?.pullType || '');
+    if (!target)
+        return;
+    // Get the actual entity from the world model
+    const targetEntity = world.getEntity(target);
+    if (!targetEntity)
+        return;
+    switch (pullType) {
+        case 'lever':
+        case 'cord':
+            // Toggle switchable state if applicable
+            if (targetEntity.has(world_model_1.TraitType.SWITCHABLE) && data?.willToggle) {
+                const switchable = targetEntity.get(world_model_1.TraitType.SWITCHABLE);
+                switchable.isOn = data?.newState;
+            }
+            break;
+        case 'attached':
+            // Object is attached to something else
+            if (data?.willDetach) {
+                // Future: Handle detachment logic
+            }
+            break;
+        case 'moveable':
+            // Similar to pushing but in opposite direction
+            if (data?.moved && data?.moveDirection) {
+                // Future: Move object logic
+            }
+            break;
+    }
+};
+exports.handlePulled = handlePulled;
+/**
+ * Handle TURNED event - process turning dials/knobs
+ */
+const handleTurned = (event, world) => {
+    const { target } = event.entities;
+    const data = (0, core_1.getUntypedEventData)(event);
+    const turnType = String(data?.turnType || '');
+    const newSetting = data?.newSetting;
+    if (!target)
+        return;
+    // Get the actual entity from the world model
+    const targetEntity = world.getEntity(target);
+    if (!targetEntity)
+        return;
+    switch (turnType) {
+        case 'dial':
+        case 'knob':
+            // Future: Add a TURNABLE trait with setting property
+            // For now, just handle basic switchable devices
+            if (targetEntity.has(world_model_1.TraitType.SWITCHABLE) && data?.willToggle) {
+                const switchable = targetEntity.get(world_model_1.TraitType.SWITCHABLE);
+                switchable.isOn = data?.newState;
+            }
+            break;
+        case 'wheel':
+        case 'crank':
+            // These might open/close things or activate mechanisms
+            if (data?.activatesMechanism) {
+                // Future: Trigger mechanism activation
+            }
+            break;
+    }
+};
+exports.handleTurned = handleTurned;
+/**
+ * Handle USED event - generic device usage
+ */
+const handleUsed = (event, world) => {
+    const { target } = event.entities;
+    const data = (0, core_1.getUntypedEventData)(event);
+    const useType = String(data?.useType || '');
+    if (!target)
+        return;
+    // Get the actual entity from the world model
+    const targetEntity = world.getEntity(target);
+    if (!targetEntity)
+        return;
+    // Generic use often delegates to more specific actions
+    // or handles custom device behaviors
+    switch (useType) {
+        case 'device':
+            // Activate or deactivate device
+            if (targetEntity.has(world_model_1.TraitType.SWITCHABLE)) {
+                const switchable = targetEntity.get(world_model_1.TraitType.SWITCHABLE);
+                switchable.isOn = !switchable.isOn;
+            }
+            break;
+        case 'tool':
+            // Tools might be used with other objects
+            // This is handled by the action, not the handler
+            break;
+        case 'consumable':
+            // Some items are consumed when used
+            if (data?.consumed) {
+                world.removeEntity(target);
+            }
+            break;
+    }
+};
+exports.handleUsed = handleUsed;
+/**
+ * Register all device manipulation handlers
+ */
+function registerDeviceHandlers(world) {
+    world.registerEventHandler(if_domain_1.IFEvents.PUSHED, exports.handlePushed);
+    world.registerEventHandler(if_domain_1.IFEvents.PULLED, exports.handlePulled);
+    world.registerEventHandler(if_domain_1.IFEvents.TURNED, exports.handleTurned);
+    world.registerEventHandler(if_domain_1.IFEvents.USED, exports.handleUsed);
+}
+//# sourceMappingURL=index.js.map

package/dist/handlers/device/index.js.map

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

package/dist/handlers/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Event handler registration
+ *
+ * Central module for registering all standard IF event handlers
+ */
+export * from './movement';
+export * from './state-change';
+export * from './observation';
+export * from './meta';
+export * from './complex-manipulation';
+export * from './device';
+import { WorldModel } from '@sharpee/world-model';
+/**
+ * Register all standard IF event handlers with the world model
+ */
+export declare function registerStandardHandlers(world: WorldModel): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,QAAQ,CAAC;AACvB,cAAc,wBAAwB,CAAC;AACvC,cAAc,UAAU,CAAC;AAEzB,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AASlD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAQhE"}

package/dist/handlers/index.js

@@ -0,0 +1,48 @@
+"use strict";
+/**
+ * Event handler registration
+ *
+ * Central module for registering all standard IF event handlers
+ */
+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 });
+exports.registerStandardHandlers = registerStandardHandlers;
+__exportStar(require("./movement"), exports);
+__exportStar(require("./state-change"), exports);
+__exportStar(require("./observation"), exports);
+__exportStar(require("./meta"), exports);
+__exportStar(require("./complex-manipulation"), exports);
+__exportStar(require("./device"), exports);
+const movement_1 = require("./movement");
+const state_change_1 = require("./state-change");
+const observation_handlers_1 = require("./observation/observation-handlers");
+const sensory_1 = require("./observation/sensory");
+const meta_1 = require("./meta");
+const complex_manipulation_1 = require("./complex-manipulation");
+const device_1 = require("./device");
+/**
+ * Register all standard IF event handlers with the world model
+ */
+function registerStandardHandlers(world) {
+    (0, movement_1.registerMovementHandlers)(world);
+    (0, state_change_1.registerStateChangeHandlers)(world);
+    (0, observation_handlers_1.registerObservationHandlers)(world);
+    (0, sensory_1.registerSensoryHandlers)(world);
+    (0, meta_1.registerMetaHandlers)(world);
+    (0, complex_manipulation_1.registerComplexManipulationHandlers)(world);
+    (0, device_1.registerDeviceHandlers)(world);
+}
+//# sourceMappingURL=index.js.map

package/dist/handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/handlers/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;AAqBH,4DAQC;AA3BD,6CAA2B;AAC3B,iDAA+B;AAC/B,gDAA8B;AAC9B,yCAAuB;AACvB,yDAAuC;AACvC,2CAAyB;AAGzB,yCAAsD;AACtD,iDAA6D;AAC7D,6EAAiF;AACjF,mDAAgE;AAChE,iCAA8C;AAC9C,iEAA6E;AAC7E,qCAAkD;AAElD;;GAEG;AACH,SAAgB,wBAAwB,CAAC,KAAiB;IACxD,IAAA,mCAAwB,EAAC,KAAK,CAAC,CAAC;IAChC,IAAA,0CAA2B,EAAC,KAAK,CAAC,CAAC;IACnC,IAAA,kDAA2B,EAAC,KAAK,CAAC,CAAC;IACnC,IAAA,iCAAuB,EAAC,KAAK,CAAC,CAAC;IAC/B,IAAA,2BAAoB,EAAC,KAAK,CAAC,CAAC;IAC5B,IAAA,0DAAmC,EAAC,KAAK,CAAC,CAAC;IAC3C,IAAA,+BAAsB,EAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/handlers/meta.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Meta action event handlers
+ *
+ * Handles events for meta-game actions like waiting, scoring, help, etc.
+ */
+import { ISemanticEvent } from '@sharpee/core';
+import { WorldModel } from '@sharpee/world-model';
+/**
+ * Handle waited event
+ *
+ * This event is fired when a player waits/passes time.
+ * Default behavior: Increment turn counter in shared data
+ *
+ * Can be overridden to:
+ * - Trigger time-based events (e.g., NPC movements, timed puzzles)
+ * - Update atmospheric descriptions (e.g., sun setting)
+ * - Advance story-specific timers
+ */
+export declare function handleWaited(event: ISemanticEvent, world: any): void;
+/**
+ * Handle score_displayed event
+ *
+ * This event is fired when a player checks their score.
+ * Default behavior: No world state changes (display only)
+ *
+ * Can be overridden to:
+ * - Track how often player checks score
+ * - Trigger achievements based on score milestones
+ * - Update NPC reactions based on player progress
+ */
+export declare function handleScoreDisplayed(event: ISemanticEvent, world: any): void;
+/**
+ * Handle help_displayed event
+ *
+ * This event is fired when a player requests help.
+ * Default behavior: Mark help as requested in shared data
+ *
+ * Can be overridden to:
+ * - Track which help topics were viewed
+ * - Adjust difficulty based on help usage
+ * - Provide context-sensitive help
+ */
+export declare function handleHelpDisplayed(event: ISemanticEvent, world: any): void;
+/**
+ * Handle about_displayed event
+ *
+ * This event is fired when a player requests game information.
+ * Default behavior: Track that about was viewed
+ *
+ * Can be overridden to:
+ * - Unlock easter eggs for viewing credits
+ * - Track completion statistics
+ */
+export declare function handleAboutDisplayed(event: ISemanticEvent, world: any): void;
+/**
+ * Register all meta action event handlers
+ */
+export declare function registerMetaHandlers(world: WorldModel): void;
+//# sourceMappingURL=meta.d.ts.map

package/dist/handlers/meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/handlers/meta.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAiBpE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAqB5E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAiC3E;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAuB5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAK5D"}