source-map-explorer 2.3.0 → 2.4.2

package/README.md

@@ -126,11 +126,15 @@ source-map-explorer foo.min.js --tsv result.tsv
 
     These are regular expressions.
 
-* `--no-root`: By default, source-map-explorer finds common prefixes between all source files and eliminates them, since they add complexity to the visualization with no real benefit. But if you want to disable this behavior, set the `--no-root` flag.
+* `--no-root`: By default, `source-map-explorer` finds common prefixes between all source files and eliminates them, since they add complexity to the visualization with no real benefit. But if you want to disable this behavior, set the `--no-root` flag.
+
+* `--no-border-checks`: Disable invalid mapping column/line checks. By default, when a source map references column/line with bigger index than available in the source `source-map-explorers` throws an error indicating that specified source map might be wrong for the source.
 
 * `--coverage`: If the path to a valid a chrome code coverage JSON export is supplied, the tree map will be colorized according to which percentage of the modules code was executed
 
-* `--gzip`: calculate gzip size. It also sets `onlyMapped` flag
+* `--gzip`: Calculate gzip size. It also sets `onlyMapped` flag
+
+* `--sort`: Sort filenames
 
 <details>
 <summary>Examples</summary>
@@ -143,7 +147,7 @@ source-map-explorer -h
 ```
 Analyze and debug space usage through source maps.
 Usage:
-source-map-explorer script.js [script.js.map] [--json [result.json] | --html [result.html] | --tsv [result.csv]] [-m | --only-mapped] [--exclude-source-map] [--gzip] [--replace=BEFORE_1 BEFORE_2 --with=AFTER_1 AFTER_2] [--no-root] [--coverage coverage.json] [--version] [--help | -h]
+source-map-explorer script.js [script.js.map] [--json [result.json] | --html [result.html] | --tsv [result.csv]] [-m | --only-mapped] [--exclude-source-map] [--no-border-checks] [--gzip] [--sort] [--replace=BEFORE_1 BEFORE_2 --with=AFTER_1 AFTER_2] [--no-root] [--coverage coverage.json] [--version] [--help | -h]
 
 Output:
   --json  If filename specified save output as JSON to specified file otherwise output to stdout.  [string]
@@ -160,9 +164,11 @@ Options:
   --only-mapped, -m     Exclude "unmapped" bytes from the output. This will result in total counts less than the file size  [boolean]
   --exclude-source-map  Exclude source map comment size from output  [boolean]
   --no-root             To simplify the visualization, source-map-explorer will remove any prefix shared by all sources. If you wish to disable this behavior, set --no-root.  [boolean]
+  --no-border-checks    Disable invalid mapping column/line checks.  [boolean]
   --coverage            If the path to a valid a chrome code coverage JSON export is supplied, the tree map will be colorized according to which percentage of the modules code was executed
 [string]
   --gzip                Calculate gzip size. It also sets onlyMapped flag  [boolean]
+  --sort                Sort filenames  [boolean]
   -h, --help            Show help  [boolean]
 
 Examples:
@@ -294,10 +300,10 @@ source-map-explorer script.js --tsv --no-root
 ### On error
 Errors will be displayed only if no output flags specified
 ```
-source-map-explore with-unmapped.js no-map.js
+source-map-explore with-unmapped.js no-map-comment.js
 ```
 ```
-no-map.js
+no-map-comment.js
   Unable to find a source map.
   See https://github.com/danvk/source-map-explorer/blob/master/README.md#generating-source-maps
 with-unmapped.js
@@ -326,6 +332,7 @@ with-unmapped.js
     * `format`: [string] - `'json'`, `'tsv'` or `'html'`
     * `filename`: [string] - Filename to save output to
 * `noRoot`: [boolean] (default `false`) - See `--no-root` option above for details
+* `noBorderChecks`: [boolean] - Disable invalid mapping column/line checks. See `--no-border-checks` above.
 * `replaceMap`: <[Object]<{ [from: [string]]: [string] }>> - Mapping for replacement, see `--replace`, `--with` options above for details.
 * `coverage`: [string] - If the path to a valid a chrome code coverage JSON export is supplied, the tree map will be colorized according to which percentage of the modules code was executed
 * `gzip`: [boolean] - Calculate gzip size. It also sets `onlyMapped` flag
@@ -555,9 +562,14 @@ source-map-explorer path/to/foo.min.js{,.map}
 
 ### Other source map tools
 
-[source-map-visualization](https://sokra.github.io/source-map-visualization)
+- [source-map-visualization](https://sokra.github.io/source-map-visualization)
+
+- [bundle-wizard](https://github.com/aholachek/bundle-wizard) - Easier analysis of webapp entry points (uses source-map-explorer under the hood)
+
+### Learn about source maps
 
-[bundle-wizard](https://github.com/aholachek/bundle-wizard): Easier analysis of webapp entry points (uses source-map-explorer under the hood)
+- [Standard](https://docs.google.com/document/d/1U1RGAehQwRypUTovF1KRlpiOFze0b-_2gc6fAH0KY0k/edit)
+- [Anatomy of source maps](https://www.bugsnag.com/blog/source-maps)
 
 [demo]: https://cdn.rawgit.com/danvk/source-map-explorer/08b0e130cb9345f9061760bf8a8d9136ea60b457/demo.html
 [another demo]: https://cdn.rawgit.com/danvk/source-map-explorer/08b0e130cb9345f9061760bf8a8d9136ea60b457/demo-bug.html

package/dist/api.d.ts

@@ -1,10 +1,4 @@
-import { BundlesAndFileTokens, ExploreOptions, ExploreResult, Bundle } from './index';
-/**
- * Analyze bundle(s)
- */
+import type { Bundle, BundlesAndFileTokens, ExploreOptions, ExploreResult } from './types';
 export declare function explore(bundlesAndFileTokens: BundlesAndFileTokens, options?: ExploreOptions): Promise<ExploreResult>;
-/**
- * Expand list of file tokens into a list of bundles
- */
 export declare function getBundles(fileTokens: string[]): Bundle[];
 export declare function getBundleName(bundle: Bundle): string;

package/dist/api.js

@@ -1,105 +1,69 @@
 'use strict';
-
-Object.defineProperty(exports, '__esModule', {
-  value: true,
-});
-exports.explore = explore;
-exports.getBundles = getBundles;
-exports.getBundleName = getBundleName;
-
-var _glob = _interopRequireDefault(require('glob'));
-
-var _lodash = require('lodash');
-
-var _explore = require('./explore');
-
-var _appError = require('./app-error');
-
-var _output = require('./output');
-
-var _coverage = require('./coverage');
-
-function _interopRequireDefault(obj) {
-  return obj && obj.__esModule ? obj : { default: obj };
-}
-
+var __importDefault =
+  (this && this.__importDefault) ||
+  function (mod) {
+    return mod && mod.__esModule ? mod : { default: mod };
+  };
+Object.defineProperty(exports, '__esModule', { value: true });
+const glob_1 = __importDefault(require('glob'));
+const lodash_1 = require('lodash');
+const explore_1 = require('./explore');
+const app_error_1 = require('./app-error');
+const output_1 = require('./output');
+const coverage_1 = require('./coverage');
 function adjustOptions(options) {
-  /* Unmapped bytes cannot be calculate because it's impossible to get total size by summing files'
-     sizes when calculating gzip size for a file. */
   if (options.gzip) {
     options.onlyMapped = true;
   }
-
   return options;
 }
-/**
- * Analyze bundle(s)
- */
-
 async function explore(bundlesAndFileTokens, options = {}) {
   bundlesAndFileTokens = Array.isArray(bundlesAndFileTokens)
     ? bundlesAndFileTokens
     : [bundlesAndFileTokens];
-
   if (bundlesAndFileTokens.length === 0) {
-    throw new _appError.AppError({
-      code: 'NoBundles',
-    });
+    throw new app_error_1.AppError({ code: 'NoBundles' });
   }
-
-  adjustOptions(options); // Separate bundles from file tokens
-
-  const [fileTokens, bundles] = (0, _lodash.partition)(bundlesAndFileTokens, _lodash.isString); // Get bundles from file tokens
-
+  adjustOptions(options);
+  const [fileTokens, bundles] = lodash_1.partition(bundlesAndFileTokens, lodash_1.isString);
   bundles.push(...getBundles(fileTokens));
-  (0, _coverage.addCoverageRanges)(bundles, options.coverage);
+  coverage_1.addCoverageRanges(bundles, options.coverage);
   const results = await Promise.all(
-    bundles.map(bundle =>
-      (0, _explore.exploreBundle)(bundle, options).catch(error => onExploreError(bundle, error))
+    bundles.map((bundle) =>
+      explore_1.exploreBundle(bundle, options).catch((error) => onExploreError(bundle, error))
     )
   );
-  const exploreResult = getExploreResult(results, options); // Reject if none of results is successful
-
+  const exploreResult = getExploreResult(results, options);
   if (exploreResult.bundles.length === 0) {
     return Promise.reject(exploreResult);
   }
-
-  (0, _output.saveOutputToFile)(exploreResult, options);
+  output_1.saveOutputToFile(exploreResult, options);
   return exploreResult;
 }
-/**
- * Expand list of file tokens into a list of bundles
- */
-
+exports.explore = explore;
 function getBundles(fileTokens) {
-  const filenames = (0, _lodash.flatMap)(fileTokens, filePath =>
-    _glob.default.hasMagic(filePath) ? expandGlob(filePath) : filePath
+  const filenames = lodash_1.flatMap(fileTokens, (filePath) =>
+    glob_1.default.hasMagic(filePath) ? expandGlob(filePath) : filePath
   );
-  const [mapFilenames, codeFilenames] = (0, _lodash.partition)(filenames, filename =>
+  const [mapFilenames, codeFilenames] = lodash_1.partition(filenames, (filename) =>
     filename.endsWith('.map')
   );
-  return codeFilenames.map(code => ({
+  return codeFilenames.map((code) => ({
     code,
-    map: mapFilenames.find(filename => filename === `${code}.map`),
+    map: mapFilenames.find((filename) => filename === `${code}.map`),
   }));
 }
-
+exports.getBundles = getBundles;
 function expandGlob(pattern) {
-  // Make sure pattern match `.map` files as well
   if (pattern.endsWith('.js')) {
     pattern = `${pattern}?(.map)`;
   }
-
-  return _glob.default.sync(pattern);
+  return glob_1.default.sync(pattern);
 }
-
 function getBundleName(bundle) {
   return Buffer.isBuffer(bundle.code) ? 'Buffer' : bundle.code;
 }
-/**
- * Handle error during bundle processing
- */
-
+exports.getBundleName = getBundleName;
 function onExploreError(bundle, error) {
   return {
     bundleName: getBundleName(bundle),
@@ -108,53 +72,54 @@ function onExploreError(bundle, error) {
     error,
   };
 }
-
+function sortFilenames(bundles) {
+  return bundles.map((bundle) => ({
+    ...bundle,
+    files: lodash_1.fromPairs(lodash_1.sortBy(lodash_1.toPairs(bundle.files), 0)),
+  }));
+}
 function getExploreResult(results, options) {
-  const [bundles, errors] = (0, _lodash.partition)(results, result => 'files' in result);
+  const [bundles, errors] = lodash_1.partition(results, (result) => 'files' in result);
+  let sortedBundles = lodash_1.sortBy(bundles, (bundle) => bundle.bundleName);
+  if (options.sort) {
+    sortedBundles = sortFilenames(sortedBundles);
+  }
   errors.push(...getPostExploreErrors(bundles));
   return {
-    bundles,
+    bundles: sortedBundles,
     errors,
-    ...(bundles.length > 0 && {
-      output: (0, _output.formatOutput)(bundles, options),
-    }),
+    ...(bundles.length > 0 && { output: output_1.formatOutput(sortedBundles, options) }),
   };
 }
-
 function getPostExploreErrors(exploreBundleResults) {
   const errors = [];
   const isSingleBundle = exploreBundleResults.length === 1;
-
   for (const result of exploreBundleResults) {
-    const { bundleName, files, totalBytes } = result; // Check if source map contains only one file - this make result useless when exploring single bundle
-
+    const { bundleName, files, totalBytes } = result;
     if (isSingleBundle) {
       const filenames = Object.keys(files).filter(
-        filename => !_explore.SPECIAL_FILENAMES.includes(filename)
+        (filename) => !explore_1.SPECIAL_FILENAMES.includes(filename)
       );
-
       if (filenames.length === 1) {
         errors.push({
           bundleName,
           isWarning: true,
           code: 'OneSourceSourceMap',
-          message: (0, _appError.getErrorMessage)({
+          message: app_error_1.getErrorMessage({
             code: 'OneSourceSourceMap',
             filename: filenames[0],
           }),
         });
       }
     }
-
-    if (files[_explore.UNMAPPED_KEY] !== undefined) {
-      const { size: unmappedBytes } = files[_explore.UNMAPPED_KEY];
-
+    if (files[explore_1.UNMAPPED_KEY] !== undefined) {
+      const { size: unmappedBytes } = files[explore_1.UNMAPPED_KEY];
       if (unmappedBytes) {
         errors.push({
           bundleName,
           isWarning: true,
           code: 'UnmappedBytes',
-          message: (0, _appError.getErrorMessage)({
+          message: app_error_1.getErrorMessage({
             code: 'UnmappedBytes',
             unmappedBytes,
             totalBytes,
@@ -163,6 +128,6 @@ function getPostExploreErrors(exploreBundleResults) {
       }
     }
   }
-
   return errors;
 }
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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","sourcesContent":["import glob from 'glob';\nimport { partition, flatMap, isString, toPairs, fromPairs, sortBy } from 'lodash';\n\nimport { exploreBundle, UNMAPPED_KEY, SPECIAL_FILENAMES } from './explore';\nimport { AppError, getErrorMessage } from './app-error';\nimport { formatOutput, saveOutputToFile } from './output';\nimport { addCoverageRanges } from './coverage';\n\nimport type {\n  Bundle,\n  BundlesAndFileTokens,\n  ExploreBundleResult,\n  ExploreErrorResult,\n  ExploreOptions,\n  ExploreResult,\n} from './types';\n\nfunction adjustOptions(options: ExploreOptions): ExploreOptions {\n  /* Unmapped bytes cannot be calculate because it's impossible to get total size by summing files'\n     sizes when calculating gzip size for a file. */\n  if (options.gzip) {\n    options.onlyMapped = true;\n  }\n\n  return options;\n}\n\n/**\n * Analyze bundle(s)\n */\nexport async function explore(\n  bundlesAndFileTokens: BundlesAndFileTokens,\n  options: ExploreOptions = {}\n): Promise<ExploreResult> {\n  bundlesAndFileTokens = Array.isArray(bundlesAndFileTokens)\n    ? bundlesAndFileTokens\n    : [bundlesAndFileTokens];\n\n  if (bundlesAndFileTokens.length === 0) {\n    throw new AppError({ code: 'NoBundles' });\n  }\n\n  adjustOptions(options);\n\n  // Separate bundles from file tokens\n  const [fileTokens, bundles] = partition(bundlesAndFileTokens, isString);\n\n  // Get bundles from file tokens\n  bundles.push(...getBundles(fileTokens));\n\n  addCoverageRanges(bundles, options.coverage);\n\n  const results = await Promise.all(\n    bundles.map((bundle) =>\n      exploreBundle(bundle, options).catch<ExploreErrorResult>((error) =>\n        onExploreError(bundle, error)\n      )\n    )\n  );\n\n  const exploreResult = getExploreResult(results, options);\n\n  // Reject if none of results is successful\n  if (exploreResult.bundles.length === 0) {\n    return Promise.reject(exploreResult);\n  }\n\n  saveOutputToFile(exploreResult, options);\n\n  return exploreResult;\n}\n\n/**\n * Expand list of file tokens into a list of bundles\n */\nexport function getBundles(fileTokens: string[]): Bundle[] {\n  const filenames = flatMap(fileTokens, (filePath) =>\n    glob.hasMagic(filePath) ? expandGlob(filePath) : filePath\n  );\n\n  const [mapFilenames, codeFilenames] = partition(filenames, (filename) =>\n    filename.endsWith('.map')\n  );\n\n  return codeFilenames.map<Bundle>((code) => ({\n    code,\n    map: mapFilenames.find((filename) => filename === `${code}.map`),\n  }));\n}\n\nfunction expandGlob(pattern: string): string[] {\n  // Make sure pattern match `.map` files as well\n  if (pattern.endsWith('.js')) {\n    pattern = `${pattern}?(.map)`;\n  }\n\n  return glob.sync(pattern);\n}\n\nexport function getBundleName(bundle: Bundle): string {\n  return Buffer.isBuffer(bundle.code) ? 'Buffer' : bundle.code;\n}\n\n/**\n * Handle error during bundle processing\n */\nfunction onExploreError(bundle: Bundle, error: NodeJS.ErrnoException): ExploreErrorResult {\n  return {\n    bundleName: getBundleName(bundle),\n    code: error.code || 'Unknown',\n    message: error.message,\n    error,\n  };\n}\n\nfunction sortFilenames(bundles: ExploreBundleResult[]): ExploreBundleResult[] {\n  return bundles.map((bundle) => ({\n    ...bundle,\n    files: fromPairs(sortBy(toPairs(bundle.files), 0)),\n  }));\n}\n\nfunction getExploreResult(\n  results: (ExploreBundleResult | ExploreErrorResult)[],\n  options: ExploreOptions\n): ExploreResult {\n  const [bundles, errors] = partition(\n    results,\n    (result): result is ExploreBundleResult => 'files' in result\n  );\n\n  let sortedBundles = sortBy(bundles, (bundle) => bundle.bundleName);\n\n  if (options.sort) {\n    sortedBundles = sortFilenames(sortedBundles);\n  }\n\n  errors.push(...getPostExploreErrors(bundles));\n\n  return {\n    bundles: sortedBundles,\n    errors,\n    ...(bundles.length > 0 && { output: formatOutput(sortedBundles, options) }),\n  };\n}\n\nfunction getPostExploreErrors(exploreBundleResults: ExploreBundleResult[]): ExploreErrorResult[] {\n  const errors: ExploreErrorResult[] = [];\n\n  const isSingleBundle = exploreBundleResults.length === 1;\n\n  for (const result of exploreBundleResults) {\n    const { bundleName, files, totalBytes } = result;\n\n    // Check if source map contains only one file - this make result useless when exploring single bundle\n    if (isSingleBundle) {\n      const filenames = Object.keys(files).filter(\n        (filename) => !SPECIAL_FILENAMES.includes(filename)\n      );\n\n      if (filenames.length === 1) {\n        errors.push({\n          bundleName,\n          isWarning: true,\n          code: 'OneSourceSourceMap',\n          message: getErrorMessage({ code: 'OneSourceSourceMap', filename: filenames[0] }),\n        });\n      }\n    }\n\n    if (files[UNMAPPED_KEY] !== undefined) {\n      const { size: unmappedBytes } = files[UNMAPPED_KEY];\n\n      if (unmappedBytes) {\n        errors.push({\n          bundleName,\n          isWarning: true,\n          code: 'UnmappedBytes',\n          message: getErrorMessage({ code: 'UnmappedBytes', unmappedBytes, totalBytes }),\n        });\n      }\n    }\n  }\n\n  return errors;\n}\n"]}

package/dist/app-error.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="node" />
-import { ErrorCode } from './index';
+import type { ErrorCode } from './types';
 export declare class AppError extends Error {
     code?: ErrorCode;
     cause?: Error;

package/dist/app-error.js

@@ -1,18 +1,9 @@
 'use strict';
-
-Object.defineProperty(exports, '__esModule', {
-  value: true,
-});
-exports.getErrorMessage = getErrorMessage;
-exports.SOURCE_MAP_INFO_URL = exports.AppError = void 0;
-
-var _helpers = require('./helpers');
-
-// If we need advanced error consider using https://github.com/joyent/node-verror
+Object.defineProperty(exports, '__esModule', { value: true });
+const helpers_1 = require('./helpers');
 class AppError extends Error {
   constructor(errorContext, error) {
-    super(); // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work
-
+    super();
     Object.setPrototypeOf(this, AppError.prototype);
     const message = getErrorMessage(errorContext);
     this.message = error ? `${message}: ${error.message}` : message;
@@ -20,69 +11,57 @@ class AppError extends Error {
     Error.captureStackTrace(this, AppError);
   }
 }
-
 exports.AppError = AppError;
-const SOURCE_MAP_INFO_URL =
+exports.SOURCE_MAP_INFO_URL =
   'https://github.com/danvk/source-map-explorer/blob/master/README.md#generating-source-maps';
-exports.SOURCE_MAP_INFO_URL = SOURCE_MAP_INFO_URL;
-
 function getErrorMessage(context) {
   switch (context.code) {
     case 'NoBundles':
       return 'No file(s) provided';
-
     case 'NoSourceMap':
       return `Unable to find a source map.
-See ${SOURCE_MAP_INFO_URL}`;
-
+See ${exports.SOURCE_MAP_INFO_URL}`;
     case 'OneSourceSourceMap': {
       return `Your source map only contains one source (${context.filename}).
 This can happen if you use browserify+uglifyjs, for example, and don't set the --in-source-map flag to uglify.
-See ${SOURCE_MAP_INFO_URL}`;
+See ${exports.SOURCE_MAP_INFO_URL}`;
     }
-
     case 'UnmappedBytes': {
       const { unmappedBytes, totalBytes } = context;
-      const bytesString = (0, _helpers.formatPercent)(unmappedBytes, totalBytes, 2);
+      const bytesString = helpers_1.formatPercent(unmappedBytes, totalBytes, 2);
       return `Unable to map ${unmappedBytes}/${totalBytes} bytes (${bytesString}%)`;
     }
-
     case 'InvalidMappingLine': {
       const { generatedLine, maxLine } = context;
       return `Your source map refers to generated line ${generatedLine}, but the source only contains ${maxLine} line(s).
 Check that you are using the correct source map.`;
     }
-
     case 'InvalidMappingColumn': {
-      const { generatedLine, generatedColumn, maxColumn } = context; // Add 1 since generatedColumn is 0-based
-
-      return `Your source map refers to generated column ${generatedColumn +
-        1} on line ${generatedLine}, but the source only contains ${maxColumn} column(s) on that line.
+      const { generatedLine, generatedColumn, maxColumn } = context;
+      return `Your source map refers to generated column ${
+        generatedColumn + 1
+      } on line ${generatedLine}, but the source only contains ${maxColumn} column(s) on that line.
 Check that you are using the correct source map.`;
     }
-
     case 'CannotSaveFile':
       return 'Unable to save HTML to file';
-
     case 'CannotCreateTempFile':
       return 'Unable to create a temporary HTML file';
-
     case 'CannotOpenTempFile': {
       const { error, tempFile } = context;
       return `Unable to open web browser. ${error.toString().trim()}
 Either run with --html, --json, --tsv, --file, or view HTML for the visualization at:
 ${tempFile}`;
     }
-
     case 'CannotOpenCoverageFile': {
       return 'Unable to open/parse coverage file';
     }
-
     case 'NoCoverageMatches': {
       return 'No matched bundles found for coverages';
     }
-
     default:
       return 'Unknown error';
   }
 }
+exports.getErrorMessage = getErrorMessage;
+//# sourceMappingURL=app-error.js.map

package/dist/app-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-error.js","sourceRoot":"","sources":["../src/app-error.ts"],"names":[],"mappings":";;AAAA,uCAA0C;AAK1C,MAAa,QAAS,SAAQ,KAAK;IAIjC,YAAY,YAA0B,EAAE,KAA6B;QACnE,KAAK,EAAE,CAAC;QAER,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAEhD,MAAM,OAAO,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;QAE9C,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAChE,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC;QAE9B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;CACF;AAhBD,4BAgBC;AAEY,QAAA,mBAAmB,GAC9B,2FAA2F,CAAC;AAmD9F,SAAgB,eAAe,CAAC,OAAqB;IACnD,QAAQ,OAAO,CAAC,IAAI,EAAE;QACpB,KAAK,WAAW;YACd,OAAO,qBAAqB,CAAC;QAE/B,KAAK,aAAa;YAChB,OAAO;MACP,2BAAmB,EAAE,CAAC;QAExB,KAAK,oBAAoB,CAAC,CAAC;YACzB,OAAO,6CAA6C,OAAO,CAAC,QAAQ;;MAEpE,2BAAmB,EAAE,CAAC;SACvB;QAED,KAAK,eAAe,CAAC,CAAC;YACpB,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;YAE9C,MAAM,WAAW,GAAG,uBAAa,CAAC,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;YAEhE,OAAO,iBAAiB,aAAa,IAAI,UAAU,WAAW,WAAW,IAAI,CAAC;SAC/E;QAED,KAAK,oBAAoB,CAAC,CAAC;YACzB,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;YAE3C,OAAO,4CAA4C,aAAa,kCAAkC,OAAO;iDAC9D,CAAC;SAC7C;QAED,KAAK,sBAAsB,CAAC,CAAC;YAC3B,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC;YAG9D,OAAO,8CACL,eAAe,GAAG,CACpB,YAAY,aAAa,kCAAkC,SAAS;iDACzB,CAAC;SAC7C;QAED,KAAK,gBAAgB;YACnB,OAAO,6BAA6B,CAAC;QAEvC,KAAK,sBAAsB;YACzB,OAAO,wCAAwC,CAAC;QAElD,KAAK,oBAAoB,CAAC,CAAC;YACzB,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;YAEpC,OAAO,+BAA+B,KAAK,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;;EAEjE,QAAQ,EAAE,CAAC;SACR;QAED,KAAK,wBAAwB,CAAC,CAAC;YAC7B,OAAO,oCAAoC,CAAC;SAC7C;QAED,KAAK,mBAAmB,CAAC,CAAC;YACxB,OAAO,wCAAwC,CAAC;SACjD;QAED;YACE,OAAO,eAAe,CAAC;KAC1B;AACH,CAAC;AAjED,0CAiEC","sourcesContent":["import { formatPercent } from './helpers';\n\nimport type { ErrorCode } from './types';\n\n// If we need advanced error consider using https://github.com/joyent/node-verror\nexport class AppError extends Error {\n  code?: ErrorCode;\n  cause?: Error;\n\n  constructor(errorContext: ErrorContext, error?: NodeJS.ErrnoException) {\n    super();\n    // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work\n    Object.setPrototypeOf(this, AppError.prototype);\n\n    const message = getErrorMessage(errorContext);\n\n    this.message = error ? `${message}: ${error.message}` : message;\n    this.code = errorContext.code;\n\n    Error.captureStackTrace(this, AppError);\n  }\n}\n\nexport const SOURCE_MAP_INFO_URL =\n  'https://github.com/danvk/source-map-explorer/blob/master/README.md#generating-source-maps';\n\ninterface CommonErrorContext {\n  code:\n    | 'NoBundles'\n    | 'NoSourceMap'\n    | 'CannotSaveFile'\n    | 'CannotCreateTempFile'\n    | 'CannotOpenCoverageFile'\n    | 'NoCoverageMatches'\n    | 'Unknown';\n}\n\ninterface OneSourceSourceMapErrorContext {\n  code: 'OneSourceSourceMap';\n  filename: string;\n}\n\ninterface UnmappedBytesErrorContext {\n  code: 'UnmappedBytes';\n  totalBytes: number;\n  unmappedBytes: number;\n}\n\ninterface InvalidMappingLineErrorContext {\n  code: 'InvalidMappingLine';\n  generatedLine: number;\n  maxLine: number;\n}\n\ninterface InvalidMappingColumnErrorContext {\n  code: 'InvalidMappingColumn';\n  generatedLine: number;\n  generatedColumn: number;\n  maxColumn: number;\n}\n\ninterface CannotOpenTempFileErrorContext {\n  code: 'CannotOpenTempFile';\n  error: Buffer;\n  tempFile: string;\n}\n\nexport type ErrorContext =\n  | CommonErrorContext\n  | OneSourceSourceMapErrorContext\n  | UnmappedBytesErrorContext\n  | InvalidMappingLineErrorContext\n  | InvalidMappingColumnErrorContext\n  | CannotOpenTempFileErrorContext;\n\nexport function getErrorMessage(context: ErrorContext): string {\n  switch (context.code) {\n    case 'NoBundles':\n      return 'No file(s) provided';\n\n    case 'NoSourceMap':\n      return `Unable to find a source map.\nSee ${SOURCE_MAP_INFO_URL}`;\n\n    case 'OneSourceSourceMap': {\n      return `Your source map only contains one source (${context.filename}).\nThis can happen if you use browserify+uglifyjs, for example, and don't set the --in-source-map flag to uglify.\nSee ${SOURCE_MAP_INFO_URL}`;\n    }\n\n    case 'UnmappedBytes': {\n      const { unmappedBytes, totalBytes } = context;\n\n      const bytesString = formatPercent(unmappedBytes, totalBytes, 2);\n\n      return `Unable to map ${unmappedBytes}/${totalBytes} bytes (${bytesString}%)`;\n    }\n\n    case 'InvalidMappingLine': {\n      const { generatedLine, maxLine } = context;\n\n      return `Your source map refers to generated line ${generatedLine}, but the source only contains ${maxLine} line(s).\nCheck that you are using the correct source map.`;\n    }\n\n    case 'InvalidMappingColumn': {\n      const { generatedLine, generatedColumn, maxColumn } = context;\n\n      // Add 1 since generatedColumn is 0-based\n      return `Your source map refers to generated column ${\n        generatedColumn + 1\n      } on line ${generatedLine}, but the source only contains ${maxColumn} column(s) on that line.\nCheck that you are using the correct source map.`;\n    }\n\n    case 'CannotSaveFile':\n      return 'Unable to save HTML to file';\n\n    case 'CannotCreateTempFile':\n      return 'Unable to create a temporary HTML file';\n\n    case 'CannotOpenTempFile': {\n      const { error, tempFile } = context;\n\n      return `Unable to open web browser. ${error.toString().trim()}\nEither run with --html, --json, --tsv, --file, or view HTML for the visualization at:\n${tempFile}`;\n    }\n\n    case 'CannotOpenCoverageFile': {\n      return 'Unable to open/parse coverage file';\n    }\n\n    case 'NoCoverageMatches': {\n      return 'No matched bundles found for coverages';\n    }\n\n    default:\n      return 'Unknown error';\n  }\n}\n"]}

package/dist/cli.d.ts

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { ErrorContext } from './app-error';
+import type { ErrorContext } from './app-error';
 export declare function logError(message: string | ErrorContext, error?: Error): void;
 export declare function logWarn(message: string): void;
 export declare function logInfo(message: string): void;