@remotex-labs/xmap 3.0.1 → 3.0.3

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

@@ -1,216 +0,0 @@
-/**
- * Import will remove at compile time
- */
-import type { PositionInterface, SourceMapInterface, SourceOptionsInterface, PositionWithCodeInterface, PositionWithContentInterface } from "./interfaces/source-service.interface";
-/**
- * Imports
- */
-import { MappingProvider } from "../providers/mapping.provider";
-import { Bias } from "../providers/interfaces/mapping-provider.interface";
-/**
- * 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
- *
- * @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'
- * ```
- *
- * @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;
-}