@sharpee/stdlib 0.9.66-beta → 0.9.67-beta

package/actions/standard/examining/examining-messages.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExaminingMessages = void 0;
+/**
+ * Message constants for the examining 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.ExaminingMessages = {
+    // Error messages
+    NO_TARGET: 'no_target',
+    NOT_VISIBLE: 'not_visible',
+    // Success messages
+    EXAMINED: 'examined',
+    EXAMINED_SELF: 'examined_self',
+    EXAMINED_CONTAINER: 'examined_container',
+    EXAMINED_SUPPORTER: 'examined_supporter',
+    EXAMINED_READABLE: 'examined_readable',
+    EXAMINED_SWITCHABLE: 'examined_switchable',
+    EXAMINED_WEARABLE: 'examined_wearable',
+    EXAMINED_DOOR: 'examined_door',
+    NOTHING_SPECIAL: 'nothing_special',
+    DESCRIPTION: 'description',
+    BRIEF_DESCRIPTION: 'brief_description',
+};
+//# sourceMappingURL=examining-messages.js.map

package/actions/standard/examining/examining-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"examining-messages.js","sourceRoot":"","sources":["../../../../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/examining/examining-messages.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACU,QAAA,iBAAiB,GAAG;IAC/B,iBAAiB;IACjB,SAAS,EAAE,WAAW;IACtB,WAAW,EAAE,aAAa;IAE1B,mBAAmB;IACnB,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,eAAe;IAC9B,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,iBAAiB,EAAE,mBAAmB;IACtC,mBAAmB,EAAE,qBAAqB;IAC1C,iBAAiB,EAAE,mBAAmB;IACtC,aAAa,EAAE,eAAe;IAC9B,eAAe,EAAE,iBAAiB;IAClC,WAAW,EAAE,aAAa;IAC1B,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC"}

package/actions/standard/examining/examining.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Examining action - looks at objects in detail
+ *
+ * This is a read-only action that provides detailed information about objects.
+ * It validates visibility but doesn't change state.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check target exists and is visible
+ * 2. execute: No mutations (read-only action)
+ * 3. report: Generate success events with complete entity snapshot
+ * 4. blocked: Generate error events when validation fails
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const examiningAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=examining.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"examining.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/examining/examining.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAUrD,eAAO,MAAM,eAAe,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA0GhE,CAAC"}

package/actions/standard/examining/examining.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * Examining action - looks at objects in detail
+ *
+ * This is a read-only action that provides detailed information about objects.
+ * It validates visibility but doesn't change state.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check target exists and is visible
+ * 2. execute: No mutations (read-only action)
+ * 3. report: Generate success events with complete entity snapshot
+ * 4. blocked: Generate error events when validation fails
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.examiningAction = void 0;
+const constants_1 = require("../../constants");
+const types_1 = require("../../../scope/types");
+const emit_illustrations_1 = require("../../helpers/emit-illustrations");
+const data_builder_types_1 = require("../../data-builder-types");
+// Import our data builder
+const examining_data_1 = require("./examining-data");
+const examining_messages_1 = require("./examining-messages");
+exports.examiningAction = {
+    id: constants_1.IFActions.EXAMINING,
+    // Default scope requirements for this action's slots
+    defaultScope: {
+        target: types_1.ScopeLevel.VISIBLE
+    },
+    requiredMessages: [
+        'no_target',
+        'not_visible',
+        'examined',
+        'examined_self',
+        'examined_container',
+        'examined_supporter',
+        'examined_readable',
+        'examined_switchable',
+        'examined_wearable',
+        'examined_door',
+        'nothing_special',
+        'description',
+        'brief_description'
+    ],
+    validate(context) {
+        const actor = context.player;
+        const noun = context.command.directObject?.entity;
+        // Validate we have a target
+        if (!noun) {
+            return {
+                valid: false,
+                error: examining_messages_1.ExaminingMessages.NO_TARGET
+            };
+        }
+        // Check scope - must be able to see the target (unless examining yourself)
+        if (noun.id !== actor.id) {
+            const scopeCheck = context.requireScope(noun, types_1.ScopeLevel.VISIBLE);
+            if (!scopeCheck.ok) {
+                return scopeCheck.error;
+            }
+        }
+        // Valid - all event data will be built in report()
+        return { valid: true };
+    },
+    execute(context) {
+        // No mutations - examining is a read-only action
+    },
+    report(context) {
+        // report() is only called on success - validation passed
+        const noun = context.command.directObject.entity;
+        // Use data builder to create event data
+        const eventData = (0, data_builder_types_1.buildEventData)(examining_data_1.examiningDataConfig, context);
+        // Get message parameters from the data
+        const { messageId, params, contentsMessage } = (0, examining_data_1.buildExaminingMessageParams)(eventData, noun);
+        // Build events array - emit domain event with messageId for text rendering
+        const examinedEvent = context.event('if.event.examined', {
+            messageId: `${context.action.id}.${messageId}`,
+            params,
+            ...eventData
+        });
+        const events = [examinedEvent];
+        // Emit illustration events for the examined entity (ADR-124)
+        events.push(...(0, emit_illustrations_1.emitIllustrations)(noun, 'on-examine', examinedEvent.id, context));
+        // Add contents message for containers/supporters with visible items
+        if (contentsMessage) {
+            events.push(context.event('if.event.examined', {
+                messageId: `${context.action.id}.${contentsMessage.messageId}`,
+                params: contentsMessage.params,
+                isContentsMessage: true
+            }));
+        }
+        return events;
+    },
+    blocked(context, result) {
+        // blocked() is called when validation fails
+        const noun = context.command.directObject?.entity;
+        return [context.event('if.event.examined', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: { target: noun?.name, ...result.params },
+                reason: result.error,
+                targetId: noun?.id,
+                targetName: noun?.name
+            })];
+    },
+    group: "observation",
+    metadata: {
+        requiresDirectObject: true,
+        requiresIndirectObject: false,
+        directObjectScope: types_1.ScopeLevel.VISIBLE
+    }
+};
+//# sourceMappingURL=examining.js.map

package/actions/standard/examining/examining.js.map

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

package/actions/standard/examining/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Examining action module
+ *
+ * Exports the examining action and its associated event types
+ */
+export { examiningAction } from './examining';
+export type { ExaminedEventData, ExaminingErrorData } from './examining-events';
+//# sourceMappingURL=index.d.ts.map

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

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

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Examining action module
+ *
+ * Exports the examining action and its associated event types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.examiningAction = void 0;
+var examining_1 = require("./examining");
+Object.defineProperty(exports, "examiningAction", { enumerable: true, get: function () { return examining_1.examiningAction; } });
+//# sourceMappingURL=index.js.map

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

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

package/actions/standard/exiting/exiting-events.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Event type definitions for the exiting action
+ */
+import { EntityId } from "../../../src/index";
+/**
+ * Event data for when an actor exits something
+ */
+export interface ExitedEventData {
+    /** Location the actor is exiting from */
+    fromLocation: EntityId;
+    /** Location the actor is exiting to */
+    toLocation: EntityId;
+    /** Preposition used ('out of', 'off', 'from under', etc.) */
+    preposition: string;
+}
+/**
+ * Error data for exiting failures
+ */
+export interface ExitingErrorData {
+    reason: 'already_outside' | 'container_closed' | 'cant_exit' | 'nowhere_to_go';
+    container?: string;
+    place?: string;
+}
+/**
+ * Complete event map for exiting action
+ */
+export interface ExitingEventMap {
+    'if.event.exited': ExitedEventData;
+    'action.success': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+    'action.error': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+}
+//# sourceMappingURL=exiting-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exiting-events.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/exiting/exiting-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,YAAY,EAAE,QAAQ,CAAC;IAEvB,uCAAuC;IACvC,UAAU,EAAE,QAAQ,CAAC;IAErB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,GAAG,WAAW,GAAG,eAAe,CAAC;IAC/E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,eAAe,CAAC;IACnC,gBAAgB,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC9B,CAAC;IACF,cAAc,EAAE;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAC9B,CAAC;CACH"}

package/actions/standard/exiting/exiting-events.js

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

package/actions/standard/exiting/exiting-events.js.map

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

package/actions/standard/exiting/exiting-messages.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Message constants for the exiting action
+ * Used by validate() and blocked() for consistent error messages
+ */
+export declare const ExitingMessages: {
+    readonly NOWHERE_TO_GO: "nowhere_to_go";
+    readonly ALREADY_OUTSIDE: "already_outside";
+    readonly CONTAINER_CLOSED: "container_closed";
+    readonly CANT_EXIT: "cant_exit";
+    readonly EXITED: "exited";
+    readonly EXITED_FROM: "exited_from";
+};
+//# sourceMappingURL=exiting-messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exiting-messages.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/exiting/exiting-messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,eAAe;;;;;;;CASlB,CAAC"}

package/actions/standard/exiting/exiting-messages.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExitingMessages = void 0;
+/**
+ * Message constants for the exiting action
+ * Used by validate() and blocked() for consistent error messages
+ */
+exports.ExitingMessages = {
+    // Validation failures
+    NOWHERE_TO_GO: 'nowhere_to_go',
+    ALREADY_OUTSIDE: 'already_outside',
+    CONTAINER_CLOSED: 'container_closed',
+    CANT_EXIT: 'cant_exit',
+    // Success messages
+    EXITED: 'exited',
+    EXITED_FROM: 'exited_from',
+};
+//# sourceMappingURL=exiting-messages.js.map

package/actions/standard/exiting/exiting-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exiting-messages.js","sourceRoot":"","sources":["../../../../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/exiting/exiting-messages.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,eAAe,GAAG;IAC7B,sBAAsB;IACtB,aAAa,EAAE,eAAe;IAC9B,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IACpC,SAAS,EAAE,WAAW;IACtB,mBAAmB;IACnB,MAAM,EAAE,QAAQ;IAChB,WAAW,EAAE,aAAa;CAClB,CAAC"}

package/actions/standard/exiting/exiting.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Exiting action - exit from containers, supporters, or other enterable objects
+ *
+ * This action handles exiting objects that the actor is currently inside/on.
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const exitingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=exiting.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"exiting.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/exiting/exiting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAA0D,MAAM,sBAAsB,CAAC;AA4BtG,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAgJ9D,CAAC"}

package/actions/standard/exiting/exiting.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Exiting action - exit from containers, supporters, or other enterable objects
+ *
+ * This action handles exiting objects that the actor is currently inside/on.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exitingAction = void 0;
+const world_model_1 = require("../../../src/index.js");
+const constants_1 = require("../../constants");
+const exiting_messages_1 = require("./exiting-messages");
+function getExitingSharedData(context) {
+    return context.sharedData;
+}
+const types_1 = require("../../../scope/types");
+exports.exitingAction = {
+    id: constants_1.IFActions.EXITING,
+    requiredMessages: [
+        'already_outside',
+        'container_closed',
+        'cant_exit',
+        'exited',
+        'exited_from',
+        'nowhere_to_go'
+    ],
+    group: 'movement',
+    validate(context) {
+        const actor = context.player;
+        const currentLocation = context.world.getLocation(actor.id);
+        if (!currentLocation) {
+            return {
+                valid: false,
+                error: exiting_messages_1.ExitingMessages.NOWHERE_TO_GO
+            };
+        }
+        const currentContainer = context.world.getEntity(currentLocation);
+        if (!currentContainer) {
+            return {
+                valid: false,
+                error: exiting_messages_1.ExitingMessages.NOWHERE_TO_GO
+            };
+        }
+        // Check if we're in something we can exit from
+        // Rooms cannot be exited (use GO to move between rooms)
+        const isRoom = currentContainer.has(world_model_1.TraitType.ROOM);
+        if (isRoom) {
+            return {
+                valid: false,
+                error: exiting_messages_1.ExitingMessages.ALREADY_OUTSIDE
+            };
+        }
+        // Find the parent location (where we'll exit to)
+        const parentLocation = context.world.getLocation(currentLocation);
+        if (!parentLocation) {
+            return {
+                valid: false,
+                error: exiting_messages_1.ExitingMessages.NOWHERE_TO_GO
+            };
+        }
+        // Check if container needs to be open to exit using behavior
+        if (currentContainer.has(world_model_1.TraitType.CONTAINER) && currentContainer.has(world_model_1.TraitType.OPENABLE)) {
+            if (!world_model_1.OpenableBehavior.isOpen(currentContainer)) {
+                return {
+                    valid: false,
+                    error: exiting_messages_1.ExitingMessages.CONTAINER_CLOSED,
+                    params: { container: currentContainer.name }
+                };
+            }
+        }
+        return { valid: true };
+    },
+    /**
+     * Execute the exit action - performs mutations only
+     * Assumes validation has already passed
+     */
+    execute(context) {
+        const actor = context.player;
+        const currentLocation = context.world.getLocation(actor.id); // Safe because validate ensures it exists
+        const currentContainer = context.world.getEntity(currentLocation); // Safe because validate ensures it exists
+        const parentLocation = context.world.getLocation(currentLocation); // Safe because validate ensures it exists
+        // Determine preposition based on what we're exiting from
+        let preposition = 'from';
+        if (currentContainer.has(world_model_1.TraitType.CONTAINER)) {
+            preposition = 'out of';
+        }
+        else if (currentContainer.has(world_model_1.TraitType.SUPPORTER)) {
+            preposition = 'off';
+        }
+        // Simply move the actor to the parent location - that's all!
+        context.world.moveEntity(actor.id, parentLocation);
+        // Store state for report phase using sharedData
+        const state = {
+            fromLocation: currentLocation,
+            fromLocationName: currentContainer.name,
+            toLocation: parentLocation,
+            preposition
+        };
+        const sharedData = getExitingSharedData(context);
+        sharedData.exitingState = state;
+    },
+    /**
+     * Report phase - generates events after successful execution
+     * Only called on success path - validation has already passed
+     */
+    report(context) {
+        // Get stored state from execute phase
+        const sharedData = getExitingSharedData(context);
+        const state = sharedData.exitingState;
+        if (!state) {
+            // This shouldn't happen, but handle gracefully
+            return [
+                context.event('if.event.exited', {
+                    messageId: `${context.action.id}.action_failed`,
+                    error: 'Missing state from execute phase'
+                })
+            ];
+        }
+        // Create the EXITED event with messageId for text rendering
+        return [context.event('if.event.exited', {
+                messageId: `${context.action.id}.exited`,
+                params: { place: state.fromLocationName },
+                fromLocation: state.fromLocation,
+                fromLocationName: state.fromLocationName,
+                toLocation: state.toLocation,
+                preposition: state.preposition
+            })];
+    },
+    /**
+     * Generate events when validation fails
+     * Called instead of execute/report when validate returns invalid
+     */
+    blocked(context, result) {
+        return [context.event('if.event.exited', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: result.params || {},
+                reason: result.error
+            })];
+    },
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false,
+        directObjectScope: types_1.ScopeLevel.REACHABLE
+    }
+};
+//# sourceMappingURL=exiting.js.map

package/actions/standard/exiting/exiting.js.map

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

package/actions/standard/exiting/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Exiting action module exports
+ */
+export { exitingAction } from './exiting';
+export type { ExitedEventData, ExitingErrorData, ExitingEventMap } from './exiting-events';
+//# sourceMappingURL=index.d.ts.map

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

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

package/actions/standard/exiting/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Exiting action module exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exitingAction = void 0;
+var exiting_1 = require("./exiting");
+Object.defineProperty(exports, "exitingAction", { enumerable: true, get: function () { return exiting_1.exitingAction; } });
+//# sourceMappingURL=index.js.map

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

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

package/actions/standard/giving/giving-events.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Event type definitions for the giving action
+ * @module
+ */
+export interface GivenEventData {
+    /** ID of the item being given */
+    item: string;
+    /** Name of the item for display */
+    itemName: string;
+    /** ID of the recipient */
+    recipient: string;
+    /** Name of the recipient for display */
+    recipientName: string;
+    /** Whether the gift was accepted */
+    accepted: boolean;
+    /** Reason for refusal if not accepted */
+    refusalReason?: string;
+}
+export interface GivingEventMap {
+    'if.event.given': GivenEventData;
+}
+//# sourceMappingURL=giving-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"giving-events.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/giving/giving-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,cAAc,CAAC;CAClC"}

package/actions/standard/giving/giving-events.js

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

package/actions/standard/giving/giving-events.js.map

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

package/actions/standard/giving/giving.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Giving action - give objects to NPCs or other actors
+ *
+ * This action handles transferring objects from the player to NPCs.
+ * NPCs may accept or refuse items based on their state.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check if item can be given to recipient
+ * 2. execute: Transfer item, store result in sharedData
+ * 3. blocked: Generate events when validation fails
+ * 4. report: Generate success events from sharedData
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const givingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=giving.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"giving.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/giving/giving.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAwBrD,eAAO,MAAM,YAAY,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAiP7D,CAAC"}