@sharpee/stdlib 0.9.66-beta → 0.9.69-beta

package/actions/standard/going/going.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Going action - movement through exits
+ *
+ * This action handles movement in cardinal directions and through named exits.
+ * It validates all conditions and returns appropriate events.
+ *
+ * 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)
+ */
+import { Action, ActionContext } from '../../enhanced-types';
+import { IFEntity, DirectionType, ActionInterceptor, InterceptorSharedData } from "../../../src/index";
+import { ActionMetadata } from '../../../validation';
+/**
+ * Shared data passed between execute and report phases.
+ * Now includes interceptor data for ADR-118 support.
+ */
+export interface GoingSharedData {
+    isFirstVisit?: boolean;
+    previousLocation?: string;
+    currentLocation?: string;
+    direction?: DirectionType;
+    vehicleId?: string;
+    /** Interceptor found during validate, if any */
+    interceptor?: ActionInterceptor;
+    /** Shared data for interceptor phases */
+    interceptorData?: InterceptorSharedData;
+    /** Source room entity for interceptor lookups */
+    sourceRoom?: IFEntity;
+}
+export declare function getGoingSharedData(context: ActionContext): GoingSharedData;
+export declare const goingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=going.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"going.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/going/going.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAoB,MAAM,sBAAsB,CAAC;AAE/E,OAAO,EAEL,QAAQ,EAMR,aAAa,EAGb,iBAAiB,EACjB,qBAAqB,EACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgBrD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,yCAAyC;IACzC,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,iDAAiD;IACjD,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,CAE1E;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAkY5D,CAAC"}

package/actions/standard/going/going.js

@@ -0,0 +1,370 @@
+"use strict";
+/**
+ * Going action - movement through exits
+ *
+ * This action handles movement in cardinal directions and through named exits.
+ * It validates all conditions and returns appropriate events.
+ *
+ * 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.goingAction = void 0;
+exports.getGoingSharedData = getGoingSharedData;
+const world_model_1 = require("../../../src/index.js");
+const constants_1 = require("../../constants");
+const types_1 = require("../../../scope/types");
+const snapshot_utils_1 = require("../../base/snapshot-utils");
+const data_builder_types_1 = require("../../data-builder-types");
+const going_messages_1 = require("./going-messages");
+// Import our data builders
+const going_data_1 = require("./going-data");
+function getGoingSharedData(context) {
+    return context.sharedData;
+}
+exports.goingAction = {
+    id: constants_1.IFActions.GOING,
+    requiredMessages: [
+        'no_direction',
+        'not_in_room',
+        'no_exits',
+        'no_exit_that_way',
+        'movement_blocked',
+        'door_closed',
+        'door_locked',
+        'destination_not_found',
+        'moved',
+        'moved_to',
+        'first_visit',
+        'too_dark',
+        'need_light'
+    ],
+    validate(context) {
+        const actor = context.player;
+        const sharedData = getGoingSharedData(context);
+        // Get the direction from the parsed command (should already be a Direction constant)
+        // Direction can come from extras or from directObject name
+        let direction = context.command.parsed.extras?.direction;
+        // If no direction in extras, check if directObject has a name that could be a direction
+        if (!direction && context.command.directObject?.entity) {
+            const entityName = context.command.directObject.entity.name ||
+                context.command.directObject.entity.attributes?.name;
+            if (entityName) {
+                direction = entityName;
+            }
+        }
+        if (!direction) {
+            return {
+                valid: false,
+                error: going_messages_1.GoingMessages.NO_DIRECTION
+            };
+        }
+        // Check if player is in a vehicle
+        const walkCheck = (0, world_model_1.canActorWalkInVehicle)(context.world, actor.id);
+        let currentRoom = context.currentLocation;
+        if (walkCheck.vehicle) {
+            // Player is in a vehicle - check if walking is allowed
+            if (!walkCheck.canWalk) {
+                // In a vehicle that blocks walking (bucket, etc.)
+                return {
+                    valid: false,
+                    error: going_messages_1.GoingMessages.NOT_IN_ROOM,
+                    params: { vehicle: walkCheck.vehicle?.name }
+                };
+            }
+            // In a vehicle that allows walking (boat, etc.) - get the containing room
+            const containingRoom = context.world.getContainingRoom(actor.id);
+            if (containingRoom) {
+                currentRoom = containingRoom;
+                // Store vehicle ID so execute() can move the vehicle instead of the player
+                sharedData.vehicleId = context.world.getLocation(actor.id);
+            }
+        }
+        if (!currentRoom.has(world_model_1.TraitType.ROOM)) {
+            // Player is in a container that's not in a room
+            return {
+                valid: false,
+                error: going_messages_1.GoingMessages.NOT_IN_ROOM
+            };
+        }
+        // Check for interceptor on the source room (ADR-118)
+        // Interceptors on rooms can block or modify movement attempts
+        const interceptorResult = (0, world_model_1.getInterceptorForAction)(currentRoom, constants_1.IFActions.GOING);
+        const interceptor = interceptorResult?.interceptor;
+        const interceptorData = {
+            // Pass direction info to interceptor
+            direction: direction
+        };
+        // Store for later phases
+        sharedData.interceptor = interceptor;
+        sharedData.interceptorData = interceptorData;
+        sharedData.sourceRoom = currentRoom;
+        // === PRE-VALIDATE HOOK ===
+        // Called before standard validation - can block early
+        if (interceptor?.preValidate) {
+            const result = interceptor.preValidate(currentRoom, context.world, actor.id, interceptorData);
+            if (result !== null) {
+                return {
+                    valid: result.valid,
+                    error: result.error,
+                    params: result.params
+                };
+            }
+        }
+        // Use RoomBehavior to get exit information
+        const exitConfig = world_model_1.RoomBehavior.getExit(currentRoom, direction);
+        if (!exitConfig) {
+            // Check if we have exits at all
+            const allExits = world_model_1.RoomBehavior.getAllExits(currentRoom);
+            if (allExits.size === 0) {
+                return {
+                    valid: false,
+                    error: going_messages_1.GoingMessages.NO_EXITS
+                };
+            }
+            return {
+                valid: false,
+                error: going_messages_1.GoingMessages.NO_EXIT_THAT_WAY,
+                params: { direction: direction }
+            };
+        }
+        // Check if exit is blocked
+        if (world_model_1.RoomBehavior.isExitBlocked(currentRoom, direction)) {
+            const blockedMessage = world_model_1.RoomBehavior.getBlockedMessage(currentRoom, direction) || "You can't go that way.";
+            return {
+                valid: false,
+                error: going_messages_1.GoingMessages.MOVEMENT_BLOCKED,
+                params: { direction: direction, message: blockedMessage }
+            };
+        }
+        // Check if there's a door/portal
+        if (exitConfig.via) {
+            const door = context.world.getEntity(exitConfig.via);
+            if (door) {
+                // Use behaviors to check door state
+                const isLocked = door.has(world_model_1.TraitType.LOCKABLE) && world_model_1.LockableBehavior.isLocked(door);
+                const isClosed = door.has(world_model_1.TraitType.OPENABLE) && !world_model_1.OpenableBehavior.isOpen(door);
+                if (isLocked) {
+                    return {
+                        valid: false,
+                        error: going_messages_1.GoingMessages.DOOR_LOCKED,
+                        params: {
+                            door: door.name,
+                            direction: direction,
+                            isClosed: isClosed,
+                            isLocked: true
+                        }
+                    };
+                }
+                if (isClosed) {
+                    return {
+                        valid: false,
+                        error: going_messages_1.GoingMessages.DOOR_CLOSED,
+                        params: { door: door.name, direction: direction }
+                    };
+                }
+            }
+        }
+        // Get destination
+        const destinationId = exitConfig.destination;
+        const destination = context.world.getEntity(destinationId);
+        if (!destination) {
+            // Destination doesn't exist
+            return {
+                valid: false,
+                error: going_messages_1.GoingMessages.DESTINATION_NOT_FOUND,
+                params: { direction: direction }
+            };
+        }
+        // Note: We allow entry to dark rooms - you just can't see.
+        // Darkness affects visibility (looking), not movement.
+        // This matches traditional IF behavior (e.g., Cloak of Darkness).
+        // === POST-VALIDATE HOOK ===
+        // Called after standard validation passes - can add entity-specific conditions
+        if (interceptor?.postValidate) {
+            const result = interceptor.postValidate(currentRoom, context.world, actor.id, interceptorData);
+            if (result !== null) {
+                return {
+                    valid: result.valid,
+                    error: result.error,
+                    params: result.params
+                };
+            }
+        }
+        return { valid: true };
+    },
+    execute(context) {
+        // Only perform the movement mutation
+        const actor = context.player;
+        const sharedData = getGoingSharedData(context);
+        // Get the source room - if in a vehicle, use containing room
+        let sourceRoom = context.currentLocation;
+        if (sharedData.vehicleId) {
+            const containingRoom = context.world.getContainingRoom(actor.id);
+            if (containingRoom) {
+                sourceRoom = containingRoom;
+            }
+        }
+        // Get direction from parsed command (should already be a Direction constant)
+        // Direction can come from extras or from directObject name
+        let direction = context.command.parsed.extras?.direction;
+        // If no direction in extras, check if directObject has a name that could be a direction
+        if (!direction && context.command.directObject?.entity) {
+            const entityName = context.command.directObject.entity.name ||
+                context.command.directObject.entity.attributes?.name;
+            if (entityName) {
+                direction = entityName;
+            }
+        }
+        // Get exit info and destination using behaviors
+        const exitConfig = world_model_1.RoomBehavior.getExit(sourceRoom, direction);
+        const destination = context.world.getEntity(exitConfig.destination);
+        // Check if this is the first time entering the destination
+        const isFirstVisit = !world_model_1.RoomBehavior.hasBeenVisited(destination);
+        // Store locations and state for report phase
+        sharedData.isFirstVisit = isFirstVisit;
+        sharedData.previousLocation = sourceRoom.id;
+        sharedData.currentLocation = destination.id;
+        sharedData.direction = direction;
+        // Move to destination - if in a vehicle, move the vehicle (player stays inside)
+        if (sharedData.vehicleId) {
+            context.world.moveEntity(sharedData.vehicleId, destination.id);
+        }
+        else {
+            context.world.moveEntity(actor.id, destination.id);
+        }
+        // Mark the destination room as visited
+        if (isFirstVisit) {
+            world_model_1.RoomBehavior.markVisited(destination, actor);
+        }
+        // === POST-EXECUTE HOOK ===
+        // Called after standard execution - can perform additional mutations
+        const interceptor = sharedData.interceptor;
+        const interceptorData = sharedData.interceptorData || {};
+        if (interceptor?.postExecute && sharedData.sourceRoom) {
+            interceptor.postExecute(sharedData.sourceRoom, context.world, actor.id, interceptorData);
+        }
+    },
+    /**
+     * Report events after successful movement
+     * Only called on success path - validation has already passed
+     */
+    report(context) {
+        const sharedData = getGoingSharedData(context);
+        // Get the actual destination room (not the stale context.currentLocation)
+        const destinationRoom = context.world.getEntity(sharedData.currentLocation);
+        // Build event data using data builders
+        const exitedData = (0, data_builder_types_1.buildEventData)(going_data_1.actorExitedDataConfig, context);
+        const movedData = (0, data_builder_types_1.buildEventData)(going_data_1.actorMovedDataConfig, context);
+        const enteredData = (0, data_builder_types_1.buildEventData)(going_data_1.actorEnteredDataConfig, context);
+        // Return movement events first (no messageId - these are for event sourcing/handlers)
+        const events = [
+            context.event('if.event.actor_exited', exitedData),
+            context.event('if.event.actor_moved', movedData),
+            context.event('if.event.actor_entered', enteredData)
+        ];
+        // Check if destination is dark (no usable light source)
+        const isDark = world_model_1.VisibilityBehavior.isDark(destinationRoom, context.world);
+        if (isDark) {
+            // Dark room with no light - emit went event with darkness messageId
+            events.push(context.event('if.event.went', {
+                messageId: `${context.action.id}.too_dark`,
+                params: {},
+                actorId: context.player.id,
+                destinationId: destinationRoom.id,
+                isDark: true
+            }));
+            return events;
+        }
+        // Room has light - build and emit room description
+        const roomSnapshot = (0, snapshot_utils_1.captureRoomSnapshot)(destinationRoom, context.world, false);
+        // Get visible contents in the destination room
+        const destinationContents = context.world.getContents(destinationRoom.id)
+            .filter(e => e.id !== context.player.id);
+        const visibleSnapshots = (0, snapshot_utils_1.captureEntitySnapshots)(destinationContents, context.world);
+        const roomDescData = {
+            room: roomSnapshot,
+            visibleItems: visibleSnapshots,
+            roomId: destinationRoom.id,
+            roomName: destinationRoom.name,
+            roomDescription: destinationRoom.description,
+            includeContents: true,
+            verbose: true, // Always verbose after movement
+            previousLocation: sharedData.previousLocation,
+            currentLocation: sharedData.currentLocation,
+            isDark: false,
+            contents: destinationContents.map(entity => ({
+                id: entity.id,
+                name: entity.name,
+                description: entity.description
+            }))
+        };
+        // Emit room description (specialized handler renders this)
+        events.push(context.event('if.event.room.description', roomDescData));
+        // Emit contents list if there are visible items
+        if (destinationContents.length > 0) {
+            const itemList = destinationContents.map(e => e.name).join(', ');
+            // Use looking's messageId namespace since this is auto-look
+            events.push(context.event('if.event.list.contents', {
+                messageId: 'if.action.looking.contents_list',
+                params: {
+                    items: itemList,
+                    count: destinationContents.length
+                },
+                locationId: destinationRoom.id,
+                itemIds: destinationContents.map(e => e.id),
+                itemNames: destinationContents.map(e => e.name)
+            }));
+        }
+        // === POST-REPORT HOOK ===
+        // Called after standard report - can add additional effects
+        const interceptor = sharedData.interceptor;
+        const interceptorData = sharedData.interceptorData || {};
+        if (interceptor?.postReport && sharedData.sourceRoom) {
+            const additionalEffects = interceptor.postReport(sharedData.sourceRoom, 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 sharedData = getGoingSharedData(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 && sharedData.sourceRoom && result.error) {
+            const customEffects = interceptor.onBlocked(sharedData.sourceRoom, 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.went', {
+                blocked: true,
+                reason: result.error,
+                messageId: `${context.action.id}.${result.error}`,
+                params: result.params || {},
+                actorId: context.player.id
+            })];
+    },
+    group: "movement",
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false,
+        directObjectScope: types_1.ScopeLevel.VISIBLE
+    }
+};
+// Note: Darkness checking for rooms should use VisibilityBehavior.isDark()
+// which is the single source of truth (see ADR-068)
+//# sourceMappingURL=going.js.map

package/actions/standard/going/going.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Going action module
+ *
+ * Exports the going action and its associated event types
+ */
+export { goingAction } from './going';
+export type { ActorMovedEventData, ActorExitedEventData, ActorEnteredEventData, GoingErrorData } from './going-events';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/going/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,cAAc,EACf,MAAM,gBAAgB,CAAC"}

package/actions/standard/going/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Going action module
+ *
+ * Exports the going action and its associated event types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.goingAction = void 0;
+var going_1 = require("./going");
+Object.defineProperty(exports, "goingAction", { enumerable: true, get: function () { return going_1.goingAction; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/going/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,iCAAsC;AAA7B,oGAAA,WAAW,OAAA"}

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

@@ -0,0 +1,42 @@
+/**
+ * Event type definitions for the help action
+ */
+/**
+ * Event data for when help is displayed
+ * Uses domain event pattern with embedded messageId (ADR-097)
+ */
+export interface HelpDisplayedEventData {
+    /** Message ID for text-service lookup */
+    messageId?: string;
+    /** Parameters for message template substitution */
+    params?: {
+        topic?: string;
+        sections?: string[];
+        hintsAvailable?: boolean;
+    };
+    /** Whether general help was requested */
+    generalHelp?: boolean;
+    /** Whether help for a specific topic was requested */
+    specificHelp?: boolean;
+    /** The type of help being displayed */
+    helpType?: string;
+    /** The specific topic/action requested help for */
+    helpRequest?: string;
+    /** Whether this is the first time help was requested */
+    firstTime?: boolean;
+    /** Available help sections */
+    sections?: string[];
+    /** Whether hints are available in the game */
+    hintsAvailable?: boolean;
+    /** Whether this is a blocked/error case */
+    blocked?: boolean;
+    /** Reason for block (if blocked) */
+    reason?: string;
+}
+/**
+ * Complete event map for help action
+ */
+export interface HelpEventMap {
+    'if.event.help_displayed': HelpDisplayedEventData;
+}
+//# sourceMappingURL=help-events.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help-events.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/help/help-events.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;IAGF,yCAAyC;IACzC,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,sDAAsD;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,uCAAuC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,wDAAwD;IACxD,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB,EAAE,sBAAsB,CAAC;CACnD"}

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

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

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

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

package/actions/standard/help/help.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Help action - displays help information
+ *
+ * This is a meta action that provides gameplay instructions
+ * and command information to the player.
+ *
+ * Updated to support automated help generation from LanguageProvider.
+ * The action emits events with the requested help type/action,
+ * and the text service retrieves the actual help content.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Always succeeds (no preconditions)
+ * 2. execute: Analyze help request (no world mutations)
+ * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 4. report: Emit help_displayed event
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const helpAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../../../../../../mnt/c/repotemp/sharpee/packages/stdlib/src/actions/standard/help/help.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAmErD,eAAO,MAAM,UAAU,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA0E3D,CAAC"}