@nodemod/core 1.0.0

package/dist/enhanced/trace.d.ts

@@ -0,0 +1,198 @@
+/**
+ * Configuration options for trace operations.
+ */
+export interface TraceOptions {
+    /** Trace flags for filtering what to ignore (use nodemod.IGNORE constants) */
+    flags?: number;
+    /** Entity to ignore during the trace */
+    ignore?: nodemod.Entity | null;
+    /** Hull size for hull-based traces (use nodemod.HULL constants) */
+    hullSize?: number;
+}
+/**
+ * Enhanced trace result with additional computed properties and convenience flags.
+ */
+export interface EnhancedTraceResult extends nodemod.TraceResult {
+    /** Distance traveled before hitting something */
+    distance?: number;
+    /** Exact 3D coordinates where the trace hit */
+    hitPoint?: number[];
+    /** Whether the trace hit something before reaching the end */
+    didHit: boolean;
+    /** Whether the trace hit the sky */
+    hitSky: boolean;
+    /** Whether the trace hit water */
+    hitWater: boolean;
+    /** Entity that was hit (if any) */
+    hitEntity?: nodemod.Entity | null;
+    /** Whether the trace hit a solid surface */
+    hitSurface: boolean;
+}
+/**
+ * Detailed information about the contents of a specific point in space.
+ */
+export interface PointContentsResult {
+    /** Raw contents value from the engine */
+    contents: number;
+    /** Whether the point is in empty space */
+    isEmpty: boolean;
+    /** Whether the point is inside a solid object */
+    isSolid: boolean;
+    /** Whether the point is in water */
+    isWater: boolean;
+    /** Whether the point is in slime */
+    isSlime: boolean;
+    /** Whether the point is in lava */
+    isLava: boolean;
+    /** Whether the point is in the sky */
+    isSky: boolean;
+}
+/**
+ * Advanced tracing and physics utilities for line-of-sight, collision detection, and spatial analysis.
+ * Provides enhanced trace operations with convenient result parsing and batch processing capabilities.
+ *
+ * @example
+ * ```typescript
+ * // Basic line tracing
+ * const trace = nodemodCore.trace.line([0, 0, 100], [100, 100, 100]);
+ * if (trace?.didHit) {
+ *   console.log(`Hit something at distance: ${trace.distance}`);
+ * }
+ *
+ * // Line of sight check
+ * const canSee = nodemodCore.trace.canSee(player1, player2);
+ * console.log(`Players can see each other: ${canSee}`);
+ *
+ * // Find ground below position
+ * const ground = nodemodCore.trace.findGround([100, 100, 500]);
+ * if (ground?.didHit) {
+ *   console.log(`Ground is at: ${ground.hitPoint}`);
+ * }
+ *
+ * // Check point contents
+ * const contents = nodemodCore.trace.pointContents([50, 50, 50]);
+ * if (contents.isWater) {
+ *   console.log('Point is underwater');
+ * }
+ * ```
+ */
+export default class NodemodTrace {
+    /**
+     * Performs a line trace between two points with enhanced options and result parsing.
+     *
+     * @param start - Starting point [x, y, z]
+     * @param end - Ending point [x, y, z]
+     * @param options - Trace configuration options
+     * @returns Enhanced trace result with additional computed properties
+     *
+     * @example
+     * ```typescript
+     * // Basic line trace
+     * const trace = nodemodCore.trace.line([0, 0, 0], [100, 0, 0]);
+     *
+     * // Trace ignoring monsters
+     * const trace2 = nodemodCore.trace.line([0, 0, 0], [100, 0, 0], {
+     *   flags: nodemod.IGNORE.MONSTERS
+     * });
+     *
+     * // Hull-based trace
+     * const trace3 = nodemodCore.trace.line([0, 0, 0], [100, 0, 0], {
+     *   hullSize: nodemod.HULL.HUMAN,
+     *   ignore: player
+     * });
+     * ```
+     */
+    line(start: number[], end: number[], options?: TraceOptions): EnhancedTraceResult | null;
+    fromEntity(entity: nodemod.Entity | number, target: nodemod.Entity | number[], options?: TraceOptions): EnhancedTraceResult | null;
+    /**
+     * Checks if one entity has line of sight to another entity.
+     * Automatically adjusts for entity view offset and target positioning.
+     *
+     * @param entity1 - Source entity or entity index
+     * @param entity2 - Target entity or entity index
+     * @param options - Trace configuration options
+     * @returns True if entity1 can see entity2, false otherwise
+     *
+     * @example
+     * ```typescript
+     * // Check if player can see another player
+     * const canSee = nodemodCore.trace.canSee(player1, player2);
+     * if (canSee) {
+     *   console.log('Player 1 can see Player 2');
+     * }
+     *
+     * // Check line of sight ignoring other players
+     * const canSeeIgnoringPlayers = nodemodCore.trace.canSee(sniper, target, {
+     *   flags: nodemod.IGNORE.MONSTERS
+     * });
+     * ```
+     */
+    canSee(entity1: nodemod.Entity | number, entity2: nodemod.Entity | number, options?: TraceOptions): boolean;
+    findGround(origin: number[], distance?: number): EnhancedTraceResult | null;
+    sphere(start: number[], end: number[], radius: number, options?: TraceOptions): EnhancedTraceResult | null;
+    monsterHull(entity: nodemod.Entity, start: number[], end: number[], options?: TraceOptions): nodemod.TraceMonsterHullResult;
+    texture(entity: nodemod.Entity, start: number[], end: number[]): string;
+    projectile(entity: nodemod.Entity, ignore?: nodemod.Entity | null): EnhancedTraceResult | null;
+    /**
+     * Analyzes the contents of a specific point in 3D space.
+     * Useful for checking if a position is in water, solid matter, or empty space.
+     *
+     * @param point - 3D coordinates [x, y, z] to check
+     * @returns Detailed information about what exists at that point
+     *
+     * @example
+     * ```typescript
+     * // Check if a position is safe for teleporting
+     * const contents = nodemodCore.trace.pointContents([100, 200, 300]);
+     * if (contents.isEmpty) {
+     *   console.log('Safe to teleport');
+     * } else if (contents.isWater) {
+     *   console.log('Position is underwater');
+     * } else if (contents.isSolid) {
+     *   console.log('Position is inside a wall');
+     * }
+     *
+     * // Check multiple points
+     * const positions = [[0,0,0], [100,100,100], [200,200,200]];
+     * positions.forEach((pos, i) => {
+     *   const result = nodemodCore.trace.pointContents(pos);
+     *   console.log(`Point ${i}: ${result.isEmpty ? 'empty' : 'occupied'}`);
+     * });
+     * ```
+     */
+    pointContents(point: number[]): PointContentsResult;
+    enhanceTraceResult(result: nodemod.TraceResult | null, start?: number[] | null, end?: number[] | null): EnhancedTraceResult | null;
+    multiLine(traces: Array<{
+        start: number[];
+        end: number[];
+        options?: TraceOptions;
+    } | [number[], number[], TraceOptions?]>): Array<EnhancedTraceResult | null>;
+    findClosestSurface(origin: number[], direction: number[], maxDistance?: number): EnhancedTraceResult | null;
+    traceCardinal(origin: number[], distance?: number): Record<string, EnhancedTraceResult | null>;
+    /**
+     * Checks if a rectangular area is clear of obstacles by testing all corners.
+     * Useful for verifying if there's enough space to place objects or teleport players.
+     *
+     * @param center - Center point of the area [x, y, z]
+     * @param size - Dimensions of the area [width, length, height] (default: [64, 64, 64])
+     * @returns True if the entire area is clear, false if any part is blocked
+     *
+     * @example
+     * ```typescript
+     * // Check if there's space for a player
+     * const playerSize = [32, 32, 72]; // Typical player dimensions
+     * const isClear = nodemodCore.trace.isAreaClear([100, 200, 300], playerSize);
+     * if (isClear) {
+     *   console.log('Safe to spawn player here');
+     * }
+     *
+     * // Check default 64x64x64 area
+     * const canPlaceItem = nodemodCore.trace.isAreaClear([50, 50, 50]);
+     * ```
+     */
+    isAreaClear(center: number[], size?: number[]): boolean;
+    normalizeVector(vector: number[]): number[];
+    vectorLength(vector: number[]): number;
+    vectorDistance(v1: number[], v2: number[]): number;
+}
+//# sourceMappingURL=trace.d.ts.map

package/dist/enhanced/trace.d.ts.map

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

package/dist/enhanced/trace.js

@@ -0,0 +1,311 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Advanced tracing and physics utilities for line-of-sight, collision detection, and spatial analysis.
+ * Provides enhanced trace operations with convenient result parsing and batch processing capabilities.
+ *
+ * @example
+ * ```typescript
+ * // Basic line tracing
+ * const trace = nodemodCore.trace.line([0, 0, 100], [100, 100, 100]);
+ * if (trace?.didHit) {
+ *   console.log(`Hit something at distance: ${trace.distance}`);
+ * }
+ *
+ * // Line of sight check
+ * const canSee = nodemodCore.trace.canSee(player1, player2);
+ * console.log(`Players can see each other: ${canSee}`);
+ *
+ * // Find ground below position
+ * const ground = nodemodCore.trace.findGround([100, 100, 500]);
+ * if (ground?.didHit) {
+ *   console.log(`Ground is at: ${ground.hitPoint}`);
+ * }
+ *
+ * // Check point contents
+ * const contents = nodemodCore.trace.pointContents([50, 50, 50]);
+ * if (contents.isWater) {
+ *   console.log('Point is underwater');
+ * }
+ * ```
+ */
+class NodemodTrace {
+    /**
+     * Performs a line trace between two points with enhanced options and result parsing.
+     *
+     * @param start - Starting point [x, y, z]
+     * @param end - Ending point [x, y, z]
+     * @param options - Trace configuration options
+     * @returns Enhanced trace result with additional computed properties
+     *
+     * @example
+     * ```typescript
+     * // Basic line trace
+     * const trace = nodemodCore.trace.line([0, 0, 0], [100, 0, 0]);
+     *
+     * // Trace ignoring monsters
+     * const trace2 = nodemodCore.trace.line([0, 0, 0], [100, 0, 0], {
+     *   flags: nodemod.IGNORE.MONSTERS
+     * });
+     *
+     * // Hull-based trace
+     * const trace3 = nodemodCore.trace.line([0, 0, 0], [100, 0, 0], {
+     *   hullSize: nodemod.HULL.HUMAN,
+     *   ignore: player
+     * });
+     * ```
+     */
+    line(start, end, options = {}) {
+        const { flags = 0, ignore = null, hullSize = 0 } = options;
+        let result;
+        if (hullSize > 0) {
+            // traceHull requires Entity, not Entity | null
+            const ignoreEntity = ignore || nodemod.eng.pEntityOfEntIndex(0); // Use world entity as fallback
+            result = nodemod.eng.traceHull(start, end, flags, hullSize, ignoreEntity);
+        }
+        else {
+            result = nodemod.eng.traceLine(start, end, flags, ignore || null);
+        }
+        return this.enhanceTraceResult(result, start, end);
+    }
+    // Trace from entity to point
+    fromEntity(entity, target, options = {}) {
+        const entityObj = typeof entity === 'number' ?
+            nodemod.eng.pEntityOfEntIndex(entity) : entity;
+        if (!entityObj)
+            return null;
+        const start = [
+            entityObj.origin[0],
+            entityObj.origin[1],
+            entityObj.origin[2] + (entityObj.view_ofs?.[2] || 0)
+        ];
+        const end = Array.isArray(target) ? target : [
+            target.origin[0],
+            target.origin[1],
+            target.origin[2] + 16
+        ];
+        return this.line(start, end, { ...options, ignore: entityObj });
+    }
+    /**
+     * Checks if one entity has line of sight to another entity.
+     * Automatically adjusts for entity view offset and target positioning.
+     *
+     * @param entity1 - Source entity or entity index
+     * @param entity2 - Target entity or entity index
+     * @param options - Trace configuration options
+     * @returns True if entity1 can see entity2, false otherwise
+     *
+     * @example
+     * ```typescript
+     * // Check if player can see another player
+     * const canSee = nodemodCore.trace.canSee(player1, player2);
+     * if (canSee) {
+     *   console.log('Player 1 can see Player 2');
+     * }
+     *
+     * // Check line of sight ignoring other players
+     * const canSeeIgnoringPlayers = nodemodCore.trace.canSee(sniper, target, {
+     *   flags: nodemod.IGNORE.MONSTERS
+     * });
+     * ```
+     */
+    canSee(entity1, entity2, options = {}) {
+        const entity2Obj = typeof entity2 === 'number' ? nodemod.eng.pEntityOfEntIndex(entity2) : entity2;
+        if (!entity2Obj)
+            return false;
+        const trace = this.fromEntity(entity1, entity2Obj, options);
+        return trace !== null && (trace.fraction >= 1.0 || trace.hitEntity === entity2);
+    }
+    // Trace downward to find ground
+    findGround(origin, distance = 4096) {
+        const start = [...origin];
+        const end = [origin[0], origin[1], origin[2] - distance];
+        return this.line(start, end, { flags: 1 /* nodemod.IGNORE.MONSTERS */ });
+    }
+    // Trace sphere/hull
+    sphere(start, end, radius, options = {}) {
+        // traceSphere requires Entity, not Entity | null, so provide a fallback
+        const ignoreEntity = options.ignore || nodemod.eng.pEntityOfEntIndex(0); // Use world entity as fallback
+        const result = nodemod.eng.traceSphere(start, end, options.flags || 0, radius, ignoreEntity);
+        return this.enhanceTraceResult(result, start, end);
+    }
+    // Trace with monster hull
+    monsterHull(entity, start, end, options = {}) {
+        // traceMonsterHull requires Entity, not Entity | null
+        const ignoreEntity = options.ignore || nodemod.eng.pEntityOfEntIndex(0); // Use world entity as fallback
+        return nodemod.eng.traceMonsterHull(entity, start, end, options.flags || 0, ignoreEntity);
+    }
+    // Trace for texture information
+    texture(entity, start, end) {
+        return nodemod.eng.traceTexture(entity, start, end);
+    }
+    // Trace projectile path
+    projectile(entity, ignore = null) {
+        const result = nodemod.eng.traceToss(entity, ignore || entity);
+        return this.enhanceTraceResult(result);
+    }
+    /**
+     * Analyzes the contents of a specific point in 3D space.
+     * Useful for checking if a position is in water, solid matter, or empty space.
+     *
+     * @param point - 3D coordinates [x, y, z] to check
+     * @returns Detailed information about what exists at that point
+     *
+     * @example
+     * ```typescript
+     * // Check if a position is safe for teleporting
+     * const contents = nodemodCore.trace.pointContents([100, 200, 300]);
+     * if (contents.isEmpty) {
+     *   console.log('Safe to teleport');
+     * } else if (contents.isWater) {
+     *   console.log('Position is underwater');
+     * } else if (contents.isSolid) {
+     *   console.log('Position is inside a wall');
+     * }
+     *
+     * // Check multiple points
+     * const positions = [[0,0,0], [100,100,100], [200,200,200]];
+     * positions.forEach((pos, i) => {
+     *   const result = nodemodCore.trace.pointContents(pos);
+     *   console.log(`Point ${i}: ${result.isEmpty ? 'empty' : 'occupied'}`);
+     * });
+     * ```
+     */
+    pointContents(point) {
+        const contents = nodemod.eng.pointContents(point);
+        return {
+            contents,
+            isEmpty: contents === -1 /* nodemod.CONTENTS.EMPTY */,
+            isSolid: contents === -2 /* nodemod.CONTENTS.SOLID */,
+            isWater: contents === -3 /* nodemod.CONTENTS.WATER */,
+            isSlime: contents === -4 /* nodemod.CONTENTS.SLIME */,
+            isLava: contents === -5 /* nodemod.CONTENTS.LAVA */,
+            isSky: contents === -6 /* nodemod.CONTENTS.SKY */
+        };
+    }
+    // Enhanced trace result with utility methods
+    enhanceTraceResult(result, start = null, end = null) {
+        if (!result)
+            return null;
+        const distance = start && end ? (() => {
+            const dx = end[0] - start[0];
+            const dy = end[1] - start[1];
+            const dz = end[2] - start[2];
+            const totalDistance = Math.sqrt(dx * dx + dy * dy + dz * dz);
+            return totalDistance * result.fraction;
+        })() : result.fraction;
+        const hitPoint = start && end ? [
+            start[0] + (end[0] - start[0]) * result.fraction,
+            start[1] + (end[1] - start[1]) * result.fraction,
+            start[2] + (end[2] - start[2]) * result.fraction
+        ] : result.endPos;
+        return {
+            ...result,
+            distance,
+            hitPoint,
+            didHit: result.fraction < 1.0,
+            hitSky: result.inOpen,
+            hitWater: result.inWater,
+            hitEntity: result.hit,
+            hitSurface: result.fraction < 1.0 && !!result.planeNormal
+        };
+    }
+    // Batch tracing utilities
+    // Trace multiple lines at once
+    multiLine(traces) {
+        return traces.map((trace) => {
+            if (Array.isArray(trace)) {
+                return this.line(trace[0], trace[1], trace[2] || {});
+            }
+            return this.line(trace.start, trace.end, trace.options || {});
+        });
+    }
+    // Find closest surface in direction
+    findClosestSurface(origin, direction, maxDistance = 4096) {
+        const normalized = this.normalizeVector(direction);
+        const end = [
+            origin[0] + normalized[0] * maxDistance,
+            origin[1] + normalized[1] * maxDistance,
+            origin[2] + normalized[2] * maxDistance
+        ];
+        return this.line(origin, end);
+    }
+    // Trace in all cardinal directions
+    traceCardinal(origin, distance = 512) {
+        const directions = [
+            [1, 0, 0], // East
+            [-1, 0, 0], // West  
+            [0, 1, 0], // North
+            [0, -1, 0], // South
+            [0, 0, 1], // Up
+            [0, 0, -1] // Down
+        ];
+        const results = {};
+        const labels = ['east', 'west', 'north', 'south', 'up', 'down'];
+        directions.forEach((dir, i) => {
+            const end = [
+                origin[0] + dir[0] * distance,
+                origin[1] + dir[1] * distance,
+                origin[2] + dir[2] * distance
+            ];
+            results[labels[i]] = this.line(origin, end);
+        });
+        return results;
+    }
+    /**
+     * Checks if a rectangular area is clear of obstacles by testing all corners.
+     * Useful for verifying if there's enough space to place objects or teleport players.
+     *
+     * @param center - Center point of the area [x, y, z]
+     * @param size - Dimensions of the area [width, length, height] (default: [64, 64, 64])
+     * @returns True if the entire area is clear, false if any part is blocked
+     *
+     * @example
+     * ```typescript
+     * // Check if there's space for a player
+     * const playerSize = [32, 32, 72]; // Typical player dimensions
+     * const isClear = nodemodCore.trace.isAreaClear([100, 200, 300], playerSize);
+     * if (isClear) {
+     *   console.log('Safe to spawn player here');
+     * }
+     *
+     * // Check default 64x64x64 area
+     * const canPlaceItem = nodemodCore.trace.isAreaClear([50, 50, 50]);
+     * ```
+     */
+    isAreaClear(center, size = [64, 64, 64]) {
+        const halfSize = [size[0] / 2, size[1] / 2, size[2] / 2];
+        const corners = [
+            [center[0] - halfSize[0], center[1] - halfSize[1], center[2] - halfSize[2]],
+            [center[0] + halfSize[0], center[1] - halfSize[1], center[2] - halfSize[2]],
+            [center[0] - halfSize[0], center[1] + halfSize[1], center[2] - halfSize[2]],
+            [center[0] + halfSize[0], center[1] + halfSize[1], center[2] - halfSize[2]],
+            [center[0] - halfSize[0], center[1] - halfSize[1], center[2] + halfSize[2]],
+            [center[0] + halfSize[0], center[1] - halfSize[1], center[2] + halfSize[2]],
+            [center[0] - halfSize[0], center[1] + halfSize[1], center[2] + halfSize[2]],
+            [center[0] + halfSize[0], center[1] + halfSize[1], center[2] + halfSize[2]]
+        ];
+        return corners.every(corner => {
+            const contents = this.pointContents(corner);
+            return contents.isEmpty;
+        });
+    }
+    // Vector utilities
+    normalizeVector(vector) {
+        const length = Math.sqrt(vector[0] * vector[0] + vector[1] * vector[1] + vector[2] * vector[2]);
+        if (length === 0)
+            return [0, 0, 0];
+        return [vector[0] / length, vector[1] / length, vector[2] / length];
+    }
+    vectorLength(vector) {
+        return Math.sqrt(vector[0] * vector[0] + vector[1] * vector[1] + vector[2] * vector[2]);
+    }
+    vectorDistance(v1, v2) {
+        const dx = v2[0] - v1[0];
+        const dy = v2[1] - v1[1];
+        const dz = v2[2] - v1[2];
+        return Math.sqrt(dx * dx + dy * dy + dz * dz);
+    }
+}
+exports.default = NodemodTrace;
+//# sourceMappingURL=trace.js.map

package/dist/enhanced/trace.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,88 @@
+/// <reference path="./types/index.d.ts" />
+import NodemodCmd from './core/cmd';
+import NodemodMenu from './core/menu';
+import NodemodMsg from './core/msg';
+import NodemodResource from './core/resource';
+import NodemodSound from './core/sound';
+import NodemodCVar from './native/cvar';
+import NodemodFile from './native/file';
+import NodemodEvents from './enhanced/events';
+import NodemodPlayer from './enhanced/player';
+import NodemodEntity from './enhanced/entity';
+import NodemodTrace from './enhanced/trace';
+import NodemodUtil from './utils/util';
+/**
+ * Main NodeMod Core class providing unified access to all NodeMod services
+ *
+ * This class serves as the central hub for all NodeMod functionality, providing
+ * easy access to various services including messaging, entity management,
+ * player utilities, and Half-Life engine interactions.
+ *
+ * @example
+ * ```typescript
+ * // Access the global nodemodCore instance
+ * nodemodCore.util.messageAll("Hello world!");
+ * nodemodCore.player.getAll().forEach(player => {
+ *   console.log(`Player: ${player.name}`);
+ * });
+ * ```
+ */
+declare class NodemodCore {
+    /** Console variable management service */
+    readonly cvar: NodemodCVar;
+    /** File system operations service */
+    readonly file: NodemodFile;
+    /** Network messaging service */
+    readonly msg: NodemodMsg;
+    /** General utility functions */
+    readonly util: NodemodUtil;
+    /** Sound management service */
+    readonly sound: NodemodSound;
+    /** Command registration and handling service */
+    readonly cmd: NodemodCmd;
+    /** Resource management service */
+    readonly resource: NodemodResource;
+    /** Menu creation and display service */
+    readonly menu: NodemodMenu;
+    /** Event handling service */
+    readonly events: NodemodEvents;
+    /** Player management and utilities */
+    readonly player: NodemodPlayer;
+    /** Entity management and utilities */
+    readonly entity: NodemodEntity;
+    /** Trace and collision detection service */
+    readonly trace: NodemodTrace;
+    /** Current working directory of the game server */
+    get cwd(): string;
+    /** Current map name */
+    get mapname(): string;
+    /** Current server time */
+    get time(): number;
+    /** Array of all connected player entities */
+    get players(): nodemod.Entity[];
+    /**
+     * Get the message ID for a user message name
+     * @param msgName The name of the user message
+     * @returns The message ID
+     */
+    getUserMsgId(msgName: string): number;
+    /**
+     * Get the message name for a user message ID
+     * @param msgId The message ID
+     * @returns The message name
+     */
+    getUserMsgName(msgId: number): string;
+    /**
+     * Set the metamod result for the current hook
+     * @param result The metamod result constant
+     */
+    setMetaResult(result: nodemod.META_RES): void;
+    /**
+     * Continue server execution (used with metamod hooks)
+     */
+    continueServer(): void;
+    constructor();
+}
+declare const nodemodCore: NodemodCore;
+export default nodemodCore;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,WAAW,MAAM,aAAa,CAAC;AACtC,OAAO,UAAU,MAAM,YAAY,CAAC;AACpC,OAAO,eAAe,MAAM,iBAAiB,CAAC;AAC9C,OAAO,YAAY,MAAM,cAAc,CAAC;AAGxC,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,WAAW,MAAM,eAAe,CAAC;AAGxC,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,aAAa,MAAM,mBAAmB,CAAC;AAC9C,OAAO,YAAY,MAAM,kBAAkB,CAAC;AAG5C,OAAO,WAAW,MAAM,cAAc,CAAC;AAEvC;;;;;;;;;;;;;;;GAeG;AACH,cAAM,WAAW;IACf,0CAA0C;IAC1C,SAAgB,IAAI,EAAE,WAAW,CAAC;IAElC,qCAAqC;IACrC,SAAgB,IAAI,EAAE,WAAW,CAAC;IAElC,gCAAgC;IAChC,SAAgB,GAAG,EAAE,UAAU,CAAC;IAEhC,gCAAgC;IAChC,SAAgB,IAAI,EAAE,WAAW,CAAC;IAElC,+BAA+B;IAC/B,SAAgB,KAAK,EAAE,YAAY,CAAC;IAEpC,gDAAgD;IAChD,SAAgB,GAAG,EAAE,UAAU,CAAC;IAEhC,kCAAkC;IAClC,SAAgB,QAAQ,EAAE,eAAe,CAAC;IAE1C,wCAAwC;IACxC,SAAgB,IAAI,EAAE,WAAW,CAAC;IAElC,6BAA6B;IAC7B,SAAgB,MAAM,EAAE,aAAa,CAAC;IAEtC,sCAAsC;IACtC,SAAgB,MAAM,EAAE,aAAa,CAAC;IAEtC,sCAAsC;IACtC,SAAgB,MAAM,EAAE,aAAa,CAAC;IAEtC,4CAA4C;IAC5C,SAAgB,KAAK,EAAE,YAAY,CAAC;IAIpC,mDAAmD;IACnD,IAAI,GAAG,IAAI,MAAM,CAAwB;IAEzC,uBAAuB;IACvB,IAAI,OAAO,IAAI,MAAM,CAA4B;IAEjD,0BAA0B;IAC1B,IAAI,IAAI,IAAI,MAAM,CAAyB;IAE3C,6CAA6C;IAC7C,IAAI,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE,CAA4B;IAI3D;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAErC;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAErC;;;OAGG;IACH,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,GAAG,IAAI;IAE7C;;OAEG;IACH,cAAc,IAAI,IAAI;;CA0BvB;AAED,QAAA,MAAM,WAAW,aAAoB,CAAC;AAGtC,eAAe,WAAW,CAAC"}