opal 1.3.0.alpha1 → 1.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cf895e8ef63c69f90e6e099aa2f4c671649411893b980bdb03b55268da2e0a34
-  data.tar.gz: 5fc847637cea4a857bcc78ad1a491d5c898fdc051d779644f39e282e6c2aba66
+  metadata.gz: 2b87866d518e2345b4aa120b4f8d457dad6f86ed9f365974161efad2e2f0dde9
+  data.tar.gz: a3dac2be866ce053470b56377131f7615f0ff6bc3dc7a1d567ce77a8efff5278
 SHA512:
-  metadata.gz: 0eb66e6cb09d52075f7afd1ab8d10b67fdab302a503269f95b152440991b8d1f9bc3fc759e0265503350e6c4cd3c1453afca9d7d971bbdae46a367f15f5f8230
-  data.tar.gz: e0ce987c98345a13101dc3d9311ce1bb41435777edf41ab14aac96cf5821c1e6076236de25216c443fa806567af6f1a32de2f8d7d9e1e67e4ba165547c938e95
+  metadata.gz: 161e91aa69fc166adf4719b56724251e97239de73dba172916a3de5c744e4d7166a33b0fdc97f9fb68079c0627815a5ae00aba0cbedb137b35a6fc34191979ac
+  data.tar.gz: ec37e385c55325552d2b7a82fc4c9ec4cd2a98aa3be966a6f9c193e483d0278f58ac8241eec65e12d9e965ea4eda17454430ae284352526ce408e7bc69729ad3

data/.github/workflows/build.yml

@@ -54,6 +54,7 @@ jobs:
             permissive: true
             fetchdepth: '0'
             command: bin/rake performance:compare
+            os: ryzen
 
           # Currently failing:
           # - ruby: truffleruby
@@ -66,7 +67,8 @@ jobs:
       - uses: actions/checkout@v2
         with:
           fetch-depth: ${{ fromJSON(matrix.combo.fetchdepth || '1') }}
-      - uses: ruby/setup-ruby@v1
+      - if: ${{ matrix.combo.os != 'ryzen' }}
+        uses: ruby/setup-ruby@v1
         with:
           ruby-version: ${{ matrix.combo.ruby }}
           # NOTE: Bundler 2.2.0 fails to install libv8

data/CHANGELOG.md

@@ -15,7 +15,145 @@ Changes are grouped as follows:
 
 
 
-## [1.2.0](https://github.com/opal/opal/compare/v1.1.1...1.2.0) - 2021-07-28
+## [1.3.2](https://github.com/opal/opal/compare/v1.3.1...v1.3.2) - 2021-11-10
+
+
+### Fixed
+
+- Update documentation ([#2350](https://github.com/opal/opal/pull/2350))
+- Fix `IO#gets` getting an extra char under some circumstances ([#2349](https://github.com/opal/opal/pull/2349))
+- Raise a `TypeError` instead of `UndefinedMethod` if not a string is passed to `__send__` ([#2346](https://github.com/opal/opal/pull/2346))
+- Do not modify `$~` when calling `String#scan` from internal methods ([#2353](https://github.com/opal/opal/pull/2353))
+- Stop interpreting falsey values as a missing constant in `Module#const_get` ([#2354](https://github.com/opal/opal/pull/2354))
+
+<!--
+### Changed
+### Deprecated
+### Removed
+### Internal
+-->
+
+
+
+
+## [1.3.1](https://github.com/opal/opal/compare/v1.3.0...v1.3.1) - 2021-11-03
+
+
+### Fixed
+
+- Fix REPL if bundler environment isn't set ([#2338](https://github.com/opal/opal/pull/2338))
+- Fix Chrome runner if bundler environment isn't set and make it work on other Unixes ([#2339](https://github.com/opal/opal/pull/2339))
+- `Proc#binding` to return a binding if `Binding` is defined (#2341, #2340)
+- `Array#zip` to correctly `yield` (#2342, #1611)
+- `String#scan` to correctly `yield` (#2342, #1660)
+
+
+
+
+## [1.3.0](https://github.com/opal/opal/compare/v1.2.0...v1.3.0) - 2021-10-27
+
+
+### Added
+
+- Add support for `retry` ([#2264](https://github.com/opal/opal/pull/2264))
+- Modernize Exceptions ([#2264](https://github.com/opal/opal/pull/2264))
+  - Add `#cause`, `#backtrace_locations`, `#full_message` to `Exception`
+  - Normalize backtraces across platforms
+  - Add `Thread::Backtrace::Location`
+  - Output Exception#full_message on uncaught exceptions ([#2269](https://github.com/opal/opal/pull/2269))
+- TracePoint `:class` support ([#2049](https://github.com/opal/opal/pull/2049))
+- Implement the Flip-Flop operators ([#2261](https://github.com/opal/opal/pull/2261))
+- Add `JS[]` to access properties on the global object ([#2259](https://github.com/opal/opal/pull/2259))
+- Add `ENV.fetch` to the Nodejs implementation of `ENV` ([#2259](https://github.com/opal/opal/pull/2259))
+- Opal::Cache, an optional compiler cache (enabled by default) (#2242, #2278, #2329)
+- Alias for gvars, alias on main ([#2270](https://github.com/opal/opal/pull/2270))
+- Support for GJS (GNOME's JavaScript runtime) runner ([#2280](https://github.com/opal/opal/pull/2280))
+- Scope variables support for `eval()` ([#2256](https://github.com/opal/opal/pull/2256))
+- Add support for `Kernel#binding` ([#2256](https://github.com/opal/opal/pull/2256))
+- A (mostly) correct support for refinements ([#2256](https://github.com/opal/opal/pull/2256))
+- Add support for ECMAScript modules with an `--esm` CLI option ([#2286](https://github.com/opal/opal/pull/2286))
+- Implement `Regexp#names` and add named captures support ([#2272](https://github.com/opal/opal/pull/2272))
+- REPL improvements: ([#2285](https://github.com/opal/opal/pull/2285))
+  - Colored output & history support
+  - `ls` to show available constants and variable
+- Add `Method#===` as an alias to `Method#call`, works the same as `Proc#===` ([#2305](https://github.com/opal/opal/pull/2305))
+- Add `IO#gets` and `IO#read_proc` along with other supporting methods ([#2309](https://github.com/opal/opal/pull/2309))
+  - Support `#gets` on most platforms, including browsers (via `prompt`)
+  - Move the REPL to a `--repl` CLI option of the main executable
+  - Completely refactor IO, now supporting methods like `#each_line` throughout the entire IO chain
+  - Add a runner for MiniRacer (as `miniracer`)
+  - Support Windows on the Chrome runner
+  - Support Windows on the REPL
+  - Platforms an IO implementations should either set `IO#read_proc` or overwrite `IO#sysread`
+- [experimental] Add support for JavaScript async/await ([#2221](https://github.com/opal/opal/pull/2221))
+  - Enable the feature by adding a magic comment: `# await: true`
+  - The magic comment can be also used to mark specific method patterns to be awaited
+    (e.g. `# await: *_await, sleep` will make any method ending in `_await` or named `sleep` to be awaited)
+  - Add `Kernel#__await__` as a bridge to the `await` keyword (inspired by CoffeeScript await support)
+  - Require `opal/await` to get additional support
+  - Read more on the newly added documentation page
+- Better interoperability between legacy Promise (v1) and native Promise (v2) ([#2221](https://github.com/opal/opal/pull/2221))
+  - Add `PromiseV1` as an alias to the original (legacy) Promise class
+  - Add `#to_v1` and `#to_v2` to both classes
+  - `Promise#to_n` will convert it to a native Promise (v2)
+- Add `Opal::Config.esm` to enable/disable ES modules ([#2316](https://github.com/opal/opal/pull/2316))
+  - If Config.esm is enabled, SimpleServer does type="module"
+  - Add new rack-esm example
+- Add a QuickJS (https://bellard.org/quickjs/) runner ([#2331](https://github.com/opal/opal/pull/2331))
+- Add `IO#fileno`, `Method#curry`, `Buffer#to_s`, `Pathname.pwd` ([#2332](https://github.com/opal/opal/pull/2332))
+- Add NodeJS support for `ARGF`, `ENV.{inspect,to_h,to_hash,merge}`, `File.{delete,unlink}`, `Kernel#system`, <code>Kernel#\`</code>, `Process::Status` ([#2332](https://github.com/opal/opal/pull/2332))
+- Introduce `__dir__` support ([#2323](https://github.com/opal/opal/pull/2323))
+- Full autoload support ([#2323](https://github.com/opal/opal/pull/2323))
+  - Now compatible with `opal-zeitwerk` and `isomorfeus`
+  - Allow toplevel autoloads
+  - Allow dynamic autoloads (e.g. can be hooked to fetch a URL upon autoload with a custom loader)
+  - Allow overwriting `require` (e.g. like rubygems does)
+  - Allow autoloading trees with `require_tree "./foo", autoload: true`
+  - Add Module#autoload?
+- Autoload parts of the corelib ([#2323](https://github.com/opal/opal/pull/2323))
+
+### Fixed
+
+- Fixed multiple line `Regexp` literal to not generate invalid syntax as JavaScript ([#1616](https://github.com/opal/opal/pull/1616))
+- Fix `Kernel#{throw,catch}` along with `UncaughtThrowError` ([#2264](https://github.com/opal/opal/pull/2264))
+- Update source-map-support to fix an off-by-one error ([#2264](https://github.com/opal/opal/pull/2264))
+- Source map: lines should start from 1, not 0 ([#2273](https://github.com/opal/opal/pull/2273))
+- Allow for multiple underscored args with the same name in strict mode ([#2292](https://github.com/opal/opal/pull/2292))
+- Show instance variables in `Kernel#inspect` ([#2285](https://github.com/opal/opal/pull/2285))
+- `0.digits` was returning an empty array in strict mode ([#2301](https://github.com/opal/opal/pull/2301))
+- Non Integer numbers were responding to `#digits` ([#2301](https://github.com/opal/opal/pull/2301))
+- Correctly delete hash members when dealing with boxed strings ([#2306](https://github.com/opal/opal/pull/2306))
+- Escape string components in interpolated strings (`dstrs`) correctly ([#2308](https://github.com/opal/opal/pull/2308))
+- Don't try to return the JS `debugger` statement, just return `nil` ([#2307](https://github.com/opal/opal/pull/2307))
+- Retain the `-` while stringifying `-0.0` ([#2304](https://github.com/opal/opal/pull/2304))
+- Fix super support for rest args and re-assignments with implicit arguments ([#2315](https://github.com/opal/opal/pull/2315))
+- Fix calling `Regexp#last_match` when `$~` is nil ([#2328](https://github.com/opal/opal/pull/2328))
+- Windows support for chrome runner ([#2324](https://github.com/opal/opal/pull/2324))
+  - Use correct node separator for NODE_PATH on Windows
+  - Pass dir and emulate exec a bit on Windows
+  - Use Gem.win_platform?, match supported platform to ruby, simplify run
+- NodeJS: Drop the first `--` argument in `ARGV` ([#2332](https://github.com/opal/opal/pull/2332))
+- Fix `Object#require` not pointing to `Kernel#require` ([#2323](https://github.com/opal/opal/pull/2323))
+
+### Changed
+
+- Fast-track bad constant names passed to `Struct.new` ([#2259](https://github.com/opal/opal/pull/2259))
+- Renamed internal `super` related helpers,
+  `find_super_dispatcher` is now `find_super`, `find_iter_super_dispatcher` is now `find_block_super` ([#2090](https://github.com/opal/opal/pull/2090))
+- The `opal-repl` CLI now requires files to be passed with `--require` (or `-r`) instead of the bare filename ([#2309](https://github.com/opal/opal/pull/2309))
+- `Process` is now a Module, not a Class - just like in MRI ([#2332](https://github.com/opal/opal/pull/2332))
+- `s = StringIO.new("a"); s << "b"; s.string` now returns "b", like MRI, but Opal used to return "ab" ([#2309](https://github.com/opal/opal/pull/2309))
+
+### Internal
+
+- Switch from jshint to ESLint ([#2289](https://github.com/opal/opal/pull/2289))
+- Switch from UglifyJS to Terser ([#2318](https://github.com/opal/opal/pull/2318))
+- [CI] Performance regression check (#2276, #2282)
+
+
+
+
+## [1.2.0](https://github.com/opal/opal/compare/v1.1.1...v1.2.0) - 2021-07-28
 
 
 ### Added

data/UNRELEASED.md

@@ -1,76 +1,7 @@
-### Added
-
-- Add support for `retry` (#2264)
-- Modernize Exceptions (#2264)
-  - Add `#cause`, `#backtrace_locations`, `#full_message` to `Exception`
-  - Normalize backtraces across platforms
-  - Add `Thread::Backtrace::Location`
-  - Output Exception#full_message on uncaught exceptions (#2269)
-- TracePoint `:class` support (#2049)
-- Implement the Flip-Flop operators (#2261)
-- Add `JS[]` to access properties on the global object (#2259)
-- Add `ENV.fetch` to the Nodejs implementation of `ENV` (#2259)
-- Opal::Cache, an optional compiler cache (enabled by default) (#2242, #2278)
-- Alias for gvars, alias on main (#2270)
-- Support for GJS (GNOME's JavaScript runtime) runner (#2280)
-- Scope variables support for `eval()` (#2256)
-- Add support for `Kernel#binding` (#2256)
-- A (mostly) correct support for refinements (#2256)
-- [CI] Performance regression check (#2276, #2282)
-- Add support for ECMAScript modules with an `--esm` CLI option (#2286)
-- Implement `Regexp#names` and add named captures support (#2272)
-- REPL improvements: (#2285)
-  - Colored output & history support
-  - `ls` to show available constants and variable
-- Add `Method#===` as an alias to `Method#call`, works the same as `Proc#===` (#2305)
-- Add `IO#gets` and `IO#read_proc` along with other supporting methods (#2309)
-  - Support `#gets` on most platforms, including browsers (via `prompt`)
-  - Move the REPL to a `--repl` CLI option of the main executable
-  - Completely refactor IO, now supporting 
-  - Add a runner for MiniRacer (as `miniracer`)
-  - Support Windows on the Chrome runner 
-  - Support Windows on the REPL
-  - Platforms an IO implementations should either set `IO#read_proc` or overwrite `IO#sysread`
-- [experimental] Add support for JavaScript async/await (#2221)
-  - Enable the feature by adding a magic comment: `# await: true`
-  - The magic comment can be also used to mark specific method patterns to be awaited
-    (e.g. `# await: *_await, sleep` will make any method ending in `_await` or named `sleep` to be awaited) 
-  - Add `Kernel#__await__` as a bridge to the `await` keyword (inspired by CoffeeScript await support)
-  - Require `opal/await` to get additional support
-  - Read more on the newly added documentation page
-- Better interoperability between legacy Promise (v1) and native Promise (v2) (#2221)
-  - Add `PromiseV1` as an alias to the original (legacy) Promise class
-  - Add `#to_v1` and `#to_v2` to both classes
-  - `Promise#to_n` will convert it to a native Promise (v2)
-
+<!--
 ### Fixed
-
-- Fixed multiple line `Regexp` literal to not generate invalid syntax as JavaScript (#1616)
-- Fix `Kernel#{try,catch}` along with `UncaughtThrowError` (#2264)
-- Update source-map-support to fix an off-by-one error (#2264)
-- Source map: lines should start from 1, not 0 (#2273)
-- Allow for multiple underscored args with the same name in strict mode (#2292)
-- Show instance variables in `Kernel#inspect` (#2285)
-- `0.digits` was returning an empty array in strict mode (#2301)
-- Non Integer numbers were responding to `#digits` (#2301)
-- Correctly delete hash members when dealing with boxed strings (#2306)
-- Escape string components in interpolated strings (`dstrs`) correctly (#2308)
-- Don't try to return the JS `debugger` statement, just return `nil` (#2307)
-- Retain the `-` while stringifying `-0.0` (#2304)
-- Fix super support for rest args and re-assignments with implicit arguments (#2315)
-
 ### Changed
-
-- Fast-track bad constant names passed to `Struct.new` (#2259)
-- Renamed internal `super` related helpers,
-  `find_super_dispatcher` is now `find_super`, `find_iter_super_dispatcher` is now `find_block_super` (#2090)
-- The `opal-repl` CLI now requires files to be passed with `--require` (or `-r`) instead of the bare filename (#2309)
-
-
 ### Deprecated
-
 ### Removed
-
 ### Internal
-
-- Switch from jshint to ESLint (#2289)
+-->

data/docs/compiled_ruby.md

@@ -30,8 +30,8 @@ to convert values to opal specific values.
 
 NOTE: Because `true` and `false` compile to their native
 javascript equivalents, they must share the same class: `Boolean`.
-For this reason, they do not belong to their respective `TrueClass`
-and `FalseClass` classes from ruby.
+Thru some level of hackery, we make them pseudo-members of the appropriate
+`TrueClass` and `FalseClass`.
 
 #### Strings & Symbols
 
@@ -55,11 +55,11 @@ class. Symbols and Strings can therefore be used interchangeably.
 
 #### Numbers
 
-In Opal there is a single class for numbers; `Numeric`. To keep Opal
+In Opal there is a single class for numbers; `Number`. To keep Opal
 as performant as possible, Ruby numbers are mapped to native numbers.
 This has the side effect that all numbers must be of the same class.
-Most relevant methods from `Integer`, `Float` and `Numeric` are
-implemented on this class.
+Most relevant methods from `Integer` and `Float` are implemented on
+this class.
 
 ```ruby
 42        # => 42
@@ -104,7 +104,7 @@ else is a truthy value including `""`, `0` and `[]`. This differs from
 JavaScript as these values are also treated as false.
 
 For this reason, most truthy tests must check if values are `false` or
-`nil`.
+`nil` (we also check for `null` and `undefined`).
 
 Taking the following test:
 
@@ -204,16 +204,16 @@ obvious what went wrong.
 
 As Opal just generates JavaScript, it is useful to use a native
 debugger to work through JavaScript code. To use a debugger, simply
-add an x-string similar to the following at the place you wish to
-debug:
+add a `debugger` statement:
 
 ```ruby
 # .. code
-`debugger`
+debugger
 # .. more code
 ```
-The x-strings just pass the debugger statement straight through to the
-JavaScript output.
+
+The `debugger` statement is compiled to become a JavaScript `debugger`
+statement. This statement breaks the code if you have your Inspector open.
 
 NOTE: All local variables and method/block arguments also keep their Ruby
 names except in the rare cases when the name is reserved in JavaScript.
@@ -246,7 +246,7 @@ in the browser.
 }
 
 # => opal version is:
-# => 0.6.0
+# => 1.3.1
 ```
 
 Even interpolations are supported, as seen here.
@@ -280,6 +280,9 @@ require 'native'
 win = Native(`window`) # equivalent to Native::Object.new(`window`)
 ```
 
+To access a Native-wrapped global JavaScript object, we can also use `$$`, after
+we have the `native` module required.
+
 Now what if we want to access one of its properties?
 
 ```ruby
@@ -514,10 +517,10 @@ Opal.BAZ;          // => 789
 To reach nested constants the safest way is to call `#const_get` on `Object`:
 
 ```javascript
-Opal.Object.$$const_get('Bar::BAR'); // => 123
-Opal.Object.$$const_get('Foo::BAR'); // => 123
-Opal.Object.$$const_get('Foo::FOO'); // => 456
-Opal.Object.$$const_get('BAZ');      // => 789
+Opal.Object.$const_get('Bar::BAR'); // => 123
+Opal.Object.$const_get('Foo::BAR'); // => 123
+Opal.Object.$const_get('Foo::FOO'); // => 456
+Opal.Object.$const_get('BAZ');      // => 789
 ```
 
 Constants can also be navigated using the `$$` property, although this is limited to constants defined directly under the current object:
@@ -528,6 +531,14 @@ Opal.Foo.$$.FOO // => 456
 Opal.Foo.$$.BAR // => undefined
 ```
 
+A later feature also allows you to skip the `$$` property:
+
+```javascript
+Opal.Bar.BAR // => 123
+Opal.Foo.FOO // => 456
+Opal.Foo.BAR // => undefined
+```
+
 
 ### Calling methods
 

data/docs/faq.md

@@ -10,7 +10,7 @@ We run opal against the [ruby spec](https://github.com/ruby/spec) as our primary
 
 ### What version of ruby does Opal target?
 
-We are running tests under ruby 2.0.0 conditions, but are mostly compatible with 1.9 level features.
+We are running tests under ruby 3.0.0 conditions, but are mostly compatible with 2.6 level features.
 
 ### Why doesn't Opal support mutable strings?
 

data/docs/headless_chrome.md

@@ -3,7 +3,6 @@
 ## Requirements
 
 First of all, make sure that you have Chrome at least 59.0 installed.
-Also for now it's supported only on Mac and Linux. (version 60 may get support on Windows)
 
 ## Using the runner
 
@@ -22,11 +21,9 @@ The runner also listens for any exceptions and prints formatted stracktraces bac
     raising_method
     "
 
-    RuntimeError : test error
-        at $$raise (file:///tmp/chrome-opal.js:4996:6)
-        at $$raising_method (file:///tmp/chrome-opal.js:21144:16)
-        at  (file:///tmp/chrome-opal.js:21146:14)
-        at  (file:///tmp/chrome-opal.js:21147:2)
+    RuntimeError: test error
+      from <internal:corelib/…>:2693:7:in `<main>'
+      from -e:1:1:in `undefined'
 
 ## Using exit codes
 
@@ -36,10 +33,9 @@ By default headless chrome runner explicitly sets exit code to 1 when there was
     0
 
     $ opal -Rchrome -e "raise 'error'"; echo $?
-    RuntimeError : error
-        at $$raise (file:///tmp/chrome-opal.js:4996:6)
-        at  (file:///tmp/chrome-opal.js:21139:14)
-        at  (file:///tmp/chrome-opal.js:21140:2)
+    RuntimeError: error
+      from <internal:corelib/kerne…>:2693:7:in `<main>'
+      from -e:1:1:in `undefined'
     1
 
 You can change final exit code by using `Kernel#exit`, but make sure to require `opal/platform` in your code.
@@ -69,20 +65,12 @@ or runs the server on its own. It detects your platform and uses a default path
 (`Opal::CliRunners::Chrome#chrome_executable`) but you can override it by specifying `GOOGLE_CHROME_BINARY` environment
 variable.
 
-When the server is up and running it passes compiled js code to `node lib/opal/cli_runners/chrome.js`
+When the server is up and running it passes compiled js code to `lib/opal/cli_runners/chrome_cdp_interface.rb`
 as a plain input using stdin (basically, it's a second part of the runner).
-`chrome.js` is a node js script that does the main job. It runs any provided code on the running chrome server,
+`chrome_cdp_interface.rb` is a node js + Opal script that does the main job. It runs any provided code on the running chrome server,
 catches errors and forwards console messages.
 
 
-Moreover, you can actually call any js using headless chrome by running
-
-      $ echo "console.log('Hello, Opal')" | node lib/opal/cli_runners/chrome.js
-
-NOTE: to run it you need to have a chrome server running on `localhost:9222` (usually `chrome.rb` does it for you)
-
-      $ chrome --disable-gpu --headless --remote-debugging-port=9222
-
 ## Using a remote chrome server
 
 If you want to change a default chrome port or your chrome server is running on a different host:port
@@ -99,7 +87,9 @@ NOTE: `CHROME_HOST` requires a chrome server to be started. You can't start remo
 
 If you need to pass additional CLI options to the Chrome executable you can do so by setting the `CHROME_OPTS` environment variable:
 
-      $ CHROME_OPS="--window-size=412,732" opal -Rchrome -e "puts 42"
+      $ CHROME_OPTS="--window-size=412,732" opal -Rchrome -e "puts 42"
       42
 
+Docker users may need `CHROME_OPTS="--no-sandbox"` due to the user namespaces limitations.
+
 _For a list of additional options see https://developers.google.com/web/updates/2017/04/headless-chrome_

data/docs/jquery.md

@@ -1,8 +1,6 @@
 # JQuery
 
-`opal-jquery` offers a nicer ruby-like syntax for JQuery (and Zepto). It is
-useful for projects which cannot use `opal-browser` due to a reliance on jquery
-for plugins or other libraries.
+`opal-jquery` offers a nicer ruby-like syntax for JQuery. It is useful for projects which cannot use `opal-browser` due to a reliance on jquery for plugins or other libraries.
 
 ```ruby
 foos = Element.find('.foo')
@@ -91,9 +89,6 @@ bridged instances of jquery objects. Just like ruby arrays are just javascript
 arrays, `Element` instances are just jquery objects. This makes interaction
 with jquery plugins much easier.
 
-Also, `Element` will try to bridge with Zepto if it cannot find jQuery loaded,
-making it ideal for mobile applications as well.
-
 ### Interacting with the DOM
 
 #### Finding Elements

data/docs/opal_parser.md

@@ -8,12 +8,14 @@ Opal is able to compile its – pure Ruby – compiler to JavaScript (how cool i
 require 'opal-parser'
 ```
 
+_Note: For the best performance and application load times, it is strongly recommended to design your application so that it won't need the parser. A lot of methods described in this document are more fun hacks than robust solutions. But if you really want or need to use them, for example so that you can implement a Ruby REPL or an interactive Ruby playground - we have you covered, but for all other cases, we strongly discourage you to take an advice from this guide._
+
 
 ## Features
 
 ### `Kernel#eval`
 
-`opal-parser` provides a partial implementation of `Kernel#eval` that only support the first parameter (String) and refuse any passed `binding`, `lineno` or `filename`.
+`opal-parser` provides a partial implementation of `Kernel#eval`.
 
 Example:
 

data/docs/promises.md

@@ -8,6 +8,8 @@ It can be required inside any Opal applicaton:
 require 'promise'
 ```
 
+_Please also take a look at the Asynchronous code guide - we are in the process of modernizing the Promises, along with supporting async/await_
+
 ## Usage
 
 This example shows how to use a `HTTP` request from `opal-jquery` from a callback style, into a promise style handler.

data/docs/releasing.md

@@ -14,5 +14,24 @@ _This guide is a work-in-progress._
 
 ## The commit
 
-- Commit the updated changelog along with the version bump using this commmit message:
+- Commit the updated changelog along with the version bump using this commit message:
   "Release v1.2.3"
+- Push the commit and run `bin/rake release` to release the new version to Rubygems
+- Go to GitHub releases and create a new release from the latest tag pasting the contents of UNRELEASED.md
+- Empty UNRELEASED.md and run `bin/rake changelog`
+- Push the updated changelog
+
+## Opal docs
+
+- Open `opal-docs` and run `bin/build v1.2.3`
+- Then run `bin/deploy`
+
+## Opal site
+
+- Open `opal.github.io` and update the opal version in the `Gemfile`
+- run `bin/build`
+- `git push` the latest changes
+
+## Opal CDN
+
+- Run `bin/release v1.2.3`

data/docs/roda-sprockets.md

@@ -23,7 +23,6 @@ class App < Roda
    plugin :sprockets, precompile: %w(application.js),
                       prefix: %w(app/),
                       opal: true,
-                      debug: ENV['RACK_ENV'] != 'production'
    plugin :public
 
    route do |r|

data/docs/source_maps.md

@@ -1,10 +1,6 @@
 # Source maps
 
-Source maps are available (on current stable release, v0.6.x) even without explicit support from Sprockets in a sort of hackish way.
-
-_As such even if they generally work fine there are some limitations and edge case issues._
-
-NOTE: Currently on `master` branch sourcemaps are work-in-progress and probably will integrate with the upcoming Sprockets 4 that has integrated support for them.
+Source maps are available on most environments we support.
 
 #### Processor `source_map_enabled` flag
 To enable sourcemaps in the Sprockets processor you need to turn on the relative flag:
@@ -16,8 +12,7 @@ Opal::Config.source_map_enabled = true # default
 
 #### Sprockets debug mode
 
-The  sourcemaps only work with Sprockets in debug mode because they are generated just for single files.
-
+The source maps only work with Sprockets in debug mode - this is a limitation of Sprockets.
 
 ## Enable source maps
 
@@ -37,13 +32,17 @@ config.assets.debug = true
 
 ### Sinatra
 
-You can add `Opal::Server` as in the official example: [sinatra/config.ru](https://github.com/opal/opal/blob/0-6-stable/examples/sinatra/config.ru).
+You can add `Opal::Server` as in the official example: [sinatra/config.ru](https://github.com/opal/opal/blob/master/examples/sinatra/config.ru).
 
 ### Opal::Server
 
-`Opal::Server` implements sourcemaps and can be used alone or with `Rack::Cascade` in conjunction with other apps.
+`Opal::Server` (which is based on Sprockets) implements sourcemaps and can be used alone or with `Rack::Cascade` in conjunction with other apps.
+
+### Opal::SimpleServer
+
+Like `Opal::Server`, `Opal::SimpleServer` (which isn't based on Sprockets) implements sourcemaps properly.
 
-### Opal::Environment
+### Opal::Builder
 
-`Opal::Environment` is a bit lower level and doesn't support source maps by itself.
+`Opal::Builder` is a bit lower level and doesn't support source maps by itself. It requires you to call in a specific method to generate them yourself.
 

data/docs/static_applications.md

@@ -2,7 +2,7 @@
 
 `opal` makes it easy to build static opal applications. Opal uses internal load
 paths to make it easy to handle resolving requirements during building. `opal`
-forms the basis of rails support, so anything you can do there, you can do
+forms the basis of Rails support, so anything you can do there, you can do
 standalone as well.
 
 ## Overview
@@ -11,7 +11,7 @@ First, install `opal` adding them to a `Gemfile`:
 
 ```ruby
 # Gemfile
-gem "opal", "~> 0.7.0"
+gem "opal"
 ```
 
 Next, we want to add our main app code. Keep all opal code inside `app/`

data/docs/unsupported_features.md

@@ -6,6 +6,10 @@ Opal does not support some language/runtime features of ruby. These are document
 
 For performance and ease of runtime features, all strings in Opal are immutable, i.e. `#<<`, `#gsub!`, etc. do not exist. Also, symbols are just strings. There is no class, runtime or feature difference between Symbols and Strings. Their syntaxes can be used interchangeably.
 
+#### Regexp differences ####
+
+We are using JavaScript regular expressions. While we do translate a few of Ruby specific instructions like `\A` or `\z`, there are a lot of incompatibilities that you should be aware of - for example `$` and `^` don't match newlines like they do in Ruby. Support for features like named matches or lookahead/lookbehind is dependent on the JavaScript environment support for those. To support everything, we would need to [compile in the entire Ruby's regular expression engine](https://opalrb.com/blog/2021/06/26/webassembly-and-advanced-regexp-with-opal/) which is unfeasible at the current time.
+
 #### Integer / Float difference ####
 
 In Opal, both integers and floats belong to same class `Number` (using JavaScript native numbers). So `1 / 4` is `0.25` (not `0`) and `4.0 / 2` is `2` (not `2.0`).

data/examples/rack/Gemfile

@@ -2,3 +2,4 @@ source 'https://rubygems.org'
 
 gem 'rack'
 gem 'opal', :path => '../../'
+gem 'puma'

data/examples/rack/Gemfile.lock

@@ -1,24 +1,28 @@
 PATH
   remote: ../..
   specs:
-    opal (1.0.0)
+    opal (1.3.0.dev)
       ast (>= 2.3.0)
-      parser (~> 2.6)
+      parser (~> 3.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    ast (2.4.0)
-    parser (2.6.4.1)
-      ast (~> 2.4.0)
-    rack (2.0.7)
+    ast (2.4.2)
+    nio4r (2.5.8)
+    parser (3.0.2.0)
+      ast (~> 2.4.1)
+    puma (5.5.0)
+      nio4r (~> 2.0)
+    rack (2.2.3)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
   opal!
+  puma
   rack
 
 BUNDLED WITH
-   1.17.3
+   2.1.4

data/examples/rack-esm/.gitignore

@@ -0,0 +1 @@
+tmp

data/examples/rack-esm/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gem 'rack'
+gem 'opal', :path => '../../'
+gem 'puma'