@remotex-labs/xmap 1.1.0 → 2.0.1

package/dist/esm/providers/mapping.provider.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Import will remove at compile time
+ */
+import { Bias, type MapType, type SegmentInterface } from './interfaces/mapping.interface';
+/**
+ * The `MappingProvider` class provides methods to encode and decode mappings
+ * from a source map or mapping string to an internal structured representation.
+ */
+export declare class MappingProvider {
+    /**
+     * The internal mapping representation, where each index represents a frame of segments.
+     */
+    private mapping;
+    /**
+     * Constructor to initialize the `MappingProvider` with a mapping.
+     * Can be initialized with either a mapping string or a structured mapping array.
+     *
+     * @param mapping - The mapping data, either as a string or structured array.
+     * @param namesOffset - Optional offset for the names index.
+     * @param sourceOffset - Optional offset for the sources index.
+     *
+     * @example
+     * ```ts
+     * const provider = new MappingProvider(";;;AAiBO,SAAS,OAAO;AACnB,UAAQ,IAAI,MAAM;AACtB;;;ACjBA,QAAQ,IAAI,GAAG;AACf,KAAK;", 0, 0);
+     * const provider2 = new MappingProvider([
+     *   null,
+     *   [
+     *     {
+     *       line: 1,
+     *       column: 1,
+     *       nameIndex: null,
+     *       sourceIndex: 0,
+     *       generatedLine: 2,
+     *       generatedColumn: 1
+     *     }
+     *   ],
+     *   null
+     * ], 0, 0);
+     * ```
+     */
+    constructor(mapping: string, namesOffset?: number, sourceOffset?: number);
+    constructor(mapping: MapType, namesOffset?: number, sourceOffset?: number);
+    constructor(mapping: MappingProvider, namesOffset?: number, sourceOffset?: number);
+    /**
+     * Encodes the internal mapping array back into a mapping string.
+     *
+     * @returns {string} - The encoded mapping string.
+     * @example
+     * ```ts
+     * const encoded = provider.encode();
+     * console.log(encoded); // Outputs encoded mapping string
+     * ```
+     */
+    encode(): string;
+    /**
+     * Decodes a mapping from either a string or structured array into the internal mapping.
+     *
+     * @param mapping - The mapping data to decode.
+     * @param namesOffset - Offset for the names index.
+     * @param sourcesOffset - Offset for the sources index.
+     * @example
+     * ```ts
+     * provider.decode(";;;AAiBO,SAAS,OAAO;AACnB,UAAQ,IAAI,MAAM;AACtB;;;ACjBA,QAAQ,IAAI,GAAG;AACf,KAAK;", 0, 0);
+     * provider.decode([
+     *   null,
+     *   [
+     *     {
+     *       line: 1,
+     *       column: 1,
+     *       nameIndex: null,
+     *       sourceIndex: 0,
+     *       generatedLine: 2,
+     *       generatedColumn: 1
+     *     }
+     *   ],
+     *   null
+     * ], 0, 0);
+     * ```
+     */
+    decode(mapping: MappingProvider | MapType | string, namesOffset?: number, sourcesOffset?: number): void;
+    /**
+     * Retrieves a segment based on the provided generated line and column,
+     * applying the specified bias when the exact match is not found.
+     *
+     * This method performs a binary search on the segments of the specified
+     * generated line to efficiently locate the segment corresponding to
+     * the provided generated column. If an exact match is not found,
+     * the method returns the closest segment based on the specified bias:
+     * - `Bias.BOUND`: No preference for column matching (returns the closest segment).
+     * - `Bias.LOWER_BOUND`: Prefers the closest mapping with a lower column value.
+     * - `Bias.UPPER_BOUND`: Prefers the closest mapping with a higher column value.
+     *
+     * @param generatedLine - The line number of the generated code (1-based index).
+     * @param generatedColumn - The column number of the generated code (0-based index).
+     * @param bias - The bias to use when the line matches, can be one of:
+     *   - `Bias.BOUND` (default): No preference for column matching.
+     *   - `Bias.LOWER_BOUND`: Prefer the closest mapping with a lower column value.
+     *   - `Bias.UPPER_BOUND`: Prefer the closest mapping with a higher column value.
+     * @returns The matching segment if found;
+     * returns null if no segments exist for the specified generated line
+     * or if the generated line is out of bounds.
+     *
+     * @throws { Error } - Throws an error if the generated line is invalid
+     * (out of bounds).
+     *
+     * @example
+     * ```ts
+     * const segment = sourceMap.getSegment(5, 10, Bias.UPPER_BOUND);
+     * if (segment) {
+     *     console.log(`Found segment: line ${segment.line}, column ${segment.column}`);
+     * } else {
+     *     console.log('No matching segment found.');
+     * }
+     * ```
+     */
+    getSegment(generatedLine: number, generatedColumn: number, bias?: Bias): SegmentInterface | null;
+    /**
+     * Retrieves the original segment based on the provided line, column, and source index.
+     *
+     * This method searches for the original segment that corresponds to the specified
+     * line, column, and source index. It uses binary search to find the closest segment
+     * based on the provided bias.
+     *
+     * @param line - The line number of the original code (1-based index).
+     * @param column - The column number of the original code (0-based index).
+     * @param sourceIndex - The index of the source file in the source map.
+     * @param bias - The bias to apply when multiple segments match; defaults to `Bias.BOUND`.
+     * @returns {SegmentInterface | null} - The matching original segment if found;
+     * returns null if no segments exist for the specified line and source index.
+     *
+     * @example
+     * ```ts
+     * const originalSegment = sourceMap.getOriginalSegment(3, 5, 0, Bias.LOWER_BOUND);
+     * if (originalSegment) {
+     *     console.log(`Found original segment: line ${originalSegment.line}, column ${originalSegment.column}`);
+     * } else {
+     *     console.log('No matching original segment found.');
+     * }
+     * ```
+     */
+    getOriginalSegment(line: number, column: number, sourceIndex: number, bias?: Bias): SegmentInterface | null;
+    /**
+     * Initializes the segment offsets used to track the current decoding position.
+     *
+     * @param namesOffset - The offset for the names index.
+     * @param sourceIndex - The offset for the source index.
+     * @returns { SegmentOffsetInterface } - The initialized segment offset.
+     */
+    private initPositionOffsets;
+    /**
+     * Validates the format of an encoded mapping string.
+     *
+     * @param encodedSourceMap - The encoded source map string to validate.
+     * @returns Returns `true` if the format is valid, otherwise `false`.
+     */
+    private validateMappingString;
+    /**
+     * Validates the properties of a segment to ensure they conform to expected types.
+     *
+     * This method checks that the segment's properties are finite numbers and that
+     * the nameIndex, if provided, is either a finite number or null.
+     * An error is thrown if any of the properties do not meet the specified criteria.
+     *
+     * @param segment - The segment object to validate, which must conform to the
+     *                  SegmentInterface structure, including:
+     *                  - line: number (finite)
+     *                  - column: number (finite)
+     *                  - nameIndex: number | null (if not null, must be finite)
+     *                  - sourceIndex: number (finite)
+     *                  - generatedLine: number (finite)
+     *                  - generatedColumn: number (finite)
+     *
+     * @throws {Error} - Throws an error if any property of the segment is invalid.
+     *                   The error message will specify which property is invalid
+     *                   and the value that was received.
+     */
+    private validateSegment;
+    /**
+     * Encodes a segment into a VLQ-encoded string based on the segment offsets.
+     *
+     * @param segmentOffset - The current segment offset.
+     * @param segmentObject - The segment to encode.
+     * @returns The encoded segment string.
+     */
+    private encodeSegment;
+    /**
+     * Encodes the entire mapping array into a VLQ-encoded mapping string.
+     *
+     * @param map - The mapping array to encode.
+     * @returns The encoded mapping string.
+     */
+    private encodeMappings;
+    /**
+     * Decodes a VLQ-encoded segment into a segment object based on the current offset.
+     *
+     * @param segmentOffset - The current segment offset.
+     * @param decodedSegment - The decoded VLQ segment values.
+     * @returns The decoded segment object.
+     */
+    private decodedSegment;
+    /**
+     * Decodes a VLQ-encoded mapping string into the internal mapping representation.
+     *
+     * @param encodedMap - The VLQ-encoded mapping string.
+     * @param namesOffset - Offset for the names index.
+     * @param sourceOffset - Offset for the sources index.
+     * @throws { Error } - Throws an error if the mapping string is invalid.
+     */
+    private decodeMappingString;
+    /**
+     * Decodes a mapping array into the internal mapping representation, adjusting for offsets.
+     *
+     * This method processes each frame in the provided structured mapping array,
+     * validating each segment within the frame and adjusting the indices based on the
+     * specified offsets for names and sources. If a frame is invalid or not an array,
+     * an error will be thrown.
+     *
+     * @param encodedMap - The structured mapping array, which should be an array of frames,
+     *                     where each frame is an array of segments. Each segment must conform
+     *                     to the SegmentInterface.
+     * @param namesOffset - Offset for the names index, which will be added to each segment's nameIndex.
+     * @param sourceOffset - Offset for the sources index, which will be added to each segment's sourceIndex.
+     * @throws { Error } - Throws an error if:
+     *                   - The mapping array is invalid (not an array).
+     *                   - Any frame is not an array.
+     *                   - Any segment does not conform to the SegmentInterface.
+     */
+    private decodeMappingArray;
+}

package/dist/esm/services/interfaces/source.interface.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Represents a source map structure used for mapping code within a file
+ * to its original source. Source maps are essential for debugging minified
+ * or transpiled code, as they allow developers to trace back to the
+ * original source files and understand the context of the code execution.
+ *
+ * @interface SourceMapInterface
+ * @property file - The generated file's name that the source map is associated with.
+ * This property is optional and may be null if not specified.
+ * @property names - An array of variable/function names that are present in the original source.
+ * These names help in mapping the original code context during debugging.
+ * @property version - The version of the source map specification.
+ * This should be set to `3` for the standard source map version.
+ * @property sources - An array of URLs or paths to the original source files.
+ * These sources are used to locate the original code that corresponds to the generated code.
+ * @property mappings - A VLQ (Variable-Length Quantity) encoded string that describes how to map the
+ * generated code back to the original source code. This property is crucial for the correct functioning of the source map.
+ * @property sourceRoot - An optional root URL for the sources.
+ * It can be used to specify a base path for resolving the sources, which may be null if not applicable.
+ * @property sourcesContent - An optional array containing the content of the original source files.
+ * This property can be useful when the original files are not available at runtime.
+ */
+export interface SourceMapInterface {
+    file?: string | null;
+    names: Array<string>;
+    version: number;
+    sources: Array<string>;
+    mappings: string;
+    sourceRoot?: string | null;
+    sourcesContent?: Array<string>;
+}
+export interface PositionInterface {
+    name: string | null;
+    line: number;
+    column: number;
+    source: string;
+    sourceRoot: string | null;
+    sourceIndex: number;
+    generatedLine: number;
+    generatedColumn: number;
+}
+export interface PositionWithContentInterface extends PositionInterface {
+    sourcesContent: string;
+}
+export interface PositionWithCodeInterface extends PositionInterface {
+    code: string;
+    endLine: number;
+    startLine: number;
+}
+export interface SourceOptionsInterface {
+    linesAfter?: number;
+    linesBefore?: number;
+}

package/dist/esm/services/source.service.d.ts

@@ -0,0 +1,217 @@
+/**
+ * Import will remove at compile time
+ */
+import type { PositionInterface, SourceMapInterface, SourceOptionsInterface, PositionWithCodeInterface, PositionWithContentInterface } from "./interfaces/source.interface";
+/**
+ * Imports
+ */
+import { MappingProvider } from "../providers/mapping.provider";
+import { Bias } from "../providers/interfaces/mapping.interface";
+/**
+ * A service for validating and processing source maps.
+ * This class allows parsing and manipulation of source maps, providing functionality such as
+ * retrieving position mappings between original and generated code, concatenating source maps,
+ * and getting code snippets based on mappings.
+ *
+ * @example
+ * ```ts
+ * const sourceMapJSON = '{"version": 3, "file": "bundle.js", "sources": ["foo.ts"], "names": [], "mappings": "AAAA"}';
+ * const sourceService = new SourceService(sourceMapJSON);
+ *
+ * console.log(sourceService.file); // Outputs: 'bundle.js'
+ * ```
+ */
+export declare class SourceService {
+    /**
+     * The name of the generated file (bundle) that this source map applies to.
+     *
+     * @example
+     * ```ts
+     * console.log(sourceService.file); // 'bundle.js'
+     * ```
+     */
+    readonly file: string | null;
+    /**
+     * A MappingProvider instance of base64 VLQ-encoded mappings.
+     */
+    readonly mappings: MappingProvider;
+    /**
+     * The root URL for the sources, if present in the source map.
+     */
+    readonly sourceRoot: string | null;
+    /**
+     * A list of symbol names used by the “mappings” entry.
+     */
+    readonly names: Array<string>;
+    /**
+     * An array of source file paths.
+     */
+    readonly sources: Array<string>;
+    /**
+     * An array of source files contents.
+     */
+    readonly sourcesContent: Array<string>;
+    /**
+     * Creates a new instance of the `SourceService` class.
+     *
+     * This constructor initializes the class using either a `SourceMapInterface` object,
+     * a JSON string representing the source map, or an existing `SourceService` instance.
+     * It validates the source map and populates its properties such as `file`, `sources`, and `mappings`.
+     *
+     * @param source - Can be one of the following:
+     *   - An object conforming to the `SourceMapInterface`.
+     *   - A JSON string representing the source map.
+     *   - A `SourceService` instance to copy the properties.
+     * @param file - (Optional) A string representing the file name of the generated bundle.
+     *               Defaults to `null`. It will overwrite any existing `file` property in the source map.
+     * @throws {Error} - If the source map does not contain required properties or has an invalid format.
+     *
+     * @example
+     * ```ts
+     * const sourceMapJSON = '{"version": 3, "file": "bundle.js", "sources": ["foo.ts"], "names": [], "mappings": "AAAA"}';
+     * const sourceService = new SourceService(sourceMapJSON);
+     * ```
+     */
+    constructor(source: SourceService);
+    constructor(source: SourceMapInterface | string, file?: string | null);
+    /**
+     * Converts the current source map data into a plain object format.
+     *
+     * @returns The source map json object.
+     *
+     * @example
+     * ```ts
+     * const mapObject = sourceService.getMapObject();
+     * console.log(mapObject.file); // 'bundle.js'
+     * ```
+     */
+    getMapObject(): SourceMapInterface;
+    /**
+     * Concatenates one or more source maps to the current source map.
+     *
+     * This method merges additional source maps into the current source map,
+     * updating the `mappings`, `names`, `sources`, and `sourcesContent` arrays.
+     *
+     * @param maps - An array of `SourceMapInterface` or `SourceService` instances to be concatenated.
+     * @throws { Error } If no source maps are provided for concatenation.
+     *
+     * @example
+     * ```ts
+     * sourceService.concat(anotherSourceMap);
+     * console.log(sourceService.sources); // Updated source paths
+     * ```
+     */
+    concat(...maps: Array<SourceMapInterface | SourceService>): void;
+    /**
+     * Creates a new instance of `SourceService` with concatenated source maps.
+     *
+     * @param maps - An array of `SourceMapInterface` or `SourceService` instances to be concatenated.
+     * @returns { SourceService } A new `SourceService` instance with the concatenated maps.
+     * @throws { Error } If no source maps are provided.
+     *
+     * @example
+     * ```ts
+     * const newService = sourceService.concatNewMap(anotherSourceMap);
+     * console.log(newService.file); // The file from the new source map
+     * ```
+     */
+    concatNewMap(...maps: Array<SourceMapInterface | SourceService>): SourceService;
+    /**
+     * Retrieves the position information based on the original source line and column.
+     *
+     * @param line - The line number in the generated code.
+     * @param column - The column number in the generated code.
+     * @param sourceIndex - The index or file path of the original source.
+     * @param bias - The bias to use when matching positions (`Bias.LOWER_BOUND`, `Bias.UPPER_BOUND`, or `Bias.BOUND`).
+     * @returns { PositionInterface | null } The corresponding position in the original source, or `null` if not found.
+     *
+     * @example
+     * ```ts
+     * const position = sourceService.getPositionByOriginal(1, 10, 'foo.ts');
+     * console.log(position?.line); // The line number in the original source
+     * ```
+     */
+    getPositionByOriginal(line: number, column: number, sourceIndex: number | string, bias?: Bias): PositionInterface | null;
+    /**
+     * Retrieves the position in the original source code based on a given line and column
+     * in the generated code.
+     *
+     * @param line - Line number in the generated code.
+     * @param column - Column number in the generated code.
+     * @param bias - The bias to use for matching positions. Defaults to `Bias.BOUND`.
+     * @returns {PositionInterface | null} The position in the original source, or null if not found.
+     *
+     * @example
+     * ```ts
+     * const position = sourceService.getPosition(2, 15);
+     * console.log(position?.source); // The original source file
+     * ```
+     */
+    getPosition(line: number, column: number, bias?: Bias): PositionInterface | null;
+    /**
+     * Retrieves the position and original source content for a given position in the generated code.
+     *
+     * @param line - Line number in the generated code.
+     * @param column - Column number in the generated code.
+     * @param bias - Bias used for position matching.
+     * @returns { PositionWithContentInterface | null } The position and its associated content, or `null` if not found.
+     *
+     * @example
+     * ```ts
+     * const positionWithContent = sourceService.getPositionWithContent(3, 5);
+     * console.log(positionWithContent?.sourcesContent); // The source code content
+     * ```
+     */
+    getPositionWithContent(line: number, column: number, bias?: Bias): PositionWithContentInterface | null;
+    /**
+     * Retrieves the position and a code snippet from the original source based on the given
+     * generated code position, with additional lines of code around the matching line.
+     *
+     * @param line - Line number in the generated code.
+     * @param column - Column number in the generated code.
+     * @param bias - Bias used for position matching.
+     * @param options - (Optional) Extra options for the amount of surrounding lines to include.
+     * @returns { PositionWithCodeInterface | null } The position and code snippet.
+     *
+     * @example
+     * ```ts
+     * const positionWithCode = sourceService.getPositionWithCode(4, 8, Bias.BOUND, { linesBefore: 2, linesAfter: 2 });
+     * console.log(positionWithCode?.code); // The code snippet from the original source
+     * ```
+     */
+    getPositionWithCode(line: number, column: number, bias?: Bias, options?: SourceOptionsInterface): PositionWithCodeInterface | null;
+    /**
+     * Converts the current source map object to a JSON string.
+     *
+     * @returns A stringified version of the source map object.
+     *
+     * @example
+     * ```ts
+     * console.log(sourceService.toString()); // JSON string of the source map
+     * ```
+     */
+    toString(): string;
+    /**
+     * Validates the provided source map object.
+     *
+     * This method checks whether all required keys are present in the source map object.
+     * It throws an error if any required keys are missing.
+     *
+     * @private
+     * @param input - The source map object to be validated.
+     * @throws Error If any required key is missing from the source map.
+     *
+     * @example
+     * ```ts
+     * const sourceMap = {
+     *     version: 3,
+     *     file: 'example.js',
+     *     names: ['src', 'maps', 'example', 'function', 'line', 'column'],
+     *     sources: ['source1.js', 'source2.js'],
+     *     mappings: 'AAAA,SAASA,CAAC,CAAC,CAAC;AAAA,CAAC,CAAC;AAAC,CAAC',
+     * };
+     * sourceService['validateSource'](sourceMap); // Throws if invalid
+     * ```
+     */
+    private validateSourceMap;
+}

package/package.json

@@ -1,9 +1,11 @@
 {
     "name": "@remotex-labs/xmap",
-    "main": "dist/index.js",
-    "types": "dist/index.d.ts",
+    "main": "dist/cjs/index.js",
+    "type": "module",
+    "types": "./dist/cjs/index.d.ts",
+    "module": "./dist/esm/index.js",
     "author": "Garefild",
-    "version": "1.1.0",
+    "version": "2.0.1",
     "license": "Mozilla Public License Version 2.0",
     "description": "A library with a sourcemap parser and TypeScript code formatter for the CLI",
     "homepage": "https://github.com/remotex-lab/xMap",
@@ -32,6 +34,19 @@
     "engines": {
         "node": ">=18"
     },
+    "exports": {
+        "./package.json": "./package.json",
+        ".": {
+            "import": {
+                "types": "./dist/esm/index.d.ts",
+                "default": "./dist/esm/index.js"
+            },
+            "require": {
+                "types": "./dist/cjs/index.d.ts",
+                "default": "./dist/cjs/index.js"
+            }
+        }
+    },
     "files": [
         "dist",
         "LICENSE",
@@ -40,7 +55,7 @@
     "scripts": {
         "dev": "xBuild -w",
         "test": "jest",
-        "build": "xBuild",
+        "build": "xBuild && xbuild -c xbuild.cjs.ts",
         "test:coverage": "jest --coverage",
         "lint": "xbuild --tc && eslint . -c ./eslint.config.mjs",
         "ci:test": "jest",
@@ -49,15 +64,15 @@
     },
     "devDependencies": {
         "jest": "^29.7.0",
-        "eslint": "^9.11.1",
-        "typescript-eslint": "^8.7.0",
-        "eslint-plugin-jsdoc": "^50.3.0",
+        "eslint": "^9.12.0",
+        "typescript-eslint": "^8.9.0",
+        "eslint-plugin-jsdoc": "^50.4.1",
         "@swc/jest": "^0.2.36",
         "@types/jest": "^29.5.13",
-        "@types/node": "^22.7.4",
+        "@types/node": "^22.7.5",
         "@remotex-labs/xbuild": "^1.2.0"
     },
     "dependencies": {
-        "typescript": "^5.6.2"
+        "typescript": "^5.6.3"
     }
 }

package/dist/index.js

@@ -1,9 +0,0 @@
-"use strict";var P=Object.create;var f=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var k=Object.getOwnPropertyNames;var B=Object.getPrototypeOf,$=Object.prototype.hasOwnProperty;var D=(i,e)=>{for(var n in e)f(i,n,{get:e[n],enumerable:!0})},b=(i,e,n,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let r of k(e))!$.call(i,r)&&r!==n&&f(i,r,{get:()=>e[r],enumerable:!(t=R(e,r))||t.enumerable});return i};var U=(i,e,n)=>(n=i!=null?P(B(i)):{},b(e||!i||!i.__esModule?f(n,"default",{value:i,enumerable:!0}):n,i)),_=i=>b(f({},"__esModule",{value:!0}),i);var V={};D(V,{CodeHighlighter:()=>S,Colors:()=>O,SourceService:()=>y,decodeVLQ:()=>I,encodeArrayVLQ:()=>x,encodeVLQ:()=>N,formatCode:()=>E,formatErrorCode:()=>j,highlightCode:()=>W,parseErrorStack:()=>F});module.exports=_(V);function F(i){let e=i.split(`
-`).slice(1),n=/^\s*at\s+(.*?)\s+\((.*?):(\d+):(\d+)\)$|^\s*at\s+(.*?):(\d+):(\d+)$/,t=/eval\s+at\s+([^\s(]+).+\((.+):(\d+):(\d+)\),\s(.+)/,r=[];return e.forEach(s=>{let a=s.match(n);if(!a)return;let c=a.slice(1);a[2]||(c=a.slice(4));let[l,d,m,g]=c,p=parseInt(m,10),u=parseInt(g,10);if(s.includes("eval")){let C=d.match(t)?.slice(1);if(C){let[M,A,K,T,w]=C;r.push({at:l,file:w,line:p,column:u,executor:{at:M,file:A,line:parseInt(K,10),column:parseInt(T,10)}});return}}r.push({at:l||"<anonymous>",file:d,line:p,column:u,executor:null})}),r}var v={},L="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".split("");L.forEach((i,e)=>{v[i]=e});function N(i){let e=i<0,n="",t=e?(-i<<1)+1:i<<1;do{let r=t&31;t>>>=5,n+=L[r|(t>0?32:0)]}while(t>0);return n}function x(i){return i.map(N).join("")}function I(i){let e=[],n=0,t=0;for(let r=0;r<i.length;r++){let s=v[i[r]];if(s===void 0)throw new Error(`Invalid Base64 character: ${i[r]}`);let a=s&32;if(t+=(s&31)<<n,a)n+=5;else{let c=(t&1)===1,l=t>>1;e.push(c?-l:l),t=n=0}}return e}function E(i,e={}){let n=i.split(`
-`),t=e.padding??10,r=e.startLine??0;return n.map((s,a)=>{let c=a+r+1,d=`${`${c} | `.padStart(t)}${s}`;return e.action&&c===e.action.triggerLine?e.action.callback(d,t,c):d}).join(`
-`)}function j(i,e){let{code:n,line:t,column:r,startLine:s}=i;if(t<s||r<1)throw new Error("Invalid line or column number.");return E(n,{startLine:s,action:{triggerLine:t,callback:(a,c,l)=>{let d="^",m=c-1,g=">";e&&(d=`${e.color}${d}${e.reset}`,m+=e.color.length+e.reset.length,g=`${e.color}>${e.reset}`);let p=" | ".padStart(c)+" ".repeat(r-1)+`${d}`;return a=`${g} ${l} |`.padStart(m)+a.split("|")[1],a+`
-${p}`}}})}var o=U(require("typescript")),h=require("typescript"),O=(u=>(u.reset="\x1B[0m",u.gray="\x1B[38;5;243m",u.darkGray="\x1B[38;5;238m",u.lightCoral="\x1B[38;5;203m",u.lightOrange="\x1B[38;5;215m",u.oliveGreen="\x1B[38;5;149m",u.burntOrange="\x1B[38;5;208m",u.lightGoldenrodYellow="\x1B[38;5;221m",u.lightYellow="\x1B[38;5;230m",u.canaryYellow="\x1B[38;5;227m",u.deepOrange="\x1B[38;5;166m",u.lightGray="\x1B[38;5;252m",u.brightPink="\x1B[38;5;197m",u))(O||{}),G={enumColor:"\x1B[38;5;208m",typeColor:"\x1B[38;5;221m",classColor:"\x1B[38;5;215m",stringColor:"\x1B[38;5;149m",keywordColor:"\x1B[38;5;203m",commentColor:"\x1B[38;5;238m",functionColor:"\x1B[38;5;215m",variableColor:"\x1B[38;5;208m",interfaceColor:"\x1B[38;5;221m",parameterColor:"\x1B[38;5;166m",getAccessorColor:"\x1B[38;5;230m",numericLiteralColor:"\x1B[38;5;252m",methodSignatureColor:"\x1B[38;5;208m",regularExpressionColor:"\x1B[38;5;149m",propertyAssignmentColor:"\x1B[38;5;227m",propertyAccessExpressionColor:"\x1B[38;5;230m",expressionWithTypeArgumentsColor:"\x1B[38;5;215m"},S=class{constructor(e,n,t){this.sourceFile=e;this.code=n;this.schema=t}segments=new Map;parseNode(e){this.processComments(e),this.processKeywords(e),this.processNode(e)}highlight(){let e=0,n,t=[];return Array.from(this.segments.values()).sort((s,a)=>s.start-a.start||s.end-a.end).forEach(s=>{if(n&&s.start<n.end){let a=t.pop();if(!a)return;let c=this.getSegmentSource(s.start,s.end),l=`${s.color}${c}${n.color}`;t.push(a.replace(c,l));return}t.push(this.getSegmentSource(e,s.start)),t.push(`${s.color}${this.getSegmentSource(s.start,s.end)}${s.reset}`),e=s.end,n=s}),t.join("")+this.getSegmentSource(e)}getSegmentSource(e,n){return this.code.slice(e,n)}addSegment(e,n,t,r="\x1B[0m"){let s=`${e}-${n}`;this.segments.set(s,{start:e,end:n,color:t,reset:r})}processComments(e){[...o.getTrailingCommentRanges(this.sourceFile.getFullText(),e.getFullStart())||[],...o.getLeadingCommentRanges(this.sourceFile.getFullText(),e.getFullStart())||[]].forEach(t=>this.addSegment(t.pos,t.end,this.schema.commentColor))}processKeywords(e){if([h.SyntaxKind.NullKeyword,h.SyntaxKind.VoidKeyword,h.SyntaxKind.StringKeyword,h.SyntaxKind.NumberKeyword,h.SyntaxKind.BooleanKeyword,h.SyntaxKind.UndefinedKeyword].includes(e.kind))return this.addSegment(e.getStart(),e.getEnd(),this.schema.typeColor);e&&e.kind>=o.SyntaxKind.FirstKeyword&&e.kind<=o.SyntaxKind.LastKeyword&&this.addSegment(e.getStart(),e.getEnd(),this.schema.keywordColor)}processIdentifier(e){let n=e.getEnd(),t=e.getStart();switch(e.parent.kind){case o.SyntaxKind.EnumMember:return this.addSegment(t,n,this.schema.enumColor);case o.SyntaxKind.CallExpression:case o.SyntaxKind.EnumDeclaration:case o.SyntaxKind.PropertySignature:case o.SyntaxKind.ModuleDeclaration:return this.addSegment(t,n,this.schema.variableColor);case o.SyntaxKind.InterfaceDeclaration:return this.addSegment(t,n,this.schema.interfaceColor);case o.SyntaxKind.GetAccessor:return this.addSegment(t,n,this.schema.getAccessorColor);case o.SyntaxKind.PropertyAssignment:return this.addSegment(t,n,this.schema.propertyAssignmentColor);case o.SyntaxKind.MethodSignature:return this.addSegment(t,n,this.schema.methodSignatureColor);case o.SyntaxKind.MethodDeclaration:case o.SyntaxKind.FunctionDeclaration:return this.addSegment(t,n,this.schema.functionColor);case o.SyntaxKind.ClassDeclaration:return this.addSegment(t,n,this.schema.classColor);case o.SyntaxKind.Parameter:return this.addSegment(t,n,this.schema.parameterColor);case o.SyntaxKind.VariableDeclaration:return this.addSegment(t,n,this.schema.variableColor);case o.SyntaxKind.PropertyDeclaration:return this.addSegment(t,n,this.schema.variableColor);case o.SyntaxKind.PropertyAccessExpression:return e.parent.getChildAt(0).getText()===e.getText()?this.addSegment(t,n,this.schema.variableColor):this.addSegment(t,n,this.schema.propertyAccessExpressionColor);case o.SyntaxKind.ExpressionWithTypeArguments:return this.addSegment(t,n,this.schema.expressionWithTypeArgumentsColor);case o.SyntaxKind.BreakStatement:case o.SyntaxKind.ShorthandPropertyAssignment:case o.SyntaxKind.BindingElement:return this.addSegment(t,n,this.schema.variableColor);case o.SyntaxKind.BinaryExpression:case o.SyntaxKind.SwitchStatement:case o.SyntaxKind.TemplateSpan:return this.addSegment(t,n,this.schema.variableColor);case o.SyntaxKind.TypeReference:case o.SyntaxKind.TypeAliasDeclaration:return this.addSegment(t,n,this.schema.typeColor);case o.SyntaxKind.NewExpression:return this.addSegment(t,n,this.schema.variableColor)}}processTemplateExpression(e){let n=e.head.getStart(),t=e.head.getEnd();this.addSegment(n,t,this.schema.stringColor),e.templateSpans.forEach(r=>{let s=r.literal.getStart(),a=r.literal.getEnd();this.addSegment(s,a,this.schema.stringColor)})}processNode(e){let n=e.getStart(),t=e.getEnd();switch(e.kind){case o.SyntaxKind.TypeParameter:return this.addSegment(n,n+e.name.text.length,this.schema.typeColor);case o.SyntaxKind.TypeReference:return this.addSegment(n,t,this.schema.typeColor);case o.SyntaxKind.StringLiteral:case o.SyntaxKind.NoSubstitutionTemplateLiteral:return this.addSegment(n,t,this.schema.stringColor);case o.SyntaxKind.RegularExpressionLiteral:return this.addSegment(n,t,this.schema.regularExpressionColor);case o.SyntaxKind.TemplateExpression:return this.processTemplateExpression(e);case o.SyntaxKind.Identifier:return this.processIdentifier(e);case o.SyntaxKind.BigIntLiteral:case o.SyntaxKind.NumericLiteral:return this.addSegment(n,t,this.schema.numericLiteralColor)}}};function W(i,e={}){let n=o.createSourceFile("temp.ts",i,o.ScriptTarget.Latest,!0,o.ScriptKind.TS),t=new S(n,i,Object.assign(G,e));function r(s){t.parseNode(s);for(let a=0;a<s.getChildCount();a++)r(s.getChildAt(a))}return o.forEachChild(n,r),t.highlight()}var y=class{file;sourceRoot;names;sources;mappings;sourcesContent;constructor(e){this.validateSourceMap(e),this.file=e.file??null,this.names=e.names??[],this.sources=e.sources??[],this.mappings=[],this.sourceRoot=e.sourceRoot??null,this.sourcesContent=e.sourcesContent??[],this.decodeMappings(e.mappings)}getMapObject(){let e={version:3,names:this.names,sources:this.sources,mappings:this.encodeMappings(this.mappings),sourcesContent:this.sourcesContent};return this.file&&(e.file=this.file),this.sourceRoot&&(e.sourceRoot=this.sourceRoot),e}getSourceCodeByLocation(e,n,t,r){let s=e;if(typeof e=="string"&&(s=this.sources.findIndex(l=>l.includes(e))),s<0)return null;let a=Object.assign({bias:1,linesAfter:4,linesBefore:3},r),c=this.retrieveMapping(n,t,a.bias,s,"sourceLine","sourceColumn");return this.getPositionWithSource(c,a)}getSourcePosition(e,n,t){let r=Object.assign({bias:1,linesAfter:4,linesBefore:3},t),s=this.retrieveMapping(e,n,r.bias);return this.getPositionWithSource(s,r)}getPosition(e,n,t=1){let r=this.retrieveMapping(e,n,t);return r&&{line:r.sourceLine,name:this.names[r.nameIndex??-1]??null,column:r.sourceColumn,source:this.sources[r.fileIndex],sourceRoot:this.sourceRoot}}concat(...e){if(e.length<1)throw new Error("At least one map must be provided for concatenation.");for(let n of e){this.names.push(...n.names),this.sources.push(...n.sources),this.sourcesContent.push(...n.sourcesContent);let t=this.mappings[this.mappings.length-1],r=this.sourcesContent[t.fileIndex].split(`
-`).length;this.decodeMappings(e[0].mappings,{nameIndex:this.names.length-1,fileIndex:this.sources.length-1,generatedLine:r<2?2:r})}}toString(){return JSON.stringify(this.getMapObject())}getPositionWithSource(e,n){if(!e||isNaN(e.fileIndex))return null;let t=this.sourcesContent[e.fileIndex].split(`
-`),r=(e.sourceLine??1)+n.linesAfter,s=Math.max((e.sourceLine??1)-n.linesBefore,0);return{code:t.slice(s,Math.min(r+1,t.length)).join(`
-`),line:e.sourceLine,name:this.names[e.nameIndex??-1]??null,column:e.sourceColumn,endLine:r,startLine:s,source:this.sources[e.fileIndex],sourceRoot:this.sourceRoot}}validateSourceMap(e){if(!["version","sources","sourcesContent","mappings","names"].every(t=>t in e))throw new Error("Missing required keys in SourceMap.")}decodeMappings(e,n){let t=Object.assign({fileIndex:0,nameIndex:0,sourceLine:1,sourceColumn:1,generatedLine:1,generatedColumn:1},n);try{for(let[r,s]of e.split(";").entries()){if(!s)continue;t.generatedColumn=1;let a=s.split(",");for(let c of a){if(c.length<4)continue;let l=I(c);this.decodedSegment(t,l,r+t.generatedLine)}}}catch(r){throw new Error(`Error decoding mappings: ${r.message}`)}}decodedSegment(e,n,t){let[r,s,a,c,l]=n;e.fileIndex+=s,e.nameIndex+=l??0,e.sourceLine+=a,e.sourceColumn+=c,e.generatedColumn+=r,this.mappings.push({nameIndex:l!==void 0?e.nameIndex:null,fileIndex:e.fileIndex,sourceLine:e.sourceLine,sourceColumn:e.sourceColumn,generatedLine:t,generatedColumn:e.generatedColumn})}encodeMappings(e){let n="",t=[],r={fileIndex:0,nameIndex:0,sourceLine:1,sourceColumn:1,generatedLine:1,generatedColumn:1};r.generatedLine=e[0].generatedLine,n+=";".repeat(r.generatedLine-1);for(let s of e)s.generatedLine!==r.generatedLine&&(n+=t.join(","),n+=";".repeat(Math.max(1,s.generatedLine-r.generatedLine)),t=[],r.generatedLine=s.generatedLine,r.generatedColumn=1),this.encodeSegment(s,t,r);return n+t.join(",")+";"}encodeSegment(e,n,t){let r=[],s=e.fileIndex;if(r[1]=0,r[2]=e.sourceLine-t.sourceLine,r[3]=e.sourceColumn-t.sourceColumn,r[0]=e.generatedColumn-t.generatedColumn,s!==t.fileIndex&&(r[1]=s-t.fileIndex,t.fileIndex=s),e.nameIndex){let a=e.nameIndex;r[4]=a-t.nameIndex,t.nameIndex=a}t.sourceLine=e.sourceLine,t.sourceColumn=e.sourceColumn,t.generatedColumn=e.generatedColumn,n.push(x(r))}shouldSkipMapping(e,n){return n!==-1&&e.fileIndex!==n}retrieveMapping(e,n,t=0,r=-1,s="generatedLine",a="generatedColumn"){let c=0,l=this.mappings.length-1,d=null;for(;c<=l;){let m=Math.floor((c+l)/2),g=this.mappings[m];if(this.shouldSkipMapping(g,r)){c=m+1;continue}let p=g[s],u=g[a];if(p<e)c=m+1;else if(p>e)l=m-1;else if(u<n)d=t===1?g:d,c=m+1;else if(u>n)d=t===2?g:d,l=m-1;else return g}return d&&d[s]===e?d:null}};0&&(module.exports={CodeHighlighter,Colors,SourceService,decodeVLQ,encodeArrayVLQ,encodeVLQ,formatCode,formatErrorCode,highlightCode,parseErrorStack});
-//# sourceMappingURL=index.js.map