@remotex-labs/xmap 3.0.5 → 4.0.0

package/README.md

@@ -1,8 +1,20 @@
-# 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.
+# xMap
 
-# Installation
+[![npm version](https://img.shields.io/badge/Documentation-orange?logo=typescript&logoColor=f5f5f5)](https://remotex-labs.github.io/xMap/)
+[![npm version](https://img.shields.io/npm/v/@remotex-labs/xmap.svg)](https://www.npmjs.com/package/@remotex-labs/xmap)
+[![License: MPL 2.0](https://img.shields.io/badge/License-MPL_2.0-brightgreen.svg)](https://opensource.org/licenses/MPL-2.0)
+[![Node.js CI](https://github.com/remotex-labs/xMap/actions/workflows/node.js.yml/badge.svg)](https://github.com/remotex-labs/xMap/actions/workflows/node.js.yml)
+
+`xMap` is a TypeScript library for working with source maps, stack trace parsing, and code formatting. It provides powerful tools for debugging, error reporting, and code visualization in CLI environments.
+
+## Features
+- **Source Map Processing**: Parse, manipulate, and query source maps
+- **Stack Trace Parsing**: Parse error stacks from V8, SpiderMonkey, and JavaScriptCore engines
+- **Code Formatting**: Display code with line numbers and custom highlighting
+- **Syntax Highlighting**: Semantic TypeScript code highlighting with customizable themes
+- **Error Visualization**: Format code snippets with error indicators
+
+## Installation
 To install the package, use npm or yarn:
 ```bash
 npm install @remotex-labs/xmap
@@ -11,170 +23,211 @@ 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
+## Optimizing Bundle Size
+xMap supports subpath imports, allowing you to import only the specific components you need:
+
+```ts
+// Import only what you need
+import { parseErrorStack } from '@remotex-labs/xmap/parser.component';
+import { formatCode } from '@remotex-labs/xmap/formatter.component';
+import { highlightCode } from '@remotex-labs/xmap/highlighter.component';
 import { SourceService } 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"]
-}
-`;
+## Key Components
+### SourceService
+Process and query source maps to get original positions, concatenate maps, and retrieve code snippets.
+
+```ts
+import { SourceService, Bias } from '@remotex-labs/xmap';
+
+// Create from JSON string
 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);
-```
+// Get original position for generated code
+const originalPosition = sourceService.getPositionByGenerated(12, 34);
 
-## 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());
+// Get position with code context
+const positionWithCode = sourceService.getPositionWithCode(12, 34, Bias.LOWER_BOUND, { 
+  linesBefore: 2, 
+  linesAfter: 2 
+});
 ```
 
-## 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"
-};
+#### Understanding Bias
+When querying source maps, the parameter controls how positions are matched: `Bias`
+- `Bias.BOUND` - No directional preference; returns the first match found 
+- `Bias.LOWER_BOUND` - Prefers segments with column values ≤ the target 
+- `Bias.UPPER_BOUND` - Prefers segments with column values ≥ the target `Bias.UPPER_BOUND`
 
-sourceService.concat(anotherSourceMap);
-console.log(sourceService.sources); // Updated source paths
+Example:
+```ts
+// Using different bias values for position lookup
+const exactPosition = sourceService.getPosition(10, 15, Bias.BOUND);
+const beforePosition = sourceService.getPosition(10, 15, Bias.LOWER_BOUND);
+const afterPosition = sourceService.getPosition(10, 15, Bias.UPPER_BOUND);
 ```
 
-## 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.
+### Stack Trace Parser
+Parse error stack traces from different JavaScript engines into a structured format.
 
-### Example:
-```typescript
+```ts
 import { parseErrorStack } from '@remotex-labs/xmap/parser.component';
 
-// Example with Error object
 try {
-    throw new Error('Example error');
+  throw new Error('Example error');
 } catch (error) {
-    // Parsing the stack trace from an Error object
-    const parsedStack = parseErrorStack(error);
-    console.log(parsedStack);
+  const parsedStack = parseErrorStack(error);
+  
+  console.log(parsedStack.name);     // "Error"
+  console.log(parsedStack.message);  // "Example error"
+  
+  // Access the first stack frame
+  const frame = parsedStack.stack[0];
+  console.log(frame.fileName);       // File where error occurred
+  console.log(frame.line);           // Line number
+  console.log(frame.functionName);   // Function name
 }
+
 ```
 
-## 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.
+### Code Highlighter
+Apply semantic syntax highlighting to TypeScript code.
 
-Example:
-```typescript
+```ts
 import { highlightCode } from '@remotex-labs/xmap/highlighter.component';
 
-// TypeScript code to be highlighted
-const codeToHighlight = `
-function greet(name: string): string {
-    return 'Hello, ' + name;
+const code = `
+function sum(a: number, b: number): number {
+  return a + b;
 }
 `;
 
-// Optional custom highlight scheme
+// Use default color scheme
+const highlightedCode = highlightCode(code);
+
+// Or customize with your own color scheme
 const customScheme = {
-    keywordColor: '\x1b[36m', // Blue
-    stringColor: '\x1b[32m',  // Green
-    numberColor: '\x1b[31m'  // Red
+    keywordColor: (text: string): string => `\x1b[36m${ text }\x1b[0m`,  // Blue for keywords
+    stringColor: (text: string): string => `\x1b[32m${ text }\x1b[0m`,  // Blue for keywords
+    numberColor: (text: string): string => `\x1b[31m${ text }\x1b[0m`  // Blue for keywords
 };
 
-// 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);
+const customHighlightedCode = highlightCode(code, customScheme);
+console.log(customHighlightedCode)
 ```
-> 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)
+![image](docs/src/public/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
+```ts
 import { formatCode } from '@remotex-labs/xmap/formatter.component';
 import { highlightCode } from '@remotex-labs/xmap/highlighter.component';
 
 const code = `
 function greet(name: string) {
-    console.log('Hello, ' + name);
+  console.log('Hello, ' + name);
 }
 
 greet('World');
 `;
 
+// Format with custom options
 const formattedCode = formatCode(highlightCode(code), {
-    padding: 8,
-    startLine: 5,
+    padding: 8,         // Padding for line numbers
+    startLine: 1,       // Starting line number
     action: {
-        triggerLine: 6,
+        triggerLine: 3,   // Line to apply custom formatting
         callback: (lineString, padding, lineNumber) => {
-            return `*** Custom formatting for line ${lineNumber} ***\n${lineString}`;
+            return `*** Line ${ lineNumber } ***\n${ lineString }`;
         }
     }
 });
 
 console.log(formattedCode);
 ```
-![image](docs/images/formatCode.png)
+![image](docs/src/public/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.
+```ts
+import { formatErrorCode } from '@remotex-labs/xmap/formatter.component';
 
-```typescript
-import { SourceService } from '@remotex-labs/xmap';
-import { highlightCode } from '@remotex-labs/xmap/highlighter.component';
+const sourcePosition = {
+    code: 'function divide(a, b) {\n  return a / b;\n}',
+    line: 2,
+    column: 13,
+    startLine: 1,
+    endLine: 0,
+    name: null,
+    source: '',
+    sourceRoot: null,
+    sourceIndex: 0,
+    generatedLine: 0,
+    generatedColumn: 0
+};
+
+// Format with error indicator
+const formattedError = formatErrorCode(sourcePosition, {
+    color: (text) => `\x1b[31m${ text }\x1b[0m`  // Red color for error indicator
+});
+
+console.log(formattedError)
+```
+
+![image](docs/src/public/images/formatErrorCode.png)
+
+## Practical Examples
+### Working with Source Maps and Errors
+
+```ts
+import { SourceService, Bias } from '@remotex-labs/xmap';
+import { parseErrorStack } from '@remotex-labs/xmap/parser.component';
 import { formatErrorCode } from '@remotex-labs/xmap/formatter.component';
+import { highlightCode } from '@remotex-labs/xmap/highlighter.component';
+
+try {
+    // Code that throws an error
+    throw new Error('Something went wrong');
+} catch (error) {
+    // Parse the error stack
+    const parsedStack = parseErrorStack(error);
+
+    // Get the top frame
+    const frame = parsedStack.stack[0];
+
+    if (frame.fileName && frame.line && frame.column) {
+        // Initialize source service with your source map
+        const sourceService = new SourceService(sourceMapJSON);
+
+        // Get original position with code
+        const position = sourceService.getPositionWithCode(
+            frame.line,
+            frame.column,
+            Bias.LOWER_BOUND,
+            { linesBefore: 2, linesAfter: 2 }
+        );
+
+        if (position) {
+            // Apply syntax highlighting
+            position.code = highlightCode(position.code);
+
+            // Format with error indicator
+            const formattedError = formatErrorCode(position, {
+                color: (text) => `\x1b[31m${ text }\x1b[0m`
+            });
+
+            console.log('Error occurred:');
+            console.log(formattedError);
+        }
+    }
+}
+
+```
+
+```ts
+import { SourceService } from '@remotex-labs/xmap';
 
 const sourceMapJSON = `
 {
@@ -187,16 +240,31 @@ const sourceMapJSON = `
 }
 `;
 const sourceService = new SourceService(sourceMapJSON, 'bundle.js');
-const error = sourceService.getPositionWithCode(1, 91);
+console.log(sourceService);
 
-const ansiOption = {
-    color: '\x1b[38;5;160m', // Color for error marker
-    reset: '\x1b[0m'         // Reset color
-};
+const position = sourceService.getPositionByOriginal(3, 7, 'index.ts');
+console.log(position);
+
+const positionWithCode = sourceService.getPositionWithCode(1, 104, 1, { linesBefore: 2, linesAfter: 2 });
+console.log(positionWithCode);
 
-if (error) {
-    error.code = highlightCode(error.code);
-    console.log(formatErrorCode(error, ansiOption));
-}
 ```
-![image](docs/images/formatErrorCode.png)
+
+## Documentation
+For complete API documentation, examples, and guides, visit: [xMap Documentation](https://remotex-labs.github.io/xMap/)
+
+## Compatibility
+- Node.js 20+
+- All modern browsers (via bundlers)
+- TypeScript 4.5+
+
+## Contributing
+Contributions are welcome!\
+Please see our [Contributing Guide](CONTRIBUTING.md) for details.
+
+
+## License
+This project is licensed under the Mozilla Public License 2.0 - see the [LICENSE](LICENSE) file for details.
+
+## Acknowledgments
+- Built with TypeScript

package/dist/cjs/formatter.component.js

@@ -1,5 +1,5 @@
-"use strict";var s=Object.defineProperty;var $=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var I=(r,e)=>{for(var n in e)s(r,n,{get:e[n],enumerable:!0})},L=(r,e,n,o)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of g(e))!C.call(r,t)&&t!==n&&s(r,t,{get:()=>e[t],enumerable:!(o=$(e,t))||o.enumerable});return r};var x=r=>L(s({},"__esModule",{value:!0}),r);var b={};I(b,{formatCode:()=>d,formatErrorCode:()=>h});module.exports=x(b);function d(r,e={}){let n=r.split(`
-`),o=e.padding??10,t=e.startLine??0;return n.map((f,a)=>{let c=a+t+1,i=`${`${c} | `.padStart(o)}${f}`;return e.action&&c===e.action.triggerLine?e.action.callback(i,o,c):i}).join(`
-`)}function h(r,e){let{code:n,line:o,column:t,startLine:f}=r;if(o<f||t<1)throw new Error("Invalid line or column number.");return d(n,{startLine:f,action:{triggerLine:o,callback:(a,c,m)=>{let i="^",l=c-1,p=">";e&&(i=`${e.color}${i}${e.reset}`,l+=e.color.length+e.reset.length,p=`${e.color}>${e.reset}`);let u=" | ".padStart(c)+" ".repeat(t-1)+`${i}`;return a=`${p} ${m} |`.padStart(l)+a.split("|")[1],a+`
+"use strict";var s=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var I=Object.prototype.hasOwnProperty;var L=(e,r)=>{for(var n in r)s(e,n,{get:r[n],enumerable:!0})},$=(e,r,n,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of C(r))!I.call(e,t)&&t!==n&&s(e,t,{get:()=>r[t],enumerable:!(o=g(r,t))||o.enumerable});return e};var x=e=>$(s({},"__esModule",{value:!0}),e);var h={};L(h,{formatCode:()=>d,formatErrorCode:()=>b});module.exports=x(h);function d(e,r={}){let n=e.split(`
+`),o=r.padding??10,t=r.startLine??0;return n.map((f,a)=>{let c=a+t+1,i=`${`${c} | `.padStart(o)}${f}`;return r.action&&c===r.action.triggerLine?r.action.callback(i,o,c):i}).join(`
+`)}function b(e,r){let{code:n,line:o,column:t,startLine:f}=e;if(o<f||t<1)throw new Error("Invalid line or column number.");return d(n,{startLine:f,action:{triggerLine:o,callback:(a,c,m)=>{let i="^",p=c-1,l=">";r&&(i=r.color(i),p+=i.length-1,l=r.color(">"));let u=" | ".padStart(c)+" ".repeat(t-1)+`${i}`;return a=`${l} ${m} |`.padStart(p)+a.split("|")[1],a+`
 ${u}`}}})}0&&(module.exports={formatCode,formatErrorCode});
 //# sourceMappingURL=formatter.component.js.map

package/dist/cjs/formatter.component.js.map

@@ -1,8 +1,8 @@
 {
   "version": 3,
   "sources": ["../../src/components/formatter.component.ts"],
-  "sourceRoot": "https://github.com/remotex-lab/xmap/tree/v3.0.5/",
-  "sourcesContent": ["/**\n * Export interfaces\n */\n\nexport type * from '@components/interfaces/formatter-component.interface';\n\n/**\n * Import will remove at compile time\n */\n\nimport type { PositionWithCodeInterface } from '@services/interfaces/source-service.interface';\nimport type { AnsiOptionInterface, FormatCodeInterface } from '@components/interfaces/formatter-component.interface';\n\n/**\n * Formats a code snippet with optional line padding and custom actions\n *\n * @param code - The source code | stack to be formatted\n * @param options - Configuration options for formatting the code\n * @returns A formatted string of the code snippet with applied padding and custom actions\n *\n * @remarks\n * This function takes a code string and an options object to format the code snippet.\n * It applies padding to line numbers and can trigger custom actions for specific lines.\n * Options include padding (default 10), startLine (default 0), and custom actions for specific lines.\n *\n * @example\n * ```ts\n * const formattedCode = formatCode(code, {\n *     padding: 8,\n *     startLine: 5,\n *     action: {\n *         triggerLine: 7,\n *         callback: (lineString, padding, lineNumber) => {\n *             return `Custom formatting for line ${lineNumber}: ${lineString}`;\n *         }\n *     }\n * });\n * ```\n *\n * @since 1.0.0\n */\n\nexport function formatCode(code: string, options: FormatCodeInterface = {}): string {\n    const lines = code.split('\\n');\n    const padding = options.padding ?? 10;\n    const startLine = options.startLine ?? 0;\n\n    return lines.map((lineContent, index) => {\n        const currentLineNumber = index + startLine + 1;\n        const prefix = `${ currentLineNumber} | `;\n        const string = `${ prefix.padStart(padding) }${ lineContent }`;\n\n        if (options.action && currentLineNumber === options.action.triggerLine) {\n            return options.action.callback(string, padding, currentLineNumber);\n        }\n\n        return string;\n    }).join('\\n');\n}\n\n/**\n * Formats a code snippet around an error location with special highlighting\n *\n * @param sourcePosition - An object containing information about the source code and error location\n * @param ansiOption - Optional configuration for ANSI color codes\n * @returns A formatted string representing the relevant code snippet with error highlighting\n *\n * @throws Error - If the provided sourcePosition object has invalid line or column numbers\n *\n * @remarks\n * This function takes a sourcePosition object with code content and error location information,\n * then uses formatCode to format and highlight the relevant code snippet around the error.\n * The sourcePosition object should contain code (string), line (number), column (number),\n * and optional startLine (number, defaults to 1).\n *\n * @example\n * ```ts\n * const formattedErrorCode = formatErrorCode({\n *     code: \"const x = 1;\\nconst y = x.undefined;\\n\",\n *     line: 2,\n *     column: 15,\n *     startLine: 1\n * });\n * ```\n *\n * @see formatCode - The underlying function used for basic code formatting\n *\n * @since 1.0.0\n */\n\nexport function formatErrorCode(sourcePosition: PositionWithCodeInterface, ansiOption?: AnsiOptionInterface): string {\n    const { code, line: errorLine, column: errorColumn, startLine } = sourcePosition;\n\n    // Validate line and column numbers\n    if (errorLine < startLine || errorColumn < 1) {\n        throw new Error('Invalid line or column number.');\n    }\n\n    return formatCode(code, {\n        startLine,\n        action: {\n            triggerLine: errorLine,\n            callback: (lineString, padding, line) => {\n                let pointer = '^';\n                let ansiPadding = padding - 1; // 1 size of the char we added\n                let prefixPointer = '>';\n\n                if (ansiOption) {\n                    pointer = `${ ansiOption.color }${ pointer }${ ansiOption.reset }`;\n                    ansiPadding += (ansiOption.color.length + ansiOption.reset.length);\n                    prefixPointer = `${ ansiOption.color }>${ ansiOption.reset }`;\n                }\n\n                const errorMarker = ' | '.padStart(padding) + ' '.repeat(errorColumn - 1) + `${ pointer }`;\n                lineString = `${ prefixPointer } ${ line } |`.padStart(ansiPadding) + lineString.split('|')[1];\n\n                return lineString + `\\n${ errorMarker }`;\n            }\n        }\n    });\n}\n"],
-  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,gBAAAE,EAAA,oBAAAC,IAAA,eAAAC,EAAAJ,GA0CO,SAASE,EAAWG,EAAcC,EAA+B,CAAC,EAAW,CAChF,IAAMC,EAAQF,EAAK,MAAM;AAAA,CAAI,EACvBG,EAAUF,EAAQ,SAAW,GAC7BG,EAAYH,EAAQ,WAAa,EAEvC,OAAOC,EAAM,IAAI,CAACG,EAAaC,IAAU,CACrC,IAAMC,EAAoBD,EAAQF,EAAY,EAExCI,EAAS,GADA,GAAID,CAAiB,MACV,SAASJ,CAAO,CAAE,GAAIE,CAAY,GAE5D,OAAIJ,EAAQ,QAAUM,IAAsBN,EAAQ,OAAO,YAChDA,EAAQ,OAAO,SAASO,EAAQL,EAASI,CAAiB,EAG9DC,CACX,CAAC,EAAE,KAAK;AAAA,CAAI,CAChB,CAgCO,SAASV,EAAgBW,EAA2CC,EAA0C,CACjH,GAAM,CAAE,KAAAV,EAAM,KAAMW,EAAW,OAAQC,EAAa,UAAAR,CAAU,EAAIK,EAGlE,GAAIE,EAAYP,GAAaQ,EAAc,EACvC,MAAM,IAAI,MAAM,gCAAgC,EAGpD,OAAOf,EAAWG,EAAM,CACpB,UAAAI,EACA,OAAQ,CACJ,YAAaO,EACb,SAAU,CAACE,EAAYV,EAASW,IAAS,CACrC,IAAIC,EAAU,IACVC,EAAcb,EAAU,EACxBc,EAAgB,IAEhBP,IACAK,EAAU,GAAIL,EAAW,KAAM,GAAIK,CAAQ,GAAIL,EAAW,KAAM,GAChEM,GAAgBN,EAAW,MAAM,OAASA,EAAW,MAAM,OAC3DO,EAAgB,GAAIP,EAAW,KAAM,IAAKA,EAAW,KAAM,IAG/D,IAAMQ,EAAc,MAAM,SAASf,CAAO,EAAI,IAAI,OAAOS,EAAc,CAAC,EAAI,GAAIG,CAAQ,GACxF,OAAAF,EAAa,GAAII,CAAc,IAAKH,CAAK,KAAK,SAASE,CAAW,EAAIH,EAAW,MAAM,GAAG,EAAE,CAAC,EAEtFA,EAAa;AAAA,EAAMK,CAAY,EAC1C,CACJ,CACJ,CAAC,CACL",
+  "sourceRoot": "https://github.com/remotex-lab/xmap/tree/v4.0.0/",
+  "sourcesContent": ["/**\n * Import will remove at compile time\n */\n\nimport type { PositionWithCodeInterface } from '@services/interfaces/source-service.interface';\nimport type { AnsiOptionInterface, FormatCodeInterface } from '@components/interfaces/formatter-component.interface';\n\n/**\n * Export interfaces\n */\n\nexport type * from '@components/interfaces/formatter-component.interface';\n\n/**\n * Formats a code snippet with optional line padding and custom actions\n *\n * @param code - The source code | stack to be formatted\n * @param options - Configuration options for formatting the code\n * @returns A formatted string of the code snippet with applied padding and custom actions\n *\n * @remarks\n * This function takes a code string and an options object to format the code snippet.\n * It applies padding to line numbers and can trigger custom actions for specific lines.\n * Options include padding (default 10), startLine (default 0), and custom actions for specific lines.\n *\n * @example\n * ```ts\n * const formattedCode = formatCode(code, {\n *     padding: 8,\n *     startLine: 5,\n *     action: {\n *         triggerLine: 7,\n *         callback: (lineString, padding, lineNumber) => {\n *             return `Custom formatting for line ${lineNumber}: ${lineString}`;\n *         }\n *     }\n * });\n * ```\n *\n * @since 1.0.0\n */\n\nexport function formatCode(code: string, options: FormatCodeInterface = {}): string {\n    const lines = code.split('\\n');\n    const padding = options.padding ?? 10;\n    const startLine = options.startLine ?? 0;\n\n    return lines.map((lineContent, index) => {\n        const currentLineNumber = index + startLine + 1;\n        const prefix = `${ currentLineNumber } | `;\n        const string = `${ prefix.padStart(padding) }${ lineContent }`;\n\n        if (options.action && currentLineNumber === options.action.triggerLine) {\n            return options.action.callback(string, padding, currentLineNumber);\n        }\n\n        return string;\n    }).join('\\n');\n}\n\n/**\n * Formats a code snippet around an error location with special highlighting\n *\n * @param sourcePosition - An object containing information about the source code and error location\n * @param ansiOption - Optional configuration for ANSI color codes\n * @returns A formatted string representing the relevant code snippet with error highlighting\n *\n * @throws Error - If the provided sourcePosition object has invalid line or column numbers\n *\n * @remarks\n * This function takes a sourcePosition object with code content and error location information,\n * then uses formatCode to format and highlight the relevant code snippet around the error.\n * The sourcePosition object should contain code (string), line (number), column (number),\n * and optional startLine (number, defaults to 1).\n *\n * @example\n * ```ts\n * const formattedErrorCode = formatErrorCode({\n *     code: \"const x = 1;\\nconst y = x.undefined;\\n\",\n *     line: 2,\n *     column: 15,\n *     startLine: 1\n * });\n * ```\n *\n * @see formatCode - The underlying function used for basic code formatting\n *\n * @since 1.0.0\n */\n\nexport function formatErrorCode(sourcePosition: PositionWithCodeInterface, ansiOption?: AnsiOptionInterface): string {\n    const { code, line: errorLine, column: errorColumn, startLine } = sourcePosition;\n\n    // Validate line and column numbers\n    if (errorLine < startLine || errorColumn < 1) {\n        throw new Error('Invalid line or column number.');\n    }\n\n    return formatCode(code, {\n        startLine,\n        action: {\n            triggerLine: errorLine,\n            callback: (lineString, padding, line) => {\n                let pointer = '^';\n                let ansiPadding = padding - 1; // 1 size of the char we added\n                let prefixPointer = '>';\n\n                if (ansiOption) {\n                    pointer = ansiOption.color(pointer);\n                    ansiPadding += pointer.length - 1;\n                    prefixPointer = ansiOption.color('>');\n                }\n\n                const errorMarker = ' | '.padStart(padding) + ' '.repeat(errorColumn - 1) + `${ pointer }`;\n                lineString = `${ prefixPointer } ${ line } |`.padStart(ansiPadding) + lineString.split('|')[1];\n\n                return lineString + `\\n${ errorMarker }`;\n            }\n        }\n    });\n}\n"],
+  "mappings": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,gBAAAE,EAAA,oBAAAC,IAAA,eAAAC,EAAAJ,GA0CO,SAASE,EAAWG,EAAcC,EAA+B,CAAC,EAAW,CAChF,IAAMC,EAAQF,EAAK,MAAM;AAAA,CAAI,EACvBG,EAAUF,EAAQ,SAAW,GAC7BG,EAAYH,EAAQ,WAAa,EAEvC,OAAOC,EAAM,IAAI,CAACG,EAAaC,IAAU,CACrC,IAAMC,EAAoBD,EAAQF,EAAY,EAExCI,EAAS,GADA,GAAID,CAAkB,MACX,SAASJ,CAAO,CAAE,GAAIE,CAAY,GAE5D,OAAIJ,EAAQ,QAAUM,IAAsBN,EAAQ,OAAO,YAChDA,EAAQ,OAAO,SAASO,EAAQL,EAASI,CAAiB,EAG9DC,CACX,CAAC,EAAE,KAAK;AAAA,CAAI,CAChB,CAgCO,SAASV,EAAgBW,EAA2CC,EAA0C,CACjH,GAAM,CAAE,KAAAV,EAAM,KAAMW,EAAW,OAAQC,EAAa,UAAAR,CAAU,EAAIK,EAGlE,GAAIE,EAAYP,GAAaQ,EAAc,EACvC,MAAM,IAAI,MAAM,gCAAgC,EAGpD,OAAOf,EAAWG,EAAM,CACpB,UAAAI,EACA,OAAQ,CACJ,YAAaO,EACb,SAAU,CAACE,EAAYV,EAASW,IAAS,CACrC,IAAIC,EAAU,IACVC,EAAcb,EAAU,EACxBc,EAAgB,IAEhBP,IACAK,EAAUL,EAAW,MAAMK,CAAO,EAClCC,GAAeD,EAAQ,OAAS,EAChCE,EAAgBP,EAAW,MAAM,GAAG,GAGxC,IAAMQ,EAAc,MAAM,SAASf,CAAO,EAAI,IAAI,OAAOS,EAAc,CAAC,EAAI,GAAIG,CAAQ,GACxF,OAAAF,EAAa,GAAII,CAAc,IAAKH,CAAK,KAAK,SAASE,CAAW,EAAIH,EAAW,MAAM,GAAG,EAAE,CAAC,EAEtFA,EAAa;AAAA,EAAMK,CAAY,EAC1C,CACJ,CACJ,CAAC,CACL",
   "names": ["formatter_component_exports", "__export", "formatCode", "formatErrorCode", "__toCommonJS", "code", "options", "lines", "padding", "startLine", "lineContent", "index", "currentLineNumber", "string", "sourcePosition", "ansiOption", "errorLine", "errorColumn", "lineString", "line", "pointer", "ansiPadding", "prefixPointer", "errorMarker"]
 }

package/dist/cjs/highlighter.component.js

@@ -1,2 +1,2 @@
-"use strict";var u=Object.create;var h=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var x=Object.getOwnPropertyNames;var C=Object.getPrototypeOf,K=Object.prototype.hasOwnProperty;var f=(a,e)=>{for(var t in e)h(a,t,{get:e[t],enumerable:!0})},m=(a,e,t,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of x(e))!K.call(a,i)&&i!==t&&h(a,i,{get:()=>e[i],enumerable:!(s=y(e,i))||s.enumerable});return a};var b=(a,e,t)=>(t=a!=null?u(C(a)):{},m(e||!a||!a.__esModule?h(t,"default",{value:a,enumerable:!0}):t,a)),v=a=>m(h({},"__esModule",{value:!0}),a);var T={};f(T,{CodeHighlighter:()=>d,Colors:()=>S,highlightCode:()=>w});module.exports=v(T);var r=b(require("typescript"),1),l=require("typescript"),S=(o=>(o.reset="\x1B[0m",o.gray="\x1B[38;5;243m",o.darkGray="\x1B[38;5;238m",o.lightCoral="\x1B[38;5;203m",o.lightOrange="\x1B[38;5;215m",o.oliveGreen="\x1B[38;5;149m",o.burntOrange="\x1B[38;5;208m",o.lightGoldenrodYellow="\x1B[38;5;221m",o.lightYellow="\x1B[38;5;230m",o.canaryYellow="\x1B[38;5;227m",o.deepOrange="\x1B[38;5;166m",o.lightGray="\x1B[38;5;252m",o.brightPink="\x1B[38;5;197m",o))(S||{}),E={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"},d=class{constructor(e,t,s){this.sourceFile=e;this.code=t;this.schema=s}segments=new Map;parseNode(e){this.processComments(e),this.processKeywords(e),this.processNode(e)}highlight(){let e=0,t,s=[];return Array.from(this.segments.values()).sort((n,c)=>n.start-c.start||n.end-c.end).forEach(n=>{if(t&&n.start<t.end){let c=s.pop();if(!c)return;let g=this.getSegmentSource(n.start,n.end),p=`${n.color}${g}${t.color}`;s.push(c.replace(g,p));return}s.push(this.getSegmentSource(e,n.start)),s.push(`${n.color}${this.getSegmentSource(n.start,n.end)}${n.reset}`),e=n.end,t=n}),s.join("")+this.getSegmentSource(e)}getSegmentSource(e,t){return this.code.slice(e,t)}addSegment(e,t,s,i="\x1B[0m"){let n=`${e}-${t}`;this.segments.set(n,{start:e,end:t,color:s,reset:i})}processComments(e){[...r.getTrailingCommentRanges(this.sourceFile.getFullText(),e.getFullStart())||[],...r.getLeadingCommentRanges(this.sourceFile.getFullText(),e.getFullStart())||[]].forEach(s=>this.addSegment(s.pos,s.end,this.schema.commentColor))}processKeywords(e){if([l.SyntaxKind.NullKeyword,l.SyntaxKind.VoidKeyword,l.SyntaxKind.StringKeyword,l.SyntaxKind.NumberKeyword,l.SyntaxKind.BooleanKeyword,l.SyntaxKind.UndefinedKeyword].includes(e.kind))return this.addSegment(e.getStart(),e.getEnd(),this.schema.typeColor);e&&e.kind>=r.SyntaxKind.FirstKeyword&&e.kind<=r.SyntaxKind.LastKeyword&&this.addSegment(e.getStart(),e.getEnd(),this.schema.keywordColor)}processIdentifier(e){let t=e.getEnd(),s=e.getStart();switch(e.parent.kind){case r.SyntaxKind.EnumMember:return this.addSegment(s,t,this.schema.enumColor);case r.SyntaxKind.CallExpression:case r.SyntaxKind.EnumDeclaration:case r.SyntaxKind.PropertySignature:case r.SyntaxKind.ModuleDeclaration:return this.addSegment(s,t,this.schema.variableColor);case r.SyntaxKind.InterfaceDeclaration:return this.addSegment(s,t,this.schema.interfaceColor);case r.SyntaxKind.GetAccessor:return this.addSegment(s,t,this.schema.getAccessorColor);case r.SyntaxKind.PropertyAssignment:return this.addSegment(s,t,this.schema.propertyAssignmentColor);case r.SyntaxKind.MethodSignature:return this.addSegment(s,t,this.schema.methodSignatureColor);case r.SyntaxKind.MethodDeclaration:case r.SyntaxKind.FunctionDeclaration:return this.addSegment(s,t,this.schema.functionColor);case r.SyntaxKind.ClassDeclaration:return this.addSegment(s,t,this.schema.classColor);case r.SyntaxKind.Parameter:return this.addSegment(s,t,this.schema.parameterColor);case r.SyntaxKind.VariableDeclaration:return this.addSegment(s,t,this.schema.variableColor);case r.SyntaxKind.PropertyDeclaration:return this.addSegment(s,t,this.schema.variableColor);case r.SyntaxKind.PropertyAccessExpression:return e.parent.getChildAt(0).getText()===e.getText()?this.addSegment(s,t,this.schema.variableColor):this.addSegment(s,t,this.schema.propertyAccessExpressionColor);case r.SyntaxKind.ExpressionWithTypeArguments:return this.addSegment(s,t,this.schema.expressionWithTypeArgumentsColor);case r.SyntaxKind.BreakStatement:case r.SyntaxKind.ShorthandPropertyAssignment:case r.SyntaxKind.BindingElement:return this.addSegment(s,t,this.schema.variableColor);case r.SyntaxKind.BinaryExpression:case r.SyntaxKind.SwitchStatement:case r.SyntaxKind.TemplateSpan:return this.addSegment(s,t,this.schema.variableColor);case r.SyntaxKind.TypeReference:case r.SyntaxKind.TypeAliasDeclaration:return this.addSegment(s,t,this.schema.typeColor);case r.SyntaxKind.NewExpression:return this.addSegment(s,t,this.schema.variableColor)}}processTemplateExpression(e){let t=e.head.getStart(),s=e.head.getEnd();this.addSegment(t,s,this.schema.stringColor),e.templateSpans.forEach(i=>{let n=i.literal.getStart(),c=i.literal.getEnd();this.addSegment(n,c,this.schema.stringColor)})}processNode(e){let t=e.getStart(),s=e.getEnd();switch(e.kind){case r.SyntaxKind.TypeParameter:return this.addSegment(t,t+e.name.text.length,this.schema.typeColor);case r.SyntaxKind.TypeReference:return this.addSegment(t,s,this.schema.typeColor);case r.SyntaxKind.StringLiteral:case r.SyntaxKind.NoSubstitutionTemplateLiteral:return this.addSegment(t,s,this.schema.stringColor);case r.SyntaxKind.RegularExpressionLiteral:return this.addSegment(t,s,this.schema.regularExpressionColor);case r.SyntaxKind.TemplateExpression:return this.processTemplateExpression(e);case r.SyntaxKind.Identifier:return this.processIdentifier(e);case r.SyntaxKind.BigIntLiteral:case r.SyntaxKind.NumericLiteral:return this.addSegment(t,s,this.schema.numericLiteralColor)}}};function w(a,e={}){let t=r.createSourceFile("temp.ts",a,r.ScriptTarget.Latest,!0,r.ScriptKind.TS),s=new d(t,a,Object.assign(E,e));function i(n){s.parseNode(n);for(let c=0;c<n.getChildCount();c++)i(n.getChildAt(c))}return r.forEachChild(t,i),s.highlight()}0&&(module.exports={CodeHighlighter,Colors,highlightCode});
+"use strict";var S=Object.create;var l=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var x=Object.getPrototypeOf,C=Object.prototype.hasOwnProperty;var K=(i,e)=>{for(var t in e)l(i,t,{get:e[t],enumerable:!0})},m=(i,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of y(e))!C.call(i,o)&&o!==t&&l(i,o,{get:()=>e[o],enumerable:!(n=u(e,o))||n.enumerable});return i};var f=(i,e,t)=>(t=i!=null?S(x(i)):{},m(e||!i||!i.__esModule?l(t,"default",{value:i,enumerable:!0}):t,i)),v=i=>m(l({},"__esModule",{value:!0}),i);var T={};K(T,{CodeHighlighter:()=>d,highlightCode:()=>w});module.exports=v(T);var r=f(require("typescript"),1),h=require("typescript"),a=require("@remotex-labs/xansi/xterm.component"),E={enumColor:a.xterm.burntOrange,typeColor:a.xterm.lightGoldenrodYellow,classColor:a.xterm.lightOrange,stringColor:a.xterm.oliveGreen,keywordColor:a.xterm.lightCoral,commentColor:a.xterm.darkGray,functionColor:a.xterm.lightOrange,variableColor:a.xterm.burntOrange,interfaceColor:a.xterm.lightGoldenrodYellow,parameterColor:a.xterm.deepOrange,getAccessorColor:a.xterm.lightYellow,numericLiteralColor:a.xterm.lightGray,methodSignatureColor:a.xterm.burntOrange,regularExpressionColor:a.xterm.oliveGreen,propertyAssignmentColor:a.xterm.canaryYellow,propertyAccessExpressionColor:a.xterm.lightYellow,expressionWithTypeArgumentsColor:a.xterm.lightOrange},d=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((s,c)=>s.start-c.start||s.end-c.end).forEach(s=>{if(t&&s.start<t.end){let c=n.pop();if(!c)return;let g=this.getSegmentSource(s.start,s.end),p=`${s.color(g)}`;n.push(c.replace(g,p));return}n.push(this.getSegmentSource(e,s.start)),n.push(s.color(this.getSegmentSource(s.start,s.end))),e=s.end,t=s}),n.join("")+this.getSegmentSource(e)}getSegmentSource(e,t){return this.code.slice(e,t)}addSegment(e,t,n){let o=`${e}-${t}`;this.segments.set(o,{start:e,end:t,color:n})}processComments(e){[...r.default.getTrailingCommentRanges(this.sourceFile.getFullText(),e.getFullStart())||[],...r.default.getLeadingCommentRanges(this.sourceFile.getFullText(),e.getFullStart())||[]].forEach(n=>this.addSegment(n.pos,n.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>=r.default.SyntaxKind.FirstKeyword&&e.kind<=r.default.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 r.default.SyntaxKind.EnumMember:return this.addSegment(n,t,this.schema.enumColor);case r.default.SyntaxKind.CallExpression:case r.default.SyntaxKind.EnumDeclaration:case r.default.SyntaxKind.PropertySignature:case r.default.SyntaxKind.ModuleDeclaration:return this.addSegment(n,t,this.schema.variableColor);case r.default.SyntaxKind.InterfaceDeclaration:return this.addSegment(n,t,this.schema.interfaceColor);case r.default.SyntaxKind.GetAccessor:return this.addSegment(n,t,this.schema.getAccessorColor);case r.default.SyntaxKind.PropertyAssignment:return this.addSegment(n,t,this.schema.propertyAssignmentColor);case r.default.SyntaxKind.MethodSignature:return this.addSegment(n,t,this.schema.methodSignatureColor);case r.default.SyntaxKind.MethodDeclaration:case r.default.SyntaxKind.FunctionDeclaration:return this.addSegment(n,t,this.schema.functionColor);case r.default.SyntaxKind.ClassDeclaration:return this.addSegment(n,t,this.schema.classColor);case r.default.SyntaxKind.Parameter:return this.addSegment(n,t,this.schema.parameterColor);case r.default.SyntaxKind.VariableDeclaration:return this.addSegment(n,t,this.schema.variableColor);case r.default.SyntaxKind.PropertyDeclaration:return this.addSegment(n,t,this.schema.variableColor);case r.default.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 r.default.SyntaxKind.ExpressionWithTypeArguments:return this.addSegment(n,t,this.schema.expressionWithTypeArgumentsColor);case r.default.SyntaxKind.BreakStatement:case r.default.SyntaxKind.ShorthandPropertyAssignment:case r.default.SyntaxKind.BindingElement:return this.addSegment(n,t,this.schema.variableColor);case r.default.SyntaxKind.BinaryExpression:case r.default.SyntaxKind.SwitchStatement:case r.default.SyntaxKind.TemplateSpan:return this.addSegment(n,t,this.schema.variableColor);case r.default.SyntaxKind.TypeReference:case r.default.SyntaxKind.TypeAliasDeclaration:return this.addSegment(n,t,this.schema.typeColor);case r.default.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(o=>{let s=o.literal.getStart(),c=o.literal.getEnd();this.addSegment(s,c,this.schema.stringColor)})}processNode(e){let t=e.getStart(),n=e.getEnd();switch(e.kind){case r.default.SyntaxKind.TypeParameter:return this.addSegment(t,t+e.name.text.length,this.schema.typeColor);case r.default.SyntaxKind.TypeReference:return this.addSegment(t,n,this.schema.typeColor);case r.default.SyntaxKind.StringLiteral:case r.default.SyntaxKind.NoSubstitutionTemplateLiteral:return this.addSegment(t,n,this.schema.stringColor);case r.default.SyntaxKind.RegularExpressionLiteral:return this.addSegment(t,n,this.schema.regularExpressionColor);case r.default.SyntaxKind.TemplateExpression:return this.processTemplateExpression(e);case r.default.SyntaxKind.Identifier:return this.processIdentifier(e);case r.default.SyntaxKind.BigIntLiteral:case r.default.SyntaxKind.NumericLiteral:return this.addSegment(t,n,this.schema.numericLiteralColor)}}};function w(i,e={}){let t=r.default.createSourceFile("temp.ts",i,r.default.ScriptTarget.Latest,!0,r.default.ScriptKind.TS),n=new d(t,i,Object.assign(E,e));function o(s){n.parseNode(s);for(let c=0;c<s.getChildCount();c++)o(s.getChildAt(c))}return r.default.forEachChild(t,o),n.highlight()}0&&(module.exports={CodeHighlighter,highlightCode});
 //# sourceMappingURL=highlighter.component.js.map