@sharpee/stdlib 0.9.60-beta

package/dist/actions/standard/touching/touching.js

@@ -0,0 +1,221 @@
+"use strict";
+/**
+ * Touching action - touch or feel objects
+ *
+ * This action allows players to touch objects to discover their
+ * texture, temperature, or other tactile properties.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check target exists
+ * 2. execute: Compute tactile properties (no world mutations)
+ * 3. blocked: Generate events when validation fails
+ * 4. report: Generate success events
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.touchingAction = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const constants_1 = require("../../constants");
+const types_1 = require("../../../scope/types");
+function getTouchingSharedData(context) {
+    return context.sharedData;
+}
+exports.touchingAction = {
+    id: constants_1.IFActions.TOUCHING,
+    // Default scope requirements for this action's slots
+    defaultScope: {
+        target: types_1.ScopeLevel.REACHABLE
+    },
+    requiredMessages: [
+        'no_target',
+        'not_visible',
+        'not_reachable',
+        'feels_normal',
+        'feels_warm',
+        'feels_hot',
+        'feels_cold',
+        'feels_soft',
+        'feels_hard',
+        'feels_smooth',
+        'feels_rough',
+        'feels_wet',
+        'device_vibrating',
+        'immovable_object',
+        'liquid_container',
+        'touched',
+        'touched_gently',
+        'poked',
+        'prodded',
+        'patted',
+        'stroked'
+    ],
+    metadata: {
+        requiresDirectObject: true,
+        requiresIndirectObject: false,
+        directObjectScope: types_1.ScopeLevel.REACHABLE
+    },
+    validate(context) {
+        const target = context.command.directObject?.entity;
+        // Must have a target to touch
+        if (!target) {
+            return {
+                valid: false,
+                error: 'no_target',
+                params: {}
+            };
+        }
+        // Check scope - must be able to reach the target
+        const scopeCheck = context.requireScope(target, types_1.ScopeLevel.REACHABLE);
+        if (!scopeCheck.ok) {
+            return scopeCheck.error;
+        }
+        // Tactile property computation happens in execute phase
+        return { valid: true };
+    },
+    execute(context) {
+        // Touching has NO world mutations - it's a sensory action
+        // Just compute tactile properties and store in sharedData for report phase
+        const target = context.command.directObject?.entity;
+        const sharedData = getTouchingSharedData(context);
+        // Build event data with tactile properties
+        const eventData = {
+            target: target.id,
+            targetName: target.name
+        };
+        let messageId = 'feels_normal';
+        // Check various traits for tactile properties
+        // Check if it's a light source (might be hot if lit)
+        if (target.has(world_model_1.TraitType.LIGHT_SOURCE)) {
+            const lightTrait = target.get(world_model_1.TraitType.LIGHT_SOURCE);
+            if (lightTrait.isLit) {
+                eventData.temperature = 'hot';
+                eventData.isLit = true;
+                messageId = 'feels_hot';
+            }
+        }
+        // Check if it's a device (might be warm if on)
+        if (target.has(world_model_1.TraitType.SWITCHABLE) && messageId === 'feels_normal') {
+            const switchableTrait = target.get(world_model_1.TraitType.SWITCHABLE);
+            if (switchableTrait.isOn) {
+                eventData.temperature = 'warm';
+                eventData.isActive = true;
+                // Check if it's vibrating (special case for some devices)
+                const identity = target.get(world_model_1.TraitType.IDENTITY);
+                if (identity?.description?.toLowerCase().includes('vibrat')) {
+                    messageId = 'device_vibrating';
+                }
+                else {
+                    messageId = 'feels_warm';
+                }
+            }
+        }
+        // Determine texture based on traits
+        if (target.has(world_model_1.TraitType.WEARABLE)) {
+            eventData.texture = 'soft';
+            if (messageId === 'feels_normal') {
+                messageId = 'feels_soft';
+            }
+        }
+        else if (target.has(world_model_1.TraitType.DOOR)) {
+            eventData.texture = 'smooth';
+            eventData.material = 'hard';
+            if (messageId === 'feels_normal') {
+                messageId = 'feels_smooth';
+            }
+        }
+        else if (target.has(world_model_1.TraitType.CONTAINER) || target.has(world_model_1.TraitType.SUPPORTER)) {
+            eventData.texture = 'solid';
+            // Check for liquid contents
+            if (target.has(world_model_1.TraitType.CONTAINER)) {
+                const contents = context.world.getContents(target.id);
+                const hasLiquid = contents.some(item => {
+                    if (item.has(world_model_1.TraitType.EDIBLE)) {
+                        const edibleTrait = item.get(world_model_1.TraitType.EDIBLE);
+                        return edibleTrait.isDrink;
+                    }
+                    return false;
+                });
+                if (hasLiquid) {
+                    messageId = 'liquid_container';
+                }
+            }
+            if (messageId === 'feels_normal') {
+                messageId = 'feels_hard';
+            }
+        }
+        else if (target.has(world_model_1.TraitType.EDIBLE)) {
+            const edibleTrait = target.get(world_model_1.TraitType.EDIBLE);
+            if (edibleTrait.isDrink) {
+                eventData.texture = 'liquid';
+                if (messageId === 'feels_normal') {
+                    messageId = 'feels_wet';
+                }
+            }
+        }
+        // Check if it's scenery (usually immovable)
+        if (target.has(world_model_1.TraitType.SCENERY)) {
+            eventData.immovable = true;
+            if (messageId === 'feels_normal') {
+                messageId = 'immovable_object';
+            }
+        }
+        // Determine touch verb from command
+        const verb = context.command.parsed.structure.verb?.text.toLowerCase() || 'touch';
+        if (messageId === 'feels_normal') {
+            // Use verb-specific messages for normal touches
+            switch (verb) {
+                case 'poke':
+                    messageId = 'poked';
+                    break;
+                case 'prod':
+                    messageId = 'prodded';
+                    break;
+                case 'pat':
+                    messageId = 'patted';
+                    break;
+                case 'stroke':
+                    messageId = 'stroked';
+                    break;
+                case 'feel':
+                    messageId = 'touched_gently';
+                    break;
+                default:
+                    messageId = 'touched';
+            }
+        }
+        // Store computed data in sharedData for report phase
+        sharedData.targetId = target.id;
+        sharedData.targetName = target.name;
+        sharedData.messageId = messageId;
+        sharedData.eventData = eventData;
+    },
+    /**
+     * Generate events when validation fails
+     */
+    blocked(context, result) {
+        const target = context.command.directObject?.entity;
+        return [context.event('if.event.touch_blocked', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: {
+                    ...result.params,
+                    target: target?.name
+                },
+                reason: result.error,
+                targetId: target?.id,
+                targetName: target?.name
+            })];
+    },
+    report(context) {
+        const events = [];
+        const sharedData = getTouchingSharedData(context);
+        // Emit touched event with messageId for text rendering
+        events.push(context.event('if.event.touched', {
+            messageId: `${context.action.id}.${sharedData.messageId || 'touched'}`,
+            params: { target: sharedData.targetName },
+            ...sharedData.eventData
+        }));
+        return events;
+    },
+    group: "sensory"
+};
+//# sourceMappingURL=touching.js.map

package/dist/actions/standard/touching/touching.js.map

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

package/dist/actions/standard/undoing/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Undoing action module exports
+ */
+export { undoingAction } from './undoing';
+export * from './undoing-events';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/standard/undoing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/undoing/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,cAAc,kBAAkB,CAAC"}

package/dist/actions/standard/undoing/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Undoing action module exports
+ */
+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.undoingAction = void 0;
+var undoing_1 = require("./undoing");
+Object.defineProperty(exports, "undoingAction", { enumerable: true, get: function () { return undoing_1.undoingAction; } });
+__exportStar(require("./undoing-events"), exports);
+//# sourceMappingURL=index.js.map

package/dist/actions/standard/undoing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/undoing/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,mDAAiC"}

package/dist/actions/standard/undoing/undoing-events.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Undoing action event types
+ */
+export interface UndoRequestedEventData {
+    timestamp: number;
+}
+export interface UndoCompletedEventData {
+    success: boolean;
+    restoredToTurn?: number;
+    error?: string;
+}
+//# sourceMappingURL=undoing-events.d.ts.map

package/dist/actions/standard/undoing/undoing-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undoing-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/undoing/undoing-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/actions/standard/undoing/undoing-events.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Undoing action event types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=undoing-events.js.map

package/dist/actions/standard/undoing/undoing-events.js.map

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

package/dist/actions/standard/undoing/undoing.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Undoing action - undo the previous turn
+ *
+ * This is a meta action that triggers the engine's undo functionality.
+ * It emits a platform event that the engine processes to restore
+ * the previous game state.
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const undoingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=undoing.d.ts.map

package/dist/actions/standard/undoing/undoing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undoing.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/undoing/undoing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAoC9D,CAAC"}

package/dist/actions/standard/undoing/undoing.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * Undoing action - undo the previous turn
+ *
+ * This is a meta action that triggers the engine's undo functionality.
+ * It emits a platform event that the engine processes to restore
+ * the previous game state.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.undoingAction = void 0;
+const core_1 = require("@sharpee/core");
+const constants_1 = require("../../constants");
+exports.undoingAction = {
+    id: constants_1.IFActions.UNDOING,
+    requiredMessages: [
+        'undo_success',
+        'undo_failed',
+        'nothing_to_undo'
+    ],
+    validate(_context) {
+        // Undo is always valid - the engine will determine if there's anything to undo
+        return { valid: true };
+    },
+    execute(_context) {
+        // No world mutations - undo is handled by the engine
+    },
+    blocked(_context, _result) {
+        // Undo should never be blocked
+        return [];
+    },
+    report(context) {
+        // Emit platform undo requested event
+        // The engine will handle this after turn completion
+        const platformEvent = (0, core_1.createUndoRequestedEvent)();
+        return [platformEvent];
+    },
+    group: "meta",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false
+    }
+};
+//# sourceMappingURL=undoing.js.map

package/dist/actions/standard/undoing/undoing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undoing.js","sourceRoot":"","sources":["../../../../src/actions/standard/undoing/undoing.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAGH,wCAAyE;AACzE,+CAA4C;AAG/B,QAAA,aAAa,GAA0C;IAClE,EAAE,EAAE,qBAAS,CAAC,OAAO;IAErB,gBAAgB,EAAE;QAChB,cAAc;QACd,aAAa;QACb,iBAAiB;KAClB;IAED,QAAQ,CAAC,QAAuB;QAC9B,+EAA+E;QAC/E,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,QAAuB;QAC7B,qDAAqD;IACvD,CAAC;IAED,OAAO,CAAC,QAAuB,EAAE,OAAyB;QACxD,+BAA+B;QAC/B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,CAAC,OAAsB;QAC3B,qCAAqC;QACrC,oDAAoD;QACpD,MAAM,aAAa,GAAG,IAAA,+BAAwB,GAAE,CAAC;QACjD,OAAO,CAAC,aAAa,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,EAAE,MAAM;IAEb,QAAQ,EAAE;QACR,oBAAoB,EAAE,KAAK;QAC3B,sBAAsB,EAAE,KAAK;KAC9B;CACF,CAAC"}

package/dist/actions/standard/unlocking/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Unlocking action module
+ *
+ * Handles unlocking containers and doors with optional key requirements
+ */
+export { unlockingAction } from './unlocking';
+export type { UnlockedEventData, UnlockingErrorData } from './unlocking-events';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/standard/unlocking/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/unlocking/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/actions/standard/unlocking/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Unlocking action module
+ *
+ * Handles unlocking containers and doors with optional key requirements
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unlockingAction = void 0;
+var unlocking_1 = require("./unlocking");
+Object.defineProperty(exports, "unlockingAction", { enumerable: true, get: function () { return unlocking_1.unlockingAction; } });
+//# sourceMappingURL=index.js.map

package/dist/actions/standard/unlocking/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/unlocking/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,yCAA8C;AAArC,4GAAA,eAAe,OAAA"}

package/dist/actions/standard/unlocking/unlocking-events.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Event data types for the unlocking action
+ *
+ * These interfaces define the structure of data emitted by the unlocking action
+ */
+import { EntityId } from '@sharpee/core';
+/**
+ * Data for the 'if.event.unlocked' event
+ *
+ * Emitted when a container or door is successfully unlocked.
+ * Contains information about what was unlocked and with which key.
+ */
+export interface UnlockedEventData {
+    /** ID of the container/door being unlocked */
+    targetId: EntityId;
+    /** Name of the container/door being unlocked */
+    targetName: string;
+    /** ID of the container/door (duplicate for backward compatibility) */
+    containerId: EntityId;
+    /** Name of the container/door (duplicate for backward compatibility) */
+    containerName: string;
+    /** Type information */
+    isContainer?: boolean;
+    isDoor?: boolean;
+    /** Key information */
+    keyId?: EntityId;
+    keyName?: string;
+    requiresKey?: boolean;
+    /** State after unlocking */
+    hasContents?: boolean;
+    contentsCount?: number;
+    contentsIds?: EntityId[];
+    /** Effects */
+    sound?: string;
+    willAutoOpen?: boolean;
+}
+/**
+ * Data for 'action.error' events from unlocking action
+ */
+export interface UnlockingErrorData {
+    /** The specific error reason */
+    reason: 'no_target' | 'not_lockable' | 'no_key' | 'wrong_key' | 'already_unlocked' | 'key_not_held' | 'still_locked' | 'cant_reach';
+    /** Name of the target (when applicable) */
+    item?: string;
+    /** Name of the key (when applicable) */
+    key?: string;
+    /** Additional context for the error */
+    details?: Record<string, any>;
+}
+//# sourceMappingURL=unlocking-events.d.ts.map

package/dist/actions/standard/unlocking/unlocking-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlocking-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/unlocking/unlocking-events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,QAAQ,EAAE,QAAQ,CAAC;IAEnB,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IAEnB,sEAAsE;IACtE,WAAW,EAAE,QAAQ,CAAC;IAEtB,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IAEtB,uBAAuB;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,sBAAsB;IACtB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC;IAEzB,cAAc;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,MAAM,EACF,WAAW,GACX,cAAc,GACd,QAAQ,GACR,WAAW,GACX,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,YAAY,CAAC;IAEjB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B"}

package/dist/actions/standard/unlocking/unlocking-events.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Event data types for the unlocking action
+ *
+ * These interfaces define the structure of data emitted by the unlocking action
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=unlocking-events.js.map

package/dist/actions/standard/unlocking/unlocking-events.js.map

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

package/dist/actions/standard/unlocking/unlocking-messages.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Message constants for the unlocking action
+ *
+ * These constants provide type safety for message IDs within stdlib.
+ * The lang-en-us package uses matching string literals (stable, injected at runtime).
+ */
+export declare const MESSAGES: {
+    readonly NO_TARGET: "no_target";
+    readonly NOT_LOCKABLE: "not_lockable";
+    readonly NO_KEY: "no_key";
+    readonly WRONG_KEY: "wrong_key";
+    readonly ALREADY_UNLOCKED: "already_unlocked";
+    readonly CANT_REACH: "cant_reach";
+    readonly KEY_NOT_HELD: "key_not_held";
+    readonly UNLOCKED: "unlocked";
+    readonly UNLOCKED_WITH: "unlocked_with";
+};
+export type UnlockingMessageId = typeof MESSAGES[keyof typeof MESSAGES];
+//# sourceMappingURL=unlocking-messages.d.ts.map

package/dist/actions/standard/unlocking/unlocking-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlocking-messages.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/unlocking/unlocking-messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;CAaX,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC"}

package/dist/actions/standard/unlocking/unlocking-messages.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MESSAGES = void 0;
+/**
+ * Message constants for the unlocking action
+ *
+ * These constants provide type safety for message IDs within stdlib.
+ * The lang-en-us package uses matching string literals (stable, injected at runtime).
+ */
+exports.MESSAGES = {
+    // Validation failures
+    NO_TARGET: 'no_target',
+    NOT_LOCKABLE: 'not_lockable',
+    NO_KEY: 'no_key',
+    WRONG_KEY: 'wrong_key',
+    ALREADY_UNLOCKED: 'already_unlocked',
+    CANT_REACH: 'cant_reach',
+    KEY_NOT_HELD: 'key_not_held',
+    // Success messages
+    UNLOCKED: 'unlocked',
+    UNLOCKED_WITH: 'unlocked_with',
+};
+//# sourceMappingURL=unlocking-messages.js.map

package/dist/actions/standard/unlocking/unlocking-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlocking-messages.js","sourceRoot":"","sources":["../../../../src/actions/standard/unlocking/unlocking-messages.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACU,QAAA,QAAQ,GAAG;IACtB,sBAAsB;IACtB,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,gBAAgB,EAAE,kBAAkB;IACpC,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;IAE5B,mBAAmB;IACnB,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,eAAe;CACtB,CAAC"}

package/dist/actions/standard/unlocking/unlocking.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Unlocking action - unlocks containers and doors
+ *
+ * This action properly delegates to LockableBehavior for validation
+ * and execution. It follows the three-phase pattern.
+ *
+ * Uses three-phase pattern:
+ * 1. validate: Check if target is lockable and key requirements
+ * 2. execute: Call LockableBehavior.unlock(), store result in sharedData
+ * 3. report: Generate events from sharedData
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const unlockingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=unlocking.d.ts.map

package/dist/actions/standard/unlocking/unlocking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlocking.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/unlocking/unlocking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAmCrD,eAAO,MAAM,eAAe,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA4OhE,CAAC"}