@sharpee/stdlib 0.9.60-beta

package/dist/actions/context.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Read-only action context implementation
+ *
+ * Provides query methods for actions without allowing state mutations
+ */
+import { IFEntity, WorldModel, ICapabilityData, IValidatedCommand } from '@sharpee/world-model';
+import { ActionContext, Action, ScopeCheckResult, ImplicitTakeResult } from './enhanced-types';
+import { ISemanticEvent } from '@sharpee/core';
+import { ScopeResolver, ScopeLevel } from '../scope/types';
+/**
+ * @deprecated Use createActionContext from enhanced-context.ts instead
+ * This class is kept for backward compatibility but will be removed in Phase 4
+ */
+export declare class ReadOnlyActionContext implements ActionContext {
+    readonly world: WorldModel;
+    readonly player: IFEntity;
+    readonly currentLocation: IFEntity;
+    readonly command: IValidatedCommand;
+    readonly action: Action;
+    readonly scopeResolver: ScopeResolver;
+    sharedData: Record<string, any>;
+    constructor(world: WorldModel, player: IFEntity, currentLocation: IFEntity, command: IValidatedCommand, action?: Action, scopeResolver?: ScopeResolver);
+    /**
+     * Check if an entity is visible to the player
+     */
+    canSee(entity: IFEntity): boolean;
+    /**
+     * Check if an entity is physically reachable by the player
+     *
+     * An entity is reachable if:
+     * 1. It's in the same location as the player
+     * 2. It's held by the player
+     * 3. It's in an open container in the same location
+     * 4. It's on a supporter in the same location
+     */
+    canReach(entity: IFEntity): boolean;
+    /**
+     * Check if an entity can be taken by the player
+     *
+     * An entity can be taken if:
+     * 1. It's visible
+     * 2. It's reachable
+     * 3. It's not a room
+     * 4. It's not scenery (fixed in place)
+     * 5. It's not already held by the player
+     */
+    canTake(entity: IFEntity): boolean;
+    /**
+     * Check if an entity is in scope for the player
+     */
+    isInScope(entity: IFEntity): boolean;
+    /**
+     * Get all entities visible to the player
+     */
+    getVisible(): IFEntity[];
+    /**
+     * Get all entities in scope for the player
+     */
+    getInScope(): IFEntity[];
+    /**
+     * Get capability data (convenience method)
+     */
+    getCapability(name: string): ICapabilityData | undefined;
+    /**
+     * Event creation method (required by ActionContext interface)
+     * @deprecated This implementation throws an error - use createActionContext instead
+     */
+    event(type: string, data: any): ISemanticEvent;
+    /**
+     * Get the scope level for an entity.
+     * @deprecated This implementation returns basic scope levels - use createActionContext instead
+     */
+    getEntityScope(entity: IFEntity): ScopeLevel;
+    /**
+     * Get the scope level for an entity in a command slot.
+     * @deprecated This implementation returns basic scope levels - use createActionContext instead
+     */
+    getSlotScope(slot: string): ScopeLevel;
+    /**
+     * Check if an entity meets a required scope level.
+     * @deprecated This implementation is basic - use createActionContext instead
+     */
+    requireScope(entity: IFEntity, required: ScopeLevel): ScopeCheckResult;
+    /**
+     * Check if a command slot entity meets a required scope level.
+     * @deprecated This implementation is basic - use createActionContext instead
+     */
+    requireSlotScope(slot: string, required: ScopeLevel): ScopeCheckResult;
+    /**
+     * Check if an entity is carried, attempting implicit take if needed.
+     * @deprecated This implementation throws an error - use createActionContext instead
+     */
+    requireCarriedOrImplicitTake(_entity: IFEntity): ImplicitTakeResult;
+}
+//# sourceMappingURL=context.d.ts.map

package/dist/actions/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/actions/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAChG,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE3D;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,aAAa;aAMvC,KAAK,EAAE,UAAU;aACjB,MAAM,EAAE,QAAQ;aAChB,eAAe,EAAE,QAAQ;aACzB,OAAO,EAAE,iBAAiB;IAR5C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,aAAa,EAAE,aAAa,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAM;gBAG1B,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,QAAQ,EAChB,eAAe,EAAE,QAAQ,EACzB,OAAO,EAAE,iBAAiB,EAC1C,MAAM,CAAC,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,aAAa;IAW/B;;OAEG;IACH,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAIjC;;;;;;;;OAQG;IACH,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAmDnC;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IA8BlC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,OAAO;IAKpC;;OAEG;IACH,UAAU,IAAI,QAAQ,EAAE;IAIxB;;OAEG;IACH,UAAU,IAAI,QAAQ,EAAE;IAIxB;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIxD;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,cAAc;IAQ9C;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,UAAU;IAuB5C;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU;IAmBtC;;;OAGG;IACH,YAAY,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,GAAG,gBAAgB;IA8BtE;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,GAAG,gBAAgB;IA0BtE;;;OAGG;IACH,4BAA4B,CAAC,OAAO,EAAE,QAAQ,GAAG,kBAAkB;CAGpE"}

package/dist/actions/context.js

@@ -0,0 +1,271 @@
+"use strict";
+/**
+ * Read-only action context implementation
+ *
+ * Provides query methods for actions without allowing state mutations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadOnlyActionContext = void 0;
+const types_1 = require("../scope/types");
+/**
+ * @deprecated Use createActionContext from enhanced-context.ts instead
+ * This class is kept for backward compatibility but will be removed in Phase 4
+ */
+class ReadOnlyActionContext {
+    world;
+    player;
+    currentLocation;
+    command;
+    action;
+    scopeResolver;
+    sharedData = {};
+    constructor(world, player, currentLocation, command, action, scopeResolver) {
+        this.world = world;
+        this.player = player;
+        this.currentLocation = currentLocation;
+        this.command = command;
+        // Temporary compatibility - action is required by interface but this class is deprecated
+        this.action = action || {
+            id: 'unknown',
+            validate: () => ({ valid: true }),
+            execute: () => []
+        };
+        this.scopeResolver = scopeResolver || {}; // Temporary fix for deprecated class
+    }
+    /**
+     * Check if an entity is visible to the player
+     */
+    canSee(entity) {
+        return this.world.canSee(this.player.id, entity.id);
+    }
+    /**
+     * Check if an entity is physically reachable by the player
+     *
+     * An entity is reachable if:
+     * 1. It's in the same location as the player
+     * 2. It's held by the player
+     * 3. It's in an open container in the same location
+     * 4. It's on a supporter in the same location
+     */
+    canReach(entity) {
+        const entityLocation = this.world.getLocation(entity.id);
+        // Held by player
+        if (entityLocation === this.player.id) {
+            return true;
+        }
+        // In same location as player
+        if (entityLocation === this.currentLocation.id) {
+            return true;
+        }
+        // In an accessible container/supporter
+        if (entityLocation) {
+            const container = this.world.getEntity(entityLocation);
+            if (container) {
+                const containerLocation = this.world.getLocation(container.id);
+                // Container is in same location as player
+                if (containerLocation === this.currentLocation.id) {
+                    // Check if it's an open container
+                    if (container.has('container')) {
+                        const openableTrait = container.get('openable');
+                        if (!openableTrait || openableTrait.isOpen) {
+                            return true;
+                        }
+                    }
+                    // Or a supporter (always accessible)
+                    if (container.has('supporter')) {
+                        return true;
+                    }
+                }
+                // Container is held by player
+                if (containerLocation === this.player.id) {
+                    // Check if it's an open container
+                    if (container.has('container')) {
+                        const openableTrait = container.get('openable');
+                        if (!openableTrait || openableTrait.isOpen) {
+                            return true;
+                        }
+                    }
+                }
+            }
+        }
+        return false;
+    }
+    /**
+     * Check if an entity can be taken by the player
+     *
+     * An entity can be taken if:
+     * 1. It's visible
+     * 2. It's reachable
+     * 3. It's not a room
+     * 4. It's not scenery (fixed in place)
+     * 5. It's not already held by the player
+     */
+    canTake(entity) {
+        // Must be visible
+        if (!this.canSee(entity)) {
+            return false;
+        }
+        // Must be reachable
+        if (!this.canReach(entity)) {
+            return false;
+        }
+        // Can't take rooms
+        if (entity.has('room')) {
+            return false;
+        }
+        // Can't take scenery
+        if (entity.has('scenery')) {
+            return false;
+        }
+        // Already held
+        const location = this.world.getLocation(entity.id);
+        if (location === this.player.id) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Check if an entity is in scope for the player
+     */
+    isInScope(entity) {
+        const inScopeEntities = this.world.getInScope(this.player.id);
+        return inScopeEntities.some(e => e.id === entity.id);
+    }
+    /**
+     * Get all entities visible to the player
+     */
+    getVisible() {
+        return this.world.getVisible(this.player.id);
+    }
+    /**
+     * Get all entities in scope for the player
+     */
+    getInScope() {
+        return this.world.getInScope(this.player.id);
+    }
+    /**
+     * Get capability data (convenience method)
+     */
+    getCapability(name) {
+        return this.world.getCapability(name);
+    }
+    /**
+     * Event creation method (required by ActionContext interface)
+     * @deprecated This implementation throws an error - use createActionContext instead
+     */
+    event(type, data) {
+        throw new Error('ReadOnlyActionContext does not support event creation. Use createActionContext from enhanced-context.ts instead.');
+    }
+    // =========================================================================
+    // Scope validation methods (Phase 4 - stub implementations for deprecated class)
+    // =========================================================================
+    /**
+     * Get the scope level for an entity.
+     * @deprecated This implementation returns basic scope levels - use createActionContext instead
+     */
+    getEntityScope(entity) {
+        // Basic implementation for deprecated class
+        const entityLocation = this.world.getLocation(entity.id);
+        // Carried - in player's inventory
+        if (entityLocation === this.player.id) {
+            return types_1.ScopeLevel.CARRIED;
+        }
+        // Reachable - in same location
+        if (entityLocation === this.currentLocation.id || this.canReach(entity)) {
+            return types_1.ScopeLevel.REACHABLE;
+        }
+        // Visible - can see but not reach
+        if (this.canSee(entity)) {
+            return types_1.ScopeLevel.VISIBLE;
+        }
+        // Not in scope
+        return types_1.ScopeLevel.UNAWARE;
+    }
+    /**
+     * Get the scope level for an entity in a command slot.
+     * @deprecated This implementation returns basic scope levels - use createActionContext instead
+     */
+    getSlotScope(slot) {
+        const slotMap = {
+            target: 'directObject',
+            item: 'directObject',
+            container: 'indirectObject',
+            recipient: 'indirectObject'
+        };
+        const commandSlot = slotMap[slot] || slot;
+        const ref = this.command[commandSlot];
+        const entity = ref?.entity;
+        if (!entity) {
+            return types_1.ScopeLevel.UNAWARE;
+        }
+        return this.getEntityScope(entity);
+    }
+    /**
+     * Check if an entity meets a required scope level.
+     * @deprecated This implementation is basic - use createActionContext instead
+     */
+    requireScope(entity, required) {
+        const actualScope = this.getEntityScope(entity);
+        if (actualScope >= required) {
+            return { ok: true, actualScope };
+        }
+        // Return appropriate error based on what's missing
+        let errorCode;
+        if (required === types_1.ScopeLevel.CARRIED) {
+            errorCode = 'scope.not_carried';
+        }
+        else if (required === types_1.ScopeLevel.REACHABLE) {
+            errorCode = 'scope.not_reachable';
+        }
+        else if (required === types_1.ScopeLevel.VISIBLE) {
+            errorCode = 'scope.not_visible';
+        }
+        else {
+            errorCode = 'scope.out_of_scope';
+        }
+        return {
+            ok: false,
+            actualScope,
+            error: {
+                valid: false,
+                error: errorCode,
+                params: { entityId: entity.id, entityName: entity.name, required, actual: actualScope }
+            }
+        };
+    }
+    /**
+     * Check if a command slot entity meets a required scope level.
+     * @deprecated This implementation is basic - use createActionContext instead
+     */
+    requireSlotScope(slot, required) {
+        const slotMap = {
+            target: 'directObject',
+            item: 'directObject',
+            container: 'indirectObject',
+            recipient: 'indirectObject'
+        };
+        const commandSlot = slotMap[slot] || slot;
+        const ref = this.command[commandSlot];
+        const entity = ref?.entity;
+        if (!entity) {
+            return {
+                ok: false,
+                error: {
+                    valid: false,
+                    error: 'scope.not_found',
+                    params: { slot }
+                }
+            };
+        }
+        return this.requireScope(entity, required);
+    }
+    /**
+     * Check if an entity is carried, attempting implicit take if needed.
+     * @deprecated This implementation throws an error - use createActionContext instead
+     */
+    requireCarriedOrImplicitTake(_entity) {
+        throw new Error('ReadOnlyActionContext does not support implicit takes. Use createActionContext from enhanced-context.ts instead.');
+    }
+}
+exports.ReadOnlyActionContext = ReadOnlyActionContext;
+//# sourceMappingURL=context.js.map

package/dist/actions/context.js.map

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

package/dist/actions/data-builder-types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Action Data Builder Types
+ *
+ * Provides base types and utilities for building action event data.
+ * This addresses the snapshot code smell (ADR-061) by centralizing
+ * data structure logic outside of action business logic.
+ */
+import { ActionContext } from './enhanced-types';
+import { WorldModel } from '@sharpee/world-model';
+/**
+ * Function that builds data for action events
+ *
+ * Takes the action context and world states, returns structured data
+ * for use in semantic events. This separates data structure from
+ * business logic in actions.
+ */
+export type ActionDataBuilder<T = Record<string, unknown>> = (context: ActionContext, preState?: WorldModel, postState?: WorldModel) => T;
+/**
+ * Configuration for action data building
+ *
+ * Allows stories to extend or customize the data included in events
+ */
+export interface ActionDataConfig<T = Record<string, unknown>> {
+    /**
+     * The base data builder function
+     */
+    builder: ActionDataBuilder<T>;
+    /**
+     * Optional story-specific extension
+     */
+    extension?: (baseData: T, context: ActionContext, preState?: WorldModel, postState?: WorldModel) => T;
+    /**
+     * Protected fields that cannot be overridden by extensions
+     */
+    protectedFields?: string[];
+}
+/**
+ * Build event data using a configuration
+ *
+ * Combines base builder with optional extensions while protecting core fields
+ */
+export declare function buildEventData<T extends Record<string, unknown>>(config: ActionDataConfig<T>, context: ActionContext, preState?: WorldModel, postState?: WorldModel): T;
+/**
+ * Common validation error data builder
+ *
+ * Builds standard error data with entity snapshots
+ */
+export interface ValidationErrorData {
+    actionId: string;
+    error: string;
+    messageId: string;
+    params: Record<string, any>;
+}
+/**
+ * Build validation error data with entity snapshots
+ *
+ * Centralizes the logic for building error events with entity data
+ */
+export declare function buildValidationErrorData(context: ActionContext, error: string, params?: Record<string, any>): ValidationErrorData;
+/**
+ * Registry for action data builders
+ *
+ * Allows registration and retrieval of data builders by action ID
+ */
+export declare class ActionDataRegistry {
+    private builders;
+    /**
+     * Register a data builder for an action
+     */
+    register<T extends Record<string, unknown>>(actionId: string, config: ActionDataConfig<T>): void;
+    /**
+     * Get a data builder for an action
+     */
+    get<T extends Record<string, unknown>>(actionId: string): ActionDataConfig<T> | undefined;
+    /**
+     * Check if a data builder is registered
+     */
+    has(actionId: string): boolean;
+    /**
+     * Build data for an action using its registered builder
+     */
+    buildData<T extends Record<string, unknown>>(actionId: string, context: ActionContext, preState?: WorldModel, postState?: WorldModel): T | undefined;
+}
+export declare const actionDataRegistry: ActionDataRegistry;
+//# sourceMappingURL=data-builder-types.d.ts.map

package/dist/actions/data-builder-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-builder-types.d.ts","sourceRoot":"","sources":["../../src/actions/data-builder-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAC3D,OAAO,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,UAAU,EACrB,SAAS,CAAC,EAAE,UAAU,KACnB,CAAC,CAAC;AAEP;;;;GAIG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D;;OAEG;IACH,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAE9B;;OAEG;IACH,SAAS,CAAC,EAAE,CACV,QAAQ,EAAE,CAAC,EACX,OAAO,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,UAAU,EACrB,SAAS,CAAC,EAAE,UAAU,KACnB,CAAC,CAAC;IAEP;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9D,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,UAAU,EACrB,SAAS,CAAC,EAAE,UAAU,GACrB,CAAC,CAqBH;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC3B,mBAAmB,CAqBrB;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;OAEG;IACH,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC1B,IAAI;IAIP;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAAC,CAAC,CAAC,GAAG,SAAS;IAIlC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,EACtB,QAAQ,CAAC,EAAE,UAAU,EACrB,SAAS,CAAC,EAAE,UAAU,GACrB,CAAC,GAAG,SAAS;CAQjB;AAGD,eAAO,MAAM,kBAAkB,oBAA2B,CAAC"}

package/dist/actions/data-builder-types.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Action Data Builder Types
+ *
+ * Provides base types and utilities for building action event data.
+ * This addresses the snapshot code smell (ADR-061) by centralizing
+ * data structure logic outside of action business logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.actionDataRegistry = exports.ActionDataRegistry = void 0;
+exports.buildEventData = buildEventData;
+exports.buildValidationErrorData = buildValidationErrorData;
+/**
+ * Build event data using a configuration
+ *
+ * Combines base builder with optional extensions while protecting core fields
+ */
+function buildEventData(config, context, preState, postState) {
+    // Build base data
+    let data = config.builder(context, preState, postState);
+    // Apply extension if present
+    if (config.extension) {
+        const extended = config.extension(data, context, preState, postState);
+        // Restore protected fields if specified
+        if (config.protectedFields) {
+            for (const field of config.protectedFields) {
+                if (field in data) {
+                    extended[field] = data[field];
+                }
+            }
+        }
+        data = extended;
+    }
+    return data;
+}
+/**
+ * Build validation error data with entity snapshots
+ *
+ * Centralizes the logic for building error events with entity data
+ */
+function buildValidationErrorData(context, error, params) {
+    const errorData = {
+        actionId: context.action.id,
+        error: error,
+        messageId: error,
+        params: params || {}
+    };
+    // Add entity snapshots if entities are available
+    // This will be expanded to use captureEntitySnapshot once we import it
+    if (context.command.directObject?.entity) {
+        errorData.params.target = context.command.directObject.entity.name;
+        errorData.params.targetId = context.command.directObject.entity.id;
+    }
+    if (context.command.indirectObject?.entity) {
+        errorData.params.indirectTarget = context.command.indirectObject.entity.name;
+        errorData.params.indirectTargetId = context.command.indirectObject.entity.id;
+    }
+    return errorData;
+}
+/**
+ * Registry for action data builders
+ *
+ * Allows registration and retrieval of data builders by action ID
+ */
+class ActionDataRegistry {
+    builders = new Map();
+    /**
+     * Register a data builder for an action
+     */
+    register(actionId, config) {
+        this.builders.set(actionId, config);
+    }
+    /**
+     * Get a data builder for an action
+     */
+    get(actionId) {
+        return this.builders.get(actionId);
+    }
+    /**
+     * Check if a data builder is registered
+     */
+    has(actionId) {
+        return this.builders.has(actionId);
+    }
+    /**
+     * Build data for an action using its registered builder
+     */
+    buildData(actionId, context, preState, postState) {
+        const config = this.get(actionId);
+        if (!config) {
+            return undefined;
+        }
+        return buildEventData(config, context, preState, postState);
+    }
+}
+exports.ActionDataRegistry = ActionDataRegistry;
+// Global registry instance
+exports.actionDataRegistry = new ActionDataRegistry();
+//# sourceMappingURL=data-builder-types.js.map

package/dist/actions/data-builder-types.js.map

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

package/dist/actions/enhanced-context.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Enhanced action context implementation
+ *
+ * Provides helper methods that make it easy to create properly
+ * formatted events while maintaining the event-driven architecture.
+ */
+import { IFEntity, WorldModel } from '@sharpee/world-model';
+import { ActionContext, Action } from './enhanced-types';
+import { ScopeResolver } from '../scope/types';
+import { ValidatedCommand } from '../validation/types';
+/**
+ * Factory function to create unified action context
+ *
+ * Phase 2: Factory pattern implementation
+ */
+export declare function createActionContext(world: WorldModel, player: IFEntity, action: Action, command: ValidatedCommand, scopeResolver?: ScopeResolver): ActionContext;
+/**
+ * Helper to create a mock action context for testing
+ */
+export declare function createMockActionContext(world: WorldModel, player: IFEntity, action: Action, command?: Partial<ValidatedCommand>, scopeResolver?: ScopeResolver): ActionContext;
+//# sourceMappingURL=enhanced-context.d.ts.map

package/dist/actions/enhanced-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enhanced-context.d.ts","sourceRoot":"","sources":["../../src/actions/enhanced-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAa,MAAM,sBAAsB,CAAC;AACvE,OAAO,EACL,aAAa,EACb,MAAM,EAMP,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,aAAa,EAAc,MAAM,gBAAgB,CAAC;AAE3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAsXvD;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,gBAAgB,EACzB,aAAa,CAAC,EAAE,aAAa,GAC5B,aAAa,CAQf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,UAAU,EACjB,MAAM,EAAE,QAAQ,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,EACnC,aAAa,CAAC,EAAE,aAAa,GAC5B,aAAa,CAyBf"}