@sharpee/stdlib 0.9.109 → 0.9.110

package/actions/standard/looking/looking-data.js

@@ -0,0 +1,277 @@
+"use strict";
+/**
+ * Data builder for looking action
+ *
+ * Centralizes all room snapshot and visibility logic for the looking action.
+ * This separates data structure concerns from business logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listContentsDataConfig = exports.roomDescriptionDataConfig = exports.lookingEventDataConfig = exports.buildListContentsData = exports.buildRoomDescriptionData = exports.buildLookingEventData = void 0;
+exports.determineLookingMessage = determineLookingMessage;
+const world_model_1 = require("../../../../world-model/index.js");
+const snapshot_utils_1 = require("../../base/snapshot-utils");
+/**
+ * Check if a location is dark (needs light but has none).
+ * Delegates to VisibilityBehavior.isDark() as the single source of truth.
+ */
+function checkIfDark(context) {
+    const room = context.world.getContainingRoom(context.player.id);
+    if (!room)
+        return false;
+    return world_model_1.VisibilityBehavior.isDark(room, context.world);
+}
+/**
+ * Build looking action data for the looked event
+ */
+const buildLookingEventData = (context, preState, postState) => {
+    const player = context.player;
+    // Use visibility logic to determine what location to describe
+    const { location, immediateContainer } = world_model_1.VisibilityBehavior.getDescribableLocation(player, context.world);
+    // Get visible items (excluding the room itself and the player)
+    const visible = context.getVisible().filter(e => e.id !== location.id && e.id !== player.id);
+    // Check if dark
+    const isDark = checkIfDark(context);
+    // Create atomic looked event with complete room snapshot
+    const roomSnapshot = (0, snapshot_utils_1.captureRoomSnapshot)(location, context.world, false);
+    const visibleSnapshots = (0, snapshot_utils_1.captureEntitySnapshots)(visible, context.world);
+    // Get identity trait for ID fields (ADR-107 dual-mode)
+    const identity = location.getTrait(world_model_1.IdentityTrait);
+    return {
+        actorId: player.id,
+        // New atomic structure
+        room: roomSnapshot,
+        visibleItems: visibleSnapshots,
+        // Backward compatibility fields
+        locationId: location.id,
+        locationName: location.name,
+        locationDescription: location.description,
+        // ADR-107: Message IDs for localization (take precedence over literals)
+        locationNameId: identity?.nameId,
+        locationDescriptionId: identity?.descriptionId,
+        isDark: isDark,
+        inVehicle: immediateContainer?.name || null,
+        contents: visible.map(entity => ({
+            id: entity.id,
+            name: entity.name,
+            description: entity.description
+        })),
+        timestamp: Date.now()
+    };
+};
+exports.buildLookingEventData = buildLookingEventData;
+/**
+ * Build room description event data
+ */
+const buildRoomDescriptionData = (context, preState, postState) => {
+    // Use visibility logic to determine what location to describe
+    const { location, immediateContainer } = world_model_1.VisibilityBehavior.getDescribableLocation(context.player, context.world);
+    // Get visible items (excluding the room itself and the player)
+    const visible = context.getVisible().filter(e => e.id !== location.id && e.id !== context.player.id);
+    // Create snapshots
+    const roomSnapshot = (0, snapshot_utils_1.captureRoomSnapshot)(location, context.world, false);
+    const visibleSnapshots = (0, snapshot_utils_1.captureEntitySnapshots)(visible, context.world);
+    // Determine if verbose mode
+    // TODO: Wire verbose mode from game-meta state when brief/verbose commands are implemented
+    const verboseMode = true;
+    const firstVisit = true;
+    const isVerbose = verboseMode || firstVisit;
+    // Get identity trait for ID fields (ADR-107 dual-mode)
+    const identity = location.getTrait(world_model_1.IdentityTrait);
+    return {
+        // New atomic structure
+        room: roomSnapshot,
+        visibleItems: visibleSnapshots,
+        // Backward compatibility fields
+        roomId: location.id,
+        roomName: location.name,
+        roomDescription: location.description,
+        // ADR-107: Message IDs for localization (take precedence over literals)
+        roomNameId: identity?.nameId,
+        roomDescriptionId: identity?.descriptionId,
+        includeContents: true,
+        verbose: isVerbose,
+        inVehicle: immediateContainer?.name || null,
+        contents: visible.map(entity => ({
+            id: entity.id,
+            name: entity.name,
+            description: entity.description
+        })),
+        timestamp: Date.now()
+    };
+};
+exports.buildRoomDescriptionData = buildRoomDescriptionData;
+/**
+ * Build list contents event data
+ */
+const buildListContentsData = (context, preState, postState) => {
+    // Use visibility logic to determine what location to describe
+    const { location } = world_model_1.VisibilityBehavior.getDescribableLocation(context.player, context.world);
+    // Get visible items (excluding the room itself and the player)
+    const visible = context.getVisible().filter(e => e.id !== location.id && e.id !== context.player.id);
+    if (visible.length === 0) {
+        return {}; // No list event needed if nothing visible
+    }
+    // Create snapshots
+    const roomSnapshot = (0, snapshot_utils_1.captureRoomSnapshot)(location, context.world, false);
+    const visibleSnapshots = (0, snapshot_utils_1.captureEntitySnapshots)(visible, context.world);
+    // Separate items directly in room from items in containers/supporters
+    const directInRoom = visible.filter(e => {
+        const itemLocation = context.world.getLocation(e.id);
+        return itemLocation === location.id;
+    });
+    // Group direct room items by type
+    const npcs = directInRoom.filter(e => e.hasTrait(world_model_1.TraitType.ACTOR));
+    const containers = directInRoom.filter(e => e.hasTrait(world_model_1.TraitType.CONTAINER) && !e.hasTrait(world_model_1.TraitType.ACTOR));
+    const supporters = directInRoom.filter(e => e.hasTrait(world_model_1.TraitType.SUPPORTER) && !e.hasTrait(world_model_1.TraitType.CONTAINER));
+    const otherItems = directInRoom.filter(e => !e.hasTrait(world_model_1.TraitType.ACTOR) &&
+        !e.hasTrait(world_model_1.TraitType.CONTAINER) &&
+        !e.hasTrait(world_model_1.TraitType.SUPPORTER));
+    // Build container/supporter contents info for separate rendering
+    const openContainerContents = [];
+    // Check each container for visible contents
+    for (const container of containers) {
+        // Skip if container is closed
+        if (container.hasTrait(world_model_1.TraitType.OPENABLE)) {
+            const { OpenableBehavior } = require("../../../../world-model/index.js");
+            if (!OpenableBehavior.isOpen(container))
+                continue;
+        }
+        const contents = context.world.getContents(container.id);
+        if (contents.length > 0) {
+            openContainerContents.push({
+                containerId: container.id,
+                containerName: container.name,
+                preposition: 'in',
+                itemIds: contents.map(e => e.id),
+                itemNames: contents.map(e => e.name)
+            });
+        }
+    }
+    // Check each supporter for visible contents
+    for (const supporter of supporters) {
+        const contents = context.world.getContents(supporter.id);
+        if (contents.length > 0) {
+            openContainerContents.push({
+                containerId: supporter.id,
+                containerName: supporter.name,
+                preposition: 'on',
+                itemIds: contents.map(e => e.id),
+                itemNames: contents.map(e => e.name)
+            });
+        }
+    }
+    return {
+        // New atomic structure (full snapshots)
+        allItems: visibleSnapshots,
+        location: roomSnapshot,
+        // Backward compatibility fields (just IDs as before)
+        items: visible.map(e => e.id),
+        // Direct room items (not inside containers)
+        directItems: directInRoom.map(e => e.id),
+        directItemNames: directInRoom.map(e => e.name),
+        npcs: npcs.map(e => e.id),
+        containers: containers.map(e => e.id),
+        supporters: supporters.map(e => e.id),
+        other: otherItems.map(e => e.id),
+        // Container/supporter contents for separate rendering
+        openContainerContents,
+        context: 'room',
+        locationName: location.name,
+        timestamp: Date.now()
+    };
+};
+exports.buildListContentsData = buildListContentsData;
+/**
+ * Determine the appropriate message ID and parameters for looking
+ */
+function determineLookingMessage(context, isDark) {
+    // Use visibility logic to determine what location to describe
+    const { location, immediateContainer } = world_model_1.VisibilityBehavior.getDescribableLocation(context.player, context.world);
+    const params = {};
+    if (isDark) {
+        return {
+            messageId: 'room_dark',
+            params: { location: location.name }
+        };
+    }
+    // Include name and description for room_description template
+    params.name = location.name;
+    params.description = location.description;
+    params.location = location.name;
+    // If we're in an immediate container (but can see the room), note it
+    if (immediateContainer) {
+        params.inVehicle = immediateContainer.name;
+    }
+    // Check if we're in a closed container/vehicle (can't see the room)
+    // This only happens when getDescribableLocation returns the container itself
+    if (!immediateContainer && location.hasTrait(world_model_1.TraitType.CONTAINER)) {
+        return {
+            messageId: 'in_container',
+            params: {
+                container: location.name,
+                location: location.name
+            }
+        };
+    }
+    else if (!immediateContainer && location.hasTrait(world_model_1.TraitType.SUPPORTER)) {
+        return {
+            messageId: 'on_supporter',
+            params: {
+                supporter: location.name,
+                location: location.name
+            }
+        };
+    }
+    // Check for brief/verbose mode
+    // TODO: Wire verbose mode from game-meta state when brief/verbose commands are implemented
+    const verboseMode = true;
+    const firstVisit = true;
+    let messageId = (!verboseMode && !firstVisit) ? 'room_description_brief' : 'room_description';
+    // Check for visible items
+    const visible = context.getVisible().filter(e => e.id !== location.id && e.id !== context.player.id);
+    // Check command verb for variations
+    const verb = context.command.parsed.structure.verb?.text.toLowerCase() || 'look';
+    const hasDirectObject = (context.command.directObject !== undefined && context.command.directObject !== null) ||
+        (context.command.parsed.structure.directObject !== undefined && context.command.parsed.structure.directObject !== null);
+    // Special handling for examine without object
+    const isExamineSurroundings = verb === 'examine' && !hasDirectObject;
+    if (isExamineSurroundings) {
+        return { messageId: 'examine_surroundings', params };
+    }
+    // Get items directly in the room (not inside containers)
+    const directInRoom = visible.filter(e => {
+        const itemLocation = context.world.getLocation(e.id);
+        return itemLocation === location.id;
+    });
+    // If there are direct room items, include them in params for contents_list
+    // (the action will emit room_description first, then contents_list)
+    if (directInRoom.length > 0) {
+        const itemList = directInRoom.map(e => e.name).join(', ');
+        return {
+            messageId, // room_description or room_description_brief
+            params: {
+                items: itemList,
+                count: directInRoom.length,
+                hasItems: true,
+                ...params
+            }
+        };
+    }
+    return { messageId, params };
+}
+/**
+ * Configuration for looking data builders
+ */
+exports.lookingEventDataConfig = {
+    builder: exports.buildLookingEventData,
+    protectedFields: ['actorId', 'locationId', 'timestamp']
+};
+exports.roomDescriptionDataConfig = {
+    builder: exports.buildRoomDescriptionData,
+    protectedFields: ['roomId', 'timestamp']
+};
+exports.listContentsDataConfig = {
+    builder: exports.buildListContentsData,
+    protectedFields: ['locationName', 'timestamp']
+};
+//# sourceMappingURL=looking-data.js.map

package/actions/standard/looking/looking-data.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"looking-events.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/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/actions/standard/looking/looking-events.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"looking-messages.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/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/actions/standard/looking/looking-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"looking-messages.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee/packages/stdlib/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/actions/standard/looking/looking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"looking.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/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;AAarD,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA+H9D,CAAC"}

package/actions/standard/looking/looking.js

@@ -0,0 +1,127 @@
+"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("../../../../world-model/index.js");
+const constants_1 = require("../../constants");
+const emit_illustrations_1 = require("../../helpers/emit-illustrations");
+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.RoomTrait);
+            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)
+        const lookedEvent = context.event('if.event.looked', lookedEventData);
+        events.push(lookedEvent);
+        // 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));
+        // Emit illustration events for the room (ADR-124)
+        const room = context.world.getContainingRoom(context.player.id);
+        if (room) {
+            events.push(...(0, emit_illustrations_1.emitIllustrations)(room, 'on-enter', lookedEvent.id, context));
+        }
+        // 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/actions/standard/looking/looking.js.map

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"lowering.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee/packages/stdlib/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,WAAW;IAC1B,eAAe,EAAE,iBAAiB;CACnC,CAAC,CAAC"}

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"opening-data.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/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/actions/standard/opening/opening-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opening-data.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee/packages/stdlib/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/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 "../../../../core/index";
+/**
+ * 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/actions/standard/opening/opening-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opening-events.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/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/actions/standard/opening/opening-events.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"opening-messages.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/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/actions/standard/opening/opening-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opening-messages.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee/packages/stdlib/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/actions/standard/opening/opening-types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Type definitions for the opening action's shared data
+ */
+import { IOpenResult } from "../../../../world-model/index";
+/**
+ * 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"opening-types.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/standard/opening/opening-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,UAAU,CAAC,EAAE,WAAW,CAAC;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,IAAI,iBAAiB,CAEnF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,GAAG,iBAAiB,CAE9F"}

package/actions/standard/opening/opening-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opening-types.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee/packages/stdlib/src/actions/standard/opening/opening-types.ts"],"names":[],"mappings":";AAAA;;GAEG;;AA8BH,wCAEC;AAKD,wCAEC;AAZD;;GAEG;AACH,SAAgB,cAAc,CAAC,IAAyB;IACtD,OAAO,YAAY,IAAI,IAAI,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,SAAgB,cAAc,CAAC,OAA4C;IACzE,OAAO,OAAO,CAAC,UAA+B,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"opening.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/standard/opening/opening.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAM/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAoBrD,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA4M9D,CAAC"}