@sharpee/stdlib 0.9.60-beta

package/dist/actions/standard/quitting/quitting.js

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * Quitting action - quit the game
+ *
+ * This action emits a platform event that will be processed after turn completion.
+ * The engine will handle any necessary confirmations through its quit hook.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions)
+ * 2. execute: Analyze quit context (no world mutations)
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emit quit events
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.quittingAction = void 0;
+const core_1 = require("@sharpee/core");
+const constants_1 = require("../../constants");
+function getQuittingSharedData(context) {
+    return context.sharedData;
+}
+/**
+ * Analyzes quit context - shared between execute and any other phase that needs it
+ */
+function analyzeQuitContext(context) {
+    const gameData = context.world.getCapability('sharedData') || {};
+    const hasUnsavedProgress = (gameData.moves || 0) > (gameData.lastSaveMove || 0);
+    const score = gameData.score || 0;
+    const maxScore = gameData.maxScore || 0;
+    const moves = gameData.moves || 0;
+    const nearComplete = maxScore > 0 && (score / maxScore) > 0.8;
+    const forceQuit = context.command.parsed.extras?.force ||
+        context.command.parsed.extras?.now ||
+        context.command.parsed.action === 'exit';
+    const quitContext = {
+        score,
+        moves,
+        hasUnsavedChanges: hasUnsavedProgress,
+        force: forceQuit,
+        stats: {
+            maxScore,
+            nearComplete,
+            playTime: gameData.playTime || 0,
+            achievements: gameData.achievements || []
+        }
+    };
+    const eventData = {
+        timestamp: Date.now(),
+        hasUnsavedChanges: hasUnsavedProgress,
+        force: forceQuit,
+        score,
+        moves
+    };
+    return { quitContext, eventData, forceQuit, hasUnsavedProgress };
+}
+exports.quittingAction = {
+    id: constants_1.IFActions.QUITTING,
+    requiredMessages: [
+        // Query messages
+        'quit_confirm_query',
+        'quit_save_query',
+        'quit_unsaved_query',
+        // Status messages
+        'quit_requested',
+        'game_ending'
+    ],
+    validate(context) {
+        // Quitting is always valid - no preconditions
+        return { valid: true };
+    },
+    execute(context) {
+        // Quitting has NO world mutations
+        // Analyze quit context and store in sharedData for report phase
+        const analysis = analyzeQuitContext(context);
+        const sharedData = getQuittingSharedData(context);
+        sharedData.quitContext = analysis.quitContext;
+        sharedData.eventData = analysis.eventData;
+        sharedData.forceQuit = analysis.forceQuit;
+        sharedData.hasUnsavedProgress = analysis.hasUnsavedProgress;
+    },
+    blocked(context, result) {
+        // Quitting always succeeds, but include blocked for consistency
+        return [context.event('if.event.quit_blocked', {
+                messageId: `if.action.quitting.${result.error}`,
+                params: result.params || {},
+                blocked: true,
+                reason: result.error
+            })];
+    },
+    report(context) {
+        const events = [];
+        const sharedData = getQuittingSharedData(context);
+        if (!sharedData.quitContext || !sharedData.eventData) {
+            return events;
+        }
+        // Emit platform quit requested event
+        const platformEvent = (0, core_1.createQuitRequestedEvent)(sharedData.quitContext);
+        events.push(platformEvent);
+        // Emit client.query event for quit confirmation
+        events.push(context.event('client.query', {
+            queryId: `quit_${Date.now()}`,
+            prompt: 'Are you sure you want to quit?',
+            source: 'system',
+            type: 'multiple_choice',
+            messageId: 'quit_confirm_query',
+            options: ['quit', 'cancel'],
+            context: sharedData.quitContext
+        }));
+        // Emit quit_requested notification
+        events.push(context.event('if.event.quit_requested', sharedData.eventData));
+        // If not force quit and there are unsaved changes, add hint to the quit_requested event
+        // The hint is already conveyed via hasUnsavedChanges in the event data
+        return events;
+    },
+    group: "meta",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false
+    }
+};
+//# sourceMappingURL=quitting.js.map

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * Raising Action (ADR-090 Capability Dispatch)
+ *
+ * This action dispatches to trait behaviors instead of having fixed semantics.
+ * Entities that can be raised declare the 'if.action.raising' capability
+ * and register a behavior to handle it.
+ *
+ * Examples: basket elevator, drawbridge, blinds, levers
+ */
+/**
+ * Raising action - dispatches to capability behaviors.
+ *
+ * Usage:
+ * 1. Create a trait that declares `static capabilities = ['if.action.raising']`
+ * 2. Create a behavior implementing CapabilityBehavior
+ * 3. Register the behavior with registerCapabilityBehavior()
+ * 4. Add the trait to your entity
+ */
+export declare const raisingAction: import("../..").Action & {
+    metadata: import("../../..").ActionMetadata;
+};
+//# sourceMappingURL=raising.d.ts.map

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

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

package/dist/actions/standard/raising/raising.js

@@ -0,0 +1,30 @@
+"use strict";
+/**
+ * Raising Action (ADR-090 Capability Dispatch)
+ *
+ * This action dispatches to trait behaviors instead of having fixed semantics.
+ * Entities that can be raised declare the 'if.action.raising' capability
+ * and register a behavior to handle it.
+ *
+ * Examples: basket elevator, drawbridge, blinds, levers
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.raisingAction = void 0;
+const capability_dispatch_1 = require("../../capability-dispatch");
+const constants_1 = require("../../constants");
+/**
+ * Raising action - dispatches to capability behaviors.
+ *
+ * Usage:
+ * 1. Create a trait that declares `static capabilities = ['if.action.raising']`
+ * 2. Create a behavior implementing CapabilityBehavior
+ * 3. Register the behavior with registerCapabilityBehavior()
+ * 4. Add the trait to your entity
+ */
+exports.raisingAction = (0, capability_dispatch_1.createCapabilityDispatchAction)({
+    actionId: constants_1.IFActions.RAISING,
+    group: 'manipulation',
+    noTargetError: 'if.raise.no_target',
+    cantDoThatError: 'if.raise.cant_raise_that'
+});
+//# sourceMappingURL=raising.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Reading action module
+ * @module
+ */
+export { reading } from './reading';
+export type { ReadingEventData, ReadingEventMap } from './reading-events';
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/reading/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,qCAAoC;AAA3B,kGAAA,OAAO,OAAA"}

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

@@ -0,0 +1,35 @@
+/**
+ * Event definitions for the reading action
+ * @module
+ */
+import { ISemanticEvent } from '@sharpee/core';
+/**
+ * Data for reading events
+ */
+export interface ReadingEventData {
+    /** ID of the entity being read */
+    targetId: string;
+    /** Name of the entity being read */
+    targetName: string;
+    /** The text content */
+    text: string;
+    /** Type of readable (book, sign, note, etc.) */
+    readableType?: string;
+    /** Whether this has been read before */
+    hasBeenRead?: boolean;
+    /** Current page (for multi-page items) */
+    currentPage?: number;
+    /** Total pages (for multi-page items) */
+    totalPages?: number;
+}
+/**
+ * Create a reading event
+ */
+export declare function createReadingEvent(data: ReadingEventData): ISemanticEvent;
+/**
+ * Reading event type map
+ */
+export interface ReadingEventMap {
+    'if.event.read': ReadingEventData;
+}
+//# sourceMappingURL=reading-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reading-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/reading/reading-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,cAAc,CAUzE;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,eAAe,EAAE,gBAAgB,CAAC;CACnC"}

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

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Event definitions for the reading action
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReadingEvent = createReadingEvent;
+/**
+ * Create a reading event
+ */
+function createReadingEvent(data) {
+    return {
+        id: `${Date.now()}-read`,
+        type: 'if.event.read',
+        timestamp: Date.now(),
+        data: { ...data },
+        entities: {
+            target: data.targetId
+        }
+    };
+}
+//# sourceMappingURL=reading-events.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reading-events.js","sourceRoot":"","sources":["../../../../src/actions/standard/reading/reading-events.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AA2BH,gDAUC;AAbD;;GAEG;AACH,SAAgB,kBAAkB,CAAC,IAAsB;IACvD,OAAO;QACL,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO;QACxB,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,IAAI,EAAE,EAAE,GAAG,IAAI,EAA6B;QAC5C,QAAQ,EAAE;YACR,MAAM,EAAE,IAAI,CAAC,QAAQ;SACtB;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,17 @@
+/**
+ * Reading action - handles reading text from readable entities
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check target exists and is readable
+ * 2. execute: Mark as read, compute text (mutation)
+ * 3. blocked: Generate events when validation fails
+ * 4. report: Generate success events
+ *
+ * Supports implicit take for portable readable items (books, notes).
+ * Scenery items (inscriptions, signs) can be read without taking.
+ *
+ * @module
+ */
+import { Action } from '../../enhanced-types';
+export declare const reading: Action;
+//# sourceMappingURL=reading.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reading.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/reading/reading.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAiC/E,eAAO,MAAM,OAAO,EAAE,MAqKrB,CAAC"}

package/dist/actions/standard/reading/reading.js

@@ -0,0 +1,176 @@
+"use strict";
+/**
+ * Reading action - handles reading text from readable entities
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check target exists and is readable
+ * 2. execute: Mark as read, compute text (mutation)
+ * 3. blocked: Generate events when validation fails
+ * 4. report: Generate success events
+ *
+ * Supports implicit take for portable readable items (books, notes).
+ * Scenery items (inscriptions, signs) can be read without taking.
+ *
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reading = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const reading_events_1 = require("./reading-events");
+function getReadingSharedData(context) {
+    return context.sharedData;
+}
+/**
+ * Reading action implementation
+ *
+ * Handles:
+ * - Reading books, notes, signs, inscriptions
+ * - Multi-page books
+ * - Language/ability requirements
+ * - Tracking what has been read
+ * - Implicit take for portable items
+ */
+const types_1 = require("../../../scope/types");
+exports.reading = {
+    id: 'if.action.reading',
+    // Default scope requirements for this action's slots
+    defaultScope: {
+        target: types_1.ScopeLevel.REACHABLE // REACHABLE allows implicit take
+    },
+    // ADR-104: Implicit inference requirements
+    targetRequirements: {
+        trait: world_model_1.TraitType.READABLE,
+        description: 'readable'
+    },
+    // Reading typically requires holding the item (books, notes, etc.)
+    // Inscriptions/signs don't need taking - they're scenery (handled in validate)
+    requiresHolding: true,
+    validate(context) {
+        const { directObject } = context.command;
+        // Require a direct object
+        if (!directObject?.entity) {
+            return {
+                valid: false,
+                error: 'what_to_read'
+            };
+        }
+        const target = directObject.entity;
+        // Check scope - must be able to see the target
+        const scopeCheck = context.requireScope(target, types_1.ScopeLevel.VISIBLE);
+        if (!scopeCheck.ok) {
+            return scopeCheck.error;
+        }
+        // Check if entity has readable trait
+        const readable = target.get(world_model_1.TraitType.READABLE);
+        if (!readable) {
+            return {
+                valid: false,
+                error: 'not_readable',
+                params: { item: String(target.attributes.name || 'that') }
+            };
+        }
+        // Check if currently readable
+        if (readable.isReadable === false) {
+            return {
+                valid: false,
+                error: 'cannot_read_now',
+                params: {
+                    item: String(target.attributes.name || 'that'),
+                    reason: readable.cannotReadMessage || 'cannot_read_now'
+                }
+            };
+        }
+        // Implicit take for portable items (not scenery)
+        // Scenery items (inscriptions, signs on walls) can be read without taking
+        if (!target.has(world_model_1.TraitType.SCENERY)) {
+            const carryCheck = context.requireCarriedOrImplicitTake(target);
+            if (!carryCheck.ok) {
+                return carryCheck.error;
+            }
+        }
+        // Check ability requirements
+        if (readable.requiresAbility && !readable.requiredAbility) {
+            // If ability is required but player doesn't have it
+            // TODO: Check if player has the required ability
+            // For now, we'll assume they do if requiredAbility is set
+        }
+        return { valid: true };
+    },
+    execute(context) {
+        const { directObject } = context.command;
+        const target = directObject.entity;
+        const readable = target.get(world_model_1.TraitType.READABLE);
+        const sharedData = getReadingSharedData(context);
+        // Mark as read (world mutation)
+        readable.hasBeenRead = true;
+        // Build event data
+        const eventData = {
+            targetId: target.id,
+            targetName: String(target.attributes.name || 'something'),
+            text: readable.text,
+            readableType: readable.readableType || 'text',
+            hasBeenRead: true
+        };
+        // Handle multi-page items
+        if (readable.pageContent && readable.currentPage) {
+            eventData.currentPage = readable.currentPage;
+            eventData.totalPages = readable.pages || readable.pageContent.length;
+            eventData.text = readable.pageContent[readable.currentPage - 1];
+        }
+        // Create the reading event
+        const readEvent = (0, reading_events_1.createReadingEvent)(eventData);
+        // Determine message based on type
+        let messageId = 'read_text';
+        if (readable.readableType === 'book') {
+            messageId = readable.pageContent ? 'read_book_page' : 'read_book';
+        }
+        else if (readable.readableType === 'sign') {
+            messageId = 'read_sign';
+        }
+        else if (readable.readableType === 'inscription') {
+            messageId = 'read_inscription';
+        }
+        const params = {
+            item: String(target.attributes.name || 'something'),
+            text: eventData.text
+        };
+        if (eventData.currentPage) {
+            params.currentPage = eventData.currentPage;
+            params.totalPages = eventData.totalPages;
+        }
+        // Store in sharedData for report phase
+        sharedData.readEvent = readEvent;
+        sharedData.messageId = messageId;
+        sharedData.params = params;
+    },
+    blocked(context, result) {
+        const target = context.command.directObject?.entity;
+        return [context.event('if.event.read', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: { item: target?.name, ...result.params },
+                reason: result.error,
+                targetId: target?.id,
+                targetName: target?.name
+            })];
+    },
+    report(context) {
+        const sharedData = getReadingSharedData(context);
+        const events = [];
+        // Prepend any implicit take events (from requireCarriedOrImplicitTake)
+        if (context.sharedData.implicitTakeEvents) {
+            events.push(...context.sharedData.implicitTakeEvents);
+        }
+        // Emit read event with messageId for text rendering
+        const target = context.command.directObject?.entity;
+        events.push(context.event('if.event.read', {
+            messageId: `${context.action.id}.${sharedData.messageId || 'read_text'}`,
+            params: sharedData.params || {},
+            targetId: target?.id,
+            targetName: String(target?.attributes.name || 'something'),
+            text: sharedData.params?.text
+        }));
+        return events;
+    }
+};
+//# sourceMappingURL=reading.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Removing action module
+ * @module
+ */
+export { removingAction } from './removing';
+//# sourceMappingURL=index.d.ts.map

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

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

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

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Removing action module
+ * @module
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removingAction = void 0;
+var removing_1 = require("./removing");
+Object.defineProperty(exports, "removingAction", { enumerable: true, get: function () { return removing_1.removingAction; } });
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,7 @@
+/**
+ * Data builder for removing action
+ */
+import { ActionDataBuilder, ActionDataConfig } from '../../data-builder-types';
+export declare const buildRemovedData: ActionDataBuilder<Record<string, unknown>>;
+export declare const removedDataConfig: ActionDataConfig<Record<string, unknown>>;
+//# sourceMappingURL=removing-data.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"removing-data.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/removing/removing-data.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAK/E,eAAO,MAAM,gBAAgB,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBvE,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGvE,CAAC"}

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

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Data builder for removing action
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removedDataConfig = exports.buildRemovedData = void 0;
+const snapshot_utils_1 = require("../../base/snapshot-utils");
+const buildRemovedData = (context) => {
+    const item = context.command.directObject?.entity;
+    const source = context.command.indirectObject?.entity;
+    const actor = context.player;
+    if (!item) {
+        return { item: 'nothing' };
+    }
+    return {
+        item: item.name,
+        itemSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(item, context.world, true),
+        actorSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(actor, context.world, false),
+        sourceSnapshot: source ? (0, snapshot_utils_1.captureEntitySnapshot)(source, context.world, true) : undefined,
+        itemId: item.id,
+        fromLocation: source?.name || 'somewhere'
+    };
+};
+exports.buildRemovedData = buildRemovedData;
+exports.removedDataConfig = {
+    builder: exports.buildRemovedData,
+    protectedFields: ['item', 'itemId']
+};
+//# sourceMappingURL=removing-data.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"removing-data.js","sourceRoot":"","sources":["../../../../src/actions/standard/removing/removing-data.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,8DAAkE;AAE3D,MAAM,gBAAgB,GAA+C,CAC1E,OAAsB,EACG,EAAE;IAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAE7B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAA,sCAAqB,EAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QAC9D,aAAa,EAAE,IAAA,sCAAqB,EAAC,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;QACjE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC,IAAA,sCAAqB,EAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;QACvF,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,YAAY,EAAE,MAAM,EAAE,IAAI,IAAI,WAAW;KAC1C,CAAC;AACJ,CAAC,CAAC;AAnBW,QAAA,gBAAgB,oBAmB3B;AAEW,QAAA,iBAAiB,GAA8C;IAC1E,OAAO,EAAE,wBAAgB;IACzB,eAAe,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;CACpC,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Event type definitions for the removing action
+ * @module
+ */
+export { TakenEventData as RemovedEventData } from '../taking/taking-events';
+export interface RemovingEventMap {
+    'if.event.taken': import('../taking/taking-events').TakenEventData;
+}
+//# sourceMappingURL=removing-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"removing-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/removing/removing-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,IAAI,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,OAAO,yBAAyB,EAAE,cAAc,CAAC;CACpE"}

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

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

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * Message constants for the removing action
+ * Used by validate() and blocked() for consistent error messages
+ */
+export declare const RemovingMessages: {
+    readonly NO_TARGET: "no_target";
+    readonly NO_SOURCE: "no_source";
+    readonly NOT_IN_CONTAINER: "not_in_container";
+    readonly NOT_ON_SURFACE: "not_on_surface";
+    readonly CONTAINER_CLOSED: "container_closed";
+    readonly REMOVED_FROM: "removed_from";
+    readonly REMOVED_FROM_SURFACE: "removed_from_surface";
+    readonly CANT_REACH: "cant_reach";
+    readonly ALREADY_HAVE: "already_have";
+    readonly CANNOT_TAKE: "cannot_take";
+    readonly CANT_REMOVE: "cant_remove";
+    readonly TOO_HEAVY: "too_heavy";
+    readonly CONTAINER_FULL: "container_full";
+    readonly CANT_TAKE: "cant_take";
+    readonly NOTHING_TO_REMOVE: "nothing_to_remove";
+};
+//# sourceMappingURL=removing-messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"removing-messages.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/removing/removing-messages.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;CAgBnB,CAAC"}