@sharpee/stdlib 0.9.107 → 0.9.109

package/dist/actions/standard/eating/eating.js

@@ -0,0 +1,228 @@
+"use strict";
+/**
+ * Eating action - consume edible items
+ *
+ * This action handles eating items that have the EDIBLE trait.
+ * It validates that the item is edible and not a drink.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check if item is reachable, edible, not a drink, and not consumed
+ * 2. execute: Delegate to EdibleBehavior for consumption
+ * 3. blocked: Generate events when validation fails
+ * 4. report: Generate success events
+ *
+ * Supports implicit take - "eat apple" when apple is on ground will
+ * automatically take it first.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.eatingAction = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const constants_1 = require("../../constants");
+const types_1 = require("../../../scope/types");
+function getEatingSharedData(context) {
+    return context.sharedData;
+}
+exports.eatingAction = {
+    id: constants_1.IFActions.EATING,
+    // Default scope requirements for this action's slots
+    defaultScope: {
+        item: types_1.ScopeLevel.REACHABLE
+    },
+    // ADR-104: Implicit inference requirements
+    targetRequirements: {
+        trait: world_model_1.TraitType.EDIBLE,
+        description: 'edible'
+    },
+    // Eating requires holding the food
+    requiresHolding: true,
+    requiredMessages: [
+        'no_item',
+        'not_visible',
+        'not_reachable',
+        'not_edible',
+        'is_drink',
+        'already_consumed',
+        'eaten',
+        'eaten_all',
+        'eaten_some',
+        'delicious',
+        'tasty',
+        'bland',
+        'awful',
+        'filling',
+        'still_hungry',
+        'poisonous'
+    ],
+    metadata: {
+        requiresDirectObject: true,
+        requiresIndirectObject: false,
+        directObjectScope: types_1.ScopeLevel.REACHABLE
+    },
+    validate(context) {
+        const item = context.command.directObject?.entity;
+        // Must have an item to eat
+        if (!item) {
+            return {
+                valid: false,
+                error: 'no_item'
+            };
+        }
+        // Check scope - must be able to reach the item
+        const scopeCheck = context.requireScope(item, types_1.ScopeLevel.REACHABLE);
+        if (!scopeCheck.ok) {
+            return scopeCheck.error;
+        }
+        // Check if item is edible
+        if (!item.has(world_model_1.TraitType.EDIBLE)) {
+            return {
+                valid: false,
+                error: 'not_edible',
+                params: { item: item.name }
+            };
+        }
+        // Use behavior for liquid check (it's a drink, not food)
+        if (world_model_1.EdibleBehavior.isLiquid(item)) {
+            return {
+                valid: false,
+                error: 'is_drink',
+                params: { item: item.name }
+            };
+        }
+        // Use behavior for consumption check (servings > 0)
+        if (!world_model_1.EdibleBehavior.canConsume(item)) {
+            return {
+                valid: false,
+                error: 'already_consumed',
+                params: { item: item.name }
+            };
+        }
+        // Implicit take - "eat apple" when apple is on ground
+        const carryCheck = context.requireCarriedOrImplicitTake(item);
+        if (!carryCheck.ok) {
+            return carryCheck.error;
+        }
+        return { valid: true };
+    },
+    /**
+     * Execute the eat action - performs mutations only
+     * Assumes validation has already passed
+     */
+    execute(context) {
+        const item = context.command.directObject.entity;
+        const actor = context.player;
+        // Capture state before mutation for event data
+        const servingsBefore = world_model_1.EdibleBehavior.getServings(item);
+        const nutrition = world_model_1.EdibleBehavior.getNutrition(item);
+        const taste = world_model_1.EdibleBehavior.getTaste(item);
+        const effects = world_model_1.EdibleBehavior.getEffects(item);
+        const satisfiesHunger = world_model_1.EdibleBehavior.satisfiesHunger(item);
+        // Delegate to behavior for consumption (decrements servings)
+        world_model_1.EdibleBehavior.consume(item, actor);
+        // Calculate servings remaining after consumption
+        const servingsRemaining = world_model_1.EdibleBehavior.getServings(item);
+        // Build event data
+        const eventData = {
+            item: item.id,
+            itemName: item.name
+        };
+        // Add nutritional information if available
+        if (nutrition !== undefined && nutrition !== 1) {
+            eventData.nutrition = nutrition;
+        }
+        // Include servings info for multi-serving food (servingsBefore > 1)
+        // Note: We can't detect if single-serving food was originally multi-serving
+        // after all but one serving was consumed. This is a known limitation.
+        if (servingsBefore > 1) {
+            eventData.servings = servingsBefore;
+            eventData.servingsRemaining = servingsRemaining;
+        }
+        // Add effects if present
+        if (effects && effects.length > 0) {
+            eventData.effects = effects;
+        }
+        // Add hunger satisfaction if set
+        if (satisfiesHunger !== undefined) {
+            eventData.satisfiesHunger = satisfiesHunger;
+        }
+        // Determine message based on properties
+        let messageId = 'eaten';
+        // Message priority: effects > taste > servings > hunger > default
+        if (effects && effects.includes('poison')) {
+            messageId = 'poisonous';
+        }
+        else if (taste) {
+            switch (taste) {
+                case 'delicious':
+                    messageId = 'delicious';
+                    break;
+                case 'tasty':
+                case 'good':
+                    messageId = 'tasty';
+                    break;
+                case 'bland':
+                case 'plain':
+                    messageId = 'bland';
+                    break;
+                case 'awful':
+                case 'terrible':
+                    messageId = 'awful';
+                    break;
+            }
+        }
+        else if (servingsBefore > 1 && servingsRemaining > 0) {
+            // Multi-serving food with servings remaining
+            messageId = 'eaten_some';
+        }
+        else if (servingsBefore > 1 && servingsRemaining === 0) {
+            // Finished all servings of multi-serving food (e.g., ate 2-serving food going to 0)
+            messageId = 'eaten_all';
+        }
+        else if (satisfiesHunger === true) {
+            messageId = 'filling';
+        }
+        else if (satisfiesHunger === false) {
+            messageId = 'still_hungry';
+        }
+        // Store in sharedData for report phase
+        const sharedData = getEatingSharedData(context);
+        sharedData.itemId = item.id;
+        sharedData.itemName = item.name;
+        sharedData.messageId = messageId;
+        sharedData.eventData = eventData;
+    },
+    /**
+     * Generate events when validation fails
+     */
+    blocked(context, result) {
+        const item = context.command.directObject?.entity;
+        return [context.event('if.event.eaten', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: { item: item?.name, ...result.params },
+                reason: result.error,
+                itemId: item?.id,
+                itemName: item?.name
+            })];
+    },
+    /**
+     * Report phase - generates all events after successful execution
+     */
+    report(context) {
+        const events = [];
+        const sharedData = getEatingSharedData(context);
+        // Prepend any implicit take events (from requireCarriedOrImplicitTake)
+        if (context.sharedData.implicitTakeEvents) {
+            events.push(...context.sharedData.implicitTakeEvents);
+        }
+        // Emit the EATEN event with messageId for text rendering
+        // eventData already contains item (id) and itemName (string)
+        events.push(context.event('if.event.eaten', {
+            messageId: `${context.action.id}.${sharedData.messageId}`,
+            params: { item: sharedData.eventData?.itemName },
+            ...sharedData.eventData
+        }));
+        return events;
+    },
+    group: "interaction"
+};
+//# sourceMappingURL=eating.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../src/actions/standard/eating/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,kDAAgC"}

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

@@ -0,0 +1,42 @@
+/**
+ * Event type definitions for the entering action
+ */
+import { EntityId } from '@sharpee/core';
+/**
+ * Event data for when an actor enters something
+ */
+export interface EnteredEventData {
+    /** The entity being entered */
+    targetId: EntityId;
+    /** Location the actor was in before entering */
+    fromLocation?: EntityId;
+    /** Preposition used ('in' or 'on') */
+    preposition: 'in' | 'on';
+}
+/**
+ * Error data for entering failures
+ */
+export interface EnteringErrorData {
+    reason: 'no_target' | 'not_enterable' | 'already_inside' | 'container_closed' | 'too_full' | 'cant_enter';
+    place?: string;
+    container?: string;
+    occupants?: number;
+    max?: number;
+}
+/**
+ * Complete event map for entering action
+ */
+export interface EnteringEventMap {
+    'if.event.entered': EnteredEventData;
+    'action.success': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+    'action.error': {
+        actionId: string;
+        messageId: string;
+        params?: Record<string, any>;
+    };
+}
+//# sourceMappingURL=entering-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entering-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/entering/entering-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,QAAQ,EAAE,QAAQ,CAAC;IAEnB,gDAAgD;IAChD,YAAY,CAAC,EAAE,QAAQ,CAAC;IAExB,sCAAsC;IACtC,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,WAAW,GAAG,eAAe,GAAG,gBAAgB,GAChD,kBAAkB,GAAG,UAAU,GAAG,YAAY,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,gBAAgB,CAAC;IACrC,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/entering/entering-events.js.map

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

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

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

package/dist/actions/standard/entering/entering-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entering-messages.js","sourceRoot":"","sources":["../../../../../../../src/actions/standard/entering/entering-messages.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACU,QAAA,gBAAgB,GAAG;IAC9B,SAAS,EAAE,WAAW;IACtB,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IACpC,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,UAAU,EAAE,YAAY;IACxB,UAAU,EAAE,YAAY;IACxB,aAAa,EAAE,eAAe;CACtB,CAAC"}

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

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

package/dist/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("@sharpee/world-model");
+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/dist/actions/standard/entering/entering.js.map

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../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/dist/actions/standard/entering/index.js.map

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

package/dist/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 '@sharpee/world-model';
+/**
+ * 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/dist/actions/standard/examining/examining-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"examining-data.d.ts","sourceRoot":"","sources":["../../../../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,EAAgC,MAAM,sBAAsB,CAAC;AAKrG;;;;;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,CAsFxB;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzE,CAAC"}