@remotex-labs/xmap 1.0.4 → 2.0.0

package/README.md

@@ -1,143 +1,206 @@
-# xMap
-## Description
-`xMap` is a library designed to help with sourcemap parsing and TypeScript code formatting for the CLI.\
-It includes components for parsing error stack traces, formatting code, and providing syntax highlighting, as well as a service for handling source maps.
-
-## Installation
-To install the package, use npm or yarn:
-```bash
-npm install @remotex-labs/xmap
-```
-or
-```bash
-yarn add @remotex-labs/xmap
-```
-## Usage
-### Parsing Error Stack Traces
-The parseErrorStack function parses an error stack trace and returns an array of stack entries.\
-Each entry contains information about the function call, file, line number, column number, and if applicable, details about the eval context.
-
-**Example**
-```typescript
-import { parseErrorStack } from '@remotex-labs/xmap';
-
-// Example stack trace string
-const stackTrace = `
-Error: Example error
-    at Object.<anonymous> (/path/to/file.js:10:15)
-    at Module._compile (node:internal/modules/cjs/loader:1217:14)
-    at node:internal/modules/cjs/loader:1308:14
-    at node:internal/modules/cjs/loader:1425:5
-    at node:internal/modules/cjs/loader:1425:5
-    at node:internal/modules/cjs/loader:1483:3
-    at node:internal/modules/cjs/loader:1700:8
-    at node:internal/modules/cjs/loader:1760:3
-    at /path/to/file.js:10:15
-    at Object.<anonymous> (/path/to/file.js:10:15)
-    at eval (eval at <anonymous> (/path/to/file.js:10:15), <anonymous>:1:1)
-`;
-
-// Parsing the stack trace
-const parsedStack = parseErrorStack(stackTrace);
-console.log(parsedStack);
-```
-
-### Formatting Code
-The formatCode function formats a code snippet with optional line padding and custom actions.\
-It applies padding to line numbers and can trigger custom actions for specific lines.
-
-Function Signature
-```typescript
-export function formatCode(code: string, options: FormatCodeInterface = {}): string;
-```
-Parameters
-
-* `code` (string): The source code or stack to be formatted.
-* `options` (FormatCodeInterface, optional): Configuration options for formatting the code. 
-  * `padding` (number, optional): Number of characters for line number padding. Defaults to 10. 
-  * `startLine` (number, optional): The starting line number for formatting. Defaults to 1. 
-  * `action` (object, optional): Custom actions to apply to specific lines. 
-  * `triggerLine` (number): The line number where the action should be triggered. 
-  * `callback` (function): A callback function to format the line string when triggerLine is matched. The callback receives the formatted line string, the padding value, and the current line number as arguments.
-
-```typescript
-import { formatCode } from '@remotex-labs/xmap';
-
-// Example TypeScript code
-const code = `
-function helloWorld() {
-    console.log('Hello, world!');
-}
-`;
-
-// Formatting the code
-const formattedCode = formatCode(code, {
-    padding: 8,
-    startLine: 5,
-    action: {
-        triggerLine: 7,
-        callback: (lineString, padding, lineNumber) => {
-            return `Custom formatting for line ${lineNumber}: ${lineString}`;
-        }
-    }
-});
-console.log(formattedCode);
-`;
-
-// Formatting the code
-const formattedCode = formatCode(code);
-console.log(formattedCode);
-```
-
-### Formatting Code with Error Location
-The formatErrorCode function formats a code snippet around an error location with special highlighting.\
-It highlights the relevant code snippet around the error location, including special formatting for the error line and column.
-
-Function Signature
-```typescript
-export function formatErrorCode(sourcePosition: PositionSourceInterface, ansiOption?: AnsiOptionInterface): string;
-```
-
-Example
-```typescript
-import { formatErrorCode } from '@remotex-labs/xmap';
-
-// Example source position
-const sourcePosition = {
-    code: `
-function helloWorld() {
-    console.log('Hello, world!');
-}
-`,
-    line: 2,
-    column: 15,
-    startLine: 1
-};
-
-// Optional ANSI color configuration
-const ansiOption = {
-    color: '\x1b[38;5;160m', // Red color
-    reset: '\x1b[0m' // Reset color
-};
-
-// Formatting the error code
-const formattedErrorCode = formatErrorCode(sourcePosition, ansiOption);
-console.log(formattedErrorCode);
-```
-
-### Highlighting Syntax
-To apply syntax highlighting to TypeScript or JavaScript code, use the highlighter component:
-```typescript
-import { highlightCode } from '@remotex-labs/xmap';
-
-// Example TypeScript code
-const code = `
-function helloWorld() {
-    console.log('Hello, world!');
-}
-`;
-
-// Highlighting the code
-const highlightedCode = highlightCode(code);
-console.log(highlightedCode);
-```
+# xMap Description
+`xMap` is a library designed to help with sourcemap parsing and TypeScript code formatting for the CLI.\
+It includes components for parsing error stack traces, formatting code, and providing syntax highlighting, as well as a service for handling source maps.
+
+# Installation
+To install the package, use npm or yarn:
+```bash
+npm install @remotex-labs/xmap
+```
+or
+```bash
+yarn add @remotex-labs/xmap
+```
+# Usage SourceService
+A TypeScript service for validating and processing source maps.
+The `SourceService` class provides functionality for parsing and manipulating source maps, including retrieving position mappings, 
+concatenating source maps, and getting code snippets based on mappings.
+
+### Importing the SourceService
+You can import the SourceService class in your TypeScript project as follows:
+```typescript
+import { SourceService } from '@remotex-labs/xmap'
+```
+
+## Creating an Instance of SourceService
+You can create an instance of `SourceService` using either a `SourceMapInterface` object, 
+a JSON string representing the source map, or an existing `SourceService` instance.
+Example:
+```typescript
+const sourceMapJSON = `
+{
+  "version": 3,
+  "sources": ["../src/core/core.component.ts", "../src/index.ts"],
+  "sourceRoot": "https://github.com/remotex-lab/xmap/tree/test/",
+  "sourcesContent": ["export class CoreModule {\\r\\n    private name: string;\\r\\n\\r\\n    constructor(name: string) {\\r\\n        this.name = name;\\r\\n    }\\r\\n\\r\\n    public greet(): string {\\r\\n        return \`Hello from \${ this.name }!\`;\\r\\n    }\\r\\n}", "import { CoreModule } from '@core/core.component';\\r\\n\\r\\nconst coreInstance = new CoreModule('Core Module');\\r\\n\\r\\nconsole.log(coreInstance.greet());"],
+  "mappings": "aAAO,IAAMA,EAAN,KAAiB,CACZ,KAER,YAAYC,EAAc,CACtB,KAAK,KAAOA,CAChB,CAEO,OAAgB,CACnB,MAAO,cAAc,KAAK,IAAI,GAClC,CACJ,ECRA,IAAMC,EAAe,IAAIC,EAAW,aAAa,EAEjD,QAAQ,IAAID,EAAa,MAAM,CAAC",
+  "names": ["CoreModule", "name", "coreInstance", "CoreModule"]
+}
+`;
+const sourceService = new SourceService(sourceMapJSON, 'bundle.js');
+console.log(sourceService);
+```
+
+## Retrieving Position Information
+You can retrieve position information based on the original source line and column using the `getPositionByOriginal` method.
+Example:
+```typescript
+const position = sourceService.getPositionByOriginal(3, 7, 'index.ts');
+console.log(position);
+```
+## Getting Code Snippets
+To retrieve the position and a code snippet from the original source based on the given generated code position, 
+you can use the `getPositionWithCode` method.
+Example:
+```typescript
+const positionWithCode = sourceService.getPositionWithCode(1, 104, Bias.UPPER_BOUND, { linesBefore: 2, linesAfter: 2 });
+console.log(positionWithCode);
+```
+
+## Converting to JSON String
+You can convert the current source map object to a JSON string using the `toString` method.
+Example:
+```typescript
+console.log(sourceService.toString());
+```
+
+## Concatenating Source Maps
+To concatenate one or more source maps to the current source map, you can use the `concat` method.
+```typescript
+const anotherSourceMap = {
+    version: 3,
+    file: "another-bundle.js",
+    sources: ["bar.ts"],
+    names: [],
+    mappings: "AAAA"
+};
+
+sourceService.concat(anotherSourceMap);
+console.log(sourceService.sources); // Updated source paths
+```
+
+## Parsing Error Stack Traces
+The parseErrorStack function parses an error stack trace and returns an array of stack entries.
+Each entry contains information about the function call, file, line number, column number, and if applicable, details about the eval context.
+Example:
+```typescript
+import { parseErrorStack } from '@remotex-labs/xmap';
+
+// Example stack trace string
+const stackTrace = `
+Error: Example error
+    at Object.<anonymous> (/path/to/file.js:10:15)
+    at Module._compile (node:internal/modules/cjs/loader:1217:14)
+    at node:internal/modules/cjs/loader:1308:14
+    at node:internal/modules/cjs/loader:1425:5
+    at node:internal/modules/cjs/loader:1425:5
+    at node:internal/modules/cjs/loader:1483:3
+    at node:internal/modules/cjs/loader:1700:8
+    at node:internal/modules/cjs/loader:1760:3
+    at /path/to/file.js:10:15
+    at Object.<anonymous> (/path/to/file.js:10:15)
+    at eval (eval at <anonymous> (/path/to/file.js:10:15), <anonymous>:1:1)
+`;
+
+// Parsing the stack trace
+const parsedStack = parseErrorStack(stackTrace);
+console.log(parsedStack);
+```
+
+## highlightCode
+Highlights the provided TypeScript code based on a specified highlighting scheme. 
+This function creates a source file from the provided code string, walks through its nodes, 
+and applies syntax highlighting according to the given schema.
+
+Example:
+```typescript
+import { highlightCode } from '@remotex-labs/xmap';
+
+// TypeScript code to be highlighted
+const codeToHighlight = `
+function greet(name: string): string {
+    return 'Hello, ' + name;
+}
+`;
+
+// Optional custom highlight scheme
+const customScheme = {
+    keywordColor: '\x1b[36m', // Blue
+    stringColor: '\x1b[32m',  // Green
+    numberColor: '\x1b[31m'  // Red
+};
+
+// Highlight the code
+const highlightedCode = highlightCode(codeToHighlight);
+const highlightedCode2 = highlightCode(codeToHighlight, customScheme);
+const highlightedCode3 = highlightCode(codeToHighlight);
+
+// Output the highlighted code
+console.log(highlightedCode, highlightedCode2, highlightedCode3);
+```
+> If you provide a customScheme, it will override the default highlighting scheme. This means you won't need to pass it each time you call highlightCode.
+
+![image](docs/images/code.png)
+## formatCode
+The `formatCode` function formats a given code snippet, adding line numbers with customizable padding and enabling specific actions for particular lines. 
+This utility is useful for displaying code snippets in a user-friendly manner, particularly in documentation or debugging scenarios.
+
+Example:
+```typescript
+import { formatCode, highlightCode } from '@remotex-labs/xmap';
+
+const code = `
+function greet(name: string) {
+    console.log('Hello, ' + name);
+}
+
+greet('World');
+`;
+
+const formattedCode = formatCode(highlightCode(code), {
+    padding: 8,
+    startLine: 5,
+    action: {
+        triggerLine: 6,
+        callback: (lineString, padding, lineNumber) => {
+            return `*** Custom formatting for line ${lineNumber} ***\n${lineString}`;
+        }
+    }
+});
+
+console.log(formattedCode);
+```
+![image](docs/images/formatCode.png)
+
+## formatErrorCode
+The `formatErrorCode` function formats a code snippet around a specified error location, 
+applying special highlighting to indicate where the error occurred. This function is particularly useful for debugging and error reporting, 
+as it helps to visually identify issues in the source code.
+
+```typescript
+import { highlightCode, SourceService, formatErrorCode } from '@remotex-labs/xmap';
+
+const sourceMapJSON = `
+{
+  "version": 3,
+  "sources": ["../src/core/core.component.ts", "../src/index.ts"],
+  "sourceRoot": "https://github.com/remotex-lab/xmap/tree/test/",
+  "sourcesContent": ["export class CoreModule {\\r\\n    private name: string;\\r\\n\\r\\n    constructor(name: string) {\\r\\n        this.name = name;\\r\\n    }\\r\\n\\r\\n    public greet(): string {\\r\\n        return \`Hello from \${ this.name }!\`;\\r\\n    }\\r\\n}", "import { CoreModule } from '@core/core.component';\\r\\n\\r\\nconst coreInstance = new CoreModule('Core Module');\\r\\n\\r\\nconsole.log(coreInstance.greet());"],
+  "mappings": "aAAO,IAAMA,EAAN,KAAiB,CACZ,KAER,YAAYC,EAAc,CACtB,KAAK,KAAOA,CAChB,CAEO,OAAgB,CACnB,MAAO,cAAc,KAAK,IAAI,GAClC,CACJ,ECRA,IAAMC,EAAe,IAAIC,EAAW,aAAa,EAEjD,QAAQ,IAAID,EAAa,MAAM,CAAC",
+  "names": ["CoreModule", "name", "coreInstance", "CoreModule"]
+}
+`;
+const sourceService = new SourceService(sourceMapJSON, 'bundle.js');
+const error = sourceService.getPositionWithCode(1, 91);
+
+const ansiOption = {
+    color: '\x1b[38;5;160m', // Color for error marker
+    reset: '\x1b[0m'         // Reset color
+};
+
+if (error) {
+    error.code = highlightCode(error.code);
+    console.log(formatErrorCode(error, ansiOption));
+}
+```
+![image](docs/images/formatErrorCode.png)

package/dist/{components → cjs/components}/formatter.component.d.ts

@@ -1,8 +1,8 @@
 /**
  * Import will remove at compile time
  */
-import type { PositionSourceInterface } from "../services/interfaces/source.interface.ts";
-import type { AnsiOptionInterface, FormatCodeInterface } from "./interfaces/formatter.interface.ts";
+import type { PositionWithCodeInterface } from "../services/interfaces/source.interface";
+import type { AnsiOptionInterface, FormatCodeInterface } from "./interfaces/formatter.interface";
 /**
  * Formats a code snippet with optional line padding and custom actions.
  *
@@ -63,4 +63,4 @@ export declare function formatCode(code: string, options?: FormatCodeInterface):
  * console.log(formattedErrorCode);
  * ```
  */
-export declare function formatErrorCode(sourcePosition: PositionSourceInterface, ansiOption?: AnsiOptionInterface): string;
+export declare function formatErrorCode(sourcePosition: PositionWithCodeInterface, ansiOption?: AnsiOptionInterface): string;

package/dist/{components → cjs/components}/highlighter.component.d.ts

@@ -1,7 +1,7 @@
 /**
  * Import will remove at compile time
  */
-import type { HighlightSchemeInterface } from "./interfaces/highlighter.interface.ts";
+import type { HighlightSchemeInterface } from "./interfaces/highlighter.interface";
 /**
  * Imports
  */

package/dist/{components → cjs/components}/parser.component.d.ts

@@ -1,7 +1,7 @@
 /**
  * Import will remove at compile time
  */
-import type { StackEntryInterface } from "./interfaces/parse.interface.ts";
+import type { StackEntryInterface } from "./interfaces/parse.interface";
 /**
  * Parses an error stack trace and returns an object with a message and an array of stack entries.
  *

package/dist/cjs/index.d.ts

@@ -0,0 +1,9 @@
+export type * from "./components/interfaces/parse.interface";
+export type * from "./components/interfaces/formatter.interface";
+export type * from "./components/interfaces/highlighter.interface";
+export type * from "./services/interfaces/source.interface";
+export * from "./components/parser.component";
+export * from "./components/base64.component";
+export * from "./components/formatter.component";
+export * from "./components/highlighter.component";
+export * from "./services/source.service";

package/dist/cjs/index.js

@@ -0,0 +1,7 @@
+function $(u){let e=u.split(`
+`).slice(1),t=/^\s*at\s+(.*?)\s+\((.*?):(\d+):(\d+)\)$|^\s*at\s+(.*?):(\d+):(\d+)$/,n=/eval\s+at\s+([^\s(]+).+\((.+):(\d+):(\d+)\),\s(.+)/,i=[];return e.forEach(r=>{let s=r.match(t);if(!s)return;let a=s.slice(1);s[2]||(a=s.slice(4));let[c,l,d,g]=a,h=parseInt(d,10),m=parseInt(g,10);if(r.includes("eval")){let y=l.match(n)?.slice(1);if(y){let[N,w,E,A,M]=y;i.push({at:c,file:M,line:h,column:m,executor:{at:N,file:w,line:parseInt(E,10),column:parseInt(A,10)}});return}}i.push({at:c||"<anonymous>",file:l,line:h,column:m,executor:null})}),i}var x={},I="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".split("");I.forEach((u,e)=>{x[u]=e});function T(u){let e=u<0,t="",n=e?(-u<<1)+1:u<<1;do{let i=n&31;n>>>=5,t+=I[i|(n>0?32:0)]}while(n>0);return t}function C(u){return u.map(T).join("")}function b(u){let e=[],t=0,n=0;for(let i=0;i<u.length;i++){let r=x[u[i]];if(r===void 0)throw new Error(`Invalid Base64 character: ${u[i]}`);let s=r&32;if(n+=(r&31)<<t,s)t+=5;else{let a=(n&1)===1,c=n>>1;e.push(a?-c:c),n=t=0}}return e}function K(u,e={}){let t=u.split(`
+`),n=e.padding??10,i=e.startLine??0;return t.map((r,s)=>{let a=s+i+1,l=`${`${a} | `.padStart(n)}${r}`;return e.action&&a===e.action.triggerLine?e.action.callback(l,n,a):l}).join(`
+`)}function F(u,e){let{code:t,line:n,column:i,startLine:r}=u;if(n<r||i<1)throw new Error("Invalid line or column number.");return K(t,{startLine:r,action:{triggerLine:n,callback:(s,a,c)=>{let l="^",d=a-1,g=">";e&&(l=`${e.color}${l}${e.reset}`,d+=e.color.length+e.reset.length,g=`${e.color}>${e.reset}`);let h=" | ".padStart(a)+" ".repeat(i-1)+`${l}`;return s=`${g} ${c} |`.padStart(d)+s.split("|")[1],s+`
+${h}`}}})}import*as o from"typescript";import{SyntaxKind as p}from"typescript";var O=(m=>(m.reset="\x1B[0m",m.gray="\x1B[38;5;243m",m.darkGray="\x1B[38;5;238m",m.lightCoral="\x1B[38;5;203m",m.lightOrange="\x1B[38;5;215m",m.oliveGreen="\x1B[38;5;149m",m.burntOrange="\x1B[38;5;208m",m.lightGoldenrodYellow="\x1B[38;5;221m",m.lightYellow="\x1B[38;5;230m",m.canaryYellow="\x1B[38;5;227m",m.deepOrange="\x1B[38;5;166m",m.lightGray="\x1B[38;5;252m",m.brightPink="\x1B[38;5;197m",m))(O||{}),L={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,t,n){this.sourceFile=e;this.code=t;this.schema=n}segments=new Map;parseNode(e){this.processComments(e),this.processKeywords(e),this.processNode(e)}highlight(){let e=0,t,n=[];return Array.from(this.segments.values()).sort((r,s)=>r.start-s.start||r.end-s.end).forEach(r=>{if(t&&r.start<t.end){let s=n.pop();if(!s)return;let a=this.getSegmentSource(r.start,r.end),c=`${r.color}${a}${t.color}`;n.push(s.replace(a,c));return}n.push(this.getSegmentSource(e,r.start)),n.push(`${r.color}${this.getSegmentSource(r.start,r.end)}${r.reset}`),e=r.end,t=r}),n.join("")+this.getSegmentSource(e)}getSegmentSource(e,t){return this.code.slice(e,t)}addSegment(e,t,n,i="\x1B[0m"){let r=`${e}-${t}`;this.segments.set(r,{start:e,end:t,color:n,reset:i})}processComments(e){[...o.getTrailingCommentRanges(this.sourceFile.getFullText(),e.getFullStart())||[],...o.getLeadingCommentRanges(this.sourceFile.getFullText(),e.getFullStart())||[]].forEach(n=>this.addSegment(n.pos,n.end,this.schema.commentColor))}processKeywords(e){if([p.NullKeyword,p.VoidKeyword,p.StringKeyword,p.NumberKeyword,p.BooleanKeyword,p.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 t=e.getEnd(),n=e.getStart();switch(e.parent.kind){case o.SyntaxKind.EnumMember:return this.addSegment(n,t,this.schema.enumColor);case o.SyntaxKind.CallExpression:case o.SyntaxKind.EnumDeclaration:case o.SyntaxKind.PropertySignature:case o.SyntaxKind.ModuleDeclaration:return this.addSegment(n,t,this.schema.variableColor);case o.SyntaxKind.InterfaceDeclaration:return this.addSegment(n,t,this.schema.interfaceColor);case o.SyntaxKind.GetAccessor:return this.addSegment(n,t,this.schema.getAccessorColor);case o.SyntaxKind.PropertyAssignment:return this.addSegment(n,t,this.schema.propertyAssignmentColor);case o.SyntaxKind.MethodSignature:return this.addSegment(n,t,this.schema.methodSignatureColor);case o.SyntaxKind.MethodDeclaration:case o.SyntaxKind.FunctionDeclaration:return this.addSegment(n,t,this.schema.functionColor);case o.SyntaxKind.ClassDeclaration:return this.addSegment(n,t,this.schema.classColor);case o.SyntaxKind.Parameter:return this.addSegment(n,t,this.schema.parameterColor);case o.SyntaxKind.VariableDeclaration:return this.addSegment(n,t,this.schema.variableColor);case o.SyntaxKind.PropertyDeclaration:return this.addSegment(n,t,this.schema.variableColor);case o.SyntaxKind.PropertyAccessExpression:return e.parent.getChildAt(0).getText()===e.getText()?this.addSegment(n,t,this.schema.variableColor):this.addSegment(n,t,this.schema.propertyAccessExpressionColor);case o.SyntaxKind.ExpressionWithTypeArguments:return this.addSegment(n,t,this.schema.expressionWithTypeArgumentsColor);case o.SyntaxKind.BreakStatement:case o.SyntaxKind.ShorthandPropertyAssignment:case o.SyntaxKind.BindingElement:return this.addSegment(n,t,this.schema.variableColor);case o.SyntaxKind.BinaryExpression:case o.SyntaxKind.SwitchStatement:case o.SyntaxKind.TemplateSpan:return this.addSegment(n,t,this.schema.variableColor);case o.SyntaxKind.TypeReference:case o.SyntaxKind.TypeAliasDeclaration:return this.addSegment(n,t,this.schema.typeColor);case o.SyntaxKind.NewExpression:return this.addSegment(n,t,this.schema.variableColor)}}processTemplateExpression(e){let t=e.head.getStart(),n=e.head.getEnd();this.addSegment(t,n,this.schema.stringColor),e.templateSpans.forEach(i=>{let r=i.literal.getStart(),s=i.literal.getEnd();this.addSegment(r,s,this.schema.stringColor)})}processNode(e){let t=e.getStart(),n=e.getEnd();switch(e.kind){case o.SyntaxKind.TypeParameter:return this.addSegment(t,t+e.name.text.length,this.schema.typeColor);case o.SyntaxKind.TypeReference:return this.addSegment(t,n,this.schema.typeColor);case o.SyntaxKind.StringLiteral:case o.SyntaxKind.NoSubstitutionTemplateLiteral:return this.addSegment(t,n,this.schema.stringColor);case o.SyntaxKind.RegularExpressionLiteral:return this.addSegment(t,n,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(t,n,this.schema.numericLiteralColor)}}};function D(u,e={}){let t=o.createSourceFile("temp.ts",u,o.ScriptTarget.Latest,!0,o.ScriptKind.TS),n=new S(t,u,Object.assign(L,e));function i(r){n.parseNode(r);for(let s=0;s<r.getChildCount();s++)i(r.getChildAt(s))}return o.forEachChild(t,i),n.highlight()}var f=class u{mapping=[];constructor(e,t=0,n=0){e=e instanceof u?e.mapping:e,Array.isArray(e)?this.decodeMappingArray(e,t,n):this.decodeMappingString(e,t,n)}encode(){return this.encodeMappings(this.mapping)}decode(e,t=0,n=0){e=e instanceof u?e.mapping:e,Array.isArray(e)?this.decodeMappingArray(e,t,n):this.decodeMappingString(e,t,n)}getSegment(e,t,n=0){let i=this.mapping[e-1];if(!i||i.length===0)return null;let r=0,s=i.length-1,a=null;for(;r<=s;){let c=Math.floor((r+s)/2),l=i[c];if(l.generatedColumn<t)r=c+1,a=n===1?l:a;else if(l.generatedColumn>t)s=c-1,a=n===2?l:a;else return l}return a}getOriginalSegment(e,t,n,i=0){let r=null;for(let s of this.mapping){if(!s)continue;let a=0,c=s.length-1;for(;a<=c;){let l=Math.floor((a+c)/2),d=s[l];if(d.sourceIndex<n||d.line<e)a=l+1;else if(d.sourceIndex>n||d.line>e)c=l-1;else if(d.column<t)a=l+1,r=i===1?d:r;else if(d.column>t)c=l-1,r=i===2?d:r;else return d}}return r}initPositionOffsets(e=0,t=0){return{line:0,column:0,nameIndex:e,sourceIndex:t,generatedLine:0,generatedColumn:0}}validateMappingString(e){return/^(;*([A-Za-z0-9+/]{1,7}(([,]|[;]+)[A-Za-z0-9+/]{1,7})*));*$/.test(e)}validateSegment(e){if(!Number.isFinite(e.line))throw new Error(`Invalid segment: line must be a finite number, received ${e.line}`);if(!Number.isFinite(e.column))throw new Error(`Invalid segment: column must be a finite number, received ${e.column}`);if(e.nameIndex!==null&&!Number.isFinite(e.nameIndex))throw new Error(`Invalid segment: nameIndex must be a number or null, received ${e.nameIndex}`);if(!Number.isFinite(e.sourceIndex))throw new Error(`Invalid segment: sourceIndex must be a finite number, received ${e.sourceIndex}`);if(!Number.isFinite(e.generatedLine))throw new Error(`Invalid segment: generatedLine must be a finite number, received ${e.generatedLine}`);if(!Number.isFinite(e.generatedColumn))throw new Error(`Invalid segment: generatedColumn must be a finite number, received ${e.generatedColumn}`)}encodeSegment(e,t){let{line:n,column:i,generatedColumn:r,nameIndex:s,sourceIndex:a}=t,c=n-1,l=i-1,d=r-1,g=[d-e.generatedColumn,a!==e.sourceIndex?a-e.sourceIndex:0,c-e.line,l-e.column];return s!=null&&(g[4]=s-e.nameIndex,e.nameIndex=s),e.line=c,e.column=l,e.generatedColumn=d,e.sourceIndex=a,C(g)}encodeMappings(e){let t=this.initPositionOffsets();return e.map(n=>n?(t.generatedColumn=0,n.map(r=>this.encodeSegment(t,r)).join(",")):"").join(";")}decodedSegment(e,t){let[n,i,r,s,a]=t;return e.line+=r,e.column+=s,e.nameIndex+=a??0,e.sourceIndex+=i,e.generatedColumn+=n,{line:e.line+1,column:e.column+1,nameIndex:a!==void 0?e.nameIndex:null,sourceIndex:e.sourceIndex,generatedLine:e.generatedLine+1,generatedColumn:e.generatedColumn+1}}decodeMappingString(e,t,n){if(!this.validateMappingString(e))throw new Error("Invalid Mappings string format: the provided string does not conform to expected VLQ format.");let i=e.split(";"),r=this.mapping.length,s=this.initPositionOffsets(t,n);try{i.forEach((a,c)=>{if(!a){this.mapping.push(null);return}s.generatedColumn=0,s.generatedLine=r+c;let l=a.split(",").map(d=>this.decodedSegment(s,b(d)));this.mapping.push(l)})}catch(a){throw new Error(`Error decoding mappings at frame index ${i.length}: ${a.message}`)}}decodeMappingArray(e,t,n){let i=this.mapping.length;if(!Array.isArray(e))throw new Error("Invalid encoded map: expected an array of frames.");try{e.forEach((r,s)=>{if(!r){this.mapping.push(r);return}if(!Array.isArray(r))throw new Error(`Invalid Mappings array format at frame index ${s}: expected an array, received ${typeof r}.`);let a=r.map(c=>(this.validateSegment(c),{...c,nameIndex:typeof c.nameIndex=="number"?c.nameIndex+t:null,sourceIndex:c.sourceIndex+n,generatedLine:c.generatedLine+i}));this.mapping.push(a)})}catch(r){let s=r instanceof Error?r.message:"Unknown error";throw new Error(`Error decoding mappings: ${s}`)}}};var v=class u{file;mappings;sourceRoot;names;sources;sourcesContent;constructor(e,t=null){typeof e=="string"&&(e=JSON.parse(e)),e=e,this.validateSourceMap(e),this.file=e.file??t,this.names=[...e.names??[]],this.sources=[...e.sources??[]],this.sourceRoot=e.sourceRoot??null,this.sourcesContent=e.sourcesContent?[...e.sourcesContent]:[],this.mappings=new f(e.mappings)}getMapObject(){let e={version:3,names:this.names,sources:this.sources,mappings:this.mappings.encode(),sourcesContent:this.sourcesContent};return this.file&&(e.file=this.file),this.sourceRoot&&(e.sourceRoot=this.sourceRoot),e}concat(...e){if(e.length<1)throw new Error("At least one map must be provided for concatenation.");for(let t of e)this.mappings.decode(t.mappings,this.names.length,this.sources.length),this.names.push(...t.names),this.sources.push(...t.sources),this.sourcesContent.push(...t.sourcesContent??[])}concatNewMap(...e){if(e.length<1)throw new Error("At least one map must be provided for concatenation.");let t=new u(this);for(let n of e)t.mappings.decode(n.mappings,t.names.length,t.sources.length),t.names.push(...n.names),t.sources.push(...n.sources),t.sourcesContent.push(...n.sourcesContent??[]);return t}getPositionByOriginal(e,t,n,i=0){let r=n;if(typeof n=="string"&&(r=this.sources.findIndex(a=>a.includes(n))),r<0)return null;let s=this.mappings.getOriginalSegment(e,t,r,i);return s?{name:this.names[s.nameIndex??-1]??null,line:s.line,column:s.column,source:this.sources[s.sourceIndex],sourceRoot:this.sourceRoot,sourceIndex:s.sourceIndex,generatedLine:s.generatedLine,generatedColumn:s.generatedColumn}:null}getPosition(e,t,n=0){let i=this.mappings.getSegment(e,t,n);return i?{name:this.names[i.nameIndex??-1]??null,line:i.line,column:i.column,source:this.sources[i.sourceIndex],sourceRoot:this.sourceRoot,sourceIndex:i.sourceIndex,generatedLine:i.generatedLine,generatedColumn:i.generatedColumn}:null}getPositionWithContent(e,t,n=0){let i=this.getPosition(e,t,n);return i?{...i,sourcesContent:this.sourcesContent[i.sourceIndex]}:null}getPositionWithCode(e,t,n=0,i){let r=this.getPosition(e,t,n);if(!r||!this.sourcesContent[r.sourceIndex])return null;let s=Object.assign({linesAfter:4,linesBefore:3},i),a=this.sourcesContent[r.sourceIndex].split(`
+`),c=Math.min((r.line??1)+s.linesAfter,a.length),l=Math.max((r.line??1)-s.linesBefore,0),d=a.slice(l,Math.min(c+1,a.length)).join(`
+`);return{...r,code:d,endLine:c,startLine:l}}toString(){return JSON.stringify(this.getMapObject())}validateSourceMap(e){if(!["sources","mappings","names"].every(n=>n in e))throw new Error("Missing required keys in SourceMap.")}};export{S as CodeHighlighter,O as Colors,v as SourceService,b as decodeVLQ,C as encodeArrayVLQ,T as encodeVLQ,K as formatCode,F as formatErrorCode,D as highlightCode,$ as parseErrorStack};