@remotex-labs/xmap 1.0.4 → 2.0.0

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

@@ -1,252 +0,0 @@
-/**
- * Interface representing a source map object, which is used to map
- * transformed or compiled code back to its original source.
- * This is typically used in debugging to trace errors or logs in the
- * compiled code back to the original source code.
- */
-export interface SourceMapInterface {
-    /**
-     * The version of the source map specification.
-     * This field is a required number that indicates which version of the source map format is used.
-     *
-     * @example
-     * 3
-     */
-    version: number;
-    /**
-     * The name of the generated file (bundle) that this source map applies to.
-     * This field is optional, and it might not always be present in the source map.
-     *
-     * @example
-     * "bundle.js"
-     */
-    file?: string | null;
-    /**
-     * A VLQ (Variable-Length Quantity) encoded string representing the mapping information
-     * between the transformed code and the original source code. This field is mandatory
-     * and stores the actual mapping data in a compact format.
-     *
-     * @example
-     * "AAAA,QAASA,IAAIC;..."
-     */
-    mappings: string;
-    /**
-     * A list of variable or function names used in the transformed code,
-     * corresponding to their references in the source code.
-     *
-     * @example
-     * ["myFunction", "myVariable", "otherSymbol"]
-     */
-    names: Array<string>;
-    /**
-     * An array of source file paths. Each path corresponds to a source file that was part of the original code,
-     * allowing for a reverse mapping to the source files.
-     *
-     * @example
-     * ["src/file1.ts", "src/file2.ts"]
-     */
-    sources: Array<string>;
-    /**
-     * An array of the contents of the source files, corresponding to the paths in the `sources` array.
-     * If available, this field allows viewing the original source code within the source map file.
-     *
-     * @example
-     * ["function myFunction() {...}", "const myVariable = 10;"]
-     */
-    sourcesContent: Array<string>;
-    /**
-     * An optional prefix that is added to the source file paths in the `sources` array.
-     * This is useful when the paths in the `sources` field are relative and need to be resolved
-     * against a common root directory. It helps organize and locate the original source files.
-     *
-     * @example
-     * "/source/root"
-     */
-    sourceRoot?: string | null;
-}
-/**
- * Interface representing a mapping between generated and original source code.
- * This is used to connect positions in the compiled/generated code to their
- * corresponding positions in the original source code, allowing for debugging
- * and error tracking.
- */
-export interface MappingInterface {
-    /**
-     * The index in the `names` array that refers to a symbol (such as a function or variable name)
-     * in the original source. If there is no corresponding name, this will be `null`.
-     *
-     * @example
-     * 3
-     */
-    nameIndex: number | null;
-    /**
-     * The index in the `sources` array that refers to the file in which the original code is located.
-     *
-     * @example
-     * 1
-     */
-    fileIndex: number;
-    /**
-     * The line number in the original source code (1-based index).
-     *
-     * @example
-     * 25
-     */
-    sourceLine: number;
-    /**
-     * The column number in the original source code (0-based index).
-     *
-     * @example
-     * 12
-     */
-    sourceColumn: number;
-    /**
-     * The line number in the generated (compiled/transpiled) code (1-based index).
-     *
-     * @example
-     * 32
-     */
-    generatedLine: number;
-    /**
-     * The column number in the generated (compiled/transpiled) code (0-based index).
-     *
-     * @example
-     * 8
-     */
-    generatedColumn: number;
-}
-/**
- * Internal interface used to track the current state during decoding and encoding mappings.
- * This interface keeps track of the current mapping segment and is primarily used in the
- * process of transforming source maps. Not intended for external use.
- */
-export interface ShiftSegmentInterface {
-    /**
-     * The index of the source file in the `sources` array.
-     */
-    fileIndex: number;
-    /**
-     * The index of the name in the `names` array. May be `null` if there is no associated name.
-     */
-    nameIndex: 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 offsets during source map concatenation.
- * This interface helps handle transitions between different source maps
- * and offsets. Not intended for external use.
- */
-export interface ThresholdSegmentInterface {
-    /**
-     * Optional index of the source file in the `sources` array, used for tracking offsets.
-     */
-    fileIndex?: number;
-    /**
-     * Optional index of the name in the `names` array, used for tracking name offsets.
-     */
-    nameIndex?: number;
-    /**
-     * Optional line number in the generated code, used for tracking line offsets.
-     */
-    generatedLine?: number;
-}
-/**
- * Interface representing a position in the source code.
- * This is used to pinpoint an exact location in the source code (line, column),
- * along with the name and the file path (source) where the position occurs.
- */
-export interface PositionInterface {
-    /**
-     * The line number in the source code (1-based index).
-     */
-    line: number;
-    /**
-     * The column number in the source code (0-based index).
-     */
-    column: number;
-    /**
-     * The name associated with this position, if any.
-     * If no name is associated, this will be `null`.
-     */
-    name: string | null;
-    /**
-     * The path or name of the source file.
-     */
-    source: string;
-    /**
-     * The root URL for the sources, if present in the source map.
-     */
-    sourceRoot: string | null;
-}
-/**
- * Interface representing a position in the source code with additional context.
- * Extends `PositionInterface` by adding the actual code snippet and range information.
- */
-export interface PositionSourceInterface extends PositionInterface {
-    /**
-     * A snippet of the actual code at this position.
-     */
-    code: string;
-    /**
-     * The ending line number (1-based index) of the code range.
-     */
-    endLine: number;
-    /**
-     * The starting line number (0-based index) of the code range.
-     */
-    startLine: number;
-}
-/**
- * Interface representing options for retrieving source positions.
- * This interface defines options that can modify how source positions
- * are retrieved, including bias settings and surrounding line context.
- */
-export interface SourceOptionsInterface {
-    /**
-     * The bias option for controlling how mappings are searched.
-     * This determines how to handle ambiguities in the source map (e.g., when multiple mappings exist).
-     */
-    bias?: Bias;
-    /**
-     * The number of lines after the target position to include for additional context.
-     */
-    linesAfter?: number;
-    /**
-     * The number of lines before the target position to include for additional context.
-     */
-    linesBefore?: number;
-}
-/**
- * Enumeration representing bias options for searching in mappings.
- * This can control whether the search favors the closest lower-bound or upper-bound
- * mapping when looking for a corresponding position in the source map.
- */
-export declare const enum Bias {
-    /**
-     * No specific bias is applied when searching for a mapping.
-     */
-    BOUND = 0,
-    /**
-     * Search for the closest lower-bound mapping.
-     */
-    LOWER_BOUND = 1,
-    /**
-     * Search for the closest upper-bound mapping.
-     */
-    UPPER_BOUND = 2
-}

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

@@ -1,399 +0,0 @@
-/**
- * Import will remove at compile time
- */
-import type { PositionInterface, SourceMapInterface, SourceOptionsInterface, PositionSourceInterface } from "./interfaces/source.interface.ts";
-/**
- * Imports
- */
-import { Bias } from "./interfaces/source.interface.ts";
-/**
- * A service for validating and processing source maps.
- */
-export declare class SourceService {
-    /**
-     * The name of the generated file (bundle) that this source map applies to.
-     */
-    readonly file: string | null;
-    /**
-     * The root URL for the sources, if present in the source map.
-     */
-    readonly sourceRoot: string | null;
-    /**
-     * A list of symbol names used by the “mappings” entry.
-     */
-    private readonly names;
-    /**
-     * An array of source file paths.
-     */
-    private readonly sources;
-    /**
-     * A string of base64 VLQ-encoded mappings.
-     */
-    private readonly mappings;
-    /**
-     * An array of source files contents.
-     */
-    private readonly sourcesContent;
-    /**
-     * Creates a new instance of the SourceService class.
-     *
-     * This constructor initializes a `SourceService` instance using the provided source map object.
-     * It performs validation to ensure that the source map contains all required properties.
-     *
-     * @param source - An object conforming to the `SourceMapInterface` representing the source map to be validated and processed.
-     * @throws Error If any required property is missing from the source map object.
-     */
-    constructor(source: SourceMapInterface);
-    /**
-     * Returns a plain object representation of the source map data.
-     *
-     * This method constructs and returns an object that includes key properties of the source map:
-     * - `version`: The version of the source map specification (typically 3).
-     * - `file`: The name of the generated file (optional).
-     * - `names`: An array of function or variable names extracted from the original source code.
-     * - `sources`: An array of file paths for the source files referenced in the mappings.
-     * - `sourceRoot`: An optional root URL for resolving source file paths.
-     * - `mappings`: A base64 VLQ-encoded string representing the source map mappings, generated by `encodeMappings`.
-     * - `sourcesContent`: An optional array containing the content of the source files. This property may not be present in all source maps.
-     *
-     * @returns A plain object conforming to the `SourceMapInterface` structure,
-     *                               representing the source map data.
-     */
-    getMapObject(): SourceMapInterface;
-    /**
-     * Retrieves information about the original source code for a given line and column in the generated code.
-     *
-     * This method looks up the source code mappings to find the corresponding source location and provides additional context based on the provided options.
-     * It can choose to retrieve either the original mapping or the generated mapping based on the `useSource` flag.
-     *
-     * @param line - The line number in the generated code.
-     * @param column - The column number in the generated code.
-     * @param options - Optional configuration for retrieving source information.
-     *   - `linesBefore` (default: 3): Number of lines before the matching source line to include in the context.
-     *   - `linesAfter` (default: 4): Number of lines after the matching source line to include in the context.
-     *   - `includeSourceContent` (default: false): Flag indicating whether to include the relevant source code snippet.
-     * @param useSource - A boolean flag indicating whether to retrieve the original mapping (`true`) or the generated mapping (`false`). Defaults to `false`.
-     * @returns An object containing source location information including:
-     *   - `line`: The line number in the original source code.
-     *   - `column`: The column number in the original source code.
-     *   - `endLine`: The end line number of the included source code snippet.
-     *   - `startLine`: The start line number of the included source code snippet.
-     *   - `name`: The function or variable name at the source position, or null if not available.
-     *   - `source`: The file name of the source code.
-     *   - `code` (if `includeSourceContent` is true): A snippet of the source code surrounding the specified line.
-     *
-     * @returns Null if no matching mapping is found.
-     *
-     * @example
-     * const position = getSourcePosition(10, 5, { linesBefore: 2, linesAfter: 2 }, true);
-     * console.log(position); // Outputs the source position information or null if not found
-     */
-    getSourcePosition(line: number, column: number, options?: SourceOptionsInterface, useSource?: boolean): PositionSourceInterface | null;
-    /**
-     * Retrieves the position information in the original source code for a given line and column in the generated code.
-     *
-     * This method locates the corresponding source code position based on the provided line and column in the generated code.
-     * It uses the specified bias to determine the best match when multiple mappings are possible.
-     *
-     * @param line - The line number in the generated code.
-     * @param column - The column number in the generated code.
-     * @param bias - Optional parameter specifying how to handle cases where only the line number matches:
-     *   - `Bias.LOWER_BOUND` (default): If the line number matches but the column is less, returns the closest mapping with a lower column.
-     *   - `Bias.UPPER_BOUND`: If the line number matches but the column is greater, returns the closest mapping with a higher column.
-     *   - `Bias.BOUND`: If the line number matches but the column doesn't, returns null (default behavior).
-     * @param useSource - Optional parameter that determines whether to use original source mappings (true) or generated mappings (false). Default is false.
-     * @returns A `PositionInterface` object representing the position in the original source code, including:
-     *   - `line`: The line number in the original source code.
-     *   - `column`: The column number in the original source code.
-     *   - `name`: The function or variable name at the source position, or null if not available.
-     *   - `source`: The file name of the original source code.
-     *   - `sourceRoot`: The root path of the source.
-     *   Returns null if no matching position is found.
-     */
-    getPosition(line: number, column: number, bias?: Bias, useSource?: boolean): PositionInterface | null;
-    /**
-     * Merges multiple source maps into this source map object.
-     * The order of the provided source maps must correspond to the order in which the source files were concatenated.
-     *
-     * This method appends the names, sources, and source contents from each provided source map to the current source map.
-     * It also adjusts the mappings to account for the concatenation of the source files.
-     *
-     * @param maps - An array of `SourceMapInterface` instances representing the source maps to be merged.
-     * @throws Error If no source maps are provided for concatenation.
-     *
-     * @example
-     * // Merging two source maps
-     * const map1: SourceMapInterface = { /* ... *\/ };
-     * const map2: SourceMapInterface = { /* ... *\/ };
-     * sourceMapService.concat(map1, map2);
-     */
-    concat(...maps: Array<SourceMapInterface>): void;
-    /**
-     * Converts the source map object to a JSON string representation.
-     *
-     * This method performs the following steps:
-     * 1. Creates a plain object representation of the source map using the `getMapObject` method.
-     * 2. Converts the plain object to a JSON string using `JSON.stringify`.
-     *
-     * @returns A JSON string representation of the source map.
-     *
-     * @example
-     * const sourceMapString = sourceMapService.toString();
-     * // sourceMapString contains the JSON string representation of the source map.
-     */
-    toString(): string;
-    /**
-     * Validates the provided source map object.
-     *
-     * This method checks whether all required keys are present in the source map object.
-     * It throws an error if any required keys are missing.
-     *
-     * @private
-     * @param input - The source map object to be validated.
-     * @throws Error If any required key is missing from the source map.
-     *
-     * @example
-     * const sourceMap = {
-     *     version: 3,
-     *     file: 'example.js',
-     *     names: ['src', 'maps', 'example', 'function', 'line', 'column'],
-     *     sources: ['source1.js', 'source2.js'],
-     *     mappings: 'AAAA,SAASA,CAAC,CAAC,CAAC;AAAA,CAAC,CAAC;AAAC,CAAC',
-     *     sourcesContent: ['console.log("Hello world");', 'console.log("Another file");']
-     * };
-     *
-     * try {
-     *     validateSourceMap(sourceMap);
-     *     console.log('Source map is valid.');
-     * } catch (error) {
-     *     console.error('Invalid source map:', error.message);
-     * }
-     */
-    private validateSourceMap;
-    /**
-     * Decodes and processes the base64 VLQ-encoded mappings from a source map.
-     *
-     * This method interprets the encoded mappings from the `mappings` property of a source map. It adjusts
-     * the shift state for both generated and original positions in the source code, and processes each
-     * decoded mapping segment using the `decodedSegment` method.
-     *
-     * The decoding process involves:
-     * 1. Parsing the base64 VLQ-encoded mappings.
-     * 2. Adjusting the shift state based on the provided `thresholdSegment` or default values.
-     * 3. Handling each decoded mapping segment with the `decodedSegment` method.
-     *
-     * @param encodedMappings - A string representing the encoded mappings in base64 VLQ format. This string
-     *                          is typically found in the `mappings` property of a source map.
-     * @param thresholdSegment - Optional. An object containing offset information that adjusts the starting
-     *                           point for decoding. This can include offsets for line, column, or file index.
-     *                           If not provided, default values are used.
-     * @throws Error - Throws an error if the decoding process encounters an issue, such as an invalid
-     *                 encoding or unexpected format.
-     *
-     * @example
-     * const encodedMappings = 'AAAA,CAAC,CAAC,CAAC,CAAC;AAAA,CAAC,CAAC,CAAC,CAAC';
-     * const threshold = {
-     *     fileIndex: 0,
-     *     nameIndex: 0,
-     *     sourceLine: 1,
-     *     sourceColumn: 1,
-     *     generatedLine: 1,
-     *     generatedColumn: 1
-     * };
-     * try {
-     *     decodeMappings(encodedMappings, threshold);
-     * } catch (error) {
-     *     console.error('Failed to decode mappings:', error.message);
-     * }
-     */
-    private decodeMappings;
-    /**
-     * Processes a decoded VLQ segment and updates the mapping information.
-     *
-     * This method adjusts the current mapping state based on the decoded VLQ segment and the current
-     * line in the generated code. It then updates the internal mappings list with the new information.
-     *
-     * The decoding process involves:
-     * 1. Extracting the mapping details from the `decodedSegment` array.
-     * 2. Updating the shift values for file index, name index, source line, source column, and generated column.
-     * 3. Adding the processed mapping to the internal `mappings` array.
-     *
-     * @param shift - The current state of mapping information. This object tracks the cumulative state
-     *                of file index, name index, source line, source column, and generated column.
-     * @param decodedSegment - An array representing the decoded VLQ segment, containing:
-     *   - `generatedColumn`: The column number in the generated code.
-     *   - `fileIndex`: The index in the sources array.
-     *   - `sourceLine`: The line number in the original source code.
-     *   - `sourceColumn`: The column number in the original source code.
-     *   - `nameIndex`: The index in the names array.
-     * @param generatedLine - The line index in the generated code where this segment applies.
-     *
-     * @example
-     * const shift = {
-     *     fileIndex: 0,
-     *     nameIndex: 0,
-     *     sourceLine: 1,
-     *     sourceColumn: 1,
-     *     generatedLine: 1,
-     *     generatedColumn: 1
-     * };
-     * const decodedSegment = [2, 1, 3, 4, 5];
-     * const generatedLine = 1;
-     * this.decodedSegment(shift, decodedSegment, generatedLine);
-     *
-     * @see ShiftSegmentInterface for details on the `shift` parameter.
-     * @see SourceMapInterface for details on the mapping properties.
-     */
-    private decodedSegment;
-    /**
-     * Encodes an array of mappings into a VLQ-encoded string representation.
-     *
-     * This method converts an array of `MappingInterface` objects into a base64 VLQ-encoded string,
-     * which is used in source maps to represent the mapping between generated and original source code positions.
-     *
-     * The encoding process involves:
-     * 1. Initializing the shift state to track the current line and column in the generated code.
-     * 2. Iterating through the mappings to group them by line number and encode each segment.
-     * 3. Concatenating encoded segments with the appropriate separator characters (`,` and `;`).
-     *
-     * @param mappings - An array of `MappingInterface` objects representing the mappings to encode. Each mapping object contains:
-     *   - `nameIndex`: The index in the names array.
-     *   - `fileIndex`: The index in the sources array.
-     *   - `sourceLine`: The line number in the original source code.
-     *   - `sourceColumn`: The column number in the original source code.
-     *   - `generatedLine`: The line number in the generated code.
-     *   - `generatedColumn`: The column number in the generated code.
-     * @returns A VLQ-encoded string representing the mappings, with segments separated by commas and lines by semicolons.
-     *
-     * @example
-     * const mappings = [
-     *     { nameIndex: 0, fileIndex: 1, sourceLine: 2, sourceColumn: 3, generatedLine: 1, generatedColumn: 4 },
-     *     { nameIndex: 1, fileIndex: 1, sourceLine: 3, sourceColumn: 4, generatedLine: 2, generatedColumn: 5 }
-     * ];
-     * const encodedMappings = this.encodeMappings(mappings);
-     * console.log(encodedMappings); // Outputs the VLQ-encoded string
-     *
-     * @see MappingInterface for details on the mapping properties.
-     */
-    private encodeMappings;
-    /**
-     * Encodes a single segment of the mappings into VLQ format.
-     *
-     * This method processes a `MappingInterface` object and updates the list of encoded segments. It calculates the differences
-     * between the current and previous mapping states, then encodes these differences using VLQ (Variable-Length Quantity) encoding.
-     * The encoded segment is added to the provided `segments` array.
-     *
-     * The encoding process involves:
-     * 1. Calculating the delta values for the file index, source line, source column, and generated column.
-     * 2. Updating the `shift` state to reflect the current mapping information.
-     * 3. Encoding the segment using VLQ and adding it to the `segments` array.
-     *
-     * @param map - The `MappingInterface` object representing a single mapping to encode. This object contains:
-     *   - `nameIndex`: The index in the names array.
-     *   - `fileIndex`: The index in the sources array.
-     *   - `sourceLine`: The line number in the original source code.
-     *   - `sourceColumn`: The column number in the original source code.
-     *   - `generatedColumn`: The column number in the generated code.
-     * @param segments - An array of encoded segments that will be updated with the new encoded segment.
-     * @param shift - The current state of the mapping information, including the latest file index, name index, source line,
-     *                source column, and generated column. This state is updated as new mappings are processed.
-     *
-     * @example
-     * const map: MappingInterface = { nameIndex: 0, fileIndex: 1, sourceLine: 2, sourceColumn: 3, generatedLine: 1, generatedColumn: 4 };
-     * const segments: Array<string> = [];
-     * const shift: ShiftSegmentInterface = { fileIndex: 0, nameIndex: 0, sourceLine: 1, sourceColumn: 1, generatedLine: 1, generatedColumn: 1 };
-     * this.encodeSegment(map, segments, shift);
-     * console.log(segments); // Outputs the encoded VLQ segment
-     *
-     * @see MappingInterface for details on the mapping properties.
-     * @see encodeArrayVLQ for the encoding function used.
-     */
-    private encodeSegment;
-    /**
-     * Performs a binary search on the internal `mappings` array to locate a mapping based on the specified line and column information.
-     * This method efficiently searches for a mapping corresponding to a specific line and column, using binary search for improved performance.
-     *
-     * The method supports optional biasing to refine the search when an exact match is not found:
-     * - **Bias.LOWER_BOUND**: If the line number matches but the column is less, returns the closest mapping with a lower column.
-     * - **Bias.UPPER_BOUND**: If the line number matches but the column is greater, returns the closest mapping with a higher column.
-     * - **Bias.BOUND**: If the line number matches but the column doesn't, returns null. This is the default behavior.
-     *
-     * @param targetLine - The line number to search for. This is the primary criterion for locating the mapping.
-     * @param targetColumn - The column number to search for. This is used in conjunction with the line number.
-     * @param bias - An optional bias value to handle cases where only the line number matches. It influences how the column mismatch
-     *               is resolved.
-     *               - `Bias.LOWER_BOUND`: Return the closest mapping with a lower column if the exact column is not found.
-     *               - `Bias.UPPER_BOUND`: Return the closest mapping with a higher column if the exact column is not found.
-     *               - `Bias.BOUND`: Return null if no exact column match is found. (Default behavior)
-     * @param lineAccessor - A function that retrieves the line property from the mapping being examined, allowing for flexibility
-     *                      in accessing either generated or original lines.
-     * @param columnAccessor - A function that retrieves the column property from the mapping being examined, allowing for flexibility
-     *                        in accessing either generated or original columns.
-     * @returns A `MappingInterface` object representing the found mapping if an exact or biased match is found, or null if no
-     *          appropriate mapping is located.
-     *
-     * @example
-     * const targetLine = 10;
-     * const targetColumn = 5;
-     * const bias = Bias.UPPER_BOUND;
-     * const result = this.findMappingGeneric(targetLine, targetColumn, bias,
-     *     (mapping) => mapping.generatedLine,
-     *     (mapping) => mapping.generatedColumn);
-     * console.log(result); // Outputs the found mapping or null if not found
-     */
-    private findMappingGeneric;
-    /**
-     * Searches for a mapping in the internal `mappings` array based on the specified line and column information in the generated code.
-     * This method utilizes the `findMappingGeneric` function to perform the search, leveraging its binary search mechanism for efficiency.
-     *
-     * The method supports optional biasing to refine the search when an exact match is not found:
-     * - **Bias.LOWER_BOUND**: If the line number matches but the column is less, returns the closest mapping with a lower column.
-     * - **Bias.UPPER_BOUND**: If the line number matches but the column is greater, returns the closest mapping with a higher column.
-     * - **Bias.BOUND**: If the line number matches but the column doesn't, returns null. This is the default behavior.
-     *
-     * @param targetLine - The line number in the generated code to search for. This is the primary criterion for locating the mapping.
-     * @param targetColumn - The column number in the generated code to search for. This is used in conjunction with the line number.
-     * @param bias - An optional bias value to handle cases where only the line number matches. It influences how the column mismatch
-     *               is resolved.
-     *               - `Bias.LOWER_BOUND`: Return the closest mapping with a lower column if the exact column is not found.
-     *               - `Bias.UPPER_BOUND`: Return the closest mapping with a higher column if the exact column is not found.
-     *               - `Bias.BOUND`: Return null if no exact column match is found. (Default behavior)
-     * @returns A `MappingInterface` object representing the found mapping if an exact or biased match is found, or null if no
-     *          appropriate mapping is located.
-     *
-     * @example
-     * const targetLine = 10;
-     * const targetColumn = 5;
-     * const bias = Bias.UPPER_BOUND;
-     * const result = this.findMapping(targetLine, targetColumn, bias);
-     * console.log(result); // Outputs the found mapping or null if not found
-     */
-    private findMapping;
-    /**
-     * Searches for a mapping in the internal `mappings` array based on the specified line and column information in the original source code.
-     * This method utilizes the `findMappingGeneric` function to perform the search, leveraging its binary search mechanism for efficiency.
-     *
-     * The method supports optional biasing to refine the search when an exact match is not found:
-     * - **Bias.LOWER_BOUND**: If the line number matches but the column is less, returns the closest mapping with a lower column.
-     * - **Bias.UPPER_BOUND**: If the line number matches but the column is greater, returns the closest mapping with a higher column.
-     * - **Bias.BOUND**: If the line number matches but the column doesn't, returns null. This is the default behavior.
-     *
-     * @param targetLine - The line number in the original source code to search for. This is the primary criterion for locating the mapping.
-     * @param targetColumn - The column number in the original source code to search for. This is used in conjunction with the line number.
-     * @param bias - An optional bias value to handle cases where only the line number matches. It influences how the column mismatch
-     *               is resolved.
-     *               - `Bias.LOWER_BOUND`: Return the closest mapping with a lower column if the exact column is not found.
-     *               - `Bias.UPPER_BOUND`: Return the closest mapping with a higher column if the exact column is not found.
-     *               - `Bias.BOUND`: Return null if no exact column match is found. (Default behavior)
-     * @returns A `MappingInterface` object representing the found mapping if an exact or biased match is found, or null if no
-     *          appropriate mapping is located.
-     *
-     * @example
-     * const targetLine = 15;
-     * const targetColumn = 10;
-     * const bias = Bias.LOWER_BOUND;
-     * const result = this.findOriginalMapping(targetLine, targetColumn, bias);
-     * console.log(result); // Outputs the found mapping or null if not found
-     */
-    private findOriginalMapping;
-}