@sharpee/if-domain 0.9.60-beta

package/README.md

@@ -0,0 +1,71 @@
+# @sharpee/if-domain
+
+Core domain model and contracts for the Sharpee Interactive Fiction Platform.
+
+## Overview
+
+This package contains the shared domain types, events, and contracts that define the Interactive Fiction domain model. It serves as the single source of truth for domain concepts used across the Sharpee platform.
+
+## Contents
+
+### Events (`events.ts`)
+- `IFEvents` - Standard interactive fiction event constants
+- `IFEventType` - Type-safe event type
+- `IFEventCategory` - Event categorization for filtering and handling
+
+### Contracts (`contracts.ts`)
+- `EventHandler` - Function type for handling events
+- `EventValidator` - Function type for validating events
+- `EventPreviewer` - Function type for previewing event effects
+- `WorldChange` - Interface for world state changes
+- `ProcessedEvents` - Result of event processing
+- `ProcessorOptions` - Event processing configuration
+
+### Changes (`changes.ts`)
+- `WorldChangeType` - Types of world state changes
+- `ContentsOptions` - Options for querying entity contents
+- `FindOptions` - Options for finding entities
+- `WorldConfig` - World behavior configuration
+- `WorldState` - World state storage interface
+
+### Sequencing (`sequencing.ts`)
+- `TurnPhase` - Phases of turn execution
+- `EventSequence` - Sequencing information for events
+- `SequencedEvent` - Event with sequence information
+- `EventSequencer` - Interface for event sequencing
+
+## Usage
+
+```typescript
+import { IFEvents, EventHandler, WorldChange } from '@sharpee/if-domain';
+
+// Use event constants
+const moveEvent = {
+  type: IFEvents.ACTOR_MOVED,
+  // ...
+};
+
+// Implement event handlers
+const handleMove: EventHandler = (event, world) => {
+  // Handle the event
+};
+```
+
+## Design Principles
+
+1. **Domain-Driven Design**: All types represent domain concepts, not technical implementations
+2. **Single Source of Truth**: Event constants and core types defined once
+3. **No Implementation**: Pure type definitions with no runtime code (except constants)
+4. **Minimal Dependencies**: Only depends on @sharpee/core for base types
+
+## Dependencies
+
+- `@sharpee/core` - Core semantic event types
+
+## Build Order
+
+This package must be built after `core` but before:
+- `world-model`
+- `event-processor`
+- `engine`
+- `stdlib`

package/dist/changes.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Domain types for world state changes
+ */
+/**
+ * Types of changes that can occur in the world
+ */
+export type WorldChangeType = 'move' | 'create' | 'delete' | 'modify' | 'relate' | 'unrelate';
+//# sourceMappingURL=changes.d.ts.map

package/dist/changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../src/changes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC"}

package/dist/changes.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Domain types for world state changes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=changes.js.map

package/dist/changes.js.map

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

package/dist/contracts.d.ts

@@ -0,0 +1,270 @@
+/**
+ * Domain contracts for world state changes and event processing
+ */
+import { ISemanticEvent, IEntity } from '@sharpee/core';
+/**
+ * Represents a change to the world state
+ */
+export interface WorldChange {
+    type: 'move' | 'create' | 'delete' | 'modify' | 'relate' | 'unrelate';
+    entityId: string;
+    field?: string;
+    oldValue?: unknown;
+    newValue?: unknown;
+    details?: Record<string, unknown>;
+}
+/**
+ * Configuration for world model behavior
+ */
+export interface WorldConfig {
+    enableSpatialIndex?: boolean;
+    maxDepth?: number;
+    strictMode?: boolean;
+}
+/**
+ * World state storage
+ */
+export interface WorldState {
+    [key: string]: any;
+}
+/**
+ * Options for finding entities
+ */
+export interface FindOptions {
+    includeScenery?: boolean;
+    includeInvisible?: boolean;
+    maxDepth?: number;
+}
+/**
+ * Options for getting contents
+ */
+export interface ContentsOptions {
+    recursive?: boolean;
+    includeWorn?: boolean;
+    visibleOnly?: boolean;
+}
+/**
+ * Result of processing events
+ */
+export interface ProcessedEvents {
+    /**
+     * Events that were successfully applied
+     */
+    applied: ISemanticEvent[];
+    /**
+     * Events that failed validation
+     */
+    failed: Array<{
+        event: ISemanticEvent;
+        reason: string;
+    }>;
+    /**
+     * World changes that occurred
+     */
+    changes: WorldChange[];
+    /**
+     * Events generated as reactions to the processed events
+     */
+    reactions: ISemanticEvent[];
+}
+/**
+ * Options for event processing
+ */
+export interface ProcessorOptions {
+    /**
+     * Whether to validate events before applying them
+     */
+    validate?: boolean;
+    /**
+     * Whether to preview changes before applying
+     */
+    preview?: boolean;
+    /**
+     * Maximum depth for reaction processing
+     */
+    maxReactionDepth?: number;
+}
+/**
+ * Simple command input for actions
+ *
+ * This is what actions receive - no parser internals, just the essentials.
+ * The rich parsing data stays in world-model where it belongs.
+ */
+export interface CommandInput {
+    /** The action being executed */
+    actionId: string;
+    /** Direct object if present */
+    directObject?: EntityReference;
+    /** Indirect object if present */
+    indirectObject?: EntityReference;
+    /** Preposition used (if any) - raw text for backward compatibility */
+    preposition?: string;
+    /** Semantic properties derived from grammar */
+    semantics?: CommandSemantics;
+    /** Original input text for reference */
+    inputText: string;
+}
+/**
+ * Semantic properties derived from grammar rules
+ *
+ * These replace the need for actions to inspect verb.text, preposition variations,
+ * or modify parsed commands. The grammar rules provide normalized semantic meaning.
+ */
+export interface CommandSemantics {
+    /** How the action should be performed */
+    manner?: 'normal' | 'careful' | 'careless' | 'forceful' | 'stealthy' | 'quick';
+    /** Spatial relationship (normalized from preposition variations) */
+    spatialRelation?: 'in' | 'on' | 'under' | 'behind' | 'beside' | 'above' | 'below';
+    /** Movement direction (normalized from direction variations) */
+    direction?: 'north' | 'south' | 'east' | 'west' | 'up' | 'down' | 'northeast' | 'northwest' | 'southeast' | 'southwest' | 'in' | 'out';
+    /** Whether a preposition was implicit in the grammar */
+    implicitPreposition?: boolean;
+    /** Whether a direction was implicit */
+    implicitDirection?: boolean;
+    /** Action-specific semantics */
+    custom?: Record<string, any>;
+}
+/**
+ * Reference to an entity in a command
+ */
+export interface EntityReference {
+    /** The resolved entity */
+    entity: IEntity;
+    /** The text that matched this entity */
+    matchedText: string;
+    /** How the entity was referenced */
+    referenceType?: 'name' | 'pronoun' | 'definite' | 'indefinite';
+}
+/**
+ * Validation result from an action
+ */
+export interface ValidationResult {
+    /** Whether the action can proceed */
+    valid: boolean;
+    /** Error code if validation failed */
+    error?: string;
+    /** Parameters for error message formatting */
+    params?: Record<string, any>;
+}
+/**
+ * Context provided to actions
+ *
+ * This is the contract for what actions can access.
+ * No world-model internals, no parser details.
+ */
+export interface IActionContext {
+    /** The player entity */
+    readonly player: IEntity;
+    /** The player's current location */
+    readonly currentLocation: IEntity;
+    /** The command being executed */
+    readonly command: CommandInput;
+    /** The action being executed */
+    readonly action: IAction;
+    /**
+     * Check if an entity is visible to the player
+     */
+    canSee(entity: IEntity): boolean;
+    /**
+     * Check if an entity is reachable by the player
+     */
+    canReach(entity: IEntity): boolean;
+    /**
+     * Check if an entity can be taken by the player
+     */
+    canTake(entity: IEntity): boolean;
+    /**
+     * Check if an entity is in scope for the player
+     */
+    isInScope(entity: IEntity): boolean;
+    /**
+     * Get all visible entities
+     */
+    getVisible(): IEntity[];
+    /**
+     * Get all entities in scope
+     */
+    getInScope(): IEntity[];
+    /**
+     * Get an entity by ID
+     */
+    getEntity(entityId: string): IEntity | undefined;
+    /**
+     * Get an entity's location
+     */
+    getEntityLocation(entityId: string): string | undefined;
+    /**
+     * Get entities contained within an entity
+     */
+    getEntityContents(entityId: string): IEntity[];
+    /**
+     * Get the room containing an entity
+     */
+    getContainingRoom(entityId: string): IEntity | undefined;
+    /**
+     * Get a world capability (scoring, etc.)
+     */
+    getWorldCapability(name: string): any;
+    /**
+     * Move an entity to a new location
+     */
+    moveEntity(entityId: string, newLocationId: string): boolean;
+    /**
+     * Create an event
+     */
+    event(type: string, data: any): ISemanticEvent;
+}
+/**
+ * Action contract
+ *
+ * Actions implement game verbs. They validate and execute commands.
+ */
+export interface IAction {
+    /** Unique identifier */
+    id: string;
+    /** Validate if the action can be executed */
+    validate(context: IActionContext): ValidationResult;
+    /** Execute the action and return events */
+    execute(context: IActionContext): ISemanticEvent[];
+    /** Required message IDs for this action */
+    requiredMessages?: string[];
+    /** Optional description for help/documentation */
+    descriptionMessageId?: string;
+    /** Optional examples for help/documentation */
+    examplesMessageId?: string;
+}
+/**
+ * Action registry contract
+ */
+export interface IActionRegistry {
+    /** Register an action */
+    register(action: IAction): void;
+    /** Get an action by ID */
+    get(actionId: string): IAction | undefined;
+    /** Get all registered actions */
+    getAll(): IAction[];
+    /** Check if an action exists */
+    has(actionId: string): boolean;
+}
+/**
+ * Scope levels for entity visibility and accessibility
+ */
+export type ScopeLevel = 'carried' | 'reachable' | 'visible' | 'audible' | 'detectable' | 'out_of_scope';
+/**
+ * Basic scope resolver interface for actions
+ */
+export interface IScopeResolver {
+    /**
+     * Get the highest level of scope for a target entity
+     */
+    getScope(actor: IEntity, target: IEntity): ScopeLevel;
+    /**
+     * Check if actor can see the target
+     */
+    canSee(actor: IEntity, target: IEntity): boolean;
+    /**
+     * Check if actor can physically reach the target
+     */
+    canReach(actor: IEntity, target: IEntity): boolean;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

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

package/dist/contracts.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Domain contracts for world state changes and event processing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,124 @@
+/**
+ * Standard Interactive Fiction events.
+ *
+ * These are the core events that can occur in the IF world model.
+ * Extensions can add their own events using namespaced identifiers.
+ */
+export declare const IFEvents: {
+    readonly TAKEN: "taken";
+    readonly DROPPED: "dropped";
+    readonly MOVED: "moved";
+    readonly EXAMINED: "examined";
+    readonly PUT_IN: "put_in";
+    readonly PUT_ON: "put_on";
+    readonly REMOVED_FROM: "removed_from";
+    readonly ITEM_PUT_ON: "item_put_on";
+    readonly ITEM_REMOVED_FROM: "item_removed_from";
+    readonly CONTAINER_EMPTIED: "container_emptied";
+    readonly CONTAINER_NOT_OPEN: "container_not_open";
+    readonly NOT_A_CONTAINER: "not_a_container";
+    readonly NOT_A_SUPPORTER: "not_a_supporter";
+    readonly DOESNT_FIT: "doesnt_fit";
+    readonly OPENED: "opened";
+    readonly CLOSED: "closed";
+    readonly NOT_OPENABLE: "not_openable";
+    readonly LOCKED: "locked";
+    readonly UNLOCKED: "unlocked";
+    readonly CONTAINER_LOCKED: "container_locked";
+    readonly CONTAINER_UNLOCKED: "container_unlocked";
+    readonly ALREADY_LOCKED: "already_locked";
+    readonly ALREADY_UNLOCKED: "already_unlocked";
+    readonly UNLOCK_FAILED: "unlock_failed";
+    readonly NOT_LOCKABLE: "not_lockable";
+    readonly SWITCHED_ON: "switched_on";
+    readonly SWITCHED_OFF: "switched_off";
+    readonly DEVICE_SWITCHED_ON: "device_switched_on";
+    readonly DEVICE_SWITCHED_OFF: "device_switched_off";
+    readonly DEVICE_ACTIVATED: "device_activated";
+    readonly WORN: "worn";
+    readonly REMOVED: "removed";
+    readonly EATEN: "eaten";
+    readonly DRUNK: "drunk";
+    readonly ITEM_EATEN: "item_eaten";
+    readonly ITEM_DRUNK: "item_drunk";
+    readonly ITEM_DESTROYED: "item_destroyed";
+    readonly ACTOR_MOVED: "actor_moved";
+    readonly ACTOR_ENTERED: "actor_entered";
+    readonly ACTOR_EXITED: "actor_exited";
+    readonly MOVEMENT_BLOCKED: "movement_blocked";
+    readonly ENTERED: "entered";
+    readonly EXITED: "exited";
+    readonly EVACUATED: "evacuated";
+    readonly CLIMBED: "climbed";
+    readonly ROOM_ENTERED: "room_entered";
+    readonly ROOM_EXITED: "room_exited";
+    readonly ROOM_DESCRIBED: "room_described";
+    readonly ROOM_FIRST_ENTERED: "room_first_entered";
+    readonly ROOM_ILLUMINATED: "room_illuminated";
+    readonly ROOM_DARKENED: "room_darkened";
+    readonly NEW_EXIT_REVEALED: "new_exit_revealed";
+    readonly LIGHT_CHANGED: "light_changed";
+    readonly LOCATION_ILLUMINATED: "location_illuminated";
+    readonly LOCATION_DARKENED: "location_darkened";
+    readonly FUEL_DEPLETED: "fuel_depleted";
+    readonly FUEL_LOW: "fuel_low";
+    readonly REFUELED: "refueled";
+    readonly READ: "read";
+    readonly SEARCHED: "searched";
+    readonly LISTENED: "listened";
+    readonly SMELLED: "smelled";
+    readonly TOUCHED: "touched";
+    readonly GIVEN: "given";
+    readonly SHOWN: "shown";
+    readonly THROWN: "thrown";
+    readonly PUSHED: "pushed";
+    readonly PULLED: "pulled";
+    readonly TURNED: "turned";
+    readonly USED: "used";
+    readonly CUSTOM_MESSAGE: "custom_message";
+    readonly VISIBILITY_CHANGED: "visibility_changed";
+    readonly ACTION_PREVENTED: "action_prevented";
+    readonly ACTION_FAILED: "action_failed";
+    readonly ACTION_SUCCEEDED: "action_succeeded";
+    readonly WAITED: "waited";
+    readonly SCORE_DISPLAYED: "score_displayed";
+    readonly HELP_DISPLAYED: "help_displayed";
+    readonly ABOUT_DISPLAYED: "about_displayed";
+    readonly SCORE_GAINED: "if.event.score_gained";
+    readonly SCORE_LOST: "if.event.score_lost";
+};
+export type IFEventType = typeof IFEvents[keyof typeof IFEvents];
+/**
+ * Event categories for filtering and handling
+ */
+export declare const IFEventCategory: {
+    readonly MANIPULATION: "manipulation";
+    readonly MOVEMENT: "movement";
+    readonly STATE_CHANGE: "state_change";
+    readonly PERCEPTION: "perception";
+    readonly META: "meta";
+};
+export type IFEventCategoryType = typeof IFEventCategory[keyof typeof IFEventCategory];
+/**
+ * Event processor wiring types (ADR-086)
+ *
+ * These types allow WorldModel to wire its event handlers to the engine's
+ * EventProcessor without creating a circular dependency.
+ */
+import type { ISemanticEvent } from '@sharpee/core';
+/**
+ * Callback for registering a handler with the event processor.
+ * The handler returns an array (Effect[] in practice, but typed loosely to avoid circular deps).
+ */
+export type EventProcessorRegisterFn = (eventType: string, handler: (event: ISemanticEvent) => unknown[]) => void;
+/**
+ * Interface for wiring WorldModel handlers to EventProcessor.
+ * WorldModel receives this during engine initialization.
+ */
+export interface IEventProcessorWiring {
+    /**
+     * Register a handler with the event processor
+     */
+    registerHandler: EventProcessorRegisterFn;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyHX,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEjE;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;CAMlB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC;AAEvF;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,EAAE,KAC1C,IAAI,CAAC;AAEV;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,eAAe,EAAE,wBAAwB,CAAC;CAC3C"}

package/dist/events.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Standard Interactive Fiction events.
+ *
+ * These are the core events that can occur in the IF world model.
+ * Extensions can add their own events using namespaced identifiers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IFEventCategory = exports.IFEvents = void 0;
+exports.IFEvents = {
+    // Core object manipulation
+    TAKEN: 'taken',
+    DROPPED: 'dropped',
+    MOVED: 'moved',
+    EXAMINED: 'examined',
+    // Container/supporter events  
+    PUT_IN: 'put_in',
+    PUT_ON: 'put_on',
+    REMOVED_FROM: 'removed_from',
+    ITEM_PUT_ON: 'item_put_on',
+    ITEM_REMOVED_FROM: 'item_removed_from',
+    CONTAINER_EMPTIED: 'container_emptied',
+    CONTAINER_NOT_OPEN: 'container_not_open',
+    NOT_A_CONTAINER: 'not_a_container',
+    NOT_A_SUPPORTER: 'not_a_supporter',
+    DOESNT_FIT: 'doesnt_fit',
+    // Openable events
+    OPENED: 'opened',
+    CLOSED: 'closed',
+    NOT_OPENABLE: 'not_openable',
+    // Lockable events
+    LOCKED: 'locked',
+    UNLOCKED: 'unlocked',
+    CONTAINER_LOCKED: 'container_locked',
+    CONTAINER_UNLOCKED: 'container_unlocked',
+    ALREADY_LOCKED: 'already_locked',
+    ALREADY_UNLOCKED: 'already_unlocked',
+    UNLOCK_FAILED: 'unlock_failed',
+    NOT_LOCKABLE: 'not_lockable',
+    // Switchable events
+    SWITCHED_ON: 'switched_on',
+    SWITCHED_OFF: 'switched_off',
+    DEVICE_SWITCHED_ON: 'device_switched_on',
+    DEVICE_SWITCHED_OFF: 'device_switched_off',
+    DEVICE_ACTIVATED: 'device_activated',
+    // Wearable events
+    WORN: 'worn',
+    REMOVED: 'removed',
+    // Edible events
+    EATEN: 'eaten',
+    DRUNK: 'drunk',
+    ITEM_EATEN: 'item_eaten',
+    ITEM_DRUNK: 'item_drunk',
+    ITEM_DESTROYED: 'item_destroyed',
+    // Movement events
+    ACTOR_MOVED: 'actor_moved',
+    ACTOR_ENTERED: 'actor_entered',
+    ACTOR_EXITED: 'actor_exited',
+    MOVEMENT_BLOCKED: 'movement_blocked',
+    // Entry/exit events
+    ENTERED: 'entered',
+    EXITED: 'exited',
+    EVACUATED: 'evacuated',
+    CLIMBED: 'climbed',
+    // Room events
+    ROOM_ENTERED: 'room_entered',
+    ROOM_EXITED: 'room_exited',
+    ROOM_DESCRIBED: 'room_described',
+    ROOM_FIRST_ENTERED: 'room_first_entered',
+    ROOM_ILLUMINATED: 'room_illuminated',
+    ROOM_DARKENED: 'room_darkened',
+    NEW_EXIT_REVEALED: 'new_exit_revealed',
+    // Light events
+    LIGHT_CHANGED: 'light_changed',
+    LOCATION_ILLUMINATED: 'location_illuminated',
+    LOCATION_DARKENED: 'location_darkened',
+    FUEL_DEPLETED: 'fuel_depleted',
+    FUEL_LOW: 'fuel_low',
+    REFUELED: 'refueled',
+    // Reading events
+    READ: 'read',
+    // Observation events
+    SEARCHED: 'searched',
+    LISTENED: 'listened',
+    SMELLED: 'smelled',
+    TOUCHED: 'touched',
+    // Social/interaction events
+    GIVEN: 'given',
+    SHOWN: 'shown',
+    THROWN: 'thrown',
+    // Device manipulation events
+    PUSHED: 'pushed',
+    PULLED: 'pulled',
+    TURNED: 'turned',
+    USED: 'used',
+    // General message events
+    CUSTOM_MESSAGE: 'custom_message',
+    // Visibility events
+    VISIBILITY_CHANGED: 'visibility_changed',
+    // Action meta-events
+    ACTION_PREVENTED: 'action_prevented',
+    ACTION_FAILED: 'action_failed',
+    ACTION_SUCCEEDED: 'action_succeeded',
+    // Meta action events
+    WAITED: 'waited',
+    SCORE_DISPLAYED: 'score_displayed',
+    HELP_DISPLAYED: 'help_displayed',
+    ABOUT_DISPLAYED: 'about_displayed',
+    // Scoring events (ADR-085)
+    SCORE_GAINED: 'if.event.score_gained',
+    SCORE_LOST: 'if.event.score_lost',
+};
+/**
+ * Event categories for filtering and handling
+ */
+exports.IFEventCategory = {
+    MANIPULATION: 'manipulation',
+    MOVEMENT: 'movement',
+    STATE_CHANGE: 'state_change',
+    PERCEPTION: 'perception',
+    META: 'meta',
+};
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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