@epic-web/workshop-app 4.6.5 → 4.7.0

package/node_modules/{@remix-run/server-runtime/node_modules/source-map → source-map}/README.md

@@ -2,8 +2,6 @@
 
 [![Build Status](https://travis-ci.org/mozilla/source-map.png?branch=master)](https://travis-ci.org/mozilla/source-map)
 
-[![Coverage Status](https://coveralls.io/repos/github/mozilla/source-map/badge.svg)](https://coveralls.io/github/mozilla/source-map)
-
 [![NPM](https://nodei.co/npm/source-map.png?downloads=true&downloadRank=true)](https://www.npmjs.com/package/source-map)
 
 This is a library to generate and consume the source map format
@@ -17,12 +15,7 @@ This is a library to generate and consume the source map format
 
 ## Use on the Web
 
-    <script src="https://unpkg.com/source-map@0.7.3/dist/source-map.js"></script>
-    <script>
-        sourceMap.SourceMapConsumer.initialize({
-            "lib/mappings.wasm": "https://unpkg.com/source-map@0.7.3/lib/mappings.wasm"
-        });
-    </script>
+    <script src="https://raw.githubusercontent.com/mozilla/source-map/master/dist/source-map.min.js" defer></script>
 
 --------------------------------------------------------------------------------
 
@@ -39,10 +32,7 @@ This is a library to generate and consume the source map format
     - [With SourceMapGenerator (low level API)](#with-sourcemapgenerator-low-level-api)
 - [API](#api)
   - [SourceMapConsumer](#sourcemapconsumer)
-    - [SourceMapConsumer.initialize(options)](#sourcemapconsumerinitializeoptions)
     - [new SourceMapConsumer(rawSourceMap)](#new-sourcemapconsumerrawsourcemap)
-    - [SourceMapConsumer.with](#sourcemapconsumerwith)
-    - [SourceMapConsumer.prototype.destroy()](#sourcemapconsumerprototypedestroy)
     - [SourceMapConsumer.prototype.computeColumnSpans()](#sourcemapconsumerprototypecomputecolumnspans)
     - [SourceMapConsumer.prototype.originalPositionFor(generatedPosition)](#sourcemapconsumerprototypeoriginalpositionforgeneratedposition)
     - [SourceMapConsumer.prototype.generatedPositionFor(originalPosition)](#sourcemapconsumerprototypegeneratedpositionfororiginalposition)
@@ -77,7 +67,7 @@ This is a library to generate and consume the source map format
 ### Consuming a source map
 
 ```js
-const rawSourceMap = {
+var rawSourceMap = {
   version: 3,
   file: 'min.js',
   names: ['bar', 'baz', 'n'],
@@ -86,33 +76,30 @@ const rawSourceMap = {
   mappings: 'CAAC,IAAI,IAAM,SAAUA,GAClB,OAAOC,IAAID;CCDb,IAAI,IAAM,SAAUE,GAClB,OAAOA'
 };
 
-const whatever = await SourceMapConsumer.with(rawSourceMap, null, consumer => {
-
-  console.log(consumer.sources);
-  // [ 'http://example.com/www/js/one.js',
-  //   'http://example.com/www/js/two.js' ]
-
-  console.log(consumer.originalPositionFor({
-    line: 2,
-    column: 28
-  }));
-  // { source: 'http://example.com/www/js/two.js',
-  //   line: 2,
-  //   column: 10,
-  //   name: 'n' }
-
-  console.log(consumer.generatedPositionFor({
-    source: 'http://example.com/www/js/two.js',
-    line: 2,
-    column: 10
-  }));
-  // { line: 2, column: 28 }
-
-  consumer.eachMapping(function (m) {
-    // ...
-  });
-
-  return computeWhatever();
+var smc = new SourceMapConsumer(rawSourceMap);
+
+console.log(smc.sources);
+// [ 'http://example.com/www/js/one.js',
+//   'http://example.com/www/js/two.js' ]
+
+console.log(smc.originalPositionFor({
+  line: 2,
+  column: 28
+}));
+// { source: 'http://example.com/www/js/two.js',
+//   line: 2,
+//   column: 10,
+//   name: 'n' }
+
+console.log(smc.generatedPositionFor({
+  source: 'http://example.com/www/js/two.js',
+  line: 2,
+  column: 10
+}));
+// { line: 2, column: 28 }
+
+smc.eachMapping(function (m) {
+  // ...
 });
 ```
 
@@ -195,27 +182,10 @@ const sourceMap = require("devtools/toolkit/sourcemap/source-map.js");
 
 ### SourceMapConsumer
 
-A `SourceMapConsumer` instance represents a parsed source map which we can query
+A SourceMapConsumer instance represents a parsed source map which we can query
 for information about the original file positions by giving it a file position
 in the generated source.
 
-#### SourceMapConsumer.initialize(options)
-
-When using `SourceMapConsumer` outside of node.js, for example on the Web, it
-needs to know from what URL to load `lib/mappings.wasm`. You must inform it by
-calling `initialize` before constructing any `SourceMapConsumer`s.
-
-The options object has the following properties:
-
-* `"lib/mappings.wasm"`: A `String` containing the URL of the
-  `lib/mappings.wasm` file, or an `ArrayBuffer` with the contents of `lib/mappings.wasm`.
-
-```js
-sourceMap.SourceMapConsumer.initialize({
-  "lib/mappings.wasm": "https://example.com/source-map/lib/mappings.wasm"
-});
-```
-
 #### new SourceMapConsumer(rawSourceMap)
 
 The only parameter is the raw source map (either as a string which can be
@@ -237,62 +207,10 @@ following attributes:
 
 * `file`: Optional. The generated filename this source map is associated with.
 
-The promise of the constructed souce map consumer is returned.
-
-When the `SourceMapConsumer` will no longer be used anymore, you must call its
-`destroy` method.
-
-```js
-const consumer = await new sourceMap.SourceMapConsumer(rawSourceMapJsonData);
-doStuffWith(consumer);
-consumer.destroy();
-```
-
-Alternatively, you can use `SourceMapConsumer.with` to avoid needing to remember
-to call `destroy`.
-
-#### SourceMapConsumer.with
-
-Construct a new `SourceMapConsumer` from `rawSourceMap` and `sourceMapUrl`
-(see the `SourceMapConsumer` constructor for details. Then, invoke the `async
-function f(SourceMapConsumer) -> T` with the newly constructed consumer, wait
-for `f` to complete, call `destroy` on the consumer, and return `f`'s return
-value.
-
-You must not use the consumer after `f` completes!
-
-By using `with`, you do not have to remember to manually call `destroy` on
-the consumer, since it will be called automatically once `f` completes.
-
 ```js
-const xSquared = await SourceMapConsumer.with(
-  myRawSourceMap,
-  null,
-  async function (consumer) {
-    // Use `consumer` inside here and don't worry about remembering
-    // to call `destroy`.
-
-    const x = await whatever(consumer);
-    return x * x;
-  }
-);
-
-// You may not use that `consumer` anymore out here; it has
-// been destroyed. But you can use `xSquared`.
-console.log(xSquared);
+var consumer = new sourceMap.SourceMapConsumer(rawSourceMapJsonData);
 ```
 
-#### SourceMapConsumer.prototype.destroy()
-
-Free this source map consumer's associated wasm data that is manually-managed.
-
-```js
-consumer.destroy();
-```
-
-Alternatively, you can use `SourceMapConsumer.with` to avoid needing to remember
-to call `destroy`.
-
 #### SourceMapConsumer.prototype.computeColumnSpans()
 
 Compute the last column for each generated mapping. The last column is
@@ -321,6 +239,7 @@ consumer.allGeneratedPositionsFor({ line: 2, source: "foo.coffee" })
 //   { line: 2,
 //     column: 20,
 //     lastColumn: Infinity } ]
+
 ```
 
 #### SourceMapConsumer.prototype.originalPositionFor(generatedPosition)
@@ -660,8 +579,9 @@ Creates a SourceNode from generated code and a SourceMapConsumer.
   should be relative to.
 
 ```js
-const consumer = await new SourceMapConsumer(fs.readFileSync("path/to/my-file.js.map", "utf8"));
-const node = SourceNode.fromStringWithSourceMap(fs.readFileSync("path/to/my-file.js"), consumer);
+var consumer = new SourceMapConsumer(fs.readFileSync("path/to/my-file.js.map", "utf8"));
+var node = SourceNode.fromStringWithSourceMap(fs.readFileSync("path/to/my-file.js"),
+                                              consumer);
 ```
 
 #### SourceNode.prototype.add(chunk)