summaryrefslogtreecommitdiff
path: root/node_modules/@jridgewell/gen-mapping/src/gen-mapping.ts
diff options
context:
space:
mode:
authorChristian Cleberg <[email protected]>2026-04-18 22:32:53 -0500
committerChristian Cleberg <[email protected]>2026-04-18 22:32:53 -0500
commit580e798e16346eb894eb899edac82d2efdf40adc (patch)
tree6dec3b7db678f781138b40d34da37d21ac8fbe7d /node_modules/@jridgewell/gen-mapping/src/gen-mapping.ts
downloadbrand-bench-580e798e16346eb894eb899edac82d2efdf40adc.tar.gz
brand-bench-580e798e16346eb894eb899edac82d2efdf40adc.tar.bz2
brand-bench-580e798e16346eb894eb899edac82d2efdf40adc.zip
initial commit
Diffstat (limited to 'node_modules/@jridgewell/gen-mapping/src/gen-mapping.ts')
-rw-r--r--node_modules/@jridgewell/gen-mapping/src/gen-mapping.ts614
1 files changed, 614 insertions, 0 deletions
diff --git a/node_modules/@jridgewell/gen-mapping/src/gen-mapping.ts b/node_modules/@jridgewell/gen-mapping/src/gen-mapping.ts
new file mode 100644
index 0000000..ecc878c
--- /dev/null
+++ b/node_modules/@jridgewell/gen-mapping/src/gen-mapping.ts
@@ -0,0 +1,614 @@
+import { SetArray, put, remove } from './set-array';
+import {
+ encode,
+ // encodeGeneratedRanges,
+ // encodeOriginalScopes
+} from '@jridgewell/sourcemap-codec';
+import { TraceMap, decodedMappings } from '@jridgewell/trace-mapping';
+
+import {
+ COLUMN,
+ SOURCES_INDEX,
+ SOURCE_LINE,
+ SOURCE_COLUMN,
+ NAMES_INDEX,
+} from './sourcemap-segment';
+
+import type { SourceMapInput } from '@jridgewell/trace-mapping';
+// import type { OriginalScope, GeneratedRange } from '@jridgewell/sourcemap-codec';
+import type { SourceMapSegment } from './sourcemap-segment';
+import type {
+ DecodedSourceMap,
+ EncodedSourceMap,
+ Pos,
+ Mapping,
+ // BindingExpressionRange,
+ // OriginalPos,
+ // OriginalScopeInfo,
+ // GeneratedRangeInfo,
+} from './types';
+
+export type { DecodedSourceMap, EncodedSourceMap, Mapping };
+
+export type Options = {
+ file?: string | null;
+ sourceRoot?: string | null;
+};
+
+const NO_NAME = -1;
+
+/**
+ * Provides the state to generate a sourcemap.
+ */
+export class GenMapping {
+ declare private _names: SetArray<string>;
+ declare private _sources: SetArray<string>;
+ declare private _sourcesContent: (string | null)[];
+ declare private _mappings: SourceMapSegment[][];
+ // private declare _originalScopes: OriginalScope[][];
+ // private declare _generatedRanges: GeneratedRange[];
+ declare private _ignoreList: SetArray<number>;
+ declare file: string | null | undefined;
+ declare sourceRoot: string | null | undefined;
+
+ constructor({ file, sourceRoot }: Options = {}) {
+ this._names = new SetArray();
+ this._sources = new SetArray();
+ this._sourcesContent = [];
+ this._mappings = [];
+ // this._originalScopes = [];
+ // this._generatedRanges = [];
+ this.file = file;
+ this.sourceRoot = sourceRoot;
+ this._ignoreList = new SetArray();
+ }
+}
+
+interface PublicMap {
+ _names: GenMapping['_names'];
+ _sources: GenMapping['_sources'];
+ _sourcesContent: GenMapping['_sourcesContent'];
+ _mappings: GenMapping['_mappings'];
+ // _originalScopes: GenMapping['_originalScopes'];
+ // _generatedRanges: GenMapping['_generatedRanges'];
+ _ignoreList: GenMapping['_ignoreList'];
+}
+
+/**
+ * Typescript doesn't allow friend access to private fields, so this just casts the map into a type
+ * with public access modifiers.
+ */
+function cast(map: unknown): PublicMap {
+ return map as any;
+}
+
+/**
+ * A low-level API to associate a generated position with an original source position. Line and
+ * column here are 0-based, unlike `addMapping`.
+ */
+export function addSegment(
+ map: GenMapping,
+ genLine: number,
+ genColumn: number,
+ source?: null,
+ sourceLine?: null,
+ sourceColumn?: null,
+ name?: null,
+ content?: null,
+): void;
+export function addSegment(
+ map: GenMapping,
+ genLine: number,
+ genColumn: number,
+ source: string,
+ sourceLine: number,
+ sourceColumn: number,
+ name?: null,
+ content?: string | null,
+): void;
+export function addSegment(
+ map: GenMapping,
+ genLine: number,
+ genColumn: number,
+ source: string,
+ sourceLine: number,
+ sourceColumn: number,
+ name: string,
+ content?: string | null,
+): void;
+export function addSegment(
+ map: GenMapping,
+ genLine: number,
+ genColumn: number,
+ source?: string | null,
+ sourceLine?: number | null,
+ sourceColumn?: number | null,
+ name?: string | null,
+ content?: string | null,
+): void {
+ return addSegmentInternal(
+ false,
+ map,
+ genLine,
+ genColumn,
+ source,
+ sourceLine,
+ sourceColumn,
+ name,
+ content,
+ );
+}
+
+/**
+ * A high-level API to associate a generated position with an original source position. Line is
+ * 1-based, but column is 0-based, due to legacy behavior in `source-map` library.
+ */
+export function addMapping(
+ map: GenMapping,
+ mapping: {
+ generated: Pos;
+ source?: null;
+ original?: null;
+ name?: null;
+ content?: null;
+ },
+): void;
+export function addMapping(
+ map: GenMapping,
+ mapping: {
+ generated: Pos;
+ source: string;
+ original: Pos;
+ name?: null;
+ content?: string | null;
+ },
+): void;
+export function addMapping(
+ map: GenMapping,
+ mapping: {
+ generated: Pos;
+ source: string;
+ original: Pos;
+ name: string;
+ content?: string | null;
+ },
+): void;
+export function addMapping(
+ map: GenMapping,
+ mapping: {
+ generated: Pos;
+ source?: string | null;
+ original?: Pos | null;
+ name?: string | null;
+ content?: string | null;
+ },
+): void {
+ return addMappingInternal(false, map, mapping as Parameters<typeof addMappingInternal>[2]);
+}
+
+/**
+ * Same as `addSegment`, but will only add the segment if it generates useful information in the
+ * resulting map. This only works correctly if segments are added **in order**, meaning you should
+ * not add a segment with a lower generated line/column than one that came before.
+ */
+export const maybeAddSegment: typeof addSegment = (
+ map,
+ genLine,
+ genColumn,
+ source,
+ sourceLine,
+ sourceColumn,
+ name,
+ content,
+) => {
+ return addSegmentInternal(
+ true,
+ map,
+ genLine,
+ genColumn,
+ source,
+ sourceLine,
+ sourceColumn,
+ name,
+ content,
+ );
+};
+
+/**
+ * Same as `addMapping`, but will only add the mapping if it generates useful information in the
+ * resulting map. This only works correctly if mappings are added **in order**, meaning you should
+ * not add a mapping with a lower generated line/column than one that came before.
+ */
+export const maybeAddMapping: typeof addMapping = (map, mapping) => {
+ return addMappingInternal(true, map, mapping as Parameters<typeof addMappingInternal>[2]);
+};
+
+/**
+ * Adds/removes the content of the source file to the source map.
+ */
+export function setSourceContent(map: GenMapping, source: string, content: string | null): void {
+ const {
+ _sources: sources,
+ _sourcesContent: sourcesContent,
+ // _originalScopes: originalScopes,
+ } = cast(map);
+ const index = put(sources, source);
+ sourcesContent[index] = content;
+ // if (index === originalScopes.length) originalScopes[index] = [];
+}
+
+export function setIgnore(map: GenMapping, source: string, ignore = true) {
+ const {
+ _sources: sources,
+ _sourcesContent: sourcesContent,
+ _ignoreList: ignoreList,
+ // _originalScopes: originalScopes,
+ } = cast(map);
+ const index = put(sources, source);
+ if (index === sourcesContent.length) sourcesContent[index] = null;
+ // if (index === originalScopes.length) originalScopes[index] = [];
+ if (ignore) put(ignoreList, index);
+ else remove(ignoreList, index);
+}
+
+/**
+ * Returns a sourcemap object (with decoded mappings) suitable for passing to a library that expects
+ * a sourcemap, or to JSON.stringify.
+ */
+export function toDecodedMap(map: GenMapping): DecodedSourceMap {
+ const {
+ _mappings: mappings,
+ _sources: sources,
+ _sourcesContent: sourcesContent,
+ _names: names,
+ _ignoreList: ignoreList,
+ // _originalScopes: originalScopes,
+ // _generatedRanges: generatedRanges,
+ } = cast(map);
+ removeEmptyFinalLines(mappings);
+
+ return {
+ version: 3,
+ file: map.file || undefined,
+ names: names.array,
+ sourceRoot: map.sourceRoot || undefined,
+ sources: sources.array,
+ sourcesContent,
+ mappings,
+ // originalScopes,
+ // generatedRanges,
+ ignoreList: ignoreList.array,
+ };
+}
+
+/**
+ * Returns a sourcemap object (with encoded mappings) suitable for passing to a library that expects
+ * a sourcemap, or to JSON.stringify.
+ */
+export function toEncodedMap(map: GenMapping): EncodedSourceMap {
+ const decoded = toDecodedMap(map);
+ return Object.assign({}, decoded, {
+ // originalScopes: decoded.originalScopes.map((os) => encodeOriginalScopes(os)),
+ // generatedRanges: encodeGeneratedRanges(decoded.generatedRanges as GeneratedRange[]),
+ mappings: encode(decoded.mappings as SourceMapSegment[][]),
+ });
+}
+
+/**
+ * Constructs a new GenMapping, using the already present mappings of the input.
+ */
+export function fromMap(input: SourceMapInput): GenMapping {
+ const map = new TraceMap(input);
+ const gen = new GenMapping({ file: map.file, sourceRoot: map.sourceRoot });
+
+ putAll(cast(gen)._names, map.names);
+ putAll(cast(gen)._sources, map.sources as string[]);
+ cast(gen)._sourcesContent = map.sourcesContent || map.sources.map(() => null);
+ cast(gen)._mappings = decodedMappings(map) as GenMapping['_mappings'];
+ // TODO: implement originalScopes/generatedRanges
+ if (map.ignoreList) putAll(cast(gen)._ignoreList, map.ignoreList);
+
+ return gen;
+}
+
+/**
+ * Returns an array of high-level mapping objects for every recorded segment, which could then be
+ * passed to the `source-map` library.
+ */
+export function allMappings(map: GenMapping): Mapping[] {
+ const out: Mapping[] = [];
+ const { _mappings: mappings, _sources: sources, _names: names } = cast(map);
+
+ for (let i = 0; i < mappings.length; i++) {
+ const line = mappings[i];
+ for (let j = 0; j < line.length; j++) {
+ const seg = line[j];
+
+ const generated = { line: i + 1, column: seg[COLUMN] };
+ let source: string | undefined = undefined;
+ let original: Pos | undefined = undefined;
+ let name: string | undefined = undefined;
+
+ if (seg.length !== 1) {
+ source = sources.array[seg[SOURCES_INDEX]];
+ original = { line: seg[SOURCE_LINE] + 1, column: seg[SOURCE_COLUMN] };
+
+ if (seg.length === 5) name = names.array[seg[NAMES_INDEX]];
+ }
+
+ out.push({ generated, source, original, name } as Mapping);
+ }
+ }
+
+ return out;
+}
+
+// This split declaration is only so that terser can elminiate the static initialization block.
+function addSegmentInternal<S extends string | null | undefined>(
+ skipable: boolean,
+ map: GenMapping,
+ genLine: number,
+ genColumn: number,
+ source: S,
+ sourceLine: S extends string ? number : null | undefined,
+ sourceColumn: S extends string ? number : null | undefined,
+ name: S extends string ? string | null | undefined : null | undefined,
+ content: S extends string ? string | null | undefined : null | undefined,
+): void {
+ const {
+ _mappings: mappings,
+ _sources: sources,
+ _sourcesContent: sourcesContent,
+ _names: names,
+ // _originalScopes: originalScopes,
+ } = cast(map);
+ const line = getIndex(mappings, genLine);
+ const index = getColumnIndex(line, genColumn);
+
+ if (!source) {
+ if (skipable && skipSourceless(line, index)) return;
+ return insert(line, index, [genColumn]);
+ }
+
+ // Sigh, TypeScript can't figure out sourceLine and sourceColumn aren't nullish if source
+ // isn't nullish.
+ assert<number>(sourceLine);
+ assert<number>(sourceColumn);
+
+ const sourcesIndex = put(sources, source);
+ const namesIndex = name ? put(names, name) : NO_NAME;
+ if (sourcesIndex === sourcesContent.length) sourcesContent[sourcesIndex] = content ?? null;
+ // if (sourcesIndex === originalScopes.length) originalScopes[sourcesIndex] = [];
+
+ if (skipable && skipSource(line, index, sourcesIndex, sourceLine, sourceColumn, namesIndex)) {
+ return;
+ }
+
+ return insert(
+ line,
+ index,
+ name
+ ? [genColumn, sourcesIndex, sourceLine, sourceColumn, namesIndex]
+ : [genColumn, sourcesIndex, sourceLine, sourceColumn],
+ );
+}
+
+function assert<T>(_val: unknown): asserts _val is T {
+ // noop.
+}
+
+function getIndex<T>(arr: T[][], index: number): T[] {
+ for (let i = arr.length; i <= index; i++) {
+ arr[i] = [];
+ }
+ return arr[index];
+}
+
+function getColumnIndex(line: SourceMapSegment[], genColumn: number): number {
+ let index = line.length;
+ for (let i = index - 1; i >= 0; index = i--) {
+ const current = line[i];
+ if (genColumn >= current[COLUMN]) break;
+ }
+ return index;
+}
+
+function insert<T>(array: T[], index: number, value: T) {
+ for (let i = array.length; i > index; i--) {
+ array[i] = array[i - 1];
+ }
+ array[index] = value;
+}
+
+function removeEmptyFinalLines(mappings: SourceMapSegment[][]) {
+ const { length } = mappings;
+ let len = length;
+ for (let i = len - 1; i >= 0; len = i, i--) {
+ if (mappings[i].length > 0) break;
+ }
+ if (len < length) mappings.length = len;
+}
+
+function putAll<T extends string | number>(setarr: SetArray<T>, array: T[]) {
+ for (let i = 0; i < array.length; i++) put(setarr, array[i]);
+}
+
+function skipSourceless(line: SourceMapSegment[], index: number): boolean {
+ // The start of a line is already sourceless, so adding a sourceless segment to the beginning
+ // doesn't generate any useful information.
+ if (index === 0) return true;
+
+ const prev = line[index - 1];
+ // If the previous segment is also sourceless, then adding another sourceless segment doesn't
+ // genrate any new information. Else, this segment will end the source/named segment and point to
+ // a sourceless position, which is useful.
+ return prev.length === 1;
+}
+
+function skipSource(
+ line: SourceMapSegment[],
+ index: number,
+ sourcesIndex: number,
+ sourceLine: number,
+ sourceColumn: number,
+ namesIndex: number,
+): boolean {
+ // A source/named segment at the start of a line gives position at that genColumn
+ if (index === 0) return false;
+
+ const prev = line[index - 1];
+
+ // If the previous segment is sourceless, then we're transitioning to a source.
+ if (prev.length === 1) return false;
+
+ // If the previous segment maps to the exact same source position, then this segment doesn't
+ // provide any new position information.
+ return (
+ sourcesIndex === prev[SOURCES_INDEX] &&
+ sourceLine === prev[SOURCE_LINE] &&
+ sourceColumn === prev[SOURCE_COLUMN] &&
+ namesIndex === (prev.length === 5 ? prev[NAMES_INDEX] : NO_NAME)
+ );
+}
+
+function addMappingInternal<S extends string | null | undefined>(
+ skipable: boolean,
+ map: GenMapping,
+ mapping: {
+ generated: Pos;
+ source: S;
+ original: S extends string ? Pos : null | undefined;
+ name: S extends string ? string | null | undefined : null | undefined;
+ content: S extends string ? string | null | undefined : null | undefined;
+ },
+) {
+ const { generated, source, original, name, content } = mapping;
+ if (!source) {
+ return addSegmentInternal(
+ skipable,
+ map,
+ generated.line - 1,
+ generated.column,
+ null,
+ null,
+ null,
+ null,
+ null,
+ );
+ }
+ assert<Pos>(original);
+ return addSegmentInternal(
+ skipable,
+ map,
+ generated.line - 1,
+ generated.column,
+ source as string,
+ original.line - 1,
+ original.column,
+ name,
+ content,
+ );
+}
+
+/*
+export function addOriginalScope(
+ map: GenMapping,
+ data: {
+ start: Pos;
+ end: Pos;
+ source: string;
+ kind: string;
+ name?: string;
+ variables?: string[];
+ },
+): OriginalScopeInfo {
+ const { start, end, source, kind, name, variables } = data;
+ const {
+ _sources: sources,
+ _sourcesContent: sourcesContent,
+ _originalScopes: originalScopes,
+ _names: names,
+ } = cast(map);
+ const index = put(sources, source);
+ if (index === sourcesContent.length) sourcesContent[index] = null;
+ if (index === originalScopes.length) originalScopes[index] = [];
+
+ const kindIndex = put(names, kind);
+ const scope: OriginalScope = name
+ ? [start.line - 1, start.column, end.line - 1, end.column, kindIndex, put(names, name)]
+ : [start.line - 1, start.column, end.line - 1, end.column, kindIndex];
+ if (variables) {
+ scope.vars = variables.map((v) => put(names, v));
+ }
+ const len = originalScopes[index].push(scope);
+ return [index, len - 1, variables];
+}
+*/
+
+// Generated Ranges
+/*
+export function addGeneratedRange(
+ map: GenMapping,
+ data: {
+ start: Pos;
+ isScope: boolean;
+ originalScope?: OriginalScopeInfo;
+ callsite?: OriginalPos;
+ },
+): GeneratedRangeInfo {
+ const { start, isScope, originalScope, callsite } = data;
+ const {
+ _originalScopes: originalScopes,
+ _sources: sources,
+ _sourcesContent: sourcesContent,
+ _generatedRanges: generatedRanges,
+ } = cast(map);
+
+ const range: GeneratedRange = [
+ start.line - 1,
+ start.column,
+ 0,
+ 0,
+ originalScope ? originalScope[0] : -1,
+ originalScope ? originalScope[1] : -1,
+ ];
+ if (originalScope?.[2]) {
+ range.bindings = originalScope[2].map(() => [[-1]]);
+ }
+ if (callsite) {
+ const index = put(sources, callsite.source);
+ if (index === sourcesContent.length) sourcesContent[index] = null;
+ if (index === originalScopes.length) originalScopes[index] = [];
+ range.callsite = [index, callsite.line - 1, callsite.column];
+ }
+ if (isScope) range.isScope = true;
+ generatedRanges.push(range);
+
+ return [range, originalScope?.[2]];
+}
+
+export function setEndPosition(range: GeneratedRangeInfo, pos: Pos) {
+ range[0][2] = pos.line - 1;
+ range[0][3] = pos.column;
+}
+
+export function addBinding(
+ map: GenMapping,
+ range: GeneratedRangeInfo,
+ variable: string,
+ expression: string | BindingExpressionRange,
+) {
+ const { _names: names } = cast(map);
+ const bindings = (range[0].bindings ||= []);
+ const vars = range[1];
+
+ const index = vars!.indexOf(variable);
+ const binding = getIndex(bindings, index);
+
+ if (typeof expression === 'string') binding[0] = [put(names, expression)];
+ else {
+ const { start } = expression;
+ binding.push([put(names, expression.expression), start.line - 1, start.column]);
+ }
+}
+*/