@sharpee/stdlib 0.9.60-beta

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

@@ -0,0 +1,50 @@
+/**
+ * Event type definitions for the looking action
+ * @module
+ */
+export interface LookedEventData {
+    /** ID of the actor looking */
+    actorId: string;
+    /** ID of the location being looked at */
+    locationId: string;
+    /** Name of the location for display */
+    locationName: string;
+    /** Whether the location is dark */
+    isDark: boolean;
+    /** Timestamp of when the look occurred */
+    timestamp: number;
+}
+export interface RoomDescriptionEventData {
+    /** ID of the room being described */
+    roomId: string;
+    /** Whether to include contents in description */
+    includeContents: boolean;
+    /** Whether to use verbose description */
+    verbose: boolean;
+    /** Timestamp of description */
+    timestamp: number;
+}
+export interface ListContentsEventData {
+    /** IDs of all visible items */
+    items: string[];
+    /** Names of all visible items */
+    itemNames: string[];
+    /** IDs of visible NPCs */
+    npcs: string[];
+    /** IDs of visible containers */
+    containers: string[];
+    /** IDs of visible supporters */
+    supporters: string[];
+    /** IDs of other visible items */
+    other: string[];
+    /** Context of the listing (e.g., 'room') */
+    context: string;
+    /** Timestamp of listing */
+    timestamp: number;
+}
+export interface LookingEventMap {
+    'if.event.looked': LookedEventData;
+    'if.event.room.description': RoomDescriptionEventData;
+    'if.event.list.contents': ListContentsEventData;
+}
+//# sourceMappingURL=looking-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"looking-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/looking/looking-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,eAAe,EAAE,OAAO,CAAC;IACzB,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iCAAiC;IACjC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,gCAAgC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,gCAAgC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iCAAiC;IACjC,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,eAAe,CAAC;IACnC,2BAA2B,EAAE,wBAAwB,CAAC;IACtD,wBAAwB,EAAE,qBAAqB,CAAC;CACjD"}

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

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Event type definitions for the looking action
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=looking-events.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * Message constants for the looking 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 LookingMessages: {
+    readonly ROOM_DESCRIPTION: "room_description";
+    readonly ROOM_DESCRIPTION_BRIEF: "room_description_brief";
+    readonly ROOM_DARK: "room_dark";
+    readonly CONTENTS_LIST: "contents_list";
+    readonly NOTHING_SPECIAL: "nothing_special";
+    readonly IN_CONTAINER: "in_container";
+    readonly ON_SUPPORTER: "on_supporter";
+    readonly CANT_SEE_IN_DARK: "cant_see_in_dark";
+    readonly LOOK_AROUND: "look_around";
+    readonly EXAMINE_SURROUNDINGS: "examine_surroundings";
+};
+export type LookingMessageId = typeof LookingMessages[keyof typeof LookingMessages];
+//# sourceMappingURL=looking-messages.d.ts.map

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

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

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LookingMessages = void 0;
+/**
+ * Message constants for the looking 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.LookingMessages = {
+    // Success messages
+    ROOM_DESCRIPTION: 'room_description',
+    ROOM_DESCRIPTION_BRIEF: 'room_description_brief',
+    ROOM_DARK: 'room_dark',
+    CONTENTS_LIST: 'contents_list',
+    NOTHING_SPECIAL: 'nothing_special',
+    IN_CONTAINER: 'in_container',
+    ON_SUPPORTER: 'on_supporter',
+    CANT_SEE_IN_DARK: 'cant_see_in_dark',
+    LOOK_AROUND: 'look_around',
+    EXAMINE_SURROUNDINGS: 'examine_surroundings',
+};
+//# sourceMappingURL=looking-messages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"looking-messages.js","sourceRoot":"","sources":["../../../../src/actions/standard/looking/looking-messages.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACU,QAAA,eAAe,GAAG;IAC7B,mBAAmB;IACnB,gBAAgB,EAAE,kBAAkB;IACpC,sBAAsB,EAAE,wBAAwB;IAChD,SAAS,EAAE,WAAW;IACtB,aAAa,EAAE,eAAe;IAC9B,eAAe,EAAE,iBAAiB;IAClC,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,gBAAgB,EAAE,kBAAkB;IACpC,WAAW,EAAE,aAAa;IAC1B,oBAAoB,EAAE,sBAAsB;CACpC,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Looking action - Provides description of current location and visible items
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always valid (basic sensory action)
+ * 2. execute: Mark room as visited (only mutation)
+ * 3. report: Generate success events with complete state snapshots
+ * 4. blocked: Generate error events (never called since looking always valid)
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const lookingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=looking.d.ts.map

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

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

package/dist/actions/standard/looking/looking.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Looking action - Provides description of current location and visible items
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always valid (basic sensory action)
+ * 2. execute: Mark room as visited (only mutation)
+ * 3. report: Generate success events with complete state snapshots
+ * 4. blocked: Generate error events (never called since looking always valid)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookingAction = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const constants_1 = require("../../constants");
+const data_builder_types_1 = require("../../data-builder-types");
+const looking_data_1 = require("./looking-data");
+exports.lookingAction = {
+    id: constants_1.IFActions.LOOKING,
+    requiredMessages: [
+        'room_description',
+        'room_description_brief',
+        'room_dark',
+        'contents_list',
+        'nothing_special',
+        'in_container',
+        'on_supporter',
+        'cant_see_in_dark',
+        'look_around',
+        'examine_surroundings'
+    ],
+    validate(context) {
+        // Looking is always valid - it's a basic sensory action
+        return { valid: true };
+    },
+    execute(context) {
+        // Only mutation: mark room as visited
+        const location = context.currentLocation;
+        const room = context.world.getContainingRoom(context.player.id);
+        if (room && room.hasTrait(world_model_1.TraitType.ROOM)) {
+            const roomTrait = room.getTrait(world_model_1.TraitType.ROOM);
+            if (roomTrait && !roomTrait.visited) {
+                roomTrait.visited = true;
+            }
+        }
+        // No events returned - they're generated in report()
+    },
+    report(context) {
+        // report() is only called on success - looking always succeeds
+        const events = [];
+        // Build looked event data
+        const lookedEventData = (0, data_builder_types_1.buildEventData)(looking_data_1.lookingEventDataConfig, context);
+        // Determine message and params
+        const isDark = lookedEventData.isDark;
+        const { messageId, params } = (0, looking_data_1.determineLookingMessage)(context, isDark);
+        // If dark, emit looked event with dark messageId and return early
+        if (isDark) {
+            events.push(context.event('if.event.looked', {
+                messageId: `${context.action.id}.${messageId}`,
+                params,
+                ...lookedEventData
+            }));
+            return events;
+        }
+        // Emit looked event as domain event (no messageId - specialized handler handles room description)
+        events.push(context.event('if.event.looked', lookedEventData));
+        // Build and emit room description event (specialized handler renders this)
+        const roomDescData = (0, data_builder_types_1.buildEventData)(looking_data_1.roomDescriptionDataConfig, context);
+        events.push(context.event('if.event.room.description', roomDescData));
+        // Build list contents data
+        const listData = (0, data_builder_types_1.buildEventData)(looking_data_1.listContentsDataConfig, context);
+        // Emit contents_list if there are direct items in the room
+        if (params.hasItems) {
+            events.push(context.event('if.event.list.contents', {
+                messageId: `${context.action.id}.contents_list`,
+                params,
+                ...listData
+            }));
+        }
+        // Emit messages for container/supporter contents
+        const openContainerContents = listData.openContainerContents;
+        if (openContainerContents && openContainerContents.length > 0) {
+            for (const containerInfo of openContainerContents) {
+                const contentsMessageId = containerInfo.preposition === 'in'
+                    ? 'container_contents'
+                    : 'surface_contents';
+                const containerKey = containerInfo.preposition === 'in' ? 'container' : 'surface';
+                events.push(context.event('if.event.list.contents', {
+                    messageId: `${context.action.id}.${contentsMessageId}`,
+                    params: {
+                        [containerKey]: containerInfo.containerName,
+                        items: containerInfo.itemNames.join(', ')
+                    },
+                    containerId: containerInfo.containerId,
+                    containerName: containerInfo.containerName,
+                    preposition: containerInfo.preposition,
+                    itemIds: containerInfo.itemIds,
+                    itemNames: containerInfo.itemNames
+                }));
+            }
+        }
+        return events;
+    },
+    blocked(context, result) {
+        // blocked() is called when validation fails
+        // Looking always succeeds, so this should never be called
+        return [context.event('if.event.looked', {
+                blocked: true,
+                reason: result.error,
+                messageId: `${context.action.id}.${result.error}`,
+                params: result.params,
+                actorId: context.player.id
+            })];
+    },
+    group: "observation",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false
+    }
+};
+//# sourceMappingURL=looking.js.map

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

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

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

@@ -0,0 +1,2 @@
+export { loweringAction } from './lowering';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/lowering/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

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

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loweringAction = void 0;
+var lowering_1 = require("./lowering");
+Object.defineProperty(exports, "loweringAction", { enumerable: true, get: function () { return lowering_1.loweringAction; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/lowering/index.ts"],"names":[],"mappings":";;;AAAA,uCAA4C;AAAnC,0GAAA,cAAc,OAAA"}

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

@@ -0,0 +1,46 @@
+/**
+ * Lowering Action (ADR-090 Capability Dispatch)
+ *
+ * This action dispatches to trait behaviors instead of having fixed semantics.
+ * Entities that can be lowered declare the 'if.action.lowering' capability
+ * and register a behavior to handle it.
+ *
+ * Examples: basket elevator, drawbridge, blinds, levers
+ */
+/**
+ * Lowering action - dispatches to capability behaviors.
+ *
+ * Usage:
+ * 1. Create a trait that declares `static capabilities = ['if.action.lowering']`
+ * 2. Create a behavior implementing CapabilityBehavior
+ * 3. Register the behavior with registerCapabilityBehavior()
+ * 4. Add the trait to your entity
+ *
+ * @example
+ * ```typescript
+ * // In trait:
+ * class BasketElevatorTrait implements ITrait {
+ *   static readonly capabilities = ['if.action.lowering', 'if.action.raising'];
+ *   // ...
+ * }
+ *
+ * // In behavior:
+ * const BasketLoweringBehavior: CapabilityBehavior = {
+ *   validate(entity, world, actorId) { ... },
+ *   execute(entity, world, actorId) { ... },
+ *   report(entity, world, actorId) { ... },
+ *   blocked(entity, world, actorId, error) { ... }
+ * };
+ *
+ * // Registration:
+ * registerCapabilityBehavior(
+ *   BasketElevatorTrait.type,
+ *   'if.action.lowering',
+ *   BasketLoweringBehavior
+ * );
+ * ```
+ */
+export declare const loweringAction: import("../..").Action & {
+    metadata: import("../../..").ActionMetadata;
+};
+//# sourceMappingURL=lowering.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lowering.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/lowering/lowering.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,cAAc;;CAKzB,CAAC"}

package/dist/actions/standard/lowering/lowering.js

@@ -0,0 +1,54 @@
+"use strict";
+/**
+ * Lowering Action (ADR-090 Capability Dispatch)
+ *
+ * This action dispatches to trait behaviors instead of having fixed semantics.
+ * Entities that can be lowered declare the 'if.action.lowering' capability
+ * and register a behavior to handle it.
+ *
+ * Examples: basket elevator, drawbridge, blinds, levers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loweringAction = void 0;
+const capability_dispatch_1 = require("../../capability-dispatch");
+const constants_1 = require("../../constants");
+/**
+ * Lowering action - dispatches to capability behaviors.
+ *
+ * Usage:
+ * 1. Create a trait that declares `static capabilities = ['if.action.lowering']`
+ * 2. Create a behavior implementing CapabilityBehavior
+ * 3. Register the behavior with registerCapabilityBehavior()
+ * 4. Add the trait to your entity
+ *
+ * @example
+ * ```typescript
+ * // In trait:
+ * class BasketElevatorTrait implements ITrait {
+ *   static readonly capabilities = ['if.action.lowering', 'if.action.raising'];
+ *   // ...
+ * }
+ *
+ * // In behavior:
+ * const BasketLoweringBehavior: CapabilityBehavior = {
+ *   validate(entity, world, actorId) { ... },
+ *   execute(entity, world, actorId) { ... },
+ *   report(entity, world, actorId) { ... },
+ *   blocked(entity, world, actorId, error) { ... }
+ * };
+ *
+ * // Registration:
+ * registerCapabilityBehavior(
+ *   BasketElevatorTrait.type,
+ *   'if.action.lowering',
+ *   BasketLoweringBehavior
+ * );
+ * ```
+ */
+exports.loweringAction = (0, capability_dispatch_1.createCapabilityDispatchAction)({
+    actionId: constants_1.IFActions.LOWERING,
+    group: 'manipulation',
+    noTargetError: 'if.lower.no_target',
+    cantDoThatError: 'if.lower.cant_lower_that'
+});
+//# sourceMappingURL=lowering.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lowering.js","sourceRoot":"","sources":["../../../../src/actions/standard/lowering/lowering.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,mEAA2E;AAC3E,+CAA4C;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACU,QAAA,cAAc,GAAG,IAAA,oDAA8B,EAAC;IAC3D,QAAQ,EAAE,qBAAS,CAAC,QAAQ;IAC5B,KAAK,EAAE,cAAc;IACrB,aAAa,EAAE,oBAAoB;IACnC,eAAe,EAAE,0BAA0B;CAC5C,CAAC,CAAC"}

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

@@ -0,0 +1,8 @@
+/**
+ * Opening action module
+ *
+ * Handles opening containers and doors
+ */
+export { openingAction } from './opening';
+export type { OpenedEventData, OpeningErrorData } from './opening-events';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/opening/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/opening/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Opening action module
+ *
+ * Handles opening containers and doors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openingAction = void 0;
+var opening_1 = require("./opening");
+Object.defineProperty(exports, "openingAction", { enumerable: true, get: function () { return opening_1.openingAction; } });
+//# sourceMappingURL=index.js.map

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

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

package/dist/actions/standard/opening/opening-data.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Data builder for opening action
+ *
+ * Following atomic event principles - minimal data per event
+ */
+import { ActionDataBuilder, ActionDataConfig } from '../../data-builder-types';
+import { OpenedEventData } from './opening-events';
+export declare const buildOpenedData: ActionDataBuilder<OpenedEventData>;
+export declare const openedDataConfig: ActionDataConfig<OpenedEventData>;
+//# sourceMappingURL=opening-data.d.ts.map

package/dist/actions/standard/opening/opening-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opening-data.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/opening/opening-data.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE/E,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,eAAO,MAAM,eAAe,EAAE,iBAAiB,CAAC,eAAe,CAe9D,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,gBAAgB,CAAC,eAAe,CAG9D,CAAC"}

package/dist/actions/standard/opening/opening-data.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Data builder for opening action
+ *
+ * Following atomic event principles - minimal data per event
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.openedDataConfig = exports.buildOpenedData = void 0;
+const buildOpenedData = (context) => {
+    const noun = context.command.directObject?.entity;
+    if (!noun) {
+        return {
+            targetId: '',
+            targetName: 'nothing'
+        };
+    }
+    return {
+        targetId: noun.id,
+        targetName: noun.name
+    };
+};
+exports.buildOpenedData = buildOpenedData;
+exports.openedDataConfig = {
+    builder: exports.buildOpenedData,
+    protectedFields: ['targetId', 'targetName']
+};
+//# sourceMappingURL=opening-data.js.map

package/dist/actions/standard/opening/opening-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opening-data.js","sourceRoot":"","sources":["../../../../src/actions/standard/opening/opening-data.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAMI,MAAM,eAAe,GAAuC,CACjE,OAAsB,EACL,EAAE;IACnB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;IAClD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,SAAS;SACtB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,EAAE;QACjB,UAAU,EAAE,IAAI,CAAC,IAAI;KACtB,CAAC;AACJ,CAAC,CAAC;AAfW,QAAA,eAAe,mBAe1B;AAEW,QAAA,gBAAgB,GAAsC;IACjE,OAAO,EAAE,uBAAe;IACxB,eAAe,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;CAC5C,CAAC"}

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

@@ -0,0 +1,63 @@
+/**
+ * Event data types for the opening action
+ *
+ * These interfaces define the structure of data emitted by the opening action.
+ * Following atomic event principles - each event represents one discrete fact.
+ */
+import { EntityId } from '@sharpee/core';
+/**
+ * Data for the 'if.event.opened' event
+ *
+ * Emitted when a container or door is successfully opened.
+ * This is the atomic fact of the state change from closed to open.
+ */
+export interface OpenedEventData {
+    /** ID of the entity that was opened */
+    targetId: EntityId;
+    /** Name of the entity that was opened */
+    targetName: string;
+}
+/**
+ * Data for the 'if.event.revealed' event
+ *
+ * Emitted when a container is opened to list all revealed contents.
+ * Items can be any entity type (objects, scenery, etc.)
+ */
+export interface RevealedEventData {
+    /** ID of the container that was opened */
+    containerId: EntityId;
+    /** Name of the container (for context) */
+    containerName: string;
+    /** List of revealed items with their message IDs for display */
+    items: Array<{
+        entityId: EntityId;
+        messageId: string;
+    }>;
+}
+/**
+ * Data for the 'if.event.exit_revealed' event
+ *
+ * Emitted when opening a door reveals a new exit/passage.
+ */
+export interface ExitRevealedEventData {
+    /** The direction of the revealed exit */
+    direction: string;
+    /** ID of the room the exit leads from */
+    fromRoomId: EntityId;
+    /** ID of the room the exit leads to */
+    toRoomId: EntityId;
+    /** ID of the door that was opened */
+    doorId: EntityId;
+}
+/**
+ * Data for 'action.error' events from opening action
+ */
+export interface OpeningErrorData {
+    /** The specific error reason */
+    reason: 'no_target' | 'not_openable' | 'already_open' | 'locked' | 'cant_reach';
+    /** Name of the target (when applicable) */
+    item?: string;
+    /** Additional context for the error */
+    details?: Record<string, any>;
+}
+//# sourceMappingURL=opening-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opening-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/opening/opening-events.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,QAAQ,EAAE,QAAQ,CAAC;IAEnB,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,WAAW,EAAE,QAAQ,CAAC;IAEtB,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IAEtB,gEAAgE;IAChE,KAAK,EAAE,KAAK,CAAC;QACX,QAAQ,EAAE,QAAQ,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAElB,yCAAyC;IACzC,UAAU,EAAE,QAAQ,CAAC;IAErB,uCAAuC;IACvC,QAAQ,EAAE,QAAQ,CAAC;IAEnB,qCAAqC;IACrC,MAAM,EAAE,QAAQ,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gCAAgC;IAChC,MAAM,EACF,WAAW,GACX,cAAc,GACd,cAAc,GACd,QAAQ,GACR,YAAY,CAAC;IAEjB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B"}

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

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Event data types for the opening action
+ *
+ * These interfaces define the structure of data emitted by the opening action.
+ * Following atomic event principles - each event represents one discrete fact.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=opening-events.js.map

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

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

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

@@ -0,0 +1,19 @@
+/**
+ * Message constants for the opening 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 OpeningMessages: {
+    readonly NO_TARGET: "no_target";
+    readonly NOT_OPENABLE: "not_openable";
+    readonly ALREADY_OPEN: "already_open";
+    readonly LOCKED: "locked";
+    readonly CANT_REACH: "cant_reach";
+    readonly CANNOT_OPEN: "cannot_open";
+    readonly OPENED: "opened";
+    readonly REVEALING: "revealing";
+    readonly ITS_EMPTY: "its_empty";
+};
+export type OpeningMessageId = typeof OpeningMessages[keyof typeof OpeningMessages];
+//# sourceMappingURL=opening-messages.d.ts.map

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

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

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpeningMessages = void 0;
+/**
+ * Message constants for the opening 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.OpeningMessages = {
+    // Error messages
+    NO_TARGET: 'no_target',
+    NOT_OPENABLE: 'not_openable',
+    ALREADY_OPEN: 'already_open',
+    LOCKED: 'locked',
+    CANT_REACH: 'cant_reach',
+    CANNOT_OPEN: 'cannot_open',
+    // Success messages
+    OPENED: 'opened',
+    REVEALING: 'revealing',
+    ITS_EMPTY: 'its_empty',
+};
+//# sourceMappingURL=opening-messages.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opening-messages.js","sourceRoot":"","sources":["../../../../src/actions/standard/opening/opening-messages.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACU,QAAA,eAAe,GAAG;IAC7B,iBAAiB;IACjB,SAAS,EAAE,WAAW;IACtB,YAAY,EAAE,cAAc;IAC5B,YAAY,EAAE,cAAc;IAC5B,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE,YAAY;IACxB,WAAW,EAAE,aAAa;IAE1B,mBAAmB;IACnB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,WAAW;IACtB,SAAS,EAAE,WAAW;CACd,CAAC"}

package/dist/actions/standard/opening/opening-types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Type definitions for the opening action's shared data
+ */
+import { IOpenResult } from '@sharpee/world-model';
+/**
+ * Data shared between execute and report phases of the opening action
+ */
+export interface OpeningSharedData {
+    /**
+     * Result from the OpenableBehavior.open() call
+     * Contains success status, custom messages, and other metadata
+     */
+    openResult?: IOpenResult;
+    /**
+     * Whether this is the first time opening this object
+     * Used for special first-time reveal messages
+     */
+    isFirstOpen?: boolean;
+    /**
+     * Custom message to use instead of default
+     * Can come from the entity's properties
+     */
+    customMessage?: string;
+}
+/**
+ * Type guard to check if sharedData contains opening data
+ */
+export declare function hasOpeningData(data: Record<string, any>): data is OpeningSharedData;
+/**
+ * Helper to get typed opening data from context
+ */
+export declare function getOpeningData(context: {
+    sharedData: Record<string, any>;
+}): OpeningSharedData;
+//# sourceMappingURL=opening-types.d.ts.map