@sharpee/stdlib 0.9.109 → 0.9.111

package/actions/standard/pushing/pushing.js

@@ -0,0 +1,303 @@
+"use strict";
+/**
+ * Pushing action - push objects, buttons, or move heavy items
+ *
+ * This action handles pushing objects, which can result in:
+ * - Moving heavy scenery objects
+ * - Activating buttons or switches
+ * - Revealing hidden passages
+ * - General pushing feedback
+ *
+ * Uses four-phase pattern with interceptor support (ADR-118):
+ * 1. validate: preValidate hook → standard checks → postValidate hook
+ * 2. execute: standard mutation → postExecute hook
+ * 3. blocked: onBlocked hook (if validation failed)
+ * 4. report: standard events → postReport hook (additional effects)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pushingAction = void 0;
+const world_model_1 = require("../../../../world-model/index.js");
+const constants_1 = require("../../constants");
+const types_1 = require("../../../scope/types");
+const pushing_types_1 = require("./pushing-types");
+exports.pushingAction = {
+    id: constants_1.IFActions.PUSHING,
+    // Default scope requirements for this action's slots
+    defaultScope: {
+        target: types_1.ScopeLevel.REACHABLE
+    },
+    requiredMessages: [
+        'no_target',
+        'not_visible',
+        'not_reachable',
+        'too_heavy',
+        'wearing_it',
+        'button_pushed',
+        'button_clicks',
+        'switch_toggled',
+        'pushed_direction',
+        'pushed_nudged',
+        'pushed_with_effort',
+        'reveals_passage',
+        'wont_budge',
+        'pushing_does_nothing',
+        'fixed_in_place'
+    ],
+    metadata: {
+        requiresDirectObject: true,
+        requiresIndirectObject: false,
+        directObjectScope: types_1.ScopeLevel.REACHABLE
+    },
+    validate(context) {
+        const actor = context.player;
+        const target = context.command.directObject?.entity;
+        const sharedData = (0, pushing_types_1.getPushingSharedData)(context);
+        // Must have something to push
+        if (!target) {
+            return {
+                valid: false,
+                error: 'no_target'
+            };
+        }
+        // Check for interceptor on the target entity (ADR-118)
+        const interceptorResult = (0, world_model_1.getInterceptorForAction)(target, constants_1.IFActions.PUSHING);
+        const interceptor = interceptorResult?.interceptor;
+        const interceptorData = {
+            targetId: target.id,
+            targetName: target.name
+        };
+        // Store for later phases
+        sharedData.interceptor = interceptor;
+        sharedData.interceptorData = interceptorData;
+        // === PRE-VALIDATE HOOK ===
+        // Called before standard validation - can block early
+        if (interceptor?.preValidate) {
+            const result = interceptor.preValidate(target, context.world, actor.id, interceptorData);
+            if (result !== null) {
+                return {
+                    valid: result.valid,
+                    error: result.error,
+                    params: result.params
+                };
+            }
+        }
+        // Check scope - must be able to reach the target
+        const scopeCheck = context.requireScope(target, types_1.ScopeLevel.REACHABLE);
+        if (!scopeCheck.ok) {
+            return scopeCheck.error;
+        }
+        // Can't push worn items
+        if (target.has(world_model_1.TraitType.WEARABLE)) {
+            const wearableLocation = context.world.getLocation(target.id);
+            if (wearableLocation === actor.id) {
+                return {
+                    valid: false,
+                    error: 'wearing_it'
+                };
+            }
+        }
+        // Check if object is pushable
+        if (!target.has(world_model_1.TraitType.PUSHABLE)) {
+            // Not pushable - check if it's fixed scenery
+            if (target.has(world_model_1.TraitType.SCENERY)) {
+                return {
+                    valid: false,
+                    error: 'fixed_in_place'
+                };
+            }
+            // Regular non-pushable object
+            return {
+                valid: false,
+                error: 'pushing_does_nothing'
+            };
+        }
+        // === POST-VALIDATE HOOK ===
+        // Called after standard validation passes - can add entity-specific conditions
+        if (interceptor?.postValidate) {
+            const result = interceptor.postValidate(target, context.world, actor.id, interceptorData);
+            if (result !== null) {
+                return {
+                    valid: result.valid,
+                    error: result.error,
+                    params: result.params
+                };
+            }
+        }
+        return { valid: true };
+    },
+    /**
+     * Execute the push action - performs mutations only
+     * Assumes validation has already passed
+     */
+    execute(context) {
+        const target = context.command.directObject.entity;
+        const direction = context.command.parsed.extras?.direction;
+        const sharedData = (0, pushing_types_1.getPushingSharedData)(context);
+        // Store basic info
+        sharedData.targetId = target.id;
+        sharedData.targetName = target.name;
+        sharedData.direction = direction;
+        sharedData.messageParams = {};
+        const pushableTrait = target.get(world_model_1.TraitType.PUSHABLE);
+        sharedData.pushType = pushableTrait.pushType;
+        // Handle based on push type
+        switch (pushableTrait.pushType) {
+            case 'button':
+                sharedData.activated = true;
+                // Check if it's also switchable - perform world mutation
+                if (target.has(world_model_1.TraitType.SWITCHABLE)) {
+                    const switchable = target.get(world_model_1.TraitType.SWITCHABLE);
+                    sharedData.willToggle = true;
+                    sharedData.currentState = switchable.isOn;
+                    sharedData.newState = !switchable.isOn;
+                    // Perform the toggle (world mutation)
+                    world_model_1.SwitchableBehavior.toggle(target);
+                    // Choose message based on whether it has BUTTON trait
+                    if (target.has(world_model_1.TraitType.BUTTON)) {
+                        sharedData.messageId = 'button_clicks';
+                    }
+                    else {
+                        sharedData.messageId = 'switch_toggled';
+                    }
+                    sharedData.messageParams.target = target.name;
+                    sharedData.messageParams.newState = sharedData.newState ? 'on' : 'off';
+                }
+                else {
+                    // Non-switchable button
+                    sharedData.messageId = 'button_pushed';
+                    sharedData.messageParams.target = target.name;
+                }
+                // Add push sound if specified
+                if (pushableTrait.pushSound) {
+                    sharedData.sound = pushableTrait.pushSound;
+                }
+                break;
+            case 'heavy':
+                // Heavy objects might require strength
+                if (pushableTrait.requiresStrength) {
+                    sharedData.requiresStrength = pushableTrait.requiresStrength;
+                }
+                if (direction) {
+                    sharedData.moved = true;
+                    sharedData.moveDirection = direction;
+                    sharedData.messageId = 'pushed_with_effort';
+                    sharedData.messageParams.target = target.name;
+                    sharedData.messageParams.direction = direction;
+                }
+                else {
+                    sharedData.moved = false;
+                    sharedData.nudged = true;
+                    sharedData.messageId = 'wont_budge';
+                    sharedData.messageParams.target = target.name;
+                }
+                break;
+            case 'moveable':
+                // Moveable objects can be pushed around
+                if (direction) {
+                    sharedData.moved = true;
+                    sharedData.moveDirection = direction;
+                    // Check if pushing reveals a passage
+                    if (pushableTrait.revealsPassage) {
+                        sharedData.revealsPassage = true;
+                        sharedData.messageId = 'reveals_passage';
+                    }
+                    else {
+                        sharedData.messageId = 'pushed_direction';
+                    }
+                    sharedData.messageParams.target = target.name;
+                    sharedData.messageParams.direction = direction;
+                }
+                else {
+                    sharedData.moved = false;
+                    sharedData.nudged = true;
+                    sharedData.messageId = 'pushed_nudged';
+                    sharedData.messageParams.target = target.name;
+                }
+                // Add push sound if specified
+                if (pushableTrait.pushSound) {
+                    sharedData.sound = pushableTrait.pushSound;
+                }
+                break;
+            default:
+                // Fallback for unknown push types
+                sharedData.messageId = 'pushing_does_nothing';
+                sharedData.messageParams.target = target.name;
+                break;
+        }
+        // === POST-EXECUTE HOOK ===
+        // Called after standard execution - can perform additional mutations
+        const interceptor = sharedData.interceptor;
+        const interceptorData = sharedData.interceptorData || {};
+        if (interceptor?.postExecute) {
+            interceptor.postExecute(target, context.world, context.player.id, interceptorData);
+        }
+    },
+    /**
+     * Generate events when validation fails
+     */
+    blocked(context, result) {
+        const target = context.command.directObject?.entity;
+        const sharedData = (0, pushing_types_1.getPushingSharedData)(context);
+        // === ON-BLOCKED HOOK ===
+        // Called when action is blocked - can provide custom blocked handling
+        const interceptor = sharedData.interceptor;
+        const interceptorData = sharedData.interceptorData || {};
+        if (interceptor?.onBlocked && target && result.error) {
+            const customEffects = interceptor.onBlocked(target, context.world, context.player.id, result.error, interceptorData);
+            if (customEffects !== null) {
+                // Interceptor provided custom blocked effects
+                return customEffects.map(effect => context.event(effect.type, effect.payload));
+            }
+        }
+        // Standard blocked handling
+        return [context.event('if.event.pushed', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: { target: target?.name, ...result.params },
+                reason: result.error,
+                targetId: target?.id,
+                targetName: target?.name
+            })];
+    },
+    /**
+     * Report phase - generates all events after successful execution
+     */
+    report(context) {
+        const events = [];
+        const sharedData = (0, pushing_types_1.getPushingSharedData)(context);
+        const target = context.command.directObject.entity;
+        // Emit pushed event with messageId for text rendering
+        events.push(context.event('if.event.pushed', {
+            messageId: `${context.action.id}.${sharedData.messageId}`,
+            params: sharedData.messageParams,
+            target: sharedData.targetId,
+            targetName: sharedData.targetName,
+            direction: sharedData.direction,
+            pushType: sharedData.pushType,
+            activated: sharedData.activated,
+            willToggle: sharedData.willToggle,
+            currentState: sharedData.currentState,
+            newState: sharedData.newState,
+            sound: sharedData.sound,
+            moved: sharedData.moved,
+            moveDirection: sharedData.moveDirection,
+            nudged: sharedData.nudged,
+            revealsPassage: sharedData.revealsPassage,
+            requiresStrength: sharedData.requiresStrength
+        }));
+        // === POST-REPORT HOOK ===
+        // Called after standard report - can add additional effects
+        const interceptor = sharedData.interceptor;
+        const interceptorData = sharedData.interceptorData || {};
+        if (interceptor?.postReport) {
+            const additionalEffects = interceptor.postReport(target, context.world, context.player.id, interceptorData);
+            // Convert CapabilityEffects to ISemanticEvents
+            for (const effect of additionalEffects) {
+                events.push(context.event(effect.type, effect.payload));
+            }
+        }
+        return events;
+    },
+    group: "device_manipulation"
+};
+//# sourceMappingURL=pushing.js.map

package/actions/standard/pushing/pushing.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/standard/putting/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,cAAc,kBAAkB,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"putting-data.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/standard/putting/putting-data.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAK/E,eAAO,MAAM,YAAY,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAmBnE,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnE,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"putting-data.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee/packages/stdlib/src/actions/standard/putting/putting-data.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,8DAAkE;AAE3D,MAAM,YAAY,GAA+C,CACtE,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;IAEtD,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACrB,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAChD,CAAC;IAED,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAA,sCAAqB,EAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QAC9D,MAAM,EAAE,MAAM,CAAC,IAAI;QACnB,cAAc,EAAE,IAAA,sCAAqB,EAAC,MAAM,EAAE,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;QAClE,MAAM,EAAE,IAAI,CAAC,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC,EAAE;QACnB,WAAW,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,IAAI,IAAI;KAChE,CAAC;AACJ,CAAC,CAAC;AAnBW,QAAA,YAAY,gBAmBvB;AAEW,QAAA,aAAa,GAA8C;IACtE,OAAO,EAAE,oBAAY;IACrB,eAAe,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC;CAC1D,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"putting-events.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/standard/putting/putting-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,WAAW,EAAE,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,EAAE,cAAc,CAAC;IAClC,iBAAiB,EAAE,cAAc,CAAC;CACnC"}

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"putting-messages.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee/packages/stdlib/src/actions/standard/putting/putting-messages.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,eAAe,GAAG;IAC7B,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,eAAe;IAC9B,WAAW,EAAE,aAAa;IAC1B,gBAAgB,EAAE,kBAAkB;IACpC,aAAa,EAAE,eAAe;IAC9B,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,kBAAkB,EAAE,oBAAoB;IACxC,kBAAkB,EAAE,oBAAoB;IACxC,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,gBAAgB;CACxB,CAAC"}

package/actions/standard/putting/putting-types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Type definitions for the putting action
+ *
+ * Provides type-safe access to shared data for multi-object support
+ * and interceptor integration (ADR-118)
+ */
+import { IFEntity, IAddItemResult, IAddItemToSupporterResult, ActionInterceptor, InterceptorSharedData } from "../../../../world-model/index";
+/**
+ * Result of validating/executing a single entity in multi-object command
+ */
+export interface PuttingItemResult {
+    entity: IFEntity;
+    success: boolean;
+    error?: string;
+    errorParams?: Record<string, unknown>;
+    targetPreposition?: 'in' | 'on';
+    putResult?: IAddItemResult | IAddItemToSupporterResult;
+}
+/**
+ * Typed shared data for putting action
+ */
+export interface PuttingSharedData {
+    targetPreposition?: 'in' | 'on';
+    putResult?: IAddItemResult | IAddItemToSupporterResult;
+    /**
+     * Multi-object support: results for each entity
+     * When set, indicates this is a multi-object command
+     */
+    multiObjectResults?: PuttingItemResult[];
+    /** Interceptor found during validate, if any (ADR-118) */
+    interceptor?: ActionInterceptor;
+    /** Shared data for interceptor phases (ADR-118) */
+    interceptorData?: InterceptorSharedData;
+}
+/**
+ * Safely get typed shared data from context
+ */
+export declare function getPuttingSharedData(context: {
+    sharedData: Record<string, any>;
+}): PuttingSharedData;
+//# sourceMappingURL=putting-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"putting-types.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/standard/putting/putting-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAErI;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,QAAQ,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,cAAc,GAAG,yBAAyB,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,SAAS,CAAC,EAAE,cAAc,GAAG,yBAAyB,CAAC;IAEvD;;;OAGG;IACH,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAEzC,0DAA0D;IAC1D,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,mDAAmD;IACnD,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,GAAG,iBAAiB,CAKpG"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"putting-types.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee/packages/stdlib/src/actions/standard/putting/putting-types.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAuCH,oDAKC;AARD;;GAEG;AACH,SAAgB,oBAAoB,CAAC,OAA4C;IAC/E,IAAI,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC1E,OAAO,CAAC,UAAU,GAAG,EAAE,CAAC;IAC1B,CAAC;IACD,OAAO,OAAO,CAAC,UAA+B,CAAC;AACjD,CAAC"}

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

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