@remotex-labs/xmap 1.0.0

package/dist/components/highlighter.component.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Import will remove at compile time
+ */
+import type { HighlightSchemeInterface } from './interfaces/highlighter.interface';
+/**
+ * Imports
+ */
+import * as ts from 'typescript';
+/**
+ * An enum containing ANSI escape sequences for various colors.
+ *
+ * This enum is primarily intended for terminal output and won't work directly in JavaScript for web development.
+ * It defines color codes for various colors and a reset code to return to
+ * the default text color.
+ *
+ * @example
+ * ```typescript
+ * console.log(`${Colors.red}This the text will be red in the terminal.${Colors.reset}`);
+ * ```
+ *
+ * This functionality is limited to terminal environments.
+ * Consider alternative methods
+ * for color highlighting in web development contexts, such as CSS classes.
+ */
+export declare const enum Colors {
+    reset = "\u001B[0m",
+    gray = "\u001B[38;5;243m",
+    darkGray = "\u001B[38;5;238m",
+    lightCoral = "\u001B[38;5;203m",
+    lightOrange = "\u001B[38;5;215m",
+    oliveGreen = "\u001B[38;5;149m",
+    burntOrange = "\u001B[38;5;208m",
+    lightGoldenrodYellow = "\u001B[38;5;221m",
+    lightYellow = "\u001B[38;5;230m",
+    canaryYellow = "\u001B[38;5;227m",
+    deepOrange = "\u001B[38;5;166m",
+    lightGray = "\u001B[38;5;252m",
+    brightPink = "\u001B[38;5;197m"
+}
+/**
+ * Class responsible for applying semantic highlighting to a source code string based on a given color scheme.
+ *
+ * @class
+ *
+ * @param sourceFile - The TypeScript AST node representing the source file.
+ * @param code - The source code string to be highlighted.
+ * @param schema - The color scheme used for highlighting different elements in the code.
+ *
+ * const highlighter = new CodeHighlighter(sourceFile, code, schema);
+ */
+export declare class CodeHighlighter {
+    private sourceFile;
+    private code;
+    private schema;
+    /**
+     * A Map of segments where the key is a combination of start and end positions,
+     * and the value is an object containing the color and reset code.
+     * This structure ensures unique segments and allows for fast lookups and updates.
+     *
+     * @example
+     * this.segments = new Map([
+     *   ['0-10', { start: 1, end: 11, color: '\x1b[31m', reset: '\x1b[0m' }],
+     *   ['11-20', { start: 12, end: 20, color: '\x1b[32m', reset: '\x1b[0m' }]
+     * ]);
+     */
+    private segments;
+    /**
+     * Creates an instance of the CodeHighlighter class.
+     *
+     * @param sourceFile - The TypeScript AST node representing the source file.
+     * @param code - The source code string to be highlighted.
+     * @param schema - The color scheme used for highlighting different elements in the code.
+     */
+    constructor(sourceFile: ts.Node, code: string, schema: HighlightSchemeInterface);
+    /**
+     * Parses a TypeScript AST node and processes its comments to identify segments that need highlighting.
+     *
+     * @param node - The TypeScript AST node to be parsed.
+     */
+    parseNode(node: ts.Node): void;
+    /**
+     * Generates a string with highlighted code segments based on the provided color scheme.
+     *
+     * This method processes the stored segments, applies the appropriate colors to each segment,
+     * and returns the resulting highlighted code as a single string.
+     *
+     * @returns The highlighted code as a string, with ANSI color codes applied to the segments.
+     */
+    highlight(): string;
+    /**
+     * Extracts a substring from the code based on the specified start and end positions.
+     *
+     * This method is used to retrieve the source code segment that corresponds to the
+     * given start and end positions. It is primarily used for highlighting specific
+     * segments of the code.
+     *
+     * @param start - The starting index of the segment to be extracted.
+     * @param end - The ending index of the segment to be extracted.
+     * @returns The extracted substring from the code.
+     */
+    private getSegmentSource;
+    /**
+     * Adds a new segment to the list of segments to be highlighted.
+     * The segment is defined by its start and end positions, the color to apply, and an optional reset code.
+     *
+     * @param start - The starting index of the segment in the code string.
+     * @param end - The ending index of the segment in the code string.
+     * @param color - The color code to apply to the segment.
+     * @param reset - The color reset code to apply after the segment, Defaults to the reset code defined in `Colors.reset`.
+     */
+    private addSegment;
+    /**
+     * Processes comments within a TypeScript AST node and adds segments for highlighting.
+     * Extracts trailing and leading comments from the node and adds them as segments using the color defined in `this.colorSchema.comments`.
+     *
+     * @param node - The TypeScript AST node whose comments are to be processed.
+     */
+    private processComments;
+    /**
+     * Processes the keywords within a TypeScript AST node and adds them as segments for highlighting.
+     *
+     * This method identifies potential keyword tokens within the provided node and adds them to the
+     * list of segments with the color defined in `this.schema.keywordColor`.
+     * The method considers the current node, its first token, and its last token to determine if they should be highlighted
+     * as keywords.
+     *
+     * The method checks if the node's kind falls within the range of keyword kinds defined by TypeScript.
+     * If the node or any of its tokens are identified as keywords, a segment is added to `this.segments`
+     * with the start and end positions of the node and the specified color for keywords.
+     *
+     * @param  node - The TypeScript AST node to be processed for keywords.
+     */
+    private processKeywords;
+    /**
+     * Processes identifiers within a TypeScript AST node and adds them as segments for highlighting
+     * based on the node's parent type.
+     *
+     * This method determines the appropriate color for an identifier based on its parent node's kind.
+     * If the parent node matches one of the specified kinds, the identifier is highlighted with a cyan color.
+     * Supported parent kinds include various declarations, expressions, and signatures.
+     *
+     * @param node - The TypeScript AST node representing the identifier to be processed.
+     */
+    private processIdentifier;
+    /**
+     * Processes a TypeScript template expression and adds segments for highlighting its literal parts.
+     *
+     * This method adds a segment for the head of the template expression with the color specified in `this.schema.stringColor`.
+     * It also processes each template span within the expression, adding
+     * segments for each span's literal part.
+     *
+     * @param templateExpression - The TypeScript template expression to be processed.
+     */
+    private processTemplateExpression;
+    /**
+     * Processes a TypeScript AST node and adds segments for highlighting based on the node's kind.
+     *
+     * This method identifies the kind of the node and determines the appropriate color for highlighting.
+     * It handles various node kinds including string literals, regular expressions, template expressions, and identifiers.
+     * Specific methods are invoked for more complex node kinds, such as template expressions and identifiers.
+     *
+     * @param  node - The TypeScript AST node to be processed.
+     */
+    private processNode;
+}
+/**
+ * Applies semantic highlighting to the provided code string using the specified color scheme.
+ *
+ * @param code - The source code to be highlighted.
+ * @param schema - An optional partial schema defining the color styles for various code elements.
+ *                 Defaults to an empty object, which means no specific highlighting will be applied.
+ *
+ * @returns A string with the code elements wrapped in the appropriate color styles as specified by the schema.
+ *
+ * @example
+ * const code = 'const x: number = 42;';
+ * const schema = {
+ *   keywordColor: '\x1b[34m', // Blue
+ *   stringColor: '\x1b[32m',  // Green
+ *   numberColor: '\x1b[31m',  // Red
+ *   reset: '\x1b[0m'          // Reset
+ * };
+ * const highlightedCode = highlightCode(code, schema);
+ * console.log(highlightedCode);
+ */
+export declare function highlightCode(code: string, schema?: Partial<HighlightSchemeInterface>): string;

package/dist/components/interfaces/formatter.interface.d.ts

@@ -0,0 +1,42 @@
+/**
+ * A callback function type used for formatting code lines.
+ *
+ * @param lineString - The content of the line to be formatted.
+ * @param padding - The amount of padding to be applied to the line.
+ * @param line - The line number of the line to be formatted.
+ * @returns The formatted line string.
+ */
+export type FormatCodeCallbackType = (lineString: string, padding: number, line: number) => string;
+/**
+ * Configuration options for formatting code.
+ */
+export interface FormatCodeInterface {
+    /**
+     * The amount of padding to be applied to each line. If not specified, defaults to 0.
+     */
+    padding?: number;
+    /**
+     * The starting line number for formatting. If not specified, defaults to 1.
+     */
+    startLine?: number;
+    /**
+     * An optional action object specifying a line where a callback function should be triggered.
+     */
+    action?: {
+        /**
+         * The line number at which the callback function should be triggered.
+         */
+        triggerLine: number;
+        /**
+         * The callback function to be executed when the trigger line is encountered.
+         */
+        callback: FormatCodeCallbackType;
+    };
+}
+/**
+ * Set color to an error pointer
+ */
+export interface AnsiOptionInterface {
+    color: string;
+    reset: string;
+}

package/dist/components/interfaces/highlighter.interface.d.ts

@@ -0,0 +1,48 @@
+/**
+ * HighlightSchemeInterface defines the structure for a color style schema
+ * used in semantic highlighting.
+ * This interface ensures that the highlighting styles are consistent and easily configurable.
+ */
+export interface HighlightSchemeInterface {
+    enumColor: string;
+    typeColor: string;
+    classColor: string;
+    stringColor: string;
+    keywordColor: string;
+    commentColor: string;
+    functionColor: string;
+    variableColor: string;
+    interfaceColor: string;
+    parameterColor: string;
+    getAccessorColor: string;
+    numericLiteralColor: string;
+    methodSignatureColor: string;
+    regularExpressionColor: string;
+    propertyAssignmentColor: string;
+    propertyAccessExpressionColor: string;
+    expressionWithTypeArgumentsColor: string;
+}
+/**
+ * Represents a segment of a code string that needs to be highlighted.
+ *
+ * @interface
+ *
+ * @property start - The starting index of the segment in the code string.
+ * @property end - The ending index of the segment in the code string.
+ * @property color - The color code to apply to the segment.
+ * @property reset - The color reset code to apply after the segment.
+ *
+ * @example
+ * const segment: HighlightNodeSegment = {
+ *   start: 0,
+ *   end: 10,
+ *   color: '\x1b[31m', // Red
+ *   reset: '\x1b[0m' // Reset
+ * };
+ */
+export interface HighlightNodeSegmentInterface {
+    end: number;
+    start: number;
+    color: string;
+    reset: string;
+}

package/dist/components/interfaces/parse.interface.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Represents an entry in the stack trace.
+ */
+export interface StackInterface {
+    /**
+     * The function or method where the error occurred.
+     */
+    at: string;
+    /**
+     * The file path where the error occurred.
+     */
+    file: string;
+    /**
+     * The line number where the error occurred.
+     */
+    line: number;
+    /**
+     * The column number where the error occurred.
+     */
+    column: number;
+}
+/**
+ * Represents a detailed entry in the stack trace, which may include an executor stack entry.
+ */
+export interface StackEntryInterface extends StackInterface {
+    /**
+     * The executor information if the error occurred within an eval function.
+     * This will be `null` if the error did not occur within an eval function.
+     */
+    executor?: StackInterface | null;
+}

package/dist/components/parser.component.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Import will remove at compile time
+ */
+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.
+ *
+ * @param stackString - The error stack trace.
+ * @returns The parsed stack trace object.
+ */
+export declare function parseErrorStack(stackString: string): Array<StackEntryInterface>;

package/dist/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/index.js

@@ -0,0 +1,9 @@
+function w(l){let e=l.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 i=s.match(n);if(!i)return;let a=i.slice(1);i[2]||(a=i.slice(4));let[c,m,g,p]=a,h=parseInt(g,10),d=parseInt(p,10);if(s.includes("eval")){let S=m.match(t)?.slice(1);if(S){let[v,L,N,E,K]=S;r.push({at:c,file:K,line:h,column:d,executor:{at:v,file:L,line:parseInt(N,10),column:parseInt(E,10)}});return}}r.push({at:c||"<anonymous>",file:m,line:h,column:d,executor:null})}),r}var x={},y="ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/".split("");y.forEach((l,e)=>{x[l]=e});function A(l){let e=l<0,n="",t=e?(-l<<1)+1:l<<1;do{let r=t&31;t>>>=5,n+=y[r|(t>0?32:0)]}while(t>0);return n}function I(l){return l.map(A).join("")}function C(l){let e=[],n=0,t=0;for(let r=0;r<l.length;r++){let s=x[l[r]];if(s===void 0)throw new Error(`Invalid Base64 character: ${l[r]}`);let i=s&32;if(t+=(s&31)<<n,i)n+=5;else{let a=(t&1)===1,c=t>>1;e.push(a?-c:c),t=n=0}}return e}function M(l,e={}){let n=l.split(`
+`),t=e.padding??10,r=e.startLine??0;return n.map((s,i)=>{let a=i+r+1,m=`${`${a} | `.padStart(t)}${s}`;return e.action&&a===e.action.triggerLine?e.action.callback(m,t,a):m}).join(`
+`)}function $(l,e){let{code:n,line:t,column:r,startLine:s}=l;if(t<s||r<1)throw new Error("Invalid line or column number.");return M(n,{startLine:s,action:{triggerLine:t,callback:(i,a,c)=>{let m="^",g=a-1,p=">";e&&(m=`${e.color}${m}${e.reset}`,g+=e.color.length+e.reset.length,p=`${e.color}>${e.reset}`);let h=" | ".padStart(a)+" ".repeat(r-1)+`${m}`;return i=`${p} ${c} |`.padStart(g)+i.split("|")[1],i+`
+${h}`}}})}import*as o from"typescript";import{SyntaxKind as u}from"typescript";var O=(d=>(d.reset="\x1B[0m",d.gray="\x1B[38;5;243m",d.darkGray="\x1B[38;5;238m",d.lightCoral="\x1B[38;5;203m",d.lightOrange="\x1B[38;5;215m",d.oliveGreen="\x1B[38;5;149m",d.burntOrange="\x1B[38;5;208m",d.lightGoldenrodYellow="\x1B[38;5;221m",d.lightYellow="\x1B[38;5;230m",d.canaryYellow="\x1B[38;5;227m",d.deepOrange="\x1B[38;5;166m",d.lightGray="\x1B[38;5;252m",d.brightPink="\x1B[38;5;197m",d))(O||{}),T={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"},f=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,i)=>s.start-i.start||s.end-i.end).forEach(s=>{if(n&&s.start<n.end){let i=t.pop();if(!i)return;let a=this.getSegmentSource(s.start,s.end),c=`${s.color}${a}${n.color}`;t.push(i.replace(a,c));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([u.NullKeyword,u.VoidKeyword,u.StringKeyword,u.NumberKeyword,u.BooleanKeyword,u.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(),i=r.literal.getEnd();this.addSegment(s,i,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 U(l,e={}){let n=o.createSourceFile("temp.ts",l,o.ScriptTarget.Latest,!0,o.ScriptKind.TS),t=new f(n,l,Object.assign(T,e));function r(s){t.parseNode(s);for(let i=0;i<s.getChildCount();i++)r(s.getChildAt(i))}return o.forEachChild(n,r),t.highlight()}var b=class{names;sources;mappings;sourcesContent;constructor(e){this.validateSourceMap(e),this.names=e.names??[],this.sources=e.sources??[],this.mappings=[],this.sourcesContent=e.sourcesContent??[],this.decodeMappings(e)}getMapObject(){return{version:3,names:this.names,sources:this.sources,mappings:this.encodeMappings(this.mappings),sourcesContent:this.sourcesContent}}getSourcePosition(e,n,t){let r=Object.assign({bias:1,linesAfter:4,linesBefore:3},t),s=this.findMapping(e,n,r.bias);if(!s||isNaN(s.fileIndex))return null;let i=this.sourcesContent[s.fileIndex].split(`
+`),a=(s.sourceLine??1)+r.linesAfter,c=Math.max((s.sourceLine??1)-r.linesBefore,0);return{code:i.slice(c,Math.min(a+1,i.length)).join(`
+`),line:s.sourceLine,column:s.sourceColumn,endLine:a,startLine:c,name:this.names[s.nameIndex??-1]??null,source:this.sources[s.fileIndex]}}getPosition(e,n,t=1){let r=this.findMapping(e,n,t);return r&&{line:r.sourceLine,column:r.sourceColumn,name:this.names[r.nameIndex??-1]??null,source:this.sources[r.fileIndex]}}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],{nameIndex:this.names.length-1,fileIndex:this.sources.length-1,generatedLine:r<2?2:r})}}toString(){return JSON.stringify(this.getMapObject())}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.mappings.split(";").entries()){if(!s)continue;t.generatedColumn=1;let i=s.split(",");for(let a of i){if(a.length<4)continue;let c=C(a);this.decodedSegment(t,c,r+t.generatedLine)}}}catch(r){throw new Error(`Error decoding mappings: ${r.message}`)}}decodedSegment(e,n,t){let[r,s,i,a,c]=n;e.fileIndex+=s,e.nameIndex+=c??0,e.sourceLine+=i,e.sourceColumn+=a,e.generatedColumn+=r,this.mappings.push({nameIndex:c!==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 i=e.nameIndex;r[4]=i-t.nameIndex,t.nameIndex=i}t.sourceLine=e.sourceLine,t.sourceColumn=e.sourceColumn,t.generatedColumn=e.generatedColumn,n.push(I(r))}findMapping(e,n,t=0){let r=0,s=this.mappings.length-1,i=null;for(;r<=s;){let a=Math.floor((r+s)/2),c=this.mappings[a];if(c.generatedLine<e)r=a+1;else if(c.generatedLine>e)s=a-1;else if(c.generatedColumn<n)r=a+1,t===1&&(i=c);else if(c.generatedColumn>n)s=a-1,t===2&&(i=c);else return c}return i&&i.generatedLine===e?i:null}};export{f as CodeHighlighter,O as Colors,b as SourceService,C as decodeVLQ,I as encodeArrayVLQ,A as encodeVLQ,M as formatCode,$ as formatErrorCode,U as highlightCode,w as parseErrorStack};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/components/parser.component.ts", "../src/components/base64.component.ts", "../src/components/formatter.component.ts", "../src/components/highlighter.component.ts", "../src/services/source.service.ts"],
+  "sourcesContent": ["/**\n * Import will remove at compile time\n */\n\nimport type { StackEntryInterface } from '@components/interfaces/parse.interface';\n\n/**\n * Parses an error stack trace and returns an object with a message and an array of stack entries.\n *\n * @param stackString - The error stack trace.\n * @returns The parsed stack trace object.\n */\n\nexport function parseErrorStack(stackString: string): Array<StackEntryInterface> {\n    const lines = stackString.split('\\n').slice(1);\n    const regex = /^\\s*at\\s+(.*?)\\s+\\((.*?):(\\d+):(\\d+)\\)$|^\\s*at\\s+(.*?):(\\d+):(\\d+)$/;\n    const evalRegex = /eval\\s+at\\s+([^\\s(]+).+\\((.+):(\\d+):(\\d+)\\),\\s(.+)/;\n    const stack: Array<StackEntryInterface> = [];\n\n    lines.forEach((line) => {\n        const match = line.match(regex);\n        if (!match) return;\n\n        let args: Array<string> = match.slice(1);\n        if(!match[2]) {\n            args = match.slice(4);\n        }\n\n        const [ at, file, lineNum, colNum ] = args;\n        const lineNumber = parseInt(lineNum, 10);\n        const columnNumber = parseInt(colNum, 10);\n\n        if (line.includes('eval')) {\n            const evalMatch = file.match(evalRegex)?.slice(1);\n            if (evalMatch) {\n                const [ evalAt, evalFile, evalLineNum, evalColNum, evalAnonFile ] = evalMatch;\n                stack.push({\n                    at,\n                    file: evalAnonFile,\n                    line: lineNumber,\n                    column: columnNumber,\n                    executor: {\n                        at: evalAt,\n                        file: evalFile,\n                        line: parseInt(evalLineNum, 10),\n                        column: parseInt(evalColNum, 10)\n                    }\n                });\n\n                return;\n            }\n        }\n\n        stack.push({\n            at: at || '<anonymous>',\n            file,\n            line: lineNumber,\n            column: columnNumber,\n            executor: null\n        });\n    });\n\n    return stack;\n}\n", "// Bitmask to extract the lower 5 bits (continuation bit removed) - 0b11111\nconst CONTINUATION_BIT_REMOVE = 0x1F;\n\n// Bitmask to set the continuation bit - 0b100000\nconst CONTINUATION_BIT_POSITION = 0x20;\n\n// Mapping of Base64 characters to their indices\nconst base64Map: { [key: string]: number } = {};\n\n// Array of Base64 characters\nconst base64Chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/'.split('');\n\n// Populate the base64Map with characters and their corresponding indices\nbase64Chars.forEach((char, index) => {\n    base64Map[char] = index;\n});\n\n/**\n * Encodes a given number using Variable-Length Quantity (VLQ) encoding.\n * Negative numbers are encoded by converting to a non-negative representation.\n * The continuation bit is used to indicate if more bytes follow.\n *\n * @param value - The number to be encoded.\n * @returns The VLQ encoded string.\n */\n\nexport function encodeVLQ(value: number): string {\n    const isNegative = value < 0;\n\n    /**\n     * Bit Structure Representation:\n     *\n     * +--------------------------+\n     * | C |   Value       | Sign |\n     * +---+---+---+---+---+------+\n     * | 1 | 1 | 0 | 0 | 1 |   0  |\n     * +---+---+---+---+---+------+\n     */\n\n    let encoded = '';\n    let vlq = isNegative ? ((-value) << 1) + 1 : (value << 1); // Shift left by 1 bit to encode the sign bit\n\n    do {\n        const digit = vlq & CONTINUATION_BIT_REMOVE; // Extract lower 5 bits\n        vlq >>>= 5; // Right shift by 5 bits to process next chunk\n        encoded += base64Chars[digit | (vlq > 0 ? CONTINUATION_BIT_POSITION : 0)]; // Combine digit and continuation bit\n    } while (vlq > 0);\n\n    return encoded;\n}\n\n/**\n * Encodes an array of numbers using VLQ encoding.\n * Each number in the array is individually encoded and the results are concatenated.\n *\n * @param values - The array of numbers to be encoded.\n * @returns The concatenated VLQ encoded string.\n */\n\nexport function encodeArrayVLQ(values: number[]): string {\n    return values.map(encodeVLQ).join('');\n}\n\n/**\n * Decodes a VLQ encoded string back into an array of numbers.\n * Each character is decoded using the Base64 map and continuation bits are processed.\n *\n * @param data - The VLQ encoded string.\n * @returns The array of decoded numbers.\n * @throws Error If the string contains invalid Base64 characters.\n */\n\nexport function decodeVLQ(data: string): number[] {\n    const result = [];\n    let shift = 0;\n    let value = 0;\n\n    for (let i = 0; i < data.length; i++) {\n        const digit = base64Map[data[i]];\n        if (digit === undefined) {\n            throw new Error(`Invalid Base64 character: ${data[i]}`);\n        }\n\n        const continuation = digit & CONTINUATION_BIT_POSITION; // Check if continuation bit is set\n        value += (digit & CONTINUATION_BIT_REMOVE) << shift; // Add lower 5 bits to value\n        if (continuation) {\n            shift += 5; // Shift left by 5 for next chunk\n        } else {\n            const isNegative = (value & 1) === 1; // Check if the number is negative\n            const shifted = value >> 1; // Remove the sign bit\n\n            result.push(isNegative ? -shifted : shifted); // Convert back to signed integer\n            value = shift = 0; // Reset for next number\n        }\n    }\n\n    return result;\n}\n", "/**\n * Import will remove at compile time\n */\n\nimport type { PositionSourceInterface } from '@services/interfaces/source.interface';\nimport type { AnsiOptionInterface, FormatCodeInterface } from '@components/interfaces/formatter.interface';\n\n/**\n * Formats a code snippet with optional line padding and custom actions.\n *\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 *\n * @param code - The source code | stack to be formatted.\n * @param options - Configuration options for formatting the code.\n *   - `padding` (number, optional): Number of characters for line number padding. Defaults to 10.\n *   - `startLine` (number, optional): The starting line number for formatting. Defaults to 1.\n *   - `action` (object, optional): Custom actions to apply to specific lines.\n *     - `triggerLine` (number): The line number where the action should be triggered.\n *     - `callback` (function): A callback function to format the line string when `triggerLine` is matched.\n *       The callback receives the formatted line string, the padding value, and the current line number as arguments.\n *\n * @returns A formatted string of the code snippet with applied padding and custom actions.\n *\n * @example\n * ```typescript\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 * console.log(formattedCode);\n * ```\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 * This function takes a `sourcePosition` object containing information about the source code\n * and error location, then uses `formatCode` to format and highlight the relevant code snippet.\n *\n * @param sourcePosition - An object containing information about the source code and error location.\n *   - `code` (string): The entire source code content.\n *   - `line` (number): The line number where the error occurred (1-based indexing).\n *   - `column` (number): The column number within the line where the error occurred (1-based indexing).\n *   - `startLine` (number, optional): The starting line number of the code snippet (defaults to 1).\n * @param ansiOption - Optional configuration for ANSI color codes.\n *   - `color` (string): The ANSI escape sequence to colorize the error marker and prefix (e.g., `'\\x1b[38;5;160m'`).\n *   - `reset` (string): The ANSI escape sequence to reset the color (e.g., `'\\x1b[0m'`).\n *\n * @throws Error - If the provided `sourcePosition` object has invalid line or column numbers,\n *                  or if the error line is outside the boundaries of the provided code content.\n *\n * @returns A formatted string representing the relevant code snippet around the error location,\n *          including special highlighting for the error line and column.\n *\n * @example\n * ```typescript\n * const formattedErrorCode = formatErrorCode(sourcePosition);\n * console.log(formattedErrorCode);\n * ```\n */\n\nexport function formatErrorCode(sourcePosition: PositionSourceInterface, 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", "/**\n * Import will remove at compile time\n */\n\nimport type { HighlightSchemeInterface, HighlightNodeSegmentInterface } from '@components/interfaces/highlighter.interface';\n\n/**\n * Imports\n */\n\nimport * as ts from 'typescript';\nimport { SyntaxKind } from 'typescript';\n\n/**\n * An enum containing ANSI escape sequences for various colors.\n *\n * This enum is primarily intended for terminal output and won't work directly in JavaScript for web development.\n * It defines color codes for various colors and a reset code to return to\n * the default text color.\n *\n * @example\n * ```typescript\n * console.log(`${Colors.red}This the text will be red in the terminal.${Colors.reset}`);\n * ```\n *\n * This functionality is limited to terminal environments.\n * Consider alternative methods\n * for color highlighting in web development contexts, such as CSS classes.\n */\n\nexport const enum Colors {\n    reset = '\\x1b[0m',\n    gray = '\\x1b[38;5;243m',\n    darkGray = '\\x1b[38;5;238m',\n    lightCoral = '\\x1b[38;5;203m',\n    lightOrange = '\\x1b[38;5;215m',\n    oliveGreen = '\\x1b[38;5;149m',\n    burntOrange = '\\x1b[38;5;208m',\n    lightGoldenrodYellow = '\\x1b[38;5;221m',\n    lightYellow = '\\x1b[38;5;230m',\n    canaryYellow = '\\x1b[38;5;227m',\n    deepOrange = '\\x1b[38;5;166m',\n    lightGray = '\\x1b[38;5;252m',\n    brightPink = '\\x1b[38;5;197m'\n}\n\n/**\n * Default color scheme for semantic highlighting.\n * This scheme uses red color for all code elements.\n *\n * @example\n * const scheme = defaultScheme;\n * console.log(scheme.typeColor); // Outputs: the red color code\n */\n\n\nconst defaultScheme: HighlightSchemeInterface = {\n    enumColor: Colors.burntOrange,\n    typeColor: Colors.lightGoldenrodYellow,\n    classColor: Colors.lightOrange,\n    stringColor: Colors.oliveGreen,\n    keywordColor: Colors.lightCoral,\n    commentColor: Colors.darkGray,\n    functionColor: Colors.lightOrange,\n    variableColor: Colors.burntOrange,\n    interfaceColor: Colors.lightGoldenrodYellow,\n    parameterColor: Colors.deepOrange,\n    getAccessorColor: Colors.lightYellow,\n    numericLiteralColor: Colors.lightGray,\n    methodSignatureColor: Colors.burntOrange,\n    regularExpressionColor: Colors.oliveGreen,\n    propertyAssignmentColor: Colors.canaryYellow,\n    propertyAccessExpressionColor: Colors.lightYellow,\n    expressionWithTypeArgumentsColor: Colors.lightOrange\n};\n\n/**\n * Class responsible for applying semantic highlighting to a source code string based on a given color scheme.\n *\n * @class\n *\n * @param sourceFile - The TypeScript AST node representing the source file.\n * @param code - The source code string to be highlighted.\n * @param schema - The color scheme used for highlighting different elements in the code.\n *\n * const highlighter = new CodeHighlighter(sourceFile, code, schema);\n */\n\nexport class CodeHighlighter {\n\n    /**\n     * A Map of segments where the key is a combination of start and end positions,\n     * and the value is an object containing the color and reset code.\n     * This structure ensures unique segments and allows for fast lookups and updates.\n     *\n     * @example\n     * this.segments = new Map([\n     *   ['0-10', { start: 1, end: 11, color: '\\x1b[31m', reset: '\\x1b[0m' }],\n     *   ['11-20', { start: 12, end: 20, color: '\\x1b[32m', reset: '\\x1b[0m' }]\n     * ]);\n     */\n\n    private segments: Map<string, HighlightNodeSegmentInterface> = new Map();\n\n    /**\n     * Creates an instance of the CodeHighlighter class.\n     *\n     * @param sourceFile - The TypeScript AST node representing the source file.\n     * @param code - The source code string to be highlighted.\n     * @param schema - The color scheme used for highlighting different elements in the code.\n     */\n\n    constructor(private sourceFile: ts.Node, private code: string, private schema: HighlightSchemeInterface) {\n    }\n\n    /**\n     * Parses a TypeScript AST node and processes its comments to identify segments that need highlighting.\n     *\n     * @param node - The TypeScript AST node to be parsed.\n     */\n\n    parseNode(node: ts.Node): void {\n        this.processComments(node);\n        this.processKeywords(node);\n        this.processNode(node);\n    }\n\n    /**\n     * Generates a string with highlighted code segments based on the provided color scheme.\n     *\n     * This method processes the stored segments, applies the appropriate colors to each segment,\n     * and returns the resulting highlighted code as a single string.\n     *\n     * @returns The highlighted code as a string, with ANSI color codes applied to the segments.\n     */\n\n    highlight(): string {\n        let previousSegmentEnd = 0;\n        let parent: HighlightNodeSegmentInterface | undefined;\n\n        const result: Array<string> = [];\n        const segments = Array.from(\n            this.segments.values()\n        ).sort((a, b) => a.start - b.start || a.end - b.end);\n\n        segments.forEach((segment) => {\n            if (parent && segment.start < parent.end) {\n                const lastSegment = result.pop();\n                if (!lastSegment) return;\n\n                const source = this.getSegmentSource(segment.start, segment.end);\n                const combinedSource = `${ segment.color }${ source }${ parent.color }`;\n                result.push(lastSegment.replace(source, combinedSource));\n\n                return;\n            }\n\n            result.push(this.getSegmentSource(previousSegmentEnd, segment.start));\n            result.push(`${ segment.color }${ this.getSegmentSource(segment.start, segment.end) }${ segment.reset }`);\n            previousSegmentEnd = segment.end;\n            parent = segment;\n        });\n\n        return result.join('') + this.getSegmentSource(previousSegmentEnd);\n    }\n\n    /**\n     * Extracts a substring from the code based on the specified start and end positions.\n     *\n     * This method is used to retrieve the source code segment that corresponds to the\n     * given start and end positions. It is primarily used for highlighting specific\n     * segments of the code.\n     *\n     * @param start - The starting index of the segment to be extracted.\n     * @param end - The ending index of the segment to be extracted.\n     * @returns The extracted substring from the code.\n     */\n\n    private getSegmentSource(start: number, end?: number): string {\n        return this.code.slice(start, end);\n    }\n\n    /**\n     * Adds a new segment to the list of segments to be highlighted.\n     * The segment is defined by its start and end positions, the color to apply, and an optional reset code.\n     *\n     * @param start - The starting index of the segment in the code string.\n     * @param end - The ending index of the segment in the code string.\n     * @param color - The color code to apply to the segment.\n     * @param reset - The color reset code to apply after the segment, Defaults to the reset code defined in `Colors.reset`.\n     */\n\n    private addSegment(start: number, end: number, color: string, reset: string = Colors.reset) {\n        const key = `${ start }-${ end }`;\n        this.segments.set(key, { start, end, color, reset });\n    }\n\n    /**\n     * Processes comments within a TypeScript AST node and adds segments for highlighting.\n     * Extracts trailing and leading comments from the node and adds them as segments using the color defined in `this.colorSchema.comments`.\n     *\n     * @param node - The TypeScript AST node whose comments are to be processed.\n     */\n\n    private processComments(node: ts.Node): void {\n        const comments = [\n            ...ts.getTrailingCommentRanges(this.sourceFile.getFullText(), node.getFullStart()) || [],\n            ...ts.getLeadingCommentRanges(this.sourceFile.getFullText(), node.getFullStart()) || []\n        ];\n\n        comments.forEach(comment => this.addSegment(comment.pos, comment.end, this.schema.commentColor));\n    }\n\n    /**\n     * Processes the keywords within a TypeScript AST node and adds them as segments for highlighting.\n     *\n     * This method identifies potential keyword tokens within the provided node and adds them to the\n     * list of segments with the color defined in `this.schema.keywordColor`.\n     * The method considers the current node, its first token, and its last token to determine if they should be highlighted\n     * as keywords.\n     *\n     * The method checks if the node's kind falls within the range of keyword kinds defined by TypeScript.\n     * If the node or any of its tokens are identified as keywords, a segment is added to `this.segments`\n     * with the start and end positions of the node and the specified color for keywords.\n     *\n     * @param  node - The TypeScript AST node to be processed for keywords.\n     */\n\n    private processKeywords(node: ts.Node): void {\n        if ([\n            SyntaxKind.NullKeyword,\n            SyntaxKind.VoidKeyword,\n            SyntaxKind.StringKeyword,\n            SyntaxKind.NumberKeyword,\n            SyntaxKind.BooleanKeyword,\n            SyntaxKind.UndefinedKeyword\n        ].includes(node.kind)) {\n            return this.addSegment(node.getStart(), node.getEnd(), this.schema.typeColor);\n        }\n\n        if (node && node.kind >= ts.SyntaxKind.FirstKeyword && node.kind <= ts.SyntaxKind.LastKeyword) {\n            this.addSegment(node.getStart(), node.getEnd(), this.schema.keywordColor);\n        }\n    }\n\n    /**\n     * Processes identifiers within a TypeScript AST node and adds them as segments for highlighting\n     * based on the node's parent type.\n     *\n     * This method determines the appropriate color for an identifier based on its parent node's kind.\n     * If the parent node matches one of the specified kinds, the identifier is highlighted with a cyan color.\n     * Supported parent kinds include various declarations, expressions, and signatures.\n     *\n     * @param node - The TypeScript AST node representing the identifier to be processed.\n     */\n\n    private processIdentifier(node: ts.Node): void {\n        const end = node.getEnd();\n        const start = node.getStart();\n\n        switch (node.parent.kind) {\n            case ts.SyntaxKind.EnumMember:\n                return this.addSegment(start, end, this.schema.enumColor);\n            case ts.SyntaxKind.CallExpression:\n            case ts.SyntaxKind.EnumDeclaration:\n            case ts.SyntaxKind.PropertySignature:\n            case ts.SyntaxKind.ModuleDeclaration:\n                return this.addSegment(start, end, this.schema.variableColor);\n            case ts.SyntaxKind.InterfaceDeclaration:\n                return this.addSegment(start, end, this.schema.interfaceColor);\n            case ts.SyntaxKind.GetAccessor:\n                return this.addSegment(start, end, this.schema.getAccessorColor);\n            case ts.SyntaxKind.PropertyAssignment:\n                return this.addSegment(start, end, this.schema.propertyAssignmentColor);\n            case ts.SyntaxKind.MethodSignature:\n                return this.addSegment(start, end, this.schema.methodSignatureColor);\n            case ts.SyntaxKind.MethodDeclaration:\n            case ts.SyntaxKind.FunctionDeclaration:\n                return this.addSegment(start, end, this.schema.functionColor);\n            case ts.SyntaxKind.ClassDeclaration:\n                return this.addSegment(start, end, this.schema.classColor);\n            case ts.SyntaxKind.Parameter:\n                return this.addSegment(start, end, this.schema.parameterColor);\n            case ts.SyntaxKind.VariableDeclaration:\n                return this.addSegment(start, end, this.schema.variableColor);\n            case ts.SyntaxKind.PropertyDeclaration:\n                return this.addSegment(start, end, this.schema.variableColor);\n            case ts.SyntaxKind.PropertyAccessExpression: {\n                if (node.parent.getChildAt(0).getText() === node.getText()) {\n                    return this.addSegment(start, end, this.schema.variableColor);\n                }\n\n                return this.addSegment(start, end, this.schema.propertyAccessExpressionColor);\n            }\n            case ts.SyntaxKind.ExpressionWithTypeArguments:\n                return this.addSegment(start, end, this.schema.expressionWithTypeArgumentsColor);\n            case ts.SyntaxKind.BreakStatement:\n            case ts.SyntaxKind.ShorthandPropertyAssignment:\n            case ts.SyntaxKind.BindingElement:\n                return this.addSegment(start, end, this.schema.variableColor);\n            case ts.SyntaxKind.BinaryExpression:\n            case ts.SyntaxKind.SwitchStatement:\n            case ts.SyntaxKind.TemplateSpan:\n                return this.addSegment(start, end, this.schema.variableColor);\n            case ts.SyntaxKind.TypeReference:\n            case ts.SyntaxKind.TypeAliasDeclaration:\n                return this.addSegment(start, end, this.schema.typeColor);\n            case ts.SyntaxKind.NewExpression:\n                return this.addSegment(start, end, this.schema.variableColor);\n        }\n    }\n\n    /**\n     * Processes a TypeScript template expression and adds segments for highlighting its literal parts.\n     *\n     * This method adds a segment for the head of the template expression with the color specified in `this.schema.stringColor`.\n     * It also processes each template span within the expression, adding\n     * segments for each span's literal part.\n     *\n     * @param templateExpression - The TypeScript template expression to be processed.\n     */\n\n    private processTemplateExpression(templateExpression: ts.TemplateExpression): void {\n        const start = templateExpression.head.getStart();\n        const end = templateExpression.head.getEnd();\n        this.addSegment(start, end, this.schema.stringColor);\n\n        templateExpression.templateSpans.forEach(span => {\n            const spanStart = span.literal.getStart();\n            const spanEnd = span.literal.getEnd();\n            this.addSegment(spanStart, spanEnd, this.schema.stringColor);\n        });\n    }\n\n    /**\n     * Processes a TypeScript AST node and adds segments for highlighting based on the node's kind.\n     *\n     * This method identifies the kind of the node and determines the appropriate color for highlighting.\n     * It handles various node kinds including string literals, regular expressions, template expressions, and identifiers.\n     * Specific methods are invoked for more complex node kinds, such as template expressions and identifiers.\n     *\n     * @param  node - The TypeScript AST node to be processed.\n     */\n\n    private processNode(node: ts.Node): void {\n        const start = node.getStart();\n        const end = node.getEnd();\n\n        switch (node.kind) {\n            case ts.SyntaxKind.TypeParameter:\n                return this.addSegment(start, start + (node as ts.TypeParameterDeclaration).name.text.length, this.schema.typeColor);\n            case ts.SyntaxKind.TypeReference:\n                return this.addSegment(start, end, this.schema.typeColor);\n            case ts.SyntaxKind.StringLiteral:\n            case ts.SyntaxKind.NoSubstitutionTemplateLiteral:\n                return this.addSegment(start, end, this.schema.stringColor);\n            case ts.SyntaxKind.RegularExpressionLiteral:\n                return this.addSegment(start, end, this.schema.regularExpressionColor);\n            case ts.SyntaxKind.TemplateExpression:\n                return this.processTemplateExpression(node as ts.TemplateExpression);\n            case ts.SyntaxKind.Identifier:\n                return this.processIdentifier(node);\n            case ts.SyntaxKind.BigIntLiteral:\n            case ts.SyntaxKind.NumericLiteral:\n                return this.addSegment(start, end, this.schema.numericLiteralColor);\n        }\n    }\n}\n\n/**\n * Applies semantic highlighting to the provided code string using the specified color scheme.\n *\n * @param code - The source code to be highlighted.\n * @param schema - An optional partial schema defining the color styles for various code elements.\n *                 Defaults to an empty object, which means no specific highlighting will be applied.\n *\n * @returns A string with the code elements wrapped in the appropriate color styles as specified by the schema.\n *\n * @example\n * const code = 'const x: number = 42;';\n * const schema = {\n *   keywordColor: '\\x1b[34m', // Blue\n *   stringColor: '\\x1b[32m',  // Green\n *   numberColor: '\\x1b[31m',  // Red\n *   reset: '\\x1b[0m'          // Reset\n * };\n * const highlightedCode = highlightCode(code, schema);\n * console.log(highlightedCode);\n */\n\nexport function highlightCode(code: string, schema: Partial<HighlightSchemeInterface> = {}) {\n    const sourceFile = ts.createSourceFile('temp.ts', code, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);\n    const codeHighlighter = new CodeHighlighter(sourceFile, code, Object.assign(defaultScheme, schema));\n\n    function walk(node: ts.Node): void {\n        codeHighlighter.parseNode(node);\n\n        for (let i = 0; i < node.getChildCount(); i++) {\n            walk(node.getChildAt(i));\n        }\n    } ts.forEachChild(sourceFile, walk);\n\n    return codeHighlighter.highlight();\n}\n", "/**\n * Import will remove at compile time\n */\n\nimport type {\n    MappingInterface,\n    PositionInterface,\n    SourceMapInterface,\n    ShiftSegmentInterface,\n    SourceOptionsInterface,\n    PositionSourceInterface,\n    ThresholdSegmentInterface\n} from '@services/interfaces/source.interface';\n\n/**\n * Imports\n */\n\nimport { Bias } from '@services/interfaces/source.interface';\nimport { decodeVLQ, encodeArrayVLQ } from '@components/base64.component';\n\n/**\n * A service for validating and processing source maps.\n */\n\nexport class SourceService {\n    /**\n     * A list of symbol names used by the \u201Cmappings\u201D entry.\n     */\n\n    private readonly names: Array<string>;\n\n    /**\n     * An array of source file paths.\n     */\n\n    private readonly sources: Array<string>;\n\n    /**\n     * A string of base64 VLQ-encoded mappings.\n     */\n\n    private readonly mappings: Array<MappingInterface>;\n\n    /**\n     * An array of source files contents.\n     */\n\n    private readonly sourcesContent: Array<string>;\n\n    /**\n     * Creates a new SourceService instance.\n     *\n     * @param source - The source map object to be validated.\n     * @throws Error If any required key is missing from the source map.\n     */\n\n    constructor(source: SourceMapInterface) {\n        this.validateSourceMap(source);\n\n        this.names = source.names ?? [];\n        this.sources = source.sources ?? [];\n        this.mappings = [];\n        this.sourcesContent = source.sourcesContent ?? [];\n        this.decodeMappings(source);\n    }\n\n    /**\n     * Returns a plain object representation of the source map data.\n     *\n     * This method creates a new object containing essential source map properties:\n     * - `version`: The version of the source map (typically 3).\n     * - `names`: An array of function or variable names from the original source code.\n     * - `sources`: An array of source file names referenced in the mappings.\n     * - `mappings`: A string representation of the encoded source map mappings. (Generated by `encodeMappings`)\n     * - `sourcesContent`: An optional array containing the content of the source files. (May not be present in all source maps)\n     *\n     * @returns A plain object representing the source map data.\n     */\n\n    getMapObject(): SourceMapInterface {\n        return {\n            version: 3,\n            names: this.names,\n            sources: this.sources,\n            mappings: this.encodeMappings(this.mappings),\n            sourcesContent: this.sourcesContent\n        };\n    }\n\n    /**\n     * Retrieves source code information for a given line and column in the generated code.\n     *\n     * @param line - The line number in the generated code.\n     * @param column - The column number in the generated code.\n     * @param options - Optional configuration for retrieving source information.\n     *   linesBefore (default: 3) - Number of lines before the matching source line to include.\n     *   linesAfter (default: 4) - Number of lines after the matching source line to include.\n     *   includeSourceContent (default: false) - Flag to include the relevant source code snippet.\n     * @returns An object containing source location information (line, column, name, source)\n     *         or including source code (code) if the includeSourceContent flag is set.\n     *         Returns null if no matching mapping is found.\n     */\n\n    getSourcePosition(line: number, column: number, options?: SourceOptionsInterface): PositionSourceInterface | null {\n        const settings = Object.assign({\n            bias: Bias.LOWER_BOUND,\n            linesAfter: 4,\n            linesBefore: 3\n        }, options);\n\n        const map = this.findMapping(line, column, settings.bias);\n        if (!map || isNaN(map.fileIndex)) {\n            return null;\n        }\n\n        const code = this.sourcesContent[map.fileIndex].split('\\n');\n        const endLine = (map.sourceLine ?? 1) + settings.linesAfter;\n        const startLine = Math.max((map.sourceLine ?? 1) - settings.linesBefore, 0);\n        const relevantCode = code.slice(startLine, Math.min(endLine + 1, code.length)).join('\\n');\n\n        return {\n            code: relevantCode,\n            line: map.sourceLine,\n            column: map.sourceColumn,\n            endLine: endLine,\n            startLine: startLine,\n            name:this.names[map.nameIndex ?? -1] ?? null,\n            source: this.sources[map.fileIndex]\n        };\n    }\n\n    /**\n     * Retrieves the position information in the original source code for a given line and column in the generated code.\n     *\n     * @param line - The line number in the generated code.\n     * @param column - The column number in the generated code.\n     * @param bias - An optional bias value specifying how to handle cases where only the line number matches. Defaults to Bias.LOWER_BOUND.\n     *               Bias.LOWER_BOUND: If the line number matches but the column is less, return the closest mapping with a lower column.\n     *               Bias.UPPER_BOUND: If the line number matches but the column is greater, return the closest mapping with a higher column.\n     *               Bias.BOUND: If the line number matches and the column doesn't, return null (default behavior).\n     * @returns A PositionInterface object representing the position in the original source code, or null if no matching position is found.\n     */\n\n    getPosition(line: number, column: number, bias: Bias = Bias.LOWER_BOUND): PositionInterface | null {\n        const map = this.findMapping(line, column, bias);\n        if (!map) {\n            return map;\n        }\n\n        return {\n            line: map.sourceLine,\n            column: map.sourceColumn,\n            name: this.names[map.nameIndex ?? -1] ?? null,\n            source: this.sources[map.fileIndex]\n        };\n    }\n\n    /**\n     * Merges multiple source maps into this source map object.\n     * The order of the provided source maps must match the order in which the corresponding source files were concatenated.\n     *\n     * @param maps - An array of `SourceService` instances representing the source maps to be merged.\n     * @throws Error - If no source maps are provided for concatenation.\n     */\n\n    concat(...maps: Array<SourceMapInterface>): void {\n        if (maps.length < 1) {\n            throw new Error('At least one map must be provided for concatenation.');\n        }\n\n        for (const map of maps) {\n            this.names.push(...map.names);\n            this.sources.push(...map.sources);\n            this.sourcesContent.push(...map.sourcesContent);\n\n            const lastSegment = this.mappings[this.mappings.length - 1];\n            const lines = this.sourcesContent[lastSegment.fileIndex].split('\\n').length;\n\n            this.decodeMappings(maps[0], {\n                nameIndex: this.names.length - 1,\n                fileIndex: this.sources.length - 1,\n                generatedLine: lines < 2 ? 2 : lines\n            });\n        }\n    }\n\n    /**\n     * Converts the source map object to a base64 encoded string representation.\n     *\n     * This method performs the following steps:\n     * 1. Creates a plain object representation of the source map using `getMapObject`.\n     * 2. Convert the plain object to a JSON string using `JSON.stringify`.\n     * 3. Encodes the JSON string using the `encode` function (assumed to be a base64 encoding function).\n     *\n     * @returns A string representing the source map.\n     */\n\n    toString(): string {\n        return JSON.stringify(this.getMapObject());\n    }\n\n    /**\n     * Validates the provided source map object.\n     *\n     * This private method throws an error if any of the required keys are missing from the source map.\n     *\n     * @private\n     * @param input - The source map object to be validated.\n     * @throws Error If any required key is missing from the source map.\n     */\n\n    private validateSourceMap(input: SourceMapInterface): void {\n        const requiredKeys: (keyof SourceMapInterface)[] = [ 'version', 'sources', 'sourcesContent', 'mappings', 'names' ];\n        if (!requiredKeys.every(key => key in input)) {\n            throw new Error('Missing required keys in SourceMap.');\n        }\n    }\n\n    /**\n     * Decodes and processes the encoded mappings.\n     *\n     *  @param encodedMappings - The source map object to be decoded.\n     * @param thresholdSegment\n     */\n\n    private decodeMappings(encodedMappings: SourceMapInterface, thresholdSegment?: ThresholdSegmentInterface): void {\n        // Note: Line and column numbers in source maps start at 1,\n        // unlike arrays which start at 0. Therefore, the initial shift for lines is set to 1.\n        const shift = Object.assign({\n            fileIndex: 0,\n            nameIndex: 0,\n            sourceLine: 1,\n            sourceColumn: 1,\n            generatedLine: 1,\n            generatedColumn: 1\n        }, thresholdSegment);\n\n        try {\n            for (const [ generatedLine, stringSegments ] of encodedMappings.mappings.split(';').entries()) {\n                if (!stringSegments) continue;\n                shift.generatedColumn = 1;\n                const segments = stringSegments.split(',');\n\n                for (const segment of segments) {\n                    if (segment.length < 4) continue;\n                    const decodedSegment = decodeVLQ(segment);\n\n                    this.decodedSegment(shift, decodedSegment, generatedLine + shift.generatedLine);\n                }\n            }\n        } catch (error) {\n            throw new Error(`Error decoding mappings: ${ (<Error>error).message }`);\n        }\n    }\n\n    /**\n     * Processes a decoded segment and updates the mappings.\n     *\n     * @param shift - The current state of the mapping information.\n     * @param decodedSegment - The decoded VLQ segment.\n     * @param generatedLine - The current line index in the generated code.\n     */\n\n    private decodedSegment(shift: ShiftSegmentInterface, decodedSegment: Array<number>, generatedLine: number): void {\n        const [ generatedColumn, fileIndex, sourceLine, sourceColumn, nameIndex ] = decodedSegment;\n        shift.fileIndex += fileIndex;\n        shift.nameIndex += nameIndex ?? 0;\n        shift.sourceLine += sourceLine;\n        shift.sourceColumn += sourceColumn;\n        shift.generatedColumn += generatedColumn;\n\n        this.mappings.push({\n            nameIndex: (nameIndex !== undefined) ? shift.nameIndex : null,\n            fileIndex: shift.fileIndex,\n            sourceLine: shift.sourceLine,\n            sourceColumn: shift.sourceColumn,\n            generatedLine: generatedLine,\n            generatedColumn: shift.generatedColumn\n        });\n    }\n\n    /**\n     * Encodes the mappings into a VLQ string.\n     *\n     * @param mappings - An array of MappingInterface objects to encode.\n     * @returns A VLQ-encoded string representing the mappings.\n     */\n\n    private encodeMappings(mappings: Array<MappingInterface>): string {\n        let resultMapping = '';\n        let segments: Array<string> = [];\n\n        const shift = {\n            fileIndex: 0,\n            nameIndex: 0,\n            sourceLine: 1,\n            sourceColumn: 1,\n            generatedLine: 1,\n            generatedColumn: 1\n        };\n\n        shift.generatedLine = mappings[0].generatedLine;\n        resultMapping += ';'.repeat(shift.generatedLine - 1);\n\n        for (const map of mappings) {\n            if (map.generatedLine !== shift.generatedLine) {\n                resultMapping += segments.join(',');\n                resultMapping += ';'.repeat(Math.max(1, map.generatedLine - shift.generatedLine));\n\n                segments = [];\n                shift.generatedLine = map.generatedLine;\n                shift.generatedColumn = 1;\n            }\n\n            this.encodeSegment(map, segments, shift);\n        }\n\n        return resultMapping + segments.join(',') + ';';\n    }\n\n    /**\n     * Encodes a single segment of the mappings.\n     *\n     * @param map - The MappingInterface object representing a single mapping.\n     * @param segments - An array of encoded segments.\n     * @param shift - The current state of the mapping information.\n     */\n\n    private encodeSegment(map: MappingInterface, segments: Array<string>, shift: ShiftSegmentInterface): void {\n        const segment: Array<number> = [];\n        const sourceIndex = map.fileIndex;\n\n        segment[1] = 0;\n        segment[2] = map.sourceLine - shift.sourceLine;\n        segment[3] = map.sourceColumn - shift.sourceColumn;\n        segment[0] = map.generatedColumn - shift.generatedColumn;\n\n        if (sourceIndex !== shift.fileIndex) {\n            segment[1] = sourceIndex - shift.fileIndex;\n            shift.fileIndex = sourceIndex;\n        }\n\n        if (map.nameIndex) {\n            const nameIndex = map.nameIndex;\n            segment[4] = nameIndex - shift.nameIndex;\n            shift.nameIndex = nameIndex;\n        }\n\n        shift.sourceLine = map.sourceLine;\n        shift.sourceColumn = map.sourceColumn;\n        shift.generatedColumn = map.generatedColumn;\n        segments.push(encodeArrayVLQ(segment));\n    }\n\n    /**\n     * Performs a binary search on the internal `mappings` array to find a mapping object based on the line and column information.\n     * This function utilizes a binary search algorithm to efficiently locate the mapping corresponding to a specific line and column in the generated code.\n     *\n     * @param targetLine - The line number in the generated code to search for.\n     * @param targetColumn - The column number in the generated code to search for.\n     * @param bias - An optional bias value specifying how to handle cases where only the line number matches (DEFAULT: Bias.BOUND).\n     *                 Bias.LOWER_BOUND: If the line number matches but the column is less, return the closest mapping with a lower column.\n     *                 Bias.UPPER_BOUND: If the line number matches but the column is greater, return the closest mapping with a higher column.\n     *                 Bias.BOUND: If the line number matches and the column doesn't, return null (default behavior).\n     * @returns A MappingInterface object representing the found mapping, or null if no matching mapping is found based on the bias.\n     */\n\n    private findMapping(targetLine: number, targetColumn: number, bias: Bias = Bias.BOUND): MappingInterface | null {\n        let startIndex = 0;\n        let endIndex = this.mappings.length - 1;\n        let closestMapping: MappingInterface | null = null;\n\n        while (startIndex <= endIndex) {\n            const middleIndex = Math.floor((startIndex + endIndex) / 2);\n            const currentMapping = this.mappings[middleIndex];\n\n            if (currentMapping.generatedLine < targetLine) {\n                startIndex = middleIndex + 1;\n            } else if (currentMapping.generatedLine > targetLine) {\n                endIndex = middleIndex - 1;\n            } else {\n                // The line matches, now we handle the column bias\n                if (currentMapping.generatedColumn < targetColumn) {\n                    startIndex = middleIndex + 1;\n                    if (bias === Bias.LOWER_BOUND) {\n                        closestMapping = currentMapping;\n                    }\n                } else if (currentMapping.generatedColumn > targetColumn) {\n                    endIndex = middleIndex - 1;\n                    if (bias === Bias.UPPER_BOUND) {\n                        closestMapping = currentMapping;\n                    }\n                } else {\n                    return currentMapping;\n                }\n            }\n        }\n\n        // If the line doesn't match any mapping, return null\n        return closestMapping && closestMapping.generatedLine === targetLine ? closestMapping : null;\n    }\n}\n"],
+  "mappings": "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",
+  "names": ["parseErrorStack", "stackString", "lines", "regex", "evalRegex", "stack", "line", "match", "args", "at", "file", "lineNum", "colNum", "lineNumber", "columnNumber", "evalMatch", "evalAt", "evalFile", "evalLineNum", "evalColNum", "evalAnonFile", "base64Map", "base64Chars", "char", "index", "encodeVLQ", "value", "isNegative", "encoded", "vlq", "digit", "encodeArrayVLQ", "values", "decodeVLQ", "data", "result", "shift", "i", "continuation", "shifted", "formatCode", "code", "options", "lines", "padding", "startLine", "lineContent", "index", "currentLineNumber", "string", "formatErrorCode", "sourcePosition", "ansiOption", "errorLine", "errorColumn", "lineString", "line", "pointer", "ansiPadding", "prefixPointer", "errorMarker", "ts", "SyntaxKind", "Colors", "defaultScheme", "CodeHighlighter", "sourceFile", "code", "schema", "node", "previousSegmentEnd", "parent", "result", "a", "b", "segment", "lastSegment", "source", "combinedSource", "start", "end", "color", "reset", "key", "comment", "templateExpression", "span", "spanStart", "spanEnd", "highlightCode", "codeHighlighter", "walk", "SourceService", "source", "line", "column", "options", "settings", "map", "code", "endLine", "startLine", "bias", "maps", "lastSegment", "lines", "input", "key", "encodedMappings", "thresholdSegment", "shift", "generatedLine", "stringSegments", "segments", "segment", "decodedSegment", "decodeVLQ", "error", "generatedColumn", "fileIndex", "sourceLine", "sourceColumn", "nameIndex", "mappings", "resultMapping", "sourceIndex", "encodeArrayVLQ", "targetLine", "targetColumn", "startIndex", "endIndex", "closestMapping", "middleIndex", "currentMapping"]
+}

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

@@ -0,0 +1,112 @@
+/**
+ * Interface representing a source map object.
+ */
+export interface SourceMapInterface {
+    /**
+     * The version of the source map specification.
+     */
+    version: number;
+    /**
+     * The bundle filename
+     */
+    file?: string;
+    /**
+     * A string of base64 VLQ-encoded mappings.
+     */
+    mappings: string;
+    /**
+     * A list of symbol names used by the “mappings” entry.
+     */
+    names: Array<string>;
+    /**
+     * An array of source file paths.
+     */
+    sources: Array<string>;
+    /**
+     * An array of contents of the source files.
+     */
+    sourcesContent: Array<string>;
+}
+/**
+ * Interface representing a mapping between generated and original source code.
+ */
+export interface MappingInterface {
+    /**
+     * The index in names array
+     */
+    nameIndex: number | null;
+    /**
+     * The file index in sources array
+     */
+    fileIndex: number;
+    /**
+     * The line number in the original source code.
+     */
+    sourceLine: number;
+    /**
+     * The column number in the original source code.
+     */
+    sourceColumn: number;
+    /**
+     * The line number in the generated code.
+     */
+    generatedLine: number;
+    /**
+     * The column number in the generated code.
+     */
+    generatedColumn: number;
+}
+/**
+ * Internal interface used to track the current state during decoding and encoding mappings.
+ * This interface is not intended for external use.
+ */
+export interface ShiftSegmentInterface {
+    fileIndex: number;
+    nameIndex: number;
+    sourceLine: number;
+    sourceColumn: number;
+    generatedLine: number;
+    generatedColumn: number;
+}
+/**
+ * Internal interface used to track offsets during source map concatenation.
+ * This interface is not intended for external use.
+ */
+export interface ThresholdSegmentInterface {
+    fileIndex?: number;
+    nameIndex?: number;
+    generatedLine?: number;
+}
+/**
+ * Interface representing a position in the source code.
+ */
+export interface PositionInterface {
+    line: number;
+    column: number;
+    name: string | null;
+    source: string;
+}
+/**
+ * Interface representing a position in the source code with additional context.
+ */
+export interface PositionSourceInterface extends PositionInterface {
+    code: string;
+    endLine: number;
+    startLine: number;
+}
+/**
+ * Interface representing options for retrieving source positions.
+ */
+export interface SourceOptionsInterface {
+    bias?: Bias;
+    linesAfter?: number;
+    linesBefore?: number;
+}
+/**
+ * Enumeration representing bias options for searching in mappings.
+ */
+export declare const enum Bias {
+    BOUND = 0,
+    LOWER_BOUND = 1,
+    UPPER_BOUND = 2
+}