@sharpee/stdlib 0.9.60-beta

package/dist/actions/standard/exiting/exiting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exiting.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/exiting/exiting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAA0D,MAAM,sBAAsB,CAAC;AA4BtG,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAgJ9D,CAAC"}

package/dist/actions/standard/exiting/exiting.js

@@ -0,0 +1,146 @@
+"use strict";
+/**
+ * Exiting action - exit from containers, supporters, or other enterable objects
+ *
+ * This action handles exiting objects that the actor is currently inside/on.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exitingAction = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const constants_1 = require("../../constants");
+const exiting_messages_1 = require("./exiting-messages");
+function getExitingSharedData(context) {
+    return context.sharedData;
+}
+const types_1 = require("../../../scope/types");
+exports.exitingAction = {
+    id: constants_1.IFActions.EXITING,
+    requiredMessages: [
+        'already_outside',
+        'container_closed',
+        'cant_exit',
+        'exited',
+        'exited_from',
+        'nowhere_to_go'
+    ],
+    group: 'movement',
+    validate(context) {
+        const actor = context.player;
+        const currentLocation = context.world.getLocation(actor.id);
+        if (!currentLocation) {
+            return {
+                valid: false,
+                error: exiting_messages_1.ExitingMessages.NOWHERE_TO_GO
+            };
+        }
+        const currentContainer = context.world.getEntity(currentLocation);
+        if (!currentContainer) {
+            return {
+                valid: false,
+                error: exiting_messages_1.ExitingMessages.NOWHERE_TO_GO
+            };
+        }
+        // Check if we're in something we can exit from
+        // Rooms cannot be exited (use GO to move between rooms)
+        const isRoom = currentContainer.has(world_model_1.TraitType.ROOM);
+        if (isRoom) {
+            return {
+                valid: false,
+                error: exiting_messages_1.ExitingMessages.ALREADY_OUTSIDE
+            };
+        }
+        // Find the parent location (where we'll exit to)
+        const parentLocation = context.world.getLocation(currentLocation);
+        if (!parentLocation) {
+            return {
+                valid: false,
+                error: exiting_messages_1.ExitingMessages.NOWHERE_TO_GO
+            };
+        }
+        // Check if container needs to be open to exit using behavior
+        if (currentContainer.has(world_model_1.TraitType.CONTAINER) && currentContainer.has(world_model_1.TraitType.OPENABLE)) {
+            if (!world_model_1.OpenableBehavior.isOpen(currentContainer)) {
+                return {
+                    valid: false,
+                    error: exiting_messages_1.ExitingMessages.CONTAINER_CLOSED,
+                    params: { container: currentContainer.name }
+                };
+            }
+        }
+        return { valid: true };
+    },
+    /**
+     * Execute the exit action - performs mutations only
+     * Assumes validation has already passed
+     */
+    execute(context) {
+        const actor = context.player;
+        const currentLocation = context.world.getLocation(actor.id); // Safe because validate ensures it exists
+        const currentContainer = context.world.getEntity(currentLocation); // Safe because validate ensures it exists
+        const parentLocation = context.world.getLocation(currentLocation); // Safe because validate ensures it exists
+        // Determine preposition based on what we're exiting from
+        let preposition = 'from';
+        if (currentContainer.has(world_model_1.TraitType.CONTAINER)) {
+            preposition = 'out of';
+        }
+        else if (currentContainer.has(world_model_1.TraitType.SUPPORTER)) {
+            preposition = 'off';
+        }
+        // Simply move the actor to the parent location - that's all!
+        context.world.moveEntity(actor.id, parentLocation);
+        // Store state for report phase using sharedData
+        const state = {
+            fromLocation: currentLocation,
+            fromLocationName: currentContainer.name,
+            toLocation: parentLocation,
+            preposition
+        };
+        const sharedData = getExitingSharedData(context);
+        sharedData.exitingState = state;
+    },
+    /**
+     * Report phase - generates events after successful execution
+     * Only called on success path - validation has already passed
+     */
+    report(context) {
+        // Get stored state from execute phase
+        const sharedData = getExitingSharedData(context);
+        const state = sharedData.exitingState;
+        if (!state) {
+            // This shouldn't happen, but handle gracefully
+            return [
+                context.event('if.event.exited', {
+                    messageId: `${context.action.id}.action_failed`,
+                    error: 'Missing state from execute phase'
+                })
+            ];
+        }
+        // Create the EXITED event with messageId for text rendering
+        return [context.event('if.event.exited', {
+                messageId: `${context.action.id}.exited`,
+                params: { place: state.fromLocationName },
+                fromLocation: state.fromLocation,
+                fromLocationName: state.fromLocationName,
+                toLocation: state.toLocation,
+                preposition: state.preposition
+            })];
+    },
+    /**
+     * Generate events when validation fails
+     * Called instead of execute/report when validate returns invalid
+     */
+    blocked(context, result) {
+        return [context.event('if.event.exited', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: result.params || {},
+                reason: result.error
+            })];
+    },
+    metadata: {
+        requiresDirectObject: false,
+        requiresIndirectObject: false,
+        directObjectScope: types_1.ScopeLevel.REACHABLE
+    }
+};
+//# sourceMappingURL=exiting.js.map

package/dist/actions/standard/exiting/exiting.js.map

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

package/dist/actions/standard/exiting/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Exiting action module exports
+ */
+export { exitingAction } from './exiting';
+export type { ExitedEventData, ExitingErrorData, ExitingEventMap } from './exiting-events';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/standard/exiting/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/exiting/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/actions/standard/exiting/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Exiting action module exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exitingAction = void 0;
+var exiting_1 = require("./exiting");
+Object.defineProperty(exports, "exitingAction", { enumerable: true, get: function () { return exiting_1.exitingAction; } });
+//# sourceMappingURL=index.js.map

package/dist/actions/standard/exiting/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/exiting/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qCAA0C;AAAjC,wGAAA,aAAa,OAAA"}

package/dist/actions/standard/giving/giving-events.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Event type definitions for the giving action
+ * @module
+ */
+export interface GivenEventData {
+    /** ID of the item being given */
+    item: string;
+    /** Name of the item for display */
+    itemName: string;
+    /** ID of the recipient */
+    recipient: string;
+    /** Name of the recipient for display */
+    recipientName: string;
+    /** Whether the gift was accepted */
+    accepted: boolean;
+    /** Reason for refusal if not accepted */
+    refusalReason?: string;
+}
+export interface GivingEventMap {
+    'if.event.given': GivenEventData;
+}
+//# sourceMappingURL=giving-events.d.ts.map

package/dist/actions/standard/giving/giving-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"giving-events.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/giving/giving-events.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,yCAAyC;IACzC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,cAAc,CAAC;CAClC"}

package/dist/actions/standard/giving/giving-events.js

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

package/dist/actions/standard/giving/giving-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"giving-events.js","sourceRoot":"","sources":["../../../../src/actions/standard/giving/giving-events.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/actions/standard/giving/giving.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Giving action - give objects to NPCs or other actors
+ *
+ * This action handles transferring objects from the player to NPCs.
+ * NPCs may accept or refuse items based on their state.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check if item can be given to recipient
+ * 2. execute: Transfer item, store result in sharedData
+ * 3. blocked: Generate events when validation fails
+ * 4. report: Generate success events from sharedData
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+export declare const givingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=giving.d.ts.map

package/dist/actions/standard/giving/giving.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"giving.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/giving/giving.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAwBrD,eAAO,MAAM,YAAY,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAiP7D,CAAC"}

package/dist/actions/standard/giving/giving.js

@@ -0,0 +1,231 @@
+"use strict";
+/**
+ * Giving action - give objects to NPCs or other actors
+ *
+ * This action handles transferring objects from the player to NPCs.
+ * NPCs may accept or refuse items based on their state.
+ *
+ * Uses four-phase pattern:
+ * 1. validate: Check if item can be given to recipient
+ * 2. execute: Transfer item, store result in sharedData
+ * 3. blocked: Generate events when validation fails
+ * 4. report: Generate success events from sharedData
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.givingAction = void 0;
+const types_1 = require("../../../scope/types");
+const world_model_1 = require("@sharpee/world-model");
+const constants_1 = require("../../constants");
+function getGivingSharedData(context) {
+    return context.sharedData;
+}
+exports.givingAction = {
+    id: constants_1.IFActions.GIVING,
+    // Default scope requirements for this action's slots
+    defaultScope: {
+        item: types_1.ScopeLevel.REACHABLE, // REACHABLE allows implicit take
+        recipient: types_1.ScopeLevel.REACHABLE
+    },
+    requiredMessages: [
+        'no_item',
+        'no_recipient',
+        'not_holding',
+        'recipient_not_visible',
+        'recipient_not_reachable',
+        'not_actor',
+        'self',
+        'inventory_full',
+        'too_heavy',
+        'not_interested',
+        'refuses',
+        'given',
+        'accepts',
+        'gratefully_accepts',
+        'reluctantly_accepts'
+    ],
+    metadata: {
+        requiresDirectObject: true,
+        requiresIndirectObject: true,
+        directObjectScope: types_1.ScopeLevel.REACHABLE, // REACHABLE allows implicit take
+        indirectObjectScope: types_1.ScopeLevel.REACHABLE
+    },
+    validate(context) {
+        const actor = context.player;
+        const item = context.command.directObject?.entity;
+        const recipient = context.command.indirectObject?.entity;
+        // Validate we have both item and recipient
+        if (!item) {
+            return {
+                valid: false,
+                error: 'no_item',
+                params: {}
+            };
+        }
+        if (!recipient) {
+            return {
+                valid: false,
+                error: 'no_recipient',
+                params: {}
+            };
+        }
+        // Item must be carried (or implicitly takeable)
+        // This enables "give apple to bob" when apple is on the ground
+        const carryCheck = context.requireCarriedOrImplicitTake(item);
+        if (!carryCheck.ok) {
+            return carryCheck.error;
+        }
+        // Check if recipient is an actor (can receive items)
+        if (!recipient.has(world_model_1.TraitType.ACTOR)) {
+            return {
+                valid: false,
+                error: 'not_actor',
+                params: { recipient: recipient.name }
+            };
+        }
+        // Prevent giving to self
+        if (recipient.id === actor.id) {
+            return {
+                valid: false,
+                error: 'self',
+                params: { item: item.name }
+            };
+        }
+        // Check inventory capacity
+        const recipientActor = recipient.get(world_model_1.TraitType.ACTOR);
+        if (recipientActor) {
+            const limit = recipientActor.capacity || recipientActor.inventoryLimit;
+            if (limit) {
+                const recipientInventory = context.world.getContents(recipient.id);
+                // Check item count
+                if (limit.maxItems !== undefined && recipientInventory.length >= limit.maxItems) {
+                    return {
+                        valid: false,
+                        error: 'inventory_full',
+                        params: { recipient: recipient.name }
+                    };
+                }
+                // Check weight
+                if (limit.maxWeight !== undefined) {
+                    const currentWeight = recipientInventory.reduce((sum, e) => {
+                        return sum + world_model_1.IdentityBehavior.getWeight(e);
+                    }, 0);
+                    const itemWeight = world_model_1.IdentityBehavior.getWeight(item);
+                    if (currentWeight + itemWeight > limit.maxWeight) {
+                        return {
+                            valid: false,
+                            error: 'too_heavy',
+                            params: { item: item.name, recipient: recipient.name }
+                        };
+                    }
+                }
+            }
+        }
+        // Check for preferences (stored directly on actor trait)
+        const preferences = recipientActor?.preferences;
+        if (preferences) {
+            const itemName = item.name.toLowerCase();
+            if (preferences.refuses && Array.isArray(preferences.refuses)) {
+                for (const refuse of preferences.refuses) {
+                    if (itemName.includes(refuse.toLowerCase())) {
+                        return {
+                            valid: false,
+                            error: 'not_interested',
+                            params: { item: item.name, recipient: recipient.name }
+                        };
+                    }
+                }
+            }
+        }
+        return { valid: true };
+    },
+    execute(context) {
+        const item = context.command.directObject.entity;
+        const recipient = context.command.indirectObject.entity;
+        const sharedData = getGivingSharedData(context);
+        // Store basic info
+        sharedData.itemId = item.id;
+        sharedData.itemName = item.name;
+        sharedData.recipientId = recipient.id;
+        sharedData.recipientName = recipient.name;
+        // Actually transfer the item from actor to recipient
+        context.world.moveEntity(item.id, recipient.id);
+        // Determine acceptance type based on preferences
+        let acceptanceType = 'normal';
+        const recipientActor = recipient.get(world_model_1.TraitType.ACTOR);
+        const preferences = recipientActor?.preferences;
+        if (preferences) {
+            const itemName = item.name.toLowerCase();
+            if (preferences.likes && Array.isArray(preferences.likes)) {
+                for (const like of preferences.likes) {
+                    if (itemName.includes(like.toLowerCase())) {
+                        acceptanceType = 'grateful';
+                        break;
+                    }
+                }
+            }
+            if (acceptanceType === 'normal' && preferences.dislikes && Array.isArray(preferences.dislikes)) {
+                for (const dislike of preferences.dislikes) {
+                    if (itemName.includes(dislike.toLowerCase())) {
+                        acceptanceType = 'reluctant';
+                        break;
+                    }
+                }
+            }
+        }
+        sharedData.acceptanceType = acceptanceType;
+        // Determine success message based on acceptance type
+        switch (acceptanceType) {
+            case 'grateful':
+                sharedData.messageId = 'gratefully_accepts';
+                break;
+            case 'reluctant':
+                sharedData.messageId = 'reluctantly_accepts';
+                break;
+            default:
+                sharedData.messageId = 'given';
+        }
+        sharedData.params = {
+            item: item.name,
+            recipient: recipient.name
+        };
+    },
+    blocked(context, result) {
+        const item = context.command.directObject?.entity;
+        const recipient = context.command.indirectObject?.entity;
+        return [context.event('if.event.give_blocked', {
+                blocked: true,
+                messageId: `${context.action.id}.${result.error}`,
+                params: {
+                    ...result.params,
+                    item: item?.name,
+                    recipient: recipient?.name
+                },
+                reason: result.error,
+                itemId: item?.id,
+                itemName: item?.name,
+                recipientId: recipient?.id,
+                recipientName: recipient?.name
+            })];
+    },
+    report(context) {
+        const sharedData = getGivingSharedData(context);
+        const events = [];
+        // Prepend any implicit take events (from requireCarriedOrImplicitTake)
+        if (context.sharedData.implicitTakeEvents) {
+            events.push(...context.sharedData.implicitTakeEvents);
+        }
+        // Emit given event with messageId for text rendering
+        events.push(context.event('if.event.given', {
+            messageId: `${context.action.id}.${sharedData.messageId}`,
+            params: sharedData.params,
+            item: sharedData.itemId,
+            itemName: sharedData.itemName,
+            recipient: sharedData.recipientId,
+            recipientName: sharedData.recipientName,
+            accepted: true
+        }));
+        return events;
+    },
+    group: "social"
+};
+//# sourceMappingURL=giving.js.map

package/dist/actions/standard/giving/giving.js.map

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

package/dist/actions/standard/giving/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Giving action module
+ * @module
+ */
+export { givingAction } from './giving';
+export * from './giving-events';
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/standard/giving/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/giving/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,cAAc,iBAAiB,CAAC"}

package/dist/actions/standard/giving/index.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Giving action module
+ * @module
+ */
+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 });
+exports.givingAction = void 0;
+var giving_1 = require("./giving");
+Object.defineProperty(exports, "givingAction", { enumerable: true, get: function () { return giving_1.givingAction; } });
+__exportStar(require("./giving-events"), exports);
+//# sourceMappingURL=index.js.map

package/dist/actions/standard/giving/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/actions/standard/giving/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,kDAAgC"}

package/dist/actions/standard/going/going-data.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Data builder for going action
+ *
+ * Centralizes all room and movement snapshot logic for the going action.
+ * This separates data structure concerns from business logic.
+ */
+import { ActionDataBuilder, ActionDataConfig } from '../../data-builder-types';
+/**
+ * Build actor moved event data
+ */
+export declare const buildActorMovedData: ActionDataBuilder<Record<string, unknown>>;
+/**
+ * Build actor exited event data
+ */
+export declare const buildActorExitedData: ActionDataBuilder<Record<string, unknown>>;
+/**
+ * Build actor entered event data
+ */
+export declare const buildActorEnteredData: ActionDataBuilder<Record<string, unknown>>;
+/**
+ * Determine the success message for going action
+ */
+export declare function determineGoingMessage(movedData: Record<string, unknown>): {
+    messageId: string;
+    params: Record<string, any>;
+};
+/**
+ * Configuration for going data builders
+ */
+export declare const actorMovedDataConfig: ActionDataConfig<Record<string, unknown>>;
+export declare const actorExitedDataConfig: ActionDataConfig<Record<string, unknown>>;
+export declare const actorEnteredDataConfig: ActionDataConfig<Record<string, unknown>>;
+//# sourceMappingURL=going-data.d.ts.map

package/dist/actions/standard/going/going-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"going-data.d.ts","sourceRoot":"","sources":["../../../../src/actions/standard/going/going-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AA8B/E;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiD1E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6B3E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiC5E,CAAC;AAEF;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,CAgBpD;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG1E,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG3E,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,gBAAgB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG5E,CAAC"}