Use source-map-support for stack trace formatting

CHANGELOG.md

@@ -1,3 +1,18 @@
+## v108.0.15 (2019-12-20)
+
+- Use `source-map-support` package for mapping stack trace line numbers to
+  original iced/coffee file line numbers.
+
+  This is potentially a breaking change, depending how you use or integrate
+  with IcedCoffeeScript. The old behavior can be restored by calling the
+  following new IcedCoffeeScript API:
+
+  ```
+  require('iced-coffee-script').installPrepareStackTrace()
+  ```
+
+  See the README file for more information.
+
 ## v108.0.13 (2019-04-30)
 - Fix error on repl exit
 

Cakefile

@@ -317,4 +317,11 @@ task 'test:browser', 'run the test suite against the merged browser script', ->
   result = {}
   global.testingBrowser = yes
   (-> eval source).call result
+  # When testing browser build, install custom prepareStackTrace handler instead
+  # of source-map-support. `CoffeeScript.run` is pulled from `browser.coffee` in
+  # browser build, and it's incompatible with our source-map-support hooks.
+  result.CoffeeScript.installPrepareStackTrace()
+  # WARNING: This task does not work properly right now for some reason. Somehow
+  # functions like `run` still come from `coffee-script.coffee` instead
+  # of `browser.coffee` in `result.CoffeeScript`.
   runTests result.CoffeeScript

README

@@ -54,3 +54,29 @@
 
   Top 100 contributors are listed here:
   http://github.com/maxtaco/coffee-script/contributors
+
+
+  Note about handling errors with `source-map-support`:
+
+  Since v108.0.15 (2019-12-20), IcedCoffeeScript uses `source-map-support`
+  package to handle location mapping for stack traces for errors coming from
+  IcedCoffeeScript code. It's enabled by default when using `iced` to run
+  scripts or when using `register` to enable IcedCoffeeScript in Node's module
+  system.
+
+  To enable it manually (e.g. in environments other than Node.js or when not
+  using `register`), use the following API:
+
+  ```
+  require('iced-coffee-script').installSourceMapSupport({})
+  ```
+
+  This function can also be called with options for `source-map-support`
+  instead of an empty object. Available options are described in
+  `source-map-support` README file.
+
+  To use the old error handler, use the following API instead:
+
+  ```
+  require('iced-coffee-script').installPrepareStackTrace()
+  ```