@sharpee/stdlib 0.9.60-beta

package/dist/events/action-events.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Action event data patterns
+ *
+ * These interfaces define what goes in the 'payload' field of SemanticEvents
+ * produced by actions. We use the existing SemanticEvent structure rather
+ * than creating redundant fields.
+ */
+/**
+ * Success event payload - when an action completes successfully
+ */
+export interface ActionSuccessPayload {
+    actionId: string;
+    messageId: string;
+    params?: Record<string, any>;
+}
+/**
+ * Error event payload - when an action fails
+ */
+export interface ActionErrorPayload {
+    actionId: string;
+    reason: string;
+    messageId: string;
+    params?: Record<string, any>;
+}
+/**
+ * Game event payload - for world state changes
+ * Each action defines the specific data type
+ */
+export interface GameEventPayload<TData = any> {
+    actionId: string;
+    data: TData;
+}
+//# sourceMappingURL=action-events.d.ts.map

package/dist/events/action-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-events.d.ts","sourceRoot":"","sources":["../../src/events/action-events.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,GAAG;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,KAAK,CAAC;CACb"}

package/dist/events/action-events.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Action event data patterns
+ *
+ * These interfaces define what goes in the 'payload' field of SemanticEvents
+ * produced by actions. We use the existing SemanticEvent structure rather
+ * than creating redundant fields.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=action-events.js.map

package/dist/events/action-events.js.map

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

package/dist/events/base-event.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Base event payload structures for action events
+ *
+ * All action events follow these patterns for their payload field.
+ * The SemanticEvent structure provides id, type, timestamp, and entities.
+ */
+/**
+ * Base payload for all action-generated events
+ */
+export interface BaseActionPayload {
+    /**
+     * The action that generated this event
+     */
+    actionId: string;
+}
+/**
+ * Payload for game events (world state changes)
+ */
+export interface GameEventPayload<TData = any> extends BaseActionPayload {
+    /**
+     * Event-specific data as defined by each action
+     */
+    data: TData;
+}
+/**
+ * Payload for action success messages
+ */
+export interface ActionSuccessPayload<TData = any> extends BaseActionPayload {
+    /**
+     * Message ID for text generation
+     */
+    messageId: string;
+    /**
+     * Parameters for message formatting
+     */
+    params?: Record<string, any>;
+    /**
+     * Optional structured data
+     */
+    data?: TData;
+}
+/**
+ * Payload for action error events
+ */
+export interface ActionErrorPayload<TData = any> extends BaseActionPayload {
+    /**
+     * The specific error reason
+     */
+    reason: string;
+    /**
+     * Message ID for error text
+     */
+    messageId: string;
+    /**
+     * Parameters for message formatting
+     */
+    params?: Record<string, any>;
+    /**
+     * Structured error data
+     */
+    data: TData;
+}
+//# sourceMappingURL=base-event.d.ts.map

package/dist/events/base-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-event.d.ts","sourceRoot":"","sources":["../../src/events/base-event.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,GAAG,CAAE,SAAQ,iBAAiB;IACtE;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,KAAK,GAAG,GAAG,CAAE,SAAQ,iBAAiB;IAC1E;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7B;;OAEG;IACH,IAAI,CAAC,EAAE,KAAK,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK,GAAG,GAAG,CAAE,SAAQ,iBAAiB;IACxE;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE7B;;OAEG;IACH,IAAI,EAAE,KAAK,CAAC;CACb"}

package/dist/events/base-event.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Base event payload structures for action events
+ *
+ * All action events follow these patterns for their payload field.
+ * The SemanticEvent structure provides id, type, timestamp, and entities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=base-event.js.map

package/dist/events/base-event.js.map

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

package/dist/events/common-patterns.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Common event data patterns for IF actions
+ *
+ * These are optional base interfaces that actions can extend
+ * if they want to follow common patterns. Actions are free
+ * to define their own structures.
+ */
+import { EntityId } from '@sharpee/core';
+/**
+ * Common pattern for events that involve a target entity
+ */
+export interface TargetedEventData {
+    targetId: EntityId;
+    targetName: string;
+}
+/**
+ * Common pattern for events that involve object manipulation
+ */
+export interface ObjectEventData extends TargetedEventData {
+    objectId: EntityId;
+    objectName: string;
+}
+/**
+ * Common pattern for location-based events
+ */
+export interface LocationEventData {
+    locationId: EntityId;
+    locationName: string;
+}
+/**
+ * Common pattern for events involving containers/supporters
+ */
+export interface ContainerContextData {
+    containerId?: EntityId;
+    containerName?: string;
+    isContainer?: boolean;
+    isSupporter?: boolean;
+}
+/**
+ * Common pattern for movement between locations
+ */
+export interface MovementData {
+    fromLocationId: EntityId;
+    fromLocationName: string;
+    toLocationId: EntityId;
+    toLocationName: string;
+}
+/**
+ * Guidelines for event data design:
+ *
+ * 1. Entity references should use IDs (stable, unique)
+ * 2. Include human-readable names when needed for messages
+ * 3. Use consistent naming patterns:
+ *    - `${entity}Id` for entity IDs
+ *    - `${entity}Name` for entity names
+ *    - `is${Property}` for boolean flags
+ *    - `has${Property}` for existence checks
+ * 4. Keep event data focused on what happened, not how to display it
+ */
+//# sourceMappingURL=common-patterns.d.ts.map

package/dist/events/common-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-patterns.d.ts","sourceRoot":"","sources":["../../src/events/common-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,QAAQ,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,QAAQ,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,QAAQ,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;GAWG"}

package/dist/events/common-patterns.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Common event data patterns for IF actions
+ *
+ * These are optional base interfaces that actions can extend
+ * if they want to follow common patterns. Actions are free
+ * to define their own structures.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Guidelines for event data design:
+ *
+ * 1. Entity references should use IDs (stable, unique)
+ * 2. Include human-readable names when needed for messages
+ * 3. Use consistent naming patterns:
+ *    - `${entity}Id` for entity IDs
+ *    - `${entity}Name` for entity names
+ *    - `is${Property}` for boolean flags
+ *    - `has${Property}` for existence checks
+ * 4. Keep event data focused on what happened, not how to display it
+ */
+//# sourceMappingURL=common-patterns.js.map

package/dist/events/common-patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common-patterns.js","sourceRoot":"","sources":["../../src/events/common-patterns.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAgDH;;;;;;;;;;;GAWG"}

package/dist/events/event-registry.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Stdlib Event Registry Extension
+ *
+ * Extends the core EventDataRegistry with stdlib action event types.
+ * Uses TypeScript declaration merging to add type safety for IF events.
+ *
+ * @see ADR-082 for the design rationale
+ */
+import type { EntityId } from '@sharpee/core';
+export type { TakenEventData, TakingErrorData } from '../actions/standard/taking/taking-events';
+export type { DroppedEventData, DroppingErrorData } from '../actions/standard/dropping/dropping-events';
+export type { LookedEventData, RoomDescriptionEventData, ListContentsEventData } from '../actions/standard/looking/looking-events';
+export type { ExaminedEventData, ExaminingErrorData } from '../actions/standard/examining/examining-events';
+export type { ActorMovedEventData, ActorExitedEventData, ActorEnteredEventData, GoingErrorData } from '../actions/standard/going/going-events';
+export type { OpenedEventData, RevealedEventData, ExitRevealedEventData, OpeningErrorData } from '../actions/standard/opening/opening-events';
+export type { PutInEventData, PutOnEventData } from '../actions/standard/putting/putting-events';
+export type { LockedEventData, LockingErrorData } from '../actions/standard/locking/locking-events';
+export type { UnlockedEventData, UnlockingErrorData } from '../actions/standard/unlocking/unlocking-events';
+export type { WornEventData, WearingErrorData } from '../actions/standard/wearing/wearing-events';
+export type { RemovedEventData as TakingOffRemovedEventData, TakingOffErrorData } from '../actions/standard/taking_off/taking-off-events';
+export type { EnteredEventData, EnteringErrorData } from '../actions/standard/entering/entering-events';
+export type { ExitedEventData, ExitingErrorData } from '../actions/standard/exiting/exiting-events';
+export type { SwitchedOnEventData, SwitchingOnErrorData } from '../actions/standard/switching_on/switching_on-events';
+export type { SwitchedOffEventData, SwitchingOffErrorData } from '../actions/standard/switching_off/switching_off-events';
+export type { ScoreDisplayedEventData } from '../actions/standard/scoring/scoring-events';
+export type { InventoryEventData, InventoryItem } from '../actions/standard/inventory/inventory-events';
+import type { TakenEventData } from '../actions/standard/taking/taking-events';
+import type { DroppedEventData } from '../actions/standard/dropping/dropping-events';
+import type { LookedEventData, RoomDescriptionEventData, ListContentsEventData } from '../actions/standard/looking/looking-events';
+import type { ExaminedEventData } from '../actions/standard/examining/examining-events';
+import type { ActorMovedEventData, ActorExitedEventData, ActorEnteredEventData } from '../actions/standard/going/going-events';
+import type { OpenedEventData, RevealedEventData, ExitRevealedEventData } from '../actions/standard/opening/opening-events';
+import type { PutInEventData, PutOnEventData } from '../actions/standard/putting/putting-events';
+import type { LockedEventData } from '../actions/standard/locking/locking-events';
+import type { UnlockedEventData } from '../actions/standard/unlocking/unlocking-events';
+import type { WornEventData } from '../actions/standard/wearing/wearing-events';
+import type { RemovedEventData as TakingOffRemovedData } from '../actions/standard/taking_off/taking-off-events';
+import type { EnteredEventData } from '../actions/standard/entering/entering-events';
+import type { ExitedEventData } from '../actions/standard/exiting/exiting-events';
+import type { SwitchedOnEventData } from '../actions/standard/switching_on/switching_on-events';
+import type { SwitchedOffEventData } from '../actions/standard/switching_off/switching_off-events';
+import type { ScoreDisplayedEventData } from '../actions/standard/scoring/scoring-events';
+import type { InventoryEventData } from '../actions/standard/inventory/inventory-events';
+/**
+ * Standard success event data for actions
+ */
+export interface ActionSuccessData {
+    actionId: string;
+    messageId: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * Standard error event data for actions
+ */
+export interface ActionErrorData {
+    actionId: string;
+    reason: string;
+    messageId: string;
+    params?: Record<string, unknown>;
+}
+/**
+ * Closed event data (for closing action)
+ */
+export interface ClosedEventData {
+    targetId: EntityId;
+    targetName: string;
+}
+/**
+ * Implicit take event data
+ *
+ * Emitted when an action requires a carried item and the item
+ * is automatically taken first. Used for "(first taking the X)" messages.
+ */
+export interface ImplicitTakeEventData {
+    item: EntityId;
+    itemName: string;
+}
+declare module '@sharpee/core' {
+    interface EventDataRegistry {
+        'if.event.taken': TakenEventData;
+        'if.event.dropped': DroppedEventData;
+        'if.event.implicit_take': ImplicitTakeEventData;
+        'if.event.looked': LookedEventData;
+        'if.event.room.description': RoomDescriptionEventData;
+        'if.event.list.contents': ListContentsEventData;
+        'if.event.examined': ExaminedEventData;
+        'if.event.actor_moved': ActorMovedEventData;
+        'if.event.actor_exited': ActorExitedEventData;
+        'if.event.actor_entered': ActorEnteredEventData;
+        'if.event.opened': OpenedEventData;
+        'if.event.closed': ClosedEventData;
+        'if.event.revealed': RevealedEventData;
+        'if.event.exit_revealed': ExitRevealedEventData;
+        'if.event.put_in': PutInEventData;
+        'if.event.put_on': PutOnEventData;
+        'if.event.locked': LockedEventData;
+        'if.event.unlocked': UnlockedEventData;
+        'if.event.worn': WornEventData;
+        'if.event.removed': TakingOffRemovedData;
+        'if.event.entered': EnteredEventData;
+        'if.event.exited': ExitedEventData;
+        'if.event.switched_on': SwitchedOnEventData;
+        'if.event.switched_off': SwitchedOffEventData;
+        'if.event.score_displayed': ScoreDisplayedEventData;
+        'if.action.inventory': InventoryEventData;
+        'action.success': ActionSuccessData;
+        'action.error': ActionErrorData;
+    }
+}
+export {};
+//# sourceMappingURL=event-registry.d.ts.map

package/dist/events/event-registry.d.ts.map

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

package/dist/events/event-registry.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Stdlib Event Registry Extension
+ *
+ * Extends the core EventDataRegistry with stdlib action event types.
+ * Uses TypeScript declaration merging to add type safety for IF events.
+ *
+ * @see ADR-082 for the design rationale
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=event-registry.js.map

package/dist/events/event-registry.js.map

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

package/dist/events/event-utils.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Utilities for creating standardized event data
+ *
+ * These are helpers that actions can use if they want to follow
+ * common patterns, but they're entirely optional.
+ */
+import { IFEntity } from '@sharpee/world-model';
+import { EntityId } from '@sharpee/core';
+/**
+ * Create standard target data from an entity
+ */
+export declare function createTargetData(entity: IFEntity): {
+    targetId: string;
+    targetName: string;
+};
+/**
+ * Create standard object data from an entity
+ */
+export declare function createObjectData(entity: IFEntity): {
+    targetId: string;
+    targetName: string;
+    objectId: string;
+    objectName: string;
+};
+/**
+ * Create standard container data from an entity
+ */
+export declare function createContainerData(entity: IFEntity): {
+    containerId: string;
+    containerName: string;
+};
+/**
+ * Create standard location data from an entity
+ */
+export declare function createLocationData(entity: IFEntity): {
+    locationId: string;
+    locationName: string;
+};
+/**
+ * Helper to convert entity array to ID array
+ */
+export declare function entitiesToIds(entities: IFEntity[]): EntityId[];
+/**
+ * Helper to convert entity array to name array
+ */
+export declare function entitiesToNames(entities: IFEntity[]): string[];
+/**
+ * Create movement data from two locations
+ */
+export declare function createMovementData(from: IFEntity, to: IFEntity): {
+    fromLocationId: string;
+    fromLocationName: string;
+    toLocationId: string;
+    toLocationName: string;
+};
+//# sourceMappingURL=event-utils.d.ts.map

package/dist/events/event-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-utils.d.ts","sourceRoot":"","sources":["../../src/events/event-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ;;;EAKhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ;;;;;EAOhD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ;;;EAKnD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ;;;EAKlD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAE9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,CAE9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ;;;;;EAO9D"}

package/dist/events/event-utils.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Utilities for creating standardized event data
+ *
+ * These are helpers that actions can use if they want to follow
+ * common patterns, but they're entirely optional.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTargetData = createTargetData;
+exports.createObjectData = createObjectData;
+exports.createContainerData = createContainerData;
+exports.createLocationData = createLocationData;
+exports.entitiesToIds = entitiesToIds;
+exports.entitiesToNames = entitiesToNames;
+exports.createMovementData = createMovementData;
+/**
+ * Create standard target data from an entity
+ */
+function createTargetData(entity) {
+    return {
+        targetId: entity.id,
+        targetName: entity.name
+    };
+}
+/**
+ * Create standard object data from an entity
+ */
+function createObjectData(entity) {
+    return {
+        targetId: entity.id,
+        targetName: entity.name,
+        objectId: entity.id,
+        objectName: entity.name
+    };
+}
+/**
+ * Create standard container data from an entity
+ */
+function createContainerData(entity) {
+    return {
+        containerId: entity.id,
+        containerName: entity.name
+    };
+}
+/**
+ * Create standard location data from an entity
+ */
+function createLocationData(entity) {
+    return {
+        locationId: entity.id,
+        locationName: entity.name
+    };
+}
+/**
+ * Helper to convert entity array to ID array
+ */
+function entitiesToIds(entities) {
+    return entities.map(e => e.id);
+}
+/**
+ * Helper to convert entity array to name array
+ */
+function entitiesToNames(entities) {
+    return entities.map(e => e.name);
+}
+/**
+ * Create movement data from two locations
+ */
+function createMovementData(from, to) {
+    return {
+        fromLocationId: from.id,
+        fromLocationName: from.name,
+        toLocationId: to.id,
+        toLocationName: to.name
+    };
+}
+//# sourceMappingURL=event-utils.js.map

package/dist/events/event-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-utils.js","sourceRoot":"","sources":["../../src/events/event-utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAQH,4CAKC;AAKD,4CAOC;AAKD,kDAKC;AAKD,gDAKC;AAKD,sCAEC;AAKD,0CAEC;AAKD,gDAOC;AAlED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,MAAgB;IAC/C,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,UAAU,EAAE,MAAM,CAAC,IAAI;KACxB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,MAAgB;IAC/C,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,UAAU,EAAE,MAAM,CAAC,IAAI;KACxB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAgB;IAClD,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,EAAE;QACtB,aAAa,EAAE,MAAM,CAAC,IAAI;KAC3B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,MAAgB;IACjD,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,EAAE;QACrB,YAAY,EAAE,MAAM,CAAC,IAAI;KAC1B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,aAAa,CAAC,QAAoB;IAChD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,QAAoB;IAClD,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,IAAc,EAAE,EAAY;IAC7D,OAAO;QACL,cAAc,EAAE,IAAI,CAAC,EAAE;QACvB,gBAAgB,EAAE,IAAI,CAAC,IAAI;QAC3B,YAAY,EAAE,EAAE,CAAC,EAAE;QACnB,cAAc,EAAE,EAAE,CAAC,IAAI;KACxB,CAAC;AACJ,CAAC"}

package/dist/events/helpers.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Helper utilities for common event handler patterns
+ */
+import { ISemanticEvent } from '@sharpee/core';
+import { IFEntity, WorldModel } from '@sharpee/world-model';
+interface GameEvent extends ISemanticEvent {
+    type: string;
+    data: Record<string, any>;
+}
+type EntityEventHandler = (event: GameEvent, world: WorldModel) => void | ISemanticEvent[];
+/**
+ * Create a handler that toggles a switchable entity
+ */
+export declare function createToggleHandler(entity: IFEntity): EntityEventHandler;
+/**
+ * Create a handler that opens something when triggered
+ */
+export declare function createOpenHandler(entity: IFEntity, target: string): EntityEventHandler;
+/**
+ * Create a handler that reveals a hidden passage
+ */
+export declare function createRevealHandler(entity: IFEntity, passage: string): EntityEventHandler;
+/**
+ * Create a handler that displays a message
+ */
+export declare function createMessageHandler(message: string, params?: Record<string, any>): EntityEventHandler;
+/**
+ * Compose multiple handlers into one
+ */
+export declare function composeHandlers(...handlers: EntityEventHandler[]): EntityEventHandler;
+/**
+ * Create a handler that only fires once
+ */
+export declare function createOnceHandler(handler: EntityEventHandler): EntityEventHandler;
+/**
+ * Create a handler that only fires after N times
+ */
+export declare function createAfterHandler(count: number, handler: EntityEventHandler): EntityEventHandler;
+/**
+ * Create a handler with a condition
+ */
+export declare function createConditionalHandler(condition: (event: GameEvent) => boolean, handler: EntityEventHandler): EntityEventHandler;
+export {};
+//# sourceMappingURL=helpers.d.ts.map

package/dist/events/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/events/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG5D,UAAU,SAAU,SAAQ,cAAc;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC3B;AAGD,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,UAAU,KAAK,IAAI,GAAG,cAAc,EAAE,CAAC;AAE3F;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,GAAG,kBAAkB,CAqBxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,kBAAkB,CActF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAczF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,kBAAkB,CActG;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,QAAQ,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CAWrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAQjF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAQjG;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,EACxC,OAAO,EAAE,kBAAkB,GAC1B,kBAAkB,CAMpB"}