@sharpee/stdlib 0.9.60-beta

package/dist/actions/standard/saving/saving.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Saving action - save game state
+ *
+ * This is a meta action that triggers game save functionality.
+ * It emits a platform event that the engine will process after turn completion.
+ *
+ * Four-phase pattern:
+ * 1. validate: Check if save is allowed, validate save name
+ * 2. execute: Analyze save context, store in sharedData (no world mutations)
+ * 3. blocked: Handle validation failures
+ * 4. report: Emit platform event and notifications
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.savingAction = void 0;
+const core_1 = require("@sharpee/core");
+const constants_1 = require("../../constants");
+/**
+ * Analyze save context from game state
+ */
+function analyzeSaveContext(context, saveName) {
+    // Get game state
+    const sharedData = context.world.getCapability('sharedData') || {};
+    const score = sharedData.score || 0;
+    const moves = sharedData.moves || 0;
+    const turnCount = sharedData.turnCount || 0;
+    // Check if this is a quick save or auto save
+    const isQuickSave = saveName === 'quicksave' || context.command.parsed.extras?.quick;
+    const isAutoSave = context.command.parsed.extras?.auto;
+    // Build save context
+    const saveContext = {
+        saveName: saveName !== 'default' ? saveName : undefined,
+        autosave: isAutoSave,
+        timestamp: Date.now(),
+        metadata: {
+            score,
+            moves,
+            turnCount,
+            quickSave: isQuickSave
+        }
+    };
+    // Build event data
+    const eventData = {
+        saveName,
+        timestamp: saveContext.timestamp,
+        metadata: {
+            score,
+            moves,
+            turnCount,
+            quickSave: isQuickSave
+        }
+    };
+    return {
+        saveName,
+        isQuickSave,
+        isAutoSave,
+        score,
+        moves,
+        turnCount,
+        saveContext,
+        eventData
+    };
+}
+exports.savingAction = {
+    id: constants_1.IFActions.SAVING,
+    requiredMessages: [
+        'game_saved',
+        'game_saved_as',
+        'save_successful',
+        'save_slot',
+        'overwrite_save',
+        'save_details',
+        'quick_save',
+        'auto_save',
+        'save_failed',
+        'no_save_slots',
+        'invalid_save_name',
+        'save_not_allowed',
+        'save_in_progress',
+        'confirm_overwrite',
+        'save_reminder',
+        'saved_locally',
+        'saved_to_cloud',
+        'save_exported'
+    ],
+    validate(context) {
+        // Extract save slot or name if provided
+        const saveName = context.command.parsed.extras?.name ||
+            context.command.parsed.extras?.slot ||
+            context.command.indirectObject?.parsed?.text ||
+            'default';
+        // Get game state info
+        const sharedData = context.world.getCapability('sharedData') || {};
+        // Check save restrictions
+        const saveRestrictions = sharedData.saveRestrictions || {};
+        if (saveRestrictions.disabled) {
+            return {
+                valid: false,
+                error: 'save_not_allowed'
+            };
+        }
+        if (saveRestrictions.inProgress) {
+            return {
+                valid: false,
+                error: 'save_in_progress'
+            };
+        }
+        // Check if save name is valid
+        if (saveName.length > 50 || /[<>:"/\\|?*]/.test(saveName)) {
+            return {
+                valid: false,
+                error: 'invalid_save_name'
+            };
+        }
+        return { valid: true };
+    },
+    execute(context) {
+        // Extract save slot or name if provided
+        const saveName = context.command.parsed.extras?.name ||
+            context.command.parsed.extras?.slot ||
+            context.command.directObject?.parsed?.text ||
+            'default';
+        // Analyze save context and store in sharedData
+        const data = analyzeSaveContext(context, saveName);
+        Object.assign(context.sharedData, data);
+    },
+    blocked(context, result) {
+        return [context.event('if.event.save_blocked', {
+                messageId: `if.action.saving.${result.error}`,
+                params: result.params || {},
+                blocked: true,
+                reason: result.error
+            })];
+    },
+    report(context) {
+        const events = [];
+        const data = context.sharedData;
+        // Emit platform save requested event
+        // The engine will handle this after turn completion
+        const platformEvent = (0, core_1.createSaveRequestedEvent)(data.saveContext);
+        events.push(platformEvent);
+        // Emit the save requested event
+        events.push(context.event('if.event.save_requested', data.eventData));
+        return events;
+    },
+    group: "meta",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false
+    }
+};
+//# sourceMappingURL=saving.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Scoring action module exports
+ */
+export { scoringAction } from './scoring';
+export type { ScoreDisplayedEventData, ScoringEventMap } from './scoring-events';
+//# sourceMappingURL=index.d.ts.map

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

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

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

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

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * Event type definitions for the scoring action
+ */
+/**
+ * Event data for when score is displayed
+ * Uses domain event pattern with embedded messageId (ADR-097)
+ */
+export interface ScoreDisplayedEventData {
+    /** Message ID for text-service lookup */
+    messageId?: string;
+    /** Parameters for message template substitution */
+    params?: Record<string, any>;
+    /** Current score */
+    score?: number;
+    /** Maximum possible score */
+    maxScore?: number;
+    /** Number of moves/turns taken */
+    moves?: number;
+    /** Percentage of completion (if maxScore > 0) */
+    percentage?: number;
+    /** Player's rank based on score */
+    rank?: string;
+    /** List of achievements earned */
+    achievements?: string[];
+    /** Current game progress state */
+    progress?: 'early_game' | 'mid_game' | 'late_game' | 'game_complete';
+    /** Whether scoring is enabled */
+    enabled?: boolean;
+    /** Whether this is a blocked/error case */
+    blocked?: boolean;
+    /** Reason for block (if blocked) */
+    reason?: string;
+    /** Whether achievements should be displayed */
+    hasAchievements?: boolean;
+    /** Progress message ID */
+    progressMessage?: string;
+}
+/**
+ * Complete event map for scoring action
+ */
+export interface ScoringEventMap {
+    'if.event.score_displayed': ScoreDisplayedEventData;
+}
+//# sourceMappingURL=scoring-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scoring-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/scoring/scoring-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAG7B,oBAAoB;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,mCAAmC;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,kCAAkC;IAClC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,WAAW,GAAG,eAAe,CAAC;IAErE,iCAAiC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,+CAA+C;IAC/C,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,0BAA0B;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,0BAA0B,EAAE,uBAAuB,CAAC;CACrD"}

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

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

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * Scoring action - displays the player's current score (ADR-085)
+ *
+ * This is a meta action that shows game progress information
+ * without changing the world state.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always valid (but may return "no scoring" message)
+ * 2. execute: Compute score data (no world mutations)
+ * 3. blocked: Handle validation failures
+ * 4. report: Emit score events
+ *
+ * Scoring capability can be:
+ * - Not registered: Show "no scoring" message
+ * - Registered but disabled (enabled: false): Show funny "no scoring" message
+ * - Registered and enabled: Show score/rank
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const scoringAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=scoring.d.ts.map

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

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

package/dist/actions/standard/scoring/scoring.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Scoring action - displays the player's current score (ADR-085)
+ *
+ * This is a meta action that shows game progress information
+ * without changing the world state.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always valid (but may return "no scoring" message)
+ * 2. execute: Compute score data (no world mutations)
+ * 3. blocked: Handle validation failures
+ * 4. report: Emit score events
+ *
+ * Scoring capability can be:
+ * - Not registered: Show "no scoring" message
+ * - Registered but disabled (enabled: false): Show funny "no scoring" message
+ * - Registered and enabled: Show score/rank
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scoringAction = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const constants_1 = require("../../constants");
+function getScoringSharedData(context) {
+    return context.sharedData;
+}
+/**
+ * Compute rank from score (fallback if not provided by service)
+ */
+function computeRank(score, maxScore) {
+    if (maxScore === 0)
+        return 'Beginner';
+    const percentage = (score / maxScore) * 100;
+    if (percentage >= 90)
+        return 'Master';
+    if (percentage >= 75)
+        return 'Expert';
+    if (percentage >= 50)
+        return 'Proficient';
+    if (percentage >= 25)
+        return 'Amateur';
+    return 'Novice';
+}
+exports.scoringAction = {
+    id: constants_1.IFActions.SCORING,
+    requiredMessages: [
+        'no_scoring',
+        'score_display',
+        'score_simple',
+        'score_with_rank',
+        'perfect_score',
+        'with_achievements',
+        'early_game',
+        'mid_game',
+        'late_game',
+        'game_complete'
+    ],
+    validate(_context) {
+        // Always valid - we handle disabled case in execute/report
+        return { valid: true };
+    },
+    execute(context) {
+        const sharedData = getScoringSharedData(context);
+        const scoringData = context.world.getCapability(world_model_1.StandardCapabilities.SCORING);
+        // Check if scoring is enabled
+        if (!scoringData || scoringData.enabled === false) {
+            sharedData.enabled = false;
+            return;
+        }
+        sharedData.enabled = true;
+        // Extract score data from capability
+        const score = scoringData.scoreValue || 0;
+        const maxScore = scoringData.maxScore || 0;
+        const moves = scoringData.moves || 0;
+        const achievements = scoringData.achievements || [];
+        const rank = scoringData.rank || computeRank(score, maxScore);
+        const eventData = { score, maxScore, moves };
+        const params = { score, maxScore, moves, rank };
+        let messageId = 'score_simple';
+        if (maxScore > 0) {
+            const percentage = Math.round((score / maxScore) * 100);
+            eventData.percentage = percentage;
+            params.percentage = percentage;
+            eventData.rank = rank;
+            if (score === maxScore) {
+                messageId = 'perfect_score';
+            }
+            else {
+                messageId = 'score_with_rank';
+            }
+        }
+        else if (moves > 0) {
+            messageId = 'score_display';
+        }
+        if (achievements.length > 0) {
+            eventData.achievements = achievements;
+            params.achievements = achievements.join(', ');
+        }
+        // Determine progress message
+        let progressMessage;
+        if (maxScore > 0) {
+            const percentage = (score / maxScore) * 100;
+            if (percentage === 100)
+                progressMessage = 'game_complete';
+            else if (percentage >= 75)
+                progressMessage = 'late_game';
+            else if (percentage >= 25)
+                progressMessage = 'mid_game';
+            else
+                progressMessage = 'early_game';
+            eventData.progress = progressMessage;
+        }
+        sharedData.eventData = eventData;
+        sharedData.params = params;
+        sharedData.messageId = messageId;
+        sharedData.achievements = achievements;
+        sharedData.progressMessage = progressMessage;
+    },
+    blocked(context, result) {
+        return [context.event('if.event.score_displayed', {
+                messageId: `if.action.scoring.${result.error}`,
+                params: result.params || {},
+                blocked: true,
+                reason: result.error
+            })];
+    },
+    report(context) {
+        const sharedData = getScoringSharedData(context);
+        // Handle disabled scoring
+        if (!sharedData.enabled) {
+            return [context.event('if.event.score_displayed', {
+                    messageId: 'if.action.scoring.no_scoring',
+                    params: {},
+                    enabled: false
+                })];
+        }
+        if (!sharedData.eventData) {
+            return [];
+        }
+        // Determine primary messageId
+        const messageId = `if.action.scoring.${sharedData.messageId || 'score_simple'}`;
+        // Emit single domain event with all data
+        return [context.event('if.event.score_displayed', {
+                messageId,
+                params: sharedData.params || {},
+                // Domain data
+                ...sharedData.eventData,
+                // Additional rendering hints
+                hasAchievements: sharedData.achievements && sharedData.achievements.length > 0,
+                achievements: sharedData.achievements,
+                progressMessage: sharedData.progressMessage
+            })];
+    },
+    group: "meta",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false
+    }
+};
+//# sourceMappingURL=scoring.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Searching action module exports
+ */
+export { searchingAction } from './searching';
+export type { SearchedEventData, SearchingErrorData, SearchingEventMap } from './searching-events';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/searching/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/searching/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yCAA8C;AAArC,4GAAA,eAAe,OAAA"}

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

@@ -0,0 +1,43 @@
+/**
+ * Event type definitions for the searching action
+ */
+import { EntityId } from '@sharpee/core';
+/**
+ * Event data for when something is searched
+ */
+export interface SearchedEventData {
+    /** The entity that was searched */
+    target: EntityId;
+    /** Name of the target */
+    targetName: string;
+    /** IDs of items found (including concealed) */
+    foundItems: EntityId[];
+    /** Names of items found */
+    foundItemNames: string[];
+    /** Whether searching the current location (no target specified) */
+    searchingLocation?: boolean;
+}
+/**
+ * Error data for searching failures
+ */
+export interface SearchingErrorData {
+    reason: 'not_visible' | 'not_reachable' | 'container_closed';
+    target?: string;
+}
+/**
+ * Complete event map for searching action
+ */
+export interface SearchingEventMap {
+    'if.event.searched': SearchedEventData;
+    'action.success': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+    'action.error': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+}
+//# sourceMappingURL=searching-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searching-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/searching/searching-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mCAAmC;IACnC,MAAM,EAAE,QAAQ,CAAC;IAEjB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IAEnB,+CAA+C;IAC/C,UAAU,EAAE,QAAQ,EAAE,CAAC;IAEvB,2BAA2B;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,mEAAmE;IACnE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,aAAa,GAAG,eAAe,GAAG,kBAAkB,CAAC;IAC7D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mBAAmB,EAAE,iBAAiB,CAAC;IACvC,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/dist/actions/standard/searching/searching-events.js

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

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Searching action - search objects or locations for hidden items
+ *
+ * This action allows players to search containers, supporters, or locations
+ * to find concealed items or discover additional details.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check target is searchable (container open if applicable)
+ * 2. execute: Analyze contents, reveal concealed items (mutation)
+ * 3. blocked: Generate events when validation fails
+ * 4. report: Generate success events
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const searchingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=searching.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"searching.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/searching/searching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAQ/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsBrD,eAAO,MAAM,eAAe,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAkGhE,CAAC"}

package/dist/actions/standard/searching/searching.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Searching action - search objects or locations for hidden items
+ *
+ * This action allows players to search containers, supporters, or locations
+ * to find concealed items or discover additional details.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check target is searchable (container open if applicable)
+ * 2. execute: Analyze contents, reveal concealed items (mutation)
+ * 3. blocked: Generate events when validation fails
+ * 4. report: Generate success events
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchingAction = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const constants_1 = require("../../constants");
+const types_1 = require("../../../scope/types");
+const searching_helpers_1 = require("../searching-helpers");
+function getSearchingSharedData(context) {
+    return context.sharedData;
+}
+exports.searchingAction = {
+    id: constants_1.IFActions.SEARCHING,
+    // Default scope requirements for this action's slots
+    defaultScope: {
+        target: types_1.ScopeLevel.REACHABLE
+    },
+    requiredMessages: [
+        'not_visible',
+        'not_reachable',
+        'container_closed',
+        'nothing_special',
+        'found_items',
+        'empty_container',
+        'container_contents',
+        'supporter_contents',
+        'searched_location',
+        'searched_object',
+        'found_concealed'
+    ],
+    metadata: {
+        requiresDirectObject: true,
+        requiresIndirectObject: false,
+        directObjectScope: types_1.ScopeLevel.REACHABLE
+    },
+    validate(context) {
+        const target = context.command.directObject?.entity;
+        // If no target, we'll search the current location (always valid)
+        if (!target) {
+            return { valid: true };
+        }
+        // Check if it's a container that needs to be open
+        if (target.has(world_model_1.TraitType.CONTAINER) && target.has(world_model_1.TraitType.OPENABLE)) {
+            if (!world_model_1.OpenableBehavior.isOpen(target)) {
+                return {
+                    valid: false,
+                    error: 'container_closed',
+                    params: { target: target.name }
+                };
+            }
+        }
+        return { valid: true };
+    },
+    execute(context) {
+        const target = context.command.directObject?.entity;
+        const sharedData = getSearchingSharedData(context);
+        // Analyze what we're searching
+        const searchContext = (0, searching_helpers_1.analyzeSearchTarget)(context, target);
+        // Reveal any concealed items found (world mutation)
+        if (searchContext.concealedItems.length > 0) {
+            (0, searching_helpers_1.revealConcealedItems)(searchContext.concealedItems);
+        }
+        // Build event data and message
+        const eventData = (0, searching_helpers_1.buildSearchEventData)(searchContext);
+        const { messageId, params } = (0, searching_helpers_1.determineSearchMessage)(searchContext);
+        // Store in sharedData for report phase
+        sharedData.eventData = eventData;
+        sharedData.messageId = messageId;
+        sharedData.params = params;
+    },
+    blocked(context, result) {
+        const target = context.command.directObject?.entity;
+        return [context.event('if.event.searched', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: { target: target?.name, ...result.params },
+                reason: result.error,
+                targetId: target?.id,
+                targetName: target?.name
+            })];
+    },
+    report(context) {
+        const events = [];
+        const sharedData = getSearchingSharedData(context);
+        // Emit searched event with messageId for text rendering
+        events.push(context.event('if.event.searched', {
+            messageId: `${context.action.id}.${sharedData.messageId || 'nothing_special'}`,
+            params: sharedData.params || {},
+            ...sharedData.eventData
+        }));
+        return events;
+    },
+    group: "sensory"
+};
+//# sourceMappingURL=searching.js.map