@sharpee/stdlib 1.0.0 → 1.1.0

package/services/scoring/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../repos/sharpee/packages/stdlib/src/services/scoring/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qDAQ2B;AANzB,iHAAA,cAAc,OAAA;AAKd,gHAAA,aAAa,OAAA;AAGf,qEAamC;AAZjC,gIAAA,qBAAqB,OAAA"}

package/services/scoring/scoring-event-processor.d.ts

@@ -1,337 +0,0 @@
-/**
- * ScoringEventProcessor - Declarative scoring hooks for common patterns
- *
- * Provides a clean API for story authors to configure scoring without
- * manually wiring event handlers. Supports:
- * - Treasure scoring (take points + container bonus)
- * - Room visit scoring (first-visit points)
- * - Event sequences (ordered chains like rituals)
- * - Aggregate goals (collect all X)
- * - Conditional unlocks (state changes when conditions met)
- *
- * @see docs/work/scoring/assessment.md
- */
-import { IWorldModel } from "../../../world-model/index";
-import { ISemanticEvent } from "../../../core/index";
-import { IScoringService } from './scoring-service';
-/**
- * Interface for event processor registration
- * Matches the EventProcessor.registerHandler signature
- */
-export interface IEventProcessorRegistration {
-    registerHandler(eventType: string, handler: (event: ISemanticEvent, query: unknown) => unknown[]): void;
-}
-/**
- * Configuration for a treasure's scoring behavior
- */
-export interface TreasureConfig {
-    /** Entity ID of the treasure */
-    entityId: string;
-    /** Points awarded when first taking the treasure */
-    takePoints?: number;
-    /** Points awarded when placing in the scoring container */
-    containerPoints?: number;
-    /** Entity ID of the container that awards bonus points (e.g., trophy case) */
-    containerId?: string;
-}
-/**
- * Configuration for room visit scoring
- */
-export interface RoomVisitConfig {
-    /** Room entity ID */
-    roomId: string;
-    /** Points awarded on first visit */
-    points: number;
-}
-/**
- * A step in an event sequence
- */
-export interface SequenceStep {
-    /** Event type to match (e.g., 'if.event.taken') */
-    event: string;
-    /** Filter to match event data (all properties must match) */
-    filter?: Record<string, unknown>;
-    /** Optional name for this step (for debugging/display) */
-    name?: string;
-}
-/**
- * Configuration for an event sequence (chained events)
- */
-export interface SequenceConfig {
-    /** Ordered steps that must happen in sequence */
-    steps: SequenceStep[];
-    /** Number of turns before sequence resets (optional) */
-    timeout?: number;
-    /** Called when sequence completes */
-    onComplete: (processor: ScoringEventProcessor) => void;
-    /** Called after each step completes (optional) */
-    onStep?: (stepIndex: number, processor: ScoringEventProcessor) => void;
-    /** Whether sequence can be repeated (default: false) */
-    repeatable?: boolean;
-}
-/**
- * Condition types for goals and unlocks
- */
-export type GoalCondition = {
-    type: 'item_in_container';
-    itemId: string;
-    containerId: string;
-} | {
-    type: 'item_taken';
-    itemId: string;
-} | {
-    type: 'room_visited';
-    roomId: string;
-} | {
-    type: 'achievement';
-    id: string;
-} | {
-    type: 'sequence_complete';
-    sequenceId: string;
-} | {
-    type: 'score_reached';
-    score: number;
-} | {
-    type: 'custom';
-    check: (world: IWorldModel) => boolean;
-};
-/**
- * Configuration for an aggregate goal
- */
-export interface GoalConfig {
-    /** Human-readable description */
-    description?: string;
-    /** List of conditions that must all be met */
-    conditions?: GoalCondition[];
-    /** Dynamic condition function (alternative to conditions list) */
-    conditionFn?: (world: IWorldModel) => boolean;
-    /** Called when goal is completed */
-    onComplete: (processor: ScoringEventProcessor) => void;
-    /** Called when progress changes (optional) */
-    onProgress?: (progress: GoalProgress, processor: ScoringEventProcessor) => void;
-}
-/**
- * Configuration for a conditional unlock
- */
-export interface UnlockConfig {
-    /** Conditions that trigger the unlock */
-    conditions: GoalCondition[];
-    /** Called when unlock triggers */
-    onUnlock: (processor: ScoringEventProcessor) => void;
-}
-/**
- * Runtime state for a sequence
- */
-export interface SequenceState {
-    /** Current step index (0-based) */
-    currentStep: number;
-    /** Turn when last step was completed */
-    lastStepTurn: number;
-    /** Whether sequence has been completed */
-    completed: boolean;
-}
-/**
- * Progress information for a goal
- */
-export interface GoalProgress {
-    /** Number of conditions met */
-    completed: number;
-    /** Total number of conditions */
-    total: number;
-    /** Percentage complete (0-100) */
-    percentage: number;
-    /** IDs of remaining conditions (for condition lists) */
-    remaining: string[];
-    /** Whether goal is fully complete */
-    isComplete: boolean;
-}
-/**
- * Serializable state for save/restore
- */
-export interface ScoringProcessorState {
-    /** Set of treasures that have been taken (for take points) */
-    takenTreasures: string[];
-    /** Set of treasures placed in scoring container (for container points) */
-    containerTreasures: string[];
-    /** Set of rooms visited (for visit points) */
-    visitedRooms: string[];
-    /** Sequence states by ID */
-    sequences: Record<string, SequenceState>;
-    /** Set of completed goals */
-    completedGoals: string[];
-    /** Set of triggered unlocks */
-    triggeredUnlocks: string[];
-    /** Current turn count (for sequence timeouts) */
-    currentTurn: number;
-}
-/**
- * Event processor for declarative scoring configuration
- */
-export declare class ScoringEventProcessor {
-    private scoringService;
-    private world;
-    private treasures;
-    private roomVisits;
-    private sequences;
-    private goals;
-    private unlocks;
-    private takenTreasures;
-    private containerTreasures;
-    private visitedRooms;
-    private sequenceStates;
-    private completedGoals;
-    private triggeredUnlocks;
-    private currentTurn;
-    private defaultContainerId?;
-    private dynamicTreasureMode;
-    private dynamicContainerName?;
-    private onTreasureTake?;
-    private onTreasurePlace?;
-    constructor(scoringService: IScoringService, world: IWorldModel);
-    /**
-     * Set the default container for treasure bonus points
-     */
-    setDefaultContainer(containerId: string): this;
-    /**
-     * Enable dynamic treasure mode - detects treasures by entity properties
-     * instead of explicit registration.
-     *
-     * In this mode, entities with these properties are treated as treasures:
-     * - isTreasure: boolean (must be true)
-     * - treasureValue: number (points for taking)
-     * - trophyCaseValue: number (points for placing in container)
-     * - treasureId: string (unique ID, defaults to entity ID)
-     *
-     * @param containerName - Name of the scoring container (e.g., 'trophy case')
-     */
-    enableDynamicTreasures(containerName: string): this;
-    /**
-     * Set custom callback for treasure take scoring
-     * Use this to integrate with story-specific scoring services
-     */
-    setTreasureTakeCallback(callback: (treasureId: string, points: number) => void): this;
-    /**
-     * Set custom callback for treasure placement scoring
-     * Use this to integrate with story-specific scoring services
-     */
-    setTreasurePlaceCallback(callback: (treasureId: string, points: number) => void): this;
-    /**
-     * Register a treasure for scoring
-     */
-    registerTreasure(config: TreasureConfig): this;
-    /**
-     * Register multiple treasures at once
-     */
-    registerTreasures(configs: TreasureConfig[]): this;
-    /**
-     * Register a room for first-visit scoring
-     */
-    registerRoomVisit(roomId: string, points: number): this;
-    /**
-     * Register an event sequence
-     */
-    registerSequence(id: string, config: SequenceConfig): this;
-    /**
-     * Register an aggregate goal
-     */
-    registerGoal(id: string, config: GoalConfig): this;
-    /**
-     * Register a conditional unlock
-     */
-    registerUnlock(id: string, config: UnlockConfig): this;
-    /**
-     * Initialize event handlers via EventProcessor
-     *
-     * IMPORTANT: Must be called in onEngineReady(), not initializeWorld()!
-     * The EventProcessor doesn't exist during initializeWorld(), and
-     * world.registerEventHandler() handlers get overwritten by the engine.
-     *
-     * @param eventProcessor - The EventProcessor from engine.getEventProcessor()
-     */
-    initializeHandlers(eventProcessor: IEventProcessorRegistration): this;
-    /**
-     * Handle a taken event (item picked up)
-     */
-    handleTaken(event: ISemanticEvent): void;
-    /**
-     * Handle a put_in event (item placed in container)
-     */
-    handlePutIn(event: ISemanticEvent): void;
-    /**
-     * Handle a player_moved event (room entry)
-     */
-    handlePlayerMoved(event: ISemanticEvent): void;
-    /**
-     * Process any event for sequence advancement
-     */
-    processEventForSequences(event: ISemanticEvent): void;
-    /**
-     * Increment the turn counter (call at end of each turn)
-     */
-    incrementTurn(): void;
-    /**
-     * Get progress for a sequence
-     */
-    getSequenceProgress(id: string): SequenceState | undefined;
-    /**
-     * Get progress for a goal
-     */
-    getGoalProgress(id: string): GoalProgress | undefined;
-    /**
-     * Check if a goal is complete
-     */
-    isGoalComplete(id: string): boolean;
-    /**
-     * Check if an unlock has been triggered
-     */
-    isUnlockTriggered(id: string): boolean;
-    /**
-     * Check if a treasure's take points have been awarded
-     */
-    hasTakenTreasure(entityId: string): boolean;
-    /**
-     * Check if a treasure's container points have been awarded
-     */
-    hasPlacedTreasure(entityId: string): boolean;
-    /**
-     * Check if a room has been visited (for points)
-     */
-    hasVisitedRoom(roomId: string): boolean;
-    /**
-     * Award points once (with deduplication)
-     */
-    awardOnce(sourceId: string, points: number, reason?: string): boolean;
-    /**
-     * Get the scoring service (for direct access)
-     */
-    getScoringService(): IScoringService;
-    /**
-     * Get the world model (for condition checking)
-     */
-    getWorld(): IWorldModel;
-    /**
-     * Get serializable state for saving
-     */
-    getState(): ScoringProcessorState;
-    /**
-     * Restore state from save data
-     */
-    restoreState(state: ScoringProcessorState): void;
-    /**
-     * Check if an event matches a sequence step
-     */
-    private eventMatchesStep;
-    /**
-     * Check if a condition is met
-     */
-    private checkCondition;
-    /**
-     * Get a string ID for a condition (for progress tracking)
-     */
-    private getConditionId;
-    /**
-     * Check all goals and unlocks after a state change
-     */
-    private checkGoalsAndUnlocks;
-}
-//# sourceMappingURL=scoring-event-processor.d.ts.map

package/services/scoring/scoring-event-processor.d.ts.map

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