@sharpee/stdlib 1.0.0 → 1.1.0

package/actions/context.js

@@ -1,272 +0,0 @@
-"use strict";
-/**
- * Read-only action context implementation
- *
- * Provides query methods for actions without allowing state mutations
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReadOnlyActionContext = void 0;
-const world_model_1 = require("../../world-model/index.js");
-const types_1 = require("../scope/types");
-/**
- * @deprecated Use createActionContext from enhanced-context.ts instead
- * This class is kept for backward compatibility but will be removed in Phase 4
- */
-class ReadOnlyActionContext {
-    world;
-    player;
-    currentLocation;
-    command;
-    action;
-    scopeResolver;
-    sharedData = {};
-    constructor(world, player, currentLocation, command, action, scopeResolver) {
-        this.world = world;
-        this.player = player;
-        this.currentLocation = currentLocation;
-        this.command = command;
-        // Temporary compatibility - action is required by interface but this class is deprecated
-        this.action = action || {
-            id: 'unknown',
-            validate: () => ({ valid: true }),
-            execute: () => []
-        };
-        this.scopeResolver = scopeResolver || {}; // Temporary fix for deprecated class
-    }
-    /**
-     * Check if an entity is visible to the player
-     */
-    canSee(entity) {
-        return this.world.canSee(this.player.id, entity.id);
-    }
-    /**
-     * Check if an entity is physically reachable by the player
-     *
-     * An entity is reachable if:
-     * 1. It's in the same location as the player
-     * 2. It's held by the player
-     * 3. It's in an open container in the same location
-     * 4. It's on a supporter in the same location
-     */
-    canReach(entity) {
-        const entityLocation = this.world.getLocation(entity.id);
-        // Held by player
-        if (entityLocation === this.player.id) {
-            return true;
-        }
-        // In same location as player
-        if (entityLocation === this.currentLocation.id) {
-            return true;
-        }
-        // In an accessible container/supporter
-        if (entityLocation) {
-            const container = this.world.getEntity(entityLocation);
-            if (container) {
-                const containerLocation = this.world.getLocation(container.id);
-                // Container is in same location as player
-                if (containerLocation === this.currentLocation.id) {
-                    // Check if it's an open container
-                    if (container.has('container')) {
-                        const openableTrait = container.getTrait(world_model_1.OpenableTrait);
-                        if (!openableTrait || openableTrait.isOpen) {
-                            return true;
-                        }
-                    }
-                    // Or a supporter (always accessible)
-                    if (container.has('supporter')) {
-                        return true;
-                    }
-                }
-                // Container is held by player
-                if (containerLocation === this.player.id) {
-                    // Check if it's an open container
-                    if (container.has('container')) {
-                        const openableTrait = container.getTrait(world_model_1.OpenableTrait);
-                        if (!openableTrait || openableTrait.isOpen) {
-                            return true;
-                        }
-                    }
-                }
-            }
-        }
-        return false;
-    }
-    /**
-     * Check if an entity can be taken by the player
-     *
-     * An entity can be taken if:
-     * 1. It's visible
-     * 2. It's reachable
-     * 3. It's not a room
-     * 4. It's not scenery (fixed in place)
-     * 5. It's not already held by the player
-     */
-    canTake(entity) {
-        // Must be visible
-        if (!this.canSee(entity)) {
-            return false;
-        }
-        // Must be reachable
-        if (!this.canReach(entity)) {
-            return false;
-        }
-        // Can't take rooms
-        if (entity.has('room')) {
-            return false;
-        }
-        // Can't take scenery
-        if (entity.has('scenery')) {
-            return false;
-        }
-        // Already held
-        const location = this.world.getLocation(entity.id);
-        if (location === this.player.id) {
-            return false;
-        }
-        return true;
-    }
-    /**
-     * Check if an entity is in scope for the player
-     */
-    isInScope(entity) {
-        const inScopeEntities = this.world.getInScope(this.player.id);
-        return inScopeEntities.some(e => e.id === entity.id);
-    }
-    /**
-     * Get all entities visible to the player
-     */
-    getVisible() {
-        return this.world.getVisible(this.player.id);
-    }
-    /**
-     * Get all entities in scope for the player
-     */
-    getInScope() {
-        return this.world.getInScope(this.player.id);
-    }
-    /**
-     * Get capability data (convenience method)
-     */
-    getCapability(name) {
-        return this.world.getCapability(name);
-    }
-    /**
-     * Event creation method (required by ActionContext interface)
-     * @deprecated This implementation throws an error - use createActionContext instead
-     */
-    event(type, data) {
-        throw new Error('ReadOnlyActionContext does not support event creation. Use createActionContext from enhanced-context.ts instead.');
-    }
-    // =========================================================================
-    // Scope validation methods (Phase 4 - stub implementations for deprecated class)
-    // =========================================================================
-    /**
-     * Get the scope level for an entity.
-     * @deprecated This implementation returns basic scope levels - use createActionContext instead
-     */
-    getEntityScope(entity) {
-        // Basic implementation for deprecated class
-        const entityLocation = this.world.getLocation(entity.id);
-        // Carried - in player's inventory
-        if (entityLocation === this.player.id) {
-            return types_1.ScopeLevel.CARRIED;
-        }
-        // Reachable - in same location
-        if (entityLocation === this.currentLocation.id || this.canReach(entity)) {
-            return types_1.ScopeLevel.REACHABLE;
-        }
-        // Visible - can see but not reach
-        if (this.canSee(entity)) {
-            return types_1.ScopeLevel.VISIBLE;
-        }
-        // Not in scope
-        return types_1.ScopeLevel.UNAWARE;
-    }
-    /**
-     * Get the scope level for an entity in a command slot.
-     * @deprecated This implementation returns basic scope levels - use createActionContext instead
-     */
-    getSlotScope(slot) {
-        const slotMap = {
-            target: 'directObject',
-            item: 'directObject',
-            container: 'indirectObject',
-            recipient: 'indirectObject'
-        };
-        const commandSlot = slotMap[slot] || slot;
-        const ref = this.command[commandSlot];
-        const entity = ref?.entity;
-        if (!entity) {
-            return types_1.ScopeLevel.UNAWARE;
-        }
-        return this.getEntityScope(entity);
-    }
-    /**
-     * Check if an entity meets a required scope level.
-     * @deprecated This implementation is basic - use createActionContext instead
-     */
-    requireScope(entity, required) {
-        const actualScope = this.getEntityScope(entity);
-        if (actualScope >= required) {
-            return { ok: true, actualScope };
-        }
-        // Return appropriate error based on what's missing
-        let errorCode;
-        if (required === types_1.ScopeLevel.CARRIED) {
-            errorCode = 'scope.not_carried';
-        }
-        else if (required === types_1.ScopeLevel.REACHABLE) {
-            errorCode = 'scope.not_reachable';
-        }
-        else if (required === types_1.ScopeLevel.VISIBLE) {
-            errorCode = 'scope.not_visible';
-        }
-        else {
-            errorCode = 'scope.out_of_scope';
-        }
-        return {
-            ok: false,
-            actualScope,
-            error: {
-                valid: false,
-                error: errorCode,
-                params: { entityId: entity.id, entityName: entity.name, required, actual: actualScope }
-            }
-        };
-    }
-    /**
-     * Check if a command slot entity meets a required scope level.
-     * @deprecated This implementation is basic - use createActionContext instead
-     */
-    requireSlotScope(slot, required) {
-        const slotMap = {
-            target: 'directObject',
-            item: 'directObject',
-            container: 'indirectObject',
-            recipient: 'indirectObject'
-        };
-        const commandSlot = slotMap[slot] || slot;
-        const ref = this.command[commandSlot];
-        const entity = ref?.entity;
-        if (!entity) {
-            return {
-                ok: false,
-                error: {
-                    valid: false,
-                    error: 'scope.not_found',
-                    params: { slot }
-                }
-            };
-        }
-        return this.requireScope(entity, required);
-    }
-    /**
-     * Check if an entity is carried, attempting implicit take if needed.
-     * @deprecated This implementation throws an error - use createActionContext instead
-     */
-    requireCarriedOrImplicitTake(_entity) {
-        throw new Error('ReadOnlyActionContext does not support implicit takes. Use createActionContext from enhanced-context.ts instead.');
-    }
-}
-exports.ReadOnlyActionContext = ReadOnlyActionContext;
-//# sourceMappingURL=context.js.map

package/actions/context.js.map

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

package/actions/standard/inserting/inserting-semantic.d.ts

@@ -1,42 +0,0 @@
-/**
- * SEMANTIC VERSION: Inserting action - insert objects specifically into containers
- *
- * This version demonstrates how semantic grammar eliminates the need for:
- * - Modifying parsed commands to add implicit prepositions
- * - Checking verb.text for variations
- * - Tight coupling to parser internals
- *
- * Instead, the grammar provides semantic properties that tell us:
- * - spatialRelation: 'in' (normalized from 'in', 'into', or implicit)
- * - manner: how the insertion should be performed
- * - implicitPreposition: whether the user said "insert X Y" vs "insert X into Y"
- */
-import { IAction } from "../../../../if-domain/index";
-export declare const insertingActionSemantic: IAction;
-/**
- * Key improvements in this semantic version:
- *
- * 1. NO COMMAND MODIFICATION
- *    - The old version modified context.command.parsed to add 'in' preposition
- *    - This version trusts the grammar-provided semantics.spatialRelation
- *
- * 2. SEMANTIC-BASED BEHAVIOR
- *    - Different messages based on manner (forceful, careful, stealthy)
- *    - Sound events based on how the action was performed
- *    - Validation considers semantics (forceful + fragile = error)
- *
- * 3. CLEANER ARCHITECTURE
- *    - No delegation to putting action needed
- *    - No need to create modified contexts
- *    - Action is self-contained and focused
- *
- * 4. IMPLICIT PREPOSITION HANDLING
- *    - Grammar tells us if user said "insert X Y" via implicitPreposition flag
- *    - We can provide clearer feedback without hacking the command
- *
- * 5. NO PARSER COUPLING
- *    - Never accesses context.command.parsed
- *    - Never checks verb.text
- *    - Never looks at structure.preposition.text
- */ 
-//# sourceMappingURL=inserting-semantic.d.ts.map

package/actions/standard/inserting/inserting-semantic.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"inserting-semantic.d.ts","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/stdlib/src/actions/standard/inserting/inserting-semantic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,OAAO,EAAsD,MAAM,oBAAoB,CAAC;AAIjG,eAAO,MAAM,uBAAuB,EAAE,OAkMrC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG"}

package/actions/standard/inserting/inserting-semantic.js

@@ -1,219 +0,0 @@
-"use strict";
-/**
- * SEMANTIC VERSION: Inserting action - insert objects specifically into containers
- *
- * This version demonstrates how semantic grammar eliminates the need for:
- * - Modifying parsed commands to add implicit prepositions
- * - Checking verb.text for variations
- * - Tight coupling to parser internals
- *
- * Instead, the grammar provides semantic properties that tell us:
- * - spatialRelation: 'in' (normalized from 'in', 'into', or implicit)
- * - manner: how the insertion should be performed
- * - implicitPreposition: whether the user said "insert X Y" vs "insert X into Y"
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.insertingActionSemantic = void 0;
-exports.insertingActionSemantic = {
-    id: 'if.action.inserting',
-    requiredMessages: [
-        'no_target',
-        'no_destination',
-        'not_held',
-        'not_insertable',
-        'not_container',
-        'already_there',
-        'inserted',
-        'inserted_forcefully',
-        'inserted_carefully',
-        'wont_fit',
-        'container_closed'
-    ],
-    validate(context) {
-        const item = context.command.directObject?.entity;
-        const container = context.command.indirectObject?.entity;
-        const semantics = context.command.semantics || {};
-        // Validate we have an item
-        if (!item) {
-            return {
-                valid: false,
-                error: 'no_target'
-            };
-        }
-        // Validate we have a destination
-        if (!container) {
-            return {
-                valid: false,
-                error: 'no_destination',
-                params: { item: item.attributes.name || item.id }
-            };
-        }
-        // Check if player is holding the item
-        if (!context.canReach(item)) {
-            return {
-                valid: false,
-                error: 'not_held',
-                params: { item: item.attributes.name || item.id }
-            };
-        }
-        // Check if container is actually a container
-        // Note: IEntity doesn't have getCapability - need to check attributes
-        const capabilities = container.capabilities;
-        const containerData = (container.attributes?.['container'] || capabilities?.['container']);
-        if (!containerData) {
-            return {
-                valid: false,
-                error: 'not_container',
-                params: { container: container.attributes.name || container.id }
-            };
-        }
-        // Check if container is closed
-        if (containerData.closed) {
-            return {
-                valid: false,
-                error: 'container_closed',
-                params: { container: container.attributes.name || container.id }
-            };
-        }
-        // Check if item is already in container
-        if (context.getEntityLocation(item.id) === container.id) {
-            return {
-                valid: false,
-                error: 'already_there',
-                params: {
-                    item: item.attributes.name || item.id,
-                    container: container.attributes.name || container.id
-                }
-            };
-        }
-        // Check capacity if applicable
-        if (containerData.maxCapacity !== undefined) {
-            const contents = context.getEntityContents(container.id);
-            if (contents.length >= containerData.maxCapacity) {
-                return {
-                    valid: false,
-                    error: 'wont_fit',
-                    params: {
-                        item: item.attributes.name || item.id,
-                        container: container.attributes.name || container.id
-                    }
-                };
-            }
-        }
-        // Semantic validation: forceful insertion might damage fragile containers
-        if (semantics.manner === 'forceful' && container.attributes?.['fragile']) {
-            return {
-                valid: false,
-                error: 'would_damage',
-                params: {
-                    item: item.attributes.name || item.id,
-                    container: container.attributes.name || container.id
-                }
-            };
-        }
-        return { valid: true };
-    },
-    execute(context) {
-        // Revalidate
-        const validation = this.validate(context);
-        if (!validation.valid) {
-            return [context.event('if.event.insert_blocked', {
-                    messageId: `${this.id}.${validation.error}`,
-                    params: validation.params || {},
-                    reason: validation.error
-                })];
-        }
-        const item = context.command.directObject.entity;
-        const container = context.command.indirectObject.entity;
-        const semantics = context.command.semantics || {};
-        // Move the item into the container
-        const success = context.moveEntity(item.id, container.id);
-        if (!success) {
-            return [context.event('if.event.insert_blocked', {
-                    messageId: `${this.id}.insertion_failed`,
-                    params: {
-                        item: item.attributes.name || item.id,
-                        container: container.attributes.name || container.id
-                    },
-                    reason: 'insertion_failed'
-                })];
-        }
-        // Choose message based on semantic manner
-        let messageId = 'inserted';
-        if (semantics.manner === 'forceful') {
-            messageId = 'inserted_forcefully';
-        }
-        else if (semantics.manner === 'careful') {
-            messageId = 'inserted_carefully';
-        }
-        else if (semantics.manner === 'stealthy') {
-            messageId = 'inserted_stealthily';
-        }
-        // If the preposition was implicit, we might want to be more explicit in the response
-        if (semantics.implicitPreposition) {
-            // The grammar told us the user said "insert X Y" not "insert X into Y"
-            // We can provide clearer feedback
-            messageId = 'inserted_into'; // "You insert the coin into the slot."
-        }
-        const itemName = item.attributes.name || item.id;
-        const containerName = container.attributes.name || container.id;
-        return [
-            // Domain event with embedded messageId (ADR-097)
-            context.event('if.event.inserted', {
-                // Rendering data (messageId + params for text-service)
-                messageId: `${this.id}.${messageId}`,
-                params: {
-                    item: itemName,
-                    container: containerName,
-                    manner: semantics.manner || 'normal'
-                },
-                // Domain data (for event sourcing / handlers)
-                itemId: item.id,
-                itemName: itemName,
-                containerId: container.id,
-                containerName: containerName,
-                manner: semantics.manner || 'normal'
-            }),
-            // Additional semantic events based on manner
-            ...(semantics.manner === 'forceful' ? [
-                context.event('sound.loud', {
-                    source: container.id,
-                    description: 'clunk'
-                })
-            ] : []),
-            ...(semantics.manner === 'stealthy' ? [
-                context.event('sound.quiet', {
-                    source: container.id,
-                    description: 'soft sliding'
-                })
-            ] : [])
-        ];
-    }
-};
-/**
- * Key improvements in this semantic version:
- *
- * 1. NO COMMAND MODIFICATION
- *    - The old version modified context.command.parsed to add 'in' preposition
- *    - This version trusts the grammar-provided semantics.spatialRelation
- *
- * 2. SEMANTIC-BASED BEHAVIOR
- *    - Different messages based on manner (forceful, careful, stealthy)
- *    - Sound events based on how the action was performed
- *    - Validation considers semantics (forceful + fragile = error)
- *
- * 3. CLEANER ARCHITECTURE
- *    - No delegation to putting action needed
- *    - No need to create modified contexts
- *    - Action is self-contained and focused
- *
- * 4. IMPLICIT PREPOSITION HANDLING
- *    - Grammar tells us if user said "insert X Y" via implicitPreposition flag
- *    - We can provide clearer feedback without hacking the command
- *
- * 5. NO PARSER COUPLING
- *    - Never accesses context.command.parsed
- *    - Never checks verb.text
- *    - Never looks at structure.preposition.text
- */ 
-//# sourceMappingURL=inserting-semantic.js.map

package/actions/standard/inserting/inserting-semantic.js.map

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

package/combat/combat-messages.d.ts

@@ -1,52 +0,0 @@
-/**
- * Combat Message IDs (ADR-072)
- *
- * Semantic message IDs for combat-related events.
- * Actual text is provided by the language layer.
- */
-/**
- * Message IDs for combat events
- */
-export declare const CombatMessages: {
-    readonly ATTACK_MISSED: "combat.attack.missed";
-    readonly ATTACK_HIT: "combat.attack.hit";
-    readonly ATTACK_HIT_LIGHT: "combat.attack.hit_light";
-    readonly ATTACK_HIT_HEAVY: "combat.attack.hit_heavy";
-    readonly ATTACK_KNOCKED_OUT: "combat.attack.knocked_out";
-    readonly ATTACK_KILLED: "combat.attack.killed";
-    readonly DEFEND_BLOCKED: "combat.defend.blocked";
-    readonly DEFEND_PARRIED: "combat.defend.parried";
-    readonly DEFEND_DODGED: "combat.defend.dodged";
-    readonly HEALTH_HEALTHY: "combat.health.healthy";
-    readonly HEALTH_WOUNDED: "combat.health.wounded";
-    readonly HEALTH_BADLY_WOUNDED: "combat.health.badly_wounded";
-    readonly HEALTH_NEAR_DEATH: "combat.health.near_death";
-    readonly HEALTH_UNCONSCIOUS: "combat.health.unconscious";
-    readonly HEALTH_DEAD: "combat.health.dead";
-    readonly SWORD_GLOWS: "combat.special.sword_glows";
-    readonly SWORD_STOPS_GLOWING: "combat.special.sword_stops_glowing";
-    readonly BLESSED_WEAPON_EFFECT: "combat.special.blessed_weapon";
-    readonly CANNOT_ATTACK: "combat.cannot_attack";
-    readonly ALREADY_DEAD: "combat.already_dead";
-    readonly NOT_HOSTILE: "combat.not_hostile";
-    readonly NO_TARGET: "combat.no_target";
-    readonly TARGET_UNCONSCIOUS: "combat.target_unconscious";
-    readonly NEED_WEAPON: "combat.need_weapon";
-    readonly COMBAT_STARTED: "combat.started";
-    readonly COMBAT_ENDED: "combat.ended";
-    readonly PLAYER_DIED: "combat.player_died";
-    readonly PLAYER_RESURRECTED: "combat.player_resurrected";
-};
-/**
- * Type for combat message IDs
- */
-export type CombatMessageId = (typeof CombatMessages)[keyof typeof CombatMessages];
-/**
- * Health status levels
- */
-export type HealthStatus = 'healthy' | 'wounded' | 'badly_wounded' | 'near_death' | 'unconscious' | 'dead';
-/**
- * Get message ID for a health status
- */
-export declare function getHealthStatusMessageId(status: HealthStatus): CombatMessageId;
-//# sourceMappingURL=combat-messages.d.ts.map

package/combat/combat-messages.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"combat-messages.d.ts","sourceRoot":"","sources":["../../../../repos/sharpee/packages/stdlib/src/combat/combat-messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCjB,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,eAAe,GACf,YAAY,GACZ,aAAa,GACb,MAAM,CAAC;AAEX;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,eAAe,CAe9E"}