@sharpee/stdlib 0.9.60-beta

package/dist/actions/standard/listening/listening.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * Listening action - listen for sounds in the environment
+ *
+ * This action allows players to listen for sounds in their current location
+ * or from specific objects.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions for listening)
+ * 2. execute: Analyze sounds (no world mutations)
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emit listened event and success message
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listeningAction = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const constants_1 = require("../../constants");
+const scope_1 = require("../../../scope");
+function getListeningSharedData(context) {
+    return context.sharedData;
+}
+/**
+ * Analyzes what sounds can be heard from a target or environment
+ * Shared logic between validate and execute phases
+ */
+function analyzeListening(context) {
+    const target = context.command.directObject?.entity;
+    const eventData = {};
+    const params = {};
+    let messageId;
+    if (target) {
+        eventData.target = target.id;
+        params.target = target.name;
+        // Check if the target has any sound-related properties
+        let hasSound = false;
+        if (target.has(world_model_1.TraitType.SWITCHABLE)) {
+            const switchableTrait = target.get(world_model_1.TraitType.SWITCHABLE);
+            if (switchableTrait.isOn) {
+                hasSound = true;
+                eventData.hasSound = true;
+                eventData.soundType = 'device';
+                messageId = 'device_running';
+            }
+            else {
+                messageId = 'device_off';
+            }
+        }
+        else if (target.has(world_model_1.TraitType.CONTAINER)) {
+            const contents = context.world.getContents(target.id);
+            if (contents.length > 0) {
+                eventData.hasContents = true;
+                eventData.contentCount = contents.length;
+                // Check if any contents are liquid (edible with isDrink)
+                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;
+                });
+                messageId = hasLiquid ? 'liquid_sounds' : 'container_sounds';
+                hasSound = true;
+            }
+            else {
+                messageId = 'no_sound';
+            }
+        }
+        else {
+            messageId = 'no_sound';
+        }
+        // Override with generic message if no specific sound
+        if (!hasSound && !messageId) {
+            messageId = 'listened_to';
+        }
+    }
+    else {
+        // Listening to the general environment
+        eventData.listeningToEnvironment = true;
+        // Check for any active sound sources in the location
+        const location = context.currentLocation;
+        const contents = context.world.getContents(location.id);
+        const soundSources = contents.filter(item => {
+            if (item.has(world_model_1.TraitType.SWITCHABLE)) {
+                const switchableTrait = item.get(world_model_1.TraitType.SWITCHABLE);
+                return switchableTrait.isOn;
+            }
+            return false;
+        });
+        if (soundSources.length > 0) {
+            eventData.soundSources = soundSources.map(s => s.id);
+            params.devices = soundSources.map(s => s.name).join(', ');
+            messageId = 'active_devices';
+        }
+        else {
+            messageId = 'silence';
+        }
+        eventData.roomId = location.id;
+    }
+    return {
+        messageId: messageId,
+        params,
+        eventData
+    };
+}
+exports.listeningAction = {
+    id: constants_1.IFActions.LISTENING,
+    requiredMessages: [
+        'not_visible',
+        'silence',
+        'ambient_sounds',
+        'active_devices',
+        'no_sound',
+        'device_running',
+        'device_off',
+        'container_sounds',
+        'liquid_sounds',
+        'listened_to',
+        'listened_environment'
+    ],
+    group: "sensory",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false,
+        directObjectScope: scope_1.ScopeLevel.AWARE
+    },
+    validate(context) {
+        // Listening always succeeds - no preconditions
+        return { valid: true };
+    },
+    execute(context) {
+        // Listening has NO world mutations - it's a sensory action
+        // Analyze sounds and store in sharedData for report phase
+        const analysis = analyzeListening(context);
+        const sharedData = getListeningSharedData(context);
+        sharedData.messageId = analysis.messageId;
+        sharedData.params = analysis.params;
+        sharedData.eventData = analysis.eventData;
+    },
+    blocked(context, result) {
+        // Listening always succeeds, but include blocked for consistency
+        const target = context.command.directObject?.entity;
+        return [context.event('if.event.listen_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 = getListeningSharedData(context);
+        // Emit listened event with messageId for text rendering
+        events.push(context.event('if.event.listened', {
+            messageId: `${context.action.id}.${sharedData.messageId || 'silence'}`,
+            params: sharedData.params,
+            ...sharedData.eventData
+        }));
+        return events;
+    }
+};
+//# sourceMappingURL=listening.js.map

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

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

package/dist/actions/standard/lock-shared.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Shared logic for locking and unlocking actions
+ */
+import { ActionContext, ValidationResult } from '../enhanced-types';
+import { IFEntity } from '@sharpee/world-model';
+import { ISemanticEvent } from '@sharpee/core';
+/**
+ * Shared message constants for lock/unlock validation
+ * These are message IDs, not English strings - lang-en-us resolves them
+ */
+export declare const LOCK_MESSAGES: {
+    NO_KEY: string;
+    KEY_NOT_HELD: string;
+    WRONG_KEY: string;
+};
+export interface LockAnalysis {
+    target: IFEntity;
+    key?: IFEntity;
+    isContainer: boolean;
+    isDoor: boolean;
+    requiresKey: boolean;
+    keyHeld: boolean;
+}
+/**
+ * Analyzes the lock/unlock context to determine object types and key requirements
+ */
+export declare function analyzeLockContext(context: ActionContext, target: IFEntity, key?: IFEntity): LockAnalysis;
+/**
+ * Validates key requirements for locking/unlocking
+ * Returns validation result with appropriate error if validation fails
+ */
+export declare function validateKeyRequirements(context: ActionContext, target: IFEntity, key: IFEntity | undefined, isLocking: boolean): ValidationResult | null;
+/**
+ * Creates error events based on lock/unlock result
+ */
+export declare function createLockErrorEvent(context: ActionContext, result: any, target: IFEntity, key: IFEntity | undefined, isLocking: boolean): ISemanticEvent | null;
+/**
+ * Determines the appropriate message based on lock/unlock action
+ */
+export declare function determineLockMessage(isLocking: boolean, hasKey: boolean): string;
+//# sourceMappingURL=lock-shared.d.ts.map

package/dist/actions/standard/lock-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock-shared.d.ts","sourceRoot":"","sources":["../../../src/actions/standard/lock-shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAiD,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;CAIzB,CAAC;AAEF,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,QAAQ,CAAC;IACjB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,WAAW,EAAE,OAAO,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,QAAQ,EAChB,GAAG,CAAC,EAAE,QAAQ,GACb,YAAY,CAkBd;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,QAAQ,GAAG,SAAS,EACzB,SAAS,EAAE,OAAO,GACjB,gBAAgB,GAAG,IAAI,CAyCzB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,QAAQ,EAChB,GAAG,EAAE,QAAQ,GAAG,SAAS,EACzB,SAAS,EAAE,OAAO,GACjB,cAAc,GAAG,IAAI,CA2DvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,OAAO,EAClB,MAAM,EAAE,OAAO,GACd,MAAM,CAMR"}

package/dist/actions/standard/lock-shared.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Shared logic for locking and unlocking actions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOCK_MESSAGES = void 0;
+exports.analyzeLockContext = analyzeLockContext;
+exports.validateKeyRequirements = validateKeyRequirements;
+exports.createLockErrorEvent = createLockErrorEvent;
+exports.determineLockMessage = determineLockMessage;
+const world_model_1 = require("@sharpee/world-model");
+/**
+ * Shared message constants for lock/unlock validation
+ * These are message IDs, not English strings - lang-en-us resolves them
+ */
+exports.LOCK_MESSAGES = {
+    NO_KEY: 'no_key',
+    KEY_NOT_HELD: 'key_not_held',
+    WRONG_KEY: 'wrong_key',
+};
+/**
+ * Analyzes the lock/unlock context to determine object types and key requirements
+ */
+function analyzeLockContext(context, target, key) {
+    const actor = context.player;
+    const requiresKey = world_model_1.LockableBehavior.requiresKey(target);
+    let keyHeld = false;
+    if (key) {
+        const keyLocation = context.world.getLocation(key.id);
+        keyHeld = keyLocation === actor.id;
+    }
+    return {
+        target,
+        key,
+        isContainer: target.has(world_model_1.TraitType.CONTAINER),
+        isDoor: target.has(world_model_1.TraitType.DOOR),
+        requiresKey,
+        keyHeld
+    };
+}
+/**
+ * Validates key requirements for locking/unlocking
+ * Returns validation result with appropriate error if validation fails
+ */
+function validateKeyRequirements(context, target, key, isLocking) {
+    if (!world_model_1.LockableBehavior.requiresKey(target)) {
+        return null; // No key required, validation passes
+    }
+    // Key is required but not provided
+    if (!key) {
+        return {
+            valid: false,
+            error: exports.LOCK_MESSAGES.NO_KEY
+        };
+    }
+    // Check if player has the key
+    const actor = context.player;
+    const keyLocation = context.world.getLocation(key.id);
+    if (keyLocation !== actor.id) {
+        return {
+            valid: false,
+            error: exports.LOCK_MESSAGES.KEY_NOT_HELD,
+            params: { key: key.name }
+        };
+    }
+    // Check if it's the right key
+    const canUseKey = isLocking
+        ? world_model_1.LockableBehavior.canLockWith(target, key.id)
+        : world_model_1.LockableBehavior.canUnlockWith(target, key.id);
+    if (!canUseKey) {
+        return {
+            valid: false,
+            error: exports.LOCK_MESSAGES.WRONG_KEY,
+            params: {
+                key: key.name,
+                item: target.name
+            }
+        };
+    }
+    return null; // All key validations pass
+}
+/**
+ * Creates error events based on lock/unlock result
+ */
+function createLockErrorEvent(context, result, target, key, isLocking) {
+    const actionId = context.action.id;
+    if (isLocking) {
+        if (result.alreadyLocked) {
+            return context.event('action.error', {
+                actionId,
+                messageId: 'already_locked',
+                reason: 'already_locked',
+                params: { item: target.name }
+            });
+        }
+        if (result.notClosed) {
+            return context.event('action.error', {
+                actionId,
+                messageId: 'not_closed',
+                reason: 'not_closed',
+                params: { item: target.name }
+            });
+        }
+    }
+    else {
+        if (result.alreadyUnlocked) {
+            return context.event('action.error', {
+                actionId,
+                messageId: 'already_unlocked',
+                reason: 'already_unlocked',
+                params: { item: target.name }
+            });
+        }
+    }
+    // Common errors for both
+    if (result.noKey) {
+        return context.event('action.error', {
+            actionId,
+            messageId: 'no_key',
+            reason: 'no_key'
+        });
+    }
+    if (result.wrongKey) {
+        return context.event('action.error', {
+            actionId,
+            messageId: 'wrong_key',
+            reason: 'wrong_key',
+            params: {
+                key: key?.name || 'key',
+                item: target.name
+            }
+        });
+    }
+    // Fallback error
+    return context.event('action.error', {
+        actionId,
+        messageId: isLocking ? 'cannot_lock' : 'cannot_unlock',
+        reason: isLocking ? 'cannot_lock' : 'cannot_unlock',
+        params: { item: target.name }
+    });
+}
+/**
+ * Determines the appropriate message based on lock/unlock action
+ */
+function determineLockMessage(isLocking, hasKey) {
+    if (isLocking) {
+        return hasKey ? 'locked_with' : 'locked';
+    }
+    else {
+        return hasKey ? 'unlocked_with' : 'unlocked';
+    }
+}
+//# sourceMappingURL=lock-shared.js.map

package/dist/actions/standard/lock-shared.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Locking action module
+ *
+ * Handles locking containers and doors with optional key requirements
+ */
+export { lockingAction } from './locking';
+export type { LockedEventData, LockingErrorData } from './locking-events';
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +1,41 @@
+/**
+ * Event data types for the locking action
+ *
+ * These interfaces define the structure of data emitted by the locking action
+ */
+import { EntityId } from '@sharpee/core';
+/**
+ * Data for the 'if.event.locked' event
+ *
+ * Emitted when a container or door is successfully locked.
+ * Contains information about what was locked and with which key.
+ */
+export interface LockedEventData {
+    /** ID of the container/door being locked */
+    targetId: EntityId;
+    /** Name of the container/door being locked */
+    targetName: string;
+    /** ID of the key used (if any) */
+    keyId?: EntityId;
+    /** Name of the key used (if any) */
+    keyName?: string;
+    /** Type information */
+    isContainer?: boolean;
+    isDoor?: boolean;
+    /** Sound effect (if configured) */
+    sound?: string;
+}
+/**
+ * Data for 'action.error' events from locking action
+ */
+export interface LockingErrorData {
+    /** The specific error reason */
+    reason: 'no_target' | 'not_lockable' | 'no_key' | 'wrong_key' | 'already_locked' | 'not_closed' | 'key_not_held' | '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=locking-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locking-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/locking/locking-events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,4CAA4C;IAC5C,QAAQ,EAAE,QAAQ,CAAC;IAEnB,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IAEnB,kCAAkC;IAClC,KAAK,CAAC,EAAE,QAAQ,CAAC;IAEjB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,uBAAuB;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,EACF,WAAW,GACX,cAAc,GACd,QAAQ,GACR,WAAW,GACX,gBAAgB,GAChB,YAAY,GACZ,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/locking/locking-events.js

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

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * Message constants for the locking 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_LOCKED: "already_locked";
+    readonly NOT_CLOSED: "not_closed";
+    readonly CANT_REACH: "cant_reach";
+    readonly KEY_NOT_HELD: "key_not_held";
+    readonly LOCKED: "locked";
+    readonly LOCKED_WITH: "locked_with";
+};
+export type LockingMessageId = typeof MESSAGES[keyof typeof MESSAGES];
+//# sourceMappingURL=locking-messages.d.ts.map

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

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

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

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MESSAGES = void 0;
+/**
+ * Message constants for the locking 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_LOCKED: 'already_locked',
+    NOT_CLOSED: 'not_closed',
+    CANT_REACH: 'cant_reach',
+    KEY_NOT_HELD: 'key_not_held',
+    // Success messages
+    LOCKED: 'locked',
+    LOCKED_WITH: 'locked_with',
+};
+//# sourceMappingURL=locking-messages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"locking-messages.js","sourceRoot":"","sources":["../../../../src/actions/standard/locking/locking-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,cAAc,EAAE,gBAAgB;IAChC,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,YAAY,EAAE,cAAc;IAE5B,mBAAmB;IACnB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;CAClB,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Locking action - locks 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.lock(), store result in sharedData
+ * 3. report: Generate events from sharedData
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const lockingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=locking.d.ts.map

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

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