@sharpee/stdlib 0.9.60-beta

package/dist/npc/types.d.ts

@@ -0,0 +1,167 @@
+/**
+ * NPC System Types (ADR-070)
+ *
+ * Types for NPC behaviors and actions.
+ */
+import { ISemanticEvent, EntityId, SeededRandom } from '@sharpee/core';
+import { IFEntity, WorldModel } from '@sharpee/world-model';
+/**
+ * Direction for NPC movement
+ */
+export type Direction = 'north' | 'south' | 'east' | 'west' | 'northeast' | 'northwest' | 'southeast' | 'southwest' | 'up' | 'down' | 'in' | 'out';
+/**
+ * Context passed to NPC behavior hooks
+ */
+export interface NpcContext {
+    /** The NPC entity */
+    npc: IFEntity;
+    /** The world model */
+    world: WorldModel;
+    /** Seeded random number generator */
+    random: SeededRandom;
+    /** Current turn number */
+    turnCount: number;
+    /** Player's current location */
+    playerLocation: EntityId;
+    /** NPC's current location */
+    npcLocation: EntityId;
+    /** Items in NPC's inventory */
+    npcInventory: IFEntity[];
+    /** Whether the player is in the same room as the NPC */
+    playerVisible: boolean;
+    /** Get entities in the NPC's current room */
+    getEntitiesInRoom(): IFEntity[];
+    /** Get exits from the NPC's current room */
+    getAvailableExits(): {
+        direction: Direction;
+        destination: EntityId;
+    }[];
+}
+/**
+ * Actions an NPC can take
+ *
+ * All actions use semantic data (message IDs, entity IDs) rather than raw text.
+ */
+export type NpcAction = {
+    type: 'move';
+    direction: Direction;
+} | {
+    type: 'moveTo';
+    roomId: EntityId;
+} | {
+    type: 'take';
+    target: EntityId;
+} | {
+    type: 'drop';
+    target: EntityId;
+} | {
+    type: 'attack';
+    target: EntityId;
+} | {
+    type: 'speak';
+    messageId: string;
+    data?: Record<string, unknown>;
+} | {
+    type: 'emote';
+    messageId: string;
+    data?: Record<string, unknown>;
+} | {
+    type: 'wait';
+} | {
+    type: 'custom';
+    handler: () => ISemanticEvent[];
+};
+/**
+ * NPC behavior interface
+ *
+ * Defines hooks that are called at various points during the game.
+ * Each hook returns an array of NpcActions to be executed.
+ */
+export interface NpcBehavior {
+    /** Unique identifier for this behavior */
+    id: string;
+    /** Human-readable name for debugging */
+    name?: string;
+    /**
+     * Called each turn for this NPC
+     * This is the main hook for autonomous NPC behavior.
+     */
+    onTurn(context: NpcContext): NpcAction[];
+    /**
+     * Called when the player enters the NPC's room
+     */
+    onPlayerEnters?(context: NpcContext): NpcAction[];
+    /**
+     * Called when the player leaves the NPC's room
+     */
+    onPlayerLeaves?(context: NpcContext): NpcAction[];
+    /**
+     * Called when the player speaks to/at the NPC
+     */
+    onSpokenTo?(context: NpcContext, words: string): NpcAction[];
+    /**
+     * Called when the NPC is attacked
+     */
+    onAttacked?(context: NpcContext, attacker: IFEntity): NpcAction[];
+    /**
+     * Called when the NPC observes a player action
+     */
+    onObserve?(context: NpcContext, actionType: string, actionData: unknown): NpcAction[];
+    /**
+     * Optional: Get serializable state for save/load
+     */
+    getState?(npc: IFEntity): Record<string, unknown>;
+    /**
+     * Optional: Restore state after load
+     */
+    setState?(npc: IFEntity, state: Record<string, unknown>): void;
+}
+/**
+ * Events emitted by NPC actions
+ */
+export interface NpcEvent extends ISemanticEvent {
+    type: 'npc.moved' | 'npc.spoke' | 'npc.took' | 'npc.dropped' | 'npc.attacked' | 'npc.emoted' | 'npc.died' | 'npc.stateChanged';
+}
+/**
+ * Data for NPC movement events
+ */
+export interface NpcMovedData {
+    npc: EntityId;
+    from: EntityId;
+    to: EntityId;
+    direction?: Direction;
+}
+/**
+ * Data for NPC speech events
+ */
+export interface NpcSpokeData {
+    npc: EntityId;
+    messageId: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Data for NPC item manipulation events
+ */
+export interface NpcItemData {
+    npc: EntityId;
+    target: EntityId;
+}
+/**
+ * Data for NPC emote events
+ */
+export interface NpcEmoteData {
+    npc: EntityId;
+    messageId: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Result of NPC combat
+ */
+export interface NpcCombatData {
+    npc: EntityId;
+    target: EntityId;
+    hit: boolean;
+    damage: number;
+    targetKilled: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/npc/types.d.ts.map

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

package/dist/npc/types.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * NPC System Types (ADR-070)
+ *
+ * Types for NPC behaviors and actions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/npc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/npc/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/parser/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Parser module exports
+ *
+ * Parser contracts have been moved to @sharpee/if-domain.
+ * This module now only re-exports from if-domain for backward compatibility.
+ */
+export { Parser, ParserOptions, ParserFactory, BaseParser, Token, TokenCandidate, CandidateCommand, InternalParseResult, ParseError, ParseErrorType, VocabularyEntry, PartOfSpeech, VocabularyProvider, VocabularyRegistry, vocabularyRegistry, VerbVocabulary, DirectionVocabulary, SpecialVocabulary, EntityVocabulary, VocabularySet, GrammarPattern, GrammarPatterns, GrammarPatternName, adaptVerbVocabulary, adaptDirectionVocabulary, adaptSpecialVocabulary } from '@sharpee/if-domain';
+//# sourceMappingURL=index.d.ts.map

package/dist/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAEL,MAAM,EACN,aAAa,EACb,aAAa,EACb,UAAU,EACV,KAAK,EACL,cAAc,EAGd,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,cAAc,EAGd,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,eAAe,EACf,kBAAkB,EAGlB,mBAAmB,EACnB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC"}

package/dist/parser/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Parser module exports
+ *
+ * Parser contracts have been moved to @sharpee/if-domain.
+ * This module now only re-exports from if-domain for backward compatibility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.adaptSpecialVocabulary = exports.adaptDirectionVocabulary = exports.adaptVerbVocabulary = exports.GrammarPatterns = exports.vocabularyRegistry = exports.VocabularyRegistry = exports.PartOfSpeech = exports.ParseErrorType = exports.ParserFactory = void 0;
+// Re-export parser and vocabulary contracts from if-domain
+var if_domain_1 = require("@sharpee/if-domain");
+Object.defineProperty(exports, "ParserFactory", { enumerable: true, get: function () { return if_domain_1.ParserFactory; } });
+Object.defineProperty(exports, "ParseErrorType", { enumerable: true, get: function () { return if_domain_1.ParseErrorType; } });
+Object.defineProperty(exports, "PartOfSpeech", { enumerable: true, get: function () { return if_domain_1.PartOfSpeech; } });
+Object.defineProperty(exports, "VocabularyRegistry", { enumerable: true, get: function () { return if_domain_1.VocabularyRegistry; } });
+Object.defineProperty(exports, "vocabularyRegistry", { enumerable: true, get: function () { return if_domain_1.vocabularyRegistry; } });
+Object.defineProperty(exports, "GrammarPatterns", { enumerable: true, get: function () { return if_domain_1.GrammarPatterns; } });
+// Vocabulary adapters
+Object.defineProperty(exports, "adaptVerbVocabulary", { enumerable: true, get: function () { return if_domain_1.adaptVerbVocabulary; } });
+Object.defineProperty(exports, "adaptDirectionVocabulary", { enumerable: true, get: function () { return if_domain_1.adaptDirectionVocabulary; } });
+Object.defineProperty(exports, "adaptSpecialVocabulary", { enumerable: true, get: function () { return if_domain_1.adaptSpecialVocabulary; } });
+//# sourceMappingURL=index.js.map

package/dist/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/parser/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,2DAA2D;AAC3D,gDAkC4B;AA9B1B,0GAAA,aAAa,OAAA;AASb,2GAAA,cAAc,OAAA;AAId,yGAAA,YAAY,OAAA;AAEZ,+GAAA,kBAAkB,OAAA;AAClB,+GAAA,kBAAkB,OAAA;AAOlB,4GAAA,eAAe,OAAA;AAGf,sBAAsB;AACtB,gHAAA,mBAAmB,OAAA;AACnB,qHAAA,wBAAwB,OAAA;AACxB,mHAAA,sBAAsB,OAAA"}

package/dist/query-handlers/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Query handlers for standard queries
+ *
+ * These handlers process responses to system queries like
+ * quit confirmation, save confirmation, etc.
+ */
+export * from './quit-handler';
+export * from './restart-handler';
+//# sourceMappingURL=index.d.ts.map

package/dist/query-handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/query-handlers/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/query-handlers/index.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Query handlers for standard queries
+ *
+ * These handlers process responses to system queries like
+ * quit confirmation, save confirmation, etc.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./quit-handler"), exports);
+__exportStar(require("./restart-handler"), exports);
+// TODO: Add more handlers as implemented
+// export * from './save-handler';
+// export * from './restart-handler';
+// export * from './yes-no-handler';
+//# sourceMappingURL=index.js.map

package/dist/query-handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/query-handlers/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;AAEH,iDAA+B;AAC/B,oDAAkC;AAElC,yCAAyC;AACzC,kCAAkC;AAClC,qCAAqC;AACrC,oCAAoC"}

package/dist/query-handlers/quit-handler.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Quit Query Handler
+ *
+ * Handles responses to quit confirmation queries.
+ * Works with the platform events system to emit appropriate events.
+ */
+import { IQueryHandler, IPendingQuery, IQueryResponse } from '@sharpee/core';
+/**
+ * Handler for quit confirmation queries
+ */
+export declare class QuitQueryHandler implements IQueryHandler {
+    private eventSource;
+    /**
+     * Check if this handler can process the query
+     */
+    canHandle(query: IPendingQuery): boolean;
+    /**
+     * Process the player's response
+     */
+    handleResponse(response: IQueryResponse, query: IPendingQuery): void;
+    /**
+     * Handle query timeout
+     */
+    handleTimeout(query: IPendingQuery): void;
+    /**
+     * Handle query cancellation
+     */
+    handleCancel(query: IPendingQuery): void;
+    /**
+     * Get the event source
+     */
+    getEventSource(): import("@sharpee/core").ISemanticEventSource;
+    /**
+     * Create a semantic event
+     */
+    private createEvent;
+}
+/**
+ * Create a quit query handler instance
+ */
+export declare function createQuitQueryHandler(): QuitQueryHandler;
+//# sourceMappingURL=quit-handler.d.ts.map

package/dist/query-handlers/quit-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quit-handler.d.ts","sourceRoot":"","sources":["../../src/query-handlers/quit-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EAQf,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACpD,OAAO,CAAC,WAAW,CAA+B;IAElD;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IASxC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAoIpE;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAYzC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAWxC;;OAEG;IACH,cAAc;IAId;;OAEG;IACH,OAAO,CAAC,WAAW;CASpB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,gBAAgB,CAEzD"}

package/dist/query-handlers/quit-handler.js

@@ -0,0 +1,201 @@
+"use strict";
+/**
+ * Quit Query Handler
+ *
+ * Handles responses to quit confirmation queries.
+ * Works with the platform events system to emit appropriate events.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuitQueryHandler = void 0;
+exports.createQuitQueryHandler = createQuitQueryHandler;
+const core_1 = require("@sharpee/core");
+/**
+ * Handler for quit confirmation queries
+ */
+class QuitQueryHandler {
+    eventSource = (0, core_1.createSemanticEventSource)();
+    /**
+     * Check if this handler can process the query
+     */
+    canHandle(query) {
+        return query.source === core_1.QuerySource.SYSTEM &&
+            (query.type === core_1.QueryType.YES_NO || query.type === core_1.QueryType.MULTIPLE_CHOICE) &&
+            (query.messageId === 'quit_confirmation' ||
+                query.messageId === 'quit_confirm_query' ||
+                query.messageId === 'quit_unsaved_query' ||
+                query.messageId === 'quit_save_query');
+    }
+    /**
+     * Process the player's response
+     */
+    handleResponse(response, query) {
+        const events = [];
+        const context = query.context;
+        // Get the selected option
+        const selectedOption = query.options?.[response.selectedIndex || 0] ||
+            response.response;
+        // Handle boolean responses for YES_NO queries
+        if (typeof selectedOption === 'boolean') {
+            if (selectedOption === true) {
+                // Yes response - proceed with quit
+                const quitContext = {
+                    score: context.score,
+                    moves: context.moves,
+                    hasUnsavedChanges: context.hasUnsavedProgress || false,
+                    force: true, // User confirmed, so treat as forced
+                    stats: {
+                        maxScore: context.maxScore,
+                        nearComplete: context.nearComplete
+                    }
+                };
+                // Emit platform quit requested event
+                const quitEvent = (0, core_1.createQuitRequestedEvent)(quitContext);
+                events.push(quitEvent);
+                // Also emit a query handled event for tracking
+                events.push(this.createEvent('query.handled', {
+                    queryId: query.id,
+                    action: 'quit_confirmed',
+                    savedBeforeQuit: false
+                }));
+            }
+            else {
+                // No response - cancel quit
+                const cancelEvent = (0, core_1.createQuitCancelledEvent)();
+                events.push(cancelEvent);
+                // Query handled event
+                events.push(this.createEvent('query.handled', {
+                    queryId: query.id,
+                    action: 'quit_cancelled'
+                }));
+            }
+        }
+        else {
+            // Handle string responses for MULTIPLE_CHOICE queries
+            switch (selectedOption) {
+                case 'quit':
+                case 'quit_without_saving':
+                case 'yes':
+                    // Build quit context from query context
+                    const quitContext = {
+                        score: context.score,
+                        moves: context.moves,
+                        hasUnsavedChanges: context.hasUnsavedProgress || false,
+                        force: true, // User confirmed, so treat as forced
+                        stats: {
+                            maxScore: context.maxScore,
+                            nearComplete: context.nearComplete
+                        }
+                    };
+                    // Emit platform quit requested event
+                    const quitEvent = (0, core_1.createQuitRequestedEvent)(quitContext);
+                    events.push(quitEvent);
+                    // Also emit a query handled event for tracking
+                    events.push(this.createEvent('query.handled', {
+                        queryId: query.id,
+                        action: 'quit_confirmed',
+                        savedBeforeQuit: false
+                    }));
+                    break;
+                case 'save_and_quit':
+                    // First emit save requested event
+                    events.push(this.createEvent('platform.save_requested', {
+                        saveName: 'autosave',
+                        autosave: true,
+                        timestamp: Date.now(),
+                        metadata: {
+                            reason: 'quit',
+                            score: context.score,
+                            moves: context.moves
+                        }
+                    }));
+                    // Then emit quit requested event
+                    const saveAndQuitContext = {
+                        score: context.score,
+                        moves: context.moves,
+                        hasUnsavedChanges: false, // Will be saved first
+                        force: true,
+                        stats: {
+                            maxScore: context.maxScore,
+                            savedBeforeQuit: true
+                        }
+                    };
+                    const saveAndQuitEvent = (0, core_1.createQuitRequestedEvent)(saveAndQuitContext);
+                    events.push(saveAndQuitEvent);
+                    // Query handled event
+                    events.push(this.createEvent('query.handled', {
+                        queryId: query.id,
+                        action: 'save_and_quit',
+                        savedBeforeQuit: true
+                    }));
+                    break;
+                case 'cancel':
+                case 'no':
+                default:
+                    // Emit platform quit cancelled event
+                    const cancelEvent = (0, core_1.createQuitCancelledEvent)();
+                    events.push(cancelEvent);
+                    // Query handled event
+                    events.push(this.createEvent('query.handled', {
+                        queryId: query.id,
+                        action: 'quit_cancelled'
+                    }));
+                    break;
+            }
+        }
+        // Emit all events
+        for (const event of events) {
+            this.eventSource.emit(event);
+        }
+    }
+    /**
+     * Handle query timeout
+     */
+    handleTimeout(query) {
+        // On timeout, treat as cancelled
+        const cancelEvent = (0, core_1.createQuitCancelledEvent)();
+        this.eventSource.emit(cancelEvent);
+        this.eventSource.emit(this.createEvent('query.timeout', {
+            queryId: query.id,
+            action: 'quit_cancelled',
+            reason: 'timeout'
+        }));
+    }
+    /**
+     * Handle query cancellation
+     */
+    handleCancel(query) {
+        const cancelEvent = (0, core_1.createQuitCancelledEvent)();
+        this.eventSource.emit(cancelEvent);
+        this.eventSource.emit(this.createEvent('query.cancelled', {
+            queryId: query.id,
+            action: 'quit_cancelled',
+            reason: 'cancelled'
+        }));
+    }
+    /**
+     * Get the event source
+     */
+    getEventSource() {
+        return this.eventSource;
+    }
+    /**
+     * Create a semantic event
+     */
+    createEvent(type, data) {
+        return {
+            id: `evt_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+            type,
+            timestamp: Date.now(),
+            entities: {},
+            data
+        };
+    }
+}
+exports.QuitQueryHandler = QuitQueryHandler;
+/**
+ * Create a quit query handler instance
+ */
+function createQuitQueryHandler() {
+    return new QuitQueryHandler();
+}
+//# sourceMappingURL=quit-handler.js.map

package/dist/query-handlers/quit-handler.js.map

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

package/dist/query-handlers/restart-handler.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Restart Query Handler
+ *
+ * Handles responses to restart confirmation queries.
+ * Works with the platform events system to emit appropriate events.
+ */
+import { IQueryHandler, IPendingQuery, IQueryResponse } from '@sharpee/core';
+/**
+ * Handler for restart confirmation queries
+ */
+export declare class RestartQueryHandler implements IQueryHandler {
+    private eventSource;
+    /**
+     * Check if this handler can process the query
+     */
+    canHandle(query: IPendingQuery): boolean;
+    /**
+     * Process the player's response
+     */
+    handleResponse(response: IQueryResponse, query: IPendingQuery): void;
+    /**
+     * Handle query timeout
+     */
+    handleTimeout(query: IPendingQuery): void;
+    /**
+     * Handle query cancellation
+     */
+    handleCancel(query: IPendingQuery): void;
+    /**
+     * Get the event source
+     */
+    getEventSource(): import("@sharpee/core").ISemanticEventSource;
+    /**
+     * Create a semantic event
+     */
+    private createEvent;
+}
+/**
+ * Create a restart query handler instance
+ */
+export declare function createRestartQueryHandler(): RestartQueryHandler;
+//# sourceMappingURL=restart-handler.d.ts.map

package/dist/query-handlers/restart-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restart-handler.d.ts","sourceRoot":"","sources":["../../src/query-handlers/restart-handler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,aAAa,EACb,aAAa,EACb,cAAc,EAQf,MAAM,eAAe,CAAC;AAEvB;;GAEG;AACH,qBAAa,mBAAoB,YAAW,aAAa;IACvD,OAAO,CAAC,WAAW,CAA+B;IAElD;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO;IASxC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,aAAa,GAAG,IAAI;IAqIpE;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAYzC;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAWxC;;OAEG;IACH,cAAc;IAId;;OAEG;IACH,OAAO,CAAC,WAAW;CASpB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,mBAAmB,CAE/D"}