@sharpee/stdlib 0.9.66-beta → 0.9.67-beta

package/actions/standard/entering/entering.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * Entering action - enter containers, supporters, or other enterable objects
+ *
+ * This action handles entering objects that have the ENTRY trait or
+ * are containers/supporters marked as enterable.
+ *
+ * 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.enteringAction = void 0;
+const world_model_1 = require("../../../src/index.js");
+const constants_1 = require("../../constants");
+const entering_messages_1 = require("./entering-messages");
+function getEnteringSharedData(context) {
+    return context.sharedData;
+}
+const types_1 = require("../../../scope/types");
+exports.enteringAction = {
+    id: constants_1.IFActions.ENTERING,
+    // Default scope requirements for this action's slots
+    defaultScope: {
+        target: types_1.ScopeLevel.REACHABLE
+    },
+    requiredMessages: [
+        'no_target',
+        'not_enterable',
+        'already_inside',
+        'container_closed',
+        'too_full',
+        'entered',
+        'entered_on',
+        'cant_enter'
+    ],
+    group: 'movement',
+    validate(context) {
+        const actor = context.player;
+        const target = context.command.directObject?.entity;
+        const sharedData = getEnteringSharedData(context);
+        // Validate target
+        if (!target) {
+            return {
+                valid: false,
+                error: entering_messages_1.EnteringMessages.NO_TARGET
+            };
+        }
+        // Check for interceptor on the target entity (ADR-118)
+        const interceptorResult = (0, world_model_1.getInterceptorForAction)(target, constants_1.IFActions.ENTERING);
+        const interceptor = interceptorResult?.interceptor;
+        const interceptorData = {};
+        // 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;
+        }
+        // Check if already inside the target
+        const currentLocation = context.world.getLocation(actor.id);
+        if (currentLocation === target.id) {
+            return {
+                valid: false,
+                error: entering_messages_1.EnteringMessages.ALREADY_INSIDE,
+                params: { place: target.name }
+            };
+        }
+        // Check enterability
+        if (!target.has(world_model_1.TraitType.ENTERABLE)) {
+            return {
+                valid: false,
+                error: entering_messages_1.EnteringMessages.NOT_ENTERABLE,
+                params: { place: target.name }
+            };
+        }
+        // Check if it needs to be open
+        if (target.has(world_model_1.TraitType.OPENABLE) && !world_model_1.OpenableBehavior.isOpen(target)) {
+            return {
+                valid: false,
+                error: entering_messages_1.EnteringMessages.CONTAINER_CLOSED,
+                params: { container: target.name }
+            };
+        }
+        // === 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 enter action - performs mutations only
+     * Assumes validation has already passed
+     */
+    execute(context) {
+        const actor = context.player;
+        const target = context.command.directObject.entity; // Safe because validate ensures it exists
+        const currentLocation = context.world.getLocation(actor.id);
+        const sharedData = getEnteringSharedData(context);
+        // Get preposition from EnterableTrait (required by validate)
+        const enterableTrait = target.get(world_model_1.TraitType.ENTERABLE);
+        const preposition = enterableTrait.preposition;
+        // Simply move the actor to the target - that's all!
+        context.world.moveEntity(actor.id, target.id);
+        // Store state for report phase using sharedData
+        const state = {
+            targetId: target.id,
+            targetName: target.name,
+            fromLocation: currentLocation,
+            preposition
+        };
+        sharedData.enteringState = state;
+        // === 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, actor.id, interceptorData);
+        }
+    },
+    /**
+     * Report events after successful entering
+     * Only called on success path - validation passed
+     */
+    report(context) {
+        // Get stored state from execute phase
+        const sharedData = getEnteringSharedData(context);
+        const state = sharedData.enteringState;
+        if (!state) {
+            // This shouldn't happen, but handle gracefully
+            return [
+                context.event('if.event.entered', {
+                    messageId: `${context.action.id}.${entering_messages_1.EnteringMessages.ACTION_FAILED}`,
+                    error: 'Missing state from execute phase'
+                })
+            ];
+        }
+        // Determine the message ID based on preposition
+        const messageId = state.preposition === 'on' ? entering_messages_1.EnteringMessages.ENTERED_ON : entering_messages_1.EnteringMessages.ENTERED;
+        // Create the ENTERED event with messageId for text rendering
+        const events = [context.event('if.event.entered', {
+                messageId: `${context.action.id}.${messageId}`,
+                params: { place: state.targetName },
+                targetId: state.targetId,
+                targetName: state.targetName,
+                fromLocation: state.fromLocation,
+                preposition: state.preposition
+            })];
+        // === POST-REPORT HOOK ===
+        // Called after standard report - can add additional effects
+        const interceptor = sharedData.interceptor;
+        const interceptorData = sharedData.interceptorData || {};
+        if (interceptor?.postReport) {
+            const target = context.command.directObject?.entity;
+            if (target) {
+                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;
+    },
+    /**
+     * Generate events when validation fails
+     * Called instead of execute/report when validate returns invalid
+     */
+    blocked(context, result) {
+        const target = context.command.directObject?.entity;
+        const sharedData = getEnteringSharedData(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.entered', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: { place: target?.name, ...result.params },
+                reason: result.error,
+                targetId: target?.id,
+                targetName: target?.name
+            })];
+    },
+    metadata: {
+        requiresDirectObject: true,
+        requiresIndirectObject: false,
+        directObjectScope: types_1.ScopeLevel.REACHABLE
+    }
+};
+//# sourceMappingURL=entering.js.map

package/actions/standard/entering/entering.js.map

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

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

@@ -0,0 +1,6 @@
+/**
+ * Entering action module exports
+ */
+export { enteringAction } from './entering';
+export type { EnteredEventData, EnteringErrorData, EnteringEventMap } from './entering-events';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/entering/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/actions/standard/entering/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/entering/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAA4C;AAAnC,0GAAA,cAAc,OAAA"}

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

@@ -0,0 +1,42 @@
+/**
+ * Data builder for examining action
+ *
+ * Centralizes all entity snapshot and event data logic for the examining action.
+ * This separates data structure concerns from business logic.
+ */
+import { ActionDataBuilder, ActionDataConfig } from '../../data-builder-types';
+import { IFEntity } from "../../../src/index";
+/**
+ * Build examining action success data
+ *
+ * Creates the complete data structure for examined events,
+ * including entity snapshots and trait-specific information.
+ */
+export declare const buildExaminingData: ActionDataBuilder<Record<string, unknown>>;
+/**
+ * Result of building message parameters for examining
+ */
+export interface ExaminingMessageResult {
+    messageId: string;
+    params: Record<string, any>;
+    /** Additional message for container/supporter contents */
+    contentsMessage?: {
+        messageId: string;
+        params: Record<string, any>;
+    };
+}
+/**
+ * Build message parameters for examining action
+ *
+ * Creates the parameters needed for text generation based on
+ * the entity's traits and state. Also returns an optional
+ * contentsMessage for containers/supporters with visible items.
+ */
+export declare function buildExaminingMessageParams(eventData: Record<string, unknown>, noun: IFEntity): ExaminingMessageResult;
+/**
+ * Configuration for examining data builder
+ *
+ * Allows stories to extend the data while protecting core fields
+ */
+export declare const examiningDataConfig: ActionDataConfig<Record<string, unknown>>;
+//# sourceMappingURL=examining-data.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"examining-data.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/examining/examining-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE/E,OAAO,EAAyB,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKvE;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAuHzE,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,0DAA0D;IAC1D,eAAe,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC;CACtE;AAED;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,IAAI,EAAE,QAAQ,GACb,sBAAsB,CAyFxB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzE,CAAC"}

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

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * Data builder for examining action
+ *
+ * Centralizes all entity snapshot and event data logic for the examining action.
+ * This separates data structure concerns from business logic.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.examiningDataConfig = exports.buildExaminingData = void 0;
+exports.buildExaminingMessageParams = buildExaminingMessageParams;
+const world_model_1 = require("../../../src/index.js");
+const world_model_2 = require("../../../src/index.js");
+const snapshot_utils_1 = require("../../base/snapshot-utils");
+/**
+ * Build examining action success data
+ *
+ * Creates the complete data structure for examined events,
+ * including entity snapshots and trait-specific information.
+ */
+const buildExaminingData = (context, preState, postState) => {
+    const actor = context.player;
+    const noun = context.command.directObject?.entity;
+    if (!noun) {
+        // Shouldn't happen if validation passed, but handle gracefully
+        return {
+            targetId: '',
+            targetName: 'nothing'
+        };
+    }
+    const isSelf = noun.id === actor.id;
+    // Capture complete entity snapshot for atomic event
+    const entitySnapshot = (0, snapshot_utils_1.captureEntitySnapshot)(noun, context.world, true);
+    // Build base event data
+    const eventData = {
+        // New atomic structure
+        target: entitySnapshot,
+        // Backward compatibility fields
+        targetId: noun.id,
+        targetName: isSelf ? 'yourself' : noun.name
+    };
+    if (isSelf) {
+        eventData.self = true;
+        return eventData; // No trait checking for self-examination
+    }
+    // Add trait-specific information
+    // Identity trait (description/brief)
+    if (noun.has(world_model_1.TraitType.IDENTITY)) {
+        const identityTrait = noun.get(world_model_1.TraitType.IDENTITY);
+        if (identityTrait) {
+            eventData.hasDescription = !!identityTrait.description;
+            eventData.hasBrief = !!identityTrait.brief;
+        }
+    }
+    // Container trait
+    if (noun.has(world_model_1.TraitType.CONTAINER)) {
+        const contents = context.world.getContents(noun.id);
+        const contentsSnapshots = (0, snapshot_utils_1.captureEntitySnapshots)(contents, context.world);
+        eventData.isContainer = true;
+        eventData.hasContents = contents.length > 0;
+        eventData.contentCount = contents.length;
+        // New: full snapshots
+        eventData.contentsSnapshots = contentsSnapshots;
+        // Backward compatibility: simple references
+        eventData.contents = contents.map(e => ({ id: e.id, name: e.name }));
+        // Check if open/closed
+        if (noun.has(world_model_1.TraitType.OPENABLE)) {
+            eventData.isOpenable = true;
+            eventData.isOpen = world_model_2.OpenableBehavior.isOpen(noun);
+        }
+        else {
+            eventData.isOpen = true; // Containers without openable trait are always open
+        }
+    }
+    // Supporter trait
+    if (noun.has(world_model_1.TraitType.SUPPORTER)) {
+        const contents = context.world.getContents(noun.id);
+        const contentsSnapshots = (0, snapshot_utils_1.captureEntitySnapshots)(contents, context.world);
+        eventData.isSupporter = true;
+        eventData.hasContents = contents.length > 0;
+        eventData.contentCount = contents.length;
+        // New: full snapshots
+        eventData.contentsSnapshots = contentsSnapshots;
+        // Backward compatibility: simple references
+        eventData.contents = contents.map(e => ({ id: e.id, name: e.name }));
+    }
+    // Switchable trait
+    if (noun.has(world_model_1.TraitType.SWITCHABLE)) {
+        eventData.isSwitchable = true;
+        eventData.isOn = world_model_2.SwitchableBehavior.isOn(noun);
+    }
+    // Readable trait
+    if (noun.has(world_model_1.TraitType.READABLE)) {
+        const readableTrait = noun.get(world_model_1.TraitType.READABLE);
+        eventData.isReadable = true;
+        eventData.hasText = readableTrait ? !!readableTrait.text : false;
+    }
+    // Wearable trait
+    if (noun.has(world_model_1.TraitType.WEARABLE)) {
+        eventData.isWearable = true;
+        eventData.isWorn = world_model_2.WearableBehavior.isWorn(noun);
+    }
+    // Door trait
+    if (noun.has(world_model_1.TraitType.DOOR)) {
+        eventData.isDoor = true;
+        // Check if door is openable
+        if (noun.has(world_model_1.TraitType.OPENABLE)) {
+            eventData.isOpenable = true;
+            eventData.isOpen = world_model_2.OpenableBehavior.isOpen(noun);
+        }
+        // Add lock status
+        if (noun.has(world_model_1.TraitType.LOCKABLE)) {
+            eventData.isLockable = true;
+            eventData.isLocked = world_model_2.LockableBehavior.isLocked(noun);
+        }
+    }
+    return eventData;
+};
+exports.buildExaminingData = buildExaminingData;
+/**
+ * Build message parameters for examining action
+ *
+ * Creates the parameters needed for text generation based on
+ * the entity's traits and state. Also returns an optional
+ * contentsMessage for containers/supporters with visible items.
+ */
+function buildExaminingMessageParams(eventData, noun) {
+    const params = {};
+    let messageId = eventData.self ? 'examined_self' : 'examined';
+    let contentsMessage = undefined;
+    if (!eventData.self && noun) {
+        // Add trait-specific parameters
+        // Add description text if available
+        if (eventData.hasDescription && noun.has(world_model_1.TraitType.IDENTITY)) {
+            const identityTrait = noun.get(world_model_1.TraitType.IDENTITY);
+            if (identityTrait?.description) {
+                params.description = identityTrait.description;
+            }
+        }
+        // Container-specific message
+        if (eventData.isContainer) {
+            messageId = 'examined_container';
+            params.isOpen = eventData.isOpen;
+            // Add contents message if container is open and has contents
+            if (eventData.isOpen && eventData.hasContents && eventData.contents) {
+                const contents = eventData.contents;
+                const itemNames = contents.map(c => c.name).join(', ');
+                contentsMessage = {
+                    messageId: 'container_contents',
+                    params: {
+                        container: noun.name,
+                        items: itemNames
+                    }
+                };
+            }
+        }
+        // Supporter-specific message (only if not also a container)
+        else if (eventData.isSupporter) {
+            messageId = 'examined_supporter';
+            // Add contents message if supporter has contents
+            if (eventData.hasContents && eventData.contents) {
+                const contents = eventData.contents;
+                const itemNames = contents.map(c => c.name).join(', ');
+                contentsMessage = {
+                    messageId: 'surface_contents',
+                    params: {
+                        surface: noun.name,
+                        items: itemNames
+                    }
+                };
+            }
+        }
+        // Switchable-specific message
+        else if (eventData.isSwitchable) {
+            messageId = 'examined_switchable';
+            params.isOn = eventData.isOn;
+        }
+        // Readable-specific message
+        else if (eventData.isReadable && eventData.hasText && noun.has(world_model_1.TraitType.READABLE)) {
+            const readableTrait = noun.get(world_model_1.TraitType.READABLE);
+            if (readableTrait?.text) {
+                params.text = readableTrait.text;
+                messageId = 'examined_readable';
+            }
+        }
+        // Wearable-specific message
+        else if (eventData.isWearable) {
+            messageId = 'examined_wearable';
+            params.isWorn = eventData.isWorn;
+        }
+        // Door-specific message
+        else if (eventData.isDoor) {
+            messageId = 'examined_door';
+            if (eventData.isLocked !== undefined) {
+                params.isLocked = eventData.isLocked;
+            }
+        }
+        // Default parameters for basic examined message
+        else if (messageId === 'examined') {
+            params.target = noun.name;
+        }
+    }
+    return { messageId, params, contentsMessage };
+}
+/**
+ * Configuration for examining data builder
+ *
+ * Allows stories to extend the data while protecting core fields
+ */
+exports.examiningDataConfig = {
+    builder: exports.buildExaminingData,
+    protectedFields: ['targetId', 'targetName', 'target']
+};
+//# sourceMappingURL=examining-data.js.map

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

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

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

@@ -0,0 +1,66 @@
+/**
+ * Event data types for the examining action
+ *
+ * These interfaces define the structure of data emitted by the examining action
+ */
+import { EntityId } from "../../../src/index";
+/**
+ * Data for the 'if.event.examined' event
+ *
+ * Emitted when an entity is examined. Contains comprehensive information
+ * about the examined entity's traits and state.
+ */
+export interface ExaminedEventData {
+    /** Full entity snapshot (new atomic pattern) */
+    target?: any;
+    /** Full snapshots of contents (new atomic pattern) */
+    contentsSnapshots?: any[];
+    /** ID of the examined entity (backward compatibility) */
+    targetId: EntityId;
+    /** Name of the examined entity (backward compatibility) */
+    targetName: string;
+    /** True if examining yourself */
+    self?: boolean;
+    /** Identity trait information */
+    hasDescription?: boolean;
+    hasBrief?: boolean;
+    /** Container trait information */
+    isContainer?: boolean;
+    hasContents?: boolean;
+    contentCount?: number;
+    contents?: Array<{
+        id: EntityId;
+        name: string;
+    }>;
+    /** Openable trait information */
+    isOpenable?: boolean;
+    isOpen?: boolean;
+    /** Supporter trait information */
+    isSupporter?: boolean;
+    /** Switchable trait information */
+    isSwitchable?: boolean;
+    isOn?: boolean;
+    /** Readable trait information */
+    isReadable?: boolean;
+    hasText?: boolean;
+    /** Wearable trait information */
+    isWearable?: boolean;
+    isWorn?: boolean;
+    /** Door trait information */
+    isDoor?: boolean;
+    /** Lockable trait information */
+    isLockable?: boolean;
+    isLocked?: boolean;
+}
+/**
+ * Data for 'action.error' events from examining action
+ */
+export interface ExaminingErrorData {
+    /** The specific error reason */
+    reason: 'no_target' | 'not_visible';
+    /** Name of the target (when applicable) */
+    target?: string;
+    /** Additional context for the error */
+    details?: Record<string, any>;
+}
+//# sourceMappingURL=examining-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"examining-events.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/examining/examining-events.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,MAAM,CAAC,EAAE,GAAG,CAAC;IAEb,sDAAsD;IACtD,iBAAiB,CAAC,EAAE,GAAG,EAAE,CAAC;IAE1B,yDAAyD;IACzD,QAAQ,EAAE,QAAQ,CAAC;IAEnB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IAEnB,iCAAiC;IACjC,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,iCAAiC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,kCAAkC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,QAAQ,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAEjD,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,kCAAkC;IAClC,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,mCAAmC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB,iCAAiC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,MAAM,EACF,WAAW,GACX,aAAa,CAAC;IAElB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC/B"}

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

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Event data types for the examining action
+ *
+ * These interfaces define the structure of data emitted by the examining action
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=examining-events.js.map

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

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

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

@@ -0,0 +1,23 @@
+/**
+ * Message constants for the examining action
+ *
+ * These constants provide type safety for message IDs within stdlib.
+ * The lang-en-us package uses matching string literals (stable, injected at runtime).
+ */
+export declare const ExaminingMessages: {
+    readonly NO_TARGET: "no_target";
+    readonly NOT_VISIBLE: "not_visible";
+    readonly EXAMINED: "examined";
+    readonly EXAMINED_SELF: "examined_self";
+    readonly EXAMINED_CONTAINER: "examined_container";
+    readonly EXAMINED_SUPPORTER: "examined_supporter";
+    readonly EXAMINED_READABLE: "examined_readable";
+    readonly EXAMINED_SWITCHABLE: "examined_switchable";
+    readonly EXAMINED_WEARABLE: "examined_wearable";
+    readonly EXAMINED_DOOR: "examined_door";
+    readonly NOTHING_SPECIAL: "nothing_special";
+    readonly DESCRIPTION: "description";
+    readonly BRIEF_DESCRIPTION: "brief_description";
+};
+export type ExaminingMessageId = typeof ExaminingMessages[keyof typeof ExaminingMessages];
+//# sourceMappingURL=examining-messages.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"examining-messages.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/examining/examining-messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;CAiBpB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,OAAO,iBAAiB,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC"}