@remotex-labs/xmap 3.0.4 → 4.0.0

package/dist/index.d.ts

@@ -1,5 +1,9 @@
-import type * as ts from "typescript";
+
 /**
+ * This file was automatically generated by xBuild.
+ * DO NOT EDIT MANUALLY.
+ */
+ /**
  * Represents a source map structure used for mapping code within a file to its original source
  * @since 1.0.0
  */
@@ -138,6 +142,7 @@ export interface SourceOptionsInterface {
      */
     linesBefore?: number;
 }
+
 /**
  * Encodes a given number using Variable-Length Quantity (VLQ) encoding. Negative numbers are encoded by
  * converting to a non-negative representation and the continuation bit is used to indicate if more bytes follow.
@@ -208,74 +213,13 @@ export declare function encodeArrayVLQ(values: number[]): string;
  * @since 1.0.0
  */
 export declare function decodeVLQ(data: string): number[];
+
 /**
- * Represents a source map mapping segment that links positions between original and generated code.
- *
- * @interface SegmentInterface
- *
- * @property line - Original line number in the source file
- * @property column - Original column number in the source file
- * @property nameIndex - Index of the symbol name in the source map's names array (null if no associated name)
- * @property sourceIndex - Index of the source file in the source map's sources array
- * @property generatedLine - Line number in the generated output code
- * @property generatedColumn - Column number in the generated output code
- *
- * @remarks
- * These segments form the core data structure of source maps, providing the necessary
- * information to trace locations between original source code and generated output code.
- * Each segment represents a single mapping point in the transformation process.
- *
- * @example
- * ```ts
- * const segment: SegmentInterface = {
- *   line: 42,
- *   column: 10,
- *   nameIndex: 5,
- *   sourceIndex: 0,
- *   generatedLine: 100,
- *   generatedColumn: 15
- * };
- * ```
- *
- * @since 1.0.0
+ * Import will remove at compile time
  */
-export interface SegmentInterface {
-    line: number;
-    column: number;
-    nameIndex: number | null;
-    sourceIndex: number;
-    generatedLine: number;
-    generatedColumn: number;
-}
 /**
- * A specialized segment interface used during source map offset calculations.
- *
- * @property nameIndex - Index of the symbol name in the source map's names array (always numeric)
- *
- * @remarks
- * Unlike the base SegmentInterface where nameIndex can be null,
- * in offset calculations this value must always be a concrete numeric index.
- * This specialized interface ensures type safety during mapping offset operations.
- *
- * @example
- * ```ts
- * const offsetSegment: SegmentOffsetInterface = {
- *   line: 42,
- *   column: 10,
- *   nameIndex: 5, // Must be a number, not null
- *   sourceIndex: 0,
- *   generatedLine: 100,
- *   generatedColumn: 15
- * };
- * ```
- *
- * @see SegmentInterface
- *
- * @since 1.0.0
+ * Imports
  */
-export interface SegmentOffsetInterface extends SegmentInterface {
-    nameIndex: number;
-}
 /**
  * Determines the matching behavior when searching for segments in a source map.
  *
@@ -297,183 +241,358 @@ export interface SegmentOffsetInterface extends SegmentInterface {
  *
  * @since 1.0.0
  */
-export declare const enum Bias {
+declare const enum Bias {
     BOUND = 0,
     LOWER_BOUND = 1,
     UPPER_BOUND = 2
 }
 /**
- * Represents a collection of mapping segments for a single line in generated code.
- *
- * @remarks
- * A frame contains all the segments that map to a particular line of generated code.
- * Each segment within the frame provides mapping information for a specific range
- * of columns within that line.
- *
- * @example
- * ```ts
- * const lineFrame: FrameType = [
- *   { line: 10, column: 0, nameIndex: null, sourceIndex: 0, generatedLine: 5, generatedColumn: 0 },
- *   { line: 10, column: 5, nameIndex: 3, sourceIndex: 0, generatedLine: 5, generatedColumn: 10 }
- * ];
- * ```
- *
- * @see SegmentInterface
- *
- * @since 1.0.0
- */
-export type FrameType = Array<SegmentInterface>;
-/**
- * Represents the complete mapping structure of a source map.
- *
- * @remarks
- * A source map contains an array where each index corresponds to a line in the generated code.
- * Each entry is either:
- * - A frame (array of segments) containing mappings for that line
- * - Null, indicating the line has no mappings (represented by a semicolon in the source map)
- *
- * The array index corresponds directly to the line number in generated code (0-based).
- *
- * @example
- * ```ts
- * const sourceMap: MapType = [
- *   [{ line: 1, column: 0, nameIndex: null, sourceIndex: 0, generatedLine: 0, generatedColumn: 0 }], // Line 0
- *   null, // Line 1 has no mappings
- *   [{ line: 2, column: 0, nameIndex: 1, sourceIndex: 0, generatedLine: 2, generatedColumn: 0 }]  // Line 2
- * ];
- * ```
- *
- * @see FrameType
- * @see SegmentInterface
- *
- * @since 1.0.0
- */
-export type MapType = Array<null | FrameType>;
-/**
- * Provides functionality for encoding and decoding source map mappings.
- *
- * The MappingProvider class handles the conversion between various mapping representations:
- * - String format (VLQ-encoded mappings)
- * - Structured array format (MapType)
- * - Internal structured representation
+ * A service for validating and processing source maps that provides functionality for parsing,
+ * position mapping, concatenation, and code snippet extraction.
  *
- * It also provides methods to query and retrieve source map segments based on
- * generated or original source positions.
+ * @param source - Source map data (SourceService, SourceMapInterface object, or JSON string)
+ * @param file - Optional file name for the generated bundle
+ * @returns A new SourceService instance
  *
  * @example
  * ```ts
- * // Create from VLQ-encoded mapping string
- * const provider = new MappingProvider(mappingString);
- *
- * // Get a segment by generated position
- * const segment = provider.getSegment(10, 15);
- *
- * // Convert back to mapping string
- * const encoded = provider.encode();
+ * const sourceMapJSON = '{"version": 3, "file": "bundle.js", "sources": ["foo.ts"], "names": [], "mappings": "AAAA"}';
+ * const sourceService = new SourceService(sourceMapJSON);
+ * console.log(sourceService.file); // 'bundle.js'
  * ```
  *
  * @since 1.0.0
  */
-export declare class MappingProvider {
-    private mapping;
+export declare class SourceService {
     /**
-     * Creates a new MappingProvider instance.
-     *
-     * @param mapping - Source map mapping data in one of three formats:
-     *                 - VLQ-encoded string
-     *                 - Structured array (MapType)
-     *                 - Another MappingProvider instance (copy constructor)
-     * @param namesOffset - Optional offset to apply to name indices (default: 0)
-     * @param sourceOffset - Optional offset to apply to source indices (default: 0)
-     *
-     * @remarks
-     * The constructor automatically detects the mapping format and decodes it accordingly.
-     * When providing offsets, these values will be added to the corresponding indices
-     * in the decoded mapping data, which is useful when concatenating multiple source maps.
+     * The name of the generated file this source map applies to.
      *
      * @since 1.0.0
      */
-    constructor(mapping: string, namesOffset?: number, sourceOffset?: number);
-    constructor(mapping: MapType, namesOffset?: number, sourceOffset?: number);
-    constructor(mapping: MappingProvider, namesOffset?: number, sourceOffset?: number);
+    readonly file: string | null;
     /**
-     * Encodes the internal mapping representation to a VLQ-encoded mapping string.
-     *
-     * @returns VLQ-encoded mapping string compatible with the source map format specification
+     * Provider for accessing and manipulating the base64 VLQ-encoded mappings.
      *
-     * @remarks
-     * This method converts the internal structured mapping representation into a compact
-     * string format using Variable Length Quantity (VLQ) encoding.
-     * The resulting string follows the source map v3 format for the 'mappings' field.
+     * @since 1.0.0
+     */
+    readonly mappings: MappingProvider;
+    /**
+     * The root URL for resolving relative paths in the source files.
+     * @since 1.0.0
+     */
+    readonly sourceRoot: string | null;
+    /**
+     * List of symbol names referenced by the mappings.
+     * @since 1.0.0
+     */
+    readonly names: Array<string>;
+    /**
+     * Array of source file paths.
+     * @since 1.0.0
+     */
+    readonly sources: Array<string>;
+    /**
+     * Array of source file contents.
+     * @since 1.0.0
+     */
+    readonly sourcesContent: Array<string>;
+    /**
+     * Creates a new SourceService instance.
      *
-     * @see https://sourcemaps.info/spec.html
+     * @param source - Source map data (SourceService, SourceMapInterface object, or JSON string)
+     * @throws Error - When a source map has an invalid format or missing required properties
      *
      * @since 1.0.0
      */
-    encode(): string;
+    constructor(source: SourceService);
     /**
-     * Decodes mapping data into the internal representation.
-     *
-     * @param mapping - Mapping data to decode in one of three formats:
-     *                 - VLQ-encoded string
-     *                 - Structured array (MapType)
-     *                 - Another MappingProvider instance
-     * @param namesOffset - Optional offset for name indices (default: 0)
-     * @param sourcesOffset - Optional offset for source indices (default: 0)
+     * Creates a new SourceService instance.
      *
-     * @remarks
-     * This method replaces the current internal mapping data with the newly decoded mapping.
-     * The format of the input mapping is automatically detected and processed accordingly.
+     * @param source - Source map data (SourceService, SourceMapInterface object, or JSON string)
+     * @param file - Optional file name for the generated bundle
      *
-     * @see MapType
-     * @see MappingProvider
+     * @throws Error - When a source map has an invalid format or missing required properties
      *
      * @since 1.0.0
      */
-    decode(mapping: MappingProvider | MapType | string, namesOffset?: number, sourcesOffset?: number): void;
+    constructor(source: SourceMapInterface | string, file?: string | null);
     /**
-     * Retrieves a segment based on a position in the generated code.
+     * Converts the source map data to a plain object.
      *
-     * @param generatedLine - Line number in generated code (1-based)
-     * @param generatedColumn - Column number in generated code (0-based)
-     * @param bias - Controls matching behavior when exact position not found:
-     *              - BOUND: No preference (default)
-     *              - LOWER_BOUND: Prefer segment with lower column
-     *              - UPPER_BOUND: Prefer segment with higher column
-     * @returns Matching segment or null if not found
+     * @returns A SourceMapInterface object representing the current state
      *
-     * @remarks
-     * Uses binary search to efficiently locate matching segments.
-     * When no exact match is found, the bias parameter determines which nearby segment to return.
+     * @example
+     * ```ts
+     * const mapObject = sourceService.getMapObject();
+     * console.log(mapObject.file); // 'bundle.js'
+     * ```
      *
      * @since 1.0.0
      */
-    getSegment(generatedLine: number, generatedColumn: number, bias?: Bias): SegmentInterface | null;
+    getMapObject(): SourceMapInterface;
     /**
-     * Retrieves a segment based on a position in the original source code.
+     * Concatenates additional source maps into the current instance.
      *
-     * @param line - Line number in original source (1-based)
-     * @param column - Column number in original source (0-based)
-     * @param sourceIndex - Index of source file in the sources array
-     * @param bias - Controls matching behavior when exact position not found:
-     *              - BOUND: No preference (default)
-     *              - LOWER_BOUND: Prefer segment with lower column
-     *              - UPPER_BOUND: Prefer segment with higher column
-     * @returns Matching segment or null if not found
+     * @param maps - Source maps to concatenate with the current map
      *
-     * @remarks
-     * Searches across all mapping segments to find those matching the specified original source position.
-     * When multiple matches are possible, the bias
-     * parameter determines which segment to return.
+     * @example
+     * ```ts
+     * sourceService.concat(anotherSourceMap);
+     * console.log(sourceService.sources); // Updated source paths
+     * ```
      *
-     * This operation is more expensive than getSegment as it must potentially
-     * scan the entire mapping structure.
+     * @throws Error - When no maps are provided
      *
      * @since 1.0.0
      */
-    getOriginalSegment(line: number, column: number, sourceIndex: number, bias?: Bias): SegmentInterface | null;
+    concat(...maps: Array<SourceMapInterface | SourceService>): void;
     /**
-     * Initializes a new segment offset object with default values.
+     * Creates a new SourceService instance with concatenated source maps.
+     *
+     * @param maps - Source maps to concatenate with a copy of the current map
+     * @returns A new SourceService instance with the combined maps
+     *
+     * @example
+     * ```ts
+     * const newService = sourceService.concatNewMap(anotherSourceMap);
+     * console.log(newService.sources); // Combined sources array
+     * ```
+     *
+     * @throws Error - When no maps are provided
+     *
+     * @since 1.0.0
+     */
+    concatNewMap(...maps: Array<SourceMapInterface | SourceService>): SourceService;
+    /**
+     * Finds position in generated code based on original source position.
+     *
+     * @param line - Line number in the original source
+     * @param column - Column number in the original source
+     * @param sourceIndex - Index or file path of the original source
+     * @param bias - Position matching strategy (default: Bias.BOUND)
+     * @returns Position information or null if not found
+     *
+     * @example
+     * ```ts
+     * const position = sourceService.getPositionByOriginal(1, 10, 'foo.ts');
+     * console.log(position?.generatedLine); // Line in generated code
+     * ```
+     *
+     * @since 1.0.0
+     */
+    getPositionByOriginal(line: number, column: number, sourceIndex: number | string, bias?: Bias): PositionInterface | null;
+    /**
+     * Finds position in an original source based on generated code position.
+     *
+     * @param line - Line number in the generated code
+     * @param column - Column number in the generated code
+     * @param bias - Position matching strategy (default: Bias.BOUND)
+     * @returns Position information or null if not found
+     *
+     * @example
+     * ```ts
+     * const position = sourceService.getPosition(2, 15);
+     * console.log(position?.source); // Original source file
+     * ```
+     *
+     * @since 1.0.0
+     */
+    getPosition(line: number, column: number, bias?: Bias): PositionInterface | null;
+    /**
+     * Retrieves position with source content for a location in generated code.
+     *
+     * @param line - Line number in the generated code
+     * @param column - Column number in the generated code
+     * @param bias - Position matching strategy (default: Bias.BOUND)
+     * @returns Position with content information or null if not found
+     *
+     * @example
+     * ```ts
+     * const posWithContent = sourceService.getPositionWithContent(3, 5);
+     * console.log(posWithContent?.sourcesContent); // Original source content
+     * ```
+     *
+     * @since 1.0.0
+     */
+    getPositionWithContent(line: number, column: number, bias?: Bias): PositionWithContentInterface | null;
+    /**
+     * Retrieves position with a code snippet from the original source.
+     *
+     * @param line - Line number in the generated code
+     * @param column - Column number in the generated code
+     * @param bias - Position matching strategy (default: Bias.BOUND)
+     * @param options - Configuration for the amount of surrounding lines
+     * @returns Position with code snippet or null if not found
+     *
+     * @example
+     * ```ts
+     * const posWithCode = sourceService.getPositionWithCode(4, 8, Bias.BOUND, {
+     *   linesBefore: 2,
+     *   linesAfter: 2
+     * });
+     * console.log(posWithCode?.code); // Code snippet with context
+     * ```
+     *
+     * @since 1.0.0
+     */
+    getPositionWithCode(line: number, column: number, bias?: Bias, options?: SourceOptionsInterface): PositionWithCodeInterface | null;
+    /**
+     * Serializes the source map to a JSON string.
+     *
+     * @returns JSON string representation of the source map
+     *
+     * @example
+     * ```ts
+     * const jsonString = sourceService.toString();
+     * console.log(jsonString); // '{"version":3,"file":"bundle.js",...}'
+     * ```
+     *
+     * @since 1.0.0
+     */
+    toString(): string;
+    /**
+     * Validates a source map object has all required properties.
+     *
+     * @param input - Source map object to validate
+     *
+     * @throws Error - When required properties are missing
+     *
+     * @since 1.0.0
+     */
+    private validateSourceMap;
+}
+
+/**
+ * Import will remove at compile time
+ */
+/**
+ * Imports
+ */
+/**
+ * Provides functionality for encoding and decoding source map mappings.
+ *
+ * The MappingProvider class handles the conversion between various mapping representations:
+ * - String format (VLQ-encoded mappings)
+ * - Structured array format (MapType)
+ * - Internal structured representation
+ *
+ * It also provides methods to query and retrieve source map segments based on
+ * generated or original source positions.
+ *
+ * @example
+ * ```ts
+ * // Create from VLQ-encoded mapping string
+ * const provider = new MappingProvider(mappingString);
+ *
+ * // Get a segment by generated position
+ * const segment = provider.getSegment(10, 15);
+ *
+ * // Convert back to mapping string
+ * const encoded = provider.encode();
+ * ```
+ *
+ * @since 1.0.0
+ */
+declare class MappingProvider {
+    private mapping;
+    /**
+     * Creates a new MappingProvider instance.
+     *
+     * @param mapping - Source map mapping data in one of three formats:
+     *                 - VLQ-encoded string
+     *                 - Structured array (MapType)
+     *                 - Another MappingProvider instance (copy constructor)
+     * @param namesOffset - Optional offset to apply to name indices (default: 0)
+     * @param sourceOffset - Optional offset to apply to source indices (default: 0)
+     *
+     * @remarks
+     * The constructor automatically detects the mapping format and decodes it accordingly.
+     * When providing offsets, these values will be added to the corresponding indices
+     * in the decoded mapping data, which is useful when concatenating multiple source maps.
+     *
+     * @since 1.0.0
+     */
+    constructor(mapping: string, namesOffset?: number, sourceOffset?: number);
+    constructor(mapping: MapType, namesOffset?: number, sourceOffset?: number);
+    constructor(mapping: MappingProvider, namesOffset?: number, sourceOffset?: number);
+    /**
+     * Encodes the internal mapping representation to a VLQ-encoded mapping string.
+     *
+     * @returns VLQ-encoded mapping string compatible with the source map format specification
+     *
+     * @remarks
+     * This method converts the internal structured mapping representation into a compact
+     * string format using Variable Length Quantity (VLQ) encoding.
+     * The resulting string follows the source map v3 format for the 'mappings' field.
+     *
+     * @see https://sourcemaps.info/spec.html
+     *
+     * @since 1.0.0
+     */
+    encode(): string;
+    /**
+     * Decodes mapping data into the internal representation.
+     *
+     * @param mapping - Mapping data to decode in one of three formats:
+     *                 - VLQ-encoded string
+     *                 - Structured array (MapType)
+     *                 - Another MappingProvider instance
+     * @param namesOffset - Optional offset for name indices (default: 0)
+     * @param sourcesOffset - Optional offset for source indices (default: 0)
+     *
+     * @remarks
+     * This method replaces the current internal mapping data with the newly decoded mapping.
+     * The format of the input mapping is automatically detected and processed accordingly.
+     *
+     * @see MapType
+     * @see MappingProvider
+     *
+     * @since 1.0.0
+     */
+    decode(mapping: MappingProvider | MapType | string, namesOffset?: number, sourcesOffset?: number): void;
+    /**
+     * Retrieves a segment based on a position in the generated code.
+     *
+     * @param generatedLine - Line number in generated code (1-based)
+     * @param generatedColumn - Column number in generated code (0-based)
+     * @param bias - Controls matching behavior when exact position not found:
+     *              - BOUND: No preference (default)
+     *              - LOWER_BOUND: Prefer segment with lower column
+     *              - UPPER_BOUND: Prefer segment with higher column
+     * @returns Matching segment or null if not found
+     *
+     * @remarks
+     * Uses binary search to efficiently locate matching segments.
+     * When no exact match is found, the bias parameter determines which nearby segment to return.
+     *
+     * @since 1.0.0
+     */
+    getSegment(generatedLine: number, generatedColumn: number, bias?: Bias): SegmentInterface | null;
+    /**
+     * Retrieves a segment based on a position in the original source code.
+     *
+     * @param line - Line number in original source (1-based)
+     * @param column - Column number in original source (0-based)
+     * @param sourceIndex - Index of source file in the sources array
+     * @param bias - Controls matching behavior when exact position not found:
+     *              - BOUND: No preference (default)
+     *              - LOWER_BOUND: Prefer segment with lower column
+     *              - UPPER_BOUND: Prefer segment with higher column
+     * @returns Matching segment or null if not found
+     *
+     * @remarks
+     * Searches across all mapping segments to find those matching the specified original source position.
+     * When multiple matches are possible, the bias
+     * parameter determines which segment to return.
+     *
+     * This operation is more expensive than getSegment as it must potentially
+     * scan the entire mapping structure.
+     *
+     * @since 1.0.0
+     */
+    getOriginalSegment(line: number, column: number, sourceIndex: number, bias?: Bias): SegmentInterface | null;
+    /**
+     * Initializes a new segment offset object with default values.
      *
      * @param namesOffset - Initial name index offset value (default: 0)
      * @param sourceIndex - Initial source index offset value (default: 0)
@@ -658,1017 +777,119 @@ export declare class MappingProvider {
      */
     private decodeMappingArray;
 }
+
 /**
- * A service for validating and processing source maps that provides functionality for parsing,
- * position mapping, concatenation, and code snippet extraction.
- *
- * @param source - Source map data (SourceService, SourceMapInterface object, or JSON string)
- * @param file - Optional file name for the generated bundle
- * @returns A new SourceService instance
+ * Represents a source map mapping segment that links positions between original and generated code.
  *
- * @example
- * ```ts
- * const sourceMapJSON = '{"version": 3, "file": "bundle.js", "sources": ["foo.ts"], "names": [], "mappings": "AAAA"}';
- * const sourceService = new SourceService(sourceMapJSON);
- * console.log(sourceService.file); // 'bundle.js'
- * ```
+ * @interface SegmentInterface
  *
- * @since 1.0.0
- */
-export declare class SourceService {
-    /**
-     * The name of the generated file this source map applies to.
-     *
-     * @since 1.0.0
-     */
-    readonly file: string | null;
-    /**
-     * Provider for accessing and manipulating the base64 VLQ-encoded mappings.
-     *
-     * @since 1.0.0
-     */
-    readonly mappings: MappingProvider;
-    /**
-     * The root URL for resolving relative paths in the source files.
-     * @since 1.0.0
-     */
-    readonly sourceRoot: string | null;
-    /**
-     * List of symbol names referenced by the mappings.
-     * @since 1.0.0
-     */
-    readonly names: Array<string>;
-    /**
-     * Array of source file paths.
-     * @since 1.0.0
-     */
-    readonly sources: Array<string>;
-    /**
-     * Array of source file contents.
-     * @since 1.0.0
-     */
-    readonly sourcesContent: Array<string>;
-    /**
-     * Creates a new SourceService instance.
-     *
-     * @param source - Source map data (SourceService, SourceMapInterface object, or JSON string)
-     * @param file - Optional file name for the generated bundle
-     *
-     * @throws Error - When a source map has an invalid format or missing required properties
-     *
-     * @since 1.0.0
-     */
-    constructor(source: SourceService);
-    constructor(source: SourceMapInterface | string, file?: string | null);
-    /**
-     * Converts the source map data to a plain object.
-     *
-     * @returns A SourceMapInterface object representing the current state
-     *
-     * @example
-     * ```ts
-     * const mapObject = sourceService.getMapObject();
-     * console.log(mapObject.file); // 'bundle.js'
-     * ```
-     *
-     * @since 1.0.0
-     */
-    getMapObject(): SourceMapInterface;
-    /**
-     * Concatenates additional source maps into the current instance.
-     *
-     * @param maps - Source maps to concatenate with the current map
-     *
-     * @example
-     * ```ts
-     * sourceService.concat(anotherSourceMap);
-     * console.log(sourceService.sources); // Updated source paths
-     * ```
-     *
-     * @throws Error - When no maps are provided
-     *
-     * @since 1.0.0
-     */
-    concat(...maps: Array<SourceMapInterface | SourceService>): void;
-    /**
-     * Creates a new SourceService instance with concatenated source maps.
-     *
-     * @param maps - Source maps to concatenate with a copy of the current map
-     * @returns A new SourceService instance with the combined maps
-     *
-     * @example
-     * ```ts
-     * const newService = sourceService.concatNewMap(anotherSourceMap);
-     * console.log(newService.sources); // Combined sources array
-     * ```
-     *
-     * @throws Error - When no maps are provided
-     *
-     * @since 1.0.0
-     */
-    concatNewMap(...maps: Array<SourceMapInterface | SourceService>): SourceService;
-    /**
-     * Finds position in generated code based on original source position.
-     *
-     * @param line - Line number in the original source
-     * @param column - Column number in the original source
-     * @param sourceIndex - Index or file path of the original source
-     * @param bias - Position matching strategy (default: Bias.BOUND)
-     * @returns Position information or null if not found
-     *
-     * @example
-     * ```ts
-     * const position = sourceService.getPositionByOriginal(1, 10, 'foo.ts');
-     * console.log(position?.generatedLine); // Line in generated code
-     * ```
-     *
-     * @since 1.0.0
-     */
-    getPositionByOriginal(line: number, column: number, sourceIndex: number | string, bias?: Bias): PositionInterface | null;
-    /**
-     * Finds position in an original source based on generated code position.
-     *
-     * @param line - Line number in the generated code
-     * @param column - Column number in the generated code
-     * @param bias - Position matching strategy (default: Bias.BOUND)
-     * @returns Position information or null if not found
-     *
-     * @example
-     * ```ts
-     * const position = sourceService.getPosition(2, 15);
-     * console.log(position?.source); // Original source file
-     * ```
-     *
-     * @since 1.0.0
-     */
-    getPosition(line: number, column: number, bias?: Bias): PositionInterface | null;
-    /**
-     * Retrieves position with source content for a location in generated code.
-     *
-     * @param line - Line number in the generated code
-     * @param column - Column number in the generated code
-     * @param bias - Position matching strategy (default: Bias.BOUND)
-     * @returns Position with content information or null if not found
-     *
-     * @example
-     * ```ts
-     * const posWithContent = sourceService.getPositionWithContent(3, 5);
-     * console.log(posWithContent?.sourcesContent); // Original source content
-     * ```
-     *
-     * @since 1.0.0
-     */
-    getPositionWithContent(line: number, column: number, bias?: Bias): PositionWithContentInterface | null;
-    /**
-     * Retrieves position with a code snippet from the original source.
-     *
-     * @param line - Line number in the generated code
-     * @param column - Column number in the generated code
-     * @param bias - Position matching strategy (default: Bias.BOUND)
-     * @param options - Configuration for the amount of surrounding lines
-     * @returns Position with code snippet or null if not found
-     *
-     * @example
-     * ```ts
-     * const posWithCode = sourceService.getPositionWithCode(4, 8, Bias.BOUND, {
-     *   linesBefore: 2,
-     *   linesAfter: 2
-     * });
-     * console.log(posWithCode?.code); // Code snippet with context
-     * ```
-     *
-     * @since 1.0.0
-     */
-    getPositionWithCode(line: number, column: number, bias?: Bias, options?: SourceOptionsInterface): PositionWithCodeInterface | null;
-    /**
-     * Serializes the source map to a JSON string.
-     *
-     * @returns JSON string representation of the source map
-     *
-     * @example
-     * ```ts
-     * const jsonString = sourceService.toString();
-     * console.log(jsonString); // '{"version":3,"file":"bundle.js",...}'
-     * ```
-     *
-     * @since 1.0.0
-     */
-    toString(): string;
-    /**
-     * Validates a source map object has all required properties.
-     *
-     * @param input - Source map object to validate
-     *
-     * @throws Error - When required properties are missing
-     *
-     * @since 1.0.0
-     */
-    private validateSourceMap;
-}
-/**
- * A callback function 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 Formatted line string
- *
- * @since 1.0.0
- */
-export type FormatCodeCallbackType = (lineString: string, padding: number, line: number) => string;
-/**
- * Configuration options for formatting code
- *
- * @since 1.0.0
- */
-export interface FormatCodeInterface {
-    /**
-     * The amount of padding to be applied to each line
-     * @since 1.0.0
-     */
-    padding?: number;
-    /**
-     * The starting line number for formatting
-     * @since 1.0.0
-     */
-    startLine?: number;
-    /**
-     * An optional action object specifying a line where a callback function should be triggered.
-     * @since 1.0.0
-     */
-    action?: {
-        /**
-         * The line number at which the callback function should be triggered.
-         * @since 1.0.0
-         */
-        triggerLine: number;
-        /**
-         * The callback function to be executed when the trigger line is encountered.
-         * @since 1.0.0
-         */
-        callback: FormatCodeCallbackType;
-    };
-}
-/**
- * Configuration for ANSI color styling of error pointers
- * @since 1.0.0
- */
-export interface AnsiOptionInterface {
-    /**
-     * ANSI color code to apply to the error pointer
-     * @since 1.0.0
-     */
-    color: string;
-    /**
-     * ANSI reset code to restore default styling after the error pointer
-     * @since 1.0.0
-     */
-    reset: string;
-}
-/**
- * Formats a code snippet with optional line padding and custom actions
- *
- * @param code - The source code | stack to be formatted
- * @param options - Configuration options for formatting the code
- * @returns A formatted string of the code snippet with applied padding and custom actions
- *
- * @remarks
- * This function takes a code string and an options object to format the code snippet.
- * It applies padding to line numbers and can trigger custom actions for specific lines.
- * Options include padding (default 10), startLine (default 0), and custom actions for specific lines.
- *
- * @example
- * ```ts
- * const formattedCode = formatCode(code, {
- *     padding: 8,
- *     startLine: 5,
- *     action: {
- *         triggerLine: 7,
- *         callback: (lineString, padding, lineNumber) => {
- *             return `Custom formatting for line ${lineNumber}: ${lineString}`;
- *         }
- *     }
- * });
- * ```
- *
- * @since 1.0.0
- */
-export declare function formatCode(code: string, options?: FormatCodeInterface): string;
-/**
- * Formats a code snippet around an error location with special highlighting
- *
- * @param sourcePosition - An object containing information about the source code and error location
- * @param ansiOption - Optional configuration for ANSI color codes
- * @returns A formatted string representing the relevant code snippet with error highlighting
- *
- * @throws Error - If the provided sourcePosition object has invalid line or column numbers
- *
- * @remarks
- * This function takes a sourcePosition object with code content and error location information,
- * then uses formatCode to format and highlight the relevant code snippet around the error.
- * The sourcePosition object should contain code (string), line (number), column (number),
- * and optional startLine (number, defaults to 1).
- *
- * @example
- * ```ts
- * const formattedErrorCode = formatErrorCode({
- *     code: "const x = 1;\nconst y = x.undefined;\n",
- *     line: 2,
- *     column: 15,
- *     startLine: 1
- * });
- * ```
- *
- * @see formatCode - The underlying function used for basic code formatting
- *
- * @since 1.0.0
- */
-export declare function formatErrorCode(sourcePosition: PositionWithCodeInterface, ansiOption?: AnsiOptionInterface): string;
-/**
- * Defines the color scheme for syntax highlighting different code elements.
- *
- * @interface HighlightSchemeInterface
- *
- * @property enumColor - Color code for enum declarations and references
- * @property typeColor - Color code for type annotations and primitive types
- * @property classColor - Color code for class declarations and references
- * @property stringColor - Color code for string literals and template strings
- * @property keywordColor - Color code for language keywords
- * @property commentColor - Color code for comments (single-line and multi-line)
- * @property functionColor - Color code for function declarations and calls
- * @property variableColor - Color code for variable declarations and references
- * @property interfaceColor - Color code for interface declarations and references
- * @property parameterColor - Color code for function and method parameters
- * @property getAccessorColor - Color code for getter accessor methods
- * @property numericLiteralColor - Color code for numeric literals
- * @property methodSignatureColor - Color code for method signatures in interfaces
- * @property regularExpressionColor - Color code for regular expression literals
- * @property propertyAssignmentColor - Color code for property assignments in object literals
- * @property propertyAccessExpressionColor - Color code for property access expressions
- * @property expressionWithTypeArgumentsColor - Color code for type arguments in expressions
- *
- * @example
- * ```ts
- * const darkTheme: HighlightSchemeInterface = {
- *   enumColor: Colors.cyan,
- *   typeColor: Colors.blue,
- *   classColor: Colors.yellow,
- *   // ...other color definitions
- * };
- * ```
- *
- * @since 1.0.0
- */
-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 source code to be highlighted with specific styling.
- *
- * @interface HighlightNodeSegmentInterface
- *
- * @property start - The starting character position of the segment in the source text
- * @property end - The ending character position of the segment in the source text
- * @property color - The color or style code to apply to this segment
- * @property reset - The reset code that returns formatting to normal after this segment
- *
- * @remarks
- * Segments are the fundamental units of the highlighting system.
- * Each segment represents a portion of text that should receive specific styling.
- * When the source code is processed for display,
- * these segments are used to insert the appropriate color/style codes at the correct positions.
- *
- * The highlighter maintains a collection of these segments and applies them
- * in position order to create the complete highlighted output.
- *
- * @example
- * ```ts
- * const keywordSegment: HighlightNodeSegmentInterface = {
- *   start: 0,
- *   end: 6,
- *   color: '\x1b[34m', // Blue for the keyword "import"
- *   reset: '\x1b[0m'   // Reset to default
- * };
- * ```
- *
- * @see HighlightSchemeInterface
- * @see addSegment
- *
- * @since 1.0.0
- */
-export interface HighlightNodeSegmentInterface {
-    end: number;
-    start: number;
-    color: string;
-    reset: string;
-}
-/**
- * An enum containing ANSI escape sequences for various colors
- *
- * @remarks
- * 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
- * ```ts
- * console.log(`${Colors.red}This text will be red in the terminal.${Colors.reset}`);
- * ```
- *
- * @since 1.0.0
- */
-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
- *
- * @remarks
- * Processes TypeScript AST nodes and applies color formatting to different code elements
- * according to the provided color scheme.
- *
- * @example
- * ```ts
- * const sourceFile = ts.createSourceFile('example.ts', code, ts.ScriptTarget.Latest);
- * const highlighter = new CodeHighlighter(sourceFile, code, customScheme);
- * highlighter.parseNode(sourceFile);
- * const highlightedCode = highlighter.highlight();
- * ```
- *
- * @since 1.0.0
- */
-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.
-     *
-     * @remarks
-     * This structure ensures unique segments and allows for fast lookups and updates.
-     *
-     * @see HighlightNodeSegmentInterface
-     * @since 1.0.0
-     */
-    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
-     *
-     * @since 1.0.0
-     */
-    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
-     *
-     * @since 1.0.0
-     */
-    parseNode(node: ts.Node): void;
-    /**
-     * Generates a string with highlighted code segments based on the provided color scheme.
-     *
-     * @returns The highlighted code as a string, with ANSI color codes applied to the segments
-     *
-     * @remarks
-     * This method processes the stored segments, applies the appropriate colors to each segment,
-     * and returns the resulting highlighted code as a single string.
-     *
-     * @since 1.0.0
-     */
-    highlight(): string;
-    /**
-     * Extracts a text segment from the source code using position indices.
-     *
-     * @param start - The starting index position in the source text
-     * @param end - The ending index position in the source text (optional)
-     * @returns The substring of source text between the start and end positions
-     *
-     * @remarks
-     * This utility method provides access to specific portions of the source code
-     * based on character positions. When the end parameter is omitted, the extraction
-     * will continue to the end of the source text.
-     *
-     * This method is typically used during the highlighting process to access the
-     * actual text content that corresponds to syntax nodes or other text ranges
-     * before applying formatting.
-     *
-     * @example
-     * ```ts
-     * // Extract a variable name
-     * const variableName = this.getSegmentSource(10, 15);
-     *
-     * // Extract from a position to the end of source
-     * const remaining = this.getSegmentSource(100);
-     * ```
-     *
-     * @see addSegment
-     * @see highlight
-     *
-     * @since 1.0.0
-     */
-    private getSegmentSource;
-    /**
-     * Registers a text segment for syntax highlighting with specified style information.
-     *
-     * @param start - The starting position of the segment in the source text
-     * @param end - The ending position of the segment in the source text
-     * @param color - The color code to apply to this segment
-     * @param reset - The color reset code to apply after the segment (defaults to the standard reset code)
-     *
-     * @remarks
-     * This method creates a unique key for each segment based on its position and stores the segment information in a map.
-     * Each segment contains its position information, styling code,
-     * and reset code which will later be used during the highlighting process.
-     *
-     * If multiple segments are added with the same positions, the later additions will
-     * overwrite earlier ones due to the map's key-based storage.
-     *
-     * @example
-     * ```ts
-     * // Highlight a variable name in red
-     * this.addSegment(10, 15, Colors.red);
-     *
-     * // Highlight a keyword with custom color and reset
-     * this.addSegment(20, 26, Colors.blue, Colors.customReset);
-     * ```
-     *
-     * @see Colors
-     * @see processNode
-     *
-     * @since 1.0.0
-     */
-    private addSegment;
-    /**
-     * Processes and highlights comments associated with a TypeScript AST node.
-     *
-     * @param node - The TypeScript AST node whose comments are to be processed
-     *
-     * @remarks
-     * This method identifies both leading and trailing comments associated with the given node
-     * and adds them to the highlighting segments.
-     * The comments are extracted from the full source text using TypeScript's utility functions
-     * and are highlighted using the color specified
-     * in the schema's commentColor property.
-     *
-     * Leading comments appear before the node, while trailing comments appear after it.
-     * Both types are processed with the same highlighting style.
-     *
-     * @example
-     * ```ts
-     * // For a node that might have comments like:
-     * // This is a leading comment
-     * const x = 5; // This is a trailing comment
-     *
-     * this.processComments(someNode);
-     * // Both comments will be added to segments with the comment color
-     * ```
-     *
-     * @see addSegment
-     * @see ts.getLeadingCommentRanges
-     * @see ts.getTrailingCommentRanges
-     *
-     * @since 1.0.0
-     */
-    private processComments;
-    /**
-     * Processes TypeScript keywords and primitive type references in an AST node for syntax highlighting.
-     *
-     * @param node - The TypeScript AST node to be processed for keywords
-     *
-     * @remarks
-     * This method handles two categories of tokens that require special highlighting:
-     *
-     * 1. Primitive type references: Highlights references to built-in types like `null`,
-     *    `void`, `string`, `number`, `boolean`, and `undefined` using the type color.
-     *
-     * 2. TypeScript keywords: Identifies any node whose kind falls within the TypeScript
-     *    keyword range (between FirstKeyword and LastKeyword) and highlights it using
-     *    the keyword color.
-     *
-     * Each identified token is added to the segments collection with appropriate position
-     * and color information.
-     *
-     * @example
-     * ```ts
-     * // Inside syntax highlighting process
-     * this.processKeywords(someNode);
-     * // If the node represents a keyword like 'const' or a primitive type like 'string',
-     * // it will be added to the segments with the appropriate color
-     * ```
-     *
-     * @see addSegment
-     * @see ts.SyntaxKind
-     *
-     * @since 1.0.0
-     */
-    private processKeywords;
-    /**
-     * Processes identifier nodes and applies appropriate syntax highlighting based on their context.
-     *
-     * @param node - The TypeScript AST node representing the identifier to be processed
-     *
-     * @remarks
-     * This method determines the appropriate color for an identifier by examining its parent node's kind.
-     * Different colors are applied based on the identifier's role in the code:
-     * - Enum members use enumColor
-     * - Interface names use interfaceColor
-     * - Class names use classColor
-     * - Function and method names use functionColor
-     * - Parameters use parameterColor
-     * - Variables and properties use variableColor
-     * - Types use typeColor
-     * - And more specialized cases for other syntax kinds
-     *
-     * Special handling is applied to property access expressions to differentiate between
-     * the object being accessed and the property being accessed.
-     *
-     * @example
-     * ```ts
-     * // Inside the CodeHighlighter class
-     * const identifierNode = getIdentifierNode(); // Get some identifier node
-     * this.processIdentifier(identifierNode);
-     * // The identifier is now added to segments with appropriate color based on its context
-     * ```
-     *
-     * @see addSegment
-     * @see HighlightSchemeInterface
-     *
-     * @since 1.0.0
-     */
-    private processIdentifier;
-    /**
-     * Processes a TypeScript template expression and adds highlighting segments for its literal parts.
-     *
-     * @param templateExpression - The TypeScript template expression to be processed
-     *
-     * @remarks
-     * This method adds color segments for both the template head and each template span's literal part.
-     * All template string components are highlighted using the color defined in the schema's stringColor.
-     *
-     * @example
-     * ```ts
-     * // Given a template expression like: `Hello ${name}`
-     * this.processTemplateExpression(templateNode);
-     * // Both "Hello " and the closing part after the expression will be highlighted
-     * ```
-     *
-     * @see addSegment
-     *
-     * @since 1.0.0
-     */
-    private processTemplateExpression;
-    /**
-     * Processes a TypeScript AST node and adds highlighting segments based on the node's kind.
-     *
-     * @param node - The TypeScript AST node to be processed
-     *
-     * @remarks
-     * This method identifies the node's kind and applies the appropriate color for highlighting.
-     * It handles various syntax kinds including literals (string, numeric, regular expressions),
-     * template expressions, identifiers, and type references.
-     * For complex node types like template expressions and identifiers, it delegates to specialized processing methods.
-     *
-     * @throws Error - When casting to TypeParameterDeclaration fails for non-compatible node kinds
-     *
-     * @example
-     * ```ts
-     * // Inside the CodeHighlighter class
-     * const node = sourceFile.getChildAt(0);
-     * this.processNode(node);
-     * // Node is now added to the segments map with appropriate colors
-     * ```
-     *
-     * @see processTemplateExpression
-     * @see processIdentifier
-     *
-     * @since 1.0.0
-     */
-    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
- *
- * @returns A string with the code elements wrapped in the appropriate color styles
+ * @property line - Original line number in the source file
+ * @property column - Original column number in the source file
+ * @property nameIndex - Index of the symbol name in the source map's names array (null if no associated name)
+ * @property sourceIndex - Index of the source file in the source map's sources array
+ * @property generatedLine - Line number in the generated output code
+ * @property generatedColumn - Column number in the generated output code
  *
  * @remarks
- * If no schema is provided, the default schema will be used. The function creates a TypeScript
- * source file from the provided code and walks through its AST to apply syntax highlighting.
+ * These segments form the core data structure of source maps, providing the necessary
+ * information to trace locations between original source code and generated output code.
+ * Each segment represents a single mapping point in the transformation process.
  *
  * @example
  * ```ts
- * const code = 'const x: number = 42;';
- * const schema = {
- *   keywordColor: '\x1b[34m', // Blue
- *   numberColor: '\x1b[31m',  // Red
+ * const segment: SegmentInterface = {
+ *   line: 42,
+ *   column: 10,
+ *   nameIndex: 5,
+ *   sourceIndex: 0,
+ *   generatedLine: 100,
+ *   generatedColumn: 15
  * };
- * const highlightedCode = highlightCode(code, schema);
- * console.log(highlightedCode);
  * ```
  *
- * @see CodeHighlighter
- * @see HighlightSchemeInterface
- *
  * @since 1.0.0
  */
-export declare function highlightCode(code: string, schema?: Partial<HighlightSchemeInterface>): string;
-/**
- * Interface representing a stack frame in a stack trace.
- *
- * This structure provides detailed information about the location
- * of a specific frame in the stack trace, primarily used in error debugging and stack analysis.
- * It optionally includes information about the line, column, file, function name, and other details
- * about the origin of the code.
- *
- * Properties:
- * - source: The source code relevant to the stack frame.
- * - line: An optional line number in the code associated with this frame.
- * - column: An optional column number in the line associated with this frame.
- * - fileName: The name of the file associated with the frame, if available.
- * - functionName: The name of the function where the stack frame is located, if available.
- * - eval: Indicates if the stack frame originates from an evaluated script.
- * - async: Indicates if the stack frame is part of an asynchronous operation.
- * - native: Indicates if the stack frame is part of native code execution.
- * - constructor: Indicates if the frame is related to an object constructor invocation.
- * - evalOrigin: Optional information about the origin of the code if it resulted from an eval execution,
- * including line number, column number, file name, and function name.
- *
- * @since 3.0.0
- */
-export interface StackFrame {
-    source: string;
-    line?: number;
-    column?: number;
-    fileName?: string;
-    functionName?: string;
-    eval: boolean;
-    async: boolean;
-    native: boolean;
-    constructor: boolean;
-    evalOrigin?: {
-        line?: number;
-        column?: number;
-        fileName?: string;
-        functionName?: string;
-    };
-}
-/**
- * Represents a fully parsed error stack trace with structured information
- *
- * @see StackFrame
- * @since 2.1.0
- */
-export interface ParsedStackTrace {
-    name: string;
-    message: string;
-    stack: StackFrame[];
-    rawStack: string;
-}
-/**
- * Enumeration of JavaScript engines that can be detected from stack traces
- *
- * @since 2.1.0
- */
-export declare const enum JSEngines {
-    V8 = 0,
-    SPIDERMONKEY = 1,
-    JAVASCRIPT_CORE = 2,
-    UNKNOWN = 3
+interface SegmentInterface {
+    line: number;
+    column: number;
+    nameIndex: number | null;
+    sourceIndex: number;
+    generatedLine: number;
+    generatedColumn: number;
 }
 /**
- * Detects the JavaScript engine based on the format of a stack trace line
- *
- * @param stack - The stack trace to analyze
- * @returns The identified JavaScript engine type
- *
- * @example
- * ```ts
- * const engine = detectJSEngine("at functionName (/path/to/file.js:10:15)");
- * if (engine === JSEngines.V8) {
- *   // Handle V8 specific logic
- * }
- * ```
- *
- * @since 2.1.0
- */
-export declare function detectJSEngine(stack: string): JSEngines;
-/**
- * Normalizes file paths from various formats to a standard format
- *
- * @param filePath - The file path to normalize, which may include protocol prefixes
- * @returns A normalized file path with consistent separators and without protocol prefixes
- *
- * @remarks
- * Handles both Windows and Unix-style paths, as well as file:// protocol URLs.
- * Converts all backslashes to forward slashes for consistency.
- *
- * @example
- * ```ts
- * // Windows file URL to a normal path
- * normalizePath("file:///C:/path/to/file.js"); // "C:/path/to/file.js"
- *
- * // Unix file URL to a normal path
- * normalizePath("file:///path/to/file.js"); // "/path/to/file.js"
- *
- * // Windows backslashes to forward slashes
- * normalizePath("C:\\path\\to\\file.js"); // "C:/path/to/file.js"
- * ```
- *
- * @since 2.1.0
- */
-export declare function normalizePath(filePath: string): string;
-/**
- * Creates a default stack frame object with initial values
- *
- * @param source - The original source line from the stack trace
- * @returns A new StackFrame object with default null values
- *
- * @see ParsedStackTrace
- * @see StackFrame
- *
- * @since 2.1.0
- */
-export declare function createDefaultFrame(source: string): StackFrame;
-/**
- * Safely parses a string value to an integer, handling undefined and null cases
- *
- * @param value - The string value to parse
- * @returns The parsed integer or null if the input is undefined/null
- *
- * @example
- * ```ts
- * safeParseInt("42"); // 42
- * safeParseInt(undefined); // null
- * safeParseInt(null); // null
- * ```
- *
- * @since 2.1.0
- */
-export declare function safeParseInt(value: string | undefined | null): number | undefined;
-/**
- * Parses a V8 JavaScript engine stack trace line into a structured StackFrame object
- *
- * @param line - The stack trace line to parse
- * @returns A StackFrame object containing the parsed information
- *
- * @remarks
- * Handles both standard V8 stack frames and eval-generated stack frames which
- * have a more complex structure with nested origin information.
- *
- * @example
- * ```ts
- * // Standard frame
- * parseV8StackLine("at functionName (/path/to/file.js:10:15)");
- *
- * // Eval frame
- * parseV8StackLine("at eval (eval at evalFn (/source.js:5:10), <anonymous>:1:5)");
- * ```
- *
- * @throws Error - If the line format doesn't match any known V8 pattern
- *
- * @see StackFrame
- * @see createDefaultFrame
- *
- * @since 2.1.0
- */
-export declare function parseV8StackLine(line: string): StackFrame;
-/**
- * Parses a SpiderMonkey JavaScript engine stack trace line into a structured StackFrame object
+ * A specialized segment interface used during source map offset calculations.
  *
- * @param line - The stack trace line to parse
- * @returns A StackFrame object containing the parsed information
+ * @property nameIndex - Index of the symbol name in the source map's names array (always numeric)
  *
  * @remarks
- * Handles both standard SpiderMonkey stack frames and eval/Function-generated stack frames
- * which contain additional evaluation context information.
+ * Unlike the base SegmentInterface where nameIndex can be null,
+ * in offset calculations this value must always be a concrete numeric index.
+ * This specialized interface ensures type safety during mapping offset operations.
  *
  * @example
  * ```ts
- * // Standard frame
- * parseSpiderMonkeyStackLine("functionName@/path/to/file.js:10:15");
- *
- * // Eval frame
- * parseSpiderMonkeyStackLine("evalFn@/source.js line 5 > eval:1:5");
+ * const offsetSegment: SegmentOffsetInterface = {
+ *   line: 42,
+ *   column: 10,
+ *   nameIndex: 5, // Must be a number, not null
+ *   sourceIndex: 0,
+ *   generatedLine: 100,
+ *   generatedColumn: 15
+ * };
  * ```
  *
- * @see StackFrame
- * @see createDefaultFrame
+ * @see SegmentInterface
  *
- * @since 2.1.0
+ * @since 1.0.0
  */
-export declare function parseSpiderMonkeyStackLine(line: string): StackFrame;
+interface SegmentOffsetInterface extends SegmentInterface {
+    nameIndex: number;
+}
 /**
- * Parses a JavaScriptCore engine stack trace line into a structured StackFrame object
- *
- * @param line - The stack trace line to parse
- * @returns A StackFrame object containing the parsed information
+ * Represents a collection of mapping segments for a single line in generated code.
  *
  * @remarks
- * Handles both standard JavaScriptCore stack frames and eval-generated stack frames.
- * Special handling is provided for "global code" references and native code.
+ * A frame contains all the segments that map to a particular line of generated code.
+ * Each segment within the frame provides mapping information for a specific range
+ * of columns within that line.
  *
  * @example
  * ```ts
- * // Standard frame
- * parseJavaScriptCoreStackLine("functionName@/path/to/file.js:10:15");
- *
- * // Eval frame
- * parseJavaScriptCoreStackLine("eval code@");
+ * const lineFrame: FrameType = [
+ *   { line: 10, column: 0, nameIndex: null, sourceIndex: 0, generatedLine: 5, generatedColumn: 0 },
+ *   { line: 10, column: 5, nameIndex: 3, sourceIndex: 0, generatedLine: 5, generatedColumn: 10 }
+ * ];
  * ```
  *
- * @see StackFrame
- * @see createDefaultFrame
+ * @see SegmentInterface
  *
- * @since 2.1.0
+ * @since 1.0.0
  */
-export declare function parseJavaScriptCoreStackLine(line: string): StackFrame;
+type FrameType = Array<SegmentInterface>;
 /**
- * Parses a stack trace line based on the detected JavaScript engine
- *
- * @param line - The stack trace line to parse
- * @param engine - The JavaScript engine type that generated the stack trace
- * @returns A StackFrame object containing the parsed information
+ * Represents the complete mapping structure of a source map.
  *
  * @remarks
- * Delegates to the appropriate parsing function based on the JavaScript engine.
- * Defaults to V8 parsing if the engine is unknown.
- *
- * @example
- * ```ts
- * const engine = detectJSEngine(stackLine);
- * const frame = parseStackLine(stackLine, engine);
- * ```
- *
- * @see JSEngines
- * @see parseV8StackLine
- * @see parseSpiderMonkeyStackLine
- * @see parseJavaScriptCoreStackLine
- *
- * @since 2.1.0
- */
-export declare function parseStackLine(line: string, engine: JSEngines): StackFrame;
-/**
- * Parses a complete error stack trace into a structured format
- *
- * @param error - Error object or error message string to parse
- * @returns A ParsedStackTrace object containing structured stack trace information
+ * A source map contains an array where each index corresponds to a line in the generated code.
+ * Each entry is either:
+ * - A frame (array of segments) containing mappings for that line
+ * - Null, indicating the line has no mappings (represented by a semicolon in the source map)
  *
- * @remarks
- * Automatically detects the JavaScript engine from the stack format.
- * Filters out redundant information like the error name/message line.
- * Handles both Error objects and string error messages.
+ * The array index corresponds directly to the line number in generated code (0-based).
  *
  * @example
  * ```ts
- * try {
- *   throw new Error ("Something went wrong");
- * } catch (error) {
- *   const parsedStack = parseErrorStack(error);
- *   console.log(parsedStack.name); // "Error"
- *   console.log(parsedStack.message); // "Something went wrong"
- *   console.log(parsedStack.stack); // Array of StackFrame objects
- * }
+ * const sourceMap: MapType = [
+ *   [{ line: 1, column: 0, nameIndex: null, sourceIndex: 0, generatedLine: 0, generatedColumn: 0 }], // Line 0
+ *   null, // Line 1 has no mappings
+ *   [{ line: 2, column: 0, nameIndex: 1, sourceIndex: 0, generatedLine: 2, generatedColumn: 0 }]  // Line 2
+ * ];
  * ```
  *
- * @see ParsedStackTrace
- * @see StackFrame
- * @see parseStackLine
- * @see detectJSEngine
+ * @see FrameType
+ * @see SegmentInterface
  *
- * @since 2.1.0
+ * @since 1.0.0
  */
-export declare function parseErrorStack(error: Error | string): ParsedStackTrace;
+type MapType = Array<null | FrameType>;