@sharpee/engine 0.9.60-beta

package/dist/command-executor.js

@@ -0,0 +1,329 @@
+"use strict";
+/**
+ * Command Executor - Orchestrates command pipeline
+ *
+ * Responsibilities:
+ * - Orchestrate the four-phase pattern (validate → execute → report/blocked)
+ * - Handle implicit inference (ADR-104) when validation fails with pronouns
+ * - Pass results between phases
+ * - Return the final TurnResult
+ *
+ * All event creation is owned by the action components themselves.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandExecutor = void 0;
+exports.createCommandExecutor = createCommandExecutor;
+const core_1 = require("@sharpee/core");
+const parser_interface_1 = require("./parser-interface");
+const shared_data_keys_1 = require("./shared-data-keys");
+const stdlib_1 = require("@sharpee/stdlib");
+const event_sequencer_1 = require("./event-sequencer");
+const action_context_factory_1 = require("./action-context-factory");
+const capability_dispatch_helper_1 = require("./capability-dispatch-helper");
+class CommandExecutor {
+    parser;
+    validator;
+    actionRegistry;
+    eventProcessor;
+    scopeResolver;
+    parsedCommandTransformers = [];
+    constructor(world, actionRegistry, eventProcessor, parser, systemEvents) {
+        if (!world)
+            throw new Error('World model is required');
+        if (!actionRegistry)
+            throw new Error('Action registry is required');
+        if (!eventProcessor)
+            throw new Error('Event processor is required');
+        if (!parser)
+            throw new Error('Parser is required');
+        this.parser = parser;
+        this.validator = new stdlib_1.CommandValidator(world, actionRegistry);
+        if (systemEvents) {
+            this.validator.setSystemEventSource(systemEvents);
+        }
+        this.actionRegistry = actionRegistry;
+        this.eventProcessor = eventProcessor;
+    }
+    /**
+     * Register a transformer that can modify parsed commands before validation.
+     * Transformers are called in order of registration.
+     *
+     * @param transformer - Function to transform parsed commands
+     */
+    registerParsedCommandTransformer(transformer) {
+        this.parsedCommandTransformers.push(transformer);
+    }
+    /**
+     * Unregister a previously registered transformer.
+     *
+     * @param transformer - The transformer to remove
+     * @returns true if the transformer was found and removed
+     */
+    unregisterParsedCommandTransformer(transformer) {
+        const index = this.parsedCommandTransformers.indexOf(transformer);
+        if (index !== -1) {
+            this.parsedCommandTransformers.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+    async execute(input, world, context, config) {
+        const turn = context.currentTurn;
+        event_sequencer_1.eventSequencer.resetTurn(turn);
+        // Timing tracking
+        const startTime = config?.collectTiming ? Date.now() : 0;
+        let parseTime = 0;
+        let executionTime = 0;
+        try {
+            // Set world context for parser entity resolution
+            const player = world.getPlayer();
+            if (player && (0, parser_interface_1.hasWorldContext)(this.parser)) {
+                const playerLocation = world.getLocation(player.id) || '';
+                this.parser.setWorldContext(world, player.id, playerLocation);
+            }
+            // Phase 1: Parse
+            const parseStart = config?.collectTiming ? Date.now() : 0;
+            const parseResult = this.parser.parse(input);
+            if (config?.collectTiming) {
+                parseTime = Date.now() - parseStart;
+            }
+            if (!parseResult.success) {
+                throw new Error(`Parse failed: ${parseResult.error.code}`);
+            }
+            // Phase 1.5: Apply parsed command transformers
+            // Allows stories to modify parsed commands before validation
+            let parsedCommand = parseResult.value;
+            for (const transformer of this.parsedCommandTransformers) {
+                parsedCommand = transformer(parsedCommand, world);
+            }
+            // Phase 2: Validate
+            const validationResult = this.validator.validate(parsedCommand);
+            if (!validationResult.success) {
+                // Check for disambiguation - emit client.query event instead of throwing
+                if (validationResult.error.code === 'AMBIGUOUS_ENTITY') {
+                    const details = validationResult.error.details || {};
+                    const candidates = details.ambiguousEntities || [];
+                    // Emit client.query event for disambiguation
+                    const queryEvent = event_sequencer_1.eventSequencer.sequence({
+                        type: 'client.query',
+                        data: {
+                            source: core_1.QuerySource.DISAMBIGUATION,
+                            type: core_1.QueryType.DISAMBIGUATION,
+                            messageId: 'core.disambiguation_prompt',
+                            candidates: candidates,
+                            searchText: details.searchText,
+                            originalCommand: parsedCommand
+                        }
+                    }, turn);
+                    // Return early with query pending
+                    return {
+                        turn,
+                        input,
+                        success: false,
+                        needsInput: true,
+                        events: [queryEvent],
+                        error: 'DISAMBIGUATION_NEEDED'
+                    };
+                }
+                // Other validation errors still throw
+                throw new Error(`Validation failed: ${validationResult.error.code}`);
+            }
+            // Phase 3: Execute action's three-phase pattern
+            const executionStart = config?.collectTiming ? Date.now() : 0;
+            const command = validationResult.value;
+            const action = this.actionRegistry.get(command.actionId);
+            if (!action) {
+                throw new Error(`Action not found: ${command.actionId}`);
+            }
+            // Create context
+            if (!this.scopeResolver) {
+                this.scopeResolver = (0, stdlib_1.createScopeResolver)(world);
+            }
+            const actionContext = (0, action_context_factory_1.createActionContext)(world, context, command, action, this.scopeResolver);
+            // Universal Capability Dispatch: Check if any involved entity has a capability for this action
+            // If so, the entity's behavior handles the action instead of the stdlib default
+            // Check all entities: directObject, indirectObject, and any others
+            const involvedEntities = [
+                command.directObject?.entity,
+                command.indirectObject?.entity
+            ];
+            const capabilityCheck = (0, capability_dispatch_helper_1.checkCapabilityDispatchMulti)(command.actionId, involvedEntities);
+            // Run action's four phases: validate → execute → report (or blocked)
+            // If capability dispatch applies, use capability behavior; otherwise use action
+            let actionValidation = capabilityCheck.shouldDispatch
+                ? (0, capability_dispatch_helper_1.executeCapabilityValidate)(capabilityCheck, actionContext)
+                : action.validate(actionContext);
+            let currentCommand = command;
+            let currentContext = actionContext;
+            let useCapabilityDispatch = capabilityCheck.shouldDispatch;
+            // ADR-104: Implicit inference - if validation fails and pronoun was used,
+            // try to find a valid alternative target
+            // Check story-level config first
+            const inferenceEnabled = context.implicitActions?.inference !== false;
+            if (!actionValidation.valid && action.targetRequirements && inferenceEnabled) {
+                const directObject = command.directObject;
+                // Check if pronoun was used (INounPhrase has wasPronoun, cast is safe)
+                const parsedNounPhrase = directObject?.parsed;
+                const wasPronoun = parsedNounPhrase?.wasPronoun === true;
+                if (wasPronoun && directObject?.entity) {
+                    // Note: directObject.parsed is typed as IParsedObjectReference but at runtime
+                    // it's actually an INounPhrase (command-validator sets it from the noun phrase)
+                    // Get entities in scope for inference (visible entities)
+                    const scopeEntities = this.scopeResolver.getVisible(world.getPlayer());
+                    // Try to infer a different target
+                    const inferenceResult = (0, stdlib_1.tryInferTarget)(directObject.entity, wasPronoun, action, scopeEntities, world);
+                    if (inferenceResult.inferred && inferenceResult.inferredTarget) {
+                        // Create a modified command with the inferred target
+                        const inferredCommand = {
+                            ...command,
+                            directObject: {
+                                entity: inferenceResult.inferredTarget,
+                                parsed: {
+                                    ...directObject.parsed,
+                                    // Update text to reflect inferred entity
+                                    text: inferenceResult.inferredTarget.name
+                                }
+                            }
+                        };
+                        // Create new context with inferred command
+                        const inferredContext = (0, action_context_factory_1.createActionContext)(world, context, inferredCommand, action, this.scopeResolver);
+                        // Mark that inference occurred (for "(the leaflet)" message)
+                        const sharedData = inferredContext.sharedData;
+                        sharedData[shared_data_keys_1.SharedDataKeys.INFERENCE_PERFORMED] = true;
+                        sharedData[shared_data_keys_1.SharedDataKeys.ORIGINAL_TARGET] = directObject.entity;
+                        sharedData[shared_data_keys_1.SharedDataKeys.INFERRED_TARGET] = inferenceResult.inferredTarget;
+                        // Re-check capability dispatch for inferred target
+                        const inferredInvolvedEntities = [
+                            inferenceResult.inferredTarget,
+                            command.indirectObject?.entity
+                        ];
+                        const inferredCapabilityCheck = (0, capability_dispatch_helper_1.checkCapabilityDispatchMulti)(command.actionId, inferredInvolvedEntities);
+                        // Re-validate with inferred target (using capability dispatch if applicable)
+                        const retryValidation = inferredCapabilityCheck.shouldDispatch
+                            ? (0, capability_dispatch_helper_1.executeCapabilityValidate)(inferredCapabilityCheck, inferredContext)
+                            : action.validate(inferredContext);
+                        if (retryValidation.valid) {
+                            // Inference succeeded - use the inferred command
+                            actionValidation = retryValidation;
+                            currentCommand = inferredCommand;
+                            currentContext = inferredContext;
+                            useCapabilityDispatch = inferredCapabilityCheck.shouldDispatch;
+                        }
+                    }
+                }
+            }
+            // Thread validation result to later phases via context
+            // This allows actions to access data from validate() in execute/report
+            currentContext.validationResult = actionValidation;
+            let events;
+            if (actionValidation.valid) {
+                if (useCapabilityDispatch) {
+                    // Capability dispatch: use behavior phases
+                    (0, capability_dispatch_helper_1.executeCapabilityExecute)(currentContext);
+                    events = (0, capability_dispatch_helper_1.executeCapabilityReport)(currentContext);
+                }
+                else {
+                    // Standard action: use action phases
+                    const executeResult = action.execute(currentContext);
+                    // Check pattern (new vs old)
+                    if (executeResult === undefined || executeResult === null) {
+                        // New pattern: use report() for success events only
+                        if (action.report) {
+                            events = action.report(currentContext);
+                        }
+                        else {
+                            throw new Error(`Action ${action.id} uses new pattern but lacks report()`);
+                        }
+                    }
+                    else {
+                        // Old pattern: events from execute()
+                        events = executeResult;
+                    }
+                }
+            }
+            else {
+                // Validation failed - use blocked() for error events
+                if (useCapabilityDispatch) {
+                    // Capability dispatch: use behavior's blocked phase
+                    events = (0, capability_dispatch_helper_1.executeCapabilityBlocked)(currentContext, actionValidation, command.actionId);
+                }
+                else if (action.blocked) {
+                    events = action.blocked(currentContext, actionValidation);
+                }
+                else {
+                    // Fallback for unmigrated actions
+                    events = [{
+                            id: `${turn}-error`,
+                            type: 'action.error',
+                            timestamp: Date.now(),
+                            data: {
+                                actionId: command.actionId,
+                                messageId: actionValidation.error || 'validation_failed',
+                                params: actionValidation.params || {}
+                            },
+                            entities: {}
+                        }];
+                }
+            }
+            if (config?.collectTiming) {
+                executionTime = Date.now() - executionStart;
+            }
+            // Process events and collect reactions (ADR-052 entity handlers)
+            let allEvents = events;
+            if (events.length > 0) {
+                const processed = this.eventProcessor.processEvents(events);
+                // Add reaction events from entity handlers
+                if (processed.reactions && processed.reactions.length > 0) {
+                    allEvents = [...events, ...processed.reactions];
+                }
+            }
+            // Preserve all event properties (including requiresClientAction for platform events)
+            const sequenced = event_sequencer_1.eventSequencer.sequenceAll(allEvents, turn);
+            const result = {
+                turn,
+                input,
+                success: !events.some(e => e.type === 'action.error'),
+                events: sequenced,
+                actionId: command.actionId,
+                parsedCommand: command.parsed,
+                validatedCommand: command
+            };
+            // Add timing data if requested
+            if (config?.collectTiming) {
+                result.timing = {
+                    parsing: parseTime,
+                    execution: executionTime,
+                    total: Date.now() - startTime
+                };
+            }
+            return result;
+        }
+        catch (error) {
+            // Minimal error handling - just return failure
+            const result = {
+                turn,
+                input,
+                success: false,
+                events: [event_sequencer_1.eventSequencer.sequence({
+                        type: 'command.failed',
+                        data: { reason: error.message, input }
+                    }, turn)],
+                error: error.message
+            };
+            // Add timing data even for errors if requested
+            if (config?.collectTiming) {
+                result.timing = {
+                    parsing: parseTime,
+                    execution: executionTime,
+                    total: Date.now() - startTime
+                };
+            }
+            return result;
+        }
+    }
+}
+exports.CommandExecutor = CommandExecutor;
+function createCommandExecutor(world, actionRegistry, eventProcessor, parser, systemEvents) {
+    return new CommandExecutor(world, actionRegistry, eventProcessor, parser, systemEvents);
+}
+//# sourceMappingURL=command-executor.js.map

package/dist/command-executor.js.map

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

package/dist/event-adapter.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Event Adapter - Converts between SemanticEvent and SequencedEvent
+ *
+ * This adapter handles:
+ * - Event normalization for consistent structure
+ * - Event enrichment pipeline for adding metadata
+ */
+import { ISemanticEvent } from '@sharpee/core';
+import { SequencedEvent } from './types';
+/**
+ * Event normalization - ensures consistent event structure
+ * Preserves all original properties (including requiresClientAction for platform events)
+ */
+export declare function normalizeEvent(event: ISemanticEvent): ISemanticEvent;
+/**
+ * Event enrichment pipeline - adds additional metadata
+ */
+export declare function enrichEvent(event: ISemanticEvent, context?: EventProcessingContext): ISemanticEvent;
+/**
+ * Event processing context for enrichment
+ */
+export interface EventProcessingContext {
+    turn?: number;
+    playerId?: string;
+    locationId?: string;
+}
+/**
+ * Process an event through the pipeline.
+ *
+ * Pipeline stages:
+ * 1. Normalization (ensure required fields, lowercase type)
+ * 2. Enrichment (add turn info, default entities)
+ */
+export declare function processEvent(event: ISemanticEvent, context?: EventProcessingContext): ISemanticEvent;
+/**
+ * Convert a SemanticEvent to a SequencedEvent
+ */
+export declare function toSequencedEvent(event: ISemanticEvent, turn: number, sequence: number): SequencedEvent;
+/**
+ * Convert a SequencedEvent back to a SemanticEvent
+ * Preserves all original properties (including requiresClientAction for platform events)
+ */
+export declare function toSemanticEvent(event: SequencedEvent): ISemanticEvent;
+//# sourceMappingURL=event-adapter.d.ts.map

package/dist/event-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-adapter.d.ts","sourceRoot":"","sources":["../src/event-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAcpE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAmChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,cAAc,EACrB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,cAAc,CAIhB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,cAAc,CAYhB;AAsBD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CASrE"}

package/dist/event-adapter.js

@@ -0,0 +1,127 @@
+"use strict";
+/**
+ * Event Adapter - Converts between SemanticEvent and SequencedEvent
+ *
+ * This adapter handles:
+ * - Event normalization for consistent structure
+ * - Event enrichment pipeline for adding metadata
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeEvent = normalizeEvent;
+exports.enrichEvent = enrichEvent;
+exports.processEvent = processEvent;
+exports.toSequencedEvent = toSequencedEvent;
+exports.toSemanticEvent = toSemanticEvent;
+/**
+ * Event normalization - ensures consistent event structure
+ * Preserves all original properties (including requiresClientAction for platform events)
+ */
+function normalizeEvent(event) {
+    const normalized = {
+        ...event, // Preserve all original properties (e.g., requiresClientAction)
+        id: event.id || generateEventId(),
+        type: event.type.toLowerCase(),
+        timestamp: event.timestamp || Date.now(),
+        entities: event.entities || {},
+        data: event.data,
+        tags: event.tags,
+        priority: event.priority,
+        narrate: event.narrate
+    };
+    return normalized;
+}
+/**
+ * Event enrichment pipeline - adds additional metadata
+ */
+function enrichEvent(event, context) {
+    const enriched = { ...event };
+    if (context) {
+        // Add turn information to data
+        if (context.turn !== undefined && enriched.data && typeof enriched.data === 'object') {
+            enriched.data = { ...enriched.data, turn: context.turn };
+        }
+        // Add player as actor if not specified
+        if (context.playerId && !enriched.entities.actor) {
+            enriched.entities = { ...enriched.entities, actor: context.playerId };
+        }
+        // Add location if not specified
+        if (context.locationId && !enriched.entities.location) {
+            enriched.entities = { ...enriched.entities, location: context.locationId };
+        }
+    }
+    // Add default tags based on event type
+    if (!enriched.tags) {
+        enriched.tags = [];
+    }
+    // Add category tags
+    if (enriched.type.startsWith('action.') && !enriched.tags.includes('action')) {
+        enriched.tags = [...enriched.tags, 'action'];
+    }
+    else if (enriched.type.startsWith('system.') && !enriched.tags.includes('system')) {
+        enriched.tags = [...enriched.tags, 'system'];
+    }
+    else if (enriched.type.startsWith('game.') && !enriched.tags.includes('game')) {
+        enriched.tags = [...enriched.tags, 'game'];
+    }
+    return enriched;
+}
+/**
+ * Process an event through the pipeline.
+ *
+ * Pipeline stages:
+ * 1. Normalization (ensure required fields, lowercase type)
+ * 2. Enrichment (add turn info, default entities)
+ */
+function processEvent(event, context) {
+    const normalized = normalizeEvent(event);
+    const enriched = enrichEvent(normalized, context);
+    return enriched;
+}
+/**
+ * Convert a SemanticEvent to a SequencedEvent
+ */
+function toSequencedEvent(event, turn, sequence) {
+    const processed = processEvent(event, { turn });
+    return {
+        type: processed.type,
+        data: processed.data,
+        sequence,
+        timestamp: new Date(processed.timestamp),
+        turn,
+        scope: determineScope(processed),
+        source: processed.id
+    };
+}
+/**
+ * Generate a unique event ID
+ */
+function generateEventId() {
+    return `event-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * Determine the scope of an event
+ */
+function determineScope(event) {
+    if (event.type.startsWith('platform.')) {
+        return 'system';
+    }
+    if (event.type === 'action.error') {
+        return 'turn';
+    }
+    return 'turn';
+}
+/**
+ * Convert a SequencedEvent back to a SemanticEvent
+ * Preserves all original properties (including requiresClientAction for platform events)
+ */
+function toSemanticEvent(event) {
+    return {
+        ...event, // Preserve all original properties (e.g., requiresClientAction, payload)
+        id: event.source || `${event.turn}-${event.sequence}`,
+        type: event.type,
+        timestamp: event.timestamp.getTime(),
+        data: event.data,
+        entities: event.entities || {}
+    };
+}
+//# sourceMappingURL=event-adapter.js.map

package/dist/event-adapter.js.map

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

package/dist/event-sequencer.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Event Sequencer - Manages event ordering within turns
+ *
+ * Ensures all events have proper sequence numbers for ordering
+ * and grouping within a turn.
+ */
+import { GameEvent, SequencedEvent } from './types';
+/**
+ * Event sequencer class
+ */
+declare class EventSequencer {
+    private counter;
+    /**
+     * Get next sequence number
+     */
+    next(): number;
+    /**
+     * Reset turn counter (optional, for testing)
+     */
+    resetTurn(turn: number): void;
+    /**
+     * Sequence a single event
+     */
+    sequence(event: GameEvent, turn: number): SequencedEvent;
+    /**
+     * Sequence multiple events
+     */
+    sequenceAll(events: GameEvent[], turn: number): SequencedEvent[];
+}
+/**
+ * Event sequence utilities
+ */
+export declare class EventSequenceUtils {
+    /**
+     * Sort events by sequence number
+     */
+    static sort(events: SequencedEvent[]): SequencedEvent[];
+    /**
+     * Filter events by type
+     */
+    static filterByType(events: SequencedEvent[], type: string): SequencedEvent[];
+    /**
+     * Filter events by turn
+     */
+    static filterByTurn(events: SequencedEvent[], turn: number): SequencedEvent[];
+    /**
+     * Filter events by scope
+     */
+    static filterByScope(events: SequencedEvent[], scope: SequencedEvent['scope']): SequencedEvent[];
+    /**
+     * Group events by type
+     */
+    static groupByType(events: SequencedEvent[]): Record<string, SequencedEvent[]>;
+    /**
+     * Group events by turn
+     */
+    static groupByTurn(events: SequencedEvent[]): Record<number, SequencedEvent[]>;
+    /**
+     * Get latest event by type
+     */
+    static getLatestByType(events: SequencedEvent[], type: string): SequencedEvent | undefined;
+    /**
+     * Count events by type
+     */
+    static countByType(events: SequencedEvent[]): Record<string, number>;
+    /**
+     * Get events in sequence range
+     */
+    static getInRange(events: SequencedEvent[], start: number, end: number, inclusive?: boolean): SequencedEvent[];
+}
+export declare const eventSequencer: EventSequencer;
+export {};
+//# sourceMappingURL=event-sequencer.d.ts.map

package/dist/event-sequencer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-sequencer.d.ts","sourceRoot":"","sources":["../src/event-sequencer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAEpD;;GAEG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,OAAO,CAAsB;IAErC;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI7B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc;IAUxD;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;CAGjE;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE;IAIvD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAI7E;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE;IAI7E;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,GAAG,cAAc,EAAE;IAIhG;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAa9E;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IAa9E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAS1F;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAUpE;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,MAAM,EAAE,cAAc,EAAE,EACxB,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,MAAM,EACX,SAAS,GAAE,OAAc,GACxB,cAAc,EAAE;CAOpB;AAGD,eAAO,MAAM,cAAc,gBAAuB,CAAC"}