@sharpee/stdlib 0.9.62-beta → 0.9.66-beta

package/dist-npm/actions/standard/unlocking/unlocking.js

@@ -1,235 +0,0 @@
-"use strict";
-/**
- * Unlocking action - unlocks containers and doors
- *
- * This action properly delegates to LockableBehavior for validation
- * and execution. It follows the three-phase pattern.
- *
- * Uses three-phase pattern:
- * 1. validate: Check if target is lockable and key requirements
- * 2. execute: Call LockableBehavior.unlock(), store result in sharedData
- * 3. report: Generate events from sharedData
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.unlockingAction = void 0;
-const world_model_1 = require("@sharpee/world-model");
-const constants_1 = require("../../constants");
-const scope_1 = require("../../../scope");
-const lock_shared_1 = require("../lock-shared");
-const unlocking_messages_1 = require("./unlocking-messages");
-function getUnlockingSharedData(context) {
-    return context.sharedData;
-}
-exports.unlockingAction = {
-    id: constants_1.IFActions.UNLOCKING,
-    // Default scope requirements for this action's slots
-    defaultScope: {
-        target: scope_1.ScopeLevel.REACHABLE,
-        key: scope_1.ScopeLevel.CARRIED
-    },
-    requiredMessages: [
-        'no_target',
-        'not_lockable',
-        'no_key',
-        'wrong_key',
-        'already_unlocked',
-        'unlocked',
-        'unlocked_with',
-        'cant_reach',
-        'key_not_held',
-        'still_locked'
-    ],
-    group: 'lock_manipulation',
-    /**
-     * Validate whether the unlock action can be executed
-     * Uses behavior validation methods to check preconditions
-     */
-    validate(context) {
-        const noun = context.command.directObject?.entity;
-        // ADR-080: Prefer instrument field (from .instrument() patterns), fall back to indirectObject
-        const withKey = context.command.instrument?.entity ?? context.command.indirectObject?.entity;
-        // Validate we have a target
-        if (!noun) {
-            return {
-                valid: false,
-                error: unlocking_messages_1.MESSAGES.NO_TARGET
-            };
-        }
-        // Check scope - must be able to reach the target
-        const scopeCheck = context.requireScope(noun, scope_1.ScopeLevel.REACHABLE);
-        if (!scopeCheck.ok) {
-            return scopeCheck.error;
-        }
-        // Check if it's lockable
-        if (!noun.has(world_model_1.TraitType.LOCKABLE)) {
-            return {
-                valid: false,
-                error: unlocking_messages_1.MESSAGES.NOT_LOCKABLE,
-                params: { item: noun.name }
-            };
-        }
-        // Use behavior's canUnlock method for validation
-        if (!world_model_1.LockableBehavior.canUnlock(noun)) {
-            return {
-                valid: false,
-                error: unlocking_messages_1.MESSAGES.ALREADY_UNLOCKED,
-                params: { item: noun.name }
-            };
-        }
-        // Validate key requirements using shared helper
-        const keyValidation = (0, lock_shared_1.validateKeyRequirements)(context, noun, withKey, false);
-        if (keyValidation) {
-            return keyValidation;
-        }
-        return { valid: true };
-    },
-    /**
-     * Execute the unlock action - performs mutations only
-     * Assumes validation has already passed
-     * Delegates to LockableBehavior for actual state changes
-     */
-    execute(context) {
-        const noun = context.command.directObject.entity;
-        // ADR-080: Prefer instrument field, fall back to indirectObject
-        const withKey = context.command.instrument?.entity ?? context.command.indirectObject?.entity;
-        const sharedData = getUnlockingSharedData(context);
-        // Analyze the unlocking context
-        const analysis = (0, lock_shared_1.analyzeLockContext)(context, noun, withKey);
-        // Delegate to behavior for unlocking (world mutation)
-        const result = world_model_1.LockableBehavior.unlock(noun, withKey);
-        // Store basic info
-        sharedData.targetId = noun.id;
-        sharedData.targetName = noun.name;
-        // Check if the behavior reported failure
-        if (!result.success) {
-            sharedData.failed = true;
-            // Map behavior failure to error message
-            if (result.wrongKey) {
-                sharedData.errorMessageId = 'wrong_key';
-            }
-            else if (result.noKey) {
-                sharedData.errorMessageId = 'no_key';
-            }
-            else {
-                sharedData.errorMessageId = 'cant_unlock';
-            }
-            return;
-        }
-        // Unlocking succeeded
-        sharedData.failed = false;
-        // Add type information from analysis
-        if (analysis.isContainer) {
-            sharedData.isContainer = true;
-            // Get container contents
-            const contents = context.world.getContents(noun.id);
-            sharedData.hasContents = contents.length > 0;
-            sharedData.contentsCount = contents.length;
-            sharedData.contentsIds = contents.map(e => e.id);
-        }
-        if (analysis.isDoor) {
-            sharedData.isDoor = true;
-        }
-        // Add key information
-        if (withKey) {
-            sharedData.keyId = withKey.id;
-            sharedData.keyName = withKey.name;
-        }
-        // Add sound information from result
-        if (result.unlockSound) {
-            sharedData.sound = result.unlockSound;
-        }
-        // Check for auto-open behavior
-        if (noun.has(world_model_1.TraitType.OPENABLE)) {
-            const openableTrait = noun.get(world_model_1.TraitType.OPENABLE);
-            if (openableTrait.autoOpenOnUnlock) {
-                sharedData.willAutoOpen = true;
-            }
-        }
-        // Determine success message
-        sharedData.messageId = (0, lock_shared_1.determineLockMessage)(false, !!withKey);
-        sharedData.params = {
-            item: noun.name
-        };
-        // Add container/door info to params
-        if (analysis.isContainer) {
-            sharedData.params.isContainer = true;
-            sharedData.params.hasContents = sharedData.hasContents;
-        }
-        if (analysis.isDoor) {
-            sharedData.params.isDoor = true;
-        }
-        if (withKey) {
-            sharedData.params.key = withKey.name;
-        }
-        if (sharedData.willAutoOpen) {
-            sharedData.params.willAutoOpen = true;
-        }
-        if (sharedData.sound) {
-            sharedData.params.sound = sharedData.sound;
-        }
-    },
-    /**
-     * Report phase - generates events after successful execution
-     *
-     * Uses simplified event pattern (ADR-097): domain event carries messageId directly.
-     */
-    report(context) {
-        const sharedData = getUnlockingSharedData(context);
-        // Check if behavior failed (safety net for edge cases)
-        if (sharedData.failed) {
-            return [context.event('if.event.unlock_blocked', {
-                    messageId: `${context.action.id}.${sharedData.errorMessageId}`,
-                    params: { item: sharedData.targetName },
-                    targetId: sharedData.targetId,
-                    targetName: sharedData.targetName,
-                    reason: sharedData.errorMessageId
-                })];
-        }
-        // Emit domain event with messageId (simplified pattern - ADR-097)
-        return [
-            context.event('if.event.unlocked', {
-                // Rendering data (messageId + params for text-service)
-                messageId: `${context.action.id}.${sharedData.messageId}`,
-                params: sharedData.params,
-                // Domain data (for event sourcing / handlers)
-                targetId: sharedData.targetId,
-                targetName: sharedData.targetName,
-                containerId: sharedData.targetId,
-                containerName: sharedData.targetName,
-                actorId: context.player.id,
-                isContainer: sharedData.isContainer,
-                isDoor: sharedData.isDoor,
-                keyId: sharedData.keyId,
-                keyName: sharedData.keyName,
-                sound: sharedData.sound,
-                willAutoOpen: sharedData.willAutoOpen,
-                hasContents: sharedData.hasContents,
-                contentsCount: sharedData.contentsCount,
-                contentsIds: sharedData.contentsIds
-            })
-        ];
-    },
-    /**
-     * Generate events when validation fails
-     *
-     * Uses simplified event pattern (ADR-097): domain event carries messageId directly.
-     */
-    blocked(context, result) {
-        const noun = context.command.directObject?.entity;
-        return [context.event('if.event.unlock_blocked', {
-                // Rendering data
-                messageId: `${context.action.id}.${result.error}`,
-                params: result.params || {},
-                // Domain data
-                targetId: noun?.id,
-                targetName: noun?.name,
-                reason: result.error
-            })];
-    },
-    metadata: {
-        requiresDirectObject: true,
-        requiresIndirectObject: false,
-        directObjectScope: scope_1.ScopeLevel.REACHABLE
-    }
-};
-//# sourceMappingURL=unlocking.js.map

package/dist-npm/actions/standard/unlocking/unlocking.js.map

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

package/dist-npm/actions/standard/version/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Version action module exports
- */
-export { versionAction, ENGINE_VERSION } from './version';
-export type { VersionDisplayedEventData, VersionEventMap } from './version-events';
-//# sourceMappingURL=index.d.ts.map

package/dist-npm/actions/standard/version/index.d.ts.map

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

package/dist-npm/actions/standard/version/index.js

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

package/dist-npm/actions/standard/version/index.js.map

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

package/dist-npm/actions/standard/version/version-events.d.ts

@@ -1,46 +0,0 @@
-/**
- * Event type definitions for the version action
- */
-/**
- * Event data for when version information is displayed
- * Uses domain event pattern with embedded messageId (ADR-097)
- *
- * Includes both semantic fields (storyVersion, storyTitle) and
- * template-friendly aliases (version, title) for banner compatibility.
- */
-export interface VersionDisplayedEventData {
-    /** Message ID for text-service lookup */
-    messageId: string;
-    /** Parameters for message template substitution */
-    params: {
-        storyVersion?: string;
-        storyTitle?: string;
-        engineVersion?: string;
-        clientVersion?: string;
-        buildDate?: string;
-        author?: string;
-        title?: string;
-        version?: string;
-    };
-    /** Story/game version */
-    storyVersion?: string;
-    /** Story title */
-    storyTitle?: string;
-    /** Engine version */
-    engineVersion?: string;
-    /** Client version (browser, electron, etc.) */
-    clientVersion?: string;
-    /** Build timestamp (ISO 8601) */
-    buildDate?: string;
-    /** Whether this is a blocked/error case */
-    blocked?: boolean;
-    /** Reason for block (if blocked) */
-    reason?: string;
-}
-/**
- * Complete event map for version action
- */
-export interface VersionEventMap {
-    'if.event.version_displayed': VersionDisplayedEventData;
-}
-//# sourceMappingURL=version-events.d.ts.map

package/dist-npm/actions/standard/version/version-events.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/version/version-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,MAAM,WAAW,yBAAyB;IACxC,yCAAyC;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IAEF,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B,EAAE,yBAAyB,CAAC;CACzD"}

package/dist-npm/actions/standard/version/version-events.js

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

package/dist-npm/actions/standard/version/version-events.js.map

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

package/dist-npm/actions/standard/version/version.d.ts

@@ -1,21 +0,0 @@
-/**
- * Version action - displays version information about the game and engine
- *
- * This is a meta action that emits version information for display.
- * The text service will render the version info based on story config
- * and engine version data.
- *
- * Uses four-phase pattern:
- * 1. validate: Always succeeds (no preconditions)
- * 2. execute: No world mutations
- * 3. blocked: Handle validation failures (n/a - always succeeds)
- * 4. report: Emit version event with version data
- */
-import { Action } from '../../enhanced-types';
-import { ActionMetadata } from '../../../validation';
-/** Engine version - update this when engine version changes */
-export declare const ENGINE_VERSION = "0.9.43-beta.1";
-export declare const versionAction: Action & {
-    metadata: ActionMetadata;
-};
-//# sourceMappingURL=version.d.ts.map

package/dist-npm/actions/standard/version/version.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/version/version.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,+DAA+D;AAC/D,eAAO,MAAM,cAAc,kBAAkB,CAAC;AAE9C,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA2E9D,CAAC"}

package/dist-npm/actions/standard/version/version.js

@@ -1,86 +0,0 @@
-"use strict";
-/**
- * Version action - displays version information about the game and engine
- *
- * This is a meta action that emits version information for display.
- * The text service will render the version info based on story config
- * and engine version data.
- *
- * Uses four-phase pattern:
- * 1. validate: Always succeeds (no preconditions)
- * 2. execute: No world mutations
- * 3. blocked: Handle validation failures (n/a - always succeeds)
- * 4. report: Emit version event with version data
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.versionAction = exports.ENGINE_VERSION = void 0;
-const constants_1 = require("../../constants");
-/** Engine version - update this when engine version changes */
-exports.ENGINE_VERSION = '0.9.43-beta.1';
-exports.versionAction = {
-    id: constants_1.IFActions.VERSION,
-    validate(context) {
-        // Version action always succeeds
-        return {
-            valid: true
-        };
-    },
-    execute(context) {
-        // No state mutations needed for this meta action
-    },
-    blocked(context, result) {
-        // Version always succeeds, but include blocked for consistency
-        return [context.event('if.event.version_displayed', {
-                messageId: `if.action.version.${result.error}`,
-                params: result.params || {},
-                blocked: true,
-                reason: result.error
-            })];
-    },
-    report(context) {
-        // Get version info from world/story config
-        const world = context.world;
-        const storyConfig = world.storyConfig || {};
-        const versionInfo = world.versionInfo || {};
-        const storyTitle = storyConfig.title || 'Unknown';
-        const storyVersion = versionInfo.version || storyConfig.version || '0.0.0';
-        const engineVersion = versionInfo.engineVersion || exports.ENGINE_VERSION;
-        const clientVersion = versionInfo.clientVersion || world.clientVersion || 'N/A';
-        const buildDate = versionInfo.buildDate;
-        const author = storyConfig.author || 'Unknown';
-        // Determine messageId based on available data
-        // Use existing lang-en-us keys: version_full, version_no_date
-        const messageId = buildDate
-            ? 'if.action.version.version_full'
-            : 'if.action.version.version_no_date';
-        // Event data with messageId for text-service lookup
-        const eventData = {
-            messageId,
-            params: {
-                storyTitle,
-                storyVersion,
-                engineVersion,
-                clientVersion,
-                buildDate,
-                title: storyTitle,
-                version: storyVersion,
-                author: Array.isArray(author) ? author.join(', ') : author
-            },
-            // Domain data for event handlers
-            storyTitle,
-            storyVersion,
-            engineVersion,
-            clientVersion,
-            buildDate
-        };
-        return [
-            context.event('if.event.version_displayed', eventData)
-        ];
-    },
-    group: "meta",
-    metadata: {
-        requiresDirectObject: false,
-        requiresIndirectObject: false
-    }
-};
-//# sourceMappingURL=version.js.map

package/dist-npm/actions/standard/version/version.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../../../../src/actions/standard/version/version.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAIH,+CAA4C;AAI5C,+DAA+D;AAClD,QAAA,cAAc,GAAG,eAAe,CAAC;AAEjC,QAAA,aAAa,GAA0C;IAClE,EAAE,EAAE,qBAAS,CAAC,OAAO;IAErB,QAAQ,CAAC,OAAsB;QAC7B,iCAAiC;QACjC,OAAO;YACL,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,OAAsB;QAC5B,iDAAiD;IACnD,CAAC;IAED,OAAO,CAAC,OAAsB,EAAE,MAAwB;QACtD,+DAA+D;QAC/D,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE;gBAClD,SAAS,EAAE,qBAAqB,MAAM,CAAC,KAAK,EAAE;gBAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;gBAC3B,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,MAAM,CAAC,KAAK;aACrB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,CAAC,OAAsB;QAC3B,2CAA2C;QAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC5B,MAAM,WAAW,GAAI,KAAa,CAAC,WAAW,IAAI,EAAE,CAAC;QACrD,MAAM,WAAW,GAAI,KAAa,CAAC,WAAW,IAAI,EAAE,CAAC;QAErD,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,IAAI,SAAS,CAAC;QAClD,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,IAAI,OAAO,CAAC;QAC3E,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,IAAI,sBAAc,CAAC;QAClE,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,IAAK,KAAa,CAAC,aAAa,IAAI,KAAK,CAAC;QACzF,MAAM,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC;QACxC,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,IAAI,SAAS,CAAC;QAE/C,8CAA8C;QAC9C,8DAA8D;QAC9D,MAAM,SAAS,GAAG,SAAS;YACzB,CAAC,CAAC,gCAAgC;YAClC,CAAC,CAAC,mCAAmC,CAAC;QAExC,oDAAoD;QACpD,MAAM,SAAS,GAA8B;YAC3C,SAAS;YACT,MAAM,EAAE;gBACN,UAAU;gBACV,YAAY;gBACZ,aAAa;gBACb,aAAa;gBACb,SAAS;gBACT,KAAK,EAAE,UAAU;gBACjB,OAAO,EAAE,YAAY;gBACrB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM;aAC3D;YACD,iCAAiC;YACjC,UAAU;YACV,YAAY;YACZ,aAAa;YACb,aAAa;YACb,SAAS;SACV,CAAC;QAEF,OAAO;YACL,OAAO,CAAC,KAAK,CAAC,4BAA4B,EAAE,SAAS,CAAC;SACvD,CAAC;IACJ,CAAC;IAED,KAAK,EAAE,MAAM;IAEb,QAAQ,EAAE;QACR,oBAAoB,EAAE,KAAK;QAC3B,sBAAsB,EAAE,KAAK;KAC9B;CACF,CAAC"}

package/dist-npm/actions/standard/waiting/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * Waiting action module exports
- */
-export { waitingAction } from './waiting';
-export type { WaitedEventData, WaitingEventMap } from './waiting-events';
-//# sourceMappingURL=index.d.ts.map

package/dist-npm/actions/standard/waiting/index.d.ts.map

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

package/dist-npm/actions/standard/waiting/index.js

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

package/dist-npm/actions/standard/waiting/index.js.map

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

package/dist-npm/actions/standard/waiting/waiting-events.d.ts

@@ -1,31 +0,0 @@
-/**
- * Event type definitions for the waiting action
- */
-import { EntityId } from '@sharpee/core';
-/**
- * Event data for when an actor waits
- */
-export interface WaitedEventData {
-    /** Number of turns that passed while waiting */
-    turnsPassed: number;
-    /** Location where the waiting occurred */
-    location?: EntityId;
-    /** Name of the location */
-    locationName?: string;
-    /** Number of consecutive waits */
-    waitCount?: number;
-    /** ID of any pending timed event */
-    pendingEvent?: string;
-}
-/**
- * Complete event map for waiting action
- */
-export interface WaitingEventMap {
-    'if.event.waited': WaitedEventData;
-    'action.success': {
-        actionId: string;
-        messageId: string;
-        params?: Record<string, any>;
-    };
-}
-//# sourceMappingURL=waiting-events.d.ts.map

package/dist-npm/actions/standard/waiting/waiting-events.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"waiting-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/waiting/waiting-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,WAAW,EAAE,MAAM,CAAC;IAEpB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IAEpB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;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;CACH"}

package/dist-npm/actions/standard/waiting/waiting-events.js

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

package/dist-npm/actions/standard/waiting/waiting-events.js.map

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

package/dist-npm/actions/standard/waiting/waiting.d.ts

@@ -1,18 +0,0 @@
-/**
- * Waiting action - passes time without doing anything
- *
- * This is a signal action that emits an event to indicate the player
- * chose to wait. The engine handles turn advancement and daemon processing.
- *
- * Uses four-phase pattern:
- * 1. validate: Always succeeds (no preconditions for waiting)
- * 2. execute: No world mutations (stores location in sharedData)
- * 3. blocked: Handle validation failures (n/a - always succeeds)
- * 4. report: Emits if.event.waited signal for engine/daemons
- */
-import { Action } from '../../enhanced-types';
-import { ActionMetadata } from '../../../validation';
-export declare const waitingAction: Action & {
-    metadata: ActionMetadata;
-};
-//# sourceMappingURL=waiting.d.ts.map

package/dist-npm/actions/standard/waiting/waiting.d.ts.map

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

package/dist-npm/actions/standard/waiting/waiting.js

@@ -1,65 +0,0 @@
-"use strict";
-/**
- * Waiting action - passes time without doing anything
- *
- * This is a signal action that emits an event to indicate the player
- * chose to wait. The engine handles turn advancement and daemon processing.
- *
- * Uses four-phase pattern:
- * 1. validate: Always succeeds (no preconditions for waiting)
- * 2. execute: No world mutations (stores location in sharedData)
- * 3. blocked: Handle validation failures (n/a - always succeeds)
- * 4. report: Emits if.event.waited signal for engine/daemons
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.waitingAction = void 0;
-const constants_1 = require("../../constants");
-function getWaitingSharedData(context) {
-    return context.sharedData;
-}
-exports.waitingAction = {
-    id: constants_1.IFActions.WAITING,
-    requiredMessages: [
-        'time_passes'
-    ],
-    group: "meta",
-    metadata: {
-        requiresDirectObject: false,
-        requiresIndirectObject: false
-    },
-    validate(context) {
-        // Waiting always succeeds - no preconditions
-        return { valid: true };
-    },
-    execute(context) {
-        // Waiting has NO world mutations
-        // Just store location info in sharedData for report phase
-        const location = context.currentLocation;
-        const sharedData = getWaitingSharedData(context);
-        sharedData.locationId = location?.id;
-        sharedData.locationName = location?.name;
-    },
-    blocked(context, result) {
-        // Waiting always succeeds, but include blocked for consistency
-        return [context.event('if.event.wait_blocked', {
-                blocked: true,
-                messageId: `${context.action.id}.${result.error}`,
-                params: result.params,
-                reason: result.error
-            })];
-    },
-    report(context) {
-        const events = [];
-        const sharedData = getWaitingSharedData(context);
-        // Emit waited event with messageId for text rendering
-        // Engine/daemons listen to this to advance turn counter and process scheduled events
-        events.push(context.event('if.event.waited', {
-            messageId: `${context.action.id}.time_passes`,
-            turnsPassed: 1,
-            location: sharedData.locationId,
-            locationName: sharedData.locationName
-        }));
-        return events;
-    }
-};
-//# sourceMappingURL=waiting.js.map

package/dist-npm/actions/standard/waiting/waiting.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"waiting.js","sourceRoot":"","sources":["../../../../src/actions/standard/waiting/waiting.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AAIH,+CAA4C;AAY5C,SAAS,oBAAoB,CAAC,OAAsB;IAClD,OAAO,OAAO,CAAC,UAA+B,CAAC;AACjD,CAAC;AAEY,QAAA,aAAa,GAA0C;IAClE,EAAE,EAAE,qBAAS,CAAC,OAAO;IAErB,gBAAgB,EAAE;QAChB,aAAa;KACd;IAED,KAAK,EAAE,MAAM;IAEb,QAAQ,EAAE;QACR,oBAAoB,EAAE,KAAK;QAC3B,sBAAsB,EAAE,KAAK;KAC9B;IAED,QAAQ,CAAC,OAAsB;QAC7B,6CAA6C;QAC7C,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED,OAAO,CAAC,OAAsB;QAC5B,iCAAiC;QACjC,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;QACzC,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjD,UAAU,CAAC,UAAU,GAAG,QAAQ,EAAE,EAAE,CAAC;QACrC,UAAU,CAAC,YAAY,GAAG,QAAQ,EAAE,IAAI,CAAC;IAC3C,CAAC;IAED,OAAO,CAAC,OAAsB,EAAE,MAAwB;QACtD,+DAA+D;QAC/D,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBAC7C,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,EAAE;gBACjD,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,MAAM,EAAE,MAAM,CAAC,KAAK;aACrB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,CAAC,OAAsB;QAC3B,MAAM,MAAM,GAAqB,EAAE,CAAC;QACpC,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAEjD,sDAAsD;QACtD,qFAAqF;QACrF,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE;YAC3C,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,cAAc;YAC7C,WAAW,EAAE,CAAC;YACd,QAAQ,EAAE,UAAU,CAAC,UAAU;YAC/B,YAAY,EAAE,UAAU,CAAC,YAAY;SACK,CAAC,CAAC,CAAC;QAE/C,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}