@nodemod/core 1.0.0

package/dist/core/resource.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Function type for precaching operations.
+ */
+export type PrecacheFunction = () => void;
+/**
+ * Callback function executed after a resource is precached.
+ */
+export type PrecacheCallback = (id: number) => void;
+/**
+ * Configuration for a resource to be precached.
+ */
+export interface ResourceItem {
+    /** Type of resource (model, sound, or generic file) */
+    type: 'model' | 'sound' | 'generic';
+    /** File path relative to the game directory */
+    path: string;
+}
+/**
+ * Enhanced resource management system with queuing for game assets.
+ * Handles precaching of models, sounds, and generic files with automatic queue processing on map spawn.
+ *
+ * @example
+ * ```typescript
+ * // Precache a single sound
+ * await nodemodCore.resource.precacheSound('weapons/ak47/ak47-1.wav');
+ *
+ * // Precache a model with callback
+ * await nodemodCore.resource.precacheModel('models/player/terror/terror.mdl');
+ *
+ * // Batch precache multiple resources
+ * await nodemodCore.resource.precacheBatch([
+ *   { type: 'sound', path: 'weapons/ak47/ak47-1.wav' },
+ *   { type: 'model', path: 'models/w_ak47.mdl' },
+ *   { type: 'generic', path: 'sprites/muzzleflash.spr' }
+ * ]);
+ * ```
+ */
+export default class NodemodResource {
+    /** Queue of precaching functions to execute on map spawn */
+    private listToPrecache;
+    /**
+     * Creates a new NodemodResource instance and sets up event handlers.
+     * Automatically processes the precache queue when the map spawns.
+     */
+    constructor();
+    /**
+     * Queues a sound file for precaching.
+     * The actual precaching occurs when the map spawns.
+     *
+     * @param path - Path to the sound file (relative to game directory)
+     * @param cb - Optional callback executed with the precache ID
+     *
+     * @example
+     * ```typescript
+     * // Basic sound precaching
+     * await nodemodCore.resource.precacheSound('weapons/ak47/ak47-1.wav');
+     *
+     * // With callback
+     * await nodemodCore.resource.precacheSound('ambient/water/water1.wav', (id) => {
+     *   console.log(`Sound precached with ID: ${id}`);
+     * });
+     * ```
+     */
+    precacheSound(path: string, cb?: PrecacheCallback): Promise<void>;
+    /**
+     * Queues a model file for precaching.
+     * Returns a promise that resolves with the precache ID when the map spawns.
+     *
+     * @param path - Path to the model file (relative to game directory)
+     * @returns Promise resolving to the precache ID
+     *
+     * @example
+     * ```typescript
+     * const modelId = await nodemodCore.resource.precacheModel('models/w_ak47.mdl');
+     * console.log(`Model precached with ID: ${modelId}`);
+     * ```
+     */
+    precacheModel(path: string): Promise<number>;
+    /**
+     * Queues a generic file for precaching.
+     * Returns a promise that resolves with the precache ID when the map spawns.
+     *
+     * @param path - Path to the generic file (relative to game directory)
+     * @returns Promise resolving to the precache ID
+     *
+     * @example
+     * ```typescript
+     * const spriteId = await nodemodCore.resource.precacheGeneric('sprites/muzzleflash.spr');
+     * console.log(`Sprite precached with ID: ${spriteId}`);
+     * ```
+     */
+    precacheGeneric(path: string): Promise<number>;
+    /**
+     * Precaches multiple resources in batch.
+     * More efficient than precaching resources individually.
+     *
+     * @param resources - Array of resources to precache
+     * @returns Promise resolving to array of precache IDs (or void for sounds with no callback)
+     *
+     * @example
+     * ```typescript
+     * const resources = [
+     *   { type: 'sound', path: 'weapons/ak47/ak47-1.wav' },
+     *   { type: 'model', path: 'models/w_ak47.mdl' },
+     *   { type: 'generic', path: 'sprites/muzzleflash.spr' }
+     * ];
+     *
+     * const results = await nodemodCore.resource.precacheBatch(resources);
+     * console.log('All resources precached:', results);
+     * ```
+     */
+    precacheBatch(resources: ResourceItem[]): Promise<(number | void)[]>;
+    /**
+     * Gets the current number of queued precaching operations.
+     *
+     * @returns Number of items in the precache queue
+     *
+     * @example
+     * ```typescript
+     * console.log(`${nodemodCore.resource.getQueueLength()} items queued for precaching`);
+     * ```
+     */
+    getQueueLength(): number;
+    /**
+     * Clears all queued precaching operations.
+     * Use with caution as this will prevent queued resources from being precached.
+     *
+     * @example
+     * ```typescript
+     * // Clear all pending precache operations
+     * nodemodCore.resource.clearQueue();
+     * console.log('Precache queue cleared');
+     * ```
+     */
+    clearQueue(): void;
+}
+//# sourceMappingURL=resource.d.ts.map

package/dist/core/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/core/resource.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACpC,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;CACd;AAID;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAClC,4DAA4D;IAC5D,OAAO,CAAC,cAAc,CAA0B;IAEhD;;;OAGG;;IAUH;;;;;;;;;;;;;;;;;OAiBG;IACG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAE,gBAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjF;;;;;;;;;;;;OAYG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU5C;;;;;;;;;;;;OAYG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAU9C;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAC;IAgBpE;;;;;;;;;OASG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;;;;;;OAUG;IACH,UAAU,IAAI,IAAI;CAGnB"}

package/dist/core/resource.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Extend the nodemod namespace to include missing methods
+/**
+ * Enhanced resource management system with queuing for game assets.
+ * Handles precaching of models, sounds, and generic files with automatic queue processing on map spawn.
+ *
+ * @example
+ * ```typescript
+ * // Precache a single sound
+ * await nodemodCore.resource.precacheSound('weapons/ak47/ak47-1.wav');
+ *
+ * // Precache a model with callback
+ * await nodemodCore.resource.precacheModel('models/player/terror/terror.mdl');
+ *
+ * // Batch precache multiple resources
+ * await nodemodCore.resource.precacheBatch([
+ *   { type: 'sound', path: 'weapons/ak47/ak47-1.wav' },
+ *   { type: 'model', path: 'models/w_ak47.mdl' },
+ *   { type: 'generic', path: 'sprites/muzzleflash.spr' }
+ * ]);
+ * ```
+ */
+class NodemodResource {
+    /** Queue of precaching functions to execute on map spawn */
+    listToPrecache = [];
+    /**
+     * Creates a new NodemodResource instance and sets up event handlers.
+     * Automatically processes the precache queue when the map spawns.
+     */
+    constructor() {
+        nodemod.on('dllSpawn', () => {
+            while (this.listToPrecache.length) {
+                const fn = this.listToPrecache.pop();
+                if (fn)
+                    fn();
+            }
+        });
+    }
+    /**
+     * Queues a sound file for precaching.
+     * The actual precaching occurs when the map spawns.
+     *
+     * @param path - Path to the sound file (relative to game directory)
+     * @param cb - Optional callback executed with the precache ID
+     *
+     * @example
+     * ```typescript
+     * // Basic sound precaching
+     * await nodemodCore.resource.precacheSound('weapons/ak47/ak47-1.wav');
+     *
+     * // With callback
+     * await nodemodCore.resource.precacheSound('ambient/water/water1.wav', (id) => {
+     *   console.log(`Sound precached with ID: ${id}`);
+     * });
+     * ```
+     */
+    async precacheSound(path, cb = () => { }) {
+        this.listToPrecache.push(() => {
+            const id = nodemod.eng.precacheSound(path);
+            cb(id);
+        });
+    }
+    /**
+     * Queues a model file for precaching.
+     * Returns a promise that resolves with the precache ID when the map spawns.
+     *
+     * @param path - Path to the model file (relative to game directory)
+     * @returns Promise resolving to the precache ID
+     *
+     * @example
+     * ```typescript
+     * const modelId = await nodemodCore.resource.precacheModel('models/w_ak47.mdl');
+     * console.log(`Model precached with ID: ${modelId}`);
+     * ```
+     */
+    precacheModel(path) {
+        return new Promise((resolve) => {
+            this.listToPrecache.push(() => {
+                const id = nodemod.eng.precacheModel(path);
+                console.log(path, id);
+                resolve(id);
+            });
+        });
+    }
+    /**
+     * Queues a generic file for precaching.
+     * Returns a promise that resolves with the precache ID when the map spawns.
+     *
+     * @param path - Path to the generic file (relative to game directory)
+     * @returns Promise resolving to the precache ID
+     *
+     * @example
+     * ```typescript
+     * const spriteId = await nodemodCore.resource.precacheGeneric('sprites/muzzleflash.spr');
+     * console.log(`Sprite precached with ID: ${spriteId}`);
+     * ```
+     */
+    precacheGeneric(path) {
+        return new Promise((resolve) => {
+            this.listToPrecache.push(() => {
+                const id = nodemod.eng.precacheGeneric(path);
+                console.log(path, id);
+                resolve(id);
+            });
+        });
+    }
+    /**
+     * Precaches multiple resources in batch.
+     * More efficient than precaching resources individually.
+     *
+     * @param resources - Array of resources to precache
+     * @returns Promise resolving to array of precache IDs (or void for sounds with no callback)
+     *
+     * @example
+     * ```typescript
+     * const resources = [
+     *   { type: 'sound', path: 'weapons/ak47/ak47-1.wav' },
+     *   { type: 'model', path: 'models/w_ak47.mdl' },
+     *   { type: 'generic', path: 'sprites/muzzleflash.spr' }
+     * ];
+     *
+     * const results = await nodemodCore.resource.precacheBatch(resources);
+     * console.log('All resources precached:', results);
+     * ```
+     */
+    precacheBatch(resources) {
+        const promises = [];
+        resources.forEach(resource => {
+            if (resource.type === 'model') {
+                promises.push(this.precacheModel(resource.path));
+            }
+            else if (resource.type === 'sound') {
+                promises.push(this.precacheSound(resource.path));
+            }
+            else if (resource.type === 'generic') {
+                promises.push(this.precacheGeneric(resource.path));
+            }
+        });
+        return Promise.all(promises);
+    }
+    /**
+     * Gets the current number of queued precaching operations.
+     *
+     * @returns Number of items in the precache queue
+     *
+     * @example
+     * ```typescript
+     * console.log(`${nodemodCore.resource.getQueueLength()} items queued for precaching`);
+     * ```
+     */
+    getQueueLength() {
+        return this.listToPrecache.length;
+    }
+    /**
+     * Clears all queued precaching operations.
+     * Use with caution as this will prevent queued resources from being precached.
+     *
+     * @example
+     * ```typescript
+     * // Clear all pending precache operations
+     * nodemodCore.resource.clearQueue();
+     * console.log('Precache queue cleared');
+     * ```
+     */
+    clearQueue() {
+        this.listToPrecache = [];
+    }
+}
+exports.default = NodemodResource;
+//# sourceMappingURL=resource.js.map

package/dist/core/resource.js.map

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

package/dist/core/sound.d.ts

@@ -0,0 +1,262 @@
+import type NodemodUtil from '../utils/util';
+/**
+ * Configuration options for emitting sounds.
+ */
+export interface EmitSoundOptions {
+    /** Target entity or entity index (0 for world entity) */
+    entity?: nodemod.Entity | number;
+    /** Audio channel to use */
+    channel?: number;
+    /** Path to the sound file */
+    sound: string;
+    /** Volume level (0.0 to 1.0) */
+    volume?: number;
+    /** Sound attenuation over distance */
+    attenuation?: number;
+    /** Sound transmission flags */
+    flags?: number;
+    /** Pitch adjustment (1-255, 100 = normal) */
+    pitch?: number;
+}
+/**
+ * Sound configuration alias for batch operations.
+ */
+export interface SoundConfig extends EmitSoundOptions {
+}
+/**
+ * Result of a sound emission operation.
+ */
+export interface SoundResult {
+    /** Index in the batch operation */
+    index: number;
+    /** Whether the sound was successfully emitted */
+    success: boolean;
+    /** The configuration used for this sound */
+    config: SoundConfig;
+    /** Error message if emission failed */
+    error?: string;
+}
+/**
+ * Audio channel constants for categorizing sounds.
+ */
+export declare const SoundChannel: {
+    /** Automatically select appropriate channel */
+    auto: number;
+    /** Weapon sounds */
+    weapon: number;
+    /** Voice communications */
+    voice: number;
+    /** Item interaction sounds */
+    item: number;
+    /** Body/movement sounds */
+    body: number;
+    /** Streaming audio */
+    stream: number;
+    /** Static/ambient sounds */
+    static: number;
+    /** Network voice communication base */
+    networkVoiceBase: number;
+    /** Network voice communication end */
+    networkVoiceEnd: number;
+};
+/**
+ * Enhanced sound system providing comprehensive audio functionality for the game server.
+ * Handles sound emission, validation, and management with improved defaults and error handling.
+ *
+ * @example
+ * ```typescript
+ * // Play a weapon sound
+ * nodemodCore.sound.emitSound({
+ *   entity: player,
+ *   channel: SoundChannel.weapon,
+ *   sound: 'weapons/ak47/ak47-1.wav',
+ *   volume: 0.8,
+ *   pitch: 110
+ * });
+ *
+ * // Broadcast ambient sound to all players
+ * nodemodCore.sound.broadcastSound('ambient/music/track1.wav', {
+ *   volume: 0.5,
+ *   attenuation: 0.5
+ * });
+ *
+ * // Play client-side sound command
+ * nodemodCore.sound.emitClientSound(player, 'ui/buttonclick');
+ * ```
+ */
+export default class NodemodSound {
+    /** Utility service for entity operations */
+    private util;
+    /**
+     * Creates a new NodemodSound instance.
+     *
+     * @param utilService - Utility service for entity operations
+     */
+    constructor(utilService: NodemodUtil);
+    /**
+     * Emits a sound with enhanced validation and default values.
+     * Provides better parameter validation and clamping than the basic engine function.
+     *
+     * @param options - Sound emission configuration
+     * @returns True if sound was emitted successfully, false otherwise
+     *
+     * @example
+     * ```typescript
+     * // Basic sound emission
+     * nodemodCore.sound.emitSound({
+     *   sound: 'weapons/ak47/ak47-1.wav'
+     * });
+     *
+     * // Advanced sound with all options
+     * nodemodCore.sound.emitSound({
+     *   entity: player,
+     *   channel: SoundChannel.weapon,
+     *   sound: 'weapons/ak47/ak47-1.wav',
+     *   volume: 0.8,
+     *   attenuation: 1.5,
+     *   flags: 0, // Normal playback
+     *   pitch: 110
+     * });
+     * ```
+     */
+    emitSound(options: EmitSoundOptions): boolean;
+    /**
+     * Sends a client-side sound command to a specific player.
+     * Uses the client's `spk` command to play sounds locally.
+     *
+     * @param entity - Target player entity or index
+     * @param soundName - Name of the sound file (with or without extension)
+     * @param extension - File extension to append if not present in soundName
+     * @returns True if command was sent successfully, false otherwise
+     *
+     * @example
+     * ```typescript
+     * // Play UI sound to player
+     * nodemodCore.sound.emitClientSound(player, 'ui/buttonclick');
+     *
+     * // Play custom sound with specific extension
+     * nodemodCore.sound.emitClientSound(player, 'custom/notification', 'mp3');
+     * ```
+     */
+    emitClientSound(entity: nodemod.Entity | number, soundName: string, extension?: string): boolean;
+    /**
+     * Emits an ambient sound at a specific 3D position.
+     * Useful for environmental sounds, explosions, or location-based audio.
+     *
+     * @param position - 3D coordinates [x, y, z] where the sound originates
+     * @param sound - Path to the sound file
+     * @param volume - Volume level (0.0 to 1.0)
+     * @param attenuation - How quickly sound fades with distance
+     * @param flags - Sound transmission flags
+     * @param pitch - Pitch adjustment (1-255, 100 = normal)
+     * @returns True if sound was emitted successfully, false otherwise
+     *
+     * @example
+     * ```typescript
+     * // Explosion sound at coordinates
+     * nodemodCore.sound.emitAmbientSound(
+     *   [100, 200, 50],
+     *   'weapons/explode1.wav',
+     *   0.9,
+     *   2.0
+     * );
+     *
+     * // Ambient environmental sound
+     * nodemodCore.sound.emitAmbientSound(
+     *   [0, 0, 0],
+     *   'ambient/wind/wind1.wav',
+     *   0.3,
+     *   0.5,
+     *   nodemod.SND.SPAWNING
+     * );
+     * ```
+     */
+    emitAmbientSound(position: number[], sound: string, volume?: number, attenuation?: number, flags?: number, pitch?: number): boolean;
+    /**
+     * Broadcasts a sound to all players on the server.
+     * Convenient wrapper for playing sounds that everyone should hear.
+     *
+     * @param sound - Path to the sound file
+     * @param options - Optional sound configuration overrides
+     * @returns True if sound was broadcast successfully, false otherwise
+     *
+     * @example
+     * ```typescript
+     * // Simple server announcement sound
+     * nodemodCore.sound.broadcastSound('admin/announcement.wav');
+     *
+     * // Round start music with custom settings
+     * nodemodCore.sound.broadcastSound('music/roundstart.wav', {
+     *   volume: 0.7,
+     *   channel: SoundChannel.stream,
+     *   attenuation: 0.1
+     * });
+     * ```
+     */
+    broadcastSound(sound: string, options?: Partial<EmitSoundOptions>): boolean;
+    /**
+     * Attempts to stop a sound on a specific entity.
+     * Uses a workaround by playing a very quiet sound since direct stop may not be available.
+     *
+     * @param entity - Target entity or entity index
+     * @param channel - Audio channel to stop
+     * @param sound - Specific sound to stop (empty for all sounds on channel)
+     * @returns True if stop attempt was successful, false otherwise
+     *
+     * @example
+     * ```typescript
+     * // Stop all sounds on entity
+     * nodemodCore.sound.stopSound(player);
+     *
+     * // Stop weapon channel sounds
+     * nodemodCore.sound.stopSound(player, SoundChannel.weapon);
+     * ```
+     */
+    stopSound(entity: nodemod.Entity | number, channel?: number, sound?: string): boolean;
+    /**
+     * Validates whether a sound file path is valid.
+     * Checks for supported file extensions and proper format.
+     *
+     * @param soundPath - Path to the sound file to validate
+     * @returns True if the sound path is valid, false otherwise
+     *
+     * @example
+     * ```typescript
+     * // Valid sound files
+     * console.log(nodemodCore.sound.isValidSound('weapons/ak47-1.wav')); // true
+     * console.log(nodemodCore.sound.isValidSound('music/track.mp3')); // true
+     *
+     * // Invalid sound files
+     * console.log(nodemodCore.sound.isValidSound('invalid.txt')); // false
+     * console.log(nodemodCore.sound.isValidSound('')); // false
+     * ```
+     */
+    isValidSound(soundPath: string): boolean;
+    /**
+     * Emits multiple sounds in batch with individual result tracking.
+     * Useful for playing multiple sounds simultaneously or handling bulk operations.
+     *
+     * @param soundConfigs - Array of sound configurations to emit
+     * @returns Array of results indicating success/failure for each sound
+     *
+     * @example
+     * ```typescript
+     * const sounds = [
+     *   { sound: 'weapons/ak47/ak47-1.wav', entity: player1, volume: 0.8 },
+     *   { sound: 'weapons/deagle/deagle-1.wav', entity: player2, volume: 0.9 },
+     *   { sound: 'items/ammopickup2.wav', volume: 0.5 }
+     * ];
+     *
+     * const results = nodemodCore.sound.emitMultipleSounds(sounds);
+     * results.forEach((result, i) => {
+     *   if (result.success) {
+     *     console.log(`Sound ${i} played successfully`);
+     *   } else {
+     *     console.log(`Sound ${i} failed: ${result.error}`);
+     *   }
+     * });
+     * ```
+     */
+    emitMultipleSounds(soundConfigs: SoundConfig[]): SoundResult[];
+}
+//# sourceMappingURL=sound.d.ts.map

package/dist/core/sound.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sound.d.ts","sourceRoot":"","sources":["../../src/core/sound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yDAAyD;IACzD,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IACjC,2BAA2B;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,gBAAgB;CAAG;AAExD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,MAAM,EAAE,WAAW,CAAC;IACpB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB,+CAA+C;;IAE/C,oBAAoB;;IAEpB,2BAA2B;;IAE3B,8BAA8B;;IAE9B,2BAA2B;;IAE3B,sBAAsB;;IAEtB,4BAA4B;;IAE5B,uCAAuC;;IAEvC,sCAAsC;;CAEvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,CAAC,OAAO,OAAO,YAAY;IAC/B,4CAA4C;IAC5C,OAAO,CAAC,IAAI,CAAc;IAE1B;;;;OAIG;gBACS,WAAW,EAAE,WAAW;IAIpC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO;IA8B7C;;;;;;;;;;;;;;;;;OAiBG;IACH,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,GAAE,MAAc,GAAG,OAAO;IAYvG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,EAAE,WAAW,GAAE,MAAY,EAAE,KAAK,GAAE,MAAU,EAAE,KAAK,GAAE,MAAY,GAAG,OAAO;IAkBrJ;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GAAG,OAAO;IAe/E;;;;;;;;;;;;;;;;;OAiBG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,OAAO,GAAE,MAA0B,EAAE,KAAK,GAAE,MAAW,GAAG,OAAO;IAc5G;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IASxC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,kBAAkB,CAAC,YAAY,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;CAc/D"}