metro-source-map 0.83.0 → 0.83.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "metro-source-map",
-  "version": "0.83.0",
+  "version": "0.83.2",
   "description": "🚇 Source map generator for Metro.",
   "main": "src/source-map.js",
   "exports": {
@@ -22,9 +22,9 @@
     "@babel/types": "^7.25.2",
     "flow-enums-runtime": "^0.0.6",
     "invariant": "^2.2.4",
-    "metro-symbolicate": "0.83.0",
+    "metro-symbolicate": "0.83.2",
     "nullthrows": "^1.1.1",
-    "ob1": "0.83.0",
+    "ob1": "0.83.2",
     "source-map": "^0.5.6",
     "vlq": "^1.0.0"
   },
@@ -35,6 +35,6 @@
     "terser": "^5.15.0"
   },
   "engines": {
-    "node": ">=22.14"
+    "node": ">=20.19.4"
   }
 }

package/src/B64Builder.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+/**
+ * Efficient builder for base64 VLQ mappings strings.
+ *
+ * This class uses a buffer that is preallocated with one megabyte and is
+ * reallocated dynamically as needed, doubling its size.
+ *
+ * Encoding never creates any complex value types (strings, objects), and only
+ * writes character values to the buffer.
+ *
+ * For details about source map terminology and specification, check
+ * https://docs.google.com/document/d/1U1RGAehQwRypUTovF1KRlpiOFze0b-_2gc6fAH0KY0k/edit
+ */
+declare class B64Builder {
+  buffer: Buffer;
+  pos: number;
+  hasSegment: boolean;
+  constructor();
+  /**
+   * Adds `n` markers for generated lines to the mappings.
+   */
+  markLines(n: number): this;
+  /**
+   * Starts a segment at the specified column offset in the current line.
+   */
+  startSegment(column: number): this;
+  /**
+   * Appends a single number to the mappings.
+   */
+  append(value: number): this;
+  /**
+   * Returns the string representation of the mappings.
+   */
+  toString(): string;
+  _writeByte(byte: number): void;
+  _realloc(): void;
+}
+export default B64Builder;

package/src/B64Builder.js

@@ -1,6 +1,13 @@
 "use strict";
 
-const encode = require("./encode");
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.default = void 0;
+var _encode = _interopRequireDefault(require("./encode"));
+function _interopRequireDefault(e) {
+  return e && e.__esModule ? e : { default: e };
+}
 const MAX_SEGMENT_LENGTH = 7;
 const ONE_MEG = 1024 * 1024;
 const COMMA = 0x2c;
@@ -37,7 +44,7 @@ class B64Builder {
     if (this.pos + MAX_SEGMENT_LENGTH >= this.buffer.length) {
       this._realloc();
     }
-    this.pos = encode(value, this.buffer, this.pos);
+    this.pos = (0, _encode.default)(value, this.buffer, this.pos);
     return this;
   }
   toString() {
@@ -55,4 +62,4 @@ class B64Builder {
     buffer.copy(this.buffer);
   }
 }
-module.exports = B64Builder;
+exports.default = B64Builder;

package/src/B64Builder.js.flow

@@ -9,9 +9,7 @@
  * @oncall react_native
  */
 
-'use strict';
-
-const encode = require('./encode');
+import encode from './encode';
 
 const MAX_SEGMENT_LENGTH = 7;
 const ONE_MEG = 1024 * 1024;
@@ -30,7 +28,7 @@ const SEMICOLON = 0x3b;
  * For details about source map terminology and specification, check
  * https://docs.google.com/document/d/1U1RGAehQwRypUTovF1KRlpiOFze0b-_2gc6fAH0KY0k/edit
  */
-class B64Builder {
+export default class B64Builder {
   buffer: Buffer;
   pos: number;
   hasSegment: boolean;
@@ -104,5 +102,3 @@ class B64Builder {
     buffer.copy(this.buffer);
   }
 }
-
-module.exports = B64Builder;

package/src/BundleBuilder.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+import type {IndexMap, IndexMapSection, MixedSourceMap} from './source-map';
+/**
+ * Builds a source-mapped bundle by concatenating strings and their
+ * corresponding source maps (if any).
+ *
+ * Usage:
+ *
+ * const builder = new BundleBuilder('bundle.js');
+ * builder
+ *   .append('foo\n', fooMap)
+ *   .append('bar\n')
+ *   // ...
+ * const code = builder.getCode();
+ * const map = builder.getMap();
+ */
+export declare class BundleBuilder {
+  _file: string;
+  _sections: Array<IndexMapSection>;
+  _line: number;
+  _column: number;
+  _code: string;
+  _afterMappedContent: boolean;
+  constructor(file: string);
+  _pushMapSection(map: MixedSourceMap): void;
+  _endMappedContent(): void;
+  append(code: string, map: null | undefined | MixedSourceMap): this;
+  getMap(): MixedSourceMap;
+  getCode(): string;
+}
+export declare function createIndexMap(
+  file: string,
+  sections: Array<IndexMapSection>,
+): IndexMap;

package/src/BundleBuilder.js

@@ -1,5 +1,10 @@
 "use strict";
 
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.BundleBuilder = void 0;
+exports.createIndexMap = createIndexMap;
 const EMPTY_MAP = {
   version: 3,
   sources: [],
@@ -59,6 +64,7 @@ class BundleBuilder {
     return this._code;
   }
 }
+exports.BundleBuilder = BundleBuilder;
 const reLineBreak = /\r\n|\r|\n/g;
 function measureString(str) {
   let lineBreaks = 0;
@@ -81,7 +87,3 @@ function createIndexMap(file, sections) {
     sections,
   };
 }
-module.exports = {
-  BundleBuilder,
-  createIndexMap,
-};

package/src/BundleBuilder.js.flow

@@ -9,8 +9,6 @@
  * @oncall react_native
  */
 
-'use strict';
-
 import type {IndexMap, IndexMapSection, MixedSourceMap} from './source-map';
 
 const EMPTY_MAP = {
@@ -34,7 +32,7 @@ const EMPTY_MAP = {
  * const code = builder.getCode();
  * const map = builder.getMap();
  */
-class BundleBuilder {
+export class BundleBuilder {
   _file: string;
   _sections: Array<IndexMapSection>;
   _line: number;
@@ -114,7 +112,7 @@ function measureString(str: string): {
   return {lineBreaks, lastLineColumns};
 }
 
-function createIndexMap(
+export function createIndexMap(
   file: string,
   sections: Array<IndexMapSection>,
 ): IndexMap {
@@ -124,5 +122,3 @@ function createIndexMap(
     sections,
   };
 }
-
-module.exports = {BundleBuilder, createIndexMap};

package/src/Consumer/AbstractConsumer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+import type {
+  GeneratedPositionLookup,
+  IConsumer,
+  IterationOrder,
+  Mapping,
+  SourcePosition,
+} from './types';
+
+declare class AbstractConsumer implements IConsumer {
+  _sourceMap: {readonly file?: string};
+  constructor(sourceMap: {readonly file?: string});
+  originalPositionFor(
+    generatedPosition: GeneratedPositionLookup,
+  ): SourcePosition;
+  generatedMappings(): Iterable<Mapping>;
+  eachMapping(
+    callback: (mapping: Mapping) => unknown,
+    context?: unknown,
+    order?: IterationOrder,
+  ): void;
+  get file(): null | undefined | string;
+  sourceContentFor(
+    source: string,
+    nullOnMissing: true,
+  ): null | undefined | string;
+}
+export default AbstractConsumer;

package/src/Consumer/AbstractConsumer.js

@@ -1,21 +1,28 @@
 "use strict";
 
-const { GENERATED_ORDER, iterationOrderToString } = require("./constants");
-const invariant = require("invariant");
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.default = void 0;
+var _constants = require("./constants");
+var _invariant = _interopRequireDefault(require("invariant"));
+function _interopRequireDefault(e) {
+  return e && e.__esModule ? e : { default: e };
+}
 class AbstractConsumer {
   constructor(sourceMap) {
     this._sourceMap = sourceMap;
   }
   originalPositionFor(generatedPosition) {
-    invariant(false, "Not implemented");
+    (0, _invariant.default)(false, "Not implemented");
   }
   generatedMappings() {
-    invariant(false, "Not implemented");
+    (0, _invariant.default)(false, "Not implemented");
   }
-  eachMapping(callback, context = null, order = GENERATED_ORDER) {
-    invariant(
-      order === GENERATED_ORDER,
-      `Iteration order not implemented: ${iterationOrderToString(order)}`
+  eachMapping(callback, context = null, order = _constants.GENERATED_ORDER) {
+    (0, _invariant.default)(
+      order === _constants.GENERATED_ORDER,
+      `Iteration order not implemented: ${(0, _constants.iterationOrderToString)(order)}`,
     );
     for (const mapping of this.generatedMappings()) {
       callback.call(context, mapping);
@@ -25,7 +32,7 @@ class AbstractConsumer {
     return this._sourceMap.file;
   }
   sourceContentFor(source, nullOnMissing) {
-    invariant(false, "Not implemented");
+    (0, _invariant.default)(false, "Not implemented");
   }
 }
-module.exports = AbstractConsumer;
+exports.default = AbstractConsumer;

package/src/Consumer/AbstractConsumer.js.flow

@@ -9,21 +9,19 @@
  * @oncall react_native
  */
 
-'use strict';
-
 import type {
   GeneratedPositionLookup,
   IConsumer,
   IterationOrder,
   Mapping,
   SourcePosition,
-} from './types.flow';
+} from './types';
 
-const {GENERATED_ORDER, iterationOrderToString} = require('./constants');
-const invariant = require('invariant');
+import {GENERATED_ORDER, iterationOrderToString} from './constants';
+import invariant from 'invariant';
 
 // Implementation details shared between MappingsConsumer and SectionsConsumer
-class AbstractConsumer implements IConsumer {
+export default class AbstractConsumer implements IConsumer {
   _sourceMap: {+file?: string, ...};
 
   constructor(sourceMap: {+file?: string, ...}) {
@@ -63,5 +61,3 @@ class AbstractConsumer implements IConsumer {
     invariant(false, 'Not implemented');
   }
 }
-
-module.exports = AbstractConsumer;

package/src/Consumer/DelegatingConsumer.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+import type {MixedSourceMap} from '../source-map';
+import type {LookupBias} from './constants.js';
+import type {
+  GeneratedPositionLookup,
+  IConsumer,
+  IterationOrder,
+  Mapping,
+  SourcePosition,
+} from './types';
+/**
+ * A source map consumer that supports both "basic" and "indexed" source maps.
+ * Uses `MappingsConsumer` and `SectionsConsumer` under the hood (via
+ * `createConsumer`).
+ */
+declare class DelegatingConsumer implements IConsumer {
+  static readonly GENERATED_ORDER: IterationOrder;
+  static readonly ORIGINAL_ORDER: IterationOrder;
+  static readonly GREATEST_LOWER_BOUND: LookupBias;
+  static readonly LEAST_UPPER_BOUND: LookupBias;
+  _rootConsumer: IConsumer;
+  constructor(sourceMap: MixedSourceMap);
+  originalPositionFor(
+    generatedPosition: GeneratedPositionLookup,
+  ): SourcePosition;
+  generatedMappings(): Iterable<Mapping>;
+  eachMapping(
+    callback: (mapping: Mapping) => unknown,
+    context?: unknown,
+    order?: IterationOrder,
+  ): void;
+  get file(): null | undefined | string;
+  sourceContentFor(
+    source: string,
+    nullOnMissing: true,
+  ): null | undefined | string;
+}
+export default DelegatingConsumer;

package/src/Consumer/DelegatingConsumer.js

@@ -1,19 +1,21 @@
 "use strict";
 
-const {
-  GENERATED_ORDER,
-  GREATEST_LOWER_BOUND,
-  LEAST_UPPER_BOUND,
-  ORIGINAL_ORDER,
-} = require("./constants");
-const createConsumer = require("./createConsumer");
+Object.defineProperty(exports, "__esModule", {
+  value: true,
+});
+exports.default = void 0;
+var _constants = require("./constants");
+var _createConsumer = _interopRequireDefault(require("./createConsumer"));
+function _interopRequireDefault(e) {
+  return e && e.__esModule ? e : { default: e };
+}
 class DelegatingConsumer {
-  static GENERATED_ORDER = GENERATED_ORDER;
-  static ORIGINAL_ORDER = ORIGINAL_ORDER;
-  static GREATEST_LOWER_BOUND = GREATEST_LOWER_BOUND;
-  static LEAST_UPPER_BOUND = LEAST_UPPER_BOUND;
+  static GENERATED_ORDER = _constants.GENERATED_ORDER;
+  static ORIGINAL_ORDER = _constants.ORIGINAL_ORDER;
+  static GREATEST_LOWER_BOUND = _constants.GREATEST_LOWER_BOUND;
+  static LEAST_UPPER_BOUND = _constants.LEAST_UPPER_BOUND;
   constructor(sourceMap) {
-    this._rootConsumer = createConsumer(sourceMap);
+    this._rootConsumer = (0, _createConsumer.default)(sourceMap);
     return this._rootConsumer;
   }
   originalPositionFor(generatedPosition) {
@@ -32,4 +34,4 @@ class DelegatingConsumer {
     return this._rootConsumer.sourceContentFor(source, nullOnMissing);
   }
 }
-module.exports = DelegatingConsumer;
+exports.default = DelegatingConsumer;

package/src/Consumer/DelegatingConsumer.js.flow

@@ -9,7 +9,6 @@
  * @oncall react_native
  */
 
-'use strict';
 import type {MixedSourceMap} from '../source-map';
 import type {LookupBias} from './constants.js';
 import type {
@@ -18,22 +17,22 @@ import type {
   IterationOrder,
   Mapping,
   SourcePosition,
-} from './types.flow';
+} from './types';
 
-const {
+import {
   GENERATED_ORDER,
   GREATEST_LOWER_BOUND,
   LEAST_UPPER_BOUND,
   ORIGINAL_ORDER,
-} = require('./constants');
-const createConsumer = require('./createConsumer');
+} from './constants';
+import createConsumer from './createConsumer';
 
 /**
  * A source map consumer that supports both "basic" and "indexed" source maps.
  * Uses `MappingsConsumer` and `SectionsConsumer` under the hood (via
  * `createConsumer`).
  */
-class DelegatingConsumer implements IConsumer {
+export default class DelegatingConsumer implements IConsumer {
   static +GENERATED_ORDER: IterationOrder = GENERATED_ORDER;
   static +ORIGINAL_ORDER: IterationOrder = ORIGINAL_ORDER;
   static +GREATEST_LOWER_BOUND: LookupBias = GREATEST_LOWER_BOUND;
@@ -41,7 +40,7 @@ class DelegatingConsumer implements IConsumer {
 
   _rootConsumer: IConsumer;
 
-  // $FlowFixMe[incompatible-return]
+  // $FlowFixMe[incompatible-type]
   constructor(sourceMap: MixedSourceMap): IConsumer {
     this._rootConsumer = createConsumer(sourceMap);
     return this._rootConsumer;
@@ -74,5 +73,3 @@ class DelegatingConsumer implements IConsumer {
     return this._rootConsumer.sourceContentFor(source, nullOnMissing);
   }
 }
-
-module.exports = DelegatingConsumer;

package/src/Consumer/MappingsConsumer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @format
+ * @oncall react_native
+ */
+
+import type {BasicSourceMap} from '../source-map';
+import type {
+  GeneratedPositionLookup,
+  IConsumer,
+  Mapping,
+  SourcePosition,
+} from './types';
+import type {Number0} from 'ob1';
+
+import AbstractConsumer from './AbstractConsumer';
+/**
+ * A source map consumer that supports "basic" source maps (that have a
+ * `mappings` field and no sections).
+ */
+declare class MappingsConsumer extends AbstractConsumer implements IConsumer {
+  _sourceMap: BasicSourceMap;
+  _decodedMappings: null | undefined | ReadonlyArray<Mapping>;
+  _normalizedSources: null | undefined | ReadonlyArray<string>;
+  constructor(sourceMap: BasicSourceMap);
+  originalPositionFor(
+    generatedPosition: GeneratedPositionLookup,
+  ): SourcePosition;
+  _decodeMappings(): Generator<Mapping, void, void>;
+  _normalizeAndCacheSources(): ReadonlyArray<string>;
+  _decodeAndCacheMappings(): ReadonlyArray<Mapping>;
+  generatedMappings(): Iterable<Mapping>;
+  _indexOfSource(source: string): null | undefined | Number0;
+  sourceContentFor(
+    source: string,
+    nullOnMissing: true,
+  ): null | undefined | string;
+}
+export default MappingsConsumer;